@dep-radius/core 0.1.0

package/dist/usage/opaque.js

@@ -0,0 +1,193 @@
+import { join, posix } from "node:path";
+import { readFile } from "node:fs/promises";
+import ts from "typescript";
+import { STYLE_EXT } from "./files.js";
+import { packageNameOf } from "../inventory/specifiers.js";
+// Packages consumed mostly through file conventions: their import surface says little about how
+// much of the project depends on them.
+export const CONVENTION_FRAMEWORKS = new Set([
+    "next",
+    "nuxt",
+    "astro",
+    "gatsby",
+    "@remix-run/dev",
+    "@react-router/dev",
+    "@sveltejs/kit",
+    "@docusaurus/core",
+    "vitepress",
+    "expo-router",
+    "react-scripts",
+    "@angular/core",
+    "@nestjs/core",
+]);
+const CONFIG_FILE = /(^|\/)([^/]*\.config\.[cm]?[jt]s|\.[a-z-]*rc(\.[cm]?[jt]s|\.json|\.ya?ml)?|[a-z-]*rc\.[cm]?js|tsconfig[^/]*\.json|jsconfig\.json|components\.json|turbo\.json|vercel\.json|biome\.jsonc?|renovate\.json5?|\.babelrc|babel\.config\.json|deno\.jsonc?)$/i;
+export async function findOpaque(root, files, facts, inventory, resolver) {
+    const hits = new Map();
+    const add = (id, kind, s) => {
+        let m = hits.get(id);
+        if (!m) {
+            m = new Map();
+            hits.set(id, m);
+        }
+        const list = m.get(kind) ?? [];
+        list.push(s);
+        m.set(kind, list);
+    };
+    const byName = new Map();
+    for (const d of inventory.installed) {
+        for (const n of new Set([d.name, ...d.declaredBy.map((x) => x.key)])) {
+            const l = byName.get(n) ?? [];
+            if (!l.includes(d))
+                l.push(d);
+            byName.set(n, l);
+        }
+    }
+    const depsFor = (value) => {
+        const name = packageNameOf(value);
+        if (!name)
+            return [];
+        if (value !== name && !value.startsWith(`${name}/`))
+            return [];
+        return byName.get(name) ?? [];
+    };
+    // string references in JS or TS config files: plugins: ["prettier-plugin-tailwindcss"]
+    for (const [rel, f] of facts) {
+        if (!CONFIG_FILE.test(rel))
+            continue;
+        for (const s of f.stringLiterals) {
+            for (const d of depsFor(s.value))
+                add(d.id, "config-reference", site(rel, s.pos.line, s.pos.text));
+        }
+    }
+    // JSON configs, and the non-dependency fields of manifests ("prettier": "@acme/prettier-config")
+    for (const rel of files) {
+        const isManifest = rel === "package.json" || rel.endsWith("/package.json");
+        const isJsonConfig = /\.(json|jsonc|json5)$/i.test(rel) && CONFIG_FILE.test(rel);
+        const isRc = /(^|\/)\.[a-z-]*rc$/i.test(rel);
+        if (!isManifest && !isJsonConfig && !isRc)
+            continue;
+        let text;
+        try {
+            text = await readFile(join(root, rel), "utf8");
+        }
+        catch {
+            continue;
+        }
+        const parsed = ts.parseConfigFileTextToJson(rel, text);
+        const json = parsed.config;
+        if (json === undefined)
+            continue;
+        const strings = [];
+        collectStrings(json, strings, isManifest);
+        for (const value of strings) {
+            for (const d of depsFor(value))
+                add(d.id, "config-reference", site(rel, lineOfString(text, value), value));
+        }
+    }
+    // binaries run from scripts: "lint": "eslint . --max-warnings 0"
+    const binOwners = new Map();
+    for (const d of inventory.installed) {
+        for (const bin of await binNames(d)) {
+            const l = binOwners.get(bin) ?? [];
+            l.push(d);
+            binOwners.set(bin, l);
+        }
+    }
+    for (const m of inventory.manifests) {
+        const mRel = posix.relative(root.split("\\").join("/"), m.path.split("\\").join("/"));
+        for (const [name, script] of Object.entries(m.scripts)) {
+            for (const token of script.split(/[\s;&|()]+/)) {
+                const owners = binOwners.get(token);
+                if (!owners)
+                    continue;
+                for (const d of owners) {
+                    if (d.declaredBy.length === 0)
+                        continue;
+                    add(d.id, "script-bin", site(mRel, 1, `${name}: ${script}`.slice(0, 160)));
+                }
+            }
+        }
+    }
+    // stylesheets: @import "tailwindcss"; @plugin "@tailwindcss/typography"
+    for (const rel of files) {
+        if (!STYLE_EXT.test(rel))
+            continue;
+        let text;
+        try {
+            text = await readFile(join(root, rel), "utf8");
+        }
+        catch {
+            continue;
+        }
+        const re = /@(import|plugin|config|source|use|forward|reference)\s+(?:url\()?\s*["']([^"']+)["']/g;
+        for (let m = re.exec(text); m; m = re.exec(text)) {
+            const spec = (m[2] ?? "").replace(/^~/, "");
+            if (!packageNameOf(spec))
+                continue;
+            const t = await resolver.resolve(rel, spec);
+            const line = text.slice(0, m.index).split("\n").length;
+            if (t.kind === "pkg")
+                add(t.installedId, "css-import", site(rel, line, m[0]));
+        }
+    }
+    for (const d of inventory.installed) {
+        if (CONVENTION_FRAMEWORKS.has(d.name))
+            add(d.id, "convention-framework", site(d.declaredBy[0]?.manifest ?? "package.json", 1, d.name));
+    }
+    return hits;
+}
+async function binNames(d) {
+    if (!d.dir)
+        return [d.name.split("/").pop()];
+    try {
+        const pj = JSON.parse(await readFile(join(d.dir, "package.json"), "utf8"));
+        if (typeof pj.bin === "string")
+            return [(pj.name ?? d.name).split("/").pop()];
+        if (pj.bin && typeof pj.bin === "object")
+            return Object.keys(pj.bin);
+    }
+    catch {
+        // unreadable manifest
+    }
+    return [];
+}
+const DEP_BLOCKS = new Set([
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies",
+    "peerDependenciesMeta",
+    "bundleDependencies",
+    "bundledDependencies",
+    "overrides",
+    "resolutions",
+    "name",
+    "scripts",
+    "pnpm",
+    "workspaces",
+    "catalog",
+    "catalogs",
+]);
+function collectStrings(v, out, manifest, depth = 0) {
+    if (depth > 20)
+        return;
+    if (typeof v === "string")
+        out.push(v);
+    else if (Array.isArray(v))
+        for (const x of v)
+            collectStrings(x, out, manifest, depth + 1);
+    else if (v && typeof v === "object") {
+        for (const [k, x] of Object.entries(v)) {
+            if (manifest && depth === 0 && DEP_BLOCKS.has(k))
+                continue;
+            collectStrings(x, out, manifest, depth + 1);
+        }
+    }
+}
+function lineOfString(text, value) {
+    const i = text.indexOf(JSON.stringify(value));
+    return i < 0 ? 1 : text.slice(0, i).split("\n").length;
+}
+function site(file, line, text) {
+    return { file, line, col: 1, typeOnly: false, text };
+}

package/dist/usage/parse.d.ts

@@ -0,0 +1,73 @@
+import type { SourceText } from "./files.ts";
+import type { Binding, ChainSeg } from "../model.ts";
+export interface Pos {
+    line: number;
+    col: number;
+    text: string;
+}
+export interface ImportBinding {
+    local: string;
+    specifier: string;
+    binding: Binding;
+    typeOnly: boolean;
+    pos: Pos;
+}
+export interface ReExport {
+    specifier: string;
+    kind: "star" | "named" | "star-as";
+    names: {
+        imported: string;
+        exported: string;
+    }[];
+    pos: Pos;
+}
+export interface Reference {
+    local: string;
+    chain: ChainSeg[];
+    callSelf: boolean;
+    typeOnly: boolean;
+    pos: Pos;
+    escape: boolean;
+    computed: boolean;
+    derivedInto?: string;
+    callbackInto?: string[];
+}
+export interface InlineUse {
+    specifier: string;
+    binding: Binding;
+    chain: ChainSeg[];
+    callSelf: boolean;
+    pos: Pos;
+    escape: boolean;
+    derivedInto?: string;
+    callbackInto?: string[];
+}
+export interface FileFacts {
+    imports: ImportBinding[];
+    sideEffects: {
+        specifier: string;
+        pos: Pos;
+    }[];
+    reExports: ReExport[];
+    exportedLocals: {
+        local: string;
+        exported: string;
+    }[];
+    declaredExports: string[];
+    references: Reference[];
+    inline: InlineUse[];
+    nonLiteralRequire: Pos[];
+    nonLiteralImport: Pos[];
+    prefixImports: {
+        prefix: string;
+        pos: Pos;
+    }[];
+    stringLiterals: {
+        value: string;
+        pos: Pos;
+    }[];
+    unparseable: boolean;
+}
+export declare const SCANNER_VERSION = 2;
+export declare function parseSource(src: SourceText): FileFacts;
+//# sourceMappingURL=parse.d.ts.map

package/dist/usage/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/usage/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAIpD,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,GAAG,CAAA;CACT;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IAEjB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAClC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC/C,GAAG,EAAE,GAAG,CAAA;CACT;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,GAAG,CAAA;IAER,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAGD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,GAAG,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE,EAAE,CAAA;IAC9C,SAAS,EAAE,QAAQ,EAAE,CAAA;IAErB,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAErD,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,iBAAiB,EAAE,GAAG,EAAE,CAAA;IACxB,gBAAgB,EAAE,GAAG,EAAE,CAAA;IACvB,aAAa,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE,EAAE,CAAA;IAC7C,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE,EAAE,CAAA;IAC7C,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,eAAO,MAAM,eAAe,IAAI,CAAA;AAEhC,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAiBtD"}