@cratis/scene.react 4.3.0 → 4.4.0

package/dist/esm/icons/IconAdapter.d.ts

@@ -0,0 +1,13 @@
+import { ComponentType } from 'react';
+import { IconReference } from '@cratis/scene.model';
+export interface IconGlyphProps {
+    size: number | string;
+    color: string;
+    className?: string;
+}
+export type IconGlyph = ComponentType<IconGlyphProps>;
+export interface IconAdapter {
+    library: string;
+    loadGlyph(reference: IconReference): Promise<IconGlyph | undefined> | IconGlyph | undefined;
+}
+//# sourceMappingURL=IconAdapter.d.ts.map

package/dist/esm/icons/IconAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconAdapter.d.ts","sourceRoot":"","sources":["../../../icons/IconAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,MAAM,WAAW,cAAc;IAI3B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAKtB,KAAK,EAAE,MAAM,CAAC;IAKd,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;AAWtD,MAAM,WAAW,WAAW;IAIxB,OAAO,EAAE,MAAM,CAAC;IAKhB,SAAS,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,CAAC;CAC/F"}

package/dist/esm/icons/IconAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IconAdapter.js.map

package/dist/esm/icons/IconAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconAdapter.js","sourceRoot":"","sources":["../../../icons/IconAdapter.ts"],"names":[],"mappings":""}

package/dist/esm/icons/IconAdapterContext.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { IconAdapterRegistry } from './IconAdapterRegistry';
+export declare const IconAdapterProvider: ({ registry, children }: {
+    registry: IconAdapterRegistry;
+    children?: ReactNode;
+}) => import("react").JSX.Element;
+export declare function useIconAdapters(): IconAdapterRegistry | undefined;
+//# sourceMappingURL=IconAdapterContext.d.ts.map

package/dist/esm/icons/IconAdapterContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconAdapterContext.d.ts","sourceRoot":"","sources":["../../../icons/IconAdapterContext.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAO5D,eAAO,MAAM,mBAAmB,2BAA4B;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,gCAElH,CAAC;AAKF,wBAAgB,eAAe,IAAI,mBAAmB,GAAG,SAAS,CAEjE"}

package/dist/esm/icons/IconAdapterContext.js

@@ -0,0 +1,18 @@
+import { jsx } from 'react/jsx-runtime';
+import { useContext, createContext } from 'react';
+
+const IconAdapterContext = /*#__PURE__*/ createContext(undefined);
+/**
+ * Supplies the icon adapters every `SceneIcon` below it renders through.
+ */ const IconAdapterProvider = ({ registry, children })=>/*#__PURE__*/ jsx(IconAdapterContext.Provider, {
+        value: registry,
+        children: children
+    });
+/**
+ * The icon adapters in scope, or `undefined` outside an {@link IconAdapterProvider}.
+ */ function useIconAdapters() {
+    return useContext(IconAdapterContext);
+}
+
+export { IconAdapterProvider, useIconAdapters };
+//# sourceMappingURL=IconAdapterContext.js.map

package/dist/esm/icons/IconAdapterContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconAdapterContext.js","sources":["../../../icons/IconAdapterContext.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ReactNode, createContext, useContext } from 'react';\nimport { IconAdapterRegistry } from './IconAdapterRegistry';\n\nconst IconAdapterContext = createContext<IconAdapterRegistry | undefined>(undefined);\n\n/**\n * Supplies the icon adapters every `SceneIcon` below it renders through.\n */\nexport const IconAdapterProvider = ({ registry, children }: { registry: IconAdapterRegistry; children?: ReactNode }) => (\n    <IconAdapterContext.Provider value={registry}>{children}</IconAdapterContext.Provider>\n);\n\n/**\n * The icon adapters in scope, or `undefined` outside an {@link IconAdapterProvider}.\n */\nexport function useIconAdapters(): IconAdapterRegistry | undefined {\n    return useContext(IconAdapterContext);\n}\n"],"names":["IconAdapterContext","createContext","undefined","IconAdapterProvider","registry","children","_jsx","Provider","value","useIconAdapters","useContext"],"mappings":";;;AAMA,MAAMA,mCAAqBC,aAAAA,CAA+CC,SAAAA,CAAAA;AAE1E;;AAEC,IACM,MAAMC,mBAAAA,GAAsB,CAAC,EAAEC,QAAQ,EAAEC,QAAQ,EAA2D,iBAC/GC,GAAA,CAACN,kBAAAA,CAAmBO,QAAQ,EAAA;QAACC,KAAAA,EAAOJ,QAAAA;AAAWC,QAAAA,QAAAA,EAAAA;AACjD,KAAA;AAEF;;AAEC,IACM,SAASI,eAAAA,GAAAA;AACZ,IAAA,OAAOC,UAAAA,CAAWV,kBAAAA,CAAAA;AACtB;;"}

package/dist/esm/icons/IconAdapterRegistry.d.ts

@@ -0,0 +1,9 @@
+import { IconAdapter } from './IconAdapter';
+export declare class IconAdapterRegistry {
+    #private;
+    register(adapter: IconAdapter): this;
+    get(library: string): IconAdapter | undefined;
+    get libraries(): string[];
+}
+export declare function createIconAdapterRegistry(adapters?: IconAdapter[]): IconAdapterRegistry;
+//# sourceMappingURL=IconAdapterRegistry.d.ts.map

package/dist/esm/icons/IconAdapterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconAdapterRegistry.d.ts","sourceRoot":"","sources":["../../../icons/IconAdapterRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,qBAAa,mBAAmB;;IAQ5B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAOnC;IAKD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE5C;IAKD,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;CACJ;AAKD,wBAAgB,yBAAyB,CAAC,QAAQ,GAAE,WAAW,EAAO,GAAG,mBAAmB,CAI3F"}

package/dist/esm/icons/IconAdapterRegistry.js

@@ -0,0 +1,42 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The icon adapters a renderer has, one per library. Registering is explicit and never replaces: two
+ * adapters for one library would mean an icon renders differently depending on registration order, which
+ * is the silent swapping the library-qualified reference exists to prevent.
+ */ class IconAdapterRegistry {
+    #adapters = new Map();
+    /**
+     * Adds an adapter.
+     *
+     * @throws Error when an adapter for the same library is already registered.
+     */ register(adapter) {
+        if (this.#adapters.has(adapter.library)) {
+            throw new Error(`An icon adapter for the library '${adapter.library}' is already registered`);
+        }
+        this.#adapters.set(adapter.library, adapter);
+        return this;
+    }
+    /**
+     * The adapter for a library, or `undefined` when this renderer has none.
+     */ get(library) {
+        return this.#adapters.get(library);
+    }
+    /**
+     * The libraries this registry can render.
+     */ get libraries() {
+        return [
+            ...this.#adapters.keys()
+        ];
+    }
+}
+/**
+ * Creates a registry holding the given adapters.
+ */ function createIconAdapterRegistry(adapters = []) {
+    const registry = new IconAdapterRegistry();
+    adapters.forEach((adapter)=>registry.register(adapter));
+    return registry;
+}
+
+export { IconAdapterRegistry, createIconAdapterRegistry };
+//# sourceMappingURL=IconAdapterRegistry.js.map

package/dist/esm/icons/IconAdapterRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconAdapterRegistry.js","sources":["../../../icons/IconAdapterRegistry.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IconAdapter } from './IconAdapter';\n\n/**\n * The icon adapters a renderer has, one per library. Registering is explicit and never replaces: two\n * adapters for one library would mean an icon renders differently depending on registration order, which\n * is the silent swapping the library-qualified reference exists to prevent.\n */\nexport class IconAdapterRegistry {\n    readonly #adapters = new Map<string, IconAdapter>();\n\n    /**\n     * Adds an adapter.\n     *\n     * @throws Error when an adapter for the same library is already registered.\n     */\n    register(adapter: IconAdapter): this {\n        if (this.#adapters.has(adapter.library)) {\n            throw new Error(`An icon adapter for the library '${adapter.library}' is already registered`);\n        }\n\n        this.#adapters.set(adapter.library, adapter);\n        return this;\n    }\n\n    /**\n     * The adapter for a library, or `undefined` when this renderer has none.\n     */\n    get(library: string): IconAdapter | undefined {\n        return this.#adapters.get(library);\n    }\n\n    /**\n     * The libraries this registry can render.\n     */\n    get libraries(): string[] {\n        return [...this.#adapters.keys()];\n    }\n}\n\n/**\n * Creates a registry holding the given adapters.\n */\nexport function createIconAdapterRegistry(adapters: IconAdapter[] = []): IconAdapterRegistry {\n    const registry = new IconAdapterRegistry();\n    adapters.forEach((adapter) => registry.register(adapter));\n    return registry;\n}\n"],"names":["IconAdapterRegistry","Map","register","adapter","has","library","Error","set","get","libraries","keys","createIconAdapterRegistry","adapters","registry","forEach"],"mappings":"AAAA;AACA;AAIA;;;;AAIC,IACM,MAAMA,mBAAAA,CAAAA;IACA,SAAS,GAAG,IAAIC,GAAAA,EAAAA;AAEzB;;;;QAKAC,QAAAA,CAASC,OAAoB,EAAQ;QACjC,IAAI,IAAI,CAAC,SAAS,CAACC,GAAG,CAACD,OAAAA,CAAQE,OAAO,CAAA,EAAG;YACrC,MAAM,IAAIC,MAAM,CAAC,iCAAiC,EAAEH,OAAAA,CAAQE,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAChG,QAAA;QAEA,IAAI,CAAC,SAAS,CAACE,GAAG,CAACJ,OAAAA,CAAQE,OAAO,EAAEF,OAAAA,CAAAA;AACpC,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;QAGAK,GAAAA,CAAIH,OAAe,EAA2B;AAC1C,QAAA,OAAO,IAAI,CAAC,SAAS,CAACG,GAAG,CAACH,OAAAA,CAAAA;AAC9B,IAAA;AAEA;;AAEC,QACD,IAAII,SAAAA,GAAsB;QACtB,OAAO;AAAI,YAAA,GAAA,IAAI,CAAC,SAAS,CAACC,IAAI;AAAG,SAAA;AACrC,IAAA;AACJ;AAEA;;AAEC,IACM,SAASC,yBAAAA,CAA0BC,QAAAA,GAA0B,EAAE,EAAA;AAClE,IAAA,MAAMC,WAAW,IAAIb,mBAAAA,EAAAA;AACrBY,IAAAA,QAAAA,CAASE,OAAO,CAAC,CAACX,OAAAA,GAAYU,QAAAA,CAASX,QAAQ,CAACC,OAAAA,CAAAA,CAAAA;IAChD,OAAOU,QAAAA;AACX;;"}

package/dist/esm/icons/IconLibraryBundle.d.ts

@@ -0,0 +1,7 @@
+import { IconCatalogSource } from '@cratis/scene.engine';
+import { IconAdapter } from './IconAdapter';
+export interface IconLibraryBundle {
+    catalog: IconCatalogSource;
+    adapter: IconAdapter;
+}
+//# sourceMappingURL=IconLibraryBundle.d.ts.map

package/dist/esm/icons/IconLibraryBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconLibraryBundle.d.ts","sourceRoot":"","sources":["../../../icons/IconLibraryBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5C,MAAM,WAAW,iBAAiB;IAI9B,OAAO,EAAE,iBAAiB,CAAC;IAK3B,OAAO,EAAE,WAAW,CAAC;CACxB"}

package/dist/esm/icons/IconLibraryBundle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IconLibraryBundle.js.map

package/dist/esm/icons/IconLibraryBundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconLibraryBundle.js","sourceRoot":"","sources":["../../../icons/IconLibraryBundle.ts"],"names":[],"mappings":""}

package/dist/esm/icons/SceneIcon.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { IconReference } from '@cratis/scene.model';
+import { IconAdapterRegistry } from './IconAdapterRegistry';
+export interface SceneIconProps {
+    reference: IconReference;
+    adapters?: IconAdapterRegistry;
+    size?: number | string;
+    color?: string;
+    label?: string;
+    className?: string;
+    fallback?: ReactNode;
+}
+export declare const SceneIcon: ({ reference, adapters, size, color, label, className, fallback }: SceneIconProps) => import("react").JSX.Element;
+//# sourceMappingURL=SceneIcon.d.ts.map

package/dist/esm/icons/SceneIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneIcon.d.ts","sourceRoot":"","sources":["../../../icons/SceneIcon.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,WAAW,cAAc;IAI3B,SAAS,EAAE,aAAa,CAAC;IAKzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAM/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAKvB,KAAK,CAAC,EAAE,MAAM,CAAC;IAMf,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,SAAS,CAAC,EAAE,MAAM,CAAC;IAMnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAMD,eAAO,MAAM,SAAS,qEAA+F,cAAc,gCAmBlI,CAAC"}

package/dist/esm/icons/SceneIcon.js

@@ -0,0 +1,40 @@
+import { jsx } from 'react/jsx-runtime';
+import { useIconAdapters } from './IconAdapterContext.js';
+import { useIconGlyph } from './useIconGlyph.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Draws a renderer-neutral {@link IconReference} through the adapter registered for its library, honoring
+ * size, color and accessible label. The reference is all that is persisted; this is where it becomes pixels.
+ */ const SceneIcon = ({ reference, adapters, size = '1em', color = 'currentColor', label, className, fallback })=>{
+    const inScope = useIconAdapters();
+    const state = useIconGlyph(reference, adapters ?? inScope);
+    const Glyph = state.status === 'ready' ? state.glyph : undefined;
+    return /*#__PURE__*/ jsx("span", {
+        className: className,
+        role: label ? 'img' : undefined,
+        "aria-label": label,
+        "aria-hidden": label ? undefined : true,
+        "data-icon-library": reference.library,
+        "data-icon-key": reference.key,
+        "data-icon-variant": reference.variant,
+        "data-icon-state": state.status,
+        style: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            width: size,
+            height: size,
+            color,
+            flexShrink: 0
+        },
+        children: Glyph ? /*#__PURE__*/ jsx(Glyph, {
+            size: size,
+            color: color
+        }) : state.status === 'unavailable' ? fallback : null
+    });
+};
+
+export { SceneIcon };
+//# sourceMappingURL=SceneIcon.js.map

package/dist/esm/icons/SceneIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneIcon.js","sources":["../../../icons/SceneIcon.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ReactNode } from 'react';\nimport { IconReference } from '@cratis/scene.model';\nimport { IconAdapterRegistry } from './IconAdapterRegistry';\nimport { useIconAdapters } from './IconAdapterContext';\nimport { useIconGlyph } from './useIconGlyph';\n\nexport interface SceneIconProps {\n    /**\n     * The icon to draw.\n     */\n    reference: IconReference;\n\n    /**\n     * The adapters to render through. Defaults to the ones an `IconAdapterProvider` supplies.\n     */\n    adapters?: IconAdapterRegistry;\n\n    /**\n     * The width and height of the icon: a number of pixels or any CSS length. Defaults to `1em`, so an\n     * icon scales with the text it sits in.\n     */\n    size?: number | string;\n\n    /**\n     * The color to draw in. Defaults to `currentColor`.\n     */\n    color?: string;\n\n    /**\n     * The accessible name. With a label the icon is announced as an image; without one it is decorative\n     * and hidden from assistive technology - an icon next to its own text label should not be read twice.\n     */\n    label?: string;\n\n    /**\n     * An optional class for the box the icon sits in.\n     */\n    className?: string;\n\n    /**\n     * What to show when the icon cannot be drawn - no adapter, no such icon, a failed load. Nothing by\n     * default; the box keeps its size so layout does not shift.\n     */\n    fallback?: ReactNode;\n}\n\n/**\n * Draws a renderer-neutral {@link IconReference} through the adapter registered for its library, honoring\n * size, color and accessible label. The reference is all that is persisted; this is where it becomes pixels.\n */\nexport const SceneIcon = ({ reference, adapters, size = '1em', color = 'currentColor', label, className, fallback }: SceneIconProps) => {\n    const inScope = useIconAdapters();\n    const state = useIconGlyph(reference, adapters ?? inScope);\n    const Glyph = state.status === 'ready' ? state.glyph : undefined;\n\n    return (\n        <span\n            className={className}\n            role={label ? 'img' : undefined}\n            aria-label={label}\n            aria-hidden={label ? undefined : true}\n            data-icon-library={reference.library}\n            data-icon-key={reference.key}\n            data-icon-variant={reference.variant}\n            data-icon-state={state.status}\n            style={{ display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: size, height: size, color, flexShrink: 0 }}>\n            {Glyph ? <Glyph size={size} color={color} /> : state.status === 'unavailable' ? fallback : null}\n        </span>\n    );\n};\n"],"names":["SceneIcon","reference","adapters","size","color","label","className","fallback","inScope","useIconAdapters","state","useIconGlyph","Glyph","status","glyph","undefined","_jsx","span","role","aria-label","aria-hidden","data-icon-library","library","data-icon-key","key","data-icon-variant","variant","data-icon-state","style","display","alignItems","justifyContent","width","height","flexShrink"],"mappings":";;;;AAAA;AACA;AAgDA;;;UAIaA,SAAAA,GAAY,CAAC,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,IAAAA,GAAO,KAAK,EAAEC,KAAAA,GAAQ,cAAc,EAAEC,KAAK,EAAEC,SAAS,EAAEC,QAAQ,EAAkB,GAAA;AAC/H,IAAA,MAAMC,OAAAA,GAAUC,eAAAA,EAAAA;IAChB,MAAMC,KAAAA,GAAQC,YAAAA,CAAaV,SAAAA,EAAWC,QAAAA,IAAYM,OAAAA,CAAAA;AAClD,IAAA,MAAMI,QAAQF,KAAAA,CAAMG,MAAM,KAAK,OAAA,GAAUH,KAAAA,CAAMI,KAAK,GAAGC,SAAAA;AAEvD,IAAA,qBACIC,GAAA,CAACC,MAAAA,EAAAA;QACGX,SAAAA,EAAWA,SAAAA;AACXY,QAAAA,IAAAA,EAAMb,QAAQ,KAAA,GAAQU,SAAAA;QACtBI,YAAAA,EAAYd,KAAAA;AACZe,QAAAA,aAAAA,EAAaf,QAAQU,SAAAA,GAAY,IAAA;AACjCM,QAAAA,mBAAAA,EAAmBpB,UAAUqB,OAAO;AACpCC,QAAAA,eAAAA,EAAetB,UAAUuB,GAAG;AAC5BC,QAAAA,mBAAAA,EAAmBxB,UAAUyB,OAAO;AACpCC,QAAAA,iBAAAA,EAAiBjB,MAAMG,MAAM;QAC7Be,KAAAA,EAAO;YAAEC,OAAAA,EAAS,aAAA;YAAeC,UAAAA,EAAY,QAAA;YAAUC,cAAAA,EAAgB,QAAA;YAAUC,KAAAA,EAAO7B,IAAAA;YAAM8B,MAAAA,EAAQ9B,IAAAA;AAAMC,YAAAA,KAAAA;YAAO8B,UAAAA,EAAY;AAAE,SAAA;AAChItB,QAAAA,QAAAA,EAAAA,KAAAA,iBAAQI,GAAA,CAACJ,KAAAA,EAAAA;YAAMT,IAAAA,EAAMA,IAAAA;YAAMC,KAAAA,EAAOA;aAAYM,KAAAA,CAAMG,MAAM,KAAK,aAAA,GAAgBN,QAAAA,GAAW;;AAGvG;;"}

package/dist/esm/icons/index.d.ts

@@ -0,0 +1,7 @@
+export * from './IconAdapter';
+export * from './IconAdapterRegistry';
+export * from './IconAdapterContext';
+export * from './useIconGlyph';
+export * from './SceneIcon';
+export * from './IconLibraryBundle';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/icons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../icons/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/esm/icons/index.js

@@ -0,0 +1,7 @@
+export * from './IconAdapter';
+export * from './IconAdapterRegistry';
+export * from './IconAdapterContext';
+export * from './useIconGlyph';
+export * from './SceneIcon';
+export * from './IconLibraryBundle';
+//# sourceMappingURL=index.js.map

package/dist/esm/icons/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../icons/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/esm/icons/useIconGlyph.d.ts

@@ -0,0 +1,14 @@
+import { IconReference } from '@cratis/scene.model';
+import { IconGlyph } from './IconAdapter';
+import { IconAdapterRegistry } from './IconAdapterRegistry';
+export type IconGlyphState = {
+    status: 'loading';
+} | {
+    status: 'ready';
+    glyph: IconGlyph;
+} | {
+    status: 'unavailable';
+    reason: string;
+};
+export declare function useIconGlyph(reference: IconReference, adapters: IconAdapterRegistry | undefined): IconGlyphState;
+//# sourceMappingURL=useIconGlyph.d.ts.map

package/dist/esm/icons/useIconGlyph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIconGlyph.d.ts","sourceRoot":"","sources":["../../../icons/useIconGlyph.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAe,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,MAAM,cAAc,GACpB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAmChD,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,GAAG,SAAS,GAAG,cAAc,CA6BhH"}

package/dist/esm/icons/useIconGlyph.js

@@ -0,0 +1,84 @@
+import { useState, useEffect } from 'react';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const loads = new WeakMap();
+function keyOf(reference) {
+    return JSON.stringify([
+        reference.key,
+        reference.variant ?? null
+    ]);
+}
+/**
+ * One load per adapter and icon, shared between every place the icon is drawn; a failed load is
+ * forgotten so the next render can try again.
+ */ function load(adapter, reference) {
+    let perAdapter = loads.get(adapter);
+    if (!perAdapter) {
+        perAdapter = new Map();
+        loads.set(adapter, perAdapter);
+    }
+    const key = keyOf(reference);
+    let pending = perAdapter.get(key);
+    if (!pending) {
+        pending = Promise.resolve().then(()=>adapter.loadGlyph(reference));
+        perAdapter.set(key, pending);
+        pending.catch(()=>perAdapter.delete(key));
+    }
+    return pending;
+}
+/**
+ * Loads the artwork for a reference through the adapter registered for its library. An absent registry,
+ * a library with no adapter, an icon the library lacks and a failed load are all `unavailable`, each with
+ * its reason - never a different icon.
+ */ function useIconGlyph(reference, adapters) {
+    const [state, setState] = useState({
+        status: 'loading'
+    });
+    const { library, key, variant } = reference;
+    useEffect(()=>{
+        let isCurrent = true;
+        const adapter = adapters?.get(library);
+        if (!adapter) {
+            setState({
+                status: 'unavailable',
+                reason: `No icon adapter is registered for the library '${library}'`
+            });
+            return;
+        }
+        setState({
+            status: 'loading'
+        });
+        load(adapter, {
+            library,
+            key,
+            variant
+        }).then((glyph)=>{
+            if (!isCurrent) return;
+            setState(glyph ? {
+                status: 'ready',
+                glyph
+            } : {
+                status: 'unavailable',
+                reason: `The library '${library}' has no icon '${key}'`
+            });
+        }, (error)=>{
+            if (isCurrent) setState({
+                status: 'unavailable',
+                reason: error instanceof Error ? error.message : String(error)
+            });
+        });
+        return ()=>{
+            isCurrent = false;
+        };
+    }, [
+        adapters,
+        library,
+        key,
+        variant
+    ]);
+    return state;
+}
+
+export { useIconGlyph };
+//# sourceMappingURL=useIconGlyph.js.map

package/dist/esm/icons/useIconGlyph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIconGlyph.js","sources":["../../../icons/useIconGlyph.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useEffect, useState } from 'react';\nimport { IconReference } from '@cratis/scene.model';\nimport { IconAdapter, IconGlyph } from './IconAdapter';\nimport { IconAdapterRegistry } from './IconAdapterRegistry';\n\n/**\n * Where loading one icon's artwork stands.\n */\nexport type IconGlyphState =\n    | { status: 'loading' }\n    | { status: 'ready'; glyph: IconGlyph }\n    | { status: 'unavailable'; reason: string };\n\nconst loads = new WeakMap<IconAdapter, Map<string, Promise<IconGlyph | undefined>>>();\n\nfunction keyOf(reference: IconReference): string {\n    return JSON.stringify([reference.key, reference.variant ?? null]);\n}\n\n/**\n * One load per adapter and icon, shared between every place the icon is drawn; a failed load is\n * forgotten so the next render can try again.\n */\nfunction load(adapter: IconAdapter, reference: IconReference): Promise<IconGlyph | undefined> {\n    let perAdapter = loads.get(adapter);\n    if (!perAdapter) {\n        perAdapter = new Map();\n        loads.set(adapter, perAdapter);\n    }\n\n    const key = keyOf(reference);\n    let pending = perAdapter.get(key);\n    if (!pending) {\n        pending = Promise.resolve().then(() => adapter.loadGlyph(reference));\n        perAdapter.set(key, pending);\n        pending.catch(() => perAdapter.delete(key));\n    }\n\n    return pending;\n}\n\n/**\n * Loads the artwork for a reference through the adapter registered for its library. An absent registry,\n * a library with no adapter, an icon the library lacks and a failed load are all `unavailable`, each with\n * its reason - never a different icon.\n */\nexport function useIconGlyph(reference: IconReference, adapters: IconAdapterRegistry | undefined): IconGlyphState {\n    const [state, setState] = useState<IconGlyphState>({ status: 'loading' });\n    const { library, key, variant } = reference;\n\n    useEffect(() => {\n        let isCurrent = true;\n        const adapter = adapters?.get(library);\n        if (!adapter) {\n            setState({ status: 'unavailable', reason: `No icon adapter is registered for the library '${library}'` });\n            return;\n        }\n\n        setState({ status: 'loading' });\n        load(adapter, { library, key, variant }).then(\n            (glyph) => {\n                if (!isCurrent) return;\n                setState(glyph ? { status: 'ready', glyph } : { status: 'unavailable', reason: `The library '${library}' has no icon '${key}'` });\n            },\n            (error: unknown) => {\n                if (isCurrent) setState({ status: 'unavailable', reason: error instanceof Error ? error.message : String(error) });\n            }\n        );\n\n        return () => {\n            isCurrent = false;\n        };\n    }, [adapters, library, key, variant]);\n\n    return state;\n}\n"],"names":["loads","WeakMap","keyOf","reference","JSON","stringify","key","variant","load","adapter","perAdapter","get","Map","set","pending","Promise","resolve","then","loadGlyph","catch","delete","useIconGlyph","adapters","state","setState","useState","status","library","useEffect","isCurrent","reason","glyph","error","Error","message","String"],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -2,6 +2,7 @@ export * from './SceneElementView';
 export * from './renderer';
 export * from './core';
 export * from './NavBar';
+export * from './icons';
 export * from './packages';
 export * from './theme';
 export * from './interactions';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/dist/esm/index.js

@@ -12,7 +12,11 @@ export { coreComponents } from './core/coreComponents.js';
 export { corePackage, corePackageManifest } from './core/corePackage.js';
 export { NavBar } from './NavBar/NavBar.js';
 export { extractNavigationItem } from './NavBar/extractNavigationItem.js';
-export { componentRegistryKey, mergePackageRegistries, validatePackageBundle } from './packages/ScenePackageBundle.js';
+export { IconAdapterRegistry, createIconAdapterRegistry } from './icons/IconAdapterRegistry.js';
+export { IconAdapterProvider, useIconAdapters } from './icons/IconAdapterContext.js';
+export { useIconGlyph } from './icons/useIconGlyph.js';
+export { SceneIcon } from './icons/SceneIcon.js';
+export { componentRegistryKey, mergeIconAdapters, mergePackageRegistries, validatePackageBundle } from './packages/ScenePackageBundle.js';
 export { applyThemeTokens, themeTokenPrefix, themeTokenProperty } from './theme/themeTokens.js';
 export { SceneThemeProvider, useSceneTheme } from './theme/SceneThemeProvider.js';
 export { InteractionScope, attachmentFor, useInteractionScope } from './interactions/InteractionScope.js';

package/dist/esm/index.js.map

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

package/dist/esm/packages/ScenePackageBundle.d.ts

@@ -1,4 +1,6 @@
 import { ComponentDescriptor, DialogTemplate, Layout, ScenePackage, Screen, ScreenTemplate, Theme } from '@cratis/scene.model';
+import { IconAdapterRegistry } from '../icons/IconAdapterRegistry';
+import { IconLibraryBundle } from '../icons/IconLibraryBundle';
 import { ComponentRegistry } from '../renderer';
 export interface ScenePackageBundle {
     manifest: ScenePackage;
@@ -9,8 +11,10 @@ export interface ScenePackageBundle {
     screens?: Screen[];
     descriptors?: ComponentDescriptor[];
     themes?: Theme[];
+    iconLibrary?: IconLibraryBundle;
 }
 export declare function componentRegistryKey(packageName: string, componentName: string): string;
 export declare function validatePackageBundle(bundle: ScenePackageBundle): string[];
 export declare function mergePackageRegistries(bundles: ScenePackageBundle[]): ComponentRegistry;
+export declare function mergeIconAdapters(bundles: ScenePackageBundle[]): IconAdapterRegistry;
 //# sourceMappingURL=ScenePackageBundle.d.ts.map

package/dist/esm/packages/ScenePackageBundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScenePackageBundle.d.ts","sourceRoot":"","sources":["../../../packages/ScenePackageBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAqB,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAClJ,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAchD,MAAM,WAAW,kBAAkB;IAK/B,QAAQ,EAAE,YAAY,CAAC;IAKvB,UAAU,EAAE,iBAAiB,CAAC;IAK9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAMnB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAKnC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAMnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAQnB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAKpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACpB;AAYD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvF;AAWD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CA+C1E;AA6CD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,CAEvF"}
+{"version":3,"file":"ScenePackageBundle.d.ts","sourceRoot":"","sources":["../../../packages/ScenePackageBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAkC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/J,OAAO,EAAE,mBAAmB,EAA6B,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAchD,MAAM,WAAW,kBAAkB;IAK/B,QAAQ,EAAE,YAAY,CAAC;IAKvB,UAAU,EAAE,iBAAiB,CAAC;IAK9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAMnB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAKnC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAMnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAQnB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAKpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAMjB,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAYD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvF;AAWD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAiD1E;AAmFD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,CAEvF;AAOD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,mBAAmB,CAEpF"}

package/dist/esm/packages/ScenePackageBundle.js

@@ -1,4 +1,5 @@
-import { PropertyValueType } from '@cratis/scene.model';
+import { PackageKind, PropertyValueType } from '@cratis/scene.model';
+import { createIconAdapterRegistry } from '../icons/IconAdapterRegistry.js';
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
@@ -60,9 +61,39 @@ import { PropertyValueType } from '@cratis/scene.model';
             problems.push(`declares the theme '${name}' but provides no definition for it`);
         }
     }
+    problems.push(...validateIconLibrary(bundle));
     problems.push(...validateDescriptors(bundle));
     return problems;
 }
+function validateIconLibrary(bundle) {
+    const problems = [];
+    const { manifest, iconLibrary } = bundle;
+    const declaresIconLibrary = manifest.kind === PackageKind.IconLibrary || manifest.iconLibrary !== undefined;
+    if (manifest.kind === PackageKind.IconLibrary && !manifest.iconLibrary) {
+        problems.push('is an icon library but declares no iconLibrary metadata');
+    }
+    if (manifest.kind !== PackageKind.IconLibrary && manifest.iconLibrary) {
+        problems.push('declares iconLibrary metadata but is not of kind IconLibrary');
+    }
+    if (declaresIconLibrary && !iconLibrary) {
+        problems.push('declares an icon library but the bundle provides no catalog or adapter for it');
+    }
+    if (!declaresIconLibrary && iconLibrary) {
+        problems.push('provides an icon catalog and adapter, which the manifest does not declare');
+    }
+    if (iconLibrary) {
+        if (iconLibrary.catalog.library !== manifest.name) {
+            problems.push(`provides an icon catalog for '${iconLibrary.catalog.library}' instead of '${manifest.name}'`);
+        }
+        if (iconLibrary.adapter.library !== manifest.name) {
+            problems.push(`provides an icon adapter for '${iconLibrary.adapter.library}' instead of '${manifest.name}'`);
+        }
+        if (manifest.iconLibrary && !manifest.iconLibrary.renderers.includes('react')) {
+            problems.push("provides a React icon adapter but does not list 'react' among its icon renderers");
+        }
+    }
+    return problems;
+}
 function validateDescriptors(bundle) {
     const problems = [];
     const declared = new Set(bundle.manifest.components.map((name)=>componentRegistryKey(bundle.manifest.name, name)));
@@ -99,6 +130,15 @@ function validateDescriptors(bundle) {
  */ function mergePackageRegistries(bundles) {
     return Object.assign({}, ...bundles.map((bundle)=>bundle.components));
 }
+/**
+ * Collects the icon adapters of several bundles into the registry `SceneIcon` renders through.
+ *
+ * @throws Error when two bundles provide an adapter for the same library.
+ */ function mergeIconAdapters(bundles) {
+    return createIconAdapterRegistry(bundles.flatMap((bundle)=>bundle.iconLibrary ? [
+            bundle.iconLibrary.adapter
+        ] : []));
+}
 
-export { componentRegistryKey, mergePackageRegistries, validatePackageBundle };
+export { componentRegistryKey, mergeIconAdapters, mergePackageRegistries, validatePackageBundle };
 //# sourceMappingURL=ScenePackageBundle.js.map

package/dist/esm/packages/ScenePackageBundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScenePackageBundle.js","sources":["../../../packages/ScenePackageBundle.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ComponentDescriptor, DialogTemplate, Layout, PropertyValueType, ScenePackage, Screen, ScreenTemplate, Theme } from '@cratis/scene.model';\nimport { ComponentRegistry } from '../renderer';\n\n/**\n * What a package actually ships to a React renderer, as opposed to what it *declares*.\n *\n * `ScenePackage` is the declaration — a name, a kind, dependencies, and the names of what it\n * contributes. It is deliberately platform-agnostic and lives in `Scene.Model`, because Stage's build and\n * Studio's design-time queries both read it without ever loading a component. A bundle is the other half:\n * the real React components, layouts, screens and themes behind those names, which only a renderer needs.\n *\n * A package publishes exactly one bundle, as a named export following its own name —\n * `primeReactPackage`, `cratisComponentsPackage`, `corePackage`. A host loads it from the module the\n * declaration's `ScenePackage.module` names.\n */\nexport interface ScenePackageBundle {\n    /**\n     * The package's own declaration. Its `components`, `layouts` and `themes` name lists must agree with\n     * what this bundle actually provides — {@link validatePackageBundle} is what proves they do.\n     */\n    manifest: ScenePackage;\n\n    /**\n     * The components this package provides, keyed by {@link componentRegistryKey}.\n     */\n    components: ComponentRegistry;\n\n    /**\n     * The application shells this package provides, if any. Only a blueprint has these.\n     */\n    layouts?: Layout[];\n\n    /**\n     * The screen templates this package provides — the shapes that go inside a layout, each declaring\n     * which of its parent's slots it fills.\n     */\n    screenTemplates?: ScreenTemplate[];\n\n    /**\n     * The dialog templates this package provides.\n     */\n    dialogTemplates?: DialogTemplate[];\n\n    /**\n     * Sample screens this package ships — a layout package's gallery, so a preview has real content to\n     * put through the real engine rather than a mockup.\n     */\n    screens?: Screen[];\n\n    /**\n     * What can be edited on this package's components - one {@link ComponentDescriptor} per component that is\n     * editable at design time. They are data, so Studio reads them without rendering anything, and they travel with\n     * the components they describe rather than in a registry of their own. {@link validatePackageBundle} checks\n     * that every descriptor names a component the manifest declares.\n     */\n    descriptors?: ComponentDescriptor[];\n\n    /**\n     * The themes this package ships, if any.\n     */\n    themes?: Theme[];\n}\n\n/**\n * The key a component is registered and looked up under: the package that provides it, then the bare name\n * a screen refers to it by.\n *\n * A screen writes a bare name (`button`) or a package-qualified one (`PrimeReact.button`);\n * `resolveComponentName` turns either into a `{ name, package }` pair, and this turns that pair into the\n * registry key. Nothing should build this string by hand — the separator is an implementation detail of\n * the registry, deliberately not the `.` used for qualification in a screen, so a package name containing\n * dots stays unambiguous.\n */\nexport function componentRegistryKey(packageName: string, componentName: string): string {\n    return `${packageName}:${componentName}`;\n}\n\n/**\n * Checks that a bundle provides everything its manifest declares, and declares everything it provides, and that\n * every descriptor it ships is for a component it declares and is well formed.\n *\n * A manifest that promises a component the bundle does not register renders as `UnresolvedComponent` at\n * runtime — a blank box, far from where the mistake was made. A component registered but not declared is\n * invisible to `resolveComponentName`, so a screen can never name it. Both are silent failures, which is\n * why every package's specs run this.\n */\nexport function validatePackageBundle(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest } = bundle;\n\n    for (const name of manifest.components) {\n        if (!(componentRegistryKey(manifest.name, name) in bundle.components)) {\n            problems.push(`declares the component '${name}' but registers no implementation for it`);\n        }\n    }\n\n    const declared = new Set(manifest.components.map((name) => componentRegistryKey(manifest.name, name)));\n    for (const key of Object.keys(bundle.components)) {\n        if (!declared.has(key)) {\n            problems.push(`registers '${key}', which the manifest does not declare`);\n        }\n    }\n\n    const providedLayouts = new Set((bundle.layouts ?? []).map((layout) => layout.name));\n    for (const name of manifest.layouts) {\n        if (!providedLayouts.has(name)) {\n            problems.push(`declares the layout '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedScreenTemplates = new Set((bundle.screenTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.screenTemplates) {\n        if (!providedScreenTemplates.has(name)) {\n            problems.push(`declares the screen template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedDialogTemplates = new Set((bundle.dialogTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.dialogTemplates) {\n        if (!providedDialogTemplates.has(name)) {\n            problems.push(`declares the dialog template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedThemes = new Set((bundle.themes ?? []).map((theme) => theme.name));\n    for (const name of manifest.themes) {\n        if (!providedThemes.has(name)) {\n            problems.push(`declares the theme '${name}' but provides no definition for it`);\n        }\n    }\n\n    problems.push(...validateDescriptors(bundle));\n    return problems;\n}\n\nfunction validateDescriptors(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const declared = new Set(bundle.manifest.components.map((name) => componentRegistryKey(bundle.manifest.name, name)));\n    const described = new Set<string>();\n\n    for (const descriptor of bundle.descriptors ?? []) {\n        if (!declared.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}', which the manifest does not declare as a component`);\n        }\n\n        if (described.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}' more than once`);\n        }\n\n        described.add(descriptor.component);\n\n        const paths = new Set<string>();\n        for (const property of descriptor.properties) {\n            if (paths.has(property.path)) {\n                problems.push(`'${descriptor.component}' describes the property '${property.path}' more than once`);\n            }\n\n            paths.add(property.path);\n\n            if (property.valueType === PropertyValueType.Collection && property.item === undefined) {\n                problems.push(`'${descriptor.component}' describes the collection '${property.path}' without describing its items`);\n            }\n\n            if (property.valueType === PropertyValueType.Enum && (property.choices ?? []).length === 0) {\n                problems.push(`'${descriptor.component}' describes the enum '${property.path}' without choices`);\n            }\n        }\n    }\n\n    return problems;\n}\n\n/**\n * Merges the component registries of several bundles into the single registry a renderer consumes.\n *\n * Keys carry their package name, so nothing collides and merge order does not matter — which package wins\n * a *bare* name is decided earlier, by `resolveComponentName` walking the profile's priority order.\n */\nexport function mergePackageRegistries(bundles: ScenePackageBundle[]): ComponentRegistry {\n    return Object.assign({}, ...bundles.map((bundle) => bundle.components)) as ComponentRegistry;\n}\n"],"names":["componentRegistryKey","packageName","componentName","validatePackageBundle","bundle","problems","manifest","name","components","push","declared","Set","map","key","Object","keys","has","providedLayouts","layouts","layout","providedScreenTemplates","screenTemplates","template","providedDialogTemplates","dialogTemplates","providedThemes","themes","theme","validateDescriptors","described","descriptor","descriptors","component","add","paths","property","properties","path","valueType","PropertyValueType","Collection","item","undefined","Enum","choices","length","mergePackageRegistries","bundles","assign"],"mappings":"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"}
+{"version":3,"file":"ScenePackageBundle.js","sources":["../../../packages/ScenePackageBundle.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ComponentDescriptor, DialogTemplate, Layout, PackageKind, PropertyValueType, ScenePackage, Screen, ScreenTemplate, Theme } from '@cratis/scene.model';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { IconLibraryBundle } from '../icons/IconLibraryBundle';\nimport { ComponentRegistry } from '../renderer';\n\n/**\n * What a package actually ships to a React renderer, as opposed to what it *declares*.\n *\n * `ScenePackage` is the declaration — a name, a kind, dependencies, and the names of what it\n * contributes. It is deliberately platform-agnostic and lives in `Scene.Model`, because Stage's build and\n * Studio's design-time queries both read it without ever loading a component. A bundle is the other half:\n * the real React components, layouts, screens and themes behind those names, which only a renderer needs.\n *\n * A package publishes exactly one bundle, as a named export following its own name —\n * `primeReactPackage`, `cratisComponentsPackage`, `corePackage`. A host loads it from the module the\n * declaration's `ScenePackage.module` names.\n */\nexport interface ScenePackageBundle {\n    /**\n     * The package's own declaration. Its `components`, `layouts` and `themes` name lists must agree with\n     * what this bundle actually provides — {@link validatePackageBundle} is what proves they do.\n     */\n    manifest: ScenePackage;\n\n    /**\n     * The components this package provides, keyed by {@link componentRegistryKey}.\n     */\n    components: ComponentRegistry;\n\n    /**\n     * The application shells this package provides, if any. Only a blueprint has these.\n     */\n    layouts?: Layout[];\n\n    /**\n     * The screen templates this package provides — the shapes that go inside a layout, each declaring\n     * which of its parent's slots it fills.\n     */\n    screenTemplates?: ScreenTemplate[];\n\n    /**\n     * The dialog templates this package provides.\n     */\n    dialogTemplates?: DialogTemplate[];\n\n    /**\n     * Sample screens this package ships — a layout package's gallery, so a preview has real content to\n     * put through the real engine rather than a mockup.\n     */\n    screens?: Screen[];\n\n    /**\n     * What can be edited on this package's components - one {@link ComponentDescriptor} per component that is\n     * editable at design time. They are data, so Studio reads them without rendering anything, and they travel with\n     * the components they describe rather than in a registry of their own. {@link validatePackageBundle} checks\n     * that every descriptor names a component the manifest declares.\n     */\n    descriptors?: ComponentDescriptor[];\n\n    /**\n     * The themes this package ships, if any.\n     */\n    themes?: Theme[];\n\n    /**\n     * The icon catalog and renderer adapter of an icon-library package. Present exactly when the\n     * manifest declares an icon library.\n     */\n    iconLibrary?: IconLibraryBundle;\n}\n\n/**\n * The key a component is registered and looked up under: the package that provides it, then the bare name\n * a screen refers to it by.\n *\n * A screen writes a bare name (`button`) or a package-qualified one (`PrimeReact.button`);\n * `resolveComponentName` turns either into a `{ name, package }` pair, and this turns that pair into the\n * registry key. Nothing should build this string by hand — the separator is an implementation detail of\n * the registry, deliberately not the `.` used for qualification in a screen, so a package name containing\n * dots stays unambiguous.\n */\nexport function componentRegistryKey(packageName: string, componentName: string): string {\n    return `${packageName}:${componentName}`;\n}\n\n/**\n * Checks that a bundle provides everything its manifest declares, and declares everything it provides, and that\n * every descriptor it ships is for a component it declares and is well formed.\n *\n * A manifest that promises a component the bundle does not register renders as `UnresolvedComponent` at\n * runtime — a blank box, far from where the mistake was made. A component registered but not declared is\n * invisible to `resolveComponentName`, so a screen can never name it. Both are silent failures, which is\n * why every package's specs run this.\n */\nexport function validatePackageBundle(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest } = bundle;\n\n    for (const name of manifest.components) {\n        if (!(componentRegistryKey(manifest.name, name) in bundle.components)) {\n            problems.push(`declares the component '${name}' but registers no implementation for it`);\n        }\n    }\n\n    const declared = new Set(manifest.components.map((name) => componentRegistryKey(manifest.name, name)));\n    for (const key of Object.keys(bundle.components)) {\n        if (!declared.has(key)) {\n            problems.push(`registers '${key}', which the manifest does not declare`);\n        }\n    }\n\n    const providedLayouts = new Set((bundle.layouts ?? []).map((layout) => layout.name));\n    for (const name of manifest.layouts) {\n        if (!providedLayouts.has(name)) {\n            problems.push(`declares the layout '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedScreenTemplates = new Set((bundle.screenTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.screenTemplates) {\n        if (!providedScreenTemplates.has(name)) {\n            problems.push(`declares the screen template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedDialogTemplates = new Set((bundle.dialogTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.dialogTemplates) {\n        if (!providedDialogTemplates.has(name)) {\n            problems.push(`declares the dialog template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedThemes = new Set((bundle.themes ?? []).map((theme) => theme.name));\n    for (const name of manifest.themes) {\n        if (!providedThemes.has(name)) {\n            problems.push(`declares the theme '${name}' but provides no definition for it`);\n        }\n    }\n\n    problems.push(...validateIconLibrary(bundle));\n    problems.push(...validateDescriptors(bundle));\n\n    return problems;\n}\n\nfunction validateIconLibrary(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest, iconLibrary } = bundle;\n    const declaresIconLibrary = manifest.kind === PackageKind.IconLibrary || manifest.iconLibrary !== undefined;\n\n    if (manifest.kind === PackageKind.IconLibrary && !manifest.iconLibrary) {\n        problems.push('is an icon library but declares no iconLibrary metadata');\n    }\n\n    if (manifest.kind !== PackageKind.IconLibrary && manifest.iconLibrary) {\n        problems.push('declares iconLibrary metadata but is not of kind IconLibrary');\n    }\n\n    if (declaresIconLibrary && !iconLibrary) {\n        problems.push('declares an icon library but the bundle provides no catalog or adapter for it');\n    }\n\n    if (!declaresIconLibrary && iconLibrary) {\n        problems.push('provides an icon catalog and adapter, which the manifest does not declare');\n    }\n\n    if (iconLibrary) {\n        if (iconLibrary.catalog.library !== manifest.name) {\n            problems.push(`provides an icon catalog for '${iconLibrary.catalog.library}' instead of '${manifest.name}'`);\n        }\n\n        if (iconLibrary.adapter.library !== manifest.name) {\n            problems.push(`provides an icon adapter for '${iconLibrary.adapter.library}' instead of '${manifest.name}'`);\n        }\n\n        if (manifest.iconLibrary && !manifest.iconLibrary.renderers.includes('react')) {\n            problems.push(\"provides a React icon adapter but does not list 'react' among its icon renderers\");\n        }\n    }\n\n    return problems;\n}\n\nfunction validateDescriptors(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const declared = new Set(bundle.manifest.components.map((name) => componentRegistryKey(bundle.manifest.name, name)));\n    const described = new Set<string>();\n\n    for (const descriptor of bundle.descriptors ?? []) {\n        if (!declared.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}', which the manifest does not declare as a component`);\n        }\n\n        if (described.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}' more than once`);\n        }\n\n        described.add(descriptor.component);\n\n        const paths = new Set<string>();\n        for (const property of descriptor.properties) {\n            if (paths.has(property.path)) {\n                problems.push(`'${descriptor.component}' describes the property '${property.path}' more than once`);\n            }\n\n            paths.add(property.path);\n\n            if (property.valueType === PropertyValueType.Collection && property.item === undefined) {\n                problems.push(`'${descriptor.component}' describes the collection '${property.path}' without describing its items`);\n            }\n\n            if (property.valueType === PropertyValueType.Enum && (property.choices ?? []).length === 0) {\n                problems.push(`'${descriptor.component}' describes the enum '${property.path}' without choices`);\n            }\n        }\n    }\n\n    return problems;\n}\n\n/**\n * Merges the component registries of several bundles into the single registry a renderer consumes.\n *\n * Keys carry their package name, so nothing collides and merge order does not matter — which package wins\n * a *bare* name is decided earlier, by `resolveComponentName` walking the profile's priority order.\n */\nexport function mergePackageRegistries(bundles: ScenePackageBundle[]): ComponentRegistry {\n    return Object.assign({}, ...bundles.map((bundle) => bundle.components)) as ComponentRegistry;\n}\n\n/**\n * Collects the icon adapters of several bundles into the registry `SceneIcon` renders through.\n *\n * @throws Error when two bundles provide an adapter for the same library.\n */\nexport function mergeIconAdapters(bundles: ScenePackageBundle[]): IconAdapterRegistry {\n    return createIconAdapterRegistry(bundles.flatMap((bundle) => (bundle.iconLibrary ? [bundle.iconLibrary.adapter] : [])));\n}\n"],"names":["componentRegistryKey","packageName","componentName","validatePackageBundle","bundle","problems","manifest","name","components","push","declared","Set","map","key","Object","keys","has","providedLayouts","layouts","layout","providedScreenTemplates","screenTemplates","template","providedDialogTemplates","dialogTemplates","providedThemes","themes","theme","validateIconLibrary","validateDescriptors","iconLibrary","declaresIconLibrary","kind","PackageKind","IconLibrary","undefined","catalog","library","adapter","renderers","includes","described","descriptor","descriptors","component","add","paths","property","properties","path","valueType","PropertyValueType","Collection","item","Enum","choices","length","mergePackageRegistries","bundles","assign","mergeIconAdapters","createIconAdapterRegistry","flatMap"],"mappings":"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"}