@cratis/scene.model 4.3.0 → 4.5.0

package/common/index.ts

@@ -12,5 +12,4 @@ export * from './Orientation';
 export * from './Dock';
 export * from './GridUnitType';
 export * from './GridLength';
-export * from './IconReference';
 export * from './DestinationReference';

package/dist/cjs/editing/DiagnosticCode.js

@@ -50,6 +50,13 @@
     DiagnosticCode["CollectionItemNotFound"] = "collectionItemNotFound";
     DiagnosticCode["DuplicateCollectionItem"] = "duplicateCollectionItem";
     DiagnosticCode["UnknownInstance"] = "unknownInstance";
+    // Icons
+    DiagnosticCode["MissingIconLibrary"] = "missingIconLibrary";
+    DiagnosticCode["MissingIcon"] = "missingIcon";
+    DiagnosticCode["MissingIconVariant"] = "missingIconVariant";
+    DiagnosticCode["IncompatibleIconLibrary"] = "incompatibleIconLibrary";
+    DiagnosticCode["IconCatalogUnavailable"] = "iconCatalogUnavailable";
+    DiagnosticCode["IconNotVerified"] = "iconNotVerified";
     return DiagnosticCode;
 }({});
 

package/dist/cjs/editing/DiagnosticCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"DiagnosticCode.js","sources":["../../../editing/DiagnosticCode.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\n/**\n * The reasons inspection, editing, binding validation and configuration resolution report a problem. A host\n * switches on the code; the message is for a person.\n */\nexport enum DiagnosticCode {\n    // Addressing\n    UnknownNode = 'unknownNode',\n    DuplicateElementId = 'duplicateElementId',\n    UnknownScope = 'unknownScope',\n    InvalidEdit = 'invalidEdit',\n\n    // Properties\n    UnknownProperty = 'unknownProperty',\n    InvalidValue = 'invalidValue',\n    ReadOnlyProperty = 'readOnlyProperty',\n    NodeNotEditable = 'nodeNotEditable',\n    MissingComponentDescriptor = 'missingComponentDescriptor',\n\n    // Layout\n    NotALayoutNode = 'notALayoutNode',\n    LayoutTypeNotConvertible = 'layoutTypeNotConvertible',\n    LossyConversionNotAccepted = 'lossyConversionNotAccepted',\n    LossyConversion = 'lossyConversion',\n\n    // Structure\n    TargetDoesNotAcceptChildren = 'targetDoesNotAcceptChildren',\n    UnknownSlot = 'unknownSlot',\n    ContainmentCycle = 'containmentCycle',\n    IndexOutOfRange = 'indexOutOfRange',\n    ElementIdInUse = 'elementIdInUse',\n    MaximumChildrenExceeded = 'maximumChildrenExceeded',\n    NodeNotRemovable = 'nodeNotRemovable',\n\n    // Query binding\n    MissingQuery = 'missingQuery',\n    IncompatibleResultShape = 'incompatibleResultShape',\n    MissingRequiredParameter = 'missingRequiredParameter',\n    UnknownParameter = 'unknownParameter',\n    ArgumentTypeMismatch = 'argumentTypeMismatch',\n    UnresolvedArgumentSource = 'unresolvedArgumentSource',\n    UnknownResultField = 'unknownResultField',\n\n    // Exposure and instance configuration\n    ExposureTargetMissing = 'exposureTargetMissing',\n    ExposureWidensOwner = 'exposureWidensOwner',\n    ReExposureBroken = 'reExposureBroken',\n    ContributionNotExposed = 'contributionNotExposed',\n    ContributionTargetMissing = 'contributionTargetMissing',\n    ContributionTypeMismatch = 'contributionTypeMismatch',\n    ContributionOperationNotPermitted = 'contributionOperationNotPermitted',\n    UnknownCollectionField = 'unknownCollectionField',\n    CollectionItemNotFound = 'collectionItemNotFound',\n    DuplicateCollectionItem = 'duplicateCollectionItem',\n    UnknownInstance = 'unknownInstance',\n}\n"],"names":["DiagnosticCode"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,IAAKA,cAAAA,iBAAAA,SAAAA,cAAAA,EAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,IAAAA,OAAAA,cAAAA;AAkDX,CAAA,CAAA,EAAA;;"}
+{"version":3,"file":"DiagnosticCode.js","sources":["../../../editing/DiagnosticCode.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\n/**\n * The reasons inspection, editing, binding validation and configuration resolution report a problem. A host\n * switches on the code; the message is for a person.\n */\nexport enum DiagnosticCode {\n    // Addressing\n    UnknownNode = 'unknownNode',\n    DuplicateElementId = 'duplicateElementId',\n    UnknownScope = 'unknownScope',\n    InvalidEdit = 'invalidEdit',\n\n    // Properties\n    UnknownProperty = 'unknownProperty',\n    InvalidValue = 'invalidValue',\n    ReadOnlyProperty = 'readOnlyProperty',\n    NodeNotEditable = 'nodeNotEditable',\n    MissingComponentDescriptor = 'missingComponentDescriptor',\n\n    // Layout\n    NotALayoutNode = 'notALayoutNode',\n    LayoutTypeNotConvertible = 'layoutTypeNotConvertible',\n    LossyConversionNotAccepted = 'lossyConversionNotAccepted',\n    LossyConversion = 'lossyConversion',\n\n    // Structure\n    TargetDoesNotAcceptChildren = 'targetDoesNotAcceptChildren',\n    UnknownSlot = 'unknownSlot',\n    ContainmentCycle = 'containmentCycle',\n    IndexOutOfRange = 'indexOutOfRange',\n    ElementIdInUse = 'elementIdInUse',\n    MaximumChildrenExceeded = 'maximumChildrenExceeded',\n    NodeNotRemovable = 'nodeNotRemovable',\n\n    // Query binding\n    MissingQuery = 'missingQuery',\n    IncompatibleResultShape = 'incompatibleResultShape',\n    MissingRequiredParameter = 'missingRequiredParameter',\n    UnknownParameter = 'unknownParameter',\n    ArgumentTypeMismatch = 'argumentTypeMismatch',\n    UnresolvedArgumentSource = 'unresolvedArgumentSource',\n    UnknownResultField = 'unknownResultField',\n\n    // Exposure and instance configuration\n    ExposureTargetMissing = 'exposureTargetMissing',\n    ExposureWidensOwner = 'exposureWidensOwner',\n    ReExposureBroken = 'reExposureBroken',\n    ContributionNotExposed = 'contributionNotExposed',\n    ContributionTargetMissing = 'contributionTargetMissing',\n    ContributionTypeMismatch = 'contributionTypeMismatch',\n    ContributionOperationNotPermitted = 'contributionOperationNotPermitted',\n    UnknownCollectionField = 'unknownCollectionField',\n    CollectionItemNotFound = 'collectionItemNotFound',\n    DuplicateCollectionItem = 'duplicateCollectionItem',\n    UnknownInstance = 'unknownInstance',\n\n    // Icons\n    MissingIconLibrary = 'missingIconLibrary',\n    MissingIcon = 'missingIcon',\n    MissingIconVariant = 'missingIconVariant',\n    IncompatibleIconLibrary = 'incompatibleIconLibrary',\n    IconCatalogUnavailable = 'iconCatalogUnavailable',\n    IconNotVerified = 'iconNotVerified',\n}\n"],"names":["DiagnosticCode"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,IAAKA,cAAAA,iBAAAA,SAAAA,cAAAA,EAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,IAAAA,OAAAA,cAAAA;AA0DX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/icons/IconEntry.js

@@ -0,0 +1,22 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * One icon in an icon library's catalog: what a picker needs to find it and a reference needs to name it.
+ *
+ * An entry is metadata only. It holds no SVG, class name or component - that is the renderer's concern,
+ * resolved lazily per icon by the adapter - so a catalog is cheap to load and identical for every
+ * renderer. The {@link IconReference} that names the icon is the entry's `key` (and one of its
+ * `variants`) together with the library the catalog belongs to.
+ */ const IconEntryPropertyNames = [
+    'key',
+    'name',
+    'categories',
+    'aliases',
+    'tags',
+    'variants'
+];
+
+exports.IconEntryPropertyNames = IconEntryPropertyNames;
+//# sourceMappingURL=IconEntry.js.map

package/dist/cjs/icons/IconEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconEntry.js","sources":["../../../icons/IconEntry.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\n/**\n * One icon in an icon library's catalog: what a picker needs to find it and a reference needs to name it.\n *\n * An entry is metadata only. It holds no SVG, class name or component - that is the renderer's concern,\n * resolved lazily per icon by the adapter - so a catalog is cheap to load and identical for every\n * renderer. The {@link IconReference} that names the icon is the entry's `key` (and one of its\n * `variants`) together with the library the catalog belongs to.\n */\nexport interface IconEntry {\n    /**\n     * The stable key within the library; what an {@link IconReference} persists.\n     */\n    key: string;\n\n    /**\n     * The display name a picker shows. Never identity - two libraries may share a name.\n     */\n    name: string;\n\n    /**\n     * The categories the icon is filed under, for browsing.\n     */\n    categories: string[];\n\n    /**\n     * Alternative names to find the icon by (`bin` for `trash`).\n     */\n    aliases?: string[];\n\n    /**\n     * Free-form search terms.\n     */\n    tags?: string[];\n\n    /**\n     * The variants this icon exists in. Absent or empty when the icon has no variants, in which case\n     * references to it carry none.\n     */\n    variants?: string[];\n}\n\nexport const IconEntryPropertyNames: (keyof IconEntry)[] = ['key', 'name', 'categories', 'aliases', 'tags', 'variants'];\n"],"names":["IconEntryPropertyNames"],"mappings":";;AAAA;AACA;AAEA;;;;;;;UAyCaA,sBAAAA,GAA8C;AAAC,IAAA,KAAA;AAAO,IAAA,MAAA;AAAQ,IAAA,YAAA;AAAc,IAAA,SAAA;AAAW,IAAA,MAAA;AAAQ,IAAA;;;"}

package/dist/cjs/icons/IconLibrary.js

@@ -0,0 +1,22 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * What a {@link ScenePackage} of kind {@link PackageKind.IconLibrary} declares about its icons, beyond
+ * what every package declares (name, version, license, dependencies, module).
+ *
+ * It is deliberately small. The icons themselves are not listed here: a library can ship thousands, and a
+ * profile resolution that read every key of every library would defeat the point of resolving without
+ * loading anything. The icon *catalog* - an {@link IconEntry} per icon - is loaded on demand from the
+ * library's module, and each icon's artwork is loaded per icon by the renderer's adapter.
+ */ const IconLibraryPropertyNames = [
+    'variants',
+    'renderers',
+    'attribution',
+    'attributionUrl',
+    'iconCount'
+];
+
+exports.IconLibraryPropertyNames = IconLibraryPropertyNames;
+//# sourceMappingURL=IconLibrary.js.map

package/dist/cjs/icons/IconLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconLibrary.js","sources":["../../../icons/IconLibrary.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\n/**\n * What a {@link ScenePackage} of kind {@link PackageKind.IconLibrary} declares about its icons, beyond\n * what every package declares (name, version, license, dependencies, module).\n *\n * It is deliberately small. The icons themselves are not listed here: a library can ship thousands, and a\n * profile resolution that read every key of every library would defeat the point of resolving without\n * loading anything. The icon *catalog* - an {@link IconEntry} per icon - is loaded on demand from the\n * library's module, and each icon's artwork is loaded per icon by the renderer's adapter.\n */\nexport interface IconLibrary {\n    /**\n     * The style variants the library offers (`outline`, `solid` ...), empty when it has a single style.\n     * Declared here so a picker can offer variant filters before it has loaded the catalog.\n     */\n    variants: string[];\n\n    /**\n     * The renderers the library ships an adapter for (`react` ...), so tooling can say whether the\n     * library can render for the target a profile selects without loading it.\n     */\n    renderers: string[];\n\n    /**\n     * The credit line the library's license asks to be shown, for example \"Icons by Lucide contributors\".\n     */\n    attribution?: string;\n\n    /**\n     * Where the attribution points - the library's home or license page.\n     */\n    attributionUrl?: string;\n\n    /**\n     * How many icons the catalog holds, for a picker's \"1,500 icons\" before the catalog is loaded.\n     */\n    iconCount?: number;\n}\n\nexport const IconLibraryPropertyNames: (keyof IconLibrary)[] = ['variants', 'renderers', 'attribution', 'attributionUrl', 'iconCount'];\n"],"names":["IconLibraryPropertyNames"],"mappings":";;AAAA;AACA;AAEA;;;;;;;;UAsCaA,wBAAAA,GAAkD;AAAC,IAAA,UAAA;AAAY,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,gBAAA;AAAkB,IAAA;;;"}

package/dist/cjs/icons/IconReference.js

@@ -0,0 +1,23 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The persisted, renderer-neutral identity of one icon: which icon library it comes from, which icon
+ * inside that library, and optionally which style variant of it.
+ *
+ * This is the only form in which a screen, template, blueprint or profile refers to an icon. It carries
+ * no CSS class, no SVG and no component - those belong to a renderer's adapter for the library - so the
+ * same reference renders on the web, on a phone, or anywhere else a library has an adapter.
+ *
+ * Identity is all three fields. A display name, a catalog position or a CSS class is never identity:
+ * two libraries can each ship an icon called `home`, and `{ library: 'a', key: 'home' }` and
+ * `{ library: 'b', key: 'home' }` are different icons that are never silently swapped for one another.
+ */ const IconReferencePropertyNames = [
+    'library',
+    'key',
+    'variant'
+];
+
+exports.IconReferencePropertyNames = IconReferencePropertyNames;
+//# sourceMappingURL=IconReference.js.map

package/dist/cjs/icons/IconReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconReference.js","sources":["../../../icons/IconReference.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\n/**\n * The persisted, renderer-neutral identity of one icon: which icon library it comes from, which icon\n * inside that library, and optionally which style variant of it.\n *\n * This is the only form in which a screen, template, blueprint or profile refers to an icon. It carries\n * no CSS class, no SVG and no component - those belong to a renderer's adapter for the library - so the\n * same reference renders on the web, on a phone, or anywhere else a library has an adapter.\n *\n * Identity is all three fields. A display name, a catalog position or a CSS class is never identity:\n * two libraries can each ship an icon called `home`, and `{ library: 'a', key: 'home' }` and\n * `{ library: 'b', key: 'home' }` are different icons that are never silently swapped for one another.\n */\nexport interface IconReference {\n    /**\n     * The identity of the icon library - the `name` of the {@link ScenePackage} of kind\n     * {@link PackageKind.IconLibrary} that provides the icon.\n     */\n    library: string;\n\n    /**\n     * The stable key of the icon inside its library. Stable means a library keeps the key across\n     * versions for as long as it ships the icon; it is not the icon's display name.\n     */\n    key: string;\n\n    /**\n     * The style variant (`outline`, `solid`, `filled` ...), or absent for a library or icon that has none.\n     */\n    variant?: string;\n}\n\nexport const IconReferencePropertyNames: (keyof IconReference)[] = ['library', 'key', 'variant'];\n"],"names":["IconReferencePropertyNames"],"mappings":";;AAAA;AACA;AAEA;;;;;;;;;;;UA+BaA,0BAAAA,GAAsD;AAAC,IAAA,SAAA;AAAW,IAAA,KAAA;AAAO,IAAA;;;"}

package/dist/cjs/icons/iconReferences.js

@@ -0,0 +1,61 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The character that separates the parts of an icon reference's text form. A reference's parts therefore
+ * cannot contain it - an npm package name, an icon key and a variant name never do.
+ */ const separator = '#';
+function isPart(value) {
+    return typeof value === 'string' && value.length > 0 && !value.includes(separator);
+}
+/**
+ * Whether a value is a well-formed {@link IconReference}: a library and a key that are non-empty, an
+ * optional non-empty variant, none of them containing the text-form separator. Extra properties are
+ * tolerated, because a reference read from a persisted document may carry editor-added metadata.
+ */ function isIconReference(value) {
+    if (typeof value !== 'object' || value === null) return false;
+    const candidate = value;
+    return isPart(candidate.library) && isPart(candidate.key) && (candidate.variant === undefined || isPart(candidate.variant));
+}
+/**
+ * Whether two references name the same icon. Equality is all three fields - library, key and variant -
+ * and nothing else; an absent variant equals only another absent variant.
+ */ function iconReferencesEqual(left, right) {
+    return left.library === right.library && left.key === right.key && (left.variant ?? undefined) === (right.variant ?? undefined);
+}
+/**
+ * The canonical single-string form of a reference, for keys, logs and diagnostics:
+ * `library#key`, or `library#key#variant`. Two references are equal exactly when their text forms are equal.
+ * It is a convenience for people and tools, not the persisted shape - persist the {@link IconReference}.
+ *
+ * @throws Error when a part is empty or contains `#`.
+ */ function formatIconReference(reference) {
+    if (!isIconReference(reference)) {
+        throw new Error(`'${JSON.stringify(reference)}' is not a valid icon reference: library and key are required, and no part may be empty or contain '${separator}'`);
+    }
+    return reference.variant === undefined ? `${reference.library}${separator}${reference.key}` : `${reference.library}${separator}${reference.key}${separator}${reference.variant}`;
+}
+/**
+ * Reads the text form produced by {@link formatIconReference}. Returns `undefined` for anything that is
+ * not one - including a bare legacy icon name such as `pi pi-home`, which has no library and so cannot be
+ * made into a reference without choosing one.
+ */ function parseIconReference(text) {
+    const parts = text.split(separator);
+    if (parts.length < 2 || parts.length > 3 || !parts.every(isPart)) return undefined;
+    const [library, key, variant] = parts;
+    return variant === undefined ? {
+        library,
+        key
+    } : {
+        library,
+        key,
+        variant
+    };
+}
+
+exports.formatIconReference = formatIconReference;
+exports.iconReferencesEqual = iconReferencesEqual;
+exports.isIconReference = isIconReference;
+exports.parseIconReference = parseIconReference;
+//# sourceMappingURL=iconReferences.js.map

package/dist/cjs/icons/iconReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconReferences.js","sources":["../../../icons/iconReferences.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 { IconReference } from './IconReference';\n\n/**\n * The character that separates the parts of an icon reference's text form. A reference's parts therefore\n * cannot contain it - an npm package name, an icon key and a variant name never do.\n */\nconst separator = '#';\n\nfunction isPart(value: unknown): value is string {\n    return typeof value === 'string' && value.length > 0 && !value.includes(separator);\n}\n\n/**\n * Whether a value is a well-formed {@link IconReference}: a library and a key that are non-empty, an\n * optional non-empty variant, none of them containing the text-form separator. Extra properties are\n * tolerated, because a reference read from a persisted document may carry editor-added metadata.\n */\nexport function isIconReference(value: unknown): value is IconReference {\n    if (typeof value !== 'object' || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return isPart(candidate.library) && isPart(candidate.key) && (candidate.variant === undefined || isPart(candidate.variant));\n}\n\n/**\n * Whether two references name the same icon. Equality is all three fields - library, key and variant -\n * and nothing else; an absent variant equals only another absent variant.\n */\nexport function iconReferencesEqual(left: IconReference, right: IconReference): boolean {\n    return left.library === right.library && left.key === right.key && (left.variant ?? undefined) === (right.variant ?? undefined);\n}\n\n/**\n * The canonical single-string form of a reference, for keys, logs and diagnostics:\n * `library#key`, or `library#key#variant`. Two references are equal exactly when their text forms are equal.\n * It is a convenience for people and tools, not the persisted shape - persist the {@link IconReference}.\n *\n * @throws Error when a part is empty or contains `#`.\n */\nexport function formatIconReference(reference: IconReference): string {\n    if (!isIconReference(reference)) {\n        throw new Error(`'${JSON.stringify(reference)}' is not a valid icon reference: library and key are required, and no part may be empty or contain '${separator}'`);\n    }\n\n    return reference.variant === undefined\n        ? `${reference.library}${separator}${reference.key}`\n        : `${reference.library}${separator}${reference.key}${separator}${reference.variant}`;\n}\n\n/**\n * Reads the text form produced by {@link formatIconReference}. Returns `undefined` for anything that is\n * not one - including a bare legacy icon name such as `pi pi-home`, which has no library and so cannot be\n * made into a reference without choosing one.\n */\nexport function parseIconReference(text: string): IconReference | undefined {\n    const parts = text.split(separator);\n    if (parts.length < 2 || parts.length > 3 || !parts.every(isPart)) return undefined;\n    const [library, key, variant] = parts;\n    return variant === undefined ? { library, key } : { library, key, variant };\n}\n"],"names":["separator","isPart","value","length","includes","isIconReference","candidate","library","key","variant","undefined","iconReferencesEqual","left","right","formatIconReference","reference","Error","JSON","stringify","parseIconReference","text","parts","split","every"],"mappings":";;AAAA;AACA;AAIA;;;AAGC,IACD,MAAMA,SAAAA,GAAY,GAAA;AAElB,SAASC,OAAOC,KAAc,EAAA;IAC1B,OAAO,OAAOA,KAAAA,KAAU,QAAA,IAAYA,KAAAA,CAAMC,MAAM,GAAG,CAAA,IAAK,CAACD,KAAAA,CAAME,QAAQ,CAACJ,SAAAA,CAAAA;AAC5E;AAEA;;;;IAKO,SAASK,eAAAA,CAAgBH,KAAc,EAAA;AAC1C,IAAA,IAAI,OAAOA,KAAAA,KAAU,QAAA,IAAYA,KAAAA,KAAU,MAAM,OAAO,KAAA;AACxD,IAAA,MAAMI,SAAAA,GAAYJ,KAAAA;AAClB,IAAA,OAAOD,OAAOK,SAAAA,CAAUC,OAAO,CAAA,IAAKN,MAAAA,CAAOK,UAAUE,GAAG,CAAA,KAAMF,SAAAA,CAAUG,OAAO,KAAKC,SAAAA,IAAaT,MAAAA,CAAOK,SAAAA,CAAUG,OAAO,CAAA,CAAA;AAC7H;AAEA;;;AAGC,IACM,SAASE,mBAAAA,CAAoBC,IAAmB,EAAEC,KAAoB,EAAA;IACzE,OAAOD,IAAAA,CAAKL,OAAO,KAAKM,KAAAA,CAAMN,OAAO,IAAIK,IAAAA,CAAKJ,GAAG,KAAKK,KAAAA,CAAML,GAAG,IAAI,CAACI,IAAAA,CAAKH,OAAO,IAAIC,SAAQ,OAAQG,KAAAA,CAAMJ,OAAO,IAAIC,SAAQ,CAAA;AACjI;AAEA;;;;;;IAOO,SAASI,mBAAAA,CAAoBC,SAAwB,EAAA;IACxD,IAAI,CAACV,gBAAgBU,SAAAA,CAAAA,EAAY;AAC7B,QAAA,MAAM,IAAIC,KAAAA,CAAM,CAAC,CAAC,EAAEC,IAAAA,CAAKC,SAAS,CAACH,SAAAA,CAAAA,CAAW,oGAAoG,EAAEf,SAAAA,CAAU,CAAC,CAAC,CAAA;AACpK,IAAA;IAEA,OAAOe,SAAAA,CAAUN,OAAO,KAAKC,SAAAA,GACvB,CAAA,EAAGK,UAAUR,OAAO,CAAA,EAAGP,SAAAA,CAAAA,EAAYe,SAAAA,CAAUP,GAAG,CAAA,CAAE,GAClD,CAAA,EAAGO,SAAAA,CAAUR,OAAO,CAAA,EAAGP,SAAAA,CAAAA,EAAYe,SAAAA,CAAUP,GAAG,CAAA,EAAGR,SAAAA,CAAAA,EAAYe,SAAAA,CAAUN,OAAO,CAAA,CAAE;AAC5F;AAEA;;;;IAKO,SAASU,kBAAAA,CAAmBC,IAAY,EAAA;IAC3C,MAAMC,KAAAA,GAAQD,IAAAA,CAAKE,KAAK,CAACtB,SAAAA,CAAAA;AACzB,IAAA,IAAIqB,KAAAA,CAAMlB,MAAM,GAAG,CAAA,IAAKkB,KAAAA,CAAMlB,MAAM,GAAG,CAAA,IAAK,CAACkB,KAAAA,CAAME,KAAK,CAACtB,SAAS,OAAOS,SAAAA;AACzE,IAAA,MAAM,CAACH,OAAAA,EAASC,GAAAA,EAAKC,OAAAA,CAAQ,GAAGY,KAAAA;AAChC,IAAA,OAAOZ,YAAYC,SAAAA,GAAY;AAAEH,QAAAA,OAAAA;AAASC,QAAAA;KAAI,GAAI;AAAED,QAAAA,OAAAA;AAASC,QAAAA,GAAAA;AAAKC,QAAAA;AAAQ,KAAA;AAC9E;;;;;"}

package/dist/cjs/index.js

@@ -11,7 +11,6 @@ var Orientation = require('./common/Orientation.js');
 var Dock = require('./common/Dock.js');
 var GridUnitType = require('./common/GridUnitType.js');
 var GridLength = require('./common/GridLength.js');
-var IconReference = require('./common/IconReference.js');
 var DestinationReference = require('./common/DestinationReference.js');
 var WidthSizeClass = require('./sizeClasses/WidthSizeClass.js');
 var HeightSizeClass = require('./sizeClasses/HeightSizeClass.js');
@@ -59,6 +58,10 @@ var Contribution = require('./contributionPoints/Contribution.js');
 var NavigationItem = require('./contributionPoints/NavigationItem.js');
 var UiProfile = require('./profiles/UiProfile.js');
 var Theme = require('./profiles/Theme.js');
+var IconReference = require('./icons/IconReference.js');
+var iconReferences = require('./icons/iconReferences.js');
+var IconLibrary = require('./icons/IconLibrary.js');
+var IconEntry = require('./icons/IconEntry.js');
 var PackageKind = require('./packages/PackageKind.js');
 var PackageDependency = require('./packages/PackageDependency.js');
 var ScenePackage = require('./packages/ScenePackage.js');
@@ -159,7 +162,6 @@ exports.Orientation = Orientation.Orientation;
 exports.Dock = Dock.Dock;
 exports.GridUnitType = GridUnitType.GridUnitType;
 exports.GridLengthPropertyNames = GridLength.GridLengthPropertyNames;
-exports.IconReferencePropertyNames = IconReference.IconReferencePropertyNames;
 exports.DestinationReferencePropertyNames = DestinationReference.DestinationReferencePropertyNames;
 exports.WidthSizeClass = WidthSizeClass.WidthSizeClass;
 exports.HeightSizeClass = HeightSizeClass.HeightSizeClass;
@@ -207,6 +209,13 @@ exports.ContributionPropertyNames = Contribution.ContributionPropertyNames;
 exports.NavigationItemPropertyNames = NavigationItem.NavigationItemPropertyNames;
 exports.UiProfilePropertyNames = UiProfile.UiProfilePropertyNames;
 exports.ThemePropertyNames = Theme.ThemePropertyNames;
+exports.IconReferencePropertyNames = IconReference.IconReferencePropertyNames;
+exports.formatIconReference = iconReferences.formatIconReference;
+exports.iconReferencesEqual = iconReferences.iconReferencesEqual;
+exports.isIconReference = iconReferences.isIconReference;
+exports.parseIconReference = iconReferences.parseIconReference;
+exports.IconLibraryPropertyNames = IconLibrary.IconLibraryPropertyNames;
+exports.IconEntryPropertyNames = IconEntry.IconEntryPropertyNames;
 exports.PackageKind = PackageKind.PackageKind;
 exports.PackageDependencyPropertyNames = PackageDependency.PackageDependencyPropertyNames;
 exports.ScenePackagePropertyNames = ScenePackage.ScenePackagePropertyNames;

package/dist/cjs/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/cjs/packages/PackageKind.js

@@ -4,7 +4,7 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 /**
  * What a {@link ScenePackage} contributes to a {@link UiProfile}. A profile's package list mixes all
- * three kinds freely - the kind says what a package is for, never where it sits in the override-priority
+ * four kinds freely - the kind says what a package is for, never where it sits in the override-priority
  * order.
  */ var PackageKind = /*#__PURE__*/ function(PackageKind) {
     /**
@@ -27,6 +27,17 @@
      * against PrimeReact and Cratis Components, and says so. That is what makes "which blueprints can I
      * use" answerable from the packages a profile already has.
      */ PackageKind["Blueprint"] = "Blueprint";
+    /**
+     * Provides icons - a named, versioned library of them, such as Lucide or PrimeIcons - that screens,
+     * templates and blueprints refer to by {@link IconReference} rather than by CSS class or markup.
+     * A library declares its variants, renderer adapters and attribution through
+     * {@link ScenePackage.iconLibrary}; its icon catalog is loaded on demand, never listed in the package.
+     *
+     * It is a package kind rather than a contribution on another kind because everything an author asks
+     * of a library - select it in a profile, see its license and version, have it pulled in by the
+     * components that need it - is already what a package is. Several libraries coexist in one profile,
+     * and the library is part of every icon's identity, so same-named icons never shadow one another.
+     */ PackageKind["IconLibrary"] = "IconLibrary";
     return PackageKind;
 }({});
 

package/dist/cjs/packages/PackageKind.js.map

@@ -1 +1 @@
-{"version":3,"file":"PackageKind.js","sources":["../../../packages/PackageKind.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\n/**\n * What a {@link ScenePackage} contributes to a {@link UiProfile}. A profile's package list mixes all\n * three kinds freely - the kind says what a package is for, never where it sits in the override-priority\n * order.\n */\nexport enum PackageKind {\n    /**\n     * Declares component names a screen can resolve against. A package with no dependency on another\n     * `ComponentLibrary` is a base library (PrimeReact, `core`); one that depends on another layers on\n     * top of it.\n     */\n    ComponentLibrary = 'ComponentLibrary',\n\n    /**\n     * Contributes styling rather than components - a utility CSS system such as Tailwind. A styling\n     * package usually declares no components at all; component libraries depend on it to say \"my\n     * components are written against this styling system\".\n     */\n    Styling = 'Styling',\n\n    /**\n     * Provides the shape of an application: its {@link Layout}s, the {@link ScreenTemplate}s and\n     * {@link DialogTemplate}s built on them, and the components that fill their slots. An application\n     * selects one blueprint, and gets a coherent set rather than assembling layouts and templates from\n     * unrelated sources.\n     *\n     * A blueprint depends on the component libraries it is built from — the default blueprint is written\n     * against PrimeReact and Cratis Components, and says so. That is what makes \"which blueprints can I\n     * use\" answerable from the packages a profile already has.\n     */\n    Blueprint = 'Blueprint',\n}\n"],"names":["PackageKind"],"mappings":";;AAAA;AACA;AAEA;;;;IAKO,IAAKA,WAAAA,iBAAAA,SAAAA,WAAAA,EAAAA;AACR;;;;AAIC,QAAA,WAAA,CAAA,kBAAA,CAAA,GAAA,kBAAA;AAGD;;;;AAIC,QAAA,WAAA,CAAA,SAAA,CAAA,GAAA,SAAA;AAGD;;;;;;;;;AASC,QAAA,WAAA,CAAA,WAAA,CAAA,GAAA,WAAA;AAxBOA,IAAAA,OAAAA,WAAAA;AA0BX,CAAA,CAAA,EAAA;;"}
+{"version":3,"file":"PackageKind.js","sources":["../../../packages/PackageKind.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\n/**\n * What a {@link ScenePackage} contributes to a {@link UiProfile}. A profile's package list mixes all\n * four kinds freely - the kind says what a package is for, never where it sits in the override-priority\n * order.\n */\nexport enum PackageKind {\n    /**\n     * Declares component names a screen can resolve against. A package with no dependency on another\n     * `ComponentLibrary` is a base library (PrimeReact, `core`); one that depends on another layers on\n     * top of it.\n     */\n    ComponentLibrary = 'ComponentLibrary',\n\n    /**\n     * Contributes styling rather than components - a utility CSS system such as Tailwind. A styling\n     * package usually declares no components at all; component libraries depend on it to say \"my\n     * components are written against this styling system\".\n     */\n    Styling = 'Styling',\n\n    /**\n     * Provides the shape of an application: its {@link Layout}s, the {@link ScreenTemplate}s and\n     * {@link DialogTemplate}s built on them, and the components that fill their slots. An application\n     * selects one blueprint, and gets a coherent set rather than assembling layouts and templates from\n     * unrelated sources.\n     *\n     * A blueprint depends on the component libraries it is built from — the default blueprint is written\n     * against PrimeReact and Cratis Components, and says so. That is what makes \"which blueprints can I\n     * use\" answerable from the packages a profile already has.\n     */\n    Blueprint = 'Blueprint',\n\n    /**\n     * Provides icons - a named, versioned library of them, such as Lucide or PrimeIcons - that screens,\n     * templates and blueprints refer to by {@link IconReference} rather than by CSS class or markup.\n     * A library declares its variants, renderer adapters and attribution through\n     * {@link ScenePackage.iconLibrary}; its icon catalog is loaded on demand, never listed in the package.\n     *\n     * It is a package kind rather than a contribution on another kind because everything an author asks\n     * of a library - select it in a profile, see its license and version, have it pulled in by the\n     * components that need it - is already what a package is. Several libraries coexist in one profile,\n     * and the library is part of every icon's identity, so same-named icons never shadow one another.\n     */\n    IconLibrary = 'IconLibrary',\n}\n"],"names":["PackageKind"],"mappings":";;AAAA;AACA;AAEA;;;;IAKO,IAAKA,WAAAA,iBAAAA,SAAAA,WAAAA,EAAAA;AACR;;;;AAIC,QAAA,WAAA,CAAA,kBAAA,CAAA,GAAA,kBAAA;AAGD;;;;AAIC,QAAA,WAAA,CAAA,SAAA,CAAA,GAAA,SAAA;AAGD;;;;;;;;;AASC,QAAA,WAAA,CAAA,WAAA,CAAA,GAAA,WAAA;AAGD;;;;;;;;;;AAUC,QAAA,WAAA,CAAA,aAAA,CAAA,GAAA,aAAA;AArCOA,IAAAA,OAAAA,WAAAA;AAuCX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/packages/ScenePackage.js

@@ -16,7 +16,8 @@ const ScenePackagePropertyNames = [
     'description',
     'module',
     'license',
-    'licenseUrl'
+    'licenseUrl',
+    'iconLibrary'
 ];
 
 exports.ScenePackagePropertyNames = ScenePackagePropertyNames;

package/dist/cjs/packages/ScenePackage.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScenePackage.js","sources":["../../../packages/ScenePackage.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 { PackageDependency } from './PackageDependency';\nimport { PackageKind } from './PackageKind';\n\n/**\n * What a {@link UiProfile}'s `packages` entry actually names. A profile lists packages by name only;\n * this is the declaration behind the name - what it contributes, and what else has to be active for it\n * to work.\n */\nexport interface ScenePackage {\n    /**\n     * The name a {@link UiProfile} lists, and the name a {@link PackageDependency} refers to.\n     */\n    name: string;\n\n    /**\n     * The package's own version, so a {@link PackageDependency.versionRange} has something to check against.\n     */\n    version: string;\n\n    /**\n     * What the package contributes.\n     */\n    kind: PackageKind;\n\n    /**\n     * Other packages that must be active in the same profile for this one to work.\n     */\n    dependencies: PackageDependency[];\n\n    /**\n     * The component names this package declares - the catalog entry {@link UiProfile} resolution walks.\n     */\n    components: string[];\n\n    /**\n     * The names of the {@link Layout}s this package provides — an application's base navigational shells.\n     * Empty for anything that is not a {@link PackageKind.Blueprint}.\n     */\n    layouts: string[];\n\n    /**\n     * The names of the {@link ScreenTemplate}s this package provides — the shapes that go inside a layout,\n     * at module, feature and slice level.\n     */\n    screenTemplates: string[];\n\n    /**\n     * The names of the {@link DialogTemplate}s this package provides.\n     */\n    dialogTemplates: string[];\n\n    /**\n     * The names of the {@link Theme}s this package ships, empty for a package that ships none.\n     */\n    themes: string[];\n\n    /**\n     * A human-readable name for a package picker, falling back to `name` when absent.\n     */\n    displayName?: string;\n\n    /**\n     * A one-line description for a package picker.\n     */\n    description?: string;\n\n    /**\n     * The module that implements the package - an npm package name for a web renderer. Design-time\n     * tooling needs it to know what to import; the model itself never loads anything.\n     */\n    module?: string;\n\n    /**\n     * The license the package is available under, as a short human-readable name (`MIT`,\n     * `PrimeUI Community`). A package picker shows it, because \"what am I taking on by selecting this\"\n     * is a question an author needs answered before they select it, not after.\n     */\n    license?: string;\n\n    /**\n     * Where the license terms actually live, so a reader can go and check rather than take `license` on\n     * trust. Required in practice for anything that is not a permissive standard license — a name alone\n     * tells an author nothing about eligibility or obligations.\n     */\n    licenseUrl?: string;\n}\n\nexport const ScenePackagePropertyNames: (keyof ScenePackage)[] = [\n    'name',\n    'version',\n    'kind',\n    'dependencies',\n    'components',\n    'layouts',\n    'screenTemplates',\n    'dialogTemplates',\n    'themes',\n    'displayName',\n    'description',\n    'module',\n    'license',\n    'licenseUrl',\n];\n"],"names":["ScenePackagePropertyNames"],"mappings":";;AAAA;AACA;MAyFaA,yBAAAA,GAAoD;AAC7D,IAAA,MAAA;AACA,IAAA,SAAA;AACA,IAAA,MAAA;AACA,IAAA,cAAA;AACA,IAAA,YAAA;AACA,IAAA,SAAA;AACA,IAAA,iBAAA;AACA,IAAA,iBAAA;AACA,IAAA,QAAA;AACA,IAAA,aAAA;AACA,IAAA,aAAA;AACA,IAAA,QAAA;AACA,IAAA,SAAA;AACA,IAAA;;;"}
+{"version":3,"file":"ScenePackage.js","sources":["../../../packages/ScenePackage.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 { IconLibrary } from '../icons';\nimport { PackageDependency } from './PackageDependency';\nimport { PackageKind } from './PackageKind';\n\n/**\n * What a {@link UiProfile}'s `packages` entry actually names. A profile lists packages by name only;\n * this is the declaration behind the name - what it contributes, and what else has to be active for it\n * to work.\n */\nexport interface ScenePackage {\n    /**\n     * The name a {@link UiProfile} lists, and the name a {@link PackageDependency} refers to.\n     */\n    name: string;\n\n    /**\n     * The package's own version, so a {@link PackageDependency.versionRange} has something to check against.\n     */\n    version: string;\n\n    /**\n     * What the package contributes.\n     */\n    kind: PackageKind;\n\n    /**\n     * Other packages that must be active in the same profile for this one to work.\n     */\n    dependencies: PackageDependency[];\n\n    /**\n     * The component names this package declares - the catalog entry {@link UiProfile} resolution walks.\n     */\n    components: string[];\n\n    /**\n     * The names of the {@link Layout}s this package provides — an application's base navigational shells.\n     * Empty for anything that is not a {@link PackageKind.Blueprint}.\n     */\n    layouts: string[];\n\n    /**\n     * The names of the {@link ScreenTemplate}s this package provides — the shapes that go inside a layout,\n     * at module, feature and slice level.\n     */\n    screenTemplates: string[];\n\n    /**\n     * The names of the {@link DialogTemplate}s this package provides.\n     */\n    dialogTemplates: string[];\n\n    /**\n     * The names of the {@link Theme}s this package ships, empty for a package that ships none.\n     */\n    themes: string[];\n\n    /**\n     * A human-readable name for a package picker, falling back to `name` when absent.\n     */\n    displayName?: string;\n\n    /**\n     * A one-line description for a package picker.\n     */\n    description?: string;\n\n    /**\n     * The module that implements the package - an npm package name for a web renderer. Design-time\n     * tooling needs it to know what to import; the model itself never loads anything.\n     */\n    module?: string;\n\n    /**\n     * The license the package is available under, as a short human-readable name (`MIT`,\n     * `PrimeUI Community`). A package picker shows it, because \"what am I taking on by selecting this\"\n     * is a question an author needs answered before they select it, not after.\n     */\n    license?: string;\n\n    /**\n     * Where the license terms actually live, so a reader can go and check rather than take `license` on\n     * trust. Required in practice for anything that is not a permissive standard license — a name alone\n     * tells an author nothing about eligibility or obligations.\n     */\n    licenseUrl?: string;\n\n    /**\n     * What the package declares about its icons. Present exactly for a {@link PackageKind.IconLibrary}.\n     */\n    iconLibrary?: IconLibrary;\n}\n\nexport const ScenePackagePropertyNames: (keyof ScenePackage)[] = [\n    'name',\n    'version',\n    'kind',\n    'dependencies',\n    'components',\n    'layouts',\n    'screenTemplates',\n    'dialogTemplates',\n    'themes',\n    'displayName',\n    'description',\n    'module',\n    'license',\n    'licenseUrl',\n    'iconLibrary',\n];\n"],"names":["ScenePackagePropertyNames"],"mappings":";;AAAA;AACA;MA+FaA,yBAAAA,GAAoD;AAC7D,IAAA,MAAA;AACA,IAAA,SAAA;AACA,IAAA,MAAA;AACA,IAAA,cAAA;AACA,IAAA,YAAA;AACA,IAAA,SAAA;AACA,IAAA,iBAAA;AACA,IAAA,iBAAA;AACA,IAAA,QAAA;AACA,IAAA,aAAA;AACA,IAAA,aAAA;AACA,IAAA,QAAA;AACA,IAAA,SAAA;AACA,IAAA,YAAA;AACA,IAAA;;;"}

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

@@ -9,6 +9,5 @@ export * from './Orientation';
 export * from './Dock';
 export * from './GridUnitType';
 export * from './GridLength';
-export * from './IconReference';
 export * from './DestinationReference';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../common/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../common/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/dist/esm/common/index.js

@@ -9,6 +9,5 @@ export * from './Orientation';
 export * from './Dock';
 export * from './GridUnitType';
 export * from './GridLength';
-export * from './IconReference';
 export * from './DestinationReference';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../common/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../common/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/dist/esm/editing/DiagnosticCode.d.ts

@@ -36,6 +36,12 @@ export declare enum DiagnosticCode {
     UnknownCollectionField = "unknownCollectionField",
     CollectionItemNotFound = "collectionItemNotFound",
     DuplicateCollectionItem = "duplicateCollectionItem",
-    UnknownInstance = "unknownInstance"
+    UnknownInstance = "unknownInstance",
+    MissingIconLibrary = "missingIconLibrary",
+    MissingIcon = "missingIcon",
+    MissingIconVariant = "missingIconVariant",
+    IncompatibleIconLibrary = "incompatibleIconLibrary",
+    IconCatalogUnavailable = "iconCatalogUnavailable",
+    IconNotVerified = "iconNotVerified"
 }
 //# sourceMappingURL=DiagnosticCode.d.ts.map

package/dist/esm/editing/DiagnosticCode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DiagnosticCode.d.ts","sourceRoot":"","sources":["../../../editing/DiagnosticCode.ts"],"names":[],"mappings":"AAOA,oBAAY,cAAc;IAEtB,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAG3B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,0BAA0B,+BAA+B;IAGzD,cAAc,mBAAmB;IACjC,wBAAwB,6BAA6B;IACrD,0BAA0B,+BAA+B;IACzD,eAAe,oBAAoB;IAGnC,2BAA2B,gCAAgC;IAC3D,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,uBAAuB,4BAA4B;IACnD,gBAAgB,qBAAqB;IAGrC,YAAY,iBAAiB;IAC7B,uBAAuB,4BAA4B;IACnD,wBAAwB,6BAA6B;IACrD,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IAGzC,qBAAqB,0BAA0B;IAC/C,mBAAmB,wBAAwB;IAC3C,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IACjD,yBAAyB,8BAA8B;IACvD,wBAAwB,6BAA6B;IACrD,iCAAiC,sCAAsC;IACvE,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IACnD,eAAe,oBAAoB;CACtC"}
+{"version":3,"file":"DiagnosticCode.d.ts","sourceRoot":"","sources":["../../../editing/DiagnosticCode.ts"],"names":[],"mappings":"AAOA,oBAAY,cAAc;IAEtB,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAG3B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,0BAA0B,+BAA+B;IAGzD,cAAc,mBAAmB;IACjC,wBAAwB,6BAA6B;IACrD,0BAA0B,+BAA+B;IACzD,eAAe,oBAAoB;IAGnC,2BAA2B,gCAAgC;IAC3D,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,uBAAuB,4BAA4B;IACnD,gBAAgB,qBAAqB;IAGrC,YAAY,iBAAiB;IAC7B,uBAAuB,4BAA4B;IACnD,wBAAwB,6BAA6B;IACrD,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IAGzC,qBAAqB,0BAA0B;IAC/C,mBAAmB,wBAAwB;IAC3C,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IACjD,yBAAyB,8BAA8B;IACvD,wBAAwB,6BAA6B;IACrD,iCAAiC,sCAAsC;IACvE,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IACnD,eAAe,oBAAoB;IAGnC,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,uBAAuB,4BAA4B;IACnD,sBAAsB,2BAA2B;IACjD,eAAe,oBAAoB;CACtC"}

package/dist/esm/editing/DiagnosticCode.js

@@ -48,6 +48,13 @@
     DiagnosticCode["CollectionItemNotFound"] = "collectionItemNotFound";
     DiagnosticCode["DuplicateCollectionItem"] = "duplicateCollectionItem";
     DiagnosticCode["UnknownInstance"] = "unknownInstance";
+    // Icons
+    DiagnosticCode["MissingIconLibrary"] = "missingIconLibrary";
+    DiagnosticCode["MissingIcon"] = "missingIcon";
+    DiagnosticCode["MissingIconVariant"] = "missingIconVariant";
+    DiagnosticCode["IncompatibleIconLibrary"] = "incompatibleIconLibrary";
+    DiagnosticCode["IconCatalogUnavailable"] = "iconCatalogUnavailable";
+    DiagnosticCode["IconNotVerified"] = "iconNotVerified";
     return DiagnosticCode;
 }({});
 

package/dist/esm/editing/DiagnosticCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"DiagnosticCode.js","sources":["../../../editing/DiagnosticCode.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\n/**\n * The reasons inspection, editing, binding validation and configuration resolution report a problem. A host\n * switches on the code; the message is for a person.\n */\nexport enum DiagnosticCode {\n    // Addressing\n    UnknownNode = 'unknownNode',\n    DuplicateElementId = 'duplicateElementId',\n    UnknownScope = 'unknownScope',\n    InvalidEdit = 'invalidEdit',\n\n    // Properties\n    UnknownProperty = 'unknownProperty',\n    InvalidValue = 'invalidValue',\n    ReadOnlyProperty = 'readOnlyProperty',\n    NodeNotEditable = 'nodeNotEditable',\n    MissingComponentDescriptor = 'missingComponentDescriptor',\n\n    // Layout\n    NotALayoutNode = 'notALayoutNode',\n    LayoutTypeNotConvertible = 'layoutTypeNotConvertible',\n    LossyConversionNotAccepted = 'lossyConversionNotAccepted',\n    LossyConversion = 'lossyConversion',\n\n    // Structure\n    TargetDoesNotAcceptChildren = 'targetDoesNotAcceptChildren',\n    UnknownSlot = 'unknownSlot',\n    ContainmentCycle = 'containmentCycle',\n    IndexOutOfRange = 'indexOutOfRange',\n    ElementIdInUse = 'elementIdInUse',\n    MaximumChildrenExceeded = 'maximumChildrenExceeded',\n    NodeNotRemovable = 'nodeNotRemovable',\n\n    // Query binding\n    MissingQuery = 'missingQuery',\n    IncompatibleResultShape = 'incompatibleResultShape',\n    MissingRequiredParameter = 'missingRequiredParameter',\n    UnknownParameter = 'unknownParameter',\n    ArgumentTypeMismatch = 'argumentTypeMismatch',\n    UnresolvedArgumentSource = 'unresolvedArgumentSource',\n    UnknownResultField = 'unknownResultField',\n\n    // Exposure and instance configuration\n    ExposureTargetMissing = 'exposureTargetMissing',\n    ExposureWidensOwner = 'exposureWidensOwner',\n    ReExposureBroken = 'reExposureBroken',\n    ContributionNotExposed = 'contributionNotExposed',\n    ContributionTargetMissing = 'contributionTargetMissing',\n    ContributionTypeMismatch = 'contributionTypeMismatch',\n    ContributionOperationNotPermitted = 'contributionOperationNotPermitted',\n    UnknownCollectionField = 'unknownCollectionField',\n    CollectionItemNotFound = 'collectionItemNotFound',\n    DuplicateCollectionItem = 'duplicateCollectionItem',\n    UnknownInstance = 'unknownInstance',\n}\n"],"names":["DiagnosticCode"],"mappings":"AAAA;AACA;AAEA;;;IAIO,IAAKA,cAAAA,iBAAAA,SAAAA,cAAAA,EAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,IAAAA,OAAAA,cAAAA;AAkDX,CAAA,CAAA,EAAA;;"}
+{"version":3,"file":"DiagnosticCode.js","sources":["../../../editing/DiagnosticCode.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\n/**\n * The reasons inspection, editing, binding validation and configuration resolution report a problem. A host\n * switches on the code; the message is for a person.\n */\nexport enum DiagnosticCode {\n    // Addressing\n    UnknownNode = 'unknownNode',\n    DuplicateElementId = 'duplicateElementId',\n    UnknownScope = 'unknownScope',\n    InvalidEdit = 'invalidEdit',\n\n    // Properties\n    UnknownProperty = 'unknownProperty',\n    InvalidValue = 'invalidValue',\n    ReadOnlyProperty = 'readOnlyProperty',\n    NodeNotEditable = 'nodeNotEditable',\n    MissingComponentDescriptor = 'missingComponentDescriptor',\n\n    // Layout\n    NotALayoutNode = 'notALayoutNode',\n    LayoutTypeNotConvertible = 'layoutTypeNotConvertible',\n    LossyConversionNotAccepted = 'lossyConversionNotAccepted',\n    LossyConversion = 'lossyConversion',\n\n    // Structure\n    TargetDoesNotAcceptChildren = 'targetDoesNotAcceptChildren',\n    UnknownSlot = 'unknownSlot',\n    ContainmentCycle = 'containmentCycle',\n    IndexOutOfRange = 'indexOutOfRange',\n    ElementIdInUse = 'elementIdInUse',\n    MaximumChildrenExceeded = 'maximumChildrenExceeded',\n    NodeNotRemovable = 'nodeNotRemovable',\n\n    // Query binding\n    MissingQuery = 'missingQuery',\n    IncompatibleResultShape = 'incompatibleResultShape',\n    MissingRequiredParameter = 'missingRequiredParameter',\n    UnknownParameter = 'unknownParameter',\n    ArgumentTypeMismatch = 'argumentTypeMismatch',\n    UnresolvedArgumentSource = 'unresolvedArgumentSource',\n    UnknownResultField = 'unknownResultField',\n\n    // Exposure and instance configuration\n    ExposureTargetMissing = 'exposureTargetMissing',\n    ExposureWidensOwner = 'exposureWidensOwner',\n    ReExposureBroken = 'reExposureBroken',\n    ContributionNotExposed = 'contributionNotExposed',\n    ContributionTargetMissing = 'contributionTargetMissing',\n    ContributionTypeMismatch = 'contributionTypeMismatch',\n    ContributionOperationNotPermitted = 'contributionOperationNotPermitted',\n    UnknownCollectionField = 'unknownCollectionField',\n    CollectionItemNotFound = 'collectionItemNotFound',\n    DuplicateCollectionItem = 'duplicateCollectionItem',\n    UnknownInstance = 'unknownInstance',\n\n    // Icons\n    MissingIconLibrary = 'missingIconLibrary',\n    MissingIcon = 'missingIcon',\n    MissingIconVariant = 'missingIconVariant',\n    IncompatibleIconLibrary = 'incompatibleIconLibrary',\n    IconCatalogUnavailable = 'iconCatalogUnavailable',\n    IconNotVerified = 'iconNotVerified',\n}\n"],"names":["DiagnosticCode"],"mappings":"AAAA;AACA;AAEA;;;IAIO,IAAKA,cAAAA,iBAAAA,SAAAA,cAAAA,EAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,IAAAA,OAAAA,cAAAA;AA0DX,CAAA,CAAA,EAAA;;"}

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

@@ -0,0 +1,10 @@
+export interface IconEntry {
+    key: string;
+    name: string;
+    categories: string[];
+    aliases?: string[];
+    tags?: string[];
+    variants?: string[];
+}
+export declare const IconEntryPropertyNames: (keyof IconEntry)[];
+//# sourceMappingURL=IconEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconEntry.d.ts","sourceRoot":"","sources":["../../../icons/IconEntry.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,SAAS;IAItB,GAAG,EAAE,MAAM,CAAC;IAKZ,IAAI,EAAE,MAAM,CAAC;IAKb,UAAU,EAAE,MAAM,EAAE,CAAC;IAKrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAKnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAMhB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,sBAAsB,EAAE,CAAC,MAAM,SAAS,CAAC,EAAiE,CAAC"}

package/dist/esm/icons/IconEntry.js

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * One icon in an icon library's catalog: what a picker needs to find it and a reference needs to name it.
+ *
+ * An entry is metadata only. It holds no SVG, class name or component - that is the renderer's concern,
+ * resolved lazily per icon by the adapter - so a catalog is cheap to load and identical for every
+ * renderer. The {@link IconReference} that names the icon is the entry's `key` (and one of its
+ * `variants`) together with the library the catalog belongs to.
+ */ const IconEntryPropertyNames = [
+    'key',
+    'name',
+    'categories',
+    'aliases',
+    'tags',
+    'variants'
+];
+
+export { IconEntryPropertyNames };
+//# sourceMappingURL=IconEntry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconEntry.js","sources":["../../../icons/IconEntry.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\n/**\n * One icon in an icon library's catalog: what a picker needs to find it and a reference needs to name it.\n *\n * An entry is metadata only. It holds no SVG, class name or component - that is the renderer's concern,\n * resolved lazily per icon by the adapter - so a catalog is cheap to load and identical for every\n * renderer. The {@link IconReference} that names the icon is the entry's `key` (and one of its\n * `variants`) together with the library the catalog belongs to.\n */\nexport interface IconEntry {\n    /**\n     * The stable key within the library; what an {@link IconReference} persists.\n     */\n    key: string;\n\n    /**\n     * The display name a picker shows. Never identity - two libraries may share a name.\n     */\n    name: string;\n\n    /**\n     * The categories the icon is filed under, for browsing.\n     */\n    categories: string[];\n\n    /**\n     * Alternative names to find the icon by (`bin` for `trash`).\n     */\n    aliases?: string[];\n\n    /**\n     * Free-form search terms.\n     */\n    tags?: string[];\n\n    /**\n     * The variants this icon exists in. Absent or empty when the icon has no variants, in which case\n     * references to it carry none.\n     */\n    variants?: string[];\n}\n\nexport const IconEntryPropertyNames: (keyof IconEntry)[] = ['key', 'name', 'categories', 'aliases', 'tags', 'variants'];\n"],"names":["IconEntryPropertyNames"],"mappings":"AAAA;AACA;AAEA;;;;;;;UAyCaA,sBAAAA,GAA8C;AAAC,IAAA,KAAA;AAAO,IAAA,MAAA;AAAQ,IAAA,YAAA;AAAc,IAAA,SAAA;AAAW,IAAA,MAAA;AAAQ,IAAA;;;"}

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

@@ -0,0 +1,9 @@
+export interface IconLibrary {
+    variants: string[];
+    renderers: string[];
+    attribution?: string;
+    attributionUrl?: string;
+    iconCount?: number;
+}
+export declare const IconLibraryPropertyNames: (keyof IconLibrary)[];
+//# sourceMappingURL=IconLibrary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconLibrary.d.ts","sourceRoot":"","sources":["../../../icons/IconLibrary.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,WAAW;IAKxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAMnB,SAAS,EAAE,MAAM,EAAE,CAAC;IAKpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,cAAc,CAAC,EAAE,MAAM,CAAC;IAKxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,wBAAwB,EAAE,CAAC,MAAM,WAAW,CAAC,EAA4E,CAAC"}

package/dist/esm/icons/IconLibrary.js

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * What a {@link ScenePackage} of kind {@link PackageKind.IconLibrary} declares about its icons, beyond
+ * what every package declares (name, version, license, dependencies, module).
+ *
+ * It is deliberately small. The icons themselves are not listed here: a library can ship thousands, and a
+ * profile resolution that read every key of every library would defeat the point of resolving without
+ * loading anything. The icon *catalog* - an {@link IconEntry} per icon - is loaded on demand from the
+ * library's module, and each icon's artwork is loaded per icon by the renderer's adapter.
+ */ const IconLibraryPropertyNames = [
+    'variants',
+    'renderers',
+    'attribution',
+    'attributionUrl',
+    'iconCount'
+];
+
+export { IconLibraryPropertyNames };
+//# sourceMappingURL=IconLibrary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconLibrary.js","sources":["../../../icons/IconLibrary.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\n/**\n * What a {@link ScenePackage} of kind {@link PackageKind.IconLibrary} declares about its icons, beyond\n * what every package declares (name, version, license, dependencies, module).\n *\n * It is deliberately small. The icons themselves are not listed here: a library can ship thousands, and a\n * profile resolution that read every key of every library would defeat the point of resolving without\n * loading anything. The icon *catalog* - an {@link IconEntry} per icon - is loaded on demand from the\n * library's module, and each icon's artwork is loaded per icon by the renderer's adapter.\n */\nexport interface IconLibrary {\n    /**\n     * The style variants the library offers (`outline`, `solid` ...), empty when it has a single style.\n     * Declared here so a picker can offer variant filters before it has loaded the catalog.\n     */\n    variants: string[];\n\n    /**\n     * The renderers the library ships an adapter for (`react` ...), so tooling can say whether the\n     * library can render for the target a profile selects without loading it.\n     */\n    renderers: string[];\n\n    /**\n     * The credit line the library's license asks to be shown, for example \"Icons by Lucide contributors\".\n     */\n    attribution?: string;\n\n    /**\n     * Where the attribution points - the library's home or license page.\n     */\n    attributionUrl?: string;\n\n    /**\n     * How many icons the catalog holds, for a picker's \"1,500 icons\" before the catalog is loaded.\n     */\n    iconCount?: number;\n}\n\nexport const IconLibraryPropertyNames: (keyof IconLibrary)[] = ['variants', 'renderers', 'attribution', 'attributionUrl', 'iconCount'];\n"],"names":["IconLibraryPropertyNames"],"mappings":"AAAA;AACA;AAEA;;;;;;;;UAsCaA,wBAAAA,GAAkD;AAAC,IAAA,UAAA;AAAY,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,gBAAA;AAAkB,IAAA;;;"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconReference.d.ts","sourceRoot":"","sources":["../../../icons/IconReference.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,aAAa;IAK1B,OAAO,EAAE,MAAM,CAAC;IAMhB,GAAG,EAAE,MAAM,CAAC;IAKZ,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,0BAA0B,EAAE,CAAC,MAAM,aAAa,CAAC,EAAkC,CAAC"}

package/dist/esm/icons/IconReference.js

@@ -0,0 +1,21 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The persisted, renderer-neutral identity of one icon: which icon library it comes from, which icon
+ * inside that library, and optionally which style variant of it.
+ *
+ * This is the only form in which a screen, template, blueprint or profile refers to an icon. It carries
+ * no CSS class, no SVG and no component - those belong to a renderer's adapter for the library - so the
+ * same reference renders on the web, on a phone, or anywhere else a library has an adapter.
+ *
+ * Identity is all three fields. A display name, a catalog position or a CSS class is never identity:
+ * two libraries can each ship an icon called `home`, and `{ library: 'a', key: 'home' }` and
+ * `{ library: 'b', key: 'home' }` are different icons that are never silently swapped for one another.
+ */ const IconReferencePropertyNames = [
+    'library',
+    'key',
+    'variant'
+];
+
+export { IconReferencePropertyNames };
+//# sourceMappingURL=IconReference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconReference.js","sources":["../../../icons/IconReference.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\n/**\n * The persisted, renderer-neutral identity of one icon: which icon library it comes from, which icon\n * inside that library, and optionally which style variant of it.\n *\n * This is the only form in which a screen, template, blueprint or profile refers to an icon. It carries\n * no CSS class, no SVG and no component - those belong to a renderer's adapter for the library - so the\n * same reference renders on the web, on a phone, or anywhere else a library has an adapter.\n *\n * Identity is all three fields. A display name, a catalog position or a CSS class is never identity:\n * two libraries can each ship an icon called `home`, and `{ library: 'a', key: 'home' }` and\n * `{ library: 'b', key: 'home' }` are different icons that are never silently swapped for one another.\n */\nexport interface IconReference {\n    /**\n     * The identity of the icon library - the `name` of the {@link ScenePackage} of kind\n     * {@link PackageKind.IconLibrary} that provides the icon.\n     */\n    library: string;\n\n    /**\n     * The stable key of the icon inside its library. Stable means a library keeps the key across\n     * versions for as long as it ships the icon; it is not the icon's display name.\n     */\n    key: string;\n\n    /**\n     * The style variant (`outline`, `solid`, `filled` ...), or absent for a library or icon that has none.\n     */\n    variant?: string;\n}\n\nexport const IconReferencePropertyNames: (keyof IconReference)[] = ['library', 'key', 'variant'];\n"],"names":["IconReferencePropertyNames"],"mappings":"AAAA;AACA;AAEA;;;;;;;;;;;UA+BaA,0BAAAA,GAAsD;AAAC,IAAA,SAAA;AAAW,IAAA,KAAA;AAAO,IAAA;;;"}

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

@@ -0,0 +1,6 @@
+import { IconReference } from './IconReference';
+export declare function isIconReference(value: unknown): value is IconReference;
+export declare function iconReferencesEqual(left: IconReference, right: IconReference): boolean;
+export declare function formatIconReference(reference: IconReference): string;
+export declare function parseIconReference(text: string): IconReference | undefined;
+//# sourceMappingURL=iconReferences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iconReferences.d.ts","sourceRoot":"","sources":["../../../icons/iconReferences.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiBhD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAItE;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAEtF;AASD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAQpE;AAOD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAK1E"}