@spectratools/graphic-designer-cli 0.6.0 → 0.7.1

package/dist/renderer.js

@@ -1151,12 +1151,12 @@ function withAlpha2(color, alpha) {
 }
 function drawGradientRect(ctx, rect, gradient, borderRadius = 0) {
   const fill = gradient.type === "linear" ? createLinearRectGradient(ctx, rect, gradient.angle ?? 180) : ctx.createRadialGradient(
-    rect.x + rect.width / 2,
-    rect.y + rect.height / 2,
-    0,
-    rect.x + rect.width / 2,
-    rect.y + rect.height / 2,
-    Math.max(rect.width, rect.height) / 2
+    gradient.cx ?? rect.x + rect.width / 2,
+    gradient.cy ?? rect.y + rect.height / 2,
+    gradient.innerRadius ?? 0,
+    gradient.cx ?? rect.x + rect.width / 2,
+    gradient.cy ?? rect.y + rect.height / 2,
+    gradient.outerRadius ?? Math.max(rect.width, rect.height) / 2
   );
   addGradientStops(fill, gradient.stops);
   ctx.save();
@@ -2009,21 +2009,61 @@ function edgeAnchor(bounds, target) {
   const t = absDx * hh > absDy * hw ? hw / absDx : hh / absDy;
   return { x: c.x + dx * t, y: c.y + dy * t };
 }
+function resolveAnchor(bounds, anchor, fallbackTarget) {
+  if (!anchor) return edgeAnchor(bounds, fallbackTarget);
+  if (typeof anchor === "string") {
+    const c2 = rectCenter(bounds);
+    switch (anchor) {
+      case "top":
+        return { x: c2.x, y: bounds.y };
+      case "bottom":
+        return { x: c2.x, y: bounds.y + bounds.height };
+      case "left":
+        return { x: bounds.x, y: c2.y };
+      case "right":
+        return { x: bounds.x + bounds.width, y: c2.y };
+      case "center":
+        return c2;
+    }
+  }
+  const c = rectCenter(bounds);
+  return {
+    x: c.x + anchor.x * (bounds.width / 2),
+    y: c.y + anchor.y * (bounds.height / 2)
+  };
+}
+function anchorNormal(anchor, point, diagramCenter) {
+  if (typeof anchor === "string") {
+    switch (anchor) {
+      case "top":
+        return { x: 0, y: -1 };
+      case "bottom":
+        return { x: 0, y: 1 };
+      case "left":
+        return { x: -1, y: 0 };
+      case "right":
+        return { x: 1, y: 0 };
+      case "center":
+        return outwardNormal(point, diagramCenter);
+    }
+  }
+  return outwardNormal(point, diagramCenter);
+}
 function outwardNormal(point, diagramCenter) {
   const dx = point.x - diagramCenter.x;
   const dy = point.y - diagramCenter.y;
   const len = Math.hypot(dx, dy) || 1;
   return { x: dx / len, y: dy / len };
 }
-function curveRoute(fromBounds, toBounds, diagramCenter, tension) {
+function curveRoute(fromBounds, toBounds, diagramCenter, tension, fromAnchor, toAnchor) {
   const fromCenter = rectCenter(fromBounds);
   const toCenter = rectCenter(toBounds);
-  const p0 = edgeAnchor(fromBounds, toCenter);
-  const p3 = edgeAnchor(toBounds, fromCenter);
+  const p0 = resolveAnchor(fromBounds, fromAnchor, toCenter);
+  const p3 = resolveAnchor(toBounds, toAnchor, fromCenter);
   const dist = Math.hypot(p3.x - p0.x, p3.y - p0.y);
   const offset = dist * tension;
-  const n0 = outwardNormal(p0, diagramCenter);
-  const n3 = outwardNormal(p3, diagramCenter);
+  const n0 = anchorNormal(fromAnchor, p0, diagramCenter);
+  const n3 = anchorNormal(toAnchor, p3, diagramCenter);
   const cp1 = { x: p0.x + n0.x * offset, y: p0.y + n0.y * offset };
   const cp2 = { x: p3.x + n3.x * offset, y: p3.y + n3.y * offset };
   return [p0, cp1, cp2, p3];
@@ -2037,11 +2077,11 @@ function localToWorld(origin, axisX, axisY, local) {
     y: origin.y + axisX.y * local.x + axisY.y * local.y
   };
 }
-function arcRoute(fromBounds, toBounds, diagramCenter, tension) {
+function arcRoute(fromBounds, toBounds, diagramCenter, tension, fromAnchor, toAnchor) {
   const fromCenter = rectCenter(fromBounds);
   const toCenter = rectCenter(toBounds);
-  const start = edgeAnchor(fromBounds, toCenter);
-  const end = edgeAnchor(toBounds, fromCenter);
+  const start = resolveAnchor(fromBounds, fromAnchor, toCenter);
+  const end = resolveAnchor(toBounds, toAnchor, fromCenter);
   const chord = { x: end.x - start.x, y: end.y - start.y };
   const chordLength = Math.hypot(chord.x, chord.y);
   if (chordLength < 1e-6) {
@@ -2079,11 +2119,11 @@ function arcRoute(fromBounds, toBounds, diagramCenter, tension) {
     [pMid, cp3, cp4, p3]
   ];
 }
-function orthogonalRoute(fromBounds, toBounds) {
+function orthogonalRoute(fromBounds, toBounds, fromAnchor, toAnchor) {
   const fromC = rectCenter(fromBounds);
   const toC = rectCenter(toBounds);
-  const p0 = edgeAnchor(fromBounds, toC);
-  const p3 = edgeAnchor(toBounds, fromC);
+  const p0 = resolveAnchor(fromBounds, fromAnchor, toC);
+  const p3 = resolveAnchor(toBounds, toAnchor, fromC);
   const midX = (p0.x + p3.x) / 2;
   return [p0, { x: midX, y: p0.y }, { x: midX, y: p3.y }, p3];
 }
@@ -2094,6 +2134,35 @@ function bezierPointAt(p0, cp1, cp2, p3, t) {
     y: mt * mt * mt * p0.y + 3 * mt * mt * t * cp1.y + 3 * mt * t * t * cp2.y + t * t * t * p3.y
   };
 }
+function bezierTangentAt(p0, cp1, cp2, p3, t) {
+  const mt = 1 - t;
+  return {
+    x: 3 * mt * mt * (cp1.x - p0.x) + 6 * mt * t * (cp2.x - cp1.x) + 3 * t * t * (p3.x - cp2.x),
+    y: 3 * mt * mt * (cp1.y - p0.y) + 6 * mt * t * (cp2.y - cp1.y) + 3 * t * t * (p3.y - cp2.y)
+  };
+}
+function isInsideRect(point, rect) {
+  return point.x >= rect.x && point.x <= rect.x + rect.width && point.y >= rect.y && point.y <= rect.y + rect.height;
+}
+function findBoundaryIntersection(p0, cp1, cp2, p3, targetRect, searchFromEnd) {
+  const step = 5e-3;
+  if (searchFromEnd) {
+    for (let t = 0.95; t >= 0.5; t -= step) {
+      const pt = bezierPointAt(p0, cp1, cp2, p3, t);
+      if (!isInsideRect(pt, targetRect)) {
+        return t;
+      }
+    }
+  } else {
+    for (let t = 0.05; t <= 0.5; t += step) {
+      const pt = bezierPointAt(p0, cp1, cp2, p3, t);
+      if (!isInsideRect(pt, targetRect)) {
+        return t;
+      }
+    }
+  }
+  return void 0;
+}
 function pointAlongArc(route, t) {
   const [first, second] = route;
   if (t <= 0.5) {
@@ -2221,8 +2290,16 @@ function renderConnection(ctx, conn, fromBounds, toBounds, theme, edgeRoute, opt
   let labelPoint;
   ctx.save();
   ctx.globalAlpha = conn.opacity;
+  const arrowPlacement = conn.arrowPlacement ?? "endpoint";
   if (routing === "curve") {
-    const [p0, cp1, cp2, p3] = curveRoute(fromBounds, toBounds, diagramCenter, tension);
+    const [p0, cp1, cp2, p3] = curveRoute(
+      fromBounds,
+      toBounds,
+      diagramCenter,
+      tension,
+      conn.fromAnchor,
+      conn.toAnchor
+    );
     ctx.strokeStyle = style.color;
     ctx.lineWidth = style.width;
     ctx.setLineDash(style.dash ?? []);
@@ -2236,8 +2313,33 @@ function renderConnection(ctx, conn, fromBounds, toBounds, theme, edgeRoute, opt
     startAngle = Math.atan2(p0.y - cp1.y, p0.x - cp1.x);
     endAngle = Math.atan2(p3.y - cp2.y, p3.x - cp2.x);
     labelPoint = bezierPointAt(p0, cp1, cp2, p3, labelT);
+    if (arrowPlacement === "boundary") {
+      if (conn.arrow === "end" || conn.arrow === "both") {
+        const tEnd = findBoundaryIntersection(p0, cp1, cp2, p3, toBounds, true);
+        if (tEnd !== void 0) {
+          endPoint = bezierPointAt(p0, cp1, cp2, p3, tEnd);
+          const tangent = bezierTangentAt(p0, cp1, cp2, p3, tEnd);
+          endAngle = Math.atan2(tangent.y, tangent.x);
+        }
+      }
+      if (conn.arrow === "start" || conn.arrow === "both") {
+        const tStart = findBoundaryIntersection(p0, cp1, cp2, p3, fromBounds, false);
+        if (tStart !== void 0) {
+          startPoint = bezierPointAt(p0, cp1, cp2, p3, tStart);
+          const tangent = bezierTangentAt(p0, cp1, cp2, p3, tStart);
+          startAngle = Math.atan2(tangent.y, tangent.x) + Math.PI;
+        }
+      }
+    }
   } else if (routing === "arc") {
-    const [first, second] = arcRoute(fromBounds, toBounds, diagramCenter, tension);
+    const [first, second] = arcRoute(
+      fromBounds,
+      toBounds,
+      diagramCenter,
+      tension,
+      conn.fromAnchor,
+      conn.toAnchor
+    );
     const [p0, cp1, cp2, pMid] = first;
     const [, cp3, cp4, p3] = second;
     ctx.strokeStyle = style.color;
@@ -2254,9 +2356,29 @@ function renderConnection(ctx, conn, fromBounds, toBounds, theme, edgeRoute, opt
     startAngle = Math.atan2(p0.y - cp1.y, p0.x - cp1.x);
     endAngle = Math.atan2(p3.y - cp4.y, p3.x - cp4.x);
     labelPoint = pointAlongArc([first, second], labelT);
+    if (arrowPlacement === "boundary") {
+      if (conn.arrow === "end" || conn.arrow === "both") {
+        const [, s_cp3, s_cp4, s_p3] = second;
+        const tEnd = findBoundaryIntersection(pMid, s_cp3, s_cp4, s_p3, toBounds, true);
+        if (tEnd !== void 0) {
+          endPoint = bezierPointAt(pMid, s_cp3, s_cp4, s_p3, tEnd);
+          const tangent = bezierTangentAt(pMid, s_cp3, s_cp4, s_p3, tEnd);
+          endAngle = Math.atan2(tangent.y, tangent.x);
+        }
+      }
+      if (conn.arrow === "start" || conn.arrow === "both") {
+        const tStart = findBoundaryIntersection(p0, cp1, cp2, pMid, fromBounds, false);
+        if (tStart !== void 0) {
+          startPoint = bezierPointAt(p0, cp1, cp2, pMid, tStart);
+          const tangent = bezierTangentAt(p0, cp1, cp2, pMid, tStart);
+          startAngle = Math.atan2(tangent.y, tangent.x) + Math.PI;
+        }
+      }
+    }
   } else {
-    const useElkRoute = routing === "auto" && (edgeRoute?.points.length ?? 0) >= 2;
-    linePoints = useElkRoute ? edgeRoute?.points ?? orthogonalRoute(fromBounds, toBounds) : orthogonalRoute(fromBounds, toBounds);
+    const hasAnchorHints = conn.fromAnchor !== void 0 || conn.toAnchor !== void 0;
+    const useElkRoute = routing === "auto" && !hasAnchorHints && (edgeRoute?.points.length ?? 0) >= 2;
+    linePoints = useElkRoute ? edgeRoute?.points ?? orthogonalRoute(fromBounds, toBounds, conn.fromAnchor, conn.toAnchor) : orthogonalRoute(fromBounds, toBounds, conn.fromAnchor, conn.toAnchor);
     startPoint = linePoints[0];
     const startSegment = linePoints[1] ?? linePoints[0];
     const endStart = linePoints[linePoints.length - 2] ?? linePoints[0];
@@ -2488,6 +2610,13 @@ function expandRect(rect, amount) {
     height: rect.height + amount * 2
   };
 }
+function applyDrawShadow(ctx, shadow) {
+  if (!shadow) return;
+  ctx.shadowColor = shadow.color;
+  ctx.shadowBlur = shadow.blur;
+  ctx.shadowOffsetX = shadow.offsetX;
+  ctx.shadowOffsetY = shadow.offsetY;
+}
 function fromPoints(points) {
   const minX = Math.min(...points.map((point) => point.x));
   const minY = Math.min(...points.map((point) => point.y));
@@ -2669,6 +2798,7 @@ function renderDrawCommands(ctx, commands, theme) {
           height: command.height
         };
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           roundRectPath(ctx, rect, command.radius);
           if (command.fill) {
             ctx.fillStyle = command.fill;
@@ -2692,6 +2822,7 @@ function renderDrawCommands(ctx, commands, theme) {
       }
       case "circle": {
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           ctx.beginPath();
           ctx.arc(command.cx, command.cy, command.radius, 0, Math.PI * 2);
           ctx.closePath();
@@ -2726,6 +2857,7 @@ function renderDrawCommands(ctx, commands, theme) {
       case "text": {
         const fontFamily = resolveDrawFont(theme, command.fontFamily);
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           applyFont(ctx, {
             size: command.fontSize,
             weight: command.fontWeight,
@@ -2776,6 +2908,7 @@ function renderDrawCommands(ctx, commands, theme) {
         const to = { x: command.x2, y: command.y2 };
         const lineAngle = angleBetween(from, to);
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           drawLine(ctx, from, to, {
             color: command.color,
             width: command.width,
@@ -2800,6 +2933,7 @@ function renderDrawCommands(ctx, commands, theme) {
       case "bezier": {
         const points = command.points;
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           drawBezier(ctx, points, {
             color: command.color,
             width: command.width,
@@ -2833,6 +2967,7 @@ function renderDrawCommands(ctx, commands, theme) {
         const operations = parseSvgPath(command.d);
         const baseBounds = pathBounds(operations);
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           applySvgOperations(ctx, operations);
           if (command.fill) {
             ctx.fillStyle = command.fill;
@@ -2873,9 +3008,16 @@ function renderDrawCommands(ctx, commands, theme) {
           height: textHeight + command.paddingY * 2
         };
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           roundRectPath(ctx, rect, command.borderRadius);
           ctx.fillStyle = command.background;
           ctx.fill();
+          if (command.shadow) {
+            ctx.shadowColor = "transparent";
+            ctx.shadowBlur = 0;
+            ctx.shadowOffsetX = 0;
+            ctx.shadowOffsetY = 0;
+          }
           applyFont(ctx, {
             size: command.fontSize,
             weight: 600,
@@ -2903,6 +3045,7 @@ function renderDrawCommands(ctx, commands, theme) {
           height: command.height
         };
         withOpacity(ctx, command.opacity, () => {
+          applyDrawShadow(ctx, command.shadow);
           drawGradientRect(ctx, rect, command.gradient, command.radius);
         });
         rendered.push({
@@ -2913,6 +3056,36 @@ function renderDrawCommands(ctx, commands, theme) {
         });
         break;
       }
+      case "grid": {
+        const canvasWidth = ctx.canvas.width;
+        const canvasHeight = ctx.canvas.height;
+        withOpacity(ctx, command.opacity, () => {
+          ctx.strokeStyle = command.color;
+          ctx.lineWidth = command.width;
+          const startX = command.offsetX % command.spacing;
+          for (let x = startX; x <= canvasWidth; x += command.spacing) {
+            ctx.beginPath();
+            ctx.moveTo(x, 0);
+            ctx.lineTo(x, canvasHeight);
+            ctx.stroke();
+          }
+          const startY = command.offsetY % command.spacing;
+          for (let y = startY; y <= canvasHeight; y += command.spacing) {
+            ctx.beginPath();
+            ctx.moveTo(0, y);
+            ctx.lineTo(canvasWidth, y);
+            ctx.stroke();
+          }
+        });
+        rendered.push({
+          id,
+          kind: "draw",
+          bounds: { x: 0, y: 0, width: canvasWidth, height: canvasHeight },
+          foregroundColor: command.color,
+          allowOverlap: true
+        });
+        break;
+      }
     }
   }
   return rendered;
@@ -3194,9 +3367,19 @@ var linearGradientSchema = z2.object({
 }).strict();
 var radialGradientSchema = z2.object({
   type: z2.literal("radial"),
+  cx: z2.number().optional(),
+  cy: z2.number().optional(),
+  innerRadius: z2.number().min(0).optional(),
+  outerRadius: z2.number().min(0).optional(),
   stops: z2.array(gradientStopSchema).min(2)
 }).strict();
 var gradientSchema = z2.discriminatedUnion("type", [linearGradientSchema, radialGradientSchema]);
+var drawShadowSchema = z2.object({
+  color: colorHexSchema2.default("rgba(0,0,0,0.5)"),
+  blur: z2.number().min(0).max(64).default(10),
+  offsetX: z2.number().default(0),
+  offsetY: z2.number().default(4)
+}).strict();
 var drawFontFamilySchema = z2.enum(["heading", "body", "mono"]);
 var drawRectSchema = z2.object({
   type: z2.literal("rect"),
@@ -3208,7 +3391,8 @@ var drawRectSchema = z2.object({
   stroke: colorHexSchema2.optional(),
   strokeWidth: z2.number().min(0).max(32).default(0),
   radius: z2.number().min(0).max(256).default(0),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawCircleSchema = z2.object({
   type: z2.literal("circle"),
@@ -3218,7 +3402,8 @@ var drawCircleSchema = z2.object({
   fill: colorHexSchema2.optional(),
   stroke: colorHexSchema2.optional(),
   strokeWidth: z2.number().min(0).max(32).default(0),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawTextSchema = z2.object({
   type: z2.literal("text"),
@@ -3233,7 +3418,8 @@ var drawTextSchema = z2.object({
   baseline: z2.enum(["top", "middle", "alphabetic", "bottom"]).default("alphabetic"),
   letterSpacing: z2.number().min(-10).max(50).default(0),
   maxWidth: z2.number().positive().optional(),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawLineSchema = z2.object({
   type: z2.literal("line"),
@@ -3246,7 +3432,8 @@ var drawLineSchema = z2.object({
   dash: z2.array(z2.number()).max(6).optional(),
   arrow: z2.enum(["none", "end", "start", "both"]).default("none"),
   arrowSize: z2.number().min(4).max(32).default(10),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawPointSchema = z2.object({
   x: z2.number(),
@@ -3260,7 +3447,8 @@ var drawBezierSchema = z2.object({
   dash: z2.array(z2.number()).max(6).optional(),
   arrow: z2.enum(["none", "end", "start", "both"]).default("none"),
   arrowSize: z2.number().min(4).max(32).default(10),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawPathSchema = z2.object({
   type: z2.literal("path"),
@@ -3268,7 +3456,8 @@ var drawPathSchema = z2.object({
   fill: colorHexSchema2.optional(),
   stroke: colorHexSchema2.optional(),
   strokeWidth: z2.number().min(0).max(32).default(0),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawBadgeSchema = z2.object({
   type: z2.literal("badge"),
@@ -3282,7 +3471,8 @@ var drawBadgeSchema = z2.object({
   paddingX: z2.number().min(0).max(64).default(10),
   paddingY: z2.number().min(0).max(32).default(4),
   borderRadius: z2.number().min(0).max(64).default(12),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
 }).strict();
 var drawGradientRectSchema = z2.object({
   type: z2.literal("gradient-rect"),
@@ -3292,7 +3482,17 @@ var drawGradientRectSchema = z2.object({
   height: z2.number().positive(),
   gradient: gradientSchema,
   radius: z2.number().min(0).max(256).default(0),
-  opacity: z2.number().min(0).max(1).default(1)
+  opacity: z2.number().min(0).max(1).default(1),
+  shadow: drawShadowSchema.optional()
+}).strict();
+var drawGridSchema = z2.object({
+  type: z2.literal("grid"),
+  spacing: z2.number().min(5).max(200).default(40),
+  color: colorHexSchema2.default("#1E2D4A"),
+  width: z2.number().min(0.1).max(4).default(0.5),
+  opacity: z2.number().min(0).max(1).default(0.2),
+  offsetX: z2.number().default(0),
+  offsetY: z2.number().default(0)
 }).strict();
 var drawCommandSchema = z2.discriminatedUnion("type", [
   drawRectSchema,
@@ -3302,7 +3502,8 @@ var drawCommandSchema = z2.discriminatedUnion("type", [
   drawBezierSchema,
   drawPathSchema,
   drawBadgeSchema,
-  drawGradientRectSchema
+  drawGradientRectSchema,
+  drawGridSchema
 ]);
 var defaultCanvas = {
   width: 1200,
@@ -3408,6 +3609,13 @@ var flowNodeElementSchema = z2.object({
   badgePosition: z2.enum(["top", "inside-top"]).default("inside-top"),
   shadow: flowNodeShadowSchema.optional()
 }).strict();
+var anchorHintSchema = z2.union([
+  z2.enum(["top", "bottom", "left", "right", "center"]),
+  z2.object({
+    x: z2.number().min(-1).max(1),
+    y: z2.number().min(-1).max(1)
+  }).strict()
+]);
 var connectionElementSchema = z2.object({
   type: z2.literal("connection"),
   from: z2.string().min(1).max(120),
@@ -3421,9 +3629,12 @@ var connectionElementSchema = z2.object({
   width: z2.number().min(0.5).max(10).optional(),
   strokeWidth: z2.number().min(0.5).max(10).default(2),
   arrowSize: z2.number().min(4).max(32).optional(),
+  arrowPlacement: z2.enum(["endpoint", "boundary"]).default("endpoint"),
   opacity: z2.number().min(0).max(1).default(1),
   routing: z2.enum(["auto", "orthogonal", "curve", "arc"]).default("auto"),
-  tension: z2.number().min(0.1).max(0.8).default(0.35)
+  tension: z2.number().min(0.1).max(0.8).default(0.35),
+  fromAnchor: anchorHintSchema.optional(),
+  toAnchor: anchorHintSchema.optional()
 }).strict();
 var codeBlockStyleSchema = z2.object({
   paddingVertical: z2.number().min(0).max(128).default(56),