@component-compass/cli 0.0.0-pr-3-8916f3c-20260507145532

package/dist/walker/resolve-import.js

@@ -0,0 +1,119 @@
+import { readFileSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, isAbsolute, resolve as pathResolve } from "node:path";
+/**
+ * Module specifier resolver layered on top of Node's module resolution.
+ *
+ * Resolution order (first hit wins):
+ *   1. Config `aliases` (explicit user-supplied alias map).
+ *   2. `compilerOptions.paths` from the tsconfig at `tsconfigPath`.
+ *   3. Node module resolution via `require.resolve`.
+ *
+ * Returns the absolute path of the resolved file, or `null` if no layer
+ * matches. See spec §3.5.
+ *
+ * v1 limitations:
+ *   - Tsconfig `extends` chains are NOT followed; only the named file's own
+ *     `compilerOptions.paths` and `baseUrl` are consulted.
+ *   - No caching of resolved specifiers (workload is small for v1 scans).
+ */
+const FILE_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js", ".vue"];
+const REGEX_META = /[.+?^${}()|[\]\\]/g;
+export function createImportResolver(opts) {
+    const configEntries = compileAliasMap(opts.aliases, opts.repoRoot);
+    const tsconfigEntries = loadTsconfigEntries(opts.tsconfigPath);
+    // Reused for `require.resolve` fallback. Anchoring at <repoRoot>/_ ensures
+    // Node walks up through <repoRoot>/node_modules and parents.
+    const requireFromRepo = createRequire(pathResolve(opts.repoRoot, "_"));
+    return function resolveImport(from, spec) {
+        for (const layers of [configEntries, tsconfigEntries]) {
+            for (const entry of layers) {
+                const m = entry.pattern.exec(spec);
+                if (!m)
+                    continue;
+                const wildcard = m[1] ?? "";
+                for (const target of entry.targets) {
+                    const expanded = pathResolve(entry.base, target.replace(/\*/g, wildcard));
+                    const hit = tryFileWithExtensions(expanded);
+                    if (hit)
+                        return hit;
+                }
+            }
+        }
+        try {
+            return requireFromRepo.resolve(spec, { paths: [dirname(from), opts.repoRoot] });
+        }
+        catch {
+            return null;
+        }
+    };
+}
+function compileAliasMap(aliases, base) {
+    if (!aliases)
+        return [];
+    const out = [];
+    for (const [key, targets] of Object.entries(aliases)) {
+        out.push({ pattern: compilePattern(key), targets, base });
+    }
+    return out;
+}
+function loadTsconfigEntries(tsconfigPath) {
+    if (!tsconfigPath)
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(tsconfigPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    const co = parsed.compilerOptions ?? {};
+    if (!co.paths)
+        return [];
+    const tsconfigDir = dirname(tsconfigPath);
+    const base = co.baseUrl ? pathResolve(tsconfigDir, co.baseUrl) : tsconfigDir;
+    const out = [];
+    for (const [key, targets] of Object.entries(co.paths)) {
+        out.push({ pattern: compilePattern(key), targets, base });
+    }
+    return out;
+}
+/** Compiles an alias pattern (literal text + `*` wildcard) into an anchored regex
+ *  with the wildcard captured for substitution into the target. */
+function compilePattern(pattern) {
+    return new RegExp(`^${pattern.replace(REGEX_META, "\\$&").replace(/\*/g, "(.*)")}$`);
+}
+/** Tries the path as-is, with each extension, and as a directory with `index.{ext}`. */
+function tryFileWithExtensions(absPath) {
+    if (!isAbsolute(absPath))
+        return null;
+    if (isFile(absPath))
+        return absPath;
+    for (const ext of FILE_EXTENSIONS) {
+        const withExt = absPath + ext;
+        if (isFile(withExt))
+            return withExt;
+    }
+    for (const ext of FILE_EXTENSIONS) {
+        const indexPath = pathResolve(absPath, `index${ext}`);
+        if (isFile(indexPath))
+            return indexPath;
+    }
+    return null;
+}
+function isFile(p) {
+    try {
+        return statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=resolve-import.js.map

package/dist/walker/resolve-import.js.map

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

package/examples/github-actions-workflow.yml

@@ -0,0 +1,20 @@
+name: component-compass
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+      - run: corepack enable && yarn install --immutable
+      - run: yarn dlx component-compass scan --quiet
+      - uses: actions/upload-artifact@v4
+        with:
+          name: component-compass
+          path: component-compass.json

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@component-compass/cli",
+  "version": "0.0.0-pr-3-8916f3c-20260507145532",
+  "description": "Open-source CLI for measuring design-system component usage across multi-framework consumer repos.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "compass": "dist/cli.js",
+    "component-compass": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "examples",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./schema/config.schema.json": "./schema/config.schema.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint src tests",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.29.3",
+    "@babel/types": "^7.29.0",
+    "@component-compass/ast-utils": "0.0.0-pr-3-8916f3c-20260507145532",
+    "@component-compass/parser-html": "0.0.0-pr-3-8916f3c-20260507145532",
+    "@component-compass/parser-lit": "0.0.0-pr-3-8916f3c-20260507145532",
+    "@component-compass/parser-react": "0.0.0-pr-3-8916f3c-20260507145532",
+    "@component-compass/parser-vue": "0.0.0-pr-3-8916f3c-20260507145532",
+    "@component-compass/plugin-core": "0.0.0-pr-3-8916f3c-20260507145532",
+    "@vue/compiler-sfc": "^3.5.33",
+    "ajv": "^8.20.0",
+    "glob": "^13.0.0",
+    "globby": "^16.2.0",
+    "picomatch": "^4.0.4",
+    "ulid": "^3.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/picomatch": "^4.0.3",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/schema/config.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://unpkg.com/@component-compass/cli/schema/config.schema.json",
+  "title": "component-compass config",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["repoId", "packageScopes", "include"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "repoId": { "type": "string", "minLength": 1 },
+    "packageScopes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "manifestSources": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "minItems": 1
+    },
+    "exclude": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "captureValues": { "type": "boolean" },
+    "output": { "type": "string", "minLength": 1 },
+    "tsconfigPath": { "type": "string", "minLength": 1 },
+    "aliases": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "tagRules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["tag", "match"],
+        "additionalProperties": false,
+        "properties": {
+          "tag": { "type": "string", "minLength": 1 },
+          "match": {
+            "type": "object",
+            "required": ["packageName"],
+            "additionalProperties": false,
+            "properties": {
+              "packageName": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}