weldbox 0.1.0__tar.gz

weldbox-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,15 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  fast-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Run fast tests (frame math, features, dedupe — no CAD kernel)
+        run: uv run pytest -m "not slow" -q

weldbox-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Build sdist and wheel
+        run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/weldbox
+    permissions:
+      id-token: write  # OIDC for PyPI trusted publishing — no API token needed
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

weldbox-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.venv/
+out/
+dist/
+.pytest_cache/
+.DS_Store

weldbox-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Texabama Labs
+
+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.

weldbox-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: weldbox
+Version: 0.1.0
+Summary: Generate vendor-ready tube laser cut lists (STEP) and sheet panel DXFs for welded square-tube boxes
+License-File: LICENSE
+Requires-Python: <3.13,>=3.10
+Requires-Dist: build123d>=0.8
+Requires-Dist: ezdxf>=1.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12

weldbox-0.1.0/PRD.md

@@ -0,0 +1,49 @@
+Tube Box Generator
+
+Many laser cutting services are exposing tube cutting as a service. Tubes, particularly square tube can be cut to length so that they can be welded together to form machinery boxes/cabinet bases. 
+
+Services that expose this service include:
+
+https://www.fabworks.com/services/tube-laser-cutting
+https://tube.oshcut.com/
+https://www.rmfg.com/laser-tube-cutting
+
+
+I would like to be able to spec the outer dimentions of a box (larger than 12" x 12" x 12") and have the pieces automatically generated as a cut list (multiple step files) for easy upload to the services. I have attached step and/or dfx  patterns for RFMG and OshCut in /docs/samples/<vendor_name>/**
+
+I have also put tables (partial) of the materials offered as a markdown file in /docs/samples/<vendor_name>/material_list.md
+
+I think the experience would be improved by a user interface, but a terminal interface with questions like inclusion of gussets, or additional supports (blocking?)  would be helpful. We might also want to spec sheet metal siding that can easily be tack welded or rivited (we pre-cut the rivet holes in the tube for sheet metal adhesion). 
+
+We have freecad installed, I'm ok with leveraging that as a partial visual for the final assembly. If possible, I would like to avoid creating a 3d viewer in javascript - that seems like a waste of time.
+
+We want to have some some tab/slot setup to improve assembly and welding:
+
+In tube laser cutting, tab-and-slot connections (or hook-in-slot designs) allow two pieces of metal to interlock and self-locate. This eliminates the need for expensive jigs, clamps, and manual layout during assembly. Tabs are typically designed to be slightly smaller than the slot width to create an easy slip-fit for welding.Design Best PracticesClearance: To achieve a proper slip fit, make your slot's width and length at least 0.010 inches (or roughly 0.25 mm) larger than the thickness of the mating tab.Radius and Corner Relief: Right angles and square corners create localized stress concentration points in the metal tubing. Always incorporate small radii or "dog-bone" reliefs in the corners of your slots to prevent cracking during use.Self-Fixturing: Design the tabs so the parts interlock perfectly at the correct angle (e.g., 90° for frames). This allows the connected tubes to hold themselves in position while being tack-welded.
+
+
+Example Use Case:
+
+Name: Winding Machine Cell
+Vendor: RFMG
+Material: 1.5 x 1.5 x .120 in Square Tube	Square	1.5" × 1.5"	wall-thickness:0.12	corner-radus:0.24
+Exterior Size:
+  height: 2000mm
+  width: 1000mm
+  depth: 800mm
+Blocking: 
+  a. perpedicular to height axis at 1000mm ("work surface"). 3x evenly spaced blocking of work surface extending from front to back(depth)
+  b. vertical supports between base and this at midpoints
+  c. midpoint of top extending across the width
+  d. midpoint of bottom extending across the width
+  
+Sheet metal siding:
+  attachment: rivet 100mm spacing 1/4" rivet
+  pieces:
+    a. sides (stainless - 0.038")
+    b. back (stainless - 0.038")
+quantity: 5
+
+
+
+

weldbox-0.1.0/README.md

@@ -0,0 +1,146 @@
+# weldbox
+
+Vendor-ready tube-laser cut lists for jigless welded frames — STEP + DXF
+from a YAML spec.
+
+| Enclosure with riveted siding (`full_height_posts`) | Bench frame (`top_bottom_frames`) |
+|---|---|
+| ![Winding machine cell: tube frame with work surface and riveted stainless siding](docs/images/weldbox_sample_1.jpg) | ![Epoxy machine cell: bench frame with solid full-width rails and posts butting up into them](docs/images/weldbox_sample_2.jpg) |
+
+Generate laser tube cut lists for welded square-tube boxes and machine
+bases. From a single YAML spec, weldbox produces:
+
+- **`parts/*.step`** — one STEP file per unique tube part (deduplicated with
+  quantities), ready to upload to a tube laser service (RFMG, OshCut, Fabworks)
+- **`panels/*.dxf`** — flat patterns for riveted sheet-metal siding, with
+  rivet holes that match the holes pre-cut in the tubes
+- **`assembly.step`** — the full assembly for visual review (open in FreeCAD)
+- **`cutlist.md` / `cutlist.csv`** — the manifest with lengths and quantities
+
+Frames are self-fixturing: tee joints get through-wall tab-and-slot features
+(slip fit +0.25mm, dog-bone corner reliefs per vendor best practice) so parts
+interlock at 90° for tack welding without jigs.
+
+**[Read the functionality deep dive →](docs/FUNCTIONALITY.md)** — topologies,
+blocking primitives, the tab/slot system, part-count consolidation, siding,
+shipping checks, and the full spec reference.
+
+## Quick start
+
+```sh
+uv sync
+
+# browse a vendor's tube catalog
+uv run weldbox catalog list --vendor rfmg --shape square
+
+# check the cut list without generating CAD (fast)
+uv run weldbox generate examples/winding_machine_cell.yaml --dry-run
+
+# full generation
+uv run weldbox generate examples/winding_machine_cell.yaml -o out
+open out/winding-machine-cell/assembly.step   # opens in FreeCAD
+
+# author a new spec interactively
+uv run weldbox wizard
+```
+
+## The spec file
+
+The YAML spec is the source of truth (the wizard just writes one). Lengths
+accept unit suffixes (`2000mm`, `1.5in`, `0.038"`, `1/4in`); bare numbers are
+millimetres. See `examples/winding_machine_cell.yaml` for a complete example:
+
+```yaml
+name: Winding Machine Cell
+vendor: rfmg
+material: {shape: square, size: [1.5in], wall: 0.120in, family: A500}
+exterior: {height: 2000mm, width: 1000mm, depth: 800mm}
+topology: full_height_posts
+blocking:
+  - type: level          # horizontal frame; top surface at `height`
+    name: work-surface
+    height: 1000mm
+    cross_members: {count: 3, axis: depth}
+  - type: supports        # verticals between two layers, at rail midpoints
+    between: [base, work-surface]
+  - type: spanner         # single member across a face
+    face: top
+    axis: width
+siding:
+  attachment: {method: rivet, rivet: 0.25in, spacing: 100mm}
+  panels:
+    - {faces: [left, right, back], material: {alloy: "304", thickness: 0.038"}}
+quantity: 5
+```
+
+### Conventions
+
+- Box coordinates: X = width, Y = depth, Z = height; the exterior dimensions
+  are outer envelope dimensions.
+- `full_height_posts`: 4 posts run full height; all rails butt between posts.
+- `level` heights place the level's **top surface** at the given height (it
+  is a work surface); use `height_ref: centerline|bottom_face` to override.
+- Rivet holes: rivet diameter + 0.15mm clearance, evenly pitched at
+  `spacing`, on every member whose outer face lies on a sided box face.
+  Panel DXF holes are derived from the same list, so they always line up.
+- All joints get tab/slot by default, including box corners — corner slots
+  that land flush with a post end become open hook-in notches. Disable with
+  `joints: {corner_tabs: false}`. `joints.weld_gap` shortens butting ends.
+- Sheet panels get a `siding.corner_radius` (default 5mm) applied to the
+  DXF outline and the assembly solids; panels carry their rivet holes in 3D.
+- Same-size panels consolidate into one flat part (vendors price multiples
+  cheaper): a sheet with through-holes can be flipped or rotated 180 in
+  plane, so left/right, front/back, and top/bottom pairs share one DXF
+  (e.g. `left-right.dxf`, qty 2). When hole patterns differ, the union is
+  cut into both so the blank stays reversible; conflicting patterns stay
+  separate parts.
+- In the assembly STEP, members are colored by role (posts slate, rails
+  gray, level rails teal, crosses orange, supports green, spanners purple)
+  and panels are translucent. The assembly is written as flat named
+  products (one per member/panel) with colors on every face, which FreeCAD
+  imports as individually selectable/hideable colored objects regardless
+  of its STEP import preferences.
+- `consolidate: true` (default) adds sacrificial slots/holes so same-length
+  members collapse into one part number — the example box goes from 13
+  unique parts to 3. Set `consolidate: false` if you don't want unused
+  cuts on visible faces.
+
+## Vendors
+
+`rfmg` is fully encoded (from `docs/samples/rfmg/material_list.md`); `oshcut`
+and `fabtech` are stubs awaiting material lists. Vendor shipping rules
+(RFMG's LTL freight thresholds, see `docs/samples/rfmg/shipping.md`) drive
+an order-level estimate: the generator weighs the cut list analytically and
+warns — in the console and on `cutlist.md` — when a part dimension or the
+order weight will trigger freight, with the specific reasons and the flat
+surcharge. Vendor catalogs live in
+`src/weldbox/vendors/data/*.yaml` — dimensions in inches as published, with
+corner radius falling back to 2 x wall where unpublished.
+
+## Development
+
+```sh
+uv run pytest -m "not slow"   # fast tests: frame math, features, dedupe (<1s)
+uv run pytest -m slow         # geometry tests (build123d/OpenCascade)
+uv run pytest                 # everything
+```
+
+Pipeline: `spec.py` (YAML schema) → `frame.py`/`blocking.py` (member/joint
+math, no CAD) → `features.py` (tab/slot/hole placement, no CAD) →
+`dedupe.py` (symmetry-aware part grouping) → `geometry/` (build123d solids,
+STEP) + `panels/` (DXF) → `manifest.py`.
+
+All dimension and placement math is CAD-free and covered by fast tests;
+geometry tests verify solids against analytic volumes and RFMG's published
+stock STEP files, and assert zero interference at assembled joints.
+
+## License and attribution
+
+weldbox is released under the [MIT License](LICENSE).
+
+The RFMG reference data in `docs/samples/rfmg/` (tube profile
+specifications, stock STEP/DXF geometry, and shipping thresholds) is
+published by RMFG as design-against reference material for their laser tube
+cutting service: <https://www.rmfg.com/docs/services/laser-tube-cutting>.
+It is included here for interoperability and remains theirs; weldbox is not
+affiliated with or endorsed by RMFG.

weldbox-0.1.0/docs/FUNCTIONALITY.md

@@ -0,0 +1,323 @@
+# weldbox — Functionality Deep Dive
+
+weldbox turns a short YAML description of a welded square-tube box — a
+machine base, enclosure, cart, bench, or cabinet frame — into everything a
+laser tube cutting service needs to make the parts, and everything you need
+to weld them together without a jig.
+
+```
+ spec.yaml ──▶ frame math ──▶ features ──▶ consolidation ──▶ outputs
+ (source of    members +      tabs/slots/   fewer unique      STEP per part
+  truth)       joints         rivet holes   part numbers      DXF per panel
+                                                              assembly STEP
+                                                              cut list + shipping
+```
+
+Everything up to geometry is pure math (no CAD kernel), so `--dry-run`
+gives you a complete priced-out cut list in under a second.
+
+---
+
+## 1. The workflow
+
+```sh
+uv run weldbox catalog list --vendor rfmg          # 1. pick stock
+uv run weldbox wizard                              # 2. author a spec (or write YAML by hand)
+uv run weldbox generate my-box.yaml --dry-run      # 3. sanity-check the cut list + shipping
+uv run weldbox generate my-box.yaml -o out         # 4. produce files
+open out/my-box/assembly.step                      # 5. review in FreeCAD
+# 6. upload out/my-box/parts/*.step and panels/*.dxf to the vendor
+```
+
+The YAML spec is the source of truth. The wizard is only a convenience that
+writes one; you can always edit the file directly and regenerate.
+
+---
+
+## 2. The spec file, field by field
+
+All lengths accept unit suffixes — `2000mm`, `1.5in`, `0.038"`, `1/4in`,
+`3 1/2 in`, `2cm`, `1m` — and bare numbers are millimetres. Unknown fields
+are **rejected with an error**, never silently ignored, so a typo cannot
+quietly change your build.
+
+```yaml
+name: Epoxy Machine Cell        # used for output folder and file names
+vendor: rfmg                    # rfmg | oshcut | fabtech (stubs)
+material:                       # catalog lookup key, not free-form:
+  shape: square                 #   must match a profile the vendor stocks
+  size: [1.5in]                 #   [w] or [w, h]
+  wall: 0.120in
+  family: A500                  #   disambiguates A500 vs 304 vs 6061 at the same size
+exterior:                       # OUTER envelope of the frame
+  height: 860mm                 #   Z
+  width: 2000mm                 #   X
+  depth: 660mm                  #   Y
+topology: top_bottom_frames     # see section 3
+joints:                         # all optional; defaults shown
+  style: through_wall_tab       #   or plain_butt (no tabs anywhere)
+  slot_clearance: 0.25mm        #   slip fit: slot = tab + this
+  tab_width_fraction: 0.5       #   tab width as fraction of the receiving flat
+  dogbone_radius: 1.0mm         #   corner relief circles in slots
+  weld_gap: 0mm                 #   shortens every butting end
+  corner_tabs: true             #   tab/slot at box corners too
+blocking: [...]                 # see section 4
+siding: {...}                   # see section 5
+quantity: 5                     # assemblies; multiplies the cut list
+consolidate: true               # see section 6
+```
+
+`material` must resolve to a real vendor profile — weldbox models the
+vendor's actual stock (including the published outside corner radius) so
+the STEP files you upload match what the service quotes against.
+
+---
+
+## 3. Topologies — how the box is framed
+
+### `full_height_posts`
+
+Four posts run the full height; every horizontal rail butts between them.
+The classic cabinet/enclosure frame — vertical loads go straight down the
+posts to the floor.
+
+```
+ ┌─post──────post─┐        posts:  height H        x4
+ │  ═══rails═══   │        rails:  width  − 2×tube
+ ║                ║                depth  − 2×tube
+ │  ═══rails═══   │
+ └─post──────post─┘
+```
+
+### `top_bottom_frames`
+
+The top and bottom are complete rectangular frames whose **width rails run
+solid across the full exterior width**; the depth rails butt between them,
+and the posts butt *up into* the frames, tabbing into the full-width rails.
+Right for benches and long tables where you want unbroken members across
+the span (and two frames you can weld up flat on a table first).
+
+```
+ ╔════ solid width rail ════╗     top frame
+ ║ post   post   post  post ║     posts: height − 2×tube, tab up/down
+ ╚════ solid width rail ════╝     bottom frame
+```
+
+---
+
+## 4. Blocking — interior structure
+
+Three primitives, freely combined in the `blocking:` list.
+
+### `level` — a horizontal frame at any height
+
+```yaml
+- type: level
+  name: work-surface            # referenced by supports
+  height: 1000mm
+  height_ref: top_face          # top_face (default) | centerline | bottom_face
+  cross_members: {count: 3, axis: depth}
+```
+
+A level is a full perimeter frame (4 rails teed into the posts) with
+optional evenly spaced cross members butted between its rails.
+`height_ref: top_face` means the *surface you'd put something on* is at the
+given height — it's a work surface. Heights are validated against the box:
+if a level can't fit, the error tells you the exact legal range for your
+tube size and box height.
+
+### `supports` — verticals between two layers
+
+```yaml
+- type: supports
+  between: [base, work-surface]   # any two of: base, top, or a level name
+  at: midpoints
+```
+
+Places a vertical member at the midpoint of each of the four rail pairs of
+the two layers, butted between the lower rails' top faces and the upper
+rails' bottom faces — load paths under a work surface without blocking the
+interior.
+
+### `spanner` — members across the top or bottom face
+
+```yaml
+- type: spanner
+  face: [top, bottom]           # one face or a list
+  axis: depth                   # width | depth
+  count: 3                      # evenly spaced at k/(count+1)
+  position: 0.5                 # used only when count == 1
+```
+
+Spanners butt between the two face rails perpendicular to their axis —
+mounting rails for equipment, caster plates, or deck support.
+
+---
+
+## 5. Sheet metal siding
+
+```yaml
+siding:
+  attachment: {method: rivet, rivet: 1/4in, spacing: 100mm, hole_clearance: 0.15mm}
+  panels:
+    - {faces: [left, right, back], material: {alloy: "304", thickness: 0.038"}}
+  panel_margin: 0mm             # inset from the frame edge
+  corner_radius: 5mm            # sheet corner radius (DXF + 3D)
+```
+
+What you get:
+
+- **Rivet holes pre-cut in the tubes.** Every member whose outer face lies
+  on a sided box face gets holes — rivet diameter + clearance (1/4" →
+  6.5mm), evenly pitched at `spacing`, symmetric about the member's middle
+  with a 20mm end margin. That includes mid-frame members (a level rail or
+  support on a sided face gets a rivet row too).
+- **A DXF flat pattern per unique panel** — closed polyline outline with
+  true arc corners at `corner_radius`, CIRCLE holes, millimetre units
+  (`$INSUNITS = 4`), DXF R2000 — the format flat-laser vendors ingest
+  directly (SendCutSend, OshCut, Fabworks flat service).
+- **Guaranteed alignment.** Panel holes are derived from the *same* planned
+  holes as the tube cuts — they cannot drift apart.
+- Panels appear in the assembly STEP as translucent solids with their holes
+  and rounded corners, sitting proud on the frame face.
+
+---
+
+## 6. Part-count consolidation
+
+Vendors price multiples of the same part dramatically cheaper, so weldbox
+works hard to minimize unique part numbers (`consolidate: true`, the
+default).
+
+**Tubes.** Members with the same profile and cut length often differ only
+in *which faces* carry slots or holes. weldbox aligns every member of such
+a group through the square tube's 8 symmetries (4 rotations × end-for-end
+flip), unions the feature sets, and cuts the union into all of them. The
+extra cuts are sacrificial — unused slots or holes over solid tube — and
+the pass is guarded: it only ever *adds cuts* (never tabs), it never lets
+two features come closer than a 0.5mm web, and a member that can't merge
+safely keeps its own part number.
+
+**Panels.** A flat sheet with through-holes can be flipped over or rotated
+180° in plane, so left/right, front/back, and top/bottom panels of the same
+size merge into one blank (`left-right.dxf`, qty 2). Differing hole
+patterns are unioned under the best alignment; patterns that would collide
+stay separate.
+
+Real numbers: the PRD's winding machine cell is 25 members that would
+naively be 13 unique parts — consolidation ships it as **3**. The epoxy
+cell's 22 members also ship as **3** (its posts and supports turn out to be
+literally the same part).
+
+Set `consolidate: false` if you don't want sacrificial cuts on visible
+faces — only exactly-identical parts merge then.
+
+---
+
+## 7. The tab/slot system (jigless welding)
+
+Every joint self-locates for tack welding — no jigs, clamps, or layout:
+
+- At each butting end, the two walls parallel to the receiving member's
+  axis each grow a **tab**: the wall's own thickness, half the receiving
+  flat width wide, protruding exactly one receiving-wall thickness so it
+  finishes **flush with the far side of the wall** after welding.
+- The receiving face gets matching **through-wall slots** at
+  tab + 0.25mm (the 0.010" slip fit tube-laser vendors recommend), with
+  **dog-bone relief circles** in the corners so the slot can't start a
+  crack.
+- Slots always land on the flat region between the tube's corner radii.
+- At box corners, the outer tab's slot lands flush with the post end and
+  becomes an **open hook-in notch** — drop the rail in, it self-squares.
+- Everything is tunable per spec (`joints:`): clearance, tab width
+  fraction, dog-bone radius, weld gap, corner tabs on/off, or
+  `style: plain_butt` for plain saw-style cuts.
+
+Correctness is enforced by the test suite: assembled members are checked
+for **zero boolean interference** — every tab passes exactly through its
+slot void.
+
+---
+
+## 8. Outputs
+
+```
+out/<name>/
+├── cutlist.md            # human cut list + shipping estimate
+├── cutlist.csv           # same data for spreadsheets
+├── parts/
+│   └── <name>_<part>_<length>mm_x<qty>.step
+├── panels/
+│   └── <name>_<faces>.dxf
+└── assembly.step         # open in FreeCAD
+```
+
+- **Part STEPs** are built in the vendor-stock convention (cross-section
+  centered on origin, extruded along +Z) and modeled against the vendor's
+  published geometry — the generated 1.5×1.5×0.120 profile matches RFMG's
+  own reference STEP within 0.5%.
+- **The assembly STEP** contains one *named product per member and panel*
+  (`post-fl`, `work-surface-cross-2`, `panel-back`, …), colored by role —
+  posts slate, rails gray, level rails teal, crosses orange, supports
+  green, spanners purple, panels translucent — with colors on every face,
+  so FreeCAD shows an inspectable, hideable, colored model regardless of
+  its STEP import preferences.
+- **The cut list** shows per-part length (mm and inches), quantity per
+  assembly, and total quantity across the order, plus total stock meters.
+
+### Design-rule and shipping checks
+
+Every run (including `--dry-run`) checks the vendor's design rules
+(minimum hole diameter, dog-bone radius, maximum part length) and estimates
+the **order shipping**: analytic part weights (section area × length ×
+material density; sheet area × thickness) against the vendor's parcel
+limits. For RFMG that means LTL freight is flagged — with the specific
+trigger and the $200 flat surcharge — when any part exceeds 100 lb or 60"
+(or 48"×30" on two dimensions), or the order exceeds 200 lb.
+
+---
+
+## 9. Vendors
+
+Vendor data lives in `src/weldbox/vendors/data/*.yaml` behind a small
+`Vendor` interface (catalog, design rules, shipping rules, file naming):
+
+- **rfmg** — fully encoded: 56 profiles (A500/4130/DOM steel, 304
+  stainless, 6061/6063 aluminum) with published corner radii, design notes,
+  and LTL freight thresholds. Source:
+  <https://www.rmfg.com/docs/services/laser-tube-cutting>
+- **oshcut**, **fabtech** — registered stubs awaiting material lists.
+
+To add a vendor: drop a `data/<slug>.yaml` (dimensions in inches as
+published; omit corner radius where unpublished and weldbox assumes
+2×wall), subclass `Vendor` with its rules, and register it. Catalog lookups
+are tolerant (±0.02mm) and demand a `family` when a size/wall exists in
+several alloys.
+
+---
+
+## 10. Validation and errors
+
+- Unknown/typo'd spec fields → error naming the exact path
+  (`blocking.1.spanner.cross_members: Extra inputs are not permitted`).
+- Level heights → validated against the box with the legal range in the
+  message, in *your* `height_ref` terms.
+- Exterior too small for the tube, unknown vendors/layers, ambiguous
+  catalog matches → specific errors.
+- The CLI prints one clean error line and exits 1 — no tracebacks.
+
+---
+
+## 11. Current limitations
+
+- Frame math supports **square tube** only (rect/round profiles exist in
+  the catalog for future use; round stock is not applicable to this joint
+  system).
+- One tube profile per box.
+- Gussets are not yet generated.
+- Blocking members can be placed at positions that collide with each other
+  (e.g. a spanner through a support); member-vs-member placement collision
+  checking is on the roadmap — the bounding-box overlap tests catch this in
+  the standard layouts.
+- `oshcut`/`fabtech` catalogs are empty until their material lists are
+  transcribed.

weldbox-0.1.0/docs/samples/fabtech/material_list.md

@@ -0,0 +1 @@
+todo

weldbox-0.1.0/docs/samples/oshcut/material_list.md

@@ -0,0 +1 @@
+todo