@playus.club/games-sdk 0.1.0

package/dist/sdk/tap-to-start.d.ts

@@ -0,0 +1,19 @@
+import { type Language } from './i18n';
+import { type TouchHintType } from './overlay/touch-hint';
+export type TapToStartMode = 'dismiss-only' | 'pass-first-input';
+export type LocalizedText = string | Partial<Record<Language, string>>;
+export type TapToStartOverlay = {
+    show: () => void;
+    hide: () => void;
+    destroy: () => void;
+};
+type TapToStartOptions = {
+    parent?: HTMLElement;
+    text?: LocalizedText;
+    touchHint?: TouchHintType | false;
+    mode?: TapToStartMode;
+    onStart: (event: PointerEvent) => void;
+};
+export declare function createTapToStartOverlay(options: TapToStartOptions): TapToStartOverlay;
+export {};
+//# sourceMappingURL=tap-to-start.d.ts.map

package/dist/sdk/tap-to-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-to-start.d.ts","sourceRoot":"","sources":["../../src/playus/tap-to-start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,kBAAkB,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC;IAClC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CA2DrF"}

package/dist/sdk/three/canvas.d.ts

@@ -0,0 +1,13 @@
+import { type BackgroundConfig } from '../types/background';
+export type ThreeCanvasOptions = {
+    aspectRatio?: number;
+    background?: BackgroundConfig;
+};
+export declare function createThreeCanvas(options?: ThreeCanvasOptions): HTMLCanvasElement;
+export declare function getThreeRendererOptions(background?: BackgroundConfig): {
+    alpha: boolean;
+    antialias: boolean;
+    powerPreference: "high-performance";
+    preserveDrawingBuffer: boolean;
+};
+//# sourceMappingURL=canvas.d.ts.map

package/dist/sdk/three/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../src/playus/three/canvas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAqC,MAAM,qBAAqB,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAwCrF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,gBAAgB;;;;;EAOpE"}

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

@@ -0,0 +1,3 @@
+export { createThreeCanvas, getThreeRendererOptions } from './canvas';
+export type { ThreeCanvasOptions } from './canvas';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/playus/three/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/sdk/three.js

@@ -0,0 +1,36 @@
+import { i as e, n as t, o as n, r } from "./chunks/background-DLy8kjVf.js";
+//#region src/playus/three/canvas.ts
+function i(r = {}) {
+	let i = r.aspectRatio ?? 1.6, a = t(r.background), o = document.createElement("div");
+	o.id = "game-root", Object.assign(o.style, {
+		position: "fixed",
+		inset: "0",
+		display: "grid",
+		placeItems: "center",
+		background: a ?? "transparent"
+	}), e(o), document.body.appendChild(o);
+	let s = document.createElement("div");
+	s.id = "game-viewport", Object.assign(s.style, {
+		width: `min(100vw, calc(100vh / ${i}))`,
+		aspectRatio: `${1 / i}`,
+		position: "relative",
+		overflow: "hidden",
+		background: a ?? "transparent"
+	}), e(s), o.appendChild(s);
+	let c = document.createElement("canvas");
+	return c.id = "gameCanvas", Object.assign(c.style, {
+		width: "100%",
+		height: "100%",
+		display: "block"
+	}), e(c), n(c), s.appendChild(c), c;
+}
+function a(e) {
+	return {
+		alpha: r(e),
+		antialias: !0,
+		powerPreference: "high-performance",
+		preserveDrawingBuffer: !1
+	};
+}
+//#endregion
+export { i as createThreeCanvas, a as getThreeRendererOptions };

package/dist/sdk/timing.d.ts

@@ -0,0 +1,4 @@
+export declare const MAX_GAMEPLAY_DELTA_MS = 150;
+export declare function clampGameplayDeltaMs(deltaMs: number): number;
+export declare function clampGameplayDeltaSeconds(deltaSeconds: number): number;
+//# sourceMappingURL=timing.d.ts.map

package/dist/sdk/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/playus/timing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGtE"}

package/dist/sdk/types/background.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Background configuration for games
+ *
+ * Games run in iOS WKWebView where transparent backgrounds let the native
+ * iOS UI show through. When a game doesn't need transparency, using a solid
+ * color can provide minor performance improvements by skipping alpha blending.
+ *
+ * @example
+ * // Transparent (default) - iOS native background shows through
+ * { transparent: true }
+ *
+ * // Solid color - minor performance optimization
+ * { transparent: false, color: '#1a1a2e' }
+ */
+export type BackgroundConfig = {
+    transparent: true;
+} | {
+    transparent: false;
+    color: string;
+};
+/**
+ * Default: transparent background for iOS native show-through
+ */
+export declare const DEFAULT_BACKGROUND: BackgroundConfig;
+/**
+ * Check if a background config is transparent
+ */
+export declare function isTransparent(config?: BackgroundConfig): boolean;
+/**
+ * Get background color (returns undefined for transparent)
+ */
+export declare function getBackgroundColor(config?: BackgroundConfig): string | undefined;
+//# sourceMappingURL=background.d.ts.map

package/dist/sdk/types/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/playus/types/background.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,WAAW,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAwC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAGhF"}

package/dist/sdk/url-params.d.ts

@@ -0,0 +1,5 @@
+export declare function getUrlParam(name: string): string | null;
+export declare function getGameSeed(options?: {
+    includePlayContext?: boolean;
+}): string | undefined;
+//# sourceMappingURL=url-params.d.ts.map

package/dist/sdk/url-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-params.d.ts","sourceRoot":"","sources":["../../src/playus/url-params.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvD;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAU1F"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@playus.club/games-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dappsltd/playus-games-sdk.git"
+  },
+  "homepage": "https://github.com/dappsltd/playus-games-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/dappsltd/playus-games-sdk/issues"
+  },
+  "description": "Playus games SDK: native bridge, host handshake, sounds, haptics, overlays, seeded random, and engine helpers for Playus-compatible web game bundles.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "author": "Dapps Pte Ltd (https://dapps.ltd)",
+  "files": [
+    "dist/sdk",
+    "src/playus/*.css",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js"
+    },
+    "./phaser": {
+      "types": "./dist/sdk/phaser/index.d.ts",
+      "import": "./dist/sdk/phaser.js"
+    },
+    "./babylon": {
+      "types": "./dist/sdk/babylon/index.d.ts",
+      "import": "./dist/sdk/babylon.js"
+    },
+    "./three": {
+      "types": "./dist/sdk/three/index.d.ts",
+      "import": "./dist/sdk/three.js"
+    },
+    "./overlay": {
+      "types": "./dist/sdk/overlay/index.d.ts",
+      "import": "./dist/sdk/overlay.js"
+    },
+    "./styles.css": "./src/playus/styles.css",
+    "./fonts.css": "./src/playus/fonts.css",
+    "./global.css": "./src/playus/global.css"
+  },
+  "scripts": {
+    "prepublishOnly": "npm run build:sdk",
+    "dev": "vite --host --port 8091",
+    "dev:starter": "vite games/starter-game --config vite.config.ts --host --port 8090 --strictPort",
+    "dev:phaser": "vite games/phaser-example --config vite.config.ts --host --port 8090 --strictPort",
+    "dev:babylon": "vite games/babylon-example --config vite.config.ts --host --port 8090 --strictPort",
+    "build:sdk": "vite build --config vite.sdk.config.ts && tsc -p tsconfig.sdk.json",
+    "build": "tsc --noEmit && npm run build:sdk && vite build --outDir dist/tester && vite build games/starter-game --config vite.config.ts --outDir ../../dist/games/starter-game --emptyOutDir false && vite build games/phaser-example --config vite.config.ts --outDir ../../dist/games/phaser-example --emptyOutDir false && vite build games/babylon-example --config vite.config.ts --outDir ../../dist/games/babylon-example --emptyOutDir false",
+    "preview": "vite preview --host --port 4173"
+  },
+  "peerDependencies": {
+    "@babylonjs/core": "^8.31.2",
+    "phaser": "^3.80.0"
+  },
+  "peerDependenciesMeta": {
+    "@babylonjs/core": {
+      "optional": true
+    },
+    "phaser": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babylonjs/core": "^8.31.2",
+    "phaser": "^3.80.0",
+    "typescript": "^5.9.2",
+    "vite": "^8.1.0"
+  }
+}

package/src/playus/fonts.css

@@ -0,0 +1,29 @@
+@font-face {
+  font-family: "Unbounded";
+  src: url("native://fonts/Unbounded.woff2") format("woff2"),
+       url("native://fonts/Unbounded.ttf") format("truetype"),
+       url("https://pub-f2838cca4376431f9c696446d4a3e503.r2.dev/fonts/Unbounded.woff2") format("woff2");
+  font-style: normal;
+  font-weight: 400 900;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: "Space Grotesk";
+  src: url("native://fonts/SpaceGrotesk.woff2") format("woff2"),
+       url("native://fonts/SpaceGrotesk.ttf") format("truetype"),
+       url("https://pub-f2838cca4376431f9c696446d4a3e503.r2.dev/fonts/SpaceGrotesk.woff2") format("woff2");
+  font-style: normal;
+  font-weight: 300 800;
+  font-display: block;
+}
+
+@font-face {
+  font-family: "Quicksand";
+  src: url("native://fonts/Quicksand.woff2") format("woff2"),
+       url("native://fonts/Quicksand.ttf") format("truetype"),
+       url("https://pub-f2838cca4376431f9c696446d4a3e503.r2.dev/fonts/Quicksand.woff2") format("woff2");
+  font-style: normal;
+  font-weight: 300 700;
+  font-display: swap;
+}

package/src/playus/global.css

@@ -0,0 +1,14 @@
+html,
+body {
+  height: 100%;
+  margin: 0;
+  -webkit-user-select: none;
+  user-select: none;
+  -webkit-touch-callout: none;
+  touch-action: manipulation;
+  overscroll-behavior: contain;
+}
+
+canvas:focus {
+  outline: none;
+}

package/src/playus/styles.css

@@ -0,0 +1,61 @@
+@import "./fonts.css";
+@import "./global.css";
+
+:root {
+  color-scheme: dark;
+  font-family: "Space Grotesk", "Inter", system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  background: #121214;
+  color: #ffffff;
+}
+
+* {
+  box-sizing: border-box;
+  -webkit-tap-highlight-color: transparent;
+}
+
+html,
+body {
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  overflow: hidden;
+  user-select: none;
+  touch-action: none;
+}
+
+button,
+input,
+select {
+  font: inherit;
+}
+
+.playus-game-root {
+  position: fixed;
+  inset: 0;
+  overflow: hidden;
+  background: #17171d;
+}
+
+.playus-tap-start {
+  position: fixed;
+  inset: 0;
+  z-index: 50;
+  display: grid;
+  place-items: center;
+  padding: 28px;
+  background: rgba(0, 0, 0, 0.7);
+}
+
+.playus-tap-start[hidden] {
+  display: none;
+}
+
+.playus-tap-start__label {
+  max-width: 80%;
+  text-align: center;
+  color: #ffffff;
+  font-family: "Unbounded", "Space Grotesk", system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-size: min(5vh, 6vw);
+  font-weight: 700;
+  line-height: 1.12;
+}