bytecut 0.1.0 → 0.2.1

package/README.md

@@ -18,7 +18,7 @@ landscape image is 1920 wide, a portrait one is 1920 tall, nothing is ever upsca
 and GPS are stripped, orientation is applied and the colour profile is kept.
 
 ```
-public/img/hero.jpg  →  public/_bytecut/img/hero/hero-1920.jpg
+public/img/hero.jpg  →  public/_bytecut/img/hero-1920.jpg
                          public/_bytecut/bytecut-manifest.json
 ```
 
@@ -30,6 +30,10 @@ public/img/hero.jpg  →  public/_bytecut/img/hero/hero-1920.jpg
 - **Videos and animated GIFs** become AV1 and H.264 MP4 plus a poster, using your own
   `ffmpeg` (see [Video](#video)).
 
+Outputs are flat: an image at the top of your static folder lands directly in `_bytecut/`, and
+one in a subfolder keeps that subfolder (`public/img/hero.jpg` → `_bytecut/img/hero-1920.jpg`).
+There is no extra folder per image.
+
 Re-running is cheap: unchanged sources are skipped by content hash, and the manifest is
 byte-identical when nothing changed, so it diffs cleanly in pull requests.
 
@@ -104,6 +108,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-PEKVNXKA.js → audit-EBKL6L65.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-LTWUPQDT.js";
 import {
   audit
-} from "./chunk-4PWCQ4NF.js";
+} from "./chunk-WI4ZO7GP.js";
 import {
   formatAuditReport
-} from "./chunk-P5PFI3AO.js";
+} from "./chunk-HLBNRB3S.js";
 import "./chunk-3DBJKHOD.js";
 import "./chunk-TCQFQ354.js";
 import {
   sharpImageEngine
 } from "./chunk-CSFBJ3UH.js";
-import "./chunk-XUBQWBWH.js";
+import "./chunk-RZ2V4PCS.js";
 import {
   configArg,
   createVideoEngine,

package/dist/{check-BYNAWCDE.js → check-XTTU5SCZ.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-LTWUPQDT.js";
 import {
   audit
-} from "./chunk-4PWCQ4NF.js";
+} from "./chunk-WI4ZO7GP.js";
 import {
   formatAuditReport
-} from "./chunk-P5PFI3AO.js";
+} from "./chunk-HLBNRB3S.js";
 import "./chunk-3DBJKHOD.js";
 import "./chunk-TCQFQ354.js";
 import {
   sharpImageEngine
 } from "./chunk-CSFBJ3UH.js";
-import "./chunk-XUBQWBWH.js";
+import "./chunk-RZ2V4PCS.js";
 import {
   configArg,
   createVideoEngine,

package/dist/{chunk-P5PFI3AO.js → chunk-HLBNRB3S.js}

@@ -16,7 +16,7 @@ import {
   classify,
   sha256,
   sha256File
-} from "./chunk-XUBQWBWH.js";
+} from "./chunk-RZ2V4PCS.js";
 import {
   AbortedError,
   outputWidth

package/dist/{chunk-XUBQWBWH.js → chunk-RZ2V4PCS.js}

@@ -161,7 +161,7 @@ async function buildPlan(options) {
     for (const width of outputWidths(preset, analysis.width, analysis.height)) {
       for (const format of formatsFor(preset, analysis, choice.confidence)) {
         const lossless = format === "png" || (preset.lossless ?? (analysis.format === "png" && format === "webp"));
-        const path = posix.join(dir, name, `${name}-${width}.${format}`);
+        const path = posix.join(dir, `${name}-${width}.${format}`);
         const owner = claimed.get(path);
         if (owner !== void 0) {
           throw new BytecutError(
@@ -260,7 +260,7 @@ function plannedVideoOutputs(source, staticRoot, preset, probe) {
   for (const codec of preset.codecs) {
     outputs.push({
       role: "video",
-      path: posix2.join(dir, name, `${name}-${width}.${codec}.mp4`),
+      path: posix2.join(dir, `${name}-${width}.${codec}.mp4`),
       codec,
       width,
       crf: preset.crf[codec],
@@ -274,7 +274,7 @@ function plannedVideoOutputs(source, staticRoot, preset, probe) {
   }
   outputs.push({
     role: "poster",
-    path: posix2.join(dir, name, `${name}-poster.avif`),
+    path: posix2.join(dir, `${name}-poster.avif`),
     format: "avif",
     width,
     quality: preset.poster.quality,

package/dist/{chunk-AYYKUSRP.js → chunk-SKANYRVT.js}

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "bytecut",
-  version: "0.1.0",
+  version: "0.2.1",
   description: "Audit and optimize images and videos in web projects.",
   type: "module",
   license: "MIT",

package/dist/{chunk-4PWCQ4NF.js → chunk-WI4ZO7GP.js}

@@ -6,7 +6,7 @@ import {
   sortFindings,
   walkFiles,
   withVideos
-} from "./chunk-P5PFI3AO.js";
+} from "./chunk-HLBNRB3S.js";
 import {
   MANIFEST_FILE,
   parseManifest
@@ -17,7 +17,7 @@ import {
   classify,
   classifyVideo,
   sha256
-} from "./chunk-XUBQWBWH.js";
+} from "./chunk-RZ2V4PCS.js";
 import {
   isFastStart,
   toPosix
@@ -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);
@@ -247,6 +249,7 @@ 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);
@@ -444,7 +447,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/cli.js

@@ -8,19 +8,19 @@ import {
 } from "./chunk-LTWUPQDT.js";
 import {
   audit
-} from "./chunk-4PWCQ4NF.js";
+} from "./chunk-WI4ZO7GP.js";
 import {
   package_default
-} from "./chunk-AYYKUSRP.js";
+} from "./chunk-SKANYRVT.js";
 import {
   formatAuditReport
-} from "./chunk-P5PFI3AO.js";
+} from "./chunk-HLBNRB3S.js";
 import "./chunk-3DBJKHOD.js";
 import "./chunk-TCQFQ354.js";
 import {
   sharpImageEngine
 } from "./chunk-CSFBJ3UH.js";
-import "./chunk-XUBQWBWH.js";
+import "./chunk-RZ2V4PCS.js";
 import {
   createVideoEngine,
   discover,
@@ -57,7 +57,7 @@ async function runDefault() {
     return;
   }
   if (isInteractive()) {
-    const { runTui } = await import("./tui-CDF23I73.js");
+    const { runTui } = await import("./tui-6WSMCHZS.js");
     await runTui({
       projectRoot: found.projectRoot,
       project: found.project,
@@ -125,13 +125,13 @@ var main = defineCommand({
     await runDefault();
   }),
   subCommands: {
-    audit: () => import("./audit-PEKVNXKA.js").then((m) => m.default),
-    optimize: () => import("./optimize-47YALM3D.js").then((m) => m.default),
+    audit: () => import("./audit-EBKL6L65.js").then((m) => m.default),
+    optimize: () => import("./optimize-TLJG7UYF.js").then((m) => m.default),
     snippet: () => import("./snippet-IIPVF6PS.js").then((m) => m.default),
     compare: () => import("./compare-MPPGTUC5.js").then((m) => m.default),
-    explain: () => import("./explain-TS6XF5TX.js").then((m) => m.default),
+    explain: () => import("./explain-LKOB7FRT.js").then((m) => m.default),
     init: () => import("./init-CWDWVJ55.js").then((m) => m.default),
-    check: () => import("./check-BYNAWCDE.js").then((m) => m.default),
+    check: () => import("./check-XTTU5SCZ.js").then((m) => m.default),
     doctor: () => import("./doctor-PWCUEBD5.js").then((m) => m.default)
   }
 });

package/dist/{explain-TS6XF5TX.js → explain-LKOB7FRT.js}

@@ -8,7 +8,7 @@ import {
   mirroredDir,
   outputWidths,
   plannedVideoOutputs
-} from "./chunk-XUBQWBWH.js";
+} from "./chunk-RZ2V4PCS.js";
 import {
   configArg,
   createVideoEngine,
@@ -123,7 +123,7 @@ async function explainFile(options) {
       const dir = mirroredDir(source, config.project.staticRoot);
       const name = posix.basename(source, posix.extname(source));
       const outputs = resolved2 ? outputWidths(resolved2, analysis.width, analysis.height).flatMap(
-        (w) => resolved2.formats.map((f) => posix.join(dir, name, `${name}-${w}.${f}`))
+        (w) => resolved2.formats.map((f) => posix.join(dir, `${name}-${w}.${f}`))
       ) : [];
       return {
         ...base,

package/dist/{optimize-47YALM3D.js → optimize-TLJG7UYF.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   package_default
-} from "./chunk-AYYKUSRP.js";
+} from "./chunk-SKANYRVT.js";
 import {
   formatFindings,
   formatPlan,
   formatSummary,
   optimize
-} from "./chunk-P5PFI3AO.js";
+} from "./chunk-HLBNRB3S.js";
 import "./chunk-3DBJKHOD.js";
 import {
   isPlaceholderKind,
@@ -17,7 +17,7 @@ import {
 import {
   sharpImageEngine
 } from "./chunk-CSFBJ3UH.js";
-import "./chunk-XUBQWBWH.js";
+import "./chunk-RZ2V4PCS.js";
 import {
   configArg,
   createVideoEngine,

package/dist/{tui-CDF23I73.js → tui-6WSMCHZS.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   audit
-} from "./chunk-4PWCQ4NF.js";
+} from "./chunk-WI4ZO7GP.js";
 import {
   formatSummary,
   optimize
-} from "./chunk-P5PFI3AO.js";
+} from "./chunk-HLBNRB3S.js";
 import {
   buildSnippet,
   originalUrl,
@@ -19,7 +19,7 @@ import {
   MANIFEST_FILE,
   parseManifest
 } from "./chunk-TCQFQ354.js";
-import "./chunk-XUBQWBWH.js";
+import "./chunk-RZ2V4PCS.js";
 import {
   toPosix
 } from "./chunk-QOG2F4SF.js";
@@ -454,7 +454,16 @@ function effectivePreset(state, row) {
 function reducer(state, action) {
   switch (action.type) {
     case "scan-progress":
-      return { ...state, scan: { phase: action.phase, done: action.done, total: action.total } };
+      return {
+        ...state,
+        scan: {
+          phase: action.phase,
+          done: action.done,
+          total: action.total,
+          ...action.source ? { source: action.source } : {},
+          ...action.detail ? { detail: action.detail } : {}
+        }
+      };
     case "scan-done":
       return {
         ...state,
@@ -1579,10 +1588,18 @@ function App(props) {
   let body;
   if (state.view === "scanning") {
     const sc = state.scan;
-    body = /* @__PURE__ */ jsxs5(Text5, { children: [
-      "Scanning",
-      sc && sc.total > 0 ? ` ${Math.min(sc.done, sc.total)}/${sc.total} images (${sc.phase})` : "",
-      "\u2026"
+    body = /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs5(Text5, { children: [
+        "Scanning",
+        sc && sc.total > 0 ? ` ${Math.min(sc.done, sc.total)}/${sc.total} files (${sc.phase})` : "",
+        "\u2026"
+      ] }),
+      sc?.source && sc.detail ? /* @__PURE__ */ jsxs5(Text5, { dimColor: true, children: [
+        sc.source,
+        ": ",
+        sc.detail,
+        ". Large videos take a while; the result is cached."
+      ] }) : null
     ] });
   } else if (state.view === "error") {
     body = /* @__PURE__ */ jsx5(Text5, { color: "red", children: state.error });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bytecut",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Audit and optimize images and videos in web projects.",
   "type": "module",
   "license": "MIT",