dewdrop-sdk 0.5.4 → 0.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dewdrop-sdk",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Build a three.js game for Dewdrop: the Vite plugin, model calls, multiplayer, saves and voice.",
   "license": "MIT",
   "type": "module",

package/src/index.js

@@ -5,8 +5,9 @@
 // runs, `clients`, in that backend, over its port back, and `saves` into
 // the browser's own storage, which the plugin's script empties as each
 // page loads; `session` says when a session ends ahead of time, which here
-// none does, and lets a game end its player's session, which here ends
-// nothing; and `voice` reads the microphone through the browser's own
+// none does, lets a game end its player's session, which here ends
+// nothing, and lets a game allow portrait views, which here the browser's
+// window already gives; and `voice` reads the microphone through the browser's own
 // audio worklet, into the chunks a game gets on Dewdrop.
 export { llm } from './llm.js';
 export { backend } from './backend.js';

package/src/session.js

@@ -12,12 +12,21 @@
 // `session.exit()`, which on Dewdrop takes the player back to Dewdrop's
 // home page while the room's other players play on, the game hearing
 // `'exit'` as it goes; a backend has no player to send anywhere, so there it
-// throws NotSupportedError. `npm run dev` ends no session, so here `ending`
-// stays null and the event never fires, a game trying its handler by
-// calling it, and `exit()` ends nothing: the console says so, once.
+// throws NotSupportedError. A game that lays itself out for either shape
+// calls `session.allowPortrait()`, after which Dewdrop turns its view
+// portrait whenever its player's page asks — a phone held upright — and the
+// game hears each turn as a `resize`, its window taking the view's new
+// shape; until then a session stays landscape, and a backend, which has no
+// view, throws NotSupportedError. `npm run dev` ends no session, so here
+// `ending` stays null and the event never fires, a game trying its handler
+// by calling it, and `exit()` ends nothing: the console says so, once. The
+// game here is the browser's own window, which already takes any shape and
+// fires its own `resize`, so `allowPortrait()` changes nothing and says
+// what it does on Dewdrop, once.
 import { defineHandlers, side } from './net.js';
 
 let told = false;
+let toldPortrait = false;
 class Session extends EventTarget {
   get ending() { return null; }
   exit() {
@@ -26,6 +35,12 @@ class Session extends EventTarget {
     told = true;
     console.info('[dewdrop] session.exit(): on Dewdrop this ends the session and takes the player back to Dewdrop’s home page; npm run dev keeps the game running');
   }
+  allowPortrait() {
+    if (side.backend) throw new DOMException('session.allowPortrait is unavailable in a backend', 'NotSupportedError');
+    if (toldPortrait) return;
+    toldPortrait = true;
+    console.info('[dewdrop] session.allowPortrait(): on Dewdrop the view turns portrait whenever the player’s page is taller than wide, each turn a resize; npm run dev’s window already takes any shape');
+  }
 }
 defineHandlers(Session.prototype, ['ending']);