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

package/README.md

@@ -0,0 +1,5 @@
+# component-compass
+
+Open-source CLI for measuring design-system component usage across multi-framework consumer repos.
+
+See the [usage docs](../../docs/usage.md) and the [v1 design spec](../../docs/superpowers/specs/2026-05-02-component-compass-design.md).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+import { runScan } from "./commands/scan.js";
+import { runInit } from "./commands/init.js";
+import { Logger } from "./util/log.js";
+import { errorStack } from "@component-compass/ast-utils";
+const VERSION = "0.1.0";
+const HELP = `component-compass <command> [options]
+
+Commands:
+  scan          Scan repo and write component-compass.json
+  init          Scaffold component-compass.config.json
+
+Scan options:
+  --config <path>      Override config path (default: ./component-compass.config.json)
+  --output <path>      Override output path
+  --capture-values     Force capture literal prop values
+  --quiet              Suppress STDOUT summary
+  --json               Print JSON to stdout (implies --quiet)
+  --fail-on <metric>   CI gate (e.g. deprecated-usage)
+  --repo-id <value>    Override scan envelope repoId (else env COMPONENT_COMPASS_REPO_ID, git remote, package.json name, or cwd hash)
+
+Other:
+  --help, -h
+  --version, -v
+`;
+async function main(argv) {
+    const log = new Logger(false);
+    if (argv.includes("--version") || argv.includes("-v")) {
+        process.stdout.write(`${VERSION}\n`);
+        return 0;
+    }
+    if (argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const [cmd, ...rest] = argv;
+    if (!cmd) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (cmd === "scan") {
+        const flags = parseFlags(rest);
+        const scanOpts = {
+            configPath: flags.config ?? "./component-compass.config.json",
+            quiet: Boolean(flags.quiet || flags.json),
+        };
+        if (flags.output)
+            scanOpts.outputOverride = flags.output;
+        if (flags.captureValues)
+            scanOpts.captureValuesOverride = true;
+        if (flags.failOn)
+            scanOpts.failOn = flags.failOn;
+        if (flags.repoId)
+            scanOpts.repoId = flags.repoId;
+        const r = await runScan(scanOpts);
+        return r.exitCode;
+    }
+    if (cmd === "init") {
+        try {
+            await runInit({ cwd: process.cwd() });
+            return 0;
+        }
+        catch (err) {
+            process.stderr.write(`init failed: ${errorStack(err)}\n`);
+            return 1;
+        }
+    }
+    log.error(`Unknown command: ${cmd}\n${HELP}`);
+    return 2;
+}
+function parseFlags(args) {
+    const out = {};
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === undefined)
+            continue;
+        if (a === "--config") {
+            const next = args[++i];
+            if (next)
+                out.config = next;
+        }
+        else if (a === "--output") {
+            const next = args[++i];
+            if (next)
+                out.output = next;
+        }
+        else if (a === "--capture-values")
+            out.captureValues = true;
+        else if (a === "--quiet")
+            out.quiet = true;
+        else if (a === "--json")
+            out.json = true;
+        else if (a === "--fail-on") {
+            const next = args[++i];
+            if (next)
+                out.failOn = next;
+        }
+        else if (a === "--repo-id") {
+            const next = args[++i];
+            if (next)
+                out.repoId = next;
+        }
+    }
+    return out;
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    process.stderr.write(`Unhandled error: ${errorStack(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+export type InitOptions = {
+    cwd: string;
+    outputPath?: string;
+};
+export declare function runInit(opts: InitOptions): Promise<void>;
+export declare function runInitCli(_argv: string[]): Promise<number>;

package/dist/commands/init.js

@@ -0,0 +1,61 @@
+import { writeFile, stat, readFile } from "node:fs/promises";
+import { basename, isAbsolute, resolve } from "node:path";
+import { errorMessage } from "@component-compass/ast-utils";
+const TEMPLATE = (repoId) => ({
+    $schema: "https://unpkg.com/@component-compass/cli/schema/config.schema.json",
+    repoId,
+    include: ["src/**/*.{ts,tsx,jsx,js,vue,html}"],
+    exclude: ["**/*.{test,spec,stories}.*", "**/node_modules/**"],
+    packageScopes: [],
+    captureValues: false,
+    output: "./component-compass.json",
+    tagRules: [],
+});
+export async function runInit(opts) {
+    const cwd = isAbsolute(opts.cwd) ? opts.cwd : resolve(opts.cwd);
+    const out = opts.outputPath ?? resolve(cwd, "component-compass.config.json");
+    // Don't clobber existing config.
+    try {
+        await stat(out);
+        throw new Error(`Config already exists at ${out}. Refusing to overwrite.`);
+    }
+    catch (err) {
+        const e = err;
+        if (e.code !== "ENOENT") {
+            // If the stat succeeded (no ENOENT), the throw above re-fires here. Detect
+            // by message and re-throw cleanly.
+            if (e.message?.startsWith("Config already exists"))
+                throw e;
+            throw err;
+        }
+    }
+    const repoId = await deriveRepoId(cwd);
+    const cfg = TEMPLATE(repoId);
+    await writeFile(out, `${JSON.stringify(cfg, null, 2)}\n`, "utf8");
+    // eslint-disable-next-line no-console
+    console.log(`Wrote ${out}.\nEdit packageScopes to declare which DS packages to track.`);
+}
+async function deriveRepoId(cwd) {
+    try {
+        const pkgRaw = await readFile(resolve(cwd, "package.json"), "utf8");
+        const pkg = JSON.parse(pkgRaw);
+        if (pkg.name)
+            return pkg.name;
+    }
+    catch {
+        // ignore
+    }
+    return basename(cwd) || "unknown";
+}
+export async function runInitCli(_argv) {
+    const cwd = process.cwd();
+    try {
+        await runInit({ cwd });
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`init failed: ${errorMessage(err)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/scan.d.ts

@@ -0,0 +1,12 @@
+export type ScanOptions = {
+    configPath: string;
+    outputOverride?: string;
+    captureValuesOverride?: boolean;
+    quiet?: boolean;
+    failOn?: string;
+    repoId?: string;
+};
+export type ScanResult = {
+    exitCode: number;
+};
+export declare function runScan(opts: ScanOptions): Promise<ScanResult>;

package/dist/commands/scan.js

@@ -0,0 +1,147 @@
+import { performance } from "node:perf_hooks";
+import { isAbsolute, resolve } from "node:path";
+import { readFile } from "node:fs/promises";
+import { loadConfig, ConfigError } from "../config/loader.js";
+import { runDiscovery } from "../manifest/run-discovery.js";
+import { buildComponentIndex } from "../manifest/index.js";
+import { buildLocalIndex } from "../local-index/index.js";
+import { walkFiles } from "../walker/files.js";
+import { createImportResolver } from "../walker/resolve-import.js";
+import { Dispatcher } from "../dispatcher.js";
+import { reactPlugin } from "@component-compass/parser-react";
+import { htmlPlugin } from "@component-compass/parser-html";
+import { litTemplatePlugin } from "@component-compass/parser-lit";
+import { vuePlugin } from "@component-compass/parser-vue";
+import { writeJson } from "../reporter/json.js";
+import { printSummary } from "../reporter/stdout.js";
+import { buildScanEnvelope } from "../envelope/index.js";
+import { isPnpProject } from "../util/pnp-check.js";
+import { Logger } from "../util/log.js";
+import { errorMessage } from "@component-compass/ast-utils";
+import { buildComponentSeeds } from "../seeds.js";
+import { parseResultsToOccurrences } from "../occurrences.js";
+import { buildScanOutput } from "../reporter/index.js";
+export async function runScan(opts) {
+    const log = new Logger(opts.quiet);
+    const t0 = performance.now();
+    let cfg;
+    try {
+        cfg = await loadConfig(opts.configPath);
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            log.error(err.message);
+            return { exitCode: 2 };
+        }
+        throw err;
+    }
+    if (isPnpProject(cfg.configDir)) {
+        log.error("yarn PnP detected; component-compass requires nodeLinker: node-modules. See docs/usage.md.");
+        return { exitCode: 2 };
+    }
+    if (opts.outputOverride)
+        cfg.output = opts.outputOverride;
+    if (opts.captureValuesOverride !== undefined)
+        cfg.captureValues = opts.captureValuesOverride;
+    const discovery = runDiscovery({
+        repoRoot: cfg.configDir,
+        packageScopes: cfg.packageScopes,
+        manifestSources: cfg.manifestSources ?? {},
+    });
+    const cems = discovery.manifests;
+    for (const d of discovery.diagnostics) {
+        if (d.code === "no-manifest-found") {
+            log.warn(`[component-compass] "${d.packageName}" matched packageScopes but no manifest could be resolved (root, re-export chain, manifestSources). Components from this package will surface with manifest: null.`);
+        }
+        else if (d.code === "untraceable-barrel") {
+            log.warn(`[component-compass] "${d.packageName}" resolved to ${d.resolvedFile} which has no statically-traceable re-exports (likely bundled). Add an entry under manifestSources to point at the source packages.`);
+        }
+        else if (d.code === "cycle-detected") {
+            log.warn(`[component-compass] cycle detected in re-export chain at ${d.file}. Truncating.`);
+        }
+    }
+    const { warnings: _compIndexWarnings, ...compIndexBase } = buildComponentIndex(cems);
+    const localIndex = await buildLocalIndex({ repoRoot: cfg.configDir });
+    const compIndex = { ...compIndexBase, local: localIndex };
+    const files = await walkFiles({
+        root: cfg.configDir,
+        include: cfg.include,
+        exclude: cfg.exclude,
+    });
+    if (files.length === 0) {
+        log.warn(`No files matched include globs: ${cfg.include.join(", ")}`);
+    }
+    const dispatcher = new Dispatcher([reactPlugin, htmlPlugin, litTemplatePlugin, vuePlugin]);
+    const resolveImportOpts = {
+        repoRoot: cfg.configDir,
+    };
+    if (cfg.aliases)
+        resolveImportOpts.aliases = cfg.aliases;
+    if (cfg.tsconfigPath) {
+        resolveImportOpts.tsconfigPath = isAbsolute(cfg.tsconfigPath)
+            ? cfg.tsconfigPath
+            : resolve(cfg.configDir, cfg.tsconfigPath);
+    }
+    const resolveImport = createImportResolver(resolveImportOpts);
+    const results = [];
+    for (const file of files) {
+        const source = await readFile(file, "utf8").catch(() => "");
+        if (!source)
+            continue;
+        for (const plugin of dispatcher.allPluginsFor(file)) {
+            try {
+                results.push(plugin.parse(file, source, {
+                    index: compIndex,
+                    config: cfg,
+                    resolveImport,
+                    repoRoot: cfg.configDir,
+                }));
+            }
+            catch (err) {
+                log.warn(`[component-compass] parse failure in ${file}: ${errorMessage(err)}`);
+            }
+        }
+    }
+    const t1 = performance.now();
+    const envelope = buildScanEnvelope({
+        cwd: cfg.configDir,
+        cliRepoIdFlag: opts.repoId,
+    });
+    const seeds = buildComponentSeeds(compIndex, results, cfg.tagRules);
+    const occurrences = parseResultsToOccurrences(results, cfg.captureValues);
+    const manifests = manifestsToRefs(cems);
+    const partialStats = {
+        filesScanned: files.length,
+        filesWithUsage: countFilesWithUsage(occurrences),
+        scanDurationMs: Math.round(t1 - t0),
+    };
+    const scanOutput = buildScanOutput(envelope, manifests, partialStats, seeds, occurrences);
+    const outputPath = isAbsolute(cfg.output) ? cfg.output : resolve(cfg.configDir, cfg.output);
+    await writeJson(scanOutput, outputPath);
+    if (!opts.quiet) {
+        printSummary(scanOutput, outputPath);
+    }
+    let exitCode = 0;
+    if (opts.failOn === "deprecated-usage") {
+        const hasDeprecated = scanOutput.components.some((c) => c.manifest?.lifecycle?.status === "deprecated" &&
+            c.stats.occurrenceCount > 0);
+        if (hasDeprecated)
+            exitCode = 1;
+    }
+    return { exitCode };
+}
+function countFilesWithUsage(occurrences) {
+    const files = new Set();
+    for (const o of occurrences)
+        files.add(o.filePath);
+    return files.size;
+}
+function manifestsToRefs(manifests) {
+    return manifests.map((m) => ({
+        source: m.kind === "cem" ? "cem" : m.manifest.source,
+        package: m.packageName,
+        path: m.path,
+        version: m.packageVersion ?? null,
+    }));
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedConfig } from "../types.js";
+export declare class ConfigError extends Error {
+    code: "CONFIG_MISSING" | "CONFIG_INVALID";
+    constructor(code: "CONFIG_MISSING" | "CONFIG_INVALID", message: string);
+}
+export declare function loadConfig(configPath: string): Promise<ResolvedConfig>;

package/dist/config/loader.js

@@ -0,0 +1,62 @@
+import { readFile, stat } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { validateConfig } from "./schema.js";
+import { errorMessage } from "@component-compass/ast-utils";
+export class ConfigError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export async function loadConfig(configPath) {
+    const abs = isAbsolute(configPath) ? configPath : resolve(process.cwd(), configPath);
+    try {
+        await stat(abs);
+    }
+    catch {
+        throw new ConfigError("CONFIG_MISSING", `component-compass config not found at ${abs}. Run \`component-compass init\` to scaffold one.`);
+    }
+    const raw = await readFile(abs, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new ConfigError("CONFIG_INVALID", `${abs} is not valid JSON: ${errorMessage(err)}`);
+    }
+    // Pre-validation legacy field detection so we surface a migration message
+    // rather than a generic "additional property" AJV error.
+    if (parsed && typeof parsed === "object" && "manifests" in parsed) {
+        throw new ConfigError("CONFIG_INVALID", `${abs}: the \`manifests\` field was removed. Replace with \`packageScopes\` (array of glob patterns matching package names). See docs/usage.md.`);
+    }
+    if (!validateConfig(parsed)) {
+        const issues = (validateConfig.errors ?? [])
+            .map((e) => `${e.instancePath || "<root>"}: ${e.message}`)
+            .join("; ");
+        throw new ConfigError("CONFIG_INVALID", `Invalid config at ${abs}: ${issues}`);
+    }
+    // parsed is now narrowed to ConfigFile by the typed validator.
+    const resolved = {
+        configPath: abs,
+        configDir: dirname(abs),
+        repoId: parsed.repoId,
+        packageScopes: parsed.packageScopes,
+        include: parsed.include,
+        exclude: parsed.exclude ?? [],
+        captureValues: parsed.captureValues ?? false,
+        output: parsed.output ?? "./component-compass.json",
+    };
+    // Optional passthroughs — only assigned when present so we satisfy
+    // `exactOptionalPropertyTypes` (undefined ≠ absent).
+    if (parsed.manifestSources !== undefined)
+        resolved.manifestSources = parsed.manifestSources;
+    if (parsed.tsconfigPath !== undefined)
+        resolved.tsconfigPath = parsed.tsconfigPath;
+    if (parsed.aliases !== undefined)
+        resolved.aliases = parsed.aliases;
+    if (parsed.tagRules !== undefined)
+        resolved.tagRules = parsed.tagRules;
+    return resolved;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,32 @@
+import type { ValidateFunction } from "ajv";
+/**
+ * A single tag rule maps imports from a matching package to an arbitrary tag
+ * string surfaced on Component identities. v1 only supports matching by
+ * `packageName` (exact); the schema's `additionalProperties: false` on `match`
+ * rejects other keys with a clear validation error.
+ */
+export type TagRule = {
+    tag: string;
+    match: {
+        packageName: string;
+    };
+};
+/**
+ * Shape of a parsed component-compass.config.json after AJV validation.
+ * Mirrors schema/config.schema.json. loader.ts applies defaults for optional
+ * fields when producing ResolvedConfig.
+ */
+export interface ConfigFile {
+    repoId: string;
+    packageScopes: string[];
+    manifestSources?: Record<string, string[]>;
+    include: string[];
+    exclude?: string[];
+    captureValues?: boolean;
+    output?: string;
+    $schema?: string;
+    tsconfigPath?: string;
+    aliases?: Record<string, string[]>;
+    tagRules?: TagRule[];
+}
+export declare const validateConfig: ValidateFunction<ConfigFile>;

package/dist/config/schema.js

@@ -0,0 +1,15 @@
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+// ajv is a CJS-only package. Same situation as @babel/traverse: under
+// module: NodeNext, the bare default import is the namespace, not the class.
+// createRequire is Node's official escape hatch for loading CJS from ESM.
+const require = createRequire(import.meta.url);
+const Ajv = require("ajv").default ?? require("ajv");
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const schemaPath = resolve(__dirname, "../../schema/config.schema.json");
+const schemaJson = JSON.parse(readFileSync(schemaPath, "utf8"));
+const ajv = new Ajv({ allErrors: true, strict: false });
+export const validateConfig = ajv.compile(schemaJson);
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,sEAAsE;AACtE,6EAA6E;AAC7E,0EAA0E;AAC1E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAA2B,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;AAE7E,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;AACzE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AA6BhE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,cAAc,GACzB,GAAG,CAAC,OAAO,CAAa,UAAU,CAAC,CAAC"}

package/dist/config/tag-rules.d.ts

@@ -0,0 +1,2 @@
+import type { TagRule } from "./schema.js";
+export declare function evaluateTagRules(packageName: string | null, rules: TagRule[] | undefined): string[];

package/dist/config/tag-rules.js

@@ -0,0 +1,34 @@
+/**
+ * Pre-computes the list of tags that apply to a Component identity given its
+ * resolved `packageName` and the user's configured `tagRules`. Pure function;
+ * called once per Component during scan-time identity assembly.
+ *
+ * v1 rules match by `packageName` only, with `*` as the sole glob metacharacter
+ * (zero-or-more chars). All other regex metacharacters are escaped so patterns
+ * are interpreted literally. See spec §6.
+ *
+ * Local components (those without a resolved package) have `packageName === null`
+ * and never match any rule.
+ */
+const REGEX_META = /[.+?^${}()|[\]\\]/g;
+const cache = new Map();
+function matcher(pattern) {
+    const cached = cache.get(pattern);
+    if (cached)
+        return cached;
+    const compiled = new RegExp(`^${pattern.replace(REGEX_META, "\\$&").replace(/\*/g, ".*")}$`);
+    cache.set(pattern, compiled);
+    return compiled;
+}
+export function evaluateTagRules(packageName, rules) {
+    if (packageName === null || !rules || rules.length === 0)
+        return [];
+    const tags = [];
+    for (const rule of rules) {
+        if (matcher(rule.match.packageName).test(packageName)) {
+            tags.push(rule.tag);
+        }
+    }
+    return tags;
+}
+//# sourceMappingURL=tag-rules.js.map

package/dist/config/tag-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-rules.js","sourceRoot":"","sources":["../../src/config/tag-rules.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,MAAM,CACzB,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAChE,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAA0B,EAC1B,KAA4B;IAE5B,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/dispatcher.d.ts

@@ -0,0 +1,8 @@
+import type { ParserPlugin } from "@component-compass/plugin-core";
+export declare class Dispatcher {
+    plugins: ParserPlugin[];
+    private byExt;
+    constructor(plugins: ParserPlugin[]);
+    pluginFor(file: string): ParserPlugin | undefined;
+    allPluginsFor(file: string): ParserPlugin[];
+}

package/dist/dispatcher.js

@@ -0,0 +1,22 @@
+import { extname } from "node:path";
+export class Dispatcher {
+    plugins;
+    byExt = new Map();
+    constructor(plugins) {
+        this.plugins = plugins;
+        for (const p of plugins) {
+            for (const ext of p.extensions) {
+                const list = this.byExt.get(ext) ?? [];
+                list.push(p);
+                this.byExt.set(ext, list);
+            }
+        }
+    }
+    pluginFor(file) {
+        return this.allPluginsFor(file)[0];
+    }
+    allPluginsFor(file) {
+        return this.byExt.get(extname(file)) ?? [];
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,OAAO,UAAU;IAGF;IAFX,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,YAAmB,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/envelope/git.d.ts

@@ -0,0 +1,13 @@
+export declare function resolveCommitSha(cwd: string): string | null;
+export declare function resolveBranch(cwd: string): string | null;
+export declare function resolveOriginRemote(cwd: string): string | 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 declare function parseRemoteUrl(url: string): string | null;