@mmstack/primitives 22.6.0 → 22.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/primitives",
-  "version": "22.6.0",
+  "version": "22.6.1",
   "keywords": [
     "angular",
     "signals",

package/types/mmstack-primitives.d.ts

@@ -2283,7 +2283,7 @@ type PointerDragState = {
     /**
      * The element the gesture started on: the `handleSelector` match when one is
      * set (so a single delegated listener can tell which child started the drag),
-     * otherwise the listener's element. `null` when idle.
+     * otherwise the pressed element itself (`event.target`). `null` when idle.
      */
     origin: HTMLElement | null;
     /**
@@ -3498,6 +3498,23 @@ type MaybePromise<T> = T | Promise<T>;
  *   del: (k) => table.delete(k),
  * };
  * ```
+ *
+ * The backend is also the seam for cross-cutting storage concerns like encryption: wrap any
+ * backend in a decorator (get/set may be async, so WebCrypto fits here — `serialize` is sync
+ * by design and is for shape, not for the storage medium). Versioning and migration still work
+ * because the version envelope is inspected on what the backend RETURNS, i.e. after decryption:
+ *
+ * ```ts
+ * const encrypted = (inner: AsyncStore, cipher: MyCipher): AsyncStore => ({
+ *   get: async (k) => {
+ *     const raw = await inner.get(k);
+ *     return raw === undefined ? undefined : cipher.decrypt(raw);
+ *   },
+ *   set: async (k, v) => inner.set(k, await cipher.encrypt(v)),
+ *   del: (k) => inner.del(k),
+ * });
+ * providePersistedStoreOptions({ store: encrypted(idbKeyval, cipher) });
+ * ```
  */
 type AsyncStore = {
     get(key: string): MaybePromise<unknown>;