hyperframes 0.8.106 → 0.8.108

package/dist/{lint-LSTEZZ6T.js → lint-3NKKYCMH.js}

@@ -6,21 +6,21 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   trackLintRun
-} from "./chunk-IBCGKQB5.js";
+} from "./chunk-KZJ6V7RT.js";
 import {
   resolveProject
-} from "./chunk-FTXU3TQ4.js";
+} from "./chunk-US7SWKGC.js";
 import {
   formatLintFindings
 } from "./chunk-6CSYCFQV.js";
 import "./chunk-IHFUKJOR.js";
-import "./chunk-2LCIQS3K.js";
-import "./chunk-LAHK4P7Q.js";
+import "./chunk-VBXJSCHR.js";
+import "./chunk-J7XPPADY.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-PUB5XZYL.js";
+import "./chunk-SIVCJJHE.js";
 import "./chunk-AMKC3AXA.js";
 import {
   defineCommand
@@ -31,19 +31,19 @@ import {
 import {
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-VW5OMJNG.js";
-import "./chunk-TEXPOC5V.js";
-import "./chunk-TLYU5625.js";
+import "./chunk-QB6OM2BP.js";
+import "./chunk-B25H4M4V.js";
+import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-TH4APNRP.js";
-import "./chunk-FOKUJKBN.js";
+import "./chunk-X763EUBO.js";
+import "./chunk-YLVI7VL5.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-Q5X2B5WT.js";
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 import "./chunk-HBBJFK6I.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-TQFG7HTI.js";
@@ -51,12 +51,12 @@ import "./chunk-GK4AIFIH.js";
 import "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-4NJZZHYT.js";
+} from "./chunk-RPMXMOFU.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-6LPWMCPY.js";
+import "./chunk-NROJESOK.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{lintProject-4P4C6AN2.js → lintProject-F2OTN2IR.js}

@@ -11,7 +11,7 @@ import {
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 import "./chunk-HBBJFK6I.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-TQFG7HTI.js";

package/dist/{list-6VICFTAM.js → list-Q7SOE3NF.js}

@@ -14,9 +14,9 @@ import {
   createCloudClient,
   reportApiError
 } from "./chunk-RLYTIMTS.js";
-import "./chunk-6F6EEQNB.js";
+import "./chunk-PSGDNMM6.js";
 import "./chunk-DNXD7TOA.js";
-import "./chunk-4Z5O7BTD.js";
+import "./chunk-WEATBQTR.js";
 import {
   errorBox
 } from "./chunk-IHFUKJOR.js";
@@ -32,12 +32,12 @@ import {
 import "./chunk-OFQWTKPW.js";
 import {
   withMeta
-} from "./chunk-4NJZZHYT.js";
+} from "./chunk-RPMXMOFU.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-6LPWMCPY.js";
+import "./chunk-NROJESOK.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 

package/dist/{login-MXDIDOOG.js → login-TGRGWS5E.js}

@@ -113,7 +113,7 @@ function assertAttendedDeviceFlow() {
 async function runDeviceLogin() {
   assertAttendedDeviceFlow();
   assertOAuthConfiguredOrExit();
-  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-XTN5BO5S.js");
+  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-46XSB2VN.js");
   trackAuthLoginStarted("device");
   let tokens;
   try {
@@ -178,7 +178,7 @@ async function revokeDeviceTokens(tokens) {
 }
 async function runOAuthLogin() {
   assertOAuthConfiguredOrExit();
-  const { trackAuthLoginStarted, trackAuthLoginFailed } = await import("./telemetry-XTN5BO5S.js");
+  const { trackAuthLoginStarted, trackAuthLoginFailed } = await import("./telemetry-46XSB2VN.js");
   trackAuthLoginStarted("oauth");
   try {
     await startAuthorizationCodeFlow();
@@ -191,7 +191,7 @@ async function runOAuthLogin() {
   await reportIdentity();
 }
 async function reportIdentity() {
-  const { trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-XTN5BO5S.js");
+  const { trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-46XSB2VN.js");
   const credential = await tryResolveCredential();
   if (!credential) {
     trackAuthLoginFailed("oauth", "no_credential");
@@ -248,7 +248,7 @@ async function clearUserInfoBestEffort() {
   }
 }
 async function runApiKeyLogin(inlineKey) {
-  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-XTN5BO5S.js");
+  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-46XSB2VN.js");
   trackAuthLoginStarted("api_key");
   let key;
   try {

package/dist/{media-treatment-ZVCWEACM.js → media-treatment-5TUXWHWE.js}

@@ -9,23 +9,23 @@ import {
 } from "./chunk-ZKDMAOFU.js";
 import {
   patchElementInHtml
-} from "./chunk-M4KS6MJN.js";
+} from "./chunk-NJLFRKHX.js";
 import {
   resolveProject
-} from "./chunk-FTXU3TQ4.js";
+} from "./chunk-US7SWKGC.js";
 import "./chunk-IHFUKJOR.js";
 import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
 } from "./chunk-TVCRUG2S.js";
-import "./chunk-2LCIQS3K.js";
-import "./chunk-LAHK4P7Q.js";
+import "./chunk-VBXJSCHR.js";
+import "./chunk-J7XPPADY.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-PUB5XZYL.js";
+import "./chunk-SIVCJJHE.js";
 import "./chunk-AMKC3AXA.js";
 import {
   defineCommand
@@ -34,18 +34,18 @@ import "./chunk-54HJ63Q2.js";
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-VW5OMJNG.js";
-import "./chunk-TEXPOC5V.js";
-import "./chunk-TLYU5625.js";
+import "./chunk-QB6OM2BP.js";
+import "./chunk-B25H4M4V.js";
+import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-TH4APNRP.js";
+import "./chunk-X763EUBO.js";
 import {
   HF_COLOR_GRADING_ATTR,
   getHfColorGradingCapabilities,
   hasHfColorGradingAuthoredValues,
   normalizeHfColorGrading,
   serializeHfColorGrading
-} from "./chunk-FOKUJKBN.js";
+} from "./chunk-YLVI7VL5.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-LCSMOLGX.js";
@@ -54,7 +54,7 @@ import {
   cleanAssetUrl,
   isRemoteOrInlineUrl,
   resolveExistingLocalAsset
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 import "./chunk-HBBJFK6I.js";
 import "./chunk-PJ3HDUCY.js";
 import {
@@ -69,12 +69,12 @@ import {
 import "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-4NJZZHYT.js";
+} from "./chunk-RPMXMOFU.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-6LPWMCPY.js";
+import "./chunk-NROJESOK.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/{models-LXUIU5DC.js → models-YJUTM6TH.js}

@@ -12,7 +12,7 @@ import {
 } from "./chunk-WMQNIQDJ.js";
 import {
   createRenderCancellationScope
-} from "./chunk-TMLEIURT.js";
+} from "./chunk-QRXICW5Q.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
@@ -23,18 +23,18 @@ import {
   failCommand,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-VW5OMJNG.js";
-import "./chunk-TEXPOC5V.js";
-import "./chunk-TLYU5625.js";
+import "./chunk-QB6OM2BP.js";
+import "./chunk-B25H4M4V.js";
+import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-TH4APNRP.js";
-import "./chunk-FOKUJKBN.js";
+import "./chunk-X763EUBO.js";
+import "./chunk-YLVI7VL5.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-LAOCA3MQ.js";
 import "./chunk-LCSMOLGX.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-UVUAU3CH.js";
+import "./chunk-ONY5CJXS.js";
 import "./chunk-HBBJFK6I.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-TQFG7HTI.js";
@@ -88,7 +88,7 @@ async function installMissing(sherpa, spin, signal) {
 }
 var wasCancelled = (err, signal, sherpa) => signal.aborted || err instanceof sherpa.DecodeCancelled;
 async function installParakeet(json) {
-  const sherpa = await import("./sherpa-MNCWRFD4.js");
+  const sherpa = await import("./sherpa-PR3I4KGM.js");
   const unsupported = sherpa.sherpaUnsupportedReason();
   if (unsupported) fail(unsupported, json);
   const spin = json ? null : ft({ output: process.stderr });

package/dist/{motionShot-2LYUQF3T.js → motionShot-5QUMZ7J3.js}

@@ -18,29 +18,29 @@ import {
 } from "./chunk-5Z63TBTX.js";
 import {
   resolveDiagnosticNavigationTimeoutMs
-} from "./chunk-IQ4UCWV7.js";
+} from "./chunk-TIZQC44K.js";
 import "./chunk-YEIFI443.js";
 import "./chunk-IHFUKJOR.js";
 import "./chunk-PFCFR3KZ.js";
 import {
   resolveCaptureBrowserGpuMode,
   resolveLocalBrowserGpuMode
-} from "./chunk-4WAMN4IF.js";
+} from "./chunk-GYYFNAVA.js";
 import "./chunk-ZTZA4UWZ.js";
 import "./chunk-PBN6GBJE.js";
 import {
   assertWebGpuAdapterAvailable,
   compositionRequiresWebGpu
-} from "./chunk-VW5OMJNG.js";
-import "./chunk-TEXPOC5V.js";
-import "./chunk-TLYU5625.js";
+} from "./chunk-QB6OM2BP.js";
+import "./chunk-B25H4M4V.js";
+import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-TH4APNRP.js";
-import "./chunk-FOKUJKBN.js";
+import "./chunk-X763EUBO.js";
+import "./chunk-YLVI7VL5.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-UVUAU3CH.js";
+import "./chunk-ONY5CJXS.js";
 import "./chunk-HBBJFK6I.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-TQFG7HTI.js";
@@ -276,7 +276,7 @@ async function installSeekHelper(page) {
 }
 async function openCompositionPage(html, url, executablePath) {
   const puppeteer = await import("puppeteer-core");
-  const { buildChromeArgs } = await import("./src-QX5PPANW.js");
+  const { buildChromeArgs } = await import("./src-6R4DC2YI.js");
   const size = resolveCompositionViewportFromHtml(html);
   const requestedGpuMode = resolveLocalBrowserGpuMode();
   const resolvedGpuMode = await resolveCaptureBrowserGpuMode(requestedGpuMode, executablePath);
@@ -544,8 +544,8 @@ async function captureMotionPathShot(projectDir, requestsIn, outPath, opts = {})
   const fit = opts.fit ?? true;
   const camera = parseAngle(opts.angle);
   const { ensureBrowser } = await import("./manager-NEVLEZK3.js");
-  const { serveStaticProjectHtml } = await import("./staticProjectServer-WBXW2CA4.js");
-  const { bundleToSingleHtml } = await import("./compiler-QMEZK6CU.js");
+  const { serveStaticProjectHtml } = await import("./staticProjectServer-RXAFGDK7.js");
+  const { bundleToSingleHtml } = await import("./compiler-YYOV2BJ7.js");
   const html = await bundleToSingleHtml(projectDir, { entryFile: opts.entryFile });
   const server = await serveStaticProjectHtml(
     projectDir,

package/dist/normalize-audio-63BI5BPL.js

@@ -0,0 +1,276 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  DEFAULT_TARGET_LUFS,
+  absoluteLoudnessPlan,
+  audioNormalizationPlan,
+  audioTags,
+  loudnessMeasureArgs,
+  measureAudio,
+  parseEbur128Summary,
+  requiredFfmpeg,
+  resolveLocalAudioPath,
+  updateAudioVolume
+} from "./chunk-5ON5GH3X.js";
+import {
+  resolveProject
+} from "./chunk-US7SWKGC.js";
+import "./chunk-IHFUKJOR.js";
+import "./chunk-VBXJSCHR.js";
+import "./chunk-J7XPPADY.js";
+import "./chunk-VWG7OQKU.js";
+import {
+  c
+} from "./chunk-ZTZA4UWZ.js";
+import "./chunk-SIVCJJHE.js";
+import "./chunk-AMKC3AXA.js";
+import {
+  defineCommand
+} from "./chunk-S3S4TGEH.js";
+import "./chunk-54HJ63Q2.js";
+import {
+  failCommand
+} from "./chunk-PBN6GBJE.js";
+import "./chunk-QB6OM2BP.js";
+import "./chunk-B25H4M4V.js";
+import "./chunk-UUDQD62L.js";
+import "./chunk-DPVXBVLL.js";
+import "./chunk-X763EUBO.js";
+import "./chunk-YLVI7VL5.js";
+import "./chunk-VC76R6W2.js";
+import "./chunk-OFQWTKPW.js";
+import "./chunk-TWWSYAKJ.js";
+import "./chunk-ONY5CJXS.js";
+import "./chunk-HBBJFK6I.js";
+import "./chunk-PJ3HDUCY.js";
+import "./chunk-TQFG7HTI.js";
+import "./chunk-GK4AIFIH.js";
+import "./chunk-2PSPARWP.js";
+import "./chunk-K4WIOZFP.js";
+import "./chunk-XUXGIA7H.js";
+import "./chunk-WERLJGIC.js";
+import "./chunk-ISN5GRYI.js";
+import "./chunk-NROJESOK.js";
+import "./chunk-KNU5COPB.js";
+import "./chunk-3GXQPCJC.js";
+import "./chunk-RQVDTPGD.js";
+import "./chunk-PMRBLBUP.js";
+import "./chunk-M2WBOQ2Q.js";
+
+// src/commands/normalize-audio.ts
+import { existsSync, readFileSync, renameSync, writeFileSync } from "fs";
+import { relative } from "path";
+var DEFAULT_TOLERANCE_LU = 0.5;
+function fail(message, json, cause) {
+  if (json) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
+  else console.error(c.error(message));
+  failCommand(1, cause);
+}
+function byId(tags, rawId, role) {
+  const id = rawId.trim().replace(/^#/, "");
+  const tag = tags.find((candidate) => candidate.id === id);
+  if (!tag) throw new Error(`${role} audio #${id} was not found`);
+  return tag;
+}
+function selectedTags(html, referenceId, targetId) {
+  const tags = audioTags(html);
+  const referenceTag = byId(tags, referenceId, "Reference");
+  const targetTag = byId(tags, targetId, "Target");
+  if (referenceTag.id === targetTag.id) {
+    throw new Error("Reference and target must be different audio elements");
+  }
+  return { referenceTag, targetTag };
+}
+function existingAudioFile(projectDir, tag) {
+  const file = resolveLocalAudioPath(projectDir, tag.src);
+  if (!existsSync(file)) {
+    throw new Error(`Audio #${tag.id} file was not found: ${relative(projectDir, file)}`);
+  }
+  return file;
+}
+async function measuredPlan(projectDir, referenceTag, targetTag) {
+  const ffmpegPath = requiredFfmpeg();
+  const referenceFile = existingAudioFile(projectDir, referenceTag);
+  const targetFile = existingAudioFile(projectDir, targetTag);
+  const [referenceMeasurement, targetMeasurement] = await Promise.all([
+    measureAudio(ffmpegPath, referenceFile, referenceTag),
+    measureAudio(ffmpegPath, targetFile, targetTag)
+  ]);
+  return audioNormalizationPlan(
+    { id: referenceTag.id, volume: referenceTag.volume, ...referenceMeasurement },
+    { id: targetTag.id, volume: targetTag.volume, ...targetMeasurement }
+  );
+}
+function writeAtomically(path, contents) {
+  const temporary = `${path}.hf-normalize-${process.pid}.tmp`;
+  writeFileSync(temporary, contents);
+  renameSync(temporary, path);
+}
+function parsedTolerance(raw) {
+  const tolerance = Number(raw);
+  if (!Number.isFinite(tolerance) || tolerance < 0) {
+    throw new Error("--tolerance must be a non-negative number");
+  }
+  return tolerance;
+}
+function parsedLufs(raw) {
+  const lufs = Number(raw);
+  if (!Number.isFinite(lufs) || lufs >= 0) throw new Error("--lufs must be a negative number");
+  return lufs;
+}
+async function measuredAbsolutePlan(projectDir, targetTag, targetLufs) {
+  const measurement = await measureAudio(
+    requiredFfmpeg(),
+    existingAudioFile(projectDir, targetTag),
+    targetTag
+  );
+  return absoluteLoudnessPlan(
+    { id: targetTag.id, volume: targetTag.volume, ...measurement },
+    targetLufs
+  );
+}
+async function plannedNormalization(projectDir, html, options, tolerance) {
+  if (options.reference === void 0) {
+    const targetTag2 = byId(audioTags(html), options.target, "Target");
+    const plan2 = await measuredAbsolutePlan(projectDir, targetTag2, parsedLufs(options.lufs));
+    const withinTolerance2 = Math.abs(plan2.changeDb) <= tolerance;
+    return { targetTag: targetTag2, withinTolerance: withinTolerance2, plan: { mode: "absolute", ...plan2 } };
+  }
+  const { referenceTag, targetTag } = selectedTags(html, options.reference, options.target);
+  const plan = await measuredPlan(projectDir, referenceTag, targetTag);
+  const withinTolerance = Math.abs(plan.referenceLufs - plan.targetLufs) <= tolerance;
+  return { targetTag, withinTolerance, plan: { mode: "reference", ...plan } };
+}
+async function normalizeAudio(options) {
+  const project = resolveProject(options.dir);
+  const html = readFileSync(project.indexPath, "utf8");
+  const tolerance = parsedTolerance(options.tolerance);
+  const { targetTag, withinTolerance, plan } = await plannedNormalization(
+    project.dir,
+    html,
+    options,
+    tolerance
+  );
+  const wrote = options.write && !withinTolerance;
+  if (wrote) {
+    writeAtomically(
+      project.indexPath,
+      updateAudioVolume(readFileSync(project.indexPath, "utf8"), targetTag.id, plan.volume)
+    );
+  }
+  return { ok: true, wrote, withinTolerance, tolerance, indexPath: project.indexPath, ...plan };
+}
+var LIMIT_TEXT = {
+  "gain-ceiling": "stopped at the +12 dB authoring ceiling",
+  "true-peak": "stopped short of -1.5 dBTP"
+};
+function printMeasuredLine(result) {
+  if (result.mode === "reference") {
+    console.log(
+      `${c.bold(`#${result.referenceId}`)} ${result.referenceLufs.toFixed(1)} LUFS \u2192 ${c.bold(`#${result.targetId}`)} ${result.targetLufs.toFixed(1)} LUFS`
+    );
+    return;
+  }
+  const limit = result.limitedBy ? ` (${LIMIT_TEXT[result.limitedBy]})` : "";
+  console.log(
+    `${c.bold(`#${result.targetId}`)} ${result.sourceLufs.toFixed(1)} LUFS \u2192 ${result.projectedLufs.toFixed(1)} LUFS, target ${result.targetLufs.toFixed(1)}${limit}`
+  );
+}
+function printHumanResult(result) {
+  printMeasuredLine(result);
+  if (result.withinTolerance) {
+    console.log(
+      c.success(`Already matched within ${result.tolerance.toFixed(1)} LU; no change needed.`)
+    );
+    return;
+  }
+  console.log(
+    `Set #${result.targetId} data-volume ${result.previousVolume.toFixed(3)} \u2192 ${result.volume.toFixed(6)} (${result.changeDb >= 0 ? "+" : ""}${result.changeDb.toFixed(1)} dB).`
+  );
+  console.log(
+    result.wrote ? c.success(`Updated ${relative(process.cwd(), result.indexPath) || "index.html"}.`) : c.dim("Dry run only. Pass --write to persist this gain.")
+  );
+}
+var examples = [
+  [
+    "Bring one clip (audio or a video with sound) to -16 LUFS",
+    "hyperframes normalize-audio --target voiceover --write"
+  ],
+  [
+    "Measure two authored clips and preview the matching gain",
+    "hyperframes normalize-audio --reference target-audio --target user-audio"
+  ],
+  [
+    "Persist the measured gain into index.html",
+    "hyperframes normalize-audio --reference target-audio --target user-audio --write"
+  ]
+];
+var normalize_audio_default = defineCommand({
+  meta: {
+    name: "normalize-audio",
+    description: "Normalize a clip with sound to an absolute LUFS target, or match it to another clip"
+  },
+  args: {
+    dir: { type: "positional", description: "Project directory", required: false },
+    reference: {
+      type: "string",
+      description: "Audio or video element id whose effective loudness should be preserved (omit to use --lufs)",
+      required: false
+    },
+    target: {
+      type: "string",
+      description: "Audio or video element id whose data-volume should be set",
+      required: true
+    },
+    lufs: {
+      type: "string",
+      description: `Absolute integrated loudness target without --reference (default ${DEFAULT_TARGET_LUFS})`,
+      default: String(DEFAULT_TARGET_LUFS)
+    },
+    write: {
+      type: "boolean",
+      description: "Persist the measured target gain into index.html",
+      default: false
+    },
+    tolerance: {
+      type: "string",
+      description: `Skip writes within this many LU (default ${DEFAULT_TOLERANCE_LU})`,
+      default: String(DEFAULT_TOLERANCE_LU)
+    },
+    json: { type: "boolean", description: "Print machine-readable output", default: false }
+  },
+  async run({ args }) {
+    try {
+      const result = await normalizeAudio({
+        dir: args.dir,
+        reference: args.reference,
+        target: args.target,
+        lufs: args.lufs,
+        tolerance: args.tolerance,
+        write: args.write
+      });
+      if (args.json) {
+        const { indexPath: _, ...jsonResult } = result;
+        console.log(JSON.stringify(jsonResult, null, 2));
+        return;
+      }
+      printHumanResult(result);
+    } catch (error) {
+      fail(error instanceof Error ? error.message : String(error), Boolean(args.json), error);
+    }
+  }
+});
+export {
+  audioNormalizationPlan,
+  audioTags,
+  normalize_audio_default as default,
+  examples,
+  loudnessMeasureArgs,
+  parseEbur128Summary,
+  resolveLocalAudioPath,
+  updateAudioVolume
+};

package/dist/{pipeline-OFFKTFXS.js → pipeline-4NN5T7Q3.js}

@@ -14,22 +14,22 @@ import {
   render,
   resolveRenderTargets,
   waitForExit
-} from "./chunk-I77CAR4W.js";
+} from "./chunk-KVOWTRD5.js";
 import "./chunk-2EAXUCCE.js";
 import "./chunk-X5HWXQPU.js";
 import "./chunk-TVCRUG2S.js";
 import "./chunk-AMKC3AXA.js";
-import "./chunk-VW5OMJNG.js";
-import "./chunk-TEXPOC5V.js";
-import "./chunk-TLYU5625.js";
+import "./chunk-QB6OM2BP.js";
+import "./chunk-B25H4M4V.js";
+import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-TH4APNRP.js";
-import "./chunk-FOKUJKBN.js";
+import "./chunk-X763EUBO.js";
+import "./chunk-YLVI7VL5.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-LCSMOLGX.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-UVUAU3CH.js";
+import "./chunk-ONY5CJXS.js";
 import "./chunk-HBBJFK6I.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-TQFG7HTI.js";