tosijs-3d 0.8.14 → 0.9.0

package/CHANGELOG.md

@@ -6,6 +6,228 @@ 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.9.0
+
+**A sea that knows its shore, and a temperature that means one.** The water
+takes the depth and the distance to land from the terrain and draws surf that
+runs in, pale shallows and sea ice; solid ice is solid for everything in the
+scene. Temperature is now a real scale (0 is 0 °C, 1 is 50 °C), so the same
+dial reaches Titan and Venus.
+
+Size: barrel (min, packages external) 948.5 KB raw / 318.9 KB gz, +1.75% on
+0.8.15 (the shore model and its shader).
+
+### ⚠️ Breaking
+
+- **`biomeTemperature` is a temperature, and `-1` no longer means
+  "default".** `0` is 0 °C and each unit is 50 °C (`1` = 50 °C, `-1` =
+  -50 °C, which warns once in the console), with no limit either way, so a world
+  can be as cold as Titan or as hot as Venus. It used to be the biome
+  chart's `0…1` axis with `-1` for "default". Convert old values with
+  `(old - 0.36) / 0.8`; the default is now `0.45` and looks the same. The
+  chart is a window onto the new scale (-22.5 °C to 40 °C) and clamps beyond
+  it. `chartTemperature` / `planetTemperature` convert. Everything inside the
+  biome shader, province climate and decorator bands is still in chart
+  units. See [Migration](./Migration.md).
+
+### Changed
+
+- **The deprecated `onX` callback names stay for one more minor.** They were
+  announced as "removed in 0.9"; they are removed in **0.10** instead, and
+  still work and warn once in 0.9.x. The same goes for the other names marked
+  for removal in 0.9 (`whenEnter`/`whenExit`'s old spellings on the trigger,
+  the manipulator's, `generateGalaxy`). Nothing to do yet beyond renaming at
+  your own pace.
+
+### Added
+
+- **A shoreline, and sea ice.** `<tosi-b3d-water shore="on">` gives the water
+  the depth of the ground under each vertex (from the scene's terrain) and
+  draws from it: surf (wave fronts running in to the shore one after
+  another, and a wet edge lapping at the waterline), paler water over the
+  shallows, and ice. The surf is drawn from each vertex's DISTANCE to the
+  waterline, not its depth, so it is the same width on a steep shore as on
+  a flat one. The distance is a real one, carried across the grid from
+  the waterline, so the fronts are evenly spaced whatever the bed does.
+  `shoreFine` doubles the mesh near the viewer: a vertex every 2 m out to
+  64 m (about 16,600 in all) where there is otherwise one every 4 m. The ice follows the cold and the shore: a solid sheet
+  along the beach, breaking into plates further out, open water beyond, and
+  all of it moving out to sea as the climate at sea level (season included)
+  gets colder. It is there from below as well. The sea starts to freeze at
+  -2 °C at the beach; open water stays clear to about -8 °C and is one
+  unbroken surface by -22.5 °C. `iceCover(temperature, depth)` is the rule; see [water-shore](/water-shore/). With `shore="on"` a vertex
+  colour on the water mesh is shore data, not a tint. The shader patch is
+  made once for the page, so this holds for EVERY `WaterMaterial` on a page
+  that has one `shore="on"` water: a vertex-coloured water mesh of your own
+  loses its tint there.
+- **Solid ice is solid.** Ice is water until it has knitted solid
+  (`iceBears`); where it has, the water carries an invisible collision mesh
+  (collision group `ice`), so anything that collides or picks meets it: a
+  car, a shell, a ground probe. Plates and a sheet still showing its cracks
+  are water. Wave displacement fades out under ice, so the sheet lies flat
+  where it collides. A biped swimming at the surface climbs onto solid ice;
+  one that dived first goes under it, with the ice as a ceiling.
+  `water.iceBearsAt(x, z)` asks for any point.
+
+### Fixed
+
+- **Water animates on every browser.** Babylon's `WaterMaterial` advances
+  its clock only on a frame whose duration differs from the last, so where
+  frame times are steady (a browser that rounds its timer, a display holding
+  its rate) the ripples crawled. `<tosi-b3d-water>` now writes the
+  material's time itself, once a frame, from the scene's clock. It also
+  stops when the scene is paused.
+- **Fog takes the sky's tint.** A `syncSkybox` fog fades distant ground to
+  the skybox's `horizonColor`, which ignored `horizonTint`: under a tinted
+  sky the far hills stood out as a pale blue-white band along the horizon.
+  It now keeps its brightness and takes the tint's hue, by `tintStrength`.
+- **Land and Sky: no air, no cloud.** The demo's cloud cover and orographic
+  dials are thinned by the air setting (none below a twentieth of Earth's),
+  so Mars has a clear sky. The cloud deck itself is unchanged.
+- **Negative `cirrus` had a quarter of the cloud of positive `cirrus`.** The
+  two streak directions were built differently; across-the-wind is now the
+  same field turned a quarter, so the sign changes only which way the streaks
+  run.
+- **Clouds needed exactly full air.** With `atmosphere` under about 0.8 the
+  sky dome becomes a blended mesh, and it was drawn after the cloud deck and
+  over it. It is now drawn first.
+- **A little less air cleared the haze almost completely, and a slow drag
+  back to full air never quite arrived.** The vacuum fog layer now mixes fog
+  by strength (`FogLayer.reciprocal`), and the sky's air value lands exactly
+  on 0 and 1.
+
+## 0.8.15
+
+**Rocks and trees that belong to the land.** Procedural rocks, Quaternius
+trees gathered into copses, and a biome shader that colours vegetation by the
+ground under it and by the season: autumn colour, bare winter branches, snow.
+
+Size: barrel (min, packages external) 932.0 KB raw / 313.0 KB gz, +1.85% on
+0.8.14.
+
+### Added
+
+- **Procedural rocks.** `rockGeometry({ seed })` makes a rock from a seed
+  (a sphere cut by random planes, roughened, squashed, sunk into the ground):
+  pure, deterministic, no model file. The decorator's default boulders and
+  stones are now these instead of Kenney's, and it shades them with the
+  terrain's own biome colours, so their tops take whatever grows there and
+  they change colour with the planet. A scatter rule asks for one by name:
+  `rock:boulder:3` (`rockNames('boulder', 6)` lists six). See
+  [procedural-rock](/procedural-rock/).
+
+- **The scatter gathers into clumps.** Every rule now clusters by default
+  (copses, thickets, rock fields, with thin outliers between) instead of
+  spreading evenly. Per rule: `clump` (0 = the old even spread, default
+  0.85), `clumpScale` (this rule's clump size relative to the scatter's) and
+  `clumpGroup` (rules in one group gather in the same places; the default
+  stones gather around the boulders). The scatter and `<tosi-b3d-decorator>`
+  take `clump` (one strength for every rule) and `clumpSize` (metres; 0 =
+  auto, about two and a half times the average spacing, so pulling `radius`
+  in keeps the clumps).
+- **The scatter's budget is a ceiling.** It no longer fills the gaps between
+  clumps, or packs thin habitat as full as lush, to reach the number: a small
+  radius or a map that is mostly sea gets fewer and keeps its shape. It also
+  lays down at least `oversample` × budget candidates (it could lay down
+  half that), so a high budget no longer stalls below itself.
+- `ScatterRule.sink`: how much of a model is buried. The default rocks bury a
+  quarter or more; they used to rest on their lowest point and looked set
+  down on the ground, or floating over it. Same seed gives a DIFFERENT layout
+  than before; set `clump: 0` on a rule to get the old one back.
+
+- **Seasons in the biome shader.** `<tosi-b3d-terrain biomeSeason
+  biomeSeasonality>` (params `season`, `seasonality`): the year swings the
+  chart's temperature axis, so winter cools the whole ground (snow lines drop)
+  with no second palette. `seasonality` defaults to 0, so nothing changes
+  until you ask. `seasonOf(season, seasonality)` is the pure rule.
+- **Winter snow.** Where the season takes a moist place below freezing
+  (temperature about 0.3), snow lies on level ground and the tops of rocks,
+  and evergreen foliage goes white. It is a layer of its own, applied only
+  while the season is pulling cold, so a world without seasons is unchanged.
+- **Deciduous trees drop their leaves.** After the autumn turn (season 0.55
+  to 0.7) `leaf`-role canopies thin in soft patches and are gone through
+  winter, leaving trunk and branches, then return across the spring equinox.
+  Evergreens, and anything in warm country, keep theirs. A bare tree still
+  casts its full summer shadow and still counts in ambient occlusion.
+- **Vegetation roles: trees take their colour from the land.**
+  `BiomePlugin.role` is `'ground'` (as before), `'leaf'`, `'evergreen'` or
+  `'bark'`. A leaf is its own green pulled toward the colour of the ground
+  under it (`leafBlend`), and turns in autumn in temperate country; an
+  evergreen does not turn. The decorator assigns roles by material name
+  (`roles`, default `NATURE_ROLES`, with `Model*/Material` keys for one
+  model's use of a shared material).
+
+- An **Occlusion on/off button in Perf Stats**, so its cost can be read in any
+  demo on any device; Land and Sky has its own control too.
+
+### Changed
+
+- **⚠️ The decorator's defaults changed: models, rocks and layout.** See
+  [Migration](/Migration/) for the exact steps. In short:
+  - With no `url` it now loads `quaternius/libraries/nature.glb` (a curated
+    64-model library: common, pine, birch, willow and palm trees, dead trees,
+    bushes, cacti, undergrowth) with the new `NATURE_RULES`. Custom rules that
+    use Kenney's model names and set no `url` now find none of their models:
+    the decorator warns and places nothing for them. Set `url` to
+    `assetUrl('kenney/libraries/nature-kit.glb')`.
+  - Naming a `url` still gets `NATURE_KIT_RULES` and Kenney's trees, but NOT
+    the old result: its rocks are now the procedural ones, everything clumps,
+    and the same seed gives a different layout. `clump: 0` on a rule (or
+    `clump="0"` on the element) restores the even spread.
+  - Rocks are no longer placed on a volcanic province. They cannot read the
+    province, so they came out the colour of the country around it.
+  - The new trees are heavier (about 1,000 vertices each against Kenney's
+    100): Land and Sky's 2,000 placements went from about 205k to 365k
+    vertices.
+
+- **A volcano's flank is bare basalt, and seams start only near the top.**
+  Walking in from the edge of `volcano()`'s province you now cross the biome,
+  then plain basalt, then faint seams from about 55% of the way to the crater
+  rim; stronger veins and open lava are inside the crater only. The rim's
+  province value is 0.25 (it was 0.5). In the biome shader, a local province
+  draws no seams below 0.14 and all of them by 0.4; the global `volcanism`
+  dial is unchanged. Land and Sky's volcano keeps its size with a smaller
+  crater (radius 55, it was 90).
+
+- **A standalone headset sizes build-once budgets for stereo from the start.**
+  Terrain detail and tile pool, shadow map and cascade count, cloud shadows and
+  reflection probes are sized when the scene is built, which is before any
+  session, so a Quest got the flat (`medium`) numbers and kept them in VR. They
+  now resolve at the XR tier (`low`) on a standalone headset, flat included:
+  terrain 12 subdivisions and 56 tiles instead of 16 and 80, shadows 2 cascades
+  instead of 4. A PC driving a headset is unaffected. `headsetDevice()` is
+  exported for your own build-once budgets.
+
+- **Water's reflection and refraction follow the device tier.** Each is the
+  whole scene drawn again, and both were 1024 and redrawn every frame on every
+  device. `textureSize` now defaults to auto (1024 / 512 / 256) and a new
+  `reflectionRefresh` redraws them every Nth frame (1 / 2 / 3) on a flat
+  screen; inside a headset session they are redrawn every frame, because
+  skipping one eye breaks stereo. Top-tier devices are unchanged. To keep the old behaviour everywhere, set
+  `textureSize="1024" reflectionRefresh="1"`.
+- Land and Sky's lightning storm toggle moved to the Weather tab.
+
+### Fixed
+
+- **A small, distant sun is visible in an airless sky.** Its disc is drawn at
+  true size, which from Jupiter is under a pixel, so Io had no sun. A tight
+  glare now takes over as the disc shrinks.
+
+- **A world with no moisture grows nothing.** The cactus rule accepted a
+  moisture of zero, so Mars grew cacti (and a few dead trees).
+
+- **Switching decorator shadows on made whole models vanish**, and every
+  rebuild flashed the full scatter before dropping most of it. Each part's
+  shadow-only twin shared its geometry, and with it the thin-instance buffer,
+  so the visible mesh drew its full count from the twin's short list and
+  WebGL rejected the draw. The twin now has its own geometry.
+
+- A menu hung off a narrow button (`button3d({ menu })`, `openMenu3d`) is now as wide as its longest label. It used to take a 160 floor, so longer labels ran out of the box (Land and Sky's preset menu).
+- **A `select3d` inside a `row3d` stepped to its next option instead of opening
+  its list.** A row did not pass the panel's host to its children, and a select
+  with no host falls back to stepping. Land and Sky's world picker jumped from
+  Earth to Mars on a tap. (Seen in a headset, reproduced flat.)
+
 ## 0.8.14
 
 **Ambient occlusion that works in a headset, and it is the default.**

package/Migration.md

@@ -9,6 +9,97 @@ 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.8.15 → 0.9.0
+
+### 1. `biomeTemperature` is in degrees now: 0 is 0 °C, 1 is 50 °C
+
+**What changed.** `<tosi-b3d-terrain biomeTemperature>` used to be the biome
+chart's own axis: `0…1`, cold to warm, with `-1` meaning "use the default".
+It is now a temperature: `0` is 0 °C and each unit is 50 °C, so `-1` is
+-50 °C, and the value is not limited to any range. The default is `0.45`
+(22.5 °C), which is the same climate as before.
+
+**Who is affected.** Anyone who sets `biomeTemperature`. An old value is read
+on the new scale and comes out much warmer: `0.3` used to be about -4 °C and
+is now 15 °C. `-1` used to mean the default and is now -50 °C.
+
+**What to do.** Convert each value: `new = (old - 0.36) / 0.8`. Replace `-1`
+with `0.45`, or delete the attribute.
+
+| Old | New | Climate |
+|-----|-----|---------|
+| `-1` (auto) | `0.45` | 22.5 °C |
+| `1` | `0.8` | 40 °C |
+| `0.72` | `0.45` | 22.5 °C |
+| `0.36` | `0` | 0 °C |
+| `0` | `-0.45` | -22.5 °C |
+
+`chartTemperature` and `planetTemperature` (from `biome-chart`) do the
+conversion in code. Only this attribute moved. `BiomePlugin.params`, the
+province climate curves and the decorator's rule bands are still in chart
+units.
+
+### 2. Nothing else is removed, including what was promised
+
+The deprecated `onX` callback names (and the other names announced as
+"removed in 0.9") still work in 0.9.x and warn once. They are removed in
+0.10. Rename when convenient.
+
+## 0.8.14 → 0.8.15
+
+**Nothing breaks at compile time. Three defaults change what you see.**
+
+### 1. The decorator's default library is Quaternius', not Kenney's
+
+**What changed.** `<tosi-b3d-decorator>` with no `url` loads
+`quaternius/libraries/nature.glb` and uses `NATURE_RULES`. It used to load
+Kenney's Nature Kit and use `NATURE_KIT_RULES`.
+
+**Who is affected.**
+- You set no `url` and no `rules`: you get the new trees. Nothing to do unless
+  you want the old ones.
+- You set custom `rules` that use Kenney's model names (`tree_oak`,
+  `rock_largeA`) and no `url`: none of those names exist in the new library.
+  The decorator now warns in the console and places nothing for them.
+- You self-host only the Kenney kit: the default URL is a file you do not have.
+
+**What to do.** To stay on Kenney's kit, name it:
+
+```javascript
+b3dDecorator({ url: assetUrl('kenney/libraries/nature-kit.glb') })
+```
+
+With a `url` set and no `rules`, the decorator uses `NATURE_KIT_RULES`.
+
+### 2. Layouts are different, and things clump
+
+**What changed.** Every scatter rule now gathers into clumps by default, the
+candidate grid changed, and the budget became a ceiling (a small radius or a
+mostly-sea map places fewer than the budget). The same seed gives a different
+layout than 0.8.14 did. `NATURE_KIT_RULES`' rocks are now procedural
+(`rock:boulder:1` …) at a different scale, and no rocks are placed on a
+volcanic province.
+
+**Who is affected.** Anyone who stored placements, compared them in a test, or
+tuned a scene around where things stood.
+
+**What to do.** There is no switch that restores 0.8.14's exact layout. For an
+even spread again, set `clump="0"` on the element (or `clump: 0` on a rule).
+
+### 3. Water reflections follow the device tier
+
+**What changed.** `<tosi-b3d-water>`'s `textureSize` defaults to auto (1024,
+512 or 256 by device tier; it was 1024 everywhere) and a new
+`reflectionRefresh` redraws the reflection every frame, every second or every
+third by tier on a flat screen.
+
+**What to do.** Top-tier devices see no change. To keep the old behaviour on
+every device:
+
+```javascript
+b3dWater({ textureSize: 1024, reflectionRefresh: 1 })
+```
+
 ## 0.8.0 → 0.8.1
 
 **Nothing breaks at compile time, and one behaviour changes.** The
@@ -95,7 +186,8 @@ Use **`isOff()`** from `tosijs-3d`, which accepts `'off'`, `false` and
 ### 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**.
+still works, warns **once per name**, and is **removed in 0.10** (announced
+for 0.9, then kept one more minor).
 
 | widget                                   | old                                  | new                                              |
 | ---------------------------------------- | ------------------------------------ | ------------------------------------------------ |

package/dist/angle-field.d.ts

@@ -20,7 +20,7 @@ export interface Angle3dOptions {
     /** Ring diameter. `0` fits the row to the panel width. */
     size?: number;
     handleChange?: (v: number) => void;
-    /** @deprecated use `handleChange` — removed in 0.9. */
+    /** @deprecated use `handleChange` — removed in 0.10. */
     onChange?: (v: number) => void;
     handleCommit?: (v: number) => void;
 }
@@ -33,7 +33,7 @@ export interface Arc3dOptions {
     maxWidth?: number;
     size?: number;
     handleChange?: (v: Arc) => void;
-    /** @deprecated use `handleChange` — removed in 0.9. */
+    /** @deprecated use `handleChange` — removed in 0.10. */
     onChange?: (v: Arc) => void;
     handleCommit?: (v: Arc) => void;
 }

package/dist/angle-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"angle-field.d.ts","sourceRoot":"","sources":["../src/angle-field.ts"],"names":[],"mappings":"AAgIA,OAAO,EAWL,KAAK,GAAG,EAET,MAAM,UAAU,CAAA;AAEjB,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAO3D,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,8EAA8E;IAC9E,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;IACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAC3B,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;CAChC;AAkHD,0BAA0B;AAC1B,wBAAgB,OAAO,CAAC,MAAM,GAAE,cAAmB,GAAG,UAAU,CAgG/D;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAiHzD"}
+{"version":3,"file":"angle-field.d.ts","sourceRoot":"","sources":["../src/angle-field.ts"],"names":[],"mappings":"AAgIA,OAAO,EAWL,KAAK,GAAG,EAET,MAAM,UAAU,CAAA;AAEjB,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAO3D,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,8EAA8E;IAC9E,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;IACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAC3B,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;CAChC;AAkHD,0BAA0B;AAC1B,wBAAgB,OAAO,CAAC,MAAM,GAAE,cAAmB,GAAG,UAAU,CAgG/D;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAiHzD"}

package/dist/atmosphere.d.ts

@@ -40,6 +40,14 @@ export type FogLayer = {
      * which is right for water and for anything you are simply immersed in.
      */
     veil?: number;
+    /**
+     * Blend `start` and `end` by their RECIPROCALS. For a layer that CLEARS the
+     * air (vacuum: distances of millions of metres): blended straight, a weight
+     * of 0.002 toward ten million metres moves a 4 km fog out to 20 km, so
+     * thinning the air a little cleared it almost entirely. Fog strength goes
+     * as one over distance, and that is what should be mixed.
+     */
+    reciprocal?: boolean;
 };
 /**
  * Composite layers over a base, in order. Each pulls the running state toward itself by its

package/dist/atmosphere.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atmosphere.d.ts","sourceRoot":"","sources":["../src/atmosphere.ts"],"names":[],"mappings":"AA+CA;uDACuD;AACvD,MAAM,MAAM,QAAQ,GAAG;IACrB,qBAAqB;IACrB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAqBzE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,QAAQ,EAChB,EAAE,EAAE,MAAM,EACV,GAAG,SAAO,GACT,QAAQ,CAYV;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzE"}
+{"version":3,"file":"atmosphere.d.ts","sourceRoot":"","sources":["../src/atmosphere.ts"],"names":[],"mappings":"AA+CA;uDACuD;AACvD,MAAM,MAAM,QAAQ,GAAG;IACrB,qBAAqB;IACrB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CA8BzE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,QAAQ,EAChB,EAAE,EAAE,MAAM,EACV,GAAG,SAAO,GACT,QAAQ,CAYV;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzE"}

package/dist/atmosphere.js

@@ -69,10 +69,19 @@ export function compositeFog(base, layers) {
         }
         if (layer.density !== undefined)
             out.density = lerp(out.density, layer.density, w);
+        const mix = layer.reciprocal
+            ? (a, b) => a > 0 && b > 0 ? 1 / lerp(1 / a, 1 / b, w) : lerp(a, b, w)
+            : (a, b) => lerp(a, b, w);
         if (layer.start !== undefined)
-            out.start = lerp(out.start, layer.start, w);
+            out.start = mix(out.start, layer.start);
         if (layer.end !== undefined)
-            out.end = lerp(out.end, layer.end, w);
+            out.end = mix(out.end, layer.end);
+        // A reciprocal blend cannot take a zero, so a start of 0 falls back to a
+        // plain lerp while the end beside it moves by reciprocals: toward a far
+        // layer the start then races ahead of the end, and everything nearer
+        // than the end draws as solid fog. The start never passes the end.
+        if (layer.reciprocal && out.start > out.end)
+            out.start = out.end;
     }
     return out;
 }

package/dist/atmosphere.js.map

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

package/dist/b3d-biped.d.ts

@@ -499,6 +499,8 @@ export declare class B3dBiped extends B3dControllable {
     /** Zoom 0..1, now integrated from the d-pad rather than read off a stick. */
     private _camZoom;
     private _waterEl;
+    /** Which side of weight-bearing ice we are on; see water-shore's `iceSide`. */
+    private _iceSide;
     /**
      * Surface height of the scene's water, or `null` if there is none.
      *

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

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

package/dist/b3d-biped.js

@@ -228,6 +228,7 @@ import { collidable, isOff, markUiMesh } from './b3d-utils.js';
 import { canMantle, mantleClip, mantlePath, defaultMantleLimits, } from './mantle.js';
 import { buoyantStep, submergedFraction, isSwimming, swimBuoyancy, } from './buoyancy.js';
 import { aimFromLook, clampAim, easeAim, aimTarget, surfaceAimLimit, } from './swim-aim.js';
+import { iceSide } from './water-shore.js';
 import { fitChase } from './camera-fit.js';
 import { DEFAULT_AIM_LIMITS, aimDirection as aimToDirection, aimPoseWeights, bodyCatchUp, relaxAim, stepAim, wrapDeg, } from './aim.js';
 import { xrControllers } from './gamepad.js';
@@ -366,6 +367,7 @@ const CROUCH_HALF = 0.45;
 const STEP_UP = 0.5;
 /** How far the ground may drop before it becomes a FALL rather than a step. */
 const STEP_DOWN = 0.6;
+const ICE_GROUP = ['ice'];
 /**
  * Vertical kick while swimming, m/s². Enough to beat buoyancy comfortably
  * (which is ~1.5 m/s² of upward push at full submersion) without feeling like a
@@ -1155,6 +1157,8 @@ export class B3dBiped extends B3dControllable {
     /** Zoom 0..1, now integrated from the d-pad rather than read off a stick. */
     _camZoom = 0;
     _waterEl;
+    /** Which side of weight-bearing ice we are on; see water-shore's `iceSide`. */
+    _iceSide = 'none';
     /**
      * Surface height of the scene's water, or `null` if there is none.
      *
@@ -1166,7 +1170,8 @@ export class B3dBiped extends B3dControllable {
     _waterSurfaceY() {
         if (this._waterEl === undefined) {
             this._waterEl =
-                this.owner?.querySelector('tosi-b3d-water') ?? null;
+                this.owner?.querySelector('tosi-b3d-water') ??
+                    null;
         }
         const mesh = this._waterEl?.mesh;
         return mesh ? mesh.absolutePosition.y : null;
@@ -2137,7 +2142,12 @@ export class B3dBiped extends B3dControllable {
             // `collidable()` for the shared rules (UI never counts as floor,
             // isPickable/isEnabled re-checked because a predicate replaces
             // Babylon's own filter); `checkCollisions` stays as OUR clause.
-            collidable((m) => m === node || !m.checkCollisions));
+            // Not the water's ice mesh: which SIDE of the ice we are on is kept
+            // below (`iceSide`), and a probe from just under it would put a diver
+            // on top.
+            collidable((m) => m === node || !m.checkCollisions, {
+                ignoreGroups: ICE_GROUP,
+            }));
             /*
             WATER IS A MEDIUM, NOT A LINE.
       
@@ -2177,7 +2187,25 @@ export class B3dBiped extends B3dControllable {
             this button is the SURFACE control and continuous, so it never charges.
             */
             const jumpDown = (input.jump ?? 0) > 0.5;
-            const surfaceY = this._waterSurfaceY();
+            /*
+            ICE IS WATER UNTIL IT IS SOLID.
+      
+            Where the water's ice bears weight (`iceBearsAt`), the surface is ground
+            from above and a ceiling from below; everywhere else, plates included,
+            it is water and nothing here changes. Which side we are on is decided
+            once, where we meet the ice, and kept (`iceSide` says why). On top, there
+            is no water as far as the rest of this frame is concerned: `surfaceY` is
+            null and the ice stands in for the floor.
+            */
+            const seaY = this._waterSurfaceY();
+            const eyeLevel = this.eyeHeight || 1.6;
+            this._iceSide =
+                seaY != null && node.position.y < seaY + eyeLevel + 1
+                    ? iceSide(this._iceSide, this._waterEl?.iceBearsAt?.(node.position.x, node.position.z) ===
+                        true, seaY - node.position.y, this._swimming, STEP_UP)
+                    : 'none';
+            const onIce = this._iceSide === 'over' && seaY != null;
+            const surfaceY = onIce ? null : seaY;
             // `eyeHeight` as a proxy for body height. It is a little short by
             // definition, which is the harmless direction: equilibrium is a FRACTION
             // of whatever height you give it, so erring small floats you a touch
@@ -2235,8 +2263,15 @@ export class B3dBiped extends B3dControllable {
             */
             const headDepth = surfaceY == null ? 0 : surfaceY - (feetY + bodyHeight);
             const submerged = surfaceY == null ? 0 : submergedFraction(feetY, bodyHeight, surfaceY);
-            const grounded = hit?.hit === true && hit.pickedPoint != null;
-            const groundY = grounded ? hit.pickedPoint.y : -Infinity;
+            const floorHit = hit?.hit === true && hit.pickedPoint != null;
+            const floorY = floorHit ? hit.pickedPoint.y : -Infinity;
+            // The ice is in reach when we are below it (climbing out, or it froze
+            // around us) or within the same drop the ground probe allows.
+            const iceFloor = onIce &&
+                seaY > floorY &&
+                seaY >= node.position.y - (STEP_DOWN + fallStep);
+            const grounded = floorHit || iceFloor;
+            const groundY = iceFloor ? seaY : floorY;
             /*
             THE SWIM/STAND TEST MUST NOT USE THE POSE, or it feeds back on itself.
       
@@ -2427,6 +2462,15 @@ export class B3dBiped extends B3dControllable {
                 });
                 let nextY = node.position.y + this._fallVel * dt;
                 let onFloor = false;
+                // Under bearing ice the head stops at its underside. Before the floor
+                // test, so in water too shallow for both, the floor wins.
+                if (this._iceSide === 'under' && seaY != null) {
+                    const top = seaY - 0.1 - (bodyBottom + bodyHeight);
+                    if (nextY > top) {
+                        nextY = top;
+                        this._fallVel = Math.min(0, this._fallVel);
+                    }
+                }
                 // The floor stops the body's LOWEST point, which in a swim pose is the
                 // trailing legs rather than the root — treading, they hang 1.37 m below
                 // it. Clamping the root instead buried them in the seabed.