@wildo-ai/saas-frontend-lib 1.1.10 → 1.1.11

package/dist/esm/components/navigation/app-level/useNavigationBehaviors.d.ts

@@ -1,7 +1,6 @@
 import type { NavigationBehaviors } from '../../../core/app-shell/app-shell.schemas';
 /**
- * Standalone navigation behavior hook — provides active-state checking,
- * display policy evaluation, click dispatch, and home navigation.
+ * Standalone navigation behavior hook — provides active-state checking, click dispatch, and home navigation.
  *
  * This hook is completely independent of item fetching. It does not call
  * any scan-based item discovery. Consumers provide their own items from

package/dist/esm/components/navigation/app-level/useNavigationBehaviors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationBehaviors.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useNavigationBehaviors.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAEhG;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAuD5D"}
+{"version":3,"file":"useNavigationBehaviors.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useNavigationBehaviors.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAEhG;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAuC5D"}

package/dist/esm/components/navigation/app-level/useNavigationBehaviors.js

@@ -1,6 +1,5 @@
 import { useCallback, useMemo } from 'react';
 import { useLocation, useNavigate } from 'react-router-dom';
-import { SidebarItemDisplayPolicy, } from '../../../core/config/app-level-components.frontend.schemas.js';
 import { useEventBus } from '../../../core/events/useEventBus.js';
 import { EnginePageRef, ENGINE_PAGE_METADATA, } from '../../../core/config/launcher-items.frontend.schemas.js';
 import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
@@ -8,8 +7,7 @@ import { navigateHomeWithFreshStart } from '../../../core/navigation/navigation-
 import { useNavigationController } from '../../../core/navigation/useNavigationController.js';
 import { useNavigationState } from '../../../core/navigation/useNavigationState.js';
 /**
- * Standalone navigation behavior hook — provides active-state checking,
- * display policy evaluation, click dispatch, and home navigation.
+ * Standalone navigation behavior hook — provides active-state checking, click dispatch, and home navigation.
  *
  * This hook is completely independent of item fetching. It does not call
  * any scan-based item discovery. Consumers provide their own items from
@@ -25,17 +23,6 @@ export function useNavigationBehaviors() {
     const { navigate } = useNavigationController();
     const { isNavigationItemActive } = useNavigationState();
     const { emit } = useEventBus();
-    const shouldShowItem = useCallback((item) => {
-        const policy = item.displayPolicy ?? SidebarItemDisplayPolicy.ALWAYS;
-        switch (policy) {
-            case SidebarItemDisplayPolicy.ALWAYS:
-                return 'visible';
-            case SidebarItemDisplayPolicy.SECTION_MORE_MENU:
-                return 'more_menu';
-            default:
-                return 'visible';
-        }
-    }, []);
     const handleNavigationClick = useCallback((item, launcher) => {
         NavigationUtils.dispatchNavigationForItem(navigate, item, launcher);
     }, [navigate]);
@@ -57,7 +44,6 @@ export function useNavigationBehaviors() {
     }, [location.pathname, homePath]);
     return {
         isNavigationItemActive,
-        shouldShowItem,
         handleNavigationClick,
         handleHomeClick,
         isHomeActive,

package/dist/esm/components/navigation/app-level/useNavigationBehaviors.js.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationBehaviors.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useNavigationBehaviors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAEL,wBAAwB,GACzB,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EACL,aAAa,EACb,oBAAoB,GACrB,MAAM,iEAAiE,CAAC;AAKzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2EAA2E,CAAC;AACvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAI5F;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,cAAc,GAAG,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAC/C,MAAM,EAAE,sBAAsB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACxD,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAE/B,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,IAAuB,EAAsC,EAAE;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,wBAAwB,CAAC,MAAM,CAAC;QACrE,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,wBAAwB,CAAC,MAAM;gBAClC,OAAO,SAAS,CAAC;YACnB,KAAK,wBAAwB,CAAC,iBAAiB;gBAC7C,OAAO,WAAW,CAAC;YACrB;gBACE,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,IAAuB,EAAE,QAAuC,EAAE,EAAE;QACnE,eAAe,CAAC,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF;;;;OAIG;IACH,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,0BAA0B,CAAC;YACzB,IAAI;YACJ,cAAc;YACd,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC5B,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElC,OAAO;QACL,sBAAsB;QACtB,cAAc;QACd,qBAAqB;QACrB,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router-dom';\n\nimport {\n  type ApplicationLevelComponentType,\n  SidebarItemDisplayPolicy,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport {\n  EnginePageRef,\n  ENGINE_PAGE_METADATA,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport {\n  NavigationZone,\n  type AnyNavigationItem,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { useNavigationState } from '~wildo-frontend-lib/core/navigation/useNavigationState';\n\nimport type { NavigationBehaviors } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/**\n * Standalone navigation behavior hook — provides active-state checking,\n * display policy evaluation, click dispatch, and home navigation.\n *\n * This hook is completely independent of item fetching. It does not call\n * any scan-based item discovery. Consumers provide their own items from\n * per-launcher resolution (declared `contentSections`, `commands`, `tools`, etc.).\n *\n * `handleNavigationClick` requires `launcher` as a second parameter since\n * this hook is not scoped to a single launcher.\n */\nexport function useNavigationBehaviors(): NavigationBehaviors {\n  const routerNavigate = useNavigate();\n  const location = useLocation();\n  const homePath = ENGINE_PAGE_METADATA[EnginePageRef.HOME].route;\n  const { navigate } = useNavigationController();\n  const { isNavigationItemActive } = useNavigationState();\n  const { emit } = useEventBus();\n\n  const shouldShowItem = useCallback(\n    (item: AnyNavigationItem): 'visible' | 'more_menu' | 'hidden' => {\n      const policy = item.displayPolicy ?? SidebarItemDisplayPolicy.ALWAYS;\n      switch (policy) {\n        case SidebarItemDisplayPolicy.ALWAYS:\n          return 'visible';\n        case SidebarItemDisplayPolicy.SECTION_MORE_MENU:\n          return 'more_menu';\n        default:\n          return 'visible';\n      }\n    },\n    [],\n  );\n\n  const handleNavigationClick = useCallback(\n    (item: AnyNavigationItem, launcher: ApplicationLevelComponentType) => {\n      NavigationUtils.dispatchNavigationForItem(navigate, item, launcher);\n    },\n    [navigate],\n  );\n\n  /**\n   * Home navigation — clears all panes and navigates to the engine home route\n   * (`ENGINE_PAGE_ROUTES[EnginePageRef.HOME]`). Wrapped in a NavigationTransaction\n   * to prevent useRouterSync from re-populating stale content during the transition.\n   */\n  const handleHomeClick = useCallback(() => {\n    navigateHomeWithFreshStart({\n      emit,\n      routerNavigate,\n      homePath,\n    });\n  }, [emit, routerNavigate, homePath]);\n\n  const isHomeActive = useMemo(() => {\n    const p = location.pathname;\n    return p === homePath || (homePath === '/' && p === '');\n  }, [location.pathname, homePath]);\n\n  return {\n    isNavigationItemActive,\n    shouldShowItem,\n    handleNavigationClick,\n    handleHomeClick,\n    isHomeActive,\n  };\n}\n"]}
+{"version":3,"file":"useNavigationBehaviors.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useNavigationBehaviors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EACL,aAAa,EACb,oBAAoB,GACrB,MAAM,iEAAiE,CAAC;AAKzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2EAA2E,CAAC;AACvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAI5F;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,cAAc,GAAG,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAC/C,MAAM,EAAE,sBAAsB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACxD,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAE/B,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,IAAuB,EAAE,QAAuC,EAAE,EAAE;QACnE,eAAe,CAAC,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF;;;;OAIG;IACH,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,0BAA0B,CAAC;YACzB,IAAI;YACJ,cAAc;YACd,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC5B,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElC,OAAO;QACL,sBAAsB;QACtB,qBAAqB;QACrB,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router-dom';\n\nimport type { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport {\n  EnginePageRef,\n  ENGINE_PAGE_METADATA,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport {\n  NavigationZone,\n  type AnyNavigationItem,\n} from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { useNavigationState } from '~wildo-frontend-lib/core/navigation/useNavigationState';\n\nimport type { NavigationBehaviors } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/**\n * Standalone navigation behavior hook — provides active-state checking, click dispatch, and home navigation.\n *\n * This hook is completely independent of item fetching. It does not call\n * any scan-based item discovery. Consumers provide their own items from\n * per-launcher resolution (declared `contentSections`, `commands`, `tools`, etc.).\n *\n * `handleNavigationClick` requires `launcher` as a second parameter since\n * this hook is not scoped to a single launcher.\n */\nexport function useNavigationBehaviors(): NavigationBehaviors {\n  const routerNavigate = useNavigate();\n  const location = useLocation();\n  const homePath = ENGINE_PAGE_METADATA[EnginePageRef.HOME].route;\n  const { navigate } = useNavigationController();\n  const { isNavigationItemActive } = useNavigationState();\n  const { emit } = useEventBus();\n\n  const handleNavigationClick = useCallback(\n    (item: AnyNavigationItem, launcher: ApplicationLevelComponentType) => {\n      NavigationUtils.dispatchNavigationForItem(navigate, item, launcher);\n    },\n    [navigate],\n  );\n\n  /**\n   * Home navigation — clears all panes and navigates to the engine home route\n   * (`ENGINE_PAGE_ROUTES[EnginePageRef.HOME]`). Wrapped in a NavigationTransaction\n   * to prevent useRouterSync from re-populating stale content during the transition.\n   */\n  const handleHomeClick = useCallback(() => {\n    navigateHomeWithFreshStart({\n      emit,\n      routerNavigate,\n      homePath,\n    });\n  }, [emit, routerNavigate, homePath]);\n\n  const isHomeActive = useMemo(() => {\n    const p = location.pathname;\n    return p === homePath || (homePath === '/' && p === '');\n  }, [location.pathname, homePath]);\n\n  return {\n    isNavigationItemActive,\n    handleNavigationClick,\n    handleHomeClick,\n    isHomeActive,\n  };\n}\n"]}

package/dist/esm/components/navigation/app-level/useNotificationCenterBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNotificationCenterBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useNotificationCenterBehavior.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAqEvG;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,CAAC,EAAE,OAAO,EACxB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EACtC,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,0BAA0B,CA6H5B"}
+{"version":3,"file":"useNotificationCenterBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useNotificationCenterBehavior.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAqEvG;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,CAAC,EAAE,OAAO,EACxB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EACtC,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,0BAA0B,CA6H5B"}

package/dist/esm/components/navigation/app-level/useOwnOrganizationSearch.d.ts

@@ -0,0 +1,32 @@
+/** Characters typed before the switcher searches — the reference picker's threshold (`useResourceSearch`). */
+export declare const ORGANIZATION_SEARCH_MIN_CHARS = 2;
+/** Pause after the last keystroke before searching — the reference picker's debounce. */
+export declare const ORGANIZATION_SEARCH_DEBOUNCE_MS = 300;
+/** Organizations a search returns at most. A person refines the query rather than scrolling a long answer. */
+export declare const ORGANIZATION_SEARCH_PAGE_LIMIT = 20;
+export interface OwnOrganizationSearch {
+    query: string;
+    setQuery: (query: string) => void;
+    /** `null` while no search applies (query below the threshold, or the first answer not in yet). */
+    results: {
+        _id: string;
+        name: string;
+    }[] | null;
+    isSearching: boolean;
+    failed: boolean;
+}
+/**
+ * The organization switcher's search over the person's OWN organizations (#2452).
+ *
+ * The user context carries only the newest 20 memberships, so a person in more cannot be offered every organization at
+ * session restore: each costs an organization read and a preferences read. This finds the rest the way GitHub's,
+ * Slack's and Linear's switchers do — a bounded first page, then search — through `GET /organizations/search/mine`,
+ * which the backend confines to the organizations the caller holds an organization-wide role in.
+ *
+ * Paced like the engine's reference picker (`useResourceSearch`): nothing below {@link ORGANIZATION_SEARCH_MIN_CHARS},
+ * a {@link ORGANIZATION_SEARCH_DEBOUNCE_MS} debounce, and only the latest query's answer is kept, so a slow early answer
+ * never overwrites a later one. Searching is off (`enabled: false`) when the switcher has nothing unlisted to find, and
+ * the query is cleared whenever it turns off, so a reopened switcher starts from its list.
+ */
+export declare function useOwnOrganizationSearch(enabled: boolean): OwnOrganizationSearch;
+//# sourceMappingURL=useOwnOrganizationSearch.d.ts.map

package/dist/esm/components/navigation/app-level/useOwnOrganizationSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOwnOrganizationSearch.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useOwnOrganizationSearch.ts"],"names":[],"mappings":"AAcA,8GAA8G;AAC9G,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,yFAAyF;AACzF,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,8GAA8G;AAC9G,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,kGAAkG;IAClG,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;IAChD,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAkEhF"}

package/dist/esm/components/navigation/app-level/useOwnOrganizationSearch.js

@@ -0,0 +1,91 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { CoreResourceOperation, CoreResourceType, OrganizationsSearchVariantKey, ResourceOperationVariantType, ResourcesConfig_OperationPathUtils, } from '@wildo-ai/saas-models';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
+/** Characters typed before the switcher searches — the reference picker's threshold (`useResourceSearch`). */
+export const ORGANIZATION_SEARCH_MIN_CHARS = 2;
+/** Pause after the last keystroke before searching — the reference picker's debounce. */
+export const ORGANIZATION_SEARCH_DEBOUNCE_MS = 300;
+/** Organizations a search returns at most. A person refines the query rather than scrolling a long answer. */
+export const ORGANIZATION_SEARCH_PAGE_LIMIT = 20;
+/**
+ * The organization switcher's search over the person's OWN organizations (#2452).
+ *
+ * The user context carries only the newest 20 memberships, so a person in more cannot be offered every organization at
+ * session restore: each costs an organization read and a preferences read. This finds the rest the way GitHub's,
+ * Slack's and Linear's switchers do — a bounded first page, then search — through `GET /organizations/search/mine`,
+ * which the backend confines to the organizations the caller holds an organization-wide role in.
+ *
+ * Paced like the engine's reference picker (`useResourceSearch`): nothing below {@link ORGANIZATION_SEARCH_MIN_CHARS},
+ * a {@link ORGANIZATION_SEARCH_DEBOUNCE_MS} debounce, and only the latest query's answer is kept, so a slow early answer
+ * never overwrites a later one. Searching is off (`enabled: false`) when the switcher has nothing unlisted to find, and
+ * the query is cleared whenever it turns off, so a reopened switcher starts from its list.
+ */
+export function useOwnOrganizationSearch(enabled) {
+    const { registry, doOperation } = useResourceRegistry();
+    const doOperationRef = useRef(doOperation);
+    doOperationRef.current = doOperation;
+    const [query, setQuery] = useState('');
+    const [results, setResults] = useState(null);
+    const [isSearching, setIsSearching] = useState(false);
+    const [failed, setFailed] = useState(false);
+    const latestRequestRef = useRef(0);
+    const operationPath = useMemo(() => {
+        const operation = registry?.resourceConfigurations?.[CoreResourceType.ORGANIZATIONS]?.operations.find((candidate) => candidate.operationIdentifier === CoreResourceOperation.SEARCH
+            && candidate.variantType === ResourceOperationVariantType.API_CALL
+            && candidate.variantKey === OrganizationsSearchVariantKey.MINE);
+        return operation ? ResourcesConfig_OperationPathUtils.buildOperationPathKeyFromOperation(operation) : null;
+    }, [registry]);
+    const trimmed = query.trim();
+    const active = enabled && operationPath !== null && trimmed.length >= ORGANIZATION_SEARCH_MIN_CHARS;
+    useEffect(() => {
+        if (!enabled)
+            setQuery('');
+    }, [enabled]);
+    useEffect(() => {
+        if (!active || !operationPath) {
+            latestRequestRef.current += 1;
+            setResults(null);
+            setIsSearching(false);
+            setFailed(false);
+            return;
+        }
+        const requestNumber = ++latestRequestRef.current;
+        setIsSearching(true);
+        const timer = setTimeout(() => {
+            void (async () => {
+                try {
+                    const answer = await doOperationRef.current(operationPath, {
+                        contextualParameters: {},
+                        queryParameters: FrontendResourceUtils.buildForeignKeySearchParams(trimmed, ORGANIZATION_SEARCH_PAGE_LIMIT).queryParameters,
+                    });
+                    if (latestRequestRef.current !== requestNumber)
+                        return;
+                    const rows = Array.isArray(answer)
+                        ? answer
+                        : (answer?.data ?? answer?.items ?? []);
+                    // `name` is required on an organization; a row without one is not offered rather than shown under its id.
+                    setResults(rows
+                        .filter((row) => !!row && row._id !== undefined && row._id !== null && typeof row.name === 'string')
+                        .map((row) => ({ _id: String(row._id), name: row.name })));
+                    setFailed(false);
+                }
+                catch (error) {
+                    if (latestRequestRef.current !== requestNumber)
+                        return;
+                    LoggerFrontendService.getLogger().warn('[OrganizationSwitcher] Searching the person\'s own organizations failed', { error });
+                    setResults([]);
+                    setFailed(true);
+                }
+                finally {
+                    if (latestRequestRef.current === requestNumber)
+                        setIsSearching(false);
+                }
+            })();
+        }, ORGANIZATION_SEARCH_DEBOUNCE_MS);
+        return () => clearTimeout(timer);
+    }, [active, operationPath, trimmed]);
+    return { query, setQuery, results, isSearching, failed };
+}
+//# sourceMappingURL=useOwnOrganizationSearch.js.map

package/dist/esm/components/navigation/app-level/useOwnOrganizationSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOwnOrganizationSearch.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useOwnOrganizationSearch.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useRef, useState } from 'react';\n\nimport {\n  CoreResourceOperation,\n  CoreResourceType,\n  OrganizationsSearchVariantKey,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\n\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/** Characters typed before the switcher searches — the reference picker's threshold (`useResourceSearch`). */\nexport const ORGANIZATION_SEARCH_MIN_CHARS = 2;\n/** Pause after the last keystroke before searching — the reference picker's debounce. */\nexport const ORGANIZATION_SEARCH_DEBOUNCE_MS = 300;\n/** Organizations a search returns at most. A person refines the query rather than scrolling a long answer. */\nexport const ORGANIZATION_SEARCH_PAGE_LIMIT = 20;\n\nexport interface OwnOrganizationSearch {\n  query: string;\n  setQuery: (query: string) => void;\n  /** `null` while no search applies (query below the threshold, or the first answer not in yet). */\n  results: { _id: string; name: string }[] | null;\n  isSearching: boolean;\n  failed: boolean;\n}\n\n/**\n * The organization switcher's search over the person's OWN organizations (#2452).\n *\n * The user context carries only the newest 20 memberships, so a person in more cannot be offered every organization at\n * session restore: each costs an organization read and a preferences read. This finds the rest the way GitHub's,\n * Slack's and Linear's switchers do — a bounded first page, then search — through `GET /organizations/search/mine`,\n * which the backend confines to the organizations the caller holds an organization-wide role in.\n *\n * Paced like the engine's reference picker (`useResourceSearch`): nothing below {@link ORGANIZATION_SEARCH_MIN_CHARS},\n * a {@link ORGANIZATION_SEARCH_DEBOUNCE_MS} debounce, and only the latest query's answer is kept, so a slow early answer\n * never overwrites a later one. Searching is off (`enabled: false`) when the switcher has nothing unlisted to find, and\n * the query is cleared whenever it turns off, so a reopened switcher starts from its list.\n */\nexport function useOwnOrganizationSearch(enabled: boolean): OwnOrganizationSearch {\n  const { registry, doOperation } = useResourceRegistry();\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n\n  const [query, setQuery] = useState('');\n  const [results, setResults] = useState<{ _id: string; name: string }[] | null>(null);\n  const [isSearching, setIsSearching] = useState(false);\n  const [failed, setFailed] = useState(false);\n  const latestRequestRef = useRef(0);\n\n  const operationPath = useMemo(() => {\n    const operation = registry?.resourceConfigurations?.[CoreResourceType.ORGANIZATIONS]?.operations.find((candidate: any) =>\n      candidate.operationIdentifier === CoreResourceOperation.SEARCH\n      && candidate.variantType === ResourceOperationVariantType.API_CALL\n      && candidate.variantKey === OrganizationsSearchVariantKey.MINE);\n    return operation ? ResourcesConfig_OperationPathUtils.buildOperationPathKeyFromOperation(operation) : null;\n  }, [registry]);\n\n  const trimmed = query.trim();\n  const active = enabled && operationPath !== null && trimmed.length >= ORGANIZATION_SEARCH_MIN_CHARS;\n\n  useEffect(() => {\n    if (!enabled) setQuery('');\n  }, [enabled]);\n\n  useEffect(() => {\n    if (!active || !operationPath) {\n      latestRequestRef.current += 1;\n      setResults(null);\n      setIsSearching(false);\n      setFailed(false);\n      return;\n    }\n    const requestNumber = ++latestRequestRef.current;\n    setIsSearching(true);\n    const timer = setTimeout(() => {\n      void (async () => {\n        try {\n          const answer = await doOperationRef.current<unknown>(operationPath, {\n            contextualParameters: {},\n            queryParameters: FrontendResourceUtils.buildForeignKeySearchParams(trimmed, ORGANIZATION_SEARCH_PAGE_LIMIT).queryParameters,\n          });\n          if (latestRequestRef.current !== requestNumber) return;\n          const rows = Array.isArray(answer)\n            ? answer\n            : ((answer as { data?: unknown[]; items?: unknown[] } | null)?.data ?? (answer as { items?: unknown[] } | null)?.items ?? []);\n          // `name` is required on an organization; a row without one is not offered rather than shown under its id.\n          setResults((rows as { _id?: unknown; name?: unknown }[])\n            .filter((row): row is { _id: unknown; name: string } => !!row && row._id !== undefined && row._id !== null && typeof row.name === 'string')\n            .map((row) => ({ _id: String(row._id), name: row.name })));\n          setFailed(false);\n        } catch (error) {\n          if (latestRequestRef.current !== requestNumber) return;\n          LoggerFrontendService.getLogger().warn('[OrganizationSwitcher] Searching the person\\'s own organizations failed', { error });\n          setResults([]);\n          setFailed(true);\n        } finally {\n          if (latestRequestRef.current === requestNumber) setIsSearching(false);\n        }\n      })();\n    }, ORGANIZATION_SEARCH_DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n  }, [active, operationPath, trimmed]);\n\n  return { query, setQuery, results, isSearching, failed };\n}\n"]}

package/dist/esm/components/navigation/app-level/useQuickActionButtonBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useQuickActionButtonBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useQuickActionButtonBehavior.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,yBAAyB,EAAgC,MAAM,sDAAsD,CAAC;AAQpI;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,CAqDxE"}
+{"version":3,"file":"useQuickActionButtonBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useQuickActionButtonBehavior.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,yBAAyB,EAAgC,MAAM,sDAAsD,CAAC;AAQpI;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,CAqDxE"}

package/dist/esm/components/navigation/app-level/useQuickSwitcherBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useQuickSwitcherBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useQuickSwitcherBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAC;AAW7G,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAElG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC9C,oGAAoG;IACpG,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB;;;;;OAKG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,yBAAyB,GAAG,SAAS,EAC/C,KAAK,EAAE,uBAAuB,GAC7B,gCAAgC,GAAG,SAAS,CAsB9C;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,qBAAqB,CAqP7G"}
+{"version":3,"file":"useQuickSwitcherBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useQuickSwitcherBehavior.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAC;AAW7G,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAElG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC9C,oGAAoG;IACpG,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB;;;;;OAKG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,yBAAyB,GAAG,SAAS,EAC/C,KAAK,EAAE,uBAAuB,GAC7B,gCAAgC,GAAG,SAAS,CAuB9C;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,qBAAqB,CAqP7G"}

package/dist/esm/components/navigation/app-level/useQuickSwitcherBehavior.js

@@ -1,4 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
 import { useForm, useWatch } from 'react-hook-form';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE, FieldSchemaType, getArrayItemSchema, getSchemaType, isForeignKey } from '@wildo-ai/zod-decorators';
@@ -21,7 +22,8 @@ export function resolveQuickSwitcherFieldSchema(registry, field) {
     if (!resourceConfig?.mainSchema) {
         return undefined;
     }
-    const shape = resourceConfig.mainSchema.shape;
+    // Every field some row can hold (#2455): a scope field only an inheritance variant declares is found too.
+    const shape = FrontendResourceUtils.resolveFieldShapeOfAnyVariant(resourceConfig);
     const directSchema = shape?.[field.fieldIdentifier];
     if (directSchema) {
         return { schema: directSchema, isPrimaryKeyFallback: false };

package/dist/esm/components/navigation/app-level/useQuickSwitcherBehavior.js.map

@@ -1 +1 @@
-{"version":3,"file":"useQuickSwitcherBehavior.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useQuickSwitcherBehavior.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useForm, useWatch } from 'react-hook-form';\nimport type { z } from 'zod';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE, FieldSchemaType, getArrayItemSchema, getSchemaType, isForeignKey } from '@wildo-ai/zod-decorators';\n\nimport type { AppScopeFieldDefinition } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { QuickSwitcherFieldPresentation } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { ScopeChangeInitiator, type AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { APP_SCOPE_FIELD_DEFAULT_POSITION } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { QuickSwitcherBehavior } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\nimport { QuickSwitcherFieldControlKind } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport interface UseQuickSwitcherBehaviorOptions {\n  /** The container hosting this quick switcher (e.g. MENUBAR, SIDEBAR). Affects layout derivation. */\n  containerType?: ApplicationLevelComponentType;\n  /** External focus signal owned by a host container. */\n  focusTrigger?: number;\n}\n\n/**\n * Result of {@link resolveQuickSwitcherFieldSchema} — carries the resolved Zod schema\n * PLUS its provenance. Provenance matters downstream: a schema obtained through the\n * primary-key fallback (`_id` / `id`) is not decorated `isForeignKey`, yet the scope\n * field is BY DEFINITION selecting an instance of `field.resourceType`. Without the\n * provenance bit the control-kind derivation degrades such fields to a RAW text input\n * (the user would be asked to type a Mongo ObjectId by hand).\n */\nexport interface ResolvedQuickSwitcherFieldSchema {\n  schema: z.ZodTypeAny;\n  /**\n   * `true` when the configured `fieldIdentifier` was not present on the resource's\n   * `mainSchema` and the resource's own primary-key schema (`_id` / `id`) was used\n   * instead. Such a field always represents \"pick an instance of `field.resourceType`\",\n   * so consumers must render a resource-reference control targeting that resource type.\n   */\n  isPrimaryKeyFallback: boolean;\n}\n\nexport function resolveQuickSwitcherFieldSchema(\n  registry: FrontendResourcesRegistry | undefined,\n  field: AppScopeFieldDefinition,\n): ResolvedQuickSwitcherFieldSchema | undefined {\n  if (!registry) {\n    return undefined;\n  }\n\n  const resourceConfig = registry.resourceConfigurations[field.resourceType];\n  if (!resourceConfig?.mainSchema) {\n    return undefined;\n  }\n\n  const shape = (resourceConfig.mainSchema as z.ZodObject<any>).shape;\n  const directSchema = shape?.[field.fieldIdentifier];\n  if (directSchema) {\n    return { schema: directSchema, isPrimaryKeyFallback: false };\n  }\n\n  if (field.fieldIdentifier !== resourceConfig.resourceFieldIdentifier) {\n    return undefined;\n  }\n\n  const primaryKeySchema = shape?._id ?? shape?.id;\n  return primaryKeySchema ? { schema: primaryKeySchema, isPrimaryKeyFallback: true } : undefined;\n}\n\n/**\n * Behavior hook for QuickSwitcher — manages bidirectional sync between\n * react-hook-form and AppScopeContext for scope fields declared in\n * the canonical top-level `appScope.fields` configuration.\n *\n * All fields in customScopeFields are quick switcher fields by definition\n * (they were declared as app scope fields and surfaced through the QuickSwitcher UI).\n */\nexport function useQuickSwitcherBehavior(options: UseQuickSwitcherBehaviorOptions = {}): QuickSwitcherBehavior {\n  const appScope = useAppScopeSafe();\n  const { on } = useEventBus();\n  const { registry } = useResourceRegistry();\n  const [internalFocusTrigger, setInternalFocusTrigger] = useState(0);\n  const focusTrigger = options.focusTrigger ?? internalFocusTrigger;\n\n  useEffect(() => {\n    if (options.focusTrigger !== undefined) return;\n    return on(FrontendEvents.HOTKEY_QUICK_SWITCHER_OPEN, () => {\n      setInternalFocusTrigger(prev => prev + 1);\n    });\n  }, [on, options.focusTrigger]);\n\n  const formMethods = useForm({\n    mode: 'onChange',\n    defaultValues: appScope?.customScopeValues ?? {},\n  });\n\n  const isSyncingFromScopeRef = useRef(false);\n\n  const normalizeScopeValueForForm = useCallback((value: AppScopeValue, isMultiple: boolean): string | string[] | undefined => {\n    if (value === null || value === undefined) {\n      return isMultiple ? [] : undefined;\n    }\n    if (Array.isArray(value)) {\n      return isMultiple ? value : value[0];\n    }\n    return isMultiple ? [value] : value;\n  }, []);\n\n  const switchableFields = useMemo(() => {\n    if (!appScope?.customScopeFields) return [];\n\n    // All custom scope fields are switchable — the QuickSwitcher is the app-level\n    // surface for selecting those declared scope dimensions.\n    // Sort by position (lower = higher).\n    return [...appScope.customScopeFields]\n      .sort((a, b) => (\n        (a.position ?? APP_SCOPE_FIELD_DEFAULT_POSITION) -\n        (b.position ?? APP_SCOPE_FIELD_DEFAULT_POSITION)\n      ));\n  }, [appScope?.customScopeFields]);\n\n  const fieldSchemas = useMemo(() => {\n    const schemas = new Map<string, ResolvedQuickSwitcherFieldSchema>();\n\n    if (!registry) {\n      return schemas;\n    }\n\n    for (const field of switchableFields) {\n      const resolved = resolveQuickSwitcherFieldSchema(registry, field);\n      if (resolved) {\n        schemas.set(field.fieldIdentifier, resolved);\n      }\n    }\n\n    return schemas;\n  }, [switchableFields, registry]);\n\n  // Sync scope → form when external changes occur (URL, cascade, etc.)\n  useEffect(() => {\n    if (appScope?.customScopeValues) {\n      isSyncingFromScopeRef.current = true;\n      for (const field of appScope.customScopeFields) {\n        const fieldId = field.fieldIdentifier;\n        const value = appScope.customScopeValues[fieldId];\n        const currentFormValue = formMethods.getValues(fieldId);\n        const fieldSchema = fieldSchemas.get(fieldId)?.schema;\n        const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : Array.isArray(value);\n        const normalizedValue = normalizeScopeValueForForm(value ?? null, isMultiple);\n        if (JSON.stringify(currentFormValue) !== JSON.stringify(normalizedValue)) {\n          formMethods.setValue(fieldId, normalizedValue);\n        }\n      }\n      queueMicrotask(() => {\n        isSyncingFromScopeRef.current = false;\n      });\n    }\n  }, [appScope?.customScopeValues, appScope?.customScopeFields, formMethods, normalizeScopeValueForForm, fieldSchemas]);\n\n  const resourceTypes = useMemo(() => {\n    const types = new Set<string>();\n    for (const field of switchableFields) {\n      types.add(field.resourceType);\n    }\n    return Array.from(types);\n  }, [switchableFields]);\n\n  const { tResourceHeader } = useI18n({\n    component: FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER,\n    resource: resourceTypes,\n  });\n\n  const fieldNames = useMemo(() =>\n    switchableFields.map(f => f.fieldIdentifier),\n    [switchableFields]\n  );\n\n  const watchedValues = useWatch({\n    control: formMethods.control,\n    name: fieldNames\n  });\n\n  // Sync form → scope when user changes values\n  useEffect(() => {\n    if (isSyncingFromScopeRef.current) {\n      return;\n    }\n\n    fieldNames.forEach((fieldId, index) => {\n      const formValue = watchedValues[index];\n      const scopeValue = appScope?.customScopeValues[fieldId];\n\n      const fieldSchema = fieldSchemas.get(fieldId)?.schema;\n      const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : false;\n\n      let normalizedFormValue: AppScopeValue;\n      if (formValue === undefined || formValue === '' || formValue === null) {\n        normalizedFormValue = null;\n      } else if (isMultiple) {\n        const values = Array.isArray(formValue)\n          ? formValue.filter((value): value is string => typeof value === 'string' && value.length > 0)\n          : [String(formValue)];\n        normalizedFormValue = values.length > 0 ? values : null;\n      } else {\n        normalizedFormValue = Array.isArray(formValue) ? (formValue[0] ?? null) : String(formValue);\n      }\n\n      if (JSON.stringify(normalizedFormValue) !== JSON.stringify(scopeValue ?? null)) {\n        appScope?.setScopeValue(fieldId, normalizedFormValue, {\n          initiator: ScopeChangeInitiator.USER_SELECTION\n        });\n      }\n    });\n  }, [watchedValues, fieldNames, appScope, switchableFields, fieldSchemas]);\n\n  const isFieldDisabled = useCallback(\n    (field: AppScopeFieldDefinition): boolean => {\n      const dependencyValue = field.dependsOn ? appScope?.allScopeValues?.[field.dependsOn] : null;\n      if (!field.dependsOn) {\n        return false;\n      }\n      if (Array.isArray(dependencyValue)) {\n        return dependencyValue.length === 0;\n      }\n      return !dependencyValue;\n    },\n    [appScope?.allScopeValues],\n  );\n\n  const fields = useMemo(() => {\n    return switchableFields.flatMap(field => {\n      const fieldId = field.fieldIdentifier;\n      const resolvedSchema = fieldSchemas.get(fieldId);\n\n      if (!resolvedSchema) {\n        if (envLoader.isDevelopment()) {\n          console.warn(`[QuickSwitcher] No schema found for scope field \"${fieldId}\" — field will not render.`);\n        }\n        return [];\n      }\n\n      const { schema, isPrimaryKeyFallback } = resolvedSchema;\n\n      const schemaType = getSchemaType(schema);\n      const isMultiple = schemaType === FieldSchemaType.ARRAY;\n      const valueSchema = isMultiple ? (getArrayItemSchema(schema) ?? schema) : schema;\n      const valueSchemaType = getSchemaType(valueSchema);\n      // Control-kind derivation:\n      // - an `isForeignKey`-decorated value schema is a reference to whatever resource\n      //   the FK metadata names (resolved downstream by `useResourceSearch`);\n      // - a PRIMARY-KEY FALLBACK schema (`_id`/`id` is never FK-decorated) is still a\n      //   resource selection BY DEFINITION — the switcher picks an instance of\n      //   `field.resourceType` — so it must render the same reference combobox, with the\n      //   target passed explicitly (`targetResourceType`) since no FK metadata exists.\n      //   Without this, the switcher degraded to a RAW text input asking the user to\n      //   type a raw id (frontend-ux-quality-audit E1).\n      const controlKind = isForeignKey(valueSchema) || isPrimaryKeyFallback\n        ? QuickSwitcherFieldControlKind.RESOURCE_REFERENCE\n        : valueSchemaType === FieldSchemaType.ENUM\n          ? QuickSwitcherFieldControlKind.ENUM\n          : QuickSwitcherFieldControlKind.RAW;\n\n      const resourceTitle = tResourceHeader(field.resourceType, 'title');\n      // Guaranteed non-empty accessible label: explicit config label → localized\n      // resource title → humanized field identifier → raw field identifier. The last\n      // two make the chain provably non-empty even before i18n resolves, so the\n      // rendered control never ends up with an empty label/aria name.\n      const label =\n        field.label\n        || resourceTitle\n        // `fieldId.replace(/([A-Z])/g, ' $1').trim()` stood here, one link above the raw `fieldId`\n        // it now falls through to. It only ever ran when both labels were missing, so it made an\n        // unlabelled field look labelled — in English, produced by code, in every locale.\n        || fieldId;\n\n      return [{\n        fieldId,\n        label,\n        schema,\n        valueSchema,\n        disabled: isFieldDisabled(field),\n        isMultiple,\n        controlKind,\n        // Explicit target for the reference combobox when the schema itself carries no\n        // FK metadata (primary-key fallback). Left undefined for FK-decorated schemas\n        // so the FK metadata stays the single source of the target resource.\n        targetResourceType: isPrimaryKeyFallback ? field.resourceType : undefined,\n        // Placeholder from the resource title (falls back to the label, which is\n        // non-empty by construction).\n        placeholder: resourceTitle || label,\n        // Declared per scope field; LABEL keeps the compact one-line option a\n        // menubar wants, SUMMARY renders each option's summary card.\n        optionDisplayMode: field.optionDisplayMode ?? DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE,\n        presentation: field.presentation ?? QuickSwitcherFieldPresentation.CONTROL_ONLY,\n        // Clearing writes through the SAME form → scope path a selection takes,\n        // so \"no scope\" is produced by one mechanism rather than two: the form\n        // effect emits `setScopeValue(null, USER_SELECTION)`, which is what\n        // demotes the URL and unfilters the dependent surfaces.\n        onClear: () => formMethods.setValue(fieldId, isMultiple ? [] : undefined, { shouldDirty: true, shouldTouch: true }),\n        hasValue: (() => {\n          const current = formMethods.getValues(fieldId) as unknown;\n          return Array.isArray(current) ? current.length > 0 : current !== undefined && current !== null && current !== '';\n        })(),\n        definition: field,\n      }];\n    });\n    // `watchedValues` is in the dep list because `hasValue` is derived from the\n    // live form state: without it the clear affordance would render from a\n    // stale snapshot and linger after the value was cleared.\n  }, [switchableFields, fieldSchemas, tResourceHeader, isFieldDisabled, formMethods, watchedValues]);\n\n  const layoutDirection = useMemo(() => {\n    if (options.containerType === ApplicationLevelComponentType.SIDEBAR) return 'vertical' as const;\n    return 'horizontal' as const;\n  }, [options.containerType]);\n\n  return {\n    fields,\n    formMethods,\n    layoutDirection,\n    focusTrigger,\n  };\n}\n"]}
+{"version":3,"file":"useQuickSwitcherBehavior.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useQuickSwitcherBehavior.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { useForm, useWatch } from 'react-hook-form';\nimport type { z } from 'zod';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE, FieldSchemaType, getArrayItemSchema, getSchemaType, isForeignKey } from '@wildo-ai/zod-decorators';\n\nimport type { AppScopeFieldDefinition } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { QuickSwitcherFieldPresentation } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { ScopeChangeInitiator, type AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { APP_SCOPE_FIELD_DEFAULT_POSITION } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { QuickSwitcherBehavior } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\nimport { QuickSwitcherFieldControlKind } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport interface UseQuickSwitcherBehaviorOptions {\n  /** The container hosting this quick switcher (e.g. MENUBAR, SIDEBAR). Affects layout derivation. */\n  containerType?: ApplicationLevelComponentType;\n  /** External focus signal owned by a host container. */\n  focusTrigger?: number;\n}\n\n/**\n * Result of {@link resolveQuickSwitcherFieldSchema} — carries the resolved Zod schema\n * PLUS its provenance. Provenance matters downstream: a schema obtained through the\n * primary-key fallback (`_id` / `id`) is not decorated `isForeignKey`, yet the scope\n * field is BY DEFINITION selecting an instance of `field.resourceType`. Without the\n * provenance bit the control-kind derivation degrades such fields to a RAW text input\n * (the user would be asked to type a Mongo ObjectId by hand).\n */\nexport interface ResolvedQuickSwitcherFieldSchema {\n  schema: z.ZodTypeAny;\n  /**\n   * `true` when the configured `fieldIdentifier` was not present on the resource's\n   * `mainSchema` and the resource's own primary-key schema (`_id` / `id`) was used\n   * instead. Such a field always represents \"pick an instance of `field.resourceType`\",\n   * so consumers must render a resource-reference control targeting that resource type.\n   */\n  isPrimaryKeyFallback: boolean;\n}\n\nexport function resolveQuickSwitcherFieldSchema(\n  registry: FrontendResourcesRegistry | undefined,\n  field: AppScopeFieldDefinition,\n): ResolvedQuickSwitcherFieldSchema | undefined {\n  if (!registry) {\n    return undefined;\n  }\n\n  const resourceConfig = registry.resourceConfigurations[field.resourceType];\n  if (!resourceConfig?.mainSchema) {\n    return undefined;\n  }\n\n  // Every field some row can hold (#2455): a scope field only an inheritance variant declares is found too.\n  const shape = FrontendResourceUtils.resolveFieldShapeOfAnyVariant(resourceConfig);\n  const directSchema = shape?.[field.fieldIdentifier];\n  if (directSchema) {\n    return { schema: directSchema, isPrimaryKeyFallback: false };\n  }\n\n  if (field.fieldIdentifier !== resourceConfig.resourceFieldIdentifier) {\n    return undefined;\n  }\n\n  const primaryKeySchema = shape?._id ?? shape?.id;\n  return primaryKeySchema ? { schema: primaryKeySchema, isPrimaryKeyFallback: true } : undefined;\n}\n\n/**\n * Behavior hook for QuickSwitcher — manages bidirectional sync between\n * react-hook-form and AppScopeContext for scope fields declared in\n * the canonical top-level `appScope.fields` configuration.\n *\n * All fields in customScopeFields are quick switcher fields by definition\n * (they were declared as app scope fields and surfaced through the QuickSwitcher UI).\n */\nexport function useQuickSwitcherBehavior(options: UseQuickSwitcherBehaviorOptions = {}): QuickSwitcherBehavior {\n  const appScope = useAppScopeSafe();\n  const { on } = useEventBus();\n  const { registry } = useResourceRegistry();\n  const [internalFocusTrigger, setInternalFocusTrigger] = useState(0);\n  const focusTrigger = options.focusTrigger ?? internalFocusTrigger;\n\n  useEffect(() => {\n    if (options.focusTrigger !== undefined) return;\n    return on(FrontendEvents.HOTKEY_QUICK_SWITCHER_OPEN, () => {\n      setInternalFocusTrigger(prev => prev + 1);\n    });\n  }, [on, options.focusTrigger]);\n\n  const formMethods = useForm({\n    mode: 'onChange',\n    defaultValues: appScope?.customScopeValues ?? {},\n  });\n\n  const isSyncingFromScopeRef = useRef(false);\n\n  const normalizeScopeValueForForm = useCallback((value: AppScopeValue, isMultiple: boolean): string | string[] | undefined => {\n    if (value === null || value === undefined) {\n      return isMultiple ? [] : undefined;\n    }\n    if (Array.isArray(value)) {\n      return isMultiple ? value : value[0];\n    }\n    return isMultiple ? [value] : value;\n  }, []);\n\n  const switchableFields = useMemo(() => {\n    if (!appScope?.customScopeFields) return [];\n\n    // All custom scope fields are switchable — the QuickSwitcher is the app-level\n    // surface for selecting those declared scope dimensions.\n    // Sort by position (lower = higher).\n    return [...appScope.customScopeFields]\n      .sort((a, b) => (\n        (a.position ?? APP_SCOPE_FIELD_DEFAULT_POSITION) -\n        (b.position ?? APP_SCOPE_FIELD_DEFAULT_POSITION)\n      ));\n  }, [appScope?.customScopeFields]);\n\n  const fieldSchemas = useMemo(() => {\n    const schemas = new Map<string, ResolvedQuickSwitcherFieldSchema>();\n\n    if (!registry) {\n      return schemas;\n    }\n\n    for (const field of switchableFields) {\n      const resolved = resolveQuickSwitcherFieldSchema(registry, field);\n      if (resolved) {\n        schemas.set(field.fieldIdentifier, resolved);\n      }\n    }\n\n    return schemas;\n  }, [switchableFields, registry]);\n\n  // Sync scope → form when external changes occur (URL, cascade, etc.)\n  useEffect(() => {\n    if (appScope?.customScopeValues) {\n      isSyncingFromScopeRef.current = true;\n      for (const field of appScope.customScopeFields) {\n        const fieldId = field.fieldIdentifier;\n        const value = appScope.customScopeValues[fieldId];\n        const currentFormValue = formMethods.getValues(fieldId);\n        const fieldSchema = fieldSchemas.get(fieldId)?.schema;\n        const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : Array.isArray(value);\n        const normalizedValue = normalizeScopeValueForForm(value ?? null, isMultiple);\n        if (JSON.stringify(currentFormValue) !== JSON.stringify(normalizedValue)) {\n          formMethods.setValue(fieldId, normalizedValue);\n        }\n      }\n      queueMicrotask(() => {\n        isSyncingFromScopeRef.current = false;\n      });\n    }\n  }, [appScope?.customScopeValues, appScope?.customScopeFields, formMethods, normalizeScopeValueForForm, fieldSchemas]);\n\n  const resourceTypes = useMemo(() => {\n    const types = new Set<string>();\n    for (const field of switchableFields) {\n      types.add(field.resourceType);\n    }\n    return Array.from(types);\n  }, [switchableFields]);\n\n  const { tResourceHeader } = useI18n({\n    component: FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER,\n    resource: resourceTypes,\n  });\n\n  const fieldNames = useMemo(() =>\n    switchableFields.map(f => f.fieldIdentifier),\n    [switchableFields]\n  );\n\n  const watchedValues = useWatch({\n    control: formMethods.control,\n    name: fieldNames\n  });\n\n  // Sync form → scope when user changes values\n  useEffect(() => {\n    if (isSyncingFromScopeRef.current) {\n      return;\n    }\n\n    fieldNames.forEach((fieldId, index) => {\n      const formValue = watchedValues[index];\n      const scopeValue = appScope?.customScopeValues[fieldId];\n\n      const fieldSchema = fieldSchemas.get(fieldId)?.schema;\n      const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : false;\n\n      let normalizedFormValue: AppScopeValue;\n      if (formValue === undefined || formValue === '' || formValue === null) {\n        normalizedFormValue = null;\n      } else if (isMultiple) {\n        const values = Array.isArray(formValue)\n          ? formValue.filter((value): value is string => typeof value === 'string' && value.length > 0)\n          : [String(formValue)];\n        normalizedFormValue = values.length > 0 ? values : null;\n      } else {\n        normalizedFormValue = Array.isArray(formValue) ? (formValue[0] ?? null) : String(formValue);\n      }\n\n      if (JSON.stringify(normalizedFormValue) !== JSON.stringify(scopeValue ?? null)) {\n        appScope?.setScopeValue(fieldId, normalizedFormValue, {\n          initiator: ScopeChangeInitiator.USER_SELECTION\n        });\n      }\n    });\n  }, [watchedValues, fieldNames, appScope, switchableFields, fieldSchemas]);\n\n  const isFieldDisabled = useCallback(\n    (field: AppScopeFieldDefinition): boolean => {\n      const dependencyValue = field.dependsOn ? appScope?.allScopeValues?.[field.dependsOn] : null;\n      if (!field.dependsOn) {\n        return false;\n      }\n      if (Array.isArray(dependencyValue)) {\n        return dependencyValue.length === 0;\n      }\n      return !dependencyValue;\n    },\n    [appScope?.allScopeValues],\n  );\n\n  const fields = useMemo(() => {\n    return switchableFields.flatMap(field => {\n      const fieldId = field.fieldIdentifier;\n      const resolvedSchema = fieldSchemas.get(fieldId);\n\n      if (!resolvedSchema) {\n        if (envLoader.isDevelopment()) {\n          console.warn(`[QuickSwitcher] No schema found for scope field \"${fieldId}\" — field will not render.`);\n        }\n        return [];\n      }\n\n      const { schema, isPrimaryKeyFallback } = resolvedSchema;\n\n      const schemaType = getSchemaType(schema);\n      const isMultiple = schemaType === FieldSchemaType.ARRAY;\n      const valueSchema = isMultiple ? (getArrayItemSchema(schema) ?? schema) : schema;\n      const valueSchemaType = getSchemaType(valueSchema);\n      // Control-kind derivation:\n      // - an `isForeignKey`-decorated value schema is a reference to whatever resource\n      //   the FK metadata names (resolved downstream by `useResourceSearch`);\n      // - a PRIMARY-KEY FALLBACK schema (`_id`/`id` is never FK-decorated) is still a\n      //   resource selection BY DEFINITION — the switcher picks an instance of\n      //   `field.resourceType` — so it must render the same reference combobox, with the\n      //   target passed explicitly (`targetResourceType`) since no FK metadata exists.\n      //   Without this, the switcher degraded to a RAW text input asking the user to\n      //   type a raw id (frontend-ux-quality-audit E1).\n      const controlKind = isForeignKey(valueSchema) || isPrimaryKeyFallback\n        ? QuickSwitcherFieldControlKind.RESOURCE_REFERENCE\n        : valueSchemaType === FieldSchemaType.ENUM\n          ? QuickSwitcherFieldControlKind.ENUM\n          : QuickSwitcherFieldControlKind.RAW;\n\n      const resourceTitle = tResourceHeader(field.resourceType, 'title');\n      // Guaranteed non-empty accessible label: explicit config label → localized\n      // resource title → humanized field identifier → raw field identifier. The last\n      // two make the chain provably non-empty even before i18n resolves, so the\n      // rendered control never ends up with an empty label/aria name.\n      const label =\n        field.label\n        || resourceTitle\n        // `fieldId.replace(/([A-Z])/g, ' $1').trim()` stood here, one link above the raw `fieldId`\n        // it now falls through to. It only ever ran when both labels were missing, so it made an\n        // unlabelled field look labelled — in English, produced by code, in every locale.\n        || fieldId;\n\n      return [{\n        fieldId,\n        label,\n        schema,\n        valueSchema,\n        disabled: isFieldDisabled(field),\n        isMultiple,\n        controlKind,\n        // Explicit target for the reference combobox when the schema itself carries no\n        // FK metadata (primary-key fallback). Left undefined for FK-decorated schemas\n        // so the FK metadata stays the single source of the target resource.\n        targetResourceType: isPrimaryKeyFallback ? field.resourceType : undefined,\n        // Placeholder from the resource title (falls back to the label, which is\n        // non-empty by construction).\n        placeholder: resourceTitle || label,\n        // Declared per scope field; LABEL keeps the compact one-line option a\n        // menubar wants, SUMMARY renders each option's summary card.\n        optionDisplayMode: field.optionDisplayMode ?? DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE,\n        presentation: field.presentation ?? QuickSwitcherFieldPresentation.CONTROL_ONLY,\n        // Clearing writes through the SAME form → scope path a selection takes,\n        // so \"no scope\" is produced by one mechanism rather than two: the form\n        // effect emits `setScopeValue(null, USER_SELECTION)`, which is what\n        // demotes the URL and unfilters the dependent surfaces.\n        onClear: () => formMethods.setValue(fieldId, isMultiple ? [] : undefined, { shouldDirty: true, shouldTouch: true }),\n        hasValue: (() => {\n          const current = formMethods.getValues(fieldId) as unknown;\n          return Array.isArray(current) ? current.length > 0 : current !== undefined && current !== null && current !== '';\n        })(),\n        definition: field,\n      }];\n    });\n    // `watchedValues` is in the dep list because `hasValue` is derived from the\n    // live form state: without it the clear affordance would render from a\n    // stale snapshot and linger after the value was cleared.\n  }, [switchableFields, fieldSchemas, tResourceHeader, isFieldDisabled, formMethods, watchedValues]);\n\n  const layoutDirection = useMemo(() => {\n    if (options.containerType === ApplicationLevelComponentType.SIDEBAR) return 'vertical' as const;\n    return 'horizontal' as const;\n  }, [options.containerType]);\n\n  return {\n    fields,\n    formMethods,\n    layoutDirection,\n    focusTrigger,\n  };\n}\n"]}

package/dist/esm/components/navigation/app-level/useSidebarBehavior.d.ts

@@ -1,6 +1,6 @@
 import { HorizontalPlacement } from '@wildo-ai/presets-components-models';
 import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
-import type { SidebarBehavior } from '../../../core/app-shell/app-shell.schemas';
+import type { HierarchicalNavigationItem, SidebarBehavior } from '../../../core/app-shell/app-shell.schemas';
 export interface UseSidebarBehaviorOptions {
     placement?: HorizontalPlacement;
     isCollapsed?: boolean;
@@ -31,4 +31,21 @@ export declare function resolveSidebarMobileDrawerMode(config: unknown, currentB
  */
 export declare function useSidebarMobileDrawerMode(): boolean;
 export declare function useSidebarBehavior(options?: UseSidebarBehaviorOptions): SidebarBehavior;
+/**
+ * Applies a navigation section's `nested` / `maxNestingDepth` to its rows.
+ *
+ * Both were declared, defaulted and carried onto the section, and nothing read them: the sidebar drew whatever
+ * children an item had, one level deep, and silently dropped every grandchild. Two settings that look like a control
+ * and do nothing (#2331). They now mean:
+ *
+ * - `nested: false` — the section is a flat list (the section's choice; an unset `nested` keeps the hierarchy). An item's children are listed after it, in order, at the same level.
+ * - `nested: true` — children are drawn as a disclosure list under their parent, `maxNestingDepth` levels deep (1: a
+ *   row's children nest, their children do not). A row deeper than the cap is drawn at the deepest level, after its
+ *   ancestor, in order.
+ *
+ * Neither setting ever DROPS a row: hiding a declared destination because of a presentation cap would make a page
+ * unreachable from the sidebar with nothing saying why. A cap below 1 is read as 1, since `nested: true` with no level
+ * to nest is `nested: false` spelled differently.
+ */
+export declare function shapeSectionNesting(items: HierarchicalNavigationItem[], nested: boolean, maxNestingDepth: number): HierarchicalNavigationItem[];
 //# sourceMappingURL=useSidebarBehavior.d.ts.map

package/dist/esm/components/navigation/app-level/useSidebarBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSidebarBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useSidebarBehavior.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAA8C,MAAM,qCAAqC,CAAC;AAUtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAoB9D,OAAO,KAAK,EAAyF,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAYnL,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,GAChD,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAKpD;AAuBD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CAmrB3F"}
+{"version":3,"file":"useSidebarBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useSidebarBehavior.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAA8C,MAAM,qCAAqC,CAAC;AAUtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAsB9D,OAAO,KAAK,EAAE,0BAA0B,EAA6D,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAYnL,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,GAChD,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAKpD;AAuBD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CAqsB3F;AAyHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,0BAA0B,EAAE,EACnC,MAAM,EAAE,OAAO,EACf,eAAe,EAAE,MAAM,GACtB,0BAA0B,EAAE,CAgB9B"}

package/dist/esm/components/navigation/app-level/useSidebarBehavior.js

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { ApplicationLevelComponentType, SidebarItemDisplayPolicy } from '../../../core/config/app-level-components.frontend.schemas.js';
 import { HorizontalPlacement, SidebarCompactLabelMode, VerticalPlacement } from '@wildo-ai/presets-components-models';
 import { SidebarHomeDisplayMode, SidebarSectionBehavior, SidebarSectionInlineCreate, SidebarSectionContentKind, SidebarResponsivePolicy, } from '../../../core/config/launcher-items.frontend.schemas.js';
 import { useBrandIdentity } from '../../../core/branding/useBrandIdentity.js';
@@ -8,6 +8,8 @@ import { NavigationContentType, NavigationItemType } from '../../../core/navigat
 import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
 import { useNavigationController } from '../../../core/navigation/useNavigationController.js';
 import { useUI } from '../../../core/ui/useUI.js';
+import { useApplication } from '../../../core/runtime/useApplication.js';
+import { withEngineClientsEntry, withEngineDecisionInbox } from '../../../components/navigation/app-level/engine-launcher-entries.js';
 import { LOCAL_STORAGE_KEYS, getLocalStorageItem, setLocalStorageItem } from '../../../core/commons/local-storage.frontend.schemas.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 import { resolveSidebarSections } from '../../../core/navigation/launcher-resolution.js';
@@ -111,16 +113,23 @@ export function useSidebarBehavior(options = {}) {
     const appScope = useAppScopeSafe();
     const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();
     // --- Config from UI context ---
-    const { UIConfig, appComponentsConfiguration, sidebarCompactLabelMode, navigationLayout } = useUI();
+    const { UIConfig, appComponentsConfiguration, sidebarCompactLabelMode, navigationLayout, suppressedEngineNavigationEntries } = useUI();
     const { navigate, navigateToResource } = useNavigationController();
     const { registry } = useResourceRegistry();
     const config = appComponentsConfiguration?.[ApplicationLevelComponentType.SIDEBAR];
     const sidebarEnabled = config !== false;
     const currentBreakpoint = UIConfig?.currentBreakpoint;
     const { on } = useEventBus();
-    const rawContentSections = isSidebarConfigObject(config)
+    // The engine's own rows join the application's sections before anything is filtered or resolved, so they are drawn,
+    // gated and highlighted exactly as an application's are: the decision inbox (#2527), when the application routes
+    // decisions to reviewers, and the Clients list (#2589), unless the application suppresses it.
+    const decisionInboxOffer = useApplication().appConfig.decisionInbox;
+    const declaredContentSections = isSidebarConfigObject(config)
         ? config.contentSections
         : undefined;
+    const rawContentSections = useMemo(() => (sidebarEnabled
+        ? withEngineClientsEntry(withEngineDecisionInbox(declaredContentSections, decisionInboxOffer), suppressedEngineNavigationEntries)
+        : declaredContentSections), [sidebarEnabled, declaredContentSections, decisionInboxOffer, suppressedEngineNavigationEntries]);
     const defaultSection = isSidebarConfigObject(config) ? config.defaultSection : undefined;
     // How HOME is surfaced (hidden / pinned brand header / navigation row). The
     // schema defaults this, but a `true`-shaped or absent sidebar config never
@@ -353,6 +362,8 @@ export function useSidebarBehavior(options = {}) {
             if (group.section.behavior === SidebarSectionBehavior.FAVORITES)
                 continue;
             collectItems(group.items);
+            // A row tucked into its section's "More" menu can be starred like any other, so it must be findable here too.
+            collectItems(group.moreMenuItems);
         }
         const withFavorites = groups
             .map((group) => {
@@ -408,6 +419,8 @@ export function useSidebarBehavior(options = {}) {
             // "drop things here" rationale claimed and did not have.
             .filter(group => group.contentKind !== SidebarSectionContentKind.NAVIGATION_LIST
             || group.items.length > 0
+            // A section whose rows are all tucked into its "More" menu still has rows.
+            || group.moreMenuItems.length > 0
             || group.section.inlineCreate !== SidebarSectionInlineCreate.NONE);
         // ── Engine ordering policy ──────────────────────────────────────────────
         // Primary section(s) first (they head the sidebar, sharing their group with
@@ -452,8 +465,11 @@ export function useSidebarBehavior(options = {}) {
                     collect(item.children);
             }
         };
-        for (const group of groupedSections)
+        // Rows tucked into a section's "More" menu are destinations too, and one of them may be the current page.
+        for (const group of groupedSections) {
             collect(group.items);
+            collect(group.moreMenuItems);
+        }
         return entries;
     }, [groupedSections]);
     const mostSpecificActiveUrlPath = useMemo(() => NavigationUtils.getMostSpecificActiveRoute(allItemEntries.map(entry => entry.urlPath), isItemActiveByRoute), [allItemEntries, isItemActiveByRoute]);
@@ -656,7 +672,10 @@ export function useSidebarBehavior(options = {}) {
         dimensions,
         sidebarConfig,
         isNavigationLoading: !resolutionCtx,
-        hasItems: resolvedSections.length > 0,
+        // Counted on what RENDERS: the sections that survived the empty-section rule above. It was counted on the
+        // resolved sections before that rule, so a sidebar whose sections were all empty showed neither a row nor
+        // its "nothing here" message. A Home row is a row, so it counts too.
+        hasItems: groupedSections.length > 0 || homeDisplayMode === SidebarHomeDisplayMode.NAVIGATION_ITEM,
         placement,
         isMobileDrawerMode,
         isMobileDrawerOpen,
@@ -714,7 +733,8 @@ function mapResolvedSectionToSectionGroup(resolved, index) {
                 behavior: resolved.behavior ?? SidebarSectionBehavior.STATIC,
                 inlineCreate: resolved.inlineCreate ?? SidebarSectionInlineCreate.NONE,
                 inlineCreateResourceType: resolved.inlineCreateResourceType,
-                nested: resolved.nested ?? false,
+                // A declared hierarchy is drawn as one unless the section says `nested: false` (see `shapeSectionNesting`).
+                nested: resolved.nested ?? true,
                 maxNestingDepth: resolved.maxNestingDepth ?? 1,
                 // Primary sections head the sidebar (and share their group with the
                 // Home row under NAVIGATION_ITEM): headerless and non-collapsible BY
@@ -736,13 +756,20 @@ function mapResolvedSectionToSectionGroup(resolved, index) {
              * degraded into a view link that resolved to nothing. Introduced and caught the same day
              * (2026-09-25), by a review pass over the change that introduced it.
              */
-            const items = resolved.items
+            const mapped = shapeSectionNesting(resolved.items
                 .map(item => mapResolvedItemToHierarchical(item))
-                .filter((item) => item !== null);
+                .filter((item) => item !== null), sectionProps.nested ?? true, sectionProps.maxNestingDepth ?? 1);
+            /*
+             * `SidebarItemDisplayPolicy.SECTION_MORE_MENU` tucks a row into its section's "More" menu instead of listing it.
+             * The policy was carried onto every item and then ignored here — `moreMenuItems` was always `[]` — so the
+             * preset's More menu could never appear and an item that asked to be tucked away was listed like any other.
+             */
+            const items = mapped.filter(item => item.displayPolicy !== SidebarItemDisplayPolicy.SECTION_MORE_MENU);
+            const moreMenuItems = mapped.filter(item => item.displayPolicy === SidebarItemDisplayPolicy.SECTION_MORE_MENU);
             return {
                 section: sectionProps,
                 items,
-                moreMenuItems: [],
+                moreMenuItems,
                 contentKind: SidebarSectionContentKind.NAVIGATION_LIST,
             };
         }
@@ -778,6 +805,36 @@ function mapResolvedSectionToSectionGroup(resolved, index) {
             };
     }
 }
+/**
+ * Applies a navigation section's `nested` / `maxNestingDepth` to its rows.
+ *
+ * Both were declared, defaulted and carried onto the section, and nothing read them: the sidebar drew whatever
+ * children an item had, one level deep, and silently dropped every grandchild. Two settings that look like a control
+ * and do nothing (#2331). They now mean:
+ *
+ * - `nested: false` — the section is a flat list (the section's choice; an unset `nested` keeps the hierarchy). An item's children are listed after it, in order, at the same level.
+ * - `nested: true` — children are drawn as a disclosure list under their parent, `maxNestingDepth` levels deep (1: a
+ *   row's children nest, their children do not). A row deeper than the cap is drawn at the deepest level, after its
+ *   ancestor, in order.
+ *
+ * Neither setting ever DROPS a row: hiding a declared destination because of a presentation cap would make a page
+ * unreachable from the sidebar with nothing saying why. A cap below 1 is read as 1, since `nested: true` with no level
+ * to nest is `nested: false` spelled differently.
+ */
+export function shapeSectionNesting(items, nested, maxNestingDepth) {
+    const levels = nested ? Math.max(1, Math.floor(maxNestingDepth)) : 0;
+    const flatten = (rows) => rows.flatMap(row => [{ ...row, children: undefined }, ...flatten((row.children ?? []))]);
+    /** `remaining` is how many more child levels may still be drawn under these rows. */
+    const shape = (rows, remaining) => rows.flatMap(row => {
+        const children = (row.children ?? []);
+        if (children.length === 0)
+            return [row];
+        if (remaining === 0)
+            return [{ ...row, children: undefined }, ...flatten(children)];
+        return [{ ...row, children: shape(children, remaining - 1) }];
+    });
+    return shape(items, levels);
+}
 /**
  * Maps a `ResolvedSidebarItem` to `HierarchicalNavigationItem`.
  * Bridges the new resolved types to the old navigation item interface