@scarlett-player/core 0.1.0 → 0.1.2

package/dist/state/state-manager.d.ts

@@ -0,0 +1,199 @@
+/**
+ * StateManager - Centralized reactive state management for Scarlett Player.
+ *
+ * Manages all player state using reactive signals. Each state property
+ * is a Signal that can be observed for changes.
+ *
+ * Target size: ~1-2KB (excluding type definitions)
+ */
+import { type Signal } from './signal';
+import type { StateStore, StateKey, StateValue, StateUpdate, StateChangeEvent } from '../types/state';
+/**
+ * StateManager manages all player state using reactive signals.
+ *
+ * Each state property is a Signal that automatically tracks dependencies
+ * and notifies subscribers when changed.
+ *
+ * @example
+ * ```ts
+ * const state = new StateManager();
+ *
+ * // Get a signal
+ * const playingSignal = state.get('playing');
+ * playingSignal.get(); // false
+ *
+ * // Set a value
+ * state.set('playing', true);
+ *
+ * // Subscribe to changes
+ * state.subscribe((event) => {
+ *   console.log(`${event.key} changed to`, event.value);
+ * });
+ *
+ * // Batch updates
+ * state.update({
+ *   playing: true,
+ *   currentTime: 10,
+ *   volume: 0.8,
+ * });
+ * ```
+ */
+export declare class StateManager {
+    /** Internal map of state signals */
+    private signals;
+    /** Global state change subscribers */
+    private changeSubscribers;
+    /**
+     * Create a new StateManager with default initial state.
+     *
+     * @param initialState - Optional partial initial state (merged with defaults)
+     */
+    constructor(initialState?: Partial<StateStore>);
+    /**
+     * Initialize all state signals with default or provided values.
+     * @private
+     */
+    private initializeSignals;
+    /**
+     * Get the signal for a state property.
+     *
+     * @param key - State property key
+     * @returns Signal for the property
+     *
+     * @example
+     * ```ts
+     * const playingSignal = state.get('playing');
+     * playingSignal.get(); // false
+     * playingSignal.set(true);
+     * ```
+     */
+    get<K extends StateKey>(key: K): Signal<StateValue<K>>;
+    /**
+     * Get the current value of a state property (convenience method).
+     *
+     * @param key - State property key
+     * @returns Current value
+     *
+     * @example
+     * ```ts
+     * state.getValue('playing'); // false
+     * ```
+     */
+    getValue<K extends StateKey>(key: K): StateValue<K>;
+    /**
+     * Set the value of a state property.
+     *
+     * @param key - State property key
+     * @param value - New value
+     *
+     * @example
+     * ```ts
+     * state.set('playing', true);
+     * state.set('currentTime', 10.5);
+     * ```
+     */
+    set<K extends StateKey>(key: K, value: StateValue<K>): void;
+    /**
+     * Update multiple state properties at once (batch update).
+     *
+     * More efficient than calling set() multiple times.
+     *
+     * @param updates - Partial state object with updates
+     *
+     * @example
+     * ```ts
+     * state.update({
+     *   playing: true,
+     *   currentTime: 0,
+     *   volume: 1.0,
+     * });
+     * ```
+     */
+    update(updates: StateUpdate): void;
+    /**
+     * Subscribe to changes on a specific state property.
+     *
+     * @param key - State property key
+     * @param callback - Callback function receiving new value
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```ts
+     * const unsub = state.subscribe('playing', (value) => {
+     *   console.log('Playing:', value);
+     * });
+     * ```
+     */
+    subscribeToKey<K extends StateKey>(key: K, callback: (value: StateValue<K>) => void): () => void;
+    /**
+     * Subscribe to all state changes.
+     *
+     * Receives a StateChangeEvent for every state property change.
+     *
+     * @param callback - Callback function receiving change events
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```ts
+     * const unsub = state.subscribe((event) => {
+     *   console.log(`${event.key} changed:`, event.value);
+     * });
+     * ```
+     */
+    subscribe(callback: (event: StateChangeEvent) => void): () => void;
+    /**
+     * Notify all global change subscribers.
+     * @private
+     */
+    private notifyChangeSubscribers;
+    /**
+     * Reset all state to default values.
+     *
+     * @example
+     * ```ts
+     * state.reset();
+     * ```
+     */
+    reset(): void;
+    /**
+     * Reset a specific state property to its default value.
+     *
+     * @param key - State property key
+     *
+     * @example
+     * ```ts
+     * state.resetKey('playing');
+     * ```
+     */
+    resetKey<K extends StateKey>(key: K): void;
+    /**
+     * Get a snapshot of all current state values.
+     *
+     * @returns Frozen snapshot of current state
+     *
+     * @example
+     * ```ts
+     * const snapshot = state.snapshot();
+     * console.log(snapshot.playing, snapshot.currentTime);
+     * ```
+     */
+    snapshot(): Readonly<StateStore>;
+    /**
+     * Get the number of subscribers for a state property (for debugging).
+     *
+     * @param key - State property key
+     * @returns Number of subscribers
+     * @internal
+     */
+    getSubscriberCount(key: StateKey): number;
+    /**
+     * Destroy the state manager and cleanup all signals.
+     *
+     * @example
+     * ```ts
+     * state.destroy();
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=state-manager.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scarlett-player/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Core player with plugin system for Scarlett Player",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -19,7 +19,7 @@
   "scripts": {
     "dev": "vite",
     "demo": "vite",
-    "build": "tsc && vite build",
+    "build": "rm -f tsconfig.tsbuildinfo && tsc && vite build",
     "test": "vitest --run",
     "test:watch": "vitest",
     "test:coverage": "vitest --coverage",
@@ -47,7 +47,7 @@
   "bugs": {
     "url": "https://github.com/Hackney-Enterprises-Inc/scarlett-player/issues"
   },
-  "homepage": "https://github.com/Hackney-Enterprises-Inc/scarlett-player#readme",
+  "homepage": "https://scarlettplayer.com",
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^1.1.0",