castle-web-cli 0.4.166 → 0.4.168

package/kits/physics-2d/pnpm-lock.yaml

@@ -23,18 +23,33 @@ importers:
       '@codemirror/view':
         specifier: ^6.41.1
         version: 6.43.1
+      '@dnd-kit/core':
+        specifier: ^6.3.1
+        version: 6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7)
+      '@dnd-kit/modifiers':
+        specifier: ^9.0.0
+        version: 9.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7))(react@19.2.7)
+      '@dnd-kit/sortable':
+        specifier: ^10.0.0
+        version: 10.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7))(react@19.2.7)
+      '@dnd-kit/utilities':
+        specifier: ^3.2.2
+        version: 3.2.2(react@19.2.7)
       '@fortawesome/free-solid-svg-icons':
         specifier: ^5.15.4
         version: 5.15.4
       '@lezer/highlight':
         specifier: ^1.2.3
         version: 1.2.3
-      castle-web-sdk:
-        specifier: file:../../sdk
-        version: file:../../sdk
+      castle-web-fonts:
+        specifier: ^1.0.0
+        version: 1.0.0
       codemirror:
         specifier: ^6.0.2
         version: 6.0.2
+      matter-js:
+        specifier: ^0.20.0
+        version: 0.20.0
       react:
         specifier: ^19.2.4
         version: 19.2.7
@@ -42,6 +57,9 @@ importers:
         specifier: ^19.2.4
         version: 19.2.7(react@19.2.7)
     devDependencies:
+      castle-web-sdk:
+        specifier: file:../../sdk
+        version: file:../../sdk
       eslint:
         specifier: ^9.0.0
         version: 9.39.4
@@ -102,6 +120,34 @@ packages:
     resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
     engines: {node: '>=0.1.90'}
 
+  '@dnd-kit/accessibility@3.1.1':
+    resolution: {integrity: sha512-2P+YgaXF+gRsIihwwY1gCsQSYnu9Zyj2py8kY5fFvUM1qm2WA2u639R6YNVfU4GWr+ZM5mqEsfHZZLoRONbemw==}
+    peerDependencies:
+      react: '>=16.8.0'
+
+  '@dnd-kit/core@6.3.1':
+    resolution: {integrity: sha512-xkGBRQQab4RLwgXxoqETICr6S5JlogafbhNsidmrkVv2YRs5MLwpjoF2qpiGjQt8S9AoxtIV603s0GIUpY5eYQ==}
+    peerDependencies:
+      react: '>=16.8.0'
+      react-dom: '>=16.8.0'
+
+  '@dnd-kit/modifiers@9.0.0':
+    resolution: {integrity: sha512-ybiLc66qRGuZoC20wdSSG6pDXFikui/dCNGthxv4Ndy8ylErY0N3KVxY2bgo7AWwIbxDmXDg3ylAFmnrjcbVvw==}
+    peerDependencies:
+      '@dnd-kit/core': ^6.3.0
+      react: '>=16.8.0'
+
+  '@dnd-kit/sortable@10.0.0':
+    resolution: {integrity: sha512-+xqhmIIzvAYMGfBYYnbKuNicfSsk4RksY2XdmJhT+HAC01nix6fHCztU68jooFiMUB01Ky3F0FyOvhG/BZrWkg==}
+    peerDependencies:
+      '@dnd-kit/core': ^6.3.0
+      react: '>=16.8.0'
+
+  '@dnd-kit/utilities@3.2.2':
+    resolution: {integrity: sha512-+MKAJEOfaBe5SmV6t34p80MMKhjvUz0vRrvVJbPT0WElzaOJ/1xs+D+KDv+tD/NE5ujfrChEcshd4fLn0wpiqg==}
+    peerDependencies:
+      react: '>=16.8.0'
+
   '@eslint-community/eslint-utils@4.9.1':
     resolution: {integrity: sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==}
     engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
@@ -291,6 +337,9 @@ packages:
     resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==}
     engines: {node: '>=6'}
 
+  castle-web-fonts@1.0.0:
+    resolution: {integrity: sha512-amFts4vVJjaXKNQkh2DMMmxYHafCYczAOvme70n+0WX8fsTqJACh6r6MzND94l89Q6LFoIyrCm+cLh3S1Usy0w==}
+
   castle-web-sdk@file:../../sdk:
     resolution: {directory: ../../sdk, type: directory}
 
@@ -624,6 +673,9 @@ packages:
     resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
     engines: {node: '>= 0.4'}
 
+  matter-js@0.20.0:
+    resolution: {integrity: sha512-iC9fYR7zVT3HppNnsFsp9XOoQdQN2tUyfaKg4CHLH8bN+j6GT4Gw7IH2rP0tflAebrHFw730RR3DkVSZRX8hwA==}
+
   merge-stream@2.0.0:
     resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==}
 
@@ -836,6 +888,9 @@ packages:
   token-stream@1.0.0:
     resolution: {integrity: sha512-VSsyNPPW74RpHwR8Fc21uubwHY7wMDeJLys2IX5zJNih+OnAnaifKHo+1LHT7DAdloQ7apeaaWg8l7qnf/TnEg==}
 
+  tslib@2.8.1:
+    resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
   type-check@0.4.0:
     resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
     engines: {node: '>= 0.8.0'}
@@ -948,6 +1003,38 @@ snapshots:
   '@colors/colors@1.5.0':
     optional: true
 
+  '@dnd-kit/accessibility@3.1.1(react@19.2.7)':
+    dependencies:
+      react: 19.2.7
+      tslib: 2.8.1
+
+  '@dnd-kit/core@6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7)':
+    dependencies:
+      '@dnd-kit/accessibility': 3.1.1(react@19.2.7)
+      '@dnd-kit/utilities': 3.2.2(react@19.2.7)
+      react: 19.2.7
+      react-dom: 19.2.7(react@19.2.7)
+      tslib: 2.8.1
+
+  '@dnd-kit/modifiers@9.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7))(react@19.2.7)':
+    dependencies:
+      '@dnd-kit/core': 6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7)
+      '@dnd-kit/utilities': 3.2.2(react@19.2.7)
+      react: 19.2.7
+      tslib: 2.8.1
+
+  '@dnd-kit/sortable@10.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7))(react@19.2.7)':
+    dependencies:
+      '@dnd-kit/core': 6.3.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7)
+      '@dnd-kit/utilities': 3.2.2(react@19.2.7)
+      react: 19.2.7
+      tslib: 2.8.1
+
+  '@dnd-kit/utilities@3.2.2(react@19.2.7)':
+    dependencies:
+      react: 19.2.7
+      tslib: 2.8.1
+
   '@eslint-community/eslint-utils@4.9.1(eslint@9.39.4)':
     dependencies:
       eslint: 9.39.4
@@ -1149,6 +1236,8 @@ snapshots:
 
   callsites@3.1.0: {}
 
+  castle-web-fonts@1.0.0: {}
+
   castle-web-sdk@file:../../sdk: {}
 
   chalk@4.1.2:
@@ -1514,6 +1603,8 @@ snapshots:
 
   math-intrinsics@1.1.0: {}
 
+  matter-js@0.20.0: {}
+
   merge-stream@2.0.0: {}
 
   merge2@1.4.1: {}
@@ -1729,6 +1820,8 @@ snapshots:
 
   token-stream@1.0.0: {}
 
+  tslib@2.8.1: {}
+
   type-check@0.4.0:
     dependencies:
       prelude-ls: 1.2.1

package/kits/physics-3d/castle.json

@@ -69,5 +69,5 @@
   "autoUpdateWhenImported": true,
   "deckId": "JH0SclbPVP0y",
   "cardId": "eXfAaUdbSU5A",
-  "publishedVersion": "2026-09-02T05:55:18.459Z"
+  "publishedVersion": "2026-09-05T00:07:37.655Z"
 }

package/kits/physics-3d/package-lock.json

@@ -35,7 +35,7 @@
     },
     "../../sdk": {
       "name": "castle-web-sdk",
-      "version": "0.4.23",
+      "version": "0.4.26",
       "dev": true,
       "devDependencies": {
         "eslint": "^9.0.0",

package/kits/physics-3d/pnpm-lock.yaml

@@ -26,15 +26,27 @@ importers:
       '@dimforge/rapier3d-compat':
         specifier: ^0.19.2
         version: 0.19.3
+      '@dnd-kit/core':
+        specifier: ^6.3.1
+        version: 6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
+      '@dnd-kit/modifiers':
+        specifier: ^9.0.0
+        version: 9.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@dnd-kit/sortable':
+        specifier: ^10.0.0
+        version: 10.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@dnd-kit/utilities':
+        specifier: ^3.2.2
+        version: 3.2.2(react@19.2.8)
       '@fortawesome/free-solid-svg-icons':
         specifier: ^5.15.4
         version: 5.15.4
       '@lezer/highlight':
         specifier: ^1.2.3
         version: 1.2.3
-      castle-web-sdk:
-        specifier: file:../../sdk
-        version: file:../../sdk
+      castle-web-fonts:
+        specifier: ^1.0.0
+        version: 1.0.0
       codemirror:
         specifier: ^6.0.2
         version: 6.0.2
@@ -51,6 +63,9 @@ importers:
         specifier: ^0.180.0
         version: 0.180.0
     devDependencies:
+      castle-web-sdk:
+        specifier: file:../../sdk
+        version: file:../../sdk
       eslint:
         specifier: ^9.0.0
         version: 9.39.5
@@ -114,6 +129,34 @@ packages:
   '@dimforge/rapier3d-compat@0.19.3':
     resolution: {integrity: sha512-mMVdSj1PRTT108s9Swbu2GQOmHbn8kbJANRV5xfczL3s0T4vkgZAuoMRgvBzQcHanpKusbC0ZJj6z3mC3aj3vg==}
 
+  '@dnd-kit/accessibility@3.1.1':
+    resolution: {integrity: sha512-2P+YgaXF+gRsIihwwY1gCsQSYnu9Zyj2py8kY5fFvUM1qm2WA2u639R6YNVfU4GWr+ZM5mqEsfHZZLoRONbemw==}
+    peerDependencies:
+      react: '>=16.8.0'
+
+  '@dnd-kit/core@6.3.1':
+    resolution: {integrity: sha512-xkGBRQQab4RLwgXxoqETICr6S5JlogafbhNsidmrkVv2YRs5MLwpjoF2qpiGjQt8S9AoxtIV603s0GIUpY5eYQ==}
+    peerDependencies:
+      react: '>=16.8.0'
+      react-dom: '>=16.8.0'
+
+  '@dnd-kit/modifiers@9.0.0':
+    resolution: {integrity: sha512-ybiLc66qRGuZoC20wdSSG6pDXFikui/dCNGthxv4Ndy8ylErY0N3KVxY2bgo7AWwIbxDmXDg3ylAFmnrjcbVvw==}
+    peerDependencies:
+      '@dnd-kit/core': ^6.3.0
+      react: '>=16.8.0'
+
+  '@dnd-kit/sortable@10.0.0':
+    resolution: {integrity: sha512-+xqhmIIzvAYMGfBYYnbKuNicfSsk4RksY2XdmJhT+HAC01nix6fHCztU68jooFiMUB01Ky3F0FyOvhG/BZrWkg==}
+    peerDependencies:
+      '@dnd-kit/core': ^6.3.0
+      react: '>=16.8.0'
+
+  '@dnd-kit/utilities@3.2.2':
+    resolution: {integrity: sha512-+MKAJEOfaBe5SmV6t34p80MMKhjvUz0vRrvVJbPT0WElzaOJ/1xs+D+KDv+tD/NE5ujfrChEcshd4fLn0wpiqg==}
+    peerDependencies:
+      react: '>=16.8.0'
+
   '@eslint-community/eslint-utils@4.10.1':
     resolution: {integrity: sha512-cuadcxVFE8sDK6iWJbs8Sn0av2Nrh2QSGQhVlBW9AaAHqHwjWsZHT8LJ4hFGPh7ASBV2deFdM7H/DPjulmh8rg==}
     engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
@@ -303,6 +346,9 @@ packages:
     resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==}
     engines: {node: '>=6'}
 
+  castle-web-fonts@1.0.0:
+    resolution: {integrity: sha512-amFts4vVJjaXKNQkh2DMMmxYHafCYczAOvme70n+0WX8fsTqJACh6r6MzND94l89Q6LFoIyrCm+cLh3S1Usy0w==}
+
   castle-web-sdk@file:../../sdk:
     resolution: {directory: ../../sdk, type: directory}
 
@@ -855,6 +901,9 @@ packages:
   token-stream@1.0.0:
     resolution: {integrity: sha512-VSsyNPPW74RpHwR8Fc21uubwHY7wMDeJLys2IX5zJNih+OnAnaifKHo+1LHT7DAdloQ7apeaaWg8l7qnf/TnEg==}
 
+  tslib@2.8.1:
+    resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
   type-check@0.4.0:
     resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
     engines: {node: '>= 0.8.0'}
@@ -969,6 +1018,38 @@ snapshots:
 
   '@dimforge/rapier3d-compat@0.19.3': {}
 
+  '@dnd-kit/accessibility@3.1.1(react@19.2.8)':
+    dependencies:
+      react: 19.2.8
+      tslib: 2.8.1
+
+  '@dnd-kit/core@6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8)':
+    dependencies:
+      '@dnd-kit/accessibility': 3.1.1(react@19.2.8)
+      '@dnd-kit/utilities': 3.2.2(react@19.2.8)
+      react: 19.2.8
+      react-dom: 19.2.8(react@19.2.8)
+      tslib: 2.8.1
+
+  '@dnd-kit/modifiers@9.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
+    dependencies:
+      '@dnd-kit/core': 6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
+      '@dnd-kit/utilities': 3.2.2(react@19.2.8)
+      react: 19.2.8
+      tslib: 2.8.1
+
+  '@dnd-kit/sortable@10.0.0(@dnd-kit/core@6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
+    dependencies:
+      '@dnd-kit/core': 6.3.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
+      '@dnd-kit/utilities': 3.2.2(react@19.2.8)
+      react: 19.2.8
+      tslib: 2.8.1
+
+  '@dnd-kit/utilities@3.2.2(react@19.2.8)':
+    dependencies:
+      react: 19.2.8
+      tslib: 2.8.1
+
   '@eslint-community/eslint-utils@4.10.1(eslint@9.39.5)':
     dependencies:
       eslint: 9.39.5
@@ -1170,6 +1251,8 @@ snapshots:
 
   callsites@3.1.0: {}
 
+  castle-web-fonts@1.0.0: {}
+
   castle-web-sdk@file:../../sdk: {}
 
   chalk@4.1.2:
@@ -1754,6 +1837,8 @@ snapshots:
 
   token-stream@1.0.0: {}
 
+  tslib@2.8.1: {}
+
   type-check@0.4.0:
     dependencies:
       prelude-ls: 1.2.1

package/kits/real-time/CLAUDE.md

@@ -59,6 +59,11 @@ never learns the format.
 values of a player pose are geometry before the `clamped` flag, and `epsilonAt`,
 which a kit whose pose values are all one unit leaves undefined.
 
+`soloBadge.js` is the one file here that touches the DOM: a fixed badge that
+names why a session fell back to solo (`status().soloReason` from
+`connection.js`), drawn by both kits each frame through `updateSoloBadge`. It
+stays dependency-free and hides itself when a deck's `soloBadge` hook says so.
+
 ## Rules for editing this kit
 
 **Root-anchor anything that reaches out.** Once imported these files live at

package/kits/real-time/castle.json

@@ -9,11 +9,11 @@
   "imports": {
     "castle.base": {
       "deckId": "yRcmH4_aYllE",
-      "version": "2026-09-01T01:02:34.326Z"
+      "version": "2026-09-05T01:31:11.287Z"
     }
   },
   "autoUpdateWhenImported": true,
   "deckId": "xFVr-afOLuUQ",
   "cardId": "w6G45sy3_P_m",
-  "publishedVersion": "2026-09-02T05:55:19.420Z"
+  "publishedVersion": "2026-09-05T01:31:28.578Z"
 }

package/kits/real-time/code/client/connection.js

@@ -90,6 +90,10 @@ export async function connectSession({ onLog = () => {} } = {}) {
     status: () => ({
       state: connection.state,
       solo: connection.isSolo,
+
+      // Why the join fell back to solo (`private_deck`, `no_server_bundle`, or
+      // `unavailable`), null while multiplayer is live. Drives soloBadge.js.
+      soloReason: connection.soloReason ?? null,
       others: Math.max(0, net.roster.size - 1),
 
       // The SDK derives `you` by finding the local id in its player list. Use

package/kits/real-time/code/client/gameHooks.js

@@ -37,6 +37,9 @@ const modules = {
 //                                 for one frame
 //   afterFrame(scene, dt, system) after reporting
 //   presence(status)              the presence text a kit HUD shows
+//   soloBadge(status)             the solo fallback badge (soloBadge.js):
+//                                 false hides it, a string replaces its text.
+//                                 Called every frame, so keep it a lookup
 //   reset(scene, system)          a scene load, after spawned actors are gone
 //                                 and while the connection is still open
 //   dispose(scene, system)        runtime disposal, before reset and close

package/kits/real-time/code/client/soloBadge.js

@@ -0,0 +1,71 @@
+// A small on-screen badge for a session that fell back to solo, so a creator
+// testing their own deck learns why nobody can join instead of guessing that
+// multiplayer is broken. The two reasons a creator can fix name the fix; every
+// other reason is a plain "unavailable" (the platform does not say more).
+//
+// Dependency-free DOM: the 2D and 3D kits draw their scenes differently, and
+// neither has a shared HUD, so the badge lives outside both. A deck that wants
+// its own treatment exports `soloBadge` from `code/client/game.js`: `false`
+// suppresses it, a string replaces the text (see gameHooks.js).
+
+const TEXT = {
+  private_deck: 'Solo: this deck is private',
+  no_server_bundle: 'Solo: publish the deck to enable multiplayer',
+  unavailable: 'Multiplayer unavailable',
+};
+
+// The badge text for a `status()` result, or null while multiplayer is live.
+export function soloBadgeText(status) {
+  if (!status?.solo) {
+    return null;
+  }
+  return TEXT[status.soloReason] ?? TEXT.unavailable;
+}
+
+let element = null;
+let shown = null;
+
+// Show, update, or hide the badge to match `text`. Idempotent and cheap enough
+// to call every frame: nothing touches the DOM unless the text changed.
+export function showSoloBadge(text) {
+  if (text === shown || typeof document === 'undefined') {
+    return;
+  }
+  if (text === null) {
+    element?.remove();
+    element = null;
+    shown = null;
+    return;
+  }
+  if (!element) {
+    element = document.createElement('div');
+    element.setAttribute('data-castle-solo-badge', '');
+    element.style.cssText = [
+      'position:fixed',
+      'left:12px',
+      'bottom:12px',
+      'max-width:80vw',
+      'padding:6px 10px',
+      'border-radius:6px',
+      'background:rgba(0,0,0,0.72)',
+      'color:#fff',
+      'font:500 12px/1.4 system-ui,sans-serif',
+      'z-index:2147483647',
+      'pointer-events:none',
+    ].join(';');
+    document.body.appendChild(element);
+  }
+  element.textContent = text;
+  // Recorded only once the DOM holds it, so a failed append is retried next
+  // frame rather than suppressing the badge for the rest of the session.
+  shown = text;
+}
+
+// The per-frame call a kit makes: the deck hook decides, then the badge follows.
+export function updateSoloBadge(status, game) {
+  const custom = game?.soloBadge?.(status);
+  if (custom === false) {
+    return showSoloBadge(null);
+  }
+  showSoloBadge(typeof custom === 'string' ? custom : soloBadgeText(status));
+}

package/kits/real-time/package.json

@@ -10,5 +10,8 @@
     "castle-web-sdk": "file:../../sdk",
     "eslint": "^9.0.0",
     "prettier": "^3.8.3"
+  },
+  "dependencies": {
+    "castle-web-fonts": "^1.0.0"
   }
 }

package/kits/turn-based/castle.json

@@ -28,7 +28,7 @@
   "autoUpdateWhenImported": true,
   "deckId": "K6-Xs7dCoMVi",
   "cardId": "Kh_08IYATpC3",
-  "publishedVersion": "2026-09-02T05:55:21.391Z",
+  "publishedVersion": "2026-09-05T00:07:41.510Z",
   "server": {
     "main": "code/server/index.js",
     "maxPlayers": 8,

package/kits/turn-based/package-lock.json

@@ -29,7 +29,7 @@
     },
     "../../sdk": {
       "name": "castle-web-sdk",
-      "version": "0.4.23",
+      "version": "0.4.26",
       "dev": true,
       "devDependencies": {
         "eslint": "^9.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-cli",
-  "version": "0.4.166",
+  "version": "0.4.168",
   "type": "module",
   "bin": {
     "castle-web": "./dist/index.js"