@component-compass/plugin-core 0.0.1 → 0.0.3

package/dist/builder.d.ts

@@ -3,19 +3,13 @@ type BuilderOpts = {
     source: ManifestSource;
     package: string;
 };
-type AddInput = (Omit<Extract<ManifestComponent, {
+type AddInput = Extract<ManifestComponent, {
     kind: "custom-element";
-}>, "deprecated"> & {
-    deprecated?: boolean | string;
-}) | (Omit<Extract<ManifestComponent, {
+}> | Extract<ManifestComponent, {
     kind: "react-component";
-}>, "deprecated"> & {
-    deprecated?: boolean | string;
-}) | (Omit<Extract<ManifestComponent, {
+}> | Extract<ManifestComponent, {
     kind: "vue-component";
-}>, "deprecated"> & {
-    deprecated?: boolean | string;
-});
+}>;
 export declare class ManifestBuilder {
     private readonly source;
     private readonly packageName;

package/dist/builder.js

@@ -19,7 +19,7 @@ export class ManifestBuilder {
         if (c.kind !== expected) {
             throw new Error(`Component kind "${c.kind}" does not match builder source "${this.source}" (expected kind "${expected}")`);
         }
-        this.components.push({ deprecated: false, ...c });
+        this.components.push(c);
         return this;
     }
     build() {

package/dist/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,eAAe,GAAsD;IACzE,GAAG,EAAE,gBAAgB;IACrB,KAAK,EAAE,iBAAiB;IACxB,GAAG,EAAE,eAAe;CACrB,CAAC;AASF,MAAM,OAAO,eAAe;IACT,MAAM,CAAiB;IACvB,WAAW,CAAS;IACpB,UAAU,GAAwB,EAAE,CAAC;IAEtD,YAAY,IAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,CAAW;QACtB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,mBAAmB,CAAC,CAAC,IAAI,oCAAoC,IAAI,CAAC,MAAM,qBAAqB,QAAQ,IAAI,CAC1G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,EAAuB,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAiB;YACxB,aAAa,EAAE,cAAc;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,UAAU,EAAE,MAAM;SACnB,CAAC;QACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,CAAoB,EAAE,CAAoB;IACnE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,IAAI,CAAC,CAAoB;IAChC,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,eAAe,GAAsD;IACzE,GAAG,EAAE,gBAAgB;IACrB,KAAK,EAAE,iBAAiB;IACxB,GAAG,EAAE,eAAe;CACrB,CAAC;AASF,MAAM,OAAO,eAAe;IACT,MAAM,CAAiB;IACvB,WAAW,CAAS;IACpB,UAAU,GAAwB,EAAE,CAAC;IAEtD,YAAY,IAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,CAAW;QACtB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,mBAAmB,CAAC,CAAC,IAAI,oCAAoC,IAAI,CAAC,MAAM,qBAAqB,QAAQ,IAAI,CAC1G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAiB;YACxB,aAAa,EAAE,cAAc;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,UAAU,EAAE,MAAM;SACnB,CAAC;QACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,CAAoB,EAAE,CAAoB;IACnE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,IAAI,CAAC,CAAoB;IAChC,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9D,CAAC"}

package/dist/diagnostic.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Unified diagnostic surface for parsers, resolver, and local-index.
+ * Discriminated union by `code`; severity drives `--strict` exit code.
+ *
+ * Lives in plugin-core so resolver, parsers, local-index, and CLI all
+ * share one source of truth.
+ */
+export type DiagnosticSeverity = "info" | "warning";
+export type Diagnostic = {
+    code: "jsx-shape-unsupported";
+    severity: "warning";
+    filePath: string;
+    line?: number;
+    column?: number;
+    nameType: string;
+    detail: string;
+} | {
+    code: "vue-tag-low-confidence";
+    severity: "info";
+    filePath: string;
+    line?: number;
+    column?: number;
+    tagName: string;
+    emittedAs: "vue-component" | "custom-element";
+} | {
+    code: "local-index-duplicate-tag";
+    severity: "warning";
+    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";
+    filePath: string;
+    exportName: string;
+    packageName?: string;
+} | {
+    code: "chain-too-deep";
+    severity: "warning";
+    filePath: string;
+    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;
+    drain(): Diagnostic[];
+}
+export type DiagnosticCode = Diagnostic["code"];
+export declare function createDiagnosticCollector(): DiagnosticCollector;

package/dist/diagnostic.js

@@ -0,0 +1,69 @@
+/**
+ * Unified diagnostic surface for parsers, resolver, and local-index.
+ * Discriminated union by `code`; severity drives `--strict` exit code.
+ *
+ * Lives in plugin-core so resolver, parsers, local-index, and CLI all
+ * share one source of truth.
+ */
+function assertUnreachable(x) {
+    throw new Error(`Unhandled diagnostic code: ${x.code}`);
+}
+/**
+ * Compute a stable dedup key for a diagnostic. Two diagnostics with
+ * identical keys are treated as the same observation and only emitted once.
+ *
+ * Keys are constructed per-code from the fields that identify the OBSERVATION
+ * (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.
+ */
+function dedupKey(d) {
+    switch (d.code) {
+        case "jsx-shape-unsupported":
+            return `${d.code}::${d.filePath}::${d.line ?? ""}::${d.column ?? ""}::${d.nameType}`;
+        case "vue-tag-low-confidence":
+            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);
+    }
+}
+export function createDiagnosticCollector() {
+    const seen = new Set();
+    const ordered = [];
+    return {
+        emit(d) {
+            const key = dedupKey(d);
+            if (seen.has(key))
+                return;
+            seen.add(key);
+            ordered.push(d);
+        },
+        drain() {
+            const out = ordered.slice();
+            ordered.length = 0;
+            seen.clear();
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=diagnostic.js.map

package/dist/diagnostic.js.map

@@ -0,0 +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"}

package/dist/enrichment.d.ts

@@ -0,0 +1,45 @@
+import type { IndexedComponent } from "./scan-types.js";
+/**
+ * Manifest source for enrichment of a resolver-discovered leaf package.
+ *
+ *   - "authored": leaf shipped a `custom-elements.json` or
+ *                 `component-compass-manifest.json` at its package root.
+ *   - "derived":  leaf carries no authored manifest but `manifest-react` /
+ *                 `manifest-vue` extractors (Phase 4) produced one from source.
+ *   - null:       no enrichment available — identity stays opaque
+ *                 (`components[].manifest === null` in the artifact).
+ *
+ * Open envelope: `data` shape grows in Phase 3 (CEM depth) and Phase 4
+ * (extractor maturity) without changing this discriminator.
+ */
+export type Enrichment = {
+    source: "authored";
+    data: AuthoredLeafPayload;
+} | {
+    source: "derived";
+    data: DerivedLeafPayload;
+} | null;
+/**
+ * Payload shape held by the lazy resolver for a successfully-loaded leaf
+ * manifest. Per-leaf, not per-component — carries every component the leaf
+ * declares plus the manifest source metadata.
+ */
+export type AuthoredLeafPayload = {
+    /** Every component declared in the leaf's authored manifest. */
+    components: IndexedComponent[];
+    /** Absolute filesystem path of the loaded manifest file. */
+    manifestPath: string;
+    /** Authored format the manifest was loaded from. */
+    manifestKind: "cem" | "component-compass-manifest";
+    /** Leaf package's `version` field, when readable. */
+    packageVersion?: string;
+};
+/**
+ * Phase 4 hook: per-leaf payload populated by the source-extraction fallback
+ * (manifest-react / manifest-vue extractors). Same per-leaf shape as
+ * `AuthoredLeafPayload`; field set narrows to whatever the extractors recover.
+ */
+export type DerivedLeafPayload = {
+    /** Components extracted from leaf source by Phase 4 extractors. */
+    components: IndexedComponent[];
+};

package/dist/enrichment.js

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

package/dist/enrichment.js.map

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

package/dist/id.d.ts

@@ -2,3 +2,8 @@ import type { ComponentId, ComponentSource } from "./types.js";
 export declare function externalPackageOf(source: ComponentSource): string;
 export declare function serialiseComponentId(id: ComponentId): string;
 export declare function compareComponentId(a: ComponentId, b: ComponentId): number;
+export declare function parseCompoundExport(exportName: string): {
+    root: string;
+    path: string[];
+    isCompound: boolean;
+};

package/dist/id.js

@@ -28,4 +28,12 @@ export function serialiseComponentId(id) {
 export function compareComponentId(a, b) {
     return serialiseComponentId(a).localeCompare(serialiseComponentId(b));
 }
+export function parseCompoundExport(exportName) {
+    const [root, ...path] = exportName.split(".");
+    return {
+        root: root ?? "",
+        path,
+        isCompound: path.length > 0,
+    };
+}
 //# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACtD,MAAM,IAAI,KAAK,CACb,2DAA2D,MAAM,CAAC,IAAI,qEAAqE,CAC5I,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAuB;IAC5C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,OAAO;YACV,OAAO,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,EAAe;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,gBAAgB;YACnB,OAAO,EAAE,CAAC,OAAO,CAAC;QACpB,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,EAAE,CAAC,MAAM,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAe;IAClD,OAAO,GAAG,EAAE,CAAC,IAAI,IAAI,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAc,EAAE,CAAc;IAC/D,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACtD,MAAM,IAAI,KAAK,CACb,2DAA2D,MAAM,CAAC,IAAI,qEAAqE,CAC5I,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAuB;IAC5C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,OAAO;YACV,OAAO,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,EAAe;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,gBAAgB;YACnB,OAAO,EAAE,CAAC,OAAO,CAAC;QACpB,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,EAAE,CAAC,MAAM,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAe;IAClD,OAAO,GAAG,EAAE,CAAC,IAAI,IAAI,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAc,EAAE,CAAc;IAC/D,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IAKpD,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO;QACL,IAAI,EAAE,IAAI,IAAI,EAAE;QAChB,IAAI;QACJ,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,14 @@
 export type { ComponentId, ComponentKind, ComponentSource, Lifecycle, ManifestComponent, ManifestEvent, ManifestFile, ManifestProp, ManifestSlot, ManifestSource, } from "./types.js";
-export { serialiseComponentId, compareComponentId, externalPackageOf } from "./id.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, ImportRole, ImportEntry, IndexedComponent, ComponentIndex, Loc, WarningCode, Warning, ScanConfig, PropUsage, OccurrenceVia, Occurrence, WrapperDef, FileImport, ParseResult, ParseContext, ParserPlugin, ScanEnvelope, ScanOutput, DetectorId, LocalDefinition, LocalDefinitionIndex, } from "./scan-types.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 { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
+export type { Enrichment, AuthoredLeafPayload, DerivedLeafPayload } from "./enrichment.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";

package/dist/index.js

@@ -1,7 +1,9 @@
-export { serialiseComponentId, compareComponentId, externalPackageOf } from "./id.js";
+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 { computeOccurrenceId } from "./occurrence-id.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,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAa/C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1E,cAAc,mBAAmB,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;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"}

package/dist/occurrence-id.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stable per-occurrence id keyed on (componentId, filePath, line, column).
+ *
+ * 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)`.
+ *
+ * 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;

package/dist/occurrence-id.js

@@ -0,0 +1,18 @@
+import { createHash } from "node:crypto";
+/**
+ * Stable per-occurrence id keyed on (componentId, filePath, line, column).
+ *
+ * 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)`.
+ *
+ * 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);
+}
+//# sourceMappingURL=occurrence-id.js.map

package/dist/occurrence-id.js.map

@@ -0,0 +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"}

package/dist/output-types.d.ts

@@ -3,37 +3,78 @@
  * occurrences). Lives in plugin-core so consumers (cli, future analytics,
  * agents) share one source of truth without depending on cli internals.
  */
+import type { OccurrenceVia } from "./via-types.js";
+import type { Lifecycle } from "./types.js";
 export type ComponentScope = "ds" | "external" | "local";
 export type ComponentKindOutput = "custom-element" | "react-component" | "vue-component";
-export type ViaKindOutput = "html-tag" | "lit-template" | "react-wrapper" | "direct-import" | "vue-template";
 export type OutputIdentity = {
     scope: ComponentScope;
     kind: ComponentKindOutput;
-    /** Present for ds + external; absent for local. */
+    /**
+     * For ds + external lanes: 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 react-component / vue-component. */
     exportName?: string;
     /** For custom-element. */
     tagName?: string;
-    via: {
-        kind: ViaKindOutput;
-    };
     /** Present for local; absent for ds/external. */
     repoId?: string;
     /** Present for local; absent for ds/external. Repo-relative path of the defining file. */
     filePath?: string;
-};
-export type OutputManifest = {
-    lifecycle?: {
-        status: "stable" | "deprecated";
-        supersededBy?: {
-            packageName: string;
-            exportName: 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.
+     */
+    definition?: {
+        line: number;
+        column: number;
     };
-    props?: Record<string, {
-        default?: string | number | boolean | null;
-    }>;
+};
+export type PropDecl = {
+    type?: string;
+    default?: string | number | boolean | null;
+    values?: string[];
+    required?: boolean;
+    description?: string;
+    lifecycle?: Lifecycle;
+};
+export type SlotDecl = {
+    description?: string;
+    lifecycle?: Lifecycle;
+};
+export type InvocableDecl = {
+    kind: "dom-event" | "callback-prop";
+    payloadType?: string;
+    description?: string;
+    lifecycle?: Lifecycle;
+};
+/**
+ * Per-component manifest payload as it appears in `component-compass.json`.
+ * Field set is the closed-form Phase 3 schema (trimmed): description, lifecycle,
+ * and the three per-feature record maps. Methods, CSS surfaces, inheritance,
+ * and `since` are deferred to later sub-plans / phases.
+ */
+export type AuthoredManifestData = {
+    description?: string;
+    lifecycle?: Lifecycle;
+    props?: Record<string, PropDecl>;
+    slots?: Record<string, SlotDecl>;
+    invocable?: Record<string, InvocableDecl>;
+};
+/**
+ * Phase 4 hook: per-component payload populated by source-extraction fallback.
+ * Structurally a subset of `AuthoredManifestData`; ships empty in Phase 3.
+ */
+export type DerivedManifestData = {
+    description?: string;
+    lifecycle?: Lifecycle;
+    props?: Record<string, PropDecl>;
+    slots?: Record<string, SlotDecl>;
+    invocable?: Record<string, InvocableDecl>;
 };
 export type DynamicKind = "spread" | "expr" | "identifier";
 /**
@@ -52,28 +93,53 @@ export type PropDistribution = {
     omitted: number;
     defaultApplied: number;
 };
-export type OutputEdges = {
-    /** componentIds this component renders. Empty in v1, schema slot. */
-    renders: string[];
-    /** componentIds that render this component. Empty in v1, schema slot. */
-    renderedBy: string[];
+export type CompositionRollup = {
+    /** child componentId → count of occurrences owned by this component (owner-edge children). */
+    rendersByCount: Record<string, number>;
+    /** parent componentId → count of occurrences in which this component is owned by that parent. */
+    renderedByCount: Record<string, number>;
+    /** # of this component's occurrences with no ownerComponentId. */
+    isRootCount: number;
+    /** # of this component's occurrences whose component has empty rendersByCount. */
+    isLeafCount: number;
 };
 export type OutputComponent = {
     id: string;
     identity: OutputIdentity;
     derivedTags: string[];
-    manifest: OutputManifest | null;
+    manifest: {
+        source: "authored";
+        data: AuthoredManifestData;
+    } | {
+        source: "derived";
+        data: DerivedManifestData;
+    } | null;
     stats: {
         occurrenceCount: number;
         fileCount: number;
     };
     props: Record<string, PropDistribution>;
-    edges: OutputEdges;
+    /** Per-component composition rollup (owner-edge driven). Always emitted. */
+    composition?: CompositionRollup;
 };
 export type OutputOccurrence = {
     componentId: string;
     filePath: string;
     line: number;
     column: number;
+    via: OccurrenceVia;
     props: Record<string, PropValueState>;
+    /** Phase 2: stable id keyed on (componentId, filePath, line, column). */
+    occurrenceId: string;
+    /** Phase 2: occurrenceId of nearest tracked ancestor. Absent if root in this scope. */
+    parentOccurrenceId?: string;
+    /** Phase 2: distance from highest tracked-rootless ancestor in same lexical scope. */
+    depth?: number;
+    /**
+     * Stable id of the component-definition that lexically contains this call
+     * site (the enclosing function/class). Drives the owner-edge composition
+     * graph. Absent when the occurrence is module-scope JSX, in a `.html`
+     * file, or the parser couldn't resolve an enclosing tracked component.
+     */
+    ownerComponentId?: string;
 };

package/dist/output-types.js

@@ -1,7 +1,2 @@
-/**
- * Types describing the CLI's emitted JSON artifact (two-grain: components +
- * occurrences). Lives in plugin-core so consumers (cli, future analytics,
- * agents) share one source of truth without depending on cli internals.
- */
 export {};
 //# sourceMappingURL=output-types.js.map

package/dist/output-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-types.js","sourceRoot":"","sources":["../src/output-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
+{"version":3,"file":"output-types.js","sourceRoot":"","sources":["../src/output-types.ts"],"names":[],"mappings":""}

package/dist/scan-types.d.ts

@@ -6,7 +6,9 @@
  * parser ↔ CLI boundary lives here in `plugin-core`.
  */
 import type { OutputComponent, OutputOccurrence } from "./output-types.js";
-import type { ComponentId, ManifestComponent } from "./types.js";
+import type { Diagnostic, DiagnosticCollector } from "./diagnostic.js";
+import type { ComponentId, ManifestComponent, ManifestSource } from "./types.js";
+import type { OccurrenceVia } from "./via-types.js";
 declare const __brand: unique symbol;
 type Brand<K, T> = K & {
     readonly [__brand]: T;
@@ -29,22 +31,21 @@ export type IndexedComponent = (Extract<ManifestComponent, {
 }) | Extract<ManifestComponent, {
     kind: "react-component" | "vue-component";
 }>;
-export type ComponentIndex = {
-    /** key = serialiseComponentId(id) */
-    byId: Map<string, IndexedComponent>;
-    /** custom-element only, keyed by tagName */
-    byTag: Map<string, Extract<IndexedComponent, {
-        kind: "custom-element";
-    }>>;
-    /** key = `${specifier}::${export}` — covers WC react-wrappers AND direct react/vue imports */
-    byImport: Map<string, IndexedComponent>;
-    /** key = native specifier (WC bare imports for side-effect registration) */
-    byNativeSpecifier: Map<string, Extract<IndexedComponent, {
-        kind: "custom-element";
-    }>>;
-    /** Local-component definitions discovered in repo source. */
-    local: LocalDefinitionIndex;
+/**
+ * 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;
+    matched: IndexedComponent | null;
 };
+export type ResolveLazyManifest = (fromFile: string, specifier: string, exportName: string) => LazyResolverHit | 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 LocalDefinition = {
     /** componentId.source is always { type: "local", filePath }. */
@@ -58,6 +59,8 @@ export type LocalDefinition = {
     /** True when emitted via `export default`. */
     isDefault: boolean;
     detector: DetectorId;
+    /** Source position of the declaration site. Populated by detectors. */
+    loc?: Loc;
 };
 export type LocalDefinitionIndex = {
     /** POSIX repo-relative filePath → definitions in that file. */
@@ -71,7 +74,7 @@ export type Loc = {
     line: number;
     column: number;
 };
-export type WarningCode = "MISSING_REACT_EXPORT_EXTENSION" | "PARSE_FAILURE" | "IMPORT_UNRESOLVABLE" | "MANIFEST_TAG_COLLISION" | "EMPTY_INCLUDE";
+export type WarningCode = "PARSE_FAILURE" | "IMPORT_UNRESOLVABLE" | "MANIFEST_TAG_COLLISION" | "EMPTY_INCLUDE";
 interface WarningBase {
     message: string;
 }
@@ -83,10 +86,6 @@ export type Warning = (WarningBase & {
     code: "IMPORT_UNRESOLVABLE";
     file: string;
     line: number;
-}) | (WarningBase & {
-    code: "MISSING_REACT_EXPORT_EXTENSION";
-    package: string;
-    file: string;
 }) | (WarningBase & {
     code: "MANIFEST_TAG_COLLISION";
     package: string;
@@ -115,30 +114,36 @@ export type PropUsage = {
      */
     dynamicKind?: "spread" | "expr" | "identifier";
 };
-export type OccurrenceVia = {
-    kind: "html-tag";
-} | {
-    kind: "lit-template";
-    specifier?: string;
-} | {
-    kind: "react-wrapper";
-    specifier: string;
-    import: string;
-} | {
-    kind: "direct-import";
-    specifier: string;
-    import: string;
-} | {
-    kind: "vue-template";
-    specifier: string;
-    import: string;
-};
+export type { OccurrenceVia } from "./via-types.js";
 export type Occurrence = {
     componentId: ComponentId;
     loc: Loc;
     via: OccurrenceVia;
     props: PropUsage[];
     events: string[];
+    /**
+     * Phase 2: 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 (per spec
+     * non-goal), so the index is local to one ParseResult.
+     */
+    parentRef?: number;
+    /**
+     * Phase 2: distance from the highest tracked-rootless ancestor in the
+     * same lexical scope. 0 for roots; matches `parentStack.length` at the
+     * time the occurrence was emitted.
+     */
+    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.
+     */
+    ownerComponentId?: ComponentId;
 };
 export type WrapperDef = {
     id: WrapperId;
@@ -161,10 +166,15 @@ export type ParseResult = {
     warnings: Warning[];
 };
 export type ParseContext = {
-    index: ComponentIndex;
+    /** Local-component definitions discovered in repo source. */
+    localIndex: LocalDefinitionIndex;
     config: ScanConfig;
     resolveImport: (from: string, spec: string) => string | null;
+    resolveLazyManifest: ResolveLazyManifest;
+    lookupByTag: LookupByTag;
     repoRoot: string;
+    /** Shared diagnostic collector for the scan run. */
+    collector?: DiagnosticCollector;
 };
 export interface ParserPlugin {
     name: string;
@@ -180,9 +190,24 @@ export type ScanEnvelope = {
     toolVersion: string;
     cwd: string;
 };
+export type ManifestRef = {
+    source: ManifestSource;
+    package: string;
+    path: string;
+    version: string | null;
+};
+export type ScanStats = {
+    filesScanned: number;
+    filesWithUsage: number;
+    scanDurationMs: number;
+    componentsDetected: number;
+    totalOccurrences: number;
+};
 export type ScanOutput = {
     envelope: ScanEnvelope;
+    manifests: ManifestRef[];
+    stats: ScanStats;
     components: OutputComponent[];
     occurrences: OutputOccurrence[];
+    diagnostics: Diagnostic[];
 };
-export {};

package/dist/scan-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"scan-types.js","sourceRoot":"","sources":["../src/scan-types.ts"],"names":[],"mappings":"AAoBA,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;AAsEpE,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;AAsFpE,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,KAAK,EAAE,IAAI,GAAG,EAAE;CACjB,CAAC"}

package/dist/schema.d.ts

@@ -18,7 +18,7 @@ export declare const manifestJsonSchema: {
             readonly type: "array";
             readonly items: {
                 readonly type: "object";
-                readonly required: readonly ["kind", "source", "deprecated", "props"];
+                readonly required: readonly ["kind", "source", "props"];
                 readonly properties: {
                     readonly kind: {
                         readonly enum: readonly ["custom-element", "react-component", "vue-component"];
@@ -69,12 +69,11 @@ export declare const manifestJsonSchema: {
                     readonly tagName: {
                         readonly type: "string";
                     };
-                    readonly deprecated: {
-                        readonly oneOf: readonly [{
-                            readonly type: "boolean";
-                        }, {
-                            readonly type: "string";
-                        }];
+                    readonly description: {
+                        readonly type: "string";
+                    };
+                    readonly lifecycle: {
+                        readonly type: "object";
                     };
                     readonly props: {
                         readonly type: "array";

package/dist/schema.js

@@ -12,7 +12,7 @@ export const manifestJsonSchema = {
             type: "array",
             items: {
                 type: "object",
-                required: ["kind", "source", "deprecated", "props"],
+                required: ["kind", "source", "props"],
                 properties: {
                     kind: { enum: ["custom-element", "react-component", "vue-component"] },
                     source: {
@@ -32,7 +32,8 @@ export const manifestJsonSchema = {
                     },
                     export: { type: "string" },
                     tagName: { type: "string" },
-                    deprecated: { oneOf: [{ type: "boolean" }, { type: "string" }] },
+                    description: { type: "string" },
+                    lifecycle: { type: "object" },
                     props: { type: "array", items: { type: "object", required: ["name"], properties: { name: { type: "string" } } } },
                     events: { type: "array" },
                     slots: { type: "array" },

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

@@ -21,31 +21,39 @@ 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;
-    deprecated?: boolean | string;
     default?: string | number | boolean | null;
+    values?: string[];
+    required?: boolean;
+    description?: string;
+    lifecycle?: Lifecycle;
 };
 export type ManifestEvent = {
     name: string;
-    deprecated?: boolean | string;
+    payloadType?: string;
+    description?: string;
+    lifecycle?: Lifecycle;
 };
 export type ManifestSlot = {
     name: string;
-};
-export type Lifecycle = {
-    status: "stable";
-} | {
-    status: "deprecated";
-    supersededBy?: {
-        packageName: string;
-        exportName: string;
-    };
+    description?: string;
+    lifecycle?: Lifecycle;
 };
 type ComponentBase = {
     source: ComponentSource;
-    deprecated: boolean | string;
+    description?: string;
     props: ManifestProp[];
     lifecycle?: Lifecycle;
 };

package/dist/via-types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Discriminated union describing how a component instance was used.
+ * Shared between parser-emitted Occurrence (scan-types.ts) and the artifact-shape
+ * OutputOccurrence (output-types.ts). Lives in its own module to keep the two
+ * type files acyclic.
+ */
+export type OccurrenceVia = {
+    kind: "html-tag";
+} | {
+    kind: "lit-template";
+    specifier?: string;
+} | {
+    kind: "react-wrapper";
+    specifier: string;
+    import: string;
+} | {
+    kind: "direct-import";
+    specifier: string;
+    import: string;
+} | {
+    kind: "vue-template";
+    specifier: string;
+    import: string;
+} | {
+    kind: "context-provider";
+} | {
+    kind: "local-component";
+};

package/dist/via-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=via-types.js.map

package/dist/via-types.js.map

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

package/package.json

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