@oimdb/core 3.3.0 → 3.5.0

package/dist/index.d.cts

@@ -627,7 +627,20 @@ declare class OIMIndexManualOrderedArrayBased<TKey extends TOIMPk, TItemKey exte
     pushSlot(key: TKey, slot: TOIMAnyEntitySlot<TItemKey>): number;
     insertSlotAt(key: TKey, index: number, slot: TOIMAnyEntitySlot<TItemKey>): number;
     removeAt(key: TKey, index: number): TOIMAnyEntitySlot<TItemKey> | undefined;
+    /**
+     * Remove up to `count` consecutive slots starting at `index`.
+     * Returns the number actually removed (clamped to bounds; 0 if nothing).
+     */
+    removeRange(key: TKey, index: number, count: number): number;
     move(key: TKey, fromIndex: number, toIndex: number): TOIMAnyEntitySlot<TItemKey> | undefined;
+    /** Replace the slot at `index` in place. Returns the safe index, or -1. */
+    setSlotAt(key: TKey, index: number, slot: TOIMAnyEntitySlot<TItemKey>): number;
+    /**
+     * Move up to `count` consecutive slots from `from` to `to`. `to` is in the
+     * coordinate space *after* the block is extracted (same as single `move`).
+     * Returns the number actually moved (0 if a no-op / out of bounds).
+     */
+    moveRange(key: TKey, from: number, to: number, count: number): number;
     resetSlots(key: TKey, slots: readonly TOIMAnyEntitySlot<TItemKey>[]): void;
     private getOrCreateList;
 }
@@ -712,39 +725,79 @@ declare class OIMUpdateEventEmitter<TKey extends TOIMPk> {
     unsubscribeFromKeys(keys: readonly TKey[], handler: TOIMEventHandler<void>): void;
 }
 
-type TOIMOrderedListCommand<TPk extends TOIMPk, TEntity extends object = object> = {
+/**
+ * Incremental command for an ordered per-key list, addressed by position.
+ *
+ * `item` is whatever the stream stores per element — the command stream uses the
+ * entity slot (`TOIMEntitySlot`), so a consumer reads `item.item` for the entity.
+ *
+ * - `insert` — a single element appears at `index`.
+ * - `remove` — `count` elements (default 1, may be > 1) disappear from `index`.
+ * - `move`   — `count` elements (default 1) move from `from` to `to`.
+ * - `set`    — the element at `index` is replaced in place.
+ * - `reset`  — the whole list for the key is replaced by `items`.
+ */
+type TOIMOrderedListCommand<TItem> = {
     type: 'insert';
-    pk: TPk;
-    slot: TOIMEntitySlot<TEntity, TPk>;
     index: number;
+    item: TItem;
 } | {
     type: 'remove';
-    pk: TPk;
-    slot: TOIMEntitySlot<TEntity, TPk>;
     index: number;
+    count?: number;
 } | {
     type: 'move';
-    pk: TPk;
-    slot: TOIMEntitySlot<TEntity, TPk>;
-    fromIndex: number;
-    toIndex: number;
+    from: number;
+    to: number;
+    count?: number;
 } | {
-    /**
-     * Replace the whole list for this key (preferred name).
-     */
     type: 'set';
-    pks: readonly TPk[];
-    slots: readonly TOIMEntitySlot<TEntity, TPk>[];
+    index: number;
+    item: TItem;
+} | {
+    type: 'reset';
+    items: readonly TItem[];
 };
 
+/**
+ * Read/consume side of an ordered-list command stream, generic over the element
+ * type it carries.
+ *
+ * The concrete stream stores entity slots (`TItem = TOIMEntitySlot<...>`); a
+ * mapped source ({@link OIMOrderedListMappedCommandStream}) carries whatever the
+ * mapping produces. A consumer that depends on this interface works unchanged
+ * against either — raw or mapped.
+ *
+ * Consumption is pull-based and synchronous: the notification carries no
+ * payload, so `consumeCommands(key)` must be called inside the `handler`, before
+ * the buffer for that key is cleared.
+ */
+interface IOIMOrderedListCommandSource<TKey extends TOIMPk, TItem> {
+    /**
+     * Subscribe to per-key command notifications. The handler receives no
+     * payload — pull the commands with {@link consumeCommands} synchronously.
+     * Returns an unsubscribe function.
+     */
+    subscribeCommands(key: TKey, handler: () => void): () => void;
+    /** Drain the commands buffered for `key` this delivery (a copy). */
+    consumeCommands(key: TKey): TOIMOrderedListCommand<TItem>[];
+    /** Current ordered items for `key` — the initial state before any command. */
+    getItemsByKey(key: TKey): readonly TItem[];
+}
+
 /**
  * Slot-first ordered-list command stream.
  *
- * Use this when you already have slots and want incremental commands for an
- * imperative renderer. For PK writes bound to a collection, use
+ * Emits position-addressed {@link TOIMOrderedListCommand}s whose `item` is the
+ * entity slot. Use this when you already have slots and want incremental
+ * commands for an imperative renderer. For PK writes bound to a collection, use
  * `OIMCollectionOrderedListCommandStream`.
+ *
+ * Implements {@link IOIMOrderedListCommandSource} (with the slot as the element)
+ * so it can be projected element-wise via
+ * `createOIMOrderedListMappedCommandStream`.
  */
-declare class OIMOrderedListCommandStream<TKey extends TOIMPk, TPk extends TOIMPk, TEntity extends object = object> {
+declare class OIMOrderedListCommandStream<TKey extends TOIMPk, TPk extends TOIMPk, TEntity extends object = object> implements IOIMOrderedListCommandSource<TKey, TOIMEntitySlot<TEntity, TPk>> {
     readonly commandsEventEmitter: OIMUpdateEventEmitter<TKey>;
     private readonly unsubscribeAfterFlush;
     private readonly unsubscribeFromIndexEmitter;
@@ -755,24 +808,37 @@ declare class OIMOrderedListCommandStream<TKey extends TOIMPk, TPk extends TOIMP
     constructor(queue: OIMEventQueue, index?: OIMIndexManualOrderedArrayBased<TKey, TPk>);
     getPksByKey(key: TKey): readonly TPk[];
     getSlotsByKey(key: TKey): readonly TOIMEntitySlot<TEntity, TPk>[];
+    /** {@link IOIMOrderedListCommandSource} — alias of {@link getSlotsByKey}. */
+    getItemsByKey(key: TKey): readonly TOIMEntitySlot<TEntity, TPk>[];
+    /** {@link IOIMOrderedListCommandSource} — per-key command subscription. */
+    subscribeCommands(key: TKey, handler: () => void): () => void;
     getEntitiesByKey(key: TKey): (TEntity | undefined)[];
     hasKey(key: TKey): boolean;
     getKeys(): readonly TKey[];
     pushSlot(key: TKey, slot: TOIMEntitySlot<TEntity, TPk>): void;
     insertSlotAt(key: TKey, index: number, slot: TOIMEntitySlot<TEntity, TPk>): void;
+    /** Replace the slot at `index` in place. */
+    setSlotAt(key: TKey, index: number, slot: TOIMEntitySlot<TEntity, TPk>): void;
     removeAt(key: TKey, index: number): void;
+    /** Remove `count` consecutive elements from `index`; emits `remove` with `count`. */
+    removeRange(key: TKey, index: number, count: number): void;
     move(key: TKey, fromIndex: number, toIndex: number): void;
+    /**
+     * Move `count` consecutive elements from `from` to `to`; emits `move` with
+     * `count`. `to` is in the post-extraction coordinate space (as single `move`).
+     */
+    moveRange(key: TKey, from: number, to: number, count: number): void;
     setSlots(key: TKey, slots: readonly TOIMEntitySlot<TEntity, TPk>[]): void;
-    getBufferedCommands(key: TKey): readonly TOIMOrderedListCommand<TPk, TEntity>[];
-    consumeCommands(key: TKey): TOIMOrderedListCommand<TPk, TEntity>[];
+    getBufferedCommands(key: TKey): readonly TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>[];
+    consumeCommands(key: TKey): TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>[];
     clear(key?: TKey): void;
     destroy(): void;
     private readonly onAfterFlush;
     private readonly onIndexUpdate;
     protected withWrite(fn: () => void): void;
-    protected appendCommand(key: TKey, cmd: TOIMOrderedListCommand<TPk, TEntity>): void;
-    protected appendSetCommand(key: TKey, slots: readonly TOIMEntitySlot<TEntity, TPk>[]): void;
-    protected createSetCommand(slots: readonly TOIMEntitySlot<TEntity, TPk>[]): TOIMOrderedListCommand<TPk, TEntity>;
+    protected appendCommand(key: TKey, cmd: TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>): void;
+    protected appendResetCommand(key: TKey, slots: readonly TOIMEntitySlot<TEntity, TPk>[]): void;
+    protected createResetCommand(slots: readonly TOIMEntitySlot<TEntity, TPk>[]): TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>;
 }
 
 /**
@@ -785,6 +851,8 @@ declare class OIMCollectionOrderedListCommandStream<TKey extends TOIMPk, TPk ext
     constructor(queue: OIMEventQueue, opts: TOIMCollectionOrderedListCommandStreamOptions<TKey, TPk, TEntity>);
     push(key: TKey, pk: TPk): void;
     insertAt(key: TKey, index: number, pk: TPk): void;
+    /** Replace the element at `index` with the slot for `pk`, in place. */
+    setAt(key: TKey, index: number, pk: TPk): void;
     set(key: TKey, pks: readonly TPk[]): void;
     getSlotsByKey(key: TKey): readonly TOIMEntitySlot<TEntity, TPk>[];
     getEntitiesByKey(key: TKey): (TEntity | undefined)[];
@@ -1149,6 +1217,18 @@ declare class OIMEntityUpdaterFactory<TEntity extends object> {
  */
 declare function createInPlaceEntityUpdater<TEntity extends object>(): TOIMEntityUpdater<TEntity>;
 
+/**
+ * Default entity updater: shallow-merges the patch into a NEW object
+ * (`{ ...prev, ...draft }`). Each update produces a fresh entity reference, which
+ * reference-comparison bindings (React's `Object.is` / `useSyncExternalStore`,
+ * `React.memo`, prev/next diffing, time-travel) need to detect a change.
+ *
+ * The new-object allocation is the biggest per-update data-layer cost; for
+ * update-heavy, subscription-driven readers use {@link createInPlaceEntityUpdater}
+ * instead.
+ */
+declare function createMergeEntityUpdater<TEntity extends object>(): TOIMEntityUpdater<TEntity>;
+
 /**
  * Factory for creating index comparators.
  * Provides common comparison strategies for primary key arrays.
@@ -1297,9 +1377,11 @@ declare class OIMCollectionChangedFields<TEntity extends object, TPk extends TOI
     readonly collection: OIMCollection<TEntity, TPk>;
     private readonly selectPk;
     private readonly unsubscribeAfterFlush;
-    private readonly unsubscribeFromCollectionEmitter;
+    private readonly unsubscribeFromCollectionEmitter?;
+    private readonly detectExternalMutations;
     private isInWrite;
     private readonly lastEntitySnapshotByPk;
+    private readonly writtenThroughThisFlush;
     /**
      * Emits updates scoped by PK. Subscribe, then read state via `getChangedFieldsByPk(...)`
      * or drain via `consumeChangedFieldsByPk(...)`.
@@ -1318,6 +1400,18 @@ declare class OIMCollectionChangedFields<TEntity extends object, TPk extends TOI
          * If not provided, only `upsertOneByPk(...)` should be used.
          */
         selectPk?: (entity: TEntity | Partial<TEntity>) => TPk;
+        /**
+         * Detect writes that bypass this wrapper (direct collection
+         * mutations) by diffing entity snapshots. Default `true`.
+         *
+         * Set to `false` when you always write through this wrapper: it
+         * drops the per-write snapshot clone and the per-PK snapshot map
+         * (~2x entity memory), since those exist only to power external
+         * detection. The shallow diff also can't see deep in-place
+         * mutations anyway — so if that's your model, opting out costs you
+         * nothing it could have caught.
+         */
+        detectExternalMutations?: boolean;
     });
     upsertOneByPk(pk: TPk, patch: Partial<TEntity>): TOIMEntitySlot<TEntity, TPk>;
     upsertOne(entity: TEntity | Partial<TEntity>): TOIMEntitySlot<TEntity, TPk>;
@@ -1338,6 +1432,80 @@ declare class OIMCollectionChangedFields<TEntity extends object, TPk extends TOI
     private trackPatch;
 }
 
+/**
+ * Options for {@link OIMOrderedListMappedCommandStream} — how a source element
+ * (`TIn`) is projected to a downstream element (`TOut`) and torn down.
+ *
+ * `create` runs once per element when it enters the list (an `insert`, a `set`
+ * replacement, or list build / `reset`). `destroy` runs when it leaves (a
+ * `remove`, the replaced half of a `set`, every element on `reset`, and on
+ * stream `destroy()`). A `move` reuses the same `TOut` — it is never recreated.
+ */
+type TOIMOrderedListMapOptions<TIn, TOut> = {
+    create: (item: TIn) => TOut;
+    destroy?: (mapped: TOut) => void;
+};
+
+/**
+ * Projects an ordered-list command source element-wise, re-emitting the same
+ * position-addressed commands with `item` replaced by the mapped value.
+ *
+ * It rides the source's batching: there is no queue and no independent
+ * scheduling. On each source notification it pulls the source commands,
+ * translates them (running `create` / `destroy` and updating a positional
+ * mirror of the mapped elements), and notifies its own subscribers
+ * synchronously — so the source's `after_flush` semantics carry through.
+ *
+ * Identity is positional: a `move` reorders the *same* mapped references in the
+ * mirror, so the mapped element is preserved across moves and never recreated.
+ * `create` runs on `insert` / `set` / `reset` / initial build; `destroy` on
+ * `remove` / the replaced half of `set` / every element on `reset` / `destroy()`.
+ *
+ * Wiring to the source for a key is lazy (on first `subscribeCommands` or
+ * `getItemsByKey`) and lives until `destroy()`; subscriber churn does not
+ * create or tear down mapped elements.
+ *
+ * The output is itself an {@link IOIMOrderedListCommandSource}, so maps chain:
+ * `source.map(...)` → `.map(...)`.
+ */
+declare class OIMOrderedListMappedCommandStream<TKey extends TOIMPk, TOut, TIn> implements IOIMOrderedListCommandSource<TKey, TOut> {
+    private readonly source;
+    private readonly create;
+    private readonly destroyItem?;
+    /** Per-key positional mirror of the mapped elements. */
+    private readonly mirror;
+    /** Mapped commands produced for the current delivery, per key. */
+    private readonly buffer;
+    private readonly subscribers;
+    private readonly sourceUnsubscribers;
+    constructor(source: IOIMOrderedListCommandSource<TKey, TIn>, opts: TOIMOrderedListMapOptions<TIn, TOut>);
+    subscribeCommands(key: TKey, handler: () => void): () => void;
+    consumeCommands(key: TKey): TOIMOrderedListCommand<TOut>[];
+    getItemsByKey(key: TKey): readonly TOut[];
+    /** Map this source again, chaining the projection. */
+    map<TNext>(opts: TOIMOrderedListMapOptions<TOut, TNext>): OIMOrderedListMappedCommandStream<TKey, TNext, TOut>;
+    destroy(): void;
+    /** Build the initial mirror and subscribe to the source once per key. */
+    private ensureWired;
+    private onSourceCommands;
+}
+
+/**
+ * Map an ordered-list command source element-wise. The result is itself a
+ * source, so it can be mapped again (or via its `.map()` method).
+ *
+ * ```ts
+ * const nodes = createOIMOrderedListMappedCommandStream(stream, {
+ *     create: (slot) => engine.makeNode(slot.item),
+ *     destroy: (node) => engine.dropNode(node),
+ * });
+ * nodes.subscribeCommands(key, () =>
+ *     engine.apply(nodes.consumeCommands(key))
+ * );
+ * ```
+ */
+declare function createOIMOrderedListMappedCommandStream<TKey extends TOIMPk, TIn, TOut>(source: IOIMOrderedListCommandSource<TKey, TIn>, opts: TOIMOrderedListMapOptions<TIn, TOut>): OIMOrderedListMappedCommandStream<TKey, TOut, TIn>;
+
 /**
  * Animation frame-based scheduler that executes flushes synchronized with the browser's repaint cycle.
  * Ideal for UI-related updates that need to be synchronized with rendering.
@@ -1690,4 +1858,4 @@ declare class OIMEntitiesByIndexKeyArrayBasedSelector<TEntity extends object, TP
     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 IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMSubscribable, OIMCarrierKeyedEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, 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 TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit };
+export { EOIMCollectionEventType, EOIMComputedEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMObjectEventType, type IOIMCarrierResolver, type IOIMComputedEventSource, type IOIMEffectDependency, type IOIMEventQueueSchedulerEvents, type IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMOrderedListCommandSource, type IOIMSubscribable, OIMCarrierKeyedEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandStream, OIMOrderedListMappedCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, 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 TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMOrderedListMapOptions, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createMergeEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit, createOIMOrderedListMappedCommandStream };

package/dist/index.d.ts

@@ -627,7 +627,20 @@ declare class OIMIndexManualOrderedArrayBased<TKey extends TOIMPk, TItemKey exte
     pushSlot(key: TKey, slot: TOIMAnyEntitySlot<TItemKey>): number;
     insertSlotAt(key: TKey, index: number, slot: TOIMAnyEntitySlot<TItemKey>): number;
     removeAt(key: TKey, index: number): TOIMAnyEntitySlot<TItemKey> | undefined;
+    /**
+     * Remove up to `count` consecutive slots starting at `index`.
+     * Returns the number actually removed (clamped to bounds; 0 if nothing).
+     */
+    removeRange(key: TKey, index: number, count: number): number;
     move(key: TKey, fromIndex: number, toIndex: number): TOIMAnyEntitySlot<TItemKey> | undefined;
+    /** Replace the slot at `index` in place. Returns the safe index, or -1. */
+    setSlotAt(key: TKey, index: number, slot: TOIMAnyEntitySlot<TItemKey>): number;
+    /**
+     * Move up to `count` consecutive slots from `from` to `to`. `to` is in the
+     * coordinate space *after* the block is extracted (same as single `move`).
+     * Returns the number actually moved (0 if a no-op / out of bounds).
+     */
+    moveRange(key: TKey, from: number, to: number, count: number): number;
     resetSlots(key: TKey, slots: readonly TOIMAnyEntitySlot<TItemKey>[]): void;
     private getOrCreateList;
 }
@@ -712,39 +725,79 @@ declare class OIMUpdateEventEmitter<TKey extends TOIMPk> {
     unsubscribeFromKeys(keys: readonly TKey[], handler: TOIMEventHandler<void>): void;
 }
 
-type TOIMOrderedListCommand<TPk extends TOIMPk, TEntity extends object = object> = {
+/**
+ * Incremental command for an ordered per-key list, addressed by position.
+ *
+ * `item` is whatever the stream stores per element — the command stream uses the
+ * entity slot (`TOIMEntitySlot`), so a consumer reads `item.item` for the entity.
+ *
+ * - `insert` — a single element appears at `index`.
+ * - `remove` — `count` elements (default 1, may be > 1) disappear from `index`.
+ * - `move`   — `count` elements (default 1) move from `from` to `to`.
+ * - `set`    — the element at `index` is replaced in place.
+ * - `reset`  — the whole list for the key is replaced by `items`.
+ */
+type TOIMOrderedListCommand<TItem> = {
     type: 'insert';
-    pk: TPk;
-    slot: TOIMEntitySlot<TEntity, TPk>;
     index: number;
+    item: TItem;
 } | {
     type: 'remove';
-    pk: TPk;
-    slot: TOIMEntitySlot<TEntity, TPk>;
     index: number;
+    count?: number;
 } | {
     type: 'move';
-    pk: TPk;
-    slot: TOIMEntitySlot<TEntity, TPk>;
-    fromIndex: number;
-    toIndex: number;
+    from: number;
+    to: number;
+    count?: number;
 } | {
-    /**
-     * Replace the whole list for this key (preferred name).
-     */
     type: 'set';
-    pks: readonly TPk[];
-    slots: readonly TOIMEntitySlot<TEntity, TPk>[];
+    index: number;
+    item: TItem;
+} | {
+    type: 'reset';
+    items: readonly TItem[];
 };
 
+/**
+ * Read/consume side of an ordered-list command stream, generic over the element
+ * type it carries.
+ *
+ * The concrete stream stores entity slots (`TItem = TOIMEntitySlot<...>`); a
+ * mapped source ({@link OIMOrderedListMappedCommandStream}) carries whatever the
+ * mapping produces. A consumer that depends on this interface works unchanged
+ * against either — raw or mapped.
+ *
+ * Consumption is pull-based and synchronous: the notification carries no
+ * payload, so `consumeCommands(key)` must be called inside the `handler`, before
+ * the buffer for that key is cleared.
+ */
+interface IOIMOrderedListCommandSource<TKey extends TOIMPk, TItem> {
+    /**
+     * Subscribe to per-key command notifications. The handler receives no
+     * payload — pull the commands with {@link consumeCommands} synchronously.
+     * Returns an unsubscribe function.
+     */
+    subscribeCommands(key: TKey, handler: () => void): () => void;
+    /** Drain the commands buffered for `key` this delivery (a copy). */
+    consumeCommands(key: TKey): TOIMOrderedListCommand<TItem>[];
+    /** Current ordered items for `key` — the initial state before any command. */
+    getItemsByKey(key: TKey): readonly TItem[];
+}
+
 /**
  * Slot-first ordered-list command stream.
  *
- * Use this when you already have slots and want incremental commands for an
- * imperative renderer. For PK writes bound to a collection, use
+ * Emits position-addressed {@link TOIMOrderedListCommand}s whose `item` is the
+ * entity slot. Use this when you already have slots and want incremental
+ * commands for an imperative renderer. For PK writes bound to a collection, use
  * `OIMCollectionOrderedListCommandStream`.
+ *
+ * Implements {@link IOIMOrderedListCommandSource} (with the slot as the element)
+ * so it can be projected element-wise via
+ * `createOIMOrderedListMappedCommandStream`.
  */
-declare class OIMOrderedListCommandStream<TKey extends TOIMPk, TPk extends TOIMPk, TEntity extends object = object> {
+declare class OIMOrderedListCommandStream<TKey extends TOIMPk, TPk extends TOIMPk, TEntity extends object = object> implements IOIMOrderedListCommandSource<TKey, TOIMEntitySlot<TEntity, TPk>> {
     readonly commandsEventEmitter: OIMUpdateEventEmitter<TKey>;
     private readonly unsubscribeAfterFlush;
     private readonly unsubscribeFromIndexEmitter;
@@ -755,24 +808,37 @@ declare class OIMOrderedListCommandStream<TKey extends TOIMPk, TPk extends TOIMP
     constructor(queue: OIMEventQueue, index?: OIMIndexManualOrderedArrayBased<TKey, TPk>);
     getPksByKey(key: TKey): readonly TPk[];
     getSlotsByKey(key: TKey): readonly TOIMEntitySlot<TEntity, TPk>[];
+    /** {@link IOIMOrderedListCommandSource} — alias of {@link getSlotsByKey}. */
+    getItemsByKey(key: TKey): readonly TOIMEntitySlot<TEntity, TPk>[];
+    /** {@link IOIMOrderedListCommandSource} — per-key command subscription. */
+    subscribeCommands(key: TKey, handler: () => void): () => void;
     getEntitiesByKey(key: TKey): (TEntity | undefined)[];
     hasKey(key: TKey): boolean;
     getKeys(): readonly TKey[];
     pushSlot(key: TKey, slot: TOIMEntitySlot<TEntity, TPk>): void;
     insertSlotAt(key: TKey, index: number, slot: TOIMEntitySlot<TEntity, TPk>): void;
+    /** Replace the slot at `index` in place. */
+    setSlotAt(key: TKey, index: number, slot: TOIMEntitySlot<TEntity, TPk>): void;
     removeAt(key: TKey, index: number): void;
+    /** Remove `count` consecutive elements from `index`; emits `remove` with `count`. */
+    removeRange(key: TKey, index: number, count: number): void;
     move(key: TKey, fromIndex: number, toIndex: number): void;
+    /**
+     * Move `count` consecutive elements from `from` to `to`; emits `move` with
+     * `count`. `to` is in the post-extraction coordinate space (as single `move`).
+     */
+    moveRange(key: TKey, from: number, to: number, count: number): void;
     setSlots(key: TKey, slots: readonly TOIMEntitySlot<TEntity, TPk>[]): void;
-    getBufferedCommands(key: TKey): readonly TOIMOrderedListCommand<TPk, TEntity>[];
-    consumeCommands(key: TKey): TOIMOrderedListCommand<TPk, TEntity>[];
+    getBufferedCommands(key: TKey): readonly TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>[];
+    consumeCommands(key: TKey): TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>[];
     clear(key?: TKey): void;
     destroy(): void;
     private readonly onAfterFlush;
     private readonly onIndexUpdate;
     protected withWrite(fn: () => void): void;
-    protected appendCommand(key: TKey, cmd: TOIMOrderedListCommand<TPk, TEntity>): void;
-    protected appendSetCommand(key: TKey, slots: readonly TOIMEntitySlot<TEntity, TPk>[]): void;
-    protected createSetCommand(slots: readonly TOIMEntitySlot<TEntity, TPk>[]): TOIMOrderedListCommand<TPk, TEntity>;
+    protected appendCommand(key: TKey, cmd: TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>): void;
+    protected appendResetCommand(key: TKey, slots: readonly TOIMEntitySlot<TEntity, TPk>[]): void;
+    protected createResetCommand(slots: readonly TOIMEntitySlot<TEntity, TPk>[]): TOIMOrderedListCommand<TOIMEntitySlot<TEntity, TPk>>;
 }
 
 /**
@@ -785,6 +851,8 @@ declare class OIMCollectionOrderedListCommandStream<TKey extends TOIMPk, TPk ext
     constructor(queue: OIMEventQueue, opts: TOIMCollectionOrderedListCommandStreamOptions<TKey, TPk, TEntity>);
     push(key: TKey, pk: TPk): void;
     insertAt(key: TKey, index: number, pk: TPk): void;
+    /** Replace the element at `index` with the slot for `pk`, in place. */
+    setAt(key: TKey, index: number, pk: TPk): void;
     set(key: TKey, pks: readonly TPk[]): void;
     getSlotsByKey(key: TKey): readonly TOIMEntitySlot<TEntity, TPk>[];
     getEntitiesByKey(key: TKey): (TEntity | undefined)[];
@@ -1149,6 +1217,18 @@ declare class OIMEntityUpdaterFactory<TEntity extends object> {
  */
 declare function createInPlaceEntityUpdater<TEntity extends object>(): TOIMEntityUpdater<TEntity>;
 
+/**
+ * Default entity updater: shallow-merges the patch into a NEW object
+ * (`{ ...prev, ...draft }`). Each update produces a fresh entity reference, which
+ * reference-comparison bindings (React's `Object.is` / `useSyncExternalStore`,
+ * `React.memo`, prev/next diffing, time-travel) need to detect a change.
+ *
+ * The new-object allocation is the biggest per-update data-layer cost; for
+ * update-heavy, subscription-driven readers use {@link createInPlaceEntityUpdater}
+ * instead.
+ */
+declare function createMergeEntityUpdater<TEntity extends object>(): TOIMEntityUpdater<TEntity>;
+
 /**
  * Factory for creating index comparators.
  * Provides common comparison strategies for primary key arrays.
@@ -1297,9 +1377,11 @@ declare class OIMCollectionChangedFields<TEntity extends object, TPk extends TOI
     readonly collection: OIMCollection<TEntity, TPk>;
     private readonly selectPk;
     private readonly unsubscribeAfterFlush;
-    private readonly unsubscribeFromCollectionEmitter;
+    private readonly unsubscribeFromCollectionEmitter?;
+    private readonly detectExternalMutations;
     private isInWrite;
     private readonly lastEntitySnapshotByPk;
+    private readonly writtenThroughThisFlush;
     /**
      * Emits updates scoped by PK. Subscribe, then read state via `getChangedFieldsByPk(...)`
      * or drain via `consumeChangedFieldsByPk(...)`.
@@ -1318,6 +1400,18 @@ declare class OIMCollectionChangedFields<TEntity extends object, TPk extends TOI
          * If not provided, only `upsertOneByPk(...)` should be used.
          */
         selectPk?: (entity: TEntity | Partial<TEntity>) => TPk;
+        /**
+         * Detect writes that bypass this wrapper (direct collection
+         * mutations) by diffing entity snapshots. Default `true`.
+         *
+         * Set to `false` when you always write through this wrapper: it
+         * drops the per-write snapshot clone and the per-PK snapshot map
+         * (~2x entity memory), since those exist only to power external
+         * detection. The shallow diff also can't see deep in-place
+         * mutations anyway — so if that's your model, opting out costs you
+         * nothing it could have caught.
+         */
+        detectExternalMutations?: boolean;
     });
     upsertOneByPk(pk: TPk, patch: Partial<TEntity>): TOIMEntitySlot<TEntity, TPk>;
     upsertOne(entity: TEntity | Partial<TEntity>): TOIMEntitySlot<TEntity, TPk>;
@@ -1338,6 +1432,80 @@ declare class OIMCollectionChangedFields<TEntity extends object, TPk extends TOI
     private trackPatch;
 }
 
+/**
+ * Options for {@link OIMOrderedListMappedCommandStream} — how a source element
+ * (`TIn`) is projected to a downstream element (`TOut`) and torn down.
+ *
+ * `create` runs once per element when it enters the list (an `insert`, a `set`
+ * replacement, or list build / `reset`). `destroy` runs when it leaves (a
+ * `remove`, the replaced half of a `set`, every element on `reset`, and on
+ * stream `destroy()`). A `move` reuses the same `TOut` — it is never recreated.
+ */
+type TOIMOrderedListMapOptions<TIn, TOut> = {
+    create: (item: TIn) => TOut;
+    destroy?: (mapped: TOut) => void;
+};
+
+/**
+ * Projects an ordered-list command source element-wise, re-emitting the same
+ * position-addressed commands with `item` replaced by the mapped value.
+ *
+ * It rides the source's batching: there is no queue and no independent
+ * scheduling. On each source notification it pulls the source commands,
+ * translates them (running `create` / `destroy` and updating a positional
+ * mirror of the mapped elements), and notifies its own subscribers
+ * synchronously — so the source's `after_flush` semantics carry through.
+ *
+ * Identity is positional: a `move` reorders the *same* mapped references in the
+ * mirror, so the mapped element is preserved across moves and never recreated.
+ * `create` runs on `insert` / `set` / `reset` / initial build; `destroy` on
+ * `remove` / the replaced half of `set` / every element on `reset` / `destroy()`.
+ *
+ * Wiring to the source for a key is lazy (on first `subscribeCommands` or
+ * `getItemsByKey`) and lives until `destroy()`; subscriber churn does not
+ * create or tear down mapped elements.
+ *
+ * The output is itself an {@link IOIMOrderedListCommandSource}, so maps chain:
+ * `source.map(...)` → `.map(...)`.
+ */
+declare class OIMOrderedListMappedCommandStream<TKey extends TOIMPk, TOut, TIn> implements IOIMOrderedListCommandSource<TKey, TOut> {
+    private readonly source;
+    private readonly create;
+    private readonly destroyItem?;
+    /** Per-key positional mirror of the mapped elements. */
+    private readonly mirror;
+    /** Mapped commands produced for the current delivery, per key. */
+    private readonly buffer;
+    private readonly subscribers;
+    private readonly sourceUnsubscribers;
+    constructor(source: IOIMOrderedListCommandSource<TKey, TIn>, opts: TOIMOrderedListMapOptions<TIn, TOut>);
+    subscribeCommands(key: TKey, handler: () => void): () => void;
+    consumeCommands(key: TKey): TOIMOrderedListCommand<TOut>[];
+    getItemsByKey(key: TKey): readonly TOut[];
+    /** Map this source again, chaining the projection. */
+    map<TNext>(opts: TOIMOrderedListMapOptions<TOut, TNext>): OIMOrderedListMappedCommandStream<TKey, TNext, TOut>;
+    destroy(): void;
+    /** Build the initial mirror and subscribe to the source once per key. */
+    private ensureWired;
+    private onSourceCommands;
+}
+
+/**
+ * Map an ordered-list command source element-wise. The result is itself a
+ * source, so it can be mapped again (or via its `.map()` method).
+ *
+ * ```ts
+ * const nodes = createOIMOrderedListMappedCommandStream(stream, {
+ *     create: (slot) => engine.makeNode(slot.item),
+ *     destroy: (node) => engine.dropNode(node),
+ * });
+ * nodes.subscribeCommands(key, () =>
+ *     engine.apply(nodes.consumeCommands(key))
+ * );
+ * ```
+ */
+declare function createOIMOrderedListMappedCommandStream<TKey extends TOIMPk, TIn, TOut>(source: IOIMOrderedListCommandSource<TKey, TIn>, opts: TOIMOrderedListMapOptions<TIn, TOut>): OIMOrderedListMappedCommandStream<TKey, TOut, TIn>;
+
 /**
  * Animation frame-based scheduler that executes flushes synchronized with the browser's repaint cycle.
  * Ideal for UI-related updates that need to be synchronized with rendering.
@@ -1690,4 +1858,4 @@ declare class OIMEntitiesByIndexKeyArrayBasedSelector<TEntity extends object, TP
     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 IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMSubscribable, OIMCarrierKeyedEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, 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 TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit };
+export { EOIMCollectionEventType, EOIMComputedEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMObjectEventType, type IOIMCarrierResolver, type IOIMComputedEventSource, type IOIMEffectDependency, type IOIMEventQueueSchedulerEvents, type IOIMIndexStore, type IOIMKeyedUpdateEmitter, type IOIMOrderedListCommandSource, type IOIMSubscribable, OIMCarrierKeyedEmitter, OIMCollection, OIMCollectionByPkSelector, OIMCollectionByPksSelector, OIMCollectionChangedFields, OIMCollectionIndexFactory, OIMCollectionIndexManualOrderedArrayBased, OIMCollectionOrderedListCommandStream, OIMCollectionSelectors, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMComputeRuntime, OIMComputed, OIMDBSettings, OIMDerivedCollectionIndexArrayBased, OIMDerivedCollectionIndexSetBased, OIMEffect, OIMEffectDependencyComputed, OIMEffectDependencyKeyed, OIMEffectDependencyKeyedCollection, OIMEffectDependencyKeyedIndex, OIMEffectDependencyKeyedObject, OIMEntitiesByIndexKeyArrayBasedSelector, OIMEntitiesByIndexKeySetBasedSelector, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexArrayBased, OIMIndexComparatorFactory, OIMIndexManualArrayBased, OIMIndexManualOrderedArrayBased, OIMIndexManualSetBased, OIMIndexPksByKeyArrayBasedSelector, OIMIndexPksByKeySetBasedSelector, OIMIndexPksByKeysArrayBasedSelector, OIMIndexPksByKeysSetBasedSelector, OIMIndexSetBased, OIMIndexStoreArrayBased, OIMIndexStoreMapDrivenArrayBased, OIMIndexStoreMapDrivenSetBased, OIMIndexStoreSetBased, OIMMap2Keys, OIMObject, OIMObjectStore, OIMObjectStoreMapDriven, OIMObjectStoreRecordDriven, OIMObjectValueByKeySelector, OIMObjectValuesByKeysSelector, OIMOrderedListCommandStream, OIMOrderedListMappedCommandStream, OIMPkSelectorFactory, OIMReactiveCollection, OIMReactiveCollectionIndexManualArrayBased, OIMReactiveCollectionIndexManualSetBased, OIMReactiveIndex, OIMReactiveIndexArrayBased, OIMReactiveIndexManualArrayBased, OIMReactiveIndexManualSetBased, OIMReactiveIndexSetBased, OIMReactiveObject, OIMSelector, type TOIMAnyEntitySlot, type TOIMCollectionEntitiesSelector, type TOIMCollectionEntitySelector, type TOIMCollectionIndexArrayBasedOptions, type TOIMCollectionIndexSetBasedOptions, type TOIMCollectionKit, type TOIMCollectionOptions, type TOIMCollectionOrderedIndexOptions, type TOIMCollectionOrderedListCommandStreamOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMComputedOptions, type TOIMComputedUpdatePayload, 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 TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptionsArrayBased, type TOIMIndexOptionsSetBased, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMObjectOptions, type TOIMOrderedListCommand, type TOIMOrderedListMapOptions, type TOIMPk, type TOIMPkSelector, type TOIMReactiveCollectionFactoryOptions, type TOIMRelationsArrayIndexOptions, type TOIMRelationsDerivedArrayIndexOptions, type TOIMRelationsDerivedSetIndexOptions, type TOIMRelationsOrderedListOptions, type TOIMRelationsSetIndexOptions, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdatePayload, createInPlaceEntityUpdater, createMergeEntityUpdater, createOIMCollectionIndexFactory, createOIMCollectionKit, createOIMOrderedListMappedCommandStream };