asset-doctor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 STkangyh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# asset-doctor 🩺
+
+[![CI](https://github.com/STkangyh/asset-doctor/actions/workflows/ci.yml/badge.svg)](https://github.com/STkangyh/asset-doctor/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/asset-doctor.svg)](https://www.npmjs.com/package/asset-doctor)
+
+**Health checks for your `public/` folder — catch runtime 404s before your users do.**
+
+Your bundler verifies every `import`. **Nobody verifies your string asset paths.**
+A typo in `"/img/hero.png"` builds fine, deploys fine, and 404s in production.
+Meanwhile dead files pile up in `public/` and a 20 MB SVG ships unnoticed.
+
+```bash
+npx asset-doctor check --max-size 500
+```
+
+```
+public/  101 assets · scanned 237 files · 97 referenced
+  ✖ missing    4 reference(s) point to files that don't exist
+       /img/hero@2x.png  (src/components/Hero.tsx:12)
+       /lottie/loading.json  (src/hooks/useAnimations.ts:8)
+  ✖ oversize   2 file(s) exceed 500 KB
+       /img/background.svg  (15.0 MB)
+  ⚠ orphans    4 file(s) (15.6 MB) never referenced — review before deleting
+  ℹ dynamic    14 template-string reference(s) couldn't be verified
+```
+
+Exits `1` on missing or oversize files — drop it straight into CI.
+
+## Why
+
+Real result from the first project this ran on: **10 broken asset references**
+(code fetching `.json` files that had been replaced by `.lottie` versions —
+silent runtime 404s), a **20 MB SVG** shipping to every visitor, and 15 MB of
+orphaned files. All invisible to the bundler, the type checker, and code review.
+
+## What it checks
+
+| Check | What it catches |
+| --- | --- |
+| ✖ **missing** | Root-absolute references (`"/img/x.png"`) to files that don't exist — runtime 404s. Found in JS/TS/JSX, CSS, HTML, Markdown, and even `site.webmanifest` icons. |
+| ✖ **oversize** | Public files over `--max-size` KB — your asset weight budget, enforced in CI. |
+| ⚠ **orphans** | Files in `public/` that no scanned file references. Conventional files (`favicon*`, `robots.txt`, `sitemap*.xml`, `*.webmanifest`, `.well-known/**`, …) are exempt by default. |
+
+## Typed asset manifest
+
+Stop hand-maintaining an `assets.ts` full of string paths. Generate one:
+
+```bash
+npx asset-doctor manifest -o src/assets.gen.ts
+```
+
+```ts
+// AUTO-GENERATED by asset-doctor — do not edit.
+export const assets = {
+  img: {
+    logo: "/img/logo.png",
+    heroImage2x: "/img/hero-image_2x.png",
+  },
+} as const;
+
+export type AssetPath = (typeof assetList)[number];
+```
+
+Now `assets.img.logo` autocompletes, and a renamed file becomes a **compile
+error** instead of a production 404. (Generated files are automatically
+excluded from reference scanning, so the manifest never masks real orphans.)
+
+## Versus existing tools
+
+| | asset-doctor | knip / deadfile | assetdrain |
+| --- | :---: | :---: | :---: |
+| Broken references (404s) | ✅ | ❌ | ❌ |
+| Orphaned public assets | ✅ | ❌ module graph only — string paths are invisible to it | ✅ |
+| Size budget for CI | ✅ | ❌ | ❌ |
+| Typed manifest generator | ✅ | ❌ | ❌ |
+| Runtime dependencies | **0** | — | — |
+
+Module-graph tools (knip, deadfile) are great at unused *code*, but `public/`
+assets referenced by URL string never enter the module graph — they can't see
+them. assetdrain cleans unused assets but doesn't catch broken references,
+which is where the actual bugs are.
+
+## Usage
+
+```bash
+# Full health check (CI-friendly: exits 1 on missing/oversize)
+asset-doctor check --max-size 500
+
+# Treat orphans as errors too
+asset-doctor check --fail-orphans
+
+# Custom public dir, extra orphan exemptions, JSON output
+asset-doctor check --public static --exempt "og/**" --json
+
+# Generate the typed manifest
+asset-doctor manifest -o src/assets.gen.ts
+```
+
+### GitHub Action
+
+```yaml
+- uses: STkangyh/asset-doctor@v1
+  with:
+    max-size: 500
+```
+
+### Library
+
+```ts
+import { scan, generateManifest, collectAssets } from "asset-doctor";
+
+const report = scan({ root: process.cwd(), maxSizeKb: 500 });
+if (report.missing.length > 0) process.exit(1);
+```
+
+## Honest limitations
+
+- Matching is **exact string matching** (after stripping `?query`/`#hash`).
+  Paths built with template interpolation can't be verified — they're counted
+  and reported as `dynamic`, never guessed at.
+- Because of dynamic paths, **orphans are warnings by default**. Review before
+  deleting; use `--fail-orphans` once you trust the result.
+- A root-absolute string with an asset extension (`"/foo/bar.json"`) is assumed
+  to target `public/`. If it's actually an API route, add it to `--exempt`.
+
+## Sister project
+
+🩺 [lottie-doctor](https://github.com/STkangyh/lottie-doctor) — diagnose and
+repair broken Lottie files (garbled text, size bloat).
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { parseArgs } from "node:util";
+import { generateManifest } from "./manifest.js";
+import { collectAssets, scan } from "./scan.js";
+import { GENERATED_MARKER } from "./util.js";
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const paint = (code) => (s) => useColor ? `\x1b[${code}m${s}\x1b[0m` : s;
+const c = {
+    red: paint("31"),
+    green: paint("32"),
+    yellow: paint("33"),
+    blue: paint("36"),
+    dim: paint("2"),
+    bold: paint("1"),
+};
+function fmtBytes(n) {
+    if (n >= 1024 * 1024)
+        return `${(n / 1024 / 1024).toFixed(1)} MB`;
+    if (n >= 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${n} B`;
+}
+const HELP = `asset-doctor — health checks for your public/ assets
+
+Usage:
+  asset-doctor check [--root <dir>] [--public <dir>] [--max-size <KB>]
+                     [--fail-orphans] [--exempt <glob>]... [--json]
+  asset-doctor manifest [-o <file>] [--root <dir>] [--public <dir>]
+
+check     Cross-reference public/ against your source code.
+            ✖ missing   references to files that don't exist (runtime 404s)
+            ⚠ orphans   files in public/ that nothing references
+            ✖ oversize  files exceeding --max-size
+          Exits 1 on missing refs or oversize files (CI-friendly).
+manifest  Generate a typed TS manifest of every public asset, so a typo in
+          an asset path becomes a compile error.
+
+Options:
+  --root <dir>        Project root (default: current directory)
+  --public <dir>      Public directory name (default: public)
+  --max-size <KB>     Flag public files larger than this
+  --fail-orphans      Exit 1 when orphans are found (default: warn only)
+  --exempt <glob>     Extra orphan exemptions (repeatable)
+  --json              Machine-readable output
+  -o, --output <file> Manifest output path (default: src/assets.gen.ts)
+  -h, --help          Show this help
+`;
+function cmdCheck(o) {
+    const r = scan({
+        root: o.root,
+        publicDir: o.publicDir,
+        maxSizeKb: o.maxSize,
+        exemptOrphans: o.exempt,
+    });
+    const failed = r.missing.length > 0 ||
+        r.oversize.length > 0 ||
+        (o.failOrphans && r.orphans.length > 0);
+    if (o.json) {
+        console.log(JSON.stringify(r, null, 2));
+        return failed ? 1 : 0;
+    }
+    console.log(`${c.bold(o.publicDir + "/")}  ${r.publicFiles} assets · scanned ${r.readableFiles} files · ${r.referencedCount} referenced`);
+    if (r.missing.length > 0) {
+        console.log(`  ${c.red("✖ missing")}    ${r.missing.length} reference(s) point to files that don't exist`);
+        for (const m of r.missing.slice(0, 8)) {
+            console.log(`       ${m.ref}  ${c.dim(`(${m.file}:${m.line})`)}`);
+        }
+        if (r.missing.length > 8)
+            console.log(c.dim(`       … and ${r.missing.length - 8} more (--json for all)`));
+    }
+    if (r.oversize.length > 0) {
+        console.log(`  ${c.red("✖ oversize")}   ${r.oversize.length} file(s) exceed ${o.maxSize} KB`);
+        for (const f of r.oversize.slice(0, 8)) {
+            console.log(`       ${f.path}  ${c.dim(`(${fmtBytes(f.sizeBytes)})`)}`);
+        }
+    }
+    if (r.orphans.length > 0) {
+        console.log(`  ${c.yellow("⚠ orphans")}    ${r.orphans.length} file(s) (${fmtBytes(r.orphanBytes)}) never referenced — review before deleting`);
+        for (const f of r.orphans.slice(0, 8)) {
+            console.log(`       ${f.path}  ${c.dim(`(${fmtBytes(f.sizeBytes)})`)}`);
+        }
+        if (r.orphans.length > 8)
+            console.log(c.dim(`       … and ${r.orphans.length - 8} more (--json for all)`));
+    }
+    if (r.dynamicRefs > 0) {
+        console.log(`  ${c.blue("ℹ dynamic")}    ${r.dynamicRefs} template-string reference(s) couldn't be verified`);
+    }
+    if (!failed && r.orphans.length === 0) {
+        console.log(`  ${c.green("✔ healthy")}`);
+    }
+    return failed ? 1 : 0;
+}
+function cmdManifest(o) {
+    const assets = collectAssets(o.root, o.publicDir);
+    if (assets.size === 0) {
+        console.error(c.red(`error: no assets found under ${o.publicDir}/ (root: ${o.root})`));
+        return 2;
+    }
+    if (existsSync(o.output)) {
+        const head = readFileSync(o.output, "utf8").slice(0, 300);
+        if (!head.includes(GENERATED_MARKER)) {
+            console.error(c.red(`error: ${o.output} exists and was not generated by asset-doctor — refusing to overwrite`));
+            return 2;
+        }
+    }
+    mkdirSync(dirname(o.output), { recursive: true });
+    writeFileSync(o.output, generateManifest(assets.keys()));
+    console.log(`${c.green("✔")} wrote ${c.bold(o.output)} (${assets.size} assets)`);
+    return 0;
+}
+function main() {
+    const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        options: {
+            root: { type: "string" },
+            public: { type: "string" },
+            "max-size": { type: "string" },
+            "fail-orphans": { type: "boolean", default: false },
+            exempt: { type: "string", multiple: true },
+            json: { type: "boolean", default: false },
+            output: { type: "string", short: "o" },
+            help: { type: "boolean", short: "h", default: false },
+        },
+    });
+    if (values.help || positionals.length === 0) {
+        console.log(HELP);
+        return values.help ? 0 : 1;
+    }
+    const root = values.root ?? process.cwd();
+    const publicDir = values.public ?? "public";
+    const command = positionals[0];
+    switch (command) {
+        case "check":
+            return cmdCheck({
+                root,
+                publicDir,
+                maxSize: values["max-size"] != null ? Number(values["max-size"]) : null,
+                failOrphans: values["fail-orphans"],
+                exempt: values.exempt ?? [],
+                json: values.json,
+            });
+        case "manifest":
+            return cmdManifest({
+                root,
+                publicDir,
+                output: values.output ?? "src/assets.gen.ts",
+            });
+        default:
+            console.error(c.red(`unknown command: ${command}`));
+            console.log(HELP);
+            return 2;
+    }
+}
+process.exit(main());
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC/D,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,CAAS,EAAE,EAAE,CAC5C,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,MAAM,CAAC,GAAG;IACR,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;IACjB,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;IACf,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;CACjB,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACpD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBZ,CAAC;AAWF,SAAS,QAAQ,CAAC,CAAY;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,OAAO;QACpB,aAAa,EAAE,CAAC,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,MAAM,MAAM,GACV,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE1C,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,qBAAqB,CAAC,CAAC,aAAa,YAAY,CAAC,CAAC,eAAe,aAAa,CAC7H,CAAC;IAEF,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,+CAA+C,CAC9F,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,mBAAmB,CAAC,CAAC,OAAO,KAAK,CACjF,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,aAAa,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,6CAA6C,CACnI,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,oDAAoD,CACjG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,CAIpB;IACC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CACX,CAAC,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,IAAI,GAAG,CAAC,CACxE,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CACX,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,uEAAuE,CAAC,CACjG,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC;IACjF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,IAAI;IACX,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACnD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACtC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE/B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;gBACd,IAAI;gBACJ,SAAS;gBACT,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvE,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC;gBACnC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;QACL,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;gBACjB,IAAI;gBACJ,SAAS;gBACT,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,mBAAmB;aAC7C,CAAC,CAAC;QACL;YACE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { scan, collectAssets } from "./scan.js";
+export { generateManifest } from "./manifest.js";
+export type { MissingRef, OrphanAsset, OversizeAsset, ScanOptions, ScanReport, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { scan, collectAssets } from "./scan.js";
+export { generateManifest } from "./manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a typed TypeScript manifest module from a list of public web paths
+ * (as produced by {@link collectAssets}). The result is a nested `assets`
+ * object mirroring the directory structure, plus a flat `assetList` and an
+ * `AssetPath` union type — so a typo in an asset path is a compile error.
+ */
+export declare function generateManifest(webPaths: Iterable<string>): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CA+BnE"}

package/dist/manifest.js

@@ -0,0 +1,62 @@
+import { GENERATED_MARKER, IDENT_RE, camelCase } from "./util.js";
+function keyFor(node, fileName) {
+    const stem = fileName.replace(/\.[^.]+$/, "");
+    let key = camelCase(stem) || stem;
+    if (!(key in node))
+        return key;
+    key = camelCase(fileName) || fileName; // disambiguate by extension
+    let i = 2;
+    let candidate = key;
+    while (candidate in node)
+        candidate = key + i++;
+    return candidate;
+}
+function serialize(node, depth) {
+    const pad = "  ".repeat(depth);
+    const keys = Object.keys(node).sort();
+    const lines = keys.map((k) => {
+        const v = node[k];
+        const key = IDENT_RE.test(k) ? k : JSON.stringify(k);
+        return typeof v === "string"
+            ? `${pad}${key}: ${JSON.stringify(v)},`
+            : `${pad}${key}: ${serialize(v, depth + 1)},`;
+    });
+    return "{\n" + lines.join("\n") + "\n" + "  ".repeat(depth - 1) + "}";
+}
+/**
+ * Generate a typed TypeScript manifest module from a list of public web paths
+ * (as produced by {@link collectAssets}). The result is a nested `assets`
+ * object mirroring the directory structure, plus a flat `assetList` and an
+ * `AssetPath` union type — so a typo in an asset path is a compile error.
+ */
+export function generateManifest(webPaths) {
+    const sorted = [...webPaths].sort();
+    const root = {};
+    for (const p of sorted) {
+        const segs = p.slice(1).split("/");
+        const file = segs.pop();
+        let node = root;
+        for (const dir of segs) {
+            let key = camelCase(dir) || dir;
+            if (typeof node[key] === "string")
+                key += "Dir";
+            node = (node[key] ??= {});
+        }
+        node[keyFor(node, file)] = p;
+    }
+    const list = sorted.map((p) => `  ${JSON.stringify(p)},`).join("\n");
+    return [
+        `// ${GENERATED_MARKER} — do not edit.`,
+        `// Regenerate with: npx asset-doctor manifest`,
+        ``,
+        `export const assets = ${serialize(root, 1)} as const;`,
+        ``,
+        `export const assetList = [`,
+        list,
+        `] as const;`,
+        ``,
+        `export type AssetPath = (typeof assetList)[number];`,
+        ``,
+    ].join("\n");
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/scan.d.ts

@@ -0,0 +1,13 @@
+import type { ScanOptions, ScanReport } from "./types.js";
+/** List public assets as web paths (`/img/logo.png`) with their sizes. */
+export declare function collectAssets(root: string, publicDir?: string): Map<string, number>;
+/**
+ * Cross-check the public directory against every reference in the codebase.
+ *
+ * Finds: references to assets that don't exist (runtime 404s), assets nothing
+ * references (orphans), and assets over the size budget. String matching is
+ * exact after stripping `?query`/`#hash`; root-absolute references built with
+ * template interpolation are counted as `dynamicRefs` and never flagged.
+ */
+export declare function scan(options?: ScanOptions): ScanReport;
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAmDpB,0EAA0E;AAC1E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,SAAW,GACnB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrB;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CAwG1D"}

package/dist/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+/** Options for {@link scan}. */
+export interface ScanOptions {
+    /** Project root to scan. Default: `process.cwd()`. */
+    root?: string;
+    /** Static-assets directory name, relative to root. Default: `"public"`. */
+    publicDir?: string;
+    /** Flag public files larger than this many KB. `null` disables. Default: `null`. */
+    maxSizeKb?: number | null;
+    /**
+     * Extra glob patterns (matched against the public-relative path and the
+     * basename) exempted from the orphan check, on top of the built-in
+     * conventions (favicon*, robots.txt, sitemap*.xml, *.webmanifest, …).
+     */
+    exemptOrphans?: string[];
+}
+/** A reference in source code to a public asset that does not exist. */
+export interface MissingRef {
+    /** The referenced web path, e.g. `/img/hero.png`. */
+    ref: string;
+    /** Source file containing the reference, relative to root. */
+    file: string;
+    /** 1-based line number of the reference. */
+    line: number;
+}
+/** A public asset that no scanned file references. */
+export interface OrphanAsset {
+    /** Web path of the asset, e.g. `/img/old-banner.png`. */
+    path: string;
+    sizeBytes: number;
+}
+/** A public asset exceeding the size budget. */
+export interface OversizeAsset {
+    path: string;
+    sizeBytes: number;
+}
+/** The result of {@link scan}. */
+export interface ScanReport {
+    /** Number of files found under the public directory. */
+    publicFiles: number;
+    /** Number of source/text files whose contents were scanned for references. */
+    readableFiles: number;
+    /** Number of distinct public assets referenced somewhere. */
+    referencedCount: number;
+    /** Root-absolute references built with template interpolation — unverifiable. */
+    dynamicRefs: number;
+    missing: MissingRef[];
+    orphans: OrphanAsset[];
+    oversize: OversizeAsset[];
+    /** Total size of all orphaned assets, in bytes. */
+    orphanBytes: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/util.d.ts

@@ -0,0 +1,16 @@
+/** First-line marker that identifies files generated by asset-doctor. */
+export declare const GENERATED_MARKER = "AUTO-GENERATED by asset-doctor";
+/**
+ * Orphan-check exemptions for files browsers and crawlers fetch by
+ * convention, without any reference appearing in source code.
+ */
+export declare const DEFAULT_ORPHAN_EXEMPT: string[];
+/** Recursively list all regular files under `dir` (absolute paths). */
+export declare function walk(dir: string): string[];
+/** Minimal glob → RegExp: `**` crosses slashes, `*` does not, `?` is one char. */
+export declare function globToRegExp(glob: string): RegExp;
+/** Valid bare JS identifier (no quoting needed as an object key). */
+export declare const IDENT_RE: RegExp;
+/** `"hero_image-2x"` → `"heroImage2x"`. */
+export declare function camelCase(s: string): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAGA,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AAcjE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB1C;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBjD;AAED,qEAAqE;AACrE,eAAO,MAAM,QAAQ,QAA+B,CAAC;AAErD,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3C"}

package/dist/util.js

@@ -0,0 +1,95 @@
+import { readdirSync } from "node:fs";
+import { join } from "node:path";
+/** First-line marker that identifies files generated by asset-doctor. */
+export const GENERATED_MARKER = "AUTO-GENERATED by asset-doctor";
+/** Directories never worth scanning. */
+const SKIP_DIRS = new Set([
+    "node_modules",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    "vendor",
+]);
+const JUNK_FILES = new Set([".DS_Store", "Thumbs.db", "desktop.ini", ".gitkeep"]);
+/**
+ * Orphan-check exemptions for files browsers and crawlers fetch by
+ * convention, without any reference appearing in source code.
+ */
+export const DEFAULT_ORPHAN_EXEMPT = [
+    "robots.txt",
+    "sitemap*.xml",
+    "favicon*",
+    "apple-touch-icon*",
+    "*.webmanifest",
+    "manifest.json",
+    "browserconfig.xml",
+    "humans.txt",
+    "ads.txt",
+    ".well-known/**",
+];
+/** Recursively list all regular files under `dir` (absolute paths). */
+export function walk(dir) {
+    const out = [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const e of entries) {
+        if (e.isDirectory()) {
+            if (SKIP_DIRS.has(e.name))
+                continue;
+            // skip dot-directories (.git, .next, .vercel, …) except .well-known,
+            // which legitimately lives inside public/
+            if (e.name.startsWith(".") && e.name !== ".well-known")
+                continue;
+            out.push(...walk(join(dir, e.name)));
+        }
+        else if (e.isFile()) {
+            if (!JUNK_FILES.has(e.name))
+                out.push(join(dir, e.name));
+        }
+    }
+    return out;
+}
+/** Minimal glob → RegExp: `**` crosses slashes, `*` does not, `?` is one char. */
+export function globToRegExp(glob) {
+    const g = glob.replace(/^\//, "");
+    let re = "";
+    for (let i = 0; i < g.length; i++) {
+        const ch = g[i];
+        if (ch === "*") {
+            if (g[i + 1] === "*") {
+                re += ".*";
+                i++;
+                if (g[i + 1] === "/")
+                    i++;
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if (ch === "?") {
+            re += "[^/]";
+        }
+        else {
+            re += ch.replace(/[.+^${}()|[\]\\]/, "\\$&");
+        }
+    }
+    return new RegExp("^" + re + "$");
+}
+/** Valid bare JS identifier (no quoting needed as an object key). */
+export const IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** `"hero_image-2x"` → `"heroImage2x"`. */
+export function camelCase(s) {
+    const parts = s.split(/[^A-Za-z0-9]+/).filter(Boolean);
+    return parts
+        .map((p, i) => i === 0
+        ? p.charAt(0).toLowerCase() + p.slice(1)
+        : p.charAt(0).toUpperCase() + p.slice(1))
+        .join("");
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "asset-doctor",
+  "version": "0.1.0",
+  "description": "Health checks for your public/ assets: find broken references (runtime 404s), orphaned files, and oversized assets — and generate a typed asset manifest. Zero dependencies.",
+  "type": "module",
+  "bin": {
+    "asset-doctor": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "assets",
+    "public",
+    "unused",
+    "orphan",
+    "missing",
+    "404",
+    "broken-links",
+    "nextjs",
+    "vite",
+    "cli",
+    "linter",
+    "manifest",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "STkangyh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STkangyh/asset-doctor.git"
+  },
+  "homepage": "https://github.com/STkangyh/asset-doctor#readme",
+  "bugs": "https://github.com/STkangyh/asset-doctor/issues",
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5",
+    "vitest": "^3"
+  }
+}