@code3d/screws 0.0.1-alpha.4 → 0.0.1-alpha.6

package/bld/chunks/chunk-Z5LEGL77.js

@@ -0,0 +1,464 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// packages/screws/src/library/common.ts
+import {
+  offset,
+  cylinder,
+  cut,
+  frustum,
+  intersect,
+  loft,
+  rectangle,
+  regularPrism,
+  sphere,
+  union
+} from "@code3d/core";
+
+// packages/screws/src/library/thread.ts
+import {
+  definePrimitive,
+  replicad
+} from "@code3d/core/replicad";
+var { Plane, draw, makeCylinder, makeHelix, makeSolid, weldShellsAndFaces } = replicad;
+var loopSteps = Array.from({ length: 21 }, (_, index) => index / 20);
+var helicalThread = definePrimitive(
+  (options) => {
+    validateHelicalThread(options);
+    const {
+      majorDiameter,
+      minorDiameter,
+      leftHanded = false,
+      ...dimensions
+    } = options;
+    return makeHelicalThreadShape({
+      ...dimensions,
+      majorRadius: majorDiameter / 2,
+      minorRadius: minorDiameter / 2,
+      leftHanded
+    });
+  }
+);
+function validateHelicalThread({
+  pitch,
+  y,
+  majorDiameter,
+  minorDiameter,
+  rootWidth,
+  crestWidth
+}) {
+  assertPositive("pitch", pitch);
+  assertPositive("y", y);
+  assertPositive("majorDiameter", majorDiameter);
+  assertPositive("minorDiameter", minorDiameter);
+  assertPositive("rootWidth", rootWidth);
+  assertPositive("crestWidth", crestWidth);
+  if (y < pitch) {
+    throw new Error("y must be at least one thread pitch.");
+  }
+  if (minorDiameter >= majorDiameter) {
+    throw new Error("minorDiameter must be smaller than majorDiameter.");
+  }
+  if (crestWidth >= rootWidth || rootWidth > pitch) {
+    throw new Error(
+      "The thread profile requires crestWidth < rootWidth <= pitch."
+    );
+  }
+}
+__name(validateHelicalThread, "validateHelicalThread");
+function makeHelicalThreadShape({
+  pitch,
+  y,
+  majorRadius,
+  minorRadius,
+  rootWidth,
+  crestWidth,
+  leftHanded
+}) {
+  const toothHeight = majorRadius - minorRadius;
+  const profile = threadProfile(rootWidth, crestWidth, toothHeight);
+  const teeth = fadedThread(pitch, minorRadius, y, profile, leftHanded);
+  const core = makeCylinder(minorRadius + 0.05, y);
+  const threaded = core.fuse(teeth);
+  core.delete();
+  teeth.delete();
+  const envelope = makeCylinder(majorRadius + pitch, y);
+  const trimmed = threaded.intersect(envelope);
+  threaded.delete();
+  envelope.delete();
+  return trimmed.rotate(-90, [0, 0, 0], [1, 0, 0]).translate([0, -y / 2, 0]);
+}
+__name(makeHelicalThreadShape, "makeHelicalThreadShape");
+function threadProfile(rootWidth, crestWidth, toothHeight) {
+  const rootHalf = rootWidth / 2;
+  const crestHalf = crestWidth / 2;
+  return draw([rootHalf, -0.05]).vLine(0.05).lineTo([crestHalf, toothHeight]).hLineTo(-crestHalf).lineTo([-rootHalf, 0]).vLine(-0.05).close();
+}
+__name(threadProfile, "threadProfile");
+function fadedThread(pitch, radius, length, profile, leftHanded) {
+  const bottomEnd = fadedEnd(pitch, radius, profile, true, leftHanded);
+  const totalLoops = length / pitch - 0.5;
+  const fullLoops = Math.floor(totalLoops);
+  const leftover = totalLoops - fullLoops;
+  const singleLoop = basicThreadLoop(
+    pitch,
+    radius,
+    profile,
+    1,
+    "none",
+    leftHanded
+  );
+  const shells = Array.from(
+    { length: fullLoops },
+    (_, index) => singleLoop.clone().translate([0, 0, index * pitch])
+  );
+  singleLoop.delete();
+  if (leftover > 1e-9) {
+    shells.push(
+      basicThreadLoop(
+        pitch,
+        radius,
+        profile,
+        leftover,
+        "none",
+        leftHanded
+      ).translate([0, 0, fullLoops * pitch])
+    );
+  }
+  const topEnd = fadedEnd(pitch, radius, profile, false, leftHanded).translate([0, 0, totalLoops * pitch]).rotate(360 * leftover, [0, 0, 0], [0, 0, 1]);
+  const thread = makeSolid([bottomEnd, ...shells, topEnd]).translate([
+    0,
+    0,
+    pitch / 4
+  ]);
+  bottomEnd.delete();
+  shells.forEach((shell) => shell.delete());
+  topEnd.delete();
+  return thread;
+}
+__name(fadedThread, "fadedThread");
+function basicThreadLoop(pitch, radius, profile, loopFraction, includeEnd, leftHanded) {
+  const helix = makeHelix(
+    pitch,
+    pitch * clamp(loopFraction, 0, 1),
+    radius,
+    [0, 0, 0],
+    [0, 0, 1],
+    leftHanded
+  );
+  const profiles = loopSteps.map((step) => {
+    const position = helix.pointAt(step);
+    const tangent = helix.tangentAt(step);
+    const plane = new Plane(position, [0, 0, 1], tangent);
+    const sketch = profile.sketchOnPlane(plane);
+    plane.delete();
+    return sketch;
+  });
+  helix.delete();
+  const ends = [];
+  if (includeEnd === "first" || includeEnd === "both") {
+    ends.push(profiles[0].faces());
+  }
+  if (includeEnd === "last" || includeEnd === "both") {
+    const face = profiles.at(-1).faces();
+    face.wrapped.Reverse();
+    ends.push(face);
+  }
+  const shell = profiles[0].loftWith(profiles.slice(1), { ruled: false }, true);
+  if (ends.length === 0) return shell;
+  const closed = weldShellsAndFaces([shell, ...ends]);
+  shell.delete();
+  ends.forEach((face) => face.delete());
+  return closed;
+}
+__name(basicThreadLoop, "basicThreadLoop");
+function fadedEnd(pitch, radius, profile, bottom, leftHanded) {
+  const length = pitch / 4;
+  const helix = makeHelix(
+    pitch,
+    length,
+    radius,
+    [0, 0, 0],
+    [0, 0, bottom ? -1 : 1],
+    leftHanded
+  );
+  const profiles = loopSteps.map((step, index) => {
+    const position = helix.pointAt(step);
+    let tangent = helix.tangentAt(step);
+    if (bottom) tangent = tangent.multiply(-1);
+    const plane = new Plane(position, [0, 0, 1], tangent);
+    const sketch = profile.scale((loopSteps.length - index) / loopSteps.length, [0, 0]).sketchOnPlane(plane);
+    plane.delete();
+    return sketch;
+  });
+  helix.delete();
+  const endFace = profiles.at(-1).faces();
+  const shell = profiles[0].loftWith(profiles.slice(1), { ruled: false }, true);
+  const closed = weldShellsAndFaces([shell, endFace]);
+  shell.delete();
+  endFace.delete();
+  return bottom ? closed.rotate(180, [0, 0, 0], [0, 0, 1]) : closed;
+}
+__name(fadedEnd, "fadedEnd");
+function assertPositive(name, value) {
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new Error(`${name} must be a positive finite number.`);
+  }
+}
+__name(assertPositive, "assertPositive");
+function clamp(value, minimum, maximum) {
+  return Math.min(Math.max(value, minimum), maximum);
+}
+__name(clamp, "clamp");
+
+// packages/screws/src/library/common.ts
+var metricDimensions = {
+  M3: [3, 0.5, 3.2, 3.4, 3.6],
+  M4: [4, 0.7, 4.3, 4.5, 4.8],
+  M5: [5, 0.8, 5.3, 5.5, 5.8],
+  M6: [6, 1, 6.4, 6.6, 7],
+  M8: [8, 1.25, 8.4, 9, 10],
+  M10: [10, 1.5, 10.5, 11, 12],
+  M12: [12, 1.75, 13, 13.5, 14.5]
+};
+function metric(designation) {
+  const [nominalDiameter, pitch, close, normal, loose] = metricDimensions[designation];
+  return {
+    designation,
+    nominalDiameter,
+    pitch,
+    clearance: { close, normal, loose }
+  };
+}
+__name(metric, "metric");
+function positive(name, value) {
+  if (!Number.isFinite(value) || value <= 0)
+    throw new Error(`${name} must be a positive finite number.`);
+}
+__name(positive, "positive");
+function validateMetric(spec) {
+  positive("Nominal diameter", spec.nominalDiameter);
+  positive("Pitch", spec.pitch);
+  if (spec.pitch >= spec.nominalDiameter)
+    throw new Error("Pitch must be smaller than the nominal diameter.");
+}
+__name(validateMetric, "validateMetric");
+function validateHead(spec) {
+  validateMetric(spec);
+  positive("Head diameter", spec.headDiameter);
+  positive("Head height", spec.headHeight);
+  positive("Under-head radius", spec.underHeadRadius);
+  if (spec.headDiameter <= spec.nominalDiameter)
+    throw new Error("Head diameter must exceed the nominal diameter.");
+}
+__name(validateHead, "validateHead");
+function atY(model, y) {
+  return model.originOffset(0, -y, 0);
+}
+__name(atY, "atY");
+function externalThread(spec, length) {
+  validateMetric(spec);
+  positive("Thread length", length);
+  const fundamentalHeight = Math.sqrt(3) / 2 * spec.pitch;
+  return helicalThread({
+    pitch: spec.pitch,
+    y: length,
+    majorDiameter: spec.nominalDiameter,
+    minorDiameter: spec.nominalDiameter - 2 * (5 / 8 * fundamentalHeight),
+    rootWidth: 3 / 4 * spec.pitch,
+    crestWidth: 1 / 8 * spec.pitch
+  });
+}
+__name(externalThread, "externalThread");
+function shank(spec, length, threadedLength, radius) {
+  positive("Screw length", length);
+  positive("Thread length", threadedLength);
+  if (length <= spec.pitch + radius)
+    throw new Error(
+      "Screw length must leave room for at least one full thread pitch."
+    );
+  const bodyLength = length - radius;
+  const threadLength = Math.min(bodyLength, threadedLength);
+  const plainLength = bodyLength - threadLength;
+  const overlap = Math.min(0.08, spec.pitch / 10);
+  const transition = atY(
+    frustum(
+      spec.nominalDiameter / 2,
+      spec.nominalDiameter / 2 + radius,
+      radius
+    ),
+    -radius / 2
+  );
+  const parts = [transition];
+  if (plainLength > 0)
+    parts.push(
+      atY(
+        cylinder(spec.nominalDiameter / 2, plainLength + overlap),
+        -radius - plainLength / 2 + overlap / 2
+      )
+    );
+  const thread = atY(
+    externalThread(spec, threadLength + overlap),
+    -length + (threadLength + overlap) / 2
+  );
+  parts.push(thread);
+  return union(parts).expose({
+    shankTop: transition.up,
+    shankBottom: thread.down,
+    shankAxis: thread.axis
+  });
+}
+__name(shank, "shank");
+function headedScrew(head, spec, length, threadedLength) {
+  validateHead(spec);
+  const shaft = shank(
+    spec,
+    length,
+    threadedLength,
+    spec.underHeadRadius
+  ).relate((part) => part.on(head.down));
+  return union([head, shaft]).expose({
+    headTop: head.up,
+    headBottom: head.down,
+    shankTop: shaft.shankTop,
+    shankBottom: shaft.shankBottom,
+    shankAxis: shaft.shankAxis
+  });
+}
+__name(headedScrew, "headedScrew");
+function hexSocket(head, width, depth, height) {
+  positive("Hex socket width", width);
+  positive("Hex socket depth", depth);
+  if (depth >= height)
+    throw new Error("Hex socket depth must be smaller than the head height.");
+  const tool = regularPrism(width / Math.sqrt(3), depth + 0.2, 6, 30).relate(
+    (part) => [part.down.on(head.up), offset(0, -depth, 0)]
+  );
+  return cut(head, [tool]);
+}
+__name(hexSocket, "hexSocket");
+function roundHead(diameter, height, crownDiameter) {
+  positive("Head diameter", diameter);
+  positive("Head height", height);
+  positive("Crown diameter", crownDiameter);
+  if (crownDiameter >= diameter)
+    throw new Error("Crown diameter must be smaller than the head diameter.");
+  const radius = diameter / 2;
+  const crown = crownDiameter / 2;
+  const center = (height * height + crown * crown - radius * radius) / (2 * height);
+  const ball = atY(sphere(Math.hypot(radius, center)), center - height / 2);
+  return intersect([cylinder(radius, height), ball]);
+}
+__name(roundHead, "roundHead");
+function panHead(diameter, height, crownDiameter, curvatureRadius) {
+  positive("Head curvature radius", curvatureRadius);
+  if (curvatureRadius <= diameter / 2)
+    throw new Error(
+      "Head curvature radius must exceed half the head diameter."
+    );
+  const capHeight = Math.sqrt(curvatureRadius ** 2 - (crownDiameter / 2) ** 2) - Math.sqrt(curvatureRadius ** 2 - (diameter / 2) ** 2);
+  if (!Number.isFinite(capHeight) || capHeight <= 0 || capHeight >= height)
+    throw new Error("Pan head crown must leave a cylindrical barrel.");
+  const barrel = cylinder(diameter / 2, height - capHeight);
+  const cap = atY(roundHead(diameter, capHeight, crownDiameter), height / 2);
+  return union([barrel, cap]);
+}
+__name(panHead, "panHead");
+function crossSocket(head, recess, type) {
+  const { diameter, depth, width } = recess;
+  positive("Cross recess diameter", diameter);
+  positive("Cross recess depth", depth);
+  positive("Cross recess width", width);
+  const bottom = rectangle(width * 0.7, diameter * 0.5);
+  const top = rectangle(width, diameter).originOffset(0, -depth, 0);
+  const wing = loft([bottom, top]);
+  const tools = [wing, wing.rotate(0, 90, 0)];
+  if (type === "Z") {
+    const rib = loft([
+      rectangle(width * 0.2, diameter * 0.45),
+      rectangle(width * 0.35, diameter * 0.85).originOffset(0, -depth, 0)
+    ]);
+    tools.push(rib.rotate(0, 45, 0), rib.rotate(0, 135, 0));
+  }
+  const tool = union(tools).relate((part) => part.up.on(head.up));
+  return cut(head, [tool]);
+}
+__name(crossSocket, "crossSocket");
+function plainHole(spec, options) {
+  validateMetric(spec);
+  positive("Hole depth", options.depth);
+  const diameter = options.diameter ?? spec.clearance[options.fit ?? "normal"];
+  positive("Clearance diameter", diameter);
+  if (diameter <= spec.nominalDiameter)
+    throw new Error(
+      "Clearance-hole diameter must exceed the nominal screw diameter."
+    );
+  const shaft = cylinder(diameter / 2, options.depth);
+  return shaft.expose({
+    shaftTop: shaft.up,
+    shaftBottom: shaft.down,
+    shaftAxis: shaft.axis
+  });
+}
+__name(plainHole, "plainHole");
+function clearanceHole(spec, optionsOrDepth, defaultCounterbore = false) {
+  const options = typeof optionsOrDepth === "number" ? { depth: optionsOrDepth } : optionsOrDepth;
+  return withCounterbore(
+    plainHole(spec, options),
+    spec,
+    options,
+    defaultCounterbore
+  );
+}
+__name(clearanceHole, "clearanceHole");
+function withCounterbore(shaft, spec, options, defaultCounterbore = false) {
+  const counterboreOption = options.counterbore ?? defaultCounterbore;
+  if (counterboreOption === false) return shaft;
+  const counterbore = counterboreOption === true ? {} : counterboreOption;
+  const axialClearance = counterbore.axialClearance ?? 0.5;
+  if (!Number.isFinite(axialClearance) || axialClearance < 0)
+    throw new Error("Axial clearance must be a nonnegative finite number.");
+  const depth = counterbore.depth ?? spec.headHeight + axialClearance;
+  const diameter = counterbore.diameter ?? spec.counterboreDiameter ?? spec.headDiameter + 1;
+  positive("Counterbore depth", depth);
+  positive("Counterbore diameter", diameter);
+  if (depth > options.depth)
+    throw new Error("Counterbore depth must be within the total hole depth.");
+  if (diameter < spec.headDiameter)
+    throw new Error("Counterbore diameter must accommodate the screw head.");
+  const recess = atY(
+    cylinder(diameter / 2, depth),
+    (options.depth - depth) / 2
+  );
+  return union([shaft, recess]).expose({
+    shaftTop: shaft.shaftTop,
+    shaftBottom: shaft.shaftBottom,
+    shaftAxis: shaft.shaftAxis,
+    counterboreTop: recess.up,
+    counterboreBottom: recess.down
+  });
+}
+__name(withCounterbore, "withCounterbore");
+
+export {
+  __name,
+  __export,
+  metric,
+  positive,
+  validateHead,
+  atY,
+  externalThread,
+  headedScrew,
+  hexSocket,
+  roundHead,
+  panHead,
+  crossSocket,
+  plainHole,
+  clearanceHole,
+  withCounterbore
+};
+//# sourceMappingURL=chunk-Z5LEGL77.js.map

package/bld/chunks/chunk-Z5LEGL77.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/common.ts", "../../src/library/thread.ts"],
+  "sourcesContent": ["import {\n  offset,\n  cylinder,\n  cut,\n  frustum,\n  intersect,\n  loft,\n  rectangle,\n  regularPrism,\n  sphere,\n  union,\n  type Bound,\n  type CanonicalElements,\n  type LineAnchor,\n  type SolidModel,\n} from '@code3d/core';\nimport {helicalThread} from './thread.js';\n\nexport type ClearanceFit = 'close' | 'normal' | 'loose';\nexport type MetricSpecification = Readonly<{\n  designation: string;\n  nominalDiameter: number;\n  pitch: number;\n  clearance: Readonly<Record<ClearanceFit, number>>;\n}>;\n\n// ISO metric coarse pitches and ISO 273 clearance series, millimetres.\nconst metricDimensions = {\n  M3: [3, 0.5, 3.2, 3.4, 3.6],\n  M4: [4, 0.7, 4.3, 4.5, 4.8],\n  M5: [5, 0.8, 5.3, 5.5, 5.8],\n  M6: [6, 1, 6.4, 6.6, 7],\n  M8: [8, 1.25, 8.4, 9, 10],\n  M10: [10, 1.5, 10.5, 11, 12],\n  M12: [12, 1.75, 13, 13.5, 14.5],\n} as const;\nexport type MetricSize = keyof typeof metricDimensions;\n\nexport function metric(designation: MetricSize): MetricSpecification {\n  const [nominalDiameter, pitch, close, normal, loose] =\n    metricDimensions[designation];\n  return {\n    designation,\n    nominalDiameter,\n    pitch,\n    clearance: {close, normal, loose},\n  };\n}\n\nexport type ShankElements = Readonly<{\n  shankTop: Bound;\n  shankBottom: Bound;\n  shankAxis: LineAnchor;\n}>;\nexport type ScrewElements = CanonicalElements &\n  ShankElements &\n  Readonly<{\n    headTop: Bound;\n    headBottom: Bound;\n  }>;\nexport type Screw = SolidModel<ScrewElements>;\nexport type HoleElements = CanonicalElements &\n  Readonly<{\n    shaftTop: Bound;\n    shaftBottom: Bound;\n    shaftAxis: LineAnchor;\n  }>;\nexport type CounterboredHoleElements = HoleElements &\n  Readonly<{\n    counterboreTop: Bound;\n    counterboreBottom: Bound;\n  }>;\nexport type ClearanceHole = SolidModel<HoleElements>;\nexport type CounterboredHole = SolidModel<CounterboredHoleElements>;\n\nexport type HeadSpecification = MetricSpecification &\n  Readonly<{\n    headDiameter: number;\n    headHeight: number;\n    underHeadRadius: number;\n  }>;\nexport type CounterboreOptions = Readonly<{\n  diameter?: number;\n  depth?: number;\n  axialClearance?: number;\n}>;\nexport type ClearanceHoleOptions = Readonly<{\n  depth: number;\n  fit?: ClearanceFit;\n  diameter?: number;\n  counterbore?: boolean | CounterboreOptions;\n}>;\nexport type PlainHoleOptions = ClearanceHoleOptions &\n  Readonly<{counterbore?: false}>;\nexport type CounterboredHoleOptions = ClearanceHoleOptions &\n  Readonly<{\n    counterbore: true | CounterboreOptions;\n  }>;\n\nexport function positive(name: string, value: number): void {\n  if (!Number.isFinite(value) || value <= 0)\n    throw new Error(`${name} must be a positive finite number.`);\n}\n\nexport function validateMetric(spec: MetricSpecification): void {\n  positive('Nominal diameter', spec.nominalDiameter);\n  positive('Pitch', spec.pitch);\n  if (spec.pitch >= spec.nominalDiameter)\n    throw new Error('Pitch must be smaller than the nominal diameter.');\n}\n\nexport function validateHead(spec: HeadSpecification): void {\n  validateMetric(spec);\n  positive('Head diameter', spec.headDiameter);\n  positive('Head height', spec.headHeight);\n  positive('Under-head radius', spec.underHeadRadius);\n  if (spec.headDiameter <= spec.nominalDiameter)\n    throw new Error('Head diameter must exceed the nominal diameter.');\n}\n\n/** Translate geometry within the package's common Y-axis frame. */\nexport function atY<T extends SolidModel>(model: T, y: number) {\n  return model.originOffset(0, -y, 0);\n}\n\nexport function externalThread(spec: MetricSpecification, length: number) {\n  validateMetric(spec);\n  positive('Thread length', length);\n  const fundamentalHeight = (Math.sqrt(3) / 2) * spec.pitch;\n  return helicalThread({\n    pitch: spec.pitch,\n    y: length,\n    majorDiameter: spec.nominalDiameter,\n    minorDiameter: spec.nominalDiameter - 2 * ((5 / 8) * fundamentalHeight),\n    rootWidth: (3 / 4) * spec.pitch,\n    crestWidth: (1 / 8) * spec.pitch,\n  });\n}\n\n/** Shaft top is Y=0; its tip is Y=-length, including the blended ends. */\nexport function shank(\n  spec: MetricSpecification,\n  length: number,\n  threadedLength: number,\n  radius: number,\n) {\n  positive('Screw length', length);\n  positive('Thread length', threadedLength);\n  if (length <= spec.pitch + radius)\n    throw new Error(\n      'Screw length must leave room for at least one full thread pitch.',\n    );\n  const bodyLength = length - radius;\n  const threadLength = Math.min(bodyLength, threadedLength);\n  const plainLength = bodyLength - threadLength;\n  const overlap = Math.min(0.08, spec.pitch / 10);\n  const transition = atY(\n    frustum(\n      spec.nominalDiameter / 2,\n      spec.nominalDiameter / 2 + radius,\n      radius,\n    ),\n    -radius / 2,\n  );\n  const parts: SolidModel[] = [transition];\n  if (plainLength > 0)\n    parts.push(\n      atY(\n        cylinder(spec.nominalDiameter / 2, plainLength + overlap),\n        -radius - plainLength / 2 + overlap / 2,\n      ),\n    );\n  const thread = atY(\n    externalThread(spec, threadLength + overlap),\n    -length + (threadLength + overlap) / 2,\n  );\n  parts.push(thread);\n  return union(parts).expose({\n    shankTop: transition.up,\n    shankBottom: thread.down,\n    shankAxis: thread.axis,\n  });\n}\n\nexport function headedScrew(\n  head: SolidModel,\n  spec: HeadSpecification,\n  length: number,\n  threadedLength: number,\n): Screw {\n  validateHead(spec);\n  const shaft = shank(\n    spec,\n    length,\n    threadedLength,\n    spec.underHeadRadius,\n  ).relate(part => part.on(head.down));\n  return union([head, shaft]).expose({\n    headTop: head.up,\n    headBottom: head.down,\n    shankTop: shaft.shankTop,\n    shankBottom: shaft.shankBottom,\n    shankAxis: shaft.shankAxis,\n  });\n}\n\nexport function hexSocket(\n  head: SolidModel,\n  width: number,\n  depth: number,\n  height: number,\n): SolidModel {\n  positive('Hex socket width', width);\n  positive('Hex socket depth', depth);\n  if (depth >= height)\n    throw new Error('Hex socket depth must be smaller than the head height.');\n  const tool = regularPrism(width / Math.sqrt(3), depth + 0.2, 6, 30).relate(\n    part => [part.down.on(head.up), offset(0, -depth, 0)],\n  );\n  return cut(head, [tool]);\n}\n\n/** Spherical head with a small flat crown surrounding the driving recess. */\nexport function roundHead(\n  diameter: number,\n  height: number,\n  crownDiameter: number,\n): SolidModel {\n  positive('Head diameter', diameter);\n  positive('Head height', height);\n  positive('Crown diameter', crownDiameter);\n  if (crownDiameter >= diameter)\n    throw new Error('Crown diameter must be smaller than the head diameter.');\n  const radius = diameter / 2;\n  const crown = crownDiameter / 2;\n  const center =\n    (height * height + crown * crown - radius * radius) / (2 * height);\n  const ball = atY(sphere(Math.hypot(radius, center)), center - height / 2);\n  return intersect([cylinder(radius, height), ball]);\n}\n\nexport function panHead(\n  diameter: number,\n  height: number,\n  crownDiameter: number,\n  curvatureRadius: number,\n): SolidModel {\n  positive('Head curvature radius', curvatureRadius);\n  if (curvatureRadius <= diameter / 2)\n    throw new Error(\n      'Head curvature radius must exceed half the head diameter.',\n    );\n  const capHeight =\n    Math.sqrt(curvatureRadius ** 2 - (crownDiameter / 2) ** 2) -\n    Math.sqrt(curvatureRadius ** 2 - (diameter / 2) ** 2);\n  if (!Number.isFinite(capHeight) || capHeight <= 0 || capHeight >= height)\n    throw new Error('Pan head crown must leave a cylindrical barrel.');\n  const barrel = cylinder(diameter / 2, height - capHeight);\n  const cap = atY(roundHead(diameter, capHeight, crownDiameter), height / 2);\n  return union([barrel, cap]);\n}\n\nexport type CrossRecessType = 'H' | 'Z';\nexport type CrossRecess = Readonly<{\n  number: number;\n  diameter: number;\n  depth: number;\n  width: number;\n}>;\n\n/** Tapered cruciform drive; type Z adds its four intermediate ribs. */\nexport function crossSocket(\n  head: SolidModel,\n  recess: CrossRecess,\n  type: CrossRecessType,\n): SolidModel {\n  const {diameter, depth, width} = recess;\n  positive('Cross recess diameter', diameter);\n  positive('Cross recess depth', depth);\n  positive('Cross recess width', width);\n  const bottom = rectangle(width * 0.7, diameter * 0.5);\n  const top = rectangle(width, diameter).originOffset(0, -depth, 0);\n  const wing = loft([bottom, top]);\n  const tools = [wing, wing.rotate(0, 90, 0)];\n  if (type === 'Z') {\n    const rib = loft([\n      rectangle(width * 0.2, diameter * 0.45),\n      rectangle(width * 0.35, diameter * 0.85).originOffset(0, -depth, 0),\n    ]);\n    tools.push(rib.rotate(0, 45, 0), rib.rotate(0, 135, 0));\n  }\n  const tool = union(tools).relate(part => part.up.on(head.up));\n  return cut(head, [tool]);\n}\n\nexport function plainHole(\n  spec: MetricSpecification,\n  options: Omit<ClearanceHoleOptions, 'counterbore'>,\n): ClearanceHole {\n  validateMetric(spec);\n  positive('Hole depth', options.depth);\n  const diameter = options.diameter ?? spec.clearance[options.fit ?? 'normal'];\n  positive('Clearance diameter', diameter);\n  if (diameter <= spec.nominalDiameter)\n    throw new Error(\n      'Clearance-hole diameter must exceed the nominal screw diameter.',\n    );\n  const shaft = cylinder(diameter / 2, options.depth);\n  return shaft.expose({\n    shaftTop: shaft.up,\n    shaftBottom: shaft.down,\n    shaftAxis: shaft.axis,\n  });\n}\n\nexport function clearanceHole(\n  spec: HeadSpecification & {counterboreDiameter?: number},\n  optionsOrDepth: number | ClearanceHoleOptions,\n  defaultCounterbore = false,\n): ClearanceHole | CounterboredHole {\n  const options =\n    typeof optionsOrDepth === 'number'\n      ? {depth: optionsOrDepth}\n      : optionsOrDepth;\n  return withCounterbore(\n    plainHole(spec, options),\n    spec,\n    options,\n    defaultCounterbore,\n  );\n}\n\n/** Add a head recess to a centered Y-axis passage, preserving its references. */\nexport function withCounterbore(\n  shaft: ClearanceHole,\n  spec: Pick<HeadSpecification, 'headDiameter' | 'headHeight'> &\n    Readonly<{counterboreDiameter?: number}>,\n  options: Pick<ClearanceHoleOptions, 'depth' | 'counterbore'>,\n  defaultCounterbore = false,\n): ClearanceHole | CounterboredHole {\n  const counterboreOption = options.counterbore ?? defaultCounterbore;\n  if (counterboreOption === false) return shaft;\n  const counterbore = counterboreOption === true ? {} : counterboreOption;\n  const axialClearance = counterbore.axialClearance ?? 0.5;\n  if (!Number.isFinite(axialClearance) || axialClearance < 0)\n    throw new Error('Axial clearance must be a nonnegative finite number.');\n  const depth = counterbore.depth ?? spec.headHeight + axialClearance;\n  const diameter =\n    counterbore.diameter ?? spec.counterboreDiameter ?? spec.headDiameter + 1;\n  positive('Counterbore depth', depth);\n  positive('Counterbore diameter', diameter);\n  if (depth > options.depth)\n    throw new Error('Counterbore depth must be within the total hole depth.');\n  if (diameter < spec.headDiameter)\n    throw new Error('Counterbore diameter must accommodate the screw head.');\n  const recess = atY(\n    cylinder(diameter / 2, depth),\n    (options.depth - depth) / 2,\n  );\n  return union([shaft, recess]).expose({\n    shaftTop: shaft.shaftTop,\n    shaftBottom: shaft.shaftBottom,\n    shaftAxis: shaft.shaftAxis,\n    counterboreTop: recess.up,\n    counterboreBottom: recess.down,\n  });\n}\n", "import {\n  definePrimitive,\n  replicad,\n  type Drawing,\n  type Face,\n  type Shape3D,\n  type Sketch,\n} from '@code3d/core/replicad';\n\nconst {Plane, draw, makeCylinder, makeHelix, makeSolid, weldShellsAndFaces} =\n  replicad;\n\ntype HelicalThreadOptions = Readonly<{\n  pitch: number;\n  y: number;\n  majorDiameter: number;\n  minorDiameter: number;\n  rootWidth: number;\n  crestWidth: number;\n  leftHanded?: boolean;\n}>;\n\nconst loopSteps = Array.from({length: 21}, (_, index) => index / 20);\n\nexport const helicalThread = definePrimitive(\n  (options: HelicalThreadOptions) => {\n    validateHelicalThread(options);\n    const {\n      majorDiameter,\n      minorDiameter,\n      leftHanded = false,\n      ...dimensions\n    } = options;\n    return makeHelicalThreadShape({\n      ...dimensions,\n      majorRadius: majorDiameter / 2,\n      minorRadius: minorDiameter / 2,\n      leftHanded,\n    });\n  },\n);\n\nfunction validateHelicalThread({\n  pitch,\n  y,\n  majorDiameter,\n  minorDiameter,\n  rootWidth,\n  crestWidth,\n}: HelicalThreadOptions): void {\n  assertPositive('pitch', pitch);\n  assertPositive('y', y);\n  assertPositive('majorDiameter', majorDiameter);\n  assertPositive('minorDiameter', minorDiameter);\n  assertPositive('rootWidth', rootWidth);\n  assertPositive('crestWidth', crestWidth);\n  if (y < pitch) {\n    throw new Error('y must be at least one thread pitch.');\n  }\n  if (minorDiameter >= majorDiameter) {\n    throw new Error('minorDiameter must be smaller than majorDiameter.');\n  }\n  if (crestWidth >= rootWidth || rootWidth > pitch) {\n    throw new Error(\n      'The thread profile requires crestWidth < rootWidth <= pitch.',\n    );\n  }\n}\n\ntype HelicalThreadShapeOptions = Readonly<{\n  pitch: number;\n  y: number;\n  majorRadius: number;\n  minorRadius: number;\n  rootWidth: number;\n  crestWidth: number;\n  leftHanded: boolean;\n}>;\n\n/**\n * Builds a closed external thread around its minor-diameter core. The lofted\n * end treatment follows the MIT-licensed replicad-threads construction by\n * Steve Genoud, adapted here to code3d's Y-axis and geometry ownership model.\n */\nfunction makeHelicalThreadShape({\n  pitch,\n  y,\n  majorRadius,\n  minorRadius,\n  rootWidth,\n  crestWidth,\n  leftHanded,\n}: HelicalThreadShapeOptions): Shape3D {\n  const toothHeight = majorRadius - minorRadius;\n  const profile = threadProfile(rootWidth, crestWidth, toothHeight);\n  const teeth = fadedThread(pitch, minorRadius, y, profile, leftHanded);\n  const core = makeCylinder(minorRadius + 0.05, y);\n  const threaded = core.fuse(teeth);\n  core.delete();\n  teeth.delete();\n  // The axial profile width extends past the fade's quarter-pitch centreline.\n  // Face both ends. Keep the tool clear of the crest to avoid tangent slivers.\n  const envelope = makeCylinder(majorRadius + pitch, y);\n  const trimmed = threaded.intersect(envelope);\n  threaded.delete();\n  envelope.delete();\n  return trimmed.rotate(-90, [0, 0, 0], [1, 0, 0]).translate([0, -y / 2, 0]);\n}\n\nfunction threadProfile(\n  rootWidth: number,\n  crestWidth: number,\n  toothHeight: number,\n): Drawing {\n  const rootHalf = rootWidth / 2;\n  const crestHalf = crestWidth / 2;\n  return draw([rootHalf, -0.05])\n    .vLine(0.05)\n    .lineTo([crestHalf, toothHeight])\n    .hLineTo(-crestHalf)\n    .lineTo([-rootHalf, 0])\n    .vLine(-0.05)\n    .close();\n}\n\nfunction fadedThread(\n  pitch: number,\n  radius: number,\n  length: number,\n  profile: Drawing,\n  leftHanded: boolean,\n): Shape3D {\n  const bottomEnd = fadedEnd(pitch, radius, profile, true, leftHanded);\n  const totalLoops = length / pitch - 0.5;\n  const fullLoops = Math.floor(totalLoops);\n  const leftover = totalLoops - fullLoops;\n  const singleLoop = basicThreadLoop(\n    pitch,\n    radius,\n    profile,\n    1,\n    'none',\n    leftHanded,\n  );\n  const shells = Array.from({length: fullLoops}, (_, index) =>\n    singleLoop.clone().translate([0, 0, index * pitch]),\n  );\n  singleLoop.delete();\n  if (leftover > 1e-9) {\n    shells.push(\n      basicThreadLoop(\n        pitch,\n        radius,\n        profile,\n        leftover,\n        'none',\n        leftHanded,\n      ).translate([0, 0, fullLoops * pitch]),\n    );\n  }\n  const topEnd = fadedEnd(pitch, radius, profile, false, leftHanded)\n    .translate([0, 0, totalLoops * pitch])\n    .rotate(360 * leftover, [0, 0, 0], [0, 0, 1]);\n  const thread = makeSolid([bottomEnd, ...shells, topEnd]).translate([\n    0,\n    0,\n    pitch / 4,\n  ]);\n  bottomEnd.delete();\n  shells.forEach(shell => shell.delete());\n  topEnd.delete();\n  return thread;\n}\n\nfunction basicThreadLoop(\n  pitch: number,\n  radius: number,\n  profile: Drawing,\n  loopFraction: number,\n  includeEnd: 'none' | 'first' | 'last' | 'both',\n  leftHanded: boolean,\n) {\n  const helix = makeHelix(\n    pitch,\n    pitch * clamp(loopFraction, 0, 1),\n    radius,\n    [0, 0, 0],\n    [0, 0, 1],\n    leftHanded,\n  );\n  const profiles = loopSteps.map(step => {\n    const position = helix.pointAt(step);\n    const tangent = helix.tangentAt(step);\n    const plane = new Plane(position, [0, 0, 1], tangent);\n    const sketch = profile.sketchOnPlane(plane) as Sketch;\n    plane.delete();\n    return sketch;\n  });\n  helix.delete();\n\n  const ends: Face[] = [];\n  if (includeEnd === 'first' || includeEnd === 'both') {\n    ends.push(profiles[0].faces());\n  }\n  if (includeEnd === 'last' || includeEnd === 'both') {\n    const face = profiles.at(-1)!.faces();\n    face.wrapped.Reverse();\n    ends.push(face);\n  }\n  const shell = profiles[0].loftWith(profiles.slice(1), {ruled: false}, true);\n  if (ends.length === 0) return shell;\n  const closed = weldShellsAndFaces([shell, ...ends]);\n  shell.delete();\n  ends.forEach(face => face.delete());\n  return closed;\n}\n\nfunction fadedEnd(\n  pitch: number,\n  radius: number,\n  profile: Drawing,\n  bottom: boolean,\n  leftHanded: boolean,\n) {\n  const length = pitch / 4;\n  const helix = makeHelix(\n    pitch,\n    length,\n    radius,\n    [0, 0, 0],\n    [0, 0, bottom ? -1 : 1],\n    leftHanded,\n  );\n  const profiles = loopSteps.map((step, index) => {\n    const position = helix.pointAt(step);\n    let tangent = helix.tangentAt(step);\n    if (bottom) tangent = tangent.multiply(-1);\n    const plane = new Plane(position, [0, 0, 1], tangent);\n    const sketch = profile\n      .scale((loopSteps.length - index) / loopSteps.length, [0, 0])\n      .sketchOnPlane(plane) as Sketch;\n    plane.delete();\n    return sketch;\n  });\n  helix.delete();\n  const endFace = profiles.at(-1)!.faces();\n  const shell = profiles[0].loftWith(profiles.slice(1), {ruled: false}, true);\n  const closed = weldShellsAndFaces([shell, endFace]);\n  shell.delete();\n  endFace.delete();\n  return bottom ? closed.rotate(180, [0, 0, 0], [0, 0, 1]) : closed;\n}\n\nfunction assertPositive(name: string, value: number): void {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new Error(`${name} must be a positive finite number.`);\n  }\n}\n\nfunction clamp(value: number, minimum: number, maximum: number): number {\n  return Math.min(Math.max(value, minimum), maximum);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/bld/chunks/chunk-ZNWKI54A.js

@@ -0,0 +1,25 @@
+import {
+  clearanceHole,
+  resolveSpecification,
+  screw,
+  specifications,
+  threadLength
+} from "./chunk-IXFHRZSY.js";
+import {
+  __export
+} from "./chunk-Z5LEGL77.js";
+
+// packages/screws/src/library/gb-70-3.ts
+var gb_70_3_exports = {};
+__export(gb_70_3_exports, {
+  clearanceHole: () => clearanceHole,
+  resolveSpecification: () => resolveSpecification,
+  screw: () => screw,
+  specifications: () => specifications,
+  threadLength: () => threadLength
+});
+
+export {
+  gb_70_3_exports
+};
+//# sourceMappingURL=chunk-ZNWKI54A.js.map

package/bld/chunks/chunk-ZNWKI54A.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/gb-70-3.ts"],
+  "sourcesContent": ["/**\n * GB/T 70.3-2023 (MOD ISO 10642:2019).\n * Shares the corresponding ISO module's nominal geometry within our preset\n * range. See the package README for sizes, hole allowances and modeling limits.\n * https://std.samr.gov.cn/gb/search/gbDetailed?id=FC816D05003162EBE05397BE0A0AD5FA\n */\nexport * from './iso-10642.js';\n"],
+  "mappings": ";;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/bld/library/common.d.ts

@@ -0,0 +1,104 @@
+import { type Bound, type CanonicalElements, type LineAnchor, type SolidModel } from '@code3d/core';
+export type ClearanceFit = 'close' | 'normal' | 'loose';
+export type MetricSpecification = Readonly<{
+    designation: string;
+    nominalDiameter: number;
+    pitch: number;
+    clearance: Readonly<Record<ClearanceFit, number>>;
+}>;
+declare const metricDimensions: {
+    readonly M3: readonly [3, 0.5, 3.2, 3.4, 3.6];
+    readonly M4: readonly [4, 0.7, 4.3, 4.5, 4.8];
+    readonly M5: readonly [5, 0.8, 5.3, 5.5, 5.8];
+    readonly M6: readonly [6, 1, 6.4, 6.6, 7];
+    readonly M8: readonly [8, 1.25, 8.4, 9, 10];
+    readonly M10: readonly [10, 1.5, 10.5, 11, 12];
+    readonly M12: readonly [12, 1.75, 13, 13.5, 14.5];
+};
+export type MetricSize = keyof typeof metricDimensions;
+export declare function metric(designation: MetricSize): MetricSpecification;
+export type ShankElements = Readonly<{
+    shankTop: Bound;
+    shankBottom: Bound;
+    shankAxis: LineAnchor;
+}>;
+export type ScrewElements = CanonicalElements & ShankElements & Readonly<{
+    headTop: Bound;
+    headBottom: Bound;
+}>;
+export type Screw = SolidModel<ScrewElements>;
+export type HoleElements = CanonicalElements & Readonly<{
+    shaftTop: Bound;
+    shaftBottom: Bound;
+    shaftAxis: LineAnchor;
+}>;
+export type CounterboredHoleElements = HoleElements & Readonly<{
+    counterboreTop: Bound;
+    counterboreBottom: Bound;
+}>;
+export type ClearanceHole = SolidModel<HoleElements>;
+export type CounterboredHole = SolidModel<CounterboredHoleElements>;
+export type HeadSpecification = MetricSpecification & Readonly<{
+    headDiameter: number;
+    headHeight: number;
+    underHeadRadius: number;
+}>;
+export type CounterboreOptions = Readonly<{
+    diameter?: number;
+    depth?: number;
+    axialClearance?: number;
+}>;
+export type ClearanceHoleOptions = Readonly<{
+    depth: number;
+    fit?: ClearanceFit;
+    diameter?: number;
+    counterbore?: boolean | CounterboreOptions;
+}>;
+export type PlainHoleOptions = ClearanceHoleOptions & Readonly<{
+    counterbore?: false;
+}>;
+export type CounterboredHoleOptions = ClearanceHoleOptions & Readonly<{
+    counterbore: true | CounterboreOptions;
+}>;
+export declare function positive(name: string, value: number): void;
+export declare function validateMetric(spec: MetricSpecification): void;
+export declare function validateHead(spec: HeadSpecification): void;
+/** Translate geometry within the package's common Y-axis frame. */
+export declare function atY<T extends SolidModel>(model: T, y: number): SolidModel<Readonly<{
+    center: import("@code3d/core").PointAnchor;
+    axis: LineAnchor;
+}>>;
+export declare function externalThread(spec: MetricSpecification, length: number): SolidModel;
+/** Shaft top is Y=0; its tip is Y=-length, including the blended ends. */
+export declare function shank(spec: MetricSpecification, length: number, threadedLength: number, radius: number): SolidModel<import("@code3d/core").MergedElements<Readonly<{
+    center: import("@code3d/core").PointAnchor;
+    axis: LineAnchor;
+}>, Readonly<{
+    readonly shankTop: Bound;
+    readonly shankBottom: Bound;
+    readonly shankAxis: LineAnchor;
+}>>>;
+export declare function headedScrew(head: SolidModel, spec: HeadSpecification, length: number, threadedLength: number): Screw;
+export declare function hexSocket(head: SolidModel, width: number, depth: number, height: number): SolidModel;
+/** Spherical head with a small flat crown surrounding the driving recess. */
+export declare function roundHead(diameter: number, height: number, crownDiameter: number): SolidModel;
+export declare function panHead(diameter: number, height: number, crownDiameter: number, curvatureRadius: number): SolidModel;
+export type CrossRecessType = 'H' | 'Z';
+export type CrossRecess = Readonly<{
+    number: number;
+    diameter: number;
+    depth: number;
+    width: number;
+}>;
+/** Tapered cruciform drive; type Z adds its four intermediate ribs. */
+export declare function crossSocket(head: SolidModel, recess: CrossRecess, type: CrossRecessType): SolidModel;
+export declare function plainHole(spec: MetricSpecification, options: Omit<ClearanceHoleOptions, 'counterbore'>): ClearanceHole;
+export declare function clearanceHole(spec: HeadSpecification & {
+    counterboreDiameter?: number;
+}, optionsOrDepth: number | ClearanceHoleOptions, defaultCounterbore?: boolean): ClearanceHole | CounterboredHole;
+/** Add a head recess to a centered Y-axis passage, preserving its references. */
+export declare function withCounterbore(shaft: ClearanceHole, spec: Pick<HeadSpecification, 'headDiameter' | 'headHeight'> & Readonly<{
+    counterboreDiameter?: number;
+}>, options: Pick<ClearanceHoleOptions, 'depth' | 'counterbore'>, defaultCounterbore?: boolean): ClearanceHole | CounterboredHole;
+export {};
+//# sourceMappingURL=common.d.ts.map