@al8b/player 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,19 @@
+$ tsup
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/l8b/l8b/packages/core/player/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+CJS Build start
+ESM Build start
+CJS dist/index.js     2.53 KB
+CJS dist/index.js.map 2.84 KB
+CJS ⚡️ Build success in 78ms
+ESM dist/index.mjs     1.56 KB
+ESM dist/index.mjs.map 2.70 KB
+ESM ⚡️ Build success in 77ms
+DTS Build start
+DTS ⚡️ Build success in 4112ms
+DTS dist/index.d.ts  1.17 KB
+DTS dist/index.d.mts 1.17 KB

package/.turbo/turbo-test.log

@@ -0,0 +1,9 @@
+$ vitest run --passWithNoTests
+
+ RUN  v4.1.2 /home/runner/work/l8b/l8b/packages/core/player
+
+No test files found, exiting with code 0
+
+include: **/*.{test,spec}.?(c|m)[jt]s?(x)
+exclude:  **/node_modules/**, **/.git/**
+

package/README.md

@@ -0,0 +1,21 @@
+# @al8b/player
+
+Player control bridge for L8B. It exposes the runtime-to-host lifecycle hooks used by game code for pause/resume, performance settings, and outbound messages.
+
+## Public API
+
+- `PlayerService`
+- Type: `PlayerDelegate`
+
+## Notes
+
+- Consumed by `@al8b/runtime` to build the script-facing `player.*` API.
+- This package is intentionally small and host-integration focused.
+
+## Scripts
+
+```bash
+bun run build
+bun run test
+bun run clean
+```

package/dist/index.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Delegate interface for PlayerService.
+ *
+ * The orchestrator provides concrete implementations of these callbacks
+ * so the PlayerService stays decoupled from runtime internals.
+ */
+interface PlayerDelegate {
+    /** Pause the game loop */
+    pause: () => void;
+    /** Resume the game loop */
+    resume: () => void;
+    /** Send an arbitrary message to the host application */
+    postMessage: (message: any) => void;
+    /** Get current FPS */
+    getFps: () => number;
+    /** Get target update rate (Hz) */
+    getUpdateRate: () => number;
+    /** Set target update rate (Hz) */
+    setUpdateRate: (rate: number) => void;
+}
+
+/**
+ * PlayerService - Controls player UX from LootiScript
+ *
+ * Provides game scripts with the ability to control the player lifecycle
+ * (quit, pause, resume, exit), adjust performance (fps, update_rate),
+ * and communicate with the host application (postMessage).
+ */
+
+declare class PlayerService {
+    private delegate;
+    private interfaceCache;
+    constructor(delegate: PlayerDelegate);
+    /**
+     * Get interface for game code (LootiScript `player.*`)
+     */
+    getInterface(): Record<string, any>;
+}
+
+export { type PlayerDelegate, PlayerService };

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Delegate interface for PlayerService.
+ *
+ * The orchestrator provides concrete implementations of these callbacks
+ * so the PlayerService stays decoupled from runtime internals.
+ */
+interface PlayerDelegate {
+    /** Pause the game loop */
+    pause: () => void;
+    /** Resume the game loop */
+    resume: () => void;
+    /** Send an arbitrary message to the host application */
+    postMessage: (message: any) => void;
+    /** Get current FPS */
+    getFps: () => number;
+    /** Get target update rate (Hz) */
+    getUpdateRate: () => number;
+    /** Set target update rate (Hz) */
+    setUpdateRate: (rate: number) => void;
+}
+
+/**
+ * PlayerService - Controls player UX from LootiScript
+ *
+ * Provides game scripts with the ability to control the player lifecycle
+ * (quit, pause, resume, exit), adjust performance (fps, update_rate),
+ * and communicate with the host application (postMessage).
+ */
+
+declare class PlayerService {
+    private delegate;
+    private interfaceCache;
+    constructor(delegate: PlayerDelegate);
+    /**
+     * Get interface for game code (LootiScript `player.*`)
+     */
+    getInterface(): Record<string, any>;
+}
+
+export { type PlayerDelegate, PlayerService };

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PlayerService: () => PlayerService
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/player-service.ts
+var PlayerService = class {
+  static {
+    __name(this, "PlayerService");
+  }
+  delegate;
+  interfaceCache = null;
+  constructor(delegate) {
+    this.delegate = delegate;
+  }
+  /**
+  * Get interface for game code (LootiScript `player.*`)
+  */
+  getInterface() {
+    if (this.interfaceCache) {
+      return this.interfaceCache;
+    }
+    const iface = {
+      pause: /* @__PURE__ */ __name(() => this.delegate.pause(), "pause"),
+      resume: /* @__PURE__ */ __name(() => this.delegate.resume(), "resume"),
+      postMessage: /* @__PURE__ */ __name((message) => this.delegate.postMessage(message), "postMessage"),
+      setFps: /* @__PURE__ */ __name((fps) => {
+        if (typeof fps === "number" && isFinite(fps) && fps > 0) {
+          this.delegate.setUpdateRate(fps);
+        }
+      }, "setFps")
+    };
+    Object.defineProperty(iface, "fps", {
+      get: /* @__PURE__ */ __name(() => this.delegate.getFps(), "get"),
+      enumerable: true
+    });
+    Object.defineProperty(iface, "update_rate", {
+      get: /* @__PURE__ */ __name(() => this.delegate.getUpdateRate(), "get"),
+      set: /* @__PURE__ */ __name((value) => {
+        if (typeof value === "number" && isFinite(value) && value > 0) {
+          this.delegate.setUpdateRate(value);
+        }
+      }, "set"),
+      enumerable: true
+    });
+    this.interfaceCache = iface;
+    return this.interfaceCache;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PlayerService
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/player-service.ts"],"sourcesContent":["export { PlayerService } from \"./player-service\";\nexport type { PlayerDelegate } from \"./types\";\n","/**\n * PlayerService - Controls player UX from LootiScript\n *\n * Provides game scripts with the ability to control the player lifecycle\n * (quit, pause, resume, exit), adjust performance (fps, update_rate),\n * and communicate with the host application (postMessage).\n */\n\nimport type { PlayerDelegate } from \"./types\";\n\nexport class PlayerService {\n\tprivate delegate: PlayerDelegate;\n\tprivate interfaceCache: Record<string, any> | null = null;\n\n\tconstructor(delegate: PlayerDelegate) {\n\t\tthis.delegate = delegate;\n\t}\n\n\t/**\n\t * Get interface for game code (LootiScript `player.*`)\n\t */\n\tgetInterface(): Record<string, any> {\n\t\tif (this.interfaceCache) {\n\t\t\treturn this.interfaceCache;\n\t\t}\n\n\t\tconst iface: Record<string, any> = {\n\t\t\tpause: () => this.delegate.pause(),\n\t\t\tresume: () => this.delegate.resume(),\n\t\t\tpostMessage: (message: any) => this.delegate.postMessage(message),\n\t\t\tsetFps: (fps: number) => {\n\t\t\t\tif (typeof fps === \"number\" && isFinite(fps) && fps > 0) {\n\t\t\t\t\tthis.delegate.setUpdateRate(fps);\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\n\t\tObject.defineProperty(iface, \"fps\", {\n\t\t\tget: () => this.delegate.getFps(),\n\t\t\tenumerable: true,\n\t\t});\n\n\t\tObject.defineProperty(iface, \"update_rate\", {\n\t\t\tget: () => this.delegate.getUpdateRate(),\n\t\t\tset: (value: number) => {\n\t\t\t\tif (typeof value === \"number\" && isFinite(value) && value > 0) {\n\t\t\t\t\tthis.delegate.setUpdateRate(value);\n\t\t\t\t}\n\t\t\t},\n\t\t\tenumerable: true,\n\t\t});\n\n\t\tthis.interfaceCache = iface;\n\t\treturn this.interfaceCache;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACUO,IAAMA,gBAAN,MAAMA;EAVb,OAUaA;;;EACJC;EACAC,iBAA6C;EAErD,YAAYD,UAA0B;AACrC,SAAKA,WAAWA;EACjB;;;;EAKAE,eAAoC;AACnC,QAAI,KAAKD,gBAAgB;AACxB,aAAO,KAAKA;IACb;AAEA,UAAME,QAA6B;MAClCC,OAAO,6BAAM,KAAKJ,SAASI,MAAK,GAAzB;MACPC,QAAQ,6BAAM,KAAKL,SAASK,OAAM,GAA1B;MACRC,aAAa,wBAACC,YAAiB,KAAKP,SAASM,YAAYC,OAAAA,GAA5C;MACbC,QAAQ,wBAACC,QAAAA;AACR,YAAI,OAAOA,QAAQ,YAAYC,SAASD,GAAAA,KAAQA,MAAM,GAAG;AACxD,eAAKT,SAASW,cAAcF,GAAAA;QAC7B;MACD,GAJQ;IAKT;AAEAG,WAAOC,eAAeV,OAAO,OAAO;MACnCW,KAAK,6BAAM,KAAKd,SAASe,OAAM,GAA1B;MACLC,YAAY;IACb,CAAA;AAEAJ,WAAOC,eAAeV,OAAO,eAAe;MAC3CW,KAAK,6BAAM,KAAKd,SAASiB,cAAa,GAAjC;MACLC,KAAK,wBAACC,UAAAA;AACL,YAAI,OAAOA,UAAU,YAAYT,SAASS,KAAAA,KAAUA,QAAQ,GAAG;AAC9D,eAAKnB,SAASW,cAAcQ,KAAAA;QAC7B;MACD,GAJK;MAKLH,YAAY;IACb,CAAA;AAEA,SAAKf,iBAAiBE;AACtB,WAAO,KAAKF;EACb;AACD;","names":["PlayerService","delegate","interfaceCache","getInterface","iface","pause","resume","postMessage","message","setFps","fps","isFinite","setUpdateRate","Object","defineProperty","get","getFps","enumerable","getUpdateRate","set","value"]}

package/dist/index.mjs

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/player-service.ts
+var PlayerService = class {
+  static {
+    __name(this, "PlayerService");
+  }
+  delegate;
+  interfaceCache = null;
+  constructor(delegate) {
+    this.delegate = delegate;
+  }
+  /**
+  * Get interface for game code (LootiScript `player.*`)
+  */
+  getInterface() {
+    if (this.interfaceCache) {
+      return this.interfaceCache;
+    }
+    const iface = {
+      pause: /* @__PURE__ */ __name(() => this.delegate.pause(), "pause"),
+      resume: /* @__PURE__ */ __name(() => this.delegate.resume(), "resume"),
+      postMessage: /* @__PURE__ */ __name((message) => this.delegate.postMessage(message), "postMessage"),
+      setFps: /* @__PURE__ */ __name((fps) => {
+        if (typeof fps === "number" && isFinite(fps) && fps > 0) {
+          this.delegate.setUpdateRate(fps);
+        }
+      }, "setFps")
+    };
+    Object.defineProperty(iface, "fps", {
+      get: /* @__PURE__ */ __name(() => this.delegate.getFps(), "get"),
+      enumerable: true
+    });
+    Object.defineProperty(iface, "update_rate", {
+      get: /* @__PURE__ */ __name(() => this.delegate.getUpdateRate(), "get"),
+      set: /* @__PURE__ */ __name((value) => {
+        if (typeof value === "number" && isFinite(value) && value > 0) {
+          this.delegate.setUpdateRate(value);
+        }
+      }, "set"),
+      enumerable: true
+    });
+    this.interfaceCache = iface;
+    return this.interfaceCache;
+  }
+};
+export {
+  PlayerService
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/player-service.ts"],"sourcesContent":["/**\n * PlayerService - Controls player UX from LootiScript\n *\n * Provides game scripts with the ability to control the player lifecycle\n * (quit, pause, resume, exit), adjust performance (fps, update_rate),\n * and communicate with the host application (postMessage).\n */\n\nimport type { PlayerDelegate } from \"./types\";\n\nexport class PlayerService {\n\tprivate delegate: PlayerDelegate;\n\tprivate interfaceCache: Record<string, any> | null = null;\n\n\tconstructor(delegate: PlayerDelegate) {\n\t\tthis.delegate = delegate;\n\t}\n\n\t/**\n\t * Get interface for game code (LootiScript `player.*`)\n\t */\n\tgetInterface(): Record<string, any> {\n\t\tif (this.interfaceCache) {\n\t\t\treturn this.interfaceCache;\n\t\t}\n\n\t\tconst iface: Record<string, any> = {\n\t\t\tpause: () => this.delegate.pause(),\n\t\t\tresume: () => this.delegate.resume(),\n\t\t\tpostMessage: (message: any) => this.delegate.postMessage(message),\n\t\t\tsetFps: (fps: number) => {\n\t\t\t\tif (typeof fps === \"number\" && isFinite(fps) && fps > 0) {\n\t\t\t\t\tthis.delegate.setUpdateRate(fps);\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\n\t\tObject.defineProperty(iface, \"fps\", {\n\t\t\tget: () => this.delegate.getFps(),\n\t\t\tenumerable: true,\n\t\t});\n\n\t\tObject.defineProperty(iface, \"update_rate\", {\n\t\t\tget: () => this.delegate.getUpdateRate(),\n\t\t\tset: (value: number) => {\n\t\t\t\tif (typeof value === \"number\" && isFinite(value) && value > 0) {\n\t\t\t\t\tthis.delegate.setUpdateRate(value);\n\t\t\t\t}\n\t\t\t},\n\t\t\tenumerable: true,\n\t\t});\n\n\t\tthis.interfaceCache = iface;\n\t\treturn this.interfaceCache;\n\t}\n}\n"],"mappings":";;;;AAUO,IAAMA,gBAAN,MAAMA;EAVb,OAUaA;;;EACJC;EACAC,iBAA6C;EAErD,YAAYD,UAA0B;AACrC,SAAKA,WAAWA;EACjB;;;;EAKAE,eAAoC;AACnC,QAAI,KAAKD,gBAAgB;AACxB,aAAO,KAAKA;IACb;AAEA,UAAME,QAA6B;MAClCC,OAAO,6BAAM,KAAKJ,SAASI,MAAK,GAAzB;MACPC,QAAQ,6BAAM,KAAKL,SAASK,OAAM,GAA1B;MACRC,aAAa,wBAACC,YAAiB,KAAKP,SAASM,YAAYC,OAAAA,GAA5C;MACbC,QAAQ,wBAACC,QAAAA;AACR,YAAI,OAAOA,QAAQ,YAAYC,SAASD,GAAAA,KAAQA,MAAM,GAAG;AACxD,eAAKT,SAASW,cAAcF,GAAAA;QAC7B;MACD,GAJQ;IAKT;AAEAG,WAAOC,eAAeV,OAAO,OAAO;MACnCW,KAAK,6BAAM,KAAKd,SAASe,OAAM,GAA1B;MACLC,YAAY;IACb,CAAA;AAEAJ,WAAOC,eAAeV,OAAO,eAAe;MAC3CW,KAAK,6BAAM,KAAKd,SAASiB,cAAa,GAAjC;MACLC,KAAK,wBAACC,UAAAA;AACL,YAAI,OAAOA,UAAU,YAAYT,SAASS,KAAAA,KAAUA,QAAQ,GAAG;AAC9D,eAAKnB,SAASW,cAAcQ,KAAAA;QAC7B;MACD,GAJK;MAKLH,YAAY;IACb,CAAA;AAEA,SAAKf,iBAAiBE;AACtB,WAAO,KAAKF;EACb;AACD;","names":["PlayerService","delegate","interfaceCache","getInterface","iface","pause","resume","postMessage","message","setFps","fps","isFinite","setUpdateRate","Object","defineProperty","get","getFps","enumerable","getUpdateRate","set","value"]}

package/package.json

@@ -0,0 +1,27 @@
+{
+	"name": "@al8b/player",
+	"version": "0.1.0",
+	"description": "Player control API for L8B - lifecycle, performance, and host communication",
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsup",
+		"clean": "bun --bun ../../../scripts/clean-package.mjs dist .turbo node_modules",
+		"test": "vitest run --passWithNoTests"
+	},
+	"devDependencies": {
+		"tsup": "^8.0.0",
+		"typescript": "^5.9.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { PlayerService } from "./player-service";
+export type { PlayerDelegate } from "./types";

package/src/player-service.ts

@@ -0,0 +1,56 @@
+/**
+ * PlayerService - Controls player UX from LootiScript
+ *
+ * Provides game scripts with the ability to control the player lifecycle
+ * (quit, pause, resume, exit), adjust performance (fps, update_rate),
+ * and communicate with the host application (postMessage).
+ */
+
+import type { PlayerDelegate } from "./types";
+
+export class PlayerService {
+	private delegate: PlayerDelegate;
+	private interfaceCache: Record<string, any> | null = null;
+
+	constructor(delegate: PlayerDelegate) {
+		this.delegate = delegate;
+	}
+
+	/**
+	 * Get interface for game code (LootiScript `player.*`)
+	 */
+	getInterface(): Record<string, any> {
+		if (this.interfaceCache) {
+			return this.interfaceCache;
+		}
+
+		const iface: Record<string, any> = {
+			pause: () => this.delegate.pause(),
+			resume: () => this.delegate.resume(),
+			postMessage: (message: any) => this.delegate.postMessage(message),
+			setFps: (fps: number) => {
+				if (typeof fps === "number" && isFinite(fps) && fps > 0) {
+					this.delegate.setUpdateRate(fps);
+				}
+			},
+		};
+
+		Object.defineProperty(iface, "fps", {
+			get: () => this.delegate.getFps(),
+			enumerable: true,
+		});
+
+		Object.defineProperty(iface, "update_rate", {
+			get: () => this.delegate.getUpdateRate(),
+			set: (value: number) => {
+				if (typeof value === "number" && isFinite(value) && value > 0) {
+					this.delegate.setUpdateRate(value);
+				}
+			},
+			enumerable: true,
+		});
+
+		this.interfaceCache = iface;
+		return this.interfaceCache;
+	}
+}

package/src/types.ts

@@ -0,0 +1,20 @@
+/**
+ * Delegate interface for PlayerService.
+ *
+ * The orchestrator provides concrete implementations of these callbacks
+ * so the PlayerService stays decoupled from runtime internals.
+ */
+export interface PlayerDelegate {
+	/** Pause the game loop */
+	pause: () => void;
+	/** Resume the game loop */
+	resume: () => void;
+	/** Send an arbitrary message to the host application */
+	postMessage: (message: any) => void;
+	/** Get current FPS */
+	getFps: () => number;
+	/** Get target update rate (Hz) */
+	getUpdateRate: () => number;
+	/** Set target update rate (Hz) */
+	setUpdateRate: (rate: number) => void;
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+	"extends": "../../../tsconfig.base.json",
+	"compilerOptions": {
+		"outDir": "dist",
+		"rootDir": "src",
+		"ignoreDeprecations": "5.0"
+	},
+	"include": [
+		"src/**/*"
+	],
+	"exclude": [
+		"node_modules",
+		"dist",
+		"**/*.test.ts"
+	]
+}

package/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+	entry: ["src/index.ts"],
+	format: ["cjs", "esm"],
+	dts: true,
+	clean: true,
+	sourcemap: true,
+});