gui4cli 0.0.0 → 0.0.2

package/dist/detect/yargs.js

@@ -0,0 +1,75 @@
+import ts from "typescript";
+import { objectProps, parseSource, primitiveLiteral, stringLiteral, walkCalls } from "./ast.js";
+import { fieldFromFlag, nameFromLongFlag, shouldSkipFlag } from "./flags.js";
+const YARGS_TYPES = new Set(["string", "number", "boolean", "array"]);
+export function detectYargs(fileName, source) {
+    const sf = parseSource(fileName, source);
+    const fields = [];
+    walkCalls(sf, (call, method) => {
+        if (method !== "option" && method !== "options" && method !== "positional")
+            return;
+        if (method === "options") {
+            const props = objectProps(call.arguments[0]);
+            for (const [name, value] of props) {
+                const field = fieldFromYargs(name, objectProps(value), false);
+                if (field)
+                    fields.push(field);
+            }
+            return;
+        }
+        const name = stringLiteral(call.arguments[0]);
+        if (!name || shouldSkipFlag(name))
+            return;
+        const field = fieldFromYargs(name, objectProps(call.arguments[1]), method === "positional");
+        if (field)
+            fields.push(field);
+    });
+    return uniqueFields(fields);
+}
+function fieldFromYargs(rawName, props, positional) {
+    const name = nameFromLongFlag(rawName.startsWith("-") ? rawName : `--${rawName}`);
+    if (shouldSkipFlag(name))
+        return null;
+    const typeText = stringLiteral(props.get("type"));
+    const type = typeText && YARGS_TYPES.has(typeText)
+        ? typeText === "array"
+            ? "string"
+            : typeText
+        : undefined;
+    const alias = stringLiteral(props.get("alias"));
+    const help = stringLiteral(props.get("describe") ?? props.get("description") ?? props.get("desc"));
+    const required = primitiveLiteral(props.get("demandOption")) === true ||
+        primitiveLiteral(props.get("required")) === true ||
+        primitiveLiteral(props.get("demand")) === true;
+    const defaultValue = primitiveLiteral(props.get("default"));
+    const choices = stringArray(props.get("choices"));
+    return fieldFromFlag({
+        name,
+        longFlag: `--${name}`,
+        shortFlag: alias ? (alias.startsWith("-") ? alias : `-${alias}`) : undefined,
+        type,
+        help,
+        required: required || positional,
+        default: defaultValue,
+        choices,
+        boolean: type === "boolean",
+        positional,
+    });
+}
+function stringArray(node) {
+    if (!node || !ts.isArrayLiteralExpression(node))
+        return undefined;
+    const values = node.elements
+        .map((el) => stringLiteral(el))
+        .filter((value) => Boolean(value));
+    return values.length > 0 ? values : undefined;
+}
+function uniqueFields(fields) {
+    const seen = new Set();
+    return fields.filter((field) => {
+        if (seen.has(field.name))
+            return false;
+        seen.add(field.name);
+        return true;
+    });
+}

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class Gui4CliError extends Error {
+    readonly detail?: string;
+    constructor(message: string, detail?: string);
+}
+export declare function formatUserError(error: unknown): string;

package/dist/errors.js

@@ -0,0 +1,17 @@
+export class Gui4CliError extends Error {
+    detail;
+    constructor(message, detail) {
+        super(message);
+        this.name = "Gui4CliError";
+        this.detail = detail;
+    }
+}
+export function formatUserError(error) {
+    if (error instanceof Gui4CliError) {
+        return error.detail ? `${error.message}\n${error.detail}` : error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}

package/dist/generate/project.d.ts

@@ -0,0 +1,10 @@
+import type { FormSpec, FormValues } from "../schema/form.js";
+export declare function slugify(title: string): string;
+export declare function defaultBuildDir(title: string, cwd: string): string;
+export declare function writeBuildProject(input: {
+    spec: FormSpec;
+    values: FormValues;
+    outDir: string;
+    lastRunPath: string;
+    force?: boolean;
+}): Promise<string>;

package/dist/generate/project.js

@@ -0,0 +1,77 @@
+import { existsSync } from "node:fs";
+import { mkdir, readdir, rm, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { Gui4CliError } from "../errors.js";
+import { writeWindowApp } from "./window.js";
+export function slugify(title) {
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "app";
+}
+export function defaultBuildDir(title, cwd) {
+    return resolve(cwd, `${slugify(title)}-gui`);
+}
+export async function writeBuildProject(input) {
+    const outDir = resolve(input.outDir);
+    await prepareOutDir(outDir, input.force === true);
+    const payload = {
+        spec: input.spec,
+        values: input.values,
+        nodePath: process.execPath,
+        lastRunPath: input.lastRunPath,
+        platform: process.platform,
+    };
+    await writeWindowApp(payload, outDir);
+    const width = input.spec.window?.width ?? 960;
+    const height = input.spec.window?.height ?? 620;
+    const pkgName = slugify(input.spec.title);
+    await writeFile(join(outDir, "package.json"), `${JSON.stringify({
+        name: pkgName,
+        private: true,
+        type: "module",
+        scripts: {
+            start: `npx --yes windowd --title ${JSON.stringify(input.spec.title)} --width ${width} --height ${height}`,
+        },
+    }, null, 2)}\n`, "utf8");
+    await writeFile(join(outDir, "runner.js"), `// GUI4CLI does not rewrite the original script.\nexport const scriptPath = ${JSON.stringify(input.spec.target)};\n`, "utf8");
+    await writeFile(join(outDir, "README.md"), projectReadme(input.spec), "utf8");
+    return outDir;
+}
+async function prepareOutDir(outDir, force) {
+    if (existsSync(outDir)) {
+        const entries = await readdir(outDir).catch(() => null);
+        if (entries === null) {
+            throw new Gui4CliError(`Could not write the project folder.`, `${outDir} already exists and is not a folder.`);
+        }
+        if (entries.length > 0 && !force) {
+            throw new Gui4CliError(`The folder ${outDir} already exists.`, "Choose another --out path, or pass --force to replace it.");
+        }
+        if (force) {
+            await rm(outDir, { recursive: true, force: true });
+        }
+    }
+    await mkdir(outDir, { recursive: true });
+}
+function projectReadme(spec) {
+    const script = basename(spec.target);
+    return `# ${spec.title}
+
+Desktop form generated by GUI4CLI. This folder is the GUI shell. It runs **${script}** in place and does not rewrite that file.
+
+\`\`\`bash
+npx --yes windowd
+# or
+npm start
+\`\`\`
+
+The first windowd launch may download the NW.js runtime (~200 MB).
+
+If you move this folder, keep the original script at:
+
+\`${spec.target}\`
+
+A real \`.exe\` is not part of this step.
+`;
+}

package/dist/generate/window-app.d.ts

@@ -0,0 +1,2 @@
+export declare const windowAppJs = "import { spawn } from \"node:child_process\";\nimport { writeFileSync } from \"node:fs\";\nimport { payload } from \"./payload.js\";\n\nconst statusEl = document.getElementById(\"status\");\nconst formEl = document.getElementById(\"form\");\nconst previewEl = document.getElementById(\"preview\");\nconst outputEl = document.getElementById(\"output\");\nconst runBtn = document.getElementById(\"run\");\nconst cancelBtn = document.getElementById(\"cancel\");\nconst resultEl = document.getElementById(\"result\");\n\nconst values = { ...payload.values };\nlet child = null;\nlet startedAt = 0;\n\nfunction setStatus(phase, text) {\n  statusEl.dataset.phase = phase;\n  statusEl.textContent = text;\n}\n\nfunction quote(part) {\n  return /[\\s\"]/.test(part) ? '\"' + part.replaceAll('\"', '\\\\\"') + '\"' : part;\n}\n\nfunction buildArgv() {\n  const argv = [];\n  for (const field of payload.spec.fields) {\n    const value = values[field.name];\n    if (field.positional) {\n      if (value !== undefined && value !== \"\" && value !== false) argv.push(String(value));\n      continue;\n    }\n    if (field.type === \"boolean\") {\n      if (value === true) argv.push(field.longFlag);\n      continue;\n    }\n    if (value === undefined || value === \"\") continue;\n    argv.push(field.longFlag, String(value));\n  }\n  return argv;\n}\n\nfunction updatePreview() {\n  const argv = buildArgv();\n  previewEl.textContent = [process.execPath, payload.spec.target, ...argv].map(quote).join(\" \")\n    + \"\\n(in \" + payload.spec.cwd + \")\";\n}\n\nfunction missingRequired() {\n  return payload.spec.fields\n    .filter((field) => field.required && field.type !== \"boolean\")\n    .filter((field) => values[field.name] === undefined || values[field.name] === \"\")\n    .map((field) => field.label);\n}\n\nfunction fieldControl(field) {\n  const wrap = document.createElement(\"label\");\n  wrap.className = \"field\";\n  const title = document.createElement(\"span\");\n  title.className = \"field-label\";\n  title.textContent = field.label + (field.required ? \" (required)\" : \"\");\n  wrap.appendChild(title);\n  if (field.help) {\n    const help = document.createElement(\"span\");\n    help.className = \"field-help\";\n    help.textContent = field.help;\n    wrap.appendChild(help);\n  }\n\n  let input;\n  if (field.type === \"boolean\") {\n    input = document.createElement(\"input\");\n    input.type = \"checkbox\";\n    input.checked = Boolean(values[field.name]);\n    input.addEventListener(\"change\", () => {\n      values[field.name] = input.checked;\n      updatePreview();\n    });\n  } else if (field.type === \"choice\" && field.choices) {\n    input = document.createElement(\"select\");\n    for (const choice of field.choices) {\n      const opt = document.createElement(\"option\");\n      opt.value = choice;\n      opt.textContent = choice;\n      if (String(values[field.name]) === choice) opt.selected = true;\n      input.appendChild(opt);\n    }\n    input.addEventListener(\"change\", () => {\n      values[field.name] = input.value;\n      updatePreview();\n    });\n  } else {\n    input = document.createElement(\"input\");\n    input.type = field.type === \"number\" ? \"number\" : \"text\";\n    input.value = values[field.name] === undefined ? \"\" : String(values[field.name]);\n    input.placeholder = field.type === \"directory\" || field.type === \"file\" ? \"Path\" : \"\";\n    input.addEventListener(\"input\", () => {\n      values[field.name] = field.type === \"number\" && input.value !== \"\" ? Number(input.value) : input.value;\n      updatePreview();\n    });\n  }\n  input.id = \"field-\" + field.name;\n  wrap.appendChild(input);\n  return wrap;\n}\n\nfunction appendOutput(stream, text) {\n  const span = document.createElement(\"span\");\n  span.className = stream;\n  span.textContent = text;\n  outputEl.appendChild(span);\n  outputEl.scrollTop = outputEl.scrollHeight;\n}\n\nfunction killTree(pid) {\n  if (payload.platform === \"win32\") {\n    spawn(\"taskkill\", [\"/pid\", String(pid), \"/T\", \"/F\"], { stdio: \"ignore\", windowsHide: true });\n    return;\n  }\n  try { process.kill(-pid, \"SIGTERM\"); } catch { try { process.kill(pid, \"SIGTERM\"); } catch {} }\n}\n\nfunction finish(code) {\n  const ms = Date.now() - startedAt;\n  child = null;\n  runBtn.disabled = false;\n  cancelBtn.disabled = true;\n  const phase = code === 0 ? \"done\" : \"failed\";\n  setStatus(phase, code === 0 ? \"Done\" : \"Failed\");\n  resultEl.textContent = \"Exit code \" + code + \" \u00B7 \" + (ms / 1000).toFixed(1) + \"s\";\n}\n\nfunction run() {\n  const missing = missingRequired();\n  if (missing.length) {\n    setStatus(\"failed\", \"Missing required fields\");\n    resultEl.textContent = \"Fill in: \" + missing.join(\", \");\n    return;\n  }\n  const argv = buildArgv();\n  outputEl.replaceChildren();\n  resultEl.textContent = \"\";\n  setStatus(\"running\", \"Running\");\n  runBtn.disabled = true;\n  cancelBtn.disabled = false;\n  startedAt = Date.now();\n  try {\n    writeFileSync(payload.lastRunPath, JSON.stringify(values, null, 2) + \"\\n\");\n  } catch {}\n\n  child = spawn(process.execPath, [payload.spec.target, ...argv], {\n    cwd: payload.spec.cwd,\n    env: process.env,\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    detached: payload.platform !== \"win32\",\n  });\n  child.stdout.on(\"data\", (chunk) => {\n    setStatus(\"streaming\", \"Streaming output\");\n    appendOutput(\"stdout\", chunk.toString(\"utf8\"));\n  });\n  child.stderr.on(\"data\", (chunk) => {\n    setStatus(\"streaming\", \"Streaming output\");\n    appendOutput(\"stderr\", chunk.toString(\"utf8\"));\n  });\n  child.on(\"error\", (error) => {\n    appendOutput(\"stderr\", error.message + \"\\n\");\n    finish(1);\n  });\n  child.on(\"close\", (code) => finish(code ?? 1));\n}\n\nfunction cancel() {\n  if (!child || child.pid == null) return;\n  killTree(child.pid);\n  appendOutput(\"stderr\", \"\\nCancelled.\\n\");\n}\n\nfor (const field of payload.spec.fields) {\n  formEl.appendChild(fieldControl(field));\n}\nupdatePreview();\nsetStatus(\"ready\", \"Ready \u2014 review the command, then Run\");\nrunBtn.addEventListener(\"click\", run);\ncancelBtn.addEventListener(\"click\", cancel);\ndocument.addEventListener(\"keydown\", (event) => {\n  if (event.key === \"Enter\" && (event.metaKey || event.ctrlKey)) run();\n});\n";
+export declare const windowStyles = ":root {\n  color-scheme: light;\n  --bg: #f6f4ef;\n  --surface: #fffdf8;\n  --ink: #1f1b16;\n  --muted: #5c564d;\n  --line: #d9d2c5;\n  --accent: #2f5d50;\n  --danger: #8a2f2f;\n  --ok: #2f5d50;\n}\n* { box-sizing: border-box; }\nhtml, body { margin: 0; height: 100%; overflow: hidden; }\nbody {\n  font: 14px/1.4 \"Segoe UI\", system-ui, sans-serif;\n  background: var(--bg);\n  color: var(--ink);\n  display: flex;\n  flex-direction: column;\n}\nheader {\n  display: flex;\n  justify-content: space-between;\n  gap: 16px;\n  align-items: baseline;\n  padding: 10px 16px;\n  border-bottom: 1px solid var(--line);\n  background: var(--surface);\n  flex-shrink: 0;\n}\nh1 { margin: 0; font-size: 1.1rem; }\nh2 { margin: 0 0 6px; font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.04em; color: var(--muted); }\n.desc, .muted { color: var(--muted); margin: 2px 0 0; }\n#status { margin: 0; white-space: nowrap; }\nmain {\n  flex: 1;\n  min-height: 0;\n  display: grid;\n  grid-template-columns: minmax(240px, 1fr) minmax(320px, 1.2fr);\n  gap: 12px;\n  padding: 12px 16px 16px;\n}\n.form-pane, .run-pane {\n  min-height: 0;\n  min-width: 0;\n  overflow: auto;\n}\n.run-pane {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n.field { display: flex; flex-direction: column; gap: 2px; margin-bottom: 10px; }\n.field-label { font-weight: 600; }\n.field-help { color: var(--muted); font-size: 0.8rem; }\ninput, select {\n  font: inherit;\n  padding: 6px 8px;\n  border: 1px solid var(--line);\n  border-radius: 6px;\n  background: #fff;\n}\ninput[type=\"checkbox\"] { width: 1.1rem; height: 1.1rem; }\n.preview, .output {\n  background: #1f1b16;\n  color: #f6f4ef;\n  border-radius: 8px;\n  padding: 8px 10px;\n  overflow: auto;\n  white-space: pre-wrap;\n  font: 12px/1.4 ui-monospace, Consolas, monospace;\n}\n.preview { max-height: 4.6em; flex-shrink: 0; }\n.output { flex: 1; min-height: 120px; }\n.output .stderr { color: #f0b4b4; }\n.actions { display: flex; gap: 8px; align-items: center; flex-shrink: 0; }\n@media (max-width: 720px) {\n  main { grid-template-columns: 1fr; }\n}\nbutton {\n  font: inherit;\n  border: 0;\n  border-radius: 6px;\n  padding: 8px 14px;\n  cursor: pointer;\n}\n#run { background: var(--accent); color: #fff; }\n#cancel { background: #ece7dc; color: var(--ink); }\n#cancel:disabled, #run:disabled { opacity: 0.5; cursor: not-allowed; }\n#status[data-phase=\"running\"], #status[data-phase=\"streaming\"] { color: var(--accent); }\n#status[data-phase=\"done\"] { color: var(--ok); }\n#status[data-phase=\"failed\"] { color: var(--danger); }\n";

package/dist/generate/window-app.js

@@ -0,0 +1,282 @@
+export const windowAppJs = `import { spawn } from "node:child_process";
+import { writeFileSync } from "node:fs";
+import { payload } from "./payload.js";
+
+const statusEl = document.getElementById("status");
+const formEl = document.getElementById("form");
+const previewEl = document.getElementById("preview");
+const outputEl = document.getElementById("output");
+const runBtn = document.getElementById("run");
+const cancelBtn = document.getElementById("cancel");
+const resultEl = document.getElementById("result");
+
+const values = { ...payload.values };
+let child = null;
+let startedAt = 0;
+
+function setStatus(phase, text) {
+  statusEl.dataset.phase = phase;
+  statusEl.textContent = text;
+}
+
+function quote(part) {
+  return /[\\s"]/.test(part) ? '"' + part.replaceAll('"', '\\\\"') + '"' : part;
+}
+
+function buildArgv() {
+  const argv = [];
+  for (const field of payload.spec.fields) {
+    const value = values[field.name];
+    if (field.positional) {
+      if (value !== undefined && value !== "" && value !== false) argv.push(String(value));
+      continue;
+    }
+    if (field.type === "boolean") {
+      if (value === true) argv.push(field.longFlag);
+      continue;
+    }
+    if (value === undefined || value === "") continue;
+    argv.push(field.longFlag, String(value));
+  }
+  return argv;
+}
+
+function updatePreview() {
+  const argv = buildArgv();
+  previewEl.textContent = [process.execPath, payload.spec.target, ...argv].map(quote).join(" ")
+    + "\\n(in " + payload.spec.cwd + ")";
+}
+
+function missingRequired() {
+  return payload.spec.fields
+    .filter((field) => field.required && field.type !== "boolean")
+    .filter((field) => values[field.name] === undefined || values[field.name] === "")
+    .map((field) => field.label);
+}
+
+function fieldControl(field) {
+  const wrap = document.createElement("label");
+  wrap.className = "field";
+  const title = document.createElement("span");
+  title.className = "field-label";
+  title.textContent = field.label + (field.required ? " (required)" : "");
+  wrap.appendChild(title);
+  if (field.help) {
+    const help = document.createElement("span");
+    help.className = "field-help";
+    help.textContent = field.help;
+    wrap.appendChild(help);
+  }
+
+  let input;
+  if (field.type === "boolean") {
+    input = document.createElement("input");
+    input.type = "checkbox";
+    input.checked = Boolean(values[field.name]);
+    input.addEventListener("change", () => {
+      values[field.name] = input.checked;
+      updatePreview();
+    });
+  } else if (field.type === "choice" && field.choices) {
+    input = document.createElement("select");
+    for (const choice of field.choices) {
+      const opt = document.createElement("option");
+      opt.value = choice;
+      opt.textContent = choice;
+      if (String(values[field.name]) === choice) opt.selected = true;
+      input.appendChild(opt);
+    }
+    input.addEventListener("change", () => {
+      values[field.name] = input.value;
+      updatePreview();
+    });
+  } else {
+    input = document.createElement("input");
+    input.type = field.type === "number" ? "number" : "text";
+    input.value = values[field.name] === undefined ? "" : String(values[field.name]);
+    input.placeholder = field.type === "directory" || field.type === "file" ? "Path" : "";
+    input.addEventListener("input", () => {
+      values[field.name] = field.type === "number" && input.value !== "" ? Number(input.value) : input.value;
+      updatePreview();
+    });
+  }
+  input.id = "field-" + field.name;
+  wrap.appendChild(input);
+  return wrap;
+}
+
+function appendOutput(stream, text) {
+  const span = document.createElement("span");
+  span.className = stream;
+  span.textContent = text;
+  outputEl.appendChild(span);
+  outputEl.scrollTop = outputEl.scrollHeight;
+}
+
+function killTree(pid) {
+  if (payload.platform === "win32") {
+    spawn("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+    return;
+  }
+  try { process.kill(-pid, "SIGTERM"); } catch { try { process.kill(pid, "SIGTERM"); } catch {} }
+}
+
+function finish(code) {
+  const ms = Date.now() - startedAt;
+  child = null;
+  runBtn.disabled = false;
+  cancelBtn.disabled = true;
+  const phase = code === 0 ? "done" : "failed";
+  setStatus(phase, code === 0 ? "Done" : "Failed");
+  resultEl.textContent = "Exit code " + code + " · " + (ms / 1000).toFixed(1) + "s";
+}
+
+function run() {
+  const missing = missingRequired();
+  if (missing.length) {
+    setStatus("failed", "Missing required fields");
+    resultEl.textContent = "Fill in: " + missing.join(", ");
+    return;
+  }
+  const argv = buildArgv();
+  outputEl.replaceChildren();
+  resultEl.textContent = "";
+  setStatus("running", "Running");
+  runBtn.disabled = true;
+  cancelBtn.disabled = false;
+  startedAt = Date.now();
+  try {
+    writeFileSync(payload.lastRunPath, JSON.stringify(values, null, 2) + "\\n");
+  } catch {}
+
+  child = spawn(process.execPath, [payload.spec.target, ...argv], {
+    cwd: payload.spec.cwd,
+    env: process.env,
+    stdio: ["ignore", "pipe", "pipe"],
+    detached: payload.platform !== "win32",
+  });
+  child.stdout.on("data", (chunk) => {
+    setStatus("streaming", "Streaming output");
+    appendOutput("stdout", chunk.toString("utf8"));
+  });
+  child.stderr.on("data", (chunk) => {
+    setStatus("streaming", "Streaming output");
+    appendOutput("stderr", chunk.toString("utf8"));
+  });
+  child.on("error", (error) => {
+    appendOutput("stderr", error.message + "\\n");
+    finish(1);
+  });
+  child.on("close", (code) => finish(code ?? 1));
+}
+
+function cancel() {
+  if (!child || child.pid == null) return;
+  killTree(child.pid);
+  appendOutput("stderr", "\\nCancelled.\\n");
+}
+
+for (const field of payload.spec.fields) {
+  formEl.appendChild(fieldControl(field));
+}
+updatePreview();
+setStatus("ready", "Ready — review the command, then Run");
+runBtn.addEventListener("click", run);
+cancelBtn.addEventListener("click", cancel);
+document.addEventListener("keydown", (event) => {
+  if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) run();
+});
+`;
+export const windowStyles = `:root {
+  color-scheme: light;
+  --bg: #f6f4ef;
+  --surface: #fffdf8;
+  --ink: #1f1b16;
+  --muted: #5c564d;
+  --line: #d9d2c5;
+  --accent: #2f5d50;
+  --danger: #8a2f2f;
+  --ok: #2f5d50;
+}
+* { box-sizing: border-box; }
+html, body { margin: 0; height: 100%; overflow: hidden; }
+body {
+  font: 14px/1.4 "Segoe UI", system-ui, sans-serif;
+  background: var(--bg);
+  color: var(--ink);
+  display: flex;
+  flex-direction: column;
+}
+header {
+  display: flex;
+  justify-content: space-between;
+  gap: 16px;
+  align-items: baseline;
+  padding: 10px 16px;
+  border-bottom: 1px solid var(--line);
+  background: var(--surface);
+  flex-shrink: 0;
+}
+h1 { margin: 0; font-size: 1.1rem; }
+h2 { margin: 0 0 6px; font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.04em; color: var(--muted); }
+.desc, .muted { color: var(--muted); margin: 2px 0 0; }
+#status { margin: 0; white-space: nowrap; }
+main {
+  flex: 1;
+  min-height: 0;
+  display: grid;
+  grid-template-columns: minmax(240px, 1fr) minmax(320px, 1.2fr);
+  gap: 12px;
+  padding: 12px 16px 16px;
+}
+.form-pane, .run-pane {
+  min-height: 0;
+  min-width: 0;
+  overflow: auto;
+}
+.run-pane {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.field { display: flex; flex-direction: column; gap: 2px; margin-bottom: 10px; }
+.field-label { font-weight: 600; }
+.field-help { color: var(--muted); font-size: 0.8rem; }
+input, select {
+  font: inherit;
+  padding: 6px 8px;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: #fff;
+}
+input[type="checkbox"] { width: 1.1rem; height: 1.1rem; }
+.preview, .output {
+  background: #1f1b16;
+  color: #f6f4ef;
+  border-radius: 8px;
+  padding: 8px 10px;
+  overflow: auto;
+  white-space: pre-wrap;
+  font: 12px/1.4 ui-monospace, Consolas, monospace;
+}
+.preview { max-height: 4.6em; flex-shrink: 0; }
+.output { flex: 1; min-height: 120px; }
+.output .stderr { color: #f0b4b4; }
+.actions { display: flex; gap: 8px; align-items: center; flex-shrink: 0; }
+@media (max-width: 720px) {
+  main { grid-template-columns: 1fr; }
+}
+button {
+  font: inherit;
+  border: 0;
+  border-radius: 6px;
+  padding: 8px 14px;
+  cursor: pointer;
+}
+#run { background: var(--accent); color: #fff; }
+#cancel { background: #ece7dc; color: var(--ink); }
+#cancel:disabled, #run:disabled { opacity: 0.5; cursor: not-allowed; }
+#status[data-phase="running"], #status[data-phase="streaming"] { color: var(--accent); }
+#status[data-phase="done"] { color: var(--ok); }
+#status[data-phase="failed"] { color: var(--danger); }
+`;

package/dist/generate/window.d.ts

@@ -0,0 +1,9 @@
+import type { FormSpec, FormValues } from "../schema/form.js";
+export type WindowPayload = {
+    spec: FormSpec;
+    values: FormValues;
+    nodePath: string;
+    lastRunPath: string;
+    platform: NodeJS.Platform;
+};
+export declare function writeWindowApp(payload: WindowPayload, dest?: string): Promise<string>;

package/dist/generate/window.js

@@ -0,0 +1,56 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { windowAppJs, windowStyles } from "./window-app.js";
+export async function writeWindowApp(payload, dest) {
+    const dir = dest ?? join(tmpdir(), `gui4cli-window-${Date.now()}`);
+    await mkdir(dir, { recursive: true });
+    const html = `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${escapeHtml(payload.spec.title)}</title>
+    <style>${windowStyles}</style>
+  </head>
+  <body>
+    <header>
+      <div>
+        <h1>${escapeHtml(payload.spec.title)}</h1>
+        <p class="desc">${escapeHtml(payload.spec.description ?? "Fill the form, review the command, then Run.")}</p>
+      </div>
+      <p id="status" class="muted" data-phase="ready">Ready</p>
+    </header>
+    <main>
+      <form id="form" class="form-pane"></form>
+      <section class="run-pane">
+        <h2>Command preview</h2>
+        <pre id="preview" class="preview"></pre>
+        <div class="actions">
+          <button type="button" id="run">Run</button>
+          <button type="button" id="cancel" disabled>Cancel</button>
+          <span id="result" class="muted"></span>
+        </div>
+        <h2>Output</h2>
+        <pre id="output" class="output"></pre>
+      </section>
+    </main>
+    <script type="module" src="./app.js"></script>
+  </body>
+</html>
+`;
+    await writeFile(join(dir, "index.html"), html, "utf8");
+    await writeFile(join(dir, "app.js"), windowAppJs, "utf8");
+    await writeFile(join(dir, "payload.js"), `export const payload = ${JSON.stringify(payload, null, 2)};\n`, "utf8");
+    await writeFile(join(dir, "vite.config.js"), `export default {
+  server: { hmr: false, watch: null },
+};
+`, "utf8");
+    return dir;
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}

package/dist/last-run/store.d.ts

@@ -0,0 +1,4 @@
+import { type FormValues } from "../schema/form.js";
+export declare function lastRunPath(target: string): string;
+export declare function loadLastRun(target: string): Promise<FormValues | null>;
+export declare function saveLastRun(target: string, values: FormValues): Promise<void>;

package/dist/last-run/store.js

@@ -0,0 +1,23 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { formValuesSchema } from "../schema/form.js";
+export function lastRunPath(target) {
+    const hash = createHash("sha1").update(target).digest("hex").slice(0, 16);
+    return join(homedir(), ".gui4cli", "lastrun", `${hash}.json`);
+}
+export async function loadLastRun(target) {
+    try {
+        const raw = JSON.parse(await readFile(lastRunPath(target), "utf8"));
+        return formValuesSchema.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveLastRun(target, values) {
+    const path = lastRunPath(target);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(values, null, 2)}\n`, "utf8");
+}

package/dist/resolve/target.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveTarget(input: string | undefined, entry: string | undefined, cwd: string): Promise<{
+    target: string;
+    cwd: string;
+}>;

package/dist/resolve/target.js

@@ -0,0 +1,54 @@
+import { existsSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { Gui4CliError } from "../errors.js";
+export async function resolveTarget(input, entry, cwd) {
+    if (entry) {
+        const target = resolvePath(entry, cwd);
+        assertFile(target, `Could not find the entry file at ${entry}.`);
+        return { target, cwd: dirname(target) };
+    }
+    if (!input) {
+        throw new Gui4CliError("Pass a script file or a project folder.", "Example: gui4cli fixtures/resize.js");
+    }
+    const path = resolvePath(input, cwd);
+    if (!existsSync(path)) {
+        throw new Gui4CliError(`Could not find ${input}.`, "Check the path, or pass --entry if the script lives somewhere else.");
+    }
+    const info = await stat(path);
+    if (info.isFile()) {
+        return { target: path, cwd: dirname(path) };
+    }
+    if (info.isDirectory()) {
+        const fromPkg = await entryFromPackage(path);
+        return { target: fromPkg, cwd: path };
+    }
+    throw new Gui4CliError(`Could not use ${input} as a script or folder.`);
+}
+function resolvePath(input, cwd) {
+    return isAbsolute(input) ? input : resolve(cwd, input);
+}
+function assertFile(path, message) {
+    if (!existsSync(path)) {
+        throw new Gui4CliError(message);
+    }
+}
+async function entryFromPackage(dir) {
+    const pkgPath = resolve(dir, "package.json");
+    if (!existsSync(pkgPath)) {
+        throw new Gui4CliError(`No package.json in ${dir}.`, "Pass a script file, or use --entry path/to/cli.js.");
+    }
+    const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
+    const bin = typeof pkg.bin === "string"
+        ? pkg.bin
+        : pkg.bin
+            ? Object.values(pkg.bin)[0]
+            : undefined;
+    const rel = bin ?? pkg.main;
+    if (!rel) {
+        throw new Gui4CliError(`package.json in ${dir} has no bin or main field.`, "Add one, or run gui4cli --entry path/to/cli.js.");
+    }
+    const target = resolve(dir, rel);
+    assertFile(target, `package.json points at ${rel}, but that file is missing.`);
+    return target;
+}

package/dist/run/argv.d.ts

@@ -0,0 +1,5 @@
+import type { Field, FormValues } from "../schema/form.js";
+export declare function valuesFromDefaults(fields: Field[]): FormValues;
+export declare function buildArgv(fields: Field[], values: FormValues): string[];
+export declare function previewCommand(nodePath: string, target: string, argv: string[], cwd: string): string;
+export declare function missingRequired(fields: Field[], values: FormValues): string[];