@component-compass/cli 0.0.1 → 0.0.3

package/dist/seeds.js

@@ -0,0 +1,145 @@
+/**
+ * Builds per-component seeds from a resolver-emitted snapshot,
+ * parser-emitted occurrences, and the workspace tag rules. Seeds are the
+ * per-component input to `rollupOccurrencesToComponents`: they carry
+ * identity, derivedTags, and manifest enrichment but no occurrence data
+ * (that is merged separately during rollup).
+ *
+ * Pure function; no I/O.
+ */
+import { relative, isAbsolute } from "node:path";
+import { evaluateTagRules } from "./config/tag-rules.js";
+import { manifestComponentToOutput } from "./reporter/index.js";
+import { computeOutputIdentity, computeStableId, computeStableIdFromComponentId, } from "./identity.js";
+/**
+ * Project the resolver snapshot AND parser-emitted occurrences into
+ * ComponentSeeds.
+ *
+ * Two sources contribute:
+ *   1. Snapshotted components — full enrichment via `manifestComponentToOutput`,
+ *      labelled with the snapshot entry's `enrichmentSource`.
+ *   2. Components observed in parser walks but absent from the snapshot —
+ *      emitted with `manifest: null` so they surface in `components[]` per
+ *      the realignment principle ("manifest is enrichment, not gate").
+ *
+ * Dedupe by stable id; snapshotted seeds win.
+ *
+ * Scope derivation follows the three-lane model in identity.ts:
+ *   - local  → source.type === "local"
+ *   - ds     → external + derivedTags.length > 0
+ *   - external → external + no matching tag rules
+ */
+export function buildComponentSeeds(snapshot, parseResults, tagRules, localIndex, repoRoot, workspaceGraph) {
+    const seedsById = new Map();
+    // 1. Resolver-snapshotted components first (so they win on dedupe).
+    for (const entry of snapshot) {
+        const componentId = indexedToComponentId(entry.component);
+        const packageName = entry.component.source.type === "external"
+            ? entry.component.source.package
+            : null;
+        const derivedTags = evaluateTagRules(packageName, tagRules);
+        const identity = computeOutputIdentity({
+            componentId,
+            derivedTags,
+            repoId: "",
+            ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
+        });
+        const id = computeStableId(identity);
+        const manifest = manifestComponentToOutput(entry.component, entry.enrichmentSource);
+        seedsById.set(id, { id, identity, derivedTags, manifest });
+    }
+    // 2. Components observed in parser walks but not yet seeded.
+    //    Emitted with manifest: null per the realignment principle.
+    for (const result of parseResults) {
+        for (const occ of result.occurrences) {
+            // Normalise local filePaths: parsers emit absolute paths; the local index
+            // uses repo-root-relative POSIX paths. Relativise here so the stable id
+            // matches the one produced for seeds built from the local index.
+            const componentId = repoRoot && occ.componentId.source.type === "local" && isAbsolute(occ.componentId.source.filePath)
+                ? {
+                    ...occ.componentId,
+                    source: {
+                        type: "local",
+                        filePath: relative(repoRoot, occ.componentId.source.filePath).replace(/\\/g, "/"),
+                    },
+                }
+                : occ.componentId;
+            const id = computeStableIdFromComponentId(componentId);
+            if (seedsById.has(id))
+                continue;
+            const packageName = componentId.source.type === "external"
+                ? componentId.source.package
+                : null;
+            const derivedTags = evaluateTagRules(packageName, tagRules);
+            const isLocal = componentId.source.type === "local";
+            let definitionLoc;
+            if (isLocal && localIndex) {
+                let match;
+                if (componentId.kind === "custom-element") {
+                    match = localIndex.byTag.get(componentId.tagName);
+                }
+                else {
+                    const path = componentId.source.type === "local" ? componentId.source.filePath : "";
+                    const defs = localIndex.byPath.get(path) ?? [];
+                    const exportName = componentId.export;
+                    match = defs.find((d) => d.exportName === exportName);
+                }
+                if (match?.loc) {
+                    definitionLoc = { line: match.loc.line, column: match.loc.column };
+                }
+            }
+            const identity = computeOutputIdentity({
+                componentId,
+                derivedTags,
+                repoId: "",
+                ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
+                ...(definitionLoc !== undefined ? { definitionLoc } : {}),
+            });
+            seedsById.set(id, { id, identity, derivedTags, manifest: null });
+        }
+    }
+    // 3. Local definitions that were never referenced in any occurrence.
+    //    These must still appear in components[] so they can serve as
+    //    owner-edge targets in the composition graph.
+    if (localIndex) {
+        for (const [, defs] of localIndex.byPath) {
+            for (const def of defs) {
+                const id = computeStableIdFromComponentId(def.componentId);
+                if (seedsById.has(id))
+                    continue;
+                const definitionLoc = def.loc !== undefined
+                    ? { line: def.loc.line, column: def.loc.column }
+                    : undefined;
+                const identity = computeOutputIdentity({
+                    componentId: def.componentId,
+                    derivedTags: [],
+                    repoId: "",
+                    ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
+                    ...(definitionLoc !== undefined ? { definitionLoc } : {}),
+                });
+                seedsById.set(id, { id, identity, derivedTags: [], manifest: null });
+            }
+        }
+    }
+    return [...seedsById.values()];
+}
+/**
+ * Convert an `IndexedComponent` to a `ComponentId` for use with
+ * `computeOutputIdentity`. `IndexedComponent` extends `ManifestComponent`
+ * which shares the same `source` / `kind` / `export` / `tagName` fields.
+ */
+function indexedToComponentId(c) {
+    if (c.kind === "custom-element") {
+        return {
+            kind: "custom-element",
+            tagName: c.tagName,
+            source: c.source,
+        };
+    }
+    return {
+        kind: c.kind,
+        export: c.export,
+        source: c.source,
+    };
+}
+//# sourceMappingURL=seeds.js.map

package/dist/seeds.js.map

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

package/dist/types.d.ts

@@ -6,7 +6,6 @@ export type ResolvedConfig = {
     configDir: string;
     repoId: string;
     packageScopes: string[];
-    manifestSources?: Record<string, string[]>;
     include: string[];
     exclude: string[];
     captureValues: boolean;

package/dist/workspace/build-graph.d.ts

@@ -0,0 +1,2 @@
+import type { WorkspaceGraph } from "./types.js";
+export declare function buildWorkspaceGraph(rootPath: string): WorkspaceGraph;

package/dist/workspace/build-graph.js

@@ -0,0 +1,117 @@
+/**
+ * Build a workspace graph from a repository root.
+ *
+ * Two independent steps:
+ *   - sniffPackageManager: lockfile-based; sets graph.packageManager. Always
+ *     runs; returns "unknown" when no lockfile is found.
+ *   - detectWorkspacePackages: pnpm-workspace.yaml → package.json#workspaces →
+ *     empty array. Independent of step 1.
+ *
+ * Glob expansion uses globby (already a CLI dep).
+ * Pure; no I/O beyond config-file reads.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { globbySync } from "globby";
+import * as yaml from "js-yaml";
+export function buildWorkspaceGraph(rootPath) {
+    const absRoot = resolve(rootPath);
+    const rootPkgJsonPath = join(absRoot, "package.json");
+    const rootPkg = readJsonSafely(rootPkgJsonPath) ?? {};
+    const rootPackageName = typeof rootPkg.name === "string" ? rootPkg.name : "<unnamed>";
+    return {
+        packageManager: sniffPackageManager(absRoot),
+        rootPath: absRoot,
+        rootPackageName,
+        packages: detectWorkspacePackages(absRoot, rootPkg),
+    };
+}
+function sniffPackageManager(absRoot) {
+    if (existsSync(join(absRoot, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(absRoot, "package-lock.json")))
+        return "npm";
+    if (existsSync(join(absRoot, "yarn.lock")))
+        return "yarn";
+    return "unknown";
+}
+function detectWorkspacePackages(absRoot, rootPkg) {
+    // pnpm-workspace.yaml wins when both configs present.
+    const pnpmYamlPath = join(absRoot, "pnpm-workspace.yaml");
+    if (existsSync(pnpmYamlPath)) {
+        const yamlContent = readFileSync(pnpmYamlPath, "utf8");
+        let parsed;
+        try {
+            parsed = yaml.load(yamlContent);
+        }
+        catch {
+            parsed = null;
+        }
+        const globs = isWorkspaceYaml(parsed) ? parsed.packages : [];
+        return expandPackages(absRoot, globs);
+    }
+    // package.json#workspaces (array or object form).
+    const workspaces = rootPkg.workspaces;
+    if (Array.isArray(workspaces)) {
+        return expandPackages(absRoot, workspaces);
+    }
+    if (workspaces &&
+        typeof workspaces === "object" &&
+        Array.isArray(workspaces.packages)) {
+        return expandPackages(absRoot, workspaces.packages);
+    }
+    // No workspace config → single-package repo.
+    return [];
+}
+function expandPackages(absRoot, entries) {
+    if (entries.length === 0)
+        return [];
+    // Split literal paths from globs: globby (fast-glob) treats a bare "foo"
+    // as "foo/**" and returns subdirectories instead of foo itself, so literal
+    // workspace entries must be resolved directly.
+    const literals = [];
+    const globs = [];
+    for (const e of entries) {
+        if (/[*?[\]{}]/.test(e))
+            globs.push(e);
+        else
+            literals.push(e);
+    }
+    const matched = literals.map((p) => resolve(absRoot, p));
+    if (globs.length > 0) {
+        matched.push(...globbySync(globs, {
+            cwd: absRoot,
+            onlyDirectories: true,
+            absolute: true,
+            suppressErrors: true,
+        }));
+    }
+    const packages = [];
+    const seenNames = new Set();
+    for (const dir of matched) {
+        const pkgJson = readJsonSafely(join(dir, "package.json"));
+        if (!pkgJson)
+            continue;
+        if (typeof pkgJson.name !== "string" || pkgJson.name.length === 0)
+            continue;
+        if (seenNames.has(pkgJson.name))
+            continue;
+        seenNames.add(pkgJson.name);
+        packages.push({ name: pkgJson.name, absolutePath: dir, packageJson: pkgJson });
+    }
+    return packages;
+}
+function readJsonSafely(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function isWorkspaceYaml(p) {
+    return (typeof p === "object" &&
+        p !== null &&
+        Array.isArray(p.packages));
+}
+//# sourceMappingURL=build-graph.js.map

package/dist/workspace/build-graph.js.map

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

package/dist/workspace/declared-deps.d.ts

@@ -0,0 +1,5 @@
+import type { WorkspaceGraph, WorkspacePackage } from "./types.js";
+type PkgJson = WorkspacePackage["packageJson"];
+type ReadPkgJson = (path: string) => PkgJson | null;
+export declare function declaredDeps(graph: WorkspaceGraph, read?: ReadPkgJson): string[];
+export {};

package/dist/workspace/declared-deps.js

@@ -0,0 +1,42 @@
+/**
+ * Union of declared dependencies across the workspace root + every workspace
+ * package. Used to warm the lazy resolver's by-tag cache so the resolver knows
+ * about every package in the consumer's monorepo, not just the root's deps.
+ *
+ * Pure; the JSON-read side-effect is injected so tests can drive it without
+ * filesystem fixtures.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+const defaultReader = (path) => {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+};
+export function declaredDeps(graph, read = defaultReader) {
+    const all = new Set();
+    collect(read(join(graph.rootPath, "package.json")), all);
+    for (const pkg of graph.packages) {
+        collect(pkg.packageJson, all);
+    }
+    return [...all];
+}
+function collect(pkg, into) {
+    if (!pkg)
+        return;
+    for (const bucket of [
+        pkg.dependencies,
+        pkg.devDependencies,
+        pkg.peerDependencies,
+        pkg.optionalDependencies,
+    ]) {
+        if (!bucket)
+            continue;
+        for (const name of Object.keys(bucket))
+            into.add(name);
+    }
+}
+//# sourceMappingURL=declared-deps.js.map

package/dist/workspace/declared-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-deps.js","sourceRoot":"","sources":["../../src/workspace/declared-deps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,MAAM,aAAa,GAAgB,CAAC,IAAI,EAAE,EAAE;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,KAAqB,EACrB,OAAoB,aAAa;IAEjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEzD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,OAAO,CAAC,GAAmB,EAAE,IAAiB;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,KAAK,MAAM,MAAM,IAAI;QACnB,GAAG,CAAC,YAAY;QAChB,GAAG,CAAC,eAAe;QACnB,GAAG,CAAC,gBAAgB;QACpB,GAAG,CAAC,oBAAoB;KACzB,EAAE,CAAC;QACF,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/workspace/find-owning-package.d.ts

@@ -0,0 +1,2 @@
+import type { WorkspaceGraph, WorkspacePackage } from "./types.js";
+export declare function findOwningPackage(graph: WorkspaceGraph, filePath: string): WorkspacePackage | null;

package/dist/workspace/find-owning-package.js

@@ -0,0 +1,49 @@
+/**
+ * Realpath-aware workspace-membership check. Resolves the input path via
+ * realpath so node_modules symlinks (yarn/pnpm's usual layout) match their
+ * underlying workspace package directories.
+ *
+ * Returns the WorkspacePackage with the longest absolutePath that is a path
+ * prefix of the resolved input. Null when no package owns the file.
+ */
+import { realpathSync } from "node:fs";
+export function findOwningPackage(graph, filePath) {
+    if (graph.packages.length === 0)
+        return null;
+    const resolved = resolveRealpath(filePath);
+    let best = null;
+    let bestPrefixLen = -1;
+    for (const pkg of graph.packages) {
+        // Realpath the package root too: on macOS tmpdir resolves through
+        // /var -> /private/var, and consumers may pass either form into the graph.
+        const pkgPath = resolveRealpath(pkg.absolutePath);
+        if (!isPathPrefix(pkgPath, resolved))
+            continue;
+        // Reject paths that fall inside a node_modules under the workspace
+        // package: those are vendor packages installed within the workspace
+        // (e.g. <app>/node_modules/@vendor/foo), not the workspace's own source.
+        // Symlinked sibling workspaces have already collapsed away via realpath.
+        if (resolved.slice(pkgPath.length).includes("/node_modules/"))
+            continue;
+        if (pkgPath.length > bestPrefixLen) {
+            best = pkg;
+            bestPrefixLen = pkgPath.length;
+        }
+    }
+    return best;
+}
+function resolveRealpath(filePath) {
+    try {
+        return realpathSync(filePath);
+    }
+    catch {
+        return filePath;
+    }
+}
+function isPathPrefix(prefix, candidate) {
+    if (candidate === prefix)
+        return true;
+    const withSep = prefix.endsWith("/") ? prefix : `${prefix}/`;
+    return candidate.startsWith(withSep);
+}
+//# sourceMappingURL=find-owning-package.js.map

package/dist/workspace/find-owning-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-owning-package.js","sourceRoot":"","sources":["../../src/workspace/find-owning-package.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,QAAgB;IAEhB,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,IAAI,GAA4B,IAAI,CAAC;IACzC,IAAI,aAAa,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,kEAAkE;QAClE,2EAA2E;QAC3E,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC;YAAE,SAAS;QAC/C,mEAAmE;QACnE,oEAAoE;QACpE,yEAAyE;QACzE,yEAAyE;QACzE,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAAE,SAAS;QACxE,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACnC,IAAI,GAAG,GAAG,CAAC;YACX,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,SAAiB;IACrD,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC;IAC7D,OAAO,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/workspace/index.d.ts

@@ -0,0 +1,4 @@
+export { buildWorkspaceGraph } from "./build-graph.js";
+export { declaredDeps } from "./declared-deps.js";
+export { findOwningPackage } from "./find-owning-package.js";
+export type { PackageManager, WorkspaceGraph, WorkspacePackage } from "./types.js";

package/dist/workspace/index.js

@@ -0,0 +1,4 @@
+export { buildWorkspaceGraph } from "./build-graph.js";
+export { declaredDeps } from "./declared-deps.js";
+export { findOwningPackage } from "./find-owning-package.js";
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/workspace/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Workspace graph shape. Built once per scan at scan-start, threaded into the
+ * resolver (for workspace-locality classification) and the identity layer
+ * (for `OutputIdentity.packageName` enrichment).
+ *
+ * Two independent axes:
+ *   - `packageManager` — yarn / npm / pnpm, sniffed from lockfile. Always set.
+ *     Returns "unknown" when no lockfile is detected (explicit "no signal").
+ *   - `packages` — workspace packages from pnpm-workspace.yaml or
+ *     package.json#workspaces. Empty array for single-package repos.
+ */
+export type PackageManager = "yarn" | "npm" | "pnpm" | "unknown";
+export type WorkspacePackage = {
+    /** Workspace package name from its `package.json#name`. */
+    name: string;
+    /** Absolute path to the package directory. */
+    absolutePath: string;
+    /** Parsed `package.json` contents. Cached for `declaredDeps`. */
+    packageJson: {
+        name?: string;
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+        peerDependencies?: Record<string, string>;
+        optionalDependencies?: Record<string, string>;
+        workspaces?: string[] | {
+            packages?: string[];
+        };
+    };
+};
+export type WorkspaceGraph = {
+    /**
+     * Detected package manager (lockfile-based). `"unknown"` when no lockfile
+     * is present — explicit about not knowing. Independent of workspace
+     * detection — set even for single-package repos.
+     */
+    packageManager: PackageManager;
+    /** Absolute path to the scan's configDir (the workspace root). */
+    rootPath: string;
+    /** Root package name; "<unnamed>" if missing. */
+    rootPackageName: string;
+    /**
+     * Detected workspace packages from pnpm-workspace.yaml or
+     * package.json#workspaces. Empty array for single-package repos.
+     */
+    packages: WorkspacePackage[];
+};

package/dist/workspace/types.js

@@ -0,0 +1,13 @@
+/**
+ * Workspace graph shape. Built once per scan at scan-start, threaded into the
+ * resolver (for workspace-locality classification) and the identity layer
+ * (for `OutputIdentity.packageName` enrichment).
+ *
+ * Two independent axes:
+ *   - `packageManager` — yarn / npm / pnpm, sniffed from lockfile. Always set.
+ *     Returns "unknown" when no lockfile is detected (explicit "no signal").
+ *   - `packages` — workspace packages from pnpm-workspace.yaml or
+ *     package.json#workspaces. Empty array for single-package repos.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@component-compass/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "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"
+    "compass": "dist/cli.js",
+    "component-compass": "dist/cli.js"
   },
   "files": [
     "dist",
@@ -35,20 +35,22 @@
   "dependencies": {
     "@babel/parser": "^7.29.3",
     "@babel/types": "^7.29.0",
-    "@component-compass/ast-utils": "^0.0.1",
-    "@component-compass/parser-html": "^0.0.1",
-    "@component-compass/parser-lit": "^0.0.1",
-    "@component-compass/parser-react": "^0.0.1",
-    "@component-compass/parser-vue": "^0.0.1",
-    "@component-compass/plugin-core": "^0.0.1",
+    "@component-compass/ast-utils": "^0.0.3",
+    "@component-compass/parser-html": "^0.0.3",
+    "@component-compass/parser-lit": "^0.0.3",
+    "@component-compass/parser-react": "^0.0.3",
+    "@component-compass/parser-vue": "^0.0.3",
+    "@component-compass/plugin-core": "^0.0.3",
     "@vue/compiler-sfc": "^3.5.33",
     "ajv": "^8.20.0",
     "glob": "^13.0.0",
     "globby": "^16.2.0",
+    "js-yaml": "^4",
     "picomatch": "^4.0.4",
     "ulid": "^3.0.2"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4",
     "@types/node": "^24.0.0",
     "@types/picomatch": "^4.0.3",
     "typescript": "^5.9.0",

package/schema/config.schema.json

@@ -4,21 +4,13 @@
   "title": "component-compass config",
   "type": "object",
   "additionalProperties": false,
-  "required": ["repoId", "packageScopes", "include"],
+  "required": ["repoId", "include"],
   "properties": {
     "$schema": { "type": "string" },
     "repoId": { "type": "string", "minLength": 1 },
     "packageScopes": {
       "type": "array",
-      "items": { "type": "string", "minLength": 1 },
-      "minItems": 1
-    },
-    "manifestSources": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "array",
-        "items": { "type": "string", "minLength": 1 }
-      }
+      "items": { "type": "string", "minLength": 1 }
     },
     "include": {
       "type": "array",

package/dist/graph/builder.d.ts

@@ -1,25 +0,0 @@
-import type { ScanEnvelope } from "@component-compass/plugin-core";
-import type { ComponentIndex } from "../manifest/types.js";
-import type { ParseResult } from "@component-compass/plugin-core";
-import type { Warning } from "../types.js";
-import type { OutputDocument, OutputManifestRef } from "../reporter/types.js";
-export type BuildGraphOptions = {
-    index: ComponentIndex;
-    results: ParseResult[];
-    filesScanned: number;
-    scanDurationMs: number;
-    tool: {
-        name: string;
-        version: string;
-    };
-    repo: {
-        name: string;
-        root: string;
-        commit?: string | undefined;
-    };
-    manifests: OutputManifestRef[];
-    captureValues: boolean;
-    extraWarnings?: Warning[];
-    envelope: ScanEnvelope;
-};
-export declare function buildGraph(opts: BuildGraphOptions): OutputDocument;