@cratis/scene.react 4.13.0 → 4.15.0

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;;"}

package/dist/esm/core/coreComponents.js

@@ -1,7 +1,7 @@
 import 'react/jsx-runtime';
 import 'react';
-import '@cratis/scene.model';
 import '@cratis/scene.engine';
+import '@cratis/scene.model';
 import '../interactions/useInteractions.js';
 import '../interactions/NotificationHost.js';
 import { componentRegistryKey } from '../packages/ScenePackageBundle.js';

package/dist/esm/index.js

@@ -3,6 +3,7 @@ export { AbortableQueryRunner } from './renderer/AbortableQueryRunner.js';
 export { BindingOutputProvider, useBindingOutputScope, useBindingOutputs } from './renderer/BindingOutputContext.js';
 export { RenderBindingScopeProvider, useRenderBindingResolver, useRenderBindingScope } from './renderer/RenderBindingScopeContext.js';
 export { UnresolvedComponent } from './renderer/UnresolvedComponent.js';
+export { useBoundQuery } from './renderer/useBoundQuery.js';
 export { createReactRenderer } from './renderer/createReactRenderer.js';
 export { InteractiveComponent } from './renderer/InteractiveComponent.js';
 export { CoreText } from './core/CoreText.js';
@@ -17,10 +18,15 @@ export { NavBar } from './NavBar/NavBar.js';
 export { extractNavigationItem } from './NavBar/extractNavigationItem.js';
 export { SceneNavigationProvider, useSceneNavigation } from './navigation/SceneNavigationContext.js';
 export { SceneNavigationHost } from './navigation/SceneNavigationHost.js';
-export { resolveDestination } from './navigation/resolveDestination.js';
+export { createBrowserSceneHistory } from './navigation/createBrowserSceneHistory.js';
+export { createMemorySceneHistory } from './navigation/createMemorySceneHistory.js';
 export { diagnoseRenderedNavigation } from './navigation/diagnoseRenderedNavigation.js';
 export { identityRoute } from './navigation/identityRoute.js';
+export { matchSceneRoute } from './navigation/matchSceneRoute.js';
 export { navigationRouteKey } from './navigation/navigationRouteKey.js';
+export { resolveDestination } from './navigation/resolveDestination.js';
+export { sceneRoutesFrom } from './navigation/sceneRoutesFrom.js';
+export { useSceneHistoryNavigation } from './navigation/useSceneHistoryNavigation.js';
 export { IconAdapterRegistry, createIconAdapterRegistry } from './icons/IconAdapterRegistry.js';
 export { IconAdapterProvider, useIconAdapters } from './icons/IconAdapterContext.js';
 export { useIconGlyph } from './icons/useIconGlyph.js';
@@ -31,6 +37,7 @@ export { DesignTimeExtensionPoint, designTimeExtensionPointLabels } from './pack
 export { DesignTimeProvider, useDesignTimeContext } from './packages/DesignTimeProvider.js';
 export { EmbeddedPackageHost } from './packages/EmbeddedPackageHost.js';
 export { loadDesignTimeContributions } from './packages/loadDesignTimeContributions.js';
+export { isNetworkAsset } from './packages/isNetworkAsset.js';
 export { PackageHostAssets } from './packages/PackageHostAssets.js';
 export { resolvePackageHost } from './packages/PackageHostConfiguration.js';
 export { PackageHostRenderMode } from './packages/PackageHostRenderMode.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/navigation/DestinationResolution.d.ts

@@ -4,6 +4,7 @@ export interface DestinationResolution {
     url?: string;
     outlet?: string;
     dialog?: string;
+    parameters: Record<string, string>;
     action: 'navigate' | 'openDialog' | 'openExternal';
     diagnostics: string[];
 }

package/dist/esm/navigation/DestinationResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DestinationResolution.d.ts","sourceRoot":"","sources":["../../../navigation/DestinationResolution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC;IACnD,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB"}
+{"version":3,"file":"DestinationResolution.d.ts","sourceRoot":"","sources":["../../../navigation/DestinationResolution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC;IACnD,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/esm/navigation/DialogResult.d.ts

@@ -0,0 +1,5 @@
+export interface DialogResult {
+    dialog: string;
+    result?: unknown;
+}
+//# sourceMappingURL=DialogResult.d.ts.map

package/dist/esm/navigation/DialogResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogResult.d.ts","sourceRoot":"","sources":["../../../navigation/DialogResult.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/esm/navigation/DialogResult.js

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

package/dist/esm/navigation/DialogResult.js.map

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

package/dist/esm/navigation/SceneHistory.d.ts

@@ -0,0 +1,10 @@
+import { SceneNavigationState } from './SceneNavigationState';
+export interface SceneHistory {
+    location(): string | undefined;
+    state(): SceneNavigationState | undefined;
+    push(state: SceneNavigationState): void;
+    replace(state: SceneNavigationState): void;
+    back(): void;
+    listen(listener: (url: string | undefined, state: SceneNavigationState | undefined) => void): () => void;
+}
+//# sourceMappingURL=SceneHistory.d.ts.map

package/dist/esm/navigation/SceneHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneHistory.d.ts","sourceRoot":"","sources":["../../../navigation/SceneHistory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,MAAM,WAAW,YAAY;IAEzB,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;IAG/B,KAAK,IAAI,oBAAoB,GAAG,SAAS,CAAC;IAE1C,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,IAAI,IAAI,IAAI,CAAC;IAGb,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,oBAAoB,GAAG,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5G"}

package/dist/esm/navigation/SceneHistory.js

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

package/dist/esm/navigation/SceneHistory.js.map

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

package/dist/esm/navigation/SceneNavigationContext.d.ts

@@ -2,14 +2,19 @@ import { ReactNode } from 'react';
 import { BindingScope } from '@cratis/scene.engine';
 import { DestinationReference } from '@cratis/scene.model';
 import { DestinationResolution } from './DestinationResolution';
+import { DialogResult } from './DialogResult';
 export interface SceneNavigationContextValue {
     currentScreen: string;
     currentUrl?: string;
     currentOutlet?: string;
     currentDialog?: string;
+    currentParameters: Record<string, string>;
+    dialogResult?: DialogResult;
+    unresolvedUrl?: string;
     bindingScope: BindingScope;
     navigate(destination: DestinationReference): DestinationResolution;
-    closeDialog(): void;
+    closeDialog(result?: unknown): void;
+    back(): void;
 }
 export interface SceneNavigationProviderProps {
     value: SceneNavigationContextValue;

package/dist/esm/navigation/SceneNavigationContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneNavigationContext.d.ts","sourceRoot":"","sources":["../../../navigation/SceneNavigationContext.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,qBAAqB,CAAC;IACnE,WAAW,IAAI,IAAI,CAAC;CACvB;AAID,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,2BAA2B,CAAC;IACnC,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,4BAA4B,+BAExF;AAED,wBAAgB,kBAAkB,IAAI,2BAA2B,CAIhE"}
+{"version":3,"file":"SceneNavigationContext.d.ts","sourceRoot":"","sources":["../../../navigation/SceneNavigationContext.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,2BAA2B;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAG1C,YAAY,CAAC,EAAE,YAAY,CAAC;IAG5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,qBAAqB,CAAC;IAGnE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpC,IAAI,IAAI,IAAI,CAAC;CAChB;AAID,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,2BAA2B,CAAC;IACnC,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,4BAA4B,+BAExF;AAED,wBAAgB,kBAAkB,IAAI,2BAA2B,CAIhE"}

package/dist/esm/navigation/SceneNavigationContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneNavigationContext.js","sources":["../../../navigation/SceneNavigationContext.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, useContext } from 'react';\nimport { BindingScope } from '@cratis/scene.engine';\nimport { DestinationReference } from '@cratis/scene.model';\nimport { DestinationResolution } from './DestinationResolution';\n\nexport interface SceneNavigationContextValue {\n    currentScreen: string;\n    currentUrl?: string;\n    currentOutlet?: string;\n    currentDialog?: string;\n    bindingScope: BindingScope;\n    navigate(destination: DestinationReference): DestinationResolution;\n    closeDialog(): void;\n}\n\nconst Context = createContext<SceneNavigationContextValue | undefined>(undefined);\n\nexport interface SceneNavigationProviderProps {\n    value: SceneNavigationContextValue;\n    children: ReactNode;\n}\n\nexport function SceneNavigationProvider({ value, children }: SceneNavigationProviderProps) {\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useSceneNavigation(): SceneNavigationContextValue {\n    const context = useContext(Context);\n    if (!context) throw new Error('No Scene navigation context is available.');\n    return context;\n}\n"],"names":["Context","createContext","undefined","SceneNavigationProvider","value","children","_jsx","Provider","useSceneNavigation","context","useContext","Error"],"mappings":";;;AAkBA,MAAMA,wBAAUC,aAAAA,CAAuDC,SAAAA,CAAAA;AAOhE,SAASC,uBAAAA,CAAwB,EAAEC,KAAK,EAAEC,QAAQ,EAAgC,EAAA;IACrF,qBAAOC,GAAA,CAACN,QAAQO,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQC,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAASG,kBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAUC,UAAAA,CAAWV,OAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACS,OAAAA,EAAS,MAAM,IAAIE,KAAAA,CAAM,2CAAA,CAAA;IAC9B,OAAOF,OAAAA;AACX;;"}
+{"version":3,"file":"SceneNavigationContext.js","sources":["../../../navigation/SceneNavigationContext.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, useContext } from 'react';\nimport { BindingScope } from '@cratis/scene.engine';\nimport { DestinationReference } from '@cratis/scene.model';\nimport { DestinationResolution } from './DestinationResolution';\nimport { DialogResult } from './DialogResult';\n\nexport interface SceneNavigationContextValue {\n    currentScreen: string;\n    currentUrl?: string;\n    currentOutlet?: string;\n    currentDialog?: string;\n\n    /** The route parameters of the current entry - from the destination that opened it, or the deep link. */\n    currentParameters: Record<string, string>;\n\n    /** What the last dialog returned when it closed. */\n    dialogResult?: DialogResult;\n\n    /** A deep link that matched no route; the host fell back to its initial screen. */\n    unresolvedUrl?: string;\n    bindingScope: BindingScope;\n    navigate(destination: DestinationReference): DestinationResolution;\n\n    /** Closes the open dialog, returning to the entry that opened it, and records its result. */\n    closeDialog(result?: unknown): void;\n\n    /** Goes back one history entry. */\n    back(): void;\n}\n\nconst Context = createContext<SceneNavigationContextValue | undefined>(undefined);\n\nexport interface SceneNavigationProviderProps {\n    value: SceneNavigationContextValue;\n    children: ReactNode;\n}\n\nexport function SceneNavigationProvider({ value, children }: SceneNavigationProviderProps) {\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useSceneNavigation(): SceneNavigationContextValue {\n    const context = useContext(Context);\n    if (!context) throw new Error('No Scene navigation context is available.');\n    return context;\n}\n"],"names":["Context","createContext","undefined","SceneNavigationProvider","value","children","_jsx","Provider","useSceneNavigation","context","useContext","Error"],"mappings":";;;AAiCA,MAAMA,wBAAUC,aAAAA,CAAuDC,SAAAA,CAAAA;AAOhE,SAASC,uBAAAA,CAAwB,EAAEC,KAAK,EAAEC,QAAQ,EAAgC,EAAA;IACrF,qBAAOC,GAAA,CAACN,QAAQO,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQC,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAASG,kBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAUC,UAAAA,CAAWV,OAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACS,OAAAA,EAAS,MAAM,IAAIE,KAAAA,CAAM,2CAAA,CAAA;IAC9B,OAAOF,OAAAA;AACX;;"}

package/dist/esm/navigation/SceneNavigationHost.d.ts

@@ -1,12 +1,17 @@
 import { BindingScope } from '@cratis/scene.engine';
-import { SceneElement } from '@cratis/scene.model';
+import { DestinationReference, SceneElement } from '@cratis/scene.model';
 import { ComponentRegistry } from '../renderer';
+import { SceneHistory } from './SceneHistory';
+import { SceneRoute } from './SceneRoute';
 export interface SceneNavigationHostProps {
     screens: Record<string, SceneElement>;
     dialogs?: Record<string, SceneElement>;
     initialScreen: string;
     registry: ComponentRegistry;
     bindingScope?: BindingScope;
+    history?: SceneHistory;
+    destinations?: DestinationReference[];
+    routes?: SceneRoute[];
 }
-export declare function SceneNavigationHost({ screens, dialogs, initialScreen, registry, bindingScope }: SceneNavigationHostProps): import("react").JSX.Element;
+export declare function SceneNavigationHost({ screens, dialogs, initialScreen, registry, bindingScope, history, destinations, routes }: SceneNavigationHostProps): import("react").JSX.Element;
 //# sourceMappingURL=SceneNavigationHost.d.ts.map

package/dist/esm/navigation/SceneNavigationHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneNavigationHost.d.ts","sourceRoot":"","sources":["../../../navigation/SceneNavigationHost.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAyC,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAMD,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,OAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAiB,EAAE,EAAE,wBAAwB,+BA2ClI"}
+{"version":3,"file":"SceneNavigationHost.d.ts","sourceRoot":"","sources":["../../../navigation/SceneNavigationHost.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAM5B,OAAO,CAAC,EAAE,YAAY,CAAC;IAGvB,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAGtC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAOD,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,OAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,wBAAwB,+BAgBjK"}

package/dist/esm/navigation/SceneNavigationHost.js

@@ -1,58 +1,31 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { useState, useCallback, useMemo } from 'react';
-import { DestinationKind } from '@cratis/scene.model';
+import { useState, useMemo } from 'react';
 import { SceneElementView } from '../SceneElementView.js';
+import { createMemorySceneHistory } from './createMemorySceneHistory.js';
 import { SceneNavigationProvider } from './SceneNavigationContext.js';
-import { resolveDestination } from './resolveDestination.js';
+import { sceneRoutesFrom } from './sceneRoutesFrom.js';
+import { useSceneHistoryNavigation } from './useSceneHistoryNavigation.js';
 
 /**
  * Executes Scene destinations against an in-memory rendered hierarchy: screen routes replace outlets,
- * dialog destinations render dialog content, and external destinations only report their resolved action.
- */ function SceneNavigationHost({ screens, dialogs = {}, initialScreen, registry, bindingScope = {} }) {
-    const [currentScreen, setCurrentScreen] = useState(initialScreen);
-    const [currentUrl, setCurrentUrl] = useState(initialScreen);
-    const [currentOutlet, setCurrentOutlet] = useState();
-    const [currentDialog, setCurrentDialog] = useState();
-    const navigate = useCallback((destination)=>{
-        const resolution = resolveDestination(destination, bindingScope);
-        if (resolution.kind === DestinationKind.Dialog) {
-            setCurrentDialog(resolution.dialog);
-            return resolution;
-        }
-        if (resolution.kind !== DestinationKind.External) {
-            setCurrentScreen(destination.screen ?? destination.slice ?? currentScreen);
-            setCurrentOutlet(resolution.outlet);
-        }
-        setCurrentUrl(resolution.url);
-        return resolution;
-    }, [
-        bindingScope,
-        currentScreen
+ * dialog destinations render dialog content over the screen that opened them, and external destinations
+ * only report their resolved action. Every navigation is a history entry.
+ */ function SceneNavigationHost({ screens, dialogs = {}, initialScreen, registry, bindingScope = {}, history, destinations, routes }) {
+    const [memoryHistory] = useState(()=>createMemorySceneHistory());
+    const routeTable = useMemo(()=>routes ?? sceneRoutesFrom(Object.keys(screens), destinations), [
+        destinations,
+        routes,
+        screens
     ]);
-    const value = useMemo(()=>({
-            currentScreen,
-            currentUrl,
-            currentOutlet,
-            currentDialog,
-            bindingScope,
-            navigate,
-            closeDialog: ()=>setCurrentDialog(undefined)
-        }), [
-        bindingScope,
-        currentDialog,
-        currentOutlet,
-        currentScreen,
-        currentUrl,
-        navigate
-    ]);
-    const screen = screens[currentScreen];
-    const dialog = currentDialog ? dialogs[currentDialog] : undefined;
+    const value = useSceneHistoryNavigation(history ?? memoryHistory, routeTable, initialScreen, bindingScope);
+    const screen = screens[value.currentScreen];
+    const dialog = value.currentDialog ? dialogs[value.currentDialog] : undefined;
     return /*#__PURE__*/ jsxs(SceneNavigationProvider, {
         value: value,
         children: [
             /*#__PURE__*/ jsx("div", {
-                "data-scene-outlet": currentOutlet ?? 'primary',
-                "data-scene-url": currentUrl,
+                "data-scene-outlet": value.currentOutlet ?? 'primary',
+                "data-scene-url": value.currentUrl,
                 children: screen && /*#__PURE__*/ jsx(SceneElementView, {
                     element: screen,
                     registry: registry,
@@ -63,7 +36,9 @@ import { resolveDestination } from './resolveDestination.js';
             }),
             dialog && /*#__PURE__*/ jsx("div", {
                 role: "dialog",
-                "data-scene-dialog": currentDialog,
+                "aria-modal": "true",
+                "aria-label": value.currentDialog,
+                "data-scene-dialog": value.currentDialog,
                 children: /*#__PURE__*/ jsx(SceneElementView, {
                     element: dialog,
                     registry: registry,

package/dist/esm/navigation/SceneNavigationHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneNavigationHost.js","sources":["../../../navigation/SceneNavigationHost.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 { useCallback, useMemo, useState } from 'react';\nimport { BindingScope } from '@cratis/scene.engine';\nimport { DestinationKind, DestinationReference, SceneElement } from '@cratis/scene.model';\nimport { SceneElementView } from '../SceneElementView';\nimport { ComponentRegistry } from '../renderer';\nimport { SceneNavigationContextValue, SceneNavigationProvider } from './SceneNavigationContext';\nimport { resolveDestination } from './resolveDestination';\n\nexport interface SceneNavigationHostProps {\n    screens: Record<string, SceneElement>;\n    dialogs?: Record<string, SceneElement>;\n    initialScreen: string;\n    registry: ComponentRegistry;\n    bindingScope?: BindingScope;\n}\n\n/**\n * Executes Scene destinations against an in-memory rendered hierarchy: screen routes replace outlets,\n * dialog destinations render dialog content, and external destinations only report their resolved action.\n */\nexport function SceneNavigationHost({ screens, dialogs = {}, initialScreen, registry, bindingScope = {} }: SceneNavigationHostProps) {\n    const [currentScreen, setCurrentScreen] = useState(initialScreen);\n    const [currentUrl, setCurrentUrl] = useState<string | undefined>(initialScreen);\n    const [currentOutlet, setCurrentOutlet] = useState<string | undefined>();\n    const [currentDialog, setCurrentDialog] = useState<string | undefined>();\n\n    const navigate = useCallback((destination: DestinationReference) => {\n        const resolution = resolveDestination(destination, bindingScope);\n        if (resolution.kind === DestinationKind.Dialog) {\n            setCurrentDialog(resolution.dialog);\n            return resolution;\n        }\n\n        if (resolution.kind !== DestinationKind.External) {\n            setCurrentScreen(destination.screen ?? destination.slice ?? currentScreen);\n            setCurrentOutlet(resolution.outlet);\n        }\n\n        setCurrentUrl(resolution.url);\n        return resolution;\n    }, [bindingScope, currentScreen]);\n\n    const value = useMemo<SceneNavigationContextValue>(() => ({\n        currentScreen,\n        currentUrl,\n        currentOutlet,\n        currentDialog,\n        bindingScope,\n        navigate,\n        closeDialog: () => setCurrentDialog(undefined),\n    }), [bindingScope, currentDialog, currentOutlet, currentScreen, currentUrl, navigate]);\n\n    const screen = screens[currentScreen];\n    const dialog = currentDialog ? dialogs[currentDialog] : undefined;\n\n    return <SceneNavigationProvider value={value}>\n        <div data-scene-outlet={currentOutlet ?? 'primary'} data-scene-url={currentUrl}>\n            {screen && <SceneElementView element={screen} registry={registry} dataContext={bindingScope.dataContext} queryResults={bindingScope.queryResults} componentOutputs={bindingScope.componentOutputs} />}\n        </div>\n        {dialog && <div role='dialog' data-scene-dialog={currentDialog}>\n            <SceneElementView element={dialog} registry={registry} dataContext={bindingScope.dataContext} queryResults={bindingScope.queryResults} componentOutputs={bindingScope.componentOutputs} />\n        </div>}\n    </SceneNavigationProvider>;\n}\n"],"names":["SceneNavigationHost","screens","dialogs","initialScreen","registry","bindingScope","currentScreen","setCurrentScreen","useState","currentUrl","setCurrentUrl","currentOutlet","setCurrentOutlet","currentDialog","setCurrentDialog","navigate","useCallback","destination","resolution","resolveDestination","kind","DestinationKind","Dialog","dialog","External","screen","slice","outlet","url","value","useMemo","closeDialog","undefined","_jsxs","SceneNavigationProvider","_jsx","div","data-scene-outlet","data-scene-url","SceneElementView","element","dataContext","queryResults","componentOutputs","role","data-scene-dialog"],"mappings":"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"}
+{"version":3,"file":"SceneNavigationHost.js","sources":["../../../navigation/SceneNavigationHost.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, useState } from 'react';\nimport { BindingScope } from '@cratis/scene.engine';\nimport { DestinationReference, SceneElement } from '@cratis/scene.model';\nimport { SceneElementView } from '../SceneElementView';\nimport { ComponentRegistry } from '../renderer';\nimport { createMemorySceneHistory } from './createMemorySceneHistory';\nimport { SceneHistory } from './SceneHistory';\nimport { SceneNavigationProvider } from './SceneNavigationContext';\nimport { SceneRoute } from './SceneRoute';\nimport { sceneRoutesFrom } from './sceneRoutesFrom';\nimport { useSceneHistoryNavigation } from './useSceneHistoryNavigation';\n\nexport interface SceneNavigationHostProps {\n    screens: Record<string, SceneElement>;\n    dialogs?: Record<string, SceneElement>;\n    initialScreen: string;\n    registry: ComponentRegistry;\n    bindingScope?: BindingScope;\n\n    /**\n     * Where entries are recorded. `createBrowserSceneHistory()` drives the address bar, so deep links,\n     * refresh and back/forward work; the default is an in-memory history for embedded hosts.\n     */\n    history?: SceneHistory;\n\n    /** The destinations the application navigates to, so their route overrides can be deep linked. */\n    destinations?: DestinationReference[];\n\n    /** An explicit route table, used instead of the one derived from `screens` and `destinations`. */\n    routes?: SceneRoute[];\n}\n\n/**\n * Executes Scene destinations against an in-memory rendered hierarchy: screen routes replace outlets,\n * dialog destinations render dialog content over the screen that opened them, and external destinations\n * only report their resolved action. Every navigation is a history entry.\n */\nexport function SceneNavigationHost({ screens, dialogs = {}, initialScreen, registry, bindingScope = {}, history, destinations, routes }: SceneNavigationHostProps) {\n    const [memoryHistory] = useState(() => createMemorySceneHistory());\n    const routeTable = useMemo(() => routes ?? sceneRoutesFrom(Object.keys(screens), destinations), [destinations, routes, screens]);\n    const value = useSceneHistoryNavigation(history ?? memoryHistory, routeTable, initialScreen, bindingScope);\n\n    const screen = screens[value.currentScreen];\n    const dialog = value.currentDialog ? dialogs[value.currentDialog] : undefined;\n\n    return <SceneNavigationProvider value={value}>\n        <div data-scene-outlet={value.currentOutlet ?? 'primary'} data-scene-url={value.currentUrl}>\n            {screen && <SceneElementView element={screen} registry={registry} dataContext={bindingScope.dataContext} queryResults={bindingScope.queryResults} componentOutputs={bindingScope.componentOutputs} />}\n        </div>\n        {dialog && <div role='dialog' aria-modal='true' aria-label={value.currentDialog} data-scene-dialog={value.currentDialog}>\n            <SceneElementView element={dialog} registry={registry} dataContext={bindingScope.dataContext} queryResults={bindingScope.queryResults} componentOutputs={bindingScope.componentOutputs} />\n        </div>}\n    </SceneNavigationProvider>;\n}\n"],"names":["SceneNavigationHost","screens","dialogs","initialScreen","registry","bindingScope","history","destinations","routes","memoryHistory","useState","createMemorySceneHistory","routeTable","useMemo","sceneRoutesFrom","Object","keys","value","useSceneHistoryNavigation","screen","currentScreen","dialog","currentDialog","undefined","_jsxs","SceneNavigationProvider","_jsx","div","data-scene-outlet","currentOutlet","data-scene-url","currentUrl","SceneElementView","element","dataContext","queryResults","componentOutputs","role","aria-modal","aria-label","data-scene-dialog"],"mappings":";;;;;;;;AAmCA;;;;IAKO,SAASA,mBAAAA,CAAoB,EAAEC,OAAO,EAAEC,OAAAA,GAAU,EAAE,EAAEC,aAAa,EAAEC,QAAQ,EAAEC,YAAAA,GAAe,EAAE,EAAEC,OAAO,EAAEC,YAAY,EAAEC,MAAM,EAA4B,EAAA;AAC9J,IAAA,MAAM,CAACC,aAAAA,CAAc,GAAGC,QAAAA,CAAS,IAAMC,wBAAAA,EAAAA,CAAAA;IACvC,MAAMC,UAAAA,GAAaC,QAAQ,IAAML,MAAAA,IAAUM,gBAAgBC,MAAAA,CAAOC,IAAI,CAACf,OAAAA,CAAAA,EAAUM,YAAAA,CAAAA,EAAe;AAACA,QAAAA,YAAAA;AAAcC,QAAAA,MAAAA;AAAQP,QAAAA;AAAQ,KAAA,CAAA;AAC/H,IAAA,MAAMgB,KAAAA,GAAQC,yBAAAA,CAA0BZ,OAAAA,IAAWG,aAAAA,EAAeG,YAAYT,aAAAA,EAAeE,YAAAA,CAAAA;AAE7F,IAAA,MAAMc,MAAAA,GAASlB,OAAO,CAACgB,KAAAA,CAAMG,aAAa,CAAC;IAC3C,MAAMC,MAAAA,GAASJ,MAAMK,aAAa,GAAGpB,OAAO,CAACe,KAAAA,CAAMK,aAAa,CAAC,GAAGC,SAAAA;AAEpE,IAAA,qBAAOC,IAAA,CAACC,uBAAAA,EAAAA;QAAwBR,KAAAA,EAAOA,KAAAA;;0BACnCS,GAAA,CAACC,KAAAA,EAAAA;gBAAIC,mBAAAA,EAAmBX,KAAAA,CAAMY,aAAa,IAAI,SAAA;AAAWC,gBAAAA,gBAAAA,EAAgBb,MAAMc,UAAU;AACrFZ,gBAAAA,QAAAA,EAAAA,MAAAA,kBAAUO,GAAA,CAACM,gBAAAA,EAAAA;oBAAiBC,OAAAA,EAASd,MAAAA;oBAAQf,QAAAA,EAAUA,QAAAA;AAAU8B,oBAAAA,WAAAA,EAAa7B,aAAa6B,WAAW;AAAEC,oBAAAA,YAAAA,EAAc9B,aAAa8B,YAAY;AAAEC,oBAAAA,gBAAAA,EAAkB/B,aAAa+B;;;AAEpLf,YAAAA,MAAAA,kBAAUK,GAAA,CAACC,KAAAA,EAAAA;gBAAIU,IAAAA,EAAK,QAAA;gBAASC,YAAAA,EAAW,MAAA;AAAOC,gBAAAA,YAAAA,EAAYtB,MAAMK,aAAa;AAAEkB,gBAAAA,mBAAAA,EAAmBvB,MAAMK,aAAa;AACnH,gBAAA,QAAA,gBAAAI,GAAA,CAACM,gBAAAA,EAAAA;oBAAiBC,OAAAA,EAASZ,MAAAA;oBAAQjB,QAAAA,EAAUA,QAAAA;AAAU8B,oBAAAA,WAAAA,EAAa7B,aAAa6B,WAAW;AAAEC,oBAAAA,YAAAA,EAAc9B,aAAa8B,YAAY;AAAEC,oBAAAA,gBAAAA,EAAkB/B,aAAa+B;;;;;AAGlL;;"}

package/dist/esm/navigation/SceneNavigationState.d.ts

@@ -0,0 +1,8 @@
+export interface SceneNavigationState {
+    screen: string;
+    url?: string;
+    outlet?: string;
+    dialog?: string;
+    parameters: Record<string, string>;
+}
+//# sourceMappingURL=SceneNavigationState.d.ts.map