@spectratools/graphic-designer-cli 0.14.1 → 0.14.3

package/dist/cli.js

@@ -1378,6 +1378,60 @@ function deriveSafeFrame(spec) {
 function parseDesignSpec(input) {
   return designSpecSchema.parse(input);
 }
+var graphNodeSchema = z2.object({
+  id: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200),
+  shape: z2.enum([
+    "box",
+    "rounded-box",
+    "diamond",
+    "circle",
+    "pill",
+    "cylinder",
+    "parallelogram",
+    "hexagon"
+  ]).optional()
+}).strict();
+var graphEdgeSchema = z2.object({
+  from: z2.string().min(1).max(120),
+  to: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200).optional()
+}).strict();
+var graphSpecSchema = z2.object({
+  nodes: z2.array(graphNodeSchema).min(1),
+  edges: z2.array(graphEdgeSchema).default([])
+}).strict();
+function isGraphSpecInput(input) {
+  return typeof input === "object" && input !== null && "nodes" in input;
+}
+function graphSpecToDesignSpec(graph) {
+  const elements = [
+    ...graph.nodes.map((n) => ({
+      type: "flow-node",
+      id: n.id,
+      label: n.label,
+      ...n.shape ? { shape: n.shape } : {}
+    })),
+    ...graph.edges.map((e) => ({
+      type: "connection",
+      from: e.from,
+      to: e.to,
+      ...e.label ? { label: e.label } : {}
+    }))
+  ];
+  return designSpecSchema.parse({
+    version: 2,
+    elements,
+    layout: { mode: "auto", algorithm: "layered", direction: "TB" }
+  });
+}
+function parseSpecInput(input) {
+  if (isGraphSpecInput(input)) {
+    const graph = graphSpecSchema.parse(input);
+    return graphSpecToDesignSpec(graph);
+  }
+  return designSpecSchema.parse(input);
+}
 
 // src/qa.ts
 function rectWithin(outer, inner) {
@@ -5997,11 +6051,89 @@ async function runRenderPipeline(spec, options) {
     }
   };
 }
+var renderOptions = z3.object({
+  spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
+  out: z3.string().optional().describe("Output file path (.png) or output directory"),
+  output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
+  specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
+  iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
+  iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
+  maxIterations: z3.number().int().positive().optional().describe("Optional maximum planned iteration count"),
+  previousHash: z3.string().optional().describe("Optional artifact hash from the previous iteration"),
+  allowQaFail: z3.boolean().default(false).describe("Allow render success even if QA fails")
+});
+function resolveOut(options) {
+  const resolved = options.out ?? options.output;
+  if (!resolved) {
+    throw new Error("Either --out or --output is required.");
+  }
+  return resolved;
+}
 cli.command("render", {
   description: "Render a deterministic design artifact from a DesignSpec JSON file.",
+  options: renderOptions,
+  output: renderOutputSchema,
+  examples: [
+    {
+      options: {
+        spec: "./specs/pipeline.json",
+        out: "./output"
+      },
+      description: "Render a design spec and write .png/.meta/.spec artifacts"
+    }
+  ],
+  async run(c) {
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let iteration;
+    try {
+      iteration = parseIterationMeta({
+        ...c.options.iteration != null ? { iteration: c.options.iteration } : {},
+        ...c.options.maxIterations != null ? { maxIterations: c.options.maxIterations } : {},
+        ...c.options.iterationNotes ? { iterationNotes: c.options.iterationNotes } : {},
+        ...c.options.previousHash ? { previousHash: c.options.previousHash } : {}
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "INVALID_ITERATION_OPTIONS",
+        message,
+        retryable: false
+      });
+    }
+    const runReport = await runRenderPipeline(spec, {
+      out,
+      ...c.options.specOut ? { specOut: c.options.specOut } : {},
+      ...iteration ? { iteration } : {}
+    });
+    if (!runReport.qa.pass && !c.options.allowQaFail) {
+      return c.error({
+        code: "QA_FAILED",
+        message: `Render completed but QA failed (${runReport.qa.issueCount} issues). Review qa output.`,
+        retryable: false
+      });
+    }
+    return c.ok(runReport);
+  }
+});
+cli.command("draw", {
+  description: "Alias for render. Render a deterministic design artifact from a DesignSpec JSON.",
+  args: z3.object({
+    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)')
+  }),
   options: z3.object({
-    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
-    out: z3.string().describe("Output file path (.png) or output directory"),
+    out: z3.string().optional().describe("Output file path (.png) or output directory"),
+    output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
     specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
     iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
     iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
@@ -6012,15 +6144,34 @@ cli.command("render", {
   output: renderOutputSchema,
   examples: [
     {
-      options: {
-        spec: "./specs/pipeline.json",
-        out: "./output"
-      },
-      description: "Render a design spec and write .png/.meta/.spec artifacts"
+      args: { spec: "/tmp/spec.json" },
+      options: { output: "/tmp/out" },
+      description: "Render a spec using the draw alias with --output"
     }
   ],
   async run(c) {
-    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    let spec;
+    try {
+      spec = parseSpecInput(await readJson(c.args.spec));
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "UNKNOWN",
+        message,
+        retryable: false
+      });
+    }
     let iteration;
     try {
       iteration = parseIterationMeta({
@@ -6038,7 +6189,7 @@ cli.command("render", {
       });
     }
     const runReport = await runRenderPipeline(spec, {
-      out: c.options.out,
+      out,
       ...c.options.specOut ? { specOut: c.options.specOut } : {},
       ...iteration ? { iteration } : {}
     });

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Cli } from 'incur';
-import { T as ThemeInput, D as DesignSpec, a as Rect$1, b as DrawCommand, c as Theme, d as RenderedElement, A as AnchorHint, C as ConnectionElement } from './spec.schema-De-IkUjn.js';
-export { e as AutoLayoutConfig, B as BuiltInTheme, f as CardElement, g as CodeBlockElement, h as ConstraintSpec, i as DEFAULT_GENERATOR_VERSION, j as DEFAULT_RAINBOW_COLORS, k as Decorator, l as DesignCardSpec, m as DesignSafeFrame, n as DesignTheme, o as DiagramElement, p as DiagramLayout, q as DiagramSpec, r as DrawArc, s as DrawBadge, t as DrawBezier, u as DrawCircle, v as DrawFontFamily, w as DrawGradientRect, x as DrawLine, y as DrawPath, z as DrawPoint, E as DrawRect, F as DrawShadow, G as DrawText, H as DrawTextRow, I as DrawTextRowSegment, J as Element, K as EllipseLayoutConfig, L as FlowNodeElement, M as Gradient, N as GradientOverlayDecorator, O as GradientSpec, P as GradientStop, Q as GridLayoutConfig, S as ImageElement, U as IterationMeta, V as LayoutConfig, W as LayoutSnapshot, X as ManualLayoutConfig, Y as RainbowRuleDecorator, Z as RenderDesignOptions, R as RenderMetadata, _ as RenderResult, $ as ShapeElement, a0 as StackLayoutConfig, a1 as TerminalElement, a2 as TextElement, a3 as ThemeInput, a4 as VignetteDecorator, a5 as WrittenArtifacts, a6 as builtInThemeBackgrounds, a7 as builtInThemes, a8 as computeSpecHash, a9 as connectionElementSchema, aa as defaultAutoLayout, ab as defaultCanvas, ac as defaultConstraints, ad as defaultGridLayout, ae as defaultLayout, af as defaultStackLayout, ag as defaultTheme, ah as deriveSafeFrame, ai as designSpecSchema, aj as diagramElementSchema, ak as diagramLayoutSchema, al as diagramSpecSchema, am as drawGradientRect, an as drawRainbowRule, ao as drawVignette, ap as flowNodeElementSchema, aq as inferLayout, ar as inferSidecarPath, as as parseDesignSpec, at as parseDiagramSpec, au as renderDesign, av as resolveTheme, aw as writeRenderArtifacts } from './spec.schema-De-IkUjn.js';
+import { T as ThemeInput, D as DesignSpec, a as Rect$1, b as DrawCommand, c as Theme, d as RenderedElement, A as AnchorHint, C as ConnectionElement } from './spec.schema-BY5MjmA8.js';
+export { e as AutoLayoutConfig, B as BuiltInTheme, f as CardElement, g as CodeBlockElement, h as ConstraintSpec, i as DEFAULT_GENERATOR_VERSION, j as DEFAULT_RAINBOW_COLORS, k as Decorator, l as DesignCardSpec, m as DesignSafeFrame, n as DesignTheme, o as DiagramElement, p as DiagramLayout, q as DiagramSpec, r as DrawArc, s as DrawBadge, t as DrawBezier, u as DrawCircle, v as DrawFontFamily, w as DrawGradientRect, x as DrawLine, y as DrawPath, z as DrawPoint, E as DrawRect, F as DrawShadow, G as DrawText, H as DrawTextRow, I as DrawTextRowSegment, J as Element, K as EllipseLayoutConfig, L as FlowNodeElement, M as Gradient, N as GradientOverlayDecorator, O as GradientSpec, P as GradientStop, Q as GraphSpec, S as GridLayoutConfig, U as ImageElement, V as IterationMeta, W as LayoutConfig, X as LayoutSnapshot, Y as ManualLayoutConfig, Z as RainbowRuleDecorator, _ as RenderDesignOptions, R as RenderMetadata, $ as RenderResult, a0 as ShapeElement, a1 as StackLayoutConfig, a2 as TerminalElement, a3 as TextElement, a4 as ThemeInput, a5 as VignetteDecorator, a6 as WrittenArtifacts, a7 as builtInThemeBackgrounds, a8 as builtInThemes, a9 as computeSpecHash, aa as connectionElementSchema, ab as defaultAutoLayout, ac as defaultCanvas, ad as defaultConstraints, ae as defaultGridLayout, af as defaultLayout, ag as defaultStackLayout, ah as defaultTheme, ai as deriveSafeFrame, aj as designSpecSchema, ak as diagramElementSchema, al as diagramLayoutSchema, am as diagramSpecSchema, an as drawGradientRect, ao as drawRainbowRule, ap as drawVignette, aq as flowNodeElementSchema, ar as graphSpecSchema, as as graphSpecToDesignSpec, at as inferLayout, au as inferSidecarPath, av as parseDesignSpec, aw as parseDiagramSpec, ax as parseSpecInput, ay as renderDesign, az as resolveTheme, aA as writeRenderArtifacts } from './spec.schema-BY5MjmA8.js';
 import { SKRSContext2D } from '@napi-rs/canvas';
 export { QaIssue, QaReferenceResult, QaReport, QaSeverity, readMetadata, runQa } from './qa.js';
 import { Highlighter } from 'shiki';

package/dist/index.js

@@ -1391,6 +1391,60 @@ function parseDiagramSpec(input) {
 function parseDesignSpec(input) {
   return designSpecSchema.parse(input);
 }
+var graphNodeSchema = z2.object({
+  id: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200),
+  shape: z2.enum([
+    "box",
+    "rounded-box",
+    "diamond",
+    "circle",
+    "pill",
+    "cylinder",
+    "parallelogram",
+    "hexagon"
+  ]).optional()
+}).strict();
+var graphEdgeSchema = z2.object({
+  from: z2.string().min(1).max(120),
+  to: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200).optional()
+}).strict();
+var graphSpecSchema = z2.object({
+  nodes: z2.array(graphNodeSchema).min(1),
+  edges: z2.array(graphEdgeSchema).default([])
+}).strict();
+function isGraphSpecInput(input) {
+  return typeof input === "object" && input !== null && "nodes" in input;
+}
+function graphSpecToDesignSpec(graph) {
+  const elements = [
+    ...graph.nodes.map((n) => ({
+      type: "flow-node",
+      id: n.id,
+      label: n.label,
+      ...n.shape ? { shape: n.shape } : {}
+    })),
+    ...graph.edges.map((e) => ({
+      type: "connection",
+      from: e.from,
+      to: e.to,
+      ...e.label ? { label: e.label } : {}
+    }))
+  ];
+  return designSpecSchema.parse({
+    version: 2,
+    elements,
+    layout: { mode: "auto", algorithm: "layered", direction: "TB" }
+  });
+}
+function parseSpecInput(input) {
+  if (isGraphSpecInput(input)) {
+    const graph = graphSpecSchema.parse(input);
+    return graphSpecToDesignSpec(graph);
+  }
+  return designSpecSchema.parse(input);
+}
 
 // src/qa.ts
 function rectWithin(outer, inner) {
@@ -6065,11 +6119,89 @@ async function runRenderPipeline(spec, options) {
     }
   };
 }
+var renderOptions = z3.object({
+  spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
+  out: z3.string().optional().describe("Output file path (.png) or output directory"),
+  output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
+  specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
+  iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
+  iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
+  maxIterations: z3.number().int().positive().optional().describe("Optional maximum planned iteration count"),
+  previousHash: z3.string().optional().describe("Optional artifact hash from the previous iteration"),
+  allowQaFail: z3.boolean().default(false).describe("Allow render success even if QA fails")
+});
+function resolveOut(options) {
+  const resolved = options.out ?? options.output;
+  if (!resolved) {
+    throw new Error("Either --out or --output is required.");
+  }
+  return resolved;
+}
 cli.command("render", {
   description: "Render a deterministic design artifact from a DesignSpec JSON file.",
+  options: renderOptions,
+  output: renderOutputSchema,
+  examples: [
+    {
+      options: {
+        spec: "./specs/pipeline.json",
+        out: "./output"
+      },
+      description: "Render a design spec and write .png/.meta/.spec artifacts"
+    }
+  ],
+  async run(c) {
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let iteration;
+    try {
+      iteration = parseIterationMeta({
+        ...c.options.iteration != null ? { iteration: c.options.iteration } : {},
+        ...c.options.maxIterations != null ? { maxIterations: c.options.maxIterations } : {},
+        ...c.options.iterationNotes ? { iterationNotes: c.options.iterationNotes } : {},
+        ...c.options.previousHash ? { previousHash: c.options.previousHash } : {}
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "INVALID_ITERATION_OPTIONS",
+        message,
+        retryable: false
+      });
+    }
+    const runReport = await runRenderPipeline(spec, {
+      out,
+      ...c.options.specOut ? { specOut: c.options.specOut } : {},
+      ...iteration ? { iteration } : {}
+    });
+    if (!runReport.qa.pass && !c.options.allowQaFail) {
+      return c.error({
+        code: "QA_FAILED",
+        message: `Render completed but QA failed (${runReport.qa.issueCount} issues). Review qa output.`,
+        retryable: false
+      });
+    }
+    return c.ok(runReport);
+  }
+});
+cli.command("draw", {
+  description: "Alias for render. Render a deterministic design artifact from a DesignSpec JSON.",
+  args: z3.object({
+    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)')
+  }),
   options: z3.object({
-    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
-    out: z3.string().describe("Output file path (.png) or output directory"),
+    out: z3.string().optional().describe("Output file path (.png) or output directory"),
+    output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
     specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
     iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
     iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
@@ -6080,15 +6212,34 @@ cli.command("render", {
   output: renderOutputSchema,
   examples: [
     {
-      options: {
-        spec: "./specs/pipeline.json",
-        out: "./output"
-      },
-      description: "Render a design spec and write .png/.meta/.spec artifacts"
+      args: { spec: "/tmp/spec.json" },
+      options: { output: "/tmp/out" },
+      description: "Render a spec using the draw alias with --output"
     }
   ],
   async run(c) {
-    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    let spec;
+    try {
+      spec = parseSpecInput(await readJson(c.args.spec));
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "UNKNOWN",
+        message,
+        retryable: false
+      });
+    }
     let iteration;
     try {
       iteration = parseIterationMeta({
@@ -6106,7 +6257,7 @@ cli.command("render", {
       });
     }
     const runReport = await runRenderPipeline(spec, {
-      out: c.options.out,
+      out,
       ...c.options.specOut ? { specOut: c.options.specOut } : {},
       ...iteration ? { iteration } : {}
     });
@@ -6630,6 +6781,8 @@ export {
   edgeAnchor,
   ellipseRoute,
   flowNodeElementSchema,
+  graphSpecSchema,
+  graphSpecToDesignSpec,
   highlightCode,
   inferEllipseParams,
   inferLayout,
@@ -6640,6 +6793,7 @@ export {
   outwardNormal,
   parseDesignSpec,
   parseDiagramSpec,
+  parseSpecInput,
   publishToGist,
   publishToGitHub,
   readMetadata,

package/dist/qa.d.ts

@@ -1,4 +1,4 @@
-import { R as RenderMetadata, D as DesignSpec } from './spec.schema-De-IkUjn.js';
+import { R as RenderMetadata, D as DesignSpec } from './spec.schema-BY5MjmA8.js';
 import 'zod';
 import '@napi-rs/canvas';
 

package/dist/qa.js

@@ -1121,6 +1121,29 @@ function deriveSafeFrame(spec) {
 function parseDesignSpec(input) {
   return designSpecSchema.parse(input);
 }
+var graphNodeSchema = z2.object({
+  id: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200),
+  shape: z2.enum([
+    "box",
+    "rounded-box",
+    "diamond",
+    "circle",
+    "pill",
+    "cylinder",
+    "parallelogram",
+    "hexagon"
+  ]).optional()
+}).strict();
+var graphEdgeSchema = z2.object({
+  from: z2.string().min(1).max(120),
+  to: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200).optional()
+}).strict();
+var graphSpecSchema = z2.object({
+  nodes: z2.array(graphNodeSchema).min(1),
+  edges: z2.array(graphEdgeSchema).default([])
+}).strict();
 
 // src/qa.ts
 function rectWithin(outer, inner) {

package/dist/renderer.d.ts

@@ -1,3 +1,3 @@
-export { i as DEFAULT_GENERATOR_VERSION, U as IterationMeta, W as LayoutSnapshot, a as Rect, Z as RenderDesignOptions, R as RenderMetadata, _ as RenderResult, d as RenderedElement, a5 as WrittenArtifacts, a8 as computeSpecHash, ar as inferSidecarPath, au as renderDesign, aw as writeRenderArtifacts } from './spec.schema-De-IkUjn.js';
+export { i as DEFAULT_GENERATOR_VERSION, V as IterationMeta, X as LayoutSnapshot, a as Rect, _ as RenderDesignOptions, R as RenderMetadata, $ as RenderResult, d as RenderedElement, a6 as WrittenArtifacts, a9 as computeSpecHash, au as inferSidecarPath, ay as renderDesign, aA as writeRenderArtifacts } from './spec.schema-BY5MjmA8.js';
 import 'zod';
 import '@napi-rs/canvas';

package/dist/renderer.js

@@ -4477,6 +4477,29 @@ function deriveSafeFrame(spec) {
 function parseDesignSpec(input) {
   return designSpecSchema.parse(input);
 }
+var graphNodeSchema = z2.object({
+  id: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200),
+  shape: z2.enum([
+    "box",
+    "rounded-box",
+    "diamond",
+    "circle",
+    "pill",
+    "cylinder",
+    "parallelogram",
+    "hexagon"
+  ]).optional()
+}).strict();
+var graphEdgeSchema = z2.object({
+  from: z2.string().min(1).max(120),
+  to: z2.string().min(1).max(120),
+  label: z2.string().min(1).max(200).optional()
+}).strict();
+var graphSpecSchema = z2.object({
+  nodes: z2.array(graphNodeSchema).min(1),
+  edges: z2.array(graphEdgeSchema).default([])
+}).strict();
 
 // src/utils/hash.ts
 import { createHash } from "crypto";