@json-to-office/jto 0.3.6 → 0.4.1

package/README.md

@@ -1,38 +1,64 @@
 # @json-to-office/jto
 
-CLI and visual playground for [json-to-office](https://github.com/Wiseair-srl/json-to-office). Edit document definitions in a Monaco editor with autocomplete and validation, preview rendered output live, and generate `.docx` / `.pptx` files from the command line.
+CLI and visual playground for [json-to-office](https://github.com/Wiseair-srl/json-to-office). Describe `.docx` and `.pptx` files as JSON, preview them live, generate them from the command line.
 
 [![npm](https://img.shields.io/npm/v/@json-to-office/jto.svg)](https://www.npmjs.com/package/@json-to-office/jto)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/Wiseair-srl/json-to-office/blob/main/LICENSE)
 
-## Install
+## Quick start
 
 ```bash
 npm install -g @json-to-office/jto
+
+# Open the visual playground with live preview
+jto docx dev
+jto pptx dev
 ```
 
-## Usage
+![Visual Playground](https://raw.githubusercontent.com/Wiseair-srl/json-to-office/main/docs/playground-screenshot.png)
+
+## CLI commands
+
+### `dev`: visual playground
 
 ```bash
-# Start the dev server with visual playground
 jto docx dev --input ./template.json
 jto pptx dev --input ./template.json
+```
+
+Opens a browser-based IDE at `localhost:3000` with:
 
-# Generate files directly
+| Feature             | Description                                                                                                                                          |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Monaco editor       | JSON editing with autocomplete, inline validation, syntax highlighting                                                                               |
+| Live preview        | Rendered document updates as you type                                                                                                                |
+| Built-in templates  | Start from example documents (dashboards, sales decks, reports)                                                                                      |
+| Theme switching     | Toggle between built-in themes or load your own                                                                                                      |
+| Schema validation   | Real-time error reporting against TypeBox schemas                                                                                                    |
+| AI assistant        | Describe a document in plain English, get schema-validated JSON back (requires Claude API key)                                                       |
+| LibreOffice preview | **Optional.** If LibreOffice (headless) is installed, enables high-fidelity PDF rendering for pixel-accurate output. Not required for live previews. |
+
+### `generate`: render files
+
+```bash
 jto docx generate --input ./template.json --output ./report.docx
 jto pptx generate --input ./template.json --output ./deck.pptx
 ```
 
-## Visual playground
+Reads a JSON document definition and writes a `.docx` or `.pptx` file. Works in CI/CD pipelines, cron jobs, and scripts.
+
+## Part of json-to-office
+
+`jto` is the CLI companion to the programmatic libraries:
 
-The dev server opens a browser-based IDE with:
+| Package                                                                                      | Use case                   |
+| -------------------------------------------------------------------------------------------- | -------------------------- |
+| [`@json-to-office/json-to-docx`](https://www.npmjs.com/package/@json-to-office/json-to-docx) | Generate `.docx` from code |
+| [`@json-to-office/json-to-pptx`](https://www.npmjs.com/package/@json-to-office/json-to-pptx) | Generate `.pptx` from code |
+| **`@json-to-office/jto`**                                                                    | CLI + visual playground    |
 
-- **Monaco editor** — Full JSON editing with autocomplete, inline validation, and syntax highlighting
-- **Live preview** — See rendered document output update as you type
-- **Built-in templates** — Start from example documents (dashboards, sales decks, reports)
-- **Theme switching** — Toggle between built-in themes or load your own
-- **Schema validation** — Real-time error reporting against TypeBox schemas
+See the [monorepo](https://github.com/Wiseair-srl/json-to-office) for full docs, examples, and the schema reference.
 
 ## License
 
-[MIT](https://github.com/Wiseair-srl/json-to-office/blob/main/LICENSE) — Wiseair srl
+[MIT](https://github.com/Wiseair-srl/json-to-office/blob/main/LICENSE), Wiseair srl

package/dist/cli.js

@@ -1375,16 +1375,25 @@ import os from "os";
 import path13 from "path";
 function executeFile(binary, args, timeoutMs) {
   return new Promise((resolve16, reject) => {
-    execFile(binary, args, { timeout: timeoutMs, maxBuffer: MAX_EXEC_BUFFER_BYTES, windowsHide: true }, (error, stdout, stderr) => {
-      if (error) {
-        const execError = error;
-        execError.stdout = stdout;
-        execError.stderr = stderr;
-        reject(execError);
-        return;
+    execFile(
+      binary,
+      args,
+      {
+        timeout: timeoutMs,
+        maxBuffer: MAX_EXEC_BUFFER_BYTES,
+        windowsHide: true
+      },
+      (error, stdout, stderr) => {
+        if (error) {
+          const execError = error;
+          execError.stdout = stdout;
+          execError.stderr = stderr;
+          reject(execError);
+          return;
+        }
+        resolve16({ stdout: stdout ?? "", stderr: stderr ?? "" });
       }
-      resolve16({ stdout: stdout ?? "", stderr: stderr ?? "" });
-    });
+    );
   });
 }
 function toErrorText(value) {
@@ -1417,7 +1426,10 @@ var init_libreoffice_converter = __esm({
     LibreOfficeBinaryNotFoundError = class extends LibreOfficeError {
       candidates;
       constructor(candidates) {
-        super("BINARY_NOT_FOUND", "LibreOffice binary not found. Install LibreOffice locally or set LIBREOFFICE_PATH.");
+        super(
+          "BINARY_NOT_FOUND",
+          "LibreOffice binary not found. Install LibreOffice locally or set LIBREOFFICE_PATH."
+        );
         this.name = "LibreOfficeBinaryNotFoundError";
         this.candidates = candidates;
       }
@@ -1425,7 +1437,10 @@ var init_libreoffice_converter = __esm({
     LibreOfficeTimeoutError = class extends LibreOfficeError {
       timeoutMs;
       constructor(timeoutMs) {
-        super("CONVERSION_TIMEOUT", `LibreOffice conversion timed out after ${timeoutMs}ms`);
+        super(
+          "CONVERSION_TIMEOUT",
+          `LibreOffice conversion timed out after ${timeoutMs}ms`
+        );
         this.name = "LibreOfficeTimeoutError";
         this.timeoutMs = timeoutMs;
       }
@@ -1441,7 +1456,10 @@ var init_libreoffice_converter = __esm({
     LibreOfficeOutputNotFoundError = class extends LibreOfficeError {
       outputPath;
       constructor(outputPath) {
-        super("OUTPUT_NOT_FOUND", "LibreOffice conversion completed but PDF output was not produced");
+        super(
+          "OUTPUT_NOT_FOUND",
+          "LibreOffice conversion completed but PDF output was not produced"
+        );
         this.name = "LibreOfficeOutputNotFoundError";
         this.outputPath = outputPath;
       }
@@ -1458,7 +1476,9 @@ var init_libreoffice_converter = __esm({
           throw new LibreOfficeConversionError("Input file is empty");
         }
         const binaryPath = await this.resolveBinaryPath();
-        const tempDir = await fs10.mkdtemp(path13.join(os.tmpdir(), "jto-libreoffice-"));
+        const tempDir = await fs10.mkdtemp(
+          path13.join(os.tmpdir(), "jto-libreoffice-")
+        );
         const outputBaseName = sanitizeBaseName(originalName);
         const ext = this.format === "pptx" ? ".pptx" : ".docx";
         const inputPath = path13.join(tempDir, `${outputBaseName}${ext}`);
@@ -1486,6 +1506,11 @@ var init_libreoffice_converter = __esm({
         if (configured) candidates.push(configured);
         if (process.platform === "darwin") {
           candidates.push("/Applications/LibreOffice.app/Contents/MacOS/soffice");
+        } else if (process.platform === "win32") {
+          candidates.push("C:\\Program Files\\LibreOffice\\program\\soffice.exe");
+          candidates.push(
+            "C:\\Program Files (x86)\\LibreOffice\\program\\soffice.exe"
+          );
         }
         candidates.push("soffice", "libreoffice");
         return [...new Set(candidates)];
@@ -1532,10 +1557,18 @@ var init_libreoffice_converter = __esm({
           await executeFile(binaryPath, args, this.timeoutMs);
         } catch (error) {
           const execError = error;
-          if (execError.code === "ETIMEDOUT") throw new LibreOfficeTimeoutError(this.timeoutMs);
-          if (execError.code === "ENOENT") throw new LibreOfficeBinaryNotFoundError(this.getBinaryCandidates());
-          const details = [toErrorText(execError.stderr), toErrorText(execError.stdout)].filter(Boolean).join("\n").trim();
-          throw new LibreOfficeConversionError("LibreOffice failed to convert to PDF", details || execError.message);
+          if (execError.code === "ETIMEDOUT")
+            throw new LibreOfficeTimeoutError(this.timeoutMs);
+          if (execError.code === "ENOENT")
+            throw new LibreOfficeBinaryNotFoundError(this.getBinaryCandidates());
+          const details = [
+            toErrorText(execError.stderr),
+            toErrorText(execError.stdout)
+          ].filter(Boolean).join("\n").trim();
+          throw new LibreOfficeConversionError(
+            "LibreOffice failed to convert to PDF",
+            details || execError.message
+          );
         }
       }
     };
@@ -5826,7 +5859,7 @@ ${chalk8.cyan("Health:")}  ${url}/health
 }
 
 // src/cli.ts
-var PACKAGE_VERSION = true ? "0.3.6" : "dev-mode";
+var PACKAGE_VERSION = true ? "0.4.1" : "dev-mode";
 function registerFormatCommands(parent, adapter) {
   parent.addCommand(createGenerateCommand(adapter));
   parent.addCommand(createValidateCommand(adapter));