@component-compass/plugin-core 0.1.23 → 0.1.28

package/dist/diagnostic.d.ts

@@ -7,26 +7,6 @@
  */
 export type DiagnosticSeverity = "info" | "warning";
 export type Diagnostic = {
-    code: "low-confidence-tag";
-    severity: "info";
-    filePath: string;
-    line?: number;
-    column?: number;
-    tagName: string;
-} | {
-    code: "local-index-duplicate-tag";
-    severity: "warning";
-    filePath: string;
-    tagName: string;
-    conflictsWith: string;
-} | {
-    code: "unresolved-import";
-    severity: "warning";
-    filePath: string;
-    line: number;
-    column: number;
-    specifier: string;
-} | {
     code: "lazy-import-unsupported";
     severity: "warning";
     filePath: string;
@@ -34,13 +14,6 @@ export type Diagnostic = {
     column: number;
     specifier: string;
     detail: string;
-} | {
-    code: "unresolved-component-tag";
-    severity: "warning";
-    filePath: string;
-    line?: number;
-    column?: number;
-    tagName: string;
 } | {
     code: "auto-import-stale-entry";
     severity: "warning";
@@ -60,6 +33,14 @@ export type Diagnostic = {
     column: number;
     symbol: string;
     memberChain: string[];
+} | {
+    code: "late-bound-render";
+    severity: "info";
+    filePath: string;
+    line: number;
+    column: number;
+    symbol: string;
+    memberChain: string[];
 } | {
     code: "cycle-detected";
     severity: "warning";
@@ -73,6 +54,13 @@ export type Diagnostic = {
     exportName: string;
     depth: number;
     packageName?: string;
+} | {
+    code: "dependency-not-installed";
+    severity: "warning";
+    packageName: string;
+    occurrenceCount: number;
+    /** Repository-relative path of the package.json that declares the package. */
+    declaredIn: string;
 };
 export interface DiagnosticCollector {
     emit(d: Diagnostic): void;

package/dist/diagnostic.js

@@ -25,26 +25,22 @@ function assertUnreachable(x) {
  */
 function dedupKey(d) {
     switch (d.code) {
-        case "low-confidence-tag":
-            return `${d.code}::${d.filePath}::${d.line ?? ""}::${d.column ?? ""}::${d.tagName}`;
-        case "local-index-duplicate-tag":
-            return `${d.code}::${d.filePath}::${d.tagName}`;
-        case "unresolved-import":
-            return `${d.code}::${d.filePath}::${d.line}::${d.column}::${d.specifier}`;
         case "lazy-import-unsupported":
             return `${d.code}::${d.filePath}::${d.line}::${d.column}::${d.specifier}`;
-        case "unresolved-component-tag":
-            return `${d.code}::${d.filePath}::${d.line ?? ""}::${d.column ?? ""}::${d.tagName}`;
         case "auto-import-stale-entry":
             return `${d.code}::${d.componentName}::${d.target}`;
         case "auto-import-manifest-missing":
             return `${d.code}::${d.filePath}`;
         case "unresolved-reference":
             return `${d.code}::${d.filePath}::${d.line}::${d.column}::${d.symbol}::${d.memberChain.join(".")}`;
+        case "late-bound-render":
+            return `${d.code}::${d.filePath}::${d.line}::${d.column}::${d.symbol}::${d.memberChain.join(".")}`;
         case "cycle-detected":
             return `${d.code}::${d.filePath}::${d.exportName}`;
         case "chain-too-deep":
             return `${d.code}::${d.filePath}::${d.exportName}`;
+        case "dependency-not-installed":
+            return `${d.code}::${d.packageName}`;
         default:
             return assertUnreachable(d);
     }

package/dist/diagnostic.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiFH,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,yBAAyB;YAC5B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;QAC5E,KAAK,yBAAyB;YAC5B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QACtD,KAAK,8BAA8B;YACjC,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QACpC,KAAK,sBAAsB;YACzB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrG,KAAK,mBAAmB;YACtB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrG,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,0BAA0B;YAC7B,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC;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

@@ -1,19 +1,11 @@
-export type { ComponentId, ComponentKind, ComponentSource, Lifecycle, ManifestComponent, ManifestEvent, ManifestFile, ManifestProp, ManifestSlot, ManifestSource, } from "./types.js";
+export type { ComponentId, ComponentKind, ComponentSource } from "./types.js";
 export { serialiseComponentId, compareComponentId, externalPackageOf, parseCompoundExport } from "./id.js";
-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, IndexedComponent, Loc, WarningCode, Warning, ScanConfig, PropUsage, OccurrenceVia, Occurrence, WrapperDef, FileImport, ParseResult, ParseContext, ParserPlugin, ScanOutput, ManifestRef, ScanStats, DetectorId, LocalDefinition, LocalDefinitionIndex, ResolveLazyManifest, ResolveLocalExport, LookupByTag, LazyResolverHit, CemIndex, CemIndexEntry, } from "./scan-types.js";
-export { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
-export type { Enrichment, AuthoredLeafPayload } from "./enrichment.js";
+export type { TagName, Loc, Warning, PropUsage, Occurrence, FileImport, ParseResult, ParseContext, ParserPlugin, DetectorId, LocalDefinition, LocalDefinitionIndex, ResolveLocalExport, } from "./scan-types.js";
+export { asTagName, emptyLocalIndex } from "./scan-types.js";
 export { normalizeOwnerPath } from "./owner-utils.js";
 export { posixPath } from "./posix.js";
-export { logicalKeyFor, hashLogicalKey, computeLogicalId } from "./logical-id.js";
 export { computeOccurrenceId } from "./occurrence-id.js";
 export { projectPropUsages, classifyExprText } from "./project-props.js";
-export type { CompositionRollup, DeclaredProp, DeclaredPropApi } from "./output-types.js";
-export * from "./output-types.js";
 export type { Diagnostic, DiagnosticSeverity, DiagnosticCollector, DiagnosticCode } from "./diagnostic.js";
 export { createDiagnosticCollector } from "./diagnostic.js";
 export type { ResolveImport } from "./resolve-import-type.js";

package/dist/index.js

@@ -1,13 +1,8 @@
 export { serialiseComponentId, compareComponentId, externalPackageOf, parseCompoundExport } from "./id.js";
-export { validateManifest } from "./validate.js";
-export { manifestJsonSchema } from "./schema.js";
-export { ManifestBuilder } from "./builder.js";
-export { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
+export { asTagName, emptyLocalIndex } from "./scan-types.js";
 export { normalizeOwnerPath } from "./owner-utils.js";
 export { posixPath } from "./posix.js";
-export { logicalKeyFor, hashLogicalKey, computeLogicalId } from "./logical-id.js";
 export { computeOccurrenceId } from "./occurrence-id.js";
 export { projectPropUsages, classifyExprText } from "./project-props.js";
-export * from "./output-types.js";
 export { createDiagnosticCollector } from "./diagnostic.js";
 //# sourceMappingURL=index.js.map

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;AAe/C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAI1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAW3G,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/occurrence-id.d.ts

@@ -2,10 +2,10 @@
  * Stable per-occurrence id keyed on (componentId, filePath, line, column,
  * ownerComponentId?).
  *
- * Inputs use the FINAL artifact componentId strings (the hashed forms that
- * appear on `OutputOccurrence.componentId` / `OutputOccurrence.ownerComponentId`),
- * so downstream consumers can re-derive:
- *   id === computeOccurrenceId(o.componentId, o.filePath, o.line, o.column, o.ownerComponentId)
+ * Inputs use the FINAL artifact id strings (the ones that appear on an
+ * occurrence's `resolution.componentId` and `ownerComponentId`), so downstream
+ * consumers can re-derive a resolved occurrence's id:
+ *   id === computeOccurrenceId(o.resolution.componentId, o.filePath, o.line, o.column, o.ownerComponentId)
  *
  * `ownerComponentId` participates in the hash so that one JSX call site
  * fanning out to multiple owner resolutions (helper-call fanout) produces

package/dist/occurrence-id.js

@@ -3,10 +3,10 @@ import { createHash } from "node:crypto";
  * Stable per-occurrence id keyed on (componentId, filePath, line, column,
  * ownerComponentId?).
  *
- * Inputs use the FINAL artifact componentId strings (the hashed forms that
- * appear on `OutputOccurrence.componentId` / `OutputOccurrence.ownerComponentId`),
- * so downstream consumers can re-derive:
- *   id === computeOccurrenceId(o.componentId, o.filePath, o.line, o.column, o.ownerComponentId)
+ * Inputs use the FINAL artifact id strings (the ones that appear on an
+ * occurrence's `resolution.componentId` and `ownerComponentId`), so downstream
+ * consumers can re-derive a resolved occurrence's id:
+ *   id === computeOccurrenceId(o.resolution.componentId, o.filePath, o.line, o.column, o.ownerComponentId)
  *
  * `ownerComponentId` participates in the hash so that one JSX call site
  * fanning out to multiple owner resolutions (helper-call fanout) produces

package/dist/project-props.d.ts

@@ -1,12 +1,12 @@
 import type { PropUsage } from "./scan-types.js";
-import type { PropValueState } from "./output-types.js";
+import type { PropValueState } from "./v2/schema.js";
 /** Project parser-emitted PropUsage[] onto the per-occurrence value map. */
 export declare function projectPropUsages(usages: PropUsage[]): Record<string, PropValueState>;
 /**
- * Classify an already-extracted expression *string* (Vue template binding /
- * Lit placeholder) as a bare `reference` (identifier or dotted member path)
+ * Classify an already-extracted Vue template expression *string* as a bare
+ * `reference` (identifier or dotted member path)
  * or `dynamic`. AST-based parsers (React) do NOT use this — they classify
- * structurally. This is the single seam so Vue and Lit don't re-derive it.
+ * structurally. Vue template bindings use this single seam.
  */
 export declare function classifyExprText(text: string): {
     tier: "reference";

package/dist/project-props.js

@@ -22,10 +22,10 @@ export function projectPropUsages(usages) {
 const IDENT_RE = /^[A-Za-z_$][\w$]*$/;
 const MEMBER_PATH_RE = /^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*)+$/;
 /**
- * Classify an already-extracted expression *string* (Vue template binding /
- * Lit placeholder) as a bare `reference` (identifier or dotted member path)
+ * Classify an already-extracted Vue template expression *string* as a bare
+ * `reference` (identifier or dotted member path)
  * or `dynamic`. AST-based parsers (React) do NOT use this — they classify
- * structurally. This is the single seam so Vue and Lit don't re-derive it.
+ * structurally. Vue template bindings use this single seam.
  */
 export function classifyExprText(text) {
     const t = text.trim();

package/dist/scan-types.d.ts

@@ -1,67 +1,20 @@
 /**
  * Shared types consumed by all parser packages and the CLI host.
  *
- * Parsers (`parser-react`, `parser-vue`, `parser-lit`, `parser-html`) cannot
+ * Parsers (`parser-react`, `parser-vue`) cannot
  * depend on the CLI package (circular), so every type that crosses the
  * parser ↔ CLI boundary lives here in `plugin-core`.
  */
-import type { DeclaredPropApi, OutputComponent, OutputOccurrence, RelationshipEdge, 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";
+import type { DiagnosticCollector } from "./diagnostic.js";
+import type { ComponentId } from "./types.js";
+import type { DeclaredPropApi } from "./v2/schema.js";
 declare const __brand: unique symbol;
 type Brand<K, T> = K & {
     readonly [__brand]: T;
 };
 export type TagName = Brand<string, "TagName">;
-export type WrapperId = Brand<string, "WrapperId">;
-/** Unsafe constructors — use only at the data-ingest boundary. */
+/** Unsafe constructor — 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 IndexedComponent = (Extract<ManifestComponent, {
-    kind: "custom-element";
-}> & {
-    className?: string;
-}) | Extract<ManifestComponent, {
-    kind: "react-component" | "vue-component";
-}>;
-/**
- * A single resolution outcome for one `(fromFile, specifier, exportName)`
- * triple. `matched` is null when the resolved leaf has no manifest entry
- * for `exportName` — the caller should fall back to opaque opportunistic
- * emission (current `react-component` / `vue-component` with `manifest: null`
- * shape, package = `leafPackage`).
- */
-export type LazyResolverHit = {
-    leafPackage: string;
-    /** Terminal file's path relative to the leaf package root, POSIX-normalised. */
-    modulePath: string;
-    /**
-     * Export name at the terminal file after the walk. Equals the input
-     * exportName unless a hop renamed it (`export { X as Y } from ...`).
-     */
-    exportName: string;
-    matched: IndexedComponent | null;
-};
-export type ResolveLazyManifest = (fromFile: string, specifier: string, exportName: string) => LazyResolverHit | null;
 /**
  * File-path-anchored local barrel walker. Given a known-local file and an
  * export name, walks `export { X } from "./Y"` / `export * from "./Y"` chains
@@ -76,17 +29,14 @@ export type ResolveLocalExport = (filePath: string, exportName: string) => {
     filePath: string;
     exportName: string;
 } | null;
-export type LookupByTag = (tagName: string) => Extract<IndexedComponent, {
-    kind: "custom-element";
-}> | null;
-export type DetectorId = "react-default-fn" | "react-arrow" | "react-class" | "react-forward-ref" | "react-memo" | "vue-sfc" | "vue-define-component" | "vue-functional" | "wc-decorator" | "wc-customelements-define";
+export type DetectorId = "vue-sfc" | "vue-define-component" | "vue-functional" | "wc-decorator" | "wc-customelements-define";
 export type LocalDefinition = {
     /** componentId.source is always { type: "local", filePath }. */
     componentId: ComponentId;
     /**
-     * Local export identifier. For default exports, this is the declaration
-     * name (e.g. "Button" for `export default function Button()`); use
-     * `isDefault` to distinguish default from named-with-same-name.
+     * Local export identifier. For a Vue default export, this is the
+     * component's name (e.g. "UserCard" for `user-card.vue` with no `name`
+     * option); use `isDefault` to distinguish default from named-with-same-name.
      */
     exportName: string;
     /** True when emitted via `export default`. */
@@ -100,8 +50,8 @@ export type LocalDefinition = {
 export type LocalDefinitionIndex = {
     /** POSIX repo-relative filePath → definitions in that file. */
     byPath: Map<string, LocalDefinition[]>;
-    /** hyphenated-tag → WC local definition. */
-    byTag: Map<string, LocalDefinition>;
+    /** Canonical custom-element tag → every local registration of it. */
+    byTag: Map<string, LocalDefinition[]>;
 };
 export declare const emptyLocalIndex: LocalDefinitionIndex;
 export type Loc = {
@@ -109,7 +59,6 @@ export type Loc = {
     line: number;
     column: number;
 };
-export type WarningCode = "PARSE_FAILURE" | "IMPORT_UNRESOLVABLE" | "MANIFEST_TAG_COLLISION" | "EMPTY_INCLUDE";
 interface WarningBase {
     message: string;
 }
@@ -127,12 +76,6 @@ export type Warning = (WarningBase & {
 }) | (WarningBase & {
     code: "EMPTY_INCLUDE";
 });
-/**
- * The subset of the CLI's resolved configuration that parsers actually consume.
- * Using a structural interface rather than the full `ResolvedConfig` keeps
- * parsers decoupled from CLI-specific fields (configPath, output, etc.).
- */
-export type ScanConfig = {};
 /**
  * Per-attribute usage emitted by a parser. Four-tier floor:
  * - written: a literal value present verbatim in source (incl. a folded
@@ -156,21 +99,16 @@ export type PropUsage = {
     name: string;
     tier: "dynamic";
 };
-export type { OccurrenceVia } from "./via-types.js";
 export type Occurrence = {
     componentId: ComponentId;
     loc: Loc;
-    via: OccurrenceVia;
     props: PropUsage[];
     events: string[];
     /**
      * Parser-side parent reference. Index into the same
      * ParseResult.occurrences array. `undefined` = no tracked parent in this
-     * lexical scope. The CLI's projection layer (`parseResultsToOccurrences`)
-     * resolves this index into a `parentOccurrenceId` string; downstream
-     * queries needing the parent's componentId look it up via the flat
-     * occurrence stream. Cross-file composition is out of scope, so the index
-     * is local to one ParseResult.
+     * lexical scope. Cross-file composition is out of scope, so the index is
+     * local to one ParseResult.
      */
     parentRef?: number;
     /**
@@ -182,8 +120,8 @@ export type Occurrence = {
     /**
      * 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.
+     * The CLI projection layer (Assemble) hashes this into the artifact
+     * occurrence's `ownerComponentId` and drives the composition rollup.
      *
      * Convention for parsers that emit `ownerComponentId`:
      *   - Absent (undefined) ⇒ Occurrence is a "root" — no enclosing Component
@@ -197,21 +135,12 @@ export type Occurrence = {
      * Per-language framing:
      *   - parser-vue:   owner = enclosing SFC's vue-component Identity.
      *   - parser-react: owner = nearest enclosing function/class Component binding.
-     *   - parser-lit (planned): 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;
 };
-export type WrapperDef = {
-    id: WrapperId;
-    name: string;
-    file: string;
-    exportName: string;
-    componentDeps: ComponentId[];
-};
 export type FileImport = {
     file: string;
     /** Local binding name as used at the import site. */
@@ -221,18 +150,14 @@ export type FileImport = {
 };
 export type ParseResult = {
     occurrences: Occurrence[];
-    wrappers: WrapperDef[];
     imports: FileImport[];
     warnings: Warning[];
 };
 export type ParseContext = {
     /** Local-component definitions discovered in repo source. */
     localIndex: LocalDefinitionIndex;
-    config: ScanConfig;
     resolveImport: (from: string, spec: string) => string | null;
-    resolveLazyManifest: ResolveLazyManifest;
     resolveLocalExport: ResolveLocalExport;
-    lookupByTag: LookupByTag;
     repoRoot: string;
     /** Shared diagnostic collector for the scan run. */
     collector?: DiagnosticCollector;
@@ -243,42 +168,12 @@ export type ParseContext = {
      *
      * 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 `<x-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 ManifestRef = {
-    source: ManifestSource;
-    packageName: string;
-    path: string;
-    version: string | null;
-};
-export type ScanStats = {
-    filesScanned: number;
-    filesWithUsage: number;
-    scanDurationMs: number;
-    componentsDetected: number;
-    totalOccurrences: number;
-};
-export type ScanOutput = {
-    meta: ScanMeta;
-    manifests: ManifestRef[];
-    stats: ScanStats;
-    components: OutputComponent[];
-    occurrences: OutputOccurrence[];
-    diagnostics: Diagnostic[];
-    /** Realization edges. Populated post-resolve by applyWrapRelationships (scan.ts). */
-    relationships: RelationshipEdge[];
-};
+export {};

package/dist/scan-types.js

@@ -1,6 +1,5 @@
-/** Unsafe constructors — use only at the data-ingest boundary. */
+/** Unsafe constructor — use only at the data-ingest boundary. */
 export const asTagName = (s) => s;
-export const asWrapperId = (s) => s;
 export const emptyLocalIndex = {
     byPath: new Map(),
     byTag: new Map(),

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;AAyHpE,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":"AAoBA,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAY,CAAC;AAyD9D,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,KAAK,EAAE,IAAI,GAAG,EAAE;CACjB,CAAC"}

package/dist/types.d.ts

@@ -23,65 +23,3 @@ export type ComponentId = {
     export: string;
     source: ComponentSource;
 };
-export type Lifecycle = {
-    status: "stable";
-} | {
-    status: "deprecated";
-    supersededBy?: {
-        packageName: string;
-        exportName: string;
-    };
-    deprecationReason?: string;
-};
-export type ManifestProp = {
-    name: string;
-    type?: string;
-    default?: string | number | boolean | null;
-    values?: string[];
-    required?: boolean;
-    description?: string;
-    lifecycle?: Lifecycle;
-};
-export type ManifestEvent = {
-    name: string;
-    payloadType?: string;
-    description?: string;
-    lifecycle?: Lifecycle;
-};
-export type ManifestSlot = {
-    name: string;
-    description?: string;
-    lifecycle?: Lifecycle;
-};
-type ComponentBase = {
-    source: ComponentSource;
-    description?: string;
-    props: ManifestProp[];
-    lifecycle?: Lifecycle;
-};
-export type ManifestComponent = (ComponentBase & {
-    kind: "custom-element";
-    tagName: string;
-    events?: ManifestEvent[];
-    slots?: ManifestSlot[];
-    cssParts?: Array<{
-        name: string;
-    }>;
-    cssProperties?: Array<{
-        name: string;
-    }>;
-}) | (ComponentBase & {
-    kind: "react-component";
-    export: string;
-}) | (ComponentBase & {
-    kind: "vue-component";
-    export: string;
-});
-export type ManifestSource = "cem" | "react" | "vue";
-export type ManifestFile = {
-    schemaVersion: "2.0.0";
-    source: ManifestSource;
-    package: string;
-    components: ManifestComponent[];
-};
-export {};

package/dist/v2/component-key.d.ts

@@ -0,0 +1,3 @@
+import type { Identity } from "./schema.js";
+/** Canonical identity → component id. Isomorphic: runs in the CLI and in the browser bundle. */
+export declare function componentKey(identity: Identity): string;

package/dist/v2/component-key.js

@@ -0,0 +1,12 @@
+import { sha1 } from "@noble/hashes/legacy";
+import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils";
+/** Canonical identity → component id. Isomorphic: runs in the CLI and in the browser bundle. */
+export function componentKey(identity) {
+    const tuple = identity.kind === "package-export"
+        ? [identity.kind, identity.packageName, identity.publicEntry, identity.exportName]
+        : identity.kind === "repository-declaration"
+            ? [identity.kind, identity.repoId, identity.filePath, identity.exportName]
+            : [identity.kind, identity.tagName];
+    return bytesToHex(sha1(utf8ToBytes(JSON.stringify(tuple)))).slice(0, 16);
+}
+//# sourceMappingURL=component-key.js.map

package/dist/v2/component-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-key.js","sourceRoot":"","sources":["../../src/v2/component-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG9D,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAAC,QAAkB;IAC7C,MAAM,KAAK,GACT,QAAQ,CAAC,IAAI,KAAK,gBAAgB;QAChC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC;QAClF,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,wBAAwB;YAC1C,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;YAC1E,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/v2/index.d.ts

@@ -0,0 +1,9 @@
+export type { AttributionTarget, ChainBailedCode, Component, CompositionRollup, Credit, DeclaredProp, DeclaredPropApi, EvidenceRecord, Framework, Identity, Known, KnownEvidenceRecord, Occurrence, PropDistribution, PropValueEntry, PropValueState, Resolution, ResolvedOccurrence, ScanArtifact, ScanMeta, SourceLoc, TagAttribution, TraceStep, UnresolvedReason, } from "./schema.js";
+export { componentKey } from "./component-key.js";
+export { isKind } from "./schema.js";
+export { isResolved, resolvedOccurrences } from "./resolved-occurrences.js";
+export { buildScanStats, type ScanStats } from "./scan-stats.js";
+export { SCHEMA_VERSION, schemaVersionOf } from "./schema-version.js";
+export { resolveTagAttribution } from "./tag-attribution.js";
+export { RESERVED_CUSTOM_ELEMENT_NAMES, canonicalTagName, isValidCustomElementName } from "./tag-vocabulary.js";
+export { type ValidationResult, validateArtifact } from "./validate.js";

package/dist/v2/index.js

@@ -0,0 +1,9 @@
+export { componentKey } from "./component-key.js";
+export { isKind } from "./schema.js";
+export { isResolved, resolvedOccurrences } from "./resolved-occurrences.js";
+export { buildScanStats } from "./scan-stats.js";
+export { SCHEMA_VERSION, schemaVersionOf } from "./schema-version.js";
+export { resolveTagAttribution } from "./tag-attribution.js";
+export { RESERVED_CUSTOM_ELEMENT_NAMES, canonicalTagName, isValidCustomElementName } from "./tag-vocabulary.js";
+export { validateArtifact } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAyB,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/v2/resolved-occurrences.d.ts

@@ -0,0 +1,4 @@
+import type { Occurrence, ResolvedOccurrence } from "./schema.js";
+export declare function isResolved(o: Occurrence): o is ResolvedOccurrence;
+/** The only way component-facing code reads occurrences: unresolved ones have no component. */
+export declare function resolvedOccurrences(occurrences: readonly Occurrence[]): ResolvedOccurrence[];

package/dist/v2/resolved-occurrences.js

@@ -0,0 +1,8 @@
+export function isResolved(o) {
+    return o.resolution.status === "resolved";
+}
+/** The only way component-facing code reads occurrences: unresolved ones have no component. */
+export function resolvedOccurrences(occurrences) {
+    return occurrences.filter(isResolved);
+}
+//# sourceMappingURL=resolved-occurrences.js.map

package/dist/v2/resolved-occurrences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-occurrences.js","sourceRoot":"","sources":["../../src/v2/resolved-occurrences.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,CAAa;IACtC,OAAO,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC;AAC5C,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB,CAAC,WAAkC;IACpE,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC"}

package/dist/v2/scan-stats.d.ts

@@ -0,0 +1,16 @@
+import type { Occurrence } from "./schema.js";
+/** A scan's summary counts. The scan file doesn't carry them. */
+export type ScanStats = {
+    filesScanned: number;
+    scanDurationMs: number;
+    componentCount: number;
+    occurrenceCount: number;
+    resolvedOccurrenceCount: number;
+    filesWithResolvedOccurrences: number;
+};
+export declare function buildScanStats(input: {
+    filesScanned: number;
+    scanDurationMs: number;
+    components: readonly unknown[];
+    occurrences: readonly Occurrence[];
+}): ScanStats;