@component-compass/plugin-core 0.1.9 → 0.1.11

package/dist/output-types.d.ts

@@ -181,6 +181,26 @@ export type CompositionRollup = {
 export type EventDistribution = {
     boundCount: number;
 };
+/**
+ * Entry/wrapper package through which this repo reached the component
+ * (#331). Scan-observational provenance — how the repo imported it — not
+ * identity. `version` is the entry package's installed version, null when
+ * its package.json is unreadable or unversioned.
+ */
+export type EntryPackageRef = {
+    package: string;
+    version: string | null;
+};
+/**
+ * Why this component is in the inventory (#340 spec, 2026-07-16).
+ * Total classification; precedence: direct > via-wrapper > 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 OutputComponent = {
     id: string;
     identity: OutputIdentity;
@@ -192,6 +212,8 @@ export type OutputComponent = {
         occurrenceCount: number;
         fileCount: number;
     };
+    /** Why this component is in the inventory. See UsageKind. */
+    usage: UsageKind;
     props: Record<string, PropDistribution>;
     /** Consumer-bound events rolled up across occurrences (Vue/html/lit native + React on* props). */
     events?: Record<string, EventDistribution>;
@@ -200,6 +222,9 @@ export type OutputComponent = {
     /** Source-derived declared prop API. Local components only; absent when the
      *  declaration site is unreadable. Orthogonal to `manifest`. */
     declared?: DeclaredPropApi;
+    /** Entry/wrapper packages this repo reached the component through (#331).
+     *  Deduped by {package, version}, sorted. Present only when non-empty. */
+    entryPackages?: EntryPackageRef[];
     /** Package version from package.json or CEM. Null for external packages not versioned at scan time. */
     version: string | null;
     /** Git-mtime: first commit of the declaring file. ISO 8601 string, or null for external packages. */

package/package.json

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