@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

package/dist/esm/core/navigation/useNavigationState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationState.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/useNavigationState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAqB,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAO/E;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAQ1D"}
+{"version":3,"file":"useNavigationState.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/useNavigationState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAqB,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAO/E;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAQ1D"}

package/dist/esm/core/navigation/useNavigationState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationState.js","sourceRoot":"","sources":["../../../../src/core/navigation/useNavigationState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG,MAAM,MAAM,GAA0B,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACxE,MAAM,QAAQ,GAAiE,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACxH,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * useNavigationState Hook\n * \n * Hook to access navigation state from NavigationContext.\n * Separated from NavigationContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { NavigationContext, NavigationContextType } from './NavigationContext';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('useNavigationState');\nlogger.setDebugTypeLogging('useNavigationState', false);\n\n/**\n * Hook to access navigation state and actions\n */\nexport function useNavigationState(): NavigationContextType {\n  const context = useContext(NavigationContext);\n  \n  if (!context) {\n    throw new Error('useNavigationState must be used within a NavigationProvider');\n  }\n  \n  return context;\n}\n\n\n\n\n"]}
+{"version":3,"file":"useNavigationState.js","sourceRoot":"","sources":["../../../../../src/core/navigation/useNavigationState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG,MAAM,MAAM,GAA0B,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACxE,MAAM,QAAQ,GAAiE,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACxH,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * useNavigationState Hook\n * \n * Hook to access navigation state from NavigationContext.\n * Separated from NavigationContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { NavigationContext, NavigationContextType } from './NavigationContext';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('useNavigationState');\nlogger.setDebugTypeLogging('useNavigationState', false);\n\n/**\n * Hook to access navigation state and actions\n */\nexport function useNavigationState(): NavigationContextType {\n  const context = useContext(NavigationContext);\n  \n  if (!context) {\n    throw new Error('useNavigationState must be used within a NavigationProvider');\n  }\n  \n  return context;\n}\n\n\n\n\n"]}

package/dist/esm/core/navigation/useOverlayTitle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOverlayTitle.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/useOverlayTitle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AA0B9B;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAmEnH"}
+{"version":3,"file":"useOverlayTitle.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/useOverlayTitle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AA0B9B;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CA+DnH"}

package/dist/esm/core/navigation/useOverlayTitle.js

@@ -54,11 +54,8 @@ export function useOverlayTitle(topEntry) {
         const { content } = topEntry;
         if (content.contentType === NavigationContentType.RESOURCE_OPERATION) {
             const { resourceType, operationIdentifier } = content.resourceContext;
-            const operationTitle = tResourceOperation(resourceType, operationIdentifier, 'title');
-            if (operationTitle) {
-                return { title: operationTitle };
-            }
-            return { title: '' };
+            // Never empty: an ungenerated operation title is its key path (#1450).
+            return { title: tResourceOperation(resourceType, operationIdentifier, 'title') };
         }
         if (isOverlayTitleViewContent(content)) {
             return {

package/dist/esm/core/navigation/useOverlayTitle.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOverlayTitle.js","sourceRoot":"","sources":["../../../../src/core/navigation/useOverlayTitle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOverlayTitle Hook\n * \n * Separated from NavigationContentAreas.tsx for React Fast Refresh compatibility.\n */\n\nimport { useMemo } from 'react';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport {\n  NavigationContentType,\n  type NavigationContent,\n  type NavigationStackEntry,\n} from './navigation.schemas';\nimport {\n  buildCompositeViewLabelKey,\n  buildNavigationViewLabelKey,\n  resolveCompositeViewTranslationRef,\n  resolveNavigationViewLabelTarget,\n  resolveNavigationViewTitle,\n} from './view-title-resolution';\n\ntype OverlayTitleViewContent = Extract<\n  NavigationContent,\n  { viewRef: string }\n>;\n\nfunction isOverlayTitleViewContent(\n  content: NavigationContent,\n): content is OverlayTitleViewContent {\n  return (\n    content.contentType === NavigationContentType.COMPOSITE_VIEW\n    || content.contentType === NavigationContentType.CHART_VIEW\n    || content.contentType === NavigationContentType.FULL_CUSTOM_VIEW\n    || content.contentType === NavigationContentType.FLOWS_ACTORS_VIEW\n    || content.contentType === NavigationContentType.EXECUTION_VIEW\n  );\n}\n\n/**\n * Derive overlay title/description from the navigation stack entry.\n * Resource operations resolve through their operation title contract.\n * Composite and other view families resolve through their dedicated\n * translation-ref-based view title contracts.\n */\nexport function useOverlayTitle(topEntry: NavigationStackEntry | undefined): { title: string; description?: string } {\n  const resourceType = topEntry?.content?.contentType === NavigationContentType.RESOURCE_OPERATION\n    ? topEntry.content.resourceContext.resourceType\n    : undefined;\n  const compositeLabelKeys = useMemo(() => {\n    if (topEntry?.content.contentType !== NavigationContentType.COMPOSITE_VIEW) {\n      return [];\n    }\n\n    const translationRef = resolveCompositeViewTranslationRef(topEntry.content.viewRef);\n    return translationRef ? [buildCompositeViewLabelKey(translationRef)] : [];\n  }, [topEntry]);\n  const viewLabelKeys = useMemo(() => {\n    const content = topEntry?.content;\n    if (\n      !content\n      || !isOverlayTitleViewContent(content)\n      || content.contentType === NavigationContentType.COMPOSITE_VIEW\n    ) {\n      return [];\n    }\n\n    const viewTarget = resolveNavigationViewLabelTarget({\n      viewRef: content.viewRef,\n      contentType: content.contentType,\n    });\n    return viewTarget ? [buildNavigationViewLabelKey(viewTarget)] : [];\n  }, [topEntry]);\n  const { tResourceOperation, tCompositeView, tView } = useI18n({\n    resource: resourceType,\n    keys: [...compositeLabelKeys, ...viewLabelKeys],\n  });\n\n  return useMemo(() => {\n    if (!topEntry) return { title: '' };\n\n    const { content } = topEntry;\n\n    if (content.contentType === NavigationContentType.RESOURCE_OPERATION) {\n      const { resourceType, operationIdentifier } = content.resourceContext;\n\n      const operationTitle = tResourceOperation(resourceType, operationIdentifier, 'title');\n      if (operationTitle) {\n        return { title: operationTitle };\n      }\n\n      return { title: '' };\n    }\n\n    if (isOverlayTitleViewContent(content)) {\n      return {\n        title: resolveNavigationViewTitle({\n          viewRef: content.viewRef,\n          contentType: content.contentType,\n          tCompositeView,\n          tView,\n        }),\n      };\n    }\n\n    if (content.contentType === NavigationContentType.SETTINGS_HUB) {\n      // i18n for the hub title is wired in the settings-hub i18n slice; literal for now.\n      return { title: 'Settings' };\n    }\n\n    return { title: '' };\n  }, [topEntry, tCompositeView, tResourceOperation, tView]);\n}\n"]}
+{"version":3,"file":"useOverlayTitle.js","sourceRoot":"","sources":["../../../../../src/core/navigation/useOverlayTitle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOverlayTitle Hook\n * \n * Separated from NavigationContentAreas.tsx for React Fast Refresh compatibility.\n */\n\nimport { useMemo } from 'react';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport {\n  NavigationContentType,\n  type NavigationContent,\n  type NavigationStackEntry,\n} from './navigation.schemas';\nimport {\n  buildCompositeViewLabelKey,\n  buildNavigationViewLabelKey,\n  resolveCompositeViewTranslationRef,\n  resolveNavigationViewLabelTarget,\n  resolveNavigationViewTitle,\n} from './view-title-resolution';\n\ntype OverlayTitleViewContent = Extract<\n  NavigationContent,\n  { viewRef: string }\n>;\n\nfunction isOverlayTitleViewContent(\n  content: NavigationContent,\n): content is OverlayTitleViewContent {\n  return (\n    content.contentType === NavigationContentType.COMPOSITE_VIEW\n    || content.contentType === NavigationContentType.CHART_VIEW\n    || content.contentType === NavigationContentType.FULL_CUSTOM_VIEW\n    || content.contentType === NavigationContentType.FLOWS_ACTORS_VIEW\n    || content.contentType === NavigationContentType.EXECUTION_VIEW\n  );\n}\n\n/**\n * Derive overlay title/description from the navigation stack entry.\n * Resource operations resolve through their operation title contract.\n * Composite and other view families resolve through their dedicated\n * translation-ref-based view title contracts.\n */\nexport function useOverlayTitle(topEntry: NavigationStackEntry | undefined): { title: string; description?: string } {\n  const resourceType = topEntry?.content?.contentType === NavigationContentType.RESOURCE_OPERATION\n    ? topEntry.content.resourceContext.resourceType\n    : undefined;\n  const compositeLabelKeys = useMemo(() => {\n    if (topEntry?.content.contentType !== NavigationContentType.COMPOSITE_VIEW) {\n      return [];\n    }\n\n    const translationRef = resolveCompositeViewTranslationRef(topEntry.content.viewRef);\n    return translationRef ? [buildCompositeViewLabelKey(translationRef)] : [];\n  }, [topEntry]);\n  const viewLabelKeys = useMemo(() => {\n    const content = topEntry?.content;\n    if (\n      !content\n      || !isOverlayTitleViewContent(content)\n      || content.contentType === NavigationContentType.COMPOSITE_VIEW\n    ) {\n      return [];\n    }\n\n    const viewTarget = resolveNavigationViewLabelTarget({\n      viewRef: content.viewRef,\n      contentType: content.contentType,\n    });\n    return viewTarget ? [buildNavigationViewLabelKey(viewTarget)] : [];\n  }, [topEntry]);\n  const { tResourceOperation, tCompositeView, tView } = useI18n({\n    resource: resourceType,\n    keys: [...compositeLabelKeys, ...viewLabelKeys],\n  });\n\n  return useMemo(() => {\n    if (!topEntry) return { title: '' };\n\n    const { content } = topEntry;\n\n    if (content.contentType === NavigationContentType.RESOURCE_OPERATION) {\n      const { resourceType, operationIdentifier } = content.resourceContext;\n\n      // Never empty: an ungenerated operation title is its key path (#1450).\n      return { title: tResourceOperation(resourceType, operationIdentifier, 'title') };\n    }\n\n    if (isOverlayTitleViewContent(content)) {\n      return {\n        title: resolveNavigationViewTitle({\n          viewRef: content.viewRef,\n          contentType: content.contentType,\n          tCompositeView,\n          tView,\n        }),\n      };\n    }\n\n    if (content.contentType === NavigationContentType.SETTINGS_HUB) {\n      // i18n for the hub title is wired in the settings-hub i18n slice; literal for now.\n      return { title: 'Settings' };\n    }\n\n    return { title: '' };\n  }, [topEntry, tCompositeView, tResourceOperation, tView]);\n}\n"]}

package/dist/esm/core/navigation/useSynchronousBrowserLocation.d.ts

@@ -0,0 +1,58 @@
+import { type Location } from 'react-router-dom';
+/**
+ * The browser location as the data router holds it NOW, for reconcilers that must observe every
+ * URL the router moves through.
+ *
+ * ## Why `useLocation()` is not enough for them
+ *
+ * `RouterProvider` runs with `future.v7_startTransition`, so the location context commits inside a
+ * React TRANSITION. A transition yields to every more urgent update, and a later transition supersedes
+ * a pending one — so the committed location can skip an intermediate URL entirely. Measured 2026-09-14
+ * on Wonder Todos (`browser-nav-breadcrumb`, about half of runs): a crumb click pushed the list READ,
+ * the page kept committing sync updates, and the list location transition was still pending when
+ * browser back arrived. The committed location went straight from the todo URL to the todo URL.
+ *
+ * `useStructuralZoneBackForwardSync` keys on "the URL I last synced". It had last synced the todo URL,
+ * never saw the list, so back looked like no change: no POP, and the list page stayed on screen under
+ * the todo URL.
+ *
+ * `router.state.location` is updated synchronously by every navigation and every popstate, and
+ * `useSyncExternalStore` re-renders at sync priority, so no URL can be coalesced away before a
+ * reconciler reads it.
+ *
+ * ## Who should use it, and who should not
+ *
+ * The ALWAYS-MOUNTED reconcilers — structural back/forward, hosted pane, settings-hub overlay. They
+ * answer "what does the browser address?" and are not bound to a route match.
+ *
+ * NOT the route-mounted sync hooks (`useRouterSync`, `useViewRouterSync`, `useEnginePageRouterSync`,
+ * the chart sync). They render inside the matched route element and must read the location that
+ * match committed with; reading ahead of their own match would reconcile the old route's params
+ * against the new URL.
+ *
+ * Outside a data router (a `MemoryRouter` test harness) this is exactly `useLocation()`.
+ */
+export declare function useSynchronousBrowserLocation(): Location;
+/**
+ * `true` while the router has already moved to a URL the committed location context has not rendered yet.
+ *
+ * The ROUTE-MOUNTED sync hooks rebuild navigation state from `useLocation()` — correctly, because they
+ * render inside their matched route. But while a location transition is pending, that committed location
+ * names a page the browser has LEFT. Rebuilding from it restores the previous page, and once the
+ * always-mounted reconciler (which reads the router directly) sees the new URL and clears it, the two
+ * alternate: measured 2026-09-15 on `browser-org-switch`, where an organization switch replaced the URL
+ * with `/` and `useRouterSync`, still rendering the previous organization's todos route, re-pushed that
+ * list after every clear. The previous tenant's rows stayed on screen.
+ *
+ * A hook that reads this defers exactly as it does for a navigation transaction. Its effect re-runs when
+ * the committed location catches up, because `useLocation()` is already one of its dependencies.
+ *
+ * Compares the ADDRESS (`pathname` + `search`), never the history `key`: a key differs for a replace to
+ * the same URL, which is not a pending move.
+ *
+ * Assumes the data router has NO `basename` — true of `ApplicationMainContext`'s `createBrowserRouter` today.
+ * `router.state.location.pathname` keeps a basename that `useLocation()` strips, so adding one would make this
+ * permanently `true` and silently stop every route-mounted sync. Strip the basename here in the same change.
+ */
+export declare function useRouterLocationAheadOfCommit(committedLocation: Pick<Location, 'pathname' | 'search'>): boolean;
+//# sourceMappingURL=useSynchronousBrowserLocation.d.ts.map

package/dist/esm/core/navigation/useSynchronousBrowserLocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSynchronousBrowserLocation.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/useSynchronousBrowserLocation.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,6BAA6B,IAAI,QAAQ,CAWxD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,8BAA8B,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG,OAAO,CAGhH"}

package/dist/esm/core/navigation/useSynchronousBrowserLocation.js

@@ -0,0 +1,68 @@
+import { useCallback, useContext, useSyncExternalStore } from 'react';
+import { UNSAFE_DataRouterContext, useLocation } from 'react-router-dom';
+/**
+ * The browser location as the data router holds it NOW, for reconcilers that must observe every
+ * URL the router moves through.
+ *
+ * ## Why `useLocation()` is not enough for them
+ *
+ * `RouterProvider` runs with `future.v7_startTransition`, so the location context commits inside a
+ * React TRANSITION. A transition yields to every more urgent update, and a later transition supersedes
+ * a pending one — so the committed location can skip an intermediate URL entirely. Measured 2026-09-14
+ * on Wonder Todos (`browser-nav-breadcrumb`, about half of runs): a crumb click pushed the list READ,
+ * the page kept committing sync updates, and the list location transition was still pending when
+ * browser back arrived. The committed location went straight from the todo URL to the todo URL.
+ *
+ * `useStructuralZoneBackForwardSync` keys on "the URL I last synced". It had last synced the todo URL,
+ * never saw the list, so back looked like no change: no POP, and the list page stayed on screen under
+ * the todo URL.
+ *
+ * `router.state.location` is updated synchronously by every navigation and every popstate, and
+ * `useSyncExternalStore` re-renders at sync priority, so no URL can be coalesced away before a
+ * reconciler reads it.
+ *
+ * ## Who should use it, and who should not
+ *
+ * The ALWAYS-MOUNTED reconcilers — structural back/forward, hosted pane, settings-hub overlay. They
+ * answer "what does the browser address?" and are not bound to a route match.
+ *
+ * NOT the route-mounted sync hooks (`useRouterSync`, `useViewRouterSync`, `useEnginePageRouterSync`,
+ * the chart sync). They render inside the matched route element and must read the location that
+ * match committed with; reading ahead of their own match would reconcile the old route's params
+ * against the new URL.
+ *
+ * Outside a data router (a `MemoryRouter` test harness) this is exactly `useLocation()`.
+ */
+export function useSynchronousBrowserLocation() {
+    const committedLocation = useLocation();
+    const router = useContext(UNSAFE_DataRouterContext)?.router;
+    const subscribe = useCallback((onStoreChange) => (router ? router.subscribe(() => onStoreChange()) : () => undefined), [router]);
+    const getSnapshot = useCallback(() => router?.state.location ?? committedLocation, [router, committedLocation]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+/**
+ * `true` while the router has already moved to a URL the committed location context has not rendered yet.
+ *
+ * The ROUTE-MOUNTED sync hooks rebuild navigation state from `useLocation()` — correctly, because they
+ * render inside their matched route. But while a location transition is pending, that committed location
+ * names a page the browser has LEFT. Rebuilding from it restores the previous page, and once the
+ * always-mounted reconciler (which reads the router directly) sees the new URL and clears it, the two
+ * alternate: measured 2026-09-15 on `browser-org-switch`, where an organization switch replaced the URL
+ * with `/` and `useRouterSync`, still rendering the previous organization's todos route, re-pushed that
+ * list after every clear. The previous tenant's rows stayed on screen.
+ *
+ * A hook that reads this defers exactly as it does for a navigation transaction. Its effect re-runs when
+ * the committed location catches up, because `useLocation()` is already one of its dependencies.
+ *
+ * Compares the ADDRESS (`pathname` + `search`), never the history `key`: a key differs for a replace to
+ * the same URL, which is not a pending move.
+ *
+ * Assumes the data router has NO `basename` — true of `ApplicationMainContext`'s `createBrowserRouter` today.
+ * `router.state.location.pathname` keeps a basename that `useLocation()` strips, so adding one would make this
+ * permanently `true` and silently stop every route-mounted sync. Strip the basename here in the same change.
+ */
+export function useRouterLocationAheadOfCommit(committedLocation) {
+    const routerLocation = useSynchronousBrowserLocation();
+    return routerLocation.pathname !== committedLocation.pathname || routerLocation.search !== committedLocation.search;
+}
+//# sourceMappingURL=useSynchronousBrowserLocation.js.map

package/dist/esm/core/navigation/useSynchronousBrowserLocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSynchronousBrowserLocation.js","sourceRoot":"","sources":["../../../../../src/core/navigation/useSynchronousBrowserLocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAiB,MAAM,kBAAkB,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,iBAAiB,GAAG,WAAW,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAE5D,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,aAAyB,EAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EACjH,CAAC,MAAM,CAAC,CACT,CAAC;IACF,MAAM,WAAW,GAAG,WAAW,CAAC,GAAa,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,IAAI,iBAAiB,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE1H,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,8BAA8B,CAAC,iBAAwD;IACrG,MAAM,cAAc,GAAG,6BAA6B,EAAE,CAAC;IACvD,OAAO,cAAc,CAAC,QAAQ,KAAK,iBAAiB,CAAC,QAAQ,IAAI,cAAc,CAAC,MAAM,KAAK,iBAAiB,CAAC,MAAM,CAAC;AACtH,CAAC","sourcesContent":["import { useCallback, useContext, useSyncExternalStore } from 'react';\nimport { UNSAFE_DataRouterContext, useLocation, type Location } from 'react-router-dom';\n\n/**\n * The browser location as the data router holds it NOW, for reconcilers that must observe every\n * URL the router moves through.\n *\n * ## Why `useLocation()` is not enough for them\n *\n * `RouterProvider` runs with `future.v7_startTransition`, so the location context commits inside a\n * React TRANSITION. A transition yields to every more urgent update, and a later transition supersedes\n * a pending one — so the committed location can skip an intermediate URL entirely. Measured 2026-09-14\n * on Wonder Todos (`browser-nav-breadcrumb`, about half of runs): a crumb click pushed the list READ,\n * the page kept committing sync updates, and the list location transition was still pending when\n * browser back arrived. The committed location went straight from the todo URL to the todo URL.\n *\n * `useStructuralZoneBackForwardSync` keys on \"the URL I last synced\". It had last synced the todo URL,\n * never saw the list, so back looked like no change: no POP, and the list page stayed on screen under\n * the todo URL.\n *\n * `router.state.location` is updated synchronously by every navigation and every popstate, and\n * `useSyncExternalStore` re-renders at sync priority, so no URL can be coalesced away before a\n * reconciler reads it.\n *\n * ## Who should use it, and who should not\n *\n * The ALWAYS-MOUNTED reconcilers — structural back/forward, hosted pane, settings-hub overlay. They\n * answer \"what does the browser address?\" and are not bound to a route match.\n *\n * NOT the route-mounted sync hooks (`useRouterSync`, `useViewRouterSync`, `useEnginePageRouterSync`,\n * the chart sync). They render inside the matched route element and must read the location that\n * match committed with; reading ahead of their own match would reconcile the old route's params\n * against the new URL.\n *\n * Outside a data router (a `MemoryRouter` test harness) this is exactly `useLocation()`.\n */\nexport function useSynchronousBrowserLocation(): Location {\n  const committedLocation = useLocation();\n  const router = useContext(UNSAFE_DataRouterContext)?.router;\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void): (() => void) => (router ? router.subscribe(() => onStoreChange()) : () => undefined),\n    [router],\n  );\n  const getSnapshot = useCallback((): Location => router?.state.location ?? committedLocation, [router, committedLocation]);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n/**\n * `true` while the router has already moved to a URL the committed location context has not rendered yet.\n *\n * The ROUTE-MOUNTED sync hooks rebuild navigation state from `useLocation()` — correctly, because they\n * render inside their matched route. But while a location transition is pending, that committed location\n * names a page the browser has LEFT. Rebuilding from it restores the previous page, and once the\n * always-mounted reconciler (which reads the router directly) sees the new URL and clears it, the two\n * alternate: measured 2026-09-15 on `browser-org-switch`, where an organization switch replaced the URL\n * with `/` and `useRouterSync`, still rendering the previous organization's todos route, re-pushed that\n * list after every clear. The previous tenant's rows stayed on screen.\n *\n * A hook that reads this defers exactly as it does for a navigation transaction. Its effect re-runs when\n * the committed location catches up, because `useLocation()` is already one of its dependencies.\n *\n * Compares the ADDRESS (`pathname` + `search`), never the history `key`: a key differs for a replace to\n * the same URL, which is not a pending move.\n *\n * Assumes the data router has NO `basename` — true of `ApplicationMainContext`'s `createBrowserRouter` today.\n * `router.state.location.pathname` keeps a basename that `useLocation()` strips, so adding one would make this\n * permanently `true` and silently stop every route-mounted sync. Strip the basename here in the same change.\n */\nexport function useRouterLocationAheadOfCommit(committedLocation: Pick<Location, 'pathname' | 'search'>): boolean {\n  const routerLocation = useSynchronousBrowserLocation();\n  return routerLocation.pathname !== committedLocation.pathname || routerLocation.search !== committedLocation.search;\n}\n"]}

package/dist/esm/core/navigation/useTransactionAwareSyncRetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTransactionAwareSyncRetry.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/useTransactionAwareSyncRetry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,CAgBA"}
+{"version":3,"file":"useTransactionAwareSyncRetry.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/useTransactionAwareSyncRetry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,CAgBA"}

package/dist/esm/core/navigation/useTransactionAwareSyncRetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTransactionAwareSyncRetry.js","sourceRoot":"","sources":["../../../../src/core/navigation/useTransactionAwareSyncRetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAqC;IAKhF,KAAK,UAAU,CAAC;IAEhB,MAAM,SAAS,GAAG,oBAAoB,CACpC,eAAe,CAAC,2BAA2B,EAC3C,eAAe,CAAC,mBAAmB,EACnC,eAAe,CAAC,mBAAmB,CACpC,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAE9C,OAAO;QACL,SAAS;QACT,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nimport { NavigationUtils } from './navigation.utils';\n\n/**\n * Re-run a router-sync hook once the navigation transaction it deferred to has ended.\n *\n * ## What this replaced, and why the replacement is a different shape\n *\n * Router-sync hooks legitimately skip while a navigation transaction is active, and then need to run\n * again once it closes. That used to be a per-instance `setTimeout(0)` that bumped a per-instance\n * counter — and it lost the retry whenever the instance did not survive to see its own timer (#212).\n *\n * That is not an edge case, it is the common path. `useRouterSync` lives in the ROUTE ELEMENT, which\n * `NavigationContentAreas` renders only while PRIMARY's stack is empty. The back/forward reconciler\n * clears the structural zones inside a transaction precisely so that element MOUNTS and rebuilds — so\n * the instance that schedules the retry is routinely unmounted and replaced before it fires. Measured\n * on a browser back between two details: two instances each scheduled, the first unmounted and\n * cancelled its timer, and the reconstruction never ran. The detail then rendered through PRIMARY's\n * `routerChildren` fallback — in the wrong zone, with no error.\n *\n * The transaction is GLOBAL (a static flag), so the signal that it ended has to be global too. This\n * subscribes to that signal instead of racing it.\n *\n * ## Why an EPOCH and not an event\n *\n * A hook that mounts AFTER the transaction ended must not wait for a notification that already fired.\n * An epoch has no such hole: the newcomer reads the current value, finds `isInTransaction()` false, and\n * proceeds on its first run. `useSyncExternalStore` keeps that read consistent across concurrent\n * renders rather than sampling it in an effect.\n *\n * The returned shape is unchanged so call sites did not move. `scheduleRetry` and `clearRetry` are now\n * no-ops kept for exactly that reason — there is nothing per-instance left to schedule or cancel, and\n * a caller declaring \"I am deferring\" costs nothing and reads correctly at the call site.\n */\nexport function useTransactionAwareSyncRetry(currentUrl: string | null | undefined): {\n  retryTick: number;\n  scheduleRetry: () => void;\n  clearRetry: () => void;\n} {\n  void currentUrl;\n\n  const retryTick = useSyncExternalStore(\n    NavigationUtils.subscribeToTransactionState,\n    NavigationUtils.getTransactionEpoch,\n    NavigationUtils.getTransactionEpoch,\n  );\n\n  const noop = useCallback(() => undefined, []);\n\n  return {\n    retryTick,\n    scheduleRetry: noop,\n    clearRetry: noop,\n  };\n}\n"]}
+{"version":3,"file":"useTransactionAwareSyncRetry.js","sourceRoot":"","sources":["../../../../../src/core/navigation/useTransactionAwareSyncRetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAqC;IAKhF,KAAK,UAAU,CAAC;IAEhB,MAAM,SAAS,GAAG,oBAAoB,CACpC,eAAe,CAAC,2BAA2B,EAC3C,eAAe,CAAC,mBAAmB,EACnC,eAAe,CAAC,mBAAmB,CACpC,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAE9C,OAAO;QACL,SAAS;QACT,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nimport { NavigationUtils } from './navigation.utils';\n\n/**\n * Re-run a router-sync hook once the navigation transaction it deferred to has ended.\n *\n * ## What this replaced, and why the replacement is a different shape\n *\n * Router-sync hooks legitimately skip while a navigation transaction is active, and then need to run\n * again once it closes. That used to be a per-instance `setTimeout(0)` that bumped a per-instance\n * counter — and it lost the retry whenever the instance did not survive to see its own timer (#212).\n *\n * That is not an edge case, it is the common path. `useRouterSync` lives in the ROUTE ELEMENT, which\n * `NavigationContentAreas` renders only while PRIMARY's stack is empty. The back/forward reconciler\n * clears the structural zones inside a transaction precisely so that element MOUNTS and rebuilds — so\n * the instance that schedules the retry is routinely unmounted and replaced before it fires. Measured\n * on a browser back between two details: two instances each scheduled, the first unmounted and\n * cancelled its timer, and the reconstruction never ran. The detail then rendered through PRIMARY's\n * `routerChildren` fallback — in the wrong zone, with no error.\n *\n * The transaction is GLOBAL (a static flag), so the signal that it ended has to be global too. This\n * subscribes to that signal instead of racing it.\n *\n * ## Why an EPOCH and not an event\n *\n * A hook that mounts AFTER the transaction ended must not wait for a notification that already fired.\n * An epoch has no such hole: the newcomer reads the current value, finds `isInTransaction()` false, and\n * proceeds on its first run. `useSyncExternalStore` keeps that read consistent across concurrent\n * renders rather than sampling it in an effect.\n *\n * The returned shape is unchanged so call sites did not move. `scheduleRetry` and `clearRetry` are now\n * no-ops kept for exactly that reason — there is nothing per-instance left to schedule or cancel, and\n * a caller declaring \"I am deferring\" costs nothing and reads correctly at the call site.\n */\nexport function useTransactionAwareSyncRetry(currentUrl: string | null | undefined): {\n  retryTick: number;\n  scheduleRetry: () => void;\n  clearRetry: () => void;\n} {\n  void currentUrl;\n\n  const retryTick = useSyncExternalStore(\n    NavigationUtils.subscribeToTransactionState,\n    NavigationUtils.getTransactionEpoch,\n    NavigationUtils.getTransactionEpoch,\n  );\n\n  const noop = useCallback(() => undefined, []);\n\n  return {\n    retryTick,\n    scheduleRetry: noop,\n    clearRetry: noop,\n  };\n}\n"]}

package/dist/esm/core/navigation/view-title-resolution.d.ts

@@ -22,6 +22,24 @@ export declare function resolveNavigationViewLabelTarget(params: {
  * Composite views have a first-class translation identity and must resolve
  * through `composite_views.{translationRef}.title`. Other supported view
  * families resolve through `views.{family}.{translationRef}.title`.
+ *
+ * ## A missing title is never `''`
+ *
+ * Every caller NAMES something with the answer — a sidebar item, a command-menu entry, a dialog
+ * title, an inserted-view link — and `''` there is a control with no accessible name: still there,
+ * still focusable, and silent. axe reports it as a critical `button-name` (#1411), and a screen
+ * reader announces "button".
+ *
+ * `tCompositeView` / `tView` used to answer `''` for a missing title, so this function patched the
+ * gap with the view's own ref. Since #1450 the resolvers answer the KEY PATH themselves — one
+ * decision, in one place, for the header and the navigation control alike — so nothing is patched
+ * here any more. (#1411's note argued a HEADER "is right to disappear rather than show a key"; that
+ * is the half #1450 overturned: a page with no header says nothing about the label being owed.)
+ *
+ * The view ref is still the answer where there is NO label identity to resolve at all — no
+ * translation ref, no label target — because then there is no key to show.
+ * The loading window is a different case and is handled upstream, by `useLauncherResolutionContext`
+ * not resolving anything before its label bundles settle.
  */
 export declare function resolveNavigationViewTitle(params: {
     viewRef: string;

package/dist/esm/core/navigation/view-title-resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-title-resolution.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/view-title-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,yBAAyB,EAC1B,MAAM,qCAAqC,CAAC;AAU7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,MAAM,EAAE,yBAAyB,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAET;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAiBpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,yBAAyB,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,qBAAqB,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CAoDxC;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,qBAAqB,CAAC;IACnC,cAAc,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACjE,KAAK,EAAE,CACL,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,OAAO,KACT,MAAM,CAAC;CACb,GAAG,MAAM,CAmBT"}
+{"version":3,"file":"view-title-resolution.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/view-title-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,yBAAyB,EAC1B,MAAM,qCAAqC,CAAC;AAU7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,MAAM,EAAE,yBAAyB,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAET;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAiBpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,yBAAyB,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,qBAAqB,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CAoDxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,qBAAqB,CAAC;IACnC,cAAc,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACjE,KAAK,EAAE,CACL,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,OAAO,KACT,MAAM,CAAC;CACb,GAAG,MAAM,CAmBT"}

package/dist/esm/core/navigation/view-title-resolution.js

@@ -73,12 +73,30 @@ export function resolveNavigationViewLabelTarget(params) {
  * Composite views have a first-class translation identity and must resolve
  * through `composite_views.{translationRef}.title`. Other supported view
  * families resolve through `views.{family}.{translationRef}.title`.
+ *
+ * ## A missing title is never `''`
+ *
+ * Every caller NAMES something with the answer — a sidebar item, a command-menu entry, a dialog
+ * title, an inserted-view link — and `''` there is a control with no accessible name: still there,
+ * still focusable, and silent. axe reports it as a critical `button-name` (#1411), and a screen
+ * reader announces "button".
+ *
+ * `tCompositeView` / `tView` used to answer `''` for a missing title, so this function patched the
+ * gap with the view's own ref. Since #1450 the resolvers answer the KEY PATH themselves — one
+ * decision, in one place, for the header and the navigation control alike — so nothing is patched
+ * here any more. (#1411's note argued a HEADER "is right to disappear rather than show a key"; that
+ * is the half #1450 overturned: a page with no header says nothing about the label being owed.)
+ *
+ * The view ref is still the answer where there is NO label identity to resolve at all — no
+ * translation ref, no label target — because then there is no key to show.
+ * The loading window is a different case and is handled upstream, by `useLauncherResolutionContext`
+ * not resolving anything before its label bundles settle.
  */
 export function resolveNavigationViewTitle(params) {
     if (params.contentType === NavigationContentType.COMPOSITE_VIEW) {
         const translationRef = resolveCompositeViewTranslationRef(params.viewRef);
         if (!translationRef) {
-            return '';
+            return params.viewRef;
         }
         return params.tCompositeView(translationRef, 'title');
     }
@@ -87,7 +105,7 @@ export function resolveNavigationViewTitle(params) {
         contentType: params.contentType,
     });
     if (!viewTarget) {
-        return '';
+        return params.viewRef;
     }
     return params.tView(viewTarget.family, viewTarget.translationRef, 'title');
 }

package/dist/esm/core/navigation/view-title-resolution.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-title-resolution.js","sourceRoot":"","sources":["../../../../src/core/navigation/view-title-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  LabellingTypes,\n  NavigationViewLabelFamily,\n} from '@wildo-ai/presets-components-models';\nimport {\n  buildApplicationCompositeViewTranslationRef,\n  buildResourceCompositeViewTranslationRef,\n} from '~wildo-frontend-lib/core/config/composite-view.schemas';\nimport {\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  parseFrontendInsertedViewRef,\n} from '~wildo-frontend-lib/core/config/inserted-view.frontend.schemas';\nimport { NavigationContentType } from './navigation.schemas';\n\nexport function buildCompositeViewLabelKey(translationRef: string): string {\n  return `${LabellingTypes.COMPOSITE_VIEWS}.${translationRef}`;\n}\n\nexport function buildNavigationViewLabelKey(params: {\n  family: NavigationViewLabelFamily;\n  translationRef: string;\n}): string {\n  return `${LabellingTypes.VIEWS}.${params.family}.${params.translationRef}`;\n}\n\nexport function buildApplicationViewTranslationRef(viewRef: string): string {\n  return `app.${viewRef}`;\n}\n\nexport function buildResourceViewTranslationRef(\n  resourceType: string,\n  localRef: string,\n): string {\n  return `resources.${resourceType}.${localRef}`;\n}\n\nexport function resolveCompositeViewTranslationRef(\n  viewRef: string,\n): string | undefined {\n  const insertedView = parseFrontendInsertedViewRef(viewRef);\n  if (!insertedView) {\n    return buildApplicationCompositeViewTranslationRef(viewRef);\n  }\n  if (insertedView.viewKind !== FrontendInsertedViewKind.COMPOSITE_VIEW) {\n    return undefined;\n  }\n\n  if (insertedView.hostKind === FrontendInsertedViewHostKind.RESOURCE) {\n    return buildResourceCompositeViewTranslationRef(\n      insertedView.hostRef,\n      insertedView.localRef,\n    );\n  }\n\n  return buildApplicationCompositeViewTranslationRef(insertedView.localRef);\n}\n\nexport interface NavigationViewLabelTarget {\n  family: NavigationViewLabelFamily;\n  translationRef: string;\n}\n\nexport function resolveNavigationViewLabelTarget(params: {\n  viewRef: string;\n  contentType: NavigationContentType;\n}): NavigationViewLabelTarget | undefined {\n  const insertedView = parseFrontendInsertedViewRef(params.viewRef);\n\n  if (params.contentType === NavigationContentType.CHART_VIEW) {\n    if (insertedView?.viewKind === FrontendInsertedViewKind.CHART_VIEW) {\n      return {\n        family: NavigationViewLabelFamily.CHART,\n        translationRef: buildResourceViewTranslationRef(\n          insertedView.hostRef,\n          insertedView.localRef,\n        ),\n      };\n    }\n\n    return {\n      family: NavigationViewLabelFamily.CHART,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  if (params.contentType === NavigationContentType.EXECUTION_VIEW) {\n    if (insertedView?.viewKind === FrontendInsertedViewKind.EXECUTION_VIEW) {\n      return {\n        family: NavigationViewLabelFamily.EXECUTION,\n        translationRef: buildResourceViewTranslationRef(\n          insertedView.hostRef,\n          insertedView.localRef,\n        ),\n      };\n    }\n\n    return {\n      family: NavigationViewLabelFamily.EXECUTION,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  if (params.contentType === NavigationContentType.FULL_CUSTOM_VIEW) {\n    return {\n      family: NavigationViewLabelFamily.FULL_CUSTOM,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  if (params.contentType === NavigationContentType.FLOWS_ACTORS_VIEW) {\n    return {\n      family: NavigationViewLabelFamily.FLOWS_ACTORS,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve the display title for a navigable view surface.\n *\n * Composite views have a first-class translation identity and must resolve\n * through `composite_views.{translationRef}.title`. Other supported view\n * families resolve through `views.{family}.{translationRef}.title`.\n */\nexport function resolveNavigationViewTitle(params: {\n  viewRef: string;\n  contentType: NavigationContentType;\n  tCompositeView: (translationRef: string, key: 'title') => string;\n  tView: (\n    family: NavigationViewLabelFamily,\n    translationRef: string,\n    key: 'title',\n  ) => string;\n}): string {\n  if (params.contentType === NavigationContentType.COMPOSITE_VIEW) {\n    const translationRef = resolveCompositeViewTranslationRef(params.viewRef);\n    if (!translationRef) {\n      return '';\n    }\n\n    return params.tCompositeView(translationRef, 'title');\n  }\n\n  const viewTarget = resolveNavigationViewLabelTarget({\n    viewRef: params.viewRef,\n    contentType: params.contentType,\n  });\n  if (!viewTarget) {\n    return '';\n  }\n\n  return params.tView(viewTarget.family, viewTarget.translationRef, 'title');\n}\n"]}
+{"version":3,"file":"view-title-resolution.js","sourceRoot":"","sources":["../../../../../src/core/navigation/view-title-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  LabellingTypes,\n  NavigationViewLabelFamily,\n} from '@wildo-ai/presets-components-models';\nimport {\n  buildApplicationCompositeViewTranslationRef,\n  buildResourceCompositeViewTranslationRef,\n} from '~wildo-frontend-lib/core/config/composite-view.schemas';\nimport {\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  parseFrontendInsertedViewRef,\n} from '~wildo-frontend-lib/core/config/inserted-view.frontend.schemas';\nimport { NavigationContentType } from './navigation.schemas';\n\nexport function buildCompositeViewLabelKey(translationRef: string): string {\n  return `${LabellingTypes.COMPOSITE_VIEWS}.${translationRef}`;\n}\n\nexport function buildNavigationViewLabelKey(params: {\n  family: NavigationViewLabelFamily;\n  translationRef: string;\n}): string {\n  return `${LabellingTypes.VIEWS}.${params.family}.${params.translationRef}`;\n}\n\nexport function buildApplicationViewTranslationRef(viewRef: string): string {\n  return `app.${viewRef}`;\n}\n\nexport function buildResourceViewTranslationRef(\n  resourceType: string,\n  localRef: string,\n): string {\n  return `resources.${resourceType}.${localRef}`;\n}\n\nexport function resolveCompositeViewTranslationRef(\n  viewRef: string,\n): string | undefined {\n  const insertedView = parseFrontendInsertedViewRef(viewRef);\n  if (!insertedView) {\n    return buildApplicationCompositeViewTranslationRef(viewRef);\n  }\n  if (insertedView.viewKind !== FrontendInsertedViewKind.COMPOSITE_VIEW) {\n    return undefined;\n  }\n\n  if (insertedView.hostKind === FrontendInsertedViewHostKind.RESOURCE) {\n    return buildResourceCompositeViewTranslationRef(\n      insertedView.hostRef,\n      insertedView.localRef,\n    );\n  }\n\n  return buildApplicationCompositeViewTranslationRef(insertedView.localRef);\n}\n\nexport interface NavigationViewLabelTarget {\n  family: NavigationViewLabelFamily;\n  translationRef: string;\n}\n\nexport function resolveNavigationViewLabelTarget(params: {\n  viewRef: string;\n  contentType: NavigationContentType;\n}): NavigationViewLabelTarget | undefined {\n  const insertedView = parseFrontendInsertedViewRef(params.viewRef);\n\n  if (params.contentType === NavigationContentType.CHART_VIEW) {\n    if (insertedView?.viewKind === FrontendInsertedViewKind.CHART_VIEW) {\n      return {\n        family: NavigationViewLabelFamily.CHART,\n        translationRef: buildResourceViewTranslationRef(\n          insertedView.hostRef,\n          insertedView.localRef,\n        ),\n      };\n    }\n\n    return {\n      family: NavigationViewLabelFamily.CHART,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  if (params.contentType === NavigationContentType.EXECUTION_VIEW) {\n    if (insertedView?.viewKind === FrontendInsertedViewKind.EXECUTION_VIEW) {\n      return {\n        family: NavigationViewLabelFamily.EXECUTION,\n        translationRef: buildResourceViewTranslationRef(\n          insertedView.hostRef,\n          insertedView.localRef,\n        ),\n      };\n    }\n\n    return {\n      family: NavigationViewLabelFamily.EXECUTION,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  if (params.contentType === NavigationContentType.FULL_CUSTOM_VIEW) {\n    return {\n      family: NavigationViewLabelFamily.FULL_CUSTOM,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  if (params.contentType === NavigationContentType.FLOWS_ACTORS_VIEW) {\n    return {\n      family: NavigationViewLabelFamily.FLOWS_ACTORS,\n      translationRef: buildApplicationViewTranslationRef(params.viewRef),\n    };\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve the display title for a navigable view surface.\n *\n * Composite views have a first-class translation identity and must resolve\n * through `composite_views.{translationRef}.title`. Other supported view\n * families resolve through `views.{family}.{translationRef}.title`.\n *\n * ## A missing title is never `''`\n *\n * Every caller NAMES something with the answer — a sidebar item, a command-menu entry, a dialog\n * title, an inserted-view link — and `''` there is a control with no accessible name: still there,\n * still focusable, and silent. axe reports it as a critical `button-name` (#1411), and a screen\n * reader announces \"button\".\n *\n * `tCompositeView` / `tView` used to answer `''` for a missing title, so this function patched the\n * gap with the view's own ref. Since #1450 the resolvers answer the KEY PATH themselves — one\n * decision, in one place, for the header and the navigation control alike — so nothing is patched\n * here any more. (#1411's note argued a HEADER \"is right to disappear rather than show a key\"; that\n * is the half #1450 overturned: a page with no header says nothing about the label being owed.)\n *\n * The view ref is still the answer where there is NO label identity to resolve at all — no\n * translation ref, no label target — because then there is no key to show.\n * The loading window is a different case and is handled upstream, by `useLauncherResolutionContext`\n * not resolving anything before its label bundles settle.\n */\nexport function resolveNavigationViewTitle(params: {\n  viewRef: string;\n  contentType: NavigationContentType;\n  tCompositeView: (translationRef: string, key: 'title') => string;\n  tView: (\n    family: NavigationViewLabelFamily,\n    translationRef: string,\n    key: 'title',\n  ) => string;\n}): string {\n  if (params.contentType === NavigationContentType.COMPOSITE_VIEW) {\n    const translationRef = resolveCompositeViewTranslationRef(params.viewRef);\n    if (!translationRef) {\n      return params.viewRef;\n    }\n\n    return params.tCompositeView(translationRef, 'title');\n  }\n\n  const viewTarget = resolveNavigationViewLabelTarget({\n    viewRef: params.viewRef,\n    contentType: params.contentType,\n  });\n  if (!viewTarget) {\n    return params.viewRef;\n  }\n\n  return params.tView(viewTarget.family, viewTarget.translationRef, 'title');\n}\n"]}

package/dist/esm/core/navigation/zone-content-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zone-content-geometry.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/zone-content-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAGpF,OAAO,KAAK,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE/G,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,EAAE,mBAAiE,CAAC;AAE9G;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,mBAAmB,CAMtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,WAAW,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACnD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,mBAAmB,CAStB;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,wBAAwB,GAC7B,wBAAwB,CAI1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAExG"}
+{"version":3,"file":"zone-content-geometry.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/zone-content-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAGpF,OAAO,KAAK,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE/G,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,EAAE,mBAAiE,CAAC;AAE9G;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,mBAAmB,CAMtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,WAAW,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACnD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,mBAAmB,CAStB;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,wBAAwB,GAC7B,wBAAwB,CAI1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAExG"}

package/dist/esm/core/navigation/zone-content-geometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"zone-content-geometry.js","sourceRoot":"","sources":["../../../../src/core/navigation/zone-content-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EAAE,0CAA0C,EAAE,MAAM,8BAA8B,CAAC;AAW1F,iGAAiG;AACjG,MAAM,CAAC,MAAM,6BAA6B,GAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAE9G;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAGjD;IACC,MAAM,QAAQ,GAAG,0CAA0C,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,IAAI,6BAA6B,CAAC,QAAQ;QACjF,WAAW,EAAE,QAAQ,EAAE,sBAAsB,IAAI,6BAA6B,CAAC,WAAW;KAC3F,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kCAAkC,CAAC,MAGlD;IACC,MAAM,QAAQ,GAAG,0CAA0C,CAAC;QAC1D,cAAc,EAAE,MAAM,CAAC,WAAW;QAClC,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,IAAI,6BAA6B,CAAC,QAAQ;QACjF,WAAW,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CACjD,QAA6B,EAC7B,IAA8B;IAE9B,OAAO,QAAQ,CAAC,QAAQ,KAAK,6BAA6B,CAAC,QAAQ;QACjE,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sCAAsC,CAAC,QAA6B;IAClF,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC","sourcesContent":["/**\n * Zone content geometry (#176) — how much of a zone a destination's content occupies.\n *\n * ## Two axes, deliberately not one enum\n *\n * This replaced `ZoneContentFill`, a three-member enum — `NONE` / `WIDTH` / `BOTH` — that fused a\n * WIDTH decision and a HEIGHT decision into one value. Three points on a 2×2 grid: `NONE`→`WIDTH`\n * moved the width, `WIDTH`→`BOTH` moved the height, and the fourth cell (a capped width with a\n * definite height) was unrepresentable. Its width half also restated `ResponsiveMaxWidth`, the\n * vocabulary a Surface, a `DisplayLayout` and a `FormLayout` already use — so the same question had\n * two answers with different spellings depending on which level you asked.\n *\n * Splitting them costs one extra field and buys the missing cell, one vocabulary for width across\n * every level, and a height flag that reads as what it is. `design-philosophy.md` says not to merge\n * semantically distinct concepts for convenience; this is that rule applied to something that had\n * already shipped.\n *\n * ## What the boundary is for\n *\n * The boundary caps and centres a zone's content, and its defaults are RIGHT for almost everything a\n * zone hosts: a form, a list or a settings page stretched across a wide monitor is unreadable. What\n * did not exist before #176 was a way to say \"this one is a canvas\" — so the one surface that needed\n * it hand-rolled `h-[70vh]`, sizing against the WINDOW rather than its container and ignoring whatever\n * chrome sat above it.\n *\n * The defaults are preserved rather than inverted: every surface authored before this existed keeps\n * `'content'` and a natural height, and opting out is per-destination and explicit. The alternative\n * door — the application-wide `--content-max-width` variable — is the one that already existed and is\n * the reason the issue was filed: uncapping a graph that way uncaps every form in the application.\n */\n\nimport type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport type { DeepPartialSurfacePolicy } from '@wildo-ai/presets-components-models';\n\nimport { resolvePrimaryDestinationLayoutDeclaration } from './primary-destination-layout';\nimport type { PrimaryDestinationCompositeView, PrimaryDestinationContent } from './primary-destination-layout';\n\n/** The two independent answers a zone's content boundary needs. */\nexport interface ZoneContentGeometry {\n  /** The width cap, in the framework's shared vocabulary. `'content'` is the historical default. */\n  maxWidth: ResponsiveMaxWidth;\n  /** Whether the boundary becomes a definite-height flex column the content can fill. */\n  fillsHeight: boolean;\n}\n\n/** What a destination that declares nothing receives — and what every pre-#176 surface keeps. */\nexport const DEFAULT_ZONE_CONTENT_GEOMETRY: ZoneContentGeometry = { maxWidth: 'content', fillsHeight: false };\n\n/**\n * Read the geometry off whatever occupies PRIMARY, defaulting to {@link DEFAULT_ZONE_CONTENT_GEOMETRY}.\n *\n * Defaults HERE rather than at the declaration sites so there is one answer to \"what does a destination\n * that declares nothing get\", and it is the same answer for a composite view, a resource operation, a\n * content kind that cannot declare, and an empty primary stack.\n */\nexport function resolvePrimaryZoneContentGeometry(params: {\n  primaryContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): ZoneContentGeometry {\n  const declared = resolvePrimaryDestinationLayoutDeclaration(params);\n  return {\n    maxWidth: declared?.zoneContentMaxWidth ?? DEFAULT_ZONE_CONTENT_GEOMETRY.maxWidth,\n    fillsHeight: declared?.zoneContentFillsHeight ?? DEFAULT_ZONE_CONTENT_GEOMETRY.fillsHeight,\n  };\n}\n\n/**\n * The geometry for an ADJACENT zone's content.\n *\n * Adjacent zones had no content boundary at all before #176: a detail pane's width was decided by\n * whatever component happened to be rendered in it, so the workbench's artifact detail capped itself\n * and centred — an application solving, locally and invisibly, a question the engine had not answered.\n * The answer is the one primary already gets: cap at the page-content width and fill anything narrower.\n * A detail pane is usually narrower than that cap, so in practice the content fills the pane, which is\n * what \"full width, up to a maximum\" describes without the pane having to know its own size.\n *\n * `fillsHeight` is forced FALSE here, whatever the destination declared. Filling the height requires a\n * definite-height ancestor chain and an adjacent zone SCROLLS — it is the one place where a filling\n * child and a scrolling parent contradict each other. A canvas belongs in primary.\n */\nexport function resolveAdjacentZoneContentGeometry(params: {\n  zoneContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): ZoneContentGeometry {\n  const declared = resolvePrimaryDestinationLayoutDeclaration({\n    primaryContent: params.zoneContent,\n    compositeViews: params.compositeViews,\n  });\n  return {\n    maxWidth: declared?.zoneContentMaxWidth ?? DEFAULT_ZONE_CONTENT_GEOMETRY.maxWidth,\n    fillsHeight: false,\n  };\n}\n\n/**\n * The boundary's surface policy for a given geometry.\n *\n * The width rides the policy because that is the framework's declared channel for it — the same field\n * a Surface anywhere else sets, so the boundary announces its tier in the DOM like every other cap.\n */\nexport function zoneContentGeometryToPolicyOverride(\n  geometry: ZoneContentGeometry,\n  base: DeepPartialSurfacePolicy,\n): DeepPartialSurfacePolicy {\n  return geometry.maxWidth === DEFAULT_ZONE_CONTENT_GEOMETRY.maxWidth\n    ? base\n    : { ...base, geometry: { responsiveMaxWidth: geometry.maxWidth } };\n}\n\n/**\n * Extra classes the boundary element needs so filling content can actually fill.\n *\n * This is the half a surface policy cannot express. Filling the HEIGHT is not a property of the\n * boundary's own box — it is a property of the CHAIN: the boundary must become a definite-height flex\n * column so that the view's root, as its flex item, has something for `flex-1 min-h-0` to resolve\n * against. `h-full` alone is not enough (an auto-height parent gives a percentage height nothing to\n * measure), which is precisely why the previous state forced viewport fractions.\n *\n * `min-h-0` is what lets the column shrink rather than overflow its zone; without it a tall child\n * pushes the boundary past the content area and the zone's own scroll never engages.\n */\nexport function zoneContentGeometryToBoundaryClassName(geometry: ZoneContentGeometry): string | undefined {\n  return geometry.fillsHeight ? 'flex h-full min-h-0 flex-col' : undefined;\n}\n"]}
+{"version":3,"file":"zone-content-geometry.js","sourceRoot":"","sources":["../../../../../src/core/navigation/zone-content-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EAAE,0CAA0C,EAAE,MAAM,8BAA8B,CAAC;AAW1F,iGAAiG;AACjG,MAAM,CAAC,MAAM,6BAA6B,GAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAE9G;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAGjD;IACC,MAAM,QAAQ,GAAG,0CAA0C,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,IAAI,6BAA6B,CAAC,QAAQ;QACjF,WAAW,EAAE,QAAQ,EAAE,sBAAsB,IAAI,6BAA6B,CAAC,WAAW;KAC3F,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kCAAkC,CAAC,MAGlD;IACC,MAAM,QAAQ,GAAG,0CAA0C,CAAC;QAC1D,cAAc,EAAE,MAAM,CAAC,WAAW;QAClC,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,IAAI,6BAA6B,CAAC,QAAQ;QACjF,WAAW,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CACjD,QAA6B,EAC7B,IAA8B;IAE9B,OAAO,QAAQ,CAAC,QAAQ,KAAK,6BAA6B,CAAC,QAAQ;QACjE,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sCAAsC,CAAC,QAA6B;IAClF,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC","sourcesContent":["/**\n * Zone content geometry (#176) — how much of a zone a destination's content occupies.\n *\n * ## Two axes, deliberately not one enum\n *\n * This replaced `ZoneContentFill`, a three-member enum — `NONE` / `WIDTH` / `BOTH` — that fused a\n * WIDTH decision and a HEIGHT decision into one value. Three points on a 2×2 grid: `NONE`→`WIDTH`\n * moved the width, `WIDTH`→`BOTH` moved the height, and the fourth cell (a capped width with a\n * definite height) was unrepresentable. Its width half also restated `ResponsiveMaxWidth`, the\n * vocabulary a Surface, a `DisplayLayout` and a `FormLayout` already use — so the same question had\n * two answers with different spellings depending on which level you asked.\n *\n * Splitting them costs one extra field and buys the missing cell, one vocabulary for width across\n * every level, and a height flag that reads as what it is. `design-philosophy.md` says not to merge\n * semantically distinct concepts for convenience; this is that rule applied to something that had\n * already shipped.\n *\n * ## What the boundary is for\n *\n * The boundary caps and centres a zone's content, and its defaults are RIGHT for almost everything a\n * zone hosts: a form, a list or a settings page stretched across a wide monitor is unreadable. What\n * did not exist before #176 was a way to say \"this one is a canvas\" — so the one surface that needed\n * it hand-rolled `h-[70vh]`, sizing against the WINDOW rather than its container and ignoring whatever\n * chrome sat above it.\n *\n * The defaults are preserved rather than inverted: every surface authored before this existed keeps\n * `'content'` and a natural height, and opting out is per-destination and explicit. The alternative\n * door — the application-wide `--content-max-width` variable — is the one that already existed and is\n * the reason the issue was filed: uncapping a graph that way uncaps every form in the application.\n */\n\nimport type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport type { DeepPartialSurfacePolicy } from '@wildo-ai/presets-components-models';\n\nimport { resolvePrimaryDestinationLayoutDeclaration } from './primary-destination-layout';\nimport type { PrimaryDestinationCompositeView, PrimaryDestinationContent } from './primary-destination-layout';\n\n/** The two independent answers a zone's content boundary needs. */\nexport interface ZoneContentGeometry {\n  /** The width cap, in the framework's shared vocabulary. `'content'` is the historical default. */\n  maxWidth: ResponsiveMaxWidth;\n  /** Whether the boundary becomes a definite-height flex column the content can fill. */\n  fillsHeight: boolean;\n}\n\n/** What a destination that declares nothing receives — and what every pre-#176 surface keeps. */\nexport const DEFAULT_ZONE_CONTENT_GEOMETRY: ZoneContentGeometry = { maxWidth: 'content', fillsHeight: false };\n\n/**\n * Read the geometry off whatever occupies PRIMARY, defaulting to {@link DEFAULT_ZONE_CONTENT_GEOMETRY}.\n *\n * Defaults HERE rather than at the declaration sites so there is one answer to \"what does a destination\n * that declares nothing get\", and it is the same answer for a composite view, a resource operation, a\n * content kind that cannot declare, and an empty primary stack.\n */\nexport function resolvePrimaryZoneContentGeometry(params: {\n  primaryContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): ZoneContentGeometry {\n  const declared = resolvePrimaryDestinationLayoutDeclaration(params);\n  return {\n    maxWidth: declared?.zoneContentMaxWidth ?? DEFAULT_ZONE_CONTENT_GEOMETRY.maxWidth,\n    fillsHeight: declared?.zoneContentFillsHeight ?? DEFAULT_ZONE_CONTENT_GEOMETRY.fillsHeight,\n  };\n}\n\n/**\n * The geometry for an ADJACENT zone's content.\n *\n * Adjacent zones had no content boundary at all before #176: a detail pane's width was decided by\n * whatever component happened to be rendered in it, so the workbench's artifact detail capped itself\n * and centred — an application solving, locally and invisibly, a question the engine had not answered.\n * The answer is the one primary already gets: cap at the page-content width and fill anything narrower.\n * A detail pane is usually narrower than that cap, so in practice the content fills the pane, which is\n * what \"full width, up to a maximum\" describes without the pane having to know its own size.\n *\n * `fillsHeight` is forced FALSE here, whatever the destination declared. Filling the height requires a\n * definite-height ancestor chain and an adjacent zone SCROLLS — it is the one place where a filling\n * child and a scrolling parent contradict each other. A canvas belongs in primary.\n */\nexport function resolveAdjacentZoneContentGeometry(params: {\n  zoneContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): ZoneContentGeometry {\n  const declared = resolvePrimaryDestinationLayoutDeclaration({\n    primaryContent: params.zoneContent,\n    compositeViews: params.compositeViews,\n  });\n  return {\n    maxWidth: declared?.zoneContentMaxWidth ?? DEFAULT_ZONE_CONTENT_GEOMETRY.maxWidth,\n    fillsHeight: false,\n  };\n}\n\n/**\n * The boundary's surface policy for a given geometry.\n *\n * The width rides the policy because that is the framework's declared channel for it — the same field\n * a Surface anywhere else sets, so the boundary announces its tier in the DOM like every other cap.\n */\nexport function zoneContentGeometryToPolicyOverride(\n  geometry: ZoneContentGeometry,\n  base: DeepPartialSurfacePolicy,\n): DeepPartialSurfacePolicy {\n  return geometry.maxWidth === DEFAULT_ZONE_CONTENT_GEOMETRY.maxWidth\n    ? base\n    : { ...base, geometry: { responsiveMaxWidth: geometry.maxWidth } };\n}\n\n/**\n * Extra classes the boundary element needs so filling content can actually fill.\n *\n * This is the half a surface policy cannot express. Filling the HEIGHT is not a property of the\n * boundary's own box — it is a property of the CHAIN: the boundary must become a definite-height flex\n * column so that the view's root, as its flex item, has something for `flex-1 min-h-0` to resolve\n * against. `h-full` alone is not enough (an auto-height parent gives a percentage height nothing to\n * measure), which is precisely why the previous state forced viewport fractions.\n *\n * `min-h-0` is what lets the column shrink rather than overflow its zone; without it a tall child\n * pushes the boundary past the content area and the zone's own scroll never engages.\n */\nexport function zoneContentGeometryToBoundaryClassName(geometry: ZoneContentGeometry): string | undefined {\n  return geometry.fillsHeight ? 'flex h-full min-h-0 flex-col' : undefined;\n}\n"]}

package/dist/esm/core/navigation/zone-emphasis.d.ts

@@ -0,0 +1,42 @@
+import { NavigationZoneName } from '@wildo-ai/saas-models';
+/**
+ * The zone that actually takes the whole content area this render, given what the reader asked for
+ * and what the layout can currently show.
+ *
+ * Pure, so the rule is pinned without a provider stack. The reader's request
+ * (`NavigationContextType.emphasizedZone`) is a wish; this is the decision, and it yields the area
+ * back in every case where honouring the wish would hide the page:
+ *
+ * - on MOBILE there is one zone already, so emphasis means nothing;
+ * - a zone with NOTHING IN IT cannot be emphasized — an empty full-width pane over a hidden list is
+ *   the blank screen the request was never about;
+ * - PRIMARY is never emphasized: it has the whole area whenever nothing is beside it, and hiding the
+ *   adjacent zones to "emphasize" primary would be the same as closing them, which is a navigation
+ *   act with its own verbs.
+ *
+ * The request itself is left standing when it is not honoured. A reader who expanded a pane, lost it
+ * to a responsive collapse and got it back should find it expanded again; clearing the request on
+ * every non-honouring render would make emphasis flicker off under them.
+ */
+export declare function resolveEmphasizedZone(input: {
+    requested: NavigationZoneName | null;
+    isMobile: boolean;
+    secondaryShown: boolean;
+    companionShown: boolean;
+}): NavigationZoneName.SECONDARY | NavigationZoneName.COMPANION | null;
+/**
+ * Whether a keyboard Escape should restore the split.
+ *
+ * Escape is the universal "leave this mode" key and it is also what every text control, menu and
+ * dialog listens for. Emphasis yields to all of them: a key pressed inside an editable control is
+ * that control's, and a key pressed while an overlay is open belongs to the overlay (the overlay
+ * layer sits above the content areas and has its own dismissal). What is left — Escape on the page
+ * itself while a pane is emphasized — restores the split.
+ */
+export declare function escapeRestoresEmphasis(input: {
+    key: string;
+    emphasized: boolean;
+    overlayOpen: boolean;
+    target: EventTarget | null;
+}): boolean;
+//# sourceMappingURL=zone-emphasis.d.ts.map

package/dist/esm/core/navigation/zone-emphasis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-emphasis.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/zone-emphasis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,kBAAkB,CAAC,SAAS,GAAG,kBAAkB,CAAC,SAAS,GAAG,IAAI,CAKrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B,GAAG,OAAO,CAOV"}

package/dist/esm/core/navigation/zone-emphasis.js

@@ -0,0 +1,50 @@
+import { NavigationZoneName } from '@wildo-ai/saas-models';
+/**
+ * The zone that actually takes the whole content area this render, given what the reader asked for
+ * and what the layout can currently show.
+ *
+ * Pure, so the rule is pinned without a provider stack. The reader's request
+ * (`NavigationContextType.emphasizedZone`) is a wish; this is the decision, and it yields the area
+ * back in every case where honouring the wish would hide the page:
+ *
+ * - on MOBILE there is one zone already, so emphasis means nothing;
+ * - a zone with NOTHING IN IT cannot be emphasized — an empty full-width pane over a hidden list is
+ *   the blank screen the request was never about;
+ * - PRIMARY is never emphasized: it has the whole area whenever nothing is beside it, and hiding the
+ *   adjacent zones to "emphasize" primary would be the same as closing them, which is a navigation
+ *   act with its own verbs.
+ *
+ * The request itself is left standing when it is not honoured. A reader who expanded a pane, lost it
+ * to a responsive collapse and got it back should find it expanded again; clearing the request on
+ * every non-honouring render would make emphasis flicker off under them.
+ */
+export function resolveEmphasizedZone(input) {
+    if (input.requested === null || input.isMobile)
+        return null;
+    if (input.requested === NavigationZoneName.SECONDARY)
+        return input.secondaryShown ? NavigationZoneName.SECONDARY : null;
+    if (input.requested === NavigationZoneName.COMPANION)
+        return input.companionShown ? NavigationZoneName.COMPANION : null;
+    return null;
+}
+/**
+ * Whether a keyboard Escape should restore the split.
+ *
+ * Escape is the universal "leave this mode" key and it is also what every text control, menu and
+ * dialog listens for. Emphasis yields to all of them: a key pressed inside an editable control is
+ * that control's, and a key pressed while an overlay is open belongs to the overlay (the overlay
+ * layer sits above the content areas and has its own dismissal). What is left — Escape on the page
+ * itself while a pane is emphasized — restores the split.
+ */
+export function escapeRestoresEmphasis(input) {
+    if (input.key !== 'Escape' || !input.emphasized || input.overlayOpen)
+        return false;
+    const element = input.target instanceof HTMLElement ? input.target : null;
+    if (element === null)
+        return true;
+    if (element.isContentEditable)
+        return false;
+    const tag = element.tagName;
+    return tag !== 'INPUT' && tag !== 'TEXTAREA' && tag !== 'SELECT';
+}
+//# sourceMappingURL=zone-emphasis.js.map

package/dist/esm/core/navigation/zone-emphasis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-emphasis.js","sourceRoot":"","sources":["../../../../../src/core/navigation/zone-emphasis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAKrC;IACC,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,KAAK,CAAC,SAAS,KAAK,kBAAkB,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACxH,IAAI,KAAK,CAAC,SAAS,KAAK,kBAAkB,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACxH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAKtC;IACC,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IACnF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,OAAO,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAC5B,OAAO,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ,CAAC;AACnE,CAAC","sourcesContent":["import { NavigationZoneName } from '@wildo-ai/saas-models';\n\n/**\n * The zone that actually takes the whole content area this render, given what the reader asked for\n * and what the layout can currently show.\n *\n * Pure, so the rule is pinned without a provider stack. The reader's request\n * (`NavigationContextType.emphasizedZone`) is a wish; this is the decision, and it yields the area\n * back in every case where honouring the wish would hide the page:\n *\n * - on MOBILE there is one zone already, so emphasis means nothing;\n * - a zone with NOTHING IN IT cannot be emphasized — an empty full-width pane over a hidden list is\n *   the blank screen the request was never about;\n * - PRIMARY is never emphasized: it has the whole area whenever nothing is beside it, and hiding the\n *   adjacent zones to \"emphasize\" primary would be the same as closing them, which is a navigation\n *   act with its own verbs.\n *\n * The request itself is left standing when it is not honoured. A reader who expanded a pane, lost it\n * to a responsive collapse and got it back should find it expanded again; clearing the request on\n * every non-honouring render would make emphasis flicker off under them.\n */\nexport function resolveEmphasizedZone(input: {\n  requested: NavigationZoneName | null;\n  isMobile: boolean;\n  secondaryShown: boolean;\n  companionShown: boolean;\n}): NavigationZoneName.SECONDARY | NavigationZoneName.COMPANION | null {\n  if (input.requested === null || input.isMobile) return null;\n  if (input.requested === NavigationZoneName.SECONDARY) return input.secondaryShown ? NavigationZoneName.SECONDARY : null;\n  if (input.requested === NavigationZoneName.COMPANION) return input.companionShown ? NavigationZoneName.COMPANION : null;\n  return null;\n}\n\n/**\n * Whether a keyboard Escape should restore the split.\n *\n * Escape is the universal \"leave this mode\" key and it is also what every text control, menu and\n * dialog listens for. Emphasis yields to all of them: a key pressed inside an editable control is\n * that control's, and a key pressed while an overlay is open belongs to the overlay (the overlay\n * layer sits above the content areas and has its own dismissal). What is left — Escape on the page\n * itself while a pane is emphasized — restores the split.\n */\nexport function escapeRestoresEmphasis(input: {\n  key: string;\n  emphasized: boolean;\n  overlayOpen: boolean;\n  target: EventTarget | null;\n}): boolean {\n  if (input.key !== 'Escape' || !input.emphasized || input.overlayOpen) return false;\n  const element = input.target instanceof HTMLElement ? input.target : null;\n  if (element === null) return true;\n  if (element.isContentEditable) return false;\n  const tag = element.tagName;\n  return tag !== 'INPUT' && tag !== 'TEXTAREA' && tag !== 'SELECT';\n}\n"]}

package/dist/esm/core/navigation/zone-empty-behavior.d.ts

@@ -61,6 +61,28 @@ export declare function resolveZoneEmptyBehavior({ zone, zones, destinationOverr
  * visibility expression is how one of them ends up reading the field and the other not.
  */
 export declare function zoneOccupiesSpaceWhenEmpty(behavior: ZoneEmptyBehavior): boolean;
+/**
+ * May this zone be DISMISSED — is a close control worth offering on it?
+ *
+ * Two conditions, and both are about whether the gesture would DO anything:
+ *
+ * - **It holds something.** Closing an empty pane is a no-op by definition.
+ * - **Closing gives the width back**, i.e. the resolved behavior is not `EMPTY_STATE`. A zone that
+ *   stays on screen when empty has declared that it stays; "closing" it would swap a record for a
+ *   placeholder and return no room, so the control would appear to do nothing. That is a worse
+ *   affordance than no control at all.
+ *
+ * Kept beside {@link zoneOccupiesSpaceWhenEmpty} — it is that predicate's inverse plus the content
+ * test — so the two cannot drift: the control can never appear on a pane that would stay put, nor be
+ * withheld from one that would go.
+ *
+ * Deliberately NOT conditioned on emphasis: closing an emphasized pane is the fastest way back to
+ * the list beneath it, and hiding the control there strands the reader on the expand toggle.
+ */
+export declare function zoneIsDismissable(params: {
+    hasContent: boolean;
+    behavior: ZoneEmptyBehavior;
+}): boolean;
 /**
  * Read `adjacentZoneOnEmpty` off whatever occupies PRIMARY.
  *

package/dist/esm/core/navigation/zone-empty-behavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zone-empty-behavior.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/zone-empty-behavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE/G;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,mGAAmG;IACnG,IAAI,EAAE,kBAAkB,CAAC;IACzB,4FAA4F;IAC5F,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C;;;OAGG;IACH,mBAAmB,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,IAAI,EACJ,KAAK,EACL,mBAAmB,GACpB,EAAE,uBAAuB,GAAG,iBAAiB,CAO7C;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAAC,MAAM,EAAE;IACnE,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,iBAAiB,GAAG,SAAS,CAEhC"}
+{"version":3,"file":"zone-empty-behavior.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/zone-empty-behavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE/G;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,mGAAmG;IACnG,IAAI,EAAE,kBAAkB,CAAC;IACzB,4FAA4F;IAC5F,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C;;;OAGG;IACH,mBAAmB,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,IAAI,EACJ,KAAK,EACL,mBAAmB,GACpB,EAAE,uBAAuB,GAAG,iBAAiB,CAO7C;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAE/E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,GAAG,OAAO,CAEvG;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAAC,MAAM,EAAE;IACnE,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,iBAAiB,GAAG,SAAS,CAEhC"}

package/dist/esm/core/navigation/zone-empty-behavior.js

@@ -50,6 +50,27 @@ export function resolveZoneEmptyBehavior({ zone, zones, destinationOverride, })
 export function zoneOccupiesSpaceWhenEmpty(behavior) {
     return behavior === ZoneEmptyBehavior.EMPTY_STATE;
 }
+/**
+ * May this zone be DISMISSED — is a close control worth offering on it?
+ *
+ * Two conditions, and both are about whether the gesture would DO anything:
+ *
+ * - **It holds something.** Closing an empty pane is a no-op by definition.
+ * - **Closing gives the width back**, i.e. the resolved behavior is not `EMPTY_STATE`. A zone that
+ *   stays on screen when empty has declared that it stays; "closing" it would swap a record for a
+ *   placeholder and return no room, so the control would appear to do nothing. That is a worse
+ *   affordance than no control at all.
+ *
+ * Kept beside {@link zoneOccupiesSpaceWhenEmpty} — it is that predicate's inverse plus the content
+ * test — so the two cannot drift: the control can never appear on a pane that would stay put, nor be
+ * withheld from one that would go.
+ *
+ * Deliberately NOT conditioned on emphasis: closing an emphasized pane is the fastest way back to
+ * the list beneath it, and hiding the control there strands the reader on the expand toggle.
+ */
+export function zoneIsDismissable(params) {
+    return params.hasContent && !zoneOccupiesSpaceWhenEmpty(params.behavior);
+}
 /**
  * Read `adjacentZoneOnEmpty` off whatever occupies PRIMARY.
  *