@vaadin/hilla-react-signals 24.5.0-alpha14 → 24.5.0-alpha15

package/FullStackSignal.d.ts

@@ -30,6 +30,11 @@ export type ServerConnectionConfig = Readonly<{
      * The name of the signal provider service method.
      */
     method: string;
+    /**
+     * Optional object with method call arguments to be sent to the endpoint
+     * method that provides the signal when subscribing to it.
+     */
+    params?: Record<string, unknown>;
 }>;
 /**
  * A server connection manager.
@@ -72,6 +77,12 @@ export declare abstract class FullStackSignal<T> extends DependencyTrackingSigna
      */
     readonly error: import("@preact/signals-core").ReadonlySignal<Error | undefined>;
     constructor(value: T | undefined, config: ServerConnectionConfig);
+    /**
+     * Sets the local value of the signal without sending any events to the server
+     * @param value - The new value.
+     * @internal
+     */
+    protected setValueLocal(value: T): void;
     /**
      * A method to update the server with the new value.
      *

package/FullStackSignal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FullStackSignal.d.ts","sourceRoot":"","sources":["src/FullStackSignal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAoB,MAAM,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAInE;;;;;GAKG;AACH,8BAAsB,wBAAwB,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;;IAQjE,SAAS,aAAa,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,IAAI,EAAE,iBAAiB,EAAE,MAAM,IAAI;cAMpF,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;cAQtB,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAO1C;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,cAAM,gBAAgB,CAAC,CAAC;;gBAKV,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB;IAKtD,IAAI,YAAY,4CAEf;IAED,OAAO;IAYD,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,UAAU;CAIX;AAED,eAAO,MAAM,OAAO,eAAmB,CAAC;AACxC,eAAO,MAAM,sBAAsB,eAAkC,CAAC;AAEtE;;;;;;;GAOG;AACH,8BAAsB,eAAe,CAAC,CAAC,CAAE,SAAQ,wBAAwB,CAAC,CAAC,CAAC;;IAC1E;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAY;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,OAAO,yDAAuC;IAEvD;;OAEG;IACH,QAAQ,CAAC,KAAK,mEAAqC;gBASvC,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,sBAAsB;IAmBhE;;;;OAIG;IACH,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAW/C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC,sBAAsB,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;CAgBxE"}
+{"version":3,"file":"FullStackSignal.d.ts","sourceRoot":"","sources":["src/FullStackSignal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAoB,MAAM,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAInE;;;;;GAKG;AACH,8BAAsB,wBAAwB,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;;IAQjE,SAAS,aAAa,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,IAAI,EAAE,iBAAiB,EAAE,MAAM,IAAI;cAMpF,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;cAQtB,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAO1C;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH;;GAEG;AACH,cAAM,gBAAgB,CAAC,CAAC;;gBAKV,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB;IAKtD,IAAI,YAAY,4CAEf;IAED,OAAO;IAaD,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,UAAU;CAIX;AAED,eAAO,MAAM,OAAO,eAAmB,CAAC;AACxC,eAAO,MAAM,sBAAsB,eAAkC,CAAC;AAEtE;;;;;;;GAOG;AACH,8BAAsB,eAAe,CAAC,CAAC,CAAE,SAAQ,wBAAwB,CAAC,CAAC,CAAC;;IAC1E;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAY;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,OAAO,yDAAuC;IAEvD;;OAEG;IACH,QAAQ,CAAC,KAAK,mEAAqC;gBASvC,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,sBAAsB;IAmBhE;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAMvC;;;;OAIG;IACH,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAW/C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC,sBAAsB,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;CAgBxE"}

package/FullStackSignal.js

@@ -40,11 +40,12 @@ class ServerConnection {
     return this.#subscription;
   }
   connect() {
-    const { client, endpoint, method } = this.#config;
+    const { client, endpoint, method, params } = this.#config;
     this.#subscription ??= client.subscribe(ENDPOINT, "subscribe", {
       providerEndpoint: endpoint,
       providerMethod: method,
-      clientSignalId: this.#id
+      clientSignalId: this.#id,
+      params
     });
     return this.#subscription;
   }
@@ -100,6 +101,16 @@ class FullStackSignal extends DependencyTrackingSignal {
     });
     this.#paused = false;
   }
+  /**
+   * Sets the local value of the signal without sending any events to the server
+   * @param value - The new value.
+   * @internal
+   */
+  setValueLocal(value) {
+    this.#paused = true;
+    this.value = value;
+    this.#paused = false;
+  }
   /**
    * A method to update the server with the new value.
    *

package/FullStackSignal.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["src/FullStackSignal.ts"],
-  "sourcesContent": ["import type { ConnectClient, Subscription } from '@vaadin/hilla-frontend';\nimport { nanoid } from 'nanoid';\nimport { computed, signal, Signal } from './core.js';\nimport { createSetStateEvent, type StateEvent } from './events.js';\n\nconst ENDPOINT = 'SignalsHandler';\n\n/**\n * An abstraction of a signal that tracks the number of subscribers, and calls\n * the provided `onSubscribe` and `onUnsubscribe` callbacks for the first\n * subscription and the last unsubscription, respectively.\n * @internal\n */\nexport abstract class DependencyTrackingSignal<T> extends Signal<T> {\n  readonly #onFirstSubscribe: () => void;\n  readonly #onLastUnsubscribe: () => void;\n\n  // -1 means to ignore the first subscription that is created internally in the\n  // FullStackSignal constructor.\n  #subscribeCount = -1;\n\n  protected constructor(value: T | undefined, onFirstSubscribe: () => void, onLastUnsubscribe: () => void) {\n    super(value);\n    this.#onFirstSubscribe = onFirstSubscribe;\n    this.#onLastUnsubscribe = onLastUnsubscribe;\n  }\n\n  protected override S(node: unknown): void {\n    super.S(node);\n    if (this.#subscribeCount === 0) {\n      this.#onFirstSubscribe();\n    }\n    this.#subscribeCount += 1;\n  }\n\n  protected override U(node: unknown): void {\n    super.U(node);\n    this.#subscribeCount -= 1;\n    if (this.#subscribeCount === 0) {\n      this.#onLastUnsubscribe();\n    }\n  }\n}\n\n/**\n * An object that describes a data object to connect to the signal provider\n * service.\n */\nexport type ServerConnectionConfig = Readonly<{\n  /**\n   * The client instance to be used for communication.\n   */\n  client: ConnectClient;\n\n  /**\n   * The name of the signal provider service endpoint.\n   */\n  endpoint: string;\n\n  /**\n   * The name of the signal provider service method.\n   */\n  method: string;\n}>;\n\n/**\n * A server connection manager.\n */\nclass ServerConnection<T> {\n  readonly #id: string;\n  readonly #config: ServerConnectionConfig;\n  #subscription?: Subscription<StateEvent<T>>;\n\n  constructor(id: string, config: ServerConnectionConfig) {\n    this.#config = config;\n    this.#id = id;\n  }\n\n  get subscription() {\n    return this.#subscription;\n  }\n\n  connect() {\n    const { client, endpoint, method } = this.#config;\n\n    this.#subscription ??= client.subscribe(ENDPOINT, 'subscribe', {\n      providerEndpoint: endpoint,\n      providerMethod: method,\n      clientSignalId: this.#id,\n    });\n\n    return this.#subscription;\n  }\n\n  async update(event: StateEvent<T>): Promise<void> {\n    await this.#config.client.call(ENDPOINT, 'update', {\n      clientSignalId: this.#id,\n      event,\n    });\n  }\n\n  disconnect() {\n    this.#subscription?.cancel();\n    this.#subscription = undefined;\n  }\n}\n\nexport const $update = Symbol('update');\nexport const $processServerResponse = Symbol('processServerResponse');\n\n/**\n * A signal that holds a shared value. Each change to the value is propagated to\n * the server-side signal provider. At the same time, each change received from\n * the server-side signal provider is propagated to the local signal and it's\n * subscribers.\n *\n * @internal\n */\nexport abstract class FullStackSignal<T> extends DependencyTrackingSignal<T> {\n  /**\n   * The unique identifier of the signal necessary to communicate with the\n   * server.\n   */\n  readonly id = nanoid();\n\n  /**\n   * The server connection manager.\n   */\n  readonly server: ServerConnection<T>;\n\n  /**\n   * Defines whether the signal is currently awaits a server-side response.\n   */\n  readonly pending = computed(() => this.#pending.value);\n\n  /**\n   * Defines whether the signal has an error.\n   */\n  readonly error = computed(() => this.#error.value);\n\n  readonly #pending = signal(false);\n  readonly #error = signal<Error | undefined>(undefined);\n\n  // Paused at the very start to prevent the signal from sending the initial\n  // value to the server.\n  #paused = true;\n\n  constructor(value: T | undefined, config: ServerConnectionConfig) {\n    super(\n      value,\n      () => this.#connect(),\n      () => this.#disconnect(),\n    );\n    this.server = new ServerConnection(this.id, config);\n\n    this.subscribe((v) => {\n      if (!this.#paused) {\n        this.#pending.value = true;\n        this.#error.value = undefined;\n        this[$update](createSetStateEvent(v));\n      }\n    });\n\n    this.#paused = false;\n  }\n\n  /**\n   * A method to update the server with the new value.\n   *\n   * @param event - The event to update the server with.\n   */\n  protected [$update](event: StateEvent<T>): void {\n    this.server\n      .update(event)\n      .catch((error: unknown) => {\n        this.#error.value = error instanceof Error ? error : new Error(String(error));\n      })\n      .finally(() => {\n        this.#pending.value = false;\n      });\n  }\n\n  /**\n   * A method with to process the server response. The implementation is\n   * specific for each signal type.\n   *\n   * @param event - The server response event.\n   */\n  protected abstract [$processServerResponse](event: StateEvent<T>): void;\n\n  #connect() {\n    this.server.connect().onNext((event: StateEvent<T>) => {\n      this.#paused = true;\n      this[$processServerResponse](event);\n      this.#paused = false;\n    });\n  }\n\n  #disconnect() {\n    if (this.server.subscription === undefined) {\n      return;\n    }\n    this.server.disconnect();\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { ConnectClient, Subscription } from '@vaadin/hilla-frontend';\nimport { nanoid } from 'nanoid';\nimport { computed, signal, Signal } from './core.js';\nimport { createSetStateEvent, type StateEvent } from './events.js';\n\nconst ENDPOINT = 'SignalsHandler';\n\n/**\n * An abstraction of a signal that tracks the number of subscribers, and calls\n * the provided `onSubscribe` and `onUnsubscribe` callbacks for the first\n * subscription and the last unsubscription, respectively.\n * @internal\n */\nexport abstract class DependencyTrackingSignal<T> extends Signal<T> {\n  readonly #onFirstSubscribe: () => void;\n  readonly #onLastUnsubscribe: () => void;\n\n  // -1 means to ignore the first subscription that is created internally in the\n  // FullStackSignal constructor.\n  #subscribeCount = -1;\n\n  protected constructor(value: T | undefined, onFirstSubscribe: () => void, onLastUnsubscribe: () => void) {\n    super(value);\n    this.#onFirstSubscribe = onFirstSubscribe;\n    this.#onLastUnsubscribe = onLastUnsubscribe;\n  }\n\n  protected override S(node: unknown): void {\n    super.S(node);\n    if (this.#subscribeCount === 0) {\n      this.#onFirstSubscribe();\n    }\n    this.#subscribeCount += 1;\n  }\n\n  protected override U(node: unknown): void {\n    super.U(node);\n    this.#subscribeCount -= 1;\n    if (this.#subscribeCount === 0) {\n      this.#onLastUnsubscribe();\n    }\n  }\n}\n\n/**\n * An object that describes a data object to connect to the signal provider\n * service.\n */\nexport type ServerConnectionConfig = Readonly<{\n  /**\n   * The client instance to be used for communication.\n   */\n  client: ConnectClient;\n\n  /**\n   * The name of the signal provider service endpoint.\n   */\n  endpoint: string;\n\n  /**\n   * The name of the signal provider service method.\n   */\n  method: string;\n\n  /**\n   * Optional object with method call arguments to be sent to the endpoint\n   * method that provides the signal when subscribing to it.\n   */\n  params?: Record<string, unknown>;\n}>;\n\n/**\n * A server connection manager.\n */\nclass ServerConnection<T> {\n  readonly #id: string;\n  readonly #config: ServerConnectionConfig;\n  #subscription?: Subscription<StateEvent<T>>;\n\n  constructor(id: string, config: ServerConnectionConfig) {\n    this.#config = config;\n    this.#id = id;\n  }\n\n  get subscription() {\n    return this.#subscription;\n  }\n\n  connect() {\n    const { client, endpoint, method, params } = this.#config;\n\n    this.#subscription ??= client.subscribe(ENDPOINT, 'subscribe', {\n      providerEndpoint: endpoint,\n      providerMethod: method,\n      clientSignalId: this.#id,\n      params,\n    });\n\n    return this.#subscription;\n  }\n\n  async update(event: StateEvent<T>): Promise<void> {\n    await this.#config.client.call(ENDPOINT, 'update', {\n      clientSignalId: this.#id,\n      event,\n    });\n  }\n\n  disconnect() {\n    this.#subscription?.cancel();\n    this.#subscription = undefined;\n  }\n}\n\nexport const $update = Symbol('update');\nexport const $processServerResponse = Symbol('processServerResponse');\n\n/**\n * A signal that holds a shared value. Each change to the value is propagated to\n * the server-side signal provider. At the same time, each change received from\n * the server-side signal provider is propagated to the local signal and it's\n * subscribers.\n *\n * @internal\n */\nexport abstract class FullStackSignal<T> extends DependencyTrackingSignal<T> {\n  /**\n   * The unique identifier of the signal necessary to communicate with the\n   * server.\n   */\n  readonly id = nanoid();\n\n  /**\n   * The server connection manager.\n   */\n  readonly server: ServerConnection<T>;\n\n  /**\n   * Defines whether the signal is currently awaits a server-side response.\n   */\n  readonly pending = computed(() => this.#pending.value);\n\n  /**\n   * Defines whether the signal has an error.\n   */\n  readonly error = computed(() => this.#error.value);\n\n  readonly #pending = signal(false);\n  readonly #error = signal<Error | undefined>(undefined);\n\n  // Paused at the very start to prevent the signal from sending the initial\n  // value to the server.\n  #paused = true;\n\n  constructor(value: T | undefined, config: ServerConnectionConfig) {\n    super(\n      value,\n      () => this.#connect(),\n      () => this.#disconnect(),\n    );\n    this.server = new ServerConnection(this.id, config);\n\n    this.subscribe((v) => {\n      if (!this.#paused) {\n        this.#pending.value = true;\n        this.#error.value = undefined;\n        this[$update](createSetStateEvent(v));\n      }\n    });\n\n    this.#paused = false;\n  }\n\n  /**\n   * Sets the local value of the signal without sending any events to the server\n   * @param value - The new value.\n   * @internal\n   */\n  protected setValueLocal(value: T): void {\n    this.#paused = true;\n    this.value = value;\n    this.#paused = false;\n  }\n\n  /**\n   * A method to update the server with the new value.\n   *\n   * @param event - The event to update the server with.\n   */\n  protected [$update](event: StateEvent<T>): void {\n    this.server\n      .update(event)\n      .catch((error: unknown) => {\n        this.#error.value = error instanceof Error ? error : new Error(String(error));\n      })\n      .finally(() => {\n        this.#pending.value = false;\n      });\n  }\n\n  /**\n   * A method with to process the server response. The implementation is\n   * specific for each signal type.\n   *\n   * @param event - The server response event.\n   */\n  protected abstract [$processServerResponse](event: StateEvent<T>): void;\n\n  #connect() {\n    this.server.connect().onNext((event: StateEvent<T>) => {\n      this.#paused = true;\n      this[$processServerResponse](event);\n      this.#paused = false;\n    });\n  }\n\n  #disconnect() {\n    if (this.server.subscription === undefined) {\n      return;\n    }\n    this.server.disconnect();\n  }\n}\n"],
+  "mappings": "AACA,SAAS,cAAc;AACvB,SAAS,UAAU,QAAQ,cAAc;AACzC,SAAS,2BAA4C;AAErD,MAAM,WAAW;AAQV,MAAe,iCAAoC,OAAU;AAAA,EACzD;AAAA,EACA;AAAA;AAAA;AAAA,EAIT,kBAAkB;AAAA,EAER,YAAY,OAAsB,kBAA8B,mBAA+B;AACvG,UAAM,KAAK;AACX,SAAK,oBAAoB;AACzB,SAAK,qBAAqB;AAAA,EAC5B;AAAA,EAEmB,EAAE,MAAqB;AACxC,UAAM,EAAE,IAAI;AACZ,QAAI,KAAK,oBAAoB,GAAG;AAC9B,WAAK,kBAAkB;AAAA,IACzB;AACA,SAAK,mBAAmB;AAAA,EAC1B;AAAA,EAEmB,EAAE,MAAqB;AACxC,UAAM,EAAE,IAAI;AACZ,SAAK,mBAAmB;AACxB,QAAI,KAAK,oBAAoB,GAAG;AAC9B,WAAK,mBAAmB;AAAA,IAC1B;AAAA,EACF;AACF;AAgCA,MAAM,iBAAoB;AAAA,EACf;AAAA,EACA;AAAA,EACT;AAAA,EAEA,YAAY,IAAY,QAAgC;AACtD,SAAK,UAAU;AACf,SAAK,MAAM;AAAA,EACb;AAAA,EAEA,IAAI,eAAe;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,UAAU;AACR,UAAM,EAAE,QAAQ,UAAU,QAAQ,OAAO,IAAI,KAAK;AAElD,SAAK,kBAAkB,OAAO,UAAU,UAAU,aAAa;AAAA,MAC7D,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,gBAAgB,KAAK;AAAA,MACrB;AAAA,IACF,CAAC;AAED,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,OAAO,OAAqC;AAChD,UAAM,KAAK,QAAQ,OAAO,KAAK,UAAU,UAAU;AAAA,MACjD,gBAAgB,KAAK;AAAA,MACrB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,aAAa;AACX,SAAK,eAAe,OAAO;AAC3B,SAAK,gBAAgB;AAAA,EACvB;AACF;AAEO,MAAM,UAAU,OAAO,QAAQ;AAC/B,MAAM,yBAAyB,OAAO,uBAAuB;AAU7D,MAAe,wBAA2B,yBAA4B;AAAA;AAAA;AAAA;AAAA;AAAA,EAKlE,KAAK,OAAO;AAAA;AAAA;AAAA;AAAA,EAKZ;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,SAAS,MAAM,KAAK,SAAS,KAAK;AAAA;AAAA;AAAA;AAAA,EAK5C,QAAQ,SAAS,MAAM,KAAK,OAAO,KAAK;AAAA,EAExC,WAAW,OAAO,KAAK;AAAA,EACvB,SAAS,OAA0B,MAAS;AAAA;AAAA;AAAA,EAIrD,UAAU;AAAA,EAEV,YAAY,OAAsB,QAAgC;AAChE;AAAA,MACE;AAAA,MACA,MAAM,KAAK,SAAS;AAAA,MACpB,MAAM,KAAK,YAAY;AAAA,IACzB;AACA,SAAK,SAAS,IAAI,iBAAiB,KAAK,IAAI,MAAM;AAElD,SAAK,UAAU,CAAC,MAAM;AACpB,UAAI,CAAC,KAAK,SAAS;AACjB,aAAK,SAAS,QAAQ;AACtB,aAAK,OAAO,QAAQ;AACpB,aAAK,OAAO,EAAE,oBAAoB,CAAC,CAAC;AAAA,MACtC;AAAA,IACF,CAAC;AAED,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOU,cAAc,OAAgB;AACtC,SAAK,UAAU;AACf,SAAK,QAAQ;AACb,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,CAAW,OAAO,EAAE,OAA4B;AAC9C,SAAK,OACF,OAAO,KAAK,EACZ,MAAM,CAAC,UAAmB;AACzB,WAAK,OAAO,QAAQ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,IAC9E,CAAC,EACA,QAAQ,MAAM;AACb,WAAK,SAAS,QAAQ;AAAA,IACxB,CAAC;AAAA,EACL;AAAA,EAUA,WAAW;AACT,SAAK,OAAO,QAAQ,EAAE,OAAO,CAAC,UAAyB;AACrD,WAAK,UAAU;AACf,WAAK,sBAAsB,EAAE,KAAK;AAClC,WAAK,UAAU;AAAA,IACjB,CAAC;AAAA,EACH;AAAA,EAEA,cAAc;AACZ,QAAI,KAAK,OAAO,iBAAiB,QAAW;AAC1C;AAAA,IACF;AACA,SAAK,OAAO,WAAW;AAAA,EACzB;AACF;",
   "names": []
 }

package/NumberSignal.d.ts

@@ -0,0 +1,40 @@
+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> {
+    /**
+     * 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.
+     */
+    incrementBy(delta: number): void;
+}
+//# sourceMappingURL=NumberSignal.d.ts.map

package/NumberSignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberSignal.d.ts","sourceRoot":"","sources":["src/NumberSignal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,SAAQ,WAAW,CAAC,MAAM,CAAC;IACnD;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAQjC"}

package/NumberSignal.js

@@ -0,0 +1,29 @@
+import { createIncrementStateEvent } from "./events.js";
+import { $update } from "./FullStackSignal.js";
+import { ValueSignal } from "./ValueSignal.js";
+class NumberSignal extends ValueSignal {
+  /**
+   * 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.
+   */
+  incrementBy(delta) {
+    if (delta === 0) {
+      return;
+    }
+    this.setValueLocal(this.value + delta);
+    const event = createIncrementStateEvent(delta);
+    this[$update](event);
+  }
+}
+export {
+  NumberSignal
+};
+//# sourceMappingURL=NumberSignal.js.map

package/NumberSignal.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/NumberSignal.ts"],
+  "sourcesContent": ["import { createIncrementStateEvent } from './events.js';\nimport { $update } 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  /**\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   */\n  incrementBy(delta: number): void {\n    if (delta === 0) {\n      return;\n    }\n    this.setValueLocal(this.value + delta);\n    const event = createIncrementStateEvent(delta);\n    this[$update](event);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iCAAiC;AAC1C,SAAS,eAAe;AACxB,SAAS,mBAAmB;AAyBrB,MAAM,qBAAqB,YAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAapD,YAAY,OAAqB;AAC/B,QAAI,UAAU,GAAG;AACf;AAAA,IACF;AACA,SAAK,cAAc,KAAK,QAAQ,KAAK;AACrC,UAAM,QAAQ,0BAA0B,KAAK;AAC7C,SAAK,OAAO,EAAE,KAAK;AAAA,EACrB;AACF;",
+  "names": []
+}

package/events.d.ts

@@ -23,9 +23,11 @@ export type ReplaceStateEvent<T> = CreateStateEventType<T, 'replace', {
     expected: T;
 }>;
 export declare function createReplaceStateEvent<T>(expected: T, value: T): ReplaceStateEvent<T>;
+export type IncrementStateEvent = CreateStateEventType<number, 'increment'>;
+export declare function createIncrementStateEvent(delta: number): IncrementStateEvent;
 /**
  * An object that describes the change of the signal state.
  */
-export type StateEvent<T> = RejectStateEvent | ReplaceStateEvent<T> | SetStateEvent<T> | SnapshotStateEvent<T>;
+export type StateEvent<T> = IncrementStateEvent | RejectStateEvent | ReplaceStateEvent<T> | SetStateEvent<T> | SnapshotStateEvent<T>;
 export {};
 //# sourceMappingURL=events.d.ts.map

package/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["src/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;GAEG;AACH,KAAK,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,QAAQ,CACjH,QAAQ,CAAC;IACP,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,CAAC;CACV,CAAC,GACA,QAAQ,CAAC,CAAC,CAAC,CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAMjE;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAEvF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAOtF;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,gBAAgB,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["src/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;GAEG;AACH,KAAK,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,QAAQ,CACjH,QAAQ,CAAC;IACP,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,CAAC;CACV,CAAC,GACA,QAAQ,CAAC,CAAC,CAAC,CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAMjE;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAEvF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAOtF;AAED,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE5E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAM5E;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,CAAC,CAAC,CAAC,GACpB,aAAa,CAAC,CAAC,CAAC,GAChB,kBAAkB,CAAC,CAAC,CAAC,CAAC"}

package/events.js

@@ -14,7 +14,15 @@ function createReplaceStateEvent(expected, value) {
     expected
   };
 }
+function createIncrementStateEvent(delta) {
+  return {
+    id: nanoid(),
+    type: "increment",
+    value: delta
+  };
+}
 export {
+  createIncrementStateEvent,
   createReplaceStateEvent,
   createSetStateEvent
 };

package/events.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["src/events.ts"],
-  "sourcesContent": ["import { nanoid } from 'nanoid';\nimport type { Simplify } from 'type-fest';\n\n/**\n * Creates a new state event type.\n */\ntype CreateStateEventType<V, T extends string, C extends Record<string, unknown> = Record<never, never>> = Simplify<\n  Readonly<{\n    id: string;\n    type: T;\n    value: V;\n  }> &\n    Readonly<C>\n>;\n\n/**\n * A state event received from the server describing the current state of the\n * signal.\n */\nexport type SnapshotStateEvent<T> = CreateStateEventType<T, 'snapshot'>;\n\nexport type RejectStateEvent = CreateStateEventType<never, 'reject'>;\n\n/**\n * A state event defines a new value of the signal shared with the server. The\n *\n */\nexport type SetStateEvent<T> = CreateStateEventType<T, 'set'>;\n\nexport function createSetStateEvent<T>(value: T): SetStateEvent<T> {\n  return {\n    id: nanoid(),\n    type: 'set',\n    value,\n  };\n}\n\nexport type ReplaceStateEvent<T> = CreateStateEventType<T, 'replace', { expected: T }>;\n\nexport function createReplaceStateEvent<T>(expected: T, value: T): ReplaceStateEvent<T> {\n  return {\n    id: nanoid(),\n    type: 'replace',\n    value,\n    expected,\n  };\n}\n\n/**\n * An object that describes the change of the signal state.\n */\nexport type StateEvent<T> = RejectStateEvent | ReplaceStateEvent<T> | SetStateEvent<T> | SnapshotStateEvent<T>;\n"],
-  "mappings": "AAAA,SAAS,cAAc;AA6BhB,SAAS,oBAAuB,OAA4B;AACjE,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAIO,SAAS,wBAA2B,UAAa,OAAgC;AACtF,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { nanoid } from 'nanoid';\nimport type { Simplify } from 'type-fest';\n\n/**\n * Creates a new state event type.\n */\ntype CreateStateEventType<V, T extends string, C extends Record<string, unknown> = Record<never, never>> = Simplify<\n  Readonly<{\n    id: string;\n    type: T;\n    value: V;\n  }> &\n    Readonly<C>\n>;\n\n/**\n * A state event received from the server describing the current state of the\n * signal.\n */\nexport type SnapshotStateEvent<T> = CreateStateEventType<T, 'snapshot'>;\n\nexport type RejectStateEvent = CreateStateEventType<never, 'reject'>;\n\n/**\n * A state event defines a new value of the signal shared with the server. The\n *\n */\nexport type SetStateEvent<T> = CreateStateEventType<T, 'set'>;\n\nexport function createSetStateEvent<T>(value: T): SetStateEvent<T> {\n  return {\n    id: nanoid(),\n    type: 'set',\n    value,\n  };\n}\n\nexport type ReplaceStateEvent<T> = CreateStateEventType<T, 'replace', { expected: T }>;\n\nexport function createReplaceStateEvent<T>(expected: T, value: T): ReplaceStateEvent<T> {\n  return {\n    id: nanoid(),\n    type: 'replace',\n    value,\n    expected,\n  };\n}\n\nexport type IncrementStateEvent = CreateStateEventType<number, 'increment'>;\n\nexport function createIncrementStateEvent(delta: number): IncrementStateEvent {\n  return {\n    id: nanoid(),\n    type: 'increment',\n    value: delta,\n  };\n}\n\n/**\n * An object that describes the change of the signal state.\n */\nexport type StateEvent<T> =\n  | IncrementStateEvent\n  | RejectStateEvent\n  | ReplaceStateEvent<T>\n  | SetStateEvent<T>\n  | SnapshotStateEvent<T>;\n"],
+  "mappings": "AAAA,SAAS,cAAc;AA6BhB,SAAS,oBAAuB,OAA4B;AACjE,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAIO,SAAS,wBAA2B,UAAa,OAAgC;AACtF,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;AAIO,SAAS,0BAA0B,OAAoC;AAC5E,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AACF;",
   "names": []
 }

package/index.d.ts

@@ -1,6 +1,6 @@
 import './polyfills.js';
 export * from './core.js';
-export { NumberSignal } from './Signals.js';
+export { NumberSignal } from './NumberSignal.js';
 export { ValueSignal } from './ValueSignal.js';
 export type { OperationSubscription } from './ValueSignal.js';
 export { FullStackSignal } from './FullStackSignal.js';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,CAAC;AAGxB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,CAAC;AAGxB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/index.js

@@ -1,6 +1,6 @@
 import "./polyfills.js";
 export * from "./core.js";
-import { NumberSignal } from "./Signals.js";
+import { NumberSignal } from "./NumberSignal.js";
 import { ValueSignal } from "./ValueSignal.js";
 import { FullStackSignal } from "./FullStackSignal.js";
 export {

package/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["src/index.ts"],
-  "sourcesContent": ["// eslint-disable-next-line import/no-unassigned-import\nimport './polyfills.js';\n\n// eslint-disable-next-line import/export\nexport * from './core.js';\nexport { NumberSignal } from './Signals.js';\nexport { ValueSignal } from './ValueSignal.js';\nexport type { OperationSubscription } from './ValueSignal.js';\nexport { FullStackSignal } from './FullStackSignal.js';\n"],
+  "sourcesContent": ["// eslint-disable-next-line import/no-unassigned-import\nimport './polyfills.js';\n\n// eslint-disable-next-line import/export\nexport * from './core.js';\nexport { NumberSignal } from './NumberSignal.js';\nexport { ValueSignal } from './ValueSignal.js';\nexport type { OperationSubscription } from './ValueSignal.js';\nexport { FullStackSignal } from './FullStackSignal.js';\n"],
   "mappings": "AACA,OAAO;AAGP,cAAc;AACd,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAE5B,SAAS,uBAAuB;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/hilla-react-signals",
-  "version": "24.5.0-alpha14",
+  "version": "24.5.0-alpha15",
   "description": "Signals for Hilla React",
   "main": "index.js",
   "module": "index.js",
@@ -47,12 +47,12 @@
   },
   "dependencies": {
     "@preact/signals-react": "^2.0.0",
-    "@vaadin/hilla-frontend": "24.5.0-alpha14",
+    "@vaadin/hilla-frontend": "24.5.0-alpha15",
     "nanoid": "^5.0.7"
   },
   "peerDependencies": {
     "react": "^18",
-    "react-router-dom": "^6"
+    "react-router-dom": "^6.26.2"
   },
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4-fix.0",
@@ -74,6 +74,6 @@
     "karma-viewport": "^1.0.9",
     "sinon": "^16.0.0",
     "sinon-chai": "^3.7.0",
-    "typescript": "5.5.2"
+    "typescript": "5.6.2"
   }
 }

package/Signals.d.ts

@@ -1,84 +0,0 @@
-import { type OperationSubscription, 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++)}>
- *      Click count: { counter }
- *    </Button>
- *    <Button onClick={() => counter.value = 0}>Reset</Button>
- * );
- * ```
- */
-export declare class NumberSignal extends ValueSignal<number> {
-    /**
-     * Increments the value by the specified delta. The delta can be negative to
-     * decrease the value. If no delta is provided, the value increases by 1.
-     *
-     * This method differs from using the `++` or `+=` operators directly on the
-     * signal instance. It performs an atomic operation to prevent conflicts from
-     * concurrent changes, ensuring that other users' modifications are not
-     * accidentally overwritten.
-     *
-     * By default, if there are concurrent changes on the server, this operation
-     * will keep retrying until it succeeds. The returned `OperationSubscription`
-     * can be used to cancel the operation, if needed.
-     * To disable automatic retries, set `retryOnFailure` to `false`. Note that
-     * when `retryOnFailure` is `false`, the returned `OperationSubscription` will
-     * not be cancellable.
-     *
-     * @remarks
-     * **IMPORTANT:** please note that if the operation has already succeeded on
-     * the server, calling `cancel` will not prevent or undo the operation.The
-     * `cancel` method only stops further retry attempts if a previous attempt was
-     * rejected by the server.
-     *
-     * @param delta - The delta to increment the value by. The delta can be
-     * negative. Defaults to 1.
-     * @param retryOnFailure - Whether to retry the operation in case of a
-     * concurrent value change on the server or not. Defaults to `true`.
-     *
-     * @returns An object that can be used to cancel the operation.
-     */
-    increment(delta?: number, retryOnFailure?: boolean): OperationSubscription;
-    /**
-     * Adds the provided delta to the value. The delta can be negative to perform
-     * a subtraction.
-     * This operation does not retry in case failure due to concurrent value
-     * changes from other clients have already applied to the shared value on the
-     * server. If you want the operation to be retried until it succeeds, use the
-     * overload with retry functionality.
-     *
-     * @param delta - The delta to add to the value. The delta can be negative to
-     * perform a subtraction.
-     * @see {@link NumberSignal.add|add(delta: number, retryOnFailure: boolean)}
-     */
-    add(delta: number): void;
-    /**
-     * Adds the provided delta to the value. The delta can be negative to perform
-     * a subtraction.
-     * If `true` passed to the `retryOnFailure` parameter, the operation is
-     * retried in case of failures due to concurrent value changes on the server
-     * until it succeeds. Note that the returned operation subscription can be
-     * used to cancel the operation.
-     *
-     * @param delta - The delta to add to the value. The delta can be negative.
-     * @param retryOnFailure - Whether to retry the operation in case of failures
-     * due to concurrent value changes on the server or not.
-     * @returns An operation subscription that can be canceled.
-     */
-    add(delta: number, retryOnFailure: boolean): OperationSubscription;
-}
-//# sourceMappingURL=Signals.d.ts.map

package/Signals.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Signals.d.ts","sourceRoot":"","sources":["src/Signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,SAAQ,WAAW,CAAC,MAAM,CAAC;IACnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,SAAS,CAAC,KAAK,GAAE,MAAU,EAAE,cAAc,GAAE,OAAc,GAAG,qBAAqB;IAanF;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAExB;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,qBAAqB;CAanE"}

package/Signals.js

@@ -1,59 +0,0 @@
-import { ValueSignal } from "./ValueSignal.js";
-class NumberSignal extends ValueSignal {
-  /**
-   * Increments the value by the specified delta. The delta can be negative to
-   * decrease the value. If no delta is provided, the value increases by 1.
-   *
-   * This method differs from using the `++` or `+=` operators directly on the
-   * signal instance. It performs an atomic operation to prevent conflicts from
-   * concurrent changes, ensuring that other users' modifications are not
-   * accidentally overwritten.
-   *
-   * By default, if there are concurrent changes on the server, this operation
-   * will keep retrying until it succeeds. The returned `OperationSubscription`
-   * can be used to cancel the operation, if needed.
-   * To disable automatic retries, set `retryOnFailure` to `false`. Note that
-   * when `retryOnFailure` is `false`, the returned `OperationSubscription` will
-   * not be cancellable.
-   *
-   * @remarks
-   * **IMPORTANT:** please note that if the operation has already succeeded on
-   * the server, calling `cancel` will not prevent or undo the operation.The
-   * `cancel` method only stops further retry attempts if a previous attempt was
-   * rejected by the server.
-   *
-   * @param delta - The delta to increment the value by. The delta can be
-   * negative. Defaults to 1.
-   * @param retryOnFailure - Whether to retry the operation in case of a
-   * concurrent value change on the server or not. Defaults to `true`.
-   *
-   * @returns An object that can be used to cancel the operation.
-   */
-  increment(delta = 1, retryOnFailure = true) {
-    const noopCancelSubscription = { cancel: () => {
-    } };
-    if (delta === 0) {
-      return noopCancelSubscription;
-    }
-    if (!retryOnFailure) {
-      const expected = this.value;
-      this.replace(expected, expected + delta);
-      return noopCancelSubscription;
-    }
-    return this.update((value) => value + delta);
-  }
-  add(delta, retryOnFailure) {
-    if (delta !== 0) {
-      if (retryOnFailure) {
-        return this.increment(delta, retryOnFailure);
-      }
-      const expected = this.value;
-      this.replace(expected, expected + delta);
-    }
-    return;
-  }
-}
-export {
-  NumberSignal
-};
-//# sourceMappingURL=Signals.js.map

package/Signals.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["src/Signals.ts"],
-  "sourcesContent": ["import { type OperationSubscription, 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++)}>\n *      Click count: { counter }\n *    </Button>\n *    <Button onClick={() => counter.value = 0}>Reset</Button>\n * );\n * ```\n */\nexport class NumberSignal extends ValueSignal<number> {\n  /**\n   * Increments the value by the specified delta. The delta can be negative to\n   * decrease the value. If no delta is provided, the value increases by 1.\n   *\n   * This method differs from using the `++` or `+=` operators directly on the\n   * signal instance. It performs an atomic operation to prevent conflicts from\n   * concurrent changes, ensuring that other users' modifications are not\n   * accidentally overwritten.\n   *\n   * By default, if there are concurrent changes on the server, this operation\n   * will keep retrying until it succeeds. The returned `OperationSubscription`\n   * can be used to cancel the operation, if needed.\n   * To disable automatic retries, set `retryOnFailure` to `false`. Note that\n   * when `retryOnFailure` is `false`, the returned `OperationSubscription` will\n   * not be cancellable.\n   *\n   * @remarks\n   * **IMPORTANT:** please note that if the operation has already succeeded on\n   * the server, calling `cancel` will not prevent or undo the operation.The\n   * `cancel` method only stops further retry attempts if a previous attempt was\n   * rejected by the server.\n   *\n   * @param delta - The delta to increment the value by. The delta can be\n   * negative. Defaults to 1.\n   * @param retryOnFailure - Whether to retry the operation in case of a\n   * concurrent value change on the server or not. Defaults to `true`.\n   *\n   * @returns An object that can be used to cancel the operation.\n   */\n  increment(delta: number = 1, retryOnFailure: boolean = true): OperationSubscription {\n    const noopCancelSubscription = { cancel: () => {} };\n    if (delta === 0) {\n      return noopCancelSubscription;\n    }\n    if (!retryOnFailure) {\n      const expected = this.value;\n      this.replace(expected, expected + delta);\n      return noopCancelSubscription;\n    }\n    return this.update((value) => value + delta);\n  }\n\n  /**\n   * Adds the provided delta to the value. The delta can be negative to perform\n   * a subtraction.\n   * This operation does not retry in case failure due to concurrent value\n   * changes from other clients have already applied to the shared value on the\n   * server. If you want the operation to be retried until it succeeds, use the\n   * overload with retry functionality.\n   *\n   * @param delta - The delta to add to the value. The delta can be negative to\n   * perform a subtraction.\n   * @see {@link NumberSignal.add|add(delta: number, retryOnFailure: boolean)}\n   */\n  add(delta: number): void;\n\n  /**\n   * Adds the provided delta to the value. The delta can be negative to perform\n   * a subtraction.\n   * If `true` passed to the `retryOnFailure` parameter, the operation is\n   * retried in case of failures due to concurrent value changes on the server\n   * until it succeeds. Note that the returned operation subscription can be\n   * used to cancel the operation.\n   *\n   * @param delta - The delta to add to the value. The delta can be negative.\n   * @param retryOnFailure - Whether to retry the operation in case of failures\n   * due to concurrent value changes on the server or not.\n   * @returns An operation subscription that can be canceled.\n   */\n  add(delta: number, retryOnFailure: boolean): OperationSubscription;\n\n  add(delta: number, retryOnFailure?: boolean): OperationSubscription | void {\n    if (delta !== 0) {\n      if (retryOnFailure) {\n        return this.increment(delta, retryOnFailure);\n      }\n      const expected = this.value;\n      this.replace(expected, expected + delta);\n    }\n    // eslint-disable-next-line no-useless-return, consistent-return\n    return;\n  }\n}\n"],
-  "mappings": "AAAA,SAAqC,mBAAmB;AAyBjD,MAAM,qBAAqB,YAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BpD,UAAU,QAAgB,GAAG,iBAA0B,MAA6B;AAClF,UAAM,yBAAyB,EAAE,QAAQ,MAAM;AAAA,IAAC,EAAE;AAClD,QAAI,UAAU,GAAG;AACf,aAAO;AAAA,IACT;AACA,QAAI,CAAC,gBAAgB;AACnB,YAAM,WAAW,KAAK;AACtB,WAAK,QAAQ,UAAU,WAAW,KAAK;AACvC,aAAO;AAAA,IACT;AACA,WAAO,KAAK,OAAO,CAAC,UAAU,QAAQ,KAAK;AAAA,EAC7C;AAAA,EA+BA,IAAI,OAAe,gBAAwD;AACzE,QAAI,UAAU,GAAG;AACf,UAAI,gBAAgB;AAClB,eAAO,KAAK,UAAU,OAAO,cAAc;AAAA,MAC7C;AACA,YAAM,WAAW,KAAK;AACtB,WAAK,QAAQ,UAAU,WAAW,KAAK;AAAA,IACzC;AAEA;AAAA,EACF;AACF;",
-  "names": []
-}