@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,213 @@
+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 { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
+import { ScopeChangeInitiator } from '../../../core/scope/scope.frontend.schemas.js';
+import { FrontendEvents } from '../../../core/events/events.frontend.schemas.js';
+import { useEventBus } from '../../../core/events/useEventBus.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { envLoader } from '../../../core/runtime/env-variable-loader.frontend.service.js';
+import { APP_SCOPE_FIELD_DEFAULT_POSITION } from '../../../core/config/app-configuration-frontend.schemas.js';
+import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { QuickSwitcherFieldControlKind } from '../../../core/app-shell/app-shell.schemas.js';
+export function resolveQuickSwitcherFieldSchema(registry, field) {
+    if (!registry) {
+        return undefined;
+    }
+    const resourceConfig = registry.resourceConfigurations[field.resourceType];
+    if (!resourceConfig?.mainSchema) {
+        return undefined;
+    }
+    const shape = resourceConfig.mainSchema.shape;
+    const directSchema = shape?.[field.fieldIdentifier];
+    if (directSchema) {
+        return directSchema;
+    }
+    if (field.fieldIdentifier !== resourceConfig.resourceFieldIdentifier) {
+        return undefined;
+    }
+    return shape?._id ?? shape?.id;
+}
+/**
+ * Behavior hook for QuickSwitcher — manages bidirectional sync between
+ * react-hook-form and AppScopeContext for scope fields declared in
+ * the canonical top-level `appScope.fields` configuration.
+ *
+ * All fields in customScopeFields are quick switcher fields by definition
+ * (they were declared as app scope fields and surfaced through the QuickSwitcher UI).
+ */
+export function useQuickSwitcherBehavior(options = {}) {
+    const appScope = useAppScopeSafe();
+    const { on } = useEventBus();
+    const { registry } = useResourceRegistry();
+    const [internalFocusTrigger, setInternalFocusTrigger] = useState(0);
+    const focusTrigger = options.focusTrigger ?? internalFocusTrigger;
+    useEffect(() => {
+        if (options.focusTrigger !== undefined)
+            return;
+        return on(FrontendEvents.HOTKEY_QUICK_SWITCHER_OPEN, () => {
+            setInternalFocusTrigger(prev => prev + 1);
+        });
+    }, [on, options.focusTrigger]);
+    const formMethods = useForm({
+        mode: 'onChange',
+        defaultValues: appScope?.customScopeValues ?? {},
+    });
+    const isSyncingFromScopeRef = useRef(false);
+    const normalizeScopeValueForForm = useCallback((value, isMultiple) => {
+        if (value === null || value === undefined) {
+            return isMultiple ? [] : undefined;
+        }
+        if (Array.isArray(value)) {
+            return isMultiple ? value : value[0];
+        }
+        return isMultiple ? [value] : value;
+    }, []);
+    const switchableFields = useMemo(() => {
+        if (!appScope?.customScopeFields)
+            return [];
+        // All custom scope fields are switchable — the QuickSwitcher is the app-level
+        // surface for selecting those declared scope dimensions.
+        // Sort by position (lower = higher).
+        return [...appScope.customScopeFields]
+            .sort((a, b) => ((a.position ?? APP_SCOPE_FIELD_DEFAULT_POSITION) -
+            (b.position ?? APP_SCOPE_FIELD_DEFAULT_POSITION)));
+    }, [appScope?.customScopeFields]);
+    const fieldSchemas = useMemo(() => {
+        const schemas = new Map();
+        if (!registry) {
+            return schemas;
+        }
+        for (const field of switchableFields) {
+            const schema = resolveQuickSwitcherFieldSchema(registry, field);
+            if (schema) {
+                schemas.set(field.fieldIdentifier, schema);
+            }
+        }
+        return schemas;
+    }, [switchableFields, registry]);
+    // Sync scope → form when external changes occur (URL, cascade, etc.)
+    useEffect(() => {
+        if (appScope?.customScopeValues) {
+            isSyncingFromScopeRef.current = true;
+            for (const field of appScope.customScopeFields) {
+                const fieldId = field.fieldIdentifier;
+                const value = appScope.customScopeValues[fieldId];
+                const currentFormValue = formMethods.getValues(fieldId);
+                const fieldSchema = fieldSchemas.get(fieldId);
+                const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : Array.isArray(value);
+                const normalizedValue = normalizeScopeValueForForm(value ?? null, isMultiple);
+                if (JSON.stringify(currentFormValue) !== JSON.stringify(normalizedValue)) {
+                    formMethods.setValue(fieldId, normalizedValue);
+                }
+            }
+            queueMicrotask(() => {
+                isSyncingFromScopeRef.current = false;
+            });
+        }
+    }, [appScope?.customScopeValues, appScope?.customScopeFields, formMethods, normalizeScopeValueForForm, fieldSchemas]);
+    const resourceTypes = useMemo(() => {
+        const types = new Set();
+        for (const field of switchableFields) {
+            types.add(field.resourceType);
+        }
+        return Array.from(types);
+    }, [switchableFields]);
+    const { tResourceHeader } = useI18n({
+        component: FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER,
+        resource: resourceTypes,
+    });
+    const fieldNames = useMemo(() => switchableFields.map(f => f.fieldIdentifier), [switchableFields]);
+    const watchedValues = useWatch({
+        control: formMethods.control,
+        name: fieldNames
+    });
+    // Sync form → scope when user changes values
+    useEffect(() => {
+        if (isSyncingFromScopeRef.current) {
+            return;
+        }
+        fieldNames.forEach((fieldId, index) => {
+            const formValue = watchedValues[index];
+            const scopeValue = appScope?.customScopeValues[fieldId];
+            const fieldSchema = fieldSchemas.get(fieldId);
+            const isMultiple = fieldSchema ? getSchemaType(fieldSchema) === FieldSchemaType.ARRAY : false;
+            let normalizedFormValue;
+            if (formValue === undefined || formValue === '' || formValue === null) {
+                normalizedFormValue = null;
+            }
+            else if (isMultiple) {
+                const values = Array.isArray(formValue)
+                    ? formValue.filter((value) => typeof value === 'string' && value.length > 0)
+                    : [String(formValue)];
+                normalizedFormValue = values.length > 0 ? values : null;
+            }
+            else {
+                normalizedFormValue = Array.isArray(formValue) ? (formValue[0] ?? null) : String(formValue);
+            }
+            if (JSON.stringify(normalizedFormValue) !== JSON.stringify(scopeValue ?? null)) {
+                appScope?.setScopeValue(fieldId, normalizedFormValue, {
+                    initiator: ScopeChangeInitiator.USER_SELECTION
+                });
+            }
+        });
+    }, [watchedValues, fieldNames, appScope, switchableFields, fieldSchemas]);
+    const isFieldDisabled = useCallback((field) => {
+        const dependencyValue = field.dependsOn ? appScope?.allScopeValues?.[field.dependsOn] : null;
+        if (!field.dependsOn) {
+            return false;
+        }
+        if (Array.isArray(dependencyValue)) {
+            return dependencyValue.length === 0;
+        }
+        return !dependencyValue;
+    }, [appScope?.allScopeValues]);
+    const fields = useMemo(() => {
+        return switchableFields.flatMap(field => {
+            const fieldId = field.fieldIdentifier;
+            const schema = fieldSchemas.get(fieldId);
+            if (!schema) {
+                if (envLoader.isDevelopment()) {
+                    console.warn(`[QuickSwitcher] No schema found for scope field "${fieldId}" — field will not render.`);
+                }
+                return [];
+            }
+            const schemaType = getSchemaType(schema);
+            const isMultiple = schemaType === FieldSchemaType.ARRAY;
+            const valueSchema = isMultiple ? (getArrayItemSchema(schema) ?? schema) : schema;
+            const valueSchemaType = getSchemaType(valueSchema);
+            const controlKind = isForeignKey(valueSchema)
+                ? QuickSwitcherFieldControlKind.RESOURCE_REFERENCE
+                : valueSchemaType === FieldSchemaType.ENUM
+                    ? QuickSwitcherFieldControlKind.ENUM
+                    : QuickSwitcherFieldControlKind.RAW;
+            const label = field.label
+                || tResourceHeader(field.resourceType, 'title')
+                || fieldId.replace(/([A-Z])/g, ' $1').trim();
+            return [{
+                    fieldId,
+                    label,
+                    schema,
+                    valueSchema,
+                    disabled: isFieldDisabled(field),
+                    isMultiple,
+                    controlKind,
+                    definition: field,
+                }];
+        });
+    }, [switchableFields, fieldSchemas, tResourceHeader, isFieldDisabled]);
+    const layoutDirection = useMemo(() => {
+        if (options.containerType === ApplicationLevelComponentType.SIDEBAR)
+            return 'vertical';
+        return 'horizontal';
+    }, [options.containerType]);
+    return {
+        fields,
+        formMethods,
+        layoutDirection,
+        focusTrigger,
+    };
+}
+//# sourceMappingURL=useQuickSwitcherBehavior.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQuickSwitcherBehavior.js","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useQuickSwitcherBehavior.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+import { HorizontalPlacement } from '@wildo-ai/presets-components-models';
+import type { SidebarBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+export interface UseSidebarBehaviorOptions {
+    placement?: HorizontalPlacement;
+    isCollapsed?: boolean;
+    onToggleCollapse?: () => void;
+}
+/**
+ * Pure behavior hook for the Sidebar — zero rendering, 100% logic.
+ *
+ * Extracts section grouping, hierarchy, collapse state, inline create,
+ * badge counts, navigation click handling, and responsive policy from the
+ * monolithic `ApplicationLevelPreset_Sidebar_Default`.
+ */
+export declare function useSidebarBehavior(options?: UseSidebarBehaviorOptions): SidebarBehavior;
+//# sourceMappingURL=useSidebarBehavior.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,410 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { HorizontalPlacement } from '@wildo-ai/presets-components-models';
+import { SidebarSectionBehavior, SidebarSectionInlineCreate, SidebarSectionContentKind, SidebarResponsivePolicy, } from '../../../core/config/launcher-items.frontend.schemas.js';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import { NavigationContentType, NavigationItemType } from '../../../core/navigation/navigation.schemas.js';
+import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
+import { useNavigationController } from '../../../core/navigation/useNavigationController.js';
+import { useUI } from '../../../core/ui/useUI.js';
+import { LOCAL_STORAGE_KEYS } 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';
+import { useLauncherResolutionContext } from '../../../core/navigation/useLauncherResolutionContext.js';
+import { filterVisibleSections, buildScopeConditionParams, debugSectionVisibility } from '../../../core/mode/section-visibility.js';
+import { filterSidebarSectionsByRuntimeAvailability, useLauncherRuntimeAvailabilityContext, } from '../../../core/navigation/launcher-runtime-availability.js';
+import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
+import { envLoader } from '../../../core/runtime/env-variable-loader.frontend.service.js';
+import { useNavigationBehaviors } from './useNavigationBehaviors.js';
+import { useEventBus } from '../../../core/events/useEventBus.js';
+import { FrontendEvents } from '../../../core/events/events.frontend.schemas.js';
+import { isSidebarConfigObject } from '../../../core/app-shell/app-shell.schemas.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { frontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('SidebarBehavior');
+logger.setDebugTypeLogging('SidebarBehavior', false);
+/**
+ * Pure behavior hook for the Sidebar — zero rendering, 100% logic.
+ *
+ * Extracts section grouping, hierarchy, collapse state, inline create,
+ * badge counts, navigation click handling, and responsive policy from the
+ * monolithic `ApplicationLevelPreset_Sidebar_Default`.
+ */
+export function useSidebarBehavior(options = {}) {
+    const { placement = HorizontalPlacement.START, isCollapsed: externalIsCollapsed, onToggleCollapse, } = options;
+    const navBehaviors = useNavigationBehaviors();
+    const { isNavigationItemActive, badgeCounts } = navBehaviors;
+    // --- New per-launcher resolution context ---
+    const resolutionCtx = useLauncherResolutionContext();
+    // --- Mode + scope contexts for section filtering ---
+    const appScope = useAppScopeSafe();
+    const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();
+    // --- Config from UI context ---
+    const { UIConfig, appComponentsConfiguration } = useUI();
+    const { navigate } = useNavigationController();
+    const { registry } = useResourceRegistry();
+    const config = appComponentsConfiguration?.[ApplicationLevelComponentType.SIDEBAR];
+    const sidebarEnabled = config !== false;
+    const currentBreakpoint = UIConfig?.currentBreakpoint;
+    const { on } = useEventBus();
+    const rawContentSections = isSidebarConfigObject(config)
+        ? config.contentSections
+        : undefined;
+    const defaultSection = isSidebarConfigObject(config) ? config.defaultSection : undefined;
+    // Filter sections by mode + scope BEFORE resolution (skip resolving hidden sections)
+    const activeMode = runtimeAvailabilityContext.activeMode;
+    const availableModes = runtimeAvailabilityContext.availableModes;
+    const allScopeValues = runtimeAvailabilityContext.allScopeValues;
+    const contentSections = useMemo(() => {
+        if (!rawContentSections)
+            return undefined;
+        const scopeParams = buildScopeConditionParams(allScopeValues, activeMode, availableModes);
+        const visible = filterVisibleSections(rawContentSections, activeMode, scopeParams, envLoader.isDevelopment());
+        return filterSidebarSectionsByRuntimeAvailability(visible, runtimeAvailabilityContext);
+    }, [rawContentSections, activeMode, availableModes, allScopeValues, runtimeAvailabilityContext]);
+    // DEV-only: log visibility table when window.__WILDO_DEBUG_SIDEBAR__ is set.
+    // Runs as an effect so toggling the flag in DevTools takes effect on the
+    // next mode/scope/sections change without needing a manual refresh.
+    useEffect(() => {
+        if (!envLoader.isDevelopment() || !rawContentSections)
+            return;
+        if (!window.__WILDO_DEBUG_SIDEBAR__)
+            return;
+        const scopeParams = buildScopeConditionParams(allScopeValues, activeMode, availableModes);
+        debugSectionVisibility(rawContentSections, activeMode, scopeParams);
+    }, [rawContentSections, activeMode, availableModes, allScopeValues]);
+    // ===================================================================
+    // State Management
+    // ===================================================================
+    const [internalIsCollapsed, setInternalIsCollapsed] = useState(false);
+    const isCollapsed = externalIsCollapsed !== undefined ? externalIsCollapsed : internalIsCollapsed;
+    const [collapsedSections, setCollapsedSections] = useState(() => {
+        try {
+            const stored = localStorage.getItem(LOCAL_STORAGE_KEYS.SIDEBAR_SECTION_COLLAPSED);
+            return stored ? JSON.parse(stored) : {};
+        }
+        catch {
+            return {};
+        }
+    });
+    const [collapsedItems, setCollapsedItems] = useState({});
+    const [inlineCreateActive, setInlineCreateActive] = useState(null);
+    const [inlineCreateValue, setInlineCreateValue] = useState('');
+    // Persist section collapse state
+    useEffect(() => {
+        try {
+            localStorage.setItem(LOCAL_STORAGE_KEYS.SIDEBAR_SECTION_COLLAPSED, JSON.stringify(collapsedSections));
+        }
+        catch { /* ignore localStorage errors */ }
+    }, [collapsedSections]);
+    // ===================================================================
+    // Configuration Processing
+    // ===================================================================
+    const dimensions = useMemo(() => {
+        const isMobile = currentBreakpoint === ViewportBreakpoint.MOBILE;
+        const sidebarObj = isSidebarConfigObject(config) ? config : undefined;
+        return {
+            width: isMobile
+                ? (sidebarObj?.mobileWidth ?? 280)
+                : (sidebarObj?.width ?? 256),
+            collapsedWidth: isMobile
+                ? (sidebarObj?.mobileCollapsedWidth ?? 56)
+                : (sidebarObj?.collapsedWidth ?? 64),
+        };
+    }, [currentBreakpoint, config]);
+    // Auto-collapse on mobile (if configured)
+    useEffect(() => {
+        const policy = isSidebarConfigObject(config) ? config.policy : undefined;
+        if (currentBreakpoint === ViewportBreakpoint.MOBILE && policy === SidebarResponsivePolicy.BURGER) {
+            if (externalIsCollapsed === undefined)
+                setInternalIsCollapsed(true);
+        }
+        else if (currentBreakpoint !== ViewportBreakpoint.MOBILE && policy === SidebarResponsivePolicy.DRAWER) {
+            if (externalIsCollapsed === undefined)
+                setInternalIsCollapsed(false);
+        }
+    }, [currentBreakpoint, config, externalIsCollapsed]);
+    // ===================================================================
+    // Section Grouping Logic
+    // ===================================================================
+    // ===================================================================
+    // New per-launcher resolution path
+    // ===================================================================
+    const resolvedSections = useMemo(() => {
+        if (!contentSections || !resolutionCtx)
+            return [];
+        return resolveSidebarSections(contentSections, resolutionCtx);
+    }, [contentSections, resolutionCtx]);
+    // ===================================================================
+    // Section Grouping Logic (per-launcher resolution)
+    // ===================================================================
+    const groupedSections = useMemo(() => {
+        return resolvedSections.map((resolved, idx) => mapResolvedSectionToSectionGroup(resolved, idx));
+    }, [resolvedSections]);
+    // ===================================================================
+    // Computed Properties
+    // ===================================================================
+    const sidebarConfig = useMemo(() => {
+        const isCollapsible = isSidebarConfigObject(config) ? config.collapsible !== false : true;
+        const placementClass = placement === HorizontalPlacement.START ? 'border-e' : 'border-s';
+        const policy = isSidebarConfigObject(config) ? config.policy : SidebarResponsivePolicy.BURGER;
+        return {
+            isCollapsible,
+            placementClass,
+            responsivePolicy: policy,
+            currentWidth: isCollapsed ? dimensions.collapsedWidth : dimensions.width,
+        };
+    }, [config, placement, isCollapsed, dimensions]);
+    // ===================================================================
+    // Event Handlers
+    // ===================================================================
+    const handleToggleCollapse = useCallback(() => {
+        if (onToggleCollapse) {
+            onToggleCollapse();
+        }
+        else {
+            setInternalIsCollapsed(!isCollapsed);
+        }
+    }, [isCollapsed, onToggleCollapse]);
+    const handleToggleCollapseRef = useRef(handleToggleCollapse);
+    handleToggleCollapseRef.current = handleToggleCollapse;
+    useEffect(() => {
+        if (!sidebarEnabled)
+            return;
+        return on(FrontendEvents.HOTKEY_SIDEBAR_TOGGLE, () => {
+            handleToggleCollapseRef.current();
+        });
+    }, [on, sidebarEnabled]);
+    const handleToggleSectionCollapse = useCallback((sectionRef) => {
+        setCollapsedSections(prev => ({ ...prev, [sectionRef]: !prev[sectionRef] }));
+    }, []);
+    const isSectionCollapsed = useCallback((section) => {
+        if (!section.collapsible)
+            return false;
+        const stored = collapsedSections[section.ref];
+        if (stored !== undefined)
+            return stored;
+        if (defaultSection && section.ref === defaultSection)
+            return false;
+        return section.defaultCollapsed ?? false;
+    }, [collapsedSections, defaultSection]);
+    const handleToggleItemCollapse = useCallback((itemId) => {
+        setCollapsedItems(prev => ({ ...prev, [itemId]: !prev[itemId] }));
+    }, []);
+    const handleNavigationClick = useCallback((item) => {
+        logDebug('handleNavigationClick', {
+            itemId: item.id,
+            itemLabel: item.label,
+            urlPath: item.urlPath,
+        });
+        navBehaviors.handleNavigationClick(item, ApplicationLevelComponentType.SIDEBAR);
+    }, [navBehaviors.handleNavigationClick]);
+    const handleHomeClick = useCallback(() => {
+        logDebug('handleHomeClick: START');
+        navBehaviors.handleHomeClick();
+        logDebug('handleHomeClick: DONE');
+    }, [navBehaviors.handleHomeClick]);
+    // --- Inline create handlers ---
+    const handleStartInlineCreate = useCallback((sectionRef) => {
+        setInlineCreateActive(sectionRef);
+        setInlineCreateValue('');
+    }, []);
+    const handleCancelInlineCreate = useCallback(() => {
+        setInlineCreateActive(null);
+        setInlineCreateValue('');
+    }, []);
+    const handleSubmitInlineCreate = useCallback((sectionRef, resourceType) => {
+        if (!inlineCreateValue.trim() || !resourceType)
+            return;
+        const rawSections = isSidebarConfigObject(config)
+            ? config.contentSections
+            : undefined;
+        const section = rawSections?.find(s => s.ref === sectionRef);
+        const fieldName = (section?.contentKind === SidebarSectionContentKind.NAVIGATION_LIST
+            ? section.inlineCreateField
+            : undefined) ?? 'title';
+        const resourceConfig = registry.resourceConfigurations[resourceType];
+        const createOperation = resourceConfig?.operations?.find((operation) => String(operation.operationIdentifier) === CoreResourceOperation.CREATE);
+        if (!resourceConfig || !createOperation) {
+            return;
+        }
+        const resourceContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+            resourceType,
+            operation: createOperation,
+            contextResourceIdentifiers: appScope?.buildContextResourceIdentifiers() ?? {},
+            additionalContext: {
+                defaultValuesOverride: { [fieldName]: inlineCreateValue.trim() },
+            },
+        });
+        navigate({
+            content: {
+                contentType: NavigationContentType.RESOURCE_OPERATION,
+                resourceContext,
+            },
+            initiator: NavigationUtils.createAppLevelInitiator(ApplicationLevelComponentType.SIDEBAR),
+        });
+        handleCancelInlineCreate();
+    }, [inlineCreateValue, navigate, handleCancelInlineCreate, config, registry, appScope]);
+    const getBadgeCount = useCallback((badgeReference) => badgeReference ? badgeCounts[badgeReference] ?? 0 : 0, [badgeCounts]);
+    const isItemCollapsedFn = useCallback((itemId) => collapsedItems[itemId] ?? false, [collapsedItems]);
+    // ===================================================================
+    // Return
+    // ===================================================================
+    return {
+        groupedSections,
+        isCollapsed,
+        isHomeActive: navBehaviors.isHomeActive,
+        dimensions,
+        sidebarConfig,
+        isNavigationLoading: !resolutionCtx,
+        hasItems: resolvedSections.length > 0,
+        placement,
+        isNavigationItemActive,
+        isSectionCollapsed,
+        getBadgeCount,
+        isItemCollapsed: isItemCollapsedFn,
+        handleNavigationClick,
+        handleHomeClick,
+        handleToggleCollapse,
+        handleToggleSectionCollapse,
+        handleToggleItemCollapse,
+        inlineCreate: {
+            activeSection: inlineCreateActive,
+            value: inlineCreateValue,
+            start: handleStartInlineCreate,
+            cancel: handleCancelInlineCreate,
+            submit: handleSubmitInlineCreate,
+            setValue: setInlineCreateValue,
+        },
+    };
+}
+// ════════════════════════════════════════════════════════════════
+// Helpers: Map resolved sections to SectionGroup
+// ════════════════════════════════════════════════════════════════
+/**
+ * Maps a `ResolvedSidebarSection` (from the new per-launcher resolution) to
+ * the existing `SectionGroup` interface so consumers don't need to change.
+ *
+ * For `NAVIGATION_LIST`, resolved items are mapped to `HierarchicalNavigationItem`.
+ * For other content kinds, `items` is empty and the content-specific fields
+ * are set on `SectionGroup` for the rendering layer to dispatch on.
+ */
+function mapResolvedSectionToSectionGroup(resolved, index) {
+    const baseProps = {
+        ref: resolved.ref,
+        label: resolved.label,
+        showLabel: resolved.showLabel !== false,
+        collapsible: resolved.collapsible ?? false,
+        defaultCollapsed: resolved.defaultCollapsed ?? false,
+        behavior: SidebarSectionBehavior.STATIC,
+        inlineCreate: SidebarSectionInlineCreate.NONE,
+        nested: false,
+        maxNestingDepth: 1,
+    };
+    switch (resolved.contentKind) {
+        case SidebarSectionContentKind.NAVIGATION_LIST: {
+            const sectionProps = {
+                ...baseProps,
+                behavior: resolved.behavior ?? SidebarSectionBehavior.STATIC,
+                inlineCreate: resolved.inlineCreate ?? SidebarSectionInlineCreate.NONE,
+                inlineCreateResourceType: resolved.inlineCreateResourceType,
+                nested: resolved.nested ?? false,
+                maxNestingDepth: resolved.maxNestingDepth ?? 1,
+            };
+            const items = resolved.items.map(item => mapResolvedItemToHierarchical(item));
+            return {
+                section: sectionProps,
+                items,
+                moreMenuItems: [],
+                contentKind: SidebarSectionContentKind.NAVIGATION_LIST,
+            };
+        }
+        case SidebarSectionContentKind.RESOURCE_BROWSER:
+            return {
+                section: baseProps,
+                items: [],
+                moreMenuItems: [],
+                contentKind: SidebarSectionContentKind.RESOURCE_BROWSER,
+                resourceType: resolved.resourceType,
+                operation: resolved.operation,
+                operationVariant: resolved.operationVariant,
+                navigateOperation: resolved.navigateOperation,
+                navigateOperationVariant: resolved.navigateOperationVariant,
+                instanceFilter: resolved.instanceFilter,
+                onInstanceClick: resolved.onInstanceClick,
+            };
+        case SidebarSectionContentKind.GUIDANCE_WIDGET:
+            return {
+                section: baseProps,
+                items: [],
+                moreMenuItems: [],
+                contentKind: SidebarSectionContentKind.GUIDANCE_WIDGET,
+                guidanceRef: resolved.guidanceRef,
+            };
+        case SidebarSectionContentKind.CUSTOM_COMPONENT:
+            return {
+                section: baseProps,
+                items: [],
+                moreMenuItems: [],
+                contentKind: SidebarSectionContentKind.CUSTOM_COMPONENT,
+                componentRef: resolved.componentRef,
+            };
+    }
+}
+/**
+ * Maps a `ResolvedSidebarItem` to `HierarchicalNavigationItem`.
+ * Bridges the new resolved types to the old navigation item interface
+ * so existing rendering components continue to work.
+ *
+ * Dispatches on presence of `operation`/`resourceContext` to build a
+ * `ResourceNavigationItem`, otherwise builds a `ViewNavigationItem`.
+ */
+function mapResolvedItemToHierarchical(item) {
+    const base = {
+        id: item.id,
+        ref: item.ref,
+        label: item.label,
+        urlPath: item.urlPath,
+        icon: item.icon,
+        displayPolicy: item.displayPolicy,
+        badgeReference: item.badgeReference,
+        children: item.children?.map(mapResolvedItemToHierarchical),
+    };
+    if (item.operation && item.resourceContext) {
+        if (envLoader.isDevelopment()) {
+            if (!item.resourceType)
+                console.warn(`[SidebarBehavior] Resource item "${item.id}" missing resourceType`);
+            if (!item.operationIdentifier)
+                console.warn(`[SidebarBehavior] Resource item "${item.id}" missing operationIdentifier`);
+        }
+        return {
+            ...base,
+            itemType: NavigationItemType.RESOURCE,
+            resourceType: item.resourceType ?? '',
+            operationIdentifier: item.operationIdentifier ?? '',
+            operation: item.operation,
+            resourceContext: item.resourceContext,
+        };
+    }
+    if (item.componentRef) {
+        return {
+            ...base,
+            itemType: NavigationItemType.CUSTOM_COMPONENT,
+            componentRef: item.componentRef,
+            contextResourceIdentifiers: item.contextResourceIdentifiers,
+        };
+    }
+    return {
+        ...base,
+        itemType: NavigationItemType.VIEW,
+        viewRef: item.viewRef ?? item.ref,
+        contentType: item.contentType ?? NavigationContentType.COMPOSITE_VIEW,
+        contextResourceIdentifiers: item.contextResourceIdentifiers,
+        flowsActorsSystemRefs: item.flowsActorsSystemRefs,
+        fullCustomComponentRef: item.fullCustomComponentRef,
+        requiredFeatures: item.requiredFeatures,
+    };
+}
+//# sourceMappingURL=useSidebarBehavior.js.map