react-native-hox 0.0.3 → 1.0.1

package/README.md

@@ -1,27 +1,44 @@
 # react-native-hox
 
-面向 React Native 的轻量状态管理方案：类型安全、API 极简，支持组件内 Hook 与组件外 Vanilla 读写，并内置可选持久化能力。
+面向 React Native 的**极简状态管理**：类型安全、API 零心智负担，单文件架构，包体积极小。
 
 [![NPM Version](https://img.shields.io/npm/v/react-native-hox)](https://www.npmjs.com/package/react-native-hox)
 [![TypeScript](https://img.shields.io/badge/language-TypeScript-blue)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/npm/l/react-native-hox)](https://www.npmjs.com/package/react-native-hox)
 
+---
+
+## 亮点
+
+| 特性 | 说明 |
+|------|------|
+| **包体积极小** | 单入口构建，**gzip 后 ESM ~1.5 KB / CJS ~1.6 KB**；运行时仅依赖 `use-sync-external-store`，持久化可选依赖 AsyncStorage |
+| **类型安全** | 全 TypeScript，`createModel` 泛型推导完整，selector 与 setState 类型即文档 |
+| **API 极简** | 一个 `createModel` 搞定：组件内用 Hook，组件外用 `model.data`，无需 Provider |
+| **按需重渲染** | 支持 selector + 可选 `shallow`，只在关注字段变化时更新组件 |
+| **可选持久化** | 内置 persist（默认 AsyncStorage），支持自定义 storage、防抖、迁移钩子 |
+| **React 18 友好** | 基于 `useSyncExternalStore`，无 tearing，兼容并发渲染 |
+
+---
+
 ## 快速开始
 
 ### 安装
 
 ```bash
-npm i react-native-hox
+npm i react-native-hox @react-native-async-storage/async-storage
 ```
 
+> 项目中已有 `@react-native-async-storage/async-storage` 则无需重复安装。
+
 ### 最小示例
 
 ```ts
 // stores/user.ts
 import { createModel } from 'react-native-hox';
 
-export const userStore = createModel({ name: 'Guest' }); // 数据只存在内存
-// export const userStore = createModel({ name: 'Guest' }, { persist: 'user_v1' }); // 数据存在缓存 AsyncStorage
+export const userStore = createModel({ name: 'Guest' });
+// 持久化：createModel({ name: 'Guest' }, { persist: 'user_v1' });
 ```
 
 ```tsx
@@ -41,198 +58,102 @@ export function Profile() {
 }
 ```
 
-## 功能点
-
-### 1) 更新状态：自动合并 / 显式替换
-
-```ts
-import { createModel } from 'react-native-hox';
-
-export const profileStore = createModel({ name: 'Guest', role: 'user' as 'user' | 'admin' });
-```
-
-```tsx
-import React from 'react';
-import { View, Text, Button } from 'react-native';
-import { profileStore } from './stores/profile';
+---
 
-export function UpdateExample() {
-  const profile = profileStore.getState();
+## 功能概览
 
-  return (
-    <View>
-      <Text>{profile.name}</Text>
-      <Text>{profile.role}</Text>
-      <Button title="Merge Update" onPress={() => profileStore.setState({ name: 'Alice' })} />
-      <Button title="Replace" onPress={() => profileStore.setState({ name: 'Bob', role: 'admin' }, true)} />
-    </View>
-  );
-}
-```
-
-### 2) Selector：只在关注的数据变化时重渲染
+### 1) 更新状态：自动合并 / 显式替换
 
 ```ts
-import { createModel } from 'react-native-hox';
-
-export const counterStore = createModel({ count: 0, text: 'a' });
+const profileStore = createModel({ name: 'Guest', role: 'user' as 'user' | 'admin' });
 ```
 
 ```tsx
-import React from 'react';
-import { View, Text, Button } from 'react-native';
-import { counterStore } from './stores/counter';
-
-export function SelectorExample() {
-  const count = counterStore.getState((s) => s.count);
-
-  return (
-    <View>
-      <Text>{count}</Text>
-      <Button title="Inc" onPress={() => counterStore.setState((s) => ({ count: s.count + 1 }))} />
-      <Button title="Change Text" onPress={() => counterStore.setState({ text: String(Math.random()) })} />
-    </View>
-  );
-}
+profileStore.setState({ name: 'Alice' });                    // 合并
+profileStore.setState({ name: 'Bob', role: 'admin' }, true);  // 整体替换
 ```
 
-当 selector 返回对象/数组时，传入 `equalityFn`（例如 `shallow`）避免无意义重渲染：
+### 2) Selector：只在关注数据变化时重渲染
 
 ```tsx
-import { shallow } from 'react-native-hox';
-import { counterStore } from './stores/counter';
-
+const count = counterStore.getState((s) => s.count);
+// 返回对象时建议用 shallow
 const picked = counterStore.getState((s) => ({ count: s.count }), shallow);
 ```
 
 ### 3) 组件外读写：Vanilla API
 
 ```ts
-import { userStore } from './stores/user';
-
-const name1 = userStore.data.state.name;
-const name2 = userStore.data.getState().name;
-
-const unsub = userStore.data.subscribe((next, prev) => {
-  console.log(next, prev);
-});
-unsub();
-```
-
-### 4) 持久化：persist（默认 AsyncStorage）
-
-只要提供一个 key 即可开启持久化（默认使用 `@react-native-async-storage/async-storage`，无需重复传 `storage`）：
-
-```ts
-import { createModel } from 'react-native-hox';
-
-export const authStore = createModel({ token: '' }, { persist: 'auth_v1' });
+const name = userStore.data.state.name;
+userStore.data.getState();
+userStore.data.subscribe((next, prev) => {});
 ```
 
-如果你希望替换存储引擎，可以在 `persist.storage` 传入实现同等接口的存储对象：
+### 4) 持久化
 
 ```ts
-import { createModel } from 'react-native-hox';
-import type { StorageEngine } from 'react-native-hox';
-
-const storage: StorageEngine = {
-  getItem: async (key) => null,
-  setItem: async (key, value) => {},
-  removeItem: async (key) => {},
-};
-
-export const authStore = createModel({ token: '' }, { persist: { key: 'auth_v1', storage } });
+createModel({ token: '' }, { persist: 'auth_v1' });
+// 或自定义 storage / beforeRecover / beforePersist
+createModel({ token: '' }, { persist: { key: 'auth_v1', storage: myStorage } });
 ```
 
 ### 5) reset / destroy / strict
 
 ```ts
-import { userStore } from './stores/user';
-
 userStore.reset();
 userStore.destroy();
+createModel({ count: 0 }, { strict: { forbidSetStateAfterDestroy: true } });
 ```
 
-```ts
-import { createModel } from 'react-native-hox';
+---
 
-export const strictStore = createModel(
-  { count: 0 },
-  { strict: { forbidSetStateAfterDestroy: true } }
-);
-```
-
-## 进阶使用
+## 进阶
 
-### 1) subscribe(selector)：只在 slice 变化时触发
+### subscribe(selector)：按 slice 订阅
 
 ```tsx
-import React, { useEffect } from 'react';
-import { View, Text } from 'react-native';
-import { userStore } from './stores/user';
-
-export function SubscribeExample() {
-  const name = userStore.getState((s) => s.name);
-
-  useEffect(() => {
-    const unsub = userStore.data.subscribe(
-      (s) => s.name,
-      (next, prev) => {
-        console.log('name changed:', prev, '->', next);
-      },
-      { fireImmediately: true }
-    );
-    return unsub;
-  }, []);
-
-  return (
-    <View>
-      <Text>{name}</Text>
-    </View>
-  );
-}
+userStore.data.subscribe(
+  (s) => s.name,
+  (next, prev) => console.log(next, prev),
+  { fireImmediately: true }
+);
 ```
 
-### 2) 持久化安全边界：版本化与数据迁移
+### 持久化迁移
 
 ```ts
-import { createModel } from 'react-native-hox';
-
-export const userPersistStore = createModel(
+createModel(
   { token: '', isLogin: false },
   {
     persist: {
       key: 'user_v1',
-      beforeRecover: (v) => ({
-        token: v?.token ?? '',
-        isLogin: Boolean(v?.token),
-      }),
+      beforeRecover: (v) => ({ token: v?.token ?? '', isLogin: Boolean(v?.token) }),
     },
   }
 );
 ```
 
-### 3) initialState 支持纯函数
+### 初始状态用函数
 
 ```ts
-import { createModel } from 'react-native-hox';
-
-export const appStore = createModel(() => ({ bootAt: Date.now() }));
+createModel(() => ({ bootAt: Date.now() }));
 ```
 
-## API 参考（简版）
+---
 
-### `createModel(initialState, options?)`
+## API 简表
 
-- `initialState`: `T` 或 `() => T`
-- `options.persist`: `string` 或 `{ key, storage?, debounce?, beforePersist?, beforeRecover? }`
-- `options.strict.forbidSetStateAfterDestroy`: `boolean`
-- `options.logger`: `{ warn, error }`
+| 方法 / 属性 | 说明 |
+|-------------|------|
+| `model()` / `model.getState()` / `model.use()` / `model.useState()` | 组件内 Hook，可传 selector + equalityFn |
+| `model.setState(partial, replace?)` | 更新状态 |
+| `model.data.state` / `model.data.getState()` | 组件外读状态 |
+| `model.data.setState` / `model.data.subscribe` | 组件外写与订阅 |
+| `model.reset()` / `model.destroy()` | 重置为初始值、销毁 |
 
-返回的 `Model` 同时支持：
+**options**：`persist`（string 或 `{ key, storage?, debounce?, beforePersist?, beforeRecover? }`）、`logger`、`strict.forbidSetStateAfterDestroy`。
 
-- 组件内（Hook）：`model.getState()` / `model.use()` / `model.useState()`
-- 组件外（Vanilla）：`model.data.state` / `model.data.getState()` / `model.data.setState()` / `model.data.subscribe()`
+---
 
 ## License
 

package/dist/index.d.mts

@@ -1,61 +1,71 @@
-type Listener<T> = (state: T, prevState: T) => void;
-interface StorageEngine {
-    getItem: (key: string) => string | null | Promise<string | null>;
-    setItem: (key: string, value: string) => void | Promise<void>;
-    removeItem: (key: string) => void | Promise<void>;
-}
-type EqualityFn<T> = (a: T, b: T) => boolean;
-
+type Listener<T> = (state: T, prev: T) => void;
 type Selector<T, U> = (state: T) => U;
+type EqualityFn<T> = (a: T, b: T) => boolean;
+type SetState<T> = (partial: T | Partial<T> | ((s: T) => T | Partial<T>), replace?: boolean) => void;
 type ModelHook<T> = {
     (): T;
-    <U>(selector: Selector<T, U>, equalityFn?: EqualityFn<U>): U;
+    <U>(sel: Selector<T, U>, eq?: EqualityFn<U>): U;
+};
+type StorageEngine = {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
 };
 interface PersistOptions<T> {
     key: string;
     storage?: StorageEngine;
     debounce?: number;
-    beforePersist?: (state: T) => any;
-    beforeRecover?: (value: any) => T | Partial<T>;
-}
-interface Logger {
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
+    beforePersist?(state: T): any;
+    beforeRecover?(value: any): T | Partial<T>;
 }
 interface CreateModelOptions<T> {
     persist?: string | PersistOptions<T>;
-    logger?: Logger;
+    logger?: {
+        warn(...a: any[]): void;
+        error(...a: any[]): void;
+    };
     strict?: {
         forbidSetStateAfterDestroy?: boolean;
     };
 }
 interface SubscribeWithSelectorOptions<U> {
-    equalityFn?: EqualityFn<U>;
+    equalityFn?(a: U, b: U): boolean;
     fireImmediately?: boolean;
 }
 interface Subscribe<T> {
     (listener: Listener<T>): () => void;
-    <U>(selector: Selector<T, U>, listener: (selected: U, prevSelected: U) => void, options?: SubscribeWithSelectorOptions<U>): () => void;
+    <U>(sel: Selector<T, U>, fn: (s: U, p: U) => void, opts?: SubscribeWithSelectorOptions<U>): () => void;
 }
 interface ModelData<T> {
-    getState: () => T;
-    setState: (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean) => void;
+    getState(): T;
+    setState: SetState<T>;
     subscribe: Subscribe<T>;
-    destroy: () => void;
-    reset: () => void;
+    destroy(): void;
+    reset(): void;
     state: T;
 }
 type Model<T> = ModelHook<T> & {
     getState: ModelHook<T>;
     useState: ModelHook<T>;
-    setState: (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean) => void;
-    destroy: () => void;
-    reset: () => void;
-    data: ModelData<T>;
     use: ModelHook<T>;
+    setState: SetState<T>;
+    destroy(): void;
+    reset(): void;
+    data: ModelData<T>;
+};
+declare function shallow<T>(a: T, b: T): boolean;
+declare function debounce<T extends (...a: any[]) => any>(fn: T, ms: number): {
+    (...a: Parameters<T>): void;
+    flush(): void;
+    cancel(): void;
+};
+declare const createStore: <T>(init: T) => {
+    getState: () => T;
+    getInitialState: () => T;
+    setState(partial: T | Partial<T> | ((s: T) => T | Partial<T>), replace?: boolean): void;
+    subscribe(l: Listener<T>): () => void;
+    destroy(): void;
 };
 declare function createModel<T>(initialState: T | (() => T), options?: CreateModelOptions<T>): Model<T>;
 
-declare function shallow<T>(objA: T, objB: T): boolean;
-
-export { type CreateModelOptions, type Model, type ModelData, type PersistOptions, type StorageEngine, type SubscribeWithSelectorOptions, createModel, shallow };
+export { type CreateModelOptions, type Model, type ModelData, type PersistOptions, type StorageEngine, type SubscribeWithSelectorOptions, createModel, createStore, debounce, shallow };

package/dist/index.d.ts

@@ -1,61 +1,71 @@
-type Listener<T> = (state: T, prevState: T) => void;
-interface StorageEngine {
-    getItem: (key: string) => string | null | Promise<string | null>;
-    setItem: (key: string, value: string) => void | Promise<void>;
-    removeItem: (key: string) => void | Promise<void>;
-}
-type EqualityFn<T> = (a: T, b: T) => boolean;
-
+type Listener<T> = (state: T, prev: T) => void;
 type Selector<T, U> = (state: T) => U;
+type EqualityFn<T> = (a: T, b: T) => boolean;
+type SetState<T> = (partial: T | Partial<T> | ((s: T) => T | Partial<T>), replace?: boolean) => void;
 type ModelHook<T> = {
     (): T;
-    <U>(selector: Selector<T, U>, equalityFn?: EqualityFn<U>): U;
+    <U>(sel: Selector<T, U>, eq?: EqualityFn<U>): U;
+};
+type StorageEngine = {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
 };
 interface PersistOptions<T> {
     key: string;
     storage?: StorageEngine;
     debounce?: number;
-    beforePersist?: (state: T) => any;
-    beforeRecover?: (value: any) => T | Partial<T>;
-}
-interface Logger {
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
+    beforePersist?(state: T): any;
+    beforeRecover?(value: any): T | Partial<T>;
 }
 interface CreateModelOptions<T> {
     persist?: string | PersistOptions<T>;
-    logger?: Logger;
+    logger?: {
+        warn(...a: any[]): void;
+        error(...a: any[]): void;
+    };
     strict?: {
         forbidSetStateAfterDestroy?: boolean;
     };
 }
 interface SubscribeWithSelectorOptions<U> {
-    equalityFn?: EqualityFn<U>;
+    equalityFn?(a: U, b: U): boolean;
     fireImmediately?: boolean;
 }
 interface Subscribe<T> {
     (listener: Listener<T>): () => void;
-    <U>(selector: Selector<T, U>, listener: (selected: U, prevSelected: U) => void, options?: SubscribeWithSelectorOptions<U>): () => void;
+    <U>(sel: Selector<T, U>, fn: (s: U, p: U) => void, opts?: SubscribeWithSelectorOptions<U>): () => void;
 }
 interface ModelData<T> {
-    getState: () => T;
-    setState: (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean) => void;
+    getState(): T;
+    setState: SetState<T>;
     subscribe: Subscribe<T>;
-    destroy: () => void;
-    reset: () => void;
+    destroy(): void;
+    reset(): void;
     state: T;
 }
 type Model<T> = ModelHook<T> & {
     getState: ModelHook<T>;
     useState: ModelHook<T>;
-    setState: (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean) => void;
-    destroy: () => void;
-    reset: () => void;
-    data: ModelData<T>;
     use: ModelHook<T>;
+    setState: SetState<T>;
+    destroy(): void;
+    reset(): void;
+    data: ModelData<T>;
+};
+declare function shallow<T>(a: T, b: T): boolean;
+declare function debounce<T extends (...a: any[]) => any>(fn: T, ms: number): {
+    (...a: Parameters<T>): void;
+    flush(): void;
+    cancel(): void;
+};
+declare const createStore: <T>(init: T) => {
+    getState: () => T;
+    getInitialState: () => T;
+    setState(partial: T | Partial<T> | ((s: T) => T | Partial<T>), replace?: boolean): void;
+    subscribe(l: Listener<T>): () => void;
+    destroy(): void;
 };
 declare function createModel<T>(initialState: T | (() => T), options?: CreateModelOptions<T>): Model<T>;
 
-declare function shallow<T>(objA: T, objB: T): boolean;
-
-export { type CreateModelOptions, type Model, type ModelData, type PersistOptions, type StorageEngine, type SubscribeWithSelectorOptions, createModel, shallow };
+export { type CreateModelOptions, type Model, type ModelData, type PersistOptions, type StorageEngine, type SubscribeWithSelectorOptions, createModel, createStore, debounce, shallow };

package/dist/index.js

@@ -1,254 +1 @@
-'use strict';
-
-var useSyncExternalStoreExports = require('use-sync-external-store/shim/with-selector');
-var AsyncStorage = require('@react-native-async-storage/async-storage');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var useSyncExternalStoreExports__default = /*#__PURE__*/_interopDefault(useSyncExternalStoreExports);
-var AsyncStorage__default = /*#__PURE__*/_interopDefault(AsyncStorage);
-
-// src/createModel.ts
-
-// src/vanilla.ts
-function isPlainObject(value) {
-  if (Object.prototype.toString.call(value) !== "[object Object]") {
-    return false;
-  }
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-var createStore = (initialState) => {
-  let state = initialState;
-  const listeners = /* @__PURE__ */ new Set();
-  const setState = (partial, replace) => {
-    const nextState = typeof partial === "function" ? partial(state) : partial;
-    if (!Object.is(nextState, state)) {
-      const previousState = state;
-      const shouldReplace = replace != null ? replace : !isPlainObject(state) || !isPlainObject(nextState);
-      state = shouldReplace ? nextState : Object.assign({}, state, nextState);
-      const snapshot = new Set(listeners);
-      snapshot.forEach((listener) => listener(state, previousState));
-    }
-  };
-  const getState = () => state;
-  const getInitialState = () => initialState;
-  const subscribe = (listener) => {
-    listeners.add(listener);
-    return () => listeners.delete(listener);
-  };
-  const destroy = () => {
-    listeners.clear();
-  };
-  return { getState, getInitialState, setState, subscribe, destroy };
-};
-
-// src/utils.ts
-function shallow(objA, objB) {
-  if (Object.is(objA, objB)) {
-    return true;
-  }
-  if (typeof objA !== "object" || objA === null || typeof objB !== "object" || objB === null) {
-    return false;
-  }
-  const keysA = Object.keys(objA);
-  const keysB = Object.keys(objB);
-  if (keysA.length !== keysB.length) {
-    return false;
-  }
-  for (let i = 0; i < keysA.length; i++) {
-    if (!Object.prototype.hasOwnProperty.call(objB, keysA[i]) || !Object.is(objA[keysA[i]], objB[keysA[i]])) {
-      return false;
-    }
-  }
-  return true;
-}
-function debounce(func, wait) {
-  let timeout;
-  let lastArgs;
-  let context;
-  const debounced = function(...args) {
-    context = this;
-    lastArgs = args;
-    clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      func.apply(context, args);
-      lastArgs = void 0;
-      timeout = void 0;
-    }, wait);
-  };
-  debounced.flush = () => {
-    if (timeout && lastArgs) {
-      clearTimeout(timeout);
-      func.apply(context, lastArgs);
-      lastArgs = void 0;
-      timeout = void 0;
-    }
-  };
-  debounced.cancel = () => {
-    clearTimeout(timeout);
-    lastArgs = void 0;
-    timeout = void 0;
-  };
-  return debounced;
-}
-
-// src/createModel.ts
-var { useSyncExternalStoreWithSelector } = useSyncExternalStoreExports__default.default;
-var identity = (v) => v;
-function isInvalidHookCallError(error) {
-  return error instanceof Error && /Invalid hook call|Hooks can only be called/i.test(error.message);
-}
-function createModel(initialState, options) {
-  var _a;
-  const initialValue = typeof initialState === "function" ? initialState() : initialState;
-  const store = createStore(initialValue);
-  const logger = (_a = options == null ? void 0 : options.logger) != null ? _a : console;
-  setupModelSideEffects(store, options, logger);
-  let isDestroyed = false;
-  const setState = (partial, replace) => {
-    var _a2;
-    if (isDestroyed && ((_a2 = options == null ? void 0 : options.strict) == null ? void 0 : _a2.forbidSetStateAfterDestroy)) {
-      const error = new Error("[react-native-hox] model \u5DF2\u9500\u6BC1\uFF0C\u65E0\u6CD5\u518D\u8C03\u7528 setState\u3002");
-      logger.error(error);
-      throw error;
-    }
-    store.setState(partial, replace);
-  };
-  const destroy = () => {
-    isDestroyed = true;
-    store.destroy();
-  };
-  const reset = () => setState(initialValue, true);
-  const subscribe = createSubscribe(store);
-  const data = {
-    getState: store.getState,
-    setState,
-    subscribe,
-    destroy,
-    reset
-  };
-  Object.defineProperty(data, "state", {
-    get: () => store.getState(),
-    enumerable: true
-  });
-  const hook = createModelHook(store);
-  const model = {
-    getState: hook,
-    useState: hook,
-    use: hook,
-    // Add 'use' alias
-    setState,
-    reset,
-    destroy,
-    data
-  };
-  const modelFn = function(selector, equalityFn) {
-    return hook(selector, equalityFn);
-  };
-  Object.assign(modelFn, model);
-  return modelFn;
-}
-function createSubscribe(store) {
-  return ((arg1, arg2, arg3) => {
-    var _a;
-    if (typeof arg1 === "function" && typeof arg2 !== "function") {
-      return store.subscribe(arg1);
-    }
-    const selector = arg1;
-    const listener = arg2;
-    const options = arg3 != null ? arg3 : {};
-    const equalityFn = (_a = options.equalityFn) != null ? _a : Object.is;
-    let lastSelected = selector(store.getState());
-    if (options.fireImmediately) {
-      listener(lastSelected, lastSelected);
-    }
-    return store.subscribe((nextState) => {
-      const nextSelected = selector(nextState);
-      if (equalityFn(lastSelected, nextSelected)) {
-        return;
-      }
-      const prevSelected = lastSelected;
-      lastSelected = nextSelected;
-      listener(nextSelected, prevSelected);
-    });
-  });
-}
-function createModelHook(store) {
-  const useModel = ((selector, equalityFn = shallow) => {
-    try {
-      return useSyncExternalStoreWithSelector(
-        store.subscribe,
-        store.getState,
-        store.getInitialState,
-        selector != null ? selector : identity,
-        equalityFn
-      );
-    } catch (error) {
-      if (isInvalidHookCallError(error)) {
-        throw new Error(
-          "[react-native-hox] \u4F60\u6B63\u5728\u7EC4\u4EF6\u5916\u8C03\u7528 Hook \u8BFB\u53D6\u72B6\u6001\uFF1B\u8BF7\u5728\u7EC4\u4EF6\u5185\u4F7F\u7528 `model()` / `model.use()` / `model.getState()` / `model.useState()`\uFF0C\u7EC4\u4EF6\u5916\u8BF7\u4F7F\u7528 `model.data.getState()` / `model.data.state`\u3002"
-        );
-      }
-      throw error;
-    }
-  });
-  return useModel;
-}
-function setupModelSideEffects(store, options, logger) {
-  var _a, _b, _c, _d;
-  const persist = typeof (options == null ? void 0 : options.persist) === "string" ? { key: options.persist } : options == null ? void 0 : options.persist;
-  const persistKey = persist == null ? void 0 : persist.key;
-  const storage = (_a = persist == null ? void 0 : persist.storage) != null ? _a : AsyncStorage__default.default;
-  if (!persistKey) {
-    return;
-  }
-  const beforePersist = (_b = persist == null ? void 0 : persist.beforePersist) != null ? _b : ((s) => s);
-  const beforeRecover = (_c = persist == null ? void 0 : persist.beforeRecover) != null ? _c : ((v) => v);
-  const debounceMs = (_d = persist == null ? void 0 : persist.debounce) != null ? _d : 100;
-  if (!storage) {
-    logger.warn(
-      "[react-native-hox] persist \u5DF2\u5F00\u542F\u4F46 storage \u4E0D\u53EF\u7528\uFF1A\u8BF7\u5728 persist.storage \u4F20\u5165 AsyncStorage/MMKV \u7B49\u3002"
-    );
-    return;
-  }
-  let isDestroyed = false;
-  Promise.resolve().then(() => storage.getItem(persistKey)).then((val) => {
-    if (isDestroyed) return;
-    if (!val) return;
-    try {
-      const parsed = JSON.parse(val);
-      const recovered = beforeRecover(parsed);
-      store.setState(recovered, false);
-    } catch (e) {
-      logger.error("[react-native-hox] Failed to parse stored value:", e);
-    }
-  }).catch((e) => {
-    logger.error("[react-native-hox] Recover failed:", e);
-  });
-  const save = debounce((state) => {
-    if (isDestroyed) return;
-    try {
-      const prepared = beforePersist(state);
-      const result = storage.setItem(persistKey, JSON.stringify(prepared));
-      Promise.resolve(result).catch((e) => {
-        logger.error("[react-native-hox] Save failed:", e);
-      });
-    } catch (e) {
-      logger.error("[react-native-hox] Save failed:", e);
-    }
-  }, debounceMs);
-  const unsubscribe = store.subscribe((state) => {
-    save(state);
-  });
-  const originalDestroy = store.destroy;
-  store.destroy = () => {
-    unsubscribe();
-    save.flush();
-    isDestroyed = true;
-    originalDestroy();
-  };
-}
-
-exports.createModel = createModel;
-exports.shallow = shallow;
+'use strict';var E=require('use-sync-external-store/shim/with-selector'),w=require('@react-native-async-storage/async-storage');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var E__default=/*#__PURE__*/_interopDefault(E);var w__default=/*#__PURE__*/_interopDefault(w);var I=E__default.default.useSyncExternalStoreWithSelector,M=o=>{if(Object.prototype.toString.call(o)!=="[object Object]")return  false;let e=Object.getPrototypeOf(o);return e===Object.prototype||e===null};function H(o,e){if(Object.is(o,e))return  true;if(typeof o!="object"||!o||typeof e!="object"||!e)return  false;let r=Object.keys(o);return r.length===Object.keys(e).length&&r.every(t=>Object.prototype.hasOwnProperty.call(e,t)&&Object.is(o[t],e[t]))}function q(o,e){let r,t,n=function(...l){t=l,clearTimeout(r),r=setTimeout(()=>{o(...l),t=r=void 0;},e);};return n.flush=()=>{r&&t&&(clearTimeout(r),o(...t),t=r=void 0);},n.cancel=()=>{clearTimeout(r),t=r=void 0;},n}var F=o=>{let e=o,r=new Set;return {getState:()=>e,getInitialState:()=>o,setState(t,n){let l=typeof t=="function"?t(e):t;if(!Object.is(l,e)){let f=e;e=(n!=null?n:!M(e)||!M(l))?l:{...e,...l},new Set(r).forEach(S=>S(e,f));}},subscribe(t){return r.add(t),()=>{r.delete(t);}},destroy(){r.clear();}}};function L(o,e){var h,O,k,x,P;let r=typeof o=="function"?o():o,t=F(r),n=(h=e==null?void 0:e.logger)!=null?h:console,l=false,f,S=(s,c)=>{var i;if(l&&((i=e==null?void 0:e.strict)!=null&&i.forbidSetStateAfterDestroy)){let u=new Error("[react-native-hox] model \u5DF2\u9500\u6BC1\uFF0C\u65E0\u6CD5\u518D\u8C03\u7528 setState\u3002");throw n.error(u),u}t.setState(s,c);},d=typeof(e==null?void 0:e.persist)=="string"?{key:e.persist}:e==null?void 0:e.persist;if(d!=null&&d.key){let s=(O=d.storage)!=null?O:w__default.default;if(s){let c=(k=d.beforePersist)!=null?k:(a=>a),i=(x=d.beforeRecover)!=null?x:(a=>a),u=false;Promise.resolve().then(()=>s.getItem(d.key)).then(a=>{if(!(u||!a))try{t.setState(i(JSON.parse(a)),!1);}catch(y){n.error("[react-native-hox] Failed to parse stored value:",y);}}).catch(a=>n.error("[react-native-hox] Recover failed:",a));let T=q(a=>{if(!u)try{Promise.resolve(s.setItem(d.key,JSON.stringify(c(a)))).catch(y=>n.error("[react-native-hox] Save failed:",y));}catch(y){n.error("[react-native-hox] Save failed:",y);}},(P=d.debounce)!=null?P:100),g=t.subscribe(a=>T(a));f=()=>{g(),T.flush(),u=true;};}else n.warn("[react-native-hox] persist \u5DF2\u5F00\u542F\u4F46 storage \u4E0D\u53EF\u7528\uFF1A\u8BF7\u5728 persist.storage \u4F20\u5165 AsyncStorage/MMKV \u7B49\u3002");}let v=()=>{f==null||f(),l=true,t.destroy();},p=()=>S(r,true),U=((s,c,i)=>{if(typeof s=="function"&&typeof c!="function")return t.subscribe(s);let u=i!=null?i:{},T=s(t.getState());return u.fireImmediately&&c(T,T),t.subscribe(g=>{var y;let a=s(g);if(!((y=u.equalityFn)!=null?y:Object.is)(T,a)){let j=T;T=a,c(a,j);}})}),b=((s,c=H)=>{try{return I(t.subscribe,t.getState,t.getInitialState,s!=null?s:(i=>i),c)}catch(i){throw i instanceof Error&&/Invalid hook call|Hooks can only be called/i.test(i.message)?new Error("[react-native-hox] \u7EC4\u4EF6\u5916\u8BF7\u4F7F\u7528 model.data.getState() / model.data.state"):i}}),m={getState:t.getState,setState:S,subscribe:U,destroy:v,reset:p};return Object.defineProperty(m,"state",{get:t.getState,enumerable:true}),Object.assign((s,c)=>b(s,c),{getState:b,useState:b,use:b,setState:S,destroy:v,reset:p,data:m})}exports.createModel=L;exports.createStore=F;exports.debounce=q;exports.shallow=H;

package/dist/index.mjs

@@ -1,246 +1 @@
-import useSyncExternalStoreExports from 'use-sync-external-store/shim/with-selector';
-import AsyncStorage from '@react-native-async-storage/async-storage';
-
-// src/createModel.ts
-
-// src/vanilla.ts
-function isPlainObject(value) {
-  if (Object.prototype.toString.call(value) !== "[object Object]") {
-    return false;
-  }
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-var createStore = (initialState) => {
-  let state = initialState;
-  const listeners = /* @__PURE__ */ new Set();
-  const setState = (partial, replace) => {
-    const nextState = typeof partial === "function" ? partial(state) : partial;
-    if (!Object.is(nextState, state)) {
-      const previousState = state;
-      const shouldReplace = replace != null ? replace : !isPlainObject(state) || !isPlainObject(nextState);
-      state = shouldReplace ? nextState : Object.assign({}, state, nextState);
-      const snapshot = new Set(listeners);
-      snapshot.forEach((listener) => listener(state, previousState));
-    }
-  };
-  const getState = () => state;
-  const getInitialState = () => initialState;
-  const subscribe = (listener) => {
-    listeners.add(listener);
-    return () => listeners.delete(listener);
-  };
-  const destroy = () => {
-    listeners.clear();
-  };
-  return { getState, getInitialState, setState, subscribe, destroy };
-};
-
-// src/utils.ts
-function shallow(objA, objB) {
-  if (Object.is(objA, objB)) {
-    return true;
-  }
-  if (typeof objA !== "object" || objA === null || typeof objB !== "object" || objB === null) {
-    return false;
-  }
-  const keysA = Object.keys(objA);
-  const keysB = Object.keys(objB);
-  if (keysA.length !== keysB.length) {
-    return false;
-  }
-  for (let i = 0; i < keysA.length; i++) {
-    if (!Object.prototype.hasOwnProperty.call(objB, keysA[i]) || !Object.is(objA[keysA[i]], objB[keysA[i]])) {
-      return false;
-    }
-  }
-  return true;
-}
-function debounce(func, wait) {
-  let timeout;
-  let lastArgs;
-  let context;
-  const debounced = function(...args) {
-    context = this;
-    lastArgs = args;
-    clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      func.apply(context, args);
-      lastArgs = void 0;
-      timeout = void 0;
-    }, wait);
-  };
-  debounced.flush = () => {
-    if (timeout && lastArgs) {
-      clearTimeout(timeout);
-      func.apply(context, lastArgs);
-      lastArgs = void 0;
-      timeout = void 0;
-    }
-  };
-  debounced.cancel = () => {
-    clearTimeout(timeout);
-    lastArgs = void 0;
-    timeout = void 0;
-  };
-  return debounced;
-}
-
-// src/createModel.ts
-var { useSyncExternalStoreWithSelector } = useSyncExternalStoreExports;
-var identity = (v) => v;
-function isInvalidHookCallError(error) {
-  return error instanceof Error && /Invalid hook call|Hooks can only be called/i.test(error.message);
-}
-function createModel(initialState, options) {
-  var _a;
-  const initialValue = typeof initialState === "function" ? initialState() : initialState;
-  const store = createStore(initialValue);
-  const logger = (_a = options == null ? void 0 : options.logger) != null ? _a : console;
-  setupModelSideEffects(store, options, logger);
-  let isDestroyed = false;
-  const setState = (partial, replace) => {
-    var _a2;
-    if (isDestroyed && ((_a2 = options == null ? void 0 : options.strict) == null ? void 0 : _a2.forbidSetStateAfterDestroy)) {
-      const error = new Error("[react-native-hox] model \u5DF2\u9500\u6BC1\uFF0C\u65E0\u6CD5\u518D\u8C03\u7528 setState\u3002");
-      logger.error(error);
-      throw error;
-    }
-    store.setState(partial, replace);
-  };
-  const destroy = () => {
-    isDestroyed = true;
-    store.destroy();
-  };
-  const reset = () => setState(initialValue, true);
-  const subscribe = createSubscribe(store);
-  const data = {
-    getState: store.getState,
-    setState,
-    subscribe,
-    destroy,
-    reset
-  };
-  Object.defineProperty(data, "state", {
-    get: () => store.getState(),
-    enumerable: true
-  });
-  const hook = createModelHook(store);
-  const model = {
-    getState: hook,
-    useState: hook,
-    use: hook,
-    // Add 'use' alias
-    setState,
-    reset,
-    destroy,
-    data
-  };
-  const modelFn = function(selector, equalityFn) {
-    return hook(selector, equalityFn);
-  };
-  Object.assign(modelFn, model);
-  return modelFn;
-}
-function createSubscribe(store) {
-  return ((arg1, arg2, arg3) => {
-    var _a;
-    if (typeof arg1 === "function" && typeof arg2 !== "function") {
-      return store.subscribe(arg1);
-    }
-    const selector = arg1;
-    const listener = arg2;
-    const options = arg3 != null ? arg3 : {};
-    const equalityFn = (_a = options.equalityFn) != null ? _a : Object.is;
-    let lastSelected = selector(store.getState());
-    if (options.fireImmediately) {
-      listener(lastSelected, lastSelected);
-    }
-    return store.subscribe((nextState) => {
-      const nextSelected = selector(nextState);
-      if (equalityFn(lastSelected, nextSelected)) {
-        return;
-      }
-      const prevSelected = lastSelected;
-      lastSelected = nextSelected;
-      listener(nextSelected, prevSelected);
-    });
-  });
-}
-function createModelHook(store) {
-  const useModel = ((selector, equalityFn = shallow) => {
-    try {
-      return useSyncExternalStoreWithSelector(
-        store.subscribe,
-        store.getState,
-        store.getInitialState,
-        selector != null ? selector : identity,
-        equalityFn
-      );
-    } catch (error) {
-      if (isInvalidHookCallError(error)) {
-        throw new Error(
-          "[react-native-hox] \u4F60\u6B63\u5728\u7EC4\u4EF6\u5916\u8C03\u7528 Hook \u8BFB\u53D6\u72B6\u6001\uFF1B\u8BF7\u5728\u7EC4\u4EF6\u5185\u4F7F\u7528 `model()` / `model.use()` / `model.getState()` / `model.useState()`\uFF0C\u7EC4\u4EF6\u5916\u8BF7\u4F7F\u7528 `model.data.getState()` / `model.data.state`\u3002"
-        );
-      }
-      throw error;
-    }
-  });
-  return useModel;
-}
-function setupModelSideEffects(store, options, logger) {
-  var _a, _b, _c, _d;
-  const persist = typeof (options == null ? void 0 : options.persist) === "string" ? { key: options.persist } : options == null ? void 0 : options.persist;
-  const persistKey = persist == null ? void 0 : persist.key;
-  const storage = (_a = persist == null ? void 0 : persist.storage) != null ? _a : AsyncStorage;
-  if (!persistKey) {
-    return;
-  }
-  const beforePersist = (_b = persist == null ? void 0 : persist.beforePersist) != null ? _b : ((s) => s);
-  const beforeRecover = (_c = persist == null ? void 0 : persist.beforeRecover) != null ? _c : ((v) => v);
-  const debounceMs = (_d = persist == null ? void 0 : persist.debounce) != null ? _d : 100;
-  if (!storage) {
-    logger.warn(
-      "[react-native-hox] persist \u5DF2\u5F00\u542F\u4F46 storage \u4E0D\u53EF\u7528\uFF1A\u8BF7\u5728 persist.storage \u4F20\u5165 AsyncStorage/MMKV \u7B49\u3002"
-    );
-    return;
-  }
-  let isDestroyed = false;
-  Promise.resolve().then(() => storage.getItem(persistKey)).then((val) => {
-    if (isDestroyed) return;
-    if (!val) return;
-    try {
-      const parsed = JSON.parse(val);
-      const recovered = beforeRecover(parsed);
-      store.setState(recovered, false);
-    } catch (e) {
-      logger.error("[react-native-hox] Failed to parse stored value:", e);
-    }
-  }).catch((e) => {
-    logger.error("[react-native-hox] Recover failed:", e);
-  });
-  const save = debounce((state) => {
-    if (isDestroyed) return;
-    try {
-      const prepared = beforePersist(state);
-      const result = storage.setItem(persistKey, JSON.stringify(prepared));
-      Promise.resolve(result).catch((e) => {
-        logger.error("[react-native-hox] Save failed:", e);
-      });
-    } catch (e) {
-      logger.error("[react-native-hox] Save failed:", e);
-    }
-  }, debounceMs);
-  const unsubscribe = store.subscribe((state) => {
-    save(state);
-  });
-  const originalDestroy = store.destroy;
-  store.destroy = () => {
-    unsubscribe();
-    save.flush();
-    isDestroyed = true;
-    originalDestroy();
-  };
-}
-
-export { createModel, shallow };
+import E from'use-sync-external-store/shim/with-selector';import w from'@react-native-async-storage/async-storage';var I=E.useSyncExternalStoreWithSelector,M=o=>{if(Object.prototype.toString.call(o)!=="[object Object]")return  false;let e=Object.getPrototypeOf(o);return e===Object.prototype||e===null};function H(o,e){if(Object.is(o,e))return  true;if(typeof o!="object"||!o||typeof e!="object"||!e)return  false;let r=Object.keys(o);return r.length===Object.keys(e).length&&r.every(t=>Object.prototype.hasOwnProperty.call(e,t)&&Object.is(o[t],e[t]))}function q(o,e){let r,t,n=function(...l){t=l,clearTimeout(r),r=setTimeout(()=>{o(...l),t=r=void 0;},e);};return n.flush=()=>{r&&t&&(clearTimeout(r),o(...t),t=r=void 0);},n.cancel=()=>{clearTimeout(r),t=r=void 0;},n}var F=o=>{let e=o,r=new Set;return {getState:()=>e,getInitialState:()=>o,setState(t,n){let l=typeof t=="function"?t(e):t;if(!Object.is(l,e)){let f=e;e=(n!=null?n:!M(e)||!M(l))?l:{...e,...l},new Set(r).forEach(S=>S(e,f));}},subscribe(t){return r.add(t),()=>{r.delete(t);}},destroy(){r.clear();}}};function L(o,e){var h,O,k,x,P;let r=typeof o=="function"?o():o,t=F(r),n=(h=e==null?void 0:e.logger)!=null?h:console,l=false,f,S=(s,c)=>{var i;if(l&&((i=e==null?void 0:e.strict)!=null&&i.forbidSetStateAfterDestroy)){let u=new Error("[react-native-hox] model \u5DF2\u9500\u6BC1\uFF0C\u65E0\u6CD5\u518D\u8C03\u7528 setState\u3002");throw n.error(u),u}t.setState(s,c);},d=typeof(e==null?void 0:e.persist)=="string"?{key:e.persist}:e==null?void 0:e.persist;if(d!=null&&d.key){let s=(O=d.storage)!=null?O:w;if(s){let c=(k=d.beforePersist)!=null?k:(a=>a),i=(x=d.beforeRecover)!=null?x:(a=>a),u=false;Promise.resolve().then(()=>s.getItem(d.key)).then(a=>{if(!(u||!a))try{t.setState(i(JSON.parse(a)),!1);}catch(y){n.error("[react-native-hox] Failed to parse stored value:",y);}}).catch(a=>n.error("[react-native-hox] Recover failed:",a));let T=q(a=>{if(!u)try{Promise.resolve(s.setItem(d.key,JSON.stringify(c(a)))).catch(y=>n.error("[react-native-hox] Save failed:",y));}catch(y){n.error("[react-native-hox] Save failed:",y);}},(P=d.debounce)!=null?P:100),g=t.subscribe(a=>T(a));f=()=>{g(),T.flush(),u=true;};}else n.warn("[react-native-hox] persist \u5DF2\u5F00\u542F\u4F46 storage \u4E0D\u53EF\u7528\uFF1A\u8BF7\u5728 persist.storage \u4F20\u5165 AsyncStorage/MMKV \u7B49\u3002");}let v=()=>{f==null||f(),l=true,t.destroy();},p=()=>S(r,true),U=((s,c,i)=>{if(typeof s=="function"&&typeof c!="function")return t.subscribe(s);let u=i!=null?i:{},T=s(t.getState());return u.fireImmediately&&c(T,T),t.subscribe(g=>{var y;let a=s(g);if(!((y=u.equalityFn)!=null?y:Object.is)(T,a)){let j=T;T=a,c(a,j);}})}),b=((s,c=H)=>{try{return I(t.subscribe,t.getState,t.getInitialState,s!=null?s:(i=>i),c)}catch(i){throw i instanceof Error&&/Invalid hook call|Hooks can only be called/i.test(i.message)?new Error("[react-native-hox] \u7EC4\u4EF6\u5916\u8BF7\u4F7F\u7528 model.data.getState() / model.data.state"):i}}),m={getState:t.getState,setState:S,subscribe:U,destroy:v,reset:p};return Object.defineProperty(m,"state",{get:t.getState,enumerable:true}),Object.assign((s,c)=>b(s,c),{getState:b,useState:b,use:b,setState:S,destroy:v,reset:p,data:m})}export{L as createModel,F as createStore,q as debounce,H as shallow};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-hox",
-  "version": "0.0.3",
+  "version": "1.0.1",
   "description": "一个轻量级、类型安全、零心智负担的 React Native 状态管理解决方案。",
   "keywords": [
     "react-native",
@@ -20,7 +20,7 @@
   },
   "homepage": "https://gitee.com/ws18250840411/react-native-hox#readme",
   "license": "ISC",
-  "author": "wangws",
+  "author": "wangwenshan",
   "sideEffects": false,
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -46,12 +46,12 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@react-native-async-storage/async-storage": "^2.2.0",
     "use-sync-external-store": "^1.6.0"
   },
   "peerDependencies": {
     "react": ">=16.8",
-    "react-native": ">=0.65"
+    "react-native": ">=0.65",
+    "@react-native-async-storage/async-storage": ">=2.0.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",