@component-compass/plugin-core 0.0.3 → 0.0.5

package/dist/diagnostic.d.ts

@@ -28,18 +28,6 @@ export type Diagnostic = {
     filePath: string;
     tagName: string;
     conflictsWith: string;
-} | {
-    code: "barrel-unsupported-form";
-    severity: "info";
-    filePath: string;
-    form: string;
-    line?: number;
-    packageName?: string;
-} | {
-    code: "untraceable-barrel";
-    severity: "info";
-    packageName: string;
-    resolvedFile: string;
 } | {
     code: "cycle-detected";
     severity: "warning";
@@ -53,12 +41,6 @@ export type Diagnostic = {
     exportName: string;
     depth: number;
     packageName?: string;
-} | {
-    code: "no-deps-match-scopes";
-    severity: "info";
-    packageScopes: readonly string[];
-    packageManager: "yarn" | "npm" | "pnpm" | "unknown";
-    workspacePackageCount: number;
 };
 export interface DiagnosticCollector {
     emit(d: Diagnostic): void;

package/dist/diagnostic.js

@@ -16,14 +16,12 @@ function assertUnreachable(x) {
  * (e.g. file + line, or package + resolvedFile) — not the severity or
  * descriptive `detail`/`form` fields.
  *
- * Note on `packageName` omission: for `barrel-unsupported-form`,
- * `cycle-detected`, and `chain-too-deep`, the diagnostic describes a property
- * of the barrel/re-export (file, line, exportName), not the consumer package
- * that triggered resolution. Including `packageName` (which is the consumer's
- * package) would un-dedup based on consumer attribution and re-introduce the
- * noise pattern this collector exists to suppress (GH issue #12). For
- * `untraceable-barrel`, `packageName` IS included — it's the barrel's own
- * package name there, part of the observation identity.
+ * Note on `packageName` omission: for `cycle-detected` and `chain-too-deep`,
+ * the diagnostic describes a property of the barrel/re-export (file,
+ * exportName), not the consumer package that triggered resolution. Including
+ * `packageName` (which is the consumer's package) would un-dedup based on
+ * consumer attribution and re-introduce the noise pattern this collector
+ * exists to suppress (GH issue #12).
  */
 function dedupKey(d) {
     switch (d.code) {
@@ -33,16 +31,10 @@ function dedupKey(d) {
             return `${d.code}::${d.filePath}::${d.line ?? ""}::${d.column ?? ""}::${d.tagName}`;
         case "local-index-duplicate-tag":
             return `${d.code}::${d.filePath}::${d.tagName}`;
-        case "barrel-unsupported-form":
-            return `${d.code}::${d.filePath}::${d.line ?? ""}::${d.form}`;
-        case "untraceable-barrel":
-            return `${d.code}::${d.packageName}::${d.resolvedFile}`;
         case "cycle-detected":
             return `${d.code}::${d.filePath}::${d.exportName}`;
         case "chain-too-deep":
             return `${d.code}::${d.filePath}::${d.exportName}`;
-        case "no-deps-match-scopes":
-            return `${d.code}::${d.packageScopes.join(",")}::${d.packageManager}`;
         default:
             return assertUnreachable(d);
     }

package/dist/diagnostic.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2EH,SAAS,iBAAiB,CAAC,CAAQ;IACjC,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,QAAQ,CAAC,CAAa;IAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,uBAAuB;YAC1B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvF,KAAK,wBAAwB;YAC3B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACtF,KAAK,2BAA2B;YAC9B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAClD,KAAK,yBAAyB;YAC5B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,KAAK,oBAAoB;YACvB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC;QAC1D,KAAK,gBAAgB;YACnB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QACrD,KAAK,gBAAgB;YACnB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QACrD,KAAK,sBAAsB;YACzB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC;QACxE;YACE,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAID,MAAM,UAAU,yBAAyB;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,OAAO;QACL,IAAI,CAAC,CAAC;YACJ,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqDH,SAAS,iBAAiB,CAAC,CAAQ;IACjC,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,QAAQ,CAAC,CAAa;IAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,uBAAuB;YAC1B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvF,KAAK,wBAAwB;YAC3B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACtF,KAAK,2BAA2B;YAC9B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAClD,KAAK,gBAAgB;YACnB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QACrD,KAAK,gBAAgB;YACnB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QACrD;YACE,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAID,MAAM,UAAU,yBAAyB;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,OAAO;QACL,IAAI,CAAC,CAAC;YACJ,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -4,9 +4,10 @@ export { validateManifest } from "./validate.js";
 export type { ValidationResult } from "./validate.js";
 export { manifestJsonSchema } from "./schema.js";
 export { ManifestBuilder } from "./builder.js";
-export type { TagName, WrapperId, ImportRole, ImportEntry, IndexedComponent, Loc, WarningCode, Warning, ScanConfig, PropUsage, OccurrenceVia, Occurrence, WrapperDef, FileImport, ParseResult, ParseContext, ParserPlugin, ScanEnvelope, ScanOutput, ManifestRef, ScanStats, DetectorId, LocalDefinition, LocalDefinitionIndex, ResolveLazyManifest, LookupByTag, LazyResolverHit, } from "./scan-types.js";
+export type { TagName, WrapperId, ImportRole, ImportEntry, IndexedComponent, Loc, WarningCode, Warning, ScanConfig, PropUsage, OccurrenceVia, Occurrence, WrapperDef, FileImport, ParseResult, ParseContext, ParserPlugin, ScanOutput, ManifestRef, ScanStats, DetectorId, LocalDefinition, LocalDefinitionIndex, ResolveLazyManifest, LookupByTag, LazyResolverHit, CemIndex, CemIndexEntry, } from "./scan-types.js";
 export { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
 export type { Enrichment, AuthoredLeafPayload, DerivedLeafPayload } from "./enrichment.js";
+export { normalizeOwnerPath } from "./owner-utils.js";
 export { computeOccurrenceId } from "./occurrence-id.js";
 export type { CompositionRollup } from "./output-types.js";
 export * from "./output-types.js";

package/dist/index.js

@@ -3,6 +3,7 @@ export { validateManifest } from "./validate.js";
 export { manifestJsonSchema } from "./schema.js";
 export { ManifestBuilder } from "./builder.js";
 export { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
+export { normalizeOwnerPath } from "./owner-utils.js";
 export { computeOccurrenceId } from "./occurrence-id.js";
 export * from "./output-types.js";
 export { createDiagnosticCollector } from "./diagnostic.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAc/C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAI1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAe/C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAI1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/output-types.d.ts

@@ -5,7 +5,7 @@
  */
 import type { OccurrenceVia } from "./via-types.js";
 import type { Lifecycle } from "./types.js";
-export type ComponentScope = "ds" | "external" | "local";
+export type ComponentScope = "external" | "local";
 export type ComponentKindOutput = "custom-element" | "react-component" | "vue-component";
 export type OutputIdentity = {
     scope: ComponentScope;
@@ -16,6 +16,15 @@ export type OutputIdentity = {
      * one. Absent for root-level local files (non-workspace single-package repos).
      */
     packageName?: string;
+    /**
+     * For resolver-driven external identities: the file Node's import resolution
+     * (and any further chain walking) landed on, relative to the leaf package
+     * root, POSIX-normalised. Disambiguates distinct components reached via
+     * different subpaths of the same package. Absent for byTag-driven external
+     * identities (which disambiguate via `tagName` alone) and for local identities
+     * (which use `filePath` instead).
+     */
+    modulePath?: string;
     /** For react-component / vue-component. */
     exportName?: string;
     /** For custom-element. */
@@ -106,7 +115,6 @@ export type CompositionRollup = {
 export type OutputComponent = {
     id: string;
     identity: OutputIdentity;
-    derivedTags: string[];
     manifest: {
         source: "authored";
         data: AuthoredManifestData;
@@ -121,6 +129,14 @@ export type OutputComponent = {
     props: Record<string, PropDistribution>;
     /** Per-component composition rollup (owner-edge driven). Always emitted. */
     composition?: CompositionRollup;
+    /** Package version from package.json or CEM. Null for external packages not versioned at scan time. */
+    version: string | null;
+    /** Deprecation flag from CEM @deprecated declaration. False if the component's CEM declaration does not carry `@deprecated`; CEM declarations on external packages flow through to this field. */
+    deprecated: boolean;
+    /** Git-mtime: first commit of the declaring file. ISO 8601 string, or null for external packages. */
+    createdAt: string | null;
+    /** Git-mtime: last commit of the declaring file. ISO 8601 string, or null for external packages. */
+    updatedAt: string | null;
 };
 export type OutputOccurrence = {
     componentId: string;
@@ -143,3 +159,38 @@ export type OutputOccurrence = {
      */
     ownerComponentId?: string;
 };
+/**
+ * Top-level metadata block in the scan artifact.
+ * Captures repo identity, git state, and scan timing for cross-scan joins and provenance.
+ */
+export type ScanMeta = {
+    /** CC version that created this artifact. */
+    ccVersion: string;
+    /** ULID generated once per scan. Unique across scans; stable within a single run. */
+    scanId: string;
+    /** ISO 8601 timestamp of the scan. */
+    scannedAt: string;
+    /** Repository identification and git state. */
+    repo: {
+        /** Stable repo identifier: git remote basename, config override, or working-directory basename. */
+        id: string;
+        /** Git remote URL (or null if not configured). For provenance tracking. */
+        gitRemote: string | null;
+        /** Current HEAD commit SHA. */
+        commit: string;
+        /** First commit SHA in the repo history. Stable across force-pushes and rebases. Null on shallow clones where git rev-list --max-parents=0 is unavailable. */
+        initialCommit: string | null;
+        /** Current branch name, or null for detached HEAD / shallow clones where branch is unavailable. */
+        branch: string | null;
+    };
+};
+/**
+ * The complete scan artifact shape produced by the CLI.
+ * Two-grain structure: components (rolled-up identity + manifest + composition) +
+ * occurrences (per call-site, linked to components by id).
+ */
+export type ScanArtifact = {
+    meta: ScanMeta;
+    components: OutputComponent[];
+    occurrences: OutputOccurrence[];
+};

package/dist/owner-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Normalize a file path to the form used as keys in `LocalDefinitionIndex.byPath`.
+ *
+ * Parsers receive absolute paths from oxc; the local-index stores
+ * repo-root-relative POSIX paths. Shared helper to prevent path-normalisation
+ * drift in owner-resolution code paths across parsers.
+ *
+ * No-op for already-relative paths beyond backslash → forward-slash conversion.
+ */
+export declare function normalizeOwnerPath(file: string, repoRoot?: string): string;

package/dist/owner-utils.js

@@ -0,0 +1,16 @@
+import { relative, isAbsolute } from "node:path";
+/**
+ * Normalize a file path to the form used as keys in `LocalDefinitionIndex.byPath`.
+ *
+ * Parsers receive absolute paths from oxc; the local-index stores
+ * repo-root-relative POSIX paths. Shared helper to prevent path-normalisation
+ * drift in owner-resolution code paths across parsers.
+ *
+ * No-op for already-relative paths beyond backslash → forward-slash conversion.
+ */
+export function normalizeOwnerPath(file, repoRoot) {
+    if (!repoRoot || !isAbsolute(file))
+        return file.replace(/\\/g, "/");
+    return relative(repoRoot, file).replace(/\\/g, "/");
+}
+//# sourceMappingURL=owner-utils.js.map

package/dist/owner-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-utils.js","sourceRoot":"","sources":["../src/owner-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAAiB;IAChE,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/scan-types.d.ts

@@ -5,7 +5,7 @@
  * depend on the CLI package (circular), so every type that crosses the
  * parser ↔ CLI boundary lives here in `plugin-core`.
  */
-import type { OutputComponent, OutputOccurrence } from "./output-types.js";
+import type { OutputComponent, OutputOccurrence, ScanMeta } from "./output-types.js";
 import type { Diagnostic, DiagnosticCollector } from "./diagnostic.js";
 import type { ComponentId, ManifestComponent, ManifestSource } from "./types.js";
 import type { OccurrenceVia } from "./via-types.js";
@@ -18,6 +18,24 @@ export type WrapperId = Brand<string, "WrapperId">;
 /** Unsafe constructors — use only at the data-ingest boundary. */
 export declare const asTagName: (s: string) => TagName;
 export declare const asWrapperId: (s: string) => WrapperId;
+export type CemIndexEntry = {
+    packageName: string;
+    manifest: unknown;
+};
+/**
+ * Structural interface for the global CEM index built by `buildCemIndex` in
+ * the CLI. Defined here as a structural type (not importing from CLI) so
+ * parsers can reference it without creating a circular dependency.
+ *
+ * The actual `CemIndex` implementation lives in
+ * `packages/cli/src/scan/cem-index.ts` and satisfies this interface.
+ */
+export type CemIndex = {
+    byTag: Map<string, CemIndexEntry>;
+    byPackageName: Map<string, {
+        manifest: unknown;
+    }>;
+};
 export type ImportRole = "native" | "react";
 export type ImportEntry = {
     specifier: string;
@@ -40,6 +58,8 @@ export type IndexedComponent = (Extract<ManifestComponent, {
  */
 export type LazyResolverHit = {
     leafPackage: string;
+    /** Terminal file's path relative to the leaf package root, POSIX-normalised. */
+    modulePath: string;
     matched: IndexedComponent | null;
 };
 export type ResolveLazyManifest = (fromFile: string, specifier: string, exportName: string) => LazyResolverHit | null;
@@ -98,7 +118,6 @@ export type Warning = (WarningBase & {
  * parsers decoupled from CLI-specific fields (configPath, output, etc.).
  */
 export type ScanConfig = {
-    packageScopes: string[];
     captureValues: boolean;
 };
 export type PropUsage = {
@@ -138,10 +157,28 @@ export type Occurrence = {
      */
     depth?: number;
     /**
-     * ComponentId of the enclosing component-definition. Resolved by parsers
-     * via ancestor walk. The CLI projection layer hashes this into
-     * `OutputOccurrence.ownerComponentId`. Undefined when no enclosing tracked
-     * component was found.
+     * Identity of the Component definition that owns this Occurrence (i.e.
+     * lexically encloses it in source). Resolved by parsers via ancestor walk.
+     * The CLI projection layer (Assemble) hashes this into
+     * `OutputOccurrence.ownerComponentId` and drives the composition rollup.
+     *
+     * Convention for parsers that emit `ownerComponentId`:
+     *   - Absent (undefined) ⇒ Occurrence is a "root" — no enclosing Component
+     *     owns it. Composition rollup counts these in `isRootCount`.
+     *   - Present ⇒ MUST be an Identity that matches a Local definition produced
+     *     by the corresponding `detect-*.ts` for that file. Mismatch causes the
+     *     composition rollup's id-equality check to drop the edge silently.
+     *   - Parsers MUST NOT emit a sentinel value (e.g. "root", null-stringified)
+     *     in this field. Absence is the signal.
+     *
+     * Per-language framing:
+     *   - parser-vue:   owner = enclosing SFC's vue-component Identity.
+     *   - parser-react: owner = nearest enclosing function/class Component binding.
+     *   - parser-lit (planned, #76): owner = enclosing @customElement class Identity.
+     *   - parser-html:  no owner; HTML files are not Component definitions.
+     *
+     * Path-based identity resolution must use `normalizeOwnerPath` (from
+     * `@component-compass/plugin-core`) to match local-index keys.
      */
     ownerComponentId?: ComponentId;
 };
@@ -175,24 +212,32 @@ export type ParseContext = {
     repoRoot: string;
     /** Shared diagnostic collector for the scan run. */
     collector?: DiagnosticCollector;
+    /**
+     * Pre-parsed AST for the file. Provided by scan.ts when the single-pass
+     * pipeline is active. The type is intentionally `unknown` here — concrete
+     * narrowing is plugin-specific. Plugin-core stays free of parser-library deps.
+     *
+     * For babel-family files (.tsx/.ts/.jsx/.js): oxc Program.
+     * For .vue: VueParseWrapper (descriptor + optional scriptProgram).
+     * For .html: parse5 Document.
+     */
+    ast?: unknown;
+    /**
+     * Global CEM index built once at scan startup. Maps hyphenated tag names
+     * and package names to their manifest entries, enabling parsers to resolve
+     * tags like `<pie-link>` unconditionally.
+     * Provided by scan.ts; parsers consume it.
+     */
+    cemIndex?: CemIndex;
 };
 export interface ParserPlugin {
     name: string;
     extensions: string[];
     parse(file: string, source: string, ctx: ParseContext): ParseResult;
 }
-export type ScanEnvelope = {
-    scanId: string;
-    repoId: string;
-    commitSha: string | null;
-    branch: string | null;
-    timestamp: string;
-    toolVersion: string;
-    cwd: string;
-};
 export type ManifestRef = {
     source: ManifestSource;
-    package: string;
+    packageName: string;
     path: string;
     version: string | null;
 };
@@ -204,7 +249,7 @@ export type ScanStats = {
     totalOccurrences: number;
 };
 export type ScanOutput = {
-    envelope: ScanEnvelope;
+    meta: ScanMeta;
     manifests: ManifestRef[];
     stats: ScanStats;
     components: OutputComponent[];

package/dist/scan-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"scan-types.js","sourceRoot":"","sources":["../src/scan-types.ts"],"names":[],"mappings":"AAsBA,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAa,EAAE,CAAC,CAAc,CAAC;AAsFpE,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,KAAK,EAAE,IAAI,GAAG,EAAE;CACjB,CAAC"}
+{"version":3,"file":"scan-types.js","sourceRoot":"","sources":["../src/scan-types.ts"],"names":[],"mappings":"AAsBA,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAa,EAAE,CAAC,CAAc,CAAC;AA2GpE,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,KAAK,EAAE,IAAI,GAAG,EAAE;CACjB,CAAC"}

package/dist/schema.js

@@ -1,4 +1,3 @@
-// biome-ignore lint/suspicious/noThenProperty: JSON Schema if/then for source⇄kind validation
 export const manifestJsonSchema = {
     $id: "https://component-compass.dev/manifest-2.0.0.json",
     type: "object",

package/dist/schema.js.map

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

package/dist/types.d.ts

@@ -2,6 +2,7 @@ export type ComponentKind = "custom-element" | "react-component" | "vue-componen
 export type ComponentSource = {
     type: "external";
     package: string;
+    modulePath?: string;
 } | {
     type: "local";
     filePath: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@component-compass/plugin-core",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",