@evolu/common 7.4.0 → 8.0.0-next.0

package/dist/src/Store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../src/Store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAY,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CACvD;AAED,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,gBAAgB,CAAC;AAE3E,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,cAAc,CAAC,EACf,KAAI,EAAE,CAAC,CAAC,CAAY,KACnB,KAAK,CAAC,CAAC,CA4BT,CAAC"}
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../src/Store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAGpC;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;CAAG;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,UAAU;IAClD,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,WAAW,CAAC;CACzD;AAED,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAqEnE,CAAC"}

package/dist/src/Store.js

@@ -1,34 +1,74 @@
+/**
+ * Observable state container with change notifications.
+ *
+ * @module
+ */
 import { eqStrict } from "./Eq.js";
+import { createRef } from "./Ref.js";
 /**
  * Creates a store with the given initial state. The store encapsulates its
- * state, which can be read with `get` and updated with `set` or `modify`. All
+ * state, which can be read with `get` and updated with `set` or `update`. All
  * changes are broadcast to subscribers.
  *
- * By default, state changes are detected using `===` (shallow equality). You
- * can provide a custom equality function as the second argument.
+ * By default, state changes are detected using strict equality (`===`). You can
+ * provide a custom equality function as the second argument.
  */
-export const createStore = (initialState, eq = eqStrict) => {
+export const createStore = (initialState, eq) => {
+    const equality = eq ?? eqStrict;
+    const ref = createRef(initialState);
     const listeners = new Set();
-    let currentState = initialState;
-    const updateState = (newState) => {
-        if (eq(newState, currentState))
-            return;
-        currentState = newState;
-        listeners.forEach((listener) => {
-            listener();
-        });
+    const notifyIfChanged = (previousState) => {
+        if (!equality(previousState, ref.get())) {
+            for (const listener of listeners)
+                listener();
+        }
     };
     return {
+        get: ref.get,
         subscribe: (listener) => {
             listeners.add(listener);
             return () => listeners.delete(listener);
         },
-        get: () => currentState,
         set: (state) => {
-            updateState(state);
+            const previousState = ref.get();
+            ref.set(state);
+            notifyIfChanged(previousState);
+        },
+        getAndSet: (state) => {
+            const previousState = ref.getAndSet(state);
+            notifyIfChanged(previousState);
+            return previousState;
+        },
+        setAndGet: (state) => {
+            const previousState = ref.get();
+            ref.set(state);
+            notifyIfChanged(previousState);
+            return ref.get();
+        },
+        update: (updater) => {
+            const previousState = ref.get();
+            ref.update(updater);
+            notifyIfChanged(previousState);
+        },
+        getAndUpdate: (updater) => {
+            const previousState = ref.getAndUpdate(updater);
+            notifyIfChanged(previousState);
+            return previousState;
+        },
+        updateAndGet: (updater) => {
+            const previousState = ref.get();
+            ref.updateAndGet(updater);
+            notifyIfChanged(previousState);
+            return ref.get();
         },
         modify: (updater) => {
-            updateState(updater(currentState));
+            const previousState = ref.get();
+            const result = ref.modify(updater);
+            notifyIfChanged(previousState);
+            return result;
+        },
+        [Symbol.dispose]: () => {
+            listeners.clear();
         },
     };
 };

package/dist/src/String.d.ts

@@ -1,2 +1,7 @@
+/**
+ * String utilities for safe value conversion.
+ *
+ * @module
+ */
 export declare const safelyStringifyUnknownValue: (value: unknown) => string;
 //# sourceMappingURL=String.d.ts.map

package/dist/src/String.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../../src/String.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,MAS5D,CAAC"}
+{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../../src/String.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,MAS5D,CAAC"}

package/dist/src/String.js

@@ -1,3 +1,8 @@
+/**
+ * String utilities for safe value conversion.
+ *
+ * @module
+ */
 export const safelyStringifyUnknownValue = (value) => {
     if (value === null)
         return "null";