@videojs/spf 10.0.0-beta.11 → 10.0.0-beta.13

package/dist/dev/core/state/create-state.d.ts

@@ -1,104 +0,0 @@
-//#region src/core/state/create-state.d.ts
-/**
- * Reactive state container with selectors, custom equality, and batched updates.
- *
- * Manages both immutable state values and mutable object references (e.g., HTMLMediaElement).
- */
-declare const STATE_SYMBOL: unique symbol;
-/**
- * State change listener for full-state subscriptions.
- */
-type StateListener<T> = (current: T) => void;
-/**
- * Selector function to derive a value from state.
- */
-type StateSelector<T, R> = (state: T) => R;
-/**
- * Listener for selector-based subscriptions.
- */
-type SelectorListener<R> = (current: R) => void;
-/**
- * Options for selector subscriptions.
- */
-interface SelectorOptions<R> {
-  /**
-   * Custom equality function for selected value.
-   * Defaults to Object.is
-   */
-  equalityFn?: (a: R, b: R) => boolean;
-}
-/**
- * Configuration for creating a state container.
- */
-interface StateConfig<T> {
-  /**
-   * Custom equality function for change detection.
-   * Defaults to Object.is for top-level comparison.
-   */
-  equalityFn?: (a: T, b: T) => boolean;
-}
-/**
- * Read-only state interface.
- */
-interface State<T> {
-  /** Symbol for type identification */
-  readonly [STATE_SYMBOL]: true;
-  /** Current state snapshot */
-  readonly current: T;
-  /** Subscribe to state changes */
-  subscribe(listener: StateListener<T>): () => void;
-}
-/**
- * Writable state interface with patch capability.
- */
-interface WritableState<T> extends State<T> {
-  /** Update state with partial object (for object state) or full value (for primitive state) */
-  patch(partial: T extends object ? Partial<T> : T): void;
-  /** Subscribe to full-state changes */
-  subscribe(listener: StateListener<T>): () => void;
-  /** Subscribe to selected value changes */
-  subscribe<R>(selector: StateSelector<T, R>, listener: SelectorListener<R>, options?: SelectorOptions<R>): () => void;
-  /** Manually flush pending updates */
-  flush(): void;
-}
-/**
- * Create a reactive state container.
- *
- * @example
- * ```typescript
- * const state = createState({ count: 0 });
- *
- * // Subscribe to changes
- * state.subscribe((current, prev) => {
- *   console.log('Changed:', prev, '->', current);
- * });
- *
- * // Updates are batched
- * state.patch({ count: 1 });
- * state.patch({ count: 2 });
- * // Only one notification fires (with count: 2)
- * ```
- *
- * @example Selector subscriptions
- * ```typescript
- * const state = createState({ count: 0, name: 'test' });
- *
- * // Only notified when count changes
- * state.subscribe(
- *   s => s.count,
- *   (current, prev) => console.log(current, prev)
- * );
- * ```
- *
- * @example Custom equality
- * ```typescript
- * const state = createState(
- *   { count: 0, name: 'test' },
- *   { equalityFn: (a, b) => a.count === b.count }
- * );
- * ```
- */
-declare function createState<T>(initial: T, config?: StateConfig<T>): WritableState<T>;
-//#endregion
-export { WritableState, createState };
-//# sourceMappingURL=create-state.d.ts.map

package/dist/dev/core/state/create-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-state.d.ts","names":[],"sources":["../../../../src/core/state/create-state.ts"],"mappings":";;;;;;cAUM,YAAA;AASN;;;AAAA,KAAY,aAAA,OAAoB,OAAA,EAAS,CAAA;;;;KAK7B,aAAA,UAAuB,KAAA,EAAO,CAAA,KAAM,CAAA;;AAAhD;;KAKY,gBAAA,OAAuB,OAAA,EAAS,CAAA;;;;UAK3B,eAAA;EAVkB;;;;EAejC,UAAA,IAAc,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA;;;;UAMR,WAAA;EAhBkB;;;AAKnC;EAgBE,UAAA,IAAc,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA;;;;UAMR,KAAA;EAjBD;EAAA,UAmBJ,YAAA;EAnBU;EAAA,SAsBX,OAAA,EAAS,CAAA;EAtBM;EAyBxB,SAAA,CAAU,QAAA,EAAU,aAAA,CAAc,CAAA;AAAA;;;;UAMnB,aAAA,YAAyB,KAAA,CAAM,CAAA;EApB7B;EAsBjB,KAAA,CAAM,OAAA,EAAS,CAAA,kBAAmB,OAAA,CAAQ,CAAA,IAAK,CAAA;EAtBxB;EAyBvB,SAAA,CAAU,QAAA,EAAU,aAAA,CAAc,CAAA;EAzBV;EA4BxB,SAAA,IAAa,QAAA,EAAU,aAAA,CAAc,CAAA,EAAG,CAAA,GAAI,QAAA,EAAU,gBAAA,CAAiB,CAAA,GAAI,OAAA,GAAU,eAAA,CAAgB,CAAA;EAtBtF;EAyBf,KAAA;AAAA;;;;;;;;;;;;;;;;;AAXF;;;;;;;;;;;;;;;;;;;;;iBA4NgB,WAAA,GAAA,CAAe,OAAA,EAAS,CAAA,EAAG,MAAA,GAAS,WAAA,CAAY,CAAA,IAAK,aAAA,CAAc,CAAA"}

package/dist/dev/core/state/create-state.js

@@ -1,143 +0,0 @@
-//#region src/core/state/create-state.ts
-/**
-* Reactive state container with selectors, custom equality, and batched updates.
-*
-* Manages both immutable state values and mutable object references (e.g., HTMLMediaElement).
-*/
-const STATE_SYMBOL = Symbol("@videojs/spf/state");
-/**
-* Default equality function using Object.is.
-*/
-function defaultEquality(a, b) {
-	return Object.is(a, b);
-}
-/**
-* State container implementation.
-*/
-var StateContainer = class {
-	[STATE_SYMBOL] = true;
-	#current;
-	#pending = null;
-	#pendingFlush = false;
-	#equalityFn;
-	#listeners = /* @__PURE__ */ new Set();
-	#selectorListeners = /* @__PURE__ */ new Set();
-	constructor(initial, config) {
-		this.#current = typeof initial === "object" && initial !== null ? { ...initial } : initial;
-		this.#equalityFn = config?.equalityFn ?? defaultEquality;
-	}
-	get current() {
-		return this.#pending ?? this.#current;
-	}
-	patch(partial) {
-		const base = this.#pending ?? this.#current;
-		if (typeof base !== "object" || base === null) {
-			const value = partial;
-			if (!Object.is(base, value)) {
-				this.#pending = value;
-				this.#scheduleFlush();
-			}
-			return;
-		}
-		const next = { ...base };
-		let changed = false;
-		for (const key in partial) {
-			if (!Object.hasOwn(partial, key)) continue;
-			const value = partial[key];
-			if (!Object.is(base[key], value)) {
-				next[key] = value;
-				changed = true;
-			}
-		}
-		if (changed) {
-			this.#pending = next;
-			this.#scheduleFlush();
-		}
-	}
-	subscribe(selectorOrListener, maybeListener, options) {
-		if (maybeListener === void 0) {
-			const listener = selectorOrListener;
-			this.#listeners.add(listener);
-			listener(this.current);
-			return () => {
-				this.#listeners.delete(listener);
-			};
-		}
-		const selector = selectorOrListener;
-		const listener = maybeListener;
-		const entry = {
-			selector,
-			listener,
-			options: options ?? {}
-		};
-		this.#selectorListeners.add(entry);
-		listener(selector(this.current));
-		return () => {
-			this.#selectorListeners.delete(entry);
-		};
-	}
-	flush() {
-		if (this.#pending === null) return;
-		const prev = this.#current;
-		const next = this.#pending;
-		this.#pending = null;
-		this.#pendingFlush = false;
-		if (this.#equalityFn(prev, next)) return;
-		this.#current = next;
-		for (const listener of this.#listeners) listener(this.#current);
-		for (const entry of this.#selectorListeners) {
-			const prevSelected = entry.selector(prev);
-			const nextSelected = entry.selector(this.#current);
-			if (!(entry.options.equalityFn ?? Object.is)(prevSelected, nextSelected)) entry.listener(nextSelected);
-		}
-	}
-	#scheduleFlush() {
-		if (this.#pendingFlush) return;
-		this.#pendingFlush = true;
-		queueMicrotask(() => this.flush());
-	}
-};
-/**
-* Create a reactive state container.
-*
-* @example
-* ```typescript
-* const state = createState({ count: 0 });
-*
-* // Subscribe to changes
-* state.subscribe((current, prev) => {
-*   console.log('Changed:', prev, '->', current);
-* });
-*
-* // Updates are batched
-* state.patch({ count: 1 });
-* state.patch({ count: 2 });
-* // Only one notification fires (with count: 2)
-* ```
-*
-* @example Selector subscriptions
-* ```typescript
-* const state = createState({ count: 0, name: 'test' });
-*
-* // Only notified when count changes
-* state.subscribe(
-*   s => s.count,
-*   (current, prev) => console.log(current, prev)
-* );
-* ```
-*
-* @example Custom equality
-* ```typescript
-* const state = createState(
-*   { count: 0, name: 'test' },
-*   { equalityFn: (a, b) => a.count === b.count }
-* );
-* ```
-*/
-function createState(initial, config) {
-	return new StateContainer(initial, config);
-}
-
-//#endregion
-export { createState };
-//# sourceMappingURL=create-state.js.map

package/dist/dev/core/state/create-state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-state.js","names":["#current","#equalityFn","#pending","#scheduleFlush","#listeners","#selectorListeners","#pendingFlush"],"sources":["../../../../src/core/state/create-state.ts"],"sourcesContent":["/**\n * Reactive state container with selectors, custom equality, and batched updates.\n *\n * Manages both immutable state values and mutable object references (e.g., HTMLMediaElement).\n */\n\n// =============================================================================\n// Symbol for type identification\n// =============================================================================\n\nconst STATE_SYMBOL = Symbol('@videojs/spf/state');\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * State change listener for full-state subscriptions.\n */\nexport type StateListener<T> = (current: T) => void;\n\n/**\n * Selector function to derive a value from state.\n */\nexport type StateSelector<T, R> = (state: T) => R;\n\n/**\n * Listener for selector-based subscriptions.\n */\nexport type SelectorListener<R> = (current: R) => void;\n\n/**\n * Options for selector subscriptions.\n */\nexport interface SelectorOptions<R> {\n  /**\n   * Custom equality function for selected value.\n   * Defaults to Object.is\n   */\n  equalityFn?: (a: R, b: R) => boolean;\n}\n\n/**\n * Configuration for creating a state container.\n */\nexport interface StateConfig<T> {\n  /**\n   * Custom equality function for change detection.\n   * Defaults to Object.is for top-level comparison.\n   */\n  equalityFn?: (a: T, b: T) => boolean;\n}\n\n/**\n * Read-only state interface.\n */\nexport interface State<T> {\n  /** Symbol for type identification */\n  readonly [STATE_SYMBOL]: true;\n\n  /** Current state snapshot */\n  readonly current: T;\n\n  /** Subscribe to state changes */\n  subscribe(listener: StateListener<T>): () => void;\n}\n\n/**\n * Writable state interface with patch capability.\n */\nexport interface WritableState<T> extends State<T> {\n  /** Update state with partial object (for object state) or full value (for primitive state) */\n  patch(partial: T extends object ? Partial<T> : T): void;\n\n  /** Subscribe to full-state changes */\n  subscribe(listener: StateListener<T>): () => void;\n\n  /** Subscribe to selected value changes */\n  subscribe<R>(selector: StateSelector<T, R>, listener: SelectorListener<R>, options?: SelectorOptions<R>): () => void;\n\n  /** Manually flush pending updates */\n  flush(): void;\n}\n\n/**\n * Entry for selector subscriptions.\n */\ninterface SelectorEntry<T, R> {\n  selector: StateSelector<T, R>;\n  listener: SelectorListener<R>;\n  options: SelectorOptions<R>;\n}\n\n// =============================================================================\n// Default equality function\n// =============================================================================\n\n/**\n * Default equality function using Object.is.\n */\nfunction defaultEquality<T>(a: T, b: T): boolean {\n  return Object.is(a, b);\n}\n\n// =============================================================================\n// Implementation\n// =============================================================================\n\n/**\n * State container implementation.\n */\nclass StateContainer<T> implements WritableState<T> {\n  [STATE_SYMBOL] = true as const;\n\n  #current: T;\n  #pending: T | null = null;\n  #pendingFlush = false;\n  #equalityFn: (a: T, b: T) => boolean;\n\n  // Full-state listeners\n  #listeners = new Set<StateListener<T>>();\n\n  // Selector-based listeners\n  #selectorListeners = new Set<SelectorEntry<T, unknown>>();\n\n  constructor(initial: T, config?: StateConfig<T>) {\n    this.#current = typeof initial === 'object' && initial !== null ? ({ ...initial } as T) : initial;\n    this.#equalityFn = config?.equalityFn ?? defaultEquality;\n  }\n\n  get current(): T {\n    // Return pending state if available (for chained patches)\n    return this.#pending ?? this.#current;\n  }\n\n  patch(partial: T extends object ? Partial<T> : T): void {\n    const base = this.#pending ?? this.#current;\n\n    if (typeof base !== 'object' || base === null) {\n      // Primitive state: replace the whole value\n      const value = partial as T;\n      if (!Object.is(base, value)) {\n        this.#pending = value;\n        this.#scheduleFlush();\n      }\n      return;\n    }\n\n    const next = { ...base } as T;\n    let changed = false;\n\n    // Apply partial updates with change detection\n    for (const key in partial) {\n      if (!Object.hasOwn(partial as any, key)) continue;\n\n      const value = (partial as Partial<T>)[key as keyof T];\n\n      if (!Object.is((base as Partial<T>)[key as keyof T], value)) {\n        (next as Partial<T>)[key as keyof T] = value;\n        changed = true;\n      }\n    }\n\n    if (changed) {\n      this.#pending = next;\n      this.#scheduleFlush();\n    }\n  }\n\n  subscribe(listener: StateListener<T>): () => void;\n  subscribe<R>(selector: StateSelector<T, R>, listener: SelectorListener<R>, options?: SelectorOptions<R>): () => void;\n  subscribe<R>(\n    selectorOrListener: StateListener<T> | StateSelector<T, R>,\n    maybeListener?: SelectorListener<R>,\n    options?: SelectorOptions<R>\n  ): () => void {\n    // Overload 1: Full-state subscription\n    if (maybeListener === undefined) {\n      const listener = selectorOrListener as StateListener<T>;\n      this.#listeners.add(listener);\n\n      // Fire immediately with current state\n      listener(this.current);\n\n      return () => {\n        this.#listeners.delete(listener);\n      };\n    }\n\n    // Overload 2: Selector subscription\n    const selector = selectorOrListener as StateSelector<T, R>;\n    const listener = maybeListener;\n    const opts = options ?? {};\n\n    const entry: SelectorEntry<T, unknown> = {\n      selector: selector as StateSelector<T, unknown>,\n      listener: listener as SelectorListener<unknown>,\n      options: opts as SelectorOptions<unknown>,\n    };\n\n    this.#selectorListeners.add(entry);\n\n    // Fire immediately with current selected value\n    const selected = selector(this.current);\n    listener(selected);\n\n    return () => {\n      this.#selectorListeners.delete(entry);\n    };\n  }\n\n  flush(): void {\n    if (this.#pending === null) return;\n\n    const prev = this.#current;\n    const next = this.#pending;\n    this.#pending = null;\n    this.#pendingFlush = false;\n\n    // Check if state actually changed using custom equality\n    if (this.#equalityFn(prev, next)) return;\n\n    this.#current = next;\n\n    // Notify full-state listeners\n    for (const listener of this.#listeners) {\n      listener(this.#current);\n    }\n\n    // Notify selector listeners\n    for (const entry of this.#selectorListeners) {\n      const prevSelected = entry.selector(prev);\n      const nextSelected = entry.selector(this.#current);\n\n      const equalityFn = entry.options.equalityFn ?? Object.is;\n\n      if (!equalityFn(prevSelected, nextSelected)) {\n        entry.listener(nextSelected);\n      }\n    }\n  }\n\n  #scheduleFlush(): void {\n    if (this.#pendingFlush) return;\n    this.#pendingFlush = true;\n    queueMicrotask(() => this.flush());\n  }\n}\n\n// =============================================================================\n// Factory function\n// =============================================================================\n\n/**\n * Create a reactive state container.\n *\n * @example\n * ```typescript\n * const state = createState({ count: 0 });\n *\n * // Subscribe to changes\n * state.subscribe((current, prev) => {\n *   console.log('Changed:', prev, '->', current);\n * });\n *\n * // Updates are batched\n * state.patch({ count: 1 });\n * state.patch({ count: 2 });\n * // Only one notification fires (with count: 2)\n * ```\n *\n * @example Selector subscriptions\n * ```typescript\n * const state = createState({ count: 0, name: 'test' });\n *\n * // Only notified when count changes\n * state.subscribe(\n *   s => s.count,\n *   (current, prev) => console.log(current, prev)\n * );\n * ```\n *\n * @example Custom equality\n * ```typescript\n * const state = createState(\n *   { count: 0, name: 'test' },\n *   { equalityFn: (a, b) => a.count === b.count }\n * );\n * ```\n */\nexport function createState<T>(initial: T, config?: StateConfig<T>): WritableState<T> {\n  return new StateContainer(initial, config);\n}\n\n// =============================================================================\n// Type guard\n// =============================================================================\n\n/**\n * Check if a value is a State container.\n */\nexport function isState(value: unknown): value is State<object> {\n  return typeof value === 'object' && value !== null && STATE_SYMBOL in value;\n}\n"],"mappings":";;;;;;AAUA,MAAM,eAAe,OAAO,qBAAqB;;;;AA0FjD,SAAS,gBAAmB,GAAM,GAAe;AAC/C,QAAO,OAAO,GAAG,GAAG,EAAE;;;;;AAUxB,IAAM,iBAAN,MAAoD;CAClD,CAAC,gBAAgB;CAEjB;CACA,WAAqB;CACrB,gBAAgB;CAChB;CAGA,6BAAa,IAAI,KAAuB;CAGxC,qCAAqB,IAAI,KAAgC;CAEzD,YAAY,SAAY,QAAyB;AAC/C,QAAKA,UAAW,OAAO,YAAY,YAAY,YAAY,OAAQ,EAAE,GAAG,SAAS,GAAS;AAC1F,QAAKC,aAAc,QAAQ,cAAc;;CAG3C,IAAI,UAAa;AAEf,SAAO,MAAKC,WAAY,MAAKF;;CAG/B,MAAM,SAAkD;EACtD,MAAM,OAAO,MAAKE,WAAY,MAAKF;AAEnC,MAAI,OAAO,SAAS,YAAY,SAAS,MAAM;GAE7C,MAAM,QAAQ;AACd,OAAI,CAAC,OAAO,GAAG,MAAM,MAAM,EAAE;AAC3B,UAAKE,UAAW;AAChB,UAAKC,eAAgB;;AAEvB;;EAGF,MAAM,OAAO,EAAE,GAAG,MAAM;EACxB,IAAI,UAAU;AAGd,OAAK,MAAM,OAAO,SAAS;AACzB,OAAI,CAAC,OAAO,OAAO,SAAgB,IAAI,CAAE;GAEzC,MAAM,QAAS,QAAuB;AAEtC,OAAI,CAAC,OAAO,GAAI,KAAoB,MAAiB,MAAM,EAAE;AAC3D,IAAC,KAAoB,OAAkB;AACvC,cAAU;;;AAId,MAAI,SAAS;AACX,SAAKD,UAAW;AAChB,SAAKC,eAAgB;;;CAMzB,UACE,oBACA,eACA,SACY;AAEZ,MAAI,kBAAkB,QAAW;GAC/B,MAAM,WAAW;AACjB,SAAKC,UAAW,IAAI,SAAS;AAG7B,YAAS,KAAK,QAAQ;AAEtB,gBAAa;AACX,UAAKA,UAAW,OAAO,SAAS;;;EAKpC,MAAM,WAAW;EACjB,MAAM,WAAW;EAGjB,MAAM,QAAmC;GAC7B;GACA;GACV,SALW,WAAW,EAAE;GAMzB;AAED,QAAKC,kBAAmB,IAAI,MAAM;AAIlC,WADiB,SAAS,KAAK,QAAQ,CACrB;AAElB,eAAa;AACX,SAAKA,kBAAmB,OAAO,MAAM;;;CAIzC,QAAc;AACZ,MAAI,MAAKH,YAAa,KAAM;EAE5B,MAAM,OAAO,MAAKF;EAClB,MAAM,OAAO,MAAKE;AAClB,QAAKA,UAAW;AAChB,QAAKI,eAAgB;AAGrB,MAAI,MAAKL,WAAY,MAAM,KAAK,CAAE;AAElC,QAAKD,UAAW;AAGhB,OAAK,MAAM,YAAY,MAAKI,UAC1B,UAAS,MAAKJ,QAAS;AAIzB,OAAK,MAAM,SAAS,MAAKK,mBAAoB;GAC3C,MAAM,eAAe,MAAM,SAAS,KAAK;GACzC,MAAM,eAAe,MAAM,SAAS,MAAKL,QAAS;AAIlD,OAAI,EAFe,MAAM,QAAQ,cAAc,OAAO,IAEtC,cAAc,aAAa,CACzC,OAAM,SAAS,aAAa;;;CAKlC,iBAAuB;AACrB,MAAI,MAAKM,aAAe;AACxB,QAAKA,eAAgB;AACrB,uBAAqB,KAAK,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CtC,SAAgB,YAAe,SAAY,QAA2C;AACpF,QAAO,IAAI,eAAe,SAAS,OAAO"}