@umicat/three-sdk 0.8.3 → 0.8.5

package/dist/Input3D.d.ts

@@ -55,6 +55,17 @@ export interface Input3DOptions {
     /** Radians of camera rotation per screen-width dragged. Same number governs
      *  touch drags and desktop right-drags, so there is one knob to turn. */
     lookSensitivity?: number;
+    /**
+     * How much of the top of the screen the move and look zones leave alone.
+     *
+     * A HUD lives at the top — score, hearts, a mute button — and the zones are
+     * full-screen and sit ABOVE the game's DOM, so without this every button up
+     * there is unreachable on a phone while looking perfectly fine. Nobody
+     * drives a thumbstick from the top edge, so the trade is free.
+     *
+     * A CSS length; the default is `max(64px, 12%)`.
+     */
+    controlsTopInset?: string;
 }
 /**
  * Movement and jump, from a keyboard or a thumb, behind one interface.
@@ -82,6 +93,7 @@ export declare class Input3D {
     private actions;
     private stickMode;
     private wantLook;
+    private topInset;
     private lookSens;
     private readonly lookDelta;
     private enabled;

package/dist/Input3D.js

@@ -69,6 +69,7 @@ export class Input3D {
         this.actions = [];
         this.stickMode = 'floating';
         this.wantLook = true;
+        this.topInset = 'max(64px, 12%)';
         this.lookSens = 4.6;
         this.lookDelta = { x: 0, y: 0 };
         this.enabled = true;
@@ -88,6 +89,7 @@ export class Input3D {
         this.actions = opts.actions ?? [];
         this.stickMode = opts.stick ?? 'floating';
         this.wantLook = opts.look ?? true;
+        this.topInset = opts.controlsTopInset ?? 'max(64px, 12%)';
         this.lookSens = opts.lookSensitivity ?? 4.6;
         if (this.wantLook && typeof document !== 'undefined') {
             this.mountMouseLook(opts.container?.ownerDocument ?? document);
@@ -314,7 +316,7 @@ export class Input3D {
         // anything. It deliberately stops short of the buttons on the right.
         const zone = document.createElement('div');
         Object.assign(zone.style, {
-            position: 'absolute', left: '0', top: '0', width: '50%', height: '100%',
+            position: 'absolute', left: '0', top: this.topInset, width: '50%', bottom: '0',
             pointerEvents: floating ? 'auto' : 'none',
         });
         Object.assign(zone.style, NO_SELECTION);
@@ -323,7 +325,7 @@ export class Input3D {
         // can be the whole right half rather than an awkward cut-out around them.
         const lookZone = document.createElement('div');
         Object.assign(lookZone.style, {
-            position: 'absolute', right: '0', top: '0', width: '50%', height: '100%',
+            position: 'absolute', right: '0', top: this.topInset, width: '50%', bottom: '0',
             pointerEvents: this.wantLook ? 'auto' : 'none',
         });
         Object.assign(lookZone.style, NO_SELECTION);

package/dist/SceneLoader3D.js

@@ -132,7 +132,7 @@ export async function loadScene3D(scene3d, manifest, opts = {}) {
                 const mesh = o;
                 if (!mesh.isMesh)
                     return;
-                mesh.castShadow = true;
+                mesh.castShadow = e.castShadow !== false;
                 mesh.receiveShadow = true;
                 // A SkinnedMesh's bounding sphere is computed from the BIND pose and
                 // does not follow the bones. Once the object moves, three.js culls it
@@ -242,7 +242,14 @@ export async function loadScene3D(scene3d, manifest, opts = {}) {
                 // would otherwise be lit from the side of a box centred somewhere else.
                 d.target.position.copy(centre);
                 scene.add(d.target);
-                d.shadow.mapSize.set(2048, 2048);
+                // Sized for the DEVICE, not for the desktop it was written on. A
+                // 2048 map is four megapixels of extra render target every frame, and
+                // a phone is already drawing at 2x for its screen — that combination
+                // took a board from smooth on a laptop to visibly dropping frames on
+                // an iPhone while looking identical in a screenshot.
+                const dense = typeof window !== 'undefined' && (window.devicePixelRatio ?? 1) > 2;
+                const map = dense ? 512 : 1024;
+                d.shadow.mapSize.set(map, map);
                 d.shadow.bias = -0.0012;
             }
         }

package/dist/scene3d.d.ts

@@ -83,6 +83,15 @@ export interface Entity3D {
     /** Free-form, read by game code. The 2D SDK's `properties` equivalent. */
     properties?: Record<string, unknown>;
     visible?: boolean;
+    /**
+     * Whether this entity casts a shadow. Defaults to true.
+     *
+     * Set it false for ground: a flat tile casting onto the flat tile beside it
+     * produces nothing anyone can see and costs a full extra draw of that mesh
+     * every frame. A board made of 144 tiles was drawing 288 times for 144
+     * tiles' worth of picture.
+     */
+    castShadow?: boolean;
 }
 /**
  * Semantic clip name → the clip actually inside the model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/three-sdk",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "Three.js runtime for Umicat games: the scene3d design format, its loader with physics, a kinematic character controller, and the Umicat platform via @umicat/platform-sdk.",
   "type": "module",
   "main": "dist/index.js",