jscad-electronics 0.0.199 → 0.0.200

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, FlangedBushingModelPropsInput, FlatHeadScrewModelPropsInput, SpurGearModelPropsInput, HelicalGearModelPropsInput, HexBoltModelPropsInput, HexSocketBoltModelPropsInput, NemaMotorModelPropsInput, PanScrewModelPropsInput, PlainBushingModelPropsInput, SheetMetalModelPropsInput, WormGearModelPropsInput } from '@tscircuit/modelprinter';
+import { ButtonScrewModelPropsInput, FlangedBushingModelPropsInput, FlatHeadScrewModelPropsInput, SpurGearModelPropsInput, HelicalGearModelPropsInput, HexBoltModelPropsInput, HexNutModelPropsInput, HexSocketBoltModelPropsInput, NemaMotorModelPropsInput, PanScrewModelPropsInput, PlainBushingModelPropsInput, SheetMetalModelPropsInput, WormGearModelPropsInput } from '@tscircuit/modelprinter';
 
 type VNode = {
     type: any;
@@ -123,6 +123,25 @@ type HexBoltProps = HexBoltModelPropsInput & {
 declare function createHexBoltGeom(input: HexBoltModelPropsInput, options?: HexBoltMeshOptions): _jscad_modeling_src_geometries_types.Geom3;
 declare function HexBolt({ color, ...props }: HexBoltProps): react_jsx_runtime.JSX.Element;
 
+/** Indexed counterclockwise triangles in millimeters. */
+interface HexNutMesh {
+    positions: number[];
+    indices: number[];
+}
+/** Renderer resolution affects tessellation only, never model specifications. */
+interface HexNutMeshOptions {
+    radialSegments?: number;
+    segmentsPerPitch?: number;
+}
+/** Closed annular surface with a through internal thread and both conical mouths. */
+declare function createHexNutMesh(input: HexNutModelPropsInput, options?: HexNutMeshOptions): HexNutMesh;
+
+type HexNutProps = HexNutModelPropsInput & {
+    color?: string;
+};
+declare function createHexNutGeom(input: HexNutModelPropsInput, resolution?: HexNutMeshOptions): _jscad_modeling_src_geometries_types.Geom3;
+declare function HexNut({ color, ...props }: HexNutProps): react_jsx_runtime.JSX.Element;
+
 /** Indexed triangles, counterclockwise from outside; millimeters, Z up. */
 interface HexSocketBoltMesh {
     positions: number[];
@@ -244,4 +263,4 @@ declare function createJSCADRenderer(jscad: typeof jscadModeling): {
     };
 };
 
-export { ButtonScrew, type ButtonScrewMesh, type ButtonScrewMeshOptions, type ButtonScrewProps, type ColoredGeom, 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, 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, SheetMetal, type SheetMetalMesh, type SheetMetalProps, SpurGear, type SpurGearMesh, type SpurGearProps, type VNode, WormGear, type WormGearMesh, type WormGearProps, convertCSGToThreeGeom, createButtonScrewGeom, createButtonScrewMesh, createFlangedBushingGeom, createFlangedBushingMesh, createFlatHeadScrewGeom, createFlatHeadScrewMesh, createHelicalGearGeom, createHelicalGearMesh, createHexBoltGeom, createHexBoltMesh, createHexSocketBoltGeom, createHexSocketBoltMesh, createJSCADRenderer, createPanScrewGeom, createPanScrewMesh, createPlainBushingGeom, createPlainBushingMesh, createSheetMetalGeom, createSheetMetalMesh, createSpurGearGeom, createSpurGearMesh, createWormGearGeom, createWormGearMesh, getJscadModelForFootprint, getJscadModelForFootprintWithPads, h };
+export { ButtonScrew, type ButtonScrewMesh, type ButtonScrewMeshOptions, type ButtonScrewProps, type ColoredGeom, 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, SheetMetal, type SheetMetalMesh, type SheetMetalProps, SpurGear, type SpurGearMesh, type SpurGearProps, type VNode, WormGear, type WormGearMesh, type WormGearProps, convertCSGToThreeGeom, createButtonScrewGeom, createButtonScrewMesh, createFlangedBushingGeom, createFlangedBushingMesh, createFlatHeadScrewGeom, createFlatHeadScrewMesh, createHelicalGearGeom, createHelicalGearMesh, createHexBoltGeom, createHexBoltMesh, createHexNutGeom, createHexNutMesh, createHexSocketBoltGeom, createHexSocketBoltMesh, createJSCADRenderer, createPanScrewGeom, createPanScrewMesh, createPlainBushingGeom, createPlainBushingMesh, createSheetMetalGeom, createSheetMetalMesh, createSpurGearGeom, createSpurGearMesh, 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(model14) {
-  return model14;
+function defineModelRenderer(model15) {
+  return model15;
 }
 var ModelRendererRegistry = class {
   models = /* @__PURE__ */ new Map();
-  register(model14) {
-    if (typeof model14.name !== "string" || !/^[a-z]+$/.test(model14.name)) {
+  register(model15) {
+    if (typeof model15.name !== "string" || !/^[a-z]+$/.test(model15.name)) {
       throw new Error(
         "Model renderer names must contain only lowercase letters"
       );
     }
-    if (this.models.has(model14.name)) {
-      throw new Error(`Model renderer "${model14.name}" is already registered`);
+    if (this.models.has(model15.name)) {
+      throw new Error(`Model renderer "${model15.name}" is already registered`);
     }
-    if (model14.pads !== "none" && model14.pads !== "footprinter") {
+    if (model15.pads !== "none" && model15.pads !== "footprinter") {
       throw new Error('Model renderer pads must be "none" or "footprinter"');
     }
-    const { name, schema, render: render2, pads } = model14;
+    const { name, schema, render: render2, pads } = model15;
     this.models.set(name, {
       name,
       schema,
@@ -354,8 +354,8 @@ function indexedMeshToGeom3(mesh) {
 }
 
 // lib/models/buttonscrew/ButtonScrew.tsx
-function createButtonScrewGeom(input, resolution2) {
-  return indexedMeshToGeom3(createButtonScrewMesh(input, resolution2));
+function createButtonScrewGeom(input, resolution3) {
+  return indexedMeshToGeom3(createButtonScrewMesh(input, resolution3));
 }
 function ButtonScrew({ color = "#737e8f", ...props }) {
   return /* @__PURE__ */ jsx(Colorize, { color, children: /* @__PURE__ */ jsx(Custom, { geometry: createButtonScrewGeom(props) }) });
@@ -541,14 +541,14 @@ function createFlatHeadScrewMesh(input, options = {}) {
       filletCenterZ + p.underHeadRadius * Math.sin(angle)
     );
   }
-  const hexRadius2 = (theta) => p.socketAcrossFlats / 2 / Math.max(
+  const hexRadius3 = (theta) => p.socketAcrossFlats / 2 / Math.max(
     Math.abs(Math.sin(theta)),
     Math.abs(Math.sin(theta + 2 * Math.PI / 3)),
     Math.abs(Math.sin(theta + 4 * Math.PI / 3))
   );
   add(() => p.headDiameter / 2, 0);
-  add(hexRadius2, 0);
-  add(hexRadius2, -p.socketDepth);
+  add(hexRadius3, 0);
+  add(hexRadius3, -p.socketDepth);
   cap(previous, -p.socketDepth, true);
   return { positions, indices };
 }
@@ -1579,20 +1579,20 @@ function createHexBoltMesh(input, options = {}) {
       filletCenterZ + p.underHeadRadius * Math.sin(angle)
     );
   }
-  const hexRadius2 = (theta) => p.headAcrossFlats / 2 / Math.max(
+  const hexRadius3 = (theta) => p.headAcrossFlats / 2 / Math.max(
     Math.abs(Math.sin(theta)),
     Math.abs(Math.sin(theta + 2 * Math.PI / 3)),
     Math.abs(Math.sin(theta + 4 * Math.PI / 3))
   );
-  add(hexRadius2, 0);
+  add(hexRadius3, 0);
   const slope = Math.tan(p.headChamferAngle * Math.PI / 180);
   const start = p.headHeight - (p.headCornerDiameter - p.headChamferDiameter) / 2 * slope;
-  add(hexRadius2, start);
+  add(hexRadius3, start);
   for (let i = 1; i <= 12; i++) {
     const z = start + (p.headHeight - start) * i / 12;
     add(
       (theta) => Math.min(
-        hexRadius2(theta),
+        hexRadius3(theta),
         p.headChamferDiameter / 2 + (p.headHeight - z) / slope
       ),
       z
@@ -1621,6 +1621,136 @@ function register6(registry) {
   registry.register(model6);
 }
 
+// lib/models/hexnut/register.tsx
+import { hexNutModelDefinitionSchema } from "@tscircuit/modelprinter";
+
+// lib/models/hexnut/mesh.ts
+import {
+  hexNutModelPropsSchema,
+  getHexNutDimensions
+} from "@tscircuit/modelprinter";
+function resolution2(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 surface2(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 hexRadius2(angle, acrossFlats) {
+  const period = Math.PI / 3;
+  const distance2 = ((angle - Math.PI / 2 + period / 2) % period + period) % period - period / 2;
+  return acrossFlats / 2 / Math.cos(distance2);
+}
+function threadDistance2(z, angle, pitch, hand = 1) {
+  const phase = ((z / pitch - hand * angle / (2 * Math.PI)) % 1 + 1) % 1;
+  return Math.min(phase, 1 - phase);
+}
+function createHexNutMesh(input, options = {}) {
+  const props = hexNutModelPropsSchema.parse(input);
+  const d = getHexNutDimensions(input);
+  const { radial, axial } = resolution2(options);
+  const steps = Math.max(2, Math.ceil(d.height / d.threadPitch * axial));
+  if (steps > 24e3 || !Number.isFinite(steps))
+    throw new Error("Mesh resolution limit: too many thread turns");
+  const m = surface2(radial);
+  const outer = (z, angle) => Math.min(
+    hexRadius2(angle, d.acrossFlats),
+    d.faceDiameter / 2 + Math.min(z, d.height - z) * Math.sqrt(3)
+  );
+  const outerLevels = [
+    0,
+    d.outerChamferDepth,
+    d.height - d.outerChamferDepth,
+    d.height
+  ];
+  for (let index = 0; index < radial; index++) {
+    const angle = index * 2 * Math.PI / radial;
+    const height10 = (hexRadius2(angle, d.acrossFlats) - d.faceDiameter / 2) / Math.sqrt(3);
+    if (height10 > 1e-9 && height10 < d.outerChamferDepth - 1e-9)
+      outerLevels.push(height10, d.height - height10);
+  }
+  const outerZ = outerLevels.sort((a, b) => a - b).filter((z, index, sorted) => index === 0 || z - sorted[index - 1] > 1e-10);
+  const first = m.ring(0, (angle) => outer(0, angle));
+  let previous = first;
+  for (const z of outerZ.slice(1)) {
+    const current = m.ring(z, (angle) => outer(z, angle));
+    m.connect(previous, current);
+    previous = current;
+  }
+  const levels = new Set(
+    props.showThreads ? Array.from({ length: steps + 1 }, (_, i) => d.height * i / steps) : [0, d.height]
+  );
+  levels.add(d.boreChamferDepth);
+  levels.add(d.height - d.boreChamferDepth);
+  const minor = d.boreMinorDiameter / 2;
+  const depth = (d.diameter - d.boreMinorDiameter) / 2;
+  for (const z of [...levels].sort((a, b) => b - a)) {
+    const current = m.ring(z, (angle) => {
+      const groove = Math.min(
+        depth,
+        Math.max(
+          0,
+          (threadDistance2(z, angle, d.threadPitch) - 1 / 8) * d.threadPitch * Math.sqrt(3)
+        )
+      );
+      const threaded = minor + (props.showThreads ? groove : 0);
+      return Math.max(threaded, d.mouthDiameter / 2 - Math.min(z, d.height - z));
+    });
+    m.connect(previous, current);
+    previous = current;
+  }
+  m.connect(previous, first);
+  return { positions: m.positions, indices: m.indices };
+}
+
+// lib/models/hexnut/HexNut.tsx
+function createHexNutGeom(input, resolution3) {
+  return indexedMeshToGeom3(createHexNutMesh(input, resolution3));
+}
+function HexNut({ color = "#737e8f", ...props }) {
+  return /* @__PURE__ */ jsx(Colorize, { color, children: /* @__PURE__ */ jsx(Custom, { geometry: createHexNutGeom(props) }) });
+}
+
+// lib/models/hexnut/register.tsx
+var model7 = defineModelRenderer({
+  name: "hexnut",
+  schema: hexNutModelDefinitionSchema,
+  render: ({ fn, ...props }) => /* @__PURE__ */ jsx(HexNut, { ...props }),
+  pads: "none"
+});
+function register7(registry) {
+  registry.register(model7);
+}
+
 // lib/models/hexsocketbolt/register.tsx
 import { hexSocketBoltModelDefinitionSchema } from "@tscircuit/modelprinter";
 
@@ -1710,10 +1840,10 @@ var createHexSocketBoltMesh = (input) => {
   addRing(bevel, () => headDiameter / 2);
   addRing(headHeight - bevel, () => headDiameter / 2);
   addRing(headHeight, () => headDiameter / 2 - bevel);
-  const hexRadius2 = (angle, acrossFlats) => acrossFlats / 2 / Math.cos((angle + Math.PI / 6) % (Math.PI / 3) - Math.PI / 6);
-  addRing(headHeight, (angle) => hexRadius2(angle, socketWidth + bevel));
-  addRing(headHeight - bevel / 2, (angle) => hexRadius2(angle, socketWidth));
-  addRing(headHeight - socketDepth, (angle) => hexRadius2(angle, socketWidth));
+  const hexRadius3 = (angle, acrossFlats) => acrossFlats / 2 / Math.cos((angle + Math.PI / 6) % (Math.PI / 3) - Math.PI / 6);
+  addRing(headHeight, (angle) => hexRadius3(angle, socketWidth + bevel));
+  addRing(headHeight - bevel / 2, (angle) => hexRadius3(angle, socketWidth));
+  addRing(headHeight - socketDepth, (angle) => hexRadius3(angle, socketWidth));
   cap(previous, headHeight - socketDepth, true);
   return { positions, indices };
 };
@@ -1730,14 +1860,14 @@ function HexSocketBolt({
 }
 
 // lib/models/hexsocketbolt/register.tsx
-var model7 = defineModelRenderer({
+var model8 = defineModelRenderer({
   name: "hexsocketbolt",
   schema: hexSocketBoltModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(HexSocketBolt, { ...props }),
   pads: "none"
 });
-function register7(registry) {
-  registry.register(model7);
+function register8(registry) {
+  registry.register(model8);
 }
 
 // lib/models/nema/register.tsx
@@ -2006,14 +2136,14 @@ var NEMA17 = (props) => /* @__PURE__ */ jsx(NemaMotor, { ...props, nemaSize: 17
 var NEMA23 = (props) => /* @__PURE__ */ jsx(NemaMotor, { ...props, nemaSize: 23 });
 
 // lib/models/nema/register.tsx
-var model8 = defineModelRenderer({
+var model9 = defineModelRenderer({
   name: "nema",
   schema: nemaMotorModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(NemaMotor, { ...props }),
   pads: "none"
 });
-function register8(registry) {
-  registry.register(model8);
+function register9(registry) {
+  registry.register(model9);
 }
 
 // lib/models/panscrew/register.tsx
@@ -2225,14 +2355,14 @@ function PanScrew({ color = "#737e8f", ...props }) {
 }
 
 // lib/models/panscrew/register.tsx
-var model9 = defineModelRenderer({
+var model10 = defineModelRenderer({
   name: "panscrew",
   schema: panScrewModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(PanScrew, { ...props }),
   pads: "none"
 });
-function register9(registry) {
-  registry.register(model9);
+function register10(registry) {
+  registry.register(model10);
 }
 
 // lib/models/plainbushing/register.tsx
@@ -2295,14 +2425,14 @@ function PlainBushing({
 }
 
 // lib/models/plainbushing/register.tsx
-var model10 = defineModelRenderer({
+var model11 = defineModelRenderer({
   name: "plainbushing",
   schema: plainBushingModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(PlainBushing, { ...props }),
   pads: "none"
 });
-function register10(registry) {
-  registry.register(model10);
+function register11(registry) {
+  registry.register(model11);
 }
 
 // lib/models/sheetmetal/register.tsx
@@ -2462,14 +2592,14 @@ function SheetMetal({ color = "#737e8f", ...props }) {
 }
 
 // lib/models/sheetmetal/register.tsx
-var model11 = defineModelRenderer({
+var model12 = defineModelRenderer({
   name: "sheetmetal",
   schema: sheetMetalModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(SheetMetal, { ...props }),
   pads: "none"
 });
-function register11(registry) {
-  registry.register(model11);
+function register12(registry) {
+  registry.register(model12);
 }
 
 // lib/models/spurgear/register.tsx
@@ -2484,14 +2614,14 @@ function SpurGear({ color = "#737e8f", ...props }) {
 }
 
 // lib/models/spurgear/register.tsx
-var model12 = defineModelRenderer({
+var model13 = defineModelRenderer({
   name: "spurgear",
   schema: spurGearModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(SpurGear, { ...props }),
   pads: "none"
 });
-function register12(registry) {
-  registry.register(model12);
+function register13(registry) {
+  registry.register(model13);
 }
 
 // lib/models/wormgear/register.tsx
@@ -2683,14 +2813,14 @@ function WormGear({ color = "#737e8f", ...props }) {
 }
 
 // lib/models/wormgear/register.tsx
-var model13 = defineModelRenderer({
+var model14 = defineModelRenderer({
   name: "wormgear",
   schema: wormGearModelDefinitionSchema,
   render: ({ fn, ...props }) => /* @__PURE__ */ jsx(WormGear, { ...props }),
   pads: "none"
 });
-function register13(registry) {
-  registry.register(model13);
+function register14(registry) {
+  registry.register(model14);
 }
 
 // lib/generated/model-renderers.ts
@@ -2708,6 +2838,7 @@ function registerAllModelRenderers(registry) {
   register11(registry);
   register12(registry);
   register13(registry);
+  register14(registry);
 }
 
 // lib/default-model-registry.ts
@@ -10264,10 +10395,10 @@ var SOT143 = ({ footprint = "sot143" }) => {
 var Footprinter3d = ({ footprint }) => {
   const modelFn = mp3.string(footprint.split("_", 1)[0]).params().fn;
   if (mp3.getModelNames().includes(modelFn)) {
-    const model14 = mp3.string(footprint).json();
-    const renderer = modelRendererRegistry.get(model14.fn);
+    const model15 = mp3.string(footprint).json();
+    const renderer = modelRendererRegistry.get(model15.fn);
     if (renderer) {
-      return renderer.render(model14);
+      return renderer.render(model15);
     }
   }
   let normalizedFootprint = footprint;
@@ -11224,6 +11355,7 @@ export {
   Fragment,
   HelicalGear,
   HexBolt,
+  HexNut,
   HexSocketBolt,
   NEMA17,
   NEMA23,
@@ -11245,6 +11377,8 @@ export {
   createHelicalGearMesh,
   createHexBoltGeom,
   createHexBoltMesh,
+  createHexNutGeom,
+  createHexNutMesh,
   createHexSocketBoltGeom,
   createHexSocketBoltMesh,
   createJSCADRenderer,