@noego/wood 0.4.9 → 0.5.0

package/dist/frontend/work_registry.d.cts

@@ -0,0 +1,70 @@
+/**
+ * Owned-work registry for the frontend application slice (18A D-FAS-01).
+ *
+ * `act()` and `settle()` drain framework-owned finite work registered here
+ * through production seams (transport invokes, event deliveries, navigation
+ * transitions, tracked lifecycle tasks). The registry never patches global
+ * async primitives and never guesses at event-loop emptiness: work exists
+ * only because an owner registered it, and a drain is a fixed point —
+ * repeated passes until one complete pass creates no new owned work.
+ *
+ * Floating promises and bare timers are explicitly outside the guarantee;
+ * they are product lifecycle bugs, not framework blind spots to paper over.
+ */
+type WorkKind = 'invoke' | 'event-delivery' | 'navigation' | 'initialize' | 'tracked' | (string & {});
+interface WorkOptions {
+    /** Human-readable diagnostic label, e.g. `invoke messages.send`. */
+    label: string;
+    kind?: WorkKind;
+    /** Owning lifecycle identity, e.g. `page main.chat_dom` or `application`. */
+    owner?: string;
+}
+interface WorkDescriptor {
+    readonly id: number;
+    readonly label: string;
+    readonly kind: WorkKind;
+    readonly owner: string;
+}
+interface WorkFailure extends WorkDescriptor {
+    readonly error: unknown;
+}
+declare class FrontendWorkError extends Error {
+    readonly failures: readonly WorkFailure[];
+    constructor(message: string, failures?: readonly WorkFailure[]);
+}
+declare class WorkRegistry {
+    private nextId;
+    /** Total registrations ever — the fixed-point signal for draining. */
+    private registrations;
+    private readonly inFlight;
+    private readonly failures;
+    /** How many failures a completed drain has already reported. */
+    private reportedFailures;
+    private drainChain;
+    /**
+     * Register finite owned work. Returns a promise with the work's own
+     * settlement semantics — callers may await it directly; the registry
+     * additionally observes completion (success or failure) for draining.
+     */
+    track<T>(work: Promise<T> | (() => Promise<T>), options: WorkOptions): Promise<T>;
+    /** Descriptors of currently incomplete owned work. */
+    pending(): WorkDescriptor[];
+    /** Every owned-work failure observed so far (accumulates across drains). */
+    errors(): readonly WorkFailure[];
+    /**
+     * Fixed-point drain: await all pending owned work, run the adapter flush
+     * hooks, repeat until one full pass observes no pending work and causes
+     * no new registrations. Concurrent drains queue — each caller gets its
+     * own complete pass over whatever work exists when its turn arrives.
+     *
+     * Rejects with `FrontendWorkError` naming the owners when owned work
+     * failed since the previous drain, or when the pass bound is exceeded
+     * (repeating owned work), listing pending and repeating labels.
+     */
+    drain(flushHooks?: ReadonlyArray<() => void | Promise<void>>): Promise<void>;
+    private drainOnce;
+    private takeNewFailures;
+    private throwNewFailures;
+}
+
+export { FrontendWorkError, type WorkDescriptor, type WorkFailure, type WorkKind, type WorkOptions, WorkRegistry };

package/dist/frontend/work_registry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Owned-work registry for the frontend application slice (18A D-FAS-01).
+ *
+ * `act()` and `settle()` drain framework-owned finite work registered here
+ * through production seams (transport invokes, event deliveries, navigation
+ * transitions, tracked lifecycle tasks). The registry never patches global
+ * async primitives and never guesses at event-loop emptiness: work exists
+ * only because an owner registered it, and a drain is a fixed point —
+ * repeated passes until one complete pass creates no new owned work.
+ *
+ * Floating promises and bare timers are explicitly outside the guarantee;
+ * they are product lifecycle bugs, not framework blind spots to paper over.
+ */
+type WorkKind = 'invoke' | 'event-delivery' | 'navigation' | 'initialize' | 'tracked' | (string & {});
+interface WorkOptions {
+    /** Human-readable diagnostic label, e.g. `invoke messages.send`. */
+    label: string;
+    kind?: WorkKind;
+    /** Owning lifecycle identity, e.g. `page main.chat_dom` or `application`. */
+    owner?: string;
+}
+interface WorkDescriptor {
+    readonly id: number;
+    readonly label: string;
+    readonly kind: WorkKind;
+    readonly owner: string;
+}
+interface WorkFailure extends WorkDescriptor {
+    readonly error: unknown;
+}
+declare class FrontendWorkError extends Error {
+    readonly failures: readonly WorkFailure[];
+    constructor(message: string, failures?: readonly WorkFailure[]);
+}
+declare class WorkRegistry {
+    private nextId;
+    /** Total registrations ever — the fixed-point signal for draining. */
+    private registrations;
+    private readonly inFlight;
+    private readonly failures;
+    /** How many failures a completed drain has already reported. */
+    private reportedFailures;
+    private drainChain;
+    /**
+     * Register finite owned work. Returns a promise with the work's own
+     * settlement semantics — callers may await it directly; the registry
+     * additionally observes completion (success or failure) for draining.
+     */
+    track<T>(work: Promise<T> | (() => Promise<T>), options: WorkOptions): Promise<T>;
+    /** Descriptors of currently incomplete owned work. */
+    pending(): WorkDescriptor[];
+    /** Every owned-work failure observed so far (accumulates across drains). */
+    errors(): readonly WorkFailure[];
+    /**
+     * Fixed-point drain: await all pending owned work, run the adapter flush
+     * hooks, repeat until one full pass observes no pending work and causes
+     * no new registrations. Concurrent drains queue — each caller gets its
+     * own complete pass over whatever work exists when its turn arrives.
+     *
+     * Rejects with `FrontendWorkError` naming the owners when owned work
+     * failed since the previous drain, or when the pass bound is exceeded
+     * (repeating owned work), listing pending and repeating labels.
+     */
+    drain(flushHooks?: ReadonlyArray<() => void | Promise<void>>): Promise<void>;
+    private drainOnce;
+    private takeNewFailures;
+    private throwNewFailures;
+}
+
+export { FrontendWorkError, type WorkDescriptor, type WorkFailure, type WorkKind, type WorkOptions, WorkRegistry };

package/dist/frontend/work_registry.js

@@ -0,0 +1,128 @@
+const MAX_DRAIN_PASSES = 100;
+class FrontendWorkError extends Error {
+  constructor(message, failures = []) {
+    super(message);
+    this.failures = failures;
+    this.name = "FrontendWorkError";
+  }
+}
+function describe(work) {
+  return `[${work.kind}] ${work.label} (owner: ${work.owner})`;
+}
+class WorkRegistry {
+  constructor() {
+    this.nextId = 1;
+    /** Total registrations ever — the fixed-point signal for draining. */
+    this.registrations = 0;
+    this.inFlight = /* @__PURE__ */ new Map();
+    this.failures = [];
+    /** How many failures a completed drain has already reported. */
+    this.reportedFailures = 0;
+    this.drainChain = Promise.resolve();
+  }
+  /**
+   * Register finite owned work. Returns a promise with the work's own
+   * settlement semantics — callers may await it directly; the registry
+   * additionally observes completion (success or failure) for draining.
+   */
+  track(work, options) {
+    const descriptor = {
+      id: this.nextId++,
+      label: options.label,
+      kind: options.kind ?? "tracked",
+      owner: options.owner ?? "application"
+    };
+    this.registrations += 1;
+    const promise = typeof work === "function" ? work() : work;
+    const observed = promise.then(
+      () => void 0,
+      (error) => {
+        this.failures.push({ ...descriptor, error });
+      }
+    ).finally(() => {
+      this.inFlight.delete(descriptor.id);
+    });
+    this.inFlight.set(descriptor.id, { descriptor, observed });
+    return promise;
+  }
+  /** Descriptors of currently incomplete owned work. */
+  pending() {
+    return [...this.inFlight.values()].map((entry) => entry.descriptor);
+  }
+  /** Every owned-work failure observed so far (accumulates across drains). */
+  errors() {
+    return [...this.failures];
+  }
+  /**
+   * Fixed-point drain: await all pending owned work, run the adapter flush
+   * hooks, repeat until one full pass observes no pending work and causes
+   * no new registrations. Concurrent drains queue — each caller gets its
+   * own complete pass over whatever work exists when its turn arrives.
+   *
+   * Rejects with `FrontendWorkError` naming the owners when owned work
+   * failed since the previous drain, or when the pass bound is exceeded
+   * (repeating owned work), listing pending and repeating labels.
+   */
+  drain(flushHooks = []) {
+    const run = this.drainChain.then(() => this.drainOnce(flushHooks));
+    this.drainChain = run.then(
+      () => void 0,
+      () => void 0
+    );
+    return run;
+  }
+  async drainOnce(flushHooks) {
+    const seenPerLabel = /* @__PURE__ */ new Map();
+    for (let pass = 1; pass <= MAX_DRAIN_PASSES; pass++) {
+      const registrationsBefore = this.registrations;
+      const snapshot = [...this.inFlight.values()];
+      for (const { descriptor } of snapshot) {
+        seenPerLabel.set(descriptor.label, (seenPerLabel.get(descriptor.label) ?? 0) + 1);
+      }
+      await Promise.all(snapshot.map((entry) => entry.observed));
+      for (const hook of flushHooks) {
+        await hook();
+      }
+      await Promise.resolve();
+      await Promise.resolve();
+      const stable = this.inFlight.size === 0 && this.registrations === registrationsBefore;
+      if (stable) {
+        this.throwNewFailures();
+        return;
+      }
+    }
+    const pendingLines = this.pending().map(describe);
+    const repeating = [...seenPerLabel.entries()].filter(([, count]) => count > 3).map(([label, count]) => `${label} (seen in ${count} passes)`);
+    throw new FrontendWorkError(
+      `settle did not converge within ${MAX_DRAIN_PASSES} drain passes.
+` + (pendingLines.length ? `Still pending:
+  ${pendingLines.join("\n  ")}
+` : "") + (repeating.length ? `Repeating owned work:
+  ${repeating.join("\n  ")}
+` : "") + "Owned work keeps creating more owned work \u2014 this names the owners; it is not a timeout.",
+      this.takeNewFailures()
+    );
+  }
+  takeNewFailures() {
+    const fresh = this.failures.slice(this.reportedFailures);
+    this.reportedFailures = this.failures.length;
+    return fresh;
+  }
+  throwNewFailures() {
+    const fresh = this.takeNewFailures();
+    if (!fresh.length) return;
+    const lines = fresh.map(
+      (failure) => `${describe(failure)}: ${failure.error instanceof Error ? failure.error.message : String(failure.error)}`
+    );
+    throw new FrontendWorkError(
+      `owned frontend work failed:
+  ${lines.join("\n  ")}`,
+      fresh
+    );
+  }
+}
+export {
+  FrontendWorkError,
+  WorkRegistry
+};
+//# sourceMappingURL=work_registry.js.map

package/dist/frontend/work_registry.js.map

@@ -0,0 +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":[]}

package/dist/index.cjs

@@ -28,6 +28,7 @@ __export(index_exports, {
   MainTracer: () => import_tracing.MainTracer,
   MiddlewareResolver: () => import_middleware.MiddlewareResolver,
   Navigation: () => import_navigation.Navigation,
+  RENDERER_TRACE_BATCHING_DEFAULTS: () => import_config.RENDERER_TRACE_BATCHING_DEFAULTS,
   RendererTracer: () => import_tracing.RendererTracer,
   SchemaValidator: () => import_validation.SchemaValidator,
   TestTracer: () => import_tracing.TestTracer,
@@ -40,13 +41,16 @@ __export(index_exports, {
   WindowStateStore: () => import_window.WindowStateStore,
   WoodAuthError: () => import_types.WoodAuthError,
   WoodRouter: () => import_router.WoodRouter,
+  WoodTraceBatchContract: () => import_tracing.WoodTraceBatchContract,
   WoodValidationError: () => import_types.WoodValidationError,
   buildControllerArgs: () => import_controller.buildControllerArgs,
   buildMiddlewareContext: () => import_middleware.buildMiddlewareContext,
+  buildOperationContext: () => import_controller.buildOperationContext,
   clearApplicationRootForTests: () => import_runtime.clearApplicationRootForTests,
   clearContainerRegistryForTests: () => import_runtime.clearContainerRegistryForTests,
   clearRendererTraceBatchReceiverForTests: () => import_runtime.clearRendererTraceBatchReceiverForTests,
   clearTraceHubForTests: () => import_tracing.clearTraceHubForTests,
+  createWoodRoot: () => import_runtime.createWoodRoot,
   disposeControllerLifecycle: () => import_controller.disposeControllerLifecycle,
   executeMiddleware: () => import_middleware.executeMiddleware,
   generateChannelMap: () => import_codegen3.generateChannelMap,
@@ -64,18 +68,24 @@ __export(index_exports, {
   getNavigation: () => import_navigation.getNavigation,
   getRendererTraceBatchReceiver: () => import_runtime.getRendererTraceBatchReceiver,
   getTraceEvents$: () => import_tracing.getTraceEvents$,
+  getTraceProducerId: () => import_tracing.getTraceProducerId,
   go: () => import_navigation.go,
   goback: () => import_navigation.goback,
   goto: () => import_navigation.goto,
+  ingestRemoteTraceEvent: () => import_tracing.ingestRemoteTraceEvent,
   parseConfig: () => import_config.parseConfig,
   parseOperations: () => import_parser.parseOperations,
+  parseOperationsDocument: () => import_parser.parseOperationsDocument,
   parseOperationsFile: () => import_parser.parseOperationsFile,
   parseViews: () => import_parser2.parseViews,
   parseViewsFile: () => import_parser2.parseViewsFile,
+  publishMainTrace: () => import_tracing.publishMainTrace,
+  publishTestTrace: () => import_tracing.publishTestTrace,
   pushEvent: () => import_bridge.pushEvent,
   readWoodDevMetadata: () => import_dev_metadata.readWoodDevMetadata,
   registerTraceSink: () => import_tracing.registerTraceSink,
   removeWoodDevMetadata: () => import_dev_metadata.removeWoodDevMetadata,
+  resolveRendererTraceBatching: () => import_config.resolveRendererTraceBatching,
   resolveWoodDevDirectory: () => import_dev_metadata.resolveWoodDevDirectory,
   resolveWoodDevMetadataPath: () => import_dev_metadata.resolveWoodDevMetadataPath,
   resolveWoodRemoteDebuggingPort: () => import_dev_metadata.resolveWoodRemoteDebuggingPort,
@@ -85,6 +95,8 @@ __export(index_exports, {
   setRendererTraceEnabled: () => import_tracing.setRendererTraceEnabled,
   setRendererTraceTransport: () => import_tracing.setRendererTraceTransport,
   startBackendLoop: () => import_bridge.startBackendLoop,
+  usesOperationContext: () => import_controller.usesOperationContext,
+  woodBatchToTraceBatch: () => import_tracing.woodBatchToTraceBatch,
   writeWoodDevMetadata: () => import_dev_metadata.writeWoodDevMetadata
 });
 module.exports = __toCommonJS(index_exports);
@@ -125,6 +137,7 @@ var import_tracing = require("./tracing/index.js");
   MainTracer,
   MiddlewareResolver,
   Navigation,
+  RENDERER_TRACE_BATCHING_DEFAULTS,
   RendererTracer,
   SchemaValidator,
   TestTracer,
@@ -137,13 +150,16 @@ var import_tracing = require("./tracing/index.js");
   WindowStateStore,
   WoodAuthError,
   WoodRouter,
+  WoodTraceBatchContract,
   WoodValidationError,
   buildControllerArgs,
   buildMiddlewareContext,
+  buildOperationContext,
   clearApplicationRootForTests,
   clearContainerRegistryForTests,
   clearRendererTraceBatchReceiverForTests,
   clearTraceHubForTests,
+  createWoodRoot,
   disposeControllerLifecycle,
   executeMiddleware,
   generateChannelMap,
@@ -161,18 +177,24 @@ var import_tracing = require("./tracing/index.js");
   getNavigation,
   getRendererTraceBatchReceiver,
   getTraceEvents$,
+  getTraceProducerId,
   go,
   goback,
   goto,
+  ingestRemoteTraceEvent,
   parseConfig,
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile,
   parseViews,
   parseViewsFile,
+  publishMainTrace,
+  publishTestTrace,
   pushEvent,
   readWoodDevMetadata,
   registerTraceSink,
   removeWoodDevMetadata,
+  resolveRendererTraceBatching,
   resolveWoodDevDirectory,
   resolveWoodDevMetadataPath,
   resolveWoodRemoteDebuggingPort,
@@ -182,6 +204,8 @@ var import_tracing = require("./tracing/index.js");
   setRendererTraceEnabled,
   setRendererTraceTransport,
   startBackendLoop,
+  usesOperationContext,
+  woodBatchToTraceBatch,
   writeWoodDevMetadata
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.cjs';\n\n// Config\nexport { parseConfig } from './config/index.cjs';\n\n// Parsers\nexport { parseOperations, parseOperationsFile } from './parser/index.cjs';\nexport { parseViews, parseViewsFile } from './parser/index.cjs';\n\n// Router\nexport { WoodRouter } from './router/index.cjs';\n\n// Validation\nexport { SchemaValidator } from './validation/index.cjs';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.cjs';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from './controller/index.cjs';\nexport type { ControllerLifecycle } from './controller/index.cjs';\n\n// Codegen\nexport { generatePreload } from './codegen/index.cjs';\nexport { generateTypes } from './codegen/index.cjs';\nexport { generateChannelMap } from './codegen/index.cjs';\nexport { generateTestMock } from './codegen/index.cjs';\nexport { generateControllerRegistration } from './codegen/index.cjs';\nexport type { ControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRuntime } from './codegen/index.cjs';\nexport type { RuntimeGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererViewManifest } from './codegen/index.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererControllerRegistration } from './codegen/index.cjs';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRendererApp } from './codegen/index.cjs';\nexport type { RendererAppGeneratorOptions } from './codegen/index.cjs';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.cjs';\nexport type { ScreenLike, WindowBounds } from './window/index.cjs';\n\n// Loader\nexport { LoaderRunner } from './loader/index.cjs';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.cjs';\n\n// Dev metadata (lightweight; safe at runtime)\n// Heavy dev tooling (WoodDevServer, BackendWatcher, YamlWatcher,\n// EsbuildBackend) is available via the '@noego/wood/dev' subpath only,\n// so production consumers never load esbuild/chokidar.\nexport {\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/dev_metadata.js';\nexport type { WoodDevMetadata } from './dev/dev_metadata.js';\n\n// Runtime\nexport {\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  runtime,\n  setRendererTraceBatchReceiver,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.cjs';\nexport type { NavigationEntry, NavigationOptions } from './navigation/index.cjs';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.cjs';\nexport type { IpcPushOptions } from './ipc/index.cjs';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCommitWriter,\n  clearTraceHubForTests,\n  getTraceEvents$,\n  registerTraceSink,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n} from './tracing/index.js';\nexport type {\n  TraceCommitRow,\n  TraceCommitWriterOptions,\n  TraceFlushOptions,\n  TraceFlushResult,\n  WoodTracePersistencePort,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntimeContext,\n  TraceRuntime,\n  TraceWaitOptions,\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCA,mBAA2E;AAG3E,oBAA4B;AAG5B,oBAAqD;AACrD,IAAAA,iBAA2C;AAG3C,oBAA2B;AAG3B,wBAAgC;AAGhC,wBAA8E;AAG9E,wBAAoF;AAIpF,qBAAgC;AAChC,IAAAC,kBAA8B;AAC9B,IAAAA,kBAAmC;AACnC,IAAAA,kBAAiC;AACjC,IAAAA,kBAA+C;AAE/C,IAAAA,kBAAgC;AAEhC,IAAAA,kBAA6C;AAE7C,IAAAA,kBAAuD;AAEvD,IAAAA,kBAAoC;AAIpC,oBAAgD;AAIhD,oBAA6B;AAG7B,oBAA2D;AAM3D,0BAUO;AAIP,qBAUO;AASP,wBAA4D;AAI5D,iBAA4B;AAI5B,qBAaO;","names":["import_parser","import_codegen"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types/index.cjs';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.cjs';\n\n// Config\nexport {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config/index.cjs';\nexport type { ObservabilityConfig, RendererTraceBatchingConfig } from './config/index.cjs';\n\n// Parsers\nexport { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/index.cjs';\nexport { parseViews, parseViewsFile } from './parser/index.cjs';\n\n// Router\nexport { WoodRouter } from './router/index.cjs';\n\n// Validation\nexport { SchemaValidator } from './validation/index.cjs';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.cjs';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext, disposeControllerLifecycle } from './controller/index.cjs';\nexport type { ControllerLifecycle } from './controller/index.cjs';\n\n// Codegen\nexport { generatePreload } from './codegen/index.cjs';\nexport { generateTypes } from './codegen/index.cjs';\nexport { generateChannelMap } from './codegen/index.cjs';\nexport { generateTestMock } from './codegen/index.cjs';\nexport { generateControllerRegistration } from './codegen/index.cjs';\nexport type { ControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRuntime } from './codegen/index.cjs';\nexport type { RuntimeGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererViewManifest } from './codegen/index.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererControllerRegistration } from './codegen/index.cjs';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRendererApp } from './codegen/index.cjs';\nexport type { RendererAppGeneratorOptions } from './codegen/index.cjs';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.cjs';\nexport type { ScreenLike, WindowBounds } from './window/index.cjs';\n\n// Loader\nexport { LoaderRunner } from './loader/index.cjs';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.cjs';\n\n// Dev metadata (lightweight; safe at runtime)\n// Heavy dev tooling (WoodDevServer, BackendWatcher, YamlWatcher,\n// EsbuildBackend) is available via the '@noego/wood/dev' subpath only,\n// so production consumers never load esbuild/chokidar.\nexport {\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/dev_metadata.js';\nexport type { WoodDevMetadata } from './dev/dev_metadata.js';\n\n// Runtime\nexport {\n  createWoodRoot,\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  runtime,\n  setRendererTraceBatchReceiver,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime/index.cjs';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.cjs';\nexport type { NavigationEntry, NavigationOptions } from './navigation/index.cjs';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.cjs';\nexport type { IpcPushOptions } from './ipc/index.cjs';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCommitWriter,\n  clearTraceHubForTests,\n  getTraceEvents$,\n  getTraceProducerId,\n  ingestRemoteTraceEvent,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n  woodBatchToTraceBatch,\n  WoodTraceBatchContract,\n} from './tracing/index.js';\nexport type { WoodTraceBatchConversion } from './tracing/index.js';\nexport type {\n  TraceCommitRow,\n  TraceCommitWriterOptions,\n  TraceFlushOptions,\n  TraceFlushResult,\n  WoodTracePersistencePort,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntimeContext,\n  TraceRuntime,\n  TraceWaitOptions,\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCA,mBAA2E;AAG3E,oBAIO;AAIP,oBAA8E;AAC9E,IAAAA,iBAA2C;AAG3C,oBAA2B;AAG3B,wBAAgC;AAGhC,wBAA8E;AAG9E,wBAAiI;AAIjI,qBAAgC;AAChC,IAAAC,kBAA8B;AAC9B,IAAAA,kBAAmC;AACnC,IAAAA,kBAAiC;AACjC,IAAAA,kBAA+C;AAE/C,IAAAA,kBAAgC;AAEhC,IAAAA,kBAA6C;AAE7C,IAAAA,kBAAuD;AAEvD,IAAAA,kBAAoC;AAIpC,oBAAgD;AAIhD,oBAA6B;AAG7B,oBAA2D;AAM3D,0BAUO;AAIP,qBAWO;AASP,wBAA4D;AAI5D,iBAA4B;AAI5B,qBAmBO;","names":["import_parser","import_codegen"]}

package/dist/index.d.cts

@@ -1,17 +1,17 @@
-export { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig } from './types/config.cjs';
+export { DevConfig, ElectronBuilderConfig, ObservabilityConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig } from './types/config.cjs';
 export { OperationDef, RawModuleDef, RawModuleOperationEntry, RawOperationEntry, RawOperationsDocument } from './types/operations.cjs';
 export { ParameterDef, RawViewEntry, RawViewsDocument, ViewDef } from './types/views.cjs';
 export { ControllerArgs, IpcContext, LoaderResult, RequestData, WoodMiddlewareContext, WoodMiddlewareFn } from './types/context.cjs';
 export { BackendRestartingError, BridgeElectronApi, BridgeMessage, BridgePush, BridgeReady, BridgeRequest, BridgeResponse, SerializedError, WoodAuthError, WoodValidationError } from './types/bridge.cjs';
 export { ContextMenuContext, ContextMenuEvent, ContextMenuItem } from './types/context_menu.cjs';
-export { parseConfig } from './config/config_parser.cjs';
-export { parseOperations, parseOperationsFile } from './parser/operations_parser.cjs';
+export { RENDERER_TRACE_BATCHING_DEFAULTS, parseConfig, resolveRendererTraceBatching } from './config/config_parser.cjs';
+export { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/operations_parser.cjs';
 export { parseViews, parseViewsFile } from './parser/views_parser.cjs';
 export { WoodRouter } from './router/wood_router.cjs';
 export { SchemaValidator } from './validation/schema_validator.cjs';
 export { MiddlewareResolver } from './middleware/middleware_resolver.cjs';
 export { buildMiddlewareContext, executeMiddleware } from './middleware/middleware_pipeline.cjs';
-export { ControllerResolver, buildControllerArgs } from './controller/controller_resolver.cjs';
+export { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext } from './controller/controller_resolver.cjs';
 export { ControllerLifecycle, disposeControllerLifecycle } from './controller/controller_lifecycle.cjs';
 export { generatePreload } from './codegen/preload_generator.cjs';
 export { generateTypes } from './codegen/type_generator.cjs';
@@ -28,18 +28,22 @@ export { LoaderRunner } from './loader/loader_runner.cjs';
 export { BackendBridge } from './bridge/backend_bridge.cjs';
 export { pushEvent, startBackendLoop } from './bridge/backend_entry.cjs';
 export { DEFAULT_WOOD_REMOTE_DEBUGGING_PORT, WOOD_DEV_DIRECTORY, WOOD_DEV_METADATA_BASENAME, WoodDevMetadata, readWoodDevMetadata, removeWoodDevMetadata, resolveWoodDevDirectory, resolveWoodDevMetadataPath, resolveWoodRemoteDebuggingPort, writeWoodDevMetadata } from './dev/dev_metadata.cjs';
-export { GetContainerOptions, clearContainerRegistryForTests, getContainer } from './runtime/get_container.cjs';
+export { GetContainerOptions, clearContainerRegistryForTests, createWoodRoot, getContainer } from './runtime/get_container.cjs';
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './runtime/application_root.cjs';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime/runtime.cjs';
 export { clearRendererTraceBatchReceiverForTests, getRendererTraceBatchReceiver, setRendererTraceBatchReceiver } from './runtime/renderer_trace_batch_receiver_registry.cjs';
-export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer, i as clearTraceHubForTests, j as getTraceEvents$, r as registerTraceSink, s as setRendererTraceEnabled, k as setRendererTraceTransport } from './trace_hub-Cob54qRx.cjs';
+export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer, i as clearTraceHubForTests, j as getTraceEvents$, k as getTraceProducerId, l as ingestRemoteTraceEvent, p as publishMainTrace, m as publishTestTrace, r as registerTraceSink, s as setRendererTraceEnabled, n as setRendererTraceTransport } from './trace_hub-Cpo_nVze.cjs';
+export { WoodTraceBatchConversion, woodBatchToTraceBatch } from './tracing/trace_batch_adapter.cjs';
 export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchReceiver, WoodTraceBatchRuntimeContext } from './tracing/types/wood_trace_batch.types.cjs';
+export { WoodTraceBatchContract } from './tracing/wood_trace_batch_contract.cjs';
 export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlushOptions, TraceFlushResult, WoodTracePersistencePort } from './tracing/trace_commit_writer.cjs';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.cjs';
 export { Navigation, NavigationEntry, NavigationOptions, getNavigation, go, goback, goto } from './navigation/index.cjs';
 export { Ipc, getIpc } from './ipc/index.cjs';
 export { IpcPushOptions } from './ipc/shared.cjs';
+import '@noego/ioc';
 import './runtime/app_env.cjs';
 import 'rxjs';
+import '@noego/trace';
 import '@noego/telemetry/core';
-import '@noego/ioc';
+import './navigation/automation_introspection.cjs';

package/dist/index.d.ts

@@ -1,17 +1,17 @@
-export { DevConfig, ElectronBuilderConfig, WindowDef, WoodConfig } from './types/config.js';
+export { DevConfig, ElectronBuilderConfig, ObservabilityConfig, RendererTraceBatchingConfig, WindowDef, WoodConfig } from './types/config.js';
 export { OperationDef, RawModuleDef, RawModuleOperationEntry, RawOperationEntry, RawOperationsDocument } from './types/operations.js';
 export { ParameterDef, RawViewEntry, RawViewsDocument, ViewDef } from './types/views.js';
 export { ControllerArgs, IpcContext, LoaderResult, RequestData, WoodMiddlewareContext, WoodMiddlewareFn } from './types/context.js';
 export { BackendRestartingError, BridgeElectronApi, BridgeMessage, BridgePush, BridgeReady, BridgeRequest, BridgeResponse, SerializedError, WoodAuthError, WoodValidationError } from './types/bridge.js';
 export { ContextMenuContext, ContextMenuEvent, ContextMenuItem } from './types/context_menu.js';
-export { parseConfig } from './config/config_parser.js';
-export { parseOperations, parseOperationsFile } from './parser/operations_parser.js';
+export { RENDERER_TRACE_BATCHING_DEFAULTS, parseConfig, resolveRendererTraceBatching } from './config/config_parser.js';
+export { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/operations_parser.js';
 export { parseViews, parseViewsFile } from './parser/views_parser.js';
 export { WoodRouter } from './router/wood_router.js';
 export { SchemaValidator } from './validation/schema_validator.js';
 export { MiddlewareResolver } from './middleware/middleware_resolver.js';
 export { buildMiddlewareContext, executeMiddleware } from './middleware/middleware_pipeline.js';
-export { ControllerResolver, buildControllerArgs } from './controller/controller_resolver.js';
+export { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext } from './controller/controller_resolver.js';
 export { ControllerLifecycle, disposeControllerLifecycle } from './controller/controller_lifecycle.js';
 export { generatePreload } from './codegen/preload_generator.js';
 export { generateTypes } from './codegen/type_generator.js';
@@ -28,18 +28,22 @@ export { LoaderRunner } from './loader/loader_runner.js';
 export { BackendBridge } from './bridge/backend_bridge.js';
 export { pushEvent, startBackendLoop } from './bridge/backend_entry.js';
 export { DEFAULT_WOOD_REMOTE_DEBUGGING_PORT, WOOD_DEV_DIRECTORY, WOOD_DEV_METADATA_BASENAME, WoodDevMetadata, readWoodDevMetadata, removeWoodDevMetadata, resolveWoodDevDirectory, resolveWoodDevMetadataPath, resolveWoodRemoteDebuggingPort, writeWoodDevMetadata } from './dev/dev_metadata.js';
-export { GetContainerOptions, clearContainerRegistryForTests, getContainer } from './runtime/get_container.js';
+export { GetContainerOptions, clearContainerRegistryForTests, createWoodRoot, getContainer } from './runtime/get_container.js';
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './runtime/application_root.js';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime/runtime.js';
 export { clearRendererTraceBatchReceiverForTests, getRendererTraceBatchReceiver, setRendererTraceBatchReceiver } from './runtime/renderer_trace_batch_receiver_registry.js';
-export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer, i as clearTraceHubForTests, j as getTraceEvents$, r as registerTraceSink, s as setRendererTraceEnabled, k as setRendererTraceTransport } from './trace_hub-Cob54qRx.js';
+export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, c as TraceLevel, d as TraceProcess, e as TraceRuntimeContext, f as TraceWaitOptions, W as WoodTraceEventSink, g as WoodTraceEventSnapshot, h as WoodTraceSinkDisposer, i as clearTraceHubForTests, j as getTraceEvents$, k as getTraceProducerId, l as ingestRemoteTraceEvent, p as publishMainTrace, m as publishTestTrace, r as registerTraceSink, s as setRendererTraceEnabled, n as setRendererTraceTransport } from './trace_hub-Cpo_nVze.js';
+export { WoodTraceBatchConversion, woodBatchToTraceBatch } from './tracing/trace_batch_adapter.js';
 export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchReceiver, WoodTraceBatchRuntimeContext } from './tracing/types/wood_trace_batch.types.js';
+export { WoodTraceBatchContract } from './tracing/wood_trace_batch_contract.js';
 export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlushOptions, TraceFlushResult, WoodTracePersistencePort } from './tracing/trace_commit_writer.js';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.js';
 export { Navigation, NavigationEntry, NavigationOptions, getNavigation, go, goback, goto } from './navigation/index.js';
 export { Ipc, getIpc } from './ipc/index.js';
 export { IpcPushOptions } from './ipc/shared.js';
+import '@noego/ioc';
 import './runtime/app_env.js';
 import 'rxjs';
+import '@noego/trace';
 import '@noego/telemetry/core';
-import '@noego/ioc';
+import './navigation/automation_introspection.js';

package/dist/index.js

@@ -1,11 +1,15 @@
 import { WoodAuthError, WoodValidationError, BackendRestartingError } from "./types/index.js";
-import { parseConfig } from "./config/index.js";
-import { parseOperations, parseOperationsFile } from "./parser/index.js";
+import {
+  parseConfig,
+  resolveRendererTraceBatching,
+  RENDERER_TRACE_BATCHING_DEFAULTS
+} from "./config/index.js";
+import { parseOperations, parseOperationsDocument, parseOperationsFile } from "./parser/index.js";
 import { parseViews, parseViewsFile } from "./parser/index.js";
 import { WoodRouter } from "./router/index.js";
 import { SchemaValidator } from "./validation/index.js";
 import { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from "./middleware/index.js";
-import { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from "./controller/index.js";
+import { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext, disposeControllerLifecycle } from "./controller/index.js";
 import { generatePreload } from "./codegen/index.js";
 import { generateTypes } from "./codegen/index.js";
 import { generateChannelMap } from "./codegen/index.js";
@@ -30,6 +34,7 @@ import {
   removeWoodDevMetadata
 } from "./dev/dev_metadata.js";
 import {
+  createWoodRoot,
   getContainer,
   clearContainerRegistryForTests,
   getApplicationRoot,
@@ -52,9 +57,15 @@ import {
   TraceCommitWriter,
   clearTraceHubForTests,
   getTraceEvents$,
+  getTraceProducerId,
+  ingestRemoteTraceEvent,
+  publishMainTrace,
+  publishTestTrace,
   registerTraceSink,
   setRendererTraceEnabled,
-  setRendererTraceTransport
+  setRendererTraceTransport,
+  woodBatchToTraceBatch,
+  WoodTraceBatchContract
 } from "./tracing/index.js";
 export {
   BackendBridge,
@@ -67,6 +78,7 @@ export {
   MainTracer,
   MiddlewareResolver,
   Navigation,
+  RENDERER_TRACE_BATCHING_DEFAULTS,
   RendererTracer,
   SchemaValidator,
   TestTracer,
@@ -79,13 +91,16 @@ export {
   WindowStateStore,
   WoodAuthError,
   WoodRouter,
+  WoodTraceBatchContract,
   WoodValidationError,
   buildControllerArgs,
   buildMiddlewareContext,
+  buildOperationContext,
   clearApplicationRootForTests,
   clearContainerRegistryForTests,
   clearRendererTraceBatchReceiverForTests,
   clearTraceHubForTests,
+  createWoodRoot,
   disposeControllerLifecycle,
   executeMiddleware,
   generateChannelMap,
@@ -103,18 +118,24 @@ export {
   getNavigation,
   getRendererTraceBatchReceiver,
   getTraceEvents$,
+  getTraceProducerId,
   go,
   goback,
   goto,
+  ingestRemoteTraceEvent,
   parseConfig,
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile,
   parseViews,
   parseViewsFile,
+  publishMainTrace,
+  publishTestTrace,
   pushEvent,
   readWoodDevMetadata,
   registerTraceSink,
   removeWoodDevMetadata,
+  resolveRendererTraceBatching,
   resolveWoodDevDirectory,
   resolveWoodDevMetadataPath,
   resolveWoodRemoteDebuggingPort,
@@ -124,6 +145,8 @@ export {
   setRendererTraceEnabled,
   setRendererTraceTransport,
   startBackendLoop,
+  usesOperationContext,
+  woodBatchToTraceBatch,
   writeWoodDevMetadata
 };
 //# sourceMappingURL=index.js.map