circuit-to-canvas 0.0.50 → 0.0.52

package/lib/drawer/elements/pcb-soldermask/via.ts

@@ -0,0 +1,27 @@
+import type { PcbVia } from "circuit-json"
+import type { Matrix } from "transformation-matrix"
+import { applyToPoint } from "transformation-matrix"
+import type { CanvasContext, PcbColorMap } from "../../types"
+
+/**
+ * Process soldermask for a via.
+ * Vias typically have soldermask openings to expose the copper ring.
+ */
+export function processViaSoldermask(params: {
+  ctx: CanvasContext
+  via: PcbVia
+  realToCanvasMat: Matrix
+  colorMap: PcbColorMap
+}): void {
+  const { ctx, via, realToCanvasMat, colorMap } = params
+  // Vias typically have soldermask openings to expose the copper ring
+  // Draw substrate color to simulate the cutout
+  const [cx, cy] = applyToPoint(realToCanvasMat, [via.x, via.y])
+  const scaledRadius = (via.outer_diameter / 2) * Math.abs(realToCanvasMat.a)
+
+  ctx.fillStyle = colorMap.substrate
+  ctx.beginPath()
+  ctx.arc(cx, cy, scaledRadius, 0, Math.PI * 2)
+  ctx.closePath()
+  ctx.fill()
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "circuit-to-canvas",
   "main": "dist/index.js",
-  "version": "0.0.50",
+  "version": "0.0.52",
   "type": "module",
   "scripts": {
     "build": "tsup-node ./lib/index.ts --format esm --dts",

package/tests/board-snapshot/usb-c-flashlight-board.test.ts

@@ -9,6 +9,7 @@ test("USB-C flashlight - comprehensive comparison (circuit-to-canvas vs circuit-
   const stackedPng = await getStackedPngSvgComparison(circuitElements, {
     width: 400,
     height: 800,
+    drawSoldermask: true,
   })
 
   await expect(stackedPng).toMatchPngSnapshot(import.meta.path)

package/tests/elements/pcb-board.test.ts

@@ -22,7 +22,7 @@ test("draw rectangular board", async () => {
     material: "fr4",
   }
 
-  drawer.drawElements([board])
+  drawer.drawElements([board], { drawBoardMaterial: true })
 
   await expect(canvas.toBuffer("image/png")).toMatchPngSnapshot(
     import.meta.path,
@@ -57,7 +57,7 @@ test("draw board with custom outline", async () => {
     ],
   }
 
-  drawer.drawElements([board])
+  drawer.drawElements([board], { drawBoardMaterial: true })
 
   await expect(canvas.toBuffer("image/png")).toMatchPngSnapshot(
     import.meta.path,

package/tests/elements/pcb-comprehensive-soldermask-margin.test.ts

@@ -1,7 +1,7 @@
 import { expect, test } from "bun:test"
 import { createCanvas } from "@napi-rs/canvas"
-import { CircuitToCanvasDrawer } from "../../lib/drawer"
 import type { AnyCircuitElement } from "circuit-json"
+import { CircuitToCanvasDrawer } from "../../lib/drawer"
 
 /**
  * Comprehensive test for soldermask margin functionality:
@@ -1273,7 +1273,7 @@ test("comprehensive soldermask margin test", async () => {
   ]
 
   drawer.setCameraBounds({ minX: -95, maxX: 90, minY: -22, maxY: 22 })
-  drawer.drawElements(circuit)
+  drawer.drawElements(circuit, { drawSoldermask: true })
 
   await expect(canvas.toBuffer("image/png")).toMatchPngSnapshot(
     import.meta.path,

package/tests/elements/pcb-hole-soldermask-margin.test.ts

@@ -2,7 +2,7 @@ import { expect, test } from "bun:test"
 import { createCanvas } from "@napi-rs/canvas"
 import { CircuitToCanvasDrawer } from "../../lib/drawer"
 
-test("draw holes with positive soldermask margins", async () => {
+test("draw holes with positive and negative soldermask margins", async () => {
   const canvas = createCanvas(800, 600)
   const ctx = canvas.getContext("2d")
   const drawer = new CircuitToCanvasDrawer(ctx)
@@ -29,6 +29,122 @@ test("draw holes with positive soldermask margins", async () => {
 
       soldermask_margin: 0.2,
     },
+    // Circle with negative margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_circle_negative",
+      hole_shape: "circle",
+      x: -4,
+      y: -2,
+      hole_diameter: 1.0,
+
+      soldermask_margin: -0.15,
+    },
+    // Square with positive margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_square_positive",
+      hole_shape: "square",
+      x: -1,
+      y: 2,
+      hole_diameter: 1.0,
+
+      soldermask_margin: 0.15,
+    },
+    // Square with negative margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_square_negative",
+      hole_shape: "square",
+      x: -1,
+      y: -2,
+      hole_diameter: 1.0,
+
+      soldermask_margin: -0.1,
+    },
+    // Oval with positive margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_oval_positive",
+      hole_shape: "oval",
+      x: 2,
+      y: 2,
+      hole_width: 1.5,
+      hole_height: 0.8,
+
+      soldermask_margin: 0.1,
+    },
+    // Oval with negative margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_oval_negative",
+      hole_shape: "oval",
+      x: 2,
+      y: -2,
+      hole_width: 1.5,
+      hole_height: 0.8,
+
+      soldermask_margin: -0.12,
+    },
+    // Rect with positive margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_rect_positive",
+      hole_shape: "rect",
+      x: 5,
+      y: 2,
+      hole_width: 1.5,
+      hole_height: 0.8,
+
+      soldermask_margin: 0.15,
+    },
+    // Pill with positive margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_pill_positive",
+      hole_shape: "pill",
+      x: -2.5,
+      y: 0,
+      hole_width: 1.5,
+      hole_height: 0.8,
+
+      soldermask_margin: 0.1,
+    },
+    // Pill with negative margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_pill_negative",
+      hole_shape: "pill",
+      x: -2.5,
+      y: -4,
+      hole_width: 1.5,
+      hole_height: 0.8,
+
+      soldermask_margin: -0.08,
+    },
+    // Pill with negative margin
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_pill_negative",
+      hole_shape: "pill",
+      x: -2.5,
+      y: -4,
+      hole_width: 1.5,
+      hole_height: 0.8,
+
+      soldermask_margin: -0.08,
+    },
+    // Circle with positive margin (mask extends beyond hole)
+    {
+      type: "pcb_hole",
+      pcb_hole_id: "hole_circle_positive",
+      hole_shape: "circle",
+      x: -4,
+      y: 2,
+      hole_diameter: 1.0,
+
+      soldermask_margin: 0.2,
+    },
     // Square with positive margin
     {
       type: "pcb_hole",
@@ -122,10 +238,47 @@ test("draw holes with positive soldermask margins", async () => {
       text: "+0.1mm",
       font_size: 0.4,
     },
+    // Labels for negative margin holes (bottom row)
+    {
+      type: "pcb_silkscreen_text",
+      pcb_silkscreen_text_id: "text_circle_neg",
+      layer: "top",
+      anchor_position: { x: -4, y: -0.8 },
+      anchor_alignment: "center",
+      text: "-0.15mm",
+      font_size: 0.4,
+    },
+    {
+      type: "pcb_silkscreen_text",
+      pcb_silkscreen_text_id: "text_square_neg",
+      layer: "top",
+      anchor_position: { x: -1, y: -0.8 },
+      anchor_alignment: "center",
+      text: "-0.1mm",
+      font_size: 0.4,
+    },
+    {
+      type: "pcb_silkscreen_text",
+      pcb_silkscreen_text_id: "text_oval_neg",
+      layer: "top",
+      anchor_position: { x: 2, y: -0.8 },
+      anchor_alignment: "center",
+      text: "-0.12mm",
+      font_size: 0.4,
+    },
+    {
+      type: "pcb_silkscreen_text",
+      pcb_silkscreen_text_id: "text_pill_neg",
+      layer: "top",
+      anchor_position: { x: -2.5, y: -2.8 },
+      anchor_alignment: "center",
+      text: "-0.08mm",
+      font_size: 0.4,
+    },
   ]
 
   drawer.setCameraBounds({ minX: -7, maxX: 7, minY: -5, maxY: 5 })
-  drawer.drawElements(circuit)
+  drawer.drawElements(circuit, { drawSoldermask: true })
 
   await expect(canvas.toBuffer("image/png")).toMatchPngSnapshot(
     import.meta.path,

package/tests/elements/pcb-keepout-with-group-id.test.ts

@@ -37,7 +37,7 @@ test("pcb keepout with pcb_group_id and subcircuit_id", async () => {
     },
   ]
 
-  drawer.drawElements(elements)
+  drawer.drawElements(elements, { drawBoardMaterial: true })
 
   await expect(canvas.toBuffer("image/png")).toMatchPngSnapshot(
     import.meta.path,