@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.5

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingContext.js","sourceRoot":"","sources":["../../../../src/core/loading/LoadingContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Loading Context — Event-Driven State Aggregator\n *\n * Central loading state management. Subscribes to loading events on the EventBus\n * and maintains aggregate state for UI consumption.\n *\n * Architecture: EventBus → LoadingProvider (useReducer) → Context → Hooks\n *\n * Tier 1 (APPLICATION): Gates entire app — init, language change, org switch.\n * Tier 2 (COMPONENT): Per-scope — resource lists, detail views, etc.\n *\n * @see .cursor/plans/loading-system-architecture.md\n *\n * ARCHITECTURE NOTE:\n * This file exports the Provider component and context. Hooks are in separate files\n * (useAppLoading.ts, useComponentLoading.ts, useLoading.ts) for React Fast Refresh\n * compatibility — mixing components and hooks causes HMR invalidation loops.\n */\n\nimport React, { createContext, useReducer, useEffect, useRef, useCallback, useMemo, type ReactNode } from 'react';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport {\n  LoadingTier,\n  LoadingPhase,\n  type LoadingScope,\n  type ComponentLoadingState,\n  type LoadingSource,\n} from './loading-types.frontend.schemas';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('LoadingContext');\nlogger.setDebugTypeLogging('LoadingContext', false);\n\n// ─── Internal State ─────────────────────────────────────────────────────────\n\nenum LoadingActionType {\n  APP_LOADING_START = 'APP_LOADING_START',\n  APP_LOADING_END = 'APP_LOADING_END',\n  COMPONENT_LOADING_START = 'COMPONENT_LOADING_START',\n  COMPONENT_LOADING_END = 'COMPONENT_LOADING_END',\n}\n\ninterface LoadingInternalState {\n  appLoadingSources: Map<string, LoadingSource>;\n  componentLoadingMap: Map<string, ComponentLoadingState>;\n}\n\ntype LoadingAction =\n  | { type: LoadingActionType.APP_LOADING_START; identifier: string; source: LoadingSource }\n  | { type: LoadingActionType.APP_LOADING_END; identifier: string }\n  | { type: LoadingActionType.COMPONENT_LOADING_START; scopeKey: string; phase: LoadingPhase }\n  | { type: LoadingActionType.COMPONENT_LOADING_END; scopeKey: string };\n\nconst initialState: LoadingInternalState = {\n  appLoadingSources: new Map(),\n  componentLoadingMap: new Map(),\n};\n\n/**\n * IMPORTANT: Returns new Map instances on every mutation.\n * React detects state changes by reference equality — mutating a Map in place\n * returns the same reference and triggers no re-render.\n */\nfunction loadingReducer(state: LoadingInternalState, action: LoadingAction): LoadingInternalState {\n  switch (action.type) {\n    case LoadingActionType.APP_LOADING_START: {\n      const next = new Map(state.appLoadingSources);\n      next.set(action.identifier, action.source);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.APP_LOADING_END: {\n      const next = new Map(state.appLoadingSources);\n      next.delete(action.identifier);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_START: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      const activeCount = (existing?.activeCount ?? 0) + 1;\n      next.set(action.scopeKey, {\n        hasLoadedOnce: existing?.hasLoadedOnce ?? false,\n        isLoading: true,\n        phase: action.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_END: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      if (!existing) return state;\n      const activeCount = Math.max(0, existing.activeCount - 1);\n      next.set(action.scopeKey, {\n        hasLoadedOnce: true,\n        isLoading: activeCount > 0,\n        phase: existing.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    default:\n      return state;\n  }\n}\n\n// ─── LoadedOnce LRU Cache ───────────────────────────────────────────────────\n\n/**\n * Tracks data contexts that have been successfully loaded and rendered.\n * Used to distinguish initial loads from refreshes on re-visit.\n *\n * LRU eviction: oldest entries are evicted when cache exceeds maxEntries.\n * Map insertion order is exploited — delete+re-set moves entry to end.\n */\nclass LoadedOnceCache {\n  private cache = new Map<string, { lastRenderedAt: number }>();\n  private readonly maxEntries = 200;\n\n  has(scopeKey: string, refreshThresholdMs: number = 5 * 60 * 1000): boolean {\n    const entry = this.cache.get(scopeKey);\n    if (!entry) return false;\n    return (Date.now() - entry.lastRenderedAt) < refreshThresholdMs;\n  }\n\n  set(scopeKey: string): void {\n    this.cache.delete(scopeKey);\n    this.cache.set(scopeKey, { lastRenderedAt: Date.now() });\n    if (this.cache.size > this.maxEntries) {\n      const oldest = this.cache.keys().next().value;\n      if (oldest !== undefined) this.cache.delete(oldest);\n    }\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n// ─── Context Type ───────────────────────────────────────────────────────────\n\nexport interface LoadingContextType {\n  // Tier 1 read-only state\n  isAppLoading: boolean;\n  appLoadingSources: LoadingSource[];\n\n  // Tier 2 state access\n  getComponentLoadingState: (scopeKey: string) => ComponentLoadingState | undefined;\n\n  // hasLoadedOnce cache access\n  hasLoadedOnce: (scopeKey: string, refreshThresholdMs?: number) => boolean;\n  markRendered: (scopeKey: string) => void;\n\n  /**\n   * Emit a loading start event via EventBus.\n   * State comes back through the subscription pipeline.\n   */\n  fireLoading: (scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => void;\n  /**\n   * Emit a loading end event via EventBus.\n   * Must pass the same tier used in fireLoading() — APPLICATION-tier loading\n   * won't be ended if tier is omitted (defaults to COMPONENT).\n   */\n  endLoading: (scope: LoadingScope, options?: { tier?: LoadingTier }) => void;\n}\n\n/**\n * @internal Use useLoading(), useAppLoading(), or useComponentLoading() hooks\n */\nexport const LoadingContext: React.Context<LoadingContextType | undefined> = createContext<LoadingContextType | undefined>(undefined);\n\n// ─── Provider ───────────────────────────────────────────────────────────────\n\nexport const LoadingProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const [state, dispatch] = useReducer(loadingReducer, initialState);\n  const loadedOnceCacheRef = useRef(new LoadedOnceCache());\n\n  useEffect(() => {\n    const identifiers = Array.from(state.appLoadingSources.keys());\n    logDebug(`App loading state: ${state.appLoadingSources.size > 0 ? 'loading' : 'ready'} [${identifiers.join(', ') || 'none'}]`);\n  }, [state.appLoadingSources]);\n\n  // ── Subscribe to loading events ──────────────────────────────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_START, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: scopeKey, source: { identifier: scopeKey, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_END, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: scopeKey });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_START, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: payload.identifier, source: { identifier: payload.identifier, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey: `custom:${payload.identifier}`, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_END, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: payload.identifier });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey: `custom:${payload.identifier}` });\n        }\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── Global clear events — invalidate hasLoadedOnce cache ─────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n        if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS) {\n          loadedOnceCacheRef.current.clear();\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.AUTH_LOGOUT_REQUIRED, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.WHOLE_APP_REFRESH, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── New API methods ──────────────────────────────────────────────────────\n\n  const getComponentLoadingState = useCallback(\n    (scopeKey: string): ComponentLoadingState | undefined => state.componentLoadingMap.get(scopeKey),\n    [state.componentLoadingMap]\n  );\n\n  const hasLoadedOnce = useCallback(\n    (scopeKey: string, refreshThresholdMs?: number): boolean => loadedOnceCacheRef.current.has(scopeKey, refreshThresholdMs),\n    []\n  );\n\n  const markRendered = useCallback(\n    (scopeKey: string): void => loadedOnceCacheRef.current.set(scopeKey),\n    []\n  );\n\n  const fireLoading = useCallback((scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_START, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_START, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    }\n  }, []);\n\n  const endLoading = useCallback((scope: LoadingScope, options?: { tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_END, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_END, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n      });\n    }\n  }, []);\n\n  // ── Build context value ──────────────────────────────────────────────────\n\n  const value: LoadingContextType = useMemo(() => ({\n    isAppLoading: state.appLoadingSources.size > 0,\n    appLoadingSources: Array.from(state.appLoadingSources.values()),\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  }), [\n    state.appLoadingSources,\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  ]);\n\n  return <LoadingContext.Provider value={value}>{children}</LoadingContext.Provider>;\n};\n"]}
+{"version":3,"file":"LoadingContext.js","sourceRoot":"","sources":["../../../../../src/core/loading/LoadingContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Loading Context — Event-Driven State Aggregator\n *\n * Central loading state management. Subscribes to loading events on the EventBus\n * and maintains aggregate state for UI consumption.\n *\n * Architecture: EventBus → LoadingProvider (useReducer) → Context → Hooks\n *\n * Tier 1 (APPLICATION): Gates entire app — init, language change, org switch.\n * Tier 2 (COMPONENT): Per-scope — resource lists, detail views, etc.\n *\n * @see .cursor/plans/loading-system-architecture.md\n *\n * ARCHITECTURE NOTE:\n * This file exports the Provider component and context. Hooks are in separate files\n * (useAppLoading.ts, useComponentLoading.ts, useLoading.ts) for React Fast Refresh\n * compatibility — mixing components and hooks causes HMR invalidation loops.\n */\n\nimport React, { createContext, useReducer, useEffect, useRef, useCallback, useMemo, type ReactNode } from 'react';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport {\n  LoadingTier,\n  LoadingPhase,\n  type LoadingScope,\n  type ComponentLoadingState,\n  type LoadingSource,\n} from './loading-types.frontend.schemas';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('LoadingContext');\nlogger.setDebugTypeLogging('LoadingContext', false);\n\n// ─── Internal State ─────────────────────────────────────────────────────────\n\nenum LoadingActionType {\n  APP_LOADING_START = 'APP_LOADING_START',\n  APP_LOADING_END = 'APP_LOADING_END',\n  COMPONENT_LOADING_START = 'COMPONENT_LOADING_START',\n  COMPONENT_LOADING_END = 'COMPONENT_LOADING_END',\n}\n\ninterface LoadingInternalState {\n  appLoadingSources: Map<string, LoadingSource>;\n  componentLoadingMap: Map<string, ComponentLoadingState>;\n}\n\ntype LoadingAction =\n  | { type: LoadingActionType.APP_LOADING_START; identifier: string; source: LoadingSource }\n  | { type: LoadingActionType.APP_LOADING_END; identifier: string }\n  | { type: LoadingActionType.COMPONENT_LOADING_START; scopeKey: string; phase: LoadingPhase }\n  | { type: LoadingActionType.COMPONENT_LOADING_END; scopeKey: string };\n\nconst initialState: LoadingInternalState = {\n  appLoadingSources: new Map(),\n  componentLoadingMap: new Map(),\n};\n\n/**\n * IMPORTANT: Returns new Map instances on every mutation.\n * React detects state changes by reference equality — mutating a Map in place\n * returns the same reference and triggers no re-render.\n */\nfunction loadingReducer(state: LoadingInternalState, action: LoadingAction): LoadingInternalState {\n  switch (action.type) {\n    case LoadingActionType.APP_LOADING_START: {\n      const next = new Map(state.appLoadingSources);\n      next.set(action.identifier, action.source);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.APP_LOADING_END: {\n      const next = new Map(state.appLoadingSources);\n      next.delete(action.identifier);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_START: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      const activeCount = (existing?.activeCount ?? 0) + 1;\n      next.set(action.scopeKey, {\n        hasLoadedOnce: existing?.hasLoadedOnce ?? false,\n        isLoading: true,\n        phase: action.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_END: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      if (!existing) return state;\n      const activeCount = Math.max(0, existing.activeCount - 1);\n      next.set(action.scopeKey, {\n        hasLoadedOnce: true,\n        isLoading: activeCount > 0,\n        phase: existing.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    default:\n      return state;\n  }\n}\n\n// ─── LoadedOnce LRU Cache ───────────────────────────────────────────────────\n\n/**\n * Tracks data contexts that have been successfully loaded and rendered.\n * Used to distinguish initial loads from refreshes on re-visit.\n *\n * LRU eviction: oldest entries are evicted when cache exceeds maxEntries.\n * Map insertion order is exploited — delete+re-set moves entry to end.\n */\nclass LoadedOnceCache {\n  private cache = new Map<string, { lastRenderedAt: number }>();\n  private readonly maxEntries = 200;\n\n  has(scopeKey: string, refreshThresholdMs: number = 5 * 60 * 1000): boolean {\n    const entry = this.cache.get(scopeKey);\n    if (!entry) return false;\n    return (Date.now() - entry.lastRenderedAt) < refreshThresholdMs;\n  }\n\n  set(scopeKey: string): void {\n    this.cache.delete(scopeKey);\n    this.cache.set(scopeKey, { lastRenderedAt: Date.now() });\n    if (this.cache.size > this.maxEntries) {\n      const oldest = this.cache.keys().next().value;\n      if (oldest !== undefined) this.cache.delete(oldest);\n    }\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n// ─── Context Type ───────────────────────────────────────────────────────────\n\nexport interface LoadingContextType {\n  // Tier 1 read-only state\n  isAppLoading: boolean;\n  appLoadingSources: LoadingSource[];\n\n  // Tier 2 state access\n  getComponentLoadingState: (scopeKey: string) => ComponentLoadingState | undefined;\n\n  // hasLoadedOnce cache access\n  hasLoadedOnce: (scopeKey: string, refreshThresholdMs?: number) => boolean;\n  markRendered: (scopeKey: string) => void;\n\n  /**\n   * Emit a loading start event via EventBus.\n   * State comes back through the subscription pipeline.\n   */\n  fireLoading: (scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => void;\n  /**\n   * Emit a loading end event via EventBus.\n   * Must pass the same tier used in fireLoading() — APPLICATION-tier loading\n   * won't be ended if tier is omitted (defaults to COMPONENT).\n   */\n  endLoading: (scope: LoadingScope, options?: { tier?: LoadingTier }) => void;\n}\n\n/**\n * @internal Use useLoading(), useAppLoading(), or useComponentLoading() hooks\n */\nexport const LoadingContext: React.Context<LoadingContextType | undefined> = createContext<LoadingContextType | undefined>(undefined);\n\n// ─── Provider ───────────────────────────────────────────────────────────────\n\nexport const LoadingProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const [state, dispatch] = useReducer(loadingReducer, initialState);\n  const loadedOnceCacheRef = useRef(new LoadedOnceCache());\n\n  useEffect(() => {\n    const identifiers = Array.from(state.appLoadingSources.keys());\n    logDebug(`App loading state: ${state.appLoadingSources.size > 0 ? 'loading' : 'ready'} [${identifiers.join(', ') || 'none'}]`);\n  }, [state.appLoadingSources]);\n\n  // ── Subscribe to loading events ──────────────────────────────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_START, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: scopeKey, source: { identifier: scopeKey, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_END, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: scopeKey });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_START, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: payload.identifier, source: { identifier: payload.identifier, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey: `custom:${payload.identifier}`, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_END, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: payload.identifier });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey: `custom:${payload.identifier}` });\n        }\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── Global clear events — invalidate hasLoadedOnce cache ─────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n        if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS) {\n          loadedOnceCacheRef.current.clear();\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.AUTH_LOGOUT_REQUIRED, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.WHOLE_APP_REFRESH, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── New API methods ──────────────────────────────────────────────────────\n\n  const getComponentLoadingState = useCallback(\n    (scopeKey: string): ComponentLoadingState | undefined => state.componentLoadingMap.get(scopeKey),\n    [state.componentLoadingMap]\n  );\n\n  const hasLoadedOnce = useCallback(\n    (scopeKey: string, refreshThresholdMs?: number): boolean => loadedOnceCacheRef.current.has(scopeKey, refreshThresholdMs),\n    []\n  );\n\n  const markRendered = useCallback(\n    (scopeKey: string): void => loadedOnceCacheRef.current.set(scopeKey),\n    []\n  );\n\n  const fireLoading = useCallback((scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_START, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_START, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    }\n  }, []);\n\n  const endLoading = useCallback((scope: LoadingScope, options?: { tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_END, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_END, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n      });\n    }\n  }, []);\n\n  // ── Build context value ──────────────────────────────────────────────────\n\n  const value: LoadingContextType = useMemo(() => ({\n    isAppLoading: state.appLoadingSources.size > 0,\n    appLoadingSources: Array.from(state.appLoadingSources.values()),\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  }), [\n    state.appLoadingSources,\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  ]);\n\n  return <LoadingContext.Provider value={value}>{children}</LoadingContext.Provider>;\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingGate.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/LoadingGate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAyB,MAAM,kCAAkC,CAAC;AAWtJ,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,4DAA4D;IAC5D,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,SAAS,CAAC;IAC7D,0DAA0D;IAC1D,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,CAAC;IAC1D,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAwBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAC1B,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6MtC"}
+{"version":3,"file":"LoadingGate.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/LoadingGate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAyB,MAAM,kCAAkC,CAAC;AAWtJ,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,4DAA4D;IAC5D,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,SAAS,CAAC;IAC7D,0DAA0D;IAC1D,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,CAAC;IAC1D,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AA+BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAC1B,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0OtC"}

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

@@ -29,6 +29,12 @@ function resolveSurfaceLoadingPolicy(value) {
             return undefined;
     }
 }
+/** Treatments that render the gate's children while loading — the ones a remount would cost something under. */
+const CHILD_KEEPING_TREATMENTS = new Set([
+    LoadingTreatment.OPACITY_OVERLAY,
+    LoadingTreatment.HIDDEN,
+    LoadingTreatment.INVISIBLE,
+]);
 /**
  * LoadingGate — Universal gating component for loading dependencies.
  *
@@ -147,13 +153,40 @@ export function LoadingGate({ loadingScopes, i18nKeys, readiness, policy, render
             }) }));
     }
     // ── Ready — render children ─────────────────────────────────────────────
+    const refreshTreatment = effectivePolicy?.refresh ?? LoadingTreatment.OPACITY_OVERLAY;
+    const initialTreatment = effectivePolicy?.initialLoad ?? LoadingTreatment.SKELETON;
+    /*
+     * ONE WRAPPER ACROSS THE TRANSITION, for every treatment that keeps the children on screen.
+     *
+     * React keeps a subtree's state only while its parent is the same element TYPE at the same
+     * position. The ready branch returned a fragment and `OPACITY_OVERLAY` / `HIDDEN` / `INVISIBLE`
+     * returned a `<div>`, so every passage between them — the end of a load, and the start AND end of
+     * every refresh — unmounted the whole surface and mounted a new one. Everything a reader had set
+     * inside it went with it: the selected tab, an open accordion, the scroll position.
+     *
+     * Measured 2026-09-21 on the workbench's actor-task modal, whose READ takes ~3 s: a tab clicked
+     * during the load was reset to the first one when the record arrived, and the replaced ancestor
+     * was this gate's own `relative` overlay wrapper. It presented as "the Conversation tab does not
+     * work", three layers away from the cause.
+     *
+     * So a gate whose policy CAN keep its children renders the same `<div>` in both states and only
+     * its class moves. Ready is `display: contents`, which leaves the children laid out exactly as
+     * the fragment did — flex items, grid items and `h-full` chains all survive, which a block
+     * wrapper would break in the state a surface spends its life in. Rejected alternative: keeping
+     * the fragment and floating the overlay beside the children, which leaves the overlay with no
+     * positioned box of its own to cover.
+     *
+     * A gate whose policy never keeps children (skeleton / spinner / full screen in both phases) has
+     * nothing to preserve and keeps the bare fragment.
+     */
+    const keepsChildrenWhileLoading = CHILD_KEEPING_TREATMENTS.has(refreshTreatment) || CHILD_KEEPING_TREATMENTS.has(initialTreatment);
     if (allReady) {
-        return _jsx(_Fragment, { children: children });
+        return keepsChildrenWhileLoading
+            ? _jsx("div", { className: "contents", "data-loading-gate": "ready", children: children })
+            : _jsx(_Fragment, { children: children });
     }
     // ── Not ready — render loading treatment ────────────────────────────────
-    const treatment = phase === LoadingPhase.REFRESH
-        ? (effectivePolicy?.refresh ?? LoadingTreatment.OPACITY_OVERLAY)
-        : (effectivePolicy?.initialLoad ?? LoadingTreatment.SKELETON);
+    const treatment = phase === LoadingPhase.REFRESH ? refreshTreatment : initialTreatment;
     const renderContext = {
         phase,
         scope: scopeStates[0]?.scope ?? { customIdentifier: 'loading-gate' },
@@ -179,11 +212,12 @@ export function LoadingGate({ loadingScopes, i18nKeys, readiness, policy, render
         case LoadingTreatment.SPINNER:
             return (_jsx("div", { className: "flex items-center justify-center py-8", children: _jsx(LoadingSpinner, { size: 32 }) }));
         case LoadingTreatment.OPACITY_OVERLAY:
-            return (_jsxs("div", { className: "relative", children: [children, _jsx(LoadingOverlay, {})] }));
+            // `{children}` stays the FIRST child of the same `<div>` as the ready branch — see above.
+            return (_jsxs("div", { className: "relative", "data-loading-gate": "loading", children: [children, _jsx(LoadingOverlay, {})] }));
         case LoadingTreatment.HIDDEN:
-            return _jsx("div", { style: { display: 'none' }, children: children });
+            return _jsx("div", { style: { display: 'none' }, "data-loading-gate": "loading", children: children });
         case LoadingTreatment.INVISIBLE:
-            return _jsx("div", { style: { visibility: 'hidden' }, children: children });
+            return _jsx("div", { style: { visibility: 'hidden' }, "data-loading-gate": "loading", children: children });
         case LoadingTreatment.FULL_SCREEN:
             return (_jsx("div", { className: "fixed inset-0 z-(--z-critical) flex items-center justify-center bg-background/80", children: _jsx(LoadingSpinner, { size: 48 }) }));
         default:

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingGate.js","sourceRoot":"","sources":["../../../../src/core/loading/LoadingGate.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { LoadingScope, LoadingPolicy, LoadingRenderContext, LoadingErrorContext, ComponentLoadingState } from './loading-types.frontend.schemas';\nimport { LoadingTreatment, LoadingPhase } from './loading-types.frontend.schemas';\nimport { LoadingContext } from './LoadingContext';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { LoadingOverlay } from '~wildo-frontend-lib/components/feedback/loading-overlay';\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useSurfacePolicy } from '~wildo-frontend-lib/core/ui/SurfacePolicyContext';\nimport type { LoadingDisplayMode } from '@wildo-ai/presets-components-models';\n\nexport interface LoadingGateProps {\n  /** Loading scopes to wait for — each scope is tracked independently */\n  loadingScopes?: LoadingScope[];\n  /** i18n dot-path keys that must be loaded before rendering children */\n  i18nKeys?: string[];\n  /** Custom readiness signals — all must be `true` for the gate to open */\n  readiness?: Array<{ id: string; isReady: boolean }>;\n  /** Loading policy determining visual treatment per phase */\n  policy?: LoadingPolicy;\n  /** Custom loading renderer — called for CUSTOM and SKELETON treatments */\n  renderLoading?: (context: LoadingRenderContext) => ReactNode;\n  /** Error renderer — called on timeout or loading error */\n  renderError?: (context: LoadingErrorContext) => ReactNode;\n  /** Timeout in ms after which the gate shows an error state. Default: no timeout. */\n  timeoutMs?: number;\n  children: ReactNode;\n}\n\nfunction resolveSurfaceLoadingPolicy(value: LoadingDisplayMode | string | undefined): LoadingPolicy | undefined {\n  switch (value) {\n    case 'overlay':\n      return {\n        initialLoad: LoadingTreatment.OPACITY_OVERLAY,\n        refresh: LoadingTreatment.OPACITY_OVERLAY,\n      };\n    case 'spinner-only':\n      return {\n        initialLoad: LoadingTreatment.SPINNER,\n        refresh: LoadingTreatment.SPINNER,\n      };\n    case 'skeleton-children':\n      return {\n        initialLoad: LoadingTreatment.SKELETON,\n        refresh: LoadingTreatment.OPACITY_OVERLAY,\n      };\n    default:\n      return undefined;\n  }\n}\n\n/**\n * LoadingGate — Universal gating component for loading dependencies.\n *\n * Waits for all specified dependencies (loading scopes, i18n keys, custom\n * readiness signals) before rendering children. While waiting, renders the\n * appropriate visual treatment based on the loading policy.\n *\n * Explicit `policy` props win first. When absent, the enclosing surface policy\n * chooses the default treatment: BASE-style surfaces skeleton, OVERLAY surfaces\n * overlay children, and TRANSIENT surfaces use a spinner-only affordance.\n *\n * @see loading-system-architecture.md §2.5\n */\nexport function LoadingGate({\n  loadingScopes,\n  i18nKeys,\n  readiness,\n  policy,\n  renderLoading,\n  renderError,\n  timeoutMs,\n  children,\n}: LoadingGateProps): React.JSX.Element {\n  if (process.env.NODE_ENV !== 'production' && timeoutMs && !renderError) {\n    console.warn('[LoadingGate] timeoutMs is set without renderError — timeout will have no visible effect. Provide renderError to surface timeout failures.');\n  }\n\n  const context = useContext(LoadingContext);\n  if (!context) throw new Error('LoadingGate must be used within a LoadingProvider');\n\n  const surfacePolicy = useSurfacePolicy();\n  const effectivePolicy = policy ?? resolveSurfaceLoadingPolicy(surfacePolicy.interactiveState?.loadingDisplay);\n\n  const i18nDeps = useMemo(() => ({ keys: i18nKeys ?? [] }), [i18nKeys]);\n  const { requestKeys, isKeySettled, isReady } = useI18n(i18nDeps);\n\n  // ── Loading scope states ─────────────────────────────────────────────────\n\n  const scopeStates = useMemo(() => {\n    if (!loadingScopes?.length) return [];\n    return loadingScopes.map(scope => {\n      const key = buildLoadingScopeKey(scope);\n      const state: ComponentLoadingState | undefined = context.getComponentLoadingState(key);\n      const isLoading = state?.isLoading ?? false;\n      const hasLoadedOnce = context.hasLoadedOnce(key);\n      return { scope, key, isLoading, hasLoadedOnce };\n    });\n  }, [loadingScopes, context]);\n\n  const loadingScopesReady = scopeStates.length === 0 || scopeStates.every(s => !s.isLoading);\n\n  // ── i18n key readiness ──────────────────────────────────────────────────\n\n  useEffect(() => {\n    if (i18nKeys?.length) {\n      /*\n       * Fire-and-forget, so the rejection is observed here. `requestKeys` rejects when the bundle\n       * fetch fails; with nobody awaiting it that reaches the window as an unhandled rejection,\n       * while saying nothing new — `flushBatch` already reported the failure once and settled the\n       * keys. The gate below reads that settled state.\n       */\n      void requestKeys(i18nKeys).catch(() => undefined);\n    }\n  }, [i18nKeys, requestKeys]);\n\n  /*\n   * SETTLED, not loaded — the same distinction `useI18n.isReady` makes, and for the same reason.\n   * `isKeyLoaded` stays false forever for a key whose bundle failed, so gating on it turned one\n   * failed request into a gate that never opens: a permanent spinner in place of the content. A\n   * settled-but-failed key opens the gate and the label lookup reports the label as missing, which\n   * is visible and correct, rather than hiding the whole surface behind a loader.\n   */\n  const i18nReady = !i18nKeys?.length || i18nKeys.every(k => isKeySettled(k));\n\n  // ── Custom readiness signals ────────────────────────────────────────────\n\n  const customReady = !readiness?.length || readiness.every(r => r.isReady);\n\n  // ── Combined readiness ──────────────────────────────────────────────────\n\n  const allReady = loadingScopesReady && i18nReady && customReady;\n\n  // ── Determine loading phase ─────────────────────────────────────────────\n\n  const phase = useMemo(() => {\n    if (scopeStates.some(s => s.isLoading && !s.hasLoadedOnce)) return LoadingPhase.INITIAL;\n    if (scopeStates.some(s => s.isLoading && s.hasLoadedOnce)) return LoadingPhase.REFRESH;\n    return LoadingPhase.INITIAL;\n  }, [scopeStates]);\n\n  // ── Timeout handling ────────────────────────────────────────────────────\n\n  const [timedOut, setTimedOut] = useState(false);\n  const loadingStartRef = useRef<number | null>(null);\n\n  useEffect(() => {\n    if (allReady) {\n      loadingStartRef.current = null;\n      setTimedOut(false);\n      return;\n    }\n\n    if (!loadingStartRef.current) {\n      loadingStartRef.current = Date.now();\n    }\n\n    if (!timeoutMs) return;\n\n    const elapsed = Date.now() - loadingStartRef.current;\n    const remaining = timeoutMs - elapsed;\n\n    if (remaining <= 0) {\n      setTimedOut(true);\n      return;\n    }\n\n    const timer = setTimeout(() => setTimedOut(true), remaining);\n    return () => clearTimeout(timer);\n  }, [allReady, timeoutMs]);\n\n  // ── Mark rendered on first ready ────────────────────────────────────────\n\n  const hasMarkedRef = useRef(false);\n\n  useEffect(() => {\n    if (allReady && !hasMarkedRef.current && loadingScopes?.length) {\n      hasMarkedRef.current = true;\n      for (const scope of loadingScopes) {\n        context.markRendered(buildLoadingScopeKey(scope));\n      }\n    }\n    if (!allReady) {\n      hasMarkedRef.current = false;\n    }\n  }, [allReady, loadingScopes, context]);\n\n  // ── Timeout error state ─────────────────────────────────────────────────\n\n  if (timedOut && renderError) {\n    const failedScopes = scopeStates.filter(s => s.isLoading).map(s => s.scope);\n    return (\n      <>\n        {renderError({\n          failedScopes,\n          reason: 'timeout',\n          retry: () => {\n            setTimedOut(false);\n            loadingStartRef.current = Date.now();\n          },\n        })}\n      </>\n    );\n  }\n\n  // ── Ready — render children ─────────────────────────────────────────────\n\n  if (allReady) {\n    return <>{children}</>;\n  }\n\n  // ── Not ready — render loading treatment ────────────────────────────────\n\n  const treatment = phase === LoadingPhase.REFRESH\n    ? (effectivePolicy?.refresh ?? LoadingTreatment.OPACITY_OVERLAY)\n    : (effectivePolicy?.initialLoad ?? LoadingTreatment.SKELETON);\n\n  const renderContext: LoadingRenderContext = {\n    phase,\n    scope: scopeStates[0]?.scope ?? { customIdentifier: 'loading-gate' },\n  };\n\n  switch (treatment) {\n    case LoadingTreatment.CUSTOM:\n      return <>{renderLoading?.(renderContext) ?? children}</>;\n\n    case LoadingTreatment.SKELETON:\n      /*\n       * The live region wraps a CUSTOM silhouette too.\n       *\n       * `renderLoading` used to return early, so a surface that drew its own skeleton — which is the\n       * surface that most needs one, since it draws a whole collection — silently lost the `role=status`\n       * announcement and the screen-reader \"Loading\" text. Supplying a better SHAPE should not cost the\n       * assistive channel; the two are independent, and only the shape was ever being overridden.\n       *\n       * `CUSTOM` is different and still hands over everything: it means \"this treatment is not a\n       * skeleton at all\", so the caller owns the semantics as well as the pixels.\n       */\n      return (\n        <div role=\"status\" aria-live=\"polite\">\n          <span className=\"sr-only\">Loading</span>\n          {renderLoading\n            ? renderLoading(renderContext)\n            : <Skeleton template=\"auto\" density=\"auto\" aria-hidden=\"true\" />}\n        </div>\n      );\n\n    case LoadingTreatment.SPINNER:\n      return (\n        <div className=\"flex items-center justify-center py-8\">\n          <LoadingSpinner size={32} />\n        </div>\n      );\n\n    case LoadingTreatment.OPACITY_OVERLAY:\n      return (\n        <div className=\"relative\">\n          {children}\n          <LoadingOverlay />\n        </div>\n      );\n\n    case LoadingTreatment.HIDDEN:\n      return <div style={{ display: 'none' }}>{children}</div>;\n\n    case LoadingTreatment.INVISIBLE:\n      return <div style={{ visibility: 'hidden' }}>{children}</div>;\n\n    case LoadingTreatment.FULL_SCREEN:\n      return (\n        <div className=\"fixed inset-0 z-(--z-critical) flex items-center justify-center bg-background/80\">\n          <LoadingSpinner size={48} />\n        </div>\n      );\n\n    default:\n      return <>{children}</>;\n  }\n}\n"]}
+{"version":3,"file":"LoadingGate.js","sourceRoot":"","sources":["../../../../../src/core/loading/LoadingGate.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { LoadingScope, LoadingPolicy, LoadingRenderContext, LoadingErrorContext, ComponentLoadingState } from './loading-types.frontend.schemas';\nimport { LoadingTreatment, LoadingPhase } from './loading-types.frontend.schemas';\nimport { LoadingContext } from './LoadingContext';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { LoadingOverlay } from '~wildo-frontend-lib/components/feedback/loading-overlay';\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useSurfacePolicy } from '~wildo-frontend-lib/core/ui/SurfacePolicyContext';\nimport type { LoadingDisplayMode } from '@wildo-ai/presets-components-models';\n\nexport interface LoadingGateProps {\n  /** Loading scopes to wait for — each scope is tracked independently */\n  loadingScopes?: LoadingScope[];\n  /** i18n dot-path keys that must be loaded before rendering children */\n  i18nKeys?: string[];\n  /** Custom readiness signals — all must be `true` for the gate to open */\n  readiness?: Array<{ id: string; isReady: boolean }>;\n  /** Loading policy determining visual treatment per phase */\n  policy?: LoadingPolicy;\n  /** Custom loading renderer — called for CUSTOM and SKELETON treatments */\n  renderLoading?: (context: LoadingRenderContext) => ReactNode;\n  /** Error renderer — called on timeout or loading error */\n  renderError?: (context: LoadingErrorContext) => ReactNode;\n  /** Timeout in ms after which the gate shows an error state. Default: no timeout. */\n  timeoutMs?: number;\n  children: ReactNode;\n}\n\nfunction resolveSurfaceLoadingPolicy(value: LoadingDisplayMode | string | undefined): LoadingPolicy | undefined {\n  switch (value) {\n    case 'overlay':\n      return {\n        initialLoad: LoadingTreatment.OPACITY_OVERLAY,\n        refresh: LoadingTreatment.OPACITY_OVERLAY,\n      };\n    case 'spinner-only':\n      return {\n        initialLoad: LoadingTreatment.SPINNER,\n        refresh: LoadingTreatment.SPINNER,\n      };\n    case 'skeleton-children':\n      return {\n        initialLoad: LoadingTreatment.SKELETON,\n        refresh: LoadingTreatment.OPACITY_OVERLAY,\n      };\n    default:\n      return undefined;\n  }\n}\n\n/** Treatments that render the gate's children while loading — the ones a remount would cost something under. */\nconst CHILD_KEEPING_TREATMENTS: ReadonlySet<LoadingTreatment> = new Set([\n  LoadingTreatment.OPACITY_OVERLAY,\n  LoadingTreatment.HIDDEN,\n  LoadingTreatment.INVISIBLE,\n]);\n\n/**\n * LoadingGate — Universal gating component for loading dependencies.\n *\n * Waits for all specified dependencies (loading scopes, i18n keys, custom\n * readiness signals) before rendering children. While waiting, renders the\n * appropriate visual treatment based on the loading policy.\n *\n * Explicit `policy` props win first. When absent, the enclosing surface policy\n * chooses the default treatment: BASE-style surfaces skeleton, OVERLAY surfaces\n * overlay children, and TRANSIENT surfaces use a spinner-only affordance.\n *\n * @see loading-system-architecture.md §2.5\n */\nexport function LoadingGate({\n  loadingScopes,\n  i18nKeys,\n  readiness,\n  policy,\n  renderLoading,\n  renderError,\n  timeoutMs,\n  children,\n}: LoadingGateProps): React.JSX.Element {\n  if (process.env.NODE_ENV !== 'production' && timeoutMs && !renderError) {\n    console.warn('[LoadingGate] timeoutMs is set without renderError — timeout will have no visible effect. Provide renderError to surface timeout failures.');\n  }\n\n  const context = useContext(LoadingContext);\n  if (!context) throw new Error('LoadingGate must be used within a LoadingProvider');\n\n  const surfacePolicy = useSurfacePolicy();\n  const effectivePolicy = policy ?? resolveSurfaceLoadingPolicy(surfacePolicy.interactiveState?.loadingDisplay);\n\n  const i18nDeps = useMemo(() => ({ keys: i18nKeys ?? [] }), [i18nKeys]);\n  const { requestKeys, isKeySettled, isReady } = useI18n(i18nDeps);\n\n  // ── Loading scope states ─────────────────────────────────────────────────\n\n  const scopeStates = useMemo(() => {\n    if (!loadingScopes?.length) return [];\n    return loadingScopes.map(scope => {\n      const key = buildLoadingScopeKey(scope);\n      const state: ComponentLoadingState | undefined = context.getComponentLoadingState(key);\n      const isLoading = state?.isLoading ?? false;\n      const hasLoadedOnce = context.hasLoadedOnce(key);\n      return { scope, key, isLoading, hasLoadedOnce };\n    });\n  }, [loadingScopes, context]);\n\n  const loadingScopesReady = scopeStates.length === 0 || scopeStates.every(s => !s.isLoading);\n\n  // ── i18n key readiness ──────────────────────────────────────────────────\n\n  useEffect(() => {\n    if (i18nKeys?.length) {\n      /*\n       * Fire-and-forget, so the rejection is observed here. `requestKeys` rejects when the bundle\n       * fetch fails; with nobody awaiting it that reaches the window as an unhandled rejection,\n       * while saying nothing new — `flushBatch` already reported the failure once and settled the\n       * keys. The gate below reads that settled state.\n       */\n      void requestKeys(i18nKeys).catch(() => undefined);\n    }\n  }, [i18nKeys, requestKeys]);\n\n  /*\n   * SETTLED, not loaded — the same distinction `useI18n.isReady` makes, and for the same reason.\n   * `isKeyLoaded` stays false forever for a key whose bundle failed, so gating on it turned one\n   * failed request into a gate that never opens: a permanent spinner in place of the content. A\n   * settled-but-failed key opens the gate and the label lookup reports the label as missing, which\n   * is visible and correct, rather than hiding the whole surface behind a loader.\n   */\n  const i18nReady = !i18nKeys?.length || i18nKeys.every(k => isKeySettled(k));\n\n  // ── Custom readiness signals ────────────────────────────────────────────\n\n  const customReady = !readiness?.length || readiness.every(r => r.isReady);\n\n  // ── Combined readiness ──────────────────────────────────────────────────\n\n  const allReady = loadingScopesReady && i18nReady && customReady;\n\n  // ── Determine loading phase ─────────────────────────────────────────────\n\n  const phase = useMemo(() => {\n    if (scopeStates.some(s => s.isLoading && !s.hasLoadedOnce)) return LoadingPhase.INITIAL;\n    if (scopeStates.some(s => s.isLoading && s.hasLoadedOnce)) return LoadingPhase.REFRESH;\n    return LoadingPhase.INITIAL;\n  }, [scopeStates]);\n\n  // ── Timeout handling ────────────────────────────────────────────────────\n\n  const [timedOut, setTimedOut] = useState(false);\n  const loadingStartRef = useRef<number | null>(null);\n\n  useEffect(() => {\n    if (allReady) {\n      loadingStartRef.current = null;\n      setTimedOut(false);\n      return;\n    }\n\n    if (!loadingStartRef.current) {\n      loadingStartRef.current = Date.now();\n    }\n\n    if (!timeoutMs) return;\n\n    const elapsed = Date.now() - loadingStartRef.current;\n    const remaining = timeoutMs - elapsed;\n\n    if (remaining <= 0) {\n      setTimedOut(true);\n      return;\n    }\n\n    const timer = setTimeout(() => setTimedOut(true), remaining);\n    return () => clearTimeout(timer);\n  }, [allReady, timeoutMs]);\n\n  // ── Mark rendered on first ready ────────────────────────────────────────\n\n  const hasMarkedRef = useRef(false);\n\n  useEffect(() => {\n    if (allReady && !hasMarkedRef.current && loadingScopes?.length) {\n      hasMarkedRef.current = true;\n      for (const scope of loadingScopes) {\n        context.markRendered(buildLoadingScopeKey(scope));\n      }\n    }\n    if (!allReady) {\n      hasMarkedRef.current = false;\n    }\n  }, [allReady, loadingScopes, context]);\n\n  // ── Timeout error state ─────────────────────────────────────────────────\n\n  if (timedOut && renderError) {\n    const failedScopes = scopeStates.filter(s => s.isLoading).map(s => s.scope);\n    return (\n      <>\n        {renderError({\n          failedScopes,\n          reason: 'timeout',\n          retry: () => {\n            setTimedOut(false);\n            loadingStartRef.current = Date.now();\n          },\n        })}\n      </>\n    );\n  }\n\n  // ── Ready — render children ─────────────────────────────────────────────\n\n  const refreshTreatment = effectivePolicy?.refresh ?? LoadingTreatment.OPACITY_OVERLAY;\n  const initialTreatment = effectivePolicy?.initialLoad ?? LoadingTreatment.SKELETON;\n  /*\n   * ONE WRAPPER ACROSS THE TRANSITION, for every treatment that keeps the children on screen.\n   *\n   * React keeps a subtree's state only while its parent is the same element TYPE at the same\n   * position. The ready branch returned a fragment and `OPACITY_OVERLAY` / `HIDDEN` / `INVISIBLE`\n   * returned a `<div>`, so every passage between them — the end of a load, and the start AND end of\n   * every refresh — unmounted the whole surface and mounted a new one. Everything a reader had set\n   * inside it went with it: the selected tab, an open accordion, the scroll position.\n   *\n   * Measured 2026-09-21 on the workbench's actor-task modal, whose READ takes ~3 s: a tab clicked\n   * during the load was reset to the first one when the record arrived, and the replaced ancestor\n   * was this gate's own `relative` overlay wrapper. It presented as \"the Conversation tab does not\n   * work\", three layers away from the cause.\n   *\n   * So a gate whose policy CAN keep its children renders the same `<div>` in both states and only\n   * its class moves. Ready is `display: contents`, which leaves the children laid out exactly as\n   * the fragment did — flex items, grid items and `h-full` chains all survive, which a block\n   * wrapper would break in the state a surface spends its life in. Rejected alternative: keeping\n   * the fragment and floating the overlay beside the children, which leaves the overlay with no\n   * positioned box of its own to cover.\n   *\n   * A gate whose policy never keeps children (skeleton / spinner / full screen in both phases) has\n   * nothing to preserve and keeps the bare fragment.\n   */\n  const keepsChildrenWhileLoading = CHILD_KEEPING_TREATMENTS.has(refreshTreatment) || CHILD_KEEPING_TREATMENTS.has(initialTreatment);\n\n  if (allReady) {\n    return keepsChildrenWhileLoading\n      ? <div className=\"contents\" data-loading-gate=\"ready\">{children}</div>\n      : <>{children}</>;\n  }\n\n  // ── Not ready — render loading treatment ────────────────────────────────\n\n  const treatment = phase === LoadingPhase.REFRESH ? refreshTreatment : initialTreatment;\n\n  const renderContext: LoadingRenderContext = {\n    phase,\n    scope: scopeStates[0]?.scope ?? { customIdentifier: 'loading-gate' },\n  };\n\n  switch (treatment) {\n    case LoadingTreatment.CUSTOM:\n      return <>{renderLoading?.(renderContext) ?? children}</>;\n\n    case LoadingTreatment.SKELETON:\n      /*\n       * The live region wraps a CUSTOM silhouette too.\n       *\n       * `renderLoading` used to return early, so a surface that drew its own skeleton — which is the\n       * surface that most needs one, since it draws a whole collection — silently lost the `role=status`\n       * announcement and the screen-reader \"Loading\" text. Supplying a better SHAPE should not cost the\n       * assistive channel; the two are independent, and only the shape was ever being overridden.\n       *\n       * `CUSTOM` is different and still hands over everything: it means \"this treatment is not a\n       * skeleton at all\", so the caller owns the semantics as well as the pixels.\n       */\n      return (\n        <div role=\"status\" aria-live=\"polite\">\n          <span className=\"sr-only\">Loading</span>\n          {renderLoading\n            ? renderLoading(renderContext)\n            : <Skeleton template=\"auto\" density=\"auto\" aria-hidden=\"true\" />}\n        </div>\n      );\n\n    case LoadingTreatment.SPINNER:\n      return (\n        <div className=\"flex items-center justify-center py-8\">\n          <LoadingSpinner size={32} />\n        </div>\n      );\n\n    case LoadingTreatment.OPACITY_OVERLAY:\n      // `{children}` stays the FIRST child of the same `<div>` as the ready branch — see above.\n      return (\n        <div className=\"relative\" data-loading-gate=\"loading\">\n          {children}\n          <LoadingOverlay />\n        </div>\n      );\n\n    case LoadingTreatment.HIDDEN:\n      return <div style={{ display: 'none' }} data-loading-gate=\"loading\">{children}</div>;\n\n    case LoadingTreatment.INVISIBLE:\n      return <div style={{ visibility: 'hidden' }} data-loading-gate=\"loading\">{children}</div>;\n\n    case LoadingTreatment.FULL_SCREEN:\n      return (\n        <div className=\"fixed inset-0 z-(--z-critical) flex items-center justify-center bg-background/80\">\n          <LoadingSpinner size={48} />\n        </div>\n      );\n\n    default:\n      return <>{children}</>;\n  }\n}\n"]}

package/dist/esm/core/loading/loading-policy.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-policy.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/loading-policy.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAAC,MAAM,CAAC,yBAAyB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAMxG,CAAC"}
+{"version":3,"file":"loading-policy.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/loading-policy.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAAC,MAAM,CAAC,yBAAyB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAMxG,CAAC"}

package/dist/esm/core/loading/loading-policy.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"loading-policy.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/loading/loading-policy.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAuE;IAC3G,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,eAAe,EAAE;IAChJ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,EAAc,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,eAAe,EAAE;IAChJ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,EAAc,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,eAAe,EAAE;IAChJ,CAAC,yBAAyB,CAAC,4BAA4B,CAAC,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE;IACvI,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAiB,EAAE,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAI,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE;CAC1I,CAAC","sourcesContent":["import { FrontendComponentCategory } from '@wildo-ai/presets-components-models';\nimport type { LoadingPolicy } from './loading-types.frontend.schemas';\nimport { LoadingTreatment } from './loading-types.frontend.schemas';\n\n/**\n * Day-1 category defaults for loading policy resolution.\n *\n * Categories NOT listed (`APP_LAYOUTS`, `LOW_LEVEL_COMPONENTS`, `GUIDANCE`,\n * `PROGRESSION`, `LIFECYCLE`) have **no default** — their presets either\n * don't load data (primitives) or have specialized loading flows.\n * Presets in those categories must provide explicit overrides when using\n * `resolveLoadingPolicy`; omitting the category is intentional.\n *\n * @see loading-system-architecture.md §2.5\n */\nexport const CATEGORY_LOADING_DEFAULTS: Partial<Record<FrontendComponentCategory, Partial<LoadingPolicy>>> = {\n  [FrontendComponentCategory.RESOURCES_LAYOUTS]:            { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.OPACITY_OVERLAY },\n  [FrontendComponentCategory.RESOURCES_FIELDS]:             { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.OPACITY_OVERLAY },\n  [FrontendComponentCategory.HIGH_LEVEL_VIEWS]:             { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.OPACITY_OVERLAY },\n  [FrontendComponentCategory.APPLICATION_LEVEL_COMPONENTS]: { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.HIDDEN },\n  [FrontendComponentCategory.PUBLIC_LAYOUTS]:                { initialLoad: LoadingTreatment.SPINNER,   refresh: LoadingTreatment.SPINNER },\n};\n"]}
+{"version":3,"file":"loading-policy.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/loading/loading-policy.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAuE;IAC3G,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,eAAe,EAAE;IAChJ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,EAAc,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,eAAe,EAAE;IAChJ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,EAAc,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,eAAe,EAAE;IAChJ,CAAC,yBAAyB,CAAC,4BAA4B,CAAC,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAG,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE;IACvI,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAiB,EAAE,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAI,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE;CAC1I,CAAC","sourcesContent":["import { FrontendComponentCategory } from '@wildo-ai/presets-components-models';\nimport type { LoadingPolicy } from './loading-types.frontend.schemas';\nimport { LoadingTreatment } from './loading-types.frontend.schemas';\n\n/**\n * Day-1 category defaults for loading policy resolution.\n *\n * Categories NOT listed (`APP_LAYOUTS`, `LOW_LEVEL_COMPONENTS`, `GUIDANCE`,\n * `PROGRESSION`, `LIFECYCLE`) have **no default** — their presets either\n * don't load data (primitives) or have specialized loading flows.\n * Presets in those categories must provide explicit overrides when using\n * `resolveLoadingPolicy`; omitting the category is intentional.\n *\n * @see loading-system-architecture.md §2.5\n */\nexport const CATEGORY_LOADING_DEFAULTS: Partial<Record<FrontendComponentCategory, Partial<LoadingPolicy>>> = {\n  [FrontendComponentCategory.RESOURCES_LAYOUTS]:            { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.OPACITY_OVERLAY },\n  [FrontendComponentCategory.RESOURCES_FIELDS]:             { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.OPACITY_OVERLAY },\n  [FrontendComponentCategory.HIGH_LEVEL_VIEWS]:             { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.OPACITY_OVERLAY },\n  [FrontendComponentCategory.APPLICATION_LEVEL_COMPONENTS]: { initialLoad: LoadingTreatment.SKELETON,  refresh: LoadingTreatment.HIDDEN },\n  [FrontendComponentCategory.PUBLIC_LAYOUTS]:                { initialLoad: LoadingTreatment.SPINNER,   refresh: LoadingTreatment.SPINNER },\n};\n"]}

package/dist/esm/core/loading/loading-scope.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-scope.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/loading-scope.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAClG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAIhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,SAAS,MAAM,GAAG,qBAAqB,GAAG,MAAM,EAAE,IAAI,EAAE;IAC1G,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,YAAY,CAMf;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,oBAAoB,GAAG,QAAQ,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,GAAG,YAAY,CAExH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,GAAG,YAAY,CAE3F"}
+{"version":3,"file":"loading-scope.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/loading-scope.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAClG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAIhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,SAAS,MAAM,GAAG,qBAAqB,GAAG,MAAM,EAAE,IAAI,EAAE;IAC1G,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,YAAY,CAMf;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,oBAAoB,GAAG,QAAQ,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,GAAG,YAAY,CAExH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,GAAG,YAAY,CAE3F"}

package/dist/esm/core/loading/loading-scope.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"loading-scope.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/loading/loading-scope.frontend.utils.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,UAAU,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CAA6D,IAIrG;IACC,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACjC,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAqE;IACxG,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAoC;IAC3E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["import type { LoadingScope } from './loading-types.frontend.schemas';\nimport { AppLoadingIdentifier, ContextLoadingIdentifier } from './loading-types.frontend.schemas';\nimport type { CoreResourceOperation } from '@wildo-ai/saas-models';\n\n/**\n * Builds a deterministic string key from a LoadingScope.\n * Used as Map keys in the loading state aggregator.\n *\n * Key format:\n * - Custom: `custom:{identifier}`\n * - Resource: `{resourceType}:{operation}` or `{resourceType}:{operation}:{discriminator}`\n *\n * Consumers must use the same scope shape to match — no fuzzy matching.\n */\nexport function buildLoadingScopeKey(scope: LoadingScope): string {\n  if (scope.customIdentifier) return `custom:${scope.customIdentifier}`;\n  const parts = [scope.resourceType, scope.operation, scope.discriminator].filter(Boolean);\n  return parts.join(':');\n}\n\n/**\n * L-3: typed loading-scope builders.\n *\n * These narrow the inputs accepted by `LoadingScope`'s open-world string\n * fields, making it harder to typo or forget a required identifier:\n *\n * - `buildResourceLoadingScope` requires `resourceType` and `operation`. The\n *   `operation` field accepts `CoreResourceOperation` (enum, autocompleted)\n *   or a domain operation identifier string (custom resources / variants).\n * - `buildAppLoadingScope` requires an `AppLoadingIdentifier` enum value, so\n *   Tier-1 (APPLICATION) callers can't drift to ad-hoc strings.\n *\n * Existing callers can keep building the LoadingScope literal directly; these\n * helpers are an opt-in safety layer used in new/refactored sites.\n */\nexport function buildResourceLoadingScope<TOperation extends string = CoreResourceOperation | string>(args: {\n  resourceType: string;\n  operation: TOperation;\n  discriminator?: string;\n}): LoadingScope {\n  return {\n    resourceType: args.resourceType,\n    operation: String(args.operation),\n    discriminator: args.discriminator,\n  };\n}\n\nexport function buildAppLoadingScope(identifier: AppLoadingIdentifier | `init:${string}` | `app:${string}`): LoadingScope {\n  return { customIdentifier: identifier };\n}\n\n/**\n * L-2.b: typed builder for **Tier-2 context** loading scopes.\n *\n * Use this from the four canonical contexts (billing, flows-actors,\n * progression, lifecycle) — and from any future context that opts into\n * publishing its loading state through `LoadingContext`. The narrowed\n * `ContextLoadingIdentifier` enum prevents drift to ad-hoc identifier strings.\n *\n * Pair with `useEmitLoadingScope` for the canonical fire/end pattern, or\n * call `fireLoading({ ...scope }, { tier: LoadingTier.COMPONENT, phase })`\n * + `endLoading({ ...scope }, { tier: LoadingTier.COMPONENT })` directly.\n */\nexport function buildContextLoadingScope(identifier: ContextLoadingIdentifier): LoadingScope {\n  return { customIdentifier: identifier };\n}\n"]}
+{"version":3,"file":"loading-scope.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/loading/loading-scope.frontend.utils.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,UAAU,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CAA6D,IAIrG;IACC,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACjC,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAqE;IACxG,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAoC;IAC3E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["import type { LoadingScope } from './loading-types.frontend.schemas';\nimport { AppLoadingIdentifier, ContextLoadingIdentifier } from './loading-types.frontend.schemas';\nimport type { CoreResourceOperation } from '@wildo-ai/saas-models';\n\n/**\n * Builds a deterministic string key from a LoadingScope.\n * Used as Map keys in the loading state aggregator.\n *\n * Key format:\n * - Custom: `custom:{identifier}`\n * - Resource: `{resourceType}:{operation}` or `{resourceType}:{operation}:{discriminator}`\n *\n * Consumers must use the same scope shape to match — no fuzzy matching.\n */\nexport function buildLoadingScopeKey(scope: LoadingScope): string {\n  if (scope.customIdentifier) return `custom:${scope.customIdentifier}`;\n  const parts = [scope.resourceType, scope.operation, scope.discriminator].filter(Boolean);\n  return parts.join(':');\n}\n\n/**\n * L-3: typed loading-scope builders.\n *\n * These narrow the inputs accepted by `LoadingScope`'s open-world string\n * fields, making it harder to typo or forget a required identifier:\n *\n * - `buildResourceLoadingScope` requires `resourceType` and `operation`. The\n *   `operation` field accepts `CoreResourceOperation` (enum, autocompleted)\n *   or a domain operation identifier string (custom resources / variants).\n * - `buildAppLoadingScope` requires an `AppLoadingIdentifier` enum value, so\n *   Tier-1 (APPLICATION) callers can't drift to ad-hoc strings.\n *\n * Existing callers can keep building the LoadingScope literal directly; these\n * helpers are an opt-in safety layer used in new/refactored sites.\n */\nexport function buildResourceLoadingScope<TOperation extends string = CoreResourceOperation | string>(args: {\n  resourceType: string;\n  operation: TOperation;\n  discriminator?: string;\n}): LoadingScope {\n  return {\n    resourceType: args.resourceType,\n    operation: String(args.operation),\n    discriminator: args.discriminator,\n  };\n}\n\nexport function buildAppLoadingScope(identifier: AppLoadingIdentifier | `init:${string}` | `app:${string}`): LoadingScope {\n  return { customIdentifier: identifier };\n}\n\n/**\n * L-2.b: typed builder for **Tier-2 context** loading scopes.\n *\n * Use this from the four canonical contexts (billing, flows-actors,\n * progression, lifecycle) — and from any future context that opts into\n * publishing its loading state through `LoadingContext`. The narrowed\n * `ContextLoadingIdentifier` enum prevents drift to ad-hoc identifier strings.\n *\n * Pair with `useEmitLoadingScope` for the canonical fire/end pattern, or\n * call `fireLoading({ ...scope }, { tier: LoadingTier.COMPONENT, phase })`\n * + `endLoading({ ...scope }, { tier: LoadingTier.COMPONENT })` directly.\n */\nexport function buildContextLoadingScope(identifier: ContextLoadingIdentifier): LoadingScope {\n  return { customIdentifier: identifier };\n}\n"]}

package/dist/esm/core/loading/loading-types.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-types.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/loading-types.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,oBAAY,oBAAoB;IAC9B,+CAA+C;IAC/C,SAAS,cAAc;IACvB,yDAAyD;IACzD,oBAAoB,yBAAyB;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,oBAAY,wBAAwB;IAClC,oDAAoD;IACpD,aAAa,sBAAsB;IACnC,kEAAkE;IAClE,YAAY,qBAAqB;IACjC,oEAAoE;IACpE,WAAW,oBAAoB;IAC/B,6DAA6D;IAC7D,SAAS,kBAAkB;CAC5B;AAED,4CAA4C;AAC5C,oBAAY,WAAW;IACrB,4EAA4E;IAC5E,WAAW,gBAAgB;IAC3B,4EAA4E;IAC5E,SAAS,cAAc;CACxB;AAED,iEAAiE;AACjE,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC1B,0EAA0E;IAC1E,QAAQ,aAAa;IACrB,uEAAuE;IACvE,OAAO,YAAY;IACnB,wEAAwE;IACxE,eAAe,oBAAoB;IACnC,gDAAgD;IAChD,MAAM,WAAW;IACjB,wDAAwD;IACxD,SAAS,cAAc;IACvB,uEAAuE;IACvE,WAAW,gBAAgB;IAC3B,gEAAgE;IAChE,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,OAAO,EAAE,SAAS,CAAC;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"loading-types.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/loading-types.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,oBAAY,oBAAoB;IAC9B,+CAA+C;IAC/C,SAAS,cAAc;IACvB,yDAAyD;IACzD,oBAAoB,yBAAyB;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,oBAAY,wBAAwB;IAClC,oDAAoD;IACpD,aAAa,sBAAsB;IACnC,kEAAkE;IAClE,YAAY,qBAAqB;IACjC,oEAAoE;IACpE,WAAW,oBAAoB;IAC/B,6DAA6D;IAC7D,SAAS,kBAAkB;CAC5B;AAED,4CAA4C;AAC5C,oBAAY,WAAW;IACrB,4EAA4E;IAC5E,WAAW,gBAAgB;IAC3B,4EAA4E;IAC5E,SAAS,cAAc;CACxB;AAED,iEAAiE;AACjE,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC1B,0EAA0E;IAC1E,QAAQ,aAAa;IACrB,uEAAuE;IACvE,OAAO,YAAY;IACnB,wEAAwE;IACxE,eAAe,oBAAoB;IACnC,gDAAgD;IAChD,MAAM,WAAW;IACjB,wDAAwD;IACxD,SAAS,cAAc;IACvB,uEAAuE;IACvE,WAAW,gBAAgB;IAC3B,gEAAgE;IAChE,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,OAAO,EAAE,SAAS,CAAC;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/esm/core/loading/loading-types.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"loading-types.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/loading/loading-types.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,+CAA+C;IAC/C,+CAAuB,CAAA;IACvB,yDAAyD;IACzD,qEAA6C,CAAA;AAC/C,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAN,IAAY,wBASX;AATD,WAAY,wBAAwB;IAClC,oDAAoD;IACpD,+DAAmC,CAAA;IACnC,kEAAkE;IAClE,6DAAiC,CAAA;IACjC,oEAAoE;IACpE,2DAA+B,CAAA;IAC/B,6DAA6D;IAC7D,uDAA2B,CAAA;AAC7B,CAAC,EATW,wBAAwB,KAAxB,wBAAwB,QASnC;AAED,4CAA4C;AAC5C,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,4EAA4E;IAC5E,0CAA2B,CAAA;IAC3B,4EAA4E;IAC5E,sCAAuB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,iEAAiE;AACjE,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;AACrB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,gBAeX;AAfD,WAAY,gBAAgB;IAC1B,0EAA0E;IAC1E,yCAAqB,CAAA;IACrB,uEAAuE;IACvE,uCAAmB,CAAA;IACnB,wEAAwE;IACxE,uDAAmC,CAAA;IACnC,gDAAgD;IAChD,qCAAiB,CAAA;IACjB,wDAAwD;IACxD,2CAAuB,CAAA;IACvB,uEAAuE;IACvE,+CAA2B,CAAA;IAC3B,gEAAgE;IAChE,qCAAiB,CAAA;AACnB,CAAC,EAfW,gBAAgB,KAAhB,gBAAgB,QAe3B","sourcesContent":["/**\n * Loading System Type Definitions\n *\n * Foundation types for the 3-tier loading architecture.\n * See .cursor/plans/loading-system-architecture.md for full design.\n *\n * Tier 1 (APPLICATION): Gates the entire UI — init steps, language change, org switch.\n * Tier 2 (COMPONENT): Per-scope loading managed centrally — enables cross-component awareness.\n * Tier 3 (ACTION): Local to the component — button spinners, inline saves. Not tracked here.\n */\n\n/**\n * Well-known custom loading identifiers for Tier 1 (APPLICATION) events.\n *\n * Used as `customIdentifier` in LoadingScope and as `identifier` in\n * LOADING_CUSTOM_START/END event payloads.\n */\nexport enum AppLoadingIdentifier {\n  /** Initial translations load on app startup */\n  INIT_I18N = 'init:i18n',\n  /** Translations reload triggered by a language change */\n  I18N_LANGUAGE_CHANGE = 'i18n:language-change',\n}\n\n/**\n * Well-known custom loading identifiers for Tier 2 (COMPONENT) **context**\n * providers — i.e. high-level frontend-lib contexts (billing, flows-actors,\n * progression, lifecycle, …) that own their own fetch lifecycle but want to\n * publish that lifecycle through `LoadingContext` so unrelated components can\n * observe it via `useComponentLoading({ customIdentifier })`.\n *\n * **L-2.b decision (2026-04-21): emit via the LoadingContext event bus**\n * rather than expose ad-hoc `useXxxLoadingScope()` hooks. Rationale:\n * - `LoadingContext` is already the single source of truth for both\n *   `LoadingGate` and `useComponentLoading`; parallel hooks would fragment\n *   the model and force every cross-cutting consumer to learn N adapters.\n * - The infrastructure already exists (LOADING_CUSTOM_*` events with\n *   `tier: COMPONENT`); no schema change needed.\n * - Contexts keep exposing their own `isLoading` for direct consumers\n *   (back-compat), but ALSO call `fireLoading`/`endLoading` so that\n *   downstream sites can wrap content in a `LoadingGate`/`useComponentLoading`\n *   without coupling to the context.\n *\n * Naming convention: `app:<domain>` (lowercase, kebab-case for multi-word).\n * Add a new entry here when promoting a context to publish its loading state.\n */\nexport enum ContextLoadingIdentifier {\n  /** BillingContext: billing-state fetch lifecycle */\n  BILLING_STATE = 'app:billing:state',\n  /** FlowsActorsContext: flows + actors registry fetch lifecycle */\n  FLOWS_ACTORS = 'app:flows-actors',\n  /** GuidanceContext: progression / guidance graph fetch lifecycle */\n  PROGRESSION = 'app:progression',\n  /** ExecutionRuntimeContext: lifecycle/runtime state fetch */\n  LIFECYCLE = 'app:lifecycle',\n}\n\n/** Which tier a loading event belongs to */\nexport enum LoadingTier {\n  /** App-level: gates the entire application (init steps, language change) */\n  APPLICATION = 'application',\n  /** Component-level: managed centrally, enables cross-component awareness */\n  COMPONENT = 'component',\n}\n\n/** Whether this is a first load or a refresh of existing data */\nexport enum LoadingPhase {\n  INITIAL = 'initial',\n  REFRESH = 'refresh',\n}\n\n/**\n * Visual treatment for loading states.\n *\n * Used by LoadingPolicy to determine what the user sees while content loads.\n * SKELETON and OPACITY_OVERLAY preserve layout stability; SPINNER and FULL_SCREEN do not.\n */\nexport enum LoadingTreatment {\n  /** Placeholder shapes matching content layout — best for initial loads */\n  SKELETON = 'SKELETON',\n  /** Centered spinner — use when layout is unknown or for short waits */\n  SPINNER = 'SPINNER',\n  /** Semi-transparent overlay on existing content — best for refreshes */\n  OPACITY_OVERLAY = 'OPACITY_OVERLAY',\n  /** display: none — component hidden entirely */\n  HIDDEN = 'HIDDEN',\n  /** visibility: hidden — space reserved but invisible */\n  INVISIBLE = 'INVISIBLE',\n  /** Full-screen overlay blocking all interaction — app-level loading */\n  FULL_SCREEN = 'FULL_SCREEN',\n  /** Custom renderer provided via LoadingPolicy.customRenderer */\n  CUSTOM = 'CUSTOM',\n}\n\n/**\n * Identifies what is loading — resource operation or custom identifier.\n *\n * At least one of `resourceType`+`operation` or `customIdentifier` must be provided.\n * The scope is serialized to a string key via `buildLoadingScopeKey()` for Map lookups.\n */\nexport interface LoadingScope {\n  resourceType?: string;\n  operation?: string;\n  /** Distinguishes multiple instances of the same resource+operation (e.g., inline editors) */\n  discriminator?: string;\n  /** For non-resource loading (e.g., 'init:auth', 'init:i18n') */\n  customIdentifier?: string;\n}\n\n/**\n * Policy that determines how loading is rendered.\n *\n * Resolved by resolveLoadingPolicy — 2-layer for day 1:\n * 1. Category defaults (resource lists → SKELETON, actions → SPINNER, etc.)\n * 2. Explicit override via LoadingGate props\n */\nexport interface LoadingPolicy {\n  initialLoad: LoadingTreatment;\n  refresh?: LoadingTreatment;\n  customRenderer?: (context: LoadingRenderContext) => import('react').ReactNode;\n  disableInteraction?: boolean;\n  skeletonSchema?: unknown;\n}\n\n/** Context passed to custom loading renderers */\nexport interface LoadingRenderContext {\n  phase: LoadingPhase;\n  scope: LoadingScope;\n}\n\n/** Context passed to error renderers on LoadingGate */\nexport interface LoadingErrorContext {\n  failedScopes: LoadingScope[];\n  reason: 'timeout' | 'error';\n  retry: () => void;\n  error?: unknown;\n}\n\n/**\n * Internal state for a single loading scope in the LoadingContext aggregator.\n *\n * activeCount tracks concurrent requests for the same scope (e.g., rapid LIST refreshes).\n * isLoading is true when activeCount > 0.\n */\nexport interface ComponentLoadingState {\n  hasLoadedOnce: boolean;\n  isLoading: boolean;\n  phase: LoadingPhase;\n  activeCount: number;\n}\n\n/** Active app-level loading source — exposed for debugging and UI display */\nexport interface LoadingSource {\n  identifier: string;\n  tier: LoadingTier;\n  startedAt: number;\n}\n"]}
+{"version":3,"file":"loading-types.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/loading/loading-types.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,+CAA+C;IAC/C,+CAAuB,CAAA;IACvB,yDAAyD;IACzD,qEAA6C,CAAA;AAC/C,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAN,IAAY,wBASX;AATD,WAAY,wBAAwB;IAClC,oDAAoD;IACpD,+DAAmC,CAAA;IACnC,kEAAkE;IAClE,6DAAiC,CAAA;IACjC,oEAAoE;IACpE,2DAA+B,CAAA;IAC/B,6DAA6D;IAC7D,uDAA2B,CAAA;AAC7B,CAAC,EATW,wBAAwB,KAAxB,wBAAwB,QASnC;AAED,4CAA4C;AAC5C,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,4EAA4E;IAC5E,0CAA2B,CAAA;IAC3B,4EAA4E;IAC5E,sCAAuB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,iEAAiE;AACjE,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;AACrB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,gBAeX;AAfD,WAAY,gBAAgB;IAC1B,0EAA0E;IAC1E,yCAAqB,CAAA;IACrB,uEAAuE;IACvE,uCAAmB,CAAA;IACnB,wEAAwE;IACxE,uDAAmC,CAAA;IACnC,gDAAgD;IAChD,qCAAiB,CAAA;IACjB,wDAAwD;IACxD,2CAAuB,CAAA;IACvB,uEAAuE;IACvE,+CAA2B,CAAA;IAC3B,gEAAgE;IAChE,qCAAiB,CAAA;AACnB,CAAC,EAfW,gBAAgB,KAAhB,gBAAgB,QAe3B","sourcesContent":["/**\n * Loading System Type Definitions\n *\n * Foundation types for the 3-tier loading architecture.\n * See .cursor/plans/loading-system-architecture.md for full design.\n *\n * Tier 1 (APPLICATION): Gates the entire UI — init steps, language change, org switch.\n * Tier 2 (COMPONENT): Per-scope loading managed centrally — enables cross-component awareness.\n * Tier 3 (ACTION): Local to the component — button spinners, inline saves. Not tracked here.\n */\n\n/**\n * Well-known custom loading identifiers for Tier 1 (APPLICATION) events.\n *\n * Used as `customIdentifier` in LoadingScope and as `identifier` in\n * LOADING_CUSTOM_START/END event payloads.\n */\nexport enum AppLoadingIdentifier {\n  /** Initial translations load on app startup */\n  INIT_I18N = 'init:i18n',\n  /** Translations reload triggered by a language change */\n  I18N_LANGUAGE_CHANGE = 'i18n:language-change',\n}\n\n/**\n * Well-known custom loading identifiers for Tier 2 (COMPONENT) **context**\n * providers — i.e. high-level frontend-lib contexts (billing, flows-actors,\n * progression, lifecycle, …) that own their own fetch lifecycle but want to\n * publish that lifecycle through `LoadingContext` so unrelated components can\n * observe it via `useComponentLoading({ customIdentifier })`.\n *\n * **L-2.b decision (2026-04-21): emit via the LoadingContext event bus**\n * rather than expose ad-hoc `useXxxLoadingScope()` hooks. Rationale:\n * - `LoadingContext` is already the single source of truth for both\n *   `LoadingGate` and `useComponentLoading`; parallel hooks would fragment\n *   the model and force every cross-cutting consumer to learn N adapters.\n * - The infrastructure already exists (LOADING_CUSTOM_*` events with\n *   `tier: COMPONENT`); no schema change needed.\n * - Contexts keep exposing their own `isLoading` for direct consumers\n *   (back-compat), but ALSO call `fireLoading`/`endLoading` so that\n *   downstream sites can wrap content in a `LoadingGate`/`useComponentLoading`\n *   without coupling to the context.\n *\n * Naming convention: `app:<domain>` (lowercase, kebab-case for multi-word).\n * Add a new entry here when promoting a context to publish its loading state.\n */\nexport enum ContextLoadingIdentifier {\n  /** BillingContext: billing-state fetch lifecycle */\n  BILLING_STATE = 'app:billing:state',\n  /** FlowsActorsContext: flows + actors registry fetch lifecycle */\n  FLOWS_ACTORS = 'app:flows-actors',\n  /** GuidanceContext: progression / guidance graph fetch lifecycle */\n  PROGRESSION = 'app:progression',\n  /** ExecutionRuntimeContext: lifecycle/runtime state fetch */\n  LIFECYCLE = 'app:lifecycle',\n}\n\n/** Which tier a loading event belongs to */\nexport enum LoadingTier {\n  /** App-level: gates the entire application (init steps, language change) */\n  APPLICATION = 'application',\n  /** Component-level: managed centrally, enables cross-component awareness */\n  COMPONENT = 'component',\n}\n\n/** Whether this is a first load or a refresh of existing data */\nexport enum LoadingPhase {\n  INITIAL = 'initial',\n  REFRESH = 'refresh',\n}\n\n/**\n * Visual treatment for loading states.\n *\n * Used by LoadingPolicy to determine what the user sees while content loads.\n * SKELETON and OPACITY_OVERLAY preserve layout stability; SPINNER and FULL_SCREEN do not.\n */\nexport enum LoadingTreatment {\n  /** Placeholder shapes matching content layout — best for initial loads */\n  SKELETON = 'SKELETON',\n  /** Centered spinner — use when layout is unknown or for short waits */\n  SPINNER = 'SPINNER',\n  /** Semi-transparent overlay on existing content — best for refreshes */\n  OPACITY_OVERLAY = 'OPACITY_OVERLAY',\n  /** display: none — component hidden entirely */\n  HIDDEN = 'HIDDEN',\n  /** visibility: hidden — space reserved but invisible */\n  INVISIBLE = 'INVISIBLE',\n  /** Full-screen overlay blocking all interaction — app-level loading */\n  FULL_SCREEN = 'FULL_SCREEN',\n  /** Custom renderer provided via LoadingPolicy.customRenderer */\n  CUSTOM = 'CUSTOM',\n}\n\n/**\n * Identifies what is loading — resource operation or custom identifier.\n *\n * At least one of `resourceType`+`operation` or `customIdentifier` must be provided.\n * The scope is serialized to a string key via `buildLoadingScopeKey()` for Map lookups.\n */\nexport interface LoadingScope {\n  resourceType?: string;\n  operation?: string;\n  /** Distinguishes multiple instances of the same resource+operation (e.g., inline editors) */\n  discriminator?: string;\n  /** For non-resource loading (e.g., 'init:auth', 'init:i18n') */\n  customIdentifier?: string;\n}\n\n/**\n * Policy that determines how loading is rendered.\n *\n * Resolved by resolveLoadingPolicy — 2-layer for day 1:\n * 1. Category defaults (resource lists → SKELETON, actions → SPINNER, etc.)\n * 2. Explicit override via LoadingGate props\n */\nexport interface LoadingPolicy {\n  initialLoad: LoadingTreatment;\n  refresh?: LoadingTreatment;\n  customRenderer?: (context: LoadingRenderContext) => import('react').ReactNode;\n  disableInteraction?: boolean;\n  skeletonSchema?: unknown;\n}\n\n/** Context passed to custom loading renderers */\nexport interface LoadingRenderContext {\n  phase: LoadingPhase;\n  scope: LoadingScope;\n}\n\n/** Context passed to error renderers on LoadingGate */\nexport interface LoadingErrorContext {\n  failedScopes: LoadingScope[];\n  reason: 'timeout' | 'error';\n  retry: () => void;\n  error?: unknown;\n}\n\n/**\n * Internal state for a single loading scope in the LoadingContext aggregator.\n *\n * activeCount tracks concurrent requests for the same scope (e.g., rapid LIST refreshes).\n * isLoading is true when activeCount > 0.\n */\nexport interface ComponentLoadingState {\n  hasLoadedOnce: boolean;\n  isLoading: boolean;\n  phase: LoadingPhase;\n  activeCount: number;\n}\n\n/** Active app-level loading source — exposed for debugging and UI display */\nexport interface LoadingSource {\n  identifier: string;\n  tier: LoadingTier;\n  startedAt: number;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"resolveLoadingPolicy.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/resolveLoadingPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAItE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,yBAAyB,EAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,aAAa,CASf"}
+{"version":3,"file":"resolveLoadingPolicy.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/resolveLoadingPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAItE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,yBAAyB,EAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,aAAa,CASf"}

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

@@ -1 +1 @@
-{"version":3,"file":"resolveLoadingPolicy.js","sourceRoot":"","sources":["../../../../src/core/loading/resolveLoadingPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,iBAA4C,EAC5C,QAAiC;IAEjC,MAAM,eAAe,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAC3E,OAAO;QACL,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,eAAe,CAAC,WAAW,IAAI,gBAAgB,CAAC,QAAQ;QAC9F,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,eAAe,CAAC,OAAO,IAAI,gBAAgB,CAAC,eAAe;QACzF,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,eAAe,CAAC,cAAc;QAC1E,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,IAAI,eAAe,CAAC,kBAAkB;QACtF,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,eAAe,CAAC,cAAc;KAC3E,CAAC;AACJ,CAAC","sourcesContent":["import type { FrontendComponentCategory } from '@wildo-ai/presets-components-models';\nimport type { LoadingPolicy } from './loading-types.frontend.schemas';\nimport { LoadingTreatment } from './loading-types.frontend.schemas';\nimport { CATEGORY_LOADING_DEFAULTS } from './loading-policy.frontend.schemas';\n\n/**\n * Resolves a `LoadingPolicy` via 2-layer resolution:\n *   1. Category defaults (from `CATEGORY_LOADING_DEFAULTS`)\n *   2. Explicit override (preset code or instance props)\n *\n * Categories without defaults (LOW_LEVEL, APP_LAYOUTS, GUIDANCE, PROGRESSION,\n * LIFECYCLE) fall through to framework defaults (SKELETON + OPACITY_OVERLAY).\n * Presets in those categories should always provide explicit overrides.\n *\n * @param componentCategory - The category to look up defaults for\n * @param override - Explicit overrides from the preset or instance\n */\nexport function resolveLoadingPolicy(\n  componentCategory: FrontendComponentCategory,\n  override?: Partial<LoadingPolicy>\n): LoadingPolicy {\n  const categoryDefault = CATEGORY_LOADING_DEFAULTS[componentCategory] ?? {};\n  return {\n    initialLoad: override?.initialLoad ?? categoryDefault.initialLoad ?? LoadingTreatment.SKELETON,\n    refresh: override?.refresh ?? categoryDefault.refresh ?? LoadingTreatment.OPACITY_OVERLAY,\n    customRenderer: override?.customRenderer ?? categoryDefault.customRenderer,\n    disableInteraction: override?.disableInteraction ?? categoryDefault.disableInteraction,\n    skeletonSchema: override?.skeletonSchema ?? categoryDefault.skeletonSchema,\n  };\n}\n"]}
+{"version":3,"file":"resolveLoadingPolicy.js","sourceRoot":"","sources":["../../../../../src/core/loading/resolveLoadingPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,iBAA4C,EAC5C,QAAiC;IAEjC,MAAM,eAAe,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAC3E,OAAO;QACL,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,eAAe,CAAC,WAAW,IAAI,gBAAgB,CAAC,QAAQ;QAC9F,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,eAAe,CAAC,OAAO,IAAI,gBAAgB,CAAC,eAAe;QACzF,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,eAAe,CAAC,cAAc;QAC1E,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,IAAI,eAAe,CAAC,kBAAkB;QACtF,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,eAAe,CAAC,cAAc;KAC3E,CAAC;AACJ,CAAC","sourcesContent":["import type { FrontendComponentCategory } from '@wildo-ai/presets-components-models';\nimport type { LoadingPolicy } from './loading-types.frontend.schemas';\nimport { LoadingTreatment } from './loading-types.frontend.schemas';\nimport { CATEGORY_LOADING_DEFAULTS } from './loading-policy.frontend.schemas';\n\n/**\n * Resolves a `LoadingPolicy` via 2-layer resolution:\n *   1. Category defaults (from `CATEGORY_LOADING_DEFAULTS`)\n *   2. Explicit override (preset code or instance props)\n *\n * Categories without defaults (LOW_LEVEL, APP_LAYOUTS, GUIDANCE, PROGRESSION,\n * LIFECYCLE) fall through to framework defaults (SKELETON + OPACITY_OVERLAY).\n * Presets in those categories should always provide explicit overrides.\n *\n * @param componentCategory - The category to look up defaults for\n * @param override - Explicit overrides from the preset or instance\n */\nexport function resolveLoadingPolicy(\n  componentCategory: FrontendComponentCategory,\n  override?: Partial<LoadingPolicy>\n): LoadingPolicy {\n  const categoryDefault = CATEGORY_LOADING_DEFAULTS[componentCategory] ?? {};\n  return {\n    initialLoad: override?.initialLoad ?? categoryDefault.initialLoad ?? LoadingTreatment.SKELETON,\n    refresh: override?.refresh ?? categoryDefault.refresh ?? LoadingTreatment.OPACITY_OVERLAY,\n    customRenderer: override?.customRenderer ?? categoryDefault.customRenderer,\n    disableInteraction: override?.disableInteraction ?? categoryDefault.disableInteraction,\n    skeletonSchema: override?.skeletonSchema ?? categoryDefault.skeletonSchema,\n  };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useAppLoading.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/useAppLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAInF"}
+{"version":3,"file":"useAppLoading.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/useAppLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAInF"}

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

@@ -1 +1 @@
-{"version":3,"file":"useAppLoading.js","sourceRoot":"","sources":["../../../../src/core/loading/useAppLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrF,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;AACpF,CAAC","sourcesContent":["/**\n * useAppLoading Hook — Tier 1: Application-Level Loading State\n *\n * Separated from LoadingContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { LoadingContext } from './LoadingContext';\nimport type { LoadingSource } from './loading-types.frontend.schemas';\n\n/**\n * Tier 1: Application-level loading state.\n * Returns true when any app-level loading is active (init steps, language change).\n *\n * Use this to gate the entire application UI — show a full-screen loading\n * overlay when the app is initializing or switching languages/orgs.\n *\n * @throws Error if used outside of LoadingProvider\n */\nexport function useAppLoading(): { isAppLoading: boolean; sources: LoadingSource[] } {\n  const context = useContext(LoadingContext);\n  if (!context) throw new Error('useAppLoading must be used within a LoadingProvider');\n  return { isAppLoading: context.isAppLoading, sources: context.appLoadingSources };\n}\n"]}
+{"version":3,"file":"useAppLoading.js","sourceRoot":"","sources":["../../../../../src/core/loading/useAppLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrF,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;AACpF,CAAC","sourcesContent":["/**\n * useAppLoading Hook — Tier 1: Application-Level Loading State\n *\n * Separated from LoadingContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { LoadingContext } from './LoadingContext';\nimport type { LoadingSource } from './loading-types.frontend.schemas';\n\n/**\n * Tier 1: Application-level loading state.\n * Returns true when any app-level loading is active (init steps, language change).\n *\n * Use this to gate the entire application UI — show a full-screen loading\n * overlay when the app is initializing or switching languages/orgs.\n *\n * @throws Error if used outside of LoadingProvider\n */\nexport function useAppLoading(): { isAppLoading: boolean; sources: LoadingSource[] } {\n  const context = useContext(LoadingContext);\n  if (!context) throw new Error('useAppLoading must be used within a LoadingProvider');\n  return { isAppLoading: context.isAppLoading, sources: context.appLoadingSources };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useComponentLoading.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/useComponentLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IACD,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAqBA"}
+{"version":3,"file":"useComponentLoading.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/useComponentLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IACD,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAqBA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useComponentLoading.js","sourceRoot":"","sources":["../../../../src/core/loading/useComponentLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAmB,EACnB,OAAyC;IAOzC,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAE3F,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,KAAK,EAAE,SAAS,IAAI,KAAK,CAAC;IAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAEnF,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IACjD,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpC,OAAO;QACL,aAAa,EAAE,SAAS,IAAI,CAAC,aAAa;QAC1C,YAAY,EAAE,SAAS,IAAI,aAAa;QACxC,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["/**\n * useComponentLoading Hook — Tier 2: Component-Level Loading State\n *\n * Separated from LoadingContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext, useCallback } from 'react';\nimport { LoadingContext } from './LoadingContext';\nimport type { LoadingScope } from './loading-types.frontend.schemas';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\n\n/**\n * Tier 2: Component-level loading state for a specific scope.\n * Derives isInitialLoad vs isRefreshing from the LoadedOnceCache.\n *\n * - `isInitialLoad`: Loading AND this scope has never been loaded before → show skeleton\n * - `isRefreshing`: Loading AND this scope was loaded before → show opacity overlay\n * - `isLoading`: Either of the above\n * - `markRendered`: Call after first successful render to record in LoadedOnceCache\n *\n * @param scope - What is being loaded (resource+operation or custom identifier)\n * @param options.refreshThresholdMs - TTL for hasLoadedOnce (default 5 min)\n * @throws Error if used outside of LoadingProvider\n */\nexport function useComponentLoading(\n  scope: LoadingScope,\n  options?: { refreshThresholdMs?: number }\n): {\n  isInitialLoad: boolean;\n  isRefreshing: boolean;\n  isLoading: boolean;\n  markRendered: () => void;\n} {\n  const context = useContext(LoadingContext);\n  if (!context) throw new Error('useComponentLoading must be used within a LoadingProvider');\n\n  const scopeKey = buildLoadingScopeKey(scope);\n  const state = context.getComponentLoadingState(scopeKey);\n\n  const isLoading = state?.isLoading ?? false;\n  const hasLoadedOnce = context.hasLoadedOnce(scopeKey, options?.refreshThresholdMs);\n\n  const contextMarkRendered = context.markRendered;\n  const markRendered = useCallback(() => {\n    contextMarkRendered(scopeKey);\n  }, [contextMarkRendered, scopeKey]);\n\n  return {\n    isInitialLoad: isLoading && !hasLoadedOnce,\n    isRefreshing: isLoading && hasLoadedOnce,\n    isLoading,\n    markRendered,\n  };\n}\n"]}
+{"version":3,"file":"useComponentLoading.js","sourceRoot":"","sources":["../../../../../src/core/loading/useComponentLoading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAmB,EACnB,OAAyC;IAOzC,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAE3F,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,KAAK,EAAE,SAAS,IAAI,KAAK,CAAC;IAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAEnF,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IACjD,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpC,OAAO;QACL,aAAa,EAAE,SAAS,IAAI,CAAC,aAAa;QAC1C,YAAY,EAAE,SAAS,IAAI,aAAa;QACxC,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["/**\n * useComponentLoading Hook — Tier 2: Component-Level Loading State\n *\n * Separated from LoadingContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext, useCallback } from 'react';\nimport { LoadingContext } from './LoadingContext';\nimport type { LoadingScope } from './loading-types.frontend.schemas';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\n\n/**\n * Tier 2: Component-level loading state for a specific scope.\n * Derives isInitialLoad vs isRefreshing from the LoadedOnceCache.\n *\n * - `isInitialLoad`: Loading AND this scope has never been loaded before → show skeleton\n * - `isRefreshing`: Loading AND this scope was loaded before → show opacity overlay\n * - `isLoading`: Either of the above\n * - `markRendered`: Call after first successful render to record in LoadedOnceCache\n *\n * @param scope - What is being loaded (resource+operation or custom identifier)\n * @param options.refreshThresholdMs - TTL for hasLoadedOnce (default 5 min)\n * @throws Error if used outside of LoadingProvider\n */\nexport function useComponentLoading(\n  scope: LoadingScope,\n  options?: { refreshThresholdMs?: number }\n): {\n  isInitialLoad: boolean;\n  isRefreshing: boolean;\n  isLoading: boolean;\n  markRendered: () => void;\n} {\n  const context = useContext(LoadingContext);\n  if (!context) throw new Error('useComponentLoading must be used within a LoadingProvider');\n\n  const scopeKey = buildLoadingScopeKey(scope);\n  const state = context.getComponentLoadingState(scopeKey);\n\n  const isLoading = state?.isLoading ?? false;\n  const hasLoadedOnce = context.hasLoadedOnce(scopeKey, options?.refreshThresholdMs);\n\n  const contextMarkRendered = context.markRendered;\n  const markRendered = useCallback(() => {\n    contextMarkRendered(scopeKey);\n  }, [contextMarkRendered, scopeKey]);\n\n  return {\n    isInitialLoad: isLoading && !hasLoadedOnce,\n    isRefreshing: isLoading && hasLoadedOnce,\n    isLoading,\n    markRendered,\n  };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useEmitLoadingScope.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/useEmitLoadingScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EACL,wBAAwB,EAGzB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,wBAAwB,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,IAAI,CAyCP"}
+{"version":3,"file":"useEmitLoadingScope.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/useEmitLoadingScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EACL,wBAAwB,EAGzB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,wBAAwB,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,IAAI,CAyCP"}

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

@@ -1 +1 @@
-{"version":3,"file":"useEmitLoadingScope.js","sourceRoot":"","sources":["../../../../src/core/loading/useEmitLoadingScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAEL,YAAY,EACZ,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAInC;IACC,sEAAsE;IACtE,qEAAqE;IACrE,wEAAwE;IACxE,mEAAmE;IACnE,oEAAoE;IACpE,oEAAoE;IACpE,qCAAqC;IACrC,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,UAAU,EAAE,WAAW,CAAC;IAC5C,MAAM,UAAU,GAAG,UAAU,EAAE,UAAU,CAAC;IAE1C,MAAM,aAAa,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAE7C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU;YAAE,OAAO;QAExC,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC;QAEnC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC/C,WAAW,CAAC,KAAK,EAAE;gBACjB,IAAI;gBACJ,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO;aAC1E,CAAC,CAAC;YACH,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YACtD,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5B,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;QAChC,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,aAAa,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC1D,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;gBACnD,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;YAChC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AACtC,CAAC","sourcesContent":["/**\n * useEmitLoadingScope — Tier-2 context loading emitter (L-2.b)\n *\n * Ergonomic wrapper around `LoadingContext.fireLoading`/`endLoading` for the\n * \"context publishes its lifecycle\" use-case. Handles three things consumers\n * would otherwise reinvent:\n *\n * 1. **Tier defaulting** — always emits as `LoadingTier.COMPONENT` (Tier-1\n *    `APPLICATION` is reserved for app-init / language-change events).\n * 2. **Phase derivation** — accepts a single `isLoading` boolean and figures\n *    out whether to emit START or END (and with which phase).\n * 3. **Cleanup** — guarantees an `endLoading` is fired on unmount, so an\n *    in-flight scope can never leak past the provider's lifetime.\n *\n * The hook does **not** own the loading state — the calling context still\n * tracks `isLoading` locally for its own consumers and back-compat. It just\n * mirrors that state to the LoadingContext event bus so unrelated components\n * can observe it via `useComponentLoading({ customIdentifier })` or wrap\n * content in `<LoadingGate scopes={[...]}>`.\n */\n\nimport { useContext, useEffect, useRef } from 'react';\nimport { LoadingContext } from './LoadingContext';\nimport { buildContextLoadingScope } from './loading-scope.frontend.utils';\nimport {\n  ContextLoadingIdentifier,\n  LoadingPhase,\n  LoadingTier,\n} from './loading-types.frontend.schemas';\n\n/**\n * Mirror a context's local `isLoading` boolean onto the LoadingContext event\n * bus under a typed `ContextLoadingIdentifier`.\n *\n * Usage:\n *\n * ```tsx\n * // Inside BillingContext\n * useEmitLoadingScope({\n *   identifier: ContextLoadingIdentifier.BILLING_STATE,\n *   isLoading,\n *   hasLoadedOnce: billingState !== null,\n * });\n * ```\n *\n * Downstream observers:\n *\n * ```tsx\n * const { isInitialLoad } = useComponentLoading({\n *   customIdentifier: ContextLoadingIdentifier.BILLING_STATE,\n * });\n * ```\n *\n * @param params.identifier — typed scope identifier\n * @param params.isLoading — current loading boolean from the context\n * @param params.hasLoadedOnce — distinguishes INITIAL vs REFRESH phase. Pass\n *   `true` once the first successful payload has arrived. Optional; defaults\n *   to `false` (always treats as INITIAL) which is acceptable for contexts\n *   whose first load is the only \"skeleton-worthy\" wait.\n */\nexport function useEmitLoadingScope(params: {\n  identifier: ContextLoadingIdentifier;\n  isLoading: boolean;\n  hasLoadedOnce?: boolean;\n}): void {\n  // Resilience: emission is **opt-in observability**, NOT load-bearing.\n  // A context that calls this hook must remain functional when mounted\n  // outside a `LoadingProvider` (the calling context's own `isLoading` is\n  // still the source of truth for direct consumers). This keeps test\n  // harnesses, isolated story rigs, and minimal-shell apps from being\n  // forced to add `LoadingProvider` just because a downstream context\n  // wants to publish lifecycle events.\n  const loadingCtx = useContext(LoadingContext);\n  const fireLoading = loadingCtx?.fireLoading;\n  const endLoading = loadingCtx?.endLoading;\n\n  const wasLoadingRef = useRef<boolean>(false);\n\n  useEffect(() => {\n    if (!fireLoading || !endLoading) return;\n\n    const scope = buildContextLoadingScope(params.identifier);\n    const tier = LoadingTier.COMPONENT;\n\n    if (params.isLoading && !wasLoadingRef.current) {\n      fireLoading(scope, {\n        tier,\n        phase: params.hasLoadedOnce ? LoadingPhase.REFRESH : LoadingPhase.INITIAL,\n      });\n      wasLoadingRef.current = true;\n    } else if (!params.isLoading && wasLoadingRef.current) {\n      endLoading(scope, { tier });\n      wasLoadingRef.current = false;\n    }\n  }, [params.identifier, params.isLoading, params.hasLoadedOnce, fireLoading, endLoading]);\n\n  useEffect(() => {\n    return () => {\n      if (wasLoadingRef.current && endLoading) {\n        const scope = buildContextLoadingScope(params.identifier);\n        endLoading(scope, { tier: LoadingTier.COMPONENT });\n        wasLoadingRef.current = false;\n      }\n    };\n  }, [params.identifier, endLoading]);\n}\n"]}
+{"version":3,"file":"useEmitLoadingScope.js","sourceRoot":"","sources":["../../../../../src/core/loading/useEmitLoadingScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAEL,YAAY,EACZ,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAInC;IACC,sEAAsE;IACtE,qEAAqE;IACrE,wEAAwE;IACxE,mEAAmE;IACnE,oEAAoE;IACpE,oEAAoE;IACpE,qCAAqC;IACrC,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,UAAU,EAAE,WAAW,CAAC;IAC5C,MAAM,UAAU,GAAG,UAAU,EAAE,UAAU,CAAC;IAE1C,MAAM,aAAa,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAE7C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU;YAAE,OAAO;QAExC,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC;QAEnC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC/C,WAAW,CAAC,KAAK,EAAE;gBACjB,IAAI;gBACJ,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO;aAC1E,CAAC,CAAC;YACH,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YACtD,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5B,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;QAChC,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,aAAa,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC1D,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;gBACnD,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;YAChC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AACtC,CAAC","sourcesContent":["/**\n * useEmitLoadingScope — Tier-2 context loading emitter (L-2.b)\n *\n * Ergonomic wrapper around `LoadingContext.fireLoading`/`endLoading` for the\n * \"context publishes its lifecycle\" use-case. Handles three things consumers\n * would otherwise reinvent:\n *\n * 1. **Tier defaulting** — always emits as `LoadingTier.COMPONENT` (Tier-1\n *    `APPLICATION` is reserved for app-init / language-change events).\n * 2. **Phase derivation** — accepts a single `isLoading` boolean and figures\n *    out whether to emit START or END (and with which phase).\n * 3. **Cleanup** — guarantees an `endLoading` is fired on unmount, so an\n *    in-flight scope can never leak past the provider's lifetime.\n *\n * The hook does **not** own the loading state — the calling context still\n * tracks `isLoading` locally for its own consumers and back-compat. It just\n * mirrors that state to the LoadingContext event bus so unrelated components\n * can observe it via `useComponentLoading({ customIdentifier })` or wrap\n * content in `<LoadingGate scopes={[...]}>`.\n */\n\nimport { useContext, useEffect, useRef } from 'react';\nimport { LoadingContext } from './LoadingContext';\nimport { buildContextLoadingScope } from './loading-scope.frontend.utils';\nimport {\n  ContextLoadingIdentifier,\n  LoadingPhase,\n  LoadingTier,\n} from './loading-types.frontend.schemas';\n\n/**\n * Mirror a context's local `isLoading` boolean onto the LoadingContext event\n * bus under a typed `ContextLoadingIdentifier`.\n *\n * Usage:\n *\n * ```tsx\n * // Inside BillingContext\n * useEmitLoadingScope({\n *   identifier: ContextLoadingIdentifier.BILLING_STATE,\n *   isLoading,\n *   hasLoadedOnce: billingState !== null,\n * });\n * ```\n *\n * Downstream observers:\n *\n * ```tsx\n * const { isInitialLoad } = useComponentLoading({\n *   customIdentifier: ContextLoadingIdentifier.BILLING_STATE,\n * });\n * ```\n *\n * @param params.identifier — typed scope identifier\n * @param params.isLoading — current loading boolean from the context\n * @param params.hasLoadedOnce — distinguishes INITIAL vs REFRESH phase. Pass\n *   `true` once the first successful payload has arrived. Optional; defaults\n *   to `false` (always treats as INITIAL) which is acceptable for contexts\n *   whose first load is the only \"skeleton-worthy\" wait.\n */\nexport function useEmitLoadingScope(params: {\n  identifier: ContextLoadingIdentifier;\n  isLoading: boolean;\n  hasLoadedOnce?: boolean;\n}): void {\n  // Resilience: emission is **opt-in observability**, NOT load-bearing.\n  // A context that calls this hook must remain functional when mounted\n  // outside a `LoadingProvider` (the calling context's own `isLoading` is\n  // still the source of truth for direct consumers). This keeps test\n  // harnesses, isolated story rigs, and minimal-shell apps from being\n  // forced to add `LoadingProvider` just because a downstream context\n  // wants to publish lifecycle events.\n  const loadingCtx = useContext(LoadingContext);\n  const fireLoading = loadingCtx?.fireLoading;\n  const endLoading = loadingCtx?.endLoading;\n\n  const wasLoadingRef = useRef<boolean>(false);\n\n  useEffect(() => {\n    if (!fireLoading || !endLoading) return;\n\n    const scope = buildContextLoadingScope(params.identifier);\n    const tier = LoadingTier.COMPONENT;\n\n    if (params.isLoading && !wasLoadingRef.current) {\n      fireLoading(scope, {\n        tier,\n        phase: params.hasLoadedOnce ? LoadingPhase.REFRESH : LoadingPhase.INITIAL,\n      });\n      wasLoadingRef.current = true;\n    } else if (!params.isLoading && wasLoadingRef.current) {\n      endLoading(scope, { tier });\n      wasLoadingRef.current = false;\n    }\n  }, [params.identifier, params.isLoading, params.hasLoadedOnce, fireLoading, endLoading]);\n\n  useEffect(() => {\n    return () => {\n      if (wasLoadingRef.current && endLoading) {\n        const scope = buildContextLoadingScope(params.identifier);\n        endLoading(scope, { tier: LoadingTier.COMPONENT });\n        wasLoadingRef.current = false;\n      }\n    };\n  }, [params.identifier, endLoading]);\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useLoading.d.ts","sourceRoot":"","sources":["../../../../src/core/loading/useLoading.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,QAAO,kBAM7B,CAAC"}
+{"version":3,"file":"useLoading.d.ts","sourceRoot":"","sources":["../../../../../src/core/loading/useLoading.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,QAAO,kBAM7B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useLoading.js","sourceRoot":"","sources":["../../../../src/core/loading/useLoading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAuB,EAAE;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import { useContext } from 'react';\nimport { LoadingContext, type LoadingContextType } from './LoadingContext';\n\n/**\n * useLoading Hook\n *\n * Separated from LoadingContext.tsx for React Fast Refresh compatibility.\n * Prefer useAppLoading() for Tier 1 or useComponentLoading() for Tier 2 when\n * only those concerns are needed.\n *\n * @returns LoadingContextType with fireLoading, endLoading, and state access\n * @throws Error if used outside of LoadingProvider\n */\nexport const useLoading = (): LoadingContextType => {\n  const context = useContext(LoadingContext);\n  if (!context) {\n    throw new Error('useLoading must be used within a LoadingProvider');\n  }\n  return context;\n};\n\n"]}
+{"version":3,"file":"useLoading.js","sourceRoot":"","sources":["../../../../../src/core/loading/useLoading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAuB,EAAE;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import { useContext } from 'react';\nimport { LoadingContext, type LoadingContextType } from './LoadingContext';\n\n/**\n * useLoading Hook\n *\n * Separated from LoadingContext.tsx for React Fast Refresh compatibility.\n * Prefer useAppLoading() for Tier 1 or useComponentLoading() for Tier 2 when\n * only those concerns are needed.\n *\n * @returns LoadingContextType with fireLoading, endLoading, and state access\n * @throws Error if used outside of LoadingProvider\n */\nexport const useLoading = (): LoadingContextType => {\n  const context = useContext(LoadingContext);\n  if (!context) {\n    throw new Error('useLoading must be used within a LoadingProvider');\n  }\n  return context;\n};\n\n"]}

package/dist/esm/core/mode/AppModeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppModeContext.d.ts","sourceRoot":"","sources":["../../../../src/core/mode/AppModeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAA+E,MAAM,OAAO,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iEAAiE,CAAC;AAQzG,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,kFAAkF;IAClF,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAkED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA6D1D,CAAC;AAMF;;GAEG;AACH,wBAAgB,UAAU,IAAI,mBAAmB,CAMhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,mBAAmB,GAAG,IAAI,CAE3D"}
+{"version":3,"file":"AppModeContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/mode/AppModeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAA+E,MAAM,OAAO,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iEAAiE,CAAC;AAQzG,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,kFAAkF;IAClF,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAkED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA6D1D,CAAC;AAMF;;GAEG;AACH,wBAAgB,UAAU,IAAI,mBAAmB,CAMhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,mBAAmB,GAAG,IAAI,CAE3D"}