use-entity 0.0.1-alpha → 0.1.0-alpha

package/README.md

@@ -1,15 +1,100 @@
 # use-entity
 
-To install dependencies:
+Fast, typed entity state for React with minimal boilerplate. Use it to manage
+normalized collections with a ready-to-use hook, selector helpers, and adapter
+actions that stay portable across state managers. Powered by Redux Toolkit's
+[`createEntityAdapter`](https://redux-toolkit.js.org/api/createEntityAdapter).
+
+## Install
 
 ```bash
-bun install
+npm install use-entity
 ```
 
-To run:
+## Quick Start (TanStack React Store)
 
-```bash
-bun run index.ts
+```tsx
+import { createEntityStoreTanstack } from "use-entity";
+
+type Todo = { id: string; title: string; done: boolean };
+
+const { useEntity } = createEntityStoreTanstack<Todo>([
+	{ id: "1", title: "Ship it", done: false },
+]);
+
+function TodoList() {
+	const [state, actions] = useEntity();
+
+	return (
+		<div>
+			<ul>
+				{state.all.map((todo) => (
+					<li key={todo.id}>{todo.title}</li>
+				))}
+			</ul>
+			<button
+				onClick={() =>
+					actions.addOne({ id: "2", title: "Celebrate", done: false })
+				}
+			>
+				Add
+			</button>
+		</div>
+	);
+}
+```
+
+## Selecting State
+
+`useEntity()` returns the full selector object by default. You can also ask for
+a specific selector to reduce re-renders.
+
+```tsx
+const [all] = useEntity("all");
+const [ids] = useEntity("ids");
+const [entities] = useEntity("entities");
+const [total] = useEntity("total");
+const [full] = useEntity("full");
+```
+
+```tsx
+const [state] = useEntity();
+const todo = state.byId("2");
+```
+
+The full selector object looks like:
+
+```ts
+{
+	all: T[];
+	ids: string[];
+	entities: Record<string, T>;
+	total: number;
+	byId: (id: string) => T | undefined;
+}
 ```
 
-This project was created using `bun init` in bun v1.3.6. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+## Actions
+
+All actions mirror Redux Toolkit's entity adapter API
+([docs](https://redux-toolkit.js.org/api/createEntityAdapter#crud-functions)):
+
+```ts
+addOne, addMany,
+setOne, setMany, setAll,
+removeOne, removeMany, removeAll,
+updateOne, updateMany,
+upsertOne, upsertMany
+```
+## Exports
+
+```ts
+createEntityStoreTanstack<T>(initial?: T[])
+entityStoreFactory<T>(initial?: T[])
+getEntityActions<T>(store, adapter)
+```
+
+## Notes
+
+- `T` must include `id: string`.
+- Peer deps: `react`, `@reduxjs/toolkit`, `@tanstack/react-store`, `typescript`.

package/dist/index.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+var toolkit = require('@reduxjs/toolkit');
+var reactStore = require('@tanstack/react-store');
+var react = require('react');
+
+// src/actions.ts
+var getEntityActions = (adapter, setState) => ({
+  setOne: (entity) => setState((prev) => adapter.setOne(prev, entity)),
+  setMany: (entities) => setState((prev) => adapter.setMany(prev, entities)),
+  setAll: (entities) => setState((prev) => adapter.setAll(prev, entities)),
+  addOne: (entity) => setState((prev) => adapter.addOne(prev, entity)),
+  addMany: (entities) => setState((prev) => adapter.addMany(prev, entities)),
+  removeOne: (entityId) => setState((prev) => adapter.removeOne(prev, entityId)),
+  removeMany: (entityIds) => setState((prev) => adapter.removeMany(prev, entityIds)),
+  removeAll: () => setState((prev) => adapter.removeAll(prev)),
+  updateOne: (update) => setState((prev) => adapter.updateOne(prev, update)),
+  updateMany: (updates) => setState((prev) => adapter.updateMany(prev, updates)),
+  upsertOne: (entity) => setState((prev) => adapter.upsertOne(prev, entity)),
+  upsertMany: (entities) => setState((prev) => adapter.upsertMany(prev, entities))
+});
+
+// src/selectors.ts
+var getEntityStateTanstack = (entityState, selectors) => ({
+  all: selectors.selectAll(entityState),
+  byId: (id) => selectors.selectById(entityState, id),
+  ids: selectors.selectIds(entityState),
+  entities: selectors.selectEntities(entityState),
+  total: selectors.selectTotal(entityState)
+});
+var noSelect = (state) => state;
+var getSelectors = (baseSelectors) => ({
+  all: baseSelectors.selectAll,
+  entities: baseSelectors.selectEntities,
+  ids: baseSelectors.selectIds,
+  total: baseSelectors.selectTotal,
+  full: (state) => getEntityStateTanstack(state, baseSelectors)
+});
+
+// src/adapter/tanstack.ts
+var entityStoreFactory = (initialState) => {
+  const adapter = toolkit.createEntityAdapter();
+  const store = new reactStore.Store(
+    initialState ? adapter.setAll(adapter.getInitialState(), initialState) : adapter.getInitialState()
+  );
+  const actions = getEntityActions(adapter, (updater) => store.setState(updater));
+  const selectors = getSelectors(adapter.getSelectors(noSelect));
+  return { store, adapter, selectors, actions };
+};
+var createEntityStoreTanstack = (initialState) => {
+  const { adapter, store, actions, selectors } = entityStoreFactory(initialState);
+  function useEntity(selector = "full") {
+    const entityState = reactStore.useStore(store, selectors[selector]);
+    return [entityState, actions];
+  }
+  return { useEntity, store, actions, adapter };
+};
+var adapterInstance = toolkit.createEntityAdapter();
+function useStateEntity(initialState, selector) {
+  const adapter = adapterInstance;
+  const selectorKey = selector ?? "all";
+  const [state, setState] = react.useState(
+    () => initialState ? adapter.setAll(adapter.getInitialState(), initialState instanceof Function ? initialState() : initialState) : adapter.getInitialState()
+  );
+  const actions = react.useMemo(() => getEntityActions(adapter, setState), [adapter]);
+  const data = react.useMemo(
+    () => getSelectors(adapter.getSelectors(noSelect))[selectorKey](state),
+    [state, adapter.getSelectors, selectorKey]
+  );
+  return [data, actions];
+}
+
+exports.createEntityStoreTanstack = createEntityStoreTanstack;
+exports.entityStoreFactory = entityStoreFactory;
+exports.getEntityActions = getEntityActions;
+exports.useStateEntity = useStateEntity;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/actions.ts","../src/selectors.ts","../src/adapter/tanstack.ts","../src/adapter/useState.ts"],"names":["createEntityAdapter","Store","useStore","useState","useMemo"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { EntityAdapter, EntityState } from \"@reduxjs/toolkit\";\nimport type { EntityStateAdapter, IdItem } from \"./types.ts\";\n\nexport const getEntityActions = <T extends IdItem>(\n\tadapter: EntityAdapter<T, T[\"id\"]>,\n\tsetState: (updater: (prev: EntityState<T, T[\"id\"]>) => EntityState<T, T[\"id\"]>) => void,\n): EntityStateAdapter<T, T[\"id\"]> => ({\n\tsetOne: (entity) => setState((prev) => adapter.setOne(prev, entity)),\n\tsetMany: (entities) => setState((prev) => adapter.setMany(prev, entities)),\n\tsetAll: (entities) => setState((prev) => adapter.setAll(prev, entities)),\n\n\taddOne: (entity) => setState((prev) => adapter.addOne(prev, entity)),\n\taddMany: (entities) => setState((prev) => adapter.addMany(prev, entities)),\n\n\tremoveOne: (entityId) => setState((prev) => adapter.removeOne(prev, entityId)),\n\tremoveMany: (entityIds) => setState((prev) => adapter.removeMany(prev, entityIds)),\n\tremoveAll: () => setState((prev) => adapter.removeAll(prev)),\n\n\tupdateOne: (update) => setState((prev) => adapter.updateOne(prev, update)),\n\tupdateMany: (updates) => setState((prev) => adapter.updateMany(prev, updates)),\n\n\tupsertOne: (entity) => setState((prev) => adapter.upsertOne(prev, entity)),\n\tupsertMany: (entities) => setState((prev) => adapter.upsertMany(prev, entities)),\n});\n","import type { EntitySelectors, EntityState } from \"@reduxjs/toolkit\";\nimport type { EntitySelectorsData, IdItem } from \"./types.ts\";\n\nconst getEntityStateTanstack = <T extends IdItem>(\n\tentityState: EntityState<T, T[\"id\"]>,\n\tselectors: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>,\n): EntitySelectorsData<T, T[\"id\"]> => ({\n\tall: selectors.selectAll(entityState),\n\tbyId: (id) => selectors.selectById(entityState, id),\n\tids: selectors.selectIds(entityState) as T[\"id\"][],\n\tentities: selectors.selectEntities(entityState),\n\ttotal: selectors.selectTotal(entityState),\n});\n\nexport const noSelect = <T>(state: T): T => state;\n\nexport type DataSelectors<T extends IdItem> = {\n\tall: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectAll\"];\n\tentities: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectEntities\"];\n\tids: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectIds\"];\n\ttotal: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectTotal\"];\n\tfull: (state: EntityState<T, T[\"id\"]>) => EntitySelectorsData<T, T[\"id\"]>;\n};\n\nexport const getSelectors = <T extends IdItem>(\n\tbaseSelectors: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>,\n): DataSelectors<T> => ({\n\tall: baseSelectors.selectAll,\n\tentities: baseSelectors.selectEntities,\n\tids: baseSelectors.selectIds,\n\ttotal: baseSelectors.selectTotal,\n\tfull: (state) => getEntityStateTanstack(state, baseSelectors),\n});\n","import { createEntityAdapter, type EntityState } from \"@reduxjs/toolkit\";\nimport { Store, useStore } from \"@tanstack/react-store\";\nimport { getEntityActions } from \"../actions.ts\";\nimport { getSelectors, noSelect } from \"../selectors.ts\";\nimport type { EntityStateAdapter, IdItem } from \"../types.ts\";\n\nexport const entityStoreFactory = <T extends IdItem>(initialState?: T[]) => {\n\tconst adapter = createEntityAdapter<T>();\n\tconst store = new Store(\n\t\tinitialState ? adapter.setAll(adapter.getInitialState(), initialState) : adapter.getInitialState(),\n\t);\n\tconst actions = getEntityActions(adapter, (updater) => store.setState(updater));\n\tconst selectors = getSelectors(adapter.getSelectors<EntityState<T, T[\"id\"]>>(noSelect));\n\treturn { store, adapter, selectors, actions };\n};\nexport const createEntityStoreTanstack = <T extends IdItem>(initialState?: T[]) => {\n\tconst { adapter, store, actions, selectors } = entityStoreFactory(initialState);\n\n\ttype SelectorKey = keyof typeof selectors;\n\ttype SelectorReturn<K extends SelectorKey> = ReturnType<(typeof selectors)[K]>;\n\n\tfunction useEntity(): [SelectorReturn<\"full\">, EntityStateAdapter<T, T[\"id\"]>];\n\tfunction useEntity(selector: \"full\"): [SelectorReturn<\"full\">, EntityStateAdapter<T, T[\"id\"]>];\n\tfunction useEntity<K extends Exclude<SelectorKey, \"full\">>(\n\t\tselector: K,\n\t): [SelectorReturn<K>, EntityStateAdapter<T, T[\"id\"]>];\n\n\tfunction useEntity<K extends SelectorKey>(selector: K = \"full\" as K) {\n\t\tconst entityState = useStore(store, selectors[selector] as () => SelectorReturn<K>);\n\n\t\treturn [entityState, actions] satisfies [SelectorReturn<K>, EntityStateAdapter<T, T[\"id\"]>];\n\t}\n\n\treturn { useEntity, store, actions, adapter };\n};\n","import { createEntityAdapter, type EntityState } from \"@reduxjs/toolkit\";\nimport { useMemo, useState } from \"react\";\nimport { getEntityActions } from \"../actions.ts\";\nimport { type DataSelectors, getSelectors, noSelect } from \"../selectors.ts\";\nimport type { EntityStateAdapter, IdItem, InitialEntityState } from \"../types.ts\";\n\n/**\n * Creates a stable adapter instance outside the hook.\n * Since adapters are stateless configuration objects, we don't need\n * to recreate them or store them in React state.\n */\n// biome-ignore lint/suspicious/noExplicitAny: fine here\nconst adapterInstance = createEntityAdapter<any>();\n\n/**\n * react useState hook integrated with an entity adapter.\n * Provides entity state and actions to manipulate that state.\n *\n * @example\n * const [] = useStateWithEntity<{ id: string; name: string }>();\n * const [] = useStateWithEntity<{ id: string; name: string }>([]);\n * const [] = useStateWithEntity<{ id: string; name: string }>([], \"total\");\n * const [] = useStateWithEntity<{ id: string; name: string }>([], \"full\");\n * const [] = useStateWithEntity([] as { id: string; name: string }[], \"full\");\n * action.addOne({ id: \"1\", name: \"Demo\" });\n */\ntype SelectorKey<T extends IdItem> = keyof DataSelectors<T>;\ntype SelectorReturn<T extends IdItem, K extends SelectorKey<T>> = ReturnType<DataSelectors<T>[K]>;\ntype SelectorOrFull<T extends IdItem, K> = K extends SelectorKey<T> ? K : \"full\";\n\ntype Return<T extends IdItem, S extends SelectorKey<T>> = [SelectorReturn<T, S>, EntityStateAdapter<T, T[\"id\"]>];\n\n// biome-ignore format: no selector => full\nexport function useStateEntity<T extends IdItem>(): Return<T, \"all\">;\n\n// biome-ignore format: initial state  => full selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>): Return<T, \"all\">;\n\n// biome-ignore format: initial state + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"all\"): Return<T, \"all\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"entities\"): Return<T, \"entities\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"ids\"): Return<T, \"ids\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"total\"): Return<T, \"total\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"full\"): Return<T, \"full\">;\n\n//  Keep it short\nexport function useStateEntity<T extends IdItem, K extends SelectorKey<T>>(\n\tinitialState?: InitialEntityState<T>,\n\tselector?: K,\n): [SelectorReturn<T, SelectorOrFull<T, K>>, EntityStateAdapter<T, T[\"id\"]>] {\n\t// Cast the generic adapter for type safety within the hook\n\tconst adapter = adapterInstance as ReturnType<typeof createEntityAdapter<T>>;\n\tconst selectorKey = (selector ?? \"all\") as SelectorKey<T>;\n\n\tconst [state, setState] = useState(() =>\n\t\tinitialState\n\t\t\t? adapter.setAll(adapter.getInitialState(), initialState instanceof Function ? initialState() : initialState)\n\t\t\t: adapter.getInitialState(),\n\t);\n\n\tconst actions = useMemo(() => getEntityActions(adapter, setState), [adapter]);\n\n\tconst data = useMemo(\n\t\t() =>\n\t\t\tgetSelectors(adapter.getSelectors<EntityState<T, T[\"id\"]>>(noSelect))[selectorKey](state) as SelectorReturn<\n\t\t\t\tT,\n\t\t\t\tSelectorOrFull<T, K>\n\t\t\t>,\n\t\t[state, adapter.getSelectors, selectorKey],\n\t);\n\n\treturn [data, actions];\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,89 @@
+import * as _reduxjs_toolkit from '@reduxjs/toolkit';
+import { EntityId, Update, EntityAdapter, EntityState, EntitySelectors } from '@reduxjs/toolkit';
+import { Store } from '@tanstack/react-store';
+
+type IfMaybeUndefined<T, True, False> = [undefined] extends [T] ? True : False;
+declare const testAccess: 0 | undefined;
+type IfUncheckedIndexedAccess<True, False> = IfMaybeUndefined<typeof testAccess, True, False>;
+type UncheckedIndexedAccess<T> = IfUncheckedIndexedAccess<T | undefined, T>;
+
+interface EntityStateAdapter<T, Id extends EntityId> {
+    addOne(entity: T): void;
+    addMany(entities: readonly T[] | Record<Id, T>): void;
+    setOne(entity: T): void;
+    setMany(entities: readonly T[] | Record<Id, T>): void;
+    setAll(entities: readonly T[] | Record<Id, T>): void;
+    removeOne(key: Id): void;
+    removeMany(keys: readonly Id[]): void;
+    removeAll(): void;
+    updateOne(update: Update<T, Id>): void;
+    updateMany(updates: ReadonlyArray<Update<T, Id>>): void;
+    upsertOne(entity: T): void;
+    upsertMany(entities: readonly T[] | Record<Id, T>): void;
+}
+type IdItem = {
+    id: string;
+};
+type InitialEntityState<T extends IdItem> = T[] | Record<T["id"], T> | (() => T[] | Record<T["id"], T>) | undefined;
+type Id<T> = {
+    [K in keyof T]: T[K];
+} & {};
+interface EntitySelectorsData<T, IdType extends EntityId> {
+    ids: IdType[];
+    entities: Record<IdType, T>;
+    all: T[];
+    total: number;
+    byId: (id: IdType) => Id<UncheckedIndexedAccess<T>>;
+}
+
+declare const getEntityActions: <T extends IdItem>(adapter: EntityAdapter<T, T["id"]>, setState: (updater: (prev: EntityState<T, T["id"]>) => EntityState<T, T["id"]>) => void) => EntityStateAdapter<T, T["id"]>;
+
+type DataSelectors<T extends IdItem> = {
+    all: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectAll"];
+    entities: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectEntities"];
+    ids: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectIds"];
+    total: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectTotal"];
+    full: (state: EntityState<T, T["id"]>) => EntitySelectorsData<T, T["id"]>;
+};
+
+declare const entityStoreFactory: <T extends IdItem>(initialState?: T[]) => {
+    store: Store<EntityState<T, T["id"]>, (cb: EntityState<T, T["id"]>) => EntityState<T, T["id"]>>;
+    adapter: _reduxjs_toolkit.EntityAdapter<T, T["id"]>;
+    selectors: DataSelectors<T>;
+    actions: EntityStateAdapter<T, T["id"]>;
+};
+declare const createEntityStoreTanstack: <T extends IdItem>(initialState?: T[]) => {
+    useEntity: {
+        (): [EntitySelectorsData<T, T["id"]>, EntityStateAdapter<T, T["id"]>];
+        (selector: "full"): [EntitySelectorsData<T, T["id"]>, EntityStateAdapter<T, T["id"]>];
+        <K extends Exclude<keyof DataSelectors<T>, "full">>(selector: K): [ReturnType<DataSelectors<T>[K]>, EntityStateAdapter<T, T["id"]>];
+    };
+    store: Store<EntityState<T, T["id"]>, (cb: EntityState<T, T["id"]>) => EntityState<T, T["id"]>>;
+    actions: EntityStateAdapter<T, T["id"]>;
+    adapter: _reduxjs_toolkit.EntityAdapter<T, T["id"]>;
+};
+
+/**
+ * react useState hook integrated with an entity adapter.
+ * Provides entity state and actions to manipulate that state.
+ *
+ * @example
+ * const [] = useStateWithEntity<{ id: string; name: string }>();
+ * const [] = useStateWithEntity<{ id: string; name: string }>([]);
+ * const [] = useStateWithEntity<{ id: string; name: string }>([], "total");
+ * const [] = useStateWithEntity<{ id: string; name: string }>([], "full");
+ * const [] = useStateWithEntity([] as { id: string; name: string }[], "full");
+ * action.addOne({ id: "1", name: "Demo" });
+ */
+type SelectorKey<T extends IdItem> = keyof DataSelectors<T>;
+type SelectorReturn<T extends IdItem, K extends SelectorKey<T>> = ReturnType<DataSelectors<T>[K]>;
+type Return<T extends IdItem, S extends SelectorKey<T>> = [SelectorReturn<T, S>, EntityStateAdapter<T, T["id"]>];
+declare function useStateEntity<T extends IdItem>(): Return<T, "all">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>): Return<T, "all">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "all"): Return<T, "all">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "entities"): Return<T, "entities">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "ids"): Return<T, "ids">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "total"): Return<T, "total">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "full"): Return<T, "full">;
+
+export { createEntityStoreTanstack, entityStoreFactory, getEntityActions, useStateEntity };

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import * as _reduxjs_toolkit from '@reduxjs/toolkit';
+import { EntityId, Update, EntityAdapter, EntityState, EntitySelectors } from '@reduxjs/toolkit';
+import { Store } from '@tanstack/react-store';
+
+type IfMaybeUndefined<T, True, False> = [undefined] extends [T] ? True : False;
+declare const testAccess: 0 | undefined;
+type IfUncheckedIndexedAccess<True, False> = IfMaybeUndefined<typeof testAccess, True, False>;
+type UncheckedIndexedAccess<T> = IfUncheckedIndexedAccess<T | undefined, T>;
+
+interface EntityStateAdapter<T, Id extends EntityId> {
+    addOne(entity: T): void;
+    addMany(entities: readonly T[] | Record<Id, T>): void;
+    setOne(entity: T): void;
+    setMany(entities: readonly T[] | Record<Id, T>): void;
+    setAll(entities: readonly T[] | Record<Id, T>): void;
+    removeOne(key: Id): void;
+    removeMany(keys: readonly Id[]): void;
+    removeAll(): void;
+    updateOne(update: Update<T, Id>): void;
+    updateMany(updates: ReadonlyArray<Update<T, Id>>): void;
+    upsertOne(entity: T): void;
+    upsertMany(entities: readonly T[] | Record<Id, T>): void;
+}
+type IdItem = {
+    id: string;
+};
+type InitialEntityState<T extends IdItem> = T[] | Record<T["id"], T> | (() => T[] | Record<T["id"], T>) | undefined;
+type Id<T> = {
+    [K in keyof T]: T[K];
+} & {};
+interface EntitySelectorsData<T, IdType extends EntityId> {
+    ids: IdType[];
+    entities: Record<IdType, T>;
+    all: T[];
+    total: number;
+    byId: (id: IdType) => Id<UncheckedIndexedAccess<T>>;
+}
+
+declare const getEntityActions: <T extends IdItem>(adapter: EntityAdapter<T, T["id"]>, setState: (updater: (prev: EntityState<T, T["id"]>) => EntityState<T, T["id"]>) => void) => EntityStateAdapter<T, T["id"]>;
+
+type DataSelectors<T extends IdItem> = {
+    all: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectAll"];
+    entities: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectEntities"];
+    ids: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectIds"];
+    total: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>["selectTotal"];
+    full: (state: EntityState<T, T["id"]>) => EntitySelectorsData<T, T["id"]>;
+};
+
+declare const entityStoreFactory: <T extends IdItem>(initialState?: T[]) => {
+    store: Store<EntityState<T, T["id"]>, (cb: EntityState<T, T["id"]>) => EntityState<T, T["id"]>>;
+    adapter: _reduxjs_toolkit.EntityAdapter<T, T["id"]>;
+    selectors: DataSelectors<T>;
+    actions: EntityStateAdapter<T, T["id"]>;
+};
+declare const createEntityStoreTanstack: <T extends IdItem>(initialState?: T[]) => {
+    useEntity: {
+        (): [EntitySelectorsData<T, T["id"]>, EntityStateAdapter<T, T["id"]>];
+        (selector: "full"): [EntitySelectorsData<T, T["id"]>, EntityStateAdapter<T, T["id"]>];
+        <K extends Exclude<keyof DataSelectors<T>, "full">>(selector: K): [ReturnType<DataSelectors<T>[K]>, EntityStateAdapter<T, T["id"]>];
+    };
+    store: Store<EntityState<T, T["id"]>, (cb: EntityState<T, T["id"]>) => EntityState<T, T["id"]>>;
+    actions: EntityStateAdapter<T, T["id"]>;
+    adapter: _reduxjs_toolkit.EntityAdapter<T, T["id"]>;
+};
+
+/**
+ * react useState hook integrated with an entity adapter.
+ * Provides entity state and actions to manipulate that state.
+ *
+ * @example
+ * const [] = useStateWithEntity<{ id: string; name: string }>();
+ * const [] = useStateWithEntity<{ id: string; name: string }>([]);
+ * const [] = useStateWithEntity<{ id: string; name: string }>([], "total");
+ * const [] = useStateWithEntity<{ id: string; name: string }>([], "full");
+ * const [] = useStateWithEntity([] as { id: string; name: string }[], "full");
+ * action.addOne({ id: "1", name: "Demo" });
+ */
+type SelectorKey<T extends IdItem> = keyof DataSelectors<T>;
+type SelectorReturn<T extends IdItem, K extends SelectorKey<T>> = ReturnType<DataSelectors<T>[K]>;
+type Return<T extends IdItem, S extends SelectorKey<T>> = [SelectorReturn<T, S>, EntityStateAdapter<T, T["id"]>];
+declare function useStateEntity<T extends IdItem>(): Return<T, "all">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>): Return<T, "all">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "all"): Return<T, "all">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "entities"): Return<T, "entities">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "ids"): Return<T, "ids">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "total"): Return<T, "total">;
+declare function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: "full"): Return<T, "full">;
+
+export { createEntityStoreTanstack, entityStoreFactory, getEntityActions, useStateEntity };

package/dist/index.js

@@ -0,0 +1,73 @@
+import { createEntityAdapter } from '@reduxjs/toolkit';
+import { Store, useStore } from '@tanstack/react-store';
+import { useState, useMemo } from 'react';
+
+// src/actions.ts
+var getEntityActions = (adapter, setState) => ({
+  setOne: (entity) => setState((prev) => adapter.setOne(prev, entity)),
+  setMany: (entities) => setState((prev) => adapter.setMany(prev, entities)),
+  setAll: (entities) => setState((prev) => adapter.setAll(prev, entities)),
+  addOne: (entity) => setState((prev) => adapter.addOne(prev, entity)),
+  addMany: (entities) => setState((prev) => adapter.addMany(prev, entities)),
+  removeOne: (entityId) => setState((prev) => adapter.removeOne(prev, entityId)),
+  removeMany: (entityIds) => setState((prev) => adapter.removeMany(prev, entityIds)),
+  removeAll: () => setState((prev) => adapter.removeAll(prev)),
+  updateOne: (update) => setState((prev) => adapter.updateOne(prev, update)),
+  updateMany: (updates) => setState((prev) => adapter.updateMany(prev, updates)),
+  upsertOne: (entity) => setState((prev) => adapter.upsertOne(prev, entity)),
+  upsertMany: (entities) => setState((prev) => adapter.upsertMany(prev, entities))
+});
+
+// src/selectors.ts
+var getEntityStateTanstack = (entityState, selectors) => ({
+  all: selectors.selectAll(entityState),
+  byId: (id) => selectors.selectById(entityState, id),
+  ids: selectors.selectIds(entityState),
+  entities: selectors.selectEntities(entityState),
+  total: selectors.selectTotal(entityState)
+});
+var noSelect = (state) => state;
+var getSelectors = (baseSelectors) => ({
+  all: baseSelectors.selectAll,
+  entities: baseSelectors.selectEntities,
+  ids: baseSelectors.selectIds,
+  total: baseSelectors.selectTotal,
+  full: (state) => getEntityStateTanstack(state, baseSelectors)
+});
+
+// src/adapter/tanstack.ts
+var entityStoreFactory = (initialState) => {
+  const adapter = createEntityAdapter();
+  const store = new Store(
+    initialState ? adapter.setAll(adapter.getInitialState(), initialState) : adapter.getInitialState()
+  );
+  const actions = getEntityActions(adapter, (updater) => store.setState(updater));
+  const selectors = getSelectors(adapter.getSelectors(noSelect));
+  return { store, adapter, selectors, actions };
+};
+var createEntityStoreTanstack = (initialState) => {
+  const { adapter, store, actions, selectors } = entityStoreFactory(initialState);
+  function useEntity(selector = "full") {
+    const entityState = useStore(store, selectors[selector]);
+    return [entityState, actions];
+  }
+  return { useEntity, store, actions, adapter };
+};
+var adapterInstance = createEntityAdapter();
+function useStateEntity(initialState, selector) {
+  const adapter = adapterInstance;
+  const selectorKey = selector ?? "all";
+  const [state, setState] = useState(
+    () => initialState ? adapter.setAll(adapter.getInitialState(), initialState instanceof Function ? initialState() : initialState) : adapter.getInitialState()
+  );
+  const actions = useMemo(() => getEntityActions(adapter, setState), [adapter]);
+  const data = useMemo(
+    () => getSelectors(adapter.getSelectors(noSelect))[selectorKey](state),
+    [state, adapter.getSelectors, selectorKey]
+  );
+  return [data, actions];
+}
+
+export { createEntityStoreTanstack, entityStoreFactory, getEntityActions, useStateEntity };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/actions.ts","../src/selectors.ts","../src/adapter/tanstack.ts","../src/adapter/useState.ts"],"names":["createEntityAdapter"],"mappings":"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","file":"index.js","sourcesContent":["import type { EntityAdapter, EntityState } from \"@reduxjs/toolkit\";\nimport type { EntityStateAdapter, IdItem } from \"./types.ts\";\n\nexport const getEntityActions = <T extends IdItem>(\n\tadapter: EntityAdapter<T, T[\"id\"]>,\n\tsetState: (updater: (prev: EntityState<T, T[\"id\"]>) => EntityState<T, T[\"id\"]>) => void,\n): EntityStateAdapter<T, T[\"id\"]> => ({\n\tsetOne: (entity) => setState((prev) => adapter.setOne(prev, entity)),\n\tsetMany: (entities) => setState((prev) => adapter.setMany(prev, entities)),\n\tsetAll: (entities) => setState((prev) => adapter.setAll(prev, entities)),\n\n\taddOne: (entity) => setState((prev) => adapter.addOne(prev, entity)),\n\taddMany: (entities) => setState((prev) => adapter.addMany(prev, entities)),\n\n\tremoveOne: (entityId) => setState((prev) => adapter.removeOne(prev, entityId)),\n\tremoveMany: (entityIds) => setState((prev) => adapter.removeMany(prev, entityIds)),\n\tremoveAll: () => setState((prev) => adapter.removeAll(prev)),\n\n\tupdateOne: (update) => setState((prev) => adapter.updateOne(prev, update)),\n\tupdateMany: (updates) => setState((prev) => adapter.updateMany(prev, updates)),\n\n\tupsertOne: (entity) => setState((prev) => adapter.upsertOne(prev, entity)),\n\tupsertMany: (entities) => setState((prev) => adapter.upsertMany(prev, entities)),\n});\n","import type { EntitySelectors, EntityState } from \"@reduxjs/toolkit\";\nimport type { EntitySelectorsData, IdItem } from \"./types.ts\";\n\nconst getEntityStateTanstack = <T extends IdItem>(\n\tentityState: EntityState<T, T[\"id\"]>,\n\tselectors: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>,\n): EntitySelectorsData<T, T[\"id\"]> => ({\n\tall: selectors.selectAll(entityState),\n\tbyId: (id) => selectors.selectById(entityState, id),\n\tids: selectors.selectIds(entityState) as T[\"id\"][],\n\tentities: selectors.selectEntities(entityState),\n\ttotal: selectors.selectTotal(entityState),\n});\n\nexport const noSelect = <T>(state: T): T => state;\n\nexport type DataSelectors<T extends IdItem> = {\n\tall: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectAll\"];\n\tentities: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectEntities\"];\n\tids: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectIds\"];\n\ttotal: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>[\"selectTotal\"];\n\tfull: (state: EntityState<T, T[\"id\"]>) => EntitySelectorsData<T, T[\"id\"]>;\n};\n\nexport const getSelectors = <T extends IdItem>(\n\tbaseSelectors: EntitySelectors<T, EntityState<T, T[\"id\"]>, T[\"id\"]>,\n): DataSelectors<T> => ({\n\tall: baseSelectors.selectAll,\n\tentities: baseSelectors.selectEntities,\n\tids: baseSelectors.selectIds,\n\ttotal: baseSelectors.selectTotal,\n\tfull: (state) => getEntityStateTanstack(state, baseSelectors),\n});\n","import { createEntityAdapter, type EntityState } from \"@reduxjs/toolkit\";\nimport { Store, useStore } from \"@tanstack/react-store\";\nimport { getEntityActions } from \"../actions.ts\";\nimport { getSelectors, noSelect } from \"../selectors.ts\";\nimport type { EntityStateAdapter, IdItem } from \"../types.ts\";\n\nexport const entityStoreFactory = <T extends IdItem>(initialState?: T[]) => {\n\tconst adapter = createEntityAdapter<T>();\n\tconst store = new Store(\n\t\tinitialState ? adapter.setAll(adapter.getInitialState(), initialState) : adapter.getInitialState(),\n\t);\n\tconst actions = getEntityActions(adapter, (updater) => store.setState(updater));\n\tconst selectors = getSelectors(adapter.getSelectors<EntityState<T, T[\"id\"]>>(noSelect));\n\treturn { store, adapter, selectors, actions };\n};\nexport const createEntityStoreTanstack = <T extends IdItem>(initialState?: T[]) => {\n\tconst { adapter, store, actions, selectors } = entityStoreFactory(initialState);\n\n\ttype SelectorKey = keyof typeof selectors;\n\ttype SelectorReturn<K extends SelectorKey> = ReturnType<(typeof selectors)[K]>;\n\n\tfunction useEntity(): [SelectorReturn<\"full\">, EntityStateAdapter<T, T[\"id\"]>];\n\tfunction useEntity(selector: \"full\"): [SelectorReturn<\"full\">, EntityStateAdapter<T, T[\"id\"]>];\n\tfunction useEntity<K extends Exclude<SelectorKey, \"full\">>(\n\t\tselector: K,\n\t): [SelectorReturn<K>, EntityStateAdapter<T, T[\"id\"]>];\n\n\tfunction useEntity<K extends SelectorKey>(selector: K = \"full\" as K) {\n\t\tconst entityState = useStore(store, selectors[selector] as () => SelectorReturn<K>);\n\n\t\treturn [entityState, actions] satisfies [SelectorReturn<K>, EntityStateAdapter<T, T[\"id\"]>];\n\t}\n\n\treturn { useEntity, store, actions, adapter };\n};\n","import { createEntityAdapter, type EntityState } from \"@reduxjs/toolkit\";\nimport { useMemo, useState } from \"react\";\nimport { getEntityActions } from \"../actions.ts\";\nimport { type DataSelectors, getSelectors, noSelect } from \"../selectors.ts\";\nimport type { EntityStateAdapter, IdItem, InitialEntityState } from \"../types.ts\";\n\n/**\n * Creates a stable adapter instance outside the hook.\n * Since adapters are stateless configuration objects, we don't need\n * to recreate them or store them in React state.\n */\n// biome-ignore lint/suspicious/noExplicitAny: fine here\nconst adapterInstance = createEntityAdapter<any>();\n\n/**\n * react useState hook integrated with an entity adapter.\n * Provides entity state and actions to manipulate that state.\n *\n * @example\n * const [] = useStateWithEntity<{ id: string; name: string }>();\n * const [] = useStateWithEntity<{ id: string; name: string }>([]);\n * const [] = useStateWithEntity<{ id: string; name: string }>([], \"total\");\n * const [] = useStateWithEntity<{ id: string; name: string }>([], \"full\");\n * const [] = useStateWithEntity([] as { id: string; name: string }[], \"full\");\n * action.addOne({ id: \"1\", name: \"Demo\" });\n */\ntype SelectorKey<T extends IdItem> = keyof DataSelectors<T>;\ntype SelectorReturn<T extends IdItem, K extends SelectorKey<T>> = ReturnType<DataSelectors<T>[K]>;\ntype SelectorOrFull<T extends IdItem, K> = K extends SelectorKey<T> ? K : \"full\";\n\ntype Return<T extends IdItem, S extends SelectorKey<T>> = [SelectorReturn<T, S>, EntityStateAdapter<T, T[\"id\"]>];\n\n// biome-ignore format: no selector => full\nexport function useStateEntity<T extends IdItem>(): Return<T, \"all\">;\n\n// biome-ignore format: initial state  => full selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>): Return<T, \"all\">;\n\n// biome-ignore format: initial state + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"all\"): Return<T, \"all\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"entities\"): Return<T, \"entities\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"ids\"): Return<T, \"ids\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"total\"): Return<T, \"total\">;\n\n// biome-ignore format: initial state  + selector\nexport function useStateEntity<T extends IdItem>(initialState: InitialEntityState<T>, selector: \"full\"): Return<T, \"full\">;\n\n//  Keep it short\nexport function useStateEntity<T extends IdItem, K extends SelectorKey<T>>(\n\tinitialState?: InitialEntityState<T>,\n\tselector?: K,\n): [SelectorReturn<T, SelectorOrFull<T, K>>, EntityStateAdapter<T, T[\"id\"]>] {\n\t// Cast the generic adapter for type safety within the hook\n\tconst adapter = adapterInstance as ReturnType<typeof createEntityAdapter<T>>;\n\tconst selectorKey = (selector ?? \"all\") as SelectorKey<T>;\n\n\tconst [state, setState] = useState(() =>\n\t\tinitialState\n\t\t\t? adapter.setAll(adapter.getInitialState(), initialState instanceof Function ? initialState() : initialState)\n\t\t\t: adapter.getInitialState(),\n\t);\n\n\tconst actions = useMemo(() => getEntityActions(adapter, setState), [adapter]);\n\n\tconst data = useMemo(\n\t\t() =>\n\t\t\tgetSelectors(adapter.getSelectors<EntityState<T, T[\"id\"]>>(noSelect))[selectorKey](state) as SelectorReturn<\n\t\t\t\tT,\n\t\t\t\tSelectorOrFull<T, K>\n\t\t\t>,\n\t\t[state, adapter.getSelectors, selectorKey],\n\t);\n\n\treturn [data, actions];\n}\n"]}

package/package.json

@@ -1,15 +1,29 @@
 {
 	"name": "use-entity",
-	"module": "index.ts",
+	"version": "0.1.0-alpha",
+	"main": "dist/index.cjs",
+	"module": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"sideEffects": false,
 	"type": "module",
-	"version": "0.0.1-alpha",
 	"scripts": {
 		"biome:check": "biome check",
 		"biome:fix": "biome check --write --unsafe",
 		"biome:format": "biome format --write",
 		"test": "bun test",
-		"typecheck": "tsc",
-		"test:coverage": "jest"
+		"build": "tsup",
+		"build:dev": "tsup --watch --clean false",
+		"typecheck": "tsc"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.11",
@@ -18,12 +32,13 @@
 		"@tanstack/react-store": "0.8.0",
 		"@testing-library/dom": "10.4.1",
 		"@testing-library/jest-dom": "6.9.1",
-		"@testing-library/react": "16.3.1",
+		"@testing-library/react": "16.3.2",
 		"@types/bun": "latest",
-		"@types/react": "19.2.8",
+		"@types/react": "19.2.9",
 		"@types/react-dom": "19.2.3",
 		"lefthook": "2.0.15",
-		"react": "^19.2.3"
+		"react": "^19.2.3",
+		"tsup": "8.5.1"
 	},
 	"peerDependencies": {
 		"typescript": "^5",

package/.github/workflows/release-please.yml

@@ -1,52 +0,0 @@
-name: release-please
-
-on:
-  push:
-    branches:
-      - "**"
-
-jobs:
-  release-please:
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    env:
-      NODE_ENV: production
-      CI: true
-
-    steps:
-      - uses: googleapis/release-please-action@v4
-        id: release
-        with:
-          token: ${{ secrets.RELEASE_PLEASE_GH_TOKEN }}
-          release-type: node
-
-      - uses: actions/checkout@v6
-
-      - name: Set up Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: "latest"
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Run typecheck
-        run: bun run typecheck
-
-      - name: Run lint
-        run: bun run biome:check
-
-      - name: Run test
-        run: bun test
-
-      - name: Run build
-        run: bun run build
-
-      - run: bunx pkg-pr-new publish
-        continue-on-error: true
-
-      - name: Publish to npm
-        run: bun publish --access public
-        env:
-          NPM_CONFIG_TOKEN: ${{ secrets.NPM_TOKEN }}
-        if: ${{ steps.release.outputs.release_created }}