,\n modelName: string,\n computedName: string,\n fn: (...args: any[]) => any,\n): ComputedFlag => {\n let caches: {\n deps: any[];\n skipCount: number;\n ref: ComputedValue;\n }[] = [];\n\n function anonymousFn() {\n const args = toArgs(arguments);\n let hitCache: (typeof caches)[number] | undefined;\n\n searchCache: for (let i = 0; i < caches.length; ++i) {\n const cache = caches[i]!;\n if (hitCache) {\n ++cache.skipCount;\n continue;\n }\n for (let j = 0; j < cache.deps.length; ++j) {\n if (args[j] !== cache.deps[j]) {\n ++cache.skipCount;\n continue searchCache;\n }\n }\n cache.skipCount = 0;\n hitCache = cache;\n }\n\n if (hitCache) return hitCache.ref.value;\n\n if (caches.length > 10) {\n caches = caches.filter((cache) => cache.skipCount < 15);\n }\n\n hitCache = {\n deps: args,\n skipCount: 0,\n ref: new ComputedValue(modelStore, modelName, computedName, () =>\n fn.apply(ctx, args),\n ),\n };\n caches.push(hitCache);\n return hitCache.ref.value;\n }\n\n return anonymousFn as any;\n};\n"
},
{
"path": "src/model/enhance-effect.ts",
"content": "import {\n LoadingAction,\n LOADING_CATEGORY,\n TYPE_SET_LOADING,\n} from '../actions/loading';\nimport type { EffectCtx } from './types';\nimport { isPromise } from '../utils/is-promise';\nimport { toArgs } from '../utils/to-args';\nimport { loadingStore } from '../store/loading-store';\n\ninterface RoomFunc> {\n (category: number | string): {\n execute(...args: P): R;\n };\n}\n\ninterface AsyncRoomEffect
>\n extends RoomFunc {\n readonly _: {\n readonly model: string;\n readonly method: string;\n readonly hasRoom: true;\n };\n}\n\ninterface AsyncEffect>\n extends EffectFunc {\n readonly _: {\n readonly model: string;\n readonly method: string;\n readonly hasRoom: '';\n };\n /**\n * 对同一effect函数的执行状态进行分类以实现独立保存。好处有：\n *\n * 1. 并发请求同一个请求时不会互相覆盖执行状态。\n *
\n * 2. 可以精确地判断业务中是哪个控件或者逻辑正在执行。\n *\n * ```typescript\n * model.effect.room(CATEGORY).execute(...);\n * ```\n *\n * @see useLoading(effect.room)\n * @see getLoading(effect.room)\n * @since 0.11.4\n *\n */\n readonly room: AsyncRoomEffect;\n}\n\nexport type PromiseEffect = AsyncEffect;\nexport type PromiseRoomEffect = AsyncRoomEffect;\n\ninterface EffectFunc> {\n (...args: P): R;\n}\n\nexport type EnhancedEffect
> =\n R extends Promise ? AsyncEffect : EffectFunc;\n\ntype NonReadonly = {\n -readonly [K in keyof T]: T[K];\n};\n\nexport const enhanceEffect = (\n ctx: EffectCtx,\n methodName: string,\n effect: (...args: any[]) => any,\n): EnhancedEffect => {\n const fn: NonReadonly & EffectFunc = function () {\n return execute(ctx, methodName, effect, toArgs(arguments));\n };\n\n fn._ = {\n model: ctx.name,\n method: methodName,\n hasRoom: '',\n };\n\n const room: NonReadonly & RoomFunc = (\n category: number | string,\n ) => ({\n execute() {\n return execute(ctx, methodName, effect, toArgs(arguments), category);\n },\n });\n\n room._ = Object.assign({}, fn._, {\n hasRoom: true as const,\n });\n\n fn.room = room;\n\n return fn;\n};\n\nconst dispatchLoading = (\n modelName: string,\n methodName: string,\n loading: boolean,\n category?: number | string,\n) => {\n loadingStore.dispatch({\n type: TYPE_SET_LOADING,\n model: modelName,\n method: methodName,\n payload: {\n category: category === void 0 ? LOADING_CATEGORY : category,\n loading,\n },\n });\n};\n\nconst execute = (\n ctx: EffectCtx,\n methodName: string,\n effect: (...args: any[]) => any,\n args: any[],\n category?: number | string,\n) => {\n const modelName = ctx.name;\n const resultOrPromise = effect.apply(ctx, args);\n\n if (!isPromise(resultOrPromise)) return resultOrPromise;\n\n dispatchLoading(modelName, methodName, true, category);\n\n return resultOrPromise.then(\n (result) => {\n return dispatchLoading(modelName, methodName, false, category), result;\n },\n (e: unknown) => {\n dispatchLoading(modelName, methodName, false, category);\n throw e;\n },\n );\n};\n"
},
{
"path": "src/model/guard.ts",
"content": "const counter: Record = {};\n\nexport const guard = (modelName: string) => {\n counter[modelName] ||= 0;\n\n if (process.env.NODE_ENV !== 'production') {\n setTimeout(() => {\n --counter[modelName]!;\n });\n }\n\n if (++counter[modelName] > 1) {\n throw new Error(`模型名称'${modelName}'被重复使用`);\n }\n};\n"
},
{
"path": "src/model/types.ts",
"content": "import type { UnknownAction } from 'redux';\nimport type { EnhancedEffect } from './enhance-effect';\nimport type { PersistMergeMode } from '../persist/persist-item';\n\nexport interface ComputedFlag {\n readonly _computedFlag: never;\n}\n\nexport interface GetName {\n /**\n * 模型名称。请在定义模型时确保是唯一的字符串\n */\n readonly name: Name;\n}\n\nexport interface GetState {\n /**\n * 模型的实时状态\n */\n readonly state: State;\n}\n\nexport interface GetInitialState {\n /**\n * 模型的初始状态，每次获取该属性都会执行深拷贝操作\n */\n readonly initialState: State;\n}\n\nexport type ModelPersist = {\n /**\n * 持久化版本号，数据结构变化后建议立即升级该版本。默认值：`0`\n */\n version?: number | string;\n\n /**\n * 持久化数据与初始数据的合并方式。默认值以全局配置为准\n *\n * - replace - 覆盖模式。直接用持久化数据替换初始数据\n * - merge - 合并模式。持久化数据与初始数据新增的key进行合并，可理解为`Object.assign`\n * - deep-merge - 二级合并模式。在合并模式的基础上，如果某个key的值为对象，则该对象也会执行合并操作\n *\n * 注意：当数据为数组格式时该配置无效。\n * @since 3.0.0\n */\n merge?: PersistMergeMode;\n} & (\n | {\n /**\n * 模型数据从内存存储到持久化引擎时的过滤函数，允许你只持久化部分数据。\n * ```typescript\n *\n * // state = { firstName: 'tick', lastName: 'tock' }\n * dump: (state) => state\n * dump: (state) => state.firstName\n * dump: (state) => ({ name: state.lastName })\n * ```\n *\n * @since 3.0.0\n */\n dump: (state: State) => PersistDump;\n /**\n * 持久化数据恢复到模型内存时的过滤函数，参数为`dump`返回的值。\n * ```typescript\n * // state = { firstName: 'tick', lastName: 'tock' }\n * {\n * dump(state) {\n * return state.firstName\n * },\n * load(firstName) {\n * return { ...this.initialState, firstName: firstName };\n * }\n * }\n * ```\n *\n * @since 3.0.0\n */\n load: (this: GetInitialState, dumpData: PersistDump) => State;\n }\n | {\n dump?: never;\n load?: never;\n }\n);\n\nexport interface ActionCtx\n extends GetName,\n GetInitialState {}\n\nexport interface EffectCtx\n extends ActionCtx,\n GetState {\n /**\n * 立即更改状态，支持**immer**操作\n *\n * ```typescript\n * this.setState((state) => {\n * state.count += 1;\n * });\n * ```\n *\n * 对于object类型，你可以直接传递 **全部** 或者 **部分** 数据\n * ```typescript\n * interface State { id: number; name: string };\n *\n * this.setState({}); // 什么也没修改\n * this.setState({ id: 10 }); // 只修改id\n * this.setState({ id: 10, name: 'foo' }); // 修改全部\n *\n * this.setState((state) => {\n * return {}; // 什么也没修改\n * });\n * this.setState((state) => {\n * return { id: 10 }; // 只修改id\n * });\n * this.setState((state) => {\n * return { id: 10, name: 'foo' }; // 修改全部\n * });\n * ```\n *\n * 对于array类型，直接传递数组就行了\n * ```typescript\n * this.setState(['a', 'b', 'c']);\n * ```\n */\n readonly setState: State extends any[]\n ? (state: State | ((state: State) => State | void)) => UnknownAction\n : (\n state: SetStateCallback | (Pick | State),\n ) => UnknownAction;\n}\n\nexport interface SetStateCallback {\n (state: State): Pick | State | void;\n}\n\nexport interface ComputedCtx\n extends GetName,\n GetState {}\n\nexport interface BaseModel\n extends GetState,\n GetName {}\n\ntype ModelActionItem<\n State extends object,\n Action extends object,\n K extends keyof Action,\n> = Action[K] extends (state: State, ...args: infer P) => State | void\n ? (...args: P) => UnknownAction\n : never;\n\ntype ModelAction = {\n readonly [K in keyof Action]: ModelActionItem;\n};\n\ntype GetPrivateMethodKeys = {\n [K in keyof Method]: K extends `_${string}` ? K : never;\n}[keyof Method];\n\ntype ModelEffect = {\n readonly [K in keyof Effect]: Effect[K] extends (...args: infer P) => infer R\n ? EnhancedEffect\n : never;\n};\n\ntype ModelComputed = {\n readonly [K in keyof Computed]: Computed[K] & ComputedFlag;\n};\n\nexport type Model<\n Name extends string = string,\n State extends object = object,\n Action extends object = object,\n Effect extends object = object,\n Computed extends object = object,\n> = BaseModel &\n // [K in keyof Action as K extends `_${string}` ? never : K]\n // 上面这种看起来简洁，业务代码提示也正常，但是业务代码那边无法点击跳转进模型了。\n // 所以需要先转换所有的属性，再把私有属性去除。\n Omit, GetPrivateMethodKeys> &\n Omit, GetPrivateMethodKeys> &\n Omit, GetPrivateMethodKeys>;\n\nexport type InternalModel<\n Name extends string = string,\n State extends object = object,\n Action extends object = object,\n Effect extends object = object,\n Computed extends object = object,\n> = BaseModel & {\n readonly _$opts: DefineModelOptions;\n readonly _$persistCtx: GetInitialState;\n};\n\nexport type InternalAction = {\n [key: string]: (state: State, ...args: any[]) => State | void;\n};\n\nexport interface Event {\n /**\n * store初始化完成，并且持久化（如果有）的数据也已经恢复。\n *\n * 上下文 **this** 可以直接调用actions和effects的函数以及computed计算属性。\n */\n onInit?: () => void;\n /**\n * 每当state有变化时的回调通知。\n *\n * 初始化(onInit)执行之前不会触发该回调。如果在onInit中做了修改state的操作，则会触发该回调。\n *\n * 上下文 **this** 可以直接调用actions和effects的函数以及computed计算属性，请谨慎执行修改数据的操作以防止死循环。\n */\n onChange?: (prevState: State, nextState: State) => void;\n /**\n * 销毁模型时的回调通知，此时模型已经被销毁。\n * 该事件仅在局部模型生效\n * @see useIsolate\n */\n onDestroy?: (this: never, modelName: string) => void;\n}\n\nexport interface EventCtx\n extends GetName,\n GetState {}\n\nexport interface DefineModelOptions<\n State extends object,\n Action extends object,\n Effect extends object,\n Computed extends object,\n PersistDump,\n> {\n /**\n * 初始状态\n *\n * ```typescript\n * cosnt initialState: {\n * count: number;\n * } = {\n * count: 0,\n * }\n *\n * const model = defineModel('model1', {\n * initialState\n * });\n * ```\n */\n initialState: State;\n /**\n * 定义修改状态的方法。参数一自动推断为state类型。支持**immer**操作。支持多参数。\n *\n * ```typescript\n * const model = defineModel('model1', {\n * initialState,\n * reducers: {\n * plus(state, step: number) {\n * state.count += step;\n * },\n * minus(state, step: number, scale: 1 | 2) {\n * state.count -= step * scale;\n * }\n * },\n * });\n * ```\n */\n reducers?: Action & InternalAction & ThisType>;\n /**\n * 定义普通方法，异步方法等。\n * 调用effect方法时，一般会伴随异步操作（请求数据、耗时任务），框架会自动收集当前方法的调用状态。\n *\n * ```typescript\n * const model = defineModel('model1', {\n * initialState,\n * methods: {\n * async foo(p1: string, p2: number) {\n * const result = await Promise.resolve();\n * this.setState({ x: result });\n * return 'OK';\n * }\n * },\n * });\n *\n * useLoading(model.foo); // 返回值类型: boolean\n * ```\n */\n methods?: Effect &\n ThisType & Effect & Computed & EffectCtx>;\n /**\n * 定义计算属性。针对需要复杂的计算才能得出结果的场景而设计。如果只是简单的返回，建议使用`methods`\n *\n * ```typescript\n * const initialState = { firstName: 'tick', lastName: 'tock' };\n *\n * const model = defineModel('model1', {\n * initialState,\n * computed: {\n * fullname() {\n * return this.state.firstName + '.' + this.state.lastName;\n * },\n * names() {\n * return this.fullName.value.split('').map((item) => `[${item}]`);\n * }\n * },\n * });\n * ```\n *\n * 可以单独使用：\n * ```typescript\n * model.fullname; // ComputedRef;\n * model.fullname.value; // string;\n * ```\n *\n * 可以配合react hooks使用：\n *\n * ```typescript\n * const fullname = useComputed(model.fullname); // string\n * ```\n */\n computed?: Computed & ThisType>;\n /**\n * 是否阻止刷新数据时跳过当前模型，默认即不跳过。\n *\n * 如果是强制刷新，则该参数无效。\n *\n * @see store.refresh(force: boolean = false)\n */\n skipRefresh?: boolean;\n /**\n * 定制持久化，请确保已经在初始化store的时候把当前模型加入persist配置，否则当前设置无效\n *\n * @see store.init()\n */\n persist?: ModelPersist & ThisType;\n /**\n * 生命周期\n * @since 0.11.1\n */\n events?: Event &\n ThisType & Computed & Effect & EventCtx>;\n}\n"
},
{
"path": "src/persist/persist-gate.tsx",
"content": "import { ReactNode, FC, useState, useEffect } from 'react';\nimport { modelStore } from '../store/model-store';\nimport { isFunction } from '../utils/is-type';\n\nexport interface PersistGateProps {\n loading?: ReactNode;\n children?: ReactNode | ((isReady: boolean) => ReactNode);\n}\n\nexport const PersistGate: FC = (props) => {\n const state = useState(() => modelStore.isReady),\n isReady = state[0],\n setIsReady = state[1];\n const { loading = null, children } = props;\n\n useEffect(() => {\n isReady ||\n modelStore.onInitialized().then(() => {\n setIsReady(true);\n });\n }, []);\n\n /* istanbul ignore else -- @preserve */\n if (process.env.NODE_ENV !== 'production') {\n if (loading && isFunction(children)) {\n console.error('[PersistGate] 当前children为函数类型，loading属性无效');\n }\n }\n\n return (\n <>\n {isFunction(children) ? children(isReady) : isReady ? children : loading}\n \n );\n};\n"
},
{
"path": "src/persist/persist-item.ts",
"content": "import type { StorageEngine } from '../engines/storage-engine';\nimport type {\n GetInitialState,\n InternalModel,\n Model,\n ModelPersist,\n} from '../model/types';\nimport { isObject, isPlainObject, isString } from '../utils/is-type';\nimport { toPromise } from '../utils/to-promise';\nimport { parseState, stringifyState } from '../utils/serialize';\n\nexport interface PersistSchema {\n /**\n * 版本\n */\n v: number | string;\n /**\n * 数据\n */\n d: {\n [key: string]: PersistItemSchema;\n };\n}\n\nexport interface PersistItemSchema {\n /**\n * 版本\n */\n v: number | string;\n /**\n * 数据\n */\n d: string;\n}\n\nexport type PersistMergeMode = 'replace' | 'merge' | 'deep-merge';\n\nexport interface PersistOptions {\n /**\n * 存储唯一标识名称\n */\n key: string;\n /**\n * 存储名称前缀，默认值：`@@foca.persist:`\n */\n keyPrefix?: string;\n /**\n * 持久化数据与初始数据的合并方式。默认值：`merge`\n *\n * - replace - 覆盖模式。数据从存储引擎取出后直接覆盖初始数据\n * - merge - 合并模式。数据从存储引擎取出后，与初始数据多余部分进行合并，可以理解为`Object.assign()`操作\n * - deep-merge - 二级合并模式。在合并模式的基础上，如果某个key的值为对象，则该对象也会执行合并操作\n *\n * 注意：当数据为数组格式时该配置无效。\n * @since 3.0.0\n */\n merge?: PersistMergeMode;\n /**\n * 版本号\n */\n version: string | number;\n /**\n * 存储引擎\n */\n engine: StorageEngine;\n /**\n * 允许持久化的模型列表\n */\n models: Model[];\n}\n\ntype CustomModelPersistOptions = Required> & {\n ctx: GetInitialState