npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.6 → 1.1.7 - Mend

@wildo-ai/saas-frontend-lib 1.1.6 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1971) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useIconRegistry.js","sourceRoot":"","sources":["~~../../../../../~~src/core/icons/useIconRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kEAAkE,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAgC,MAAM,uBAAuB,CAAC;AAE1F,MAAM,YAAY,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAA4B,EAAE;IAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,YAAY,CAAC,wBAAwB,CAAC,SAAS,CAAC,aAAa,EAAE;YAChF,OAAO,EAAE,EAAE,OAAO,EAAE,6DAA6D,EAAE;SACpF,CAAC,CAAC;QACH,MAAM,UAAU,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/*\n useIconRegistry Hook\n * \n * Separated from IconRegistryContext.tsx for React Fast Refresh compatibility.\n /\n\nimport { useContext } from 'react';\nimport { ErrorType } from '@wildo-ai/saas-models';\nimport { ErrorBuilderFrontend } from '~wildo-frontend-lib/core/errors/errors-builder.frontend.services';\nimport { IconRegistryContext, type IconRegistryContextType } from './IconRegistryContext';\n\nconst errorBuilder = new ErrorBuilderFrontend();\n\n/\n Hook to access the Icon Registry context\n * @returns IconRegistryContextType with icon lookup functions\n * @throws WildoError if used outside of IconRegistryProvider\n */\nexport const useIconRegistry = (): IconRegistryContextType => {\n const context = useContext(IconRegistryContext);\n\n if (!context) {\n const wildoError = errorBuilder.buildWildoError_Frontend(ErrorType.CONFIGURATION, {\n context: { message: 'useIconRegistry must be used within an IconRegistryProvider' },\n });\n throw wildoError;\n }\n\n return context;\n};\n\n\n\n"]}
1	+ {"version":3,"file":"useIconRegistry.js","sourceRoot":"","sources":["../../../../src/core/icons/useIconRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kEAAkE,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAgC,MAAM,uBAAuB,CAAC;AAE1F,MAAM,YAAY,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAA4B,EAAE;IAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,YAAY,CAAC,wBAAwB,CAAC,SAAS,CAAC,aAAa,EAAE;YAChF,OAAO,EAAE,EAAE,OAAO,EAAE,6DAA6D,EAAE;SACpF,CAAC,CAAC;QACH,MAAM,UAAU,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/*\n useIconRegistry Hook\n * \n * Separated from IconRegistryContext.tsx for React Fast Refresh compatibility.\n /\n\nimport { useContext } from 'react';\nimport { ErrorType } from '@wildo-ai/saas-models';\nimport { ErrorBuilderFrontend } from '~wildo-frontend-lib/core/errors/errors-builder.frontend.services';\nimport { IconRegistryContext, type IconRegistryContextType } from './IconRegistryContext';\n\nconst errorBuilder = new ErrorBuilderFrontend();\n\n/\n Hook to access the Icon Registry context\n * @returns IconRegistryContextType with icon lookup functions\n * @throws WildoError if used outside of IconRegistryProvider\n */\nexport const useIconRegistry = (): IconRegistryContextType => {\n const context = useContext(IconRegistryContext);\n\n if (!context) {\n const wildoError = errorBuilder.buildWildoError_Frontend(ErrorType.CONFIGURATION, {\n context: { message: 'useIconRegistry must be used within an IconRegistryProvider' },\n });\n throw wildoError;\n }\n\n return context;\n};\n\n\n\n"]}

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"AppLoadingGate.js","sourceRoot":"","sources":["~~../../../../../~~src/core/loading/AppLoadingGate.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;AACtD,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAQpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAuB;IAC7E,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAElD,gFAAgF;IAChF,gFAAgF;IAChF,kFAAkF;IAClF,6EAA6E;IAC7E,+EAA+E;IAC/E,wEAAwE;IACxE,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,CAAC,uBAAuB,EAAE,0BAA0B,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,EAAE,CAAC;YACjB,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC;QACnC,CAAC;aAAM,IAAI,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACrC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,sBAAsB,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;IAC1I,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5B,OAAO,CACL,8BACG,QAAQ,EACR,YAAY;gBACX,CAAC,aAAa,CAAC,CAAC,CAAC,CACf,aAAa,CAAC,OAAO,CAAC,CACvB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBAC5B,qEAAqE;gBACrE,sEAAsE;gBACtE,cACE,SAAS,EAAC,qIAAqI,EAC/I,IAAI,EAAC,QAAQ,eACH,QAAQ,gCACS,cAAc,YAEzC,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GACxB,CACP,CAAC,CAAC,CAAC,CACF,cAAK,SAAS,EAAC,+EAA+E,EAAC,IAAI,EAAC,QAAQ,eAAW,QAAQ,YAC7H,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GACxB,CACP,CAAC,IACH,CACJ,CAAC;AACJ,CAAC","sourcesContent":["import React, { useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport { useAppLoading } from './useAppLoading';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AppLoadingGate');\nlogger.setDebugTypeLogging('AppLoadingGate', false);\n\nexport interface AppLoadingGateProps {\n /** Custom full-screen loading renderer. Default: centered spinner. /\n renderLoading?: (sources: { identifier: string }[]) => ReactNode;\n children: ReactNode;\n}\n\n/\n AppLoadingGate — Tier 1 application-level loading gate.\n \n Gates the entire application UI when any app-level loading is active\n * (initialization steps, language change, org switch) by rendering a full-screen\n * loading overlay until all Tier 1 loading sources have resolved.\n \n CRITICAL: the children are ALWAYS rendered; the spinner is layered on top\n * (opaque, `fixed inset-0`) while loading. It must NOT be a `return <Spinner/>`\n * branch that omits `children` — doing so unmounts the entire subtree\n * (`NavigationProvider`, scope, router content, …) every time `isAppLoading`\n * toggles, destroying all of their state. During bootstrap `isAppLoading` toggles\n * several times (init steps, then async primary-scope resolution on a deep-link),\n * so an unmount-style gate wiped navigation/overlay state reconstructed from the\n * URL — a cold deep-link to an overlay surface (e.g. `/settings`) lost its\n * overlay, while in-session navigation (no further loading toggles) kept it.\n * Keeping children mounted lets that state survive; transitions that genuinely\n * need a reset (e.g. org switch) clear it explicitly via `PRIMARY_SCOPE_CHANGED`,\n * not as a side effect of unmounting.\n \n Mount between `<LoadingProvider>` and `<AnonymousSessionProvider>` in the\n * provider tree. This ensures the UI is blocked during critical app-level\n * operations without affecting the loading state management itself.\n \n OPAQUE vs NON-BLOCKING (frontend-ux-quality-audit E5): the opaque full-screen\n * overlay only covers the app BEFORE the first ready render — there is nothing\n * meaningful underneath yet. Once the app has been ready once, later\n * APPLICATION-tier loads (e.g. i18n lazily fetching a label namespace on\n * navigation) render a small non-blocking corner indicator instead: blanking a\n * fully-rendered shell for a background label fetch reads as a crash-and-reload.\n * The mount-stability contract above is unchanged either way — children stay\n * mounted under both indicator styles.\n */\nexport function AppLoadingGate({ renderLoading, children }: AppLoadingGateProps): React.JSX.Element {\n const { isAppLoading, sources } = useAppLoading();\n\n // Latched once the first app-level load CYCLE completes (loading observed, then\n // cleared); never reset. The cycle requirement matters: `LoadingContext` starts\n // with an EMPTY source map, so `isAppLoading` is false on the very first commit —\n // before any init step has registered — and latching on that transient would\n // demote the real bootstrap overlay to the corner indicator. State (not a ref)\n // for the latch itself so the indicator style is consistent per render.\n const hasSeenLoadingRef = useRef(false);\n const [hasCompletedInitialLoad, setHasCompletedInitialLoad] = useState(false);\n useEffect(() => {\n if (isAppLoading) {\n hasSeenLoadingRef.current = true;\n } else if (hasSeenLoadingRef.current) {\n setHasCompletedInitialLoad(true);\n }\n }, [isAppLoading]);\n\n useEffect(() => {\n logDebug(`Gate render state: ${isAppLoading ? 'loading' : 'ready'} [${sources.map(source => source.identifier).join(', ') \|\| 'none'}]`);\n }, [isAppLoading, sources]);\n\n return (\n <>\n {children}\n {isAppLoading &&\n (renderLoading ? (\n renderLoading(sources)\n ) : hasCompletedInitialLoad ? (\n // Post-bootstrap load: unobtrusive corner indicator. Non-interactive\n // (`pointer-events-none`) so the shell stays fully usable underneath.\n <div\n className=\"fixed top-4 end-4 z-(--z-critical) pointer-events-none flex items-center justify-center rounded-full bg-background/80 p-2 shadow-md\"\n role=\"status\"\n aria-live=\"polite\"\n data-app-loading-indicator=\"non-blocking\"\n >\n <LoadingSpinner size={20} />\n </div>\n ) : (\n <div className=\"fixed inset-0 z-(--z-critical) flex items-center justify-center bg-background\" role=\"status\" aria-live=\"polite\">\n <LoadingSpinner size={48} />\n </div>\n ))}\n </>\n );\n}\n"]}
1	+ {"version":3,"file":"AppLoadingGate.js","sourceRoot":"","sources":["../../../../src/core/loading/AppLoadingGate.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;AACtD,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAQpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAuB;IAC7E,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAElD,gFAAgF;IAChF,gFAAgF;IAChF,kFAAkF;IAClF,6EAA6E;IAC7E,+EAA+E;IAC/E,wEAAwE;IACxE,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,CAAC,uBAAuB,EAAE,0BAA0B,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,EAAE,CAAC;YACjB,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC;QACnC,CAAC;aAAM,IAAI,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACrC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,sBAAsB,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;IAC1I,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5B,OAAO,CACL,8BACG,QAAQ,EACR,YAAY;gBACX,CAAC,aAAa,CAAC,CAAC,CAAC,CACf,aAAa,CAAC,OAAO,CAAC,CACvB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBAC5B,qEAAqE;gBACrE,sEAAsE;gBACtE,cACE,SAAS,EAAC,qIAAqI,EAC/I,IAAI,EAAC,QAAQ,eACH,QAAQ,gCACS,cAAc,YAEzC,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GACxB,CACP,CAAC,CAAC,CAAC,CACF,cAAK,SAAS,EAAC,+EAA+E,EAAC,IAAI,EAAC,QAAQ,eAAW,QAAQ,YAC7H,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GACxB,CACP,CAAC,IACH,CACJ,CAAC;AACJ,CAAC","sourcesContent":["import React, { useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport { useAppLoading } from './useAppLoading';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AppLoadingGate');\nlogger.setDebugTypeLogging('AppLoadingGate', false);\n\nexport interface AppLoadingGateProps {\n /** Custom full-screen loading renderer. Default: centered spinner. /\n renderLoading?: (sources: { identifier: string }[]) => ReactNode;\n children: ReactNode;\n}\n\n/\n AppLoadingGate — Tier 1 application-level loading gate.\n \n Gates the entire application UI when any app-level loading is active\n * (initialization steps, language change, org switch) by rendering a full-screen\n * loading overlay until all Tier 1 loading sources have resolved.\n \n CRITICAL: the children are ALWAYS rendered; the spinner is layered on top\n * (opaque, `fixed inset-0`) while loading. It must NOT be a `return <Spinner/>`\n * branch that omits `children` — doing so unmounts the entire subtree\n * (`NavigationProvider`, scope, router content, …) every time `isAppLoading`\n * toggles, destroying all of their state. During bootstrap `isAppLoading` toggles\n * several times (init steps, then async primary-scope resolution on a deep-link),\n * so an unmount-style gate wiped navigation/overlay state reconstructed from the\n * URL — a cold deep-link to an overlay surface (e.g. `/settings`) lost its\n * overlay, while in-session navigation (no further loading toggles) kept it.\n * Keeping children mounted lets that state survive; transitions that genuinely\n * need a reset (e.g. org switch) clear it explicitly via `PRIMARY_SCOPE_CHANGED`,\n * not as a side effect of unmounting.\n \n Mount between `<LoadingProvider>` and `<AnonymousSessionProvider>` in the\n * provider tree. This ensures the UI is blocked during critical app-level\n * operations without affecting the loading state management itself.\n \n OPAQUE vs NON-BLOCKING (frontend-ux-quality-audit E5): the opaque full-screen\n * overlay only covers the app BEFORE the first ready render — there is nothing\n * meaningful underneath yet. Once the app has been ready once, later\n * APPLICATION-tier loads (e.g. i18n lazily fetching a label namespace on\n * navigation) render a small non-blocking corner indicator instead: blanking a\n * fully-rendered shell for a background label fetch reads as a crash-and-reload.\n * The mount-stability contract above is unchanged either way — children stay\n * mounted under both indicator styles.\n */\nexport function AppLoadingGate({ renderLoading, children }: AppLoadingGateProps): React.JSX.Element {\n const { isAppLoading, sources } = useAppLoading();\n\n // Latched once the first app-level load CYCLE completes (loading observed, then\n // cleared); never reset. The cycle requirement matters: `LoadingContext` starts\n // with an EMPTY source map, so `isAppLoading` is false on the very first commit —\n // before any init step has registered — and latching on that transient would\n // demote the real bootstrap overlay to the corner indicator. State (not a ref)\n // for the latch itself so the indicator style is consistent per render.\n const hasSeenLoadingRef = useRef(false);\n const [hasCompletedInitialLoad, setHasCompletedInitialLoad] = useState(false);\n useEffect(() => {\n if (isAppLoading) {\n hasSeenLoadingRef.current = true;\n } else if (hasSeenLoadingRef.current) {\n setHasCompletedInitialLoad(true);\n }\n }, [isAppLoading]);\n\n useEffect(() => {\n logDebug(`Gate render state: ${isAppLoading ? 'loading' : 'ready'} [${sources.map(source => source.identifier).join(', ') \|\| 'none'}]`);\n }, [isAppLoading, sources]);\n\n return (\n <>\n {children}\n {isAppLoading &&\n (renderLoading ? (\n renderLoading(sources)\n ) : hasCompletedInitialLoad ? (\n // Post-bootstrap load: unobtrusive corner indicator. Non-interactive\n // (`pointer-events-none`) so the shell stays fully usable underneath.\n <div\n className=\"fixed top-4 end-4 z-(--z-critical) pointer-events-none flex items-center justify-center rounded-full bg-background/80 p-2 shadow-md\"\n role=\"status\"\n aria-live=\"polite\"\n data-app-loading-indicator=\"non-blocking\"\n >\n <LoadingSpinner size={20} />\n </div>\n ) : (\n <div className=\"fixed inset-0 z-(--z-critical) flex items-center justify-center bg-background\" role=\"status\" aria-live=\"polite\">\n <LoadingSpinner size={48} />\n </div>\n ))}\n </>\n );\n}\n"]}

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"LoadingBarrier.js","sourceRoot":"","sources":["../../../../../src/core/loading/LoadingBarrier.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { LoadingErrorContext } from './loading-types.frontend.schemas';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nenum ParticipantStatus {\n PENDING = 'pending',\n READY = 'ready',\n ERROR = 'error',\n}\n\ninterface BarrierRegistration {\n markReady: () => void;\n markError: (error?: unknown) => void;\n /** Remove this participant from the barrier — call in useEffect cleanup /\n unregister: () => void;\n}\n\ninterface LoadingBarrierContextType {\n register: (id: string) => BarrierRegistration;\n /* Incremented on each retry — children can depend on this to re-trigger loading /\n retryCounter: number;\n}\n\n// ─── Context ────────────────────────────────────────────────────────────────\n\nconst LoadingBarrierContext = createContext<LoadingBarrierContextType \| null>(null);\n\n/\n Hook for child components to register themselves as barrier participants.\n \n Call `register(id)` once (typically in a useEffect) and use the returned\n * `markReady` / `markError` / `unregister` to manage the child's lifecycle.\n * Call `unregister()` in the useEffect cleanup to prevent dangling participants.\n \n Use `retryCounter` as a dependency in effects that need to re-trigger loading\n * when the barrier's retry handler fires.\n \n @throws Error if used outside a `<LoadingBarrier>`\n /\nexport function useBarrierParticipant(): LoadingBarrierContextType {\n const ctx = useContext(LoadingBarrierContext);\n if (!ctx) throw new Error('useBarrierParticipant must be used within a LoadingBarrier');\n return ctx;\n}\n\n// ─── Props ──────────────────────────────────────────────────────────────────\n\nexport interface LoadingBarrierProps {\n /* Custom loading renderer — shown while children are registering and loading /\n renderLoading?: () => ReactNode;\n /* Error renderer — shown on timeout or participant error /\n renderError?: (context: LoadingErrorContext) => ReactNode;\n /* Timeout in ms after which the barrier shows an error. Default: no timeout. /\n timeoutMs?: number;\n children: ReactNode;\n}\n\n/\n LoadingBarrier — Composite loading gate for dynamic views.\n \n Used when the set of loading dependencies is determined by children at\n * render time (e.g., a dashboard with multiple independently-loaded cards,\n * a side menu with multiple resource counts).\n \n Children self-register as participants via `useBarrierParticipant()`,\n * then call `markReady()` or `markError()` when loaded. The barrier\n * renders children invisibly (opacity 0, pointer-events none) until all\n * participants are ready, then transitions to full visibility.\n \n @see loading-system-architecture.md §2.5 \"LoadingBarrier\"\n /\nexport function LoadingBarrier({\n renderLoading,\n renderError,\n timeoutMs,\n children,\n}: LoadingBarrierProps): React.JSX.Element {\n const participantsRef = useRef<Map<string, { status: ParticipantStatus; error?: unknown }>>(new Map());\n const [, forceRender] = useState(0);\n const [timedOut, setTimedOut] = useState(false);\n const [retryCounter, setRetryCounter] = useState(0);\n const mountTimeRef = useRef(Date.now());\n\n // ── Participant registration ──────────────────────────────────────────\n\n const register = useCallback((id: string): BarrierRegistration => {\n if (!participantsRef.current.has(id)) {\n participantsRef.current.set(id, { status: ParticipantStatus.PENDING });\n forceRender(c => c + 1);\n }\n\n return {\n markReady: () => {\n const entry = participantsRef.current.get(id);\n if (entry && entry.status !== ParticipantStatus.READY) {\n participantsRef.current.set(id, { status: ParticipantStatus.READY });\n forceRender(c => c + 1);\n }\n },\n markError: (error?: unknown) => {\n const entry = participantsRef.current.get(id);\n if (entry && entry.status !== ParticipantStatus.ERROR) {\n participantsRef.current.set(id, { status: ParticipantStatus.ERROR, error });\n forceRender(c => c + 1);\n }\n },\n unregister: () => {\n if (participantsRef.current.has(id)) {\n participantsRef.current.delete(id);\n forceRender(c => c + 1);\n }\n },\n };\n }, []);\n\n // ── Derive aggregate state ────────────────────────────────────────────\n\n const participants = participantsRef.current;\n const hasParticipants = participants.size > 0;\n const allReady = hasParticipants && Array.from(participants.values()).every(p => p.status === ParticipantStatus.READY);\n const hasError = Array.from(participants.values()).some(p => p.status === ParticipantStatus.ERROR);\n\n // ── Timeout handling ──────────────────────────────────────────────────\n\n useEffect(() => {\n if (allReady \|\| !timeoutMs) return;\n\n const elapsed = Date.now() - mountTimeRef.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 useEffect(() => {\n if (allReady) setTimedOut(false);\n }, [allReady]);\n\n // ── Context value ─────────────────────────────────────────────────────\n\n const contextValue = useMemo((): LoadingBarrierContextType => ({ register, retryCounter }), [register, retryCounter]);\n\n // ── Error state ───────────────────────────────────────────────────────\n\n if ((timedOut \|\| hasError) && renderError) {\n const failedEntries = Array.from(participants.entries())\n .filter(([, p]) => p.status !== ParticipantStatus.READY);\n const failedScopes = failedEntries.map(([id]) => ({ customIdentifier: id }));\n const firstError = failedEntries.find(([, p]) => p.error)?.[1]?.error;\n\n return (\n <LoadingBarrierContext.Provider value={contextValue}>\n {renderError({\n failedScopes,\n reason: hasError ? 'error' : 'timeout',\n error: firstError,\n retry: () => {\n setTimedOut(false);\n mountTimeRef.current = Date.now();\n for (const [id] of participants) {\n participants.set(id, { status: ParticipantStatus.PENDING });\n }\n setRetryCounter(c => c + 1);\n forceRender(c => c + 1);\n },\n })}\n </LoadingBarrierContext.Provider>\n );\n }\n\n // ── Render ────────────────────────────────────────────────────────────\n\n const isLoading = !allReady;\n\n return (\n <LoadingBarrierContext.Provider value={contextValue}>\n <div className=\"relative\">\n {/ Children always render (to enable self-registration), but hidden while loading /}\n <div\n style={{\n opacity: isLoading ? 0 : 1,\n pointerEvents: isLoading ? 'none' : 'auto',\n transition: 'opacity 200ms ease-out',\n }}\n aria-hidden={isLoading}\n >\n {children}\n </div>\n\n {/ Loading overlay — positioned over the invisible children */}\n {isLoading && (\n <div className=\"absolute inset-0 flex items-center justify-center\">\n {renderLoading ? renderLoading() : <LoadingSpinner size={32} />}\n </div>\n )}\n </div>\n </LoadingBarrierContext.Provider>\n );\n}\n"]}
1	+ {"version":3,"file":"LoadingBarrier.js","sourceRoot":"","sources":["../../../../src/core/loading/LoadingBarrier.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5G,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AAEzF,+EAA+E;AAE/E,IAAK,iBAIJ;AAJD,WAAK,iBAAiB;IACpB,wCAAmB,CAAA;IACnB,oCAAe,CAAA;IACf,oCAAe,CAAA;AACjB,CAAC,EAJI,iBAAiB,KAAjB,iBAAiB,QAIrB;AAeD,+EAA+E;AAE/E,MAAM,qBAAqB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAEpF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACxF,OAAO,GAAG,CAAC;AACb,CAAC;AAcD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,GACY;IACpB,MAAM,eAAe,GAAG,MAAM,CAA8D,IAAI,GAAG,EAAE,CAAC,CAAC;IACvG,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAExC,yEAAyE;IAEzE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAU,EAAuB,EAAE;QAC/D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,SAAS,EAAE,GAAG,EAAE;gBACd,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,iBAAiB,CAAC,KAAK,EAAE,CAAC;oBACtD,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC;oBACrE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,SAAS,EAAE,CAAC,KAAe,EAAE,EAAE;gBAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,iBAAiB,CAAC,KAAK,EAAE,CAAC;oBACtD,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC5E,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACpC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACnC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,yEAAyE;IAEzE,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC;IAC7C,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,eAAe,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvH,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAEnG,yEAAyE;IAEzE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,IAAI,CAAC,SAAS;YAAE,OAAO;QAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC;QAClD,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;QAEtC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAE1B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ;YAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,yEAAyE;IAEzE,MAAM,YAAY,GAAG,OAAO,CAAC,GAA8B,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAEtH,yEAAyE;IAEzE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;aACrD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAEtE,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAChD,WAAW,CAAC;gBACX,YAAY;gBACZ,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACtC,KAAK,EAAE,UAAU;gBACjB,KAAK,EAAE,GAAG,EAAE;oBACV,WAAW,CAAC,KAAK,CAAC,CAAC;oBACnB,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAClC,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;wBAChC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC9D,CAAC;oBACD,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC5B,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC;aACF,CAAC,GAC6B,CAClC,CAAC;IACJ,CAAC;IAED,yEAAyE;IAEzE,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC;IAE5B,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YACjD,eAAK,SAAS,EAAC,UAAU,aAEvB,cACE,KAAK,EAAE;wBACL,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC1B,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;wBAC1C,UAAU,EAAE,wBAAwB;qBACrC,iBACY,SAAS,YAErB,QAAQ,GACL,EAGL,SAAS,IAAI,CACZ,cAAK,SAAS,EAAC,mDAAmD,YAC/D,aAAa,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,KAAC,cAAc,IAAC,IAAI,EAAE,EAAE,GAAI,GAC3D,CACP,IACG,GACyB,CAClC,CAAC;AACJ,CAAC","sourcesContent":["import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { LoadingErrorContext } from './loading-types.frontend.schemas';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nenum ParticipantStatus {\n PENDING = 'pending',\n READY = 'ready',\n ERROR = 'error',\n}\n\ninterface BarrierRegistration {\n markReady: () => void;\n markError: (error?: unknown) => void;\n /** Remove this participant from the barrier — call in useEffect cleanup /\n unregister: () => void;\n}\n\ninterface LoadingBarrierContextType {\n register: (id: string) => BarrierRegistration;\n /* Incremented on each retry — children can depend on this to re-trigger loading /\n retryCounter: number;\n}\n\n// ─── Context ────────────────────────────────────────────────────────────────\n\nconst LoadingBarrierContext = createContext<LoadingBarrierContextType \| null>(null);\n\n/\n Hook for child components to register themselves as barrier participants.\n \n Call `register(id)` once (typically in a useEffect) and use the returned\n * `markReady` / `markError` / `unregister` to manage the child's lifecycle.\n * Call `unregister()` in the useEffect cleanup to prevent dangling participants.\n \n Use `retryCounter` as a dependency in effects that need to re-trigger loading\n * when the barrier's retry handler fires.\n \n @throws Error if used outside a `<LoadingBarrier>`\n /\nexport function useBarrierParticipant(): LoadingBarrierContextType {\n const ctx = useContext(LoadingBarrierContext);\n if (!ctx) throw new Error('useBarrierParticipant must be used within a LoadingBarrier');\n return ctx;\n}\n\n// ─── Props ──────────────────────────────────────────────────────────────────\n\nexport interface LoadingBarrierProps {\n /* Custom loading renderer — shown while children are registering and loading /\n renderLoading?: () => ReactNode;\n /* Error renderer — shown on timeout or participant error /\n renderError?: (context: LoadingErrorContext) => ReactNode;\n /* Timeout in ms after which the barrier shows an error. Default: no timeout. /\n timeoutMs?: number;\n children: ReactNode;\n}\n\n/\n LoadingBarrier — Composite loading gate for dynamic views.\n \n Used when the set of loading dependencies is determined by children at\n * render time (e.g., a dashboard with multiple independently-loaded cards,\n * a side menu with multiple resource counts).\n \n Children self-register as participants via `useBarrierParticipant()`,\n * then call `markReady()` or `markError()` when loaded. The barrier\n * renders children invisibly (opacity 0, pointer-events none) until all\n * participants are ready, then transitions to full visibility.\n \n @see loading-system-architecture.md §2.5 \"LoadingBarrier\"\n /\nexport function LoadingBarrier({\n renderLoading,\n renderError,\n timeoutMs,\n children,\n}: LoadingBarrierProps): React.JSX.Element {\n const participantsRef = useRef<Map<string, { status: ParticipantStatus; error?: unknown }>>(new Map());\n const [, forceRender] = useState(0);\n const [timedOut, setTimedOut] = useState(false);\n const [retryCounter, setRetryCounter] = useState(0);\n const mountTimeRef = useRef(Date.now());\n\n // ── Participant registration ──────────────────────────────────────────\n\n const register = useCallback((id: string): BarrierRegistration => {\n if (!participantsRef.current.has(id)) {\n participantsRef.current.set(id, { status: ParticipantStatus.PENDING });\n forceRender(c => c + 1);\n }\n\n return {\n markReady: () => {\n const entry = participantsRef.current.get(id);\n if (entry && entry.status !== ParticipantStatus.READY) {\n participantsRef.current.set(id, { status: ParticipantStatus.READY });\n forceRender(c => c + 1);\n }\n },\n markError: (error?: unknown) => {\n const entry = participantsRef.current.get(id);\n if (entry && entry.status !== ParticipantStatus.ERROR) {\n participantsRef.current.set(id, { status: ParticipantStatus.ERROR, error });\n forceRender(c => c + 1);\n }\n },\n unregister: () => {\n if (participantsRef.current.has(id)) {\n participantsRef.current.delete(id);\n forceRender(c => c + 1);\n }\n },\n };\n }, []);\n\n // ── Derive aggregate state ────────────────────────────────────────────\n\n const participants = participantsRef.current;\n const hasParticipants = participants.size > 0;\n const allReady = hasParticipants && Array.from(participants.values()).every(p => p.status === ParticipantStatus.READY);\n const hasError = Array.from(participants.values()).some(p => p.status === ParticipantStatus.ERROR);\n\n // ── Timeout handling ──────────────────────────────────────────────────\n\n useEffect(() => {\n if (allReady \|\| !timeoutMs) return;\n\n const elapsed = Date.now() - mountTimeRef.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 useEffect(() => {\n if (allReady) setTimedOut(false);\n }, [allReady]);\n\n // ── Context value ─────────────────────────────────────────────────────\n\n const contextValue = useMemo((): LoadingBarrierContextType => ({ register, retryCounter }), [register, retryCounter]);\n\n // ── Error state ───────────────────────────────────────────────────────\n\n if ((timedOut \|\| hasError) && renderError) {\n const failedEntries = Array.from(participants.entries())\n .filter(([, p]) => p.status !== ParticipantStatus.READY);\n const failedScopes = failedEntries.map(([id]) => ({ customIdentifier: id }));\n const firstError = failedEntries.find(([, p]) => p.error)?.[1]?.error;\n\n return (\n <LoadingBarrierContext.Provider value={contextValue}>\n {renderError({\n failedScopes,\n reason: hasError ? 'error' : 'timeout',\n error: firstError,\n retry: () => {\n setTimedOut(false);\n mountTimeRef.current = Date.now();\n for (const [id] of participants) {\n participants.set(id, { status: ParticipantStatus.PENDING });\n }\n setRetryCounter(c => c + 1);\n forceRender(c => c + 1);\n },\n })}\n </LoadingBarrierContext.Provider>\n );\n }\n\n // ── Render ────────────────────────────────────────────────────────────\n\n const isLoading = !allReady;\n\n return (\n <LoadingBarrierContext.Provider value={contextValue}>\n <div className=\"relative\">\n {/ Children always render (to enable self-registration), but hidden while loading /}\n <div\n style={{\n opacity: isLoading ? 0 : 1,\n pointerEvents: isLoading ? 'none' : 'auto',\n transition: 'opacity 200ms ease-out',\n }}\n aria-hidden={isLoading}\n >\n {children}\n </div>\n\n {/ Loading overlay — positioned over the invisible children */}\n {isLoading && (\n <div className=\"absolute inset-0 flex items-center justify-center\">\n {renderLoading ? renderLoading() : <LoadingSpinner size={32} />}\n </div>\n )}\n </div>\n </LoadingBarrierContext.Provider>\n );\n}\n"]}

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

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

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

	@@ -1 +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 /\n * The person this tab knew is gone (#1996): the next person must see every resource's first-load state,\n * not inherit the previous person's \"already loaded\" marks. `USER_LOGOUT` is announced once per\n * departure on every path — sign-out, a refused refresh, a failed restore, another tab's sign-out, a\n * replacement. This listened to `AUTH_LOGOUT_REQUIRED` before, an event nothing ever emitted.\n */\n unsubscribes.push(\n frontendEventBus.on(FrontendEvents.USER_LOGOUT, () => {\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"]}
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 /\n * The person this tab knew is gone (#1996): the next person must see every resource's first-load state,\n * not inherit the previous person's \"already loaded\" marks. `USER_LOGOUT` is announced once per\n * departure on every path — sign-out, a refused refresh, a failed restore, another tab's sign-out, a\n * replacement. This listened to `AUTH_LOGOUT_REQUIRED` before, an event nothing ever emitted.\n */\n unsubscribes.push(\n frontendEventBus.on(FrontendEvents.USER_LOGOUT, () => {\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 CHANGED Viewed

	@@ -1 +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;AAkDD;;;;;;;;;;;;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"}
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;AAkDD;;;;;;;;;;;;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.map CHANGED Viewed

	@@ -1 +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 The box a READY child-keeping gate wraps its children in — transparent to its PARENT's layout model.\n \n `display: contents` is transparent to a FLEX or GRID parent: the children become the items, so gaps,\n * `h-full` chains and grid placement all survive (the reason the wrapper is `contents` at all — see the\n * comment where it renders). It is NOT transparent to a MARGIN STACK. `space-y-` spaces a parent's\n children with `margin-block-end` on each one, and a `contents` box has no box to hold a margin, so the\n * gap after every gated surface vanished: measured 2026-09-25 on Wonder Todos, where a todo's record body\n * and the workspace composite below it touched edge to edge on every READ page, because the displayer's\n * gate sat directly inside the read layout's `space-y-section`.\n \n In a margin stack the parent is ordinary block flow, and there a plain block wrapper is the transparent\n * choice: it lays out exactly as its content would and carries the stack's margin. So the gate is a block\n * box when its parent is a `space-y-` stack and `contents` everywhere else. Keyed on the parent's own\n utility because that is the layout decision the gate has to agree with; the class list is the only place\n * it is written down.\n /\nconst READY_GATE_TRANSPARENT_BOX_CLASS = \"contents [:where([class='space-y-'])>&]:block\";\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={READY_GATE_TRANSPARENT_BOX_CLASS} 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"]}
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 The box a READY child-keeping gate wraps its children in — transparent to its PARENT's layout model.\n \n `display: contents` is transparent to a FLEX or GRID parent: the children become the items, so gaps,\n * `h-full` chains and grid placement all survive (the reason the wrapper is `contents` at all — see the\n * comment where it renders). It is NOT transparent to a MARGIN STACK. `space-y-` spaces a parent's\n children with `margin-block-end` on each one, and a `contents` box has no box to hold a margin, so the\n * gap after every gated surface vanished: measured 2026-09-25 on Wonder Todos, where a todo's record body\n * and the workspace composite below it touched edge to edge on every READ page, because the displayer's\n * gate sat directly inside the read layout's `space-y-section`.\n \n In a margin stack the parent is ordinary block flow, and there a plain block wrapper is the transparent\n * choice: it lays out exactly as its content would and carries the stack's margin. So the gate is a block\n * box when its parent is a `space-y-` stack and `contents` everywhere else. Keyed on the parent's own\n utility because that is the layout decision the gate has to agree with; the class list is the only place\n * it is written down.\n /\nconst READY_GATE_TRANSPARENT_BOX_CLASS = \"contents [:where([class='space-y-'])>&]:block\";\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={READY_GATE_TRANSPARENT_BOX_CLASS} 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 CHANGED Viewed

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

	@@ -1 +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"}
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"}