@bodil/signal 0.3.5 → 0.4.0

package/dist/array.d.ts

@@ -1,33 +1,162 @@
+import type { Equals } from "@bodil/core/types";
 import { type Option } from "@bodil/opt";
-export interface SignalReadonlyArray<A> extends Iterable<A> {
+import * as Signal from "./signal";
+declare const instance: unique symbol;
+type InstanceProps<A> = {
+    array: Array<A>;
+    signal: Signal.State<null>;
+    equals?: (a: A, b: A) => boolean;
+};
+/**
+ * A read-only view of a {@link Signal.Array}.
+ *
+ * This acts just like the {@link Signal.Array} it was created from, mirroring
+ * the current contents of the source array, but without the ability to modify
+ * it.
+ */
+export declare class ReadonlySignalArray<A> implements Iterable<A>, Equals {
+    /** @ignore */
+    protected readonly [instance]: InstanceProps<A>;
+    /** @ignore */
+    protected constructor(instanceProps: InstanceProps<A>);
+    /**
+     * Test whether a value is a `Signal.ReadonlyArray`.
+     */
+    static is(value: unknown): value is Signal.ReadonlyArray<unknown>;
+    /**
+     * Test whether the array is empty.
+     */
     isEmpty(): boolean;
+    /**
+     * Get the size of the array.
+     */
     size(): number;
+    /**
+     * Find the index at which the given value first occurs in the array,
+     * optionally starting at `fromIndex`. If the value doesn't occur in the
+     * array, return `-1`.
+     */
     indexOf(value: A, fromIndex?: number): number;
+    /**
+     * Find the first index in the array for which the `predicate` function
+     * returns true for the value at that index, or `-1` if it never does.
+     */
     findIndex(predicate: (value: A, index: number, obj: Array<A>) => boolean, thisArg?: any): number;
+    /**
+     * Test whether a value is an array with identical contents to this array.
+     */
+    equals(other: unknown): other is Signal.ReadonlyArray<A>;
+    /**
+     * Copy the contents of this array into a normal {@link Array}.
+     */
     toArray(): Array<A>;
+    /**
+     * Get the value at the given index, or {@link None} if the index is out of
+     * bounds.
+     *
+     * @throws {@link TypeError} of `index` is not an integer
+     */
     get(index: number): Option<A>;
-}
-export declare class SignalArray<A> implements Iterable<A>, SignalReadonlyArray<A> {
-    #private;
-    static from<T>(iterable: Iterable<T>): SignalArray<T>;
-    constructor(iterable: Iterable<A>);
+    /**
+     * Iterate over the contents of the array.
+     */
     [Symbol.iterator](): IteratorObject<A>;
-    isEmpty(): boolean;
-    size(): number;
-    indexOf(value: A, fromIndex?: number): number;
-    findIndex(predicate: (value: A, index: number, obj: Array<A>) => boolean, thisArg?: any): number;
-    toArray(): Array<A>;
-    get(index: number): Option<A>;
-    readOnly(): SignalReadonlyArray<A>;
-    set(index: number, value: A): void;
+}
+/**
+ * An array which behaves like a signal.
+ *
+ * Any read operation on the array, like {@link Signal.Array.get},
+ * {@link Signal.Array.size}, or iteration, acts like a
+ * {@link Signal.State.get}, registering the array as a dependency in any
+ * computed signals or effects it's used in. Correspondingly, any write
+ * operation to the array will cause all of these dependencies to update as
+ * with a {@link Signal.State.set}.
+ *
+ * Note that the API of this array is different from the built-in
+ * {@link Array}. This is intentional. Additionally, many operations you'd
+ * expect to find on an array, like {@link Array.map} or predicates like
+ * {@link Array.every}, are missing from the array itself. It's recommended
+ * that you access these through {@link Iterator}s instead.
+ *
+ * Note also that array access doesn't come with any granularity: if you read
+ * only a single index from the array inside a computed signal, *any* change to
+ * the array causes the signal to recompute, regardless of whether the value at
+ * the index you read changed.
+ */
+export declare class SignalArray<A> extends ReadonlySignalArray<A> {
+    /**
+     * Construct a new array with the contents of the provided iterable.
+     */
+    static from<T>(iterable: Iterable<T>): Signal.Array<T>;
+    /**
+     * Test whether a value is a `Signal.Array`.
+     */
+    static is(value: unknown): value is Signal.Array<unknown>;
+    /**
+     * Construct a new array, optionally filling it with the contents of the
+     * provided iterable.
+     */
+    constructor(iterable?: Iterable<A>, options?: Signal.Options<A>);
+    /**
+     * Return a read-only view of the array.
+     */
+    readOnly(): Signal.ReadonlyArray<A>;
+    /**
+     * Write the given value to the given index of the array, overwriting
+     * anything that may have been there before.
+     *
+     * @throws {@link TypeError} if `index` is negative or not an integer
+     */
+    set(index: number, value: A): this;
+    /**
+     * Append the provided values to the end of the array.
+     *
+     * @returns the number of values that were inserted.
+     */
     push(...values: Array<A>): number;
+    /**
+     * Prepend the provided values to the start of the array.
+     *
+     * @returns the number of values that were inserted.
+     */
     unshift(...values: Array<A>): number;
+    /**
+     * Remove the item at the front of the array and return it.
+     */
     pop(): Option<A>;
+    /**
+     * Remove the item at the end of the array and return it.
+     */
     shift(): Option<A>;
-    splice(start: number, deleteCount: number, ...values: Array<A>): Array<A>;
+    /** @see {@link Array.splice} */
+    splice(start: number, deleteCount?: number, ...values: Array<A>): Array<A>;
+    /**
+     * Insert the given values starting at the given index, shifting the
+     * remainder of the array to higher indices accordingly.
+     *
+     * @throws {@link TypeError} if `index` is not an integer
+     */
     insert(index: number, ...values: Array<A>): this;
+    /**
+     * Remove the value at the given index and return it. If there's no value at
+     * the given index, return {@link None}.
+     *
+     * @throws {@link TypeError} if `index` is not an integer
+     */
     removeIndex(index: number): Option<A>;
+    /**
+     * Remove the first occurrence of the given value from the array, if it
+     * exists in the array.
+     */
     remove(value: A): Option<A>;
+    /**
+     * Remove the first value from the array that matches the given predicate
+     * function, if any.
+     */
     removeFn(predicate: (value: A, index: number, obj: Array<A>) => boolean): Option<A>;
+    /**
+     * Discard all values in the array, leaving an empty array.
+     */
     clear(): this;
 }
+export {};

package/dist/array.js

@@ -1,126 +1,286 @@
 import { None, Some } from "@bodil/opt";
-import { Signal } from ".";
-export class SignalArray {
-    #array;
-    #signal = Signal(null, { equals: () => false });
-    static from(iterable) {
-        return new SignalArray(iterable);
+import * as Signal from "./signal";
+const instance = Symbol("Signal.Array");
+/**
+ * A read-only view of a {@link Signal.Array}.
+ *
+ * This acts just like the {@link Signal.Array} it was created from, mirroring
+ * the current contents of the source array, but without the ability to modify
+ * it.
+ */
+export class ReadonlySignalArray {
+    /** @ignore */
+    constructor(instanceProps) {
+        this[instance] = instanceProps;
     }
-    constructor(iterable) {
-        this.#array = [...iterable];
-    }
-    [Symbol.iterator]() {
-        this.#signal.get();
-        return Iterator.from(this.#array);
+    /**
+     * Test whether a value is a `Signal.ReadonlyArray`.
+     */
+    static is(value) {
+        return value instanceof ReadonlySignalArray;
     }
+    /**
+     * Test whether the array is empty.
+     */
     isEmpty() {
-        this.#signal.get();
-        return this.#array.length === 0;
+        const self = this[instance];
+        self.signal.get();
+        return self.array.length === 0;
     }
+    /**
+     * Get the size of the array.
+     */
     size() {
-        this.#signal.get();
-        return this.#array.length;
+        const self = this[instance];
+        self.signal.get();
+        return self.array.length;
     }
+    /**
+     * Find the index at which the given value first occurs in the array,
+     * optionally starting at `fromIndex`. If the value doesn't occur in the
+     * array, return `-1`.
+     */
     indexOf(value, fromIndex) {
-        this.#signal.get();
-        return this.#array.indexOf(value, fromIndex);
+        const self = this[instance];
+        self.signal.get();
+        return self.array.indexOf(value, fromIndex);
     }
+    /**
+     * Find the first index in the array for which the `predicate` function
+     * returns true for the value at that index, or `-1` if it never does.
+     */
     findIndex(predicate, thisArg) {
-        this.#signal.get();
-        return this.#array.findIndex(predicate, thisArg);
+        const self = this[instance];
+        self.signal.get();
+        return self.array.findIndex(predicate, thisArg);
     }
+    /**
+     * Test whether a value is an array with identical contents to this array.
+     */
+    equals(other) {
+        if (!ReadonlySignalArray.is(other)) {
+            return false;
+        }
+        const self = this[instance];
+        self.signal.get();
+        return (this.size() === other.size() &&
+            self.array.every((a, index) => Object.is(a, other.get(index).value)));
+    }
+    /**
+     * Copy the contents of this array into a normal {@link Array}.
+     */
     toArray() {
-        this.#signal.get();
-        return this.#array.slice();
+        const self = this[instance];
+        self.signal.get();
+        return self.array.slice();
     }
+    /**
+     * Get the value at the given index, or {@link None} if the index is out of
+     * bounds.
+     *
+     * @throws {@link TypeError} of `index` is not an integer
+     */
     get(index) {
         if (!Number.isInteger(index)) {
             throw new TypeError(`Signal.Array.get: index ${index} is not an integer`);
         }
-        this.#signal.get();
-        return index >= 0 && this.#array.length > index ? Some(this.#array[index]) : None;
+        const self = this[instance];
+        self.signal.get();
+        return Object.hasOwn(this, index) ? Some(self.array[index]) : None;
+    }
+    /**
+     * Iterate over the contents of the array.
+     */
+    [Symbol.iterator]() {
+        const self = this[instance];
+        self.signal.get();
+        return Iterator.from(self.array);
+    }
+}
+/**
+ * An array which behaves like a signal.
+ *
+ * Any read operation on the array, like {@link Signal.Array.get},
+ * {@link Signal.Array.size}, or iteration, acts like a
+ * {@link Signal.State.get}, registering the array as a dependency in any
+ * computed signals or effects it's used in. Correspondingly, any write
+ * operation to the array will cause all of these dependencies to update as
+ * with a {@link Signal.State.set}.
+ *
+ * Note that the API of this array is different from the built-in
+ * {@link Array}. This is intentional. Additionally, many operations you'd
+ * expect to find on an array, like {@link Array.map} or predicates like
+ * {@link Array.every}, are missing from the array itself. It's recommended
+ * that you access these through {@link Iterator}s instead.
+ *
+ * Note also that array access doesn't come with any granularity: if you read
+ * only a single index from the array inside a computed signal, *any* change to
+ * the array causes the signal to recompute, regardless of whether the value at
+ * the index you read changed.
+ */
+export class SignalArray extends ReadonlySignalArray {
+    /**
+     * Construct a new array with the contents of the provided iterable.
+     */
+    static from(iterable) {
+        return new SignalArray(iterable);
+    }
+    /**
+     * Test whether a value is a `Signal.Array`.
+     */
+    static is(value) {
+        return value instanceof SignalArray;
+    }
+    /**
+     * Construct a new array, optionally filling it with the contents of the
+     * provided iterable.
+     */
+    constructor(iterable = [], options) {
+        super({
+            array: Array.from(iterable),
+            signal: new Signal.State(null, { equals: () => false }),
+            equals: options?.equals,
+        });
     }
+    /**
+     * Return a read-only view of the array.
+     */
     readOnly() {
-        return this;
+        return new ReadonlySignalArray(this[instance]);
     }
+    /**
+     * Write the given value to the given index of the array, overwriting
+     * anything that may have been there before.
+     *
+     * @throws {@link TypeError} if `index` is negative or not an integer
+     */
     set(index, value) {
         if (!Number.isInteger(index)) {
             throw new TypeError(`Signal.Array.set: index ${index} is not an integer`);
         }
-        if (index > this.#array.length || index < 0) {
+        if (index < 0) {
             throw new RangeError(`Signal.Array.set: index ${index} out of bounds`);
         }
-        this.#array[index] = value;
-        this.#signal.set(null);
+        const self = this[instance];
+        if (!(self.equals ?? Object.is)(self.array[index], value)) {
+            self.array[index] = value;
+            self.signal.set(null);
+        }
+        return this;
     }
+    /**
+     * Append the provided values to the end of the array.
+     *
+     * @returns the number of values that were inserted.
+     */
     push(...values) {
-        const result = this.#array.push(...values);
-        this.#signal.set(null);
+        const self = this[instance];
+        const result = self.array.push(...values);
+        self.signal.set(null);
         return result;
     }
+    /**
+     * Prepend the provided values to the start of the array.
+     *
+     * @returns the number of values that were inserted.
+     */
     unshift(...values) {
-        const result = this.#array.unshift(...values);
-        this.#signal.set(null);
+        const self = this[instance];
+        const result = self.array.unshift(...values);
+        self.signal.set(null);
         return result;
     }
+    /**
+     * Remove the item at the front of the array and return it.
+     */
     pop() {
         if (this.isEmpty()) {
             return None;
         }
-        const result = this.#array.pop();
-        this.#signal.set(null);
+        const self = this[instance];
+        const result = self.array.pop();
+        self.signal.set(null);
         return Some(result);
     }
+    /**
+     * Remove the item at the end of the array and return it.
+     */
     shift() {
         if (this.isEmpty()) {
             return None;
         }
-        const result = this.#array.shift();
-        this.#signal.set(null);
+        const self = this[instance];
+        const result = self.array.shift();
+        self.signal.set(null);
         return Some(result);
     }
+    /** @see {@link Array.splice} */
     splice(start, deleteCount, ...values) {
         if (!Number.isInteger(start)) {
-            throw new TypeError(`Signal.Array.splice: index ${start} is not an integer`);
+            throw new TypeError(`Signal.Array.splice: start ${start} is not an integer`);
         }
-        if (start > this.#array.length || start < 0) {
-            throw new RangeError(`Signal.Array.splice: index ${start} out of bounds`);
+        if (deleteCount !== undefined && !Number.isInteger(deleteCount)) {
+            throw new TypeError(`Signal.Array.splice: deleteCount ${deleteCount} is not an integer`);
         }
-        const result = this.#array.splice(start, deleteCount, ...values);
-        this.#signal.set(null);
+        const self = this[instance];
+        const result = self.array.splice(start, deleteCount, ...values);
+        self.signal.set(null);
         return result;
     }
+    /**
+     * Insert the given values starting at the given index, shifting the
+     * remainder of the array to higher indices accordingly.
+     *
+     * @throws {@link TypeError} if `index` is not an integer
+     */
     insert(index, ...values) {
         if (!Number.isInteger(index)) {
             throw new TypeError(`Signal.Array.insert: index ${index} is not an integer`);
         }
-        if (index > this.#array.length || index < 0) {
-            throw new RangeError(`Signal.Array.insert: index ${index} out of bounds`);
-        }
-        this.#array.splice(index, 0, ...values);
-        this.#signal.set(null);
+        this.splice(index, 0, ...values);
         return this;
     }
+    /**
+     * Remove the value at the given index and return it. If there's no value at
+     * the given index, return {@link None}.
+     *
+     * @throws {@link TypeError} if `index` is not an integer
+     */
     removeIndex(index) {
         if (!Number.isInteger(index)) {
             throw new TypeError(`Signal.Array.removeIndex: index ${index} is not an integer`);
         }
-        if (index < 0 || index >= this.#array.length) {
+        if (!Object.hasOwn(this, index)) {
             return None;
         }
-        const removed = this.#array.splice(index, 1).pop();
-        this.#signal.set(null);
+        const self = this[instance];
+        const removed = self.array.splice(index, 1).pop();
+        self.signal.set(null);
         return Some(removed);
     }
+    /**
+     * Remove the first occurrence of the given value from the array, if it
+     * exists in the array.
+     */
     remove(value) {
-        return this.removeIndex(this.indexOf(value));
+        const index = this.indexOf(value);
+        return index < 0 ? None : this.removeIndex(index);
     }
+    /**
+     * Remove the first value from the array that matches the given predicate
+     * function, if any.
+     */
     removeFn(predicate) {
-        return this.removeIndex(this.findIndex(predicate));
+        const index = this.findIndex(predicate);
+        return index < 0 ? None : this.removeIndex(index);
     }
+    /**
+     * Discard all values in the array, leaving an empty array.
+     */
     clear() {
-        this.#array = [];
-        this.#signal.set(null);
+        const self = this[instance];
+        self.array = [];
+        self.signal.set(null);
         return this;
     }
 }

package/dist/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,123 +3,4 @@
  * Proposal](https://github.com/tc39/proposal-signals).
  * @module
  */
-import { type Disposifiable } from "@bodil/core/disposable";
-import { Signal } from "signal-polyfill";
-import { SignalArray } from "./array";
-interface ISignal<A> {
-    /**
-     * The current value of the signal.
-     *
-     * When this is read inside a computation function or an effect function,
-     * this signal is automatically added to the effect or computed signal as a
-     * dependency.
-     */
-    readonly value: A;
-    /**
-     * Construct a {@link Signal.Computed} signal using a mapping function over
-     * the current value of this signal.
-     */
-    map<B>(fn: (value: A) => B): SignalGlobal.Computed<B>;
-    /**
-     * Subscribe to changes to the value of this signal.
-     */
-    on(callback: (value: A) => void): Disposable;
-}
-/**
- * A writable state signal.
- */
-declare class StateSignal<A> extends Signal.State<A> implements ISignal<A> {
-    get value(): A;
-    set value(value: A);
-    /**
-     * Update the current value of this signal using a function.
-     */
-    update(fn: (value: A) => A): void;
-    /**
-     * Get a read only version of this signal.
-     */
-    readOnly(): SignalGlobal.Computed<A>;
-    map<B>(fn: (value: A) => B): SignalGlobal.Computed<B>;
-    on(callback: (value: A) => void): Disposable;
-    static is(v: unknown): v is SignalGlobal.State<unknown>;
-}
-/**
- * A read only signal computed from the values of other signals.
- */
-declare class ComputedSignal<A> extends Signal.Computed<A> implements ISignal<A> {
-    get value(): A;
-    map<B>(fn: (value: A) => B): SignalGlobal.Computed<B>;
-    on(callback: (value: A) => void): Disposable;
-    static is(v: unknown): v is SignalGlobal.Computed<unknown>;
-}
-type SignalGlobal<A> = SignalGlobal.State<A> | SignalGlobal.Computed<A>;
-declare const SignalGlobal: (<A>(value: A, options?: Signal.Options<A>) => SignalGlobal.State<A>) & {
-    /**
-     * Test whether the given value is a signal.
-     */
-    is(v: unknown): v is SignalGlobal<unknown>;
-    /**
-     * Construct a new {@link Signal.Computed} signal using the provided
-     * computation function.
-     *
-     * @example
-     * const sig1 = Signal(2);
-     * const sig2 = Signal(3);
-     * const sum = Signal.computed(() => sig1.get() + sig2.get());
-     * assert(sum.get() === 5);
-     */
-    computed<A>(fn: (this: SignalGlobal.Computed<A>) => A, options?: Signal.Options<A>): SignalGlobal.Computed<A>;
-    /**
-     * Suscribe to a signal.
-     *
-     * The provided callback will be called every time the value of the
-     * signal changes.
-     */
-    subscribe<A>(signal: SignalGlobal<A>, callback: (value: A) => void): Disposable;
-    /**
-     * Create an effect responding to signal changes.
-     *
-     * The provided function will be called immediately, and again every
-     * time a signal that was read by the function changes.
-     *
-     * @example
-     * const sig = Signal("Hello Joe!");
-     * effect(() => console.log("Signal value is:", sig.get()));
-     * // prints "Signal value is: Hello Joe!"
-     * sig.set("Hello Mike!");
-     * // prints "Signal value is: Hello Mike!"
-     */
-    effect(fn: () => Disposifiable | void): Disposable;
-    /**
-     * Construct a new {@link Signal.Computed} signal using an async
-     * computation function.
-     *
-     * This returns a promise which will resolve to a
-     * {@link Signal.Computed} signal once the promise returned by the
-     * computation function resolves, and will update itself whenever
-     * subsequent calls to the computation function resolve.
-     *
-     * The function is provided with an {@link AbortSignal} which any async
-     * jobs started from it should abide by. If a signal dependency changes
-     * while the job is running, the {@link AbortSignal} will be triggered
-     * and the job restarted.
-     */
-    asyncComputed<A>(fn: (abort: AbortSignal) => Promise<A>, options?: Signal.Options<A>): Promise<SignalGlobal.Computed<A>>;
-    array<A>(values: Iterable<A>): SignalArray<A>;
-    State: typeof StateSignal;
-    Computed: typeof ComputedSignal;
-    Array: typeof SignalArray;
-    subtle: typeof Signal.subtle;
-};
-declare namespace SignalGlobal {
-    /** @interface */
-    type State<A> = StateSignal<A>;
-    /** @interface */
-    type Computed<A> = ComputedSignal<A>;
-    type Array<A> = SignalArray<A>;
-    type Options<A> = Signal.Options<A>;
-    namespace subtle {
-        type Watcher = Signal.subtle.Watcher;
-    }
-}
-export { SignalGlobal as Signal };
+export * as Signal from "./signal";