@oscarpalmer/mora 0.31.0 → 0.33.0

package/dist/models.d.mts

@@ -1,39 +1,53 @@
-import { PROPERTY_LENGTH } from "./constants.mjs";
+import { PROPERTY_LENGTH, SYMBOL_EFFECT, SYMBOL_STATE } 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 InternalComputed = {
+  [SYMBOL_EFFECT]: ComputedEffect;
+} & InternalSignal;
+export type InternalProxy = {
+  [SYMBOL_STATE]: ReactiveProxyState;
+};
+export type InternalReadonly = {
+  frozen: boolean;
+} & InternalSignal;
+export type InternalSignal = {
+  [SYMBOL_STATE]: SignalState;
+};
+export type Reactive<Value> = {
   /**
-   * JSON representation of the value
+   * _JSON_ representation of the value
    *
-   * @returns JSON value
+   * @returns _JSON_ value
    */
   toJSON(): Value;
   /**
    * String representation of the value
    *
+   * @param json When `true`, returns the _JSON_ string representation of the value _(defaults to `false`)_
    * @returns Value as string
    */
-  toString(): string;
+  toString(json?: boolean): string;
 };
-type ReactiveArray<Item> = {
+export type ReactiveArray<Item> = {
   /**
    * The length of the array
    */
@@ -186,37 +200,26 @@ type ReactiveArray<Item> = {
   /**
    * Subscribe to changes
    *
-   * @param callback Callback for changes
-   * @returns Unsubscribe callback
+   * @param subscriber Callback for changes
+   * @param copy Copy the array? _(defaults to `false`)_
+   * @returns Subscription
    */
-  subscribe(callback: (value: Item[]) => void): Unsubscribe;
+  subscribe(subscriber: Subscriber<Item[]>, 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 subscriber Callback for changes
+   * @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, subscriber: Subscriber<Item | undefined>, 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 +227,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 +237,21 @@ type ReactiveOptions<Value> = {
    */
   equal?: (first: Value, second: Value) => boolean;
 };
-type ReactiveState<Value, Equal> = {
-  computeds: Set<ComputedEffect>;
-  effects: Set<EffectState>;
-  equal: (first: Equal, second: Equal) => boolean;
-  promise?: Promise<Value>;
+export type ReactiveProxyState = {
+  isArray: boolean;
+  length?: Signal<number>;
+  mapped?: Map<string, [Computed<unknown>, ComputedEffect]>;
+} & SignalState;
+export type ReactiveState = {
+  computeds?: Set<ComputedEffect>;
+  effects?: Set<EffectState>;
+  equal?: (first: unknown, second: unknown) => boolean;
+  promise?: Promise<unknown>;
   promises?: Map<Key, Promise<never>>;
-  subscriptions: Map<GenericCallback, Subscription>;
-  value: Value;
+  subscriptions?: Subscriptions<GenericCallback>;
+  value: unknown;
 };
-type ReactiveStore<Store> = {
+export type ReactiveStore<Store> = {
   /**
    * Get a readonly version of the reactive store
    *
@@ -331,46 +339,29 @@ type ReactiveStore<Store> = {
   /**
    * Subscribe to changes
    *
-   * @param callback Callback for changes
-   * @returns Unsubscribe callback
+   * @param subscriber Callback for changes
+   * @param copy Copy the store? _(defaults to `false`)_
+   * @returns Subscription
    */
-  subscribe(callback: (value: Store) => void): Unsubscribe;
+  subscribe(subscriber: Subscriber<Store>, 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 subscriber Callback for changes
+   * @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, subscriber: Subscriber<Store[Key] | undefined>, 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 subscriber Callback for changes
+   * @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, subscriber: Subscriber<unknown>, copy?: boolean): Subscription;
   /**
    * Update the value _(based on the current value)_
    *
@@ -382,23 +373,15 @@ 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
    *
@@ -426,6 +409,9 @@ type Signal<Value> = {
    */
   update(callback: (value: Value) => Value): void;
 } & Reactive<Value> & SimpleReactive<Value>;
+export type SignalState = {
+  readonlies?: ReadonlyInstances<unknown>;
+} & ReactiveState;
 type SimpleReactive<Value> = {
   /**
    * Get the value
@@ -436,31 +422,26 @@ 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 subscriber Callback for changes
+   * @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(subscriber: Subscriber<Value>, copy?: boolean): Subscription;
 };
-type Subscription = {
+export type StoredSubscription = {
   callback: GenericCallback;
-  state: ReactiveState<unknown, never>;
-  destroy(): void;
+  copy: boolean;
+  frozen: boolean;
+  instance: InternalSignal;
+  state: SignalState;
 };
-/**
- * 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 Subscriber<Value> = (value: Value, subscription: Subscription) => void;
+export type SubscriptionType = 'copy' | 'frozen' | 'original' | 'readonly';
+//#endregion

package/dist/models.mjs

@@ -1 +1,2 @@
+import "./constants.mjs";
 export {};