forgecad 0.9.16 → 0.10.0

package/dist/docs-raw/guides/geometry-conventions.md

@@ -1,52 +0,0 @@
----
-skill-group: geometry
-skill-order: 2
----
-
-# Geometry Conventions
-
-ForgeCAD wraps Manifold (mesh kernel) and Three.js (Y-up renderer). This doc captures convention mismatches and how ForgeCAD resolves them.
-
-## Winding Order
-
-CCW = positive area, CW = empty in Manifold's `CrossSection`. ForgeCAD auto-fixes at all entry points:
-- `polygon(points)` — computes signed area (shoelace), reverses if CW
-- `path().close()` — same fix
-
-**Rule for new code:** Any function accepting user point arrays that creates a `CrossSection` MUST auto-fix winding.
-
-## Coordinate System (Z-up vs Y-up)
-
-Three.js is Y-up; ForgeCAD is Z-up. Fix applied at camera level (`camera.up = (0,0,1)`) — geometry coordinates are native Z-up. Never swap Y/Z in geometry.
-
-## Revolution Axis
-
-`Sketch.revolve()` produces a world Z-axis solid of revolution. Profile X = radial distance from the Z axis, Profile Y = world Z height after revolution. Profile should stay at X > 0 unless intentionally touching the axis.
-
-## Boolean Winding (3D)
-
-Manifold requires consistent outward face normals. ForgeCAD only creates meshes through Manifold's own constructors, which guarantee correct normals.
-
-## Transform Order
-
-Transforms apply left-to-right. `Sketch.rotate()`, `scale()`, and `mirror()` operate around bounding-box center. For 3D `Shape` / `ShapeGroup`, `scale()` and `mirror()` operate around bounding-box center, while `rotate()` remains origin-based unless you pass `options.pivot` or use `rotateAroundAxis(...)`.
-
-For explicit transform objects: `A.mul(B)` = apply A then B; `composeChain(A, B, C)` = A→B→C.
-
-## Assembly Frame Composition
-
-```ts
-childWorld = composeChain(childBase, jointMotion, jointFrame, parentWorld)
-```
-
-Prefer `composeChain(...)` over manual `.mul(...).mul(...)` in kinematics code to avoid order mistakes.
-
-## Summary
-
-| Convention | User sees | Kernel needs | Where we fix it |
-|---|---|---|---|
-| Winding | Any point order | CCW | `polygon()`, `path().close()` |
-| Up axis | Z-up | Y-up (Three.js) | `camera.up`, gizmo labels |
-| Revolution | "revolve this profile" | Profile X = radius, Profile Y = world Z height | Documented and regression-tested |
-| Face normals | Doesn't think about it | Outward-pointing | Manifold constructors |
-| Transform order | Left-to-right chain | Post-multiply | Native match |

package/dist/docs-raw/guides/modeling-recipes.md

@@ -1,78 +0,0 @@
----
-skill-group: recipes
-skill-order: 1
----
-
-# Modeling Recipes
-
-## Iteration Bias
-
-- Default to a buildable first pass instead of a long proposal.
-- Replace a broken model wholesale when that is faster than incremental patching.
-- Validate early with `forgecad run <file>`.
-
-## Common Patterns
-
-### Hollow Shell
-```javascript
-const innerSize = outer - 2 * wall;
-const outerBox = box(outer, outer, outer).placeReference('center', [0, 0, 0]);
-const innerBox = box(innerSize, innerSize, innerSize).placeReference('center', [0, 0, 0]);
-return outerBox.subtract(innerBox);
-```
-
-### Sketch-Based Twist
-```javascript
-const outer = ngon(sides, radius);
-const inner = ngon(sides, radius - wall);
-return outer.subtract(inner).extrude(height, { twist: 45, divisions: 32 });
-```
-
-### Rounded Profiles
-```javascript
-// All convex corners — offset trick
-const base = rect(50, 30).offset(-3, 'Round').offset(3, 'Round');
-
-// Selected corners only
-const roof = filletCorners(roofPoints, [
-  { index: 3, radius: 19 },
-  { index: 4, radius: 19 },
-  { index: 5, radius: 19 },
-]);
-```
-
-### Choosing the right sketch-rounding tool
-
-- `offset(-r).offset(+r)` — round every convex corner of a closed outline
-- `stroke(points, width, 'Round')` — centerline-based geometry (ribs, traces)
-- `filletCorners(points, ...)` — selective true-corner fillets on mixed profiles
-
-## Best Practices
-
-- All dimensions in millimeters; angles in degrees.
-- Primitives are centered on XY, base at Z=0. Use `placeReference('center', [0,0,0])` to center on all axes.
-- Prefer named intermediate values over deeply nested one-liners.
-- `union2d`, `difference2d`, `intersection2d` batch faster than chained `.add()` / `.subtract()`.
-
-## Debugging
-
-```javascript
-console.log("Volume:", shape.volume());
-```
-
-For sketch-heavy work, compare the raw profile and rounded profile side-by-side before extruding:
-
-```javascript
-return [
-  { name: "Raw", sketch: polygon(roofPoints) },
-  { name: "Rounded", sketch: filletCorners(roofPoints, [...]).translate(120, 0) },
-];
-```
-
-## Common Errors
-
-- `"Kernel not initialized"` — internal/runtime issue, reload the app
-- zero dimensions or self-intersecting sketches → invalid geometry
-- wrong variable name → `"Cannot read property of undefined"`
-
-For deeper API coverage, load the relevant generated doc group from the skill source map instead of reaching for repo examples by default.

package/dist-skill/docs/guides/geometry-conventions.md

@@ -1,52 +0,0 @@
----
-skill-group: geometry
-skill-order: 2
----
-
-# Geometry Conventions
-
-ForgeCAD wraps Manifold (mesh kernel) and Three.js (Y-up renderer). This doc captures convention mismatches and how ForgeCAD resolves them.
-
-## Winding Order
-
-CCW = positive area, CW = empty in Manifold's `CrossSection`. ForgeCAD auto-fixes at all entry points:
-- `polygon(points)` — computes signed area (shoelace), reverses if CW
-- `path().close()` — same fix
-
-**Rule for new code:** Any function accepting user point arrays that creates a `CrossSection` MUST auto-fix winding.
-
-## Coordinate System (Z-up vs Y-up)
-
-Three.js is Y-up; ForgeCAD is Z-up. Fix applied at camera level (`camera.up = (0,0,1)`) — geometry coordinates are native Z-up. Never swap Y/Z in geometry.
-
-## Revolution Axis
-
-`Sketch.revolve()` produces a world Z-axis solid of revolution. Profile X = radial distance from the Z axis, Profile Y = world Z height after revolution. Profile should stay at X > 0 unless intentionally touching the axis.
-
-## Boolean Winding (3D)
-
-Manifold requires consistent outward face normals. ForgeCAD only creates meshes through Manifold's own constructors, which guarantee correct normals.
-
-## Transform Order
-
-Transforms apply left-to-right. `Sketch.rotate()`, `scale()`, and `mirror()` operate around bounding-box center. For 3D `Shape` / `ShapeGroup`, `scale()` and `mirror()` operate around bounding-box center, while `rotate()` remains origin-based unless you pass `options.pivot` or use `rotateAroundAxis(...)`.
-
-For explicit transform objects: `A.mul(B)` = apply A then B; `composeChain(A, B, C)` = A→B→C.
-
-## Assembly Frame Composition
-
-```ts
-childWorld = composeChain(childBase, jointMotion, jointFrame, parentWorld)
-```
-
-Prefer `composeChain(...)` over manual `.mul(...).mul(...)` in kinematics code to avoid order mistakes.
-
-## Summary
-
-| Convention | User sees | Kernel needs | Where we fix it |
-|---|---|---|---|
-| Winding | Any point order | CCW | `polygon()`, `path().close()` |
-| Up axis | Z-up | Y-up (Three.js) | `camera.up`, gizmo labels |
-| Revolution | "revolve this profile" | Profile X = radius, Profile Y = world Z height | Documented and regression-tested |
-| Face normals | Doesn't think about it | Outward-pointing | Manifold constructors |
-| Transform order | Left-to-right chain | Post-multiply | Native match |

package/dist-skill/docs/guides/modeling-recipes.md

@@ -1,78 +0,0 @@
----
-skill-group: recipes
-skill-order: 1
----
-
-# Modeling Recipes
-
-## Iteration Bias
-
-- Default to a buildable first pass instead of a long proposal.
-- Replace a broken model wholesale when that is faster than incremental patching.
-- Validate early with `forgecad run <file>`.
-
-## Common Patterns
-
-### Hollow Shell
-```javascript
-const innerSize = outer - 2 * wall;
-const outerBox = box(outer, outer, outer).placeReference('center', [0, 0, 0]);
-const innerBox = box(innerSize, innerSize, innerSize).placeReference('center', [0, 0, 0]);
-return outerBox.subtract(innerBox);
-```
-
-### Sketch-Based Twist
-```javascript
-const outer = ngon(sides, radius);
-const inner = ngon(sides, radius - wall);
-return outer.subtract(inner).extrude(height, { twist: 45, divisions: 32 });
-```
-
-### Rounded Profiles
-```javascript
-// All convex corners — offset trick
-const base = rect(50, 30).offset(-3, 'Round').offset(3, 'Round');
-
-// Selected corners only
-const roof = filletCorners(roofPoints, [
-  { index: 3, radius: 19 },
-  { index: 4, radius: 19 },
-  { index: 5, radius: 19 },
-]);
-```
-
-### Choosing the right sketch-rounding tool
-
-- `offset(-r).offset(+r)` — round every convex corner of a closed outline
-- `stroke(points, width, 'Round')` — centerline-based geometry (ribs, traces)
-- `filletCorners(points, ...)` — selective true-corner fillets on mixed profiles
-
-## Best Practices
-
-- All dimensions in millimeters; angles in degrees.
-- Primitives are centered on XY, base at Z=0. Use `placeReference('center', [0,0,0])` to center on all axes.
-- Prefer named intermediate values over deeply nested one-liners.
-- `union2d`, `difference2d`, `intersection2d` batch faster than chained `.add()` / `.subtract()`.
-
-## Debugging
-
-```javascript
-console.log("Volume:", shape.volume());
-```
-
-For sketch-heavy work, compare the raw profile and rounded profile side-by-side before extruding:
-
-```javascript
-return [
-  { name: "Raw", sketch: polygon(roofPoints) },
-  { name: "Rounded", sketch: filletCorners(roofPoints, [...]).translate(120, 0) },
-];
-```
-
-## Common Errors
-
-- `"Kernel not initialized"` — internal/runtime issue, reload the app
-- zero dimensions or self-intersecting sketches → invalid geometry
-- wrong variable name → `"Cannot read property of undefined"`
-
-For deeper API coverage, load the relevant generated doc group from the skill source map instead of reaching for repo examples by default.

package/dist-skill/library/forgecad-visual-spec/references/prompt-template.md

@@ -1,79 +0,0 @@
-# Prompt Template
-
-Use this as a fill-in structure, not as fixed text.
-
-## Block Order
-
-1. Artifact identity
-2. Mechanical / build truth
-3. Material and color truth
-4. Pose and shot
-5. Render style
-6. Negative constraints
-
-## Skeleton
-
-```text
-A [artifact identity and scale], designed as a real buildable CAD-driven object, not a fantasy concept. [Major subassemblies and mechanism truth]. [Materials, colors, finish, and visible hardware truth]. Show it in [pose / state]. [Shot, camera, background, and lighting]. It should look physically buildable and mechanically honest, with visible part boundaries and serviceable architecture. No [negative 1], no [negative 2], no [negative 3].
-```
-
-## Default Prompt Shape
-
-Use this for most first-pass prompts:
-
-- artifact identity:
-  compact benchtop robot arm, printable gripper, modular fixture, shop tool, enclosure, etc.
-- mechanism truth:
-  weighted base, exposed belt reductions, mounted motor, support shafts, guide rods, removable cover, jaw mechanism, hinge stack, etc.
-- materials:
-  PETG, TPU, aluminum shaft, brass pinion, black belt, matte plastic, realistic metal
-- shot:
-  front-left three-quarter view
-- render style:
-  clean premium studio product render, neutral background, soft diffused lighting, crisp soft shadows
-- negatives:
-  fake sleek shell, hidden mechanics, over-smoothed geometry, text, labels, humans
-
-## Shot Suffixes
-
-Useful one-line suffixes:
-
-- `front-left three-quarter hero view, eye-level product camera`
-- `rear-right three-quarter view showing motor placement and belt routing`
-- `pure side view showing the reach silhouette and joint stack clearly`
-- `close-up on the wrist and end effector showing the mechanism clearly`
-
-## Mode Swaps
-
-### Honest Hero Render
-
-Add phrases like:
-
-- `clean premium studio product render`
-- `show the final artifact clearly`
-- `physically buildable and mechanically honest`
-- `visible part boundaries and serviceable architecture`
-
-### Builder-First Mechanical Render
-
-Add phrases like:
-
-- `emphasizing how it would actually be built`
-- `clear visibility of interfaces, seams, and subsystem boundaries`
-- `serious prototype, not a polished consumer shell`
-
-### Mild Exploded Assembly Render
-
-Add phrases like:
-
-- `major modules separated by small clean gaps`
-- `reveal the build logic without chaotic disassembly`
-- `no tiny floating fragments, no labels, no arrows`
-
-### Workshop Prototype Realism
-
-Add phrases like:
-
-- `realistic workshop photo`
-- `visible print lines and honest surface texture`
-- `believable but uncluttered engineering bench background`