@cratis/scene.react 4.28.0 → 4.30.0

package/dist/cjs/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';\nimport { DialogResult } from './DialogResult';\n\nexport interface SceneNavigationContextValue {\n    /** The screen the last navigation opened. */\n    currentScreen: string;\n\n    /** The screen in the primary region. */\n    primaryScreen: string;\n\n    /** Which screen each nested outlet shows, by outlet name. */\n    outlets: Record<string, 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\n/** The navigation context itself, for components that render outside a host as well as inside one. */\nexport const SceneNavigationContextInternal = Context;\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","SceneNavigationContextInternal","SceneNavigationProvider","value","children","_jsx","Provider","useSceneNavigation","context","useContext","Error"],"mappings":";;;;;AAwCA,MAAMA,wBAAUC,mBAAAA,CAAuDC,SAAAA,CAAAA;AAEvE,uGACO,MAAMC,8BAAAA,GAAiCH;AAOvC,SAASI,uBAAAA,CAAwB,EAAEC,KAAK,EAAEC,QAAQ,EAAgC,EAAA;IACrF,qBAAOC,cAAA,CAACP,QAAQQ,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQC,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAASG,kBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAUC,gBAAAA,CAAWX,OAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACU,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    /** The screen the last navigation opened. */\n    currentScreen: string;\n\n    /** The screen in the primary region. */\n    primaryScreen: string;\n\n    /** Which screen each nested outlet shows, by outlet name. */\n    outlets: Record<string, string>;\n    currentUrl?: string;\n    currentOutlet?: string;\n    currentDialog?: string;\n\n    /** The parameters the open dialog was opened with - a slice dialog carries its slice, command and title. */\n    currentDialogParameters?: Record<string, 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\n/** The navigation context itself, for components that render outside a host as well as inside one. */\nexport const SceneNavigationContextInternal = Context;\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","SceneNavigationContextInternal","SceneNavigationProvider","value","children","_jsx","Provider","useSceneNavigation","context","useContext","Error"],"mappings":";;;;;AA2CA,MAAMA,wBAAUC,mBAAAA,CAAuDC,SAAAA,CAAAA;AAEvE,uGACO,MAAMC,8BAAAA,GAAiCH;AAOvC,SAASI,uBAAAA,CAAwB,EAAEC,KAAK,EAAEC,QAAQ,EAAgC,EAAA;IACrF,qBAAOC,cAAA,CAACP,QAAQQ,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQC,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAASG,kBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAUC,gBAAAA,CAAWX,OAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACU,OAAAA,EAAS,MAAM,IAAIE,KAAAA,CAAM,2CAAA,CAAA;IAC9B,OAAOF,OAAAA;AACX;;;;"}

package/dist/cjs/navigation/SceneNavigationHost.js

@@ -9,14 +9,23 @@ var sceneRoutesFrom = require('./sceneRoutesFrom.js');
 var collectOutletOwners = require('./collectOutletOwners.js');
 var SceneOutletContext = require('./SceneOutletContext.js');
 var useSceneHistoryNavigation = require('./useSceneHistoryNavigation.js');
+var SceneNavigationModelContext = require('./region/SceneNavigationModelContext.js');
+var navigationDestinations = require('./region/navigationDestinations.js');
+var SliceDialogView = require('../slices/SliceDialogView.js');
+var sliceDialogDestination = require('../slices/sliceDialogDestination.js');
 
 /**
  * Executes Scene destinations against an in-memory rendered hierarchy: a destination into a nested outlet -
  * one a screen declares with `core:outlet` - places its screen there and keeps the screens above it, to any
  * depth; any other screen route replaces the primary region,
- * dialog destinations render dialog content over the screen that opened them, and external destinations
+ * dialog destinations render dialog content over the screen that opened them - a toolbar slice button's dialog falls back to
+ * the built-in task dialog (`SliceDialogView`) when `dialogs` has no template of that name -, and external destinations
  * only report their resolved action. Every navigation is a history entry.
- */ function SceneNavigationHost({ screens, dialogs = {}, initialScreen, registry, bindingScope = {}, history, destinations, routes }) {
+ */ function SceneNavigationHost({ screens, dialogs = {}, initialScreen, registry, bindingScope = {}, history, destinations: authoredDestinations, routes, navigationModel, frame }) {
+    const destinations = react.useMemo(()=>authoredDestinations ?? (navigationModel ? navigationDestinations.navigationDestinations(navigationModel.structure, navigationModel.navigation, navigationModel.screenFor) : undefined), [
+        authoredDestinations,
+        navigationModel
+    ]);
     const [memoryHistory] = react.useState(()=>createMemorySceneHistory.createMemorySceneHistory());
     const routeTable = react.useMemo(()=>routes ?? sceneRoutesFrom.sceneRoutesFrom(Object.keys(screens), destinations), [
         destinations,
@@ -36,38 +45,45 @@ var useSceneHistoryNavigation = require('./useSceneHistoryNavigation.js');
     ]);
     const screen = screens[value.primaryScreen];
     const dialog = value.currentDialog ? dialogs[value.currentDialog] : undefined;
-    return /*#__PURE__*/ jsxRuntime.jsx(SceneNavigationContext.SceneNavigationProvider, {
+    const sliceDialog = !dialog && value.currentDialog && sliceDialogDestination.sliceDialogParameters(value.currentDialogParameters) !== undefined;
+    const dialogName = sliceDialogDestination.sliceDialogParameters(value.currentDialogParameters)?.title ?? value.currentDialog;
+    const outlet = /*#__PURE__*/ jsxRuntime.jsx("div", {
+        "data-scene-outlet": value.primaryScreen === value.currentScreen ? value.currentOutlet ?? 'primary' : 'primary',
+        "data-scene-url": value.currentUrl,
+        children: screen && /*#__PURE__*/ jsxRuntime.jsx(SceneElementView.SceneElementView, {
+            element: screen,
+            registry: registry,
+            dataContext: bindingScope.dataContext,
+            queryResults: bindingScope.queryResults,
+            componentOutputs: bindingScope.componentOutputs
+        })
+    });
+    const page = /*#__PURE__*/ jsxRuntime.jsx(SceneNavigationContext.SceneNavigationProvider, {
         value: value,
         children: /*#__PURE__*/ jsxRuntime.jsxs(SceneOutletContext.SceneOutletContext.Provider, {
             value: outletContext,
             children: [
-                /*#__PURE__*/ jsxRuntime.jsx("div", {
-                    "data-scene-outlet": value.primaryScreen === value.currentScreen ? value.currentOutlet ?? 'primary' : 'primary',
-                    "data-scene-url": value.currentUrl,
-                    children: screen && /*#__PURE__*/ jsxRuntime.jsx(SceneElementView.SceneElementView, {
-                        element: screen,
-                        registry: registry,
-                        dataContext: bindingScope.dataContext,
-                        queryResults: bindingScope.queryResults,
-                        componentOutputs: bindingScope.componentOutputs
-                    })
-                }),
-                dialog && /*#__PURE__*/ jsxRuntime.jsx("div", {
+                frame ? frame(outlet) : outlet,
+                (dialog || sliceDialog) && /*#__PURE__*/ jsxRuntime.jsx("div", {
                     role: "dialog",
                     "aria-modal": "true",
-                    "aria-label": value.currentDialog,
+                    "aria-label": dialogName,
                     "data-scene-dialog": value.currentDialog,
-                    children: /*#__PURE__*/ jsxRuntime.jsx(SceneElementView.SceneElementView, {
+                    children: dialog ? /*#__PURE__*/ jsxRuntime.jsx(SceneElementView.SceneElementView, {
                         element: dialog,
                         registry: registry,
                         dataContext: bindingScope.dataContext,
                         queryResults: bindingScope.queryResults,
                         componentOutputs: bindingScope.componentOutputs
-                    })
+                    }) : /*#__PURE__*/ jsxRuntime.jsx(SliceDialogView.SliceDialogView, {})
                 })
             ]
         })
     });
+    return navigationModel ? /*#__PURE__*/ jsxRuntime.jsx(SceneNavigationModelContext.SceneNavigationModelProvider, {
+        model: navigationModel,
+        children: page
+    }) : page;
 }
 
 exports.SceneNavigationHost = SceneNavigationHost;

package/dist/cjs/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 { 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 { collectOutletOwners } from './collectOutletOwners';\nimport { SceneOutletContext } from './SceneOutletContext';\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: a destination into a nested outlet -\n * one a screen declares with `core:outlet` - places its screen there and keeps the screens above it, to any\n * depth; any other screen route replaces the primary region,\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 outletOwners = useMemo(() => collectOutletOwners(screens), [screens]);\n    const value = useSceneHistoryNavigation(history ?? memoryHistory, routeTable, initialScreen, bindingScope, outletOwners, destinations);\n    const outletContext = useMemo(() => ({ screens, registry }), [registry, screens]);\n\n    const screen = screens[value.primaryScreen];\n    const dialog = value.currentDialog ? dialogs[value.currentDialog] : undefined;\n\n    return <SceneNavigationProvider value={value}><SceneOutletContext.Provider value={outletContext}>\n        <div data-scene-outlet={value.primaryScreen === value.currentScreen ? value.currentOutlet ?? 'primary' : '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    </SceneOutletContext.Provider></SceneNavigationProvider>;\n}\n"],"names":["SceneNavigationHost","screens","dialogs","initialScreen","registry","bindingScope","history","destinations","routes","memoryHistory","useState","createMemorySceneHistory","routeTable","useMemo","sceneRoutesFrom","Object","keys","outletOwners","collectOutletOwners","value","useSceneHistoryNavigation","outletContext","screen","primaryScreen","dialog","currentDialog","undefined","_jsx","SceneNavigationProvider","_jsxs","SceneOutletContext","Provider","div","data-scene-outlet","currentScreen","currentOutlet","data-scene-url","currentUrl","SceneElementView","element","dataContext","queryResults","componentOutputs","role","aria-modal","aria-label","data-scene-dialog"],"mappings":";;;;;;;;;;;;AAqCA;;;;;;IAOO,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,cAAAA,CAAS,IAAMC,iDAAAA,EAAAA,CAAAA;IACvC,MAAMC,UAAAA,GAAaC,cAAQ,IAAML,MAAAA,IAAUM,gCAAgBC,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,YAAAA,GAAeJ,aAAAA,CAAQ,IAAMK,uCAAAA,CAAoBjB,OAAAA,CAAAA,EAAU;AAACA,QAAAA;AAAQ,KAAA,CAAA;AAC1E,IAAA,MAAMkB,QAAQC,mDAAAA,CAA0Bd,OAAAA,IAAWG,eAAeG,UAAAA,EAAYT,aAAAA,EAAeE,cAAcY,YAAAA,EAAcV,YAAAA,CAAAA;IACzH,MAAMc,aAAAA,GAAgBR,aAAAA,CAAQ,KAAO;AAAEZ,YAAAA,OAAAA;AAASG,YAAAA;AAAS,SAAA,CAAA,EAAI;AAACA,QAAAA,QAAAA;AAAUH,QAAAA;AAAQ,KAAA,CAAA;AAEhF,IAAA,MAAMqB,MAAAA,GAASrB,OAAO,CAACkB,KAAAA,CAAMI,aAAa,CAAC;IAC3C,MAAMC,MAAAA,GAASL,MAAMM,aAAa,GAAGvB,OAAO,CAACiB,KAAAA,CAAMM,aAAa,CAAC,GAAGC,SAAAA;AAEpE,IAAA,qBAAOC,cAAA,CAACC,8CAAAA,EAAAA;QAAwBT,KAAAA,EAAOA,KAAAA;gCAAOU,eAAA,CAACC,sCAAmBC,QAAQ,EAAA;YAACZ,KAAAA,EAAOE,aAAAA;;8BAC9EM,cAAA,CAACK,KAAAA,EAAAA;oBAAIC,mBAAAA,EAAmBd,KAAAA,CAAMI,aAAa,KAAKJ,KAAAA,CAAMe,aAAa,GAAGf,KAAAA,CAAMgB,aAAa,IAAI,SAAA,GAAY,SAAA;AAAWC,oBAAAA,gBAAAA,EAAgBjB,MAAMkB,UAAU;AAC/If,oBAAAA,QAAAA,EAAAA,MAAAA,kBAAUK,cAAA,CAACW,iCAAAA,EAAAA;wBAAiBC,OAAAA,EAASjB,MAAAA;wBAAQlB,QAAAA,EAAUA,QAAAA;AAAUoC,wBAAAA,WAAAA,EAAanC,aAAamC,WAAW;AAAEC,wBAAAA,YAAAA,EAAcpC,aAAaoC,YAAY;AAAEC,wBAAAA,gBAAAA,EAAkBrC,aAAaqC;;;AAEpLlB,gBAAAA,MAAAA,kBAAUG,cAAA,CAACK,KAAAA,EAAAA;oBAAIW,IAAAA,EAAK,QAAA;oBAASC,YAAAA,EAAW,MAAA;AAAOC,oBAAAA,YAAAA,EAAY1B,MAAMM,aAAa;AAAEqB,oBAAAA,mBAAAA,EAAmB3B,MAAMM,aAAa;AACnH,oBAAA,QAAA,gBAAAE,cAAA,CAACW,iCAAAA,EAAAA;wBAAiBC,OAAAA,EAASf,MAAAA;wBAAQpB,QAAAA,EAAUA,QAAAA;AAAUoC,wBAAAA,WAAAA,EAAanC,aAAamC,WAAW;AAAEC,wBAAAA,YAAAA,EAAcpC,aAAaoC,YAAY;AAAEC,wBAAAA,gBAAAA,EAAkBrC,aAAaqC;;;;;;AAGlL;;"}
+{"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 { ReactNode, 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 { collectOutletOwners } from './collectOutletOwners';\nimport { SceneOutletContext } from './SceneOutletContext';\nimport { useSceneHistoryNavigation } from './useSceneHistoryNavigation';\nimport { SceneNavigationModel } from './region/SceneNavigationModel';\nimport { SceneNavigationModelProvider } from './region/SceneNavigationModelContext';\nimport { navigationDestinations } from './region/navigationDestinations';\nimport { SliceDialogView } from '../slices/SliceDialogView';\nimport { sliceDialogParameters } from '../slices/sliceDialogDestination';\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    /**\n     * The application's structure and navigation. Navigation regions rendered inside the host (`NavigationRegionView`) read it,\n     * and - when `destinations` is not given - the destinations of every navigation item become the deep-linkable ones.\n     */\n    navigationModel?: SceneNavigationModel;\n\n    /**\n     * Wraps the primary outlet in the application's chrome - a topbar, a sidebar, a toolbar. The chrome is part of the host,\n     * so it stays mounted while the screens inside it change and navigation regions keep their state.\n     */\n    frame?(content: ReactNode): ReactNode;\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: a destination into a nested outlet -\n * one a screen declares with `core:outlet` - places its screen there and keeps the screens above it, to any\n * depth; any other screen route replaces the primary region,\n * dialog destinations render dialog content over the screen that opened them - a toolbar slice button's dialog falls back to\n * the built-in task dialog (`SliceDialogView`) when `dialogs` has no template of that name -, 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: authoredDestinations, routes, navigationModel, frame }: SceneNavigationHostProps) {\n    const destinations = useMemo(\n        () => authoredDestinations ?? (navigationModel ? navigationDestinations(navigationModel.structure, navigationModel.navigation, navigationModel.screenFor) : undefined),\n        [authoredDestinations, navigationModel]);\n    const [memoryHistory] = useState(() => createMemorySceneHistory());\n    const routeTable = useMemo(() => routes ?? sceneRoutesFrom(Object.keys(screens), destinations), [destinations, routes, screens]);\n    const outletOwners = useMemo(() => collectOutletOwners(screens), [screens]);\n    const value = useSceneHistoryNavigation(history ?? memoryHistory, routeTable, initialScreen, bindingScope, outletOwners, destinations);\n    const outletContext = useMemo(() => ({ screens, registry }), [registry, screens]);\n\n    const screen = screens[value.primaryScreen];\n    const dialog = value.currentDialog ? dialogs[value.currentDialog] : undefined;\n    const sliceDialog = !dialog && value.currentDialog && sliceDialogParameters(value.currentDialogParameters) !== undefined;\n    const dialogName = sliceDialogParameters(value.currentDialogParameters)?.title ?? value.currentDialog;\n\n    const outlet = <div data-scene-outlet={value.primaryScreen === value.currentScreen ? value.currentOutlet ?? 'primary' : '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    const page = <SceneNavigationProvider value={value}><SceneOutletContext.Provider value={outletContext}>\n        {frame ? frame(outlet) : outlet}\n        {(dialog || sliceDialog) && <div role='dialog' aria-modal='true' aria-label={dialogName} data-scene-dialog={value.currentDialog}>\n            {dialog ? <SceneElementView element={dialog} registry={registry} dataContext={bindingScope.dataContext} queryResults={bindingScope.queryResults} componentOutputs={bindingScope.componentOutputs} /> : <SliceDialogView />}\n        </div>}\n    </SceneOutletContext.Provider></SceneNavigationProvider>;\n\n    return navigationModel ? <SceneNavigationModelProvider model={navigationModel}>{page}</SceneNavigationModelProvider> : page;\n}\n"],"names":["SceneNavigationHost","screens","dialogs","initialScreen","registry","bindingScope","history","destinations","authoredDestinations","routes","navigationModel","frame","useMemo","navigationDestinations","structure","navigation","screenFor","undefined","memoryHistory","useState","createMemorySceneHistory","routeTable","sceneRoutesFrom","Object","keys","outletOwners","collectOutletOwners","value","useSceneHistoryNavigation","outletContext","screen","primaryScreen","dialog","currentDialog","sliceDialog","sliceDialogParameters","currentDialogParameters","dialogName","title","outlet","_jsx","div","data-scene-outlet","currentScreen","currentOutlet","data-scene-url","currentUrl","SceneElementView","element","dataContext","queryResults","componentOutputs","page","SceneNavigationProvider","_jsxs","SceneOutletContext","Provider","role","aria-modal","aria-label","data-scene-dialog","SliceDialogView","SceneNavigationModelProvider","model"],"mappings":"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"}

package/dist/cjs/navigation/region/NavigationRegionClassNames.js

@@ -0,0 +1,21 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The class names a {@link NavigationRegionView} puts on its nodes. The renderer carries no look of its own: a package
+ * gives the nodes its vocabulary (`blueprint.default` uses its `layout-menu` classes) and a stylesheet does the rest.
+ * State is always on data attributes as well - `data-active`, `data-expanded`, `data-read-only`, `data-origin`.
+ */ /** The class names used when a host passes none. */ const defaultNavigationRegionClassNames = {
+    root: 'scene-nav',
+    list: 'scene-nav-list',
+    item: 'scene-nav-item',
+    link: 'scene-nav-link',
+    icon: 'scene-nav-icon',
+    label: 'scene-nav-label',
+    toggle: 'scene-nav-toggle',
+    submenu: 'scene-nav-submenu'
+};
+
+exports.defaultNavigationRegionClassNames = defaultNavigationRegionClassNames;
+//# sourceMappingURL=NavigationRegionClassNames.js.map

package/dist/cjs/navigation/region/NavigationRegionClassNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationRegionClassNames.js","sources":["../../../../navigation/region/NavigationRegionClassNames.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/**\n * The class names a {@link NavigationRegionView} puts on its nodes. The renderer carries no look of its own: a package\n * gives the nodes its vocabulary (`blueprint.default` uses its `layout-menu` classes) and a stylesheet does the rest.\n * State is always on data attributes as well - `data-active`, `data-expanded`, `data-read-only`, `data-origin`.\n */\nexport interface NavigationRegionClassNames {\n    /** The `nav` landmark. */\n    root: string;\n\n    /** Each list of items. */\n    list: string;\n\n    /** Each item's `li`. */\n    item: string;\n\n    /** The link of an item. */\n    link: string;\n\n    /** The icon of an item. */\n    icon: string;\n\n    /** The title of an item. */\n    label: string;\n\n    /** The button that expands or collapses an item's sub-items. */\n    toggle: string;\n\n    /** The list of an item's sub-items. */\n    submenu: string;\n}\n\n/** The class names used when a host passes none. */\nexport const defaultNavigationRegionClassNames: NavigationRegionClassNames = {\n    root: 'scene-nav',\n    list: 'scene-nav-list',\n    item: 'scene-nav-item',\n    link: 'scene-nav-link',\n    icon: 'scene-nav-icon',\n    label: 'scene-nav-label',\n    toggle: 'scene-nav-toggle',\n    submenu: 'scene-nav-submenu',\n};\n"],"names":["defaultNavigationRegionClassNames","root","list","item","link","icon","label","toggle","submenu"],"mappings":";;AAAA;AACA;AAGA;;;;AAIC,yDA4BM,MAAMA,iCAAAA,GAAgE;IACzEC,IAAAA,EAAM,WAAA;IACNC,IAAAA,EAAM,gBAAA;IACNC,IAAAA,EAAM,gBAAA;IACNC,IAAAA,EAAM,gBAAA;IACNC,IAAAA,EAAM,gBAAA;IACNC,KAAAA,EAAO,iBAAA;IACPC,MAAAA,EAAQ,kBAAA;IACRC,OAAAA,EAAS;AACb;;"}

package/dist/cjs/navigation/region/NavigationRegionView.js

@@ -0,0 +1,283 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var scene_model = require('@cratis/scene.model');
+var scene_engine = require('@cratis/scene.engine');
+var SceneIcon = require('../../icons/SceneIcon.js');
+var IconAdapterContext = require('../../icons/IconAdapterContext.js');
+var resolveDestination = require('../resolveDestination.js');
+var SceneNavigationContext = require('../SceneNavigationContext.js');
+var NavigationRegionClassNames = require('./NavigationRegionClassNames.js');
+var SceneNavigationModelContext = require('./SceneNavigationModelContext.js');
+var currentModuleOf = require('./currentModuleOf.js');
+var navigationItemActive = require('./navigationItemActive.js');
+var navigationItemDestination = require('./navigationItemDestination.js');
+
+function itemKey(path) {
+    return path.join('/');
+}
+function containsActive(item, isActive) {
+    return isActive(item) || (item.children ?? []).some((child)=>containsActive(child, isActive));
+}
+/**
+ * Renders the effective navigation of one region - a topbar or a sidebar - for the application or a module.
+ *
+ * - **Items** come from `effectiveNavigation`, so inherit/extend/override is already applied; nothing here re-implements
+ *   it. A topbar is flat; a sidebar nests, collapses, and expands the parents of the active item.
+ * - **Active state** follows what the navigation host shows: an item is active (`aria-current`, `data-active`) when the
+ *   screen it opens is the one in its slot, so items rendering into different slots are active at once.
+ * - **Activation** goes through the enclosing navigation host (`navigate`), which renders the target in the item's slot -
+ *   the `outlet` of the destination; outside a host it announces `cratis.scene.navigate`.
+ * - **Authorization**: `isVisible` of the model hides items, it does not disable them.
+ * - **Keyboard**: arrows (left/right in a topbar, up/down in a sidebar), Home and End move between items; in a sidebar
+ *   right expands and left collapses (or goes to the parent).
+ *
+ * Nothing here draws design chrome: items carry `data-read-only` and `data-origin` for a design layer to style.
+ */ function NavigationRegionView({ region, module, application = false, model: modelProp, label, expand = 'active', classNames, renderIcon, renderAdornment, hrefFor, onActivate }) {
+    const contextModel = SceneNavigationModelContext.useSceneNavigationModel();
+    const model = modelProp ?? contextModel;
+    if (!model) throw new Error('NavigationRegionView needs a navigation model: pass `model` or render it inside a SceneNavigationModelProvider.');
+    const navigation = react.useContext(SceneNavigationContext.SceneNavigationContextInternal);
+    const adapters = IconAdapterContext.useIconAdapters();
+    const names = {
+        ...NavigationRegionClassNames.defaultNavigationRegionClassNames,
+        ...classNames
+    };
+    const index = react.useMemo(()=>model.structure instanceof scene_engine.ApplicationStructureIndex ? model.structure : new scene_engine.ApplicationStructureIndex(model.structure), [
+        model.structure
+    ]);
+    const screenFor = model.screenFor ?? navigationItemDestination.defaultScreenFor;
+    const sidebar = region === scene_model.NavigationRegionKind.Sidebar;
+    const placement = react.useMemo(()=>({
+            primaryScreen: navigation?.primaryScreen,
+            outlets: navigation?.outlets ?? {}
+        }), [
+        navigation?.outlets,
+        navigation?.primaryScreen
+    ]);
+    const scope = application ? undefined : module ?? currentModuleOf.currentModuleOf(index, placement.primaryScreen);
+    const resolved = react.useMemo(()=>scene_engine.effectiveNavigation(index, model.navigation, scope, region), [
+        index,
+        model.navigation,
+        scope,
+        region
+    ]);
+    const isActive = (item)=>placement.primaryScreen !== undefined && navigationItemActive.navigationItemActive(item, {
+            primaryScreen: placement.primaryScreen,
+            outlets: placement.outlets
+        }, screenFor, !sidebar);
+    const isVisible = model.isVisible ?? (()=>true);
+    const visible = react.useMemo(()=>{
+        const keep = (items)=>items.filter(isVisible).map((item)=>item.children ? {
+                    ...item,
+                    children: keep(item.children)
+                } : item);
+        return keep(resolved.items);
+    }, [
+        resolved,
+        model.isVisible
+    ]);
+    const activeKey = JSON.stringify([
+        placement.primaryScreen,
+        placement.outlets,
+        scope
+    ]);
+    const [toggled, setToggled] = react.useState({
+        key: activeKey,
+        state: {}
+    });
+    const overrides = toggled.key === activeKey ? toggled.state : {};
+    const [focused, setFocused] = react.useState();
+    const root = react.useRef(null);
+    const isExpanded = (item, key)=>overrides[key] ?? (expand === 'all' || containsActive(item, isActive));
+    const toggle = (key, expanded)=>setToggled({
+            key: activeKey,
+            state: {
+                ...overrides,
+                [key]: expanded
+            }
+        });
+    const activate = (item)=>{
+        const destination = navigationItemDestination.navigationItemDestination(item, screenFor);
+        if (destination === undefined) return;
+        if (navigation) {
+            navigation.navigate(destination);
+        } else {
+            globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', {
+                detail: {
+                    targetScreen: destination.screen ?? '',
+                    destination,
+                    item
+                }
+            }));
+        }
+        onActivate?.(item, destination);
+    };
+    const links = ()=>Array.from(root.current?.querySelectorAll('[data-scene-nav-link]') ?? []);
+    const focusLink = (element)=>{
+        if (!element) return;
+        setFocused(element.getAttribute('data-scene-nav-link') ?? undefined);
+        element.focus();
+    };
+    const onKeyDown = (event)=>{
+        const all = links();
+        const position = all.findIndex((link)=>link === document.activeElement);
+        if (position < 0) return;
+        const next = sidebar ? 'ArrowDown' : 'ArrowRight';
+        const previous = sidebar ? 'ArrowUp' : 'ArrowLeft';
+        const current = all[position];
+        const key = current.getAttribute('data-scene-nav-link');
+        const owner = current.closest('[data-scene-nav-item]');
+        const hasChildren = owner?.getAttribute('data-scene-nav-parent') === 'true';
+        const expanded = owner?.getAttribute('data-expanded') === 'true';
+        let target;
+        if (event.key === next) target = all[Math.min(position + 1, all.length - 1)];
+        else if (event.key === previous) target = all[Math.max(position - 1, 0)];
+        else if (event.key === 'Home') target = all[0];
+        else if (event.key === 'End') target = all[all.length - 1];
+        else if (sidebar && event.key === 'ArrowRight' && hasChildren) {
+            if (!expanded) toggle(key, true);
+            else target = all[position + 1];
+        } else if (sidebar && event.key === 'ArrowLeft') {
+            if (hasChildren && expanded) toggle(key, false);
+            else {
+                const parent = owner?.parentElement?.closest('[data-scene-nav-item]')?.querySelector(':scope > [data-scene-nav-link]');
+                if (parent) target = parent;
+            }
+        } else return;
+        event.preventDefault();
+        focusLink(target);
+    };
+    const tabStop = focused ?? undefined;
+    const firstActive = (items, path)=>{
+        for (const item of items){
+            const key = itemKey([
+                ...path,
+                item.id
+            ]);
+            if (isActive(item)) return key;
+            const inner = firstActive(item.children ?? [], [
+                ...path,
+                item.id
+            ]);
+            if (inner !== undefined && isExpanded(item, key)) return inner;
+        }
+        return undefined;
+    };
+    const firstKey = visible.length > 0 ? itemKey([
+        visible[0].id
+    ]) : undefined;
+    const stop = tabStop ?? firstActive(visible, []) ?? firstKey;
+    const icon = (item)=>{
+        if (item.icon === undefined) return null;
+        const drawn = renderIcon ? renderIcon(item.icon) : adapters ? (()=>{
+            const reference = scene_model.parseIconReference(item.icon);
+            return reference ? /*#__PURE__*/ jsxRuntime.jsx(SceneIcon.SceneIcon, {
+                reference: reference,
+                adapters: adapters
+            }) : null;
+        })() : null;
+        return drawn === null ? null : /*#__PURE__*/ jsxRuntime.jsx("span", {
+            className: names.icon,
+            "aria-hidden": "true",
+            "data-scene-icon": item.icon,
+            children: drawn
+        });
+    };
+    const renderItems = (items, path, level)=>items.map((item)=>{
+            const key = itemKey([
+                ...path,
+                item.id
+            ]);
+            const destination = navigationItemDestination.navigationItemDestination(item, screenFor);
+            const active = isActive(item);
+            const children = item.children ?? [];
+            const parent = sidebar && children.length > 0;
+            const expanded = parent && isExpanded(item, key);
+            const url = destination ? resolveDestination.resolveDestination(destination).url : undefined;
+            const href = destination ? hrefFor ? hrefFor(destination, url) : url ? `#/${url}` : undefined : undefined;
+            const onClick = (event)=>{
+                if (event.metaKey || event.ctrlKey || event.shiftKey || event.button !== 0) return;
+                event.preventDefault();
+                if (destination) activate(item);
+                else if (parent) toggle(key, !expanded);
+            };
+            const content = /*#__PURE__*/ jsxRuntime.jsxs(jsxRuntime.Fragment, {
+                children: [
+                    icon(item),
+                    /*#__PURE__*/ jsxRuntime.jsx("span", {
+                        className: names.label,
+                        children: item.title
+                    }),
+                    renderAdornment?.(item)
+                ]
+            });
+            return /*#__PURE__*/ jsxRuntime.jsxs("li", {
+                className: names.item,
+                "data-scene-nav-item": item.id,
+                "data-scene-nav-parent": parent ? 'true' : undefined,
+                "data-active": active,
+                "data-active-descendant": !active && parent && children.some((child)=>containsActive(child, isActive)) ? true : undefined,
+                "data-expanded": parent ? expanded : undefined,
+                "data-origin": item.origin,
+                "data-read-only": item.readOnly,
+                "data-slot": item.slot,
+                "data-level": level,
+                children: [
+                    destination || parent ? /*#__PURE__*/ jsxRuntime.jsx("a", {
+                        className: names.link,
+                        href: href ?? '#',
+                        "data-scene-nav-link": key,
+                        "aria-current": active ? 'page' : undefined,
+                        "aria-expanded": parent && !destination ? expanded : undefined,
+                        tabIndex: key === stop ? 0 : -1,
+                        onClick: onClick,
+                        onFocus: ()=>setFocused(key),
+                        children: content
+                    }) : /*#__PURE__*/ jsxRuntime.jsx("span", {
+                        className: names.link,
+                        "aria-disabled": "true",
+                        "data-scene-nav-link": key,
+                        tabIndex: -1,
+                        children: content
+                    }),
+                    parent && /*#__PURE__*/ jsxRuntime.jsx("button", {
+                        type: "button",
+                        className: names.toggle,
+                        tabIndex: -1,
+                        "aria-expanded": expanded,
+                        "aria-controls": `${key}-items`,
+                        "aria-label": `${expanded ? 'Collapse' : 'Expand'} ${item.title}`,
+                        onClick: ()=>toggle(key, !expanded)
+                    }),
+                    parent && expanded && /*#__PURE__*/ jsxRuntime.jsx("ul", {
+                        id: `${key}-items`,
+                        className: `${names.list} ${names.submenu}`,
+                        children: renderItems(children, [
+                            ...path,
+                            item.id
+                        ], level + 1)
+                    })
+                ]
+            }, item.id);
+        });
+    return /*#__PURE__*/ jsxRuntime.jsx("nav", {
+        ref: root,
+        className: names.root,
+        "aria-label": label ?? (sidebar ? 'Sidebar' : 'Topbar'),
+        "data-scene-nav-region": region,
+        "data-scene-nav-sources": resolved.sources.kind,
+        "data-scene-nav-sources-label": resolved.sources.label,
+        "data-scene-nav-module": scope,
+        "data-scene-nav-mode": resolved.mode,
+        onKeyDown: onKeyDown,
+        children: /*#__PURE__*/ jsxRuntime.jsx("ul", {
+            className: names.list,
+            children: renderItems(visible, [], 0)
+        })
+    });
+}
+
+exports.NavigationRegionView = NavigationRegionView;
+//# sourceMappingURL=NavigationRegionView.js.map

package/dist/cjs/navigation/region/NavigationRegionView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationRegionView.js","sources":["../../../../navigation/region/NavigationRegionView.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 { KeyboardEvent, MouseEvent, ReactNode, useContext, useMemo, useRef, useState } from 'react';\nimport { DestinationReference, NavigationRegionKind, parseIconReference } from '@cratis/scene.model';\nimport { ApplicationStructureIndex, EffectiveNavItem, EffectiveNavigationRegion, effectiveNavigation } from '@cratis/scene.engine';\nimport { SceneIcon } from '../../icons/SceneIcon';\nimport { useIconAdapters } from '../../icons/IconAdapterContext';\nimport { resolveDestination } from '../resolveDestination';\nimport { SceneNavigationContextInternal } from '../SceneNavigationContext';\nimport { NavigationRegionClassNames, defaultNavigationRegionClassNames } from './NavigationRegionClassNames';\nimport { SceneNavigationModel } from './SceneNavigationModel';\nimport { useSceneNavigationModel } from './SceneNavigationModelContext';\nimport { currentModuleOf } from './currentModuleOf';\nimport { navigationItemActive } from './navigationItemActive';\nimport { defaultScreenFor, navigationItemDestination } from './navigationItemDestination';\n\nexport interface NavigationRegionViewProps {\n    /** Which region to show. */\n    region: NavigationRegionKind;\n\n    /**\n     * The module to show the region of. When absent the region follows the module of the screen on the page, so\n     * navigating to another module recomputes the effective items in place; outside every module it is the application's.\n     */\n    module?: string;\n\n    /** Pins the region to the application level, whatever screen is on the page. */\n    application?: boolean;\n\n    /** What to resolve against; the {@link SceneNavigationModelProvider}'s when absent. */\n    model?: SceneNavigationModel;\n\n    /**\n     * Which sub-items of a sidebar show: only those of the parents of the active item and of items the user expanded\n     * (`active`, the default), or all of them (`all`) - a design layer wants the whole hierarchy.\n     */\n    expand?: 'active' | 'all';\n\n    /** The accessible name of the `nav` landmark. */\n    label?: string;\n\n    /** The class names to put on the nodes. */\n    classNames?: Partial<NavigationRegionClassNames>;\n\n    /**\n     * Draws an item's icon from its qualified reference. By default the icon is drawn through the adapters of the\n     * enclosing `IconAdapterProvider`, or not at all without one.\n     */\n    renderIcon?(icon: string): ReactNode;\n\n    /**\n     * Content a host adds to an item after its title - Studio design mode draws the lock of an inherited item here; Stage\n     * ignores it. The item carries `origin` and `readOnly`.\n     */\n    renderAdornment?(item: EffectiveNavItem): ReactNode;\n\n    /** The href of an item's link, for opening it in a new tab; the hash route of the destination by default. */\n    hrefFor?(destination: DestinationReference, url: string | undefined): string | undefined;\n\n    /** Called after an item has been activated and the host has navigated. */\n    onActivate?(item: EffectiveNavItem, destination: DestinationReference): void;\n}\n\nfunction itemKey(path: string[]): string {\n    return path.join('/');\n}\n\nfunction containsActive(item: EffectiveNavItem, isActive: (item: EffectiveNavItem) => boolean): boolean {\n    return isActive(item) || (item.children ?? []).some(child => containsActive(child, isActive));\n}\n\n/**\n * Renders the effective navigation of one region - a topbar or a sidebar - for the application or a module.\n *\n * - **Items** come from `effectiveNavigation`, so inherit/extend/override is already applied; nothing here re-implements\n *   it. A topbar is flat; a sidebar nests, collapses, and expands the parents of the active item.\n * - **Active state** follows what the navigation host shows: an item is active (`aria-current`, `data-active`) when the\n *   screen it opens is the one in its slot, so items rendering into different slots are active at once.\n * - **Activation** goes through the enclosing navigation host (`navigate`), which renders the target in the item's slot -\n *   the `outlet` of the destination; outside a host it announces `cratis.scene.navigate`.\n * - **Authorization**: `isVisible` of the model hides items, it does not disable them.\n * - **Keyboard**: arrows (left/right in a topbar, up/down in a sidebar), Home and End move between items; in a sidebar\n *   right expands and left collapses (or goes to the parent).\n *\n * Nothing here draws design chrome: items carry `data-read-only` and `data-origin` for a design layer to style.\n */\nexport function NavigationRegionView({ region, module, application = false, model: modelProp, label, expand = 'active', classNames, renderIcon, renderAdornment, hrefFor, onActivate }: NavigationRegionViewProps) {\n    const contextModel = useSceneNavigationModel();\n    const model = modelProp ?? contextModel;\n    if (!model) throw new Error('NavigationRegionView needs a navigation model: pass `model` or render it inside a SceneNavigationModelProvider.');\n\n    const navigation = useContext(SceneNavigationContextInternal);\n    const adapters = useIconAdapters();\n    const names = { ...defaultNavigationRegionClassNames, ...classNames };\n    const index = useMemo(() => model.structure instanceof ApplicationStructureIndex ? model.structure : new ApplicationStructureIndex(model.structure), [model.structure]);\n    const screenFor = model.screenFor ?? defaultScreenFor;\n\n    const sidebar = region === NavigationRegionKind.Sidebar;\n    const placement = useMemo(() => ({ primaryScreen: navigation?.primaryScreen, outlets: navigation?.outlets ?? {} }), [navigation?.outlets, navigation?.primaryScreen]);\n    const scope = application ? undefined : module ?? currentModuleOf(index, placement.primaryScreen);\n    const resolved: EffectiveNavigationRegion = useMemo(() => effectiveNavigation(index, model.navigation, scope, region), [index, model.navigation, scope, region]);\n\n    const isActive = (item: EffectiveNavItem) => placement.primaryScreen !== undefined && navigationItemActive(item, { primaryScreen: placement.primaryScreen, outlets: placement.outlets }, screenFor, !sidebar);\n    const isVisible = model.isVisible ?? (() => true);\n    const visible = useMemo(() => {\n        const keep = (items: EffectiveNavItem[]): EffectiveNavItem[] => items.filter(isVisible).map(item => item.children ? { ...item, children: keep(item.children) } : item);\n        return keep(resolved.items);\n    }, [resolved, model.isVisible]);\n\n    const activeKey = JSON.stringify([placement.primaryScreen, placement.outlets, scope]);\n    const [toggled, setToggled] = useState<{ key: string; state: Record<string, boolean> }>({ key: activeKey, state: {} });\n    const overrides = toggled.key === activeKey ? toggled.state : {};\n    const [focused, setFocused] = useState<string>();\n    const root = useRef<HTMLElement>(null);\n\n    const isExpanded = (item: EffectiveNavItem, key: string) => overrides[key] ?? (expand === 'all' || containsActive(item, isActive));\n    const toggle = (key: string, expanded: boolean) => setToggled({ key: activeKey, state: { ...overrides, [key]: expanded } });\n\n    const activate = (item: EffectiveNavItem) => {\n        const destination = navigationItemDestination(item, screenFor);\n        if (destination === undefined) return;\n        if (navigation) {\n            navigation.navigate(destination);\n        } else {\n            globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', { detail: { targetScreen: destination.screen ?? '', destination, item } }));\n        }\n\n        onActivate?.(item, destination);\n    };\n\n    const links = () => Array.from(root.current?.querySelectorAll<HTMLElement>('[data-scene-nav-link]') ?? []);\n    const focusLink = (element: HTMLElement | undefined) => {\n        if (!element) return;\n        setFocused(element.getAttribute('data-scene-nav-link') ?? undefined);\n        element.focus();\n    };\n\n    const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n        const all = links();\n        const position = all.findIndex(link => link === document.activeElement);\n        if (position < 0) return;\n        const next = sidebar ? 'ArrowDown' : 'ArrowRight';\n        const previous = sidebar ? 'ArrowUp' : 'ArrowLeft';\n        const current = all[position];\n        const key = current.getAttribute('data-scene-nav-link')!;\n        const owner = current.closest('[data-scene-nav-item]') as HTMLElement | null;\n        const hasChildren = owner?.getAttribute('data-scene-nav-parent') === 'true';\n        const expanded = owner?.getAttribute('data-expanded') === 'true';\n\n        let target: HTMLElement | undefined;\n        if (event.key === next) target = all[Math.min(position + 1, all.length - 1)];\n        else if (event.key === previous) target = all[Math.max(position - 1, 0)];\n        else if (event.key === 'Home') target = all[0];\n        else if (event.key === 'End') target = all[all.length - 1];\n        else if (sidebar && event.key === 'ArrowRight' && hasChildren) {\n            if (!expanded) toggle(key, true);\n            else target = all[position + 1];\n        } else if (sidebar && event.key === 'ArrowLeft') {\n            if (hasChildren && expanded) toggle(key, false);\n            else {\n                const parent = owner?.parentElement?.closest('[data-scene-nav-item]')?.querySelector<HTMLElement>(':scope > [data-scene-nav-link]');\n                if (parent) target = parent;\n            }\n        } else return;\n\n        event.preventDefault();\n        focusLink(target);\n    };\n\n    const tabStop = focused ?? undefined;\n    const firstActive = (items: EffectiveNavItem[], path: string[]): string | undefined => {\n        for (const item of items) {\n            const key = itemKey([...path, item.id]);\n            if (isActive(item)) return key;\n            const inner = firstActive(item.children ?? [], [...path, item.id]);\n            if (inner !== undefined && isExpanded(item, key)) return inner;\n        }\n\n        return undefined;\n    };\n    const firstKey = visible.length > 0 ? itemKey([visible[0].id]) : undefined;\n    const stop = tabStop ?? firstActive(visible, []) ?? firstKey;\n\n    const icon = (item: EffectiveNavItem) => {\n        if (item.icon === undefined) return null;\n        const drawn = renderIcon ? renderIcon(item.icon) : adapters ? (() => {\n            const reference = parseIconReference(item.icon!);\n            return reference ? <SceneIcon reference={reference} adapters={adapters} /> : null;\n        })() : null;\n        return drawn === null ? null : <span className={names.icon} aria-hidden='true' data-scene-icon={item.icon}>{drawn}</span>;\n    };\n\n    const renderItems = (items: EffectiveNavItem[], path: string[], level: number): ReactNode => items.map(item => {\n        const key = itemKey([...path, item.id]);\n        const destination = navigationItemDestination(item, screenFor);\n        const active = isActive(item);\n        const children = item.children ?? [];\n        const parent = sidebar && children.length > 0;\n        const expanded = parent && isExpanded(item, key);\n        const url = destination ? resolveDestination(destination).url : undefined;\n        const href = destination ? (hrefFor ? hrefFor(destination, url) : url ? `#/${url}` : undefined) : undefined;\n        const onClick = (event: MouseEvent) => {\n            if (event.metaKey || event.ctrlKey || event.shiftKey || event.button !== 0) return;\n            event.preventDefault();\n            if (destination) activate(item);\n            else if (parent) toggle(key, !expanded);\n        };\n        const content = <>\n            {icon(item)}\n            <span className={names.label}>{item.title}</span>\n            {renderAdornment?.(item)}\n        </>;\n\n        return <li key={item.id} className={names.item} data-scene-nav-item={item.id} data-scene-nav-parent={parent ? 'true' : undefined}\n            data-active={active} data-active-descendant={!active && parent && children.some(child => containsActive(child, isActive)) ? true : undefined} data-expanded={parent ? expanded : undefined} data-origin={item.origin} data-read-only={item.readOnly}\n            data-slot={item.slot} data-level={level}>\n            {destination || parent\n                ? <a className={names.link} href={href ?? '#'} data-scene-nav-link={key} aria-current={active ? 'page' : undefined}\n                    aria-expanded={parent && !destination ? expanded : undefined} tabIndex={key === stop ? 0 : -1}\n                    onClick={onClick} onFocus={() => setFocused(key)}>{content}</a>\n                : <span className={names.link} aria-disabled='true' data-scene-nav-link={key} tabIndex={-1}>{content}</span>}\n            {parent && <button type='button' className={names.toggle} tabIndex={-1} aria-expanded={expanded} aria-controls={`${key}-items`}\n                aria-label={`${expanded ? 'Collapse' : 'Expand'} ${item.title}`} onClick={() => toggle(key, !expanded)} />}\n            {parent && expanded && <ul id={`${key}-items`} className={`${names.list} ${names.submenu}`}>{renderItems(children, [...path, item.id], level + 1)}</ul>}\n        </li>;\n    });\n\n    return <nav ref={root} className={names.root} aria-label={label ?? (sidebar ? 'Sidebar' : 'Topbar')} data-scene-nav-region={region}\n        data-scene-nav-sources={resolved.sources.kind} data-scene-nav-sources-label={resolved.sources.label} data-scene-nav-module={scope}\n        data-scene-nav-mode={resolved.mode} onKeyDown={onKeyDown}>\n        <ul className={names.list}>{renderItems(visible, [], 0)}</ul>\n    </nav>;\n}\n"],"names":["itemKey","path","join","containsActive","item","isActive","children","some","child","NavigationRegionView","region","module","application","model","modelProp","label","expand","classNames","renderIcon","renderAdornment","hrefFor","onActivate","contextModel","useSceneNavigationModel","Error","navigation","useContext","SceneNavigationContextInternal","adapters","useIconAdapters","names","defaultNavigationRegionClassNames","index","useMemo","structure","ApplicationStructureIndex","screenFor","defaultScreenFor","sidebar","NavigationRegionKind","Sidebar","placement","primaryScreen","outlets","scope","undefined","currentModuleOf","resolved","effectiveNavigation","navigationItemActive","isVisible","visible","keep","items","filter","map","activeKey","JSON","stringify","toggled","setToggled","useState","key","state","overrides","focused","setFocused","root","useRef","isExpanded","toggle","expanded","activate","destination","navigationItemDestination","navigate","globalThis","dispatchEvent","CustomEvent","detail","targetScreen","screen","links","Array","from","current","querySelectorAll","focusLink","element","getAttribute","focus","onKeyDown","event","all","position","findIndex","link","document","activeElement","next","previous","owner","closest","hasChildren","target","Math","min","length","max","parent","parentElement","querySelector","preventDefault","tabStop","firstActive","id","inner","firstKey","stop","icon","drawn","reference","parseIconReference","_jsx","SceneIcon","span","className","aria-hidden","data-scene-icon","renderItems","level","active","url","resolveDestination","href","onClick","metaKey","ctrlKey","shiftKey","button","content","_jsxs","_Fragment","title","li","data-scene-nav-item","data-scene-nav-parent","data-active","data-active-descendant","data-expanded","data-origin","origin","data-read-only","readOnly","data-slot","slot","data-level","a","data-scene-nav-link","aria-current","aria-expanded","tabIndex","onFocus","aria-disabled","type","aria-controls","aria-label","ul","list","submenu","nav","ref","data-scene-nav-region","data-scene-nav-sources","sources","kind","data-scene-nav-sources-label","data-scene-nav-module","data-scene-nav-mode","mode"],"mappings":"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"}

package/dist/cjs/navigation/region/SceneNavigationModelContext.js

@@ -0,0 +1,22 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+
+const Context = /*#__PURE__*/ react.createContext(undefined);
+/**
+ * Supplies the application structure and navigation every navigation region below it renders - the topbar and sidebar
+ * components of a shell find what to show here, so a screen document does not carry the application's navigation.
+ */ function SceneNavigationModelProvider({ model, children }) {
+    return /*#__PURE__*/ jsxRuntime.jsx(Context.Provider, {
+        value: model,
+        children: children
+    });
+}
+/** The navigation model in scope, or undefined outside a {@link SceneNavigationModelProvider}. */ function useSceneNavigationModel() {
+    return react.useContext(Context);
+}
+
+exports.SceneNavigationModelProvider = SceneNavigationModelProvider;
+exports.useSceneNavigationModel = useSceneNavigationModel;
+//# sourceMappingURL=SceneNavigationModelContext.js.map

package/dist/cjs/navigation/region/SceneNavigationModelContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneNavigationModelContext.js","sources":["../../../../navigation/region/SceneNavigationModelContext.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 { SceneNavigationModel } from './SceneNavigationModel';\n\nconst Context = createContext<SceneNavigationModel | undefined>(undefined);\n\nexport interface SceneNavigationModelProviderProps {\n    model: SceneNavigationModel;\n    children?: ReactNode;\n}\n\n/**\n * Supplies the application structure and navigation every navigation region below it renders - the topbar and sidebar\n * components of a shell find what to show here, so a screen document does not carry the application's navigation.\n */\nexport function SceneNavigationModelProvider({ model, children }: SceneNavigationModelProviderProps) {\n    return <Context.Provider value={model}>{children}</Context.Provider>;\n}\n\n/** The navigation model in scope, or undefined outside a {@link SceneNavigationModelProvider}. */\nexport function useSceneNavigationModel(): SceneNavigationModel | undefined {\n    return useContext(Context);\n}\n"],"names":["Context","createContext","undefined","SceneNavigationModelProvider","model","children","_jsx","Provider","value","useSceneNavigationModel","useContext"],"mappings":";;;;;AAMA,MAAMA,wBAAUC,mBAAAA,CAAgDC,SAAAA,CAAAA;AAOhE;;;AAGC,IACM,SAASC,4BAAAA,CAA6B,EAAEC,KAAK,EAAEC,QAAQ,EAAqC,EAAA;IAC/F,qBAAOC,cAAA,CAACN,QAAQO,QAAQ,EAAA;QAACC,KAAAA,EAAOJ,KAAAA;AAAQC,QAAAA,QAAAA,EAAAA;;AAC5C;AAEA,mGACO,SAASI,uBAAAA,GAAAA;AACZ,IAAA,OAAOC,gBAAAA,CAAWV,OAAAA,CAAAA;AACtB;;;"}

package/dist/cjs/navigation/region/currentModuleOf.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The module the screen on the page belongs to: the screen's qualified id starts with its module id, so `sales.orders`
+ * is in `sales`. Undefined for a screen outside every module - the application level.
+ */ function currentModuleOf(index, screen) {
+    if (screen === undefined) return undefined;
+    const module = screen.split('.')[0];
+    return index.findModule(module) ? module : undefined;
+}
+
+exports.currentModuleOf = currentModuleOf;
+//# sourceMappingURL=currentModuleOf.js.map

package/dist/cjs/navigation/region/currentModuleOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currentModuleOf.js","sources":["../../../../navigation/region/currentModuleOf.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 { ApplicationStructureIndex } from '@cratis/scene.engine';\n\n/**\n * The module the screen on the page belongs to: the screen's qualified id starts with its module id, so `sales.orders`\n * is in `sales`. Undefined for a screen outside every module - the application level.\n */\nexport function currentModuleOf(index: ApplicationStructureIndex, screen: string | undefined): string | undefined {\n    if (screen === undefined) return undefined;\n    const module = screen.split('.')[0];\n    return index.findModule(module) ? module : undefined;\n}\n"],"names":["currentModuleOf","index","screen","undefined","module","split","findModule"],"mappings":";;AAAA;AACA;AAIA;;;AAGC,IACM,SAASA,eAAAA,CAAgBC,KAAgC,EAAEC,MAA0B,EAAA;IACxF,IAAIA,MAAAA,KAAWC,WAAW,OAAOA,SAAAA;AACjC,IAAA,MAAMC,SAASF,MAAAA,CAAOG,KAAK,CAAC,GAAA,CAAI,CAAC,CAAA,CAAE;AACnC,IAAA,OAAOJ,KAAAA,CAAMK,UAAU,CAACF,MAAAA,CAAAA,GAAUA,MAAAA,GAASD,SAAAA;AAC/C;;"}