@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

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

@@ -1,4 +1,4 @@
-import type { QuickActionButtonBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+import type { QuickActionButtonBehavior } from '../../../core/app-shell/app-shell.schemas';
 /**
  * Behavior hook for the Quick Action Button — reads config, resolves actions,
  * splits primary vs menu actions, and manages popover open state.

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/useQuickActionButtonBehavior.js

@@ -57,4 +57,4 @@ export function useQuickActionButtonBehavior() {
         currentBreakpoint: UIConfig?.currentBreakpoint,
     };
 }
-//# sourceMappingURL=useQuickActionButtonBehavior.js.map
+//# sourceMappingURL=useQuickActionButtonBehavior.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useQuickActionButtonBehavior.js","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useQuickActionButtonBehavior.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useQuickActionButtonBehavior.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useQuickActionButtonBehavior.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react';\n\nimport {\n  ApplicationLevelComponentType,\n  QuickActionDisplayPolicy,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { QuickActionItem } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport {\n  filterQuickActionItemsByRuntimeAvailability,\n  useLauncherRuntimeAvailabilityContext,\n} from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { resolveQuickActions } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport { useLauncherResolutionContext } from '~wildo-frontend-lib/core/navigation/useLauncherResolutionContext';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\nimport type { QuickActionButtonBehavior, QuickActionButtonDisplayItem } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\nfunction isQABConfigObject(\n  config: unknown,\n): config is { actions?: QuickActionItem[] } {\n  return typeof config === 'object' && config !== null && !Array.isArray(config);\n}\n\n/**\n * Behavior hook for the Quick Action Button — reads config, resolves actions,\n * splits primary vs menu actions, and manages popover open state.\n */\nexport function useQuickActionButtonBehavior(): QuickActionButtonBehavior {\n  const { UIConfig, appComponentsConfiguration } = useUI();\n  const resolutionCtx = useLauncherResolutionContext();\n  const { navigate } = useNavigationController();\n  const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();\n\n  const config = appComponentsConfiguration?.[ApplicationLevelComponentType.QUICK_ACTION_BUTTON];\n  const configObj = isQABConfigObject(config) ? config : undefined;\n  const configActions = useMemo(() => (\n    filterQuickActionItemsByRuntimeAvailability(configObj?.actions, runtimeAvailabilityContext)\n  ), [configObj?.actions, runtimeAvailabilityContext]);\n\n  const resolvedActions = useMemo(() => {\n    if (!configActions?.length || !resolutionCtx) return [];\n    return resolveQuickActions(configActions, resolutionCtx);\n  }, [configActions, resolutionCtx]);\n\n  const allItems: QuickActionButtonDisplayItem[] = useMemo(() => {\n    return resolvedActions.map(item => ({\n      id: item.id,\n      label: item.label,\n      icon: item.icon,\n      displayPolicy: item.displayPolicy,\n      onClick: () => NavigationUtils.dispatchNavigationForResolvedTarget(\n        navigate, item, ApplicationLevelComponentType.QUICK_ACTION_BUTTON,\n      ),\n    }));\n  }, [resolvedActions, navigate]);\n\n  const { primaryAction, menuActions } = useMemo(() => {\n    const primary = allItems.find(i => i.displayPolicy === QuickActionDisplayPolicy.PRIMARY) ?? null;\n    const menu = allItems.filter(i => i.displayPolicy !== QuickActionDisplayPolicy.PRIMARY);\n    return { primaryAction: primary, menuActions: menu };\n  }, [allItems]);\n\n  const [isOpen, setIsOpen] = useState(false);\n\n  const handleActionClick = useCallback((item: QuickActionButtonDisplayItem) => {\n    setIsOpen(false);\n    item.onClick();\n  }, []);\n\n  return {\n    allItems,\n    primaryAction,\n    menuActions,\n    isOpen,\n    setIsOpen,\n    handleActionClick,\n    hasActions: Boolean(configActions?.length),\n    isNavigationLoading: Boolean(configActions?.length) && resolutionCtx === null,\n    currentBreakpoint: UIConfig?.currentBreakpoint,\n  };\n}\n"]}

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

@@ -1,15 +1,33 @@
 import type { z } from 'zod';
-import type { AppScopeFieldDefinition } from '../../../core/resources/resources.frontend.schemas.js';
-import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
-import type { QuickSwitcherBehavior } from '../../../core/app-shell/app-shell.schemas.js';
-import type { FrontendResourcesRegistry } from '../../../core/resources/resources.frontend.schemas.js';
+import type { AppScopeFieldDefinition } from '../../../core/resources/resources.frontend.schemas';
+import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas';
+import type { QuickSwitcherBehavior } from '../../../core/app-shell/app-shell.schemas';
+import type { FrontendResourcesRegistry } from '../../../core/resources/resources.frontend.schemas';
 export interface UseQuickSwitcherBehaviorOptions {
     /** The container hosting this quick switcher (e.g. MENUBAR, SIDEBAR). Affects layout derivation. */
     containerType?: ApplicationLevelComponentType;
     /** External focus signal owned by a host container. */
     focusTrigger?: number;
 }
-export declare function resolveQuickSwitcherFieldSchema(registry: FrontendResourcesRegistry | undefined, field: AppScopeFieldDefinition): z.ZodTypeAny | undefined;
+/**
+ * Result of {@link resolveQuickSwitcherFieldSchema} — carries the resolved Zod schema
+ * PLUS its provenance. Provenance matters downstream: a schema obtained through the
+ * primary-key fallback (`_id` / `id`) is not decorated `isForeignKey`, yet the scope
+ * field is BY DEFINITION selecting an instance of `field.resourceType`. Without the
+ * provenance bit the control-kind derivation degrades such fields to a RAW text input
+ * (the user would be asked to type a Mongo ObjectId by hand).
+ */
+export interface ResolvedQuickSwitcherFieldSchema {
+    schema: z.ZodTypeAny;
+    /**
+     * `true` when the configured `fieldIdentifier` was not present on the resource's
+     * `mainSchema` and the resource's own primary-key schema (`_id` / `id`) was used
+     * instead. Such a field always represents "pick an instance of `field.resourceType`",
+     * so consumers must render a resource-reference control targeting that resource type.
+     */
+    isPrimaryKeyFallback: boolean;
+}
+export declare function resolveQuickSwitcherFieldSchema(registry: FrontendResourcesRegistry | undefined, field: AppScopeFieldDefinition): ResolvedQuickSwitcherFieldSchema | undefined;
 /**
  * Behavior hook for QuickSwitcher — manages bidirectional sync between
  * react-hook-form and AppScopeContext for scope fields declared in

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;AAU7G,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,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,yBAAyB,GAAG,SAAS,EAC/C,KAAK,EAAE,uBAAuB,GAC7B,CAAC,CAAC,UAAU,GAAG,SAAS,CAqB1B;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,qBAAqB,CA2M7G"}
+{"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,CAmP7G"}

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

@@ -1,7 +1,8 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useForm, useWatch } from 'react-hook-form';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
-import { FieldSchemaType, getArrayItemSchema, getSchemaType, isForeignKey } from '@wildo-ai/zod-decorators';
+import { DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE, FieldSchemaType, getArrayItemSchema, getSchemaType, isForeignKey } from '@wildo-ai/zod-decorators';
+import { QuickSwitcherFieldPresentation } from '../../../core/config/app-configuration-frontend.schemas.js';
 import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
 import { ScopeChangeInitiator } from '../../../core/scope/scope.frontend.schemas.js';
 import { FrontendEvents } from '../../../core/events/events.frontend.schemas.js';
@@ -23,12 +24,13 @@ export function resolveQuickSwitcherFieldSchema(registry, field) {
     const shape = resourceConfig.mainSchema.shape;
     const directSchema = shape?.[field.fieldIdentifier];
     if (directSchema) {
-        return directSchema;
+        return { schema: directSchema, isPrimaryKeyFallback: false };
     }
     if (field.fieldIdentifier !== resourceConfig.resourceFieldIdentifier) {
         return undefined;
     }
-    return shape?._id ?? shape?.id;
+    const primaryKeySchema = shape?._id ?? shape?.id;
+    return primaryKeySchema ? { schema: primaryKeySchema, isPrimaryKeyFallback: true } : undefined;
 }
 /**
  * Behavior hook for QuickSwitcher — manages bidirectional sync between
@@ -81,9 +83,9 @@ export function useQuickSwitcherBehavior(options = {}) {
             return schemas;
         }
         for (const field of switchableFields) {
-            const schema = resolveQuickSwitcherFieldSchema(registry, field);
-            if (schema) {
-                schemas.set(field.fieldIdentifier, schema);
+            const resolved = resolveQuickSwitcherFieldSchema(registry, field);
+            if (resolved) {
+                schemas.set(field.fieldIdentifier, resolved);
             }
         }
         return schemas;
@@ -96,7 +98,7 @@ export function useQuickSwitcherBehavior(options = {}) {
                 const fieldId = field.fieldIdentifier;
                 const value = appScope.customScopeValues[fieldId];
                 const currentFormValue = formMethods.getValues(fieldId);
-                const fieldSchema = fieldSchemas.get(fieldId);
+                const fieldSchema = fieldSchemas.get(fieldId)?.schema;
                 const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : Array.isArray(value);
                 const normalizedValue = normalizeScopeValueForForm(value ?? null, isMultiple);
                 if (JSON.stringify(currentFormValue) !== JSON.stringify(normalizedValue)) {
@@ -132,7 +134,7 @@ export function useQuickSwitcherBehavior(options = {}) {
         fieldNames.forEach((fieldId, index) => {
             const formValue = watchedValues[index];
             const scopeValue = appScope?.customScopeValues[fieldId];
-            const fieldSchema = fieldSchemas.get(fieldId);
+            const fieldSchema = fieldSchemas.get(fieldId)?.schema;
             const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : false;
             let normalizedFormValue;
             if (formValue === undefined || formValue === '' || formValue === null) {
@@ -167,25 +169,41 @@ export function useQuickSwitcherBehavior(options = {}) {
     const fields = useMemo(() => {
         return switchableFields.flatMap(field => {
             const fieldId = field.fieldIdentifier;
-            const schema = fieldSchemas.get(fieldId);
-            if (!schema) {
+            const resolvedSchema = fieldSchemas.get(fieldId);
+            if (!resolvedSchema) {
                 if (envLoader.isDevelopment()) {
                     console.warn(`[QuickSwitcher] No schema found for scope field "${fieldId}" — field will not render.`);
                 }
                 return [];
             }
+            const { schema, isPrimaryKeyFallback } = resolvedSchema;
             const schemaType = getSchemaType(schema);
             const isMultiple = schemaType === FieldSchemaType.ARRAY;
             const valueSchema = isMultiple ? (getArrayItemSchema(schema) ?? schema) : schema;
             const valueSchemaType = getSchemaType(valueSchema);
-            const controlKind = isForeignKey(valueSchema)
+            // Control-kind derivation:
+            // - an `isForeignKey`-decorated value schema is a reference to whatever resource
+            //   the FK metadata names (resolved downstream by `useResourceSearch`);
+            // - a PRIMARY-KEY FALLBACK schema (`_id`/`id` is never FK-decorated) is still a
+            //   resource selection BY DEFINITION — the switcher picks an instance of
+            //   `field.resourceType` — so it must render the same reference combobox, with the
+            //   target passed explicitly (`targetResourceType`) since no FK metadata exists.
+            //   Without this, the switcher degraded to a RAW text input asking the user to
+            //   type a raw id (frontend-ux-quality-audit E1).
+            const controlKind = isForeignKey(valueSchema) || isPrimaryKeyFallback
                 ? QuickSwitcherFieldControlKind.RESOURCE_REFERENCE
                 : valueSchemaType === FieldSchemaType.ENUM
                     ? QuickSwitcherFieldControlKind.ENUM
                     : QuickSwitcherFieldControlKind.RAW;
+            const resourceTitle = tResourceHeader(field.resourceType, 'title');
+            // Guaranteed non-empty accessible label: explicit config label → localized
+            // resource title → humanized field identifier → raw field identifier. The last
+            // two make the chain provably non-empty even before i18n resolves, so the
+            // rendered control never ends up with an empty label/aria name.
             const label = field.label
-                || tResourceHeader(field.resourceType, 'title')
-                || fieldId.replace(/([A-Z])/g, ' $1').trim();
+                || resourceTitle
+                || fieldId.replace(/([A-Z])/g, ' $1').trim()
+                || fieldId;
             return [{
                     fieldId,
                     label,
@@ -194,10 +212,33 @@ export function useQuickSwitcherBehavior(options = {}) {
                     disabled: isFieldDisabled(field),
                     isMultiple,
                     controlKind,
+                    // Explicit target for the reference combobox when the schema itself carries no
+                    // FK metadata (primary-key fallback). Left undefined for FK-decorated schemas
+                    // so the FK metadata stays the single source of the target resource.
+                    targetResourceType: isPrimaryKeyFallback ? field.resourceType : undefined,
+                    // Placeholder from the resource title (falls back to the label, which is
+                    // non-empty by construction).
+                    placeholder: resourceTitle || label,
+                    // Declared per scope field; LABEL keeps the compact one-line option a
+                    // menubar wants, SUMMARY renders each option's summary card.
+                    optionDisplayMode: field.optionDisplayMode ?? DEFAULT_FOREIGN_KEY_OPTION_DISPLAY_MODE,
+                    presentation: field.presentation ?? QuickSwitcherFieldPresentation.CONTROL_ONLY,
+                    // Clearing writes through the SAME form → scope path a selection takes,
+                    // so "no scope" is produced by one mechanism rather than two: the form
+                    // effect emits `setScopeValue(null, USER_SELECTION)`, which is what
+                    // demotes the URL and unfilters the dependent surfaces.
+                    onClear: () => formMethods.setValue(fieldId, isMultiple ? [] : undefined, { shouldDirty: true, shouldTouch: true }),
+                    hasValue: (() => {
+                        const current = formMethods.getValues(fieldId);
+                        return Array.isArray(current) ? current.length > 0 : current !== undefined && current !== null && current !== '';
+                    })(),
                     definition: field,
                 }];
         });
-    }, [switchableFields, fieldSchemas, tResourceHeader, isFieldDisabled]);
+        // `watchedValues` is in the dep list because `hasValue` is derived from the
+        // live form state: without it the clear affordance would render from a
+        // stale snapshot and linger after the value was cleared.
+    }, [switchableFields, fieldSchemas, tResourceHeader, isFieldDisabled, formMethods, watchedValues]);
     const layoutDirection = useMemo(() => {
         if (options.containerType === ApplicationLevelComponentType.SIDEBAR)
             return 'vertical';
@@ -210,4 +251,4 @@ export function useQuickSwitcherBehavior(options = {}) {
         focusTrigger,
     };
 }
-//# sourceMappingURL=useQuickSwitcherBehavior.js.map
+//# sourceMappingURL=useQuickSwitcherBehavior.js.map

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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"}
+{"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()\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,10 +1,35 @@
 import { HorizontalPlacement } from '@wildo-ai/presets-components-models';
-import type { SidebarBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import type { SidebarBehavior } from '../../../core/app-shell/app-shell.schemas';
 export interface UseSidebarBehaviorOptions {
     placement?: HorizontalPlacement;
     isCollapsed?: boolean;
     onToggleCollapse?: () => void;
 }
+/**
+ * Single source of the "sidebar renders as a mobile overlay drawer" decision, shared
+ * by `useSidebarBehavior` (which owns the drawer open state) and the menubar burger
+ * trigger (which only needs to know whether to render). The decision is DERIVED from
+ * config + current breakpoint — never stored in state — so it cannot race the
+ * breakpoint read the way the old auto-collapse effect did.
+ *
+ * `true` when ALL of:
+ * - the sidebar config is the object form (or defaulted) with `policy === BURGER`
+ *   (the schema documents BURGER as "burger menu / drawer overlay on mobile");
+ * - the current breakpoint is at or below the configured `responsiveBreakpoint`
+ *   (default `MOBILE`, honoring the previously-dead config axis).
+ *
+ * `DRAWER` policy keeps its distinct documented semantics (sidebar stays visible
+ * inline, auto-expands on desktop) and never enters overlay-drawer mode.
+ */
+export declare function resolveSidebarMobileDrawerMode(config: unknown, currentBreakpoint: ViewportBreakpoint | undefined): boolean;
+/**
+ * Lightweight companion hook for launchers OUTSIDE the sidebar (the menubar burger
+ * trigger): reports whether the sidebar currently operates in mobile-drawer mode,
+ * without instantiating the full sidebar behavior (whose drawer state must stay
+ * owned by the single sidebar-preset instance).
+ */
+export declare function useSidebarMobileDrawerMode(): boolean;
 /**
  * Pure behavior hook for the Sidebar — zero rendering, 100% logic.
  *

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,EAAE,MAAM,qCAAqC,CAAC;AA4B1E,OAAO,KAAK,EAAgE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAW1J,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CAsT3F"}
+{"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;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CA8iB3F"}