@component-compass/plugin-core 0.0.4 → 0.1.0

package/dist/diagnostic.d.ts

@@ -28,6 +28,29 @@ export type Diagnostic = {
     filePath: string;
     tagName: string;
     conflictsWith: string;
+} | {
+    code: "unresolved-import";
+    severity: "warning";
+    filePath: string;
+    line: number;
+    column: number;
+    specifier: string;
+} | {
+    code: "unresolved-reference";
+    severity: "info";
+    filePath: string;
+    line: number;
+    column: number;
+    symbol: string;
+    memberChain: string[];
+} | {
+    code: "cycle-in-resolution";
+    severity: "warning";
+    filePath: string;
+    line: number;
+    column: number;
+    symbol: string;
+    depth: number;
 } | {
     code: "cycle-detected";
     severity: "warning";

package/dist/diagnostic.js

@@ -31,6 +31,12 @@ 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 "unresolved-import":
+            return `${d.code}::${d.filePath}::${d.line}::${d.column}::${d.specifier}`;
+        case "unresolved-reference":
+            return `${d.code}::${d.filePath}::${d.line}::${d.column}::${d.symbol}::${d.memberChain.join(".")}`;
+        case "cycle-in-resolution":
+            return `${d.code}::${d.filePath}::${d.symbol}`;
         case "cycle-detected":
             return `${d.code}::${d.filePath}::${d.exportName}`;
         case "chain-too-deep":

package/dist/diagnostic.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgFH,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,mBAAmB;YACtB,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,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,qBAAqB;YACxB,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QACjD,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,11 +4,13 @@ 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, ScanOutput, ManifestRef, ScanStats, DetectorId, LocalDefinition, LocalDefinitionIndex, ResolveLazyManifest, LookupByTag, LazyResolverHit, CemIndex, CemIndexEntry, } 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, ResolveLocalExport, 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";
 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

@@ -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;AAe/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/occurrence-id.d.ts

@@ -1,11 +1,22 @@
 /**
- * Stable per-occurrence id keyed on (componentId, filePath, line, column).
+ * Stable per-occurrence id keyed on (componentId, filePath, line, column,
+ * ownerComponentId?).
  *
- * Inputs use the FINAL artifact componentId string (the hashed form that
- * appears on `OutputOccurrence.componentId`), so downstream consumers can
- * re-derive: `id === computeOccurrenceId(o.componentId, o.filePath, o.line, o.column)`.
+ * 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)
  *
- * 64 bits of entropy via 16-char SHA-256 truncation. Birthday-bound collision
- * at ~4 billion occurrences; full hash is overkill for current scale.
+ * `ownerComponentId` participates in the hash so that one JSX call site
+ * fanning out to multiple owner resolutions (helper-call fanout — see
+ * docs/superpowers/specs/2026-05-22-phantom-owner-attribution-design.md)
+ * produces distinct ids per resolution. When `ownerComponentId` is
+ * undefined (parser-direct occurrence with no owner, or root JSX), the
+ * hash is computed without an owner segment — keeps the same shape as
+ * pre-fanout occurrences.
+ *
+ * 64 bits of entropy via 16-char SHA-256 truncation. Birthday-bound
+ * collision at ~4 billion occurrences; full hash is overkill for current
+ * scale.
  */
-export declare function computeOccurrenceId(componentId: string, filePath: string, line: number, column: number): string;
+export declare function computeOccurrenceId(componentId: string, filePath: string, line: number, column: number, ownerComponentId?: string): string;

package/dist/occurrence-id.js

@@ -1,18 +1,28 @@
 import { createHash } from "node:crypto";
 /**
- * Stable per-occurrence id keyed on (componentId, filePath, line, column).
+ * Stable per-occurrence id keyed on (componentId, filePath, line, column,
+ * ownerComponentId?).
  *
- * Inputs use the FINAL artifact componentId string (the hashed form that
- * appears on `OutputOccurrence.componentId`), so downstream consumers can
- * re-derive: `id === computeOccurrenceId(o.componentId, o.filePath, o.line, o.column)`.
+ * 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)
  *
- * 64 bits of entropy via 16-char SHA-256 truncation. Birthday-bound collision
- * at ~4 billion occurrences; full hash is overkill for current scale.
+ * `ownerComponentId` participates in the hash so that one JSX call site
+ * fanning out to multiple owner resolutions (helper-call fanout — see
+ * docs/superpowers/specs/2026-05-22-phantom-owner-attribution-design.md)
+ * produces distinct ids per resolution. When `ownerComponentId` is
+ * undefined (parser-direct occurrence with no owner, or root JSX), the
+ * hash is computed without an owner segment — keeps the same shape as
+ * pre-fanout occurrences.
+ *
+ * 64 bits of entropy via 16-char SHA-256 truncation. Birthday-bound
+ * collision at ~4 billion occurrences; full hash is overkill for current
+ * scale.
  */
-export function computeOccurrenceId(componentId, filePath, line, column) {
-    return createHash("sha256")
-        .update(`${componentId}|${filePath}|${line}|${column}`)
-        .digest("hex")
-        .slice(0, 16);
+export function computeOccurrenceId(componentId, filePath, line, column, ownerComponentId) {
+    const base = `${componentId}|${filePath}|${line}|${column}`;
+    const key = ownerComponentId !== undefined ? `${base}|${ownerComponentId}` : base;
+    return createHash("sha256").update(key).digest("hex").slice(0, 16);
 }
 //# sourceMappingURL=occurrence-id.js.map

package/dist/occurrence-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"occurrence-id.js","sourceRoot":"","sources":["../src/occurrence-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,QAAgB,EAChB,IAAY,EACZ,MAAc;IAEd,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,WAAW,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;SACtD,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"occurrence-id.js","sourceRoot":"","sources":["../src/occurrence-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,QAAgB,EAChB,IAAY,EACZ,MAAc,EACd,gBAAyB;IAEzB,MAAM,IAAI,GAAG,GAAG,WAAW,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/output-types.d.ts

@@ -11,32 +11,35 @@ export type OutputIdentity = {
     scope: ComponentScope;
     kind: ComponentKindOutput;
     /**
-     * For ds + external lanes: the npm package name as resolved by the manifest layer.
+     * For external lane: the npm package name as resolved by the manifest layer.
      * For local lane: the owning workspace package's name when the file resides inside
      * 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).
+     * For external identities reached via a subpath import: the subpath after
+     * the package name (e.g. `@shoelace-style/shoelace/dist/components/button`
+     * → `"dist/components/button"`), POSIX-normalised. Disambiguates distinct
+     * components reached via different subpaths of the same package.
+     * - Populated string: import specifier carried a subpath.
+     * - Absent (`undefined`): not applicable — bare package specifier (e.g.
+     *   `react`), byTag-driven external identities, or local identities.
+     * Derived from the specifier string alone — does not depend on whether
+     * the moduleResolver succeeded. Independent canonical signal.
      */
     modulePath?: string;
     /** For react-component / vue-component. */
     exportName?: string;
     /** For custom-element. */
     tagName?: string;
-    /** Present for local; absent for ds/external. */
+    /** Present for local; absent for external. */
     repoId?: string;
-    /** Present for local; absent for ds/external. Repo-relative path of the defining file. */
+    /** Present for local; absent for external. Repo-relative path of the defining file. */
     filePath?: string;
     /**
      * Source position of the local-component declaration (the function/class
      * keyword for declarations; the variable identifier for `const Foo = ...`).
-     * Only set when `scope === "local"`. Absent for ds / external / wc.
+     * Only set when `scope === "local"`. Absent for external / custom-element.
      */
     definition?: {
         line: number;
@@ -85,15 +88,14 @@ export type DerivedManifestData = {
     slots?: Record<string, SlotDecl>;
     invocable?: Record<string, InvocableDecl>;
 };
-export type DynamicKind = "spread" | "expr" | "identifier";
 /**
  * Per-occurrence prop value:
  * - a literal (string/number/boolean/null) when the source value is statically known,
- * - a `{ __dynamic }` marker when the value is a non-literal expression,
+ * - a `{ __dynamic: true }` marker when the value is a non-literal expression,
  * - or absent (key omitted from the map) when the prop was not set on the occurrence.
  */
 export type PropValueState = string | number | boolean | null | {
-    __dynamic: DynamicKind;
+    __dynamic: true;
 };
 export type PropDistribution = {
     /** Stringified literal value -> occurrence count. */
@@ -143,7 +145,12 @@ export type OutputOccurrence = {
     filePath: string;
     line: number;
     column: number;
+    /** Outer-most access pattern (alias for viaChain[0]). */
     via: OccurrenceVia;
+    /** Full provenance chain from JSX site to resolved identity, outermost-first.
+     *  Single-element for direct imports; multi-element for HOC chains, lazy boundaries
+     *  through barrels, etc. */
+    viaChain: OccurrenceVia[];
     props: Record<string, PropValueState>;
     /** Phase 2: stable id keyed on (componentId, filePath, line, column). */
     occurrenceId: string;

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/resolve-import-type.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Function type for "where does this import specifier point?" — the single
+ * source of truth consumed by both the lazy resolver and the
+ * classifyImportOrigin helper. Implementation lives in
+ * `cli/src/walker/resolve-import.ts` (knows about node-resolve quirks,
+ * tsconfig paths, config aliases). Type lives here so plugin-core consumers
+ * (ast-utils, parsers) can depend on it without depending on the CLI.
+ *
+ * Returns the absolute file path the specifier resolves to, or null if no
+ * resolution layer matches.
+ *
+ * See ADR 0001 for the dual-role rationale and CONTEXT.md "ResolveImport"
+ * entry for the glossary definition.
+ */
+export type ResolveImport = (from: string, spec: string) => string | null;

package/dist/resolve-import-type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-import-type.js.map

package/dist/resolve-import-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-import-type.js","sourceRoot":"","sources":["../src/resolve-import-type.ts"],"names":[],"mappings":""}

package/dist/scan-types.d.ts

@@ -63,6 +63,20 @@ export type LazyResolverHit = {
     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
+ * to the terminal file the chain ended at. Returns null on cross-package
+ * boundary, cycle, max-hop overflow, or unresolvable re-export specifier.
+ * The terminal `exportName` may differ from the input when the chain renames
+ * (`export { X as Y } from "./Z"`); caller does the final byPath lookup to
+ * confirm the file actually exports the returned name. Backed by the lazy
+ * resolver's `parsedBarrel` cache.
+ */
+export type ResolveLocalExport = (filePath: string, exportName: string) => {
+    filePath: string;
+    exportName: string;
+} | null;
 export type LookupByTag = (tagName: string) => Extract<IndexedComponent, {
     kind: "custom-element";
 }> | null;
@@ -124,14 +138,6 @@ export type PropUsage = {
     name: string;
     isDynamic: boolean;
     literalValue?: string | number | boolean;
-    /**
-     * When `isDynamic` is true, distinguishes the kind of dynamic value:
-     *   - "spread"     — JSX spread attribute (`{...rest}`); name is `"...rest"`.
-     *   - "identifier" — bare identifier reference (`prop={someVar}`).
-     *   - "expr"       — any other expression (`prop={a + b}`, calls, ternaries, etc.).
-     * Omitted when `isDynamic` is false.
-     */
-    dynamicKind?: "spread" | "expr" | "identifier";
 };
 export type { OccurrenceVia } from "./via-types.js";
 export type Occurrence = {
@@ -157,10 +163,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;
 };
@@ -190,8 +214,16 @@ export type ParseContext = {
     config: ScanConfig;
     resolveImport: (from: string, spec: string) => string | null;
     resolveLazyManifest: ResolveLazyManifest;
+    resolveLocalExport: ResolveLocalExport;
     lookupByTag: LookupByTag;
     repoRoot: string;
+    /**
+     * Set of package names known to belong to the scan's repo (workspace
+     * siblings + declared deps). Threaded into `classifyImportOrigin` so
+     * specifiers that don't resolve on disk (uninstalled workspace siblings)
+     * can still recover external-package identity.
+     */
+    knownPackageNames?: ReadonlySet<string>;
     /** Shared diagnostic collector for the scan run. */
     collector?: DiagnosticCollector;
     /**

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;AA2GpE,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;AA0HpE,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,KAAK,EAAE,IAAI,GAAG,EAAE;CACjB,CAAC"}

package/dist/via-types.d.ts

@@ -25,4 +25,38 @@ export type OccurrenceVia = {
     kind: "context-provider";
 } | {
     kind: "local-component";
+} | {
+    kind: "hoc-wrapper";
+    hocCallee: string;
+    specifier: string;
+    import: string;
+} | {
+    kind: "dynamic-map";
+    mapName: string;
+    mapLoc: {
+        file: string;
+        line: number;
+        column: number;
+    };
+} | {
+    kind: "lazy-import";
+    wrapperCallee: string;
+    specifier: string;
+    import: string;
+} | {
+    kind: "dynamic-binding";
+    bindingName: string;
+    bindingSource: "parameter" | "hook-return";
+} | {
+    kind: "prop-forward";
+    bindingName: string;
+    constructionSite: {
+        file: string;
+        line: number;
+        column: number;
+    };
+} | {
+    kind: "helper-call";
+    callee: string;
+    calleeFile: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@component-compass/plugin-core",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,12 +21,12 @@
     "clean": "rm -rf dist .turbo"
   },
   "dependencies": {
-    "ajv": "^8.17.0"
+    "ajv": "8.20.0"
   },
   "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.9.0",
-    "vitest": "^4.0.0"
+    "@types/node": "24.12.2",
+    "typescript": "5.9.3",
+    "vitest": "4.1.5"
   },
   "engines": {
     "node": ">=24"