@macrulez/devtoolz 0.1.0 → 0.2.0

package/dist/commands/todo-report/vue.js

@@ -0,0 +1,71 @@
+// `.vue` handling, same split as strip-comments/vue.ts: the `<script>`
+// block goes through the real TS-parser path (core.ts), and the
+// `<template>` block's `<!-- -->` comments are matched by regex — no full
+// SFC template parser here, so a `<!-- -->`-looking sequence inside a
+// bound attribute string would be misread as a real comment. Same known,
+// documented limitation as strip-comments.
+import { analyzeTodoReport, buildTagMatcher, collectNoteText, DEFAULT_TAGS, } from './core.js';
+const SCRIPT_RE = /(<script[^>]*>)([\s\S]*?)(<\/script>)/;
+const TEMPLATE_RE = /(<template[^>]*>)([\s\S]*?)(<\/template>)/;
+const TEMPLATE_COMMENT_RE = /<!--[\s\S]*?-->/g;
+function lineAt(text, index) {
+    return (text.slice(0, index).match(/\n/g) ?? []).length;
+}
+function cleanTemplateLine(line) {
+    return line
+        .replace(/^\s*<!--/, '')
+        .replace(/-->\s*$/, '')
+        .trim();
+}
+function findTemplateTodos(body, tags) {
+    const findings = [];
+    const { pattern, canonical } = buildTagMatcher(tags);
+    for (const match of body.matchAll(TEMPLATE_COMMENT_RE)) {
+        const start = match.index;
+        const rawLines = match[0].split('\n');
+        let lineStart = start;
+        let i = 0;
+        while (i < rawLines.length) {
+            const rawLine = rawLines[i];
+            const m = pattern.exec(rawLine);
+            if (m) {
+                const { text: noteText, consumedThrough } = collectNoteText(rawLines, i, cleanTemplateLine, pattern);
+                findings.push({
+                    line: lineAt(body, lineStart + m.index) + 1,
+                    column: lineStart + m.index - body.lastIndexOf('\n', lineStart + m.index),
+                    tag: canonical.get(m[0].toLowerCase()) ?? m[0],
+                    text: noteText,
+                });
+                for (let k = i; k < consumedThrough; k++)
+                    lineStart += rawLines[k].length + 1;
+                i = consumedThrough;
+                continue;
+            }
+            lineStart += rawLine.length + 1;
+            i++;
+        }
+    }
+    return findings;
+}
+export function analyzeTodoReportVue(text, file, tags = DEFAULT_TAGS) {
+    const findings = [];
+    const scriptMatch = text.match(SCRIPT_RE);
+    if (scriptMatch) {
+        const [, , body] = scriptMatch;
+        const offset = lineAt(text, scriptMatch.index);
+        for (const f of analyzeTodoReport(body, file.replace(/\.vue$/, '.ts'), tags)) {
+            findings.push({ ...f, line: f.line + offset });
+        }
+    }
+    const templateMatch = text.match(TEMPLATE_RE);
+    if (templateMatch) {
+        const [, , body] = templateMatch;
+        const offset = lineAt(text, templateMatch.index);
+        for (const f of findTemplateTodos(body, tags)) {
+            findings.push({ ...f, line: f.line + offset });
+        }
+    }
+    findings.sort((a, b) => a.line - b.line || a.column - b.column);
+    return findings;
+}
+//# sourceMappingURL=vue.js.map

package/dist/commands/todo-report/vue.js.map

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

package/dist/commands/unused-deps/config-files.d.ts

@@ -0,0 +1,9 @@
+export declare function readConfigFilesText(packageDir: string): string;
+/**
+ * Whether `name` appears as its own token anywhere in `text` — either
+ * quoted (`extends: 'stylelint-config-standard'`) or a bare identifier
+ * (`plugins: { autoprefixer: {} }`). Bounded on both sides so a
+ * different package that merely contains `name` as a substring
+ * (`autoprefixer-wrapper`, `@scope/autoprefixer`) doesn't count.
+ */
+export declare function textReferencesPackage(text: string, name: string): boolean;

package/dist/commands/unused-deps/config-files.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { escapeRegExp } from '../../utils/escape-regexp.js';
+// Config files commonly reference a dependency by name — a vitest.config.ts's
+// `environment: 'happy-dom'` (a quoted string), a postcss.config.js's
+// `plugins: { autoprefixer: {} }` (a bare object key), never a JS
+// `import`. No import-statement parse can see either shape; this is a
+// deliberately narrow, explicit-filename text scan instead of guessing
+// at every possible config format. Only the package root is checked
+// (not recursive) — the overwhelming common location for all of these
+// in a real project.
+const CONFIG_FILENAMES = [
+    'vitest.config.ts',
+    'vitest.config.js',
+    'vitest.config.mts',
+    'vitest.config.mjs',
+    'vite.config.ts',
+    'vite.config.js',
+    'vite.config.mts',
+    '.eslintrc.json',
+    '.eslintrc.js',
+    '.eslintrc.cjs',
+    'eslint.config.js',
+    'eslint.config.mjs',
+    'eslint.config.ts',
+    '.stylelintrc',
+    '.stylelintrc.json',
+    '.stylelintrc.js',
+    'stylelint.config.js',
+    'stylelint.config.mjs',
+    'postcss.config.js',
+    'postcss.config.cjs',
+    'postcss.config.mjs',
+    'nuxt.config.ts',
+    'tsconfig.json',
+    'tsconfig.build.json',
+];
+export function readConfigFilesText(packageDir) {
+    const chunks = [];
+    for (const filename of CONFIG_FILENAMES) {
+        const path = join(packageDir, filename);
+        if (!existsSync(path))
+            continue;
+        try {
+            chunks.push(readFileSync(path, 'utf8'));
+        }
+        catch {
+            // unreadable — skip rather than fail the whole command over one config file
+        }
+    }
+    return chunks.join('\n');
+}
+/**
+ * Whether `name` appears as its own token anywhere in `text` — either
+ * quoted (`extends: 'stylelint-config-standard'`) or a bare identifier
+ * (`plugins: { autoprefixer: {} }`). Bounded on both sides so a
+ * different package that merely contains `name` as a substring
+ * (`autoprefixer-wrapper`, `@scope/autoprefixer`) doesn't count.
+ */
+export function textReferencesPackage(text, name) {
+    const pattern = new RegExp(`(?<![\\w@./-])${escapeRegExp(name)}(?![\\w-])`);
+    return pattern.test(text);
+}
+//# sourceMappingURL=config-files.js.map

package/dist/commands/unused-deps/config-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-files.js","sourceRoot":"","sources":["../../../src/commands/unused-deps/config-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,8EAA8E;AAC9E,sEAAsE;AACtE,kEAAkE;AAClE,sEAAsE;AACtE,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,qBAAqB;AACrB,MAAM,gBAAgB,GAAG;IACvB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,gBAAgB;IAChB,eAAe;IACf,qBAAqB;CACtB,CAAA;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC/B,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,4EAA4E;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,IAAY;IAC9D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,iBAAiB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC3E,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/dist/commands/unused-deps/core.d.ts

@@ -0,0 +1,25 @@
+declare const DEPENDENCY_SECTIONS: readonly ["dependencies", "devDependencies", "optionalDependencies"];
+type DependencySection = (typeof DEPENDENCY_SECTIONS)[number];
+export interface UnusedDepsFinding {
+    kind: 'unused' | 'phantom';
+    name: string;
+    /** which package.json section an 'unused' finding was declared in */
+    section?: DependencySection;
+    /** where a 'phantom' finding actually resolved from on disk */
+    resolvedFrom?: string;
+}
+export interface UnusedDepsAnalysis {
+    findings: UnusedDepsFinding[];
+    filesAnalyzed: number;
+}
+export interface AnalyzeOptions {
+    packageDir: string;
+    pkg: Record<string, unknown>;
+    /** also check packages that are structurally undetectable as "used" by any means this command can see. default false */
+    strict: boolean;
+    ignorePackages: Set<string>;
+    /** names of sibling packages in the same workspace — used-but-undeclared is expected for these, never "phantom" */
+    workspacePackageNames: Set<string>;
+}
+export declare function analyzeUnusedDeps(files: string[], options: AnalyzeOptions): UnusedDepsAnalysis;
+export {};

package/dist/commands/unused-deps/core.js

@@ -0,0 +1,121 @@
+import { readFileSync } from 'node:fs';
+import { analyzeFile } from '../../utils/parse-module.js';
+import { packageNameFromSpecifier } from './package-name.js';
+import { declaredBinNames, resolvePackageDir } from './disk-resolve.js';
+import { readConfigFilesText, textReferencesPackage } from './config-files.js';
+const DEPENDENCY_SECTIONS = ['dependencies', 'devDependencies', 'optionalDependencies'];
+// Packages that are near-universally legitimate to have installed
+// without ever appearing as an `import`, a script token, or even a
+// string in a config file — either genuinely ambient (`@types/*`, picked
+// up by TypeScript automatically) or inferred from a config VALUE by a
+// tool's own naming convention rather than written out in full
+// (`coverage: { provider: 'v8' }` in a vitest config makes vitest
+// require `@vitest/coverage-v8` itself — the full package name is never
+// actually written anywhere a text scan could find it). `--strict`
+// checks these too, for a manual audit.
+function isStructurallyImplicit(name) {
+    return (name.startsWith('@types/') ||
+        name === 'typescript' ||
+        name.startsWith('@vitest/coverage-') ||
+        name === '@vitest/ui' ||
+        // Ambient type augmentation for a Nuxt module's own config/types
+        // (`defineNuxtConfig`, module hooks) — never imported by name,
+        // same structural class as @types/*.
+        name === '@nuxt/schema' ||
+        // Vite's CSS preprocessors — auto-detected by file EXTENSION
+        // (a `.scss` import triggers Vite to require `sass` if it's
+        // installed) and postcss by config file PRESENCE, neither ever
+        // spelled out by name in the project's own files. Confirmed
+        // against two real, independent packages before adding this —
+        // not a guess.
+        name === 'postcss' ||
+        name === 'sass' ||
+        name === 'less' ||
+        name === 'stylus');
+}
+function tokenAppearsIn(values, token) {
+    const words = values.flatMap((s) => s.split(/\s+/));
+    return words.some((w) => w === token || w.endsWith(`/${token}`) || w.endsWith(`\\${token}`));
+}
+/**
+ * A dependency invoked only by its bin name from tooling config embedded
+ * directly in package.json (`scripts`, and `lint-staged` — commonly
+ * inlined there rather than its own file) counts as used, same as an
+ * import. Checked by the package's own name AND (if installed) its
+ * declared `bin` keys, since `tsc`/`vitest`/`eslint` etc. don't always
+ * match their package name.
+ */
+function usedViaPackageJsonTooling(pkg, packageDir, name) {
+    const scripts = pkg.scripts && typeof pkg.scripts === 'object'
+        ? Object.values(pkg.scripts)
+        : [];
+    const lintStaged = pkg['lint-staged'] && typeof pkg['lint-staged'] === 'object'
+        ? Object.values(pkg['lint-staged']).flatMap((v) => Array.isArray(v) ? v : typeof v === 'string' ? [v] : [])
+        : [];
+    const values = [...scripts, ...lintStaged];
+    if (tokenAppearsIn(values, name))
+        return true;
+    return declaredBinNames(packageDir, name).some((bin) => tokenAppearsIn(values, bin));
+}
+export function analyzeUnusedDeps(files, options) {
+    const usedPackageNames = new Set();
+    for (const file of files) {
+        const text = readFileSync(file, 'utf8');
+        const analysis = analyzeFile(text, file);
+        for (const imp of analysis.imports) {
+            const name = packageNameFromSpecifier(imp.from);
+            if (name)
+                usedPackageNames.add(name);
+        }
+    }
+    const declared = new Map();
+    const allDeclaredNames = new Set();
+    for (const section of DEPENDENCY_SECTIONS) {
+        const value = options.pkg[section];
+        if (!value || typeof value !== 'object')
+            continue;
+        for (const name of Object.keys(value)) {
+            declared.set(name, section);
+            allDeclaredNames.add(name);
+        }
+    }
+    const peerDeps = options.pkg.peerDependencies && typeof options.pkg.peerDependencies === 'object'
+        ? Object.keys(options.pkg.peerDependencies)
+        : [];
+    for (const name of peerDeps)
+        allDeclaredNames.add(name);
+    // A package importing itself by its own published name (the same
+    // self-reference readme-check resolves) is never a phantom dependency
+    // — it can't sensibly be its own devDependency, so it's exempted
+    // explicitly rather than expected to appear in package.json at all.
+    if (typeof options.pkg.name === 'string')
+        allDeclaredNames.add(options.pkg.name);
+    const configText = readConfigFilesText(options.packageDir);
+    const findings = [];
+    for (const [name, section] of declared) {
+        if (usedPackageNames.has(name))
+            continue;
+        if (options.ignorePackages.has(name))
+            continue;
+        if (!options.strict && isStructurallyImplicit(name))
+            continue;
+        if (usedViaPackageJsonTooling(options.pkg, options.packageDir, name))
+            continue;
+        if (textReferencesPackage(configText, name))
+            continue;
+        findings.push({ kind: 'unused', name, section });
+    }
+    for (const name of usedPackageNames) {
+        if (allDeclaredNames.has(name))
+            continue;
+        if (options.ignorePackages.has(name))
+            continue;
+        if (options.workspacePackageNames.has(name))
+            continue;
+        const resolvedFrom = resolvePackageDir(options.packageDir, name);
+        if (resolvedFrom)
+            findings.push({ kind: 'phantom', name, resolvedFrom });
+    }
+    return { findings, filesAnalyzed: files.length };
+}
+//# sourceMappingURL=core.js.map

package/dist/commands/unused-deps/core.js.map

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

package/dist/commands/unused-deps/disk-resolve.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Walks up from `fromDir` looking for `node_modules/<packageName>` —
+ * npm/yarn/pnpm all create this top-level symlink/directory for a
+ * package that's actually installed and resolvable, even when pnpm's
+ * real content lives in a `.pnpm` store elsewhere. Returns the resolved
+ * directory, or null if the package isn't installed anywhere up the
+ * tree (a broken import, not this command's concern — see core.ts).
+ */
+export declare function resolvePackageDir(fromDir: string, packageName: string): string | null;
+/** The bin command name(s) a package declares in its own package.json, if it's installed and readable. */
+export declare function declaredBinNames(fromDir: string, packageName: string): string[];

package/dist/commands/unused-deps/disk-resolve.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/**
+ * Walks up from `fromDir` looking for `node_modules/<packageName>` —
+ * npm/yarn/pnpm all create this top-level symlink/directory for a
+ * package that's actually installed and resolvable, even when pnpm's
+ * real content lives in a `.pnpm` store elsewhere. Returns the resolved
+ * directory, or null if the package isn't installed anywhere up the
+ * tree (a broken import, not this command's concern — see core.ts).
+ */
+export function resolvePackageDir(fromDir, packageName) {
+    let dir = resolve(fromDir);
+    for (;;) {
+        const candidate = join(dir, 'node_modules', packageName);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** The bin command name(s) a package declares in its own package.json, if it's installed and readable. */
+export function declaredBinNames(fromDir, packageName) {
+    const pkgDir = resolvePackageDir(fromDir, packageName);
+    if (!pkgDir)
+        return [];
+    try {
+        const pkg = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf8'));
+        if (typeof pkg.bin === 'string')
+            return [packageName];
+        if (pkg.bin && typeof pkg.bin === 'object')
+            return Object.keys(pkg.bin);
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=disk-resolve.js.map

package/dist/commands/unused-deps/disk-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-resolve.js","sourceRoot":"","sources":["../../../src/commands/unused-deps/disk-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,WAAmB;IACpE,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1B,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,WAAW,CAAC,CAAA;QACxD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;QAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC/B,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,WAAmB;IACnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IACtD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAGxE,CAAA;QACD,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,CAAC,WAAW,CAAC,CAAA;QACrD,IAAI,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;YACxC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAA8B,CAAC,CAAA;QACxD,OAAO,EAAE,CAAA;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/commands/unused-deps/package-name.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extracts the real npm package name a bare import specifier resolves
+ * to — `lodash/debounce` -> `lodash`, `@scope/name/sub/path` ->
+ * `@scope/name`. Returns null for a relative/absolute specifier or a
+ * Node builtin (`fs`, `node:fs`) — neither is ever a real dependency of
+ * this project.
+ */
+export declare function packageNameFromSpecifier(specifier: string): string | null;

package/dist/commands/unused-deps/package-name.js

@@ -0,0 +1,20 @@
+import { isBuiltin } from 'node:module';
+/**
+ * Extracts the real npm package name a bare import specifier resolves
+ * to — `lodash/debounce` -> `lodash`, `@scope/name/sub/path` ->
+ * `@scope/name`. Returns null for a relative/absolute specifier or a
+ * Node builtin (`fs`, `node:fs`) — neither is ever a real dependency of
+ * this project.
+ */
+export function packageNameFromSpecifier(specifier) {
+    if (specifier.startsWith('.') || specifier.startsWith('/'))
+        return null;
+    if (isBuiltin(specifier))
+        return null;
+    const parts = specifier.split('/');
+    if (specifier.startsWith('@')) {
+        return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : null;
+    }
+    return parts[0] ?? null;
+}
+//# sourceMappingURL=package-name.js.map

package/dist/commands/unused-deps/package-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-name.js","sourceRoot":"","sources":["../../../src/commands/unused-deps/package-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACvE,IAAI,SAAS,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IAErC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACzB,CAAC"}

package/dist/commands/unused-deps/report.d.ts

@@ -0,0 +1,3 @@
+import { type VibesOptions } from '../../format/vibes.js';
+import type { UnusedDepsReport } from './run.js';
+export declare function renderUnusedDepsReport(report: UnusedDepsReport, options?: VibesOptions): string;

package/dist/commands/unused-deps/report.js

@@ -0,0 +1,32 @@
+import { banner, cleanCelebration } from '../../format/vibes.js';
+import { formatFindingsRows } from '../../format/findings-list.js';
+export function renderUnusedDepsReport(report, options = {}) {
+    if (report.error) {
+        const lines = [];
+        if (!options.quiet && !options.plain)
+            lines.push(banner(), '');
+        lines.push(`Could not run unused-deps: ${report.error}`);
+        return lines.join('\n');
+    }
+    const isClean = report.findings.length === 0;
+    if (options.quiet && isClean)
+        return '';
+    const lines = [];
+    if (!options.quiet && !options.plain)
+        lines.push(banner(), '');
+    lines.push(`Scanned ${report.filesScanned} file${report.filesScanned === 1 ? '' : 's'}.`, '');
+    if (isClean) {
+        lines.push(cleanCelebration(options));
+        return lines.join('\n');
+    }
+    lines.push(`${report.findings.length} problem${report.findings.length === 1 ? '' : 's'} found:`);
+    lines.push(...formatFindingsRows(report.findings.map((f) => ({
+        location: f.kind,
+        name: f.name,
+        tag: f.kind === 'unused'
+            ? `(${f.section}, not imported anywhere)`
+            : `resolves from ${f.resolvedFrom} — not declared in package.json`,
+    })), options));
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/unused-deps/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/commands/unused-deps/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAA;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAGlE,MAAM,UAAU,sBAAsB,CACpC,MAAwB,EACxB,UAAwB,EAAE;IAE1B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9D,KAAK,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;QACxD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9D,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,YAAY,QAAQ,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;IAE7F,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,WAAW,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAChG,KAAK,CAAC,IAAI,CACR,GAAG,kBAAkB,CACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,GAAG,EACD,CAAC,CAAC,IAAI,KAAK,QAAQ;YACjB,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,0BAA0B;YACzC,CAAC,CAAC,iBAAiB,CAAC,CAAC,YAAY,iCAAiC;KACvE,CAAC,CAAC,EACH,OAAO,CACR,CACF,CAAA;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/commands/unused-deps/run.d.ts

@@ -0,0 +1,18 @@
+import { type UnusedDepsFinding } from './core.js';
+export interface UnusedDepsRunOptions {
+    /** package directory to check — both the scan root and where package.json is looked up from, deliberately the same value (see below) */
+    dir: string;
+    extensions?: string[];
+    ignoreGlobs?: string[];
+    respectGitignore?: boolean;
+    strict?: boolean;
+    ignorePackages?: string[];
+}
+export interface UnusedDepsReport {
+    filesScanned: number;
+    findings: UnusedDepsFinding[];
+    /** package.json couldn't be found/read at all — a different kind of problem than any single finding */
+    error: string | null;
+    exitCode: number;
+}
+export declare function runUnusedDeps(options: UnusedDepsRunOptions): UnusedDepsReport;

package/dist/commands/unused-deps/run.js

@@ -0,0 +1,68 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { walk } from '../../utils/walk.js';
+import { findNearestPackageDir } from '../../utils/find-package-dir.js';
+import { detectWorkspace } from '../../utils/workspace.js';
+import { analyzeUnusedDeps } from './core.js';
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+// A single [dir] argument, not the [paths...] + --cwd shape most other
+// commands use — deliberately. unused-deps compares a package.json's
+// declared dependencies against real source usage, so scanning one
+// directory tree while consulting a DIFFERENT one's package.json (e.g.
+// `--cwd` still defaulted to wherever the CLI happened to be invoked
+// from, while `paths` pointed somewhere else entirely) would silently
+// check the wrong dependency list — caught for real while dogfooding
+// against sibling packages from inside devtoolz's own checkout, not by
+// a test: findings named devtoolz's OWN dependencies (`commander`,
+// `diff`, `ignore`) against a completely different package's source.
+// One shared root removes the possibility entirely.
+export function runUnusedDeps(options) {
+    const scanRoot = resolve(options.dir);
+    const packageDir = findNearestPackageDir(scanRoot);
+    if (!packageDir) {
+        return {
+            filesScanned: 0,
+            findings: [],
+            error: `no package.json found at or above ${scanRoot}`,
+            exitCode: 1,
+        };
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(`${packageDir}/package.json`, 'utf8'));
+    }
+    catch (err) {
+        return {
+            filesScanned: 0,
+            findings: [],
+            error: err instanceof Error ? err.message : String(err),
+            exitCode: 1,
+        };
+    }
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const files = walk(['.'], {
+        cwd: scanRoot,
+        extensions,
+        ignoreGlobs: options.ignoreGlobs ?? [],
+        ...(options.respectGitignore !== undefined
+            ? { respectGitignore: options.respectGitignore }
+            : {}),
+    });
+    const workspace = detectWorkspace(scanRoot);
+    const workspacePackageNames = new Set(workspace?.packages.map((p) => p.name) ?? []);
+    const analysis = analyzeUnusedDeps(files, {
+        packageDir,
+        pkg,
+        strict: options.strict ?? false,
+        ignorePackages: new Set(options.ignorePackages ?? []),
+        workspacePackageNames,
+    });
+    const findings = [...analysis.findings].sort((a, b) => a.kind.localeCompare(b.kind) || a.name.localeCompare(b.name));
+    return {
+        filesScanned: analysis.filesAnalyzed,
+        findings,
+        error: null,
+        exitCode: findings.length > 0 ? 1 : 0,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/unused-deps/run.js.map

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

package/dist/index.d.ts

@@ -15,9 +15,26 @@ export type { DeadExportFinding, DeadExportsAnalysis, AnalyzeOptions, } from './
 export { runDeadExports } from './commands/dead-exports/run.js';
 export type { DeadExportsRunOptions, DeadExportsReport } from './commands/dead-exports/run.js';
 export { renderDeadExportsReport } from './commands/dead-exports/report.js';
-export { detectWorkspace } from './commands/dead-exports/workspace.js';
-export type { WorkspaceInfo, WorkspacePackage } from './commands/dead-exports/workspace.js';
-export { resolvePublicEntries, findNearestPackageDir } from './commands/dead-exports/entry.js';
+export { detectWorkspace } from './utils/workspace.js';
+export type { WorkspaceInfo, WorkspacePackage } from './utils/workspace.js';
+export { analyzeCircularImports } from './commands/circular-imports/core.js';
+export type { CircularImportFinding, CircularImportsAnalysis, CircularImportsAnalyzeOptions, } from './commands/circular-imports/core.js';
+export { runCircularImports } from './commands/circular-imports/run.js';
+export type { CircularImportsRunOptions, CircularImportsFileFinding, CircularImportsReport, } from './commands/circular-imports/run.js';
+export { renderCircularImportsReport } from './commands/circular-imports/report.js';
+export { analyzeUnusedDeps } from './commands/unused-deps/core.js';
+export type { UnusedDepsFinding, UnusedDepsAnalysis } from './commands/unused-deps/core.js';
+export type { AnalyzeOptions as UnusedDepsAnalyzeOptions } from './commands/unused-deps/core.js';
+export { runUnusedDeps } from './commands/unused-deps/run.js';
+export type { UnusedDepsRunOptions, UnusedDepsReport } from './commands/unused-deps/run.js';
+export { renderUnusedDepsReport } from './commands/unused-deps/report.js';
+export { packageNameFromSpecifier } from './commands/unused-deps/package-name.js';
+export { resolvePackageDir, declaredBinNames } from './commands/unused-deps/disk-resolve.js';
+export { analyzeFile } from './utils/parse-module.js';
+export type { FileAnalysis, ExportedName, ReexportEntry, ImportedName, } from './utils/parse-module.js';
+export { resolveRelativeSpecifier } from './utils/resolve-specifier.js';
+export { resolvePublicEntries } from './commands/dead-exports/entry.js';
+export { findNearestPackageDir } from './utils/find-package-dir.js';
 export { checkSpecifierCase } from './commands/case-check/resolve-case.js';
 export type { CaseCheckOutcome } from './commands/case-check/resolve-case.js';
 export { checkFile } from './commands/case-check/core.js';
@@ -36,12 +53,41 @@ export { extractCodeBlocks } from './commands/readme-check/extract.js';
 export type { CodeBlock } from './commands/readme-check/extract.js';
 export { typecheckBlock } from './commands/readme-check/typecheck.js';
 export type { BlockDiagnostic } from './commands/readme-check/typecheck.js';
-export { loadCompilerOptions } from './commands/readme-check/tsconfig.js';
-export type { LoadedCompilerOptions, LoadCompilerOptionsResult, } from './commands/readme-check/tsconfig.js';
+export { loadTsconfig } from './utils/load-tsconfig.js';
+export type { LoadedTsconfig, LoadTsconfigResult } from './utils/load-tsconfig.js';
 export { checkMarkdownFile } from './commands/readme-check/core.js';
 export type { ReadmeCheckFinding, ReadmeCheckFileResult } from './commands/readme-check/core.js';
 export { runReadmeCheck } from './commands/readme-check/run.js';
 export type { ReadmeCheckRunOptions, ReadmeCheckReport } from './commands/readme-check/run.js';
 export { renderReadmeCheckReport } from './commands/readme-check/report.js';
+export { analyzeEmptyCatch } from './commands/empty-catch/core.js';
+export type { EmptyCatchFinding } from './commands/empty-catch/core.js';
+export { analyzeEmptyCatchVue } from './commands/empty-catch/vue.js';
+export { runEmptyCatch } from './commands/empty-catch/run.js';
+export type { EmptyCatchRunOptions, EmptyCatchFileFinding, EmptyCatchReport, } from './commands/empty-catch/run.js';
+export { renderEmptyCatchReport } from './commands/empty-catch/report.js';
+export { analyzeTodoReport, buildTagMatcher, DEFAULT_TAGS } from './commands/todo-report/core.js';
+export type { TodoFinding } from './commands/todo-report/core.js';
+export { analyzeTodoReportVue } from './commands/todo-report/vue.js';
+export { runTodoReport } from './commands/todo-report/run.js';
+export type { TodoReportRunOptions, TodoFileFinding, TodoReportReport, } from './commands/todo-report/run.js';
+export { renderTodoReportReport } from './commands/todo-report/report.js';
+export { analyzeScriptsCheck, extractMentionedScripts, isScriptMentioned, isReservedLifecycleScript, } from './commands/scripts-check/core.js';
+export type { ScriptsCheckFinding, ScriptSource } from './commands/scripts-check/core.js';
+export { runScriptsCheck } from './commands/scripts-check/run.js';
+export type { ScriptsCheckRunOptions, ScriptsCheckReport } from './commands/scripts-check/run.js';
+export { renderScriptsCheckReport } from './commands/scripts-check/report.js';
+export { parseTestFile, hasMatchingSource, candidateSourceDirs, } from './commands/orphan-tests/core.js';
+export type { OrphanTestFinding } from './commands/orphan-tests/core.js';
+export { runOrphanTests } from './commands/orphan-tests/run.js';
+export type { OrphanTestsRunOptions, OrphanTestsReport } from './commands/orphan-tests/run.js';
+export { renderOrphanTestsReport } from './commands/orphan-tests/report.js';
+export { findTsIgnoreDirectives, blankDirectives } from './commands/stale-ts-ignore/core.js';
+export type { TsIgnoreDirective } from './commands/stale-ts-ignore/core.js';
+export { extractVueScript, findVueTsIgnoreDirectives, type VueScript, } from './commands/stale-ts-ignore/vue.js';
+export { runProjectTypecheck, checkIsolatedFile } from './commands/stale-ts-ignore/check.js';
+export { runStaleTsIgnore } from './commands/stale-ts-ignore/run.js';
+export type { StaleTsIgnoreRunOptions, StaleTsIgnoreFinding, StaleTsIgnoreReport, } from './commands/stale-ts-ignore/run.js';
+export { renderStaleTsIgnoreReport } from './commands/stale-ts-ignore/report.js';
 export { walk } from './utils/walk.js';
 export type { WalkOptions } from './utils/walk.js';