@buffered-audio/nodes 0.21.0 → 0.23.0

package/README.md

@@ -69,8 +69,8 @@ Remove a region of audio
 | Parameter | Type | Default | Description |
 | --- | --- | --- | --- |
 | `regions` | Object[] | `[]` | Regions |
-| `regions[].start` | number (min 0) | — | Start (seconds) |
-| `regions[].end` | number (min 0) | — | End (seconds) |
+| `regions[].start` | number (0 to 86400) | — | Start (seconds) |
+| `regions[].end` | number (0 to 86400) | — | End (seconds) |
 
 ### De-Bleed Adaptive
 
@@ -226,15 +226,15 @@ Peak-aware content-adaptive curve fitting (LUFS, true-peak, LRA) via a single co
 | Parameter | Type | Default | Description |
 | --- | --- | --- | --- |
 | `targetLufs` | number (-50 to 0, step 0.1) | `-16` | Target integrated loudness (LUFS) |
-| `pivot` | number (max 0), optional | — | Body anchor (dB). Default: median(considered LRA blocks) from BS.1770 LRA gating in pass 1. |
-| `floor` | number (max 0), optional | — | Silence threshold (dB). Default: min(considered LRA blocks); no floor when no blocks survive gating. |
+| `pivot` | number (-80 to 0), optional | — | Body anchor (dB). Default: median(considered LRA blocks) from BS.1770 LRA gating in pass 1. |
+| `floor` | number (-100 to 0), optional | — | Silence threshold (dB). Default: min(considered LRA blocks); no floor when no blocks survive gating. |
 | `limitPercentile` | number (0.5 to 1) | `0.995` | Top-1−p fraction of detection samples to brick-wall. Default 0.995 brick-walls the top 0.5%. |
-| `limitDb` | number (max 0), optional | — | Limit-anchor override (dB). Default: auto-derived from quantile(detection histogram, limitPercentile). Set explicitly to fix the limit anchor. |
+| `limitDb` | number (-60 to 0), optional | — | Limit-anchor override (dB). Default: auto-derived from quantile(detection histogram, limitPercentile). Set explicitly to fix the limit anchor. |
 | `maxAttempts` | number (min 1) | `10` | Hard cap on iteration attempts. |
-| `targetTp` | number (max 0), optional | — | True-peak target (dBTP). Default: source true peak (peaks unchanged). |
+| `targetTp` | number (-24 to 0), optional | — | True-peak target (dBTP). Default: source true peak (peaks unchanged). |
 | `smoothing` | number (0.01 to 200) | `1` | Peak-respecting envelope time constant (ms). |
-| `tolerance` | number (min 0) | `0.5` | Iteration exit threshold (LUFS dB). |
-| `peakTolerance` | number (min 0) | `0.1` | One-sided iteration exit threshold for output true-peak overshoot (dBTP; ceiling — undershoot ignored). |
+| `tolerance` | number (0 to 6) | `0.5` | Iteration exit threshold (LUFS dB). |
+| `peakTolerance` | number (0 to 6) | `0.1` | One-sided iteration exit threshold for output true-peak overshoot (dBTP; ceiling — undershoot ignored). |
 
 ### Normalize
 
@@ -254,8 +254,8 @@ Add silence to start or end of audio
 
 | Parameter | Type | Default | Description |
 | --- | --- | --- | --- |
-| `before` | number (min 0, step 0.001) | `0` | Before |
-| `after` | number (min 0, step 0.001) | `0` | After |
+| `before` | number (0 to 300, step 0.001) | `0` | Before |
+| `after` | number (0 to 300, step 0.001) | `0` | After |
 
 ### Pan
 
@@ -328,7 +328,7 @@ Replace a region of audio with processed content
 | Parameter | Type | Default | Description |
 | --- | --- | --- | --- |
 | `insertPath` | string | `""` | Insert File Path |
-| `insertAt` | number (min 0) | `0` | Insert At (frames) |
+| `insertAt` | number (0 to 1000000000) | `0` | Insert At (frames) |
 
 ### Trim
 
@@ -351,7 +351,7 @@ Measure source true peak (4× upsampled, BS.1770-4 style) and apply a single lin
 
 | Parameter | Type | Default | Description |
 | --- | --- | --- | --- |
-| `target` | number (max 0) | `-1` | Target true peak (dBTP). Must be < 0. |
+| `target` | number (-24 to 0) | `-1` | Target true peak (dBTP). Must be < 0. |
 
 ### VST3
 
@@ -393,7 +393,7 @@ Write audio to a file
 | `encoding` | Object, optional | — | Encode through ffmpeg to a non-WAV format. Requires `ffmpegPath`. |
 | `encoding.format` | "wav" \| "flac" \| "mp3" \| "aac" | — |  |
 | `encoding.bitrate` | string, optional | — |  |
-| `encoding.vbr` | number, optional | — |  |
+| `encoding.vbr` | number (0 to 9), optional | — |  |
 | `encoding.sampleRate` | number (min 0), optional | — | Output sample rate (Hz). When set, ffmpeg resamples on encode. |
 
 ## Creating Nodes

package/dist/index.js

@@ -29843,6 +29843,9 @@ var BufferedAudioNode = class {
   get id() {
     return this.properties.id;
   }
+  get packageVersion() {
+    return this.properties.packageVersion;
+  }
   get isBypassed() {
     return this.properties.bypass === true;
   }
@@ -30118,6 +30121,7 @@ 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({
@@ -30132,15 +30136,8 @@ 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
@@ -30542,7 +30539,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() {
@@ -30770,7 +30767,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")
@@ -30980,7 +30977,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;
@@ -31222,11 +31219,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`.")
@@ -31416,8 +31413,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")
@@ -31602,8 +31599,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() {
@@ -31819,7 +31816,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() {
@@ -33181,15 +33178,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" }
@@ -33536,7 +33533,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() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buffered-audio/nodes",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "type": "module",
   "exports": {
     ".": {
@@ -44,8 +44,8 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@buffered-audio/core": "0.10.0",
-    "@buffered-audio/utils": "0.6.5",
+    "@buffered-audio/core": "0.11.0",
+    "@buffered-audio/utils": "0.6.6",
     "bufferfy": "^4.0.3",
     "wavefile": "^11.0.0",
     "zod": "^4.3.6"