@cratis/scene.react 4.7.0 → 4.9.0

package/dist/esm/index.js

@@ -1,4 +1,5 @@
 export { SceneElementView } from './SceneElementView.js';
+export { BindingOutputProvider, useBindingOutputScope, useBindingOutputs } from './renderer/BindingOutputContext.js';
 export { UnresolvedComponent } from './renderer/UnresolvedComponent.js';
 export { createReactRenderer } from './renderer/createReactRenderer.js';
 export { InteractiveComponent } from './renderer/InteractiveComponent.js';
@@ -16,7 +17,10 @@ export { IconAdapterRegistry, createIconAdapterRegistry } from './icons/IconAdap
 export { IconAdapterProvider, useIconAdapters } from './icons/IconAdapterContext.js';
 export { useIconGlyph } from './icons/useIconGlyph.js';
 export { SceneIcon } from './icons/SceneIcon.js';
+export { validateDesignTimeBundle } from './packages/DesignTimeBundle.js';
+export { resolvePackageHost } from './packages/PackageHostConfiguration.js';
 export { componentRegistryKey, mergeIconAdapters, mergePackageRegistries, validatePackageBundle } from './packages/ScenePackageBundle.js';
+export { validateComponentsUiLibraryContract, validateComponentsUiLibraryMapping } from './packages/ComponentsUiLibraryContract.js';
 export { applyThemeTokens, themeTokenPrefix, themeTokenProperty } from './theme/themeTokens.js';
 export { SceneThemeProvider, useSceneTheme } from './theme/SceneThemeProvider.js';
 export { InteractionScope, attachmentFor, useInteractionScope } from './interactions/InteractionScope.js';

package/dist/esm/index.js.map

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

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

@@ -0,0 +1,19 @@
+export interface ComponentsUiLibraryContract {
+    module: string;
+    exportName: string;
+    id: string;
+    abi: number;
+    profile: string;
+    requiredSlots: readonly string[];
+    requiredCapabilities?: readonly string[];
+}
+export interface ComponentsUiLibraryManifest {
+    readonly id: string;
+    readonly abi: number;
+    readonly profile: string;
+    readonly slots: object;
+    readonly capabilities: readonly string[];
+}
+export declare function validateComponentsUiLibraryContract(contract: ComponentsUiLibraryContract): string[];
+export declare function validateComponentsUiLibraryMapping(contract: ComponentsUiLibraryContract, library: ComponentsUiLibraryManifest): string[];
+//# sourceMappingURL=ComponentsUiLibraryContract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentsUiLibraryContract.d.ts","sourceRoot":"","sources":["../../../packages/ComponentsUiLibraryContract.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,2BAA2B;IAExC,MAAM,EAAE,MAAM,CAAC;IAEf,UAAU,EAAE,MAAM,CAAC;IAEnB,EAAE,EAAE,MAAM,CAAC;IAEX,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,EAAE,MAAM,CAAC;IAEhB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAEjC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAOD,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAGD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,EAAE,CAoBnG;AAOD,wBAAgB,kCAAkC,CAC9C,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,2BAA2B,GACrC,MAAM,EAAE,CAmBV"}

package/dist/esm/packages/ComponentsUiLibraryContract.js

@@ -0,0 +1,69 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The web-only mapping between an independently authored Scene catalog and a Components renderer.
+ * Primitive slot identities are not Scene component names: composites such as DataTable remain
+ * library-independent. This contract belongs to the React bundle, never the platform-neutral model.
+ */ /** Checks a mapping before loading executable frontend code. */ function validateComponentsUiLibraryContract(contract) {
+    const problems = [];
+    for (const field of [
+        'module',
+        'exportName',
+        'id',
+        'profile'
+    ]){
+        if (contract[field].trim().length === 0) problems.push(`Components UI library mapping has an empty '${field}'`);
+    }
+    if (!Number.isInteger(contract.abi) || contract.abi < 1) {
+        problems.push('Components UI library mapping requires a positive integer ABI major');
+    }
+    for (const [field, values] of [
+        [
+            'requiredSlots',
+            contract.requiredSlots
+        ],
+        [
+            'requiredCapabilities',
+            contract.requiredCapabilities ?? []
+        ]
+    ]){
+        const seen = new Set();
+        for (const value of values){
+            if (value.trim().length === 0) problems.push(`Components UI library mapping has an empty '${field}' entry`);
+            if (seen.has(value)) problems.push(`Components UI library mapping repeats '${value}' in '${field}'`);
+            seen.add(value);
+        }
+    }
+    return problems;
+}
+/**
+ * Proves that an allowlisted module export satisfies its Scene mapping. Hosts must reject problems,
+ * rather than silently falling back to a different library. Additional slots are permitted: a
+ * renderer can support more than the bounded profile this integration consumes.
+ */ function validateComponentsUiLibraryMapping(contract, library) {
+    const problems = validateComponentsUiLibraryContract(contract);
+    for (const field of [
+        'id',
+        'abi',
+        'profile'
+    ]){
+        if (library[field] !== contract[field]) {
+            problems.push(`Components UI library '${contract.id}' requires ${field} '${contract[field]}' but the loaded library supplies '${library[field]}'`);
+        }
+    }
+    const slots = new Map(Object.entries(library.slots));
+    for (const slot of contract.requiredSlots){
+        if (!slots.has(slot) || slots.get(slot) === undefined || slots.get(slot) === null) {
+            problems.push(`Components UI library '${contract.id}' provides no implementation for required slot '${slot}'`);
+        }
+    }
+    for (const capability of contract.requiredCapabilities ?? []){
+        if (!library.capabilities.includes(capability)) {
+            problems.push(`Components UI library '${contract.id}' does not support required capability '${capability}'`);
+        }
+    }
+    return problems;
+}
+
+export { validateComponentsUiLibraryContract, validateComponentsUiLibraryMapping };
+//# sourceMappingURL=ComponentsUiLibraryContract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentsUiLibraryContract.js","sources":["../../../packages/ComponentsUiLibraryContract.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * The web-only mapping between an independently authored Scene catalog and a Components renderer.\n * Primitive slot identities are not Scene component names: composites such as DataTable remain\n * library-independent. This contract belongs to the React bundle, never the platform-neutral model.\n */\nexport interface ComponentsUiLibraryContract {\n    /** The npm module the host loads through its explicit package allowlist. */\n    module: string;\n    /** The named export supplying the Components UiLibrary. */\n    exportName: string;\n    /** The expected runtime library identity. */\n    id: string;\n    /** The Components renderer ABI major required by this mapping. */\n    abi: number;\n    /** The renderer profile promised by the library. */\n    profile: string;\n    /** Primitive or presentation slots the Scene integration requires. */\n    requiredSlots: readonly string[];\n    /** Capabilities required by the integration, not inferred from library identity. */\n    requiredCapabilities?: readonly string[];\n}\n\n/**\n * The structural part of Components' UiLibrary needed to check a mapping. The actual library may\n * also contain providers and executable slot declarations; Scene does not load or reinterpret them.\n * Keeping this structural avoids a Components ABI dependency in Scene.Model or Scene.Engine.\n */\nexport interface ComponentsUiLibraryManifest {\n    readonly id: string;\n    readonly abi: number;\n    readonly profile: string;\n    readonly slots: object;\n    readonly capabilities: readonly string[];\n}\n\n/** Checks a mapping before loading executable frontend code. */\nexport function validateComponentsUiLibraryContract(contract: ComponentsUiLibraryContract): string[] {\n    const problems: string[] = [];\n    for (const field of ['module', 'exportName', 'id', 'profile'] as const) {\n        if (contract[field].trim().length === 0) problems.push(`Components UI library mapping has an empty '${field}'`);\n    }\n    if (!Number.isInteger(contract.abi) || contract.abi < 1) {\n        problems.push('Components UI library mapping requires a positive integer ABI major');\n    }\n    for (const [field, values] of [\n        ['requiredSlots', contract.requiredSlots],\n        ['requiredCapabilities', contract.requiredCapabilities ?? []],\n    ] as const) {\n        const seen = new Set<string>();\n        for (const value of values) {\n            if (value.trim().length === 0) problems.push(`Components UI library mapping has an empty '${field}' entry`);\n            if (seen.has(value)) problems.push(`Components UI library mapping repeats '${value}' in '${field}'`);\n            seen.add(value);\n        }\n    }\n    return problems;\n}\n\n/**\n * Proves that an allowlisted module export satisfies its Scene mapping. Hosts must reject problems,\n * rather than silently falling back to a different library. Additional slots are permitted: a\n * renderer can support more than the bounded profile this integration consumes.\n */\nexport function validateComponentsUiLibraryMapping(\n    contract: ComponentsUiLibraryContract,\n    library: ComponentsUiLibraryManifest,\n): string[] {\n    const problems = validateComponentsUiLibraryContract(contract);\n    for (const field of ['id', 'abi', 'profile'] as const) {\n        if (library[field] !== contract[field]) {\n            problems.push(`Components UI library '${contract.id}' requires ${field} '${contract[field]}' but the loaded library supplies '${library[field]}'`);\n        }\n    }\n    const slots = new Map(Object.entries(library.slots));\n    for (const slot of contract.requiredSlots) {\n        if (!slots.has(slot) || slots.get(slot) === undefined || slots.get(slot) === null) {\n            problems.push(`Components UI library '${contract.id}' provides no implementation for required slot '${slot}'`);\n        }\n    }\n    for (const capability of contract.requiredCapabilities ?? []) {\n        if (!library.capabilities.includes(capability)) {\n            problems.push(`Components UI library '${contract.id}' does not support required capability '${capability}'`);\n        }\n    }\n    return problems;\n}\n"],"names":["validateComponentsUiLibraryContract","contract","problems","field","trim","length","push","Number","isInteger","abi","values","requiredSlots","requiredCapabilities","seen","Set","value","has","add","validateComponentsUiLibraryMapping","library","id","slots","Map","Object","entries","slot","get","undefined","capability","capabilities","includes"],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+import { ComponentDescriptor, DesignTimeActionDescriptor, ExternalComponent, SceneEdit } from '@cratis/scene.model';
+export interface DesignTimeActionContext {
+    element: ExternalComponent;
+    descriptor: ComponentDescriptor;
+    commandMetadata?: {
+        properties: {
+            name: string;
+            type: string;
+            label?: string;
+        }[];
+    };
+}
+export interface DesignTimeActionResult {
+    edits: SceneEdit[];
+    diagnostics: string[];
+}
+export interface DesignTimeAction {
+    descriptor: DesignTimeActionDescriptor;
+    isVisible(context: DesignTimeActionContext): boolean;
+    isEnabled(context: DesignTimeActionContext): boolean;
+    execute(context: DesignTimeActionContext): DesignTimeActionResult;
+}
+//# sourceMappingURL=DesignTimeAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTimeAction.d.ts","sourceRoot":"","sources":["../../../packages/DesignTimeAction.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEpH,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,mBAAmB,CAAC;IAChC,eAAe,CAAC,EAAE;QAAE,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;CACtF;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAKD,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,0BAA0B,CAAC;IACvC,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC;IACrD,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC;IACrD,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAAC;CACrE"}

package/dist/esm/packages/DesignTimeAction.js

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

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

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

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

@@ -0,0 +1,17 @@
+import { ComponentType, ReactNode } from 'react';
+import { DesignTimeAction } from './DesignTimeAction';
+export interface DesignTimeBundle {
+    previews?: Record<string, ComponentType<{
+        children?: ReactNode;
+    }>>;
+    designers?: Record<string, ComponentType<{
+        children?: ReactNode;
+    }>>;
+    propertyEditors?: Record<string, ComponentType<Record<string, unknown>>>;
+    propertyDisplays?: Record<string, ComponentType<{
+        value: unknown;
+    }>>;
+    actions?: Record<string, DesignTimeAction>;
+}
+export declare function validateDesignTimeBundle(bundle: DesignTimeBundle | undefined): string[];
+//# sourceMappingURL=DesignTimeBundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTimeBundle.d.ts","sourceRoot":"","sources":["../../../packages/DesignTimeBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,EAAE,CASvF"}

package/dist/esm/packages/DesignTimeBundle.js

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+function validateDesignTimeBundle(bundle) {
+    if (!bundle) return [];
+    const problems = [];
+    for (const [name, action] of Object.entries(bundle.actions ?? {})){
+        if (action.descriptor.id !== name) {
+            problems.push(`registers design-time action '${name}' with descriptor id '${action.descriptor.id}'`);
+        }
+    }
+    return problems;
+}
+
+export { validateDesignTimeBundle };
+//# sourceMappingURL=DesignTimeBundle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTimeBundle.js","sources":["../../../packages/DesignTimeBundle.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 { ComponentType, ReactNode } from 'react';\nimport { DesignTimeAction } from './DesignTimeAction';\n\n/**\n * Optional React-only design-time surface a package may publish beside its runtime bundle.\n */\nexport interface DesignTimeBundle {\n    previews?: Record<string, ComponentType<{ children?: ReactNode }>>;\n    designers?: Record<string, ComponentType<{ children?: ReactNode }>>;\n    propertyEditors?: Record<string, ComponentType<Record<string, unknown>>>;\n    propertyDisplays?: Record<string, ComponentType<{ value: unknown }>>;\n    actions?: Record<string, DesignTimeAction>;\n}\n\nexport function validateDesignTimeBundle(bundle: DesignTimeBundle | undefined): string[] {\n    if (!bundle) return [];\n    const problems: string[] = [];\n    for (const [name, action] of Object.entries(bundle.actions ?? {})) {\n        if (action.descriptor.id !== name) {\n            problems.push(`registers design-time action '${name}' with descriptor id '${action.descriptor.id}'`);\n        }\n    }\n    return problems;\n}\n"],"names":["validateDesignTimeBundle","bundle","problems","name","action","Object","entries","actions","descriptor","id","push"],"mappings":"AAAA;AACA;AAgBO,SAASA,yBAAyBC,MAAoC,EAAA;IACzE,IAAI,CAACA,MAAAA,EAAQ,OAAO,EAAE;AACtB,IAAA,MAAMC,WAAqB,EAAE;AAC7B,IAAA,KAAK,MAAM,CAACC,IAAAA,EAAMC,MAAAA,CAAO,IAAIC,MAAAA,CAAOC,OAAO,CAACL,MAAAA,CAAOM,OAAO,IAAI,EAAC,CAAA,CAAI;AAC/D,QAAA,IAAIH,MAAAA,CAAOI,UAAU,CAACC,EAAE,KAAKN,IAAAA,EAAM;AAC/BD,YAAAA,QAAAA,CAASQ,IAAI,CAAC,CAAC,8BAA8B,EAAEP,IAAAA,CAAK,sBAAsB,EAAEC,MAAAA,CAAOI,UAAU,CAACC,EAAE,CAAC,CAAC,CAAC,CAAA;AACvG,QAAA;AACJ,IAAA;IACA,OAAOP,QAAAA;AACX;;"}

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

@@ -0,0 +1,18 @@
+import { UiProfile } from '@cratis/scene.model';
+import { ScenePackageBundle, mergePackageRegistries } from './ScenePackageBundle';
+export interface PackageHostPolicy {
+    allowExecutableImports: boolean;
+    allowNetworkAssets: boolean;
+}
+export interface PackageHostConfiguration {
+    bundles: ScenePackageBundle[];
+    profile: UiProfile;
+    policy: PackageHostPolicy;
+}
+export interface ResolvedPackageHost {
+    bundles: ScenePackageBundle[];
+    components: ReturnType<typeof mergePackageRegistries>;
+    diagnostics: string[];
+}
+export declare function resolvePackageHost(configuration: PackageHostConfiguration): ResolvedPackageHost;
+//# sourceMappingURL=PackageHostConfiguration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageHostConfiguration.d.ts","sourceRoot":"","sources":["../../../packages/PackageHostConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAKD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,wBAAwB,GAAG,mBAAmB,CA6B/F"}

package/dist/esm/packages/PackageHostConfiguration.js

@@ -0,0 +1,41 @@
+import { mergePackageRegistries } from './ScenePackageBundle.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Resolves the approved package set a standalone or embedded React host uses.
+ */ function resolvePackageHost(configuration) {
+    const diagnostics = [];
+    const byName = new Map(configuration.bundles.map((bundle)=>[
+            bundle.manifest.name,
+            bundle
+        ]));
+    const bundles = [];
+    const runtimeSingletons = new Map();
+    for (const packageName of configuration.profile.packages){
+        const bundle = byName.get(packageName);
+        if (!bundle) {
+            diagnostics.push(`UI profile asks for '${packageName}' but the host did not approve a bundle for it`);
+            continue;
+        }
+        if (!configuration.policy.allowNetworkAssets && (bundle.manifest.assets ?? []).some((asset)=>/^https?:\/\//.test(asset))) {
+            diagnostics.push(`Package '${packageName}' declares network assets, but host policy forbids them`);
+        }
+        for (const dependency of bundle.manifest.runtimeSingletons ?? []){
+            const owner = runtimeSingletons.get(dependency);
+            if (owner && owner !== packageName) {
+                diagnostics.push(`Runtime singleton '${dependency}' is provided by both '${owner}' and '${packageName}'`);
+            }
+            runtimeSingletons.set(dependency, packageName);
+        }
+        bundles.push(bundle);
+    }
+    return {
+        bundles,
+        components: mergePackageRegistries(bundles),
+        diagnostics
+    };
+}
+
+export { resolvePackageHost };
+//# sourceMappingURL=PackageHostConfiguration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageHostConfiguration.js","sources":["../../../packages/PackageHostConfiguration.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 { UiProfile } from '@cratis/scene.model';\nimport { ScenePackageBundle, mergePackageRegistries } from './ScenePackageBundle';\n\nexport interface PackageHostPolicy {\n    allowExecutableImports: boolean;\n    allowNetworkAssets: boolean;\n}\n\nexport interface PackageHostConfiguration {\n    bundles: ScenePackageBundle[];\n    profile: UiProfile;\n    policy: PackageHostPolicy;\n}\n\nexport interface ResolvedPackageHost {\n    bundles: ScenePackageBundle[];\n    components: ReturnType<typeof mergePackageRegistries>;\n    diagnostics: string[];\n}\n\n/**\n * Resolves the approved package set a standalone or embedded React host uses.\n */\nexport function resolvePackageHost(configuration: PackageHostConfiguration): ResolvedPackageHost {\n    const diagnostics: string[] = [];\n    const byName = new Map(configuration.bundles.map(bundle => [bundle.manifest.name, bundle]));\n    const bundles: ScenePackageBundle[] = [];\n    const runtimeSingletons = new Map<string, string>();\n\n    for (const packageName of configuration.profile.packages) {\n        const bundle = byName.get(packageName);\n        if (!bundle) {\n            diagnostics.push(`UI profile asks for '${packageName}' but the host did not approve a bundle for it`);\n            continue;\n        }\n\n        if (!configuration.policy.allowNetworkAssets && (bundle.manifest.assets ?? []).some(asset => /^https?:\\/\\//.test(asset))) {\n            diagnostics.push(`Package '${packageName}' declares network assets, but host policy forbids them`);\n        }\n\n        for (const dependency of bundle.manifest.runtimeSingletons ?? []) {\n            const owner = runtimeSingletons.get(dependency);\n            if (owner && owner !== packageName) {\n                diagnostics.push(`Runtime singleton '${dependency}' is provided by both '${owner}' and '${packageName}'`);\n            }\n            runtimeSingletons.set(dependency, packageName);\n        }\n\n        bundles.push(bundle);\n    }\n\n    return { bundles, components: mergePackageRegistries(bundles), diagnostics };\n}\n"],"names":["resolvePackageHost","configuration","diagnostics","byName","Map","bundles","map","bundle","manifest","name","runtimeSingletons","packageName","profile","packages","get","push","policy","allowNetworkAssets","assets","some","asset","test","dependency","owner","set","components","mergePackageRegistries"],"mappings":";;AAAA;AACA;AAsBA;;IAGO,SAASA,kBAAAA,CAAmBC,aAAuC,EAAA;AACtE,IAAA,MAAMC,cAAwB,EAAE;IAChC,MAAMC,MAAAA,GAAS,IAAIC,GAAAA,CAAIH,aAAAA,CAAcI,OAAO,CAACC,GAAG,CAACC,CAAAA,MAAAA,GAAU;YAACA,MAAAA,CAAOC,QAAQ,CAACC,IAAI;AAAEF,YAAAA;AAAO,SAAA,CAAA,CAAA;AACzF,IAAA,MAAMF,UAAgC,EAAE;AACxC,IAAA,MAAMK,oBAAoB,IAAIN,GAAAA,EAAAA;AAE9B,IAAA,KAAK,MAAMO,WAAAA,IAAeV,aAAAA,CAAcW,OAAO,CAACC,QAAQ,CAAE;QACtD,MAAMN,MAAAA,GAASJ,MAAAA,CAAOW,GAAG,CAACH,WAAAA,CAAAA;AAC1B,QAAA,IAAI,CAACJ,MAAAA,EAAQ;AACTL,YAAAA,WAAAA,CAAYa,IAAI,CAAC,CAAC,qBAAqB,EAAEJ,WAAAA,CAAY,8CAA8C,CAAC,CAAA;AACpG,YAAA;AACJ,QAAA;QAEA,IAAI,CAACV,cAAce,MAAM,CAACC,kBAAkB,IAAKV,CAAAA,MAAAA,CAAOC,QAAQ,CAACU,MAAM,IAAI,EAAE,EAAEC,IAAI,CAACC,CAAAA,KAAAA,GAAS,cAAA,CAAeC,IAAI,CAACD,KAAAA,CAAAA,CAAAA,EAAS;AACtHlB,YAAAA,WAAAA,CAAYa,IAAI,CAAC,CAAC,SAAS,EAAEJ,WAAAA,CAAY,uDAAuD,CAAC,CAAA;AACrG,QAAA;QAEA,KAAK,MAAMW,cAAcf,MAAAA,CAAOC,QAAQ,CAACE,iBAAiB,IAAI,EAAE,CAAE;YAC9D,MAAMa,KAAAA,GAAQb,iBAAAA,CAAkBI,GAAG,CAACQ,UAAAA,CAAAA;YACpC,IAAIC,KAAAA,IAASA,UAAUZ,WAAAA,EAAa;AAChCT,gBAAAA,WAAAA,CAAYa,IAAI,CAAC,CAAC,mBAAmB,EAAEO,UAAAA,CAAW,uBAAuB,EAAEC,KAAAA,CAAM,OAAO,EAAEZ,WAAAA,CAAY,CAAC,CAAC,CAAA;AAC5G,YAAA;YACAD,iBAAAA,CAAkBc,GAAG,CAACF,UAAAA,EAAYX,WAAAA,CAAAA;AACtC,QAAA;AAEAN,QAAAA,OAAAA,CAAQU,IAAI,CAACR,MAAAA,CAAAA;AACjB,IAAA;IAEA,OAAO;AAAEF,QAAAA,OAAAA;AAASoB,QAAAA,UAAAA,EAAYC,sBAAAA,CAAuBrB,OAAAA,CAAAA;AAAUH,QAAAA;AAAY,KAAA;AAC/E;;"}

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

@@ -2,6 +2,8 @@ import { ComponentDescriptor, DialogTemplate, Layout, ScenePackage, Screen, Scre
 import { IconAdapterRegistry } from '../icons/IconAdapterRegistry';
 import { IconLibraryBundle } from '../icons/IconLibraryBundle';
 import { ComponentRegistry } from '../renderer';
+import { ComponentsUiLibraryContract } from './ComponentsUiLibraryContract';
+import { DesignTimeBundle } from './DesignTimeBundle';
 export interface ScenePackageBundle {
     manifest: ScenePackage;
     components: ComponentRegistry;
@@ -12,6 +14,8 @@ export interface ScenePackageBundle {
     descriptors?: ComponentDescriptor[];
     themes?: Theme[];
     iconLibrary?: IconLibraryBundle;
+    componentsUiLibrary?: ComponentsUiLibraryContract;
+    designTime?: DesignTimeBundle;
 }
 export declare function componentRegistryKey(packageName: string, componentName: string): string;
 export declare function validatePackageBundle(bundle: ScenePackageBundle): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"ScenePackageBundle.d.ts","sourceRoot":"","sources":["../../../packages/ScenePackageBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAkC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/J,OAAO,EAAE,mBAAmB,EAA6B,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAchD,MAAM,WAAW,kBAAkB;IAK/B,QAAQ,EAAE,YAAY,CAAC;IAKvB,UAAU,EAAE,iBAAiB,CAAC;IAK9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAMnB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAKnC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAMnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAQnB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAKpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAMjB,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAYD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvF;AAWD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAiD1E;AAmFD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,CAEvF;AAOD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,mBAAmB,CAEpF"}
+{"version":3,"file":"ScenePackageBundle.d.ts","sourceRoot":"","sources":["../../../packages/ScenePackageBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAkC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/J,OAAO,EAAE,mBAAmB,EAA6B,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAuC,MAAM,+BAA+B,CAAC;AACjH,OAAO,EAAE,gBAAgB,EAA4B,MAAM,oBAAoB,CAAC;AAchF,MAAM,WAAW,kBAAkB;IAK/B,QAAQ,EAAE,YAAY,CAAC;IAKvB,UAAU,EAAE,iBAAiB,CAAC;IAK9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAMnB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAKnC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAMnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAQnB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAKpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAMjB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAMhC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAGlD,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAYD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvF;AAWD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAyD1E;AAmFD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,CAEvF;AAOD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,mBAAmB,CAEpF"}

package/dist/esm/packages/ScenePackageBundle.js

@@ -1,5 +1,7 @@
 import { PackageKind, PropertyValueType } from '@cratis/scene.model';
 import { createIconAdapterRegistry } from '../icons/IconAdapterRegistry.js';
+import { validateComponentsUiLibraryContract } from './ComponentsUiLibraryContract.js';
+import { validateDesignTimeBundle } from './DesignTimeBundle.js';
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
@@ -61,8 +63,15 @@ import { createIconAdapterRegistry } from '../icons/IconAdapterRegistry.js';
             problems.push(`declares the theme '${name}' but provides no definition for it`);
         }
     }
+    if (bundle.componentsUiLibrary) {
+        if (manifest.kind !== PackageKind.ComponentLibrary) {
+            problems.push('declares a Components UI library mapping but is not of kind ComponentLibrary');
+        }
+        problems.push(...validateComponentsUiLibraryContract(bundle.componentsUiLibrary));
+    }
     problems.push(...validateIconLibrary(bundle));
     problems.push(...validateDescriptors(bundle));
+    problems.push(...validateDesignTimeBundle(bundle.designTime));
     return problems;
 }
 function validateIconLibrary(bundle) {

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

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

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

@@ -1,2 +1,6 @@
+export * from './DesignTimeAction';
+export * from './DesignTimeBundle';
+export * from './PackageHostConfiguration';
 export * from './ScenePackageBundle';
+export * from './ComponentsUiLibraryContract';
 //# 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,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}

package/dist/esm/packages/index.js

@@ -1,2 +1,6 @@
+export * from './DesignTimeAction';
+export * from './DesignTimeBundle';
+export * from './PackageHostConfiguration';
 export * from './ScenePackageBundle';
+export * from './ComponentsUiLibraryContract';
 //# 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,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}

package/dist/esm/renderer/BindingOutputContext.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+export interface ComponentBindingOutputs {
+    setOutput(property: string, value: unknown): void;
+    clearOutput(property: string): void;
+    clearAll(): void;
+}
+export interface BindingOutputProviderValue {
+    outputs: Record<string, Record<string, unknown>>;
+    outputFor(elementId: string): ComponentBindingOutputs;
+}
+export interface BindingOutputProviderProps {
+    children: ReactNode;
+    onOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;
+}
+export declare function BindingOutputProvider({ children, onOutputsChanged }: BindingOutputProviderProps): import("react").JSX.Element;
+export declare function useBindingOutputs(elementId: string): ComponentBindingOutputs;
+export declare function useBindingOutputScope(): Record<string, Record<string, unknown>>;
+//# sourceMappingURL=BindingOutputContext.d.ts.map

package/dist/esm/renderer/BindingOutputContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindingOutputContext.d.ts","sourceRoot":"","sources":["../../../renderer/BindingOutputContext.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAwE,MAAM,OAAO,CAAC;AAExG,MAAM,WAAW,uBAAuB;IACpC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAAC;CACzD;AAUD,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;CACjF;AAKD,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,0BAA0B,+BA2B/F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAG5E;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE/E"}

package/dist/esm/renderer/BindingOutputContext.js

@@ -0,0 +1,70 @@
+import { jsx } from 'react/jsx-runtime';
+import { useState, useEffect, useCallback, useMemo, useContext, createContext } from 'react';
+
+const emptyOutputs = {
+    setOutput: ()=>undefined,
+    clearOutput: ()=>undefined,
+    clearAll: ()=>undefined
+};
+const Context = /*#__PURE__*/ createContext(undefined);
+/**
+ * Tracks component output properties for typed component-property bindings and clears them with component lifecycle.
+ */ function BindingOutputProvider({ children, onOutputsChanged }) {
+    const [outputs, setOutputs] = useState({});
+    useEffect(()=>{
+        onOutputsChanged?.(outputs);
+    }, [
+        onOutputsChanged,
+        outputs
+    ]);
+    const outputFor = useCallback((elementId)=>({
+            setOutput: (property, propertyValue)=>setOutputs((current)=>({
+                        ...current,
+                        [elementId]: {
+                            ...current[elementId] ?? {},
+                            [property]: propertyValue
+                        }
+                    })),
+            clearOutput: (property)=>setOutputs((current)=>{
+                    const elementOutputs = {
+                        ...current[elementId] ?? {}
+                    };
+                    delete elementOutputs[property];
+                    return {
+                        ...current,
+                        [elementId]: elementOutputs
+                    };
+                }),
+            clearAll: ()=>setOutputs((current)=>{
+                    const next = {
+                        ...current
+                    };
+                    delete next[elementId];
+                    return next;
+                })
+        }), []);
+    const value = useMemo(()=>({
+            outputs,
+            outputFor
+        }), [
+        outputs,
+        outputFor
+    ]);
+    return /*#__PURE__*/ jsx(Context.Provider, {
+        value: value,
+        children: children
+    });
+}
+function useBindingOutputs(elementId) {
+    const outputFor = useContext(Context)?.outputFor;
+    return useMemo(()=>outputFor?.(elementId) ?? emptyOutputs, [
+        outputFor,
+        elementId
+    ]);
+}
+function useBindingOutputScope() {
+    return useContext(Context)?.outputs ?? {};
+}
+
+export { BindingOutputProvider, useBindingOutputScope, useBindingOutputs };
+//# sourceMappingURL=BindingOutputContext.js.map

package/dist/esm/renderer/BindingOutputContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindingOutputContext.js","sources":["../../../renderer/BindingOutputContext.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ReactNode, createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';\n\nexport interface ComponentBindingOutputs {\n    setOutput(property: string, value: unknown): void;\n    clearOutput(property: string): void;\n    clearAll(): void;\n}\n\nexport interface BindingOutputProviderValue {\n    outputs: Record<string, Record<string, unknown>>;\n    outputFor(elementId: string): ComponentBindingOutputs;\n}\n\nconst emptyOutputs: ComponentBindingOutputs = {\n    setOutput: () => undefined,\n    clearOutput: () => undefined,\n    clearAll: () => undefined,\n};\n\nconst Context = createContext<BindingOutputProviderValue | undefined>(undefined);\n\nexport interface BindingOutputProviderProps {\n    children: ReactNode;\n    onOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Tracks component output properties for typed component-property bindings and clears them with component lifecycle.\n */\nexport function BindingOutputProvider({ children, onOutputsChanged }: BindingOutputProviderProps) {\n    const [outputs, setOutputs] = useState<Record<string, Record<string, unknown>>>({});\n\n    useEffect(() => {\n        onOutputsChanged?.(outputs);\n    }, [onOutputsChanged, outputs]);\n\n    const outputFor = useCallback((elementId: string): ComponentBindingOutputs => ({\n        setOutput: (property: string, propertyValue: unknown) => setOutputs(current => ({\n            ...current,\n            [elementId]: { ...(current[elementId] ?? {}), [property]: propertyValue },\n        })),\n        clearOutput: (property: string) => setOutputs(current => {\n            const elementOutputs = { ...(current[elementId] ?? {}) };\n            delete elementOutputs[property];\n            return { ...current, [elementId]: elementOutputs };\n        }),\n        clearAll: () => setOutputs(current => {\n            const next = { ...current };\n            delete next[elementId];\n            return next;\n        }),\n    }), []);\n\n    const value = useMemo<BindingOutputProviderValue>(() => ({ outputs, outputFor }), [outputs, outputFor]);\n\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useBindingOutputs(elementId: string): ComponentBindingOutputs {\n    const outputFor = useContext(Context)?.outputFor;\n    return useMemo(() => outputFor?.(elementId) ?? emptyOutputs, [outputFor, elementId]);\n}\n\nexport function useBindingOutputScope(): Record<string, Record<string, unknown>> {\n    return useContext(Context)?.outputs ?? {};\n}\n"],"names":["emptyOutputs","setOutput","undefined","clearOutput","clearAll","Context","createContext","BindingOutputProvider","children","onOutputsChanged","outputs","setOutputs","useState","useEffect","outputFor","useCallback","elementId","property","propertyValue","current","elementOutputs","next","value","useMemo","_jsx","Provider","useBindingOutputs","useContext","useBindingOutputScope"],"mappings":";;;AAgBA,MAAMA,YAAAA,GAAwC;AAC1CC,IAAAA,SAAAA,EAAW,IAAMC,SAAAA;AACjBC,IAAAA,WAAAA,EAAa,IAAMD,SAAAA;AACnBE,IAAAA,QAAAA,EAAU,IAAMF;AACpB,CAAA;AAEA,MAAMG,wBAAUC,aAAAA,CAAsDJ,SAAAA,CAAAA;AAOtE;;AAEC,IACM,SAASK,qBAAAA,CAAsB,EAAEC,QAAQ,EAAEC,gBAAgB,EAA8B,EAAA;AAC5F,IAAA,MAAM,CAACC,OAAAA,EAASC,UAAAA,CAAW,GAAGC,SAAkD,EAAC,CAAA;IAEjFC,SAAAA,CAAU,IAAA;QACNJ,gBAAAA,GAAmBC,OAAAA,CAAAA;IACvB,CAAA,EAAG;AAACD,QAAAA,gBAAAA;AAAkBC,QAAAA;AAAQ,KAAA,CAAA;AAE9B,IAAA,MAAMI,SAAAA,GAAYC,WAAAA,CAAY,CAACC,SAAAA,IAAgD;AAC3Ef,YAAAA,SAAAA,EAAW,CAACgB,QAAAA,EAAkBC,aAAAA,GAA2BP,UAAAA,CAAWQ,CAAAA,WAAY;AAC5E,wBAAA,GAAGA,OAAO;AACV,wBAAA,CAACH,YAAY;AAAE,4BAAA,GAAIG,OAAO,CAACH,SAAAA,CAAU,IAAI,EAAE;AAAG,4BAAA,CAACC,WAAWC;AAAc;qBAC5E,CAAA,CAAA;YACAf,WAAAA,EAAa,CAACc,QAAAA,GAAqBN,UAAAA,CAAWQ,CAAAA,OAAAA,GAAAA;AAC1C,oBAAA,MAAMC,cAAAA,GAAiB;AAAE,wBAAA,GAAID,OAAO,CAACH,SAAAA,CAAU,IAAI;AAAI,qBAAA;oBACvD,OAAOI,cAAc,CAACH,QAAAA,CAAS;oBAC/B,OAAO;AAAE,wBAAA,GAAGE,OAAO;AAAE,wBAAA,CAACH,YAAYI;AAAe,qBAAA;AACrD,gBAAA,CAAA,CAAA;YACAhB,QAAAA,EAAU,IAAMO,WAAWQ,CAAAA,OAAAA,GAAAA;AACvB,oBAAA,MAAME,IAAAA,GAAO;AAAE,wBAAA,GAAGF;AAAQ,qBAAA;oBAC1B,OAAOE,IAAI,CAACL,SAAAA,CAAU;oBACtB,OAAOK,IAAAA;AACX,gBAAA,CAAA;AACJ,SAAA,GAAI,EAAE,CAAA;IAEN,MAAMC,KAAAA,GAAQC,OAAAA,CAAoC,KAAO;AAAEb,YAAAA,OAAAA;AAASI,YAAAA;AAAU,SAAA,CAAA,EAAI;AAACJ,QAAAA,OAAAA;AAASI,QAAAA;AAAU,KAAA,CAAA;IAEtG,qBAAOU,GAAA,CAACnB,QAAQoB,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQd,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAASkB,kBAAkBV,SAAiB,EAAA;IAC/C,MAAMF,SAAAA,GAAYa,WAAWtB,OAAAA,CAAAA,EAAUS,SAAAA;AACvC,IAAA,OAAOS,OAAAA,CAAQ,IAAMT,SAAAA,GAAYE,SAAAA,CAAAA,IAAchB,YAAAA,EAAc;AAACc,QAAAA,SAAAA;AAAWE,QAAAA;AAAU,KAAA,CAAA;AACvF;AAEO,SAASY,qBAAAA,GAAAA;IACZ,OAAOD,UAAAA,CAAWtB,OAAAA,CAAAA,EAAUK,OAAAA,IAAW,EAAC;AAC5C;;"}

package/dist/esm/renderer/ComponentRegistry.d.ts

@@ -1,10 +1,12 @@
 import { ComponentType, ReactNode } from 'react';
 import { ExternalComponent } from '@cratis/scene.model';
 import { InteractionHandlers } from '../interactions';
+import { ComponentBindingOutputs } from './BindingOutputContext';
 export interface RegisteredComponentProps {
     element: ExternalComponent;
     slots: Record<string, ReactNode[]>;
     interactions?: InteractionHandlers;
+    bindingOutputs?: ComponentBindingOutputs;
 }
 export type ComponentRegistry = Record<string, ComponentType<RegisteredComponentProps>>;
 //# sourceMappingURL=ComponentRegistry.d.ts.map

package/dist/esm/renderer/ComponentRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../../renderer/ComponentRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKtD,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAUnC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAUD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../../renderer/ComponentRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAKjE,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAUnC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAGnC,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAUD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC,CAAC"}

package/dist/esm/renderer/InteractiveComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InteractiveComponent.d.ts","sourceRoot":"","sources":["../../../renderer/InteractiveComponent.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAiB,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;IACnD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACtC;AASD,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,yBAAyB,+GAG5F"}
+{"version":3,"file":"InteractiveComponent.d.ts","sourceRoot":"","sources":["../../../renderer/InteractiveComponent.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAA4B,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;IACnD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACtC;AASD,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,yBAAyB,+GAK5F"}