@rydr/game-sdk 8.11.0 → 8.12.0

package/dist/three/controller/glyph-texture.js

@@ -0,0 +1,68 @@
+/**
+ * GLYPH TEXTURES — the letters printed on a 3D pad's buttons (`A`, `B`, `X`, `Y`, `−`, `+`, `ZL`…),
+ * drawn into a canvas at runtime and used as a texture.
+ *
+ * **Why not 3D text?** Because this SDK ships no non-TS assets (`files: ["dist"]`, every drawing in the
+ * kit is generated from code), and real 3D text means a font file — `TextGeometry` needs a typeface
+ * JSON, and an `SDF`/MSDF atlas is an image. Both would be the first binary in the package. A canvas
+ * texture keeps the rule intact, costs one small draw per distinct glyph, and looks the same as the
+ * flat pad's lettering because it *is* the same: `2d` canvas text in the host's own font stack.
+ *
+ * Textures are cached by their full appearance key, so the eight buttons of a Joy-Con pair cost eight
+ * canvases once and zero per frame — and a pad rebuilt on a controller swap reuses them.
+ */
+import * as THREE from "three";
+/** Texture edge, in pixels. Power-of-two keeps mipmapping happy; 128 is plenty for one or two chars. */
+const SIZE = 128;
+const CACHE = new Map();
+/**
+ * A transparent texture with `text` centred on it, in `color`.
+ *
+ * Short strings only — one or two characters. A trigger's `ZL` is the longest thing that lands here,
+ * and the font shrinks for a second character so both stay inside the circle.
+ */
+export function glyphTexture(text, color = "#eaf2ff") {
+    const key = `${text}|${color}`;
+    const hit = CACHE.get(key);
+    if (hit)
+        return hit;
+    // No DOM (a Node build step, an SSR pass, a test): hand back an empty texture rather than throwing.
+    // The pad still builds; it just carries no lettering, which is the right failure for a decoration.
+    if (typeof document === "undefined") {
+        const blank = new THREE.Texture();
+        CACHE.set(key, blank);
+        return blank;
+    }
+    const canvas = document.createElement("canvas");
+    canvas.width = SIZE;
+    canvas.height = SIZE;
+    const ctx = canvas.getContext("2d");
+    if (ctx) {
+        // Two characters ("ZL") need to fit the same circle one does, so the size steps down rather than
+        // letting the glyph run over the button's edge.
+        const px = text.length > 1 ? SIZE * 0.42 : SIZE * 0.62;
+        ctx.font = `600 ${px}px system-ui, -apple-system, "Segoe UI", sans-serif`;
+        ctx.fillStyle = color;
+        ctx.textAlign = "center";
+        ctx.textBaseline = "middle";
+        // Nudged down a hair: `textBaseline: middle` sits optically high for capitals and digits.
+        ctx.fillText(text, SIZE / 2, SIZE * 0.54);
+    }
+    const tex = new THREE.CanvasTexture(canvas);
+    tex.colorSpace = THREE.SRGBColorSpace;
+    tex.anisotropy = 4;
+    CACHE.set(key, tex);
+    return tex;
+}
+/**
+ * Drop every cached glyph texture and free its GPU memory.
+ *
+ * The cache is process-wide and tiny, so a pad renderer must NOT call this on dispose — a second pad on
+ * the page would lose the textures out from under it. It exists for a host tearing the whole kit down.
+ */
+export function clearGlyphTextureCache() {
+    for (const tex of CACHE.values())
+        tex.dispose();
+    CACHE.clear();
+}
+//# sourceMappingURL=glyph-texture.js.map

package/dist/three/controller/glyph-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyph-texture.js","sourceRoot":"","sources":["../../../src/three/controller/glyph-texture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,wGAAwG;AACxG,MAAM,IAAI,GAAG,GAAG,CAAC;AAEjB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAK,GAAG,SAAS;IAC1D,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,oGAAoG;IACpG,mGAAmG;IACnG,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAA4B,CAAC,CAAC;QAC7C,OAAO,KAA4B,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,EAAE,CAAC;QACR,iGAAiG;QACjG,gDAAgD;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACvD,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,qDAAqD,CAAC;QAC1E,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;QACtB,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC;QACzB,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC5B,0FAA0F;QAC1F,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC;IACtC,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAChD,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/three/controller/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The 3D controller — a Joy-Con pair drawn in three.js, usable anywhere the flat pad goes.
+ *
+ * See `three-pad-renderer.ts` for the entry point (`createThreePadRenderer`) and `joycon-model.ts` for
+ * how the model is derived from the same layout table the flat drawing uses.
+ */
+export * from "./glyph-texture.js";
+export * from "./three-pad-renderer.js";
+export * from "./joycon-spec.js";
+export * from "./joycon-shoulder-mesh.js";
+export * from "./joycon-designs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/three/controller/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/three/controller/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}

package/dist/three/controller/index.js

@@ -0,0 +1,12 @@
+/**
+ * The 3D controller — a Joy-Con pair drawn in three.js, usable anywhere the flat pad goes.
+ *
+ * See `three-pad-renderer.ts` for the entry point (`createThreePadRenderer`) and `joycon-model.ts` for
+ * how the model is derived from the same layout table the flat drawing uses.
+ */
+export * from "./glyph-texture.js";
+export * from "./three-pad-renderer.js";
+export * from "./joycon-spec.js";
+export * from "./joycon-shoulder-mesh.js";
+export * from "./joycon-designs.js";
+//# sourceMappingURL=index.js.map

package/dist/three/controller/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/three/controller/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}

package/dist/three/controller/joycon-designs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * THREE ART DIRECTIONS for the 3D Joy-Con, to be chosen between by eye.
+ *
+ * All three are built from the same {@link joycon-spec} numbers — real hardware proportions, real
+ * control placement — so what differs between them is **only** the art direction: shape language,
+ * materials, lighting response, level of detail. Same model, three ways of drawing it.
+ *
+ *   {@link buildProductJoycon}   "Product" — what the hardware looks like. Neon red / neon blue,
+ *                                 domed buttons, dished stick caps, visible rail. Most faithful.
+ *   {@link buildToyJoycon}       "Toy" — chunkier, flatter colour, oversized controls, matte. Built to
+ *                                 be read from across a room, which is the actual use case.
+ *   {@link buildHoloJoycon}      "Holo" — translucent shell with lit edges and emissive controls, in
+ *                                 the SDK's own accent language. Reads as UI rather than as an object.
+ *
+ * Each returns a `JoyconBuild`: the group to add to a scene, plus the per-control nodes a driver would
+ * later need, plus everything to dispose. None of them is wired to input yet — that comes once one is
+ * picked.
+ */
+import * as THREE from "three";
+export interface JoyconBuild {
+    group: THREE.Group;
+    /** Every pressable node, by a stable key — what a driver will light once a design is chosen. */
+    controls: Map<string, THREE.Object3D>;
+    /** Stick pivots, tilted to lean the cap. */
+    sticks: {
+        l?: THREE.Group;
+        r?: THREE.Group;
+    };
+    disposables: {
+        dispose(): void;
+    }[];
+}
+export type JoyconDesignId = "product" | "toy" | "holo";
+export interface JoyconDesign {
+    id: JoyconDesignId;
+    name: string;
+    /** One line on what this direction is trying to be — shown under each pad in the showcase. */
+    note: string;
+    build(): JoyconBuild;
+    /** Lighting is part of the art direction, so each design brings its own. */
+    light(scene: THREE.Scene): void;
+    /** Backdrop behind the pad in the showcase, as a CSS colour. */
+    backdrop: string;
+}
+export declare function buildProductJoycon(): JoyconBuild;
+export declare function buildToyJoycon(): JoyconBuild;
+export declare function buildHoloJoycon(): JoyconBuild;
+export declare const JOYCON_DESIGNS: readonly JoyconDesign[];
+//# sourceMappingURL=joycon-designs.d.ts.map

package/dist/three/controller/joycon-designs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joycon-designs.d.ts","sourceRoot":"","sources":["../../../src/three/controller/joycon-designs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,gGAAgG;IAChG,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtC,4CAA4C;IAC5C,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;QAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAA;KAAE,CAAC;IAC7C,WAAW,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,cAAc,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,WAAW,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAChC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqpBD,wBAAgB,kBAAkB,IAAI,WAAW,CAgBhD;AAID,wBAAgB,cAAc,IAAI,WAAW,CA0B5C;AAMD,wBAAgB,eAAe,IAAI,WAAW,CA4C7C;AAID,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAgEjD,CAAC"}