@noego/wood 0.5.0 → 0.6.0

package/dist/frontend/work_registry.cjs

@@ -34,7 +34,8 @@ function describe(work) {
   return `[${work.kind}] ${work.label} (owner: ${work.owner})`;
 }
 class WorkRegistry {
-  constructor() {
+  constructor(timeoutMs = 5e3) {
+    this.timeoutMs = timeoutMs;
     this.nextId = 1;
     /** Total registrations ever — the fixed-point signal for draining. */
     this.registrations = 0;
@@ -43,6 +44,7 @@ class WorkRegistry {
     /** How many failures a completed drain has already reported. */
     this.reportedFailures = 0;
     this.drainChain = Promise.resolve();
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new Error("Wood work timeoutMs must be finite and non-negative");
   }
   /**
    * Register finite owned work. Returns a promise with the work's own
@@ -57,7 +59,12 @@ class WorkRegistry {
       owner: options.owner ?? "application"
     };
     this.registrations += 1;
-    const promise = typeof work === "function" ? work() : work;
+    let promise;
+    try {
+      promise = Promise.resolve(typeof work === "function" ? work() : work);
+    } catch (error) {
+      promise = Promise.reject(error);
+    }
     const observed = promise.then(
       () => void 0,
       (error) => {
@@ -88,14 +95,30 @@ class WorkRegistry {
    * (repeating owned work), listing pending and repeating labels.
    */
   drain(flushHooks = []) {
-    const run = this.drainChain.then(() => this.drainOnce(flushHooks));
+    const run = this.drainChain.then(async () => {
+      let timer;
+      const cancelled = { value: false };
+      try {
+        await Promise.race([
+          this.drainOnce(flushHooks, cancelled),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => {
+              cancelled.value = true;
+              reject(new FrontendWorkError("settle timed out; pending owners:\n  " + this.pending().map(describe).join("\n  ")));
+            }, this.timeoutMs);
+          })
+        ]);
+      } finally {
+        if (timer !== void 0) clearTimeout(timer);
+      }
+    });
     this.drainChain = run.then(
       () => void 0,
       () => void 0
     );
     return run;
   }
-  async drainOnce(flushHooks) {
+  async drainOnce(flushHooks, cancelled) {
     const seenPerLabel = /* @__PURE__ */ new Map();
     for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {
       const registrationsBefore = this.registrations;
@@ -105,10 +128,12 @@ class WorkRegistry {
       }
       await Promise.all(snapshot.map((entry) => entry.observed));
       for (const hook of flushHooks) {
+        if (cancelled.value) return;
         await hook();
       }
       await Promise.resolve();
       await Promise.resolve();
+      if (cancelled.value) return;
       const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;
       if (stable) {
         this.throwNewFailures();

package/dist/frontend/work_registry.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/frontend/work_registry.ts"],"sourcesContent":["/**\n * Owned-work registry for the frontend application slice (18A D-FAS-01).\n *\n * `act()` and `settle()` drain framework-owned finite work registered here\n * through production seams (transport invokes, event deliveries, navigation\n * transitions, tracked lifecycle tasks). The registry never patches global\n * async primitives and never guesses at event-loop emptiness: work exists\n * only because an owner registered it, and a drain is a fixed point —\n * repeated passes until one complete pass creates no new owned work.\n *\n * Floating promises and bare timers are explicitly outside the guarantee;\n * they are product lifecycle bugs, not framework blind spots to paper over.\n */\n\nexport type WorkKind =\n  | 'invoke'\n  | 'event-delivery'\n  | 'navigation'\n  | 'initialize'\n  | 'tracked'\n  | (string & {});\n\nexport interface WorkOptions {\n  /** Human-readable diagnostic label, e.g. `invoke messages.send`. */\n  label: string;\n  kind?: WorkKind;\n  /** Owning lifecycle identity, e.g. `page main.chat_dom` or `application`. */\n  owner?: string;\n}\n\nexport interface WorkDescriptor {\n  readonly id: number;\n  readonly label: string;\n  readonly kind: WorkKind;\n  readonly owner: string;\n}\n\nexport interface WorkFailure extends WorkDescriptor {\n  readonly error: unknown;\n}\n\n/** Safety bound on drain passes — a diagnostic limit, not the readiness mechanism. */\nconst MAX_DRAIN_PASSES = 100;\n\nexport class FrontendWorkError extends Error {\n  constructor(message: string, readonly failures: readonly WorkFailure[] = []) {\n    super(message);\n    this.name = 'FrontendWorkError';\n  }\n}\n\nfunction describe(work: WorkDescriptor): string {\n  return `[${work.kind}] ${work.label} (owner: ${work.owner})`;\n}\n\nexport class WorkRegistry {\n  private nextId = 1;\n  /** Total registrations ever — the fixed-point signal for draining. */\n  private registrations = 0;\n  private readonly inFlight = new Map<number, { descriptor: WorkDescriptor; observed: Promise<void> }>();\n  private readonly failures: WorkFailure[] = [];\n  /** How many failures a completed drain has already reported. */\n  private reportedFailures = 0;\n  private drainChain: Promise<void> = Promise.resolve();\n\n  /**\n   * Register finite owned work. Returns a promise with the work's own\n   * settlement semantics — callers may await it directly; the registry\n   * additionally observes completion (success or failure) for draining.\n   */\n  track<T>(work: Promise<T> | (() => Promise<T>), options: WorkOptions): Promise<T> {\n    const descriptor: WorkDescriptor = {\n      id: this.nextId++,\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: options.owner ?? 'application',\n    };\n\n    this.registrations += 1;\n    const promise = typeof work === 'function' ? work() : work;\n\n    // Observe settlement without altering the caller's promise semantics.\n    const observed = promise.then(\n      () => undefined,\n      (error) => {\n        this.failures.push({ ...descriptor, error });\n      },\n    ).finally(() => {\n      this.inFlight.delete(descriptor.id);\n    });\n\n    this.inFlight.set(descriptor.id, { descriptor, observed });\n    return promise;\n  }\n\n  /** Descriptors of currently incomplete owned work. */\n  pending(): WorkDescriptor[] {\n    return [...this.inFlight.values()].map((entry) => entry.descriptor);\n  }\n\n  /** Every owned-work failure observed so far (accumulates across drains). */\n  errors(): readonly WorkFailure[] {\n    return [...this.failures];\n  }\n\n  /**\n   * Fixed-point drain: await all pending owned work, run the adapter flush\n   * hooks, repeat until one full pass observes no pending work and causes\n   * no new registrations. Concurrent drains queue — each caller gets its\n   * own complete pass over whatever work exists when its turn arrives.\n   *\n   * Rejects with `FrontendWorkError` naming the owners when owned work\n   * failed since the previous drain, or when the pass bound is exceeded\n   * (repeating owned work), listing pending and repeating labels.\n   */\n  drain(flushHooks: ReadonlyArray<() => void | Promise<void>> = []): Promise<void> {\n    const run = this.drainChain.then(() => this.drainOnce(flushHooks));\n    // Keep the chain alive regardless of this drain's outcome.\n    this.drainChain = run.then(\n      () => undefined,\n      () => undefined,\n    );\n    return run;\n  }\n\n  private async drainOnce(flushHooks: ReadonlyArray<() => void | Promise<void>>): Promise<void> {\n    const seenPerLabel = new Map<string, number>();\n\n    for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {\n      const registrationsBefore = this.registrations;\n      const snapshot = [...this.inFlight.values()];\n\n      for (const { descriptor } of snapshot) {\n        seenPerLabel.set(descriptor.label, (seenPerLabel.get(descriptor.label) ?? 0) + 1);\n      }\n\n      // Observed promises never reject (failures are recorded by track());\n      // awaiting them cannot abort the pass mid-way.\n      await Promise.all(snapshot.map((entry) => entry.observed));\n\n      for (const hook of flushHooks) {\n        await hook();\n      }\n\n      // Give completion continuations a microtask to register follow-on\n      // owned work before the fixed point is tested.\n      await Promise.resolve();\n      await Promise.resolve();\n\n      const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;\n      if (stable) {\n        this.throwNewFailures();\n        return;\n      }\n    }\n\n    const pendingLines = this.pending().map(describe);\n    const repeating = [...seenPerLabel.entries()]\n      .filter(([, count]) => count > 3)\n      .map(([label, count]) => `${label} (seen in ${count} passes)`);\n\n    throw new FrontendWorkError(\n      `settle did not converge within ${MAX_DRAIN_PASSES} drain passes.\\n` +\n      (pendingLines.length ? `Still pending:\\n  ${pendingLines.join('\\n  ')}\\n` : '') +\n      (repeating.length ? `Repeating owned work:\\n  ${repeating.join('\\n  ')}\\n` : '') +\n      'Owned work keeps creating more owned work — this names the owners; it is not a timeout.',\n      this.takeNewFailures(),\n    );\n  }\n\n  private takeNewFailures(): WorkFailure[] {\n    const fresh = this.failures.slice(this.reportedFailures);\n    this.reportedFailures = this.failures.length;\n    return fresh;\n  }\n\n  private throwNewFailures(): void {\n    const fresh = this.takeNewFailures();\n    if (!fresh.length) return;\n    const lines = fresh.map(\n      (failure) =>\n        `${describe(failure)}: ${failure.error instanceof Error ? failure.error.message : String(failure.error)}`,\n    );\n    throw new FrontendWorkError(\n      `owned frontend work failed:\\n  ${lines.join('\\n  ')}`,\n      fresh,\n    );\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/frontend/work_registry.ts"],"sourcesContent":["/**\n * Owned-work registry for the frontend application slice (18A D-FAS-01).\n *\n * `act()` and `settle()` drain framework-owned finite work registered here\n * through production seams (transport invokes, event deliveries, navigation\n * transitions, tracked lifecycle tasks). The registry never patches global\n * async primitives and never guesses at event-loop emptiness: work exists\n * only because an owner registered it, and a drain is a fixed point —\n * repeated passes until one complete pass creates no new owned work.\n *\n * Floating promises and bare timers are explicitly outside the guarantee;\n * they are product lifecycle bugs, not framework blind spots to paper over.\n */\n\nexport type WorkKind =\n  | 'invoke'\n  | 'event-delivery'\n  | 'navigation'\n  | 'initialize'\n  | 'tracked'\n  | (string & {});\n\nexport interface WorkOptions {\n  /** Human-readable diagnostic label, e.g. `invoke messages.send`. */\n  label: string;\n  kind?: WorkKind;\n  /** Owning lifecycle identity, e.g. `page main.chat_dom` or `application`. */\n  owner?: string;\n}\n\nexport interface WorkDescriptor {\n  readonly id: number;\n  readonly label: string;\n  readonly kind: WorkKind;\n  readonly owner: string;\n}\n\nexport interface WorkFailure extends WorkDescriptor {\n  readonly error: unknown;\n}\n\n/** Safety bound on drain passes — a diagnostic limit, not the readiness mechanism. */\nconst MAX_DRAIN_PASSES = 100;\n\nexport class FrontendWorkError extends Error {\n  constructor(message: string, readonly failures: readonly WorkFailure[] = []) {\n    super(message);\n    this.name = 'FrontendWorkError';\n  }\n}\n\nfunction describe(work: WorkDescriptor): string {\n  return `[${work.kind}] ${work.label} (owner: ${work.owner})`;\n}\n\nexport class WorkRegistry {\n  constructor(private readonly timeoutMs = 5000) {\n    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new Error('Wood work timeoutMs must be finite and non-negative');\n  }\n  private nextId = 1;\n  /** Total registrations ever — the fixed-point signal for draining. */\n  private registrations = 0;\n  private readonly inFlight = new Map<number, { descriptor: WorkDescriptor; observed: Promise<void> }>();\n  private readonly failures: WorkFailure[] = [];\n  /** How many failures a completed drain has already reported. */\n  private reportedFailures = 0;\n  private drainChain: Promise<void> = Promise.resolve();\n\n  /**\n   * Register finite owned work. Returns a promise with the work's own\n   * settlement semantics — callers may await it directly; the registry\n   * additionally observes completion (success or failure) for draining.\n   */\n  track<T>(work: Promise<T> | (() => Promise<T>), options: WorkOptions): Promise<T> {\n    const descriptor: WorkDescriptor = {\n      id: this.nextId++,\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: options.owner ?? 'application',\n    };\n\n    this.registrations += 1;\n    let promise: Promise<T>;\n    try { promise = Promise.resolve(typeof work === 'function' ? work() : work); }\n    catch (error) { promise = Promise.reject(error); }\n\n    // Observe settlement without altering the caller's promise semantics.\n    const observed = promise.then(\n      () => undefined,\n      (error) => {\n        this.failures.push({ ...descriptor, error });\n      },\n    ).finally(() => {\n      this.inFlight.delete(descriptor.id);\n    });\n\n    this.inFlight.set(descriptor.id, { descriptor, observed });\n    return promise;\n  }\n\n  /** Descriptors of currently incomplete owned work. */\n  pending(): WorkDescriptor[] {\n    return [...this.inFlight.values()].map((entry) => entry.descriptor);\n  }\n\n  /** Every owned-work failure observed so far (accumulates across drains). */\n  errors(): readonly WorkFailure[] {\n    return [...this.failures];\n  }\n\n  /**\n   * Fixed-point drain: await all pending owned work, run the adapter flush\n   * hooks, repeat until one full pass observes no pending work and causes\n   * no new registrations. Concurrent drains queue — each caller gets its\n   * own complete pass over whatever work exists when its turn arrives.\n   *\n   * Rejects with `FrontendWorkError` naming the owners when owned work\n   * failed since the previous drain, or when the pass bound is exceeded\n   * (repeating owned work), listing pending and repeating labels.\n   */\n  drain(flushHooks: ReadonlyArray<() => void | Promise<void>> = []): Promise<void> {\n    const run = this.drainChain.then(async () => {\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const cancelled = { value: false };\n      try {\n        await Promise.race([\n          this.drainOnce(flushHooks, cancelled),\n          new Promise<never>((_, reject) => { timer = setTimeout(() => {\n            cancelled.value = true;\n            reject(new FrontendWorkError('settle timed out; pending owners:\\n  ' + this.pending().map(describe).join('\\n  ')));\n          }, this.timeoutMs); }),\n        ]);\n      } finally { if (timer !== undefined) clearTimeout(timer); }\n    });\n    // Keep the chain alive regardless of this drain's outcome.\n    this.drainChain = run.then(\n      () => undefined,\n      () => undefined,\n    );\n    return run;\n  }\n\n  private async drainOnce(flushHooks: ReadonlyArray<() => void | Promise<void>>, cancelled: { value: boolean }): Promise<void> {\n    const seenPerLabel = new Map<string, number>();\n\n    for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {\n      const registrationsBefore = this.registrations;\n      const snapshot = [...this.inFlight.values()];\n\n      for (const { descriptor } of snapshot) {\n        seenPerLabel.set(descriptor.label, (seenPerLabel.get(descriptor.label) ?? 0) + 1);\n      }\n\n      // Observed promises never reject (failures are recorded by track());\n      // awaiting them cannot abort the pass mid-way.\n      await Promise.all(snapshot.map((entry) => entry.observed));\n\n      for (const hook of flushHooks) {\n        if (cancelled.value) return;\n        await hook();\n      }\n\n      // Give completion continuations a microtask to register follow-on\n      // owned work before the fixed point is tested.\n      await Promise.resolve();\n      await Promise.resolve();\n\n      if (cancelled.value) return;\n      const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;\n      if (stable) {\n        this.throwNewFailures();\n        return;\n      }\n    }\n\n    const pendingLines = this.pending().map(describe);\n    const repeating = [...seenPerLabel.entries()]\n      .filter(([, count]) => count > 3)\n      .map(([label, count]) => `${label} (seen in ${count} passes)`);\n\n    throw new FrontendWorkError(\n      `settle did not converge within ${MAX_DRAIN_PASSES} drain passes.\\n` +\n      (pendingLines.length ? `Still pending:\\n  ${pendingLines.join('\\n  ')}\\n` : '') +\n      (repeating.length ? `Repeating owned work:\\n  ${repeating.join('\\n  ')}\\n` : '') +\n      'Owned work keeps creating more owned work — this names the owners; it is not a timeout.',\n      this.takeNewFailures(),\n    );\n  }\n\n  private takeNewFailures(): WorkFailure[] {\n    const fresh = this.failures.slice(this.reportedFailures);\n    this.reportedFailures = this.failures.length;\n    return fresh;\n  }\n\n  private throwNewFailures(): void {\n    const fresh = this.takeNewFailures();\n    if (!fresh.length) return;\n    const lines = fresh.map(\n      (failure) =>\n        `${describe(failure)}: ${failure.error instanceof Error ? failure.error.message : String(failure.error)}`,\n    );\n    throw new FrontendWorkError(\n      `owned frontend work failed:\\n  ${lines.join('\\n  ')}`,\n      fresh,\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/frontend/work_registry.d.cts

@@ -33,6 +33,8 @@ declare class FrontendWorkError extends Error {
     constructor(message: string, failures?: readonly WorkFailure[]);
 }
 declare class WorkRegistry {
+    private readonly timeoutMs;
+    constructor(timeoutMs?: number);
     private nextId;
     /** Total registrations ever — the fixed-point signal for draining. */
     private registrations;

package/dist/frontend/work_registry.d.ts

@@ -33,6 +33,8 @@ declare class FrontendWorkError extends Error {
     constructor(message: string, failures?: readonly WorkFailure[]);
 }
 declare class WorkRegistry {
+    private readonly timeoutMs;
+    constructor(timeoutMs?: number);
     private nextId;
     /** Total registrations ever — the fixed-point signal for draining. */
     private registrations;

package/dist/frontend/work_registry.js

@@ -10,7 +10,8 @@ function describe(work) {
   return `[${work.kind}] ${work.label} (owner: ${work.owner})`;
 }
 class WorkRegistry {
-  constructor() {
+  constructor(timeoutMs = 5e3) {
+    this.timeoutMs = timeoutMs;
     this.nextId = 1;
     /** Total registrations ever — the fixed-point signal for draining. */
     this.registrations = 0;
@@ -19,6 +20,7 @@ class WorkRegistry {
     /** How many failures a completed drain has already reported. */
     this.reportedFailures = 0;
     this.drainChain = Promise.resolve();
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new Error("Wood work timeoutMs must be finite and non-negative");
   }
   /**
    * Register finite owned work. Returns a promise with the work's own
@@ -33,7 +35,12 @@ class WorkRegistry {
       owner: options.owner ?? "application"
     };
     this.registrations += 1;
-    const promise = typeof work === "function" ? work() : work;
+    let promise;
+    try {
+      promise = Promise.resolve(typeof work === "function" ? work() : work);
+    } catch (error) {
+      promise = Promise.reject(error);
+    }
     const observed = promise.then(
       () => void 0,
       (error) => {
@@ -64,14 +71,30 @@ class WorkRegistry {
    * (repeating owned work), listing pending and repeating labels.
    */
   drain(flushHooks = []) {
-    const run = this.drainChain.then(() => this.drainOnce(flushHooks));
+    const run = this.drainChain.then(async () => {
+      let timer;
+      const cancelled = { value: false };
+      try {
+        await Promise.race([
+          this.drainOnce(flushHooks, cancelled),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => {
+              cancelled.value = true;
+              reject(new FrontendWorkError("settle timed out; pending owners:\n  " + this.pending().map(describe).join("\n  ")));
+            }, this.timeoutMs);
+          })
+        ]);
+      } finally {
+        if (timer !== void 0) clearTimeout(timer);
+      }
+    });
     this.drainChain = run.then(
       () => void 0,
       () => void 0
     );
     return run;
   }
-  async drainOnce(flushHooks) {
+  async drainOnce(flushHooks, cancelled) {
     const seenPerLabel = /* @__PURE__ */ new Map();
     for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {
       const registrationsBefore = this.registrations;
@@ -81,10 +104,12 @@ class WorkRegistry {
       }
       await Promise.all(snapshot.map((entry) => entry.observed));
       for (const hook of flushHooks) {
+        if (cancelled.value) return;
         await hook();
       }
       await Promise.resolve();
       await Promise.resolve();
+      if (cancelled.value) return;
       const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;
       if (stable) {
         this.throwNewFailures();

package/dist/frontend/work_registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/frontend/work_registry.ts"],"sourcesContent":["/**\n * Owned-work registry for the frontend application slice (18A D-FAS-01).\n *\n * `act()` and `settle()` drain framework-owned finite work registered here\n * through production seams (transport invokes, event deliveries, navigation\n * transitions, tracked lifecycle tasks). The registry never patches global\n * async primitives and never guesses at event-loop emptiness: work exists\n * only because an owner registered it, and a drain is a fixed point —\n * repeated passes until one complete pass creates no new owned work.\n *\n * Floating promises and bare timers are explicitly outside the guarantee;\n * they are product lifecycle bugs, not framework blind spots to paper over.\n */\n\nexport type WorkKind =\n  | 'invoke'\n  | 'event-delivery'\n  | 'navigation'\n  | 'initialize'\n  | 'tracked'\n  | (string & {});\n\nexport interface WorkOptions {\n  /** Human-readable diagnostic label, e.g. `invoke messages.send`. */\n  label: string;\n  kind?: WorkKind;\n  /** Owning lifecycle identity, e.g. `page main.chat_dom` or `application`. */\n  owner?: string;\n}\n\nexport interface WorkDescriptor {\n  readonly id: number;\n  readonly label: string;\n  readonly kind: WorkKind;\n  readonly owner: string;\n}\n\nexport interface WorkFailure extends WorkDescriptor {\n  readonly error: unknown;\n}\n\n/** Safety bound on drain passes — a diagnostic limit, not the readiness mechanism. */\nconst MAX_DRAIN_PASSES = 100;\n\nexport class FrontendWorkError extends Error {\n  constructor(message: string, readonly failures: readonly WorkFailure[] = []) {\n    super(message);\n    this.name = 'FrontendWorkError';\n  }\n}\n\nfunction describe(work: WorkDescriptor): string {\n  return `[${work.kind}] ${work.label} (owner: ${work.owner})`;\n}\n\nexport class WorkRegistry {\n  private nextId = 1;\n  /** Total registrations ever — the fixed-point signal for draining. */\n  private registrations = 0;\n  private readonly inFlight = new Map<number, { descriptor: WorkDescriptor; observed: Promise<void> }>();\n  private readonly failures: WorkFailure[] = [];\n  /** How many failures a completed drain has already reported. */\n  private reportedFailures = 0;\n  private drainChain: Promise<void> = Promise.resolve();\n\n  /**\n   * Register finite owned work. Returns a promise with the work's own\n   * settlement semantics — callers may await it directly; the registry\n   * additionally observes completion (success or failure) for draining.\n   */\n  track<T>(work: Promise<T> | (() => Promise<T>), options: WorkOptions): Promise<T> {\n    const descriptor: WorkDescriptor = {\n      id: this.nextId++,\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: options.owner ?? 'application',\n    };\n\n    this.registrations += 1;\n    const promise = typeof work === 'function' ? work() : work;\n\n    // Observe settlement without altering the caller's promise semantics.\n    const observed = promise.then(\n      () => undefined,\n      (error) => {\n        this.failures.push({ ...descriptor, error });\n      },\n    ).finally(() => {\n      this.inFlight.delete(descriptor.id);\n    });\n\n    this.inFlight.set(descriptor.id, { descriptor, observed });\n    return promise;\n  }\n\n  /** Descriptors of currently incomplete owned work. */\n  pending(): WorkDescriptor[] {\n    return [...this.inFlight.values()].map((entry) => entry.descriptor);\n  }\n\n  /** Every owned-work failure observed so far (accumulates across drains). */\n  errors(): readonly WorkFailure[] {\n    return [...this.failures];\n  }\n\n  /**\n   * Fixed-point drain: await all pending owned work, run the adapter flush\n   * hooks, repeat until one full pass observes no pending work and causes\n   * no new registrations. Concurrent drains queue — each caller gets its\n   * own complete pass over whatever work exists when its turn arrives.\n   *\n   * Rejects with `FrontendWorkError` naming the owners when owned work\n   * failed since the previous drain, or when the pass bound is exceeded\n   * (repeating owned work), listing pending and repeating labels.\n   */\n  drain(flushHooks: ReadonlyArray<() => void | Promise<void>> = []): Promise<void> {\n    const run = this.drainChain.then(() => this.drainOnce(flushHooks));\n    // Keep the chain alive regardless of this drain's outcome.\n    this.drainChain = run.then(\n      () => undefined,\n      () => undefined,\n    );\n    return run;\n  }\n\n  private async drainOnce(flushHooks: ReadonlyArray<() => void | Promise<void>>): Promise<void> {\n    const seenPerLabel = new Map<string, number>();\n\n    for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {\n      const registrationsBefore = this.registrations;\n      const snapshot = [...this.inFlight.values()];\n\n      for (const { descriptor } of snapshot) {\n        seenPerLabel.set(descriptor.label, (seenPerLabel.get(descriptor.label) ?? 0) + 1);\n      }\n\n      // Observed promises never reject (failures are recorded by track());\n      // awaiting them cannot abort the pass mid-way.\n      await Promise.all(snapshot.map((entry) => entry.observed));\n\n      for (const hook of flushHooks) {\n        await hook();\n      }\n\n      // Give completion continuations a microtask to register follow-on\n      // owned work before the fixed point is tested.\n      await Promise.resolve();\n      await Promise.resolve();\n\n      const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;\n      if (stable) {\n        this.throwNewFailures();\n        return;\n      }\n    }\n\n    const pendingLines = this.pending().map(describe);\n    const repeating = [...seenPerLabel.entries()]\n      .filter(([, count]) => count > 3)\n      .map(([label, count]) => `${label} (seen in ${count} passes)`);\n\n    throw new FrontendWorkError(\n      `settle did not converge within ${MAX_DRAIN_PASSES} drain passes.\\n` +\n      (pendingLines.length ? `Still pending:\\n  ${pendingLines.join('\\n  ')}\\n` : '') +\n      (repeating.length ? `Repeating owned work:\\n  ${repeating.join('\\n  ')}\\n` : '') +\n      'Owned work keeps creating more owned work — this names the owners; it is not a timeout.',\n      this.takeNewFailures(),\n    );\n  }\n\n  private takeNewFailures(): WorkFailure[] {\n    const fresh = this.failures.slice(this.reportedFailures);\n    this.reportedFailures = this.failures.length;\n    return fresh;\n  }\n\n  private throwNewFailures(): void {\n    const fresh = this.takeNewFailures();\n    if (!fresh.length) return;\n    const lines = fresh.map(\n      (failure) =>\n        `${describe(failure)}: ${failure.error instanceof Error ? failure.error.message : String(failure.error)}`,\n    );\n    throw new FrontendWorkError(\n      `owned frontend work failed:\\n  ${lines.join('\\n  ')}`,\n      fresh,\n    );\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/frontend/work_registry.ts"],"sourcesContent":["/**\n * Owned-work registry for the frontend application slice (18A D-FAS-01).\n *\n * `act()` and `settle()` drain framework-owned finite work registered here\n * through production seams (transport invokes, event deliveries, navigation\n * transitions, tracked lifecycle tasks). The registry never patches global\n * async primitives and never guesses at event-loop emptiness: work exists\n * only because an owner registered it, and a drain is a fixed point —\n * repeated passes until one complete pass creates no new owned work.\n *\n * Floating promises and bare timers are explicitly outside the guarantee;\n * they are product lifecycle bugs, not framework blind spots to paper over.\n */\n\nexport type WorkKind =\n  | 'invoke'\n  | 'event-delivery'\n  | 'navigation'\n  | 'initialize'\n  | 'tracked'\n  | (string & {});\n\nexport interface WorkOptions {\n  /** Human-readable diagnostic label, e.g. `invoke messages.send`. */\n  label: string;\n  kind?: WorkKind;\n  /** Owning lifecycle identity, e.g. `page main.chat_dom` or `application`. */\n  owner?: string;\n}\n\nexport interface WorkDescriptor {\n  readonly id: number;\n  readonly label: string;\n  readonly kind: WorkKind;\n  readonly owner: string;\n}\n\nexport interface WorkFailure extends WorkDescriptor {\n  readonly error: unknown;\n}\n\n/** Safety bound on drain passes — a diagnostic limit, not the readiness mechanism. */\nconst MAX_DRAIN_PASSES = 100;\n\nexport class FrontendWorkError extends Error {\n  constructor(message: string, readonly failures: readonly WorkFailure[] = []) {\n    super(message);\n    this.name = 'FrontendWorkError';\n  }\n}\n\nfunction describe(work: WorkDescriptor): string {\n  return `[${work.kind}] ${work.label} (owner: ${work.owner})`;\n}\n\nexport class WorkRegistry {\n  constructor(private readonly timeoutMs = 5000) {\n    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new Error('Wood work timeoutMs must be finite and non-negative');\n  }\n  private nextId = 1;\n  /** Total registrations ever — the fixed-point signal for draining. */\n  private registrations = 0;\n  private readonly inFlight = new Map<number, { descriptor: WorkDescriptor; observed: Promise<void> }>();\n  private readonly failures: WorkFailure[] = [];\n  /** How many failures a completed drain has already reported. */\n  private reportedFailures = 0;\n  private drainChain: Promise<void> = Promise.resolve();\n\n  /**\n   * Register finite owned work. Returns a promise with the work's own\n   * settlement semantics — callers may await it directly; the registry\n   * additionally observes completion (success or failure) for draining.\n   */\n  track<T>(work: Promise<T> | (() => Promise<T>), options: WorkOptions): Promise<T> {\n    const descriptor: WorkDescriptor = {\n      id: this.nextId++,\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: options.owner ?? 'application',\n    };\n\n    this.registrations += 1;\n    let promise: Promise<T>;\n    try { promise = Promise.resolve(typeof work === 'function' ? work() : work); }\n    catch (error) { promise = Promise.reject(error); }\n\n    // Observe settlement without altering the caller's promise semantics.\n    const observed = promise.then(\n      () => undefined,\n      (error) => {\n        this.failures.push({ ...descriptor, error });\n      },\n    ).finally(() => {\n      this.inFlight.delete(descriptor.id);\n    });\n\n    this.inFlight.set(descriptor.id, { descriptor, observed });\n    return promise;\n  }\n\n  /** Descriptors of currently incomplete owned work. */\n  pending(): WorkDescriptor[] {\n    return [...this.inFlight.values()].map((entry) => entry.descriptor);\n  }\n\n  /** Every owned-work failure observed so far (accumulates across drains). */\n  errors(): readonly WorkFailure[] {\n    return [...this.failures];\n  }\n\n  /**\n   * Fixed-point drain: await all pending owned work, run the adapter flush\n   * hooks, repeat until one full pass observes no pending work and causes\n   * no new registrations. Concurrent drains queue — each caller gets its\n   * own complete pass over whatever work exists when its turn arrives.\n   *\n   * Rejects with `FrontendWorkError` naming the owners when owned work\n   * failed since the previous drain, or when the pass bound is exceeded\n   * (repeating owned work), listing pending and repeating labels.\n   */\n  drain(flushHooks: ReadonlyArray<() => void | Promise<void>> = []): Promise<void> {\n    const run = this.drainChain.then(async () => {\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const cancelled = { value: false };\n      try {\n        await Promise.race([\n          this.drainOnce(flushHooks, cancelled),\n          new Promise<never>((_, reject) => { timer = setTimeout(() => {\n            cancelled.value = true;\n            reject(new FrontendWorkError('settle timed out; pending owners:\\n  ' + this.pending().map(describe).join('\\n  ')));\n          }, this.timeoutMs); }),\n        ]);\n      } finally { if (timer !== undefined) clearTimeout(timer); }\n    });\n    // Keep the chain alive regardless of this drain's outcome.\n    this.drainChain = run.then(\n      () => undefined,\n      () => undefined,\n    );\n    return run;\n  }\n\n  private async drainOnce(flushHooks: ReadonlyArray<() => void | Promise<void>>, cancelled: { value: boolean }): Promise<void> {\n    const seenPerLabel = new Map<string, number>();\n\n    for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {\n      const registrationsBefore = this.registrations;\n      const snapshot = [...this.inFlight.values()];\n\n      for (const { descriptor } of snapshot) {\n        seenPerLabel.set(descriptor.label, (seenPerLabel.get(descriptor.label) ?? 0) + 1);\n      }\n\n      // Observed promises never reject (failures are recorded by track());\n      // awaiting them cannot abort the pass mid-way.\n      await Promise.all(snapshot.map((entry) => entry.observed));\n\n      for (const hook of flushHooks) {\n        if (cancelled.value) return;\n        await hook();\n      }\n\n      // Give completion continuations a microtask to register follow-on\n      // owned work before the fixed point is tested.\n      await Promise.resolve();\n      await Promise.resolve();\n\n      if (cancelled.value) return;\n      const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;\n      if (stable) {\n        this.throwNewFailures();\n        return;\n      }\n    }\n\n    const pendingLines = this.pending().map(describe);\n    const repeating = [...seenPerLabel.entries()]\n      .filter(([, count]) => count > 3)\n      .map(([label, count]) => `${label} (seen in ${count} passes)`);\n\n    throw new FrontendWorkError(\n      `settle did not converge within ${MAX_DRAIN_PASSES} drain passes.\\n` +\n      (pendingLines.length ? `Still pending:\\n  ${pendingLines.join('\\n  ')}\\n` : '') +\n      (repeating.length ? `Repeating owned work:\\n  ${repeating.join('\\n  ')}\\n` : '') +\n      'Owned work keeps creating more owned work — this names the owners; it is not a timeout.',\n      this.takeNewFailures(),\n    );\n  }\n\n  private takeNewFailures(): WorkFailure[] {\n    const fresh = this.failures.slice(this.reportedFailures);\n    this.reportedFailures = this.failures.length;\n    return fresh;\n  }\n\n  private throwNewFailures(): void {\n    const fresh = this.takeNewFailures();\n    if (!fresh.length) return;\n    const lines = fresh.map(\n      (failure) =>\n        `${describe(failure)}: ${failure.error instanceof Error ? failure.error.message : String(failure.error)}`,\n    );\n    throw new FrontendWorkError(\n      `owned frontend work failed:\\n  ${lines.join('\\n  ')}`,\n      fresh,\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -42,6 +42,8 @@ export { Navigation, NavigationEntry, NavigationOptions, getNavigation, go, goba
 export { Ipc, getIpc } from './ipc/index.cjs';
 export { IpcPushOptions } from './ipc/shared.cjs';
 import '@noego/ioc';
+import './runtime/renderer_log_dispatcher.cjs';
+import './runtime/renderer_config_extension.cjs';
 import './runtime/app_env.cjs';
 import 'rxjs';
 import '@noego/trace';

package/dist/index.d.ts

@@ -42,6 +42,8 @@ export { Navigation, NavigationEntry, NavigationOptions, getNavigation, go, goba
 export { Ipc, getIpc } from './ipc/index.js';
 export { IpcPushOptions } from './ipc/shared.js';
 import '@noego/ioc';
+import './runtime/renderer_log_dispatcher.js';
+import './runtime/renderer_config_extension.js';
 import './runtime/app_env.js';
 import 'rxjs';
 import '@noego/trace';

package/dist/ipc/index.cjs

@@ -43,8 +43,12 @@ function normalizeCallbackPayload(args) {
   return args;
 }
 class Ipc {
+  /** Omit options only for the legacy process-global/preload adapter. */
+  constructor(owner) {
+    this.owner = owner;
+  }
   send(channel, payload, options) {
-    const sender = (0, import_shared.getIpcPushSender)();
+    const sender = this.owner ? this.owner.send : (0, import_shared.getIpcPushSender)();
     if (!sender) {
       return false;
     }
@@ -55,7 +59,7 @@ class Ipc {
     return this.send(channel, payload, options);
   }
   on(channel, listener) {
-    const bridge = resolveBridge();
+    const bridge = this.owner ? this.owner.bridge : resolveBridge();
     if (!bridge || typeof bridge.on !== "function") {
       return () => {
       };

package/dist/ipc/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ipc/index.ts"],"sourcesContent":["import {\n  getIpcPushSender,\n  type IpcPushOptions,\n} from './shared.js';\n\nconst IPC_SINGLETON_SYMBOL = Symbol.for('@noego/wood.ipc.singleton');\n\ntype IpcListener = (payload: unknown) => void;\ntype IpcUnsubscribe = () => void;\n\ntype WoodBridgeLike = {\n  on?: (channel: string, callback: (...args: unknown[]) => void) => IpcUnsubscribe;\n};\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\ntype GlobalWithIpc = typeof globalThis & {\n  [IPC_SINGLETON_SYMBOL]?: Ipc;\n  [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n  wood?: unknown;\n  window?: {\n    [key: string]: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction getGlobal(): GlobalWithIpc {\n  return globalThis as GlobalWithIpc;\n}\n\nfunction resolveBridge(): WoodBridgeLike | null {\n  const globalObj = getGlobal();\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as WoodBridgeLike;\n}\n\nfunction normalizeCallbackPayload(args: unknown[]): unknown {\n  if (args.length <= 1) {\n    return args[0];\n  }\n  return args;\n}\n\nexport class Ipc {\n  send(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    const sender = getIpcPushSender();\n    if (!sender) {\n      return false;\n    }\n    sender(channel, payload, options);\n    return true;\n  }\n\n  emit(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    return this.send(channel, payload, options);\n  }\n\n  on(channel: string, listener: IpcListener): IpcUnsubscribe {\n    const bridge = resolveBridge();\n    if (!bridge || typeof bridge.on !== 'function') {\n      return () => {};\n    }\n    return bridge.on(channel, (...args: unknown[]) => {\n      listener(normalizeCallbackPayload(args));\n    });\n  }\n}\n\nexport function getIpc(): Ipc {\n  const globalObj = getGlobal();\n  if (!globalObj[IPC_SINGLETON_SYMBOL]) {\n    globalObj[IPC_SINGLETON_SYMBOL] = new Ipc();\n  }\n  return globalObj[IPC_SINGLETON_SYMBOL] as Ipc;\n}\n\nexport type { IpcPushOptions };\n\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAGO;AAEP,MAAM,uBAAuB,uBAAO,IAAI,2BAA2B;AASnE,MAAM,6BAA6B;AAYnC,SAAS,YAA2B;AAClC,SAAO;AACT;AAEA,SAAS,gBAAuC;AAC9C,QAAM,YAAY,UAAU;AAC5B,QAAM,SAAS,UAAU,0BAA0B,KAC9C,UAAU,SAAS,0BAA0B,KAC7C,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,yBAAyB,MAA0B;AAC1D,MAAI,KAAK,UAAU,GAAG;AACpB,WAAO,KAAK,CAAC;AAAA,EACf;AACA,SAAO;AACT;AAEO,MAAM,IAAI;AAAA,EACf,KAAK,SAAiB,SAAkB,SAAmC;AACzE,UAAM,aAAS,gCAAiB;AAChC,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,SAAS,SAAS,OAAO;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,SAAiB,SAAkB,SAAmC;AACzE,WAAO,KAAK,KAAK,SAAS,SAAS,OAAO;AAAA,EAC5C;AAAA,EAEA,GAAG,SAAiB,UAAuC;AACzD,UAAM,SAAS,cAAc;AAC7B,QAAI,CAAC,UAAU,OAAO,OAAO,OAAO,YAAY;AAC9C,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AACA,WAAO,OAAO,GAAG,SAAS,IAAI,SAAoB;AAChD,eAAS,yBAAyB,IAAI,CAAC;AAAA,IACzC,CAAC;AAAA,EACH;AACF;AAEO,SAAS,SAAc;AAC5B,QAAM,YAAY,UAAU;AAC5B,MAAI,CAAC,UAAU,oBAAoB,GAAG;AACpC,cAAU,oBAAoB,IAAI,IAAI,IAAI;AAAA,EAC5C;AACA,SAAO,UAAU,oBAAoB;AACvC;","names":[]}
+{"version":3,"sources":["../../src/ipc/index.ts"],"sourcesContent":["import {\n  getIpcPushSender,\n  type IpcPushOptions,\n} from './shared.js';\n\nconst IPC_SINGLETON_SYMBOL = Symbol.for('@noego/wood.ipc.singleton');\n\ntype IpcListener = (payload: unknown) => void;\ntype IpcUnsubscribe = () => void;\n\ntype WoodBridgeLike = {\n  on?: (channel: string, callback: (...args: unknown[]) => void) => IpcUnsubscribe;\n};\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\ntype GlobalWithIpc = typeof globalThis & {\n  [IPC_SINGLETON_SYMBOL]?: Ipc;\n  [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n  wood?: unknown;\n  window?: {\n    [key: string]: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction getGlobal(): GlobalWithIpc {\n  return globalThis as GlobalWithIpc;\n}\n\nfunction resolveBridge(): WoodBridgeLike | null {\n  const globalObj = getGlobal();\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as WoodBridgeLike;\n}\n\nfunction normalizeCallbackPayload(args: unknown[]): unknown {\n  if (args.length <= 1) {\n    return args[0];\n  }\n  return args;\n}\n\nexport class Ipc {\n  /** Omit options only for the legacy process-global/preload adapter. */\n  constructor(private readonly owner?: {\n    send?: (channel: string, payload: unknown, options?: IpcPushOptions) => void;\n    bridge?: WoodBridgeLike;\n  }) {}\n  send(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    const sender = this.owner ? this.owner.send : getIpcPushSender();\n    if (!sender) {\n      return false;\n    }\n    sender(channel, payload, options);\n    return true;\n  }\n\n  emit(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    return this.send(channel, payload, options);\n  }\n\n  on(channel: string, listener: IpcListener): IpcUnsubscribe {\n    const bridge = this.owner ? this.owner.bridge : resolveBridge();\n    if (!bridge || typeof bridge.on !== 'function') {\n      return () => {};\n    }\n    return bridge.on(channel, (...args: unknown[]) => {\n      listener(normalizeCallbackPayload(args));\n    });\n  }\n}\n\nexport function getIpc(): Ipc {\n  const globalObj = getGlobal();\n  if (!globalObj[IPC_SINGLETON_SYMBOL]) {\n    globalObj[IPC_SINGLETON_SYMBOL] = new Ipc();\n  }\n  return globalObj[IPC_SINGLETON_SYMBOL] as Ipc;\n}\n\nexport type { IpcPushOptions };\n\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAGO;AAEP,MAAM,uBAAuB,uBAAO,IAAI,2BAA2B;AASnE,MAAM,6BAA6B;AAYnC,SAAS,YAA2B;AAClC,SAAO;AACT;AAEA,SAAS,gBAAuC;AAC9C,QAAM,YAAY,UAAU;AAC5B,QAAM,SAAS,UAAU,0BAA0B,KAC9C,UAAU,SAAS,0BAA0B,KAC7C,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,yBAAyB,MAA0B;AAC1D,MAAI,KAAK,UAAU,GAAG;AACpB,WAAO,KAAK,CAAC;AAAA,EACf;AACA,SAAO;AACT;AAEO,MAAM,IAAI;AAAA;AAAA,EAEf,YAA6B,OAG1B;AAH0B;AAAA,EAGzB;AAAA,EACJ,KAAK,SAAiB,SAAkB,SAAmC;AACzE,UAAM,SAAS,KAAK,QAAQ,KAAK,MAAM,WAAO,gCAAiB;AAC/D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,SAAS,SAAS,OAAO;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,SAAiB,SAAkB,SAAmC;AACzE,WAAO,KAAK,KAAK,SAAS,SAAS,OAAO;AAAA,EAC5C;AAAA,EAEA,GAAG,SAAiB,UAAuC;AACzD,UAAM,SAAS,KAAK,QAAQ,KAAK,MAAM,SAAS,cAAc;AAC9D,QAAI,CAAC,UAAU,OAAO,OAAO,OAAO,YAAY;AAC9C,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AACA,WAAO,OAAO,GAAG,SAAS,IAAI,SAAoB;AAChD,eAAS,yBAAyB,IAAI,CAAC;AAAA,IACzC,CAAC;AAAA,EACH;AACF;AAEO,SAAS,SAAc;AAC5B,QAAM,YAAY,UAAU;AAC5B,MAAI,CAAC,UAAU,oBAAoB,GAAG;AACpC,cAAU,oBAAoB,IAAI,IAAI,IAAI;AAAA,EAC5C;AACA,SAAO,UAAU,oBAAoB;AACvC;","names":[]}

package/dist/ipc/index.d.cts

@@ -2,7 +2,16 @@ import { IpcPushOptions } from './shared.cjs';
 
 type IpcListener = (payload: unknown) => void;
 type IpcUnsubscribe = () => void;
+type WoodBridgeLike = {
+    on?: (channel: string, callback: (...args: unknown[]) => void) => IpcUnsubscribe;
+};
 declare class Ipc {
+    private readonly owner?;
+    /** Omit options only for the legacy process-global/preload adapter. */
+    constructor(owner?: {
+        send?: (channel: string, payload: unknown, options?: IpcPushOptions) => void;
+        bridge?: WoodBridgeLike;
+    } | undefined);
     send(channel: string, payload: unknown, options?: IpcPushOptions): boolean;
     emit(channel: string, payload: unknown, options?: IpcPushOptions): boolean;
     on(channel: string, listener: IpcListener): IpcUnsubscribe;

package/dist/ipc/index.d.ts

@@ -2,7 +2,16 @@ import { IpcPushOptions } from './shared.js';
 
 type IpcListener = (payload: unknown) => void;
 type IpcUnsubscribe = () => void;
+type WoodBridgeLike = {
+    on?: (channel: string, callback: (...args: unknown[]) => void) => IpcUnsubscribe;
+};
 declare class Ipc {
+    private readonly owner?;
+    /** Omit options only for the legacy process-global/preload adapter. */
+    constructor(owner?: {
+        send?: (channel: string, payload: unknown, options?: IpcPushOptions) => void;
+        bridge?: WoodBridgeLike;
+    } | undefined);
     send(channel: string, payload: unknown, options?: IpcPushOptions): boolean;
     emit(channel: string, payload: unknown, options?: IpcPushOptions): boolean;
     on(channel: string, listener: IpcListener): IpcUnsubscribe;

package/dist/ipc/index.js

@@ -21,8 +21,12 @@ function normalizeCallbackPayload(args) {
   return args;
 }
 class Ipc {
+  /** Omit options only for the legacy process-global/preload adapter. */
+  constructor(owner) {
+    this.owner = owner;
+  }
   send(channel, payload, options) {
-    const sender = getIpcPushSender();
+    const sender = this.owner ? this.owner.send : getIpcPushSender();
     if (!sender) {
       return false;
     }
@@ -33,7 +37,7 @@ class Ipc {
     return this.send(channel, payload, options);
   }
   on(channel, listener) {
-    const bridge = resolveBridge();
+    const bridge = this.owner ? this.owner.bridge : resolveBridge();
     if (!bridge || typeof bridge.on !== "function") {
       return () => {
       };

package/dist/ipc/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ipc/index.ts"],"sourcesContent":["import {\n  getIpcPushSender,\n  type IpcPushOptions,\n} from './shared.js';\n\nconst IPC_SINGLETON_SYMBOL = Symbol.for('@noego/wood.ipc.singleton');\n\ntype IpcListener = (payload: unknown) => void;\ntype IpcUnsubscribe = () => void;\n\ntype WoodBridgeLike = {\n  on?: (channel: string, callback: (...args: unknown[]) => void) => IpcUnsubscribe;\n};\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\ntype GlobalWithIpc = typeof globalThis & {\n  [IPC_SINGLETON_SYMBOL]?: Ipc;\n  [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n  wood?: unknown;\n  window?: {\n    [key: string]: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction getGlobal(): GlobalWithIpc {\n  return globalThis as GlobalWithIpc;\n}\n\nfunction resolveBridge(): WoodBridgeLike | null {\n  const globalObj = getGlobal();\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as WoodBridgeLike;\n}\n\nfunction normalizeCallbackPayload(args: unknown[]): unknown {\n  if (args.length <= 1) {\n    return args[0];\n  }\n  return args;\n}\n\nexport class Ipc {\n  send(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    const sender = getIpcPushSender();\n    if (!sender) {\n      return false;\n    }\n    sender(channel, payload, options);\n    return true;\n  }\n\n  emit(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    return this.send(channel, payload, options);\n  }\n\n  on(channel: string, listener: IpcListener): IpcUnsubscribe {\n    const bridge = resolveBridge();\n    if (!bridge || typeof bridge.on !== 'function') {\n      return () => {};\n    }\n    return bridge.on(channel, (...args: unknown[]) => {\n      listener(normalizeCallbackPayload(args));\n    });\n  }\n}\n\nexport function getIpc(): Ipc {\n  const globalObj = getGlobal();\n  if (!globalObj[IPC_SINGLETON_SYMBOL]) {\n    globalObj[IPC_SINGLETON_SYMBOL] = new Ipc();\n  }\n  return globalObj[IPC_SINGLETON_SYMBOL] as Ipc;\n}\n\nexport type { IpcPushOptions };\n\n"],"mappings":"AAAA;AAAA,EACE;AAAA,OAEK;AAEP,MAAM,uBAAuB,uBAAO,IAAI,2BAA2B;AASnE,MAAM,6BAA6B;AAYnC,SAAS,YAA2B;AAClC,SAAO;AACT;AAEA,SAAS,gBAAuC;AAC9C,QAAM,YAAY,UAAU;AAC5B,QAAM,SAAS,UAAU,0BAA0B,KAC9C,UAAU,SAAS,0BAA0B,KAC7C,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,yBAAyB,MAA0B;AAC1D,MAAI,KAAK,UAAU,GAAG;AACpB,WAAO,KAAK,CAAC;AAAA,EACf;AACA,SAAO;AACT;AAEO,MAAM,IAAI;AAAA,EACf,KAAK,SAAiB,SAAkB,SAAmC;AACzE,UAAM,SAAS,iBAAiB;AAChC,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,SAAS,SAAS,OAAO;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,SAAiB,SAAkB,SAAmC;AACzE,WAAO,KAAK,KAAK,SAAS,SAAS,OAAO;AAAA,EAC5C;AAAA,EAEA,GAAG,SAAiB,UAAuC;AACzD,UAAM,SAAS,cAAc;AAC7B,QAAI,CAAC,UAAU,OAAO,OAAO,OAAO,YAAY;AAC9C,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AACA,WAAO,OAAO,GAAG,SAAS,IAAI,SAAoB;AAChD,eAAS,yBAAyB,IAAI,CAAC;AAAA,IACzC,CAAC;AAAA,EACH;AACF;AAEO,SAAS,SAAc;AAC5B,QAAM,YAAY,UAAU;AAC5B,MAAI,CAAC,UAAU,oBAAoB,GAAG;AACpC,cAAU,oBAAoB,IAAI,IAAI,IAAI;AAAA,EAC5C;AACA,SAAO,UAAU,oBAAoB;AACvC;","names":[]}
+{"version":3,"sources":["../../src/ipc/index.ts"],"sourcesContent":["import {\n  getIpcPushSender,\n  type IpcPushOptions,\n} from './shared.js';\n\nconst IPC_SINGLETON_SYMBOL = Symbol.for('@noego/wood.ipc.singleton');\n\ntype IpcListener = (payload: unknown) => void;\ntype IpcUnsubscribe = () => void;\n\ntype WoodBridgeLike = {\n  on?: (channel: string, callback: (...args: unknown[]) => void) => IpcUnsubscribe;\n};\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\ntype GlobalWithIpc = typeof globalThis & {\n  [IPC_SINGLETON_SYMBOL]?: Ipc;\n  [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n  wood?: unknown;\n  window?: {\n    [key: string]: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction getGlobal(): GlobalWithIpc {\n  return globalThis as GlobalWithIpc;\n}\n\nfunction resolveBridge(): WoodBridgeLike | null {\n  const globalObj = getGlobal();\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as WoodBridgeLike;\n}\n\nfunction normalizeCallbackPayload(args: unknown[]): unknown {\n  if (args.length <= 1) {\n    return args[0];\n  }\n  return args;\n}\n\nexport class Ipc {\n  /** Omit options only for the legacy process-global/preload adapter. */\n  constructor(private readonly owner?: {\n    send?: (channel: string, payload: unknown, options?: IpcPushOptions) => void;\n    bridge?: WoodBridgeLike;\n  }) {}\n  send(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    const sender = this.owner ? this.owner.send : getIpcPushSender();\n    if (!sender) {\n      return false;\n    }\n    sender(channel, payload, options);\n    return true;\n  }\n\n  emit(channel: string, payload: unknown, options?: IpcPushOptions): boolean {\n    return this.send(channel, payload, options);\n  }\n\n  on(channel: string, listener: IpcListener): IpcUnsubscribe {\n    const bridge = this.owner ? this.owner.bridge : resolveBridge();\n    if (!bridge || typeof bridge.on !== 'function') {\n      return () => {};\n    }\n    return bridge.on(channel, (...args: unknown[]) => {\n      listener(normalizeCallbackPayload(args));\n    });\n  }\n}\n\nexport function getIpc(): Ipc {\n  const globalObj = getGlobal();\n  if (!globalObj[IPC_SINGLETON_SYMBOL]) {\n    globalObj[IPC_SINGLETON_SYMBOL] = new Ipc();\n  }\n  return globalObj[IPC_SINGLETON_SYMBOL] as Ipc;\n}\n\nexport type { IpcPushOptions };\n\n"],"mappings":"AAAA;AAAA,EACE;AAAA,OAEK;AAEP,MAAM,uBAAuB,uBAAO,IAAI,2BAA2B;AASnE,MAAM,6BAA6B;AAYnC,SAAS,YAA2B;AAClC,SAAO;AACT;AAEA,SAAS,gBAAuC;AAC9C,QAAM,YAAY,UAAU;AAC5B,QAAM,SAAS,UAAU,0BAA0B,KAC9C,UAAU,SAAS,0BAA0B,KAC7C,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,yBAAyB,MAA0B;AAC1D,MAAI,KAAK,UAAU,GAAG;AACpB,WAAO,KAAK,CAAC;AAAA,EACf;AACA,SAAO;AACT;AAEO,MAAM,IAAI;AAAA;AAAA,EAEf,YAA6B,OAG1B;AAH0B;AAAA,EAGzB;AAAA,EACJ,KAAK,SAAiB,SAAkB,SAAmC;AACzE,UAAM,SAAS,KAAK,QAAQ,KAAK,MAAM,OAAO,iBAAiB;AAC/D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,SAAS,SAAS,OAAO;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,SAAiB,SAAkB,SAAmC;AACzE,WAAO,KAAK,KAAK,SAAS,SAAS,OAAO;AAAA,EAC5C;AAAA,EAEA,GAAG,SAAiB,UAAuC;AACzD,UAAM,SAAS,KAAK,QAAQ,KAAK,MAAM,SAAS,cAAc;AAC9D,QAAI,CAAC,UAAU,OAAO,OAAO,OAAO,YAAY;AAC9C,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AACA,WAAO,OAAO,GAAG,SAAS,IAAI,SAAoB;AAChD,eAAS,yBAAyB,IAAI,CAAC;AAAA,IACzC,CAAC;AAAA,EACH;AACF;AAEO,SAAS,SAAc;AAC5B,QAAM,YAAY,UAAU;AAC5B,MAAI,CAAC,UAAU,oBAAoB,GAAG;AACpC,cAAU,oBAAoB,IAAI,IAAI,IAAI;AAAA,EAC5C;AACA,SAAO,UAAU,oBAAoB;AACvC;","names":[]}

package/dist/main/index.cjs

@@ -37,17 +37,19 @@ __export(main_exports, {
 });
 module.exports = __toCommonJS(main_exports);
 var import_path = __toESM(require("path"), 1);
+var import_startup_failure_handler = require("./startup_failure_handler.cjs");
 var import_electron = require("electron");
 var import_logger = require("@noego/logger");
 var import_window_state_store = require("../window/window_state_store.js");
 var import_get_container = require("../runtime/get_container.js");
+var import_cleanup = require("../controller/cleanup.js");
+var import_ioc = require("@noego/ioc");
 var import_runtime = require("../runtime/runtime.js");
 var import_tracing = require("../tracing/index.js");
 var import_application_root = require("../runtime/application_root.js");
 var import_renderer_log_dispatcher = require("../runtime/renderer_log_dispatcher.js");
 var import_renderer_log_batch_receiver = require("../runtime/renderer_log_batch_receiver.js");
 var import_renderer_log_batch_receiver2 = require("../runtime/renderer_log_batch_receiver.js");
-var import_renderer_config_extension = require("../runtime/renderer_config_extension.js");
 var import_renderer_config_extension2 = require("../runtime/renderer_config_extension.js");
 var import_ipc = require("../ipc/index.js");
 var import_shared = require("../ipc/shared.js");
@@ -119,6 +121,13 @@ function toErrorMessage(error) {
 function startWoodMain(options) {
   const logger = (0, import_logger.getLogger)("wood:main").named("bootstrap");
   const runtimeLogger = (0, import_logger.getLogger)("wood:main").named("runtime");
+  const startupFailure = new import_startup_failure_handler.StartupFailureHandler(
+    logger,
+    (message) => {
+      process.stderr.write(message);
+    },
+    (code) => import_electron.app.exit(code)
+  );
   const debugConfig = resolveWoodDebugMetadataConfiguration();
   const windowState = new import_window_state_store.WindowStateStore();
   const windows = /* @__PURE__ */ new Map();
@@ -128,6 +137,7 @@ function startWoodMain(options) {
   let beforeQuitCleanupPromise = null;
   let runtimeContext = null;
   let mainBootCleanup;
+  let runtimeCleanup;
   let nativeQuitFallbackInstalled = false;
   const rendererTraceDrain = new import_renderer_trace_drain_coordinator.RendererTraceDrainCoordinator(import_electron.ipcMain);
   rendererTraceDrain.start();
@@ -163,7 +173,6 @@ function startWoodMain(options) {
   const initializeRuntime = async () => {
     const appBootResult = options.appBoot ? await options.appBoot(bootContext) : void 0;
     const bootOverrides = appBootResult ?? {};
-    const scope = bootOverrides.scope ?? options.scope ?? process.cwd();
     const configureContainer = bootOverrides.configureContainer ?? options.configureContainer;
     const privilegedSchemes = Array.isArray(bootOverrides.registerSchemesAsPrivileged) ? bootOverrides.registerSchemesAsPrivileged : [];
     if (privilegedSchemes.length > 0) {
@@ -176,13 +185,14 @@ function startWoodMain(options) {
     const outDir = options.outDir ?? "out";
     const preloadPath = import_path.default.join(import_electron.app.getAppPath(), outDir, "preload", "index.js");
     const rendererFile = import_path.default.join(import_electron.app.getAppPath(), outDir, "renderer", "index.html");
-    const container = (0, import_get_container.getContainer)({
-      scope,
+    const rendererLogDispatcher = new import_renderer_log_dispatcher.RendererLogDispatcher();
+    let rendererConfigExtension = null;
+    const container = (0, import_get_container.createWoodRoot)({
       ...configureContainer ? { configure: configureContainer } : {}
     });
     const registrationContainer = container;
     if (typeof registrationContainer.registerFunction === "function") {
-      registrationContainer.registerFunction(import_ipc.Ipc, () => (0, import_ipc.getIpc)());
+      registrationContainer.registerFunction(import_ipc.Ipc, () => new import_ipc.Ipc({ send: dispatchPushEvent }));
     }
     const getWindow = (windowId) => {
       const existing = windows.get(windowId);
@@ -413,7 +423,11 @@ function startWoodMain(options) {
         webPreferences: {
           preload: preloadPath,
           contextIsolation: true,
-          nodeIntegration: false
+          nodeIntegration: false,
+          // Packaged builds never expose DevTools: this disables the default
+          // menu's "Toggle Developer Tools" shortcut (Cmd/Ctrl+Alt+I, F12)
+          // and any openDevTools() call for this window.
+          devTools: !import_electron.app.isPackaged
         }
       };
       const win = new import_electron.BrowserWindow(windowOptions);
@@ -555,7 +569,7 @@ function startWoodMain(options) {
         safeSend(windowId, win, eventChannel, data);
       }
     };
-    (0, import_shared.setIpcPushSender)(dispatchPushEvent);
+    if (options.legacyGlobals) (0, import_shared.setIpcPushSender)(dispatchPushEvent);
     const broadcast = (channel, data) => {
       for (const [windowId, win] of windows.entries()) {
         if (win.isDestroyed()) {
@@ -575,11 +589,13 @@ function startWoodMain(options) {
       broadcast,
       getRendererHealthState,
       setRendererLogCallback: (callback) => {
-        (0, import_renderer_log_dispatcher.getRendererLogDispatcher)().setCallback(callback);
+        rendererLogDispatcher.setCallback(callback);
       },
-      getRendererLogCallback: () => (0, import_renderer_log_dispatcher.getRendererLogDispatcher)().getCallback(),
+      getRendererLogCallback: () => rendererLogDispatcher.getCallback(),
       setRendererLogRecordFilter: import_renderer_log_batch_receiver.setRendererLogRecordFilter,
-      setRendererConfigExtension: import_renderer_config_extension.setRendererConfigExtension,
+      setRendererConfigExtension: (extension) => {
+        rendererConfigExtension = extension;
+      },
       getDebugMetadata,
       // Late-bound after bootRuntime constructs the router (see bootstrap).
       dispatch: async () => {
@@ -597,10 +613,14 @@ function startWoodMain(options) {
           mainBootCleanup = bootResult;
         }
       }
-      const { router: runtimeRouter } = await (0, import_runtime.runtime)({
+      const { router: runtimeRouter, dispose: closeRuntime } = await (0, import_runtime.runtime)({
         container,
         ipcMain: import_electron.ipcMain,
         registerRuntime: options.registerRuntime,
+        rendererTraceBatchReceiver: options.rendererTraceBatchReceiver,
+        legacyGlobals: options.legacyGlobals,
+        rendererLogDispatcher,
+        rendererConfigExtension: () => rendererConfigExtension?.() ?? {},
         controllersDir: resolveRuntimePath(options.controllersDir),
         middlewareDir: resolveRuntimePath(options.middlewareDir),
         ...options.traceMinLevel ? { traceMinLevel: options.traceMinLevel } : {},
@@ -694,14 +714,15 @@ function startWoodMain(options) {
         }
       });
       runtimeContext.dispatch = (channel, payload) => runtimeRouter.dispatch(channel, payload ?? {});
+      runtimeCleanup = closeRuntime;
       bootstrapActivationGate.ready();
       logger.info("bootstrap complete");
     };
-    const handleBootstrapFailure = (error) => {
+    const handleBootstrapFailure = async (error) => {
       bootstrapActivationGate.failed();
-      logger.error("bootstrap failed", {
-        message: toErrorMessage(error),
-        stack: error instanceof Error ? error.stack : void 0
+      await startupFailure.handle("bootstrap failed", error, async () => {
+        rendererTraceDrain.stop();
+        await (0, import_cleanup.cleanupAll)([() => runtimeCleanup?.(), () => mainBootCleanup?.(), () => container.dispose()], "Wood bootstrap rollback failed");
       });
     };
     void import_electron.app.whenReady().then(bootstrap).catch(handleBootstrapFailure);
@@ -735,19 +756,16 @@ function startWoodMain(options) {
         windows.clear();
       };
       const runBeforeQuitCleanup = async () => {
-        await (0, import_renderer_trace_drain_coordinator.drainRendererTracesBeforeQuit)(
-          rendererTraceDrain,
-          windows.values(),
-          logger,
-          Date.now() + 1e3
-        );
-        (0, import_shared.clearIpcPushSender)();
-        if (mainBootCleanup) {
-          await mainBootCleanup();
-        }
-        if (options.onBeforeQuit) {
-          await options.onBeforeQuit(runtimeContext);
-        }
+        await (0, import_cleanup.cleanupAll)([
+          () => (0, import_renderer_trace_drain_coordinator.drainRendererTracesBeforeQuit)(rendererTraceDrain, windows.values(), logger, Date.now() + 1e3),
+          () => runtimeCleanup?.(),
+          () => {
+            if (options.legacyGlobals) (0, import_shared.clearIpcPushSender)();
+          },
+          () => mainBootCleanup?.(),
+          () => options.onBeforeQuit?.(runtimeContext),
+          () => import_ioc.ExecutionContext.run(container, () => container.dispose())
+        ], "Wood main shutdown failed");
       };
       import_electron.app.on("before-quit", (event) => {
         if (!runtimeContext) {
@@ -783,13 +801,13 @@ function startWoodMain(options) {
     };
     registerApplicationLifecycle();
   };
-  void initializeRuntime().catch((error) => {
-    rendererTraceDrain.stop();
-    logger.error("startup failed before ready", {
-      message: toErrorMessage(error),
-      stack: error instanceof Error ? error.stack : void 0
-    });
-  });
+  void initializeRuntime().catch((error) => startupFailure.handle(
+    "startup failed before ready",
+    error,
+    async () => {
+      rendererTraceDrain.stop();
+    }
+  ));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {