Function createDebugController

packages/core/src/debug/debugController.ts:371–753

(options: CreateDebugControllerOptions = {})

 * Create a debug controller instance.
 */
export function createDebugController(options: CreateDebugControllerOptions = {}): DebugController {
  const backend = options.backend ?? NULL_BACKEND;
  const terminalCapsProvider = options.terminalCapsProvider;
  const frameInspector = createFrameInspector(options.maxFrames);
  const eventTrace = createEventTrace(options.maxEvents);
  const errorAggregator = createErrorAggregator();
  const stateTimeline = createStateTimeline(options.maxStateChanges);

  let isEnabled = false;
  let currentConfig: DebugConfig | null = null;
  const recordHandlers: Set<DebugRecordHandler> = new Set();

  function notifyRecordHandlers(record: DebugRecord): void {
    for (const handler of recordHandlers) {
      try {
        handler(record);
      } catch {
        // Ignore handler errors
      }
    }
  }

  async function resolveTerminalCaps(
    override: TerminalCaps | null | undefined,
  ): Promise<TerminalCaps | null> {
    if (override !== undefined) return override;
    if (!terminalCapsProvider) return null;
    try {
      return (await terminalCapsProvider()) ?? null;
    } catch {
      return null;
    }
  }

  async function enable(config?: Partial<DebugConfig>): Promise<void> {
    const fullConfig: DebugConfig = {
      enabled: true,
      ...(config?.ringCapacity !== undefined && { ringCapacity: config.ringCapacity }),
      ...(config?.minSeverity !== undefined && { minSeverity: config.minSeverity }),
      ...(config?.categoryMask !== undefined && { categoryMask: config.categoryMask }),
      ...(config?.captureRawEvents !== undefined && { captureRawEvents: config.captureRawEvents }),
      ...(config?.captureDrawlistBytes !== undefined && {
        captureDrawlistBytes: config.captureDrawlistBytes,
      }),
    };

    await backend.debugEnable(fullConfig);
    isEnabled = true;
    currentConfig = fullConfig;
  }

  async function disable(): Promise<void> {
    await backend.debugDisable();
    isEnabled = false;
    currentConfig = null;
  }

  async function reset(): Promise<void> {