@validationcloud/fractal-ui 1.79.0 → 1.80.0

package/bin/fractal-ui

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/cli.js');

package/dist/cli/render-chart-command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const renderChartCommand: Command<[], {
+    input?: string | undefined;
+    output: string;
+    width: string;
+    height: string;
+    dpr: string;
+}, {}>;

package/dist/cli/render-chart-command.js

@@ -0,0 +1,59 @@
+import { Command as o } from "@commander-js/extra-typings";
+import { writeFile as a, rename as n, rm as p } from "node:fs/promises";
+import { join as s, dirname as c } from "node:path";
+import { isPlainObject as d } from "../lib/is-plain-object.js";
+import { renderMavrikChartToImage as h } from "../lib/render-mavrik-chart-to-image.js";
+import { resolveJson as u } from "../lib/resolve-json.js";
+async function m() {
+  const t = [];
+  for await (const r of process.stdin)
+    t.push(Buffer.from(r));
+  return Buffer.concat(t).toString("utf8");
+}
+async function f(t) {
+  if (t !== void 0)
+    return u(t);
+  if (process.stdin.isTTY)
+    throw new Error(
+      `No input provided. Use -i <json> or pipe JSON to stdin.
+Example: echo '{"xAxis":...}' | fractal-ui render-chart -o out.png`
+    );
+  const r = await m(), e = JSON.parse(r);
+  if (!d(e))
+    throw new TypeError("stdin must contain a JSON object");
+  return e;
+}
+async function l(t, r) {
+  if (t === "-") {
+    process.stdout.write(r);
+    return;
+  }
+  const e = s(c(t), `.fractal-ui-${String(process.pid)}-${String(Date.now())}.tmp`);
+  await a(e, r);
+  try {
+    await n(e, t);
+  } catch (i) {
+    throw await p(e, { force: !0 }), i;
+  }
+}
+const v = new o("render-chart").description("Render an ECharts JSON option to a PNG image using the Mavrik theme").option("-i, --input <json>", "ECharts option as JSON string or path to JSON file (reads stdin if omitted)").requiredOption("-o, --output <path>", 'Path to output PNG file, or "-" for stdout').option("-W, --width <pixels>", "Chart width in pixels", "800").option("-H, --height <pixels>", "Chart height in pixels", "600").option("-d, --dpr <ratio>", "Device pixel ratio", "2").addHelpText(
+  "after",
+  `
+Examples:
+  # Render a chart from a JSON file
+  npx -y @validationcloud/fractal-ui render-chart -i chart.json -o chart.png
+
+  # Pipe JSON from another tool
+  curl -s https://api.example.com/chart | npx -y @validationcloud/fractal-ui render-chart -o chart.png`
+).action(async (t) => {
+  const r = await f(t.input), e = h({
+    option: r,
+    width: Number.parseInt(t.width, 10),
+    height: Number.parseInt(t.height, 10),
+    devicePixelRatio: Number.parseInt(t.dpr, 10)
+  });
+  await l(t.output, e);
+});
+export {
+  v as renderChartCommand
+};

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,6 @@
+import { renderChartCommand as e } from "./cli/render-chart-command.js";
+import { Command as a } from "@commander-js/extra-typings";
+import { createRequire as n } from "node:module";
+const i = n(import.meta.url), r = i("../package.json"), o = new a().name(r.name).version(r.version).description(r.description).showHelpAfterError("(add --help for additional information)").showSuggestionAfterError();
+o.addCommand(e);
+await o.parseAsync();

package/dist/lib/is-plain-object.d.ts

@@ -0,0 +1 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;

package/dist/lib/is-plain-object.js

@@ -0,0 +1,6 @@
+function t(r) {
+  return typeof r == "object" && r !== null && !Array.isArray(r);
+}
+export {
+  t as isPlainObject
+};

package/dist/lib/parse-json-with-unescape.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Attempts to parse a JSON string that may be escaped.
+ *
+ * Handles three patterns:
+ * 1. Regular JSON: `{"name": "John"}` → parsed object
+ * 2. Quoted JSON string: `"{\"name\": \"John\"}"` → parsed object
+ * 3. Backslash-escaped: `{\"name\": \"John\"}` → parsed object
+ */
+export declare function parseJsonWithUnescape(content: string): unknown;

package/dist/lib/parse-json-with-unescape.js

@@ -0,0 +1,18 @@
+function a(e) {
+  try {
+    const r = JSON.parse(e);
+    if (typeof r == "string")
+      try {
+        return JSON.parse(r);
+      } catch {
+        return r;
+      }
+    return r;
+  } catch {
+  }
+  const t = e.replaceAll(String.raw`\"`, '"').replaceAll("\\\\", "\\");
+  return JSON.parse(t);
+}
+export {
+  a as parseJsonWithUnescape
+};

package/dist/lib/parse-json-with-unescape.test.d.ts

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

package/dist/lib/resolve-json.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolves input as either inline JSON object or file path to JSON object.
+ *
+ * Resolution order:
+ * 1. Parse input with {@link parseJsonWithUnescape}
+ * 2. If result is a plain object → return it (inline JSON)
+ * 3. If result is an array → throw (not supported)
+ * 4. If result is a string → treat as file path, read & parse as strict JSON
+ * 5. If initial parse fails → treat input as file path
+ *
+ * @throws If input is an array, file doesn't exist, or file doesn't contain an object
+ */
+export declare function resolveJson(input: string): Promise<Record<string, unknown>>;

package/dist/lib/resolve-json.js

@@ -0,0 +1,33 @@
+import { readFile as c } from "node:fs/promises";
+import { isPlainObject as a } from "./is-plain-object.js";
+import { parseJsonWithUnescape as i } from "./parse-json-with-unescape.js";
+async function n(e) {
+  let r;
+  try {
+    r = await c(e, "utf8");
+  } catch (o) {
+    throw o.code === "ENOENT" ? new Error(`File not found: ${e}`) : o;
+  }
+  const t = JSON.parse(r);
+  if (!a(t))
+    throw new Error(`File must contain a JSON object: ${e}`);
+  return t;
+}
+async function y(e) {
+  let r;
+  try {
+    r = i(e);
+  } catch {
+    return n(e);
+  }
+  if (a(r))
+    return r;
+  if (Array.isArray(r))
+    throw new TypeError("JSON arrays are not supported, expected an object");
+  if (typeof r == "string")
+    return n(r);
+  throw new TypeError(`Expected JSON object or file path, got ${typeof r}: ${String(r)}`);
+}
+export {
+  y as resolveJson
+};

package/dist/lib/resolve-json.test.d.ts

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

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@validationcloud/fractal-ui",
+  "description": "Validation Cloud's shared React component library with design tokens, Tailwind CSS utilities, and CLI tools",
   "private": false,
-  "version": "1.79.0",
+  "version": "1.80.0",
   "module": "./dist/index.js",
   "type": "module",
+  "bin": {
+    "fractal-ui": "bin/fractal-ui"
+  },
   "files": [
+    "bin",
     "dist",
     "dist/fonts"
   ],
@@ -58,6 +63,8 @@
     "node": ">=22.14.0"
   },
   "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "commander": "^14.0.3",
     "radix-ui": "^1.4.3",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",