circuit-to-svg 0.0.280 → 0.0.282

package/dist/index.js

@@ -1582,7 +1582,8 @@ import { applyToPoint as applyToPoint12 } from "transformation-matrix";
 function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
   const { transform, colorMap: colorMap2, showSolderMask } = ctx;
   const [x, y] = applyToPoint12(transform, [hole.x, hole.y]);
-  const copperLayer = Array.isArray(hole.layers) && hole.layers[0] || hole.layer || "top";
+  const layer = Array.isArray(hole.layers) && hole.layers[0] || hole.layer || "top";
+  const maskLayer = layer;
   const isCoveredWithSolderMask = Boolean(hole.is_covered_with_solder_mask);
   const soldermaskMargin = (hole.soldermask_margin ?? 0) * Math.abs(transform.a);
   const shouldShowSolderMask = showSolderMask && isCoveredWithSolderMask && soldermaskMargin !== 0;
@@ -1620,7 +1621,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
           d: createPillPath(scaledOuterWidth, scaledOuterHeight),
           transform: outerTransform,
           "data-type": "pcb_plated_hole",
-          "data-pcb-layer": copperLayer
+          "data-pcb-layer": layer
         },
         value: "",
         children: []
@@ -1656,7 +1657,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               d: createPillPath(scaledOuterWidth, scaledOuterHeight),
               transform: outerTransform,
               "data-type": "pcb_plated_hole",
-              "data-pcb-layer": copperLayer
+              "data-pcb-layer": layer
             },
             value: "",
             children: []
@@ -1670,7 +1671,8 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               fill: colorMap2.copper.top,
               d: createPillPath(maskWidth, maskHeight),
               transform: outerTransform,
-              "data-type": "pcb_soldermask"
+              "data-type": "pcb_soldermask",
+              "data-pcb-layer": maskLayer
             },
             value: "",
             children: []
@@ -1689,7 +1691,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
             d: createPillPath(maskWidth, maskHeight),
             transform: outerTransform,
             "data-type": "pcb_soldermask_opening",
-            "data-pcb-layer": "soldermask-top"
+            "data-pcb-layer": maskLayer
           },
           value: "",
           children: []
@@ -1730,7 +1732,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
           ry: (scaledOuterHeight / 2).toString(),
           transform: transformStr,
           "data-type": "pcb_plated_hole",
-          "data-pcb-layer": copperLayer
+          "data-pcb-layer": layer
         },
         value: "",
         children: []
@@ -1785,7 +1787,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
           cy: y.toString(),
           r: outerRadius.toString(),
           "data-type": "pcb_plated_hole",
-          "data-pcb-layer": copperLayer
+          "data-pcb-layer": layer
         },
         value: "",
         children: []
@@ -1821,7 +1823,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               cy: y.toString(),
               r: outerRadius.toString(),
               "data-type": "pcb_plated_hole",
-              "data-pcb-layer": copperLayer
+              "data-pcb-layer": layer
             },
             value: "",
             children: []
@@ -1836,7 +1838,8 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               cx: x.toString(),
               cy: y.toString(),
               r: maskRadius.toString(),
-              "data-type": "pcb_soldermask"
+              "data-type": "pcb_soldermask",
+              "data-pcb-layer": maskLayer
             },
             value: "",
             children: []
@@ -1856,7 +1859,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
             cy: y.toString(),
             r: maskRadius.toString(),
             "data-type": "pcb_soldermask_opening",
-            "data-pcb-layer": "soldermask-top"
+            "data-pcb-layer": maskLayer
           },
           value: "",
           children: []
@@ -1904,7 +1907,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
             ry: scaledRectBorderRadius.toString()
           } : {},
           "data-type": "pcb_plated_hole",
-          "data-pcb-layer": copperLayer
+          "data-pcb-layer": layer
         },
         value: "",
         children: []
@@ -1948,7 +1951,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
                 ry: scaledRectBorderRadius.toString()
               } : {},
               "data-type": "pcb_plated_hole",
-              "data-pcb-layer": copperLayer
+              "data-pcb-layer": layer
             },
             value: "",
             children: []
@@ -1968,7 +1971,8 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
                 rx: maskBorderRadius.toString(),
                 ry: maskBorderRadius.toString()
               } : {},
-              "data-type": "pcb_soldermask"
+              "data-type": "pcb_soldermask",
+              "data-pcb-layer": maskLayer
             },
             value: "",
             children: []
@@ -1993,7 +1997,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               ry: maskBorderRadius.toString()
             } : {},
             "data-type": "pcb_soldermask_opening",
-            "data-pcb-layer": "soldermask-top"
+            "data-pcb-layer": maskLayer
           },
           value: "",
           children: []
@@ -2045,7 +2049,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
             ry: scaledRectBorderRadius.toString()
           } : {},
           "data-type": "pcb_plated_hole",
-          "data-pcb-layer": copperLayer
+          "data-pcb-layer": layer
         },
         value: "",
         children: []
@@ -2092,7 +2096,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
                 ry: scaledRectBorderRadius.toString()
               } : {},
               "data-type": "pcb_plated_hole",
-              "data-pcb-layer": copperLayer
+              "data-pcb-layer": layer
             },
             value: "",
             children: []
@@ -2112,7 +2116,8 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
                 rx: maskBorderRadius.toString(),
                 ry: maskBorderRadius.toString()
               } : {},
-              "data-type": "pcb_soldermask"
+              "data-type": "pcb_soldermask",
+              "data-pcb-layer": maskLayer
             },
             value: "",
             children: []
@@ -2137,7 +2142,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               ry: maskBorderRadius.toString()
             } : {},
             "data-type": "pcb_soldermask_opening",
-            "data-pcb-layer": "soldermask-top"
+            "data-pcb-layer": maskLayer
           },
           value: "",
           children: []
@@ -2189,7 +2194,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
             ry: scaledRectBorderRadius.toString()
           } : {},
           "data-type": "pcb_plated_hole",
-          "data-pcb-layer": copperLayer
+          "data-pcb-layer": layer
         },
         value: "",
         children: []
@@ -2237,7 +2242,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
                 ry: scaledRectBorderRadius.toString()
               } : {},
               "data-type": "pcb_plated_hole",
-              "data-pcb-layer": copperLayer
+              "data-pcb-layer": layer
             },
             value: "",
             children: []
@@ -2258,7 +2263,8 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
                 rx: maskBorderRadius.toString(),
                 ry: maskBorderRadius.toString()
               } : {},
-              "data-type": "pcb_soldermask"
+              "data-type": "pcb_soldermask",
+              "data-pcb-layer": maskLayer
             },
             value: "",
             children: []
@@ -2283,7 +2289,8 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               rx: maskBorderRadius.toString(),
               ry: maskBorderRadius.toString()
             } : {},
-            "data-type": "pcb_soldermask"
+            "data-type": "pcb_soldermask",
+            "data-pcb-layer": maskLayer
           },
           value: "",
           children: []
@@ -2408,7 +2415,7 @@ function createSvgObjectsFromPcbPlatedHole(hole, ctx) {
               fill: colorMap2.copper.top,
               points: padPointsString,
               "data-type": "pcb_plated_hole",
-              "data-pcb-layer": copperLayer
+              "data-pcb-layer": layer
             },
             value: "",
             children: []
@@ -2838,7 +2845,11 @@ var DEFAULT_PCB_COLOR_MAP = {
   },
   soldermask: {
     top: "rgb(12, 55, 33)",
-    bottom: "rgb(52, 87, 136)"
+    bottom: "rgb(12, 55, 33)"
+  },
+  soldermaskOverCopper: {
+    top: "rgb(52, 135, 73)",
+    bottom: "rgb(52, 135, 73)"
   },
   substrate: "rgb(201, 162, 110)",
   // FR4 substrate color (tan/beige)
@@ -2886,6 +2897,7 @@ function createSvgObjectsFromPcbTrace(trace, ctx) {
     const layer = "layer" in start ? start.layer : "layer" in end ? end.layer : null;
     if (!layer) continue;
     if (layerFilter && layer !== layerFilter) continue;
+    const maskLayer = layer;
     const copperColor = layerNameToColor(layer, colorMap2);
     const maskColor = colorMap2.soldermaskWithCopperUnderneath[layer];
     const traceWidth = "width" in start ? start.width : "width" in end ? end.width : null;
@@ -2941,7 +2953,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
   const { transform, layer: layerFilter, colorMap: colorMap2, showSolderMask } = ctx;
   if (layerFilter && pad.layer !== layerFilter) return [];
   const isCoveredWithSolderMask = Boolean(pad?.is_covered_with_solder_mask);
-  const shouldshowSolderMask = showSolderMask && isCoveredWithSolderMask;
+  const shouldShowSolderMask = showSolderMask && isCoveredWithSolderMask;
   const soldermaskWithCopperUnderneathColor = colorMap2.soldermaskWithCopperUnderneath[pad.layer] ?? colorMap2.soldermaskWithCopperUnderneath.top;
   const soldermaskMargin = (pad.soldermask_margin ?? 0) * Math.abs(transform.a);
   if (pad.shape === "rect" || pad.shape === "rotated_rect") {
@@ -2972,7 +2984,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
           } : {}
         }
       };
-      if (!shouldshowSolderMask) {
+      if (!shouldShowSolderMask) {
         return [padElement2];
       }
       const maskWidth2 = width + 2 * soldermaskMargin;
@@ -3065,7 +3077,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
             ry: maskBorderRadius2.toString()
           } : {},
           "data-type": "pcb_soldermask_opening",
-          "data-pcb-layer": `soldermask-${pad.layer}`
+          "data-pcb-layer": pad.layer
         }
       };
       return [substrateElement2, padElement2];
@@ -3090,7 +3102,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
         } : {}
       }
     };
-    if (!shouldshowSolderMask) {
+    if (!shouldShowSolderMask) {
       return [padElement];
     }
     const maskWidth = width + 2 * soldermaskMargin;
@@ -3179,35 +3191,40 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
           ry: maskBorderRadius.toString()
         } : {},
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": `soldermask-${pad.layer}`
+        "data-pcb-layer": pad.layer
       }
     };
     return [substrateElement, padElement];
   }
-  if (pad.shape === "pill") {
+  if (pad.shape === "pill" || pad.shape === "rotated_pill") {
+    const isRotated = pad.shape === "rotated_pill";
     const width = pad.width * Math.abs(transform.a);
     const height = pad.height * Math.abs(transform.d);
     const radius = pad.radius * Math.abs(transform.a);
     const [x, y] = applyToPoint20(transform, [pad.x, pad.y]);
+    const baseAttributes = {
+      class: "pcb-pad",
+      fill: layerNameToColor(pad.layer, colorMap2),
+      x: isRotated ? (-width / 2).toString() : (x - width / 2).toString(),
+      y: isRotated ? (-height / 2).toString() : (y - height / 2).toString(),
+      width: width.toString(),
+      height: height.toString(),
+      rx: radius.toString(),
+      ry: radius.toString(),
+      "data-type": "pcb_smtpad",
+      "data-pcb-layer": pad.layer,
+      ...isRotated ? {
+        transform: `translate(${x} ${y}) rotate(${-(pad.ccw_rotation ?? 0)})`
+      } : {}
+    };
     const padElement = {
       name: "rect",
       type: "element",
       value: "",
       children: [],
-      attributes: {
-        class: "pcb-pad",
-        fill: layerNameToColor(pad.layer, colorMap2),
-        x: (x - width / 2).toString(),
-        y: (y - height / 2).toString(),
-        width: width.toString(),
-        height: height.toString(),
-        rx: radius.toString(),
-        ry: radius.toString(),
-        "data-type": "pcb_smtpad",
-        "data-pcb-layer": pad.layer
-      }
+      attributes: baseAttributes
     };
-    if (!shouldshowSolderMask) {
+    if (!shouldShowSolderMask) {
       return [padElement];
     }
     const maskWidth = width + 2 * soldermaskMargin;
@@ -3232,23 +3249,25 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
           "data-pcb-layer": pad.layer
         }
       };
+      const exposedAttributes = {
+        class: "pcb-pad-exposed",
+        fill: layerNameToColor(pad.layer, colorMap2),
+        x: isRotated ? (-maskWidth / 2).toString() : (x - maskWidth / 2).toString(),
+        y: isRotated ? (-maskHeight / 2).toString() : (y - maskHeight / 2).toString(),
+        width: maskWidth.toString(),
+        height: maskHeight.toString(),
+        rx: maskRadius.toString(),
+        ry: maskRadius.toString(),
+        "data-type": "pcb_soldermask",
+        "data-pcb-layer": pad.layer,
+        ...isRotated && pad.ccw_rotation ? { transform: `translate(${x} ${y}) rotate(${-pad.ccw_rotation})` } : {}
+      };
       const exposedOpeningElement = {
         name: "rect",
         type: "element",
         value: "",
         children: [],
-        attributes: {
-          class: "pcb-pad-exposed",
-          fill: layerNameToColor(pad.layer, colorMap2),
-          x: (x - maskWidth / 2).toString(),
-          y: (y - maskHeight / 2).toString(),
-          width: maskWidth.toString(),
-          height: maskHeight.toString(),
-          rx: maskRadius.toString(),
-          ry: maskRadius.toString(),
-          "data-type": "pcb_soldermask",
-          "data-pcb-layer": pad.layer
-        }
+        attributes: exposedAttributes
       };
       return [coveredPadElement, exposedOpeningElement];
     }
@@ -3273,23 +3292,25 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
       };
       return [coveredPadElement];
     }
+    const substrateAttributes = {
+      class: "pcb-soldermask-cutout",
+      fill: colorMap2.substrate,
+      x: isRotated ? (-maskWidth / 2).toString() : (x - maskWidth / 2).toString(),
+      y: isRotated ? (-maskHeight / 2).toString() : (y - maskHeight / 2).toString(),
+      width: maskWidth.toString(),
+      height: maskHeight.toString(),
+      rx: maskRadius.toString(),
+      ry: maskRadius.toString(),
+      "data-type": "pcb_soldermask_opening",
+      "data-pcb-layer": pad.layer,
+      ...isRotated && pad.ccw_rotation ? { transform: `translate(${x} ${y}) rotate(${-pad.ccw_rotation})` } : {}
+    };
     const substrateElement = {
       name: "rect",
       type: "element",
       value: "",
       children: [],
-      attributes: {
-        class: "pcb-soldermask-cutout",
-        fill: colorMap2.substrate,
-        x: (x - maskWidth / 2).toString(),
-        y: (y - maskHeight / 2).toString(),
-        width: maskWidth.toString(),
-        height: maskHeight.toString(),
-        rx: maskRadius.toString(),
-        ry: maskRadius.toString(),
-        "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": `soldermask-${pad.layer}`
-      }
+      attributes: substrateAttributes
     };
     return [substrateElement, padElement];
   }
@@ -3311,7 +3332,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
         "data-pcb-layer": pad.layer
       }
     };
-    if (!shouldshowSolderMask) {
+    if (!shouldShowSolderMask) {
       return [padElement];
     }
     const maskRadius = radius + soldermaskMargin;
@@ -3378,7 +3399,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
         cy: y.toString(),
         r: maskRadius.toString(),
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": `soldermask-${pad.layer}`
+        "data-pcb-layer": pad.layer
       }
     };
     return [substrateElement, padElement];
@@ -3400,7 +3421,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
         "data-pcb-layer": pad.layer
       }
     };
-    if (!shouldshowSolderMask) {
+    if (!shouldShowSolderMask) {
       return [padElement];
     }
     let maskPoints = points;
@@ -3475,7 +3496,7 @@ function createSvgObjectsFromSmtPad(pad, ctx) {
         fill: colorMap2.substrate,
         points: maskPoints.map((p) => p.join(",")).join(" "),
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": `soldermask-${pad.layer}`
+        "data-pcb-layer": pad.layer
       }
     };
     return [substrateElement, padElement];
@@ -3518,6 +3539,8 @@ function createSvgObjectsFromPcbBoard(pcbBoard, ctx) {
   path += " Z";
   const svgObjects = [];
   if (showSolderMask) {
+    const layer = ctx.layer ?? "top";
+    const maskLayer = layer === "bottom" ? "soldermask-bottom" : "soldermask-top";
     svgObjects.push({
       name: "path",
       type: "element",
@@ -3530,7 +3553,7 @@ function createSvgObjectsFromPcbBoard(pcbBoard, ctx) {
         "fill-opacity": "0.8",
         stroke: "none",
         "data-type": "pcb_soldermask",
-        "data-pcb-layer": "soldermask-top"
+        "data-pcb-layer": maskLayer
       }
     });
   }
@@ -3579,7 +3602,7 @@ function createSvgObjectsFromPcbPanel(pcbPanel, ctx) {
   ]);
   const path = `M ${topLeft[0]} ${topLeft[1]} L ${topRight[0]} ${topRight[1]} L ${bottomRight[0]} ${bottomRight[1]} L ${bottomLeft[0]} ${bottomLeft[1]} Z`;
   const isCoveredWithSolderMask = pcbPanel.covered_with_solder_mask !== false;
-  const shouldshowSolderMask = Boolean(
+  const shouldShowSolderMask = Boolean(
     showSolderMask && isCoveredWithSolderMask
   );
   return [
@@ -3654,6 +3677,7 @@ function createSvgObjectsFromPcbVia(hole, ctx) {
 import { applyToPoint as applyToPoint24 } from "transformation-matrix";
 function createSvgObjectsFromPcbHole(hole, ctx) {
   const { transform, colorMap: colorMap2, showSolderMask } = ctx;
+  const layer = ctx.layer ?? "top";
   const [x, y] = applyToPoint24(transform, [hole.x, hole.y]);
   const isCoveredWithSolderMask = Boolean(hole.is_covered_with_solder_mask);
   const soldermaskMargin = (hole.soldermask_margin ?? 0) * Math.abs(transform.a);
@@ -3709,7 +3733,8 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
             cx: x.toString(),
             cy: y.toString(),
             r: maskRadius.toString(),
-            "data-type": "pcb_soldermask"
+            "data-type": "pcb_soldermask",
+            "data-pcb-layer": "drill"
           }
         };
         return [coveredElement, exposedElement];
@@ -3726,7 +3751,7 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
           cy: y.toString(),
           r: maskRadius.toString(),
           "data-type": "pcb_soldermask_opening",
-          "data-pcb-layer": "soldermask-top"
+          "data-pcb-layer": layer
         }
       };
       return [substrateElement2, holeElement2];
@@ -3780,7 +3805,8 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
           y: (y - maskDiameter / 2).toString(),
           width: maskDiameter.toString(),
           height: maskDiameter.toString(),
-          "data-type": "pcb_soldermask"
+          "data-type": "pcb_soldermask",
+          "data-pcb-layer": "drill"
         }
       };
       return [coveredElement, exposedElement];
@@ -3798,7 +3824,7 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
         width: maskDiameter.toString(),
         height: maskDiameter.toString(),
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": "soldermask-top"
+        "data-pcb-layer": layer
       }
     };
     return [substrateElement, holeElement];
@@ -3858,7 +3884,8 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
           cy: y.toString(),
           rx: maskRx.toString(),
           ry: maskRy.toString(),
-          "data-type": "pcb_soldermask"
+          "data-type": "pcb_soldermask",
+          "data-pcb-layer": "drill"
         }
       };
       return [coveredElement, exposedElement];
@@ -3876,7 +3903,7 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
         rx: maskRx.toString(),
         ry: maskRy.toString(),
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": "soldermask-top"
+        "data-pcb-layer": layer
       }
     };
     return [substrateElement, holeElement];
@@ -3934,7 +3961,8 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
           y: (y - maskHeight / 2).toString(),
           width: maskWidth.toString(),
           height: maskHeight.toString(),
-          "data-type": "pcb_soldermask"
+          "data-type": "pcb_soldermask",
+          "data-pcb-layer": "drill"
         }
       };
       return [coveredElement, exposedElement];
@@ -3952,7 +3980,7 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
         width: maskWidth.toString(),
         height: maskHeight.toString(),
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": "soldermask-top"
+        "data-pcb-layer": layer
       }
     };
     return [substrateElement, holeElement];
@@ -4025,7 +4053,8 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
           class: "pcb-hole-exposed",
           fill: colorMap2.drill,
           d: maskPathD,
-          "data-type": "pcb_soldermask"
+          "data-type": "pcb_soldermask",
+          "data-pcb-layer": "drill"
         }
       };
       return [coveredElement, exposedElement];
@@ -4040,7 +4069,7 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
         fill: colorMap2.substrate,
         d: maskPathD,
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": "soldermask-top"
+        "data-pcb-layer": layer
       }
     };
     return [substrateElement, holeElement];
@@ -4117,7 +4146,8 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
           fill: colorMap2.drill,
           d: maskPathD,
           transform: `translate(${x} ${y}) rotate(${-rotation})`,
-          "data-type": "pcb_soldermask"
+          "data-type": "pcb_soldermask",
+          "data-pcb-layer": "drill"
         }
       };
       return [coveredElement, exposedElement];
@@ -4132,7 +4162,7 @@ function createSvgObjectsFromPcbHole(hole, ctx) {
         fill: colorMap2.substrate,
         d: maskPathD,
         "data-type": "pcb_soldermask_opening",
-        "data-pcb-layer": "soldermask-top"
+        "data-pcb-layer": layer
       }
     };
     return [substrateElement, holeElement];
@@ -4397,40 +4427,118 @@ function ringToPathD(vertices, transform) {
   return d;
 }
 
+// lib/pcb/svg-object-fns/create-soldermask-cutout-element.ts
+function createSoldermaskCutoutElement({
+  elementType,
+  shapeAttributes,
+  layer,
+  colorMap: colorMap2,
+  additionalAttributes
+}) {
+  const baseAttributes = {
+    class: "pcb-soldermask-cutout",
+    fill: colorMap2.substrate,
+    "data-type": "pcb_soldermask_opening",
+    "data-pcb-layer": layer,
+    ...shapeAttributes,
+    ...additionalAttributes
+  };
+  return {
+    name: elementType,
+    type: "element",
+    value: "",
+    children: [],
+    attributes: baseAttributes
+  };
+}
+
+// lib/pcb/svg-object-fns/create-soldermask-overlay-element.ts
+function createSoldermaskOverlayElement({
+  elementType,
+  shapeAttributes,
+  layer,
+  fillColor,
+  fillOpacity,
+  className,
+  additionalAttributes
+}) {
+  const baseAttributes = {
+    class: className,
+    fill: fillColor,
+    "fill-opacity": fillOpacity,
+    "data-type": "pcb_soldermask",
+    "data-pcb-layer": layer,
+    ...shapeAttributes,
+    ...additionalAttributes
+  };
+  return {
+    name: elementType,
+    type: "element",
+    value: "",
+    children: [],
+    attributes: baseAttributes
+  };
+}
+
 // lib/pcb/svg-object-fns/create-svg-objects-from-pcb-copper-pour.ts
 function createSvgObjectsFromPcbCopperPour(pour, ctx) {
-  const { transform, layer: layerFilter, colorMap: colorMap2 } = ctx;
+  const { transform, layer: layerFilter, colorMap: colorMap2, showSolderMask } = ctx;
   const { layer } = pour;
   if (layerFilter && layer !== layerFilter) return [];
   const color = layerNameToColor(layer, colorMap2);
   const opacity = "0.5";
+  const isCoveredWithSolderMask = pour.covered_with_solder_mask !== false;
+  const maskOverlayColor = layer === "bottom" ? colorMap2.soldermaskOverCopper.bottom : colorMap2.soldermaskOverCopper.top;
+  const maskOverlayOpacity = "0.9";
   if (pour.shape === "rect") {
     const [cx, cy] = applyToPoint28(transform, [pour.center.x, pour.center.y]);
     const scaledWidth = pour.width * Math.abs(transform.a);
     const scaledHeight = pour.height * Math.abs(transform.d);
     const svgRotation = -(pour.rotation ?? 0);
-    return [
-      {
-        name: "rect",
-        type: "element",
-        attributes: {
-          class: "pcb-copper-pour pcb-copper-pour-rect",
-          x: (-scaledWidth / 2).toString(),
-          y: (-scaledHeight / 2).toString(),
-          width: scaledWidth.toString(),
-          height: scaledHeight.toString(),
-          fill: color,
-          "fill-opacity": opacity,
-          transform: matrixToString7(
-            compose4(translate4(cx, cy), rotate4(svgRotation * Math.PI / 180))
-          ),
-          "data-type": "pcb_copper_pour",
-          "data-pcb-layer": layer
-        },
-        children: [],
-        value: ""
+    const rectAttributes = {
+      x: (-scaledWidth / 2).toString(),
+      y: (-scaledHeight / 2).toString(),
+      width: scaledWidth.toString(),
+      height: scaledHeight.toString(),
+      transform: matrixToString7(
+        compose4(translate4(cx, cy), rotate4(svgRotation * Math.PI / 180))
+      )
+    };
+    const copperRect = {
+      name: "rect",
+      type: "element",
+      value: "",
+      children: [],
+      attributes: {
+        class: "pcb-copper-pour pcb-copper-pour-rect",
+        ...rectAttributes,
+        fill: color,
+        "fill-opacity": opacity,
+        "data-type": "pcb_copper_pour",
+        "data-pcb-layer": layer
       }
-    ];
+    };
+    const maskRect = showSolderMask ? isCoveredWithSolderMask ? createSoldermaskOverlayElement({
+      elementType: "rect",
+      shapeAttributes: rectAttributes,
+      layer,
+      fillColor: maskOverlayColor,
+      fillOpacity: maskOverlayOpacity,
+      className: "pcb-soldermask-covered-pour"
+    }) : createSoldermaskCutoutElement({
+      elementType: "rect",
+      shapeAttributes: rectAttributes,
+      layer,
+      colorMap: colorMap2
+    }) : null;
+    if (!maskRect) {
+      return [copperRect];
+    }
+    const isSubstrateOnly = !isCoveredWithSolderMask && pour.pcb_copper_pour_id?.includes("substrate_only");
+    if (isSubstrateOnly) {
+      return [maskRect];
+    }
+    return [copperRect, maskRect];
   }
   if (pour.shape === "polygon") {
     if (!pour.points || pour.points.length === 0) return [];
@@ -4438,22 +4546,41 @@ function createSvgObjectsFromPcbCopperPour(pour, ctx) {
       (p) => applyToPoint28(transform, [p.x, p.y])
     );
     const pointsString = transformedPoints.map((p) => `${p[0]},${p[1]}`).join(" ");
-    return [
-      {
-        name: "polygon",
-        type: "element",
-        attributes: {
-          class: "pcb-copper-pour pcb-copper-pour-polygon",
-          points: pointsString,
-          fill: color,
-          "fill-opacity": opacity,
-          "data-type": "pcb_copper_pour",
-          "data-pcb-layer": layer
-        },
-        children: [],
-        value: ""
+    const copperPolygon = {
+      name: "polygon",
+      type: "element",
+      value: "",
+      children: [],
+      attributes: {
+        class: "pcb-copper-pour pcb-copper-pour-polygon",
+        points: pointsString,
+        fill: color,
+        "fill-opacity": opacity,
+        "data-type": "pcb_copper_pour",
+        "data-pcb-layer": layer
       }
-    ];
+    };
+    const maskPolygon = showSolderMask ? isCoveredWithSolderMask ? createSoldermaskOverlayElement({
+      elementType: "polygon",
+      shapeAttributes: { points: pointsString },
+      layer,
+      fillColor: maskOverlayColor,
+      fillOpacity: maskOverlayOpacity,
+      className: "pcb-soldermask-covered-pour"
+    }) : createSoldermaskCutoutElement({
+      elementType: "polygon",
+      shapeAttributes: { points: pointsString },
+      layer,
+      colorMap: colorMap2
+    }) : null;
+    if (!maskPolygon) {
+      return [copperPolygon];
+    }
+    const isSubstrateOnly = !isCoveredWithSolderMask && pour.pcb_copper_pour_id?.includes("substrate_only");
+    if (isSubstrateOnly) {
+      return [maskPolygon];
+    }
+    return [copperPolygon, maskPolygon];
   }
   if (pour.shape === "brep") {
     const { brep_shape } = pour;
@@ -4461,23 +4588,42 @@ function createSvgObjectsFromPcbCopperPour(pour, ctx) {
     for (const inner_ring of brep_shape.inner_rings ?? []) {
       d += ` ${ringToPathD(inner_ring.vertices, transform)}`;
     }
-    return [
-      {
-        name: "path",
-        type: "element",
-        attributes: {
-          class: "pcb-copper-pour pcb-copper-pour-brep",
-          d,
-          fill: color,
-          "fill-rule": "evenodd",
-          "fill-opacity": opacity,
-          "data-type": "pcb_copper_pour",
-          "data-pcb-layer": layer
-        },
-        children: [],
-        value: ""
+    const copperPath = {
+      name: "path",
+      type: "element",
+      value: "",
+      children: [],
+      attributes: {
+        class: "pcb-copper-pour pcb-copper-pour-brep",
+        d,
+        fill: color,
+        "fill-rule": "evenodd",
+        "fill-opacity": opacity,
+        "data-type": "pcb_copper_pour",
+        "data-pcb-layer": layer
       }
-    ];
+    };
+    const maskPath = showSolderMask ? isCoveredWithSolderMask ? createSoldermaskOverlayElement({
+      elementType: "path",
+      shapeAttributes: { d, "fill-rule": "evenodd" },
+      layer,
+      fillColor: maskOverlayColor,
+      fillOpacity: maskOverlayOpacity,
+      className: "pcb-soldermask-covered-pour"
+    }) : createSoldermaskCutoutElement({
+      elementType: "path",
+      shapeAttributes: { d, "fill-rule": "evenodd" },
+      layer,
+      colorMap: colorMap2
+    }) : null;
+    if (!maskPath) {
+      return [copperPath];
+    }
+    const isSubstrateOnly = !isCoveredWithSolderMask && pour.pcb_copper_pour_id?.includes("substrate_only");
+    if (isSubstrateOnly) {
+      return [maskPath];
+    }
+    return [copperPath, maskPath];
   }
   return [];
 }
@@ -5074,7 +5220,7 @@ function getSoftwareUsedString(circuitJson) {
 var package_default = {
   name: "circuit-to-svg",
   type: "module",
-  version: "0.0.279",
+  version: "0.0.281",
   description: "Convert Circuit JSON to SVG",
   main: "dist/index.js",
   files: [
@@ -5136,7 +5282,7 @@ var TYPE_PRIORITY = {
   pcb_copper_pour: 35,
   pcb_via: 36,
   pcb_soldermask: 40,
-  pcb_soldermask_opening: 41,
+  pcb_soldermask_opening: 25,
   pcb_solder_paste: 45,
   pcb_silkscreen_text: 50,
   pcb_silkscreen_path: 50,
@@ -5181,7 +5327,7 @@ function getLayerPriority(layer) {
   if (!layer) return 500;
   const normalized = layer.toLowerCase();
   if (normalized === "global") return -100;
-  if (normalized === "bottom") return 0;
+  if (normalized === "bottom") return 4;
   if (normalized === "board") return 2;
   if (normalized === "soldermask-top" || normalized === "soldermask-bottom")
     return 3;
@@ -5275,6 +5421,10 @@ function convertCircuitJsonToPcbSvg(circuitJson, options) {
       top: colorOverrides?.soldermask?.top ?? DEFAULT_PCB_COLOR_MAP.soldermask.top,
       bottom: colorOverrides?.soldermask?.bottom ?? DEFAULT_PCB_COLOR_MAP.soldermask.bottom
     },
+    soldermaskOverCopper: {
+      top: colorOverrides?.soldermaskOverCopper?.top ?? DEFAULT_PCB_COLOR_MAP.soldermaskOverCopper.top,
+      bottom: colorOverrides?.soldermaskOverCopper?.bottom ?? DEFAULT_PCB_COLOR_MAP.soldermaskOverCopper.bottom
+    },
     soldermaskWithCopperUnderneath: {
       top: colorOverrides?.soldermaskWithCopperUnderneath?.top ?? DEFAULT_PCB_COLOR_MAP.soldermaskWithCopperUnderneath.top,
       bottom: colorOverrides?.soldermaskWithCopperUnderneath?.bottom ?? DEFAULT_PCB_COLOR_MAP.soldermaskWithCopperUnderneath.bottom
@@ -5424,10 +5574,9 @@ function convertCircuitJsonToPcbSvg(circuitJson, options) {
     showAnchorOffsets: options?.showAnchorOffsets,
     circuitJson
   };
-  const unsortedSvgObjects = circuitJson.flatMap(
+  let unsortedSvgObjects = circuitJson.flatMap(
     (elm) => createSvgObjects({ elm, circuitJson, ctx })
   );
-  let svgObjects = sortSvgObjectsByPcbLayer(unsortedSvgObjects);
   let strokeWidth = String(0.05 * scaleFactor);
   for (const element of circuitJson) {
     if ("stroke_width" in element) {
@@ -5437,8 +5586,9 @@ function convertCircuitJsonToPcbSvg(circuitJson, options) {
   }
   if (options?.shouldDrawRatsNest) {
     const ratsNestObjects = createSvgObjectsForRatsNest(circuitJson, ctx);
-    svgObjects = sortSvgObjectsByPcbLayer([...svgObjects, ...ratsNestObjects]);
+    unsortedSvgObjects = [...unsortedSvgObjects, ...ratsNestObjects];
   }
+  const svgObjects = sortSvgObjectsByPcbLayer(unsortedSvgObjects);
   const children = [
     {
       name: "style",