@justai/cuts 0.148.0 → 0.150.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justai/cuts",
-  "version": "0.148.0",
+  "version": "0.150.0",
   "description": "A persona's named parts — the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {
@@ -41,8 +41,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@justai/core": "^0.39.0",
-    "@justai/ui": "^0.26.0",
+    "@justai/core": "^0.40.0",
+    "@justai/ui": "^0.27.0",
     "@justai/atrium": "^0.1.9"
   },
   "scripts": {

package/src/BackToZone.astro

@@ -13,8 +13,10 @@
 // THE TWO MARKS ARE SIBLINGS, DRAWN THE SAME WAY. app.zone is four separated corner brackets around a
 // centre — a zone is the space the corners enclose. pin.games is three vertex brackets around a play
 // triangle, drawn with app.zone's own part (pin-games, 2026-08-25). The zone has four corners; the
-// play has three. Same radii, same palette, same idea of a figure assembled from pieces, which is
-// what keeps them reading as one family at 20px.
+// play has three. City in Motion is a marker: two chevrons, the circle its head (app-zone,
+// the-family-of-marks). Same
+// radii, same palette, same idea of a figure assembled from pieces, which is what keeps them reading
+// as one family at 20px.
 //
 // Home affordance → the apex (the platform / App Store home). Standard on every app:
 // always visible at the top-left of the toolbar. Also tidies the ?ref / ?lang hints
@@ -83,7 +85,11 @@ const href = `https://${apex}`;
  * It self-corrects: the day a household has a mark here, every persona under it grows the affordance
  * on its next build, with no persona-level change anywhere.
  */
-const MARKS = ["app.zone", "pin.games"];
+//
+// cityinmotion.nl joined the table on 2026-10-05. For six weeks its personas had declined the control,
+// exactly as written above — the honest outcome while there was no mark here, and a missing way home
+// once there was one: every CiM persona already passed apex="cityinmotion.nl" and was waiting for it.
+const MARKS = ["app.zone", "pin.games", "cityinmotion.nl"];
 const drawable = MARKS.includes(apex);
 
 // queries: the home mark is missing arms · the mark is the wrong size · 36px · scoped styles do
@@ -113,6 +119,18 @@ const drawable = MARKS.includes(apex);
     <path class="arm a3" d="M550.15 91.57L399.09 170.67A17.93 17.93 0 0 1 374.89 163.1L346.57 109.02A17.93 17.93 0 0 1 354.14 84.82L505.19 5.72A6.45 6.45 0 0 0 505.19 -5.72L354.14 -84.82A17.93 17.93 0 0 1 346.57 -109.02L374.89 -163.1A17.93 17.93 0 0 1 399.09 -170.67L550.15 -91.57A103.36 103.36 0 0 1 550.15 91.57Z"/>
     <path class="ctr" d="M158.3 -92.3Q143.0 -100.3 143.0 -83.1L143.0 83.1Q143.0 100.3 158.3 92.3L319.3 8.0Q334.6 0.0 319.3 -8.0Z"/>
   </svg>
+  ) : apex === "cityinmotion.nl" ? (
+<svg class="cimmark" viewBox="-353.2 -386.42 706.39 725.18" aria-hidden="true">
+    <g transform="scale(1.04)">
+      <path class="arm a1" d="M-110.04 -35.11L-333.8 -240.15A17.93 17.93 0 0 1 -334.9 -265.48L-293.66 -310.49A17.93 17.93 0 0 1 -268.33 -311.6L-44.57 -106.56A65.97 65.97 0 0 0 44.57 -106.56L268.33 -311.6A17.93 17.93 0 0 1 293.66 -310.49L334.9 -265.48A17.93 17.93 0 0 1 333.8 -240.15L110.04 -35.11A162.88 162.88 0 0 1 -110.04 -35.11Z"/>
+      <path class="arm a2" d="M-110.04 282.94L-333.8 77.9A17.93 17.93 0 0 1 -334.9 52.57L-293.66 7.56A17.93 17.93 0 0 1 -268.33 6.46L-44.57 211.49A65.97 65.97 0 0 0 44.57 211.49L268.33 6.46A17.93 17.93 0 0 1 293.66 7.56L334.9 52.57A17.93 17.93 0 0 1 333.8 77.9L110.04 282.94A162.88 162.88 0 0 1 -110.04 282.94Z"/>
+      <circle class="ctr" cx="0" cy="-278.85" r="92.71"/>
+    </g>
+    <defs>
+      <linearGradient id="cimHome1" x1="0" y1="-287.99" x2="0" y2="96.91" gradientUnits="userSpaceOnUse"><stop stop-color="#5285DC"/><stop offset="1" stop-color="#2E62C6"/></linearGradient>
+      <linearGradient id="cimHome2" x1="0" y1="30.07" x2="0" y2="414.96" gradientUnits="userSpaceOnUse"><stop stop-color="#F2694A"/><stop offset="1" stop-color="#E04A30"/></linearGradient>
+    </defs>
+  </svg>
   ) : (
 <svg class="azmark" viewBox="-8.5 0 928 928" aria-hidden="true">
     <path class="arm a1" d="M360.365 0C372.599 0 382.517 9.91778 382.517 22.152V97.7555C382.517 109.99 372.599 119.907 360.365 119.907H203.398C157.082 119.907 119.537 157.453 119.537 203.769V353.64C119.537 370.244 106.077 383.704 89.4732 383.704H22.152C9.91778 383.704 0 373.786 0 361.552V175.633C0 78.6337 78.6338 0 175.634 0H360.365Z"/>
@@ -167,6 +185,19 @@ const drawable = MARKS.includes(apex);
     :global(html:not([data-theme="dark"])) .home:hover .pgmark .ctr, :global(html:not([data-theme="dark"])) .home:focus-visible .pgmark .ctr { fill: #2B2724; }
   }
 
+  /* queries: City in Motion's mark in the toolbar · cimmark · the CiM home control
+     cityinmotion.nl's own public/mark.svg, unlit, by the same rules: a marker, two chevrons and the
+     circle for its head, the viewBox the ink's own bounds (measured with the arcs and the 1.04 scale the apex draws
+     at), ink at rest, its own gradients and the ground's centre when engaged. */
+  .cimmark .arm,
+  .cimmark .ctr { fill: currentColor; }
+  .home:hover .cimmark .a1, .home:focus-visible .cimmark .a1 { fill: url(#cimHome1); }
+  .home:hover .cimmark .a2, .home:focus-visible .cimmark .a2 { fill: url(#cimHome2); }
+  .home:hover .cimmark .ctr, .home:focus-visible .cimmark .ctr { fill: #F5F1E8; }
+  @media (prefers-color-scheme: light) {
+    :global(html:not([data-theme="dark"])) .home:hover .cimmark .ctr, :global(html:not([data-theme="dark"])) .home:focus-visible .cimmark .ctr { fill: #2B2724; }
+  }
+
   .home:hover .azmark .a1, .home:focus-visible .azmark .a1 { fill: url(#azHome1); }
   .home:hover .azmark .a2, .home:focus-visible .azmark .a2 { fill: url(#azHome2); }
   .home:hover .azmark .a3, .home:focus-visible .azmark .a3 { fill: url(#azHome3); }

package/src/Base.astro

@@ -92,11 +92,14 @@ interface Props {
    * sides and is *at least* the active view's height; a GAME kernel keeps no inset at all and is
    * *exactly* that height.
    *
+   * `art` (2026-10-09) — a musical or visual work that embeds its piece — takes the game's geometry and
+   * its dark ground: it is entered, not scrolled.
+   *
    * IT DEFAULTS TO `app` BECAUSE FIFTEEN OF THE SIXTEEN PERSONAS ARE ONE. The failure of getting it
    * wrong is quiet in the right direction: a game persona that forgets it renders as an app — margins
    * where it wanted none — rather than an app persona bleeding to the edges.
    */
-  kind?: "app" | "game" | "now" | "expert" | "knower" | "platform";
+  kind?: "app" | "game" | "art" | "now" | "expert" | "knower" | "platform";
 }
 
 const {
@@ -147,8 +150,9 @@ if (siteProp && Astro.site && new URL(siteProp).origin !== Astro.site.origin) {
 // bottom of the screen because there is nothing there that is not the room. A persona that wants
 // otherwise passes its own — this is a default, not a law.
 const GAME_GROUND = "#080b12";
-const dark = themeDark ?? (kind === "game" ? GAME_GROUND : "#000000");
-const light = themeLight ?? (kind === "game" ? GAME_GROUND : "#f2f2f7");
+const placeKind = kind === "game" || kind === "art";   // a place you go into: the dark ground in both schemes
+const dark = themeDark ?? (placeKind ? GAME_GROUND : "#000000");
+const light = themeLight ?? (placeKind ? GAME_GROUND : "#f2f2f7");
 
 const d = dirOf(lang);
 const consent = consentCopy(lang);

package/src/Preroll.astro

@@ -46,9 +46,24 @@ import "./ground.css";
 type StoreKey = "ios" | "mac" | "android" | "steam" | "windows" | "switch" | "playstation" | "xbox";
 
 interface Props {
-  /** The game's own document, served from this persona's origin. Give this OR `stores`, never both. */
+  /** The game's own document, served from this persona's origin — or a WORK at its own address
+   *  (`https://…`), embedded as it is. Give this OR `stores`, never both. */
   src?: string;
 
+  // ── A WORK THAT LIVES AT ITS OWN ADDRESS ──────────────────────────────────────────────────
+  //
+  // queries: art persona · embed a work by iframe · the kernel embeds another site · city rises ·
+  //          the work updates without the shell · handover on load · a frame that does not speak atrium
+  //
+  // An `art` persona's kernel does not carry the work, it EMBEDS it: City Rises lives at
+  // city-rises.justrd.pro and keeps changing there, and city-rises.cityinmotion.nl shows it without a
+  // release of its own. Such a work does not speak the game–shell protocol — it has its own gate and
+  // asks for its own gesture — so waiting for a `boot` answer would hold the door for the whole
+  // patience window. `handover` says what ends the wait: `boot` (the protocol's answer, the default
+  // for a document on this origin) or `load` (the frame's own load event, the default for a `src`
+  // that names another origin). Same door, same gesture, same bar; only the signal differs.
+  handover?: "boot" | "load";
+
   // ── THE DOOR THAT OPENS OUTWARD ───────────────────────────────────────────────────────────
   //
   // queries: native game persona · a game persona for an app store title · the play button goes
@@ -113,6 +128,7 @@ interface Props {
   id?: string;
 }
 const { src, stores, also = "Also on", kicker, name, tag, sub, play, title, loading = "Loading", id = "game" } = Astro.props;
+const handover = Astro.props.handover ?? (/^https?:\/\//i.test(src ?? "") ? "load" : "boot");
 const safeId = "game-" + (id.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "x");
 
 // ONE DOOR, ONE DIRECTION. A preroll with both a frame and a store list would render two answers to
@@ -133,7 +149,7 @@ const storeRows = outward.map(([key, url]) => ({ key, url, label: STORE_NAMES[ke
 const primary = storeRows[0]?.url;
 ---
 
-<div class="pr" id="pr" data-src={src} data-atrium={src ? safeId : undefined} data-door={outward.length ? "store" : "frame"}>
+<div class="pr" id="pr" data-src={src} data-handover={src ? handover : undefined} data-atrium={src ? safeId : undefined} data-door={outward.length ? "store" : "frame"}>
   {/* ── THE STAGE IS THE FLOW; THE DOOR IS A COVER OVER IT ──────────────────────────────────────
       queries: the game boots at zero size · getBoundingClientRect returns 0 in the frame ·
                the game jumps when the preroll hands over · display none iframe · hidden iframe

package/src/behaviour/preroll.ts

@@ -62,6 +62,8 @@ if (root && root.dataset.door === "store") {
 
   const src = root.dataset.src as string;
   const atriumId = root.dataset.atrium as string;
+  // `load` for a work at its own address (see Preroll.astro, "A WORK THAT LIVES AT ITS OWN ADDRESS").
+  const onLoad = root.dataset.handover === "load";
 
   let started = false;
 
@@ -268,7 +270,10 @@ if (root && root.dataset.door === "store") {
     const here = new URLSearchParams(location.search);
     const url = new URL(src, location.href);
     for (const flag of ["xray", "slow"]) if (here.has(flag)) url.searchParams.set(flag, here.get(flag) ?? "");
-    frame.src = url.pathname + url.search;
+    // A document on this origin is named by its path, as it always was; a work at another address
+    // keeps its whole address — the path alone would load a page of this persona into the frame.
+    frame.src = url.origin === location.origin ? url.pathname + url.search : url.href;
+    const loaded = new Promise<any>((resolve) => frame.addEventListener("load", () => resolve({}), { once: true }));
 
     // ── THE HANDOVER ─────────────────────────────────────────────────────────────────────────
     //
@@ -309,12 +314,16 @@ if (root && root.dataset.door === "store") {
     // not lose the game to a broken handshake — but the catch SAYS what went wrong, because the
     // symptom on the other side of it is "the wait ended early" and nothing else. This cut's own
     // one-second bug lived inside an empty catch and was invisible until a spec read the bar.
+    // A work that does not speak the protocol is ready when its document has loaded — it draws its
+    // own gate from there. Its frame's load event joins the race only for `handover: load`: a game on
+    // this origin loads its document long before it can draw, and that is what the boot answer is for.
     const answer: any = await Promise.race([
       boot.catch((e: any) => {
         console.warn("[preroll] the game's boot did not complete:", e?.message || e);
         return {};
       }),
       giveUp,
+      ...(onLoad ? [loaded] : []),
     ]);
     if (watchdog) clearTimeout(watchdog);