@justai/cuts 0.129.1 → 0.129.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justai/cuts",
-  "version": "0.129.1",
+  "version": "0.129.3",
   "description": "A persona's named parts \u2014 the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {

package/src/Preroll.astro

@@ -364,7 +364,11 @@ const safeId = "game-" + (id.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/
    * container, and layout containment makes it the containing block for FIXED descendants too — a
    * fixed overlay written inside it would be clipped to the frame it is meant to surround. */
   html[data-stage="playing"] { overflow: hidden; }
-  html[data-stage="playing"] .cut.kernel { position: relative; z-index: 35; }
+  /* The kernel that holds a preroll rides above the room PERMANENTLY, not only while playing: the
+   * raise used to follow data-stage, so pausing dropped the kernel in one frame while the dim took
+   * half a second to fade - and every pause put a brief wave of darkness across the game itself.
+   * Static costs nothing (the room is transparent outside playing) and cannot mistime. */
+  .cut.kernel:has(#pr) { position: relative; z-index: 35; }
   .pr-room {
     position: fixed; inset: 0; z-index: 30;
     background: #05070d; opacity: 0; pointer-events: none;
@@ -473,7 +477,13 @@ const safeId = "game-" + (id.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/
       // and on a phone the only escape from that is closing the tab. So: a game that has not
       // declared protocol 2 in its boot answer is never given the stage. The declaration IS the
       // promise that `pause` is registered, and the shell holds it to that.
-      let protocol = 1;
+      // The declaration is the boot ANSWER, and a game may announce `playing` in the same breath
+      // as resolving boot — airdrop does, and its announcement beats its own answer onto the wire.
+      // So the stage handler never reads a variable; it AWAITS the declaration, and a message that
+      // arrives early is simply held until the shell knows who it is talking to. The watchdog path
+      // declares protocol 1, so a silent game's early announcement resolves to a refusal, not a hang.
+      let declareProtocol: (v: number) => void = () => {};
+      const declared: Promise<number> = new Promise((r) => { declareProtocol = r; });
       if (bus) {
         // The room's lights, hung on <body> — see the global style block for why not in here.
         const room = document.createElement("div");
@@ -530,9 +540,9 @@ const safeId = "game-" + (id.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/
 
         bus.register({
           method: "stage",
-          handler: (a: any) => {
-            // No protocol 2, no stage — the rule, not a courtesy. See the boot answer below.
-            if (protocol < 2) return { granted: false };
+          handler: async (a: any) => {
+            // No protocol 2, no stage — the rule, not a courtesy. Awaited, not read: see above.
+            if ((await declared) < 2) return { granted: false };
             setStage(a?.mode === "playing" ? "playing" : "paused");
             return { granted: true };
           },
@@ -625,9 +635,10 @@ const safeId = "game-" + (id.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/
       if (watchdog) clearTimeout(watchdog);
 
       // The boot answer carries the game's protocol version, and version 2 is the declaration
-      // that `pause` is registered and will be honoured. Read before open(), so a game announcing
-      // `playing` in its very first frame is already trusted.
-      protocol = typeof answer?.protocol === "number" ? answer.protocol : 1;
+      // that `pause` is registered and will be honoured. Resolved before open(), so a game
+      // announcing `playing` in its very first frame — or a breath before its own answer — is
+      // already trusted by the time the door goes up.
+      declareProtocol(typeof answer?.protocol === "number" ? answer.protocol : 1);
 
       open();
       // `curtain: true` is the game saying "hand over early, I will cover the rest myself" — which