@vutex/vutex 0.0.0 → 0.0.1

package/bin/vutex.mjs

@@ -1,11 +1,11 @@
-#!/usr/bin/env node
-
-import { createJiti } from "jiti";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const jiti = createJiti(import.meta.url, { interopDefault: true });
-const { runCli } = await jiti.import(join(here, "../src/cli/main.ts"));
-
-process.exit(await runCli(process.argv.slice(2)));
+#!/usr/bin/env node
+
+import { createJiti } from "jiti";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const jiti = createJiti(import.meta.url, { interopDefault: true });
+const { runCli } = await jiti.import(join(here, "../src/cli/main.ts"));
+
+process.exit(await runCli(process.argv.slice(2)));

package/locales/en-US/cli.json

@@ -1,18 +1,18 @@
-{
-  "cli.intro": "vutex — language-neutral document typesetting and rendering",
-  "cli.cmd.render": "Render a document to the configured output format",
-  "cli.cmd.inspect": "Inspect input format and document metadata",
-  "cli.cmd.package": "Manage VuTeX resource packages (fonts, templates, profiles)",
-  "cli.cmd.package.list": "List resource packages from manifest and lockfile",
-  "cli.cmd.package.add": "Add a resource package alias to vutex.toml",
-  "cli.cmd.package.remove": "Remove a resource package alias from vutex.toml",
-  "cli.cmd.package.install": "Resolve and install resource packages into the project cache",
-  "cli.cmd.package.update": "Refresh the resource package lockfile",
-  "cli.cmd.package.doctor": "Check manifest, lockfile, and package cache health",
-  "cli.opt.output": "Output file path, or format id when writing to stdout",
-  "cli.opt.profile": "Named language profile from vutex.toml",
-  "cli.opt.input-format": "Override input format id",
-  "cli.opt.json": "Emit machine-readable JSON on stdout",
-  "cli.opt.package-name": "Resource package name to install",
-  "cli.opt.package-version": "Requested package version range"
-}
+{
+  "cli.intro": "vutex — language-neutral document typesetting and rendering",
+  "cli.cmd.render": "Render a document to the configured output format",
+  "cli.cmd.inspect": "Inspect input format and document metadata",
+  "cli.cmd.package": "Manage VuTeX resource packages (fonts, templates, profiles)",
+  "cli.cmd.package.list": "List resource packages from manifest and lockfile",
+  "cli.cmd.package.add": "Add a resource package alias to vutex.toml",
+  "cli.cmd.package.remove": "Remove a resource package alias from vutex.toml",
+  "cli.cmd.package.install": "Resolve and install resource packages into the project cache",
+  "cli.cmd.package.update": "Refresh the resource package lockfile",
+  "cli.cmd.package.doctor": "Check manifest, lockfile, and package cache health",
+  "cli.opt.output": "Output file path, or format id when writing to stdout",
+  "cli.opt.profile": "Named language profile from vutex.toml",
+  "cli.opt.input-format": "Override input format id",
+  "cli.opt.json": "Emit machine-readable JSON on stdout",
+  "cli.opt.package-name": "Resource package name to install",
+  "cli.opt.package-version": "Requested package version range"
+}

package/locales/locales.json

@@ -1 +1 @@
-["en-US"]
+["en-US"]

package/package.json

@@ -30,19 +30,24 @@
   "license": "MPL-2.0",
   "name": "@vutex/vutex",
   "optionalDependencies": {
-    "@vutex/vutex-darwin-arm64": "0.0.0",
-    "@vutex/vutex-darwin-x64": "0.0.0",
-    "@vutex/vutex-linux-arm64": "0.0.0",
-    "@vutex/vutex-linux-x64": "0.0.0",
-    "@vutex/vutex-win32-x64": "0.0.0"
+    "@vutex/vutex-darwin-arm64": "0.0.1",
+    "@vutex/vutex-darwin-x64": "0.0.1",
+    "@vutex/vutex-linux-arm64": "0.0.1",
+    "@vutex/vutex-linux-x64": "0.0.1",
+    "@vutex/vutex-win32-x64": "0.0.1"
   },
   "publishConfig": {
     "access": "public"
   },
+  "repository": {
+    "directory": "projects/packages/vutex",
+    "type": "git",
+    "url": "git+https://github.com/notedge/VuTeX.git"
+  },
   "scripts": {
     "test": "tsx --test tests/package-manager.test.ts",
     "typecheck": "tsc --noEmit"
   },
   "type": "module",
-  "version": "0.0.0"
+  "version": "0.0.1"
 }

package/readme.md

@@ -1,18 +1,18 @@
-# @vutex/vutex
-
-VuTeX TypeScript runtime facade and official CLI.
-
-```bash
-vutex render sample.nd --output out.svg
-vutex inspect sample.nd
-vutex package doctor
-```
-
-```ts
-import { createVuTeX } from "@vutex/vutex";
-
-const vutex = await createVuTeX({ projectRoot: process.cwd() });
-const result = await vutex.render("sample.nd", { output: "svg" });
-```
-
-Resource packages (fonts, templates, profiles) are managed by the VuTeX package manager via `vutex.toml`, not npm.
+# @vutex/vutex
+
+VuTeX TypeScript runtime facade and official CLI.
+
+```bash
+vutex render sample.nd --output out.svg
+vutex inspect sample.nd
+vutex package doctor
+```
+
+```ts
+import { createVuTeX } from "@vutex/vutex";
+
+const vutex = await createVuTeX({ projectRoot: process.cwd() });
+const result = await vutex.render("sample.nd", { output: "svg" });
+```
+
+Resource packages (fonts, templates, profiles) are managed by the VuTeX package manager via `vutex.toml`, not npm.

package/src/cli/cli.ts

@@ -1,21 +1,21 @@
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { createCli } from "@vmz/commander";
-
-import { registerInspectCommand } from "./commands/inspect.js";
-import { registerPackageCommands } from "./commands/package.js";
-import { registerRenderCommand } from "./commands/render.js";
-
-export function buildVuTeXCli() {
-    const localesRoot = join(dirname(fileURLToPath(import.meta.url)), "../../locales");
-    const cli = createCli("vutex")
-        .locales(localesRoot, { envKeys: ["VUTEX_LOCALE", "LOCALE", "LANG", "LC_ALL"] })
-        .intro("cli.intro");
-
-    registerRenderCommand(cli);
-    registerInspectCommand(cli);
-    registerPackageCommands(cli);
-
-    return cli;
-}
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createCli } from "@vmz/commander";
+
+import { registerInspectCommand } from "./commands/inspect.js";
+import { registerPackageCommands } from "./commands/package.js";
+import { registerRenderCommand } from "./commands/render.js";
+
+export function buildVuTeXCli() {
+    const localesRoot = join(dirname(fileURLToPath(import.meta.url)), "../../locales");
+    const cli = createCli("vutex")
+        .locales(localesRoot, { envKeys: ["VUTEX_LOCALE", "LOCALE", "LANG", "LC_ALL"] })
+        .intro("cli.intro");
+
+    registerRenderCommand(cli);
+    registerInspectCommand(cli);
+    registerPackageCommands(cli);
+
+    return cli;
+}

package/src/cli/commands/inspect.ts

@@ -1,33 +1,33 @@
-import type { Cli, ParsedOptions } from "@vmz/commander";
-
-import { createVuTeXRuntime } from "../context.js";
-import { emitJson, presentDiagnostics } from "../diagnostics.js";
-import { ExitCode } from "../exit-codes.js";
-
-export function registerInspectCommand(cli: Cli): void {
-    cli.command("inspect", "cli.cmd.inspect")
-        .option("--json", "cli.opt.json")
-        .action(async (options: ParsedOptions) => {
-            const inputPath = options._[0];
-            if (!inputPath || typeof inputPath !== "string") {
-                return ExitCode.InvalidArgs;
-            }
-
-            const runtime = await createVuTeXRuntime();
-            const result = await runtime.inspect(inputPath);
-
-            if (options.json === true) {
-                emitJson(result);
-            } else {
-                console.log(`${result.inputFormat}\t${result.path}`);
-            }
-
-            if (result.diagnostics.length > 0) {
-                presentDiagnostics(result.diagnostics, options.json === true);
-            }
-
-            return result.diagnostics.some((item) => item.severity === "error")
-                ? ExitCode.ActionFailed
-                : ExitCode.Ok;
-        });
-}
+import type { Cli, ParsedOptions } from "@vmz/commander";
+
+import { createVuTeXRuntime } from "../context.js";
+import { emitJson, presentDiagnostics } from "../diagnostics.js";
+import { ExitCode } from "../exit-codes.js";
+
+export function registerInspectCommand(cli: Cli): void {
+    cli.command("inspect", "cli.cmd.inspect")
+        .option("--json", "cli.opt.json")
+        .action(async (options: ParsedOptions) => {
+            const inputPath = options._[0];
+            if (!inputPath || typeof inputPath !== "string") {
+                return ExitCode.InvalidArgs;
+            }
+
+            const runtime = await createVuTeXRuntime();
+            const result = await runtime.inspect(inputPath);
+
+            if (options.json === true) {
+                emitJson(result);
+            } else {
+                console.log(`${result.inputFormat}\t${result.path}`);
+            }
+
+            if (result.diagnostics.length > 0) {
+                presentDiagnostics(result.diagnostics, options.json === true);
+            }
+
+            return result.diagnostics.some((item) => item.severity === "error")
+                ? ExitCode.ActionFailed
+                : ExitCode.Ok;
+        });
+}

package/src/cli/commands/package.ts

@@ -1,99 +1,99 @@
-import type { Cli, ParsedOptions } from "@vmz/commander";
-
-import { createVuTeXRuntime } from "../context.js";
-import { emitHuman, emitJson } from "../diagnostics.js";
-import { ExitCode } from "../exit-codes.js";
-
-function readName(options: ParsedOptions): string | undefined {
-    const value = options._[0] ?? options.name;
-    return typeof value === "string" ? value : undefined;
-}
-
-export function registerPackageCommands(cli: Cli): void {
-    const group = cli.command("package", "cli.cmd.package");
-
-    group
-        .command("list", "cli.cmd.package.list")
-        .option("--json", "cli.opt.json")
-        .action(async (options: ParsedOptions) => {
-            const runtime = await createVuTeXRuntime();
-            const items = await runtime.packages.list();
-            if (options.json === true) {
-                emitJson({ packages: items });
-            } else {
-                for (const item of items) {
-                    emitHuman(`${item.name}\t${item.version}\t${item.source}`);
-                }
-            }
-            return ExitCode.Ok;
-        });
-
-    group
-        .command("add", "cli.cmd.package.add")
-        .action(async (options: ParsedOptions) => {
-            const name = readName(options);
-            if (!name) {
-                return ExitCode.InvalidArgs;
-            }
-            const runtime = await createVuTeXRuntime();
-            await runtime.packages.add(name, {
-                version: typeof options.version === "string" ? options.version : undefined,
-            });
-            return ExitCode.Ok;
-        });
-
-    group
-        .command("remove", "cli.cmd.package.remove")
-        .action(async (options: ParsedOptions) => {
-            const name = readName(options);
-            if (!name) {
-                return ExitCode.InvalidArgs;
-            }
-            const runtime = await createVuTeXRuntime();
-            await runtime.packages.remove(name);
-            return ExitCode.Ok;
-        });
-
-    group
-        .command("install", "cli.cmd.package.install")
-        .option("--name <name>", "cli.opt.package-name")
-        .option("--version <version>", "cli.opt.package-version")
-        .action(async (options: ParsedOptions) => {
-            const runtime = await createVuTeXRuntime();
-            await runtime.packages.install({
-                name: typeof options.name === "string" ? options.name : undefined,
-                version: typeof options.version === "string" ? options.version : undefined,
-            });
-            return ExitCode.Ok;
-        });
-
-    group
-        .command("update", "cli.cmd.package.update")
-        .action(async () => {
-            const runtime = await createVuTeXRuntime();
-            await runtime.packages.update();
-            return ExitCode.Ok;
-        });
-
-    group
-        .command("doctor", "cli.cmd.package.doctor")
-        .option("--json", "cli.opt.json")
-        .action(async (options: ParsedOptions) => {
-            const runtime = await createVuTeXRuntime();
-            const report = await runtime.packages.doctor();
-            if (options.json === true) {
-                emitJson(report);
-            } else if (report.ok) {
-                emitHuman("VuTeX resource packages look healthy");
-                for (const check of report.checks) {
-                    emitHuman(`  ok  ${check.id}: ${check.message}`);
-                }
-            } else {
-                emitHuman("VuTeX resource packages have issues");
-                for (const check of report.checks) {
-                    emitHuman(`  ${check.ok ? "ok" : "fail"}  ${check.id}: ${check.message}`);
-                }
-            }
-            return report.ok ? ExitCode.Ok : ExitCode.ActionFailed;
-        });
-}
+import type { Cli, ParsedOptions } from "@vmz/commander";
+
+import { createVuTeXRuntime } from "../context.js";
+import { emitHuman, emitJson } from "../diagnostics.js";
+import { ExitCode } from "../exit-codes.js";
+
+function readName(options: ParsedOptions): string | undefined {
+    const value = options._[0] ?? options.name;
+    return typeof value === "string" ? value : undefined;
+}
+
+export function registerPackageCommands(cli: Cli): void {
+    const group = cli.command("package", "cli.cmd.package");
+
+    group
+        .command("list", "cli.cmd.package.list")
+        .option("--json", "cli.opt.json")
+        .action(async (options: ParsedOptions) => {
+            const runtime = await createVuTeXRuntime();
+            const items = await runtime.packages.list();
+            if (options.json === true) {
+                emitJson({ packages: items });
+            } else {
+                for (const item of items) {
+                    emitHuman(`${item.name}\t${item.version}\t${item.source}`);
+                }
+            }
+            return ExitCode.Ok;
+        });
+
+    group
+        .command("add", "cli.cmd.package.add")
+        .action(async (options: ParsedOptions) => {
+            const name = readName(options);
+            if (!name) {
+                return ExitCode.InvalidArgs;
+            }
+            const runtime = await createVuTeXRuntime();
+            await runtime.packages.add(name, {
+                version: typeof options.version === "string" ? options.version : undefined,
+            });
+            return ExitCode.Ok;
+        });
+
+    group
+        .command("remove", "cli.cmd.package.remove")
+        .action(async (options: ParsedOptions) => {
+            const name = readName(options);
+            if (!name) {
+                return ExitCode.InvalidArgs;
+            }
+            const runtime = await createVuTeXRuntime();
+            await runtime.packages.remove(name);
+            return ExitCode.Ok;
+        });
+
+    group
+        .command("install", "cli.cmd.package.install")
+        .option("--name <name>", "cli.opt.package-name")
+        .option("--version <version>", "cli.opt.package-version")
+        .action(async (options: ParsedOptions) => {
+            const runtime = await createVuTeXRuntime();
+            await runtime.packages.install({
+                name: typeof options.name === "string" ? options.name : undefined,
+                version: typeof options.version === "string" ? options.version : undefined,
+            });
+            return ExitCode.Ok;
+        });
+
+    group
+        .command("update", "cli.cmd.package.update")
+        .action(async () => {
+            const runtime = await createVuTeXRuntime();
+            await runtime.packages.update();
+            return ExitCode.Ok;
+        });
+
+    group
+        .command("doctor", "cli.cmd.package.doctor")
+        .option("--json", "cli.opt.json")
+        .action(async (options: ParsedOptions) => {
+            const runtime = await createVuTeXRuntime();
+            const report = await runtime.packages.doctor();
+            if (options.json === true) {
+                emitJson(report);
+            } else if (report.ok) {
+                emitHuman("VuTeX resource packages look healthy");
+                for (const check of report.checks) {
+                    emitHuman(`  ok  ${check.id}: ${check.message}`);
+                }
+            } else {
+                emitHuman("VuTeX resource packages have issues");
+                for (const check of report.checks) {
+                    emitHuman(`  ${check.ok ? "ok" : "fail"}  ${check.id}: ${check.message}`);
+                }
+            }
+            return report.ok ? ExitCode.Ok : ExitCode.ActionFailed;
+        });
+}

package/src/cli/commands/render.ts

@@ -1,38 +1,38 @@
-import type { Cli, ParsedOptions } from "@vmz/commander";
-
-import { createVuTeXRuntime } from "../context.js";
-import { emitJson, presentDiagnostics } from "../diagnostics.js";
-import { ExitCode } from "../exit-codes.js";
-
-export function registerRenderCommand(cli: Cli): void {
-    cli.command("render", "cli.cmd.render")
-        .option("-o, --output <file>", "cli.opt.output")
-        .option("--profile <name>", "cli.opt.profile")
-        .option("--input <format>", "cli.opt.input-format")
-        .option("--json", "cli.opt.json")
-        .action(async (options: ParsedOptions) => {
-            const inputPath = options._[0];
-            if (!inputPath || typeof inputPath !== "string") {
-                return ExitCode.InvalidArgs;
-            }
-
-            const runtime = await createVuTeXRuntime();
-            const result = await runtime.render(inputPath, {
-                output: typeof options.output === "string" ? options.output : undefined,
-                profile: typeof options.profile === "string" ? options.profile : undefined,
-                input: typeof options.input === "string" ? options.input : undefined,
-            });
-
-            if (options.json === true) {
-                emitJson(result);
-            } else if (result.svg) {
-                console.log(result.svg);
-            }
-
-            if (result.diagnostics.length > 0) {
-                presentDiagnostics(result.diagnostics, options.json === true);
-            }
-
-            return result.exitCode === 0 ? ExitCode.Ok : ExitCode.ActionFailed;
-        });
-}
+import type { Cli, ParsedOptions } from "@vmz/commander";
+
+import { createVuTeXRuntime } from "../context.js";
+import { emitJson, presentDiagnostics } from "../diagnostics.js";
+import { ExitCode } from "../exit-codes.js";
+
+export function registerRenderCommand(cli: Cli): void {
+    cli.command("render", "cli.cmd.render")
+        .option("-o, --output <file>", "cli.opt.output")
+        .option("--profile <name>", "cli.opt.profile")
+        .option("--input <format>", "cli.opt.input-format")
+        .option("--json", "cli.opt.json")
+        .action(async (options: ParsedOptions) => {
+            const inputPath = options._[0];
+            if (!inputPath || typeof inputPath !== "string") {
+                return ExitCode.InvalidArgs;
+            }
+
+            const runtime = await createVuTeXRuntime();
+            const result = await runtime.render(inputPath, {
+                output: typeof options.output === "string" ? options.output : undefined,
+                profile: typeof options.profile === "string" ? options.profile : undefined,
+                input: typeof options.input === "string" ? options.input : undefined,
+            });
+
+            if (options.json === true) {
+                emitJson(result);
+            } else if (result.svg) {
+                console.log(result.svg);
+            }
+
+            if (result.diagnostics.length > 0) {
+                presentDiagnostics(result.diagnostics, options.json === true);
+            }
+
+            return result.exitCode === 0 ? ExitCode.Ok : ExitCode.ActionFailed;
+        });
+}

package/src/cli/context.ts

@@ -1,27 +1,27 @@
-import { createVuTeX, type VuTeXRuntime } from "../index.js";
-import { loadVuTeXNode } from "../node/load.js";
-
-export type CliContext = {
-    runtime: VuTeXRuntime | null;
-    toolVersion: string;
-};
-
-export async function createVuTeXRuntime(projectRoot?: string): Promise<VuTeXRuntime> {
-    return createVuTeX({ projectRoot: projectRoot ?? process.cwd(), host: "node", backend: "native" });
-}
-
-export function loadBindings(): ReturnType<typeof loadVuTeXNode> | null {
-    try {
-        return loadVuTeXNode();
-    } catch {
-        return null;
-    }
-}
-
-export async function createContext(projectRoot?: string): Promise<CliContext> {
-    const bindings = loadBindings();
-    return {
-        runtime: bindings ? await createVuTeX({ projectRoot: projectRoot ?? process.cwd() }) : null,
-        toolVersion: bindings?.vutexVersion() ?? "0.0.0",
-    };
-}
+import { createVuTeX, type VuTeXRuntime } from "../index.js";
+import { loadVuTeXNode } from "../node/load.js";
+
+export type CliContext = {
+    runtime: VuTeXRuntime | null;
+    toolVersion: string;
+};
+
+export async function createVuTeXRuntime(projectRoot?: string): Promise<VuTeXRuntime> {
+    return createVuTeX({ projectRoot: projectRoot ?? process.cwd(), host: "node", backend: "native" });
+}
+
+export function loadBindings(): ReturnType<typeof loadVuTeXNode> | null {
+    try {
+        return loadVuTeXNode();
+    } catch {
+        return null;
+    }
+}
+
+export async function createContext(projectRoot?: string): Promise<CliContext> {
+    const bindings = loadBindings();
+    return {
+        runtime: bindings ? await createVuTeX({ projectRoot: projectRoot ?? process.cwd() }) : null,
+        toolVersion: bindings?.vutexVersion() ?? "0.0.0",
+    };
+}

package/src/cli/diagnostics.ts

@@ -1,23 +1,23 @@
-import type { VuTeXDiagnostic } from "../types.js";
-
-export function emitHuman(message: string): void {
-    console.error(message);
-}
-
-export function emitJson(value: unknown): void {
-    console.log(JSON.stringify(value, null, 2));
-}
-
-export function presentDiagnostics(
-    diagnostics: VuTeXDiagnostic[],
-    json: boolean,
-): void {
-    if (json) {
-        emitJson({ diagnostics });
-        return;
-    }
-    for (const item of diagnostics) {
-        const stage = item.stage ? `[${item.stage}] ` : "";
-        emitHuman(`${stage}${item.severity}: ${item.code} — ${item.message}`);
-    }
-}
+import type { VuTeXDiagnostic } from "../types.js";
+
+export function emitHuman(message: string): void {
+    console.error(message);
+}
+
+export function emitJson(value: unknown): void {
+    console.log(JSON.stringify(value, null, 2));
+}
+
+export function presentDiagnostics(
+    diagnostics: VuTeXDiagnostic[],
+    json: boolean,
+): void {
+    if (json) {
+        emitJson({ diagnostics });
+        return;
+    }
+    for (const item of diagnostics) {
+        const stage = item.stage ? `[${item.stage}] ` : "";
+        emitHuman(`${stage}${item.severity}: ${item.code} — ${item.message}`);
+    }
+}

package/src/cli/exit-codes.ts

@@ -1,5 +1,5 @@
-export const ExitCode = {
-    Ok: 0,
-    ActionFailed: 1,
-    InvalidArgs: 2,
-} as const;
+export const ExitCode = {
+    Ok: 0,
+    ActionFailed: 1,
+    InvalidArgs: 2,
+} as const;

package/src/cli/main.ts

@@ -1,5 +1,5 @@
-import { buildVuTeXCli } from "./cli.js";
-
-export async function runCli(argv: string[]): Promise<number> {
-    return await buildVuTeXCli().parse(argv);
-}
+import { buildVuTeXCli } from "./cli.js";
+
+export async function runCli(argv: string[]): Promise<number> {
+    return await buildVuTeXCli().parse(argv);
+}