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

package/dist/esm/core/enums/common-enum-registry.js

@@ -1,8 +1,9 @@
 /**
  * Common enum registration.
  *
- * Registers enum names for i18n label resolution and stores visual
- * configuration for system enums. Two mechanisms for visual config:
+ * Stores visual configuration for system enums. It does NOT wire words: an enum value is worded through
+ * the `system_enums.<name>` block of the enum its FIELD declares (`.systemEnum(name)`), whether or not the
+ * name was registered here (#966). Two mechanisms for visual config:
  *
  * 1. **Schema-level** — when a schema field is provided, calls `.enumUI()`
  *    to mutate the field's metadata in place (same mechanism as `fields`).
@@ -15,19 +16,51 @@
  * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets
  * - App-specific common enums registered in `App.tsx` or equivalent
  */
-import { SYSTEM_ENUM_NAMES } from '@wildo-ai/presets-components-models';
+import { getEnumUI, getEnumValues } from '@wildo-ai/zod-decorators';
+import { resolveDeclaredSystemEnumName, resolveFieldEnumSchema } from '@wildo-ai/presets-components-models';
 /**
  * Registry-level visual config for common enums, keyed by enum name.
  *
  * Used as a fallback when a schema field has `.systemEnum(name)` but no
  * field-level `.enumUI()`. Populated by `registerCommonEnum()`.
  *
- * Priority chain at render time:
+ * Priority chain at render time — implemented by {@link resolveEnumDisplayConfig}, which every
+ * enum reader goes through:
  * 1. Field-level `.enumUI()` metadata (highest)
  * 2. This registry by `.systemEnum()` name (fallback)
  * 3. Default rendering (no config)
+ *
+ * That chain was DOCUMENTED here and implemented nowhere until 2026-09-20 (#1321): no renderer
+ * read this map, so a registry-only registration coloured nothing and every vocabulary that wanted
+ * a colour had to be decorated again at each field that carried it — three copies of one run-status
+ * map in the creation workbench alone.
  */
 export const COMMON_ENUM_DISPLAY_CONFIG = new Map();
+/**
+ * The enum-UI params a field RENDERS with: its own `.enumUI()` metadata over the registry-level
+ * config of the vocabulary it declares (`.systemEnum(name)`, or an exact framework vocabulary).
+ *
+ * Read this, never `getEnumUI` directly, wherever a colour, an icon or a display mode is resolved
+ * for an enum value — the display formatter, the form controls, the chart colour bridge. It is what
+ * makes "register the vocabulary once" true: a status field that declares `FlowsActors_Status` gets
+ * that vocabulary's badge treatment on every resource that carries it, with nothing decorated at the
+ * field.
+ *
+ * Merge is per key with the field winning, and per VALUE inside `values`, so a field may override
+ * one member's colour without restating the rest of the map.
+ */
+export function resolveEnumDisplayConfig(schema) {
+    const declared = getEnumUI(schema);
+    const enumSchema = resolveFieldEnumSchema(schema);
+    const name = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;
+    const registered = name ? COMMON_ENUM_DISPLAY_CONFIG.get(name) : undefined;
+    if (!registered)
+        return declared;
+    if (!declared)
+        return registered;
+    const values = registered.values || declared.values ? { ...registered.values, ...declared.values } : undefined;
+    return { ...registered, ...declared, ...(values ? { values } : {}) };
+}
 /**
  * Get visual display config for a system enum by name.
  * Returns `undefined` if the enum has no registered visual config.
@@ -36,9 +69,11 @@ export function getCommonEnumDisplayConfig(name) {
     return COMMON_ENUM_DISPLAY_CONFIG.get(name);
 }
 /**
- * Register a common enum for i18n and optionally apply visual display config.
+ * Register a common enum's visual display config.
  *
- * - Adds the name to `SYSTEM_ENUM_NAMES` (used by `tResourceFieldEnumValue` i18n cascade)
+ * - Wires NO words. `tResourceFieldEnumValue` reads `system_enums.<name>` only for the enum a field
+ *   DECLARES (`.systemEnum(name)`, see `resolveResourceLabelSystemEnumName`). Registration used to add
+ *   the name to a `SYSTEM_ENUM_NAMES` set the cascade walked by value; the walk and the set are gone (#966)
  * - If `displayConfig` is a plain object, stores it in `COMMON_ENUM_DISPLAY_CONFIG`
  *   for registry-level fallback
  * - If `schema` is also provided, calls `.enumUI()` on it (schema-level, highest priority)
@@ -74,7 +109,6 @@ export function getCommonEnumDisplayConfig(name) {
  * ```
  */
 export function registerCommonEnum(name, schema, displayConfig) {
-    SYSTEM_ENUM_NAMES.add(name);
     if (displayConfig) {
         if (typeof displayConfig !== 'function') {
             COMMON_ENUM_DISPLAY_CONFIG.set(name, displayConfig);

package/dist/esm/core/enums/common-enum-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"common-enum-registry.js","sourceRoot":"","sources":["../../../../src/core/enums/common-enum-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAUxE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAqB,EACrB,aAAuE;IAEvE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACxC,0BAA0B,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACV,MAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["/**\n * Common enum registration.\n *\n * Registers enum names for i18n label resolution and stores visual\n * configuration for system enums. Two mechanisms for visual config:\n *\n * 1. **Schema-level** — when a schema field is provided, calls `.enumUI()`\n *    to mutate the field's metadata in place (same mechanism as `fields`).\n * 2. **Registry-level** — visual config is always stored in\n *    `COMMON_ENUM_DISPLAY_CONFIG` by enum name. This serves as a fallback for\n *    fields with `.systemEnum(name)` but no `.enumUI()` of their own\n *    (e.g., standalone enums like `AvailableLanguage`, `AvailableCountry`).\n *\n * Registration is typically done at application startup, before React mounts:\n * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets\n * - App-specific common enums registered in `App.tsx` or equivalent\n */\n\nimport type { z } from 'zod';\nimport type { DecoratorUpdater, EnumUIParams } from '@wildo-ai/zod-decorators';\nimport { SYSTEM_ENUM_NAMES } from '@wildo-ai/presets-components-models';\n\n/**\n * Subset of enum-UI params appropriate for common enum registration: per-value\n * colors/icons (`values`), the color/icon defaults, and `display` (so a common enum\n * can opt into `displayMode: BADGE`/`ICON` — without it, `DisplayFieldEnum` defaults to\n * `TEXT`, which renders neither the registered colors nor icons).\n */\ntype CommonEnumVisualConfig = Pick<EnumUIParams, 'values' | 'defaultColor' | 'defaultIcon' | 'display'>;\n\n/**\n * Registry-level visual config for common enums, keyed by enum name.\n *\n * Used as a fallback when a schema field has `.systemEnum(name)` but no\n * field-level `.enumUI()`. Populated by `registerCommonEnum()`.\n *\n * Priority chain at render time:\n * 1. Field-level `.enumUI()` metadata (highest)\n * 2. This registry by `.systemEnum()` name (fallback)\n * 3. Default rendering (no config)\n */\nexport const COMMON_ENUM_DISPLAY_CONFIG = new Map<string, CommonEnumVisualConfig>();\n\n/**\n * Get visual display config for a system enum by name.\n * Returns `undefined` if the enum has no registered visual config.\n */\nexport function getCommonEnumDisplayConfig(name: string): CommonEnumVisualConfig | undefined {\n  return COMMON_ENUM_DISPLAY_CONFIG.get(name);\n}\n\n/**\n * Register a common enum for i18n and optionally apply visual display config.\n *\n * - Adds the name to `SYSTEM_ENUM_NAMES` (used by `tResourceFieldEnumValue` i18n cascade)\n * - If `displayConfig` is a plain object, stores it in `COMMON_ENUM_DISPLAY_CONFIG`\n *   for registry-level fallback\n * - If `schema` is also provided, calls `.enumUI()` on it (schema-level, highest priority)\n *\n * `displayConfig` accepts either:\n * - A **plain object** (deep-merged with existing metadata — restricted to\n *   `values`, `defaultColor`, `defaultIcon` for safety)\n * - A **`DecoratorUpdater` function** `(current) => newConfig` for full control\n *   when the restricted subset is not sufficient\n *\n * **Shared vs. independent metadata:** when a schema is provided, this function\n * mutates it directly. If the same enum field is reused across multiple resource\n * schemas, all share the same metadata. When a resource needs independent overrides,\n * use `z_clone()` from `@wildo-ai/zod-decorators` to create an independent copy.\n *\n * @param name - Unique enum name (e.g., `'SubscriptionStatus'`, `'AvailableLanguage'`)\n * @param schema - Optional Zod schema field to apply visual config to (e.g., `Shape.status`)\n * @param displayConfig - Visual config: plain object (deep-merged) or updater function (full replacement)\n *\n * @example\n * ```ts\n * // With schema field — applies to schema AND stores in registry\n * const shape = getZodObjectShape(SubscriptionSchema);\n * registerCommonEnum('SubscriptionStatus', shape.status, {\n *   values: { active: { color: 'success' }, cancelled: { color: 'destructive' } },\n *   defaultColor: 'secondary',\n * });\n *\n * // Without schema field — registry-only (for standalone enums)\n * registerCommonEnum('AvailableLanguage', undefined, {\n *   values: { en: { icon: '🇺🇸' }, fr: { icon: '🇫🇷' } },\n * });\n * ```\n */\nexport function registerCommonEnum(\n  name: string,\n  schema?: z.ZodTypeAny,\n  displayConfig?: CommonEnumVisualConfig | DecoratorUpdater<EnumUIParams>,\n): void {\n  SYSTEM_ENUM_NAMES.add(name);\n\n  if (displayConfig) {\n    if (typeof displayConfig !== 'function') {\n      COMMON_ENUM_DISPLAY_CONFIG.set(name, displayConfig);\n    }\n    if (schema) {\n      (schema as any).enumUI(displayConfig);\n    }\n  }\n}\n"]}
+{"version":3,"file":"common-enum-registry.js","sourceRoot":"","sources":["../../../../../src/core/enums/common-enum-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAU5G;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAoB;IAC3D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAqB,EACrB,aAAuE;IAEvE,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACxC,0BAA0B,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACV,MAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["/**\n * Common enum registration.\n *\n * Stores visual configuration for system enums. It does NOT wire words: an enum value is worded through\n * the `system_enums.<name>` block of the enum its FIELD declares (`.systemEnum(name)`), whether or not the\n * name was registered here (#966). Two mechanisms for visual config:\n *\n * 1. **Schema-level** — when a schema field is provided, calls `.enumUI()`\n *    to mutate the field's metadata in place (same mechanism as `fields`).\n * 2. **Registry-level** — visual config is always stored in\n *    `COMMON_ENUM_DISPLAY_CONFIG` by enum name. This serves as a fallback for\n *    fields with `.systemEnum(name)` but no `.enumUI()` of their own\n *    (e.g., standalone enums like `AvailableLanguage`, `AvailableCountry`).\n *\n * Registration is typically done at application startup, before React mounts:\n * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets\n * - App-specific common enums registered in `App.tsx` or equivalent\n */\n\nimport type { z } from 'zod';\nimport { getEnumUI, getEnumValues } from '@wildo-ai/zod-decorators';\nimport type { DecoratorUpdater, EnumUIParams } from '@wildo-ai/zod-decorators';\nimport { resolveDeclaredSystemEnumName, resolveFieldEnumSchema } from '@wildo-ai/presets-components-models';\n\n/**\n * Subset of enum-UI params appropriate for common enum registration: per-value\n * colors/icons (`values`), the color/icon defaults, and `display` (so a common enum\n * can opt into `displayMode: BADGE`/`ICON` — without it, `DisplayFieldEnum` defaults to\n * `TEXT`, which renders neither the registered colors nor icons).\n */\ntype CommonEnumVisualConfig = Pick<EnumUIParams, 'values' | 'defaultColor' | 'defaultIcon' | 'display'>;\n\n/**\n * Registry-level visual config for common enums, keyed by enum name.\n *\n * Used as a fallback when a schema field has `.systemEnum(name)` but no\n * field-level `.enumUI()`. Populated by `registerCommonEnum()`.\n *\n * Priority chain at render time — implemented by {@link resolveEnumDisplayConfig}, which every\n * enum reader goes through:\n * 1. Field-level `.enumUI()` metadata (highest)\n * 2. This registry by `.systemEnum()` name (fallback)\n * 3. Default rendering (no config)\n *\n * That chain was DOCUMENTED here and implemented nowhere until 2026-09-20 (#1321): no renderer\n * read this map, so a registry-only registration coloured nothing and every vocabulary that wanted\n * a colour had to be decorated again at each field that carried it — three copies of one run-status\n * map in the creation workbench alone.\n */\nexport const COMMON_ENUM_DISPLAY_CONFIG = new Map<string, CommonEnumVisualConfig>();\n\n/**\n * The enum-UI params a field RENDERS with: its own `.enumUI()` metadata over the registry-level\n * config of the vocabulary it declares (`.systemEnum(name)`, or an exact framework vocabulary).\n *\n * Read this, never `getEnumUI` directly, wherever a colour, an icon or a display mode is resolved\n * for an enum value — the display formatter, the form controls, the chart colour bridge. It is what\n * makes \"register the vocabulary once\" true: a status field that declares `FlowsActors_Status` gets\n * that vocabulary's badge treatment on every resource that carries it, with nothing decorated at the\n * field.\n *\n * Merge is per key with the field winning, and per VALUE inside `values`, so a field may override\n * one member's colour without restating the rest of the map.\n */\nexport function resolveEnumDisplayConfig(schema: z.ZodTypeAny): EnumUIParams | undefined {\n  const declared = getEnumUI(schema);\n  const enumSchema = resolveFieldEnumSchema(schema);\n  const name = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;\n  const registered = name ? COMMON_ENUM_DISPLAY_CONFIG.get(name) : undefined;\n  if (!registered) return declared;\n  if (!declared) return registered;\n  const values = registered.values || declared.values ? { ...registered.values, ...declared.values } : undefined;\n  return { ...registered, ...declared, ...(values ? { values } : {}) };\n}\n\n/**\n * Get visual display config for a system enum by name.\n * Returns `undefined` if the enum has no registered visual config.\n */\nexport function getCommonEnumDisplayConfig(name: string): CommonEnumVisualConfig | undefined {\n  return COMMON_ENUM_DISPLAY_CONFIG.get(name);\n}\n\n/**\n * Register a common enum's visual display config.\n *\n * - Wires NO words. `tResourceFieldEnumValue` reads `system_enums.<name>` only for the enum a field\n *   DECLARES (`.systemEnum(name)`, see `resolveResourceLabelSystemEnumName`). Registration used to add\n *   the name to a `SYSTEM_ENUM_NAMES` set the cascade walked by value; the walk and the set are gone (#966)\n * - If `displayConfig` is a plain object, stores it in `COMMON_ENUM_DISPLAY_CONFIG`\n *   for registry-level fallback\n * - If `schema` is also provided, calls `.enumUI()` on it (schema-level, highest priority)\n *\n * `displayConfig` accepts either:\n * - A **plain object** (deep-merged with existing metadata — restricted to\n *   `values`, `defaultColor`, `defaultIcon` for safety)\n * - A **`DecoratorUpdater` function** `(current) => newConfig` for full control\n *   when the restricted subset is not sufficient\n *\n * **Shared vs. independent metadata:** when a schema is provided, this function\n * mutates it directly. If the same enum field is reused across multiple resource\n * schemas, all share the same metadata. When a resource needs independent overrides,\n * use `z_clone()` from `@wildo-ai/zod-decorators` to create an independent copy.\n *\n * @param name - Unique enum name (e.g., `'SubscriptionStatus'`, `'AvailableLanguage'`)\n * @param schema - Optional Zod schema field to apply visual config to (e.g., `Shape.status`)\n * @param displayConfig - Visual config: plain object (deep-merged) or updater function (full replacement)\n *\n * @example\n * ```ts\n * // With schema field — applies to schema AND stores in registry\n * const shape = getZodObjectShape(SubscriptionSchema);\n * registerCommonEnum('SubscriptionStatus', shape.status, {\n *   values: { active: { color: 'success' }, cancelled: { color: 'destructive' } },\n *   defaultColor: 'secondary',\n * });\n *\n * // Without schema field — registry-only (for standalone enums)\n * registerCommonEnum('AvailableLanguage', undefined, {\n *   values: { en: { icon: '🇺🇸' }, fr: { icon: '🇫🇷' } },\n * });\n * ```\n */\nexport function registerCommonEnum(\n  name: string,\n  schema?: z.ZodTypeAny,\n  displayConfig?: CommonEnumVisualConfig | DecoratorUpdater<EnumUIParams>,\n): void {\n  if (displayConfig) {\n    if (typeof displayConfig !== 'function') {\n      COMMON_ENUM_DISPLAY_CONFIG.set(name, displayConfig);\n    }\n    if (schema) {\n      (schema as any).enumUI(displayConfig);\n    }\n  }\n}\n"]}

package/dist/esm/core/errors/ErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAUpD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAsBnC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAUrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAgCjE,UAAU,EAAE,MAAM,IAAI,CAMpB;IAEF,MAAM,IAAI,KAAK,CAAC,SAAS;CA0B1B"}
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAUpD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAsBnC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAUrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAgCjE,UAAU,EAAE,MAAM,IAAI,CAMpB;IAEF,MAAM,IAAI,KAAK,CAAC,SAAS;CA0B1B"}

package/dist/esm/core/errors/ErrorBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { Component, ReactNode } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { ErrorType } from '@wildo-ai/saas-models';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { AppLayout_ErrorBoundary } from '~wildo-frontend-lib/components/app/AppLayout_ErrorBoundary';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\nimport {\n  ErrorBoundaryState,\n  ErrorBoundaryProps,\n} from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorBoundary');\nlogger.setDebugTypeLogging('ErrorBoundary', false);\n\nfunction ErrorBoundaryFallback(props: {\n  error: Error;\n  errorInfo: React.ErrorInfo;\n  resetError: () => void;\n}): React.JSX.Element {\n  const routerNavigate = useNavigate();\n  const { emit } = useEventBus();\n\n  return (\n    <AppLayout_ErrorBoundary\n      {...props}\n      navigateHome={() => navigateHomeWithFreshStart({ emit, routerNavigate })}\n    />\n  );\n}\n\n/**\n * React ErrorBoundary component that catches JavaScript errors anywhere in the child component tree,\n * logs those errors, and displays a fallback UI instead of the component tree that crashed.\n *\n * This integrates with the existing Wildo error handling system to provide consistent error reporting.\n * Uses the APP_LAYOUTS_ERROR_BOUNDARY component for rendering with i18n labels and proper icons.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  constructor(props: ErrorBoundaryProps) {\n    super(props);\n    this.state = {\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    };\n    // Uses sharedErrorBuilder singleton for consistent error building with user context\n  }\n\n  static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState> {\n    // Update state so the next render will show the fallback UI\n    return {\n      hasError: true,\n      error,\n    };\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void {\n    this.setState({\n      error,\n      errorInfo,\n    });\n\n    // Log to console for development\n    logger.error('ErrorBoundary caught an error:', {error, errorInfo});\n\n    // Create a Wildo error for consistent error handling\n    // Uses sharedErrorBuilder singleton - automatically includes user context\n    const wildoError = sharedErrorBuilder.buildReactError(error, errorInfo);\n\n    // Emit error via EventBus (replaces legacy window.dispatchEvent)\n    try {\n      frontendEventBus.emit(FrontendEvents.ERROR_OCCURED, {\n        error: wildoError\n      });\n    } catch (dispatchError) {\n      logger.warn('Failed to emit error event:', {dispatchError});\n    }\n\n    // Call custom onError handler if provided\n    if (this.props.onError) {\n      try {\n        this.props.onError(error, errorInfo);\n      } catch (handlerError) {\n        logger.warn('Error in custom error handler:', handlerError);\n      }\n    }\n  }\n\n  resetError: () => void = () => {\n    this.setState({\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    });\n  };\n\n  render(): React.ReactNode {\n    if (this.state.hasError && this.state.error && this.state.errorInfo) {\n      // Use custom fallback component if provided\n      if (this.props.fallback) {\n        const FallbackComponent = this.props.fallback;\n        return (\n          <FallbackComponent\n            error={this.state.error}\n            errorInfo={this.state.errorInfo}\n            resetError={this.resetError}\n          />\n        );\n      }\n\n      // Use the APP_LAYOUTS_ERROR_BOUNDARY component\n      return (\n        <ErrorBoundaryFallback\n          error={this.state.error}\n          errorInfo={this.state.errorInfo}\n          resetError={this.resetError}\n        />\n      );\n    }\n\n    return this.props.children;\n  }\n}\n\n// Note: withErrorBoundary HOC is in withErrorBoundary.tsx for React Fast Refresh compatibility.\n"]}
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { Component, ReactNode } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { ErrorType } from '@wildo-ai/saas-models';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { AppLayout_ErrorBoundary } from '~wildo-frontend-lib/components/app/AppLayout_ErrorBoundary';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\nimport {\n  ErrorBoundaryState,\n  ErrorBoundaryProps,\n} from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorBoundary');\nlogger.setDebugTypeLogging('ErrorBoundary', false);\n\nfunction ErrorBoundaryFallback(props: {\n  error: Error;\n  errorInfo: React.ErrorInfo;\n  resetError: () => void;\n}): React.JSX.Element {\n  const routerNavigate = useNavigate();\n  const { emit } = useEventBus();\n\n  return (\n    <AppLayout_ErrorBoundary\n      {...props}\n      navigateHome={() => navigateHomeWithFreshStart({ emit, routerNavigate })}\n    />\n  );\n}\n\n/**\n * React ErrorBoundary component that catches JavaScript errors anywhere in the child component tree,\n * logs those errors, and displays a fallback UI instead of the component tree that crashed.\n *\n * This integrates with the existing Wildo error handling system to provide consistent error reporting.\n * Uses the APP_LAYOUTS_ERROR_BOUNDARY component for rendering with i18n labels and proper icons.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  constructor(props: ErrorBoundaryProps) {\n    super(props);\n    this.state = {\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    };\n    // Uses sharedErrorBuilder singleton for consistent error building with user context\n  }\n\n  static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState> {\n    // Update state so the next render will show the fallback UI\n    return {\n      hasError: true,\n      error,\n    };\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void {\n    this.setState({\n      error,\n      errorInfo,\n    });\n\n    // Log to console for development\n    logger.error('ErrorBoundary caught an error:', {error, errorInfo});\n\n    // Create a Wildo error for consistent error handling\n    // Uses sharedErrorBuilder singleton - automatically includes user context\n    const wildoError = sharedErrorBuilder.buildReactError(error, errorInfo);\n\n    // Emit error via EventBus (replaces legacy window.dispatchEvent)\n    try {\n      frontendEventBus.emit(FrontendEvents.ERROR_OCCURED, {\n        error: wildoError\n      });\n    } catch (dispatchError) {\n      logger.warn('Failed to emit error event:', {dispatchError});\n    }\n\n    // Call custom onError handler if provided\n    if (this.props.onError) {\n      try {\n        this.props.onError(error, errorInfo);\n      } catch (handlerError) {\n        logger.warn('Error in custom error handler:', handlerError);\n      }\n    }\n  }\n\n  resetError: () => void = () => {\n    this.setState({\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    });\n  };\n\n  render(): React.ReactNode {\n    if (this.state.hasError && this.state.error && this.state.errorInfo) {\n      // Use custom fallback component if provided\n      if (this.props.fallback) {\n        const FallbackComponent = this.props.fallback;\n        return (\n          <FallbackComponent\n            error={this.state.error}\n            errorInfo={this.state.errorInfo}\n            resetError={this.resetError}\n          />\n        );\n      }\n\n      // Use the APP_LAYOUTS_ERROR_BOUNDARY component\n      return (\n        <ErrorBoundaryFallback\n          error={this.state.error}\n          errorInfo={this.state.errorInfo}\n          resetError={this.resetError}\n        />\n      );\n    }\n\n    return this.props.children;\n  }\n}\n\n// Note: withErrorBoundary HOC is in withErrorBoundary.tsx for React Fast Refresh compatibility.\n"]}

package/dist/esm/core/errors/ErrorContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorContext.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,SAAS,EAA4D,MAAM,OAAO,CAAC;AAUnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAM7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAA0D,CAAC;AAEhI,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAsP3D,CAAC"}
+{"version":3,"file":"ErrorContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,SAAS,EAA4D,MAAM,OAAO,CAAC;AAUnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAM7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAA0D,CAAC;AAEhI,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAsP3D,CAAC"}

package/dist/esm/core/errors/ErrorContext.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { ERROR_DEFINITIONS, ErrorActionFrontend, ErrorType, Error_Frontend_RedirectPolicy, ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import { ERROR_DEFINITIONS, ErrorActionFrontend, Error_Frontend_RedirectPolicy, ResourcePrimaryScope, describeCaughtError } from '@wildo-ai/saas-models';
 import { createContext, useEffect, useCallback, useMemo } from 'react';
 import { WINDOW_EVENTS_SLUGS } from '../../core/commons/window-event.frontend.schemas.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
@@ -136,18 +136,14 @@ export const ErrorProvider = ({ children }) => {
                         break;
                     }
                     case ErrorActionFrontend.SHOW_MODAL: {
-                        const errorTypeModal = wildoErrorParam.type;
-                        const errorDefinitionModal = ERROR_DEFINITIONS[errorTypeModal];
-                        const customMessageReferenceModal = wildoErrorParam.customMessageReference;
-                        const messageModal = customMessageReferenceModal || errorDefinitionModal.description;
-                        const contextModal = wildoErrorParam.context;
+                        // The error itself, never text: this provider sits ABOVE the I18nProvider, so the modal's renderer
+                        // (`ErrorModalContent`) resolves the words. The raw reference, `ERROR_DEFINITIONS` developer
+                        // description and request context pushed here used to reach the screen (#1159).
                         frontendEventBus.emit(FrontendEvents.NAVIGATION_PUSH, {
                             zone: NavigationZone.OVERLAY,
                             content: {
                                 contentType: NavigationContentType.ERROR_MODAL,
-                                errorType: errorTypeModal,
-                                message: messageModal,
-                                context: contextModal,
+                                errorType: wildoErrorParam.type,
                                 wildoError: wildoErrorParam,
                             },
                             stackEntryId: `error_modal_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
@@ -163,7 +159,7 @@ export const ErrorProvider = ({ children }) => {
                 console.warn('Failed to execute frontend error action', {
                     action,
                     originalError: wildoErrorParam,
-                    actionError: actionError instanceof Error ? actionError.message : String(actionError)
+                    actionError: describeCaughtError(actionError)
                 });
             }
         });
@@ -215,7 +211,12 @@ export const ErrorProvider = ({ children }) => {
                     ...additionalContext,
                 },
             };
-            if (error.wildoErrorEventEmitted === true) {
+            // Already emitted AND displayed: the global handler showed it, so a second toast would duplicate it.
+            // A `silent` request is different — its event was emitted with `suppressUserDisplay`, which means
+            // "the CALLER owns the user-facing message". A caller reporting it here IS that owner, so it is
+            // displayed. Treating every emitted error as displayed is what left a refused form save with no
+            // words of its own: the form fell back to a fresh `Error`, classified as an uncaught exception (#1447).
+            if (error.wildoErrorEventEmitted === true && normalizedWildoError.suppressUserDisplay !== true) {
                 logger.error(enrichedWildoError.customMessageReference, enrichedWildoError.context);
                 return;
             }
@@ -242,22 +243,4 @@ export const ErrorProvider = ({ children }) => {
     }), [handleError, handleWildoError, setUserContext]);
     return _jsx(ErrorContext.Provider, { value: value, children: children });
 };
-// useError hook is now in separate file: ./useError.ts
-// This separation is required for React Fast Refresh compatibility
-/**
- * Utility function to create error with minimal config
- * @__PURE__
- */
-const createError = /* #__PURE__ */ (message, type = ErrorType.UNKNOWN, overrides) => {
-    const error = new Error(message);
-    const wildoError = sharedErrorBuilder.buildWildoError_Frontend(type, {
-        customMessageReference: overrides?.customMessageReference,
-        operationPathKey: overrides?.operationPathKey,
-        context: {
-            originalMessage: message,
-            ...overrides?.context
-        }
-    });
-    return { error, wildoError };
-};
 //# sourceMappingURL=ErrorContext.js.map

package/dist/esm/core/errors/ErrorContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorContext.js","sourceRoot":"","sources":["../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERROR_DEFINITIONS,\n  ErrorActionFrontend,\n  ErrorCustomMessageReference,\n  ErrorType,\n  Error_Frontend_RedirectPolicy,\n  ResourcePrimaryScope,\n  WildoError_Frontend\n} from '@wildo-ai/saas-models';\nimport React, { ReactNode, createContext, useState, useEffect, useCallback, useMemo } from 'react';\nimport { WINDOW_EVENTS_SLUGS } from '~wildo-frontend-lib/core/commons/window-event.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { ErrorManagementService } from './error-management.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { NavigationZone, NavigationContentType, NavigationSource } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { ErrorSeverity, FrontendNotificationCustomMessageRefs } from '@wildo-ai/saas-models';\nimport { ErrorContextType } from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorContext');\nlogger.setDebugTypeLogging('ErrorContext', false);\n\n/**\n * Error Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useError() hook instead of accessing this directly\n */\nexport const ErrorContext: React.Context<ErrorContextType | undefined> = createContext<ErrorContextType | undefined>(undefined);\n\nexport const ErrorProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const { on } = useEventBus();\n\n  const setUserContext = useCallback((userId?: string, organizationId?: string) => {\n    sharedErrorBuilder.updateUserId(userId);\n    sharedErrorBuilder.updateOrganizationId(organizationId);\n  }, []);\n\n  // Sync with user context changes - updates shared singleton\n  useEffect(() => {\n    const unsubscribe = on(FrontendEvents.USER_LOGIN, (payload) => {\n      if (payload.userId) {\n        setUserContext(payload.userId, undefined);\n      }\n    });\n    \n    const unsubscribe2 = on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n      if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS && payload.newValue) {\n        sharedErrorBuilder.updateOrganizationId(payload.newValue);\n      }\n    });\n    \n    return () => {\n      unsubscribe();\n      unsubscribe2();\n    };\n  }, [on, setUserContext]);\n\n  const executeFrontendActions = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const frontendActions: ErrorActionFrontend[] = ((wildoErrorParam as WildoError_Frontend).frontendActions || []) as ErrorActionFrontend[];\n    frontendActions.forEach(action => {\n      try {\n        switch (action) {\n          case ErrorActionFrontend.NOTIFY:\n          case ErrorActionFrontend.SHOW_TOAST: {\n            const showToUser: boolean | undefined = (wildoErrorParam as WildoError_Frontend).showToUser;\n            if (showToUser !== false) {\n              const errorType: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n              const errorDefinition = ERROR_DEFINITIONS[errorType];\n              const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n              const context = wildoErrorParam.context as Record<string, unknown> | undefined;\n              const userGuidance = (wildoErrorParam as any).userGuidance as { explanation?: string; resolution?: string } | undefined;\n              const message = userGuidance?.explanation\n                || userGuidance?.resolution\n                || (context?.message as string)\n                || (context?.errorMessage as string)\n                || (context?.originalMessage as string)\n                || customMessageReference\n                || errorDefinition.description;\n              \n              const eventPayload = {\n                identifier: FrontendNotificationCustomMessageRefs.A_TEMP_REF,\n                data: {\n                  message,\n                  errorType: wildoErrorParam.type,\n                  customMessageReference: wildoErrorParam.customMessageReference,\n                  context,\n                },\n              } as const;\n              \n              switch (errorDefinition.severity) {\n                case 'critical':\n                case 'high':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n                  break;\n                case 'medium':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_WARNING, eventPayload);\n                  break;\n                case 'low':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_INFO, eventPayload);\n                  break;\n                default:\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.DISCONNECT: {\n            const errorTypeDisconnect: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampDisconnect: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const logoutEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.LOGOUT, {\n              detail: { \n                reason: 'error_disconnect', \n                errorType: errorTypeDisconnect,\n                timestamp: timestampDisconnect \n              }\n            });\n            window.dispatchEvent(logoutEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.REDIRECT: {\n            const redirectPolicy: Error_Frontend_RedirectPolicy | undefined = (wildoErrorParam as WildoError_Frontend).redirectPolicy;\n            if (redirectPolicy) {\n              switch (redirectPolicy) {\n                case Error_Frontend_RedirectPolicy.LOGIN:\n                  window.location.href = '/login';\n                  break;\n                case Error_Frontend_RedirectPolicy.HOME:\n                  window.location.href = '/';\n                  break;\n                case Error_Frontend_RedirectPolicy.HISTORY_BACK:\n                  window.history.back();\n                  break;\n                default:\n                  logDebug('Redirect policy handled by error boundary', { policy: redirectPolicy });\n                  break;\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.REFRESH_TOKEN: {\n            const errorTypeRefresh: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampRefresh: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const refreshEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.REFRESH_TOKEN, {\n              detail: { \n                reason: 'error_refresh', \n                errorType: errorTypeRefresh,\n                timestamp: timestampRefresh \n              }\n            });\n            window.dispatchEvent(refreshEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.SHOW_MODAL: {\n            const errorTypeModal: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const errorDefinitionModal = ERROR_DEFINITIONS[errorTypeModal];\n            const customMessageReferenceModal: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n            const messageModal = customMessageReferenceModal || errorDefinitionModal.description;\n            const contextModal: Record<string, any> | undefined = (wildoErrorParam as WildoError_Frontend).context;\n            \n            frontendEventBus.emit(FrontendEvents.NAVIGATION_PUSH, {\n              zone: NavigationZone.OVERLAY,\n              content: {\n                contentType: NavigationContentType.ERROR_MODAL,\n                errorType: errorTypeModal,\n                message: messageModal,\n                context: contextModal,\n                wildoError: wildoErrorParam,\n              },\n              stackEntryId: `error_modal_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,\n              navigationSource: NavigationSource.CONTROLLER,\n            });\n            break;\n          }\n          \n          case ErrorActionFrontend.RETRY:\n            break;\n        }\n      } catch (actionError) {\n        console.warn('Failed to execute frontend error action', {\n          action,\n          originalError: wildoErrorParam,\n          actionError: actionError instanceof Error ? actionError.message : String(actionError)\n        });\n      }\n    });\n  }, []);\n\n  const handleWildoError = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const context: Record<string, any> | undefined = (wildoErrorParam as WildoError_Frontend).context;\n    /*\n     * Logged at the error's OWN severity. This handler used to write every error to the console at\n     * `error` level, so a LOW-severity outcome the behaviour matrix had already decided to keep from\n     * the user — a dangling optional reference answering 404 on a silent label probe — still arrived\n     * in the console as a red line on every render, indistinguishable from a real failure. The\n     * matrix is the one place that ranks an error; the console line follows it.\n     */\n    const logAtSeverity = (message: string): void => {\n      switch (wildoErrorParam.severity) {\n        case ErrorSeverity.LOW:\n          logger.debug(message, context);\n          break;\n        case ErrorSeverity.MEDIUM:\n          logger.warn(message, context);\n          break;\n        default:\n          logger.error(message, context);\n      }\n    };\n    if (context && typeof context === 'object' && 'originalError' in context) {\n      const originalError = context.originalError as unknown;\n      const errorMessage = originalError instanceof Error\n        ? originalError.message\n        : typeof originalError === 'string'\n          ? originalError\n          : String(originalError);\n      logAtSeverity(errorMessage);\n    } else {\n      const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n      logAtSeverity(customMessageReference);\n    }\n\n    executeFrontendActions(wildoErrorParam);\n  }, [executeFrontendActions]);\n\n  const handleError = useCallback((error: Error|any, customMessage?: string, additionalContext?: Record<string, unknown>) => {\n    const normalizedWildoError = error?.wildoError as WildoError_Frontend | undefined;\n    if (normalizedWildoError) {\n      const enrichedWildoError: WildoError_Frontend = {\n        ...normalizedWildoError,\n        context: {\n          ...(normalizedWildoError.context || {}),\n          ...(customMessage ? { originalError: customMessage } : {}),\n          ...additionalContext,\n        },\n      };\n\n      if ((error as any).wildoErrorEventEmitted === true) {\n        logger.error(enrichedWildoError.customMessageReference, enrichedWildoError.context as Record<string, any> | undefined);\n        return;\n      }\n\n      handleWildoError(enrichedWildoError);\n      return;\n    }\n\n    const errorType = ErrorManagementService.classifyError(error);\n    const errorMessage = customMessage || error?.message || 'Unknown error';\n    const errorDefinition = ERROR_DEFINITIONS[errorType];\n\n    const errorContext = {\n      originalError: errorMessage,\n      ...additionalContext\n    };\n\n    const wildoError = sharedErrorBuilder.buildWildoError_Frontend(errorType, {\n      customMessageReference: errorDefinition?.defaultCustomMessageReference,\n      context: errorContext\n    });\n\n    handleWildoError(wildoError);\n  }, [handleWildoError]);\n\n  const value = useMemo<ErrorContextType>(() => ({\n    handleError,\n    handleWildoError,\n    setUserContext,\n  }), [handleError, handleWildoError, setUserContext]);\n\n  return <ErrorContext.Provider value={value}>{children}</ErrorContext.Provider>;\n};\n\n// useError hook is now in separate file: ./useError.ts\n// This separation is required for React Fast Refresh compatibility\n\n/**\n * Utility function to create error with minimal config\n * @__PURE__\n */\nconst createError = /* #__PURE__ */ (\n  message: string, \n  type: ErrorType = ErrorType.UNKNOWN, \n  overrides?: {\n    customMessageReference?: ErrorCustomMessageReference,\n    operationPathKey?: string,\n    context?: Record<string, any>\n  }\n): { error: Error; wildoError: WildoError_Frontend } => {\n  const error = new Error(message);\n  \n  const wildoError = sharedErrorBuilder.buildWildoError_Frontend(type, {\n    customMessageReference: overrides?.customMessageReference,\n    operationPathKey: overrides?.operationPathKey,\n    context: { \n      originalMessage: message, \n      ...overrides?.context \n    }\n  });\n  \n  return { error, wildoError };\n}; "]}
+{"version":3,"file":"ErrorContext.js","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERROR_DEFINITIONS,\n  ErrorActionFrontend,\n  ErrorType,\n  Error_Frontend_RedirectPolicy,\n  ResourcePrimaryScope,\n  WildoError_Frontend, describeCaughtError } from '@wildo-ai/saas-models';\nimport React, { ReactNode, createContext, useState, useEffect, useCallback, useMemo } from 'react';\nimport { WINDOW_EVENTS_SLUGS } from '~wildo-frontend-lib/core/commons/window-event.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { ErrorManagementService } from './error-management.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { NavigationZone, NavigationContentType, NavigationSource } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { ErrorSeverity, FrontendNotificationCustomMessageRefs } from '@wildo-ai/saas-models';\nimport { ErrorContextType } from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorContext');\nlogger.setDebugTypeLogging('ErrorContext', false);\n\n/**\n * Error Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useError() hook instead of accessing this directly\n */\nexport const ErrorContext: React.Context<ErrorContextType | undefined> = createContext<ErrorContextType | undefined>(undefined);\n\nexport const ErrorProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const { on } = useEventBus();\n\n  const setUserContext = useCallback((userId?: string, organizationId?: string) => {\n    sharedErrorBuilder.updateUserId(userId);\n    sharedErrorBuilder.updateOrganizationId(organizationId);\n  }, []);\n\n  // Sync with user context changes - updates shared singleton\n  useEffect(() => {\n    const unsubscribe = on(FrontendEvents.USER_LOGIN, (payload) => {\n      if (payload.userId) {\n        setUserContext(payload.userId, undefined);\n      }\n    });\n    \n    const unsubscribe2 = on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n      if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS && payload.newValue) {\n        sharedErrorBuilder.updateOrganizationId(payload.newValue);\n      }\n    });\n    \n    return () => {\n      unsubscribe();\n      unsubscribe2();\n    };\n  }, [on, setUserContext]);\n\n  const executeFrontendActions = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const frontendActions: ErrorActionFrontend[] = ((wildoErrorParam as WildoError_Frontend).frontendActions || []) as ErrorActionFrontend[];\n    frontendActions.forEach(action => {\n      try {\n        switch (action) {\n          case ErrorActionFrontend.NOTIFY:\n          case ErrorActionFrontend.SHOW_TOAST: {\n            const showToUser: boolean | undefined = (wildoErrorParam as WildoError_Frontend).showToUser;\n            if (showToUser !== false) {\n              const errorType: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n              const errorDefinition = ERROR_DEFINITIONS[errorType];\n              const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n              const context = wildoErrorParam.context as Record<string, unknown> | undefined;\n              const userGuidance = (wildoErrorParam as any).userGuidance as { explanation?: string; resolution?: string } | undefined;\n              const message = userGuidance?.explanation\n                || userGuidance?.resolution\n                || (context?.message as string)\n                || (context?.errorMessage as string)\n                || (context?.originalMessage as string)\n                || customMessageReference\n                || errorDefinition.description;\n              \n              const eventPayload = {\n                identifier: FrontendNotificationCustomMessageRefs.A_TEMP_REF,\n                data: {\n                  message,\n                  errorType: wildoErrorParam.type,\n                  customMessageReference: wildoErrorParam.customMessageReference,\n                  context,\n                },\n              } as const;\n              \n              switch (errorDefinition.severity) {\n                case 'critical':\n                case 'high':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n                  break;\n                case 'medium':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_WARNING, eventPayload);\n                  break;\n                case 'low':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_INFO, eventPayload);\n                  break;\n                default:\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.DISCONNECT: {\n            const errorTypeDisconnect: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampDisconnect: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const logoutEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.LOGOUT, {\n              detail: { \n                reason: 'error_disconnect', \n                errorType: errorTypeDisconnect,\n                timestamp: timestampDisconnect \n              }\n            });\n            window.dispatchEvent(logoutEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.REDIRECT: {\n            const redirectPolicy: Error_Frontend_RedirectPolicy | undefined = (wildoErrorParam as WildoError_Frontend).redirectPolicy;\n            if (redirectPolicy) {\n              switch (redirectPolicy) {\n                case Error_Frontend_RedirectPolicy.LOGIN:\n                  window.location.href = '/login';\n                  break;\n                case Error_Frontend_RedirectPolicy.HOME:\n                  window.location.href = '/';\n                  break;\n                case Error_Frontend_RedirectPolicy.HISTORY_BACK:\n                  window.history.back();\n                  break;\n                default:\n                  logDebug('Redirect policy handled by error boundary', { policy: redirectPolicy });\n                  break;\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.REFRESH_TOKEN: {\n            const errorTypeRefresh: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampRefresh: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const refreshEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.REFRESH_TOKEN, {\n              detail: { \n                reason: 'error_refresh', \n                errorType: errorTypeRefresh,\n                timestamp: timestampRefresh \n              }\n            });\n            window.dispatchEvent(refreshEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.SHOW_MODAL: {\n            // The error itself, never text: this provider sits ABOVE the I18nProvider, so the modal's renderer\n            // (`ErrorModalContent`) resolves the words. The raw reference, `ERROR_DEFINITIONS` developer\n            // description and request context pushed here used to reach the screen (#1159).\n            frontendEventBus.emit(FrontendEvents.NAVIGATION_PUSH, {\n              zone: NavigationZone.OVERLAY,\n              content: {\n                contentType: NavigationContentType.ERROR_MODAL,\n                errorType: (wildoErrorParam as WildoError_Frontend).type,\n                wildoError: wildoErrorParam,\n              },\n              stackEntryId: `error_modal_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,\n              navigationSource: NavigationSource.CONTROLLER,\n            });\n            break;\n          }\n          \n          case ErrorActionFrontend.RETRY:\n            break;\n        }\n      } catch (actionError) {\n        console.warn('Failed to execute frontend error action', {\n          action,\n          originalError: wildoErrorParam,\n          actionError: describeCaughtError(actionError)\n        });\n      }\n    });\n  }, []);\n\n  const handleWildoError = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const context: Record<string, any> | undefined = (wildoErrorParam as WildoError_Frontend).context;\n    /*\n     * Logged at the error's OWN severity. This handler used to write every error to the console at\n     * `error` level, so a LOW-severity outcome the behaviour matrix had already decided to keep from\n     * the user — a dangling optional reference answering 404 on a silent label probe — still arrived\n     * in the console as a red line on every render, indistinguishable from a real failure. The\n     * matrix is the one place that ranks an error; the console line follows it.\n     */\n    const logAtSeverity = (message: string): void => {\n      switch (wildoErrorParam.severity) {\n        case ErrorSeverity.LOW:\n          logger.debug(message, context);\n          break;\n        case ErrorSeverity.MEDIUM:\n          logger.warn(message, context);\n          break;\n        default:\n          logger.error(message, context);\n      }\n    };\n    if (context && typeof context === 'object' && 'originalError' in context) {\n      const originalError = context.originalError as unknown;\n      const errorMessage = originalError instanceof Error\n        ? originalError.message\n        : typeof originalError === 'string'\n          ? originalError\n          : String(originalError);\n      logAtSeverity(errorMessage);\n    } else {\n      const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n      logAtSeverity(customMessageReference);\n    }\n\n    executeFrontendActions(wildoErrorParam);\n  }, [executeFrontendActions]);\n\n  const handleError = useCallback((error: Error|any, customMessage?: string, additionalContext?: Record<string, unknown>) => {\n    const normalizedWildoError = error?.wildoError as WildoError_Frontend | undefined;\n    if (normalizedWildoError) {\n      const enrichedWildoError: WildoError_Frontend = {\n        ...normalizedWildoError,\n        context: {\n          ...(normalizedWildoError.context || {}),\n          ...(customMessage ? { originalError: customMessage } : {}),\n          ...additionalContext,\n        },\n      };\n\n      // Already emitted AND displayed: the global handler showed it, so a second toast would duplicate it.\n      // A `silent` request is different — its event was emitted with `suppressUserDisplay`, which means\n      // \"the CALLER owns the user-facing message\". A caller reporting it here IS that owner, so it is\n      // displayed. Treating every emitted error as displayed is what left a refused form save with no\n      // words of its own: the form fell back to a fresh `Error`, classified as an uncaught exception (#1447).\n      if ((error as any).wildoErrorEventEmitted === true && (normalizedWildoError as any).suppressUserDisplay !== true) {\n        logger.error(enrichedWildoError.customMessageReference, enrichedWildoError.context as Record<string, any> | undefined);\n        return;\n      }\n\n      handleWildoError(enrichedWildoError);\n      return;\n    }\n\n    const errorType = ErrorManagementService.classifyError(error);\n    const errorMessage = customMessage || error?.message || 'Unknown error';\n    const errorDefinition = ERROR_DEFINITIONS[errorType];\n\n    const errorContext = {\n      originalError: errorMessage,\n      ...additionalContext\n    };\n\n    const wildoError = sharedErrorBuilder.buildWildoError_Frontend(errorType, {\n      customMessageReference: errorDefinition?.defaultCustomMessageReference,\n      context: errorContext\n    });\n\n    handleWildoError(wildoError);\n  }, [handleWildoError]);\n\n  const value = useMemo<ErrorContextType>(() => ({\n    handleError,\n    handleWildoError,\n    setUserContext,\n  }), [handleError, handleWildoError, setUserContext]);\n\n  return <ErrorContext.Provider value={value}>{children}</ErrorContext.Provider>;\n};\n\n// useError hook is now in separate file: ./useError.ts\n// This separation is required for React Fast Refresh compatibility\n"]}

package/dist/esm/core/errors/ErrorModalContent.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+export interface ErrorModalContentProps {
+    /** The error carried by the `ERROR_MODAL` navigation entry — resolved here, never rendered raw. */
+    wildoError: unknown;
+}
+/**
+ * Body of an `ERROR_MODAL` overlay entry (pushed by `ErrorContext` for a `SHOW_MODAL` action).
+ *
+ * Shows ONE thing: the error's localized message, resolved through `useUserFacingErrorMessage` — with no
+ * surface words, since the modal speaks for no particular screen, so a generic bucket shows its own label.
+ *
+ * It deliberately shows nothing else (#1159). It used to render the error TYPE as a heading (`VALIDATION`),
+ * the raw i18n reference as the body, and the whole request context as JSON (`url`, `method`,
+ * `originalMessage`, Zod issues). None of that is for a person; the context remains in the error-handler
+ * logs, where it belongs.
+ */
+export declare const ErrorModalContent: React.FC<ErrorModalContentProps>;
+//# sourceMappingURL=ErrorModalContent.d.ts.map

package/dist/esm/core/errors/ErrorModalContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorModalContent.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorModalContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAQ9D,CAAC"}

package/dist/esm/core/errors/ErrorModalContent.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useUserFacingErrorMessage } from '../../core/errors/useUserFacingErrorMessage.js';
+/**
+ * Body of an `ERROR_MODAL` overlay entry (pushed by `ErrorContext` for a `SHOW_MODAL` action).
+ *
+ * Shows ONE thing: the error's localized message, resolved through `useUserFacingErrorMessage` — with no
+ * surface words, since the modal speaks for no particular screen, so a generic bucket shows its own label.
+ *
+ * It deliberately shows nothing else (#1159). It used to render the error TYPE as a heading (`VALIDATION`),
+ * the raw i18n reference as the body, and the whole request context as JSON (`url`, `method`,
+ * `originalMessage`, Zod issues). None of that is for a person; the context remains in the error-handler
+ * logs, where it belongs.
+ */
+export const ErrorModalContent = ({ wildoError }) => {
+    const toUserFacingErrorMessage = useUserFacingErrorMessage();
+    return (_jsx("div", { className: "space-y-element", children: _jsx("p", { className: "text-sm text-muted-foreground whitespace-pre-wrap", children: toUserFacingErrorMessage(wildoError) }) }));
+};
+//# sourceMappingURL=ErrorModalContent.js.map

package/dist/esm/core/errors/ErrorModalContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorModalContent.js","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorModalContent.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAOtG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACpF,MAAM,wBAAwB,GAAG,yBAAyB,EAAE,CAAC;IAE7D,OAAO,CACL,cAAK,SAAS,EAAC,iBAAiB,YAC9B,YAAG,SAAS,EAAC,mDAAmD,YAAE,wBAAwB,CAAC,UAAU,CAAC,GAAK,GACvG,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import React from 'react';\nimport { useUserFacingErrorMessage } from '~wildo-frontend-lib/core/errors/useUserFacingErrorMessage';\n\nexport interface ErrorModalContentProps {\n  /** The error carried by the `ERROR_MODAL` navigation entry — resolved here, never rendered raw. */\n  wildoError: unknown;\n}\n\n/**\n * Body of an `ERROR_MODAL` overlay entry (pushed by `ErrorContext` for a `SHOW_MODAL` action).\n *\n * Shows ONE thing: the error's localized message, resolved through `useUserFacingErrorMessage` — with no\n * surface words, since the modal speaks for no particular screen, so a generic bucket shows its own label.\n *\n * It deliberately shows nothing else (#1159). It used to render the error TYPE as a heading (`VALIDATION`),\n * the raw i18n reference as the body, and the whole request context as JSON (`url`, `method`,\n * `originalMessage`, Zod issues). None of that is for a person; the context remains in the error-handler\n * logs, where it belongs.\n */\nexport const ErrorModalContent: React.FC<ErrorModalContentProps> = ({ wildoError }) => {\n  const toUserFacingErrorMessage = useUserFacingErrorMessage();\n\n  return (\n    <div className=\"space-y-element\">\n      <p className=\"text-sm text-muted-foreground whitespace-pre-wrap\">{toUserFacingErrorMessage(wildoError)}</p>\n    </div>\n  );\n};\n"]}

package/dist/esm/core/errors/GlobalErrorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalErrorHandler.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAiEpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,GACR,EAAE,uBAAuB,GAAG,IAAI,CAqMhC;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"GlobalErrorHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAyBpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,GACR,EAAE,uBAAuB,GAAG,IAAI,CAwMhC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/esm/core/errors/GlobalErrorHandler.js

@@ -21,6 +21,7 @@ import { useAuthSession } from '../../core/security/useAuthSession.js';
 import { useNotification } from '../../core/events/useNotification.js';
 import { useI18n } from '../../core/i18n/useI18n.js';
 import { errorManagement } from './error-management.frontend.service.js';
+import { resolveUserFacingErrorMessage } from './user-facing-error-message.frontend.utils.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('GlobalErrorHandler');
 logger.setDebugTypeLogging('GlobalErrorHandler', false);
@@ -40,39 +41,6 @@ function severityToNotificationType(severity) {
             return 'error';
     }
 }
-/**
- * Extract a human, localized display message from an error.
- *
- * `tErrorMessage(ref)` resolves `errors_messages.{ref}.msg`; when no label
- * exists it returns the key path (ending in `.{ref}.msg`), so we guard against
- * that before trusting it. The backend `customMessageReference` (e.g.
- * `"validation"`) is otherwise an i18n KEY, not a sentence — surfacing it raw is
- * the bug this resolution fixes. Falls back to any backend-provided human
- * message, then the error definition description, then a generic string.
- */
-function extractErrorMessage(wildoError, tErrorMessage) {
-    const errorDefinition = ERROR_DEFINITIONS[wildoError.type];
-    const context = wildoError.context;
-    const userGuidance = wildoError.userGuidance;
-    const ref = wildoError.customMessageReference;
-    let localizedRef;
-    if (ref) {
-        const resolved = tErrorMessage(ref);
-        // tErrorMessage returns the key path (`...{ref}.msg`) when unresolved.
-        if (resolved && !resolved.endsWith(`.${ref}.msg`)) {
-            localizedRef = resolved;
-        }
-    }
-    return (userGuidance?.explanation ||
-        userGuidance?.resolution ||
-        localizedRef ||
-        context?.message ||
-        context?.errorMessage ||
-        context?.originalMessage ||
-        ref ||
-        errorDefinition?.description ||
-        'An error occurred');
-}
 /**
  * Global Error Handler Component
  *
@@ -87,19 +55,18 @@ export function GlobalErrorHandler({ onError, }) {
     const { handleWildoError } = useError();
     const { logout, isAuthenticated } = useAuthSession();
     const { notifyError, notifyWarning, notifyInfo } = useNotification();
-    // Resolver for backend error references → localized human messages. No deps
-    // requested: this only borrows the resolver; it resolves against already-loaded
-    // labels and falls back gracefully when an error label is absent.
+    // Resolvers for backend error references and guidance → localized human messages. No deps
+    // requested: `errors_*` sections load eagerly, so this only borrows the resolvers.
     //
     // Held in a ref: `tErrorMessage` (and the whole I18n context value) is NOT
     // memoized, so a new identity is produced on every I18nProvider render. Using it
     // directly as a `useCallback` dep would ripple through `showErrorNotification` →
     // `handleErrorEvent` → the `ERROR_OCCURED` subscription effect, re-subscribing
     // the global handler on every i18n render. The ref keeps those callbacks (and the
-    // subscription) stable while always reading the latest resolver.
-    const { tErrorMessage } = useI18n();
-    const tErrorMessageRef = useRef(tErrorMessage);
-    tErrorMessageRef.current = tErrorMessage;
+    // subscription) stable while always reading the latest resolvers.
+    const { tErrorMessage, tErrorGuidance } = useI18n();
+    const translatorsRef = useRef({ tErrorMessage, tErrorGuidance });
+    translatorsRef.current = { tErrorMessage, tErrorGuidance };
     /**
      * Tear down the AuthSession in response to a `triggerLogout` error.
      *
@@ -124,7 +91,11 @@ export function GlobalErrorHandler({ onError, }) {
     const showErrorNotification = useCallback((wildoError) => {
         const errorDefinition = ERROR_DEFINITIONS[wildoError.type];
         const severity = wildoError.severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;
-        const message = extractErrorMessage(wildoError, tErrorMessageRef.current);
+        // The global toast speaks for no particular surface, so no surface words are passed: a generic
+        // bucket shows its own label. Server `context.message` / `originalMessage` and the raw reference
+        // are never shown — an unresolvable message falls to the default label, or to its key path when
+        // even that is unauthored (see `resolveUserFacingErrorMessage`).
+        const message = resolveUserFacingErrorMessage(wildoError, { translators: translatorsRef.current });
         const notificationType = severityToNotificationType(severity);
         // Use appropriate notification method based on severity
         const notificationData = {

package/dist/esm/core/errors/GlobalErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalErrorHandler.js","sourceRoot":"","sources":["../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global Error Handler\n * \n * Subscribes to ERROR_OCCURED events from the event bus and executes\n * frontend actions based on the error configuration.\n * \n * This component integrates with:\n * - AuthSession: For authentication error handling (logout)\n * - NotificationContext: For toast and notification center display\n * - ErrorContext: For other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n * \n * Must be rendered inside AuthSessionProvider and NotificationProvider.\n */\n\nimport { useEffect, useCallback, useRef } from 'react';\nimport {\n  ErrorActionFrontend,\n  WildoError_Frontend,\n  ERROR_DEFINITIONS,\n  ErrorSeverity,\n} from '@wildo-ai/saas-models';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, FrontendEventErrorOccured } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useError } from './useError';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { errorManagement } from './error-management.frontend.service';\nimport { GlobalErrorHandlerProps } from './errors.frontend.schemas';\nimport { NotificationType } from '~wildo-frontend-lib/core/events/NotificationContext';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('GlobalErrorHandler');\nlogger.setDebugTypeLogging('GlobalErrorHandler', false);\n\n/**\n * Map error severity to notification type\n */\nfunction severityToNotificationType(severity: ErrorSeverity): NotificationType {\n  switch (severity) {\n    case ErrorSeverity.CRITICAL:\n    case ErrorSeverity.HIGH:\n      return 'error';\n    case ErrorSeverity.MEDIUM:\n      return 'warning';\n    case ErrorSeverity.LOW:\n      return 'info';\n    default:\n      return 'error';\n  }\n}\n\n/**\n * Extract a human, localized display message from an error.\n *\n * `tErrorMessage(ref)` resolves `errors_messages.{ref}.msg`; when no label\n * exists it returns the key path (ending in `.{ref}.msg`), so we guard against\n * that before trusting it. The backend `customMessageReference` (e.g.\n * `\"validation\"`) is otherwise an i18n KEY, not a sentence — surfacing it raw is\n * the bug this resolution fixes. Falls back to any backend-provided human\n * message, then the error definition description, then a generic string.\n */\nfunction extractErrorMessage(\n  wildoError: WildoError_Frontend,\n  tErrorMessage: (errorRef: string, key?: string, params?: Record<string, string | number>) => string,\n): string {\n  const errorDefinition = ERROR_DEFINITIONS[wildoError.type];\n  const context = wildoError.context as Record<string, unknown> | undefined;\n  const userGuidance = (wildoError as any).userGuidance as { explanation?: string; resolution?: string } | undefined;\n\n  const ref = wildoError.customMessageReference;\n  let localizedRef: string | undefined;\n  if (ref) {\n    const resolved = tErrorMessage(ref);\n    // tErrorMessage returns the key path (`...{ref}.msg`) when unresolved.\n    if (resolved && !resolved.endsWith(`.${ref}.msg`)) {\n      localizedRef = resolved;\n    }\n  }\n\n  return (\n    userGuidance?.explanation ||\n    userGuidance?.resolution ||\n    localizedRef ||\n    (context?.message as string) ||\n    (context?.errorMessage as string) ||\n    (context?.originalMessage as string) ||\n    (ref as string) ||\n    errorDefinition?.description ||\n    'An error occurred'\n  );\n}\n\n/**\n * Global Error Handler Component\n * \n * Subscribes to ERROR_OCCURED events and executes frontend actions.\n * Integrates with AuthSession for authentication error handling (logout).\n * Delegates notification display to NotificationContext.\n * \n * Should be rendered once, inside the AuthSessionProvider and NotificationProvider.\n */\nexport function GlobalErrorHandler({\n  onError,\n}: GlobalErrorHandlerProps): null {\n  const { on } = useEventBus();\n  const { handleWildoError } = useError();\n  const { logout, isAuthenticated } = useAuthSession();\n  const { notifyError, notifyWarning, notifyInfo } = useNotification();\n  // Resolver for backend error references → localized human messages. No deps\n  // requested: this only borrows the resolver; it resolves against already-loaded\n  // labels and falls back gracefully when an error label is absent.\n  //\n  // Held in a ref: `tErrorMessage` (and the whole I18n context value) is NOT\n  // memoized, so a new identity is produced on every I18nProvider render. Using it\n  // directly as a `useCallback` dep would ripple through `showErrorNotification` →\n  // `handleErrorEvent` → the `ERROR_OCCURED` subscription effect, re-subscribing\n  // the global handler on every i18n render. The ref keeps those callbacks (and the\n  // subscription) stable while always reading the latest resolver.\n  const { tErrorMessage } = useI18n();\n  const tErrorMessageRef = useRef(tErrorMessage);\n  tErrorMessageRef.current = tErrorMessage;\n  \n  /**\n   * Tear down the AuthSession in response to a `triggerLogout` error.\n   *\n   * Only logs out when currently authenticated, to avoid a redundant logout\n   * (e.g. when the token-refresh interceptor already logged the session out).\n   * Fires for ANY error flagged `triggerLogout`, not only AUTHENTICATION-typed\n   * ones — see the gate in handleErrorEvent.\n   */\n  const handleForcedLogout = useCallback(() => {\n    if (isAuthenticated()) {\n      logDebug('triggerLogout requested - logging out via AuthSession');\n      logout();\n    } else {\n      logDebug('triggerLogout requested but not authenticated - skipping logout');\n    }\n  }, [logout, isAuthenticated]);\n  \n  /**\n   * Show error notification via NotificationContext\n   * Uses policy-driven display (toast + optional notification center)\n   */\n  const showErrorNotification = useCallback((wildoError: WildoError_Frontend) => {\n    const errorDefinition = ERROR_DEFINITIONS[wildoError.type];\n    const severity = (wildoError as any).severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;\n    const message = extractErrorMessage(wildoError, tErrorMessageRef.current);\n    const notificationType = severityToNotificationType(severity);\n    \n    // Use appropriate notification method based on severity\n    const notificationData = {\n      errorType: wildoError.type,\n      severity,\n      context: wildoError.context,\n    };\n    \n    switch (notificationType) {\n      case 'error':\n        notifyError(message, { data: notificationData });\n        break;\n      case 'warning':\n        notifyWarning(message, { data: notificationData });\n        break;\n      case 'info':\n        notifyInfo(message, { data: notificationData });\n        break;\n    }\n    \n    logDebug('Error notification displayed via NotificationContext', {\n      errorType: wildoError.type,\n      severity,\n      notificationType,\n      message,\n    });\n  }, [notifyError, notifyWarning, notifyInfo]);\n  \n  /**\n   * Handle ERROR_OCCURED event\n   *\n   * Delegates to ErrorContext.handleWildoError for action execution, but intercepts\n   * any error flagged `triggerLogout` to tear down the session via the AuthSession\n   * `logout()` callback instead of the DISCONNECT window-event fallback.\n   */\n  const handleErrorEvent = useCallback((payload: FrontendEventErrorOccured) => {\n    let wildoError: WildoError_Frontend = payload.error;\n\n    logDebug('Received ERROR_OCCURED event', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n      triggerLogout: wildoError.triggerLogout,\n    });\n    \n    // Check for duplicate errors using deduplication service\n    if (errorManagement.shouldSuppress(wildoError)) {\n      logDebug('Error suppressed (duplicate)', {\n        errorType: wildoError.type,\n        customMessageReference: wildoError.customMessageReference,\n      });\n      return; // Don't process duplicate\n    }\n    \n    // `triggerLogout` is the authoritative \"force a logout\" signal (set by the HTTP\n    // error-behavior matrix, e.g. a 401 invalid session). It drives the AuthSession\n    // logout on its own — deliberately NOT additionally gated on\n    // `type === AUTHENTICATION`. The error's `type` is taken from the backend payload\n    // (`backendErrorType || behavior.errorType` in buildWildoError), so a 401 whose\n    // backend type is not AUTHENTICATION would still carry triggerLogout=true; an extra\n    // type gate would silently swallow that logout. Mirrors `handleHttpError`'s\n    // `shouldLogout`, which is also triggerLogout-only.\n    const shouldTriggerLogout = wildoError.triggerLogout === true;\n\n    // Handle logout via AuthSession if needed (before delegating to ErrorContext)\n    if (shouldTriggerLogout) {\n      logDebug('triggerLogout=true - calling AuthSession logout handler');\n      handleForcedLogout();\n      \n      // Remove DISCONNECT action from frontendActions since we already handled logout\n      const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n      if (frontendActions.includes(ErrorActionFrontend.DISCONNECT)) {\n        wildoError = {\n          ...wildoError,\n          frontendActions: frontendActions.filter(a => a !== ErrorActionFrontend.DISCONNECT),\n        };\n      }\n    }\n    \n    // Log error for analytics/debugging\n    logDebug('Error occurred', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n    });\n    \n    // `suppressUserDisplay` (set when the originating request was `silent`) means\n    // the CALLER owns the user-facing error UX — e.g. a resource form already shows\n    // NOTIFY_RESOURCE_ERROR + inline field errors. In that case strip ALL display\n    // actions (toast + modal) so the global handler never double-surfaces the error,\n    // while still running the side-effect actions below (REDIRECT, DISCONNECT) and\n    // the auth-logout handled earlier. This is what lets a silent resource mutation\n    // log out on 401 without raising a duplicate global toast.\n    //\n    // INVARIANT (load-bearing): we deliberately KEEP REDIRECT/DISCONNECT here, so the\n    // \"silent\" contract relies on HTTP_ERROR_BEHAVIOR_MATRIX never placing those two\n    // actions at a risk level a silent caller can reach (today the matrix only adds\n    // REDIRECT at HIGH/CRITICAL, and silent callers are autosave / RMM-fallback /\n    // guidance / uniqueness — MEDIUM-or-lower). If you add REDIRECT/DISCONNECT at a\n    // lower risk, OR via `setHttpErrorBehaviorOverride`, a silent background op would\n    // navigate/disconnect with NO visible toast to explain it — add those to the\n    // strip list here if that ever changes.\n    const suppressUserDisplay = (wildoError as any).suppressUserDisplay === true;\n    const shouldShowNotification = !suppressUserDisplay && (wildoError as any).showToUser !== false;\n    const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n    const hasNotifyAction = frontendActions.includes(ErrorActionFrontend.NOTIFY)\n      || frontendActions.includes(ErrorActionFrontend.SHOW_TOAST);\n\n    let errorForDelegation = wildoError;\n    if (suppressUserDisplay) {\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY\n            && action !== ErrorActionFrontend.SHOW_TOAST\n            && action !== ErrorActionFrontend.SHOW_MODAL,\n        ),\n      };\n    } else if (shouldShowNotification && hasNotifyAction) {\n      showErrorNotification(wildoError);\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY && action !== ErrorActionFrontend.SHOW_TOAST,\n        ),\n      };\n    }\n    \n    // Call custom error handler if provided\n    if (onError) {\n      onError(wildoError);\n    }\n    \n    // Delegate to ErrorContext for other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n    // Note: We've already handled NOTIFY above via NotificationContext\n    handleWildoError(errorForDelegation);\n  }, [handleWildoError, onError, handleForcedLogout, showErrorNotification]);\n  \n  // Subscribe to ERROR_OCCURED events\n  useEffect(() => {\n    logDebug('Subscribing to ERROR_OCCURED events', {\n      eventName: FrontendEvents.ERROR_OCCURED,\n    });\n    \n    const unsubscribe = on(FrontendEvents.ERROR_OCCURED, handleErrorEvent);\n    \n    return () => {\n      logDebug('Unsubscribing from ERROR_OCCURED events');\n      unsubscribe();\n    };\n  }, [on, handleErrorEvent]);\n  \n  // This component renders nothing - it only subscribes to events\n  return null;\n}\n\nexport default GlobalErrorHandler;\n"]}
+{"version":3,"file":"GlobalErrorHandler.js","sourceRoot":"","sources":["../../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global Error Handler\n * \n * Subscribes to ERROR_OCCURED events from the event bus and executes\n * frontend actions based on the error configuration.\n * \n * This component integrates with:\n * - AuthSession: For authentication error handling (logout)\n * - NotificationContext: For toast and notification center display\n * - ErrorContext: For other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n * \n * Must be rendered inside AuthSessionProvider and NotificationProvider.\n */\n\nimport { useEffect, useCallback, useRef } from 'react';\nimport {\n  ErrorActionFrontend,\n  WildoError_Frontend,\n  ERROR_DEFINITIONS,\n  ErrorSeverity,\n} from '@wildo-ai/saas-models';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, FrontendEventErrorOccured } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useError } from './useError';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { errorManagement } from './error-management.frontend.service';\nimport { GlobalErrorHandlerProps } from './errors.frontend.schemas';\nimport { NotificationType } from '~wildo-frontend-lib/core/events/NotificationContext';\nimport { resolveUserFacingErrorMessage, type ErrorMessageTranslators } from './user-facing-error-message.frontend.utils';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('GlobalErrorHandler');\nlogger.setDebugTypeLogging('GlobalErrorHandler', false);\n\n/**\n * Map error severity to notification type\n */\nfunction severityToNotificationType(severity: ErrorSeverity): NotificationType {\n  switch (severity) {\n    case ErrorSeverity.CRITICAL:\n    case ErrorSeverity.HIGH:\n      return 'error';\n    case ErrorSeverity.MEDIUM:\n      return 'warning';\n    case ErrorSeverity.LOW:\n      return 'info';\n    default:\n      return 'error';\n  }\n}\n\n/**\n * Global Error Handler Component\n * \n * Subscribes to ERROR_OCCURED events and executes frontend actions.\n * Integrates with AuthSession for authentication error handling (logout).\n * Delegates notification display to NotificationContext.\n * \n * Should be rendered once, inside the AuthSessionProvider and NotificationProvider.\n */\nexport function GlobalErrorHandler({\n  onError,\n}: GlobalErrorHandlerProps): null {\n  const { on } = useEventBus();\n  const { handleWildoError } = useError();\n  const { logout, isAuthenticated } = useAuthSession();\n  const { notifyError, notifyWarning, notifyInfo } = useNotification();\n  // Resolvers for backend error references and guidance → localized human messages. No deps\n  // requested: `errors_*` sections load eagerly, so this only borrows the resolvers.\n  //\n  // Held in a ref: `tErrorMessage` (and the whole I18n context value) is NOT\n  // memoized, so a new identity is produced on every I18nProvider render. Using it\n  // directly as a `useCallback` dep would ripple through `showErrorNotification` →\n  // `handleErrorEvent` → the `ERROR_OCCURED` subscription effect, re-subscribing\n  // the global handler on every i18n render. The ref keeps those callbacks (and the\n  // subscription) stable while always reading the latest resolvers.\n  const { tErrorMessage, tErrorGuidance } = useI18n();\n  const translatorsRef = useRef<ErrorMessageTranslators>({ tErrorMessage, tErrorGuidance });\n  translatorsRef.current = { tErrorMessage, tErrorGuidance };\n  \n  /**\n   * Tear down the AuthSession in response to a `triggerLogout` error.\n   *\n   * Only logs out when currently authenticated, to avoid a redundant logout\n   * (e.g. when the token-refresh interceptor already logged the session out).\n   * Fires for ANY error flagged `triggerLogout`, not only AUTHENTICATION-typed\n   * ones — see the gate in handleErrorEvent.\n   */\n  const handleForcedLogout = useCallback(() => {\n    if (isAuthenticated()) {\n      logDebug('triggerLogout requested - logging out via AuthSession');\n      logout();\n    } else {\n      logDebug('triggerLogout requested but not authenticated - skipping logout');\n    }\n  }, [logout, isAuthenticated]);\n  \n  /**\n   * Show error notification via NotificationContext\n   * Uses policy-driven display (toast + optional notification center)\n   */\n  const showErrorNotification = useCallback((wildoError: WildoError_Frontend) => {\n    const errorDefinition = ERROR_DEFINITIONS[wildoError.type];\n    const severity = (wildoError as any).severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;\n    // The global toast speaks for no particular surface, so no surface words are passed: a generic\n    // bucket shows its own label. Server `context.message` / `originalMessage` and the raw reference\n    // are never shown — an unresolvable message falls to the default label, or to its key path when\n    // even that is unauthored (see `resolveUserFacingErrorMessage`).\n    const message = resolveUserFacingErrorMessage(wildoError, { translators: translatorsRef.current });\n    const notificationType = severityToNotificationType(severity);\n    \n    // Use appropriate notification method based on severity\n    const notificationData = {\n      errorType: wildoError.type,\n      severity,\n      context: wildoError.context,\n    };\n    \n    switch (notificationType) {\n      case 'error':\n        notifyError(message, { data: notificationData });\n        break;\n      case 'warning':\n        notifyWarning(message, { data: notificationData });\n        break;\n      case 'info':\n        notifyInfo(message, { data: notificationData });\n        break;\n    }\n    \n    logDebug('Error notification displayed via NotificationContext', {\n      errorType: wildoError.type,\n      severity,\n      notificationType,\n      message,\n    });\n  }, [notifyError, notifyWarning, notifyInfo]);\n  \n  /**\n   * Handle ERROR_OCCURED event\n   *\n   * Delegates to ErrorContext.handleWildoError for action execution, but intercepts\n   * any error flagged `triggerLogout` to tear down the session via the AuthSession\n   * `logout()` callback instead of the DISCONNECT window-event fallback.\n   */\n  const handleErrorEvent = useCallback((payload: FrontendEventErrorOccured) => {\n    let wildoError: WildoError_Frontend = payload.error;\n\n    logDebug('Received ERROR_OCCURED event', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n      triggerLogout: wildoError.triggerLogout,\n    });\n    \n    // Check for duplicate errors using deduplication service\n    if (errorManagement.shouldSuppress(wildoError)) {\n      logDebug('Error suppressed (duplicate)', {\n        errorType: wildoError.type,\n        customMessageReference: wildoError.customMessageReference,\n      });\n      return; // Don't process duplicate\n    }\n    \n    // `triggerLogout` is the authoritative \"force a logout\" signal (set by the HTTP\n    // error-behavior matrix, e.g. a 401 invalid session). It drives the AuthSession\n    // logout on its own — deliberately NOT additionally gated on\n    // `type === AUTHENTICATION`. The error's `type` is taken from the backend payload\n    // (`backendErrorType || behavior.errorType` in buildWildoError), so a 401 whose\n    // backend type is not AUTHENTICATION would still carry triggerLogout=true; an extra\n    // type gate would silently swallow that logout. Mirrors `handleHttpError`'s\n    // `shouldLogout`, which is also triggerLogout-only.\n    const shouldTriggerLogout = wildoError.triggerLogout === true;\n\n    // Handle logout via AuthSession if needed (before delegating to ErrorContext)\n    if (shouldTriggerLogout) {\n      logDebug('triggerLogout=true - calling AuthSession logout handler');\n      handleForcedLogout();\n      \n      // Remove DISCONNECT action from frontendActions since we already handled logout\n      const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n      if (frontendActions.includes(ErrorActionFrontend.DISCONNECT)) {\n        wildoError = {\n          ...wildoError,\n          frontendActions: frontendActions.filter(a => a !== ErrorActionFrontend.DISCONNECT),\n        };\n      }\n    }\n    \n    // Log error for analytics/debugging\n    logDebug('Error occurred', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n    });\n    \n    // `suppressUserDisplay` (set when the originating request was `silent`) means\n    // the CALLER owns the user-facing error UX — e.g. a resource form already shows\n    // NOTIFY_RESOURCE_ERROR + inline field errors. In that case strip ALL display\n    // actions (toast + modal) so the global handler never double-surfaces the error,\n    // while still running the side-effect actions below (REDIRECT, DISCONNECT) and\n    // the auth-logout handled earlier. This is what lets a silent resource mutation\n    // log out on 401 without raising a duplicate global toast.\n    //\n    // INVARIANT (load-bearing): we deliberately KEEP REDIRECT/DISCONNECT here, so the\n    // \"silent\" contract relies on HTTP_ERROR_BEHAVIOR_MATRIX never placing those two\n    // actions at a risk level a silent caller can reach (today the matrix only adds\n    // REDIRECT at HIGH/CRITICAL, and silent callers are autosave / RMM-fallback /\n    // guidance / uniqueness — MEDIUM-or-lower). If you add REDIRECT/DISCONNECT at a\n    // lower risk, OR via `setHttpErrorBehaviorOverride`, a silent background op would\n    // navigate/disconnect with NO visible toast to explain it — add those to the\n    // strip list here if that ever changes.\n    const suppressUserDisplay = (wildoError as any).suppressUserDisplay === true;\n    const shouldShowNotification = !suppressUserDisplay && (wildoError as any).showToUser !== false;\n    const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n    const hasNotifyAction = frontendActions.includes(ErrorActionFrontend.NOTIFY)\n      || frontendActions.includes(ErrorActionFrontend.SHOW_TOAST);\n\n    let errorForDelegation = wildoError;\n    if (suppressUserDisplay) {\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY\n            && action !== ErrorActionFrontend.SHOW_TOAST\n            && action !== ErrorActionFrontend.SHOW_MODAL,\n        ),\n      };\n    } else if (shouldShowNotification && hasNotifyAction) {\n      showErrorNotification(wildoError);\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY && action !== ErrorActionFrontend.SHOW_TOAST,\n        ),\n      };\n    }\n    \n    // Call custom error handler if provided\n    if (onError) {\n      onError(wildoError);\n    }\n    \n    // Delegate to ErrorContext for other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n    // Note: We've already handled NOTIFY above via NotificationContext\n    handleWildoError(errorForDelegation);\n  }, [handleWildoError, onError, handleForcedLogout, showErrorNotification]);\n  \n  // Subscribe to ERROR_OCCURED events\n  useEffect(() => {\n    logDebug('Subscribing to ERROR_OCCURED events', {\n      eventName: FrontendEvents.ERROR_OCCURED,\n    });\n    \n    const unsubscribe = on(FrontendEvents.ERROR_OCCURED, handleErrorEvent);\n    \n    return () => {\n      logDebug('Unsubscribing from ERROR_OCCURED events');\n      unsubscribe();\n    };\n  }, [on, handleErrorEvent]);\n  \n  // This component renders nothing - it only subscribes to events\n  return null;\n}\n\nexport default GlobalErrorHandler;\n"]}

package/dist/esm/core/errors/RouterErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/RouterErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAkDnD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAyWvC,CAAC"}
+{"version":3,"file":"RouterErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/RouterErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAkDnD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAyWvC,CAAC"}