@component-compass/cli 0.0.0-pr-3-8916f3c-20260507145532

package/dist/envelope/git.js

@@ -0,0 +1,69 @@
+import { execFileSync } from "node:child_process";
+export function resolveCommitSha(cwd) {
+    try {
+        return execFileSync("git", ["rev-parse", "HEAD"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveBranch(cwd) {
+    try {
+        const branch = execFileSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (branch === "HEAD")
+            return null;
+        return branch;
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveOriginRemote(cwd) {
+    try {
+        const url = execFileSync("git", ["remote", "get-url", "origin"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return parseRemoteUrl(url);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Normalise a git remote URL to `host/owner/repo` form (no `.git` suffix).
+ * Accepts:
+ *   - https://github.com/owner/repo.git
+ *   - https://github.com/owner/repo
+ *   - git@github.com:owner/repo.git
+ *   - ssh://git@github.com/owner/repo.git
+ *   - ssh://git@github.com:22/owner/repo.git
+ */
+export function parseRemoteUrl(url) {
+    const trimmed = url.trim();
+    if (!trimmed)
+        return null;
+    // ssh://git@host[:port]/owner/repo(.git)?
+    const sshProto = trimmed.match(/^ssh:\/\/(?:[^@]+@)?([^/:]+)(?::\d+)?\/([^/]+)\/(.+?)(?:\.git)?\/?$/);
+    if (sshProto)
+        return `${sshProto[1]}/${sshProto[2]}/${sshProto[3]}`;
+    // https://host/owner/repo(.git)?
+    const https = trimmed.match(/^https?:\/\/(?:[^@/]+@)?([^/:]+)(?::\d+)?\/([^/]+)\/(.+?)(?:\.git)?\/?$/);
+    if (https)
+        return `${https[1]}/${https[2]}/${https[3]}`;
+    // git@host:owner/repo(.git)?
+    const scp = trimmed.match(/^[^@]+@([^/:]+):([^/]+)\/(.+?)(?:\.git)?\/?$/);
+    if (scp)
+        return `${scp[1]}/${scp[2]}/${scp[3]}`;
+    return null;
+}
+//# sourceMappingURL=git.js.map

package/dist/envelope/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/envelope/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;YAChD,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;YACxE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;YAC/D,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAC5B,qEAAqE,CACtE,CAAC;IACF,IAAI,QAAQ;QAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpE,iCAAiC;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CACzB,yEAAyE,CAC1E,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAExD,6BAA6B;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC1E,IAAI,GAAG;QAAE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/envelope/index.d.ts

@@ -0,0 +1,10 @@
+import type { ScanEnvelope } from "@component-compass/plugin-core";
+export type BuildEnvelopeOptions = {
+    cwd: string;
+    cliRepoIdFlag?: string | undefined;
+    /** Path to @component-compass/cli's own package.json directory. Optional;
+     *  defaults to the CLI package root resolved via `import.meta.url`. */
+    packageRoot?: string;
+};
+export declare function buildScanEnvelope(opts: BuildEnvelopeOptions): ScanEnvelope;
+export declare function readToolVersion(packageRoot: string): string;

package/dist/envelope/index.js

@@ -0,0 +1,57 @@
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ulid } from "ulid";
+import { resolveBranch, resolveCommitSha } from "./git.js";
+import { resolveRepoId } from "./repo-id.js";
+export function buildScanEnvelope(opts) {
+    const { value: repoId } = resolveRepoId({
+        cwd: opts.cwd,
+        cliFlag: opts.cliRepoIdFlag,
+        // biome-ignore lint/complexity/useLiteralKeys: tsconfig noPropertyAccessFromIndexSignature requires bracket access on process.env
+        envOverride: process.env["COMPONENT_COMPASS_REPO_ID"],
+    });
+    return {
+        scanId: ulid(),
+        repoId,
+        commitSha: resolveCommitSha(opts.cwd),
+        branch: resolveBranch(opts.cwd),
+        timestamp: new Date().toISOString(),
+        toolVersion: readToolVersion(opts.packageRoot ?? defaultPackageRoot()),
+        cwd: opts.cwd,
+    };
+}
+export function readToolVersion(packageRoot) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/**
+ * Walk up from this module's directory until we find a `package.json` whose
+ * `name` is `@component-compass/cli`. Robust to running from `dist/` or `src/`
+ * (vitest) without hardcoding a relative depth.
+ */
+function defaultPackageRoot() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, "package.json");
+        try {
+            const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+            if (parsed.name === "@component-compass/cli")
+                return dir;
+        }
+        catch {
+            // continue walking
+        }
+        const parent = resolve(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return dirname(fileURLToPath(import.meta.url));
+}
+//# sourceMappingURL=index.js.map

package/dist/envelope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/envelope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAU7C,MAAM,UAAU,iBAAiB,CAAC,IAA0B;IAC1D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;QACtC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,aAAa;QAC3B,kIAAkI;QAClI,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;KACtD,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,IAAI,EAAE;QACd,MAAM;QACN,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;QACrC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;QACtE,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE7E,CAAC;QACF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB;IACzB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAuB,CAAC;YACjF,IAAI,MAAM,CAAC,IAAI,KAAK,wBAAwB;gBAAE,OAAO,GAAG,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/envelope/repo-id.d.ts

@@ -0,0 +1,16 @@
+export type RepoIdSource = "flag" | "env" | "git" | "package" | "hash";
+export type ResolveRepoIdOptions = {
+    cwd: string;
+    cliFlag?: string | undefined;
+    envOverride?: string | undefined;
+};
+export type ResolvedRepoId = {
+    value: string;
+    source: RepoIdSource;
+};
+/**
+ * Resolve the repository identifier used in the scan envelope.
+ * Priority: CLI flag > env var > git origin remote > package.json name >
+ * deterministic hash of `cwd`.
+ */
+export declare function resolveRepoId(opts: ResolveRepoIdOptions): ResolvedRepoId;

package/dist/envelope/repo-id.js

@@ -0,0 +1,40 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveOriginRemote } from "./git.js";
+/**
+ * Resolve the repository identifier used in the scan envelope.
+ * Priority: CLI flag > env var > git origin remote > package.json name >
+ * deterministic hash of `cwd`.
+ */
+export function resolveRepoId(opts) {
+    if (opts.cliFlag && opts.cliFlag.length > 0) {
+        return { value: opts.cliFlag, source: "flag" };
+    }
+    if (opts.envOverride && opts.envOverride.length > 0) {
+        return { value: opts.envOverride, source: "env" };
+    }
+    const remote = resolveOriginRemote(opts.cwd);
+    if (remote)
+        return { value: remote, source: "git" };
+    const pkgName = readPackageName(opts.cwd);
+    if (pkgName)
+        return { value: pkgName, source: "package" };
+    const hash = createHash("sha1").update(opts.cwd).digest("hex").slice(0, 12);
+    return { value: `repo-hash-${hash}`, source: "hash" };
+}
+function readPackageName(cwd) {
+    const pkgPath = join(cwd, "package.json");
+    if (!existsSync(pkgPath))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(pkgPath, "utf8"));
+        if (typeof parsed.name === "string" && parsed.name.length > 0)
+            return parsed.name;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=repo-id.js.map

package/dist/envelope/repo-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-id.js","sourceRoot":"","sources":["../../src/envelope/repo-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAe/C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,KAAK,EAAE,aAAa,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAuB,CAAC;QAC/E,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAClF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Three-lane identity derivation + stable id keying.
+ *
+ * Two pure functions that translate a per-occurrence `ComponentId + via +
+ * derivedTags + repoId` tuple into the rolled-up `OutputIdentity` and a
+ * deterministic short hash used as the component's `id` in the emitted
+ * artifact.
+ *
+ * Lanes (scope):
+ *   - "local"    — `componentId.source.type === "local"`. Siloed per
+ *                   `{repoId, filePath, exportName, kind}` so two consumer
+ *                   repos with locally-named components don't collide.
+ *   - "ds"       — externally-sourced AND `derivedTags.length > 0` (i.e.
+ *                   matched the workspace's tag rules — the "design system"
+ *                   you're tracking).
+ *   - "external" — externally-sourced with no tag matches (third-party noise).
+ *
+ * Stable-id key composition:
+ *   - local                          → `local::<repoId>::<filePath>::<exportName>::<kind>`
+ *   - ds | external custom-element   → `ce::<packageName>::<tagName>`
+ *   - ds | external react/vue        → `rc::<packageName>::<exportName>`
+ * Hashed with SHA-1, truncated to 16 hex chars.
+ *
+ * NOT yet wired into the scan pipeline — wiring is a separate task.
+ */
+import type { ComponentId, OccurrenceVia, OutputIdentity } from "@component-compass/plugin-core";
+export type IdentityInputs = {
+    componentId: ComponentId;
+    via: OccurrenceVia;
+    derivedTags: readonly string[];
+    repoId: string;
+};
+export declare function computeOutputIdentity(inputs: IdentityInputs): OutputIdentity;
+export declare function computeStableId(identity: OutputIdentity): string;
+/**
+ * Produce the same stable id as `computeStableId` from a raw `ComponentId`
+ * (as emitted by parsers), without needing to first build an `OutputIdentity`.
+ *
+ * This is used in `occurrences.ts` so that occurrence `componentId` fields
+ * hash-match the `id` values produced by `buildComponentSeeds` → `rollupOccurrencesToComponents`
+ * can correctly correlate occurrences to seeds.
+ *
+ * For local components, `repoId` is absent from the `ComponentId` source, so
+ * we use `""` — matching the `repoId: ""` convention in `buildComponentSeeds`.
+ */
+export declare function computeStableIdFromComponentId(c: ComponentId): string;

package/dist/identity.js

@@ -0,0 +1,92 @@
+/**
+ * Three-lane identity derivation + stable id keying.
+ *
+ * Two pure functions that translate a per-occurrence `ComponentId + via +
+ * derivedTags + repoId` tuple into the rolled-up `OutputIdentity` and a
+ * deterministic short hash used as the component's `id` in the emitted
+ * artifact.
+ *
+ * Lanes (scope):
+ *   - "local"    — `componentId.source.type === "local"`. Siloed per
+ *                   `{repoId, filePath, exportName, kind}` so two consumer
+ *                   repos with locally-named components don't collide.
+ *   - "ds"       — externally-sourced AND `derivedTags.length > 0` (i.e.
+ *                   matched the workspace's tag rules — the "design system"
+ *                   you're tracking).
+ *   - "external" — externally-sourced with no tag matches (third-party noise).
+ *
+ * Stable-id key composition:
+ *   - local                          → `local::<repoId>::<filePath>::<exportName>::<kind>`
+ *   - ds | external custom-element   → `ce::<packageName>::<tagName>`
+ *   - ds | external react/vue        → `rc::<packageName>::<exportName>`
+ * Hashed with SHA-1, truncated to 16 hex chars.
+ *
+ * NOT yet wired into the scan pipeline — wiring is a separate task.
+ */
+import { createHash } from "node:crypto";
+export function computeOutputIdentity(inputs) {
+    const { componentId, via, derivedTags, repoId } = inputs;
+    const { source, kind } = componentId;
+    const isLocal = source.type === "local";
+    const scope = isLocal
+        ? "local"
+        : derivedTags.length > 0
+            ? "ds"
+            : "external";
+    const identity = {
+        scope,
+        kind,
+        via: { kind: via.kind },
+    };
+    if (source.type === "external") {
+        identity.packageName = source.package;
+    }
+    if (componentId.kind === "custom-element") {
+        identity.tagName = componentId.tagName;
+    }
+    else {
+        // react-component | vue-component
+        identity.exportName = componentId.export;
+    }
+    if (isLocal && source.type === "local") {
+        identity.repoId = repoId;
+        identity.filePath = source.filePath;
+    }
+    return identity;
+}
+const sha1Short = (s) => createHash("sha1").update(s).digest("hex").slice(0, 16);
+export function computeStableId(identity) {
+    if (identity.scope === "local") {
+        return sha1Short(`local::${identity.repoId}::${identity.filePath}::${identity.exportName}::${identity.kind}`);
+    }
+    if (identity.kind === "custom-element") {
+        return sha1Short(`ce::${identity.packageName}::${identity.tagName}`);
+    }
+    return sha1Short(`rc::${identity.packageName}::${identity.exportName}`);
+}
+/**
+ * Produce the same stable id as `computeStableId` from a raw `ComponentId`
+ * (as emitted by parsers), without needing to first build an `OutputIdentity`.
+ *
+ * This is used in `occurrences.ts` so that occurrence `componentId` fields
+ * hash-match the `id` values produced by `buildComponentSeeds` → `rollupOccurrencesToComponents`
+ * can correctly correlate occurrences to seeds.
+ *
+ * For local components, `repoId` is absent from the `ComponentId` source, so
+ * we use `""` — matching the `repoId: ""` convention in `buildComponentSeeds`.
+ */
+export function computeStableIdFromComponentId(c) {
+    if (c.source.type === "local") {
+        const exportOrTag = c.kind === "custom-element" ? c.tagName : c.export;
+        // repoId is not carried on ComponentId.source; use "" to match the
+        // repoId: "" convention in buildComponentSeeds (seeds for local
+        // components are keyed the same way).
+        return sha1Short(`local::::${c.source.filePath}::${exportOrTag}::${c.kind}`);
+    }
+    const pkg = c.source.type === "external" ? c.source.package : "unknown";
+    if (c.kind === "custom-element") {
+        return sha1Short(`ce::${pkg}::${c.tagName}`);
+    }
+    return sha1Short(`rc::${pkg}::${c.export}`);
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0";

package/dist/index.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.1.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/local-index/detect-react.d.ts

@@ -0,0 +1,2 @@
+import type { LocalDefinition } from "./types.js";
+export declare function detectReactComponents(source: string, filePath: string, extension: string): LocalDefinition[];

package/dist/local-index/detect-react.js

@@ -0,0 +1,128 @@
+import { parse } from "@babel/parser";
+import { traverse } from "@component-compass/ast-utils";
+const REACT_EXTS = new Set([".tsx", ".jsx", ".ts", ".js"]);
+export function detectReactComponents(source, filePath, extension) {
+    if (!REACT_EXTS.has(extension))
+        return [];
+    const ast = (() => {
+        try {
+            return parse(source, {
+                sourceType: "module",
+                plugins: ["typescript", "jsx", "decorators-legacy", "classProperties"],
+                errorRecovery: true,
+            });
+        }
+        catch {
+            return null;
+        }
+    })();
+    if (!ast)
+        return [];
+    const found = [];
+    const filePathSource = { type: "local", filePath };
+    traverse(ast, {
+        ExportDefaultDeclaration(path) {
+            const decl = path.node.declaration;
+            if (decl.type === "FunctionDeclaration" && decl.id && isPascalCase(decl.id.name) && returnsJsx(decl)) {
+                found.push({
+                    componentId: { kind: "react-component", export: decl.id.name, source: filePathSource },
+                    exportName: decl.id.name,
+                    isDefault: true,
+                    detector: "react-default-fn",
+                });
+            }
+            if (decl.type === "ClassDeclaration" &&
+                decl.id &&
+                isPascalCase(decl.id.name) &&
+                extendsReactClass(decl)) {
+                found.push({
+                    componentId: { kind: "react-component", export: decl.id.name, source: filePathSource },
+                    exportName: decl.id.name,
+                    isDefault: true,
+                    detector: "react-class",
+                });
+            }
+        },
+        ExportNamedDeclaration(path) {
+            const decl = path.node.declaration;
+            if (!decl)
+                return;
+            if (decl.type === "FunctionDeclaration" && decl.id && isPascalCase(decl.id.name) && returnsJsx(decl)) {
+                found.push({
+                    componentId: { kind: "react-component", export: decl.id.name, source: filePathSource },
+                    exportName: decl.id.name,
+                    isDefault: false,
+                    detector: "react-default-fn",
+                });
+            }
+            if (decl.type === "VariableDeclaration") {
+                for (const d of decl.declarations) {
+                    if (d.id.type !== "Identifier" || !isPascalCase(d.id.name) || !d.init)
+                        continue;
+                    const detector = classifyVariableInit(d.init);
+                    if (detector) {
+                        found.push({
+                            componentId: { kind: "react-component", export: d.id.name, source: filePathSource },
+                            exportName: d.id.name,
+                            isDefault: false,
+                            detector,
+                        });
+                    }
+                }
+            }
+        },
+    });
+    return found;
+}
+function isPascalCase(name) {
+    return /^[A-Z]/.test(name);
+}
+function returnsJsx(fn) {
+    if (fn.type === "ArrowFunctionExpression" && fn.body.type !== "BlockStatement") {
+        return isJsxNode(fn.body);
+    }
+    const block = fn.body;
+    if (!block || block.type !== "BlockStatement")
+        return false;
+    return block.body.some((stmt) => stmt.type === "ReturnStatement" && stmt.argument != null && isJsxNode(stmt.argument));
+}
+function isJsxNode(node) {
+    if (node.type === "JSXElement" || node.type === "JSXFragment")
+        return true;
+    if (node.type === "ConditionalExpression")
+        return isJsxNode(node.consequent) || isJsxNode(node.alternate);
+    if (node.type === "LogicalExpression")
+        return isJsxNode(node.right);
+    return false;
+}
+function extendsReactClass(decl) {
+    const sup = decl.superClass;
+    if (!sup)
+        return false;
+    if (sup.type === "Identifier") {
+        return sup.name === "Component" || sup.name === "PureComponent";
+    }
+    if (sup.type === "MemberExpression" && sup.object.type === "Identifier" && sup.object.name === "React") {
+        return (sup.property.type === "Identifier" &&
+            (sup.property.name === "Component" || sup.property.name === "PureComponent"));
+    }
+    return false;
+}
+function classifyVariableInit(init) {
+    if (init.type === "ArrowFunctionExpression" || init.type === "FunctionExpression")
+        return "react-arrow";
+    if (init.type === "CallExpression") {
+        const callee = init.callee;
+        let calleeName;
+        if (callee.type === "Identifier")
+            calleeName = callee.name;
+        else if (callee.type === "MemberExpression" && callee.property.type === "Identifier")
+            calleeName = callee.property.name;
+        if (calleeName === "forwardRef")
+            return "react-forward-ref";
+        if (calleeName === "memo")
+            return "react-memo";
+    }
+    return null;
+}
+//# sourceMappingURL=detect-react.js.map

package/dist/local-index/detect-react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-react.js","sourceRoot":"","sources":["../../src/local-index/detect-react.ts"],"names":[],"mappings":"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"}

package/dist/local-index/detect-vue.d.ts

@@ -0,0 +1,2 @@
+import type { LocalDefinition } from "./types.js";
+export declare function detectVueComponents(source: string, filePath: string, extension: string): LocalDefinition[];