@burdenoff/fe-libs 2026.510.126

package/dist/shared/help/HelpProvider.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+import { HelpContext, HelpContent, HelpTour, SupportTicket } from './types';
+declare const HelpContext: import('react').Context<HelpContext | null>;
+export interface HelpProviderProps {
+    children: ReactNode;
+    /** Callback when support ticket is submitted */
+    onSubmitTicket?: (ticket: SupportTicket) => Promise<void>;
+    /** Default articles to include */
+    defaultArticles?: HelpContent["articles"];
+    /** Default tours to include */
+    defaultTours?: HelpContent["tours"];
+}
+/**
+ * HelpProvider component
+ *
+ * @example
+ * ```tsx
+ * <HelpProvider onSubmitTicket={async (ticket) => { ... }}>
+ *   <App />
+ * </HelpProvider>
+ * ```
+ */
+export declare function HelpProvider({ children, onSubmitTicket, defaultArticles, defaultTours, }: HelpProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access help context
+ */
+export declare function useHelp(): HelpContext;
+/**
+ * Hook to get all articles (with optional filtering)
+ */
+export declare function useHelpArticles(options?: {
+    category?: string;
+    search?: string;
+}): import('./types').HelpArticle[];
+/**
+ * Hook to get all tours (with optional context filtering)
+ */
+export declare function useHelpTours(contextId?: string): HelpTour[];
+export {};
+//# sourceMappingURL=HelpProvider.d.ts.map

package/dist/shared/help/HelpProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpProvider.d.ts","sourceRoot":"","sources":["../../../src/shared/help/HelpProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,WAAW,EAGX,WAAW,EACX,QAAQ,EACR,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,WAAW,6CAA0C,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kCAAkC;IAClC,eAAe,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC1C,+BAA+B;IAC/B,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,cAAc,EACd,eAAoB,EACpB,YAAiB,GAClB,EAAE,iBAAiB,2CA8LnB;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,WAAW,CAMrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,mCA+BA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,cAkB9C"}

package/dist/shared/help/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Help Framework
+ *
+ * Contextual help system for microfrontend applications.
+ *
+ * Features:
+ * - Help panel with docs, tours, and support tabs
+ * - Guided tours system
+ * - Context-aware content (microfrontends can register their help content)
+ * - Search functionality
+ * - Support ticket creation
+ *
+ * @example
+ * ```tsx
+ * // In your app's root
+ * import { HelpProvider, HelpPanel, HelpButton } from '@burdenoff/fe-libs/shared/help';
+ *
+ * function App() {
+ *   return (
+ *     <HelpProvider onSubmitTicket={handleTicket}>
+ *       <Header>
+ *         <HelpButton />
+ *       </Header>
+ *       <Routes>...</Routes>
+ *       <HelpPanel />
+ *     </HelpProvider>
+ *   );
+ * }
+ *
+ * // In a microfrontend
+ * import { useHelp } from '@burdenoff/fe-libs/shared/help';
+ *
+ * function MyMicrofrontend() {
+ *   const { registerHelpContent } = useHelp();
+ *
+ *   useEffect(() => {
+ *     registerHelpContent({
+ *       contextId: 'my-mfe',
+ *       articles: [...],
+ *       tours: [...],
+ *     });
+ *   }, []);
+ * }
+ * ```
+ */
+export { HelpProvider, useHelp, useHelpArticles, useHelpTours, } from './HelpProvider';
+export { HelpButton } from './HelpButton';
+export { HelpPanel } from './HelpPanel';
+export type { HelpArticle, HelpTour, TourStep, SupportTicket, HelpContent, HelpTab, HelpContext, HelpContextState, HelpContextActions, } from './types';
+export type { HelpProviderProps } from './HelpProvider';
+export type { HelpButtonProps } from './HelpButton';
+export type { HelpPanelProps } from './HelpPanel';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/help/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/help/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EACL,YAAY,EACZ,OAAO,EACP,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,YAAY,EACV,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,WAAW,EACX,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/shared/help/types.d.ts

@@ -0,0 +1,159 @@
+import { FC } from 'react';
+/**
+ * A help article/documentation item
+ */
+export interface HelpArticle {
+    /** Unique identifier */
+    id: string;
+    /** Article title */
+    title: string;
+    /** Short description */
+    description?: string;
+    /** Full content (markdown supported) */
+    content?: string;
+    /** Category for grouping */
+    category: string;
+    /** Tags for search */
+    tags: string[];
+    /** External URL if hosted elsewhere */
+    url?: string;
+    /** Icon for display */
+    icon?: FC<{
+        className?: string;
+    }>;
+    /** Order within category */
+    order?: number;
+}
+/**
+ * A step in a guided tour
+ */
+export interface TourStep {
+    /** Unique step identifier */
+    id: string;
+    /** Step title */
+    title: string;
+    /** Step description/content */
+    content: string;
+    /** CSS selector for the target element */
+    targetSelector?: string;
+    /** Position of the popover */
+    position?: "top" | "bottom" | "left" | "right";
+    /** Action to perform when step is shown */
+    onShow?: () => void;
+    /** Action to perform when moving to next step */
+    onNext?: () => void;
+}
+/**
+ * A guided tour
+ */
+export interface HelpTour {
+    /** Unique tour identifier */
+    id: string;
+    /** Tour name */
+    name: string;
+    /** Tour description */
+    description?: string;
+    /** Steps in the tour */
+    steps: TourStep[];
+    /** Context where this tour is relevant (e.g., microfrontend name) */
+    context?: string;
+    /** Whether tour auto-starts for new users */
+    autoStart?: boolean;
+}
+/**
+ * Support ticket creation data
+ */
+export interface SupportTicket {
+    /** Ticket subject */
+    subject: string;
+    /** Ticket description */
+    description: string;
+    /** Priority level */
+    priority: "low" | "medium" | "high" | "urgent";
+    /** Category */
+    category: string;
+    /** Attachments (file URLs) */
+    attachments?: string[];
+    /** Current page URL */
+    pageUrl?: string;
+    /** Browser info */
+    browserInfo?: string;
+}
+/**
+ * Help content registration from microfrontends
+ */
+export interface HelpContent {
+    /** Context identifier (usually microfrontend name) */
+    contextId: string;
+    /** Articles specific to this context */
+    articles?: HelpArticle[];
+    /** Tours specific to this context */
+    tours?: HelpTour[];
+    /** Quick links */
+    quickLinks?: Array<{
+        label: string;
+        url: string;
+        icon?: FC<{
+            className?: string;
+        }>;
+    }>;
+}
+/**
+ * Help panel tab types
+ */
+export type HelpTab = "docs" | "tours" | "support";
+/**
+ * Help context state
+ */
+export interface HelpContextState {
+    /** Whether help panel is open */
+    isOpen: boolean;
+    /** Currently active tab */
+    activeTab: HelpTab;
+    /** Current context (e.g., active microfrontend) */
+    currentContext?: string;
+    /** Search query */
+    searchQuery: string;
+    /** Registered help content from all microfrontends */
+    registeredContent: Map<string, HelpContent>;
+    /** Active tour (if any) */
+    activeTour?: HelpTour;
+    /** Current step in active tour */
+    activeTourStep?: number;
+}
+/**
+ * Help context actions
+ */
+export interface HelpContextActions {
+    /** Open help panel */
+    openHelp: () => void;
+    /** Close help panel */
+    closeHelp: () => void;
+    /** Toggle help panel */
+    toggleHelp: () => void;
+    /** Set active tab */
+    setActiveTab: (tab: HelpTab) => void;
+    /** Set search query */
+    setSearchQuery: (query: string) => void;
+    /** Set current context */
+    setCurrentContext: (context: string) => void;
+    /** Register help content */
+    registerHelpContent: (content: HelpContent) => void;
+    /** Unregister help content */
+    unregisterHelpContent: (contextId: string) => void;
+    /** Start a tour */
+    startTour: (tourId: string) => void;
+    /** End current tour */
+    endTour: () => void;
+    /** Go to next tour step */
+    nextTourStep: () => void;
+    /** Go to previous tour step */
+    prevTourStep: () => void;
+    /** Submit support ticket */
+    submitTicket: (ticket: SupportTicket) => Promise<void>;
+}
+/**
+ * Complete help context
+ */
+export type HelpContext = HelpContextState & HelpContextActions;
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/help/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/help/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/hooks/index.d.ts

@@ -0,0 +1,30 @@
+import { default as React } from 'react';
+import { MicrofrontendRootProps } from '../types';
+/**
+ * Context for microfrontend configuration
+ */
+export declare const MicrofrontendContext: React.Context<MicrofrontendRootProps | null>;
+/**
+ * Hook to access microfrontend context
+ */
+export declare function useMicrofrontendContext(): MicrofrontendRootProps;
+export { useDebounce } from './useDebounce';
+export { useThrottle } from './useThrottle';
+export { useMediaQuery } from './useMediaQuery';
+export { useBreakpoint, useMobileBreakpoint, BREAKPOINTS, type Breakpoint, } from './useBreakpoint';
+export { useOnClickOutside, useOnClickOutsideWithRef, } from './useOnClickOutside';
+export { useKeyPress, useKeyboardShortcut } from './useKeyPress';
+export { useCopyToClipboard } from './useCopyToClipboard';
+export { useLocalStorage } from './useLocalStorage';
+export { useSessionStorage } from './useSessionStorage';
+export { usePrevious, usePreviousDistinct, usePreviousHistory, } from './usePrevious';
+export { useToggle, useToggleObject, useConditionalToggle } from './useToggle';
+export { useAsync, useAsyncImmediate, type UseAsyncReturn } from './useAsync';
+export * from '../keyboard';
+export * from '../logger';
+export { usePWA } from './usePWA';
+export { useHasAnimated } from './useHasAnimated';
+export { useReferralAttribution } from './useReferralAttribution';
+export { useQuotaErrorToast, dispatchQuotaExhausted, QUOTA_EXHAUSTED_EVENT, } from './useQuotaErrorToast';
+export type { UseQuotaErrorToastOptions, QuotaExhaustedEventDetail, } from './useQuotaErrorToast';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,8CACyB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,uBAAuB,2BAQtC;AAOD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG/E,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9E,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/shared/hooks/shell/index.d.ts

@@ -0,0 +1,22 @@
+export { useNavRegistryStore } from './useNavRegistry';
+export type { NavItem } from './useNavRegistry';
+export { useFooterRegistryStore } from './useFooterRegistry';
+export type { FooterItem, FooterSection } from './useFooterRegistry';
+export { useGlobalSearch } from './useGlobalSearch';
+export type { UseGlobalSearchReturn, SearchFilters, MetadataCondition, DateRange, SearchSortBy, } from './useGlobalSearch';
+export type { User, MicrofrontendRootProps, NavItem as NavItemType, FooterItem as FooterItemType, FooterSection as FooterSectionType, } from '../../types';
+export { useAuth } from '../../providers/shell/AuthProvider';
+export { useActiveContext } from '../../providers/shell/ActiveContextProvider';
+export { useTheme } from '../../providers/shell/ThemeProvider';
+export { useI18n } from '../../providers/shell/I18nProvider';
+export { useGeography } from '../../geography/GeographyProvider';
+export { useFeatureFlags } from '../../feature-flags/FeatureFlagProvider';
+export { useGlobalUi } from '../../providers/shell/GlobalUiProvider';
+export { useShellUi } from '../../providers/shell/ShellUiProvider';
+export { useContextManager } from '../../providers/shell/ContextManagerProvider';
+export type { ContextManagerValue } from '../../providers/shell/ContextManagerProvider';
+export { useProducts } from './useProducts';
+export type { Product, UseProductsReturn } from './useProducts';
+export { useLanguages } from './useLanguages';
+export type { Language, UseLanguagesReturn } from './useLanguages';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/hooks/shell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,IAAI,EACJ,sBAAsB,EACtB,OAAO,IAAI,WAAW,EACtB,UAAU,IAAI,cAAc,EAC5B,aAAa,IAAI,iBAAiB,GACnC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAGxF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shared/hooks/shell/useBreadcrumbs.d.ts

@@ -0,0 +1,50 @@
+import { BreadcrumbItem } from '../../providers/shell/ShellUiProvider';
+type Breadcrumb = BreadcrumbItem;
+/**
+ * useBreadcrumbs Hook
+ *
+ * Convenience hook for managing breadcrumb navigation.
+ * Automatically sets breadcrumbs when component mounts and clears when unmounts.
+ *
+ * Usage:
+ * ```tsx
+ * function AgentsPage() {
+ *   useBreadcrumbs([
+ *     { label: 'VibeControls', path: '/' },
+ *     { label: 'Agents' },
+ *   ]);
+ *
+ *   return <div>Agents Page</div>;
+ * }
+ * ```
+ *
+ * Dynamic updates:
+ * ```tsx
+ * function AgentDetailsPage({ agentId }) {
+ *   const agent = useAgent(agentId);
+ *   const { updateBreadcrumbs } = useBreadcrumbs([
+ *     { label: 'VibeControls', path: '/' },
+ *     { label: 'Agents', path: '/agents' },
+ *     { label: agent?.name || 'Loading...' },
+ *   ]);
+ *
+ *   // Update when agent loads
+ *   useEffect(() => {
+ *     if (agent) {
+ *       updateBreadcrumbs([
+ *         { label: 'VibeControls', path: '/' },
+ *         { label: 'Agents', path: '/agents' },
+ *         { label: agent.name },
+ *       ]);
+ *     }
+ *   }, [agent]);
+ *
+ *   return <div>Agent Details</div>;
+ * }
+ * ```
+ */
+export declare function useBreadcrumbs(breadcrumbs: Breadcrumb[]): {
+    updateBreadcrumbs: (newBreadcrumbs: Breadcrumb[]) => void;
+};
+export {};
+//# sourceMappingURL=useBreadcrumbs.d.ts.map

package/dist/shared/hooks/shell/useBreadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreadcrumbs.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useBreadcrumbs.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAE/C,KAAK,UAAU,GAAG,cAAc,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE;wCAcX,UAAU,EAAE;EAKxD"}

package/dist/shared/hooks/shell/useFooterRegistry.d.ts

@@ -0,0 +1,23 @@
+export interface FooterItem {
+    id: string;
+    label: string;
+    icon?: string;
+    onClick?: () => void;
+    type?: "status" | "action" | "info";
+    order?: number;
+    badge?: string;
+    section?: "left" | "center" | "right";
+    visible?: boolean;
+    /** Plugin that registered this item. Set automatically by the plugin runtime. */
+    pluginId?: string;
+}
+export type FooterSection = "left" | "center" | "right";
+interface FooterRegistryStore {
+    items: FooterItem[];
+    register: (section: FooterSection, item: FooterItem) => void;
+    unregister: (id: string) => void;
+    clear: () => void;
+}
+export declare const useFooterRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<FooterRegistryStore>>;
+export {};
+//# sourceMappingURL=useFooterRegistry.d.ts.map

package/dist/shared/hooks/shell/useFooterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFooterRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useFooterRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,sBAAsB,kFAiBhC,CAAC"}

package/dist/shared/hooks/shell/useFooterRegistry.js

@@ -0,0 +1,16 @@
+import { create as e } from "zustand";
+//#region src/shared/hooks/shell/useFooterRegistry.ts
+var t = e((e) => ({
+	items: [],
+	register: (t, n) => e((e) => {
+		let r = {
+			...n,
+			section: t
+		};
+		return { items: [...e.items.filter((e) => e.id !== n.id), r].sort((e, t) => (e.order || 0) - (t.order || 0)) };
+	}),
+	unregister: (t) => e((e) => ({ items: e.items.filter((e) => e.id !== t) })),
+	clear: () => e({ items: [] })
+}));
+//#endregion
+export { t as useFooterRegistryStore };

package/dist/shared/hooks/shell/useGlobalSearch.d.ts

@@ -0,0 +1,103 @@
+import { SearchResult, SearchResponse } from '../../types';
+export type MetadataOperator = "EQUALS" | "NOT_EQUALS" | "CONTAINS" | "STARTS_WITH";
+/** Metadata condition for filtering search results */
+export interface MetadataCondition {
+    key: string;
+    value: string;
+    operator?: MetadataOperator;
+}
+/** Tag filter for graph-backed search. */
+export interface TagFilter {
+    tagIds?: string[];
+    tagKeys?: string[];
+    hierarchyPaths?: string[];
+    vocabularyKeys?: string[];
+    matchAll?: boolean;
+    includeDescendants?: boolean;
+    depth?: number;
+}
+/** Date range for filtering */
+export interface DateRange {
+    from?: string;
+    to?: string;
+}
+/** Search matching mode */
+export type SearchMode = "PARTIAL" | "FULLTEXT" | "EXACT";
+/** Sort options for search results */
+export type SearchSortBy = "SCORE_DESC" | "SCORE_ASC" | "CREATED_DESC" | "CREATED_ASC" | "UPDATED_DESC" | "UPDATED_ASC" | "TITLE_ASC" | "TITLE_DESC";
+/** Advanced search filters */
+export interface SearchFilters {
+    /** Search matching mode (defaults to PARTIAL for autocomplete) */
+    searchMode?: SearchMode;
+    /** Filter by entity types (OR logic) */
+    entityTypes?: string[];
+    /** Exclude specific entity types */
+    excludeEntityTypes?: string[];
+    /** Filter by product sources */
+    productSources?: string[];
+    /** Filter to a specific project */
+    projectId?: string;
+    /** Filter by actor who created the entity */
+    createdBy?: string;
+    /** Filter by actor who last updated the entity */
+    updatedBy?: string;
+    /** Date range filter on creation date */
+    dateRange?: DateRange;
+    /** Date range filter on update date */
+    updatedDateRange?: DateRange;
+    /** Metadata key-value conditions (AND-ed together) */
+    metadataConditions?: MetadataCondition[];
+    /** Entity-owned tag filters resolved in graph search */
+    tagFilter?: TagFilter;
+    /** Exclude specific entity IDs */
+    excludeIds?: string[];
+    /** Sort order (defaults to SCORE_DESC) */
+    sortBy?: SearchSortBy;
+    /** Number of results per page (max 100) */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+export interface UseGlobalSearchReturn {
+    /** Search and return full response with pagination and facets */
+    searchFull: (query: string, category?: string, filters?: SearchFilters) => Promise<SearchResponse>;
+    /** Search and return just the results array (backward-compatible) */
+    search: (query: string, category?: string, filters?: SearchFilters) => Promise<readonly SearchResult[]>;
+    isSearching: boolean;
+}
+/**
+ * Maps UI search category names to backend entity types.
+ * Categories without a mapping search across all entity types (no filter).
+ */
+export declare const CATEGORY_ENTITY_TYPE_MAP: Record<string, string[]>;
+export declare function resolveEntityTypesForCategory(category?: string): string[] | undefined;
+/**
+ * Global search hook — single entry point for all search operations.
+ *
+ * The `category` parameter provides a quick UI-friendly filter by mapping
+ * category names to entity types. For more advanced filtering, pass a
+ * `SearchFilters` object as the third argument.
+ *
+ * @example Basic search
+ * ```tsx
+ * const { search, isSearching } = useGlobalSearch();
+ * const results = await search('dashboard');
+ * ```
+ *
+ * @example Category filter
+ * ```tsx
+ * const results = await search('dashboard', 'projects');
+ * ```
+ *
+ * @example Advanced filters
+ * ```tsx
+ * const results = await search('dashboard', undefined, {
+ *   projectId: 'proj-123',
+ *   sortBy: 'CREATED_DESC',
+ *   metadataConditions: [{ key: 'status', value: 'active' }],
+ *   limit: 50,
+ * });
+ * ```
+ */
+export declare function useGlobalSearch(): UseGlobalSearchReturn;
+//# sourceMappingURL=useGlobalSearch.d.ts.map

package/dist/shared/hooks/shell/useGlobalSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalSearch.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useGlobalSearch.ts"],"names":[],"mappings":"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"}