phaser-hooks 0.1.0

package/dist/hooks/with-persistent-state.js

@@ -0,0 +1,45 @@
+import { withGlobalState } from './with-global-state';
+/**
+ * Creates a state hook with automatic localStorage persistence
+ * @template T The type of the state value
+ * @param key Unique identifier for the state
+ * @param initialValue Initial value to use if no stored value exists
+ * @param storageKey Optional custom localStorage key (defaults to the state key)
+ * @returns HookState with automatic persistence
+ *
+ * @example
+ * ```typescript
+ * const persistentSettings = withPersistentState<UserSettings>(
+ *   'settings',
+ *   { volume: 0.8, difficulty: 'normal' }
+ * );
+ * ```
+ */
+export const withPersistentState = (key, initialValue, storageKey) => {
+    const actualStorageKey = storageKey ?? `phaser-state-${key}`;
+    // Load from localStorage if available
+    let storedValue = initialValue;
+    try {
+        const stored = localStorage.getItem(actualStorageKey);
+        if (stored) {
+            storedValue = JSON.parse(stored);
+        }
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.warn(`[withPersistentState] Failed to load stored state for "${key}":`, error);
+    }
+    const state = withGlobalState(key, storedValue);
+    // Save to localStorage on changes
+    state.onChange(newValue => {
+        try {
+            localStorage.setItem(actualStorageKey, JSON.stringify(newValue));
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.warn(`[withPersistentState] Failed to save state for "${key}":`, error);
+        }
+    });
+    return state;
+};
+//# sourceMappingURL=with-persistent-state.js.map

package/dist/hooks/with-persistent-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-persistent-state.js","sourceRoot":"","sources":["../../src/hooks/with-persistent-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAW,EACX,YAAe,EACf,UAAmB,EACL,EAAE;IAChB,MAAM,gBAAgB,GAAG,UAAU,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAE7D,sCAAsC;IACtC,IAAI,WAAW,GAAG,YAAY,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtD,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,0DAA0D,GAAG,IAAI,EACjE,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAI,GAAG,EAAE,WAAW,CAAC,CAAC;IAEnD,kCAAkC;IAClC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACxB,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACV,mDAAmD,GAAG,IAAI,EAC1D,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/hooks/with-state-def.d.ts

@@ -0,0 +1,75 @@
+import * as Phaser from 'phaser';
+import { type HookState } from './type';
+/**
+ * Configuration options for state definition
+ */
+export type StateDefOptions = {
+    /**
+     * Whether to persist state across scene changes
+     * @default true
+     */
+    persistent?: boolean;
+    /**
+     * Custom validator function for state values
+     * @param value The value to validate
+     * @returns true if valid, false or error message if invalid
+     */
+    validator?: (value: unknown) => boolean | string;
+    /**
+     * Whether to enable debug logging for this state
+     * @default false
+     */
+    debug?: boolean;
+};
+/**
+ * Low-level state management hook that directly interfaces with Phaser's registry system.
+ * This is the foundation for all other state hooks and provides direct access to
+ * Phaser's scene registry with additional safety and TypeScript support.
+ *
+ * ⚠️ **Note**: This is a low-level hook. Consider using `withLocalState` or `withGlobalState`
+ * for most use cases unless you need specific registry control.
+ *
+ * @template T The type of the state value
+ * @param scene The Phaser scene instance that owns this state
+ * @param key Unique identifier for the state in the registry
+ * @param initialValue Optional initial value to set if key doesn't exist
+ * @param options Optional configuration for state behavior
+ * @returns HookState interface for managing the state
+ *
+ * @throws {Error} When scene or registry is not available
+ * @throws {Error} When key is invalid (empty or non-string)
+ * @throws {Error} When validator rejects the initial value
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const playerState = withStateDef<{name: string, level: number}>(
+ *   scene,
+ *   'player',
+ *   { name: 'Player1', level: 1 }
+ * );
+ *
+ * // With validation
+ * const healthState = withStateDef<number>(
+ *   scene,
+ *   'health',
+ *   100,
+ *   {
+ *     validator: (value) => {
+ *       const health = value as number;
+ *       return health >= 0 && health <= 100 ? true : 'Health must be between 0-100';
+ *     }
+ *   }
+ * );
+ *
+ * // With debug logging
+ * const debugState = withStateDef<string>(
+ *   scene,
+ *   'debug-info',
+ *   'initial',
+ *   { debug: true }
+ * );
+ * ```
+ */
+export declare const withStateDef: <T>(scene: Phaser.Scene, key: string, initialValue?: T, options?: StateDefOptions) => HookState<T>;
+//# sourceMappingURL=with-state-def.d.ts.map

package/dist/hooks/with-state-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-state-def.d.ts","sourceRoot":"","sources":["../../src/hooks/with-state-def.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAAE,KAAK,SAAS,EAA4B,MAAM,QAAQ,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;IAEjD;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAIH,eAAO,MAAM,YAAY,GAAI,CAAC,EAC5B,OAAO,MAAM,CAAC,KAAK,EACnB,KAAK,MAAM,EACX,eAAe,CAAC,EAChB,UAAS,eAAoB,KAC5B,SAAS,CAAC,CAAC,CAyHb,CAAC"}

package/dist/hooks/with-state-def.js

@@ -0,0 +1,148 @@
+/**
+ * Low-level state management hook that directly interfaces with Phaser's registry system.
+ * This is the foundation for all other state hooks and provides direct access to
+ * Phaser's scene registry with additional safety and TypeScript support.
+ *
+ * ⚠️ **Note**: This is a low-level hook. Consider using `withLocalState` or `withGlobalState`
+ * for most use cases unless you need specific registry control.
+ *
+ * @template T The type of the state value
+ * @param scene The Phaser scene instance that owns this state
+ * @param key Unique identifier for the state in the registry
+ * @param initialValue Optional initial value to set if key doesn't exist
+ * @param options Optional configuration for state behavior
+ * @returns HookState interface for managing the state
+ *
+ * @throws {Error} When scene or registry is not available
+ * @throws {Error} When key is invalid (empty or non-string)
+ * @throws {Error} When validator rejects the initial value
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const playerState = withStateDef<{name: string, level: number}>(
+ *   scene,
+ *   'player',
+ *   { name: 'Player1', level: 1 }
+ * );
+ *
+ * // With validation
+ * const healthState = withStateDef<number>(
+ *   scene,
+ *   'health',
+ *   100,
+ *   {
+ *     validator: (value) => {
+ *       const health = value as number;
+ *       return health >= 0 && health <= 100 ? true : 'Health must be between 0-100';
+ *     }
+ *   }
+ * );
+ *
+ * // With debug logging
+ * const debugState = withStateDef<string>(
+ *   scene,
+ *   'debug-info',
+ *   'initial',
+ *   { debug: true }
+ * );
+ * ```
+ */
+/* eslint-disable max-lines-per-function */
+/* eslint-disable complexity */
+/* eslint-disable sonarjs/cognitive-complexity */
+export const withStateDef = (scene, key, initialValue, options = {}) => {
+    if (!scene) {
+        throw new Error('[withStateDef] Scene parameter is required');
+    }
+    if (!scene.registry) {
+        throw new Error('[withStateDef] Scene registry is not available. Ensure the scene is properly initialized.');
+    }
+    if (!key || typeof key !== 'string' || key.trim().length === 0) {
+        throw new Error('[withStateDef] Key must be a non-empty string');
+    }
+    const { validator, debug = false } = options;
+    const registry = scene.registry;
+    const eventKey = `changedata-${key}`;
+    // Validate and set initial value if provided
+    if (!registry.has(key) && initialValue !== undefined) {
+        if (validator) {
+            const validationResult = validator(initialValue);
+            if (validationResult !== true) {
+                const message = typeof validationResult === 'string'
+                    ? validationResult
+                    : `Invalid initial value for key "${key}"`;
+                throw new Error(`[withStateDef] ${message}`);
+            }
+        }
+        registry.set(key, initialValue);
+        if (debug) {
+            // eslint-disable-next-line no-console
+            console.debug(`[withStateDef] Initialized "${key}" with value:`, initialValue);
+        }
+    }
+    /**
+     * Gets the current state value from the registry
+     */
+    const get = () => {
+        const value = registry.get(key);
+        if (debug) {
+            // eslint-disable-next-line no-console
+            console.debug(`[withStateDef] Getting "${key}":`, value);
+        }
+        return value;
+    };
+    /**
+     * Sets a new state value in the registry
+     */
+    const set = (value) => {
+        if (validator) {
+            const validationResult = validator(value);
+            if (validationResult !== true) {
+                const message = typeof validationResult === 'string'
+                    ? validationResult
+                    : `Invalid value for key "${key}"`;
+                throw new Error(`[withStateDef] ${message}`);
+            }
+        }
+        const oldValue = registry.get(key);
+        registry.set(key, value);
+        if (debug) {
+            // eslint-disable-next-line no-console
+            console.debug(`[withStateDef] Setting "${key}":`, {
+                oldValue,
+                newValue: value,
+            });
+        }
+    };
+    /**
+     * Registers a change listener for this state
+     */
+    const onChange = (callback) => {
+        if (!callback || typeof callback !== 'function') {
+            throw new Error('[withStateDef] onChange callback must be a function');
+        }
+        registry.events.on(eventKey, (_parent, key, value, previousValue) => {
+            if (debug) {
+                // eslint-disable-next-line no-console
+                console.debug(`[withStateDef] Change detected for "${key}":`, {
+                    previousValue,
+                    value,
+                });
+            }
+            try {
+                callback(value, previousValue);
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.error(`[withStateDef] Error in onChange callback for "${key}":`, error);
+            }
+        });
+    };
+    return {
+        get,
+        set,
+        onChange,
+    };
+};
+//# sourceMappingURL=with-state-def.js.map

package/dist/hooks/with-state-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-state-def.js","sourceRoot":"","sources":["../../src/hooks/with-state-def.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,2CAA2C;AAC3C,+BAA+B;AAC/B,iDAAiD;AACjD,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAmB,EACnB,GAAW,EACX,YAAgB,EAChB,UAA2B,EAAE,EACf,EAAE;IAChB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,MAAM,QAAQ,GAAG,cAAc,GAAG,EAAE,CAAC;IAErC,6CAA6C;IAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACrD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,gBAAgB,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;YACjD,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,QAAQ;oBAClC,CAAC,CAAC,gBAAgB;oBAClB,CAAC,CAAC,kCAAkC,GAAG,GAAG,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAEhC,IAAI,KAAK,EAAE,CAAC;YACV,sCAAsC;YACtC,OAAO,CAAC,KAAK,CACX,+BAA+B,GAAG,eAAe,EACjD,YAAY,CACb,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,GAAG,GAAG,GAAM,EAAE;QAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;QAErC,IAAI,KAAK,EAAE,CAAC;YACV,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,GAAG,GAAG,CAAC,KAAQ,EAAQ,EAAE;QAC7B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC9B,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,QAAQ;oBAClC,CAAC,CAAC,gBAAgB;oBAClB,CAAC,CAAC,0BAA0B,GAAG,GAAG,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;QACxC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEzB,IAAI,KAAK,EAAE,CAAC;YACV,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,IAAI,EAAE;gBAChD,QAAQ;gBACR,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,QAAQ,GAAG,CAAC,QAAgC,EAAQ,EAAE;QAC1D,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,EAAE,CAChB,QAAQ,EACR,CAAC,OAAgB,EAAE,GAAW,EAAE,KAAQ,EAAE,aAAgB,EAAE,EAAE;YAC5D,IAAI,KAAK,EAAE,CAAC;gBACV,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,uCAAuC,GAAG,IAAI,EAAE;oBAC5D,aAAa;oBACb,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CACX,kDAAkD,GAAG,IAAI,EACzD,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;QACH,GAAG;QACH,QAAQ;KACT,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/with-undoable-state.d.ts

@@ -0,0 +1,32 @@
+import { type HookState } from './type';
+/**
+ * Enhanced HookState interface with undo/redo capabilities
+ */
+export type UndoableHookState<T> = {
+    undo(): boolean;
+    redo(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    clearHistory(): void;
+} & HookState<T>;
+/**
+ * Creates a state hook with undo/redo functionality
+ * @template T The type of the state value
+ * @param scene The Phaser scene instance
+ * @param key Unique identifier for the state
+ * @param initialValue Initial value for the state
+ * @param maxHistorySize Maximum number of history entries to keep
+ * @returns Enhanced HookState with undo/redo capabilities
+ *
+ * @example
+ * ```typescript
+ * const undoableState = withUndoableState<string>(scene, 'text', 'initial', 10);
+ *
+ * undoableState.set('first change');
+ * undoableState.set('second change');
+ * undoableState.undo(); // Back to 'first change'
+ * undoableState.redo(); // Forward to 'second change'
+ * ```
+ */
+export declare const withUndoableState: <T>(scene: Phaser.Scene, key: string, initialValue: T, maxHistorySize: number) => UndoableHookState<T>;
+//# sourceMappingURL=with-undoable-state.d.ts.map

package/dist/hooks/with-undoable-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-undoable-state.d.ts","sourceRoot":"","sources":["../../src/hooks/with-undoable-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGxC;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,IAAI,IAAI,OAAO,CAAC;IAChB,IAAI,IAAI,OAAO,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC;IACnB,YAAY,IAAI,IAAI,CAAC;CACtB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAEjB;;;;;;;;;;;;;;;;;;GAkBG;AAIH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,OAAO,MAAM,CAAC,KAAK,EACnB,KAAK,MAAM,EACX,cAAc,CAAC,EACf,gBAAgB,MAAM,KACrB,iBAAiB,CAAC,CAAC,CAsFrB,CAAC"}

package/dist/hooks/with-undoable-state.js

@@ -0,0 +1,96 @@
+import { withLocalState } from './with-local-state';
+/**
+ * Creates a state hook with undo/redo functionality
+ * @template T The type of the state value
+ * @param scene The Phaser scene instance
+ * @param key Unique identifier for the state
+ * @param initialValue Initial value for the state
+ * @param maxHistorySize Maximum number of history entries to keep
+ * @returns Enhanced HookState with undo/redo capabilities
+ *
+ * @example
+ * ```typescript
+ * const undoableState = withUndoableState<string>(scene, 'text', 'initial', 10);
+ *
+ * undoableState.set('first change');
+ * undoableState.set('second change');
+ * undoableState.undo(); // Back to 'first change'
+ * undoableState.redo(); // Forward to 'second change'
+ * ```
+ */
+/* eslint-disable max-lines-per-function */
+/* eslint-disable complexity */
+/* eslint-disable sonarjs/cognitive-complexity */
+export const withUndoableState = (scene, key, initialValue, maxHistorySize) => {
+    const currentState = withLocalState(scene, key, initialValue);
+    const historyState = withLocalState(scene, `${key}:history`, [
+        initialValue,
+    ]);
+    const historyIndexState = withLocalState(scene, `${key}:historyIndex`, 0);
+    const addToHistory = (value) => {
+        const history = historyState.get();
+        const currentIndex = historyIndexState.get();
+        // Remove any "future" history if we're not at the end
+        const newHistory = history.slice(0, currentIndex + 1);
+        // Add new value
+        newHistory.push(value);
+        // Limit history size
+        if (newHistory.length > maxHistorySize) {
+            newHistory.shift();
+        }
+        else {
+            historyIndexState.set(currentIndex + 1);
+        }
+        historyState.set(newHistory);
+    };
+    const set = (value) => {
+        addToHistory(value);
+        currentState.set(value);
+    };
+    const undo = () => {
+        const currentIndex = historyIndexState.get();
+        if (currentIndex > 0) {
+            const newIndex = currentIndex - 1;
+            historyIndexState.set(newIndex);
+            const history = historyState.get();
+            const previousValue = history[newIndex];
+            if (previousValue !== undefined) {
+                currentState.set(previousValue);
+                return true;
+            }
+        }
+        return false;
+    };
+    const redo = () => {
+        const currentIndex = historyIndexState.get();
+        const history = historyState.get();
+        if (currentIndex < history.length - 1) {
+            const newIndex = currentIndex + 1;
+            historyIndexState.set(newIndex);
+            const nextValue = history[newIndex];
+            if (nextValue !== undefined) {
+                currentState.set(nextValue);
+                return true;
+            }
+        }
+        return false;
+    };
+    const canUndo = () => historyIndexState.get() > 0;
+    const canRedo = () => historyIndexState.get() < historyState.get().length - 1;
+    const clearHistory = () => {
+        const current = currentState.get();
+        historyState.set([current]);
+        historyIndexState.set(0);
+    };
+    return {
+        get: currentState.get,
+        set,
+        onChange: currentState.onChange,
+        undo,
+        redo,
+        canUndo,
+        canRedo,
+        clearHistory,
+    };
+};
+//# sourceMappingURL=with-undoable-state.js.map

package/dist/hooks/with-undoable-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-undoable-state.js","sourceRoot":"","sources":["../../src/hooks/with-undoable-state.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './utils';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './is-valid-scene';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from './is-valid-scene';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/utils/is-valid-scene.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility function to check if a scene is valid for state management
+ * @param scene The scene to validate
+ * @returns true if scene is valid, false otherwise
+ */
+export declare const isValidScene: (scene: unknown) => scene is Phaser.Scene;
+//# sourceMappingURL=is-valid-scene.d.ts.map

package/dist/utils/is-valid-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-scene.d.ts","sourceRoot":"","sources":["../../src/utils/is-valid-scene.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,KAO7D,CAAC"}

package/dist/utils/is-valid-scene.js

@@ -0,0 +1,12 @@
+/**
+ * Utility function to check if a scene is valid for state management
+ * @param scene The scene to validate
+ * @returns true if scene is valid, false otherwise
+ */
+export const isValidScene = (scene) => {
+    return (scene != null &&
+        typeof scene === 'object' &&
+        'registry' in scene &&
+        'scene' in scene);
+};
+//# sourceMappingURL=is-valid-scene.js.map

package/dist/utils/is-valid-scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-scene.js","sourceRoot":"","sources":["../../src/utils/is-valid-scene.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAyB,EAAE;IACpE,OAAO,CACL,KAAK,IAAI,IAAI;QACb,OAAO,KAAK,KAAK,QAAQ;QACzB,UAAU,IAAI,KAAK;QACnB,OAAO,IAAI,KAAK,CACjB,CAAC;AACJ,CAAC,CAAC"}

package/dist/utils/is-valid-scene.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=is-valid-scene.spec.d.ts.map

package/dist/utils/is-valid-scene.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-scene.spec.d.ts","sourceRoot":"","sources":["../../src/utils/is-valid-scene.spec.ts"],"names":[],"mappings":""}

package/dist/utils/is-valid-scene.spec.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest';
+import { isValidScene } from './is-valid-scene';
+describe('isValidScene', () => {
+    it('should return true for valid Phaser scene', () => {
+        const mockScene = {
+            registry: {},
+            scene: {},
+        };
+        expect(isValidScene(mockScene)).toBe(true);
+    });
+    it('should return false for invalid scene', () => {
+        expect(isValidScene(null)).toBe(false);
+        expect(isValidScene(undefined)).toBe(false);
+        expect(isValidScene({})).toBe(false);
+        expect(isValidScene({ registry: {} })).toBe(false);
+        expect(isValidScene({ scene: {} })).toBe(false);
+    });
+});
+//# sourceMappingURL=is-valid-scene.spec.js.map

package/dist/utils/is-valid-scene.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-scene.spec.js","sourceRoot":"","sources":["../../src/utils/is-valid-scene.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,SAAS,GAAG;YAChB,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;SACV,CAAC;QAEF,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "phaser-hooks",
+  "version": "0.1.0",
+  "description": "Hooks in react-style for Phaser games",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "phaser",
+    "game-development",
+    "hooks",
+    "typescript"
+  ],
+  "author": "CassinoDev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/renatocassino/phaser-toolkit.git",
+    "directory": "packages/phaser-hooks"
+  },
+  "bugs": {
+    "url": "https://github.com/renatocassino/phaser-toolkit/issues"
+  },
+  "homepage": "https://github.com/renatocassino/phaser-toolkit/tree/main/packages/phaser-hooks#readme",
+  "devDependencies": {
+    "@eslint-recommended/eslint-config": "^28.0.0",
+    "@types/node": "^24.1.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.55.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-prefer-arrow": "^1.2.3",
+    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-security": "^1.7.1",
+    "eslint-plugin-sonarjs": "^0.23.0",
+    "eslint-plugin-unicorn": "^50.0.1",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "phaser": "^3.70.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "dev": "tsc --build --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx --max-warnings 0",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "lint:report": "eslint src --ext .ts,.tsx --format html --output-file eslint-report.html"
+  }
+}