youmightnotneed 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johannes Maendle
+
+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,27 @@
+# youmightnotneed
+
+Find the modern CSS and HTML that replaces your JavaScript dependencies.
+
+```
+npx youmightnotneed
+```
+
+Reads the nearest `package.json` and prints what the platform now covers,
+grouped by how well supported the replacement is.
+
+```
+npx youmightnotneed [path] [options]
+
+  path            A package.json, or a directory holding one.
+  -v, --verbose   Print every condition where the dependency still wins.
+      --json      Machine-readable output.
+      --no-color  Disable colour. NO_COLOR is respected too.
+  -h, --help      Show help.
+```
+
+Run it with `--verbose` before you change anything. The conditions are the
+point: a dependency in `package.json` is not proof of what it is used for, so
+every finding is a "this may apply", and the report says when it does not.
+
+Powered by [`@jomae/catalog`](https://www.npmjs.com/package/@jomae/catalog).
+MIT.

package/dist/bin.d.ts

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

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+/**
+ * npx youmightnotneed
+ *
+ * Reads a package.json, runs the catalog's detect(), prints a report. All the
+ * I/O lives here; the rendering and the detection are both pure.
+ */
+import { readFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { analyze, BASELINE_DATA_DATE, packageSizes, WEB_FEATURES_VERSION, } from "@jomae/catalog";
+import { createPalette } from "./colors.js";
+import { renderJson, renderReport } from "./render.js";
+const HELP = `
+youmightnotneed  ·  is it CSS yet?
+
+Finds the modern CSS and HTML that replaces your JavaScript dependencies.
+
+Usage
+  npx youmightnotneed [path] [options]
+
+  path            A package.json, or a directory containing one.
+                  Defaults to the nearest package.json from the current
+                  directory upwards.
+
+Options
+  -v, --verbose   Print every condition under which the dependency is still
+                  the right call. Recommended before you change anything.
+      --json      Machine-readable output.
+      --no-color  Disable colour. Also respects the NO_COLOR variable.
+  -h, --help      Show this.
+      --version   Print the version.
+
+Notes
+  A dependency in package.json is not proof of what it is used for, so every
+  finding is a "this may apply", not an instruction. Read the conditions.
+`;
+function parseArgs(argv) {
+    const args = {
+        path: undefined,
+        verbose: false,
+        json: false,
+        color: !process.env.NO_COLOR,
+        help: false,
+        version: false,
+    };
+    for (const arg of argv) {
+        switch (arg) {
+            case "-v":
+            case "--verbose":
+                args.verbose = true;
+                break;
+            case "--json":
+                args.json = true;
+                break;
+            case "--no-color":
+                args.color = false;
+                break;
+            case "-h":
+            case "--help":
+                args.help = true;
+                break;
+            case "--version":
+                args.version = true;
+                break;
+            default:
+                if (arg.startsWith("-")) {
+                    console.error(`Unknown option: ${arg}`);
+                    console.error("Run with --help to see the available options.");
+                    process.exit(2);
+                }
+                args.path = arg;
+                break;
+        }
+    }
+    return args;
+}
+/** Walks up from a directory looking for a package.json. */
+function findPackageJson(start) {
+    let dir = resolve(start);
+    for (let depth = 0; depth < 40; depth += 1) {
+        const candidate = join(dir, "package.json");
+        try {
+            readFileSync(candidate, "utf8");
+            return candidate;
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    }
+    return null;
+}
+function resolveTarget(input) {
+    if (!input) {
+        const found = findPackageJson(process.cwd());
+        if (!found) {
+            console.error("No package.json found here or in any parent directory.\nPass a path: npx youmightnotneed ./path/to/package.json");
+            process.exit(1);
+        }
+        return found;
+    }
+    const target = resolve(input);
+    if (basename(target) === "package.json")
+        return target;
+    const inDir = join(target, "package.json");
+    try {
+        readFileSync(inDir, "utf8");
+        return inDir;
+    }
+    catch {
+        console.error(`No package.json at ${inDir}`);
+        process.exit(1);
+    }
+}
+function readPackageJson(file) {
+    let raw;
+    try {
+        raw = readFileSync(file, "utf8");
+    }
+    catch {
+        console.error(`Could not read ${file}`);
+        process.exit(1);
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null) {
+            throw new Error("not an object");
+        }
+        return parsed;
+    }
+    catch {
+        console.error(`${file} is not valid JSON.`);
+        process.exit(1);
+    }
+}
+function readOwnVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+const args = parseArgs(process.argv.slice(2));
+if (args.help) {
+    console.info(HELP);
+    process.exit(0);
+}
+if (args.version) {
+    console.info(readOwnVersion());
+    process.exit(0);
+}
+const target = resolveTarget(args.path);
+const pkg = readPackageJson(target);
+const report = analyze(pkg);
+if (args.json) {
+    console.info(renderJson(report));
+}
+else {
+    const useColor = args.color && process.stdout.isTTY === true;
+    console.info(renderReport(report, {
+        palette: createPalette(useColor),
+        projectName: pkg.name ?? basename(dirname(target)),
+        provenance: {
+            baselineOn: BASELINE_DATA_DATE,
+            webFeaturesVersion: WEB_FEATURES_VERSION,
+            sizesOn: packageSizes.fetchedOn,
+        },
+        verbose: args.verbose,
+    }));
+}
+// The report is informational, so a clean run always exits 0. A CI-friendly
+// threshold flag can come later, once the catalog has settled.
+process.exit(0);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/colors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A very small ANSI helper. The CLI has no dependencies beyond the catalog, so
+ * terminal output screenshots well without pulling in a colour library.
+ */
+declare const CODES: {
+    readonly reset: `${string}0m`;
+    readonly bold: `${string}1m`;
+    readonly dim: `${string}2m`;
+    readonly red: `${string}31m`;
+    readonly green: `${string}32m`;
+    readonly yellow: `${string}33m`;
+    readonly blue: `${string}34m`;
+    readonly cyan: `${string}36m`;
+    readonly grey: `${string}90m`;
+};
+export type ColorName = Exclude<keyof typeof CODES, "reset">;
+export interface Palette {
+    (name: ColorName, text: string): string;
+    enabled: boolean;
+}
+/** Returns a painter that becomes the identity function when colour is off. */
+export declare function createPalette(enabled: boolean): Palette;
+export {};
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,QAAA,MAAM,KAAK;aACT,KAAK;aACL,IAAI;aACJ,GAAG;aACH,GAAG;aACH,KAAK;aACL,MAAM;aACN,IAAI;aACJ,IAAI;aACJ,IAAI;CACI,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,OAAO,KAAK,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,WAAW,OAAO;IACtB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAKvD"}

package/dist/colors.js

@@ -0,0 +1,24 @@
+/**
+ * A very small ANSI helper. The CLI has no dependencies beyond the catalog, so
+ * terminal output screenshots well without pulling in a colour library.
+ */
+/** ASCII escape, built at runtime to keep a control character out of source. */
+const ESC = `${String.fromCharCode(27)}[`;
+const CODES = {
+    reset: `${ESC}0m`,
+    bold: `${ESC}1m`,
+    dim: `${ESC}2m`,
+    red: `${ESC}31m`,
+    green: `${ESC}32m`,
+    yellow: `${ESC}33m`,
+    blue: `${ESC}34m`,
+    cyan: `${ESC}36m`,
+    grey: `${ESC}90m`,
+};
+/** Returns a painter that becomes the identity function when colour is off. */
+export function createPalette(enabled) {
+    const paint = ((name, text) => enabled ? `${CODES[name]}${text}${CODES.reset}` : text);
+    paint.enabled = enabled;
+    return paint;
+}
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAChF,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;AAE1C,MAAM,KAAK,GAAG;IACZ,KAAK,EAAE,GAAG,GAAG,IAAI;IACjB,IAAI,EAAE,GAAG,GAAG,IAAI;IAChB,GAAG,EAAE,GAAG,GAAG,IAAI;IACf,GAAG,EAAE,GAAG,GAAG,KAAK;IAChB,KAAK,EAAE,GAAG,GAAG,KAAK;IAClB,MAAM,EAAE,GAAG,GAAG,KAAK;IACnB,IAAI,EAAE,GAAG,GAAG,KAAK;IACjB,IAAI,EAAE,GAAG,GAAG,KAAK;IACjB,IAAI,EAAE,GAAG,GAAG,KAAK;CACT,CAAC;AASX,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,KAAK,GAAG,CAAC,CAAC,IAAe,EAAE,IAAY,EAAE,EAAE,CAC/C,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAY,CAAC;IACrE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,18 @@
+import { type Report } from "@jomae/catalog";
+import type { Palette } from "./colors.ts";
+export interface RenderOptions {
+    palette: Palette;
+    /** Shown in the header, usually the package.json name field. */
+    projectName?: string | undefined;
+    provenance: {
+        baselineOn: string;
+        webFeaturesVersion: string;
+        sizesOn: string;
+    };
+    /** Print the full unless list. When false, print only a count. */
+    verbose: boolean;
+}
+export declare function renderReport(report: Report, options: RenderOptions): string;
+/** --json, so scripts and agents get the data without parsing terminal text. */
+export declare function renderJson(report: Report): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,aAAa,CAAC;AA+CtD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;CAClB;AA2DD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CA2D3E;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BjD"}

package/dist/render.js

@@ -0,0 +1,134 @@
+import { baselineLabel, formatBytes, formatHeadline, } from "@jomae/catalog";
+const TIERS = [
+    {
+        status: "widely",
+        heading: "Baseline widely available",
+        note: "safe to use today",
+        marker: "+",
+        color: "green",
+    },
+    {
+        status: "newly",
+        heading: "Baseline newly available",
+        note: "works in current browsers, check your support target",
+        marker: "~",
+        color: "yellow",
+    },
+    {
+        status: "limited",
+        heading: "Limited availability",
+        note: "not in every engine yet, so it needs a fallback",
+        marker: "!",
+        color: "red",
+    },
+    {
+        status: "unknown",
+        heading: "Support unverified",
+        note: "the catalog could not resolve these, so treat them with suspicion",
+        marker: "?",
+        color: "grey",
+    },
+];
+function renderFinding(finding, options) {
+    const { palette } = options;
+    const lines = [];
+    const size = finding.replaceableBytes === null
+        ? "size unknown"
+        : formatBytes(finding.replaceableBytes);
+    lines.push(`  ${palette("bold", finding.rule.title)} ${palette("grey", `(${size})`)}`);
+    lines.push(`    ${palette("dim", "you have  ")}${finding.matched
+        .map((m) => palette("cyan", m.name))
+        .join(", ")}`);
+    lines.push(`    ${palette("dim", "native    ")}${finding.rule.native}`);
+    const limitedBy = finding.baseline.limitedBy;
+    if (limitedBy) {
+        lines.push(`    ${palette("dim", "capped by ")}${palette("grey", `${limitedBy.name}, ${baselineLabel(limitedBy.status).toLowerCase()}`)}`);
+    }
+    // Never show a replacement without the conditions under which it is wrong.
+    if (options.verbose) {
+        lines.push(`    ${palette("dim", "keep it if")}`);
+        for (const condition of finding.rule.agent.unless) {
+            lines.push(`      ${palette("grey", `- ${condition}`)}`);
+        }
+    }
+    else {
+        const count = finding.rule.agent.unless.length;
+        lines.push(`    ${palette("dim", `keep it if ${count} condition${count === 1 ? "" : "s"} apply, see --verbose`)}`);
+    }
+    lines.push("");
+    return lines;
+}
+function footer(options) {
+    const { provenance } = options;
+    return [
+        `Baseline from web-features@${provenance.webFeaturesVersion}, captured ${provenance.baselineOn}.`,
+        `Sizes from bundlephobia, captured ${provenance.sizesOn}.`,
+        "Details and live demos: https://youmightnotneed.dev",
+    ].join("\n");
+}
+export function renderReport(report, options) {
+    const { palette } = options;
+    const { findings, summary } = report;
+    const lines = [];
+    lines.push("");
+    const title = palette("bold", "youmightnotneed");
+    lines.push(options.projectName
+        ? `${title} ${palette("grey", `· ${options.projectName}`)}`
+        : title);
+    lines.push("");
+    if (findings.length === 0) {
+        lines.push(`  ${palette("green", "Nothing in this package.json has a native equivalent in the catalog.")}`);
+        lines.push(`  ${palette("grey", "That is a real result. The catalog only covers CSS and HTML replacements.")}`);
+        lines.push("");
+        lines.push(palette("grey", footer(options)));
+        lines.push("");
+        return lines.join("\n");
+    }
+    lines.push(`  ${palette("bold", formatHeadline(summary.replaceableBytes, summary.packageCount))}`);
+    lines.push(`  ${palette("grey", "Minified and gzipped, and 'up to' on purpose: a dependency being installed is not proof of how it is used.")}`);
+    if (summary.hasUnknownSizes) {
+        lines.push(`  ${palette("grey", "Some matched packages have no measurement, so the real figure is higher.")}`);
+    }
+    lines.push("");
+    for (const tier of TIERS) {
+        const inTier = findings.filter((f) => f.baseline.status === tier.status);
+        if (inTier.length === 0)
+            continue;
+        lines.push(`${palette(tier.color, tier.marker)} ${palette("bold", tier.heading)} ${palette("grey", `· ${tier.note}`)}`);
+        lines.push("");
+        for (const finding of inTier) {
+            lines.push(...renderFinding(finding, options));
+        }
+    }
+    lines.push(palette("grey", footer(options)));
+    lines.push("");
+    return lines.join("\n");
+}
+/** --json, so scripts and agents get the data without parsing terminal text. */
+export function renderJson(report) {
+    return JSON.stringify({
+        summary: report.summary,
+        findings: report.findings.map((finding) => ({
+            ruleId: finding.rule.id,
+            title: finding.rule.title,
+            native: finding.rule.native,
+            baseline: {
+                status: finding.baseline.status,
+                label: baselineLabel(finding.baseline.status),
+                limitedBy: finding.baseline.limitedBy?.id ?? null,
+                dataDate: finding.baseline.dataDate,
+            },
+            matched: finding.matched.map((m) => ({
+                name: m.name,
+                fields: m.fields,
+                gzip: m.gzip,
+            })),
+            replaceableBytes: finding.replaceableBytes,
+            when: finding.rule.agent.when,
+            unless: finding.rule.agent.unless,
+            snippet: finding.rule.agent.snippet,
+            demoUrl: finding.rule.human.demoUrl ?? null,
+        })),
+    }, null, 2);
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "youmightnotneed",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Find the modern CSS and HTML that replaces your JavaScript dependencies.",
+  "license": "MIT",
+  "author": "Johannes Maendle",
+  "homepage": "https://youmightnotneed.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jomaendle/youmightnotneed.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "css",
+    "baseline",
+    "bundle-size",
+    "dependencies",
+    "cli"
+  ],
+  "bin": {
+    "youmightnotneed": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@jomae/catalog": "0.1.0"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.11",
+    "@types/node": "^24.13.3",
+    "@vitest/coverage-v8": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node src/bin.ts",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}