@component-compass/plugin-core 0.0.4 → 0.0.5

package/dist/index.d.ts

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

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/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/scan-types.d.ts

@@ -157,10 +157,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;
 };

package/package.json

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