homegames-client 0.1.2 → 0.2.1

package/notices/homepad-0.2.1.txt

@@ -0,0 +1,24 @@
+Homepad
+Source: https://github.com/homegamesio/homepad
+
+MIT License
+
+Copyright (c) 2026 Joseph Garcia and Homegames contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/notices/qrcode-generator-2.0.4.txt

@@ -0,0 +1,27 @@
+QR Code Generator for JavaScript
+Source: https://github.com/kazuhikoarase/qrcode-generator
+The distributed source header grants MIT; the npm package omits a standalone license file.
+
+MIT License
+
+Copyright (c) 2009 Kazuhiko Arase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The word QR Code is a registered trademark of DENSO WAVE INCORPORATED.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homegames-client",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Embeddable browser client for Homegames",
   "main": "src/index.js",
   "browser": "dist/homegames-client.js",
@@ -10,24 +10,30 @@
     "prepack": "npm run build"
   },
   "author": "Joseph Garcia",
-  "license": "GPL-3.0",
+  "license": "MIT",
   "dependencies": {
     "buffer": "^6.0.3",
-    "homegames-common": "1.7.2",
+    "homegames-common": "1.7.3",
     "homepad": "0.2.1",
     "qrcode-generator": "^2.0.4",
-    "squish-142": "npm:squishjs@1.4.2",
-    "squish-143": "npm:squishjs@1.4.3",
-    "squish-145": "npm:squishjs@1.4.5",
-    "squish-146": "npm:squishjs@1.4.6"
+    "squish-150": "npm:squishjs@1.5.0"
   },
   "devDependencies": {
     "webpack": "^5.65.0",
     "webpack-cli": "^4.3.1"
   },
+  "overrides": {
+    "homepad": "0.2.1",
+    "homegames-common": {
+      "ws": "7.5.13"
+    }
+  },
   "files": [
     "src",
     "dist",
-    "webpack.config.js"
+    "tools/license-notices-plugin.cjs",
+    "notices",
+    "webpack.config.js",
+    "THIRD_PARTY_NOTICES.md"
   ]
 }

package/src/game-loader.js

@@ -30,6 +30,7 @@ const loadGameClass = ({ files, entryPoint }) => {
     }
 
     const moduleCache = {};
+    const versions = new Set();
 
     const loadModule = (path) => {
         if (moduleCache[path]) return moduleCache[path].exports;
@@ -39,6 +40,8 @@ const loadGameClass = ({ files, entryPoint }) => {
         const requireShim = (request) => {
             const squishMatch = /^squish-(\d+)$/.exec(request);
             if (squishMatch) {
+                versions.add(squishMatch[1]);
+                if (versions.size > 1) throw new Error('Mixed Squish runtimes are unsupported');
                 const squishModule = squishMap[squishMatch[1]];
                 if (squishModule) return squishModule;
                 throw new Error('Unsupported Squish runtime: ' + request);
@@ -82,7 +85,13 @@ const loadGameClass = ({ files, entryPoint }) => {
         throw new Error('Entry point "' + entryPoint + '" not found in game source map');
     }
 
-    return loadModule(entry);
+    const GameClass = loadModule(entry);
+    if (versions.size) {
+        const { normalizeMetadata, bindRuntimeMetadata } = require('homegames-common/runtime-metadata');
+        const metadata = typeof GameClass.metadata === 'function' ? GameClass.metadata() : {};
+        bindRuntimeMetadata(GameClass, normalizeMetadata(metadata, { runtime: [...versions][0], legacy: true }));
+    }
+    return GameClass;
 };
 
 module.exports = { loadGameClass };

package/src/index.js

@@ -120,9 +120,15 @@ class HomegamesClient {
                 playerName: this.playerName,
                 gamepad: this.gamepadOptions, platform: opts.platform, saveStore: this.saveStore,
                 onSaveData: this.onSaveData, onError: this.onError, onReady: id => {
+                    const solo = this._localSession?.maxPlayers === 1;
+                    if (this._shareOptions) this._localChrome?.toolbar?.setAction('share', {
+                        label: solo ? 'Invite (solo)' : 'Invite', disabled: solo,
+                        title: solo ? 'This is a solo game. Use Share a copy to send it to a friend.' : 'Invite friends to play',
+                        run: () => this.showShare(),
+                    });
                     this.onReady(id);
-                    if (this._shareOptions?.autoStart) {
-                        this._getRtcHost().share().catch(err => this._localChrome?.setStatus?.(`Not available to join: ${err.message}. Use Share to retry.`));
+                    if (this._shareOptions?.autoStart && !solo) {
+                        this._getRtcHost().share().catch(err => this._localChrome?.setStatus?.(`Not available to join: ${err.message}. Use Invite to retry.`));
                     }
                 },
             }),

package/src/input.js

@@ -183,6 +183,13 @@ class InputHandler {
             // that would normally focus an embedded game. Treat this direct
             // gesture as input focus so the first tap can reach the game too.
             // Page-control touches return above; blur still releases input.
+            // preventDefault also suppresses native focus transfer. Move DOM
+            // focus into the canvas so a later keyboard press cannot activate
+            // the embedding toolbar's previously focused button.
+            if (typeof this.canvas.focus === 'function') {
+                if (this.canvas.tabIndex < 0) this.canvas.tabIndex = -1;
+                this.canvas.focus({ preventScroll: true });
+            }
             this._focused = true;
             this._touchActive = true;
             clearTimeout(this.clickStopper); this.clickStopper = null;
@@ -553,7 +560,7 @@ class InputHandler {
 
     // Whether the game's squish version uses the single-click contract
     // (onClick once per press, mousemove while held, mouseup on release).
-    // Modern version strings are three digits ('142', '144'); anything else
+    // Modern version strings are three digits ('150', '144'); anything else
     // ('0767' / '1000'-style) predates drag support entirely — both get the
     // legacy repeated-click behavior.
     _usesSingleClickContract() {
@@ -662,9 +669,9 @@ class InputHandler {
     _promptFileUpload(nodeId) {
         const inputEl = document.createElement('input');
         inputEl.type = 'file';
-        // The platform understands image, audio and video assets; the squished node
-        // carries no per-node accept info, so this is the global filter.
-        inputEl.accept = 'image/*,audio/*,video/*';
+        // Games also import portable creations such as level packs. The node
+        // has no per-input accept field; each game still validates the bytes.
+        inputEl.accept = 'image/*,audio/*,video/*,application/json,.json';
         inputEl.style.display = 'none';
         document.body.appendChild(inputEl);
         const cleanupInput = () => {

package/src/local-game-chrome.js

@@ -17,7 +17,7 @@ const createLocalChrome = (containerId, title, onHome, share = null, options = {
     let dialog;
     if (share) {
         dialog = require('./share-dialog')({ container: frame, ...share });
-        toolbar.setAction('share', { label: 'Share', run: () => dialog.show() });
+        toolbar.setAction('share', { label: 'Invite', run: () => dialog.show() });
         if (share.onVisibility) {
             let privateGame = share.private;
             const update = () => toolbar.setAction('privacy', { label: privateGame ? 'Make session public' : 'Make session private', run: async () => {

package/src/local-session.js

@@ -154,9 +154,12 @@ class LocalSession {
             return;
         }
 
-        // --- Resolve squish version from game metadata ---
-        const metadata = (typeof this.gameClass.metadata === 'function') ? this.gameClass.metadata() : {};
-        this.maxPlayers = Math.min(255, metadata.maxPlayers || 64);
+        // Loaders bind the statically resolved runtime; legacy class-only embeds
+        // retain their metadata/default compatibility path.
+        let metadata;
+        try { metadata = require('homegames-common/runtime-metadata').runtimeMetadata(this.gameClass); }
+        catch (error) { this.stop(); this.onError(error); return; }
+        this.maxPlayers = metadata.maxPlayers;
         this.pointerLockEnabled = metadata.pointerLock === true;
         const squishVersion = metadata.squishVersion || DEFAULT_VERSION;
         let squishModule = squishMap[squishVersion];
@@ -236,8 +239,7 @@ class LocalSession {
         });
         // --- Instantiate game + squisher ---
         try {
-            // Same option bag child_game_server passes; platform services are
-            // stubbed in local mode. addAsset and saveGame/saveData are real:
+            // Same option bag child_game_server passes. addAsset and saveGame/saveData are real:
             // uploads render locally and saves persist in browser storage.
             this.game = new this.gameClass({
                 createExport: this.userExportsStore.createExport,
@@ -249,7 +251,6 @@ class LocalSession {
                     && this.setCursor(playerId, cursor),
                 saveGame,
                 saveData,
-                services: {},
             });
             // The runtime owns ticking; Squish owns scene serialization.
             // Frameless: no custom layers, scale 1.

package/src/portable-project.js

@@ -14,6 +14,7 @@ module.exports = {
     create: files => project.createProject(files, options),
     importArchive: bytes => project.importArchive(bytes, options),
     exportArchive: project.exportArchive,
+    withGameId: project.withGameId,
     normalizePath: project.normalizePath,
     limits: project.LIMITS,
     buildIsolatedHtml: html.buildIsolatedHtml,

package/src/rtc-copy-protocol.js

@@ -64,7 +64,9 @@ class Receiver {
             if (msg.type !== 'copy-complete' || this.state !== 'receiving' || this.offset !== this.metadata.bytes) throw new Error('Incomplete game copy');
             this.state = 'validating';
             const bytes = this.bytes, metadata = this.metadata;
-            if (await digest(bytes) !== metadata.sha256) throw new Error('The game copy was damaged during transfer. Try again.');
+            const actualDigest = await digest(bytes);
+            if (this.state === 'closed') return;
+            if (actualDigest !== metadata.sha256) throw new Error('The game copy was damaged during transfer. Try again.');
             const project = await this.importArchive(bytes);
             if (project.revision !== metadata.revision || project.manifest.gameId !== metadata.gameId) throw new Error('The received game does not match the offered copy');
             if (this.state === 'closed') return;

package/src/rtc-session.js

@@ -112,6 +112,7 @@ class RtcHost {
         session.onStop = () => this.stop();
     }
     share() {
+        if (this.session.maxPlayers === 1) return Promise.reject(new Error('This is a solo game. Use Share a copy to send it to a friend.'));
         if (this.link) return Promise.resolve(this.link);
         if (this.pending) return this.pending;
         if (!this.session.game) return Promise.reject(new Error('The game is still loading'));

package/src/squish-map.js

@@ -4,12 +4,9 @@
 // dependency. Requires must stay static so webpack can bundle them.
 
 const squishMap = {
-    '142': require('./codecs/squish-142'),
-    '143': require('./codecs/squish-143'),
-    '145': require('./codecs/squish-145'),
-    '146': require('squish-146')
+    '150': require('squish-150')
 };
 
-const DEFAULT_VERSION = '142';
+const DEFAULT_VERSION = '150';
 
 module.exports = { squishMap, DEFAULT_VERSION };

package/tools/license-notices-plugin.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+// Discover notices from the modules webpack actually considered, including
+// concatenated modules. Embed full texts so a standalone HTML export does not
+// depend on a sidecar file that is only available on the original website.
+class LicenseNoticesPlugin {
+    apply(compiler) {
+        const { Compilation, sources } = compiler.webpack;
+        compiler.hooks.thisCompilation.tap('HomegamesLicenseNotices', compilation => {
+            compilation.hooks.processAssets.tap({ name: 'HomegamesLicenseNotices',
+                stage: Compilation.PROCESS_ASSETS_STAGE_REPORT }, () => {
+                const roots = new Set([path.resolve(__dirname, '..')]);
+                const visited = new Set();
+                const visit = module => {
+                    if (visited.has(module)) return;
+                    visited.add(module);
+                    if (module.resource) {
+                        let dir = path.dirname(module.resource.split('?')[0]);
+                        while (!fs.existsSync(path.join(dir, 'package.json'))) {
+                            const parent = path.dirname(dir);
+                            if (parent === dir) return;
+                            dir = parent;
+                        }
+                        roots.add(dir);
+                    }
+                    if (module.modules) for (const child of module.modules) visit(child);
+                };
+                for (const module of compilation.modules) visit(module);
+                const notices = [...roots].map(root => {
+                    const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+                    const files = fs.readdirSync(root).filter(name => /^(licen[cs]e|copying|notice)(\..*)?$/i.test(name)
+                        && fs.statSync(path.join(root, name)).isFile()).sort();
+                    const texts = files.map(name => fs.readFileSync(path.join(root, name), 'utf8').trim());
+                    if (!texts.length) {
+                        const supplied = path.resolve(__dirname, `../notices/${pkg.name}-${pkg.version}.txt`);
+                        if (!fs.existsSync(supplied)) throw new Error(`Missing license text for bundled ${pkg.name}@${pkg.version}`);
+                        texts.push(fs.readFileSync(supplied, 'utf8').trim());
+                    }
+                    return { key: `${pkg.name}@${pkg.version}`, text: `${pkg.name}@${pkg.version} (${pkg.license || 'see notice'})\n\n${[...new Set(texts)].join('\n\n')}` };
+                }).sort((a, b) => a.key.localeCompare(b.key));
+                const text = 'Homegames runtime license notices\n\n'
+                    + [...new Set(notices.map(item => item.text))].join('\n\n----------------------------------------\n\n') + '\n';
+                compilation.emitAsset('THIRD_PARTY_NOTICES.txt', new sources.RawSource(text));
+                for (const asset of compilation.getAssets()) {
+                    if (!asset.name.endsWith('.js')) continue;
+                    compilation.updateAsset(asset.name, new sources.ConcatSource(
+                        `/*! ${text.replace(/\*\//g, '* /')} */\n`, asset.source));
+                }
+            });
+        });
+    }
+}
+
+module.exports = LicenseNoticesPlugin;

package/webpack.config.js

@@ -1,5 +1,6 @@
 const path = require('path');
 const webpack = require('webpack');
+const LicenseNoticesPlugin = require('./tools/license-notices-plugin.cjs');
 
 module.exports = {
     entry: path.join(__dirname, 'src', 'index.js'),
@@ -24,6 +25,7 @@ module.exports = {
         }
     },
     plugins: [
+        new LicenseNoticesPlugin(),
         // The squish Squisher (used by LocalSession) builds asset bundles with
         // Buffer, which browsers don't have. Resolve the polyfill absolutely —
         // squish is file-linked from outside this package, so relative

package/src/codecs/squish-142.js

@@ -1,17 +0,0 @@
-// Versioned scene API; lifecycle and asset I/O belong to the current host.
-const codec = require('squish-142/src/squish');
-const { Squisher, Asset } = require('squish-146');
-module.exports = { ...codec, Asset,
-    Squisher: class extends Squisher { constructor(options) { super({...options, encodeNode:codec.squish, decodeNode:codec.unsquish}); } },
-    Game: require('squish-142/src/Game'),
-    ViewableGame: require('squish-142/src/ViewableGame'),
-    Colors: require('squish-142/src/Colors'),
-    Shapes: require('squish-142/src/Shapes'),
-    subtypes: require('squish-142/src/subtypes'),
-    ShapeUtils: require('squish-142/src/util/shapes'),
-    ViewUtils: require('squish-142/src/util/views'),
-    GeometryUtils: require('squish-142/src/util/geometry'),
-    Physics: require('squish-142/src/physics'),
-    ...require('squish-142/src/GameNode'),
-    TerrainGenerator: require('squish-142/src/terrain').terrainGenerator,
-};

package/src/codecs/squish-143.js

@@ -1,17 +0,0 @@
-// Versioned scene API; lifecycle and asset I/O belong to the current host.
-const codec = require('squish-143/src/squish');
-const { Squisher, Asset } = require('squish-146');
-module.exports = { ...codec, Asset,
-    Squisher: class extends Squisher { constructor(options) { super({...options, encodeNode:codec.squish, decodeNode:codec.unsquish}); } },
-    Game: require('squish-143/src/Game'),
-    ViewableGame: require('squish-143/src/ViewableGame'),
-    Colors: require('squish-143/src/Colors'),
-    Shapes: require('squish-143/src/Shapes'),
-    subtypes: require('squish-143/src/subtypes'),
-    ShapeUtils: require('squish-143/src/util/shapes'),
-    ViewUtils: require('squish-143/src/util/views'),
-    GeometryUtils: require('squish-143/src/util/geometry'),
-    Physics: require('squish-143/src/physics'),
-    ...require('squish-143/src/GameNode'),
-    TerrainGenerator: require('squish-143/src/terrain').terrainGenerator,
-};

package/src/codecs/squish-145.js

@@ -1,17 +0,0 @@
-// Versioned scene API; lifecycle and asset I/O belong to the current host.
-const codec = require('squish-145/src/squish');
-const { Squisher, Asset } = require('squish-146');
-module.exports = { ...codec, Asset,
-    Squisher: class extends Squisher { constructor(options) { super({...options, encodeNode:codec.squish, decodeNode:codec.unsquish}); } },
-    Game: require('squish-145/src/Game'),
-    ViewableGame: require('squish-145/src/ViewableGame'),
-    Colors: require('squish-145/src/Colors'),
-    Shapes: require('squish-145/src/Shapes'),
-    subtypes: require('squish-145/src/subtypes'),
-    ShapeUtils: require('squish-145/src/util/shapes'),
-    ViewUtils: require('squish-145/src/util/views'),
-    GeometryUtils: require('squish-145/src/util/geometry'),
-    Physics: require('squish-145/src/physics'),
-    ...require('squish-145/src/GameNode'),
-    TerrainGenerator: require('squish-145/src/terrain').terrainGenerator,
-};