feat: add ctx.useReactive

package.json

@@ -1,6 +1,6 @@
 {
   "name": "helux",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "A state library core that integrates atom, signal, collection dep, derive and watch, it supports all react like frameworks( including react 18 ).",
   "keywords": [],
   "author": {

packages/helux-core/src/consts/user.ts

@@ -1,6 +1,6 @@
 import { VER as limuVer } from 'limu';
 
-export const VER = '3.5.0';
+export const VER = '3.5.1';
 
 export const LIMU_VER = limuVer;
 

packages/helux-core/src/factory/createShared.ts

@@ -1,6 +1,7 @@
 import { noop } from '@helux/utils';
 import { FROM, STATE_TYPE } from '../consts';
 import { useAtom, useShared } from '../hooks/useShared';
+import { useReactive } from '../hooks/useReactive';
 import type { CoreApiCtx } from '../types/api-ctx';
 import type { Dict, Fn, IAtomCreateOptions, IAtomCtx, ICreateOptions, IRunMutateOptions, ISharedCtx } from '../types/base';
 import { action, actionAsync, atomAction, atomActionAsync } from './createAction';
@@ -63,6 +64,7 @@ export function createSharedLogic(innerOptions: IInnerOptions, createOptions?: a
     call: (fn: Fn, ...args: any[]) => actionCreator(fn)(...args),
     callAsync: (fn: Fn, ...args: any[]) => actionAsyncCreator(fn)(...args),
     useState: (options?: any) => useFn(apiCtx, state, options),
+    useReactive: (options?: any) => useReactive(apiCtx, options),
     getMutateLoading: ldMutate.getLoading,
     useMutateLoading: ldMutate.useLoading,
     getActionLoading: ldAction.getLoading,

packages/helux-core/src/types/api.d.ts

@@ -1,6 +1,6 @@
 /*
 |------------------------------------------------------------------------------------------------
-| [email protected].0
+| [email protected].1
 | A state library core that integrates atom, signal, collection dep, derive and watch,
 | it supports all react like frameworks ( including react 18 ).
 |------------------------------------------------------------------------------------------------
@@ -72,7 +72,7 @@ import type {
   WatchOptionsType,
 } from './base';
 
-export declare const VER: '3.5.0';
+export declare const VER: '3.5.1';
 
 export declare const LIMU_VER: string;
 

packages/helux-core/src/types/base.d.ts

@@ -458,6 +458,7 @@ export interface ISharedStateCtxBase<T = any> {
   sharedKeyStr: string;
   rootValKey: string;
   reactive: T;
+  useReactive: (options?: IUseSharedStateOptions<T>) => [InsReactiveState<T>, IInsRenderInfo];
 }
 
 export interface ISharedCtx<T = SharedDict, O extends ICreateOptions<T> = ICreateOptions<T>> extends ISharedStateCtxBase<T> {

packages/helux/__tests__/helux.ts

@@ -2,7 +2,7 @@ import { act } from '@testing-library/react';
 import * as React from 'react';
 import { initHeluxContext } from '../../helux-core/src/index';
 
-window.alert = () => {};
+window.alert = () => { };
 
 // pass act to avoid Warning:
 // An update to TestComponent inside a test was not wrapped in act(...).
@@ -27,6 +27,7 @@ export const {
   // hooks api
   useAtom,
   useShared,
+  useReactive,
   useDerived,
   useDerivedAtom,
   useWatch,
@@ -84,5 +85,7 @@ export const {
   addMiddleware,
   addPlugin,
   EVENT_NAME,
-  LOADING_MODE,
+  RECORD_LOADING,
+  VER,
+  LIMU_VER,
 } = api;

packages/helux/__tests__/hooks/useReactive.test.ts

@@ -0,0 +1,19 @@
+import '@testing-library/jest-dom';
+import { renderHook } from '@testing-library/react';
+import { describe, expect, test } from 'vitest';
+import { derive, share, useDerived, useReactive } from '../helux';
+import { delay, dictFictory } from '../util';
+
+describe('useReactive', () => {
+  test('simple use', async () => {
+    const [state, setState] = share(dictFictory);
+
+    const { result } = renderHook(() => {
+      const [shared] = useReactive(state);
+      return shared.a.b.c;
+    });
+
+    expect(result.current).toBe(1);
+  });
+
+});