@bemedev/app-reactjs 1.11.0 → 2.0.0

package/README.md

@@ -2,9 +2,8 @@
 
 ReactJS state hook binding for `@bemedev/app` state machines.
 
-`@bemedev/app-reactjs` provides a lightweight hook to track and select
-state from a `@bemedev/app` interpreter service inside ReactJS component
-trees.
+`@bemedev/app-reactjs` provides a lightweight hook to track and select state from a
+`@bemedev/app` interpreter service inside ReactJS component trees.
 
 <br/>
 
@@ -23,7 +22,7 @@ npm install @bemedev/app-reactjs
 pnpm add @bemedev/app-reactjs
 ```
 
-> **Requirements:** Node.js ≥ 24 · `@bemedev/app` ≥ 1.2.0 · React ≥ 18.0.0
+> **Requirements:** Node.js ≥ 24 · `@bemedev/app` ≥ 2.0.0 · React ≥ 18.0.0
 
 <br/>
 
@@ -60,8 +59,8 @@ function MyComponent() {
 
 ## Available Hooks
 
-The package also exports `useState`, `useCan`, and `useIsInside` for common
-state selection patterns:
+The package also exports `useState`, `useCan`, and `useIsInside` for common state
+selection patterns:
 
 ```typescript
 const count = useState(service, state => state.context.count);
@@ -69,9 +68,9 @@ const canIncrement = useCan(service, 'INCREMENT');
 const isInside = useIsInside(service, 'some.state');
 ```
 
-These helpers are designed to work with the same interpreter service and
-provide a lightweight way to subscribe to state slices, transition
-permissions, and nested state location checks.
+These helpers are designed to work with the same interpreter service and provide a
+lightweight way to subscribe to state slices, transition permissions, and nested
+state location checks.
 
 <br/>
 
@@ -79,8 +78,8 @@ permissions, and nested state location checks.
 
 ### `useService(service, options?)`
 
-Creates a React state hook that updates whenever the interpreter
-transitions, using deep comparison to prevent unnecessary renders.
+Creates a React state hook that updates whenever the interpreter transitions, using
+deep comparison to prevent unnecessary renders.
 
 | Parameter | Type                | Description                                                                         |
 | --------- | ------------------- | ----------------------------------------------------------------------------------- |

package/lib/types.d.ts

@@ -2,10 +2,10 @@ import type { EventObject, State, PrimitiveObject } from '@bemedev/app';
 /**
  * Options for configuring the `useService` hook.
  *
- * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
- * @template {string} Ta - Tag type extending `string`.
- * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
- * @template T - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
+ * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+ * @template `Ta` - Tag type extending `string`.
+ * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
+ * @template `T` - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
  *
  * @property selector - Optional selector function to project the state into a sub-state.
  * @property equals - Optional equality comparator function to compare previous and next selected state.

package/lib/useCan.cjs

@@ -6,9 +6,9 @@ let _bemedev_app_bemedev = require("@bemedev/app/bemedev");
 /**
 * React hook that creates reactive helpers for querying event capabilities from a service.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
 *
 * @param service - Service object containing `subscribe`, `state`, and `canEvents`.
 * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
@@ -16,6 +16,8 @@ let _bemedev_app_bemedev = require("@bemedev/app/bemedev");
 * @param service.canEvents - Function checking if event types can be accepted.
 *
 * @returns Object helper with `or` and `and` methods to check event availability.
+*
+* @see {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}
 */
 function useCan(service) {
 	const dispatch = (matcher) => (...events) => {

package/lib/useCan.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useCan.cjs","names":["useSync","deepEqual","identity","expandFn"],"sources":["../src/useCan.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for querying event capabilities from a service.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Function checking if event types can be accepted.\n *\n * @returns Object helper with `or` and `and` methods to check event availability.\n */\nexport function useCan<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  const dispatch =\n    (matcher: 'some' | 'every') =>\n    (...events: Eo['type'][]) => {\n      const selector = () =>\n        events[matcher](event => service.canEvents(event));\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => deepEqual(first.value, next.value),\n            firstTime: true,\n          });\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,OAId,SAIC;CACD,MAAM,YACH,aACA,GAAG,WAAyB;EAC3B,MAAM,iBACJ,OAAO,QAAQ,EAAC,UAAS,QAAQ,UAAU,KAAK,CAAC;EACnD,QAAA,GAAOA,oBAAAA,QAAAA,EACL,aAAY;GACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;IAClD,SAAS,OAAO,UAAA,GAASC,mBAAAA,UAAAA,CAAU,MAAM,OAAO,KAAK,KAAK;IAC1D,WAAW;GACb,CAAC;GACD,OAAO;EACT,GACA,UACA,UACAC,mBAAAA,QACF;CACF;CAEF,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,QAAA,GADYC,qBAAAA,SAAAA,CAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}
+{"version":3,"file":"useCan.cjs","names":["useSync","deepEqual","identity","expandFn"],"sources":["../src/useCan.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for querying event capabilities from a service.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Function checking if event types can be accepted.\n *\n * @returns Object helper with `or` and `and` methods to check event availability.\n *\n * @see {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}\n */\nexport function useCan<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  const dispatch =\n    (matcher: 'some' | 'every') =>\n    (...events: Eo['type'][]) => {\n      const selector = () => events[matcher](event => service.canEvents(event));\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => deepEqual(first.value, next.value),\n            firstTime: true,\n          });\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,OAId,SAIC;CACD,MAAM,YACH,aACA,GAAG,WAAyB;EAC3B,MAAM,iBAAiB,OAAO,QAAQ,EAAC,UAAS,QAAQ,UAAU,KAAK,CAAC;EACxE,QAAA,GAAOA,oBAAAA,QAAAA,EACL,aAAY;GACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;IAClD,SAAS,OAAO,UAAA,GAASC,mBAAAA,UAAAA,CAAU,MAAM,OAAO,KAAK,KAAK;IAC1D,WAAW;GACb,CAAC;GACD,OAAO;EACT,GACA,UACA,UACAC,mBAAAA,QACF;CACF;CAEF,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,QAAA,GADYC,qBAAAA,SAAAA,CAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}

package/lib/useCan.d.ts

@@ -2,9 +2,9 @@ import { type AddSubscriber_F, type EventObject, type PrimitiveObject, type Stat
 /**
  * React hook that creates reactive helpers for querying event capabilities from a service.
  *
- * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
- * @template {string} Ta - Tag type extending `string`.
- * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+ * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+ * @template `Ta` - Tag type extending `string`.
+ * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
  *
  * @param service - Service object containing `subscribe`, `state`, and `canEvents`.
  * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
@@ -12,6 +12,8 @@ import { type AddSubscriber_F, type EventObject, type PrimitiveObject, type Stat
  * @param service.canEvents - Function checking if event types can be accepted.
  *
  * @returns Object helper with `or` and `and` methods to check event availability.
+ *
+ * @see {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}
  */
 export declare function useCan<Tc extends PrimitiveObject, Ta extends string, Eo extends EventObject>(service: {
     subscribe: AddSubscriber_F<Tc, Ta, Eo>;

package/lib/useCan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCan.d.ts","sourceRoot":"","sources":["../src/useCan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAKtB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CACpB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,OAAO,EAAE;IACT,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC;CACjD,sDAGe,EAAE,CAAC,MAAM,CAAC,EAAE;6BAAZ,EAAE,CAAC,MAAM,CAAC,EAAE;8BAAZ,EAAE,CAAC,MAAM,CAAC,EAAE;GAqB3B"}
+{"version":3,"file":"useCan.d.ts","sourceRoot":"","sources":["../src/useCan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAKtB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CACpB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,OAAO,EAAE;IACT,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC;CACjD,sDAGe,EAAE,CAAC,MAAM,CAAC,EAAE;6BAAZ,EAAE,CAAC,MAAM,CAAC,EAAE;8BAAZ,EAAE,CAAC,MAAM,CAAC,EAAE;GAoB3B"}

package/lib/useCan.js

@@ -5,9 +5,9 @@ import { expandFn } from "@bemedev/app/bemedev";
 /**
 * React hook that creates reactive helpers for querying event capabilities from a service.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
 *
 * @param service - Service object containing `subscribe`, `state`, and `canEvents`.
 * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
@@ -15,6 +15,8 @@ import { expandFn } from "@bemedev/app/bemedev";
 * @param service.canEvents - Function checking if event types can be accepted.
 *
 * @returns Object helper with `or` and `and` methods to check event availability.
+*
+* @see {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}
 */
 function useCan(service) {
 	const dispatch = (matcher) => (...events) => {

package/lib/useCan.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCan.js","names":[],"sources":["../src/useCan.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for querying event capabilities from a service.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Function checking if event types can be accepted.\n *\n * @returns Object helper with `or` and `and` methods to check event availability.\n */\nexport function useCan<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  const dispatch =\n    (matcher: 'some' | 'every') =>\n    (...events: Eo['type'][]) => {\n      const selector = () =>\n        events[matcher](event => service.canEvents(event));\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => deepEqual(first.value, next.value),\n            firstTime: true,\n          });\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwBA,SAAgB,OAId,SAIC;CACD,MAAM,YACH,aACA,GAAG,WAAyB;EAC3B,MAAM,iBACJ,OAAO,QAAQ,EAAC,UAAS,QAAQ,UAAU,KAAK,CAAC;EACnD,OAAO,SACL,aAAY;GACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;IAClD,SAAS,OAAO,SAAS,UAAU,MAAM,OAAO,KAAK,KAAK;IAC1D,WAAW;GACb,CAAC;GACD,OAAO;EACT,GACA,UACA,UACA,QACF;CACF;CAEF,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,OADY,SAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}
+{"version":3,"file":"useCan.js","names":[],"sources":["../src/useCan.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for querying event capabilities from a service.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Function checking if event types can be accepted.\n *\n * @returns Object helper with `or` and `and` methods to check event availability.\n *\n * @see {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}\n */\nexport function useCan<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  const dispatch =\n    (matcher: 'some' | 'every') =>\n    (...events: Eo['type'][]) => {\n      const selector = () => events[matcher](event => service.canEvents(event));\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => deepEqual(first.value, next.value),\n            firstTime: true,\n          });\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,OAId,SAIC;CACD,MAAM,YACH,aACA,GAAG,WAAyB;EAC3B,MAAM,iBAAiB,OAAO,QAAQ,EAAC,UAAS,QAAQ,UAAU,KAAK,CAAC;EACxE,OAAO,SACL,aAAY;GACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;IAClD,SAAS,OAAO,SAAS,UAAU,MAAM,OAAO,KAAK,KAAK;IAC1D,WAAW;GACb,CAAC;GACD,OAAO;EACT,GACA,UACA,UACA,QACF;CACF;CAEF,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,OADY,SAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}

package/lib/useIsInside.cjs

@@ -6,15 +6,17 @@ let _bemedev_app_bemedev = require("@bemedev/app/bemedev");
 /**
 * React hook that creates reactive helpers for checking active state hierarchy.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
 *
 * @param service - Service object containing `subscribe` and `state`.
 * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
 * @param service.state - Current state of type {@linkcode State}.
 *
 * @returns Object helper with `or` and `and` methods to check state hierarchy.
+*
+* @see {@linkcode decomposeSV}, {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}
 */
 function useIsInside(service) {
 	const selector1 = (value) => {

package/lib/useIsInside.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useIsInside.cjs","names":["decomposeSV","useSync","deepEqual","identity","expandFn"],"sources":["../src/useIsInside.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n  StateValue,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { decomposeSV, deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for checking active state hierarchy.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe` and `state`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n *\n * @returns Object helper with `or` and `and` methods to check state hierarchy.\n */\nexport function useIsInside<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n}) {\n  const selector1 = (value: StateValue) => {\n    return decomposeSV(value);\n  };\n\n  const dispatch = (matcher: 'some' | 'every') => {\n    return (...states: string[]) => {\n      const selector = () =>\n        states[matcher](state =>\n          selector1(service.state.value).includes(state),\n        );\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => {\n              return deepEqual(first.value, next.value);\n            },\n            firstTime: true,\n          });\n\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n  };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwBA,SAAgB,YAId,SAGC;CACD,MAAM,aAAa,UAAsB;EACvC,QAAA,GAAOA,mBAAAA,YAAAA,CAAY,KAAK;CAC1B;CAEA,MAAM,YAAY,YAA8B;EAC9C,QAAQ,GAAG,WAAqB;GAC9B,MAAM,iBACJ,OAAO,QAAQ,EAAC,UACd,UAAU,QAAQ,MAAM,KAAK,CAAC,CAAC,SAAS,KAAK,CAC/C;GACF,QAAA,GAAOC,oBAAAA,QAAAA,EACL,aAAY;IACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;KAClD,SAAS,OAAO,SAAS;MACvB,QAAA,GAAOC,mBAAAA,UAAAA,CAAU,MAAM,OAAO,KAAK,KAAK;KAC1C;KACA,WAAW;IACb,CAAC;IAED,OAAO;GACT,GACA,UACA,UACAC,mBAAAA,QACF;EACF;CACF;CAEA,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,QAAA,GADYC,qBAAAA,SAAAA,CAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}
+{"version":3,"file":"useIsInside.cjs","names":["decomposeSV","useSync","deepEqual","identity","expandFn"],"sources":["../src/useIsInside.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n  StateValue,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { decomposeSV, deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for checking active state hierarchy.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe` and `state`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n *\n * @returns Object helper with `or` and `and` methods to check state hierarchy.\n *\n * @see {@linkcode decomposeSV}, {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}\n */\nexport function useIsInside<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: { subscribe: AddSubscriber_F<Tc, Ta, Eo>; state: State<Eo, Tc, Ta> }) {\n  const selector1 = (value: StateValue) => {\n    return decomposeSV(value);\n  };\n\n  const dispatch = (matcher: 'some' | 'every') => {\n    return (...states: string[]) => {\n      const selector = () =>\n        states[matcher](state => selector1(service.state.value).includes(state));\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => {\n              return deepEqual(first.value, next.value);\n            },\n            firstTime: true,\n          });\n\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n  };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,YAId,SAA+E;CAC/E,MAAM,aAAa,UAAsB;EACvC,QAAA,GAAOA,mBAAAA,YAAAA,CAAY,KAAK;CAC1B;CAEA,MAAM,YAAY,YAA8B;EAC9C,QAAQ,GAAG,WAAqB;GAC9B,MAAM,iBACJ,OAAO,QAAQ,EAAC,UAAS,UAAU,QAAQ,MAAM,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC;GACzE,QAAA,GAAOC,oBAAAA,QAAAA,EACL,aAAY;IACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;KAClD,SAAS,OAAO,SAAS;MACvB,QAAA,GAAOC,mBAAAA,UAAAA,CAAU,MAAM,OAAO,KAAK,KAAK;KAC1C;KACA,WAAW;IACb,CAAC;IAED,OAAO;GACT,GACA,UACA,UACAC,mBAAAA,QACF;EACF;CACF;CAEA,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,QAAA,GADYC,qBAAAA,SAAAA,CAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}

package/lib/useIsInside.d.ts

@@ -2,15 +2,17 @@ import type { AddSubscriber_F, EventObject, PrimitiveObject, State } from '@beme
 /**
  * React hook that creates reactive helpers for checking active state hierarchy.
  *
- * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
- * @template {string} Ta - Tag type extending `string`.
- * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+ * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+ * @template `Ta` - Tag type extending `string`.
+ * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
  *
  * @param service - Service object containing `subscribe` and `state`.
  * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
  * @param service.state - Current state of type {@linkcode State}.
  *
  * @returns Object helper with `or` and `and` methods to check state hierarchy.
+ *
+ * @see {@linkcode decomposeSV}, {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}
  */
 export declare function useIsInside<Tc extends PrimitiveObject, Ta extends string, Eo extends EventObject>(service: {
     subscribe: AddSubscriber_F<Tc, Ta, Eo>;

package/lib/useIsInside.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIsInside.d.ts","sourceRoot":"","sources":["../src/useIsInside.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,KAAK,EAEN,MAAM,cAAc,CAAC;AAKtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,OAAO,EAAE;IACT,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC1B,sDAMsB,MAAM,EAAE;6BAAR,MAAM,EAAE;8BAAR,MAAM,EAAE;GA2B9B"}
+{"version":3,"file":"useIsInside.d.ts","sourceRoot":"","sources":["../src/useIsInside.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,KAAK,EAEN,MAAM,cAAc,CAAC;AAKtB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,OAAO,EAAE;IAAE,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;CAAE,sDAMxD,MAAM,EAAE;6BAAR,MAAM,EAAE;8BAAR,MAAM,EAAE;GAyB9B"}

package/lib/useIsInside.js

@@ -5,15 +5,17 @@ import { expandFn } from "@bemedev/app/bemedev";
 /**
 * React hook that creates reactive helpers for checking active state hierarchy.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
 *
 * @param service - Service object containing `subscribe` and `state`.
 * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
 * @param service.state - Current state of type {@linkcode State}.
 *
 * @returns Object helper with `or` and `and` methods to check state hierarchy.
+*
+* @see {@linkcode decomposeSV}, {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}
 */
 function useIsInside(service) {
 	const selector1 = (value) => {

package/lib/useIsInside.js.map

@@ -1 +1 @@
-{"version":3,"file":"useIsInside.js","names":[],"sources":["../src/useIsInside.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n  StateValue,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { decomposeSV, deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for checking active state hierarchy.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe` and `state`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n *\n * @returns Object helper with `or` and `and` methods to check state hierarchy.\n */\nexport function useIsInside<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n}) {\n  const selector1 = (value: StateValue) => {\n    return decomposeSV(value);\n  };\n\n  const dispatch = (matcher: 'some' | 'every') => {\n    return (...states: string[]) => {\n      const selector = () =>\n        states[matcher](state =>\n          selector1(service.state.value).includes(state),\n        );\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => {\n              return deepEqual(first.value, next.value);\n            },\n            firstTime: true,\n          });\n\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n  };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,SAAgB,YAId,SAGC;CACD,MAAM,aAAa,UAAsB;EACvC,OAAO,YAAY,KAAK;CAC1B;CAEA,MAAM,YAAY,YAA8B;EAC9C,QAAQ,GAAG,WAAqB;GAC9B,MAAM,iBACJ,OAAO,QAAQ,EAAC,UACd,UAAU,QAAQ,MAAM,KAAK,CAAC,CAAC,SAAS,KAAK,CAC/C;GACF,OAAO,SACL,aAAY;IACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;KAClD,SAAS,OAAO,SAAS;MACvB,OAAO,UAAU,MAAM,OAAO,KAAK,KAAK;KAC1C;KACA,WAAW;IACb,CAAC;IAED,OAAO;GACT,GACA,UACA,UACA,QACF;EACF;CACF;CAEA,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,OADY,SAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}
+{"version":3,"file":"useIsInside.js","names":[],"sources":["../src/useIsInside.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n  StateValue,\n} from '@bemedev/app';\nimport { expandFn } from '@bemedev/app/bemedev';\nimport { decomposeSV, deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\n\n/**\n * React hook that creates reactive helpers for checking active state hierarchy.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service object containing `subscribe` and `state`.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n *\n * @returns Object helper with `or` and `and` methods to check state hierarchy.\n *\n * @see {@linkcode decomposeSV}, {@linkcode useSync}, {@linkcode expandFn}, {@linkcode deepEqual}, {@linkcode identity}\n */\nexport function useIsInside<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: { subscribe: AddSubscriber_F<Tc, Ta, Eo>; state: State<Eo, Tc, Ta> }) {\n  const selector1 = (value: StateValue) => {\n    return decomposeSV(value);\n  };\n\n  const dispatch = (matcher: 'some' | 'every') => {\n    return (...states: string[]) => {\n      const selector = () =>\n        states[matcher](state => selector1(service.state.value).includes(state));\n      return useSync(\n        listener => {\n          const { unsubscribe } = service.subscribe(listener, {\n            equals: (first, next) => {\n              return deepEqual(first.value, next.value);\n            },\n            firstTime: true,\n          });\n\n          return unsubscribe;\n        },\n        selector,\n        selector,\n        identity,\n      );\n    };\n  };\n\n  const or = dispatch('some');\n  const and = dispatch('every');\n  const out = expandFn(and, { or, and });\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,YAId,SAA+E;CAC/E,MAAM,aAAa,UAAsB;EACvC,OAAO,YAAY,KAAK;CAC1B;CAEA,MAAM,YAAY,YAA8B;EAC9C,QAAQ,GAAG,WAAqB;GAC9B,MAAM,iBACJ,OAAO,QAAQ,EAAC,UAAS,UAAU,QAAQ,MAAM,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC;GACzE,OAAO,SACL,aAAY;IACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;KAClD,SAAS,OAAO,SAAS;MACvB,OAAO,UAAU,MAAM,OAAO,KAAK,KAAK;KAC1C;KACA,WAAW;IACb,CAAC;IAED,OAAO;GACT,GACA,UACA,UACA,QACF;EACF;CACF;CAEA,MAAM,KAAK,SAAS,MAAM;CAC1B,MAAM,MAAM,SAAS,OAAO;CAE5B,OADY,SAAS,KAAK;EAAE;EAAI;CAAI,CAC3B;AACX"}

package/lib/useService.cjs

@@ -6,9 +6,9 @@ const require_useIsInside = require("./useIsInside.cjs");
 /**
 * React hook that binds state management, event checking, and hierarchy querying for a service.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
 *
 * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.
 * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.
@@ -16,6 +16,8 @@ const require_useIsInside = require("./useIsInside.cjs");
 * @param service.canEvents - Method to check event execution capability.
 *
 * @returns Service hooks object containing `state`, `can`, and `isInside`.
+*
+* @see {@linkcode useState}, {@linkcode useCan}, {@linkcode useIsInside}, -- type {@linkcode UseServiceOptions}
 */
 function useService(service) {
 	return {

package/lib/useService.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useService.cjs","names":["useState","useCan","useIsInside"],"sources":["../src/useService.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n} from '@bemedev/app';\nimport type { UseServiceOptions } from './types';\nimport { useCan } from './useCan';\nimport { useIsInside } from './useIsInside';\nimport { useState } from './useState';\n\n/**\n * React hook that binds state management, event checking, and hierarchy querying for a service.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Method to check event execution capability.\n *\n * @returns Service hooks object containing `state`, `can`, and `isInside`.\n */\nexport function useService<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  return {\n    state: <T = State<Eo, Tc, Ta>>(\n      options?: UseServiceOptions<Tc, Ta, Eo, T>,\n    ) => useState<Tc, Ta, Eo, T>(service, options),\n\n    can: useCan(service),\n    isInside: useIsInside(service),\n  };\n}\n\n/**\n * Alias for function {@linkcode useService}.\n */\nexport const createHooks = useService;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,WAId,SAIC;CACD,OAAO;EACL,QACE,YACGA,iBAAAA,SAAwB,SAAS,OAAO;EAE7C,KAAKC,eAAAA,OAAO,OAAO;EACnB,UAAUC,oBAAAA,YAAY,OAAO;CAC/B;AACF;;;;AAKA,MAAa,cAAc"}
+{"version":3,"file":"useService.cjs","names":["useState","useCan","useIsInside"],"sources":["../src/useService.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n} from '@bemedev/app';\nimport type { UseServiceOptions } from './types';\nimport { useCan } from './useCan';\nimport { useIsInside } from './useIsInside';\nimport { useState } from './useState';\n\n/**\n * React hook that binds state management, event checking, and hierarchy querying for a service.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Method to check event execution capability.\n *\n * @returns Service hooks object containing `state`, `can`, and `isInside`.\n *\n * @see {@linkcode useState}, {@linkcode useCan}, {@linkcode useIsInside}, -- type {@linkcode UseServiceOptions}\n */\nexport function useService<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  return {\n    state: <T = State<Eo, Tc, Ta>>(options?: UseServiceOptions<Tc, Ta, Eo, T>) =>\n      useState<Tc, Ta, Eo, T>(service, options),\n\n    can: useCan(service),\n    isInside: useIsInside(service),\n  };\n}\n\n/**\n * Alias for function {@linkcode useService}.\n */\nexport const createHooks = useService;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,WAId,SAIC;CACD,OAAO;EACL,QAA+B,YAC7BA,iBAAAA,SAAwB,SAAS,OAAO;EAE1C,KAAKC,eAAAA,OAAO,OAAO;EACnB,UAAUC,oBAAAA,YAAY,OAAO;CAC/B;AACF;;;;AAKA,MAAa,cAAc"}

package/lib/useService.d.ts

@@ -3,9 +3,9 @@ import type { UseServiceOptions } from './types';
 /**
  * React hook that binds state management, event checking, and hierarchy querying for a service.
  *
- * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
- * @template {string} Ta - Tag type extending `string`.
- * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+ * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+ * @template `Ta` - Tag type extending `string`.
+ * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
  *
  * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.
  * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.
@@ -13,6 +13,8 @@ import type { UseServiceOptions } from './types';
  * @param service.canEvents - Method to check event execution capability.
  *
  * @returns Service hooks object containing `state`, `can`, and `isInside`.
+ *
+ * @see {@linkcode useState}, {@linkcode useCan}, {@linkcode useIsInside}, -- type {@linkcode UseServiceOptions}
  */
 export declare function useService<Tc extends PrimitiveObject, Ta extends string, Eo extends EventObject>(service: {
     subscribe: AddSubscriber_F<Tc, Ta, Eo>;

package/lib/useService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useService.d.ts","sourceRoot":"","sources":["../src/useService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,KAAK,EACN,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,OAAO,EAAE;IACT,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC;CACjD;YAEW,CAAC,gCACG,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;;;;;;;;;EAM/C;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,mBAAa,CAAC"}
+{"version":3,"file":"useService.d.ts","sourceRoot":"","sources":["../src/useService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,KAAK,EACN,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,OAAO,EAAE;IACT,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC;CACjD;YAEW,CAAC,gCAAgC,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;;;;;;;;;EAM5E;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,mBAAa,CAAC"}

package/lib/useService.js

@@ -5,9 +5,9 @@ import { useIsInside } from "./useIsInside.js";
 /**
 * React hook that binds state management, event checking, and hierarchy querying for a service.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
 *
 * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.
 * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.
@@ -15,6 +15,8 @@ import { useIsInside } from "./useIsInside.js";
 * @param service.canEvents - Method to check event execution capability.
 *
 * @returns Service hooks object containing `state`, `can`, and `isInside`.
+*
+* @see {@linkcode useState}, {@linkcode useCan}, {@linkcode useIsInside}, -- type {@linkcode UseServiceOptions}
 */
 function useService(service) {
 	return {

package/lib/useService.js.map

@@ -1 +1 @@
-{"version":3,"file":"useService.js","names":[],"sources":["../src/useService.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n} from '@bemedev/app';\nimport type { UseServiceOptions } from './types';\nimport { useCan } from './useCan';\nimport { useIsInside } from './useIsInside';\nimport { useState } from './useState';\n\n/**\n * React hook that binds state management, event checking, and hierarchy querying for a service.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Method to check event execution capability.\n *\n * @returns Service hooks object containing `state`, `can`, and `isInside`.\n */\nexport function useService<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  return {\n    state: <T = State<Eo, Tc, Ta>>(\n      options?: UseServiceOptions<Tc, Ta, Eo, T>,\n    ) => useState<Tc, Ta, Eo, T>(service, options),\n\n    can: useCan(service),\n    isInside: useIsInside(service),\n  };\n}\n\n/**\n * Alias for function {@linkcode useService}.\n */\nexport const createHooks = useService;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,SAAgB,WAId,SAIC;CACD,OAAO;EACL,QACE,YACG,SAAwB,SAAS,OAAO;EAE7C,KAAK,OAAO,OAAO;EACnB,UAAU,YAAY,OAAO;CAC/B;AACF;;;;AAKA,MAAa,cAAc"}
+{"version":3,"file":"useService.js","names":[],"sources":["../src/useService.ts"],"sourcesContent":["import type {\n  AddSubscriber_F,\n  EventObject,\n  PrimitiveObject,\n  State,\n} from '@bemedev/app';\nimport type { UseServiceOptions } from './types';\nimport { useCan } from './useCan';\nimport { useIsInside } from './useIsInside';\nimport { useState } from './useState';\n\n/**\n * React hook that binds state management, event checking, and hierarchy querying for a service.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n *\n * @param service - Service instance containing `subscribe`, `state`, and `canEvents`.\n * @param service.subscribe - Subscription function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param service.canEvents - Method to check event execution capability.\n *\n * @returns Service hooks object containing `state`, `can`, and `isInside`.\n *\n * @see {@linkcode useState}, {@linkcode useCan}, {@linkcode useIsInside}, -- type {@linkcode UseServiceOptions}\n */\nexport function useService<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n>(service: {\n  subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n  state: State<Eo, Tc, Ta>;\n  canEvents: (...events: Eo['type'][]) => boolean;\n}) {\n  return {\n    state: <T = State<Eo, Tc, Ta>>(options?: UseServiceOptions<Tc, Ta, Eo, T>) =>\n      useState<Tc, Ta, Eo, T>(service, options),\n\n    can: useCan(service),\n    isInside: useIsInside(service),\n  };\n}\n\n/**\n * Alias for function {@linkcode useService}.\n */\nexport const createHooks = useService;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,WAId,SAIC;CACD,OAAO;EACL,QAA+B,YAC7B,SAAwB,SAAS,OAAO;EAE1C,KAAK,OAAO,OAAO;EACnB,UAAU,YAAY,OAAO;CAC/B;AACF;;;;AAKA,MAAa,cAAc"}

package/lib/useState.cjs

@@ -5,10 +5,10 @@ let _bemedev_react_sync = require("@bemedev/react-sync");
 /**
 * A hook that creates a React state from a service with a subscribe function.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
-* @template T - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
+* @template `T` - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
 *
 * @param service - The service containing state and subscribe method.
 * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
@@ -16,6 +16,8 @@ let _bemedev_react_sync = require("@bemedev/react-sync");
 * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.
 *
 * @returns The selected state of type `T`.
+*
+* @see {@linkcode useSync}, {@linkcode deepEqual}, {@linkcode identity}
 */
 function useState(service, options) {
 	const { selector = _bemedev_app_utils.identity, equals = _bemedev_app_utils.deepEqual } = options ?? {};

package/lib/useState.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useState.cjs","names":["identity","deepEqual","useSync"],"sources":["../src/useState.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\nimport type { UseServiceOptions } from './types';\n\n/**\n * A hook that creates a React state from a service with a subscribe function.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n * @template T - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.\n *\n * @param service - The service containing state and subscribe method.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.\n *\n * @returns The selected state of type `T`.\n */\nexport function useState<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n  T = State<Eo, Tc, Ta>,\n>(\n  service: {\n    subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n    state: State<Eo, Tc, Ta>;\n  },\n  options?: UseServiceOptions<Tc, Ta, Eo, T>,\n): T {\n  const { selector = identity, equals = deepEqual<T> } = options ?? {};\n  const _selector = () => selector(service.state);\n\n  return useSync(\n    listener => {\n      const { unsubscribe } = service.subscribe(listener, {\n        equals: (prev, next) => {\n          const _prev = selector(prev);\n          const _next = selector(next);\n          return equals(_prev, _next);\n        },\n        firstTime: true,\n      });\n      return unsubscribe;\n    },\n    _selector,\n    _selector,\n    identity,\n    equals,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,SAMd,SAIA,SACG;CACH,MAAM,EAAE,WAAWA,mBAAAA,UAAU,SAASC,mBAAAA,cAAiB,WAAW,CAAC;CACnE,MAAM,kBAAkB,SAAS,QAAQ,KAAK;CAE9C,QAAA,GAAOC,oBAAAA,QAAAA,EACL,aAAY;EACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;GAClD,SAAS,MAAM,SAAS;IACtB,MAAM,QAAQ,SAAS,IAAI;IAC3B,MAAM,QAAQ,SAAS,IAAI;IAC3B,OAAO,OAAO,OAAO,KAAK;GAC5B;GACA,WAAW;EACb,CAAC;EACD,OAAO;CACT,GACA,WACA,WACAF,mBAAAA,UACA,MACF;AACF"}
+{"version":3,"file":"useState.cjs","names":["identity","deepEqual","useSync"],"sources":["../src/useState.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\nimport type { UseServiceOptions } from './types';\n\n/**\n * A hook that creates a React state from a service with a subscribe function.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n * @template `T` - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.\n *\n * @param service - The service containing state and subscribe method.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.\n *\n * @returns The selected state of type `T`.\n *\n * @see {@linkcode useSync}, {@linkcode deepEqual}, {@linkcode identity}\n */\nexport function useState<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n  T = State<Eo, Tc, Ta>,\n>(\n  service: { subscribe: AddSubscriber_F<Tc, Ta, Eo>; state: State<Eo, Tc, Ta> },\n  options?: UseServiceOptions<Tc, Ta, Eo, T>,\n): T {\n  const { selector = identity, equals = deepEqual<T> } = options ?? {};\n  const _selector = () => selector(service.state);\n\n  return useSync(\n    listener => {\n      const { unsubscribe } = service.subscribe(listener, {\n        equals: (prev, next) => {\n          const _prev = selector(prev);\n          const _next = selector(next);\n          return equals(_prev, _next);\n        },\n        firstTime: true,\n      });\n      return unsubscribe;\n    },\n    _selector,\n    _selector,\n    identity,\n    equals,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,SAMd,SACA,SACG;CACH,MAAM,EAAE,WAAWA,mBAAAA,UAAU,SAASC,mBAAAA,cAAiB,WAAW,CAAC;CACnE,MAAM,kBAAkB,SAAS,QAAQ,KAAK;CAE9C,QAAA,GAAOC,oBAAAA,QAAAA,EACL,aAAY;EACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;GAClD,SAAS,MAAM,SAAS;IACtB,MAAM,QAAQ,SAAS,IAAI;IAC3B,MAAM,QAAQ,SAAS,IAAI;IAC3B,OAAO,OAAO,OAAO,KAAK;GAC5B;GACA,WAAW;EACb,CAAC;EACD,OAAO;CACT,GACA,WACA,WACAF,mBAAAA,UACA,MACF;AACF"}

package/lib/useState.d.ts

@@ -3,10 +3,10 @@ import type { UseServiceOptions } from './types';
 /**
  * A hook that creates a React state from a service with a subscribe function.
  *
- * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
- * @template {string} Ta - Tag type extending `string`.
- * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
- * @template T - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
+ * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+ * @template `Ta` - Tag type extending `string`.
+ * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
+ * @template `T` - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
  *
  * @param service - The service containing state and subscribe method.
  * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
@@ -14,6 +14,8 @@ import type { UseServiceOptions } from './types';
  * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.
  *
  * @returns The selected state of type `T`.
+ *
+ * @see {@linkcode useSync}, {@linkcode deepEqual}, {@linkcode identity}
  */
 export declare function useState<Tc extends PrimitiveObject, Ta extends string, Eo extends EventObject, T = State<Eo, Tc, Ta>>(service: {
     subscribe: AddSubscriber_F<Tc, Ta, Eo>;

package/lib/useState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useState.d.ts","sourceRoot":"","sources":["../src/useState.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CACtB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAErB,OAAO,EAAE;IACP,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC1B,EACD,OAAO,CAAC,EAAE,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GACzC,CAAC,CAqBH"}
+{"version":3,"file":"useState.d.ts","sourceRoot":"","sources":["../src/useState.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,EAAE,SAAS,eAAe,EAC1B,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,WAAW,EACtB,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAErB,OAAO,EAAE;IAAE,SAAS,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;CAAE,EAC7E,OAAO,CAAC,EAAE,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GACzC,CAAC,CAqBH"}

package/lib/useState.js

@@ -4,10 +4,10 @@ import { useSync } from "@bemedev/react-sync";
 /**
 * A hook that creates a React state from a service with a subscribe function.
 *
-* @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.
-* @template {string} Ta - Tag type extending `string`.
-* @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.
-* @template T - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
+* @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.
+* @template `Ta` - Tag type extending `string`.
+* @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.
+* @template `T` - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.
 *
 * @param service - The service containing state and subscribe method.
 * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.
@@ -15,6 +15,8 @@ import { useSync } from "@bemedev/react-sync";
 * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.
 *
 * @returns The selected state of type `T`.
+*
+* @see {@linkcode useSync}, {@linkcode deepEqual}, {@linkcode identity}
 */
 function useState(service, options) {
 	const { selector = identity, equals = deepEqual } = options ?? {};

package/lib/useState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useState.js","names":[],"sources":["../src/useState.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\nimport type { UseServiceOptions } from './types';\n\n/**\n * A hook that creates a React state from a service with a subscribe function.\n *\n * @template {PrimitiveObject} Tc - Context type extending type {@linkcode PrimitiveObject}.\n * @template {string} Ta - Tag type extending `string`.\n * @template {EventObject} Eo - Event object type extending type {@linkcode EventObject}.\n * @template T - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.\n *\n * @param service - The service containing state and subscribe method.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.\n *\n * @returns The selected state of type `T`.\n */\nexport function useState<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n  T = State<Eo, Tc, Ta>,\n>(\n  service: {\n    subscribe: AddSubscriber_F<Tc, Ta, Eo>;\n    state: State<Eo, Tc, Ta>;\n  },\n  options?: UseServiceOptions<Tc, Ta, Eo, T>,\n): T {\n  const { selector = identity, equals = deepEqual<T> } = options ?? {};\n  const _selector = () => selector(service.state);\n\n  return useSync(\n    listener => {\n      const { unsubscribe } = service.subscribe(listener, {\n        equals: (prev, next) => {\n          const _prev = selector(prev);\n          const _next = selector(next);\n          return equals(_prev, _next);\n        },\n        firstTime: true,\n      });\n      return unsubscribe;\n    },\n    _selector,\n    _selector,\n    identity,\n    equals,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,SAAgB,SAMd,SAIA,SACG;CACH,MAAM,EAAE,WAAW,UAAU,SAAS,cAAiB,WAAW,CAAC;CACnE,MAAM,kBAAkB,SAAS,QAAQ,KAAK;CAE9C,OAAO,SACL,aAAY;EACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;GAClD,SAAS,MAAM,SAAS;IACtB,MAAM,QAAQ,SAAS,IAAI;IAC3B,MAAM,QAAQ,SAAS,IAAI;IAC3B,OAAO,OAAO,OAAO,KAAK;GAC5B;GACA,WAAW;EACb,CAAC;EACD,OAAO;CACT,GACA,WACA,WACA,UACA,MACF;AACF"}
+{"version":3,"file":"useState.js","names":[],"sources":["../src/useState.ts"],"sourcesContent":["import {\n  type AddSubscriber_F,\n  type EventObject,\n  type PrimitiveObject,\n  type State,\n} from '@bemedev/app';\nimport { deepEqual, identity } from '@bemedev/app/utils';\nimport { useSync } from '@bemedev/react-sync';\nimport type { UseServiceOptions } from './types';\n\n/**\n * A hook that creates a React state from a service with a subscribe function.\n *\n * @template | {@linkcode PrimitiveObject} `Tc` - Context type extending type {@linkcode PrimitiveObject}.\n * @template `Ta` - Tag type extending `string`.\n * @template | {@linkcode EventObject} `Eo` - Event object type extending type {@linkcode EventObject}.\n * @template `T` - Selected state type, defaults to type {@linkcode State}<{@linkcode Eo}, {@linkcode Tc}, {@linkcode Ta}>.\n *\n * @param service - The service containing state and subscribe method.\n * @param service.subscribe - Subscription handler function of type {@linkcode AddSubscriber_F}.\n * @param service.state - Current state of type {@linkcode State}.\n * @param options - Optional configuration options of type {@linkcode UseServiceOptions}.\n *\n * @returns The selected state of type `T`.\n *\n * @see {@linkcode useSync}, {@linkcode deepEqual}, {@linkcode identity}\n */\nexport function useState<\n  Tc extends PrimitiveObject,\n  Ta extends string,\n  Eo extends EventObject,\n  T = State<Eo, Tc, Ta>,\n>(\n  service: { subscribe: AddSubscriber_F<Tc, Ta, Eo>; state: State<Eo, Tc, Ta> },\n  options?: UseServiceOptions<Tc, Ta, Eo, T>,\n): T {\n  const { selector = identity, equals = deepEqual<T> } = options ?? {};\n  const _selector = () => selector(service.state);\n\n  return useSync(\n    listener => {\n      const { unsubscribe } = service.subscribe(listener, {\n        equals: (prev, next) => {\n          const _prev = selector(prev);\n          const _next = selector(next);\n          return equals(_prev, _next);\n        },\n        firstTime: true,\n      });\n      return unsubscribe;\n    },\n    _selector,\n    _selector,\n    identity,\n    equals,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,SAMd,SACA,SACG;CACH,MAAM,EAAE,WAAW,UAAU,SAAS,cAAiB,WAAW,CAAC;CACnE,MAAM,kBAAkB,SAAS,QAAQ,KAAK;CAE9C,OAAO,SACL,aAAY;EACV,MAAM,EAAE,gBAAgB,QAAQ,UAAU,UAAU;GAClD,SAAS,MAAM,SAAS;IACtB,MAAM,QAAQ,SAAS,IAAI;IAC3B,MAAM,QAAQ,SAAS,IAAI;IAC3B,OAAO,OAAO,OAAO,KAAK;GAC5B;GACA,WAAW;EACb,CAAC;EACD,OAAO;CACT,GACA,WACA,WACA,UACA,MACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bemedev/app-reactjs",
-  "version": "1.11.0",
+  "version": "2.0.0",
   "description": "Middleware between @bemedev/app and reactjs",
   "keywords": [
     "app",
@@ -45,7 +45,7 @@
   "types": "lib/index.d.ts",
   "devDependencies": {
     "@bemedev/decompose": "2.3.0",
-    "@bemedev/dev-utils": "^1.1.1",
+    "@bemedev/dev-utils": "^1.2.0",
     "@bemedev/sleep": "^0.2.2",
     "@size-limit/file": "^13.0.3",
     "@testing-library/jest-dom": "^7.0.1",
@@ -54,32 +54,32 @@
     "@types/node": "^26.2.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
-    "@vitest/coverage-v8": "^4.1.10",
-    "@vitest/ui": "4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
+    "@vitest/ui": "4.1.11",
     "glob": "^13.0.6",
     "globals": "^17.11.0",
     "husky": "^9.1.7",
     "jsdom": "^30.0.1",
     "onchange": "^7.1.0",
-    "oxfmt": "^0.63.0",
-    "oxlint": "^1.78.0",
+    "oxfmt": "^0.64.0",
+    "oxlint": "^1.79.0",
     "prettier": "^3.9.6",
     "pretty-quick": "^4.2.2",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "rolldown": "1.2.4",
+    "rolldown": "1.2.5",
     "rolldown-plugin-dts": "^0.28.2",
     "size-limit": "^13.0.3",
     "tslib": "^2.8.1",
     "tsx": "^4.23.12",
     "typescript": "6.0.3",
-    "vitest": "^4.1.10",
-    "@bemedev/app": "^1.11.0",
-    "@bemedev/app-vitest": "^1.11.0"
+    "vitest": "^4.1.11",
+    "@bemedev/app": "^2.0.0",
+    "@bemedev/app-vitest": "^2.0.0"
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@bemedev/app": "^1.11.0"
+    "@bemedev/app": "^2.0.0"
   },
   "size-limit": [
     {