@macrulez/devtoolz 0.1.0

package/dist/commands/dead-exports/parse.d.ts

@@ -0,0 +1,30 @@
+export interface ExportedName {
+    name: string;
+    isType: boolean;
+    isDefault: boolean;
+    line: number;
+}
+export interface ReexportEntry {
+    /** the raw specifier, e.g. './core.js' */
+    from: string;
+    /** the name as exported by the SOURCE module, or '*' for `export * from`/`export * as x from` */
+    imported: string;
+    /** the name this file re-exports it as (may differ via `as`); '*' mirrors `imported` */
+    exportedAs: string;
+    isType: boolean;
+}
+export interface ImportedName {
+    /** the raw specifier */
+    from: string;
+    /** the name as exported by the source module, 'default', or '*' for a namespace import */
+    imported: string;
+    isType: boolean;
+}
+export interface FileAnalysis {
+    exports: ExportedName[];
+    reexports: ReexportEntry[];
+    imports: ImportedName[];
+    /** a dynamic import() whose argument isn't a string literal — can't be resolved, worth flagging */
+    hasUnresolvableDynamicImport: boolean;
+}
+export declare function analyzeFile(text: string, file: string): FileAnalysis;

package/dist/commands/dead-exports/parse.js

@@ -0,0 +1,174 @@
+// Per-file extraction of exports/imports via a real TS parse — no regex
+// guessing at `export`/`import` keywords, so a string/comment containing
+// those words is never mistaken for the real thing.
+import ts from 'typescript';
+function scriptKindFor(file) {
+    return file.endsWith('.tsx')
+        ? ts.ScriptKind.TSX
+        : file.endsWith('.jsx')
+            ? ts.ScriptKind.JSX
+            : ts.ScriptKind.TS;
+}
+function hasExportModifier(node) {
+    return (ts.canHaveModifiers(node) &&
+        (ts.getModifiers(node)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false));
+}
+function hasDefaultModifier(node) {
+    return (ts.canHaveModifiers(node) &&
+        (ts.getModifiers(node)?.some((m) => m.kind === ts.SyntaxKind.DefaultKeyword) ?? false));
+}
+// Not `ts.isImportCall` — that helper exists at runtime but isn't part of
+// this TypeScript version's typed public API. A dynamic `import(...)`
+// parses as a CallExpression whose callee is the `import` keyword itself
+// used as an expression; checking that structurally is exactly what the
+// untyped helper does internally.
+function isDynamicImportCall(node) {
+    return ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword;
+}
+function collectBindingNames(name, out) {
+    // Only plain identifiers are attributed — `export const { a, b } = obj`
+    // (destructured) is a rare enough pattern for a top-level export that
+    // skipping it (rather than guessing) is the safer default.
+    if (ts.isIdentifier(name))
+        out.push(name.text);
+}
+export function analyzeFile(text, file) {
+    const sf = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, scriptKindFor(file));
+    function lineOf(node) {
+        return sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+    }
+    const exports = [];
+    const reexports = [];
+    const imports = [];
+    let hasUnresolvableDynamicImport = false;
+    for (const stmt of sf.statements) {
+        if (ts.isExportDeclaration(stmt)) {
+            const isTypeOnly = stmt.isTypeOnly;
+            const moduleSpecifier = stmt.moduleSpecifier && ts.isStringLiteral(stmt.moduleSpecifier)
+                ? stmt.moduleSpecifier.text
+                : null;
+            if (stmt.exportClause) {
+                if (ts.isNamedExports(stmt.exportClause)) {
+                    for (const el of stmt.exportClause.elements) {
+                        const importedName = (el.propertyName ?? el.name).text;
+                        const exportedAs = el.name.text;
+                        const elIsType = isTypeOnly || el.isTypeOnly;
+                        if (moduleSpecifier) {
+                            reexports.push({
+                                from: moduleSpecifier,
+                                imported: importedName,
+                                exportedAs,
+                                isType: elIsType,
+                            });
+                        }
+                        else {
+                            exports.push({
+                                name: exportedAs,
+                                isType: elIsType,
+                                isDefault: false,
+                                line: lineOf(el),
+                            });
+                        }
+                    }
+                }
+                else if (ts.isNamespaceExport(stmt.exportClause) && moduleSpecifier) {
+                    // `export * as ns from './y'` — ns itself is a real named export
+                    // of THIS file (a namespace object), not traced further.
+                    exports.push({
+                        name: stmt.exportClause.name.text,
+                        isType: isTypeOnly,
+                        isDefault: false,
+                        line: lineOf(stmt.exportClause),
+                    });
+                }
+            }
+            else if (moduleSpecifier) {
+                // `export * from './y'` — every name './y' exports becomes
+                // reachable through this file too; resolved in core.ts once every
+                // file's own export list is known.
+                reexports.push({
+                    from: moduleSpecifier,
+                    imported: '*',
+                    exportedAs: '*',
+                    isType: isTypeOnly,
+                });
+            }
+            continue;
+        }
+        if (ts.isExportAssignment(stmt)) {
+            // `export default expr` and legacy `export = expr` both surface as
+            // this file's default-like export — see FileAnalysis' isDefault
+            // doc: usage detection for it is intentionally loose.
+            exports.push({ name: 'default', isType: false, isDefault: true, line: lineOf(stmt) });
+            continue;
+        }
+        if (ts.isImportDeclaration(stmt) && ts.isStringLiteral(stmt.moduleSpecifier)) {
+            const from = stmt.moduleSpecifier.text;
+            const clause = stmt.importClause;
+            if (!clause)
+                continue; // bare `import './x'` — side-effect only, not a usage of any named export
+            if (clause.name)
+                imports.push({ from, imported: 'default', isType: clause.isTypeOnly });
+            if (clause.namedBindings) {
+                if (ts.isNamespaceImport(clause.namedBindings)) {
+                    imports.push({ from, imported: '*', isType: clause.isTypeOnly });
+                }
+                else if (ts.isNamedImports(clause.namedBindings)) {
+                    for (const el of clause.namedBindings.elements) {
+                        const importedName = (el.propertyName ?? el.name).text;
+                        imports.push({
+                            from,
+                            imported: importedName,
+                            isType: clause.isTypeOnly || el.isTypeOnly,
+                        });
+                    }
+                }
+            }
+            continue;
+        }
+        if (hasExportModifier(stmt)) {
+            const isType = ts.isTypeAliasDeclaration(stmt) || ts.isInterfaceDeclaration(stmt);
+            const isDefault = hasDefaultModifier(stmt);
+            if (ts.isVariableStatement(stmt)) {
+                for (const decl of stmt.declarationList.declarations) {
+                    const names = [];
+                    collectBindingNames(decl.name, names);
+                    for (const name of names) {
+                        exports.push({ name, isType: false, isDefault: false, line: lineOf(decl) });
+                    }
+                }
+            }
+            else if ((ts.isFunctionDeclaration(stmt) ||
+                ts.isClassDeclaration(stmt) ||
+                ts.isInterfaceDeclaration(stmt) ||
+                ts.isTypeAliasDeclaration(stmt) ||
+                ts.isEnumDeclaration(stmt) ||
+                ts.isModuleDeclaration(stmt)) &&
+                stmt.name) {
+                const name = ts.isIdentifier(stmt.name) ? stmt.name.text : stmt.name.text;
+                exports.push({ name: isDefault ? 'default' : name, isType, isDefault, line: lineOf(stmt) });
+            }
+        }
+    }
+    // Dynamic import() calls can appear anywhere in an expression, not just
+    // at the top level — a full walk (not just top-level statements) is
+    // needed to find them all.
+    function visit(node) {
+        if (isDynamicImportCall(node)) {
+            const arg = node.arguments[0];
+            if (arg && ts.isStringLiteral(arg)) {
+                // A literal path we can resolve — conservatively treat the whole
+                // target module as used (see core.ts) rather than trying to trace
+                // which bindings a `const { x } = await import(...)` destructures.
+                imports.push({ from: arg.text, imported: '*', isType: false });
+            }
+            else {
+                hasUnresolvableDynamicImport = true;
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return { exports, reexports, imports, hasUnresolvableDynamicImport };
+}
+//# sourceMappingURL=parse.js.map

package/dist/commands/dead-exports/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/commands/dead-exports/parse.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,yEAAyE;AACzE,oDAAoD;AAEpD,OAAO,EAAE,MAAM,YAAY,CAAA;AAmC3B,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC1B,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG;QACnB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG;YACnB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAA;AACxB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,OAAO,CACL,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACzB,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,CACtF,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa;IACvC,OAAO,CACL,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACzB,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,CACvF,CAAA;AACH,CAAC;AAED,0EAA0E;AAC1E,sEAAsE;AACtE,yEAAyE;AACzE,wEAAwE;AACxE,kCAAkC;AAClC,SAAS,mBAAmB,CAAC,IAAa;IACxC,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAA;AAC1F,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAoB,EAAE,GAAa;IAC9D,wEAAwE;IACxE,sEAAsE;IACtE,2DAA2D;IAC3D,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IAE7F,SAAS,MAAM,CAAC,IAAa;QAC3B,OAAO,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,MAAM,SAAS,GAAoB,EAAE,CAAA;IACrC,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,IAAI,4BAA4B,GAAG,KAAK,CAAA;IAExC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;YAClC,MAAM,eAAe,GACnB,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC;gBAC9D,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI;gBAC3B,CAAC,CAAC,IAAI,CAAA;YAEV,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;oBACzC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;wBAC5C,MAAM,YAAY,GAAG,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;wBACtD,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAA;wBAC/B,MAAM,QAAQ,GAAG,UAAU,IAAI,EAAE,CAAC,UAAU,CAAA;wBAC5C,IAAI,eAAe,EAAE,CAAC;4BACpB,SAAS,CAAC,IAAI,CAAC;gCACb,IAAI,EAAE,eAAe;gCACrB,QAAQ,EAAE,YAAY;gCACtB,UAAU;gCACV,MAAM,EAAE,QAAQ;6BACjB,CAAC,CAAA;wBACJ,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC,IAAI,CAAC;gCACX,IAAI,EAAE,UAAU;gCAChB,MAAM,EAAE,QAAQ;gCAChB,SAAS,EAAE,KAAK;gCAChB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;6BACjB,CAAC,CAAA;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,eAAe,EAAE,CAAC;oBACtE,iEAAiE;oBACjE,yDAAyD;oBACzD,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI;wBACjC,MAAM,EAAE,UAAU;wBAClB,SAAS,EAAE,KAAK;wBAChB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;qBAChC,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,eAAe,EAAE,CAAC;gBAC3B,2DAA2D;gBAC3D,kEAAkE;gBAClE,mCAAmC;gBACnC,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,eAAe;oBACrB,QAAQ,EAAE,GAAG;oBACb,UAAU,EAAE,GAAG;oBACf,MAAM,EAAE,UAAU;iBACnB,CAAC,CAAA;YACJ,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,mEAAmE;YACnE,gEAAgE;YAChE,sDAAsD;YACtD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACrF,SAAQ;QACV,CAAC;QAED,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAA;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAA;YAChC,IAAI,CAAC,MAAM;gBAAE,SAAQ,CAAC,0EAA0E;YAEhG,IAAI,MAAM,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;YAEvF,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC/C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;gBAClE,CAAC;qBAAM,IAAI,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;oBACnD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;wBAC/C,MAAM,YAAY,GAAG,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;wBACtD,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI;4BACJ,QAAQ,EAAE,YAAY;4BACtB,MAAM,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU;yBAC3C,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAA;YACjF,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAE1C,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;oBACrD,MAAM,KAAK,GAAa,EAAE,CAAA;oBAC1B,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;oBACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;oBAC7E,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IACL,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;gBAC7B,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC;gBAC3B,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC;gBAC/B,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC;gBAC/B,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBAC1B,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC/B,IAAI,CAAC,IAAI,EACT,CAAC;gBACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;gBACzE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,oEAAoE;IACpE,2BAA2B;IAC3B,SAAS,KAAK,CAAC,IAAa;QAC1B,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC7B,IAAI,GAAG,IAAI,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,iEAAiE;gBACjE,kEAAkE;gBAClE,mEAAmE;gBACnE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;YAChE,CAAC;iBAAM,CAAC;gBACN,4BAA4B,GAAG,IAAI,CAAA;YACrC,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC9B,CAAC;IACD,KAAK,CAAC,EAAE,CAAC,CAAA;IAET,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAA;AACtE,CAAC"}

package/dist/commands/dead-exports/report.d.ts

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

package/dist/commands/dead-exports/report.js

@@ -0,0 +1,27 @@
+import { banner, cleanCelebration } from '../../format/vibes.js';
+import { formatFindingsRows } from '../../format/findings-list.js';
+export function renderDeadExportsReport(report, options = {}) {
+    const isClean = report.findings.length === 0;
+    if (options.quiet && isClean && !report.hasUnresolvableDynamicImports)
+        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));
+    }
+    else {
+        lines.push(`${report.findings.length} dead export${report.findings.length === 1 ? '' : 's'} found:`);
+        lines.push(...formatFindingsRows(report.findings.map((f) => ({
+            location: `${f.file}:${f.line}`,
+            name: f.name,
+            tag: f.isDefault ? '(default)' : f.isType ? '(type)' : '',
+        })), options));
+    }
+    if (report.hasUnresolvableDynamicImports) {
+        lines.push('', "Note: found a dynamic import() whose path isn't a plain string literal — it could not be resolved, so results here may include false positives.");
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/dead-exports/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/commands/dead-exports/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,uBAAuB,CACrC,MAAyB,EACzB,UAAwB,EAAE;IAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,6BAA6B;QAAE,OAAO,EAAE,CAAA;IAEhF,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;IACvC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CACzF,CAAA;QACD,KAAK,CAAC,IAAI,CACR,GAAG,kBAAkB,CACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE;YAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;SAC1D,CAAC,CAAC,EACH,OAAO,CACR,CACF,CAAA;IACH,CAAC;IAED,IAAI,MAAM,CAAC,6BAA6B,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,iJAAiJ,CAClJ,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/commands/dead-exports/resolve.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolves a relative import specifier (`./foo`, `../bar/baz`) against
+ * the file that contains it to a real, existing file on disk — or `null`
+ * if nothing matches any of the conventions this project's commands rely
+ * on elsewhere (extensionless imports, NodeNext `.js`-means-`.ts`,
+ * directory-with-index). Only ever called with specifiers that already
+ * look relative (`.`/`..`-prefixed) — bare package specifiers go through
+ * workspace.ts instead.
+ */
+export declare function resolveRelativeSpecifier(fromFile: string, specifier: string): string | null;

package/dist/commands/dead-exports/resolve.js

@@ -0,0 +1,58 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+const CANDIDATE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+// A NodeNext-style project writes `import { x } from './core.js'` in a
+// .ts file even though the real file on disk is `./core.ts` — the
+// specifier names the file's post-build extension, not its source one
+// (devtoolz's own codebase does exactly this — see src/cli.ts). When the
+// literal specifier doesn't resolve, each of these swaps is tried too.
+const NODENEXT_SWAPS = {
+    '.js': ['.ts', '.tsx'],
+    '.mjs': ['.mts'],
+    '.cjs': ['.cts'],
+};
+function tryFile(path) {
+    return existsSync(path) ? path : null;
+}
+/**
+ * Resolves a relative import specifier (`./foo`, `../bar/baz`) against
+ * the file that contains it to a real, existing file on disk — or `null`
+ * if nothing matches any of the conventions this project's commands rely
+ * on elsewhere (extensionless imports, NodeNext `.js`-means-`.ts`,
+ * directory-with-index). Only ever called with specifiers that already
+ * look relative (`.`/`..`-prefixed) — bare package specifiers go through
+ * workspace.ts instead.
+ */
+export function resolveRelativeSpecifier(fromFile, specifier) {
+    const base = resolve(dirname(fromFile), specifier);
+    const direct = tryFile(base);
+    if (direct)
+        return direct;
+    const lastDot = base.lastIndexOf('.');
+    const lastSlash = Math.max(base.lastIndexOf('/'), base.lastIndexOf('\\'));
+    const hasExt = lastDot > lastSlash;
+    if (hasExt) {
+        const ext = base.slice(lastDot);
+        const withoutExt = base.slice(0, lastDot);
+        for (const swap of NODENEXT_SWAPS[ext] ?? []) {
+            const swapped = tryFile(withoutExt + swap);
+            if (swapped)
+                return swapped;
+        }
+        // Had an extension that didn't match anything above — don't also
+        // try appending a second extension or treating it as a directory.
+        return null;
+    }
+    for (const ext of CANDIDATE_EXTENSIONS) {
+        const withExt = tryFile(base + ext);
+        if (withExt)
+            return withExt;
+    }
+    for (const ext of CANDIDATE_EXTENSIONS) {
+        const withIndex = tryFile(join(base, `index${ext}`));
+        if (withIndex)
+            return withIndex;
+    }
+    return null;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/commands/dead-exports/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/commands/dead-exports/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE3E,uEAAuE;AACvE,kEAAkE;AAClE,sEAAsE;AACtE,yEAAyE;AACzE,uEAAuE;AACvE,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,MAAM,CAAC;CACjB,CAAA;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,SAAiB;IAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;IAElD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IACzE,MAAM,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAClC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QACzC,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;YAC1C,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAA;QAC7B,CAAC;QACD,iEAAiE;QACjE,kEAAkE;QAClE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;QACnC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAA;IAC7B,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAA;QACpD,IAAI,SAAS;YAAE,OAAO,SAAS,CAAA;IACjC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/commands/dead-exports/run.d.ts

@@ -0,0 +1,21 @@
+import { type DeadExportFinding } from './core.js';
+export interface DeadExportsRunOptions {
+    paths: string[];
+    cwd: string;
+    extensions?: string[];
+    ignoreGlobs?: string[];
+    respectGitignore?: boolean;
+    /** extra public-entry files, on top of the auto-detected ones (--entry) */
+    entry?: string[];
+    /** also flag exports from public entry points. default false */
+    strict?: boolean;
+    /** auto-detect a pnpm/npm/yarn workspace for cross-package resolution. default true */
+    workspace?: boolean;
+}
+export interface DeadExportsReport {
+    filesScanned: number;
+    findings: DeadExportFinding[];
+    hasUnresolvableDynamicImports: boolean;
+    exitCode: number;
+}
+export declare function runDeadExports(options: DeadExportsRunOptions): DeadExportsReport;

package/dist/commands/dead-exports/run.js

@@ -0,0 +1,51 @@
+import { relative } from 'node:path';
+import { walk } from '../../utils/walk.js';
+import { analyzeDeadExports } from './core.js';
+import { findNearestPackageDir, resolvePublicEntries } from './entry.js';
+import { detectWorkspace } from './workspace.js';
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+// Build-tool config files (tsup.config.ts, vitest.config.ts, ...) are
+// loaded by that tool's own CLI via filename convention, never through a
+// same-repo `import` — no static analysis can see that consumer, so their
+// default export always looks unused. Confirmed against a real project
+// (inview's own packages/*/tsup.config.ts) rather than assumed. Excluded
+// from the scan entirely, same as `--ignore` would, rather than special-
+// cased per-finding — a config file has essentially nothing else in it
+// worth dead-code-checking anyway.
+const DEFAULT_CONFIG_IGNORES = ['*.config.ts', '*.config.js', '*.config.mjs', '*.config.cjs'];
+export function runDeadExports(options) {
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const files = walk(options.paths, {
+        cwd: options.cwd,
+        extensions,
+        ignoreGlobs: [...DEFAULT_CONFIG_IGNORES, ...(options.ignoreGlobs ?? [])],
+        ...(options.respectGitignore !== undefined
+            ? { respectGitignore: options.respectGitignore }
+            : {}),
+    });
+    const packageDir = findNearestPackageDir(options.cwd) ?? options.cwd;
+    const publicEntries = new Set(resolvePublicEntries(packageDir, options.entry ?? []));
+    const workspace = options.workspace !== false ? detectWorkspace(options.cwd) : null;
+    if (workspace) {
+        for (const pkg of workspace.packages) {
+            for (const entry of resolvePublicEntries(pkg.rootDir))
+                publicEntries.add(entry);
+        }
+    }
+    const analysis = analyzeDeadExports(files, {
+        publicEntries,
+        strict: options.strict ?? false,
+        workspace,
+    });
+    const findings = analysis.findings
+        .map((f) => ({ ...f, file: relative(options.cwd, f.file).split('\\').join('/') }))
+        .sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+    const exitCode = findings.length > 0 ? 1 : 0;
+    return {
+        filesScanned: analysis.filesAnalyzed,
+        findings,
+        hasUnresolvableDynamicImports: analysis.hasUnresolvableDynamicImports,
+        exitCode,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/dead-exports/run.js.map

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

package/dist/commands/dead-exports/workspace.d.ts

@@ -0,0 +1,14 @@
+export interface WorkspacePackage {
+    name: string;
+    rootDir: string;
+    packageJson: Record<string, unknown>;
+}
+export interface WorkspaceInfo {
+    root: string;
+    packages: WorkspacePackage[];
+}
+/**
+ * Walks up from `startDir` looking for a pnpm/npm/yarn workspace root.
+ * Returns `null` if none is found — a plain single-package project.
+ */
+export declare function detectWorkspace(startDir: string): WorkspaceInfo | null;

package/dist/commands/dead-exports/workspace.js

@@ -0,0 +1,99 @@
+// Detects a pnpm/npm/yarn workspace so a sibling package's import of
+// another package's export (e.g. `@macrulez/inview-vue` importing from
+// `@macrulez/inview-core`, as it really does) doesn't read as a false
+// "dead export" just because the reference lives in a different package
+// directory than the one being checked — the exact case features.md's
+// contract calls out.
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+function readPackageJson(dir) {
+    try {
+        return JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// Only the one shape pnpm-workspace.yaml realistically uses in practice —
+// a top-level `packages:` key followed by `- 'glob'` list items. Not a
+// general YAML parser; anything fancier (anchors, nested maps) isn't
+// recognized and the file is treated as if it weren't there.
+function parsePnpmWorkspaceYaml(text) {
+    const lines = text.split('\n');
+    const globs = [];
+    let inPackages = false;
+    for (const line of lines) {
+        if (/^packages:\s*$/.test(line)) {
+            inPackages = true;
+            continue;
+        }
+        if (inPackages) {
+            const item = line.match(/^\s*-\s*['"]?([^'"#]+)['"]?\s*(#.*)?$/);
+            if (item) {
+                globs.push(item[1].trim());
+                continue;
+            }
+            if (/^\S/.test(line))
+                break; // dedented past the packages: block
+        }
+    }
+    return globs;
+}
+function expandGlob(root, glob) {
+    // Only "dir/*" (one trailing wildcard segment) is supported — the
+    // overwhelming common case for a workspace's packages list. A glob
+    // without a wildcard is just a literal directory.
+    if (!glob.includes('*')) {
+        const dir = resolve(root, glob);
+        return existsSync(dir) && statSync(dir).isDirectory() ? [dir] : [];
+    }
+    const starIndex = glob.indexOf('*');
+    const prefix = glob.slice(0, starIndex).replace(/\/$/, '');
+    const parentDir = resolve(root, prefix);
+    if (!existsSync(parentDir))
+        return [];
+    return readdirSync(parentDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => join(parentDir, e.name));
+}
+function packagesFromGlobs(root, globs) {
+    const packages = [];
+    for (const glob of globs) {
+        for (const dir of expandGlob(root, glob)) {
+            const pkgJson = readPackageJson(dir);
+            const name = pkgJson && typeof pkgJson.name === 'string' ? pkgJson.name : null;
+            if (pkgJson && name)
+                packages.push({ name, rootDir: dir, packageJson: pkgJson });
+        }
+    }
+    return packages;
+}
+/**
+ * Walks up from `startDir` looking for a pnpm/npm/yarn workspace root.
+ * Returns `null` if none is found — a plain single-package project.
+ */
+export function detectWorkspace(startDir) {
+    let dir = resolve(startDir);
+    for (;;) {
+        const pnpmWorkspacePath = join(dir, 'pnpm-workspace.yaml');
+        if (existsSync(pnpmWorkspacePath)) {
+            const globs = parsePnpmWorkspaceYaml(readFileSync(pnpmWorkspacePath, 'utf8'));
+            return { root: dir, packages: packagesFromGlobs(dir, globs) };
+        }
+        const pkgJson = readPackageJson(dir);
+        if (pkgJson?.workspaces) {
+            const raw = pkgJson.workspaces;
+            const globs = Array.isArray(raw)
+                ? raw.filter((g) => typeof g === 'string')
+                : Array.isArray(raw?.packages)
+                    ? raw.packages.filter((g) => typeof g === 'string')
+                    : [];
+            return { root: dir, packages: packagesFromGlobs(dir, globs) };
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/commands/dead-exports/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/commands/dead-exports/workspace.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,uEAAuE;AACvE,sEAAsE;AACtE,wEAAwE;AACxE,sEAAsE;AACtE,sBAAsB;AAEtB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAalD,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAA;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,uEAAuE;AACvE,qEAAqE;AACrE,6DAA6D;AAC7D,SAAS,sBAAsB,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,UAAU,GAAG,IAAI,CAAA;YACjB,SAAQ;QACV,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAA;YAChE,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,IAAI,CAAE,IAAI,CAAC,CAAC,CAAY,CAAC,IAAI,EAAE,CAAC,CAAA;gBACtC,SAAQ;YACV,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAK,CAAC,oCAAoC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAY;IAC5C,kEAAkE;IAClE,mEAAmE;IACnE,kDAAkD;IAClD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC/B,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACpE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACvC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAA;IACrC,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACnD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,KAAe;IACtD,MAAM,QAAQ,GAAuB,EAAE,CAAA;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;YACpC,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;YAC9E,IAAI,OAAO,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3B,SAAS,CAAC;QACR,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAA;QAC1D,IAAI,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,sBAAsB,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAA;YAC7E,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAA;QAC/D,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAA;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC9B,CAAC,CAAE,GAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;gBACtE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAE,GAAgC,EAAE,QAAQ,CAAC;oBAC1D,CAAC,CAAG,GAA+B,CAAC,QAAQ,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAC7B;oBAChB,CAAC,CAAC,EAAE,CAAA;YACR,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAA;QAC/D,CAAC;QAED,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"}

package/dist/commands/exports-doctor/core.d.ts

@@ -0,0 +1,13 @@
+export type FindingKind = 'missing' | 'case-mismatch' | 'missing-shebang' | 'types-missing';
+export interface ExportsDoctorFinding {
+    location: string;
+    path: string;
+    kind: FindingKind;
+    /** the real on-disk case, only for kind: 'case-mismatch' */
+    realPath?: string;
+}
+export interface ExportsDoctorResult {
+    packageName: string | null;
+    findings: ExportsDoctorFinding[];
+}
+export declare function checkPackage(pkg: Record<string, unknown>, packageDir: string): ExportsDoctorResult;

package/dist/commands/exports-doctor/core.js

@@ -0,0 +1,85 @@
+import { readFileSync } from 'node:fs';
+import { collectDeclaredPaths, isBinLocation, isTypesLocation } from './parse.js';
+import { checkDeclaredPath, resolveDeclaredPath } from './resolve-path.js';
+function hasShebang(absolutePath) {
+    try {
+        const fd = readFileSync(absolutePath, { encoding: 'utf8' });
+        return fd.startsWith('#!');
+    }
+    catch {
+        return false; // unreadable — already reported as missing/case-mismatch by the caller, not a second finding
+    }
+}
+export function checkPackage(pkg, packageDir) {
+    const declared = collectDeclaredPaths(pkg);
+    const findings = [];
+    // Grouped by exports subpath key (the part inside `exports["..."]`), so
+    // the types-vs-runtime pairing check below only compares conditions
+    // that actually belong together, not e.g. `exports["."].types` against
+    // `exports["./cdn"].import`.
+    const okByExportsKey = new Map();
+    for (const entry of declared) {
+        const result = checkDeclaredPath(packageDir, entry.path);
+        if (result.status === 'missing') {
+            findings.push({ location: entry.location, path: entry.path, kind: 'missing' });
+            continue;
+        }
+        if (result.status === 'case-mismatch') {
+            findings.push({
+                location: entry.location,
+                path: entry.path,
+                kind: 'case-mismatch',
+                realPath: result.realPath,
+            });
+            continue;
+        }
+        // status: 'ok' from here on
+        const exportsKeyMatch = entry.location.match(/^exports\["([^"]+)"\]/);
+        if (exportsKeyMatch) {
+            const key = exportsKeyMatch[1];
+            const conditions = okByExportsKey.get(key) ?? new Set();
+            conditions.add(entry.location);
+            okByExportsKey.set(key, conditions);
+        }
+        if (isBinLocation(entry.location)) {
+            const absolute = resolveDeclaredPath(packageDir, entry.path);
+            if (!hasShebang(absolute)) {
+                findings.push({ location: entry.location, path: entry.path, kind: 'missing-shebang' });
+            }
+        }
+    }
+    // types-vs-runtime pairing: a `types` condition that's missing is
+    // already reported above via kind: 'missing' — this second pass instead
+    // looks for the OTHER direction, the one that's actually dangerous:
+    // every non-types condition under a subpath resolved fine (the package
+    // works at runtime), but `types` for that SAME subpath is nowhere in
+    // the declared paths at all (not just missing-on-disk — never even
+    // written), so TypeScript consumers get no types with no warning
+    // anywhere in a normal build.
+    const flaggedKeys = new Set();
+    for (const entry of declared) {
+        // Only entries declared inside a real conditions object are eligible —
+        // a bare string/array subpath value has no siblings at all, and
+        // TypeScript falls back to a colocated `.d.ts` file for those, so
+        // flagging them here would be a false positive.
+        if (!entry.isConditionEntry || isTypesLocation(entry.location))
+            continue;
+        const exportsKeyMatch = entry.location.match(/^exports\["([^"]+)"\]/);
+        if (!exportsKeyMatch)
+            continue;
+        const key = exportsKeyMatch[1];
+        if (flaggedKeys.has(key))
+            continue; // one finding per subpath, not one per condition under it
+        const hasAnyTypesDeclared = declared.some((d) => d.location.startsWith(`exports["${key}"]`) && isTypesLocation(d.location));
+        const runtimeResolvedOk = okByExportsKey.get(key)?.has(entry.location);
+        if (!hasAnyTypesDeclared && runtimeResolvedOk) {
+            findings.push({ location: `exports["${key}"]`, path: entry.path, kind: 'types-missing' });
+            flaggedKeys.add(key);
+        }
+    }
+    return {
+        packageName: typeof pkg.name === 'string' ? pkg.name : null,
+        findings,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/commands/exports-doctor/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/commands/exports-doctor/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAiB1E,SAAS,UAAU,CAAC,YAAoB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3D,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA,CAAC,6FAA6F;IAC5G,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,GAA4B,EAC5B,UAAkB;IAElB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAA2B,EAAE,CAAA;IAE3C,wEAAwE;IACxE,oEAAoE;IACpE,uEAAuE;IACvE,6BAA6B;IAC7B,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAA;IAErD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAExD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;YAC9E,SAAQ;QACV,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QAED,4BAA4B;QAC5B,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACrE,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,eAAe,CAAC,CAAC,CAAW,CAAA;YACxC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAU,CAAA;YAC/D,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC9B,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACrC,CAAC;QAED,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC5D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAA;YACxF,CAAC;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,wEAAwE;IACxE,oEAAoE;IACpE,uEAAuE;IACvE,qEAAqE;IACrE,mEAAmE;IACnE,iEAAiE;IACjE,8BAA8B;IAC9B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,uEAAuE;QACvE,gEAAgE;QAChE,kEAAkE;QAClE,gDAAgD;QAChD,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,SAAQ;QACxE,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACrE,IAAI,CAAC,eAAe;YAAE,SAAQ;QAC9B,MAAM,GAAG,GAAG,eAAe,CAAC,CAAC,CAAW,CAAA;QACxC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ,CAAC,0DAA0D;QAC7F,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CACjF,CAAA;QACD,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtE,IAAI,CAAC,mBAAmB,IAAI,iBAAiB,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAA;YACzF,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC3D,QAAQ;KACT,CAAA;AACH,CAAC"}