@declarion/react 0.6.12 → 0.6.13

package/dist-lib/stores/icon-registry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * One declared glyph. Matches the wire JSON the Go side serves on /api/schema
+ * as `icons` (plan §4):
+ *   - svg:    geometry-only path `d` strings, rendered into the fixed 24x24
+ *             stroke frame (the same frame as the built-in set).
+ *   - lucide: a Lucide icon name, lazily resolved via dynamicIconImports.
+ *   - url:    an asset URL, rendered via <img src> ONLY (security boundary, §6).
+ */
+export type IconDef = {
+    kind: "svg";
+    paths: string[];
+} | {
+    kind: "lucide";
+    name: string;
+} | {
+    kind: "url";
+    src: string;
+};
+/**
+ * Replace the entire icon registry with `icons`. Called ONCE by the consumer
+ * after the schema fetch resolves (and again on an identity switch re-fetch).
+ * Replace-all (not merge) because the registry mirrors exactly the current
+ * deployment's declared set; a stale entry from a prior identity must not
+ * survive the switch. Notifies subscribers so mounted DynamicIcons re-render.
+ */
+export declare function setIconRegistry(icons: Record<string, IconDef>): void;
+/** Read one declared glyph, or undefined when the name is not in the registry. */
+export declare function getIcon(name: string): IconDef | undefined;
+/**
+ * Subscribe to registry replacement. Returns an unsubscribe fn. Pairs with
+ * getIconRegistryVersion as the useSyncExternalStore (subscribe, getSnapshot).
+ */
+export declare function subscribeIconRegistry(listener: () => void): () => void;
+/**
+ * Monotonic snapshot of the registry's identity. Increments on every
+ * setIconRegistry call so useSyncExternalStore detects a replacement and
+ * re-renders. A primitive (number) snapshot is referentially stable between
+ * notifications, satisfying useSyncExternalStore's tear-checking contract.
+ */
+export declare function getIconRegistryVersion(): number;

package/dist-lib/types/schema.d.ts

@@ -1,6 +1,8 @@
 import { OrderedMap } from "./ordmap";
 import type { FileFieldDef } from "./files";
+import type { IconDef } from "../stores/icon-registry";
 export { OrderedMap };
+export type { IconDef };
 export type LocalizedString = Record<string, string>;
 /**
  * Per-entity empty-state copy declared in the manifest under
@@ -816,6 +818,15 @@ export interface Schema {
      * map when rendering locked-widget badges.
      */
     classifications?: Record<string, ClassificationTierDef>;
+    /**
+     * Consumer-declared icon glyphs, keyed by the name referenced at `icon:`
+     * call sites. Carries ONLY declared/overridden entries (the built-in ~119
+     * travel as bare names, never here); absent when no module declares an
+     * `icons:` block. The Admin loads this into the runtime icon registry
+     * (setIconRegistry) so custom glyphs render across the chrome. Plan
+     * 2026-06-12-consumer-extensible-icons.md §4.
+     */
+    icons?: Record<string, IconDef>;
 }
 /**
  * Plan 2026-05-26 §B9. One entry in the top-level classifications map.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.6.12",
+  "version": "0.6.13",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",
@@ -15,6 +15,11 @@
       "import": "./dist-lib/index.js",
       "default": "./dist-lib/index.js"
     },
+    "./icons": {
+      "types": "./dist-lib/icons.d.ts",
+      "import": "./dist-lib/icons.js",
+      "default": "./dist-lib/icons.js"
+    },
     "./vite": {
       "types": "./dist-lib/vite/index.d.ts",
       "import": "./dist-lib/vite/index.js",
@@ -52,6 +57,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "date-fns": "^4.4.0",
+    "lucide-react": "^1.17.0",
     "mdast-util-to-string": "^4.0.0",
     "monaco-editor": "^0.55.1",
     "react-markdown": "^10.1.0",