@vaadin/hilla-react-signals 24.7.0-alpha9 → 24.7.0-beta3

package/ListSignal.js

@@ -1,147 +1,121 @@
-import { CollectionSignal } from "./CollectionSignal.js";
-import {
-  createInsertLastStateEvent,
-  createRemoveStateEvent,
-  isInsertLastStateEvent,
-  isListSnapshotStateEvent,
-  isRemoveStateEvent
-} from "./events.js";
-import {
-  $createOperation,
-  $processServerResponse,
-  $resolveOperation,
-  $setValueQuietly,
-  $update
-} from "./FullStackSignal.js";
-import { ValueSignal } from "./ValueSignal.js";
-class ListSignal extends CollectionSignal {
-  #head;
-  #tail;
-  #values = /* @__PURE__ */ new Map();
-  constructor(config) {
-    const initialValue = [];
-    super(initialValue, config);
-  }
-  #computeItems() {
-    let current = this.#head;
-    const result = [];
-    while (current !== void 0) {
-      const entry = this.#values.get(current);
-      result.push(entry.value);
-      current = entry.next;
+import { CollectionSignal } from './CollectionSignal.js';
+import { createInsertLastStateEvent, createRemoveStateEvent, isInsertLastStateEvent, isListSnapshotStateEvent, isRemoveStateEvent, } from './events.js';
+import { $createOperation, $processServerResponse, $resolveOperation, $setValueQuietly, $update, } from './FullStackSignal.js';
+import { ValueSignal } from './ValueSignal.js';
+export class ListSignal extends CollectionSignal {
+    #head;
+    #tail;
+    #values = new Map();
+    constructor(config) {
+        const initialValue = [];
+        super(initialValue, config);
     }
-    return result;
-  }
-  [$processServerResponse](event) {
-    if (!event.accepted) {
-      this[$resolveOperation](
-        event.id,
-        `Server rejected the operation with id '${event.id}'. See the server log for more details.`
-      );
-      return;
+    #computeItems() {
+        let current = this.#head;
+        const result = [];
+        while (current !== undefined) {
+            const entry = this.#values.get(current);
+            result.push(entry.value);
+            current = entry.next;
+        }
+        return result;
     }
-    if (isListSnapshotStateEvent(event)) {
-      this.#handleSnapshotEvent(event);
-    } else if (isInsertLastStateEvent(event)) {
-      this.#handleInsertLastUpdate(event);
-    } else if (isRemoveStateEvent(event)) {
-      this.#handleRemoveUpdate(event);
+    [$processServerResponse](event) {
+        if (!event.accepted) {
+            this[$resolveOperation](event.id, `Server rejected the operation with id '${event.id}'. See the server log for more details.`);
+            return;
+        }
+        if (isListSnapshotStateEvent(event)) {
+            this.#handleSnapshotEvent(event);
+        }
+        else if (isInsertLastStateEvent(event)) {
+            this.#handleInsertLastUpdate(event);
+        }
+        else if (isRemoveStateEvent(event)) {
+            this.#handleRemoveUpdate(event);
+        }
+        this[$resolveOperation](event.id);
     }
-    this[$resolveOperation](event.id);
-  }
-  #handleInsertLastUpdate(event) {
-    if (event.entryId === void 0) {
-      throw new Error("Unexpected state: Entry id should be defined when insert last event is accepted");
+    #handleInsertLastUpdate(event) {
+        if (event.entryId === undefined) {
+            throw new Error('Unexpected state: Entry id should be defined when insert last event is accepted');
+        }
+        const valueSignal = new ValueSignal(event.value, { ...this.server.config, parentClientSignalId: this.id }, event.entryId);
+        const newEntry = { id: valueSignal.id, value: valueSignal };
+        if (this.#head === undefined) {
+            this.#head = newEntry.id;
+            this.#tail = this.#head;
+        }
+        else {
+            const tailEntry = this.#values.get(this.#tail);
+            tailEntry.next = newEntry.id;
+            newEntry.prev = this.#tail;
+            this.#tail = newEntry.id;
+        }
+        this.#values.set(valueSignal.id, newEntry);
+        this[$setValueQuietly](this.#computeItems());
     }
-    const valueSignal = new ValueSignal(
-      event.value,
-      { ...this.server.config, parentClientSignalId: this.id },
-      event.entryId
-    );
-    const newEntry = { id: valueSignal.id, value: valueSignal };
-    if (this.#head === void 0) {
-      this.#head = newEntry.id;
-      this.#tail = this.#head;
-    } else {
-      const tailEntry = this.#values.get(this.#tail);
-      tailEntry.next = newEntry.id;
-      newEntry.prev = this.#tail;
-      this.#tail = newEntry.id;
+    #handleRemoveUpdate(event) {
+        const entryToRemove = this.#values.get(event.entryId);
+        if (entryToRemove === undefined) {
+            return;
+        }
+        this.#values.delete(event.id);
+        if (this.#head === entryToRemove.id) {
+            if (entryToRemove.next === undefined) {
+                this.#head = undefined;
+                this.#tail = undefined;
+            }
+            else {
+                const newHead = this.#values.get(entryToRemove.next);
+                this.#head = newHead.id;
+                newHead.prev = undefined;
+            }
+        }
+        else {
+            const prevEntry = this.#values.get(entryToRemove.prev);
+            const nextEntry = entryToRemove.next !== undefined ? this.#values.get(entryToRemove.next) : undefined;
+            if (nextEntry === undefined) {
+                this.#tail = prevEntry.id;
+                prevEntry.next = undefined;
+            }
+            else {
+                prevEntry.next = nextEntry.id;
+                nextEntry.prev = prevEntry.id;
+            }
+        }
+        this[$setValueQuietly](this.#computeItems());
     }
-    this.#values.set(valueSignal.id, newEntry);
-    this[$setValueQuietly](this.#computeItems());
-  }
-  #handleRemoveUpdate(event) {
-    const entryToRemove = this.#values.get(event.entryId);
-    if (entryToRemove === void 0) {
-      return;
+    #handleSnapshotEvent(event) {
+        event.entries.forEach((entry) => {
+            this.#values.set(entry.id, {
+                id: entry.id,
+                prev: entry.prev,
+                next: entry.next,
+                value: new ValueSignal(entry.value, { ...this.server.config, parentClientSignalId: this.id }, entry.id),
+            });
+            if (entry.prev === undefined) {
+                this.#head = entry.id;
+            }
+            if (entry.next === undefined) {
+                this.#tail = entry.id;
+            }
+        });
+        this[$setValueQuietly](this.#computeItems());
     }
-    this.#values.delete(event.id);
-    if (this.#head === entryToRemove.id) {
-      if (entryToRemove.next === void 0) {
-        this.#head = void 0;
-        this.#tail = void 0;
-      } else {
-        const newHead = this.#values.get(entryToRemove.next);
-        this.#head = newHead.id;
-        newHead.prev = void 0;
-      }
-    } else {
-      const prevEntry = this.#values.get(entryToRemove.prev);
-      const nextEntry = entryToRemove.next !== void 0 ? this.#values.get(entryToRemove.next) : void 0;
-      if (nextEntry === void 0) {
-        this.#tail = prevEntry.id;
-        prevEntry.next = void 0;
-      } else {
-        prevEntry.next = nextEntry.id;
-        nextEntry.prev = prevEntry.id;
-      }
+    insertLast(value) {
+        const event = createInsertLastStateEvent(value);
+        const promise = this[$update](event);
+        return this[$createOperation]({ id: event.id, promise });
     }
-    this[$setValueQuietly](this.#computeItems());
-  }
-  #handleSnapshotEvent(event) {
-    event.entries.forEach((entry) => {
-      this.#values.set(entry.id, {
-        id: entry.id,
-        prev: entry.prev,
-        next: entry.next,
-        value: new ValueSignal(entry.value, { ...this.server.config, parentClientSignalId: this.id }, entry.id)
-      });
-      if (entry.prev === void 0) {
-        this.#head = entry.id;
-      }
-      if (entry.next === void 0) {
-        this.#tail = entry.id;
-      }
-    });
-    this[$setValueQuietly](this.#computeItems());
-  }
-  /**
-   * Inserts a new value at the end of the list.
-   * @param value - The value to insert.
-   * @returns An operation object that allows to perform additional actions.
-   */
-  insertLast(value) {
-    const event = createInsertLastStateEvent(value);
-    const promise = this[$update](event);
-    return this[$createOperation]({ id: event.id, promise });
-  }
-  /**
-   * Removes the given item from the list.
-   * @param item - The item to remove.
-   * @returns An operation object that allows to perform additional actions.
-   */
-  remove(item) {
-    const entryToRemove = this.#values.get(item.id);
-    if (entryToRemove === void 0) {
-      return { result: Promise.resolve() };
+    remove(item) {
+        const entryToRemove = this.#values.get(item.id);
+        if (entryToRemove === undefined) {
+            return { result: Promise.resolve() };
+        }
+        const removeEvent = createRemoveStateEvent(entryToRemove.value.id);
+        const promise = this[$update](removeEvent);
+        return this[$createOperation]({ id: removeEvent.id, promise });
     }
-    const removeEvent = createRemoveStateEvent(entryToRemove.value.id);
-    const promise = this[$update](removeEvent);
-    return this[$createOperation]({ id: removeEvent.id, promise });
-  }
 }
-export {
-  ListSignal
-};
-//# sourceMappingURL=ListSignal.js.map
+//# sourceMappingURL=ListSignal.js.map

package/ListSignal.js.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["src/ListSignal.ts"],
-  "sourcesContent": ["import { CollectionSignal } from './CollectionSignal.js';\nimport {\n  createInsertLastStateEvent,\n  createRemoveStateEvent,\n  type InsertLastStateEvent,\n  isInsertLastStateEvent,\n  isListSnapshotStateEvent,\n  isRemoveStateEvent,\n  type ListSnapshotStateEvent,\n  type RemoveStateEvent,\n  type StateEvent,\n} from './events.js';\nimport {\n  $createOperation,\n  $processServerResponse,\n  $resolveOperation,\n  $setValueQuietly,\n  $update,\n  type Operation,\n  type ServerConnectionConfig,\n} from './FullStackSignal.js';\nimport { ValueSignal } from './ValueSignal.js';\n\ntype EntryId = string;\ntype Entry<T> = {\n  id: EntryId;\n  value: ValueSignal<T>;\n  next?: EntryId;\n  prev?: EntryId;\n};\n\n/**\n * A {@link FullStackSignal} that represents a shared list of values, where each\n * value is represented by a {@link ValueSignal}.\n * The list can be modified by calling the defined methods to insert or remove\n * items, but the `value` property of a `ListSignal` instance is read-only and\n * cannot be assigned directly.\n * The value of each item in the list can be manipulated similar to a regular\n * {@link ValueSignal}.\n *\n * @typeParam T - The type of the values in the list.\n */\nexport class ListSignal<T> extends CollectionSignal<ReadonlyArray<ValueSignal<T>>> {\n  #head?: EntryId;\n  #tail?: EntryId;\n\n  readonly #values = new Map<string, Entry<T>>();\n\n  constructor(config: ServerConnectionConfig) {\n    const initialValue: Array<ValueSignal<T>> = [];\n    super(initialValue, config);\n  }\n\n  #computeItems(): ReadonlyArray<ValueSignal<T>> {\n    let current = this.#head;\n    const result: Array<ValueSignal<T>> = [];\n    while (current !== undefined) {\n      const entry = this.#values.get(current)!;\n      result.push(entry.value);\n      current = entry.next;\n    }\n    return result;\n  }\n\n  protected override [$processServerResponse](event: StateEvent): void {\n    if (!event.accepted) {\n      this[$resolveOperation](\n        event.id,\n        `Server rejected the operation with id '${event.id}'. See the server log for more details.`,\n      );\n      return;\n    }\n    if (isListSnapshotStateEvent<T>(event)) {\n      this.#handleSnapshotEvent(event);\n    } else if (isInsertLastStateEvent<T>(event)) {\n      this.#handleInsertLastUpdate(event);\n    } else if (isRemoveStateEvent(event)) {\n      this.#handleRemoveUpdate(event);\n    }\n    this[$resolveOperation](event.id);\n  }\n\n  #handleInsertLastUpdate(event: InsertLastStateEvent<T>): void {\n    if (event.entryId === undefined) {\n      throw new Error('Unexpected state: Entry id should be defined when insert last event is accepted');\n    }\n    const valueSignal = new ValueSignal<T>(\n      event.value,\n      { ...this.server.config, parentClientSignalId: this.id },\n      event.entryId,\n    );\n    const newEntry: Entry<T> = { id: valueSignal.id, value: valueSignal };\n\n    if (this.#head === undefined) {\n      this.#head = newEntry.id;\n      this.#tail = this.#head;\n    } else {\n      const tailEntry = this.#values.get(this.#tail!)!;\n      tailEntry.next = newEntry.id;\n      newEntry.prev = this.#tail;\n      this.#tail = newEntry.id;\n    }\n    this.#values.set(valueSignal.id, newEntry);\n    this[$setValueQuietly](this.#computeItems());\n  }\n\n  #handleRemoveUpdate(event: RemoveStateEvent): void {\n    const entryToRemove = this.#values.get(event.entryId);\n    if (entryToRemove === undefined) {\n      return;\n    }\n    this.#values.delete(event.id);\n    if (this.#head === entryToRemove.id) {\n      if (entryToRemove.next === undefined) {\n        this.#head = undefined;\n        this.#tail = undefined;\n      } else {\n        const newHead = this.#values.get(entryToRemove.next)!;\n        this.#head = newHead.id;\n        newHead.prev = undefined;\n      }\n    } else {\n      const prevEntry = this.#values.get(entryToRemove.prev!)!;\n      const nextEntry = entryToRemove.next !== undefined ? this.#values.get(entryToRemove.next) : undefined;\n      if (nextEntry === undefined) {\n        this.#tail = prevEntry.id;\n        prevEntry.next = undefined;\n      } else {\n        prevEntry.next = nextEntry.id;\n        nextEntry.prev = prevEntry.id;\n      }\n    }\n    this[$setValueQuietly](this.#computeItems());\n  }\n\n  #handleSnapshotEvent(event: ListSnapshotStateEvent<T>): void {\n    event.entries.forEach((entry) => {\n      this.#values.set(entry.id, {\n        id: entry.id,\n        prev: entry.prev,\n        next: entry.next,\n        value: new ValueSignal(entry.value, { ...this.server.config, parentClientSignalId: this.id }, entry.id),\n      });\n      if (entry.prev === undefined) {\n        this.#head = entry.id;\n      }\n      if (entry.next === undefined) {\n        this.#tail = entry.id;\n      }\n    });\n    this[$setValueQuietly](this.#computeItems());\n  }\n\n  /**\n   * Inserts a new value at the end of the list.\n   * @param value - The value to insert.\n   * @returns An operation object that allows to perform additional actions.\n   */\n  insertLast(value: T): Operation {\n    const event = createInsertLastStateEvent(value);\n    const promise = this[$update](event);\n    return this[$createOperation]({ id: event.id, promise });\n  }\n\n  /**\n   * Removes the given item from the list.\n   * @param item - The item to remove.\n   * @returns An operation object that allows to perform additional actions.\n   */\n  remove(item: ValueSignal<T>): Operation {\n    const entryToRemove = this.#values.get(item.id);\n    if (entryToRemove === undefined) {\n      return { result: Promise.resolve() };\n    }\n    const removeEvent = createRemoveStateEvent(entryToRemove.value.id);\n    const promise = this[$update](removeEvent);\n    return this[$createOperation]({ id: removeEvent.id, promise });\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
-}
+{"version":3,"file":"ListSignal.js","sourceRoot":"","sources":["src/ListSignal.ts"],"names":[],"mappings":"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","sourcesContent":["import { CollectionSignal } from './CollectionSignal.js';\nimport {\n  createInsertLastStateEvent,\n  createRemoveStateEvent,\n  type InsertLastStateEvent,\n  isInsertLastStateEvent,\n  isListSnapshotStateEvent,\n  isRemoveStateEvent,\n  type ListSnapshotStateEvent,\n  type RemoveStateEvent,\n  type StateEvent,\n} from './events.js';\nimport {\n  $createOperation,\n  $processServerResponse,\n  $resolveOperation,\n  $setValueQuietly,\n  $update,\n  type Operation,\n  type ServerConnectionConfig,\n} from './FullStackSignal.js';\nimport { ValueSignal } from './ValueSignal.js';\n\ntype EntryId = string;\ntype Entry<T> = {\n  id: EntryId;\n  value: ValueSignal<T>;\n  next?: EntryId;\n  prev?: EntryId;\n};\n\n/**\n * A {@link FullStackSignal} that represents a shared list of values, where each\n * value is represented by a {@link ValueSignal}.\n * The list can be modified by calling the defined methods to insert or remove\n * items, but the `value` property of a `ListSignal` instance is read-only and\n * cannot be assigned directly.\n * The value of each item in the list can be manipulated similar to a regular\n * {@link ValueSignal}.\n *\n * @typeParam T - The type of the values in the list.\n */\nexport class ListSignal<T> extends CollectionSignal<ReadonlyArray<ValueSignal<T>>> {\n  #head?: EntryId;\n  #tail?: EntryId;\n\n  readonly #values = new Map<string, Entry<T>>();\n\n  constructor(config: ServerConnectionConfig) {\n    const initialValue: Array<ValueSignal<T>> = [];\n    super(initialValue, config);\n  }\n\n  #computeItems(): ReadonlyArray<ValueSignal<T>> {\n    let current = this.#head;\n    const result: Array<ValueSignal<T>> = [];\n    while (current !== undefined) {\n      const entry = this.#values.get(current)!;\n      result.push(entry.value);\n      current = entry.next;\n    }\n    return result;\n  }\n\n  protected override [$processServerResponse](event: StateEvent): void {\n    if (!event.accepted) {\n      this[$resolveOperation](\n        event.id,\n        `Server rejected the operation with id '${event.id}'. See the server log for more details.`,\n      );\n      return;\n    }\n    if (isListSnapshotStateEvent<T>(event)) {\n      this.#handleSnapshotEvent(event);\n    } else if (isInsertLastStateEvent<T>(event)) {\n      this.#handleInsertLastUpdate(event);\n    } else if (isRemoveStateEvent(event)) {\n      this.#handleRemoveUpdate(event);\n    }\n    this[$resolveOperation](event.id);\n  }\n\n  #handleInsertLastUpdate(event: InsertLastStateEvent<T>): void {\n    if (event.entryId === undefined) {\n      throw new Error('Unexpected state: Entry id should be defined when insert last event is accepted');\n    }\n    const valueSignal = new ValueSignal<T>(\n      event.value,\n      { ...this.server.config, parentClientSignalId: this.id },\n      event.entryId,\n    );\n    const newEntry: Entry<T> = { id: valueSignal.id, value: valueSignal };\n\n    if (this.#head === undefined) {\n      this.#head = newEntry.id;\n      this.#tail = this.#head;\n    } else {\n      const tailEntry = this.#values.get(this.#tail!)!;\n      tailEntry.next = newEntry.id;\n      newEntry.prev = this.#tail;\n      this.#tail = newEntry.id;\n    }\n    this.#values.set(valueSignal.id, newEntry);\n    this[$setValueQuietly](this.#computeItems());\n  }\n\n  #handleRemoveUpdate(event: RemoveStateEvent): void {\n    const entryToRemove = this.#values.get(event.entryId);\n    if (entryToRemove === undefined) {\n      return;\n    }\n    this.#values.delete(event.id);\n    if (this.#head === entryToRemove.id) {\n      if (entryToRemove.next === undefined) {\n        this.#head = undefined;\n        this.#tail = undefined;\n      } else {\n        const newHead = this.#values.get(entryToRemove.next)!;\n        this.#head = newHead.id;\n        newHead.prev = undefined;\n      }\n    } else {\n      const prevEntry = this.#values.get(entryToRemove.prev!)!;\n      const nextEntry = entryToRemove.next !== undefined ? this.#values.get(entryToRemove.next) : undefined;\n      if (nextEntry === undefined) {\n        this.#tail = prevEntry.id;\n        prevEntry.next = undefined;\n      } else {\n        prevEntry.next = nextEntry.id;\n        nextEntry.prev = prevEntry.id;\n      }\n    }\n    this[$setValueQuietly](this.#computeItems());\n  }\n\n  #handleSnapshotEvent(event: ListSnapshotStateEvent<T>): void {\n    event.entries.forEach((entry) => {\n      this.#values.set(entry.id, {\n        id: entry.id,\n        prev: entry.prev,\n        next: entry.next,\n        value: new ValueSignal(entry.value, { ...this.server.config, parentClientSignalId: this.id }, entry.id),\n      });\n      if (entry.prev === undefined) {\n        this.#head = entry.id;\n      }\n      if (entry.next === undefined) {\n        this.#tail = entry.id;\n      }\n    });\n    this[$setValueQuietly](this.#computeItems());\n  }\n\n  /**\n   * Inserts a new value at the end of the list.\n   * @param value - The value to insert.\n   * @returns An operation object that allows to perform additional actions.\n   */\n  insertLast(value: T): Operation {\n    const event = createInsertLastStateEvent(value);\n    const promise = this[$update](event);\n    return this[$createOperation]({ id: event.id, promise });\n  }\n\n  /**\n   * Removes the given item from the list.\n   * @param item - The item to remove.\n   * @returns An operation object that allows to perform additional actions.\n   */\n  remove(item: ValueSignal<T>): Operation {\n    const entryToRemove = this.#values.get(item.id);\n    if (entryToRemove === undefined) {\n      return { result: Promise.resolve() };\n    }\n    const removeEvent = createRemoveStateEvent(entryToRemove.value.id);\n    const promise = this[$update](removeEvent);\n    return this[$createOperation]({ id: removeEvent.id, promise });\n  }\n}\n"]}

package/NumberSignal.d.ts

@@ -1,45 +1,8 @@
 import { type StateEvent } from './events.js';
 import { $processServerResponse, type Operation } from './FullStackSignal.js';
 import { ValueSignal } from './ValueSignal.js';
-/**
- * A signal that holds a number value. The underlying
- * value of this signal is stored and updated as a
- * shared value on the server.
- *
- * After obtaining the NumberSignal instance from
- * a server-side service that returns one, the value
- * can be updated using the `value` property,
- * and it can be read with or without the
- * `value` property (similar to a normal signal):
- *
- * @example
- * ```tsx
- * const counter = CounterService.counter();
- *
- * return (
- *    <Button onClick={() => counter.incrementBy(1)}>
- *      Click count: { counter }
- *    </Button>
- *    <Button onClick={() => counter.value = 0}>Reset</Button>
- * );
- * ```
- */
 export declare class NumberSignal extends ValueSignal<number> {
     #private;
-    /**
-     * Increments the value by the specified delta. The delta can be negative to
-     * decrease the value.
-     *
-     * This method differs from using the `++` or `+=` operators directly on the
-     * signal value. It performs an atomic operation to prevent conflicts from
-     * concurrent changes, ensuring that other users' modifications are not
-     * accidentally overwritten.
-     *
-     * @param delta - The delta to increment the value by. The delta can be
-     * negative.
-     * @returns An operation object that allows to perform additional actions.
-     */
     incrementBy(delta: number): Operation;
     protected [$processServerResponse](event: StateEvent): void;
 }
-//# sourceMappingURL=NumberSignal.d.ts.map

package/NumberSignal.js

@@ -1,52 +1,32 @@
-import { createIncrementStateEvent, isIncrementStateEvent } from "./events.js";
-import {
-  $createOperation,
-  $processServerResponse,
-  $resolveOperation,
-  $setValueQuietly,
-  $update
-} from "./FullStackSignal.js";
-import { ValueSignal } from "./ValueSignal.js";
-class NumberSignal extends ValueSignal {
-  #sentIncrementEvents = /* @__PURE__ */ new Map();
-  /**
-   * Increments the value by the specified delta. The delta can be negative to
-   * decrease the value.
-   *
-   * This method differs from using the `++` or `+=` operators directly on the
-   * signal value. It performs an atomic operation to prevent conflicts from
-   * concurrent changes, ensuring that other users' modifications are not
-   * accidentally overwritten.
-   *
-   * @param delta - The delta to increment the value by. The delta can be
-   * negative.
-   * @returns An operation object that allows to perform additional actions.
-   */
-  incrementBy(delta) {
-    if (delta === 0) {
-      return { result: Promise.resolve() };
+import { createIncrementStateEvent, isIncrementStateEvent } from './events.js';
+import { $createOperation, $processServerResponse, $resolveOperation, $setValueQuietly, $update, } from './FullStackSignal.js';
+import { ValueSignal } from './ValueSignal.js';
+export class NumberSignal extends ValueSignal {
+    #sentIncrementEvents = new Map();
+    incrementBy(delta) {
+        if (delta === 0) {
+            return { result: Promise.resolve() };
+        }
+        this[$setValueQuietly](this.value + delta);
+        const event = createIncrementStateEvent(delta);
+        this.#sentIncrementEvents.set(event.id, event);
+        const promise = this[$update](event);
+        return this[$createOperation]({ id: event.id, promise });
     }
-    this[$setValueQuietly](this.value + delta);
-    const event = createIncrementStateEvent(delta);
-    this.#sentIncrementEvents.set(event.id, event);
-    const promise = this[$update](event);
-    return this[$createOperation]({ id: event.id, promise });
-  }
-  [$processServerResponse](event) {
-    if (event.accepted && isIncrementStateEvent(event)) {
-      const sentEvent = this.#sentIncrementEvents.get(event.id);
-      if (sentEvent) {
-        this.#sentIncrementEvents.delete(event.id);
-      } else {
-        this[$setValueQuietly](this.value + event.value);
-      }
-      this[$resolveOperation](event.id);
-    } else {
-      super[$processServerResponse](event);
+    [$processServerResponse](event) {
+        if (event.accepted && isIncrementStateEvent(event)) {
+            const sentEvent = this.#sentIncrementEvents.get(event.id);
+            if (sentEvent) {
+                this.#sentIncrementEvents.delete(event.id);
+            }
+            else {
+                this[$setValueQuietly](this.value + event.value);
+            }
+            this[$resolveOperation](event.id);
+        }
+        else {
+            super[$processServerResponse](event);
+        }
     }
-  }
 }
-export {
-  NumberSignal
-};
-//# sourceMappingURL=NumberSignal.js.map
+//# sourceMappingURL=NumberSignal.js.map

package/NumberSignal.js.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["src/NumberSignal.ts"],
-  "sourcesContent": ["import { createIncrementStateEvent, isIncrementStateEvent, type StateEvent } from './events.js';\nimport {\n  $createOperation,\n  $processServerResponse,\n  $resolveOperation,\n  $setValueQuietly,\n  $update,\n  type Operation,\n} from './FullStackSignal.js';\nimport { ValueSignal } from './ValueSignal.js';\n\n/**\n * A signal that holds a number value. The underlying\n * value of this signal is stored and updated as a\n * shared value on the server.\n *\n * After obtaining the NumberSignal instance from\n * a server-side service that returns one, the value\n * can be updated using the `value` property,\n * and it can be read with or without the\n * `value` property (similar to a normal signal):\n *\n * @example\n * ```tsx\n * const counter = CounterService.counter();\n *\n * return (\n *    <Button onClick={() => counter.incrementBy(1)}>\n *      Click count: { counter }\n *    </Button>\n *    <Button onClick={() => counter.value = 0}>Reset</Button>\n * );\n * ```\n */\nexport class NumberSignal extends ValueSignal<number> {\n  readonly #sentIncrementEvents = new Map<string, StateEvent>();\n  /**\n   * Increments the value by the specified delta. The delta can be negative to\n   * decrease the value.\n   *\n   * This method differs from using the `++` or `+=` operators directly on the\n   * signal value. It performs an atomic operation to prevent conflicts from\n   * concurrent changes, ensuring that other users' modifications are not\n   * accidentally overwritten.\n   *\n   * @param delta - The delta to increment the value by. The delta can be\n   * negative.\n   * @returns An operation object that allows to perform additional actions.\n   */\n  incrementBy(delta: number): Operation {\n    if (delta === 0) {\n      return { result: Promise.resolve() };\n    }\n    this[$setValueQuietly](this.value + delta);\n    const event = createIncrementStateEvent(delta);\n    this.#sentIncrementEvents.set(event.id, event);\n    const promise = this[$update](event);\n    return this[$createOperation]({ id: event.id, promise });\n  }\n\n  protected override [$processServerResponse](event: StateEvent): void {\n    if (event.accepted && isIncrementStateEvent(event)) {\n      const sentEvent = this.#sentIncrementEvents.get(event.id);\n      if (sentEvent) {\n        this.#sentIncrementEvents.delete(event.id);\n      } else {\n        this[$setValueQuietly](this.value + event.value);\n      }\n      this[$resolveOperation](event.id);\n    } else {\n      super[$processServerResponse](event);\n    }\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,2BAA2B,6BAA8C;AAClF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAAmB;AAyBrB,MAAM,qBAAqB,YAAoB;AAAA,EAC3C,uBAAuB,oBAAI,IAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc5D,YAAY,OAA0B;AACpC,QAAI,UAAU,GAAG;AACf,aAAO,EAAE,QAAQ,QAAQ,QAAQ,EAAE;AAAA,IACrC;AACA,SAAK,gBAAgB,EAAE,KAAK,QAAQ,KAAK;AACzC,UAAM,QAAQ,0BAA0B,KAAK;AAC7C,SAAK,qBAAqB,IAAI,MAAM,IAAI,KAAK;AAC7C,UAAM,UAAU,KAAK,OAAO,EAAE,KAAK;AACnC,WAAO,KAAK,gBAAgB,EAAE,EAAE,IAAI,MAAM,IAAI,QAAQ,CAAC;AAAA,EACzD;AAAA,EAEA,CAAoB,sBAAsB,EAAE,OAAyB;AACnE,QAAI,MAAM,YAAY,sBAAsB,KAAK,GAAG;AAClD,YAAM,YAAY,KAAK,qBAAqB,IAAI,MAAM,EAAE;AACxD,UAAI,WAAW;AACb,aAAK,qBAAqB,OAAO,MAAM,EAAE;AAAA,MAC3C,OAAO;AACL,aAAK,gBAAgB,EAAE,KAAK,QAAQ,MAAM,KAAK;AAAA,MACjD;AACA,WAAK,iBAAiB,EAAE,MAAM,EAAE;AAAA,IAClC,OAAO;AACL,YAAM,sBAAsB,EAAE,KAAK;AAAA,IACrC;AAAA,EACF;AACF;",
-  "names": []
-}
+{"version":3,"file":"NumberSignal.js","sourceRoot":"","sources":["src/NumberSignal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAmB,MAAM,aAAa,CAAC;AAChG,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,GAER,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAyB/C,MAAM,OAAO,YAAa,SAAQ,WAAmB;IAC1C,oBAAoB,GAAG,IAAI,GAAG,EAAsB,CAAC;IAc9D,WAAW,CAAC,KAAa;QACvB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEkB,CAAC,sBAAsB,CAAC,CAAC,KAAiB;QAC3D,IAAI,KAAK,CAAC,QAAQ,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1D,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF","sourcesContent":["import { createIncrementStateEvent, isIncrementStateEvent, type StateEvent } from './events.js';\nimport {\n  $createOperation,\n  $processServerResponse,\n  $resolveOperation,\n  $setValueQuietly,\n  $update,\n  type Operation,\n} from './FullStackSignal.js';\nimport { ValueSignal } from './ValueSignal.js';\n\n/**\n * A signal that holds a number value. The underlying\n * value of this signal is stored and updated as a\n * shared value on the server.\n *\n * After obtaining the NumberSignal instance from\n * a server-side service that returns one, the value\n * can be updated using the `value` property,\n * and it can be read with or without the\n * `value` property (similar to a normal signal):\n *\n * @example\n * ```tsx\n * const counter = CounterService.counter();\n *\n * return (\n *    <Button onClick={() => counter.incrementBy(1)}>\n *      Click count: { counter }\n *    </Button>\n *    <Button onClick={() => counter.value = 0}>Reset</Button>\n * );\n * ```\n */\nexport class NumberSignal extends ValueSignal<number> {\n  readonly #sentIncrementEvents = new Map<string, StateEvent>();\n  /**\n   * Increments the value by the specified delta. The delta can be negative to\n   * decrease the value.\n   *\n   * This method differs from using the `++` or `+=` operators directly on the\n   * signal value. It performs an atomic operation to prevent conflicts from\n   * concurrent changes, ensuring that other users' modifications are not\n   * accidentally overwritten.\n   *\n   * @param delta - The delta to increment the value by. The delta can be\n   * negative.\n   * @returns An operation object that allows to perform additional actions.\n   */\n  incrementBy(delta: number): Operation {\n    if (delta === 0) {\n      return { result: Promise.resolve() };\n    }\n    this[$setValueQuietly](this.value + delta);\n    const event = createIncrementStateEvent(delta);\n    this.#sentIncrementEvents.set(event.id, event);\n    const promise = this[$update](event);\n    return this[$createOperation]({ id: event.id, promise });\n  }\n\n  protected override [$processServerResponse](event: StateEvent): void {\n    if (event.accepted && isIncrementStateEvent(event)) {\n      const sentEvent = this.#sentIncrementEvents.get(event.id);\n      if (sentEvent) {\n        this.#sentIncrementEvents.delete(event.id);\n      } else {\n        this[$setValueQuietly](this.value + event.value);\n      }\n      this[$resolveOperation](event.id);\n    } else {\n      super[$processServerResponse](event);\n    }\n  }\n}\n"]}

package/ValueSignal.d.ts

@@ -1,52 +1,12 @@
 import { type StateEvent } from './events.js';
 import { $processServerResponse, FullStackSignal, type Operation } from './FullStackSignal.js';
-/**
- * An operation subscription that can be canceled.
- */
 export interface OperationSubscription extends Operation {
     cancel(): void;
 }
-/**
- * A full-stack signal that holds an arbitrary value.
- */
 export declare class ValueSignal<T> extends FullStackSignal<T> {
     #private;
-    /**
-     * Sets the value.
-     * Note that the value change event that is propagated to the server as the
-     * result of this operation is not taking the last seen value into account and
-     * will overwrite the shared value on the server unconditionally (AKA: "Last
-     * Write Wins"). If you need to perform a conditional update, use the
-     * `replace` method instead.
-     *
-     * @param value - The new value.
-     * @returns An operation object that allows to perform additional actions.
-     */
     set(value: T): Operation;
-    /**
-     * Replaces the value with a new one only if the current value is equal to the
-     * expected value.
-     *
-     * @param expected - The expected value.
-     * @param newValue - The new value.
-     * @returns An operation object that allows to perform additional actions.
-     */
     replace(expected: T, newValue: T): Operation;
-    /**
-     * Tries to update the value by applying the callback function to the current
-     * value. In case of a concurrent change, the callback is run again with an
-     * updated input value. This is repeated until the result can be applied
-     * without concurrent changes, or the operation is canceled.
-     *
-     * Note that there is no guarantee that cancel() will be effective always,
-     * since a succeeding operation might already be on its way to the server.
-     *
-     * @param callback - The function that is applied on the current value to
-     *                   produce the new value.
-     * @returns An operation object that allows to perform additional actions,
-     *                   including cancellation.
-     */
     update(callback: (value: T) => T): OperationSubscription;
     protected [$processServerResponse](event: StateEvent): void;
 }
-//# sourceMappingURL=ValueSignal.d.ts.map