@burdenoff/fe-libs 2026.528.10 → 2026.528.11

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,34 @@
+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 { useRecordProductVisit } from './useRecordProductVisit';
+export { useQuotaErrorToast, dispatchQuotaExhausted, QUOTA_EXHAUSTED_EVENT, } from './useQuotaErrorToast';
+export type { UseQuotaErrorToastOptions, QuotaExhaustedEventDetail } from './useQuotaErrorToast';
+export { useUpgradePrompt, publishPlanUsageSnapshot, PLAN_USAGE_SNAPSHOT_EVENT, } from './useUpgradePrompt';
+export type { UseUpgradePromptOptions, UseUpgradePromptResult, PlanUsageEntry, PlanUsageSnapshot, } from './useUpgradePrompt';
+export { useCurrentContextSearchParams, appendContextToPath, } from './useCurrentContextSearchParams';
+//# 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,KAAc,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,8CAA2D,CAAC;AAE7F;;GAEG;AACH,wBAAgB,uBAAuB,2BAMtC;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,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,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,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrF,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,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjG,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,iCAAiC,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,EAAc,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAExF,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,kFAehC,CAAC"}

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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"}

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

@@ -0,0 +1,43 @@
+/**
+ * Language type for LanguageSwitcher component
+ */
+export interface Language {
+    code: string;
+    name: string;
+    nativeName: string;
+    flag: string;
+}
+/**
+ * Hook return type
+ */
+export interface UseLanguagesReturn {
+    /** Languages formatted for LanguageSwitcher */
+    languages: Language[];
+    /** Whether languages are loading */
+    isLoading: boolean;
+    /** Error message if fetch failed */
+    error: string | null;
+    /** Refetch languages from API */
+    refetch: () => void;
+    /** Default language code */
+    defaultLanguageCode: string;
+}
+export interface UseLanguagesOptions {
+    /**
+     * When true, fetch on mount. Default: false — the hook is lazy so the
+     * global-header batch on first paint doesn't pay for a query whose
+     * results are only needed when the user actually opens the language
+     * picker dropdown. Consumers should call `refetch()` from the
+     * dropdown's `onMouseDown` / `onFocus` handler instead.
+     */
+    autoFetch?: boolean;
+}
+/**
+ * useLanguages Hook
+ *
+ * Fetches languages from the i18n service and formats them for the LanguageSwitcher component.
+ * Includes flag emojis based on language code or region.
+ * Defaults to English if no languages are available.
+ */
+export declare function useLanguages(options?: UseLanguagesOptions): UseLanguagesReturn;
+//# sourceMappingURL=useLanguages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLanguages.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useLanguages.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAsID;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iCAAiC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,kBAAkB,CA0G9E"}

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

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+export interface NavItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    path: string;
+    badge?: number;
+    order?: number;
+    group?: string;
+    visible?: boolean;
+    children?: NavItem[];
+    homePath?: string;
+    exact?: boolean;
+    /** Plugin that registered this item. Set automatically by the plugin runtime. */
+    pluginId?: string;
+}
+interface NavRegistryStore {
+    items: NavItem[];
+    register: (item: NavItem) => void;
+    unregister: (id: string) => void;
+    clear: () => void;
+}
+export declare const useNavRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<NavRegistryStore>>;
+export {};
+//# sourceMappingURL=useNavRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNavRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useNavRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB,+EAa7B,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * useProductAccess Hook — checks if the current user can access a specific product.
+ *
+ * Uses the checkProductAccess query on the global gateway.
+ * Returns access status, reason, and loading state.
+ *
+ * @module @burdenoff/fe-libs/shared/hooks/shell/useProductAccess
+ */
+export type ProductAccessReason = 'PRODUCT_ACTIVE' | 'SUPER_ADMIN_ACCESS' | 'INTERNAL_DOMAIN_ACCESS' | 'WAITLIST_APPROVED' | 'WAITLIST_PENDING' | 'WAITLIST_REJECTED' | 'WAITLIST_NOT_JOINED' | 'PRODUCT_DRAFT' | 'NO_ACCESS';
+export interface ProductAccessResult {
+    hasAccess: boolean;
+    reason: ProductAccessReason;
+    product?: {
+        id: string;
+        name: string;
+        slug: string;
+        appUrl?: string | null;
+        status: string;
+    } | null;
+}
+export interface UseProductAccessReturn {
+    hasAccess: boolean;
+    reason: ProductAccessReason;
+    product: ProductAccessResult['product'];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+export declare function useProductAccess(productId: string): UseProductAccessReturn;
+/**
+ * Same as `useProductAccess` but returns a no-access sentinel instead of
+ * throwing when no `GatewayProvider` is mounted. Used by cross-cutting shell
+ * chrome (TourTrigger, pre-auth widgets) that may render in trees without a
+ * GraphQL gateway — tests, standalone previews, or embed hosts.
+ */
+export declare function useSafeProductAccess(productId: string): UseProductAccessReturn;
+//# sourceMappingURL=useProductAccess.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useProductAccess.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useProductAccess.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,oBAAoB,GACpB,wBAAwB,GACxB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,eAAe,GACf,WAAW,CAAC;AAEhB,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAG9E"}

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

@@ -0,0 +1,30 @@
+/**
+ * useProducts Hook — shared across all product app shells.
+ *
+ * Fetches platform products from the tenant service via the global gateway.
+ * Falls back to the built-in product catalog when the API is unavailable.
+ *
+ * @module @burdenoff/fe-libs/shared/hooks/shell/useProducts
+ */
+export interface Product {
+    id: string;
+    name: string;
+    url: string;
+    icon: string;
+    color: string;
+}
+export interface UseProductsReturn {
+    products: Product[];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+export interface UseProductsOptions {
+    autoFetch?: boolean;
+}
+/**
+ * Fetches platform products from the tenant service.
+ * Falls back to the built-in product catalog when the API is unavailable.
+ */
+export declare function useProducts(options?: UseProductsOptions): UseProductsReturn;
+//# sourceMappingURL=useProducts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useProducts.d.ts","sourceRoot":"","sources":["../../../../src/shared/hooks/shell/useProducts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0CH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAgDD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAsD3E"}