@vutex/vutex 0.0.2 → 0.0.4

package/locales/en-US/cli.json

@@ -9,7 +9,7 @@
   "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.output": "Output format id: svg, html, snapshot, or pdf",
   "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",

package/locales/locales.json

@@ -1 +1,4 @@
-["en-US"]
+{
+  "defaultLocale": "en-US",
+  "locales": [{ "id": "en-US", "label": "English", "direction": "ltr" }]
+}

package/package.json

@@ -30,11 +30,11 @@
   "license": "MPL-2.0",
   "name": "@vutex/vutex",
   "optionalDependencies": {
-    "@vutex/vutex-darwin-arm64": "0.0.2",
-    "@vutex/vutex-darwin-x64": "0.0.2",
-    "@vutex/vutex-linux-arm64": "0.0.2",
-    "@vutex/vutex-linux-x64": "0.0.2",
-    "@vutex/vutex-win32-x64": "0.0.2"
+    "@vutex/vutex-darwin-arm64": "0.0.4",
+    "@vutex/vutex-darwin-x64": "0.0.4",
+    "@vutex/vutex-linux-arm64": "0.0.4",
+    "@vutex/vutex-linux-x64": "0.0.4",
+    "@vutex/vutex-win32-x64": "0.0.4"
   },
   "publishConfig": {
     "access": "public"
@@ -45,9 +45,9 @@
     "url": "git+https://github.com/notedge/VuTeX.git"
   },
   "scripts": {
-    "test": "tsx --test tests/package-manager.test.ts",
+    "test": "tsx --test tests/package-manager.test.ts tests/render-runtime.test.ts",
     "typecheck": "tsc --noEmit"
   },
   "type": "module",
-  "version": "0.0.2"
+  "version": "0.0.4"
 }

package/src/cli/commands/render.ts

@@ -1,12 +1,34 @@
+import { writeFile } from "node:fs/promises";
+import { basename, dirname, extname, join, resolve } from "node:path";
+
 import type { Cli, ParsedOptions } from "@vmz/commander";
 
+import type { RenderDocumentResult } from "../../types.js";
 import { createVuTeXRuntime } from "../context.js";
 import { emitJson, presentDiagnostics } from "../diagnostics.js";
 import { ExitCode } from "../exit-codes.js";
 
+/**
+ * Write PDF bytes beside the input file and build the CLI payload.
+ *
+ * The text mode prints `outputPath`; the JSON payload carries the render
+ * result without the binary body plus the absolute `outputPath`.
+ */
+export async function writePdfOutput(
+    inputPath: string,
+    bytes: Uint8Array,
+    result: RenderDocumentResult,
+): Promise<{ outputPath: string; payload: Record<string, unknown> }> {
+    const source = resolve(inputPath);
+    const outputPath = join(dirname(source), `${basename(source, extname(source))}.pdf`);
+    await writeFile(outputPath, bytes);
+    const { pdf: _bytes, ...rest } = result;
+    return { outputPath, payload: { ...rest, outputPath } };
+}
+
 export function registerRenderCommand(cli: Cli): void {
     cli.command("render", "cli.cmd.render")
-        .option("-o, --output <file>", "cli.opt.output")
+        .option("-o, --output <format>", "cli.opt.output")
         .option("--profile <name>", "cli.opt.profile")
         .option("--input <format>", "cli.opt.input-format")
         .option("--json", "cli.opt.json")
@@ -23,10 +45,18 @@ export function registerRenderCommand(cli: Cli): void {
                 input: typeof options.input === "string" ? options.input : undefined,
             });
 
+            const pdf = result.outputFormat === "pdf" ? result.pdf : undefined;
+            const written = pdf ? await writePdfOutput(inputPath, pdf, result) : null;
+
             if (options.json === true) {
-                emitJson(result);
-            } else if (result.svg) {
-                console.log(result.svg);
+                emitJson(written ? written.payload : result);
+            } else if (written) {
+                console.log(written.outputPath);
+            } else {
+                const body = result.outputFormat === "svg"
+                    ? result.svg ?? result.html
+                    : result.html ?? result.svg;
+                console.log(body ?? result.reportJson);
             }
 
             if (result.diagnostics.length > 0) {

package/src/index.ts

@@ -4,6 +4,7 @@ import type { CreateVuTeXOptions, VuTeXRuntime } from "./types.js";
 
 export type {
     CreateVuTeXOptions,
+    DocumentOutputFormat,
     FormulaDiagnostic,
     FormulaMetrics,
     FormulaRender,

package/src/node/load.ts

@@ -17,6 +17,8 @@ type NativeBinding = {
         exitCode: number;
         outputFormat: string;
         svg?: string;
+        html?: string;
+        pdf?: Uint8Array;
         reportJson: string;
     };
 };

package/src/runtime.ts

@@ -24,6 +24,14 @@ function decodeFormulaRender(raw: string): FormulaRender {
     return JSON.parse(raw) as FormulaRender;
 }
 
+/**
+ * Keep unknown format ids intact so the native side can report them.
+ * Only a missing value falls back to the default `svg`.
+ */
+function normalizeOutputFormat(value: string | undefined): string {
+    return typeof value === "string" && value.length > 0 ? value : "svg";
+}
+
 function diagnosticsFromReport(reportJson: string): VuTeXDiagnostic[] {
     try {
         const report = JSON.parse(reportJson) as {
@@ -47,7 +55,7 @@ export function createVuTeXRuntime(
         async render(inputPath, renderOptions = {}): Promise<RenderDocumentResult> {
             const manifest = await readManifest(projectRoot);
             const payload = JSON.stringify({
-                output: renderOptions.output ?? manifest?.document?.output ?? "svg",
+                output: normalizeOutputFormat(renderOptions.output ?? manifest?.document?.output),
                 profile: renderOptions.profile ?? manifest?.profile?.name,
                 input: renderOptions.input ?? manifest?.document?.input,
             });
@@ -56,6 +64,8 @@ export function createVuTeXRuntime(
                 exitCode: response.exitCode,
                 outputFormat: response.outputFormat,
                 svg: response.svg,
+                html: response.html,
+                pdf: response.pdf,
                 reportJson: response.reportJson,
                 diagnostics: diagnosticsFromReport(response.reportJson),
             };

package/src/types.ts

@@ -8,8 +8,10 @@ export type CreateVuTeXOptions = {
     backend?: VuTeXBackend;
 };
 
+export type DocumentOutputFormat = "svg" | "html" | "snapshot" | "pdf";
+
 export type RenderDocumentOptions = {
-    output?: string;
+    output?: DocumentOutputFormat | string;
     profile?: string;
     input?: string;
 };
@@ -58,6 +60,8 @@ export type RenderDocumentResult = {
     exitCode: number;
     outputFormat: string;
     svg?: string;
+    html?: string;
+    pdf?: Uint8Array;
     reportJson: string;
     diagnostics: VuTeXDiagnostic[];
 };
@@ -100,6 +104,8 @@ export type VuTeXBindings = {
         exitCode: number;
         outputFormat: string;
         svg?: string;
+        html?: string;
+        pdf?: Uint8Array;
         reportJson: string;
     };
 };