@oscarpalmer/mora 0.31.0 → 0.32.0

package/dist/models.d.mts

@@ -1,25 +1,26 @@
 import { PROPERTY_LENGTH } from "./constants.mjs";
+import { Subscription, Subscriptions } from "@oscarpalmer/atoms/subscription";
 import { GenericCallback, Key, PlainObject } from "@oscarpalmer/atoms/models";
 //#region src/models.d.ts
-type Active = {
+export type Active = {
   computed?: ComputedEffect;
   effect?: EffectState;
 };
-type Batch = {
+export type Batch = {
   depth: number;
   flushing: boolean;
-  handlers: Set<EffectState | Subscription>;
+  handlers: Map<EffectState | Subscription, EffectState | StoredSubscription>;
 };
-type Computed<Value> = Reactive<Value> & SimpleReactive<Value>;
-type ComputedEffect = {
+export type Computed<Value> = Reactive<Value> & SimpleReactive<Value>;
+export type ComputedEffect = {
   dirty: boolean;
   instance: EffectState;
 };
-type Effect = {};
-type EffectState = {
+export type Effect = {};
+export type EffectState = {
   callback: GenericCallback;
 };
-type Reactive<Value> = {
+export type Reactive<Value> = {
   /**
    * JSON representation of the value
    *
@@ -33,7 +34,7 @@ type Reactive<Value> = {
    */
   toString(): string;
 };
-type ReactiveArray<Item> = {
+export type ReactiveArray<Item> = {
   /**
    * The length of the array
    */
@@ -187,36 +188,25 @@ type ReactiveArray<Item> = {
    * Subscribe to changes
    *
    * @param callback Callback for changes
-   * @returns Unsubscribe callback
+   * @param copy Copy the array? _(defaults to `false`)_
+   * @returns Subscription
    */
-  subscribe(callback: (value: Item[]) => void): Unsubscribe;
+  subscribe(callback: (value: Item[]) => void, copy?: boolean): Subscription;
   /**
    * Subscribe to changes at a specific index
    *
    * @param index Index of item to subscribe to
    * @param callback Callback for changes
-   * @returns Unsubscribe callback
+   * @param copy If the item is an array or record, should it be copied? _(defaults to `false`)_
+   * @returns Subscription
    */
-  subscribe(index: number, callback: (value: Item | undefined) => void): Unsubscribe;
+  subscribe(index: number, callback: (value: Item | undefined) => void, copy?: boolean): Subscription;
   /**
    * Add items to the beginning of the array
    * @param items Items to add
    * @returns New array length
    */
   unshift(...items: Item[]): number;
-  /**
-   * Unsubscribe from changes for a specific index
-   *
-   * @param index Index of the value to unsubscribe from
-   * @param callback Callback to unsubscribe
-   */
-  unsubscribe(index: number, callback: (item: Item | undefined) => void): void;
-  /**
-   * Unsubscribe from changes
-   *
-   * @param callback Callback to unsubscribe
-   */
-  unsubscribe(callback: (array: Item[]) => void): void;
   /**
    * Update the value _(based on the current value)_
    *
@@ -224,7 +214,7 @@ type ReactiveArray<Item> = {
    */
   update(callback: (value: Item[]) => Item[]): void;
 } & Reactive<Item[]>;
-type ReactiveOptions<Value> = {
+export type ReactiveOptions<Value> = {
   /**
    * Method for comparing values for equality
    * @param first First value
@@ -234,16 +224,16 @@ type ReactiveOptions<Value> = {
    */
   equal?: (first: Value, second: Value) => boolean;
 };
-type ReactiveState<Value, Equal> = {
+export type ReactiveState<Value, Item = Value> = {
   computeds: Set<ComputedEffect>;
   effects: Set<EffectState>;
-  equal: (first: Equal, second: Equal) => boolean;
+  equal: (first: Item, second: Item) => boolean;
   promise?: Promise<Value>;
   promises?: Map<Key, Promise<never>>;
-  subscriptions: Map<GenericCallback, Subscription>;
+  subscriptions?: Subscriptions<GenericCallback>;
   value: Value;
 };
-type ReactiveStore<Store> = {
+export type ReactiveStore<Store> = {
   /**
    * Get a readonly version of the reactive store
    *
@@ -332,45 +322,28 @@ type ReactiveStore<Store> = {
    * Subscribe to changes
    *
    * @param callback Callback for changes
-   * @returns Unsubscribe callback
+   * @param copy Copy the store? _(defaults to `false`)_
+   * @returns Subscription
    */
-  subscribe(callback: (value: Store) => void): Unsubscribe;
+  subscribe(callback: (value: Store) => void, copy?: boolean): Subscription;
   /**
    * Subscribe to changes for a specific key
    *
    * @param key Key of the value to subscribe to
    * @param callback Callback for changes
-   * @returns Unsubscribe callback
+   * @param copy If the value is an array or record, should it be copied? _(defaults to `false`)_
+   * @returns Subscription
    */
-  subscribe<Key extends keyof Store>(key: Key, callback: (value: Store[Key] | undefined) => void): Unsubscribe;
+  subscribe<Key extends keyof Store>(key: Key, callback: (value: Store[Key] | undefined) => void, copy?: boolean): Subscription;
   /**
    * Subscribe to changes for a specific key
    *
    * @param key Key of the value to subscribe to
    * @param callback Callback for changes
-   * @returns Unsubscribe callback
-   */
-  subscribe(key: Key, callback: (value: unknown) => void): Unsubscribe;
-  /**
-   * Unsubscribe from changes for a specific key
-   *
-   * @param key Key of the value to unsubscribe from
-   * @param callback Callback to unsubscribe
-   */
-  unsubscribe<Key extends keyof Store>(key: Key, callback: (value: Store[Key] | undefined) => void): void;
-  /**
-   * Unsubscribe from changes for a specific key
-   *
-   * @param key Key of the value to unsubscribe from
-   * @param callback Callback to unsubscribe
-   */
-  unsubscribe(key: Key, callback: (value: unknown | undefined) => void): void;
-  /**
-   * Unsubscribe from changes
-   *
-   * @param callback Callback to unsubscribe
+   * @param copy If the value is an array or record, should it be copied? _(defaults to `false`)_
+   * @returns Subscription
    */
-  unsubscribe(callback: (value: Store) => void): void;
+  subscribe(key: Key, callback: (value: unknown) => void, copy?: boolean): Subscription;
   /**
    * Update the value _(based on the current value)_
    *
@@ -378,27 +351,19 @@ type ReactiveStore<Store> = {
    */
   update(callback: (value: Store) => Store): void;
 } & Reactive<Store>;
-type ReadonlyInstances<Value> = {
+export type ReadonlyInstances<Value> = {
   frozen?: ReadonlyFrozenSignal<Value>;
   original?: ReadonlySignal<Value>;
 };
-type ReadonlyFrozenSignal<Value> = ReadonlySignal<ReadonlySignalValue<Value>>;
-type ReadonlySignal<Value> = {
+export type ReadonlyFrozenSignal<Value> = ReadonlySignal<ReadonlySignalValue<Value>>;
+export type ReadonlySignal<Value> = {
   /**
    * Is the signal frozen?
    */
   get frozen(): boolean;
 } & Reactive<Value> & SimpleReactive<Value>;
-type ReadonlySignalValue<Value> = Value extends unknown[] ? Readonly<Value> : Value extends PlainObject ? Readonly<Value> : Value;
-type SetValueInProxyParameters<Value, Equal> = {
-  target: Value;
-  property: PropertyKey;
-  value: unknown;
-  state: ReactiveState<Value, Equal>;
-  isArray: boolean;
-  length?: Signal<number>;
-};
-type Signal<Value> = {
+export type ReadonlySignalValue<Value> = Value extends unknown[] ? Readonly<Value> : Value extends PlainObject ? Readonly<Value> : Value;
+export type Signal<Value> = {
   /**
    * Get a readonly version of the signal
    *
@@ -436,31 +401,24 @@ type SimpleReactive<Value> = {
   /**
    * Get the value _(without reactivity)_
    *
+   * @param copy If the value is an array or record, should it be copied? _(defaults to `false`)_
    * @returns Current value
    */
-  peek(): Value;
+  peek(copy?: boolean): Value;
   /**
    * Subscribe to changes
    *
    * @param callback Callback for changes
-   * @returns Unsubscribe callback
-   */
-  subscribe(callback: (value: Value) => void): Unsubscribe;
-  /**
-   * Unsubscribe from changes
-   *
-   * @param callback Callback to unsubscribe
+   * @param copy If the value is an array or record, should it be copied? _(defaults to `false`)_
+   * @returns Subscription
    */
-  unsubscribe(callback: (value: Value) => void): void;
+  subscribe(callback: (value: Value) => void, copy?: boolean): Subscription;
 };
-type Subscription = {
+export type StoredSubscription = {
   callback: GenericCallback;
+  copy: boolean;
+  frozen: boolean;
   state: ReactiveState<unknown, never>;
-  destroy(): void;
 };
-/**
- * Unsubscribe from changes
- */
-type Unsubscribe = () => void;
-//#endregion
-export { Active, Batch, Computed, ComputedEffect, Effect, EffectState, Reactive, ReactiveArray, ReactiveOptions, ReactiveState, ReactiveStore, ReadonlyFrozenSignal, ReadonlyInstances, ReadonlySignal, ReadonlySignalValue, SetValueInProxyParameters, Signal, Subscription, Unsubscribe };
+export type SubscriptionType = 'copy' | 'frozen' | 'original' | 'readonly';
+//#endregion