@astryxdesign/core 0.7.4 → 0.7.5-canary.0418c47

package/dist/Icon/globalIconRegistry.d.ts

@@ -1,14 +1,25 @@
 /**
  * @file globalIconRegistry.tsx
- * @input None (pure module-level state)
- * @output Exports registerIcons, getIconRegistry, getIcon, resetIcons, IconName, IconRegistry
+ * @input Theme icon entries (a DefinedTheme or a registered theme name), the
+ *   process-wide registry, and built-in defaults
+ * @output Exports registerIcons, getIconRegistry, getIcon, getExtendedIcon,
+ *   resetIcons, resolveIcon (internal), IconName, IconRegistry, IconEntry,
+ *   IconRequest
  * @position Global and theme-scoped icon registry; works in server and client environments
  *
  * This module has NO 'use client' directive — it's importable from RSC.
  * Components resolve semantic icons through getIcon() or the client useIcon() hook.
+ *
+ * An entry is a React node or a pure synchronous function of an
+ * {@link IconRequest}. Resolution picks one source — theme entry, then
+ * process-wide registration, then built-in default; a nullish static entry
+ * falls through — and a selected function's result is final. `Icon` passes
+ * its resolved size; the public reads below pass `{size: 'md'}`.
  */
 import type { ReactNode } from 'react';
-import type { DefinedTheme } from '../theme/defineTheme';
+import type { IconSize } from './IconSize.stylex.js';
+import type { IconVariant } from './index.js';
+import type { DefinedTheme } from '../theme/defineTheme.js';
 /**
  * Semantic icon names used internally by Astryx components.
  *
@@ -43,7 +54,45 @@ export type ExtendedIconName = IconName | (string & {});
  * A complete icon registry: every semantic name mapped to a React node.
  */
 export type IconRegistry = Record<IconName, ReactNode>;
+/**
+ * What `Icon` asks a function icon entry for: the final Icon size, resolved
+ * explicit `size` → owning component's default → `'md'`, and a variant name
+ * or `undefined`.
+ *
+ * Inside `defineTheme`, `Variant` is the theme's listed `iconVariants`; a
+ * process-wide registration receives {@link IconVariant}.
+ */
+export type IconRequest<Variant extends string = IconVariant> = Readonly<{
+    size: IconSize;
+    variant?: Variant;
+}>;
+/**
+ * A theme or process-wide icon entry: a React node, or a pure synchronous
+ * function of the {@link IconRequest} that returns one.
+ *
+ * A function computes its result from the request only — no hooks, DOM or
+ * SVG measurement, browser globals, network access, mutable module state, or
+ * side effects. Once selected, its result is final: returning `null` or
+ * `undefined` renders no glyph instead of falling through to another source.
+ *
+ * @example
+ * ```
+ * defineTheme({
+ *   name: 'brand',
+ *   icons: {
+ *     info: ({size}) => <InfoIcon weight={size === 'sm' ? 'bold' : 'regular'} />,
+ *   },
+ * });
+ * ```
+ */
+export type IconEntry<Variant extends string = IconVariant> = ReactNode | ((request: IconRequest<Variant>) => ReactNode);
 export type IconRegistrySource = DefinedTheme | string | null | undefined;
+/**
+ * Resolve a key for an Icon request. `Icon` is the caller: it passes the size
+ * it resolved. Public reads use {@link getIcon} instead.
+ * @internal
+ */
+export declare function resolveIcon(name: ExtendedIconName, source: IconRegistrySource, request: IconRequest<never>): ReactNode;
 /**
  * Register icons at the module level. Works in both server and client
  * environments. Call once at app initialization (e.g. root layout).
@@ -66,8 +115,15 @@ export type IconRegistrySource = DefinedTheme | string | null | undefined;
  * ```
  * registerIcons({ 'richtext:bold': <MyBoldIcon /> });
  * ```
+ *
+ * An entry may also be a pure synchronous function of `{size, variant}`
+ * ({@link IconEntry}); `Icon` passes it the size it renders at.
+ * @example
+ * ```
+ * registerIcons({ info: ({size}) => <InfoIcon weight={size === 'sm' ? 'bold' : 'regular'} /> });
+ * ```
  */
-export declare function registerIcons(icons: Partial<Record<ExtendedIconName, ReactNode>>): void;
+export declare function registerIcons(icons: Partial<Record<ExtendedIconName, IconEntry>>): void;
 /**
  * Get a snapshot of the full icon registry, with registered icons overriding
  * built-in defaults.
@@ -75,6 +131,9 @@ export declare function registerIcons(icons: Partial<Record<ExtendedIconName, Re
  * Works in both server and client environments. Useful for tooling that needs
  * to derive valid semantic icon-name options from the same registry Icon
  * resolves against.
+ *
+ * Every value is a React node: a function entry is read at `{size: 'md'}`,
+ * exactly as {@link getIcon} reads it.
  */
 export declare function getIconRegistry(source?: IconRegistrySource): Readonly<Record<IconName, ReactNode>>;
 /**
@@ -87,6 +146,9 @@ export declare function getIconRegistry(source?: IconRegistrySource): Readonly<R
  * {@link IconName}s — useful for library-contributed icons. For a
  * caller-supplied fallback when a key isn't registered, use
  * {@link getExtendedIcon}.
+ *
+ * Returns a React node: a function entry is read at `{size: 'md'}`. Render
+ * `<Icon icon={name} />` to request another size.
  */
 export declare function getIcon(name: ExtendedIconName, source?: IconRegistrySource): ReactNode;
 /**
@@ -99,7 +161,9 @@ export declare function getIcon(name: ExtendedIconName, source?: IconRegistrySou
  * widen the core {@link IconName} union.
  *
  * The `fallback` is the library default, overridable by a theme registering the
- * same key (for example `'richtext:bold'`).
+ * same key (for example `'richtext:bold'`). A function entry is read at
+ * `{size: 'md'}`, and its result is final: a nullish result does not fall
+ * back.
  * @example
  * ```
  * getExtendedIcon('richtext:bold', <BoldGlyph />)

package/dist/Icon/globalIconRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globalIconRegistry.d.ts","sourceRoot":"","sources":["../../src/Icon/globalIconRegistry.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAQvD;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,GACd,eAAe,GACf,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,cAAc,GACd,MAAM,GACN,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,QAAQ,GACR,UAAU,GACV,aAAa,GACb,MAAM,GACN,aAAa,GACb,QAAQ,GACR,MAAM,GACN,YAAY,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAgC1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,GAClD,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAyBvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,gBAAgB,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAOX;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAQX;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}
+{"version":3,"file":"globalIconRegistry.d.ts","sourceRoot":"","sources":["../../src/Icon/globalIconRegistry.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAQvD;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,GACd,eAAe,GACf,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,cAAc,GACd,MAAM,GACN,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,QAAQ,GACR,UAAU,GACV,aAAa,GACb,MAAM,GACN,aAAa,GACb,QAAQ,GACR,MAAM,GACN,YAAY,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,MAAM,GAAG,WAAW,IAAI,QAAQ,CAAC;IACvE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,MAAM,GAAG,WAAW,IACxD,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;AAQ7D,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAgE1E;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,GAC1B,SAAS,CAEX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,GAClD,IAAI,CAON;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAsBvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,gBAAgB,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAEX;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAKX;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/Icon/globalIconRegistry.js

@@ -2,12 +2,21 @@
 
 /**
  * @file globalIconRegistry.tsx
- * @input None (pure module-level state)
- * @output Exports registerIcons, getIconRegistry, getIcon, resetIcons, IconName, IconRegistry
+ * @input Theme icon entries (a DefinedTheme or a registered theme name), the
+ *   process-wide registry, and built-in defaults
+ * @output Exports registerIcons, getIconRegistry, getIcon, getExtendedIcon,
+ *   resetIcons, resolveIcon (internal), IconName, IconRegistry, IconEntry,
+ *   IconRequest
  * @position Global and theme-scoped icon registry; works in server and client environments
  *
  * This module has NO 'use client' directive — it's importable from RSC.
  * Components resolve semantic icons through getIcon() or the client useIcon() hook.
+ *
+ * An entry is a React node or a pure synchronous function of an
+ * {@link IconRequest}. Resolution picks one source — theme entry, then
+ * process-wide registration, then built-in default; a nullish static entry
+ * falls through — and a selected function's result is final. `Icon` passes
+ * its resolved size; the public reads below pass `{size: 'md'}`.
  */
 
 import { defaultIcons } from "./defaultIcons.js";
@@ -53,6 +62,45 @@ import { warnOnce } from "../utils/devWarning.js";
  * A complete icon registry: every semantic name mapped to a React node.
  */
 
+/**
+ * What `Icon` asks a function icon entry for: the final Icon size, resolved
+ * explicit `size` → owning component's default → `'md'`, and a variant name
+ * or `undefined`.
+ *
+ * Inside `defineTheme`, `Variant` is the theme's listed `iconVariants`; a
+ * process-wide registration receives {@link IconVariant}.
+ */
+
+/**
+ * A theme or process-wide icon entry: a React node, or a pure synchronous
+ * function of the {@link IconRequest} that returns one.
+ *
+ * A function computes its result from the request only — no hooks, DOM or
+ * SVG measurement, browser globals, network access, mutable module state, or
+ * side effects. Once selected, its result is final: returning `null` or
+ * `undefined` renders no glyph instead of falling through to another source.
+ *
+ * @example
+ * ```
+ * defineTheme({
+ *   name: 'brand',
+ *   icons: {
+ *     info: ({size}) => <InfoIcon weight={size === 'sm' ? 'bold' : 'regular'} />,
+ *   },
+ * });
+ * ```
+ */
+
+/**
+ * How resolution holds any entry: an entry typed for some variant names
+ * accepts a request with none of them.
+ */
+
+/** The request every public, one-argument read uses. */
+const PUBLIC_READ_REQUEST = {
+  size: 'md'
+};
+
 // =============================================================================
 // Global Registry
 // =============================================================================
@@ -68,14 +116,42 @@ let globalRegistry = {};
 function isNamespacedKey(name) {
   return name.includes(':');
 }
-function getThemeIconOverrides(source) {
-  if (source == null) {
+
+/**
+ * The theme's icon entries, functions included. A theme from `defineTheme`
+ * keeps them in `__icons` when any entry is a function (its public `icons`
+ * is the node view); otherwise `icons` already holds them.
+ */
+function getThemeIconEntries(source) {
+  const theme = typeof source === 'string' ? getRegisteredTheme(source) : source;
+  if (theme == null) {
     return null;
   }
-  if (typeof source === 'string') {
-    return getRegisteredTheme(source)?.icons ?? null;
-  }
-  return source.icons ?? null;
+  return theme.__icons ?? theme.icons ?? null;
+}
+
+/**
+ * Pick the one source that answers `name`: the theme entry, then the
+ * process-wide registration, then the built-in default, then `fallback`. A
+ * nullish static entry falls through; a function is returned as-is, because
+ * its result is final.
+ */
+function selectIconEntry(name, source, fallback) {
+  return getThemeIconEntries(source)?.[name] ?? globalRegistry[name] ?? defaultIcons[name] ?? fallback;
+}
+
+/** Read an entry for a request: call a function, return a node as-is. */
+function readIconEntry(entry, request) {
+  return typeof entry === 'function' ? entry(request) : entry;
+}
+
+/**
+ * Resolve a key for an Icon request. `Icon` is the caller: it passes the size
+ * it resolved. Public reads use {@link getIcon} instead.
+ * @internal
+ */
+export function resolveIcon(name, source, request) {
+  return readIconEntry(selectIconEntry(name, source), request);
 }
 
 /**
@@ -100,6 +176,13 @@ function getThemeIconOverrides(source) {
  * ```
  * registerIcons({ 'richtext:bold': <MyBoldIcon /> });
  * ```
+ *
+ * An entry may also be a pure synchronous function of `{size, variant}`
+ * ({@link IconEntry}); `Icon` passes it the size it renders at.
+ * @example
+ * ```
+ * registerIcons({ info: ({size}) => <InfoIcon weight={size === 'sm' ? 'bold' : 'regular'} /> });
+ * ```
  */
 export function registerIcons(icons) {
   warnOnce('icon-registry:global-register-icons', 'Icon', '`registerIcons()` applies icon overrides globally. Prefer `defineTheme({ icons })` for theme-scoped icon overrides.');
@@ -116,6 +199,9 @@ export function registerIcons(icons) {
  * Works in both server and client environments. Useful for tooling that needs
  * to derive valid semantic icon-name options from the same registry Icon
  * resolves against.
+ *
+ * Every value is a React node: a function entry is read at `{size: 'md'}`,
+ * exactly as {@link getIcon} reads it.
  */
 export function getIconRegistry(source) {
   const registry = {};
@@ -124,20 +210,15 @@ export function getIconRegistry(source) {
   // contributed by a library or shipped as a component's own default, are
   // resolved via getIcon/getExtendedIcon and intentionally kept out of the
   // typed IconRegistry snapshot.
-  for (const name of Object.keys(defaultIcons)) {
+  const names = new Set(Object.keys(defaultIcons));
+  for (const name of Object.keys(getThemeIconEntries(source) ?? {})) {
+    names.add(name);
+  }
+  for (const name of names) {
     if (isNamespacedKey(name)) {
       continue;
     }
-    registry[name] = globalRegistry[name] ?? defaultIcons[name];
-  }
-  const themeIcons = getThemeIconOverrides(source);
-  if (themeIcons != null) {
-    for (const name of Object.keys(themeIcons)) {
-      if (isNamespacedKey(name)) {
-        continue;
-      }
-      registry[name] = themeIcons[name] ?? registry[name];
-    }
+    registry[name] = readIconEntry(selectIconEntry(name, source), PUBLIC_READ_REQUEST);
   }
   return registry;
 }
@@ -152,10 +233,12 @@ export function getIconRegistry(source) {
  * {@link IconName}s — useful for library-contributed icons. For a
  * caller-supplied fallback when a key isn't registered, use
  * {@link getExtendedIcon}.
+ *
+ * Returns a React node: a function entry is read at `{size: 'md'}`. Render
+ * `<Icon icon={name} />` to request another size.
  */
 export function getIcon(name, source) {
-  const themeIcons = getThemeIconOverrides(source);
-  return themeIcons?.[name] ?? globalRegistry[name] ?? defaultIcons[name];
+  return readIconEntry(selectIconEntry(name, source), PUBLIC_READ_REQUEST);
 }
 
 /**
@@ -168,15 +251,16 @@ export function getIcon(name, source) {
  * widen the core {@link IconName} union.
  *
  * The `fallback` is the library default, overridable by a theme registering the
- * same key (for example `'richtext:bold'`).
+ * same key (for example `'richtext:bold'`). A function entry is read at
+ * `{size: 'md'}`, and its result is final: a nullish result does not fall
+ * back.
  * @example
  * ```
  * getExtendedIcon('richtext:bold', <BoldGlyph />)
  * ```
  */
 export function getExtendedIcon(name, fallback, source) {
-  const themeIcons = getThemeIconOverrides(source);
-  return themeIcons?.[name] ?? globalRegistry[name] ?? defaultIcons[name] ?? fallback;
+  return readIconEntry(selectIconEntry(name, source, fallback), PUBLIC_READ_REQUEST);
 }
 
 /**

package/dist/Icon/index.d.ts

@@ -1,14 +1,38 @@
 /**
  * @file index.ts
  * @input Imports Icon component/types, icon registry, and global registration
- * @output Exports Icon, icon registry helpers, registerIcons, getIconRegistry, getIcon
+ * @output Exports Icon, icon registry helpers, registerIcons, getIconRegistry, getIcon,
+ *   the IconEntry/IconRequest types for theme and registered entries, and the
+ *   augmentable IconVariantMap with its IconVariant names
  * @position Component entry point; re-exported by /packages/core/src/index.ts
  *
  * SYNC: When modified, update this header and /packages/core/src/Icon/Icon.doc.mjs
  */
-export { Icon, renderIconSlot } from './Icon';
-export { useIcon } from './useIcon';
-export type { IconProps, IconColor, IconSize, IconType } from './Icon';
-export { registerIcons, getIconRegistry, getIcon, getExtendedIcon, resetIcons, } from './globalIconRegistry';
-export type { IconName, ExtendedIconName, NamespacedIconName, IconRegistry, IconRegistrySource, } from './globalIconRegistry';
+/**
+ * Icon variant names an application uses. Astryx defines none: a theme lists
+ * the names it supports in `defineTheme({iconVariants})`, and an application
+ * augments this map with the names it requests.
+ *
+ * A theme icon entry receives a requested variant only when the active theme
+ * lists it; any other request renders the entry's normal artwork.
+ *
+ * @example
+ * ```
+ * declare module '@astryxdesign/core/Icon' {
+ *   interface IconVariantMap {
+ *     outline: true;
+ *     filled: true;
+ *   }
+ * }
+ * ```
+ */
+export interface IconVariantMap {
+}
+/** A variant name from the augmentable {@link IconVariantMap}. */
+export type IconVariant = keyof IconVariantMap & string;
+export { Icon, renderIconSlot } from './Icon.js';
+export { useIcon } from './useIcon.js';
+export type { IconProps, IconColor, IconSize, IconType } from './Icon.js';
+export { registerIcons, getIconRegistry, getIcon, getExtendedIcon, resetIcons, } from './globalIconRegistry.js';
+export type { IconName, ExtendedIconName, NamespacedIconName, IconRegistry, IconRegistrySource, IconEntry, IconRequest, } from './globalIconRegistry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Icon/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Icon/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,YAAY,EAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGrE,OAAO,EACL,aAAa,EACb,eAAe,EACf,OAAO,EACP,eAAe,EACf,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Icon/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,cAAc;CAAG;AAElC,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,MAAM,cAAc,GAAG,MAAM,CAAC;AAExD,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,YAAY,EAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGrE,OAAO,EACL,aAAa,EACb,eAAe,EACf,OAAO,EACP,eAAe,EACf,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,GACZ,MAAM,sBAAsB,CAAC"}

package/dist/Icon/index.js

@@ -5,11 +5,34 @@
 /**
  * @file index.ts
  * @input Imports Icon component/types, icon registry, and global registration
- * @output Exports Icon, icon registry helpers, registerIcons, getIconRegistry, getIcon
+ * @output Exports Icon, icon registry helpers, registerIcons, getIconRegistry, getIcon,
+ *   the IconEntry/IconRequest types for theme and registered entries, and the
+ *   augmentable IconVariantMap with its IconVariant names
  * @position Component entry point; re-exported by /packages/core/src/index.ts
  *
  * SYNC: When modified, update this header and /packages/core/src/Icon/Icon.doc.mjs
  */
+
+/**
+ * Icon variant names an application uses. Astryx defines none: a theme lists
+ * the names it supports in `defineTheme({iconVariants})`, and an application
+ * augments this map with the names it requests.
+ *
+ * A theme icon entry receives a requested variant only when the active theme
+ * lists it; any other request renders the entry's normal artwork.
+ *
+ * @example
+ * ```
+ * declare module '@astryxdesign/core/Icon' {
+ *   interface IconVariantMap {
+ *     outline: true;
+ *     filled: true;
+ *   }
+ * }
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- augmentation point
+/** A variant name from the augmentable {@link IconVariantMap}. */
 export { Icon, renderIconSlot } from "./Icon.js";
 export { useIcon } from "./useIcon.js";
 // Global registry (RSC-compatible, no 'use client')

package/dist/Icon/useIcon.d.ts

@@ -1,17 +1,21 @@
 /**
  * @file useIcon.ts
  * @input Semantic icon name
- * @output Exports useIcon hook for theme-aware icon lookup
+ * @output Exports useIcon hook for theme-aware icon lookup (node-valued; a
+ *   function entry is read at `{size: 'md'}`)
  * @position Client hook for components that render registry icons directly
  */
 import type { ReactNode } from 'react';
-import { type IconName, type NamespacedIconName } from './globalIconRegistry';
+import { type IconName, type NamespacedIconName } from './globalIconRegistry.js';
 /**
  * Resolve a semantic icon name from the nearest Theme, falling back through
  * root theme registration, global icon overrides, and built-in defaults.
  *
  * Accepts a namespaced extension key (`'richtext:bold'`) as well as a built-in
  * name; both resolve through the same registry.
+ *
+ * Returns a React node: a function entry is read at `{size: 'md'}`. Render
+ * `<Icon icon={name} />` to resolve the entry at another size.
  */
 export declare function useIcon(name: IconName | NamespacedIconName): ReactNode;
 //# sourceMappingURL=useIcon.d.ts.map

package/dist/Icon/useIcon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIcon.d.ts","sourceRoot":"","sources":["../../src/Icon/useIcon.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAGtE"}
+{"version":3,"file":"useIcon.d.ts","sourceRoot":"","sources":["../../src/Icon/useIcon.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAGtE"}

package/dist/Icon/useIcon.js

@@ -5,7 +5,8 @@
 /**
  * @file useIcon.ts
  * @input Semantic icon name
- * @output Exports useIcon hook for theme-aware icon lookup
+ * @output Exports useIcon hook for theme-aware icon lookup (node-valued; a
+ *   function entry is read at `{size: 'md'}`)
  * @position Client hook for components that render registry icons directly
  */
 import { useThemeName } from "../theme/useTheme.js";
@@ -17,6 +18,9 @@ import { getIcon } from "./globalIconRegistry.js";
  *
  * Accepts a namespaced extension key (`'richtext:bold'`) as well as a built-in
  * name; both resolve through the same registry.
+ *
+ * Returns a React node: a function entry is read at `{size: 'md'}`. Render
+ * `<Icon icon={name} />` to resolve the entry at another size.
  */
 export function useIcon(name) {
   const themeName = useThemeName();

package/dist/IconButton/IconButton.d.ts

@@ -12,7 +12,7 @@
  * - /packages/cli/assets/templates/blocks/components/IconButton/ (showcase blocks)
  */
 import type { ReactNode } from 'react';
-import type { ButtonProps } from '../Button/Button';
+import type { ButtonProps } from '../Button/Button.js';
 /**
  * Props for IconButton.
  *

package/dist/IconButton/index.d.ts

@@ -6,6 +6,6 @@
  *
  * SYNC: When modified, update this header and /packages/core/src/IconButton/IconButton.doc.mjs
  */
-export { IconButton } from './IconButton';
-export type { IconButtonProps } from './IconButton';
+export { IconButton } from './IconButton.js';
+export type { IconButtonProps } from './IconButton.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Indicator/CheckIndicator.d.ts

@@ -1,4 +1,4 @@
-import type { IndicatorProps } from './types';
+import type { IndicatorProps } from './types.js';
 /**
  * The default single-selection mark: a checkmark when chosen, nothing when not.
  *

package/dist/Indicator/CheckboxIndicator.d.ts

@@ -1,4 +1,4 @@
-import type { IndicatorProps } from './types';
+import type { IndicatorProps } from './types.js';
 /**
  * The default checkbox visual: a square box with a checkmark or an
  * indeterminate bar.

package/dist/Indicator/RadioIndicator.d.ts

@@ -1,4 +1,4 @@
-import type { IndicatorProps } from './types';
+import type { IndicatorProps } from './types.js';
 /**
  * The default radio visual: a circle with a filled inner dot when selected.
  *

package/dist/Indicator/index.d.ts

@@ -13,12 +13,12 @@
  * replaceable wholesale by name through `defineTheme({indicators})` — replace
  * `check` and every single-selection mark in the app follows.
  */
-export { CheckboxIndicator } from './CheckboxIndicator';
-export { CheckIndicator } from './CheckIndicator';
-export { RadioIndicator } from './RadioIndicator';
-export { defaultIndicators, getIndicator } from './indicatorRegistry';
-export type { CoreIndicatorName, IndicatorRegistrySource, } from './indicatorRegistry';
-export { useIndicator } from './useIndicator';
-export { indicatorScope } from './indicator.markers.stylex';
-export type { IndicatorComponent, IndicatorFamily, IndicatorFamilyMap, IndicatorMap, IndicatorName, IndicatorNameOfFamily, IndicatorPosition, IndicatorProps, IndicatorRegistry, IndicatorSize, IndicatorState, } from './types';
+export { CheckboxIndicator } from './CheckboxIndicator.js';
+export { CheckIndicator } from './CheckIndicator.js';
+export { RadioIndicator } from './RadioIndicator.js';
+export { defaultIndicators, getIndicator } from './indicatorRegistry.js';
+export type { CoreIndicatorName, IndicatorRegistrySource, } from './indicatorRegistry.js';
+export { useIndicator } from './useIndicator.js';
+export { indicatorScope } from './indicator.markers.stylex.js';
+export type { IndicatorComponent, IndicatorFamily, IndicatorFamilyMap, IndicatorMap, IndicatorName, IndicatorNameOfFamily, IndicatorPosition, IndicatorProps, IndicatorRegistry, IndicatorSize, IndicatorState, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Indicator/indicatorRegistry.d.ts

@@ -21,8 +21,8 @@
  * promise a component for `getIndicator('brand-star')` and hand back
  * `undefined` at runtime.
  */
-import type { DefinedTheme } from '../theme/defineTheme';
-import type { IndicatorComponent, IndicatorMap, IndicatorName } from './types';
+import type { DefinedTheme } from '../theme/defineTheme.js';
+import type { IndicatorComponent, IndicatorMap, IndicatorName } from './types.js';
 /**
  * The indicator names Astryx ships a default for.
  *

package/dist/Indicator/types.d.ts

@@ -32,7 +32,7 @@
  * `state={isOpen ? 'on' : 'off'}`.
  */
 import type { ComponentType, ReactNode, Ref } from 'react';
-import type { BaseProps } from '../BaseProps';
+import type { BaseProps } from '../BaseProps.js';
 /**
  * The indicator families, each mapped to the states it can express.
  *

package/dist/Indicator/useIndicator.d.ts

@@ -1,5 +1,5 @@
-import { type CoreIndicatorName } from './indicatorRegistry';
-import type { IndicatorComponent, IndicatorMap, IndicatorName } from './types';
+import { type CoreIndicatorName } from './indicatorRegistry.js';
+import type { IndicatorComponent, IndicatorMap, IndicatorName } from './types.js';
 /**
  * Resolve an indicator component from the nearest `<Theme>`.
  *

package/dist/InputGroup/InputGroup.d.ts

@@ -15,8 +15,8 @@
  * - /packages/cli/assets/templates/blocks/components/InputGroup/
  */
 import { type ReactNode } from 'react';
-import { type InputStatus } from '../Field';
-import type { BaseProps } from '../BaseProps';
+import { type InputStatus } from '../Field/index.js';
+import type { BaseProps } from '../BaseProps.js';
 export type InputGroupSize = 'sm' | 'md' | 'lg';
 export interface InputGroupProps extends Omit<BaseProps<HTMLDivElement>, 'children'> {
     /** Ref forwarded to the group container element */
@@ -83,7 +83,7 @@ export interface InputGroupProps extends Omit<BaseProps<HTMLDivElement>, 'childr
  * </InputGroup>
  * ```
  */
-export declare function InputGroup({ children, label, isLabelHidden, description, isDisabled, isOptional, isRequired, size: sizeProp, status, labelTooltip, xstyle, className, style, ref, 'data-testid': testId, ...rest }: InputGroupProps): import("react").JSX.Element;
+export declare function InputGroup({ children, label, isLabelHidden, description, isDisabled: isDisabledProp, isOptional, isRequired, size: sizeProp, status, labelTooltip, xstyle, className, style, ref, 'data-testid': testId, ...rest }: InputGroupProps): import("react").JSX.Element;
 export declare namespace InputGroup {
     var displayName: string;
 }

package/dist/InputGroup/InputGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputGroup.d.ts","sourceRoot":"","sources":["../../src/InputGroup/InputGroup.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAGrD,OAAO,EAAQ,KAAK,WAAW,EAAC,MAAM,UAAU,CAAC;AAGjD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAI5C,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AA0BhD,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAC3C,SAAS,CAAC,cAAc,CAAC,EACzB,UAAU,CACX;IACC,mDAAmD;IACnD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,KAAK,EACL,aAAqB,EACrB,WAAW,EACX,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,IAAI,EAAE,QAAQ,EACd,MAAM,EACN,YAAY,EACZ,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,aAAa,EAAE,MAAM,EACrB,GAAG,IAAI,EACR,EAAE,eAAe,+BAwEjB;yBAzFe,UAAU"}
+{"version":3,"file":"InputGroup.d.ts","sourceRoot":"","sources":["../../src/InputGroup/InputGroup.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAsB,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAG1D,OAAO,EAAQ,KAAK,WAAW,EAAC,MAAM,UAAU,CAAC;AAGjD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAK5C,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AA0BhD,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAC3C,SAAS,CAAC,cAAc,CAAC,EACzB,UAAU,CACX;IACC,mDAAmD;IACnD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,KAAK,EACL,aAAqB,EACrB,WAAW,EACX,UAAU,EAAE,cAAsB,EAClC,UAAkB,EAClB,UAAkB,EAClB,IAAI,EAAE,QAAQ,EACd,MAAM,EACN,YAAY,EACZ,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,aAAa,EAAE,MAAM,EACrB,GAAG,IAAI,EACR,EAAE,eAAe,+BA8EjB;yBA/Fe,UAAU"}