@funpixel/tools 0.1.0 → 0.1.1

package/dist/production/mirror.js

@@ -71,7 +71,7 @@ export function productionMirror(dir) {
         const making = read(join(dir, 'design', 'MAKING.md'));
         const entries = (making.match(/^## /gm) ?? []).length;
         if (!making)
-            add('warn', 'direct', 'no design/MAKING.md', 'the making-of log: per lane, the decision, its numbers and the lesson (Held Note design/MAKING.md)');
+            add('warn', 'direct', 'no design/MAKING.md', 'the making-of log: per lane, the decision, its numbers and the lesson');
         else if (entries <= 1)
             add('note', 'direct', 'design/MAKING.md has no lane entry yet', 'write one when a lane lands: decision, numbers, lesson');
         if (gdd && !/^## Identity lock/m.test(gdd))
@@ -84,7 +84,7 @@ export function makingLog(name, date) {
 
 A running log, one entry per lane when it lands: what was decided, the numbers that decided it, and the lesson
 for the next lane. Before/after frames at fixed framing (desktop 1280x720, phone 844x390) beside each entry.
-The model is Held Note's design/MAKING.md. Stays private (/design/ is in .harnessignore).
+Stays private (/design/ is in .harnessignore).
 
 ## ${date} · Lane 0: the plan
 

package/dist/sim/curve.js

@@ -23,7 +23,7 @@ export function judgeCurve(cohorts) {
     const measured = ['naive', 'novice', 'skilled'].map((r) => byRole(cohorts, r)).filter((c) => !!c && split(c));
     const played = cohorts.filter((c) => c.seeds > 0);
     if (played.length && played.every((c) => c.lost === 0) && played.some((c) => c.seconds >= LOSABLE_SECONDS)) {
-        out.push({ id: 'losable', state: 'warn', says: `no run was lost by any of ${played.length} players over ${played[0].seeds} seeds (${played.map((c) => c.policy).join(', ')}): a run cannot be lost`, next: 'a puzzle or a toy on purpose? say so in the design doc and to the player; else a threat, a clock or a resource that can end a run (Sunhop, 30 Sep)' });
+        out.push({ id: 'losable', state: 'warn', says: `no run was lost by any of ${played.length} players over ${played[0].seeds} seeds (${played.map((c) => c.policy).join(', ')}): a run cannot be lost`, next: 'a puzzle or a toy on purpose? say so in the design doc and to the player; else a threat, a clock or a resource that can end a run' });
     }
     if (!measured.length) {
         out.push({ id: 'curve', state: 'not measured', says: skilled?.levels?.length ? 'the probe keeps when levels were reached but not who cleared or lost them (an older src/probe-kit.ts: funtools upgrade parks the new one)' : 'no level(run) in test/probes.ts: the difficulty curve per level, stage or wave was never split', next: 'add level(run) to the probe game (the level, stage or wave number) so sim splits clear rate, loss rate and time per level' });
@@ -39,7 +39,7 @@ export function judgeCurve(cohorts) {
             const s = at(skilled, lv), h = at(human, lv);
             const sClear = s && s.reached ? share(s.cleared, s.reached) : null, hClear = h && h.reached ? share(h.cleared, h.reached) : null;
             if (sClear !== null && hClear !== null && sClear >= 0.5 && hClear < HUMAN_SHARE * sClear) {
-                out.push({ id: `wall:${lv}`, state: 'warn', says: `level ${lv} is a wall for people: the skilled bot clears it on ${pct(sClear)} of seeds at 60 decisions a second, but ${pct(hClear)} at ${human.human.hz} a second with ${human.human.reactMs} ms to react`, next: 'the level asks for superhuman input (Saltwake\'s Dusk Cup, 30 Sep): longer warnings, a wider window, fewer inputs per second, or a slower rival' });
+                out.push({ id: `wall:${lv}`, state: 'warn', says: `level ${lv} is a wall for people: the skilled bot clears it on ${pct(sClear)} of seeds at 60 decisions a second, but ${pct(hClear)} at ${human.human.hz} a second with ${human.human.reactMs} ms to react`, next: 'the level asks for superhuman input (one race, 30 Sep): longer warnings, a wider window, fewer inputs per second, or a slower rival' });
             }
             else if ((hClear ?? sClear) !== null && (hClear ?? sClear) < WALL_SHARE && ((h ?? s).lost ?? 0) > 0 && lv !== levels.at(-1)) {
                 const who = h ? `the skilled player at ${human.human.hz} decisions a second` : 'the skilled bot';
@@ -117,6 +117,6 @@ export function judgeReach(cohorts, claimed, where = 'the design doc') {
     if (won && top >= claimed)
         return { id: 'reach', state: 'ok', says: `the skilled bot plays through all ${claimed} areas ${where} claims` };
     if (top <= claimed / 2)
-        return { id: 'reach', state: 'warn', says: `${where} claims ${claimed} areas or levels; the skilled bot reaches ${top}`, next: 'play reaches much less than the plan claims (Floe claimed 8 worlds, play reached 2): build and wire what the plan names, lower the claim, or fix the wall that stops the bot' };
+        return { id: 'reach', state: 'warn', says: `${where} claims ${claimed} areas or levels; the skilled bot reaches ${top}`, next: 'play reaches much less than the plan claims (one game claimed 8 worlds, play reached 2): build and wire what the plan names, lower the claim, or fix the wall that stops the bot' };
     return { id: 'reach', state: 'note', says: `${where} claims ${claimed} areas or levels; the skilled bot reaches ${top}${won ? '' : ' and never wins'}` };
 }

package/dist/spec/scaffold.js

@@ -403,7 +403,7 @@ This folder is what a building agent works from (the ${o.tier} tier of the plan,
 
 The data files live here, outside the Unity project, so the design and the game read one copy:
 - an Editor step copies \`tunables.json\` and \`rooms.json\` into \`${o.copy}/\` (TextAssets the game reads at start);
-- an EditMode test fails when a copy differs from this folder, so a change made here and not carried over is a red test, not a silent drift (Floe Jam's tunables changed in design/ while its Unity copy did not);
+- an EditMode test fails when a copy differs from this folder, so a change made here and not carried over is a red test, not a silent drift (one game's tunables changed in design/ while its Unity copy did not);
 - edit this folder, never the copy.
 
 ## Slice first

package/dist/studio/pitch.js

@@ -50,7 +50,7 @@ export const CATALOGUE = [
             { id: 'cutscenes', label: 'Cutscenes', why: 'one earned cinematic (the ending, a reveal), skippable', cost: '$1–3 each, plus a scene to stage' },
             { id: 'photo', label: 'Photo mode', why: 'players share the wow moments; the share card carries the game', cost: 'a free camera, a frame and a share sheet: about a day' },
             { id: 'multiplayer', label: 'Multiplayer', why: 'friends in one room through the relay', cost: 'doubles the test work; the host owns the world state' },
-            { id: 'two-takes', label: 'Two takes', why: 'for a deep game: two parallel builds of the same locked plan, each winning different areas (one the environment, one the dynamics); `funtools compare-takes` plays both from the title and writes a best-of-both table, and the mix beats both (Blue Freight, 3 rounds)', cost: 'twice the build sessions, plus a merge round' },
+            { id: 'two-takes', label: 'Two takes', why: 'for a deep game: two parallel builds of the same locked plan, each winning different areas (one the environment, one the dynamics); `funtools compare-takes` plays both from the title and writes a best-of-both table, and the mix beats both (one game, 3 rounds)', cost: 'twice the build sessions, plus a merge round' },
             { id: 'none', label: 'None', why: 'everything goes into the core' },
         ],
     },

package/dist/unity/probe/install.js

@@ -13,7 +13,7 @@ export function kitPackage(env = process.env, here = dirname(fileURLToPath(impor
 export function reference(project, o) {
     if (o.git) {
         if (!o.ref)
-            return { error: '--git needs --ref <tag or commit>: an unpinned git package changes under the project (koi-out tracks #main)' };
+            return { error: '--git needs --ref <tag or commit>: an unpinned git package changes under the project (one game tracked #main)' };
         const sep = o.git.includes('?') ? '&' : '?';
         return `${o.git}${o.git.includes('path=') ? '' : `${sep}path=/funpixel-mono/libs/unity/${PACKAGE}`}#${o.ref}`;
     }

package/dist/vendor/verify/src/page/actors.js

@@ -9,7 +9,7 @@
 // Three only: an actor must be SEEN to be measured. Rays go from the camera to
 // its centre and to 0.6 m either side of it (camera right and up) against every
 // other drawn, opaque mesh; when all five are blocked (behind a wall, a shut
-// door) or off screen, it goes in `hidden`, not in `actors` — Held Note: all 8
+// door) or off screen, it goes in `hidden`, not in `actors` — one game: all 8
 // threats measured were behind walls, so their ΔE measured the walls.
 //
 // Who plays a role, most specific first, decided per role:
@@ -17,7 +17,7 @@
 //              that starts with the role (player-ines, threat-walker-3). Once
 //              any node in the scene, shown or not, carries a role's tag, only
 //              tagged nodes play that role, so a prop named hazard_barrier is
-//              scenery (Held Note: the usual words measured it as the threat)
+//              scenery (one game: the usual words measured it as the threat)
 //   declared — the caller's pattern (funpixel.json "actors", --player/--threats)
 //   words    — the usual words (player|hero|avatar; enemy|threat|hazard|…)
 // `matched` says per role which of the three picked, and the node names it

package/dist/vendor/verify/src/page/capture_view.js

@@ -24,8 +24,8 @@
 // The phone's safe area is EMULATED before the view is entered, for every look
 // but a bare listing (view null, no hold, no freeze): headless Chromium reports
 // every env(safe-area-inset-*) as 0, so a game that pads with env() hugged the
-// edge in the picture while audit-screens measured it against a notch (Riad
-// Rush, Sunhop). The page's env(safe-area-inset-*) now resolves to the insets,
+// edge in the picture while audit-screens measured it against a notch (two
+// games). The page's env(safe-area-inset-*) now resolves to the insets,
 // in its stylesheets, its inline styles and those it adds later, and a resize
 // is sent so a game that reads them again lays out again. capture and
 // audit-screens (local and hosted) share this one emulation.

package/dist/vendor/verify/src/page/dressing.js

@@ -1,5 +1,5 @@
 // How dressed is the play (lane V2, the Silt bar's S7: "dressing density with a clear road"; Silt's
-// chapter one carries 42k instanced flowers, Saltwake and Sunhop "read as shapes"): the small things of a
+// chapter one carries 42k instanced flowers, two of our games "read as shapes"): the small things of a
 // Three scene counted per area round the player, by role, beside what they cost a frame.
 //
 // A thing is one instance of an InstancedMesh, or a mesh that is small (footprint under `max_size`,

package/dist/vendor/verify/src/page/frame_honesty.js

@@ -1,5 +1,5 @@
 // Is this frame play, or a loading or splash screen? A capture that lands on a splash must never
-// count as a moment (Pocket Crew: captures fooled by a 3.7 s splash; Blue Freight 1 Oct: shots of a
+// count as a moment (one game: captures fooled by a 3.7 s splash; another, 1 Oct: shots of a
 // loading card scored as the moment). Three signs, each read only when the page offers it:
 //   state  — __FPX_STATE__()'s screen / phase / view / mode names a splash, a loader or a boot
 //   dom    — a shown element named splash / loading / loader / preload / boot covering ≥ 40% of the page

package/dist/vendor/verify/src/page/front_door.js

@@ -40,9 +40,9 @@ async (a) => {
 
   // Seen by a player: laid out, on the screen, and hidden by neither itself nor
   // an ancestor. Opacity multiplies down the tree and visibility inherits, so a
-  // faded screen's children are faded too (Held Note: a chapter card at
+  // faded screen's children are faded too (one game: a chapter card at
   // opacity 0 counted as HUD all chapter, a hidden title's text was flagged in
-  // every play view; Fold Room: a label inside a faded-out button).
+  // every play view; another: a label inside a faded-out button).
   // checkVisibility answers where the browser has it; the
   // walk up the ancestors is the fallback, and also catches a stack of
   // part-faded layers that multiplies to nothing.

package/dist/vendor/verify/src/page/grounding.js

@@ -1,11 +1,11 @@
-// Is everything big standing on the ground (owner, 2 Oct, Blue Freight round 4: "the spacecraft must
+// Is everything big standing on the ground (owner, 2 Oct, one game's round 4: "the spacecraft must
 // not stay in the air if it's landed" — the walk said "floating: none" because it only read actors).
 // For the large props and the vehicles of a Three scene: where each one touches down (the lowest
 // vertices of its mesh, cell by cell under it, or the bottom corners of its box), read by a vertical ray
 // against the SURFACES under it, and how far it is above (hovering) or below (sunk) the nearest one. A
 // thing resting on another (a stacked container) is held, not hovering.
 //
-// The surfaces (lane J4, Blue Freight round 5: a deck, a ramp, its railing and the gantry's trestles read
+// The surfaces (lane J4, one game's round 5: a deck, a ramp, its railing and the gantry's trestles read
 // "sunk" against the crater floor under them, and the landed ship "41 m over a drop" beside its pad):
 //   terrain   meshes named ground, terrain, floor, road… (the `ground` regex)
 //   supports  built things people stand on: a mesh named deck, pad, platform, ramp, bridge, pier, dock,
@@ -430,7 +430,7 @@
     const hoverGap = verdict === 'hovering' && known.length ? Math.min(...known) : null;
     // Touching down cell by cell: the gap where it is nearest a surface (a sloped railing is not "−3.6 m" at its centre).
     const nearGap = t.mesh && known.length ? known.reduce((m, v) => (Math.abs(v) < Math.abs(m) ? v : m), known[0]) : null;
-    // Where it is off and by how much (Lantern Night: "a distance and not which corner or what tolerance").
+    // Where it is off and by how much (one game: "a distance and not which corner or what tolerance").
     let lo = -1, hi = -1, deep = -1;
     gaps.forEach((q, i) => {
       if (q.gap !== null) { if (lo < 0 || q.gap < gaps[lo].gap) lo = i; if (hi < 0 || q.gap > gaps[hi].gap) hi = i; }

package/dist/vendor/verify/src/page/hud.js

@@ -49,7 +49,7 @@ async (a) => {
     const alpha = p.length >= 3 ? (p[3] === undefined ? 1 : p[3]) : 0;
     const image = (s.backgroundImage && s.backgroundImage !== 'none') || (s.borderImageSource && s.borderImageSource !== 'none');
     if (alpha <= 0.05 && !image) return null;
-    // drawn: a picture (url()) dresses it, not only a gradient: a gradient clipped to system text is still system text (Floe R4's title).
+    // drawn: a picture (url()) dresses it, not only a gradient: a gradient clipped to system text is still system text (one game's round-4 title).
     const drawn = /url\(/.test(`${s.backgroundImage} ${s.borderImageSource}`);
     return { rgb: alpha > 0.05 ? [p[0], p[1], p[2]].map(Math.round) : null, alpha: Math.round(alpha * 100) / 100, image: !!image, drawn };
   };
@@ -64,9 +64,9 @@ async (a) => {
   };
   // Seen by a player: laid out, on the screen, and hidden by neither itself nor
   // an ancestor. Opacity multiplies down the tree and visibility inherits, so a
-  // faded screen's children are faded too (Held Note: a chapter card at
+  // faded screen's children are faded too (one game: a chapter card at
   // opacity 0 counted as HUD all chapter, a hidden title's text was flagged in
-  // every play view; Fold Room: a label inside a faded-out button).
+  // every play view; another: a label inside a faded-out button).
   // checkVisibility answers where the browser has it; the
   // walk up the ancestors is the fallback, and also catches a stack of
   // part-faded layers that multiplies to nothing.

package/dist/vendor/verify/src/page/layout.js

@@ -31,12 +31,12 @@
 //                  counts when both are hit there (clip-path and rounded
 //                  corners respected) and both paint there (a background, an
 //                  image's opaque pixel, a glyph line), so four clip-path
-//                  wedges of a d-pad whose boxes cross do not overlap (Riad Rush);
+//                  wedges of a d-pad whose boxes cross do not overlap;
 //                  nor do one widget's layers (absolute siblings in a parent
 //                  that clips them, no control, no text: a meter's fill and trail)
 //   clipped      — HUD, controls or text cut by the viewport edge: { name, side };
 //                  not what a scroll container (or the page) scrolls to on that
-//                  side: below-the-fold content is reached by scrolling (Floe);
+//                  side: below-the-fold content is reached by scrolling;
 //                  and a control cut by what it sits in (a clip-path, overflow
 //                  hidden, a mask), under 80% of it shown: { name, side: 'clip',
 //                  shown (%), by (the ancestor) } — its own shape set aside
@@ -50,9 +50,9 @@ async (a) => {
   const HIT = 'button, a[href], [role="button"], [data-fpx-touch], input, select';
   // Seen by a player: laid out, on the screen, and hidden by neither itself nor
   // an ancestor. Opacity multiplies down the tree and visibility inherits, so a
-  // faded screen's children are faded too (Held Note: a chapter card at
+  // faded screen's children are faded too (one game: a chapter card at
   // opacity 0 counted as HUD all chapter, a hidden title's text was flagged in
-  // every play view; Fold Room: a label inside a faded-out button).
+  // every play view; another: a label inside a faded-out button).
   // checkVisibility answers where the browser has it; the
   // walk up the ancestors is the fallback, and also catches a stack of
   // part-faded layers that multiplies to nothing.
@@ -297,7 +297,7 @@ async (a) => {
     const inset = Object.keys(e).find((k) => safe[k] > 0 && e[k] < safe[k] - 1 && !scrollsTo(el, k));
     if (inset) add(unsafe, { name: nameOf(el), side: inset });
   }
-  // A control cut by an ancestor (Kite Run, 9 Oct: a clip-path on the end card's paper tag cut its
+  // A control cut by an ancestor (one game, 9 Oct: a clip-path on the end card's paper tag cut its
   // "Title" button half off on a tall card, and every check passed it): points over the part of the
   // control on the screen are hit-tested with its OWN clip-path and corners set aside (its shape is
   // its design), so a point that misses it was cut by something it sits in (a clip-path, overflow

package/dist/vendor/verify/src/page/life_anim.js

@@ -1,4 +1,4 @@
-// Motion is not animation (owner, 1 Oct, Blue Freight: "static people, static creatures; what is
+// Motion is not animation (owner, 1 Oct, one game: "static people, static creatures; what is
 // animated is unlike living, just stone moves"). A sampler installed in the page watches the people,
 // creatures and the player and tells, per actor, whether anything INSIDE it changed: its picture (a
 // texture, a sheet frame, a UV offset), its bones, its morph weights, its vertices, or the pose of
@@ -10,7 +10,7 @@
 // near than with the player far (a crab that always bobs changes at one rate everywhere; one that
 // scatters when the player comes changes more near). Counted per actor, not per change.
 //
-// Moving through space is not animating in place (Blue Freight round 3: 28 townsfolk animated IN
+// Moving through space is not animating in place (one game's round 3: 28 townsfolk animated IN
 // PLACE, none walked anywhere): each actor says how far it travelled, and a crowd that never travels
 // is named. A crowd that wears the hero's face (the same geometry or texture as the player: rig
 // clones of the hero) and a crowd of one look are named too. Flyers (contract `flies`/`flying`, or a
@@ -25,8 +25,8 @@
 // shader cannot be read from the scene: declare it in the actors contract (`deform: true`). Mirroring
 // (scale.x sign) and opacity or tint pulses are never animation.
 //
-// A CODE-DRAWN shape (a Pixi Graphics cleared and drawn again each frame: Kite Run's gulls flap and its
-// tail streams that way) is read by what it draws: the drawing's size and its paths' points measured from
+// A CODE-DRAWN shape (a Pixi Graphics cleared and drawn again each frame: one game's gulls flap and its
+// kite's tail streams that way) is read by what it draws: the drawing's size and its paths' points measured from
 // the drawing's own corner, so the same shape drawn at a new place is motion and a shape drawn
 // differently is animation. A Pixi mesh is read by its vertices. What the sampler cannot read inside (a
 // filter, a shader material, a drawing it cannot parse) makes an actor `unseen` when nothing else changed:
@@ -262,7 +262,7 @@
     return t ? `${t.uuid}:${t.offset ? `${t.offset.x.toFixed(3)},${t.offset.y.toFixed(3)}` : ''}:${t.repeat ? `${t.repeat.x.toFixed(3)},${t.repeat.y.toFixed(3)}` : ''}` : '';
   };
   // A code-drawn Pixi shape (Graphics, redrawn each frame: a gull's wings, a streaming tail, a paper sail that
-  // bellies; Kite Run, 9 Oct) is read by what it draws, not by a picture: its drawing's size and every path's
+  // bellies; one game, 9 Oct) is read by what it draws, not by a picture: its drawing's size and every path's
   // points measured from the drawing's own corner, so a shape drawn again at a new place reads the same (that
   // is motion) and a shape drawn differently reads as changed (that is animation). Pixi v8 (context
   // instructions), v7 (geometry.graphicsData); null when neither can be read.
@@ -420,7 +420,7 @@
       if (pixi && (o.alpha ?? 1) <= 0.01) return;
       const name = o.label || o.name || '';
       const role = roleOf(name);
-      // A node named like a creature that holds the player (Kite Run: the "kite" container around the player's
+      // A node named like a creature that holds the player (one game: the "kite" container around the player's
       // sail, a kite also being a flyer's word) is not an actor: the player inside it is looked for.
       if (role && !(role !== 'player' && playerBelow(o))) {
         found.push([o, role, name]);

package/dist/vendor/verify/src/page/mechanic_check.js

@@ -85,7 +85,7 @@ async (a) => {
       if (app && app.stage && typeof app.stage.getChildByLabel === 'function') {
         const s = app.stage.getChildByLabel(subject, true);
         if (s && typeof s.getGlobalPosition === 'function') {
-          // A container whose children move (Kite Run: "kite" stays at 0,0 while its sail flies) is
+          // A container whose children move (one game: a "kite" container stays at 0,0 while its sail flies) is
           // where its drawing is: the centre of its world bounds. A leaf is where its position is.
           if (Array.isArray(s.children) && s.children.length && typeof s.getBounds === 'function') {
             try {

package/dist/vendor/verify/src/page/phone_check.js

@@ -27,9 +27,9 @@ async (a) => {
 
   // Seen by a player: laid out, on the screen, and hidden by neither itself nor
   // an ancestor. Opacity multiplies down the tree and visibility inherits, so a
-  // faded screen's children are faded too (Held Note: a chapter card at
+  // faded screen's children are faded too (one game: a chapter card at
   // opacity 0 counted as HUD all chapter, a hidden title's text was flagged in
-  // every play view; Fold Room: a label inside a faded-out button).
+  // every play view; another: a label inside a faded-out button).
   // checkVisibility answers where the browser has it; the
   // walk up the ancestors is the fallback, and also catches a stack of
   // part-faded layers that multiplies to nothing.

package/dist/vendor/verify/src/page/recorder.js

@@ -1,5 +1,5 @@
-// A real-time film of the play camera: MediaRecorder on the game's canvas stream (the GDK Blue
-// Freight build had to hand-write one to show a walk; screenshots every few hundred ms are not a
+// A real-time film of the play camera: MediaRecorder on the game's canvas stream (one GDK
+// build had to hand-write one to show a walk; screenshots every few hundred ms are not a
 // film, and a frozen clock is not real time). Records what the canvas draws at the game's own pace;
 // DOM over the canvas (the HUD) is not in it. Read-only to the game.
 //

package/dist/vendor/verify/src/page/surfaces.js

@@ -1,4 +1,4 @@
-// What each part of the frame is made of (owner, 2 Oct, Blue Freight round 4: "the environment
+// What each part of the frame is made of (owner, 2 Oct, one game's round 4: "the environment
 // still has boxes, must be fixed" — flat-colour containers beside one painted building, big
 // flat-shaded slabs filling the foreground). A coarse software raster of the Three scene from the
 // play camera: every cell of a grid over the canvas gets the NEAREST triangle under its centre, so
@@ -33,7 +33,7 @@
 //               color, textures } }]
 //   tris_read, capped
 //   figures — the people and creatures of the actors contract (kind person|creature, by their `node`) built as a
-//             handful of boxes, whatever their size on screen (lane J4, Blue Freight r5: Marit and the hound were four
+//             handful of boxes, whatever their size on screen (lane J4, one game's r5: a herder and the hound were four
 //             and seven flat boxes, too small on screen for the area read): [{ id, kind, node, meshes, boxes (how many
 //             are cuboids: a BoxGeometry, or eight corners and axis-aligned faces), verts, on (in front of the camera) }]
 (a) => {

package/dist/vendor/verify/src/page/world_actors.js

@@ -1,5 +1,5 @@
 // Where every actor of the world stands, how big it is and where it lands on screen (owner, 1 Oct,
-// Blue Freight: "lots of misplaces, collisions"; "we don't play and verify the environment is right
+// one game: "lots of misplaces, collisions"; "we don't play and verify the environment is right
 // and well built"). Read by `funtools walk` each tick (clipping, floating, scale, blocked paths) and
 // by `funtools framing` (each actor's box on screen and its height share, so a camera can be set to
 // a target's framing without rebuild-and-shoot rounds). Read-only.
@@ -11,7 +11,7 @@
 //     feet), grounded?, flies?, solid? (default true), state?, node? (the scene node's name) }
 // Without it, a Three scene is read instead: named nodes matching the kind words below, boxed from
 // their meshes and sprites as posed now; ground is then not observed.
-// More shapes are read as the same contract (Blue Freight round 3, the owner's build answered a bare
+// More shapes are read as the same contract (one game's round 3, the owner's build answered a bare
 // array with the species in `kind` and no `type`): a bare array or an { id: actor } map; a species or
 // role word in `kind` (crab, townsfolk, npc, drone) read into person | creature | machine with the
 // word kept as `type`; no `type` = `species` | `role` | the id without its number; `flying` = `flies`;
@@ -115,7 +115,7 @@ async (a) => {
   }
 
   // --- the scene fallback: named nodes, boxed as posed now -------------------
-  // The box is the actor's OWN model (Lantern Night, 7 Oct: the hero read 0% tall and counted what it carried):
+  // The box is the actor's OWN model (one game, 7 Oct: the hero read 0% tall and counted what it carried):
   // a node under a person, creature or machine named as a prop (a crate on a cart) is its own prop, and in a
   // rigged model the body is what the skeleton moves, so a static mesh under it (a lantern in a hand) is carried.
   // A skinned mesh is boxed from its vertices through its bones: its geometry's box is the bind pose, and a

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@funpixel/tools",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
-  "description": "funtools — the Funpixel CLI: init, dev, doctor, upgrade, smoke, verify, pack, login and publish.",
+  "description": "funtools \u2014 the Funpixel CLI: init, dev, doctor, upgrade, smoke, verify, pack, login and publish.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "bin": {

package/plugins/README.md

@@ -0,0 +1,16 @@
+# Funpixel GDK
+
+Skills, agents and hooks that help your coding agent make, check and publish browser games with Funpixel.
+
+| Agent | Install |
+|---|---|
+| Claude Code | `npx @funpixel/tools setup --host claude` (the marketplace and the install, from the npm package) |
+| Cursor | from the Cursor marketplace, or see [cursor/README.md](cursor/README.md) |
+| Codex | enable `fp` from your marketplace; see [codex/README.md](codex/README.md) |
+| Kiro CLI | see [kiro/README.md](kiro/README.md) |
+
+Every agent also needs funtools, the kit's CLI: `npm i -g @funpixel/tools`, then `funtools login`.
+
+Docs: https://docs.funpixel.ai · Licence: [LICENSE](LICENSE) · Notices: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)
+
+This repository is built from Funpixel's source and published as is: changes made here are replaced by the next release.

package/plugins/claude/README.md

@@ -3,8 +3,7 @@
 Use Funpixel asset tools, game skills and optional studio workflows in your agent. Build, verify and publish browser games with advisory hooks and project-controlled review.
 
 ```
-claude plugin marketplace add <this repository>
-claude plugin install fp@funpixel
+npx @funpixel/tools setup --host claude   # adds the marketplace from the npm package and installs fp@funpixel
 funtools login   # the plugin's MCP is `funtools mcp`, which signs in with this
 ```
 
@@ -12,4 +11,4 @@ Needs funtools: `npm i -g @funpixel/tools` (the kit's CLI; `npx @funpixel/tools
 
 Commands: `/fp:first-look`, `/fp:flow`, `/fp:lanes`, `/fp:mobile-qa`, `/fp:new`, `/fp:playtest`, `/fp:publish`, `/fp:smoke-build`, `/fp:verify`.
 
-Generated by `funpixel-mono/gdk` (`npm run build`); edit the source there, never this copy.
+This folder is built from Funpixel's source and published as is: changes made here are replaced by the next release.

package/plugins/claude/agents/art-director.md

@@ -22,8 +22,8 @@ whole-game target creation belongs to an unresolved or new-game direction.
    comfort (match the targets' quality, not their density), and framing numbers left to the owner
    (`fp:art`, references/judging-frames.md).
 3. **Generated assets.** The words live in `assets/style.json`: the medium sentence, the palette
-   roles, one isolation clause per asset family. Sets drift when each prompt is free text (The Last
-   Good Robot shipped a whole family at 0% chroma), so a new asset changes the subject or the
+   roles, one isolation clause per asset family. Sets drift when each prompt is free text (one game
+   shipped a whole family at 0% chroma), so a new asset changes the subject or the
    repair and keeps the rest of the words.
 4. **Asset specs.** Before generation, list the assets this task needs and settle the choices that
    change the result. For each: family, role size, the reference it uses, the one-line prompt

package/plugins/claude/commands/playtest.md

@@ -21,7 +21,7 @@ person: it changes nothing in the game, and its steps are suggestions they pick
    seat. Each prompt carries those numbers as facts F1, F2, … to read before the frames (Scenario's
    numbers first, then eyes); the report says which facts each seat cited.
 4. Run every seat now, in parallel in the foreground (a background seat answered after a session
-   had already ended, Lantern Night S3), each as a fresh agent given only the contents of its prompt
+   had already ended, in one game's third session), each as a fresh agent given only the contents of its prompt
    file: one per `seats/<name>.md`, per `versus/<name>.md` and `fidelity/fidelity.md` when printed (and `fidelity/ui.md` from step 5), each a general-purpose
    agent (the `critic` agent's own format would override the prompt's), and the `player` agent with
    `player.md` at phone size. The Mobile QA seat (`mobile/mobile-qa.md`, the `mobile-qa` agent: is
@@ -45,7 +45,7 @@ person: it changes nothing in the game, and its steps are suggestions they pick
    (`.funtools/playtest/history.json`: panel axes, the experience bar, the blind player, minutes of
    real play, fidelity per moment and the AD lines, every round), with each drop marked. When it
    opens with "Look at the captures first", open those frames before trusting any score: a view
-   that never reached its beat is scored as the wrong game (Held Note scored 4.9 on views stuck at
+   that never reached its beat is scored as the wrong game (one game scored 4.9 on views stuck at
    the opening shot, 6.55 once they reached their beats). A thing on the list that is lost is a
    regression: the report leads with it and exits 1, the flow makes putting it back the round's first
    step, and only the owner takes an item off (`playtest keep --drop K<n> --by owner "<their words>"`).

package/plugins/claude/hooks/brief.md

@@ -87,7 +87,7 @@ the demo with your game (`rules.ts`, `session.ts`, `game.ts`, `feel.ts`, `hud.ts
   paths, an environment map (they render flat grey without one), and `mixer.update(dt)` every frame.
 - Pixi: every display object gets a `.label`; `window.__PIXI_APP__ = app` after `app.init()`.
 - Room codes, share codes and seeds carry `data-funpixel-selectable` (else they cannot be copied).
-- `@funpixel/sdk` is pinned exactly (`"0.6.0"`). Import the root only for `setupGameResize`;
+- `@funpixel/sdk` is pinned exactly (`"0.7.0"`). Import the root only for `setupGameResize`;
   everything else from a subpath. Multiplayer is `Room.autoJoin(getGameKey(), …)`, never a raw
   WebSocket (skill `fp:game-spine`).
 - A performance fix changes how a frame is made (pooling, atlases, instancing), never what it shows.

package/plugins/claude/hooks/guidance.json

@@ -1,3 +1,3 @@
 {
-  "hash": "ec92c635aaac1cab"
+  "hash": "47443d9a284e95f9"
 }

package/plugins/claude/hooks/vendor/pipeline/pipeline.mjs

@@ -16,7 +16,7 @@ export const PANEL_DEFAULT = 7.3;
 export const CATALOGUE = {
     pitch: {
         title: 'Invent and pitch',
-        why: 'a game whose answers are generic loses to one that invented something (Gallery Heist A/B, 3 of 3 seats)',
+        why: 'a game whose answers are generic loses to one that invented something (an A/B, 3 of 3 seats)',
         gates: [{ kind: 'gdd', headings: ['The invention'] }, { kind: 'studio' }, { kind: 'worth' }],
         rules: [
             'Answer the six forcing questions for THIS game in the GDD\'s `## The invention`: what the core object means, why the verb exists in this world, who wants what (names), what the twist costs, the one system that lives, what only this game has. A generic answer means the idea is not there yet.',
@@ -71,20 +71,20 @@ export const CATALOGUE = {
     },
     'first-look': {
         title: 'First look',
-        why: 'identity drifts between frames unless it is locked first (Blue Freight: 7 of 7 redraws on-model with reference sheets)',
+        why: 'identity drifts between frames unless it is locked first (one game: 7 of 7 redraws on-model with reference sheets)',
         gates: [{ kind: 'refs', min: 1 }, { kind: 'targets', min: 4 }, { kind: 'kit' }, { kind: 'set' }],
         rules: [
             `The whole game, not a few frames (owner, 4 Oct, asked twice): key art; every screen (the title as the play world, pause, the end; past small settings, results, a level select); the HUD on the phone and the desktop; a frame per place, each tied to a story beat; a living-world sheet; an animation board; a juice board; the sound list; the fun page. \`${T} firstlook\` lists what is missing; places and the living world only for a world game.`,
             'Reference sheets (identity lock) BEFORE moment frames; every recurring design drawn with its references and one verbatim style block.',
             'A target frame per hook moment at the play framing (desktop 1280x720, phone held sideways 852x393).',
-            `The world's kit beside the hero: sheets of its made parts (structures, ground, props, the living cast), cut into pieces before the slice (\`${T} cut\`); the slice is built from them, never from plain shapes (a fresh Blue Freight build shipped code-drawn primitives until the owner's note).`,
+            `The world's kit beside the hero: sheets of its made parts (structures, ground, props, the living cast), cut into pieces before the slice (\`${T} cut\`); the slice is built from them, never from plain shapes (a fresh build shipped code-drawn primitives until the owner's note).`,
             'A picture of every place; no two places alike in shape, material, era and light.',
             'The HUD mockup drawn over a target frame.',
         ],
     },
     'core-test': {
         title: 'Core test (A1): the game bites',
-        why: 'both Blue Freight builds spent their rounds on looks and the challenge never bit ("no challenges at all")',
+        why: 'both builds of one game spent their rounds on looks and the challenge never bit ("no challenges at all")',
         gates: [{ kind: 'tests' }, { kind: 'sim' }],
         rules: [
             `The GDD's named bots play the REAL level (\`${T} sim\`): an engine-free, fixed-step, seeded sim, plus a replay test.`,
@@ -119,7 +119,7 @@ export const CATALOGUE = {
     },
     expand: {
         title: 'Expand, room by room',
-        why: 'our real games are 10 to 18 minutes of designed play, grown room by room from a slice that passed (Gallery Heist: "nothing in Rooms 2-6 starts until the slice passes its gates")',
+        why: 'our real games are 10 to 18 minutes of designed play, grown room by room from a slice that passed (one plan: "nothing in Rooms 2-6 starts until the slice passes its gates")',
         gates: [{ kind: 'rooms' }],
         rules: [
             `Slice first: a room is opened for building only once the room before it passes (\`${T} rooms open <id>\`); the owner alone releases one early (\`--by owner\`).`,
@@ -162,7 +162,7 @@ export const CATALOGUE = {
     },
     'blind-play': {
         title: 'Blind play from the title',
-        why: 'blind players from the title found the blockers no panel could (Held Note)',
+        why: 'blind players from the title found the blockers no panel could',
         gates: [{ kind: 'play' }, { kind: 'sim' }],
         rules: [
             `A blind player from the title, no instructions (\`${T} play\`): a stall counts as blocking.`,

package/plugins/claude/hooks/vendor/studio/pitch.mjs

@@ -51,7 +51,7 @@ export const CATALOGUE = [
             { id: 'cutscenes', label: 'Cutscenes', why: 'one earned cinematic (the ending, a reveal), skippable', cost: '$1–3 each, plus a scene to stage' },
             { id: 'photo', label: 'Photo mode', why: 'players share the wow moments; the share card carries the game', cost: 'a free camera, a frame and a share sheet: about a day' },
             { id: 'multiplayer', label: 'Multiplayer', why: 'friends in one room through the relay', cost: 'doubles the test work; the host owns the world state' },
-            { id: 'two-takes', label: 'Two takes', why: 'for a deep game: two parallel builds of the same locked plan, each winning different areas (one the environment, one the dynamics); `funtools compare-takes` plays both from the title and writes a best-of-both table, and the mix beats both (Blue Freight, 3 rounds)', cost: 'twice the build sessions, plus a merge round' },
+            { id: 'two-takes', label: 'Two takes', why: 'for a deep game: two parallel builds of the same locked plan, each winning different areas (one the environment, one the dynamics); `funtools compare-takes` plays both from the title and writes a best-of-both table, and the mix beats both (one game, 3 rounds)', cost: 'twice the build sessions, plus a merge round' },
             { id: 'none', label: 'None', why: 'everything goes into the core' },
         ],
     },

package/plugins/claude/skills/3d/references/bake-off.md

@@ -1,7 +1,7 @@
 # The model bake-off: several candidates, one judged against the master
 
-Held Note tried its hero three ways (three providers' takes of the same front picture) and picked
-from turntable sheets; Gallery Heist made two to four models of each crew member before one held.
+One game tried its hero three ways (three providers' takes of the same front picture) and picked
+from turntable sheets; another made two to four models of each crew member before one held.
 A model is the most expensive asset a game makes, and the first one is rarely the keeper. The
 bake-off makes the choice cheap to see and puts it on record.
 
@@ -41,7 +41,7 @@ never before (step 5 of the skill).
 
 ## What it showed on real files
 
-On Held Note's own models, rendered by the bench: each prop's model was ranked first against its own
+On the first game's own models, rendered by the bench: each prop's model was ranked first against its own
 reference picture, by 0.03 to 0.13 over the next (crate, door, lockers, canister, bell); the three
 providers' takes of the hero scored within 0.03 of each other, and well above any prop. The team
 kept the Rodin take for reasons a silhouette cannot see (triangle budget, separable limbs). That is

package/plugins/claude/skills/3d/references/characters.md

@@ -44,7 +44,7 @@ pins up to 8 colours. It changes the paint, not the shape: a knight is not a res
 
 ## When the game poses its own skeleton
 
-Held Note (a three.js horror game, 29 Sep 2026) posed a code skeleton from its sim every frame, and
+A three.js horror game (29 Sep 2026) posed a code skeleton from its sim every frame, and
 its enemies lose limbs, so neither the library nor an auto-rig fit: their bones carry their own
 names, rolls and rest rotations, and none splits a body for severing. What it did instead, run in
 local Blender:

package/plugins/claude/skills/3d/references/hero-route.md

@@ -4,10 +4,10 @@ The default path for every hero of a 3D game: the player, the rivals, the bosses
 prop the player stares at. A choice the person locked (a code-built toy style, a budget of zero
 credits, a library character) overrides it. Environment and background may stay procedural.
 
-Why it exists: Saltwake, a phone racer, was offered `generate_3d_model` in three creator rounds
+Why it exists: a phone racer was offered `generate_3d_model` in three creator rounds
 and never called it. Its boats and world were boxes, cones and extrusions; stills of tidy
 primitives read as a style, and the blind panel scored the look above 7 while the owner saw "a
-shapes game". Fold Room, rooms of code geometry, reached 7.28 against Monument Valley 2's 8.60.
+shapes game". Another game, rooms of code geometry, reached 7.28 against Monument Valley 2's 8.60.
 
 ## Declared, proven, or named
 
@@ -40,7 +40,7 @@ numbered fact. Three honest states for a code-built hero:
    ([levels.md](levels.md)): 300K triangles on Meshy 7.1 (the default engine, 2048 px maps,
    about 160 credits), 500K faces and 4096 px PNG maps with `engine: "hunyuan"` (about 135), or
    500K triangles and 4096 px PBR maps with `engine: "rodin"` (about 240; the hard-surface take:
-   Held Note kept Rodin's crate, door, lockers and bell). A rigged hero stays `standard`, and
+   one game kept Rodin's crate, door, lockers and bell). A rigged hero stays `standard`, and
    never Rodin (it has no rig).
 
    Rodin 2.5 (`engine: "rodin"`) runs only when named and never falls back: static only (with
@@ -51,12 +51,12 @@ numbered fact. Three honest states for a code-built hero:
    `raw: true`: the engine's file untouched (the optimized copy clamps maps to 1024 px), then
    cut it to the device yourself. `npx @funpixel/tools gen model3d --image-asset front.png
    --back-asset back.png --style hero --engine hunyuan --raw` does all of it from the CLI.
-   **Fidelity against the views** (dont-die's Corer, 10 Oct 2026, `npx @funpixel/tools fidelity`):
+   **Fidelity against the views** (one game's hero, 10 Oct 2026, `npx @funpixel/tools fidelity`):
    from one view the model is a slab whose end views score ~46%; four views (front, back, both
    ends) fix the depth. Projecting the views onto the mesh was the largest single gain (a profile
    84 → 91%), and generation plus projection plateaued near 73% (Hunyuan from four views 72.8%,
    Meshy hero 73.3%: Meshy keeps profiles sharper, Hunyuan the ends). Check the views agree
-   first: `fidelity` names views no one object can match (the Corer's drawings drew the drum two
+   first: `fidelity` names views no one object can match (the hero's drawings drew the drum two
    sizes, which capped even a hand-built mesh at ~74%). For 95% (reached, 95.0% mean), the studio
    order: block the shape in Blender from primitives measured off the views (6.4K faces); render
    the plain mesh in four orthographic views; `gen edit` each render into a paintover in the house

package/plugins/claude/skills/3d/references/level-spec.md

@@ -93,7 +93,7 @@ A heist in a two-room cottage with a garden:
 ## Common mistakes
 
 - Colliding against the art: a character snags on every table leg and falls through foliage.
-- Colliders for the hero but not the camera: Held Note's shoulder camera entered walls six
+- Colliders for the hero but not the camera: one game's shoulder camera entered walls six
   times in one blind phone run and lost her; cast it against the walls and planes at the kit's faces.
 - Dressing before walking the blockout: every prop moved twice.
 - A marker the code asks for that the spec never declared.