@buffered-audio/nodes 0.20.0 → 0.22.0

package/README.md

@@ -43,47 +43,7 @@ await source.render();
 
 ## CLI
 
-### `process`
-
-Run pipelines from TypeScript files. The file's default export must be a `SourceNode`.
-
-```bash
-npx @buffered-audio/nodes process --pipeline pipeline.ts
-```
-
-```ts
-// pipeline.ts
-import { chain, read, normalize, trim, write } from "@buffered-audio/nodes";
-
-export default chain(read("input.wav"), normalize(), trim({ threshold: -60 }), write("output.wav"));
-```
-
-### `render`
-
-Render a `.bag` (Buffered Audio Graph) file. BAG files are JSON-serialized graph definitions.
-
-```bash
-npx @buffered-audio/nodes render pipeline.bag
-```
-
-| Flag                        | Description                                                  |
-| --------------------------- | ----------------------------------------------------------- |
-| `--chunk-size <samples>`    | Chunk size in samples                                       |
-| `--high-water-mark <count>` | Stream backpressure high water mark                         |
-| `--param <name=value>`      | Bind a `{{name}}` template placeholder (repeatable)         |
-
-#### Template parameters
-
-String values in a bag's node `parameters` may contain `{{name}}` placeholders. Each `--param name=value` binds one for that render; the same bag renders different inputs and outputs without editing the file. Every placeholder must be bound, and every `--param` must match a placeholder, or the render fails before any audio work.
-
-```json
-{ "id": "a", "packageName": "@buffered-audio/nodes", "packageVersion": "0.16.0", "nodeName": "Read",  "parameters": { "path": "{{episode}}/raw.wav" } }
-{ "id": "z", "packageName": "@buffered-audio/nodes", "packageVersion": "0.16.0", "nodeName": "Write", "parameters": { "path": "{{episode}}/master.wav" } }
-```
-
-```bash
-npx @buffered-audio/nodes render master.bag --param episode=./e260
-```
+Render `.bag` files and run pipelines from the command line with [`@buffered-audio/cli`](https://www.npmjs.com/package/@buffered-audio/cli).
 
 ## Nodes
 
@@ -438,7 +398,7 @@ Write audio to a file
 
 ## Creating Nodes
 
-Each node has two parts: a **Node** (inert descriptor) and a **Stream** (stateful runtime instance). The node is pure static declaration — `nodeName`, `description`, `schema`, `Stream`, plus `packageName`/`packageVersion` — and carries no per-render state. The executor constructs one stream per node per render.
+Each node has two parts: a **Node** (inert descriptor) and a **Stream** (stateful runtime instance). The node is pure static declaration — `nodeName`, `description`, `schema`, `Stream`, plus `packageName` — and carries no per-render state. The executor constructs one stream per node per render.
 
 Transforms extend one of two stream bases from `@buffered-audio/core`, picked by whether the node needs the whole signal (or fixed-size blocks) before it can produce output:
 
@@ -511,7 +471,6 @@ export class NormalizeStream extends BufferedTransformStream<NormalizeNode> {
 export class NormalizeNode extends TransformNode<NormalizeProperties> {
 	static override readonly nodeName = "Normalize";
 	static override readonly packageName = "@buffered-audio/nodes";
-	static override readonly packageVersion = "0.8.0";
 	static override readonly description = "Adjust peak or loudness level to a target ceiling";
 	static override readonly schema = schema;
 	static override readonly Stream = NormalizeStream;

package/dist/index.d.ts

@@ -27,7 +27,6 @@ declare class ReadFfmpegStream extends BufferedSourceStream<ReadFfmpegNode> {
 declare class ReadFfmpegNode extends SourceNode<ReadFfmpegProperties> {
     static readonly nodeName = "Read FFmpeg";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Read audio from a file using FFmpeg";
     static readonly schema: z.ZodObject<{
         path: z.ZodDefault<z.ZodString>;
@@ -62,7 +61,6 @@ declare class ReadWavStream extends BufferedSourceStream<ReadWavNode> {
 declare class ReadWavNode extends SourceNode<ReadWavProperties> {
     static readonly nodeName = "Read WAV";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Read audio from a WAV file";
     static readonly schema: z.ZodObject<{
         path: z.ZodDefault<z.ZodString>;
@@ -118,7 +116,6 @@ declare class LoudnessStatsStream extends BufferedTargetStream<LoudnessStatsNode
 declare class LoudnessStatsNode extends TargetNode<LoudnessStatsProperties> {
     static readonly nodeName = "Loudness Stats";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Measure integrated loudness, true peak, and loudness range per EBU R128, plus an amplitude-distribution histogram";
     static readonly schema: z.ZodObject<{
         bucketCount: z.ZodDefault<z.ZodNumber>;
@@ -176,7 +173,6 @@ declare class SpectrogramStream extends BufferedTargetStream<SpectrogramNode> {
 declare class SpectrogramNode extends TargetNode<SpectrogramProperties> {
     static readonly nodeName = "Spectrogram";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Generate spectrogram visualization data";
     static readonly schema: z.ZodObject<{
         outputPath: z.ZodDefault<z.ZodString>;
@@ -227,7 +223,6 @@ declare class WaveformStream extends BufferedTargetStream<WaveformNode> {
 declare class WaveformNode extends TargetNode<WaveformProperties> {
     static readonly nodeName = "Waveform";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Generate waveform visualization data";
     static readonly schema: z.ZodObject<{
         outputPath: z.ZodDefault<z.ZodString>;
@@ -275,7 +270,6 @@ declare class WriteStream extends BufferedTargetStream<WriteNode> {
 declare class WriteNode extends TargetNode<WriteProperties> {
     static readonly nodeName = "Write";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Write audio to a file";
     static readonly schema: z.ZodObject<{
         path: z.ZodDefault<z.ZodString>;
@@ -328,7 +322,6 @@ declare class CutStream extends UnbufferedTransformStream<CutNode> {
 declare class CutNode extends TransformNode<CutProperties> {
     static readonly nodeName = "Cut";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Remove a region of audio";
     static readonly schema: z.ZodObject<{
         regions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -355,7 +348,6 @@ declare class DitherStream extends UnbufferedTransformStream<DitherNode> {
 declare class DitherNode extends TransformNode<DitherProperties> {
     static readonly nodeName = "Dither";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Add shaped noise to reduce quantization distortion";
     static readonly schema: z.ZodObject<{
         bitDepth: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<16>, z.ZodLiteral<24>]>>;
@@ -382,7 +374,6 @@ declare class NormalizeStream extends BufferedTransformStream<NormalizeNode> {
 declare class NormalizeNode extends TransformNode<NormalizeProperties> {
     static readonly nodeName = "Normalize";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Adjust peak or loudness level to a target ceiling";
     static readonly schema: z.ZodObject<{
         ceiling: z.ZodDefault<z.ZodNumber>;
@@ -412,7 +403,6 @@ declare class PadStream extends UnbufferedTransformStream<PadNode> {
 declare class PadNode extends TransformNode<PadProperties> {
     static readonly nodeName = "Pad";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Add silence to start or end of audio";
     static readonly schema: z.ZodObject<{
         before: z.ZodDefault<z.ZodNumber>;
@@ -441,7 +431,6 @@ declare class PhaseStream extends UnbufferedTransformStream<PhaseNode> {
 declare class PhaseNode extends TransformNode<PhaseProperties> {
     static readonly nodeName = "Phase";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Invert or rotate signal phase";
     static readonly schema: z.ZodObject<{
         invert: z.ZodDefault<z.ZodBoolean>;
@@ -465,7 +454,6 @@ declare class ReverseStream extends BufferedTransformStream {
 declare class ReverseNode extends TransformNode {
     static readonly nodeName = "Reverse";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Reverse audio playback direction";
     static readonly schema: z.ZodObject<{}, z.core.$strip>;
     static readonly Stream: typeof ReverseStream;
@@ -492,7 +480,6 @@ declare class SpliceStream extends UnbufferedTransformStream<SpliceNode> {
 declare class SpliceNode extends TransformNode<SpliceProperties> {
     static readonly nodeName = "Splice";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Replace a region of audio with processed content";
     static readonly schema: z.ZodObject<{
         insertPath: z.ZodDefault<z.ZodString>;
@@ -523,7 +510,6 @@ declare class TrimStream extends BufferedTransformStream<TrimNode> {
 declare class TrimNode extends TransformNode<TrimProperties> {
     static readonly nodeName = "Trim";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Remove silence from start and end";
     static readonly schema: z.ZodObject<{
         threshold: z.ZodDefault<z.ZodNumber>;
@@ -547,7 +533,6 @@ declare class DownmixMonoStream extends UnbufferedTransformStream {
 declare class DownmixMonoNode extends TransformNode {
     static readonly nodeName = "Downmix Mono";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Mix all input channels to a single mono channel by averaging";
     static readonly schema: z.ZodObject<{}, z.core.$strip>;
     static readonly Stream: typeof DownmixMonoStream;
@@ -567,7 +552,6 @@ declare class DuplicateChannelsStream extends UnbufferedTransformStream<Duplicat
 declare class DuplicateChannelsNode extends TransformNode<DuplicateChannelsProperties> {
     static readonly nodeName = "Duplicate Channels";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Duplicate a mono signal into multiple identical output channels; requires exactly 1 input channel, throws otherwise";
     static readonly schema: z.ZodObject<{
         channels: z.ZodDefault<z.ZodNumber>;
@@ -590,7 +574,6 @@ declare class GainStream extends UnbufferedTransformStream<GainNode> {
 declare class GainNode extends TransformNode<GainProperties> {
     static readonly nodeName = "Gain";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Adjust signal level by a fixed amount in dB";
     static readonly schema: z.ZodObject<{
         gain: z.ZodDefault<z.ZodNumber>;
@@ -613,7 +596,6 @@ declare class PanStream extends UnbufferedTransformStream<PanNode> {
 declare class PanNode extends TransformNode<PanProperties> {
     static readonly nodeName = "Pan";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Position mono signal in stereo field or adjust stereo balance; throws for inputs with more than 2 channels";
     static readonly schema: z.ZodObject<{
         pan: z.ZodDefault<z.ZodNumber>;
@@ -654,7 +636,6 @@ declare class FfmpegStream<P extends FfmpegProperties = FfmpegProperties> extend
 declare class FfmpegNode<P extends FfmpegProperties = FfmpegProperties> extends TransformNode<P> {
     static readonly nodeName: string;
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description: string;
     static readonly schema: z.ZodType;
     static readonly Stream: typeof FfmpegStream;
@@ -703,7 +684,6 @@ declare class LoudnessTargetStream extends BufferedTransformStream<LoudnessTarge
 declare class LoudnessTargetNode extends TransformNode<LoudnessTargetProperties> {
     static readonly nodeName = "Loudness Target";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Peak-aware content-adaptive curve fitting (LUFS, true-peak, LRA) via a single combined gain envelope with a peak-respecting two-stage smoother. The upper-arm peak anchor jointly iterates with the body gain to land both LUFS and true-peak targets in one envelope.";
     static readonly schema: z.ZodObject<{
         targetLufs: z.ZodDefault<z.ZodNumber>;
@@ -747,7 +727,6 @@ declare class LoudnessNormalizeStream extends BufferedTransformStream<LoudnessNo
 declare class LoudnessNormalizeNode extends TransformNode<LoudnessNormalizeProperties> {
     static readonly nodeName = "Loudness Normalize";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Measure integrated loudness (BS.1770) and apply a single linear gain to hit a target LUFS \u2014 no limiting, no dynamics";
     static readonly schema: z.ZodObject<{
         target: z.ZodDefault<z.ZodNumber>;
@@ -774,7 +753,6 @@ declare class TruePeakNormalizeStream extends BufferedTransformStream<TruePeakNo
 declare class TruePeakNormalizeNode extends TransformNode<TruePeakNormalizeProperties> {
     static readonly nodeName = "True Peak Normalize";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Measure source true peak (4\u00D7 upsampled, BS.1770-4 style) and apply a single linear gain to hit a target dBTP";
     static readonly schema: z.ZodObject<{
         target: z.ZodDefault<z.ZodNumber>;
@@ -807,7 +785,6 @@ declare class CrestReduceStream extends BufferedTransformStream<CrestReduceNode>
 declare class CrestReduceNode extends TransformNode<CrestReduceProperties> {
     static readonly nodeName = "Crest Reduce";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Content-adaptive, magnitude-preserving, phase-only crest-factor reducer \u2014 a pre-limiter headroom stage that rearranges signal phase to flatten true-peak excursions without changing the magnitude spectrum, never increasing crest factor";
     static readonly schema: z.ZodObject<{
         smoothing: z.ZodDefault<z.ZodNumber>;
@@ -861,7 +838,6 @@ declare class DeBleedStream extends BufferedTransformStream<DeBleedNode> {
 declare class DeBleedNode extends TransformNode<DeBleedProperties> {
     static readonly nodeName = "De-Bleed Adaptive";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Adaptive (MEF FDAF Kalman + MWF + MSAD) reference-based microphone bleed reduction. Stages 1+2 are MEF Meyer-Elshamy-Fingscheidt 2020; Stage 3 is Lukin-Todd 2D NLM+DFTT post-filter.";
     static readonly schema: z.ZodObject<{
         references: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -918,7 +894,6 @@ declare class DeepFilterNet3Stream extends BufferedTransformStream<DeepFilterNet
 declare class DeepFilterNet3Node extends TransformNode<DeepFilterNet3Properties> {
     static readonly nodeName = "DeepFilterNet3 (Denoiser)";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Remove background noise from speech using DeepFilterNet3 (48 kHz full-band CRN)";
     static readonly schema: z.ZodObject<{
         modelPath: z.ZodDefault<z.ZodString>;
@@ -961,7 +936,6 @@ declare class DtlnStream extends BufferedTransformStream<DtlnNode> {
 declare class DtlnNode extends TransformNode<DtlnProperties> {
     static readonly nodeName = "DTLN (Denoiser)";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Remove background noise from speech using DTLN neural network";
     static readonly schema: z.ZodObject<{
         modelPath1: z.ZodDefault<z.ZodString>;
@@ -1010,7 +984,6 @@ declare class HtdemucsStream extends BufferedTransformStream<HtdemucsNode> {
 declare class HtdemucsNode extends TransformNode<HtdemucsProperties> {
     static readonly nodeName = "HTDemucs (Stem Separator)";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Rebalance stem volumes using HTDemucs source separation";
     static readonly schema: z.ZodObject<{
         modelPath: z.ZodDefault<z.ZodString>;
@@ -1049,7 +1022,6 @@ declare class KimVocal2Stream extends BufferedTransformStream<KimVocal2Node> {
 declare class KimVocal2Node extends TransformNode<KimVocal2Properties> {
     static readonly nodeName = "Kim Vocal 2 (Stem Separator)";
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description = "Isolate dialogue from background using MDX-Net vocal separation";
     static readonly schema: z.ZodObject<{
         modelPath: z.ZodDefault<z.ZodString>;
@@ -1093,7 +1065,6 @@ declare class Vst3Stream<P extends Vst3Properties = Vst3Properties> extends Buff
 declare class Vst3Node<P extends Vst3Properties = Vst3Properties> extends TransformNode<P> {
     static readonly nodeName: string;
     static readonly packageName: string;
-    static readonly packageVersion: string;
     static readonly description: string;
     static readonly schema: z.ZodType;
     static readonly Stream: typeof Vst3Stream;

package/dist/index.js

@@ -16714,7 +16714,7 @@ __export2(core_exports22, {
   parse: () => parse3,
   parseAsync: () => parseAsync3,
   prettifyError: () => prettifyError2,
-  process: () => process3,
+  process: () => process22,
   regexes: () => regexes_exports2,
   registry: () => registry2,
   safeDecode: () => safeDecode3,
@@ -26989,7 +26989,7 @@ function initializeContext2(params) {
     external: params?.external ?? void 0
   };
 }
-function process3(schema28, ctx, _params = { path: [], schemaPath: [] }) {
+function process22(schema28, ctx, _params = { path: [], schemaPath: [] }) {
   var _a22;
   const def = schema28._zod.def;
   const seen = ctx.seen.get(schema28);
@@ -27026,7 +27026,7 @@ function process3(schema28, ctx, _params = { path: [], schemaPath: [] }) {
     if (parent) {
       if (!result.ref)
         result.ref = parent;
-      process3(parent, ctx, params);
+      process22(parent, ctx, params);
       ctx.seen.get(parent).isParent = true;
     }
   }
@@ -27306,14 +27306,14 @@ function isTransforming2(_schema, _ctx) {
 }
 var createToJSONSchemaMethod2 = (schema28, processors = {}) => (params) => {
   const ctx = initializeContext2({ ...params, processors });
-  process3(schema28, ctx);
+  process22(schema28, ctx);
   extractDefs2(ctx, schema28);
   return finalize2(ctx, schema28);
 };
 var createStandardJSONSchemaMethod2 = (schema28, io, processors = {}) => (params) => {
   const { libraryOptions, target } = params ?? {};
   const ctx = initializeContext2({ ...libraryOptions ?? {}, target, io, processors });
-  process3(schema28, ctx);
+  process22(schema28, ctx);
   extractDefs2(ctx, schema28);
   return finalize2(ctx, schema28);
 };
@@ -27567,7 +27567,7 @@ var arrayProcessor2 = (schema28, ctx, _json, params) => {
   if (typeof maximum === "number")
     json22.maxItems = maximum;
   json22.type = "array";
-  json22.items = process3(def.element, ctx, { ...params, path: [...params.path, "items"] });
+  json22.items = process22(def.element, ctx, { ...params, path: [...params.path, "items"] });
 };
 var objectProcessor2 = (schema28, ctx, _json, params) => {
   const json22 = _json;
@@ -27576,7 +27576,7 @@ var objectProcessor2 = (schema28, ctx, _json, params) => {
   json22.properties = {};
   const shape = def.shape;
   for (const key in shape) {
-    json22.properties[key] = process3(shape[key], ctx, {
+    json22.properties[key] = process22(shape[key], ctx, {
       ...params,
       path: [...params.path, "properties", key]
     });
@@ -27599,7 +27599,7 @@ var objectProcessor2 = (schema28, ctx, _json, params) => {
     if (ctx.io === "output")
       json22.additionalProperties = false;
   } else if (def.catchall) {
-    json22.additionalProperties = process3(def.catchall, ctx, {
+    json22.additionalProperties = process22(def.catchall, ctx, {
       ...params,
       path: [...params.path, "additionalProperties"]
     });
@@ -27608,7 +27608,7 @@ var objectProcessor2 = (schema28, ctx, _json, params) => {
 var unionProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
   const isExclusive = def.inclusive === false;
-  const options = def.options.map((x, i) => process3(x, ctx, {
+  const options = def.options.map((x, i) => process22(x, ctx, {
     ...params,
     path: [...params.path, isExclusive ? "oneOf" : "anyOf", i]
   }));
@@ -27620,11 +27620,11 @@ var unionProcessor2 = (schema28, ctx, json22, params) => {
 };
 var intersectionProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
-  const a = process3(def.left, ctx, {
+  const a = process22(def.left, ctx, {
     ...params,
     path: [...params.path, "allOf", 0]
   });
-  const b = process3(def.right, ctx, {
+  const b = process22(def.right, ctx, {
     ...params,
     path: [...params.path, "allOf", 1]
   });
@@ -27641,11 +27641,11 @@ var tupleProcessor2 = (schema28, ctx, _json, params) => {
   json22.type = "array";
   const prefixPath = ctx.target === "draft-2020-12" ? "prefixItems" : "items";
   const restPath = ctx.target === "draft-2020-12" ? "items" : ctx.target === "openapi-3.0" ? "items" : "additionalItems";
-  const prefixItems = def.items.map((x, i) => process3(x, ctx, {
+  const prefixItems = def.items.map((x, i) => process22(x, ctx, {
     ...params,
     path: [...params.path, prefixPath, i]
   }));
-  const rest = def.rest ? process3(def.rest, ctx, {
+  const rest = def.rest ? process22(def.rest, ctx, {
     ...params,
     path: [...params.path, restPath, ...ctx.target === "openapi-3.0" ? [def.items.length] : []]
   }) : null;
@@ -27685,7 +27685,7 @@ var recordProcessor2 = (schema28, ctx, _json, params) => {
   const keyBag = keyType._zod.bag;
   const patterns = keyBag?.patterns;
   if (def.mode === "loose" && patterns && patterns.size > 0) {
-    const valueSchema = process3(def.valueType, ctx, {
+    const valueSchema = process22(def.valueType, ctx, {
       ...params,
       path: [...params.path, "patternProperties", "*"]
     });
@@ -27695,12 +27695,12 @@ var recordProcessor2 = (schema28, ctx, _json, params) => {
     }
   } else {
     if (ctx.target === "draft-07" || ctx.target === "draft-2020-12") {
-      json22.propertyNames = process3(def.keyType, ctx, {
+      json22.propertyNames = process22(def.keyType, ctx, {
         ...params,
         path: [...params.path, "propertyNames"]
       });
     }
-    json22.additionalProperties = process3(def.valueType, ctx, {
+    json22.additionalProperties = process22(def.valueType, ctx, {
       ...params,
       path: [...params.path, "additionalProperties"]
     });
@@ -27715,7 +27715,7 @@ var recordProcessor2 = (schema28, ctx, _json, params) => {
 };
 var nullableProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
-  const inner = process3(def.innerType, ctx, params);
+  const inner = process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   if (ctx.target === "openapi-3.0") {
     seen.ref = def.innerType;
@@ -27726,20 +27726,20 @@ var nullableProcessor2 = (schema28, ctx, json22, params) => {
 };
 var nonoptionalProcessor2 = (schema28, ctx, _json, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
 };
 var defaultProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
   json22.default = JSON.parse(JSON.stringify(def.defaultValue));
 };
 var prefaultProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
   if (ctx.io === "input")
@@ -27747,7 +27747,7 @@ var prefaultProcessor2 = (schema28, ctx, json22, params) => {
 };
 var catchProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
   let catchValue;
@@ -27761,32 +27761,32 @@ var catchProcessor2 = (schema28, ctx, json22, params) => {
 var pipeProcessor2 = (schema28, ctx, _json, params) => {
   const def = schema28._zod.def;
   const innerType = ctx.io === "input" ? def.in._zod.def.type === "transform" ? def.out : def.in : def.out;
-  process3(innerType, ctx, params);
+  process22(innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = innerType;
 };
 var readonlyProcessor2 = (schema28, ctx, json22, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
   json22.readOnly = true;
 };
 var promiseProcessor2 = (schema28, ctx, _json, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
 };
 var optionalProcessor2 = (schema28, ctx, _json, params) => {
   const def = schema28._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = def.innerType;
 };
 var lazyProcessor2 = (schema28, ctx, _json, params) => {
   const innerType = schema28._zod.innerType;
-  process3(innerType, ctx, params);
+  process22(innerType, ctx, params);
   const seen = ctx.seen.get(schema28);
   seen.ref = innerType;
 };
@@ -27838,7 +27838,7 @@ function toJSONSchema2(input, params) {
     const defs = {};
     for (const entry of registry22._idmap.entries()) {
       const [_, schema28] = entry;
-      process3(schema28, ctx2);
+      process22(schema28, ctx2);
     }
     const schemas = {};
     const external = {
@@ -27861,7 +27861,7 @@ function toJSONSchema2(input, params) {
     return { schemas };
   }
   const ctx = initializeContext2({ ...params, processors: allProcessors2 });
-  process3(input, ctx);
+  process22(input, ctx);
   extractDefs2(ctx, input);
   return finalize2(ctx, input);
 }
@@ -27917,7 +27917,7 @@ var JSONSchemaGenerator2 = class {
    * This must be called before emit().
    */
   process(schema28, _params = { path: [], schemaPath: [] }) {
-    return process3(schema28, this.ctx, _params);
+    return process22(schema28, this.ctx, _params);
   }
   /**
    * Emit the final JSON Schema after processing.
@@ -29850,7 +29850,6 @@ var BufferedAudioNode = class {
     return this.properties.children ?? [];
   }
 };
-BufferedAudioNode.packageVersion = "0.0.0";
 BufferedAudioNode.apiVersion = 1;
 BufferedAudioNode.description = "";
 BufferedAudioNode.schema = external_exports2.object({});
@@ -30022,8 +30021,14 @@ var RenderJob = class {
     } else {
       this.streamsMap.set(node, [stream]);
     }
+    const effective = this.effectiveChildren(node.children, path2);
+    if (effective.length === 0 && typeof node.to === "function") {
+      const nodeName = node.constructor.nodeName;
+      const suffix = node.id !== void 0 ? `#${node.id}` : "";
+      throw new Error(`Graph leaf "${nodeName}"${suffix} is not a target \u2014 every path must end in a target node`);
+    }
     const children = [];
-    for (const child of this.effectiveChildren(node.children, path2)) {
+    for (const child of effective) {
       children.push(this.build(child, path2));
     }
     path2.delete(node);
@@ -30113,7 +30118,6 @@ var TransformNode = class extends BufferedAudioNode {
 var graphNodeSchema = external_exports2.object({
   id: external_exports2.string().min(1),
   packageName: external_exports2.string().min(1),
-  packageVersion: external_exports2.string().min(1),
   nodeName: external_exports2.string().min(1),
   parameters: external_exports2.record(external_exports2.string(), external_exports2.unknown()).optional(),
   options: external_exports2.object({
@@ -30128,18 +30132,23 @@ external_exports2.object({
   id: external_exports2.uuid(),
   name: external_exports2.string().default("Untitled"),
   apiVersion: external_exports2.number().int().min(1),
+  packages: external_exports2.record(external_exports2.string(), external_exports2.string().min(1)),
   nodes: external_exports2.array(graphNodeSchema),
   edges: external_exports2.array(graphEdgeSchema)
+}).superRefine((definition, context) => {
+  for (const node of definition.nodes) {
+    if (!Object.prototype.hasOwnProperty.call(definition.packages, node.packageName)) {
+      context.addIssue(`Node "${node.id}" references package "${node.packageName}" which has no entry in the graph packages map`);
+    }
+  }
 });
 
 // package.json
 var package_default = {
-  name: "@buffered-audio/nodes",
-  version: "0.20.0"};
+  name: "@buffered-audio/nodes"};
 
 // src/package-metadata.ts
 var PACKAGE_NAME = package_default.name;
-var PACKAGE_VERSION = package_default.version;
 
 // src/sources/read/ffmpeg/index.ts
 var ffmpegSchema = external_exports.object({
@@ -30320,7 +30329,6 @@ var ReadFfmpegNode = class extends SourceNode {
 };
 ReadFfmpegNode.nodeName = "Read FFmpeg";
 ReadFfmpegNode.packageName = PACKAGE_NAME;
-ReadFfmpegNode.packageVersion = PACKAGE_VERSION;
 ReadFfmpegNode.description = "Read audio from a file using FFmpeg";
 ReadFfmpegNode.schema = ffmpegSchema;
 ReadFfmpegNode.Stream = ReadFfmpegStream;
@@ -30489,7 +30497,6 @@ var ReadWavNode = class extends SourceNode {
 };
 ReadWavNode.nodeName = "Read WAV";
 ReadWavNode.packageName = PACKAGE_NAME;
-ReadWavNode.packageVersion = PACKAGE_VERSION;
 ReadWavNode.description = "Read audio from a WAV file";
 ReadWavNode.schema = wavSchema;
 ReadWavNode.Stream = ReadWavStream;
@@ -30535,7 +30542,7 @@ function amplitudePercentile(buckets, bucketMax, totalSamples, percent) {
 // src/targets/loudness-stats/index.ts
 var schema = external_exports.object({
   bucketCount: external_exports.number().int().positive().default(1024).describe("Amplitude histogram bucket count"),
-  outputPath: external_exports.string().default("").meta({ input: "file", mode: "save" }).describe("Output Path (JSON sidecar). Empty string disables file output.")
+  outputPath: external_exports.string().default("").meta({ input: "file", mode: "save", accept: ".json" }).describe("Output Path (JSON sidecar). Empty string disables file output.")
 });
 var LoudnessStatsStream = class extends BufferedTargetStream {
   constructor() {
@@ -30622,7 +30629,6 @@ var LoudnessStatsNode = class extends TargetNode {
 };
 LoudnessStatsNode.nodeName = "Loudness Stats";
 LoudnessStatsNode.packageName = PACKAGE_NAME;
-LoudnessStatsNode.packageVersion = PACKAGE_VERSION;
 LoudnessStatsNode.description = "Measure integrated loudness, true peak, and loudness range per EBU R128, plus an amplitude-distribution histogram";
 LoudnessStatsNode.schema = schema;
 LoudnessStatsNode.Stream = LoudnessStatsStream;
@@ -30764,7 +30770,7 @@ function computeLogBandMappings(numBands, minFreq, maxFreq, sampleRate, fftSize)
 
 // src/targets/spectrogram/index.ts
 var schema2 = external_exports.object({
-  outputPath: external_exports.string().default("").meta({ input: "file", mode: "save" }).describe("Output Path"),
+  outputPath: external_exports.string().default("").meta({ input: "file", mode: "save", accept: ".bin" }).describe("Output Path"),
   fftSize: external_exports.number().min(256).max(8192).multipleOf(256).default(2048).describe("FFT Size"),
   hopSize: external_exports.number().min(64).max(8192).multipleOf(64).default(512).describe("Hop Size"),
   fftwAddonPath: external_exports.string().default("").meta({ input: "file", mode: "open", binary: "fftw-addon" }).describe("FFTW Addon")
@@ -30948,7 +30954,6 @@ var SpectrogramNode = class extends TargetNode {
 };
 SpectrogramNode.nodeName = "Spectrogram";
 SpectrogramNode.packageName = PACKAGE_NAME;
-SpectrogramNode.packageVersion = PACKAGE_VERSION;
 SpectrogramNode.description = "Generate spectrogram visualization data";
 SpectrogramNode.schema = schema2;
 SpectrogramNode.Stream = SpectrogramStream;
@@ -30975,7 +30980,7 @@ function writeMinMaxPoint(min, max, channels, target, offset) {
 
 // src/targets/waveform/index.ts
 var schema3 = external_exports.object({
-  outputPath: external_exports.string().default("").meta({ input: "file", mode: "save" }).describe("Output Path"),
+  outputPath: external_exports.string().default("").meta({ input: "file", mode: "save", accept: ".bin" }).describe("Output Path"),
   resolution: external_exports.number().min(100).max(1e4).multipleOf(100).default(1e3).describe("Resolution")
 });
 var HEADER_SIZE2 = 16;
@@ -31077,7 +31082,6 @@ var WaveformNode = class extends TargetNode {
 };
 WaveformNode.nodeName = "Waveform";
 WaveformNode.packageName = PACKAGE_NAME;
-WaveformNode.packageVersion = PACKAGE_VERSION;
 WaveformNode.description = "Generate waveform visualization data";
 WaveformNode.schema = schema3;
 WaveformNode.Stream = WaveformStream;
@@ -31218,11 +31222,11 @@ function bitDepthToPcmFormat(bitDepth) {
 var encodingSchema = external_exports.object({
   format: external_exports.enum(["wav", "flac", "mp3", "aac"]),
   bitrate: external_exports.string().optional(),
-  vbr: external_exports.number().optional(),
+  vbr: external_exports.number().min(0).max(9).optional(),
   sampleRate: external_exports.number().int().positive().optional().describe("Output sample rate (Hz). When set, ffmpeg resamples on encode.")
 });
 var schema4 = external_exports.object({
-  path: external_exports.string().default("").meta({ input: "file", mode: "save" }),
+  path: external_exports.string().default("").meta({ input: "file", mode: "save", accept: ".wav,.flac,.mp3,.aac" }),
   ffmpegPath: external_exports.string().default("").meta({ input: "file", mode: "open", binary: "ffmpeg", download: "https://ffmpeg.org/download.html" }).describe("FFmpeg \u2014 audio/video processing tool"),
   bitDepth: external_exports.enum(["16", "24", "32", "32f"]).default("16"),
   encoding: encodingSchema.optional().describe("Encode through ffmpeg to a non-WAV format. Requires `ffmpegPath`.")
@@ -31382,7 +31386,6 @@ var WriteNode = class extends TargetNode {
 };
 WriteNode.nodeName = "Write";
 WriteNode.packageName = PACKAGE_NAME;
-WriteNode.packageVersion = PACKAGE_VERSION;
 WriteNode.description = "Write audio to a file";
 WriteNode.schema = schema4;
 WriteNode.Stream = WriteStream;
@@ -31413,8 +31416,8 @@ function computeKeepRanges(sortedRegions, chunkStartSec, sampleRate, chunkFrames
 
 // src/transforms/cut/index.ts
 var cutRegionSchema = external_exports.object({
-  start: external_exports.number().min(0).describe("Start (seconds)"),
-  end: external_exports.number().min(0).describe("End (seconds)")
+  start: external_exports.number().min(0).max(86400).describe("Start (seconds)"),
+  end: external_exports.number().min(0).max(86400).describe("End (seconds)")
 });
 var schema5 = external_exports.object({
   regions: external_exports.array(cutRegionSchema).default([]).describe("Regions")
@@ -31461,7 +31464,6 @@ var CutNode = class extends TransformNode {
 };
 CutNode.nodeName = "Cut";
 CutNode.packageName = PACKAGE_NAME;
-CutNode.packageVersion = PACKAGE_VERSION;
 CutNode.description = "Remove a region of audio";
 CutNode.schema = schema5;
 CutNode.Stream = CutStream;
@@ -31518,7 +31520,6 @@ var DitherNode = class extends TransformNode {
 };
 DitherNode.nodeName = "Dither";
 DitherNode.packageName = PACKAGE_NAME;
-DitherNode.packageVersion = PACKAGE_VERSION;
 DitherNode.description = "Add shaped noise to reduce quantization distortion";
 DitherNode.schema = schema6;
 DitherNode.Stream = DitherStream;
@@ -31579,7 +31580,6 @@ var NormalizeNode = class extends TransformNode {
 };
 NormalizeNode.nodeName = "Normalize";
 NormalizeNode.packageName = PACKAGE_NAME;
-NormalizeNode.packageVersion = PACKAGE_VERSION;
 NormalizeNode.description = "Adjust peak or loudness level to a target ceiling";
 NormalizeNode.schema = schema7;
 NormalizeNode.Stream = NormalizeStream;
@@ -31602,8 +31602,8 @@ function silenceChunkSizes(total, chunkFrames) {
 
 // src/transforms/pad/index.ts
 var schema8 = external_exports.object({
-  before: external_exports.number().min(0).multipleOf(1e-3).default(0).describe("Before"),
-  after: external_exports.number().min(0).multipleOf(1e-3).default(0).describe("After")
+  before: external_exports.number().min(0).max(300).multipleOf(1e-3).default(0).describe("Before"),
+  after: external_exports.number().min(0).max(300).multipleOf(1e-3).default(0).describe("After")
 });
 var PadStream = class extends UnbufferedTransformStream {
   constructor() {
@@ -31653,7 +31653,6 @@ var PadNode = class extends TransformNode {
 };
 PadNode.nodeName = "Pad";
 PadNode.packageName = PACKAGE_NAME;
-PadNode.packageVersion = PACKAGE_VERSION;
 PadNode.description = "Add silence to start or end of audio";
 PadNode.schema = schema8;
 PadNode.Stream = PadStream;
@@ -31728,7 +31727,6 @@ var PhaseNode = class extends TransformNode {
 };
 PhaseNode.nodeName = "Phase";
 PhaseNode.packageName = PACKAGE_NAME;
-PhaseNode.packageVersion = PACKAGE_VERSION;
 PhaseNode.description = "Invert or rotate signal phase";
 PhaseNode.schema = schema9;
 PhaseNode.Stream = PhaseStream;
@@ -31763,7 +31761,6 @@ var ReverseNode = class extends TransformNode {
 };
 ReverseNode.nodeName = "Reverse";
 ReverseNode.packageName = PACKAGE_NAME;
-ReverseNode.packageVersion = PACKAGE_VERSION;
 ReverseNode.description = "Reverse audio playback direction";
 ReverseNode.schema = schema10;
 ReverseNode.Stream = ReverseStream;
@@ -31822,7 +31819,7 @@ function applyInsert(destChannel, insertChannel, overlap) {
 // src/transforms/splice/index.ts
 var schema11 = external_exports.object({
   insertPath: external_exports.string().default("").meta({ input: "file", mode: "open", accept: ".wav" }).describe("Insert File Path"),
-  insertAt: external_exports.number().min(0).default(0).describe("Insert At (frames)")
+  insertAt: external_exports.number().min(0).max(1e9).default(0).describe("Insert At (frames)")
 });
 var SpliceStream = class extends UnbufferedTransformStream {
   constructor() {
@@ -31884,7 +31881,6 @@ var SpliceNode = class extends TransformNode {
 };
 SpliceNode.nodeName = "Splice";
 SpliceNode.packageName = PACKAGE_NAME;
-SpliceNode.packageVersion = PACKAGE_VERSION;
 SpliceNode.description = "Replace a region of audio with processed content";
 SpliceNode.schema = schema11;
 SpliceNode.Stream = SpliceStream;
@@ -31984,7 +31980,6 @@ var TrimNode = class extends TransformNode {
 };
 TrimNode.nodeName = "Trim";
 TrimNode.packageName = PACKAGE_NAME;
-TrimNode.packageVersion = PACKAGE_VERSION;
 TrimNode.description = "Remove silence from start and end";
 TrimNode.schema = schema12;
 TrimNode.Stream = TrimStream;
@@ -32024,7 +32019,6 @@ var DownmixMonoNode = class extends TransformNode {
 };
 DownmixMonoNode.nodeName = "Downmix Mono";
 DownmixMonoNode.packageName = PACKAGE_NAME;
-DownmixMonoNode.packageVersion = PACKAGE_VERSION;
 DownmixMonoNode.description = "Mix all input channels to a single mono channel by averaging";
 DownmixMonoNode.schema = schema13;
 DownmixMonoNode.Stream = DownmixMonoStream;
@@ -32055,7 +32049,6 @@ var DuplicateChannelsNode = class extends TransformNode {
 };
 DuplicateChannelsNode.nodeName = "Duplicate Channels";
 DuplicateChannelsNode.packageName = PACKAGE_NAME;
-DuplicateChannelsNode.packageVersion = PACKAGE_VERSION;
 DuplicateChannelsNode.description = "Duplicate a mono signal into multiple identical output channels; requires exactly 1 input channel, throws otherwise";
 DuplicateChannelsNode.schema = schema14;
 DuplicateChannelsNode.Stream = DuplicateChannelsStream;
@@ -32088,7 +32081,6 @@ var GainNode = class extends TransformNode {
 };
 GainNode.nodeName = "Gain";
 GainNode.packageName = PACKAGE_NAME;
-GainNode.packageVersion = PACKAGE_VERSION;
 GainNode.description = "Adjust signal level by a fixed amount in dB";
 GainNode.schema = schema15;
 GainNode.Stream = GainStream;
@@ -32147,7 +32139,6 @@ var PanNode = class extends TransformNode {
 };
 PanNode.nodeName = "Pan";
 PanNode.packageName = PACKAGE_NAME;
-PanNode.packageVersion = PACKAGE_VERSION;
 PanNode.description = "Position mono signal in stereo field or adjust stereo balance; throws for inputs with more than 2 channels";
 PanNode.schema = schema16;
 PanNode.Stream = PanStream;
@@ -32349,7 +32340,6 @@ var FfmpegNode = class extends TransformNode {
 };
 FfmpegNode.nodeName = "FFmpeg";
 FfmpegNode.packageName = PACKAGE_NAME;
-FfmpegNode.packageVersion = PACKAGE_VERSION;
 FfmpegNode.description = "Process audio through FFmpeg filters";
 FfmpegNode.schema = schema17;
 FfmpegNode.Stream = FfmpegStream;
@@ -33191,15 +33181,15 @@ function predictInitialB(args) {
 var FLOOR_PIVOT_EPSILON_DB = 0.01;
 var schema18 = external_exports.object({
   targetLufs: external_exports.number().min(-50).max(0).multipleOf(0.1).default(-16).describe("Target integrated loudness (LUFS)"),
-  pivot: external_exports.number().lt(0).optional().describe("Body anchor (dB). Default: median(considered LRA blocks) from BS.1770 LRA gating in pass 1."),
-  floor: external_exports.number().lt(0).optional().describe("Silence threshold (dB). Default: min(considered LRA blocks); no floor when no blocks survive gating."),
+  pivot: external_exports.number().min(-80).lt(0).optional().describe("Body anchor (dB). Default: median(considered LRA blocks) from BS.1770 LRA gating in pass 1."),
+  floor: external_exports.number().min(-100).lt(0).optional().describe("Silence threshold (dB). Default: min(considered LRA blocks); no floor when no blocks survive gating."),
   limitPercentile: external_exports.number().min(0.5).max(1).default(0.995).describe("Top-1\u2212p fraction of detection samples to brick-wall. Default 0.995 brick-walls the top 0.5%."),
-  limitDb: external_exports.number().lt(0).optional().describe("Limit-anchor override (dB). Default: auto-derived from quantile(detection histogram, limitPercentile). Set explicitly to fix the limit anchor."),
+  limitDb: external_exports.number().min(-60).lt(0).optional().describe("Limit-anchor override (dB). Default: auto-derived from quantile(detection histogram, limitPercentile). Set explicitly to fix the limit anchor."),
   maxAttempts: external_exports.number().int().min(1).default(10).describe("Hard cap on iteration attempts."),
-  targetTp: external_exports.number().lt(0).optional().describe("True-peak target (dBTP). Default: source true peak (peaks unchanged)."),
+  targetTp: external_exports.number().min(-24).lt(0).optional().describe("True-peak target (dBTP). Default: source true peak (peaks unchanged)."),
   smoothing: external_exports.number().min(0.01).max(200).default(1).describe("Peak-respecting envelope time constant (ms)."),
-  tolerance: external_exports.number().gt(0).default(0.5).describe("Iteration exit threshold (LUFS dB)."),
-  peakTolerance: external_exports.number().gt(0).default(0.1).describe("One-sided iteration exit threshold for output true-peak overshoot (dBTP; ceiling \u2014 undershoot ignored).")
+  tolerance: external_exports.number().gt(0).max(6).default(0.5).describe("Iteration exit threshold (LUFS dB)."),
+  peakTolerance: external_exports.number().gt(0).max(6).default(0.1).describe("One-sided iteration exit threshold for output true-peak overshoot (dBTP; ceiling \u2014 undershoot ignored).")
 }).refine(
   ({ floor, pivot }) => floor === void 0 || pivot === void 0 || floor < pivot,
   { message: "loudnessTarget requires floor < pivot when floor is set" }
@@ -33477,7 +33467,6 @@ var LoudnessTargetNode = class extends TransformNode {
 };
 LoudnessTargetNode.nodeName = "Loudness Target";
 LoudnessTargetNode.packageName = PACKAGE_NAME;
-LoudnessTargetNode.packageVersion = PACKAGE_VERSION;
 LoudnessTargetNode.description = "Peak-aware content-adaptive curve fitting (LUFS, true-peak, LRA) via a single combined gain envelope with a peak-respecting two-stage smoother. The upper-arm peak anchor jointly iterates with the body gain to land both LUFS and true-peak targets in one envelope.";
 LoudnessTargetNode.schema = schema18;
 LoudnessTargetNode.Stream = LoudnessTargetStream;
@@ -33531,7 +33520,6 @@ var LoudnessNormalizeNode = class extends TransformNode {
 };
 LoudnessNormalizeNode.nodeName = "Loudness Normalize";
 LoudnessNormalizeNode.packageName = PACKAGE_NAME;
-LoudnessNormalizeNode.packageVersion = PACKAGE_VERSION;
 LoudnessNormalizeNode.description = "Measure integrated loudness (BS.1770) and apply a single linear gain to hit a target LUFS \u2014 no limiting, no dynamics";
 LoudnessNormalizeNode.schema = schema19;
 LoudnessNormalizeNode.Stream = LoudnessNormalizeStream;
@@ -33548,7 +33536,7 @@ function resolveTruePeakGain(sourcePeakLinear, target) {
 
 // src/transforms/true-peak-normalize/index.ts
 var schema20 = external_exports.object({
-  target: external_exports.number().lt(0).default(-1).describe("Target true peak (dBTP). Must be < 0.")
+  target: external_exports.number().min(-24).lt(0).default(-1).describe("Target true peak (dBTP). Must be < 0.")
 });
 var TruePeakNormalizeStream = class extends BufferedTransformStream {
   constructor() {
@@ -33591,7 +33579,6 @@ var TruePeakNormalizeNode = class extends TransformNode {
 };
 TruePeakNormalizeNode.nodeName = "True Peak Normalize";
 TruePeakNormalizeNode.packageName = PACKAGE_NAME;
-TruePeakNormalizeNode.packageVersion = PACKAGE_VERSION;
 TruePeakNormalizeNode.description = "Measure source true peak (4\xD7 upsampled, BS.1770-4 style) and apply a single linear gain to hit a target dBTP";
 TruePeakNormalizeNode.schema = schema20;
 TruePeakNormalizeNode.Stream = TruePeakNormalizeStream;
@@ -34307,7 +34294,6 @@ var CrestReduceNode = class extends TransformNode {
 };
 CrestReduceNode.nodeName = "Crest Reduce";
 CrestReduceNode.packageName = PACKAGE_NAME;
-CrestReduceNode.packageVersion = PACKAGE_VERSION;
 CrestReduceNode.description = "Content-adaptive, magnitude-preserving, phase-only crest-factor reducer \u2014 a pre-limiter headroom stage that rearranges signal phase to flatten true-peak excursions without changing the magnitude spectrum, never increasing crest factor";
 CrestReduceNode.schema = schema21;
 CrestReduceNode.Stream = CrestReduceStream;
@@ -35352,7 +35338,6 @@ var DeBleedNode = class extends TransformNode {
 };
 DeBleedNode.nodeName = "De-Bleed Adaptive";
 DeBleedNode.packageName = PACKAGE_NAME;
-DeBleedNode.packageVersion = PACKAGE_VERSION;
 DeBleedNode.description = "Adaptive (MEF FDAF Kalman + MWF + MSAD) reference-based microphone bleed reduction. Stages 1+2 are MEF Meyer-Elshamy-Fingscheidt 2020; Stage 3 is Lukin-Todd 2D NLM+DFTT post-filter.";
 DeBleedNode.schema = schema22;
 DeBleedNode.Stream = DeBleedStream;
@@ -35522,7 +35507,6 @@ var DeepFilterNet3Node = class extends TransformNode {
 };
 DeepFilterNet3Node.nodeName = "DeepFilterNet3 (Denoiser)";
 DeepFilterNet3Node.packageName = PACKAGE_NAME;
-DeepFilterNet3Node.packageVersion = PACKAGE_VERSION;
 DeepFilterNet3Node.description = "Remove background noise from speech using DeepFilterNet3 (48 kHz full-band CRN)";
 DeepFilterNet3Node.schema = schema23;
 DeepFilterNet3Node.Stream = DeepFilterNet3Stream;
@@ -35943,7 +35927,6 @@ var DtlnNode = class extends TransformNode {
 };
 DtlnNode.nodeName = "DTLN (Denoiser)";
 DtlnNode.packageName = PACKAGE_NAME;
-DtlnNode.packageVersion = PACKAGE_VERSION;
 DtlnNode.description = "Remove background noise from speech using DTLN neural network";
 DtlnNode.schema = schema24;
 DtlnNode.Stream = DtlnStream;
@@ -36436,7 +36419,6 @@ var HtdemucsNode = class extends TransformNode {
 };
 HtdemucsNode.nodeName = "HTDemucs (Stem Separator)";
 HtdemucsNode.packageName = PACKAGE_NAME;
-HtdemucsNode.packageVersion = PACKAGE_VERSION;
 HtdemucsNode.description = "Rebalance stem volumes using HTDemucs source separation";
 HtdemucsNode.schema = schema25;
 HtdemucsNode.Stream = HtdemucsStream;
@@ -36835,7 +36817,6 @@ var KimVocal2Node = class extends TransformNode {
 };
 KimVocal2Node.nodeName = "Kim Vocal 2 (Stem Separator)";
 KimVocal2Node.packageName = PACKAGE_NAME;
-KimVocal2Node.packageVersion = PACKAGE_VERSION;
 KimVocal2Node.description = "Isolate dialogue from background using MDX-Net vocal separation";
 KimVocal2Node.schema = schema26;
 KimVocal2Node.Stream = KimVocal2Stream;
@@ -37075,7 +37056,6 @@ var Vst3Node = class extends TransformNode {
 };
 Vst3Node.nodeName = "VST3";
 Vst3Node.packageName = PACKAGE_NAME;
-Vst3Node.packageVersion = PACKAGE_VERSION;
 Vst3Node.description = "Host a chain of VST3 effect plugins via Pedalboard (whole-file offline mode)";
 Vst3Node.schema = schema27;
 Vst3Node.Stream = Vst3Stream;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buffered-audio/nodes",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "type": "module",
   "exports": {
     ".": {
@@ -8,9 +8,6 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "bin": {
-    "buffered-audio-nodes": "./dist/cli.js"
-  },
   "files": [
     "dist"
   ],
@@ -42,15 +39,14 @@
     "@types/node": "^25.3.5",
     "concurrently": "*",
     "tsup": "^8.0.0",
+    "tsx": "^4.21.0",
     "typescript": "*",
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@buffered-audio/core": "0.9.0",
-    "@buffered-audio/utils": "0.6.4",
+    "@buffered-audio/core": "0.10.0",
+    "@buffered-audio/utils": "0.6.5",
     "bufferfy": "^4.0.3",
-    "commander": "^14.0.3",
-    "tsx": "^4.21.0",
     "wavefile": "^11.0.0",
     "zod": "^4.3.6"
   }

package/dist/cli.js

@@ -1,188 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import { existsSync, readFileSync } from 'fs';
-import { resolve } from 'path';
-import { SourceNode, validateGraphDefinition, createRenderJobs, BufferedSourceStream } from '@buffered-audio/core';
-
-var labelOf = (identity) => identity.nodeId !== void 0 ? `${identity.nodeName}#${identity.nodeId}` : `${identity.nodeName}#${identity.streamId}`;
-function sourceLabel(job) {
-  for (const streams of job.streams.values()) {
-    for (const stream of streams) {
-      if (stream instanceof BufferedSourceStream) return labelOf(stream.identity);
-    }
-  }
-  return void 0;
-}
-var collect = (value, previous) => [...previous, value];
-function parseParams(entries) {
-  const parameters = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    const separatorIndex = entry.indexOf("=");
-    if (separatorIndex === -1) {
-      process.stderr.write(`Error: --param must be in name=value form, got "${entry}"
-`);
-      process.exit(1);
-    }
-    const name = entry.slice(0, separatorIndex);
-    const value = entry.slice(separatorIndex + 1);
-    if (name === "") {
-      process.stderr.write(`Error: --param name must not be empty, got "${entry}"
-`);
-      process.exit(1);
-    }
-    if (parameters.has(name)) {
-      process.stderr.write(`Error: --param ${name} given more than once
-`);
-      process.exit(1);
-    }
-    parameters.set(name, value);
-  }
-  return Object.fromEntries(parameters);
-}
-function stamp(createdAt) {
-  const date = new Date(createdAt);
-  const pad = (value) => String(value).padStart(2, "0");
-  return `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
-}
-function createEventSink() {
-  const totals = /* @__PURE__ */ new Map();
-  const subscribe = (events) => {
-    events.on("started", (node, payload) => {
-      process.stdout.write(`${stamp(payload.createdAt)} [${labelOf(node)}] started
-`);
-    });
-    events.on("progress", (node, payload) => {
-      const label = labelOf(node);
-      if (payload.framesTotal !== void 0) {
-        const percent = Math.round(payload.framesDone / payload.framesTotal * 100);
-        process.stdout.write(`${stamp(payload.createdAt)} [${label}] ${payload.phase} ${percent}%
-`);
-      } else {
-        process.stdout.write(`${stamp(payload.createdAt)} [${label}] ${payload.phase} frames=${payload.framesDone}
-`);
-      }
-    });
-    events.on("log", (node, payload) => {
-      const data = payload.data ? Object.entries(payload.data).map(([key, value]) => `${key}=${String(value)}`) : [];
-      const parts = [payload.message, ...data].join(" ");
-      const prefix = payload.level === "warn" ? "warn: " : "";
-      process.stdout.write(`${stamp(payload.createdAt)} ${prefix}[${labelOf(node)}] ${parts}
-`);
-    });
-    events.on("finished", (node, payload) => {
-      totals.set(node.streamId, { label: labelOf(node), framesDone: payload.framesDone, processingMs: payload.processingMs });
-      const ms = payload.processingMs !== void 0 ? ` ms=${Math.round(payload.processingMs)}` : "";
-      process.stdout.write(`${stamp(payload.createdAt)} [${labelOf(node)}] finished frames=${payload.framesDone}${ms}
-`);
-    });
-  };
-  const printSummary = (jobs) => {
-    for (const { label, framesDone, processingMs } of totals.values()) {
-      if (processingMs !== void 0) {
-        process.stdout.write(`${stamp(Date.now())} [${label}] processed ${framesDone} frames in ${Math.round(processingMs)}ms
-`);
-      } else {
-        process.stdout.write(`${stamp(Date.now())} [${label}] processed ${framesDone} frames
-`);
-      }
-    }
-    for (const job of jobs) {
-      const timing = job.timing;
-      if (!timing) continue;
-      const label = sourceLabel(job) ?? "source";
-      process.stdout.write(`${stamp(Date.now())} [${label}] total ${(timing.totalMs / 1e3).toFixed(1)}s, ${timing.realTimeMultiplier.toFixed(1)}x RT
-`);
-    }
-  };
-  return { subscribe, printSummary };
-}
-var program = new Command();
-program.name("buffered-audio-nodes").description("Process audio through buffered audio node pipelines");
-program.command("process").description("Run an async audio processing pipeline").requiredOption("--pipeline <file>", "TypeScript file with default SourceAsyncModule export").option("--chunk-size <samples>", "Chunk size in samples").option("--high-water-mark <count>", "Stream backpressure high water mark").action(async (options) => {
-  const pipelinePath = resolve(options.pipeline);
-  if (!existsSync(pipelinePath)) {
-    process.stderr.write(`Error: pipeline file not found: ${pipelinePath}
-`);
-    process.exit(1);
-  }
-  const { register } = await import('tsx/esm/api');
-  const unregister = register();
-  try {
-    const mod = await import(pipelinePath);
-    const source = mod.default;
-    if (!(source instanceof SourceNode)) {
-      process.stderr.write("Error: default export must be a SourceAsyncModule\n");
-      process.exit(1);
-    }
-    const chunkSize = options.chunkSize ? parseInt(options.chunkSize, 10) : void 0;
-    const highWaterMark = options.highWaterMark ? parseInt(options.highWaterMark, 10) : void 0;
-    if (chunkSize !== void 0 && (!Number.isFinite(chunkSize) || chunkSize <= 0)) {
-      process.stderr.write(`Error: --chunk-size must be a positive integer, got "${options.chunkSize}"
-`);
-      process.exit(1);
-    }
-    if (highWaterMark !== void 0 && (!Number.isFinite(highWaterMark) || highWaterMark <= 0)) {
-      process.stderr.write(`Error: --high-water-mark must be a positive integer, got "${options.highWaterMark}"
-`);
-      process.exit(1);
-    }
-    const sink = createEventSink();
-    const job = source.createRenderJob({ chunkSize, highWaterMark });
-    sink.subscribe(job.events);
-    process.stdout.write(`Processing pipeline: ${pipelinePath}
-`);
-    await job.render();
-    sink.printSummary([job]);
-    process.stdout.write("Done.\n");
-  } finally {
-    await unregister();
-  }
-});
-program.command("render").description("Render a .bag graph definition file").argument("<file>", "Path to .bag file (JSON)").option("--chunk-size <samples>", "Chunk size in samples").option("--high-water-mark <count>", "Stream backpressure high water mark").option("--param <name=value>", "Bind a {{name}} template placeholder in the bag (repeatable)", collect, []).action(async (file, options) => {
-  const bagPath = resolve(file);
-  if (!existsSync(bagPath)) {
-    process.stderr.write(`Error: file not found: ${bagPath}
-`);
-    process.exit(1);
-  }
-  const json = JSON.parse(readFileSync(bagPath, "utf-8"));
-  const definition = validateGraphDefinition(json);
-  const { register } = await import('tsx/esm/api');
-  const unregister = register();
-  try {
-    const registry = /* @__PURE__ */ new Map();
-    for (const nodeDef of definition.nodes) {
-      if (!registry.has(nodeDef.packageName)) {
-        const mod = await import(nodeDef.packageName);
-        const packageMap = /* @__PURE__ */ new Map();
-        for (const value of Object.values(mod)) {
-          if (typeof value !== "function") continue;
-          const ctor = value;
-          if (typeof ctor.nodeName !== "string") continue;
-          packageMap.set(ctor.nodeName, ctor);
-        }
-        registry.set(nodeDef.packageName, packageMap);
-      }
-    }
-    const chunkSize = options.chunkSize ? parseInt(options.chunkSize, 10) : void 0;
-    const highWaterMark = options.highWaterMark ? parseInt(options.highWaterMark, 10) : void 0;
-    const parameters = parseParams(options.param);
-    const sink = createEventSink();
-    process.stdout.write(`Rendering graph: ${definition.name}
-`);
-    try {
-      const jobs = createRenderJobs(definition, registry, { chunkSize, highWaterMark, parameters });
-      for (const job of jobs) sink.subscribe(job.events);
-      await Promise.all(jobs.map((job) => job.render()));
-      sink.printSummary(jobs);
-      process.stdout.write("Done.\n");
-    } catch (error) {
-      process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
-`);
-      process.exitCode = 1;
-    }
-  } finally {
-    await unregister();
-  }
-});
-program.parse();