gridfinity-rebase 0.1.0__tar.gz

gridfinity_rebase-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Szymon Krajewski
+Copyright (c) 2023 Kenneth Hodson
+Copyright (c) 2023 Zachary Freedman and Voidstar Lab LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gridfinity_rebase-0.1.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: gridfinity-rebase
+Version: 0.1.0
+Summary: Fast, validated Gridfinity STL foot replacement
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: numpy>=2.0,<3
+Requires-Dist: manifold3d>=3.5,<4
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Gridfinity Rebase
+
+CLI for replacing Gridfinity bin bases with configurable presets or a base copied from another STL.
+
+[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=000)](https://buymeacoffee.com/skrajewski)
+
+## Install
+
+Install Python 3.10+ and [uv](https://docs.astral.sh/uv/), then run this command from the repository:
+
+```sh
+uv tool install .
+```
+
+## Usage
+
+Pass an STL file to replace its base. You can also use the explicit
+`gridfinity-rebase rebase` subcommand. Run `gridfinity-rebase` without arguments
+to display help.
+
+```sh
+# Create smooth bottom-loading magnet pockets in bin-rebased-magnet-holes.stl.
+gridfinity-rebase bin.stl --preset magnet-holes
+
+# Create side-loading magnet pockets in bin-rebased-rebuilt.stl.
+gridfinity-rebase bin.stl --preset rebuilt
+
+# Create screw holes without magnet pockets in bin-rebased-screws.stl.
+gridfinity-rebase bin.stl --screws
+
+# Add screw holes to bottom-loading press-fit pockets
+gridfinity-rebase bin.stl --preset press-fit --screws
+
+# Place magnet pockets and screw holes only at the four outer corners of the bin.
+gridfinity-rebase bin.stl --preset rebuilt --screws --only-corners
+
+# Add side-loading magnet pockets and an M15x1.5 thumbscrew hole.
+# The output is bin-rebased-rebuilt-thumbscrew.stl.
+gridfinity-rebase bin.stl --preset rebuilt --thumbscrew
+
+# Copy a base from another bin
+gridfinity-rebase bin.stl --base donor.stl -o result.stl
+
+# Inspect a model or list presets
+gridfinity-rebase inspect bin.stl
+gridfinity-rebase presets
+```
+
+## Presets
+
+Available presets: `plain`, `magnet-holes`, `rebuilt` and `press-fit`.
+`refined` is an alias for `rebuilt`.
+
+`magnet-holes` creates smooth bottom-loading Ø6.5 × 2.4 mm pockets without ribs.
+`press-fit` adds eight crush ribs to each pocket. You can also get this geometry
+with `--preset magnet-holes --crush-ribs`.
+
+The previews show the same 2×3 example bin from underneath. Click a preview for the full-size image.
+Append the options in each row to `gridfinity-rebase bin.stl`.
+
+| Preview | Preset | Options |
+| --- | --- | --- |
+| [![Plain 2×3 bin base](docs/images/thumbnails/base-plain-2x3.png)](docs/images/base-plain-2x3.png) | `plain` creates standard feet without magnet pockets or screw holes. | `--preset plain` |
+| [![2×3 bin base with smooth bottom-loading magnet pockets](docs/images/thumbnails/base-magnet-holes-2x3.png)](docs/images/base-magnet-holes-2x3.png) | `magnet-holes` creates four Ø6.5 mm magnet pockets per foot, 2.4 mm deep, without crush ribs. | `--preset magnet-holes` |
+| [![2×3 bin base with side-loading magnet pockets](docs/images/thumbnails/base-rebuilt-2x3.png)](docs/images/base-rebuilt-2x3.png) | `rebuilt` creates four pockets per foot in a fan pattern, with one opening per edge. Small underside slots let you remove magnets. | `--preset rebuilt` |
+| [![2×3 bin base with ribbed bottom-loading magnet pockets](docs/images/thumbnails/base-press-fit-2x3.png)](docs/images/base-press-fit-2x3.png) | `press-fit` creates four bottom-loading pockets per foot, each with eight crush ribs. | `--preset press-fit` |
+
+### Geometry options
+
+The default preset is `plain`. Select another preset or change individual settings:
+
+- `--magnets none|side|bottom`: no magnet pockets, side-loading pockets, or bottom-loading pockets.
+- `--side-pocket-height MM`: set the side-loading pocket height. The default is 2.1 mm.
+- `--screws` / `--no-screws`: enable or disable 3 mm screw bores.
+- `--crush-ribs` / `--no-crush-ribs`: enable or disable ribs in bottom-loading pockets.
+- `--only-corners`: limit magnet pockets and 3 mm screw bores to the four outer corners of the whole bin, regardless of grid size. A 1×1 bin keeps all four holes. Central `--thumbscrew` holes still appear in every foot.
+- `--thumbscrew` / `--no-thumbscrew`: enable or disable the central threaded hole.
+
+### Examples with geometry options
+
+Add flags to a preset to combine magnet pockets, screws and central threads,
+or to place magnet pockets and screw bores only at the outer corners.
+
+| Preview | Description | Options |
+| --- | --- | --- |
+| [![2×3 bin base with side-loading magnet pockets and screw bores](docs/images/thumbnails/base-rebuilt-screws-2x3.png)](docs/images/base-rebuilt-screws-2x3.png) | Each side-loading pocket has a Ø3 mm screw bore. | `--preset rebuilt --screws` |
+| [![2×3 bin base with screw bores only](docs/images/thumbnails/base-screws-2x3.png)](docs/images/base-screws-2x3.png) | Each foot has four Ø3 mm screw bores without magnet pockets. | `--screws` |
+| [![2×3 bin base with press-fit magnet pockets and screw bores](docs/images/thumbnails/base-press-fit-screws-2x3.png)](docs/images/base-press-fit-screws-2x3.png) | Bottom-loading pockets have crush ribs and screw bores in their floors. | `--preset press-fit --screws` |
+| [![2×3 bin base with side-loading magnet pockets and central threads](docs/images/thumbnails/base-rebuilt-thumbscrew-2x3.png)](docs/images/base-rebuilt-thumbscrew-2x3.png) | Each foot has side-loading pockets and a central M15×1.5 threaded hole. | `--preset rebuilt --thumbscrew` |
+| [![2×3 bin base with magnet pockets only at the four outer corners](docs/images/thumbnails/base-rebuilt-only-corners-2x3.png)](docs/images/base-rebuilt-only-corners-2x3.png) | The whole bin has four side-loading pockets, one at each outer corner, instead of 24. | `--preset rebuilt --only-corners` |
+| [![2×3 bin base with side-loading magnet pockets, screw bores and central threads](docs/images/thumbnails/base-rebuilt-screws-thumbscrew-2x3.png)](docs/images/base-rebuilt-screws-thumbscrew-2x3.png) | The bin has 24 side pockets, 24 screw bores and six central threaded holes. | `--preset rebuilt --screws --thumbscrew` |
+| [![2×3 bin base with four outer-corner magnet pockets and screw bores, plus six central threads](docs/images/thumbnails/base-rebuilt-screws-thumbscrew-only-corners-2x3.png)](docs/images/base-rebuilt-screws-thumbscrew-only-corners-2x3.png) | The whole bin has four side pockets and four screw bores at its outer corners. All six feet have a central threaded hole. | `--preset rebuilt --screws --thumbscrew --only-corners` |
+
+### Close-ups
+
+| Preview | Description | Options |
+| --- | --- | --- |
+| [![Close-up of a side-loading magnet pocket](docs/images/thumbnails/detail-side-loading.png)](docs/images/detail-side-loading.png) | The magnet slides through the opening in the edge of the foot. | `--preset rebuilt` |
+| [![Close-up of a smooth bottom magnet pocket](docs/images/thumbnails/detail-magnet-holes.png)](docs/images/detail-magnet-holes.png) | Insert the magnet into the circular recess from underneath. | `--preset magnet-holes` |
+| [![Close-up of the eight crush ribs in a magnet pocket](docs/images/thumbnails/detail-crush-ribs.png)](docs/images/detail-crush-ribs.png) | Eight ribs narrow the pocket for a press fit. | `--preset press-fit` |
+| [![Close-up of a central M15×1.5 threaded hole](docs/images/thumbnails/detail-thumbscrew.png)](docs/images/detail-thumbscrew.png) | The M15×1.5 threaded hole is 4.75 mm deep, with a solid bridge above. | `--preset rebuilt --thumbscrew` |
+
+The images show geometry generated by the CLI. [Regenerate the graphics](docs/images/README.md).
+
+See [curve resolution](docs/segments.md) for `--segments` settings and visual comparisons.
+
+## Key details
+
+- The CLI supports standard rectangular Gridfinity bins on a 42 mm grid. Use millimeters for STL units, with feet at the bottom and Z pointing up.
+- The CLI detects the base and cut height. It preserves the bin interior and geometry above the cut, and rejects invalid meshes, incompatible bases and ambiguous models.
+- A donor base can match the input grid or have its X/Y dimensions swapped. The CLI can also tile a 1×1 donor base across the input.
+- Unmodified presets write to `bin-rebased-PRESET.stl`. `--thumbscrew` and `--only-corners` append their names to the filename. Modified settings use a descriptive suffix, such as `bin-rebased-magnets-bottom-crush-ribs-screws.stl`. Donor bases use `bin-rebased.stl`. Use `-o` to choose a filename and `--overwrite` to replace an existing output.
+- JSON reports include the resolved `geometry` settings. `base` identifies the starting preset or donor path. The default preset is `plain`. For donor bases, `geometry` is `null`.
+- `--base-height MM` overrides automatic detection for custom models and replaces everything below that height. The minimum is 4.75 mm.
+
+Run `gridfinity-rebase --help` for all options.
+
+## Performance
+
+Run the benchmark from the repository root:
+
+```sh
+uv run --locked --python 3.11 python scripts/benchmark.py --runs 5
+```
+
+The benchmark generates all test models locally. You do not need to download example STLs.
+See [benchmark instructions, methodology and reference results](docs/performance.md)
+for JSON output and environment details.
+
+## AI Disclosure
+
+Szymon here. I use AI to build this tool.
+
+I needed a way for quick replacement of base of custom Grdifnity bins downloaded from Internet, but I didn't want to spend too much of my free time on this. I collaborated with the AI, describing how it should work, how I want to use it and what's the important from the both code perspective and end-user perspective. It allowed me to iterate and create something that is exactly what I needed. Now I share it with you.
+
+Just want you to know.
+
+## License
+
+The [MIT license](LICENSE) covers this CLI and its adapted preset implementation.
+
+Processing a model does not replace its existing license or attribution
+requirements. When sharing a rebased STL, preserve applicable notices and
+comply with the licenses of the input model and any donor geometry.
+
+## Acknowledgements
+
+Preset geometry is adapted from the MIT-licensed [Gridfinity Rebuilt implementation](https://github.com/kennetek/gridfinity-rebuilt-openscad/tree/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd)
+by Kenneth Hodson, based on Gridfinity by Zack Freedman. Rebuilt credits
+[Gridfinity Refined](https://www.printables.com/model/413761-gridfinity-refined)
+by grizzie17 as the source of its side-loading magnet pockets.
+
+Rebuilt source files at revision `910e22d8607fd7f5f51ad5e5cbc5287a76810bfd`:
+
+- [standard.scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/core/standard.scad): mating profile, grid, radii and hole dimensions.
+- [gridfinity-rebuilt-holes.scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/core/gridfinity-rebuilt-holes.scad): side-loading magnet pockets and crush ribs.
+- [base.scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/core/base.scad): fan arrangement of the four pockets and the central threaded hole.
+
+The native thumbscrew thread tessellation derives from `ScrewThread()` in
+[threads-scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/external/threads-scad/threads.scad),
+created in 2016 — 2017 by Ryan A. Colyer and released under [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/).

gridfinity_rebase-0.1.0/README.md

@@ -0,0 +1,161 @@
+# Gridfinity Rebase
+
+CLI for replacing Gridfinity bin bases with configurable presets or a base copied from another STL.
+
+[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=000)](https://buymeacoffee.com/skrajewski)
+
+## Install
+
+Install Python 3.10+ and [uv](https://docs.astral.sh/uv/), then run this command from the repository:
+
+```sh
+uv tool install .
+```
+
+## Usage
+
+Pass an STL file to replace its base. You can also use the explicit
+`gridfinity-rebase rebase` subcommand. Run `gridfinity-rebase` without arguments
+to display help.
+
+```sh
+# Create smooth bottom-loading magnet pockets in bin-rebased-magnet-holes.stl.
+gridfinity-rebase bin.stl --preset magnet-holes
+
+# Create side-loading magnet pockets in bin-rebased-rebuilt.stl.
+gridfinity-rebase bin.stl --preset rebuilt
+
+# Create screw holes without magnet pockets in bin-rebased-screws.stl.
+gridfinity-rebase bin.stl --screws
+
+# Add screw holes to bottom-loading press-fit pockets
+gridfinity-rebase bin.stl --preset press-fit --screws
+
+# Place magnet pockets and screw holes only at the four outer corners of the bin.
+gridfinity-rebase bin.stl --preset rebuilt --screws --only-corners
+
+# Add side-loading magnet pockets and an M15x1.5 thumbscrew hole.
+# The output is bin-rebased-rebuilt-thumbscrew.stl.
+gridfinity-rebase bin.stl --preset rebuilt --thumbscrew
+
+# Copy a base from another bin
+gridfinity-rebase bin.stl --base donor.stl -o result.stl
+
+# Inspect a model or list presets
+gridfinity-rebase inspect bin.stl
+gridfinity-rebase presets
+```
+
+## Presets
+
+Available presets: `plain`, `magnet-holes`, `rebuilt` and `press-fit`.
+`refined` is an alias for `rebuilt`.
+
+`magnet-holes` creates smooth bottom-loading Ø6.5 × 2.4 mm pockets without ribs.
+`press-fit` adds eight crush ribs to each pocket. You can also get this geometry
+with `--preset magnet-holes --crush-ribs`.
+
+The previews show the same 2×3 example bin from underneath. Click a preview for the full-size image.
+Append the options in each row to `gridfinity-rebase bin.stl`.
+
+| Preview | Preset | Options |
+| --- | --- | --- |
+| [![Plain 2×3 bin base](docs/images/thumbnails/base-plain-2x3.png)](docs/images/base-plain-2x3.png) | `plain` creates standard feet without magnet pockets or screw holes. | `--preset plain` |
+| [![2×3 bin base with smooth bottom-loading magnet pockets](docs/images/thumbnails/base-magnet-holes-2x3.png)](docs/images/base-magnet-holes-2x3.png) | `magnet-holes` creates four Ø6.5 mm magnet pockets per foot, 2.4 mm deep, without crush ribs. | `--preset magnet-holes` |
+| [![2×3 bin base with side-loading magnet pockets](docs/images/thumbnails/base-rebuilt-2x3.png)](docs/images/base-rebuilt-2x3.png) | `rebuilt` creates four pockets per foot in a fan pattern, with one opening per edge. Small underside slots let you remove magnets. | `--preset rebuilt` |
+| [![2×3 bin base with ribbed bottom-loading magnet pockets](docs/images/thumbnails/base-press-fit-2x3.png)](docs/images/base-press-fit-2x3.png) | `press-fit` creates four bottom-loading pockets per foot, each with eight crush ribs. | `--preset press-fit` |
+
+### Geometry options
+
+The default preset is `plain`. Select another preset or change individual settings:
+
+- `--magnets none|side|bottom`: no magnet pockets, side-loading pockets, or bottom-loading pockets.
+- `--side-pocket-height MM`: set the side-loading pocket height. The default is 2.1 mm.
+- `--screws` / `--no-screws`: enable or disable 3 mm screw bores.
+- `--crush-ribs` / `--no-crush-ribs`: enable or disable ribs in bottom-loading pockets.
+- `--only-corners`: limit magnet pockets and 3 mm screw bores to the four outer corners of the whole bin, regardless of grid size. A 1×1 bin keeps all four holes. Central `--thumbscrew` holes still appear in every foot.
+- `--thumbscrew` / `--no-thumbscrew`: enable or disable the central threaded hole.
+
+### Examples with geometry options
+
+Add flags to a preset to combine magnet pockets, screws and central threads,
+or to place magnet pockets and screw bores only at the outer corners.
+
+| Preview | Description | Options |
+| --- | --- | --- |
+| [![2×3 bin base with side-loading magnet pockets and screw bores](docs/images/thumbnails/base-rebuilt-screws-2x3.png)](docs/images/base-rebuilt-screws-2x3.png) | Each side-loading pocket has a Ø3 mm screw bore. | `--preset rebuilt --screws` |
+| [![2×3 bin base with screw bores only](docs/images/thumbnails/base-screws-2x3.png)](docs/images/base-screws-2x3.png) | Each foot has four Ø3 mm screw bores without magnet pockets. | `--screws` |
+| [![2×3 bin base with press-fit magnet pockets and screw bores](docs/images/thumbnails/base-press-fit-screws-2x3.png)](docs/images/base-press-fit-screws-2x3.png) | Bottom-loading pockets have crush ribs and screw bores in their floors. | `--preset press-fit --screws` |
+| [![2×3 bin base with side-loading magnet pockets and central threads](docs/images/thumbnails/base-rebuilt-thumbscrew-2x3.png)](docs/images/base-rebuilt-thumbscrew-2x3.png) | Each foot has side-loading pockets and a central M15×1.5 threaded hole. | `--preset rebuilt --thumbscrew` |
+| [![2×3 bin base with magnet pockets only at the four outer corners](docs/images/thumbnails/base-rebuilt-only-corners-2x3.png)](docs/images/base-rebuilt-only-corners-2x3.png) | The whole bin has four side-loading pockets, one at each outer corner, instead of 24. | `--preset rebuilt --only-corners` |
+| [![2×3 bin base with side-loading magnet pockets, screw bores and central threads](docs/images/thumbnails/base-rebuilt-screws-thumbscrew-2x3.png)](docs/images/base-rebuilt-screws-thumbscrew-2x3.png) | The bin has 24 side pockets, 24 screw bores and six central threaded holes. | `--preset rebuilt --screws --thumbscrew` |
+| [![2×3 bin base with four outer-corner magnet pockets and screw bores, plus six central threads](docs/images/thumbnails/base-rebuilt-screws-thumbscrew-only-corners-2x3.png)](docs/images/base-rebuilt-screws-thumbscrew-only-corners-2x3.png) | The whole bin has four side pockets and four screw bores at its outer corners. All six feet have a central threaded hole. | `--preset rebuilt --screws --thumbscrew --only-corners` |
+
+### Close-ups
+
+| Preview | Description | Options |
+| --- | --- | --- |
+| [![Close-up of a side-loading magnet pocket](docs/images/thumbnails/detail-side-loading.png)](docs/images/detail-side-loading.png) | The magnet slides through the opening in the edge of the foot. | `--preset rebuilt` |
+| [![Close-up of a smooth bottom magnet pocket](docs/images/thumbnails/detail-magnet-holes.png)](docs/images/detail-magnet-holes.png) | Insert the magnet into the circular recess from underneath. | `--preset magnet-holes` |
+| [![Close-up of the eight crush ribs in a magnet pocket](docs/images/thumbnails/detail-crush-ribs.png)](docs/images/detail-crush-ribs.png) | Eight ribs narrow the pocket for a press fit. | `--preset press-fit` |
+| [![Close-up of a central M15×1.5 threaded hole](docs/images/thumbnails/detail-thumbscrew.png)](docs/images/detail-thumbscrew.png) | The M15×1.5 threaded hole is 4.75 mm deep, with a solid bridge above. | `--preset rebuilt --thumbscrew` |
+
+The images show geometry generated by the CLI. [Regenerate the graphics](docs/images/README.md).
+
+See [curve resolution](docs/segments.md) for `--segments` settings and visual comparisons.
+
+## Key details
+
+- The CLI supports standard rectangular Gridfinity bins on a 42 mm grid. Use millimeters for STL units, with feet at the bottom and Z pointing up.
+- The CLI detects the base and cut height. It preserves the bin interior and geometry above the cut, and rejects invalid meshes, incompatible bases and ambiguous models.
+- A donor base can match the input grid or have its X/Y dimensions swapped. The CLI can also tile a 1×1 donor base across the input.
+- Unmodified presets write to `bin-rebased-PRESET.stl`. `--thumbscrew` and `--only-corners` append their names to the filename. Modified settings use a descriptive suffix, such as `bin-rebased-magnets-bottom-crush-ribs-screws.stl`. Donor bases use `bin-rebased.stl`. Use `-o` to choose a filename and `--overwrite` to replace an existing output.
+- JSON reports include the resolved `geometry` settings. `base` identifies the starting preset or donor path. The default preset is `plain`. For donor bases, `geometry` is `null`.
+- `--base-height MM` overrides automatic detection for custom models and replaces everything below that height. The minimum is 4.75 mm.
+
+Run `gridfinity-rebase --help` for all options.
+
+## Performance
+
+Run the benchmark from the repository root:
+
+```sh
+uv run --locked --python 3.11 python scripts/benchmark.py --runs 5
+```
+
+The benchmark generates all test models locally. You do not need to download example STLs.
+See [benchmark instructions, methodology and reference results](docs/performance.md)
+for JSON output and environment details.
+
+## AI Disclosure
+
+Szymon here. I use AI to build this tool.
+
+I needed a way for quick replacement of base of custom Grdifnity bins downloaded from Internet, but I didn't want to spend too much of my free time on this. I collaborated with the AI, describing how it should work, how I want to use it and what's the important from the both code perspective and end-user perspective. It allowed me to iterate and create something that is exactly what I needed. Now I share it with you.
+
+Just want you to know.
+
+## License
+
+The [MIT license](LICENSE) covers this CLI and its adapted preset implementation.
+
+Processing a model does not replace its existing license or attribution
+requirements. When sharing a rebased STL, preserve applicable notices and
+comply with the licenses of the input model and any donor geometry.
+
+## Acknowledgements
+
+Preset geometry is adapted from the MIT-licensed [Gridfinity Rebuilt implementation](https://github.com/kennetek/gridfinity-rebuilt-openscad/tree/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd)
+by Kenneth Hodson, based on Gridfinity by Zack Freedman. Rebuilt credits
+[Gridfinity Refined](https://www.printables.com/model/413761-gridfinity-refined)
+by grizzie17 as the source of its side-loading magnet pockets.
+
+Rebuilt source files at revision `910e22d8607fd7f5f51ad5e5cbc5287a76810bfd`:
+
+- [standard.scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/core/standard.scad): mating profile, grid, radii and hole dimensions.
+- [gridfinity-rebuilt-holes.scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/core/gridfinity-rebuilt-holes.scad): side-loading magnet pockets and crush ribs.
+- [base.scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/core/base.scad): fan arrangement of the four pockets and the central threaded hole.
+
+The native thumbscrew thread tessellation derives from `ScrewThread()` in
+[threads-scad](https://github.com/kennetek/gridfinity-rebuilt-openscad/blob/910e22d8607fd7f5f51ad5e5cbc5287a76810bfd/src/external/threads-scad/threads.scad),
+created in 2016 — 2017 by Ryan A. Colyer and released under [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/).

gridfinity_rebase-0.1.0/docs/benchmark.json

@@ -0,0 +1,186 @@
+{
+  "measured_at_utc": "2026-10-13T21:57:46.970337+00:00",
+  "platform": "macOS-26.2-arm64-arm-64bit",
+  "machine": "arm64",
+  "processor": "arm",
+  "logical_cpus": 12,
+  "python": "3.11.14",
+  "dependencies": {
+    "gridfinity-rebase": "0.2.1",
+    "manifold3d": "3.5.4",
+    "numpy": "2.4.6"
+  },
+  "runs": 5,
+  "warmups_per_scenario": 1,
+  "segments": 64,
+  "inputs": {
+    "1x1": {
+      "sha256": "b3b6c2ad78f0e541e5e90331b669c8eaff3a692773903fc71c41b03e225bf184",
+      "triangles": 1894
+    },
+    "donor": {
+      "sha256": "b3b6c2ad78f0e541e5e90331b669c8eaff3a692773903fc71c41b03e225bf184",
+      "triangles": 1894
+    },
+    "6x6": {
+      "sha256": "c65ebe2a72559086b1a7fa85df1fdde08dccaef808ebc5581f53459b682f24d9",
+      "triangles": 58246
+    }
+  },
+  "results": [
+    {
+      "scenario": "1x1/plain",
+      "input_triangles": 1894,
+      "process_median_ms": 94.51,
+      "process_min_ms": 89.43,
+      "process_max_ms": 95.4,
+      "warm_engine_median_ms": 12.46,
+      "process_samples_ms": [
+        94.5103750564158,
+        89.4317920319736,
+        89.57604202441871,
+        95.39591695647687,
+        94.918749993667
+      ],
+      "warm_engine_samples_ms": [
+        12.875832966528833,
+        12.11520901415497,
+        12.394832912832499,
+        12.613541912287474,
+        12.457333039492369
+      ]
+    },
+    {
+      "scenario": "1x1/rebuilt",
+      "input_triangles": 1894,
+      "process_median_ms": 94.41,
+      "process_min_ms": 93.3,
+      "process_max_ms": 97.89,
+      "warm_engine_median_ms": 14.64,
+      "process_samples_ms": [
+        94.40787509083748,
+        97.88887505419552,
+        93.29600003547966,
+        94.29145907051861,
+        97.07208396866918
+      ],
+      "warm_engine_samples_ms": [
+        15.291957999579608,
+        14.654417056590319,
+        14.159000013023615,
+        14.640958048403263,
+        14.112790930084884
+      ]
+    },
+    {
+      "scenario": "1x1/rebuilt-screws",
+      "input_triangles": 1894,
+      "process_median_ms": 112.18,
+      "process_min_ms": 110.47,
+      "process_max_ms": 115.48,
+      "warm_engine_median_ms": 28.16,
+      "process_samples_ms": [
+        115.48470810521394,
+        111.7373340530321,
+        112.17912496067584,
+        110.46716605778784,
+        115.03658397123218
+      ],
+      "warm_engine_samples_ms": [
+        27.97850000206381,
+        28.1615830026567,
+        27.632666984573007,
+        28.340917080640793,
+        28.18029106128961
+      ]
+    },
+    {
+      "scenario": "1x1/refined",
+      "input_triangles": 1894,
+      "process_median_ms": 87.83,
+      "process_min_ms": 87.02,
+      "process_max_ms": 89.51,
+      "warm_engine_median_ms": 14.14,
+      "process_samples_ms": [
+        87.8272500121966,
+        87.02079206705093,
+        89.35604197904468,
+        87.70487492438406,
+        89.51008401345462
+      ],
+      "warm_engine_samples_ms": [
+        14.215333969332278,
+        13.873500050976872,
+        14.188083005137742,
+        13.950416934676468,
+        14.141583000309765
+      ]
+    },
+    {
+      "scenario": "1x1/press-fit",
+      "input_triangles": 1894,
+      "process_median_ms": 87.83,
+      "process_min_ms": 86.86,
+      "process_max_ms": 90.24,
+      "warm_engine_median_ms": 13.72,
+      "process_samples_ms": [
+        87.73008291609585,
+        88.37041701190174,
+        90.24062496609986,
+        86.86333289369941,
+        87.8282500198111
+      ],
+      "warm_engine_samples_ms": [
+        13.611625065095723,
+        13.737166998907924,
+        13.724167016334832,
+        13.462667004205287,
+        14.19558294583112
+      ]
+    },
+    {
+      "scenario": "1x1/donor",
+      "input_triangles": 1894,
+      "process_median_ms": 89.76,
+      "process_min_ms": 89.11,
+      "process_max_ms": 91.82,
+      "warm_engine_median_ms": 18.54,
+      "process_samples_ms": [
+        90.0000830879435,
+        89.24408291932195,
+        89.1148749506101,
+        89.76320794317871,
+        91.8165419716388
+      ],
+      "warm_engine_samples_ms": [
+        18.746749963611364,
+        18.00991699565202,
+        18.890125094912946,
+        18.205416039563715,
+        18.536541028879583
+      ]
+    },
+    {
+      "scenario": "6x6/refined",
+      "input_triangles": 58246,
+      "process_median_ms": 260.88,
+      "process_min_ms": 257.67,
+      "process_max_ms": 270.68,
+      "warm_engine_median_ms": 178.35,
+      "process_samples_ms": [
+        264.94266698136926,
+        260.8814589912072,
+        257.6676660683006,
+        260.19500009715557,
+        270.68120893090963
+      ],
+      "warm_engine_samples_ms": [
+        179.92949998006225,
+        178.08800004422665,
+        178.34912496618927,
+        178.3229160355404,
+        179.09554205834866
+      ]
+    }
+  ]
+}

gridfinity_rebase-0.1.0/docs/images/README.md

@@ -0,0 +1,47 @@
+# README graphics
+
+Each PNG contains one model or one close-up, without embedded text. The main
+README places the images in tables with descriptions and the corresponding CLI
+options. Clicking a thumbnail opens the full-size image.
+The `thumbnails/` directory contains 260 px previews, so the README can use
+standard Markdown image links without HTML sizing attributes.
+
+The `base-*-2x3.png` images show the underside of the same synthetic 2×3 example
+bin, using `generate_base()` and the CLI's resolved geometry options. They use
+the same body, camera, orthographic scale and lighting. The `detail-*.png` images
+show crops of those same models. Magnification varies between details.
+
+The four preset images are `base-plain-2x3.png`,
+`base-magnet-holes-2x3.png`, `base-rebuilt-2x3.png` and
+`base-press-fit-2x3.png`. `refined` shares the `rebuilt` image because it is
+an alias. Other base images illustrate combinations of geometry flags,
+such as `rebuilt` with `--screws`.
+The `detail-magnet-holes.png` and `detail-crush-ribs.png` close-ups show
+the difference between smooth magnet pockets and `press-fit`.
+
+The `detail-segments-{32,64,256}.png` images compare a central threaded
+hole in a generated 1×1 base at three curve resolutions. All three use the same
+camera, scale and lighting. Only the base's segment count changes.
+
+Regenerate from the repository root:
+
+```sh
+uv run --with pillow python scripts/render_readme.py
+```
+
+Regenerate only the three resolution comparisons and their thumbnails:
+
+```sh
+uv run --with pillow python scripts/render_readme.py --segments-only
+```
+
+The renderer uses NumPy and Pillow with a triangle depth buffer. It needs no
+display, GPU or external CAD renderer. The command installs Pillow as a temporary
+dependency. Preset and geometry option illustrations use 256 segments by default
+for close-ups, independently of the CLI's default of 64. The resolution
+comparisons always use 32, 64 and 256, regardless of the renderer's `--segments`
+argument. Edit descriptions and options in the README.
+
+The shared example body is 21 mm high, with a cavity starting at 8 mm. Its base
+extends to 7 mm. The body has no stacking lip because these illustrations
+focus on the feet and mounting options.