@oimdb/react 2.1.2 → 2.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 React hooks and context helpers for OIMDB reactive collections, objects, and indexes.
 
-📖 **[Full documentation](https://abaikov.github.io/oimdb/)**
+📖 **[Full documentation](https://oimdb.org/)**
 
 ## For AI Assistants
 
@@ -118,6 +118,13 @@ function TeamUsers({ teamId }: { teamId: string }) {
 - `useSelectEntitiesByIndexKeyArrayBased(collection, index, key)` watches entities referenced by one index key.
 - `useSelectEntitiesByIndexKeysArrayBased(collection, index, keys)` watches entities referenced by several index keys.
 
+### Composite (Key-Path) Indexes
+
+For indexes keyed by a composite **key path** (an array, from `indexFactory.compositeSetIndex()` / `compositeArrayIndex()`). These stabilize the key path **by content**, so passing a freshly built `['p1', 'admin']` on every render does not re-subscribe.
+
+- `useSelectPksByCompositeIndexKeySetBased(index, path)` / `…ArrayBased(index, path)` watch PKs for one key path.
+- `useSelectEntitiesByCompositeIndexKeySetBased(collection, index, path)` / `…ArrayBased(collection, index, path)` watch entities for one key path.
+
 ### Reactive Objects
 
 - `useSelectValueByObjectKey(object, key)` watches one object key.
@@ -153,7 +160,7 @@ const ids = useSelectPksByIndexKeyArrayBasedSignal(cardsByDeck, deckId);
 
 Available signal hooks (same signatures as their default counterparts): `useSelectEntityByPkSignal`, `useSelectPksByIndexKeyArrayBasedSignal`, `useSelectPksByIndexKeySetBasedSignal`. Compose the fine-grained pattern from them: a parent reads pks by index key, each row reads its own entity by pk.
 
-**Use only when every reader is subscription-driven.** Trade-offs: not Concurrent-Mode tearing-safe; the entity reference is stable across changes, so `React.memo` on entities, prev/next diffing, time-travel, and the default uSES hooks on the same collection won't see updates. Select each entity where you render it (by pk); don't pass mutable entities into `React.memo` children. See [Performance](https://abaikov.github.io/oimdb/docs/guides/performance) for when this actually pays off (in plain React the per-component commit usually dominates).
+**Use only when every reader is subscription-driven.** Trade-offs: not Concurrent-Mode tearing-safe; the entity reference is stable across changes, so `React.memo` on entities, prev/next diffing, time-travel, and the default uSES hooks on the same collection won't see updates. Select each entity where you render it (by pk); don't pass mutable entities into `React.memo` children. See [Performance](https://oimdb.org/docs/guides/performance) for when this actually pays off (in plain React the per-component commit usually dominates).
 
 ## Context API
 

package/dist/index.cjs

@@ -24,6 +24,10 @@ __export(index_exports, {
   OIMCollectionsProvider: () => OIMCollectionsProvider,
   createOIMCollectionsContext: () => createOIMCollectionsContext,
   useOIMCollectionsContext: () => useOIMCollectionsContext,
+  useSelectEntitiesByCompositeIndexKeyArrayBased: () => useSelectEntitiesByCompositeIndexKeyArrayBased,
+  useSelectEntitiesByCompositeIndexKeySetBased: () => useSelectEntitiesByCompositeIndexKeySetBased,
+  useSelectEntitiesByGlobalIndexArrayBased: () => useSelectEntitiesByGlobalIndexArrayBased,
+  useSelectEntitiesByGlobalIndexSetBased: () => useSelectEntitiesByGlobalIndexSetBased,
   useSelectEntitiesByIndexKeyArrayBased: () => useSelectEntitiesByIndexKeyArrayBased,
   useSelectEntitiesByIndexKeySetBased: () => useSelectEntitiesByIndexKeySetBased,
   useSelectEntitiesByIndexKeysArrayBased: () => useSelectEntitiesByIndexKeysArrayBased,
@@ -31,6 +35,12 @@ __export(index_exports, {
   useSelectEntitiesByPks: () => useSelectEntitiesByPks,
   useSelectEntityByPk: () => useSelectEntityByPk,
   useSelectEntityByPkSignal: () => useSelectEntityByPkSignal,
+  useSelectPksByCompositeIndexKeyArrayBased: () => useSelectPksByCompositeIndexKeyArrayBased,
+  useSelectPksByCompositeIndexKeySetBased: () => useSelectPksByCompositeIndexKeySetBased,
+  useSelectPksByGlobalIndexArrayBased: () => useSelectPksByGlobalIndexArrayBased,
+  useSelectPksByGlobalIndexArrayBasedSignal: () => useSelectPksByGlobalIndexArrayBasedSignal,
+  useSelectPksByGlobalIndexSetBased: () => useSelectPksByGlobalIndexSetBased,
+  useSelectPksByGlobalIndexSetBasedSignal: () => useSelectPksByGlobalIndexSetBasedSignal,
   useSelectPksByIndexKeyArrayBased: () => useSelectPksByIndexKeyArrayBased,
   useSelectPksByIndexKeyArrayBasedSignal: () => useSelectPksByIndexKeyArrayBasedSignal,
   useSelectPksByIndexKeySetBased: () => useSelectPksByIndexKeySetBased,
@@ -43,14 +53,121 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/hooks/index.ts
-var import_react2 = require("react");
 var import_react3 = require("react");
+var import_react4 = require("react");
 
-// src/hooks/signal.ts
+// src/hooks/global.ts
 var import_react = require("react");
-var useIsomorphicLayoutEffect = typeof window !== "undefined" ? import_react.useLayoutEffect : import_react.useEffect;
+var useSelectPksByGlobalIndexArrayBased = (reactiveIndex) => {
+  const snapshotValueRef = (0, import_react.useRef)();
+  const subscribe = (0, import_react.useMemo)(() => {
+    snapshotValueRef.current = reactiveIndex.getPks();
+    return (onStoreChange) => {
+      return reactiveIndex.subscribe(() => {
+        snapshotValueRef.current = reactiveIndex.getPks();
+        onStoreChange();
+      });
+    };
+  }, [reactiveIndex]);
+  const getSnapshot = (0, import_react.useMemo)(() => () => snapshotValueRef.current, []);
+  return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+var useSelectPksByGlobalIndexSetBased = (reactiveIndex) => {
+  const snapshotValueRef = (0, import_react.useRef)();
+  const subscribe = (0, import_react.useMemo)(() => {
+    snapshotValueRef.current = reactiveIndex.getPks();
+    return (onStoreChange) => {
+      return reactiveIndex.subscribe(() => {
+        snapshotValueRef.current = reactiveIndex.getPks();
+        onStoreChange();
+      });
+    };
+  }, [reactiveIndex]);
+  const getSnapshot = (0, import_react.useMemo)(() => () => snapshotValueRef.current, []);
+  return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+var useSelectEntitiesByGlobalIndexArrayBased = (reactiveCollection, reactiveIndex) => {
+  const snapshotRef = (0, import_react.useRef)();
+  const subscribe = (0, import_react.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 = (0, import_react.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+var useSelectEntitiesByGlobalIndexSetBased = (reactiveCollection, reactiveIndex) => {
+  const snapshotRef = (0, import_react.useRef)();
+  const subscribe = (0, import_react.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 = (0, import_react.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+
+// src/hooks/signal.ts
+var import_react2 = require("react");
+var useIsomorphicLayoutEffect = typeof window !== "undefined" ? import_react2.useLayoutEffect : import_react2.useEffect;
 function useForceUpdate() {
-  const [, force] = (0, import_react.useReducer)((c) => c + 1 | 0, 0);
+  const [, force] = (0, import_react2.useReducer)((c) => c + 1 | 0, 0);
   return force;
 }
 var useSelectEntityByPkSignal = (reactiveCollection, pk) => {
@@ -77,18 +194,34 @@ var useSelectPksByIndexKeySetBasedSignal = (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 = (0, import_react2.useRef)();
+  const prevKeysRef = (0, import_react3.useRef)();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotValueRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotValueRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     snapshotValueRef.current = stableKeys.map((key) => Array.from(reactiveIndex.getPksByKey(key))).flat();
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -104,17 +237,17 @@ var useSelectPksByIndexKeysSetBased = (reactiveIndex, keys) => {
       };
     };
   }, [reactiveIndex, stableKeys]);
-  const getSnapshot = (0, import_react2.useMemo)(() => {
+  const getSnapshot = (0, import_react3.useMemo)(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectPksByIndexKeySetBased = (reactiveIndex, key) => {
-  const snapshotValueRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotValueRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     snapshotValueRef.current = reactiveIndex.getPksByKey(key);
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -124,23 +257,23 @@ var useSelectPksByIndexKeySetBased = (reactiveIndex, key) => {
       return reactiveIndex.subscribeOnKey(key, updateSnapshot);
     };
   }, [key, reactiveIndex]);
-  const getSnapshot = (0, import_react2.useMemo)(() => {
+  const getSnapshot = (0, import_react3.useMemo)(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectPksByIndexKeysArrayBased = (reactiveIndex, keys) => {
-  const prevKeysRef = (0, import_react2.useRef)();
+  const prevKeysRef = (0, import_react3.useRef)();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotValueRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotValueRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     snapshotValueRef.current = stableKeys.map((key) => reactiveIndex.getPksByKey(key)).flat();
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -156,22 +289,22 @@ var useSelectPksByIndexKeysArrayBased = (reactiveIndex, keys) => {
       };
     };
   }, [reactiveIndex, stableKeys]);
-  const getSnapshot = (0, import_react2.useMemo)(() => {
+  const getSnapshot = (0, import_react3.useMemo)(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectPksByIndexKeyArrayBased = (reactiveIndex, key) => {
-  const prevKeyRef = (0, import_react2.useRef)();
+  const prevKeyRef = (0, import_react3.useRef)();
   const keyAreEqual = prevKeyRef.current === key;
   if (!keyAreEqual) {
     prevKeyRef.current = key;
   }
-  const snapshotValueRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotValueRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     snapshotValueRef.current = reactiveIndex.getPksByKey(key);
     return (onStoreChange) => {
       const prevKey = prevKeyRef.current;
@@ -192,49 +325,49 @@ var useSelectPksByIndexKeyArrayBased = (reactiveIndex, key) => {
       };
     };
   }, [key, reactiveIndex]);
-  const getSnapshot = (0, import_react2.useMemo)(() => {
+  const getSnapshot = (0, import_react3.useMemo)(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectEntityByPk = (reactiveCollection, pk) => {
-  const getSnapshot = (0, import_react2.useMemo)(
+  const getSnapshot = (0, import_react3.useMemo)(
     () => () => reactiveCollection.getOneByPk(pk),
     [pk, reactiveCollection]
   );
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const subscribe = (0, import_react3.useMemo)(() => {
     return (onStoreChange) => {
       return reactiveCollection.subscribeOnKey(pk, onStoreChange);
     };
   }, [pk, reactiveCollection]);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectValueByObjectKey = (reactiveObject, key) => {
-  const getSnapshot = (0, import_react2.useMemo)(
+  const getSnapshot = (0, import_react3.useMemo)(
     () => () => reactiveObject.get(key),
     [key, reactiveObject]
   );
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const subscribe = (0, import_react3.useMemo)(() => {
     return (onStoreChange) => {
       return reactiveObject.subscribeOnKey(key, onStoreChange);
     };
   }, [key, reactiveObject]);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectValuesByObjectKeys = (reactiveObject, keys) => {
-  const prevKeysRef = (0, import_react2.useRef)();
+  const prevKeysRef = (0, import_react3.useRef)();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     snapshotRef.current = stableKeys.map((key) => reactiveObject.get(key));
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -252,12 +385,12 @@ var useSelectValuesByObjectKeys = (reactiveObject, keys) => {
       };
     };
   }, [reactiveObject, stableKeys]);
-  const getSnapshot = (0, import_react2.useMemo)(() => {
+  const getSnapshot = (0, import_react3.useMemo)(() => {
     return () => {
       return snapshotRef.current;
     };
   }, []);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 function arraysEqual(a, b) {
@@ -269,14 +402,14 @@ function arraysEqual(a, b) {
   return true;
 }
 var useSelectEntitiesByPks = (reactiveCollection, pks) => {
-  const prevPksRef = (0, import_react2.useRef)();
+  const prevPksRef = (0, import_react3.useRef)();
   const pksAreEqual = arraysEqual(prevPksRef.current || EMPTY_ARRAY, pks);
   if (!pksAreEqual) {
     prevPksRef.current = pks;
   }
   const stablePks = pksAreEqual ? prevPksRef.current ?? pks : pks;
-  const snapshotRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     snapshotRef.current = stablePks.map(
       (pk) => reactiveCollection.getOneByPk(pk)
     );
@@ -296,17 +429,17 @@ var useSelectEntitiesByPks = (reactiveCollection, pks) => {
       };
     };
   }, [reactiveCollection, stablePks]);
-  const getSnapshot = (0, import_react2.useMemo)(() => {
+  const getSnapshot = (0, import_react3.useMemo)(() => {
     return () => {
       return snapshotRef.current;
     };
   }, []);
-  const snapshot = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const snapshot = (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectEntitiesByIndexKeySetBased = (reactiveCollection, reactiveIndex, key) => {
-  const snapshotRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     const readSnapshot = () => Array.from(
       reactiveIndex.getPksByKey(key),
       (pk) => reactiveCollection.getOneByPk(pk)
@@ -339,18 +472,18 @@ var useSelectEntitiesByIndexKeySetBased = (reactiveCollection, reactiveIndex, ke
       };
     };
   }, [key, reactiveCollection, reactiveIndex]);
-  const getSnapshot = (0, import_react2.useMemo)(() => () => snapshotRef.current, []);
-  return (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = (0, import_react3.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
 };
 var useSelectEntitiesByIndexKeysSetBased = (reactiveCollection, reactiveIndex, keys) => {
-  const prevKeysRef = (0, import_react2.useRef)();
+  const prevKeysRef = (0, import_react3.useRef)();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     const readPks = () => stableKeys.flatMap(
       (key) => Array.from(reactiveIndex.getPksByKey(key))
     );
@@ -385,12 +518,12 @@ var useSelectEntitiesByIndexKeysSetBased = (reactiveCollection, reactiveIndex, k
       };
     };
   }, [reactiveCollection, reactiveIndex, stableKeys]);
-  const getSnapshot = (0, import_react2.useMemo)(() => () => snapshotRef.current, []);
-  return (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = (0, import_react3.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
 };
 var useSelectEntitiesByIndexKeyArrayBased = (reactiveCollection, reactiveIndex, key) => {
-  const snapshotRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     const readSnapshot = () => reactiveIndex.getPksByKey(key).map((pk) => reactiveCollection.getOneByPk(pk));
     const readPks = () => reactiveIndex.getPksByKey(key);
     snapshotRef.current = readSnapshot();
@@ -420,18 +553,18 @@ var useSelectEntitiesByIndexKeyArrayBased = (reactiveCollection, reactiveIndex,
       };
     };
   }, [key, reactiveCollection, reactiveIndex]);
-  const getSnapshot = (0, import_react2.useMemo)(() => () => snapshotRef.current, []);
-  return (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = (0, import_react3.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
 };
 var useSelectEntitiesByIndexKeysArrayBased = (reactiveCollection, reactiveIndex, keys) => {
-  const prevKeysRef = (0, import_react2.useRef)();
+  const prevKeysRef = (0, import_react3.useRef)();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotRef = (0, import_react2.useRef)();
-  const subscribe = (0, import_react2.useMemo)(() => {
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
     const readPks = () => stableKeys.flatMap((key) => reactiveIndex.getPksByKey(key));
     const readSnapshot = () => readPks().map((pk) => reactiveCollection.getOneByPk(pk));
     snapshotRef.current = readSnapshot();
@@ -464,18 +597,139 @@ var useSelectEntitiesByIndexKeysArrayBased = (reactiveCollection, reactiveIndex,
       };
     };
   }, [reactiveCollection, reactiveIndex, stableKeys]);
-  const getSnapshot = (0, import_react2.useMemo)(() => () => snapshotRef.current, []);
-  return (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = (0, import_react3.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+function useStableKeyPath(key) {
+  const prevRef = (0, import_react3.useRef)();
+  const equal = prevRef.current !== void 0 && arraysEqual(prevRef.current, key);
+  if (!equal) {
+    prevRef.current = key;
+  }
+  return equal ? prevRef.current : key;
+}
+var useSelectPksByCompositeIndexKeySetBased = (reactiveIndex, key) => {
+  const stableKey = useStableKeyPath(key);
+  const snapshotValueRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
+    snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
+    return (onStoreChange) => {
+      const updateSnapshot = () => {
+        snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
+        onStoreChange();
+      };
+      return reactiveIndex.subscribeOnKey(stableKey, updateSnapshot);
+    };
+  }, [stableKey, reactiveIndex]);
+  const getSnapshot = (0, import_react3.useMemo)(() => () => snapshotValueRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+var useSelectPksByCompositeIndexKeyArrayBased = (reactiveIndex, key) => {
+  const stableKey = useStableKeyPath(key);
+  const snapshotValueRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
+    snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
+    return (onStoreChange) => {
+      const updateSnapshot = () => {
+        snapshotValueRef.current = reactiveIndex.getPksByKey(stableKey);
+        onStoreChange();
+      };
+      return reactiveIndex.subscribeOnKey(stableKey, updateSnapshot);
+    };
+  }, [stableKey, reactiveIndex]);
+  const getSnapshot = (0, import_react3.useMemo)(() => () => snapshotValueRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+var useSelectEntitiesByCompositeIndexKeySetBased = (reactiveCollection, reactiveIndex, key) => {
+  const stableKey = useStableKeyPath(key);
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
+    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 = (0, import_react3.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+};
+var useSelectEntitiesByCompositeIndexKeyArrayBased = (reactiveCollection, reactiveIndex, key) => {
+  const stableKey = useStableKeyPath(key);
+  const snapshotRef = (0, import_react3.useRef)();
+  const subscribe = (0, import_react3.useMemo)(() => {
+    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 = (0, import_react3.useMemo)(() => () => snapshotRef.current, []);
+  return (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
 };
 
 // src/context/index.tsx
-var import_react4 = require("react");
+var import_react5 = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
-var OIMCollectionsContext = (0, import_react4.createContext)(
+var OIMCollectionsContext = (0, import_react5.createContext)(
   {}
 );
 function createOIMCollectionsContext() {
-  return (0, import_react4.createContext)({});
+  return (0, import_react5.createContext)({});
 }
 function OIMCollectionsProvider({ collections, children, context }) {
   const ContextToUse = context || OIMCollectionsContext;
@@ -483,7 +737,7 @@ function OIMCollectionsProvider({ collections, children, context }) {
 }
 function useOIMCollectionsContext(context) {
   const contextToUse = context || OIMCollectionsContext;
-  const collections = (0, import_react4.useContext)(contextToUse);
+  const collections = (0, import_react5.useContext)(contextToUse);
   if (!collections || Object.keys(collections).length === 0) {
     throw new Error(
       "useOIMCollectionsContext must be used within an OIMCollectionsProvider"
@@ -497,6 +751,10 @@ function useOIMCollectionsContext(context) {
   OIMCollectionsProvider,
   createOIMCollectionsContext,
   useOIMCollectionsContext,
+  useSelectEntitiesByCompositeIndexKeyArrayBased,
+  useSelectEntitiesByCompositeIndexKeySetBased,
+  useSelectEntitiesByGlobalIndexArrayBased,
+  useSelectEntitiesByGlobalIndexSetBased,
   useSelectEntitiesByIndexKeyArrayBased,
   useSelectEntitiesByIndexKeySetBased,
   useSelectEntitiesByIndexKeysArrayBased,
@@ -504,6 +762,12 @@ function useOIMCollectionsContext(context) {
   useSelectEntitiesByPks,
   useSelectEntityByPk,
   useSelectEntityByPkSignal,
+  useSelectPksByCompositeIndexKeyArrayBased,
+  useSelectPksByCompositeIndexKeySetBased,
+  useSelectPksByGlobalIndexArrayBased,
+  useSelectPksByGlobalIndexArrayBasedSignal,
+  useSelectPksByGlobalIndexSetBased,
+  useSelectPksByGlobalIndexSetBasedSignal,
   useSelectPksByIndexKeyArrayBased,
   useSelectPksByIndexKeyArrayBasedSignal,
   useSelectPksByIndexKeySetBased,

package/dist/index.d.cts

@@ -1,11 +1,22 @@
-import { TOIMPk, OIMReactiveCollection, OIMIndexArrayBased, OIMReactiveIndexArrayBased, OIMIndexSetBased, OIMReactiveIndexSetBased, OIMReactiveObject } from '@oimdb/core';
+import { TOIMPk, OIMGlobalIndexArrayBased, OIMReactiveGlobalIndexArrayBased, OIMGlobalIndexSetBased, OIMReactiveGlobalIndexSetBased, OIMReactiveCollection, OIMIndexArrayBased, OIMReactiveIndexArrayBased, OIMIndexSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, TOIMKeyPath } from '@oimdb/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { ReactNode } from 'react';
 
+/**
+ * Hooks for keyless "Global" (whole-collection / "all") indexes. Same shape as
+ * the keyed `…ByIndexKey…` hooks, minus the `key` argument.
+ */
+declare const useSelectPksByGlobalIndexArrayBased: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexArrayBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexArrayBased<TPk, TIndex>) => TPk[] | undefined;
+declare const useSelectPksByGlobalIndexSetBased: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexSetBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexSetBased<TPk, TIndex>) => Set<TPk> | undefined;
+declare const useSelectEntitiesByGlobalIndexArrayBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMGlobalIndexArrayBased<TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveGlobalIndexArrayBased<TPk, TIndex>) => readonly (TEntity | undefined)[] | undefined;
+declare const useSelectEntitiesByGlobalIndexSetBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMGlobalIndexSetBased<TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveGlobalIndexSetBased<TPk, TIndex>) => readonly (TEntity | undefined)[] | undefined;
+
 declare const useSelectEntityByPkSignal: <TEntity extends object, TPk extends TOIMPk>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, pk: TPk) => TEntity | undefined;
 declare const useSelectPksByIndexKeyArrayBasedSignal: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexArrayBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexArrayBased<TKey, TPk, TIndex>, key: TKey) => readonly TPk[];
 declare const useSelectPksByIndexKeySetBasedSignal: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, key: TKey) => ReadonlySet<TPk>;
+declare const useSelectPksByGlobalIndexArrayBasedSignal: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexArrayBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexArrayBased<TPk, TIndex>) => readonly TPk[];
+declare const useSelectPksByGlobalIndexSetBasedSignal: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexSetBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexSetBased<TPk, TIndex>) => ReadonlySet<TPk>;
 
 declare const useSelectPksByIndexKeysSetBased: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, keys: readonly TKey[]) => TPk[] | undefined;
 declare const useSelectPksByIndexKeySetBased: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, key: TKey) => Set<TPk> | undefined;
@@ -19,6 +30,10 @@ declare const useSelectEntitiesByIndexKeySetBased: <TEntity extends object, TPk
 declare const useSelectEntitiesByIndexKeysSetBased: <TEntity extends object, TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, keys: readonly TKey[]) => readonly (TEntity | undefined)[] | undefined;
 declare const useSelectEntitiesByIndexKeyArrayBased: <TEntity extends object, TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexArrayBased<TKey, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexArrayBased<TKey, TPk, TIndex>, key: TKey) => readonly (TEntity | undefined)[] | undefined;
 declare const useSelectEntitiesByIndexKeysArrayBased: <TEntity extends object, TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexArrayBased<TKey, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexArrayBased<TKey, TPk, TIndex>, keys: readonly TKey[]) => readonly (TEntity | undefined)[] | undefined;
+declare const useSelectPksByCompositeIndexKeySetBased: <TPk extends TOIMPk, TIndex extends OIMIndexSetBased<TOIMKeyPath, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => Set<TPk> | undefined;
+declare const useSelectPksByCompositeIndexKeyArrayBased: <TPk extends TOIMPk, TIndex extends OIMIndexArrayBased<TOIMKeyPath, TPk>>(reactiveIndex: OIMReactiveIndexArrayBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => TPk[] | undefined;
+declare const useSelectEntitiesByCompositeIndexKeySetBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMIndexSetBased<TOIMKeyPath, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexSetBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => readonly (TEntity | undefined)[] | undefined;
+declare const useSelectEntitiesByCompositeIndexKeyArrayBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMIndexArrayBased<TOIMKeyPath, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexArrayBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => readonly (TEntity | undefined)[] | undefined;
 
 type CollectionsDictionary = Record<string, OIMReactiveCollection<any, any>>;
 type OIMContextValue<T extends CollectionsDictionary = CollectionsDictionary> = T;
@@ -32,4 +47,4 @@ interface OIMCollectionsProviderProps<T extends CollectionsDictionary = Collecti
 declare function OIMCollectionsProvider<T extends CollectionsDictionary = CollectionsDictionary>({ collections, children, context }: OIMCollectionsProviderProps<T>): react_jsx_runtime.JSX.Element;
 declare function useOIMCollectionsContext<T extends CollectionsDictionary = CollectionsDictionary>(context?: React.Context<OIMContextValue<T>>): T;
 
-export { type CollectionsDictionary, OIMCollectionsContext, OIMCollectionsProvider, type OIMCollectionsProviderProps, type OIMContextValue, createOIMCollectionsContext, useOIMCollectionsContext, useSelectEntitiesByIndexKeyArrayBased, useSelectEntitiesByIndexKeySetBased, useSelectEntitiesByIndexKeysArrayBased, useSelectEntitiesByIndexKeysSetBased, useSelectEntitiesByPks, useSelectEntityByPk, useSelectEntityByPkSignal, useSelectPksByIndexKeyArrayBased, useSelectPksByIndexKeyArrayBasedSignal, useSelectPksByIndexKeySetBased, useSelectPksByIndexKeySetBasedSignal, useSelectPksByIndexKeysArrayBased, useSelectPksByIndexKeysSetBased, useSelectValueByObjectKey, useSelectValuesByObjectKeys };
+export { type CollectionsDictionary, OIMCollectionsContext, OIMCollectionsProvider, type OIMCollectionsProviderProps, type OIMContextValue, 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 };

package/dist/index.d.ts

@@ -1,11 +1,22 @@
-import { TOIMPk, OIMReactiveCollection, OIMIndexArrayBased, OIMReactiveIndexArrayBased, OIMIndexSetBased, OIMReactiveIndexSetBased, OIMReactiveObject } from '@oimdb/core';
+import { TOIMPk, OIMGlobalIndexArrayBased, OIMReactiveGlobalIndexArrayBased, OIMGlobalIndexSetBased, OIMReactiveGlobalIndexSetBased, OIMReactiveCollection, OIMIndexArrayBased, OIMReactiveIndexArrayBased, OIMIndexSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, TOIMKeyPath } from '@oimdb/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { ReactNode } from 'react';
 
+/**
+ * Hooks for keyless "Global" (whole-collection / "all") indexes. Same shape as
+ * the keyed `…ByIndexKey…` hooks, minus the `key` argument.
+ */
+declare const useSelectPksByGlobalIndexArrayBased: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexArrayBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexArrayBased<TPk, TIndex>) => TPk[] | undefined;
+declare const useSelectPksByGlobalIndexSetBased: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexSetBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexSetBased<TPk, TIndex>) => Set<TPk> | undefined;
+declare const useSelectEntitiesByGlobalIndexArrayBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMGlobalIndexArrayBased<TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveGlobalIndexArrayBased<TPk, TIndex>) => readonly (TEntity | undefined)[] | undefined;
+declare const useSelectEntitiesByGlobalIndexSetBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMGlobalIndexSetBased<TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveGlobalIndexSetBased<TPk, TIndex>) => readonly (TEntity | undefined)[] | undefined;
+
 declare const useSelectEntityByPkSignal: <TEntity extends object, TPk extends TOIMPk>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, pk: TPk) => TEntity | undefined;
 declare const useSelectPksByIndexKeyArrayBasedSignal: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexArrayBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexArrayBased<TKey, TPk, TIndex>, key: TKey) => readonly TPk[];
 declare const useSelectPksByIndexKeySetBasedSignal: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, key: TKey) => ReadonlySet<TPk>;
+declare const useSelectPksByGlobalIndexArrayBasedSignal: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexArrayBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexArrayBased<TPk, TIndex>) => readonly TPk[];
+declare const useSelectPksByGlobalIndexSetBasedSignal: <TPk extends TOIMPk, TIndex extends OIMGlobalIndexSetBased<TPk>>(reactiveIndex: OIMReactiveGlobalIndexSetBased<TPk, TIndex>) => ReadonlySet<TPk>;
 
 declare const useSelectPksByIndexKeysSetBased: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, keys: readonly TKey[]) => TPk[] | undefined;
 declare const useSelectPksByIndexKeySetBased: <TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, key: TKey) => Set<TPk> | undefined;
@@ -19,6 +30,10 @@ declare const useSelectEntitiesByIndexKeySetBased: <TEntity extends object, TPk
 declare const useSelectEntitiesByIndexKeysSetBased: <TEntity extends object, TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexSetBased<TKey, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexSetBased<TKey, TPk, TIndex>, keys: readonly TKey[]) => readonly (TEntity | undefined)[] | undefined;
 declare const useSelectEntitiesByIndexKeyArrayBased: <TEntity extends object, TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexArrayBased<TKey, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexArrayBased<TKey, TPk, TIndex>, key: TKey) => readonly (TEntity | undefined)[] | undefined;
 declare const useSelectEntitiesByIndexKeysArrayBased: <TEntity extends object, TPk extends TOIMPk, TKey extends TOIMPk, TIndex extends OIMIndexArrayBased<TKey, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexArrayBased<TKey, TPk, TIndex>, keys: readonly TKey[]) => readonly (TEntity | undefined)[] | undefined;
+declare const useSelectPksByCompositeIndexKeySetBased: <TPk extends TOIMPk, TIndex extends OIMIndexSetBased<TOIMKeyPath, TPk>>(reactiveIndex: OIMReactiveIndexSetBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => Set<TPk> | undefined;
+declare const useSelectPksByCompositeIndexKeyArrayBased: <TPk extends TOIMPk, TIndex extends OIMIndexArrayBased<TOIMKeyPath, TPk>>(reactiveIndex: OIMReactiveIndexArrayBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => TPk[] | undefined;
+declare const useSelectEntitiesByCompositeIndexKeySetBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMIndexSetBased<TOIMKeyPath, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexSetBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => readonly (TEntity | undefined)[] | undefined;
+declare const useSelectEntitiesByCompositeIndexKeyArrayBased: <TEntity extends object, TPk extends TOIMPk, TIndex extends OIMIndexArrayBased<TOIMKeyPath, TPk>>(reactiveCollection: OIMReactiveCollection<TEntity, TPk>, reactiveIndex: OIMReactiveIndexArrayBased<TOIMKeyPath, TPk, TIndex>, key: TOIMKeyPath) => readonly (TEntity | undefined)[] | undefined;
 
 type CollectionsDictionary = Record<string, OIMReactiveCollection<any, any>>;
 type OIMContextValue<T extends CollectionsDictionary = CollectionsDictionary> = T;
@@ -32,4 +47,4 @@ interface OIMCollectionsProviderProps<T extends CollectionsDictionary = Collecti
 declare function OIMCollectionsProvider<T extends CollectionsDictionary = CollectionsDictionary>({ collections, children, context }: OIMCollectionsProviderProps<T>): react_jsx_runtime.JSX.Element;
 declare function useOIMCollectionsContext<T extends CollectionsDictionary = CollectionsDictionary>(context?: React.Context<OIMContextValue<T>>): T;
 
-export { type CollectionsDictionary, OIMCollectionsContext, OIMCollectionsProvider, type OIMCollectionsProviderProps, type OIMContextValue, createOIMCollectionsContext, useOIMCollectionsContext, useSelectEntitiesByIndexKeyArrayBased, useSelectEntitiesByIndexKeySetBased, useSelectEntitiesByIndexKeysArrayBased, useSelectEntitiesByIndexKeysSetBased, useSelectEntitiesByPks, useSelectEntityByPk, useSelectEntityByPkSignal, useSelectPksByIndexKeyArrayBased, useSelectPksByIndexKeyArrayBasedSignal, useSelectPksByIndexKeySetBased, useSelectPksByIndexKeySetBasedSignal, useSelectPksByIndexKeysArrayBased, useSelectPksByIndexKeysSetBased, useSelectValueByObjectKey, useSelectValuesByObjectKeys };
+export { type CollectionsDictionary, OIMCollectionsContext, OIMCollectionsProvider, type OIMCollectionsProviderProps, type OIMContextValue, 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 };

package/dist/index.js

@@ -1,6 +1,113 @@
 // src/hooks/index.ts
-import { useMemo, useRef } from "react";
-import { useSyncExternalStore } from "react";
+import { useMemo as useMemo2, useRef as useRef2 } from "react";
+import { useSyncExternalStore as useSyncExternalStore2 } from "react";
+
+// 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/hooks/signal.ts
 import { useEffect, useLayoutEffect, useReducer } from "react";
@@ -33,18 +140,34 @@ var useSelectPksByIndexKeySetBasedSignal = (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 = useRef();
+  const prevKeysRef = useRef2();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotValueRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotValueRef = useRef2();
+  const subscribe = useMemo2(() => {
     snapshotValueRef.current = stableKeys.map((key) => Array.from(reactiveIndex.getPksByKey(key))).flat();
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -60,17 +183,17 @@ var useSelectPksByIndexKeysSetBased = (reactiveIndex, keys) => {
       };
     };
   }, [reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo(() => {
+  const getSnapshot = useMemo2(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectPksByIndexKeySetBased = (reactiveIndex, key) => {
-  const snapshotValueRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotValueRef = useRef2();
+  const subscribe = useMemo2(() => {
     snapshotValueRef.current = reactiveIndex.getPksByKey(key);
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -80,23 +203,23 @@ var useSelectPksByIndexKeySetBased = (reactiveIndex, key) => {
       return reactiveIndex.subscribeOnKey(key, updateSnapshot);
     };
   }, [key, reactiveIndex]);
-  const getSnapshot = useMemo(() => {
+  const getSnapshot = useMemo2(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectPksByIndexKeysArrayBased = (reactiveIndex, keys) => {
-  const prevKeysRef = useRef();
+  const prevKeysRef = useRef2();
   const keysAreEqual = arraysEqual(prevKeysRef.current || EMPTY_ARRAY, keys);
   if (!keysAreEqual) {
     prevKeysRef.current = keys;
   }
   const stableKeys = keysAreEqual ? prevKeysRef.current ?? keys : keys;
-  const snapshotValueRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotValueRef = useRef2();
+  const subscribe = useMemo2(() => {
     snapshotValueRef.current = stableKeys.map((key) => reactiveIndex.getPksByKey(key)).flat();
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -112,22 +235,22 @@ var useSelectPksByIndexKeysArrayBased = (reactiveIndex, keys) => {
       };
     };
   }, [reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo(() => {
+  const getSnapshot = useMemo2(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectPksByIndexKeyArrayBased = (reactiveIndex, key) => {
-  const prevKeyRef = useRef();
+  const prevKeyRef = useRef2();
   const keyAreEqual = prevKeyRef.current === key;
   if (!keyAreEqual) {
     prevKeyRef.current = key;
   }
-  const snapshotValueRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotValueRef = useRef2();
+  const subscribe = useMemo2(() => {
     snapshotValueRef.current = reactiveIndex.getPksByKey(key);
     return (onStoreChange) => {
       const prevKey = prevKeyRef.current;
@@ -148,49 +271,49 @@ var useSelectPksByIndexKeyArrayBased = (reactiveIndex, key) => {
       };
     };
   }, [key, reactiveIndex]);
-  const getSnapshot = useMemo(() => {
+  const getSnapshot = useMemo2(() => {
     return () => {
       return snapshotValueRef.current;
     };
   }, []);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectEntityByPk = (reactiveCollection, pk) => {
-  const getSnapshot = useMemo(
+  const getSnapshot = useMemo2(
     () => () => reactiveCollection.getOneByPk(pk),
     [pk, reactiveCollection]
   );
-  const subscribe = useMemo(() => {
+  const subscribe = useMemo2(() => {
     return (onStoreChange) => {
       return reactiveCollection.subscribeOnKey(pk, onStoreChange);
     };
   }, [pk, reactiveCollection]);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectValueByObjectKey = (reactiveObject, key) => {
-  const getSnapshot = useMemo(
+  const getSnapshot = useMemo2(
     () => () => reactiveObject.get(key),
     [key, reactiveObject]
   );
-  const subscribe = useMemo(() => {
+  const subscribe = useMemo2(() => {
     return (onStoreChange) => {
       return reactiveObject.subscribeOnKey(key, onStoreChange);
     };
   }, [key, reactiveObject]);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectValuesByObjectKeys = (reactiveObject, keys) => {
-  const prevKeysRef = useRef();
+  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 = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotRef = useRef2();
+  const subscribe = useMemo2(() => {
     snapshotRef.current = stableKeys.map((key) => reactiveObject.get(key));
     return (onStoreChange) => {
       const updateSnapshot = () => {
@@ -208,12 +331,12 @@ var useSelectValuesByObjectKeys = (reactiveObject, keys) => {
       };
     };
   }, [reactiveObject, stableKeys]);
-  const getSnapshot = useMemo(() => {
+  const getSnapshot = useMemo2(() => {
     return () => {
       return snapshotRef.current;
     };
   }, []);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 function arraysEqual(a, b) {
@@ -225,14 +348,14 @@ function arraysEqual(a, b) {
   return true;
 }
 var useSelectEntitiesByPks = (reactiveCollection, pks) => {
-  const prevPksRef = useRef();
+  const prevPksRef = useRef2();
   const pksAreEqual = arraysEqual(prevPksRef.current || EMPTY_ARRAY, pks);
   if (!pksAreEqual) {
     prevPksRef.current = pks;
   }
   const stablePks = pksAreEqual ? prevPksRef.current ?? pks : pks;
-  const snapshotRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotRef = useRef2();
+  const subscribe = useMemo2(() => {
     snapshotRef.current = stablePks.map(
       (pk) => reactiveCollection.getOneByPk(pk)
     );
@@ -252,17 +375,17 @@ var useSelectEntitiesByPks = (reactiveCollection, pks) => {
       };
     };
   }, [reactiveCollection, stablePks]);
-  const getSnapshot = useMemo(() => {
+  const getSnapshot = useMemo2(() => {
     return () => {
       return snapshotRef.current;
     };
   }, []);
-  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const snapshot = useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
   return snapshot;
 };
 var useSelectEntitiesByIndexKeySetBased = (reactiveCollection, reactiveIndex, key) => {
-  const snapshotRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotRef = useRef2();
+  const subscribe = useMemo2(() => {
     const readSnapshot = () => Array.from(
       reactiveIndex.getPksByKey(key),
       (pk) => reactiveCollection.getOneByPk(pk)
@@ -295,18 +418,18 @@ var useSelectEntitiesByIndexKeySetBased = (reactiveCollection, reactiveIndex, ke
       };
     };
   }, [key, reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo(() => () => snapshotRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
+  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
 };
 var useSelectEntitiesByIndexKeysSetBased = (reactiveCollection, reactiveIndex, keys) => {
-  const prevKeysRef = useRef();
+  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 = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotRef = useRef2();
+  const subscribe = useMemo2(() => {
     const readPks = () => stableKeys.flatMap(
       (key) => Array.from(reactiveIndex.getPksByKey(key))
     );
@@ -341,12 +464,12 @@ var useSelectEntitiesByIndexKeysSetBased = (reactiveCollection, reactiveIndex, k
       };
     };
   }, [reactiveCollection, reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo(() => () => snapshotRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
+  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
 };
 var useSelectEntitiesByIndexKeyArrayBased = (reactiveCollection, reactiveIndex, key) => {
-  const snapshotRef = useRef();
-  const subscribe = useMemo(() => {
+  const snapshotRef = useRef2();
+  const subscribe = useMemo2(() => {
     const readSnapshot = () => reactiveIndex.getPksByKey(key).map((pk) => reactiveCollection.getOneByPk(pk));
     const readPks = () => reactiveIndex.getPksByKey(key);
     snapshotRef.current = readSnapshot();
@@ -376,18 +499,18 @@ var useSelectEntitiesByIndexKeyArrayBased = (reactiveCollection, reactiveIndex,
       };
     };
   }, [key, reactiveCollection, reactiveIndex]);
-  const getSnapshot = useMemo(() => () => snapshotRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const getSnapshot = useMemo2(() => () => snapshotRef.current, []);
+  return useSyncExternalStore2(subscribe, getSnapshot, getSnapshot);
 };
 var useSelectEntitiesByIndexKeysArrayBased = (reactiveCollection, reactiveIndex, keys) => {
-  const prevKeysRef = useRef();
+  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 = useRef();
-  const subscribe = useMemo(() => {
+  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();
@@ -420,8 +543,129 @@ var useSelectEntitiesByIndexKeysArrayBased = (reactiveCollection, reactiveIndex,
       };
     };
   }, [reactiveCollection, reactiveIndex, stableKeys]);
-  const getSnapshot = useMemo(() => () => snapshotRef.current, []);
-  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  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;
+}
+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
@@ -452,6 +696,10 @@ export {
   OIMCollectionsProvider,
   createOIMCollectionsContext,
   useOIMCollectionsContext,
+  useSelectEntitiesByCompositeIndexKeyArrayBased,
+  useSelectEntitiesByCompositeIndexKeySetBased,
+  useSelectEntitiesByGlobalIndexArrayBased,
+  useSelectEntitiesByGlobalIndexSetBased,
   useSelectEntitiesByIndexKeyArrayBased,
   useSelectEntitiesByIndexKeySetBased,
   useSelectEntitiesByIndexKeysArrayBased,
@@ -459,6 +707,12 @@ export {
   useSelectEntitiesByPks,
   useSelectEntityByPk,
   useSelectEntityByPkSignal,
+  useSelectPksByCompositeIndexKeyArrayBased,
+  useSelectPksByCompositeIndexKeySetBased,
+  useSelectPksByGlobalIndexArrayBased,
+  useSelectPksByGlobalIndexArrayBasedSignal,
+  useSelectPksByGlobalIndexSetBased,
+  useSelectPksByGlobalIndexSetBasedSignal,
   useSelectPksByIndexKeyArrayBased,
   useSelectPksByIndexKeyArrayBasedSignal,
   useSelectPksByIndexKeySetBased,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimdb/react",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "React integration for OIMDB - Hooks for selection and subscription with external storage",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -36,7 +36,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@oimdb/core": "^2.0.0 || ^3.0.0",
+    "@oimdb/core": "^3.8.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {