diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/README.md b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/README.md
new file mode 100644
index 000000000..c381a591d
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/README.md
@@ -0,0 +1,58 @@
+# @tmnl/mantis-terrarium-jscad
+
+TypeScript is the CAD authoring source. Leftover FreeCAD/OCCT under `cad/src/**` is emit only. PR 34 and PR 36 stay emit. Do not copy leftover OCCT as authority.
+
+The tree still has one envelope cuboid: 250 x 250 x 500 mm, origin front-left-bottom. X right, Y back, Z up. The 202 x 202 x 427 mm animal-clear box is a keep-out record, not a subtracted void. PARAMS does not lock that void's Z origin.
+
+B20 is the continuous animal/wet barrier. These solids are nonmetal. No animal-side copper, pogo, or metal mesh is authored here.
+
+## Named solids
+
+| solid | balloon | PARAMS rows | what is modeled | omitted |
+| --- | --- | --- | --- | --- |
+| enclosure envelope | — | `frame.exterior.width/depth/height` LOCK | one cuboid `[0,0,0]→[250,250,500]` | animal-clear void Z |
+| `B01-corner-block` | B01 | `frame.band` REF; instances also use exterior 250/250/500 and pitch/span 250/500 | unique 24 mm cube; eight instances at the envelope corners | leftover pocket/inset cuts |
+| `B05-view-cassette` | B05 | `panel.stock_thickness` 3.00 mm LOCK; `animal.clear.width/height` 202 x 427 CALCULATED | local plate 202 x 3 x 427 mm | world face and gasket Z; seat pocket |
+| `B06-front-door` | B06 | `panel.stock_thickness` 3.00 mm LOCK; `animal.clear.width/height` 202 x 427 CALCULATED | local plate 202 x 3 x 427 mm | world face, swing, nymph-gap cut |
+
+Cassette seat is `stock + 0.20 mm` TARGET (3.20 mm). It is recorded, not a pocket. Screen aperture `<=0.80 mm` nonmetal is LOCK on B11, not a cut in these plates. In-plane plate size is CALCULATED before gasket closure.
+
+`npm run generate` projects each authored solid with `@jscad/modeling` `extrusions.project({axis, origin}, solid)`, converts the geom2 outlines to closed `path2` via `geom2.toOutlines` and `path2.fromPoints({closed: true})`, sets stroke with `colors.colorize([0, 0, 0, 1], path)`, then writes SVG with `@jscad/svg-serializer` `serialize({unit: 'mm'}, ...paths)`. Official serializer fills geom2 black and strokes path2. Generate never passes geom2 to serialize.
+
+Those files are class generated, not shop-release. Leftover S01 stays the extract view. `generated/VIEWS.md` lists every file generate wrote.
+
+Envelope still uses the short names `front.svg`, `side.svg`, and `top.svg`. Every solid also writes `{solid}-{view}.svg`.
+
+| file | solid | view | axis | origin | plane |
+| --- | --- | --- | --- | --- | --- |
+| `generated/front.svg` | envelope | front | `[0, 1, 0]` | `[0, 0, 0]` | XZ |
+| `generated/side.svg` | envelope | side | `[1, 0, 0]` | `[0, 0, 0]` | YZ |
+| `generated/top.svg` | envelope | top | `[0, 0, 1]` | `[0, 0, 0]` | XY |
+| `generated/envelope-front.svg` | envelope | front | `[0, 1, 0]` | `[0, 0, 0]` | XZ |
+| `generated/envelope-side.svg` | envelope | side | `[1, 0, 0]` | `[0, 0, 0]` | YZ |
+| `generated/envelope-top.svg` | envelope | top | `[0, 0, 1]` | `[0, 0, 0]` | XY |
+| `generated/B01-corner-block-front.svg` | B01 | front | `[0, 1, 0]` | `[0, 0, 0]` | XZ |
+| `generated/B01-corner-block-side.svg` | B01 | side | `[1, 0, 0]` | `[0, 0, 0]` | YZ |
+| `generated/B01-corner-block-top.svg` | B01 | top | `[0, 0, 1]` | `[0, 0, 0]` | XY |
+| `generated/B05-view-cassette-front.svg` | B05 | front | `[0, 1, 0]` | `[0, 0, 0]` | XZ |
+| `generated/B05-view-cassette-side.svg` | B05 | side | `[1, 0, 0]` | `[0, 0, 0]` | YZ |
+| `generated/B05-view-cassette-top.svg` | B05 | top | `[0, 0, 1]` | `[0, 0, 0]` | XY |
+| `generated/B06-front-door-front.svg` | B06 | front | `[0, 1, 0]` | `[0, 0, 0]` | XZ |
+| `generated/B06-front-door-side.svg` | B06 | side | `[1, 0, 0]` | `[0, 0, 0]` | YZ |
+| `generated/B06-front-door-top.svg` | B06 | top | `[0, 0, 1]` | `[0, 0, 0]` | XY |
+
+`axis` is the official `project()` plane normal. Front is the Y-normal plane. Side is the X-normal plane. Top is the Z-normal plane, the library default. B05 front is the 202 x 427 mm plate. B01 is the unique 24 mm cube. The eight instance origins live in `generated/VIEWS.md`.
+
+STL and STEP emit throw. PNG/iso stay blank. `gl` created a context on this coupon. Official `@jscad/regl-renderer` `demo-cli.js` then failed with `Cannot find module '@jscad/img-utils'`. No PNG was written. Maturity is DRAFT.
+
+## Draft in-house print
+
+A local person has Bambu printers. Path is FDM on Bambu. Printer model is UNVERIFIED. Nozzle and bed size stay unnamed until that person names them.
+
+Printed candidates are REF printed solids. Acrylic B05 and B06, screen B11, and bought Particle/ADI parts are not printed.
+
+Filament (PETG/ASA on B01) stays REF until the local person names it.
+
+Shop outreach is Tuesday 2026-08-25. This packet is DRAFT, not shop-release.
+
+Leftover FreeCAD/OCCT stay emit. The SVG generate path above stays. No STL just to have a file. No cuboid shop drawing.
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-front.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-front.svg
new file mode 100644
index 000000000..63f059418
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-front.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-side.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-side.svg
new file mode 100644
index 000000000..3151e8f99
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-side.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-top.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-top.svg
new file mode 100644
index 000000000..c4adf700a
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B01-corner-block-top.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-front.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-front.svg
new file mode 100644
index 000000000..27854524d
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-front.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-side.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-side.svg
new file mode 100644
index 000000000..1a994e12a
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-side.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-top.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-top.svg
new file mode 100644
index 000000000..479ac0f96
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B05-view-cassette-top.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-front.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-front.svg
new file mode 100644
index 000000000..27854524d
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-front.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-side.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-side.svg
new file mode 100644
index 000000000..1a994e12a
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-side.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-top.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-top.svg
new file mode 100644
index 000000000..479ac0f96
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/B06-front-door-top.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/VIEWS.md b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/VIEWS.md
new file mode 100644
index 000000000..d331a885a
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/VIEWS.md
@@ -0,0 +1,43 @@
+# Generated orthographic views
+
+class: generated. Not shop-release.
+Leftover S01 stays the extract view.
+
+Command: `npm run generate`
+Each still is `extrusions.project({axis, origin}, solid)`, then `geom2.toOutlines`, closed `path2.fromPoints`, `colors.colorize([0, 0, 0, 1], path)`, then `svgSerializer.serialize({unit: 'mm'}, ...paths)`.
+Official `@jscad/svg-serializer` fills geom2 black. path2 is stroke. Generate never passes geom2 to serialize.
+
+B01 is one 24 mm cube. The eight instance origins are recorded below. Pocket cuts are omitted.
+B05 and B06 are the local 202 x 3 x 427 mm plates. World face and gasket Z stay unverified.
+
+| instance | origin mm |
+| --- | --- |
+| B01-corner-01 | [0, 0, 0] |
+| B01-corner-02 | [226, 0, 0] |
+| B01-corner-03 | [0, 226, 0] |
+| B01-corner-04 | [226, 226, 0] |
+| B01-corner-05 | [0, 0, 476] |
+| B01-corner-06 | [226, 0, 476] |
+| B01-corner-07 | [0, 226, 476] |
+| B01-corner-08 | [226, 226, 476] |
+
+| file | solid | view | axis | origin | plane |
+| --- | --- | --- | --- | --- | --- |
+| envelope-front.svg | envelope | front | [0, 1, 0] | [0, 0, 0] | XZ |
+| front.svg | envelope | front | [0, 1, 0] | [0, 0, 0] | XZ |
+| envelope-side.svg | envelope | side | [1, 0, 0] | [0, 0, 0] | YZ |
+| side.svg | envelope | side | [1, 0, 0] | [0, 0, 0] | YZ |
+| envelope-top.svg | envelope | top | [0, 0, 1] | [0, 0, 0] | XY |
+| top.svg | envelope | top | [0, 0, 1] | [0, 0, 0] | XY |
+| B01-corner-block-front.svg | B01-corner-block | front | [0, 1, 0] | [0, 0, 0] | XZ |
+| B01-corner-block-side.svg | B01-corner-block | side | [1, 0, 0] | [0, 0, 0] | YZ |
+| B01-corner-block-top.svg | B01-corner-block | top | [0, 0, 1] | [0, 0, 0] | XY |
+| B05-view-cassette-front.svg | B05-view-cassette | front | [0, 1, 0] | [0, 0, 0] | XZ |
+| B05-view-cassette-side.svg | B05-view-cassette | side | [1, 0, 0] | [0, 0, 0] | YZ |
+| B05-view-cassette-top.svg | B05-view-cassette | top | [0, 0, 1] | [0, 0, 0] | XY |
+| B06-front-door-front.svg | B06-front-door | front | [0, 1, 0] | [0, 0, 0] | XZ |
+| B06-front-door-side.svg | B06-front-door | side | [1, 0, 0] | [0, 0, 0] | YZ |
+| B06-front-door-top.svg | B06-front-door | top | [0, 0, 1] | [0, 0, 0] | XY |
+
+PNG/iso: blank. `require("gl")(64, 64)` created a context. Official `@jscad/regl-renderer` `demo-cli.js` then failed with `Cannot find module '@jscad/img-utils'`. No PNG was written.
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-front.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-front.svg
new file mode 100644
index 000000000..c4d7bd843
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-front.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-side.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-side.svg
new file mode 100644
index 000000000..49ac8c479
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-side.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-top.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-top.svg
new file mode 100644
index 000000000..454451045
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/envelope-top.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/front.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/front.svg
new file mode 100644
index 000000000..c4d7bd843
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/front.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/side.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/side.svg
new file mode 100644
index 000000000..49ac8c479
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/side.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/top.svg b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/top.svg
new file mode 100644
index 000000000..454451045
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/generated/top.svg
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/package-lock.json b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/package-lock.json
new file mode 100644
index 000000000..c5b01d4f5
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/package-lock.json
@@ -0,0 +1,85 @@
+{
+ "name": "@tmnl/mantis-terrarium-jscad",
+ "version": "0.1.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "@tmnl/mantis-terrarium-jscad",
+ "version": "0.1.0",
+ "dependencies": {
+ "@jscad/modeling": "^2.13.0",
+ "@jscad/svg-serializer": "^2.3.21"
+ },
+ "devDependencies": {
+ "@types/node": "^25.9.5",
+ "typescript": "^5.9.3"
+ }
+ },
+ "node_modules/@jscad/modeling": {
+ "version": "2.13.0",
+ "resolved": "https://registry.npmjs.org/@jscad/modeling/-/modeling-2.13.0.tgz",
+ "integrity": "sha512-Thv/JJZZOMzQ9rfhP+75PbgrNbBTZduRL+ClaGfGFts9+JdIXcUueqRL3NtZZ/v/hyZCUBkPSRxHIi4icz04tQ==",
+ "license": "MIT"
+ },
+ "node_modules/@jscad/svg-serializer": {
+ "version": "2.3.21",
+ "resolved": "https://registry.npmjs.org/@jscad/svg-serializer/-/svg-serializer-2.3.21.tgz",
+ "integrity": "sha512-Xh89gBOl0edEuE+yWEF5rjfvUc9R89AD0djKy0XiB2slVGawgGK+Lnxov3OQUWTWektrCI7DWX/uGURYJrfm6w==",
+ "license": "MIT",
+ "dependencies": {
+ "@jscad/modeling": "2.13.0",
+ "onml": "1.3.0"
+ }
+ },
+ "node_modules/@types/node": {
+ "version": "25.9.5",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.5.tgz",
+ "integrity": "sha512-OScDchr2fwuUmWdf4kZ9h7PcJiYDVInhJizG/biAq3cAvqwYktuy/TYGGdZNMtNTFUP7rnb0NU4TUdm82kt4Rg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "undici-types": ">=7.24.0 <7.24.7"
+ }
+ },
+ "node_modules/onml": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/onml/-/onml-1.3.0.tgz",
+ "integrity": "sha512-RhGUsC6Im2A5vAdIvxE3auRKTqrqUZQl/AYLn8+9lM3SO4da5bwhcI5TcM+hfQxNCSLLOVErsl9p0ZPjKKmz+g==",
+ "license": "MIT",
+ "dependencies": {
+ "sax": "^1.2.1"
+ }
+ },
+ "node_modules/sax": {
+ "version": "1.6.1",
+ "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz",
+ "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==",
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": ">=11.0.0"
+ }
+ },
+ "node_modules/typescript": {
+ "version": "5.9.3",
+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "bin": {
+ "tsc": "bin/tsc",
+ "tsserver": "bin/tsserver"
+ },
+ "engines": {
+ "node": ">=14.17"
+ }
+ },
+ "node_modules/undici-types": {
+ "version": "7.24.6",
+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz",
+ "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==",
+ "dev": true,
+ "license": "MIT"
+ }
+ }
+}
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/package.json b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/package.json
new file mode 100644
index 000000000..6b53eee16
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/package.json
@@ -0,0 +1,23 @@
+{
+ "name": "@tmnl/mantis-terrarium-jscad",
+ "version": "0.1.0",
+ "private": true,
+ "type": "module",
+ "description": "TypeScript JSCAD authoring for the mantis terrarium enclosure envelope",
+ "exports": {
+ ".": "./src/index.ts"
+ },
+ "scripts": {
+ "generate": "node --experimental-strip-types src/generate.ts",
+ "test": "node --test --experimental-strip-types test/*.test.ts",
+ "typecheck": "tsc --noEmit"
+ },
+ "dependencies": {
+ "@jscad/modeling": "^2.13.0",
+ "@jscad/svg-serializer": "^2.3.21"
+ },
+ "devDependencies": {
+ "@types/node": "^25.9.5",
+ "typescript": "^5.9.3"
+ }
+}
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/cassette.ts b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/cassette.ts
new file mode 100644
index 000000000..4cd73b942
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/cassette.ts
@@ -0,0 +1,45 @@
+import type { Geom3 } from '@jscad/modeling/src/geometries/types.js';
+
+import { cuboidFromOrigin, measureBox, type BoundingBox, type Vec3 } from './modeling.ts';
+import { ENCLOSURE_PARAMS } from './params.ts';
+
+export const B05_PARAM_ROWS = [
+ 'panel.stock_thickness',
+ 'animal.clear.width',
+ 'animal.clear.height',
+ 'cassette seat (stock + 0.20 mm TARGET)',
+ 'animal_volume.metal_allowed',
+] as const;
+
+export type ViewCassette = {
+ readonly kind: 'B05-view-cassette';
+ readonly bomId: 'B05';
+ readonly maturity: 'draft';
+ readonly printed: false;
+ readonly metal: false;
+ readonly paramsRows: typeof B05_PARAM_ROWS;
+ readonly sizeMm: Vec3;
+ readonly worldPlacement: 'unverified';
+ readonly solid: Geom3;
+};
+
+export const buildViewCassette = (): ViewCassette => {
+ const sizeMm: Vec3 = [
+ ENCLOSURE_PARAMS.clear.width.value,
+ ENCLOSURE_PARAMS.stock.value,
+ ENCLOSURE_PARAMS.clear.height.value,
+ ];
+ return {
+ kind: 'B05-view-cassette',
+ bomId: 'B05',
+ maturity: 'draft',
+ printed: false,
+ metal: false,
+ paramsRows: B05_PARAM_ROWS,
+ sizeMm,
+ worldPlacement: 'unverified',
+ solid: cuboidFromOrigin(sizeMm),
+ };
+};
+
+export const measureCassetteBox = (solid: Geom3): BoundingBox => measureBox(solid);
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/corner.ts b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/corner.ts
new file mode 100644
index 000000000..93f3b3897
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/corner.ts
@@ -0,0 +1,80 @@
+import type { Geom3 } from '@jscad/modeling/src/geometries/types.js';
+
+import { cuboidFromOrigin, measureBox, translateSolid, type BoundingBox, type Vec3 } from './modeling.ts';
+import { ENCLOSURE_PARAMS } from './params.ts';
+
+export const B01_PARAM_ROWS = [
+ 'frame.band',
+ 'frame.exterior.width',
+ 'frame.exterior.depth',
+ 'frame.exterior.height',
+ 'frame.module_pitch',
+ 'frame.first_span',
+ 'animal_volume.metal_allowed',
+] as const;
+
+export type CornerBlock = {
+ readonly kind: 'B01-corner-block';
+ readonly bomId: 'B01';
+ readonly maturity: 'draft';
+ readonly printed: true;
+ readonly metal: false;
+ readonly paramsRows: typeof B01_PARAM_ROWS;
+ readonly sizeMm: Vec3;
+ readonly solid: Geom3;
+};
+
+export type CornerInstance = {
+ readonly kind: 'B01-corner-instance';
+ readonly solidId: string;
+ readonly origin: Vec3;
+ readonly solid: Geom3;
+};
+
+const band = ENCLOSURE_PARAMS.band.value;
+const width = ENCLOSURE_PARAMS.exterior.width.value;
+const depth = ENCLOSURE_PARAMS.exterior.depth.value;
+const height = ENCLOSURE_PARAMS.exterior.height.value;
+
+export const CORNER_ORIGINS: readonly [
+ Vec3,
+ Vec3,
+ Vec3,
+ Vec3,
+ Vec3,
+ Vec3,
+ Vec3,
+ Vec3,
+] = [
+ [0, 0, 0],
+ [width - band, 0, 0],
+ [0, depth - band, 0],
+ [width - band, depth - band, 0],
+ [0, 0, height - band],
+ [width - band, 0, height - band],
+ [0, depth - band, height - band],
+ [width - band, depth - band, height - band],
+];
+
+export const buildCornerBlock = (): CornerBlock => ({
+ kind: 'B01-corner-block',
+ bomId: 'B01',
+ maturity: 'draft',
+ printed: true,
+ metal: false,
+ paramsRows: B01_PARAM_ROWS,
+ sizeMm: [band, band, band],
+ solid: cuboidFromOrigin([band, band, band]),
+});
+
+export const buildCornerInstances = (): readonly CornerInstance[] => {
+ const unique = buildCornerBlock();
+ return CORNER_ORIGINS.map((origin, index) => ({
+ kind: 'B01-corner-instance',
+ solidId: `B01-corner-0${index + 1}`,
+ origin,
+ solid: translateSolid(origin, unique.solid),
+ }));
+};
+
+export const measureCornerBox = (solid: Geom3): BoundingBox => measureBox(solid);
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/door.ts b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/door.ts
new file mode 100644
index 000000000..bbd943cf5
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/door.ts
@@ -0,0 +1,44 @@
+import type { Geom3 } from '@jscad/modeling/src/geometries/types.js';
+
+import { cuboidFromOrigin, measureBox, type BoundingBox, type Vec3 } from './modeling.ts';
+import { ENCLOSURE_PARAMS } from './params.ts';
+
+export const B06_PARAM_ROWS = [
+ 'panel.stock_thickness',
+ 'animal.clear.width',
+ 'animal.clear.height',
+ 'animal_volume.metal_allowed',
+] as const;
+
+export type FrontDoor = {
+ readonly kind: 'B06-front-door';
+ readonly bomId: 'B06';
+ readonly maturity: 'draft';
+ readonly printed: false;
+ readonly metal: false;
+ readonly paramsRows: typeof B06_PARAM_ROWS;
+ readonly sizeMm: Vec3;
+ readonly worldPlacement: 'unverified';
+ readonly solid: Geom3;
+};
+
+export const buildFrontDoor = (): FrontDoor => {
+ const sizeMm: Vec3 = [
+ ENCLOSURE_PARAMS.clear.width.value,
+ ENCLOSURE_PARAMS.stock.value,
+ ENCLOSURE_PARAMS.clear.height.value,
+ ];
+ return {
+ kind: 'B06-front-door',
+ bomId: 'B06',
+ maturity: 'draft',
+ printed: false,
+ metal: false,
+ paramsRows: B06_PARAM_ROWS,
+ sizeMm,
+ worldPlacement: 'unverified',
+ solid: cuboidFromOrigin(sizeMm),
+ };
+};
+
+export const measureDoorBox = (solid: Geom3): BoundingBox => measureBox(solid);
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/emit.ts b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/emit.ts
new file mode 100644
index 000000000..ac0c7cb69
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/emit.ts
@@ -0,0 +1,7 @@
+export const emitStl = (): never => {
+ throw new Error('not implemented');
+};
+
+export const emitStep = (): never => {
+ throw new Error('not implemented');
+};
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/enclosure.ts b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/enclosure.ts
new file mode 100644
index 000000000..33d2b1eeb
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/enclosure.ts
@@ -0,0 +1,42 @@
+import type { Geom3 } from '@jscad/modeling/src/geometries/types.js';
+
+import { cuboidFromOrigin, measureBox, type BoundingBox } from './modeling.ts';
+import { ENCLOSURE_PARAMS, type EnclosureParams } from './params.ts';
+
+export type EnclosureKeepOut = {
+ readonly kind: 'animal-clear';
+ readonly sizeMm: readonly [202, 202, 427];
+ readonly status: 'calculated';
+ readonly subtracted: false;
+ readonly reason: 'z-origin unverified before gasket closure';
+};
+
+export type EnclosureModel = {
+ readonly kind: 'enclosure-envelope';
+ readonly maturity: 'draft';
+ readonly params: EnclosureParams;
+ readonly solid: Geom3;
+ readonly keepOut: EnclosureKeepOut;
+};
+
+export const ANIMAL_CLEAR_KEEP_OUT: EnclosureKeepOut = {
+ kind: 'animal-clear',
+ sizeMm: [202, 202, 427],
+ status: 'calculated',
+ subtracted: false,
+ reason: 'z-origin unverified before gasket closure',
+};
+
+export const buildEnclosure = (): EnclosureModel => {
+ const { width, depth, height } = ENCLOSURE_PARAMS.exterior;
+ // 500-427 leftover is 73 mm, not 2*band, so the animal-clear void has no locked Z origin.
+ return {
+ kind: 'enclosure-envelope',
+ maturity: 'draft',
+ params: ENCLOSURE_PARAMS,
+ solid: cuboidFromOrigin([width.value, depth.value, height.value]),
+ keepOut: ANIMAL_CLEAR_KEEP_OUT,
+ };
+};
+
+export const measureEnclosureBox = (solid: Geom3): BoundingBox => measureBox(solid);
diff --git a/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/generate.ts b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/generate.ts
new file mode 100644
index 000000000..d00fc6938
--- /dev/null
+++ b/projects/biomemetics/labs/mantis/terrarium/cad/jscad/src/generate.ts
@@ -0,0 +1,122 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import type { Geom3 } from '@jscad/modeling/src/geometries/types.js';
+
+import { buildViewCassette } from './cassette.ts';
+import { buildCornerBlock, CORNER_ORIGINS } from './corner.ts';
+import { buildFrontDoor } from './door.ts';
+import { buildEnclosure } from './enclosure.ts';
+import { serializeSvg } from './svg.ts';
+import { ENCLOSURE_VIEWS, projectView, type ViewName, type ViewSpec } from './views.ts';
+
+const packageRoot = dirname(fileURLToPath(new URL('../package.json', import.meta.url)));
+
+export const GENERATED_DIR = join(packageRoot, 'generated');
+
+export type AuthoredSolidId =
+ | 'envelope'
+ | 'B01-corner-block'
+ | 'B05-view-cassette'
+ | 'B06-front-door';
+
+type AuthoredSolid = {
+ readonly id: AuthoredSolidId;
+ readonly solid: Geom3;
+ readonly alsoEmit: readonly ViewName[];
+};
+
+type WrittenView = {
+ readonly fileName: string;
+ readonly solidId: AuthoredSolidId;
+ readonly view: ViewSpec;
+};
+
+const authoredSolids = (): readonly AuthoredSolid[] => [
+ { id: 'envelope', solid: buildEnclosure().solid, alsoEmit: ['front', 'side', 'top'] },
+ { id: 'B01-corner-block', solid: buildCornerBlock().solid, alsoEmit: [] },
+ { id: 'B05-view-cassette', solid: buildViewCassette().solid, alsoEmit: [] },
+ { id: 'B06-front-door', solid: buildFrontDoor().solid, alsoEmit: [] },
+];
+
+const writeSvg = (fileName: string, svg: string): string => {
+ if (!svg.includes('