tosijs-3d 0.7.7 → 0.8.0

package/CHANGELOG.md

@@ -6,6 +6,272 @@ 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.8.0
+
+Lights, editors, and the schema surface `tosijs-3d-ensemble` asked for — plus
+the two renames that were waiting for a minor.
+
+### ⚠️ Breaking
+
+- **Peer dependency: `tosijs` is now `^1.9.2`** (was `^1.7.8`). Upgrade tosijs
+  alongside this. The floor moved because 1.9 fixes five issues we filed
+  (tosijs#14/#15/#22/#24/#27) and holding it down only defers the work.
+
+  Behaviour that changed with it, verified rather than assumed: a wrong-typed
+  write to an `initAttributes` prop used to be **silently discarded** and now
+  **warns and applies the value**. So `foo: false` on an `'on'|'off'` attribute
+  genuinely sets `false` where it used to quietly default — use `isOff()`,
+  which accepts `'off'`, `false` and `'false'`.
+
+- **Callbacks are `handleX`, not `onX`.** `handleChange`, `handleClick`,
+  `handleSelect`. **Both spellings work through 0.8.x** and the old one warns
+  once per name; `onX` is removed in 0.9.
+
+  Not a style preference: these are plain factories today, but the moment one
+  becomes a tosijs component the element creator binds an `on*` prop as a DOM
+  event **listener** and the class field is silently never called. `handleX`
+  cannot be mistaken for an event name. Giving both, the new one wins.
+
+  **Migrated in this release** — `inputField`, `keyboard`, `table`,
+  `box`/`surface`, popups, debug actions and the curve/footprint/vector fields.
+  In other words: all of them. `b3d-trigger` gains `whenEnter`/`whenExit`
+  instead, because components use `when*` (see Fixed).
+
+### Added
+
+- **`handlerOf`** (`handler-of.ts`, exported from the barrel) — the shim behind
+  the `handleX`/`onX` rule, in its own dependency-free module so the smallest
+  widget can adopt it without importing `widgets3d`. Use it for your own
+  widgets: `handlerOf(config, 'handleChange', 'onChange')?.(value)`.
+
+- **Lamps** — `b3dPointLight`, `b3dSpotLight`, `b3dAreaLight`: a placed light
+  with its own fixture geometry, which **tracks the light** (a fluorescent's
+  bulb stutters as it strikes and dims to a red ember as it dies). Shadows where
+  Babylon allows, **gels** where it allows (spot only), and a generated cone
+  `shape` (`circle`/`square` + `shapeAspect`, `shapeSoftness`) plus a true
+  `innerAngle` penumbra.
+
+- **Light programs** — one curve per channel (brightness, hue, saturation,
+  range) split into attack / sustain / decay by two markers. `duration` divides
+  by those markers, so dragging one **retimes** the lamp. Presets: `steady`,
+  `fluorescent`, `flickery`, `brownout`, `candle`, `fireplace`. `timeSource`
+  picks the real clock (default — a flicker should not freeze when the world
+  pauses) or the world's.
+
+- **Editors** — `curveProgram3d` (several curves sharing one pair of draggable
+  split markers), `lightEditor3d` (the whole lamp), and `curveMarkers`.
+  Controlled, with `handleCommit(value, describe)` once per gesture carrying
+  canonical values and a verb phrase, so a document records one undo step.
+
+- **`scene-schemas`** — JSON Schema for all nine scene primitives: skybox, sun,
+  water, ground, fog, clouds, ambient, terrain, reflections (and the hemispheric
+  light). **No DOM, no Babylon.** So nobody hand-copies our
+  attributes: a consumer's hand-written skybox schema carried 6 of 16 and
+  disagreed on a default. Drift is caught by a test, not promised.
+
+- **`province-climate`** — water, temperature and volcanism as bipolar bias
+  curves (`0.5` leaves the base alone) plus water presence and level as scalars,
+  because "there is a lake here at 12 m" is not something a curve can say.
+
+- **`spinner3d` / `progress3d`** — the widget set could say what a value IS but
+  not that work was under way. The spinner animates as GEOMETRY, not CSS,
+  because a keyframe animation does not run once the SVG is rasterised to a
+  texture — it would look right flat and freeze in a headset.
+
+- **Filtered tables** — `filter` / `setFilter(predicate)` and `counts`. A filter
+  never drops a selection: hiding is a view state, and losing a selection to it
+  would make typing in a search box destructive.
+
+- **`table` button columns** — `kind: 'button'` with `menu(row)` opens an action
+  menu anchored to the cell. The button takes the press instead of the row, so
+  a row's ⋯ does not also select it.
+
+- **`registerIcons`** — consumers add icons every widget resolves by name.
+- **Log sliders** — `scale: 'log' | 'log2'`, `snap`, and `zeroStop` for a
+  quantity that spans decades and can still be switched off.
+- **Action menus** — `openMenu3d`, `button3d({ menu })`, `iconGrid3d` menu
+  cells; `disabled` takes a predicate so a menu can be a constant.
+- **`table`** — `ColumnSpec.kind: 'icon'`.
+
+### Fixed
+
+- A **move** no longer costs a scene, and a genuine removal now disposes the
+  engine — a leaked WebGL context is not just memory (Chrome caps them near 16
+  and force-loses the oldest).
+- `shadows`, the gel and `geometry` each accepted a write and did nothing; all
+  three now sync per render. Lamps also never marked shadow **receivers**, so a
+  shadow map was rendered that nothing read.
+- `canonicalProgram` silently dropped `duration`, so a committed edit turned a
+  flickering lamp steady.
+- A nested widget's popup opened at the top of its container rather than beside
+  the control.
+- `lightEditor3d` shipped demo copy into every consumer's panel; the hint is now
+  opt-in.
+- The aircraft chase camera sat too close after content moved to human scale.
+- **`themeEditor` never called back.** It read `config.onChange` while its
+  callers passed `handleChange`, so the theme table updated and the host's
+  rebuild never ran — the controls moved and the panels they edit did not.
+  `handleChange` is now the option; `onChange` still works, deprecated.
+- A metric typed **out of range** left the slider on the cap and the number
+  field above it, with the theme taking the out-of-range value — the exact
+  drift a paired slider-and-field exists to prevent. Values are clamped now.
+- Two demos (`w3d-theme`, `keyboard`) passed `handleChange` to `inputField`,
+  which reads `onChange` — so typing updated nothing. Demo code lives in doc
+  comments and is **not type-checked**, which is why this class of mistake
+  reaches a page instead of the compiler.
+- **The `curve-program` demo was truncated on the published site.** Its doc
+  comment contained a nested `/* … */`, and block comments do not nest — the
+  inner `*/` closed the page early, so roughly half the demo silently vanished.
+- **The in-scene panel was sized by a guess, and the guess was wrong for the
+  one panel that mattered.** Height was `46 + rows × 48`, which assumes a row is
+  about 48px. `lightEditor3d` is ONE row that lays out over 1200px, so its panel
+  was built ~142px tall and you scrolled a postage stamp. It now sizes to its
+  content (`height: 'fit'`) with a cap, so the same panel is 620px — Tonio, from
+  the headset: _"crammed into a tiny tiny view so you have to scroll it
+  constantly… I didn't try messing with curves because they were too far down."_
+- **The in-scene panel's icon bar no longer scrolls away.** It carries Exit VR,
+  and a control you need in order to LEAVE is the one thing a headset panel
+  cannot afford to lose. `panel3d` gained a `header` option — rows pinned above
+  the scrolling body — which also ends a divergence, since the flat
+  presentation has always pinned its bar by rendering it as DOM.
+- **The theme editor no longer follows you to other demos.** It edits the global
+  table deliberately (that is what makes both panels re-theme live), but the doc
+  site is one page, so walking away left everything else wearing your palette.
+  The demo now restores it on unmount.
+- **`dist` could not be imported by Node at all** — 394 relative specifiers were
+  written without an extension (`from './tosi-b3d'`), which every bundler and
+  Bun resolves and Node's ESM resolver does not. Reported by
+  `tosijs-3d-ensemble` (#69) after they fixed the identical fault in their own
+  package and the failure moved one level down into ours.
+
+  Source specifiers now carry `.js` — the TypeScript convention, passed through
+  by `tsc` and resolved fine by bundlers, so it works everywhere and keeps the
+  per-file `dist` we ship deliberately. That covers deep package subpaths too
+  (`@babylonjs/core/Misc/observable.js`), which failed the same way. Verified by
+  importing the built package under Node 24, not by reasoning about it.
+
+  A test now asserts it **of the source**, so it fails at authoring time rather
+  than after a publish — the only moment anyone was going to notice, since every
+  loop here is a bundler or Bun.
+
+- **Subpath exports** — `import { validateLight } from 'tosijs-3d/light-settings'`
+  now works. The pure modules were split from their editors precisely so a
+  consumer could validate documents headlessly, but the only export was the
+  barrel, which defines custom elements on import and needs `HTMLElement`. So
+  the headless half was still behind a browser. It is not now.
+
+  ⚠️ **This is a wildcard** (`"./*"` → `./dist/*.js`), so **every module in
+  `dist/` is now a supported specifier** and covered by semver — renaming one is
+  a breaking change from here on. 142 of them were already public through the
+  barrel; the genuinely new surface is nine. The three superseded modules
+  (`reflections`, `dynamic-shadows`, `rippling-water`) are explicitly blocked so
+  the wildcard cannot resurrect them.
+
+- **`handleX` now works on every callback option, and `onX` is deprecated.**
+  It used to depend on which widget you were holding — `curve3d` took
+  `handleChange`, `inputField` took `onChange`, and neither complained about the
+  other — which is what made three of the bugs above possible. Migrated:
+  `table` (`handleSelect`/`handleActivate`), `box`'s `BoxChild` and `button`
+  (`handleActivate`), `surface`'s `MenuItem` (`handleSelect`), `inputField`
+  (`handleChange`/`handleEnter`/`handleFocus`, on the object as well as in
+  config), `keyboard` (`handleKey`/`handleAction`/`handleCaretMove`), popups
+  (`handleClose`), and debug-source actions (`handleClick`). Every `onX` still
+  works, warns **once per name**, and is removed in 0.9.
+- `b3d-trigger` gains **`whenEnter`/`whenExit`** (components use `when*`, like
+  `whenImpact`). Passing `onEnter` to the element creator never set the field at
+  all — it added a listener for the `'enter'` CustomEvent, so the callback got
+  an Event while `trigger.onEnter = fn` got the trigger. Same callback, two
+  different arguments depending on how you attached it.
+- The `curve-program` and `curve-field` editors did not exist inside a headset:
+  both put their controls in flat DOM beside the canvas, which an immersive
+  session does not render. Both now also build through `scenePanel`.
+
+### Changed
+
+- Doc pages are named for what they are (`Light program editor`, `Curve
+editor`, `Lamps`) rather than for their module. URLs are unchanged.
+- ⚠️ `shadows="on"` is not free — one extra render of the caster list per lamp
+  per frame, worse with a large `range`. Prefer `off` for dynamically inserted
+  content.
+
+## 0.7.8
+
+Lights you can see, edit and animate — and the editor surface `tosijs-3d-ensemble`
+asked for, built to their spec so they can adopt it without writing widgets.
+
+### Added
+
+- **Lamps.** `b3dPointLight`, `b3dSpotLight`, `b3dAreaLight` — a placed light
+  that comes with its own fixture geometry (toggle it, scale it, bring a GLB, or
+  parent your own to the lamp's `node`). Shadows where Babylon allows them
+  (point/spot; `RectAreaLight` is not a `ShadowLight`) and **gels** where it does
+  (spot only — `projectionTexture`, bitmap or SVG). The two gaps warn once rather
+  than being faked.
+
+  The fixture **tracks its light**: a fluorescent's bulb stutters as it strikes
+  and dims to a red ember as it dies.
+
+- **Light programs** (`light-modulation`). A lamp's whole life as ONE curve per
+  channel — brightness, hue, saturation, range — divided into attack / sustain /
+  decay by two markers. The seams cannot jump because there is only one curve, so
+  **the curve's value at `attackEnd` IS the sustain level**.
+
+  ⚠️ **Contract:** if `sustainEnd` precedes `attackEnd` the sustain collapses to
+  zero width AT `attackEnd`, deterministically. Stated because a consumer's
+  validator reports it as a warning rather than an error, which is only correct
+  while the behaviour is specified. Changing it is a breaking change.
+
+- **`curveProgram3d`** — several curves sharing one pair of draggable split
+  markers, as a single field. **`lightEditor3d`** wraps it with the lamp's static
+  properties (power switch, type, colour, intensity, range, shadows).
+
+- **`light-settings`** — a lamp as DATA: schema, canonical form, validator. **No
+  DOM and no Babylon**, so it works in a headless runner.
+
+- **Curve interop**, to `tosijs-3d-ensemble`'s specification: `canonicalCurve`
+  (4dp, stable bytes), `readCurve` (accepts the bare array or a `{kind, points}`
+  wrapper), `validateCurve` / `validateProgram` / `validateLight` (never throw;
+  `error`/`warning` only; relative JSON Pointer paths), and `curveSchema` /
+  `lightProgramSchema` / `lightSettingsSchema` emitting `x-widget` +
+  `x-curve-kind` for panels generated from JSON Schema.
+
+- **`handleCommit`** alongside the live `onChange` on `curve3d`, `curveMarkers`,
+  `curveProgram3d` and `lightEditor3d` — one commit per gesture, carrying
+  canonical values and a bare verb phrase (`'move attack split'`), so a document
+  records one undo step per edit instead of one per pointer-move.
+
+- **Log sliders.** `slider3d({ scale: 'log' | 'log2' })` gives every decade or
+  octave equal travel, plus `snap` to quantise the value. For intensity, noise
+  scale, grid size — anything where a linear track puts everything you want in
+  its first few percent.
+
+- **Action menus.** `openMenu3d` / `menu3d`, `button3d({ menu })`, and a `menu`
+  on an `iconGrid3d` cell. `disabled` takes a **predicate**, so a menu can be a
+  module-level constant instead of being rebuilt whenever its state moves.
+  `WidgetHost` is now exported — it was unnameable from outside.
+
+### Fixed
+
+- **Lamps never marked shadow RECEIVERS**, so a `shadows="on"` lamp rendered a
+  shadow map nothing read — a full extra render pass that presented as lights
+  shining through solid objects.
+- **`shadows` accepted a write and did nothing.** It was set up once at scene
+  ready and never re-read, so toggling it in an editor had no effect.
+- **A pale lamp could not be reddened.** Rotating a hue preserves saturation and
+  the saturation curve is `[0,1]`, so it could only desaturate — "pale tube dies
+  as a red ember" was inexpressible. Added `saturationScale`.
+- **The aircraft chase camera** sat too close after content moved to human
+  scale; pulled back 30% with the framing angle preserved (0.13° drift).
+- Log slider values no longer carry float noise (`0.010000000000000009`), which
+  matters because they are serialised and diffed.
+
+### Changed
+
+- ⚠️ **`shadows="on"` is not free**, and the cost is worst where it is least
+  visible: every such lamp is an extra render of the caster list, per frame, and
+  large `range` sweeps more of the world into it. Prefer `off` for dynamically
+  inserted content. See `TODO.md` → arbitration for inserted lights.
+
 ## 0.7.7
 
 A lifecycle release. `<tosi-b3d>` now distinguishes being **moved** from being

package/Migration.md

@@ -9,6 +9,54 @@ This file ships **inside the package**, because a migration table you can only
 read on GitHub does not exist for someone who has already installed the thing
 and is staring at an error.
 
+## 0.7.8 → 0.8.0
+
+**Nothing breaks at runtime.** Both items below keep working in 0.8.x; one is an
+install-time floor, the other is a deprecation with a removal date.
+
+### 1. Peer floor: `tosijs` `^1.7.8` → `^1.9.2`
+
+Upgrade `tosijs` alongside this. npm will refuse to install otherwise
+(`ERESOLVE`); bun and pnpm warn and proceed, which is the case worth reading on.
+
+One behaviour changed with it, and it is silent. A wrong-typed write to an
+`initAttributes` prop used to be **discarded**; since tosijs 1.9 it **warns and
+applies the value as given**. So on an `'on' | 'off'` attribute, `foo: false`
+used to mean `'on'` and now genuinely sets `false` — anything comparing against
+the string breaks instead of quietly defaulting.
+
+Use **`isOff()`** from `tosijs-3d`, which accepts `'off'`, `false` and
+`'false'`, rather than comparing to a string yourself.
+
+### 2. Callback options: `onX` → `handleX`
+
+Every callback option in the library now takes `handleX`. The old `onX` spelling
+still works, warns **once per name**, and is **removed in 0.9**.
+
+| widget                                   | old                                  | new                                              |
+| ---------------------------------------- | ------------------------------------ | ------------------------------------------------ |
+| `inputField`                             | `onChange` / `onEnter` / `onFocus`   | `handleChange` / `handleEnter` / `handleFocus`   |
+| `keyboard`                               | `onKey` / `onAction` / `onCaretMove` | `handleKey` / `handleAction` / `handleCaretMove` |
+| `table`                                  | `onSelect` / `onActivate`            | `handleSelect` / `handleActivate`                |
+| `box` `button` / `BoxChild`              | `onActivate`                         | `handleActivate`                                 |
+| `surface` `MenuItem`                     | `onSelect`                           | `handleSelect`                                   |
+| `showPopup` / `openPopup` / `openMenu3d` | `onClose`                            | `handleClose`                                    |
+| `addDebugSource` actions                 | `onClick`                            | `handleClick`                                    |
+| `themeEditor`                            | `onChange`                           | `handleChange`                                   |
+
+**Why, in one sentence:** these are plain factories today, but the moment one
+becomes a tosijs component the element creator binds an `on*` prop as a DOM
+event **listener**, so the callback is never called and nothing errors — which
+is not hypothetical, it shipped three times in this codebase.
+
+**Components use `when*`, not `handleX`** — `b3d-trigger` gains
+`whenEnter`/`whenExit` (`onEnter`/`onExit` still work). Passing `onEnter` to the
+element creator never set the field at all; it added a listener for the `'enter'`
+CustomEvent, so your callback received an `Event` instead of the trigger.
+
+If you write your own widgets, `handlerOf(config, 'handleX', 'onX')` is exported
+so you can follow the same rule.
+
 ## 0.6.2 → 0.7.0
 
 > # ⚠️ READ THIS FIRST: library rotation

package/dist/ambient-budget.d.ts

@@ -1,4 +1,4 @@
-import type { PerfTier } from './perf-probe';
+import type { PerfTier } from './perf-probe.js';
 /** What one ambient effect is asking the scene for. */
 export type AmbientRequest = {
     id: string;

package/dist/ambient-budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ambient-budget.d.ts","sourceRoot":"","sources":["../src/ambient-budget.ts"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV;8DAC0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAA;IACX,uDAAuD;IACvD,OAAO,EAAE,QAAQ,CAAA;IACjB,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,IAAI,cAAc,CAAA;IAC/B,kFAAkF;IAClF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxC;AAOD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAIrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACrC,iBAAiB,CAwBnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5C,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,EAAE,gBAAgB,GACrB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBrC"}
+{"version":3,"file":"ambient-budget.d.ts","sourceRoot":"","sources":["../src/ambient-budget.ts"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV;8DAC0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAA;IACX,uDAAuD;IACvD,OAAO,EAAE,QAAQ,CAAA;IACjB,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,IAAI,cAAc,CAAA;IAC/B,kFAAkF;IAClF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxC;AAOD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAIrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACrC,iBAAiB,CAwBnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5C,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,EAAE,gBAAgB,GACrB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBrC"}

package/dist/b3d-aircraft.d.ts

@@ -1,11 +1,11 @@
 import * as BABYLON from '@babylonjs/core';
-import type { B3d } from './tosi-b3d';
-import { B3dControllable } from './b3d-controllable';
-import type { ControlInput } from './control-input';
-import type { B3dRadar } from './b3d-radar';
+import type { B3d } from './tosi-b3d.js';
+import { B3dControllable } from './b3d-controllable.js';
+import type { ControlInput } from './control-input.js';
+import type { B3dRadar } from './b3d-radar.js';
 export declare class B3dAircraft extends B3dControllable {
     static preferredTagName: string;
-    inputMapping: import("./virtual-gamepad").InputMapping;
+    inputMapping: import("./virtual-gamepad.js").InputMapping;
     static initAttributes: {
         url: string;
         library: string;

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

@@ -1 +1 @@
-{"version":3,"file":"b3d-aircraft.d.ts","sourceRoot":"","sources":["../src/b3d-aircraft.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"b3d-aircraft.d.ts","sourceRoot":"","sources":["../src/b3d-aircraft.ts"],"names":[],"mappings":"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"}

package/dist/b3d-aircraft.js

@@ -304,12 +304,12 @@ faster than `crashSpeed`, or banked/inverted, crashes instead of lands.
 */
 /*{ "parent": "Vehicles" }*/
 import * as BABYLON from '@babylonjs/core';
-import { canonicalize, applyCenterOfGravity } from './model-transform';
-import { B3dControllable } from './b3d-controllable';
-import { aircraftMapping } from './virtual-gamepad';
-import { equilibriumSpeed, flyByWireStep, targetVelocity, chaseVelocity, } from './fly-by-wire';
-import { placeOnSurface, boundingBottomOffset, isOff, collidable, } from './b3d-utils';
-import { spawnProjectile, spawnMissile } from './b3d-launcher';
+import { canonicalize, applyCenterOfGravity } from './model-transform.js';
+import { B3dControllable } from './b3d-controllable.js';
+import { aircraftMapping } from './virtual-gamepad.js';
+import { equilibriumSpeed, flyByWireStep, targetVelocity, chaseVelocity, } from './fly-by-wire.js';
+import { placeOnSurface, boundingBottomOffset, isOff, collidable, } from './b3d-utils.js';
+import { spawnProjectile, spawnMissile } from './b3d-launcher.js';
 // Small gap kept between the model's belly and the ground.
 const GROUND_SEPARATION = 0.05;
 const DEG2RAD = Math.PI / 180;
@@ -486,9 +486,23 @@ export class B3dAircraft extends B3dControllable {
      * rather than being swung below when the aircraft pitches/rolls. */
     eyeHeight = 0.9; // cockpit height above the origin
     cockpitForward = 0.5; // cockpit offset toward the nose (local +Z)
-    chaseMinHeight = 2.0; // chase height zoomed all the way in
-    chaseHeight = 3.2; // chase height zoomed out (overview)
-    chaseDistance = 4.8; // chase distance behind
+    /*
+    Scaled 1.3x when content moved to human scale (a person is 1.8 m, so the
+    aircraft roughly doubled) and the chase sat too close — the plane filled the
+    frame.
+  
+    All three move TOGETHER on purpose: `_chaseLookPitch` is
+    `atan2(chaseMinHeight, chaseDistance)`, so scaling both leaves the ratio and
+    therefore the framing ANGLE untouched. The camera backs off along the same
+    sight line rather than tilting, which is what "pull it back" should mean and
+    is not what changing distance alone would do.
+  
+    These feed the XR rig too (tosi-b3d reads them for the VR chase), so this
+    moves both presentations — correct, since the subject grew in both.
+    */
+    chaseMinHeight = 2.6; // chase height zoomed all the way in
+    chaseHeight = 4.2; // chase height zoomed out (overview)
+    chaseDistance = 6.2; // chase distance behind
     velocity = new BABYLON.Vector3(0, 0, 0);
     _fwd = new BABYLON.Vector3(); // scratch: world nose direction (unit)
     // Weapon cooldowns (seconds until ready) + edge-detect for the one-shot weapons.