@oscarpalmer/mora 0.23.0 → 0.25.0

package/src/value/store.ts

@@ -1,12 +1,9 @@
 import {isKey, isPlainObject} from '@oscarpalmer/atoms/is';
-import type {
-	GenericCallback,
-	Key,
-	PlainObject,
-} from '@oscarpalmer/atoms/models';
+import type {GenericCallback, Key, PlainObject} from '@oscarpalmer/atoms/models';
 import {NAME_STORE} from '../constants';
 import {
 	getReactiveValueInProxy,
+	emityProxyValues,
 	setProxyValue,
 	setValueInProxy,
 } from '../helpers/proxy';
@@ -46,7 +43,7 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 	 * @param key Key of the value to get
 	 * @returns Value for the specified key, or `undefined` if it doesn't exist
 	 */
-	get(key: keyof Value): Value[keyof Value];
+	get<Key extends keyof Value>(key: Key): Value[Key];
 
 	/**
 	 * Get a value by key
@@ -61,27 +58,37 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 			: getValue(this.state);
 	}
 
+	/**
+	 * Notify dependents of changes
+	 *
+	 * _This bypasses equality checks and will immediately notify dependents.
+	 * Use this only if you're modifying nested data that would be ignored by equality checks._
+	 */
+	notify(): void {
+		emityProxyValues(this.state, this.#keyed);
+	}
+
 	/**
 	 * Get the value _(without reactivity)_
 	 * @returns The current value
 	 */
-	peek(): Value;
+	override peek(): Value;
 
 	/**
 	 * Get a value by key _(without reactivity)_
 	 * @param key Key of the value to get
 	 * @returns Value for the specified key, or `undefined` if it doesn't exist
 	 */
-	peek(key: keyof Value): Value[keyof Value];
+	override peek<Key extends keyof Value>(key: Key): Value[Key];
 
 	/**
 	 * Get a value by key _(without reactivity)_
 	 * @param key Key of the value to get
 	 * @returns Value for the specified key, or `undefined` if it doesn't exist
 	 */
-	peek(key: Key): unknown;
+	override peek(key: Key): unknown;
 
-	peek(key?: unknown): unknown {
+	override peek(key?: unknown): unknown {
 		return isKey(key) ? this.state.value[key] : {...this.state.value};
 	}
 
@@ -96,7 +103,7 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 	 * @param key Key of the value to set
 	 * @param value New value
 	 */
-	set(key: keyof Value, value: Value[keyof Value]): void;
+	set<Key extends keyof Value>(key: Key, value: Value[Key]): void;
 
 	/**
 	 * Set a value by key
@@ -116,7 +123,7 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 	/**
 	 * @inheritdoc
 	 */
-	subscribe(callback: (value: Value) => void): Unsubscribe;
+	override subscribe(callback: (value: Value) => void): Unsubscribe;
 
 	/**
 	 * Subscribe to changes for a specific key
@@ -124,7 +131,7 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 	 * @param callback Callback for changes
 	 * @returns Unsubscribe callback
 	 */
-	subscribe<Key extends keyof Value>(
+	override subscribe<Key extends keyof Value>(
 		key: Key,
 		callback: (value: Value[Key] | undefined) => void,
 	): Unsubscribe;
@@ -135,16 +142,11 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 	 * @param callback Callback for changes
 	 * @returns Unsubscribe callback
 	 */
-	subscribe(key: Key, callback: (value: unknown) => void): Unsubscribe;
+	override subscribe(key: Key, callback: (value: unknown) => void): Unsubscribe;
 
-	subscribe(
-		first: Key | GenericCallback,
-		second?: GenericCallback,
-	): Unsubscribe {
+	override subscribe(first: Key | GenericCallback, second?: GenericCallback): Unsubscribe {
 		if (isKey(first) && typeof second === 'function') {
-			return getReactiveValueInProxy(this, this.#keyed, first, false).subscribe(
-				second,
-			);
+			return getReactiveValueInProxy(this, this.#keyed, first, false).subscribe(second);
 		}
 
 		return typeof first === 'function' ? subscribe(this.state, first) : noop;
@@ -166,7 +168,7 @@ export class Store<Value extends PlainObject> extends Reactive<Value, Value> {
 /**
  * Create a reactive store
  * @param value Initial object value
- * @param options Optional reactivity options
+ * @param options Reactivity options
  * @returns Reactive store
  */
 export function store<Value extends PlainObject>(

package/types/constants.d.ts

@@ -9,6 +9,8 @@ export declare const METHODS_UPDATE: Set<string>;
 export declare const NAME_ARRAY = "array";
 export declare const NAME_COMPUTED = "computed";
 export declare const NAME_EFFECT = "effect";
+export declare const NAME_MORA = "$mora";
 export declare const NAME_SIGNAL = "signal";
 export declare const NAME_STORE = "store";
-export declare const NAMES: Set<string>;
+export declare const NAME_ALL: Set<string>;
+export declare const PROPERTY_LENGTH = "length";

package/types/helpers/proxy.d.ts

@@ -1,8 +1,10 @@
 import type { ArrayOrPlainObject, Key, PlainObject } from '@oscarpalmer/atoms/models';
-import type { SetValueInProxyParameters } from '../models';
+import type { ReactiveState, SetValueInProxyParameters } from '../models';
 import type { ReactiveArray } from '../value/array';
 import { type Computed } from '../value/computed';
 import type { Store } from '../value/store';
+export declare function emityProxyValues<Value>(state: ReactiveState<Value, Value>, mapped: Map<Key, Computed<unknown>>): void;
+export declare function emityProxyValues<Value>(state: ReactiveState<Value[], Value>, mapped: Map<Key, Computed<unknown>>): void;
 export declare function getReactiveValueInProxy<Value>(array: ReactiveArray<Value>, mapped: Map<Key, Computed<unknown>>, index: number, isArray: true): Computed<unknown>;
 export declare function getReactiveValueInProxy<Value extends PlainObject>(store: Store<Value>, mapped: Map<Key, Computed<unknown>>, key: Key, isArray: false): Computed<unknown>;
 export declare function setProxyValue(proxy: ArrayOrPlainObject, value: ArrayOrPlainObject): void;

package/types/index.d.ts

@@ -1,6 +1,6 @@
 export { startBatch, stopBatch } from './batch';
 export { effect, type Effect } from './effect';
-export { isArray, isComputed, isEffect, isReactive, isSignal, } from './helpers/is';
+export { isArray, isComputed, isEffect, isReactive, isSignal } from './helpers/is';
 export type { Unsubscribe } from './models';
 export { array, type ReactiveArray } from './value/array';
 export { computed, type Computed } from './value/computed';

package/types/value/array.d.ts

@@ -131,7 +131,7 @@ export declare class ReactiveArray<Item> extends Reactive<Item[], Item> {
 /**
  * Create a reactive array
  * @param value Initial array of items
- * @param options Optional reactivity options
+ * @param options Reactivity options
  * @returns Reactive array
  */
 export declare function array<Item>(value: Item[], options?: ReactiveOptions<Item>): ReactiveArray<Item>;

package/types/value/computed.d.ts

@@ -10,5 +10,8 @@ export declare class Computed<Value> extends Reactive<Value> {
 }
 /**
  * Create a computed value
+ * @param callback Callback to compute the value
+ * @param options Reactivity options
+ * @returns Computed value
  */
 export declare function computed<Value>(callback: () => Value, options?: ReactiveOptions<Value>): Computed<Value>;

package/types/value/signal.d.ts

@@ -20,7 +20,7 @@ export declare class Signal<Value> extends Reactive<Value> {
 /**
  * Create a reactive value
  * @param value Initial value
- * @param options Optional reactivity options
+ * @param options Reactivity options
  * @returns Reactive value
  */
 export declare function signal<Value>(value: Value, options?: ReactiveOptions<Value>): Signal<Value>;

package/types/value/store.d.ts

@@ -13,13 +13,20 @@ export declare class Store<Value extends PlainObject> extends Reactive<Value, Va
      * @param key Key of the value to get
      * @returns Value for the specified key, or `undefined` if it doesn't exist
      */
-    get(key: keyof Value): Value[keyof Value];
+    get<Key extends keyof Value>(key: Key): Value[Key];
     /**
      * Get a value by key
      * @param key Key of the value to get
      * @returns Value for the specified key, or `undefined` if it doesn't exist
      */
     get(key: Key): unknown;
+    /**
+     * Notify dependents of changes
+     *
+     * _This bypasses equality checks and will immediately notify dependents.
+     * Use this only if you're modifying nested data that would be ignored by equality checks._
+     */
+    notify(): void;
     /**
      * Get the value _(without reactivity)_
      * @returns The current value
@@ -30,7 +37,7 @@ export declare class Store<Value extends PlainObject> extends Reactive<Value, Va
      * @param key Key of the value to get
      * @returns Value for the specified key, or `undefined` if it doesn't exist
      */
-    peek(key: keyof Value): Value[keyof Value];
+    peek<Key extends keyof Value>(key: Key): Value[Key];
     /**
      * Get a value by key _(without reactivity)_
      * @param key Key of the value to get
@@ -47,7 +54,7 @@ export declare class Store<Value extends PlainObject> extends Reactive<Value, Va
      * @param key Key of the value to set
      * @param value New value
      */
-    set(key: keyof Value, value: Value[keyof Value]): void;
+    set<Key extends keyof Value>(key: Key, value: Value[Key]): void;
     /**
      * Set a value by key
      * @param key Key of the value to set
@@ -81,7 +88,7 @@ export declare class Store<Value extends PlainObject> extends Reactive<Value, Va
 /**
  * Create a reactive store
  * @param value Initial object value
- * @param options Optional reactivity options
+ * @param options Reactivity options
  * @returns Reactive store
  */
 export declare function store<Value extends PlainObject>(value: Value, options?: ReactiveOptions<Value>): Store<Value>;