@component-compass/cli 0.0.2 → 0.0.4

package/dist/scan/cem-index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A single entry in `CemIndex.byTag`.
+ *
+ * `manifest` is the **per-declaration** payload — one component's data, not
+ * the full package manifest. For CCM this is one entry from `components[]`;
+ * for CEM this is one declaration from `modules[].declarations[]`.
+ * Use `CemIndex.byPackageName` to retrieve the full-package manifest.
+ */
+export type CemIndexEntry = {
+    packageName: string;
+    manifest: unknown;
+};
+export type CemIndex = {
+    byTag: Map<string, CemIndexEntry>;
+    byPackageName: Map<string, {
+        manifest: unknown;
+    }>;
+};
+/**
+ * Build a global CEM index from all packages reachable from `<root>/node_modules`.
+ *
+ * Yarn workspace packages are symlinked into `node_modules/<name>`, so they
+ * are indexed automatically alongside published dependencies. There's no
+ * separate workspace-enumeration pass — `node_modules` covers both.
+ *
+ * For each package found:
+ *   - If it ships a `component-compass-manifest.json` (CCM), index its
+ *     declarations. CCM takes precedence over CEM.
+ *   - Otherwise, if it ships a CEM (`pkg.customElements` field or
+ *     `custom-elements.json` at the package root), index its declarations.
+ *
+ * Each declaration with a `tagName` is added to `byTag`. Each package
+ * with any indexed manifest is added to `byPackageName`.
+ *
+ * @param root Absolute or relative path to the repository root containing
+ *             a `node_modules` directory.
+ */
+export declare function buildCemIndex(root: string): Promise<CemIndex>;

package/dist/scan/cem-index.js

@@ -0,0 +1,139 @@
+/**
+ * Global CEM index — built once at scan startup.
+ *
+ * Enumerates every package.json under <root>/node_modules, finds any
+ * CEM (`custom-elements.json`) or CCM (`component-compass-manifest.json`)
+ * files, and builds two lookup tables:
+ *   - `byTag`          tagName → { packageName, manifest }
+ *   - `byPackageName`  packageName → { manifest }
+ *
+ * CCM takes precedence over CEM when both exist.
+ *
+ * Parsers use `byTag` to resolve hyphenated tags (<pie-link>, <sl-button>)
+ * unconditionally — no consumer-side config required.
+ *
+ * Shape contract:
+ *   - `byTag` entry.manifest is the **per-declaration** manifest payload —
+ *     a single component's data, not the full package manifest. For CCM this
+ *     is one entry from `components[]`; for CEM this is one declaration from
+ *     `modules[].declarations[]`. Use `byPackageName` for the full-package view.
+ *   - `byPackageName` entry.manifest is the full top-level manifest document
+ *     (the CCM root object or the CEM root object).
+ */
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { globby } from "globby";
+/**
+ * Walk a CEM document and collect all custom-element declarations that carry a
+ * `tagName`. Returns each declaration object paired with its tag name so the
+ * caller can store the per-declaration entry in `byTag`.
+ */
+function walkCemForTagDeclarations(cem) {
+    const results = [];
+    for (const mod of cem.modules ?? []) {
+        for (const decl of mod.declarations ?? []) {
+            if (decl.customElement === true && typeof decl.tagName === "string") {
+                results.push({ tagName: decl.tagName, decl });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Build a global CEM index from all packages reachable from `<root>/node_modules`.
+ *
+ * Yarn workspace packages are symlinked into `node_modules/<name>`, so they
+ * are indexed automatically alongside published dependencies. There's no
+ * separate workspace-enumeration pass — `node_modules` covers both.
+ *
+ * For each package found:
+ *   - If it ships a `component-compass-manifest.json` (CCM), index its
+ *     declarations. CCM takes precedence over CEM.
+ *   - Otherwise, if it ships a CEM (`pkg.customElements` field or
+ *     `custom-elements.json` at the package root), index its declarations.
+ *
+ * Each declaration with a `tagName` is added to `byTag`. Each package
+ * with any indexed manifest is added to `byPackageName`.
+ *
+ * @param root Absolute or relative path to the repository root containing
+ *             a `node_modules` directory.
+ */
+export async function buildCemIndex(root) {
+    const index = {
+        byTag: new Map(),
+        byPackageName: new Map(),
+    };
+    // Enumerate: unscoped node_modules/*/package.json and scoped node_modules/@*/*/package.json
+    const pkgJsonPaths = await globby([
+        "node_modules/*/package.json",
+        "node_modules/@*/*/package.json",
+    ], {
+        cwd: root,
+        absolute: true,
+        onlyFiles: true,
+        suppressErrors: true,
+        // Don't traverse into nested node_modules — only the top-level
+        // dependency tree is relevant for CEM discovery.
+        ignore: ["node_modules/*/node_modules/**", "node_modules/@*/*/node_modules/**"],
+    });
+    await Promise.all(pkgJsonPaths.map(async (pkgJsonPath) => {
+        const pkgDir = dirname(pkgJsonPath);
+        let pkg = null;
+        try {
+            pkg = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+        }
+        catch {
+            return;
+        }
+        if (!pkg || typeof pkg.name !== "string")
+            return;
+        const packageName = pkg.name;
+        // CCM takes precedence: if both exist, CCM wins.
+        const ccmPath = join(pkgDir, "component-compass-manifest.json");
+        if (existsSync(ccmPath)) {
+            try {
+                const ccmJson = JSON.parse(await readFile(ccmPath, "utf8"));
+                // CCM format has `components[]` — custom-element entries carry tagName
+                if (ccmJson && Array.isArray(ccmJson.components)) {
+                    for (const c of ccmJson.components) {
+                        if (c.kind === "custom-element" && typeof c.tagName === "string") {
+                            index.byTag.set(c.tagName, { packageName, manifest: c });
+                        }
+                    }
+                }
+                index.byPackageName.set(packageName, { manifest: ccmJson });
+            }
+            catch {
+                // Malformed CCM — skip.
+            }
+            return; // CCM found; don't also load CEM for this package.
+        }
+        // CEM: check `pkg.customElements` field first (authoritative path),
+        // then fall back to the conventional `custom-elements.json`.
+        const cemRelPath = typeof pkg.customElements === "string"
+            ? pkg.customElements
+            : "custom-elements.json";
+        const cemPath = join(pkgDir, cemRelPath);
+        if (!existsSync(cemPath))
+            return;
+        try {
+            const cemJson = JSON.parse(await readFile(cemPath, "utf8"));
+            const tagDecls = walkCemForTagDeclarations(cemJson);
+            // byPackageName is always populated for any CEM-shipping package,
+            // regardless of whether it declares any custom elements (e.g. mixin-only
+            // packages have no tagName entries but are still valid CEM consumers).
+            index.byPackageName.set(packageName, { manifest: cemJson });
+            for (const { tagName, decl } of tagDecls) {
+                // Store the per-declaration entry so byTag consumers get the specific
+                // component's data, not a haystack to search. Mirrors CCM behaviour.
+                index.byTag.set(tagName, { packageName, manifest: decl });
+            }
+        }
+        catch {
+            // Malformed CEM — skip.
+        }
+    }));
+    return index;
+}
+//# sourceMappingURL=cem-index.js.map

package/dist/scan/cem-index.js.map

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

package/dist/scan/git-mtime.d.ts

@@ -0,0 +1,2 @@
+import type { OutputComponent } from "@component-compass/plugin-core";
+export declare function stampGitMTime(root: string, components: OutputComponent[]): Promise<void>;

package/dist/scan/git-mtime.js

@@ -0,0 +1,22 @@
+import { readFileMTimes } from "../util/git.js";
+export async function stampGitMTime(root, components) {
+    const localPaths = new Set();
+    for (const c of components) {
+        if (c.identity.scope === "local" && c.identity.filePath) {
+            localPaths.add(c.identity.filePath);
+        }
+    }
+    const map = await readFileMTimes(root, [...localPaths]);
+    for (const c of components) {
+        if (c.identity.scope === "local" && c.identity.filePath) {
+            const range = map.get(c.identity.filePath);
+            c.createdAt = range?.firstCommitAt ?? null;
+            c.updatedAt = range?.lastCommitAt ?? null;
+        }
+        else {
+            c.createdAt = null;
+            c.updatedAt = null;
+        }
+    }
+}
+//# sourceMappingURL=git-mtime.js.map

package/dist/scan/git-mtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-mtime.js","sourceRoot":"","sources":["../../src/scan/git-mtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,UAA6B;IAE7B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC3C,CAAC,CAAC,SAAS,GAAG,KAAK,EAAE,aAAa,IAAI,IAAI,CAAC;YAC3C,CAAC,CAAC,SAAS,GAAG,KAAK,EAAE,YAAY,IAAI,IAAI,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/scan/meta.d.ts

@@ -0,0 +1,5 @@
+import type { ScanMeta } from "@component-compass/plugin-core";
+export declare function stampMeta(opts: {
+    cwd: string;
+    repoIdOverride?: string;
+}): Promise<ScanMeta>;

package/dist/scan/meta.js

@@ -0,0 +1,58 @@
+import { readFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ulid } from "ulid";
+import { readGitCommit, readGitRemote, readGitBranch, readInitialCommit } from "../util/git.js";
+import { readToolVersion } from "../envelope/index.js";
+export async function stampMeta(opts) {
+    const commit = await readGitCommit(opts.cwd);
+    if (!commit)
+        throw new Error(`not a git repository: ${opts.cwd}`);
+    const rawInitialCommit = await readInitialCommit(opts.cwd);
+    const initialCommit = rawInitialCommit ?? null;
+    if (!initialCommit) {
+        process.stderr.write("warn: initial commit unavailable (shallow clone?) — set fetch-depth: 0 in CI for stable repo identity\n");
+    }
+    const gitRemote = await readGitRemote(opts.cwd);
+    const branch = await readGitBranch(opts.cwd);
+    const id = opts.repoIdOverride ?? deriveId(gitRemote, opts.cwd);
+    return {
+        ccVersion: readToolVersion(findCliPackageRoot()),
+        scanId: ulid(),
+        scannedAt: new Date().toISOString(),
+        repo: { id, gitRemote, commit, initialCommit, branch },
+    };
+}
+function deriveId(remote, cwd) {
+    if (remote) {
+        const match = remote.match(/[/:]([^/]+?)(\.git)?$/);
+        if (match?.[1])
+            return match[1];
+    }
+    return basename(cwd);
+}
+/**
+ * Walk up from this module's directory until we find the @component-compass/cli
+ * package.json. Robust to running from dist/ or src/ (vitest) without
+ * hardcoding a relative depth. Mirrors the pattern in envelope/index.ts.
+ */
+function findCliPackageRoot() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, "package.json");
+        try {
+            const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+            if (parsed.name === "@component-compass/cli")
+                return dir;
+        }
+        catch {
+            // continue walking
+        }
+        const parent = resolve(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return dirname(fileURLToPath(import.meta.url));
+}
+//# sourceMappingURL=meta.js.map

package/dist/scan/meta.js.map

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

package/dist/scan/stamp-deprecated.d.ts

@@ -0,0 +1,16 @@
+import type { OutputComponent } from "@component-compass/plugin-core";
+import type { CemIndex } from "./cem-index.js";
+/**
+ * Stamp `deprecated: true` onto each custom-element component whose CEM
+ * declaration carries `deprecated: true` (or a reason string). All other
+ * components keep the default `deprecated: false` set during rollup.
+ *
+ * Sources checked, in priority order:
+ *   1. Global CEM index (built from node_modules at scan startup) — covers
+ *      custom-elements resolved via the HTML/Lit/Vue tag-name path.
+ *   2. component.manifest?.data?.lifecycle?.status — covers components whose
+ *      manifest was loaded via the lazy-resolver path.
+ *
+ * A component is deprecated when EITHER source says so.
+ */
+export declare function stampDeprecated(components: OutputComponent[], cemIndex: CemIndex): void;

package/dist/scan/stamp-deprecated.js

@@ -0,0 +1,33 @@
+/**
+ * Stamp `deprecated: true` onto each custom-element component whose CEM
+ * declaration carries `deprecated: true` (or a reason string). All other
+ * components keep the default `deprecated: false` set during rollup.
+ *
+ * Sources checked, in priority order:
+ *   1. Global CEM index (built from node_modules at scan startup) — covers
+ *      custom-elements resolved via the HTML/Lit/Vue tag-name path.
+ *   2. component.manifest?.data?.lifecycle?.status — covers components whose
+ *      manifest was loaded via the lazy-resolver path.
+ *
+ * A component is deprecated when EITHER source says so.
+ */
+export function stampDeprecated(components, cemIndex) {
+    for (const c of components) {
+        // Manifest-lifecycle path: already captured via lazy-resolver enrichment.
+        if (c.manifest?.data?.lifecycle?.status === "deprecated") {
+            c.deprecated = true;
+            continue;
+        }
+        // CEM-index path: look up the tag name in the global CEM index.
+        if (c.identity.kind === "custom-element" && c.identity.tagName) {
+            const entry = cemIndex.byTag.get(c.identity.tagName);
+            if (entry) {
+                const rawDecl = entry.manifest;
+                if (rawDecl && rawDecl.deprecated !== undefined && rawDecl.deprecated !== false) {
+                    c.deprecated = true;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=stamp-deprecated.js.map

package/dist/scan/stamp-deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-deprecated.js","sourceRoot":"","sources":["../../src/scan/stamp-deprecated.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA6B,EAC7B,QAAkB;IAElB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,0EAA0E;QAC1E,IAAI,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;YACzD,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QAED,gEAAgE;QAChE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,KAAK,CAAC,QAAoD,CAAC;gBAC3E,IAAI,OAAO,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;oBAChF,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/scan/stamp-version.d.ts

@@ -0,0 +1,18 @@
+import type { OutputComponent, OutputOccurrence } from "@component-compass/plugin-core";
+/**
+ * Reads each external/workspace package's `version` from its installed
+ * `package.json` and stamps it onto every component from that package.
+ * Local components keep `version: null`.
+ *
+ * Uses Node-style module resolution: walks upward from a representative
+ * occurrence's file directory through ancestor `node_modules` directories
+ * until the package is found. Starting from inside the sub-app that uses
+ * the package handles multi-app monorepos where deps are installed per-app
+ * (e.g. `pie-aperture/nextjs-app-v14/node_modules/`) rather than hoisted
+ * to the workspace root. Falls back to `startDir` for packages with no
+ * occurrences.
+ *
+ * Batches IO: one package.json read per unique external package name, not
+ * per component.
+ */
+export declare function stampVersion(startDir: string, components: OutputComponent[], occurrences?: OutputOccurrence[]): Promise<void>;

package/dist/scan/stamp-version.js

@@ -0,0 +1,94 @@
+import { readFile } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+/**
+ * Reads each external/workspace package's `version` from its installed
+ * `package.json` and stamps it onto every component from that package.
+ * Local components keep `version: null`.
+ *
+ * Uses Node-style module resolution: walks upward from a representative
+ * occurrence's file directory through ancestor `node_modules` directories
+ * until the package is found. Starting from inside the sub-app that uses
+ * the package handles multi-app monorepos where deps are installed per-app
+ * (e.g. `pie-aperture/nextjs-app-v14/node_modules/`) rather than hoisted
+ * to the workspace root. Falls back to `startDir` for packages with no
+ * occurrences.
+ *
+ * Batches IO: one package.json read per unique external package name, not
+ * per component.
+ */
+export async function stampVersion(startDir, components, occurrences = []) {
+    // Collect unique external package names.
+    const packageNames = new Set();
+    for (const c of components) {
+        if (c.identity.scope !== "local" && c.identity.packageName) {
+            packageNames.add(c.identity.packageName);
+        }
+    }
+    // componentId → packageName for fast occurrence → package lookup.
+    const pkgByComponentId = new Map();
+    for (const c of components) {
+        if (c.identity.scope !== "local" && c.identity.packageName) {
+            pkgByComponentId.set(c.id, c.identity.packageName);
+        }
+    }
+    // packageName → directory to start the walk-up from. Use the parent dir of
+    // any occurrence's file path (resolved relative to startDir). Multi-app
+    // monorepos install deps per-app, so walking up from inside the sub-app
+    // hits the per-app node_modules. Falls back to startDir for packages with
+    // no occurrences.
+    const starterDirByPackage = new Map();
+    for (const o of occurrences) {
+        const pkg = pkgByComponentId.get(o.componentId);
+        if (pkg && !starterDirByPackage.has(pkg)) {
+            starterDirByPackage.set(pkg, dirname(resolve(startDir, o.filePath)));
+        }
+    }
+    // Read each package.json once. Store null when not found / no version field.
+    const versionByPackage = new Map();
+    await Promise.all([...packageNames].map(async (name) => {
+        const searchFrom = starterDirByPackage.get(name) ?? startDir;
+        const version = await resolvePackageVersion(searchFrom, name);
+        versionByPackage.set(name, version);
+    }));
+    // Stamp each component.
+    for (const c of components) {
+        if (c.identity.scope !== "local" && c.identity.packageName) {
+            c.version = versionByPackage.get(c.identity.packageName) ?? null;
+        }
+        else {
+            c.version = null;
+        }
+    }
+}
+/**
+ * Walk up the directory tree from `startDir`, trying
+ * `<dir>/node_modules/<packageName>/package.json` at each level.
+ * Returns the `version` string, or null when not found anywhere.
+ */
+async function resolvePackageVersion(startDir, packageName) {
+    let dir = startDir;
+    while (true) {
+        const pkgPath = join(dir, "node_modules", packageName, "package.json");
+        try {
+            const raw = await readFile(pkgPath, "utf8");
+            try {
+                const pkg = JSON.parse(raw);
+                return pkg.version ?? null;
+            }
+            catch {
+                // Malformed JSON — file exists, version unreadable.
+                return null;
+            }
+        }
+        catch {
+            // File not found or unreadable — try parent.
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root.
+            return null;
+        }
+        dir = parent;
+    }
+}
+//# sourceMappingURL=stamp-version.js.map

package/dist/scan/stamp-version.js.map

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

package/dist/seeds.d.ts

@@ -1,15 +1,14 @@
 /**
- * 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).
+ * Builds per-component seeds from a resolver-emitted snapshot and
+ * parser-emitted occurrences. Seeds are the per-component input to
+ * `rollupOccurrencesToComponents`: they carry identity and manifest enrichment
+ * but no occurrence data (that is merged separately during rollup).
  *
  * Pure function; no I/O.
  */
-import type { IndexedComponent, ParseResult } from "@component-compass/plugin-core";
-import type { TagRule } from "./config/schema.js";
+import type { IndexedComponent, LocalDefinitionIndex, ParseResult } from "@component-compass/plugin-core";
 import type { ComponentSeed } from "./rollup.js";
+import type { WorkspaceGraph } from "./workspace/types.js";
 /**
  * One entry in the resolver snapshot. Each entry pairs an `IndexedComponent`
  * (the manifest-shaped record) with an `enrichmentSource` label distinguishing
@@ -24,17 +23,19 @@ export type SnapshotEntry = {
  * 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").
+ *   1. Components observed in parser walks — carry `modulePath` from the
+ *      resolver and surface with `manifest: null` initially.
+ *   2. Snapshotted components — full enrichment via `manifestComponentToOutput`,
+ *      labelled with the snapshot entry's `enrichmentSource`. Snapshot entries
+ *      have NO `modulePath` (manifests don't carry that info), so their stable
+ *      id differs from the parser-emitted seed for the same logical component.
+ *      To avoid emitting a ghost component, we attach the snapshot's manifest
+ *      enrichment to a matching parser-emitted seed when the match is
+ *      unambiguous (exactly one parser seed with `{kind, packageName,
+ *      exportName-or-tagName}`). Ambiguous matches fall through to a
+ *      snapshot-only seed.
  *
- * 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
+ * Scope derivation: "local" for source.type === "local"; "external" otherwise.
+ * DS-grouping is the web app's responsibility — CC emits two scopes only.
  */
-export declare function buildComponentSeeds(snapshot: SnapshotEntry[], parseResults: ParseResult[], tagRules: TagRule[] | undefined): ComponentSeed[];
+export declare function buildComponentSeeds(snapshot: SnapshotEntry[], parseResults: ParseResult[], localIndex?: LocalDefinitionIndex, repoRoot?: string, workspaceGraph?: WorkspaceGraph): ComponentSeed[];