@oimdb/react 2.2.0 → 3.1.0

package/dist/index.js

@@ -1,724 +1,355 @@
-// src/hooks/index.ts
-import { useMemo as useMemo2, useRef as useRef2 } from "react";
-import { useSyncExternalStore as useSyncExternalStore2 } from "react";
+// src/OIMDBContext.ts
+import { createContext } from "react";
+var OIMDBContext = createContext(void 0);
 
-// src/hooks/global.ts
-import { useMemo, useRef, useSyncExternalStore } from "react";
-var useSelectPksByGlobalIndexArrayBased = (reactiveIndex) => {
-  const snapshotValueRef = useRef();
-  const subscribe = useMemo(() => {
-    snapshotValueRef.current = reactiveIndex.getPks();
-    return (onStoreChange) => {
-      return reactiveIndex.subscribe(() => {
-        snapshotValueRef.current = reactiveIndex.getPks();
-        onStoreChange();
-      });
-    };
-  }, [reactiveIndex]);
-  const getSnapshot = useMemo(() => () => snapshotValueRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectPksByGlobalIndexSetBased = (reactiveIndex) => {
-  const snapshotValueRef = useRef();
-  const subscribe = useMemo(() => {
-    snapshotValueRef.current = reactiveIndex.getPks();
-    return (onStoreChange) => {
-      return reactiveIndex.subscribe(() => {
-        snapshotValueRef.current = reactiveIndex.getPks();
-        onStoreChange();
-      });
-    };
-  }, [reactiveIndex]);
-  const getSnapshot = useMemo(() => () => snapshotValueRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByGlobalIndexArrayBased = (reactiveCollection, reactiveIndex) => {
-  const snapshotRef = useRef();
-  const subscribe = useMemo(() => {
-    const readPks = () => reactiveIndex.getPks();
-    const readSnapshot = () => readPks().map((pk) => reactiveCollection.getOneByPk(pk));
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-        readPks(),
-        () => {
-          snapshotRef.current = readSnapshot();
-          onStoreChange();
-        }
-      );
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribe(() => {
-        resubscribeCollection();
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo(() => () => snapshotRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByGlobalIndexSetBased = (reactiveCollection, reactiveIndex) => {
-  const snapshotRef = useRef();
-  const subscribe = useMemo(() => {
-    const readPks = () => Array.from(reactiveIndex.getPks());
-    const readSnapshot = () => readPks().map((pk) => reactiveCollection.getOneByPk(pk));
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-        readPks(),
-        () => {
-          snapshotRef.current = readSnapshot();
-          onStoreChange();
-        }
-      );
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribe(() => {
-        resubscribeCollection();
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo(() => () => snapshotRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-};
+// src/OIMDBProvider.tsx
+import { jsx } from "react/jsx-runtime";
+function OIMDBProvider({ db, children }) {
+  return /* @__PURE__ */ jsx(OIMDBContext.Provider, { value: db, children });
+}
 
-// src/hooks/signal.ts
-import { useEffect, useLayoutEffect, useReducer } from "react";
-var useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
-function useForceUpdate() {
-  const [, force] = useReducer((c) => c + 1 | 0, 0);
-  return force;
+// src/useOIMDB.ts
+import { useContext } from "react";
+function useOIMDB() {
+  const db = useContext(OIMDBContext);
+  if (db === void 0) {
+    throw new Error(
+      "useOIMDB: no <OIMDBProvider db={...}> above this component. The hooks that build a computed for the component take the database from it."
+    );
+  }
+  return db;
 }
-var useSelectEntityByPkSignal = (reactiveCollection, pk) => {
-  const force = useForceUpdate();
-  useIsomorphicLayoutEffect(
-    () => reactiveCollection.subscribeOnKey(pk, force),
-    [reactiveCollection, pk]
-  );
-  return reactiveCollection.getOneByPk(pk);
-};
-var useSelectPksByIndexKeyArrayBasedSignal = (reactiveIndex, key) => {
-  const force = useForceUpdate();
-  useIsomorphicLayoutEffect(
-    () => reactiveIndex.subscribeOnKey(key, force),
-    [reactiveIndex, key]
-  );
-  return reactiveIndex.getPksByKey(key);
-};
-var useSelectPksByIndexKeySetBasedSignal = (reactiveIndex, key) => {
-  const force = useForceUpdate();
-  useIsomorphicLayoutEffect(
-    () => reactiveIndex.subscribeOnKey(key, force),
-    [reactiveIndex, key]
-  );
-  return reactiveIndex.getPksByKey(key);
-};
-var useSelectPksByGlobalIndexArrayBasedSignal = (reactiveIndex) => {
-  const force = useForceUpdate();
-  useIsomorphicLayoutEffect(
-    () => reactiveIndex.subscribe(force),
-    [reactiveIndex]
-  );
-  return reactiveIndex.getPks();
-};
-var useSelectPksByGlobalIndexSetBasedSignal = (reactiveIndex) => {
-  const force = useForceUpdate();
-  useIsomorphicLayoutEffect(
-    () => reactiveIndex.subscribe(force),
-    [reactiveIndex]
-  );
-  return reactiveIndex.getPks();
-};
 
-// src/hooks/index.ts
-var EMPTY_ARRAY = [];
-var useSelectPksByIndexKeysSetBased = (reactiveIndex, keys) => {
-  const prevKeysRef = useRef2();
-  const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
-  if (!keysAreEqual) {
-    prevKeysRef.current = keys;
+// src/useOIMValue.ts
+import { useMemo } from "react";
+import { OIM_FROZEN_EMPTY_SLOTS, oimRefreshSourceComputeds } from "@oimdb/core";
+
+// src/OIMSnapshotVersion.ts
+import { OIMEffectService } from "@oimdb/core";
+var OIMSnapshotVersion = class {
+  constructor() {
+    this.version = 0;
+    this.getVersion = () => this.version;
+  }
+  subscribeEffect(channelMap, onStoreChange, sourceSlots, sourceComputeds) {
+    this.version++;
+    return OIMEffectService.INSTANCE.subscribeEffect(channelMap, () => {
+      this.version++;
+      onStoreChange();
+    }, sourceSlots, sourceComputeds);
   }
-  const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotValueRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotValueRef.current = stableKeys.map((key) => Array.from(reactiveIndex.getPksByKey(key))).flat();
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotValueRef.current = stableKeys.map((key) => Array.from(reactiveIndex.getPksByKey(key))).flat();
-        onStoreChange();
-      };
-      const unsubscribe = reactiveIndex.subscribeOnKeys(
-        stableKeys,
-        updateSnapshot
-      );
-      return () => {
-        unsubscribe();
-      };
-    };
-  }, [reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo2(() => {
-    return () => {
-      return snapshotValueRef.current;
-    };
-  }, []);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
 };
-var useSelectPksByIndexKeySetBased = (reactiveIndex, key) => {
-  const snapshotValueRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotValueRef.current = reactiveIndex.getPksByKey(key);
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotValueRef.current = reactiveIndex.getPksByKey(key);
-        onStoreChange();
-      };
-      return reactiveIndex.subscribeOnKey(key, updateSnapshot);
-    };
-  }, [key, reactiveIndex]);
-  const getSnapshot = useMemo2(() => {
-    return () => {
-      return snapshotValueRef.current;
+
+// src/useOIMSnapshotVersion.ts
+import { useSyncExternalStore } from "react";
+function useOIMSnapshotVersion(snapshotVersion, subscribe) {
+  return useSyncExternalStore(subscribe, snapshotVersion.getVersion, snapshotVersion.getVersion);
+}
+
+// src/useOIMValue.ts
+function useOIMValue(binding) {
+  const db = useOIMDB();
+  const sourceComputeds = binding.sourceComputeds ?? OIM_FROZEN_EMPTY_SLOTS;
+  const store = useMemo(() => {
+    const snapshotVersion = new OIMSnapshotVersion();
+    return {
+      snapshotVersion,
+      subscribe: (onStoreChange) => snapshotVersion.subscribeEffect(
+        db,
+        onStoreChange,
+        binding.sourceSlots ?? OIM_FROZEN_EMPTY_SLOTS,
+        sourceComputeds
+      )
     };
-  }, []);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-var useSelectPksByIndexKeysArrayBased = (reactiveIndex, keys) => {
-  const prevKeysRef = useRef2();
-  const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
-  if (!keysAreEqual) {
-    prevKeysRef.current = keys;
+  }, [db, binding, sourceComputeds]);
+  useOIMSnapshotVersion(store.snapshotVersion, store.subscribe);
+  oimRefreshSourceComputeds(sourceComputeds);
+  return binding.derive();
+}
+
+// src/useOIMComputedValue.ts
+import { useMemo as useMemo2 } from "react";
+function useOIMComputedValue(computedSlot) {
+  const binding = useMemo2(() => ({
+    sourceComputeds: [computedSlot],
+    derive: () => computedSlot.value
+  }), [computedSlot]);
+  return useOIMValue(binding);
+}
+
+// src/useOIMSlotByKey.ts
+import { useMemo as useMemo3, useRef } from "react";
+import { OIM_FROZEN_EMPTY_SLOTS as OIM_FROZEN_EMPTY_SLOTS2 } from "@oimdb/core";
+
+// src/oimAssertOneChannel.ts
+function oimAssertOneChannel(channelMap, slot, door) {
+  if (slot.storeSlot.channelSlot === channelMap.defaultChannelSlot) return;
+  throw new Error(
+    `${door}: the slot was filed on another OIMDB than the one <OIMDBProvider> was given, so a write would never wake this component. Build the services and their store slots on the one OIMDB the provider holds.`
+  );
+}
+
+// src/oimSubscribeHeldSlot.ts
+function oimSubscribeHeldSlot(channelMap, hookName, snapshotVersion, holdingSlot, sourcesOfSlot, onStoreChange) {
+  try {
+    oimAssertOneChannel(channelMap, holdingSlot, hookName);
+    const [sourceSlots, sourceComputeds] = sourcesOfSlot(holdingSlot);
+    return snapshotVersion.subscribeEffect(channelMap, onStoreChange, sourceSlots, sourceComputeds);
+  } finally {
+    holdingSlot.owner.unholdSlot(holdingSlot);
   }
-  const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotValueRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotValueRef.current = stableKeys.map((key) => reactiveIndex.getPksByKey(key)).flat();
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotValueRef.current = stableKeys.map((key) => reactiveIndex.getPksByKey(key)).flat();
-        onStoreChange();
-      };
-      const unsubscribe = reactiveIndex.subscribeOnKeys(
-        stableKeys,
-        updateSnapshot
-      );
-      return () => {
-        unsubscribe();
-      };
-    };
-  }, [reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo2(() => {
-    return () => {
-      return snapshotValueRef.current;
-    };
-  }, []);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-var useSelectPksByIndexKeyArrayBased = (reactiveIndex, key) => {
-  const prevKeyRef = useRef2();
-  const keyAreEqual = prevKeyRef.current === key;
-  if (!keyAreEqual) {
-    prevKeyRef.current = key;
+}
+
+// src/useOIMSlotByKey.ts
+var sourcesOfRootSlot = (rootSlot) => [[rootSlot], OIM_FROZEN_EMPTY_SLOTS2];
+function useOIMSlotByKey(hookName, slotCollectionService, storeSlot, key, sourcesOfSlot = sourcesOfRootSlot) {
+  const db = useOIMDB();
+  const lastSeenKeyRef = useRef(key);
+  const settledKeyRef = useRef(key);
+  if (key !== lastSeenKeyRef.current) {
+    lastSeenKeyRef.current = key;
+    if (slotCollectionService.getSlotByKey(storeSlot, key) !== slotCollectionService.getSlotByKey(storeSlot, settledKeyRef.current)) {
+      settledKeyRef.current = key;
+    }
   }
-  const snapshotValueRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotValueRef.current = reactiveIndex.getPksByKey(key);
-    return (onStoreChange) => {
-      const prevKey = prevKeyRef.current;
-      if (!prevKey) {
+  const settledKey = settledKeyRef.current;
+  const store = useMemo3(() => {
+    const snapshotVersion = new OIMSnapshotVersion();
+    let subscribedSlot = void 0;
+    return {
+      snapshotVersion,
+      subscribe: (onStoreChange) => {
+        const holdingSlot = slotCollectionService.holdSlotByKey(storeSlot, settledKey);
+        const effectDisposer = oimSubscribeHeldSlot(db, hookName, snapshotVersion, holdingSlot, sourcesOfSlot, onStoreChange);
+        subscribedSlot = holdingSlot;
         return () => {
+          subscribedSlot = void 0;
+          effectDisposer();
         };
-      }
-      const updateSnapshot = () => {
-        snapshotValueRef.current = reactiveIndex.getPksByKey(prevKey);
-        onStoreChange();
-      };
-      const unsubscribe = reactiveIndex.subscribeOnKey(
-        prevKey,
-        updateSnapshot
-      );
-      return () => {
-        unsubscribe();
-      };
-    };
-  }, [key, reactiveIndex]);
-  const getSnapshot = useMemo2(() => {
-    return () => {
-      return snapshotValueRef.current;
-    };
-  }, []);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-var useSelectEntityByPk = (reactiveCollection, pk) => {
-  const getSnapshot = useMemo2(
-    () => () => reactiveCollection.getOneByPk(pk),
-    [pk, reactiveCollection]
-  );
-  const subscribe = useMemo2(() => {
-    return (onStoreChange) => {
-      return reactiveCollection.subscribeOnKey(pk, onStoreChange);
+      },
+      getSlot: () => subscribedSlot ?? slotCollectionService.getSlotByKey(storeSlot, settledKey)
     };
-  }, [pk, reactiveCollection]);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-var useSelectValueByObjectKey = (reactiveObject, key) => {
-  const getSnapshot = useMemo2(
-    () => () => reactiveObject.get(key),
-    [key, reactiveObject]
-  );
-  const subscribe = useMemo2(() => {
-    return (onStoreChange) => {
-      return reactiveObject.subscribeOnKey(key, onStoreChange);
+  }, [hookName, db, slotCollectionService, storeSlot, settledKey, sourcesOfSlot]);
+  useOIMSnapshotVersion(store.snapshotVersion, store.subscribe);
+  return store.getSlot();
+}
+
+// src/useOIMEntity.ts
+function useOIMEntity(entityCollectionService, entityStoreSlot, key) {
+  return useOIMSlotByKey("useOIMEntity", entityCollectionService, entityStoreSlot, key).entity;
+}
+
+// src/useOIMSingleSlot.ts
+import { useMemo as useMemo4 } from "react";
+import { OIM_FROZEN_EMPTY_SLOTS as OIM_FROZEN_EMPTY_SLOTS3 } from "@oimdb/core";
+var sourcesOfRootSlot2 = (rootSlot) => [[rootSlot], OIM_FROZEN_EMPTY_SLOTS3];
+function useOIMSingleSlot(hookName, singleSlotService, singleSlotStoreSlot, sourcesOfSlot = sourcesOfRootSlot2) {
+  const db = useOIMDB();
+  const store = useMemo4(() => {
+    const snapshotVersion = new OIMSnapshotVersion();
+    let subscribedSlot = void 0;
+    return {
+      snapshotVersion,
+      subscribe: (onStoreChange) => {
+        const holdingSlot = singleSlotService.holdSingleSlot(singleSlotStoreSlot);
+        const effectDisposer = oimSubscribeHeldSlot(db, hookName, snapshotVersion, holdingSlot, sourcesOfSlot, onStoreChange);
+        subscribedSlot = holdingSlot;
+        return () => {
+          subscribedSlot = void 0;
+          effectDisposer();
+        };
+      },
+      getSlot: () => subscribedSlot ?? singleSlotService.getSingleSlot(singleSlotStoreSlot)
     };
-  }, [key, reactiveObject]);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-var useSelectValuesByObjectKeys = (reactiveObject, keys) => {
-  const prevKeysRef = useRef2();
-  const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
-  if (!keysAreEqual) {
-    prevKeysRef.current = keys;
+  }, [hookName, db, singleSlotService, singleSlotStoreSlot, sourcesOfSlot]);
+  useOIMSnapshotVersion(store.snapshotVersion, store.subscribe);
+  return store.getSlot();
+}
+
+// src/useOIMSingleEntity.ts
+function useOIMSingleEntity(singleSlotService, singleSlotStoreSlot) {
+  return useOIMSingleSlot("useOIMSingleEntity", singleSlotService, singleSlotStoreSlot).entity;
+}
+
+// src/useOIMSingleBucketSlots.ts
+function useOIMSingleBucketSlots(singleSlotService, singleSlotStoreSlot) {
+  const bucketSlot = useOIMSingleSlot("useOIMSingleBucketSlots", singleSlotService, singleSlotStoreSlot);
+  return Array.from(singleSlotService.slotContentService.getBucketMemberSlots(bucketSlot));
+}
+
+// src/useOIMField.ts
+import { useMemo as useMemo5 } from "react";
+
+// src/holdWhileSubscribed.ts
+import { oimHoldSlots, oimUnholdSlotsIfAlive } from "@oimdb/core";
+function holdWhileSubscribed(slots, subscribe) {
+  oimHoldSlots(slots);
+  const giveEveryHoldBack = () => {
+    oimUnholdSlotsIfAlive(slots);
+  };
+  let disposer;
+  try {
+    disposer = subscribe();
+  } catch (failure) {
+    giveEveryHoldBack();
+    throw failure;
   }
-  const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotRef.current = stableKeys.map((key) => reactiveObject.get(key));
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotRef.current = stableKeys.map(
-          (key) => reactiveObject.get(key)
-        );
-        onStoreChange();
-      };
-      const unsubscribe = reactiveObject.subscribeOnKeys(
-        stableKeys,
-        updateSnapshot
-      );
-      return () => {
-        unsubscribe();
-      };
-    };
-  }, [reactiveObject, stableKeys]);
-  const getSnapshot = useMemo2(() => {
-    return () => {
-      return snapshotRef.current;
+  return () => {
+    try {
+      disposer();
+    } finally {
+      giveEveryHoldBack();
+    }
+  };
+}
+
+// src/useOIMField.ts
+function useOIMField(entityCollectionService, slot, name) {
+  const db = useOIMDB();
+  const store = useMemo5(() => {
+    oimAssertOneChannel(db, slot, "useOIMField");
+    const holds = [slot];
+    const snapshotVersion = new OIMSnapshotVersion();
+    return {
+      snapshotVersion,
+      subscribe: (onStoreChange) => holdWhileSubscribed(holds, () => snapshotVersion.subscribeEffect(
+        db,
+        onStoreChange,
+        [entityCollectionService.columnSlotService.getColumn(slot, name)]
+      ))
     };
-  }, []);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-function arraysEqual(a, b) {
-  if (a === b) return true;
-  if (a.length !== b.length) return false;
-  for (let i = 0; i < a.length; i++) {
-    if (a[i] !== b[i]) return false;
-  }
-  return true;
+  }, [db, entityCollectionService, slot, name]);
+  useOIMSnapshotVersion(store.snapshotVersion, store.subscribe);
+  return slot.entity?.[name];
+}
+
+// src/useOIMBucketSlots.ts
+import { useMemo as useMemo6 } from "react";
+function useOIMBucketSlots(bucketCollectionService, bucketSlot) {
+  const db = useOIMDB();
+  const binding = useMemo6(() => {
+    oimAssertOneChannel(db, bucketSlot, "useOIMBucketSlots");
+    return { sourceSlots: [bucketSlot], derive: () => bucketSlot };
+  }, [db, bucketSlot]);
+  const { changedAtRevision, changedAtEpoch } = useOIMValue(binding);
+  return useMemo6(
+    () => Array.from(bucketCollectionService.slotContentService.getBucketMemberSlots(bucketSlot)),
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- the bucket slot's change stamp moves exactly when its members do
+    [bucketCollectionService, bucketSlot, changedAtRevision, changedAtEpoch]
+  );
+}
+
+// src/useOIMBucketSlotsByKey.ts
+function useOIMBucketSlotsByKey(bucketCollectionService, bucketStoreSlot, key) {
+  const bucketSlot = useOIMSlotByKey("useOIMBucketSlotsByKey", bucketCollectionService, bucketStoreSlot, key);
+  return Array.from(bucketCollectionService.slotContentService.getBucketMemberSlots(bucketSlot));
 }
-var useSelectEntitiesByPks = (reactiveCollection, pks) => {
-  const prevPksRef = useRef2();
-  const pksAreEqual = arraysEqual(prevPksRef.current || EMPTY_ARRAY, pks);
-  if (!pksAreEqual) {
-    prevPksRef.current = pks;
+
+// src/useOIMSlotsByKeys.ts
+import { useEffect, useRef as useRef2, useState } from "react";
+import { oimSameKeySequence } from "@oimdb/core";
+function useOIMSlotsByKeys(slotCollectionService, storeSlot, keys) {
+  const settledKeys = useRef2(keys);
+  const previousKeys = settledKeys.current;
+  if (!oimSameKeySequence(previousKeys, keys)) settledKeys.current = keys;
+  const keysToHold = settledKeys.current;
+  const [, resolveAgain] = useState(0);
+  const resolvedSlots = useRef2(void 0);
+  const resolvedKeys = useRef2(keysToHold);
+  const resolvedSlotCollectionService = useRef2(slotCollectionService);
+  const resolvedStoreSlot = useRef2(storeSlot);
+  if (resolvedSlots.current === void 0 || resolvedKeys.current !== keysToHold || resolvedSlotCollectionService.current !== slotCollectionService || resolvedStoreSlot.current !== storeSlot) {
+    const slots2 = [];
+    for (let i = 0; i < keysToHold.length; i++) {
+      slots2.push(slotCollectionService.getSlotByKey(storeSlot, keysToHold[i]));
+    }
+    resolvedSlots.current = slots2;
+    resolvedKeys.current = keysToHold;
+    resolvedSlotCollectionService.current = slotCollectionService;
+    resolvedStoreSlot.current = storeSlot;
   }
-  const stablePks = pksAreEqual ? prevPksRef.current ?? pks : pks;
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotRef.current = stablePks.map(
-      (pk) => reactiveCollection.getOneByPk(pk)
-    );
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotRef.current = stablePks.map(
-          (pk) => reactiveCollection.getOneByPk(pk)
-        );
-        onStoreChange();
-      };
-      const unsubscribe = reactiveCollection.subscribeOnKeys(
-        stablePks,
-        updateSnapshot
-      );
-      return () => {
-        unsubscribe();
-      };
-    };
-  }, [reactiveCollection, stablePks]);
-  const getSnapshot = useMemo2(() => {
+  const slots = resolvedSlots.current;
+  useEffect(() => {
+    const renderedSlots = resolvedSlots.current;
+    const heldSlots = [];
+    let someKeyNamesAnotherIdentityNow = false;
+    for (let i = 0; i < keysToHold.length; i++) {
+      const slot = slotCollectionService.holdSlotByKey(storeSlot, keysToHold[i]);
+      heldSlots.push(slot);
+      if (slot !== renderedSlots?.[i]) someKeyNamesAnotherIdentityNow = true;
+    }
+    if (someKeyNamesAnotherIdentityNow) {
+      resolvedSlots.current = void 0;
+      resolveAgain((version) => version + 1);
+    }
     return () => {
-      return snapshotRef.current;
-    };
-  }, []);
-  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-  return snapshot;
-};
-var useSelectEntitiesByIndexKeySetBased = (reactiveCollection, reactiveIndex, key) => {
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    const readSnapshot = () => Array.from(
-      reactiveIndex.getPksByKey(key),
-      (pk) => reactiveCollection.getOneByPk(pk)
-    );
-    const readPks = () => Array.from(reactiveIndex.getPksByKey(key));
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(readPks(), () => {
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribeOnKey(key, () => {
-        resubscribeCollection();
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [key, reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByIndexKeysSetBased = (reactiveCollection, reactiveIndex, keys) => {
-  const prevKeysRef = useRef2();
-  const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
-  if (!keysAreEqual) {
-    prevKeysRef.current = keys;
-  }
-  const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    const readPks = () => stableKeys.flatMap(
-      (key) => Array.from(reactiveIndex.getPksByKey(key))
-    );
-    const readSnapshot = () => readPks().map((pk) => reactiveCollection.getOneByPk(pk));
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(readPks(), () => {
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribeOnKeys(
-        stableKeys,
-        () => {
-          resubscribeCollection();
-          snapshotRef.current = readSnapshot();
-          onStoreChange();
-        }
-      );
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [reactiveCollection, reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByIndexKeyArrayBased = (reactiveCollection, reactiveIndex, key) => {
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    const readSnapshot = () => reactiveIndex.getPksByKey(key).map((pk) => reactiveCollection.getOneByPk(pk));
-    const readPks = () => reactiveIndex.getPksByKey(key);
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(readPks(), () => {
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribeOnKey(key, () => {
-        resubscribeCollection();
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [key, reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByIndexKeysArrayBased = (reactiveCollection, reactiveIndex, keys) => {
-  const prevKeysRef = useRef2();
-  const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
-  if (!keysAreEqual) {
-    prevKeysRef.current = keys;
-  }
-  const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    const readPks = () => stableKeys.flatMap((key) => reactiveIndex.getPksByKey(key));
-    const readSnapshot = () => readPks().map((pk) => reactiveCollection.getOneByPk(pk));
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(readPks(), () => {
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribeOnKeys(
-        stableKeys,
-        () => {
-          resubscribeCollection();
-          snapshotRef.current = readSnapshot();
-          onStoreChange();
-        }
-      );
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
+      for (let i = 0; i < heldSlots.length; i++) {
+        const heldSlot = heldSlots[i];
+        heldSlot.owner.unholdSlot(heldSlot);
+      }
     };
-  }, [reactiveCollection, reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-function useStableKeyPath(key) {
-  const prevRef = useRef2();
-  const equal = prevRef.current !== void 0 && arraysEqual(prevRef.current, key);
-  if (!equal) {
-    prevRef.current = key;
-  }
-  return equal ? prevRef.current : key;
+  }, [slotCollectionService, storeSlot, keysToHold]);
+  return slots;
 }
-var useSelectPksByCompositeIndexKeySetBased = (reactiveIndex, key) => {
-  const stableKey = useStableKeyPath(key);
-  const snapshotValueRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
-        onStoreChange();
-      };
-      return reactiveIndex.subscribeOnKey(stableKey, updateSnapshot);
-    };
-  }, [stableKey, reactiveIndex]);
-  const getSnapshot = useMemo2(() => () => snapshotValueRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectPksByCompositeIndexKeyArrayBased = (reactiveIndex, key) => {
-  const stableKey = useStableKeyPath(key);
-  const snapshotValueRef = useRef2();
-  const subscribe = useMemo2(() => {
-    snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
-    return (onStoreChange) => {
-      const updateSnapshot = () => {
-        snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
-        onStoreChange();
-      };
-      return reactiveIndex.subscribeOnKey(stableKey, updateSnapshot);
-    };
-  }, [stableKey, reactiveIndex]);
-  const getSnapshot = useMemo2(() => () => snapshotValueRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByCompositeIndexKeySetBased = (reactiveCollection, reactiveIndex, key) => {
-  const stableKey = useStableKeyPath(key);
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    const readSnapshot = () => Array.from(
-      reactiveIndex.getPksByKey(stableKey),
-      (pk) => reactiveCollection.getOneByPk(pk)
-    );
-    const readPks = () => Array.from(reactiveIndex.getPksByKey(stableKey));
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(readPks(), () => {
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribeOnKey(
-        stableKey,
-        () => {
-          resubscribeCollection();
-          snapshotRef.current = readSnapshot();
-          onStoreChange();
-        }
-      );
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [stableKey, reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
-var useSelectEntitiesByCompositeIndexKeyArrayBased = (reactiveCollection, reactiveIndex, key) => {
-  const stableKey = useStableKeyPath(key);
-  const snapshotRef = useRef2();
-  const subscribe = useMemo2(() => {
-    const readSnapshot = () => reactiveIndex.getPksByKey(stableKey).map((pk) => reactiveCollection.getOneByPk(pk));
-    const readPks = () => reactiveIndex.getPksByKey(stableKey);
-    snapshotRef.current = readSnapshot();
-    return (onStoreChange) => {
-      let unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(readPks(), () => {
-        snapshotRef.current = readSnapshot();
-        onStoreChange();
-      });
-      const resubscribeCollection = () => {
-        unsubscribeFromCollection();
-        unsubscribeFromCollection = reactiveCollection.subscribeOnKeys(
-          readPks(),
-          () => {
-            snapshotRef.current = readSnapshot();
-            onStoreChange();
-          }
-        );
-      };
-      const unsubscribeFromIndex = reactiveIndex.subscribeOnKey(
-        stableKey,
-        () => {
-          resubscribeCollection();
-          snapshotRef.current = readSnapshot();
-          onStoreChange();
-        }
-      );
-      return () => {
-        unsubscribeFromIndex();
-        unsubscribeFromCollection();
-      };
-    };
-  }, [stableKey, reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
-  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
-};
 
-// src/context/index.tsx
-import { createContext, useContext } from "react";
-import { jsx } from "react/jsx-runtime";
-var OIMCollectionsContext = createContext(
-  {}
-);
-function createOIMCollectionsContext() {
-  return createContext({});
+// src/useOIMComputedValueByKey.ts
+import { OIM_FROZEN_EMPTY_SLOTS as OIM_FROZEN_EMPTY_SLOTS4 } from "@oimdb/core";
+var sourcesOfComputedSlot = (computedSlot) => [OIM_FROZEN_EMPTY_SLOTS4, [computedSlot]];
+function useOIMComputedValueByKey(computedCollectionService, computedStoreSlot, key) {
+  const computedSlot = useOIMSlotByKey(
+    "useOIMComputedValueByKey",
+    computedCollectionService,
+    computedStoreSlot,
+    key,
+    sourcesOfComputedSlot
+  );
+  return computedSlot.computedValueService.getValueForSlot(computedSlot);
 }
-function OIMCollectionsProvider({ collections, children, context }) {
-  const ContextToUse = context || OIMCollectionsContext;
-  return /* @__PURE__ */ jsx(ContextToUse.Provider, { value: collections, children });
+
+// src/useOIMSingleComputedValue.ts
+import { useMemo as useMemo7 } from "react";
+import { OIM_FROZEN_EMPTY_SLOTS as OIM_FROZEN_EMPTY_SLOTS5 } from "@oimdb/core";
+var sourcesOfComputedSlot2 = (computedSlot) => [OIM_FROZEN_EMPTY_SLOTS5, [computedSlot]];
+function useOIMSingleComputedValue(computedService, derive, createSources, dependencyList) {
+  const db = useOIMDB();
+  const computedStoreSlot = useMemo7(
+    () => computedService.createComputedStoreSlot(db, derive, createSources),
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- the caller's list is checked at the call site
+    [db, computedService, ...dependencyList]
+  );
+  const computedSlot = useOIMSingleSlot(
+    "useOIMSingleComputedValue",
+    computedService.computedSingleSlotService,
+    computedStoreSlot,
+    sourcesOfComputedSlot2
+  );
+  return computedSlot.computedValueService.getValueForSlot(computedSlot);
 }
-function useOIMCollectionsContext(context) {
-  const contextToUse = context || OIMCollectionsContext;
-  const collections = useContext(contextToUse);
-  if (!collections || Object.keys(collections).length === 0) {
-    throw new Error(
-      "useOIMCollectionsContext must be used within an OIMCollectionsProvider"
-    );
-  }
-  return collections;
+
+// src/useOIMComputedCollection.ts
+import { useMemo as useMemo8 } from "react";
+function useOIMComputedCollection(computedService, derive, createSources, dependencyList) {
+  const db = useOIMDB();
+  return useMemo8(
+    () => computedService.createComputedStoreSlot(db, derive, createSources),
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- the caller's list is checked at the call site
+    [db, computedService, ...dependencyList]
+  );
 }
 export {
-  OIMCollectionsContext,
-  OIMCollectionsProvider,
-  createOIMCollectionsContext,
-  useOIMCollectionsContext,
-  useSelectEntitiesByCompositeIndexKeyArrayBased,
-  useSelectEntitiesByCompositeIndexKeySetBased,
-  useSelectEntitiesByGlobalIndexArrayBased,
-  useSelectEntitiesByGlobalIndexSetBased,
-  useSelectEntitiesByIndexKeyArrayBased,
-  useSelectEntitiesByIndexKeySetBased,
-  useSelectEntitiesByIndexKeysArrayBased,
-  useSelectEntitiesByIndexKeysSetBased,
-  useSelectEntitiesByPks,
-  useSelectEntityByPk,
-  useSelectEntityByPkSignal,
-  useSelectPksByCompositeIndexKeyArrayBased,
-  useSelectPksByCompositeIndexKeySetBased,
-  useSelectPksByGlobalIndexArrayBased,
-  useSelectPksByGlobalIndexArrayBasedSignal,
-  useSelectPksByGlobalIndexSetBased,
-  useSelectPksByGlobalIndexSetBasedSignal,
-  useSelectPksByIndexKeyArrayBased,
-  useSelectPksByIndexKeyArrayBasedSignal,
-  useSelectPksByIndexKeySetBased,
-  useSelectPksByIndexKeySetBasedSignal,
-  useSelectPksByIndexKeysArrayBased,
-  useSelectPksByIndexKeysSetBased,
-  useSelectValueByObjectKey,
-  useSelectValuesByObjectKeys
+  OIMDBContext,
+  OIMDBProvider,
+  useOIMBucketSlots,
+  useOIMBucketSlotsByKey,
+  useOIMComputedCollection,
+  useOIMComputedValue,
+  useOIMComputedValueByKey,
+  useOIMDB,
+  useOIMEntity,
+  useOIMField,
+  useOIMSingleBucketSlots,
+  useOIMSingleComputedValue,
+  useOIMSingleEntity,
+  useOIMSlotsByKeys,
+  useOIMValue
 };