@tscircuit/core 0.0.872 → 0.0.873

package/dist/index.d.ts

@@ -3240,6 +3240,11 @@ declare class Panel extends Group<typeof panelProps> {
             height: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
             children: zod.ZodOptional<zod.ZodAny>;
             noSolderMask: zod.ZodOptional<zod.ZodBoolean>;
+            panelizationMethod: zod.ZodOptional<zod.ZodEnum<["tab-routing", "none"]>>;
+            boardGap: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+            tabWidth: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+            tabLength: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+            mouseBites: zod.ZodOptional<zod.ZodBoolean>;
         }, "strip", zod.ZodTypeAny, {
             width: number;
             height: number;
@@ -3484,6 +3489,11 @@ declare class Panel extends Group<typeof panelProps> {
             schPack?: boolean | undefined;
             schMatchAdapt?: boolean | undefined;
             noSolderMask?: boolean | undefined;
+            panelizationMethod?: "none" | "tab-routing" | undefined;
+            boardGap?: number | undefined;
+            tabWidth?: number | undefined;
+            tabLength?: number | undefined;
+            mouseBites?: boolean | undefined;
         }, {
             width: string | number;
             height: string | number;
@@ -3730,6 +3740,11 @@ declare class Panel extends Group<typeof panelProps> {
             schPack?: boolean | undefined;
             schMatchAdapt?: boolean | undefined;
             noSolderMask?: boolean | undefined;
+            panelizationMethod?: "none" | "tab-routing" | undefined;
+            boardGap?: string | number | undefined;
+            tabWidth?: string | number | undefined;
+            tabLength?: string | number | undefined;
+            mouseBites?: boolean | undefined;
         }>;
     };
     get isGroup(): boolean;

package/dist/index.js

@@ -14333,14 +14333,9 @@ import { panelProps } from "@tscircuit/props";
 import { distance as distance9 } from "circuit-json";
 
 // lib/utils/panels/generate-panel-tabs-and-mouse-bites.ts
-var TAB_CONFIG = {
-  TAB_WIDTH: 4,
-  TAB_DEPTH: 0.5,
-  TAB_TO_SPACE_RATIO: 5,
-  MOUSE_BITE_DIAMETER: 0.2,
-  MOUSE_BITE_SPACING: 0.1,
-  MOUSE_BITES_PER_GAP: 5
-};
+var DEFAULT_PANEL_MARGIN = 5;
+var DEFAULT_TAB_LENGTH = 5;
+var DEFAULT_TAB_WIDTH = 2;
 function rectanglesOverlap(rect1, rect2) {
   const r1Left = rect1.center.x - rect1.width / 2;
   const r1Right = rect1.center.x + rect1.width / 2;
@@ -14363,7 +14358,12 @@ function pointOverlapsRectangle(point, radius, rect) {
   const distanceY = point.y - closestY;
   return distanceX * distanceX + distanceY * distanceY <= radius * radius;
 }
-function generateTabsForEdge(board, edge, existingTabs, otherBoards) {
+function generateTabsForEdge({
+  board,
+  edge,
+  otherBoards,
+  options
+}) {
   const tabs = [];
   if (!board.width || !board.height) return tabs;
   const boardLeft = board.center.x - board.width / 2;
@@ -14382,9 +14382,15 @@ function generateTabsForEdge(board, edge, existingTabs, otherBoards) {
     isHorizontal = false;
     edgeCenter = edge === "right" ? boardRight : boardLeft;
   }
-  const totalTabWidth = TAB_CONFIG.TAB_WIDTH;
-  const minSpacingForMouseBites = TAB_CONFIG.MOUSE_BITES_PER_GAP * TAB_CONFIG.MOUSE_BITE_DIAMETER + (TAB_CONFIG.MOUSE_BITES_PER_GAP - 1) * TAB_CONFIG.MOUSE_BITE_SPACING;
-  const fixedSpacing = minSpacingForMouseBites * 1.1;
+  const totalTabWidth = options.tabLength;
+  let fixedSpacing = options.boardGap;
+  if (options.mouseBites) {
+    const mouseBiteDiameter = options.tabWidth * 0.45;
+    const mouseBiteSpacing = mouseBiteDiameter * 0.1;
+    const mouseBitesPerGap = Math.max(2, Math.ceil(options.tabLength / 2));
+    const minSpacingForMouseBites = mouseBitesPerGap * mouseBiteDiameter + (mouseBitesPerGap - 1) * mouseBiteSpacing;
+    fixedSpacing = minSpacingForMouseBites * 1.1;
+  }
   let numTabs = Math.floor(
     (edgeLength - fixedSpacing) / (totalTabWidth + fixedSpacing)
   );
@@ -14409,13 +14415,13 @@ function generateTabsForEdge(board, edge, existingTabs, otherBoards) {
     axisStart = Math.max(axisStart, boardStart);
     axisEnd = Math.min(axisEnd, boardEnd);
     if (isCornerTab) {
-      if (isFirstTab) axisStart -= TAB_CONFIG.TAB_DEPTH;
-      if (isLastTab) axisEnd += TAB_CONFIG.TAB_DEPTH;
+      if (isFirstTab) axisStart -= options.tabWidth;
+      if (isLastTab) axisEnd += options.tabWidth;
     }
     if (axisEnd <= axisStart) continue;
     const axisCenterOffset = (axisStart + axisEnd) / 2;
     const axisLength = axisEnd - axisStart;
-    const crossAxisOffset = edge === "top" || edge === "right" ? TAB_CONFIG.TAB_DEPTH / 2 : -TAB_CONFIG.TAB_DEPTH / 2;
+    const crossAxisOffset = edge === "top" || edge === "right" ? options.tabWidth / 2 : -options.tabWidth / 2;
     const tabCenter = isHorizontal ? {
       x: board.center.x + axisCenterOffset,
       y: edgeCenter + crossAxisOffset
@@ -14423,8 +14429,8 @@ function generateTabsForEdge(board, edge, existingTabs, otherBoards) {
       x: edgeCenter + crossAxisOffset,
       y: board.center.y + axisCenterOffset
     };
-    const tabWidth = isHorizontal ? axisLength : TAB_CONFIG.TAB_DEPTH;
-    const tabHeight = isHorizontal ? TAB_CONFIG.TAB_DEPTH : axisLength;
+    const tabWidth = isHorizontal ? axisLength : options.tabWidth;
+    const tabHeight = isHorizontal ? options.tabWidth : axisLength;
     const newTab = {
       center: tabCenter,
       width: tabWidth,
@@ -14449,7 +14455,13 @@ function generateTabsForEdge(board, edge, existingTabs, otherBoards) {
   }
   return tabs;
 }
-function generateMouseBitesForEdge(board, edge, edgeTabs, allTabs, allBoards, existingMouseBites) {
+function generateMouseBitesForEdge({
+  board,
+  edge,
+  edgeTabs,
+  allBoards,
+  options
+}) {
   const mouseBites = [];
   if (edgeTabs.length === 0) return mouseBites;
   if (!board.width || !board.height) return mouseBites;
@@ -14458,8 +14470,11 @@ function generateMouseBitesForEdge(board, edge, edgeTabs, allTabs, allBoards, ex
   const boardBottom = board.center.y - board.height / 2;
   const boardTop = board.center.y + board.height / 2;
   const isHorizontal = edge === "top" || edge === "bottom";
+  const mouseBiteDiameter = options.tabWidth * 0.45;
+  const mouseBiteSpacing = mouseBiteDiameter * 0.1;
+  const mouseBitesPerGap = Math.max(2, Math.ceil(options.tabLength / 2));
   let mouseBitePosition;
-  const radius = TAB_CONFIG.MOUSE_BITE_DIAMETER / 2;
+  const radius = mouseBiteDiameter / 2;
   if (edge === "top") {
     mouseBitePosition = boardTop;
   } else if (edge === "bottom") {
@@ -14489,14 +14504,14 @@ function generateMouseBitesForEdge(board, edge, edgeTabs, allTabs, allBoards, ex
       gapEnd = tab2.center.y - tab2.height / 2;
     }
     const gapLength = gapEnd - gapStart;
-    const totalMouseBiteWidth = TAB_CONFIG.MOUSE_BITES_PER_GAP * TAB_CONFIG.MOUSE_BITE_DIAMETER;
-    const totalSpacing = (TAB_CONFIG.MOUSE_BITES_PER_GAP - 1) * TAB_CONFIG.MOUSE_BITE_SPACING;
+    const totalMouseBiteWidth = mouseBitesPerGap * mouseBiteDiameter;
+    const totalSpacing = (mouseBitesPerGap - 1) * mouseBiteSpacing;
     if (gapLength < totalMouseBiteWidth + totalSpacing) continue;
     const gapCenter = (gapStart + gapEnd) / 2;
-    for (let j = 0; j < TAB_CONFIG.MOUSE_BITES_PER_GAP; j++) {
-      const posOffset = (j - (TAB_CONFIG.MOUSE_BITES_PER_GAP - 1) / 2) * (TAB_CONFIG.MOUSE_BITE_DIAMETER + TAB_CONFIG.MOUSE_BITE_SPACING);
+    for (let j = 0; j < mouseBitesPerGap; j++) {
+      const posOffset = (j - (mouseBitesPerGap - 1) / 2) * (mouseBiteDiameter + mouseBiteSpacing);
       const newMouseBite = isHorizontal ? { x: gapCenter + posOffset, y: mouseBitePosition } : { x: mouseBitePosition, y: gapCenter + posOffset };
-      const radius2 = TAB_CONFIG.MOUSE_BITE_DIAMETER / 2;
+      const radius2 = mouseBiteDiameter / 2;
       let overlapsBoard = false;
       for (const otherBoard of allBoards) {
         if (!otherBoard.width || !otherBoard.height) continue;
@@ -14516,45 +14531,50 @@ function generateMouseBitesForEdge(board, edge, edgeTabs, allTabs, allBoards, ex
   }
   return mouseBites;
 }
-function generatePanelTabsAndMouseBites(boards) {
+function generatePanelTabsAndMouseBites(boards, options) {
   const allTabCutouts = [];
   const allMouseBites = [];
   for (let boardIndex = 0; boardIndex < boards.length; boardIndex++) {
     const board = boards[boardIndex];
     const otherBoards = boards.filter((_, i) => i !== boardIndex);
     for (const edge of ["top", "bottom", "left", "right"]) {
-      const edgeTabs = generateTabsForEdge(
-        board,
-        edge,
-        allTabCutouts,
-        otherBoards
-      );
-      allTabCutouts.push(...edgeTabs);
-      const edgeMouseBites = generateMouseBitesForEdge(
+      const edgeTabs = generateTabsForEdge({
         board,
         edge,
-        edgeTabs,
-        allTabCutouts,
         otherBoards,
-        allMouseBites
-      );
-      allMouseBites.push(...edgeMouseBites);
+        options
+      });
+      allTabCutouts.push(...edgeTabs);
+      if (options.mouseBites) {
+        const edgeMouseBites = generateMouseBitesForEdge({
+          board,
+          edge,
+          edgeTabs,
+          allBoards: otherBoards,
+          options
+        });
+        allMouseBites.push(...edgeMouseBites);
+      }
     }
   }
-  const tabCutouts = allTabCutouts.map((tab, index) => ({
-    type: "pcb_cutout",
-    pcb_cutout_id: `panel_tab_${index}`,
-    shape: "rect",
-    center: tab.center,
-    width: tab.width,
-    height: tab.height,
-    corner_radius: 0.25
-  }));
+  const tabCutouts = allTabCutouts.map((tab, index) => {
+    const tabWidthDimension = Math.min(tab.width, tab.height);
+    return {
+      type: "pcb_cutout",
+      pcb_cutout_id: `panel_tab_${index}`,
+      shape: "rect",
+      center: tab.center,
+      width: tab.width,
+      height: tab.height,
+      corner_radius: tabWidthDimension / 2
+    };
+  });
+  const mouseBiteDiameter = options.tabWidth * 0.45;
   const mouseBiteHoles = allMouseBites.map((bite, index) => ({
     type: "pcb_hole",
     pcb_hole_id: `panel_mouse_bite_${index}`,
     hole_shape: "circle",
-    hole_diameter: TAB_CONFIG.MOUSE_BITE_DIAMETER,
+    hole_diameter: mouseBiteDiameter,
     x: bite.x,
     y: bite.y
   }));
@@ -14600,6 +14620,8 @@ var Panel = class extends Group6 {
       (b) => b.props.pcbX === void 0 && b.props.pcbY === void 0
     );
     if (unpositionedBoards.length > 0 && !hasAnyPositionedBoards) {
+      const tabWidth = this._parsedProps.tabWidth ?? DEFAULT_TAB_WIDTH;
+      const boardGap = this._parsedProps.boardGap ?? tabWidth;
       const gridCols = Math.ceil(Math.sqrt(unpositionedBoards.length));
       const gridRows = Math.ceil(unpositionedBoards.length / gridCols);
       const colWidths = Array(gridCols).fill(0);
@@ -14613,17 +14635,17 @@ var Panel = class extends Group6 {
         colWidths[col] = Math.max(colWidths[col], pcbBoard.width);
         rowHeights[row] = Math.max(rowHeights[row], pcbBoard.height);
       });
-      const totalGridWidth = colWidths.reduce((a, b) => a + b, 0) + (gridCols > 1 ? (gridCols - 1) * TAB_CONFIG.TAB_DEPTH : 0);
-      const totalGridHeight = rowHeights.reduce((a, b) => a + b, 0) + (gridRows > 1 ? (gridRows - 1) * TAB_CONFIG.TAB_DEPTH : 0);
+      const totalGridWidth = colWidths.reduce((a, b) => a + b, 0) + (gridCols > 1 ? (gridCols - 1) * boardGap : 0);
+      const totalGridHeight = rowHeights.reduce((a, b) => a + b, 0) + (gridRows > 1 ? (gridRows - 1) * boardGap : 0);
       const startX = -totalGridWidth / 2;
       const startY = -totalGridHeight / 2;
       const rowYOffsets = [startY];
       for (let i = 0; i < gridRows - 1; i++) {
-        rowYOffsets.push(rowYOffsets[i] + rowHeights[i] + TAB_CONFIG.TAB_DEPTH);
+        rowYOffsets.push(rowYOffsets[i] + rowHeights[i] + boardGap);
       }
       const colXOffsets = [startX];
       for (let i = 0; i < gridCols - 1; i++) {
-        colXOffsets.push(colXOffsets[i] + colWidths[i] + TAB_CONFIG.TAB_DEPTH);
+        colXOffsets.push(colXOffsets[i] + colWidths[i] + boardGap);
       }
       unpositionedBoards.forEach((board, i) => {
         const col = i % gridCols;
@@ -14657,9 +14679,8 @@ var Panel = class extends Group6 {
       if (isFinite(minX)) {
         const boundsWidth = maxX - minX;
         const boundsHeight = maxY - minY;
-        const margin = TAB_CONFIG.TAB_DEPTH * 3;
-        const newPanelWidth = boundsWidth + 2 * margin;
-        const newPanelHeight = boundsHeight + 2 * margin;
+        const newPanelWidth = boundsWidth + 2 * DEFAULT_PANEL_MARGIN;
+        const newPanelHeight = boundsHeight + 2 * DEFAULT_PANEL_MARGIN;
         db.pcb_panel.update(this.pcb_panel_id, {
           width: newPanelWidth,
           height: newPanelHeight
@@ -14667,15 +14688,29 @@ var Panel = class extends Group6 {
       }
     }
     if (this._tabsAndMouseBitesGenerated) return;
-    const childBoardIds = childBoardInstances.map((c) => c.pcb_board_id).filter((id) => !!id);
-    const boardsInPanel = db.pcb_board.list().filter((b) => childBoardIds.includes(b.pcb_board_id));
-    if (boardsInPanel.length === 0) return;
-    const { tabCutouts, mouseBiteHoles } = generatePanelTabsAndMouseBites(boardsInPanel);
-    for (const tabCutout of tabCutouts) {
-      db.pcb_cutout.insert(tabCutout);
-    }
-    for (const mouseBiteHole of mouseBiteHoles) {
-      db.pcb_hole.insert(mouseBiteHole);
+    const props = this._parsedProps;
+    const panelizationMethod = props.panelizationMethod ?? "tab-routing";
+    if (panelizationMethod !== "none") {
+      const childBoardIds = childBoardInstances.map((c) => c.pcb_board_id).filter((id) => !!id);
+      const boardsInPanel = db.pcb_board.list().filter((b) => childBoardIds.includes(b.pcb_board_id));
+      if (boardsInPanel.length === 0) return;
+      const tabWidth = props.tabWidth ?? DEFAULT_TAB_WIDTH;
+      const boardGap = props.boardGap ?? tabWidth;
+      const { tabCutouts, mouseBiteHoles } = generatePanelTabsAndMouseBites(
+        boardsInPanel,
+        {
+          boardGap,
+          tabWidth,
+          tabLength: props.tabLength ?? DEFAULT_TAB_LENGTH,
+          mouseBites: props.mouseBites ?? true
+        }
+      );
+      for (const tabCutout of tabCutouts) {
+        db.pcb_cutout.insert(tabCutout);
+      }
+      for (const mouseBiteHole of mouseBiteHoles) {
+        db.pcb_hole.insert(mouseBiteHole);
+      }
     }
     this._tabsAndMouseBitesGenerated = true;
   }
@@ -18493,7 +18528,7 @@ import { identity as identity6 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.871",
+  version: "0.0.872",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -18537,7 +18572,7 @@ var package_default = {
     "@tscircuit/math-utils": "^0.0.29",
     "@tscircuit/miniflex": "^0.0.4",
     "@tscircuit/ngspice-spice-engine": "^0.0.3",
-    "@tscircuit/props": "^0.0.408",
+    "@tscircuit/props": "^0.0.409",
     "@tscircuit/schematic-autolayout": "^0.0.6",
     "@tscircuit/schematic-match-adapt": "^0.0.16",
     "@tscircuit/schematic-trace-solver": "^v0.0.45",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.872",
+  "version": "0.0.873",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -45,7 +45,7 @@
     "@tscircuit/math-utils": "^0.0.29",
     "@tscircuit/miniflex": "^0.0.4",
     "@tscircuit/ngspice-spice-engine": "^0.0.3",
-    "@tscircuit/props": "^0.0.408",
+    "@tscircuit/props": "^0.0.409",
     "@tscircuit/schematic-autolayout": "^0.0.6",
     "@tscircuit/schematic-match-adapt": "^0.0.16",
     "@tscircuit/schematic-trace-solver": "^v0.0.45",