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

package/README.md

@@ -1,64 +1,252 @@
 # `@code3d/screws`
 
-Reusable standard screw models and matching Boolean hole tools for code3d.
+ISO and GB/T screw models with helical threads, named mounting references, and
+Boolean clearance-hole tools. All dimensions are in millimetres.
+
+Install `@code3d/core` and `@code3d/screws` together. The App supplies both when
+using its built-in Core.
 
 ```ts
-import {ISO4762} from '@code3d/screws';
+import * as ISO10642 from '@code3d/screws/iso10642';
+import * as ISO4762 from '@code3d/screws/iso4762';
+import * as ISO7380_1 from '@code3d/screws/iso7380-1';
+
+const countersunk = ISO10642.screw('M6', 20);
+const socketCap = ISO4762.screw('M6', 18);
+const button = ISO7380_1.screw('M6', 18);
+```
+
+Each standard has a public subpath with its own constructors, specifications
+and types. Prefer these subpaths to load only the selected standards and their
+shared code. The root also exports the same modules as namespaces. Multipart
+standard numbers use hyphens in subpaths and underscores in namespace names.
+
+## ISO standards and sizes
+
+| Namespace   | Import subpath             | Form                               | Presets                      |
+| ----------- | -------------------------- | ---------------------------------- | ---------------------------- |
+| `ISO4762`   | `@code3d/screws/iso4762`   | Hexagon socket cap                 | M3–M12                       |
+| `ISO10642`  | `@code3d/screws/iso10642`  | Countersunk hexagon socket         | M3–M12                       |
+| `ISO7380_1` | `@code3d/screws/iso7380-1` | Button hexagon socket              | M3–M12                       |
+| `ISO4017`   | `@code3d/screws/iso4017`   | Fully threaded hexagon head        | M3–M12                       |
+| `ISO4014`   | `@code3d/screws/iso4014`   | Partially threaded hexagon head    | M3–M12                       |
+| `ISO7380_2` | `@code3d/screws/iso7380-2` | Button hexagon socket with collar  | M3–M12                       |
+| `ISO4029`   | `@code3d/screws/iso4029`   | Cup-point hexagon socket set screw | M3–M12                       |
+| `ISO7045`   | `@code3d/screws/iso7045`   | H/Z cross-recessed pan head        | M3–M10                       |
+| `ISO14583`  | `@code3d/screws/iso14583`  | Hexalobular pan head               | M3–M10                       |
+| `ISO7379`   | `@code3d/screws/iso7379`   | Hexagon socket shoulder screw      | Shoulder Ø6.5, 8, 10, 13, 16 |
+
+Metric presets are M3, M4, M5, M6, M8, M10, and M12 where listed. All use coarse
+pitch. ISO 7379's shoulder sizes correspond to M5, M6, M8, M10, and M12 threads.
+
+## GB/T standards
+
+GB/T entries use `gb` followed by the standard number. A decimal part becomes
+a hyphen in the subpath and an underscore in the root namespace:
+
+```ts
+import * as GB70_1 from '@code3d/screws/gb70-1';
+import * as GB70_3 from '@code3d/screws/gb70-3';
+import * as GB5783 from '@code3d/screws/gb5783';
+
+const socketCap = GB70_1.screw('M6', 18);
+const countersunk = GB70_3.screw('M6', 20);
+const hexBolt = GB5783.screw('M6', 30);
+```
 
-const screw = ISO4762.screw('M6', 18);
-const hole = ISO4762.clearanceHole('M6', 10);
+The editions below are current as checked on 2026-09-12. Each standard links
+to its national standards record. These entries share nominal model dimensions
+and constructors with the corresponding ISO module **within the listed preset
+range**, including its types, length convention, drive options and mounting
+references. They do not assert that the complete GB/T and ISO product standards
+are identical: the adoption is modified (MOD), except GB/T 5281 (EQV).
+
+| Namespace | Subpath suffix | GB/T edition                                                                                      | ISO model   | Presets                      |
+| --------- | -------------- | ------------------------------------------------------------------------------------------------- | ----------- | ---------------------------- |
+| `GB70_1`  | `gb70-1`       | [70.1-2008](https://std.samr.gov.cn/gb/search/gbDetailed?id=71F772D7F825D3A7E05397BE0A0AB82A)     | `ISO4762`   | M3–M12                       |
+| `GB70_2`  | `gb70-2`       | [70.2-2025](https://openstd.samr.gov.cn/bzgk/std/newGbInfo?hcno=6F19BF92846B48BF27058E2B5299935E) | `ISO7380_1` | M3–M12                       |
+| `GB70_3`  | `gb70-3`       | [70.3-2023](https://std.samr.gov.cn/gb/search/gbDetailed?id=FC816D05003162EBE05397BE0A0AD5FA)     | `ISO10642`  | M3–M12                       |
+| `GB70_4`  | `gb70-4`       | [70.4-2025](https://std.samr.gov.cn/gb/search/gbDetailed?id=42BA7D06A4DCE936E06397BE0A0ACDC9)     | `ISO7380_2` | M3–M12                       |
+| `GB5782`  | `gb5782`       | [5782-2025](https://std.samr.gov.cn/gb/search/gbDetailed?id=jAnZliYiA5M%3D&mode=p)                | `ISO4014`   | M3–M12                       |
+| `GB5783`  | `gb5783`       | [5783-2025](https://std.samr.gov.cn/gb/search/gbDetailed?id=42BA7D06A331E936E06397BE0A0ACDC9)     | `ISO4017`   | M3–M12                       |
+| `GB818`   | `gb818`        | [818-2016](https://std.samr.gov.cn/gb/search/gbDetailed?id=71F772D813A1D3A7E05397BE0A0AB82A)      | `ISO7045`   | M3–M10                       |
+| `GB2672`  | `gb2672`       | [2672-2017](https://std.samr.gov.cn/gb/search/gbDetailed?id=71F772D818CAD3A7E05397BE0A0AB82A)     | `ISO14583`  | M3–M10                       |
+| `GB80`    | `gb80`         | [80-2007](https://std.samr.gov.cn/gb/search/gbDetailed?id=71F772D7890DD3A7E05397BE0A0AB82A)       | `ISO4029`   | M3–M12                       |
+| `GB5281`  | `gb5281`       | [5281-1985](https://std.samr.gov.cn/gb/search/gbDetailed?id=71F772D7AF1AD3A7E05397BE0A0AB82A)     | `ISO7379`   | Shoulder Ø6.5, 8, 10, 13, 16 |
+
+The 2025 editions of GB/T 70.2, 70.4, 5782 and 5783 took effect on
+2026-02-01. Presets remain the selected coarse sizes above; additions outside
+that set, such as M7 hexagon bolts and the M16 button-screw thread-length rule,
+are not included. Material, strength, coating, marking and tolerance
+requirements are outside the model scope. In particular, GB/T 5782/5783 use
+the modern M10/M12 hexagon widths of 16/18 mm, not older 17/19 mm variants.
+
+GB/T 70.1 holes include a counterbore by default; GB/T 70.3 holes include a
+90° countersink. Other headed GB/T entries accept an optional `counterbore`;
+GB/T 5281 takes a numeric shoulder diameter, and GB/T 80 has no clearance-hole
+constructor. The hole tools retain the ISO modules' fit and recess allowances
+described below; **they do not implement the GB/T 152 countersink/counterbore
+tables**. Use custom dimensions when a drawing specifies a particular hole.
+
+```ts
+import * as GB5281 from '@code3d/screws/gb5281';
+
+const hole = GB5281.clearanceHole(8, {
+  depth: 12,
+  diameter: 8.5,
+  counterbore: {diameter: 15, depth: 7},
+});
+const shoulder = GB5281.screw(8, 20).relate(part =>
+  part.headBottom.on(hole.counterboreBottom),
+);
 ```
 
-Clearance holes use the ISO 273 normal clearance and include the matching
-socket-head counterbore by default, for both the numeric overload and an
-options object. Pass `counterbore: false` explicitly to create a plain
-clearance hole; the options object also supports another fit or custom
-dimensions.
+## Length and mounting
 
-## Specification queries
+For ordinary headed screws, `screw(size, length)` measures length below the
+head. ISO 10642 includes the countersunk head in `length`; ISO 4029 measures
+the entire headless screw.
 
-`ISO4762.resolveSpecification(input)` accepts a size such as `'M6'` or a
-custom `ISO4762.Specification`. A size resolves to its entry in
-`ISO4762.specifications`; a specification object is returned unchanged.
+Headed screws expose `headTop`, `headBottom`, `shankTop`, `shankBottom`, and
+`shankAxis`. ISO 4029 instead exposes `driveTop`, `pointBottom`, and `threadAxis`.
+Lengths are along local Y; heads/drives face +Y and tips face −Y.
 
-`ISO4762.threadLength(spec, length)` returns the nominal thread length used
-by the screw builder, in millimeters. `length` is the screw length below the
-head. This query does not clamp the result to the available shank length;
-`screw()` applies that limit after allowing for the under-head transition.
+ISO 7379 takes the nominal **shoulder diameter and shoulder length**:
 
 ```ts
-const spec = ISO4762.resolveSpecification('M6');
-const nominalThreadLength = ISO4762.threadLength(spec, 30); // 24 mm
+import * as ISO7379 from '@code3d/screws/iso7379';
+
+const shoulder = ISO7379.screw(8, 20); // Ø8 × 20 shoulder, M6 × 11 projection
+const spec = ISO7379.resolveSpecification(8);
+// Overall length = spec.headHeight + 20 + spec.threadLength.
 ```
 
-The `ISO4762` namespace also exports the types used by these APIs, including
-`Specification`, `ScrewInput`, `SocketCapScrewElements`,
-`SocketCapHoleElements`, and `CounterboredSocketCapHoleElements`.
+Its references are `headTop`, `headBottom`, `shoulderTop`, `shoulderBottom`,
+`shoulderAxis`, `threadTop`, `threadBottom`, and `threadAxis`. The threaded
+projection includes its reduced neck. The shoulder length includes the relief
+beneath the head. The shoulder body uses the maximum h8 diameter, e.g. 7.99 mm
+for the Ø8 preset.
+
+## Clearance tools
+
+Use a hole model with `cut(stock, [hole])` and its named references for mounting.
+For headed metric screws, `fit: 'close' | 'normal' | 'loose'` selects ISO 273
+clearance; the default is `normal`. A custom `diameter` overrides it.
+
+- ISO 4762 includes a counterbore by default. Set `counterbore: false` for a
+  plain hole.
+- ISO 10642 includes a 90° countersink by default. Set `countersink: false` for
+  a plain hole, or `countersink: {diameter: ...}` to change the opening. Its
+  depth follows from the opening and passage diameters at the fixed 90° angle.
+- The other ordinary headed standards default to a plain hole. Set
+  `counterbore: true` or `{diameter, depth, axialClearance}` to recess the head.
+- ISO 7379 creates a shoulder passage with 0.2 mm diametral clearance by
+  default; `{depth, diameter}` controls a custom passage. Add `counterbore: true`
+  or `{diameter, depth, axialClearance}` to recess its head. The shoulder
+  allowance is a modeling default, not an ISO 273 fit.
+- ISO 4029 has no clearance-hole constructor; its mating feature is threaded.
+
+`depth` always measures the complete cutting tool. Counterbores default to
+head height + 0.5 mm depth and head diameter + 1 mm diameter (ISO 4762 uses
+its dedicated counterbore table). Countersinks default to head diameter +
+0.5 mm. These recess allowances are modeling defaults, not dimensions imposed
+by the screw product standards.
+
+ISO 7379 supports the same counterbore options as ordinary headed standards:
 
-The package currently implements ISO 4762 socket-head cap screws. Its source
-is organized by standard so additional screw families can be added without
-mixing their dimensional tables or model-specific elements.
+```ts
+import * as ISO7379 from '@code3d/screws/iso7379';
+
+const hole = ISO7379.clearanceHole(8, {
+  depth: 12, // Total tool depth, including the counterbore.
+  diameter: 8.5, // Shoulder passage diameter.
+  counterbore: {diameter: 15, depth: 7},
+});
+const shoulder = ISO7379.screw(8, 20).relate(part =>
+  part.headBottom.on(hole.counterboreBottom),
+);
+```
 
-Named mounting references such as `headBottom`, `shaftBottom`, and
-`counterboreBottom` are finite `Bound` values. For example,
-`tool.shaftBottom.on(plate.down.flip())` aligns the shaft's lower boundary with
-the plate's lower boundary without rotating the hole tool. `flip()` reverses
-facing while preserving the offset coordinate frame.
+Use `counterbore: true` for preset allowances. Within the counterbore options,
+`axialClearance` sets the extra depth above the head; an explicit `depth`
+overrides it. For example, `{axialClearance: 0}` seats the head flush.
 
-## Install and explore
+```ts
+import {box, cut} from '@code3d/core';
+import * as ISO10642 from '@code3d/screws/iso10642';
+
+const stock = box(30, 10, 30);
+const hole = ISO10642.clearanceHole('M6', 10);
+const plate = cut(stock, [hole]);
+const screw = ISO10642.screw('M6', 20).relate(part =>
+  part.headTop.on(hole.countersinkTop),
+);
+```
 
-The App includes Screws when using its built-in Core. In Node or a project with
-its own Core installation, install both packages:
+All hole models expose `shaftTop`, `shaftBottom`, and `shaftAxis`. Counterbored
+holes add `counterboreTop`/`counterboreBottom`; countersunk holes add
+`countersinkTop`/`countersinkBottom`. Plain-hole return types omit these recess
+references. Named boundaries are finite `Bound` values. For example,
+`tool.shaftBottom.on(plate.down.flip())` places a hole against the plate's lower
+boundary without rotating it; `flip()` reverses facing and preserves its offset
+coordinate frame. See the [socket-cap mounting example](../app/examples/assemblies/screw-box/model.ts).
+
+## Specifications and drives
+
+Each module exports `specifications`, `resolveSpecification(input)`, `Size`,
+`Specification`, `ScrewInput`, and `Screw`. A supplied specification object is
+returned unchanged, so callers can derive custom dimensions from a preset.
+
+Ordinary headed modules also expose `threadLength(spec, length)`. This returns
+the nominal thread length before the builder limits it to the available shaft
+and allows for its under-head transition. ISO 4017 threads the entire available
+shaft; ISO 4014 retains the unthreaded portion on longer bolts. ISO 7379's
+threaded projection is the fixed `spec.threadLength`; ISO 4029 is fully threaded.
+
+ISO 7045 defaults to type H and accepts `{recess: 'Z'}`. ISO 14583 selects its
+hexalobular recess number and dimensions from the screw size.
+
+```ts
+import * as ISO7045 from '@code3d/screws/iso7045';
 
-```sh
-npm install @code3d/core @code3d/screws
+const zDrive = ISO7045.screw('M4', 16, {recess: 'Z'});
 ```
 
-- [Public exports](src/library/index.ts), [ISO 4762 definitions and builders](src/library/iso-4762.ts),
-  and [thread geometry](src/library/thread.ts).
-- [Complete mounting example](../app/examples/website/fastener.ts) and [behavior tests](test/iso-4762.test.ts).
-- [Core relations and topology](../core/README.md), [modeling reference](../web/src/content/docs/docs/reference/screws.mdx),
-  and [agent modeling workflow](../../docs/agents/modeling.md).
+## Dimension sources and modeling scope
+
+These models support layout, visualization and Boolean assembly checks.
+Preset head, drive, shoulder and thread dimensions follow the linked tables;
+ISO and DIN dimensions are kept distinct (notably ISO 10642 heads, M10/M12 hex
+widths, and ISO 7045 M3/M5 heads).
+
+- [ISO 10642 dimensional drawing, VIPA](https://www.vipafasteners.com/files/0/886-HEXAGON_SOCKET_COUNTERSUNK_HEAD_SCREWS_ISO_10642_UNI_5933_DIN_7991.pdf)
+- [ISO 4014/4017 head and partial-thread dimensions, VIPA](https://www.vipafasteners.com/files/0/801-PARTIAL_THREAD_HEXAGON_HEAD_SCREWS_ISO_4014_UNI_5737_DIN_931.pdf)
+- [ISO 7380-1, Böllhoff](https://eshop-ro.boellhoff.com/out/media/pdf/ISO_7380-1_Stahl_10.9_Innensechskant___en.pdf)
+  and [ISO 7380-2, Böllhoff](https://eshop-cz.boellhoff.com/out/media/pdf/ISO_7380-2_Edelstahl_A2_Innensechskant___en.pdf)
+- [ISO 4029 / DIN 916, JC Fasteners](https://www.jcfasteners.com/wp-content/uploads/DIN-916-Grub-Screw-Cup-PT-B4A07-SS304.pdf)
+- [ISO 7045](https://www.finesz.com/ISO7045.php), [ISO 14583](https://www.finesz.com/ISO14583.php),
+  and [ISO 7379](https://www.finesz.com/ISO7379.php), Fine Fasteners
+- [ISO 10664:2014 basic hexalobular dimensions](https://cdn.standards.iteh.ai/samples/63207/f79670cf0a214881aa40b4822580cce3/ISO-10664-2014.pdf)
+
+Threads use a swept coarse-pitch profile with faded, axially trimmed ends.
+Under-head transitions and shoulder reliefs are simplified. Rounded heads
+include a small flat crown around the recess. Cross recesses use tapered wings
+with additional ribs for Z; hexalobular recesses use twelve tangent circular arcs
+with the nominal A/B envelope. Socket bottoms omit drill-point details. Cup
+points use a conical cavity and a narrow annular lip. These are nominal modeling
+representations, not manufacturing or inspection-gauge geometry. Tolerance
+stacks, coatings, strength grades and complete standard length series are not
+modeled; positive lengths must leave room for the relevant head, relief and
+thread features.
+
+## Source and verification
+
+[Complete mounting example](../app/examples/assemblies/screw-box/model.ts),
+[ISO gallery](../app/examples/iso-screws.ts),
+[GB/T gallery](../app/examples/gb-screws.ts),
+[public modules](src/library/index.ts), [geometry tests](test/standards.test.ts),
+[modeling reference](../web/src/content/docs/docs/reference/screws.mdx), and
+[agent modeling workflow](../../docs/agents/modeling.md).
 
 From the repository root, run `npm run build:packages` and
 `npm test --workspace @code3d/screws`.

package/bld/chunks/chunk-2DGVQRQ5.js

@@ -0,0 +1,78 @@
+import {
+  __export,
+  __name,
+  clearanceHole,
+  headedScrew,
+  hexSocket,
+  metric,
+  roundHead,
+  validateHead
+} from "./chunk-Z5LEGL77.js";
+
+// packages/screws/src/library/iso-7380-1.ts
+var iso_7380_1_exports = {};
+__export(iso_7380_1_exports, {
+  clearanceHole: () => clearanceHole2,
+  resolveSpecification: () => resolveSpecification,
+  screw: () => screw,
+  specifications: () => specifications,
+  threadLength: () => threadLength
+});
+function specification(size, headDiameter, headHeight, hexSocketWidth, hexSocketDepth, underHeadRadius) {
+  return {
+    ...metric(size),
+    headDiameter,
+    headHeight,
+    hexSocketWidth,
+    hexSocketDepth,
+    underHeadRadius
+  };
+}
+__name(specification, "specification");
+var specifications = {
+  M3: specification("M3", 5.7, 1.65, 2, 1.04, 0.1),
+  M4: specification("M4", 7.6, 2.2, 2.5, 1.3, 0.2),
+  M5: specification("M5", 9.5, 2.75, 3, 1.56, 0.2),
+  M6: specification("M6", 10.5, 3.3, 4, 2.08, 0.25),
+  M8: specification("M8", 14, 4.4, 5, 2.6, 0.4),
+  M10: specification("M10", 17.5, 5.5, 6, 3.12, 0.4),
+  M12: specification("M12", 21, 6.6, 8, 4.16, 0.6)
+};
+function resolveSpecification(input) {
+  return typeof input === "string" ? specifications[input] : input;
+}
+__name(resolveSpecification, "resolveSpecification");
+function threadLength(spec, _length) {
+  return 2 * spec.nominalDiameter + 12;
+}
+__name(threadLength, "threadLength");
+function screw(input, length) {
+  const spec = resolveSpecification(input);
+  validateHead(spec);
+  const blank = roundHead(
+    spec.headDiameter,
+    spec.headHeight,
+    Math.max(spec.nominalDiameter, spec.hexSocketWidth * 1.3)
+  );
+  return headedScrew(
+    hexSocket(blank, spec.hexSocketWidth, spec.hexSocketDepth, spec.headHeight),
+    spec,
+    length,
+    threadLength(spec, length)
+  );
+}
+__name(screw, "screw");
+function clearanceHole2(input, options) {
+  return clearanceHole(resolveSpecification(input), options);
+}
+__name(clearanceHole2, "clearanceHole");
+
+export {
+  specifications,
+  resolveSpecification,
+  threadLength,
+  screw,
+  clearanceHole2 as clearanceHole,
+  iso_7380_1_exports
+};
+//# sourceMappingURL=chunk-2DGVQRQ5.js.map

package/bld/chunks/chunk-2DGVQRQ5.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/iso-7380-1.ts"],
+  "sourcesContent": ["import {\n  metric,\n  validateHead,\n  headedScrew,\n  hexSocket,\n  roundHead,\n  clearanceHole as buildClearanceHole,\n  type HeadSpecification,\n  type MetricSize,\n  type Screw,\n  type ClearanceHole,\n  type CounterboredHole,\n  type ClearanceHoleOptions,\n  type PlainHoleOptions,\n  type CounterboredHoleOptions,\n} from './common.js';\nexport type {\n  ClearanceFit,\n  Screw,\n  ScrewElements,\n  ClearanceHole,\n  HoleElements,\n  CounterboredHole,\n  CounterboredHoleElements,\n  ClearanceHoleOptions,\n  PlainHoleOptions,\n  CounterboredHoleOptions,\n  CounterboreOptions,\n} from './common.js';\n\nexport type Specification = HeadSpecification &\n  Readonly<{hexSocketWidth: number; hexSocketDepth: number}>;\n\n// ISO 7380-1, k/dk maxima and nominal drive dimensions; millimetres.\n// https://eshop-ro.boellhoff.com/out/media/pdf/ISO_7380-1_Stahl_10.9_Innensechskant___en.pdf\nfunction specification(\n  size: MetricSize,\n  headDiameter: number,\n  headHeight: number,\n  hexSocketWidth: number,\n  hexSocketDepth: number,\n  underHeadRadius: number,\n): Specification {\n  return {\n    ...metric(size),\n    headDiameter,\n    headHeight,\n    hexSocketWidth,\n    hexSocketDepth,\n    underHeadRadius,\n  };\n}\nexport const specifications = {\n  M3: specification('M3', 5.7, 1.65, 2, 1.04, 0.1),\n  M4: specification('M4', 7.6, 2.2, 2.5, 1.3, 0.2),\n  M5: specification('M5', 9.5, 2.75, 3, 1.56, 0.2),\n  M6: specification('M6', 10.5, 3.3, 4, 2.08, 0.25),\n  M8: specification('M8', 14, 4.4, 5, 2.6, 0.4),\n  M10: specification('M10', 17.5, 5.5, 6, 3.12, 0.4),\n  M12: specification('M12', 21, 6.6, 8, 4.16, 0.6),\n} as const;\nexport type Size = keyof typeof specifications;\nexport type ScrewInput = Size | Specification;\nexport function resolveSpecification(input: ScrewInput): Specification {\n  return typeof input === 'string' ? specifications[input] : input;\n}\n/** Nominal partial thread b; the builder limits it to the available shank. */\nexport function threadLength(spec: Specification, _length: number): number {\n  return 2 * spec.nominalDiameter + 12;\n}\n/**\n * @code3d.arguments ['M6', 18]\n * @code3d.param length {kind: 'length'}\n */\nexport function screw(input: ScrewInput, length: number): Screw {\n  const spec = resolveSpecification(input);\n  validateHead(spec);\n  const blank = roundHead(\n    spec.headDiameter,\n    spec.headHeight,\n    Math.max(spec.nominalDiameter, spec.hexSocketWidth * 1.3),\n  );\n  return headedScrew(\n    hexSocket(blank, spec.hexSocketWidth, spec.hexSocketDepth, spec.headHeight),\n    spec,\n    length,\n    threadLength(spec, length),\n  );\n}\n\n/** @code3d.arguments ['M6', 10] */\nexport function clearanceHole(input: ScrewInput, depth: number): ClearanceHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: PlainHoleOptions,\n): ClearanceHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: CounterboredHoleOptions,\n): CounterboredHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: ClearanceHoleOptions,\n): ClearanceHole | CounterboredHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: number | ClearanceHoleOptions,\n): ClearanceHole | CounterboredHole {\n  return buildClearanceHole(resolveSpecification(input), options);\n}\n"],
+  "mappings": ";;;;;;;;;;;;AAAA;AAAA;AAAA,uBAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAmCA,SAAS,cACP,MACA,cACA,YACA,gBACA,gBACA,iBACe;AACf,SAAO;AAAA,IACL,GAAG,OAAO,IAAI;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAhBS;AAiBF,IAAM,iBAAiB;AAAA,EAC5B,IAAI,cAAc,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG;AAAA,EAC/C,IAAI,cAAc,MAAM,KAAK,KAAK,KAAK,KAAK,GAAG;AAAA,EAC/C,IAAI,cAAc,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG;AAAA,EAC/C,IAAI,cAAc,MAAM,MAAM,KAAK,GAAG,MAAM,IAAI;AAAA,EAChD,IAAI,cAAc,MAAM,IAAI,KAAK,GAAG,KAAK,GAAG;AAAA,EAC5C,KAAK,cAAc,OAAO,MAAM,KAAK,GAAG,MAAM,GAAG;AAAA,EACjD,KAAK,cAAc,OAAO,IAAI,KAAK,GAAG,MAAM,GAAG;AACjD;AAGO,SAAS,qBAAqB,OAAkC;AACrE,SAAO,OAAO,UAAU,WAAW,eAAe,KAAK,IAAI;AAC7D;AAFgB;AAIT,SAAS,aAAa,MAAqB,SAAyB;AACzE,SAAO,IAAI,KAAK,kBAAkB;AACpC;AAFgB;AAOT,SAAS,MAAM,OAAmB,QAAuB;AAC9D,QAAM,OAAO,qBAAqB,KAAK;AACvC,eAAa,IAAI;AACjB,QAAM,QAAQ;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,IAAI,KAAK,iBAAiB,KAAK,iBAAiB,GAAG;AAAA,EAC1D;AACA,SAAO;AAAA,IACL,UAAU,OAAO,KAAK,gBAAgB,KAAK,gBAAgB,KAAK,UAAU;AAAA,IAC1E;AAAA,IACA;AAAA,IACA,aAAa,MAAM,MAAM;AAAA,EAC3B;AACF;AAdgB;AA8BT,SAASC,eACd,OACA,SACkC;AAClC,SAAO,cAAmB,qBAAqB,KAAK,GAAG,OAAO;AAChE;AALgB,OAAAA,gBAAA;",
+  "names": ["clearanceHole", "clearanceHole"]
+}

package/bld/chunks/chunk-4FMUSJBB.js

@@ -0,0 +1,27 @@
+import {
+  clearanceHole,
+  resolveSpecification,
+  screw,
+  threadLength
+} from "./chunk-SDUJLXOE.js";
+import {
+  specifications
+} from "./chunk-GIIOR3XJ.js";
+import {
+  __export
+} from "./chunk-Z5LEGL77.js";
+
+// packages/screws/src/library/gb-5782.ts
+var gb_5782_exports = {};
+__export(gb_5782_exports, {
+  clearanceHole: () => clearanceHole,
+  resolveSpecification: () => resolveSpecification,
+  screw: () => screw,
+  specifications: () => specifications,
+  threadLength: () => threadLength
+});
+
+export {
+  gb_5782_exports
+};
+//# sourceMappingURL=chunk-4FMUSJBB.js.map

package/bld/chunks/chunk-4FMUSJBB.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/gb-5782.ts"],
+  "sourcesContent": ["/**\n * GB/T 5782-2025 (MOD ISO 4014:2022).\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=jAnZliYiA5M%3D&mode=p\n */\nexport * from './iso-4014.js';\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/bld/chunks/chunk-7UGU5EFV.js

@@ -0,0 +1,87 @@
+import {
+  __export,
+  __name,
+  clearanceHole,
+  crossSocket,
+  headedScrew,
+  metric,
+  panHead,
+  validateHead
+} from "./chunk-Z5LEGL77.js";
+
+// packages/screws/src/library/iso-7045.ts
+var iso_7045_exports = {};
+__export(iso_7045_exports, {
+  clearanceHole: () => clearanceHole2,
+  resolveSpecification: () => resolveSpecification,
+  screw: () => screw,
+  specifications: () => specifications,
+  threadLength: () => threadLength
+});
+function specification(size, headDiameter, headHeight, headCurvatureRadius, underHeadRadius, number, width, hDiameter, hDepth, zDiameter, zDepth) {
+  return {
+    ...metric(size),
+    headDiameter,
+    headHeight,
+    headCurvatureRadius,
+    underHeadRadius,
+    recesses: {
+      H: { number, width, diameter: hDiameter, depth: hDepth },
+      Z: { number, width, diameter: zDiameter, depth: zDepth }
+    }
+  };
+}
+__name(specification, "specification");
+var specifications = {
+  M3: specification("M3", 5.6, 2.4, 5, 0.1, 1, 0.97, 3, 1.4, 2.8, 1.5),
+  M4: specification("M4", 8, 3.1, 6.5, 0.2, 2, 1.47, 4.4, 1.9, 4.3, 1.89),
+  M5: specification("M5", 9.5, 3.7, 8, 0.2, 2, 1.47, 4.9, 2.4, 4.7, 2.29),
+  M6: specification("M6", 12, 4.6, 10, 0.25, 3, 2.41, 6.9, 3.1, 6.7, 3.03),
+  M8: specification("M8", 16, 6, 13, 0.4, 4, 3.48, 9, 4, 8.8, 4.05),
+  M10: specification("M10", 20, 7.5, 16, 0.4, 4, 3.48, 10.1, 5.2, 9.9, 5.24)
+};
+function resolveSpecification(input) {
+  return typeof input === "string" ? specifications[input] : input;
+}
+__name(resolveSpecification, "resolveSpecification");
+function threadLength(spec, _length) {
+  return spec.nominalDiameter <= 3 ? 25 : 38;
+}
+__name(threadLength, "threadLength");
+function screw(input, length, options = {}) {
+  const spec = resolveSpecification(input);
+  validateHead(spec);
+  const type = options.recess ?? "H";
+  if (type !== "H" && type !== "Z")
+    throw new Error("Cross recess type must be H or Z.");
+  const recess = spec.recesses[type];
+  if (recess.depth >= spec.headHeight || recess.width >= recess.diameter)
+    throw new Error("Cross recess must fit inside the head.");
+  const blank = panHead(
+    spec.headDiameter,
+    spec.headHeight,
+    recess.diameter * 1.05,
+    spec.headCurvatureRadius
+  );
+  return headedScrew(
+    crossSocket(blank, recess, type),
+    spec,
+    length,
+    threadLength(spec, length)
+  );
+}
+__name(screw, "screw");
+function clearanceHole2(input, options) {
+  return clearanceHole(resolveSpecification(input), options);
+}
+__name(clearanceHole2, "clearanceHole");
+
+export {
+  specifications,
+  resolveSpecification,
+  threadLength,
+  screw,
+  clearanceHole2 as clearanceHole,
+  iso_7045_exports
+};
+//# sourceMappingURL=chunk-7UGU5EFV.js.map

package/bld/chunks/chunk-7UGU5EFV.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/iso-7045.ts"],
+  "sourcesContent": ["import {\n  metric,\n  validateHead,\n  headedScrew,\n  panHead,\n  crossSocket,\n  clearanceHole as buildClearanceHole,\n  type CrossRecessType,\n  type CrossRecess,\n  type HeadSpecification,\n  type MetricSize,\n  type Screw,\n  type ClearanceHole,\n  type CounterboredHole,\n  type ClearanceHoleOptions,\n  type PlainHoleOptions,\n  type CounterboredHoleOptions,\n} from './common.js';\nexport type {\n  CrossRecessType,\n  CrossRecess,\n  ClearanceFit,\n  Screw,\n  ScrewElements,\n  ClearanceHole,\n  HoleElements,\n  CounterboredHole,\n  CounterboredHoleElements,\n  ClearanceHoleOptions,\n  PlainHoleOptions,\n  CounterboredHoleOptions,\n  CounterboreOptions,\n} from './common.js';\n\nexport type Specification = HeadSpecification &\n  Readonly<{\n    headCurvatureRadius: number;\n    recesses: Readonly<Record<CrossRecessType, CrossRecess>>;\n  }>;\nexport type ScrewOptions = Readonly<{recess?: CrossRecessType}>;\n// ISO 7045:2011 (M3 and M5 heads differ from DIN 7985). H/Z driving envelopes.\n// https://www.finesz.com/ISO7045.php\nfunction specification(\n  size: MetricSize,\n  headDiameter: number,\n  headHeight: number,\n  headCurvatureRadius: number,\n  underHeadRadius: number,\n  number: number,\n  width: number,\n  hDiameter: number,\n  hDepth: number,\n  zDiameter: number,\n  zDepth: number,\n): Specification {\n  return {\n    ...metric(size),\n    headDiameter,\n    headHeight,\n    headCurvatureRadius,\n    underHeadRadius,\n    recesses: {\n      H: {number, width, diameter: hDiameter, depth: hDepth},\n      Z: {number, width, diameter: zDiameter, depth: zDepth},\n    },\n  };\n}\nexport const specifications = {\n  M3: specification('M3', 5.6, 2.4, 5, 0.1, 1, 0.97, 3, 1.4, 2.8, 1.5),\n  M4: specification('M4', 8, 3.1, 6.5, 0.2, 2, 1.47, 4.4, 1.9, 4.3, 1.89),\n  M5: specification('M5', 9.5, 3.7, 8, 0.2, 2, 1.47, 4.9, 2.4, 4.7, 2.29),\n  M6: specification('M6', 12, 4.6, 10, 0.25, 3, 2.41, 6.9, 3.1, 6.7, 3.03),\n  M8: specification('M8', 16, 6, 13, 0.4, 4, 3.48, 9, 4, 8.8, 4.05),\n  M10: specification('M10', 20, 7.5, 16, 0.4, 4, 3.48, 10.1, 5.2, 9.9, 5.24),\n} as const;\nexport type Size = keyof typeof specifications;\nexport type ScrewInput = Size | Specification;\nexport function resolveSpecification(input: ScrewInput): Specification {\n  return typeof input === 'string' ? specifications[input] : input;\n}\n/** ISO minimum b; shorter screws are threaded to the head transition. */\nexport function threadLength(spec: Specification, _length: number): number {\n  return spec.nominalDiameter <= 3 ? 25 : 38;\n}\n/**\n * @code3d.arguments ['M6', 18]\n * @code3d.param length {kind: 'length'}\n */\nexport function screw(\n  input: ScrewInput,\n  length: number,\n  options: ScrewOptions = {},\n): Screw {\n  const spec = resolveSpecification(input);\n  validateHead(spec);\n  const type = options.recess ?? 'H';\n  if (type !== 'H' && type !== 'Z')\n    throw new Error('Cross recess type must be H or Z.');\n  const recess = spec.recesses[type];\n  if (recess.depth >= spec.headHeight || recess.width >= recess.diameter)\n    throw new Error('Cross recess must fit inside the head.');\n  const blank = panHead(\n    spec.headDiameter,\n    spec.headHeight,\n    recess.diameter * 1.05,\n    spec.headCurvatureRadius,\n  );\n  return headedScrew(\n    crossSocket(blank, recess, type),\n    spec,\n    length,\n    threadLength(spec, length),\n  );\n}\n/** @code3d.arguments ['M6', 10] */\nexport function clearanceHole(input: ScrewInput, depth: number): ClearanceHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: PlainHoleOptions,\n): ClearanceHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: CounterboredHoleOptions,\n): CounterboredHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: ClearanceHoleOptions,\n): ClearanceHole | CounterboredHole;\nexport function clearanceHole(\n  input: ScrewInput,\n  options: number | ClearanceHoleOptions,\n): ClearanceHole | CounterboredHole {\n  return buildClearanceHole(resolveSpecification(input), options);\n}\n"],
+  "mappings": ";;;;;;;;;;;;AAAA;AAAA;AAAA,uBAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AA0CA,SAAS,cACP,MACA,cACA,YACA,qBACA,iBACA,QACA,OACA,WACA,QACA,WACA,QACe;AACf,SAAO;AAAA,IACL,GAAG,OAAO,IAAI;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,MACR,GAAG,EAAC,QAAQ,OAAO,UAAU,WAAW,OAAO,OAAM;AAAA,MACrD,GAAG,EAAC,QAAQ,OAAO,UAAU,WAAW,OAAO,OAAM;AAAA,IACvD;AAAA,EACF;AACF;AAxBS;AAyBF,IAAM,iBAAiB;AAAA,EAC5B,IAAI,cAAc,MAAM,KAAK,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,KAAK,GAAG;AAAA,EACnE,IAAI,cAAc,MAAM,GAAG,KAAK,KAAK,KAAK,GAAG,MAAM,KAAK,KAAK,KAAK,IAAI;AAAA,EACtE,IAAI,cAAc,MAAM,KAAK,KAAK,GAAG,KAAK,GAAG,MAAM,KAAK,KAAK,KAAK,IAAI;AAAA,EACtE,IAAI,cAAc,MAAM,IAAI,KAAK,IAAI,MAAM,GAAG,MAAM,KAAK,KAAK,KAAK,IAAI;AAAA,EACvE,IAAI,cAAc,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,MAAM,GAAG,GAAG,KAAK,IAAI;AAAA,EAChE,KAAK,cAAc,OAAO,IAAI,KAAK,IAAI,KAAK,GAAG,MAAM,MAAM,KAAK,KAAK,IAAI;AAC3E;AAGO,SAAS,qBAAqB,OAAkC;AACrE,SAAO,OAAO,UAAU,WAAW,eAAe,KAAK,IAAI;AAC7D;AAFgB;AAIT,SAAS,aAAa,MAAqB,SAAyB;AACzE,SAAO,KAAK,mBAAmB,IAAI,KAAK;AAC1C;AAFgB;AAOT,SAAS,MACd,OACA,QACA,UAAwB,CAAC,GAClB;AACP,QAAM,OAAO,qBAAqB,KAAK;AACvC,eAAa,IAAI;AACjB,QAAM,OAAO,QAAQ,UAAU;AAC/B,MAAI,SAAS,OAAO,SAAS;AAC3B,UAAM,IAAI,MAAM,mCAAmC;AACrD,QAAM,SAAS,KAAK,SAAS,IAAI;AACjC,MAAI,OAAO,SAAS,KAAK,cAAc,OAAO,SAAS,OAAO;AAC5D,UAAM,IAAI,MAAM,wCAAwC;AAC1D,QAAM,QAAQ;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AAAA,IACL,OAAO,WAAW;AAAA,IAClB,KAAK;AAAA,EACP;AACA,SAAO;AAAA,IACL,YAAY,OAAO,QAAQ,IAAI;AAAA,IAC/B;AAAA,IACA;AAAA,IACA,aAAa,MAAM,MAAM;AAAA,EAC3B;AACF;AAzBgB;AAwCT,SAASC,eACd,OACA,SACkC;AAClC,SAAO,cAAmB,qBAAqB,KAAK,GAAG,OAAO;AAChE;AALgB,OAAAA,gBAAA;",
+  "names": ["clearanceHole", "clearanceHole"]
+}

package/bld/chunks/chunk-DKS4VANI.js

@@ -0,0 +1,27 @@
+import {
+  clearanceHole,
+  resolveSpecification,
+  screw,
+  threadLength
+} from "./chunk-P3M5KQ5U.js";
+import {
+  specifications
+} from "./chunk-GIIOR3XJ.js";
+import {
+  __export
+} from "./chunk-Z5LEGL77.js";
+
+// packages/screws/src/library/gb-5783.ts
+var gb_5783_exports = {};
+__export(gb_5783_exports, {
+  clearanceHole: () => clearanceHole,
+  resolveSpecification: () => resolveSpecification,
+  screw: () => screw,
+  specifications: () => specifications,
+  threadLength: () => threadLength
+});
+
+export {
+  gb_5783_exports
+};
+//# sourceMappingURL=chunk-DKS4VANI.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/gb-5783.ts"],
+  "sourcesContent": ["/**\n * GB/T 5783-2025 (MOD ISO 4017:2022).\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=42BA7D06A331E936E06397BE0A0ACDC9\n */\nexport * from './iso-4017.js';\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/bld/chunks/chunk-ES62SR3Q.js

@@ -0,0 +1,21 @@
+import {
+  resolveSpecification,
+  screw,
+  specifications
+} from "./chunk-O34BMYJV.js";
+import {
+  __export
+} from "./chunk-Z5LEGL77.js";
+
+// packages/screws/src/library/gb-80.ts
+var gb_80_exports = {};
+__export(gb_80_exports, {
+  resolveSpecification: () => resolveSpecification,
+  screw: () => screw,
+  specifications: () => specifications
+});
+
+export {
+  gb_80_exports
+};
+//# sourceMappingURL=chunk-ES62SR3Q.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/gb-80.ts"],
+  "sourcesContent": ["/**\n * GB/T 80-2007 (MOD ISO 4029:2003).\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=71F772D7890DD3A7E05397BE0A0AB82A\n */\nexport * from './iso-4029.js';\n"],
+  "mappings": ";;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/bld/chunks/chunk-ESLSQKZW.js

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/library/gb-818.ts"],
+  "sourcesContent": ["/**\n * GB/T 818-2016 (MOD ISO 7045:2011).\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=71F772D813A1D3A7E05397BE0A0AB82A\n */\nexport * from './iso-7045.js';\n"],
+  "mappings": ";;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}