fyicons 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,125 @@
 # fyicons
 
+## 0.3.0
+
+### Minor Changes
+
+- def3cb7: Sync the icon collection with the current design source.
+
+  - Add 105 icons.
+  - Remove `IconFontCapital`, `IconWrap`; these components are no longer in the source inventory.
+  - Update SVG artwork for 419 existing icons; 413 have rendered pixel changes.
+  - Rename 80 React exports. Previous names remain website lookup aliases, not React exports.
+
+  Breaking changes and migration:
+
+  Apply each replacement to the original `0.2.1` import names in one pass. Do not run sequential global replacements: some destination names are also old names that move elsewhere. For example, old `IconCheckThick` becomes `IconCheckThickSm`, while old `IconCheckThickSm` becomes `IconCheckThickXs`. Old `IconGaugeHigh` becomes `IconMeterHigh`, while old `IconGaugeSimpleHigh` becomes `IconGaugeHigh`. Preserve any local import aliases when you update the imported symbol.
+
+  Review uses of these ten names even if TypeScript still accepts them: `IconCookie`, `IconCookieFill`, `IconMenuSimple`, `IconCheckThickSm`, `IconCheckThick`, `IconGaugeHigh`, `IconGaugeLow`, `IconFlower`, `IconCalendarFill`, and `IconFlagPennant`. They now select different source icons. Use the replacements below to retain the original source identity. The corresponding SVG filenames, CSS classes, and shadcn registry item names also follow the new icon names. Historical website search aliases do not restore old React exports, and current canonical names take precedence over aliases.
+
+  - Replace `IconFlagPennant` imports with `IconFlagBanner`.
+  - Replace `IconCookie` imports with `IconCookieBite`.
+  - Replace `IconSwatch` imports with `IconSwatches`.
+  - Replace `IconCookieFill` imports with `IconCookieBiteFill`.
+  - Replace `IconHourglassSimple` imports with `IconHourglassEmpty`.
+  - Replace `IconLayoutTabs` imports with `IconTabs`.
+  - Replace `IconCircleDashedUser` imports with `IconCircleUserDashed`.
+  - Replace `IconTexture` imports with `IconBackgroundInner`.
+  - Replace `IconExtensionsLg` imports with `IconExtensionsAlt`.
+  - Replace `IconMouseModern` imports with `IconMouseWheel`.
+  - Replace `IconInfinitySign` imports with `IconInfinity`.
+  - Remove `IconFontCapital` imports. This icon is no longer available.
+  - The `IconCookie` name now refers to a different source icon. Review its use in your application.
+  - The `IconCookieFill` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconPencilEdit` imports with `IconEdit`.
+  - The `IconCalendarFill` name now refers to a different source icon. Review its use in your application.
+  - The `IconCheckThick` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconPaintBucket` imports with `IconBucket`.
+  - The `IconMenuSimple` name now refers to a different source icon. Review its use in your application.
+  - The `IconFlower` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconCheckThickSm` imports with `IconCheckThickXs`.
+  - Replace `IconSendStraight` imports with `IconSendAlt`.
+  - Replace `IconBlockquote` imports with `IconQuoteBlock`.
+  - Replace `IconKbdCommandSquare` imports with `IconSquareCommand`.
+  - Replace `IconPlugAtSign` imports with `IconAtSignPlug`.
+  - Replace `IconCompassAlt` imports with `IconCompassSimple`.
+  - Replace `IconGaugeHigh` imports with `IconMeterHigh`.
+  - Replace `IconGauge` imports with `IconMeter`.
+  - Replace `IconGaugeLow` imports with `IconMeterLow`.
+  - Replace `IconGaugeSimpleHigh` imports with `IconGaugeHigh`.
+  - The `IconGaugeHigh` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconGaugeSimpleLow` imports with `IconGaugeLow`.
+  - The `IconGaugeLow` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconTextQuotes` imports with `IconParagraphQuotes`.
+  - Replace `IconTextBlockquote` imports with `IconParagraphBlockquote`.
+  - Replace `IconSendStraightFill` imports with `IconSendAltFill`.
+  - Replace `IconPlugPlug` imports with `IconPlugs`.
+  - Replace `IconCircleProgressTodo` imports with `IconProgressTaskTodo`.
+  - Replace `IconCircleProgressQuarter` imports with `IconProgressTask25`.
+  - Replace `IconCircleProgressHalf` imports with `IconProgressTask50`.
+  - Replace `IconCircleProgressThreeQuarters` imports with `IconProgressTask75`.
+  - Replace `IconPencilEditFill` imports with `IconEditSolid`.
+  - Replace `IconGridHeader` imports with `IconGridMixedTop`.
+  - Replace `IconGridFooter` imports with `IconGridMixedBottom`.
+  - Replace `IconGridSidebarEnd` imports with `IconGridMixedRight`.
+  - Replace `IconGridSidebarStart` imports with `IconGridMixedLeft`.
+  - Replace `IconMenuSimple` imports with `IconMenuAltSimple`.
+  - Replace `IconClick` imports with `IconCursorRays`.
+  - Replace `IconTextHtml` imports with `IconTextMarkup`.
+  - Replace `IconParagraphProse` imports with `IconParagraphWords`.
+  - Replace `IconClockFillAlt` imports with `IconClockSolid`.
+  - Replace `IconWindowPointer` imports with `IconViewPointer`.
+  - Replace `IconArrowWrap` imports with `IconLineWrap`.
+  - Replace `IconGear` imports with `IconCogWheel`.
+  - Replace `IconArticle` imports with `IconPageThumbnail`.
+  - Replace `IconSwitchesIos` imports with `IconSwitchesCupertino`.
+  - Replace `IconGitModified` imports with `IconLetterM`.
+  - Replace `IconPointerRulers` imports with `IconRulersPointer`.
+  - Replace `IconCircleProgressFull` imports with `IconProgressTaskDone`.
+  - Replace `IconFolderView` imports with `IconFolderTree`.
+  - Replace `IconFolderViewFill` imports with `IconFolderTreeFill`.
+  - Replace `IconTextBox` imports with `IconBoundingBoxText`.
+  - Replace `IconGridRowBottom` imports with `IconGridPositionBottom`.
+  - Replace `IconGridRowTop` imports with `IconGridPositionTop`.
+  - Replace `IconGridColumnEnd` imports with `IconGridPositionRight`.
+  - Replace `IconGridColumnStart` imports with `IconGridPositionLeft`.
+  - Replace `IconGitAdded` imports with `IconLetterA`.
+  - Replace `IconGitRemoved` imports with `IconLetterR`.
+  - Replace `IconFlagBurgee` imports with `IconFlagPennant`.
+  - The `IconFlagPennant` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconGaugeSimpleMax` imports with `IconGaugeMax`.
+  - Replace `IconGaugeSimpleMin` imports with `IconGaugeMin`.
+  - Replace `IconLayoutTemplate` imports with `IconLayoutDashed`.
+  - Replace `IconLayoutSidebarEnd` imports with `IconLayoutColumnRight`.
+  - Replace `IconLayoutSidebarStart` imports with `IconLayoutColumnLeft`.
+  - Replace `IconLayoutFooter` imports with `IconLayoutRowBottom`.
+  - Replace `IconLayoutHeader` imports with `IconLayoutRowTop`.
+  - Replace `IconTextBoxHeading` imports with `IconBoundingBoxHeading`.
+  - Replace `IconPlugPlugged` imports with `IconPlugsPlugged`.
+  - Replace `IconPlugUnplug` imports with `IconPlugsUnplug`.
+  - Replace `IconChartBarSimple` imports with `IconChartBarAxes`.
+  - Replace `IconFlower` imports with `IconFlowerSpiral`.
+  - Remove `IconWrap` imports. This icon is no longer available.
+  - Replace `IconOverflow` imports with `IconLineOverflow`.
+  - Replace `IconCalendarFill` imports with `IconCalendarSolid`.
+  - Replace `IconCheckThick` imports with `IconCheckThickSm`.
+  - The `IconCheckThickSm` name now refers to a different source icon. Review its use in your application.
+  - Replace `IconWindowText` imports with `IconViewText`.
+  - Replace `IconSidebarRightOpen` imports with `IconSidebarRightFill`.
+  - Replace `IconSidebarLeftOpen` imports with `IconSidebarLeftFill`.
+  - Replace `IconBlueprintGrid` imports with `IconGridRuler`.
+  - Replace `IconArticleSimple` imports with `IconRichText`.
+
+- b3a8785: Add the optional `fyicons/client` entry with `FyiProvider` and provider-aware icons. Set shared `size`, `color`, `className`, and `style` defaults for an app or a section. Nested providers inherit defaults, classes and styles combine, and individual icons can override values.
+
+  Import both `FyiProvider` and its icons from `fyicons/client`. Existing `fyicons` imports, direct icon imports, and shadcn source icons remain context-free and keep Server Component support. No migration is required for existing consumers.
+
+### Patch Changes
+
+- 1f497fb: Include `fy-icon` and `fy-{icon-name}` classes on raw SVG exports, matching the React components. The package's SVG files and website downloads preserve the original artwork, viewBox, paint, and reference IDs. Website ZIP checksums include the added classes.
+
+  Use these classes to style inline SVGs with CSS `color`, `width`, and `height`.
+
 ## 0.2.1
 
 ### Patch Changes

package/README.md

@@ -2,7 +2,7 @@
 
 FYIcons brings a collection of 16 × 16 SVG icons to React, with TypeScript types, accessible naming, and colors that follow your theme. Use them in compact controls, menus, toolbars, or anywhere your interface needs an icon.
 
-[Browse the library](https://icons.bob.fyi/library/) · [See examples](https://icons.bob.fyi/examples/) · [Changelog](https://github.com/robertweisbecker/fyicons/blob/main/packages/fyicons/CHANGELOG.md)
+[Browse the library](https://icons.bob.fyi/icons/) · [See examples](https://icons.bob.fyi/examples/) · [Changelog](https://github.com/robertweisbecker/fyicons/blob/main/packages/fyicons/CHANGELOG.md)
 
 ## Install
 
@@ -63,6 +63,37 @@ Every icon has `fy-icon` and `fy-{icon-name}` classes. The icon name matches the
 // Renders class="fy-icon fy-sun toolbar-icon"
 ```
 
+## Shared defaults with FyiProvider
+
+Use the optional `fyicons/client` entry to set defaults for an app or a section. Import both the provider and its icons from this entry:
+
+```tsx
+import { FyiProvider, IconSun, IconMoon } from 'fyicons/client';
+
+export function Toolbar() {
+  return (
+    <FyiProvider size={20} className="toolbar-icon">
+      <IconSun />
+      <IconMoon size={16} />
+      <FyiProvider size={24} color="#2563eb">
+        <IconSun />
+      </FyiProvider>
+    </FyiProvider>
+  );
+}
+```
+
+The provider accepts `size`, `color`, `className`, `style`, and `children`. It adds no DOM element.
+
+- Nested providers inherit unspecified defaults. Icon props override inherited size and color. Explicit `width` and `height` still override the corresponding dimension.
+- Classes combine in outer-provider, inner-provider, then icon order, after the default icon classes.
+- Styles merge in the same order. Later values win for the same CSS property. CSS rules still follow the normal cascade; an inline style can override an SVG presentation attribute such as `color`.
+- Without a provider, client icons keep the same 16 px size, inherited text color, and decorative accessibility defaults.
+
+Set accessible names, IDs, refs, and event handlers on individual icons. These are not provider defaults.
+
+Regular `fyicons` imports, direct `fyicons/icons/*` imports, and shadcn source icons stay context-free. They do not consume provider defaults, even inside a provider. Only icons from `fyicons/client` read the context.
+
 ## Accessibility
 
 Icons without a non-empty `aria-label` are decorative and render with `aria-hidden="true"`. Add `aria-label` when an icon conveys information on its own. The component passes the label to the SVG and sets `role="img"`:
@@ -79,9 +110,11 @@ For an icon-only button, name the button and leave the icon decorative, as in th
 
 Use icons in either Server Components or Client Components. Static icons do not need a `use client` directive. For event handlers or refs, place the icon inside your own Client Component.
 
+The optional `fyicons/client` entry exports Client Components. A Server Component can render `FyiProvider` and pass serializable defaults to it. Icons from the client entry consume those defaults; icons rendered as Server Components keep their own props and defaults. Regular imports do not load the provider runtime.
+
 ## SVG files and editable source
 
-The package includes source SVG files in `svg/` and a `manifest.json` file with names, source IDs, aliases, and source links. You can also [browse and download SVGs](https://icons.bob.fyi/library/) without installing the package.
+The package includes SVG files in `svg/` and a `manifest.json` file with names, source IDs, and aliases. The SVG exports have the same `fy-icon` and `fy-{icon-name}` classes as React components, with the original artwork preserved. Style inline SVGs with CSS `color`, `width`, and `height`. You can also [browse and download SVGs](https://icons.bob.fyi/icons/) without installing the package.
 
 If you want editable React files in your project, use the [shadcn registry](https://github.com/robertweisbecker/fyicons#add-icons-with-shadcn). It copies selected icons and their shared helpers into your components directory.