feat(react-icons): propagate headless/ API to stable#1119
Merged
Hotell merged 5 commits intoJun 29, 2026
Conversation
Hotell
changed the title
Hotell
commented
Jun 19, 2026
| "import": "./lib/providers.js", | ||
| "require": "./lib-cjs/providers.js" | ||
| }, | ||
| "./headless": { |
Collaborator
Author
There was a problem hiding this comment.
note, this exist purerly for "api" aligment , it doesn't export icon chunks as current default barrel. this is by design. the direct consumption is not supported -> only atomic imports
import {AddFilled} from '@fluentui/react-icons/headless' -> 💣 in runtime/during build
📋 PR Validation SummaryCheck the Build react library job summary for detailed reports:
|
Hotell
changed the title
headless/ API to stable
This was referenced Jun 19, 2026
dmytrokirpa
approved these changes
Jun 22, 2026
- src/headless/headless.css -> styles.css - src/headless/fonts/headless-fonts.css -> fonts/styles.css - update export map, sideEffects, build-verify test and docs BREAKING CHANGE: headless CSS import paths changed '@fluentui/react-icons/headless/headless.css' -> '.../headless/styles.css' '@fluentui/react-icons/headless/headless-fonts.css' -> '.../headless/fonts/styles.css'
…prites) - convert:svg / convert:fonts: pass --headless to opt into headless atoms - convert.js: gate headless block on per-icon dest only so per-icon generation runs independently of sprites (sprite dest stays optional) - build.js: only add ./headless/svg-sprite/* export when those atoms exist Headless SVG sprites remain opt-in via --headlessSpriteDest.
Adds '@fluentui/react-icons/headless/utils' mirroring '@fluentui/react-icons/utils' for the headless API, so a future atomic-loader headless mode can route utility imports (bundleIcon, createFluentIcon, useIconState, class-name constants) to the headless implementations instead of the Griffel ones. - src/headless/utils.ts: new utils-only entry (no wrapIcon by design) - build.js: add ./headless/utils to the headless export map - build-verify: assert utils.js/.d.ts are emitted Loader changes intentionally deferred.
Adds monosize fixtures for the headless API (single SVG, single font, and bundleIcon) so headless bundle size is tracked alongside the Griffel fixtures.
- move docs/preview-features/headless.md -> docs/headless.md (fix relative links) - drop the alpha/prerelease banners from the headless doc and README section - remove headless from the preview-features index (SVG sprites stays alpha) - publish docs/headless.md via package.json files - update docsite UserGuidance note to stable wording SVG sprites remain alpha and are intentionally left unchanged.
Hotell
force-pushed
the
react-icons/prepare-headless-for-release
branch
from
cbf248d to
d8d9bab
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Prepares the headless icon API for a stable release.
Commits
styles.cssheadless/headless.css→headless/styles.cssheadless/headless-fonts.css→headless/fonts/styles.cssconvert:svg/convert:fontsopt into headless atoms via--headless--headlessSpriteDest@fluentui/react-icons/headless/utilsendpoint@fluentui/react-icons/utilsso a future atomic-loader headless mode can route utility imports to the headless implementations (nowrapIconby design)docs/preview-features/headless.md→docs/headless.md, drop alpha/prerelease banners, update README + storybook note (SVG sprites stay alpha)Notes
/headless/are intentionally deferred.