tosijs-3d 0.10.12 → 0.10.14

package/CHANGELOG.md

@@ -6,6 +6,42 @@ All notable changes to **tosijs-3d**. This project is pre-1.0 (`0.x`), so minor
 versions may carry breaking peer-dependency changes — each is called out in a
 **⚠️ Breaking** block in its version section below, with what a consumer must do.
 
+## 0.10.14
+
+### Fixed
+
+- **A press during a system panel's content swap is no longer lost** (#111 follow-up, ensemble). Setting `el.svg = next` on an open panel closed and reopened it, which left a moment with no plane: a click landing then went nowhere (ensemble's host-actions test failed one run in four after a store refresh swapped every panel's content), and `contentToClient` returned null. A framed panel (the default title bar) now swaps the content under the same frame, so the plane, texture, spot and focus stay. `panelopen` still goes to the old content (close) and the new (open). A press already down in the old content ends there rather than releasing onto the new. `chrome="none"` panels still close and reopen.
+- **The docs a consumer reads describe what the code does** (#116, ensemble). `select3d`'s JSDoc called it "a compact cycler, no dropdown" five releases after it became a select that opens a list (it steps only with no host). A sweep of every behaviour change in this CHANGELOG against the shipped docs found 33 more, fixed against the code:
+  - The settings panel is the owl's in-scene panel, not a gear and an HTML overlay (about 20 pages, and the `scenePanel` property).
+  - `gameController`'s key map: the wheel zooms (the d-pad axis), the arrows look, the mouse buttons are listed, `mouseLook` defaults to `'off'`.
+  - `b3dBiped`: the camera defaults in its table, `invertLookY` is off by default, `jumpSpeed` has no wind-up, `wadeDepth`'s swim thresholds (in at 1.3 ×, out at 1 ×).
+  - SSAO runs in a headset with `on` and the default `projected` method (three type docs and a console warning said never).
+  - `slider3d`'s peek readout sits beside the label; `panel3d`'s gap is 4.
+  - Frame-panel presets are angular, and frame panels can show flat; `b3d-moon` lights the night; planets have no separate sea sphere; the loadout is on the system bar; `lookX`/`lookY` persist on foot; `gamepadFade` ignores the pointer; the aircraft's `maxSpeed` is full lever; `GulleyOptions.heading` is degrees; `iconGlyph` takes composed and mirrored names; `biomeLapseRate`'s auto value is a fixed 0.004.
+  - Two doc comments had come loose from their declarations (`iconGlyph`'s sat on a private constant, `wadeDepth`'s on the wrong attribute), so the `.d.ts` documented the wrong thing.
+
+### Added
+
+- **`titled3d(…).setContent(next)`**: other content under the same title bar, in place (the old content goes back where it came from).
+
+Size: barrel (min, packages external) 1158.6 KB raw / 396.5 KB gz, +0.05% on 0.10.13.
+
+## 0.10.13
+
+### Fixed
+
+- **Overlapping screen panels: the one drawn on top is the one you press** (#115, from ensemble). Every screen-pinned panel sat at the same distance, and on a tie Babylon draws the later mesh on top but picks the first, so a press in an overlap went to the panel underneath. It showed up as a system panel whose content was swapped for something taller: reopened, it was drawn over its neighbour, and every row over the neighbour ignored the pointer. Screen panels in a layer now stack: newest on top, and a press or a title-bar grab brings a panel to the front, with drawing and picking taken from the same order.
+- **The wheel over an in-scene panel scrolls the panel** (#114, from ensemble), instead of zooming the camera behind it; trackpad two-finger scroll too. A panel that cannot scroll still takes the wheel, so the scene does not zoom under a pointer that is on the UI. `titled3d` passes `scrollBy`, `scrollTop` and `scrollable` through to its content.
+- `iconGrid3d` hovers inside a panel. It listened for `move`, and a panel reports an unpressed pointer as `hover`, so its cells never lit.
+
+### Added
+
+- **Tooltips for icon-only controls, wherever the panel is drawn** (#112, from ensemble): `IconGridItem` takes a `title`, shown on hover (a mouse, or a controller ray in a headset) and on D-pad focus. The panel draws it over its body, so a bottom row's tip is not clipped, flipped above the control when there is no room below. `iconBar3d` uses the same tip. A custom widget gets one through `WidgetHost.showTip`/`hideTip`.
+- **A test can click a system panel's content where a person would** (#113, from ensemble): `el.contentToClient(x, y)` gives the client pixel of a point of the content (its viewBox units), through the drawn plane, so a drag, a scale and the title bar are accounted for; `el.clientRect()` is the content's box. Null unless open and flat.
+- **A host can re-stack its system panels**: until someone drags a system panel, its spot is its current `screenAnchor`, so setting a new one moves an open panel (a column re-stacked as the panel above it grows). A dragged panel keeps its spot until its button is held. `screenAnchorDragged(anchor)` is exported.
+
+Size: barrel (min, packages external) 1158.1 KB raw / 396.3 KB gz, +0.33% on 0.10.12.
+
 ## 0.10.12
 
 ### Added

package/dist/b3d-aircraft.js

@@ -60,7 +60,7 @@ const targets = [...air, ...ground]
 const kills = div({ class: 'kills' }, `Targets down: 0 / ${targets.length}`)
 // WEATHER, to fly in: a storm cell over the whole arena (storminess shakes
 // the airframe) and the scene's wind (it carries you; blowing east, across
-// your starting heading, so you crab). Both on the ⚙ panel.
+// your starting heading, so you crab). Both on the settings panel.
 const storm = b3dWeatherCell({ x: 0, z: 0, radius: 3000, storminess: 0 })
 const turb = div({ class: 'turb' }, 'turbulence 0.00')
 let down = 0
@@ -210,7 +210,7 @@ turns the pilot's head in the cockpit, springs back on release).
 | `library` | `''` | Library type to source mesh from |
 | `meshName` | `''` | Node name to instantiate from library |
 | `enterable` | `false` | Whether a biped can enter |
-| `maxSpeed` | `50` | Normal top speed (m/s) — the cruise cap a released throttle settles at |
+| `maxSpeed` | `50` | Top speed at full lever, **military** thrust (m/s). A released trigger leaves the lever where it was, so speed settles wherever that lever meets drag |
 | `afterburnerSpeed` | `75` | Speed ceiling while the throttle is held past `maxSpeed`; releasing bleeds back to `maxSpeed`. ≤ `maxSpeed` disables afterburner. |
 | `acceleration` | `12` | Throttle / lean authority (speed change rate) |
 | `vtolSpeed` | `6` | Forward ground speed splitting hover (below) from plane (above). 0 = pure aeroplane, no hover regime. |

package/dist/b3d-biped.d.ts

@@ -94,16 +94,6 @@ export declare class B3dBiped extends B3dControllable {
         aimMaxYaw: number;
         /** How far up/down the look can go, degrees. */
         maxLookPitch: number;
-        /**
-         * Invert the right stick's vertical. **On by default** — Tonio's call, and
-         * the conventional one for a third-person camera: pushing the stick away
-         * from you tips the view DOWN, the way a physical camera head works. Set
-         * `'off'` for the direct mapping.
-         *
-         * A string enum rather than a boolean because an absent boolean attribute
-         * is false, so a default-true boolean can never turn on (and tosijs now
-         * throws on one) — see CLAUDE.md.
-         */
         /**
          * How far in FRONT of the head bone the first-person eye sits, in metres.
          *
@@ -112,6 +102,15 @@ export declare class B3dBiped extends B3dControllable {
          * which is what makes a too-large value feel like floating.
          */
         eyeForward: number;
+        /**
+         * Invert the right stick's vertical. **Off by default**: pushing the stick
+         * up looks (and aims) up. `'on'` gives the inverted, aircraft-style mapping,
+         * where pushing the stick away tips the view down.
+         *
+         * A string enum rather than a boolean because an absent boolean attribute
+         * is false, so a default-true boolean can never turn on (and tosijs now
+         * throws on one) — see CLAUDE.md.
+         */
         invertLookY: "on" | "off";
         /**
          * Never let the follow camera drop below this above the character's feet.
@@ -121,10 +120,10 @@ export declare class B3dBiped extends B3dControllable {
          */
         cameraMinHeight: number;
         /**
-         * Upward speed of a FULLY wound-up jump, m/s. The physics is fixed and the
-         * ANIMATION is retimed to match it — not the other way round. Matching the
-         * jump to the clip was tried and was wrong: it made the jump a consequence
-         * of whatever the animator exported.
+         * Upward speed at take-off, m/s. The jump is instant (no wind-up), and the
+         * physics decides it: the start, loop and land clips each play for as long
+         * as they are true, so the jump is never a consequence of whatever the
+         * animator exported.
          */
         jumpSpeed: number;
         /** Fraction of walking speed while sneaking. */
@@ -143,6 +142,17 @@ export declare class B3dBiped extends B3dControllable {
          * A string enum rather than a boolean because a boolean attribute cannot
          * default to true, and the useful default here is "strafing off".
          */
+        /**
+         * **How high a ledge the character can pull itself onto, metres.** Below
+         * `STEP_UP` (0.5) the walking code just steps up; above this it is a wall.
+         *
+         * `2.2` is a touch over shoulder height on a 1.83 m rig — a decent mantle
+         * for someone athletic. Lower it for a heavier or clumsier character; that
+         * is the mobility half of the skill dial AI-DESIGN argues for, and it costs
+         * nothing to expose because the band it defines is read from geometry
+         * rather than painted onto it.
+         */
+        climbReach: number;
         /**
          * **How deep the water gets before you swim, as a fraction of standing
          * height.** Below this you wade — feet on the bottom, walking; above it
@@ -158,20 +168,11 @@ export declare class B3dBiped extends B3dControllable {
          * fraction tracks that for free. Metres would be right for a fact about the
          * WORLD; the two are easy to confuse and worth keeping apart.
          *
-         * Leaving the water uses a lower threshold (70% of this) so the boundary
-         * does not flicker; see `buoyancy.isSwimming`.
+         * Hysteresis, so the boundary does not flicker: you START swimming a bit
+         * deeper than this (1.3 × `wadeDepth`, about 0.59 of your height at the
+         * default) and stop once the water drops back to `wadeDepth` itself; see
+         * `buoyancy.isSwimming`.
          */
-        /**
-         * **How high a ledge the character can pull itself onto, metres.** Below
-         * `STEP_UP` (0.5) the walking code just steps up; above this it is a wall.
-         *
-         * `2.2` is a touch over shoulder height on a 1.83 m rig — a decent mantle
-         * for someone athletic. Lower it for a heavier or clumsier character; that
-         * is the mobility half of the skill dial AI-DESIGN argues for, and it costs
-         * nothing to expose because the band it defines is read from geometry
-         * rather than painted onto it.
-         */
-        climbReach: number;
         wadeDepth: number;
         strafing: string;
         /**

package/dist/b3d-biped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b3d-biped.d.ts","sourceRoot":"","sources":["../src/b3d-biped.ts"],"names":[],"mappings":"AAkOA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EACL,OAAO,EAKR,MAAM,gBAAgB,CAAA;AAyBvB,OAAO,EAQL,KAAK,GAAG,EAET,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAWxE,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,qBAAa,SAAS;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;gBAEN,IAAI,EAAE,aAAa;IAQ/B,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE;CAGzD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,aAAa,EAAO,GAAG,SAAS,EAAE,CAuE3E;AAmCD,qBAAa,QAAS,SAAQ,eAAe;IAC3C,MAAM,CAAC,gBAAgB,SAAmB;IAElC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,CAAA;IAEvB,MAAM,CAAC,cAAc;;;;;;;;;;;;;;;;;;;QA8CnB,0DAA0D;;QAE1D;;;;;;;;;;;;;;;;WAgBG;gBACc,IAAI,GAAG,KAAK;QAC7B,+EAA+E;;QAiB/E,8DAA8D;;QAE9D,gDAAgD;;QAEhD;;;;;;;;;WASG;QAgBH;;;;;;WAMG;;qBAEmB,IAAI,GAAG,KAAK;QAClC;;;;;WAKG;;QAEH;;;;;WAKG;;QAGH,gDAAgD;;QAEhD,+EAA+E;;QAE/E;;;;;;;;;;;WAWG;QACH;;;;;;;;;;;;;;;;;WAiBG;QACH;;;;;;;;;WASG;;;;QAIH;;;;;;;;;;;;;;;;WAgBG;;;;;;;;;MAEJ;IAED,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAA;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAA;IACvB;;6EAEyE;IACzE,UAAU,EAAE,OAAO,GAAG,KAAK,CAAU;IACrC,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,UAAU,CAA6B;IAE/C;;gFAE4E;IAC5E,WAAW,SAAM;IACjB,aAAa,SAAM;IACnB,OAAO,CAAC,OAAO,CAAwB;IACvC;;;;;;;;;;;4EAWwE;IACxE,eAAe,CAAC,YAAY,SAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI;IA0BzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,cAAc,CAAC,EAAE,SAAS,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAA;IACvC,kFAAkF;IAClF,OAAO,CAAC,UAAU,CAGf;IACH,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAI;IACpB;;;;OAIG;IACH,kFAAkF;IAClF,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,OAAO,CAQA;IACf,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAQH;IACf,6FAA6F;IAC7F,OAAO,CAAC,aAAa,CAIN;IACf,cAAc,CAAC,EAAE,cAAc,CAAA;IAE/B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAI;IACpB,8EAA8E;IAC9E,OAAO,CAAC,SAAS,CAAQ;IACzB,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAI;IACpB,uEAAuE;IACvE,OAAO,CAAC,UAAU,CAAI;IACtB,8EAA8E;IAC9E,OAAO,CAAC,eAAe,CAAQ;IAC/B,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAI;IACpB;;;OAGG;IACH,OAAO,CAAC,UAAU,CAAI;IACtB,qEAAqE;IACrE,OAAO,CAAC,IAAI,CAAI;IAChB,uEAAuE;IACvE,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IACD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,CAAkC;IAE9C;;;;;;;;;;;;OAYG;IACH;;;;;;;;;;;OAWG;IACH,OAAO,UAAQ;IACf,OAAO,CAAC,gBAAgB,CAAQ;IAChC;;;;;OAKG;IACH,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAO;IAEjD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAc7B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,WAAW;IAwCnB;;;;;;;;;;;;OAYG;IACH,YAAY,GAAI,KAAK,cAAc,EAAE,IAAI,MAAM,KAAG,YAAY,CACzB;IAErC;;;;;;;;;;;OAWG;IACH,OAAO,KAAK,SAAS,GAEpB;IAcD,OAAO,CAAC,YAAY,CAIb;IACP,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,QAAQ;IAahB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,eAAe,CAGtB;IAED,OAAO,CAAC,cAAc;IAsHtB,OAAO,CAAC,OAAO,CAId;IACD,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,YAAY;IAgBpB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAQjB,sEAAsE;IACtE,OAAO,CAAC,OAAO,CAA2D;IAC1E,2EAA2E;IAC3E,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,OAAO,CAId;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IAWnB,iFAAiF;IACjF,IAAI,GAAG,IAAI,GAAG,CAEb;IAED;;;;;;OAMG;IACH,IAAI,YAAY,IAAI,OAAO,CAAC,OAAO,CAQlC;IAED;;;;;;;OAOG;IACH,IAAI,SAAS,IAAI,OAAO,CAAC,OAAO,CAO/B;IACD,OAAO,CAAC,SAAS,CAAQ;IACzB,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAAQ;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAkC;IACnD;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,UAAU,CAAI;IAEtB;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,SAAS,CAAQ;IACzB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,QAAQ,CAMH;IACb,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,SAAS,CAAO;IAExB,eAAe,cAkBd;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,WAAW;IAqCnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAYnB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,YAAY;IAgDpB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CAAC,cAAc;IAatB;;;;;;;;;OASG;IACH,OAAO,CAAC,UAAU;IAiGlB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA8ClB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IAKhB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,eAAe;IA+CvB,8CAA8C;IAC9C,OAAO,CAAC,SAAS,CAAI;IAErB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI;IA+EzC,eAAe,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI;IAItC,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM;IA8sC1C,OAAO,CAAC,YAAY;IASd,aAAa;IAsJb,iBAAiB;IAwDvB;;;mDAG+C;IAC/C,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK;IAyBnC;;;;+EAI2E;IAC3E,OAAO,CAAC,aAAa;IAUrB,iBAAiB;IAoBjB;;mDAE+C;IAC/C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAmB5B,OAAO,CAAC,SAAS,CAAiD;IAElE;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAoB1C,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ/B,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;IA+F3C,YAAY;IAiCZ,MAAM;CA6BP;AAED,eAAO,MAAM,QAAQ,2CAA4B,CAAA"}
+{"version":3,"file":"b3d-biped.d.ts","sourceRoot":"","sources":["../src/b3d-biped.ts"],"names":[],"mappings":"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"}

package/dist/b3d-biped.js

@@ -190,10 +190,10 @@ preview.append(
 | `forwardSpeed` | `2` | Walk speed |
 | `runSpeed` | `5` | Sprint speed |
 | `backwardSpeed` | `1` | Backward speed |
-| `cameraHeightOffset` | `1` | Camera height above target |
-| `cameraTargetHeight` | `0.75` | Height of the point the camera looks at |
-| `cameraMinFollowDistance` | `2` | Closest follow distance |
-| `cameraMaxFollowDistance` | `5` | Furthest follow distance |
+| `cameraHeightOffset` | `2` | Camera height above target |
+| `cameraTargetHeight` | `1.4` | Height of the point the camera looks at |
+| `cameraMinFollowDistance` | `4` | Closest follow distance |
+| `cameraMaxFollowDistance` | `10` | Furthest follow distance |
 
 ## Animations
 
@@ -473,16 +473,6 @@ export class B3dBiped extends B3dControllable {
         aimMaxYaw: 90,
         /** How far up/down the look can go, degrees. */
         maxLookPitch: 70,
-        /**
-         * Invert the right stick's vertical. **On by default** — Tonio's call, and
-         * the conventional one for a third-person camera: pushing the stick away
-         * from you tips the view DOWN, the way a physical camera head works. Set
-         * `'off'` for the direct mapping.
-         *
-         * A string enum rather than a boolean because an absent boolean attribute
-         * is false, so a default-true boolean can never turn on (and tosijs now
-         * throws on one) — see CLAUDE.md.
-         */
         /*
         NOT INVERTED, which is a changed default and the direct cause of a bug
         report: "when I fire it just fires into my feet".
@@ -506,6 +496,15 @@ export class B3dBiped extends B3dControllable {
          * which is what makes a too-large value feel like floating.
          */
         eyeForward: 0.13,
+        /**
+         * Invert the right stick's vertical. **Off by default**: pushing the stick
+         * up looks (and aims) up. `'on'` gives the inverted, aircraft-style mapping,
+         * where pushing the stick away tips the view down.
+         *
+         * A string enum rather than a boolean because an absent boolean attribute
+         * is false, so a default-true boolean can never turn on (and tosijs now
+         * throws on one) — see CLAUDE.md.
+         */
         invertLookY: 'off',
         /**
          * Never let the follow camera drop below this above the character's feet.
@@ -515,10 +514,10 @@ export class B3dBiped extends B3dControllable {
          */
         cameraMinHeight: 0.5,
         /**
-         * Upward speed of a FULLY wound-up jump, m/s. The physics is fixed and the
-         * ANIMATION is retimed to match it — not the other way round. Matching the
-         * jump to the clip was tried and was wrong: it made the jump a consequence
-         * of whatever the animator exported.
+         * Upward speed at take-off, m/s. The jump is instant (no wind-up), and the
+         * physics decides it: the start, loop and land clips each play for as long
+         * as they are true, so the jump is never a consequence of whatever the
+         * animator exported.
          */
         jumpSpeed: 4.5,
         /** Fraction of walking speed while sneaking. */
@@ -537,6 +536,17 @@ export class B3dBiped extends B3dControllable {
          * A string enum rather than a boolean because a boolean attribute cannot
          * default to true, and the useful default here is "strafing off".
          */
+        /**
+         * **How high a ledge the character can pull itself onto, metres.** Below
+         * `STEP_UP` (0.5) the walking code just steps up; above this it is a wall.
+         *
+         * `2.2` is a touch over shoulder height on a 1.83 m rig — a decent mantle
+         * for someone athletic. Lower it for a heavier or clumsier character; that
+         * is the mobility half of the skill dial AI-DESIGN argues for, and it costs
+         * nothing to expose because the band it defines is read from geometry
+         * rather than painted onto it.
+         */
+        climbReach: 2.2,
         /**
          * **How deep the water gets before you swim, as a fraction of standing
          * height.** Below this you wade — feet on the bottom, walking; above it
@@ -552,20 +562,11 @@ export class B3dBiped extends B3dControllable {
          * fraction tracks that for free. Metres would be right for a fact about the
          * WORLD; the two are easy to confuse and worth keeping apart.
          *
-         * Leaving the water uses a lower threshold (70% of this) so the boundary
-         * does not flicker; see `buoyancy.isSwimming`.
+         * Hysteresis, so the boundary does not flicker: you START swimming a bit
+         * deeper than this (1.3 × `wadeDepth`, about 0.59 of your height at the
+         * default) and stop once the water drops back to `wadeDepth` itself; see
+         * `buoyancy.isSwimming`.
          */
-        /**
-         * **How high a ledge the character can pull itself onto, metres.** Below
-         * `STEP_UP` (0.5) the walking code just steps up; above this it is a wall.
-         *
-         * `2.2` is a touch over shoulder height on a 1.83 m rig — a decent mantle
-         * for someone athletic. Lower it for a heavier or clumsier character; that
-         * is the mobility half of the skill dial AI-DESIGN argues for, and it costs
-         * nothing to expose because the band it defines is read from geometry
-         * rather than painted onto it.
-         */
-        climbReach: 2.2,
         wadeDepth: 0.45,
         strafing: 'off',
         /**
@@ -2369,10 +2370,10 @@ export class B3dBiped extends B3dControllable {
                       mid-torso, so measuring from it asks "how deep would it be if I
                       stood with my feet where my chest is".
           
-                      Scaled so `wadeDepth` lands exactly on `isSwimming`'s 0.5 entry
-                      threshold, which keeps that model's tested hysteresis — you stop
-                      swimming at 0.7 × wadeDepth — while letting the threshold be stated
-                      as the fraction it is.
+                      Scaled so `wadeDepth` lands on `isSwimming`'s 0.5 EXIT threshold:
+                      you start swimming at 1.3 × wadeDepth (its 0.65 entry) and stop at
+                      wadeDepth, which keeps that model's tested hysteresis while letting
+                      the threshold be stated as the fraction it is.
                       */
                         submergedFraction(groundY, standHeight, surfaceY) /
                             (2 * Math.max(0.05, attrs.wadeDepth))