jscad-electronics 0.0.208 → 0.0.209

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 { ButtonScrewModelPropsInput, CableGrommetModelPropsInput, ClampingShaftCollarModelPropsInput, CompressionSpringModelPropsInput, FlangedBushingModelPropsInput, FlatHeadScrewModelPropsInput, SpurGearModelPropsInput, HelicalGearModelPropsInput, HexBoltModelPropsInput, HexNutModelPropsInput, HexSocketBoltModelPropsInput, NemaMotorModelPropsInput, PanScrewModelPropsInput, PlainBushingModelPropsInput, RigidCouplerModelPropsInput, ShaftCollarModelPropsInput, SheetMetalModelPropsInput, TSlotExtrusionModelPropsInput, TSlotGussetModelPropsInput, TSlotInsideCornerModelPropsInput, WormGearModelPropsInput } from '@tscircuit/modelprinter';
+import { ButtonScrewModelPropsInput, CableGrommetModelPropsInput, ClampingShaftCollarModelPropsInput, CompressionSpringModelPropsInput, FlangedBushingModelPropsInput, FlatHeadScrewModelPropsInput, SpurGearModelPropsInput, HelicalGearModelPropsInput, HexBoltModelPropsInput, HexNutModelPropsInput, HexSocketBoltModelPropsInput, NemaMotorModelPropsInput, PanScrewModelPropsInput, PlainBushingModelPropsInput, RigidCouplerModelPropsInput, ShaftCollarModelPropsInput, SheetMetalModelPropsInput, ThreadedRodModelPropsInput, TSlotExtrusionModelPropsInput, TSlotGussetModelPropsInput, TSlotInsideCornerModelPropsInput, WormGearModelPropsInput } from '@tscircuit/modelprinter';
 
 type VNode = {
     type: any;
@@ -307,6 +307,25 @@ type SpurGearProps = SpurGearModelPropsInput & {
 declare function createSpurGearGeom(input: SpurGearModelPropsInput): _jscad_modeling_src_geometries_types.Geom3;
 declare function SpurGear({ color, ...props }: SpurGearProps): react_jsx_runtime.JSX.Element;
 
+/** Indexed counterclockwise triangles in millimeters. */
+interface ThreadedRodMesh {
+    positions: number[];
+    indices: number[];
+}
+/** Renderer resolution affects tessellation only, never model specifications. */
+interface ThreadedRodMeshOptions {
+    radialSegments?: number;
+    segmentsPerPitch?: number;
+}
+/** Full single-start external thread, phase +X at z=0, flat chamfered ends. */
+declare function createThreadedRodMesh(input: ThreadedRodModelPropsInput, options?: ThreadedRodMeshOptions): ThreadedRodMesh;
+
+type ThreadedRodProps = ThreadedRodModelPropsInput & {
+    color?: string;
+};
+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 TSlotExtrusionMesh {
     positions: number[];
     indices: number[];
@@ -380,4 +399,4 @@ declare function createJSCADRenderer(jscad: typeof jscadModeling): {
     };
 };
 
-export { 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, 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, type VNode, WormGear, type WormGearMesh, type WormGearProps, convertCSGToThreeGeom, createButtonScrewGeom, createButtonScrewMesh, createCableGrommetGeom, createCableGrommetMesh, createClampingShaftCollarGeom, createClampingShaftCollarMesh, createCompressionSpringGeom, createCompressionSpringMesh, createFlangedBushingGeom, createFlangedBushingMesh, createFlatHeadScrewGeom, createFlatHeadScrewMesh, createHelicalGearGeom, createHelicalGearMesh, createHexBoltGeom, createHexBoltMesh, createHexNutGeom, createHexNutMesh, createHexSocketBoltGeom, createHexSocketBoltMesh, createJSCADRenderer, createPanScrewGeom, createPanScrewMesh, createPlainBushingGeom, createPlainBushingMesh, createRigidCouplerGeom, createRigidCouplerMesh, createShaftCollarGeom, createShaftCollarMesh, createSheetMetalGeom, createSheetMetalMesh, createSpurGearGeom, createSpurGearMesh, createTSlotExtrusionGeom, createTSlotExtrusionMesh, createTSlotGussetGeom, createTSlotGussetMesh, createTSlotInsideCornerGeom, createTSlotInsideCornerMesh, createWormGearGeom, createWormGearMesh, getJscadModelForFootprint, getJscadModelForFootprintWithPads, h };
+export { 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, 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, createButtonScrewGeom, createButtonScrewMesh, createCableGrommetGeom, createCableGrommetMesh, createClampingShaftCollarGeom, createClampingShaftCollarMesh, createCompressionSpringGeom, createCompressionSpringMesh, createFlangedBushingGeom, createFlangedBushingMesh, createFlatHeadScrewGeom, createFlatHeadScrewMesh, createHelicalGearGeom, createHelicalGearMesh, createHexBoltGeom, createHexBoltMesh, createHexNutGeom, createHexNutMesh, createHexSocketBoltGeom, createHexSocketBoltMesh, 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 };

package/dist/vanilla.js

@@ -183,24 +183,24 @@ var FootprintPlatedHole = ({
 import { buttonScrewModelDefinitionSchema } from "@tscircuit/modelprinter";
 
 // lib/model-registry.ts
-function defineModelRenderer(model23) {
-  return model23;
+function defineModelRenderer(model24) {
+  return model24;
 }
 var ModelRendererRegistry = class {
   models = /* @__PURE__ */ new Map();
-  register(model23) {
-    if (typeof model23.name !== "string" || !/^[a-z]+$/.test(model23.name)) {
+  register(model24) {
+    if (typeof model24.name !== "string" || !/^[a-z]+$/.test(model24.name)) {
       throw new Error(
         "Model renderer names must contain only lowercase letters"
       );
     }
-    if (this.models.has(model23.name)) {
-      throw new Error(`Model renderer "${model23.name}" is already registered`);
+    if (this.models.has(model24.name)) {
+      throw new Error(`Model renderer "${model24.name}" is already registered`);
     }
-    if (model23.pads !== "none" && model23.pads !== "footprinter") {
+    if (model24.pads !== "none" && model24.pads !== "footprinter") {
       throw new Error('Model renderer pads must be "none" or "footprinter"');
     }
-    const { name, schema, render: render2, pads } = model23;
+    const { name, schema, render: render2, pads } = model24;
     this.models.set(name, {
       name,
       schema,
@@ -354,8 +354,8 @@ function indexedMeshToGeom3(mesh) {
 }
 
 // lib/models/buttonscrew/ButtonScrew.tsx
-function createButtonScrewGeom(input, resolution3) {
-  return indexedMeshToGeom3(createButtonScrewMesh(input, resolution3));
+function createButtonScrewGeom(input, resolution4) {
+  return indexedMeshToGeom3(createButtonScrewMesh(input, resolution4));
 }
 function ButtonScrew({ color = "#737e8f", ...props }) {
   return /* @__PURE__ */ jsx(Colorize, { color, children: /* @__PURE__ */ jsx(Custom, { geometry: createButtonScrewGeom(props) }) });
@@ -2336,8 +2336,8 @@ function createHexNutMesh(input, options = {}) {
 }
 
 // lib/models/hexnut/HexNut.tsx
-function createHexNutGeom(input, resolution3) {
-  return indexedMeshToGeom3(createHexNutMesh(input, resolution3));
+function createHexNutGeom(input, resolution4) {
+  return indexedMeshToGeom3(createHexNutMesh(input, resolution4));
 }
 function HexNut({ color = "#737e8f", ...props }) {
   return /* @__PURE__ */ jsx(Colorize, { color, children: /* @__PURE__ */ jsx(Custom, { geometry: createHexNutGeom(props) }) });
@@ -3324,6 +3324,115 @@ function register18(registry) {
   registry.register(model18);
 }
 
+// lib/models/threadedrod/register.tsx
+import { threadedRodModelDefinitionSchema } from "@tscircuit/modelprinter";
+
+// lib/models/threadedrod/mesh.ts
+import {
+  threadedRodModelPropsSchema,
+  getThreadedRodDimensions
+} from "@tscircuit/modelprinter";
+function resolution3(options) {
+  const radial = options.radialSegments ?? 96;
+  const axial = options.segmentsPerPitch ?? 32;
+  if (!Number.isInteger(radial) || radial < 24 || radial > 192 || radial % 12 !== 0 || !Number.isInteger(axial) || axial < 8 || axial > 64)
+    throw new Error(
+      "Mesh resolution limit: radial segments must be a multiple of 12 in [24,192], pitch segments an integer in [8,64]"
+    );
+  return { radial, axial };
+}
+function surface3(segments) {
+  const positions = [], indices = [];
+  const ring = (z, radius) => {
+    const start = positions.length / 3;
+    for (let i = 0; i < segments; i++) {
+      const angle = i * 2 * Math.PI / segments;
+      const r = radius(angle);
+      positions.push(r * Math.cos(angle), r * Math.sin(angle), z);
+    }
+    return start;
+  };
+  const connect = (a, b) => {
+    for (let i = 0; i < segments; i++) {
+      const n = (i + 1) % segments;
+      indices.push(a + i, a + n, b + n, a + i, b + n, b + i);
+    }
+  };
+  const cap = (start, z, up) => {
+    const center = positions.length / 3;
+    positions.push(0, 0, z);
+    for (let i = 0; i < segments; i++) {
+      const n = (i + 1) % segments;
+      indices.push(center, start + (up ? i : n), start + (up ? n : i));
+    }
+  };
+  return { positions, indices, ring, connect, cap };
+}
+function threadDistance3(z, angle, pitch, hand = 1) {
+  const phase = ((z / pitch - hand * angle / (2 * Math.PI)) % 1 + 1) % 1;
+  return Math.min(phase, 1 - phase);
+}
+function createThreadedRodMesh(input, options = {}) {
+  const props = threadedRodModelPropsSchema.parse(input);
+  const d = getThreadedRodDimensions(input);
+  const { radial, axial } = resolution3(options);
+  const steps = Math.max(2, Math.ceil(d.length / d.threadPitch * axial));
+  if (steps > 24e3 || !Number.isFinite(steps) || Math.min(d.minorDiameter, d.endDiameter) < d.diameter * 1e-8)
+    throw new Error(
+      "Mesh resolution limit: excessive turns or vanishing end/root radius"
+    );
+  const m = surface3(radial);
+  const levels = new Set(
+    Array.from({ length: steps + 1 }, (_, i) => d.length * i / steps)
+  );
+  levels.add(props.chamfer);
+  levels.add(d.length - props.chamfer);
+  const radius = d.diameter / 2, depth = (d.diameter - d.minorDiameter) / 2;
+  let previous = -1;
+  for (const z of [...levels].sort((a, b) => a - b)) {
+    const current = m.ring(z, (angle) => {
+      const groove = Math.min(
+        depth,
+        Math.max(
+          0,
+          (threadDistance3(
+            z,
+            angle,
+            d.threadPitch,
+            props.threadHand === "right" ? 1 : -1
+          ) - 1 / 16) * d.threadPitch * Math.sqrt(3)
+        )
+      );
+      const chamfer = radius - Math.max(0, props.chamfer - Math.min(z, d.length - z));
+      return Math.min(radius - groove, chamfer);
+    });
+    if (previous < 0) m.cap(current, z, false);
+    else m.connect(previous, current);
+    previous = current;
+  }
+  m.cap(previous, d.length, true);
+  return { positions: m.positions, indices: m.indices };
+}
+
+// lib/models/threadedrod/ThreadedRod.tsx
+function createThreadedRodGeom(input, resolution4) {
+  return indexedMeshToGeom3(createThreadedRodMesh(input, resolution4));
+}
+function ThreadedRod({ color = "#737e8f", ...props }) {
+  return /* @__PURE__ */ jsx(Colorize, { color, children: /* @__PURE__ */ jsx(Custom, { geometry: createThreadedRodGeom(props) }) });
+}
+
+// lib/models/threadedrod/register.tsx
+var model19 = defineModelRenderer({
+  name: "threadedrod",
+  schema: threadedRodModelDefinitionSchema,
+  render: ({ fn, ...props }) => /* @__PURE__ */ jsx(ThreadedRod, { ...props }),
+  pads: "none"
+});
+function register19(registry) {
+  registry.register(model19);
+}
+
 // lib/models/tslotextrusion/register.tsx
 import { tSlotExtrusionModelDefinitionSchema } from "@tscircuit/modelprinter";
 
@@ -3471,14 +3580,14 @@ function TSlotExtrusion({
 }
 
 // lib/models/tslotextrusion/register.tsx
-var model19 = defineModelRenderer({
+var model20 = defineModelRenderer({
   name: "tslotextrusion",
   schema: tSlotExtrusionModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TSlotExtrusion, { ...props }),
   pads: "none"
 });
-function register19(registry) {
-  registry.register(model19);
+function register20(registry) {
+  registry.register(model20);
 }
 
 // lib/models/tslotgusset/register.tsx
@@ -3531,14 +3640,14 @@ function TSlotGusset({ color = "#8995a3", ...props }) {
 }
 
 // lib/models/tslotgusset/register.tsx
-var model20 = defineModelRenderer({
+var model21 = defineModelRenderer({
   name: "tslotgusset",
   schema: tSlotGussetModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TSlotGusset, { ...props }),
   pads: "none"
 });
-function register20(registry) {
-  registry.register(model20);
+function register21(registry) {
+  registry.register(model21);
 }
 
 // lib/models/tslotinsidecorner/register.tsx
@@ -3618,14 +3727,14 @@ function TSlotInsideCorner({
 }
 
 // lib/models/tslotinsidecorner/register.tsx
-var model21 = defineModelRenderer({
+var model22 = defineModelRenderer({
   name: "tslotinsidecorner",
   schema: tSlotInsideCornerModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(TSlotInsideCorner, { ...props }),
   pads: "none"
 });
-function register21(registry) {
-  registry.register(model21);
+function register22(registry) {
+  registry.register(model22);
 }
 
 // lib/models/wormgear/register.tsx
@@ -3817,14 +3926,14 @@ function WormGear({ color = "#737e8f", ...props }) {
 }
 
 // lib/models/wormgear/register.tsx
-var model22 = defineModelRenderer({
+var model23 = defineModelRenderer({
   name: "wormgear",
   schema: wormGearModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(WormGear, { ...props }),
   pads: "none"
 });
-function register22(registry) {
-  registry.register(model22);
+function register23(registry) {
+  registry.register(model23);
 }
 
 // lib/generated/model-renderers.ts
@@ -3851,6 +3960,7 @@ function registerAllModelRenderers(registry) {
   register20(registry);
   register21(registry);
   register22(registry);
+  register23(registry);
 }
 
 // lib/default-model-registry.ts
@@ -11407,10 +11517,10 @@ var SOT143 = ({ footprint = "sot143" }) => {
 var Footprinter3d = ({ footprint }) => {
   const modelFn = mp3.string(footprint.split("_", 1)[0]).params().fn;
   if (mp3.getModelNames().includes(modelFn)) {
-    const model23 = mp3.string(footprint).json();
-    const renderer = modelRendererRegistry.get(model23.fn);
+    const model24 = mp3.string(footprint).json();
+    const renderer = modelRendererRegistry.get(model24.fn);
     if (renderer) {
-      return renderer.render(model23);
+      return renderer.render(model24);
     }
   }
   let normalizedFootprint = footprint;
@@ -12385,6 +12495,7 @@ export {
   TSlotExtrusion,
   TSlotGusset,
   TSlotInsideCorner,
+  ThreadedRod,
   WormGear,
   convertCSGToThreeGeom,
   createButtonScrewGeom,
@@ -12426,6 +12537,8 @@ export {
   createTSlotGussetMesh,
   createTSlotInsideCornerGeom,
   createTSlotInsideCornerMesh,
+  createThreadedRodGeom,
+  createThreadedRodMesh,
   createWormGearGeom,
   createWormGearMesh,
   getJscadModelForFootprint,