gracefulerrors 0.1.0

package/dist/internal.cjs

@@ -0,0 +1,169 @@
+'use strict';
+
+// src/state-manager.ts
+function createStateManager(config) {
+  const maxConcurrent = config.maxConcurrent ?? 3;
+  const maxQueue = config.maxQueue;
+  const dedupeWindow = config.dedupeWindow ?? 300;
+  const { onDropped } = config;
+  const activeSlots = /* @__PURE__ */ new Map();
+  const queue = [];
+  const dedupeMap = /* @__PURE__ */ new Map();
+  const ttlTimers = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  function notify(event) {
+    for (const listener of listeners) {
+      try {
+        listener(event);
+      } catch (err) {
+        if (process.env["NODE_ENV"] !== "production") {
+          console.error("[gracefulerrors] StateManager listener threw:", err);
+        }
+      }
+    }
+  }
+  function promoteFromQueue() {
+    if (queue.length > 0 && activeSlots.size < maxConcurrent) {
+      const next = queue.shift();
+      activateSlot(next, next._pendingAction);
+    }
+  }
+  function activateSlot(slot, action) {
+    slot.state = "ACTIVE";
+    activeSlots.set(slot.fingerprint, slot);
+    const ttl = slot.ttl;
+    if (ttl != null && ttl > 0) {
+      const timer = setTimeout(() => {
+        if (activeSlots.has(slot.fingerprint)) {
+          activeSlots.delete(slot.fingerprint);
+          ttlTimers.delete(slot.fingerprint);
+          onDropped?.(slot.error, "ttl_expired");
+          promoteFromQueue();
+        }
+      }, ttl);
+      ttlTimers.set(slot.fingerprint, timer);
+    }
+    notify({ type: "ERROR_ADDED", error: slot.error, action });
+  }
+  function canHandle(fingerprint) {
+    const lastSeen = dedupeMap.get(fingerprint);
+    if (lastSeen === void 0) return true;
+    return Date.now() - lastSeen >= dedupeWindow;
+  }
+  function enqueue(slot) {
+    if (!canHandle(slot.fingerprint)) {
+      onDropped?.(slot.error, "dedupe");
+      return "rejected";
+    }
+    dedupeMap.set(slot.fingerprint, Date.now());
+    if (activeSlots.size < maxConcurrent) {
+      activateSlot(slot, slot._pendingAction);
+      return "active";
+    }
+    if (maxQueue !== void 0 && queue.length >= maxQueue) {
+      onDropped?.(slot.error, "queue_overflow");
+      return "rejected";
+    }
+    slot.state = "QUEUED";
+    queue.push(slot);
+    return "queued";
+  }
+  function release(code) {
+    let targetFingerprint;
+    for (const [fingerprint, slot] of activeSlots) {
+      if (slot.error.code === code) {
+        targetFingerprint = fingerprint;
+        break;
+      }
+    }
+    if (targetFingerprint !== void 0) {
+      const slot = activeSlots.get(targetFingerprint);
+      slot.state = "EXPIRED";
+      activeSlots.delete(targetFingerprint);
+      const timer = ttlTimers.get(targetFingerprint);
+      if (timer !== void 0) {
+        clearTimeout(timer);
+        ttlTimers.delete(targetFingerprint);
+      }
+      notify({ type: "ERROR_CLEARED", code });
+      promoteFromQueue();
+      return;
+    }
+    const queueIdx = queue.findIndex((slot) => slot.error.code === code);
+    if (queueIdx !== -1) {
+      const slot = queue[queueIdx];
+      slot.state = "EXPIRED";
+      queue.splice(queueIdx, 1);
+      notify({ type: "ERROR_CLEARED", code });
+    }
+  }
+  function getActiveSlots() {
+    return Array.from(activeSlots.values());
+  }
+  function getQueueLength() {
+    return queue.length;
+  }
+  function clearAll() {
+    for (const timer of ttlTimers.values()) {
+      clearTimeout(timer);
+    }
+    ttlTimers.clear();
+    activeSlots.clear();
+    queue.length = 0;
+    notify({ type: "ALL_CLEARED" });
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  }
+  return { canHandle, enqueue, release, getActiveSlots, getQueueLength, clearAll, subscribe };
+}
+
+// src/registry.ts
+function lookupEntry(registry, code) {
+  return registry[code];
+}
+
+// src/router.ts
+function createUIRouter() {
+  function route(error, registry, config) {
+    const entry = lookupEntry(registry, error.code);
+    if (entry == null && config.requireRegistry) {
+      throw new Error(`[gracefulerrors] Registry entry required for code: ${error.code}`);
+    }
+    const routingContext = config.routingContext ?? {
+      activeCount: 0,
+      queueLength: 0
+    };
+    let strategyResult;
+    if (config.routingStrategy) {
+      try {
+        strategyResult = config.routingStrategy(error, entry, routingContext);
+      } catch (err) {
+        if (process.env["NODE_ENV"] !== "production") {
+          console.error("[gracefulerrors] routingStrategy threw:", err);
+        }
+        strategyResult = null;
+      }
+    }
+    if (strategyResult != null) {
+      return strategyResult;
+    }
+    if (entry != null) {
+      return entry.ui;
+    }
+    const allowFallback = config.allowFallback !== false;
+    if (allowFallback && config.fallback) {
+      return config.fallback.ui;
+    }
+    return "toast";
+  }
+  return { route };
+}
+
+exports.createStateManager = createStateManager;
+exports.createUIRouter = createUIRouter;
+//# sourceMappingURL=internal.cjs.map
+//# sourceMappingURL=internal.cjs.map

package/dist/internal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state-manager.ts","../src/registry.ts","../src/router.ts"],"names":[],"mappings":"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","file":"internal.cjs","sourcesContent":["import type { AppError, ErrorSlot, ErrorStateManager, StateListener, UIAction } from './types'\n\nexport interface StateManagerConfig<TCode extends string> {\n  maxConcurrent?: number   // default: 3\n  maxQueue?: number        // default: unbounded\n  dedupeWindow?: number    // ms, default: 300\n  onDropped?: (error: AppError<TCode>, reason: 'dedupe' | 'ttl_expired' | 'queue_overflow') => void\n}\n\nexport function createStateManager<TCode extends string>(\n  config: StateManagerConfig<TCode>\n): ErrorStateManager<TCode> {\n  const maxConcurrent = config.maxConcurrent ?? 3\n  const maxQueue = config.maxQueue\n  const dedupeWindow = config.dedupeWindow ?? 300\n  const { onDropped } = config\n\n  type InternalSlot = ErrorSlot<TCode> & { ttl?: number; _pendingAction?: UIAction }\n\n  const activeSlots = new Map<string, InternalSlot>()\n  const queue: InternalSlot[] = []\n  const dedupeMap = new Map<string, number>()\n  const ttlTimers = new Map<string, ReturnType<typeof setTimeout>>()\n  const listeners = new Set<StateListener<TCode>>()\n\n  function notify(event: Parameters<StateListener<TCode>>[0]): void {\n    for (const listener of listeners) {\n      try {\n        listener(event)\n      } catch (err) {\n        if (process.env['NODE_ENV'] !== 'production') {\n          console.error('[gracefulerrors] StateManager listener threw:', err)\n        }\n      }\n    }\n  }\n\n  function promoteFromQueue(): void {\n    if (queue.length > 0 && activeSlots.size < maxConcurrent) {\n      const next = queue.shift()!\n      activateSlot(next, next._pendingAction as UIAction)\n    }\n  }\n\n  function activateSlot(slot: InternalSlot, action: UIAction): void {\n    slot.state = 'ACTIVE'\n    activeSlots.set(slot.fingerprint, slot)\n\n    // Start TTL timer if configured\n    const ttl = slot.ttl\n    if (ttl != null && ttl > 0) {\n      const timer = setTimeout(() => {\n        if (activeSlots.has(slot.fingerprint)) {\n          activeSlots.delete(slot.fingerprint)\n          ttlTimers.delete(slot.fingerprint)\n          onDropped?.(slot.error, 'ttl_expired')\n          promoteFromQueue()\n        }\n      }, ttl)\n      ttlTimers.set(slot.fingerprint, timer)\n    }\n\n    notify({ type: 'ERROR_ADDED', error: slot.error, action })\n  }\n\n  function canHandle(fingerprint: string): boolean {\n    const lastSeen = dedupeMap.get(fingerprint)\n    if (lastSeen === undefined) return true\n    return Date.now() - lastSeen >= dedupeWindow\n  }\n\n  function enqueue(slot: InternalSlot): 'active' | 'queued' | 'rejected' {\n    if (!canHandle(slot.fingerprint)) {\n      onDropped?.(slot.error, 'dedupe')\n      return 'rejected'\n    }\n\n    dedupeMap.set(slot.fingerprint, Date.now())\n\n    if (activeSlots.size < maxConcurrent) {\n      activateSlot(slot, slot._pendingAction as UIAction)\n      return 'active'\n    }\n\n    if (maxQueue !== undefined && queue.length >= maxQueue) {\n      onDropped?.(slot.error, 'queue_overflow')\n      return 'rejected'\n    }\n\n    slot.state = 'QUEUED'\n    queue.push(slot)\n    return 'queued'\n  }\n\n  function release(code: TCode): void {\n    // Check active slots first\n    let targetFingerprint: string | undefined\n\n    for (const [fingerprint, slot] of activeSlots) {\n      if (slot.error.code === code) {\n        targetFingerprint = fingerprint\n        break\n      }\n    }\n\n    if (targetFingerprint !== undefined) {\n      const slot = activeSlots.get(targetFingerprint)!\n      slot.state = 'EXPIRED'\n      activeSlots.delete(targetFingerprint)\n\n      const timer = ttlTimers.get(targetFingerprint)\n      if (timer !== undefined) {\n        clearTimeout(timer)\n        ttlTimers.delete(targetFingerprint)\n      }\n\n      notify({ type: 'ERROR_CLEARED', code })\n      promoteFromQueue()\n      return\n    }\n\n    // Check queue — spec: QUEUED | clear() → EXPIRED | remove from queue\n    const queueIdx = queue.findIndex((slot) => slot.error.code === code)\n    if (queueIdx !== -1) {\n      const slot = queue[queueIdx]!\n      slot.state = 'EXPIRED'\n      queue.splice(queueIdx, 1)\n      notify({ type: 'ERROR_CLEARED', code })\n    }\n  }\n\n  function getActiveSlots(): ErrorSlot<TCode>[] {\n    return Array.from(activeSlots.values())\n  }\n\n  function getQueueLength(): number {\n    return queue.length\n  }\n\n  function clearAll(): void {\n    for (const timer of ttlTimers.values()) {\n      clearTimeout(timer)\n    }\n    ttlTimers.clear()\n    activeSlots.clear()\n    queue.length = 0\n    notify({ type: 'ALL_CLEARED' })\n  }\n\n  function subscribe(listener: StateListener<TCode>): () => void {\n    listeners.add(listener)\n    return () => { listeners.delete(listener) }\n  }\n\n  return { canHandle, enqueue, release, getActiveSlots, getQueueLength, clearAll, subscribe }\n}\n\nexport type { ErrorStateManager, StateListener }\n","import type { AppError, ErrorRegistry, ErrorRegistryEntry, ErrorRegistryEntryFull } from './types'\n\nexport function lookupEntry<TCode extends string>(\n  registry: ErrorRegistry<TCode>,\n  code: TCode | string\n): ErrorRegistryEntryFull<TCode> | undefined {\n  return (registry as Record<string, ErrorRegistryEntryFull<TCode> | undefined>)[code]\n}\n\nexport function resolveMessage<TCode extends string>(\n  entry: ErrorRegistryEntry<TCode>,\n  error: AppError<TCode>\n): string | undefined {\n  if (entry.message === undefined) return undefined\n  if (typeof entry.message === 'function') return entry.message(error)\n  return entry.message\n}\n\nexport function mergeRegistries<TBase extends string, TExtended extends string>(\n  base: ErrorRegistry<TBase>,\n  override: ErrorRegistry<TExtended>\n): ErrorRegistry<TBase | TExtended> {\n  return { ...base, ...override } as ErrorRegistry<TBase | TExtended>\n}\n\nexport type { ErrorRegistry, ErrorRegistryEntry, ErrorRegistryEntryFull }\n","import type { AppError, ErrorEngineConfig, ErrorRegistry, UIAction, UIRouter } from './types'\nimport { lookupEntry } from './registry'\n\nexport function createUIRouter<TCode extends string, TField extends string = string>(): UIRouter<TCode, TField> {\n  function route(\n    error: AppError<TCode, TField>,\n    registry: ErrorRegistry<TCode>,\n    config: Pick<ErrorEngineConfig<TCode, TField>, 'fallback' | 'requireRegistry' | 'allowFallback' | 'routingStrategy'> & {\n      routingContext?: { activeCount: number; queueLength: number }\n    }\n  ): UIAction | null {\n    const entry = lookupEntry(registry, error.code)\n\n    if (entry == null && config.requireRegistry) {\n      throw new Error(`[gracefulerrors] Registry entry required for code: ${error.code}`)\n    }\n\n    const routingContext = (config as { routingContext?: { activeCount: number; queueLength: number } }).routingContext ?? {\n      activeCount: 0,\n      queueLength: 0,\n    }\n\n    let strategyResult: UIAction | null | undefined\n    if (config.routingStrategy) {\n      try {\n        strategyResult = config.routingStrategy(error, entry, routingContext)\n      } catch (err) {\n        if (process.env['NODE_ENV'] !== 'production') {\n          console.error('[gracefulerrors] routingStrategy threw:', err)\n        }\n        strategyResult = null\n      }\n    }\n\n    // routingStrategy returns non-null → use it (overrides registry)\n    if (strategyResult != null) {\n      return strategyResult\n    }\n\n    // Registry entry exists → use its ui\n    if (entry != null) {\n      return entry.ui\n    }\n\n    // No match — apply fallback logic\n    // allowFallback defaults to true\n    const allowFallback = config.allowFallback !== false\n\n    if (allowFallback && config.fallback) {\n      return config.fallback.ui\n    }\n\n    return 'toast'\n  }\n\n  return { route }\n}\n\nexport type { UIRouter }\n"]}

package/dist/internal.d.cts

@@ -0,0 +1,14 @@
+import { A as AppError, i as ErrorStateManager, j as UIRouter } from './types-CsPmpcbL.cjs';
+export { k as ErrorSlot, l as ErrorState, S as StateListener } from './types-CsPmpcbL.cjs';
+
+interface StateManagerConfig<TCode extends string> {
+    maxConcurrent?: number;
+    maxQueue?: number;
+    dedupeWindow?: number;
+    onDropped?: (error: AppError<TCode>, reason: 'dedupe' | 'ttl_expired' | 'queue_overflow') => void;
+}
+declare function createStateManager<TCode extends string>(config: StateManagerConfig<TCode>): ErrorStateManager<TCode>;
+
+declare function createUIRouter<TCode extends string, TField extends string = string>(): UIRouter<TCode, TField>;
+
+export { ErrorStateManager, UIRouter, createStateManager, createUIRouter };

package/dist/internal.d.ts

@@ -0,0 +1,14 @@
+import { A as AppError, i as ErrorStateManager, j as UIRouter } from './types-CsPmpcbL.js';
+export { k as ErrorSlot, l as ErrorState, S as StateListener } from './types-CsPmpcbL.js';
+
+interface StateManagerConfig<TCode extends string> {
+    maxConcurrent?: number;
+    maxQueue?: number;
+    dedupeWindow?: number;
+    onDropped?: (error: AppError<TCode>, reason: 'dedupe' | 'ttl_expired' | 'queue_overflow') => void;
+}
+declare function createStateManager<TCode extends string>(config: StateManagerConfig<TCode>): ErrorStateManager<TCode>;
+
+declare function createUIRouter<TCode extends string, TField extends string = string>(): UIRouter<TCode, TField>;
+
+export { ErrorStateManager, UIRouter, createStateManager, createUIRouter };

package/dist/internal.js

@@ -0,0 +1,166 @@
+// src/state-manager.ts
+function createStateManager(config) {
+  const maxConcurrent = config.maxConcurrent ?? 3;
+  const maxQueue = config.maxQueue;
+  const dedupeWindow = config.dedupeWindow ?? 300;
+  const { onDropped } = config;
+  const activeSlots = /* @__PURE__ */ new Map();
+  const queue = [];
+  const dedupeMap = /* @__PURE__ */ new Map();
+  const ttlTimers = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  function notify(event) {
+    for (const listener of listeners) {
+      try {
+        listener(event);
+      } catch (err) {
+        if (process.env["NODE_ENV"] !== "production") {
+          console.error("[gracefulerrors] StateManager listener threw:", err);
+        }
+      }
+    }
+  }
+  function promoteFromQueue() {
+    if (queue.length > 0 && activeSlots.size < maxConcurrent) {
+      const next = queue.shift();
+      activateSlot(next, next._pendingAction);
+    }
+  }
+  function activateSlot(slot, action) {
+    slot.state = "ACTIVE";
+    activeSlots.set(slot.fingerprint, slot);
+    const ttl = slot.ttl;
+    if (ttl != null && ttl > 0) {
+      const timer = setTimeout(() => {
+        if (activeSlots.has(slot.fingerprint)) {
+          activeSlots.delete(slot.fingerprint);
+          ttlTimers.delete(slot.fingerprint);
+          onDropped?.(slot.error, "ttl_expired");
+          promoteFromQueue();
+        }
+      }, ttl);
+      ttlTimers.set(slot.fingerprint, timer);
+    }
+    notify({ type: "ERROR_ADDED", error: slot.error, action });
+  }
+  function canHandle(fingerprint) {
+    const lastSeen = dedupeMap.get(fingerprint);
+    if (lastSeen === void 0) return true;
+    return Date.now() - lastSeen >= dedupeWindow;
+  }
+  function enqueue(slot) {
+    if (!canHandle(slot.fingerprint)) {
+      onDropped?.(slot.error, "dedupe");
+      return "rejected";
+    }
+    dedupeMap.set(slot.fingerprint, Date.now());
+    if (activeSlots.size < maxConcurrent) {
+      activateSlot(slot, slot._pendingAction);
+      return "active";
+    }
+    if (maxQueue !== void 0 && queue.length >= maxQueue) {
+      onDropped?.(slot.error, "queue_overflow");
+      return "rejected";
+    }
+    slot.state = "QUEUED";
+    queue.push(slot);
+    return "queued";
+  }
+  function release(code) {
+    let targetFingerprint;
+    for (const [fingerprint, slot] of activeSlots) {
+      if (slot.error.code === code) {
+        targetFingerprint = fingerprint;
+        break;
+      }
+    }
+    if (targetFingerprint !== void 0) {
+      const slot = activeSlots.get(targetFingerprint);
+      slot.state = "EXPIRED";
+      activeSlots.delete(targetFingerprint);
+      const timer = ttlTimers.get(targetFingerprint);
+      if (timer !== void 0) {
+        clearTimeout(timer);
+        ttlTimers.delete(targetFingerprint);
+      }
+      notify({ type: "ERROR_CLEARED", code });
+      promoteFromQueue();
+      return;
+    }
+    const queueIdx = queue.findIndex((slot) => slot.error.code === code);
+    if (queueIdx !== -1) {
+      const slot = queue[queueIdx];
+      slot.state = "EXPIRED";
+      queue.splice(queueIdx, 1);
+      notify({ type: "ERROR_CLEARED", code });
+    }
+  }
+  function getActiveSlots() {
+    return Array.from(activeSlots.values());
+  }
+  function getQueueLength() {
+    return queue.length;
+  }
+  function clearAll() {
+    for (const timer of ttlTimers.values()) {
+      clearTimeout(timer);
+    }
+    ttlTimers.clear();
+    activeSlots.clear();
+    queue.length = 0;
+    notify({ type: "ALL_CLEARED" });
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  }
+  return { canHandle, enqueue, release, getActiveSlots, getQueueLength, clearAll, subscribe };
+}
+
+// src/registry.ts
+function lookupEntry(registry, code) {
+  return registry[code];
+}
+
+// src/router.ts
+function createUIRouter() {
+  function route(error, registry, config) {
+    const entry = lookupEntry(registry, error.code);
+    if (entry == null && config.requireRegistry) {
+      throw new Error(`[gracefulerrors] Registry entry required for code: ${error.code}`);
+    }
+    const routingContext = config.routingContext ?? {
+      activeCount: 0,
+      queueLength: 0
+    };
+    let strategyResult;
+    if (config.routingStrategy) {
+      try {
+        strategyResult = config.routingStrategy(error, entry, routingContext);
+      } catch (err) {
+        if (process.env["NODE_ENV"] !== "production") {
+          console.error("[gracefulerrors] routingStrategy threw:", err);
+        }
+        strategyResult = null;
+      }
+    }
+    if (strategyResult != null) {
+      return strategyResult;
+    }
+    if (entry != null) {
+      return entry.ui;
+    }
+    const allowFallback = config.allowFallback !== false;
+    if (allowFallback && config.fallback) {
+      return config.fallback.ui;
+    }
+    return "toast";
+  }
+  return { route };
+}
+
+export { createStateManager, createUIRouter };
+//# sourceMappingURL=internal.js.map
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state-manager.ts","../src/registry.ts","../src/router.ts"],"names":[],"mappings":"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","file":"internal.js","sourcesContent":["import type { AppError, ErrorSlot, ErrorStateManager, StateListener, UIAction } from './types'\n\nexport interface StateManagerConfig<TCode extends string> {\n  maxConcurrent?: number   // default: 3\n  maxQueue?: number        // default: unbounded\n  dedupeWindow?: number    // ms, default: 300\n  onDropped?: (error: AppError<TCode>, reason: 'dedupe' | 'ttl_expired' | 'queue_overflow') => void\n}\n\nexport function createStateManager<TCode extends string>(\n  config: StateManagerConfig<TCode>\n): ErrorStateManager<TCode> {\n  const maxConcurrent = config.maxConcurrent ?? 3\n  const maxQueue = config.maxQueue\n  const dedupeWindow = config.dedupeWindow ?? 300\n  const { onDropped } = config\n\n  type InternalSlot = ErrorSlot<TCode> & { ttl?: number; _pendingAction?: UIAction }\n\n  const activeSlots = new Map<string, InternalSlot>()\n  const queue: InternalSlot[] = []\n  const dedupeMap = new Map<string, number>()\n  const ttlTimers = new Map<string, ReturnType<typeof setTimeout>>()\n  const listeners = new Set<StateListener<TCode>>()\n\n  function notify(event: Parameters<StateListener<TCode>>[0]): void {\n    for (const listener of listeners) {\n      try {\n        listener(event)\n      } catch (err) {\n        if (process.env['NODE_ENV'] !== 'production') {\n          console.error('[gracefulerrors] StateManager listener threw:', err)\n        }\n      }\n    }\n  }\n\n  function promoteFromQueue(): void {\n    if (queue.length > 0 && activeSlots.size < maxConcurrent) {\n      const next = queue.shift()!\n      activateSlot(next, next._pendingAction as UIAction)\n    }\n  }\n\n  function activateSlot(slot: InternalSlot, action: UIAction): void {\n    slot.state = 'ACTIVE'\n    activeSlots.set(slot.fingerprint, slot)\n\n    // Start TTL timer if configured\n    const ttl = slot.ttl\n    if (ttl != null && ttl > 0) {\n      const timer = setTimeout(() => {\n        if (activeSlots.has(slot.fingerprint)) {\n          activeSlots.delete(slot.fingerprint)\n          ttlTimers.delete(slot.fingerprint)\n          onDropped?.(slot.error, 'ttl_expired')\n          promoteFromQueue()\n        }\n      }, ttl)\n      ttlTimers.set(slot.fingerprint, timer)\n    }\n\n    notify({ type: 'ERROR_ADDED', error: slot.error, action })\n  }\n\n  function canHandle(fingerprint: string): boolean {\n    const lastSeen = dedupeMap.get(fingerprint)\n    if (lastSeen === undefined) return true\n    return Date.now() - lastSeen >= dedupeWindow\n  }\n\n  function enqueue(slot: InternalSlot): 'active' | 'queued' | 'rejected' {\n    if (!canHandle(slot.fingerprint)) {\n      onDropped?.(slot.error, 'dedupe')\n      return 'rejected'\n    }\n\n    dedupeMap.set(slot.fingerprint, Date.now())\n\n    if (activeSlots.size < maxConcurrent) {\n      activateSlot(slot, slot._pendingAction as UIAction)\n      return 'active'\n    }\n\n    if (maxQueue !== undefined && queue.length >= maxQueue) {\n      onDropped?.(slot.error, 'queue_overflow')\n      return 'rejected'\n    }\n\n    slot.state = 'QUEUED'\n    queue.push(slot)\n    return 'queued'\n  }\n\n  function release(code: TCode): void {\n    // Check active slots first\n    let targetFingerprint: string | undefined\n\n    for (const [fingerprint, slot] of activeSlots) {\n      if (slot.error.code === code) {\n        targetFingerprint = fingerprint\n        break\n      }\n    }\n\n    if (targetFingerprint !== undefined) {\n      const slot = activeSlots.get(targetFingerprint)!\n      slot.state = 'EXPIRED'\n      activeSlots.delete(targetFingerprint)\n\n      const timer = ttlTimers.get(targetFingerprint)\n      if (timer !== undefined) {\n        clearTimeout(timer)\n        ttlTimers.delete(targetFingerprint)\n      }\n\n      notify({ type: 'ERROR_CLEARED', code })\n      promoteFromQueue()\n      return\n    }\n\n    // Check queue — spec: QUEUED | clear() → EXPIRED | remove from queue\n    const queueIdx = queue.findIndex((slot) => slot.error.code === code)\n    if (queueIdx !== -1) {\n      const slot = queue[queueIdx]!\n      slot.state = 'EXPIRED'\n      queue.splice(queueIdx, 1)\n      notify({ type: 'ERROR_CLEARED', code })\n    }\n  }\n\n  function getActiveSlots(): ErrorSlot<TCode>[] {\n    return Array.from(activeSlots.values())\n  }\n\n  function getQueueLength(): number {\n    return queue.length\n  }\n\n  function clearAll(): void {\n    for (const timer of ttlTimers.values()) {\n      clearTimeout(timer)\n    }\n    ttlTimers.clear()\n    activeSlots.clear()\n    queue.length = 0\n    notify({ type: 'ALL_CLEARED' })\n  }\n\n  function subscribe(listener: StateListener<TCode>): () => void {\n    listeners.add(listener)\n    return () => { listeners.delete(listener) }\n  }\n\n  return { canHandle, enqueue, release, getActiveSlots, getQueueLength, clearAll, subscribe }\n}\n\nexport type { ErrorStateManager, StateListener }\n","import type { AppError, ErrorRegistry, ErrorRegistryEntry, ErrorRegistryEntryFull } from './types'\n\nexport function lookupEntry<TCode extends string>(\n  registry: ErrorRegistry<TCode>,\n  code: TCode | string\n): ErrorRegistryEntryFull<TCode> | undefined {\n  return (registry as Record<string, ErrorRegistryEntryFull<TCode> | undefined>)[code]\n}\n\nexport function resolveMessage<TCode extends string>(\n  entry: ErrorRegistryEntry<TCode>,\n  error: AppError<TCode>\n): string | undefined {\n  if (entry.message === undefined) return undefined\n  if (typeof entry.message === 'function') return entry.message(error)\n  return entry.message\n}\n\nexport function mergeRegistries<TBase extends string, TExtended extends string>(\n  base: ErrorRegistry<TBase>,\n  override: ErrorRegistry<TExtended>\n): ErrorRegistry<TBase | TExtended> {\n  return { ...base, ...override } as ErrorRegistry<TBase | TExtended>\n}\n\nexport type { ErrorRegistry, ErrorRegistryEntry, ErrorRegistryEntryFull }\n","import type { AppError, ErrorEngineConfig, ErrorRegistry, UIAction, UIRouter } from './types'\nimport { lookupEntry } from './registry'\n\nexport function createUIRouter<TCode extends string, TField extends string = string>(): UIRouter<TCode, TField> {\n  function route(\n    error: AppError<TCode, TField>,\n    registry: ErrorRegistry<TCode>,\n    config: Pick<ErrorEngineConfig<TCode, TField>, 'fallback' | 'requireRegistry' | 'allowFallback' | 'routingStrategy'> & {\n      routingContext?: { activeCount: number; queueLength: number }\n    }\n  ): UIAction | null {\n    const entry = lookupEntry(registry, error.code)\n\n    if (entry == null && config.requireRegistry) {\n      throw new Error(`[gracefulerrors] Registry entry required for code: ${error.code}`)\n    }\n\n    const routingContext = (config as { routingContext?: { activeCount: number; queueLength: number } }).routingContext ?? {\n      activeCount: 0,\n      queueLength: 0,\n    }\n\n    let strategyResult: UIAction | null | undefined\n    if (config.routingStrategy) {\n      try {\n        strategyResult = config.routingStrategy(error, entry, routingContext)\n      } catch (err) {\n        if (process.env['NODE_ENV'] !== 'production') {\n          console.error('[gracefulerrors] routingStrategy threw:', err)\n        }\n        strategyResult = null\n      }\n    }\n\n    // routingStrategy returns non-null → use it (overrides registry)\n    if (strategyResult != null) {\n      return strategyResult\n    }\n\n    // Registry entry exists → use its ui\n    if (entry != null) {\n      return entry.ui\n    }\n\n    // No match — apply fallback logic\n    // allowFallback defaults to true\n    const allowFallback = config.allowFallback !== false\n\n    if (allowFallback && config.fallback) {\n      return config.fallback.ui\n    }\n\n    return 'toast'\n  }\n\n  return { route }\n}\n\nexport type { UIRouter }\n"]}

package/dist/react.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+var ErrorEngineContext = React.createContext(null);
+function ErrorEngineProvider({
+  engine,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsx(ErrorEngineContext.Provider, { value: { engine }, children });
+}
+function useErrorEngine() {
+  const ctx = React.useContext(ErrorEngineContext);
+  if (!ctx) {
+    if (process.env["NODE_ENV"] === "development") {
+      console.error("[gracefulerrors] useErrorEngine called outside of ErrorEngineProvider.");
+    }
+    return null;
+  }
+  return ctx.engine;
+}
+function useFieldError(field) {
+  const engine = useErrorEngine();
+  const [error, setError] = React.useState(null);
+  React.useEffect(() => {
+    if (!engine) return;
+    const unsubscribe = engine.subscribe((event) => {
+      if (event.type === "ERROR_ADDED" && event.action === "inline") {
+        if (event.error.context?.field === field) {
+          setError(event.error);
+        }
+      } else if (event.type === "ERROR_CLEARED") {
+        setError((prev) => prev?.code === event.code ? null : prev);
+      } else if (event.type === "ALL_CLEARED") {
+        setError(null);
+      }
+    });
+    return unsubscribe;
+  }, [engine, field]);
+  return { error };
+}
+var ErrorBoundaryWithEngine = class extends React__default.default.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    this.context?.engine?.handle(error);
+  }
+  render() {
+    if (this.state.hasError) return this.props.fallback;
+    return this.props.children;
+  }
+};
+ErrorBoundaryWithEngine.contextType = ErrorEngineContext;
+
+exports.ErrorBoundaryWithEngine = ErrorBoundaryWithEngine;
+exports.ErrorEngineContext = ErrorEngineContext;
+exports.ErrorEngineProvider = ErrorEngineProvider;
+exports.useErrorEngine = useErrorEngine;
+exports.useFieldError = useFieldError;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"names":["createContext","jsx","useContext","useState","useEffect","React"],"mappings":";;;;;;;;;AAKO,IAAM,kBAAA,GAAqBA,oBAA8C,IAAI;AAE7E,SAAS,mBAAA,CAAmD;AAAA,EACjE,MAAA;AAAA,EACA;AACF,CAAA,EAGgB;AACd,EAAA,uBACEC,cAAA,CAAC,mBAAmB,QAAA,EAAnB,EAA4B,OAAO,EAAE,MAAA,IACnC,QAAA,EACH,CAAA;AAEJ;AAEO,SAAS,cAAA,GAA2E;AACzF,EAAA,MAAM,GAAA,GAAMC,iBAAW,kBAAkB,CAAA;AACzC,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA,KAAM,aAAA,EAAe;AAC7C,MAAA,OAAA,CAAQ,MAAM,wEAAwE,CAAA;AAAA,IACxF;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA,CAAI,MAAA;AACb;AAEO,SAAS,cACd,KAAA,EAC4C;AAC5C,EAAA,MAAM,SAAS,cAAA,EAAe;AAC9B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIC,eAA0C,IAAI,CAAA;AAExE,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,CAAC,KAAA,KAAwC;AAC5E,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,aAAA,IAAiB,KAAA,CAAM,WAAW,QAAA,EAAU;AAC7D,QAAA,IAAI,KAAA,CAAM,KAAA,CAAM,OAAA,EAAS,KAAA,KAAU,KAAA,EAAO;AACxC,UAAA,QAAA,CAAS,MAAM,KAAiC,CAAA;AAAA,QAClD;AAAA,MACF,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,eAAA,EAAiB;AACzC,QAAA,QAAA,CAAS,UAAQ,IAAA,EAAM,IAAA,KAAS,KAAA,CAAM,IAAA,GAAO,OAAO,IAAI,CAAA;AAAA,MAC1D,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,aAAA,EAAe;AACvC,QAAA,QAAA,CAAS,IAAI,CAAA;AAAA,MACf;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAA,EAAQ,KAAK,CAAC,CAAA;AAElB,EAAA,OAAO,EAAE,KAAA,EAAM;AACjB;AAEO,IAAM,uBAAA,GAAN,cAAsCC,sBAAA,CAAM,SAAA,CAGjD;AAAA,EAHK,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AAOL,IAAA,IAAA,CAAA,KAAA,GAAQ,EAAE,UAAU,KAAA,EAAM;AAAA,EAAA;AAAA,EAE1B,OAAO,wBAAA,GAA2B;AAChC,IAAA,OAAO,EAAE,UAAU,IAAA,EAAK;AAAA,EAC1B;AAAA,EAEA,kBAAkB,KAAA,EAAc;AAC9B,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA,EAAQ,MAAA,CAAO,KAAK,CAAA;AAAA,EACpC;AAAA,EAEA,MAAA,GAAS;AACP,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,QAAA,EAAU,OAAO,KAAK,KAAA,CAAM,QAAA;AAC3C,IAAA,OAAO,KAAK,KAAA,CAAM,QAAA;AAAA,EACpB;AACF;AArBa,uBAAA,CAIJ,WAAA,GAAc,kBAAA","file":"react.cjs","sourcesContent":["'use client'\n\nimport React, { createContext, useContext, useEffect, useState } from 'react'\nimport type { ErrorEngine, AppError, StateListener } from './types'\n\nexport const ErrorEngineContext = createContext<{ engine: ErrorEngine } | null>(null)\n\nexport function ErrorEngineProvider<TCode extends string = string>({\n  engine,\n  children,\n}: {\n  engine: ErrorEngine<TCode>\n  children: React.ReactNode\n}): JSX.Element {\n  return (\n    <ErrorEngineContext.Provider value={{ engine }}>\n      {children}\n    </ErrorEngineContext.Provider>\n  )\n}\n\nexport function useErrorEngine<TCode extends string = string>(): ErrorEngine<TCode> | null {\n  const ctx = useContext(ErrorEngineContext)\n  if (!ctx) {\n    if (process.env['NODE_ENV'] === 'development') {\n      console.error('[gracefulerrors] useErrorEngine called outside of ErrorEngineProvider.')\n    }\n    return null\n  }\n  return ctx.engine as ErrorEngine<TCode>\n}\n\nexport function useFieldError<TField extends string = string>(\n  field: TField\n): { error: AppError<string, TField> | null } {\n  const engine = useErrorEngine()\n  const [error, setError] = useState<AppError<string, TField> | null>(null)\n\n  useEffect(() => {\n    if (!engine) return\n\n    const unsubscribe = engine.subscribe((event: Parameters<StateListener>[0]) => {\n      if (event.type === 'ERROR_ADDED' && event.action === 'inline') {\n        if (event.error.context?.field === field) {\n          setError(event.error as AppError<string, TField>)\n        }\n      } else if (event.type === 'ERROR_CLEARED') {\n        setError(prev => prev?.code === event.code ? null : prev)\n      } else if (event.type === 'ALL_CLEARED') {\n        setError(null)\n      }\n    })\n\n    return unsubscribe\n  }, [engine, field])\n\n  return { error }\n}\n\nexport class ErrorBoundaryWithEngine extends React.Component<\n  { children: React.ReactNode; fallback: React.ReactNode },\n  { hasError: boolean }\n> {\n  static contextType = ErrorEngineContext\n  declare context: React.ContextType<typeof ErrorEngineContext>\n\n  state = { hasError: false }\n\n  static getDerivedStateFromError() {\n    return { hasError: true }\n  }\n\n  componentDidCatch(error: Error) {\n    this.context?.engine?.handle(error)\n  }\n\n  render() {\n    if (this.state.hasError) return this.props.fallback\n    return this.props.children\n  }\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { a as ErrorEngine, A as AppError } from './types-CsPmpcbL.cjs';
+
+declare const ErrorEngineContext: React.Context<{
+    engine: ErrorEngine;
+} | null>;
+declare function ErrorEngineProvider<TCode extends string = string>({ engine, children, }: {
+    engine: ErrorEngine<TCode>;
+    children: React.ReactNode;
+}): JSX.Element;
+declare function useErrorEngine<TCode extends string = string>(): ErrorEngine<TCode> | null;
+declare function useFieldError<TField extends string = string>(field: TField): {
+    error: AppError<string, TField> | null;
+};
+declare class ErrorBoundaryWithEngine extends React.Component<{
+    children: React.ReactNode;
+    fallback: React.ReactNode;
+}, {
+    hasError: boolean;
+}> {
+    static contextType: React.Context<{
+        engine: ErrorEngine;
+    } | null>;
+    context: React.ContextType<typeof ErrorEngineContext>;
+    state: {
+        hasError: boolean;
+    };
+    static getDerivedStateFromError(): {
+        hasError: boolean;
+    };
+    componentDidCatch(error: Error): void;
+    render(): React.ReactNode;
+}
+
+export { ErrorBoundaryWithEngine, ErrorEngineContext, ErrorEngineProvider, useErrorEngine, useFieldError };

package/dist/react.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { a as ErrorEngine, A as AppError } from './types-CsPmpcbL.js';
+
+declare const ErrorEngineContext: React.Context<{
+    engine: ErrorEngine;
+} | null>;
+declare function ErrorEngineProvider<TCode extends string = string>({ engine, children, }: {
+    engine: ErrorEngine<TCode>;
+    children: React.ReactNode;
+}): JSX.Element;
+declare function useErrorEngine<TCode extends string = string>(): ErrorEngine<TCode> | null;
+declare function useFieldError<TField extends string = string>(field: TField): {
+    error: AppError<string, TField> | null;
+};
+declare class ErrorBoundaryWithEngine extends React.Component<{
+    children: React.ReactNode;
+    fallback: React.ReactNode;
+}, {
+    hasError: boolean;
+}> {
+    static contextType: React.Context<{
+        engine: ErrorEngine;
+    } | null>;
+    context: React.ContextType<typeof ErrorEngineContext>;
+    state: {
+        hasError: boolean;
+    };
+    static getDerivedStateFromError(): {
+        hasError: boolean;
+    };
+    componentDidCatch(error: Error): void;
+    render(): React.ReactNode;
+}
+
+export { ErrorBoundaryWithEngine, ErrorEngineContext, ErrorEngineProvider, useErrorEngine, useFieldError };

package/dist/react.js

@@ -0,0 +1,61 @@
+import React, { createContext, useContext, useState, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var ErrorEngineContext = createContext(null);
+function ErrorEngineProvider({
+  engine,
+  children
+}) {
+  return /* @__PURE__ */ jsx(ErrorEngineContext.Provider, { value: { engine }, children });
+}
+function useErrorEngine() {
+  const ctx = useContext(ErrorEngineContext);
+  if (!ctx) {
+    if (process.env["NODE_ENV"] === "development") {
+      console.error("[gracefulerrors] useErrorEngine called outside of ErrorEngineProvider.");
+    }
+    return null;
+  }
+  return ctx.engine;
+}
+function useFieldError(field) {
+  const engine = useErrorEngine();
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (!engine) return;
+    const unsubscribe = engine.subscribe((event) => {
+      if (event.type === "ERROR_ADDED" && event.action === "inline") {
+        if (event.error.context?.field === field) {
+          setError(event.error);
+        }
+      } else if (event.type === "ERROR_CLEARED") {
+        setError((prev) => prev?.code === event.code ? null : prev);
+      } else if (event.type === "ALL_CLEARED") {
+        setError(null);
+      }
+    });
+    return unsubscribe;
+  }, [engine, field]);
+  return { error };
+}
+var ErrorBoundaryWithEngine = class extends React.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    this.context?.engine?.handle(error);
+  }
+  render() {
+    if (this.state.hasError) return this.props.fallback;
+    return this.props.children;
+  }
+};
+ErrorBoundaryWithEngine.contextType = ErrorEngineContext;
+
+export { ErrorBoundaryWithEngine, ErrorEngineContext, ErrorEngineProvider, useErrorEngine, useFieldError };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"names":[],"mappings":";;;AAKO,IAAM,kBAAA,GAAqB,cAA8C,IAAI;AAE7E,SAAS,mBAAA,CAAmD;AAAA,EACjE,MAAA;AAAA,EACA;AACF,CAAA,EAGgB;AACd,EAAA,uBACE,GAAA,CAAC,mBAAmB,QAAA,EAAnB,EAA4B,OAAO,EAAE,MAAA,IACnC,QAAA,EACH,CAAA;AAEJ;AAEO,SAAS,cAAA,GAA2E;AACzF,EAAA,MAAM,GAAA,GAAM,WAAW,kBAAkB,CAAA;AACzC,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA,KAAM,aAAA,EAAe;AAC7C,MAAA,OAAA,CAAQ,MAAM,wEAAwE,CAAA;AAAA,IACxF;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA,CAAI,MAAA;AACb;AAEO,SAAS,cACd,KAAA,EAC4C;AAC5C,EAAA,MAAM,SAAS,cAAA,EAAe;AAC9B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAA0C,IAAI,CAAA;AAExE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,CAAC,KAAA,KAAwC;AAC5E,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,aAAA,IAAiB,KAAA,CAAM,WAAW,QAAA,EAAU;AAC7D,QAAA,IAAI,KAAA,CAAM,KAAA,CAAM,OAAA,EAAS,KAAA,KAAU,KAAA,EAAO;AACxC,UAAA,QAAA,CAAS,MAAM,KAAiC,CAAA;AAAA,QAClD;AAAA,MACF,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,eAAA,EAAiB;AACzC,QAAA,QAAA,CAAS,UAAQ,IAAA,EAAM,IAAA,KAAS,KAAA,CAAM,IAAA,GAAO,OAAO,IAAI,CAAA;AAAA,MAC1D,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,aAAA,EAAe;AACvC,QAAA,QAAA,CAAS,IAAI,CAAA;AAAA,MACf;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAA,EAAQ,KAAK,CAAC,CAAA;AAElB,EAAA,OAAO,EAAE,KAAA,EAAM;AACjB;AAEO,IAAM,uBAAA,GAAN,cAAsC,KAAA,CAAM,SAAA,CAGjD;AAAA,EAHK,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AAOL,IAAA,IAAA,CAAA,KAAA,GAAQ,EAAE,UAAU,KAAA,EAAM;AAAA,EAAA;AAAA,EAE1B,OAAO,wBAAA,GAA2B;AAChC,IAAA,OAAO,EAAE,UAAU,IAAA,EAAK;AAAA,EAC1B;AAAA,EAEA,kBAAkB,KAAA,EAAc;AAC9B,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA,EAAQ,MAAA,CAAO,KAAK,CAAA;AAAA,EACpC;AAAA,EAEA,MAAA,GAAS;AACP,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,QAAA,EAAU,OAAO,KAAK,KAAA,CAAM,QAAA;AAC3C,IAAA,OAAO,KAAK,KAAA,CAAM,QAAA;AAAA,EACpB;AACF;AArBa,uBAAA,CAIJ,WAAA,GAAc,kBAAA","file":"react.js","sourcesContent":["'use client'\n\nimport React, { createContext, useContext, useEffect, useState } from 'react'\nimport type { ErrorEngine, AppError, StateListener } from './types'\n\nexport const ErrorEngineContext = createContext<{ engine: ErrorEngine } | null>(null)\n\nexport function ErrorEngineProvider<TCode extends string = string>({\n  engine,\n  children,\n}: {\n  engine: ErrorEngine<TCode>\n  children: React.ReactNode\n}): JSX.Element {\n  return (\n    <ErrorEngineContext.Provider value={{ engine }}>\n      {children}\n    </ErrorEngineContext.Provider>\n  )\n}\n\nexport function useErrorEngine<TCode extends string = string>(): ErrorEngine<TCode> | null {\n  const ctx = useContext(ErrorEngineContext)\n  if (!ctx) {\n    if (process.env['NODE_ENV'] === 'development') {\n      console.error('[gracefulerrors] useErrorEngine called outside of ErrorEngineProvider.')\n    }\n    return null\n  }\n  return ctx.engine as ErrorEngine<TCode>\n}\n\nexport function useFieldError<TField extends string = string>(\n  field: TField\n): { error: AppError<string, TField> | null } {\n  const engine = useErrorEngine()\n  const [error, setError] = useState<AppError<string, TField> | null>(null)\n\n  useEffect(() => {\n    if (!engine) return\n\n    const unsubscribe = engine.subscribe((event: Parameters<StateListener>[0]) => {\n      if (event.type === 'ERROR_ADDED' && event.action === 'inline') {\n        if (event.error.context?.field === field) {\n          setError(event.error as AppError<string, TField>)\n        }\n      } else if (event.type === 'ERROR_CLEARED') {\n        setError(prev => prev?.code === event.code ? null : prev)\n      } else if (event.type === 'ALL_CLEARED') {\n        setError(null)\n      }\n    })\n\n    return unsubscribe\n  }, [engine, field])\n\n  return { error }\n}\n\nexport class ErrorBoundaryWithEngine extends React.Component<\n  { children: React.ReactNode; fallback: React.ReactNode },\n  { hasError: boolean }\n> {\n  static contextType = ErrorEngineContext\n  declare context: React.ContextType<typeof ErrorEngineContext>\n\n  state = { hasError: false }\n\n  static getDerivedStateFromError() {\n    return { hasError: true }\n  }\n\n  componentDidCatch(error: Error) {\n    this.context?.engine?.handle(error)\n  }\n\n  render() {\n    if (this.state.hasError) return this.props.fallback\n    return this.props.children\n  }\n}\n"]}