@cratis/scene.react 4.19.0 → 4.21.0

package/dist/cjs/packages/loadApprovedPackages.js

@@ -0,0 +1,122 @@
+'use strict';
+
+var PackageHostConfiguration = require('./PackageHostConfiguration.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Loads the runtime bundles of an approved package set through the host's importers.
+ *
+ * Nothing executes unless the host's policy allows executable imports. A package whose module cannot be imported,
+ * lacks its declared export, or whose bundle manifest differs from the declaration (name, version, components,
+ * layouts, templates, themes) contributes nothing and is reported - the declaration planning used and the code
+ * running must be the same package. Packages load in ordinal name order, so the result does not depend on the
+ * order the set was written in.
+ */ async function loadApprovedPackages(set, importers, policy) {
+    const bundles = [];
+    const diagnostics = [];
+    const ordered = [
+        ...set.packages
+    ].sort((a, b)=>a.manifest.name < b.manifest.name ? -1 : a.manifest.name > b.manifest.name ? 1 : 0);
+    for (const { manifest, module } of ordered){
+        const label = `Package '${manifest.name}'`;
+        if (!policy.allowExecutableImports) {
+            diagnostics.push(`${label} brings executable code from '${module.npm}', but host policy forbids executable imports`);
+            continue;
+        }
+        const importer = Object.prototype.hasOwnProperty.call(importers, module.npm) ? importers[module.npm] : undefined;
+        if (!importer) {
+            diagnostics.push(`${label} is imported from '${module.npm}', which this host's build does not include`);
+            continue;
+        }
+        let loaded;
+        try {
+            loaded = await importer();
+        } catch (error) {
+            diagnostics.push(`${label} could not be loaded from '${module.npm}': ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+        const bundle = loaded[module.export];
+        if (!bundle || typeof bundle !== 'object' || !bundle.manifest || !bundle.components) {
+            diagnostics.push(`${label} expects '${module.npm}' to export a package bundle named '${module.export}', which it does not`);
+            continue;
+        }
+        const mismatches = declarationMismatches(manifest, bundle);
+        if (mismatches.length > 0) {
+            diagnostics.push(...mismatches.map((mismatch)=>`${label} does not match the bundle '${module.export}' of '${module.npm}': ${mismatch}`));
+            continue;
+        }
+        bundles.push(bundle);
+    }
+    return {
+        bundles,
+        diagnostics
+    };
+}
+function declarationMismatches(declared, bundle) {
+    const actual = bundle.manifest;
+    const mismatches = [];
+    if (actual.name !== declared.name) mismatches.push(`the bundle is named '${actual.name}'`);
+    if (actual.version !== declared.version) mismatches.push(`the set declares version ${declared.version} but the bundle is ${actual.version}`);
+    if (actual.kind !== declared.kind) mismatches.push(`the set declares kind ${declared.kind} but the bundle is ${actual.kind}`);
+    const lists = [
+        'components',
+        'layouts',
+        'screenTemplates',
+        'dialogTemplates',
+        'themes'
+    ];
+    for (const list of lists){
+        const expected = [
+            ...declared[list] ?? []
+        ].sort();
+        const found = [
+            ...actual[list] ?? []
+        ].sort();
+        if (expected.join('\u0000') !== found.join('\u0000')) {
+            mismatches.push(`the set declares ${list} [${expected.join(', ')}] but the bundle declares [${found.join(', ')}]`);
+        }
+    }
+    return mismatches;
+}
+/**
+ * Loads the approved package set and resolves the effective profile over the built-in and approved bundles in one
+ * step. Packages that failed to load are reported in the result's `diagnostics` and block the host, so a profile
+ * is never rendered with a silently missing package.
+ */ async function resolveApprovedPackageHost(configuration) {
+    const { packageSet, importers, ...rest } = configuration;
+    const loaded = await loadApprovedPackages(packageSet, importers, configuration.policy);
+    const host = PackageHostConfiguration.resolvePackageHost({
+        ...rest,
+        bundles: [
+            ...configuration.bundles,
+            ...loaded.bundles
+        ]
+    });
+    if (loaded.diagnostics.length === 0) {
+        return host;
+    }
+    return {
+        ...host,
+        bundles: [],
+        components: {},
+        layouts: [],
+        screenTemplates: [],
+        dialogTemplates: [],
+        themes: [],
+        layout: undefined,
+        theme: undefined,
+        templates: [],
+        assets: [],
+        fonts: [],
+        blocked: true,
+        diagnostics: [
+            ...loaded.diagnostics,
+            ...host.diagnostics
+        ]
+    };
+}
+
+exports.loadApprovedPackages = loadApprovedPackages;
+exports.resolveApprovedPackageHost = resolveApprovedPackageHost;
+//# sourceMappingURL=loadApprovedPackages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadApprovedPackages.js","sources":["../../../packages/loadApprovedPackages.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 { ApprovedPackageSet } from './ApprovedPackageSet';\nimport { PackageHostConfiguration, ResolvedPackageHost, resolvePackageHost } from './PackageHostConfiguration';\nimport { ScenePackageBundle } from './ScenePackageBundle';\n\n/**\n * How a host loads the modules of an approved package set: one loader per npm package name the set may import.\n *\n * A bundler resolves imports at build time, so the host lists them as literal `import()` calls\n * (`{ '@acme/scene.charts': () => import('@acme/scene.charts') }`). A set naming a module the host's build does\n * not include is a diagnostic, never an attempt to load an arbitrary specifier.\n */\nexport type ApprovedPackageImporters = Record<string, () => Promise<Record<string, unknown>>>;\n\n/** The outcome of loading an approved package set. */\nexport interface LoadedApprovedPackages {\n    /** The bundles that loaded and match what the set declared, in ordinal package-name order. */\n    bundles: ScenePackageBundle[];\n\n    /** Every reason a package was not loaded or does not match its declaration. */\n    diagnostics: string[];\n}\n\n/**\n * Loads the runtime bundles of an approved package set through the host's importers.\n *\n * Nothing executes unless the host's policy allows executable imports. A package whose module cannot be imported,\n * lacks its declared export, or whose bundle manifest differs from the declaration (name, version, components,\n * layouts, templates, themes) contributes nothing and is reported - the declaration planning used and the code\n * running must be the same package. Packages load in ordinal name order, so the result does not depend on the\n * order the set was written in.\n */\nexport async function loadApprovedPackages(\n    set: ApprovedPackageSet,\n    importers: ApprovedPackageImporters,\n    policy: { allowExecutableImports: boolean },\n): Promise<LoadedApprovedPackages> {\n    const bundles: ScenePackageBundle[] = [];\n    const diagnostics: string[] = [];\n    const ordered = [...set.packages].sort((a, b) => (a.manifest.name < b.manifest.name ? -1 : a.manifest.name > b.manifest.name ? 1 : 0));\n\n    for (const { manifest, module } of ordered) {\n        const label = `Package '${manifest.name}'`;\n        if (!policy.allowExecutableImports) {\n            diagnostics.push(`${label} brings executable code from '${module.npm}', but host policy forbids executable imports`);\n            continue;\n        }\n\n        const importer = Object.prototype.hasOwnProperty.call(importers, module.npm) ? importers[module.npm] : undefined;\n        if (!importer) {\n            diagnostics.push(`${label} is imported from '${module.npm}', which this host's build does not include`);\n            continue;\n        }\n\n        let loaded: Record<string, unknown>;\n        try {\n            loaded = await importer();\n        } catch (error) {\n            diagnostics.push(`${label} could not be loaded from '${module.npm}': ${error instanceof Error ? error.message : String(error)}`);\n            continue;\n        }\n\n        const bundle = loaded[module.export] as ScenePackageBundle | undefined;\n        if (!bundle || typeof bundle !== 'object' || !bundle.manifest || !bundle.components) {\n            diagnostics.push(`${label} expects '${module.npm}' to export a package bundle named '${module.export}', which it does not`);\n            continue;\n        }\n\n        const mismatches = declarationMismatches(manifest, bundle);\n        if (mismatches.length > 0) {\n            diagnostics.push(...mismatches.map(mismatch => `${label} does not match the bundle '${module.export}' of '${module.npm}': ${mismatch}`));\n            continue;\n        }\n\n        bundles.push(bundle);\n    }\n\n    return { bundles, diagnostics };\n}\n\nfunction declarationMismatches(declared: ApprovedPackageSet['packages'][number]['manifest'], bundle: ScenePackageBundle): string[] {\n    const actual = bundle.manifest;\n    const mismatches: string[] = [];\n    if (actual.name !== declared.name) mismatches.push(`the bundle is named '${actual.name}'`);\n    if (actual.version !== declared.version) mismatches.push(`the set declares version ${declared.version} but the bundle is ${actual.version}`);\n    if (actual.kind !== declared.kind) mismatches.push(`the set declares kind ${declared.kind} but the bundle is ${actual.kind}`);\n\n    const lists = ['components', 'layouts', 'screenTemplates', 'dialogTemplates', 'themes'] as const;\n    for (const list of lists) {\n        const expected = [...(declared[list] ?? [])].sort();\n        const found = [...(actual[list] ?? [])].sort();\n        if (expected.join('\\u0000') !== found.join('\\u0000')) {\n            mismatches.push(`the set declares ${list} [${expected.join(', ')}] but the bundle declares [${found.join(', ')}]`);\n        }\n    }\n\n    return mismatches;\n}\n\n/** An approved package set and the importers that load it, resolved together with the built-in bundles. */\nexport interface ApprovedPackageHostConfiguration extends Omit<PackageHostConfiguration, 'bundles'> {\n    /** The bundles the host ships. */\n    bundles: ScenePackageBundle[];\n\n    /** The custom packages the host approved. */\n    packageSet: ApprovedPackageSet;\n\n    /** The importers for the set's modules. */\n    importers: ApprovedPackageImporters;\n}\n\n/**\n * Loads the approved package set and resolves the effective profile over the built-in and approved bundles in one\n * step. Packages that failed to load are reported in the result's `diagnostics` and block the host, so a profile\n * is never rendered with a silently missing package.\n */\nexport async function resolveApprovedPackageHost(configuration: ApprovedPackageHostConfiguration): Promise<ResolvedPackageHost> {\n    const { packageSet, importers, ...rest } = configuration;\n    const loaded = await loadApprovedPackages(packageSet, importers, configuration.policy);\n    const host = resolvePackageHost({ ...rest, bundles: [...configuration.bundles, ...loaded.bundles] });\n    if (loaded.diagnostics.length === 0) {\n        return host;\n    }\n\n    return {\n        ...host,\n        bundles: [],\n        components: {},\n        layouts: [],\n        screenTemplates: [],\n        dialogTemplates: [],\n        themes: [],\n        layout: undefined,\n        theme: undefined,\n        templates: [],\n        assets: [],\n        fonts: [],\n        blocked: true,\n        diagnostics: [...loaded.diagnostics, ...host.diagnostics],\n    };\n}\n"],"names":["loadApprovedPackages","set","importers","policy","bundles","diagnostics","ordered","packages","sort","a","b","manifest","name","module","label","allowExecutableImports","push","npm","importer","Object","prototype","hasOwnProperty","call","undefined","loaded","error","Error","message","String","bundle","export","components","mismatches","declarationMismatches","length","map","mismatch","declared","actual","version","kind","lists","list","expected","found","join","resolveApprovedPackageHost","configuration","packageSet","rest","host","resolvePackageHost","layouts","screenTemplates","dialogTemplates","themes","layout","theme","templates","assets","fonts","blocked"],"mappings":"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"}

package/dist/esm/NavBar/extractNavigationItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractNavigationItem.d.ts","sourceRoot":"","sources":["../../../NavBar/extractNavigationItem.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,YAAY,EAAqB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAczG,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAkB5F"}
+{"version":3,"file":"extractNavigationItem.d.ts","sourceRoot":"","sources":["../../../NavBar/extractNavigationItem.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,YAAY,EAA2C,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAe/H,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAuB5F"}

package/dist/esm/NavBar/extractNavigationItem.js

@@ -3,7 +3,8 @@
 /**
  * Reads a {@link NavigationItem} out of a {@link Contribution} to the built-in `Navigation` contribution
  * point. `Contribution.content` carries an {@link ExternalComponent} whose open `properties` bag holds the
- * navigation-specific values (`label`, `targetScreen`, `routeParameterBindings`, `order`, `group`) - the
+ * navigation-specific values (`label`, `targetScreen`, `routeParameterBindings`, `order`, `group`, and the
+ * optional `id`, `icon`, `presentation`, `destination` and `hierarchy`) - the
  * same names as {@link NavigationItem}'s own fields. This property-bag contract is Scene#2's own choice,
  * made without a real Screenplay-to-Scene translation to confirm it against (Stage#37 hasn't been built
  * yet) - whoever builds that seam should either produce contributions matching this contract or this
@@ -16,18 +17,26 @@
     if (!content.properties) {
         return undefined;
     }
-    const { label, targetScreen, routeParameterBindings, order, group } = content.properties;
+    const { id, label, icon, presentation, targetScreen, routeParameterBindings, destination, order, group, hierarchy } = content.properties;
     if (typeof label !== 'string' || typeof targetScreen !== 'string') {
         return undefined;
     }
     return {
+        id: typeof id === 'string' ? id : undefined,
         label,
+        icon: typeof icon === 'string' ? icon : undefined,
+        presentation: typeof presentation === 'string' ? presentation : undefined,
         targetScreen,
         routeParameterBindings: isBindingExpressionRecord(routeParameterBindings) ? routeParameterBindings : {},
         order: typeof order === 'number' ? order : contribution.order,
-        group: typeof group === 'string' ? group : undefined
+        destination: isDestination(destination) ? destination : undefined,
+        group: typeof group === 'string' ? group : undefined,
+        hierarchy: Array.isArray(hierarchy) ? hierarchy.filter((part)=>typeof part === 'string') : undefined
     };
 }
+function isDestination(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 function isBindingExpressionRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/esm/NavBar/extractNavigationItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractNavigationItem.js","sources":["../../../NavBar/extractNavigationItem.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 { BindingExpression, Contribution, ExternalComponent, NavigationItem } from '@cratis/scene.model';\n\n/**\n * Reads a {@link NavigationItem} out of a {@link Contribution} to the built-in `Navigation` contribution\n * point. `Contribution.content` carries an {@link ExternalComponent} whose open `properties` bag holds the\n * navigation-specific values (`label`, `targetScreen`, `routeParameterBindings`, `order`, `group`) - the\n * same names as {@link NavigationItem}'s own fields. This property-bag contract is Scene#2's own choice,\n * made without a real Screenplay-to-Scene translation to confirm it against (Stage#37 hasn't been built\n * yet) - whoever builds that seam should either produce contributions matching this contract or this\n * function should move to match whatever Stage#37 actually emits.\n *\n * @param contribution The contribution to read.\n * @returns The extracted {@link NavigationItem}, or `undefined` when `contribution.content` isn't an {@link ExternalComponent} or is missing a required property.\n */\nexport function extractNavigationItem(contribution: Contribution): NavigationItem | undefined {\n    const content = contribution.content as Partial<ExternalComponent>;\n    if (!content.properties) {\n        return undefined;\n    }\n\n    const { label, targetScreen, routeParameterBindings, order, group } = content.properties as Record<string, unknown>;\n    if (typeof label !== 'string' || typeof targetScreen !== 'string') {\n        return undefined;\n    }\n\n    return {\n        label,\n        targetScreen,\n        routeParameterBindings: isBindingExpressionRecord(routeParameterBindings) ? routeParameterBindings : {},\n        order: typeof order === 'number' ? order : contribution.order,\n        group: typeof group === 'string' ? group : undefined,\n    };\n}\n\nfunction isBindingExpressionRecord(value: unknown): value is Record<string, BindingExpression> {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":["extractNavigationItem","contribution","content","properties","undefined","label","targetScreen","routeParameterBindings","order","group","isBindingExpressionRecord","value","Array","isArray"],"mappings":"AAAA;AACA;AAIA;;;;;;;;;;;IAYO,SAASA,qBAAAA,CAAsBC,YAA0B,EAAA;IAC5D,MAAMC,OAAAA,GAAUD,aAAaC,OAAO;IACpC,IAAI,CAACA,OAAAA,CAAQC,UAAU,EAAE;QACrB,OAAOC,SAAAA;AACX,IAAA;AAEA,IAAA,MAAM,EAAEC,KAAK,EAAEC,YAAY,EAAEC,sBAAsB,EAAEC,KAAK,EAAEC,KAAK,EAAE,GAAGP,QAAQC,UAAU;AACxF,IAAA,IAAI,OAAOE,KAAAA,KAAU,QAAA,IAAY,OAAOC,iBAAiB,QAAA,EAAU;QAC/D,OAAOF,SAAAA;AACX,IAAA;IAEA,OAAO;AACHC,QAAAA,KAAAA;AACAC,QAAAA,YAAAA;QACAC,sBAAAA,EAAwBG,yBAAAA,CAA0BH,sBAAAA,CAAAA,GAA0BA,sBAAAA,GAAyB,EAAC;AACtGC,QAAAA,KAAAA,EAAO,OAAOA,KAAAA,KAAU,QAAA,GAAWA,KAAAA,GAAQP,aAAaO,KAAK;QAC7DC,KAAAA,EAAO,OAAOA,KAAAA,KAAU,QAAA,GAAWA,KAAAA,GAAQL;AAC/C,KAAA;AACJ;AAEA,SAASM,0BAA0BC,KAAc,EAAA;IAC7C,OAAO,OAAOA,UAAU,QAAA,IAAYA,KAAAA,KAAU,QAAQ,CAACC,KAAAA,CAAMC,OAAO,CAACF,KAAAA,CAAAA;AACzE;;"}
+{"version":3,"file":"extractNavigationItem.js","sources":["../../../NavBar/extractNavigationItem.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 { BindingExpression, Contribution, DestinationReference, ExternalComponent, NavigationItem } from '@cratis/scene.model';\n\n/**\n * Reads a {@link NavigationItem} out of a {@link Contribution} to the built-in `Navigation` contribution\n * point. `Contribution.content` carries an {@link ExternalComponent} whose open `properties` bag holds the\n * navigation-specific values (`label`, `targetScreen`, `routeParameterBindings`, `order`, `group`, and the\n * optional `id`, `icon`, `presentation`, `destination` and `hierarchy`) - the\n * same names as {@link NavigationItem}'s own fields. This property-bag contract is Scene#2's own choice,\n * made without a real Screenplay-to-Scene translation to confirm it against (Stage#37 hasn't been built\n * yet) - whoever builds that seam should either produce contributions matching this contract or this\n * function should move to match whatever Stage#37 actually emits.\n *\n * @param contribution The contribution to read.\n * @returns The extracted {@link NavigationItem}, or `undefined` when `contribution.content` isn't an {@link ExternalComponent} or is missing a required property.\n */\nexport function extractNavigationItem(contribution: Contribution): NavigationItem | undefined {\n    const content = contribution.content as Partial<ExternalComponent>;\n    if (!content.properties) {\n        return undefined;\n    }\n\n    const { id, label, icon, presentation, targetScreen, routeParameterBindings, destination, order, group, hierarchy } = content.properties as Record<string, unknown>;\n    if (typeof label !== 'string' || typeof targetScreen !== 'string') {\n        return undefined;\n    }\n\n    return {\n        id: typeof id === 'string' ? id : undefined,\n        label,\n        icon: typeof icon === 'string' ? icon : undefined,\n        presentation: typeof presentation === 'string' ? presentation : undefined,\n        targetScreen,\n        routeParameterBindings: isBindingExpressionRecord(routeParameterBindings) ? routeParameterBindings : {},\n        order: typeof order === 'number' ? order : contribution.order,\n        destination: isDestination(destination) ? destination : undefined,\n        group: typeof group === 'string' ? group : undefined,\n        hierarchy: Array.isArray(hierarchy) ? hierarchy.filter((part): part is string => typeof part === 'string') : undefined,\n    };\n}\n\nfunction isDestination(value: unknown): value is DestinationReference {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isBindingExpressionRecord(value: unknown): value is Record<string, BindingExpression> {\n    return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":["extractNavigationItem","contribution","content","properties","undefined","id","label","icon","presentation","targetScreen","routeParameterBindings","destination","order","group","hierarchy","isBindingExpressionRecord","isDestination","Array","isArray","filter","part","value"],"mappings":"AAAA;AACA;AAIA;;;;;;;;;;;;IAaO,SAASA,qBAAAA,CAAsBC,YAA0B,EAAA;IAC5D,MAAMC,OAAAA,GAAUD,aAAaC,OAAO;IACpC,IAAI,CAACA,OAAAA,CAAQC,UAAU,EAAE;QACrB,OAAOC,SAAAA;AACX,IAAA;IAEA,MAAM,EAAEC,EAAE,EAAEC,KAAK,EAAEC,IAAI,EAAEC,YAAY,EAAEC,YAAY,EAAEC,sBAAsB,EAAEC,WAAW,EAAEC,KAAK,EAAEC,KAAK,EAAEC,SAAS,EAAE,GAAGZ,OAAAA,CAAQC,UAAU;AACxI,IAAA,IAAI,OAAOG,KAAAA,KAAU,QAAA,IAAY,OAAOG,iBAAiB,QAAA,EAAU;QAC/D,OAAOL,SAAAA;AACX,IAAA;IAEA,OAAO;QACHC,EAAAA,EAAI,OAAOA,EAAAA,KAAO,QAAA,GAAWA,EAAAA,GAAKD,SAAAA;AAClCE,QAAAA,KAAAA;QACAC,IAAAA,EAAM,OAAOA,IAAAA,KAAS,QAAA,GAAWA,IAAAA,GAAOH,SAAAA;QACxCI,YAAAA,EAAc,OAAOA,YAAAA,KAAiB,QAAA,GAAWA,YAAAA,GAAeJ,SAAAA;AAChEK,QAAAA,YAAAA;QACAC,sBAAAA,EAAwBK,yBAAAA,CAA0BL,sBAAAA,CAAAA,GAA0BA,sBAAAA,GAAyB,EAAC;AACtGE,QAAAA,KAAAA,EAAO,OAAOA,KAAAA,KAAU,QAAA,GAAWA,KAAAA,GAAQX,aAAaW,KAAK;QAC7DD,WAAAA,EAAaK,aAAAA,CAAcL,eAAeA,WAAAA,GAAcP,SAAAA;QACxDS,KAAAA,EAAO,OAAOA,KAAAA,KAAU,QAAA,GAAWA,KAAAA,GAAQT,SAAAA;QAC3CU,SAAAA,EAAWG,KAAAA,CAAMC,OAAO,CAACJ,SAAAA,CAAAA,GAAaA,SAAAA,CAAUK,MAAM,CAAC,CAACC,IAAAA,GAAyB,OAAOA,IAAAA,KAAS,QAAA,CAAA,GAAYhB;AACjH,KAAA;AACJ;AAEA,SAASY,cAAcK,KAAc,EAAA;IACjC,OAAO,OAAOA,UAAU,QAAA,IAAYA,KAAAA,KAAU,QAAQ,CAACJ,KAAAA,CAAMC,OAAO,CAACG,KAAAA,CAAAA;AACzE;AAEA,SAASN,0BAA0BM,KAAc,EAAA;IAC7C,OAAO,OAAOA,UAAU,QAAA,IAAYA,KAAAA,KAAU,QAAQ,CAACJ,KAAAA,CAAMC,OAAO,CAACG,KAAAA,CAAAA;AACzE;;"}

package/dist/esm/core/CoreToolbar.d.ts

@@ -0,0 +1,8 @@
+import { DestinationReference } from '@cratis/scene.model';
+import { RegisteredComponentProps } from '../renderer';
+export type ToolbarItemMode = 'icon' | 'text' | 'both';
+export declare function toolbarItemMode(presentation: Record<string, unknown>): ToolbarItemMode;
+export declare function toolbarItemDestination(properties: Record<string, unknown>): DestinationReference | undefined;
+export declare function CoreToolbar({ element, slots }: RegisteredComponentProps): import("react").JSX.Element;
+export declare function CoreToolbarItem({ element }: RegisteredComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=CoreToolbar.d.ts.map

package/dist/esm/core/CoreToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreToolbar.d.ts","sourceRoot":"","sources":["../../../core/CoreToolbar.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAyD,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,wBAAwB,EAAyB,MAAM,aAAa,CAAC;AAI9E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AA+CvD,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAGtF;AAQD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,GAAG,SAAS,CAW5G;AAMD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,wBAAwB,+BAGvE;AAcD,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,wBAAwB,+BAkDpE"}

package/dist/esm/core/CoreToolbar.js

@@ -0,0 +1,178 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { useContext } from 'react';
+import { resolveBindingExpression } from '@cratis/scene.engine';
+import { DestinationKind, BindingSourceKind } from '@cratis/scene.model';
+import { useRenderBindingScope } from '../renderer/RenderBindingScopeContext.js';
+import '../interactions/useInteractions.js';
+import '../interactions/NotificationHost.js';
+import { SceneNavigationContextInternal } from '../navigation/SceneNavigationContext.js';
+
+function textProperty(properties, name) {
+    return typeof properties[name] === 'string' ? properties[name] : undefined;
+}
+function recordProperty(properties, name) {
+    const value = properties[name];
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function isDestination(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;
+    return [
+        'screen',
+        'module',
+        'route',
+        'dialog',
+        'outlet'
+    ].some((key)=>typeof value[key] === 'string');
+}
+function isBinding(value) {
+    return value !== null && typeof value === 'object' && typeof value.path === 'string';
+}
+function literal(value) {
+    return {
+        kind: BindingSourceKind.Literal,
+        path: '',
+        value
+    };
+}
+function resolveParameters(parameters, scope) {
+    return Object.fromEntries(Object.entries(parameters).map(([name, binding])=>[
+            name,
+            isBinding(binding) ? resolveBindingExpression(binding, scope) : binding
+        ]));
+}
+/**
+ * An authored destination with its route parameters read now, against the scope the item renders in.
+ *
+ * A navigation host resolves a destination against its own scope, which cannot see what the screen's components
+ * publish - a table's selected row, an input's value - so the item resolves them where it is, and hands the host
+ * literals. (The renderer leaves a destination's bindings alone, unlike the rest of an element's properties.)
+ */ function withResolvedParameters(destination, scope) {
+    const bindings = destination.routeParameterBindings;
+    if (!bindings) return destination;
+    return {
+        ...destination,
+        routeParameterBindings: Object.fromEntries(Object.entries(bindings).map(([name, binding])=>[
+                name,
+                literal(resolveBindingExpression(binding, scope))
+            ]))
+    };
+}
+/** The mode the item's authored presentation asks for; anything it does not name shows both. */ function toolbarItemMode(presentation) {
+    const mode = presentation.mode;
+    return mode === 'icon' || mode === 'text' ? mode : 'both';
+}
+/**
+ * Where activating a toolbar item goes.
+ *
+ * The destination the document authored wins. Without one, a `Navigate` item opens its target screen - its
+ * parameters become route parameter bindings - and a `Dialog` item opens its target dialog template.
+ */ function toolbarItemDestination(properties) {
+    if (isDestination(properties.destination)) return properties.destination;
+    const kind = textProperty(properties, 'kind')?.toLowerCase();
+    const target = textProperty(properties, 'target');
+    if (!target) return undefined;
+    // The renderer has already read each parameter's binding by the time the item sees it, so a parameter is a value.
+    const routeParameterBindings = Object.fromEntries(Object.entries(recordProperty(properties, 'parameters')).map(([name, value])=>[
+            name,
+            literal(value)
+        ]));
+    if (kind === 'navigate') return {
+        screen: target,
+        routeParameterBindings
+    };
+    if (kind === 'dialog') return {
+        kind: DestinationKind.Dialog,
+        dialog: target,
+        routeParameterBindings
+    };
+    return undefined;
+}
+/**
+ * The `core:toolbar` component: the items a screen's toolbar groups, in the order they were authored.
+ * The items are `core:toolbarItem` elements in its `items` slot.
+ */ function CoreToolbar({ element, slots }) {
+    const name = textProperty(element.properties, 'name');
+    return /*#__PURE__*/ jsx("div", {
+        "data-scene-id": element.id,
+        "data-scene-toolbar": name,
+        role: "toolbar",
+        "aria-label": name,
+        children: slots.items
+    });
+}
+/**
+ * The `core:toolbarItem` component: one toolbar entry with a label, an icon, presentation hints and what it does.
+ *
+ * - An `Action` item announces the command it targets with the host-neutral `cratis.scene.command` event, carrying its
+ *   parameters resolved against the binding scope.
+ * - A `Navigate` or `Dialog` item executes its destination through the enclosing navigation host - a screen in an
+ *   outlet, a dialog - and, outside one, announces it with the host-neutral `cratis.scene.navigate` event.
+ *
+ * Presentation: `mode` is `icon`, `text` or `both` (the default); an icon-only item keeps its label as its accessible name.
+ * Every presentation hint - `placement`, `density` or whatever a package reads - is also carried on the node as a
+ * `data-scene-presentation-<name>` attribute so a theme can style by it.
+ */ function CoreToolbarItem({ element }) {
+    const navigation = useContext(SceneNavigationContextInternal);
+    const scope = useRenderBindingScope();
+    const name = textProperty(element.properties, 'name') ?? element.id;
+    const kind = textProperty(element.properties, 'kind')?.toLowerCase();
+    const target = textProperty(element.properties, 'target') ?? '';
+    const label = textProperty(element.properties, 'label') ?? name;
+    const icon = textProperty(element.properties, 'icon');
+    const presentation = recordProperty(element.properties, 'presentation');
+    const mode = toolbarItemMode(presentation);
+    const destination = toolbarItemDestination(element.properties);
+    const attributes = Object.fromEntries(Object.entries(presentation).filter(([key])=>/^[A-Za-z][A-Za-z0-9-]*$/.test(key)).map(([key, value])=>[
+            `data-scene-presentation-${key.toLowerCase()}`,
+            String(value)
+        ]));
+    const activate = ()=>{
+        if (kind === 'action') {
+            const args = resolveParameters(recordProperty(element.properties, 'parameters'), scope);
+            globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', {
+                detail: {
+                    command: target,
+                    element,
+                    arguments: args
+                }
+            }));
+            return;
+        }
+        if (!destination) return;
+        const resolved = withResolvedParameters(destination, scope);
+        if (navigation) {
+            navigation.navigate(resolved);
+        } else {
+            globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', {
+                detail: {
+                    targetScreen: destination.screen ?? '',
+                    dialog: destination.dialog,
+                    destination: resolved,
+                    element
+                }
+            }));
+        }
+    };
+    return /*#__PURE__*/ jsxs("button", {
+        type: "button",
+        "data-scene-id": element.id,
+        "data-scene-toolbar-item": name,
+        "data-scene-icon": icon,
+        "data-scene-mode": mode,
+        "aria-label": mode === 'icon' ? label : undefined,
+        title: mode === 'icon' ? label : undefined,
+        disabled: kind !== 'action' && !destination,
+        onClick: activate,
+        ...attributes,
+        children: [
+            mode !== 'text' && icon && /*#__PURE__*/ jsx("span", {
+                "aria-hidden": "true",
+                "data-scene-icon-name": icon
+            }),
+            mode !== 'icon' && label
+        ]
+    });
+}
+
+export { CoreToolbar, CoreToolbarItem, toolbarItemDestination, toolbarItemMode };
+//# sourceMappingURL=CoreToolbar.js.map

package/dist/esm/core/CoreToolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreToolbar.js","sources":["../../../core/CoreToolbar.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useContext } from 'react';\nimport { BindingScope, resolveBindingExpression } from '@cratis/scene.engine';\nimport { BindingExpression, BindingSourceKind, DestinationKind, DestinationReference } from '@cratis/scene.model';\nimport { RegisteredComponentProps, useRenderBindingScope } from '../renderer';\nimport { SceneNavigationContextInternal } from '../navigation/SceneNavigationContext';\n\n/** How a toolbar item shows its icon and label - the `mode` an item's presentation hint can name. */\nexport type ToolbarItemMode = 'icon' | 'text' | 'both';\n\nfunction textProperty(properties: Record<string, unknown>, name: string): string | undefined {\n    return typeof properties[name] === 'string' ? properties[name] : undefined;\n}\n\nfunction recordProperty(properties: Record<string, unknown>, name: string): Record<string, unknown> {\n    const value = properties[name];\n    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {};\n}\n\nfunction isDestination(value: unknown): value is DestinationReference {\n    if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;\n    return ['screen', 'module', 'route', 'dialog', 'outlet'].some(key => typeof (value as Record<string, unknown>)[key] === 'string');\n}\n\nfunction isBinding(value: unknown): value is BindingExpression {\n    return value !== null && typeof value === 'object' && typeof (value as BindingExpression).path === 'string';\n}\n\nfunction literal(value: unknown): BindingExpression {\n    return { kind: BindingSourceKind.Literal, path: '', value } as BindingExpression;\n}\n\nfunction resolveParameters(parameters: Record<string, unknown>, scope: BindingScope): Record<string, unknown> {\n    return Object.fromEntries(Object.entries(parameters).map(([name, binding]) =>\n        [name, isBinding(binding) ? resolveBindingExpression(binding, scope) : binding]));\n}\n\n/**\n * An authored destination with its route parameters read now, against the scope the item renders in.\n *\n * A navigation host resolves a destination against its own scope, which cannot see what the screen's components\n * publish - a table's selected row, an input's value - so the item resolves them where it is, and hands the host\n * literals. (The renderer leaves a destination's bindings alone, unlike the rest of an element's properties.)\n */\nfunction withResolvedParameters(destination: DestinationReference, scope: BindingScope): DestinationReference {\n    const bindings = destination.routeParameterBindings;\n    if (!bindings) return destination;\n    return {\n        ...destination,\n        routeParameterBindings: Object.fromEntries(Object.entries(bindings).map(([name, binding]) =>\n            [name, literal(resolveBindingExpression(binding, scope))])),\n    };\n}\n\n/** The mode the item's authored presentation asks for; anything it does not name shows both. */\nexport function toolbarItemMode(presentation: Record<string, unknown>): ToolbarItemMode {\n    const mode = presentation.mode;\n    return mode === 'icon' || mode === 'text' ? mode : 'both';\n}\n\n/**\n * Where activating a toolbar item goes.\n *\n * The destination the document authored wins. Without one, a `Navigate` item opens its target screen - its\n * parameters become route parameter bindings - and a `Dialog` item opens its target dialog template.\n */\nexport function toolbarItemDestination(properties: Record<string, unknown>): DestinationReference | undefined {\n    if (isDestination(properties.destination)) return properties.destination;\n    const kind = textProperty(properties, 'kind')?.toLowerCase();\n    const target = textProperty(properties, 'target');\n    if (!target) return undefined;\n    // The renderer has already read each parameter's binding by the time the item sees it, so a parameter is a value.\n    const routeParameterBindings = Object.fromEntries(Object.entries(recordProperty(properties, 'parameters'))\n        .map(([name, value]) => [name, literal(value)])) as Record<string, BindingExpression>;\n    if (kind === 'navigate') return { screen: target, routeParameterBindings };\n    if (kind === 'dialog') return { kind: DestinationKind.Dialog, dialog: target, routeParameterBindings };\n    return undefined;\n}\n\n/**\n * The `core:toolbar` component: the items a screen's toolbar groups, in the order they were authored.\n * The items are `core:toolbarItem` elements in its `items` slot.\n */\nexport function CoreToolbar({ element, slots }: RegisteredComponentProps) {\n    const name = textProperty(element.properties, 'name');\n    return <div data-scene-id={element.id} data-scene-toolbar={name} role='toolbar' aria-label={name}>{slots.items}</div>;\n}\n\n/**\n * The `core:toolbarItem` component: one toolbar entry with a label, an icon, presentation hints and what it does.\n *\n * - An `Action` item announces the command it targets with the host-neutral `cratis.scene.command` event, carrying its\n *   parameters resolved against the binding scope.\n * - A `Navigate` or `Dialog` item executes its destination through the enclosing navigation host - a screen in an\n *   outlet, a dialog - and, outside one, announces it with the host-neutral `cratis.scene.navigate` event.\n *\n * Presentation: `mode` is `icon`, `text` or `both` (the default); an icon-only item keeps its label as its accessible name.\n * Every presentation hint - `placement`, `density` or whatever a package reads - is also carried on the node as a\n * `data-scene-presentation-<name>` attribute so a theme can style by it.\n */\nexport function CoreToolbarItem({ element }: RegisteredComponentProps) {\n    const navigation = useContext(SceneNavigationContextInternal);\n    const scope = useRenderBindingScope();\n    const name = textProperty(element.properties, 'name') ?? element.id;\n    const kind = textProperty(element.properties, 'kind')?.toLowerCase();\n    const target = textProperty(element.properties, 'target') ?? '';\n    const label = textProperty(element.properties, 'label') ?? name;\n    const icon = textProperty(element.properties, 'icon');\n    const presentation = recordProperty(element.properties, 'presentation');\n    const mode = toolbarItemMode(presentation);\n    const destination = toolbarItemDestination(element.properties);\n    const attributes = Object.fromEntries(Object.entries(presentation)\n        .filter(([key]) => /^[A-Za-z][A-Za-z0-9-]*$/.test(key))\n        .map(([key, value]) => [`data-scene-presentation-${key.toLowerCase()}`, String(value)]));\n\n    const activate = () => {\n        if (kind === 'action') {\n            const args = resolveParameters(recordProperty(element.properties, 'parameters'), scope);\n            globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', { detail: { command: target, element, arguments: args } }));\n            return;\n        }\n\n        if (!destination) return;\n        const resolved = withResolvedParameters(destination, scope);\n        if (navigation) {\n            navigation.navigate(resolved);\n        } else {\n            globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', {\n                detail: { targetScreen: destination.screen ?? '', dialog: destination.dialog, destination: resolved, element },\n            }));\n        }\n    };\n\n    return (\n        <button\n            type='button'\n            data-scene-id={element.id}\n            data-scene-toolbar-item={name}\n            data-scene-icon={icon}\n            data-scene-mode={mode}\n            aria-label={mode === 'icon' ? label : undefined}\n            title={mode === 'icon' ? label : undefined}\n            disabled={kind !== 'action' && !destination}\n            onClick={activate}\n            {...attributes}\n        >\n            {mode !== 'text' && icon && <span aria-hidden='true' data-scene-icon-name={icon} />}\n            {mode !== 'icon' && label}\n        </button>\n    );\n}\n"],"names":["textProperty","properties","name","undefined","recordProperty","value","Array","isArray","isDestination","some","key","isBinding","path","literal","kind","BindingSourceKind","Literal","resolveParameters","parameters","scope","Object","fromEntries","entries","map","binding","resolveBindingExpression","withResolvedParameters","destination","bindings","routeParameterBindings","toolbarItemMode","presentation","mode","toolbarItemDestination","toLowerCase","target","screen","DestinationKind","Dialog","dialog","CoreToolbar","element","slots","_jsx","div","data-scene-id","id","data-scene-toolbar","role","aria-label","items","CoreToolbarItem","navigation","useContext","SceneNavigationContextInternal","useRenderBindingScope","label","icon","attributes","filter","test","String","activate","args","globalThis","dispatchEvent","CustomEvent","detail","command","arguments","resolved","navigate","targetScreen","_jsxs","button","type","data-scene-toolbar-item","data-scene-icon","data-scene-mode","title","disabled","onClick","span","aria-hidden","data-scene-icon-name"],"mappings":"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"}

package/dist/esm/core/coreComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coreComponents.d.ts","sourceRoot":"","sources":["../../../core/coreComponents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAyBhD,eAAO,MAAM,cAAc,EAAE,iBAiB5B,CAAC"}
+{"version":3,"file":"coreComponents.d.ts","sourceRoot":"","sources":["../../../core/coreComponents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA0BhD,eAAO,MAAM,cAAc,EAAE,iBAmB5B,CAAC"}

package/dist/esm/core/coreComponents.js

@@ -11,6 +11,7 @@ import { CoreText } from './CoreText.js';
 import { CoreButton } from './CoreButton.js';
 import { CoreCard } from './CoreCard.js';
 import { CoreNavigationBar } from './CoreNavigationBar.js';
+import { CoreToolbarItem, CoreToolbar } from './CoreToolbar.js';
 import { CoreFile, CoreCode, CoreField, CoreSummary, CoreColumn, CoreTable, CoreTitle, CoreNavigate, CoreSection, CoreAction, CoreData } from './ScreenplayCoreComponents.js';
 
 // Copyright (c) Cratis. All rights reserved.
@@ -34,7 +35,9 @@ import { CoreFile, CoreCode, CoreField, CoreSummary, CoreColumn, CoreTable, Core
     [componentRegistryKey('core', 'code')]: CoreCode,
     [componentRegistryKey('core', 'file')]: CoreFile,
     [componentRegistryKey('core', 'navigationBar')]: CoreNavigationBar,
-    [componentRegistryKey('core', 'outlet')]: CoreOutlet
+    [componentRegistryKey('core', 'outlet')]: CoreOutlet,
+    [componentRegistryKey('core', 'toolbar')]: CoreToolbar,
+    [componentRegistryKey('core', 'toolbarItem')]: CoreToolbarItem
 };
 
 export { coreComponents };

package/dist/esm/core/coreComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreComponents.js","sources":["../../../core/coreComponents.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 { ComponentRegistry } from '../renderer';\nimport { componentRegistryKey } from '../packages';\nimport { CoreText } from './CoreText';\nimport { CoreButton } from './CoreButton';\nimport { CoreCard } from './CoreCard';\nimport { CoreNavigationBar } from './CoreNavigationBar';\nimport { CoreOutlet } from '../navigation/CoreOutlet';\nimport {\n    CoreAction,\n    CoreCode,\n    CoreColumn,\n    CoreData,\n    CoreField,\n    CoreFile,\n    CoreNavigate,\n    CoreSection,\n    CoreSummary,\n    CoreTable,\n    CoreTitle,\n} from './ScreenplayCoreComponents';\n\n/**\n * The `core` package's component registry - the final fallback every `ui profile` resolves against\n * regardless of which other packages it lists (Scene#3).\n */\nexport const coreComponents: ComponentRegistry = {\n    [componentRegistryKey('core', 'text')]: CoreText,\n    [componentRegistryKey('core', 'button')]: CoreButton,\n    [componentRegistryKey('core', 'card')]: CoreCard,\n    [componentRegistryKey('core', 'data')]: CoreData,\n    [componentRegistryKey('core', 'action')]: CoreAction,\n    [componentRegistryKey('core', 'section')]: CoreSection,\n    [componentRegistryKey('core', 'navigate')]: CoreNavigate,\n    [componentRegistryKey('core', 'title')]: CoreTitle,\n    [componentRegistryKey('core', 'table')]: CoreTable,\n    [componentRegistryKey('core', 'column')]: CoreColumn,\n    [componentRegistryKey('core', 'summary')]: CoreSummary,\n    [componentRegistryKey('core', 'field')]: CoreField,\n    [componentRegistryKey('core', 'code')]: CoreCode,\n    [componentRegistryKey('core', 'file')]: CoreFile,\n    [componentRegistryKey('core', 'navigationBar')]: CoreNavigationBar,\n    [componentRegistryKey('core', 'outlet')]: CoreOutlet,\n};\n"],"names":["coreComponents","componentRegistryKey","CoreText","CoreButton","CoreCard","CoreData","CoreAction","CoreSection","CoreNavigate","CoreTitle","CoreTable","CoreColumn","CoreSummary","CoreField","CoreCode","CoreFile","CoreNavigationBar","CoreOutlet"],"mappings":";;;;;;;;;;;;;;;AAAA;AACA;AAuBA;;;UAIaA,cAAAA,GAAoC;IAC7C,CAACC,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUC,QAAAA;IACxC,CAACD,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYE,UAAAA;IAC1C,CAACF,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUG,QAAAA;IACxC,CAACH,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUI,QAAAA;IACxC,CAACJ,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYK,UAAAA;IAC1C,CAACL,oBAAAA,CAAqB,MAAA,EAAQ,SAAA,CAAA,GAAaM,WAAAA;IAC3C,CAACN,oBAAAA,CAAqB,MAAA,EAAQ,UAAA,CAAA,GAAcO,YAAAA;IAC5C,CAACP,oBAAAA,CAAqB,MAAA,EAAQ,OAAA,CAAA,GAAWQ,SAAAA;IACzC,CAACR,oBAAAA,CAAqB,MAAA,EAAQ,OAAA,CAAA,GAAWS,SAAAA;IACzC,CAACT,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYU,UAAAA;IAC1C,CAACV,oBAAAA,CAAqB,MAAA,EAAQ,SAAA,CAAA,GAAaW,WAAAA;IAC3C,CAACX,oBAAAA,CAAqB,MAAA,EAAQ,OAAA,CAAA,GAAWY,SAAAA;IACzC,CAACZ,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUa,QAAAA;IACxC,CAACb,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUc,QAAAA;IACxC,CAACd,oBAAAA,CAAqB,MAAA,EAAQ,eAAA,CAAA,GAAmBe,iBAAAA;IACjD,CAACf,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYgB;AAC9C;;"}
+{"version":3,"file":"coreComponents.js","sources":["../../../core/coreComponents.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 { ComponentRegistry } from '../renderer';\nimport { componentRegistryKey } from '../packages';\nimport { CoreText } from './CoreText';\nimport { CoreButton } from './CoreButton';\nimport { CoreCard } from './CoreCard';\nimport { CoreNavigationBar } from './CoreNavigationBar';\nimport { CoreToolbar, CoreToolbarItem } from './CoreToolbar';\nimport { CoreOutlet } from '../navigation/CoreOutlet';\nimport {\n    CoreAction,\n    CoreCode,\n    CoreColumn,\n    CoreData,\n    CoreField,\n    CoreFile,\n    CoreNavigate,\n    CoreSection,\n    CoreSummary,\n    CoreTable,\n    CoreTitle,\n} from './ScreenplayCoreComponents';\n\n/**\n * The `core` package's component registry - the final fallback every `ui profile` resolves against\n * regardless of which other packages it lists (Scene#3).\n */\nexport const coreComponents: ComponentRegistry = {\n    [componentRegistryKey('core', 'text')]: CoreText,\n    [componentRegistryKey('core', 'button')]: CoreButton,\n    [componentRegistryKey('core', 'card')]: CoreCard,\n    [componentRegistryKey('core', 'data')]: CoreData,\n    [componentRegistryKey('core', 'action')]: CoreAction,\n    [componentRegistryKey('core', 'section')]: CoreSection,\n    [componentRegistryKey('core', 'navigate')]: CoreNavigate,\n    [componentRegistryKey('core', 'title')]: CoreTitle,\n    [componentRegistryKey('core', 'table')]: CoreTable,\n    [componentRegistryKey('core', 'column')]: CoreColumn,\n    [componentRegistryKey('core', 'summary')]: CoreSummary,\n    [componentRegistryKey('core', 'field')]: CoreField,\n    [componentRegistryKey('core', 'code')]: CoreCode,\n    [componentRegistryKey('core', 'file')]: CoreFile,\n    [componentRegistryKey('core', 'navigationBar')]: CoreNavigationBar,\n    [componentRegistryKey('core', 'outlet')]: CoreOutlet,\n    [componentRegistryKey('core', 'toolbar')]: CoreToolbar,\n    [componentRegistryKey('core', 'toolbarItem')]: CoreToolbarItem,\n};\n"],"names":["coreComponents","componentRegistryKey","CoreText","CoreButton","CoreCard","CoreData","CoreAction","CoreSection","CoreNavigate","CoreTitle","CoreTable","CoreColumn","CoreSummary","CoreField","CoreCode","CoreFile","CoreNavigationBar","CoreOutlet","CoreToolbar","CoreToolbarItem"],"mappings":";;;;;;;;;;;;;;;;AAAA;AACA;AAwBA;;;UAIaA,cAAAA,GAAoC;IAC7C,CAACC,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUC,QAAAA;IACxC,CAACD,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYE,UAAAA;IAC1C,CAACF,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUG,QAAAA;IACxC,CAACH,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUI,QAAAA;IACxC,CAACJ,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYK,UAAAA;IAC1C,CAACL,oBAAAA,CAAqB,MAAA,EAAQ,SAAA,CAAA,GAAaM,WAAAA;IAC3C,CAACN,oBAAAA,CAAqB,MAAA,EAAQ,UAAA,CAAA,GAAcO,YAAAA;IAC5C,CAACP,oBAAAA,CAAqB,MAAA,EAAQ,OAAA,CAAA,GAAWQ,SAAAA;IACzC,CAACR,oBAAAA,CAAqB,MAAA,EAAQ,OAAA,CAAA,GAAWS,SAAAA;IACzC,CAACT,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYU,UAAAA;IAC1C,CAACV,oBAAAA,CAAqB,MAAA,EAAQ,SAAA,CAAA,GAAaW,WAAAA;IAC3C,CAACX,oBAAAA,CAAqB,MAAA,EAAQ,OAAA,CAAA,GAAWY,SAAAA;IACzC,CAACZ,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUa,QAAAA;IACxC,CAACb,oBAAAA,CAAqB,MAAA,EAAQ,MAAA,CAAA,GAAUc,QAAAA;IACxC,CAACd,oBAAAA,CAAqB,MAAA,EAAQ,eAAA,CAAA,GAAmBe,iBAAAA;IACjD,CAACf,oBAAAA,CAAqB,MAAA,EAAQ,QAAA,CAAA,GAAYgB,UAAAA;IAC1C,CAAChB,oBAAAA,CAAqB,MAAA,EAAQ,SAAA,CAAA,GAAaiB,WAAAA;IAC3C,CAACjB,oBAAAA,CAAqB,MAAA,EAAQ,aAAA,CAAA,GAAiBkB;AACnD;;"}

package/dist/esm/core/corePackage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corePackage.d.ts","sourceRoot":"","sources":["../../../core/corePackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAWjD,eAAO,MAAM,mBAAmB,EAAE,YAgCjC,CAAC;AAKF,eAAO,MAAM,WAAW,EAAE,kBAIzB,CAAC"}
+{"version":3,"file":"corePackage.d.ts","sourceRoot":"","sources":["../../../core/corePackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAWjD,eAAO,MAAM,mBAAmB,EAAE,YAkCjC,CAAC;AAKF,eAAO,MAAM,WAAW,EAAE,kBAIzB,CAAC"}

package/dist/esm/core/corePackage.js

@@ -31,7 +31,9 @@ import { coreDescriptors } from './coreDescriptors.js';
         'code',
         'file',
         'navigationBar',
-        'outlet'
+        'outlet',
+        'toolbar',
+        'toolbarItem'
     ],
     layouts: [],
     screenTemplates: [],

package/dist/esm/core/corePackage.js.map

@@ -1 +1 @@
-{"version":3,"file":"corePackage.js","sources":["../../../core/corePackage.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 { PackageKind, ScenePackage } from '@cratis/scene.model';\nimport { ScenePackageBundle } from '../packages';\nimport { coreComponents } from './coreComponents';\nimport { coreDescriptors } from './coreDescriptors';\n\n/**\n * The `core` package's declaration. Every other package is loaded by a host that reads its manifest;\n * `core` ships inside the renderer itself, because Scene#3 guarantees a bare name always has somewhere to\n * resolve regardless of which packages a profile lists. It is still declared the same way as any other -\n * a package picker should be able to show it, and the dependency resolver should be able to reason about\n * it, without a special case.\n */\nexport const corePackageManifest: ScenePackage = {\n    name: 'core',\n    version: '1.0.0',\n    kind: PackageKind.ComponentLibrary,\n    dependencies: [],\n    components: [\n        'text',\n        'button',\n        'card',\n        'data',\n        'action',\n        'section',\n        'navigate',\n        'title',\n        'table',\n        'column',\n        'summary',\n        'field',\n        'code',\n        'file',\n        'navigationBar',\n        'outlet',\n    ],\n    layouts: [],\n    screenTemplates: [],\n    dialogTemplates: [],\n    themes: [],\n    displayName: 'Core',\n    description: 'The built-in fallback vocabulary every ui profile resolves against.',\n    module: '@cratis/scene.react',\n    license: 'MIT',\n    licenseUrl: 'https://github.com/Cratis/Scene/blob/main/LICENSE',\n};\n\n/**\n * The `core` package as a loadable bundle.\n */\nexport const corePackage: ScenePackageBundle = {\n    manifest: corePackageManifest,\n    components: coreComponents,\n    descriptors: coreDescriptors,\n};\n"],"names":["corePackageManifest","name","version","kind","PackageKind","ComponentLibrary","dependencies","components","layouts","screenTemplates","dialogTemplates","themes","displayName","description","module","license","licenseUrl","corePackage","manifest","coreComponents","descriptors","coreDescriptors"],"mappings":";;;;AAAA;AACA;AAOA;;;;;;UAOaA,mBAAAA,GAAoC;IAC7CC,IAAAA,EAAM,MAAA;IACNC,OAAAA,EAAS,OAAA;AACTC,IAAAA,IAAAA,EAAMC,YAAYC,gBAAgB;AAClCC,IAAAA,YAAAA,EAAc,EAAE;IAChBC,UAAAA,EAAY;AACR,QAAA,MAAA;AACA,QAAA,QAAA;AACA,QAAA,MAAA;AACA,QAAA,MAAA;AACA,QAAA,QAAA;AACA,QAAA,SAAA;AACA,QAAA,UAAA;AACA,QAAA,OAAA;AACA,QAAA,OAAA;AACA,QAAA,QAAA;AACA,QAAA,SAAA;AACA,QAAA,OAAA;AACA,QAAA,MAAA;AACA,QAAA,MAAA;AACA,QAAA,eAAA;AACA,QAAA;AACH,KAAA;AACDC,IAAAA,OAAAA,EAAS,EAAE;AACXC,IAAAA,eAAAA,EAAiB,EAAE;AACnBC,IAAAA,eAAAA,EAAiB,EAAE;AACnBC,IAAAA,MAAAA,EAAQ,EAAE;IACVC,WAAAA,EAAa,MAAA;IACbC,WAAAA,EAAa,qEAAA;IACbC,MAAAA,EAAQ,qBAAA;IACRC,OAAAA,EAAS,KAAA;IACTC,UAAAA,EAAY;AAChB;AAEA;;UAGaC,WAAAA,GAAkC;IAC3CC,QAAAA,EAAUlB,mBAAAA;IACVO,UAAAA,EAAYY,cAAAA;IACZC,WAAAA,EAAaC;AACjB;;"}
+{"version":3,"file":"corePackage.js","sources":["../../../core/corePackage.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 { PackageKind, ScenePackage } from '@cratis/scene.model';\nimport { ScenePackageBundle } from '../packages';\nimport { coreComponents } from './coreComponents';\nimport { coreDescriptors } from './coreDescriptors';\n\n/**\n * The `core` package's declaration. Every other package is loaded by a host that reads its manifest;\n * `core` ships inside the renderer itself, because Scene#3 guarantees a bare name always has somewhere to\n * resolve regardless of which packages a profile lists. It is still declared the same way as any other -\n * a package picker should be able to show it, and the dependency resolver should be able to reason about\n * it, without a special case.\n */\nexport const corePackageManifest: ScenePackage = {\n    name: 'core',\n    version: '1.0.0',\n    kind: PackageKind.ComponentLibrary,\n    dependencies: [],\n    components: [\n        'text',\n        'button',\n        'card',\n        'data',\n        'action',\n        'section',\n        'navigate',\n        'title',\n        'table',\n        'column',\n        'summary',\n        'field',\n        'code',\n        'file',\n        'navigationBar',\n        'outlet',\n        'toolbar',\n        'toolbarItem',\n    ],\n    layouts: [],\n    screenTemplates: [],\n    dialogTemplates: [],\n    themes: [],\n    displayName: 'Core',\n    description: 'The built-in fallback vocabulary every ui profile resolves against.',\n    module: '@cratis/scene.react',\n    license: 'MIT',\n    licenseUrl: 'https://github.com/Cratis/Scene/blob/main/LICENSE',\n};\n\n/**\n * The `core` package as a loadable bundle.\n */\nexport const corePackage: ScenePackageBundle = {\n    manifest: corePackageManifest,\n    components: coreComponents,\n    descriptors: coreDescriptors,\n};\n"],"names":["corePackageManifest","name","version","kind","PackageKind","ComponentLibrary","dependencies","components","layouts","screenTemplates","dialogTemplates","themes","displayName","description","module","license","licenseUrl","corePackage","manifest","coreComponents","descriptors","coreDescriptors"],"mappings":";;;;AAAA;AACA;AAOA;;;;;;UAOaA,mBAAAA,GAAoC;IAC7CC,IAAAA,EAAM,MAAA;IACNC,OAAAA,EAAS,OAAA;AACTC,IAAAA,IAAAA,EAAMC,YAAYC,gBAAgB;AAClCC,IAAAA,YAAAA,EAAc,EAAE;IAChBC,UAAAA,EAAY;AACR,QAAA,MAAA;AACA,QAAA,QAAA;AACA,QAAA,MAAA;AACA,QAAA,MAAA;AACA,QAAA,QAAA;AACA,QAAA,SAAA;AACA,QAAA,UAAA;AACA,QAAA,OAAA;AACA,QAAA,OAAA;AACA,QAAA,QAAA;AACA,QAAA,SAAA;AACA,QAAA,OAAA;AACA,QAAA,MAAA;AACA,QAAA,MAAA;AACA,QAAA,eAAA;AACA,QAAA,QAAA;AACA,QAAA,SAAA;AACA,QAAA;AACH,KAAA;AACDC,IAAAA,OAAAA,EAAS,EAAE;AACXC,IAAAA,eAAAA,EAAiB,EAAE;AACnBC,IAAAA,eAAAA,EAAiB,EAAE;AACnBC,IAAAA,MAAAA,EAAQ,EAAE;IACVC,WAAAA,EAAa,MAAA;IACbC,WAAAA,EAAa,qEAAA;IACbC,MAAAA,EAAQ,qBAAA;IACRC,OAAAA,EAAS,KAAA;IACTC,UAAAA,EAAY;AAChB;AAEA;;UAGaC,WAAAA,GAAkC;IAC3CC,QAAAA,EAAUlB,mBAAAA;IACVO,UAAAA,EAAYY,cAAAA;IACZC,WAAAA,EAAaC;AACjB;;"}

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

@@ -2,6 +2,7 @@ export * from './CoreText';
 export * from './CoreButton';
 export * from './CoreCard';
 export * from './CoreNavigationBar';
+export * from './CoreToolbar';
 export * from './coreDescriptors';
 export * from './ScreenplayCoreComponents';
 export * from './coreComponents';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/esm/core/index.js

@@ -2,6 +2,7 @@ export * from './CoreText';
 export * from './CoreButton';
 export * from './CoreCard';
 export * from './CoreNavigationBar';
+export * from './CoreToolbar';
 export * from './coreDescriptors';
 export * from './ScreenplayCoreComponents';
 export * from './coreComponents';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/esm/index.js

@@ -12,6 +12,7 @@ export { CoreText } from './core/CoreText.js';
 export { CoreButton } from './core/CoreButton.js';
 export { CoreCard } from './core/CoreCard.js';
 export { CoreNavigationBar } from './core/CoreNavigationBar.js';
+export { CoreToolbar, CoreToolbarItem, toolbarItemDestination, toolbarItemMode } from './core/CoreToolbar.js';
 export { coreDescriptors } from './core/coreDescriptors.js';
 export { CoreAction, CoreCode, CoreColumn, CoreData, CoreField, CoreFile, CoreNavigate, CoreSection, CoreSummary, CoreTable, CoreTitle } from './core/ScreenplayCoreComponents.js';
 export { coreComponents } from './core/coreComponents.js';
@@ -43,6 +44,7 @@ export { DesignTimeContractVersion } from './packages/DesignTimeContractVersion.
 export { DesignTimeExtensionPoint, designTimeExtensionPointLabels } from './packages/DesignTimeExtensionPoint.js';
 export { DesignTimeProvider, useDesignTimeContext } from './packages/DesignTimeProvider.js';
 export { EmbeddedPackageHost } from './packages/EmbeddedPackageHost.js';
+export { loadApprovedPackages, resolveApprovedPackageHost } from './packages/loadApprovedPackages.js';
 export { loadDesignTimeContributions } from './packages/loadDesignTimeContributions.js';
 export { isNetworkAsset } from './packages/isNetworkAsset.js';
 export { PackageHostAssets } from './packages/PackageHostAssets.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/ApprovedPackageSet.d.ts

@@ -0,0 +1,16 @@
+import { ScenePackage } from '@cratis/scene.model';
+export interface PackageModuleReference {
+    npm: string;
+    version: string;
+    export: string;
+    styles?: string[];
+}
+export interface ApprovedPackage {
+    manifest: ScenePackage;
+    module: PackageModuleReference;
+}
+export interface ApprovedPackageSet {
+    version: 1;
+    packages: ApprovedPackage[];
+}
+//# sourceMappingURL=ApprovedPackageSet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovedPackageSet.d.ts","sourceRoot":"","sources":["../../../packages/ApprovedPackageSet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD,MAAM,WAAW,sBAAsB;IAEnC,GAAG,EAAE,MAAM,CAAC;IAGZ,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;CAClC;AAMD,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC/B"}

package/dist/esm/packages/ApprovedPackageSet.js

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

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

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