@noego/wood 0.4.1 → 0.4.2

package/dist/tracing/trace_provider.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  createTraceCapture,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceCapture,\n  type TraceCaptureOptions,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return createTraceCapture(options);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return this.resolveImplementation().capture(options);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_provider.d.cts

@@ -1,4 +1,4 @@
-import { TraceProcess, TraceEvent, TraceInput, TraceCaptureOptions, TraceCapture, TraceLevel } from './trace_hub.cjs';
+import { TraceProcess, TraceEvent, TraceInput, TraceLevel } from './trace_hub.cjs';
 import { IContainer } from '@noego/ioc';
 import { Observable } from 'rxjs';
 
@@ -14,7 +14,6 @@ declare abstract class FrameworkTracer {
     abstract warn(event: TraceInput): void;
     abstract error(event: TraceInput): void;
     extend(context: TraceContext): FrameworkTracer;
-    capture(options?: TraceCaptureOptions): TraceCapture;
 }
 declare class TraceProviderConfiguration {
     private mode;
@@ -72,7 +71,6 @@ declare class TraceProvider extends FrameworkTracer {
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
     error(event: TraceInput): void;
-    capture(options?: TraceCaptureOptions): TraceCapture;
     private resolveImplementation;
     private resolveSync;
 }

package/dist/tracing/trace_provider.d.ts

@@ -1,4 +1,4 @@
-import { TraceProcess, TraceEvent, TraceInput, TraceCaptureOptions, TraceCapture, TraceLevel } from './trace_hub.js';
+import { TraceProcess, TraceEvent, TraceInput, TraceLevel } from './trace_hub.js';
 import { IContainer } from '@noego/ioc';
 import { Observable } from 'rxjs';
 
@@ -14,7 +14,6 @@ declare abstract class FrameworkTracer {
     abstract warn(event: TraceInput): void;
     abstract error(event: TraceInput): void;
     extend(context: TraceContext): FrameworkTracer;
-    capture(options?: TraceCaptureOptions): TraceCapture;
 }
 declare class TraceProviderConfiguration {
     private mode;
@@ -72,7 +71,6 @@ declare class TraceProvider extends FrameworkTracer {
     info(event: TraceInput): void;
     warn(event: TraceInput): void;
     error(event: TraceInput): void;
-    capture(options?: TraceCaptureOptions): TraceCapture;
     private resolveImplementation;
     private resolveSync;
 }

package/dist/tracing/trace_provider.js

@@ -11,7 +11,6 @@ var __decorateClass = (decorators, target, key, kind) => {
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER } from "@noego/ioc";
 import {
-  createTraceCapture,
   emitRendererTrace,
   getTraceEvents$,
   publishMainTrace,
@@ -24,9 +23,6 @@ class FrameworkTracer {
   extend(context) {
     return new ContextualTracer(this, context);
   }
-  capture(options = {}) {
-    return createTraceCapture(options);
-  }
 }
 class ContextualTracer extends FrameworkTracer {
   constructor(parent, context) {
@@ -214,9 +210,6 @@ let TraceProvider = class extends FrameworkTracer {
   error(event) {
     this.resolveImplementation().error(event);
   }
-  capture(options = {}) {
-    return this.resolveImplementation().capture(options);
-  }
   resolveImplementation() {
     const mode = this.configuration.getMode();
     if (mode === "test") {

package/dist/tracing/trace_provider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  createTraceCapture,\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceCapture,\n  type TraceCaptureOptions,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return createTraceCapture(options);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  capture(options: TraceCaptureOptions = {}): TraceCapture {\n    return this.resolveImplementation().capture(options);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_provider.ts"],"sourcesContent":["import { Component, Inject, LoadAs, Provider, SCOPED_CONTAINER, type IContainer } from '@noego/ioc';\nimport type { Observable } from 'rxjs';\nimport {\n  emitRendererTrace,\n  getTraceEvents$,\n  publishMainTrace,\n  publishTestTrace,\n  setMainTraceMinLevel,\n  setRendererTraceEnabled,\n  setRendererTraceMinLevel,\n  type TraceEvent,\n  type TraceInput,\n  type TraceLevel,\n  type TraceProcess,\n} from './trace_hub.js';\n\nexport type TraceProviderMode = 'live' | 'test';\nexport type TraceRuntime = 'main' | 'renderer' | 'test';\nexport type TraceContext = Partial<TraceInput>;\n\nexport abstract class FrameworkTracer {\n  abstract readonly mode: TraceProviderMode;\n  abstract readonly process: TraceProcess;\n  abstract readonly events$: Observable<TraceEvent>;\n  abstract debug(event: TraceInput): void;\n  abstract info(event: TraceInput): void;\n  abstract warn(event: TraceInput): void;\n  abstract error(event: TraceInput): void;\n\n  extend(context: TraceContext): FrameworkTracer {\n    return new ContextualTracer(this, context);\n  }\n}\n\nclass ContextualTracer extends FrameworkTracer {\n  constructor(\n    private readonly parent: FrameworkTracer,\n    private readonly context: TraceContext,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.parent.mode;\n  }\n\n  get process(): TraceProcess {\n    return this.parent.process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.parent.events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.parent.debug(this.mergeEvent(event));\n  }\n\n  info(event: TraceInput): void {\n    this.parent.info(this.mergeEvent(event));\n  }\n\n  warn(event: TraceInput): void {\n    this.parent.warn(this.mergeEvent(event));\n  }\n\n  error(event: TraceInput): void {\n    this.parent.error(this.mergeEvent(event));\n  }\n\n  private mergeEvent(event: TraceInput): TraceInput {\n    return {\n      ...this.context,\n      ...event,\n    };\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceProviderConfiguration {\n  private mode: TraceProviderMode = 'live';\n  private runtime: TraceRuntime = 'main';\n  private minLevel: TraceLevel = 'debug';\n  private enabled: boolean | null = null;\n\n  configureMode(mode: TraceProviderMode): void {\n    this.mode = mode;\n  }\n\n  configureRuntime(runtime: TraceRuntime): void {\n    this.runtime = runtime;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureMinLevel(level: TraceLevel): void {\n    this.minLevel = level;\n    this.applyRuntimeConfiguration();\n  }\n\n  configureEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n    this.applyRuntimeConfiguration();\n  }\n\n  getMode(): TraceProviderMode {\n    return this.mode;\n  }\n\n  getRuntime(): TraceRuntime {\n    return this.runtime;\n  }\n\n  getMinLevel(): TraceLevel {\n    return this.minLevel;\n  }\n\n  getEnabled(): boolean {\n    return this.enabled ?? (this.runtime === 'renderer' ? false : true);\n  }\n\n  private applyRuntimeConfiguration(): void {\n    if (this.runtime === 'renderer') {\n      setRendererTraceEnabled(this.getEnabled());\n      setRendererTraceMinLevel(this.minLevel);\n      return;\n    }\n\n    setMainTraceMinLevel(this.minLevel);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class MainTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'main' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    publishMainTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    publishMainTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    publishMainTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    publishMainTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class RendererTracer extends FrameworkTracer {\n  readonly mode = 'live' as const;\n  readonly process = 'renderer' as const;\n  readonly events$ = getTraceEvents$();\n\n  debug(event: TraceInput): void {\n    emitRendererTrace('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    emitRendererTrace('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    emitRendererTrace('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    emitRendererTrace('error', event);\n  }\n}\n\n@Component({ scope: LoadAs.Singleton })\nexport class TestTracer extends FrameworkTracer {\n  readonly mode = 'test' as const;\n  readonly events$ = getTraceEvents$();\n\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n  ) {\n    super();\n  }\n\n  get process(): TraceProcess {\n    const runtime = this.configuration.getRuntime();\n    if (runtime === 'renderer') return 'renderer';\n    if (runtime === 'main') return 'main';\n    return 'test';\n  }\n\n  debug(event: TraceInput): void {\n    this.publish('debug', event);\n  }\n\n  info(event: TraceInput): void {\n    this.publish('info', event);\n  }\n\n  warn(event: TraceInput): void {\n    this.publish('warn', event);\n  }\n\n  error(event: TraceInput): void {\n    this.publish('error', event);\n  }\n\n  private publish(level: TraceLevel, event: TraceInput): void {\n    publishTestTrace(this.process, level, event);\n  }\n}\n\n@Provider()\nexport class TraceProvider extends FrameworkTracer {\n  constructor(\n    @Inject(TraceProviderConfiguration) private readonly configuration: TraceProviderConfiguration,\n    @Inject(SCOPED_CONTAINER) private readonly container: IContainer,\n  ) {\n    super();\n  }\n\n  get mode(): TraceProviderMode {\n    return this.resolveImplementation().mode;\n  }\n\n  get process(): TraceProcess {\n    return this.resolveImplementation().process;\n  }\n\n  get events$(): Observable<TraceEvent> {\n    return this.resolveImplementation().events$;\n  }\n\n  debug(event: TraceInput): void {\n    this.resolveImplementation().debug(event);\n  }\n\n  info(event: TraceInput): void {\n    this.resolveImplementation().info(event);\n  }\n\n  warn(event: TraceInput): void {\n    this.resolveImplementation().warn(event);\n  }\n\n  error(event: TraceInput): void {\n    this.resolveImplementation().error(event);\n  }\n\n  private resolveImplementation(): FrameworkTracer {\n    const mode = this.configuration.getMode();\n    if (mode === 'test') {\n      return this.resolveSync(TestTracer);\n    }\n\n    if (this.configuration.getRuntime() === 'renderer') {\n      return this.resolveSync(RendererTracer);\n    }\n\n    return this.resolveSync(MainTracer);\n  }\n\n  private resolveSync<T>(token: new (...args: any[]) => T): T {\n    const resolved = this.container.instance<T, true>(token);\n    if (resolved instanceof Promise) {\n      throw new Error(`${token.name} must resolve synchronously`);\n    }\n    return resolved;\n  }\n}\n"],"mappings":"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","names":[]}

package/docs/browser-testing.md

@@ -162,6 +162,90 @@ bridge, for example `settings.get` or `messages.send`. Static values are
 returned directly. Functions receive the operation input and a small context
 with the channel and recorded calls.
 
+## Tracing Browser Scenarios
+
+Use browser-harness tracing when the behavior under test is a renderer pipeline:
+route/controller selection, repeated work, resize or animation timing,
+stream/reconcile order, bridge calls, or any case where the final DOM is not
+enough to prove what happened.
+
+Enable tracing on the harness with `trace.enabled`. The harness creates a
+`TraceRecorder`, installs the renderer trace bridge, and exposes the recorder as
+`harness.traceRecorder`.
+
+```ts
+import { browser } from '@noego/wood/testing';
+
+const harness = await browser.createHarness({
+  rootDir: process.cwd(),
+  componentDir: 'ui',
+  css: ['ui/app.css'],
+  trace: {
+    enabled: true,
+    harnessId: 'settings-panel-test',
+    windowId: 'settings-window',
+    maxEvents: 500,
+  },
+});
+
+try {
+  const mounted = await harness.mountComponent('ui/SettingsPanel.svelte');
+
+  await mounted.page.evaluate(() => {
+    window.wood.__trace({
+      source: 'settings.panel',
+      type: 'settings.panel.rendered',
+      payload: { tab: 'appearance' },
+    });
+  });
+
+  await expect(harness.traceRecorder?.waitForTrace({
+    type: 'settings.panel.rendered',
+    harnessId: 'settings-panel-test',
+  })).resolves.toMatchObject({
+    process: 'renderer',
+    payload: { tab: 'appearance' },
+  });
+
+  const trace = harness.traceRecorder?.query();
+  trace?.expectOnce({ type: 'settings.panel.rendered' });
+} finally {
+  await harness.destroy();
+}
+```
+
+Renderer trace events are forwarded through the Wood bridge into the same trace
+stream used by main-process and test-process events. The resulting events keep
+their `process` field, so tests can assert whether an event came from
+`renderer`, `main`, or `test`.
+
+Useful options:
+
+- `enabled`: turns on renderer forwarding and creates `harness.traceRecorder`.
+- `harnessId`: tags events from this test so assertions can filter them.
+- `windowId`: tags events with a stable window identity.
+- `maxEvents`: caps the in-memory recorder buffer.
+- `minLevel`: filters lower-level trace events before they reach the recorder.
+
+Use `harness.traceRecorder?.query()` for counts, ordered sequences, payload
+checks, and negative assertions:
+
+```ts
+const trace = harness.traceRecorder?.query();
+
+trace?.expectSequence([
+  { type: 'transcript.projection.started' },
+  { type: 'transcript.projection.completed', 'payload.changedRows': 2 },
+]);
+trace?.expectNone({ type: 'transcript.projection.failed' });
+expect(trace?.count({ type: 'transcript.scroll-plan' })).toBeLessThanOrEqual(1);
+```
+
+For Node-only controller tests, use the controller harness' `traceRecorder` or
+resolve `TraceRecorder` from the test container, call `enable()`, run the
+subject, then assert against `traceRecorder.query()`. For browser harness tests,
+prefer the `trace` harness config because it also wires renderer forwarding.
+
 ## Assertions
 
 Every mounted surface exposes Playwright's `page` and `locator`, plus

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -102,6 +102,7 @@
     "@noego/ioc": "^0.3.1",
     "@noego/logger": "^0.0.2",
     "@noego/stitch": "^1.0.3",
+    "@noego/trace": "^0.0.2",
     "ajv": "^8.x",
     "ajv-formats": "^3.x",
     "chokidar": "^4.x",

package/dist/trace-testing/trace_scenario.cjs

@@ -1,61 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var trace_scenario_exports = {};
-__export(trace_scenario_exports, {
-  createTraceScenario: () => createTraceScenario
-});
-module.exports = __toCommonJS(trace_scenario_exports);
-var import_trace_assertions = require("./trace_assertions.js");
-var import_trace_query = require("./trace_query.js");
-function createTraceScenario(options) {
-  const { trace, artifactPath, ...captureOptions } = options;
-  const capture = trace.capture(captureOptions);
-  const assertions = (0, import_trace_assertions.createTraceAssertions)(() => capture.events());
-  return {
-    capture,
-    trace: assertions,
-    async run(exercise) {
-      try {
-        return await exercise({
-          waitForTrace: (filter, waitOptions) => capture.waitFor((event) => (0, import_trace_query.matchesTrace)(event, filter), waitOptions),
-          trace: assertions
-        });
-      } catch (error) {
-        if (artifactPath) {
-          await capture.writeArtifact(artifactPath).catch(() => void 0);
-        }
-        throw error;
-      }
-    },
-    stop() {
-      capture.stop();
-    },
-    async writeArtifact(targetPath = artifactPath) {
-      if (!targetPath) {
-        throw new Error("Trace artifact path was not provided.");
-      }
-      await capture.writeArtifact(targetPath);
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createTraceScenario
-});
-//# sourceMappingURL=trace_scenario.cjs.map

package/dist/trace-testing/trace_scenario.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/trace-testing/trace_scenario.ts"],"sourcesContent":["import type { FrameworkTracer, TraceCapture, TraceCaptureOptions, TraceEvent } from '../tracing/index.js';\nimport { createTraceAssertions, type TraceAssertions } from './trace_assertions.js';\nimport { matchesTrace, type TraceFilter } from './trace_query.js';\n\nexport type TraceScenarioOptions = TraceCaptureOptions & {\n  trace: FrameworkTracer;\n  artifactPath?: string;\n};\n\nexport type TraceScenarioRunContext = {\n  waitForTrace(filter: TraceFilter, options?: { timeoutMs?: number }): Promise<TraceEvent>;\n  trace: TraceAssertions;\n};\n\nexport type TraceScenario = {\n  readonly capture: TraceCapture;\n  readonly trace: TraceAssertions;\n  run<T>(exercise: (context: TraceScenarioRunContext) => T | Promise<T>): Promise<T>;\n  stop(): void;\n  writeArtifact(targetPath?: string): Promise<void>;\n};\n\nexport function createTraceScenario(options: TraceScenarioOptions): TraceScenario {\n  const { trace, artifactPath, ...captureOptions } = options;\n  const capture = trace.capture(captureOptions);\n  const assertions = createTraceAssertions(() => capture.events());\n\n  return {\n    capture,\n    trace: assertions,\n    async run(exercise) {\n      try {\n        return await exercise({\n          waitForTrace: (filter, waitOptions) =>\n            capture.waitFor((event) => matchesTrace(event, filter), waitOptions),\n          trace: assertions,\n        });\n      } catch (error) {\n        if (artifactPath) {\n          await capture.writeArtifact(artifactPath).catch(() => undefined);\n        }\n        throw error;\n      }\n    },\n    stop() {\n      capture.stop();\n    },\n    async writeArtifact(targetPath = artifactPath): Promise<void> {\n      if (!targetPath) {\n        throw new Error('Trace artifact path was not provided.');\n      }\n      await capture.writeArtifact(targetPath);\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,8BAA4D;AAC5D,yBAA+C;AAoBxC,SAAS,oBAAoB,SAA8C;AAChF,QAAM,EAAE,OAAO,cAAc,GAAG,eAAe,IAAI;AACnD,QAAM,UAAU,MAAM,QAAQ,cAAc;AAC5C,QAAM,iBAAa,+CAAsB,MAAM,QAAQ,OAAO,CAAC;AAE/D,SAAO;AAAA,IACL;AAAA,IACA,OAAO;AAAA,IACP,MAAM,IAAI,UAAU;AAClB,UAAI;AACF,eAAO,MAAM,SAAS;AAAA,UACpB,cAAc,CAAC,QAAQ,gBACrB,QAAQ,QAAQ,CAAC,cAAU,iCAAa,OAAO,MAAM,GAAG,WAAW;AAAA,UACrE,OAAO;AAAA,QACT,CAAC;AAAA,MACH,SAAS,OAAO;AACd,YAAI,cAAc;AAChB,gBAAM,QAAQ,cAAc,YAAY,EAAE,MAAM,MAAM,MAAS;AAAA,QACjE;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,OAAO;AACL,cAAQ,KAAK;AAAA,IACf;AAAA,IACA,MAAM,cAAc,aAAa,cAA6B;AAC5D,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,uCAAuC;AAAA,MACzD;AACA,YAAM,QAAQ,cAAc,UAAU;AAAA,IACxC;AAAA,EACF;AACF;","names":[]}

package/dist/trace-testing/trace_scenario.d.cts

@@ -1,27 +0,0 @@
-import { TraceFilter } from './trace_query.cjs';
-import { TraceAssertions } from './trace_assertions.cjs';
-import { TraceCapture, TraceEvent, TraceCaptureOptions } from '../tracing/trace_hub.cjs';
-import { FrameworkTracer } from '../tracing/trace_provider.cjs';
-import 'rxjs';
-import '@noego/ioc';
-
-type TraceScenarioOptions = TraceCaptureOptions & {
-    trace: FrameworkTracer;
-    artifactPath?: string;
-};
-type TraceScenarioRunContext = {
-    waitForTrace(filter: TraceFilter, options?: {
-        timeoutMs?: number;
-    }): Promise<TraceEvent>;
-    trace: TraceAssertions;
-};
-type TraceScenario = {
-    readonly capture: TraceCapture;
-    readonly trace: TraceAssertions;
-    run<T>(exercise: (context: TraceScenarioRunContext) => T | Promise<T>): Promise<T>;
-    stop(): void;
-    writeArtifact(targetPath?: string): Promise<void>;
-};
-declare function createTraceScenario(options: TraceScenarioOptions): TraceScenario;
-
-export { type TraceScenario, type TraceScenarioOptions, type TraceScenarioRunContext, createTraceScenario };

package/dist/trace-testing/trace_scenario.d.ts

@@ -1,27 +0,0 @@
-import { TraceFilter } from './trace_query.js';
-import { TraceAssertions } from './trace_assertions.js';
-import { TraceCapture, TraceEvent, TraceCaptureOptions } from '../tracing/trace_hub.js';
-import { FrameworkTracer } from '../tracing/trace_provider.js';
-import 'rxjs';
-import '@noego/ioc';
-
-type TraceScenarioOptions = TraceCaptureOptions & {
-    trace: FrameworkTracer;
-    artifactPath?: string;
-};
-type TraceScenarioRunContext = {
-    waitForTrace(filter: TraceFilter, options?: {
-        timeoutMs?: number;
-    }): Promise<TraceEvent>;
-    trace: TraceAssertions;
-};
-type TraceScenario = {
-    readonly capture: TraceCapture;
-    readonly trace: TraceAssertions;
-    run<T>(exercise: (context: TraceScenarioRunContext) => T | Promise<T>): Promise<T>;
-    stop(): void;
-    writeArtifact(targetPath?: string): Promise<void>;
-};
-declare function createTraceScenario(options: TraceScenarioOptions): TraceScenario;
-
-export { type TraceScenario, type TraceScenarioOptions, type TraceScenarioRunContext, createTraceScenario };

package/dist/trace-testing/trace_scenario.js

@@ -1,37 +0,0 @@
-import { createTraceAssertions } from "./trace_assertions.js";
-import { matchesTrace } from "./trace_query.js";
-function createTraceScenario(options) {
-  const { trace, artifactPath, ...captureOptions } = options;
-  const capture = trace.capture(captureOptions);
-  const assertions = createTraceAssertions(() => capture.events());
-  return {
-    capture,
-    trace: assertions,
-    async run(exercise) {
-      try {
-        return await exercise({
-          waitForTrace: (filter, waitOptions) => capture.waitFor((event) => matchesTrace(event, filter), waitOptions),
-          trace: assertions
-        });
-      } catch (error) {
-        if (artifactPath) {
-          await capture.writeArtifact(artifactPath).catch(() => void 0);
-        }
-        throw error;
-      }
-    },
-    stop() {
-      capture.stop();
-    },
-    async writeArtifact(targetPath = artifactPath) {
-      if (!targetPath) {
-        throw new Error("Trace artifact path was not provided.");
-      }
-      await capture.writeArtifact(targetPath);
-    }
-  };
-}
-export {
-  createTraceScenario
-};
-//# sourceMappingURL=trace_scenario.js.map

package/dist/trace-testing/trace_scenario.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/trace-testing/trace_scenario.ts"],"sourcesContent":["import type { FrameworkTracer, TraceCapture, TraceCaptureOptions, TraceEvent } from '../tracing/index.js';\nimport { createTraceAssertions, type TraceAssertions } from './trace_assertions.js';\nimport { matchesTrace, type TraceFilter } from './trace_query.js';\n\nexport type TraceScenarioOptions = TraceCaptureOptions & {\n  trace: FrameworkTracer;\n  artifactPath?: string;\n};\n\nexport type TraceScenarioRunContext = {\n  waitForTrace(filter: TraceFilter, options?: { timeoutMs?: number }): Promise<TraceEvent>;\n  trace: TraceAssertions;\n};\n\nexport type TraceScenario = {\n  readonly capture: TraceCapture;\n  readonly trace: TraceAssertions;\n  run<T>(exercise: (context: TraceScenarioRunContext) => T | Promise<T>): Promise<T>;\n  stop(): void;\n  writeArtifact(targetPath?: string): Promise<void>;\n};\n\nexport function createTraceScenario(options: TraceScenarioOptions): TraceScenario {\n  const { trace, artifactPath, ...captureOptions } = options;\n  const capture = trace.capture(captureOptions);\n  const assertions = createTraceAssertions(() => capture.events());\n\n  return {\n    capture,\n    trace: assertions,\n    async run(exercise) {\n      try {\n        return await exercise({\n          waitForTrace: (filter, waitOptions) =>\n            capture.waitFor((event) => matchesTrace(event, filter), waitOptions),\n          trace: assertions,\n        });\n      } catch (error) {\n        if (artifactPath) {\n          await capture.writeArtifact(artifactPath).catch(() => undefined);\n        }\n        throw error;\n      }\n    },\n    stop() {\n      capture.stop();\n    },\n    async writeArtifact(targetPath = artifactPath): Promise<void> {\n      if (!targetPath) {\n        throw new Error('Trace artifact path was not provided.');\n      }\n      await capture.writeArtifact(targetPath);\n    },\n  };\n}\n"],"mappings":"AACA,SAAS,6BAAmD;AAC5D,SAAS,oBAAsC;AAoBxC,SAAS,oBAAoB,SAA8C;AAChF,QAAM,EAAE,OAAO,cAAc,GAAG,eAAe,IAAI;AACnD,QAAM,UAAU,MAAM,QAAQ,cAAc;AAC5C,QAAM,aAAa,sBAAsB,MAAM,QAAQ,OAAO,CAAC;AAE/D,SAAO;AAAA,IACL;AAAA,IACA,OAAO;AAAA,IACP,MAAM,IAAI,UAAU;AAClB,UAAI;AACF,eAAO,MAAM,SAAS;AAAA,UACpB,cAAc,CAAC,QAAQ,gBACrB,QAAQ,QAAQ,CAAC,UAAU,aAAa,OAAO,MAAM,GAAG,WAAW;AAAA,UACrE,OAAO;AAAA,QACT,CAAC;AAAA,MACH,SAAS,OAAO;AACd,YAAI,cAAc;AAChB,gBAAM,QAAQ,cAAc,YAAY,EAAE,MAAM,MAAM,MAAS;AAAA,QACjE;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,OAAO;AACL,cAAQ,KAAK;AAAA,IACf;AAAA,IACA,MAAM,cAAc,aAAa,cAA6B;AAC5D,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,uCAAuC;AAAA,MACzD;AACA,YAAM,QAAQ,cAAc,UAAU;AAAA,IACxC;AAAA,EACF;AACF;","names":[]}