@wszerad/items 0.1.1 → 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,87 @@
+//#region src/select.d.ts
+
+declare class BaseSelect<E> {
+  ids: ItemId[];
+  self: Items<E>;
+  constructor(ids: ItemId[], self: Items<E>);
+}
+declare class SingleSelect<E> extends BaseSelect<E> {}
+declare class Select<E> extends BaseSelect<E> {
+  take(len: number): Select<E>;
+  skip(len: number): Select<E>;
+  filter(testFn: (entry: E, id: ItemId, index: number) => boolean): Select<E>;
+  revert(): Select<E>;
+  sort(sortFn: (x: E, y: E) => number): Select<E>;
+  at(index: number): SingleSelect<E>;
+  from(entities: Iterable<E>): Select<E>;
+  on(entry: E): SingleSelect<E>;
+}
+//#endregion
+//#region src/types.d.ts
+type ItemId = string | number;
+type CheckFn<E> = (entity: E) => boolean;
+type Selector<E> = ((selector: Select<E>) => SingleSelect<E>) | ((selector: Select<E>) => Select<E>) | ItemId | Iterable<ItemId>;
+type UpdateFn<E> = (entity: E | undefined) => E;
+type Updater<E> = UpdateFn<E> | Partial<E>;
+type SelectId<E> = (entity: E) => ItemId;
+type ItemsOptions<E> = {
+  selectId?: SelectId<E>;
+  sortComparer?: false | ((a: E, b: E) => number);
+};
+interface ItemsState<E, I> {
+  ids: I[];
+  entities: Map<I, E>;
+}
+interface ItemDiff {
+  id: ItemId;
+  changes: any[];
+}
+interface ItemsDiff {
+  added: ItemId[];
+  removed: ItemId[];
+  updated: ItemDiff[];
+}
+//#endregion
+//#region src/Items.d.ts
+declare class Items<E> {
+  private options;
+  private state;
+  constructor(items?: Iterable<E>, options?: ItemsOptions<E>);
+  add(items: Iterable<E>): Items<E>;
+  update(select: Selector<E>, updater: Updater<E>): Items<E>;
+  merge(items: Iterable<E>): Items<E>;
+  remove(select: Selector<E>): Items<E>;
+  pick(select: Selector<E>): Items<E>;
+  select(select: ItemId): E | undefined;
+  select(select: Iterable<ItemId>): E[];
+  select(select: (selector: Select<E>) => Select<E>): E[];
+  select(select: (selector: Select<E>) => SingleSelect<E>): E | undefined;
+  selectId(select: (selector: Select<E>) => Select<E>): ItemId[];
+  selectId(select: (selector: Select<E>) => SingleSelect<E>): ItemId | undefined;
+  clear(): Items<E>;
+  every(check: CheckFn<E>): boolean;
+  some(check: CheckFn<E>): boolean;
+  has(id: ItemId): boolean;
+  get(id: ItemId): E | undefined;
+  getIds(): ItemId[];
+  getEntities(): E[];
+  get length(): number;
+  private resolveSelector;
+  private sortIds;
+  extractId(entity: E): ItemId;
+  private get sortComparer();
+  [Symbol.iterator](): Iterator<E>;
+  static compare<E>(base: Items<E>, to: Items<E>): {
+    added: ItemId[];
+    removed: ItemId[];
+    updated: any[];
+  };
+}
+//#endregion
+//#region src/utils.d.ts
+declare function defaultSelectId<E extends {
+  id: ItemId;
+}>(entity: E): ItemId;
+//#endregion
+export { BaseSelect, type CheckFn, type ItemDiff, type ItemId, Items, type ItemsDiff, type ItemsOptions, type ItemsState, Select, type SelectId, type Selector, SingleSelect, type UpdateFn, type Updater, defaultSelectId };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,193 @@
+import { diff } from "ohash/utils";
+
+//#region src/utils.ts
+function defaultSelectId(entity) {
+	return entity.id;
+}
+
+//#endregion
+//#region src/select.ts
+var BaseSelect = class {
+	constructor(ids, self) {
+		this.ids = ids;
+		this.self = self;
+	}
+};
+var SingleSelect = class extends BaseSelect {};
+var Select = class Select extends BaseSelect {
+	take(len) {
+		return new Select(this.ids.slice(0, len), this.self);
+	}
+	skip(len) {
+		return new Select(this.ids.slice(len), this.self);
+	}
+	filter(testFn) {
+		return new Select(this.ids.filter((id, index) => {
+			return testFn(this.self.get(id), id, index);
+		}), this.self);
+	}
+	revert() {
+		return new Select([...this.ids].reverse(), this.self);
+	}
+	sort(sortFn) {
+		return new Select([...this.ids].sort((aId, bId) => {
+			return sortFn(this.self.get(aId), this.self.get(bId));
+		}), this.self);
+	}
+	at(index) {
+		const id = this.ids[index];
+		return new SingleSelect([id], this.self);
+	}
+	from(entities) {
+		return new Select(Array.from(entities).map((entry) => this.self.extractId(entry)), this.self);
+	}
+	on(entry) {
+		return new SingleSelect([this.self.extractId(entry)], this.self);
+	}
+};
+
+//#endregion
+//#region src/diff.ts
+function itemsDiff(fromItems, toItems) {
+	const ids = new Set(toItems.getIds());
+	const baseIds = new Set(fromItems.getIds());
+	const added = [];
+	const updated = [];
+	ids.forEach((id) => {
+		if (!baseIds.has(id)) added.push(id);
+		else {
+			const changes = diff(fromItems.select(id), toItems.select(id));
+			if (changes.length > 0) updated.push({
+				id,
+				changes
+			});
+			baseIds.delete(id);
+		}
+	});
+	return {
+		added,
+		removed: [...baseIds],
+		updated
+	};
+}
+
+//#endregion
+//#region src/Items.ts
+var Items = class Items {
+	state;
+	constructor(items = [], options = {}) {
+		this.options = options;
+		const entities = new Map(Array.from(items).map((item) => {
+			return [this.extractId(item), item];
+		}));
+		this.state = {
+			ids: this.sortIds([...entities.keys()], entities),
+			entities
+		};
+	}
+	add(items) {
+		const newEntities = new Map(this.state.entities);
+		Array.from(items).forEach((item) => {
+			const id = this.extractId(item);
+			if (!newEntities.has(id)) newEntities.set(id, item);
+		});
+		return new Items(newEntities.values(), this.options);
+	}
+	update(select, updater) {
+		const [, selectedIds] = this.resolveSelector(select);
+		const newEntities = new Map(this.state.entities);
+		const isFn = typeof updater === "function";
+		selectedIds.forEach((id) => {
+			const entity = newEntities.get(id);
+			if (isFn) newEntities.set(id, updater(entity));
+			else if (entity) newEntities.set(id, {
+				...entity,
+				...updater
+			});
+		});
+		return new Items(newEntities.values(), this.options);
+	}
+	merge(items) {
+		const newEntities = new Map(this.state.entities);
+		Array.from(items).forEach((item) => {
+			const id = this.extractId(item);
+			const entry = this.get(id);
+			newEntities.set(id, entry ? {
+				...entry,
+				...item
+			} : item);
+		});
+		return new Items(newEntities.values(), this.options);
+	}
+	remove(select) {
+		const [, selectedIds] = this.resolveSelector(select);
+		return new Items(this.state.ids.filter((id) => !selectedIds.includes(id)).map((id) => this.get(id)), this.options);
+	}
+	pick(select) {
+		const [, selectedIds] = this.resolveSelector(select);
+		return new Items(selectedIds.map((id) => this.get(id)), this.options);
+	}
+	select(select) {
+		const [single, selectedIds] = this.resolveSelector(select);
+		const items = selectedIds.map((id) => this.get(id)).filter(Boolean);
+		return single ? items[0] : items;
+	}
+	selectId(select) {
+		const [single, selectedIds] = this.resolveSelector(select);
+		return single ? selectedIds[0] : selectedIds;
+	}
+	clear() {
+		return new Items([], this.options);
+	}
+	every(check) {
+		return this.getIds().every((id) => check(this.get(id)));
+	}
+	some(check) {
+		return this.getIds().some((id) => check(this.get(id)));
+	}
+	has(id) {
+		return this.state.ids.includes(id);
+	}
+	get(id) {
+		return this.state.entities.get(id);
+	}
+	getIds() {
+		return [...this.state.ids];
+	}
+	getEntities() {
+		return this.state.ids.map((id) => this.get(id));
+	}
+	get length() {
+		return this.state.ids.length;
+	}
+	resolveSelector(select) {
+		if (typeof select === "function") {
+			const result = select(new Select(this.state.ids, this));
+			return [result instanceof SingleSelect, result.ids];
+		} else if (typeof select === "string" || typeof select === "number") return [true, [select]];
+		else return [false, Array.from(select)];
+	}
+	sortIds(ids, entities) {
+		if (this.sortComparer === false) return ids;
+		const sorter = this.sortComparer;
+		return [...ids].sort((aId, bId) => {
+			return sorter(entities.get(aId), entities.get(bId));
+		});
+	}
+	extractId(entity) {
+		return this.options?.selectId?.(entity) || defaultSelectId(entity);
+	}
+	get sortComparer() {
+		return this.options.sortComparer || false;
+	}
+	[Symbol.iterator]() {
+		return this.state.entities.values();
+	}
+	static compare(base, to) {
+		return itemsDiff(base, to);
+	}
+};
+
+//#endregion
+export { BaseSelect, Items, Select, SingleSelect, defaultSelectId };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["ids: ItemId[]","self: Items<E>","added: ItemId[]","updated: any[]","options: ItemsOptions<E>"],"sources":["../src/utils.ts","../src/select.ts","../src/diff.ts","../src/Items.ts"],"sourcesContent":["import type { ItemId } from './types'\nexport function defaultSelectId<E extends { id: ItemId }>(entity: E): ItemId {\n  return entity.id\n}\n","import type { ItemId } from './types'\nimport type { Items } from './Items'\n\nexport class BaseSelect<E> {\n  constructor(\n    public ids: ItemId[],\n    public self: Items<E>\n  ) {}\n}\n\nexport class SingleSelect<E> extends BaseSelect<E> {}\n\nexport class Select<E> extends BaseSelect<E> {\n  take(len: number): Select<E> {\n    return new Select(this.ids.slice(0, len), this.self)\n  }\n\n  skip(len: number): Select<E> {\n    return new Select(this.ids.slice(len), this.self)\n  }\n\n  filter(testFn: (entry: E, id: ItemId, index: number) => boolean): Select<E> {\n    const filteredIds = this.ids.filter((id, index) => {\n      const entry = this.self.get(id)!\n      return testFn(entry, id, index)\n    })\n    return new Select(filteredIds, this.self)\n  }\n\n  revert(): Select<E> {\n    return new Select([...this.ids].reverse(), this.self)\n  }\n\n  sort(sortFn: (x: E, y: E) => number): Select<E> {\n    const sortedIds = [...this.ids].sort((aId, bId) => {\n      const a = this.self.get(aId)!\n      const b = this.self.get(bId)!\n      return sortFn(a, b)\n    })\n    return new Select(sortedIds, this.self)\n  }\n\n  at(index: number): SingleSelect<E> {\n    const id = this.ids[index]\n    return new SingleSelect([id], this.self)\n  }\n\n  from(entities: Iterable<E>): Select<E> {\n    const newIds = Array.from(entities).map(entry => this.self.extractId(entry))\n    return new Select(newIds, this.self)\n  }\n\n  on(entry: E): SingleSelect<E> {\n    const id = this.self.extractId(entry)\n    return new SingleSelect([id], this.self)\n  }\n}\n","import type { ItemId } from './types'\nimport { Items } from './Items'\nimport { diff} from 'ohash/utils'\n\nexport function itemsDiff<E>(fromItems: Items<E>, toItems: Items<E>) {\n  const ids = new Set(toItems.getIds())\n  const baseIds = new Set(fromItems.getIds())\n\n  const added: ItemId[] = []\n  const updated: any[] = []\n\n  ids.forEach(id => {\n    if (!baseIds.has(id)) {\n      added.push(id)\n    } else {\n      const changes = diff(fromItems.select(id), toItems.select(id))\n\n      if (changes.length > 0) {\n        updated.push({ id, changes })\n      }\n\n      baseIds.delete(id)\n    }\n  })\n\n  const removed = [...baseIds]\n\n  return {\n    added,\n    removed,\n    updated\n  }\n}\n","import type { CheckFn, ItemId, ItemsOptions, ItemsState, Selector, Updater } from './types'\nimport { defaultSelectId } from './utils'\nimport { Select, SingleSelect } from './select'\nimport { itemsDiff } from './diff'\n\nexport class Items<E> {\n  private state: ItemsState<E, ItemId>\n\n  constructor(\n    items: Iterable<E> = [],\n    private options: ItemsOptions<E> = {}\n  ) {\n    const entities = new Map(\n      Array\n        .from(items)\n        .map((item) => {\n          const id = this.extractId(item)\n          return [id, item]\n        })\n    )\n\n    this.state = {\n      ids: this.sortIds([...entities.keys()], entities),\n      entities\n    }\n  }\n\n  // NOTE: Add item if id not exists\n  add(items: Iterable<E>): Items<E> {\n    const newEntities = new Map(this.state.entities)\n\n    Array.from(items).forEach((item) => {\n      const id = this.extractId(item)\n      if (!newEntities.has(id)) {\n        newEntities.set(id, item)\n      }\n    })\n\n    return new Items<E>(newEntities.values(), this.options)\n  }\n\n  // NOTE: update selected ids with partial data or call function (even if selected id not exists)\n  update(select: Selector<E>, updater: Updater<E>): Items<E> {\n    const [, selectedIds] = this.resolveSelector(select)\n    const newEntities = new Map(this.state.entities)\n    const isFn = typeof updater === 'function'\n\n    selectedIds\n      .forEach((id) => {\n        const entity = newEntities.get(id)\n\n        if (isFn) {\n          newEntities.set(id, updater(entity))\n        } else if (entity) {\n          newEntities.set(id, { ...entity, ...updater })\n        }\n      })\n\n    return new Items<E>(newEntities.values(), this.options)\n  }\n\n  // NOTE: add if not exists, overwrite if exists\n  merge(items: Iterable<E>): Items<E> {\n    const newEntities = new Map(this.state.entities)\n\n    Array.from(items).forEach((item) => {\n      const id = this.extractId(item)\n      const entry = this.get(id)\n      newEntities.set(id, entry ? { ...entry, ...item } : item)\n    })\n\n    return new Items<E>(newEntities.values(), this.options)\n  }\n\n  remove(select: Selector<E>): Items<E> {\n    const [, selectedIds] = this.resolveSelector(select)\n    const idsToKeep = this.state.ids.filter(id => !selectedIds.includes(id))\n    const items = idsToKeep.map(id => this.get(id)!)\n    return new Items<E>(items, this.options)\n  }\n\n  pick(select: Selector<E>): Items<E> {\n    const [, selectedIds] = this.resolveSelector(select)\n    const items = selectedIds.map(id => this.get(id)!)\n    return new Items<E>(items, this.options)\n  }\n\n  select(select: ItemId): E | undefined\n  select(select: Iterable<ItemId>): E[]\n  select(select: (selector: Select<E>) => Select<E>): E[]\n  select(select: (selector: Select<E>) => SingleSelect<E>): E | undefined\n  select(select: Selector<E>): undefined | E | E[] {\n    const [single, selectedIds] = this.resolveSelector(select)\n    const items = selectedIds.map(id => this.get(id)).filter(Boolean) as E[]\n    return single ? items[0] : items\n  }\n\n  selectId(select: (selector: Select<E>) => Select<E>): ItemId[]\n  selectId(select: (selector: Select<E>) => SingleSelect<E>): ItemId | undefined\n  selectId(select: Selector<E>): undefined | ItemId | ItemId[] {\n    const [single, selectedIds] = this.resolveSelector(select)\n    return single ? selectedIds[0] : selectedIds\n  }\n\n  clear(): Items<E> {\n    return new Items<E>([], this.options)\n  }\n\n  every(check: CheckFn<E>) {\n    return this.getIds().every(id => check(this.get(id)!))\n  }\n\n  some(check: CheckFn<E>) {\n    return this.getIds().some(id => check(this.get(id)!))\n  }\n\n  has(id: ItemId) {\n    return this.state.ids.includes(id)\n  }\n\n  get(id: ItemId): E | undefined {\n    return this.state.entities.get(id)\n  }\n\n  getIds(): ItemId[] {\n    return [...this.state.ids]\n  }\n\n  getEntities(): E[] {\n    return this.state.ids.map(id => this.get(id)!)\n  }\n\n  get length(): number {\n    return this.state.ids.length\n  }\n\n  private resolveSelector(select: Selector<E>): [boolean, ItemId[]]{\n    if (typeof select === 'function') {\n      const newSelect = new Select(this.state.ids, this)\n      const result = select(newSelect)\n      return [result instanceof SingleSelect, result.ids]\n    } else if (typeof select === 'string' || typeof select === 'number') {\n      return [true, [select]]\n    } else {\n      return [false, Array.from(select)]\n    }\n  }\n\n  private sortIds(\n    ids: ItemId[],\n    entities: Map<ItemId, E>\n  ): Array<ItemId> {\n    if (this.sortComparer === false) {\n      return ids\n    }\n    const sorter = this.sortComparer\n    return [...ids].sort((aId, bId) => {\n      const a = entities.get(aId)!\n      const b = entities.get(bId)!\n      return sorter(a, b)\n    })\n  }\n\n  extractId(entity: E): ItemId {\n    return this.options?.selectId?.(entity) as undefined || defaultSelectId(entity as E & { id: ItemId })\n  }\n\n  private get sortComparer() {\n    return this.options.sortComparer || false\n  }\n\n  [Symbol.iterator](): Iterator<E> {\n    return this.state.entities.values()\n  }\n\n  static compare<E>(base: Items<E>, to: Items<E>) {\n    return itemsDiff(base, to)\n  }\n}\n\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wszerad/items",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.mjs",
@@ -9,6 +9,9 @@
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
   "engines": {
     "node": ">=20"
   },

package/.github/dependabot.yml

@@ -1,15 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
-
-version: 2
-updates:
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: npm
-    directory: "/"
-    schedule:
-      interval: "weekly"

package/.github/workflows/publish.yml

@@ -1,22 +0,0 @@
-name: Publish
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  publish-chain:
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-      contents: read
-      packages: write
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: "24"
-      - run: npm ci
-      - run: npm test
-      - run: npm run build
-      - run: npm publish --access public

package/.github/workflows/test.yml

@@ -1,21 +0,0 @@
-name: Test
-
-on:
-  pull_request:
-    branches:
-      - master
-  push:
-    branches:
-      - master
-
-jobs:
-  test:
-    name: Run tests for each push
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: "22"
-      - run: npm ci
-      - run: npm test

package/.idea/copilot.data.migration.ask2agent.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Ask2AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/items.iml" filepath="$PROJECT_DIR$/.idea/items.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-  </component>
-</project>

package/.oxlintrc.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
-  "env": {
-    "es2022": true,
-    "node": true
-  },
-  "plugins": ["typescript"],
-  "rules": {
-    "eslint/no-unused-vars": "error",
-    "typescript/no-explicit-any": "warn"
-  }
-}
-

package/src/Items.ts

@@ -1,215 +0,0 @@
-import { defaultSelectId, SelectId, StrOrNum } from './selectId'
-import { selector, Selector, SelectorFn } from './selector'
-import { Updater } from './updater'
-import { itemsDiff } from './diff'
-import { update } from './updater'
-
-export type ItemsOptions<E> = {
-  selectId?: SelectId<E>
-  sortComparer?: false | ((a: E, b: E) => number)
-}
-
-export interface ItemsState<E, I> {
-  ids: I[]
-  entities: Map<I, E>
-}
-
-export class Items<E, I extends StrOrNum = StrOrNum> {
-  private state: ItemsState<E, I>
-
-  constructor(
-    items: Iterable<E> = [],
-    private options: ItemsOptions<E> = {}
-  ) {
-    const entities = new Map(
-      Array
-        .from(items)
-        .map((item) => {
-          const id = this.selectId(item)
-          return [id, item]
-        })
-    )
-
-    this.state = {
-      ids: this.sortIds([...entities.keys()], entities),
-      entities
-    }
-  }
-
-  getIds(): I[] {
-    return [...this.state.ids]
-  }
-
-  getEntities(): Map<I, E> {
-    return new Map(this.state.entities)
-  }
-
-  get length(): number {
-    return this.state.ids.length
-  }
-
-  select(id: I): E | undefined {
-    return this.state.entities.get(id)
-  }
-
-  insert(entity: E) {
-    return this.insertMany([entity])
-  }
-
-  insertMany(entities: Iterable<E>) {
-    return new Items<E, I>([
-      ...this,
-      ...Array.from(entities).filter(entity => !this.has(this.selectId(entity)))
-    ], this.options)
-  }
-
-  upsert(entity: Partial<E>) {
-    return this.upsertMany([entity])
-  }
-
-  upsertMany(entities: Iterable<Partial<E>>) {
-    const clone = this.getEntities()
-    Array.from(entities).forEach(entity => {
-      const id = this.selectId(entity as E)
-      const existing = clone.get(id)
-      if (existing) {
-        clone.set(id, { ...existing, ...entity } as E)
-      } else {
-        clone.set(id, entity as E)
-      }
-    })
-    return new Items<E, I>(clone.values(), this.options)
-  }
-
-  set(entity: E) {
-    return this.setMany([entity])
-  }
-
-  setMany(entities: Iterable<E>) {
-    return new Items<E, I>([
-      ...this,
-      ...entities
-    ], this.options)
-  }
-
-  every(check: SelectorFn<E>) {
-    return this.getIds().every(id => check(this.select(id)!))
-  }
-
-  some(check: SelectorFn<E>) {
-    return this.getIds().some(id => check(this.select(id)!))
-  }
-
-  has(id: I) {
-    return this.state.ids.includes(id)
-  }
-
-  hasMany(select: Selector<E, I>) {
-    let failToFind = false
-    let result = false
-    selector(this, select, (entity) => {
-      if (entity) {
-        result = true
-      } else {
-        failToFind = true
-      }
-    })
-    return !failToFind && result
-  }
-
-  update(id: I, updater: Updater<E>) {
-    const entity = this.select(id)
-    if (!entity) {
-      return this
-    }
-    const clone = this.getEntities()
-    clone.set(id, update(entity, updater))
-    return new Items<E, I>(clone.values(), this.options)
-  }
-
-  updateMany(select: Selector<E, I>, updater: Updater<E>) {
-    const clone = this.getEntities()
-    selector(this, select, (entity, id) => {
-      if (entity) {
-        clone.set(id, update(entity, updater))
-      }
-    })
-    return new Items<E, I>(clone.values(), this.options)
-  }
-
-  remove(id: I) {
-    const clone = this.getEntities()
-    clone.delete(id)
-    return new Items<E, I>(clone.values(), this.options)
-  }
-
-  removeMany(select: Selector<E, I>) {
-    const clone = this.getEntities()
-    selector(this, select, (_, id) => {
-      clone.delete(id)
-    })
-    return new Items<E, I>(clone.values(), this.options)
-  }
-
-  clear() {
-    return new Items<E, I>([], this.options)
-  }
-
-  filter(select: Selector<E, I>) {
-    const clone = new Map<I, E>()
-
-    selector(this, select, (entity, id) => {
-      if (entity) {
-        clone.set(id, entity)
-      }
-    })
-
-    return new Items<E, I>(clone.values(), this.options)
-  }
-
-  page(page: number, pageSize: number) {
-    const totalPages = Math.ceil(this.length / pageSize)
-    return {
-      items: this.getIds()
-        .slice(page * pageSize, (page + 1) * pageSize)
-        .map(id => this.select(id)!),
-      page,
-      pageSize,
-      hasNext: page < totalPages - 1,
-      hasPrevious: page > 0,
-      total: this.length,
-      totalPages
-    }
-  }
-
-  diff(base: Items<E, I>) {
-    return itemsDiff(base, this)
-  }
-
-  private sortIds(
-    ids: I[],
-    entities: Map<I, E>
-  ): Array<I> {
-    if (this.sortComparer === false) {
-      return ids
-    }
-    const sorter = this.sortComparer
-    return [...ids].sort((aId, bId) => {
-      const a = entities.get(aId)!
-      const b = entities.get(bId)!
-      return sorter(a, b)
-    })
-  }
-
-  private selectId(entity: E): I {
-    return this.options?.selectId?.(entity) as undefined || defaultSelectId(entity as E & { id: I })
-  }
-
-  private get sortComparer() {
-    return this.options.sortComparer || false
-  }
-
-  [Symbol.iterator](): Iterator<E> {
-    return this.state.entities.values()
-  }
-}

package/src/diff.ts

@@ -1,44 +0,0 @@
-import { diff } from 'ohash/utils'
-import { Items } from './Items'
-import { StrOrNum } from './selectId'
-
-export interface ItemDiff<I> {
-  id: I
-  changes: ReturnType<typeof diff>
-}
-
-export interface ItemsDiff<I> {
-  added: I[]
-  removed: I[]
-  updated: ItemDiff<I>[]
-}
-
-export function itemsDiff<E, I extends StrOrNum>(fromItems: Items<E, I>, toItems: Items<E, I>): ItemsDiff<I> {
-  const ids = new Set(toItems.getIds())
-  const baseIds = new Set(fromItems.getIds())
-
-  const added: I[] = []
-  const updated: ItemDiff<I>[] = []
-
-  ids.forEach(id => {
-    if (!baseIds.has(id)) {
-      added.push(id)
-    } else {
-      const changes = diff(fromItems.select(id), toItems.select(id))
-
-      if (changes.length > 0) {
-        updated.push({ id, changes })
-      }
-
-      baseIds.delete(id)
-    }
-  })
-
-  const removed = [...baseIds]
-
-  return {
-    added,
-    removed,
-    updated
-  }
-}