@burdenoff/fe-libs 2026.510.126

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

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

package/dist/shared/tours/types.js

@@ -0,0 +1,16 @@
+//#region src/shared/tours/types.ts
+function e(e, t) {
+	switch (t) {
+		case "mobile": return e.targetSelectorMobile || e.targetSelector;
+		case "tablet": return e.targetSelectorTablet || e.targetSelector;
+		case "desktop": return e.targetSelectorDesktop || e.targetSelector;
+		default: return e.targetSelector;
+	}
+}
+function t() {
+	if (typeof window > "u") return "desktop";
+	let e = window.innerWidth;
+	return e < 768 ? "mobile" : e < 1024 ? "tablet" : "desktop";
+}
+//#endregion
+export { t as detectDeviceType, e as getResponsiveSelector };

package/dist/shared/tours/useTourPlayer.d.ts

@@ -0,0 +1,38 @@
+import { Tour, TourStep, DeviceType } from './types';
+interface UseTourPlayerOptions {
+    onTourStart?: (tour: Tour) => void;
+    onTourComplete?: (tour: Tour) => void;
+    onTourSkip?: (tour: Tour, stepIndex: number) => void;
+    onStepChange?: (tour: Tour, stepIndex: number) => void;
+    onStepComplete?: (tour: Tour, stepIndex: number) => void;
+}
+/**
+ * Hook for managing tour player state and actions
+ */
+export declare function useTourPlayer(options?: UseTourPlayerOptions): {
+    currentStep: TourStep | null;
+    totalSteps: number;
+    progress: number;
+    canGoNext: boolean;
+    canGoPrevious: boolean;
+    isLastStep: boolean;
+    targetRect: DOMRect | null;
+    deviceType: DeviceType;
+    startTour: (tour: Tour) => void;
+    stopTour: () => void;
+    nextStep: () => void;
+    previousStep: () => void;
+    goToStep: (index: number) => void;
+    pauseTour: () => void;
+    resumeTour: () => void;
+    skipTour: () => void;
+    completeTour: () => void;
+    isPlaying: boolean;
+    currentTour: Tour | null;
+    currentStepIndex: number;
+    isPaused: boolean;
+    isCompleted: boolean;
+    isSkipped: boolean;
+};
+export {};
+//# sourceMappingURL=useTourPlayer.d.ts.map

package/dist/shared/tours/useTourPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTourPlayer.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/useTourPlayer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAmB,UAAU,EAAE,MAAM,SAAS,CAAC;AAG3E,UAAU,oBAAoB;IAC5B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;;;;;;;;;sBAyPrD,IAAI;;;;sBAuEH,MAAM;;;;;;;;;;;EAoGjB"}

package/dist/shared/tours/useTourPlayer.js

@@ -0,0 +1,238 @@
+import { detectDeviceType as e, getResponsiveSelector as t } from "./types.js";
+import { useCallback as n, useEffect as r, useRef as i, useState as a } from "react";
+//#region src/shared/tours/useTourPlayer.ts
+function o(o = {}) {
+	let { onTourStart: s, onTourComplete: c, onTourSkip: l, onStepChange: u, onStepComplete: d } = o, [f, p] = a({
+		isPlaying: !1,
+		currentTour: null,
+		currentStepIndex: 0,
+		isPaused: !1,
+		isCompleted: !1,
+		isSkipped: !1
+	}), [m, h] = a(null), [g, _] = a("desktop"), [v, y] = a(!0), [b, x] = a(!0), [S, C] = a(!0), [w, T] = a(!0), E = i(null), D = i(null);
+	r(() => {
+		let t = () => {
+			_(e());
+		};
+		return t(), window.addEventListener("resize", t), () => window.removeEventListener("resize", t);
+	}, []);
+	let O = f.currentTour?.steps[f.currentStepIndex] ?? null, k = f.currentTour?.steps.length ?? 0, A = k > 0 ? (f.currentStepIndex + 1) / k * 100 : 0, j = f.currentStepIndex < k - 1, M = f.currentStepIndex > 0, N = f.currentStepIndex === k - 1, P = !!O && v && b && S && w, F = n((e) => {
+		if (!e) {
+			h(null);
+			return;
+		}
+		let n = t(e, g);
+		if (!n) {
+			h(null);
+			return;
+		}
+		let r = document.querySelector(n);
+		if (r) {
+			let e = r.getBoundingClientRect();
+			h(e), e.top >= 0 && e.left >= 0 && e.bottom <= window.innerHeight && e.right <= window.innerWidth || (r.scrollIntoView({
+				behavior: "smooth",
+				block: "center",
+				inline: "center"
+			}), D.current && clearTimeout(D.current), D.current = setTimeout(() => {
+				h(r.getBoundingClientRect());
+			}, 500));
+		} else h(null);
+	}, [g]);
+	r(() => {
+		if (!O || !f.isPlaying) {
+			h(null);
+			return;
+		}
+		let e = t(O, g);
+		if (!e) return;
+		let n = document.querySelector(e);
+		if (!n) {
+			let t = new MutationObserver(() => {
+				document.querySelector(e) && (t.disconnect(), F(O));
+			});
+			return t.observe(document.body, {
+				childList: !0,
+				subtree: !0
+			}), () => {
+				t.disconnect();
+			};
+		}
+		F(O), E.current = new ResizeObserver(() => {
+			F(O);
+		}), E.current.observe(n);
+		let r = () => {
+			F(O);
+		};
+		return window.addEventListener("scroll", r, !0), () => {
+			E.current && E.current.disconnect(), window.removeEventListener("scroll", r, !0), D.current && clearTimeout(D.current);
+		};
+	}, [
+		O,
+		f.isPlaying,
+		g,
+		F
+	]), r(() => {
+		if (!O || !f.isPlaying) {
+			y(!0), x(!0), C(!0), T(!0);
+			return;
+		}
+		let e = t(O, g) || O.waitForSelector || void 0;
+		y(!O.requireInteraction || !e), x(!O.waitForSelector || !!document.querySelector(O.waitForSelector)), C(!O.waitForTimeout), T(!O.waitForEvent);
+		let n = [];
+		if (O.requireInteraction && e) {
+			let t = (t) => {
+				let n = t.target;
+				n instanceof Element && n.closest(e) && y(!0);
+			};
+			document.addEventListener("click", t, !0), n.push(() => {
+				document.removeEventListener("click", t, !0);
+			});
+		}
+		if (O.waitForSelector) {
+			let e = O.waitForSelector;
+			if (!document.querySelector(e)) {
+				let t = new MutationObserver(() => {
+					document.querySelector(e) && (x(!0), t.disconnect());
+				});
+				t.observe(document.body, {
+					childList: !0,
+					subtree: !0
+				}), n.push(() => t.disconnect());
+			}
+		}
+		if (O.waitForTimeout && O.waitForTimeout > 0) {
+			let e = window.setTimeout(() => {
+				C(!0);
+			}, O.waitForTimeout);
+			n.push(() => window.clearTimeout(e));
+		}
+		if (O.waitForEvent) {
+			let e = () => {
+				T(!0);
+			};
+			window.addEventListener(O.waitForEvent, e), n.push(() => {
+				window.removeEventListener(O.waitForEvent, e);
+			});
+		}
+		return () => {
+			n.forEach((e) => e());
+		};
+	}, [
+		O,
+		g,
+		f.isPlaying
+	]);
+	let I = n((e) => {
+		p({
+			isPlaying: !0,
+			currentTour: e,
+			currentStepIndex: 0,
+			isPaused: !1,
+			isCompleted: !1,
+			isSkipped: !1
+		}), s?.(e), u?.(e, 0);
+	}, [u, s]), L = n(() => {
+		p({
+			isPlaying: !1,
+			currentTour: null,
+			currentStepIndex: 0,
+			isPaused: !1,
+			isCompleted: !1,
+			isSkipped: !1
+		}), h(null);
+	}, []), R = n(() => {
+		if (!f.currentTour || !j || !P) return;
+		d?.(f.currentTour, f.currentStepIndex);
+		let e = f.currentStepIndex + 1;
+		p((t) => ({
+			...t,
+			currentStepIndex: e
+		})), u?.(f.currentTour, e);
+	}, [
+		f.currentTour,
+		f.currentStepIndex,
+		j,
+		P,
+		u,
+		d
+	]), z = n(() => {
+		if (!f.currentTour || !M) return;
+		let e = f.currentStepIndex - 1;
+		p((t) => ({
+			...t,
+			currentStepIndex: e
+		})), u?.(f.currentTour, e);
+	}, [
+		f.currentTour,
+		f.currentStepIndex,
+		M,
+		u
+	]), B = n((e) => {
+		!f.currentTour || e < 0 || e >= k || (p((t) => ({
+			...t,
+			currentStepIndex: e
+		})), u?.(f.currentTour, e));
+	}, [
+		f.currentTour,
+		k,
+		u
+	]), V = n(() => {
+		p((e) => ({
+			...e,
+			isPaused: !0
+		}));
+	}, []), H = n(() => {
+		p((e) => ({
+			...e,
+			isPaused: !1
+		}));
+	}, []), U = n(() => {
+		if (!f.currentTour) return;
+		let e = f.currentTour, t = f.currentStepIndex;
+		p((e) => ({
+			...e,
+			isSkipped: !0,
+			isPlaying: !1
+		})), l?.(e, t), h(null);
+	}, [
+		f.currentTour,
+		f.currentStepIndex,
+		l
+	]), W = n(() => {
+		if (!f.currentTour || !P) return;
+		let e = f.currentTour;
+		d?.(e, f.currentStepIndex), p((e) => ({
+			...e,
+			isCompleted: !0,
+			isPlaying: !1
+		})), c?.(e), h(null);
+	}, [
+		f.currentTour,
+		f.currentStepIndex,
+		P,
+		d,
+		c
+	]);
+	return {
+		...f,
+		currentStep: O,
+		totalSteps: k,
+		progress: A,
+		canGoNext: P,
+		canGoPrevious: M,
+		isLastStep: N,
+		targetRect: m,
+		deviceType: g,
+		startTour: I,
+		stopTour: L,
+		nextStep: R,
+		previousStep: z,
+		goToStep: B,
+		pauseTour: V,
+		resumeTour: H,
+		skipTour: U,
+		completeTour: W
+	};
+}
+//#endregion
+export { o as useTourPlayer };

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

@@ -0,0 +1,185 @@
+import { ReactNode } from 'react';
+/**
+ * Navigation item for shell integration
+ */
+export interface NavItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    path: string;
+    badge?: number;
+    order?: number;
+    group?: string;
+    visible?: boolean;
+    children?: NavItem[];
+    /**
+     * When sidebar is collapsed and this parent item is clicked,
+     * navigate to this path instead of the parent's path.
+     * If not specified, defaults to the first child's path (if children exist).
+     */
+    homePath?: string;
+}
+/**
+ * Footer item for shell integration
+ */
+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;
+}
+/**
+ * Footer section type
+ */
+export type FooterSection = "left" | "center" | "right";
+/**
+ * Base user type
+ * Note: firstName and lastName are optional for compatibility with auth API responses
+ * that may not always include these fields
+ */
+export interface User {
+    id: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    /** Optional username for display */
+    username?: string;
+    /** Optional full name */
+    name?: string;
+    /** User role */
+    role?: string;
+}
+/**
+ * Base microfrontend root props
+ */
+export interface MicrofrontendRootProps {
+    /**
+     * Base path for the microfrontend (e.g., '/tags', '/workflows')
+     */
+    basePath: string;
+    /**
+     * Navigation function injected by the host shell
+     */
+    navigate: (path: string) => void;
+    /**
+     * Current authenticated user
+     */
+    currentUser?: User;
+    /**
+     * Current tenant ID (for tenant modules)
+     */
+    tenantId?: string;
+    /**
+     * Current organization ID (for workspace modules that need org context)
+     */
+    organizationId?: string;
+    /**
+     * Current workspace ID (for workspace modules)
+     */
+    workspaceId?: string;
+    /**
+     * API Gateway URL
+     */
+    apiGatewayUrl?: string;
+    /**
+     * Authentication token
+     */
+    authToken?: string;
+    /**
+     * Product name for branding (e.g., "Burdenoff Workspaces", "FluidGrids", "Botlit")
+     * Injected by the host shell to ensure consistent branding across all MFEs
+     */
+    productName?: string;
+    /**
+     * Product ID for branding (e.g., "workspaces", "fluidgrids", "botlit")
+     * Injected by the host shell to identify which app shell is rendering
+     */
+    productId?: string;
+    /**
+     * Optional function to register navigation items with the shell
+     * Injected by the shell app
+     * @returns Cleanup function to unregister the items
+     */
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    /**
+     * Optional function to register footer items with the shell
+     * Injected by the shell app
+     * @returns Cleanup function to unregister the items
+     */
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+}
+/**
+ * Represents a single search result item
+ */
+export interface SearchResult {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly category: string;
+    readonly entityType?: string;
+    readonly productSource?: string;
+    readonly icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    readonly href: string;
+    /** Graph relevance score from search engine */
+    readonly score?: number;
+    /** Workspace this result belongs to */
+    readonly workspaceId?: string;
+    /** Actor who created this entity */
+    readonly createdBy?: string;
+    /** Actor who last updated this entity */
+    readonly updatedBy?: string;
+    readonly metadata?: Readonly<{
+        createdAt?: Date;
+        author?: string;
+        tags?: readonly string[];
+        [key: string]: unknown;
+    }>;
+}
+/**
+ * Faceted search counts for filtering UI
+ */
+export interface SearchFacets {
+    readonly byType: ReadonlyArray<{
+        type: string;
+        count: number;
+    }>;
+    readonly byProduct: ReadonlyArray<{
+        product: string;
+        count: number;
+    }>;
+    readonly byWorkspace: ReadonlyArray<{
+        workspaceId: string;
+        count: number;
+    }>;
+}
+/**
+ * Full search response including pagination and facets
+ */
+export interface SearchResponse {
+    readonly results: readonly SearchResult[];
+    readonly total: number;
+    readonly hasMore: boolean;
+    readonly facets?: SearchFacets;
+    readonly searchTimeMs?: number;
+    readonly error?: "NO_WORKSPACE_CONTEXT" | string;
+}
+/**
+ * Search category configuration
+ */
+export interface SearchCategory {
+    readonly name: string;
+    readonly label: string;
+    readonly icon: React.ComponentType<{
+        className?: string;
+    }>;
+    readonly entityTypes?: readonly string[];
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/shared/utils/apollo.d.ts

@@ -0,0 +1,13 @@
+import { ApolloClient, InMemoryCache } from '@apollo/client';
+export interface CreateApolloClientOptions {
+    uri: string;
+    getAuthToken?: () => string | null | undefined;
+    onAuthError?: () => void;
+    onNetworkError?: (error: Error) => void;
+    cache?: InMemoryCache;
+    retryAttempts?: number;
+    retryDelay?: number;
+}
+export declare function withBrowserTraceHeader(headersInit?: HeadersInit): Headers;
+export declare function createApolloClient(options: CreateApolloClientOptions): ApolloClient;
+//# sourceMappingURL=apollo.d.ts.map

package/dist/shared/utils/apollo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/apollo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAQ,MAAM,gBAAgB,CAAC;AAQnE,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAMzE;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAwHd"}

package/dist/shared/utils/apollo.js

@@ -0,0 +1,68 @@
+import { createBrowserTraceContext as e } from "../events/metadata.js";
+import { ApolloClient as t, InMemoryCache as n, from as r } from "@apollo/client";
+import { BatchHttpLink as i } from "@apollo/client/link/batch-http";
+import { onError as a } from "@apollo/client/link/error";
+import { RetryLink as o } from "@apollo/client/link/retry";
+import { setContext as s } from "@apollo/client/link/context";
+//#region src/shared/utils/apollo.ts
+function c(t) {
+	let n = new Headers(t);
+	return n.has("traceparent") || n.set("traceparent", e().traceparent), n;
+}
+function l(e) {
+	let { uri: l, getAuthToken: u, onAuthError: d, onNetworkError: f, cache: p = new n(), retryAttempts: m = 3, retryDelay: h = 1e3 } = e;
+	return new t({
+		link: r([
+			new o({
+				delay: {
+					initial: h,
+					max: h * 4,
+					jitter: !0
+				},
+				attempts: {
+					max: m,
+					retryIf: (e) => !!e && !e.message.includes("401") && !e.message.includes("403")
+				}
+			}),
+			a(({ error: e }) => {
+				let t = e.errors;
+				t ? t.forEach((e) => {
+					console.error(`[GraphQL error]: Message: ${e.message}, Location: ${JSON.stringify(e.locations)}, Path: ${e.path}`), (e.extensions?.code === "UNAUTHENTICATED" || e.extensions?.code === "FORBIDDEN") && d?.();
+				}) : e && (console.error(`[Network error]: ${e.message}`), f?.(e));
+			}),
+			s((e, { headers: t }) => {
+				let n = u?.();
+				console.log("[fe-libs apollo] getAuthToken returned:", n ? n.substring(0, 20) + "..." : "null");
+				let r = { headers: {
+					...t,
+					...n ? { authorization: `Bearer ${n}` } : {}
+				} };
+				return console.log("[fe-libs apollo] Authorization header:", r.headers.authorization ? r.headers.authorization.substring(0, 30) + "..." : "MISSING"), r;
+			}),
+			new i({
+				uri: l,
+				credentials: "include",
+				batchMax: 50,
+				batchInterval: 100,
+				fetch: (e, t) => fetch(e, {
+					...t,
+					headers: c(t?.headers)
+				})
+			})
+		]),
+		cache: p,
+		defaultOptions: {
+			watchQuery: {
+				fetchPolicy: "cache-and-network",
+				errorPolicy: "all"
+			},
+			query: {
+				fetchPolicy: "network-only",
+				errorPolicy: "all"
+			},
+			mutate: { errorPolicy: "all" }
+		}
+	});
+}
+//#endregion
+export { l as createApolloClient };

package/dist/shared/utils/appHelpers.d.ts

@@ -0,0 +1,34 @@
+import { ReactNode } from 'react';
+import { User } from '../providers/shell/AuthProvider';
+import { NavItem } from '../hooks/shell/useNavRegistry';
+import { FooterItem } from '../hooks/shell/useFooterRegistry';
+/**
+ * AppInitializer Component
+ * Initializes auth and active context when the application mounts.
+ * Useful for integrating standalone MFE dev harnesses with the shell's providers.
+ */
+export interface AppInitializerProps {
+    user: User | null;
+    authToken: string;
+    workspaceId: string | null;
+    tenantId: string | null;
+    projectId?: string | null;
+    children: ReactNode;
+}
+export declare function AppInitializer({ user, authToken, workspaceId, tenantId, projectId, children, }: AppInitializerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Custom navigate hook wrapping React Router's useNavigate.
+ * Wraps navigation in startTransition so React keeps the current UI
+ * responsive while lazy-loaded route components are fetched.
+ */
+export declare function useShellNavigate(): (path: string) => void;
+/**
+ * Registry helpers for navigation and footer items.
+ * Returns functions to register/unregister nav and footer items
+ * that MFE roots can use via their registerNavItems/registerFooterItems props.
+ */
+export declare function useRegistryHelpers(): {
+    registerNavItems: (items: NavItem | NavItem[]) => () => void;
+    registerFooterItems: (items: FooterItem | FooterItem[]) => () => void;
+};
+//# sourceMappingURL=appHelpers.d.ts.map

package/dist/shared/utils/appHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appHelpers.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/appHelpers.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAyC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAEL,KAAK,OAAO,EACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,kCAAkC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,mBAAmB,2CA+BrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,WAKrB,MAAM,UAWhB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB;8BAYtB,OAAO,GAAG,OAAO,EAAE;iCAWnB,UAAU,GAAG,UAAU,EAAE;EAcpC"}

package/dist/shared/utils/appHelpers.js

@@ -0,0 +1,54 @@
+import { useAuth as e } from "../providers/shell/AuthProvider.js";
+import { useActiveContext as t } from "../providers/shell/ActiveContextProvider.js";
+import { useNavRegistryStore as n } from "../hooks/shell/useNavRegistry.js";
+import { useFooterRegistryStore as r } from "../hooks/shell/useFooterRegistry.js";
+import { useCallback as i, useEffect as a, useTransition as o } from "react";
+import { Fragment as s, jsx as c } from "react/jsx-runtime";
+import { useNavigate as l } from "react-router-dom";
+//#region src/shared/utils/appHelpers.tsx
+function u({ user: n, authToken: r, workspaceId: i, tenantId: o, projectId: l, children: u }) {
+	let { login: d, isAuthenticated: f } = e(), { setWorkspace: p, setTenant: m, setProject: h } = t();
+	return a(() => {
+		n && !f && d(n, r), i && p(i), o && m(o), l && h && h(l);
+	}, [
+		n,
+		r,
+		i,
+		o,
+		l,
+		f,
+		d,
+		p,
+		m,
+		h
+	]), /* @__PURE__ */ c(s, { children: u });
+}
+function d() {
+	let e = l(), [, t] = o();
+	return i((n) => {
+		e && t(() => {
+			e(n);
+		});
+	}, [e, t]);
+}
+function f() {
+	let e = n((e) => e.register), t = n((e) => e.unregister), a = r((e) => e.register), o = r((e) => e.unregister);
+	return {
+		registerNavItems: i((n) => {
+			let r = Array.isArray(n) ? n : [n];
+			return r.forEach((t) => e(t)), () => {
+				r.forEach((e) => t(e.id));
+			};
+		}, [e, t]),
+		registerFooterItems: i((e) => {
+			let t = Array.isArray(e) ? e : [e];
+			return t.forEach((e) => {
+				a(e.section ?? "left", e);
+			}), () => {
+				t.forEach((e) => o(e.id));
+			};
+		}, [a, o])
+	};
+}
+//#endregion
+export { u as AppInitializer, f as useRegistryHelpers, d as useShellNavigate };