@cratis/scene.model 4.37.0 → 4.39.0

package/dist/cjs/index.js

@@ -75,6 +75,8 @@ var IconEntry = require('./icons/IconEntry.js');
 var PackageKind = require('./packages/PackageKind.js');
 var PackageDependency = require('./packages/PackageDependency.js');
 var ScenePackage = require('./packages/ScenePackage.js');
+var BlueprintScreen = require('./packages/BlueprintScreen.js');
+var BlueprintMetadata = require('./packages/BlueprintMetadata.js');
 var SampleFieldKind = require('./sampleData/SampleFieldKind.js');
 var SampleShapeField = require('./sampleData/SampleShapeField.js');
 var SampleShape = require('./sampleData/SampleShape.js');
@@ -277,6 +279,8 @@ exports.IconEntryPropertyNames = IconEntry.IconEntryPropertyNames;
 exports.PackageKind = PackageKind.PackageKind;
 exports.PackageDependencyPropertyNames = PackageDependency.PackageDependencyPropertyNames;
 exports.ScenePackagePropertyNames = ScenePackage.ScenePackagePropertyNames;
+exports.BlueprintScreenPropertyNames = BlueprintScreen.BlueprintScreenPropertyNames;
+exports.BlueprintMetadataPropertyNames = BlueprintMetadata.BlueprintMetadataPropertyNames;
 exports.SampleFieldKind = SampleFieldKind.SampleFieldKind;
 exports.SampleShapeFieldPropertyNames = SampleShapeField.SampleShapeFieldPropertyNames;
 exports.SampleShapePropertyNames = SampleShape.SampleShapePropertyNames;

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/BlueprintMetadata.js

@@ -0,0 +1,14 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const BlueprintMetadataPropertyNames = [
+    'domain',
+    'description',
+    'thumbnail',
+    'screenSet',
+    'defaultSampleData'
+];
+
+exports.BlueprintMetadataPropertyNames = BlueprintMetadataPropertyNames;
+//# sourceMappingURL=BlueprintMetadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintMetadata.js","sources":["../../../packages/BlueprintMetadata.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 { BlueprintScreen } from './BlueprintScreen';\n\n/**\n * What a domain blueprint declares about itself beyond what every package does: the business domain it serves, how it\n * is described in a gallery, and the ready-to-use screens it brings with their navigation.\n *\n * A blueprint's own version is {@link ScenePackage.version}: there is deliberately no second version here to drift from\n * it. That version is what a template reference pins (`TemplateReference.version`) and what \"update available\" compares.\n * Its sample-data packs are {@link ScenePackage.sampleData}; {@link BlueprintMetadata.defaultSampleData} chooses among them.\n */\nexport interface BlueprintMetadata {\n    /** The business domain, as a lower-case slug (`crm`, `project-tracker`). Templates of the blueprint are categorised under `Business / <domain>`. */\n    domain: string;\n\n    /** One sentence, up to 200 characters, saying what the blueprint gives an application. Shown under the thumbnail in a gallery. */\n    description: string;\n\n    /** The package-relative path of the gallery thumbnail, `thumbnails/<name>.png`, `.webp`, `.jpg` or `.svg`. It is design-time only and never part of a runtime bundle. */\n    thumbnail: string;\n\n    /** The ready-to-use screens, in navigation order. */\n    screenSet: BlueprintScreen[];\n\n    /** The id of the sample-data pack a gallery preview and a new application start with; one of the package's `sampleData` ids. Required when the package ships more than one. */\n    defaultSampleData?: string;\n}\n\nexport const BlueprintMetadataPropertyNames: (keyof BlueprintMetadata)[] = ['domain', 'description', 'thumbnail', 'screenSet', 'defaultSampleData'];\n"],"names":["BlueprintMetadataPropertyNames"],"mappings":";;AAAA;AACA;MA6BaA,8BAAAA,GAA8D;AAAC,IAAA,QAAA;AAAU,IAAA,aAAA;AAAe,IAAA,WAAA;AAAa,IAAA,WAAA;AAAa,IAAA;;;"}

package/dist/cjs/packages/BlueprintScreen.js

@@ -0,0 +1,16 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const BlueprintScreenPropertyNames = [
+    'name',
+    'title',
+    'description',
+    'template',
+    'parent',
+    'order',
+    'icon'
+];
+
+exports.BlueprintScreenPropertyNames = BlueprintScreenPropertyNames;
+//# sourceMappingURL=BlueprintScreen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintScreen.js","sources":["../../../packages/BlueprintScreen.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 '../icons';\n\n/**\n * One screen of a domain blueprint's ready-to-use screen set, with where it sits in the navigation the blueprint\n * brings. The screen itself (its layout, template and content) is a `Screen` the package provides under the same\n * name; this is the part a gallery and a navigation builder need without loading it.\n */\nexport interface BlueprintScreen {\n    /** The name of the {@link Screen} the package provides. Unique within the screen set. */\n    name: string;\n\n    /** The title shown in the navigation and in the gallery. */\n    title: string;\n\n    /** One sentence saying what the screen is for. */\n    description?: string;\n\n    /** The name of the screen template the screen is built from, when it is built from one. */\n    template?: string;\n\n    /** The name of the screen this one sits under in the navigation; absent for a top-level screen. */\n    parent?: string;\n\n    /** Where the screen sits among its siblings; lower comes first, and screens without an order keep the order they are written in. */\n    order?: number;\n\n    /** The icon beside the title in the navigation. */\n    icon?: IconReference;\n}\n\nexport const BlueprintScreenPropertyNames: (keyof BlueprintScreen)[] = ['name', 'title', 'description', 'template', 'parent', 'order', 'icon'];\n"],"names":["BlueprintScreenPropertyNames"],"mappings":";;AAAA;AACA;MAgCaA,4BAAAA,GAA0D;AAAC,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,aAAA;AAAe,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,OAAA;AAAS,IAAA;;;"}

package/dist/cjs/packages/ScenePackage.js

@@ -21,7 +21,8 @@ const ScenePackagePropertyNames = [
     'designTime',
     'assets',
     'runtimeSingletons',
-    'sampleData'
+    'sampleData',
+    'blueprint'
 ];
 
 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 { PackageDesignTimeMetadata } from '../descriptors';\nimport { IconLibrary } from '../icons';\nimport { PackageDependency } from './PackageDependency';\nimport { SampleDataPackReference } from '../sampleData';\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    /** Optional design-time extensions carried as metadata; runtime hosts do not load them unless approved. */\n    designTime?: PackageDesignTimeMetadata;\n\n    /** Asset URLs or package-relative asset entries (CSS, fonts, images) required by a web renderer. */\n    assets?: string[];\n\n    /** Runtime singleton dependency names that must not be duplicated across approved bundles. */\n    runtimeSingletons?: string[];\n\n    /**\n     * The sample-data packs this package ships (`sampleData/*.json`). Design and preview time only: a\n     * Stage production build never includes or resolves them.\n     */\n    sampleData?: SampleDataPackReference[];\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    'designTime',\n    'assets',\n    'runtimeSingletons',\n    'sampleData',\n];\n"],"names":["ScenePackagePropertyNames"],"mappings":";;AAAA;AACA;MAgHaA,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,aAAA;AACA,IAAA,YAAA;AACA,IAAA,QAAA;AACA,IAAA,mBAAA;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 { PackageDesignTimeMetadata } from '../descriptors';\nimport { IconLibrary } from '../icons';\nimport { PackageDependency } from './PackageDependency';\nimport { SampleDataPackReference } from '../sampleData';\nimport { BlueprintMetadata } from './BlueprintMetadata';\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    /** Optional design-time extensions carried as metadata; runtime hosts do not load them unless approved. */\n    designTime?: PackageDesignTimeMetadata;\n\n    /** Asset URLs or package-relative asset entries (CSS, fonts, images) required by a web renderer. */\n    assets?: string[];\n\n    /** Runtime singleton dependency names that must not be duplicated across approved bundles. */\n    runtimeSingletons?: string[];\n\n    /**\n     * The sample-data packs this package ships (`sampleData/*.json`). Design and preview time only: a\n     * Stage production build never includes or resolves them.\n     */\n    sampleData?: SampleDataPackReference[];\n\n    /**\n     * What a domain blueprint declares about itself: its domain, gallery description and thumbnail, and its ready-to-use\n     * screen set. Present for a domain {@link PackageKind.Blueprint}; a blueprint that only provides foundation layouts\n     * and templates has none.\n     */\n    blueprint?: BlueprintMetadata;\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    'designTime',\n    'assets',\n    'runtimeSingletons',\n    'sampleData',\n    'blueprint',\n];\n"],"names":["ScenePackagePropertyNames"],"mappings":";;AAAA;AACA;MAwHaA,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,aAAA;AACA,IAAA,YAAA;AACA,IAAA,QAAA;AACA,IAAA,mBAAA;AACA,IAAA,YAAA;AACA,IAAA;;;"}

package/dist/cjs/screens/TemplateMetadata.js

@@ -18,7 +18,8 @@ const TemplateMetadataPropertyNames = [
     'attribution',
     'license',
     'licenseUrl',
-    'sliceKinds'
+    'sliceKinds',
+    'thumbnail'
 ];
 
 exports.TemplateMetadataPropertyNames = TemplateMetadataPropertyNames;

package/dist/cjs/screens/TemplateMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateMetadata.js","sources":["../../../screens/TemplateMetadata.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 { TemplateAttribution } from './TemplateAttribution';\nimport { TemplateCompatibility } from './TemplateCompatibility';\nimport { SliceKind } from '../structure';\n\n/** The application hierarchy at which a reusable template is selected. */\nexport enum TemplateScope {\n    Application = 'Application',\n    Module = 'Module',\n    Feature = 'Feature',\n    Subfeature = 'Subfeature',\n    Slice = 'Slice',\n}\n\n/**\n * Semantic and browsing metadata. Category is required for blueprint templates and recommended for own templates. Type and category are open strings so packages can\n * introduce their own vocabulary without a Scene release. Category never determines applicability.\n */\nexport interface TemplateMetadata {\n    /** Semantic role; built-in roles are ApplicationShell, Workspace, List, Detail, Form and Dialog. */\n    type?: string;\n    /** A package-defined browse category, preserved even when the host does not recognize it. */\n    category?: string;\n    /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */\n    scopes?: TemplateScope[];\n    /** The Scene and package versions the template requires. Required for every shipped template. */\n    compatibility?: TemplateCompatibility;\n    /** Who authored the template. Required for every shipped template. */\n    attribution?: TemplateAttribution;\n    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */\n    license?: string;\n    /** An absolute `https` URL to the license terms. */\n    licenseUrl?: string;\n    /**\n     * For a template that applies at {@link TemplateScope.Slice}, the slice kinds it applies to. Absent uses the\n     * structural default: a dialog template applies to state change slices, a screen template to every kind that\n     * presents something. Declaring slice kinds without scopes makes the default scope Slice.\n     */\n    sliceKinds?: SliceKind[];\n}\n\nexport const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [\n    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl', 'sliceKinds',\n];\n"],"names":["TemplateScope","TemplateMetadataPropertyNames"],"mappings":";;AAAA;AACA;AAMA,2EACO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;;;;;;AAAAA,IAAAA,OAAAA,aAAAA;AAMX,CAAA,CAAA,EAAA;MA6BYC,6BAAAA,GAA4D;AACrE,IAAA,MAAA;AAAQ,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,SAAA;AAAW,IAAA,YAAA;AAAc,IAAA;;;;"}
+{"version":3,"file":"TemplateMetadata.js","sources":["../../../screens/TemplateMetadata.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 { TemplateAttribution } from './TemplateAttribution';\nimport { TemplateCompatibility } from './TemplateCompatibility';\nimport { SliceKind } from '../structure';\n\n/** The application hierarchy at which a reusable template is selected. */\nexport enum TemplateScope {\n    Application = 'Application',\n    Module = 'Module',\n    Feature = 'Feature',\n    Subfeature = 'Subfeature',\n    Slice = 'Slice',\n}\n\n/**\n * Semantic and browsing metadata. Category is required for blueprint templates and recommended for own templates. Type and category are open strings so packages can\n * introduce their own vocabulary without a Scene release. Category never determines applicability.\n */\nexport interface TemplateMetadata {\n    /** Semantic role; built-in roles are ApplicationShell, Workspace, List, Detail, Form and Dialog. */\n    type?: string;\n    /** A package-defined browse category, preserved even when the host does not recognize it. */\n    category?: string;\n    /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */\n    scopes?: TemplateScope[];\n    /** The Scene and package versions the template requires. Required for every shipped template. */\n    compatibility?: TemplateCompatibility;\n    /** Who authored the template. Required for every shipped template. */\n    attribution?: TemplateAttribution;\n    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */\n    license?: string;\n    /** An absolute `https` URL to the license terms. */\n    licenseUrl?: string;\n    /**\n     * For a template that applies at {@link TemplateScope.Slice}, the slice kinds it applies to. Absent uses the\n     * structural default: a dialog template applies to state change slices, a screen template to every kind that\n     * presents something. Declaring slice kinds without scopes makes the default scope Slice.\n     */\n    sliceKinds?: SliceKind[];\n\n    /** The package-relative path of the template's gallery thumbnail (`thumbnails/<name>.png|webp|jpg|svg`); required of every template of a domain blueprint. */\n    thumbnail?: string;\n}\n\nexport const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [\n    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl', 'sliceKinds', 'thumbnail',\n];\n"],"names":["TemplateScope","TemplateMetadataPropertyNames"],"mappings":";;AAAA;AACA;AAMA,2EACO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;;;;;;AAAAA,IAAAA,OAAAA,aAAAA;AAMX,CAAA,CAAA,EAAA;MAgCYC,6BAAAA,GAA4D;AACrE,IAAA,MAAA;AAAQ,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,SAAA;AAAW,IAAA,YAAA;AAAc,IAAA,YAAA;AAAc,IAAA;;;;"}

package/dist/esm/index.js

@@ -73,6 +73,8 @@ export { IconEntryPropertyNames } from './icons/IconEntry.js';
 export { PackageKind } from './packages/PackageKind.js';
 export { PackageDependencyPropertyNames } from './packages/PackageDependency.js';
 export { ScenePackagePropertyNames } from './packages/ScenePackage.js';
+export { BlueprintScreenPropertyNames } from './packages/BlueprintScreen.js';
+export { BlueprintMetadataPropertyNames } from './packages/BlueprintMetadata.js';
 export { SampleFieldKind } from './sampleData/SampleFieldKind.js';
 export { SampleShapeFieldPropertyNames } from './sampleData/SampleShapeField.js';
 export { SampleShapePropertyNames } from './sampleData/SampleShape.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/BlueprintMetadata.d.ts

@@ -0,0 +1,10 @@
+import { BlueprintScreen } from './BlueprintScreen';
+export interface BlueprintMetadata {
+    domain: string;
+    description: string;
+    thumbnail: string;
+    screenSet: BlueprintScreen[];
+    defaultSampleData?: string;
+}
+export declare const BlueprintMetadataPropertyNames: (keyof BlueprintMetadata)[];
+//# sourceMappingURL=BlueprintMetadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintMetadata.d.ts","sourceRoot":"","sources":["../../../packages/BlueprintMetadata.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUpD,MAAM,WAAW,iBAAiB;IAE9B,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,eAAe,EAAE,CAAC;IAG7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,MAAM,iBAAiB,CAAC,EAA6E,CAAC"}

package/dist/esm/packages/BlueprintMetadata.js

@@ -0,0 +1,12 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const BlueprintMetadataPropertyNames = [
+    'domain',
+    'description',
+    'thumbnail',
+    'screenSet',
+    'defaultSampleData'
+];
+
+export { BlueprintMetadataPropertyNames };
+//# sourceMappingURL=BlueprintMetadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintMetadata.js","sources":["../../../packages/BlueprintMetadata.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 { BlueprintScreen } from './BlueprintScreen';\n\n/**\n * What a domain blueprint declares about itself beyond what every package does: the business domain it serves, how it\n * is described in a gallery, and the ready-to-use screens it brings with their navigation.\n *\n * A blueprint's own version is {@link ScenePackage.version}: there is deliberately no second version here to drift from\n * it. That version is what a template reference pins (`TemplateReference.version`) and what \"update available\" compares.\n * Its sample-data packs are {@link ScenePackage.sampleData}; {@link BlueprintMetadata.defaultSampleData} chooses among them.\n */\nexport interface BlueprintMetadata {\n    /** The business domain, as a lower-case slug (`crm`, `project-tracker`). Templates of the blueprint are categorised under `Business / <domain>`. */\n    domain: string;\n\n    /** One sentence, up to 200 characters, saying what the blueprint gives an application. Shown under the thumbnail in a gallery. */\n    description: string;\n\n    /** The package-relative path of the gallery thumbnail, `thumbnails/<name>.png`, `.webp`, `.jpg` or `.svg`. It is design-time only and never part of a runtime bundle. */\n    thumbnail: string;\n\n    /** The ready-to-use screens, in navigation order. */\n    screenSet: BlueprintScreen[];\n\n    /** The id of the sample-data pack a gallery preview and a new application start with; one of the package's `sampleData` ids. Required when the package ships more than one. */\n    defaultSampleData?: string;\n}\n\nexport const BlueprintMetadataPropertyNames: (keyof BlueprintMetadata)[] = ['domain', 'description', 'thumbnail', 'screenSet', 'defaultSampleData'];\n"],"names":["BlueprintMetadataPropertyNames"],"mappings":"AAAA;AACA;MA6BaA,8BAAAA,GAA8D;AAAC,IAAA,QAAA;AAAU,IAAA,aAAA;AAAe,IAAA,WAAA;AAAa,IAAA,WAAA;AAAa,IAAA;;;"}

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

@@ -0,0 +1,12 @@
+import { IconReference } from '../icons';
+export interface BlueprintScreen {
+    name: string;
+    title: string;
+    description?: string;
+    template?: string;
+    parent?: string;
+    order?: number;
+    icon?: IconReference;
+}
+export declare const BlueprintScreenPropertyNames: (keyof BlueprintScreen)[];
+//# sourceMappingURL=BlueprintScreen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintScreen.d.ts","sourceRoot":"","sources":["../../../packages/BlueprintScreen.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,WAAW,eAAe;IAE5B,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,CAAC;IAGd,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,eAAO,MAAM,4BAA4B,EAAE,CAAC,MAAM,eAAe,CAAC,EAA4E,CAAC"}

package/dist/esm/packages/BlueprintScreen.js

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const BlueprintScreenPropertyNames = [
+    'name',
+    'title',
+    'description',
+    'template',
+    'parent',
+    'order',
+    'icon'
+];
+
+export { BlueprintScreenPropertyNames };
+//# sourceMappingURL=BlueprintScreen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintScreen.js","sources":["../../../packages/BlueprintScreen.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 '../icons';\n\n/**\n * One screen of a domain blueprint's ready-to-use screen set, with where it sits in the navigation the blueprint\n * brings. The screen itself (its layout, template and content) is a `Screen` the package provides under the same\n * name; this is the part a gallery and a navigation builder need without loading it.\n */\nexport interface BlueprintScreen {\n    /** The name of the {@link Screen} the package provides. Unique within the screen set. */\n    name: string;\n\n    /** The title shown in the navigation and in the gallery. */\n    title: string;\n\n    /** One sentence saying what the screen is for. */\n    description?: string;\n\n    /** The name of the screen template the screen is built from, when it is built from one. */\n    template?: string;\n\n    /** The name of the screen this one sits under in the navigation; absent for a top-level screen. */\n    parent?: string;\n\n    /** Where the screen sits among its siblings; lower comes first, and screens without an order keep the order they are written in. */\n    order?: number;\n\n    /** The icon beside the title in the navigation. */\n    icon?: IconReference;\n}\n\nexport const BlueprintScreenPropertyNames: (keyof BlueprintScreen)[] = ['name', 'title', 'description', 'template', 'parent', 'order', 'icon'];\n"],"names":["BlueprintScreenPropertyNames"],"mappings":"AAAA;AACA;MAgCaA,4BAAAA,GAA0D;AAAC,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,aAAA;AAAe,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,OAAA;AAAS,IAAA;;;"}

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

@@ -2,6 +2,7 @@ import { PackageDesignTimeMetadata } from '../descriptors';
 import { IconLibrary } from '../icons';
 import { PackageDependency } from './PackageDependency';
 import { SampleDataPackReference } from '../sampleData';
+import { BlueprintMetadata } from './BlueprintMetadata';
 import { PackageKind } from './PackageKind';
 export interface ScenePackage {
     name: string;
@@ -23,6 +24,7 @@ export interface ScenePackage {
     assets?: string[];
     runtimeSingletons?: string[];
     sampleData?: SampleDataPackReference[];
+    blueprint?: BlueprintMetadata;
 }
 export declare const ScenePackagePropertyNames: (keyof ScenePackage)[];
 //# sourceMappingURL=ScenePackage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ScenePackage.d.ts","sourceRoot":"","sources":["../../../packages/ScenePackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,MAAM,WAAW,YAAY;IAIzB,IAAI,EAAE,MAAM,CAAC;IAKb,OAAO,EAAE,MAAM,CAAC;IAKhB,IAAI,EAAE,WAAW,CAAC;IAKlB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAKlC,UAAU,EAAE,MAAM,EAAE,CAAC;IAMrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAMlB,eAAe,EAAE,MAAM,EAAE,CAAC;IAK1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAK1B,MAAM,EAAE,MAAM,EAAE,CAAC;IAKjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAMrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAOjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAG1B,UAAU,CAAC,EAAE,yBAAyB,CAAC;IAGvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAGlB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAM7B,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,yBAAyB,EAAE,CAAC,MAAM,YAAY,CAAC,EAoB3D,CAAC"}
+{"version":3,"file":"ScenePackage.d.ts","sourceRoot":"","sources":["../../../packages/ScenePackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,MAAM,WAAW,YAAY;IAIzB,IAAI,EAAE,MAAM,CAAC;IAKb,OAAO,EAAE,MAAM,CAAC;IAKhB,IAAI,EAAE,WAAW,CAAC;IAKlB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAKlC,UAAU,EAAE,MAAM,EAAE,CAAC;IAMrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAMlB,eAAe,EAAE,MAAM,EAAE,CAAC;IAK1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAK1B,MAAM,EAAE,MAAM,EAAE,CAAC;IAKjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAMrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAOjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAG1B,UAAU,CAAC,EAAE,yBAAyB,CAAC;IAGvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAGlB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAM7B,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAOvC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,eAAO,MAAM,yBAAyB,EAAE,CAAC,MAAM,YAAY,CAAC,EAqB3D,CAAC"}

package/dist/esm/packages/ScenePackage.js

@@ -19,7 +19,8 @@ const ScenePackagePropertyNames = [
     'designTime',
     'assets',
     'runtimeSingletons',
-    'sampleData'
+    'sampleData',
+    'blueprint'
 ];
 
 export { ScenePackagePropertyNames };

package/dist/esm/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 { PackageDesignTimeMetadata } from '../descriptors';\nimport { IconLibrary } from '../icons';\nimport { PackageDependency } from './PackageDependency';\nimport { SampleDataPackReference } from '../sampleData';\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    /** Optional design-time extensions carried as metadata; runtime hosts do not load them unless approved. */\n    designTime?: PackageDesignTimeMetadata;\n\n    /** Asset URLs or package-relative asset entries (CSS, fonts, images) required by a web renderer. */\n    assets?: string[];\n\n    /** Runtime singleton dependency names that must not be duplicated across approved bundles. */\n    runtimeSingletons?: string[];\n\n    /**\n     * The sample-data packs this package ships (`sampleData/*.json`). Design and preview time only: a\n     * Stage production build never includes or resolves them.\n     */\n    sampleData?: SampleDataPackReference[];\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    'designTime',\n    'assets',\n    'runtimeSingletons',\n    'sampleData',\n];\n"],"names":["ScenePackagePropertyNames"],"mappings":"AAAA;AACA;MAgHaA,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,aAAA;AACA,IAAA,YAAA;AACA,IAAA,QAAA;AACA,IAAA,mBAAA;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 { PackageDesignTimeMetadata } from '../descriptors';\nimport { IconLibrary } from '../icons';\nimport { PackageDependency } from './PackageDependency';\nimport { SampleDataPackReference } from '../sampleData';\nimport { BlueprintMetadata } from './BlueprintMetadata';\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    /** Optional design-time extensions carried as metadata; runtime hosts do not load them unless approved. */\n    designTime?: PackageDesignTimeMetadata;\n\n    /** Asset URLs or package-relative asset entries (CSS, fonts, images) required by a web renderer. */\n    assets?: string[];\n\n    /** Runtime singleton dependency names that must not be duplicated across approved bundles. */\n    runtimeSingletons?: string[];\n\n    /**\n     * The sample-data packs this package ships (`sampleData/*.json`). Design and preview time only: a\n     * Stage production build never includes or resolves them.\n     */\n    sampleData?: SampleDataPackReference[];\n\n    /**\n     * What a domain blueprint declares about itself: its domain, gallery description and thumbnail, and its ready-to-use\n     * screen set. Present for a domain {@link PackageKind.Blueprint}; a blueprint that only provides foundation layouts\n     * and templates has none.\n     */\n    blueprint?: BlueprintMetadata;\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    'designTime',\n    'assets',\n    'runtimeSingletons',\n    'sampleData',\n    'blueprint',\n];\n"],"names":["ScenePackagePropertyNames"],"mappings":"AAAA;AACA;MAwHaA,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,aAAA;AACA,IAAA,YAAA;AACA,IAAA,QAAA;AACA,IAAA,mBAAA;AACA,IAAA,YAAA;AACA,IAAA;;;"}

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

@@ -1,4 +1,6 @@
 export * from './PackageKind';
 export * from './PackageDependency';
 export * from './ScenePackage';
+export * from './BlueprintScreen';
+export * from './BlueprintMetadata';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/esm/packages/index.js

@@ -1,4 +1,6 @@
 export * from './PackageKind';
 export * from './PackageDependency';
 export * from './ScenePackage';
+export * from './BlueprintScreen';
+export * from './BlueprintMetadata';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/esm/screens/TemplateMetadata.d.ts

@@ -17,6 +17,7 @@ export interface TemplateMetadata {
     license?: string;
     licenseUrl?: string;
     sliceKinds?: SliceKind[];
+    thumbnail?: string;
 }
 export declare const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[];
 //# sourceMappingURL=TemplateMetadata.d.ts.map

package/dist/esm/screens/TemplateMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateMetadata.d.ts","sourceRoot":"","sources":["../../../screens/TemplateMetadata.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,oBAAY,aAAa;IACrB,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,KAAK,UAAU;CAClB;AAMD,MAAM,WAAW,gBAAgB;IAE7B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IAEzB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAEtC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,6BAA6B,EAAE,CAAC,MAAM,gBAAgB,CAAC,EAEnE,CAAC"}
+{"version":3,"file":"TemplateMetadata.d.ts","sourceRoot":"","sources":["../../../screens/TemplateMetadata.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,oBAAY,aAAa;IACrB,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,KAAK,UAAU;CAClB;AAMD,MAAM,WAAW,gBAAgB;IAE7B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IAEzB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAEtC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IAGzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,6BAA6B,EAAE,CAAC,MAAM,gBAAgB,CAAC,EAEnE,CAAC"}

package/dist/esm/screens/TemplateMetadata.js

@@ -16,7 +16,8 @@ const TemplateMetadataPropertyNames = [
     'attribution',
     'license',
     'licenseUrl',
-    'sliceKinds'
+    'sliceKinds',
+    'thumbnail'
 ];
 
 export { TemplateMetadataPropertyNames, TemplateScope };

package/dist/esm/screens/TemplateMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateMetadata.js","sources":["../../../screens/TemplateMetadata.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 { TemplateAttribution } from './TemplateAttribution';\nimport { TemplateCompatibility } from './TemplateCompatibility';\nimport { SliceKind } from '../structure';\n\n/** The application hierarchy at which a reusable template is selected. */\nexport enum TemplateScope {\n    Application = 'Application',\n    Module = 'Module',\n    Feature = 'Feature',\n    Subfeature = 'Subfeature',\n    Slice = 'Slice',\n}\n\n/**\n * Semantic and browsing metadata. Category is required for blueprint templates and recommended for own templates. Type and category are open strings so packages can\n * introduce their own vocabulary without a Scene release. Category never determines applicability.\n */\nexport interface TemplateMetadata {\n    /** Semantic role; built-in roles are ApplicationShell, Workspace, List, Detail, Form and Dialog. */\n    type?: string;\n    /** A package-defined browse category, preserved even when the host does not recognize it. */\n    category?: string;\n    /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */\n    scopes?: TemplateScope[];\n    /** The Scene and package versions the template requires. Required for every shipped template. */\n    compatibility?: TemplateCompatibility;\n    /** Who authored the template. Required for every shipped template. */\n    attribution?: TemplateAttribution;\n    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */\n    license?: string;\n    /** An absolute `https` URL to the license terms. */\n    licenseUrl?: string;\n    /**\n     * For a template that applies at {@link TemplateScope.Slice}, the slice kinds it applies to. Absent uses the\n     * structural default: a dialog template applies to state change slices, a screen template to every kind that\n     * presents something. Declaring slice kinds without scopes makes the default scope Slice.\n     */\n    sliceKinds?: SliceKind[];\n}\n\nexport const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [\n    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl', 'sliceKinds',\n];\n"],"names":["TemplateScope","TemplateMetadataPropertyNames"],"mappings":"AAAA;AACA;AAMA,2EACO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;;;;;;AAAAA,IAAAA,OAAAA,aAAAA;AAMX,CAAA,CAAA,EAAA;MA6BYC,6BAAAA,GAA4D;AACrE,IAAA,MAAA;AAAQ,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,SAAA;AAAW,IAAA,YAAA;AAAc,IAAA;;;"}
+{"version":3,"file":"TemplateMetadata.js","sources":["../../../screens/TemplateMetadata.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 { TemplateAttribution } from './TemplateAttribution';\nimport { TemplateCompatibility } from './TemplateCompatibility';\nimport { SliceKind } from '../structure';\n\n/** The application hierarchy at which a reusable template is selected. */\nexport enum TemplateScope {\n    Application = 'Application',\n    Module = 'Module',\n    Feature = 'Feature',\n    Subfeature = 'Subfeature',\n    Slice = 'Slice',\n}\n\n/**\n * Semantic and browsing metadata. Category is required for blueprint templates and recommended for own templates. Type and category are open strings so packages can\n * introduce their own vocabulary without a Scene release. Category never determines applicability.\n */\nexport interface TemplateMetadata {\n    /** Semantic role; built-in roles are ApplicationShell, Workspace, List, Detail, Form and Dialog. */\n    type?: string;\n    /** A package-defined browse category, preserved even when the host does not recognize it. */\n    category?: string;\n    /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */\n    scopes?: TemplateScope[];\n    /** The Scene and package versions the template requires. Required for every shipped template. */\n    compatibility?: TemplateCompatibility;\n    /** Who authored the template. Required for every shipped template. */\n    attribution?: TemplateAttribution;\n    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */\n    license?: string;\n    /** An absolute `https` URL to the license terms. */\n    licenseUrl?: string;\n    /**\n     * For a template that applies at {@link TemplateScope.Slice}, the slice kinds it applies to. Absent uses the\n     * structural default: a dialog template applies to state change slices, a screen template to every kind that\n     * presents something. Declaring slice kinds without scopes makes the default scope Slice.\n     */\n    sliceKinds?: SliceKind[];\n\n    /** The package-relative path of the template's gallery thumbnail (`thumbnails/<name>.png|webp|jpg|svg`); required of every template of a domain blueprint. */\n    thumbnail?: string;\n}\n\nexport const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [\n    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl', 'sliceKinds', 'thumbnail',\n];\n"],"names":["TemplateScope","TemplateMetadataPropertyNames"],"mappings":"AAAA;AACA;AAMA,2EACO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;;;;;;AAAAA,IAAAA,OAAAA,aAAAA;AAMX,CAAA,CAAA,EAAA;MAgCYC,6BAAAA,GAA4D;AACrE,IAAA,MAAA;AAAQ,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,SAAA;AAAW,IAAA,YAAA;AAAc,IAAA,YAAA;AAAc,IAAA;;;"}