use-entity 0.0.1-alpha → 0.1.0-alpha

package/src/types.ts

@@ -1,48 +0,0 @@
-import type { EntityId, Update } from "@reduxjs/toolkit";
-import type { UncheckedIndexedAccess } from "./uncheckedindexed.ts";
-
-export 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 Id<T> = {
-	[K in keyof T]: T[K];
-} & {};
-
-export interface EntitySelectors<T, IdType extends EntityId> {
-	selectIds: () => IdType[];
-	selectEntities: () => Record<IdType, T>;
-	selectAll: () => T[];
-	selectTotal: () => number;
-	selectById: (id: IdType) => Id<UncheckedIndexedAccess<T>>;
-}
-
-export interface EntitySelectorsData<T, IdType extends EntityId> {
-	ids: IdType[];
-	entities: Record<IdType, T>;
-	all: T[];
-	total: number;
-	byId: (id: IdType) => Id<UncheckedIndexedAccess<T>>;
-}

package/src/uncheckedindexed.ts

@@ -1,16 +0,0 @@
-// inlined from https://github.com/EskiMojo14/uncheckedindexed
-// relies on remaining as a TS file, not .d.ts
-type IfMaybeUndefined<T, True, False> = [undefined] extends [T] ? True : False;
-
-const testAccess = ({} as Record<string, 0>).a;
-
-export type IfUncheckedIndexedAccess<True, False> = IfMaybeUndefined<
-	typeof testAccess,
-	True,
-	False
->;
-
-export type UncheckedIndexedAccess<T> = IfUncheckedIndexedAccess<
-	T | undefined,
-	T
->;

package/src/useEntity.ts

@@ -1,128 +0,0 @@
-import {
-	createEntityAdapter,
-	type EntityAdapter,
-	type EntitySelectors,
-	type EntityState,
-} from "@reduxjs/toolkit";
-import { Store, useStore } from "@tanstack/react-store";
-import { useMemo } from "react";
-import type { EntitySelectorsData, EntityStateAdapter } from "./types.ts";
-
-const getEntityActionsTanstack = <
-	T extends {
-		id: string;
-	},
->(
-	store: Store<EntityState<T, T["id"]>>,
-	adapter: EntityAdapter<T, T["id"]>,
-): EntityStateAdapter<T, T["id"]> => ({
-	setOne: (entity) => store.setState((prev) => adapter.setOne(prev, entity)),
-	setMany: (entities) =>
-		store.setState((prev) => adapter.setMany(prev, entities)),
-	setAll: (entities) =>
-		store.setState((prev) => adapter.setAll(prev, entities)),
-
-	addOne: (entity) => store.setState((prev) => adapter.addOne(prev, entity)),
-	addMany: (entities) =>
-		store.setState((prev) => adapter.addMany(prev, entities)),
-
-	removeOne: (entityId) =>
-		store.setState((prev) => adapter.removeOne(prev, entityId)),
-	removeMany: (entityIds) =>
-		store.setState((prev) => adapter.removeMany(prev, entityIds)),
-	removeAll: () => store.setState((prev) => adapter.removeAll(prev)),
-
-	updateOne: (update) =>
-		store.setState((prev) => adapter.updateOne(prev, update)),
-	updateMany: (updates) =>
-		store.setState((prev) => adapter.updateMany(prev, updates)),
-
-	upsertOne: (entity) =>
-		store.setState((prev) => adapter.upsertOne(prev, entity)),
-	upsertMany: (entities) =>
-		store.setState((prev) => adapter.upsertMany(prev, entities)),
-});
-
-const getEntityStateTanstack = <
-	T extends {
-		id: string;
-	},
->(
-	entityState: EntityState<T, T["id"]>,
-	selectors: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>,
-): EntitySelectorsData<T, T["id"]> => ({
-	all: selectors.selectAll(entityState),
-	byId: (id) => selectors.selectById(entityState, id),
-	ids: selectors.selectIds(entityState) as T["id"][],
-	entities: selectors.selectEntities(entityState),
-	total: selectors.selectTotal(entityState),
-});
-const getSelectors = <
-	T extends {
-		id: string;
-	},
->(
-	baseSelectors: EntitySelectors<T, EntityState<T, T["id"]>, T["id"]>,
-) =>
-	({
-		all: baseSelectors.selectAll,
-		entities: baseSelectors.selectEntities,
-		ids: baseSelectors.selectIds,
-		total: baseSelectors.selectTotal,
-		full: (state) => getEntityStateTanstack(state, baseSelectors),
-	}) satisfies Record<
-		keyof Omit<EntitySelectorsData<T, T["id"]>, "byId"> | "full",
-		(state: EntityState<T, T["id"]>) => unknown
-	>;
-
-export const createEntityStore = <
-	T extends {
-		id: string;
-	},
->(
-	initialState?: T[],
-) => {
-	const adapter = createEntityAdapter<T>();
-	const store = new Store(
-		initialState
-			? adapter.setAll(adapter.getInitialState(), initialState)
-			: adapter.getInitialState(),
-	);
-	const baseSelectors = adapter.getSelectors<EntityState<T, T["id"]>>(
-		(input) => input,
-	);
-	const MySelectors = getSelectors(baseSelectors);
-
-	type SelectorKey = keyof typeof MySelectors;
-	type SelectorReturn<K extends SelectorKey> = ReturnType<
-		(typeof MySelectors)[K]
-	>;
-
-	function useEntity(): [
-		SelectorReturn<"full">,
-		EntityStateAdapter<T, T["id"]>,
-	];
-	function useEntity(
-		selector: "full",
-	): [SelectorReturn<"full">, EntityStateAdapter<T, T["id"]>];
-	function useEntity<K extends Exclude<SelectorKey, "full">>(
-		selector: K,
-	): [SelectorReturn<K>, EntityStateAdapter<T, T["id"]>];
-
-	function useEntity<K extends SelectorKey>(selector: K = "full" as K) {
-		const entityState = useStore(
-			store,
-			MySelectors[selector] as () => SelectorReturn<K>,
-		);
-		const actions = useMemo<EntityStateAdapter<T, T["id"]>>(
-			() => getEntityActionsTanstack(store, adapter),
-			[],
-		);
-		return [entityState, actions] satisfies [
-			SelectorReturn<K>,
-			EntityStateAdapter<T, T["id"]>,
-		];
-	}
-
-	return { useEntity, store, adapter };
-};

package/testing-library.ts

@@ -1,10 +0,0 @@
-import { afterEach, expect } from "bun:test";
-import * as matchers from "@testing-library/jest-dom/matchers";
-import { cleanup } from "@testing-library/react";
-
-expect.extend(matchers);
-
-// Optional: cleans up `render` after each test
-afterEach(() => {
-	cleanup();
-});

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-	"compilerOptions": {
-		// Environment setup & latest features
-		"lib": ["ESNext"],
-		"target": "ESNext",
-		"module": "Preserve",
-		"moduleDetection": "force",
-		"jsx": "react-jsx",
-		"allowJs": true,
-
-		// Bundler mode
-		"moduleResolution": "bundler",
-		"allowImportingTsExtensions": true,
-		"verbatimModuleSyntax": true,
-		"noEmit": true,
-
-		// Best practices
-		"strict": true,
-		"skipLibCheck": true,
-		"noFallthroughCasesInSwitch": true,
-		"noUncheckedIndexedAccess": true,
-		"noImplicitOverride": true,
-
-		// Some stricter flags (disabled by default)
-		"noUnusedLocals": false,
-		"noUnusedParameters": false,
-		"noPropertyAccessFromIndexSignature": false
-	}
-}