gridsmith-ui 0.26.0 → 0.28.0

package/dist/icons.d.ts

@@ -1,6 +1,24 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ReactElement } from 'react';
 
+/**
+ * The import each icon pack takes, as an app writes it when it registers its theme's pack (Sprint 25.21 P1:
+ * `registerIconPack('feather', () => import('react-icons/fi'))`). One table for the library's warning, the shells
+ * `get_app_shell` writes and the engine's fix. Lucide is the library's own: every app installs it, as the fallback.
+ * No React here, so the platform reads it as it reads the other showcase modules.
+ */
+declare const ICON_PACK_IMPORTS: {
+    readonly feather: "react-icons/fi";
+    readonly heroicons: "@heroicons/react/24/outline";
+    readonly phosphor: "@phosphor-icons/react";
+    readonly tabler: "@tabler/icons-react";
+};
+/** A pack an app registers: every pack but Lucide. */
+type RegisteredIconPack = keyof typeof ICON_PACK_IMPORTS;
+
+/** A pack's module, as an import: the app's own for its theme's pack (registerIconPack), the library's own for Lucide. */
+type PackLoad = () => Promise<unknown>;
+
 /**
  * Runtime list of curated icon names. The CuratedIconName type derives from
  * this array, so adding a name here extends autocomplete automatically.
@@ -16,6 +34,13 @@ type CuratedIconName = (typeof CURATED_ICON_NAMES)[number];
  */
 type IconName = CuratedIconName | (string & {});
 type IconPack = "lucide" | "phosphor" | "heroicons" | "tabler" | "feather";
+/**
+ * The theme's icon pack, as the app's own import (Sprint 25.21 P1): `registerIconPack('feather', () =>
+ * import('react-icons/fi'))` at the top of the shell, before any preloadPack. The library names no pack itself, so an
+ * app's bundler only ever meets the pack the app installed. A pack drawn before it is registered draws Lucide's icons,
+ * and draws its own once registered. Lucide needs no line.
+ */
+declare function registerIconPack(pack: RegisteredIconPack, load: PackLoad): void;
 declare function IconProvider({ pack, weight, children }: {
     pack: IconPack;
     weight: number;
@@ -23,10 +48,12 @@ declare function IconProvider({ pack, weight, children }: {
 }): react_jsx_runtime.JSX.Element;
 /**
  * Start loading a pack's icon chunk before React mounts. Call this in your
- * app's entry point (e.g. main.tsx) for the fastest possible cold start:
+ * app's entry point or shell for the fastest possible cold start, after the
+ * pack is registered (every pack but Lucide, Sprint 25.21 P1):
  *
- *   import { preloadPack } from 'gridsmith-ui/icons'
- *   preloadPack('lucide')
+ *   import { preloadPack, registerIconPack } from 'gridsmith-ui/icons'
+ *   registerIconPack('feather', () => import('react-icons/fi'))
+ *   preloadPack('feather')
  */
 declare function preloadPack(pack: IconPack): void;
 declare function Icon({ name, size, className, from }: {
@@ -42,4 +69,4 @@ declare function Icon({ name, size, className, from }: {
  */
 type IconSlot = IconName | ReactElement | false | null | undefined;
 
-export { Icon, type IconName, type IconPack, IconProvider, type IconSlot, preloadPack };
+export { Icon, type IconName, type IconPack, IconProvider, type IconSlot, preloadPack, registerIconPack };

package/dist/icons.js

@@ -1,3 +1,4 @@
-export { Icon, IconProvider, preloadPack } from './chunk-HXVXJUGV.js';
+"use client";
+export { Icon, IconProvider, preloadPack, registerIconPack } from './chunk-TJEV7YAY.js';
 //# sourceMappingURL=icons.js.map
 //# sourceMappingURL=icons.js.map

package/dist/icons.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"icons.js"}
+{"version":3,"sources":[],"names":[],"mappings":";","file":"icons.js"}