@component-compass/plugin-core 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -9,7 +9,8 @@ export { asTagName, asWrapperId, emptyLocalIndex } from "./scan-types.js";
 export type { Enrichment, AuthoredLeafPayload } from "./enrichment.js";
 export { normalizeOwnerPath } from "./owner-utils.js";
 export { computeOccurrenceId } from "./occurrence-id.js";
-export type { CompositionRollup } from "./output-types.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";

package/dist/index.js

@@ -5,6 +5,7 @@ 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 { 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,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;AACzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/output-types.d.ts

@@ -97,20 +97,75 @@ export type AuthoredManifestData = {
     invocable?: Record<string, InvocableDecl>;
 };
 /**
- * Per-occurrence prop value:
- * - a literal (string/number/boolean/null) when the source value is statically known,
- * - 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.
+ * Per-occurrence prop value (keyed by prop name on OutputOccurrence.props).
+ * Same tiers as PropUsage minus `name`. Absent prop → key omitted.
  */
-export type PropValueState = string | number | boolean | null | {
-    __dynamic: true;
+export type PropValueState = {
+    tier: "written";
+    value: string | number | boolean | null;
+} | {
+    tier: "written";
+    valueSet: (string | number | boolean)[];
+} | {
+    tier: "reference";
+    ref: string;
+} | {
+    tier: "dynamic";
 };
+/** One enumerable value bucket in a component-grain prop distribution. */
+export type PropValueEntry = {
+    provenance: "written";
+    value: string | number | boolean | null;
+    count: number;
+} | {
+    provenance: "written";
+    valueSet: (string | number | boolean)[];
+    count: number;
+} | {
+    provenance: "reference";
+    ref: string;
+    count: number;
+};
+/**
+ * Component-grain rollup for one prop.
+ * Invariant: sum(values[].count) + dynamic + (other ?? 0) + omitted === occurrenceCount
+ * `defaultApplied` is a SUBSET of `omitted` (manifest declares a default), not additive.
+ */
 export type PropDistribution = {
-    /** Stringified literal value -> occurrence count. */
-    distribution: Record<string, number>;
+    values: PropValueEntry[];
     dynamic: number;
     omitted: number;
     defaultApplied: number;
+    other?: number;
+    truncated?: number;
+};
+/**
+ * One prop in a source-derived declared API. Every field is explicit-only:
+ * present iff the declaration site literally states it.
+ */
+export type DeclaredProp = {
+    /** Inline type annotation as verbatim source text (Vue type-literal only;
+     *  absent for React — a destructure exposes no reliable type). */
+    type?: string;
+    /** Optionality when stated. Vue: from the `?` marker. React: `false` when the
+     *  prop has any default (a default makes it optional); otherwise absent. */
+    required?: boolean;
+    /** Literal default value, when the default is a literal. Same union as
+     *  `PropValueEntry.value` so Spec 2 stringifies it identically to observed
+     *  written values. Absent for no default or a non-literal default. */
+    default?: string | number | boolean | null;
+};
+/**
+ * Source-derived declared prop API for a local component. Absent on
+ * `OutputComponent` when the declaration site is unreadable (see readability
+ * gate). External components use `manifest` instead; the two can co-exist on a
+ * local workspace component that also ships an authored manifest.
+ */
+export type DeclaredPropApi = {
+    /** Prop name → what the site explicitly states. Keys in source order. */
+    props: Record<string, DeclaredProp>;
+    /** Component destructures `...rest` / declares an index signature. */
+    hasRest: boolean;
 };
 export type CompositionRollup = {
     /** child componentId → count of occurrences owned by this component (owner-edge children). */
@@ -122,6 +177,10 @@ export type CompositionRollup = {
     /** # of this component's occurrences whose component has empty rendersByCount. */
     isLeafCount: number;
 };
+/** Per-component consumer-event usage rollup. `boundCount` = occurrences binding this event. */
+export type EventDistribution = {
+    boundCount: number;
+};
 export type OutputComponent = {
     id: string;
     identity: OutputIdentity;
@@ -134,8 +193,13 @@ export type OutputComponent = {
         fileCount: number;
     };
     props: Record<string, PropDistribution>;
+    /** Consumer-bound events rolled up across occurrences (Vue/html/lit native + React on* props). */
+    events?: Record<string, EventDistribution>;
     /** Per-component composition rollup (owner-edge driven). Always emitted. */
     composition?: CompositionRollup;
+    /** Source-derived declared prop API. Local components only; absent when the
+     *  declaration site is unreadable. Orthogonal to `manifest`. */
+    declared?: DeclaredPropApi;
     /** 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. */
@@ -155,6 +219,8 @@ export type OutputOccurrence = {
      *  through barrels, etc. */
     viaChain: OccurrenceVia[];
     props: Record<string, PropValueState>;
+    /** Event names bound at this call site (Vue/html/lit). React handlers stay in `props`. */
+    events?: string[];
     /** 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. */

package/dist/project-props.d.ts

@@ -0,0 +1,16 @@
+import type { PropUsage } from "./scan-types.js";
+import type { PropValueState } from "./output-types.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)
+ * 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.
+ */
+export declare function classifyExprText(text: string): {
+    tier: "reference";
+    ref: string;
+} | {
+    tier: "dynamic";
+};

package/dist/project-props.js

@@ -0,0 +1,36 @@
+/** Project parser-emitted PropUsage[] onto the per-occurrence value map. */
+export function projectPropUsages(usages) {
+    const out = {};
+    for (const p of usages) {
+        switch (p.tier) {
+            case "written":
+                out[p.name] =
+                    "valueSet" in p
+                        ? { tier: "written", valueSet: p.valueSet }
+                        : { tier: "written", value: p.value };
+                break;
+            case "reference":
+                out[p.name] = { tier: "reference", ref: p.ref };
+                break;
+            case "dynamic":
+                out[p.name] = { tier: "dynamic" };
+                break;
+        }
+    }
+    return out;
+}
+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)
+ * 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.
+ */
+export function classifyExprText(text) {
+    const t = text.trim();
+    if (IDENT_RE.test(t) || MEMBER_PATH_RE.test(t))
+        return { tier: "reference", ref: t };
+    return { tier: "dynamic" };
+}
+//# sourceMappingURL=project-props.js.map

package/dist/project-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-props.js","sourceRoot":"","sources":["../src/project-props.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,SAAS;gBACZ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;oBACT,UAAU,IAAI,CAAC;wBACb,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;wBAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC1C,MAAM;YACR,KAAK,WAAW;gBACd,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;gBAChD,MAAM;YACR,KAAK,SAAS;gBACZ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBAClC,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AACtC,MAAM,cAAc,GAAG,yCAAyC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY;IAEZ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACrF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

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 { OutputComponent, OutputOccurrence, ScanMeta } from "./output-types.js";
+import type { DeclaredPropApi, OutputComponent, OutputOccurrence, 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";
@@ -89,6 +89,8 @@ export type LocalDefinition = {
     detector: DetectorId;
     /** Source position of the declaration site. Populated by detectors. */
     loc?: Loc;
+    /** Source-derived declared prop API, when readable. Populated by detectors. */
+    declared?: DeclaredPropApi;
 };
 export type LocalDefinitionIndex = {
     /** POSIX repo-relative filePath → definitions in that file. */
@@ -125,13 +127,30 @@ export type Warning = (WarningBase & {
  * Using a structural interface rather than the full `ResolvedConfig` keeps
  * parsers decoupled from CLI-specific fields (configPath, output, etc.).
  */
-export type ScanConfig = {
-    captureValues: boolean;
-};
+export type ScanConfig = {};
+/**
+ * Per-attribute usage emitted by a parser. Four-tier floor:
+ * - written: a literal value present verbatim in source (incl. a folded
+ *   literal set from a ternary), or boolean-shorthand `true`, or literal `null`.
+ * - reference: a non-literal captured by name/path but not resolved.
+ * - dynamic: opaque (call, spread, object/array, mixed template, etc.).
+ * The `resolved` tier is added by the engine in Plan 2.
+ */
 export type PropUsage = {
     name: string;
-    isDynamic: boolean;
-    literalValue?: string | number | boolean;
+    tier: "written";
+    value: string | number | boolean | null;
+} | {
+    name: string;
+    tier: "written";
+    valueSet: (string | number | boolean)[];
+} | {
+    name: string;
+    tier: "reference";
+    ref: string;
+} | {
+    name: string;
+    tier: "dynamic";
 };
 export type { OccurrenceVia } from "./via-types.js";
 export type Occurrence = {
@@ -233,7 +252,7 @@ export type ParseContext = {
     /**
      * 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 `<pie-link>` unconditionally.
+     * tags like `<x-link>` unconditionally.
      * Provided by scan.ts; parsers consume it.
      */
     cemIndex?: CemIndex;

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

package/package.json

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