circuit-json-to-lbrn 0.0.11 → 0.0.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tscircuit Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -39,12 +39,21 @@ const defaultLbrn = convertCircuitJsonToLbrn(circuitJson)
 
 ## Soldermask Support
 
-The `includeSoldermask` flag enables generation of soldermask openings for cutting polyimide sheet. When enabled:
+The `includeSoldermask` flag enables generation of soldermask openings for cutting Kapton tape (polyimide sheet). When enabled:
 - SMT pads and plated holes will have soldermask openings
 - Traces are NOT included in the soldermask layer (to avoid accidental bridging during soldering)
 - Holes are always cut through the board regardless of the mode
+- **Soldermask shapes are filled (Scan mode)** instead of outlined, which is required for laser-cutting Kapton tape masks where the laser needs to remove material from the pad areas
+
+### Laser Cutting Workflow
+
+The soldermask layer uses LightBurn's "Scan" mode with filled shapes. This is designed for the following workflow:
+
+1. **Generate LBRN file**: Use `includeSoldermask: true` to export filled pad shapes
+2. **Laser cut Kapton tape**: The laser will fill/ablate the pad areas.
+
 
 You can generate:
 - **Copper only**: `{ includeCopper: true, includeSoldermask: false }` - Traditional copper cutting
-- **Soldermask only**: `{ includeCopper: false, includeSoldermask: true }` - Just polyimide cutting patterns
+- **Soldermask only**: `{ includeCopper: false, includeSoldermask: true }` - Just Kapton tape (polyimide) cutting patterns (filled shapes)
 - **Both**: `{ includeCopper: true, includeSoldermask: true }` - Complete fabrication file with both layers

package/dist/index.js

@@ -1334,10 +1334,14 @@ var convertCircuitJsonToLbrn = (circuitJson, options = {}) => {
   });
   project.children.push(throughBoardCutSetting);
   const soldermaskCutSetting = new CutSetting({
+    type: "Scan",
+    // Use Scan mode to fill the pad shapes for Kapton tape cutting
     index: 2,
     name: "Cut Soldermask",
     numPasses: 1,
-    speed: 150
+    speed: 150,
+    scanOpt: "individual"
+    // Scan each shape individually
   });
   project.children.push(soldermaskCutSetting);
   const connMap = getFullConnectivityMapFromCircuitJson(circuitJson);

package/lib/index.ts

@@ -48,10 +48,12 @@ export const convertCircuitJsonToLbrn = (
   project.children.push(throughBoardCutSetting)
 
   const soldermaskCutSetting = new CutSetting({
+    type: "Scan", // Use Scan mode to fill the pad shapes for Kapton tape cutting
     index: 2,
     name: "Cut Soldermask",
     numPasses: 1,
     speed: 150,
+    scanOpt: "individual", // Scan each shape individually
   })
   project.children.push(soldermaskCutSetting)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "circuit-json-to-lbrn",
   "main": "dist/index.js",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "type": "module",
   "scripts": {
     "start": "bun run site/index.html",