@vue-html-bridge/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masato Nagashima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# `@vue-html-bridge/cli`
+
+A one-shot command-line client for [vue-html-bridge](https://github.com/vue-html-bridge/vue-html-bridge):
+runs the same analysis as the language server, for CI pipelines,
+pre-commit hooks, and ad-hoc terminal use. It accepts the same settings
+schema as the editor (`@vue-html-bridge/settings`) as command-line flags,
+and loads adapters through the same `@vue-html-bridge/adapter-loader` — the
+CLI and the language server are guaranteed to report the same diagnostics
+for the same file under the same resolved settings and trust policy.
+
+## Installation
+
+```sh
+npm install --global @vue-html-bridge/cli
+```
+
+or as a project `devDependency` invoked via `npx vue-html-bridge` / a
+package-manager script.
+
+## Usage
+
+```sh
+vue-html-bridge src/components
+```
+
+```text
+src/components/Menu.vue:6:27 error no-refer-to-non-existent-id
+  Missing "missing" ID [markuplint]
+3 files analyzed: 1 error, 0 warnings, 0 infos, 0 hints
+```
+
+With no positional arguments, the `include` setting (default `**/*.vue`,
+relative to `--workspace-root`, default the current directory) is used
+instead. Exit code `0` means no diagnostic reached the `--fail-on` threshold
+(default `error`); `1` means one did; `2` means a run-level problem occurred
+(a bad argument, a fatal settings issue, a file that couldn't be read, an
+adapter that failed to load) — see below. `130`/`143` on `SIGINT`/`SIGTERM`.
+
+Machine-readable output:
+
+```sh
+vue-html-bridge --format ndjson src/components
+```
+
+emits one self-contained JSON object per line (`meta`, then one `file` line
+per analyzed file as it completes, then a `summary` line) — safe to pipe
+into another process and to parse incrementally; see
+[`docs/design/packages/cli.md`](../../docs/design/packages/cli.md) §7.2 for
+the full record shapes and their versioning contract (`CliNdjsonRecord`,
+also exported from this package's own public API for TypeScript consumers).
+
+Run `vue-html-bridge --help` for the full flag reference — every field of
+the shared settings schema that's meaningful outside an editor session has a
+corresponding flag, listed in cli.md §4.2.
+
+## Trust
+
+Running the CLI in a repository is treated the same as running any other
+linter's CLI there: **trusted by default** — it reads the workspace's
+validator config, including JS config and plugins, exactly as a trusted
+editor session would. Pass `--untrusted` for CI jobs analyzing untrusted
+contributions: it forces `externalAdapters` off and the built-in Markuplint
+adapter to its bundled, safe default config, while leaving every
+host-neutral setting (`include`/`exclude`, `maxConcurrency`, output format,
+`--fail-on`) unaffected.
+
+## Configuration
+
+The same `.vue-html-bridge.json` / `package.json#vueHtmlBridge` file the
+language server discovers is used here too — flags and `--config <path>`
+simply layer on top with the same precedence and validation rules as
+`workspace/configuration` does for the editor
+(`@vue-html-bridge/settings`'s `resolveSettings`, applied identically by
+both hosts). Unlike the editor, an **`error`-severity settings issue is
+fatal** here (exit `2`, before any analysis runs) rather than falling back —
+CI must fail loudly on misconfiguration, not analyze with silently-wrong
+settings.
+
+See [`docs/design/packages/cli.md`](../../docs/design/packages/cli.md) for
+the complete flag surface, the NDJSON contract, and the run-outcome/exit-code
+model.

package/dist/adapters.d.ts

@@ -0,0 +1,29 @@
+import { type AdapterLoadFailure, type AdapterModuleResolver } from "@vue-html-bridge/adapter-loader";
+import type { ConfiguredAdapter } from "@vue-html-bridge/analyzer";
+import type { ResolvedValidatorSetting } from "@vue-html-bridge/settings";
+import type { AdapterLogger, HtmlValidatorAdapter } from "@vue-html-bridge/validator-api";
+export declare const BUILTIN_MARKUPLINT_ID = "markuplint";
+/**
+ * cli.md §4.2/§5: in an untrusted run (`--untrusted`), the built-in
+ * Markuplint adapter runs with its bundled, safe default config — no
+ * `configFile`, forced `searchConfig: false`, so it never loads workspace JS
+ * config or plugins. A trusted run uses the entry's own configured settings
+ * unchanged.
+ */
+export declare function builtinMarkuplintSettings(entry: ResolvedValidatorSetting | undefined, workspaceTrusted: boolean): unknown;
+export interface LoadAdaptersForRunOptions {
+    validators: readonly ResolvedValidatorSetting[];
+    workspaceRoot: string;
+    workspaceTrusted: boolean;
+    externalAdapters: "disabled" | "trusted-workspace-only";
+    moduleResolver?: AdapterModuleResolver;
+    logger?: AdapterLogger;
+    /** Overridable for tests (adapter-loader.md §6 item 8's shared contract fixture); defaults to the real built-in Markuplint adapter. */
+    builtins?: ReadonlyMap<string, HtmlValidatorAdapter<unknown>>;
+}
+export interface LoadAdaptersForRunResult {
+    adapters: readonly ConfiguredAdapter[];
+    failures: readonly AdapterLoadFailure[];
+}
+export declare function loadAdaptersForRun(options: LoadAdaptersForRunOptions): Promise<LoadAdaptersForRunResult>;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAOlD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAAG,SAAS,EAC3C,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAGT;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,UAAU,GAAG,wBAAwB,CAAC;IACxD,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,uIAAuI;IACvI,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAiCnC"}

package/dist/adapters.js

@@ -0,0 +1,55 @@
+// Adapter loading (cli.md §5, §6 step 1): a thin wrapper over
+// @vue-html-bridge/adapter-loader, mirroring
+// packages/language-server/src/adapters/loading.ts's shape — the loader
+// invocation and failure handling are identical between the two hosts; only
+// the trust *default* differs (cli.md §5: trusted by default, restricted by
+// `--untrusted`, vs. the LSP's untrusted-by-default). The built-in
+// Markuplint adapter's own trust-based settings restriction
+// (packages/language-server/src/adapters/trust.ts's `builtinMarkuplintSettings`)
+// is reused verbatim here since it is not exported by that internal module.
+import { markuplintAdapter } from "@vue-html-bridge/adapter-markuplint";
+import { loadConfiguredAdapters, } from "@vue-html-bridge/adapter-loader";
+export const BUILTIN_MARKUPLINT_ID = "markuplint";
+const DEFAULT_BUILTINS = new Map([[BUILTIN_MARKUPLINT_ID, markuplintAdapter]]);
+/**
+ * cli.md §4.2/§5: in an untrusted run (`--untrusted`), the built-in
+ * Markuplint adapter runs with its bundled, safe default config — no
+ * `configFile`, forced `searchConfig: false`, so it never loads workspace JS
+ * config or plugins. A trusted run uses the entry's own configured settings
+ * unchanged.
+ */
+export function builtinMarkuplintSettings(entry, workspaceTrusted) {
+    if (!workspaceTrusted)
+        return { searchConfig: false };
+    return entry?.settings ?? {};
+}
+export async function loadAdaptersForRun(options) {
+    const markuplintEntry = options.validators.find((entry) => entry.adapter === BUILTIN_MARKUPLINT_ID);
+    const result = await loadConfiguredAdapters({
+        validators: options.validators,
+        workspaceRoot: options.workspaceRoot,
+        trust: {
+            workspaceTrusted: options.workspaceTrusted,
+            externalAdapters: options.externalAdapters,
+        },
+        builtins: options.builtins ?? DEFAULT_BUILTINS,
+        moduleResolver: options.moduleResolver,
+        logger: options.logger,
+    });
+    const adapters = result.adapters.map((loaded) => {
+        if (loaded.entryKey === BUILTIN_MARKUPLINT_ID) {
+            return {
+                adapter: loaded.adapter,
+                settings: builtinMarkuplintSettings(markuplintEntry, options.workspaceTrusted),
+                enabled: loaded.enabled,
+            };
+        }
+        return {
+            adapter: loaded.adapter,
+            settings: loaded.settings,
+            enabled: loaded.enabled,
+        };
+    });
+    return { adapters, failures: result.failures };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,6CAA6C;AAC7C,wEAAwE;AACxE,4EAA4E;AAC5E,4EAA4E;AAC5E,mEAAmE;AACnE,4DAA4D;AAC5D,iFAAiF;AACjF,4EAA4E;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EACL,sBAAsB,GAGvB,MAAM,iCAAiC,CAAC;AAQzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD,MAAM,gBAAgB,GAGlB,IAAI,GAAG,CAAC,CAAC,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA2C,EAC3C,gBAAyB;IAEzB,IAAI,CAAC,gBAAgB;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACtD,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC;AAC/B,CAAC;AAkBD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkC;IAElC,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,qBAAqB,CACnD,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;QAC1C,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,KAAK,EAAE;YACL,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C;QACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB;QAC9C,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAwB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACnE,IAAI,MAAM,CAAC,QAAQ,KAAK,qBAAqB,EAAE,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,yBAAyB,CACjC,eAAe,EACf,OAAO,CAAC,gBAAgB,CACzB;gBACD,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+// Process entry point (cli.md §2, §6 "Signals"): wires real stdio, reads the
+// package's own version for `--version`, and handles SIGINT/SIGTERM —
+// abort the in-flight run through an AbortSignal, bounded cleanup (runner.ts
+// owns the actual dispose bound), exit 130/143, and a second signal during
+// cleanup exits immediately. stdout carries analysis results only; logs,
+// progress, and notices go to stderr (mirrors the language server's rule).
+import { createRequire } from "node:module";
+import { runVueHtmlBridgeCli } from "./cli.js";
+import { EXIT_SIGINT, EXIT_SIGTERM } from "./exit-codes.js";
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json");
+const controller = new AbortController();
+let signalCount = 0;
+/** Set once, by whichever of SIGINT/SIGTERM fires first — that is the exit code used once the aborted run actually stops (cli.md §6). */
+let firstSignalExitCode;
+function onSignal(exitCode) {
+    signalCount += 1;
+    if (signalCount === 1) {
+        firstSignalExitCode = exitCode;
+        controller.abort();
+        return;
+    }
+    // A second signal during cleanup exits immediately (cli.md §6), using
+    // whichever code corresponds to *this* second signal.
+    process.exit(exitCode);
+}
+process.on("SIGINT", () => onSignal(EXIT_SIGINT));
+process.on("SIGTERM", () => onSignal(EXIT_SIGTERM));
+async function main() {
+    const result = await runVueHtmlBridgeCli({
+        argv: process.argv.slice(2),
+        cwd: process.cwd(),
+        writeStdout(chunk) {
+            process.stdout.write(chunk);
+        },
+        writeStderr(chunk) {
+            process.stderr.write(chunk);
+        },
+        signal: controller.signal,
+        version: packageJson.version,
+        stdoutIsTty: process.stdout.isTTY === true,
+        noColorEnv: process.env["NO_COLOR"] !== undefined,
+    });
+    if (result.interrupted) {
+        process.exit(firstSignalExitCode ?? EXIT_SIGINT);
+    }
+    process.exit(result.exitCode);
+}
+main().catch((error) => {
+    process.stderr.write(`vue-html-bridge: internal error: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(2);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,6EAA6E;AAC7E,sEAAsE;AACtE,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;AACzC,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,yIAAyI;AACzI,IAAI,mBAAuC,CAAC;AAE5C,SAAS,QAAQ,CAAC,QAAgB;IAChC,WAAW,IAAI,CAAC,CAAC;IACjB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,mBAAmB,GAAG,QAAQ,CAAC;QAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IACD,sEAAsE;IACtE,sDAAsD;IACtD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;AAClD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,WAAW,CAAC,KAAK;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,WAAW,CAAC,KAAK;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;QAC1C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;KAClD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,mBAAmB,IAAI,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAC/F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,27 @@
+import type { AdapterModuleResolver } from "@vue-html-bridge/adapter-loader";
+import type { AdapterLogger, HtmlValidatorAdapter } from "@vue-html-bridge/validator-api";
+export interface CliIo {
+    argv: readonly string[];
+    /** Absolute. */
+    cwd: string;
+    writeStdout: (chunk: string) => void;
+    writeStderr: (chunk: string) => void;
+    signal: AbortSignal;
+    /** The package's own version, for `--version` (bin.ts reads it from package.json). */
+    version: string;
+    /** cli.md §4.2: color is used only when stdout is a TTY and `NO_COLOR` is unset (and `--no-color` isn't given). */
+    stdoutIsTty?: boolean;
+    noColorEnv?: boolean;
+    /** 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 CliInvocationResult = {
+    interrupted: true;
+} | {
+    interrupted: false;
+    exitCode: number;
+};
+export declare function runVueHtmlBridgeCli(io: CliIo): Promise<CliInvocationResult>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAQxC,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,mHAAmH;IACnH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,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,mBAAmB,GAC7B;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAOnE,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,KAAK,GACR,OAAO,CAAC,mBAAmB,CAAC,CAwF9B"}

package/dist/cli.js

@@ -0,0 +1,93 @@
+// Top-level orchestration (cli.md §11): argument parsing dispatch,
+// --help/--version, usage errors, settings sourcing, and handing off to
+// runner.ts. bin.ts owns only the real process/stdio/signal wiring; this
+// module is what a test drives directly, with injectable I/O.
+import { realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { EXIT_RUN_ERROR, EXIT_SUCCESS } from "./exit-codes.js";
+import { HELP_TEXT, parseArgv } from "./options.js";
+import { createNdjsonRenderer } from "./output/ndjson.js";
+import { createTextRenderer } from "./output/text.js";
+import { runCli } from "./runner.js";
+import { resolveCliSettings } from "./settings-resolution.js";
+function formatSettingsIssue(issue) {
+    const location = issue.sourcePath ? `${issue.sourcePath}: ` : "";
+    return `${issue.severity}: ${location}${issue.message}`;
+}
+export async function runVueHtmlBridgeCli(io) {
+    const parsed = parseArgv(io.argv);
+    if (parsed.kind === "error") {
+        io.writeStderr(`vue-html-bridge: ${parsed.message}\n\n${HELP_TEXT}`);
+        return { interrupted: false, exitCode: EXIT_RUN_ERROR };
+    }
+    const options = parsed.options;
+    if (options.help) {
+        io.writeStdout(HELP_TEXT);
+        return { interrupted: false, exitCode: EXIT_SUCCESS };
+    }
+    if (options.version) {
+        io.writeStdout(`${io.version}\n`);
+        return { interrupted: false, exitCode: EXIT_SUCCESS };
+    }
+    const rawWorkspaceRoot = options.workspaceRoot !== undefined
+        ? resolve(io.cwd, options.workspaceRoot)
+        : io.cwd;
+    // Canonicalize once, up front: every downstream absolute-path comparison
+    // (enumeration's workspace-boundary check, workspace-relative output
+    // paths, the dedup-by-real-path rule in cli.md §6) assumes `workspaceRoot`
+    // and `cwd` are already real paths — e.g. on macOS, the OS temp directory
+    // is itself a symlink (/var -> /private/var), and comparing an
+    // un-resolved root against realpath()-resolved file paths would otherwise
+    // produce a spurious "outside the workspace" escape in relative-path math.
+    let workspaceRoot;
+    let cwd;
+    try {
+        [workspaceRoot, cwd] = await Promise.all([
+            realpath(rawWorkspaceRoot),
+            realpath(io.cwd),
+        ]);
+    }
+    catch (error) {
+        io.writeStderr(`vue-html-bridge: error: could not resolve the workspace root "${rawWorkspaceRoot}": ${error instanceof Error ? error.message : String(error)}\n`);
+        return { interrupted: false, exitCode: EXIT_RUN_ERROR };
+    }
+    const settingsResult = await resolveCliSettings({
+        workspaceRoot,
+        cwd,
+        configPath: options.configPath,
+        flagsInput: options.settingsInput,
+        validatorOps: options.validatorOps,
+        untrusted: options.untrusted,
+    });
+    if (settingsResult.kind === "fatal") {
+        for (const issue of settingsResult.issues) {
+            io.writeStderr(`${formatSettingsIssue(issue)}\n`);
+        }
+        return { interrupted: false, exitCode: EXIT_RUN_ERROR };
+    }
+    for (const warning of settingsResult.warnings) {
+        io.writeStderr(`${formatSettingsIssue(warning)}\n`);
+    }
+    const color = !options.noColor && io.stdoutIsTty === true && io.noColorEnv !== true;
+    const renderer = options.format === "ndjson"
+        ? createNdjsonRenderer(io.writeStdout)
+        : createTextRenderer(io.writeStdout, io.writeStderr, { color });
+    const result = await runCli({
+        workspaceRoot,
+        cwd,
+        positionalArgs: options.positionalArgs,
+        settings: settingsResult.settings,
+        workspaceTrusted: settingsResult.workspaceTrusted,
+        failOn: options.failOn,
+        signal: io.signal,
+        renderer,
+        notice: io.writeStderr,
+        moduleResolver: io.moduleResolver,
+        builtins: io.builtins,
+        logger: io.logger,
+    });
+    if (result.interrupted)
+        return { interrupted: true };
+    return { interrupted: false, exitCode: result.exitCode };
+}
+//# 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/diagnostics.d.ts

@@ -0,0 +1,22 @@
+import type { SourceDiagnostic } from "@vue-html-bridge/analyzer";
+import { type LineIndex } from "./line-index.js";
+import type { CliDiagnostic } from "./types.js";
+/**
+ * `relatedInformation` is restricted to the same file/URI in the initial
+ * version (analyzer.md §6.1, mirrored by language-server's diagnostics.ts) —
+ * there is no cross-file mapping yet — so every related entry uses the same
+ * `filePath`/`index` as the primary diagnostic.
+ */
+export declare function projectDiagnostic(diagnostic: SourceDiagnostic, index: LineIndex, filePath: string): CliDiagnostic;
+/** cli.md §7: "Diagnostic ordering within a file is deterministic: range, severity, origin, adapterId, code, message." */
+export declare function sortCliDiagnostics(diagnostics: readonly CliDiagnostic[]): readonly CliDiagnostic[];
+/**
+ * language-server.md §7.3's session-failure detection (server.ts's
+ * `SESSION_FAILURE_CODE`), reused verbatim (cli.md §8): a `SourceDiagnostic`
+ * with `origin: "adapter"` whose code matches this shape is a session-level
+ * adapter failure that the analyzer places on *every* analyzed file. The CLI
+ * reports it once at run level instead of repeating it per file.
+ */
+export declare const SESSION_FAILURE_CODE: RegExp;
+export declare function isSessionFailureDiagnostic(diagnostic: SourceDiagnostic): boolean;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,GACf,aAAa,CAyBf;AAyBD,0HAA0H;AAC1H,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,SAAS,aAAa,EAAE,GACpC,SAAS,aAAa,EAAE,CAW1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QACgC,CAAC;AAElE,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAKT"}

package/dist/diagnostics.js

@@ -0,0 +1,71 @@
+import {} from "./line-index.js";
+/**
+ * `relatedInformation` is restricted to the same file/URI in the initial
+ * version (analyzer.md §6.1, mirrored by language-server's diagnostics.ts) —
+ * there is no cross-file mapping yet — so every related entry uses the same
+ * `filePath`/`index` as the primary diagnostic.
+ */
+export function projectDiagnostic(diagnostic, index, filePath) {
+    return {
+        severity: diagnostic.severity,
+        code: diagnostic.code,
+        message: diagnostic.message,
+        origin: diagnostic.origin,
+        ...(diagnostic.adapterId !== undefined
+            ? { adapterId: diagnostic.adapterId }
+            : {}),
+        ...(diagnostic.codeDescriptionHref !== undefined
+            ? { codeDescriptionHref: diagnostic.codeDescriptionHref }
+            : {}),
+        range: {
+            start: diagnostic.sourceRange.start,
+            end: diagnostic.sourceRange.end,
+        },
+        position: index.toRangePosition(diagnostic.sourceRange),
+        relatedInformation: diagnostic.relatedInformation.map((related) => projectRelated(related, index, filePath)),
+        evidence: {
+            variantCount: diagnostic.evidence.variantCount,
+            truncated: diagnostic.evidence.truncated,
+        },
+    };
+}
+function projectRelated(related, index, filePath) {
+    return {
+        path: filePath,
+        range: {
+            start: related.sourceRange.start,
+            end: related.sourceRange.end,
+        },
+        position: index.toRangePosition(related.sourceRange),
+        message: related.message,
+    };
+}
+const SEVERITY_ORDER = {
+    error: 0,
+    warning: 1,
+    info: 2,
+    hint: 3,
+};
+/** cli.md §7: "Diagnostic ordering within a file is deterministic: range, severity, origin, adapterId, code, message." */
+export function sortCliDiagnostics(diagnostics) {
+    return [...diagnostics].sort((a, b) => a.range.start - b.range.start ||
+        a.range.end - b.range.end ||
+        SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity] ||
+        a.origin.localeCompare(b.origin) ||
+        (a.adapterId ?? "").localeCompare(b.adapterId ?? "") ||
+        a.code.localeCompare(b.code) ||
+        a.message.localeCompare(b.message));
+}
+/**
+ * language-server.md §7.3's session-failure detection (server.ts's
+ * `SESSION_FAILURE_CODE`), reused verbatim (cli.md §8): a `SourceDiagnostic`
+ * with `origin: "adapter"` whose code matches this shape is a session-level
+ * adapter failure that the analyzer places on *every* analyzed file. The CLI
+ * reports it once at run level instead of repeating it per file.
+ */
+export const SESSION_FAILURE_CODE = /^adapter\/[^/]+\/(configuration-error|validator-unavailable)$/;
+export function isSessionFailureDiagnostic(diagnostic) {
+    return (diagnostic.origin === "adapter" &&
+        SESSION_FAILURE_CODE.test(diagnostic.code));
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/enumerate.d.ts

@@ -0,0 +1,18 @@
+import type { RunLevelError } from "./types.js";
+export interface EnumerateFilesOptions {
+    /** Absolute. */
+    workspaceRoot: string;
+    /** Absolute; positional arguments are resolved relative to this (cli.md §2). */
+    cwd: string;
+    positionalArgs: readonly string[];
+    include: readonly string[];
+    exclude: readonly string[];
+}
+export interface EnumerateFilesResult {
+    /** Absolute real paths, sorted by workspace-relative "/"-separated path. */
+    files: readonly string[];
+    /** Boundary violations (cli.md §6): one per out-of-root positional argument. */
+    errors: readonly RunLevelError[];
+}
+export declare function enumerateFiles(options: EnumerateFilesOptions): Promise<EnumerateFilesResult>;
+//# sourceMappingURL=enumerate.d.ts.map

package/dist/enumerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumerate.d.ts","sourceRoot":"","sources":["../src/enumerate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,gFAAgF;IAChF,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAClC;AAwHD,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoE/B"}