@al8b/time 0.1.0

package/dist/playback/player.mjs

@@ -0,0 +1,147 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/constants.ts
+var DEFAULT_RECORD_BUFFER_FRAMES = 60 * 30;
+var DEFAULT_LOOP_BUFFER_FRAMES = 60 * 4;
+
+// src/utils.ts
+function deepCopy(value, excluded) {
+  if (value == null) {
+    return value;
+  }
+  if (excluded && excluded.includes(value)) {
+    return null;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    const result = [];
+    for (let i = 0; i < value.length; i++) {
+      result[i] = deepCopy(value[i], excluded);
+    }
+    return result;
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const key in value) {
+      if (Object.hasOwn(value, key)) {
+        result[key] = deepCopy(value[key], excluded);
+      }
+    }
+    return result;
+  }
+  return excluded ? null : value;
+}
+__name(deepCopy, "deepCopy");
+
+// src/playback/player.ts
+var StatePlayer = class {
+  static {
+    __name(this, "StatePlayer");
+  }
+  looping = false;
+  loopStart = 0;
+  loopIndex = 0;
+  loopLength;
+  loopCallback = null;
+  constructor(loopLength = DEFAULT_LOOP_BUFFER_FRAMES) {
+    this.loopLength = loopLength;
+  }
+  /**
+  * Check if currently looping
+  */
+  isLooping() {
+    return this.looping;
+  }
+  /**
+  * Start loop playback
+  */
+  startLoop(position, callback) {
+    this.looping = true;
+    this.loopStart = Math.max(position, 1);
+    this.loopIndex = 0;
+    this.loopCallback = callback;
+  }
+  /**
+  * Stop loop playback
+  */
+  stopLoop() {
+    this.looping = false;
+    this.loopCallback = null;
+    return this.loopStart;
+  }
+  /**
+  * Update loop (call each frame)
+  * Returns position to replay, or null if not looping
+  */
+  updateLoop() {
+    if (!this.looping) {
+      return null;
+    }
+    if (this.loopIndex === 0) {
+      this.loopIndex++;
+      return this.loopStart;
+    }
+    this.loopIndex++;
+    if (this.loopIndex > this.loopLength) {
+      this.loopIndex = 0;
+    }
+    return this.loopStart - this.loopIndex;
+  }
+  /**
+  * Execute loop callback
+  */
+  executeCallback() {
+    if (this.loopCallback) {
+      this.loopCallback();
+    }
+  }
+  /**
+  * Restore state to target object
+  */
+  restoreState(target, snapshot) {
+    if (!snapshot || !target) {
+      return;
+    }
+    for (const key in target) {
+      if (Object.hasOwn(target, key) && !this.isProtectedKey(key)) {
+        delete target[key];
+      }
+    }
+    for (const key in snapshot) {
+      if (Object.hasOwn(snapshot, key)) {
+        target[key] = deepCopy(snapshot[key]);
+      }
+    }
+  }
+  /**
+  * Check if key should be protected from restoration
+  */
+  isProtectedKey(key) {
+    const protected_keys = [
+      "screen",
+      "audio",
+      "keyboard",
+      "mouse",
+      "touch",
+      "gamepad",
+      "system",
+      "storage",
+      "sprites",
+      "maps",
+      "sounds",
+      "music",
+      "assets",
+      "host",
+      "session",
+      "memory"
+    ];
+    return protected_keys.includes(key);
+  }
+};
+export {
+  StatePlayer
+};
+//# sourceMappingURL=player.mjs.map

package/dist/playback/player.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/utils.ts","../../src/playback/player.ts"],"sourcesContent":["/** Default recording buffer: 30 seconds at 60fps (1800 frames) */\nexport const DEFAULT_RECORD_BUFFER_FRAMES = 60 * 30;\n\n/** Default loop playback buffer: 4 seconds at 60fps (240 frames) */\nexport const DEFAULT_LOOP_BUFFER_FRAMES = 60 * 4;\n","/**\n * Deep copy a value, optionally skipping excluded references.\n *\n * @param value - The value to deep copy\n * @param excluded - Optional array of object references to skip (replaced with null)\n */\nexport function deepCopy(value: any, excluded?: any[]): any {\n\tif (value == null) {\n\t\treturn value;\n\t}\n\n\tif (excluded && excluded.includes(value)) {\n\t\treturn null;\n\t}\n\n\tif (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\n\tif (Array.isArray(value)) {\n\t\tconst result: any[] = [];\n\t\tfor (let i = 0; i < value.length; i++) {\n\t\t\tresult[i] = deepCopy(value[i], excluded);\n\t\t}\n\t\treturn result;\n\t}\n\n\tif (typeof value === \"object\") {\n\t\tconst result: any = {};\n\t\tfor (const key in value) {\n\t\t\tif (Object.hasOwn(value, key)) {\n\t\t\t\tresult[key] = deepCopy(value[key], excluded);\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\n\t// Non-serializable types: return null when filtering, passthrough otherwise\n\treturn excluded ? null : value;\n}\n","/**\n * StatePlayer - Handles replay and loop playback\n *\n * Responsibilities:\n * - Restore state snapshots\n * - Manage loop playback\n * - Control playback position\n */\nimport { DEFAULT_LOOP_BUFFER_FRAMES } from \"../constants\";\nimport { deepCopy } from \"../utils\";\n\nimport type { StateSnapshot } from \"../types\";\n\nexport class StatePlayer {\n\tprivate looping = false;\n\tprivate loopStart = 0;\n\tprivate loopIndex = 0;\n\tprivate loopLength: number;\n\tprivate loopCallback: (() => void) | null = null;\n\n\tconstructor(loopLength = DEFAULT_LOOP_BUFFER_FRAMES) {\n\t\tthis.loopLength = loopLength;\n\t}\n\n\t/**\n\t * Check if currently looping\n\t */\n\tisLooping(): boolean {\n\t\treturn this.looping;\n\t}\n\n\t/**\n\t * Start loop playback\n\t */\n\tstartLoop(position: number, callback: () => void): void {\n\t\tthis.looping = true;\n\t\tthis.loopStart = Math.max(position, 1);\n\t\tthis.loopIndex = 0;\n\t\tthis.loopCallback = callback;\n\t}\n\n\t/**\n\t * Stop loop playback\n\t */\n\tstopLoop(): number {\n\t\tthis.looping = false;\n\t\tthis.loopCallback = null;\n\t\treturn this.loopStart;\n\t}\n\n\t/**\n\t * Update loop (call each frame)\n\t * Returns position to replay, or null if not looping\n\t */\n\tupdateLoop(): number | null {\n\t\tif (!this.looping) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (this.loopIndex === 0) {\n\t\t\tthis.loopIndex++;\n\t\t\treturn this.loopStart;\n\t\t}\n\n\t\tthis.loopIndex++;\n\t\tif (this.loopIndex > this.loopLength) {\n\t\t\tthis.loopIndex = 0;\n\t\t}\n\n\t\treturn this.loopStart - this.loopIndex;\n\t}\n\n\t/**\n\t * Execute loop callback\n\t */\n\texecuteCallback(): void {\n\t\tif (this.loopCallback) {\n\t\t\tthis.loopCallback();\n\t\t}\n\t}\n\n\t/**\n\t * Restore state to target object\n\t */\n\trestoreState(target: any, snapshot: StateSnapshot): void {\n\t\tif (!snapshot || !target) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove all existing properties except protected system APIs\n\t\tfor (const key in target) {\n\t\t\tif (Object.hasOwn(target, key) && !this.isProtectedKey(key)) {\n\t\t\t\tdelete target[key];\n\t\t\t}\n\t\t}\n\n\t\t// Apply snapshot properties to target object via deep copy\n\t\tfor (const key in snapshot) {\n\t\t\tif (Object.hasOwn(snapshot, key)) {\n\t\t\t\ttarget[key] = deepCopy(snapshot[key]);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Check if key should be protected from restoration\n\t */\n\tprivate isProtectedKey(key: string): boolean {\n\t\t// Prevent system APIs and runtime objects from being overwritten during restore\n\t\tconst protected_keys = [\n\t\t\t\"screen\",\n\t\t\t\"audio\",\n\t\t\t\"keyboard\",\n\t\t\t\"mouse\",\n\t\t\t\"touch\",\n\t\t\t\"gamepad\",\n\t\t\t\"system\",\n\t\t\t\"storage\",\n\t\t\t\"sprites\",\n\t\t\t\"maps\",\n\t\t\t\"sounds\",\n\t\t\t\"music\",\n\t\t\t\"assets\",\n\t\t\t\"host\",\n\t\t\t\"session\",\n\t\t\t\"memory\",\n\t\t];\n\t\treturn protected_keys.includes(key);\n\t}\n\n}\n"],"mappings":";;;;AACO,IAAMA,+BAA+B,KAAK;AAG1C,IAAMC,6BAA6B,KAAK;;;ACExC,SAASC,SAASC,OAAYC,UAAgB;AACpD,MAAID,SAAS,MAAM;AAClB,WAAOA;EACR;AAEA,MAAIC,YAAYA,SAASC,SAASF,KAAAA,GAAQ;AACzC,WAAO;EACR;AAEA,MAAI,OAAOA,UAAU,YAAY,OAAOA,UAAU,YAAY,OAAOA,UAAU,WAAW;AACzF,WAAOA;EACR;AAEA,MAAIG,MAAMC,QAAQJ,KAAAA,GAAQ;AACzB,UAAMK,SAAgB,CAAA;AACtB,aAASC,IAAI,GAAGA,IAAIN,MAAMO,QAAQD,KAAK;AACtCD,aAAOC,CAAAA,IAAKP,SAASC,MAAMM,CAAAA,GAAIL,QAAAA;IAChC;AACA,WAAOI;EACR;AAEA,MAAI,OAAOL,UAAU,UAAU;AAC9B,UAAMK,SAAc,CAAC;AACrB,eAAWG,OAAOR,OAAO;AACxB,UAAIS,OAAOC,OAAOV,OAAOQ,GAAAA,GAAM;AAC9BH,eAAOG,GAAAA,IAAOT,SAASC,MAAMQ,GAAAA,GAAMP,QAAAA;MACpC;IACD;AACA,WAAOI;EACR;AAGA,SAAOJ,WAAW,OAAOD;AAC1B;AAjCgBD;;;ACOT,IAAMY,cAAN,MAAMA;EAbb,OAaaA;;;EACJC,UAAU;EACVC,YAAY;EACZC,YAAY;EACZC;EACAC,eAAoC;EAE5C,YAAYD,aAAaE,4BAA4B;AACpD,SAAKF,aAAaA;EACnB;;;;EAKAG,YAAqB;AACpB,WAAO,KAAKN;EACb;;;;EAKAO,UAAUC,UAAkBC,UAA4B;AACvD,SAAKT,UAAU;AACf,SAAKC,YAAYS,KAAKC,IAAIH,UAAU,CAAA;AACpC,SAAKN,YAAY;AACjB,SAAKE,eAAeK;EACrB;;;;EAKAG,WAAmB;AAClB,SAAKZ,UAAU;AACf,SAAKI,eAAe;AACpB,WAAO,KAAKH;EACb;;;;;EAMAY,aAA4B;AAC3B,QAAI,CAAC,KAAKb,SAAS;AAClB,aAAO;IACR;AAEA,QAAI,KAAKE,cAAc,GAAG;AACzB,WAAKA;AACL,aAAO,KAAKD;IACb;AAEA,SAAKC;AACL,QAAI,KAAKA,YAAY,KAAKC,YAAY;AACrC,WAAKD,YAAY;IAClB;AAEA,WAAO,KAAKD,YAAY,KAAKC;EAC9B;;;;EAKAY,kBAAwB;AACvB,QAAI,KAAKV,cAAc;AACtB,WAAKA,aAAY;IAClB;EACD;;;;EAKAW,aAAaC,QAAaC,UAA+B;AACxD,QAAI,CAACA,YAAY,CAACD,QAAQ;AACzB;IACD;AAGA,eAAWE,OAAOF,QAAQ;AACzB,UAAIG,OAAOC,OAAOJ,QAAQE,GAAAA,KAAQ,CAAC,KAAKG,eAAeH,GAAAA,GAAM;AAC5D,eAAOF,OAAOE,GAAAA;MACf;IACD;AAGA,eAAWA,OAAOD,UAAU;AAC3B,UAAIE,OAAOC,OAAOH,UAAUC,GAAAA,GAAM;AACjCF,eAAOE,GAAAA,IAAOI,SAASL,SAASC,GAAAA,CAAI;MACrC;IACD;EACD;;;;EAKQG,eAAeH,KAAsB;AAE5C,UAAMK,iBAAiB;MACtB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;;AAED,WAAOA,eAAeC,SAASN,GAAAA;EAChC;AAED;","names":["DEFAULT_RECORD_BUFFER_FRAMES","DEFAULT_LOOP_BUFFER_FRAMES","deepCopy","value","excluded","includes","Array","isArray","result","i","length","key","Object","hasOwn","StatePlayer","looping","loopStart","loopIndex","loopLength","loopCallback","DEFAULT_LOOP_BUFFER_FRAMES","isLooping","startLoop","position","callback","Math","max","stopLoop","updateLoop","executeCallback","restoreState","target","snapshot","key","Object","hasOwn","isProtectedKey","deepCopy","protected_keys","includes"]}

package/dist/recording/index.d.mts

@@ -0,0 +1,2 @@
+export { StateRecorder } from './recorder.mjs';
+import '../types/state.mjs';

package/dist/recording/index.d.ts

@@ -0,0 +1,2 @@
+export { StateRecorder } from './recorder.js';
+import '../types/state.js';

package/dist/recording/index.js

@@ -0,0 +1,149 @@
+"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/recording/index.ts
+var recording_exports = {};
+__export(recording_exports, {
+  StateRecorder: () => StateRecorder
+});
+module.exports = __toCommonJS(recording_exports);
+
+// src/constants.ts
+var DEFAULT_RECORD_BUFFER_FRAMES = 60 * 30;
+var DEFAULT_LOOP_BUFFER_FRAMES = 60 * 4;
+
+// src/utils.ts
+function deepCopy(value, excluded) {
+  if (value == null) {
+    return value;
+  }
+  if (excluded && excluded.includes(value)) {
+    return null;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    const result = [];
+    for (let i = 0; i < value.length; i++) {
+      result[i] = deepCopy(value[i], excluded);
+    }
+    return result;
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const key in value) {
+      if (Object.hasOwn(value, key)) {
+        result[key] = deepCopy(value[key], excluded);
+      }
+    }
+    return result;
+  }
+  return excluded ? null : value;
+}
+__name(deepCopy, "deepCopy");
+
+// src/recording/recorder.ts
+var StateRecorder = class {
+  static {
+    __name(this, "StateRecorder");
+  }
+  history = [];
+  recordIndex = 0;
+  recordLength = 0;
+  maxLength;
+  excluded = [];
+  constructor(maxLength = DEFAULT_RECORD_BUFFER_FRAMES) {
+    this.maxLength = maxLength;
+  }
+  /**
+  * Set objects to exclude from serialization
+  */
+  setExcluded(excluded) {
+    this.excluded = excluded;
+  }
+  /**
+  * Record a state snapshot
+  */
+  record(state) {
+    const snapshot = this.makeStorableState(state);
+    this.history[this.recordIndex++] = snapshot;
+    this.recordLength = Math.min(this.recordLength + 1, this.maxLength);
+    if (this.recordIndex >= this.maxLength) {
+      this.recordIndex = 0;
+    }
+  }
+  /**
+  * Get state at specific position (0 = most recent)
+  */
+  getState(position) {
+    if (position >= this.recordLength) {
+      return null;
+    }
+    const index = (this.recordIndex - position - 1 + this.maxLength) % this.maxLength;
+    return this.history[index];
+  }
+  /**
+  * Get current record length
+  */
+  getLength() {
+    return this.recordLength;
+  }
+  /**
+  * Get maximum record length
+  */
+  getMaxLength() {
+    return this.maxLength;
+  }
+  /**
+  * Clear all recorded history
+  */
+  clear() {
+    this.history = [];
+    this.recordIndex = 0;
+    this.recordLength = 0;
+  }
+  /**
+  * Trim history to specific position
+  */
+  trimTo(position) {
+    if (position >= this.recordLength) {
+      return;
+    }
+    const histo = [];
+    const start = this.recordLength;
+    const end = position + 1;
+    for (let i = start; i >= end; i--) {
+      const index = (this.recordIndex - i + this.maxLength) % this.maxLength;
+      histo.push(this.history[index]);
+    }
+    this.history = histo;
+    this.recordIndex = this.history.length;
+    this.recordLength = this.history.length;
+  }
+  makeStorableState(value) {
+    return deepCopy(value, this.excluded);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  StateRecorder
+});
+//# sourceMappingURL=index.js.map

package/dist/recording/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/recording/index.ts","../../src/constants.ts","../../src/utils.ts","../../src/recording/recorder.ts"],"sourcesContent":["/**\n * Recording module exports\n */\n\nexport { StateRecorder } from \"./recorder\";\n","/** Default recording buffer: 30 seconds at 60fps (1800 frames) */\nexport const DEFAULT_RECORD_BUFFER_FRAMES = 60 * 30;\n\n/** Default loop playback buffer: 4 seconds at 60fps (240 frames) */\nexport const DEFAULT_LOOP_BUFFER_FRAMES = 60 * 4;\n","/**\n * Deep copy a value, optionally skipping excluded references.\n *\n * @param value - The value to deep copy\n * @param excluded - Optional array of object references to skip (replaced with null)\n */\nexport function deepCopy(value: any, excluded?: any[]): any {\n\tif (value == null) {\n\t\treturn value;\n\t}\n\n\tif (excluded && excluded.includes(value)) {\n\t\treturn null;\n\t}\n\n\tif (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\n\tif (Array.isArray(value)) {\n\t\tconst result: any[] = [];\n\t\tfor (let i = 0; i < value.length; i++) {\n\t\t\tresult[i] = deepCopy(value[i], excluded);\n\t\t}\n\t\treturn result;\n\t}\n\n\tif (typeof value === \"object\") {\n\t\tconst result: any = {};\n\t\tfor (const key in value) {\n\t\t\tif (Object.hasOwn(value, key)) {\n\t\t\t\tresult[key] = deepCopy(value[key], excluded);\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\n\t// Non-serializable types: return null when filtering, passthrough otherwise\n\treturn excluded ? null : value;\n}\n","/**\n * StateRecorder - Records game state history\n *\n * Responsibilities:\n * - Capture state snapshots\n * - Manage circular buffer\n * - Exclude non-serializable objects\n */\nimport { DEFAULT_RECORD_BUFFER_FRAMES } from \"../constants\";\nimport { deepCopy } from \"../utils\";\n\nimport type { StateSnapshot } from \"../types\";\n\nexport class StateRecorder {\n\tprivate history: StateSnapshot[] = [];\n\tprivate recordIndex = 0;\n\tprivate recordLength = 0;\n\tprivate maxLength: number;\n\tprivate excluded: any[] = [];\n\n\tconstructor(maxLength = DEFAULT_RECORD_BUFFER_FRAMES) {\n\t\tthis.maxLength = maxLength;\n\t}\n\n\t/**\n\t * Set objects to exclude from serialization\n\t */\n\tsetExcluded(excluded: any[]): void {\n\t\tthis.excluded = excluded;\n\t}\n\n\t/**\n\t * Record a state snapshot\n\t */\n\trecord(state: any): void {\n\t\tconst snapshot = this.makeStorableState(state);\n\t\tthis.history[this.recordIndex++] = snapshot;\n\t\tthis.recordLength = Math.min(this.recordLength + 1, this.maxLength);\n\n\t\tif (this.recordIndex >= this.maxLength) {\n\t\t\tthis.recordIndex = 0;\n\t\t}\n\t}\n\n\t/**\n\t * Get state at specific position (0 = most recent)\n\t */\n\tgetState(position: number): StateSnapshot | null {\n\t\tif (position >= this.recordLength) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst index = (this.recordIndex - position - 1 + this.maxLength) % this.maxLength;\n\t\treturn this.history[index];\n\t}\n\n\t/**\n\t * Get current record length\n\t */\n\tgetLength(): number {\n\t\treturn this.recordLength;\n\t}\n\n\t/**\n\t * Get maximum record length\n\t */\n\tgetMaxLength(): number {\n\t\treturn this.maxLength;\n\t}\n\n\t/**\n\t * Clear all recorded history\n\t */\n\tclear(): void {\n\t\tthis.history = [];\n\t\tthis.recordIndex = 0;\n\t\tthis.recordLength = 0;\n\t}\n\n\t/**\n\t * Trim history to specific position\n\t */\n\ttrimTo(position: number): void {\n\t\tif (position >= this.recordLength) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst histo: StateSnapshot[] = [];\n\t\tconst start = this.recordLength;\n\t\tconst end = position + 1;\n\n\t\tfor (let i = start; i >= end; i--) {\n\t\t\tconst index = (this.recordIndex - i + this.maxLength) % this.maxLength;\n\t\t\thisto.push(this.history[index]);\n\t\t}\n\n\t\tthis.history = histo;\n\t\tthis.recordIndex = this.history.length;\n\t\tthis.recordLength = this.history.length;\n\t}\n\n\tprivate makeStorableState(value: any): any {\n\t\treturn deepCopy(value, this.excluded);\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACCO,IAAMA,+BAA+B,KAAK;AAG1C,IAAMC,6BAA6B,KAAK;;;ACExC,SAASC,SAASC,OAAYC,UAAgB;AACpD,MAAID,SAAS,MAAM;AAClB,WAAOA;EACR;AAEA,MAAIC,YAAYA,SAASC,SAASF,KAAAA,GAAQ;AACzC,WAAO;EACR;AAEA,MAAI,OAAOA,UAAU,YAAY,OAAOA,UAAU,YAAY,OAAOA,UAAU,WAAW;AACzF,WAAOA;EACR;AAEA,MAAIG,MAAMC,QAAQJ,KAAAA,GAAQ;AACzB,UAAMK,SAAgB,CAAA;AACtB,aAASC,IAAI,GAAGA,IAAIN,MAAMO,QAAQD,KAAK;AACtCD,aAAOC,CAAAA,IAAKP,SAASC,MAAMM,CAAAA,GAAIL,QAAAA;IAChC;AACA,WAAOI;EACR;AAEA,MAAI,OAAOL,UAAU,UAAU;AAC9B,UAAMK,SAAc,CAAC;AACrB,eAAWG,OAAOR,OAAO;AACxB,UAAIS,OAAOC,OAAOV,OAAOQ,GAAAA,GAAM;AAC9BH,eAAOG,GAAAA,IAAOT,SAASC,MAAMQ,GAAAA,GAAMP,QAAAA;MACpC;IACD;AACA,WAAOI;EACR;AAGA,SAAOJ,WAAW,OAAOD;AAC1B;AAjCgBD;;;ACOT,IAAMY,gBAAN,MAAMA;EAbb,OAaaA;;;EACJC,UAA2B,CAAA;EAC3BC,cAAc;EACdC,eAAe;EACfC;EACAC,WAAkB,CAAA;EAE1B,YAAYD,YAAYE,8BAA8B;AACrD,SAAKF,YAAYA;EAClB;;;;EAKAG,YAAYF,UAAuB;AAClC,SAAKA,WAAWA;EACjB;;;;EAKAG,OAAOC,OAAkB;AACxB,UAAMC,WAAW,KAAKC,kBAAkBF,KAAAA;AACxC,SAAKR,QAAQ,KAAKC,aAAW,IAAMQ;AACnC,SAAKP,eAAeS,KAAKC,IAAI,KAAKV,eAAe,GAAG,KAAKC,SAAS;AAElE,QAAI,KAAKF,eAAe,KAAKE,WAAW;AACvC,WAAKF,cAAc;IACpB;EACD;;;;EAKAY,SAASC,UAAwC;AAChD,QAAIA,YAAY,KAAKZ,cAAc;AAClC,aAAO;IACR;AAEA,UAAMa,SAAS,KAAKd,cAAca,WAAW,IAAI,KAAKX,aAAa,KAAKA;AACxE,WAAO,KAAKH,QAAQe,KAAAA;EACrB;;;;EAKAC,YAAoB;AACnB,WAAO,KAAKd;EACb;;;;EAKAe,eAAuB;AACtB,WAAO,KAAKd;EACb;;;;EAKAe,QAAc;AACb,SAAKlB,UAAU,CAAA;AACf,SAAKC,cAAc;AACnB,SAAKC,eAAe;EACrB;;;;EAKAiB,OAAOL,UAAwB;AAC9B,QAAIA,YAAY,KAAKZ,cAAc;AAClC;IACD;AAEA,UAAMkB,QAAyB,CAAA;AAC/B,UAAMC,QAAQ,KAAKnB;AACnB,UAAMoB,MAAMR,WAAW;AAEvB,aAASS,IAAIF,OAAOE,KAAKD,KAAKC,KAAK;AAClC,YAAMR,SAAS,KAAKd,cAAcsB,IAAI,KAAKpB,aAAa,KAAKA;AAC7DiB,YAAMI,KAAK,KAAKxB,QAAQe,KAAAA,CAAM;IAC/B;AAEA,SAAKf,UAAUoB;AACf,SAAKnB,cAAc,KAAKD,QAAQyB;AAChC,SAAKvB,eAAe,KAAKF,QAAQyB;EAClC;EAEQf,kBAAkBgB,OAAiB;AAC1C,WAAOC,SAASD,OAAO,KAAKtB,QAAQ;EACrC;AACD;","names":["DEFAULT_RECORD_BUFFER_FRAMES","DEFAULT_LOOP_BUFFER_FRAMES","deepCopy","value","excluded","includes","Array","isArray","result","i","length","key","Object","hasOwn","StateRecorder","history","recordIndex","recordLength","maxLength","excluded","DEFAULT_RECORD_BUFFER_FRAMES","setExcluded","record","state","snapshot","makeStorableState","Math","min","getState","position","index","getLength","getMaxLength","clear","trimTo","histo","start","end","i","push","length","value","deepCopy"]}

package/dist/recording/index.mjs

@@ -0,0 +1,124 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/constants.ts
+var DEFAULT_RECORD_BUFFER_FRAMES = 60 * 30;
+var DEFAULT_LOOP_BUFFER_FRAMES = 60 * 4;
+
+// src/utils.ts
+function deepCopy(value, excluded) {
+  if (value == null) {
+    return value;
+  }
+  if (excluded && excluded.includes(value)) {
+    return null;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    const result = [];
+    for (let i = 0; i < value.length; i++) {
+      result[i] = deepCopy(value[i], excluded);
+    }
+    return result;
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const key in value) {
+      if (Object.hasOwn(value, key)) {
+        result[key] = deepCopy(value[key], excluded);
+      }
+    }
+    return result;
+  }
+  return excluded ? null : value;
+}
+__name(deepCopy, "deepCopy");
+
+// src/recording/recorder.ts
+var StateRecorder = class {
+  static {
+    __name(this, "StateRecorder");
+  }
+  history = [];
+  recordIndex = 0;
+  recordLength = 0;
+  maxLength;
+  excluded = [];
+  constructor(maxLength = DEFAULT_RECORD_BUFFER_FRAMES) {
+    this.maxLength = maxLength;
+  }
+  /**
+  * Set objects to exclude from serialization
+  */
+  setExcluded(excluded) {
+    this.excluded = excluded;
+  }
+  /**
+  * Record a state snapshot
+  */
+  record(state) {
+    const snapshot = this.makeStorableState(state);
+    this.history[this.recordIndex++] = snapshot;
+    this.recordLength = Math.min(this.recordLength + 1, this.maxLength);
+    if (this.recordIndex >= this.maxLength) {
+      this.recordIndex = 0;
+    }
+  }
+  /**
+  * Get state at specific position (0 = most recent)
+  */
+  getState(position) {
+    if (position >= this.recordLength) {
+      return null;
+    }
+    const index = (this.recordIndex - position - 1 + this.maxLength) % this.maxLength;
+    return this.history[index];
+  }
+  /**
+  * Get current record length
+  */
+  getLength() {
+    return this.recordLength;
+  }
+  /**
+  * Get maximum record length
+  */
+  getMaxLength() {
+    return this.maxLength;
+  }
+  /**
+  * Clear all recorded history
+  */
+  clear() {
+    this.history = [];
+    this.recordIndex = 0;
+    this.recordLength = 0;
+  }
+  /**
+  * Trim history to specific position
+  */
+  trimTo(position) {
+    if (position >= this.recordLength) {
+      return;
+    }
+    const histo = [];
+    const start = this.recordLength;
+    const end = position + 1;
+    for (let i = start; i >= end; i--) {
+      const index = (this.recordIndex - i + this.maxLength) % this.maxLength;
+      histo.push(this.history[index]);
+    }
+    this.history = histo;
+    this.recordIndex = this.history.length;
+    this.recordLength = this.history.length;
+  }
+  makeStorableState(value) {
+    return deepCopy(value, this.excluded);
+  }
+};
+export {
+  StateRecorder
+};
+//# sourceMappingURL=index.mjs.map

package/dist/recording/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/utils.ts","../../src/recording/recorder.ts"],"sourcesContent":["/** Default recording buffer: 30 seconds at 60fps (1800 frames) */\nexport const DEFAULT_RECORD_BUFFER_FRAMES = 60 * 30;\n\n/** Default loop playback buffer: 4 seconds at 60fps (240 frames) */\nexport const DEFAULT_LOOP_BUFFER_FRAMES = 60 * 4;\n","/**\n * Deep copy a value, optionally skipping excluded references.\n *\n * @param value - The value to deep copy\n * @param excluded - Optional array of object references to skip (replaced with null)\n */\nexport function deepCopy(value: any, excluded?: any[]): any {\n\tif (value == null) {\n\t\treturn value;\n\t}\n\n\tif (excluded && excluded.includes(value)) {\n\t\treturn null;\n\t}\n\n\tif (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\n\tif (Array.isArray(value)) {\n\t\tconst result: any[] = [];\n\t\tfor (let i = 0; i < value.length; i++) {\n\t\t\tresult[i] = deepCopy(value[i], excluded);\n\t\t}\n\t\treturn result;\n\t}\n\n\tif (typeof value === \"object\") {\n\t\tconst result: any = {};\n\t\tfor (const key in value) {\n\t\t\tif (Object.hasOwn(value, key)) {\n\t\t\t\tresult[key] = deepCopy(value[key], excluded);\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\n\t// Non-serializable types: return null when filtering, passthrough otherwise\n\treturn excluded ? null : value;\n}\n","/**\n * StateRecorder - Records game state history\n *\n * Responsibilities:\n * - Capture state snapshots\n * - Manage circular buffer\n * - Exclude non-serializable objects\n */\nimport { DEFAULT_RECORD_BUFFER_FRAMES } from \"../constants\";\nimport { deepCopy } from \"../utils\";\n\nimport type { StateSnapshot } from \"../types\";\n\nexport class StateRecorder {\n\tprivate history: StateSnapshot[] = [];\n\tprivate recordIndex = 0;\n\tprivate recordLength = 0;\n\tprivate maxLength: number;\n\tprivate excluded: any[] = [];\n\n\tconstructor(maxLength = DEFAULT_RECORD_BUFFER_FRAMES) {\n\t\tthis.maxLength = maxLength;\n\t}\n\n\t/**\n\t * Set objects to exclude from serialization\n\t */\n\tsetExcluded(excluded: any[]): void {\n\t\tthis.excluded = excluded;\n\t}\n\n\t/**\n\t * Record a state snapshot\n\t */\n\trecord(state: any): void {\n\t\tconst snapshot = this.makeStorableState(state);\n\t\tthis.history[this.recordIndex++] = snapshot;\n\t\tthis.recordLength = Math.min(this.recordLength + 1, this.maxLength);\n\n\t\tif (this.recordIndex >= this.maxLength) {\n\t\t\tthis.recordIndex = 0;\n\t\t}\n\t}\n\n\t/**\n\t * Get state at specific position (0 = most recent)\n\t */\n\tgetState(position: number): StateSnapshot | null {\n\t\tif (position >= this.recordLength) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst index = (this.recordIndex - position - 1 + this.maxLength) % this.maxLength;\n\t\treturn this.history[index];\n\t}\n\n\t/**\n\t * Get current record length\n\t */\n\tgetLength(): number {\n\t\treturn this.recordLength;\n\t}\n\n\t/**\n\t * Get maximum record length\n\t */\n\tgetMaxLength(): number {\n\t\treturn this.maxLength;\n\t}\n\n\t/**\n\t * Clear all recorded history\n\t */\n\tclear(): void {\n\t\tthis.history = [];\n\t\tthis.recordIndex = 0;\n\t\tthis.recordLength = 0;\n\t}\n\n\t/**\n\t * Trim history to specific position\n\t */\n\ttrimTo(position: number): void {\n\t\tif (position >= this.recordLength) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst histo: StateSnapshot[] = [];\n\t\tconst start = this.recordLength;\n\t\tconst end = position + 1;\n\n\t\tfor (let i = start; i >= end; i--) {\n\t\t\tconst index = (this.recordIndex - i + this.maxLength) % this.maxLength;\n\t\t\thisto.push(this.history[index]);\n\t\t}\n\n\t\tthis.history = histo;\n\t\tthis.recordIndex = this.history.length;\n\t\tthis.recordLength = this.history.length;\n\t}\n\n\tprivate makeStorableState(value: any): any {\n\t\treturn deepCopy(value, this.excluded);\n\t}\n}\n"],"mappings":";;;;AACO,IAAMA,+BAA+B,KAAK;AAG1C,IAAMC,6BAA6B,KAAK;;;ACExC,SAASC,SAASC,OAAYC,UAAgB;AACpD,MAAID,SAAS,MAAM;AAClB,WAAOA;EACR;AAEA,MAAIC,YAAYA,SAASC,SAASF,KAAAA,GAAQ;AACzC,WAAO;EACR;AAEA,MAAI,OAAOA,UAAU,YAAY,OAAOA,UAAU,YAAY,OAAOA,UAAU,WAAW;AACzF,WAAOA;EACR;AAEA,MAAIG,MAAMC,QAAQJ,KAAAA,GAAQ;AACzB,UAAMK,SAAgB,CAAA;AACtB,aAASC,IAAI,GAAGA,IAAIN,MAAMO,QAAQD,KAAK;AACtCD,aAAOC,CAAAA,IAAKP,SAASC,MAAMM,CAAAA,GAAIL,QAAAA;IAChC;AACA,WAAOI;EACR;AAEA,MAAI,OAAOL,UAAU,UAAU;AAC9B,UAAMK,SAAc,CAAC;AACrB,eAAWG,OAAOR,OAAO;AACxB,UAAIS,OAAOC,OAAOV,OAAOQ,GAAAA,GAAM;AAC9BH,eAAOG,GAAAA,IAAOT,SAASC,MAAMQ,GAAAA,GAAMP,QAAAA;MACpC;IACD;AACA,WAAOI;EACR;AAGA,SAAOJ,WAAW,OAAOD;AAC1B;AAjCgBD;;;ACOT,IAAMY,gBAAN,MAAMA;EAbb,OAaaA;;;EACJC,UAA2B,CAAA;EAC3BC,cAAc;EACdC,eAAe;EACfC;EACAC,WAAkB,CAAA;EAE1B,YAAYD,YAAYE,8BAA8B;AACrD,SAAKF,YAAYA;EAClB;;;;EAKAG,YAAYF,UAAuB;AAClC,SAAKA,WAAWA;EACjB;;;;EAKAG,OAAOC,OAAkB;AACxB,UAAMC,WAAW,KAAKC,kBAAkBF,KAAAA;AACxC,SAAKR,QAAQ,KAAKC,aAAW,IAAMQ;AACnC,SAAKP,eAAeS,KAAKC,IAAI,KAAKV,eAAe,GAAG,KAAKC,SAAS;AAElE,QAAI,KAAKF,eAAe,KAAKE,WAAW;AACvC,WAAKF,cAAc;IACpB;EACD;;;;EAKAY,SAASC,UAAwC;AAChD,QAAIA,YAAY,KAAKZ,cAAc;AAClC,aAAO;IACR;AAEA,UAAMa,SAAS,KAAKd,cAAca,WAAW,IAAI,KAAKX,aAAa,KAAKA;AACxE,WAAO,KAAKH,QAAQe,KAAAA;EACrB;;;;EAKAC,YAAoB;AACnB,WAAO,KAAKd;EACb;;;;EAKAe,eAAuB;AACtB,WAAO,KAAKd;EACb;;;;EAKAe,QAAc;AACb,SAAKlB,UAAU,CAAA;AACf,SAAKC,cAAc;AACnB,SAAKC,eAAe;EACrB;;;;EAKAiB,OAAOL,UAAwB;AAC9B,QAAIA,YAAY,KAAKZ,cAAc;AAClC;IACD;AAEA,UAAMkB,QAAyB,CAAA;AAC/B,UAAMC,QAAQ,KAAKnB;AACnB,UAAMoB,MAAMR,WAAW;AAEvB,aAASS,IAAIF,OAAOE,KAAKD,KAAKC,KAAK;AAClC,YAAMR,SAAS,KAAKd,cAAcsB,IAAI,KAAKpB,aAAa,KAAKA;AAC7DiB,YAAMI,KAAK,KAAKxB,QAAQe,KAAAA,CAAM;IAC/B;AAEA,SAAKf,UAAUoB;AACf,SAAKnB,cAAc,KAAKD,QAAQyB;AAChC,SAAKvB,eAAe,KAAKF,QAAQyB;EAClC;EAEQf,kBAAkBgB,OAAiB;AAC1C,WAAOC,SAASD,OAAO,KAAKtB,QAAQ;EACrC;AACD;","names":["DEFAULT_RECORD_BUFFER_FRAMES","DEFAULT_LOOP_BUFFER_FRAMES","deepCopy","value","excluded","includes","Array","isArray","result","i","length","key","Object","hasOwn","StateRecorder","history","recordIndex","recordLength","maxLength","excluded","DEFAULT_RECORD_BUFFER_FRAMES","setExcluded","record","state","snapshot","makeStorableState","Math","min","getState","position","index","getLength","getMaxLength","clear","trimTo","histo","start","end","i","push","length","value","deepCopy"]}

package/dist/recording/recorder.d.mts

@@ -0,0 +1,41 @@
+import { StateSnapshot } from '../types/state.mjs';
+
+declare class StateRecorder {
+    private history;
+    private recordIndex;
+    private recordLength;
+    private maxLength;
+    private excluded;
+    constructor(maxLength?: number);
+    /**
+     * Set objects to exclude from serialization
+     */
+    setExcluded(excluded: any[]): void;
+    /**
+     * Record a state snapshot
+     */
+    record(state: any): void;
+    /**
+     * Get state at specific position (0 = most recent)
+     */
+    getState(position: number): StateSnapshot | null;
+    /**
+     * Get current record length
+     */
+    getLength(): number;
+    /**
+     * Get maximum record length
+     */
+    getMaxLength(): number;
+    /**
+     * Clear all recorded history
+     */
+    clear(): void;
+    /**
+     * Trim history to specific position
+     */
+    trimTo(position: number): void;
+    private makeStorableState;
+}
+
+export { StateRecorder };

package/dist/recording/recorder.d.ts

@@ -0,0 +1,41 @@
+import { StateSnapshot } from '../types/state.js';
+
+declare class StateRecorder {
+    private history;
+    private recordIndex;
+    private recordLength;
+    private maxLength;
+    private excluded;
+    constructor(maxLength?: number);
+    /**
+     * Set objects to exclude from serialization
+     */
+    setExcluded(excluded: any[]): void;
+    /**
+     * Record a state snapshot
+     */
+    record(state: any): void;
+    /**
+     * Get state at specific position (0 = most recent)
+     */
+    getState(position: number): StateSnapshot | null;
+    /**
+     * Get current record length
+     */
+    getLength(): number;
+    /**
+     * Get maximum record length
+     */
+    getMaxLength(): number;
+    /**
+     * Clear all recorded history
+     */
+    clear(): void;
+    /**
+     * Trim history to specific position
+     */
+    trimTo(position: number): void;
+    private makeStorableState;
+}
+
+export { StateRecorder };