@jgengine/shell 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -11,6 +11,22 @@ Agents building on the published SDK can also read this programmatically:
 same data as typed values, so an updater can diff its installed version against
 the latest and surface the migration steps.
 
+## Unreleased
+
+## 0.9.0
+
+### Added
+
+- Mobile HUD fit — design-resolution UI scaling now applies to every game by default: `HudCanvas` measures the live viewport and scales the whole HUD from `PlayableGame.hudFit.designSize` (default 1600×900, clamps `minScale`/`maxScale` 0.4–1) so desktop-authored layouts shrink to fit a phone instead of overflowing it; `hudFit.mobile` overrides tune the phone fit separately. Pure math lives in `@jgengine/core/ui/hudScale` (`hudScaleForViewport`, `resolveHudFit`, `rectOverflow`, `overflowingPanels`); the shell mounts `@jgengine/react`'s `HudViewportProvider` around `GameUI` so games need no wiring.
+- Graphics → UI scale — a player-facing `graphics.uiScale` slider (0.5–1.5, default 1) multiplies the computed HUD scale on every platform; the same resolution system drives desktop preference and mobile shrink.
+- HUD overflow gate — `HudCanvas` measures every `HudPanel` against the viewport at runtime and reports offenders on a `data-hud-overflow` attribute (plus a console warning); `bun run shoot <game> --device mobile|both` now exits non-zero naming the panels that escape the viewport.
+- Automatic visibility & streaming defaults — an engine-level `VisibilitySystem` (exported from `@jgengine/core`) gives every scene renderer-agnostic culling and asset-streaming policy with no per-object wiring: distance culling, preload margins, hysteresis, delayed unloading, multi-camera awareness (including cameras excluded from streaming), and per-object overrides (always-visible, never-unload, disabled culling/streaming, custom render distance and preload margin).
+- Self-hosted asset mirror — `DEFAULT_RELEASE_BASE` now points at this repo's rolling `packs` release instead of the upstream host; a catalog-driven `mirror-assets` workflow (weekly cron + manual dispatch) keeps the mirror in sync with the asset catalog.
+
+### Changed
+
+- Mobile HUD fit is on by default — design-resolution HUD scaling now applies to every game with no config change (previously opt-in via `platforms: ["web", "mobile"]`). A desktop-only game keeps the legacy fixed 0.85 compact zoom by declaring `platforms: ["web"]` (without `"mobile"`).
+
 ## 0.8.0
 
 Transport-agnostic multiplayer (socket.io, WebRTC p2p, LAN/Fly adapters) plus grid/voxel

package/README.md

@@ -49,6 +49,17 @@ import { generateBuilding } from "@jgengine/core/world/buildings";
 <GeneratedBuilding building={generateBuilding({ seed: "block-a", floors: 6 })} />;
 ```
 
+Building parts are batched into one `InstancedMesh` per part kind, so a whole building costs about a dozen draw calls regardless of part count. `InstancedBuildings` batches many buildings together the same way — a full district in one pass — and is what `EnvironmentScene` uses for `building()` world features:
+
+```tsx
+import { InstancedBuildings } from "@jgengine/shell/structures/GeneratedBuilding";
+import { generateBuildingDistrict } from "@jgengine/core/world/buildings";
+
+const district = generateBuildingDistrict({ rows: 3, cols: 3, seed: "downtown" });
+
+<InstancedBuildings buildings={district.map((building) => ({ building }))} />;
+```
+
 The component vocabulary (windows, awnings, AC units, clotheslines, storefronts, shutters, store signs, roof props, guardrails) and placement logic follow achrefelouafi's MIT [BuildingGeneratorThreeJS](https://github.com/achrefelouafi/BuildingGeneratorThreeJS) (see [CREDITS.md](../../CREDITS.md)).
 
 ## Terrain primitives

package/dist/GamePlayerShell.d.ts

@@ -3,7 +3,7 @@ import type { Aim } from "@jgengine/core/scene/spatial";
 import { type CollisionObstacle, type MovementTuningOverrides } from "@jgengine/core/movement/movementModel";
 import type { PhysicsConfig } from "@jgengine/core/game/defineGame";
 import { type GameContext } from "@jgengine/core/runtime/gameContext";
-import type { MotionIntentBatch } from "@jgengine/core/runtime/motionIntents";
+import { type MotionIntentBatch } from "@jgengine/core/runtime/motionIntents";
 import type { SkyEnvironmentDescriptor, WorldFeature } from "@jgengine/core/world/features";
 import { type SceneObject } from "@jgengine/core/scene/objectStore";
 import type { ShellMultiplayer } from "./multiplayer.js";
@@ -32,7 +32,10 @@ export declare function resolveWorldSky(world: WorldFeature | undefined): SkyEnv
 export declare function resolvePhysicsTuning(physics: PhysicsConfig | undefined): MovementTuningOverrides | undefined;
 /** True when the world is an environment feature with terrain, so the voxel controller should sample its height. */
 export declare function hasEnvironmentTerrain(world: WorldFeature | undefined): boolean;
-export declare function GamePlayerShell({ playable, multiplayer: rawMultiplayer, }: {
+export declare function GamePlayerShell({ playable, multiplayer: rawMultiplayer, poster, onContextReady, }: {
     playable: PlayableGame;
     multiplayer?: ShellMultiplayer | null;
+    poster?: boolean;
+    /** Called once per boot after onInit/onNewPlayer with the live GameContext — a staging seam for screenshots, tests, analytics. */
+    onContextReady?: (ctx: GameContext) => void;
 }): import("react").JSX.Element;