circuit-json-to-lbrn 0.0.1

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(bun pm:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/README.md

@@ -0,0 +1,13 @@
+# circuit-json-to-lbrn
+
+Convert Circuit JSON to LBRN XML for PCB fabrication via laser ablation.
+
+## Usage
+
+```tsx
+import { convertCircuitJsonToLbrn } from "circuit-json-to-lbrn"
+
+const lbrnXml = convertCircuitJsonToLbrn(circuitJson, {
+  includeSilkscreen: true,
+})
+```

package/biome.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
+  "assist": { "actions": { "source": { "organizeImports": "on" } } },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "files": {
+    "includes": ["**", "!**/cosmos-export", "!**/dist", "!**/package.json"]
+  },
+  "javascript": {
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "all",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "off"
+      },
+      "complexity": {
+        "noForEach": "error",
+        "useLiteralKeys": "off"
+      },
+      "a11y": {
+        "noAccessKey": "off",
+        "noAriaHiddenOnFocusable": "off",
+        "noAriaUnsupportedElements": "off",
+        "noAutofocus": "off",
+        "noDistractingElements": "off",
+        "noHeaderScope": "off",
+        "noInteractiveElementToNoninteractiveRole": "off",
+        "noLabelWithoutControl": "off",
+        "noNoninteractiveElementToInteractiveRole": "off",
+        "noNoninteractiveTabindex": "off",
+        "noPositiveTabindex": "off",
+        "noRedundantAlt": "off",
+        "noRedundantRoles": "off",
+        "noStaticElementInteractions": "off",
+        "noSvgWithoutTitle": "off",
+        "useAltText": "off",
+        "useAnchorContent": "off",
+        "useAriaActivedescendantWithTabindex": "off",
+        "useAriaPropsForRole": "off",
+        "useAriaPropsSupportedByRole": "off",
+        "useButtonType": "off",
+        "useFocusableInteractive": "off",
+        "useHeadingContent": "off",
+        "useHtmlLang": "off",
+        "useIframeTitle": "off",
+        "useKeyWithClickEvents": "off",
+        "useKeyWithMouseEvents": "off",
+        "useMediaCaption": "off",
+        "useSemanticElements": "off",
+        "useValidAnchor": "off",
+        "useValidAriaProps": "off",
+        "useValidAriaRole": "off",
+        "useValidAriaValues": "off",
+        "useValidAutocomplete": "off",
+        "useValidLang": "off"
+      },
+      "style": {
+        "useSingleVarDeclarator": "error",
+        "noParameterAssign": "off",
+        "noUselessElse": "off",
+        "noNonNullAssertion": "off",
+        "useNumberNamespace": "off",
+        "noUnusedTemplateLiteral": "off",
+        "useFilenamingConvention": {
+          "level": "error",
+          "options": {
+            "strictCase": true,
+            "requireAscii": true,
+            "filenameCases": ["kebab-case", "export"]
+          }
+        },
+        "useAsConstAssertion": "error",
+        "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
+        "useSelfClosingElements": "error",
+        "noInferrableTypes": "error"
+      }
+    }
+  }
+}

package/bunfig.toml

@@ -0,0 +1,5 @@
+[test]
+preload = ["./tests/fixtures/preload.ts"]
+
+[install.lockfile]
+save = false

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { CircuitJson } from 'circuit-json';
+import { LightBurnProject } from 'lbrnts';
+
+declare const convertCircuitJsonToLbrn: (circuitJson: CircuitJson, options?: {
+    includeSilkscreen?: boolean;
+}) => LightBurnProject;
+
+export { convertCircuitJsonToLbrn };

package/dist/index.js

@@ -0,0 +1,215 @@
+// lib/index.ts
+import { LightBurnProject, CutSetting } from "lbrnts";
+import { cju } from "@tscircuit/circuit-json-util";
+
+// lib/element-handlers/addPlatedHole/addCirclePlatedHole.ts
+import { ShapePath } from "lbrnts";
+var addCirclePlatedHole = (platedHole, ctx) => {
+  const { project, copperCutSetting } = ctx;
+  const radius = platedHole.outer_diameter / 2;
+  const centerX = platedHole.x;
+  const centerY = platedHole.y;
+  const kappa = 0.5522847498;
+  const controlOffset = radius * kappa;
+  const verts = [
+    // Right point (3 o'clock)
+    { x: centerX + radius, y: centerY },
+    // Bottom point (6 o'clock) with control points
+    {
+      x: centerX,
+      y: centerY + radius,
+      c: 1,
+      c0x: radius,
+      c0y: controlOffset,
+      c1x: controlOffset,
+      c1y: radius
+    },
+    // Left point (9 o'clock) with control points
+    {
+      x: centerX - radius,
+      y: centerY,
+      c: 1,
+      c0x: -controlOffset,
+      c0y: radius,
+      c1x: -radius,
+      c1y: controlOffset
+    },
+    // Top point (12 o'clock) with control points
+    {
+      x: centerX,
+      y: centerY - radius,
+      c: 1,
+      c0x: -radius,
+      c0y: -controlOffset,
+      c1x: -controlOffset,
+      c1y: -radius
+    },
+    // Back to right point (close path) with control points
+    {
+      x: centerX + radius,
+      y: centerY,
+      c: 1,
+      c0x: controlOffset,
+      c0y: -radius,
+      c1x: radius,
+      c1y: -controlOffset
+    }
+  ];
+  const prims = [
+    { type: 1 },
+    // BezierTo for bottom
+    { type: 1 },
+    // BezierTo for left
+    { type: 1 },
+    // BezierTo for top
+    { type: 1 }
+    // BezierTo for right (closing)
+  ];
+  project.children.push(
+    new ShapePath({
+      cutIndex: copperCutSetting.index,
+      verts,
+      prims,
+      isClosed: true
+    })
+  );
+};
+
+// lib/element-handlers/addPlatedHole/addOvalPlatedHole.ts
+var addOvalPlatedHole = (platedHole, ctx) => {
+  console.warn(
+    `Oval/pill plated hole not yet implemented: ${platedHole.pcb_plated_hole_id}`
+  );
+};
+
+// lib/element-handlers/addPlatedHole/addCircularHoleWithRectPad.ts
+var addCircularHoleWithRectPad = (platedHole, ctx) => {
+  console.warn(
+    `Circular hole with rect pad not yet implemented: ${platedHole.pcb_plated_hole_id}`
+  );
+};
+
+// lib/element-handlers/addPlatedHole/addPillHoleWithRectPad.ts
+var addPillHoleWithRectPad = (platedHole, ctx) => {
+  console.warn(
+    `Pill hole with rect pad not yet implemented: ${platedHole.pcb_plated_hole_id}`
+  );
+};
+
+// lib/element-handlers/addPlatedHole/addRotatedPillHoleWithRectPad.ts
+var addRotatedPillHoleWithRectPad = (platedHole, ctx) => {
+  console.warn(
+    `Rotated pill hole with rect pad not yet implemented: ${platedHole.pcb_plated_hole_id}`
+  );
+};
+
+// lib/element-handlers/addPlatedHole/addHoleWithPolygonPad.ts
+var addHoleWithPolygonPad = (platedHole, ctx) => {
+  console.warn(
+    `Hole with polygon pad not yet implemented: ${platedHole.pcb_plated_hole_id}`
+  );
+};
+
+// lib/element-handlers/addPlatedHole/index.ts
+var addPlatedHole = (platedHole, ctx) => {
+  switch (platedHole.shape) {
+    case "circle":
+      return addCirclePlatedHole(platedHole, ctx);
+    case "oval":
+    case "pill":
+      return addOvalPlatedHole(platedHole, ctx);
+    case "circular_hole_with_rect_pad":
+      return addCircularHoleWithRectPad(platedHole, ctx);
+    case "pill_hole_with_rect_pad":
+      return addPillHoleWithRectPad(platedHole, ctx);
+    case "rotated_pill_hole_with_rect_pad":
+      return addRotatedPillHoleWithRectPad(platedHole, ctx);
+    case "hole_with_polygon_pad":
+      return addHoleWithPolygonPad(platedHole, ctx);
+    default:
+      const _exhaustive = platedHole;
+      console.warn(`Unknown plated hole shape: ${platedHole.shape}`);
+  }
+};
+
+// lib/element-handlers/addSmtPad/addRectSmtPad.ts
+import { ShapePath as ShapePath2 } from "lbrnts";
+var addRectSmtPad = (smtPad, ctx) => {
+  const { project, copperCutSetting } = ctx;
+  const centerX = smtPad.x;
+  const centerY = smtPad.y;
+  const halfWidth = smtPad.width / 2;
+  const halfHeight = smtPad.height / 2;
+  const verts = [
+    { x: centerX - halfWidth, y: centerY - halfHeight },
+    // Top-left
+    { x: centerX + halfWidth, y: centerY - halfHeight },
+    // Top-right
+    { x: centerX + halfWidth, y: centerY + halfHeight },
+    // Bottom-right
+    { x: centerX - halfWidth, y: centerY + halfHeight }
+    // Bottom-left
+  ];
+  const prims = [
+    { type: 0 },
+    // LineTo for top-right
+    { type: 0 },
+    // LineTo for bottom-right
+    { type: 0 },
+    // LineTo for bottom-left
+    { type: 0 }
+    // LineTo back to top-left (closing)
+  ];
+  project.children.push(
+    new ShapePath2({
+      cutIndex: copperCutSetting.index,
+      verts,
+      prims,
+      isClosed: true
+    })
+  );
+};
+
+// lib/element-handlers/addSmtPad/index.ts
+var addSmtPad = (smtPad, ctx) => {
+  switch (smtPad.shape) {
+    case "rect": {
+      addRectSmtPad(smtPad, ctx);
+      break;
+    }
+    default: {
+      throw new Error(`Unknown smt pad shape: ${smtPad.shape}`);
+    }
+  }
+};
+
+// lib/index.ts
+var convertCircuitJsonToLbrn = (circuitJson, options = {}) => {
+  const db = cju(circuitJson);
+  const project = new LightBurnProject({
+    appVersion: "1.7.03",
+    formatVersion: "1"
+  });
+  const copperCutSetting = new CutSetting({
+    index: 0,
+    name: "Cut Copper",
+    numPasses: 12,
+    speed: 100
+  });
+  project.children.push(copperCutSetting);
+  const ctx = {
+    db,
+    project,
+    copperCutSetting
+  };
+  for (const smtpad of db.pcb_smtpad.list()) {
+    addSmtPad(smtpad, ctx);
+  }
+  for (const platedHole of db.pcb_plated_hole.list()) {
+    addPlatedHole(platedHole, ctx);
+  }
+  return project;
+};
+export {
+  convertCircuitJsonToLbrn
+};

package/lib/ConvertContext.ts

@@ -0,0 +1,9 @@
+import type { CircuitJsonUtilObjects } from "@tscircuit/circuit-json-util"
+import type { CutSetting, LightBurnProject } from "lbrnts"
+
+export interface ConvertContext {
+  db: CircuitJsonUtilObjects
+  project: LightBurnProject
+
+  copperCutSetting: CutSetting
+}

package/lib/element-handlers/addPlatedHole/addCirclePlatedHole.ts

@@ -0,0 +1,83 @@
+import type { PcbPlatedHoleCircle } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+import { ShapePath } from "lbrnts"
+
+export const addCirclePlatedHole = (
+  platedHole: PcbPlatedHoleCircle,
+  ctx: ConvertContext,
+): void => {
+  const { project, copperCutSetting } = ctx
+
+  // Create a circle path using the outer diameter
+  const radius = platedHole.outer_diameter / 2
+  const centerX = platedHole.x
+  const centerY = platedHole.y
+
+  // Create circle using 4 bezier curves (standard circle approximation)
+  // The control point offset for a circle is approximately 0.5522847498 * radius
+  const kappa = 0.5522847498
+  const controlOffset = radius * kappa
+
+  // Create vertices for a circle starting from the right point (3 o'clock)
+  const verts = [
+    // Right point (3 o'clock)
+    { x: centerX + radius, y: centerY },
+    // Bottom point (6 o'clock) with control points
+    {
+      x: centerX,
+      y: centerY + radius,
+      c: 1,
+      c0x: radius,
+      c0y: controlOffset,
+      c1x: controlOffset,
+      c1y: radius,
+    },
+    // Left point (9 o'clock) with control points
+    {
+      x: centerX - radius,
+      y: centerY,
+      c: 1,
+      c0x: -controlOffset,
+      c0y: radius,
+      c1x: -radius,
+      c1y: controlOffset,
+    },
+    // Top point (12 o'clock) with control points
+    {
+      x: centerX,
+      y: centerY - radius,
+      c: 1,
+      c0x: -radius,
+      c0y: -controlOffset,
+      c1x: -controlOffset,
+      c1y: -radius,
+    },
+    // Back to right point (close path) with control points
+    {
+      x: centerX + radius,
+      y: centerY,
+      c: 1,
+      c0x: controlOffset,
+      c0y: -radius,
+      c1x: radius,
+      c1y: -controlOffset,
+    },
+  ]
+
+  // Create primitives (all bezier curves)
+  const prims = [
+    { type: 1 }, // BezierTo for bottom
+    { type: 1 }, // BezierTo for left
+    { type: 1 }, // BezierTo for top
+    { type: 1 }, // BezierTo for right (closing)
+  ]
+
+  project.children.push(
+    new ShapePath({
+      cutIndex: copperCutSetting.index,
+      verts,
+      prims,
+      isClosed: true,
+    }),
+  )
+}

package/lib/element-handlers/addPlatedHole/addCircularHoleWithRectPad.ts

@@ -0,0 +1,12 @@
+import type { PcbHoleCircularWithRectPad } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+
+export const addCircularHoleWithRectPad = (
+  platedHole: PcbHoleCircularWithRectPad,
+  ctx: ConvertContext,
+): void => {
+  // TODO: Implement circular hole with rectangular pad generation
+  console.warn(
+    `Circular hole with rect pad not yet implemented: ${platedHole.pcb_plated_hole_id}`,
+  )
+}

package/lib/element-handlers/addPlatedHole/addHoleWithPolygonPad.ts

@@ -0,0 +1,12 @@
+import type { PcbHoleWithPolygonPad } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+
+export const addHoleWithPolygonPad = (
+  platedHole: PcbHoleWithPolygonPad,
+  ctx: ConvertContext,
+): void => {
+  // TODO: Implement hole with polygon pad generation
+  console.warn(
+    `Hole with polygon pad not yet implemented: ${platedHole.pcb_plated_hole_id}`,
+  )
+}

package/lib/element-handlers/addPlatedHole/addOvalPlatedHole.ts

@@ -0,0 +1,12 @@
+import type { PcbPlatedHoleOval } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+
+export const addOvalPlatedHole = (
+  platedHole: PcbPlatedHoleOval,
+  ctx: ConvertContext,
+): void => {
+  // TODO: Implement oval/pill plated hole generation
+  console.warn(
+    `Oval/pill plated hole not yet implemented: ${platedHole.pcb_plated_hole_id}`,
+  )
+}

package/lib/element-handlers/addPlatedHole/addPillHoleWithRectPad.ts

@@ -0,0 +1,12 @@
+import type { PcbHolePillWithRectPad } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+
+export const addPillHoleWithRectPad = (
+  platedHole: PcbHolePillWithRectPad,
+  ctx: ConvertContext,
+): void => {
+  // TODO: Implement pill hole with rectangular pad generation
+  console.warn(
+    `Pill hole with rect pad not yet implemented: ${platedHole.pcb_plated_hole_id}`,
+  )
+}

package/lib/element-handlers/addPlatedHole/addRotatedPillHoleWithRectPad.ts

@@ -0,0 +1,12 @@
+import type { PcbHoleRotatedPillWithRectPad } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+
+export const addRotatedPillHoleWithRectPad = (
+  platedHole: PcbHoleRotatedPillWithRectPad,
+  ctx: ConvertContext,
+): void => {
+  // TODO: Implement rotated pill hole with rectangular pad generation
+  console.warn(
+    `Rotated pill hole with rect pad not yet implemented: ${platedHole.pcb_plated_hole_id}`,
+  )
+}

package/lib/element-handlers/addPlatedHole/index.ts

@@ -0,0 +1,43 @@
+import type { PcbPlatedHole } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+import { addCirclePlatedHole } from "./addCirclePlatedHole"
+import { addOvalPlatedHole } from "./addOvalPlatedHole"
+import { addCircularHoleWithRectPad } from "./addCircularHoleWithRectPad"
+import { addPillHoleWithRectPad } from "./addPillHoleWithRectPad"
+import { addRotatedPillHoleWithRectPad } from "./addRotatedPillHoleWithRectPad"
+import { addHoleWithPolygonPad } from "./addHoleWithPolygonPad"
+
+/**
+ * Main dispatcher function that routes plated holes to the appropriate handler
+ * based on their shape property
+ */
+export const addPlatedHole = (
+  platedHole: PcbPlatedHole,
+  ctx: ConvertContext,
+): void => {
+  switch (platedHole.shape) {
+    case "circle":
+      return addCirclePlatedHole(platedHole, ctx)
+
+    case "oval":
+    case "pill":
+      return addOvalPlatedHole(platedHole, ctx)
+
+    case "circular_hole_with_rect_pad":
+      return addCircularHoleWithRectPad(platedHole, ctx)
+
+    case "pill_hole_with_rect_pad":
+      return addPillHoleWithRectPad(platedHole, ctx)
+
+    case "rotated_pill_hole_with_rect_pad":
+      return addRotatedPillHoleWithRectPad(platedHole, ctx)
+
+    case "hole_with_polygon_pad":
+      return addHoleWithPolygonPad(platedHole, ctx)
+
+    default:
+      // Type guard to ensure we handle all cases
+      const _exhaustive: never = platedHole
+      console.warn(`Unknown plated hole shape: ${(platedHole as any).shape}`)
+  }
+}

package/lib/element-handlers/addSmtPad/addRectSmtPad.ts

@@ -0,0 +1,37 @@
+import type { ConvertContext } from "../../ConvertContext"
+import type { PcbSmtPadRect } from "circuit-json"
+import { ShapePath } from "lbrnts"
+
+export const addRectSmtPad = (smtPad: PcbSmtPadRect, ctx: ConvertContext) => {
+  const { project, copperCutSetting } = ctx
+
+  const centerX = smtPad.x
+  const centerY = smtPad.y
+  const halfWidth = smtPad.width / 2
+  const halfHeight = smtPad.height / 2
+
+  // Create vertices for rectangle corners (clockwise from top-left)
+  const verts = [
+    { x: centerX - halfWidth, y: centerY - halfHeight }, // Top-left
+    { x: centerX + halfWidth, y: centerY - halfHeight }, // Top-right
+    { x: centerX + halfWidth, y: centerY + halfHeight }, // Bottom-right
+    { x: centerX - halfWidth, y: centerY + halfHeight }, // Bottom-left
+  ]
+
+  // Create primitives (all lines)
+  const prims = [
+    { type: 0 }, // LineTo for top-right
+    { type: 0 }, // LineTo for bottom-right
+    { type: 0 }, // LineTo for bottom-left
+    { type: 0 }, // LineTo back to top-left (closing)
+  ]
+
+  project.children.push(
+    new ShapePath({
+      cutIndex: copperCutSetting.index,
+      verts,
+      prims,
+      isClosed: true,
+    }),
+  )
+}

package/lib/element-handlers/addSmtPad/index.ts

@@ -0,0 +1,15 @@
+import type { PcbSmtPad } from "circuit-json"
+import type { ConvertContext } from "../../ConvertContext"
+import { addRectSmtPad } from "./addRectSmtPad"
+
+export const addSmtPad = (smtPad: PcbSmtPad, ctx: ConvertContext) => {
+  switch (smtPad.shape) {
+    case "rect": {
+      addRectSmtPad(smtPad, ctx)
+      break
+    }
+    default: {
+      throw new Error(`Unknown smt pad shape: ${smtPad.shape}`)
+    }
+  }
+}

package/lib/index.ts

@@ -0,0 +1,41 @@
+import type { CircuitJson } from "circuit-json"
+import { LightBurnProject, CutSetting } from "lbrnts"
+import { cju } from "@tscircuit/circuit-json-util"
+import type { ConvertContext } from "./ConvertContext"
+import { addPlatedHole } from "./element-handlers/addPlatedHole"
+import { addSmtPad } from "./element-handlers/addSmtPad"
+
+export const convertCircuitJsonToLbrn = (
+  circuitJson: CircuitJson,
+  options: { includeSilkscreen?: boolean } = {},
+): LightBurnProject => {
+  const db = cju(circuitJson)
+  const project = new LightBurnProject({
+    appVersion: "1.7.03",
+    formatVersion: "1",
+  })
+
+  const copperCutSetting = new CutSetting({
+    index: 0,
+    name: "Cut Copper",
+    numPasses: 12,
+    speed: 100,
+  })
+  project.children.push(copperCutSetting)
+
+  const ctx: ConvertContext = {
+    db,
+    project,
+    copperCutSetting,
+  }
+
+  for (const smtpad of db.pcb_smtpad.list()) {
+    addSmtPad(smtpad, ctx)
+  }
+
+  for (const platedHole of db.pcb_plated_hole.list()) {
+    addPlatedHole(platedHole, ctx)
+  }
+
+  return project
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "circuit-json-to-lbrn",
+  "main": "dist/index.js",
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "build": "tsup-node ./lib/index.ts --dts --format esm",
+    "format": "biome format --write .",
+    "format:check": "biome format ."
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.6",
+    "@tscircuit/circuit-json-util": "^0.0.72",
+    "@types/bun": "latest",
+    "bun-match-svg": "^0.0.14",
+    "circuit-json": "^0.0.316",
+    "circuit-json-to-connectivity-map": "^0.0.22",
+    "circuit-to-svg": "^0.0.271",
+    "schematic-symbols": "^0.0.202",
+    "stack-svgs": "^0.0.1",
+    "tsup": "^8.5.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "lbrnts": "^0.0.1"
+  }
+}

package/tests/__snapshots__/svg.snap.svg

@@ -0,0 +1,3 @@
+<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">                                       
+   <circle cx="50" cy="50" r="40" stroke="black" stroke-width="3" fill="red" />                                            
+ </svg>