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

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

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

Files changed (2312) hide show

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

	@@ -1 +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 /\n \"Give this pane the whole content area\" — the zone-emphasis toggle on an adjacent navigation\n * zone. Distinct from the PANEL family (which OPENS and CLOSES a panel) and from the CHEVRON family\n * (navigation): emphasis changes how much room a pane already open is given, and nothing else.\n /\n MAXIMIZE = 'maximize',\n /* Mirror of {@link MAXIMIZE}: hand the room back to the split. /\n MINIMIZE = 'minimize',\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"]}
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 /\n \"Give this pane the whole content area\" — the zone-emphasis toggle on an adjacent navigation\n * zone. Distinct from the PANEL family (which OPENS and CLOSES a panel) and from the CHEVRON family\n * (navigation): emphasis changes how much room a pane already open is given, and nothing else.\n /\n MAXIMIZE = 'maximize',\n /* Mirror of {@link MAXIMIZE}: hand the room back to the split. /\n MINIMIZE = 'minimize',\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 CHANGED Viewed

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

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

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

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

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

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

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

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"LoadingBarrier.js","sourceRoot":"","sources":["../../../../../src/core/loading/LoadingBarrier.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport type { LoadingErrorContext } from './loading-types.frontend.schemas';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nenum ParticipantStatus {\n PENDING = 'pending',\n READY = 'ready',\n ERROR = 'error',\n}\n\ninterface BarrierRegistration {\n markReady: () => void;\n markError: (error?: unknown) => void;\n /** Remove this participant from the barrier — call in useEffect cleanup /\n unregister: () => void;\n}\n\ninterface LoadingBarrierContextType {\n register: (id: string) => BarrierRegistration;\n /* Incremented on each retry — children can depend on this to re-trigger loading /\n retryCounter: number;\n}\n\n// ─── Context ────────────────────────────────────────────────────────────────\n\nconst LoadingBarrierContext = createContext<LoadingBarrierContextType \| null>(null);\n\n/\n Hook for child components to register themselves as barrier participants.\n \n Call `register(id)` once (typically in a useEffect) and use the returned\n * `markReady` / `markError` / `unregister` to manage the child's lifecycle.\n * Call `unregister()` in the useEffect cleanup to prevent dangling participants.\n \n Use `retryCounter` as a dependency in effects that need to re-trigger loading\n * when the barrier's retry handler fires.\n \n @throws Error if used outside a `<LoadingBarrier>`\n /\nexport function useBarrierParticipant(): LoadingBarrierContextType {\n const ctx = useContext(LoadingBarrierContext);\n if (!ctx) throw new Error('useBarrierParticipant must be used within a LoadingBarrier');\n return ctx;\n}\n\n// ─── Props ──────────────────────────────────────────────────────────────────\n\nexport interface LoadingBarrierProps {\n /* Custom loading renderer — shown while children are registering and loading /\n renderLoading?: () => ReactNode;\n /* Error renderer — shown on timeout or participant error /\n renderError?: (context: LoadingErrorContext) => ReactNode;\n /* Timeout in ms after which the barrier shows an error. Default: no timeout. /\n timeoutMs?: number;\n children: ReactNode;\n}\n\n/\n LoadingBarrier — Composite loading gate for dynamic views.\n \n Used when the set of loading dependencies is determined by children at\n * render time (e.g., a dashboard with multiple independently-loaded cards,\n * a side menu with multiple resource counts).\n \n Children self-register as participants via `useBarrierParticipant()`,\n * then call `markReady()` or `markError()` when loaded. The barrier\n * renders children invisibly (opacity 0, pointer-events none) until all\n * participants are ready, then transitions to full visibility.\n \n @see loading-system-architecture.md §2.5 \"LoadingBarrier\"\n /\nexport function LoadingBarrier({\n renderLoading,\n renderError,\n timeoutMs,\n children,\n}: LoadingBarrierProps): React.JSX.Element {\n const participantsRef = useRef<Map<string, { status: ParticipantStatus; error?: unknown }>>(new Map());\n const [, forceRender] = useState(0);\n const [timedOut, setTimedOut] = useState(false);\n const [retryCounter, setRetryCounter] = useState(0);\n const mountTimeRef = useRef(Date.now());\n\n // ── Participant registration ──────────────────────────────────────────\n\n const register = useCallback((id: string): BarrierRegistration => {\n if (!participantsRef.current.has(id)) {\n participantsRef.current.set(id, { status: ParticipantStatus.PENDING });\n forceRender(c => c + 1);\n }\n\n return {\n markReady: () => {\n const entry = participantsRef.current.get(id);\n if (entry && entry.status !== ParticipantStatus.READY) {\n participantsRef.current.set(id, { status: ParticipantStatus.READY });\n forceRender(c => c + 1);\n }\n },\n markError: (error?: unknown) => {\n const entry = participantsRef.current.get(id);\n if (entry && entry.status !== ParticipantStatus.ERROR) {\n participantsRef.current.set(id, { status: ParticipantStatus.ERROR, error });\n forceRender(c => c + 1);\n }\n },\n unregister: () => {\n if (participantsRef.current.has(id)) {\n participantsRef.current.delete(id);\n forceRender(c => c + 1);\n }\n },\n };\n }, []);\n\n // ── Derive aggregate state ────────────────────────────────────────────\n\n const participants = participantsRef.current;\n const hasParticipants = participants.size > 0;\n const allReady = hasParticipants && Array.from(participants.values()).every(p => p.status === ParticipantStatus.READY);\n const hasError = Array.from(participants.values()).some(p => p.status === ParticipantStatus.ERROR);\n\n // ── Timeout handling ──────────────────────────────────────────────────\n\n useEffect(() => {\n if (allReady \|\| !timeoutMs) return;\n\n const elapsed = Date.now() - mountTimeRef.current;\n const remaining = timeoutMs - elapsed;\n\n if (remaining <= 0) {\n setTimedOut(true);\n return;\n }\n\n const timer = setTimeout(() => setTimedOut(true), remaining);\n return () => clearTimeout(timer);\n }, [allReady, timeoutMs]);\n\n useEffect(() => {\n if (allReady) setTimedOut(false);\n }, [allReady]);\n\n // ── Context value ─────────────────────────────────────────────────────\n\n const contextValue = useMemo((): LoadingBarrierContextType => ({ register, retryCounter }), [register, retryCounter]);\n\n // ── Error state ───────────────────────────────────────────────────────\n\n if ((timedOut \|\| hasError) && renderError) {\n const failedEntries = Array.from(participants.entries())\n .filter(([, p]) => p.status !== ParticipantStatus.READY);\n const failedScopes = failedEntries.map(([id]) => ({ customIdentifier: id }));\n const firstError = failedEntries.find(([, p]) => p.error)?.[1]?.error;\n\n return (\n <LoadingBarrierContext.Provider value={contextValue}>\n {renderError({\n failedScopes,\n reason: hasError ? 'error' : 'timeout',\n error: firstError,\n retry: () => {\n setTimedOut(false);\n mountTimeRef.current = Date.now();\n for (const [id] of participants) {\n participants.set(id, { status: ParticipantStatus.PENDING });\n }\n setRetryCounter(c => c + 1);\n forceRender(c => c + 1);\n },\n })}\n </LoadingBarrierContext.Provider>\n );\n }\n\n // ── Render ────────────────────────────────────────────────────────────\n\n const isLoading = !allReady;\n\n return (\n <LoadingBarrierContext.Provider value={contextValue}>\n <div className=\"relative\">\n {/ Children always render (to enable self-registration), but hidden while loading /}\n <div\n style={{\n opacity: isLoading ? 0 : 1,\n pointerEvents: isLoading ? 'none' : 'auto',\n transition: 'opacity 200ms ease-out',\n }}\n aria-hidden={isLoading}\n >\n {children}\n </div>\n\n {/ Loading overlay — positioned over the invisible children */}\n {isLoading && (\n <div className=\"absolute inset-0 flex items-center justify-center\">\n {renderLoading ? renderLoading() : <LoadingSpinner size={32} />}\n </div>\n )}\n </div>\n </LoadingBarrierContext.Provider>\n );\n}\n"]}
1	+ {"version":3,"file":"LoadingBarrier.js","sourceRoot":"","sources":["../../../../src/core/loading/LoadingBarrier.tsx"],"names":[],"mappings":"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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 CHANGED Viewed

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

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

@@ -193,7 +193,13 @@ export const LoadingProvider = ({ children }) => {
                 loadedOnceCacheRef.current.clear();
             }
         }));
-        unsubscribes.push(frontendEventBus.on(FrontendEvents.AUTH_LOGOUT_REQUIRED, () => {
+        /*
+         * The person this tab knew is gone (#1996): the next person must see every resource's first-load state,
+         * not inherit the previous person's "already loaded" marks. `USER_LOGOUT` is announced once per
+         * departure on every path — sign-out, a refused refresh, a failed restore, another tab's sign-out, a
+         * replacement. This listened to `AUTH_LOGOUT_REQUIRED` before, an event nothing ever emitted.
+         */
+        unsubscribes.push(frontendEventBus.on(FrontendEvents.USER_LOGOUT, () => {
             loadedOnceCacheRef.current.clear();
         }));
         unsubscribes.push(frontendEventBus.on(FrontendEvents.WHOLE_APP_REFRESH, () => {

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

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

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

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

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

@@ -29,6 +29,24 @@ function resolveSurfaceLoadingPolicy(value) {
             return undefined;
     }
 }
+/**
+ * The box a READY child-keeping gate wraps its children in — transparent to its PARENT's layout model.
+ *
+ * `display: contents` is transparent to a FLEX or GRID parent: the children become the items, so gaps,
+ * `h-full` chains and grid placement all survive (the reason the wrapper is `contents` at all — see the
+ * comment where it renders). It is NOT transparent to a MARGIN STACK. `space-y-*` spaces a parent's
+ * children with `margin-block-end` on each one, and a `contents` box has no box to hold a margin, so the
+ * gap after every gated surface vanished: measured 2026-09-25 on Wonder Todos, where a todo's record body
+ * and the workspace composite below it touched edge to edge on every READ page, because the displayer's
+ * gate sat directly inside the read layout's `space-y-section`.
+ *
+ * In a margin stack the parent is ordinary block flow, and there a plain block wrapper is the transparent
+ * choice: it lays out exactly as its content would and carries the stack's margin. So the gate is a block
+ * box when its parent is a `space-y-*` stack and `contents` everywhere else. Keyed on the parent's own
+ * utility because that is the layout decision the gate has to agree with; the class list is the only place
+ * it is written down.
+ */
+const READY_GATE_TRANSPARENT_BOX_CLASS = "contents [:where([class*='space-y-'])>&]:block";
 /** Treatments that render the gate's children while loading — the ones a remount would cost something under. */
 const CHILD_KEEPING_TREATMENTS = new Set([
     LoadingTreatment.OPACITY_OVERLAY,
@@ -182,7 +200,7 @@ export function LoadingGate({ loadingScopes, i18nKeys, readiness, policy, render
     const keepsChildrenWhileLoading = CHILD_KEEPING_TREATMENTS.has(refreshTreatment) || CHILD_KEEPING_TREATMENTS.has(initialTreatment);
     if (allReady) {
         return keepsChildrenWhileLoading
-            ? _jsx("div", { className: "contents", "data-loading-gate": "ready", children: children })
+            ? _jsx("div", { className: READY_GATE_TRANSPARENT_BOX_CLASS, "data-loading-gate": "ready", children: children })
             : _jsx(_Fragment, { children: children });
     }
     // ── Not ready — render loading treatment ────────────────────────────────

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

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

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

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

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

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

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

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

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

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

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

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