@oimdb/core 3.6.0 → 3.7.0

package/dist/index.cjs

@@ -71,6 +71,7 @@ __export(index_exports, {
   OIMGlobalIndexManualArrayBased: () => OIMGlobalIndexManualArrayBased,
   OIMGlobalIndexManualSetBased: () => OIMGlobalIndexManualSetBased,
   OIMGlobalIndexSetBased: () => OIMGlobalIndexSetBased,
+  OIMGlobalIndexSlotMap: () => OIMGlobalIndexSlotMap,
   OIMIndex: () => OIMIndex,
   OIMIndexArrayBased: () => OIMIndexArrayBased,
   OIMIndexComparatorFactory: () => OIMIndexComparatorFactory,
@@ -120,6 +121,7 @@ __export(index_exports, {
   createMergeEntityUpdater: () => createMergeEntityUpdater,
   createOIMCollectionIndexFactory: () => createOIMCollectionIndexFactory,
   createOIMCollectionKit: () => createOIMCollectionKit,
+  createOIMGlobalIndexSlotMap: () => createOIMGlobalIndexSlotMap,
   createOIMIndexSlotMap: () => createOIMIndexSlotMap,
   createOIMOrderedListCommandStreamDiffDriven: () => createOIMOrderedListCommandStreamDiffDriven,
   createOIMOrderedListMappedCommandStream: () => createOIMOrderedListMappedCommandStream,
@@ -4726,6 +4728,56 @@ function createOIMIndexSlotMap(index, create) {
   return new OIMIndexSlotMap(index, create);
 }
 
+// src/modules/wrapper/index/OIMGlobalIndexSlotMap.ts
+var OIMGlobalIndexSlotMap = class _OIMGlobalIndexSlotMap {
+  constructor(index, create) {
+    this.cache = /* @__PURE__ */ new WeakMap();
+    this.index = index;
+    this.create = create;
+  }
+  /** The mapped object for a slot, created once and cached by slot identity. */
+  get(slot) {
+    let mapped = this.cache.get(slot);
+    if (mapped === void 0 && !this.cache.has(slot)) {
+      mapped = this.create(slot);
+      this.cache.set(slot, mapped);
+    }
+    return mapped;
+  }
+  /**
+   * Mapped objects for every slot in the index, with stable references. For a
+   * set-based global index the order is unspecified (as the set is); for an
+   * array-based one it follows the index order.
+   */
+  getAll() {
+    const result = [];
+    for (const slot of this.index.getSlots()) {
+      result.push(this.get(slot));
+    }
+    return result;
+  }
+  /**
+   * Chain another projection. `map(f)` returns a slot map over the SAME index
+   * whose objects are `f(this.get(slot))`, cached by slot identity — both
+   * levels hand back stable references and each `create` runs once per slot.
+   */
+  map(create) {
+    return new _OIMGlobalIndexSlotMap(
+      this.index,
+      (slot) => create(this.get(slot))
+    );
+  }
+  /** Subscribe to the index's changes — passthrough to the index. */
+  subscribe(handler) {
+    return this.index.subscribe(handler);
+  }
+};
+
+// src/modules/wrapper/index/createOIMGlobalIndexSlotMap.ts
+function createOIMGlobalIndexSlotMap(index, create) {
+  return new OIMGlobalIndexSlotMap(index, create);
+}
+
 // src/modules/wrapper/index/diffOrderedListByPk.ts
 function diffOrderedListByPk(prev, next) {
   const commands = [];
@@ -5523,6 +5575,7 @@ var OIMIndexPksByKeysArrayBasedSelector = class extends OIMSelector {
   OIMGlobalIndexManualArrayBased,
   OIMGlobalIndexManualSetBased,
   OIMGlobalIndexSetBased,
+  OIMGlobalIndexSlotMap,
   OIMIndex,
   OIMIndexArrayBased,
   OIMIndexComparatorFactory,
@@ -5572,6 +5625,7 @@ var OIMIndexPksByKeysArrayBasedSelector = class extends OIMSelector {
   createMergeEntityUpdater,
   createOIMCollectionIndexFactory,
   createOIMCollectionKit,
+  createOIMGlobalIndexSlotMap,
   createOIMIndexSlotMap,
   createOIMOrderedListCommandStreamDiffDriven,
   createOIMOrderedListMappedCommandStream,

package/dist/index.d.cts

@@ -1928,9 +1928,9 @@ interface IOIMIndexSlotSource<TKey extends TOIMPk, TPk extends TOIMPk> extends I
  * and shared per pk). The cache is a `WeakMap`, so a mapped object is reclaimed
  * by GC once its slot is dropped and unreferenced — there is no lifecycle
  * callback and none is needed for plain values. If your mapped objects hold
- * resources that need explicit teardown (DOM nodes, subscriptions), use the
- * ordered command stream (`createOIMOrderedListMappedCommandStream`), which has
- * an exact removal signal to drive `destroy`.
+ * resources that need explicit teardown (DOM nodes, subscriptions), drive an
+ * ordered command stream instead — its `remove` / `set` / `reset` commands are
+ * the exact removal signal you tear down on.
  *
  * This is a thin wrapper: it holds no queue and no standing subscription of its
  * own — `subscribeOnKey` is a passthrough to the index.
@@ -1976,6 +1976,76 @@ declare class OIMIndexSlotMap<TKey extends TOIMPk, TPk extends TOIMPk, TMapped>
  */
 declare function createOIMIndexSlotMap<TKey extends TOIMPk, TPk extends TOIMPk, TMapped>(index: IOIMIndexSlotSource<TKey, TPk>, create: (slot: TOIMAnyEntitySlot<TPk>) => TMapped): OIMIndexSlotMap<TKey, TPk, TMapped>;
 
+/**
+ * Minimal read/subscribe surface a keyless (whole-collection) index exposes for
+ * slot mapping: iterate all slots and subscribe to the single bucket's changes.
+ * The keyless counterpart of {@link IOIMIndexSlotSource}.
+ *
+ * Both `OIMReactiveGlobalIndexSetBased` (slots as a `ReadonlySet`) and
+ * `OIMReactiveGlobalIndexArrayBased` (slots as a `readonly` array) satisfy it
+ * structurally — a `Set` and an array are both `Iterable`.
+ */
+interface IOIMGlobalIndexSlotSource<TPk extends TOIMPk> extends IOIMSubscription {
+    getSlots(): Iterable<TOIMAnyEntitySlot<TPk>>;
+}
+
+/**
+ * Stable slot→object memo over a keyless (whole-collection) set/array index —
+ * the keyless counterpart of {@link OIMIndexSlotMap}.
+ *
+ * `create(slot)` runs once per canonical slot; every later read returns the
+ * **same** object reference for the same slot, so a consumer can re-read on each
+ * notification and still hand reference-equal objects to `React.memo` /
+ * `Object.is` diffing, or reuse the same view-model.
+ *
+ * The cache is a `WeakMap` keyed by the slot object, so a mapped object is
+ * reclaimed by GC once its slot is dropped. There is no teardown callback and
+ * none is needed for plain values; if your mapped objects hold resources needing
+ * explicit cleanup, drive an ordered command stream (whose `remove` / `set` /
+ * `reset` commands are the exact removal signal) instead.
+ *
+ * Thin wrapper: no queue, no standing subscription of its own — `subscribe` is a
+ * passthrough to the index.
+ */
+declare class OIMGlobalIndexSlotMap<TPk extends TOIMPk, TMapped> {
+    private readonly index;
+    private readonly create;
+    private readonly cache;
+    constructor(index: IOIMGlobalIndexSlotSource<TPk>, create: (slot: TOIMAnyEntitySlot<TPk>) => TMapped);
+    /** The mapped object for a slot, created once and cached by slot identity. */
+    get(slot: TOIMAnyEntitySlot<TPk>): TMapped;
+    /**
+     * Mapped objects for every slot in the index, with stable references. For a
+     * set-based global index the order is unspecified (as the set is); for an
+     * array-based one it follows the index order.
+     */
+    getAll(): TMapped[];
+    /**
+     * Chain another projection. `map(f)` returns a slot map over the SAME index
+     * whose objects are `f(this.get(slot))`, cached by slot identity — both
+     * levels hand back stable references and each `create` runs once per slot.
+     */
+    map<TNext>(create: (mapped: TMapped) => TNext): OIMGlobalIndexSlotMap<TPk, TNext>;
+    /** Subscribe to the index's changes — passthrough to the index. */
+    subscribe(handler: TOIMEventHandler<void>): () => void;
+}
+
+/**
+ * Map the slots of a keyless (whole-collection) set/array index to stable
+ * per-slot objects — the keyless counterpart of `createOIMIndexSlotMap`.
+ *
+ * ```ts
+ * const everyone = users.indexFactory.derivedSetGlobalIndex();
+ * const rows = createOIMGlobalIndexSlotMap(everyone, (slot) => makeRow(slot.item));
+ *
+ * rows.subscribe(render);
+ * function render() {
+ *   for (const row of rows.getAll()) { /* same instance per slot *\/ }
+ * }
+ * ```
+ */
+declare function createOIMGlobalIndexSlotMap<TPk extends TOIMPk, TMapped>(index: IOIMGlobalIndexSlotSource<TPk>, create: (slot: TOIMAnyEntitySlot<TPk>) => TMapped): OIMGlobalIndexSlotMap<TPk, TMapped>;
+
 /**
  * Options for {@link OIMOrderedListCommandStreamDiffDriven}.
  */
@@ -2462,4 +2532,4 @@ declare class OIMEntitiesByGlobalIndexArrayBasedSelector<TEntity extends object,
     protected areEqual(prev: readonly (TEntity | undefined)[], next: readonly (TEntity | undefined)[]): boolean;
 }
 
-export { EOIMCollectionEventType, EOIMComputedEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMObjectEventType, type IOIMCarrierResolver, type IOIMComputedEventSource, type IOIMEffectDependency, type IOIMEventQueueSchedulerEvents, type IOIMIndexSlotSource, type IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMOrderedListCommandSource, type IOIMSingleUpdateEmitter, type IOIMSubscribable, type IOIMSubscription, OIMCarrierKeyedEmitter, OIMCarrierSingleEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionGlobalIndexArrayBased, OIMDerivedCollectionGlobalIndexSetBased, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByGlobalIndexArrayBasedSelector, OIMEntitiesByGlobalIndexSetBasedSelector, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerSync, OIMEventQueueSchedulerTimeout, OIMGlobalIndex, OIMGlobalIndexArrayBased, OIMGlobalIndexManualArrayBased, OIMGlobalIndexManualSetBased, OIMGlobalIndexSetBased, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexSlotMap, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandBuffer, OIMOrderedListCommandStream, OIMOrderedListCommandStreamDiffDriven, OIMOrderedListMappedCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionGlobalIndexManualArrayBased, OIMReactiveCollectionGlobalIndexManualSetBased, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveGlobalIndex, OIMReactiveGlobalIndexArrayBased, OIMReactiveGlobalIndexManualArrayBased, OIMReactiveGlobalIndexManualSetBased, OIMReactiveGlobalIndexSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionGlobalIndexArrayBasedOptions, type TOIMCollectionGlobalIndexSetBasedOptions, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, type TOIMDerivedCollectionGlobalIndexArrayBasedOptions, type TOIMDerivedCollectionGlobalIndexSetBasedOptions, type TOIMDerivedCollectionIndexArrayBasedOptions, type TOIMDerivedCollectionIndexSetBasedOptions, type TOIMDerivedEntityComparator, type TOIMDerivedEntityOrderSelector, type TOIMDerivedEntityOrderValue, type TOIMDerivedIndexKeySelector, type TOIMEffectOptions, type TOIMEntitySlot, type TOIMEntitySlotResolver, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMGlobalIndexFilter, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMOrderedListDiffOptions, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedGlobalArrayIndexOptions, type TOIMRelationsDerivedGlobalSetIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsGlobalArrayIndexOptions, type TOIMRelationsGlobalSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createMergeEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit, createOIMIndexSlotMap, createOIMOrderedListCommandStreamDiffDriven, createOIMOrderedListMappedCommandStream, diffOrderedListByPk };
+export { EOIMCollectionEventType, EOIMComputedEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMObjectEventType, type IOIMCarrierResolver, type IOIMComputedEventSource, type IOIMEffectDependency, type IOIMEventQueueSchedulerEvents, type IOIMGlobalIndexSlotSource, type IOIMIndexSlotSource, type IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMOrderedListCommandSource, type IOIMSingleUpdateEmitter, type IOIMSubscribable, type IOIMSubscription, OIMCarrierKeyedEmitter, OIMCarrierSingleEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionGlobalIndexArrayBased, OIMDerivedCollectionGlobalIndexSetBased, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByGlobalIndexArrayBasedSelector, OIMEntitiesByGlobalIndexSetBasedSelector, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerSync, OIMEventQueueSchedulerTimeout, OIMGlobalIndex, OIMGlobalIndexArrayBased, OIMGlobalIndexManualArrayBased, OIMGlobalIndexManualSetBased, OIMGlobalIndexSetBased, OIMGlobalIndexSlotMap, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexSlotMap, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandBuffer, OIMOrderedListCommandStream, OIMOrderedListCommandStreamDiffDriven, OIMOrderedListMappedCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionGlobalIndexManualArrayBased, OIMReactiveCollectionGlobalIndexManualSetBased, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveGlobalIndex, OIMReactiveGlobalIndexArrayBased, OIMReactiveGlobalIndexManualArrayBased, OIMReactiveGlobalIndexManualSetBased, OIMReactiveGlobalIndexSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionGlobalIndexArrayBasedOptions, type TOIMCollectionGlobalIndexSetBasedOptions, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, type TOIMDerivedCollectionGlobalIndexArrayBasedOptions, type TOIMDerivedCollectionGlobalIndexSetBasedOptions, type TOIMDerivedCollectionIndexArrayBasedOptions, type TOIMDerivedCollectionIndexSetBasedOptions, type TOIMDerivedEntityComparator, type TOIMDerivedEntityOrderSelector, type TOIMDerivedEntityOrderValue, type TOIMDerivedIndexKeySelector, type TOIMEffectOptions, type TOIMEntitySlot, type TOIMEntitySlotResolver, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMGlobalIndexFilter, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMOrderedListDiffOptions, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedGlobalArrayIndexOptions, type TOIMRelationsDerivedGlobalSetIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsGlobalArrayIndexOptions, type TOIMRelationsGlobalSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createMergeEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit, createOIMGlobalIndexSlotMap, createOIMIndexSlotMap, createOIMOrderedListCommandStreamDiffDriven, createOIMOrderedListMappedCommandStream, diffOrderedListByPk };

package/dist/index.d.ts

@@ -1928,9 +1928,9 @@ interface IOIMIndexSlotSource<TKey extends TOIMPk, TPk extends TOIMPk> extends I
  * and shared per pk). The cache is a `WeakMap`, so a mapped object is reclaimed
  * by GC once its slot is dropped and unreferenced — there is no lifecycle
  * callback and none is needed for plain values. If your mapped objects hold
- * resources that need explicit teardown (DOM nodes, subscriptions), use the
- * ordered command stream (`createOIMOrderedListMappedCommandStream`), which has
- * an exact removal signal to drive `destroy`.
+ * resources that need explicit teardown (DOM nodes, subscriptions), drive an
+ * ordered command stream instead — its `remove` / `set` / `reset` commands are
+ * the exact removal signal you tear down on.
  *
  * This is a thin wrapper: it holds no queue and no standing subscription of its
  * own — `subscribeOnKey` is a passthrough to the index.
@@ -1976,6 +1976,76 @@ declare class OIMIndexSlotMap<TKey extends TOIMPk, TPk extends TOIMPk, TMapped>
  */
 declare function createOIMIndexSlotMap<TKey extends TOIMPk, TPk extends TOIMPk, TMapped>(index: IOIMIndexSlotSource<TKey, TPk>, create: (slot: TOIMAnyEntitySlot<TPk>) => TMapped): OIMIndexSlotMap<TKey, TPk, TMapped>;
 
+/**
+ * Minimal read/subscribe surface a keyless (whole-collection) index exposes for
+ * slot mapping: iterate all slots and subscribe to the single bucket's changes.
+ * The keyless counterpart of {@link IOIMIndexSlotSource}.
+ *
+ * Both `OIMReactiveGlobalIndexSetBased` (slots as a `ReadonlySet`) and
+ * `OIMReactiveGlobalIndexArrayBased` (slots as a `readonly` array) satisfy it
+ * structurally — a `Set` and an array are both `Iterable`.
+ */
+interface IOIMGlobalIndexSlotSource<TPk extends TOIMPk> extends IOIMSubscription {
+    getSlots(): Iterable<TOIMAnyEntitySlot<TPk>>;
+}
+
+/**
+ * Stable slot→object memo over a keyless (whole-collection) set/array index —
+ * the keyless counterpart of {@link OIMIndexSlotMap}.
+ *
+ * `create(slot)` runs once per canonical slot; every later read returns the
+ * **same** object reference for the same slot, so a consumer can re-read on each
+ * notification and still hand reference-equal objects to `React.memo` /
+ * `Object.is` diffing, or reuse the same view-model.
+ *
+ * The cache is a `WeakMap` keyed by the slot object, so a mapped object is
+ * reclaimed by GC once its slot is dropped. There is no teardown callback and
+ * none is needed for plain values; if your mapped objects hold resources needing
+ * explicit cleanup, drive an ordered command stream (whose `remove` / `set` /
+ * `reset` commands are the exact removal signal) instead.
+ *
+ * Thin wrapper: no queue, no standing subscription of its own — `subscribe` is a
+ * passthrough to the index.
+ */
+declare class OIMGlobalIndexSlotMap<TPk extends TOIMPk, TMapped> {
+    private readonly index;
+    private readonly create;
+    private readonly cache;
+    constructor(index: IOIMGlobalIndexSlotSource<TPk>, create: (slot: TOIMAnyEntitySlot<TPk>) => TMapped);
+    /** The mapped object for a slot, created once and cached by slot identity. */
+    get(slot: TOIMAnyEntitySlot<TPk>): TMapped;
+    /**
+     * Mapped objects for every slot in the index, with stable references. For a
+     * set-based global index the order is unspecified (as the set is); for an
+     * array-based one it follows the index order.
+     */
+    getAll(): TMapped[];
+    /**
+     * Chain another projection. `map(f)` returns a slot map over the SAME index
+     * whose objects are `f(this.get(slot))`, cached by slot identity — both
+     * levels hand back stable references and each `create` runs once per slot.
+     */
+    map<TNext>(create: (mapped: TMapped) => TNext): OIMGlobalIndexSlotMap<TPk, TNext>;
+    /** Subscribe to the index's changes — passthrough to the index. */
+    subscribe(handler: TOIMEventHandler<void>): () => void;
+}
+
+/**
+ * Map the slots of a keyless (whole-collection) set/array index to stable
+ * per-slot objects — the keyless counterpart of `createOIMIndexSlotMap`.
+ *
+ * ```ts
+ * const everyone = users.indexFactory.derivedSetGlobalIndex();
+ * const rows = createOIMGlobalIndexSlotMap(everyone, (slot) => makeRow(slot.item));
+ *
+ * rows.subscribe(render);
+ * function render() {
+ *   for (const row of rows.getAll()) { /* same instance per slot *\/ }
+ * }
+ * ```
+ */
+declare function createOIMGlobalIndexSlotMap<TPk extends TOIMPk, TMapped>(index: IOIMGlobalIndexSlotSource<TPk>, create: (slot: TOIMAnyEntitySlot<TPk>) => TMapped): OIMGlobalIndexSlotMap<TPk, TMapped>;
+
 /**
  * Options for {@link OIMOrderedListCommandStreamDiffDriven}.
  */
@@ -2462,4 +2532,4 @@ declare class OIMEntitiesByGlobalIndexArrayBasedSelector<TEntity extends object,
     protected areEqual(prev: readonly (TEntity | undefined)[], next: readonly (TEntity | undefined)[]): boolean;
 }
 
-export { EOIMCollectionEventType, EOIMComputedEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMObjectEventType, type IOIMCarrierResolver, type IOIMComputedEventSource, type IOIMEffectDependency, type IOIMEventQueueSchedulerEvents, type IOIMIndexSlotSource, type IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMOrderedListCommandSource, type IOIMSingleUpdateEmitter, type IOIMSubscribable, type IOIMSubscription, OIMCarrierKeyedEmitter, OIMCarrierSingleEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionGlobalIndexArrayBased, OIMDerivedCollectionGlobalIndexSetBased, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByGlobalIndexArrayBasedSelector, OIMEntitiesByGlobalIndexSetBasedSelector, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerSync, OIMEventQueueSchedulerTimeout, OIMGlobalIndex, OIMGlobalIndexArrayBased, OIMGlobalIndexManualArrayBased, OIMGlobalIndexManualSetBased, OIMGlobalIndexSetBased, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexSlotMap, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandBuffer, OIMOrderedListCommandStream, OIMOrderedListCommandStreamDiffDriven, OIMOrderedListMappedCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionGlobalIndexManualArrayBased, OIMReactiveCollectionGlobalIndexManualSetBased, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveGlobalIndex, OIMReactiveGlobalIndexArrayBased, OIMReactiveGlobalIndexManualArrayBased, OIMReactiveGlobalIndexManualSetBased, OIMReactiveGlobalIndexSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionGlobalIndexArrayBasedOptions, type TOIMCollectionGlobalIndexSetBasedOptions, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, type TOIMDerivedCollectionGlobalIndexArrayBasedOptions, type TOIMDerivedCollectionGlobalIndexSetBasedOptions, type TOIMDerivedCollectionIndexArrayBasedOptions, type TOIMDerivedCollectionIndexSetBasedOptions, type TOIMDerivedEntityComparator, type TOIMDerivedEntityOrderSelector, type TOIMDerivedEntityOrderValue, type TOIMDerivedIndexKeySelector, type TOIMEffectOptions, type TOIMEntitySlot, type TOIMEntitySlotResolver, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMGlobalIndexFilter, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMOrderedListDiffOptions, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedGlobalArrayIndexOptions, type TOIMRelationsDerivedGlobalSetIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsGlobalArrayIndexOptions, type TOIMRelationsGlobalSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createMergeEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit, createOIMIndexSlotMap, createOIMOrderedListCommandStreamDiffDriven, createOIMOrderedListMappedCommandStream, diffOrderedListByPk };
+export { EOIMCollectionEventType, EOIMComputedEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMObjectEventType, type IOIMCarrierResolver, type IOIMComputedEventSource, type IOIMEffectDependency, type IOIMEventQueueSchedulerEvents, type IOIMGlobalIndexSlotSource, type IOIMIndexSlotSource, type IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMOrderedListCommandSource, type IOIMSingleUpdateEmitter, type IOIMSubscribable, type IOIMSubscription, OIMCarrierKeyedEmitter, OIMCarrierSingleEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionGlobalIndexArrayBased, OIMDerivedCollectionGlobalIndexSetBased, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByGlobalIndexArrayBasedSelector, OIMEntitiesByGlobalIndexSetBasedSelector, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerSync, OIMEventQueueSchedulerTimeout, OIMGlobalIndex, OIMGlobalIndexArrayBased, OIMGlobalIndexManualArrayBased, OIMGlobalIndexManualSetBased, OIMGlobalIndexSetBased, OIMGlobalIndexSlotMap, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexSlotMap, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandBuffer, OIMOrderedListCommandStream, OIMOrderedListCommandStreamDiffDriven, OIMOrderedListMappedCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionGlobalIndexManualArrayBased, OIMReactiveCollectionGlobalIndexManualSetBased, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveGlobalIndex, OIMReactiveGlobalIndexArrayBased, OIMReactiveGlobalIndexManualArrayBased, OIMReactiveGlobalIndexManualSetBased, OIMReactiveGlobalIndexSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionGlobalIndexArrayBasedOptions, type TOIMCollectionGlobalIndexSetBasedOptions, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, type TOIMDerivedCollectionGlobalIndexArrayBasedOptions, type TOIMDerivedCollectionGlobalIndexSetBasedOptions, type TOIMDerivedCollectionIndexArrayBasedOptions, type TOIMDerivedCollectionIndexSetBasedOptions, type TOIMDerivedEntityComparator, type TOIMDerivedEntityOrderSelector, type TOIMDerivedEntityOrderValue, type TOIMDerivedIndexKeySelector, type TOIMEffectOptions, type TOIMEntitySlot, type TOIMEntitySlotResolver, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMGlobalIndexFilter, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMOrderedListDiffOptions, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedGlobalArrayIndexOptions, type TOIMRelationsDerivedGlobalSetIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsGlobalArrayIndexOptions, type TOIMRelationsGlobalSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createMergeEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit, createOIMGlobalIndexSlotMap, createOIMIndexSlotMap, createOIMOrderedListCommandStreamDiffDriven, createOIMOrderedListMappedCommandStream, diffOrderedListByPk };

package/dist/index.js

@@ -4597,6 +4597,56 @@ function createOIMIndexSlotMap(index, create) {
   return new OIMIndexSlotMap(index, create);
 }
 
+// src/modules/wrapper/index/OIMGlobalIndexSlotMap.ts
+var OIMGlobalIndexSlotMap = class _OIMGlobalIndexSlotMap {
+  constructor(index, create) {
+    this.cache = /* @__PURE__ */ new WeakMap();
+    this.index = index;
+    this.create = create;
+  }
+  /** The mapped object for a slot, created once and cached by slot identity. */
+  get(slot) {
+    let mapped = this.cache.get(slot);
+    if (mapped === void 0 && !this.cache.has(slot)) {
+      mapped = this.create(slot);
+      this.cache.set(slot, mapped);
+    }
+    return mapped;
+  }
+  /**
+   * Mapped objects for every slot in the index, with stable references. For a
+   * set-based global index the order is unspecified (as the set is); for an
+   * array-based one it follows the index order.
+   */
+  getAll() {
+    const result = [];
+    for (const slot of this.index.getSlots()) {
+      result.push(this.get(slot));
+    }
+    return result;
+  }
+  /**
+   * Chain another projection. `map(f)` returns a slot map over the SAME index
+   * whose objects are `f(this.get(slot))`, cached by slot identity — both
+   * levels hand back stable references and each `create` runs once per slot.
+   */
+  map(create) {
+    return new _OIMGlobalIndexSlotMap(
+      this.index,
+      (slot) => create(this.get(slot))
+    );
+  }
+  /** Subscribe to the index's changes — passthrough to the index. */
+  subscribe(handler) {
+    return this.index.subscribe(handler);
+  }
+};
+
+// src/modules/wrapper/index/createOIMGlobalIndexSlotMap.ts
+function createOIMGlobalIndexSlotMap(index, create) {
+  return new OIMGlobalIndexSlotMap(index, create);
+}
+
 // src/modules/wrapper/index/diffOrderedListByPk.ts
 function diffOrderedListByPk(prev, next) {
   const commands = [];
@@ -5393,6 +5443,7 @@ export {
   OIMGlobalIndexManualArrayBased,
   OIMGlobalIndexManualSetBased,
   OIMGlobalIndexSetBased,
+  OIMGlobalIndexSlotMap,
   OIMIndex,
   OIMIndexArrayBased,
   OIMIndexComparatorFactory,
@@ -5442,6 +5493,7 @@ export {
   createMergeEntityUpdater,
   createOIMCollectionIndexFactory,
   createOIMCollectionKit,
+  createOIMGlobalIndexSlotMap,
   createOIMIndexSlotMap,
   createOIMOrderedListCommandStreamDiffDriven,
   createOIMOrderedListMappedCommandStream,

package/llms.txt

@@ -156,7 +156,7 @@ const stream = createOIMOrderedListCommandStreamDiffDriven(queue, cardsByDeck);
 stream.subscribeCommands('deck1', () => engine.apply(stream.consumeCommands('deck1'))); // insert/move/remove
 ```
 
-**Mapping a plain index to stable objects** — for an ordinary set/array index (no commands), `createOIMIndexSlotMap(index, create)` / `OIMIndexSlotMap` memoizes `create(slot)` by slot identity (a `WeakMap`): the same slot returns the same object reference on every read, so `React.memo` / `Object.is` diffing works and view-models are reused. Same plain-function shape as the ordered mapper, no `destroy` (plain values, GC reclaims). `getByKey(key)` → mapped objects; `subscribeOnKey`/`subscribeOnKeys` passthrough to the index. New exports: `OIMIndexSlotMap`, `createOIMIndexSlotMap`, `IOIMIndexSlotSource`.
+**Mapping a plain index to stable objects** — for an ordinary set/array index (no commands), `createOIMIndexSlotMap(index, create)` / `OIMIndexSlotMap` memoizes `create(slot)` by slot identity (a `WeakMap`): the same slot returns the same object reference on every read, so `React.memo` / `Object.is` diffing works and view-models are reused. Same plain-function shape as the ordered mapper, no `destroy` (plain values, GC reclaims). `getByKey(key)` → mapped objects; `.map(create)` chains; `subscribeOnKey`/`subscribeOnKeys` passthrough to the index. For a keyless global index use `createOIMGlobalIndexSlotMap(index, create)` / `OIMGlobalIndexSlotMap` — same memo with `getAll()` and `subscribe()` instead of the keyed variants. New exports: `OIMIndexSlotMap`, `createOIMIndexSlotMap`, `IOIMIndexSlotSource`, `OIMGlobalIndexSlotMap`, `createOIMGlobalIndexSlotMap`, `IOIMGlobalIndexSlotSource`.
 
 ```ts
 const usersByTeam = users.indexFactory.derivedSetIndex((u) => u.teamId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimdb/core",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Core in-memory data library with type-safe indices, reactive subscriptions, and event processing",
   "type": "module",
   "main": "./dist/index.cjs",