@json-to-office/jto 0.3.6 → 0.5.0

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
+          );
         }
       }
     };
@@ -3063,7 +3096,9 @@ function createAPIApp(adapter) {
   const legacyPath = adapter.name === "docx" ? "/api/documents" : "/api/presentations";
   honoApp.route(legacyPath, formatRouter);
   honoApp.route("/api/discovery", discoveryRouter);
-  honoApp.route("/api/ai", createAiRouter());
+  if (process.env.AI_ENABLED !== "false") {
+    honoApp.route("/api/ai", createAiRouter());
+  }
   honoApp.get("/", async (c) => {
     const apiInfo = await getApiInfo();
     return c.json(apiInfo);
@@ -3199,13 +3234,17 @@ var init_unified_server = __esm({
           const envClientPath = process.env.JTO_CLIENT_PATH;
           if (existsSync7(envClientPath) && existsSync7(resolve15(envClientPath, "index.html"))) {
             clientPath = envClientPath;
-            logger.debug("[Dev Server] Using client from JTO_CLIENT_PATH", { path: clientPath });
+            logger.debug("[Dev Server] Using client from JTO_CLIENT_PATH", {
+              path: clientPath
+            });
           }
         } else if (isBundled) {
           const bundledClientPath = resolve15(__dirname3, "client");
           if (existsSync7(bundledClientPath) && existsSync7(resolve15(bundledClientPath, "index.html"))) {
             clientPath = bundledClientPath;
-            logger.debug("[Dev Server] Using bundled client at", { path: clientPath });
+            logger.debug("[Dev Server] Using bundled client at", {
+              path: clientPath
+            });
           }
         } else {
           const possiblePaths = [
@@ -3215,7 +3254,9 @@ var init_unified_server = __esm({
           for (const p of possiblePaths) {
             if (existsSync7(p)) {
               if (p.replace(/\\/g, "/").includes("/src/client")) {
-                logger.debug("[Dev Server] Using Vite dev server for", { path: p });
+                logger.debug("[Dev Server] Using Vite dev server for", {
+                  path: p
+                });
                 try {
                   const { createServer: createViteServer } = await import("vite");
                   this.viteServer = await createViteServer({
@@ -3232,7 +3273,9 @@ var init_unified_server = __esm({
                 break;
               } else if (existsSync7(resolve15(p, "index.html"))) {
                 clientPath = p;
-                logger.debug("[Dev Server] Using pre-built client at", { path: clientPath });
+                logger.debug("[Dev Server] Using pre-built client at", {
+                  path: clientPath
+                });
                 break;
               }
             }
@@ -3283,10 +3326,13 @@ var init_unified_server = __esm({
         const { extname: extname2 } = await import("path");
         const mime = await import("mime-types");
         const format = this.adapter.name.replace(/[^a-zA-Z0-9]/g, "");
-        this.app.use("/assets/*", serveStatic({
-          root: clientPath,
-          rewriteRequestPath: (path14) => path14.replace(/^\/assets/, "/assets")
-        }));
+        this.app.use(
+          "/assets/*",
+          serveStatic({
+            root: clientPath,
+            rewriteRequestPath: (path14) => path14.replace(/^\/assets/, "/assets")
+          })
+        );
         this.app.use("/*", async (c, next) => {
           const reqPath = c.req.path;
           if (reqPath.startsWith("/api") || reqPath === "/health") return next();
@@ -3304,7 +3350,8 @@ var init_unified_server = __esm({
         });
         this.app.get("*", async (c) => {
           const reqPath = c.req.path;
-          if (reqPath.startsWith("/api") || reqPath === "/health") return c.notFound();
+          if (reqPath.startsWith("/api") || reqPath === "/health")
+            return c.notFound();
           const indexPath = resolve15(clientPath, "index.html");
           if (fs11.existsSync(indexPath)) {
             let html = fs11.readFileSync(indexPath, "utf-8");
@@ -3319,30 +3366,8 @@ var init_unified_server = __esm({
         });
       }
       async setupProdClient() {
-        const { serveStatic } = await import("@hono/node-server/serve-static");
-        const format = this.adapter.name.replace(/[^a-zA-Z0-9]/g, "");
-        this.app.use("/*", async (c, next) => {
-          const path14 = c.req.path;
-          if (path14.startsWith("/api") || path14 === "/health") return next();
-          return serveStatic({ root: "./dist/client" })(c, next);
-        });
-        this.app.get("*", (c) => {
-          const path14 = c.req.path;
-          if (path14.startsWith("/api") || path14 === "/health") return c.notFound();
-          return c.html(`<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>JSON to Office</title>
-  <script>window.__JTO_FORMAT__ = '${format}';</script>
-  <script>window.location.href = '/';</script>
-</head>
-<body>
-  <noscript>You need to enable JavaScript to run this app.</noscript>
-</body>
-</html>`);
-        });
+        const clientPath = resolve15(__dirname3, "client");
+        return this.setupBuiltClient(clientPath);
       }
       async start() {
         await this.initialize();
@@ -5715,6 +5740,9 @@ async function loadConfig(configPath) {
     }
   }
   const config2 = deepMerge(defaultConfig, userConfig);
+  if (process.env.NODE_ENV === "production") {
+    config2.mode = "production";
+  }
   if (!Value.Check(ConfigSchema, config2)) {
     const errors = [...Value.Errors(ConfigSchema, config2)];
     console.warn("Warning: Invalid configuration detected:", errors);
@@ -5826,7 +5854,7 @@ ${chalk8.cyan("Health:")}  ${url}/health
 }
 
 // src/cli.ts
-var PACKAGE_VERSION = true ? "0.3.6" : "dev-mode";
+var PACKAGE_VERSION = true ? "0.5.0" : "dev-mode";
 function registerFormatCommands(parent, adapter) {
   parent.addCommand(createGenerateCommand(adapter));
   parent.addCommand(createValidateCommand(adapter));