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

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

@@ -1 +1 @@
-{"version":3,"file":"icon-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/icons/icon-registry.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\nimport { ResourceType } from '@wildo-ai/saas-models';\n\n/**\n * Standard Icon References\n * These are the standard icons used across the application\n */\nexport enum StandardIconReference {\n  // Navigation\n  HOME = 'home',\n  MENU = 'menu',\n  CLOSE = 'close',\n  BACK = 'back',\n  FORWARD = 'forward',\n  \n  // Actions\n  ADD = 'add',\n  EDIT = 'edit',\n  DELETE = 'delete',\n  SAVE = 'save',\n  CANCEL = 'cancel',\n  SEARCH = 'search',\n  FILTER = 'filter',\n  REFRESH = 'refresh',\n  DOWNLOAD = 'download',\n  UPLOAD = 'upload',\n  COPY = 'copy',\n  SHARE = 'share',\n  \n  // Status\n  SUCCESS = 'success',\n  ERROR = 'error',\n  WARNING = 'warning',\n  INFO = 'info',\n  LOADING = 'loading',\n  \n  // Error Display\n  ERROR_NOT_FOUND = 'error_not_found',\n  ERROR_ACCESS_DENIED = 'error_access_denied',\n  ERROR_SERVER = 'error_server',\n  ERROR_APPLICATION = 'error_application',\n  ERROR_UNKNOWN = 'error_unknown',\n  RELOAD = 'reload',\n  TRY_AGAIN = 'try_again',\n  \n  // User\n  USER = 'user',\n  USERS = 'users',\n  PROFILE = 'profile',\n  SETTINGS = 'settings',\n  LOGOUT = 'logout',\n  LOGIN = 'login',\n  \n  // Organization\n  ORGANIZATION = 'organization',\n  TEAM = 'team',\n  \n  // Files\n  FILE = 'file',\n  FILE_IMAGE = 'file_image',\n  FILE_VIDEO = 'file_video',\n  FILE_AUDIO = 'file_audio',\n  FILE_TEXT = 'file_text',\n  FILE_SPREADSHEET = 'file_spreadsheet',\n  FILE_PRESENTATION = 'file_presentation',\n  FILE_ARCHIVE = 'file_archive',\n  FOLDER = 'folder',\n  \n  // Communication\n  MAIL = 'mail',\n  NOTIFICATION = 'notification',\n  CHAT = 'chat',\n  \n  // Misc\n  CALENDAR = 'calendar',\n  CLOCK = 'clock',\n  LOCK = 'lock',\n  UNLOCK = 'unlock',\n  HELP = 'help',\n  EXTERNAL_LINK = 'external_link',\n  MORE = 'more',\n  CHEVRON_DOWN = 'chevron_down',\n  CHEVRON_UP = 'chevron_up',\n  CHEVRON_LEFT = 'chevron_left',\n  CHEVRON_RIGHT = 'chevron_right',\n  \n  // UI Pattern Icons - Checks & Indicators\n  CHECK = 'check',\n  CHECK_CIRCLE = 'check_circle',\n  X_CIRCLE = 'x_circle',\n  CIRCLE = 'circle',\n  MINUS = 'minus',\n  DOT = 'dot',\n  \n  // UI Pattern Icons - Chevrons & Arrows\n  CHEVRONS_UP_DOWN = 'chevrons_up_down',\n  ARROW_LEFT = 'arrow_left',\n  ARROW_RIGHT = 'arrow_right',\n  ARROW_DOWN = 'arrow_down',\n  CORNER_DOWN_LEFT = 'corner_down_left',\n  \n  // UI Pattern Icons - Actions & Controls\n  GRIP_VERTICAL = 'grip_vertical',\n  MORE_HORIZONTAL = 'more_horizontal',\n  /** Sidebar-toggle glyph for a START-placed panel. Distinct from the CHEVRON/ARROW family on purpose: a chevron reads as NAVIGATION (back/forward), and a panel toggle is not navigation. */\n  PANEL_LEFT = 'panel_left',\n  /** Mirror of {@link PANEL_LEFT} for an END-placed panel. */\n  PANEL_RIGHT = 'panel_right',\n  /** Collection \"cards / stacked rows\" view-mode toggle option. */\n  VIEW_LIST = 'view_list',\n  /** Collection \"table / grid\" view-mode toggle option. */\n  VIEW_TABLE = 'view_table',\n  PAPERCLIP = 'paperclip',\n  PLUS = 'plus',\n  SQUARE = 'square',\n  IMAGE = 'image',\n  MIC = 'mic',\n  LOADER_2 = 'loader_2',\n  WRENCH = 'wrench',\n  \n  // Content Icons\n  BOOK = 'book',\n  BOOKMARK = 'bookmark',\n  /** Favorite/star toggle (sidebar favorites, starred items). Filled state is caller-owned via `fill-current`. */\n  STAR = 'star',\n  BRAIN = 'brain',\n  MESSAGE_CIRCLE = 'message_circle',\n  \n  // Document & File Icons\n  DOCUMENT = 'document',\n  X_MARK = 'x_mark',\n  \n  // Visibility Icons\n  EYE = 'eye',\n  EYE_OFF = 'eye_off',\n\n  // Security Icons — account-protection factors (Settings Hub → Security).\n  // The industry-recognised glyph for each authentication method, so a user\n  // scanning the panel identifies the method before reading its label.\n  /** Passkey / WebAuthn credential (biometric-backed device credential). */\n  FINGERPRINT = 'fingerprint',\n  /** Authenticator app / SMS factor — anything bound to the user's handset. */\n  SMARTPHONE = 'smartphone',\n  /** Password or other secret-based credential. */\n  KEY = 'key',\n  /** A linked external identity (social / enterprise SSO account). */\n  LINK = 'link',\n\n  // Billing Icons\n  CREDIT_CARD = 'credit_card',\n  INVOICE = 'invoice',\n  SUBSCRIPTION = 'subscription',\n  CREDIT_POOL = 'credit_pool',\n  PROMOTION = 'promotion',\n  METER = 'meter',\n  RECEIPT = 'receipt',\n\n  // Data Visualization\n  CHART = 'chart',\n\n  // Animation-capable icons (have animated overlays when registered)\n  LOADING_LIGHT = 'loading_light',\n  LOADING_DARK = 'loading_dark',\n  NETWORK_ERROR = 'network_error',\n  TADA = 'tada',\n}\n\nexport const StandardIconReferenceSchema: z.ZodEnum<typeof StandardIconReference> = z.enum(StandardIconReference);\n\n/**\n * Icon Categories\n */\nexport enum IconCategory {\n  RESOURCES = 'resources',\n  OPERATION_RESOURCES = 'operation_resources',\n  ENUM_VALUES = 'enum_values',\n  STANDARD = 'standard',\n  COMPOSITE_VIEW = 'composite_view',\n  CUSTOM = 'custom',\n}\n\nexport const IconCategorySchema: z.ZodEnum<typeof IconCategory> = z.enum(IconCategory);\n\n/**\n * Icon size variants\n */\nexport enum IconSize {\n  XS = 'xs',\n  SM = 'sm',\n  MD = 'md',\n  LG = 'lg',\n  XL = 'xl',\n}\n\nexport const IconSizeSchema: z.ZodEnum<typeof IconSize> = z.enum(IconSize);\n\nconst IconRequest_ResourcesSchema = z.object({\n  category: z.literal(IconCategory.RESOURCES),\n  resourceType: z.string(),\n});\n\nconst IconRequest_OperationResourcesSchema = z.object({\n  category: z.literal(IconCategory.OPERATION_RESOURCES),\n  resourceType: z.string(),\n  operationReference: z.string(),\n});\n\nconst IconRequest_EnumValuesSchema = z.object({\n  category: z.literal(IconCategory.ENUM_VALUES),\n  enumReference: z.string(),\n  enumValue: z.string(),\n});\n\nconst IconRequest_StandardSchema = z.object({\n  category: z.literal(IconCategory.STANDARD),\n  iconReference: StandardIconReferenceSchema,\n});\n\nconst IconRequest_CompositeViewSchema = z.object({\n  category: z.literal(IconCategory.COMPOSITE_VIEW),\n  viewReference: z.string(),\n});\n\nconst IconRequest_CustomSchema = z.object({\n  category: z.literal(IconCategory.CUSTOM),\n  customReference: z.string(),\n});\n\nexport const IconRequestSchema = z.discriminatedUnion('category', [\n  IconRequest_ResourcesSchema,\n  IconRequest_OperationResourcesSchema,\n  IconRequest_EnumValuesSchema,\n  IconRequest_StandardSchema,\n  IconRequest_CompositeViewSchema,\n  IconRequest_CustomSchema,\n]);\n\nexport const IconPropsSchema = z.object({\n  request: IconRequestSchema,\n  size: IconSizeSchema.optional(),\n  className: z.string().optional(),\n  strokeWidth: z.number().optional(),\n  color: z.string().optional(),\n});\n\nexport type IconRequest_Resources = z.infer<typeof IconRequest_ResourcesSchema>;\nexport type IconRequest_OperationResources = z.infer<typeof IconRequest_OperationResourcesSchema>;\nexport type IconRequest_EnumValues = z.infer<typeof IconRequest_EnumValuesSchema>;\nexport type IconRequest_Standard = z.infer<typeof IconRequest_StandardSchema>;\nexport type IconRequest_CompositeView = z.infer<typeof IconRequest_CompositeViewSchema>;\nexport type IconRequest_Custom = z.infer<typeof IconRequest_CustomSchema>;\nexport type IconRequest = z.infer<typeof IconRequestSchema>;\nexport type IconProps = z.infer<typeof IconPropsSchema>;\n\n/**\n * Icon size to pixel mapping\n */\nexport const ICON_SIZE_MAP: Record<IconSize, number> = {\n  [IconSize.XS]: 12,\n  [IconSize.SM]: 16,\n  [IconSize.MD]: 20,\n  [IconSize.LG]: 24,\n  [IconSize.XL]: 32,\n};\n\n/**\n * Icon render options (used by both simple and registry APIs)\n */\nexport interface IconRenderOptions {\n  size?: IconSize;\n  className?: string;\n  strokeWidth?: number;\n  color?: string;\n}\n\n/**\n * Framework-owned abstract icon component props.\n * Any icon library whose components accept these props (Lucide, custom SVGs, emoji wrappers)\n * can be registered as an IconComponent without adapters.\n */\nexport interface IconComponentProps {\n  size?: number;\n  className?: string;\n  strokeWidth?: number;\n  color?: string;\n}\n\n/**\n * Any React component that accepts IconComponentProps.\n * Concrete implementations include Lucide icons, emoji wrappers (via createEmojiIcon),\n * custom SVG components, or any future icon source.\n */\nexport type IconComponent = ComponentType<IconComponentProps>;\n\n/**\n * Animation configuration for animated icons (Lottie JSON / DotLottie).\n * All fields are config-time concerns — set at registration, not at render callsites.\n */\nexport interface IconAnimationConfig {\n  /** Lottie JSON animation data */\n  animationData?: object;\n  /** DotLottie URL (base64 data URL or HTTP URL) */\n  dotLottieUrl?: string;\n  /** Whether the animation loops (intrinsic to the asset, not the consumer) */\n  loop: boolean;\n  /** Whether to autoplay on mount */\n  autoplay: boolean;\n  /** Playback speed multiplier (1 = normal). Currently applies to dotLottie sources only — lottie-react controls speed via its imperative API, not props. */\n  speed?: number;\n  /** Below this size threshold, the static icon fallback is used instead of the animation */\n  minSize?: IconSize;\n}\n\n/**\n * Icon configuration for themable icons.\n * The static `icon` component is always present and serves as the fallback.\n *\n * For standard icons, animations are registered via the separate `IconAnimationDataMap`\n * (through `registerIconAnimation()`), not through this `animation` field.\n *\n * The `animation` field exists for non-standard categories (resource, custom, enum)\n * where icons are registered inline via `customRegistry` on the provider — these\n * don't go through the standard registration path and can embed animation config directly.\n */\nexport interface IconConfig {\n  icon: IconComponent;\n  defaultSize?: IconSize;\n  className?: string;\n  animation?: IconAnimationConfig;\n}\n\n/**\n * Icon registry structure\n */\nexport interface IconRegistry {\n  resources?: Map<ResourceType, IconConfig>;\n  operationResources?: Map<string, IconConfig>; // Key: `${resourceType}:${operationReference}`\n  enumValues?: Map<string, IconConfig>; // Key: `${enumReference}:${enumValue}`\n  standard: Map<StandardIconReference, IconConfig>;\n  compositeView?: Map<string, IconConfig>; // Key: viewReference\n  custom?: Map<string, IconConfig>; // Key: customReference\n}\n"]}
+{"version":3,"file":"icon-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/icons/icon-registry.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\nimport { ResourceType } from '@wildo-ai/saas-models';\n\n/**\n * Standard Icon References\n * These are the standard icons used across the application\n */\nexport enum StandardIconReference {\n  // Navigation\n  HOME = 'home',\n  MENU = 'menu',\n  CLOSE = 'close',\n  BACK = 'back',\n  FORWARD = 'forward',\n  \n  // Actions\n  ADD = 'add',\n  EDIT = 'edit',\n  DELETE = 'delete',\n  SAVE = 'save',\n  CANCEL = 'cancel',\n  SEARCH = 'search',\n  FILTER = 'filter',\n  REFRESH = 'refresh',\n  DOWNLOAD = 'download',\n  UPLOAD = 'upload',\n  COPY = 'copy',\n  SHARE = 'share',\n  \n  // Status\n  SUCCESS = 'success',\n  ERROR = 'error',\n  WARNING = 'warning',\n  INFO = 'info',\n  LOADING = 'loading',\n  \n  // Error Display\n  ERROR_NOT_FOUND = 'error_not_found',\n  ERROR_ACCESS_DENIED = 'error_access_denied',\n  ERROR_SERVER = 'error_server',\n  ERROR_APPLICATION = 'error_application',\n  ERROR_UNKNOWN = 'error_unknown',\n  RELOAD = 'reload',\n  TRY_AGAIN = 'try_again',\n  \n  // User\n  USER = 'user',\n  USERS = 'users',\n  PROFILE = 'profile',\n  SETTINGS = 'settings',\n  LOGOUT = 'logout',\n  LOGIN = 'login',\n  \n  // Organization\n  ORGANIZATION = 'organization',\n  TEAM = 'team',\n  \n  // Files\n  FILE = 'file',\n  FILE_IMAGE = 'file_image',\n  FILE_VIDEO = 'file_video',\n  FILE_AUDIO = 'file_audio',\n  FILE_TEXT = 'file_text',\n  FILE_SPREADSHEET = 'file_spreadsheet',\n  FILE_PRESENTATION = 'file_presentation',\n  FILE_ARCHIVE = 'file_archive',\n  FOLDER = 'folder',\n  \n  // Communication\n  MAIL = 'mail',\n  NOTIFICATION = 'notification',\n  CHAT = 'chat',\n  \n  // Misc\n  CALENDAR = 'calendar',\n  CLOCK = 'clock',\n  LOCK = 'lock',\n  UNLOCK = 'unlock',\n  HELP = 'help',\n  EXTERNAL_LINK = 'external_link',\n  MORE = 'more',\n  CHEVRON_DOWN = 'chevron_down',\n  CHEVRON_UP = 'chevron_up',\n  CHEVRON_LEFT = 'chevron_left',\n  CHEVRON_RIGHT = 'chevron_right',\n  \n  // UI Pattern Icons - Checks & Indicators\n  CHECK = 'check',\n  CHECK_CIRCLE = 'check_circle',\n  X_CIRCLE = 'x_circle',\n  CIRCLE = 'circle',\n  MINUS = 'minus',\n  DOT = 'dot',\n  \n  // UI Pattern Icons - Chevrons & Arrows\n  CHEVRONS_UP_DOWN = 'chevrons_up_down',\n  ARROW_LEFT = 'arrow_left',\n  ARROW_RIGHT = 'arrow_right',\n  ARROW_DOWN = 'arrow_down',\n  CORNER_DOWN_LEFT = 'corner_down_left',\n  \n  // UI Pattern Icons - Actions & Controls\n  GRIP_VERTICAL = 'grip_vertical',\n  MORE_HORIZONTAL = 'more_horizontal',\n  /** Sidebar-toggle glyph for a START-placed panel. Distinct from the CHEVRON/ARROW family on purpose: a chevron reads as NAVIGATION (back/forward), and a panel toggle is not navigation. */\n  PANEL_LEFT = 'panel_left',\n  /** Mirror of {@link PANEL_LEFT} for an END-placed panel. */\n  PANEL_RIGHT = 'panel_right',\n  /** Collection \"cards / stacked rows\" view-mode toggle option. */\n  VIEW_LIST = 'view_list',\n  /** Collection \"table / grid\" view-mode toggle option. */\n  VIEW_TABLE = 'view_table',\n  PAPERCLIP = 'paperclip',\n  PLUS = 'plus',\n  SQUARE = 'square',\n  IMAGE = 'image',\n  MIC = 'mic',\n  LOADER_2 = 'loader_2',\n  WRENCH = 'wrench',\n  \n  // Content Icons\n  BOOK = 'book',\n  BOOKMARK = 'bookmark',\n  /** Favorite/star toggle (sidebar favorites, starred items). Filled state is caller-owned via `fill-current`. */\n  STAR = 'star',\n  BRAIN = 'brain',\n  MESSAGE_CIRCLE = 'message_circle',\n  \n  // Document & File Icons\n  DOCUMENT = 'document',\n  X_MARK = 'x_mark',\n  \n  // Visibility Icons\n  EYE = 'eye',\n  EYE_OFF = 'eye_off',\n\n  // Security Icons — account-protection factors (Settings Hub → Security).\n  // The industry-recognised glyph for each authentication method, so a user\n  // scanning the panel identifies the method before reading its label.\n  /** Passkey / WebAuthn credential (biometric-backed device credential). */\n  FINGERPRINT = 'fingerprint',\n  /** Authenticator app / SMS factor — anything bound to the user's handset. */\n  SMARTPHONE = 'smartphone',\n  /** Password or other secret-based credential. */\n  KEY = 'key',\n  /** A linked external identity (social / enterprise SSO account). */\n  LINK = 'link',\n\n  // Billing Icons\n  CREDIT_CARD = 'credit_card',\n  INVOICE = 'invoice',\n  SUBSCRIPTION = 'subscription',\n  CREDIT_POOL = 'credit_pool',\n  PROMOTION = 'promotion',\n  METER = 'meter',\n  RECEIPT = 'receipt',\n\n  // Data Visualization\n  CHART = 'chart',\n\n  // Animation-capable icons (have animated overlays when registered)\n  LOADING_LIGHT = 'loading_light',\n  LOADING_DARK = 'loading_dark',\n  NETWORK_ERROR = 'network_error',\n  TADA = 'tada',\n}\n\nexport const StandardIconReferenceSchema: z.ZodEnum<typeof StandardIconReference> = z.enum(StandardIconReference);\n\n/**\n * Icon Categories\n */\nexport enum IconCategory {\n  RESOURCES = 'resources',\n  OPERATION_RESOURCES = 'operation_resources',\n  ENUM_VALUES = 'enum_values',\n  STANDARD = 'standard',\n  COMPOSITE_VIEW = 'composite_view',\n  CUSTOM = 'custom',\n}\n\nexport const IconCategorySchema: z.ZodEnum<typeof IconCategory> = z.enum(IconCategory);\n\n/**\n * Icon size variants\n */\nexport enum IconSize {\n  XS = 'xs',\n  SM = 'sm',\n  MD = 'md',\n  LG = 'lg',\n  XL = 'xl',\n}\n\nexport const IconSizeSchema: z.ZodEnum<typeof IconSize> = z.enum(IconSize);\n\nconst IconRequest_ResourcesSchema = z.object({\n  category: z.literal(IconCategory.RESOURCES),\n  resourceType: z.string(),\n});\n\nconst IconRequest_OperationResourcesSchema = z.object({\n  category: z.literal(IconCategory.OPERATION_RESOURCES),\n  resourceType: z.string(),\n  operationReference: z.string(),\n});\n\nconst IconRequest_EnumValuesSchema = z.object({\n  category: z.literal(IconCategory.ENUM_VALUES),\n  enumReference: z.string(),\n  enumValue: z.string(),\n});\n\nconst IconRequest_StandardSchema = z.object({\n  category: z.literal(IconCategory.STANDARD),\n  iconReference: StandardIconReferenceSchema,\n});\n\nconst IconRequest_CompositeViewSchema = z.object({\n  category: z.literal(IconCategory.COMPOSITE_VIEW),\n  viewReference: z.string(),\n});\n\nconst IconRequest_CustomSchema = z.object({\n  category: z.literal(IconCategory.CUSTOM),\n  customReference: z.string(),\n});\n\nexport const IconRequestSchema = z.discriminatedUnion('category', [\n  IconRequest_ResourcesSchema,\n  IconRequest_OperationResourcesSchema,\n  IconRequest_EnumValuesSchema,\n  IconRequest_StandardSchema,\n  IconRequest_CompositeViewSchema,\n  IconRequest_CustomSchema,\n]);\n\nexport const IconPropsSchema = z.object({\n  request: IconRequestSchema,\n  size: IconSizeSchema.optional(),\n  className: z.string().optional(),\n  strokeWidth: z.number().optional(),\n  color: z.string().optional(),\n});\n\nexport type IconRequest_Resources = z.infer<typeof IconRequest_ResourcesSchema>;\nexport type IconRequest_OperationResources = z.infer<typeof IconRequest_OperationResourcesSchema>;\nexport type IconRequest_EnumValues = z.infer<typeof IconRequest_EnumValuesSchema>;\nexport type IconRequest_Standard = z.infer<typeof IconRequest_StandardSchema>;\nexport type IconRequest_CompositeView = z.infer<typeof IconRequest_CompositeViewSchema>;\nexport type IconRequest_Custom = z.infer<typeof IconRequest_CustomSchema>;\nexport type IconRequest = z.infer<typeof IconRequestSchema>;\nexport type IconProps = z.infer<typeof IconPropsSchema>;\n\n/**\n * Icon size to pixel mapping\n */\nexport const ICON_SIZE_MAP: Record<IconSize, number> = {\n  [IconSize.XS]: 12,\n  [IconSize.SM]: 16,\n  [IconSize.MD]: 20,\n  [IconSize.LG]: 24,\n  [IconSize.XL]: 32,\n};\n\n/**\n * Icon render options (used by both simple and registry APIs)\n */\nexport interface IconRenderOptions {\n  size?: IconSize;\n  className?: string;\n  strokeWidth?: number;\n  color?: string;\n}\n\n/**\n * Framework-owned abstract icon component props.\n * Any icon library whose components accept these props (Lucide, custom SVGs, emoji wrappers)\n * can be registered as an IconComponent without adapters.\n */\nexport interface IconComponentProps {\n  size?: number;\n  className?: string;\n  strokeWidth?: number;\n  color?: string;\n}\n\n/**\n * Any React component that accepts IconComponentProps.\n * Concrete implementations include Lucide icons, emoji wrappers (via createEmojiIcon),\n * custom SVG components, or any future icon source.\n */\nexport type IconComponent = ComponentType<IconComponentProps>;\n\n/**\n * Animation configuration for animated icons (Lottie JSON / DotLottie).\n * All fields are config-time concerns — set at registration, not at render callsites.\n */\nexport interface IconAnimationConfig {\n  /** Lottie JSON animation data */\n  animationData?: object;\n  /** DotLottie URL (base64 data URL or HTTP URL) */\n  dotLottieUrl?: string;\n  /** Whether the animation loops (intrinsic to the asset, not the consumer) */\n  loop: boolean;\n  /** Whether to autoplay on mount */\n  autoplay: boolean;\n  /** Playback speed multiplier (1 = normal). Currently applies to dotLottie sources only — lottie-react controls speed via its imperative API, not props. */\n  speed?: number;\n  /** Below this size threshold, the static icon fallback is used instead of the animation */\n  minSize?: IconSize;\n}\n\n/**\n * Icon configuration for themable icons.\n * The static `icon` component is always present and serves as the fallback.\n *\n * For standard icons, animations are registered via the separate `IconAnimationDataMap`\n * (through `registerIconAnimation()`), not through this `animation` field.\n *\n * The `animation` field exists for non-standard categories (resource, custom, enum)\n * where icons are registered inline via `customRegistry` on the provider — these\n * don't go through the standard registration path and can embed animation config directly.\n */\nexport interface IconConfig {\n  icon: IconComponent;\n  defaultSize?: IconSize;\n  className?: string;\n  animation?: IconAnimationConfig;\n}\n\n/**\n * Icon registry structure\n */\nexport interface IconRegistry {\n  resources?: Map<ResourceType, IconConfig>;\n  operationResources?: Map<string, IconConfig>; // Key: `${resourceType}:${operationReference}`\n  enumValues?: Map<string, IconConfig>; // Key: `${enumReference}:${enumValue}`\n  standard: Map<StandardIconReference, IconConfig>;\n  compositeView?: Map<string, IconConfig>; // Key: viewReference\n  custom?: Map<string, IconConfig>; // Key: customReference\n}\n"]}

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingContext.js","sourceRoot":"","sources":["../../../../../src/core/loading/LoadingContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EACL,WAAW,EACX,YAAY,GAIb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,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;AAEpD,+EAA+E;AAE/E,IAAK,iBAKJ;AALD,WAAK,iBAAiB;IACpB,4DAAuC,CAAA;IACvC,wDAAmC,CAAA;IACnC,wEAAmD,CAAA;IACnD,oEAA+C,CAAA;AACjD,CAAC,EALI,iBAAiB,KAAjB,iBAAiB,QAKrB;AAaD,MAAM,YAAY,GAAyB;IACzC,iBAAiB,EAAE,IAAI,GAAG,EAAE;IAC5B,mBAAmB,EAAE,IAAI,GAAG,EAAE;CAC/B,CAAC;AAEF;;;;GAIG;AACH,SAAS,cAAc,CAAC,KAA2B,EAAE,MAAqB;IACxE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,OAAO,EAAE,GAAG,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,KAAK,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/B,OAAO,EAAE,GAAG,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,KAAK,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACxB,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,KAAK;gBAC/C,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QACD,KAAK,iBAAiB,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACxB,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,WAAW,GAAG,CAAC;gBAC1B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,eAAe;IACX,KAAK,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC7C,UAAU,GAAG,GAAG,CAAC;IAElC,GAAG,CAAC,QAAgB,EAAE,qBAA6B,CAAC,GAAG,EAAE,GAAG,IAAI;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAClE,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AA6BD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkD,aAAa,CAAiC,SAAS,CAAC,CAAC;AAEtI,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAsC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACjF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,UAAU,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACnE,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAEzD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,QAAQ,CAAC,sBAAsB,KAAK,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;IACjI,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAE9B,4EAA4E;IAE5E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAsB,EAAE,CAAC;QAE3C,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,EAAE;YACrE,MAAM,QAAQ,GAAG,oBAAoB,CAAC;gBACpC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,OAAO,CAAC,mBAAmB;gBACtC,aAAa,EAAE,OAAO,CAAC,qBAAqB;aAC7C,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC;YACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC;YAEpD,IAAI,IAAI,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;gBACrC,QAAQ,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;gBACnD,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/I,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,EAAE;YACnE,MAAM,QAAQ,GAAG,oBAAoB,CAAC;gBACpC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,OAAO,CAAC,mBAAmB;gBACtC,aAAa,EAAE,OAAO,CAAC,qBAAqB;aAC7C,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC;YAEnD,IAAI,IAAI,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;gBACrC,QAAQ,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;gBACjD,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,qBAAqB,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxE,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,EAAE;YACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC;YACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC;YACpD,IAAI,IAAI,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;gBACrC,QAAQ,CAAC,4BAA4B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC3D,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YACnK,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,uBAAuB,EAAE,QAAQ,EAAE,UAAU,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACjH,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,EAAE;YACjE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC;YACnD,IAAI,IAAI,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;gBACrC,QAAQ,CAAC,0BAA0B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;gBACzD,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,eAAe,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,qBAAqB,EAAE,QAAQ,EAAE,UAAU,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACxG,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,4EAA4E;IAE5E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAsB,EAAE,CAAC;QAE3C,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,OAAO,EAAE,EAAE;YACpE,IAAI,OAAO,CAAC,UAAU,KAAK,oBAAoB,CAAC,aAAa,EAAE,CAAC;gBAC9D,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrC,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5D,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,CAAC,CAAC,CACH,CAAC;QAEF,YAAY,CAAC,IAAI,CACf,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,GAAG,EAAE;YACzD,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,4EAA4E;IAE5E,MAAM,wBAAwB,GAAG,WAAW,CAC1C,CAAC,QAAgB,EAAqC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAChG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAC5B,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,QAAgB,EAAE,kBAA2B,EAAW,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EACxH,EAAE,CACH,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,QAAgB,EAAQ,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EACpE,EAAE,CACH,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,KAAmB,EAAE,OAAsD,EAAE,EAAE;QAC9G,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE;gBACzD,UAAU,EAAE,KAAK,CAAC,gBAAiB;gBACnC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,KAAK,EAAE,OAAO,EAAE,KAAK;aACtB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,sBAAsB,EAAE;gBAC3D,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;gBACtC,mBAAmB,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;gBAC1C,qBAAqB,EAAE,KAAK,CAAC,aAAa;gBAC1C,0BAA0B,EAAE,EAAE;gBAC9B,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,KAAK,EAAE,OAAO,EAAE,KAAK;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,KAAmB,EAAE,OAAgC,EAAE,EAAE;QACvF,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE;gBACvD,UAAU,EAAE,KAAK,CAAC,gBAAiB;gBACnC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,OAAO,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE;gBACzD,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;gBACtC,mBAAmB,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;gBAC1C,qBAAqB,EAAE,KAAK,CAAC,aAAa;gBAC1C,0BAA0B,EAAE,EAAE;gBAC9B,IAAI,EAAE,OAAO,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,4EAA4E;IAE5E,MAAM,KAAK,GAAuB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC;QAC9C,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;QAC/D,wBAAwB;QACxB,aAAa;QACb,YAAY;QACZ,WAAW;QACX,UAAU;KACX,CAAC,EAAE;QACF,KAAK,CAAC,iBAAiB;QACvB,wBAAwB;QACxB,aAAa;QACb,YAAY;QACZ,WAAW;QACX,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA2B,CAAC;AACrF,CAAC,CAAC","sourcesContent":["/**\n * Loading Context — Event-Driven State Aggregator\n *\n * Central loading state management. Subscribes to loading events on the EventBus\n * and maintains aggregate state for UI consumption.\n *\n * Architecture: EventBus → LoadingProvider (useReducer) → Context → Hooks\n *\n * Tier 1 (APPLICATION): Gates entire app — init, language change, org switch.\n * Tier 2 (COMPONENT): Per-scope — resource lists, detail views, etc.\n *\n * @see .cursor/plans/loading-system-architecture.md\n *\n * ARCHITECTURE NOTE:\n * This file exports the Provider component and context. Hooks are in separate files\n * (useAppLoading.ts, useComponentLoading.ts, useLoading.ts) for React Fast Refresh\n * compatibility — mixing components and hooks causes HMR invalidation loops.\n */\n\nimport React, { createContext, useReducer, useEffect, useRef, useCallback, useMemo, type ReactNode } from 'react';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport {\n  LoadingTier,\n  LoadingPhase,\n  type LoadingScope,\n  type ComponentLoadingState,\n  type LoadingSource,\n} from './loading-types.frontend.schemas';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('LoadingContext');\nlogger.setDebugTypeLogging('LoadingContext', false);\n\n// ─── Internal State ─────────────────────────────────────────────────────────\n\nenum LoadingActionType {\n  APP_LOADING_START = 'APP_LOADING_START',\n  APP_LOADING_END = 'APP_LOADING_END',\n  COMPONENT_LOADING_START = 'COMPONENT_LOADING_START',\n  COMPONENT_LOADING_END = 'COMPONENT_LOADING_END',\n}\n\ninterface LoadingInternalState {\n  appLoadingSources: Map<string, LoadingSource>;\n  componentLoadingMap: Map<string, ComponentLoadingState>;\n}\n\ntype LoadingAction =\n  | { type: LoadingActionType.APP_LOADING_START; identifier: string; source: LoadingSource }\n  | { type: LoadingActionType.APP_LOADING_END; identifier: string }\n  | { type: LoadingActionType.COMPONENT_LOADING_START; scopeKey: string; phase: LoadingPhase }\n  | { type: LoadingActionType.COMPONENT_LOADING_END; scopeKey: string };\n\nconst initialState: LoadingInternalState = {\n  appLoadingSources: new Map(),\n  componentLoadingMap: new Map(),\n};\n\n/**\n * IMPORTANT: Returns new Map instances on every mutation.\n * React detects state changes by reference equality — mutating a Map in place\n * returns the same reference and triggers no re-render.\n */\nfunction loadingReducer(state: LoadingInternalState, action: LoadingAction): LoadingInternalState {\n  switch (action.type) {\n    case LoadingActionType.APP_LOADING_START: {\n      const next = new Map(state.appLoadingSources);\n      next.set(action.identifier, action.source);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.APP_LOADING_END: {\n      const next = new Map(state.appLoadingSources);\n      next.delete(action.identifier);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_START: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      const activeCount = (existing?.activeCount ?? 0) + 1;\n      next.set(action.scopeKey, {\n        hasLoadedOnce: existing?.hasLoadedOnce ?? false,\n        isLoading: true,\n        phase: action.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_END: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      if (!existing) return state;\n      const activeCount = Math.max(0, existing.activeCount - 1);\n      next.set(action.scopeKey, {\n        hasLoadedOnce: true,\n        isLoading: activeCount > 0,\n        phase: existing.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    default:\n      return state;\n  }\n}\n\n// ─── LoadedOnce LRU Cache ───────────────────────────────────────────────────\n\n/**\n * Tracks data contexts that have been successfully loaded and rendered.\n * Used to distinguish initial loads from refreshes on re-visit.\n *\n * LRU eviction: oldest entries are evicted when cache exceeds maxEntries.\n * Map insertion order is exploited — delete+re-set moves entry to end.\n */\nclass LoadedOnceCache {\n  private cache = new Map<string, { lastRenderedAt: number }>();\n  private readonly maxEntries = 200;\n\n  has(scopeKey: string, refreshThresholdMs: number = 5 * 60 * 1000): boolean {\n    const entry = this.cache.get(scopeKey);\n    if (!entry) return false;\n    return (Date.now() - entry.lastRenderedAt) < refreshThresholdMs;\n  }\n\n  set(scopeKey: string): void {\n    this.cache.delete(scopeKey);\n    this.cache.set(scopeKey, { lastRenderedAt: Date.now() });\n    if (this.cache.size > this.maxEntries) {\n      const oldest = this.cache.keys().next().value;\n      if (oldest !== undefined) this.cache.delete(oldest);\n    }\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n// ─── Context Type ───────────────────────────────────────────────────────────\n\nexport interface LoadingContextType {\n  // Tier 1 read-only state\n  isAppLoading: boolean;\n  appLoadingSources: LoadingSource[];\n\n  // Tier 2 state access\n  getComponentLoadingState: (scopeKey: string) => ComponentLoadingState | undefined;\n\n  // hasLoadedOnce cache access\n  hasLoadedOnce: (scopeKey: string, refreshThresholdMs?: number) => boolean;\n  markRendered: (scopeKey: string) => void;\n\n  /**\n   * Emit a loading start event via EventBus.\n   * State comes back through the subscription pipeline.\n   */\n  fireLoading: (scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => void;\n  /**\n   * Emit a loading end event via EventBus.\n   * Must pass the same tier used in fireLoading() — APPLICATION-tier loading\n   * won't be ended if tier is omitted (defaults to COMPONENT).\n   */\n  endLoading: (scope: LoadingScope, options?: { tier?: LoadingTier }) => void;\n}\n\n/**\n * @internal Use useLoading(), useAppLoading(), or useComponentLoading() hooks\n */\nexport const LoadingContext: React.Context<LoadingContextType | undefined> = createContext<LoadingContextType | undefined>(undefined);\n\n// ─── Provider ───────────────────────────────────────────────────────────────\n\nexport const LoadingProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const [state, dispatch] = useReducer(loadingReducer, initialState);\n  const loadedOnceCacheRef = useRef(new LoadedOnceCache());\n\n  useEffect(() => {\n    const identifiers = Array.from(state.appLoadingSources.keys());\n    logDebug(`App loading state: ${state.appLoadingSources.size > 0 ? 'loading' : 'ready'} [${identifiers.join(', ') || 'none'}]`);\n  }, [state.appLoadingSources]);\n\n  // ── Subscribe to loading events ──────────────────────────────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_START, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: scopeKey, source: { identifier: scopeKey, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_END, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: scopeKey });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_START, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: payload.identifier, source: { identifier: payload.identifier, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey: `custom:${payload.identifier}`, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_END, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: payload.identifier });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey: `custom:${payload.identifier}` });\n        }\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── Global clear events — invalidate hasLoadedOnce cache ─────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n        if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS) {\n          loadedOnceCacheRef.current.clear();\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.AUTH_LOGOUT_REQUIRED, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.WHOLE_APP_REFRESH, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── New API methods ──────────────────────────────────────────────────────\n\n  const getComponentLoadingState = useCallback(\n    (scopeKey: string): ComponentLoadingState | undefined => state.componentLoadingMap.get(scopeKey),\n    [state.componentLoadingMap]\n  );\n\n  const hasLoadedOnce = useCallback(\n    (scopeKey: string, refreshThresholdMs?: number): boolean => loadedOnceCacheRef.current.has(scopeKey, refreshThresholdMs),\n    []\n  );\n\n  const markRendered = useCallback(\n    (scopeKey: string): void => loadedOnceCacheRef.current.set(scopeKey),\n    []\n  );\n\n  const fireLoading = useCallback((scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_START, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_START, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    }\n  }, []);\n\n  const endLoading = useCallback((scope: LoadingScope, options?: { tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_END, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_END, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n      });\n    }\n  }, []);\n\n  // ── Build context value ──────────────────────────────────────────────────\n\n  const value: LoadingContextType = useMemo(() => ({\n    isAppLoading: state.appLoadingSources.size > 0,\n    appLoadingSources: Array.from(state.appLoadingSources.values()),\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  }), [\n    state.appLoadingSources,\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  ]);\n\n  return <LoadingContext.Provider value={value}>{children}</LoadingContext.Provider>;\n};\n"]}
+{"version":3,"file":"LoadingContext.js","sourceRoot":"","sources":["../../../../src/core/loading/LoadingContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Loading Context — Event-Driven State Aggregator\n *\n * Central loading state management. Subscribes to loading events on the EventBus\n * and maintains aggregate state for UI consumption.\n *\n * Architecture: EventBus → LoadingProvider (useReducer) → Context → Hooks\n *\n * Tier 1 (APPLICATION): Gates entire app — init, language change, org switch.\n * Tier 2 (COMPONENT): Per-scope — resource lists, detail views, etc.\n *\n * @see .cursor/plans/loading-system-architecture.md\n *\n * ARCHITECTURE NOTE:\n * This file exports the Provider component and context. Hooks are in separate files\n * (useAppLoading.ts, useComponentLoading.ts, useLoading.ts) for React Fast Refresh\n * compatibility — mixing components and hooks causes HMR invalidation loops.\n */\n\nimport React, { createContext, useReducer, useEffect, useRef, useCallback, useMemo, type ReactNode } from 'react';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport {\n  LoadingTier,\n  LoadingPhase,\n  type LoadingScope,\n  type ComponentLoadingState,\n  type LoadingSource,\n} from './loading-types.frontend.schemas';\nimport { buildLoadingScopeKey } from './loading-scope.frontend.utils';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('LoadingContext');\nlogger.setDebugTypeLogging('LoadingContext', false);\n\n// ─── Internal State ─────────────────────────────────────────────────────────\n\nenum LoadingActionType {\n  APP_LOADING_START = 'APP_LOADING_START',\n  APP_LOADING_END = 'APP_LOADING_END',\n  COMPONENT_LOADING_START = 'COMPONENT_LOADING_START',\n  COMPONENT_LOADING_END = 'COMPONENT_LOADING_END',\n}\n\ninterface LoadingInternalState {\n  appLoadingSources: Map<string, LoadingSource>;\n  componentLoadingMap: Map<string, ComponentLoadingState>;\n}\n\ntype LoadingAction =\n  | { type: LoadingActionType.APP_LOADING_START; identifier: string; source: LoadingSource }\n  | { type: LoadingActionType.APP_LOADING_END; identifier: string }\n  | { type: LoadingActionType.COMPONENT_LOADING_START; scopeKey: string; phase: LoadingPhase }\n  | { type: LoadingActionType.COMPONENT_LOADING_END; scopeKey: string };\n\nconst initialState: LoadingInternalState = {\n  appLoadingSources: new Map(),\n  componentLoadingMap: new Map(),\n};\n\n/**\n * IMPORTANT: Returns new Map instances on every mutation.\n * React detects state changes by reference equality — mutating a Map in place\n * returns the same reference and triggers no re-render.\n */\nfunction loadingReducer(state: LoadingInternalState, action: LoadingAction): LoadingInternalState {\n  switch (action.type) {\n    case LoadingActionType.APP_LOADING_START: {\n      const next = new Map(state.appLoadingSources);\n      next.set(action.identifier, action.source);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.APP_LOADING_END: {\n      const next = new Map(state.appLoadingSources);\n      next.delete(action.identifier);\n      return { ...state, appLoadingSources: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_START: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      const activeCount = (existing?.activeCount ?? 0) + 1;\n      next.set(action.scopeKey, {\n        hasLoadedOnce: existing?.hasLoadedOnce ?? false,\n        isLoading: true,\n        phase: action.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    case LoadingActionType.COMPONENT_LOADING_END: {\n      const next = new Map(state.componentLoadingMap);\n      const existing = next.get(action.scopeKey);\n      if (!existing) return state;\n      const activeCount = Math.max(0, existing.activeCount - 1);\n      next.set(action.scopeKey, {\n        hasLoadedOnce: true,\n        isLoading: activeCount > 0,\n        phase: existing.phase,\n        activeCount,\n      });\n      return { ...state, componentLoadingMap: next };\n    }\n    default:\n      return state;\n  }\n}\n\n// ─── LoadedOnce LRU Cache ───────────────────────────────────────────────────\n\n/**\n * Tracks data contexts that have been successfully loaded and rendered.\n * Used to distinguish initial loads from refreshes on re-visit.\n *\n * LRU eviction: oldest entries are evicted when cache exceeds maxEntries.\n * Map insertion order is exploited — delete+re-set moves entry to end.\n */\nclass LoadedOnceCache {\n  private cache = new Map<string, { lastRenderedAt: number }>();\n  private readonly maxEntries = 200;\n\n  has(scopeKey: string, refreshThresholdMs: number = 5 * 60 * 1000): boolean {\n    const entry = this.cache.get(scopeKey);\n    if (!entry) return false;\n    return (Date.now() - entry.lastRenderedAt) < refreshThresholdMs;\n  }\n\n  set(scopeKey: string): void {\n    this.cache.delete(scopeKey);\n    this.cache.set(scopeKey, { lastRenderedAt: Date.now() });\n    if (this.cache.size > this.maxEntries) {\n      const oldest = this.cache.keys().next().value;\n      if (oldest !== undefined) this.cache.delete(oldest);\n    }\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n// ─── Context Type ───────────────────────────────────────────────────────────\n\nexport interface LoadingContextType {\n  // Tier 1 read-only state\n  isAppLoading: boolean;\n  appLoadingSources: LoadingSource[];\n\n  // Tier 2 state access\n  getComponentLoadingState: (scopeKey: string) => ComponentLoadingState | undefined;\n\n  // hasLoadedOnce cache access\n  hasLoadedOnce: (scopeKey: string, refreshThresholdMs?: number) => boolean;\n  markRendered: (scopeKey: string) => void;\n\n  /**\n   * Emit a loading start event via EventBus.\n   * State comes back through the subscription pipeline.\n   */\n  fireLoading: (scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => void;\n  /**\n   * Emit a loading end event via EventBus.\n   * Must pass the same tier used in fireLoading() — APPLICATION-tier loading\n   * won't be ended if tier is omitted (defaults to COMPONENT).\n   */\n  endLoading: (scope: LoadingScope, options?: { tier?: LoadingTier }) => void;\n}\n\n/**\n * @internal Use useLoading(), useAppLoading(), or useComponentLoading() hooks\n */\nexport const LoadingContext: React.Context<LoadingContextType | undefined> = createContext<LoadingContextType | undefined>(undefined);\n\n// ─── Provider ───────────────────────────────────────────────────────────────\n\nexport const LoadingProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const [state, dispatch] = useReducer(loadingReducer, initialState);\n  const loadedOnceCacheRef = useRef(new LoadedOnceCache());\n\n  useEffect(() => {\n    const identifiers = Array.from(state.appLoadingSources.keys());\n    logDebug(`App loading state: ${state.appLoadingSources.size > 0 ? 'loading' : 'ready'} [${identifiers.join(', ') || 'none'}]`);\n  }, [state.appLoadingSources]);\n\n  // ── Subscribe to loading events ──────────────────────────────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_START, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: scopeKey, source: { identifier: scopeKey, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_RESOURCE_END, (payload) => {\n        const scopeKey = buildLoadingScopeKey({\n          resourceType: payload.resourceType,\n          operation: payload.operationIdentifier,\n          discriminator: payload.optionalDiscriminator,\n        });\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END resource:${scopeKey}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: scopeKey });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_START, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        const phase = payload.phase ?? LoadingPhase.INITIAL;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_START custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_START, identifier: payload.identifier, source: { identifier: payload.identifier, tier, startedAt: Date.now() } });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_START, scopeKey: `custom:${payload.identifier}`, phase });\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.LOADING_CUSTOM_END, (payload) => {\n        const tier = payload.tier ?? LoadingTier.COMPONENT;\n        if (tier === LoadingTier.APPLICATION) {\n          logDebug(`APP_LOADING_END custom:${payload.identifier}`);\n          dispatch({ type: LoadingActionType.APP_LOADING_END, identifier: payload.identifier });\n        } else {\n          dispatch({ type: LoadingActionType.COMPONENT_LOADING_END, scopeKey: `custom:${payload.identifier}` });\n        }\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── Global clear events — invalidate hasLoadedOnce cache ─────────────────\n\n  useEffect(() => {\n    const unsubscribes: Array<() => void> = [];\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n        if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS) {\n          loadedOnceCacheRef.current.clear();\n        }\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.AUTH_LOGOUT_REQUIRED, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    unsubscribes.push(\n      frontendEventBus.on(FrontendEvents.WHOLE_APP_REFRESH, () => {\n        loadedOnceCacheRef.current.clear();\n      })\n    );\n\n    return () => unsubscribes.forEach(unsub => unsub());\n  }, []);\n\n  // ── New API methods ──────────────────────────────────────────────────────\n\n  const getComponentLoadingState = useCallback(\n    (scopeKey: string): ComponentLoadingState | undefined => state.componentLoadingMap.get(scopeKey),\n    [state.componentLoadingMap]\n  );\n\n  const hasLoadedOnce = useCallback(\n    (scopeKey: string, refreshThresholdMs?: number): boolean => loadedOnceCacheRef.current.has(scopeKey, refreshThresholdMs),\n    []\n  );\n\n  const markRendered = useCallback(\n    (scopeKey: string): void => loadedOnceCacheRef.current.set(scopeKey),\n    []\n  );\n\n  const fireLoading = useCallback((scope: LoadingScope, options?: { phase?: LoadingPhase; tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_START, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_START, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n        phase: options?.phase,\n      });\n    }\n  }, []);\n\n  const endLoading = useCallback((scope: LoadingScope, options?: { tier?: LoadingTier }) => {\n    const isCustom = !!scope.customIdentifier;\n    if (isCustom) {\n      frontendEventBus.emit(FrontendEvents.LOADING_CUSTOM_END, {\n        identifier: scope.customIdentifier!,\n        data: undefined,\n        tier: options?.tier,\n      });\n    } else {\n      frontendEventBus.emit(FrontendEvents.LOADING_RESOURCE_END, {\n        resourceType: scope.resourceType ?? '',\n        operationIdentifier: scope.operation ?? '',\n        optionalDiscriminator: scope.discriminator,\n        contextResourceIdentifiers: {},\n        tier: options?.tier,\n      });\n    }\n  }, []);\n\n  // ── Build context value ──────────────────────────────────────────────────\n\n  const value: LoadingContextType = useMemo(() => ({\n    isAppLoading: state.appLoadingSources.size > 0,\n    appLoadingSources: Array.from(state.appLoadingSources.values()),\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  }), [\n    state.appLoadingSources,\n    getComponentLoadingState,\n    hasLoadedOnce,\n    markRendered,\n    fireLoading,\n    endLoading,\n  ]);\n\n  return <LoadingContext.Provider value={value}>{children}</LoadingContext.Provider>;\n};\n"]}

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

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

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

@@ -52,7 +52,7 @@ export function LoadingGate({ loadingScopes, i18nKeys, readiness, policy, render
     const surfacePolicy = useSurfacePolicy();
     const effectivePolicy = policy ?? resolveSurfaceLoadingPolicy(surfacePolicy.interactiveState?.loadingDisplay);
     const i18nDeps = useMemo(() => ({ keys: i18nKeys ?? [] }), [i18nKeys]);
-    const { requestKeys, isKeyLoaded, isReady } = useI18n(i18nDeps);
+    const { requestKeys, isKeySettled, isReady } = useI18n(i18nDeps);
     // ── Loading scope states ─────────────────────────────────────────────────
     const scopeStates = useMemo(() => {
         if (!loadingScopes?.length)
@@ -69,10 +69,23 @@ export function LoadingGate({ loadingScopes, i18nKeys, readiness, policy, render
     // ── i18n key readiness ──────────────────────────────────────────────────
     useEffect(() => {
         if (i18nKeys?.length) {
-            requestKeys(i18nKeys);
+            /*
+             * Fire-and-forget, so the rejection is observed here. `requestKeys` rejects when the bundle
+             * fetch fails; with nobody awaiting it that reaches the window as an unhandled rejection,
+             * while saying nothing new — `flushBatch` already reported the failure once and settled the
+             * keys. The gate below reads that settled state.
+             */
+            void requestKeys(i18nKeys).catch(() => undefined);
         }
     }, [i18nKeys, requestKeys]);
-    const i18nReady = !i18nKeys?.length || i18nKeys.every(k => isKeyLoaded(k));
+    /*
+     * SETTLED, not loaded — the same distinction `useI18n.isReady` makes, and for the same reason.
+     * `isKeyLoaded` stays false forever for a key whose bundle failed, so gating on it turned one
+     * failed request into a gate that never opens: a permanent spinner in place of the content. A
+     * settled-but-failed key opens the gate and the label lookup reports the label as missing, which
+     * is visible and correct, rather than hiding the whole surface behind a loader.
+     */
+    const i18nReady = !i18nKeys?.length || i18nKeys.every(k => isKeySettled(k));
     // ── Custom readiness signals ────────────────────────────────────────────
     const customReady = !readiness?.length || readiness.every(r => r.isReady);
     // ── Combined readiness ──────────────────────────────────────────────────

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

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

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

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

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

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

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

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

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

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

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

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