framefields 2.13.1 → 2.14.0

package/dist/{index-DQ1U3HC3.d.mts.map → index-C7-p9zwU.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-DQ1U3HC3.d.mts","names":["pino","DestinationStream","VideoColorPrimaries","VideoFrame","VideoMatrixCoefficients","VideoTransferCharacteristics","AudioMix","RenderDiagnostic","VirtualMediaData","VideoSampleSource","preloadFonts","GPUDevice","Promise","FrameCostSample","ChunkPlanOptions","PlannedChunk","ChunkPlan","planChunks","StagingSlotStatus","VideoColorSpaceConfig","DmaStagingRingOptions","GPUTextureFormat","StagingSlotInfo","DmaStagingRing","GPUCommandEncoder","GPUTexture","Uint8Array","findNodesDir","discoverAndRegisterNodeRenderers","RenderPhase","RenderProgress","VideoQaOptions","QaSegment","QaIssue","VideoQaStats","AudioQaStats","VideoQaReport","FrameInspector","analyzeAudio","Float32Array","integratedLoudness","buildQaReport","formatQaReport","RenderSemaphore","renderSemaphore","FrameRange","HeadlessWebGPURenderer","Buffer","AbortSignal","HeadlessMediaRenderer","resetRenderCaches","resolveLogFormat","Record","textLogStream","rendererLogger","Logger","NODE_KINDS","NodeKind","NodeRendererExports","NodeManifest","NodeManifestError","Error","parseNodeManifest","loadNodeManifests","StitchOptions","StitchResult","stitchChunks","ZeroCopyWebCodecsPipelineOptions","WebCodecsPipelineStats","ZeroCopyWebCodecsPipeline"],"sources":["../../renderer/dist/index.d.mts","../src/renderer/framegrid.ts"],"sourcesContent":["import pino, { DestinationStream } from \"pino\";\nimport { VideoColorPrimaries, VideoFrame, VideoMatrixCoefficients, VideoTransferCharacteristics } from \"@napi-rs/webcodecs\";\nimport { AudioMix } from \"@framefields/compositions\";\nimport { RenderDiagnostic, VirtualMediaData } from \"@framefields/core\";\nimport { VideoSampleSource } from \"mediabunny\";\n\n//#region src/asset-preloader.d.ts\n/**\n * Preloads only the fonts (and emoji) a VirtualMediaData tree's text uses, so\n * typography renders correctly on Node.js without loading its media. Shared\n * with the browser preview; emoji need a font set with\n * `FontManager.registerEmojiFont()`.\n */\ndeclare function preloadFonts(media: VirtualMediaData, device?: GPUDevice | null): Promise<void>;\n//#endregion\n//#region src/chunk-plan.d.ts\n/**\n * Plans a render split across workers: how many chunks, and where each one\n * starts and ends. Pure arithmetic over measured frame costs, so it runs\n * anywhere (a worker's probe job, a coordinator, a local script).\n *\n * Every chunk pays a fixed cost before its first frame (worker start, fetch,\n * install, composition build). `workers: \"auto\"` adds workers only while each\n * chunk still spends at least `efficiency` of its time rendering, so a short\n * film stays on one worker and a long one spreads out until `maxWorkers`.\n * Chunks are cut at equal render cost, not equal frame counts, so a heavy\n * stretch (3D, vision) gets shorter chunks.\n */\n/** A measured render time for one frame. */\ninterface FrameCostSample {\n  frame: number;\n  ms: number;\n}\ninterface ChunkPlanOptions {\n  /** Frames in the composition. */\n  totalFrames: number;\n  /** Measured frame times; between samples the cost is interpolated linearly. */\n  samples: readonly FrameCostSample[];\n  /** A worker count, or `\"auto\"` to pick one from the cost. Default 1. */\n  workers?: number | \"auto\";\n  /** Upper bound for `\"auto\"` (and for a number). Default 10. */\n  maxWorkers?: number;\n  /** Fixed cost each chunk pays before rendering, in seconds. Default 90 (a cold start). */\n  overheadSec?: number;\n  /**\n   * `\"auto\"` only: the smallest share of a chunk's time spent rendering,\n   * between 0 and 1. Default 0.85: each chunk renders at least\n   * `overheadSec × 0.85 / 0.15` (about 5.7× the overhead).\n   */\n  efficiency?: number;\n  /** No chunk is shorter than this many frames. Default 60. */\n  minChunkFrames?: number;\n}\ninterface PlannedChunk {\n  /** First frame (inclusive). */\n  start: number;\n  /** Last frame (exclusive). */\n  end: number;\n  /** Estimated render time of its frames, in seconds. */\n  workSec: number;\n}\ninterface ChunkPlan {\n  workers: number;\n  /** Estimated render time of the whole composition on one worker, without overhead. */\n  workSec: number;\n  /** Estimated wall time with this plan: overhead plus the longest chunk. */\n  etaSec: number;\n  chunks: PlannedChunk[];\n}\ndeclare function planChunks(options: ChunkPlanOptions): ChunkPlan;\n//#endregion\n//#region src/dma-staging-ring.d.ts\ntype StagingSlotStatus = \"idle\" | \"rendering\" | \"mapping\" | \"mapped\";\ninterface VideoColorSpaceConfig {\n  readonly primaries?: VideoColorPrimaries;\n  readonly transfer?: VideoTransferCharacteristics;\n  readonly matrix?: VideoMatrixCoefficients;\n  readonly fullRange?: boolean;\n}\ninterface DmaStagingRingOptions {\n  readonly width: number;\n  readonly height: number;\n  readonly capacity?: number;\n  readonly format?: GPUTextureFormat;\n}\ninterface StagingSlotInfo {\n  readonly index: number;\n  readonly status: StagingSlotStatus;\n  readonly inFlightFrame: number | null;\n}\n/**\n * Pipelined Asynchronous DMA Staging Ring for WebGPU.\n *\n * Implements double-buffered (or N-buffered) GPU staging buffers to overlap\n * GPU render passes with asynchronous DMA host transfers and WebCodecs hardware encoding.\n * Eliminates GPU stalls by allowing Frame i+1 to execute on the GPU while Frame i\n * is asynchronously mapped and consumed by the hardware video encoder.\n */\ndeclare class DmaStagingRing {\n  readonly width: number;\n  readonly height: number;\n  readonly capacity: number;\n  readonly bytesPerRow: number;\n  readonly unpaddedBytesPerRow: number;\n  readonly bufferSize: number;\n  readonly format: GPUTextureFormat;\n  readonly device: GPUDevice;\n  private readonly slots;\n  private isDestroyed;\n  constructor(device: GPUDevice, options: DmaStagingRingOptions);\n  /**\n   * Prepares the staging buffer slot for writing by ensuring any prior mapping\n   * from a previous cycle has been completed and unmapped.\n   */\n  prepareSlot(frameIndex: number): Promise<void>;\n  /**\n   * Records a GPU-to-buffer DMA copy command into the provided command encoder.\n   */\n  stageTexture(encoder: GPUCommandEncoder, texture: GPUTexture, frameIndex: number): void;\n  /**\n   * Initiates asynchronous DMA mapping on the slot for the specified frame.\n   * Must be called immediately after submitting the command encoder to the device queue.\n   */\n  scheduleMap(frameIndex: number): Promise<void>;\n  /**\n   * Awaits asynchronous mapping and extracts pixels into a tightly packed Uint8Array.\n   * The slot remains in the \"mapped\" state until releaseFrame() is called.\n   */\n  readFramePixels(frameIndex: number): Promise<Uint8Array>;\n  /**\n   * Awaits asynchronous mapping, extracts pixels, and immediately unmaps the staging buffer,\n   * returning the slot to \"idle\" state so it can be reused immediately.\n   */\n  readAndReleaseFrame(frameIndex: number): Promise<Uint8Array>;\n  /**\n   * Directly reads the mapped staging buffer into a WebCodecs VideoFrame,\n   * bypassing redundant intermediate JS allocations when row pitches align,\n   * and immediately unmaps the buffer.\n   */\n  readFrameToVideoFrame(frameIndex: number, timestampUs: number, colorSpace?: VideoColorSpaceConfig, /** Sees the tightly packed RGBA pixels while they are mapped; must not keep them. */\n  inspect?: (rgba: Uint8Array) => void): Promise<VideoFrame>;\n  /**\n   * Unmaps the staging buffer for the specified frame and marks the slot idle.\n   */\n  releaseFrame(frameIndex: number): void;\n  /**\n   * Returns current status info for each slot in the ring.\n   */\n  getSlotInfos(): readonly StagingSlotInfo[];\n  /**\n   * Destroys all staging buffers and releases resources.\n   */\n  destroy(): void;\n  private checkDestroyed;\n}\n//#endregion\n//#region src/dynamic-node-discovery.d.ts\n/** Locates the workspace `nodes/` directory by climbing up from this file. */\ndeclare function findNodesDir(startDir?: string): string | null;\n/**\n * Registers the built-in node renderers, then any extra nodes found in the\n * directory named by `FRAMEFIELDS_NODES_DIR` (local node development). A node in\n * that directory overrides the built-in renderer for the same op.\n */\ndeclare function discoverAndRegisterNodeRenderers(): Promise<void>;\n//#endregion\n//#region src/render-reporter.d.ts\n/**\n * Stages of `renderVideo`, in order. Audio-only renders skip \"render\";\n * \"convert\" runs only for GIF output.\n */\ntype RenderPhase = \"prepare\" | \"render\" | \"audio\" | \"audio-encode\" | \"mux\" | \"convert\" | \"done\";\n/** Progress reported by `renderVideo({ onProgress })`. */\ninterface RenderProgress {\n  /**\n   * \"prepare\" loads fonts and warms the pipeline, \"render\" draws and encodes\n   * frames, \"audio\" mixes the soundtrack, \"audio-encode\" encodes it, \"mux\"\n   * writes the container, \"convert\" makes the GIF, \"done\" is the last event.\n   */\n  phase: RenderPhase;\n  /** Frames finished so far (1-based); `totalFrames` once frames are done. */\n  frame: number;\n  totalFrames: number;\n  /** Time since the render started. */\n  elapsedMs: number;\n  /** Share of the current phase done (0–1), when it can be measured. */\n  phaseProgress?: number;\n  /** Frames per second so far (\"render\" only). */\n  fps?: number;\n  /** Estimated seconds until the frames are done (\"render\" only). */\n  etaSec?: number;\n  /** What the phase is working on, e.g. \"3/7 sources: music.mp3\". */\n  detail?: string;\n}\n//#endregion\n//#region src/video-qa.d.ts\n/**\n * Quality checks run on a video while it renders: frames are measured as\n * they are read back for the encoder and audio as it is mixed, so the report\n * describes exactly what was encoded without decoding the file again.\n */\ninterface VideoQaOptions {\n  /** Luma (0-1) at or below which a pixel counts as black. Default 0.1. */\n  readonly blackPixelThreshold?: number;\n  /** Share of black pixels that makes a frame black. Default 0.98. */\n  readonly blackFrameRatio?: number;\n  /** Shortest run of black frames reported. Default 0.5 s. */\n  readonly minBlackSec?: number;\n  /** Shortest run of unchanging frames reported. Default 2 s. */\n  readonly minFrozenSec?: number;\n  /** Level (dBFS, 100 ms windows) below which audio counts as silent. Default -60. */\n  readonly silenceDbfs?: number;\n  /** Shortest silent stretch reported. Default 2 s. */\n  readonly minSilenceSec?: number;\n  /** Integrated loudness to hit, e.g. -14 for most streaming platforms. Unchecked when unset. */\n  readonly targetLufs?: number;\n  /** Allowed distance from `targetLufs`, in LU. Default 1. */\n  readonly lufsTolerance?: number;\n}\ninterface QaSegment {\n  readonly startSec: number;\n  readonly endSec: number;\n}\ninterface QaIssue {\n  readonly severity: \"error\" | \"warning\" | \"info\";\n  /** Stable machine-readable kind, e.g. \"black_frames\", \"audio_clipping\" */\n  readonly code: string;\n  readonly message: string;\n  readonly startSec?: number;\n  readonly endSec?: number;\n  readonly layerId?: string;\n}\ninterface VideoQaStats {\n  readonly expectedFrames: number;\n  readonly encodedFrames: number;\n  readonly fps: number;\n  readonly width: number;\n  readonly height: number;\n  /** Average luma over the whole video, 0-1 */\n  readonly meanLuma: number;\n  readonly blackSegments: readonly QaSegment[];\n  readonly frozenSegments: readonly QaSegment[];\n}\ninterface AudioQaStats {\n  readonly sampleRate: number;\n  readonly channels: number;\n  readonly durationSec: number;\n  /** Highest sample, dBFS (sample peak, not true peak) */\n  readonly peakDbfs: number;\n  /** Mean level over the whole track, dBFS */\n  readonly rmsDbfs: number;\n  /** ITU-R BS.1770 integrated loudness; null when the track is silent */\n  readonly integratedLufs: number | null;\n  /** Samples at or beyond full scale */\n  readonly clippedSamples: number;\n  readonly silentSegments: readonly QaSegment[];\n}\ninterface VideoQaReport {\n  /** No errors or warnings (info issues do not fail a render) */\n  readonly passed: boolean;\n  readonly video?: VideoQaStats;\n  readonly audio?: AudioQaStats;\n  readonly issues: readonly QaIssue[];\n}\n/** Measures frames handed to it in order, as RGBA bytes. */\ndeclare class FrameInspector {\n  private readonly blackLuma;\n  private readonly blackRatio;\n  private readonly black;\n  private readonly sameAsPrevious;\n  private lumaSum;\n  private previous;\n  constructor(options?: VideoQaOptions);\n  get frameCount(): number;\n  inspect(rgba: Uint8Array, width: number, height: number): void;\n  stats(expectedFrames: number, encodedFrames: number, fps: number, width: number, height: number, options?: VideoQaOptions): VideoQaStats;\n}\n/** Measures a mixed audio track (one Float32Array per channel). */\ndeclare function analyzeAudio(channels: readonly Float32Array[], sampleRate: number, options?: VideoQaOptions): AudioQaStats;\n/**\n * ITU-R BS.1770-4 integrated loudness (LUFS): K-weighted mean square in\n * 400 ms blocks with 75% overlap, gated at -70 LUFS and then at 10 LU below\n * the mean of what passed. Channels weigh 1 (stereo and mono layouts).\n */\ndeclare function integratedLoudness(channels: readonly Float32Array[], sampleRate: number): number | null;\n/** Turn measurements and document diagnostics into a report with issues. */\ndeclare function buildQaReport(parts: {\n  video?: VideoQaStats;\n  audio?: AudioQaStats;\n  diagnostics?: readonly RenderDiagnostic[];\n  options?: VideoQaOptions;\n}): VideoQaReport;\n/** A short human- and agent-readable summary of a report. */\ndeclare function formatQaReport(report: VideoQaReport): string;\n//#endregion\n//#region src/headless-webgpu-renderer.d.ts\ndeclare class RenderSemaphore {\n  private _running;\n  private readonly _max;\n  private readonly _queue;\n  constructor(max: number);\n  acquire(timeoutMs?: number): Promise<void>;\n  release(): void;\n  get stats(): {\n    active: number;\n    queued: number;\n    max: number;\n  };\n}\ndeclare const renderSemaphore: RenderSemaphore;\n/** Composition frames `start` (inclusive) to `end` (exclusive). */\ninterface FrameRange {\n  start: number;\n  end: number;\n}\ndeclare class HeadlessWebGPURenderer {\n  private static isInitialized;\n  private static initPromise;\n  private static initFailureCount;\n  private static readonly MAX_INIT_FAILURES;\n  private static nextRetryAt;\n  static initialize(): Promise<void>;\n  renderImage(virtualMedia: VirtualMediaData, frame?: number, fps?: number, options?: {\n    renderId?: string;\n    /** \"rgba\" skips PNG encoding and returns width*height*4 raw pixels. */\n    format?: \"png\" | \"rgba\";\n  }): Promise<Buffer>;\n  /**\n   * Renders a single frame to a PNG buffer at a specified timestamp in milliseconds or frame index.\n   */\n  renderFrame(source: VirtualMediaData | {\n    toVirtualMedia(): VirtualMediaData;\n  }, options?: {\n    atMs?: number;\n    frame?: number;\n    fps?: number;\n    /** Reuse compiled state across calls; see `renderImage`. */\n    renderId?: string;\n    /** \"rgba\" returns raw width*height*4 pixels instead of a PNG. */\n    format?: \"png\" | \"rgba\";\n  }): Promise<Buffer>;\n  /**\n   * Measures what frames cost to render across the timeline, for planning a\n   * split render (`planChunks`). At `samples` evenly spaced points (default\n   * 12) it renders three consecutive frames and times the last two, so\n   * effects that carry state (trails, particles) are caught up and their\n   * replay is not counted. Encoding is not included.\n   */\n  probeRender(source: VirtualMediaData | {\n    toVirtualMedia(): VirtualMediaData;\n  }, options?: {\n    samples?: number;\n    signal?: AbortSignal;\n    /** Called after each sample point with how many are done. */\n    onSample?: (done: number, total: number) => void;\n  }): Promise<{\n    totalFrames: number;\n    fps: number;\n    durationMs: number;\n    samples: FrameCostSample[];\n  }>;\n  /**\n   * Mixes the composition's full audio timeline (clips, effects, synthesized\n   * tracks) to stereo PCM, exactly as `renderVideo` muxes it.\n   */\n  /**\n   * Mixes the timeline's audio. `window` mixes only that stretch (the same\n   * samples as that part of a full mix); `master: false` skips the master\n   * stage, for callers that master with the whole film's `peak` later.\n   */\n  renderAudio(virtualMedia: VirtualMediaData, options?: {\n    fps?: number;\n    sampleRate?: number;\n    window?: {\n      startSec: number;\n      endSec: number;\n    };\n    master?: boolean;\n  }): Promise<AudioMix>;\n  renderLut(virtualMedia: VirtualMediaData, frame?: number, fps?: number): Promise<Buffer>;\n  private resolveMediaDuration;\n  renderVideo(virtualMedia: VirtualMediaData, options?: {\n    codec?: string;\n    audioCodec?: string;\n    quality?: string;\n    concurrency?: number;\n    /**\n     * Depth of the DMA staging ring (default 2, clamped 2–8). A deeper\n     * ring overlaps more encoder latency at the cost of VRAM\n     * (~8.3MB/slot at 1080p RGBA). Also settable via\n     * `FRAMEFIELDS_RING_CAPACITY`.\n     */\n    ringCapacity?: number;\n    /**\n     * Measure the output while it renders (black and frozen frames,\n     * dropped frames, loudness, clipping, silence, document warnings)\n     * and return the findings as `qa`. `true` uses default thresholds.\n     */\n    qa?: boolean | VideoQaOptions;\n    /**\n     * Aborts the render between frames; the promise rejects with\n     * `signal.reason` and the partial output is deleted.\n     */\n    signal?: AbortSignal;\n    /**\n     * Called as the render moves through its phases: \"prepare\", each\n     * frame (\"render\"), \"audio\" (mixing, per clip), \"audio-encode\",\n     * \"mux\", \"convert\" (GIF only) and \"done\".\n     */\n    onProgress?: (progress: RenderProgress) => void;\n    /**\n     * Renders only composition frames `start` (inclusive) to `end`\n     * (exclusive), as one chunk of a render split across workers. The\n     * chunk's timestamps start at 0 and its first frame is a keyframe,\n     * so `stitchChunks` joins chunks without re-encoding. Effects that\n     * carry state between frames rebuild it before `start`.\n     */\n    frames?: FrameRange;\n    /**\n     * `false` writes no audio track, as for chunks: the timeline's audio\n     * is exported once with `codec: \"aac\"` and added by `stitchChunks`.\n     */\n    audio?: boolean;\n  }): Promise<{\n    filePath: string;\n    cleanup: () => Promise<void>;\n    qa?: VideoQaReport;\n  }>;\n}\ndeclare const HeadlessMediaRenderer: typeof HeadlessWebGPURenderer;\ntype HeadlessMediaRenderer = HeadlessWebGPURenderer;\n//#endregion\n//#region src/job-reset.d.ts\n/**\n * Drops every cache keyed by a file path or URL: media inputs and decoders,\n * textures, LUTs, fonts and downloaded font files. A long-lived worker calls this between jobs,\n * because the next checkout may hold different bytes at the same path. The\n * GPU device and compiled pipelines stay warm.\n */\ndeclare function resetRenderCaches(): void;\n//#endregion\n//#region src/logger.d.ts\n/**\n * \"json\" (pino lines, for log collectors) or \"text\" (one short line each, for\n * people and agents reading a terminal). `FRAMEFIELDS_LOG_FORMAT` picks one;\n * otherwise production is JSON and everything else text.\n */\ndeclare function resolveLogFormat(vars?: Record<string, string | undefined> | undefined): \"json\" | \"text\";\n/**\n * Turns pino's JSON lines into `[framefields] Rendered 40% (…)`: the message\n * without its `[Component]` prefix, the level only for warnings and errors,\n * and an error's message (its stack reaches the caller with the throw).\n */\ndeclare function textLogStream(write?: (line: string) => void): DestinationStream;\ndeclare const rendererLogger: pino.Logger<never, boolean>;\n//#endregion\n//#region src/node-manifest.d.ts\n/**\n * The `framefields` block of a node package's `package.json`.\n *\n * This is the single declaration of a node's op: renderer discovery, the\n * effects generator (`scripts/generate-effects.ts`) and the skill catalog all\n * read it from here. There is deliberately no fallback that derives an op from\n * the package name. See `spec/sync-node.md` §5.1.\n */\ndeclare const NODE_KINDS: readonly [\"effect\", \"audio\", \"source\", \"signal\", \"utility\"];\ntype NodeKind = (typeof NODE_KINDS)[number];\ninterface NodeRendererExports {\n  development?: string;\n  import?: string;\n  default?: string;\n}\ninterface NodeManifest {\n  /** Directory name under `nodes/`, e.g. `node-apply-lut`. */\n  dir: string;\n  /** Absolute path of the node package. */\n  path: string;\n  /** npm package name, e.g. `@framefields/node-lut`. */\n  packageName: string;\n  /** Canonical op literal used in the operation AST and the renderer registry. */\n  type: string;\n  kind: NodeKind;\n  /** Legacy ops that resolve to the same renderer. */\n  aliases: readonly string[];\n  /** Named zod schema export of `src/shared/config.ts`. */\n  schema?: string;\n  /** Authoring class name. Defaults to `type`. */\n  className?: string;\n  /** Key on `Effect.*`. Defaults to `className` with a lower-cased first letter. */\n  factory?: string;\n  /** A hand-written subclass exists under `effects/custom/`. */\n  custom: boolean;\n  /** `false` when the package opts out of discovery. */\n  enabled: boolean;\n  rendererExports?: NodeRendererExports;\n}\ndeclare class NodeManifestError extends Error {\n  readonly problems: readonly string[];\n  constructor(problems: readonly string[]);\n}\n/**\n * Validates one parsed `package.json`. Returns the manifest, or the list of\n * problems that make it unusable. Never throws.\n */\ndeclare function parseNodeManifest(pkg: unknown, dir: string, nodePath?: string): {\n  manifest?: NodeManifest;\n  problems: string[];\n};\n/**\n * Reads every `nodes/node-*` package and returns its manifest, sorted by\n * directory name. Throws a single {@link NodeManifestError} listing every\n * problem: a missing or malformed block, or an op/alias claimed twice.\n */\ndeclare function loadNodeManifests(nodesDir: string): NodeManifest[];\n//#endregion\n//#region src/stitch.d.ts\ninterface StitchOptions {\n  /** Chunk files in timeline order, each a `renderVideo({ frames, audio: false })` output. */\n  chunks: readonly string[];\n  /**\n   * An audio-only render of the whole timeline (`renderVideo({ codec: \"aac\" })`,\n   * or `\"opus\"` for WebM chunks), copied in as the audio track.\n   */\n  audio?: string;\n  outputPath: string;\n  /** Stops between packets; the promise rejects and no file is left behind. */\n  signal?: AbortSignal;\n}\ninterface StitchResult {\n  filePath: string;\n  /** Video frames written, across all chunks. */\n  frames: number;\n  /** End of the video track, in seconds. */\n  durationSec: number;\n}\ndeclare function stitchChunks(options: StitchOptions): Promise<StitchResult>;\n//#endregion\n//#region src/zero-copy-webcodecs-pipeline.d.ts\ninterface ZeroCopyWebCodecsPipelineOptions {\n  readonly width: number;\n  readonly height: number;\n  readonly fps: number;\n  readonly videoSource: VideoSampleSource;\n  readonly ringCapacity?: number;\n  readonly colorSpace?: VideoColorSpaceConfig;\n  readonly directCanvasSource?: unknown;\n  /**\n   * Called with each frame's RGBA pixels, in frame order, just before it is\n   * encoded (staging-ring path only). The buffer is reused: read, don't keep.\n   */\n  readonly onFrame?: (rgba: Uint8Array, frameIndex: number) => void;\n}\ninterface WebCodecsPipelineStats {\n  readonly totalFramesEnqueued: number;\n  readonly totalFramesEncoded: number;\n  readonly averageGpuSubmitTimeMs: number;\n  readonly averageEncodeTimeMs: number;\n  readonly averageCycleTimeMs: number;\n  readonly maxCycleTimeMs: number;\n  readonly minCycleTimeMs: number;\n  readonly throughputFps: number;\n  readonly ringCapacity: number;\n  readonly isDirectZeroCopy: boolean;\n}\n/**\n * High-performance hardware video encoding pipeline integrating WebGPU textures with WebCodecs.\n *\n * Provides:\n * 1. Direct hardware acceleration when running with WebCodecs / OffscreenCanvas.\n * 2. Pipelined asynchronous double-buffered DMA staging ring for headless Node.js (Dawn native),\n *    allowing GPU Frame i+1 rendering to overlap concurrently with Frame i hardware encoding.\n */\ndeclare class ZeroCopyWebCodecsPipeline {\n  readonly width: number;\n  readonly height: number;\n  readonly fps: number;\n  readonly ringCapacity: number;\n  private readonly device;\n  private readonly videoSource;\n  private readonly stagingRing;\n  private readonly colorSpace?;\n  private readonly directCanvasSource?;\n  private readonly onFrame?;\n  private readonly inFlightFrames;\n  private readonly cycleStartTimes;\n  private totalFramesEnqueued;\n  private totalFramesEncoded;\n  private totalGpuSubmitTimeMs;\n  private totalEncodeTimeMs;\n  private totalCycleTimeMs;\n  private maxCycleTimeMs;\n  private minCycleTimeMs;\n  private pipelineStartTime;\n  constructor(device: GPUDevice, options: ZeroCopyWebCodecsPipelineOptions);\n  /**\n   * Returns true if direct zero-copy from an OffscreenCanvas or texture is active.\n   */\n  canDirectZeroCopy(): boolean;\n  /**\n   * Enqueues a rendered GPU texture frame into the pipeline.\n   *\n   * Uses double-buffered DMA staging: if the staging ring has reached capacity,\n   * the oldest in-flight frame is asynchronously consumed and added to the video encoder\n   * before staging the new frame, guaranteeing constant bounded VRAM usage and zero GPU stalls.\n   */\n  enqueueFrame(frameIndex: number, targetTexture: GPUTexture, encoder: GPUCommandEncoder): Promise<void>;\n  /**\n   * Drains all remaining in-flight frames in the pipeline, ensuring every enqueued\n   * frame has been encoded and added to the video sample source.\n   */\n  drain(): Promise<void>;\n  /**\n   * Returns runtime throughput, latency, and pipeline statistics.\n   */\n  getStats(): WebCodecsPipelineStats;\n  /**\n   * Destroys the pipeline and releases all staging buffers.\n   */\n  destroy(): void;\n  private consumeAndEncode;\n}\n//#endregion\nexport { AudioQaStats, ChunkPlan, ChunkPlanOptions, DmaStagingRing, DmaStagingRingOptions, FrameCostSample, FrameInspector, FrameRange, HeadlessMediaRenderer, HeadlessWebGPURenderer, NODE_KINDS, NodeKind, NodeManifest, NodeManifestError, NodeRendererExports, PlannedChunk, QaIssue, QaSegment, type RenderPhase, type RenderProgress, StagingSlotInfo, StagingSlotStatus, StitchOptions, StitchResult, VideoColorSpaceConfig, VideoQaOptions, VideoQaReport, VideoQaStats, WebCodecsPipelineStats, ZeroCopyWebCodecsPipeline, ZeroCopyWebCodecsPipelineOptions, analyzeAudio, buildQaReport, discoverAndRegisterNodeRenderers, findNodesDir, formatQaReport, integratedLoudness, loadNodeManifests, parseNodeManifest, planChunks, preloadFonts, renderSemaphore, rendererLogger, resetRenderCaches, resolveLogFormat, stitchChunks, textLogStream };\n//# sourceMappingURL=index.d.mts.map"],"mappings":"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"}
+{"version":3,"file":"index-C7-p9zwU.d.mts","names":["pino","DestinationStream","VideoColorPrimaries","VideoFrame","VideoMatrixCoefficients","VideoTransferCharacteristics","AudioMix","RenderDiagnostic","VirtualMediaData","VideoSampleSource","preloadFonts","GPUDevice","Promise","FrameCostSample","ChunkPlanOptions","PlannedChunk","ChunkPlan","planChunks","StagingSlotStatus","VideoColorSpaceConfig","DmaStagingRingOptions","GPUTextureFormat","StagingSlotInfo","DmaStagingRing","GPUCommandEncoder","GPUTexture","Uint8Array","findNodesDir","discoverAndRegisterNodeRenderers","RenderPhase","RenderProgress","VideoQaOptions","QaSegment","QaIssue","VideoQaStats","AudioQaStats","VideoQaReport","FrameInspector","analyzeAudio","Float32Array","integratedLoudness","buildQaReport","formatQaReport","RenderSemaphore","renderSemaphore","FrameRange","HeadlessWebGPURenderer","Buffer","AbortSignal","HeadlessMediaRenderer","resetRenderCaches","resolveLogFormat","Record","textLogStream","rendererLogger","Logger","NODE_KINDS","NodeKind","NodeRendererExports","NodeManifest","NodeManifestError","Error","parseNodeManifest","loadNodeManifests","StitchOptions","StitchResult","stitchChunks","ZeroCopyWebCodecsPipelineOptions","WebCodecsPipelineStats","ZeroCopyWebCodecsPipeline"],"sources":["../../renderer/dist/index.d.mts","../src/renderer/framegrid.ts"],"sourcesContent":["import pino, { DestinationStream } from \"pino\";\nimport { VideoColorPrimaries, VideoFrame, VideoMatrixCoefficients, VideoTransferCharacteristics } from \"@napi-rs/webcodecs\";\nimport { AudioMix } from \"@framefields/compositions\";\nimport { RenderDiagnostic, VirtualMediaData } from \"@framefields/core\";\nimport { VideoSampleSource } from \"mediabunny\";\n\n//#region src/asset-preloader.d.ts\n/**\n * Preloads only the fonts (and emoji) a VirtualMediaData tree's text uses, so\n * typography renders correctly on Node.js without loading its media. Shared\n * with the browser preview; emoji need a font set with\n * `FontManager.registerEmojiFont()`.\n */\ndeclare function preloadFonts(media: VirtualMediaData, device?: GPUDevice | null): Promise<void>;\n//#endregion\n//#region src/chunk-plan.d.ts\n/**\n * Plans a render split across workers: how many chunks, and where each one\n * starts and ends. Pure arithmetic over measured frame costs, so it runs\n * anywhere (a worker's probe job, a coordinator, a local script).\n *\n * Every chunk pays a fixed cost before its first frame (worker start, fetch,\n * install, composition build). `workers: \"auto\"` adds workers only while each\n * chunk still spends at least `efficiency` of its time rendering, so a short\n * film stays on one worker and a long one spreads out until `maxWorkers`.\n * Chunks are cut at equal render cost, not equal frame counts, so a heavy\n * stretch (3D, vision) gets shorter chunks.\n */\n/** A measured render time for one frame. */\ninterface FrameCostSample {\n  frame: number;\n  ms: number;\n}\ninterface ChunkPlanOptions {\n  /** Frames in the composition. */\n  totalFrames: number;\n  /** Measured frame times; between samples the cost is interpolated linearly. */\n  samples: readonly FrameCostSample[];\n  /** A worker count, or `\"auto\"` to pick one from the cost. Default 1. */\n  workers?: number | \"auto\";\n  /** Upper bound for `\"auto\"` (and for a number). Default 10. */\n  maxWorkers?: number;\n  /** Fixed cost each chunk pays before rendering, in seconds. Default 90 (a cold start). */\n  overheadSec?: number;\n  /**\n   * `\"auto\"` only: the smallest share of a chunk's time spent rendering,\n   * between 0 and 1. Default 0.85: each chunk renders at least\n   * `overheadSec × 0.85 / 0.15` (about 5.7× the overhead).\n   */\n  efficiency?: number;\n  /** No chunk is shorter than this many frames. Default 60. */\n  minChunkFrames?: number;\n}\ninterface PlannedChunk {\n  /** First frame (inclusive). */\n  start: number;\n  /** Last frame (exclusive). */\n  end: number;\n  /** Estimated render time of its frames, in seconds. */\n  workSec: number;\n}\ninterface ChunkPlan {\n  workers: number;\n  /** Estimated render time of the whole composition on one worker, without overhead. */\n  workSec: number;\n  /** Estimated wall time with this plan: overhead plus the longest chunk. */\n  etaSec: number;\n  chunks: PlannedChunk[];\n}\ndeclare function planChunks(options: ChunkPlanOptions): ChunkPlan;\n//#endregion\n//#region src/dma-staging-ring.d.ts\ntype StagingSlotStatus = \"idle\" | \"rendering\" | \"mapping\" | \"mapped\";\ninterface VideoColorSpaceConfig {\n  readonly primaries?: VideoColorPrimaries;\n  readonly transfer?: VideoTransferCharacteristics;\n  readonly matrix?: VideoMatrixCoefficients;\n  readonly fullRange?: boolean;\n}\ninterface DmaStagingRingOptions {\n  readonly width: number;\n  readonly height: number;\n  readonly capacity?: number;\n  readonly format?: GPUTextureFormat;\n}\ninterface StagingSlotInfo {\n  readonly index: number;\n  readonly status: StagingSlotStatus;\n  readonly inFlightFrame: number | null;\n}\n/**\n * Pipelined Asynchronous DMA Staging Ring for WebGPU.\n *\n * Implements double-buffered (or N-buffered) GPU staging buffers to overlap\n * GPU render passes with asynchronous DMA host transfers and WebCodecs hardware encoding.\n * Eliminates GPU stalls by allowing Frame i+1 to execute on the GPU while Frame i\n * is asynchronously mapped and consumed by the hardware video encoder.\n */\ndeclare class DmaStagingRing {\n  readonly width: number;\n  readonly height: number;\n  readonly capacity: number;\n  readonly bytesPerRow: number;\n  readonly unpaddedBytesPerRow: number;\n  readonly bufferSize: number;\n  readonly format: GPUTextureFormat;\n  readonly device: GPUDevice;\n  private readonly slots;\n  private isDestroyed;\n  constructor(device: GPUDevice, options: DmaStagingRingOptions);\n  /**\n   * Prepares the staging buffer slot for writing by ensuring any prior mapping\n   * from a previous cycle has been completed and unmapped.\n   */\n  prepareSlot(frameIndex: number): Promise<void>;\n  /**\n   * Records a GPU-to-buffer DMA copy command into the provided command encoder.\n   */\n  stageTexture(encoder: GPUCommandEncoder, texture: GPUTexture, frameIndex: number): void;\n  /**\n   * Initiates asynchronous DMA mapping on the slot for the specified frame.\n   * Must be called immediately after submitting the command encoder to the device queue.\n   */\n  scheduleMap(frameIndex: number): Promise<void>;\n  /**\n   * Awaits asynchronous mapping and extracts pixels into a tightly packed Uint8Array.\n   * The slot remains in the \"mapped\" state until releaseFrame() is called.\n   */\n  readFramePixels(frameIndex: number): Promise<Uint8Array>;\n  /**\n   * Awaits asynchronous mapping, extracts pixels, and immediately unmaps the staging buffer,\n   * returning the slot to \"idle\" state so it can be reused immediately.\n   */\n  readAndReleaseFrame(frameIndex: number): Promise<Uint8Array>;\n  /**\n   * Directly reads the mapped staging buffer into a WebCodecs VideoFrame,\n   * bypassing redundant intermediate JS allocations when row pitches align,\n   * and immediately unmaps the buffer.\n   */\n  readFrameToVideoFrame(frameIndex: number, timestampUs: number, colorSpace?: VideoColorSpaceConfig, /** Sees the tightly packed RGBA pixels while they are mapped; must not keep them. */\n  inspect?: (rgba: Uint8Array) => void): Promise<VideoFrame>;\n  /**\n   * Unmaps the staging buffer for the specified frame and marks the slot idle.\n   */\n  releaseFrame(frameIndex: number): void;\n  /**\n   * Returns current status info for each slot in the ring.\n   */\n  getSlotInfos(): readonly StagingSlotInfo[];\n  /**\n   * Destroys all staging buffers and releases resources.\n   */\n  destroy(): void;\n  private checkDestroyed;\n}\n//#endregion\n//#region src/dynamic-node-discovery.d.ts\n/** Locates the workspace `nodes/` directory by climbing up from this file. */\ndeclare function findNodesDir(startDir?: string): string | null;\n/**\n * Registers the built-in node renderers, then any extra nodes found in the\n * directory named by `FRAMEFIELDS_NODES_DIR` (local node development). A node in\n * that directory overrides the built-in renderer for the same op.\n */\ndeclare function discoverAndRegisterNodeRenderers(): Promise<void>;\n//#endregion\n//#region src/render-reporter.d.ts\n/**\n * Stages of `renderVideo`, in order. Audio-only renders skip \"render\";\n * \"convert\" runs only for GIF output.\n */\ntype RenderPhase = \"prepare\" | \"render\" | \"audio\" | \"audio-encode\" | \"mux\" | \"convert\" | \"done\";\n/** Progress reported by `renderVideo({ onProgress })`. */\ninterface RenderProgress {\n  /**\n   * \"prepare\" loads fonts and warms the pipeline, \"render\" draws and encodes\n   * frames, \"audio\" mixes the soundtrack, \"audio-encode\" encodes it, \"mux\"\n   * writes the container, \"convert\" makes the GIF, \"done\" is the last event.\n   */\n  phase: RenderPhase;\n  /** Frames finished so far (1-based); `totalFrames` once frames are done. */\n  frame: number;\n  totalFrames: number;\n  /** Time since the render started. */\n  elapsedMs: number;\n  /** Share of the current phase done (0–1), when it can be measured. */\n  phaseProgress?: number;\n  /** Frames per second so far (\"render\" only). */\n  fps?: number;\n  /** Estimated seconds until the frames are done (\"render\" only). */\n  etaSec?: number;\n  /** What the phase is working on, e.g. \"3/7 sources: music.mp3\". */\n  detail?: string;\n}\n//#endregion\n//#region src/video-qa.d.ts\n/**\n * Quality checks run on a video while it renders: frames are measured as\n * they are read back for the encoder and audio as it is mixed, so the report\n * describes exactly what was encoded without decoding the file again.\n */\ninterface VideoQaOptions {\n  /** Luma (0-1) at or below which a pixel counts as black. Default 0.1. */\n  readonly blackPixelThreshold?: number;\n  /** Share of black pixels that makes a frame black. Default 0.98. */\n  readonly blackFrameRatio?: number;\n  /** Shortest run of black frames reported. Default 0.5 s. */\n  readonly minBlackSec?: number;\n  /** Shortest run of unchanging frames reported. Default 2 s. */\n  readonly minFrozenSec?: number;\n  /** Level (dBFS, 100 ms windows) below which audio counts as silent. Default -60. */\n  readonly silenceDbfs?: number;\n  /** Shortest silent stretch reported. Default 2 s. */\n  readonly minSilenceSec?: number;\n  /** Integrated loudness to hit, e.g. -14 for most streaming platforms. Unchecked when unset. */\n  readonly targetLufs?: number;\n  /** Allowed distance from `targetLufs`, in LU. Default 1. */\n  readonly lufsTolerance?: number;\n}\ninterface QaSegment {\n  readonly startSec: number;\n  readonly endSec: number;\n}\ninterface QaIssue {\n  readonly severity: \"error\" | \"warning\" | \"info\";\n  /** Stable machine-readable kind, e.g. \"black_frames\", \"audio_clipping\" */\n  readonly code: string;\n  readonly message: string;\n  readonly startSec?: number;\n  readonly endSec?: number;\n  readonly layerId?: string;\n}\ninterface VideoQaStats {\n  readonly expectedFrames: number;\n  readonly encodedFrames: number;\n  readonly fps: number;\n  readonly width: number;\n  readonly height: number;\n  /** Average luma over the whole video, 0-1 */\n  readonly meanLuma: number;\n  readonly blackSegments: readonly QaSegment[];\n  readonly frozenSegments: readonly QaSegment[];\n}\ninterface AudioQaStats {\n  readonly sampleRate: number;\n  readonly channels: number;\n  readonly durationSec: number;\n  /** Highest sample, dBFS (sample peak, not true peak) */\n  readonly peakDbfs: number;\n  /** Mean level over the whole track, dBFS */\n  readonly rmsDbfs: number;\n  /** ITU-R BS.1770 integrated loudness; null when the track is silent */\n  readonly integratedLufs: number | null;\n  /** Samples at or beyond full scale */\n  readonly clippedSamples: number;\n  readonly silentSegments: readonly QaSegment[];\n}\ninterface VideoQaReport {\n  /** No errors or warnings (info issues do not fail a render) */\n  readonly passed: boolean;\n  readonly video?: VideoQaStats;\n  readonly audio?: AudioQaStats;\n  readonly issues: readonly QaIssue[];\n}\n/** Measures frames handed to it in order, as RGBA bytes. */\ndeclare class FrameInspector {\n  private readonly blackLuma;\n  private readonly blackRatio;\n  private readonly black;\n  private readonly sameAsPrevious;\n  private lumaSum;\n  private previous;\n  constructor(options?: VideoQaOptions);\n  get frameCount(): number;\n  inspect(rgba: Uint8Array, width: number, height: number): void;\n  stats(expectedFrames: number, encodedFrames: number, fps: number, width: number, height: number, options?: VideoQaOptions): VideoQaStats;\n}\n/** Measures a mixed audio track (one Float32Array per channel). */\ndeclare function analyzeAudio(channels: readonly Float32Array[], sampleRate: number, options?: VideoQaOptions): AudioQaStats;\n/**\n * ITU-R BS.1770-4 integrated loudness (LUFS): K-weighted mean square in\n * 400 ms blocks with 75% overlap, gated at -70 LUFS and then at 10 LU below\n * the mean of what passed. Channels weigh 1 (stereo and mono layouts).\n */\ndeclare function integratedLoudness(channels: readonly Float32Array[], sampleRate: number): number | null;\n/** Turn measurements and document diagnostics into a report with issues. */\ndeclare function buildQaReport(parts: {\n  video?: VideoQaStats;\n  audio?: AudioQaStats;\n  diagnostics?: readonly RenderDiagnostic[];\n  options?: VideoQaOptions;\n}): VideoQaReport;\n/** A short human- and agent-readable summary of a report. */\ndeclare function formatQaReport(report: VideoQaReport): string;\n//#endregion\n//#region src/headless-webgpu-renderer.d.ts\ndeclare class RenderSemaphore {\n  private _running;\n  private readonly _max;\n  private readonly _queue;\n  constructor(max: number);\n  acquire(timeoutMs?: number): Promise<void>;\n  release(): void;\n  get stats(): {\n    active: number;\n    queued: number;\n    max: number;\n  };\n}\ndeclare const renderSemaphore: RenderSemaphore;\n/** Composition frames `start` (inclusive) to `end` (exclusive). */\ninterface FrameRange {\n  start: number;\n  end: number;\n}\ndeclare class HeadlessWebGPURenderer {\n  private static isInitialized;\n  private static initPromise;\n  private static initFailureCount;\n  private static readonly MAX_INIT_FAILURES;\n  private static nextRetryAt;\n  static initialize(): Promise<void>;\n  renderImage(virtualMedia: VirtualMediaData, frame?: number, fps?: number, options?: {\n    renderId?: string;\n    /** \"rgba\" skips PNG encoding and returns width*height*4 raw pixels. */\n    format?: \"png\" | \"rgba\";\n  }): Promise<Buffer>;\n  /**\n   * Renders a single frame to a PNG buffer at a specified timestamp in milliseconds or frame index.\n   */\n  renderFrame(source: VirtualMediaData | {\n    toVirtualMedia(): VirtualMediaData;\n  }, options?: {\n    atMs?: number;\n    frame?: number;\n    fps?: number;\n    /** Reuse compiled state across calls; see `renderImage`. */\n    renderId?: string;\n    /** \"rgba\" returns raw width*height*4 pixels instead of a PNG. */\n    format?: \"png\" | \"rgba\";\n  }): Promise<Buffer>;\n  /**\n   * Measures what frames cost to render across the timeline, for planning a\n   * split render (`planChunks`). At `samples` evenly spaced points (default\n   * 12) it renders three consecutive frames and times the last two, so\n   * effects that carry state (trails, particles) are caught up and their\n   * replay is not counted. Encoding is not included.\n   */\n  probeRender(source: VirtualMediaData | {\n    toVirtualMedia(): VirtualMediaData;\n  }, options?: {\n    samples?: number;\n    signal?: AbortSignal;\n    /** Called after each sample point with how many are done. */\n    onSample?: (done: number, total: number) => void;\n  }): Promise<{\n    totalFrames: number;\n    fps: number;\n    durationMs: number;\n    samples: FrameCostSample[];\n  }>;\n  /**\n   * Mixes the composition's full audio timeline (clips, effects, synthesized\n   * tracks) to stereo PCM, exactly as `renderVideo` muxes it.\n   */\n  /**\n   * Mixes the timeline's audio. `window` mixes only that stretch (the same\n   * samples as that part of a full mix); `master: false` skips the master\n   * stage, for callers that master with the whole film's `peak` later.\n   */\n  renderAudio(virtualMedia: VirtualMediaData, options?: {\n    fps?: number;\n    sampleRate?: number;\n    window?: {\n      startSec: number;\n      endSec: number;\n    };\n    master?: boolean;\n  }): Promise<AudioMix>;\n  renderLut(virtualMedia: VirtualMediaData, frame?: number, fps?: number): Promise<Buffer>;\n  private resolveMediaDuration;\n  renderVideo(virtualMedia: VirtualMediaData, options?: {\n    codec?: string;\n    audioCodec?: string;\n    quality?: string;\n    concurrency?: number;\n    /**\n     * Depth of the DMA staging ring (default 2, clamped 2–8). A deeper\n     * ring overlaps more encoder latency at the cost of VRAM\n     * (~8.3MB/slot at 1080p RGBA). Also settable via\n     * `FRAMEFIELDS_RING_CAPACITY`.\n     */\n    ringCapacity?: number;\n    /**\n     * Measure the output while it renders (black and frozen frames,\n     * dropped frames, loudness, clipping, silence, document warnings)\n     * and return the findings as `qa`. `true` uses default thresholds.\n     */\n    qa?: boolean | VideoQaOptions;\n    /**\n     * Aborts the render between frames; the promise rejects with\n     * `signal.reason` and the partial output is deleted.\n     */\n    signal?: AbortSignal;\n    /**\n     * Called as the render moves through its phases: \"prepare\", each\n     * frame (\"render\"), \"audio\" (mixing, per clip), \"audio-encode\",\n     * \"mux\", \"convert\" (GIF only) and \"done\".\n     */\n    onProgress?: (progress: RenderProgress) => void;\n    /**\n     * Renders only composition frames `start` (inclusive) to `end`\n     * (exclusive), as one chunk of a render split across workers. The\n     * chunk's timestamps start at 0 and its first frame is a keyframe,\n     * so `stitchChunks` joins chunks without re-encoding. Effects that\n     * carry state between frames rebuild it before `start`.\n     */\n    frames?: FrameRange;\n    /**\n     * `false` writes no audio track, as for chunks: the timeline's audio\n     * is exported once with `codec: \"aac\"` and added by `stitchChunks`.\n     */\n    audio?: boolean;\n  }): Promise<{\n    filePath: string;\n    cleanup: () => Promise<void>;\n    qa?: VideoQaReport;\n  }>;\n}\ndeclare const HeadlessMediaRenderer: typeof HeadlessWebGPURenderer;\ntype HeadlessMediaRenderer = HeadlessWebGPURenderer;\n//#endregion\n//#region src/job-reset.d.ts\n/**\n * Drops every cache keyed by a file path or URL: media inputs and decoders,\n * textures, LUTs, fonts and downloaded font files. A long-lived worker calls this between jobs,\n * because the next checkout may hold different bytes at the same path. The\n * GPU device and compiled pipelines stay warm.\n */\ndeclare function resetRenderCaches(): void;\n//#endregion\n//#region src/logger.d.ts\n/**\n * \"json\" (pino lines, for log collectors) or \"text\" (one short line each, for\n * people and agents reading a terminal). `FRAMEFIELDS_LOG_FORMAT` picks one;\n * otherwise production is JSON and everything else text.\n */\ndeclare function resolveLogFormat(vars?: Record<string, string | undefined> | undefined): \"json\" | \"text\";\n/**\n * Turns pino's JSON lines into `[framefields] Rendered 40% (…)`: the message\n * without its `[Component]` prefix, the level only for warnings and errors,\n * and an error's message (its stack reaches the caller with the throw).\n */\ndeclare function textLogStream(write?: (line: string) => void): DestinationStream;\ndeclare const rendererLogger: pino.Logger<never, boolean>;\n//#endregion\n//#region src/node-manifest.d.ts\n/**\n * The `framefields` block of a node package's `package.json`.\n *\n * This is the single declaration of a node's op: renderer discovery, the\n * effects generator (`scripts/generate-effects.ts`) and the skill catalog all\n * read it from here. There is deliberately no fallback that derives an op from\n * the package name. See `spec/sync-node.md` §5.1.\n */\ndeclare const NODE_KINDS: readonly [\"effect\", \"audio\", \"source\", \"signal\", \"utility\"];\ntype NodeKind = (typeof NODE_KINDS)[number];\ninterface NodeRendererExports {\n  development?: string;\n  import?: string;\n  default?: string;\n}\ninterface NodeManifest {\n  /** Directory name under `nodes/`, e.g. `node-apply-lut`. */\n  dir: string;\n  /** Absolute path of the node package. */\n  path: string;\n  /** npm package name, e.g. `@framefields/node-lut`. */\n  packageName: string;\n  /** Canonical op literal used in the operation AST and the renderer registry. */\n  type: string;\n  kind: NodeKind;\n  /** Legacy ops that resolve to the same renderer. */\n  aliases: readonly string[];\n  /** Named zod schema export of `src/shared/config.ts`. */\n  schema?: string;\n  /** Authoring class name. Defaults to `type`. */\n  className?: string;\n  /** Key on `Effect.*`. Defaults to `className` with a lower-cased first letter. */\n  factory?: string;\n  /** A hand-written subclass exists under `effects/custom/`. */\n  custom: boolean;\n  /** `false` when the package opts out of discovery. */\n  enabled: boolean;\n  rendererExports?: NodeRendererExports;\n}\ndeclare class NodeManifestError extends Error {\n  readonly problems: readonly string[];\n  constructor(problems: readonly string[]);\n}\n/**\n * Validates one parsed `package.json`. Returns the manifest, or the list of\n * problems that make it unusable. Never throws.\n */\ndeclare function parseNodeManifest(pkg: unknown, dir: string, nodePath?: string): {\n  manifest?: NodeManifest;\n  problems: string[];\n};\n/**\n * Reads every `nodes/node-*` package and returns its manifest, sorted by\n * directory name. Throws a single {@link NodeManifestError} listing every\n * problem: a missing or malformed block, or an op/alias claimed twice.\n */\ndeclare function loadNodeManifests(nodesDir: string): NodeManifest[];\n//#endregion\n//#region src/stitch.d.ts\ninterface StitchOptions {\n  /** Chunk files in timeline order, each a `renderVideo({ frames, audio: false })` output. */\n  chunks: readonly string[];\n  /**\n   * An audio-only render of the whole timeline (`renderVideo({ codec: \"aac\" })`,\n   * or `\"opus\"` for WebM chunks), copied in as the audio track.\n   */\n  audio?: string;\n  outputPath: string;\n  /** Stops between packets; the promise rejects and no file is left behind. */\n  signal?: AbortSignal;\n}\ninterface StitchResult {\n  filePath: string;\n  /** Video frames written, across all chunks. */\n  frames: number;\n  /** End of the video track, in seconds. */\n  durationSec: number;\n}\ndeclare function stitchChunks(options: StitchOptions): Promise<StitchResult>;\n//#endregion\n//#region src/zero-copy-webcodecs-pipeline.d.ts\ninterface ZeroCopyWebCodecsPipelineOptions {\n  readonly width: number;\n  readonly height: number;\n  readonly fps: number;\n  readonly videoSource: VideoSampleSource;\n  readonly ringCapacity?: number;\n  readonly colorSpace?: VideoColorSpaceConfig;\n  readonly directCanvasSource?: unknown;\n  /**\n   * Called with each frame's RGBA pixels, in frame order, just before it is\n   * encoded (staging-ring path only). The buffer is reused: read, don't keep.\n   */\n  readonly onFrame?: (rgba: Uint8Array, frameIndex: number) => void;\n}\ninterface WebCodecsPipelineStats {\n  readonly totalFramesEnqueued: number;\n  readonly totalFramesEncoded: number;\n  readonly averageGpuSubmitTimeMs: number;\n  readonly averageEncodeTimeMs: number;\n  readonly averageCycleTimeMs: number;\n  readonly maxCycleTimeMs: number;\n  readonly minCycleTimeMs: number;\n  readonly throughputFps: number;\n  readonly ringCapacity: number;\n  readonly isDirectZeroCopy: boolean;\n}\n/**\n * High-performance hardware video encoding pipeline integrating WebGPU textures with WebCodecs.\n *\n * Provides:\n * 1. Direct hardware acceleration when running with WebCodecs / OffscreenCanvas.\n * 2. Pipelined asynchronous double-buffered DMA staging ring for headless Node.js (Dawn native),\n *    allowing GPU Frame i+1 rendering to overlap concurrently with Frame i hardware encoding.\n */\ndeclare class ZeroCopyWebCodecsPipeline {\n  readonly width: number;\n  readonly height: number;\n  readonly fps: number;\n  readonly ringCapacity: number;\n  private readonly device;\n  private readonly videoSource;\n  private readonly stagingRing;\n  private readonly colorSpace?;\n  private readonly directCanvasSource?;\n  private readonly onFrame?;\n  private readonly inFlightFrames;\n  private readonly cycleStartTimes;\n  private totalFramesEnqueued;\n  private totalFramesEncoded;\n  private totalGpuSubmitTimeMs;\n  private totalEncodeTimeMs;\n  private totalCycleTimeMs;\n  private maxCycleTimeMs;\n  private minCycleTimeMs;\n  private pipelineStartTime;\n  constructor(device: GPUDevice, options: ZeroCopyWebCodecsPipelineOptions);\n  /**\n   * Returns true if direct zero-copy from an OffscreenCanvas or texture is active.\n   */\n  canDirectZeroCopy(): boolean;\n  /**\n   * Enqueues a rendered GPU texture frame into the pipeline.\n   *\n   * Uses double-buffered DMA staging: if the staging ring has reached capacity,\n   * the oldest in-flight frame is asynchronously consumed and added to the video encoder\n   * before staging the new frame, guaranteeing constant bounded VRAM usage and zero GPU stalls.\n   */\n  enqueueFrame(frameIndex: number, targetTexture: GPUTexture, encoder: GPUCommandEncoder): Promise<void>;\n  /**\n   * Drains all remaining in-flight frames in the pipeline, ensuring every enqueued\n   * frame has been encoded and added to the video sample source.\n   */\n  drain(): Promise<void>;\n  /**\n   * Returns runtime throughput, latency, and pipeline statistics.\n   */\n  getStats(): WebCodecsPipelineStats;\n  /**\n   * Destroys the pipeline and releases all staging buffers.\n   */\n  destroy(): void;\n  private consumeAndEncode;\n}\n//#endregion\nexport { AudioQaStats, ChunkPlan, ChunkPlanOptions, DmaStagingRing, DmaStagingRingOptions, FrameCostSample, FrameInspector, FrameRange, HeadlessMediaRenderer, HeadlessWebGPURenderer, NODE_KINDS, NodeKind, NodeManifest, NodeManifestError, NodeRendererExports, PlannedChunk, QaIssue, QaSegment, type RenderPhase, type RenderProgress, StagingSlotInfo, StagingSlotStatus, StitchOptions, StitchResult, VideoColorSpaceConfig, VideoQaOptions, VideoQaReport, VideoQaStats, WebCodecsPipelineStats, ZeroCopyWebCodecsPipeline, ZeroCopyWebCodecsPipelineOptions, analyzeAudio, buildQaReport, discoverAndRegisterNodeRenderers, findNodesDir, formatQaReport, integratedLoudness, loadNodeManifests, parseNodeManifest, planChunks, preloadFonts, renderSemaphore, rendererLogger, resetRenderCaches, resolveLogFormat, stitchChunks, textLogStream };\n//# sourceMappingURL=index.d.mts.map"],"mappings":"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"}

package/dist/{index-rtCXNxGO.d.mts → index-CEKxvGY-.d.mts}

@@ -1,4 +1,4 @@
-import { A as VisionCompute, L as VisionSession, M as VisionModelDescriptor, N as VisionModelStore, P as VisionModelStoreOptions, R as VisionTensorInput, T as SessionProvider, j as VisionImageInput, z as VisionTensorOutputs } from "./index-DBh3WphX.mjs";
+import { A as VisionCompute, L as VisionSession, M as VisionModelDescriptor, N as VisionModelStore, P as VisionModelStoreOptions, R as VisionTensorInput, T as SessionProvider, j as VisionImageInput, z as VisionTensorOutputs } from "./index-D1FqV1eu.mjs";
 
 //#region ../vision-sam/dist/index.d.mts
 //#region src/license.d.ts
@@ -327,4 +327,4 @@ declare function sam3Mask(logits: Float32Array, width: number, height: number, s
 //#endregion
 //#endregion
 export { assertSamLicenseAccepted as A, sam3Precision as B, Sam3Precision as C, Sam3TrackerOptions as D, Sam3Tracker as E, sam3DenseDecoder as F, validateSam3Prompts as G, sam3Run as H, sam3EncoderFiles as I, sam3Floats as L, ensureSamModelsRegistered as M, sam2Revision as N, SamLicenseOptions as O, sam2Tokens as P, sam3Mask as R, Sam3Options as S, Sam3TextSelector as T, sam3SupportGraphs as U, sam3Revision as V, validateSam2Prompts as W, Sam2TrackerOptions as _, SAM_MODELS as a, Sam3ModelKey as b, Sam2Graph as c, Sam2Model as d, Sam2ModelKey as f, Sam2Tracker as g, Sam2Prompt as h, SAM_LICENSE_TERMS_URL as i, decodeSam2Mask as j, SamModelKey as k, Sam2Memory as l, Sam2Point as m, SAM3_ENCODER as n, Sam2FrameResult as o, Sam2Options as p, SAM_LICENSE as r, Sam2FrameTracker as s, SAM2_EXPORTS as t, Sam2MemoryBank as u, Sam3FrameResult as v, Sam3Prompt as w, Sam3ObjectResult as x, Sam3MemoryBank as y, sam3Position as z };
-//# sourceMappingURL=index-rtCXNxGO.d.mts.map
+//# sourceMappingURL=index-CEKxvGY-.d.mts.map

package/dist/{index-rtCXNxGO.d.mts.map → index-CEKxvGY-.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-rtCXNxGO.d.mts","names":["SessionProvider","VisionCompute","VisionImageInput","VisionModelDescriptor","VisionModelStore","VisionModelStoreOptions","VisionSession","VisionTensorInput","VisionTensorOutputs","SAM_LICENSE_TERMS_URL","SamLicenseOptions","assertSamLicenseAccepted","Sam2Model","Sam2Graph","Sam2ModelKey","SAM2_EXPORTS","Record","Readonly","Sam3Precision","SAM3_ENCODER","Sam3ModelKey","SamModelKey","SAM_LICENSE","sam3EncoderFiles","SAM_MODELS","ensureSamModelsRegistered","Sam2Memory","Float32Array","Sam2MemoryBank","sam2Tokens","Sam2Point","Sam2Prompt","Sam2Options","Sam2FrameResult","Uint8Array","Sam2FrameTracker","Promise","validateSam2Prompts","sam2Revision","Sam2TrackerOptions","Sam2Tracker","decodeSam2Mask","sam3SupportGraphs","sam3DenseDecoder","Sam3MemoryBank","sam3Position","sam3Floats","sam3Run","Sam3TextSelector","Sam3Prompt","Sam3Options","validateSam3Prompts","Sam3ObjectResult","Sam3FrameResult","sam3Revision","sam3Precision","Sam3TrackerOptions","Sam3Tracker","Omit","sam3Mask"],"sources":["../../vision-sam/dist/index.d.mts"],"sourcesContent":["import { SessionProvider, VisionCompute, VisionImageInput, VisionModelDescriptor, VisionModelStore, VisionModelStoreOptions, VisionSession, VisionTensorInput, VisionTensorOutputs } from \"@framefields/vision\";\n\n//#region src/license.d.ts\ndeclare const SAM_LICENSE_TERMS_URL = \"https://github.com/facebookresearch/sam3/blob/main/LICENSE\";\ninterface SamLicenseOptions {\n  /** Explicitly agree to Meta's SAM License terms to download or run SAM 3 models. */\n  readonly acceptLicense?: boolean;\n}\n/**\n * Ensures that the user has explicitly accepted Meta's SAM License terms before\n * downloading SAM 3 weights or performing inference. SAM 2.1's weights are Apache-2.0 and\n * need no acceptance.\n */\ndeclare function assertSamLicenseAccepted(context?: string, options?: SamLicenseOptions): void;\n//#endregion\n//#region src/models/registry.d.ts\n/**\n * SAM model registry. Every file is pinned to an immutable Hugging Face revision with its\n * exact size and SHA-256; the shared `VisionModelStore` verifies both after download.\n * Nothing here touches the network: the descriptors are registered into the vision\n * registry on first tracker creation so `@framefields/vision` never lists SAM weights.\n */\n/** SAM 2.1 checkpoints with a pinned video export. */\ntype Sam2Model = \"tiny\" | \"small\";\ntype Sam2Graph = \"vision_encoder\" | \"mask_decoder\" | \"memory_encoder\" | \"memory_attention\" | \"pointer_tpos\";\ntype Sam2ModelKey = `sam2.1-${Sam2Model}-${Sam2Graph | \"constants\"}`;\n/**\n * Diffusion Studio's fp16 video exports of Meta SAM 2.1 (Apache-2.0). Tiny is built for\n * speed at 512² (32×32 features); Small runs SAM 2's native 1024² (64×64), resolving small\n * objects, thin structures and identity after cuts better at roughly 4× the encoder and\n * 16× the memory-attention work.\n */\ndeclare const SAM2_EXPORTS: Readonly<Record<Sam2Model, {\n  repo: string;\n  revision: string;\n  size: number;\n  name: string;\n}>>;\n/** Weight formats published for the SAM 3 tracker's image encoder. */\ntype Sam3Precision = \"fp16\" | \"q4f16\" | \"q4\";\n/**\n * The encoder precision each backend runs fastest. Measured on an M1 Pro (one 1008² frame):\n * WebGPU fp16 3.65 s, q4f16 4.43 s, q4 6.63 s, int8 140 s (its ops fall back to the CPU);\n * fp16 is also the closest to full precision. On WebGPU, 4-bit weights are dequantized\n * before every matmul, so they only save memory. CUDA runs fp16 on tensor cores. CPUs have\n * no fast fp16 path, so they get fp32-activation q4.\n */\ndeclare const SAM3_ENCODER: Readonly<Record<VisionCompute, Sam3Precision>>;\ntype Sam3ModelKey = `sam3-vision_encoder-${Sam3Precision}` | `sam3-vision_encoder-${Sam3Precision}-data` | \"sam3-mask_decoder\" | \"sam3-memory_encoder\" | \"sam3-memory_attention\" | \"sam3-support\" | \"sam3-support-data\" | \"sam3-text-vision_encoder\" | \"sam3-text-vision_encoder-data\" | \"sam3-text-encoder\" | \"sam3-text-decoder\" | \"sam3-tokenizer\" | \"sam3-tokenizer-config\";\ntype SamModelKey = Sam2ModelKey | Sam3ModelKey;\ndeclare const SAM_LICENSE = \"Meta SAM License\";\n/** File names of the encoder at `precision`; the graph refers to its weights by `data`. */\ndeclare function sam3EncoderFiles(precision: Sam3Precision): {\n  graph: string;\n  data: string;\n};\ndeclare const SAM_MODELS: readonly VisionModelDescriptor[];\n/** Registers the SAM descriptors into the shared vision registry (idempotent). */\ndeclare function ensureSamModelsRegistered(): void;\n//#endregion\n//#region src/sam2/memory.d.ts\n/** CPU-owned memory bank; neural inference uses the configured vision execution provider. */\ninterface Sam2Memory {\n  readonly frame: number;\n  readonly tokens: Float32Array;\n  readonly positions: Float32Array;\n  readonly pointer: Float32Array;\n}\ndeclare class Sam2MemoryBank {\n  private readonly temporal;\n  private seed?;\n  private recent;\n  constructor(temporal: readonly (readonly number[])[]);\n  remember(memory: Sam2Memory, prompted: boolean): void;\n  assemble(frame: number, frameCount?: number): {\n    memory: Float32Array;\n    positions: Float32Array;\n    distances: Float32Array;\n  };\n}\n/** NCHW features to the sequence-major layout consumed by memory attention. */\ndeclare function sam2Tokens(data: Float32Array): Float32Array;\n//#endregion\n//#region src/sam2/types.d.ts\n/** Normalized source-image coordinates. Labels 2/3 form a box's opposite corners. */\ninterface Sam2Point {\n  readonly x: number;\n  readonly y: number;\n  readonly label: 0 | 1 | 2 | 3;\n}\n/** Frame is on the source analysis clock, before trim or time remapping. */\ninterface Sam2Prompt {\n  readonly frame: number;\n  readonly points: readonly Sam2Point[];\n}\ninterface Sam2Options {\n  readonly prompts: readonly Sam2Prompt[];\n  /** Metadata for object and class signals; SAM does not classify objects. */\n  readonly category?: string;\n  /**\n   * Checkpoint: `\"tiny\"` (default; 512², ~0.3 s/frame on an M1 Pro) or `\"small\"` (SAM 2's\n   * native 1024²; finer edges, small objects and thin structures, steadier identity after\n   * cuts, at several times the cost).\n   */\n  readonly model?: Sam2Model;\n}\ninterface Sam2FrameResult {\n  readonly mask: Uint8Array;\n  readonly width: number;\n  readonly height: number;\n  readonly score: number;\n  readonly iou: number;\n}\ninterface Sam2FrameTracker {\n  process(image: VisionImageInput, frame: number, points?: readonly Sam2Point[]): Promise<Sam2FrameResult>;\n  release(): void;\n}\ndeclare function validateSam2Prompts(prompts: readonly Sam2Prompt[]): void;\n//#endregion\n//#region src/sam2/tracker.d.ts\n/** The pinned export revision of `model`: part of ClipVision's persistent cache identity. */\ndeclare function sam2Revision(model?: Sam2Model): string;\ninterface Sam2TrackerOptions extends VisionModelStoreOptions {\n  readonly provider?: SessionProvider;\n  readonly store?: VisionModelStore;\n  /** Source sequence length; used to normalize object-pointer time positions for short videos. */\n  readonly frameCount?: number;\n  /** Checkpoint: `\"tiny\"` (default, 512², fast) or `\"small\"` (1024², finer detail). */\n  readonly model?: Sam2Model;\n}\n/** Complete pinned SAM 2.1 video graph pipeline (Tiny or Small), one explicitly selected object. */\ndeclare class Sam2Tracker {\n  private readonly constants;\n  private readonly frameCount;\n  private readonly sessions;\n  private readonly bank;\n  /** Model input side; image features are `size / 16` square, one memory token per cell. */\n  private readonly size;\n  private readonly tokens;\n  private lastFrame;\n  private released;\n  private constructor();\n  static create(options?: Sam2TrackerOptions): Promise<Sam2Tracker>;\n  private run;\n  process(image: VisionImageInput, frame: number, points?: readonly Sam2Point[]): Promise<Sam2FrameResult>;\n  private condition;\n  private remember;\n  release(): void;\n}\n/** Bilinear resize of square logits before thresholding, matching SAM's source-image mask contract. */\ndeclare function decodeSam2Mask(logits: Float32Array, width: number, height: number, score: number, iou: number): Sam2FrameResult;\n//#endregion\n//#region src/sam3/graphs.d.ts\ndeclare function sam3SupportGraphs(reference: Uint8Array, external: Uint8Array): {\n  densePrompt: Uint8Array;\n  pointerPosition: Uint8Array;\n  temporal: Float32Array;\n  noMemory: Float32Array;\n};\n/** Replace the no-mask embedding by the actual dense prompt head's output. */\ndeclare function sam3DenseDecoder(modelBytes: Uint8Array): Uint8Array;\n//#endregion\n//#region src/sam3/memory.d.ts\n/** Dynamic memory lengths: never duplicate unavailable early-frame memories. */\ndeclare class Sam3MemoryBank {\n  private readonly temporal;\n  private seed?;\n  private recent;\n  constructor(temporal: Float32Array);\n  remember(memory: Sam2Memory, prompted: boolean): void;\n  assemble(frame: number, frameCount: number): {\n    spatial: Float32Array;\n    positions: Float32Array;\n    pointers: Float32Array;\n    encoding: Float32Array;\n    pointerCount: number;\n  };\n}\n/** SAM 3 PositionEmbeddingSine: y then x, normalized pixel centers at grid indices 1..72. */\ndeclare function sam3Position(): Float32Array;\n//#endregion\n//#region src/sam3/text-selector.d.ts\ndeclare function sam3Floats(outputs: VisionTensorOutputs, name: string): Float32Array;\ndeclare function sam3Run(session: VisionSession, inputs: readonly VisionTensorInput[]): Promise<VisionTensorOutputs>;\n/** Semantic model is separate from the visual tracker and loads only for text prompts. */\ndeclare class Sam3TextSelector {\n  private readonly tokenizer;\n  private readonly sessions;\n  private encoded?;\n  private constructor();\n  static create(store: VisionModelStore, provider: SessionProvider): Promise<Sam3TextSelector>;\n  /**\n   * Mask logits (288²) of the instances matching `text` with sigmoid score of at least\n   * `threshold`, best first and at most `max`. Queries that repeat an accepted instance\n   * (mask IoU above 0.5) are skipped. Throws when nothing matches unless `required` is false.\n   */\n  select(pixels: Float32Array, text: string, threshold: number, max?: number, required?: boolean): Promise<Float32Array[]>;\n  /** Text features for a prompt; the last one is kept, since re-detection repeats it every few frames. */\n  private encodeText;\n  release(): void;\n}\n//#endregion\n//#region src/sam3/types.d.ts\ninterface Sam3Prompt {\n  /** Source analysis frame, before trimming or time remapping. */\n  readonly frame: number;\n  /** Normalized source coordinates; labels 2/3 define a box. */\n  readonly points?: readonly Sam2Point[];\n  /** Select matching instances (up to `maxObjects`, best first), then propagate their masks. */\n  readonly text?: string;\n  /**\n   * Track ID (1-based) a points prompt seeds or corrects; defaults to 1. The next unused\n   * ID adds an object. Text prompts re-select every object, so they take no ID.\n   */\n  readonly object?: number;\n}\ninterface Sam3Options extends SamLicenseOptions {\n  /** Prompt list across frames. Optional if shorthand `text` is supplied. */\n  readonly prompts?: readonly Sam3Prompt[];\n  /** Convenience shorthand to select by text at frame 0. */\n  readonly text?: string;\n  /** Signal category metadata; defaults to \"object\". */\n  readonly category?: string;\n  /** Minimum sigmoid score for a text-selected instance. Default 0.5. */\n  readonly textThreshold?: number;\n  /** Most instances a text prompt selects, as track IDs 1…N by score. Default 1, or every match with `merge`. */\n  readonly maxObjects?: number;\n  /**\n   * Select every instance matching the text as **one** object: one mask and one memory, so\n   * tracking costs the same as a single object however many match (e.g. a whole crowd).\n   */\n  readonly merge?: boolean;\n  /**\n   * Every this many frames after a text prompt, run that text again and add the instances no\n   * tracked object covers yet (people who walk in, turn up from behind someone, or were lost):\n   * into the one object with `merge`, otherwise as new track IDs up to `maxObjects`. Each\n   * detection pass costs about one text prompt. Default 0: select once, then only track.\n   */\n  readonly redetect?: number;\n  /** Image-encoder weights; defaults to the fastest for the backend in use (`SAM3_ENCODER`). */\n  readonly precision?: Sam3Precision;\n}\ndeclare function validateSam3Prompts(options: Sam3Options): void;\n/** One tracked SAM 3 object at a frame; an empty mask means it is absent there. */\ninterface Sam3ObjectResult {\n  /** Track ID, 1-based and stable until a text prompt re-selects every object. */\n  readonly id: number;\n  /** Source-sized binary mask (0 or 255). */\n  readonly mask: Uint8Array;\n  /** Object-presence logit; positive means present. */\n  readonly score: number;\n  readonly iou: number;\n}\ninterface Sam3FrameResult {\n  readonly width: number;\n  readonly height: number;\n  /** Every tracked object, ordered by track ID. */\n  readonly objects: readonly Sam3ObjectResult[];\n}\n//#endregion\n//#region src/sam3/tracker.d.ts\n/** Every graph and tokenizer revision, and the encoder precision: ClipVision's cache identity. */\ndeclare function sam3Revision(precision: Sam3Precision): string;\n/** The encoder precision a tracker on `provider` uses: the override, else the backend's best. */\ndeclare function sam3Precision(provider?: SessionProvider, override?: Sam3Precision): Promise<Sam3Precision>;\ninterface Sam3TrackerOptions extends VisionModelStoreOptions {\n  readonly provider?: SessionProvider;\n  readonly store?: VisionModelStore;\n  readonly frameCount?: number;\n  readonly textThreshold?: number;\n  /** Most instances a text prompt selects. Default 1, or every match with `merge`. */\n  readonly maxObjects?: number;\n  /** Track every instance a text prompt selects as one object (one mask, one memory). */\n  readonly merge?: boolean;\n  /** Re-run the last text prompt every this many frames and add what no object covers (see `Sam3Options`). */\n  readonly redetect?: number;\n  /** Image-encoder weights; defaults to the fastest for the provider's backend (`SAM3_ENCODER`). */\n  readonly precision?: Sam3Precision;\n  /** Explicitly agree to Meta's SAM License terms to download or run SAM 3's weights. */\n  readonly acceptLicense?: boolean;\n}\n/**\n * Explicitly selected SAM 3 instances with full neural memory propagation on the provider.\n * The image encoder runs once per frame; each object keeps its own memory bank.\n */\ndeclare class Sam3Tracker {\n  private readonly store;\n  private readonly provider;\n  private readonly options;\n  private readonly sessions;\n  private encoder?;\n  private readonly position;\n  private readonly banks;\n  private temporal?;\n  private noMemory?;\n  private selector?;\n  /** The last text prompt and its frame, which re-detection repeats. */\n  private text?;\n  private lastFrame;\n  private released;\n  private constructor();\n  static create(options?: Sam3TrackerOptions): Promise<Sam3Tracker>;\n  private run;\n  process(image: VisionImageInput, frame: number, prompt?: Omit<Sam3Prompt, \"frame\">): Promise<Sam3FrameResult>;\n  private track;\n  /**\n   * On a `redetect` frame, runs the last text prompt again and seeds what no tracked object\n   * covers: merged into the one object (keeping what it tracks), or as new objects.\n   */\n  private redetect;\n  private textSelector;\n  /** A 288² concept mask as a seed that outputs (and remembers) that mask. */\n  private textSeed;\n  private densePrompt;\n  /** Objects a prompt (re)seeds, by index. Text re-selects every object; points address one. */\n  private seeds;\n  private newBank;\n  private decode;\n  private initialFeatures;\n  private condition;\n  private remember;\n  release(): void;\n}\n/** Resize logits before thresholding; source pixels are the public mask coordinate system. */\ndeclare function sam3Mask(logits: Float32Array, width: number, height: number, score: number): Uint8Array;\n//#endregion\nexport { SAM2_EXPORTS, SAM3_ENCODER, SAM_LICENSE, SAM_LICENSE_TERMS_URL, SAM_MODELS, Sam2FrameResult, Sam2FrameTracker, Sam2Graph, Sam2Memory, Sam2MemoryBank, Sam2Model, Sam2ModelKey, Sam2Options, Sam2Point, Sam2Prompt, Sam2Tracker, Sam2TrackerOptions, Sam3FrameResult, Sam3MemoryBank, Sam3ModelKey, Sam3ObjectResult, Sam3Options, Sam3Precision, Sam3Prompt, Sam3TextSelector, Sam3Tracker, Sam3TrackerOptions, SamLicenseOptions, SamModelKey, assertSamLicenseAccepted, decodeSam2Mask, ensureSamModelsRegistered, sam2Revision, sam2Tokens, sam3DenseDecoder, sam3EncoderFiles, sam3Floats, sam3Mask, sam3Position, sam3Precision, sam3Revision, sam3Run, sam3SupportGraphs, validateSam2Prompts, validateSam3Prompts };\n//# sourceMappingURL=index.d.mts.map"],"mappings":"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"}
+{"version":3,"file":"index-CEKxvGY-.d.mts","names":["SessionProvider","VisionCompute","VisionImageInput","VisionModelDescriptor","VisionModelStore","VisionModelStoreOptions","VisionSession","VisionTensorInput","VisionTensorOutputs","SAM_LICENSE_TERMS_URL","SamLicenseOptions","assertSamLicenseAccepted","Sam2Model","Sam2Graph","Sam2ModelKey","SAM2_EXPORTS","Record","Readonly","Sam3Precision","SAM3_ENCODER","Sam3ModelKey","SamModelKey","SAM_LICENSE","sam3EncoderFiles","SAM_MODELS","ensureSamModelsRegistered","Sam2Memory","Float32Array","Sam2MemoryBank","sam2Tokens","Sam2Point","Sam2Prompt","Sam2Options","Sam2FrameResult","Uint8Array","Sam2FrameTracker","Promise","validateSam2Prompts","sam2Revision","Sam2TrackerOptions","Sam2Tracker","decodeSam2Mask","sam3SupportGraphs","sam3DenseDecoder","Sam3MemoryBank","sam3Position","sam3Floats","sam3Run","Sam3TextSelector","Sam3Prompt","Sam3Options","validateSam3Prompts","Sam3ObjectResult","Sam3FrameResult","sam3Revision","sam3Precision","Sam3TrackerOptions","Sam3Tracker","Omit","sam3Mask"],"sources":["../../vision-sam/dist/index.d.mts"],"sourcesContent":["import { SessionProvider, VisionCompute, VisionImageInput, VisionModelDescriptor, VisionModelStore, VisionModelStoreOptions, VisionSession, VisionTensorInput, VisionTensorOutputs } from \"@framefields/vision\";\n\n//#region src/license.d.ts\ndeclare const SAM_LICENSE_TERMS_URL = \"https://github.com/facebookresearch/sam3/blob/main/LICENSE\";\ninterface SamLicenseOptions {\n  /** Explicitly agree to Meta's SAM License terms to download or run SAM 3 models. */\n  readonly acceptLicense?: boolean;\n}\n/**\n * Ensures that the user has explicitly accepted Meta's SAM License terms before\n * downloading SAM 3 weights or performing inference. SAM 2.1's weights are Apache-2.0 and\n * need no acceptance.\n */\ndeclare function assertSamLicenseAccepted(context?: string, options?: SamLicenseOptions): void;\n//#endregion\n//#region src/models/registry.d.ts\n/**\n * SAM model registry. Every file is pinned to an immutable Hugging Face revision with its\n * exact size and SHA-256; the shared `VisionModelStore` verifies both after download.\n * Nothing here touches the network: the descriptors are registered into the vision\n * registry on first tracker creation so `@framefields/vision` never lists SAM weights.\n */\n/** SAM 2.1 checkpoints with a pinned video export. */\ntype Sam2Model = \"tiny\" | \"small\";\ntype Sam2Graph = \"vision_encoder\" | \"mask_decoder\" | \"memory_encoder\" | \"memory_attention\" | \"pointer_tpos\";\ntype Sam2ModelKey = `sam2.1-${Sam2Model}-${Sam2Graph | \"constants\"}`;\n/**\n * Diffusion Studio's fp16 video exports of Meta SAM 2.1 (Apache-2.0). Tiny is built for\n * speed at 512² (32×32 features); Small runs SAM 2's native 1024² (64×64), resolving small\n * objects, thin structures and identity after cuts better at roughly 4× the encoder and\n * 16× the memory-attention work.\n */\ndeclare const SAM2_EXPORTS: Readonly<Record<Sam2Model, {\n  repo: string;\n  revision: string;\n  size: number;\n  name: string;\n}>>;\n/** Weight formats published for the SAM 3 tracker's image encoder. */\ntype Sam3Precision = \"fp16\" | \"q4f16\" | \"q4\";\n/**\n * The encoder precision each backend runs fastest. Measured on an M1 Pro (one 1008² frame):\n * WebGPU fp16 3.65 s, q4f16 4.43 s, q4 6.63 s, int8 140 s (its ops fall back to the CPU);\n * fp16 is also the closest to full precision. On WebGPU, 4-bit weights are dequantized\n * before every matmul, so they only save memory. CUDA runs fp16 on tensor cores. CPUs have\n * no fast fp16 path, so they get fp32-activation q4.\n */\ndeclare const SAM3_ENCODER: Readonly<Record<VisionCompute, Sam3Precision>>;\ntype Sam3ModelKey = `sam3-vision_encoder-${Sam3Precision}` | `sam3-vision_encoder-${Sam3Precision}-data` | \"sam3-mask_decoder\" | \"sam3-memory_encoder\" | \"sam3-memory_attention\" | \"sam3-support\" | \"sam3-support-data\" | \"sam3-text-vision_encoder\" | \"sam3-text-vision_encoder-data\" | \"sam3-text-encoder\" | \"sam3-text-decoder\" | \"sam3-tokenizer\" | \"sam3-tokenizer-config\";\ntype SamModelKey = Sam2ModelKey | Sam3ModelKey;\ndeclare const SAM_LICENSE = \"Meta SAM License\";\n/** File names of the encoder at `precision`; the graph refers to its weights by `data`. */\ndeclare function sam3EncoderFiles(precision: Sam3Precision): {\n  graph: string;\n  data: string;\n};\ndeclare const SAM_MODELS: readonly VisionModelDescriptor[];\n/** Registers the SAM descriptors into the shared vision registry (idempotent). */\ndeclare function ensureSamModelsRegistered(): void;\n//#endregion\n//#region src/sam2/memory.d.ts\n/** CPU-owned memory bank; neural inference uses the configured vision execution provider. */\ninterface Sam2Memory {\n  readonly frame: number;\n  readonly tokens: Float32Array;\n  readonly positions: Float32Array;\n  readonly pointer: Float32Array;\n}\ndeclare class Sam2MemoryBank {\n  private readonly temporal;\n  private seed?;\n  private recent;\n  constructor(temporal: readonly (readonly number[])[]);\n  remember(memory: Sam2Memory, prompted: boolean): void;\n  assemble(frame: number, frameCount?: number): {\n    memory: Float32Array;\n    positions: Float32Array;\n    distances: Float32Array;\n  };\n}\n/** NCHW features to the sequence-major layout consumed by memory attention. */\ndeclare function sam2Tokens(data: Float32Array): Float32Array;\n//#endregion\n//#region src/sam2/types.d.ts\n/** Normalized source-image coordinates. Labels 2/3 form a box's opposite corners. */\ninterface Sam2Point {\n  readonly x: number;\n  readonly y: number;\n  readonly label: 0 | 1 | 2 | 3;\n}\n/** Frame is on the source analysis clock, before trim or time remapping. */\ninterface Sam2Prompt {\n  readonly frame: number;\n  readonly points: readonly Sam2Point[];\n}\ninterface Sam2Options {\n  readonly prompts: readonly Sam2Prompt[];\n  /** Metadata for object and class signals; SAM does not classify objects. */\n  readonly category?: string;\n  /**\n   * Checkpoint: `\"tiny\"` (default; 512², ~0.3 s/frame on an M1 Pro) or `\"small\"` (SAM 2's\n   * native 1024²; finer edges, small objects and thin structures, steadier identity after\n   * cuts, at several times the cost).\n   */\n  readonly model?: Sam2Model;\n}\ninterface Sam2FrameResult {\n  readonly mask: Uint8Array;\n  readonly width: number;\n  readonly height: number;\n  readonly score: number;\n  readonly iou: number;\n}\ninterface Sam2FrameTracker {\n  process(image: VisionImageInput, frame: number, points?: readonly Sam2Point[]): Promise<Sam2FrameResult>;\n  release(): void;\n}\ndeclare function validateSam2Prompts(prompts: readonly Sam2Prompt[]): void;\n//#endregion\n//#region src/sam2/tracker.d.ts\n/** The pinned export revision of `model`: part of ClipVision's persistent cache identity. */\ndeclare function sam2Revision(model?: Sam2Model): string;\ninterface Sam2TrackerOptions extends VisionModelStoreOptions {\n  readonly provider?: SessionProvider;\n  readonly store?: VisionModelStore;\n  /** Source sequence length; used to normalize object-pointer time positions for short videos. */\n  readonly frameCount?: number;\n  /** Checkpoint: `\"tiny\"` (default, 512², fast) or `\"small\"` (1024², finer detail). */\n  readonly model?: Sam2Model;\n}\n/** Complete pinned SAM 2.1 video graph pipeline (Tiny or Small), one explicitly selected object. */\ndeclare class Sam2Tracker {\n  private readonly constants;\n  private readonly frameCount;\n  private readonly sessions;\n  private readonly bank;\n  /** Model input side; image features are `size / 16` square, one memory token per cell. */\n  private readonly size;\n  private readonly tokens;\n  private lastFrame;\n  private released;\n  private constructor();\n  static create(options?: Sam2TrackerOptions): Promise<Sam2Tracker>;\n  private run;\n  process(image: VisionImageInput, frame: number, points?: readonly Sam2Point[]): Promise<Sam2FrameResult>;\n  private condition;\n  private remember;\n  release(): void;\n}\n/** Bilinear resize of square logits before thresholding, matching SAM's source-image mask contract. */\ndeclare function decodeSam2Mask(logits: Float32Array, width: number, height: number, score: number, iou: number): Sam2FrameResult;\n//#endregion\n//#region src/sam3/graphs.d.ts\ndeclare function sam3SupportGraphs(reference: Uint8Array, external: Uint8Array): {\n  densePrompt: Uint8Array;\n  pointerPosition: Uint8Array;\n  temporal: Float32Array;\n  noMemory: Float32Array;\n};\n/** Replace the no-mask embedding by the actual dense prompt head's output. */\ndeclare function sam3DenseDecoder(modelBytes: Uint8Array): Uint8Array;\n//#endregion\n//#region src/sam3/memory.d.ts\n/** Dynamic memory lengths: never duplicate unavailable early-frame memories. */\ndeclare class Sam3MemoryBank {\n  private readonly temporal;\n  private seed?;\n  private recent;\n  constructor(temporal: Float32Array);\n  remember(memory: Sam2Memory, prompted: boolean): void;\n  assemble(frame: number, frameCount: number): {\n    spatial: Float32Array;\n    positions: Float32Array;\n    pointers: Float32Array;\n    encoding: Float32Array;\n    pointerCount: number;\n  };\n}\n/** SAM 3 PositionEmbeddingSine: y then x, normalized pixel centers at grid indices 1..72. */\ndeclare function sam3Position(): Float32Array;\n//#endregion\n//#region src/sam3/text-selector.d.ts\ndeclare function sam3Floats(outputs: VisionTensorOutputs, name: string): Float32Array;\ndeclare function sam3Run(session: VisionSession, inputs: readonly VisionTensorInput[]): Promise<VisionTensorOutputs>;\n/** Semantic model is separate from the visual tracker and loads only for text prompts. */\ndeclare class Sam3TextSelector {\n  private readonly tokenizer;\n  private readonly sessions;\n  private encoded?;\n  private constructor();\n  static create(store: VisionModelStore, provider: SessionProvider): Promise<Sam3TextSelector>;\n  /**\n   * Mask logits (288²) of the instances matching `text` with sigmoid score of at least\n   * `threshold`, best first and at most `max`. Queries that repeat an accepted instance\n   * (mask IoU above 0.5) are skipped. Throws when nothing matches unless `required` is false.\n   */\n  select(pixels: Float32Array, text: string, threshold: number, max?: number, required?: boolean): Promise<Float32Array[]>;\n  /** Text features for a prompt; the last one is kept, since re-detection repeats it every few frames. */\n  private encodeText;\n  release(): void;\n}\n//#endregion\n//#region src/sam3/types.d.ts\ninterface Sam3Prompt {\n  /** Source analysis frame, before trimming or time remapping. */\n  readonly frame: number;\n  /** Normalized source coordinates; labels 2/3 define a box. */\n  readonly points?: readonly Sam2Point[];\n  /** Select matching instances (up to `maxObjects`, best first), then propagate their masks. */\n  readonly text?: string;\n  /**\n   * Track ID (1-based) a points prompt seeds or corrects; defaults to 1. The next unused\n   * ID adds an object. Text prompts re-select every object, so they take no ID.\n   */\n  readonly object?: number;\n}\ninterface Sam3Options extends SamLicenseOptions {\n  /** Prompt list across frames. Optional if shorthand `text` is supplied. */\n  readonly prompts?: readonly Sam3Prompt[];\n  /** Convenience shorthand to select by text at frame 0. */\n  readonly text?: string;\n  /** Signal category metadata; defaults to \"object\". */\n  readonly category?: string;\n  /** Minimum sigmoid score for a text-selected instance. Default 0.5. */\n  readonly textThreshold?: number;\n  /** Most instances a text prompt selects, as track IDs 1…N by score. Default 1, or every match with `merge`. */\n  readonly maxObjects?: number;\n  /**\n   * Select every instance matching the text as **one** object: one mask and one memory, so\n   * tracking costs the same as a single object however many match (e.g. a whole crowd).\n   */\n  readonly merge?: boolean;\n  /**\n   * Every this many frames after a text prompt, run that text again and add the instances no\n   * tracked object covers yet (people who walk in, turn up from behind someone, or were lost):\n   * into the one object with `merge`, otherwise as new track IDs up to `maxObjects`. Each\n   * detection pass costs about one text prompt. Default 0: select once, then only track.\n   */\n  readonly redetect?: number;\n  /** Image-encoder weights; defaults to the fastest for the backend in use (`SAM3_ENCODER`). */\n  readonly precision?: Sam3Precision;\n}\ndeclare function validateSam3Prompts(options: Sam3Options): void;\n/** One tracked SAM 3 object at a frame; an empty mask means it is absent there. */\ninterface Sam3ObjectResult {\n  /** Track ID, 1-based and stable until a text prompt re-selects every object. */\n  readonly id: number;\n  /** Source-sized binary mask (0 or 255). */\n  readonly mask: Uint8Array;\n  /** Object-presence logit; positive means present. */\n  readonly score: number;\n  readonly iou: number;\n}\ninterface Sam3FrameResult {\n  readonly width: number;\n  readonly height: number;\n  /** Every tracked object, ordered by track ID. */\n  readonly objects: readonly Sam3ObjectResult[];\n}\n//#endregion\n//#region src/sam3/tracker.d.ts\n/** Every graph and tokenizer revision, and the encoder precision: ClipVision's cache identity. */\ndeclare function sam3Revision(precision: Sam3Precision): string;\n/** The encoder precision a tracker on `provider` uses: the override, else the backend's best. */\ndeclare function sam3Precision(provider?: SessionProvider, override?: Sam3Precision): Promise<Sam3Precision>;\ninterface Sam3TrackerOptions extends VisionModelStoreOptions {\n  readonly provider?: SessionProvider;\n  readonly store?: VisionModelStore;\n  readonly frameCount?: number;\n  readonly textThreshold?: number;\n  /** Most instances a text prompt selects. Default 1, or every match with `merge`. */\n  readonly maxObjects?: number;\n  /** Track every instance a text prompt selects as one object (one mask, one memory). */\n  readonly merge?: boolean;\n  /** Re-run the last text prompt every this many frames and add what no object covers (see `Sam3Options`). */\n  readonly redetect?: number;\n  /** Image-encoder weights; defaults to the fastest for the provider's backend (`SAM3_ENCODER`). */\n  readonly precision?: Sam3Precision;\n  /** Explicitly agree to Meta's SAM License terms to download or run SAM 3's weights. */\n  readonly acceptLicense?: boolean;\n}\n/**\n * Explicitly selected SAM 3 instances with full neural memory propagation on the provider.\n * The image encoder runs once per frame; each object keeps its own memory bank.\n */\ndeclare class Sam3Tracker {\n  private readonly store;\n  private readonly provider;\n  private readonly options;\n  private readonly sessions;\n  private encoder?;\n  private readonly position;\n  private readonly banks;\n  private temporal?;\n  private noMemory?;\n  private selector?;\n  /** The last text prompt and its frame, which re-detection repeats. */\n  private text?;\n  private lastFrame;\n  private released;\n  private constructor();\n  static create(options?: Sam3TrackerOptions): Promise<Sam3Tracker>;\n  private run;\n  process(image: VisionImageInput, frame: number, prompt?: Omit<Sam3Prompt, \"frame\">): Promise<Sam3FrameResult>;\n  private track;\n  /**\n   * On a `redetect` frame, runs the last text prompt again and seeds what no tracked object\n   * covers: merged into the one object (keeping what it tracks), or as new objects.\n   */\n  private redetect;\n  private textSelector;\n  /** A 288² concept mask as a seed that outputs (and remembers) that mask. */\n  private textSeed;\n  private densePrompt;\n  /** Objects a prompt (re)seeds, by index. Text re-selects every object; points address one. */\n  private seeds;\n  private newBank;\n  private decode;\n  private initialFeatures;\n  private condition;\n  private remember;\n  release(): void;\n}\n/** Resize logits before thresholding; source pixels are the public mask coordinate system. */\ndeclare function sam3Mask(logits: Float32Array, width: number, height: number, score: number): Uint8Array;\n//#endregion\nexport { SAM2_EXPORTS, SAM3_ENCODER, SAM_LICENSE, SAM_LICENSE_TERMS_URL, SAM_MODELS, Sam2FrameResult, Sam2FrameTracker, Sam2Graph, Sam2Memory, Sam2MemoryBank, Sam2Model, Sam2ModelKey, Sam2Options, Sam2Point, Sam2Prompt, Sam2Tracker, Sam2TrackerOptions, Sam3FrameResult, Sam3MemoryBank, Sam3ModelKey, Sam3ObjectResult, Sam3Options, Sam3Precision, Sam3Prompt, Sam3TextSelector, Sam3Tracker, Sam3TrackerOptions, SamLicenseOptions, SamModelKey, assertSamLicenseAccepted, decodeSam2Mask, ensureSamModelsRegistered, sam2Revision, sam2Tokens, sam3DenseDecoder, sam3EncoderFiles, sam3Floats, sam3Mask, sam3Position, sam3Precision, sam3Revision, sam3Run, sam3SupportGraphs, validateSam2Prompts, validateSam3Prompts };\n//# sourceMappingURL=index.d.mts.map"],"mappings":"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"}

package/dist/{index-C2yaponf.d.mts → index-CRaydvLi.d.mts}

@@ -1,9 +1,10 @@
-import { Pt as MeshAudioDeformConfig, an as OutputItem, bt as MediaOperation, ur as VirtualMediaData } from "./index-a6JrbAK0.mjs";
+import { $n as ToonShading, Ft as MeshAudioDeformConfig, fr as VirtualMediaData, it as GeometryOutlineOptions, on as OutputItem, xt as MediaOperation } from "./index-C-V6CAhP.mjs";
 import { z } from "zod";
 import { Input, VideoSample } from "mediabunny";
 import "fontkit";
 
 //#region ../webgpu-renderers/dist/math3d/index.d.mts
+
 //#region src/math3d/vector3.d.ts
 /**
  * 3D Vector mathematics for camera kinematics, scene projections, and spatial transforms.
@@ -229,6 +230,7 @@ interface Environment3DOptions {
   toneMapping?: ToneMapping;
   fog?: Environment3DFog;
   floor?: Environment3DFloor;
+  outlines?: boolean | GeometryOutlineOptions;
 }
 interface PresetDef {
   top: string;
@@ -2997,6 +2999,8 @@ declare class GlassPipeline {
 //#region src/renderer3d/surface-params.d.ts
 /** Physically based surface inputs every 3D draw (quad, text, mesh) accepts. */
 interface SurfaceParams {
+  toon?: ToonShading;
+  outline?: boolean;
   /** Microsurface roughness 0 (mirror) .. 1 (chalk). Physical scenes default to 0.5. */
   roughness?: number;
   /** 0 = dielectric (plastic, paint, wood), 1 = metal. */
@@ -3008,7 +3012,7 @@ interface SurfaceParams {
   /** Casts into a `castShadow` light's shadow map (meshes default on, quads off). */
   castShadow?: boolean;
 }
-/** Floats appended to each 3D model uniform block: pbr vec4 + emissive vec4. */
+/** Shared model uniforms: PBR, emissive, and three art-direction vec4s. */
 
 //#endregion
 //#region src/renderer3d/mesh3d-pipeline.d.ts
@@ -3431,7 +3435,7 @@ interface ModelUniformData extends SurfaceParams {
   height?: number;
   /** Fraction of the texture the layer covers, [u, v] (default the whole texture) */
   textureExtent?: [number, number];
-  material?: "lit" | "unlit";
+  material?: "lit" | "unlit" | "toon";
   /** Screen-space track matte: the layer shows where this texture's alpha does. */
   matte?: GPUTexture;
   /** Turns the flat quad into a surface lifted by another picture's brightness. */
@@ -3442,7 +3446,7 @@ interface ModelUniformData extends SurfaceParams {
   ambientIntensity?: number;
   metallic?: number;
 }
-type MaterialUniformData = Pick<ModelUniformData, "material" | "shininess" | "roughness" | "specularIntensity" | "ambientIntensity" | "metallic" | "emissive" | "emissiveIntensity">;
+type MaterialUniformData = Pick<ModelUniformData, "material" | "shininess" | "roughness" | "specularIntensity" | "ambientIntensity" | "metallic" | "emissive" | "emissiveIntensity" | "toon" | "outline">;
 /** [shininess, specularIntensity, ambientIntensity, materialMode] as the 3D shaders' lighting reads them. */
 
 declare class Quad3DPipeline {
@@ -3682,7 +3686,7 @@ interface DrawQuad3DOpts extends SurfaceParams {
   /** Pre-computed normal matrix */
   normalMatrix?: Mat4;
   /** Material shading mode ("lit" vs "unlit") */
-  material?: "lit" | "unlit";
+  material?: "lit" | "unlit" | "toon";
   /** Blinn-Phong specular shininess exponent */
   shininess?: number;
   /** Roughness factor [0, 1] */
@@ -3854,6 +3858,8 @@ declare class Renderer3D {
   private shadowSampler;
   private meshBounds;
   private bloomPipeline;
+  private outlinePipeline;
+  private geometryResolvePipeline;
   private lastCameraBuffer;
   /**
    * Samples per pixel in the 3D pass. Mesh silhouettes (extruded text,
@@ -3862,6 +3868,15 @@ declare class Renderer3D {
    */
   readonly sampleCount: number;
   constructor(device: GPUDevice, format: GPUTextureFormat, sampleCount?: number);
+  /**
+   * Size-dependent render targets, by label, size, samples and usage. One
+   * frame (one command buffer) can render 3D scenes of different sizes, so
+   * a target is never destroyed while the frame may use it: targets the last
+   * frame did not use are destroyed at the next `resetPools`.
+   */
+  private attachments;
+  private attachmentsUsed;
+  private attachment;
   resetPools(): void;
   getOrCreateDepthTexture(width: number, height: number): GPUTexture;
   private getOrCreateMsaaTexture;
@@ -3905,10 +3920,11 @@ declare class Renderer3D {
   blurReflection(encoder: GPUCommandEncoder, reflectionTexture: GPUTexture, roughness: number): GPUTexture;
   drawFloor(pass: GPURenderPassEncoder, cameraBindGroup: GPUBindGroup, lightsBindGroup: GPUBindGroup, reflectionTexture: GPUTexture, floor: Environment3DFloor, useMrt?: boolean, useBloom?: boolean): void;
   /**
-   * A layer's unit quad ([-0.5, 0.5] square) in world space:
-   * T(pos) * Rz * Ry * Rx * S(w * sx, h * sy, sz) * T(0.5 - ax, 0.5 - ay, 0).
+   * A centered unit quad in world space. Translate to the authored pivot,
+   * rotate and scale, then offset the unit quad back from that pivot.
+   * Shared with children in preserve-3d containers.
    */
-  private quadModelMatrix;
+  quadModelMatrix(opts: DrawQuad3DOpts): Mat4;
   /**
    * Draw a text layer's captured Slug glyphs on the plane its texture quad
    * would cover. Glyph coverage is solved per screen pixel, so the text is
@@ -3949,6 +3965,9 @@ declare class Renderer3D {
   /** Writes `source` with bloom into `dest` (see `BloomOptions`). */
   applyBloom(encoder: GPUCommandEncoder, source: GPUTexture, dest: GPUTexture, options?: BloomOptions, /** Scene radiance to threshold (from a `writeHdr` pass); default `source`. */
   hdrSource?: GPUTexture | null): void;
+  /** Geometry ink is applied before lens blur, independently of material shading. */
+  resolveGeometry(encoder: GPUCommandEncoder, geometry: GPUTexture): void;
+  applyOutlines(encoder: GPUCommandEncoder, source: GPUTexture, geometry: GPUTexture, dest: GPUTextureView, camera: Camera3DPose, options: GeometryOutlineOptions, fog?: Environment3DFog): void;
   applyDepthOfField(encoder: GPUCommandEncoder, sourceColorTex: GPUTexture, depthTex: GPUTexture, destView: GPUTextureView, cameraBuffer: GPUBuffer): void;
   /** Uploads raw `InstanceData` float buffer to a GPU storage buffer from the instance pool. */
   uploadInstanceData(data: Float32Array): GPUBuffer;
@@ -4546,4 +4565,4 @@ declare const SignalResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 //#endregion
 export { inputStore as $, evaluateCubicBezierDerivative as $n, SelectorMode as $t, PolyhedronGeometryOptions as A, TextSignalSelectorSchema as An, LIGHT_UNIFORM_SIZE_BYTES as Ar, EnhancedTextNode as At, SignalRegistryResource as B, Vec2Schema as Bn, Path3DSample as Br, GlyphAnchorPointSchema as Bt, MasterAudioEntry as C, TextRangeSelector as Cn, Environment3DFloor as Cr, AudioSpectrumTypographySchema as Ct, MotionBlurPipeline as D, TextSelector as Dn, FrustumPlanes as Dr, CubicBezierSegmentSchema as Dt, Model3DData as E, TextScrambleConfigSchema as En, FrustumPlane as Er, CubicBezierSegment as Et, RoundedBoxGeometryOptions as F, TypingCadence as Fn, MAX_LIGHTS as Fr, ExtendedGlyphProperties as Ft, TorusGeometryOptions as G, buildPathLUT as Gn, linearRgb as Gr, LongShadowConfig as Gt, SlugFontCache as H, VolumetricFormationConfigSchema as Hn, ShadowUniformInfo as Hr, KineticMarqueeConfigSchema as Ht, SSAOPipeline as I, TypingCadenceSchema as In, Mat4 as Ir, ExtendedGlyphPropertiesSchema as It, WebGPUAudioProcessor as J, computeRangeSelectorWeight as Jn, ParticleDissolveConfigSchema as Jt, TubeGeometryOptions as K, computeAnchorPivotOffset as Kn, parseColorToRgb as Kr, LongShadowConfigSchema as Kt, ShadowPipeline as L, VariableFontAxes as Ln, Matrix4Math as Lr, GlyphAnchorGrouping as Lt, Renderer2D as M, TextWigglySelectorSchema as Mn, Light3DOptions as Mr, ExpressionEvaluationContext as Mt, Renderer3D as N, TypewriterAnimator as Nn, LightKind as Nr, ExpressionSelector as Nt, NodeAnimationTrack3D as O, TextSelectorSchema as On, GPULightData as Or, DynamicStrokeProperties as Ot, RingGeometryOptions as P, TypewriterAnimatorSchema as Pn, LightsUniformData as Pr, ExpressionSelectorSchema as Pt, initHeadlessWebGPU as Q, evaluateCubicBezier as Qn, SelectorBasedOnSchema as Qt, ShardGeometryOptions as R, VariableFontAxesSchema as Rn, Path3D as Rr, GlyphAnchorGroupingSchema as Rt, LoadModelOptions as S, TextPathSourceSchema as Sn, ENVIRONMENT_PRESETS as Sr, AudioSpectrumTypography as St, Mesh3DData as T, TextScrambleConfig as Tn, Environment3DOptions as Tr, ChromaticGlitchConfigSchema as Tt, SlugPipeline as U, VolumetricFormationMode as Un, Vec3 as Ur, LineSpacingDynamics as Ut, Skeleton3D as V, VolumetricFormationConfig as Vn, ResolvedEnvironment as Vr, KineticMarqueeConfig as Vt, SphereGeometryOptions as W, VolumetricFormationModeSchema as Wn, Vector3Math as Wr, LineSpacingDynamicsSchema as Wt, describeGpu as X, distanceToCurveParameter as Xn, PathChainLUTEntry as Xt, buildWGSLSignalFn as Y, deterministicWigglyNoise as Yn, PathChainLUT as Yt, ensureDevice as Z, ellipseToCubicBeziers as Zn, SelectorBasedOn as Zt, ExtrudeShapeGeometryOptions as _, TextCursorStyleSchema as _n, Camera3D as _r, AnchorPreset as _t, AudioLatentData as a, SkewProperties as an, evaluateTypewriterState as ar, parseMTL as at, LatheGeometryOptions as b, TextPathOptionsSchema as bn, CatmullRomOptions as br, AnimatableGlyphPropsSchema as bt, AudioMeshDeformPipeline as c, Spatial3DPropertiesSchema as cn, generatePathSegments as cr, signalRegistry as ct, AudioSignalComputePipeline as d, TextAnchorConfig as dn, parseSvgPathToCubicBeziers as dr, AETextAnimatorSchema as dt, SelectorModeSchema as en, evaluateExpressionSelector as er, loadFBX as et, BlendMode as f, TextAnchorConfigSchema as fn, sampleAudioSpectrumScale as fr, AdvancedTextAnimator as ft, EffectPipeline as g, TextCursorStyle as gn, BezierSegment3D as gr, AnchorGroupingSchema as gt, CylinderGeometryOptions as h, TextCursorConfigSchema as hn, waveToCubicBeziers as hr, AnchorGrouping as ht, AnimationClip3D as i, SelectorUnitsSchema as in, evaluateSpringProgress as ir, parseFBX as it, RenderContextValue as j, TextWigglySelector as jn, Light3D as jr, EnhancedTextNodeSchema as jt, Points3DGeometryOptions as k, TextSignalSelector as kn, HelixOptions as kr, DynamicStrokePropertiesSchema as kt, AudioPitchTrackConfig as l, SpringPhysics as ln, getScramblePool as lr, textureCache as lt, CapsuleGeometryOptions as m, TextCursorConfig as mn, samplePathChainGeometry as mr, AdvancedTextAnimatorSchema as mt, NodeRendererPlugin as n, SelectorShapeSchema as nn, evaluateSelectorCombination as nr, loadOBJ as nt, AudioLatentEngine as o, SkewPropertiesSchema as on, evaluateVolumetricFormation as or, parseOBJ as ot, Bone3D as p, TextAnimatorBuilder as pn, sampleCurveGeometry as pr, AdvancedTextAnimatorBuilder as pt, TubePathSpec as q, computeLineLeadingDisplacement as qn, resolveEnvironment as qr, ParticleDissolveConfig as qt, WebGPUNodeRenderer as r, SelectorUnits as rn, evaluateSkewMatrix as rr, lutStore as rt, AudioLatentTrackCache as s, Spatial3DProperties as sn, generateArcLengthLUT as sr, shaderStore as st, SignalResultSchema as t, SelectorShape as tn, evaluateMarqueeOffset as tr, loadModel3D as tt, AudioSignalComputeConfig as u, SpringPhysicsSchema as un, getShuffledOrder as ur, AETextAnimator as ut, GlassPipeline as v, TextPathBuilder as vn, Camera3DPose as vr, AnchorPresetSchema as vt, Material3D as w, TextRangeSelectorSchema as wn, Environment3DFog as wr, ChromaticGlitchConfig as wt, Line3DGeometryOptions as x, TextPathSource as xn, CirclePathOptions as xr, ArcLengthLUTEntry as xt, GpuAdapterDescription as y, TextPathOptions as yn, CameraShakeOptions as yr, AnimatableGlyphProps as yt, SignalRegistry as z, Vec2 as zn, Path3DPoint as zr, GlyphAnchorPoint as zt };
-//# sourceMappingURL=index-C2yaponf.d.mts.map
+//# sourceMappingURL=index-CRaydvLi.d.mts.map