forma-dsl-mcp 0.3.8 → 0.3.9

package/src/reference/reference/conversions.md

@@ -49,7 +49,7 @@ extrude {
 - A `height` of `0` or less yields empty geometry rather than an error, so a parameter
   sweeping to zero does not break the model.
 - `scale_top = [0, 0]` gives a point, which is one way to build a pyramid from any profile.
-- The profile is swept as drawn — `extrude` does not centre it. A `rect` that is not centred
+- The profile is swept as drawn - `extrude` does not centre it. A `rect` that is not centred
   produces a box in the positive quadrant.
 
 ---
@@ -76,7 +76,7 @@ revolve { angle = 180  segments = 64  polygon { points = profile } }
   radius. A profile drawn from `[0, 0]` upwards produces a solid standing on the XY plane.
 - **Every X must be ≥ 0.** A profile that crosses the axis revolves through itself and the
   result is not what you drew.
-- The profile does not have to touch the axis. One that does not produces a tube — which is
+- The profile does not have to touch the axis. One that does not produces a tube - which is
   how [`torus`](shapes-3d.md#torus) is built internally.
 - An `angle` of `0` or less yields empty geometry rather than an error.
 
@@ -84,7 +84,7 @@ revolve { angle = 180  segments = 64  polygon { points = profile } }
 
 ## `project`
 
-The shadow a solid casts on the XY plane — its full outline, from any Z.
+The shadow a solid casts on the XY plane - its full outline, from any Z.
 
 ```hcl
 project { bracket { } }
@@ -120,7 +120,7 @@ slice { z = 12  bracket { } }
 
 - Takes 3D geometry and produces 2D.
 - A plane that misses the solid gives an empty cross-section, not an error.
-- A plane exactly on a flat face is ambiguous — offset it slightly.
+- A plane exactly on a flat face is ambiguous - offset it slightly.
 
 ---
 
@@ -129,7 +129,7 @@ slice { z = 12  bracket { } }
 ### Profiles are where the modelling happens
 
 Most shapes are easier to describe in 2D and then given thickness. A rounded box, for
-instance, has no primitive — it is a rounded rectangle with a height:
+instance, has no primitive - it is a rounded rectangle with a height:
 
 ```hcl
 extrude {
@@ -215,7 +215,7 @@ model "m" {
 
 ### Inspecting a cross-section
 
-`slice` is a debugging tool as much as a modelling one — extrude the slice thinly to see
+`slice` is a debugging tool as much as a modelling one - extrude the slice thinly to see
 where the walls actually fell:
 
 ```hcl
@@ -243,7 +243,7 @@ extrude { height = 10  rect { size = [1, 1] } }          // ✓
 Two children of different dimensionality. Extrude each profile separately, or union the
 profiles before extruding.
 
-### `part "body" is 2D — extrude or revolve it before rendering`
+### `part "body" is 2D - extrude or revolve it before rendering`
 
 A profile reached the renderer. Somewhere the `extrude` or `revolve` is missing, or is
 wrapped around the wrong block.
@@ -261,7 +261,7 @@ have X ≥ 0.
 ### My revolved solid is lying down
 
 `revolve` maps the profile's **Y** to the result's **Z**. A profile written as (x, z) with
-the height in the first component produces a solid on its side — swap the components.
+the height in the first component produces a solid on its side - swap the components.
 
 ### `revolve` produced nothing
 

package/src/reference/reference/functions.md

@@ -1,7 +1,7 @@
 # Functions
 
 Thirty builtin functions, callable in any [expression](../language/expressions.md). They take
-**positional arguments only** — named arguments are an error — and there are no user-defined
+**positional arguments only** - named arguments are an error - and there are no user-defined
 functions: to name a value declare a [`local`](local.md), and to name geometry declare a
 [`component`](component.md).
 
@@ -103,7 +103,7 @@ local bolts = max(3, min(16, var.bolts))
 
 `len(value)` → number
 
-The length of a list or a string. Anything else gives `0` — it does not raise.
+The length of a list or a string. Anything else gives `0` - it does not raise.
 
 ```hcl
 len([1, 2, 3])      // 3
@@ -168,7 +168,7 @@ range(4)              // [0, 1, 2, 3]
 range(2, 6)           // [2, 3, 4, 5]
 range(0, 10, 2.5)     // [0, 2.5, 5, 7.5]
 range(5, 0, -1)       // [5, 4, 3, 2, 1]
-range(0, -5)          // []  — backwards with a positive step is empty, not infinite
+range(0, -5)          // []  - backwards with a positive step is empty, not infinite
 ```
 
 This is what drives most [`for`](../language/control-flow.md#for) loops.
@@ -211,14 +211,14 @@ String interpolation already converts, so `str` is mostly useful when building a
 | `pi` | 3.141592653589793 |
 | `e` | 2.718281828459045 |
 
-They are ordinary names in the root scope, so they can be shadowed by a param or a local —
+They are ordinary names in the root scope, so they can be shadowed by a param or a local -
 avoid doing so.
 
 ```hcl
 local circumference = 2 * pi * var.radius
 ```
 
-Since every angle in the language is in degrees, `pi` comes up less than it would elsewhere —
+Since every angle in the language is in degrees, `pi` comes up less than it would elsewhere -
 mostly in arc lengths and areas rather than in rotations.
 
 ---
@@ -281,8 +281,8 @@ model "m" {
 
 ### `len takes 1 argument(s), got 2`
 
-A fixed-arity function got the wrong count. The variadic ones — `min`, `max`, `sum`,
-`concat`, `range` — accept any number; the rest do not.
+A fixed-arity function got the wrong count. The variadic ones - `min`, `max`, `sum`,
+`concat`, `range` - accept any number; the rest do not.
 
 ### `pow: functions take positional arguments`
 
@@ -305,7 +305,7 @@ allocating until the tab dies.
 
 ### `... must be a finite number`
 
-Something upstream produced `NaN` or `Infinity` — `sqrt` of a negative, `min()` of nothing,
+Something upstream produced `NaN` or `Infinity` - `sqrt` of a negative, `min()` of nothing,
 `num("abc")`. The error names the block and attribute that read it, not where it was
 produced, so work backwards from there.
 

package/src/reference/reference/local.md

@@ -13,7 +13,7 @@ local radius = var.diameter / 2
 
 ### `local NAME = expression`
 
-Binds a name to the result of an expression. Locals hold values, never geometry — to name a
+Binds a name to the result of an expression. Locals hold values, never geometry - to name a
 piece of geometry, declare a [`component`](component.md).
 
 #### Parameters
@@ -30,7 +30,7 @@ Nothing. A local binds a name; it produces no geometry.
 #### Caveats
 
 - **Locals are ordered at the top level.** A local may refer to params, to constants and to
-  locals declared *above* it — never below. `local a = b` before `local b = 2` fails with
+  locals declared *above* it - never below. `local a = b` before `local b = 2` fails with
   `unknown name "b"`.
 - **Locals inside a body are not ordered.** Every local in one block body is resolved before
   any of that body's blocks are built, so a block may use a local declared after it. See
@@ -130,7 +130,7 @@ model "frame" {
 
 | Use | When |
 | --- | --- |
-| [`param`](param.md) | The value is an **input** — someone outside the document should be able to change it |
+| [`param`](param.md) | The value is an **input** - someone outside the document should be able to change it |
 | `local` | The value is **derived** from params or is a fixed table, and should never be a control |
 | [`component`](component.md) | You are naming **geometry**, not a value |
 
@@ -152,7 +152,7 @@ local cavity_top = top + 2      // runs past the opening so the neck is not capp
 
 ### `unknown name "b"`
 
-A top-level local referred to something declared below it. Move the declaration up — locals
+A top-level local referred to something declared below it. Move the declaration up - locals
 are resolved strictly in source order:
 
 ```hcl

package/src/reference/reference/model.md

@@ -38,7 +38,7 @@ A scene: a list of parts, each with a name, a colour, an opacity and a geometry
 #### Caveats
 
 - **Every part must be 3D.** A 2D part is rejected before it is solved:
-  `part "body" is 2D — extrude or revolve it before rendering`.
+  `part "body" is 2D - extrude or revolve it before rendering`.
 - **A model must produce something.** An empty body, or one whose only loop ran zero times,
   fails with `model "m" produced no geometry`.
 - **Declaring the same model twice is an error**: `model "m" is declared twice`.
@@ -63,7 +63,7 @@ Naming one that does not exist fails with `no model named "exploded"`. In the ed
 first model is the one shown.
 
 Several models in one document is the idiomatic way to keep variants of the same object
-together — a printable part and the assembly it belongs to, say:
+together - a printable part and the assembly it belongs to, say:
 
 ```hcl
 component "bracket" { ... }
@@ -81,7 +81,7 @@ model "assembly" {                  // what it looks like assembled
 
 ### Parts, and geometry without them
 
-Geometry written straight into a model — outside any `part` — becomes **one default part
+Geometry written straight into a model - outside any `part` - becomes **one default part
 named after the model**, coloured `#b8c4d0`:
 
 ```hcl
@@ -101,7 +101,7 @@ model "m" {
 // parts: "pin", then "m"
 ```
 
-Prefer explicit parts once there is more than one piece — they are what the viewer colours
+Prefer explicit parts once there is more than one piece - they are what the viewer colours
 and lists, and what an exporter can write out separately.
 
 ### Model params
@@ -119,10 +119,10 @@ model "bracket" {
 
 | | Document `param` | Model `param` |
 | --- | --- | --- |
-| Default required | No — may be required instead | **Yes**: `model "m": param "s" needs a default` |
+| Default required | No - may be required instead | **Yes**: `model "m": param "s" needs a default` |
 | Settable by the caller | Yes, via `render(source, { params })` | No |
 | Appears in `describeParameters` | Yes | No |
-| Readable as `var.NAME` | Yes | No — bare name only |
+| Readable as `var.NAME` | Yes | No - bare name only |
 
 Use them to give one model's fixed numbers a name without adding a control to the editor.
 For anything the caller should change, declare the param at the top level.
@@ -142,7 +142,7 @@ model "stacked_trays" {
 }
 ```
 
-An optional part goes behind an `if` **around** the part, never inside it — a part with no
+An optional part goes behind an `if` **around** the part, never inside it - a part with no
 geometry is an error:
 
 ```hcl
@@ -174,13 +174,13 @@ model "assembly" {
 The body evaluated to nothing. Usual causes:
 
 - an empty body;
-- a `for` over an empty list — `range(0, var.n)` where `n` is `0`;
+- a `for` over an empty list - `range(0, var.n)` where `n` is `0`;
 - an `if` with no `else` whose condition was false.
 
 Guard the degenerate case so something is always produced, or make the parameter's minimum
 exclude it.
 
-### `part "body" is 2D — extrude or revolve it before rendering`
+### `part "body" is 2D - extrude or revolve it before rendering`
 
 A part ended up holding a cross-section rather than a solid. 2D shapes cannot be rendered
 directly:
@@ -209,5 +209,5 @@ Two models share a name, so `render(source, { model: 'm' })` would be ambiguous.
 ### My `render(source, { params })` value is ignored
 
 The param is probably declared inside the model rather than at the top level. Only top-level
-params are settable. Check with [`describeParameters`](../api/describe-parameters.md) — it
+params are settable. Check with [`describeParameters`](../api/describe-parameters.md) - it
 lists exactly the params a caller can set.

package/src/reference/reference/param.md

@@ -29,7 +29,7 @@ param bolts {
 
 #### Attributes
 
-Every attribute is optional. **Only `default` affects geometry** — the rest describe the
+Every attribute is optional. **Only `default` affects geometry** - the rest describe the
 control the editor should build, and are returned verbatim by
 [`describeParameters`](../api/describe-parameters.md).
 
@@ -43,7 +43,7 @@ control the editor should build, and are returned verbatim by
 | `description` | string | Help text |
 | `options` | list | A fixed set of choices, for a dropdown rather than a free field |
 
-Unknown attributes are **not** rejected here — a param block is metadata, and anything in it
+Unknown attributes are **not** rejected here - a param block is metadata, and anything in it
 is passed through to the descriptor. This is the one block in the language that does not
 reject attributes it does not understand.
 
@@ -55,13 +55,13 @@ Nothing. A param binds a name; it produces no geometry.
 
 - **`min`, `max`, `step` and `options` are not enforced.** They shape the editor's control
   and nothing else. `render(source, { params: { bolts: 9999 } })` succeeds on a param
-  declared `max = 16`. Validate in the model if a bound matters —
+  declared `max = 16`. Validate in the model if a bound matters -
   `local n = min(max(var.bolts, 3), 16)`.
 - A param block may contain **attributes only**. Nested blocks inside it are an error:
   `a param block holds attributes, not nested blocks`.
 - Declaring the same param twice is an error: `param "a" is declared twice`.
 - A param's `default` may refer to params declared **above** it by their bare name, but not
-  to `var` — `var` is assembled after every param has resolved. See
+  to `var` - `var` is assembled after every param has resolved. See
   [Scope](../language/scope.md#the-root-scope).
 - A param declared inside a `model` is a different thing: it must have a default and cannot
   be set from outside. See [`model`](model.md#model-params).
@@ -124,7 +124,7 @@ When `type` is omitted it is inferred from the default: a number gives `number`,
 `bool`, a string `string`, a list `vector`. A param with neither a `type` nor a `default`
 falls back to `number`.
 
-An `angle` param is an ordinary number as far as the language is concerned — every angle in
+An `angle` param is an ordinary number as far as the language is concerned - every angle in
 forma is in degrees, and the type only tells the editor to label the control that way.
 
 ### Declaring a required input
@@ -155,7 +155,7 @@ param bore     = diameter / 2 - wall * 4     // ✓ bare names of earlier params
 ```
 
 For a value that is always derived and should never be a control, use a
-[`local`](local.md) instead — locals are computed after every param and may use `var.`.
+[`local`](local.md) instead - locals are computed after every param and may use `var.`.
 
 ### Offering a fixed set of choices
 
@@ -191,7 +191,7 @@ give it a default, or supply one:
 await render(source, { params: { height: 20 } });
 ```
 
-[`describeParameters`](../api/describe-parameters.md) works on such a document — it is built
+[`describeParameters`](../api/describe-parameters.md) works on such a document - it is built
 to be callable before any value exists, so a front end can discover what to ask for.
 
 ### `param "a" is declared twice`
@@ -201,7 +201,7 @@ overwritten, because a duplicated input would make the editor's control ambiguou
 
 ### `a param block holds attributes, not nested blocks`
 
-Something inside the braces was parsed as a block rather than an attribute — usually a
+Something inside the braces was parsed as a block rather than an attribute - usually a
 missing `=`:
 
 ```hcl

package/src/reference/reference/part.md

@@ -19,7 +19,7 @@ Groups geometry into one named, coloured piece of the scene. Parts are solved in
 and drawn in their own colour.
 
 A part is **not an operand**. It does not contribute geometry to the block around it, and an
-enclosing `translate` will not move it — which is why a part belongs directly in a
+enclosing `translate` will not move it - which is why a part belongs directly in a
 [`model`](model.md), or inside a `for` or `if` in one.
 
 #### Label
@@ -57,7 +57,7 @@ Nothing, to the enclosing block. The part travels separately and lands in the sc
 - **A part cannot come out of a [`component`](component.md)**:
   `a component cannot declare parts`. Call the component inside a part instead.
 - **Every part must be 3D** by the time it renders:
-  `part "body" is 2D — extrude or revolve it before rendering`.
+  `part "body" is 2D - extrude or revolve it before rendering`.
 - Several blocks inside a part are implicitly unioned, exactly as anywhere else.
 - Nothing rejects two parts with the same name; the viewer will simply list two entries
   called the same thing.
@@ -121,7 +121,7 @@ if var.show_label {
   part "label" { color = "#f4f1e4"  label_band { } }
 }
 
-// ✗ — when show_label is false this is an empty part, which is an error
+// ✗ - when show_label is false this is an empty part, which is an error
 part "label" {
   if var.show_label { label_band { } }
 }
@@ -159,13 +159,13 @@ for (const part of result.parts) {
   part.name;      // "bottle"
   part.color;     // "#8fd3e8"
   part.opacity;   // 1
-  part.node;      // the GeometryNode — what context.collect() wants
+  part.node;      // the GeometryNode - what context.collect() wants
   part.concrete;  // the solved Manifold solid, owned by the context
   part.mesh;      // positions and normals, ready to upload
 }
 ```
 
-Parts are solved independently, so two parts that share a subtree still solve it once — the
+Parts are solved independently, so two parts that share a subtree still solve it once - the
 digest cache is keyed on content, not on which part asked.
 
 To export one part, pass its `concrete` to [`toBinarySTL`](../api/export.md#tobinarystl).
@@ -176,7 +176,7 @@ To export one part, pass its `concrete` to [`toBinarySTL`](../api/export.md#tobi
 
 ### `a part needs at least one shape inside it`
 
-The part's body produced nothing — usually an `if` inside it that took no branch, or a `for`
+The part's body produced nothing - usually an `if` inside it that took no branch, or a `for`
 over an empty list. Move the condition outside the part.
 
 ### `a part cannot contain another part`
@@ -194,9 +194,9 @@ component "shell" { ... }                    // geometry only
 model "m" { part "shell" { shell { } } }     // the part lives here
 ```
 
-### `part "body" is 2D — extrude or revolve it before rendering`
+### `part "body" is 2D - extrude or revolve it before rendering`
 
-The part holds a cross-section. Extrude or revolve it first — see
+The part holds a cross-section. Extrude or revolve it first - see
 [2D ↔ 3D](conversions.md).
 
 ### A part inside an operation disappears
@@ -208,7 +208,7 @@ depends on whether the operation had anything else to work with:
 // ✗ fails: "translate" needs at least one shape inside it
 translate { offset = [0, 0, 10]  part "p" { box { size = [1, 1, 1] } } }
 
-// ✗ worse — renders, but part "p" is silently gone from the scene
+// ✗ worse - renders, but part "p" is silently gone from the scene
 translate {
   offset = [0, 0, 10]
   box { size = [1, 1, 1] }
@@ -220,10 +220,10 @@ part "p" { translate { offset = [0, 0, 10]  box { size = [1, 1, 1] } } }
 ```
 
 Nothing warns about the second case. If a part you declared is missing from the render,
-check that it is written directly in the [`model`](model.md) — or inside a `for` or `if` in
-one — and not nested inside a transform or a boolean.
+check that it is written directly in the [`model`](model.md) - or inside a `for` or `if` in
+one - and not nested inside a transform or a boolean.
 
 ### Two parts have the same name
 
 Nothing rejects it. Part names come from an expression, so a loop that computes the same
-label twice produces duplicates — include the loop index: `part "leg_${i}"`.
+label twice produces duplicates - include the loop index: `part "leg_${i}"`.

package/src/reference/reference/refinement.md

@@ -37,14 +37,14 @@ offset { amount = -1.5  join = "Miter"  rect { size = [40, 20] } }
 - **2D only.** `"offset" takes 2D geometry, got 3D`. There is no 3D shell operation; build
   one as a `difference` of two profiles, or offset the profile before extruding.
 - A negative amount larger than the shape's half-width erases it, leaving empty geometry.
-- This is the operation [`rounded_rect`](shapes-2d.md#rounded_rect) is built from — a
+- This is the operation [`rounded_rect`](shapes-2d.md#rounded_rect) is built from - a
   shrunken rectangle offset back out is what makes its corners true arcs.
 
 ---
 
 ## `hull`
 
-The convex hull of everything inside — the shape a rubber sheet would take around it.
+The convex hull of everything inside - the shape a rubber sheet would take around it.
 
 ```hcl
 hull {
@@ -61,7 +61,7 @@ None.
 #### Caveats
 
 - Works in 2D and 3D, passing the dimensionality through.
-- Children are unioned first, so the hull is of everything together — which is the point.
+- Children are unioned first, so the hull is of everything together - which is the point.
 - Any concavity is filled in. A hull of a C-shape is a solid blob.
 
 ---
@@ -85,7 +85,7 @@ refine { edge_length = 1  sphere { radius = 20 } }
 - 3D only.
 - Triangle count grows quadratically as the limit falls. `edge_length = 0.1` on anything
   large will cost seconds and hundreds of megabytes.
-- Refining does not change the shape — it only adds vertices, usually so that
+- Refining does not change the shape - it only adds vertices, usually so that
   [`smooth`](#smooth) or a downstream deformation has something to work with.
 
 ---
@@ -133,7 +133,7 @@ smooth { min_sharp_angle = 40  refine { edge_length = 1  blocky_thing { } } }
 - 3D only.
 - **Smoothing needs vertices to work with.** On a cube there is nothing between the corners
   to move, so the result is barely different. Pair it with [`refine`](#refine).
-- This is a mesh operation, not a fillet. For a controlled radius, model the fillet — round
+- This is a mesh operation, not a fillet. For a controlled radius, model the fillet - round
   the profile, or union in a [`torus`](shapes-3d.md#torus).
 
 ---
@@ -196,7 +196,7 @@ difference {
 
 ### Organic shapes from a hull
 
-A hull of a few spheres is the quickest route to a smooth, blobby form — a handle, a fillet
+A hull of a few spheres is the quickest route to a smooth, blobby form - a handle, a fillet
 between two bosses, a rounded enclosure:
 
 ```hcl
@@ -216,7 +216,7 @@ component "rounded_enclosure" {
 }
 ```
 
-Eight spheres, but one sphere node — content identity means the kernel builds the sphere
+Eight spheres, but one sphere node - content identity means the kernel builds the sphere
 once and the hull sees eight transforms of it.
 
 ### Flat cuts
@@ -232,7 +232,7 @@ For a half-model view, that is one operation instead of an intersection with a b
 
 ### Refine, then smooth
 
-The two go together — smoothing has nothing to move until the mesh is dense enough:
+The two go together - smoothing has nothing to move until the mesh is dense enough:
 
 ```hcl
 smooth {
@@ -249,7 +249,7 @@ Watch the triangle count; this is the most expensive pair of operations in the l
 
 ### `"offset" takes 2D geometry, got 3D`
 
-`offset` works on outlines. To grow a solid, project it, offset the outline and re-extrude —
+`offset` works on outlines. To grow a solid, project it, offset the outline and re-extrude -
 or offset the profile before it was extruded in the first place.
 
 ### `offset: "amount" must be a finite number`
@@ -259,7 +259,7 @@ or offset the profile before it was extruded in the first place.
 ### My `smooth` did nothing
 
 The mesh has no vertices to move. Refine first, and check that `min_sharp_angle` is above the
-angle of the edges you want rounded — the default of `60` leaves every edge on a cube alone.
+angle of the edges you want rounded - the default of `60` leaves every edge on a cube alone.
 
 ### `refine` hung the browser
 

package/src/reference/reference/shapes-2d.md

@@ -5,7 +5,7 @@ blocks.
 
 **2D shapes cannot be rendered on their own.** Give them thickness with
 [`extrude`](conversions.md#extrude) or [`revolve`](conversions.md#revolve) first, or a part
-holding one fails with `part "body" is 2D — extrude or revolve it before rendering`.
+holding one fails with `part "body" is 2D - extrude or revolve it before rendering`.
 
 | Block | Sized by | Centred by default |
 | --- | --- | --- |
@@ -20,7 +20,7 @@ holding one fails with `part "body" is 2D — extrude or revolve it before rende
 ### A note on `segments`
 
 Several shapes take `segments`, the number of straight edges used to approximate a curve.
-`0` — the default — means *let the kernel decide* from its global quality settings, which
+`0` - the default - means *let the kernel decide* from its global quality settings, which
 [`setQuality`](../api/kernel.md#setquality) controls. Set it explicitly when a specific facet
 count matters: a hole that must clear a printed bolt, or a preview that must stay cheap.
 
@@ -83,7 +83,7 @@ circle { diameter = 24  segments = 64 }
 | Attribute | Type | Default | Description |
 | --- | --- | --- | --- |
 | `radius` | number | `1` | |
-| `diameter` | number | — | An alternative spelling of the same thing |
+| `diameter` | number | - | An alternative spelling of the same thing |
 | `segments` | integer | `0` | Segments around the circle; `0` lets the kernel choose |
 
 #### Caveats
@@ -114,7 +114,7 @@ ellipse { radii = [30, 18] }
 
 - Implemented as a scaled unit circle, so both radii stay exact rather than being
   approximated by a polygon fitted to an ellipse.
-- Always centred. There is no `center` attribute — passing one is
+- Always centred. There is no `center` attribute - passing one is
   `ellipse: unknown attribute "center"`.
 
 ---
@@ -133,16 +133,16 @@ regular_polygon { sides = 8  radius = 20  rotation = 22.5 }
 | Attribute | Type | Default | Description |
 | --- | --- | --- | --- |
 | `sides` | integer | **required** | At least 3 |
-| `width_across_flats` | number | — | Distance between opposite flats — how a hex key or a nut is specified |
-| `width_across_corners` | number | — | Distance between opposite corners |
+| `width_across_flats` | number | - | Distance between opposite flats - how a hex key or a nut is specified |
+| `width_across_corners` | number | - | Distance between opposite corners |
 | `radius` | number | `1` | Centre to corner. Same as half the across-corners width |
-| `diameter` | number | — | Twice the radius |
+| `diameter` | number | - | Twice the radius |
 | `rotation` | angle | `0` | Where the first corner sits, in degrees |
 
 #### Caveats
 
 - Give **one** sizing attribute. They are tried in the order above, so
-  `width_across_flats` wins if several are present — do not rely on that; pass one.
+  `width_across_flats` wins if several are present - do not rely on that; pass one.
 - `radius` and `diameter` together are an error, as on [`circle`](#circle).
 - Fewer than 3 sides is an error: `regular_polygon: "sides" must be at least 3`.
 - Always centred on the origin.
@@ -153,7 +153,7 @@ regular_polygon { sides = 8  radius = 20  rotation = 22.5 }
 
 ## `stadium`
 
-A rectangle fully rounded on its short axis — the shape of a slot.
+A rectangle fully rounded on its short axis - the shape of a slot.
 
 ```hcl
 stadium { size = [40, 8]  center = true }
@@ -203,7 +203,7 @@ polygon {
   without a separate `difference`.
 - The outline should not self-intersect. The fill rule decides what happens when it does,
   rather than the shape being rejected.
-- Points are not closed for you — the last point connects back to the first automatically, so
+- Points are not closed for you - the last point connects back to the first automatically, so
   do not repeat it.
 
 ---
@@ -226,7 +226,7 @@ model "vase" {
 }
 ```
 
-Every X must be ≥ 0 — a profile that crosses the axis revolves through itself.
+Every X must be ≥ 0 - a profile that crosses the axis revolves through itself.
 
 ### Slots and keyways
 
@@ -255,7 +255,7 @@ for i, size in [1.5, 2, 2.5, 3, 4, 5, 6] {
 }
 ```
 
-The `+ 0.3` is print clearance — the language has no opinion about fits, so the model states
+The `+ 0.3` is print clearance - the language has no opinion about fits, so the model states
 them.
 
 ### Holes without a boolean
@@ -276,7 +276,7 @@ polygon {
 
 ## Troubleshooting
 
-### `part "body" is 2D — extrude or revolve it before rendering`
+### `part "body" is 2D - extrude or revolve it before rendering`
 
 A 2D shape reached the renderer. Wrap it:
 
@@ -286,7 +286,7 @@ extrude { height = 4  circle { radius = 10 } }
 
 ### `"circle" is a shape and cannot contain other blocks`
 
-A shape is a leaf. Something was nested inside its braces — usually a missing `}` on the
+A shape is a leaf. Something was nested inside its braces - usually a missing `}` on the
 line before, so the next block was swallowed.
 
 ### `circle: give either "radius" or "diameter", not both`
@@ -305,5 +305,5 @@ shorter side. Check that it is set and that the shape is big enough to show it.
 
 ### My hexagon is rotated 30° from what I wanted
 
-`rotation = 0` puts a **corner** on +X. For a flat on +X, use `rotation = 30` — or in general
+`rotation = 0` puts a **corner** on +X. For a flat on +X, use `rotation = 30` - or in general
 `180 / sides`.