bytecut 0.2.0 → 0.3.0

package/README.md

@@ -74,15 +74,26 @@ Everything is optional. Config is only needed to make a choice stick. Put it in
       "maxSize": "150 KB",
       "floor": 65
     },
-    "loop": { "extends": "background-video", "vmaf": 92 }
+    "loop": { "extends": "background-video", "vmaf": 92 },
+    "promo": {
+      "extends": "content-video",
+      "ssimulacra2": 70,
+      "floor": 55,
+      "maxSize": "5 MB"
+    }
+  },
+  "assets": {
+    "public/gallery/**": "gallery",
+    "public/loops/*.mp4": "loop",
+    "public/promo.mp4": "promo"
   },
-  "assets": { "public/gallery/**": "gallery", "public/loops/*.mp4": "loop" },
   "budgets": { "maxFileSize": "250 KB", "maxTotalSize": "5 MB" }
 }
 ```
 
 - **Presets**: built-in `photo`, `hero`, `icon`, `background-video`, `content-video` and
-  `gif-to-video`. Add your own with `extends`; the first matching `assets` glob wins.
+  `gif-to-video`. Add your own with `extends`; the first matching `assets` glob wins. In the
+  TUI, `p` and `/preset` offer image presets for images and video presets for videos and GIFs.
 - **Size**: `maxEdge` caps the longest side; `widths` lists widths instead (a responsive set).
 - **Formats**: `jpg` (default), `png`, `webp`, `avif`. A `<picture>` lists AVIF, then WebP, and
   the JPEG is the `<img>`.
@@ -98,7 +109,10 @@ that still meets it:
   confirms on the full-size output.
 - `maxSize` with a required `floor` lowers quality, then steps the width down, to fit a size
   cap. A constraint that cannot be met writes nothing and fails the run; it is never silently
-  exceeded.
+  exceeded. On video the cap is per output file (AV1 and H.264 each): the CRF is raised until
+  the predicted size fits, never past the `floor`, and then the width steps down by a fifth at a
+  time, never below half. The finished file is measured, not just predicted. A narrower file is
+  named for its real width, e.g. `promo-1228.h264.mp4`.
 - `vmaf: 92` (video) uses ffmpeg's `libvmaf`. Without it, the preset's fixed quality is used
   and a warning says so.
 
@@ -108,6 +122,9 @@ SSIMULACRA2 runs as WebAssembly in worker threads, so no native binary is needed
 
 ## Video
 
+Estimating a large video encodes real samples, so the first scan of a 4K file can take a minute or
+more; the screen shows which sample it is on, and the result is cached by content hash.
+
 bytecut uses **your own** `ffmpeg` and `ffprobe` (`--ffmpeg`, `BYTECUT_FFMPEG`, `ffmpegPath`, or
 `PATH`). It never downloads or bundles one. Without ffmpeg images work fully and videos are
 listed as "needs ffmpeg" with the install command for your OS. Without an AV1 encoder you still

package/dist/{audit-LJOGSJS6.js → audit-RKJNHNDZ.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-LTWUPQDT.js";
 import {
   audit
-} from "./chunk-5JEA233Z.js";
+} from "./chunk-DZLFVN4G.js";
 import {
   formatAuditReport
-} from "./chunk-HLBNRB3S.js";
+} from "./chunk-GNW3OK5U.js";
 import "./chunk-3DBJKHOD.js";
-import "./chunk-TCQFQ354.js";
+import "./chunk-CSDZGNUN.js";
 import {
   sharpImageEngine
 } from "./chunk-CSFBJ3UH.js";
-import "./chunk-RZ2V4PCS.js";
+import "./chunk-JMMXC5UA.js";
 import {
   configArg,
   createVideoEngine,
@@ -21,15 +21,15 @@ import {
   ffmpegInstallText,
   ffmpegStatus,
   noAssetsMessage
-} from "./chunk-KN5QOB7R.js";
-import "./chunk-S3FQYUTI.js";
-import "./chunk-QOG2F4SF.js";
-import "./chunk-3PF6BBFK.js";
-import "./chunk-IZ4JEL3Q.js";
+} from "./chunk-ABHEWNYQ.js";
+import "./chunk-SMR2764T.js";
+import "./chunk-L5HLKZDW.js";
+import "./chunk-PE5NKZCH.js";
+import "./chunk-4AM2CCML.js";
 import {
   guarded
-} from "./chunk-MV6J66AP.js";
-import "./chunk-FY53B4NB.js";
+} from "./chunk-MUE3L5XT.js";
+import "./chunk-KJK7XGWA.js";
 
 // src/cli/commands/audit.ts
 import { defineCommand } from "citty";

package/dist/{check-MEBXJBNG.js → check-MN7R7XOM.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-LTWUPQDT.js";
 import {
   audit
-} from "./chunk-5JEA233Z.js";
+} from "./chunk-DZLFVN4G.js";
 import {
   formatAuditReport
-} from "./chunk-HLBNRB3S.js";
+} from "./chunk-GNW3OK5U.js";
 import "./chunk-3DBJKHOD.js";
-import "./chunk-TCQFQ354.js";
+import "./chunk-CSDZGNUN.js";
 import {
   sharpImageEngine
 } from "./chunk-CSFBJ3UH.js";
-import "./chunk-RZ2V4PCS.js";
+import "./chunk-JMMXC5UA.js";
 import {
   configArg,
   createVideoEngine,
@@ -21,22 +21,22 @@ import {
   ffmpegInstallText,
   ffmpegStatus,
   noAssetsMessage
-} from "./chunk-KN5QOB7R.js";
+} from "./chunk-ABHEWNYQ.js";
 import {
   run
-} from "./chunk-S3FQYUTI.js";
+} from "./chunk-SMR2764T.js";
 import {
   toPosix
-} from "./chunk-QOG2F4SF.js";
-import "./chunk-3PF6BBFK.js";
-import "./chunk-IZ4JEL3Q.js";
+} from "./chunk-L5HLKZDW.js";
+import "./chunk-PE5NKZCH.js";
+import "./chunk-4AM2CCML.js";
 import {
   BytecutError,
   CONFIG_FILES,
   formatBytes,
   percentChange,
   plural
-} from "./chunk-FY53B4NB.js";
+} from "./chunk-KJK7XGWA.js";
 
 // src/cli/commands/check.ts
 import { defineCommand } from "citty";

package/dist/{chunk-IZ4JEL3Q.js → chunk-4AM2CCML.js}

@@ -2,7 +2,7 @@
 import {
   BytecutError,
   CONFIG_FILES
-} from "./chunk-FY53B4NB.js";
+} from "./chunk-KJK7XGWA.js";
 
 // src/core/fs-safe.ts
 import { randomBytes } from "crypto";

package/dist/{chunk-4FIB6VNC.js → chunk-7RHHOWQT.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   escapeGlob
-} from "./chunk-FY53B4NB.js";
+} from "./chunk-KJK7XGWA.js";
 
 // src/core/config/choices.ts
 import { stringify as stringifyToml } from "smol-toml";

package/dist/{chunk-KN5QOB7R.js → chunk-ABHEWNYQ.js}

@@ -3,19 +3,19 @@ import {
   isFile,
   readOsReleaseId,
   run
-} from "./chunk-S3FQYUTI.js";
+} from "./chunk-SMR2764T.js";
 import {
   createFfmpegVideoEngine
-} from "./chunk-QOG2F4SF.js";
+} from "./chunk-L5HLKZDW.js";
 import {
   installHint,
   resolveBinary,
   resolveConfig
-} from "./chunk-3PF6BBFK.js";
+} from "./chunk-PE5NKZCH.js";
 import {
   BytecutError,
   loadConfig
-} from "./chunk-FY53B4NB.js";
+} from "./chunk-KJK7XGWA.js";
 
 // src/cli/shared.ts
 import { existsSync } from "fs";

package/dist/{chunk-TCQFQ354.js → chunk-CSDZGNUN.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   BytecutError
-} from "./chunk-FY53B4NB.js";
+} from "./chunk-KJK7XGWA.js";
 
 // src/core/plan/schema.ts
 import { z } from "zod";
@@ -49,7 +49,12 @@ var videoOutputSchema = z.discriminatedUnion("role", [
     maxFps: z.number().positive().nullable(),
     audio: z.enum(["strip", "keep"]),
     audioBitrate: z.string().regex(/^\d+k$/),
-    search: z.object({ metric: z.enum(["ssimulacra2", "vmaf"]), target: z.number().min(1).max(100) }).strict().optional()
+    search: z.object({
+      metric: z.enum(["ssimulacra2", "vmaf"]),
+      target: z.number().min(1).max(100),
+      floor: z.number().min(1).max(100).optional(),
+      maxBytes: z.number().int().positive().optional()
+    }).strict().optional()
   }).strict(),
   z.object({
     role: z.literal("poster"),
@@ -182,7 +187,13 @@ var videoOutputSchema2 = z2.object({
   codecs: z2.string().optional(),
   encoder: z2.string(),
   status: z2.enum(["written", "already-optimal", "stale"]),
-  search: z2.object({ metric: z2.enum(["ssimulacra2", "vmaf"]), target: z2.number() }).strict().optional(),
+  search: z2.object({
+    metric: z2.enum(["ssimulacra2", "vmaf"]),
+    target: z2.number(),
+    floor: z2.number().optional(),
+    maxBytes: z2.number().int().optional(),
+    plannedPath: z2.string().optional()
+  }).strict().optional(),
   score: z2.number().optional(),
   scorer: z2.enum(["wasm", "native", "libvmaf"]).optional()
 }).strict();

package/dist/{chunk-5JEA233Z.js → chunk-DZLFVN4G.js}

@@ -6,38 +6,38 @@ import {
   sortFindings,
   walkFiles,
   withVideos
-} from "./chunk-HLBNRB3S.js";
+} from "./chunk-GNW3OK5U.js";
 import {
   MANIFEST_FILE,
   parseManifest
-} from "./chunk-TCQFQ354.js";
+} from "./chunk-CSDZGNUN.js";
 import {
   ANIMATED_GIF_REASON,
   buildPlan,
   classify,
   classifyVideo,
   sha256
-} from "./chunk-RZ2V4PCS.js";
+} from "./chunk-JMMXC5UA.js";
 import {
   isFastStart,
   toPosix
-} from "./chunk-QOG2F4SF.js";
+} from "./chunk-L5HLKZDW.js";
 import {
   BUILTIN_POLICY,
   getImagePreset,
   pickAv1Encoder,
   rootPreset
-} from "./chunk-3PF6BBFK.js";
+} from "./chunk-PE5NKZCH.js";
 import {
   SafeFs
-} from "./chunk-IZ4JEL3Q.js";
+} from "./chunk-4AM2CCML.js";
 import {
   ALL_RULES,
   checkCache,
   checkVideoCache,
   matchesGlob,
   savingOf
-} from "./chunk-FY53B4NB.js";
+} from "./chunk-KJK7XGWA.js";
 
 // src/core/commands/audit.ts
 import { stat as stat2 } from "fs/promises";
@@ -212,6 +212,8 @@ async function estimateVideo(item, deps, sourcePath) {
   const starts = sampleStarts(item.durationSec);
   const exact = starts.length === 1 && starts[0].durationSec >= item.durationSec;
   const perCodec = [];
+  const stepTotal = item.outputs.filter((o) => o.role === "video" && encoderFor(o.codec, caps)).length * starts.length;
+  let stepsDone = 0;
   for (const out of item.outputs) {
     if (out.role !== "video") continue;
     const encoder = encoderFor(out.codec, caps);
@@ -230,10 +232,10 @@ async function estimateVideo(item, deps, sourcePath) {
     ].join("|");
     let streamBytes = deps.cache.getEstimate(key)?.bytes;
     if (streamBytes === void 0) {
-      let total = 0;
+      let total2 = 0;
       let seconds = 0;
       for (const s of starts) {
-        total += await deps.engine.sampleBytes(
+        total2 += await deps.engine.sampleBytes(
           {
             source: sourcePath,
             encoder,
@@ -247,14 +249,18 @@ async function estimateVideo(item, deps, sourcePath) {
           },
           deps.signal
         );
+        deps.onStep?.({ done: ++stepsDone, total: stepTotal });
         seconds += s.durationSec;
       }
-      streamBytes = Math.round(seconds > 0 ? total / seconds * item.durationSec : total);
+      streamBytes = Math.round(seconds > 0 ? total2 / seconds * item.durationSec : total2);
       deps.cache.setEstimate(key, { bytes: streamBytes, basis: exact ? "exact" : "extrapolated" });
     }
+    const total = streamBytes + audioBytes(out, item);
     perCodec.push({
       codec: out.codec,
-      bytes: streamBytes + audioBytes(out, item),
+      // A size cap is met by raising the CRF or narrowing the width, or the output is not
+      // written at all, so what a run will produce never exceeds it.
+      bytes: out.search?.maxBytes !== void 0 ? Math.min(total, out.search.maxBytes) : total,
       basis: exact ? "exact" : "extrapolated"
     });
   }
@@ -444,7 +450,14 @@ async function audit(options) {
       {
         engine: options.videoEngine,
         cache,
-        ffmpegVersion: videoVersions.ffmpeg ?? "unknown"
+        ffmpegVersion: videoVersions.ffmpeg ?? "unknown",
+        onStep: (step) => options.onProgress?.({
+          phase: "estimate",
+          done: probed - 1,
+          total,
+          source: item.source,
+          detail: `encoding sample ${step.done} of ${step.total}`
+        })
       },
       absolute
     );

package/dist/{chunk-PQRBLHCC.js → chunk-EM7JMQND.js}

@@ -6,7 +6,7 @@ import {
   probeFfmpeg,
   probeFfprobeVersion,
   resolveBinary
-} from "./chunk-3PF6BBFK.js";
+} from "./chunk-PE5NKZCH.js";
 
 // src/core/doctor/report.ts
 var MIN_NODE_MAJOR = 22;