@hf-chimera/react 0.2.0

package/README.md

@@ -0,0 +1,241 @@
+# ChimeraEntityStore React Integration
+
+This package provides React hooks for seamless integration with ChimeraEntityStore, enabling reactive data management in React applications.
+
+## Features
+
+- **React Hooks**: Custom hooks for managing ChimeraEntityStore queries
+- **TypeScript Support**: Full type safety with TypeScript
+- **Automatic State Management**: Automatic re-rendering when data changes
+
+## Installation
+
+```bash
+# Install both the core store and React adapter
+npm install @hf-chimera/store @hf-chimera/react
+
+# React is a peer dependency
+npm install react
+
+# Or install all at once
+npm install @hf-chimera/store @hf-chimera/react react
+```
+
+## Usage
+
+### For React Applications
+
+Import from the React-specific entry point:
+
+```tsx
+import { createChimeraHooks } from "@hf-chimera/store/react";
+// In your app, call createChimeraHooks(store) and export the returned hooks
+```
+
+### For Non-React Applications
+
+Import from the main package:
+
+```ts
+import { createChimeraEntityStore } from "@hf-chimera/store";
+import { createChimeraStoreHooks } from "@hf-chimera/react";
+```
+
+## Quick Start
+
+### 1. Prepare hooks for the store
+
+Use the `createChimeraStoreHooks` function to create hooks for your entity store:
+
+```ts
+import { createChimeraStoreHooks } from "@hf-chimera/react";
+import { createChimeraEntityStore } from "@hf-chimera/store";
+
+// Define your entity type
+type Customer = {
+  id: number;
+  name: string;
+  email: string;
+};
+
+// Create your entity store instance
+const customerStore = createChimeraEntityStore<"customer", Customer>({
+  name: "customer",
+  idGetter: "id",
+  async collectionFetcher(params, requestParams) {
+    const response = await fetch("/api/customers", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ filter: params.filter, order: params.order }),
+      signal: requestParams.signal,
+    });
+    return { data: await response.json() };
+  },
+  async itemFetcher(params, requestParams) {
+    const response = await fetch(`/api/customers/${params.id}`, {
+      signal: requestParams.signal,
+    });
+    return { data: await response.json() };
+  },
+  // ... other CRUD operations
+});
+
+// Create hooks bound to your customer store
+// This generates: useChimeraCustomerStore, useChimeraCustomerCollection, useChimeraCustomerItem
+export const {
+  useChimeraCustomerStore,
+  useChimeraCustomerCollection,
+  useChimeraCustomerItem,
+} = createChimeraStoreHooks(customerStore);
+```
+
+### 2. Use Collection Queries
+
+```tsx
+import { useChimeraCustomerCollection } from "./store";
+
+function CustomerList() {
+  const customers = useChimeraCustomerCollection({
+    filter: { status: "active" },
+    order: [{ field: "name", direction: "asc" }],
+  });
+
+  if (!customers.ready) return <div>Loading...</div>;
+  if (customers.lastError)
+    return <div>Error: {String(customers.lastError)}</div>;
+
+  return (
+    <div>
+      {customers.map((customer) => (
+        <div key={customer.id}>
+          {customer.name}
+          <button onClick={() => customers.delete(customer.id)}>Delete</button>
+        </div>
+      ))}
+      <button onClick={() => customers.create({ name: "New Customer" })}>
+        Add Customer
+      </button>
+    </div>
+  );
+}
+```
+
+### 3. Use Item Queries
+
+```tsx
+import { useChimeraCustomerItem } from "./store";
+
+function CustomerDetail({ customerId }: { customerId: string }) {
+  const customer = useChimeraCustomerItem(customerId);
+
+  if (!customer.ready) return <div>Loading...</div>;
+  if (customer.lastError) return <div>Error: {String(customer.lastError)}</div>;
+  if (!customer.data) return <div>Customer not found</div>;
+
+  const handleUpdate = () => {
+    customer.mutable.name = "Updated Name";
+    customer.commit();
+  };
+
+  return (
+    <div>
+      <h3>{customer.data.name}</h3>
+      <button onClick={handleUpdate}>Update Name</button>
+    </div>
+  );
+}
+```
+
+### 4. Using with Query Builder
+
+You can use the `ChimeraQueryBuilder` with React hooks by passing a builder function instead of the query descriptor. This provides a more fluent and type-safe API:
+
+```tsx
+import { useChimeraCollection, useChimeraItem } from "./store";
+
+function ActiveUsers() {
+  // Pass a builder function - the hook will call it and build the query
+  const activeUsers = useChimeraCollection("customer", (q) => {
+    q.where("email", "contains", "@example.com").orderBy("createdAt", true);
+  });
+
+  if (!activeUsers.ready) {
+    return <div>Loading...</div>;
+  }
+
+  return (
+    <div>
+      {activeUsers.map((user) => (
+        <div key={user.id}>{user.name}</div>
+      ))}
+    </div>
+  );
+}
+```
+
+**Complex Query with Groups:**
+
+```tsx
+import { useChimeraCollection } from "./store";
+
+function FeaturedOrders() {
+  const orders = useChimeraCollection("order", (q) => {
+    q.where("status", "eq", "completed")
+      // Must be either high value OR from VIP customer
+      .group("or", (group) => {
+        group
+          .where("totalAmount", "gte", 1000)
+          .where("customerId", "in", [1, 2, 3]); // VIP customers
+      })
+      // But not cancelled
+      .whereNot("status", "eq", "cancelled")
+      .orderBy("totalAmount", true);
+  });
+
+  return (
+    <div>
+      {orders.map((order) => (
+        <div key={order.id}>{order.productName}</div>
+      ))}
+    </div>
+  );
+}
+```
+
+For more information on using the query builder, see the [ChimeraQueryBuilder documentation](../../qb/README.md).
+
+## API Reference
+
+### Hooks
+
+#### `useChimeraCustomerCollection<Meta>(params, deps?)`
+
+Hook for collection queries with automatic state management.
+
+**Parameters:**
+
+- `entityName: EntityName` - Name of the entity
+- `params: ChimeraCollectionParams | QueryBuilderCreator` - Query parameters or query builder function
+- `deps?: unknown[]` - Optional dependency array for memoization
+
+**Returns:** `ChimeraCollectionQuery<Item, OperatorsMap>`, see [ChimeraCollectionQuery documentation](../../../README.md#chimeracollectionquery)
+
+#### `useChimeraItem<Store, EntityName, Meta>(entityName, id, meta?)`
+
+Hook for individual item queries with automatic state management.
+
+**Parameters:**
+
+- `entityName: EntityName` - Name of the entity
+- `id: ChimeraEntityId` - Item ID
+- `meta?: Meta` - Optional metadata
+
+**Returns:** `ChimeraItemQuery<Item>`, see [ChimeraCollectionQuery documentation](../../../README.md#chimeraitemquery)
+
+## Tips
+
+1. **Type Safety**: Use `getChimeraTypedHooks` for full type safety
+2. **Error Handling**: Always check `ready` and `lastError` properties
+3. **Optimistic Updates**: Use the `mutable` property for optimistic updates on item queries
+4. **Batch Operations**: Use batch operations for multiple items when possible
+5. **Query Builder**: Use the query builder function syntax for better type safety and readability

package/dist/index.cjs

@@ -0,0 +1,48 @@
+let _hf_chimera_adapters_shared = require("@hf-chimera/adapters-shared");
+let _hf_chimera_query_builder = require("@hf-chimera/query-builder");
+let react = require("react");
+
+//#region hooks.ts
+const capitalize = (s) => s !== "" ? s[0].toUpperCase() + s.slice(1) : "";
+const useSubscribedValue = (value, events) => {
+	const trigger = (0, react.useState)(() => ({}))[1];
+	(0, react.useEffect)(() => {
+		const handler = () => trigger({});
+		events.forEach((event) => {
+			value.on(event, handler);
+		});
+		return () => {
+			events.forEach((event) => {
+				value.off(event, handler);
+			});
+		};
+	}, [
+		value,
+		events,
+		trigger
+	]);
+	return value;
+};
+function createChimeraStoreHooks(store, createQueryBuilder) {
+	createQueryBuilder ||= () => new _hf_chimera_query_builder.DefaultChimeraQueryBuilder();
+	return {
+		[`useChimera${capitalize(store.name)}Store`]: () => useSubscribedValue(store, _hf_chimera_adapters_shared.CHIMERA_ENTITY_STORE_UPDATE_EVENTS),
+		[`useChimera${capitalize(store.name)}Collection`]: (params, deps) => {
+			const oldDeps = (0, react.useRef)(deps);
+			if (oldDeps.current && !deps || !oldDeps.current && deps) console.warn(`useChimera${capitalize(store.name)}Collection deps is not a reactive param!\nUse deps if you want to control dependencies manually.
+Omit it if you already have a stable reference to params`);
+			oldDeps.current = deps;
+			const stableParams = (0, react.useMemo)(() => (0, _hf_chimera_adapters_shared.normalizeParams)(createQueryBuilder, params), deps ? deps : [params]);
+			return useSubscribedValue((0, react.useMemo)(() => store.getCollection(stableParams), [store, stableParams]), _hf_chimera_adapters_shared.CHIMERA_COLLECTION_UPDATE_EVENTS);
+		},
+		[`useChimera${capitalize(store.name)}Item`]: (id, meta) => useSubscribedValue((0, react.useMemo)(() => store.getItem(id, meta), [
+			store,
+			id,
+			meta
+		]), _hf_chimera_adapters_shared.CHIMERA_ITEM_UPDATE_EVENTS)
+	};
+}
+
+//#endregion
+exports.createChimeraStoreHooks = createChimeraStoreHooks;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["DefaultChimeraQueryBuilder","CHIMERA_ENTITY_STORE_UPDATE_EVENTS","CHIMERA_COLLECTION_UPDATE_EVENTS","CHIMERA_ITEM_UPDATE_EVENTS"],"sources":["../hooks.ts"],"sourcesContent":["import {\n\ttype AnyChimeraParams,\n\tCHIMERA_COLLECTION_UPDATE_EVENTS,\n\tCHIMERA_ENTITY_STORE_UPDATE_EVENTS,\n\tCHIMERA_ITEM_UPDATE_EVENTS,\n\tnormalizeParams,\n} from \"@hf-chimera/adapters-shared\";\nimport type { ChimeraQueryBuilder } from \"@hf-chimera/query-builder\";\nimport { DefaultChimeraQueryBuilder } from \"@hf-chimera/query-builder\";\nimport type {\n\tAnyChimeraEntityStore,\n\tAnyChimeraEventEmitter,\n\tChimeraCollectionQuery,\n\tChimeraEntityId,\n\tChimeraEntityStoreEntity,\n\tChimeraEntityStoreName,\n\tChimeraEntityStoreOperatorsMap,\n\tChimeraEventEmitterEventNames,\n\tChimeraItemQuery,\n} from \"@hf-chimera/store\";\nimport { useEffect, useMemo, useRef, useState } from \"react\";\n\ntype ChimeraHooks<\n\tTStore extends AnyChimeraEntityStore,\n\tTQueryBuilder extends ChimeraQueryBuilder<TStore>,\n\tTEntityName extends ChimeraEntityStoreName<TStore> = ChimeraEntityStoreName<TStore>,\n> = {\n\t[K in TEntityName as `useChimera${Capitalize<K>}Store`]: () => TStore;\n} & {\n\t[K in TEntityName as `useChimera${Capitalize<K>}Collection`]: <Meta = any>(\n\t\tparams: AnyChimeraParams<TStore, Meta, Extract<TQueryBuilder, ChimeraQueryBuilder<TStore>>>,\n\t\tdeps?: unknown[],\n\t) => ChimeraCollectionQuery<TEntityName, ChimeraEntityStoreEntity<TStore>, ChimeraEntityStoreOperatorsMap<TStore>>;\n} & {\n\t[K in TEntityName as `useChimera${Capitalize<K>}Item`]: <Meta = any>(\n\t\tid: ChimeraEntityId,\n\t\tmeta?: Meta,\n\t) => ChimeraItemQuery<TEntityName, ChimeraEntityStoreEntity<TStore>>;\n};\n\nconst capitalize = <T extends string>(s: T): Capitalize<T> =>\n\ts !== \"\" ? (((s[0] as string).toUpperCase() + s.slice(1)) as Capitalize<T>) : (\"\" as Capitalize<T>);\n\nconst useSubscribedValue = <TEventEmitter extends AnyChimeraEventEmitter>(\n\tvalue: TEventEmitter,\n\tevents: ChimeraEventEmitterEventNames<TEventEmitter>[],\n): TEventEmitter => {\n\tconst trigger = useState(() => ({}))[1];\n\tuseEffect(() => {\n\t\tconst handler = () => trigger({});\n\t\tevents.forEach((event) => {\n\t\t\tvalue.on(event, handler);\n\t\t});\n\t\treturn () => {\n\t\t\tevents.forEach((event) => {\n\t\t\t\tvalue.off(event, handler);\n\t\t\t});\n\t\t};\n\t}, [value, events, trigger]);\n\treturn value;\n};\n\nexport function createChimeraStoreHooks<TStore extends AnyChimeraEntityStore>(\n\tstore: TStore,\n): ChimeraHooks<TStore, DefaultChimeraQueryBuilder<TStore>>;\nexport function createChimeraStoreHooks<\n\tTStore extends AnyChimeraEntityStore,\n\tTQueryBuilder extends ChimeraQueryBuilder<TStore>,\n>(store: TStore, createQueryBuilder: () => TQueryBuilder): ChimeraHooks<TStore, TQueryBuilder>;\nexport function createChimeraStoreHooks<\n\tTStore extends AnyChimeraEntityStore,\n\tTQueryBuilder extends ChimeraQueryBuilder<TStore>,\n>(store: TStore, createQueryBuilder?: () => TQueryBuilder): ChimeraHooks<TStore, TQueryBuilder> {\n\tcreateQueryBuilder ||= () => new DefaultChimeraQueryBuilder() as unknown as TQueryBuilder;\n\n\treturn {\n\t\t[`useChimera${capitalize(store.name)}Store`]: () => useSubscribedValue(store, CHIMERA_ENTITY_STORE_UPDATE_EVENTS),\n\t\t[`useChimera${capitalize(store.name)}Collection`]: <TMeta = any>(\n\t\t\tparams: AnyChimeraParams<TStore, TMeta, Extract<TQueryBuilder, ChimeraQueryBuilder<TStore>>>,\n\t\t\tdeps?: unknown[],\n\t\t) => {\n\t\t\tconst oldDeps = useRef(deps);\n\t\t\tif ((oldDeps.current && !deps) || (!oldDeps.current && deps)) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`useChimera${capitalize(store.name)}Collection deps is not a reactive param!\\n` +\n\t\t\t\t\t\t\"Use deps if you want to control dependencies manually.\\n\" +\n\t\t\t\t\t\t\"Omit it if you already have a stable reference to params\",\n\t\t\t\t);\n\t\t\t}\n\t\t\toldDeps.current = deps;\n\n\t\t\tconst stableParams = useMemo(\n\t\t\t\t() => normalizeParams(createQueryBuilder, params),\n\t\t\t\t// biome-ignore lint/correctness/useExhaustiveDependencies: Very unlikely it will be changed over time, anyway warning for this already added.\n\t\t\t\tdeps ? deps : [params],\n\t\t\t);\n\n\t\t\treturn useSubscribedValue(\n\t\t\t\tuseMemo(() => store.getCollection(stableParams), [store, stableParams]),\n\t\t\t\tCHIMERA_COLLECTION_UPDATE_EVENTS,\n\t\t\t);\n\t\t},\n\t\t[`useChimera${capitalize(store.name)}Item`]: <Meta = any>(id: ChimeraEntityId, meta?: Meta) =>\n\t\t\tuseSubscribedValue(\n\t\t\t\tuseMemo(() => store.getItem(id, meta), [store, id, meta]),\n\t\t\t\tCHIMERA_ITEM_UPDATE_EVENTS,\n\t\t\t),\n\t} as ChimeraHooks<TStore, TQueryBuilder>;\n}\n"],"mappings":";;;;;AAwCA,MAAM,cAAgC,MACrC,MAAM,KAAQ,EAAE,GAAc,aAAa,GAAG,EAAE,MAAM,EAAE,GAAuB;AAEhF,MAAM,sBACL,OACA,WACmB;CACnB,MAAM,qCAA0B,EAAE,EAAE,CAAC;AACrC,4BAAgB;EACf,MAAM,gBAAgB,QAAQ,EAAE,CAAC;AACjC,SAAO,SAAS,UAAU;AACzB,SAAM,GAAG,OAAO,QAAQ;IACvB;AACF,eAAa;AACZ,UAAO,SAAS,UAAU;AACzB,UAAM,IAAI,OAAO,QAAQ;KACxB;;IAED;EAAC;EAAO;EAAQ;EAAQ,CAAC;AAC5B,QAAO;;AAUR,SAAgB,wBAGd,OAAe,oBAA+E;AAC/F,8BAA6B,IAAIA,sDAA4B;AAE7D,QAAO;GACL,aAAa,WAAW,MAAM,KAAK,CAAC,eAAe,mBAAmB,OAAOC,+DAAmC;GAChH,aAAa,WAAW,MAAM,KAAK,CAAC,eACpC,QACA,SACI;GACJ,MAAM,4BAAiB,KAAK;AAC5B,OAAK,QAAQ,WAAW,CAAC,QAAU,CAAC,QAAQ,WAAW,KACtD,SAAQ,KACP,aAAa,WAAW,MAAM,KAAK,CAAC;0DAGpC;AAEF,WAAQ,UAAU;GAElB,MAAM,yFACiB,oBAAoB,OAAO,EAEjD,OAAO,OAAO,CAAC,OAAO,CACtB;AAED,UAAO,4CACQ,MAAM,cAAc,aAAa,EAAE,CAAC,OAAO,aAAa,CAAC,EACvEC,6DACA;;GAED,aAAa,WAAW,MAAM,KAAK,CAAC,SAAqB,IAAqB,SAC9E,4CACe,MAAM,QAAQ,IAAI,KAAK,EAAE;GAAC;GAAO;GAAI;GAAK,CAAC,EACzDC,uDACA;EACF"}

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { AnyChimeraParams } from "@hf-chimera/adapters-shared";
+import { ChimeraQueryBuilder, DefaultChimeraQueryBuilder } from "@hf-chimera/query-builder";
+import { AnyChimeraEntityStore, ChimeraCollectionQuery, ChimeraEntityId, ChimeraEntityStoreEntity, ChimeraEntityStoreName, ChimeraEntityStoreOperatorsMap, ChimeraItemQuery } from "@hf-chimera/store";
+
+//#region hooks.d.ts
+type ChimeraHooks<TStore extends AnyChimeraEntityStore, TQueryBuilder extends ChimeraQueryBuilder<TStore>, TEntityName extends ChimeraEntityStoreName<TStore> = ChimeraEntityStoreName<TStore>> = { [K in TEntityName as `useChimera${Capitalize<K>}Store`]: () => TStore } & { [K in TEntityName as `useChimera${Capitalize<K>}Collection`]: <Meta = any>(params: AnyChimeraParams<TStore, Meta, Extract<TQueryBuilder, ChimeraQueryBuilder<TStore>>>, deps?: unknown[]) => ChimeraCollectionQuery<TEntityName, ChimeraEntityStoreEntity<TStore>, ChimeraEntityStoreOperatorsMap<TStore>> } & { [K in TEntityName as `useChimera${Capitalize<K>}Item`]: <Meta = any>(id: ChimeraEntityId, meta?: Meta) => ChimeraItemQuery<TEntityName, ChimeraEntityStoreEntity<TStore>> };
+declare function createChimeraStoreHooks<TStore extends AnyChimeraEntityStore>(store: TStore): ChimeraHooks<TStore, DefaultChimeraQueryBuilder<TStore>>;
+declare function createChimeraStoreHooks<TStore extends AnyChimeraEntityStore, TQueryBuilder extends ChimeraQueryBuilder<TStore>>(store: TStore, createQueryBuilder: () => TQueryBuilder): ChimeraHooks<TStore, TQueryBuilder>;
+//#endregion
+export { createChimeraStoreHooks };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../hooks.ts"],"sourcesContent":[],"mappings":";;;;;KAsBK,4BACW,6CACO,oBAAoB,6BACtB,uBAAuB,UAAU,uBAAuB,mBAEtE,WALU,IAAA,aAKkB,UALlB,CAK6B,CAL7B,CAAA,OAAA,GAAA,GAAA,GAK+C,MAL/C,EACD,GAAA,QAMT,WALoC,IAAA,aAKR,UALQ,CAKG,CALH,CAAA,YAAA,GAAA,CAAA,OAAA,GAAA,CAAA,CAAA,MAAA,EAMjC,gBANiC,CAMhB,MANgB,EAMR,IANQ,EAMF,OANE,CAMM,aANN,EAMqB,mBANrB,CAMyC,MANzC,CAAA,CAAA,CAAA,EAAA,IAAA,CAAA,EAAA,OAAA,EAAA,EAAA,GAQrC,sBARqC,CAQd,WARc,EAQD,wBARC,CAQwB,MARxB,CAAA,EAQiC,8BARjC,CAQgE,MARhE,CAAA,CAAA,EAApB,GAAA,QAUhB,WATqC,IAAA,aAST,UATS,CASE,CATF,CAAA,MAAA,GAAA,CAAA,OAAA,GAAA,CAAA,CAAA,EAAA,EAUtC,eAVsC,EAAA,IAAA,CAAA,EAWnC,IAXmC,EAAA,GAYtC,gBAZsC,CAYrB,WAZqB,EAYR,wBAZQ,CAYiB,MAZjB,CAAA,CAAA,EAAvB;AAAwD,iBAqC7D,uBArC6D,CAAA,eAqCtB,qBArCsB,CAAA,CAAA,KAAA,EAsCrE,MAtCqE,CAAA,EAuC1E,YAvC0E,CAuC7D,MAvC6D,EAuCrD,0BAvCqD,CAuC1B,MAvC0B,CAAA,CAAA;AAAvB,iBAwCtC,uBAxCsC,CAAA,eAyCtC,qBAzCsC,EAAA,sBA0C/B,mBA1C+B,CA0CX,MA1CW,CAAA,CAAA,CAAA,KAAA,EA2C7C,MA3C6C,EAAA,kBAAA,EAAA,GAAA,GA2CX,aA3CW,CAAA,EA2CK,YA3CL,CA2CkB,MA3ClB,EA2C0B,aA3C1B,CAAA"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { AnyChimeraParams } from "@hf-chimera/adapters-shared";
+import { ChimeraQueryBuilder, DefaultChimeraQueryBuilder } from "@hf-chimera/query-builder";
+import { AnyChimeraEntityStore, ChimeraCollectionQuery, ChimeraEntityId, ChimeraEntityStoreEntity, ChimeraEntityStoreName, ChimeraEntityStoreOperatorsMap, ChimeraItemQuery } from "@hf-chimera/store";
+
+//#region hooks.d.ts
+type ChimeraHooks<TStore extends AnyChimeraEntityStore, TQueryBuilder extends ChimeraQueryBuilder<TStore>, TEntityName extends ChimeraEntityStoreName<TStore> = ChimeraEntityStoreName<TStore>> = { [K in TEntityName as `useChimera${Capitalize<K>}Store`]: () => TStore } & { [K in TEntityName as `useChimera${Capitalize<K>}Collection`]: <Meta = any>(params: AnyChimeraParams<TStore, Meta, Extract<TQueryBuilder, ChimeraQueryBuilder<TStore>>>, deps?: unknown[]) => ChimeraCollectionQuery<TEntityName, ChimeraEntityStoreEntity<TStore>, ChimeraEntityStoreOperatorsMap<TStore>> } & { [K in TEntityName as `useChimera${Capitalize<K>}Item`]: <Meta = any>(id: ChimeraEntityId, meta?: Meta) => ChimeraItemQuery<TEntityName, ChimeraEntityStoreEntity<TStore>> };
+declare function createChimeraStoreHooks<TStore extends AnyChimeraEntityStore>(store: TStore): ChimeraHooks<TStore, DefaultChimeraQueryBuilder<TStore>>;
+declare function createChimeraStoreHooks<TStore extends AnyChimeraEntityStore, TQueryBuilder extends ChimeraQueryBuilder<TStore>>(store: TStore, createQueryBuilder: () => TQueryBuilder): ChimeraHooks<TStore, TQueryBuilder>;
+//#endregion
+export { createChimeraStoreHooks };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../hooks.ts"],"sourcesContent":[],"mappings":";;;;;KAsBK,4BACW,6CACO,oBAAoB,6BACtB,uBAAuB,UAAU,uBAAuB,mBAEtE,WALU,IAAA,aAKkB,UALlB,CAK6B,CAL7B,CAAA,OAAA,GAAA,GAAA,GAK+C,MAL/C,EACD,GAAA,QAMT,WALoC,IAAA,aAKR,UALQ,CAKG,CALH,CAAA,YAAA,GAAA,CAAA,OAAA,GAAA,CAAA,CAAA,MAAA,EAMjC,gBANiC,CAMhB,MANgB,EAMR,IANQ,EAMF,OANE,CAMM,aANN,EAMqB,mBANrB,CAMyC,MANzC,CAAA,CAAA,CAAA,EAAA,IAAA,CAAA,EAAA,OAAA,EAAA,EAAA,GAQrC,sBARqC,CAQd,WARc,EAQD,wBARC,CAQwB,MARxB,CAAA,EAQiC,8BARjC,CAQgE,MARhE,CAAA,CAAA,EAApB,GAAA,QAUhB,WATqC,IAAA,aAST,UATS,CASE,CATF,CAAA,MAAA,GAAA,CAAA,OAAA,GAAA,CAAA,CAAA,EAAA,EAUtC,eAVsC,EAAA,IAAA,CAAA,EAWnC,IAXmC,EAAA,GAYtC,gBAZsC,CAYrB,WAZqB,EAYR,wBAZQ,CAYiB,MAZjB,CAAA,CAAA,EAAvB;AAAwD,iBAqC7D,uBArC6D,CAAA,eAqCtB,qBArCsB,CAAA,CAAA,KAAA,EAsCrE,MAtCqE,CAAA,EAuC1E,YAvC0E,CAuC7D,MAvC6D,EAuCrD,0BAvCqD,CAuC1B,MAvC0B,CAAA,CAAA;AAAvB,iBAwCtC,uBAxCsC,CAAA,eAyCtC,qBAzCsC,EAAA,sBA0C/B,mBA1C+B,CA0CX,MA1CW,CAAA,CAAA,CAAA,KAAA,EA2C7C,MA3C6C,EAAA,kBAAA,EAAA,GAAA,GA2CX,aA3CW,CAAA,EA2CK,YA3CL,CA2CkB,MA3ClB,EA2C0B,aA3C1B,CAAA"}

package/dist/index.mjs

@@ -0,0 +1,48 @@
+import { CHIMERA_COLLECTION_UPDATE_EVENTS, CHIMERA_ENTITY_STORE_UPDATE_EVENTS, CHIMERA_ITEM_UPDATE_EVENTS, normalizeParams } from "@hf-chimera/adapters-shared";
+import { DefaultChimeraQueryBuilder } from "@hf-chimera/query-builder";
+import { useEffect, useMemo, useRef, useState } from "react";
+
+//#region hooks.ts
+const capitalize = (s) => s !== "" ? s[0].toUpperCase() + s.slice(1) : "";
+const useSubscribedValue = (value, events) => {
+	const trigger = useState(() => ({}))[1];
+	useEffect(() => {
+		const handler = () => trigger({});
+		events.forEach((event) => {
+			value.on(event, handler);
+		});
+		return () => {
+			events.forEach((event) => {
+				value.off(event, handler);
+			});
+		};
+	}, [
+		value,
+		events,
+		trigger
+	]);
+	return value;
+};
+function createChimeraStoreHooks(store, createQueryBuilder) {
+	createQueryBuilder ||= () => new DefaultChimeraQueryBuilder();
+	return {
+		[`useChimera${capitalize(store.name)}Store`]: () => useSubscribedValue(store, CHIMERA_ENTITY_STORE_UPDATE_EVENTS),
+		[`useChimera${capitalize(store.name)}Collection`]: (params, deps) => {
+			const oldDeps = useRef(deps);
+			if (oldDeps.current && !deps || !oldDeps.current && deps) console.warn(`useChimera${capitalize(store.name)}Collection deps is not a reactive param!\nUse deps if you want to control dependencies manually.
+Omit it if you already have a stable reference to params`);
+			oldDeps.current = deps;
+			const stableParams = useMemo(() => normalizeParams(createQueryBuilder, params), deps ? deps : [params]);
+			return useSubscribedValue(useMemo(() => store.getCollection(stableParams), [store, stableParams]), CHIMERA_COLLECTION_UPDATE_EVENTS);
+		},
+		[`useChimera${capitalize(store.name)}Item`]: (id, meta) => useSubscribedValue(useMemo(() => store.getItem(id, meta), [
+			store,
+			id,
+			meta
+		]), CHIMERA_ITEM_UPDATE_EVENTS)
+	};
+}
+
+//#endregion
+export { createChimeraStoreHooks };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../hooks.ts"],"sourcesContent":["import {\n\ttype AnyChimeraParams,\n\tCHIMERA_COLLECTION_UPDATE_EVENTS,\n\tCHIMERA_ENTITY_STORE_UPDATE_EVENTS,\n\tCHIMERA_ITEM_UPDATE_EVENTS,\n\tnormalizeParams,\n} from \"@hf-chimera/adapters-shared\";\nimport type { ChimeraQueryBuilder } from \"@hf-chimera/query-builder\";\nimport { DefaultChimeraQueryBuilder } from \"@hf-chimera/query-builder\";\nimport type {\n\tAnyChimeraEntityStore,\n\tAnyChimeraEventEmitter,\n\tChimeraCollectionQuery,\n\tChimeraEntityId,\n\tChimeraEntityStoreEntity,\n\tChimeraEntityStoreName,\n\tChimeraEntityStoreOperatorsMap,\n\tChimeraEventEmitterEventNames,\n\tChimeraItemQuery,\n} from \"@hf-chimera/store\";\nimport { useEffect, useMemo, useRef, useState } from \"react\";\n\ntype ChimeraHooks<\n\tTStore extends AnyChimeraEntityStore,\n\tTQueryBuilder extends ChimeraQueryBuilder<TStore>,\n\tTEntityName extends ChimeraEntityStoreName<TStore> = ChimeraEntityStoreName<TStore>,\n> = {\n\t[K in TEntityName as `useChimera${Capitalize<K>}Store`]: () => TStore;\n} & {\n\t[K in TEntityName as `useChimera${Capitalize<K>}Collection`]: <Meta = any>(\n\t\tparams: AnyChimeraParams<TStore, Meta, Extract<TQueryBuilder, ChimeraQueryBuilder<TStore>>>,\n\t\tdeps?: unknown[],\n\t) => ChimeraCollectionQuery<TEntityName, ChimeraEntityStoreEntity<TStore>, ChimeraEntityStoreOperatorsMap<TStore>>;\n} & {\n\t[K in TEntityName as `useChimera${Capitalize<K>}Item`]: <Meta = any>(\n\t\tid: ChimeraEntityId,\n\t\tmeta?: Meta,\n\t) => ChimeraItemQuery<TEntityName, ChimeraEntityStoreEntity<TStore>>;\n};\n\nconst capitalize = <T extends string>(s: T): Capitalize<T> =>\n\ts !== \"\" ? (((s[0] as string).toUpperCase() + s.slice(1)) as Capitalize<T>) : (\"\" as Capitalize<T>);\n\nconst useSubscribedValue = <TEventEmitter extends AnyChimeraEventEmitter>(\n\tvalue: TEventEmitter,\n\tevents: ChimeraEventEmitterEventNames<TEventEmitter>[],\n): TEventEmitter => {\n\tconst trigger = useState(() => ({}))[1];\n\tuseEffect(() => {\n\t\tconst handler = () => trigger({});\n\t\tevents.forEach((event) => {\n\t\t\tvalue.on(event, handler);\n\t\t});\n\t\treturn () => {\n\t\t\tevents.forEach((event) => {\n\t\t\t\tvalue.off(event, handler);\n\t\t\t});\n\t\t};\n\t}, [value, events, trigger]);\n\treturn value;\n};\n\nexport function createChimeraStoreHooks<TStore extends AnyChimeraEntityStore>(\n\tstore: TStore,\n): ChimeraHooks<TStore, DefaultChimeraQueryBuilder<TStore>>;\nexport function createChimeraStoreHooks<\n\tTStore extends AnyChimeraEntityStore,\n\tTQueryBuilder extends ChimeraQueryBuilder<TStore>,\n>(store: TStore, createQueryBuilder: () => TQueryBuilder): ChimeraHooks<TStore, TQueryBuilder>;\nexport function createChimeraStoreHooks<\n\tTStore extends AnyChimeraEntityStore,\n\tTQueryBuilder extends ChimeraQueryBuilder<TStore>,\n>(store: TStore, createQueryBuilder?: () => TQueryBuilder): ChimeraHooks<TStore, TQueryBuilder> {\n\tcreateQueryBuilder ||= () => new DefaultChimeraQueryBuilder() as unknown as TQueryBuilder;\n\n\treturn {\n\t\t[`useChimera${capitalize(store.name)}Store`]: () => useSubscribedValue(store, CHIMERA_ENTITY_STORE_UPDATE_EVENTS),\n\t\t[`useChimera${capitalize(store.name)}Collection`]: <TMeta = any>(\n\t\t\tparams: AnyChimeraParams<TStore, TMeta, Extract<TQueryBuilder, ChimeraQueryBuilder<TStore>>>,\n\t\t\tdeps?: unknown[],\n\t\t) => {\n\t\t\tconst oldDeps = useRef(deps);\n\t\t\tif ((oldDeps.current && !deps) || (!oldDeps.current && deps)) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`useChimera${capitalize(store.name)}Collection deps is not a reactive param!\\n` +\n\t\t\t\t\t\t\"Use deps if you want to control dependencies manually.\\n\" +\n\t\t\t\t\t\t\"Omit it if you already have a stable reference to params\",\n\t\t\t\t);\n\t\t\t}\n\t\t\toldDeps.current = deps;\n\n\t\t\tconst stableParams = useMemo(\n\t\t\t\t() => normalizeParams(createQueryBuilder, params),\n\t\t\t\t// biome-ignore lint/correctness/useExhaustiveDependencies: Very unlikely it will be changed over time, anyway warning for this already added.\n\t\t\t\tdeps ? deps : [params],\n\t\t\t);\n\n\t\t\treturn useSubscribedValue(\n\t\t\t\tuseMemo(() => store.getCollection(stableParams), [store, stableParams]),\n\t\t\t\tCHIMERA_COLLECTION_UPDATE_EVENTS,\n\t\t\t);\n\t\t},\n\t\t[`useChimera${capitalize(store.name)}Item`]: <Meta = any>(id: ChimeraEntityId, meta?: Meta) =>\n\t\t\tuseSubscribedValue(\n\t\t\t\tuseMemo(() => store.getItem(id, meta), [store, id, meta]),\n\t\t\t\tCHIMERA_ITEM_UPDATE_EVENTS,\n\t\t\t),\n\t} as ChimeraHooks<TStore, TQueryBuilder>;\n}\n"],"mappings":";;;;;AAwCA,MAAM,cAAgC,MACrC,MAAM,KAAQ,EAAE,GAAc,aAAa,GAAG,EAAE,MAAM,EAAE,GAAuB;AAEhF,MAAM,sBACL,OACA,WACmB;CACnB,MAAM,UAAU,gBAAgB,EAAE,EAAE,CAAC;AACrC,iBAAgB;EACf,MAAM,gBAAgB,QAAQ,EAAE,CAAC;AACjC,SAAO,SAAS,UAAU;AACzB,SAAM,GAAG,OAAO,QAAQ;IACvB;AACF,eAAa;AACZ,UAAO,SAAS,UAAU;AACzB,UAAM,IAAI,OAAO,QAAQ;KACxB;;IAED;EAAC;EAAO;EAAQ;EAAQ,CAAC;AAC5B,QAAO;;AAUR,SAAgB,wBAGd,OAAe,oBAA+E;AAC/F,8BAA6B,IAAI,4BAA4B;AAE7D,QAAO;GACL,aAAa,WAAW,MAAM,KAAK,CAAC,eAAe,mBAAmB,OAAO,mCAAmC;GAChH,aAAa,WAAW,MAAM,KAAK,CAAC,eACpC,QACA,SACI;GACJ,MAAM,UAAU,OAAO,KAAK;AAC5B,OAAK,QAAQ,WAAW,CAAC,QAAU,CAAC,QAAQ,WAAW,KACtD,SAAQ,KACP,aAAa,WAAW,MAAM,KAAK,CAAC;0DAGpC;AAEF,WAAQ,UAAU;GAElB,MAAM,eAAe,cACd,gBAAgB,oBAAoB,OAAO,EAEjD,OAAO,OAAO,CAAC,OAAO,CACtB;AAED,UAAO,mBACN,cAAc,MAAM,cAAc,aAAa,EAAE,CAAC,OAAO,aAAa,CAAC,EACvE,iCACA;;GAED,aAAa,WAAW,MAAM,KAAK,CAAC,SAAqB,IAAqB,SAC9E,mBACC,cAAc,MAAM,QAAQ,IAAI,KAAK,EAAE;GAAC;GAAO;GAAI;GAAK,CAAC,EACzD,2BACA;EACF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "@hf-chimera/react",
+	"version": "0.2.0",
+	"description": "Cross-end reactivity API - React adapter",
+	"license": "MIT",
+	"author": "hewston",
+	"keywords": [
+		"reactivity",
+		"reactive",
+		"react",
+		"hooks",
+		"typescript",
+		"state-management"
+	],
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"require": "./dist/index.cjs",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"bugs": {
+		"url": "https://github.com/hf-chimera/store/issues"
+	},
+	"repository": {
+		"url": "https://github.com/hf-chimera/store"
+	},
+	"peerDependencies": {
+		"@hf-chimera/store": "workspace:^",
+		"@hf-chimera/adapters-shared": "workspace:^",
+		"react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+	},
+	"scripts": {
+		"build": "tsdown",
+		"changeset:patch": "node ../../../scripts/changeset-patch.mjs @hf-chimera/react"
+	},
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	}
+}