npm - @lotics/cli - Versions diffs - 0.88.0 → 0.88.1 - Mend

@lotics/cli 0.88.0 → 0.88.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (87) hide show

package/dist/render_page.js +100 -100
package/dist/src/cli.js +100 -100
package/dist/{client.d.ts → src/client.d.ts} +1 -1
package/dist/src/package_content_types.d.ts +70 -0
package/dist/src/package_content_types.js +12 -0
package/package.json +2 -2
package/dist/app_commands.d.ts +0 -401
package/dist/app_commands.js +0 -1520
package/dist/app_commands.test.d.ts +0 -1
package/dist/app_commands.test.js +0 -898
package/dist/app_workflow_check.d.ts +0 -77
package/dist/app_workflow_check.js +0 -169
package/dist/app_workflow_check.test.d.ts +0 -1
package/dist/app_workflow_check.test.js +0 -166
package/dist/args.d.ts +0 -42
package/dist/args.js +0 -121
package/dist/args.test.d.ts +0 -1
package/dist/args.test.js +0 -88
package/dist/child_env.d.ts +0 -13
package/dist/child_env.js +0 -24
package/dist/cli.d.ts +0 -2
package/dist/cli.js +0 -1095
package/dist/cli_dispatch.test.d.ts +0 -1
package/dist/cli_dispatch.test.js +0 -89
package/dist/client.test.d.ts +0 -1
package/dist/client.test.js +0 -47
package/dist/config.d.ts +0 -124
package/dist/config.js +0 -315
package/dist/config.test.d.ts +0 -1
package/dist/config.test.js +0 -319
package/dist/dev/file_relay.d.ts +0 -39
package/dist/dev/file_relay.js +0 -87
package/dist/dev/file_relay.test.d.ts +0 -1
package/dist/dev/file_relay.test.js +0 -87
package/dist/dev/rpc_handler.d.ts +0 -21
package/dist/dev/rpc_handler.js +0 -166
package/dist/dev/rpc_handler.test.d.ts +0 -1
package/dist/dev/rpc_handler.test.js +0 -107
package/dist/dev/server.d.ts +0 -75
package/dist/dev/server.js +0 -443
package/dist/dev/upload_relay.d.ts +0 -36
package/dist/dev/upload_relay.js +0 -61
package/dist/dev/upload_relay.test.d.ts +0 -1
package/dist/dev/upload_relay.test.js +0 -76
package/dist/dev/wrapper_page.d.ts +0 -40
package/dist/dev/wrapper_page.js +0 -335
package/dist/docx.d.ts +0 -2
package/dist/docx.js +0 -341
package/dist/docx.test.d.ts +0 -1
package/dist/docx.test.js +0 -145
package/dist/file_command_io.d.ts +0 -12
package/dist/file_command_io.js +0 -34
package/dist/generate_app_agents_dts.d.ts +0 -16
package/dist/generate_app_agents_dts.js +0 -62
package/dist/generate_app_agents_dts.test.d.ts +0 -1
package/dist/generate_app_agents_dts.test.js +0 -45
package/dist/generate_app_fields.d.ts +0 -56
package/dist/generate_app_fields.js +0 -148
package/dist/generate_app_fields.test.d.ts +0 -1
package/dist/generate_app_fields.test.js +0 -108
package/dist/generate_app_queries_dts.d.ts +0 -21
package/dist/generate_app_queries_dts.js +0 -57
package/dist/generate_app_workflows_dts.d.ts +0 -39
package/dist/generate_app_workflows_dts.js +0 -229
package/dist/generate_app_workflows_dts.test.d.ts +0 -1
package/dist/generate_app_workflows_dts.test.js +0 -109
package/dist/generate_package_fields.d.ts +0 -49
package/dist/generate_package_fields.js +0 -157
package/dist/generate_package_fields.test.d.ts +0 -1
package/dist/generate_package_fields.test.js +0 -59
package/dist/inputs.d.ts +0 -38
package/dist/inputs.js +0 -50
package/dist/inputs.test.d.ts +0 -1
package/dist/inputs.test.js +0 -89
package/dist/preview.d.ts +0 -3
package/dist/preview.js +0 -233
package/dist/starter_template.d.ts +0 -64
package/dist/starter_template.js +0 -753
package/dist/starter_template.test.d.ts +0 -1
package/dist/starter_template.test.js +0 -115
package/dist/version.d.ts +0 -1
package/dist/version.js +0 -6
package/dist/xlsx.d.ts +0 -2
package/dist/xlsx.js +0 -489
package/dist/xlsx.test.d.ts +0 -1
package/dist/xlsx.test.js +0 -131
/package/dist/{client.js → src/client.js} +0 -0

package/dist/dev/wrapper_page.js DELETED Viewed

@@ -1,335 +0,0 @@
-/**
- * Builds the wrapper HTML for `lotics app dev`.
- *
- * The wrapper page is served at http://localhost:<port>/ and embeds the
- * project's Vite dev server in an iframe with the same
- * sandbox="allow-scripts allow-same-origin allow-downloads" attribute
- * production uses — safe because the Vite iframe is cross-origin to this
- * wrapper (different port), so the app gets its own real origin (and Web
- * Storage) without being able to reach the wrapper. `allow-downloads` lets
- * apps trigger file downloads (generated xlsx / pdf etc.) — Chrome blocks
- * every download path from sandboxed iframes without it. `allow="...; geolocation;
- * web-share"` delegates the host's location permission (geofenced actions read the
- * device position) and grants the Web Share API (apps call `navigator.share({ files })`
- * to push e.g. container photos to the OS share sheet / gallery) — matching
- * production. The iframe sends postMessage RPCs to
- * this wrapper, which forwards them to the local /_rpc endpoint, which
- * dispatches to api.lotics.ai with the CLI's API key.
- *
- * postMessage is origin-locked both ways — the wrapper passes its origin
- * via `?lotics_host=` and talks only to the Vite origin.
- *
- * Protocol matches `frontend/features/app_ui/app_iframe_host.tsx` exactly:
- *   iframe → wrapper: { id: number, op: string, payload: unknown }
- *   wrapper → iframe: { id, type: "result", data } | { id, type: "error", message }
- *   streaming (op "agentRun"): { id, type: "stream-chunk", chunk } * → { id, type: "stream-end" };
- *     the iframe aborts with { id, type: "abort" }.
- *   urlState (useUrlState): the iframe reads/writes the wrapper's address bar via
- *     urlState.get/set; set writes in place (replaceState), and browser
- *     back/forward broadcast { type: "url-state", params } back to the iframe.
- *     (In-app routing isn't here — the app owns the iframe's own url; see
- *     @lotics/app-sdk/router.)
- */
-export function buildWrapperPage(args) {
-    const { app_name, app_id, workspace_id, vite_url, api_url } = args;
-    return `<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>${escapeHtml(app_name)} — lotics app dev</title>
-  <style>
-    html, body { margin: 0; height: 100%; }
-    body {
-      display: flex; flex-direction: column;
-      font-family: ui-sans-serif, system-ui, -apple-system, sans-serif;
-      background: #f4f4f5;
-    }
-    header {
-      padding: 8px 14px;
-      background: #18181b;
-      color: #fafafa;
-      font-size: 12px;
-      display: flex; align-items: center; gap: 12px;
-      flex-shrink: 0;
-    }
-    header strong { font-size: 13px; }
-    header code {
-      font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
-      font-size: 11px;
-      background: rgba(255,255,255,0.08);
-      padding: 1px 6px; border-radius: 3px;
-    }
-    header span { color: #a1a1aa; }
-    iframe { border: 0; flex: 1; width: 100%; background: #fff; }
-  </style>
-</head>
-<body>
-  <header>
-    <strong>${escapeHtml(app_name)}</strong>
-    <span>app_id <code>${escapeHtml(app_id)}</code></span>
-    <span>workspace <code>${escapeHtml(workspace_id)}</code></span>
-    <span>RPC → <code>${escapeHtml(api_url)}</code></span>
-  </header>
-  <iframe id="app" sandbox="allow-scripts allow-same-origin allow-downloads" allow="clipboard-write; geolocation; web-share"></iframe>
-  <script>
-    (function () {
-      const APP_ID = ${JSON.stringify(app_id)};
-      const VITE_URL = ${JSON.stringify(vite_url)};
-      const VITE_ORIGIN = new URL(VITE_URL).origin;
-      const iframe = document.getElementById("app");
-      // Pass the wrapper's own origin to the app via ?lotics_host= so the app
-      // SDK can origin-lock its postMessage bridge, and bake the saved screen
-      // (the wrapper url's _loc, kept current by AppRouter's mirror) into the src
-      // path so a refresh boots the app at that screen — mirrors the production
-      // host. _loc is honoured only when it resolves same-origin to the Vite
-      // server (a url param flowing into an iframe src is a redirect vector);
-      // anything else falls back to the app root.
-      const appSrc = new URL(VITE_URL);
-      const savedLoc = new URLSearchParams(window.location.search).get("_loc");
-      if (savedLoc) {
-        try {
-          const resolved = new URL(savedLoc, VITE_ORIGIN);
-          if (resolved.origin === VITE_ORIGIN) {
-            appSrc.pathname = resolved.pathname;
-            appSrc.search = resolved.search;
-            appSrc.hash = resolved.hash;
-          }
-        } catch (e) {
-          // malformed _loc -> app root
-        }
-      }
-      appSrc.searchParams.set("lotics_host", window.location.origin);
-      iframe.src = appSrc.toString();
-      async function rpc(op, payload) {
-        const res = await fetch("/_rpc", {
-          method: "POST",
-          headers: { "content-type": "application/json" },
-          body: JSON.stringify({ app_id: APP_ID, op: op, payload: payload }),
-        });
-        const text = await res.text();
-        if (!res.ok) {
-          let detail = text;
-          try { detail = JSON.parse(text).message ?? text; } catch (_) {}
-          throw new Error(detail || ("HTTP " + res.status));
-        }
-        return JSON.parse(text);
-      }
-      // The iframe SDK sends one "upload" op carrying a File. A File can't
-      // cross the JSON /_rpc hop, so the upload runs here in the browser:
-      // mint an upload URL, PUT the bytes, then finalize.
-      //
-      // In dev the minted URL is same-origin (/_upload/<file_id>) — the dev
-      // server relays the bytes to storage on our behalf, because the prod
-      // bucket's CORS does not admit a localhost origin. Production PUTs the
-      // presigned storage URL directly. Same three lines either way: the page
-      // PUTs wherever the mint points.
-      //
-      // Retry policy parity with the production SDK
-      // (packages/app-sdk/src/upload/transport.ts): 3 PUT attempts with
-      // 1s/2s/4s backoff on 5xx + network errors. 4xx is terminal. Image
-      // compression is intentionally NOT inlined here — dev networks are
-      // stable enough, and end-user mobile cases are handled by the SDK
-      // and bridged host directly.
-      async function putWithRetry(url, file) {
-        const MAX_ATTEMPTS = 3;
-        let lastError;
-        for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-          try {
-            const res = await fetch(url, {
-              method: "PUT",
-              body: file,
-              headers: { "Content-Type": file.type },
-            });
-            if (res.ok) return res;
-            // 4xx is terminal — retrying a malformed/expired URL is pointless.
-            if (res.status >= 400 && res.status < 500) return res;
-            lastError = new Error("Storage PUT returned " + res.status);
-          } catch (err) {
-            lastError = err;
-          }
-          if (attempt < MAX_ATTEMPTS) {
-            const delayMs = 1000 * Math.pow(2, attempt - 1);
-            await new Promise(function (r) { setTimeout(r, delayMs); });
-          }
-        }
-        throw lastError || new Error("Storage PUT failed");
-      }
-      async function handleUpload(payload) {
-        const file = payload && payload.file;
-        if (!(file instanceof File)) {
-          throw new Error("upload payload must include a File");
-        }
-        const init = await rpc("upload_url", {
-          filename: file.name,
-          mime_type: file.type,
-          file_size: file.size,
-        });
-        const putRes = await putWithRetry(init.upload_url, file);
-        if (!putRes.ok) {
-          throw new Error("Storage upload failed (" + putRes.status + ")");
-        }
-        const completed = await rpc("upload_complete", {
-          file_id: init.file_id,
-          file_storage_key: init.file_storage_key,
-          filename: file.name,
-        });
-        return completed.file;
-      }
-      // openExternal — the wrapper page is the top frame (un-sandboxed), so it
-      // opens the link directly; NOT forwarded to the RPC endpoint (no server
-      // op). Re-validate the scheme; never trust the iframe's payload.
-      function handleOpenExternal(payload) {
-        var url = payload && payload.url;
-        if (typeof url !== "string") throw new Error("openExternal requires a url string");
-        var parsed = new URL(url);
-        if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
-          throw new Error('openExternal: unsupported URL scheme "' + parsed.protocol + '"');
-        }
-        window.open(parsed.href, "_blank", "noopener,noreferrer");
-        return undefined;
-      }
-      // urlState.get/set — useUrlState keeps app view-state (filters, search) in
-      // THIS wrapper page's address bar so it survives refresh and is shareable,
-      // mirroring the production host. Handled locally (the URL is the store; no
-      // API hop). The wrapper page is its own top-level page, so its query string
-      // is entirely the app's. Repeated keys become arrays. Parse/merge MUST
-      // match @lotics/app-sdk parseSearch/serializeMerge and the production host
-      // (inline JS here — no module system to share the trivial copy).
-      function readUrlParams() {
-        const sp = new URLSearchParams(window.location.search);
-        const out = {};
-        sp.forEach(function (_value, key) {
-          if (key in out) return;
-          const all = sp.getAll(key);
-          out[key] = all.length > 1 ? all : all[0];
-        });
-        return out;
-      }
-      function handleUrlStateSet(payload) {
-        const params = (payload && payload.params) || {};
-        const sp = new URLSearchParams(window.location.search);
-        Object.keys(params).forEach(function (key) {
-          sp.delete(key);
-          const value = params[key];
-          if (value === undefined || value === null) return;
-          if (Array.isArray(value)) value.forEach(function (item) { sp.append(key, item); });
-          else sp.append(key, value);
-        });
-        const qs = sp.toString();
-        const url = window.location.pathname + (qs ? "?" + qs : "") + window.location.hash;
-        // View-state writes in place — never a history entry. replaceState doesn't
-        // fire popstate, so no echo. Mirrors the production host.
-        window.history.replaceState(null, "", url);
-        return undefined;
-      }
-      // Streaming agent runs (op "agentRun"): the response is a stream, so it
-      // can't use rpc()'s single JSON round-trip. POST /_agent_run, read the SSE
-      // body, and forward chunks to the iframe as the SDK's bridged streaming
-      // protocol expects (stream-chunk* -> stream-end). Mirrors the production
-      // host in frontend/features/app_ui/app_iframe_host.tsx.
-      const streamingRuns = {};
-      async function handleAgentRun(id, payload) {
-        const controller = new AbortController();
-        streamingRuns[id] = controller;
-        try {
-          const res = await fetch("/_agent_run", {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ app_id: APP_ID, op: "agentRun", payload: payload }),
-            signal: controller.signal,
-          });
-          if (!res.ok || !res.body) {
-            let detail = await res.text().catch(function () { return ""; });
-            try { detail = JSON.parse(detail).message || detail; } catch (_) {}
-            throw new Error(detail || ("HTTP " + res.status));
-          }
-          const reader = res.body.getReader();
-          const decoder = new TextDecoder();
-          for (;;) {
-            const r = await reader.read();
-            if (r.done) break;
-            iframe.contentWindow.postMessage(
-              { id: id, type: "stream-chunk", chunk: decoder.decode(r.value, { stream: true }) },
-              VITE_ORIGIN
-            );
-          }
-          const tail = decoder.decode();
-          if (tail) iframe.contentWindow.postMessage({ id: id, type: "stream-chunk", chunk: tail }, VITE_ORIGIN);
-          iframe.contentWindow.postMessage({ id: id, type: "stream-end" }, VITE_ORIGIN);
-        } catch (err) {
-          if (controller.signal.aborted) return;
-          const message = err && err.message ? err.message : String(err);
-          iframe.contentWindow.postMessage({ id: id, type: "error", message: message }, VITE_ORIGIN);
-        } finally {
-          delete streamingRuns[id];
-        }
-      }
-      window.addEventListener("message", async function (event) {
-        if (event.source !== iframe.contentWindow || event.origin !== VITE_ORIGIN) return;
-        const msg = event.data;
-        if (!msg || typeof msg.id !== "number") return;
-        // Abort an in-flight streaming run (control message, carries no op).
-        if (msg.type === "abort") {
-          if (streamingRuns[msg.id]) { streamingRuns[msg.id].abort(); delete streamingRuns[msg.id]; }
-          return;
-        }
-        if (typeof msg.op !== "string") return;
-        // Streaming agent run — many messages back, not a single result.
-        if (msg.op === "agentRun") { handleAgentRun(msg.id, msg.payload); return; }
-        const startedAt = performance.now();
-        try {
-          const data = msg.op === "upload"
-            ? await handleUpload(msg.payload)
-            : msg.op === "openExternal"
-            ? handleOpenExternal(msg.payload)
-            : msg.op === "urlState.get"
-            ? readUrlParams()
-            : msg.op === "urlState.set"
-            ? handleUrlStateSet(msg.payload)
-            : await rpc(msg.op, msg.payload);
-          const ms = Math.round(performance.now() - startedAt);
-          console.debug("[lotics-dev] " + msg.op + " " + ms + "ms", data);
-          iframe.contentWindow.postMessage(
-            { id: msg.id, type: "result", data: data },
-            VITE_ORIGIN
-          );
-        } catch (err) {
-          const message = err && err.message ? err.message : String(err);
-          console.error("[lotics-dev] " + msg.op + " failed:", message);
-          iframe.contentWindow.postMessage(
-            { id: msg.id, type: "error", message: message },
-            VITE_ORIGIN
-          );
-        }
-      });
-      // Browser back/forward → broadcast the new params so useUrlState re-hydrates
-      // (the app's own set writes use replaceState — no popstate — so there's no
-      // echo). Mirrors the production host.
-      window.addEventListener("popstate", function () {
-        iframe.contentWindow.postMessage(
-          { type: "url-state", params: readUrlParams() },
-          VITE_ORIGIN
-        );
-      });
-    })();
-  </script>
-</body>
-</html>
-`;
-}
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, "&amp;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
-}

package/dist/docx.d.ts DELETED Viewed

	@@ -1,2 +0,0 @@
1	- export declare function printDocxHelp(): void;
2	- export declare function runDocxCommand(subcommand: string \| undefined, toolArgs: string \| undefined, restArgs: string[]): Promise<void>;

package/dist/docx.js DELETED Viewed

@@ -1,341 +0,0 @@
-import fs from "node:fs";
-import { fail, writeFileAtomic } from "./file_command_io.js";
-import { parseDocx, serializeDocx, } from "@lotics/docx";
-const DEFAULT_DOC_ATTRS = {
-    "@_xmlns:w": "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
-};
-async function loadFile(filePath) {
-    if (!fs.existsSync(filePath))
-        fail(`File not found: ${filePath}`);
-    const bytes = fs.readFileSync(filePath);
-    return parseDocx(new Uint8Array(bytes));
-}
-async function writeDoc(filePath, doc) {
-    const bytes = await serializeDocx(doc);
-    writeFileAtomic(filePath, bytes);
-}
-// =============================================================================
-// Block construction (typed, immutable)
-// =============================================================================
-function buildParagraph(text, style) {
-    const properties = style ? [buildPStyle(style)] : null;
-    const content = [buildRun(text)];
-    return { kind: "paragraph", properties, content };
-}
-function buildPStyle(styleId) {
-    return { "w:pStyle": [], ":@": { "@_w:val": styleId } };
-}
-function buildRun(text) {
-    // Split on \n so newlines render as Word line breaks (<w:br/>) instead of
-    // collapsing into a single line — multi-line agent input is common.
-    const segments = text.split("\n");
-    const content = [];
-    for (let i = 0; i < segments.length; i++) {
-        const value = segments[i];
-        if (value !== "") {
-            content.push({
-                kind: "text",
-                value,
-                preserveSpace: value.startsWith(" ") || value.endsWith(" "),
-            });
-        }
-        if (i < segments.length - 1) {
-            content.push({ kind: "opaque_run_child", xml: { "w:br": [] } });
-        }
-    }
-    if (content.length === 0)
-        content.push({ kind: "text", value: "", preserveSpace: false });
-    return { kind: "run", properties: null, content };
-}
-function replaceChildren(doc, children) {
-    return {
-        parts: doc.parts,
-        documentAttrs: doc.documentAttrs,
-        body: { children },
-    };
-}
-// =============================================================================
-// Read: project body to a simplified shape
-// =============================================================================
-function readToJson(doc, includeOpaque) {
-    const blocks = doc.body.children.map((block, index) => projectBlock(block, index, includeOpaque));
-    return { documentAttrs: doc.documentAttrs, blocks };
-}
-function projectBlock(block, index, includeOpaque) {
-    switch (block.kind) {
-        case "paragraph":
-            return {
-                kind: "paragraph",
-                index,
-                text: extractText(block),
-                style: extractStyleId(block.properties),
-            };
-        case "body_sect_pr":
-            return includeOpaque
-                ? { kind: "body_sect_pr", index, xml: block.xml }
-                : { kind: "body_sect_pr", index };
-        case "opaque_block":
-            return includeOpaque
-                ? { kind: "opaque_block", index, tag: firstTagName(block.xml), xml: block.xml }
-                : { kind: "opaque_block", index, tag: firstTagName(block.xml) };
-    }
-}
-function extractText(para) {
-    let out = "";
-    for (const inline of para.content) {
-        if (inline.kind !== "run")
-            continue;
-        for (const child of inline.content) {
-            if (child.kind === "text")
-                out += child.value;
-            else if (child.kind === "opaque_run_child" && firstTagName(child.xml) === "w:br")
-                out += "\n";
-        }
-    }
-    return out;
-}
-function extractStyleId(properties) {
-    if (!properties)
-        return undefined;
-    for (const prop of properties) {
-        if (firstTagName(prop) !== "w:pStyle")
-            continue;
-        const attrs = prop[":@"];
-        if (attrs?.["@_w:val"])
-            return attrs["@_w:val"];
-    }
-    return undefined;
-}
-function firstTagName(el) {
-    for (const key of Object.keys(el)) {
-        if (key !== ":@" && key !== "#text")
-            return key;
-    }
-    return undefined;
-}
-// =============================================================================
-// Write: build DocxDocument from a SimpleDoc
-// =============================================================================
-function buildDoc(input) {
-    if (!input || !Array.isArray(input.blocks))
-        fail("docx write JSON must include a `blocks` array");
-    const children = [];
-    for (let i = 0; i < input.blocks.length; i++) {
-        const b = input.blocks[i];
-        if (!b || typeof b !== "object")
-            fail(`blocks[${i}] must be an object`);
-        if (b.kind === "paragraph") {
-            if (typeof b.text !== "string")
-                fail(`blocks[${i}].text must be a string`);
-            if (b.style !== undefined && typeof b.style !== "string")
-                fail(`blocks[${i}].style must be a string`);
-            children.push(buildParagraph(b.text, b.style));
-        }
-        else if (b.kind === "opaque_block") {
-            fail(`blocks[${i}]: opaque_block cannot be created from JSON; read+modify an existing .docx instead`);
-        }
-        else {
-            const kind = b.kind;
-            fail(`blocks[${i}]: unknown kind ${JSON.stringify(kind)} (expected "paragraph")`);
-        }
-    }
-    const documentAttrs = { ...DEFAULT_DOC_ATTRS, ...(input.documentAttrs ?? {}) };
-    return { parts: new Map(), documentAttrs, body: { children } };
-}
-// =============================================================================
-// Subcommand handlers
-// =============================================================================
-async function docxRead(filePath, rest) {
-    if (!filePath)
-        fail("Usage: lotics docx read <file> [--include-opaque]");
-    const includeOpaque = rest.includes("--include-opaque");
-    const doc = await loadFile(filePath);
-    console.log(JSON.stringify(readToJson(doc, includeOpaque), null, 2));
-}
-async function docxWrite(filePath, json) {
-    if (!filePath || !json)
-        fail("Usage: lotics docx write <file> '<json>'");
-    let parsed;
-    try {
-        parsed = JSON.parse(json);
-    }
-    catch (e) {
-        fail(`Invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const doc = buildDoc(parsed);
-    await writeDoc(filePath, doc);
-}
-function getStyleFlag(rest) {
-    for (const arg of rest) {
-        if (arg.startsWith("--style="))
-            return arg.slice("--style=".length);
-    }
-    return undefined;
-}
-function getAtFlag(rest) {
-    for (const arg of rest) {
-        if (arg.startsWith("--at=")) {
-            const n = parseInt(arg.slice("--at=".length), 10);
-            return Number.isFinite(n) ? n : undefined;
-        }
-    }
-    return undefined;
-}
-function firstPositional(rest) {
-    return rest.find((a) => !a.startsWith("--"));
-}
-async function docxAppendParagraph(filePath, rest) {
-    const text = firstPositional(rest);
-    if (!filePath || text === undefined)
-        fail("Usage: lotics docx append-paragraph <file> '<text>' [--style=NAME]");
-    const style = getStyleFlag(rest);
-    const doc = await loadFile(filePath);
-    const para = buildParagraph(text, style);
-    const newChildren = [...doc.body.children, para];
-    await writeDoc(filePath, replaceChildren(doc, newChildren));
-}
-async function docxInsertParagraph(filePath, rest) {
-    const text = firstPositional(rest);
-    const at = getAtFlag(rest);
-    if (!filePath || text === undefined || at === undefined) {
-        fail("Usage: lotics docx insert-paragraph <file> '<text>' --at=<index> [--style=NAME]");
-    }
-    const style = getStyleFlag(rest);
-    const doc = await loadFile(filePath);
-    if (at < 0 || at > doc.body.children.length) {
-        fail(`--at=${at} out of range (0..${doc.body.children.length})`);
-    }
-    const para = buildParagraph(text, style);
-    const newChildren = [...doc.body.children];
-    newChildren.splice(at, 0, para);
-    await writeDoc(filePath, replaceChildren(doc, newChildren));
-}
-async function docxDeleteBlock(filePath, rest) {
-    const at = getAtFlag(rest);
-    if (!filePath || at === undefined)
-        fail("Usage: lotics docx delete-block <file> --at=<index>");
-    const doc = await loadFile(filePath);
-    if (at < 0 || at >= doc.body.children.length) {
-        fail(`--at=${at} out of range (0..${doc.body.children.length - 1})`);
-    }
-    const newChildren = doc.body.children.filter((_, i) => i !== at);
-    await writeDoc(filePath, replaceChildren(doc, newChildren));
-}
-async function docxReplaceText(filePath, rest) {
-    const [search, replace] = rest;
-    if (!filePath || !search || replace === undefined) {
-        fail("Usage: lotics docx replace-text <file> '<search>' '<replace>'");
-    }
-    const doc = await loadFile(filePath);
-    const newChildren = doc.body.children.map((b) => (b.kind === "paragraph" ? replaceInParagraph(b, search, replace) : b));
-    await writeDoc(filePath, replaceChildren(doc, newChildren));
-}
-function replaceInParagraph(p, search, replace) {
-    const content = p.content.map((inline) => {
-        if (inline.kind !== "run")
-            return inline;
-        const newChildren = inline.content.map((c) => c.kind === "text"
-            ? { kind: "text", value: c.value.split(search).join(replace), preserveSpace: c.preserveSpace }
-            : c);
-        return { kind: "run", properties: inline.properties, content: newChildren };
-    });
-    return { kind: "paragraph", properties: p.properties, content };
-}
-async function docxBatch(filePath, json) {
-    if (!filePath || !json)
-        fail("Usage: lotics docx batch <file> '<json-array-of-ops>'");
-    let ops;
-    try {
-        ops = JSON.parse(json);
-    }
-    catch (e) {
-        fail(`Invalid batch JSON: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    if (!Array.isArray(ops))
-        fail("Batch must be a JSON array of ops");
-    for (let i = 0; i < ops.length; i++) {
-        const op = ops[i];
-        if (!op || typeof op !== "object" || typeof op.op !== "string") {
-            fail(`[op ${i}] each op must be an object with an "op" string field`);
-        }
-    }
-    let doc = await loadFile(filePath);
-    for (let i = 0; i < ops.length; i++) {
-        doc = applyBatchOp(doc, ops[i], i);
-    }
-    await writeDoc(filePath, doc);
-}
-function applyBatchOp(doc, op, index) {
-    switch (op.op) {
-        case "append-paragraph": {
-            const para = buildParagraph(op.text, op.style);
-            return replaceChildren(doc, [...doc.body.children, para]);
-        }
-        case "insert-paragraph": {
-            if (op.at < 0 || op.at > doc.body.children.length) {
-                fail(`[op ${index}] at=${op.at} out of range`);
-            }
-            const next = [...doc.body.children];
-            next.splice(op.at, 0, buildParagraph(op.text, op.style));
-            return replaceChildren(doc, next);
-        }
-        case "delete-block": {
-            if (op.at < 0 || op.at >= doc.body.children.length) {
-                fail(`[op ${index}] at=${op.at} out of range`);
-            }
-            return replaceChildren(doc, doc.body.children.filter((_, i) => i !== op.at));
-        }
-        case "replace-text": {
-            const next = doc.body.children.map((b) => (b.kind === "paragraph" ? replaceInParagraph(b, op.search, op.replace) : b));
-            return replaceChildren(doc, next);
-        }
-        default: {
-            const exhaustive = op;
-            void exhaustive;
-            fail(`[op ${index}] Unknown op: ${JSON.stringify(op)}`);
-        }
-    }
-}
-// =============================================================================
-// Dispatch + help
-// =============================================================================
-export function printDocxHelp() {
-    console.error(`Lotics docx commands — manipulate .docx files in place.
-Uses Lotics' own OOXML engine; round-trips faithfully with the Lotics editor and templates.
-  lotics docx read <file> [--include-opaque]               Dump file as JSON (blocks with text/style)
-  lotics docx write <file> '<json>'                        Create .docx from {"blocks":[{"kind":"paragraph","text":...}]}
-  lotics docx append-paragraph <file> '<text>' [--style=NAME]
-                                                           Append a paragraph (styles: Title, Heading1..3, Quote, Code)
-  lotics docx insert-paragraph <file> '<text>' --at=<i> [--style=NAME]
-                                                           Insert a paragraph at index <i> (0-based)
-  lotics docx delete-block <file> --at=<i>                 Remove the block at index <i>
-  lotics docx replace-text <file> '<search>' '<replace>'   Replace text in all paragraph runs
-  lotics docx batch <file> '<json-array-of-ops>'           Apply many ops in one parse/serialize cycle
-Edit ops mutate the file atomically (temp file + rename). Opaque blocks (tables, custom XML) are preserved verbatim.`);
-}
-export async function runDocxCommand(subcommand, toolArgs, restArgs) {
-    switch (subcommand) {
-        case "read":
-            return docxRead(toolArgs, restArgs);
-        case "write":
-            return docxWrite(toolArgs, restArgs[0]);
-        case "append-paragraph":
-            return docxAppendParagraph(toolArgs, restArgs);
-        case "insert-paragraph":
-            return docxInsertParagraph(toolArgs, restArgs);
-        case "delete-block":
-            return docxDeleteBlock(toolArgs, restArgs);
-        case "replace-text":
-            return docxReplaceText(toolArgs, restArgs);
-        case "batch":
-            return docxBatch(toolArgs, restArgs[0]);
-        default: {
-            if (subcommand)
-                console.error(`Unknown docx subcommand: ${subcommand}\n`);
-            printDocxHelp();
-            process.exit(subcommand ? 1 : 0);
-        }
-    }
-}

package/dist/docx.test.d.ts DELETED Viewed

	@@ -1 +0,0 @@
1	- export {};