@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,125 @@
+import { useEffect, useMemo, useState } from 'react';
+import { ApplicationLevelComponentType, HotkeyGroup, HotkeyScope, } 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 { useHotkeyRegistry } from '../../../core/hotkey/useHotkey.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { useUI } from '../../../core/ui/useUI.js';
+function isCommandMenuConfigObject(config) {
+    return typeof config === 'object' && config !== null && !Array.isArray(config);
+}
+/**
+ * Menubar-hosted surfaces are often lazy presets wrapped in `Suspense`.
+ * Their visual tree can therefore mount after the event that should open or
+ * focus them. This bridge keeps the interaction state alive at the host layer
+ * so the eventual component mount replays the correct open/focus state.
+ */
+export function useMenubarHostedInteractions(containerComponents) {
+    const { appComponentsConfiguration } = useUI();
+    const { on, emit } = useEventBus();
+    const { register } = useHotkeyRegistry();
+    const { t } = useI18n();
+    const [commandMenuOpen, setCommandMenuOpen] = useState(false);
+    const [notificationCenterOpen, setNotificationCenterOpen] = useState(false);
+    const [quickSwitcherFocusTrigger, setQuickSwitcherFocusTrigger] = useState(0);
+    const hostedTypes = useMemo(() => new Set(containerComponents.map(component => component.component)), [containerComponents]);
+    const interactionOwnerIds = useMemo(() => {
+        const owners = new Map();
+        const interactiveTypes = new Set([
+            ApplicationLevelComponentType.COMMAND_MENU,
+            ApplicationLevelComponentType.NOTIFICATION_CENTER,
+            ApplicationLevelComponentType.QUICK_SWITCHER,
+        ]);
+        for (const component of containerComponents) {
+            if (!interactiveTypes.has(component.component))
+                continue;
+            if (!owners.has(component.component)) {
+                owners.set(component.component, component.instanceId);
+            }
+        }
+        return owners;
+    }, [containerComponents]);
+    const hasHostedComponent = (componentType) => hostedTypes.has(componentType);
+    const commandMenuConfig = appComponentsConfiguration?.[ApplicationLevelComponentType.COMMAND_MENU];
+    const commandMenuOpenShortcut = isCommandMenuConfigObject(commandMenuConfig)
+        ? commandMenuConfig.openShortcut
+        : undefined;
+    useEffect(() => {
+        if (!hasHostedComponent(ApplicationLevelComponentType.COMMAND_MENU))
+            return;
+        return on(FrontendEvents.HOTKEY_COMMAND_MENU_OPEN, () => {
+            setCommandMenuOpen(prev => !prev);
+        });
+    }, [on, hostedTypes]);
+    useEffect(() => {
+        if (!hasHostedComponent(ApplicationLevelComponentType.NOTIFICATION_CENTER))
+            return;
+        return on(FrontendEvents.HOTKEY_NOTIFICATIONS_OPEN, () => {
+            setNotificationCenterOpen(prev => !prev);
+        });
+    }, [on, hostedTypes]);
+    useEffect(() => {
+        if (!hasHostedComponent(ApplicationLevelComponentType.QUICK_SWITCHER))
+            return;
+        return on(FrontendEvents.HOTKEY_QUICK_SWITCHER_OPEN, () => {
+            setQuickSwitcherFocusTrigger(prev => prev + 1);
+        });
+    }, [on, hostedTypes]);
+    useEffect(() => {
+        if (!hasHostedComponent(ApplicationLevelComponentType.COMMAND_MENU))
+            return;
+        if (!commandMenuOpenShortcut || commandMenuConfig === false)
+            return;
+        return register({
+            id: 'menubar-hosted-command-menu-open-shortcut',
+            shortcut: commandMenuOpenShortcut,
+            description: t('engine.hotkeys.commandMenuOpen'),
+            scope: HotkeyScope.GLOBAL,
+            group: HotkeyGroup.NAVIGATION,
+            launcher: ApplicationLevelComponentType.COMMAND_MENU,
+            preventDefault: true,
+            handler: () => {
+                emit(FrontendEvents.HOTKEY_COMMAND_MENU_OPEN, {});
+            },
+        });
+    }, [
+        commandMenuConfig,
+        commandMenuOpenShortcut,
+        emit,
+        register,
+        t,
+        hostedTypes,
+    ]);
+    const getHostedComponentProps = (componentType, instanceId) => {
+        const isInteractionOwner = interactionOwnerIds.get(componentType) === instanceId;
+        switch (componentType) {
+            case ApplicationLevelComponentType.COMMAND_MENU:
+                return {
+                    listenForHotkeys: false,
+                    ...(isInteractionOwner ? {
+                        isOpen: commandMenuOpen,
+                        onOpenChange: setCommandMenuOpen,
+                    } : {}),
+                };
+            case ApplicationLevelComponentType.NOTIFICATION_CENTER:
+                return {
+                    listenForHotkeys: false,
+                    ...(isInteractionOwner ? {
+                        isOpen: notificationCenterOpen,
+                        onOpenChange: setNotificationCenterOpen,
+                    } : {}),
+                };
+            case ApplicationLevelComponentType.QUICK_SWITCHER:
+                return {
+                    // Only the first resolved hosted quick switcher owns focus replay.
+                    focusTrigger: isInteractionOwner ? quickSwitcherFocusTrigger : 0,
+                };
+            default:
+                return {};
+        }
+    };
+    return {
+        getHostedComponentProps,
+    };
+}
+//# sourceMappingURL=useMenubarHostedInteractions.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { NavigationBehaviors } from '../../../core/app-shell/app-shell.schemas.js';
+/**
+ * Standalone navigation behavior hook — provides active-state checking,
+ * badge count tracking, display policy evaluation, click dispatch, and
+ * home navigation.
+ *
+ * This hook is completely independent of item fetching. It does not call
+ * any scan-based item discovery. Consumers provide their own items from
+ * per-launcher resolution (declared `contentSections`, `commands`, `tools`, etc.).
+ *
+ * `handleNavigationClick` requires `launcher` as a second parameter since
+ * this hook is not scoped to a single launcher.
+ */
+export declare function useNavigationBehaviors(): NavigationBehaviors;
+//# sourceMappingURL=useNavigationBehaviors.d.ts.map

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

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

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

@@ -0,0 +1,83 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useLocation, useNavigate } from 'react-router-dom';
+import { SidebarItemDisplayPolicy, } 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 { EnginePageRef, ENGINE_PAGE_ROUTES, } from '../../../core/config/launcher-items.frontend.schemas.js';
+import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
+import { navigateHomeWithFreshStart } from '../../../core/navigation/navigation-clean-break.frontend.utils.js';
+import { useNavigationController } from '../../../core/navigation/useNavigationController.js';
+import { useNavigationState } from '../../../core/navigation/useNavigationState.js';
+/**
+ * Standalone navigation behavior hook — provides active-state checking,
+ * badge count tracking, display policy evaluation, click dispatch, and
+ * home navigation.
+ *
+ * This hook is completely independent of item fetching. It does not call
+ * any scan-based item discovery. Consumers provide their own items from
+ * per-launcher resolution (declared `contentSections`, `commands`, `tools`, etc.).
+ *
+ * `handleNavigationClick` requires `launcher` as a second parameter since
+ * this hook is not scoped to a single launcher.
+ */
+export function useNavigationBehaviors() {
+    const routerNavigate = useNavigate();
+    const location = useLocation();
+    const homePath = ENGINE_PAGE_ROUTES[EnginePageRef.HOME];
+    const { navigate } = useNavigationController();
+    const { isNavigationItemActive } = useNavigationState();
+    const { on, emit } = useEventBus();
+    const [badgeCounts, setBadgeCounts] = useState({});
+    useEffect(() => {
+        const unsubscribe = on(FrontendEvents.BADGE_COUNT_CHANGED, (event) => {
+            setBadgeCounts(prev => ({
+                ...prev,
+                [event.badgeReference]: event.badgeCount,
+            }));
+        });
+        return unsubscribe;
+    }, [on]);
+    const shouldShowItem = useCallback((item) => {
+        const policy = item.displayPolicy ?? SidebarItemDisplayPolicy.ALWAYS;
+        switch (policy) {
+            case SidebarItemDisplayPolicy.ALWAYS:
+                return 'visible';
+            case SidebarItemDisplayPolicy.WHEN_BADGE: {
+                const badgeCount = item.badgeReference ? badgeCounts[item.badgeReference] ?? 0 : 0;
+                return badgeCount > 0 ? 'visible' : 'hidden';
+            }
+            case SidebarItemDisplayPolicy.SECTION_MORE_MENU:
+                return 'more_menu';
+            default:
+                return 'visible';
+        }
+    }, [badgeCounts]);
+    const handleNavigationClick = useCallback((item, launcher) => {
+        NavigationUtils.dispatchNavigationForItem(navigate, item, launcher);
+    }, [navigate]);
+    /**
+     * Home navigation — clears all panes and navigates to the engine home route
+     * (`ENGINE_PAGE_ROUTES[EnginePageRef.HOME]`). Wrapped in a NavigationTransaction
+     * to prevent useRouterSync from re-populating stale content during the transition.
+     */
+    const handleHomeClick = useCallback(() => {
+        navigateHomeWithFreshStart({
+            emit,
+            routerNavigate,
+            homePath,
+        });
+    }, [emit, routerNavigate, homePath]);
+    const isHomeActive = useMemo(() => {
+        const p = location.pathname;
+        return p === homePath || (homePath === '/' && p === '');
+    }, [location.pathname, homePath]);
+    return {
+        isNavigationItemActive,
+        badgeCounts,
+        shouldShowItem,
+        handleNavigationClick,
+        handleHomeClick,
+        isHomeActive,
+    };
+}
+//# sourceMappingURL=useNavigationBehaviors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationBehaviors.js","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useNavigationBehaviors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAEL,wBAAwB,GACzB,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAuC,MAAM,yDAAyD,CAAC;AAC9H,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EACL,aAAa,EACb,kBAAkB,GACnB,MAAM,iEAAiE,CAAC;AAKzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2EAA2E,CAAC;AACvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAI5F;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,cAAc,GAAG,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAC/C,MAAM,EAAE,sBAAsB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACxD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAEnC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAyB,EAAE,CAAC,CAAC;IAE3E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,EAAE,CAAC,cAAc,CAAC,mBAAmB,EAAE,CAAC,KAAqC,EAAE,EAAE;YACnG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtB,GAAG,IAAI;gBACP,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,UAAU;aACzC,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAET,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,IAAuB,EAAsC,EAAE;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,wBAAwB,CAAC,MAAM,CAAC;QACrE,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,wBAAwB,CAAC,MAAM;gBAClC,OAAO,SAAS,CAAC;YACnB,KAAK,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC;gBACzC,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnF,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/C,CAAC;YACD,KAAK,wBAAwB,CAAC,iBAAiB;gBAC7C,OAAO,WAAW,CAAC;YACrB;gBACE,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,IAAuB,EAAE,QAAuC,EAAE,EAAE;QACnE,eAAe,CAAC,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF;;;;OAIG;IACH,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,0BAA0B,CAAC;YACzB,IAAI;YACJ,cAAc;YACd,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC5B,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElC,OAAO;QACL,sBAAsB;QACtB,WAAW;QACX,cAAc;QACd,qBAAqB;QACrB,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { ApplicationLevelComponentType } from '../../../core/config/app-level-components.frontend.schemas.js';
+import type { NavigationItemBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+/**
+ * Shared navigation-item behavior hook — thin wrapper that composes
+ * `useNavigationBehaviors()` (behavioral utilities) with
+ * `useLauncherAutoItems(launcher)` (item discovery).
+ *
+ * Used by preset components (toolbar, quick-action-button)
+ * that still rely on scan-based item discovery. Framework-level hooks
+ * (sidebar, command menu, control panel, hotkeys) use `useNavigationBehaviors()`
+ * directly with per-launcher resolution for items.
+ *
+ * @deprecated Preset components should migrate to per-launcher content
+ * declarations (`tools[]`, `actions[]`, etc.) and use
+ * `useNavigationBehaviors()` directly. This hook will be removed when all
+ * presets complete content declaration migration (Macro B Step 8).
+ */
+export declare function useNavigationItemBehavior(launcher: ApplicationLevelComponentType): NavigationItemBehavior;
+//# sourceMappingURL=useNavigationItemBehavior.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationItemBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useNavigationItemBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AAG3H,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAGnG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,sBAAsB,CAqBzG"}

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

@@ -0,0 +1,36 @@
+import { useCallback } from 'react';
+import { useLauncherAutoItems } from '../../../core/navigation/useLauncherAutoItems.js';
+import { useNavigationBehaviors } from './useNavigationBehaviors.js';
+/**
+ * Shared navigation-item behavior hook — thin wrapper that composes
+ * `useNavigationBehaviors()` (behavioral utilities) with
+ * `useLauncherAutoItems(launcher)` (item discovery).
+ *
+ * Used by preset components (toolbar, quick-action-button)
+ * that still rely on scan-based item discovery. Framework-level hooks
+ * (sidebar, command menu, control panel, hotkeys) use `useNavigationBehaviors()`
+ * directly with per-launcher resolution for items.
+ *
+ * @deprecated Preset components should migrate to per-launcher content
+ * declarations (`tools[]`, `actions[]`, etc.) and use
+ * `useNavigationBehaviors()` directly. This hook will be removed when all
+ * presets complete content declaration migration (Macro B Step 8).
+ */
+export function useNavigationItemBehavior(launcher) {
+    const behaviors = useNavigationBehaviors();
+    const { items, isLoading } = useLauncherAutoItems(launcher);
+    const handleNavigationClick = useCallback((item) => {
+        behaviors.handleNavigationClick(item, launcher);
+    }, [behaviors.handleNavigationClick, launcher]);
+    return {
+        navigationItems: items,
+        isNavigationLoading: isLoading,
+        isNavigationItemActive: behaviors.isNavigationItemActive,
+        badgeCounts: behaviors.badgeCounts,
+        shouldShowItem: behaviors.shouldShowItem,
+        handleNavigationClick,
+        handleHomeClick: behaviors.handleHomeClick,
+        isHomeActive: behaviors.isHomeActive,
+    };
+}
+//# sourceMappingURL=useNavigationItemBehavior.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationItemBehavior.js","sourceRoot":"","sources":["../../../../../src/components/navigation/app-level/useNavigationItemBehavior.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAGhG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAuC;IAC/E,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;IAC3C,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAE5D,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,IAAoE,EAAE,EAAE;QACvE,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,EACD,CAAC,SAAS,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAC5C,CAAC;IAEF,OAAO;QACL,eAAe,EAAE,KAAK;QACtB,mBAAmB,EAAE,SAAS;QAC9B,sBAAsB,EAAE,SAAS,CAAC,sBAAsB;QACxD,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,qBAAqB;QACrB,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,YAAY,EAAE,SAAS,CAAC,YAAY;KACrC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { NotificationCenterBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+/**
+ * Behavior hook for NotificationCenter — manages open state, filter,
+ * notification CRUD operations, time-based grouping, and hotkey subscription.
+ */
+export declare function useNotificationCenterBehavior(externalIsOpen?: boolean, onOpenChange?: (open: boolean) => void, options?: {
+    listenForHotkeys?: boolean;
+}): NotificationCenterBehavior;
+//# sourceMappingURL=useNotificationCenterBehavior.d.ts.map

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

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

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

@@ -0,0 +1,172 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { FrontendEvents } from '../../../core/events/events.frontend.schemas.js';
+import { useEventBus } from '../../../core/events/useEventBus.js';
+import { useNotification } from '../../../core/events/useNotification.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { NotificationCenterFilter } from '../../../core/app-shell/app-shell.schemas.js';
+function resolveComponentLabel(tComponent, key, fallback, params) {
+    const componentType = FrontendComponentType.APPLICATION_LEVEL_NOTIFICATION_CENTER;
+    const resolved = tComponent(componentType, key, params);
+    const baseKey = `components.${componentType}.${key}`;
+    return resolved === baseKey ? fallback : resolved;
+}
+function humanizeIdentifier(identifier) {
+    return identifier
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[-_]/g, ' ')
+        .trim();
+}
+function formatRelativeTime(timestamp, currentTime, tComponent, formatDate) {
+    const diff = currentTime - timestamp;
+    const minutes = Math.floor(diff / 60000);
+    const hours = Math.floor(diff / 3600000);
+    const days = Math.floor(diff / 86400000);
+    if (minutes < 1) {
+        return resolveComponentLabel(tComponent, 'timeJustNow', 'Just now');
+    }
+    if (minutes < 60) {
+        return resolveComponentLabel(tComponent, 'timeMinutesAgo', `${minutes}m ago`, { count: minutes });
+    }
+    if (hours < 24) {
+        return resolveComponentLabel(tComponent, 'timeHoursAgo', `${hours}h ago`, { count: hours });
+    }
+    if (days < 7) {
+        return resolveComponentLabel(tComponent, 'timeDaysAgo', `${days}d ago`, { count: days });
+    }
+    return formatDate(timestamp);
+}
+function getNotificationTypeIconReference(type) {
+    switch (type) {
+        case 'success':
+            return StandardIconReference.CHECK_CIRCLE;
+        case 'warning':
+            return StandardIconReference.WARNING;
+        case 'error':
+            return StandardIconReference.X_CIRCLE;
+        case 'info':
+        default:
+            return StandardIconReference.INFO;
+    }
+}
+/**
+ * Behavior hook for NotificationCenter — manages open state, filter,
+ * notification CRUD operations, time-based grouping, and hotkey subscription.
+ */
+export function useNotificationCenterBehavior(externalIsOpen, onOpenChange, options = {}) {
+    const { notifications, unreadCount, markAsRead, markAllAsRead, clearAll, removeNotification, } = useNotification();
+    const { on } = useEventBus();
+    const { tComponent, formatDate } = useI18n({
+        component: FrontendComponentType.APPLICATION_LEVEL_NOTIFICATION_CENTER,
+    });
+    const [internalIsOpen, setInternalIsOpen] = useState(false);
+    const [filter, setFilter] = useState(NotificationCenterFilter.ALL);
+    const [currentTime, setCurrentTime] = useState(() => Date.now());
+    const listenForHotkeys = options.listenForHotkeys !== false;
+    const isControlled = externalIsOpen !== undefined && onOpenChange !== undefined;
+    const isOpen = isControlled ? externalIsOpen : internalIsOpen;
+    const isOpenRef = useRef(isOpen);
+    isOpenRef.current = isOpen;
+    const setIsOpen = useCallback((open) => {
+        if (isControlled && onOpenChange) {
+            onOpenChange(open);
+            return;
+        }
+        setInternalIsOpen(open);
+    }, [isControlled, onOpenChange]);
+    useEffect(() => {
+        if (!listenForHotkeys)
+            return;
+        const unsubscribe = on(FrontendEvents.HOTKEY_NOTIFICATIONS_OPEN, () => {
+            setIsOpen(!isOpenRef.current);
+        });
+        return unsubscribe;
+    }, [on, listenForHotkeys, setIsOpen]);
+    useEffect(() => {
+        const intervalId = globalThis.setInterval(() => {
+            setCurrentTime(Date.now());
+        }, 60000);
+        return () => globalThis.clearInterval(intervalId);
+    }, []);
+    const filteredNotifications = useMemo(() => {
+        const sourceNotifications = filter === NotificationCenterFilter.UNREAD
+            ? notifications.filter(n => !n.isRead)
+            : notifications;
+        return sourceNotifications.map(notification => {
+            let displayTitle = '';
+            let displayMessage = notification.message;
+            if (notification.source === 'resource' && notification.resourceContext) {
+                displayTitle = resolveComponentLabel(tComponent, 'resourceNotificationTitle', humanizeIdentifier(notification.resourceContext.resourceType), { resourceType: notification.resourceContext.resourceType });
+                if (!displayMessage) {
+                    displayMessage = resolveComponentLabel(tComponent, 'resourceNotificationMessage', humanizeIdentifier(notification.resourceContext.operationIdentifier), { operation: notification.resourceContext.operationIdentifier });
+                }
+            }
+            else if (notification.source === 'custom' && notification.identifier) {
+                displayTitle = '';
+            }
+            if (!displayTitle && displayMessage) {
+                displayTitle = displayMessage;
+                displayMessage = '';
+            }
+            if (!displayTitle && notification.identifier) {
+                displayTitle = humanizeIdentifier(notification.identifier);
+            }
+            if (!displayTitle) {
+                displayTitle = resolveComponentLabel(tComponent, 'title', 'Notification');
+            }
+            return {
+                id: notification.id,
+                type: notification.type,
+                source: notification.source,
+                timestamp: notification.timestamp,
+                isRead: notification.isRead,
+                displayTitle,
+                displayMessage,
+                relativeTimeLabel: formatRelativeTime(notification.timestamp, currentTime, tComponent, formatDate),
+                iconReference: getNotificationTypeIconReference(notification.type),
+                nextStep: notification.nextStep,
+            };
+        });
+    }, [notifications, filter, tComponent, currentTime, formatDate]);
+    const groupedNotifications = useMemo(() => {
+        const today = [];
+        const yesterday = [];
+        const older = [];
+        const todayStart = new Date().setHours(0, 0, 0, 0);
+        const yesterdayStart = todayStart - 86400000;
+        for (const notification of filteredNotifications) {
+            if (notification.timestamp >= todayStart) {
+                today.push(notification);
+            }
+            else if (notification.timestamp >= yesterdayStart) {
+                yesterday.push(notification);
+            }
+            else {
+                older.push(notification);
+            }
+        }
+        return { today, yesterday, older };
+    }, [filteredNotifications]);
+    const handleNotificationClick = useCallback((notification) => {
+        markAsRead(notification.id);
+    }, [markAsRead]);
+    const dismissNotification = useCallback((notificationId) => {
+        removeNotification(notificationId);
+    }, [removeNotification]);
+    return {
+        isOpen,
+        setIsOpen,
+        filter,
+        setFilter,
+        unreadCount,
+        filteredNotifications,
+        groupedNotifications,
+        notificationCount: notifications.length,
+        handleNotificationClick,
+        handleMarkAllAsRead: markAllAsRead,
+        handleClearAll: clearAll,
+        dismissNotification,
+    };
+}
+//# sourceMappingURL=useNotificationCenterBehavior.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { QuickActionButtonBehavior } from '../../../core/app-shell/app-shell.schemas.js';
+/**
+ * Behavior hook for the Quick Action Button — reads config, resolves actions,
+ * splits primary vs menu actions, and manages popover open state.
+ */
+export declare function useQuickActionButtonBehavior(): QuickActionButtonBehavior;
+//# sourceMappingURL=useQuickActionButtonBehavior.d.ts.map

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

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

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

@@ -0,0 +1,60 @@
+import { useCallback, useMemo, useState } from 'react';
+import { ApplicationLevelComponentType, QuickActionDisplayPolicy, } from '../../../core/config/app-level-components.frontend.schemas.js';
+import { filterQuickActionItemsByRuntimeAvailability, useLauncherRuntimeAvailabilityContext, } from '../../../core/navigation/launcher-runtime-availability.js';
+import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
+import { resolveQuickActions } 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';
+function isQABConfigObject(config) {
+    return typeof config === 'object' && config !== null && !Array.isArray(config);
+}
+/**
+ * Behavior hook for the Quick Action Button — reads config, resolves actions,
+ * splits primary vs menu actions, and manages popover open state.
+ */
+export function useQuickActionButtonBehavior() {
+    const { UIConfig, appComponentsConfiguration } = useUI();
+    const resolutionCtx = useLauncherResolutionContext();
+    const { navigate } = useNavigationController();
+    const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();
+    const config = appComponentsConfiguration?.[ApplicationLevelComponentType.QUICK_ACTION_BUTTON];
+    const configObj = isQABConfigObject(config) ? config : undefined;
+    const configActions = useMemo(() => (filterQuickActionItemsByRuntimeAvailability(configObj?.actions, runtimeAvailabilityContext)), [configObj?.actions, runtimeAvailabilityContext]);
+    const resolvedActions = useMemo(() => {
+        if (!configActions?.length || !resolutionCtx)
+            return [];
+        return resolveQuickActions(configActions, resolutionCtx);
+    }, [configActions, resolutionCtx]);
+    const allItems = useMemo(() => {
+        return resolvedActions.map(item => ({
+            id: item.id,
+            label: item.label,
+            icon: item.icon,
+            displayPolicy: item.displayPolicy,
+            onClick: () => NavigationUtils.dispatchNavigationForResolvedTarget(navigate, item, ApplicationLevelComponentType.QUICK_ACTION_BUTTON),
+        }));
+    }, [resolvedActions, navigate]);
+    const { primaryAction, menuActions } = useMemo(() => {
+        const primary = allItems.find(i => i.displayPolicy === QuickActionDisplayPolicy.PRIMARY) ?? null;
+        const menu = allItems.filter(i => i.displayPolicy !== QuickActionDisplayPolicy.PRIMARY);
+        return { primaryAction: primary, menuActions: menu };
+    }, [allItems]);
+    const [isOpen, setIsOpen] = useState(false);
+    const handleActionClick = useCallback((item) => {
+        setIsOpen(false);
+        item.onClick();
+    }, []);
+    return {
+        allItems,
+        primaryAction,
+        menuActions,
+        isOpen,
+        setIsOpen,
+        handleActionClick,
+        hasActions: Boolean(configActions?.length),
+        isNavigationLoading: Boolean(configActions?.length) && resolutionCtx === null,
+        currentBreakpoint: UIConfig?.currentBreakpoint,
+    };
+}
+//# sourceMappingURL=useQuickActionButtonBehavior.js.map

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

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

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

@@ -0,0 +1,22 @@
+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';
+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;
+/**
+ * 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 declare function useQuickSwitcherBehavior(options?: UseQuickSwitcherBehaviorOptions): QuickSwitcherBehavior;
+//# sourceMappingURL=useQuickSwitcherBehavior.d.ts.map

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

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