1.32.0 — Your 1.31 review, fixed (roadmaps 40 + 41)

.github/workflows/ci.yml

@@ -58,6 +58,10 @@ jobs:
       # `tokens-ok: <reason>` on its line; scripts/check-tokens.cjs says how.
       - name: redesign tokens
         run: node scripts/check-tokens.cjs
+      # 41 G3b: ONE z-index scale (src/styles/ui.css). A page-level literal z-index fails;
+      # `z-ok: <reason>` on its line for a number code reads back.
+      - name: z-index scale
+        run: node scripts/check-zindex.cjs
 
   # 34 B3: scene-lint over every scene core ships (the seed) and every scene of the scenes ref
   # the perf budget is about (perf/budgets.json), with the packs checkout for the kit rules.

CHANGELOG.md

@@ -5,6 +5,114 @@
      per release, newest first. HTML comments like this one are stripped before
      rendering, so maintainer notes stay out of the user-facing window. -->
 
+## 1.32.0 — Your 1.31 review, fixed: sheets that swipe away, tidy docks and a reef that swims 🐠
+
+Everything you flagged in 1.31 and in the 1.32 preview, fixed — plus an Image editor and a real reef in the Aquarium.
+
+### 📱 On a phone
+
+- 👆 **Every sheet has one grab bar**: menus, the Inspector, Configure Scene, Add, the Explorer and every docked window,
+  the profile menu, notes and Customize character. Drag the bar to resize (each sheet remembers its height), swipe it
+  down to the bottom to close. The bar never scrolls away, and no sheet covers **Play** or the selection toolbar.
+- 👤 **Customize character and Profile settings open again** from the profile menu.
+- 🗂️ **Explorer: press and hold a file or folder** for its action sheet — no more browser image callout; hold and move
+  to pick it up. The rename field's selected text is readable, and the toolbar scrolls sideways so the project name
+  is always reachable.
+- ➕ **The dock's "+" lists every window** with a show/hide switch.
+- 🛠️ Fixed a "Something went wrong: ResizeObserver loop" message with the Explorer docked.
+
+### 🪟 Docked and floating windows
+
+- ✖️ **Close a docked window from its tab** — the window itself has no ✕ any more. **Undock** moves to the dock strip,
+  left of *Minimize the dock*, and undocks the window you are looking at (**Settings ▸ Interface ▸ Windows & chrome ▸
+  Undock button** → *All as one tabbed group* takes them all out together).
+- 📥 **A floating tab group has a "Dock all tabs" button**, and **dropping a docked tab onto a floating window adds it as
+  a tab** instead of opening another window. Tab groups no longer lose their header after switching tabs.
+- 🏷️ **Long object and file names stay on one line** with "…" (hover or press and hold for the full name) and never
+  push a window's controls out of place.
+- 🧭 The dock's tab strip stays painted behind every tab and **keeps its scroll** when you pick a tab.
+- 🗔 **Workspace layouts** is a proper dialog on desktop and phone.
+
+### 🖼️ Images
+
+- 📷 **A big photo becomes a texture** instead of being refused — it is scaled to 1024 px.
+- ✂️ **New Image editor** (Explorer ▸ Edit image…, the preview's pencil, or Edit beside a texture): crop, rotate, flip,
+  resize, brightness / contrast / saturation, **Save** or **Save as copy**, and a version history with **Restore
+  original**. Saving updates every texture made from the image, for everyone in the session.
+
+### 🌊 Smoother, and honest about it
+
+- 💧 **Water refraction (and every other automatic quality setting) no longer switches off and on by itself** on phones:
+  a setting that had to be lowered again right after coming back stays lowered for that scene.
+- 🔔 **One notice when quality is lowered for you** — *"Lowered water quality to keep it smooth · Keep full quality"* —
+  replacing the "Simplified water" strip and the object list's quality toast.
+
+### 🐠 The Aquarium is a reef
+
+- 🐟 **Templates ▸ Examples ▸ Aquarium**: clownfish, regal blue tangs and emperor angelfish swim around a reef arch,
+  staghorn coral, eelgrass and Amazon swords from the new **Aquarium Kit** pack. Simple stand-ins show at once and turn
+  into the real fish as they download.
+- 🧭 **Four new motion nodes for anything** (node editor ▸ Animation): **Follow Path** (speed, loop / ping-pong,
+  banking), **Wander**, **Orient to Velocity** and **Body Wave** — a wave travelling along a fish, snake, flag or tail.
+- ✨ **Fish scales material preset**: an iridescent thin film over a scale relief, drawn lighter on phones and headsets.
+- 🛠️ Fixed: LOD groups stuck on their first level in scenes with water.
+
+### 🔁 …and your review of the 1.32 preview
+
+- 🎛️ **Toolbar ▸ Edit positions** (right-click or press and hold any toolbar button): drag the toolbar and corner
+  buttons into place, remove one with the red **−**, add one with the green **+** (up to three in each corner, Play
+  always stays), then the green **✓** applies. A custom button order no longer shows the wrong icons after a reload.
+- ✋ **Selection toolbar**: **Inspect** is an icon that opens *and closes* the properties, and only looks pressed when
+  they are open; **Select multiple** and **Interact** sit after Scale. Interact clears the selection and gives it back
+  when you leave it. On touch, **tap a selected object to deselect it**. Adding an object no longer opens the
+  properties (an open panel follows the new object).
+- 🫳 **Carrying things in Interact** follows your finger or cursor from the point you grabbed — no more objects
+  flung at the camera — and lets go with a gentle throw.
+- 📱 **Phone drawers behave like a phone's sheets**: lists scroll, and at the top of the list a pull down (or a
+  flick) closes the drawer, with resistance and snap points. The main menu closes when you press outside it, the
+  selection toolbar no longer floats over menus or drawers, and an open note steps through **all** notes (‹ ›) and
+  returns to where you opened it.
+- 🪟 **Tabbed floating windows drag smoothly by touch** (tab names too); press and hold a tab for **Ungroup / Dock /
+  Close**. On desktop, **drop a window or tab onto the dock's tab bar** to dock it exactly where the marker shows. The
+  dock's **+** lists every window — **Node editor** and **Image editor** included — and the Image editor can be a
+  dock tab.
+- 🧑‍🎨 **Customize character opens a studio** around your character (**Show in scene** previews it in the world),
+  keeps it fully framed when you fold or unfold the phone, and **Surprise me** deals a new look on every press;
+  presets show their defaults and your edits become a **Custom** entry.
+- 🪜 **Dialogs cover the whole screen** (the logo included) and What's new sits above every button. Questions about
+  deleting, restoring or replacing things are **dialogs** instead of toasts (*Delete flow*, *Restore previous
+  session?*, …). **Settings rows fit their window**: a switch, a short
+  list, a colour, a button or a small set of choices stays beside its label, and only what cannot fit (wide choices,
+  text fields) moves underneath — on a phone, an unfolded phone and a narrow desktop window alike.
+- 🟢 **The connection pill shows a coloured dot** (grey, pulsing yellow, green, red) and says **Connecting… /
+  Connected / Offline** beside it whenever there is room; when the top bar is crowded it shrinks to the dot alone —
+  and **reconnecting after switching tabs no longer toasts**. Only a connection that gives up leaves one notification.
+- 👥 **The connected-people panel is wider**: one row per person (name, then where they are underneath, actions on the
+  right), nothing wraps or breaks; on a phone it is a drawer like the notifications.
+- 🧩 **Node editor**: a one-line breadcrumb bar — tap a crumb to jump to its siblings, hold for the full name.
+- 📈 **Profiler**: hideable sidebars, a **Details** + **Settings** sidebar on the right and a resizable split between
+  the graph and the list.
+- 🗂️ On a phone the Explorer's press-and-hold menu stays open, and docked windows open with their sidebars hidden
+  until you show them.
+- 📱 **On a phone, Properties, Objects, Notes, Layouts and Configure Scene are tabs of the bottom dock** (beside the
+  Explorer and the Node editor) instead of drawers behind it: **Inspect** brings Properties to the front, nothing
+  covers the Play button, and when you unfold the phone or switch to a desktop each panel goes back to its sidebar or
+  window — and returns when you fold it again. Menus, notifications, your profile and Add stay drawers. Tapping the
+  bottom-bar button of the view on screen minimizes it (with undocking on, it shows and hides that floating window),
+  and the main menu closes as Configure Scene opens on a phone (on a desktop it stays open).
+- 🎮 **Phone bottom bar**: **More** can be taken off the bar (a one-time note tells you to press and hold any bar item
+  to get it back), the press-and-hold menu's header reads **More ▸ Edit bar…** and opens More, and **Play can move**
+  along the bar. Play starts as plain **Play**, like on a desktop; pick VR or AR from its press-and-hold menu and its
+  icon follows. The selection toolbar now follows a drawer as you resize it, without lagging behind, and the profile
+  drawer no longer repeats your picture.
+- 📂 **Main menu ▸ Project** has a compact two-column layout — **New from template…**, **Load** | **Save ▾**,
+  **Import** | **Export…** — where **▾** opens one **Save options** dialog with every save setting. A phone keeps the
+  list; **Settings ▸ Interface ▸ Project actions** switches between Auto, Compact and List.
+- 🧩 **Modules on a phone**: Enable/Download/Remove sit to the right of each module, a long description expands when
+  you tap it (tap again to fold it), and the dev-URL row fits the screen. In Browse, **Install** several modules at
+  once: each card keeps **Installing…** until it is done, none cancels another, and a failed one says why with
+  **Retry**. Core no longer opens on a long empty scrollbar after a long Browse list.
+
 ## 1.31.0 — Drag to place: see the size and the spot before you let go 📦
 
 Drag any object from the Explorer onto the scene and see exactly where it will land and how big it is — the way a

CLAUDE.md

@@ -4611,14 +4611,17 @@ loadable play content. Everything a user does must be visible to connected peers
 - The camera PiP frame deliberately sits BELOW the tiers (z-index 2): it is a
   viewport overlay whose picture is drawn by the render loop, so panels and HUD must
   cover it (16-Q6).
-- **z-index tiers** (`ui.css` `:root`): viewport 0 · drawer 30 · bottom 35 · window 40 ·
-  hud 45 · **modal 1100 · toast 1200 · menu 1300**. The high modal/toast/menu values
-  clear the ad-hoc persistent chrome that lives OUTSIDE the scale — Users (avatar/peers)
-  ~996-998, Connect 300, ContextMenu 999-1001, ThemedSelect 9999. flowbite Modal
-  hardcodes its dialog z-50 + backdrop z-40, remapped onto `--z-modal` by an UNLAYERED
-  `[role='dialog'][aria-modal='true']` rule (unlayered beats Tailwind's layered utility
-  without !important). The logo/burger menu sits at `--z-menu` (top-most); opening a
-  modal from it calls `closeMenu.set(true)` so the menu can't cover the modal.
+- **z-index: ONE SCALE (41 G3b), `ui.css` `:root`, lowest first** — `--z-canvas` 0 · `--z-canvas-overlay` 2 ·
+  `--z-chrome` 30 (FABs, Controls pill, side drawers) · `--z-selection` 32 (phone strip, under every sheet) ·
+  `--z-dock` 35 · `--z-sheet` 38 · `--z-window` 40..44 · `--z-phone-bar` 44 · `--z-hud` 45 · `--z-side-panel` 50 ·
+  `--z-chrome-top` 300 (logo, undo/redo, Connect, the top-right corner) · `--z-popover` 1000 (main menu, profile,
+  Add, search) · `--z-toast-low` 1050 · `--z-modal` 1100 · `--z-onboarding` 1150 (What's new, Welcome, tours) ·
+  `--z-portal` 1180 (selects, context menus, drag ghosts — above the modals that open them) · `--z-toast` 1200
+  (approvals). Modals COVER the logo (the old logo-above-modals one-click trick is gone). Use `var(--z-…)` /
+  `z-(--z-…)` or `calc(var(--z-…) ± n)`; `npm run check:zindex` (CI) fails a page-level literal ≥ 30, a
+  number code reads back carries `// z-ok: <reason>`. Old names (`--z-drawer/-bottom/-viewport/-menu`) are
+  aliases. The camera PiP is `--z-canvas-overlay`. App modals are non-modal `<dialog>`s on `--z-modal`;
+  `ConfirmModal`/`SessionPrompts` are true modals (top layer).
 - **flowbite 1.x Dropdowns are TOP-LAYER popovers** (`popover="manual"`, `:popover-open`)
   — they paint above the ENTIRE page whatever the z-index (measured: a panel at 996
   covered the profile avatar at 2000, in the same stacking context). No z-index on an

check-baseline.json

@@ -1,6 +1,6 @@
 {
 	"comment": "27-I: the svelte-check floor, read ONLY by scripts/check-ratchet.cjs. It used to be hardcoded in release.yml's shell block, where it went stale (362 while the tree measured 359). Ratchet it DOWN whenever a change legitimately removes errors - that is the project convention, and --update does it in one command.",
-	"errors": 300,
-	"warnings": 41,
-	"measured": "2026-10-07"
+	"errors": 299,
+	"warnings": 39,
+	"measured": "2026-10-11"
 }

docs/settings-inventory.md

@@ -88,6 +88,7 @@ The sticky footer with three big buttons is removed.
 | 19 | Windows & chrome | Window positions | btn "Reset" | — | `resetWindowLayout()` | | btn "Reset" | |
 | 20 | Windows & chrome | Touch tools | toggle | D | `touchTools` → `touchTools` | | toggle | |
 | 21 | Windows & chrome | Allow undocking (touch) | toggle | D | `mobileUndockAllowed` → `mobileUndockAllowed` | Allow undocking on touch screens | toggle | |
+| 21b | Lists & menus | **NEW** (41b H14) | — | D | `projectActions` → `ui:projectActions` (absent = Auto) | Project actions | segmented Auto / Compact / List | badge *This device*. The burger menu's PROJECT section: Compact = a two-column grid (New from template… / Load · Save ▾ / Import · Export…), List = the 1.32 rows; Auto = List on the phone shell, Compact elsewhere. Keywords: burger, main menu, compact grid. |
 | 22 | Lists & menus | Advanced mode | check | D | `advancedMode` → `advancedMode` | Show system objects in the object list | **toggle** | old label kept as a keyword |
 | 23 | Lists & menus | Environment in list | check | D | `showEnvInList` → `showEnvInList` | Show the environment in the object list | **toggle** | |
 | 24 | Lists & menus | Object search in menu | check | D | `objectSearchEnabled` → `objectSearchEnabled` | Object search in the right-click menu | **toggle** | |
@@ -406,7 +407,7 @@ behind a store's back.
 
 | Category | Keys (localStorage, via safeStorage) |
 |---|---|
-| Interface | `allowTextSelection` `avatars:peersClassic` `theme` `customThemes`* `game:soundVolume` `game:musicVolume` `showWelcomeOnStart` `showWhatsNewNotice` `toastsInDrawerOnly` `toursAutoStart` `xrOfferSession` `showRoomsButton` `floatingToolbar` `toolbarOnTop` `touchTools` `mobileUndockAllowed` `advancedMode` `showEnvInList` `objectSearchEnabled` `perfStats:show` `perfReports:send` `viewPrefs.dockPushesViewport` `ui:density` (NEW) |
+| Interface | `allowTextSelection` `avatars:peersClassic` `theme` `customThemes`* `game:soundVolume` `game:musicVolume` `showWelcomeOnStart` `showWhatsNewNotice` `toastsInDrawerOnly` `toursAutoStart` `xrOfferSession` `showRoomsButton` `floatingToolbar` `toolbarOnTop` `touchTools` `mobileUndockAllowed` `advancedMode` `showEnvInList` `objectSearchEnabled` `perfStats:show` `perfReports:send` `viewPrefs.dockPushesViewport` `ui:density` (NEW) `ui:projectActions` (NEW, 41b) |
 | Controls | `enableShiftAdd` `helpersInPlay` `noteDoubleClickToOpen` `trackpadMode` `trackpadPanEnabled` `trackpadReversePan` `trackpadPinchZoom` `allowBrowserZoom` |
 | Input | `gamepadPrefs` `flow:mouseBindings` `flow:opens` |
 | Touch controls | `touchControlsPrefs` `touchLookSpeed` `touchControlsTextures` `touchControlsLayouts` |

package.json

@@ -24,7 +24,8 @@
 		"sync-llms": "node scripts/sync-llms.cjs",
 		"test:unit": "vitest run",
 		"check:storage": "node scripts/check-storage.cjs",
-		"check:tokens": "node scripts/check-tokens.cjs"
+		"check:tokens": "node scripts/check-tokens.cjs",
+		"check:zindex": "node scripts/check-zindex.cjs"
 	},
 	"devDependencies": {
 		"@sveltejs/adapter-static": "^3.0.10",