@component-compass/plugin-core 0.1.11 → 0.1.17

package/dist/diagnostic.d.ts

@@ -34,6 +34,24 @@ export type Diagnostic = {
     line: number;
     column: number;
     specifier: string;
+} | {
+    code: "unresolved-component-tag";
+    severity: "warning";
+    filePath: string;
+    line?: number;
+    column?: number;
+    tagName: string;
+} | {
+    code: "auto-import-stale-entry";
+    severity: "warning";
+    filePath: string;
+    componentName: string;
+    target: string;
+} | {
+    code: "auto-import-manifest-missing";
+    severity: "warning";
+    filePath: string;
+    detail: string;
 } | {
     code: "unresolved-reference";
     severity: "info";

package/dist/diagnostic.js

@@ -33,6 +33,12 @@ function dedupKey(d) {
             return `${d.code}::${d.filePath}::${d.tagName}`;
         case "unresolved-import":
             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 "cycle-in-resolution":

package/dist/diagnostic.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+EH,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,oBAAoB;YACvB,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"}
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export type { TagName, WrapperId, IndexedComponent, Loc, WarningCode, Warning, S
 export { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
 export type { Enrichment, AuthoredLeafPayload } from "./enrichment.js";
 export { normalizeOwnerPath } from "./owner-utils.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";

package/dist/index.js

@@ -4,6 +4,7 @@ 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 { 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";

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,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":"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,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"}

package/dist/logical-id.d.ts

@@ -0,0 +1,4 @@
+import type { OutputIdentity } from "./output-types.js";
+export declare function logicalKeyFor(identity: OutputIdentity): string | null;
+export declare function hashLogicalKey(key: string): string;
+export declare function computeLogicalId(identity: OutputIdentity, physicalId: string): string;

package/dist/logical-id.js

@@ -0,0 +1,48 @@
+/**
+ * THE logical-id seam (COM-388). A logical component groups the physical
+ * identities that realize it; the key is a pure function of one identity:
+ *   - external custom-element              -> logical::<tagName>
+ *   - external react/vue with `wraps`      -> its TARGET's tag key (same as above)
+ *   - everything else                      -> null (singleton: logicalId = physical id)
+ * Tag keys are deliberately modulePath-free (COM-341/COM-338) and derivable
+ * from the identity alone so every repo lands on the same id (COM-252).
+ * Keyed on tag name alone, not package+tag (spec D7, 2026-07-25): tag names
+ * are the platform's global-uniqueness contract, and package-keying split a
+ * resolved custom element from its package-unresolved twin onto two logical
+ * ids for the same element.
+ * Do not re-derive these keys anywhere else — import from here (CLI stamps
+ * at scan time; web-shared derives only for legacy stored artifacts).
+ *
+ * This module is ISOMORPHIC on purpose. `deriveLogicalId` (web-shared) is
+ * reachable from `"use client"` components, so the seam gets bundled for the
+ * browser as well as run in Node. Hashing therefore goes through
+ * `@noble/hashes` (zero-dependency, no `node:crypto`); `hashLogicalKey` stays
+ * byte-identical to the `createHash("sha1")` form it replaced — see the
+ * byte-identity suite in tests/logical-id.test.ts. Keep this file free of
+ * *unconditional* Node builtins: anything added here ships to the client.
+ * (`@noble/hashes/utils` resolves `node:crypto` only under the `node` export
+ * condition, via `@noble/hashes/crypto` -> `cryptoNode.js`; isomorphism rests
+ * on bundlers picking the browser condition, not on the module graph being
+ * literally builtin-free.)
+ */
+import { sha1 } from "@noble/hashes/legacy";
+import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils";
+export function logicalKeyFor(identity) {
+    if (identity.scope !== "external")
+        return null;
+    if (identity.kind === "custom-element" && identity.tagName !== undefined) {
+        return `logical::${identity.tagName}`;
+    }
+    if (identity.wraps !== undefined) {
+        return `logical::${identity.wraps.tagName}`;
+    }
+    return null;
+}
+export function hashLogicalKey(key) {
+    return bytesToHex(sha1(utf8ToBytes(key))).slice(0, 16);
+}
+export function computeLogicalId(identity, physicalId) {
+    const key = logicalKeyFor(identity);
+    return key === null ? physicalId : hashLogicalKey(key);
+}
+//# sourceMappingURL=logical-id.js.map

package/dist/logical-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logical-id.js","sourceRoot":"","sources":["../src/logical-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG9D,MAAM,UAAU,aAAa,CAAC,QAAwB;IACpD,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACzE,OAAO,YAAY,QAAQ,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,YAAY,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAwB,EAAE,UAAkB;IAC3E,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/dist/output-types.d.ts

@@ -3,6 +3,7 @@
  * occurrences). Lives in plugin-core so consumers (cli, future analytics,
  * agents) share one source of truth without depending on cli internals.
  */
+import type { Diagnostic } from "./diagnostic.js";
 import type { OccurrenceVia } from "./via-types.js";
 import type { Lifecycle } from "./types.js";
 export type ComponentScope = "external" | "local";
@@ -46,9 +47,9 @@ export type OutputIdentity = {
         column: number;
     };
     /**
-     * Cross-link from a React wrapper to the underlying custom element it wraps.
-     * Set on react-component identities whose package's CEM declares a
-     * custom-element with `className === this.exportName`.
+     * Cross-link from a framework wrapper to the underlying custom element it wraps.
+     * Set on react-component and vue-component identities whose package's CEM
+     * declares a custom-element with `className === this.exportName`.
      * Absent when no CEM match or for non-wrapper imports.
      * Does NOT participate in componentId hashing.
      */
@@ -57,13 +58,6 @@ export type OutputIdentity = {
         tagName: string;
         packageName: string;
     };
-    /**
-     * Cross-link from a custom element to all React wrappers pointing at it.
-     * Sorted array of componentIds (deterministic order). Populated in the
-     * post-resolve aggregation phase of scan.ts.
-     * Does NOT participate in componentId hashing.
-     */
-    wrappedBy?: string[];
 };
 export type PropDecl = {
     type?: string;
@@ -193,17 +187,22 @@ export type EntryPackageRef = {
 };
 /**
  * Why this component is in the inventory (#340 spec, 2026-07-16).
- * Total classification; precedence: direct > via-wrapper > root > none.
+ * Total classification; precedence: direct > root > none.
  * - direct: ≥1 parsed occurrence (JSX / template / HTML tag).
- * - via-wrapper: zero occurrences; wrap-aggregation join anchor of a used wrapper.
  * - root: local, zero occurrences, framework entry-point file's default export.
  * - none: anything else, including external zero-occurrence rows. Catch-all.
  * Manifest-derived components are never emitted, so no catalogue value exists.
  */
-export type UsageKind = "direct" | "via-wrapper" | "root" | "none";
+export type UsageKind = "direct" | "root" | "none";
 export type OutputComponent = {
     id: string;
     identity: OutputIdentity;
+    /**
+     * Logical-component id this physical identity realizes (COM-388).
+     * Singletons carry their own `id`; wrap chains share the tag-keyed hash.
+     * See plugin-core/src/logical-id.ts — the ONE derivation seam.
+     */
+    logicalId: string;
     manifest: {
         source: "authored";
         data: AuthoredManifestData;
@@ -285,6 +284,21 @@ export type ScanMeta = {
         branch: string | null;
     };
 };
+/**
+ * First-class realization edge (COM-388). Replaces the deleted synthetic
+ * zero-occurrence node: the edge target is a logical key, bound to a physical
+ * componentId only when that target was observed in this repo's scan.
+ * Only "wraps" is emitted today; the union stays open for future sources
+ * ("re-exports" provenance is already carried by #242 folding + entryPackages).
+ */
+export type RelationshipEdge = {
+    sourceId: string;
+    type: "wraps";
+    target: {
+        logicalKey: string;
+        componentId?: string;
+    };
+};
 /**
  * The complete scan artifact shape produced by the CLI.
  * Two-grain structure: components (rolled-up identity + manifest + composition) +
@@ -294,4 +308,12 @@ export type ScanArtifact = {
     meta: ScanMeta;
     components: OutputComponent[];
     occurrences: OutputOccurrence[];
+    relationships: RelationshipEdge[];
+    /**
+     * Observations the scan could not turn into a component — unresolved tags,
+     * unresolved imports, bailed-out re-export chains. Reader surfaces project
+     * from these to tell a consumer what the scan could NOT see, which no
+     * component row can express.
+     */
+    diagnostics: Diagnostic[];
 };

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 { DeclaredPropApi, OutputComponent, OutputOccurrence, ScanMeta } from "./output-types.js";
+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";
@@ -280,4 +280,6 @@ export type ScanOutput = {
     components: OutputComponent[];
     occurrences: OutputOccurrence[];
     diagnostics: Diagnostic[];
+    /** Realization edges (COM-388). Populated post-resolve by applyWrapRelationships (scan.ts). */
+    relationships: RelationshipEdge[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@component-compass/plugin-core",
-  "version": "0.1.11",
+  "version": "0.1.17",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,6 +8,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./logical-id": {
+      "types": "./dist/logical-id.d.ts",
+      "import": "./dist/logical-id.js"
     }
   },
   "files": [
@@ -21,6 +25,7 @@
     "clean": "rm -rf dist .turbo"
   },
   "dependencies": {
+    "@noble/hashes": "1.8.0",
     "ajv": "8.20.0"
   },
   "devDependencies": {