@cratis/scene.react 4.14.0 → 4.16.0

package/core/ScreenplayCoreComponents.tsx

@@ -1,7 +1,8 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { RegisteredComponentProps } from '../renderer';
+import { resolveArgumentSource } from '@cratis/scene.engine';
+import { RegisteredComponentProps, useRenderBindingScope } from '../renderer';
 
 function textProperty(properties: Record<string, unknown>, name: string, fallback = ''): string {
     return typeof properties[name] === 'string' ? properties[name] : fallback;
@@ -12,11 +13,31 @@ export function CoreData({ element }: RegisteredComponentProps) {
     return <span hidden data-scene-id={element.id} data-scene-data={textProperty(element.properties, 'typeName')} />;
 }
 
-/** Renders a modeled command action and emits a host-neutral command event when invoked. */
+/** One entry of a command action's argument mapping. */
+interface ArgumentMapping {
+    name?: unknown;
+    source?: unknown;
+}
+
+/**
+ * Renders a modeled command action and emits a host-neutral command event when invoked.
+ *
+ * The event carries the resolved `arguments`, by name, read when the action is invoked: a
+ * `component.<id>.<output>` source reads what another element publishes - such as what the user typed into
+ * an input - and any other source is a data-context path. Hosts that read the mapping from `element`
+ * themselves keep working.
+ */
 export function CoreAction({ element }: RegisteredComponentProps) {
     const command = textProperty(element.properties, 'command');
     const label = textProperty(element.properties, 'label', command);
-    const invoke = () => globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', { detail: { command, element } }));
+    const scope = useRenderBindingScope();
+    const invoke = () => {
+        const mapping = Array.isArray(element.properties.arguments) ? element.properties.arguments as ArgumentMapping[] : [];
+        const args = Object.fromEntries(mapping
+            .filter((argument): argument is { name: string; source: string } => typeof argument.name === 'string' && typeof argument.source === 'string')
+            .map(argument => [argument.name, resolveArgumentSource(argument.source, scope)]));
+        globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', { detail: { command, element, arguments: args } }));
+    };
     return <button type='button' data-scene-id={element.id} onClick={invoke}>{label}</button>;
 }
 

package/dist/cjs/SceneElementView.js

@@ -4,6 +4,7 @@ var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 var scene_engine = require('@cratis/scene.engine');
 var RenderBindingScopeContext = require('./renderer/RenderBindingScopeContext.js');
+require('@cratis/scene.model');
 var createReactRenderer = require('./renderer/createReactRenderer.js');
 require('./interactions/useInteractions.js');
 require('./interactions/NotificationHost.js');

package/dist/cjs/SceneElementView.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneElementView.js","sources":["../../SceneElementView.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 { useMemo } from 'react';\nimport { applyEffectiveConfiguration, renderElement, BindingResolver } from '@cratis/scene.engine';\nimport { EffectiveConfiguration, SceneElement } from '@cratis/scene.model';\nimport { ComponentRegistry, RenderBindingScopeProvider, createReactRenderer, useRenderBindingResolver } from './renderer';\n\nexport interface SceneElementViewProps {\n    element: SceneElement;\n    registry: ComponentRegistry;\n    resolveBinding?: BindingResolver;\n    dataContext?: unknown;\n    queryResults?: Record<string, unknown>;\n    componentOutputs?: Record<string, Record<string, unknown>>;\n\n    /**\n     * The resolved configuration of the template chain the element sits in, from `resolveEffectiveConfiguration`.\n     * When given, each configurable component renders with its resolved properties - what a screen's own values add\n     * to an inherited template. It is the same data the editor shows, and the same code path whether the screen is\n     * being edited or played: there is no design-time mode.\n     */\n    configuration?: EffectiveConfiguration;\n\n    /** Called when rendered components publish or clear output properties for typed bindings. */\n    onComponentOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Renders a Scene element tree with the real `Scene.React` renderer - the WYSIWYG building block Studio's\n * preview surface and Stage's shipped web bundle both consume unmodified.\n */\nexport function SceneElementView({\n    element,\n    registry,\n    resolveBinding,\n    configuration,\n    onComponentOutputsChanged,\n    dataContext,\n    queryResults,\n    componentOutputs,\n}: SceneElementViewProps) {\n    const configured = useMemo(() => configuration ? applyEffectiveConfiguration(element, configuration) : element, [element, configuration]);\n    return (\n        <RenderBindingScopeProvider\n            dataContext={dataContext}\n            queryResults={queryResults}\n            componentOutputs={componentOutputs}\n            resolveBinding={resolveBinding}\n            onComponentOutputsChanged={onComponentOutputsChanged}>\n            <RenderedElement element={configured} registry={registry} />\n        </RenderBindingScopeProvider>\n    );\n}\n\nfunction RenderedElement({ element, registry }: { element: SceneElement; registry: ComponentRegistry }) {\n    const renderer = useMemo(() => createReactRenderer(registry), [registry]);\n    const resolveBinding = useRenderBindingResolver();\n    return <>{renderElement(element, renderer, resolveBinding)}</>;\n}\n"],"names":["SceneElementView","element","registry","resolveBinding","configuration","onComponentOutputsChanged","dataContext","queryResults","componentOutputs","configured","useMemo","applyEffectiveConfiguration","_jsx","RenderBindingScopeProvider","RenderedElement","renderer","createReactRenderer","useRenderBindingResolver","_Fragment","renderElement"],"mappings":";;;;;;;;;;AA4BA;;;AAGC,IACM,SAASA,gBAAAA,CAAiB,EAC7BC,OAAO,EACPC,QAAQ,EACRC,cAAc,EACdC,aAAa,EACbC,yBAAyB,EACzBC,WAAW,EACXC,YAAY,EACZC,gBAAgB,EACI,EAAA;AACpB,IAAA,MAAMC,aAAaC,aAAAA,CAAQ,IAAMN,gBAAgBO,wCAAAA,CAA4BV,OAAAA,EAASG,iBAAiBH,OAAAA,EAAS;AAACA,QAAAA,OAAAA;AAASG,QAAAA;AAAc,KAAA,CAAA;AACxI,IAAA,qBACIQ,cAAA,CAACC,oDAAAA,EAAAA;QACGP,WAAAA,EAAaA,WAAAA;QACbC,YAAAA,EAAcA,YAAAA;QACdC,gBAAAA,EAAkBA,gBAAAA;QAClBL,cAAAA,EAAgBA,cAAAA;QAChBE,yBAAAA,EAA2BA,yBAAAA;AAC3B,QAAA,QAAA,gBAAAO,cAAA,CAACE,eAAAA,EAAAA;YAAgBb,OAAAA,EAASQ,UAAAA;YAAYP,QAAAA,EAAUA;;;AAG5D;AAEA,SAASY,eAAAA,CAAgB,EAAEb,OAAO,EAAEC,QAAQ,EAA0D,EAAA;AAClG,IAAA,MAAMa,QAAAA,GAAWL,aAAAA,CAAQ,IAAMM,uCAAAA,CAAoBd,QAAAA,CAAAA,EAAW;AAACA,QAAAA;AAAS,KAAA,CAAA;AACxE,IAAA,MAAMC,cAAAA,GAAiBc,kDAAAA,EAAAA;IACvB,qBAAOL,cAAA,CAAAM,mBAAA,EAAA;AAAGC,QAAAA,QAAAA,EAAAA,0BAAAA,CAAclB,SAASc,QAAAA,EAAUZ,cAAAA;;AAC/C;;"}
+{"version":3,"file":"SceneElementView.js","sources":["../../SceneElementView.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 { useMemo } from 'react';\nimport { applyEffectiveConfiguration, renderElement, BindingResolver } from '@cratis/scene.engine';\nimport { EffectiveConfiguration, SceneElement } from '@cratis/scene.model';\nimport { ComponentRegistry, RenderBindingScopeProvider, createReactRenderer, useRenderBindingResolver } from './renderer';\n\nexport interface SceneElementViewProps {\n    element: SceneElement;\n    registry: ComponentRegistry;\n    resolveBinding?: BindingResolver;\n    dataContext?: unknown;\n    queryResults?: Record<string, unknown>;\n    componentOutputs?: Record<string, Record<string, unknown>>;\n\n    /**\n     * The resolved configuration of the template chain the element sits in, from `resolveEffectiveConfiguration`.\n     * When given, each configurable component renders with its resolved properties - what a screen's own values add\n     * to an inherited template. It is the same data the editor shows, and the same code path whether the screen is\n     * being edited or played: there is no design-time mode.\n     */\n    configuration?: EffectiveConfiguration;\n\n    /** Called when rendered components publish or clear output properties for typed bindings. */\n    onComponentOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Renders a Scene element tree with the real `Scene.React` renderer - the WYSIWYG building block Studio's\n * preview surface and Stage's shipped web bundle both consume unmodified.\n */\nexport function SceneElementView({\n    element,\n    registry,\n    resolveBinding,\n    configuration,\n    onComponentOutputsChanged,\n    dataContext,\n    queryResults,\n    componentOutputs,\n}: SceneElementViewProps) {\n    const configured = useMemo(() => configuration ? applyEffectiveConfiguration(element, configuration) : element, [element, configuration]);\n    return (\n        <RenderBindingScopeProvider\n            dataContext={dataContext}\n            queryResults={queryResults}\n            componentOutputs={componentOutputs}\n            resolveBinding={resolveBinding}\n            onComponentOutputsChanged={onComponentOutputsChanged}>\n            <RenderedElement element={configured} registry={registry} />\n        </RenderBindingScopeProvider>\n    );\n}\n\nfunction RenderedElement({ element, registry }: { element: SceneElement; registry: ComponentRegistry }) {\n    const renderer = useMemo(() => createReactRenderer(registry), [registry]);\n    const resolveBinding = useRenderBindingResolver();\n    return <>{renderElement(element, renderer, resolveBinding)}</>;\n}\n"],"names":["SceneElementView","element","registry","resolveBinding","configuration","onComponentOutputsChanged","dataContext","queryResults","componentOutputs","configured","useMemo","applyEffectiveConfiguration","_jsx","RenderBindingScopeProvider","RenderedElement","renderer","createReactRenderer","useRenderBindingResolver","_Fragment","renderElement"],"mappings":";;;;;;;;;;;AA4BA;;;AAGC,IACM,SAASA,gBAAAA,CAAiB,EAC7BC,OAAO,EACPC,QAAQ,EACRC,cAAc,EACdC,aAAa,EACbC,yBAAyB,EACzBC,WAAW,EACXC,YAAY,EACZC,gBAAgB,EACI,EAAA;AACpB,IAAA,MAAMC,aAAaC,aAAAA,CAAQ,IAAMN,gBAAgBO,wCAAAA,CAA4BV,OAAAA,EAASG,iBAAiBH,OAAAA,EAAS;AAACA,QAAAA,OAAAA;AAASG,QAAAA;AAAc,KAAA,CAAA;AACxI,IAAA,qBACIQ,cAAA,CAACC,oDAAAA,EAAAA;QACGP,WAAAA,EAAaA,WAAAA;QACbC,YAAAA,EAAcA,YAAAA;QACdC,gBAAAA,EAAkBA,gBAAAA;QAClBL,cAAAA,EAAgBA,cAAAA;QAChBE,yBAAAA,EAA2BA,yBAAAA;AAC3B,QAAA,QAAA,gBAAAO,cAAA,CAACE,eAAAA,EAAAA;YAAgBb,OAAAA,EAASQ,UAAAA;YAAYP,QAAAA,EAAUA;;;AAG5D;AAEA,SAASY,eAAAA,CAAgB,EAAEb,OAAO,EAAEC,QAAQ,EAA0D,EAAA;AAClG,IAAA,MAAMa,QAAAA,GAAWL,aAAAA,CAAQ,IAAMM,uCAAAA,CAAoBd,QAAAA,CAAAA,EAAW;AAACA,QAAAA;AAAS,KAAA,CAAA;AACxE,IAAA,MAAMC,cAAAA,GAAiBc,kDAAAA,EAAAA;IACvB,qBAAOL,cAAA,CAAAM,mBAAA,EAAA;AAAGC,QAAAA,QAAAA,EAAAA,0BAAAA,CAAclB,SAASc,QAAAA,EAAUZ,cAAAA;;AAC/C;;"}

package/dist/cjs/core/ScreenplayCoreComponents.js

@@ -1,9 +1,13 @@
 'use strict';
 
 var jsxRuntime = require('react/jsx-runtime');
+var scene_engine = require('@cratis/scene.engine');
+require('react');
+var RenderBindingScopeContext = require('../renderer/RenderBindingScopeContext.js');
+require('@cratis/scene.model');
+require('../interactions/useInteractions.js');
+require('../interactions/NotificationHost.js');
 
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 function textProperty(properties, name, fallback = '') {
     return typeof properties[name] === 'string' ? properties[name] : fallback;
 }
@@ -14,15 +18,31 @@ function textProperty(properties, name, fallback = '') {
         "data-scene-data": textProperty(element.properties, 'typeName')
     });
 }
-/** Renders a modeled command action and emits a host-neutral command event when invoked. */ function CoreAction({ element }) {
+/**
+ * Renders a modeled command action and emits a host-neutral command event when invoked.
+ *
+ * The event carries the resolved `arguments`, by name, read when the action is invoked: a
+ * `component.<id>.<output>` source reads what another element publishes - such as what the user typed into
+ * an input - and any other source is a data-context path. Hosts that read the mapping from `element`
+ * themselves keep working.
+ */ function CoreAction({ element }) {
     const command = textProperty(element.properties, 'command');
     const label = textProperty(element.properties, 'label', command);
-    const invoke = ()=>globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', {
+    const scope = RenderBindingScopeContext.useRenderBindingScope();
+    const invoke = ()=>{
+        const mapping = Array.isArray(element.properties.arguments) ? element.properties.arguments : [];
+        const args = Object.fromEntries(mapping.filter((argument)=>typeof argument.name === 'string' && typeof argument.source === 'string').map((argument)=>[
+                argument.name,
+                scene_engine.resolveArgumentSource(argument.source, scope)
+            ]));
+        globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', {
             detail: {
                 command,
-                element
+                element,
+                arguments: args
             }
         }));
+    };
     return /*#__PURE__*/ jsxRuntime.jsx("button", {
         type: "button",
         "data-scene-id": element.id,

package/dist/cjs/core/ScreenplayCoreComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenplayCoreComponents.js","sources":["../../../core/ScreenplayCoreComponents.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 { RegisteredComponentProps } from '../renderer';\n\nfunction textProperty(properties: Record<string, unknown>, name: string, fallback = ''): string {\n    return typeof properties[name] === 'string' ? properties[name] : fallback;\n}\n\n/** Carries a Screenplay data declaration without adding visual chrome. */\nexport function CoreData({ element }: RegisteredComponentProps) {\n    return <span hidden data-scene-id={element.id} data-scene-data={textProperty(element.properties, 'typeName')} />;\n}\n\n/** Renders a modeled command action and emits a host-neutral command event when invoked. */\nexport function CoreAction({ element }: RegisteredComponentProps) {\n    const command = textProperty(element.properties, 'command');\n    const label = textProperty(element.properties, 'label', command);\n    const invoke = () => globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', { detail: { command, element } }));\n    return <button type='button' data-scene-id={element.id} onClick={invoke}>{label}</button>;\n}\n\n/** Groups the nested content of a Screenplay section. */\nexport function CoreSection({ element, slots }: RegisteredComponentProps) {\n    const name = textProperty(element.properties, 'name');\n    return <section data-scene-id={element.id}>{name && <h2>{name}</h2>}{slots.content}</section>;\n}\n\n/** Renders navigation intent and emits a host-neutral navigation event. */\nexport function CoreNavigate({ element }: RegisteredComponentProps) {\n    const targetScreen = textProperty(element.properties, 'targetScreen');\n    const navigate = () => globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', { detail: { targetScreen, element } }));\n    return <button type='button' data-scene-id={element.id} onClick={navigate}>{targetScreen}</button>;\n}\n\n/** Renders a Screenplay title directive. */\nexport function CoreTitle({ element }: RegisteredComponentProps) {\n    return <h1 data-scene-id={element.id}>{textProperty(element.properties, 'text')}</h1>;\n}\n\n/** Renders the structural shell of a Screenplay table. Query data is supplied by the host. */\nexport function CoreTable({ element, slots }: RegisteredComponentProps) {\n    return <section data-scene-id={element.id} role='table'><header role='row'>{slots.columns}</header></section>;\n}\n\n/** Renders a Screenplay table-column heading. */\nexport function CoreColumn({ element }: RegisteredComponentProps) {\n    const property = textProperty(element.properties, 'property');\n    return <span data-scene-id={element.id} role='columnheader'>{textProperty(element.properties, 'label', property)}</span>;\n}\n\n/** Renders the structural shell of a Screenplay summary. Query data is supplied by the host. */\nexport function CoreSummary({ element, slots }: RegisteredComponentProps) {\n    return <dl data-scene-id={element.id}>{slots.fields}</dl>;\n}\n\n/** Renders a Screenplay summary field label. */\nexport function CoreField({ element }: RegisteredComponentProps) {\n    const property = textProperty(element.properties, 'property');\n    return <dt data-scene-id={element.id}>{textProperty(element.properties, 'label', property)}</dt>;\n}\n\n/** Renders a Screenplay code block. */\nexport function CoreCode({ element }: RegisteredComponentProps) {\n    const language = textProperty(element.properties, 'language');\n    return <pre data-scene-id={element.id}><code data-language={language}>{textProperty(element.properties, 'code')}</code></pre>;\n}\n\n/** Makes an external screen-file reference visible until a host supplies that file. */\nexport function CoreFile({ element }: RegisteredComponentProps) {\n    return <p data-scene-id={element.id}>Screen source: {textProperty(element.properties, 'path')}</p>;\n}\n"],"names":["textProperty","properties","name","fallback","CoreData","element","_jsx","span","hidden","data-scene-id","id","data-scene-data","CoreAction","command","label","invoke","globalThis","dispatchEvent","CustomEvent","detail","button","type","onClick","CoreSection","slots","_jsxs","section","h2","content","CoreNavigate","targetScreen","navigate","CoreTitle","h1","CoreTable","role","header","columns","CoreColumn","property","CoreSummary","dl","fields","CoreField","dt","CoreCode","language","pre","code","data-language","CoreFile","p"],"mappings":"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"}
+{"version":3,"file":"ScreenplayCoreComponents.js","sources":["../../../core/ScreenplayCoreComponents.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 { resolveArgumentSource } from '@cratis/scene.engine';\nimport { RegisteredComponentProps, useRenderBindingScope } from '../renderer';\n\nfunction textProperty(properties: Record<string, unknown>, name: string, fallback = ''): string {\n    return typeof properties[name] === 'string' ? properties[name] : fallback;\n}\n\n/** Carries a Screenplay data declaration without adding visual chrome. */\nexport function CoreData({ element }: RegisteredComponentProps) {\n    return <span hidden data-scene-id={element.id} data-scene-data={textProperty(element.properties, 'typeName')} />;\n}\n\n/** One entry of a command action's argument mapping. */\ninterface ArgumentMapping {\n    name?: unknown;\n    source?: unknown;\n}\n\n/**\n * Renders a modeled command action and emits a host-neutral command event when invoked.\n *\n * The event carries the resolved `arguments`, by name, read when the action is invoked: a\n * `component.<id>.<output>` source reads what another element publishes - such as what the user typed into\n * an input - and any other source is a data-context path. Hosts that read the mapping from `element`\n * themselves keep working.\n */\nexport function CoreAction({ element }: RegisteredComponentProps) {\n    const command = textProperty(element.properties, 'command');\n    const label = textProperty(element.properties, 'label', command);\n    const scope = useRenderBindingScope();\n    const invoke = () => {\n        const mapping = Array.isArray(element.properties.arguments) ? element.properties.arguments as ArgumentMapping[] : [];\n        const args = Object.fromEntries(mapping\n            .filter((argument): argument is { name: string; source: string } => typeof argument.name === 'string' && typeof argument.source === 'string')\n            .map(argument => [argument.name, resolveArgumentSource(argument.source, scope)]));\n        globalThis.dispatchEvent(new CustomEvent('cratis.scene.command', { detail: { command, element, arguments: args } }));\n    };\n    return <button type='button' data-scene-id={element.id} onClick={invoke}>{label}</button>;\n}\n\n/** Groups the nested content of a Screenplay section. */\nexport function CoreSection({ element, slots }: RegisteredComponentProps) {\n    const name = textProperty(element.properties, 'name');\n    return <section data-scene-id={element.id}>{name && <h2>{name}</h2>}{slots.content}</section>;\n}\n\n/** Renders navigation intent and emits a host-neutral navigation event. */\nexport function CoreNavigate({ element }: RegisteredComponentProps) {\n    const targetScreen = textProperty(element.properties, 'targetScreen');\n    const navigate = () => globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', { detail: { targetScreen, element } }));\n    return <button type='button' data-scene-id={element.id} onClick={navigate}>{targetScreen}</button>;\n}\n\n/** Renders a Screenplay title directive. */\nexport function CoreTitle({ element }: RegisteredComponentProps) {\n    return <h1 data-scene-id={element.id}>{textProperty(element.properties, 'text')}</h1>;\n}\n\n/** Renders the structural shell of a Screenplay table. Query data is supplied by the host. */\nexport function CoreTable({ element, slots }: RegisteredComponentProps) {\n    return <section data-scene-id={element.id} role='table'><header role='row'>{slots.columns}</header></section>;\n}\n\n/** Renders a Screenplay table-column heading. */\nexport function CoreColumn({ element }: RegisteredComponentProps) {\n    const property = textProperty(element.properties, 'property');\n    return <span data-scene-id={element.id} role='columnheader'>{textProperty(element.properties, 'label', property)}</span>;\n}\n\n/** Renders the structural shell of a Screenplay summary. Query data is supplied by the host. */\nexport function CoreSummary({ element, slots }: RegisteredComponentProps) {\n    return <dl data-scene-id={element.id}>{slots.fields}</dl>;\n}\n\n/** Renders a Screenplay summary field label. */\nexport function CoreField({ element }: RegisteredComponentProps) {\n    const property = textProperty(element.properties, 'property');\n    return <dt data-scene-id={element.id}>{textProperty(element.properties, 'label', property)}</dt>;\n}\n\n/** Renders a Screenplay code block. */\nexport function CoreCode({ element }: RegisteredComponentProps) {\n    const language = textProperty(element.properties, 'language');\n    return <pre data-scene-id={element.id}><code data-language={language}>{textProperty(element.properties, 'code')}</code></pre>;\n}\n\n/** Makes an external screen-file reference visible until a host supplies that file. */\nexport function CoreFile({ element }: RegisteredComponentProps) {\n    return <p data-scene-id={element.id}>Screen source: {textProperty(element.properties, 'path')}</p>;\n}\n"],"names":["textProperty","properties","name","fallback","CoreData","element","_jsx","span","hidden","data-scene-id","id","data-scene-data","CoreAction","command","label","scope","useRenderBindingScope","invoke","mapping","Array","isArray","arguments","args","Object","fromEntries","filter","argument","source","map","resolveArgumentSource","globalThis","dispatchEvent","CustomEvent","detail","button","type","onClick","CoreSection","slots","_jsxs","section","h2","content","CoreNavigate","targetScreen","navigate","CoreTitle","h1","CoreTable","role","header","columns","CoreColumn","property","CoreSummary","dl","fields","CoreField","dt","CoreCode","language","pre","code","data-language","CoreFile","p"],"mappings":"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"}

package/dist/cjs/index.js

@@ -5,6 +5,9 @@ var AbortableQueryRunner = require('./renderer/AbortableQueryRunner.js');
 var BindingOutputContext = require('./renderer/BindingOutputContext.js');
 var RenderBindingScopeContext = require('./renderer/RenderBindingScopeContext.js');
 var UnresolvedComponent = require('./renderer/UnresolvedComponent.js');
+var useBoundQuery = require('./renderer/useBoundQuery.js');
+var useValueOutput = require('./renderer/useValueOutput.js');
+var valueOutputProperty = require('./renderer/valueOutputProperty.js');
 var createReactRenderer = require('./renderer/createReactRenderer.js');
 var InteractiveComponent = require('./renderer/InteractiveComponent.js');
 var CoreText = require('./core/CoreText.js');
@@ -20,6 +23,7 @@ var extractNavigationItem = require('./NavBar/extractNavigationItem.js');
 var SceneNavigationContext = require('./navigation/SceneNavigationContext.js');
 var SceneNavigationHost = require('./navigation/SceneNavigationHost.js');
 var createBrowserSceneHistory = require('./navigation/createBrowserSceneHistory.js');
+var createHashSceneHistory = require('./navigation/createHashSceneHistory.js');
 var createMemorySceneHistory = require('./navigation/createMemorySceneHistory.js');
 var diagnoseRenderedNavigation = require('./navigation/diagnoseRenderedNavigation.js');
 var identityRoute = require('./navigation/identityRoute.js');
@@ -38,6 +42,7 @@ var DesignTimeExtensionPoint = require('./packages/DesignTimeExtensionPoint.js')
 var DesignTimeProvider = require('./packages/DesignTimeProvider.js');
 var EmbeddedPackageHost = require('./packages/EmbeddedPackageHost.js');
 var loadDesignTimeContributions = require('./packages/loadDesignTimeContributions.js');
+var isNetworkAsset = require('./packages/isNetworkAsset.js');
 var PackageHostAssets = require('./packages/PackageHostAssets.js');
 var PackageHostConfiguration = require('./packages/PackageHostConfiguration.js');
 var PackageHostRenderMode = require('./packages/PackageHostRenderMode.js');
@@ -69,6 +74,10 @@ exports.RenderBindingScopeProvider = RenderBindingScopeContext.RenderBindingScop
 exports.useRenderBindingResolver = RenderBindingScopeContext.useRenderBindingResolver;
 exports.useRenderBindingScope = RenderBindingScopeContext.useRenderBindingScope;
 exports.UnresolvedComponent = UnresolvedComponent.UnresolvedComponent;
+exports.useBoundQuery = useBoundQuery.useBoundQuery;
+exports.useValueOutput = useValueOutput.useValueOutput;
+exports.valueOutputName = useValueOutput.valueOutputName;
+exports.valueOutputProperty = valueOutputProperty.valueOutputProperty;
 exports.createReactRenderer = createReactRenderer.createReactRenderer;
 exports.InteractiveComponent = InteractiveComponent.InteractiveComponent;
 exports.CoreText = CoreText.CoreText;
@@ -96,6 +105,7 @@ exports.SceneNavigationProvider = SceneNavigationContext.SceneNavigationProvider
 exports.useSceneNavigation = SceneNavigationContext.useSceneNavigation;
 exports.SceneNavigationHost = SceneNavigationHost.SceneNavigationHost;
 exports.createBrowserSceneHistory = createBrowserSceneHistory.createBrowserSceneHistory;
+exports.createHashSceneHistory = createHashSceneHistory.createHashSceneHistory;
 exports.createMemorySceneHistory = createMemorySceneHistory.createMemorySceneHistory;
 exports.diagnoseRenderedNavigation = diagnoseRenderedNavigation.diagnoseRenderedNavigation;
 exports.identityRoute = identityRoute.identityRoute;
@@ -118,6 +128,7 @@ exports.DesignTimeProvider = DesignTimeProvider.DesignTimeProvider;
 exports.useDesignTimeContext = DesignTimeProvider.useDesignTimeContext;
 exports.EmbeddedPackageHost = EmbeddedPackageHost.EmbeddedPackageHost;
 exports.loadDesignTimeContributions = loadDesignTimeContributions.loadDesignTimeContributions;
+exports.isNetworkAsset = isNetworkAsset.isNetworkAsset;
 exports.PackageHostAssets = PackageHostAssets.PackageHostAssets;
 exports.resolvePackageHost = PackageHostConfiguration.resolvePackageHost;
 exports.PackageHostRenderMode = PackageHostRenderMode.PackageHostRenderMode;

package/dist/cjs/index.js.map

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

package/dist/cjs/navigation/createHashSceneHistory.js

@@ -0,0 +1,43 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const stateKey = 'sceneNavigation';
+/**
+ * A history kept in the URL fragment - `index.html#/WorkItemDetails?workItemId=B` - for hosts that are served
+ * as a single file or from a path they do not control, such as a generated runtime or a webview. It behaves
+ * like `createBrowserSceneHistory`: entries are pushed with their navigation state, back and forward restore
+ * them, and a typed or bookmarked fragment is matched by URL alone. A fragment changed by hand, which fires
+ * `hashchange` rather than `popstate`, is reported the same way.
+ */ function createHashSceneHistory(browser = window) {
+    const location = ()=>{
+        const fragment = browser.location.hash.replace(/^#\/?/, '');
+        return fragment.length ? fragment : undefined;
+    };
+    const href = (url)=>`${browser.location.pathname}${browser.location.search}#/${url ?? ''}`;
+    const stored = (value)=>value?.[stateKey];
+    return {
+        location,
+        state: ()=>stored(browser.history.state),
+        push: (state)=>browser.history.pushState({
+                [stateKey]: state
+            }, '', href(state.url)),
+        replace: (state)=>browser.history.replaceState({
+                [stateKey]: state
+            }, '', href(state.url)),
+        back: ()=>browser.history.back(),
+        listen: (listener)=>{
+            const onPopState = (event)=>listener(location(), stored(event.state));
+            const onHashChange = ()=>listener(location(), stored(browser.history.state));
+            browser.addEventListener('popstate', onPopState);
+            browser.addEventListener('hashchange', onHashChange);
+            return ()=>{
+                browser.removeEventListener('popstate', onPopState);
+                browser.removeEventListener('hashchange', onHashChange);
+            };
+        }
+    };
+}
+
+exports.createHashSceneHistory = createHashSceneHistory;
+//# sourceMappingURL=createHashSceneHistory.js.map

package/dist/cjs/navigation/createHashSceneHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHashSceneHistory.js","sources":["../../../navigation/createHashSceneHistory.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 { SceneBrowserWindow } from './createBrowserSceneHistory';\nimport { SceneHistory } from './SceneHistory';\nimport { SceneNavigationState } from './SceneNavigationState';\n\nconst stateKey = 'sceneNavigation';\n\n/**\n * A history kept in the URL fragment - `index.html#/WorkItemDetails?workItemId=B` - for hosts that are served\n * as a single file or from a path they do not control, such as a generated runtime or a webview. It behaves\n * like `createBrowserSceneHistory`: entries are pushed with their navigation state, back and forward restore\n * them, and a typed or bookmarked fragment is matched by URL alone. A fragment changed by hand, which fires\n * `hashchange` rather than `popstate`, is reported the same way.\n */\nexport function createHashSceneHistory(browser: SceneBrowserWindow = window): SceneHistory {\n    const location = () => {\n        const fragment = browser.location.hash.replace(/^#\\/?/, '');\n        return fragment.length ? fragment : undefined;\n    };\n    const href = (url: string | undefined) => `${browser.location.pathname}${browser.location.search}#/${url ?? ''}`;\n    const stored = (value: unknown) => (value as Record<string, SceneNavigationState> | null)?.[stateKey];\n\n    return {\n        location,\n        state: () => stored(browser.history.state),\n        push: state => browser.history.pushState({ [stateKey]: state }, '', href(state.url)),\n        replace: state => browser.history.replaceState({ [stateKey]: state }, '', href(state.url)),\n        back: () => browser.history.back(),\n        listen: listener => {\n            const onPopState = (event: PopStateEvent) => listener(location(), stored(event.state));\n            const onHashChange = () => listener(location(), stored(browser.history.state));\n            browser.addEventListener('popstate', onPopState);\n            browser.addEventListener('hashchange', onHashChange);\n            return () => {\n                browser.removeEventListener('popstate', onPopState);\n                browser.removeEventListener('hashchange', onHashChange);\n            };\n        },\n    };\n}\n"],"names":["stateKey","createHashSceneHistory","browser","window","location","fragment","hash","replace","length","undefined","href","url","pathname","search","stored","value","state","history","push","pushState","replaceState","back","listen","listener","onPopState","event","onHashChange","addEventListener","removeEventListener"],"mappings":";;AAAA;AACA;AAMA,MAAMA,QAAAA,GAAW,iBAAA;AAEjB;;;;;;AAMC,IACM,SAASC,sBAAAA,CAAuBC,OAAAA,GAA8BC,MAAM,EAAA;AACvE,IAAA,MAAMC,QAAAA,GAAW,IAAA;QACb,MAAMC,QAAAA,GAAWH,QAAQE,QAAQ,CAACE,IAAI,CAACC,OAAO,CAAC,OAAA,EAAS,EAAA,CAAA;QACxD,OAAOF,QAAAA,CAASG,MAAM,GAAGH,QAAAA,GAAWI,SAAAA;AACxC,IAAA,CAAA;AACA,IAAA,MAAMC,OAAO,CAACC,GAAAA,GAA4B,CAAA,EAAGT,OAAAA,CAAQE,QAAQ,CAACQ,QAAQ,CAAA,EAAGV,OAAAA,CAAQE,QAAQ,CAACS,MAAM,CAAC,EAAE,EAAEF,OAAO,EAAA,CAAA,CAAI;AAChH,IAAA,MAAMG,MAAAA,GAAS,CAACC,KAAAA,GAAoBA,KAAAA,GAAwDf,QAAAA,CAAS;IAErG,OAAO;AACHI,QAAAA,QAAAA;AACAY,QAAAA,KAAAA,EAAO,IAAMF,MAAAA,CAAOZ,OAAAA,CAAQe,OAAO,CAACD,KAAK,CAAA;AACzCE,QAAAA,IAAAA,EAAMF,CAAAA,KAAAA,GAASd,OAAAA,CAAQe,OAAO,CAACE,SAAS,CAAC;AAAE,gBAAA,CAACnB,WAAWgB;aAAM,EAAG,EAAA,EAAIN,IAAAA,CAAKM,KAAAA,CAAML,GAAG,CAAA,CAAA;AAClFJ,QAAAA,OAAAA,EAASS,CAAAA,KAAAA,GAASd,OAAAA,CAAQe,OAAO,CAACG,YAAY,CAAC;AAAE,gBAAA,CAACpB,WAAWgB;aAAM,EAAG,EAAA,EAAIN,IAAAA,CAAKM,KAAAA,CAAML,GAAG,CAAA,CAAA;AACxFU,QAAAA,IAAAA,EAAM,IAAMnB,OAAAA,CAAQe,OAAO,CAACI,IAAI,EAAA;AAChCC,QAAAA,MAAAA,EAAQC,CAAAA,QAAAA,GAAAA;AACJ,YAAA,MAAMC,aAAa,CAACC,KAAAA,GAAyBF,SAASnB,QAAAA,EAAAA,EAAYU,MAAAA,CAAOW,MAAMT,KAAK,CAAA,CAAA;YACpF,MAAMU,YAAAA,GAAe,IAAMH,QAAAA,CAASnB,QAAAA,EAAAA,EAAYU,OAAOZ,OAAAA,CAAQe,OAAO,CAACD,KAAK,CAAA,CAAA;YAC5Ed,OAAAA,CAAQyB,gBAAgB,CAAC,UAAA,EAAYH,UAAAA,CAAAA;YACrCtB,OAAAA,CAAQyB,gBAAgB,CAAC,YAAA,EAAcD,YAAAA,CAAAA;YACvC,OAAO,IAAA;gBACHxB,OAAAA,CAAQ0B,mBAAmB,CAAC,UAAA,EAAYJ,UAAAA,CAAAA;gBACxCtB,OAAAA,CAAQ0B,mBAAmB,CAAC,YAAA,EAAcF,YAAAA,CAAAA;AAC9C,YAAA,CAAA;AACJ,QAAA;AACJ,KAAA;AACJ;;"}

package/dist/cjs/packages/PackageHostConfiguration.js

@@ -3,6 +3,7 @@
 var scene_engine = require('@cratis/scene.engine');
 var IconAdapterRegistry = require('../icons/IconAdapterRegistry.js');
 var ScenePackageBundle = require('./ScenePackageBundle.js');
+var isNetworkAsset = require('./isNetworkAsset.js');
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
@@ -41,8 +42,9 @@ var ScenePackageBundle = require('./ScenePackageBundle.js');
             diagnostics.push(`Package '${packageName}' provides executable design-time contributions, but host policy forbids them`);
         }
         const packageAssets = bundle.manifest.assets ?? [];
-        if (!configuration.policy.allowNetworkAssets && packageAssets.some((asset)=>/^https?:\/\//.test(asset))) {
-            diagnostics.push(`Package '${packageName}' declares network assets, but host policy forbids them`);
+        const networkAssets = packageAssets.filter(isNetworkAsset.isNetworkAsset);
+        if (!configuration.policy.allowNetworkAssets && networkAssets.length > 0) {
+            diagnostics.push(`Package '${packageName}' declares network assets (${networkAssets.join(', ')}), but host policy forbids them`);
         }
         assets.push(...packageAssets);
         for (const dependency of bundle.manifest.runtimeSingletons ?? []){
@@ -54,6 +56,18 @@ var ScenePackageBundle = require('./ScenePackageBundle.js');
         }
         bundles.push(bundle);
     }
+    const layouts = bundles.flatMap((bundle)=>bundle.layouts ?? []);
+    const themes = bundles.flatMap((bundle)=>bundle.themes ?? []);
+    const layout = configuration.profile.layout ? layouts.find((candidate)=>candidate.name === configuration.profile.layout) : undefined;
+    const theme = configuration.profile.theme ? themes.find((candidate)=>candidate.name === configuration.profile.theme) : undefined;
+    if (configuration.profile.layout && !layout) {
+        diagnostics.push(`UI profile '${configuration.profile.name}' uses layout '${configuration.profile.layout}', which no approved package provides`);
+    }
+    if (configuration.profile.theme && !theme) {
+        diagnostics.push(`UI profile '${configuration.profile.name}' uses theme '${configuration.profile.theme}', which no approved package provides`);
+    } else if (theme && scene_engine.incompatiblePackages(theme, configuration.profile).length > 0) {
+        diagnostics.push(`Theme '${theme.name}' is not compatible with ${scene_engine.incompatiblePackages(theme, configuration.profile).join(', ')} in UI profile '${configuration.profile.name}'`);
+    }
     const blocked = diagnostics.length > 0;
     const approved = blocked ? [] : bundles;
     const approvedAssets = blocked ? [] : assets;
@@ -64,6 +78,8 @@ var ScenePackageBundle = require('./ScenePackageBundle.js');
         screenTemplates: approved.flatMap((bundle)=>bundle.screenTemplates ?? []),
         dialogTemplates: approved.flatMap((bundle)=>bundle.dialogTemplates ?? []),
         themes: approved.flatMap((bundle)=>bundle.themes ?? []),
+        layout: blocked ? undefined : layout,
+        theme: blocked ? undefined : theme,
         templates: scene_engine.describeTemplateCatalog(approved, configuration.sceneVersion),
         icons: IconAdapterRegistry.createIconAdapterRegistry(approved.map((bundle)=>bundle.iconLibrary?.adapter).filter((adapter)=>adapter !== undefined)),
         assets: approvedAssets,

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

@@ -1 +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 { DialogTemplate, Layout, ScreenTemplate, Theme, UiProfile } from '@cratis/scene.model';\nimport { TemplateCatalogEntry, describeTemplateCatalog, resolvePackageDependencies } from '@cratis/scene.engine';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { ScenePackageBundle, mergePackageRegistries, validatePackageBundle } from './ScenePackageBundle';\n\nexport interface PackageHostPolicy {\n    allowExecutableImports: boolean;\n    allowNetworkAssets: boolean;\n\n    /** Whether this host is resolving optional design-time bundles in addition to runtime contributions. */\n    loadDesignTime?: boolean;\n}\n\nexport interface PackageHostConfiguration {\n    bundles: ScenePackageBundle[];\n    profile: UiProfile;\n    policy: PackageHostPolicy;\n\n    /** The Scene version the host runs, checked against each template's compatibility range when given. */\n    sceneVersion?: string;\n}\n\nexport interface ResolvedPackageHost {\n    bundles: ScenePackageBundle[];\n    components: ReturnType<typeof mergePackageRegistries>;\n    layouts: Layout[];\n    screenTemplates: ScreenTemplate[];\n    dialogTemplates: DialogTemplate[];\n    themes: Theme[];\n\n    /**\n     * Every template the approved packages provide, with compatibility, attribution and license metadata and\n     * whether it can be used with this package set. Template browsers read this rather than the raw lists.\n     */\n    templates: TemplateCatalogEntry[];\n    icons: IconAdapterRegistry;\n    assets: string[];\n    fonts: string[];\n    blocked: boolean;\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 names = new Map<string, number>();\n    for (const bundle of configuration.bundles) {\n        names.set(bundle.manifest.name, (names.get(bundle.manifest.name) ?? 0) + 1);\n    }\n\n    for (const [name, count] of names) {\n        if (count > 1) diagnostics.push(`Package '${name}' is approved more than once; duplicate bundles are ambiguous`);\n    }\n\n    const byName = new Map(configuration.bundles.map(bundle => [bundle.manifest.name, bundle]));\n    const selection = resolvePackageDependencies(configuration.profile.packages, configuration.bundles.map(bundle => bundle.manifest));\n    for (const missing of selection.missing) diagnostics.push(`Package '${missing.package}' depends on missing package '${missing.dependsOn}'`);\n    for (const conflict of selection.versionConflicts) {\n        diagnostics.push(`Package '${conflict.package}' requires '${conflict.dependsOn}' ${conflict.requiredRange} but approved version is ${conflict.actualVersion}`);\n    }\n    for (const cycle of selection.cycles) diagnostics.push(`Package dependency cycle: ${cycle.join(' -> ')}`);\n\n    const bundles: ScenePackageBundle[] = [];\n    const runtimeSingletons = new Map<string, string>();\n    const assets: string[] = [];\n\n    for (const packageName of selection.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        diagnostics.push(...validatePackageBundle(bundle).map(problem => `${packageName}: ${problem}`));\n        if (configuration.policy.loadDesignTime === true && !configuration.policy.allowExecutableImports && bundle.designTime) {\n            diagnostics.push(`Package '${packageName}' provides executable design-time contributions, but host policy forbids them`);\n        }\n\n        const packageAssets = bundle.manifest.assets ?? [];\n        if (!configuration.policy.allowNetworkAssets && packageAssets.some(asset => /^https?:\\/\\//.test(asset))) {\n            diagnostics.push(`Package '${packageName}' declares network assets, but host policy forbids them`);\n        }\n        assets.push(...packageAssets);\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    const blocked = diagnostics.length > 0;\n    const approved = blocked ? [] : bundles;\n    const approvedAssets = blocked ? [] : assets;\n\n    return {\n        bundles: approved,\n        components: mergePackageRegistries(approved),\n        layouts: approved.flatMap(bundle => bundle.layouts ?? []),\n        screenTemplates: approved.flatMap(bundle => bundle.screenTemplates ?? []),\n        dialogTemplates: approved.flatMap(bundle => bundle.dialogTemplates ?? []),\n        themes: approved.flatMap(bundle => bundle.themes ?? []),\n        templates: describeTemplateCatalog(approved, configuration.sceneVersion),\n        icons: createIconAdapterRegistry(approved.map(bundle => bundle.iconLibrary?.adapter).filter(adapter => adapter !== undefined)),\n        assets: approvedAssets,\n        fonts: approvedAssets.filter(isFontAsset),\n        blocked,\n        diagnostics,\n    };\n}\n\nfunction isFontAsset(asset: string): boolean {\n    return /\\.(woff2?|otf|ttf)(\\?|$)/.test(asset) || asset.includes('/fonts/');\n}\n"],"names":["resolvePackageHost","configuration","diagnostics","names","Map","bundle","bundles","set","manifest","name","get","count","push","byName","map","selection","resolvePackageDependencies","profile","packages","missing","package","dependsOn","conflict","versionConflicts","requiredRange","actualVersion","cycle","cycles","join","runtimeSingletons","assets","packageName","validatePackageBundle","problem","policy","loadDesignTime","allowExecutableImports","designTime","packageAssets","allowNetworkAssets","some","asset","test","dependency","owner","blocked","length","approved","approvedAssets","components","mergePackageRegistries","layouts","flatMap","screenTemplates","dialogTemplates","themes","templates","describeTemplateCatalog","sceneVersion","icons","createIconAdapterRegistry","iconLibrary","adapter","filter","undefined","fonts","isFontAsset","includes"],"mappings":"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"}
+{"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 { DialogTemplate, Layout, ScreenTemplate, Theme, UiProfile } from '@cratis/scene.model';\nimport { TemplateCatalogEntry, describeTemplateCatalog, incompatiblePackages, resolvePackageDependencies } from '@cratis/scene.engine';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { ScenePackageBundle, mergePackageRegistries, validatePackageBundle } from './ScenePackageBundle';\nimport { isNetworkAsset } from './isNetworkAsset';\n\nexport interface PackageHostPolicy {\n    allowExecutableImports: boolean;\n    allowNetworkAssets: boolean;\n\n    /** Whether this host is resolving optional design-time bundles in addition to runtime contributions. */\n    loadDesignTime?: boolean;\n}\n\nexport interface PackageHostConfiguration {\n    bundles: ScenePackageBundle[];\n    profile: UiProfile;\n    policy: PackageHostPolicy;\n\n    /** The Scene version the host runs, checked against each template's compatibility range when given. */\n    sceneVersion?: string;\n}\n\nexport interface ResolvedPackageHost {\n    bundles: ScenePackageBundle[];\n    components: ReturnType<typeof mergePackageRegistries>;\n    layouts: Layout[];\n    screenTemplates: ScreenTemplate[];\n    dialogTemplates: DialogTemplate[];\n    themes: Theme[];\n\n    /** The layout the UI profile names, from the approved packages. Absent when the profile names none. */\n    layout?: Layout;\n\n    /** The theme the UI profile names, from the approved packages. Absent when the profile names none. */\n    theme?: Theme;\n\n    /**\n     * Every template the approved packages provide, with compatibility, attribution and license metadata and\n     * whether it can be used with this package set. Template browsers read this rather than the raw lists.\n     */\n    templates: TemplateCatalogEntry[];\n    icons: IconAdapterRegistry;\n    assets: string[];\n    fonts: string[];\n    blocked: boolean;\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 names = new Map<string, number>();\n    for (const bundle of configuration.bundles) {\n        names.set(bundle.manifest.name, (names.get(bundle.manifest.name) ?? 0) + 1);\n    }\n\n    for (const [name, count] of names) {\n        if (count > 1) diagnostics.push(`Package '${name}' is approved more than once; duplicate bundles are ambiguous`);\n    }\n\n    const byName = new Map(configuration.bundles.map(bundle => [bundle.manifest.name, bundle]));\n    const selection = resolvePackageDependencies(configuration.profile.packages, configuration.bundles.map(bundle => bundle.manifest));\n    for (const missing of selection.missing) diagnostics.push(`Package '${missing.package}' depends on missing package '${missing.dependsOn}'`);\n    for (const conflict of selection.versionConflicts) {\n        diagnostics.push(`Package '${conflict.package}' requires '${conflict.dependsOn}' ${conflict.requiredRange} but approved version is ${conflict.actualVersion}`);\n    }\n    for (const cycle of selection.cycles) diagnostics.push(`Package dependency cycle: ${cycle.join(' -> ')}`);\n\n    const bundles: ScenePackageBundle[] = [];\n    const runtimeSingletons = new Map<string, string>();\n    const assets: string[] = [];\n\n    for (const packageName of selection.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        diagnostics.push(...validatePackageBundle(bundle).map(problem => `${packageName}: ${problem}`));\n        if (configuration.policy.loadDesignTime === true && !configuration.policy.allowExecutableImports && bundle.designTime) {\n            diagnostics.push(`Package '${packageName}' provides executable design-time contributions, but host policy forbids them`);\n        }\n\n        const packageAssets = bundle.manifest.assets ?? [];\n        const networkAssets = packageAssets.filter(isNetworkAsset);\n        if (!configuration.policy.allowNetworkAssets && networkAssets.length > 0) {\n            diagnostics.push(`Package '${packageName}' declares network assets (${networkAssets.join(', ')}), but host policy forbids them`);\n        }\n        assets.push(...packageAssets);\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    const layouts = bundles.flatMap(bundle => bundle.layouts ?? []);\n    const themes = bundles.flatMap(bundle => bundle.themes ?? []);\n    const layout = configuration.profile.layout ? layouts.find(candidate => candidate.name === configuration.profile.layout) : undefined;\n    const theme = configuration.profile.theme ? themes.find(candidate => candidate.name === configuration.profile.theme) : undefined;\n    if (configuration.profile.layout && !layout) {\n        diagnostics.push(`UI profile '${configuration.profile.name}' uses layout '${configuration.profile.layout}', which no approved package provides`);\n    }\n    if (configuration.profile.theme && !theme) {\n        diagnostics.push(`UI profile '${configuration.profile.name}' uses theme '${configuration.profile.theme}', which no approved package provides`);\n    } else if (theme && incompatiblePackages(theme, configuration.profile).length > 0) {\n        diagnostics.push(`Theme '${theme.name}' is not compatible with ${incompatiblePackages(theme, configuration.profile).join(', ')} in UI profile '${configuration.profile.name}'`);\n    }\n\n    const blocked = diagnostics.length > 0;\n    const approved = blocked ? [] : bundles;\n    const approvedAssets = blocked ? [] : assets;\n\n    return {\n        bundles: approved,\n        components: mergePackageRegistries(approved),\n        layouts: approved.flatMap(bundle => bundle.layouts ?? []),\n        screenTemplates: approved.flatMap(bundle => bundle.screenTemplates ?? []),\n        dialogTemplates: approved.flatMap(bundle => bundle.dialogTemplates ?? []),\n        themes: approved.flatMap(bundle => bundle.themes ?? []),\n        layout: blocked ? undefined : layout,\n        theme: blocked ? undefined : theme,\n        templates: describeTemplateCatalog(approved, configuration.sceneVersion),\n        icons: createIconAdapterRegistry(approved.map(bundle => bundle.iconLibrary?.adapter).filter(adapter => adapter !== undefined)),\n        assets: approvedAssets,\n        fonts: approvedAssets.filter(isFontAsset),\n        blocked,\n        diagnostics,\n    };\n}\n\nfunction isFontAsset(asset: string): boolean {\n    return /\\.(woff2?|otf|ttf)(\\?|$)/.test(asset) || asset.includes('/fonts/');\n}\n"],"names":["resolvePackageHost","configuration","diagnostics","names","Map","bundle","bundles","set","manifest","name","get","count","push","byName","map","selection","resolvePackageDependencies","profile","packages","missing","package","dependsOn","conflict","versionConflicts","requiredRange","actualVersion","cycle","cycles","join","runtimeSingletons","assets","packageName","validatePackageBundle","problem","policy","loadDesignTime","allowExecutableImports","designTime","packageAssets","networkAssets","filter","isNetworkAsset","allowNetworkAssets","length","dependency","owner","layouts","flatMap","themes","layout","find","candidate","undefined","theme","incompatiblePackages","blocked","approved","approvedAssets","components","mergePackageRegistries","screenTemplates","dialogTemplates","templates","describeTemplateCatalog","sceneVersion","icons","createIconAdapterRegistry","iconLibrary","adapter","fonts","isFontAsset","asset","test","includes"],"mappings":"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"}

package/dist/cjs/packages/isNetworkAsset.js

@@ -0,0 +1,18 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Whether loading an asset reaches beyond the host: an absolute URL with any scheme other than `data:`
+ * or `blob:` (`https://`, `http://`, `ws://`, `ftp://`), or a protocol-relative `//host/...` reference. A
+ * package-relative path or a bare module specifier such as `@cratis/components/styles` is resolved by the
+ * host from what it bundled, so it is not a network asset.
+ */ function isNetworkAsset(asset) {
+    const trimmed = asset.trim();
+    if (trimmed.startsWith('//')) return true;
+    const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):/.exec(trimmed)?.[1]?.toLowerCase();
+    return scheme !== undefined && scheme !== 'data' && scheme !== 'blob';
+}
+
+exports.isNetworkAsset = isNetworkAsset;
+//# sourceMappingURL=isNetworkAsset.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isNetworkAsset.js","sources":["../../../packages/isNetworkAsset.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 * Whether loading an asset reaches beyond the host: an absolute URL with any scheme other than `data:`\n * or `blob:` (`https://`, `http://`, `ws://`, `ftp://`), or a protocol-relative `//host/...` reference. A\n * package-relative path or a bare module specifier such as `@cratis/components/styles` is resolved by the\n * host from what it bundled, so it is not a network asset.\n */\nexport function isNetworkAsset(asset: string): boolean {\n    const trimmed = asset.trim();\n    if (trimmed.startsWith('//')) return true;\n    const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):/.exec(trimmed)?.[1]?.toLowerCase();\n    return scheme !== undefined && scheme !== 'data' && scheme !== 'blob';\n}\n"],"names":["isNetworkAsset","asset","trimmed","trim","startsWith","scheme","exec","toLowerCase","undefined"],"mappings":";;AAAA;AACA;AAEA;;;;;IAMO,SAASA,cAAAA,CAAeC,KAAa,EAAA;IACxC,MAAMC,OAAAA,GAAUD,MAAME,IAAI,EAAA;AAC1B,IAAA,IAAID,OAAAA,CAAQE,UAAU,CAAC,IAAA,CAAA,EAAO,OAAO,IAAA;AACrC,IAAA,MAAMC,SAAS,6BAAA,CAA8BC,IAAI,CAACJ,OAAAA,CAAAA,GAAW,EAAE,EAAEK,WAAAA,EAAAA;AACjE,IAAA,OAAOF,MAAAA,KAAWG,SAAAA,IAAaH,MAAAA,KAAW,MAAA,IAAUA,MAAAA,KAAW,MAAA;AACnE;;"}

package/dist/cjs/renderer/RenderBindingScopeContext.js

@@ -9,10 +9,16 @@ var BindingOutputContext = require('./BindingOutputContext.js');
 const Context = /*#__PURE__*/ react.createContext(undefined);
 /**
  * Provides the inherited reactive binding scope for a rendered Scene tree.
+ *
+ * The outermost provider owns the component output scope. A provider rendered inside another - a nested
+ * template or region - nests its own data context, query results and component outputs over the inherited
+ * scope with `nestBindingScope`, so a detail region bound to the selected row reads that row while still
+ * seeing the screen's queries and every component's outputs.
  */ function RenderBindingScopeProvider(props) {
     const current = react.useContext(Context);
-    if (current) return /*#__PURE__*/ jsxRuntime.jsx(jsxRuntime.Fragment, {
-        children: props.children
+    if (current) return /*#__PURE__*/ jsxRuntime.jsx(RenderBindingScopeInner, {
+        ...props,
+        parent: current.scope
     });
     return /*#__PURE__*/ jsxRuntime.jsx(BindingOutputContext.BindingOutputProvider, {
         onOutputsChanged: props.onComponentOutputsChanged,
@@ -21,20 +27,24 @@ const Context = /*#__PURE__*/ react.createContext(undefined);
         })
     });
 }
-function RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding }) {
+function RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding, parent }) {
     const outputs = BindingOutputContext.useBindingOutputScope();
     const previousValues = react.useRef(new Map());
-    const scope = react.useMemo(()=>({
+    const scope = react.useMemo(()=>{
+        const own = {
             dataContext,
             queryResults,
             componentOutputs: {
                 ...componentOutputs ?? {},
                 ...outputs
             }
-        }), [
+        };
+        return parent ? scene_engine.nestBindingScope(parent, own) : own;
+    }, [
         componentOutputs,
         dataContext,
         outputs,
+        parent,
         queryResults
     ]);
     const resolver = react.useCallback((binding)=>{

package/dist/cjs/renderer/RenderBindingScopeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderBindingScopeContext.js","sources":["../../../renderer/RenderBindingScopeContext.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, useMemo, useRef } from 'react';\nimport { BindingResolver, BindingScope, resolveBindingExpression } from '@cratis/scene.engine';\nimport { BindingExpression, BindingNullBehavior } from '@cratis/scene.model';\nimport { BindingOutputProvider, useBindingOutputScope } from './BindingOutputContext';\n\ninterface RenderBindingScopeValue {\n    resolveBinding: BindingResolver;\n    scope: BindingScope;\n}\n\nconst Context = createContext<RenderBindingScopeValue | undefined>(undefined);\n\nexport interface RenderBindingScopeProviderProps {\n    children: ReactNode;\n    dataContext?: unknown;\n    queryResults?: Record<string, unknown>;\n    componentOutputs?: Record<string, Record<string, unknown>>;\n    resolveBinding?: BindingResolver;\n    onComponentOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Provides the inherited reactive binding scope for a rendered Scene tree.\n */\nexport function RenderBindingScopeProvider(props: RenderBindingScopeProviderProps) {\n    const current = useContext(Context);\n    if (current) return <>{props.children}</>;\n\n    return (\n        <BindingOutputProvider onOutputsChanged={props.onComponentOutputsChanged}>\n            <RenderBindingScopeInner {...props} />\n        </BindingOutputProvider>\n    );\n}\n\nfunction RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding }: RenderBindingScopeProviderProps) {\n    const outputs = useBindingOutputScope();\n    const previousValues = useRef(new Map<string, unknown>());\n    const scope = useMemo<BindingScope>(() => ({\n        dataContext,\n        queryResults,\n        componentOutputs: { ...(componentOutputs ?? {}), ...outputs },\n    }), [componentOutputs, dataContext, outputs, queryResults]);\n\n    const resolver = useCallback<BindingResolver>((binding: BindingExpression) => {\n        if (!binding.kind && resolveBinding) return resolveBinding(binding);\n\n        const key = JSON.stringify(binding);\n        const value = resolveBindingExpression(binding, scope);\n        if (binding.nullBehavior === BindingNullBehavior.Preserve && value === undefined) {\n            return previousValues.current.get(key);\n        }\n\n        if (value !== undefined) previousValues.current.set(key, value);\n        return value;\n    }, [resolveBinding, scope]);\n\n    const value = useMemo<RenderBindingScopeValue>(() => ({ resolveBinding: resolver, scope }), [resolver, scope]);\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useRenderBindingResolver(): BindingResolver {\n    const context = useContext(Context);\n    if (!context) throw new Error('No Scene render binding scope is available.');\n    return context.resolveBinding;\n}\n\nexport function useRenderBindingScope(): BindingScope {\n    return useContext(Context)?.scope ?? {};\n}\n"],"names":["Context","createContext","undefined","RenderBindingScopeProvider","props","current","useContext","_jsx","_Fragment","children","BindingOutputProvider","onOutputsChanged","onComponentOutputsChanged","RenderBindingScopeInner","dataContext","queryResults","componentOutputs","resolveBinding","outputs","useBindingOutputScope","previousValues","useRef","Map","scope","useMemo","resolver","useCallback","binding","kind","key","JSON","stringify","value","resolveBindingExpression","nullBehavior","BindingNullBehavior","Preserve","get","set","Provider","useRenderBindingResolver","context","Error","useRenderBindingScope"],"mappings":";;;;;;;;AAaA,MAAMA,wBAAUC,mBAAAA,CAAmDC,SAAAA,CAAAA;AAWnE;;IAGO,SAASC,0BAAAA,CAA2BC,KAAsC,EAAA;AAC7E,IAAA,MAAMC,UAAUC,gBAAAA,CAAWN,OAAAA,CAAAA;AAC3B,IAAA,IAAIK,SAAS,qBAAOE,cAAA,CAAAC,mBAAA,EAAA;AAAGJ,QAAAA,QAAAA,EAAAA,KAAAA,CAAMK;;AAE7B,IAAA,qBACIF,cAAA,CAACG,0CAAAA,EAAAA;AAAsBC,QAAAA,gBAAAA,EAAkBP,MAAMQ,yBAAyB;AACpE,QAAA,QAAA,gBAAAL,cAAA,CAACM,uBAAAA,EAAAA;AAAyB,YAAA,GAAGT;;;AAGzC;AAEA,SAASS,uBAAAA,CAAwB,EAAEJ,QAAQ,EAAEK,WAAW,EAAEC,YAAY,EAAEC,gBAAgB,EAAEC,cAAc,EAAmC,EAAA;AACvI,IAAA,MAAMC,OAAAA,GAAUC,0CAAAA,EAAAA;IAChB,MAAMC,cAAAA,GAAiBC,aAAO,IAAIC,GAAAA,EAAAA,CAAAA;IAClC,MAAMC,KAAAA,GAAQC,aAAAA,CAAsB,KAAO;AACvCV,YAAAA,WAAAA;AACAC,YAAAA,YAAAA;YACAC,gBAAAA,EAAkB;gBAAE,GAAIA,gBAAAA,IAAoB,EAAE;AAAG,gBAAA,GAAGE;AAAQ;AAChE,SAAA,CAAA,EAAI;AAACF,QAAAA,gBAAAA;AAAkBF,QAAAA,WAAAA;AAAaI,QAAAA,OAAAA;AAASH,QAAAA;AAAa,KAAA,CAAA;IAE1D,MAAMU,QAAAA,GAAWC,kBAA6B,CAACC,OAAAA,GAAAA;AAC3C,QAAA,IAAI,CAACA,OAAAA,CAAQC,IAAI,IAAIX,cAAAA,EAAgB,OAAOA,cAAAA,CAAeU,OAAAA,CAAAA;QAE3D,MAAME,GAAAA,GAAMC,IAAAA,CAAKC,SAAS,CAACJ,OAAAA,CAAAA;QAC3B,MAAMK,KAAAA,GAAQC,sCAAyBN,OAAAA,EAASJ,KAAAA,CAAAA;AAChD,QAAA,IAAII,QAAQO,YAAY,KAAKC,gCAAoBC,QAAQ,IAAIJ,UAAU9B,SAAAA,EAAW;AAC9E,YAAA,OAAOkB,cAAAA,CAAef,OAAO,CAACgC,GAAG,CAACR,GAAAA,CAAAA;AACtC,QAAA;AAEA,QAAA,IAAIG,UAAU9B,SAAAA,EAAWkB,cAAAA,CAAef,OAAO,CAACiC,GAAG,CAACT,GAAAA,EAAKG,KAAAA,CAAAA;QACzD,OAAOA,KAAAA;IACX,CAAA,EAAG;AAACf,QAAAA,cAAAA;AAAgBM,QAAAA;AAAM,KAAA,CAAA;IAE1B,MAAMS,KAAAA,GAAQR,aAAAA,CAAiC,KAAO;YAAEP,cAAAA,EAAgBQ,QAAAA;AAAUF,YAAAA;AAAM,SAAA,CAAA,EAAI;AAACE,QAAAA,QAAAA;AAAUF,QAAAA;AAAM,KAAA,CAAA;IAC7G,qBAAOhB,cAAA,CAACP,QAAQuC,QAAQ,EAAA;QAACP,KAAAA,EAAOA,KAAAA;AAAQvB,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAAS+B,wBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAUnC,gBAAAA,CAAWN,OAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACyC,OAAAA,EAAS,MAAM,IAAIC,KAAAA,CAAM,6CAAA,CAAA;AAC9B,IAAA,OAAOD,QAAQxB,cAAc;AACjC;AAEO,SAAS0B,qBAAAA,GAAAA;IACZ,OAAOrC,gBAAAA,CAAWN,OAAAA,CAAAA,EAAUuB,KAAAA,IAAS,EAAC;AAC1C;;;;"}
+{"version":3,"file":"RenderBindingScopeContext.js","sources":["../../../renderer/RenderBindingScopeContext.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, useMemo, useRef } from 'react';\nimport { BindingResolver, BindingScope, nestBindingScope, resolveBindingExpression } from '@cratis/scene.engine';\nimport { BindingExpression, BindingNullBehavior } from '@cratis/scene.model';\nimport { BindingOutputProvider, useBindingOutputScope } from './BindingOutputContext';\n\ninterface RenderBindingScopeValue {\n    resolveBinding: BindingResolver;\n    scope: BindingScope;\n}\n\nconst Context = createContext<RenderBindingScopeValue | undefined>(undefined);\n\nexport interface RenderBindingScopeProviderProps {\n    children: ReactNode;\n    dataContext?: unknown;\n    queryResults?: Record<string, unknown>;\n    componentOutputs?: Record<string, Record<string, unknown>>;\n    resolveBinding?: BindingResolver;\n    onComponentOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Provides the inherited reactive binding scope for a rendered Scene tree.\n *\n * The outermost provider owns the component output scope. A provider rendered inside another - a nested\n * template or region - nests its own data context, query results and component outputs over the inherited\n * scope with `nestBindingScope`, so a detail region bound to the selected row reads that row while still\n * seeing the screen's queries and every component's outputs.\n */\nexport function RenderBindingScopeProvider(props: RenderBindingScopeProviderProps) {\n    const current = useContext(Context);\n    if (current) return <RenderBindingScopeInner {...props} parent={current.scope} />;\n\n    return (\n        <BindingOutputProvider onOutputsChanged={props.onComponentOutputsChanged}>\n            <RenderBindingScopeInner {...props} />\n        </BindingOutputProvider>\n    );\n}\n\nfunction RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding, parent }: RenderBindingScopeProviderProps & { parent?: BindingScope }) {\n    const outputs = useBindingOutputScope();\n    const previousValues = useRef(new Map<string, unknown>());\n    const scope = useMemo<BindingScope>(() => {\n        const own = { dataContext, queryResults, componentOutputs: { ...(componentOutputs ?? {}), ...outputs } };\n        return parent ? nestBindingScope(parent, own) : own;\n    }, [componentOutputs, dataContext, outputs, parent, queryResults]);\n\n    const resolver = useCallback<BindingResolver>((binding: BindingExpression) => {\n        if (!binding.kind && resolveBinding) return resolveBinding(binding);\n\n        const key = JSON.stringify(binding);\n        const value = resolveBindingExpression(binding, scope);\n        if (binding.nullBehavior === BindingNullBehavior.Preserve && value === undefined) {\n            return previousValues.current.get(key);\n        }\n\n        if (value !== undefined) previousValues.current.set(key, value);\n        return value;\n    }, [resolveBinding, scope]);\n\n    const value = useMemo<RenderBindingScopeValue>(() => ({ resolveBinding: resolver, scope }), [resolver, scope]);\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useRenderBindingResolver(): BindingResolver {\n    const context = useContext(Context);\n    if (!context) throw new Error('No Scene render binding scope is available.');\n    return context.resolveBinding;\n}\n\nexport function useRenderBindingScope(): BindingScope {\n    return useContext(Context)?.scope ?? {};\n}\n"],"names":["Context","createContext","undefined","RenderBindingScopeProvider","props","current","useContext","_jsx","RenderBindingScopeInner","parent","scope","BindingOutputProvider","onOutputsChanged","onComponentOutputsChanged","children","dataContext","queryResults","componentOutputs","resolveBinding","outputs","useBindingOutputScope","previousValues","useRef","Map","useMemo","own","nestBindingScope","resolver","useCallback","binding","kind","key","JSON","stringify","value","resolveBindingExpression","nullBehavior","BindingNullBehavior","Preserve","get","set","Provider","useRenderBindingResolver","context","Error","useRenderBindingScope"],"mappings":"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"}

package/dist/cjs/renderer/useBoundQuery.js

@@ -0,0 +1,50 @@
+'use strict';
+
+var react = require('react');
+var scene_engine = require('@cratis/scene.engine');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Runs a bound query whenever its arguments change and returns the accepted query results.
+ *
+ * Each change of arguments rebinds the query: the previous run is aborted and, should its answer still
+ * arrive, discarded by `QueryBindingState` - a slow result for a previous selection never replaces the
+ * current one. Arguments of `undefined` mean the binding is cleared, as when a selection is cleared, so the
+ * result is removed, and so is it when the current run fails - a failed rebind must not leave the previous
+ * selection's data on screen. The results are keyed by `query`, ready to pass as a scope's `queryResults`.
+ */ function useBoundQuery(query, argumentsValue, perform) {
+    const state = react.useMemo(()=>new scene_engine.QueryBindingState(), []);
+    const [results, setResults] = react.useState({});
+    const key = argumentsValue === undefined ? undefined : JSON.stringify(argumentsValue);
+    const latestArguments = react.useRef(argumentsValue);
+    latestArguments.current = argumentsValue;
+    // The arguments are compared by value through `key`; the effect reads them from `latestArguments`.
+    react.useEffect(()=>{
+        const argumentsForRun = latestArguments.current;
+        if (argumentsForRun === undefined) {
+            state.clear(query);
+            setResults(state.queryResults);
+            return undefined;
+        }
+        const controller = new AbortController();
+        const ticket = state.begin(query);
+        perform(query, argumentsForRun, controller.signal).then((result)=>{
+            if (state.complete(ticket, result)) setResults(state.queryResults);
+        }, ()=>{
+            if (controller.signal.aborted || !state.complete(ticket, undefined)) return;
+            state.clear(query);
+            setResults(state.queryResults);
+        });
+        return ()=>controller.abort();
+    }, [
+        key,
+        perform,
+        query,
+        state
+    ]);
+    return results;
+}
+
+exports.useBoundQuery = useBoundQuery;
+//# sourceMappingURL=useBoundQuery.js.map

package/dist/cjs/renderer/useBoundQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoundQuery.js","sources":["../../../renderer/useBoundQuery.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { QueryBindingState } from '@cratis/scene.engine';\nimport { QueryPerformer } from './AbortableQueryRunner';\n\n/**\n * Runs a bound query whenever its arguments change and returns the accepted query results.\n *\n * Each change of arguments rebinds the query: the previous run is aborted and, should its answer still\n * arrive, discarded by `QueryBindingState` - a slow result for a previous selection never replaces the\n * current one. Arguments of `undefined` mean the binding is cleared, as when a selection is cleared, so the\n * result is removed, and so is it when the current run fails - a failed rebind must not leave the previous\n * selection's data on screen. The results are keyed by `query`, ready to pass as a scope's `queryResults`.\n */\nexport function useBoundQuery(query: string, argumentsValue: unknown, perform: QueryPerformer): Record<string, unknown> {\n    const state = useMemo(() => new QueryBindingState(), []);\n    const [results, setResults] = useState<Record<string, unknown>>({});\n    const key = argumentsValue === undefined ? undefined : JSON.stringify(argumentsValue);\n    const latestArguments = useRef(argumentsValue);\n    latestArguments.current = argumentsValue;\n\n    // The arguments are compared by value through `key`; the effect reads them from `latestArguments`.\n    useEffect(() => {\n        const argumentsForRun = latestArguments.current;\n        if (argumentsForRun === undefined) {\n            state.clear(query);\n            setResults(state.queryResults);\n            return undefined;\n        }\n\n        const controller = new AbortController();\n        const ticket = state.begin(query);\n        perform(query, argumentsForRun, controller.signal).then(\n            result => {\n                if (state.complete(ticket, result)) setResults(state.queryResults);\n            },\n            () => {\n                if (controller.signal.aborted || !state.complete(ticket, undefined)) return;\n                state.clear(query);\n                setResults(state.queryResults);\n            },\n        );\n\n        return () => controller.abort();\n    }, [key, perform, query, state]);\n\n    return results;\n}\n"],"names":["useBoundQuery","query","argumentsValue","perform","state","useMemo","QueryBindingState","results","setResults","useState","key","undefined","JSON","stringify","latestArguments","useRef","current","useEffect","argumentsForRun","clear","queryResults","controller","AbortController","ticket","begin","signal","then","result","complete","aborted","abort"],"mappings":";;;;;AAAA;AACA;AAMA;;;;;;;;AAQC,IACM,SAASA,aAAAA,CAAcC,KAAa,EAAEC,cAAuB,EAAEC,OAAuB,EAAA;AACzF,IAAA,MAAMC,KAAAA,GAAQC,aAAAA,CAAQ,IAAM,IAAIC,kCAAqB,EAAE,CAAA;AACvD,IAAA,MAAM,CAACC,OAAAA,EAASC,UAAAA,CAAW,GAAGC,eAAkC,EAAC,CAAA;AACjE,IAAA,MAAMC,MAAMR,cAAAA,KAAmBS,SAAAA,GAAYA,SAAAA,GAAYC,IAAAA,CAAKC,SAAS,CAACX,cAAAA,CAAAA;AACtE,IAAA,MAAMY,kBAAkBC,YAAAA,CAAOb,cAAAA,CAAAA;AAC/BY,IAAAA,eAAAA,CAAgBE,OAAO,GAAGd,cAAAA;;IAG1Be,eAAAA,CAAU,IAAA;QACN,MAAMC,eAAAA,GAAkBJ,gBAAgBE,OAAO;AAC/C,QAAA,IAAIE,oBAAoBP,SAAAA,EAAW;AAC/BP,YAAAA,KAAAA,CAAMe,KAAK,CAAClB,KAAAA,CAAAA;AACZO,YAAAA,UAAAA,CAAWJ,MAAMgB,YAAY,CAAA;YAC7B,OAAOT,SAAAA;AACX,QAAA;AAEA,QAAA,MAAMU,aAAa,IAAIC,eAAAA,EAAAA;QACvB,MAAMC,MAAAA,GAASnB,KAAAA,CAAMoB,KAAK,CAACvB,KAAAA,CAAAA;AAC3BE,QAAAA,OAAAA,CAAQF,OAAOiB,eAAAA,EAAiBG,UAAAA,CAAWI,MAAM,CAAA,CAAEC,IAAI,CACnDC,CAAAA,MAAAA,GAAAA;AACI,YAAA,IAAIvB,MAAMwB,QAAQ,CAACL,QAAQI,MAAAA,CAAAA,EAASnB,UAAAA,CAAWJ,MAAMgB,YAAY,CAAA;QACrE,CAAA,EACA,IAAA;YACI,IAAIC,UAAAA,CAAWI,MAAM,CAACI,OAAO,IAAI,CAACzB,KAAAA,CAAMwB,QAAQ,CAACL,MAAAA,EAAQZ,SAAAA,CAAAA,EAAY;AACrEP,YAAAA,KAAAA,CAAMe,KAAK,CAAClB,KAAAA,CAAAA;AACZO,YAAAA,UAAAA,CAAWJ,MAAMgB,YAAY,CAAA;AACjC,QAAA,CAAA,CAAA;QAGJ,OAAO,IAAMC,WAAWS,KAAK,EAAA;IACjC,CAAA,EAAG;AAACpB,QAAAA,GAAAA;AAAKP,QAAAA,OAAAA;AAASF,QAAAA,KAAAA;AAAOG,QAAAA;AAAM,KAAA,CAAA;IAE/B,OAAOG,OAAAA;AACX;;"}