@cratis/scene.react 4.15.0 → 4.17.0

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

@@ -6,6 +6,7 @@ export * from './SceneNavigationHost';
 export * from './SceneNavigationState';
 export * from './SceneRoute';
 export * from './createBrowserSceneHistory';
+export * from './createHashSceneHistory';
 export * from './createMemorySceneHistory';
 export * from './diagnoseRenderedNavigation';
 export * from './identityRoute';
@@ -14,4 +15,8 @@ export * from './navigationRouteKey';
 export * from './resolveDestination';
 export * from './sceneRoutesFrom';
 export * from './useSceneHistoryNavigation';
+export * from './CoreOutlet';
+export * from './SceneOutletContext';
+export * from './collectOutletOwners';
+export * from './placeInOutlet';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../navigation/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../navigation/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/esm/navigation/index.js

@@ -6,6 +6,7 @@ export * from './SceneNavigationHost';
 export * from './SceneNavigationState';
 export * from './SceneRoute';
 export * from './createBrowserSceneHistory';
+export * from './createHashSceneHistory';
 export * from './createMemorySceneHistory';
 export * from './diagnoseRenderedNavigation';
 export * from './identityRoute';
@@ -14,4 +15,8 @@ export * from './navigationRouteKey';
 export * from './resolveDestination';
 export * from './sceneRoutesFrom';
 export * from './useSceneHistoryNavigation';
+export * from './CoreOutlet';
+export * from './SceneOutletContext';
+export * from './collectOutletOwners';
+export * from './placeInOutlet';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../navigation/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../navigation/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,4 @@
+import { DestinationReference } from '@cratis/scene.model';
+import { SceneNavigationState } from './SceneNavigationState';
+export declare function placeInOutlet(current: SceneNavigationState, screen: string, outlet: string | undefined, owners: Record<string, string>, destinations?: DestinationReference[]): Pick<SceneNavigationState, 'primary' | 'outlets'>;
+//# sourceMappingURL=placeInOutlet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeInOutlet.d.ts","sourceRoot":"","sources":["../../../navigation/placeInOutlet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAa9D,wBAAgB,aAAa,CACzB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,GAAE,oBAAoB,EAAO,GAC1C,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC,CAmBnD"}

package/dist/esm/navigation/placeInOutlet.js

@@ -0,0 +1,63 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The most levels of nesting a placement follows before it stops, so a cyclic model cannot loop forever. */ const maximumDepth = 32;
+/**
+ * Places a screen, recursively composing nested outlets.
+ *
+ * When `outlet` is a nested outlet - one a screen declares with `core:outlet` - the screen goes into it, and
+ * the screen that declares it is placed first: where it already is, or, when it is not on the page, where a
+ * known destination puts it, up to the primary region. Outlets declared by screens that are no longer on the
+ * page are dropped. Any other outlet replaces the primary region and clears every nested placement.
+ */ function placeInOutlet(current, screen, outlet, owners, destinations = []) {
+    const primary = current.primary ?? current.screen;
+    const placements = {
+        ...current.outlets ?? {}
+    };
+    let root = primary;
+    let target = {
+        screen,
+        outlet
+    };
+    for(let depth = 0; target && depth < maximumDepth; depth++){
+        const owner = target.outlet === undefined ? undefined : owners[target.outlet];
+        if (owner === undefined) {
+            root = target.screen;
+            break;
+        }
+        placements[target.outlet] = target.screen;
+        if (isOnPage(owner, root, placements, owners)) break;
+        target = {
+            screen: owner,
+            outlet: destinations.find((destination)=>destination.screen === owner && destination.outlet)?.outlet
+        };
+    }
+    return {
+        primary: root,
+        outlets: reachable(root, placements, owners)
+    };
+}
+/** Whether a screen is the root or shown in an outlet reachable from it. */ function isOnPage(screen, root, placements, owners) {
+    return screen === root || Object.values(reachable(root, placements, owners)).includes(screen);
+}
+/** Only the placements reachable from the root through the outlets each placed screen declares. */ function reachable(root, placements, owners) {
+    const kept = {};
+    const pending = [
+        root
+    ];
+    const seen = new Set();
+    while(pending.length > 0){
+        const screen = pending.shift();
+        if (seen.has(screen)) continue;
+        seen.add(screen);
+        for (const [outlet, placed] of Object.entries(placements)){
+            if (owners[outlet] === screen) {
+                kept[outlet] = placed;
+                pending.push(placed);
+            }
+        }
+    }
+    return kept;
+}
+
+export { placeInOutlet };
+//# sourceMappingURL=placeInOutlet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeInOutlet.js","sources":["../../../navigation/placeInOutlet.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 { DestinationReference } from '@cratis/scene.model';\nimport { SceneNavigationState } from './SceneNavigationState';\n\n/** The most levels of nesting a placement follows before it stops, so a cyclic model cannot loop forever. */\nconst maximumDepth = 32;\n\n/**\n * Places a screen, recursively composing nested outlets.\n *\n * When `outlet` is a nested outlet - one a screen declares with `core:outlet` - the screen goes into it, and\n * the screen that declares it is placed first: where it already is, or, when it is not on the page, where a\n * known destination puts it, up to the primary region. Outlets declared by screens that are no longer on the\n * page are dropped. Any other outlet replaces the primary region and clears every nested placement.\n */\nexport function placeInOutlet(\n    current: SceneNavigationState,\n    screen: string,\n    outlet: string | undefined,\n    owners: Record<string, string>,\n    destinations: DestinationReference[] = [],\n): Pick<SceneNavigationState, 'primary' | 'outlets'> {\n    const primary = current.primary ?? current.screen;\n    const placements: Record<string, string> = { ...(current.outlets ?? {}) };\n    let root = primary;\n\n    let target: { screen: string; outlet: string | undefined } | undefined = { screen, outlet };\n    for (let depth = 0; target && depth < maximumDepth; depth++) {\n        const owner = target.outlet === undefined ? undefined : owners[target.outlet];\n        if (owner === undefined) {\n            root = target.screen;\n            break;\n        }\n\n        placements[target.outlet!] = target.screen;\n        if (isOnPage(owner, root, placements, owners)) break;\n        target = { screen: owner, outlet: destinations.find(destination => destination.screen === owner && destination.outlet)?.outlet };\n    }\n\n    return { primary: root, outlets: reachable(root, placements, owners) };\n}\n\n/** Whether a screen is the root or shown in an outlet reachable from it. */\nfunction isOnPage(screen: string, root: string, placements: Record<string, string>, owners: Record<string, string>): boolean {\n    return screen === root || Object.values(reachable(root, placements, owners)).includes(screen);\n}\n\n/** Only the placements reachable from the root through the outlets each placed screen declares. */\nfunction reachable(root: string, placements: Record<string, string>, owners: Record<string, string>): Record<string, string> {\n    const kept: Record<string, string> = {};\n    const pending = [root];\n    const seen = new Set<string>();\n    while (pending.length > 0) {\n        const screen = pending.shift()!;\n        if (seen.has(screen)) continue;\n        seen.add(screen);\n        for (const [outlet, placed] of Object.entries(placements)) {\n            if (owners[outlet] === screen) {\n                kept[outlet] = placed;\n                pending.push(placed);\n            }\n        }\n    }\n\n    return kept;\n}\n"],"names":["maximumDepth","placeInOutlet","current","screen","outlet","owners","destinations","primary","placements","outlets","root","target","depth","owner","undefined","isOnPage","find","destination","reachable","Object","values","includes","kept","pending","seen","Set","length","shift","has","add","placed","entries","push"],"mappings":"AAAA;AACA;AAKA,8GACA,MAAMA,YAAAA,GAAe,EAAA;AAErB;;;;;;;AAOC,IACM,SAASC,aAAAA,CACZC,OAA6B,EAC7BC,MAAc,EACdC,MAA0B,EAC1BC,MAA8B,EAC9BC,YAAAA,GAAuC,EAAE,EAAA;AAEzC,IAAA,MAAMC,OAAAA,GAAUL,OAAAA,CAAQK,OAAO,IAAIL,QAAQC,MAAM;AACjD,IAAA,MAAMK,UAAAA,GAAqC;AAAE,QAAA,GAAIN,OAAAA,CAAQO,OAAO,IAAI;AAAI,KAAA;AACxE,IAAA,IAAIC,IAAAA,GAAOH,OAAAA;AAEX,IAAA,IAAII,MAAAA,GAAqE;AAAER,QAAAA,MAAAA;AAAQC,QAAAA;AAAO,KAAA;AAC1F,IAAA,IAAK,IAAIQ,KAAAA,GAAQ,CAAA,EAAGD,MAAAA,IAAUC,KAAAA,GAAQZ,cAAcY,KAAAA,EAAAA,CAAS;QACzD,MAAMC,KAAAA,GAAQF,MAAAA,CAAOP,MAAM,KAAKU,SAAAA,GAAYA,YAAYT,MAAM,CAACM,MAAAA,CAAOP,MAAM,CAAC;AAC7E,QAAA,IAAIS,UAAUC,SAAAA,EAAW;AACrBJ,YAAAA,IAAAA,GAAOC,OAAOR,MAAM;AACpB,YAAA;AACJ,QAAA;AAEAK,QAAAA,UAAU,CAACG,MAAAA,CAAOP,MAAM,CAAE,GAAGO,OAAOR,MAAM;AAC1C,QAAA,IAAIY,QAAAA,CAASF,KAAAA,EAAOH,IAAAA,EAAMF,UAAAA,EAAYH,MAAAA,CAAAA,EAAS;QAC/CM,MAAAA,GAAS;YAAER,MAAAA,EAAQU,KAAAA;YAAOT,MAAAA,EAAQE,YAAAA,CAAaU,IAAI,CAACC,CAAAA,WAAAA,GAAeA,WAAAA,CAAYd,MAAM,KAAKU,KAAAA,IAASI,WAAAA,CAAYb,MAAM,CAAA,EAAGA;AAAO,SAAA;AACnI,IAAA;IAEA,OAAO;QAAEG,OAAAA,EAASG,IAAAA;QAAMD,OAAAA,EAASS,SAAAA,CAAUR,MAAMF,UAAAA,EAAYH,MAAAA;AAAQ,KAAA;AACzE;AAEA,6EACA,SAASU,QAAAA,CAASZ,MAAc,EAAEO,IAAY,EAAEF,UAAkC,EAAEH,MAA8B,EAAA;IAC9G,OAAOF,MAAAA,KAAWO,IAAAA,IAAQS,MAAAA,CAAOC,MAAM,CAACF,UAAUR,IAAAA,EAAMF,UAAAA,EAAYH,MAAAA,CAAAA,CAAAA,CAASgB,QAAQ,CAAClB,MAAAA,CAAAA;AAC1F;AAEA,oGACA,SAASe,SAAAA,CAAUR,IAAY,EAAEF,UAAkC,EAAEH,MAA8B,EAAA;AAC/F,IAAA,MAAMiB,OAA+B,EAAC;AACtC,IAAA,MAAMC,OAAAA,GAAU;AAACb,QAAAA;AAAK,KAAA;AACtB,IAAA,MAAMc,OAAO,IAAIC,GAAAA,EAAAA;IACjB,MAAOF,OAAAA,CAAQG,MAAM,GAAG,CAAA,CAAG;QACvB,MAAMvB,MAAAA,GAASoB,QAAQI,KAAK,EAAA;QAC5B,IAAIH,IAAAA,CAAKI,GAAG,CAACzB,MAAAA,CAAAA,EAAS;AACtBqB,QAAAA,IAAAA,CAAKK,GAAG,CAAC1B,MAAAA,CAAAA;QACT,KAAK,MAAM,CAACC,MAAAA,EAAQ0B,MAAAA,CAAO,IAAIX,MAAAA,CAAOY,OAAO,CAACvB,UAAAA,CAAAA,CAAa;AACvD,YAAA,IAAIH,MAAM,CAACD,MAAAA,CAAO,KAAKD,MAAAA,EAAQ;gBAC3BmB,IAAI,CAAClB,OAAO,GAAG0B,MAAAA;AACfP,gBAAAA,OAAAA,CAAQS,IAAI,CAACF,MAAAA,CAAAA;AACjB,YAAA;AACJ,QAAA;AACJ,IAAA;IAEA,OAAOR,IAAAA;AACX;;"}

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

@@ -1,6 +1,7 @@
 import { BindingScope } from '@cratis/scene.engine';
+import { DestinationReference } from '@cratis/scene.model';
 import { SceneHistory } from './SceneHistory';
 import { SceneNavigationContextValue } from './SceneNavigationContext';
 import { SceneRoute } from './SceneRoute';
-export declare function useSceneHistoryNavigation(history: SceneHistory, routes: SceneRoute[], initialScreen: string, bindingScope: BindingScope): SceneNavigationContextValue;
+export declare function useSceneHistoryNavigation(history: SceneHistory, routes: SceneRoute[], initialScreen: string, bindingScope: BindingScope, outletOwners?: Record<string, string>, destinations?: DestinationReference[]): SceneNavigationContextValue;
 //# sourceMappingURL=useSceneHistoryNavigation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSceneHistoryNavigation.d.ts","sourceRoot":"","sources":["../../../navigation/useSceneHistoryNavigation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,2BAA2B,CA4DrK"}
+{"version":3,"file":"useSceneHistoryNavigation.d.ts","sourceRoot":"","sources":["../../../navigation/useSceneHistoryNavigation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAmB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAK5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C,wBAAgB,yBAAyB,CACrC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,UAAU,EAAE,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,YAAY,EAC1B,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACzC,YAAY,GAAE,oBAAoB,EAAO,GAC1C,2BAA2B,CAmE7B"}

package/dist/esm/navigation/useSceneHistoryNavigation.js

@@ -1,6 +1,7 @@
 import { useCallback, useMemo, useState, useRef, useEffect } from 'react';
 import { DestinationKind } from '@cratis/scene.model';
 import { matchSceneRoute } from './matchSceneRoute.js';
+import { placeInOutlet } from './placeInOutlet.js';
 import { resolveDestination } from './resolveDestination.js';
 
 // Copyright (c) Cratis. All rights reserved.
@@ -9,16 +10,24 @@ import { resolveDestination } from './resolveDestination.js';
  * Keeps a navigation host's state in a {@link SceneHistory}: every navigation and every dialog is an entry,
  * so back and forward step through them, a refresh restores the stored entry, and a deep link is matched
  * against the route table. Closing a dialog goes back to the entry that opened it.
- */ function useSceneHistoryNavigation(history, routes, initialScreen, bindingScope) {
+ */ function useSceneHistoryNavigation(history, routes, initialScreen, bindingScope, outletOwners = {}, destinations = []) {
     const fromLocation = useCallback((url)=>{
         const match = url ? matchSceneRoute(url, routes) : undefined;
-        return match ? {
+        if (!match) return undefined;
+        const start = {
+            screen: initialScreen};
+        const placement = placeInOutlet(start, match.route.screen, match.route.outlet, outletOwners, destinations);
+        return {
             screen: match.route.screen,
             url,
             outlet: match.route.outlet,
-            parameters: match.parameters
-        } : undefined;
+            parameters: match.parameters,
+            ...placement
+        };
     }, [
+        destinations,
+        initialScreen,
+        outletOwners,
         routes
     ]);
     const fallback = useMemo(()=>({
@@ -59,17 +68,22 @@ import { resolveDestination } from './resolveDestination.js';
                 dialog: resolution.dialog
             });
         } else if (resolution.kind !== DestinationKind.External) {
+            const screen = destination.screen ?? destination.slice ?? state.screen;
+            const placement = placeInOutlet(state, screen, resolution.outlet, outletOwners, destinations);
             go({
-                screen: destination.screen ?? destination.slice ?? state.screen,
+                screen,
                 url: resolution.url,
                 outlet: resolution.outlet,
-                parameters: resolution.parameters
+                parameters: resolution.parameters,
+                ...placement
             });
         }
         return resolution;
     }, [
         bindingScope,
+        destinations,
         go,
+        outletOwners,
         state
     ]);
     const closeDialog = useCallback((result)=>{
@@ -85,6 +99,8 @@ import { resolveDestination } from './resolveDestination.js';
     ]);
     return useMemo(()=>({
             currentScreen: state.screen,
+            primaryScreen: state.primary ?? state.screen,
+            outlets: state.outlets ?? {},
             currentUrl: state.url,
             currentOutlet: state.outlet,
             currentDialog: state.dialog,

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

@@ -1 +1 @@
-{"version":3,"file":"useSceneHistoryNavigation.js","sources":["../../../navigation/useSceneHistoryNavigation.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 { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { BindingScope } from '@cratis/scene.engine';\nimport { DestinationKind, DestinationReference } from '@cratis/scene.model';\nimport { DialogResult } from './DialogResult';\nimport { matchSceneRoute } from './matchSceneRoute';\nimport { resolveDestination } from './resolveDestination';\nimport { SceneHistory } from './SceneHistory';\nimport { SceneNavigationContextValue } from './SceneNavigationContext';\nimport { SceneNavigationState } from './SceneNavigationState';\nimport { SceneRoute } from './SceneRoute';\n\n/**\n * Keeps a navigation host's state in a {@link SceneHistory}: every navigation and every dialog is an entry,\n * so back and forward step through them, a refresh restores the stored entry, and a deep link is matched\n * against the route table. Closing a dialog goes back to the entry that opened it.\n */\nexport function useSceneHistoryNavigation(history: SceneHistory, routes: SceneRoute[], initialScreen: string, bindingScope: BindingScope): SceneNavigationContextValue {\n    const fromLocation = useCallback((url: string | undefined): SceneNavigationState | undefined => {\n        const match = url ? matchSceneRoute(url, routes) : undefined;\n        return match ? { screen: match.route.screen, url, outlet: match.route.outlet, parameters: match.parameters } : undefined;\n    }, [routes]);\n    const fallback = useMemo<SceneNavigationState>(() => ({ screen: initialScreen, url: initialScreen, parameters: {} }), [initialScreen]);\n\n    const [unresolvedUrl] = useState(() => {\n        const url = history.location();\n        return !history.state() && url && !fromLocation(url) ? url : undefined;\n    });\n    const [state, setState] = useState<SceneNavigationState>(() => history.state() ?? fromLocation(history.location()) ?? fallback);\n    const [dialogResult, setDialogResult] = useState<DialogResult>();\n\n    // Back and forward restore the stored entry, or match a URL the host never wrote against the current routes.\n    const restore = useRef((url: string | undefined, stored: SceneNavigationState | undefined) => stored ?? fromLocation(url) ?? fallback);\n    restore.current = (url, stored) => stored ?? fromLocation(url) ?? fallback;\n    const initialState = useRef(state);\n\n    // The current entry is written once, when a history is attached; later entries are written by navigate.\n    useEffect(() => {\n        history.replace(initialState.current);\n        return history.listen((url, stored) => setState(restore.current(url, stored)));\n    }, [history]);\n\n    const go = useCallback((next: SceneNavigationState) => {\n        history.push(next);\n        setState(next);\n    }, [history]);\n\n    const navigate = useCallback((destination: DestinationReference) => {\n        const resolution = resolveDestination(destination, bindingScope);\n        if (resolution.kind === DestinationKind.Dialog) {\n            if (resolution.dialog) go({ ...state, dialog: resolution.dialog });\n        } else if (resolution.kind !== DestinationKind.External) {\n            go({ screen: destination.screen ?? destination.slice ?? state.screen, url: resolution.url, outlet: resolution.outlet, parameters: resolution.parameters });\n        }\n\n        return resolution;\n    }, [bindingScope, go, state]);\n\n    const closeDialog = useCallback((result?: unknown) => {\n        if (!state.dialog) return;\n        setDialogResult({ dialog: state.dialog, result });\n        history.back();\n    }, [history, state.dialog]);\n\n    return useMemo(() => ({\n        currentScreen: state.screen,\n        currentUrl: state.url,\n        currentOutlet: state.outlet,\n        currentDialog: state.dialog,\n        currentParameters: state.parameters,\n        dialogResult,\n        unresolvedUrl,\n        bindingScope,\n        navigate,\n        closeDialog,\n        back: () => history.back(),\n    }), [bindingScope, closeDialog, dialogResult, history, navigate, state, unresolvedUrl]);\n}\n"],"names":["useSceneHistoryNavigation","history","routes","initialScreen","bindingScope","fromLocation","useCallback","url","match","matchSceneRoute","undefined","screen","route","outlet","parameters","fallback","useMemo","unresolvedUrl","useState","location","state","setState","dialogResult","setDialogResult","restore","useRef","stored","current","initialState","useEffect","replace","listen","go","next","push","navigate","destination","resolution","resolveDestination","kind","DestinationKind","Dialog","dialog","External","slice","closeDialog","result","back","currentScreen","currentUrl","currentOutlet","currentDialog","currentParameters"],"mappings":"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"}
+{"version":3,"file":"useSceneHistoryNavigation.js","sources":["../../../navigation/useSceneHistoryNavigation.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 { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { BindingScope } from '@cratis/scene.engine';\nimport { DestinationKind, DestinationReference } from '@cratis/scene.model';\nimport { DialogResult } from './DialogResult';\nimport { matchSceneRoute } from './matchSceneRoute';\nimport { placeInOutlet } from './placeInOutlet';\nimport { resolveDestination } from './resolveDestination';\nimport { SceneHistory } from './SceneHistory';\nimport { SceneNavigationContextValue } from './SceneNavigationContext';\nimport { SceneNavigationState } from './SceneNavigationState';\nimport { SceneRoute } from './SceneRoute';\n\n/**\n * Keeps a navigation host's state in a {@link SceneHistory}: every navigation and every dialog is an entry,\n * so back and forward step through them, a refresh restores the stored entry, and a deep link is matched\n * against the route table. Closing a dialog goes back to the entry that opened it.\n */\nexport function useSceneHistoryNavigation(\n    history: SceneHistory,\n    routes: SceneRoute[],\n    initialScreen: string,\n    bindingScope: BindingScope,\n    outletOwners: Record<string, string> = {},\n    destinations: DestinationReference[] = [],\n): SceneNavigationContextValue {\n    const fromLocation = useCallback((url: string | undefined): SceneNavigationState | undefined => {\n        const match = url ? matchSceneRoute(url, routes) : undefined;\n        if (!match) return undefined;\n        const start: SceneNavigationState = { screen: initialScreen, parameters: {} };\n        const placement = placeInOutlet(start, match.route.screen, match.route.outlet, outletOwners, destinations);\n        return { screen: match.route.screen, url, outlet: match.route.outlet, parameters: match.parameters, ...placement };\n    }, [destinations, initialScreen, outletOwners, routes]);\n    const fallback = useMemo<SceneNavigationState>(() => ({ screen: initialScreen, url: initialScreen, parameters: {} }), [initialScreen]);\n\n    const [unresolvedUrl] = useState(() => {\n        const url = history.location();\n        return !history.state() && url && !fromLocation(url) ? url : undefined;\n    });\n    const [state, setState] = useState<SceneNavigationState>(() => history.state() ?? fromLocation(history.location()) ?? fallback);\n    const [dialogResult, setDialogResult] = useState<DialogResult>();\n\n    // Back and forward restore the stored entry, or match a URL the host never wrote against the current routes.\n    const restore = useRef((url: string | undefined, stored: SceneNavigationState | undefined) => stored ?? fromLocation(url) ?? fallback);\n    restore.current = (url, stored) => stored ?? fromLocation(url) ?? fallback;\n    const initialState = useRef(state);\n\n    // The current entry is written once, when a history is attached; later entries are written by navigate.\n    useEffect(() => {\n        history.replace(initialState.current);\n        return history.listen((url, stored) => setState(restore.current(url, stored)));\n    }, [history]);\n\n    const go = useCallback((next: SceneNavigationState) => {\n        history.push(next);\n        setState(next);\n    }, [history]);\n\n    const navigate = useCallback((destination: DestinationReference) => {\n        const resolution = resolveDestination(destination, bindingScope);\n        if (resolution.kind === DestinationKind.Dialog) {\n            if (resolution.dialog) go({ ...state, dialog: resolution.dialog });\n        } else if (resolution.kind !== DestinationKind.External) {\n            const screen = destination.screen ?? destination.slice ?? state.screen;\n            const placement = placeInOutlet(state, screen, resolution.outlet, outletOwners, destinations);\n            go({ screen, url: resolution.url, outlet: resolution.outlet, parameters: resolution.parameters, ...placement });\n        }\n\n        return resolution;\n    }, [bindingScope, destinations, go, outletOwners, state]);\n\n    const closeDialog = useCallback((result?: unknown) => {\n        if (!state.dialog) return;\n        setDialogResult({ dialog: state.dialog, result });\n        history.back();\n    }, [history, state.dialog]);\n\n    return useMemo(() => ({\n        currentScreen: state.screen,\n        primaryScreen: state.primary ?? state.screen,\n        outlets: state.outlets ?? {},\n        currentUrl: state.url,\n        currentOutlet: state.outlet,\n        currentDialog: state.dialog,\n        currentParameters: state.parameters,\n        dialogResult,\n        unresolvedUrl,\n        bindingScope,\n        navigate,\n        closeDialog,\n        back: () => history.back(),\n    }), [bindingScope, closeDialog, dialogResult, history, navigate, state, unresolvedUrl]);\n}\n"],"names":["useSceneHistoryNavigation","history","routes","initialScreen","bindingScope","outletOwners","destinations","fromLocation","useCallback","url","match","matchSceneRoute","undefined","start","screen","placement","placeInOutlet","route","outlet","parameters","fallback","useMemo","unresolvedUrl","useState","location","state","setState","dialogResult","setDialogResult","restore","useRef","stored","current","initialState","useEffect","replace","listen","go","next","push","navigate","destination","resolution","resolveDestination","kind","DestinationKind","Dialog","dialog","External","slice","closeDialog","result","back","currentScreen","primaryScreen","primary","outlets","currentUrl","currentOutlet","currentDialog","currentParameters"],"mappings":"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"}

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

@@ -4,6 +4,8 @@ export * from './ComponentRegistry';
 export * from './RenderBindingScopeContext';
 export * from './UnresolvedComponent';
 export * from './useBoundQuery';
+export * from './useValueOutput';
+export * from './valueOutputProperty';
 export * from './createReactRenderer';
 export * from './InteractiveComponent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/esm/renderer/index.js

@@ -4,6 +4,8 @@ export * from './ComponentRegistry';
 export * from './RenderBindingScopeContext';
 export * from './UnresolvedComponent';
 export * from './useBoundQuery';
+export * from './useValueOutput';
+export * from './valueOutputProperty';
 export * from './createReactRenderer';
 export * from './InteractiveComponent';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

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

@@ -0,0 +1,4 @@
+import { ComponentBindingOutputs } from './BindingOutputContext';
+export declare const valueOutputName = "value";
+export declare function useValueOutput(bindingOutputs: ComponentBindingOutputs | undefined, value: unknown): void;
+//# sourceMappingURL=useValueOutput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useValueOutput.d.ts","sourceRoot":"","sources":["../../../renderer/useValueOutput.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,eAAO,MAAM,eAAe,UAAU,CAAC;AAUvC,wBAAgB,cAAc,CAAC,cAAc,EAAE,uBAAuB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAUxG"}

package/dist/esm/renderer/useValueOutput.js

@@ -0,0 +1,28 @@
+import { useRef, useEffect } from 'react';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The output property an input widget publishes its current value under. */ const valueOutputName = 'value';
+/**
+ * Publishes an input widget's current value as its `value` output: once when it mounts, with the initial
+ * value, and again on every change. Other elements bind to it with a `componentProperty` binding, and a
+ * command action maps it as `component.<id>.value`. The renderer clears the output when the widget unmounts.
+ *
+ * Values are published as JSON-compatible data so both engines read the same thing: a `Date` is published
+ * as its ISO 8601 string, and `undefined` as `null`.
+ */ function useValueOutput(bindingOutputs, value) {
+    const published = value instanceof Date ? value.toISOString() : value ?? null;
+    const key = JSON.stringify(published);
+    const latest = useRef(published);
+    latest.current = published;
+    // Published by value through `key`: a new array or object with the same content is not a change.
+    useEffect(()=>{
+        bindingOutputs?.setOutput(valueOutputName, latest.current);
+    }, [
+        bindingOutputs,
+        key
+    ]);
+}
+
+export { useValueOutput, valueOutputName };
+//# sourceMappingURL=useValueOutput.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useValueOutput.js","sources":["../../../renderer/useValueOutput.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, useRef } from 'react';\nimport { ComponentBindingOutputs } from './BindingOutputContext';\n\n/** The output property an input widget publishes its current value under. */\nexport const valueOutputName = 'value';\n\n/**\n * Publishes an input widget's current value as its `value` output: once when it mounts, with the initial\n * value, and again on every change. Other elements bind to it with a `componentProperty` binding, and a\n * command action maps it as `component.<id>.value`. The renderer clears the output when the widget unmounts.\n *\n * Values are published as JSON-compatible data so both engines read the same thing: a `Date` is published\n * as its ISO 8601 string, and `undefined` as `null`.\n */\nexport function useValueOutput(bindingOutputs: ComponentBindingOutputs | undefined, value: unknown): void {\n    const published = value instanceof Date ? value.toISOString() : value ?? null;\n    const key = JSON.stringify(published);\n    const latest = useRef(published);\n    latest.current = published;\n\n    // Published by value through `key`: a new array or object with the same content is not a change.\n    useEffect(() => {\n        bindingOutputs?.setOutput(valueOutputName, latest.current);\n    }, [bindingOutputs, key]);\n}\n"],"names":["valueOutputName","useValueOutput","bindingOutputs","value","published","Date","toISOString","key","JSON","stringify","latest","useRef","current","useEffect","setOutput"],"mappings":";;AAAA;AACA;AAKA,8EACO,MAAMA,eAAAA,GAAkB;AAE/B;;;;;;;AAOC,IACM,SAASC,cAAAA,CAAeC,cAAmD,EAAEC,KAAc,EAAA;AAC9F,IAAA,MAAMC,YAAYD,KAAAA,YAAiBE,IAAAA,GAAOF,KAAAA,CAAMG,WAAW,KAAKH,KAAAA,IAAS,IAAA;IACzE,MAAMI,GAAAA,GAAMC,IAAAA,CAAKC,SAAS,CAACL,SAAAA,CAAAA;AAC3B,IAAA,MAAMM,SAASC,MAAAA,CAAOP,SAAAA,CAAAA;AACtBM,IAAAA,MAAAA,CAAOE,OAAO,GAAGR,SAAAA;;IAGjBS,SAAAA,CAAU,IAAA;QACNX,cAAAA,EAAgBY,SAAAA,CAAUd,eAAAA,EAAiBU,MAAAA,CAAOE,OAAO,CAAA;IAC7D,CAAA,EAAG;AAACV,QAAAA,cAAAA;AAAgBK,QAAAA;AAAI,KAAA,CAAA;AAC5B;;"}

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

@@ -0,0 +1,3 @@
+import { PropertyDescriptor, PropertyValueType } from '@cratis/scene.model';
+export declare function valueOutputProperty(valueType: PropertyValueType, description?: string): PropertyDescriptor;
+//# sourceMappingURL=valueOutputProperty.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"valueOutputProperty.d.ts","sourceRoot":"","sources":["../../../renderer/valueOutputProperty.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAUzF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,SAA+D,GAAG,kBAAkB,CAWhK"}

package/dist/esm/renderer/valueOutputProperty.js

@@ -0,0 +1,26 @@
+import { BindingMode } from '@cratis/scene.model';
+import { valueOutputName } from './useValueOutput.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The descriptor entry an input widget declares for the value it publishes with `useValueOutput`, so a
+ * designer can offer it as a binding source - for a detail component, a query argument or a command input.
+ *
+ * @param valueType The type of value the widget publishes.
+ * @param description What the value is, when the default sentence does not say enough.
+ */ function valueOutputProperty(valueType, description = 'What the user has entered, published as the input changes.') {
+    return {
+        path: valueOutputName,
+        label: 'Value',
+        group: 'Outputs',
+        valueType,
+        readOnly: true,
+        output: true,
+        bindingMode: BindingMode.OneWay,
+        description
+    };
+}
+
+export { valueOutputProperty };
+//# sourceMappingURL=valueOutputProperty.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"valueOutputProperty.js","sources":["../../../renderer/valueOutputProperty.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 { BindingMode, PropertyDescriptor, PropertyValueType } from '@cratis/scene.model';\nimport { valueOutputName } from './useValueOutput';\n\n/**\n * The descriptor entry an input widget declares for the value it publishes with `useValueOutput`, so a\n * designer can offer it as a binding source - for a detail component, a query argument or a command input.\n *\n * @param valueType The type of value the widget publishes.\n * @param description What the value is, when the default sentence does not say enough.\n */\nexport function valueOutputProperty(valueType: PropertyValueType, description = 'What the user has entered, published as the input changes.'): PropertyDescriptor {\n    return {\n        path: valueOutputName,\n        label: 'Value',\n        group: 'Outputs',\n        valueType,\n        readOnly: true,\n        output: true,\n        bindingMode: BindingMode.OneWay,\n        description,\n    };\n}\n"],"names":["valueOutputProperty","valueType","description","path","valueOutputName","label","group","readOnly","output","bindingMode","BindingMode","OneWay"],"mappings":";;;AAAA;AACA;AAKA;;;;;;AAMC,IACM,SAASA,mBAAAA,CAAoBC,SAA4B,EAAEC,cAAc,4DAA4D,EAAA;IACxI,OAAO;QACHC,IAAAA,EAAMC,eAAAA;QACNC,KAAAA,EAAO,OAAA;QACPC,KAAAA,EAAO,SAAA;AACPL,QAAAA,SAAAA;QACAM,QAAAA,EAAU,IAAA;QACVC,MAAAA,EAAQ,IAAA;AACRC,QAAAA,WAAAA,EAAaC,YAAYC,MAAM;AAC/BT,QAAAA;AACJ,KAAA;AACJ;;"}