@jgengine/convex 0.46.0 → 0.47.0

package/CHANGELOG.md

@@ -26,6 +26,123 @@ At publish, rename this heading to the new version and mirror the entries into
 `packages/core/src/meta/changelog.ts` (the typed `CHANGELOG` export).
 -->
 
+## 0.47.0
+
+### Migrate
+
+- **Bump lockstep SDK packages to `^0.47.0`:** `@jgengine/{core,rapier,react,ws,node,sql,convex,shell,editor,assets,navbake}`. CLI `jgengine` is `0.44.0`; `@jgengine/github` is `0.34.0`.
+- `resolveScatter` returns `readonly ScatterInstance[]` (results are shared through a per-document cache). Copy before mutating.
+- `--jg-hud-dock-clearance`, `--jg-hud-dock-clearance-left|center|right`, `touchDockInsets`, `touchDockClearance`, `TouchDockInsets` and `floatingJoystickZoneHeight` are gone. A game with its own touch controls registers each one with `useRegisterLayoutRegion({ id, kind: "control", collisionPolicy: "forbid" }, ref)` (`@jgengine/core/ui/viewport.view`) instead of setting the CSS variables.
+- `@jgengine/core/game/ping` → `@jgengine/core/map/ping`
+- `@jgengine/shell/postfx/PostProcessing` → `@jgengine/core/postfx/PostProcessing.draw`
+- `@jgengine/shell/postfx/ScreenEffectsOverlay` → `@jgengine/core/postfx/ScreenEffectsOverlay.draw`
+- `@jgengine/shell/postfx/atmospherePass` → `@jgengine/core/postfx/atmospherePass.draw`
+- `@jgengine/shell/postfx/autoExposure` → `@jgengine/core/postfx/autoExposure.draw`
+- `@jgengine/shell/postfx/contactShadowPass` → `@jgengine/core/postfx/contactShadowPass.draw`
+- `@jgengine/shell/postfx/gradeShader` → `@jgengine/core/postfx/gradeShader.draw`
+- `@jgengine/shell/postfx/postfxOverlay` → `@jgengine/core/postfx/postfxOverlay.draw`
+- `@jgengine/shell/postfx/postfxTierPolicy` → `@jgengine/core/postfx/postfxTierPolicy`
+- `@jgengine/shell/postfx/shadowPrepass` → `@jgengine/core/postfx/shadowPrepass.draw`
+- `@jgengine/shell/postfx/stylizePass` → `@jgengine/core/postfx/stylizePass.draw`
+- `@jgengine/shell/postfx/temporalAaPass` → `@jgengine/core/postfx/temporalAaPass.draw`
+- `@jgengine/shell/vfx/ParticleEmitters` → `@jgengine/core/vfx/ParticleEmitters.draw`
+- `@jgengine/shell/vfx/ParticleField` → `@jgengine/core/vfx/ParticleField.draw`
+- `@jgengine/shell/vfx/RetainedVfx` → `@jgengine/core/vfx/RetainedVfx.draw`
+- `@jgengine/shell/vfx/SpellVfx` → `@jgengine/core/vfx/SpellVfx.draw`
+- `@jgengine/shell/vfx/WorldFloatingText` → `@jgengine/core/hud/floatingTextWorld.draw`
+- `@jgengine/shell/visibility/CullingProvider` → `@jgengine/core/visibility/CullingProvider.draw`
+- `@jgengine/shell/visibility/cullingDriver` → `@jgengine/core/visibility/cullingDriver`
+- `@jgengine/shell/visibility/renderBounds` → `@jgengine/core/visibility/measuredBounds`
+- `@jgengine/shell/vision/RevealVision` → `@jgengine/core/sensor/RevealVision.draw`
+- `@jgengine/shell/vision/frustumSampleEqual` → `@jgengine/core/sensor/frustumSampleEqual`
+- `@jgengine/shell/world/ImpactFeedback` → `@jgengine/core/combat/ImpactFeedback.draw`
+- `@jgengine/shell/world/ShotFeedback` → `@jgengine/core/combat/ShotFeedback.draw`
+- `@jgengine/shell/world/WorldPings` → `@jgengine/core/map/pingBeacons.draw`
+- `@jgengine/shell/world/floatTextStyle` → `@jgengine/core/hud/floatTextStyle`
+- `@jgengine/shell/world/pingPulse` → `@jgengine/core/map/pingPulse`
+- `@jgengine/shell/world/telegraphPulse` → `@jgengine/core/combat/telegraphPulse`
+- `@jgengine/shell/camera` → import each name from its file: `cameraShake`/`defaultCameraShake` from `@jgengine/core/camera/shake/cameraShake`, rigs from `@jgengine/core/camera/<Rig>.draw`, math from `@jgengine/core/camera/<file>`
+- `CameraBlendScratch` and the blend helpers come only from `@jgengine/core/camera/cameraBlendMath.draw` (no longer re-exported by `cameraRigs.draw`)
+- `fovPreference` is now `@jgengine/core/camera/fovPreference.view` (it reads `Storage`)
+- `@jgengine/shell/camera/GameCameraRig` → `@jgengine/core/camera/GameCameraRig.draw`
+- `@jgengine/shell/camera/GameFirstPersonCamera` → `@jgengine/core/camera/GameFirstPersonCamera.draw`
+- `@jgengine/shell/camera/GameInspectionCamera` → `@jgengine/core/camera/GameInspectionCamera.draw`
+- `@jgengine/shell/camera/GameOrbitCamera` → `@jgengine/core/camera/GameOrbitCamera.draw`
+- `@jgengine/shell/camera/PlayerFov` → `@jgengine/core/camera/PlayerFov.draw`
+- `@jgengine/shell/camera/Viewports` → `@jgengine/core/camera/Viewports.draw`
+- `@jgengine/shell/camera/aimRecoil` → `@jgengine/core/camera/aimRecoil`
+- `@jgengine/shell/camera/cameraBlendMath` → `@jgengine/core/camera/cameraBlendMath.draw`
+- `@jgengine/shell/camera/cameraCollision` → `@jgengine/core/camera/cameraCollision`
+- `@jgengine/shell/camera/cameraRigs` → `@jgengine/core/camera/cameraRigs.draw`
+- `@jgengine/shell/camera/chaseHeading` → `@jgengine/core/camera/chaseHeading`
+- `@jgengine/shell/camera/customMuzzle` → `@jgengine/core/camera/customMuzzle.draw`
+- `@jgengine/shell/camera/fovPreference` → `@jgengine/core/camera/fovPreference.view`
+- `@jgengine/shell/camera/inspectionCameraMath` → `@jgengine/core/camera/inspectionCameraMath`
+- `@jgengine/shell/camera/orbitCameraMath` → `@jgengine/core/camera/orbitCameraMath`
+- `@jgengine/shell/camera/rigMath` → `@jgengine/core/camera/rigMath`
+- `@jgengine/shell/camera/rigResolve` → `@jgengine/core/camera/rigResolve`
+- `@jgengine/core/render/environment` → `@jgengine/core/lighting/environmentLighting`
+- `@jgengine/core/render/lightProbes` → `@jgengine/core/lighting/lightProbes`
+- `@jgengine/core/render/lightingBalance` → `@jgengine/core/lighting/lightingBalance`
+- `@jgengine/core/world/buildPermissions` → `@jgengine/core/placement/buildPermissions`
+- `@jgengine/core/world/buildSockets` → `@jgengine/core/placement/buildSockets`
+- `@jgengine/shell/materialOverride` → `@jgengine/core/material/materialOverride.draw`
+- `@jgengine/shell/render/CascadedShadows` → `@jgengine/core/lighting/CascadedShadows.draw`
+- `@jgengine/shell/render/EnvironmentLighting` → `@jgengine/core/lighting/EnvironmentLighting.draw`
+- `@jgengine/shell/render/HairCards` → `@jgengine/core/material/hairCards.draw`
+- `@jgengine/shell/render/IrradianceVolumeLighting` → `@jgengine/core/lighting/IrradianceVolumeLighting.draw`
+- `@jgengine/shell/render/SceneLighting` → `@jgengine/core/lighting/SceneLighting.draw`
+- `@jgengine/shell/render/TextureFiltering` → `@jgengine/core/material/TextureFiltering.draw`
+- `@jgengine/shell/render/authoredSurfaceMaterial` → `@jgengine/core/material/authoredSurfaceMaterial.draw`
+- `@jgengine/shell/render/decalGeometry` → `@jgengine/core/scene/decalGeometry.draw`
+- `@jgengine/shell/render/decalTexture` → `@jgengine/core/scene/decalTexture`
+- `@jgengine/shell/render/defaultSurface` → `@jgengine/core/material/defaultSurface.draw`
+- `@jgengine/shell/render/imageTexture` → `@jgengine/core/material/imageTexture.draw`
+- `@jgengine/shell/render/materialAppearanceSignals` → `@jgengine/core/material/appearanceSignals.draw`
+- `@jgengine/shell/render/materialAsset` → `@jgengine/core/material/materialAsset.draw`
+- `@jgengine/shell/render/pmremLink` → `@jgengine/core/lighting/pmremLink.draw`
+- `@jgengine/shell/render/shadowCasters` → `@jgengine/core/lighting/shadowCasters.draw`
+- `@jgengine/shell/render/shadowTiers` → `@jgengine/core/lighting/shadowTiers`
+- `@jgengine/shell/render/stableTextureSet` → `@jgengine/core/material/stableTextureSet.draw`
+- `@jgengine/shell/render/surfaceScanShader` → `@jgengine/core/material/surfaceScanShader.draw`
+- `@jgengine/shell/render/surfaceScanTextures` → `@jgengine/core/material/surfaceScanTextures.draw`
+- `@jgengine/shell/render/triplanarMaterial` → `@jgengine/core/material/triplanarMaterial.draw`
+- `@jgengine/shell/render/wetSurfaces` → `@jgengine/core/material/wetSurfaces.draw`
+- `@jgengine/shell/render/worldReflectionProbe` → `@jgengine/core/lighting/reflectionProbe.draw`
+
+### Added
+
+- `createVitals` (`@jgengine/core/survival/vitals`): named survival pools with drain, delayed regen that can cost another pool, empty-pool links (starvation hurts health, raises torpor) and hysteresis flags; snapshot/restore.
+- `ambientTemperature` and `bodyComfort` (`@jgengine/core/survival/bodyTemperature`): air temperature from climate, time of day, weather, altitude, wetness and heat sources; hypothermia/hyperthermia as drain multipliers and exposure damage, with insulation and fortitude.
+- `createScatterHarvest` (`@jgengine/core/harvest/scatterHarvest`): any scatter placement becomes a gatherable node (tool bias, budgets, respawn) found by a cone strike; spent nodes disappear from the drawn scatter and regrow.
+- `createScatterClearing` / `scatterClearingOf` (`@jgengine/core/scatter/scatterClearing`) and `InstancedScatter`'s `hidden` prop: hide felled or mined placements; `AuthoredScene` reads it.
+- `ResourceNodeConfig.resolve`: nodes created lazily on first touch, so an island of trees costs nothing until one is hit.
+- `terrain({ coast })` / `withCoast`: shape any terrain into an island with a beach shelf and sea floor.
+- `InstancedScatter` `maxChunks` (default 400): big fields grow their chunks instead of splitting into tens of thousands of scene objects.
+
+### Changed
+
+- The output is `<staging>/<Name>.exe` (runs without installing) plus `<staging>/<Name>_<version>_x64-setup.exe`.
+- Every game shares one cargo target directory (`CARGO_TARGET_DIR`, default `%LOCALAPPDATA%/jgengine/desktop-target`), and Tauri's build-time asset compression is off, so only the first build compiles Tauri and later games compile only their own small crate.
+- `apps/web/public/og.png` (1200x630) and `apps/web/public/apple-touch-icon.png` (180x180) are redrawn in the site's dark theme with the orange accent, replacing the old lime cards.
+
+Prevention: none - the change is two redrawn PNG images with no code path a test could exercise
+
+### Fixed
+
+- `jgengine desktop` no longer fails after compiling Rust: it generates `icon.ico` and every PNG size Tauri needs from the game's `public/icon.png`, `icon.png`, `public/cover.png` or `cover.png` (centre-cropped), or from the jgengine mark when the game has none. `--icon` takes any PNG; an unreadable one is an error, an unreadable project icon falls back to the mark with a warning.
+- The desktop window's content policy allows WebAssembly (`'wasm-unsafe-eval'`) and `data:`/`blob:` fetches, so games that load physics, decoders or embedded model data no longer hang on "Preparing scene".
+- An island-sized scatter field ran at ~9 fps: every 24 m chunk was a scene object per species and draw source, small detail drew at any distance, and the impostor split searched batches quadratically. Chunks are now budgeted, sub-impostor species cull past a size-scaled distance, and only chunks whose placements crossed a switch distance re-upload (59 fps on Fernwild's island).
+- Clearing one placement rebuilt every scatter mesh; untouched chunks now keep their meshes.
+- `HudCanvas` keeps panels clear of the measured rectangle of every region registered as kind `control` or `system`, instead of a guessed height over each bottom third of the screen. Harbor Heat's minimap, Scrap Signal's loot and vitals, Apex Nights' garage and Hold the Line's bottom bar no longer sit under touch buttons.
+- Touch buttons a game pins to an anchor (`touch.buttons` with `anchor`) register as control regions, so the HUD and the collision check see them.
+- `arrangeHudPanels` shrinks the HUD before lifting a panel off its edge into the play view: a bottom bar squeezed between the joystick and the action cluster (Fernwild's build bar) stays on the bottom edge at a smaller zoom, and lifts only when no zoom down to `minScale` keeps it there.
+- Drift Foundry registers its steering and pedal pads as control regions; Apex Nights' garage panel grows to fit its price tags instead of spilling onto the action buttons.
+
+### Bends
+
+- Deleted the three `touchDockInsets` unit tests along with the function they tested; the new "touch controls are obstacles" browser test and the solver tests cover the behaviour that replaced it.
+
 ## 0.46.0
 
 ### Migrate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jgengine/convex",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "description": "Convex adapters for JGengine: game transport, presence transport, and backend wiring over @jgengine/core.",
   "license": "Apache-2.0",
   "type": "module",
@@ -30,7 +30,7 @@
     "check-types": "tsgo --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@jgengine/core": "^0.46.0"
+    "@jgengine/core": "^0.47.0"
   },
   "peerDependencies": {
     "convex": "^1.31.2",

package/skills/jgengine/api.md

@@ -6,7 +6,7 @@
 
 - `CHANGELOG` (const): const CHANGELOG: Record<string, ChangelogEntry> — Per-version engine changelog keyed by semver string (e.g. `"0.10.0"`).
 - `ChangelogEntry` (interface): interface ChangelogEntry — One release's migrate steps plus added/changed/removed notes (typed mirror of CHANGELOG.md).
-- `VERSION` (const): const VERSION: "0.46.0" — Installed `@jgengine/core` semver - compare against {@link CHANGELOG} keys when migrating.
+- `VERSION` (const): const VERSION: "0.47.0" — Installed `@jgengine/core` semver - compare against {@link CHANGELOG} keys when migrating.
 
 ## @jgengine/core/authoring
 
@@ -420,7 +420,7 @@
 
 - `CHANGELOG` (const): const CHANGELOG: Record<string, ChangelogEntry> — Per-version engine changelog keyed by semver string (e.g. `"0.10.0"`).
 - `ChangelogEntry` (interface): interface ChangelogEntry — One release's migrate steps plus added/changed/removed notes (typed mirror of CHANGELOG.md).
-- `VERSION` (const): const VERSION: "0.46.0" — Installed `@jgengine/core` semver - compare against {@link CHANGELOG} keys when migrating.
+- `VERSION` (const): const VERSION: "0.47.0" — Installed `@jgengine/core` semver - compare against {@link CHANGELOG} keys when migrating.
 
 ## @jgengine/core/runtime/adapter
 
@@ -810,7 +810,7 @@
 - `GameHostProps` (interface): interface GameHostProps — Props for {@link GameHost}: the playable, optional multiplayer overrides, and the optional editor loader that enables the engine-owned F2+E summon.
 - `GameLoop` (interface): interface GameLoop<TContext = unknown> — Lifecycle hooks a game implements to drive init, per-tick simulation, and player join/leave.
 - `Hotbar` (function): function Hotbar({ inventoryId, activeSlot, keys, slotSize = 46, itemIcon, style, className, }: { inventoryId: string; activeSlot?: number; keys?: readonly string[]; slotSize?: number; /** Caller-supplied item id → icon registry; return null/undefined to fall back to the default glyph. */ itemIcon?: … — A numbered hotbar bound to an inventory — painted iconed slots (a `GameIcon` glyph over a school-keyed gradient with a count badge, #1035), an active-slot highlight, and a keycap per slot. Place it and pass the `inventoryId`; `activeSlot` highlights the equipped one. Supply `itemIcon` to map your item ids to your own glyphs — the default resolves a `GameIcon` from the item id.
-- `HudCanvas` (function): function HudCanvas({ layout, editChord, showDuring, className, style, children, }: { layout: HudLayoutStore; editChord?: HudEditChord | false; /** Opt-in play-phase gate: render the HUD only during these phases (e.g. `["playing"]`). Omit for always-visible (default). */ showDuring?: readonly GamePha… — Full-viewport HUD surface. Each `HudPanel` names an anchor and a priority; the canvas measures every panel and places them all at once so none lands on another, at any screen size. Panels sharing an anchor stack outward from that edge; a panel that would cover a neighbour slides along its edge to the nearest free spot; when the screen is too small, the lowest-priority panels fold into a toggle, and only then does the whole HUD shrink. Device safe areas and the touch-control dock (`--jg-hud-dock-clearance-*`) are kept clear. Games declare panels, never place them per size.
+- `HudCanvas` (function): function HudCanvas({ layout, editChord, showDuring, className, style, children, }: { layout: HudLayoutStore; editChord?: HudEditChord | false; /** Opt-in play-phase gate: render the HUD only during these phases (e.g. `["playing"]`). Omit for always-visible (default). */ showDuring?: readonly GamePha… — Full-viewport HUD surface. Each `HudPanel` names an anchor and a priority; the canvas measures every panel and places them all at once so none lands on another, at any screen size. Panels sharing an anchor stack outward from that edge; a panel that would cover a neighbour slides along its edge to the nearest free spot; when the screen is too small, the lowest-priority panels fold into a toggle, and only then does the whole HUD shrink. Device safe areas and every touch control (any region registered as kind `control` or `system`) are kept clear. Games declare panels, never place them per size.
 - `HudFade` (function): function HudFade({ watch, idleMs = 3500, dimTo = 0.18, hold = false, children, className, style }: HudFadeProps): ReactNode — A HUD group that steps back when nothing is happening: it fades after a quiet spell and comes back the moment a watched value changes, so the world fills the screen and the HUD speaks only when it has news. Hovering it also brings it back.
 - `HudPanel` (function): function HudPanel({ id, anchor = "top-left", order, chip, interactive, inset, locked, showDuring, priority, mobileBehavior, allowOverlapWith, collisionGroup, region = true, width, height, type, className, style, children, }: { id: string; anchor?: HudAnchor; /** Stack position within the anchor, asc… — A HUD block anchored to a corner, edge or the centre. `HudCanvas` places every panel together: panels sharing an anchor stack outward from the screen edge in ascending `order`, and a panel that would cover another slides to the nearest free spot. When the screen is too small, lower-`priority` panels fold into a toggle first. On fine pointers panels stay draggable through the edit chord; a dragged panel leaves the flow and keeps its custom placement.
 - `HudSlots` (function): function HudSlots({ storageKey, slots, overlay, showDuring = DEFAULT_SLOT_PHASES }: HudSlotsProps): ReactNode — The play HUD in one line: a few small panels pinned to the screen's edges, scaled from a 1600x900 design to any window and movable by the player (the layout is remembered per `storageKey`). Keep it to a handful of slots; the world is the picture.