@vue-html-bridge/cli 0.1.0

package/dist/output/text.js

@@ -0,0 +1,76 @@
+function pluralize(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function evidenceSuffix(evidence) {
+    const parts = [];
+    if (evidence.variantCount > 1)
+        parts.push(`${evidence.variantCount} variants`);
+    if (evidence.truncated)
+        parts.push("truncated");
+    return parts.length > 0 ? ` (${parts.join(", ")})` : "";
+}
+/** cli.md §4.2 `--no-color`: ANSI codes for the severity token only, applied by the caller only when color is enabled. */
+const SEVERITY_COLOR = {
+    error: "", // red
+    warning: "", // yellow
+    info: "", // cyan
+    hint: "", // gray
+};
+const ANSI_RESET = "";
+function colorize(text, code, color) {
+    return color ? `${code}${text}${ANSI_RESET}` : text;
+}
+function formatDiagnostic(path, diagnostic, color) {
+    const lines = [];
+    const severityToken = colorize(diagnostic.severity, SEVERITY_COLOR[diagnostic.severity], color);
+    lines.push(`${path}:${diagnostic.position.startLine}:${diagnostic.position.startColumn} ${severityToken} ${diagnostic.code}`);
+    const adapterSuffix = diagnostic.adapterId
+        ? ` [${diagnostic.adapterId}]`
+        : "";
+    lines.push(`  ${diagnostic.message}${evidenceSuffix(diagnostic.evidence)}${adapterSuffix}`);
+    for (const related of diagnostic.relatedInformation) {
+        lines.push(`    related ${related.path}:${related.position.startLine}:${related.position.startColumn} ${related.message}`);
+    }
+    return lines.join("\n");
+}
+function formatRunError(error, color) {
+    const location = error.path ? `${error.path}: ` : "";
+    const adapterSuffix = error.adapterId ? ` [${error.adapterId}]` : "";
+    const prefix = colorize("error", SEVERITY_COLOR.error, color);
+    return `${prefix}: ${location}${error.message} (${error.code})${adapterSuffix}`;
+}
+function formatSummary(counts) {
+    const parts = [
+        pluralize(counts.errors, "error"),
+        pluralize(counts.warnings, "warning"),
+        pluralize(counts.infos, "info"),
+        pluralize(counts.hints, "hint"),
+    ];
+    const runErrorSuffix = counts.runErrors > 0 ? `, ${pluralize(counts.runErrors, "run error")}` : "";
+    return `${pluralize(counts.filesAnalyzed, "file")} analyzed: ${parts.join(", ")}${runErrorSuffix}`;
+}
+/**
+ * `writeStdout`/`writeStderr` are called with already-newline-terminated
+ * chunks; the caller owns the real stream (kept simple/testable, same
+ * pattern as output/ndjson.ts).
+ */
+export function createTextRenderer(writeStdout, writeStderr, options = {}) {
+    const color = options.color ?? false;
+    return {
+        start() {
+            // No start-of-stream marker in text mode.
+        },
+        file(path, diagnostics) {
+            for (const diagnostic of diagnostics) {
+                writeStdout(`${formatDiagnostic(path, diagnostic, color)}\n`);
+            }
+        },
+        runError(error) {
+            writeStderr(`${formatRunError(error, color)}\n`);
+        },
+        summary(counts) {
+            writeStdout(`${formatSummary(counts)}\n`);
+        },
+    };
+}
+//# sourceMappingURL=text.js.map

package/dist/output/text.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,38 @@
+import type { AdapterModuleResolver } from "@vue-html-bridge/adapter-loader";
+import { type ResolvedVueHtmlBridgeSettings } from "@vue-html-bridge/settings";
+import type { AdapterLogger, HtmlValidatorAdapter } from "@vue-html-bridge/validator-api";
+import { type FailOnThreshold } from "./exit-codes.js";
+import type { OutputRenderer } from "./types.js";
+export interface RunCliOptions {
+    /** Absolute. */
+    workspaceRoot: string;
+    /** Absolute. */
+    cwd: string;
+    positionalArgs: readonly string[];
+    settings: ResolvedVueHtmlBridgeSettings;
+    workspaceTrusted: boolean;
+    failOn: FailOnThreshold;
+    signal: AbortSignal;
+    renderer: OutputRenderer;
+    /** stderr-only notices (untrusted-mode banner, pre-analysis "no analyzable input") — always stderr regardless of `--format` (cli.md §2, §7.2 stdout validity). */
+    notice: (message: string) => void;
+    /** Injectable for tests (adapter-loader.md §6 item 8's shared contract fixture, adapter-testkit's fake adapter). */
+    moduleResolver?: AdapterModuleResolver;
+    builtins?: ReadonlyMap<string, HtmlValidatorAdapter<unknown>>;
+    logger?: AdapterLogger;
+}
+export type RunCliResult = {
+    interrupted: true;
+} | {
+    interrupted: false;
+    exitCode: number;
+};
+export declare function runCli(options: RunCliOptions): Promise<RunCliResult>;
+/**
+ * cli.md §6 step 3: `AnalyzeRequest.uri` is built from the resolved absolute
+ * real path with Node's `pathToFileURL` — its Windows drive-letter and
+ * percent-encoding rules *are* the contract, so this is a thin, exported
+ * wrapper (not a reimplementation) kept testable at the module boundary.
+ */
+export declare function toFileUri(absolutePath: string): string;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAM7E,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAQxC,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,EAAE,6BAA6B,CAAC;IACxC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,kKAAkK;IAClK,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,oHAAoH;IACpH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACtB;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA6L1E;AA0BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/runner.js

@@ -0,0 +1,221 @@
+// The execution model (cli.md §6, §8): enumeration, adapter loading,
+// analyzer lifecycle, and the run-outcome model. This module takes an
+// already-resolved settings object and a trust decision; it knows nothing
+// about flags (cli.md §11).
+import { readFile } from "node:fs/promises";
+import { relative, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+import { createWorkspaceAnalyzer, } from "@vue-html-bridge/analyzer";
+import { decomposeSettings, } from "@vue-html-bridge/settings";
+import { loadAdaptersForRun } from "./adapters.js";
+import { isSessionFailureDiagnostic, projectDiagnostic, sortCliDiagnostics, } from "./diagnostics.js";
+import { enumerateFiles } from "./enumerate.js";
+import { computeExitCode, EXIT_RUN_ERROR, severityMeetsThreshold, } from "./exit-codes.js";
+import { createLineIndex } from "./line-index.js";
+/** Bounded cleanup (cli.md §6 "Signals"): dispose never blocks exit indefinitely. */
+const DISPOSE_TIMEOUT_MS = 3000;
+export async function runCli(options) {
+    const decomposed = decomposeSettings(options.settings);
+    const enumerated = await enumerateFiles({
+        workspaceRoot: options.workspaceRoot,
+        cwd: options.cwd,
+        positionalArgs: options.positionalArgs,
+        include: decomposed.host.include,
+        exclude: decomposed.host.exclude,
+    });
+    if (enumerated.files.length === 0) {
+        // cli.md §8: "no analyzable input" is one of the reasons a run fails
+        // *before* analysis starts — stdout carries zero lines (§7.2); every
+        // message here is stderr-only, never routed through the renderer.
+        for (const error of enumerated.errors) {
+            options.notice(`${formatNoticeFromRunError(error)}\n`);
+        }
+        options.notice(`${enumerated.errors.length > 0
+            ? "No files left to analyze after resolving the given arguments."
+            : "No files matched the given include/exclude patterns."}\n`);
+        return { interrupted: false, exitCode: EXIT_RUN_ERROR };
+    }
+    if (!options.workspaceTrusted) {
+        options.notice("--untrusted: ignoring workspace validator configuration and external adapters.\n");
+    }
+    const loadResult = await loadAdaptersForRun({
+        validators: decomposed.validators,
+        workspaceRoot: options.workspaceRoot,
+        workspaceTrusted: options.workspaceTrusted,
+        externalAdapters: decomposed.host.externalAdapters,
+        moduleResolver: options.moduleResolver,
+        builtins: options.builtins,
+        logger: options.logger,
+    });
+    const runLevelErrors = [];
+    const reportedKeys = new Set();
+    /** cli.md §8: run-level errors are reported once each, keyed per their kind. */
+    function reportRunError(error, dedupeKey) {
+        if (reportedKeys.has(dedupeKey))
+            return;
+        reportedKeys.add(dedupeKey);
+        runLevelErrors.push(error);
+        options.renderer.runError(error);
+    }
+    const analyzer = await createWorkspaceAnalyzer({
+        workspaceRoot: options.workspaceRoot,
+        adapters: loadResult.adapters,
+        generateOptions: decomposed.generateOptions,
+        maxConcurrency: decomposed.analyzer.maxConcurrency,
+        logger: options.logger,
+    });
+    const counts = {
+        filesAnalyzed: 0,
+        errors: 0,
+        warnings: 0,
+        infos: 0,
+        hints: 0,
+        runErrors: 0,
+    };
+    let hasThresholdDiagnostic = false;
+    try {
+        // A run that reaches here *is* reaching analysis — emit the stream's
+        // start marker (NDJSON's `meta`; a no-op for text) before anything else,
+        // then report the enumeration/adapter-load failures already known.
+        options.renderer.start();
+        for (const error of enumerated.errors) {
+            reportRunError(error, `enumerate:${error.message}`);
+        }
+        for (const failure of loadResult.failures) {
+            reportRunError({ code: `adapter-load/${failure.kind}`, message: failure.message }, `adapter-load:${failure.dedupeKey}`);
+        }
+        for (const absolutePath of enumerated.files) {
+            if (options.signal.aborted)
+                break;
+            const relPath = toWorkspaceRelativePosix(options.workspaceRoot, absolutePath);
+            let source;
+            try {
+                source = await readFile(absolutePath, "utf8");
+            }
+            catch (error) {
+                reportRunError({
+                    code: "file-unreadable",
+                    message: `Failed to read "${relPath}": ${errorMessage(error)}`,
+                    path: relPath,
+                }, `file-read:${relPath}`);
+                continue;
+            }
+            let result;
+            try {
+                result = await analyzer.analyze({
+                    uri: toFileUri(absolutePath),
+                    filename: absolutePath,
+                    source,
+                    signal: options.signal,
+                });
+            }
+            catch (error) {
+                if (options.signal.aborted)
+                    break; // cancellation is not a diagnostic
+                reportRunError({
+                    code: "internal-error",
+                    message: `Analysis failed for "${relPath}": ${errorMessage(error)}`,
+                    path: relPath,
+                }, `internal:${relPath}`);
+                continue;
+            }
+            // A result that completed just as the signal fired is discarded, not
+            // rendered (cli.md §6: "cancellation is not a diagnostic").
+            if (options.signal.aborted)
+                break;
+            const index = createLineIndex(source);
+            const perFileDiagnostics = [];
+            for (const diagnostic of result.diagnostics) {
+                if (isSessionFailureDiagnostic(diagnostic)) {
+                    // cli.md §8: the analyzer places this on every analyzed file; the
+                    // CLI reports it once at run level and drops it from the file's
+                    // own diagnostics list.
+                    reportRunError({
+                        code: diagnostic.code,
+                        message: diagnostic.message,
+                        ...(diagnostic.adapterId !== undefined
+                            ? { adapterId: diagnostic.adapterId }
+                            : {}),
+                    }, `session:${diagnostic.adapterId ?? ""}:${diagnostic.code}`);
+                    continue;
+                }
+                perFileDiagnostics.push(diagnostic);
+            }
+            const projected = sortCliDiagnostics(perFileDiagnostics.map((diagnostic) => projectDiagnostic(diagnostic, index, relPath)));
+            for (const diagnostic of projected) {
+                tallySeverity(counts, diagnostic.severity);
+                if (severityMeetsThreshold(diagnostic.severity, options.failOn)) {
+                    hasThresholdDiagnostic = true;
+                }
+            }
+            counts.filesAnalyzed += 1;
+            options.renderer.file(relPath, projected);
+        }
+    }
+    finally {
+        await disposeBounded(analyzer);
+    }
+    if (options.signal.aborted) {
+        // cli.md §7.2: no `summary` line on interruption — the caller (bin.ts)
+        // knows which signal fired and picks 130/143.
+        return { interrupted: true };
+    }
+    counts.runErrors = runLevelErrors.length;
+    options.renderer.summary(counts);
+    return {
+        interrupted: false,
+        exitCode: computeExitCode({
+            hasRunLevelError: runLevelErrors.length > 0,
+            hasThresholdDiagnostic,
+        }),
+    };
+}
+function tallySeverity(counts, severity) {
+    switch (severity) {
+        case "error":
+            counts.errors += 1;
+            break;
+        case "warning":
+            counts.warnings += 1;
+            break;
+        case "info":
+            counts.infos += 1;
+            break;
+        case "hint":
+            counts.hints += 1;
+            break;
+    }
+}
+function toWorkspaceRelativePosix(root, absolutePath) {
+    return relative(root, absolutePath).split(sep).join("/");
+}
+/**
+ * cli.md §6 step 3: `AnalyzeRequest.uri` is built from the resolved absolute
+ * real path with Node's `pathToFileURL` — its Windows drive-letter and
+ * percent-encoding rules *are* the contract, so this is a thin, exported
+ * wrapper (not a reimplementation) kept testable at the module boundary.
+ */
+export function toFileUri(absolutePath) {
+    return pathToFileURL(absolutePath).href;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function formatNoticeFromRunError(error) {
+    return `error: ${error.message} (${error.code})`;
+}
+async function disposeBounded(analyzer) {
+    let timer;
+    const timeout = new Promise((resolvePromise) => {
+        timer = setTimeout(resolvePromise, DISPOSE_TIMEOUT_MS);
+        timer.unref();
+    });
+    try {
+        await Promise.race([analyzer.dispose(), timeout]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/settings-resolution.d.ts

@@ -0,0 +1,27 @@
+import { type ResolvedVueHtmlBridgeSettings, type SettingsIssue, type VueHtmlBridgeSettingsInput } from "@vue-html-bridge/settings";
+import { type ValidatorFlagOp } from "./options.js";
+export interface ResolveCliSettingsOptions {
+    /** Absolute. */
+    workspaceRoot: string;
+    /** Absolute; `--config`'s relative path is resolved against this (cli.md §4.1 resolves it "from the current working directory"). */
+    cwd: string;
+    /** Raw `--config` value, if given. */
+    configPath?: string;
+    /** The flags layer built by options.ts, minus the three validator flags. */
+    flagsInput: VueHtmlBridgeSettingsInput;
+    validatorOps: readonly ValidatorFlagOp[];
+    untrusted: boolean;
+}
+export type ResolveCliSettingsResult = {
+    kind: "ok";
+    settings: ResolvedVueHtmlBridgeSettings;
+    workspaceTrusted: boolean;
+    /** Warning-severity issues (settings.md §4), for the caller to print to stderr. */
+    warnings: readonly SettingsIssue[];
+} | {
+    kind: "fatal";
+    /** Every issue (error-severity ones are why this run is fatal; warnings are included too, for a complete stderr report). */
+    issues: readonly SettingsIssue[];
+};
+export declare function resolveCliSettings(options: ResolveCliSettingsOptions): Promise<ResolveCliSettingsResult>;
+//# sourceMappingURL=settings-resolution.d.ts.map

package/dist/settings-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-resolution.d.ts","sourceRoot":"","sources":["../src/settings-resolution.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,6BAA6B,EAClC,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,oIAAoI;IACpI,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,UAAU,EAAE,0BAA0B,CAAC;IACvC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,wBAAwB,GAChC;IACE,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,6BAA6B,CAAC;IACxC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,4HAA4H;IAC5H,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAClC,CAAC;AAEN,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA+CnC"}

package/dist/settings-resolution.js

@@ -0,0 +1,48 @@
+// Settings sourcing (cli.md §4.1): loads the config-file layer (explicit
+// `--config`, or discovered `.vue-html-bridge.json`/`package.json#vueHtmlBridge`),
+// merges it with the flags layer through the shared `resolveSettings`, then
+// applies the two CLI-specific, post-resolution steps that are *not* part of
+// `resolveSettings` itself: the §4.3 validator-flag patches and the §5
+// `--untrusted` trust forcing. `resolveSettings`'s own semantics are used
+// unchanged — this module decides only what the CLI does with the result
+// (fatal vs. warn, per §4.1).
+import { isAbsolute, resolve } from "node:path";
+import { createNodeFileSystem, loadSettingsFile, loadWorkspaceSettingsFile, resolveSettings, } from "@vue-html-bridge/settings";
+import { applyValidatorFlagOps } from "./options.js";
+export async function resolveCliSettings(options) {
+    const fileSystem = createNodeFileSystem();
+    const configLayerResult = options.configPath !== undefined
+        ? await loadSettingsFile(isAbsolute(options.configPath)
+            ? options.configPath
+            : resolve(options.cwd, options.configPath), fileSystem)
+        : await loadWorkspaceSettingsFile(options.workspaceRoot, fileSystem);
+    const { settings, issues } = resolveSettings([
+        configLayerResult.settings,
+        options.flagsInput,
+    ]);
+    const allIssues = [...configLayerResult.issues, ...issues];
+    const hasFatalIssue = allIssues.some((issue) => issue.severity === "error");
+    if (hasFatalIssue) {
+        return { kind: "fatal", issues: allIssues };
+    }
+    const patchedValidators = applyValidatorFlagOps(settings.validators, options.validatorOps);
+    // §5: `--untrusted` forces externalAdapters to "disabled" regardless of
+    // what resolution produced — it "wins over any conflicting trust-related
+    // flag or setting" — and every other resolved field is left untouched
+    // (host-neutral settings apply the same either way, per §5).
+    const workspaceTrusted = !options.untrusted;
+    const externalAdapters = options.untrusted
+        ? "disabled"
+        : settings.externalAdapters;
+    return {
+        kind: "ok",
+        settings: {
+            ...settings,
+            validators: patchedValidators,
+            externalAdapters,
+        },
+        workspaceTrusted,
+        warnings: allIssues.filter((issue) => issue.severity === "warning"),
+    };
+}
+//# sourceMappingURL=settings-resolution.js.map

package/dist/settings-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-resolution.js","sourceRoot":"","sources":["../src/settings-resolution.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mFAAmF;AACnF,4EAA4E;AAC5E,6EAA6E;AAC7E,uEAAuE;AACvE,0EAA0E;AAC1E,yEAAyE;AACzE,8BAA8B;AAC9B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,GAIhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,cAAc,CAAC;AA6B3E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkC;IAElC,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAE1C,MAAM,iBAAiB,GACrB,OAAO,CAAC,UAAU,KAAK,SAAS;QAC9B,CAAC,CAAC,MAAM,gBAAgB,CACpB,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;YAC5B,CAAC,CAAC,OAAO,CAAC,UAAU;YACpB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,EAC5C,UAAU,CACX;QACH,CAAC,CAAC,MAAM,yBAAyB,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAEzE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;QAC3C,iBAAiB,CAAC,QAAQ;QAC1B,OAAO,CAAC,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5E,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,iBAAiB,GAAG,qBAAqB,CAC7C,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,YAAY,CACrB,CAAC;IAEF,wEAAwE;IACxE,yEAAyE;IACzE,sEAAsE;IACtE,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS;QACxC,CAAC,CAAE,UAAoB;QACvB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAE9B,OAAO;QACL,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,UAAU,EAAE,iBAAiB;YAC7B,gBAAgB;SACjB;QACD,gBAAgB;QAChB,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/** cli.md §7.2 `CliNdjsonDiagnostic`, and the shape `--format text` renders from. */
+export interface CliDiagnosticRange {
+    start: number;
+    end: number;
+}
+export interface CliDiagnosticPosition {
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+export interface CliDiagnosticRelated {
+    /** Workspace-relative, "/"-separated. */
+    path: string;
+    range: CliDiagnosticRange;
+    position: CliDiagnosticPosition;
+    message: string;
+}
+export interface CliDiagnosticEvidence {
+    variantCount: number;
+    truncated: boolean;
+}
+export interface CliDiagnostic {
+    severity: "error" | "warning" | "info" | "hint";
+    code: string;
+    message: string;
+    origin: "core" | "validator" | "adapter";
+    adapterId?: string;
+    codeDescriptionHref?: string;
+    range: CliDiagnosticRange;
+    position: CliDiagnosticPosition;
+    relatedInformation: readonly CliDiagnosticRelated[];
+    evidence: CliDiagnosticEvidence;
+}
+/**
+ * cli.md §8: a problem with the run itself, distinct from a diagnostic.
+ * Reported once each (deduplicated by the caller), regardless of format.
+ */
+export interface RunLevelError {
+    /** e.g. "adapter/markuplint/configuration-error", "file-unreadable", "adapter-load/invalid-shape". */
+    code: string;
+    message: string;
+    adapterId?: string;
+    /** Workspace-relative, "/"-separated, when the error is file-scoped. */
+    path?: string;
+}
+export interface RunSummaryCounts {
+    filesAnalyzed: number;
+    errors: number;
+    warnings: number;
+    infos: number;
+    hints: number;
+    runErrors: number;
+}
+/**
+ * The streaming contract both `output/text.ts` and `output/ndjson.ts`
+ * implement (cli.md §6 step 5, §7): `runner.ts` renders each file's result
+ * as it completes rather than buffering the whole run, and is otherwise
+ * agnostic to the chosen format. Each renderer owns where a given call ends
+ * up (stdout vs. stderr) — text sends `runError` to stderr (§7.1), NDJSON
+ * sends it to stdout as a `runError` record (§7.2) — so `runner.ts` never
+ * writes to a stream directly.
+ */
+export interface OutputRenderer {
+    /** Emitted once, only for a run that reaches analysis (NDJSON's `meta` line; a no-op for text). */
+    start(): void;
+    /** One call per file, in completion order, with diagnostics already sorted (diagnostics.ts). */
+    file(path: string, diagnostics: readonly CliDiagnostic[]): void;
+    /** One call per run-level error, as it occurs (already deduplicated by the caller). */
+    runError(error: RunLevelError): void;
+    /** Called once, at the very end, only when the run completed without interruption. */
+    summary(counts: RunSummaryCounts): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,kBAAkB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,sGAAsG;IACtG,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,KAAK,IAAI,IAAI,CAAC;IACd,gGAAgG;IAChG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;IAChE,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,sFAAsF;IACtF,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACzC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+// Shared internal types used across runner.ts and the output/ renderers,
+// factored out so the output modules never need to import runner.ts (cli.md
+// §11: "output modules take fully converted positions and never see the
+// analyzer types beyond SourceDiagnostic").
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,4CAA4C"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vue-html-bridge/cli",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "One-shot command-line client for vue-html-bridge analysis.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "vue-html-bridge": "./dist/bin.js"
+  },
+  "dependencies": {
+    "minimatch": "10.2.6",
+    "@vue-html-bridge/analyzer": "0.1.0",
+    "@vue-html-bridge/adapter-loader": "0.1.0",
+    "@vue-html-bridge/validator-api": "0.1.0",
+    "@vue-html-bridge/settings": "0.1.0",
+    "@vue-html-bridge/adapter-markuplint": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "26.2.0",
+    "vitest": "4.1.11",
+    "vscode-jsonrpc": "9.0.1",
+    "vscode-languageserver": "10.1.0",
+    "vscode-uri": "3.1.0",
+    "@vue-html-bridge/adapter-testkit": "0.1.0",
+    "@vue-html-bridge/language-server": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/bin.js",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}