jscad-electronics 0.0.212 → 0.0.214

package/dist/vanilla.d.ts

@@ -3,7 +3,7 @@ import { BufferGeometry } from 'three';
 import * as jscadModeling from '@jscad/modeling';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _jscad_modeling_src_geometries_types from '@jscad/modeling/src/geometries/types';
-import { BallBearingModelPropsInput, ButtonScrewModelPropsInput, CableGrommetModelPropsInput, ClampingShaftCollarModelPropsInput, CompressionSpringModelPropsInput, FlangedBushingModelPropsInput, FlatHeadScrewModelPropsInput, SpurGearModelPropsInput, HelicalGearModelPropsInput, HexBoltModelPropsInput, HexNutModelPropsInput, HexSocketBoltModelPropsInput, HollowPositioningArmTubeModelPropsInput, NemaMotorModelPropsInput, PanScrewModelPropsInput, PlainBushingModelPropsInput, RigidCouplerModelPropsInput, ShaftCollarModelPropsInput, SheetMetalModelPropsInput, ThreadedRodModelPropsInput, TSlotExtrusionModelPropsInput, TSlotGussetModelPropsInput, TSlotInsideCornerModelPropsInput, WormGearModelPropsInput } from '@tscircuit/modelprinter';
+import { BallBearingModelPropsInput, ButtonScrewModelPropsInput, CableGrommetModelPropsInput, ClampingShaftCollarModelPropsInput, CompressionSpringModelPropsInput, FlangedBushingModelPropsInput, FlatHeadScrewModelPropsInput, SpurGearModelPropsInput, HelicalGearModelPropsInput, HexBoltModelPropsInput, HexNutModelPropsInput, HexSocketBoltModelPropsInput, HollowPositioningArmTubeModelPropsInput, NemaMotorModelPropsInput, PanScrewModelPropsInput, PlainBushingModelPropsInput, RigidCouplerModelPropsInput, ShaftCollarModelPropsInput, SheetMetalModelPropsInput, ThreadedRodModelPropsInput, TorsionSpringModelPropsInput, TSlotExtrusionModelPropsInput, TSlotGussetModelPropsInput, TSlotInsideCornerModelPropsInput, WormGearModelPropsInput } from '@tscircuit/modelprinter';
 
 type VNode = {
     type: any;
@@ -372,6 +372,23 @@ type ThreadedRodProps = ThreadedRodModelPropsInput & {
 declare function createThreadedRodGeom(input: ThreadedRodModelPropsInput, resolution?: ThreadedRodMeshOptions): _jscad_modeling_src_geometries_types.Geom3;
 declare function ThreadedRod({ color, ...props }: ThreadedRodProps): react_jsx_runtime.JSX.Element;
 
+interface TorsionSpringMesh {
+    positions: number[];
+    indices: number[];
+}
+interface TorsionSpringMeshOptions {
+    segmentsPerTurn?: number;
+    wireSegments?: number;
+}
+/** Circular normal sections along the shared helix and its tangent legs. */
+declare function createTorsionSpringMesh(input: TorsionSpringModelPropsInput, options?: TorsionSpringMeshOptions): TorsionSpringMesh;
+
+type TorsionSpringProps = TorsionSpringModelPropsInput & {
+    color?: string;
+};
+declare function createTorsionSpringGeom(input: TorsionSpringModelPropsInput): _jscad_modeling_src_geometries_types.Geom3;
+declare function TorsionSpring({ color, ...props }: TorsionSpringProps): react_jsx_runtime.JSX.Element;
+
 interface TSlotExtrusionMesh {
     positions: number[];
     indices: number[];
@@ -445,4 +462,4 @@ declare function createJSCADRenderer(jscad: typeof jscadModeling): {
     };
 };
 
-export { BallBearing, type BallBearingMesh, type BallBearingMeshOptions, type BallBearingMeshPart, type BallBearingProps, ButtonScrew, type ButtonScrewMesh, type ButtonScrewMeshOptions, type ButtonScrewProps, CableGrommet, type CableGrommetMesh, type CableGrommetMeshOptions, type CableGrommetProps, ClampingShaftCollar, type ClampingShaftCollarMesh, type ClampingShaftCollarProps, type ColoredGeom, CompressionSpring, type CompressionSpringMesh, type CompressionSpringMeshOptions, type CompressionSpringProps, FlangedBushing, type FlangedBushingMesh, type FlangedBushingProps, FlatHeadScrew, type FlatHeadScrewMesh, type FlatHeadScrewMeshOptions, type FlatHeadScrewProps, Fragment, HelicalGear, type HelicalGearMesh, type HelicalGearProps, HexBolt, type HexBoltMesh, type HexBoltMeshOptions, type HexBoltProps, HexNut, type HexNutMesh, type HexNutMeshOptions, type HexNutProps, HexSocketBolt, type HexSocketBoltMesh, type HexSocketBoltProps, HollowPositioningArmTube, type HollowPositioningArmTubeMesh, type HollowPositioningArmTubeMeshOptions, type HollowPositioningArmTubeProps, NEMA17, NEMA23, NEMA8, type NemaFrameMotorProps, NemaMotor, type NemaMotorProps, PanScrew, type PanScrewMesh, type PanScrewMeshOptions, type PanScrewProps, PlainBushing, type PlainBushingMesh, type PlainBushingProps, type RenderResult, RigidCoupler, type RigidCouplerMesh, type RigidCouplerProps, ShaftCollar, type ShaftCollarMesh, type ShaftCollarProps, SheetMetal, type SheetMetalMesh, type SheetMetalProps, SpurGear, type SpurGearMesh, type SpurGearProps, TSlotExtrusion, type TSlotExtrusionMesh, type TSlotExtrusionProps, TSlotGusset, type TSlotGussetMesh, type TSlotGussetProps, TSlotInsideCorner, type TSlotInsideCornerMesh, type TSlotInsideCornerProps, ThreadedRod, type ThreadedRodMesh, type ThreadedRodMeshOptions, type ThreadedRodProps, type VNode, WormGear, type WormGearMesh, type WormGearProps, convertCSGToThreeGeom, createBallBearingGeom, createBallBearingMesh, createButtonScrewGeom, createButtonScrewMesh, createCableGrommetGeom, createCableGrommetMesh, createClampingShaftCollarGeom, createClampingShaftCollarMesh, createCompressionSpringGeom, createCompressionSpringMesh, createFlangedBushingGeom, createFlangedBushingMesh, createFlatHeadScrewGeom, createFlatHeadScrewMesh, createHelicalGearGeom, createHelicalGearMesh, createHexBoltGeom, createHexBoltMesh, createHexNutGeom, createHexNutMesh, createHexSocketBoltGeom, createHexSocketBoltMesh, createHollowPositioningArmTubeGeom, createHollowPositioningArmTubeMesh, createJSCADRenderer, createPanScrewGeom, createPanScrewMesh, createPlainBushingGeom, createPlainBushingMesh, createRigidCouplerGeom, createRigidCouplerMesh, createShaftCollarGeom, createShaftCollarMesh, createSheetMetalGeom, createSheetMetalMesh, createSpurGearGeom, createSpurGearMesh, createTSlotExtrusionGeom, createTSlotExtrusionMesh, createTSlotGussetGeom, createTSlotGussetMesh, createTSlotInsideCornerGeom, createTSlotInsideCornerMesh, createThreadedRodGeom, createThreadedRodMesh, createWormGearGeom, createWormGearMesh, getJscadModelForFootprint, getJscadModelForFootprintWithPads, h };
+export { BallBearing, type BallBearingMesh, type BallBearingMeshOptions, type BallBearingMeshPart, type BallBearingProps, ButtonScrew, type ButtonScrewMesh, type ButtonScrewMeshOptions, type ButtonScrewProps, CableGrommet, type CableGrommetMesh, type CableGrommetMeshOptions, type CableGrommetProps, ClampingShaftCollar, type ClampingShaftCollarMesh, type ClampingShaftCollarProps, type ColoredGeom, CompressionSpring, type CompressionSpringMesh, type CompressionSpringMeshOptions, type CompressionSpringProps, FlangedBushing, type FlangedBushingMesh, type FlangedBushingProps, FlatHeadScrew, type FlatHeadScrewMesh, type FlatHeadScrewMeshOptions, type FlatHeadScrewProps, Fragment, HelicalGear, type HelicalGearMesh, type HelicalGearProps, HexBolt, type HexBoltMesh, type HexBoltMeshOptions, type HexBoltProps, HexNut, type HexNutMesh, type HexNutMeshOptions, type HexNutProps, HexSocketBolt, type HexSocketBoltMesh, type HexSocketBoltProps, HollowPositioningArmTube, type HollowPositioningArmTubeMesh, type HollowPositioningArmTubeMeshOptions, type HollowPositioningArmTubeProps, NEMA17, NEMA23, NEMA8, type NemaFrameMotorProps, NemaMotor, type NemaMotorProps, PanScrew, type PanScrewMesh, type PanScrewMeshOptions, type PanScrewProps, PlainBushing, type PlainBushingMesh, type PlainBushingProps, type RenderResult, RigidCoupler, type RigidCouplerMesh, type RigidCouplerProps, ShaftCollar, type ShaftCollarMesh, type ShaftCollarProps, SheetMetal, type SheetMetalMesh, type SheetMetalProps, SpurGear, type SpurGearMesh, type SpurGearProps, TSlotExtrusion, type TSlotExtrusionMesh, type TSlotExtrusionProps, TSlotGusset, type TSlotGussetMesh, type TSlotGussetProps, TSlotInsideCorner, type TSlotInsideCornerMesh, type TSlotInsideCornerProps, ThreadedRod, type ThreadedRodMesh, type ThreadedRodMeshOptions, type ThreadedRodProps, TorsionSpring, type TorsionSpringMesh, type TorsionSpringMeshOptions, type TorsionSpringProps, type VNode, WormGear, type WormGearMesh, type WormGearProps, convertCSGToThreeGeom, createBallBearingGeom, createBallBearingMesh, createButtonScrewGeom, createButtonScrewMesh, createCableGrommetGeom, createCableGrommetMesh, createClampingShaftCollarGeom, createClampingShaftCollarMesh, createCompressionSpringGeom, createCompressionSpringMesh, createFlangedBushingGeom, createFlangedBushingMesh, createFlatHeadScrewGeom, createFlatHeadScrewMesh, createHelicalGearGeom, createHelicalGearMesh, createHexBoltGeom, createHexBoltMesh, createHexNutGeom, createHexNutMesh, createHexSocketBoltGeom, createHexSocketBoltMesh, createHollowPositioningArmTubeGeom, createHollowPositioningArmTubeMesh, createJSCADRenderer, createPanScrewGeom, createPanScrewMesh, createPlainBushingGeom, createPlainBushingMesh, createRigidCouplerGeom, createRigidCouplerMesh, createShaftCollarGeom, createShaftCollarMesh, createSheetMetalGeom, createSheetMetalMesh, createSpurGearGeom, createSpurGearMesh, createTSlotExtrusionGeom, createTSlotExtrusionMesh, createTSlotGussetGeom, createTSlotGussetMesh, createTSlotInsideCornerGeom, createTSlotInsideCornerMesh, createThreadedRodGeom, createThreadedRodMesh, createTorsionSpringGeom, createTorsionSpringMesh, createWormGearGeom, createWormGearMesh, getJscadModelForFootprint, getJscadModelForFootprintWithPads, h };

package/dist/vanilla.js

@@ -183,24 +183,24 @@ var FootprintPlatedHole = ({
 import { ballBearingModelDefinitionSchema } from "@tscircuit/modelprinter";
 
 // lib/model-registry.ts
-function defineModelRenderer(model26) {
-  return model26;
+function defineModelRenderer(model27) {
+  return model27;
 }
 var ModelRendererRegistry = class {
   models = /* @__PURE__ */ new Map();
-  register(model26) {
-    if (typeof model26.name !== "string" || !/^[a-z]+$/.test(model26.name)) {
+  register(model27) {
+    if (typeof model27.name !== "string" || !/^[a-z]+$/.test(model27.name)) {
       throw new Error(
         "Model renderer names must contain only lowercase letters"
       );
     }
-    if (this.models.has(model26.name)) {
-      throw new Error(`Model renderer "${model26.name}" is already registered`);
+    if (this.models.has(model27.name)) {
+      throw new Error(`Model renderer "${model27.name}" is already registered`);
     }
-    if (model26.pads !== "none" && model26.pads !== "footprinter") {
+    if (model27.pads !== "none" && model27.pads !== "footprinter") {
       throw new Error('Model renderer pads must be "none" or "footprinter"');
     }
-    const { name, schema, render: render2, pads } = model26;
+    const { name, schema, render: render2, pads } = model27;
     this.models.set(name, {
       name,
       schema,
@@ -3827,6 +3827,110 @@ function register21(registry) {
   registry.register(model21);
 }
 
+// lib/models/torsionspring/register.tsx
+import { torsionSpringModelDefinitionSchema } from "@tscircuit/modelprinter";
+
+// lib/models/torsionspring/mesh.ts
+import {
+  torsionSpringModelPropsSchema,
+  getTorsionSpringDimensions,
+  getTorsionSpringFrame
+} from "@tscircuit/modelprinter";
+function createTorsionSpringMesh(input, options = {}) {
+  const p = torsionSpringModelPropsSchema.parse(input), d = getTorsionSpringDimensions(p);
+  const segmentsPerTurn = options.segmentsPerTurn ?? 64, wireSegments = options.wireSegments ?? 24;
+  for (const [name, value, minimum, maximum] of [
+    ["segmentsPerTurn", segmentsPerTurn, 16, 256],
+    ["wireSegments", wireSegments, 8, 64]
+  ])
+    if (!Number.isInteger(value) || value < minimum || value > maximum || value % 4 !== 0)
+      throw new Error(
+        `${name} must be a multiple of four in [${minimum},${maximum}]`
+      );
+  const steps = Math.ceil(p.turns * segmentsPerTurn);
+  if ((steps + 3) * wireSegments + 2 > 25e4)
+    throw new Error("Spring exceeds mesh resolution limit (250000 vertices)");
+  const scale = Math.max(
+    p.outerDiameter,
+    d.axialAdvance,
+    p.startLegLength,
+    p.endLegLength
+  );
+  if (Math.min(
+    p.wireDiameter,
+    p.startLegLength,
+    p.endLegLength,
+    d.insideDiameter,
+    p.pitch - p.wireDiameter
+  ) <= scale * 1e-10)
+    throw new Error("Spring clearance exceeds mesh resolution limits");
+  const distances = [
+    0,
+    ...Array.from(
+      { length: steps + 1 },
+      (_, i) => p.startLegLength + d.coilLength * i / steps
+    ),
+    d.centerlineLength
+  ];
+  const frameProps = { ...p, leftHand: false };
+  const positions = [], indices = [];
+  for (const distance2 of distances) {
+    const f = getTorsionSpringFrame(frameProps, distance2);
+    for (let j = 0; j < wireSegments; j++) {
+      const angle = 2 * Math.PI * j / wireSegments;
+      const c = j === wireSegments / 4 || j === 3 * wireSegments / 4 ? 0 : Math.cos(angle);
+      const s = j === 0 || j === wireSegments / 2 ? 0 : Math.sin(angle);
+      for (let axis = 0; axis < 3; axis++)
+        positions.push(
+          f.position[axis] + p.wireDiameter / 2 * (f.normal[axis] * c + f.binormal[axis] * s)
+        );
+    }
+  }
+  for (let i = 0; i < distances.length - 1; i++)
+    for (let j = 0; j < wireSegments; j++) {
+      const n = (j + 1) % wireSegments, a = i * wireSegments, b = (i + 1) * wireSegments;
+      indices.push(a + j, a + n, b + j, a + n, b + n, b + j);
+    }
+  const firstCenter = positions.length / 3;
+  positions.push(
+    ...getTorsionSpringFrame(frameProps, 0).position,
+    ...getTorsionSpringFrame(frameProps, d.centerlineLength).position
+  );
+  const end = (distances.length - 1) * wireSegments;
+  for (let j = 0; j < wireSegments; j++) {
+    const n = (j + 1) % wireSegments;
+    indices.push(firstCenter, n, j, firstCenter + 1, end + j, end + n);
+  }
+  if (p.leftHand) {
+    for (let i = 1; i < positions.length; i += 3) positions[i] = -positions[i];
+    for (let i = 0; i < indices.length; i += 3)
+      [indices[i + 1], indices[i + 2]] = [indices[i + 2], indices[i + 1]];
+  }
+  return { positions, indices };
+}
+
+// lib/models/torsionspring/TorsionSpring.tsx
+function createTorsionSpringGeom(input) {
+  return indexedMeshToGeom3(createTorsionSpringMesh(input));
+}
+function TorsionSpring({
+  color = "#929ba6",
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(Colorize, { color, children: /* @__PURE__ */ jsx(Custom, { geometry: createTorsionSpringGeom(props) }) });
+}
+
+// lib/models/torsionspring/register.tsx
+var model22 = defineModelRenderer({
+  name: "torsionspring",
+  schema: torsionSpringModelDefinitionSchema,
+  render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TorsionSpring, { ...props }),
+  pads: "none"
+});
+function register22(registry) {
+  registry.register(model22);
+}
+
 // lib/models/tslotextrusion/register.tsx
 import { tSlotExtrusionModelDefinitionSchema } from "@tscircuit/modelprinter";
 
@@ -3974,14 +4078,14 @@ function TSlotExtrusion({
 }
 
 // lib/models/tslotextrusion/register.tsx
-var model22 = defineModelRenderer({
+var model23 = defineModelRenderer({
   name: "tslotextrusion",
   schema: tSlotExtrusionModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TSlotExtrusion, { ...props }),
   pads: "none"
 });
-function register22(registry) {
-  registry.register(model22);
+function register23(registry) {
+  registry.register(model23);
 }
 
 // lib/models/tslotgusset/register.tsx
@@ -4034,14 +4138,14 @@ function TSlotGusset({ color = "#8995a3", ...props }) {
 }
 
 // lib/models/tslotgusset/register.tsx
-var model23 = defineModelRenderer({
+var model24 = defineModelRenderer({
   name: "tslotgusset",
   schema: tSlotGussetModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TSlotGusset, { ...props }),
   pads: "none"
 });
-function register23(registry) {
-  registry.register(model23);
+function register24(registry) {
+  registry.register(model24);
 }
 
 // lib/models/tslotinsidecorner/register.tsx
@@ -4121,14 +4225,14 @@ function TSlotInsideCorner({
 }
 
 // lib/models/tslotinsidecorner/register.tsx
-var model24 = defineModelRenderer({
+var model25 = defineModelRenderer({
   name: "tslotinsidecorner",
   schema: tSlotInsideCornerModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TSlotInsideCorner, { ...props }),
   pads: "none"
 });
-function register24(registry) {
-  registry.register(model24);
+function register25(registry) {
+  registry.register(model25);
 }
 
 // lib/models/wormgear/register.tsx
@@ -4320,14 +4424,14 @@ function WormGear({ color = "#737e8f", ...props }) {
 }
 
 // lib/models/wormgear/register.tsx
-var model25 = defineModelRenderer({
+var model26 = defineModelRenderer({
   name: "wormgear",
   schema: wormGearModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(WormGear, { ...props }),
   pads: "none"
 });
-function register25(registry) {
-  registry.register(model25);
+function register26(registry) {
+  registry.register(model26);
 }
 
 // lib/generated/model-renderers.ts
@@ -4357,6 +4461,7 @@ function registerAllModelRenderers(registry) {
   register23(registry);
   register24(registry);
   register25(registry);
+  register26(registry);
 }
 
 // lib/default-model-registry.ts
@@ -11913,10 +12018,10 @@ var SOT143 = ({ footprint = "sot143" }) => {
 var Footprinter3d = ({ footprint }) => {
   const modelFn = mp3.string(footprint.split("_", 1)[0]).params().fn;
   if (mp3.getModelNames().includes(modelFn)) {
-    const model26 = mp3.string(footprint).json();
-    const renderer = modelRendererRegistry.get(model26.fn);
+    const model27 = mp3.string(footprint).json();
+    const renderer = modelRendererRegistry.get(model27.fn);
     if (renderer) {
-      return renderer.render(model26);
+      return renderer.render(model27);
     }
   }
   let normalizedFootprint = footprint;
@@ -12894,6 +12999,7 @@ export {
   TSlotGusset,
   TSlotInsideCorner,
   ThreadedRod,
+  TorsionSpring,
   WormGear,
   convertCSGToThreeGeom,
   createBallBearingGeom,
@@ -12941,6 +13047,8 @@ export {
   createTSlotInsideCornerMesh,
   createThreadedRodGeom,
   createThreadedRodMesh,
+  createTorsionSpringGeom,
+  createTorsionSpringMesh,
   createWormGearGeom,
   createWormGearMesh,
   getJscadModelForFootprint,