@component-compass/cli 0.0.1 → 0.0.2

package/dist/manifest/lazy-resolver.js

@@ -0,0 +1,405 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, resolve as pathResolve } from "node:path";
+import { validateManifest, } from "@component-compass/plugin-core";
+import { parseBarrelTopLevelDetailed } from "./barrel-parser.js";
+import { extractDerivedManifest as extractDerivedManifestStub } from "./derived-manifest-stub.js";
+/**
+ * Hard ceiling on re-export hops a single resolution may walk. Real chains
+ * top out around 10 hops (deep barrel piles); 32 is a pathological-input
+ * safety net. When this fires we emit a `chain-too-deep` diagnostic and
+ * treat the current file as terminal so the user sees a signal rather than
+ * a silent wrong-leaf attribution.
+ */
+const MAX_REEXPORT_HOPS = 32;
+export function createLazyResolver(opts) {
+    const { resolveImport } = opts;
+    const extractDerived = opts.extractDerivedManifest ?? extractDerivedManifestStub;
+    // (absoluteFilePath::exportName) → cached hit (or null for negative cache).
+    const hitCache = new Map();
+    // tagName → custom-element entry (populated as authored manifests load).
+    const byTag = new Map();
+    // Leaf packages whose authored manifest has been loaded.
+    const visitedLeafs = new Map();
+    const diagnostics = [];
+    function loadLeafManifest(leafPackage, leafDir) {
+        const cached = visitedLeafs.get(leafPackage);
+        if (cached)
+            return cached.components;
+        const cemPath = join(leafDir, "custom-elements.json");
+        const ccmPath = join(leafDir, "component-compass-manifest.json");
+        let components = [];
+        let manifestPath = null;
+        let manifestSource = null;
+        let pkgVersion;
+        try {
+            const raw = readFileSync(join(leafDir, "package.json"), "utf8");
+            const pkg = JSON.parse(raw);
+            pkgVersion = pkg.version;
+        }
+        catch {
+            // Best-effort; leave undefined.
+        }
+        if (existsSync(cemPath)) {
+            try {
+                const raw = readFileSync(cemPath, "utf8");
+                const cem = JSON.parse(raw);
+                components = absorbCemDeclarations(cem, leafPackage);
+                manifestPath = cemPath;
+                manifestSource = "cem";
+            }
+            catch {
+                // Treat malformed CEM as no manifest.
+            }
+        }
+        else if (existsSync(ccmPath)) {
+            try {
+                const raw = readFileSync(ccmPath, "utf8");
+                const parsed = JSON.parse(raw);
+                const v = validateManifest(parsed);
+                if (v.ok) {
+                    components = absorbCcmComponents(v.data, leafPackage);
+                    manifestPath = ccmPath;
+                    manifestSource = v.data.source;
+                }
+            }
+            catch {
+                // Treat malformed CCM as no manifest.
+            }
+        }
+        if (!manifestPath || !manifestSource) {
+            // No authored manifest — try derived (Phase 4 hook).
+            const derived = extractDerived(leafDir);
+            if (derived) {
+                components = derived.components;
+                for (const c of components) {
+                    if (c.kind === "custom-element")
+                        byTag.set(c.tagName, c);
+                }
+                // `path: ""` filters this entry out of `snapshotManifestRefs()`. The
+                // resolver-internal `source` is `ManifestSource` ("cem" | "react" |
+                // "vue"); "react" is a placeholder here — the artifact-facing
+                // distinction between authored and derived is carried by
+                // `OutputManifest.source` (added in Task 8), not this internal field.
+                visitedLeafs.set(leafPackage, {
+                    components,
+                    manifestRef: { source: "react", package: leafPackage, path: "", version: pkgVersion ?? null },
+                });
+                return components;
+            }
+            visitedLeafs.set(leafPackage, {
+                components: [],
+                manifestRef: { source: "cem", package: leafPackage, path: "", version: pkgVersion ?? null },
+            });
+            return [];
+        }
+        // Index custom elements by tagName.
+        for (const c of components) {
+            if (c.kind === "custom-element")
+                byTag.set(c.tagName, c);
+        }
+        visitedLeafs.set(leafPackage, {
+            components,
+            manifestRef: {
+                source: manifestSource,
+                package: leafPackage,
+                path: manifestPath,
+                version: pkgVersion ?? null,
+            },
+        });
+        return components;
+    }
+    function findPackageRoot(absFile) {
+        let dir = dirname(absFile);
+        while (dir !== dirname(dir)) {
+            const pkgJson = join(dir, "package.json");
+            if (existsSync(pkgJson)) {
+                try {
+                    const pkg = JSON.parse(readFileSync(pkgJson, "utf8"));
+                    if (pkg.name)
+                        return { name: pkg.name, dir };
+                }
+                catch {
+                    // Continue walking if unreadable.
+                }
+            }
+            dir = dirname(dir);
+        }
+        return null;
+    }
+    function matchInLeaf(components, chainSpecifiers, exportName) {
+        // First pass: explicit imports.react[] match (strongest signal).
+        for (const c of components) {
+            if (c.kind === "custom-element") {
+                const imports = c.imports?.react ?? [];
+                for (const i of imports) {
+                    if (i.export !== exportName)
+                        continue;
+                    // Match if any specifier in the chain equals i.specifier (or stripped form).
+                    const stripped = i.specifier.replace(/\.(js|mjs|cjs)$/, "");
+                    if (chainSpecifiers.some((s) => s === i.specifier || s === stripped))
+                        return c;
+                }
+            }
+            else if (c.kind === "react-component" || c.kind === "vue-component") {
+                if (c.export === exportName)
+                    return c;
+            }
+        }
+        // Second pass: className-equality fallback for CEMs that don't declare
+        // componentCompass.imports.react[]. Scoped to THIS leaf only — never
+        // iterates a global byTag map (the old heuristic's failure mode). Safe
+        // because the resolver has already traversed the chain to a specific
+        // leaf package; if that leaf's CEM declares a custom-element class with
+        // exactly this name, the consumer's import is the React wrapper for it.
+        for (const c of components) {
+            if (c.kind === "custom-element" && c.className === exportName)
+                return c;
+        }
+        return null;
+    }
+    function resolveLazyManifest(fromFile, specifier, exportName) {
+        const initialAbs = resolveImport(fromFile, specifier);
+        if (!initialAbs)
+            return null;
+        // Resolved file lives in the same package as the importer (e.g.
+        // `../components/Foo.vue` from a sibling file in the consumer repo).
+        // The lazy resolver's contract is "external packages are opaque tuples";
+        // local files belong to the local-detection pipeline. Return null so the
+        // parser falls back to classifyImportOrigin / localIndex. Different
+        // package names — whether resolved through node_modules or through a
+        // yarn workspace symlink — are external and continue normal resolution.
+        const fromPkg = findPackageRoot(fromFile);
+        const initialPkg = findPackageRoot(initialAbs);
+        if (fromPkg && initialPkg && fromPkg.name === initialPkg.name) {
+            return null;
+        }
+        const cacheKey = `${initialAbs}::${exportName}`;
+        if (hitCache.has(cacheKey))
+            return hitCache.get(cacheKey) ?? null;
+        const visited = new Set();
+        const chainSpecifiers = [specifier];
+        let currentAbs = initialAbs;
+        let currentExport = exportName;
+        // Walk the re-export chain. If we advance MAX_REEXPORT_HOPS times without
+        // the chain naturally terminating (i.e. the next file would also be a
+        // barrel carrying our export), surface `chain-too-deep` and treat the
+        // current file as terminal so a wrong-leaf attribution is never silent.
+        let hops = 0;
+        while (true) {
+            const visitKey = `${currentAbs}::${currentExport}`;
+            if (visited.has(visitKey)) {
+                const cyclePkg = findPackageRoot(currentAbs)?.name;
+                const entry = { code: "cycle-detected", file: currentAbs, exportName: currentExport };
+                if (cyclePkg !== undefined)
+                    entry.packageName = cyclePkg;
+                diagnostics.push(entry);
+                hitCache.set(cacheKey, null);
+                return null;
+            }
+            visited.add(visitKey);
+            const source = safeReadFile(currentAbs);
+            if (source === null)
+                break;
+            const { reExports, unsupported } = parseBarrelTopLevelDetailed(source);
+            const unsupportedPkg = unsupported.length > 0 ? findPackageRoot(currentAbs)?.name : undefined;
+            for (const u of unsupported) {
+                const entry = { code: "barrel-unsupported-form", file: currentAbs, form: u.form };
+                if (u.line !== undefined)
+                    entry.line = u.line;
+                if (unsupportedPkg !== undefined)
+                    entry.packageName = unsupportedPkg;
+                diagnostics.push(entry);
+            }
+            if (reExports.length === 0)
+                break; // terminal
+            // Find the re-export that carries `currentExport`.
+            const next = pickReExportFor(reExports, currentExport);
+            if (!next)
+                break; // terminal — none of the re-exports carry this export
+            const nextAbs = resolveImport(currentAbs, next.from);
+            if (!nextAbs)
+                break; // unresolvable next hop → treat current as terminal
+            // We're about to advance. If we've already consumed our budget, bail
+            // out with a diagnostic instead. `currentAbs` stays on the last barrel
+            // we successfully read so package-root walk continues from there.
+            if (hops >= MAX_REEXPORT_HOPS) {
+                const deepPkg = findPackageRoot(currentAbs)?.name;
+                const entry = {
+                    code: "chain-too-deep",
+                    file: currentAbs,
+                    exportName: currentExport,
+                    depth: MAX_REEXPORT_HOPS,
+                };
+                if (deepPkg !== undefined)
+                    entry.packageName = deepPkg;
+                diagnostics.push(entry);
+                break;
+            }
+            chainSpecifiers.push(next.from);
+            currentAbs = nextAbs;
+            currentExport = next.targetExport;
+            hops++;
+        }
+        // Walk up to the package root of currentAbs.
+        const pkg = findPackageRoot(currentAbs);
+        if (!pkg) {
+            hitCache.set(cacheKey, null);
+            return null;
+        }
+        const components = loadLeafManifest(pkg.name, pkg.dir);
+        const matched = matchInLeaf(components, chainSpecifiers, currentExport);
+        if (!matched && components.length === 0) {
+            // Untraceable + no manifest at all; surface diagnostic.
+            diagnostics.push({
+                code: "untraceable-barrel",
+                packageName: pkg.name,
+                resolvedFile: currentAbs,
+            });
+        }
+        const hit = { leafPackage: pkg.name, matched };
+        hitCache.set(cacheKey, hit);
+        return hit;
+    }
+    function lookupByTag(tagName) {
+        return byTag.get(tagName) ?? null;
+    }
+    function snapshotComponents() {
+        const out = [];
+        for (const v of visitedLeafs.values())
+            out.push(...v.components);
+        return out;
+    }
+    function snapshotManifestRefs() {
+        const out = [];
+        for (const v of visitedLeafs.values()) {
+            if (v.manifestRef.path)
+                out.push(v.manifestRef);
+        }
+        return out;
+    }
+    function warmRoots(packageNames) {
+        // Anchor at <repoRoot>/_ so Node's resolution walks up through
+        // <repoRoot>/node_modules and parents, mirroring resolve-import.ts.
+        const anchor = pathResolve(opts.repoRoot ?? process.cwd(), "_");
+        const requireFromRepo = createRequire(anchor);
+        for (const name of packageNames) {
+            if (visitedLeafs.has(name))
+                continue;
+            try {
+                const pkgJsonPath = requireFromRepo.resolve(`${name}/package.json`);
+                loadLeafManifest(name, dirname(pkgJsonPath));
+            }
+            catch {
+                // Package not installed or its package.json not exposed via exports —
+                // skip silently. Warm-up is best-effort; missing entries are fine.
+            }
+        }
+    }
+    return {
+        resolveLazyManifest,
+        lookupByTag,
+        snapshotComponents,
+        snapshotManifestRefs,
+        diagnostics: () => diagnostics,
+        warmRoots,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function safeReadFile(path) {
+    try {
+        if (!statSync(path).isFile())
+            return null;
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function pickReExportFor(reExports, exportName) {
+    // Named re-export carrying our export wins over star re-exports.
+    for (const re of reExports) {
+        if (re.kind === "named") {
+            const found = re.names.find((n) => n.exported === exportName);
+            if (found)
+                return { from: re.from, targetExport: found.local };
+        }
+    }
+    // Star re-export: any star may carry the export; resolver tries the first
+    // and its terminal will tell us whether the leaf has it. v1 picks the first
+    // star — multi-star ambiguity in the same file is rare and a `barrel-
+    // unsupported-form` diagnostic could be added in a patch if real cases
+    // surface.
+    for (const re of reExports) {
+        if (re.kind === "star")
+            return { from: re.from, targetExport: exportName };
+    }
+    return null;
+}
+function absorbCemDeclarations(cem, packageName) {
+    const out = [];
+    for (const mod of cem.modules ?? []) {
+        for (const decl of mod.declarations ?? []) {
+            const d = decl;
+            if (!d.customElement || !d.tagName || !d.name)
+                continue;
+            const props = [];
+            for (const mem of d.members ?? []) {
+                if (mem.kind !== "field" || mem.privacy === "private")
+                    continue;
+                if (!mem.name)
+                    continue;
+                const p = { name: mem.name };
+                if (mem.type?.text !== undefined)
+                    p.type = mem.type.text;
+                if (mem.deprecated !== undefined)
+                    p.deprecated = mem.deprecated;
+                props.push(p);
+            }
+            const events = [];
+            for (const e of d.events ?? []) {
+                if (!e.name)
+                    continue;
+                const ev = { name: e.name };
+                if (e.deprecated !== undefined)
+                    ev.deprecated = e.deprecated;
+                events.push(ev);
+            }
+            out.push({
+                kind: "custom-element",
+                tagName: d.tagName,
+                source: { type: "external", package: packageName },
+                deprecated: d.deprecated ?? false,
+                props,
+                events,
+                slots: (d.slots ?? []).map((s) => ({ name: s.name ?? "" })),
+                className: d.name,
+                imports: d.componentCompass?.imports ?? {},
+            });
+        }
+    }
+    return out;
+}
+function absorbCcmComponents(manifest, packageName) {
+    const out = [];
+    for (const c of manifest.components) {
+        if (c.kind === "custom-element")
+            continue;
+        if (c.kind !== "react-component" && c.kind !== "vue-component")
+            continue;
+        if (!c.export)
+            continue;
+        const externalSrc = { type: "external", package: packageName };
+        out.push({
+            kind: c.kind,
+            export: c.export,
+            source: externalSrc,
+            deprecated: c.deprecated ?? false,
+            props: (c.props ?? []).map((p) => ({ name: p.name })),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=lazy-resolver.js.map

package/dist/manifest/lazy-resolver.js.map

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

package/dist/occurrences.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Project parser-emitted occurrences onto the artifact-shape OutputOccurrence
+ * stream, preserving the three-state attribute model:
+ *   - literal value (when captureValues is true and source value was static),
+ *   - { __dynamic: DynamicKind } marker (always, when source was non-literal),
+ *   - null (when captureValues is false and source was static, OR when source
+ *     value was literal null).
+ *
+ * Phase 2: also resolves parser-side `parentRef` (intra-ParseResult occurrence
+ * index) into artifact-side `parentOccurrenceId` + `parentComponentId` strings,
+ * and carries through `depth`. Parent resolution stays scoped to one
+ * ParseResult — cross-file composition is not tracked.
+ *
+ * Pure function; no I/O.
+ */
+import { type OutputOccurrence, type ParseResult } from "@component-compass/plugin-core";
+export declare function parseResultsToOccurrences(results: ParseResult[], captureValues: boolean): OutputOccurrence[];

package/dist/occurrences.js

@@ -0,0 +1,73 @@
+/**
+ * Project parser-emitted occurrences onto the artifact-shape OutputOccurrence
+ * stream, preserving the three-state attribute model:
+ *   - literal value (when captureValues is true and source value was static),
+ *   - { __dynamic: DynamicKind } marker (always, when source was non-literal),
+ *   - null (when captureValues is false and source was static, OR when source
+ *     value was literal null).
+ *
+ * Phase 2: also resolves parser-side `parentRef` (intra-ParseResult occurrence
+ * index) into artifact-side `parentOccurrenceId` + `parentComponentId` strings,
+ * and carries through `depth`. Parent resolution stays scoped to one
+ * ParseResult — cross-file composition is not tracked.
+ *
+ * Pure function; no I/O.
+ */
+import { computeOccurrenceId, } from "@component-compass/plugin-core";
+import { computeStableIdFromComponentId } from "./identity.js";
+export function parseResultsToOccurrences(results, captureValues) {
+    const out = [];
+    for (const result of results) {
+        // First pass: compute (final componentId hash, occurrenceId) for every
+        // parser-emitted occurrence in THIS ParseResult. Indexes align with
+        // result.occurrences, so parentRef indices resolve correctly in pass two.
+        const computed = result.occurrences.map((occ) => {
+            const componentId = computeStableIdFromComponentId(occ.componentId);
+            const occurrenceId = computeOccurrenceId(componentId, occ.loc.file, occ.loc.line, occ.loc.column);
+            return { componentId, occurrenceId };
+        });
+        // Second pass: project to OutputOccurrence, resolving parentRef.
+        for (let i = 0; i < result.occurrences.length; i++) {
+            const occ = result.occurrences[i];
+            const meta = computed[i];
+            if (!occ || !meta)
+                continue;
+            const { componentId, occurrenceId } = meta;
+            const props = {};
+            for (const p of occ.props) {
+                if (p.isDynamic) {
+                    // dynamicKind should always be set when isDynamic is true (per
+                    // scan-types.ts), but defend against malformed parser output.
+                    props[p.name] = { __dynamic: p.dynamicKind ?? "expr" };
+                }
+                else if (captureValues && p.literalValue !== undefined) {
+                    props[p.name] = p.literalValue;
+                }
+                else {
+                    props[p.name] = null;
+                }
+            }
+            const output = {
+                componentId,
+                filePath: occ.loc.file,
+                line: occ.loc.line,
+                column: occ.loc.column,
+                via: occ.via,
+                props,
+                occurrenceId,
+            };
+            if (occ.parentRef !== undefined) {
+                const parent = computed[occ.parentRef];
+                if (parent) {
+                    output.parentOccurrenceId = parent.occurrenceId;
+                    output.parentComponentId = parent.componentId;
+                }
+            }
+            if (occ.depth !== undefined)
+                output.depth = occ.depth;
+            out.push(output);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=occurrences.js.map

package/dist/occurrences.js.map

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

package/dist/reporter/index.d.ts

@@ -7,9 +7,32 @@
  *
  * It does no IO; downstream JSON / stdout reporters consume the result.
  */
-import type { ManifestComponent, OutputManifest, OutputOccurrence, ScanEnvelope, ScanOutput } from "@component-compass/plugin-core";
+import type { ManifestComponent, ManifestRef, OutputManifest, OutputOccurrence, ScanEnvelope, ScanOutput, ScanStats } from "@component-compass/plugin-core";
 import { type ComponentSeed } from "../rollup.js";
-export declare function buildScanOutput(envelope: ScanEnvelope, seeds: ComponentSeed[], occurrences: OutputOccurrence[]): ScanOutput;
+export type PartialScanStats = Pick<ScanStats, "filesScanned" | "filesWithUsage" | "scanDurationMs">;
+/**
+ * Builds the two-grain `ScanOutput` from the per-component seeds and the
+ * flat occurrence stream. When `packageScopes` is non-empty the emitter
+ * applies a final filter: components whose `identity.packageName` matches
+ * no scope pattern are dropped, along with every occurrence pointing at
+ * them. Local components always pass — `packageScopes` only constrains
+ * the external/ds lanes. An empty `packageScopes` array short-circuits
+ * the filter (visibility-first: emit everything).
+ *
+ * Pipeline order: rollup → composition → scope filter.
+ *
+ * Composition runs BEFORE the scope filter so cross-component parent
+ * counts are computed against the full occurrence graph. The scope
+ * filter then drops out-of-scope components, their occurrences, and —
+ * by transitive consequence — their composition rollup. Running
+ * composition AFTER the filter would let a child's `parentComponentId`
+ * point at a dropped component, leaving a dangling reference in the
+ * artifact.
+ *
+ * The filter runs AFTER rollup so the per-component stats already reflect
+ * the data the consumer will see in the artifact.
+ */
+export declare function buildScanOutput(envelope: ScanEnvelope, manifests: ManifestRef[], partialStats: PartialScanStats, seeds: ComponentSeed[], occurrences: OutputOccurrence[], packageScopes: string[]): ScanOutput;
 /**
  * Pure converter: project a rich `ManifestComponent` (plugin-core domain
  * model) onto the artifact-shape `OutputManifest` consumed by the JSON
@@ -21,4 +44,4 @@ export declare function buildScanOutput(envelope: ScanEnvelope, seeds: Component
  * Returns `null` when no manifest entry was matched for the component, so
  * downstream `OutputComponent.manifest` can be set directly.
  */
-export declare function manifestComponentToOutput(m: ManifestComponent | undefined): OutputManifest | null;
+export declare function manifestComponentToOutput(m: ManifestComponent | undefined, source: "authored" | "derived"): OutputManifest | null;

package/dist/reporter/index.js

@@ -7,14 +7,77 @@
  *
  * It does no IO; downstream JSON / stdout reporters consume the result.
  */
+import picomatch from "picomatch";
+import { applyCompositionRollup } from "../composition-rollup.js";
 import { rollupOccurrencesToComponents } from "../rollup.js";
-export function buildScanOutput(envelope, seeds, occurrences) {
+/**
+ * Builds the two-grain `ScanOutput` from the per-component seeds and the
+ * flat occurrence stream. When `packageScopes` is non-empty the emitter
+ * applies a final filter: components whose `identity.packageName` matches
+ * no scope pattern are dropped, along with every occurrence pointing at
+ * them. Local components always pass — `packageScopes` only constrains
+ * the external/ds lanes. An empty `packageScopes` array short-circuits
+ * the filter (visibility-first: emit everything).
+ *
+ * Pipeline order: rollup → composition → scope filter.
+ *
+ * Composition runs BEFORE the scope filter so cross-component parent
+ * counts are computed against the full occurrence graph. The scope
+ * filter then drops out-of-scope components, their occurrences, and —
+ * by transitive consequence — their composition rollup. Running
+ * composition AFTER the filter would let a child's `parentComponentId`
+ * point at a dropped component, leaving a dangling reference in the
+ * artifact.
+ *
+ * The filter runs AFTER rollup so the per-component stats already reflect
+ * the data the consumer will see in the artifact.
+ */
+export function buildScanOutput(envelope, manifests, partialStats, seeds, occurrences, packageScopes) {
+    const rolled = rollupOccurrencesToComponents(occurrences, seeds);
+    const withComposition = applyCompositionRollup(rolled, occurrences);
+    const filtered = applyScopeFilter(withComposition, occurrences, packageScopes);
+    const stats = {
+        ...partialStats,
+        componentsDetected: filtered.components.length,
+        totalOccurrences: filtered.occurrences.length,
+    };
     return {
         envelope,
-        components: rollupOccurrencesToComponents(occurrences, seeds),
-        occurrences,
+        manifests,
+        stats,
+        components: filtered.components,
+        occurrences: filtered.occurrences,
     };
 }
+/**
+ * Drops components whose `identity.packageName` matches none of the scope
+ * patterns and every occurrence pointing at a dropped component. Local
+ * components always pass (their `identity.scope === "local"` and they
+ * have no `packageName` to match).
+ *
+ * Empty `packageScopes` is the explicit "no filter" signal — the function
+ * returns the inputs untouched (visibility-first emit).
+ */
+function applyScopeFilter(components, occurrences, packageScopes) {
+    if (packageScopes.length === 0)
+        return { components, occurrences };
+    const matchers = packageScopes.map((p) => picomatch(p));
+    const allowedIds = new Set();
+    const allowedComponents = components.filter((c) => {
+        if (c.identity.scope === "local") {
+            allowedIds.add(c.id);
+            return true;
+        }
+        const pkg = c.identity.packageName ?? "";
+        if (matchers.some((m) => m(pkg))) {
+            allowedIds.add(c.id);
+            return true;
+        }
+        return false;
+    });
+    const allowedOccurrences = occurrences.filter((o) => allowedIds.has(o.componentId));
+    return { components: allowedComponents, occurrences: allowedOccurrences };
+}
 /**
  * Pure converter: project a rich `ManifestComponent` (plugin-core domain
  * model) onto the artifact-shape `OutputManifest` consumed by the JSON
@@ -26,7 +89,7 @@ export function buildScanOutput(envelope, seeds, occurrences) {
  * Returns `null` when no manifest entry was matched for the component, so
  * downstream `OutputComponent.manifest` can be set directly.
  */
-export function manifestComponentToOutput(m) {
+export function manifestComponentToOutput(m, source) {
     if (!m)
         return null;
     const props = {};
@@ -34,7 +97,7 @@ export function manifestComponentToOutput(m) {
         if (p.default !== undefined)
             props[p.name] = { default: p.default };
     }
-    const out = { props };
+    const out = { source, props };
     if (m.lifecycle !== undefined)
         out.lifecycle = m.lifecycle;
     return out;