@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/icons/icon-registry.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/icons/icon-registry.frontend.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/icons/useIconRegistry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * useIconRegistry Hook
+ *
+ * Separated from IconRegistryContext.tsx for React Fast Refresh compatibility.
+ */
+import { type IconRegistryContextType } from './IconRegistryContext.js';
+/**
+ * Hook to access the Icon Registry context
+ * @returns IconRegistryContextType with icon lookup functions
+ * @throws WildoError if used outside of IconRegistryProvider
+ */
+export declare const useIconRegistry: () => IconRegistryContextType;
+//# sourceMappingURL=useIconRegistry.d.ts.map

package/dist/esm/core/icons/useIconRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIconRegistry.d.ts","sourceRoot":"","sources":["../../../../src/core/icons/useIconRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAI1F;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,uBAWlC,CAAC"}

package/dist/esm/core/icons/useIconRegistry.js

@@ -0,0 +1,26 @@
+/**
+ * useIconRegistry Hook
+ *
+ * Separated from IconRegistryContext.tsx for React Fast Refresh compatibility.
+ */
+import { useContext } from 'react';
+import { ErrorType } from '@wildo-ai/saas-models';
+import { ErrorBuilderFrontend } from '../../core/errors/errors-builder.frontend.services.js';
+import { IconRegistryContext } from './IconRegistryContext.js';
+const errorBuilder = new ErrorBuilderFrontend();
+/**
+ * Hook to access the Icon Registry context
+ * @returns IconRegistryContextType with icon lookup functions
+ * @throws WildoError if used outside of IconRegistryProvider
+ */
+export const useIconRegistry = () => {
+    const context = useContext(IconRegistryContext);
+    if (!context) {
+        const wildoError = errorBuilder.buildWildoError_Frontend(ErrorType.CONFIGURATION, {
+            context: { message: 'useIconRegistry must be used within an IconRegistryProvider' },
+        });
+        throw wildoError;
+    }
+    return context;
+};
+//# sourceMappingURL=useIconRegistry.js.map

package/dist/esm/core/icons/useIconRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIconRegistry.js","sourceRoot":"","sources":["../../../../src/core/icons/useIconRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kEAAkE,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAgC,MAAM,uBAAuB,CAAC;AAE1F,MAAM,YAAY,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAA4B,EAAE;IAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,YAAY,CAAC,wBAAwB,CAAC,SAAS,CAAC,aAAa,EAAE;YAChF,OAAO,EAAE,EAAE,OAAO,EAAE,6DAA6D,EAAE;SACpF,CAAC,CAAC;QACH,MAAM,UAAU,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/esm/core/loading/AppLoadingGate.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+export interface AppLoadingGateProps {
+    /** Custom full-screen loading renderer. Default: centered spinner. */
+    renderLoading?: (sources: {
+        identifier: string;
+    }[]) => ReactNode;
+    children: ReactNode;
+}
+/**
+ * AppLoadingGate — Tier 1 application-level loading gate.
+ *
+ * Gates the entire application UI when any app-level loading is active
+ * (initialization steps, language change, org switch). Renders a full-screen
+ * loading overlay until all Tier 1 loading sources have resolved.
+ *
+ * Mount between `<LoadingProvider>` and `<AnonymousSessionProvider>` in the
+ * provider tree. This ensures the UI is blocked during critical app-level
+ * operations without affecting the loading state management itself.
+ */
+export declare function AppLoadingGate({ renderLoading, children }: AppLoadingGateProps): React.JSX.Element;
+//# sourceMappingURL=AppLoadingGate.d.ts.map

package/dist/esm/core/loading/AppLoadingGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppLoadingGate.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/AppLoadingGate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,SAAS,CAAC;IACjE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoBlG"}

package/dist/esm/core/loading/AppLoadingGate.js

@@ -0,0 +1,33 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { useAppLoading } from './useAppLoading.js';
+import { LoadingSpinner } from '../../components/feedback/loading-spinner.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('AppLoadingGate');
+logger.setDebugTypeLogging('AppLoadingGate', false);
+/**
+ * AppLoadingGate — Tier 1 application-level loading gate.
+ *
+ * Gates the entire application UI when any app-level loading is active
+ * (initialization steps, language change, org switch). Renders a full-screen
+ * loading overlay until all Tier 1 loading sources have resolved.
+ *
+ * Mount between `<LoadingProvider>` and `<AnonymousSessionProvider>` in the
+ * provider tree. This ensures the UI is blocked during critical app-level
+ * operations without affecting the loading state management itself.
+ */
+export function AppLoadingGate({ renderLoading, children }) {
+    const { isAppLoading, sources } = useAppLoading();
+    useEffect(() => {
+        logDebug(`Gate render state: ${isAppLoading ? 'loading' : 'ready'} [${sources.map(source => source.identifier).join(', ') || 'none'}]`);
+    }, [isAppLoading, sources]);
+    if (isAppLoading) {
+        if (renderLoading) {
+            return _jsx(_Fragment, { children: renderLoading(sources) });
+        }
+        return (_jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-background", children: _jsx(LoadingSpinner, { size: 48 }) }));
+    }
+    return _jsx(_Fragment, { children: children });
+}
+//# sourceMappingURL=AppLoadingGate.js.map

package/dist/esm/core/loading/AppLoadingGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppLoadingGate.js","sourceRoot":"","sources":["../../../../src/core/loading/AppLoadingGate.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;AACtD,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAQpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAuB;IAC7E,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,sBAAsB,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;IAC1I,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5B,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,4BAAG,aAAa,CAAC,OAAO,CAAC,GAAI,CAAC;QACvC,CAAC;QAED,OAAO,CACL,cAAK,SAAS,EAAC,mEAAmE,YAChF,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GACxB,CACP,CAAC;IACJ,CAAC;IAED,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC"}

package/dist/esm/core/loading/LoadingBarrier.d.ts

@@ -0,0 +1,53 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { LoadingErrorContext } from './loading-types.frontend.schemas.js';
+interface BarrierRegistration {
+    markReady: () => void;
+    markError: (error?: unknown) => void;
+    /** Remove this participant from the barrier — call in useEffect cleanup */
+    unregister: () => void;
+}
+interface LoadingBarrierContextType {
+    register: (id: string) => BarrierRegistration;
+    /** Incremented on each retry — children can depend on this to re-trigger loading */
+    retryCounter: number;
+}
+/**
+ * Hook for child components to register themselves as barrier participants.
+ *
+ * Call `register(id)` once (typically in a useEffect) and use the returned
+ * `markReady` / `markError` / `unregister` to manage the child's lifecycle.
+ * Call `unregister()` in the useEffect cleanup to prevent dangling participants.
+ *
+ * Use `retryCounter` as a dependency in effects that need to re-trigger loading
+ * when the barrier's retry handler fires.
+ *
+ * @throws Error if used outside a `<LoadingBarrier>`
+ */
+export declare function useBarrierParticipant(): LoadingBarrierContextType;
+export interface LoadingBarrierProps {
+    /** Custom loading renderer — shown while children are registering and loading */
+    renderLoading?: () => ReactNode;
+    /** Error renderer — shown on timeout or participant error */
+    renderError?: (context: LoadingErrorContext) => ReactNode;
+    /** Timeout in ms after which the barrier shows an error. Default: no timeout. */
+    timeoutMs?: number;
+    children: ReactNode;
+}
+/**
+ * LoadingBarrier — Composite loading gate for dynamic views.
+ *
+ * Used when the set of loading dependencies is determined by children at
+ * render time (e.g., a dashboard with multiple independently-loaded cards,
+ * a side menu with multiple resource counts).
+ *
+ * Children self-register as participants via `useBarrierParticipant()`,
+ * then call `markReady()` or `markError()` when loaded. The barrier
+ * renders children invisibly (opacity 0, pointer-events none) until all
+ * participants are ready, then transitions to full visibility.
+ *
+ * @see loading-system-architecture.md §2.5 "LoadingBarrier"
+ */
+export declare function LoadingBarrier({ renderLoading, renderError, timeoutMs, children, }: LoadingBarrierProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=LoadingBarrier.d.ts.map

package/dist/esm/core/loading/LoadingBarrier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingBarrier.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/LoadingBarrier.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuF,MAAM,OAAO,CAAC;AAC5G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAW5E,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,UAAU,yBAAyB;IACjC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAC9C,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAIjE;AAID,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,SAAS,CAAC;IAChC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,CAAC;IAC1D,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+HzC"}

package/dist/esm/core/loading/LoadingBarrier.js

@@ -0,0 +1,133 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { LoadingSpinner } from '../../components/feedback/loading-spinner.js';
+// ─── Types ──────────────────────────────────────────────────────────────────
+var ParticipantStatus;
+(function (ParticipantStatus) {
+    ParticipantStatus["PENDING"] = "pending";
+    ParticipantStatus["READY"] = "ready";
+    ParticipantStatus["ERROR"] = "error";
+})(ParticipantStatus || (ParticipantStatus = {}));
+// ─── Context ────────────────────────────────────────────────────────────────
+const LoadingBarrierContext = createContext(null);
+/**
+ * Hook for child components to register themselves as barrier participants.
+ *
+ * Call `register(id)` once (typically in a useEffect) and use the returned
+ * `markReady` / `markError` / `unregister` to manage the child's lifecycle.
+ * Call `unregister()` in the useEffect cleanup to prevent dangling participants.
+ *
+ * Use `retryCounter` as a dependency in effects that need to re-trigger loading
+ * when the barrier's retry handler fires.
+ *
+ * @throws Error if used outside a `<LoadingBarrier>`
+ */
+export function useBarrierParticipant() {
+    const ctx = useContext(LoadingBarrierContext);
+    if (!ctx)
+        throw new Error('useBarrierParticipant must be used within a LoadingBarrier');
+    return ctx;
+}
+/**
+ * LoadingBarrier — Composite loading gate for dynamic views.
+ *
+ * Used when the set of loading dependencies is determined by children at
+ * render time (e.g., a dashboard with multiple independently-loaded cards,
+ * a side menu with multiple resource counts).
+ *
+ * Children self-register as participants via `useBarrierParticipant()`,
+ * then call `markReady()` or `markError()` when loaded. The barrier
+ * renders children invisibly (opacity 0, pointer-events none) until all
+ * participants are ready, then transitions to full visibility.
+ *
+ * @see loading-system-architecture.md §2.5 "LoadingBarrier"
+ */
+export function LoadingBarrier({ renderLoading, renderError, timeoutMs, children, }) {
+    const participantsRef = useRef(new Map());
+    const [, forceRender] = useState(0);
+    const [timedOut, setTimedOut] = useState(false);
+    const [retryCounter, setRetryCounter] = useState(0);
+    const mountTimeRef = useRef(Date.now());
+    // ── Participant registration ──────────────────────────────────────────
+    const register = useCallback((id) => {
+        if (!participantsRef.current.has(id)) {
+            participantsRef.current.set(id, { status: ParticipantStatus.PENDING });
+            forceRender(c => c + 1);
+        }
+        return {
+            markReady: () => {
+                const entry = participantsRef.current.get(id);
+                if (entry && entry.status !== ParticipantStatus.READY) {
+                    participantsRef.current.set(id, { status: ParticipantStatus.READY });
+                    forceRender(c => c + 1);
+                }
+            },
+            markError: (error) => {
+                const entry = participantsRef.current.get(id);
+                if (entry && entry.status !== ParticipantStatus.ERROR) {
+                    participantsRef.current.set(id, { status: ParticipantStatus.ERROR, error });
+                    forceRender(c => c + 1);
+                }
+            },
+            unregister: () => {
+                if (participantsRef.current.has(id)) {
+                    participantsRef.current.delete(id);
+                    forceRender(c => c + 1);
+                }
+            },
+        };
+    }, []);
+    // ── Derive aggregate state ────────────────────────────────────────────
+    const participants = participantsRef.current;
+    const hasParticipants = participants.size > 0;
+    const allReady = hasParticipants && Array.from(participants.values()).every(p => p.status === ParticipantStatus.READY);
+    const hasError = Array.from(participants.values()).some(p => p.status === ParticipantStatus.ERROR);
+    // ── Timeout handling ──────────────────────────────────────────────────
+    useEffect(() => {
+        if (allReady || !timeoutMs)
+            return;
+        const elapsed = Date.now() - mountTimeRef.current;
+        const remaining = timeoutMs - elapsed;
+        if (remaining <= 0) {
+            setTimedOut(true);
+            return;
+        }
+        const timer = setTimeout(() => setTimedOut(true), remaining);
+        return () => clearTimeout(timer);
+    }, [allReady, timeoutMs]);
+    useEffect(() => {
+        if (allReady)
+            setTimedOut(false);
+    }, [allReady]);
+    // ── Context value ─────────────────────────────────────────────────────
+    const contextValue = useMemo(() => ({ register, retryCounter }), [register, retryCounter]);
+    // ── Error state ───────────────────────────────────────────────────────
+    if ((timedOut || hasError) && renderError) {
+        const failedEntries = Array.from(participants.entries())
+            .filter(([, p]) => p.status !== ParticipantStatus.READY);
+        const failedScopes = failedEntries.map(([id]) => ({ customIdentifier: id }));
+        const firstError = failedEntries.find(([, p]) => p.error)?.[1]?.error;
+        return (_jsx(LoadingBarrierContext.Provider, { value: contextValue, children: renderError({
+                failedScopes,
+                reason: hasError ? 'error' : 'timeout',
+                error: firstError,
+                retry: () => {
+                    setTimedOut(false);
+                    mountTimeRef.current = Date.now();
+                    for (const [id] of participants) {
+                        participants.set(id, { status: ParticipantStatus.PENDING });
+                    }
+                    setRetryCounter(c => c + 1);
+                    forceRender(c => c + 1);
+                },
+            }) }));
+    }
+    // ── Render ────────────────────────────────────────────────────────────
+    const isLoading = !allReady;
+    return (_jsx(LoadingBarrierContext.Provider, { value: contextValue, children: _jsxs("div", { className: "relative", children: [_jsx("div", { style: {
+                        opacity: isLoading ? 0 : 1,
+                        pointerEvents: isLoading ? 'none' : 'auto',
+                        transition: 'opacity 200ms ease-out',
+                    }, "aria-hidden": isLoading, children: children }), isLoading && (_jsx("div", { className: "absolute inset-0 flex items-center justify-center", children: renderLoading ? renderLoading() : _jsx(LoadingSpinner, { size: 32 }) }))] }) }));
+}
+//# sourceMappingURL=LoadingBarrier.js.map

package/dist/esm/core/loading/LoadingBarrier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingBarrier.js","sourceRoot":"","sources":["../../../../src/core/loading/LoadingBarrier.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/loading/LoadingContext.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Loading Context — Event-Driven State Aggregator
+ *
+ * Central loading state management. Subscribes to loading events on the EventBus
+ * and maintains aggregate state for UI consumption.
+ *
+ * Architecture: EventBus → LoadingProvider (useReducer) → Context → Hooks
+ *
+ * Tier 1 (APPLICATION): Gates entire app — init, language change, org switch.
+ * Tier 2 (COMPONENT): Per-scope — resource lists, detail views, etc.
+ *
+ * @see .cursor/plans/loading-system-architecture.md
+ *
+ * ARCHITECTURE NOTE:
+ * This file exports the Provider component and context. Hooks are in separate files
+ * (useAppLoading.ts, useComponentLoading.ts, useLoading.ts) for React Fast Refresh
+ * compatibility — mixing components and hooks causes HMR invalidation loops.
+ */
+import React, { type ReactNode } from 'react';
+import { LoadingTier, LoadingPhase, type LoadingScope, type ComponentLoadingState, type LoadingSource } from './loading-types.frontend.schemas.js';
+export interface LoadingContextType {
+    isAppLoading: boolean;
+    appLoadingSources: LoadingSource[];
+    getComponentLoadingState: (scopeKey: string) => ComponentLoadingState | undefined;
+    hasLoadedOnce: (scopeKey: string, refreshThresholdMs?: number) => boolean;
+    markRendered: (scopeKey: string) => void;
+    /**
+     * Emit a loading start event via EventBus.
+     * State comes back through the subscription pipeline.
+     */
+    fireLoading: (scope: LoadingScope, options?: {
+        phase?: LoadingPhase;
+        tier?: LoadingTier;
+    }) => void;
+    /**
+     * Emit a loading end event via EventBus.
+     * Must pass the same tier used in fireLoading() — APPLICATION-tier loading
+     * won't be ended if tier is omitted (defaults to COMPONENT).
+     */
+    endLoading: (scope: LoadingScope, options?: {
+        tier?: LoadingTier;
+    }) => void;
+}
+/**
+ * @internal Use useLoading(), useAppLoading(), or useComponentLoading() hooks
+ */
+export declare const LoadingContext: React.Context<LoadingContextType | undefined>;
+export declare const LoadingProvider: React.FC<{
+    children: ReactNode;
+}>;
+//# sourceMappingURL=LoadingContext.d.ts.map

package/dist/esm/core/loading/LoadingContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingContext.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/LoadingContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,EAAsE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKlH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAkH1C,MAAM,WAAW,kBAAkB;IAEjC,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,aAAa,EAAE,CAAC;IAGnC,wBAAwB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;IAGlF,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1E,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;;OAGG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;IACnG;;;;OAIG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAA4D,CAAC;AAItI,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAwL7D,CAAC"}