@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas.js';
+import type { UtilityPanelPlacement } from '../../../core/app-shell/app-shell.schemas.js';
+import type { BaseApplicationLevelProps } from './component-props.application-level.frontend.schemas.js';
+import type { UtilityPanelItem } from '../../../core/config/launcher-items.frontend.schemas.js';
+export interface ApplicationLevelProps_UtilityPanel extends BaseApplicationLevelProps {
+    /** Horizontal position of the utility panel. Defaults to END (right side). */
+    position?: UtilityPanelPlacement;
+    /** Items to display in the utility panel. */
+    items?: UtilityPanelItem[];
+}
+export declare function ApplicationLevel_UtilityPanel({ preset, ...props }: ApplicationLevelProps_UtilityPanel & ComponentPresetProps): React.JSX.Element;
+//# sourceMappingURL=ApplicationLevel_UtilityPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationLevel_UtilityPanel.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/ApplicationLevel_UtilityPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAGxH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACtG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iEAAiE,CAAC;AAGxG,MAAM,WAAW,kCAAmC,SAAQ,yBAAyB;IACnF,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAGD,wBAAgB,6BAA6B,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kCAAkC,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1K"}

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

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createComponentResolver } from '../../../core/components-registry/component-resolver.frontend.helper.js';
+import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
+export function ApplicationLevel_UtilityPanel({ preset = CorePresetNames.DEFAULT, ...props }) {
+    const Component = createComponentResolver(FrontendComponentType.APPLICATION_LEVEL_UTILITY_PANEL, 'ApplicationLevel_UtilityPanel')(preset);
+    return _jsx(Component, { ...props });
+}
+//# sourceMappingURL=ApplicationLevel_UtilityPanel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationLevel_UtilityPanel.js","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/ApplicationLevel_UtilityPanel.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAC;AAC1H,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAc7F,MAAM,UAAU,6BAA6B,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6D;IACrJ,MAAM,SAAS,GAAG,uBAAuB,CAAqC,qBAAqB,CAAC,+BAA+B,EAAE,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9K,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * SidebarResourceBrowser — renders a filterable list of resource instances
+ * inside a sidebar section.
+ *
+ * Uses `useResourceRegistry()` → `doOperation()` for data fetching, following
+ * the same pattern as `ResourceLayout_List.tsx`. The bound operation defaults
+ * to `CoreResourceOperation.LIST` unless overridden in the section config.
+ *
+ * Features:
+ * - Fetches instances via `doOperation` with scope-aware `contextualParameters`
+ * - Applies `instanceFilter` (client-side predicate) after fetching
+ * - `onInstanceClick` callback (default: navigate to instance)
+ * - Lightweight rendering for always-visible sidebar
+ *
+ * @see launcher-operation-binding-analysis.md §3.3.6
+ * @see app-shell-implementation-plan.md Step 7b
+ */
+import React from 'react';
+import type { ResourceBrowserClickContext } from '../../../core/config/launcher-items.frontend.schemas.js';
+export interface SidebarResourceBrowserProps {
+    resourceType: string;
+    operation?: string;
+    operationVariant?: string;
+    navigateOperation?: string;
+    navigateOperationVariant?: string;
+    instanceFilter?: (instance: Record<string, unknown>) => boolean;
+    onInstanceClick?: (context: ResourceBrowserClickContext) => void;
+    isCollapsed?: boolean;
+}
+/**
+ * Sidebar resource browser — fetches and displays a lightweight list
+ * of resource instances for browsing within the sidebar.
+ */
+export declare const SidebarResourceBrowser: React.FC<SidebarResourceBrowserProps>;
+//# sourceMappingURL=SidebarResourceBrowser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarResourceBrowser.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/SidebarResourceBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAkBjF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAuBnH,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAChE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA4QxE,CAAC"}

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

@@ -0,0 +1,234 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SidebarResourceBrowser — renders a filterable list of resource instances
+ * inside a sidebar section.
+ *
+ * Uses `useResourceRegistry()` → `doOperation()` for data fetching, following
+ * the same pattern as `ResourceLayout_List.tsx`. The bound operation defaults
+ * to `CoreResourceOperation.LIST` unless overridden in the section config.
+ *
+ * Features:
+ * - Fetches instances via `doOperation` with scope-aware `contextualParameters`
+ * - Applies `instanceFilter` (client-side predicate) after fetching
+ * - `onInstanceClick` callback (default: navigate to instance)
+ * - Lightweight rendering for always-visible sidebar
+ *
+ * @see launcher-operation-binding-analysis.md §3.3.6
+ * @see app-shell-implementation-plan.md Step 7b
+ */
+import { useEffect, useState, useRef, useCallback, useMemo } from 'react';
+import { CoreResourceOperation, ResourcesConfig_OperationPathUtils, } from '@wildo-ai/saas-models';
+import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { ScopeUtilsService } from '../../../core/scope/scope.utils.frontend.service.js';
+import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { frontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
+import { useNavigationController } from '../../../core/navigation/useNavigationController.js';
+import { IconCategory, IconSize } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('sidebar-resource-browser');
+logger.setDebugTypeLogging('sidebar-resource-browser', false);
+function resolveOperation(resourceConfig, operationIdentifier, variantKey) {
+    return resourceConfig.operations.find((operation) => {
+        const matchesOperation = operation.operationIdentifier === operationIdentifier;
+        if (variantKey) {
+            return matchesOperation && operation.variantKey === variantKey;
+        }
+        return matchesOperation && !operation.variantKey;
+    });
+}
+/**
+ * Sidebar resource browser — fetches and displays a lightweight list
+ * of resource instances for browsing within the sidebar.
+ */
+export const SidebarResourceBrowser = ({ resourceType, operation, operationVariant, navigateOperation, navigateOperationVariant, instanceFilter, onInstanceClick, isCollapsed = false, }) => {
+    const { registry, doOperation } = useResourceRegistry();
+    const { navigateToResource } = useNavigationController();
+    const appScope = useAppScopeSafe();
+    const { tResourceHeader, tResourceEmptyState, t } = useI18n({ resource: resourceType });
+    const { renderIcon } = useIconRegistry();
+    const [instances, setInstances] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const doOperationRef = useRef(doOperation);
+    doOperationRef.current = doOperation;
+    const resourceConfig = registry.resourceConfigurations[resourceType];
+    const boundOperation = useMemo(() => {
+        if (!resourceConfig)
+            return undefined;
+        return resolveOperation(resourceConfig, operation ?? CoreResourceOperation.LIST, operationVariant);
+    }, [resourceConfig, operation, operationVariant]);
+    const navigationOperationResolved = useMemo(() => {
+        if (!resourceConfig)
+            return undefined;
+        if (navigateOperation) {
+            return resolveOperation(resourceConfig, navigateOperation, navigateOperationVariant);
+        }
+        if (operation && operation !== CoreResourceOperation.LIST) {
+            return resolveOperation(resourceConfig, operation, operationVariant);
+        }
+        return (resolveOperation(resourceConfig, CoreResourceOperation.READ) ??
+            boundOperation);
+    }, [resourceConfig, navigateOperation, navigateOperationVariant, operation, operationVariant, boundOperation]);
+    const scopedContextIdentifiers = useMemo(() => {
+        if (!resourceConfig)
+            return {};
+        const primaryScopeInitiatorIds = ScopeUtilsService.buildInitiatorIds({
+            userId: appScope?.currentUserId,
+            organizationId: appScope?.currentOrganizationId,
+            applicationId: appScope?.currentApplicationId,
+            anonymousUserId: appScope?.currentAnonymousUserId,
+        });
+        return {
+            ...ScopeUtilsService.primaryScopeToContextIdentifiers(primaryScopeInitiatorIds, resourceConfig.resourcePrimaryScope),
+            ...(appScope?.buildContextResourceIdentifiers() ?? {}),
+        };
+    }, [
+        resourceConfig,
+        appScope?.currentUserId,
+        appScope?.currentOrganizationId,
+        appScope?.currentApplicationId,
+        appScope?.currentAnonymousUserId,
+        appScope,
+    ]);
+    const operationPathKey = useMemo(() => {
+        if (!boundOperation)
+            return null;
+        return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(boundOperation);
+    }, [boundOperation]);
+    useEffect(() => {
+        if (!operationPathKey || !resourceConfig) {
+            setInstances([]);
+            setError(null);
+            setIsLoading(false);
+            return;
+        }
+        let cancelled = false;
+        const fetchInstances = async () => {
+            setIsLoading(true);
+            setError(null);
+            try {
+                logDebug('Fetching resource instances', { resourceType, operationPathKey });
+                const result = await doOperationRef.current(operationPathKey, {
+                    contextualParameters: scopedContextIdentifiers,
+                    queryParameters: { limit: 100 },
+                });
+                if (cancelled)
+                    return;
+                const items = Array.isArray(result) ? result : result?.data ?? [];
+                setInstances(items);
+                logDebug('Fetched instances', { count: items.length });
+            }
+            catch (err) {
+                if (cancelled)
+                    return;
+                const message = err instanceof Error ? err.message : 'Failed to load';
+                setError(message);
+                logger.error('SidebarResourceBrowser fetch failed', { resourceType, error: err });
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        };
+        fetchInstances();
+        return () => { cancelled = true; };
+    }, [operationPathKey, resourceType, resourceConfig, scopedContextIdentifiers]);
+    const filteredInstances = useMemo(() => {
+        if (!instanceFilter)
+            return instances;
+        return instances.filter(instanceFilter);
+    }, [instances, instanceFilter]);
+    const handleInstanceClick = useCallback((instance) => {
+        const instanceId = (instance.id ?? instance._id ?? '');
+        if (onInstanceClick) {
+            onInstanceClick({
+                resourceType,
+                instanceId,
+                instanceData: instance,
+            });
+            return;
+        }
+        if (resourceConfig && navigationOperationResolved) {
+            const contextIdentifiers = {
+                ...scopedContextIdentifiers,
+                [resourceType]: instanceId,
+            };
+            const parentResourcesRequirements = frontendResourceUtils.buildParentResourcesRequirements(resourceType, contextIdentifiers, registry);
+            const resourceContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({
+                resourceType: resourceType,
+                operation: navigationOperationResolved,
+                contextResourceIdentifiers: contextIdentifiers,
+                parentResourcesRequirements,
+            });
+            navigateToResource(resourceContext, NavigationUtils.createAppLevelInitiator(ApplicationLevelComponentType.SIDEBAR));
+            return;
+        }
+        logger.warn('SidebarResourceBrowser navigation skipped: no navigation operation resolved', {
+            resourceType,
+            fetchOperationIdentifier: boundOperation?.operationIdentifier,
+            navigationOperationIdentifier: navigateOperation ?? CoreResourceOperation.READ,
+            navigationOperationVariant: navigateOperationVariant,
+            instanceId,
+        });
+    }, [
+        resourceType,
+        onInstanceClick,
+        resourceConfig,
+        navigationOperationResolved,
+        navigateOperation,
+        navigateOperationVariant,
+        scopedContextIdentifiers,
+        registry,
+        navigateToResource,
+        boundOperation,
+    ]);
+    const getInstanceLabel = useCallback((instance) => {
+        const labelConfig = resourceConfig?.frontendConfiguration?.getFrontendResourceLabel;
+        if (labelConfig) {
+            try {
+                if (typeof labelConfig === 'function') {
+                    return labelConfig({ currentObject: instance }) ?? String(instance.name ?? instance.title ?? instance.id ?? '');
+                }
+                if (Array.isArray(labelConfig)) {
+                    const parts = labelConfig.map(field => String(instance[field] ?? '')).filter(Boolean);
+                    if (parts.length > 0)
+                        return parts.join(' ');
+                }
+            }
+            catch {
+                // fallback
+            }
+        }
+        return String(instance.name ?? instance.title ?? instance.id ?? '');
+    }, [resourceConfig]);
+    const resourceIcon = useMemo(() => {
+        return renderIcon({ category: IconCategory.RESOURCES, resourceType }, { size: IconSize.SM });
+    }, [renderIcon, resourceType]);
+    if (!resourceConfig) {
+        return (_jsxs("div", { className: "px-card-sm py-item-xs text-xs text-destructive", children: ["Resource type \"", resourceType, "\" not found"] }));
+    }
+    if (isLoading) {
+        return (_jsx("div", { className: "px-card-sm py-item-xs space-y-item-xs", role: "status", "aria-live": "polite", children: [1, 2, 3].map(i => (_jsx("div", { className: "animate-pulse motion-reduce:animate-none h-7 bg-surface-sunken-accent rounded", "aria-hidden": "true" }, i))) }));
+    }
+    if (error) {
+        return (_jsx("div", { className: "px-card-sm py-item-xs text-xs text-destructive", children: error }));
+    }
+    if (filteredInstances.length === 0) {
+        return (_jsx("div", { className: "px-card-sm py-item-xs text-xs text-muted-foreground", children: tResourceEmptyState(resourceType, 'title') || t('common.emptyState') }));
+    }
+    if (isCollapsed) {
+        return (_jsxs("div", { className: "flex flex-col items-center gap-item-xs py-item-xs", children: [_jsx("span", { className: "flex-shrink-0", children: resourceIcon }), _jsx("span", { className: "text-[10px] text-muted-foreground", children: filteredInstances.length })] }));
+    }
+    return (_jsx("div", { className: "space-y-item-xs", role: "listbox", "aria-label": tResourceHeader(resourceType, 'title'), children: filteredInstances.map((instance, idx) => {
+            const label = getInstanceLabel(instance);
+            const instanceId = (instance.id ?? instance._id ?? idx);
+            const instanceKey = instance.id ?? instance._id ?? `sidebar-resource-${idx}`;
+            return (_jsxs("button", { type: "button", role: "option", onClick: () => handleInstanceClick(instance), className: "w-full text-start px-card-sm py-item-xs text-sm rounded-sm hover:bg-surface-sunken-accent/50 transition-colors flex items-center gap-field-sm min-h-7", children: [_jsx("span", { className: "flex-shrink-0", children: resourceIcon }), _jsx("span", { className: "truncate flex-1", children: label })] }, String(instanceKey)));
+        }) }));
+};
+//# sourceMappingURL=SidebarResourceBrowser.js.map

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

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

package/dist/esm/components/navigation/app-level/component-props.application-level.frontend.schemas.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export interface BaseApplicationLevelProps {
+    children?: React.ReactNode;
+}
+//# sourceMappingURL=component-props.application-level.frontend.schemas.d.ts.map

package/dist/esm/components/navigation/app-level/component-props.application-level.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-props.application-level.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/component-props.application-level.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B"}

package/dist/esm/components/navigation/app-level/component-props.application-level.frontend.schemas.js

@@ -0,0 +1 @@
+//# sourceMappingURL=component-props.application-level.frontend.schemas.js.map

package/dist/esm/components/navigation/app-level/component-props.application-level.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-props.application-level.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/component-props.application-level.frontend.schemas.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,9 @@
+import type { ActivityBarBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+/**
+ * Behavior hook for the Activity Bar — reads rendering config and derives
+ * layout props from the configured `ActivityBarRendering` mode.
+ *
+ * Tile size, tooltip delay, and other cosmetics stay in the preset.
+ */
+export declare function useActivityBarBehavior(): ActivityBarBehavior;
+//# sourceMappingURL=useActivityBarBehavior.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityBarBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useActivityBarBehavior.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,sDAAsD,CAAC;AA4BnH;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAiC5D"}

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

@@ -0,0 +1,59 @@
+import { useMemo } from 'react';
+import { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { ActivityBarRendering } from '../../../core/config/launcher-items.frontend.schemas.js';
+import { LayoutDirection, ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import { useUI } from '../../../core/ui/useUI.js';
+import { useAppModeSafe } from '../../../core/mode/AppModeContext.js';
+import { PlacementSide } from '@wildo-ai/presets-components-models';
+function isActivityBarConfigObject(config) {
+    return typeof config === 'object' && config !== null && !Array.isArray(config);
+}
+/**
+ * Derives layout props from the rendering mode.
+ * Centralizes the mapping so presets don't embed layout logic.
+ */
+function deriveLayout(renderingMode) {
+    switch (renderingMode) {
+        case ActivityBarRendering.VERTICAL_RAIL:
+            return { direction: LayoutDirection.VERTICAL, borderSide: PlacementSide.END, tooltipSide: PlacementSide.END, orientation: LayoutDirection.VERTICAL };
+        case ActivityBarRendering.HORIZONTAL_BAR:
+            return { direction: LayoutDirection.HORIZONTAL, borderSide: PlacementSide.BOTTOM, tooltipSide: PlacementSide.TOP, orientation: LayoutDirection.HORIZONTAL };
+        case ActivityBarRendering.BOTTOM_TAB_BAR:
+            return { direction: LayoutDirection.HORIZONTAL, borderSide: PlacementSide.TOP, tooltipSide: PlacementSide.TOP, orientation: LayoutDirection.HORIZONTAL };
+        default:
+            return { direction: LayoutDirection.VERTICAL, borderSide: PlacementSide.END, tooltipSide: PlacementSide.END, orientation: LayoutDirection.VERTICAL };
+    }
+}
+/**
+ * Behavior hook for the Activity Bar — reads rendering config and derives
+ * layout props from the configured `ActivityBarRendering` mode.
+ *
+ * Tile size, tooltip delay, and other cosmetics stay in the preset.
+ */
+export function useActivityBarBehavior() {
+    const { UIConfig, appComponentsConfiguration } = useUI();
+    const appMode = useAppModeSafe();
+    const config = appComponentsConfiguration?.[ApplicationLevelComponentType.ACTIVITY_BAR];
+    const currentBreakpoint = UIConfig?.currentBreakpoint;
+    const isMobile = currentBreakpoint === ViewportBreakpoint.MOBILE;
+    const activeRenderingMode = useMemo(() => {
+        if (!isActivityBarConfigObject(config)) {
+            return isMobile ? ActivityBarRendering.BOTTOM_TAB_BAR : ActivityBarRendering.VERTICAL_RAIL;
+        }
+        return isMobile
+            ? (config.mobileRendering ?? ActivityBarRendering.BOTTOM_TAB_BAR)
+            : (config.desktopRendering ?? ActivityBarRendering.VERTICAL_RAIL);
+    }, [config, isMobile]);
+    const layout = useMemo(() => deriveLayout(activeRenderingMode), [activeRenderingMode]);
+    const availableModes = useMemo(() => appMode?.availableModes ?? [], [appMode?.availableModes]);
+    return {
+        availableModes,
+        activeMode: appMode?.activeMode ?? null,
+        setActiveMode: appMode?.setActiveMode ?? (() => { }),
+        hasModes: appMode?.hasModes ?? false,
+        activeRenderingMode,
+        layout,
+        isNavigationLoading: !appMode,
+    };
+}
+//# sourceMappingURL=useActivityBarBehavior.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { CommandMenuBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+/**
+ * Behavior hook for CommandMenu — manages open state (controlled or
+ * uncontrolled), search, recent commands, hotkey subscription, and
+ * navigation items mapped to command menu entries.
+ */
+export declare function useCommandMenuBehavior(externalIsOpen?: boolean, onOpenChange?: (open: boolean) => void, options?: {
+    listenForHotkeys?: boolean;
+}): CommandMenuBehavior;
+//# sourceMappingURL=useCommandMenuBehavior.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandMenuBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useCommandMenuBehavior.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,mBAAmB,EAAqC,MAAM,sDAAsD,CAAC;AAoCnI;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,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,mBAAmB,CAoKrB"}

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

@@ -0,0 +1,193 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { ApplicationLevelComponentType, HotkeyGroup, HotkeyScope, } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { CommandMenuDisplayPolicy } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { FrontendEvents, } from '../../../core/events/events.frontend.schemas.js';
+import { useEventBus } from '../../../core/events/useEventBus.js';
+import { filterCommandMenuCommandsByRuntimeAvailability, useLauncherRuntimeAvailabilityContext, } from '../../../core/navigation/launcher-runtime-availability.js';
+import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
+import { resolveCommandMenuCommands } from '../../../core/navigation/launcher-resolution.js';
+import { useLauncherResolutionContext } from '../../../core/navigation/useLauncherResolutionContext.js';
+import { useNavigationController } from '../../../core/navigation/useNavigationController.js';
+import { useUI } from '../../../core/ui/useUI.js';
+import { useHotkeyRegistry } from '../../../core/hotkey/useHotkey.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { envLoader } from '../../../core/runtime/env-variable-loader.frontend.service.js';
+const DEFAULT_CATEGORY_ORDER = ['navigation', 'actions'];
+function humanizeCategory(category) {
+    return category
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[-_]/g, ' ')
+        .trim()
+        .replace(/\b\w/g, character => character.toUpperCase());
+}
+function resolveCategoryLabel(tComponent, category) {
+    const componentType = FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU;
+    const resolved = tComponent(componentType, category);
+    const baseKey = `components.${componentType}.${category}`;
+    return resolved === baseKey ? humanizeCategory(category) : resolved;
+}
+function isCommandMenuConfigObject(config) {
+    return typeof config === 'object' && config !== null && !Array.isArray(config);
+}
+/**
+ * Behavior hook for CommandMenu — manages open state (controlled or
+ * uncontrolled), search, recent commands, hotkey subscription, and
+ * navigation items mapped to command menu entries.
+ */
+export function useCommandMenuBehavior(externalIsOpen, onOpenChange, options = {}) {
+    const resolutionCtx = useLauncherResolutionContext();
+    const { navigate } = useNavigationController();
+    const { appComponentsConfiguration } = useUI();
+    const { on, emit } = useEventBus();
+    const { register } = useHotkeyRegistry();
+    const { t, tComponent } = useI18n({
+        component: FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU,
+    });
+    const commandMenuConfig = appComponentsConfiguration?.[ApplicationLevelComponentType.COMMAND_MENU];
+    const commandMenuObj = isCommandMenuConfigObject(commandMenuConfig) ? commandMenuConfig : undefined;
+    const openShortcut = commandMenuObj?.openShortcut;
+    const showRecent = commandMenuObj?.showRecent !== false;
+    const maxRecentItems = commandMenuObj?.maxRecentItems ?? 5;
+    const showShortcuts = commandMenuObj?.showShortcuts !== false;
+    const defaultCategory = commandMenuObj?.defaultCategory ?? 'navigation';
+    const categoryOrder = commandMenuObj?.categoryOrder ?? DEFAULT_CATEGORY_ORDER;
+    const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();
+    const configCommands = useMemo(() => (filterCommandMenuCommandsByRuntimeAvailability(commandMenuObj?.commands, runtimeAvailabilityContext)), [commandMenuObj?.commands, runtimeAvailabilityContext]);
+    const [internalIsOpen, setInternalIsOpen] = useState(false);
+    const [searchQuery, setSearchQuery] = useState('');
+    const [recentCommandIds, setRecentCommandIds] = useState([]);
+    const isControlled = externalIsOpen !== undefined && onOpenChange !== undefined;
+    const isOpen = isControlled ? externalIsOpen : internalIsOpen;
+    const isOpenRef = useRef(isOpen);
+    isOpenRef.current = isOpen;
+    const listenForHotkeys = options.listenForHotkeys !== false;
+    const handleOpenChange = useCallback((open) => {
+        if (isControlled && onOpenChange) {
+            onOpenChange(open);
+        }
+        else {
+            setInternalIsOpen(open);
+        }
+        if (!open) {
+            setSearchQuery('');
+        }
+    }, [isControlled, onOpenChange]);
+    useEffect(() => {
+        if (!listenForHotkeys)
+            return;
+        const unsubscribe = on(FrontendEvents.HOTKEY_COMMAND_MENU_OPEN, () => {
+            handleOpenChange(!isOpenRef.current);
+        });
+        return unsubscribe;
+    }, [on, handleOpenChange, listenForHotkeys]);
+    useEffect(() => {
+        if (!listenForHotkeys)
+            return;
+        if (!openShortcut || commandMenuConfig === false)
+            return;
+        return register({
+            id: 'app-command-menu-open-shortcut',
+            shortcut: openShortcut,
+            description: t('engine.hotkeys.commandMenuOpen'),
+            scope: HotkeyScope.GLOBAL,
+            group: HotkeyGroup.NAVIGATION,
+            launcher: ApplicationLevelComponentType.COMMAND_MENU,
+            preventDefault: true,
+            handler: () => {
+                emit(FrontendEvents.HOTKEY_COMMAND_MENU_OPEN, {});
+            },
+        });
+    }, [openShortcut, commandMenuConfig, register, emit, t, listenForHotkeys]);
+    const resolvedCommands = useMemo(() => {
+        if (!configCommands || !resolutionCtx)
+            return [];
+        return resolveCommandMenuCommands(configCommands, resolutionCtx);
+    }, [configCommands, resolutionCtx]);
+    const commandItems = useMemo(() => {
+        return resolvedCommands
+            .filter(cmd => {
+            const dp = cmd.displayPolicy;
+            if (dp === undefined || dp === CommandMenuDisplayPolicy.ALWAYS)
+                return true;
+            if (dp === CommandMenuDisplayPolicy.NEVER)
+                return false;
+            if (dp === CommandMenuDisplayPolicy.RECENT)
+                return true;
+            if (dp === CommandMenuDisplayPolicy.CONTEXTUAL) {
+                if (envLoader.isDevelopment()) {
+                    console.warn(`[CommandMenu] CONTEXTUAL displayPolicy requires a contextual source and is excluded from the global app-level menu for "${cmd.id}"`);
+                }
+                return false;
+            }
+            if (envLoader.isDevelopment()) {
+                console.warn(`[CommandMenu] Unknown displayPolicy "${dp}" for command "${cmd.id}" — treating as ALWAYS`);
+            }
+            return true;
+        })
+            .map(cmd => ({
+            id: cmd.id,
+            label: cmd.label,
+            shortcut: cmd.shortcut ?? '',
+            icon: cmd.icon ?? null,
+            category: cmd.category ?? defaultCategory,
+            keywords: cmd.searchKeywords ?? [],
+            displayPolicy: cmd.displayPolicy,
+            onExecute: () => {
+                handleOpenChange(false);
+                setRecentCommandIds(prev => {
+                    const next = [cmd.id, ...prev.filter(id => id !== cmd.id)];
+                    return next.slice(0, maxRecentItems);
+                });
+                if (cmd.urlPath) {
+                    NavigationUtils.dispatchNavigationForResolvedTarget(navigate, cmd, ApplicationLevelComponentType.COMMAND_MENU);
+                }
+            },
+        }));
+    }, [resolvedCommands, handleOpenChange, navigate, maxRecentItems, defaultCategory]);
+    const groupedItems = useMemo(() => {
+        const categoryMap = new Map();
+        for (const item of commandItems) {
+            if (item.displayPolicy === CommandMenuDisplayPolicy.RECENT)
+                continue;
+            const category = item.category;
+            const existing = categoryMap.get(category) ?? [];
+            existing.push(item);
+            categoryMap.set(category, existing);
+        }
+        for (const items of categoryMap.values()) {
+            items.sort((a, b) => a.label.localeCompare(b.label));
+        }
+        const ordered = [];
+        for (const cat of categoryOrder) {
+            const items = categoryMap.get(cat);
+            if (items) {
+                ordered.push({ category: cat, label: resolveCategoryLabel(tComponent, cat), items });
+                categoryMap.delete(cat);
+            }
+        }
+        for (const [cat, items] of categoryMap.entries()) {
+            ordered.push({ category: cat, label: resolveCategoryLabel(tComponent, cat), items });
+        }
+        return ordered;
+    }, [commandItems, categoryOrder, tComponent]);
+    const recentItems = useMemo(() => {
+        if (recentCommandIds.length === 0)
+            return [];
+        const itemById = new Map(commandItems.map(item => [item.id, item]));
+        return recentCommandIds.map(id => itemById.get(id)).filter(Boolean);
+    }, [commandItems, recentCommandIds]);
+    return {
+        isOpen,
+        handleOpenChange,
+        searchQuery,
+        setSearchQuery,
+        commandItems,
+        groupedItems,
+        recentItems,
+        isNavigationLoading: !resolutionCtx,
+        showRecent,
+        showShortcuts,
+    };
+}
+//# sourceMappingURL=useCommandMenuBehavior.js.map