@composy/store-core 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (300) hide show
  1. package/CHANGELOG.md +64 -3
  2. package/README.md +196 -172
  3. package/dist/index.js +1331 -1115
  4. package/dist/index.js.map +1 -1
  5. package/dist/index.min.js +578 -417
  6. package/dist/index.min.js.map +1 -1
  7. package/es/.dts-output-manifest.json +1 -0
  8. package/es/.dts.tsbuildinfo +1 -0
  9. package/es/core/async-action.d.ts +1 -71
  10. package/es/core/async-action.js +83 -35
  11. package/es/core/async-action.js.map +1 -1
  12. package/es/core/base-store.d.ts +27 -62
  13. package/es/core/base-store.js +174 -74
  14. package/es/core/base-store.js.map +1 -1
  15. package/es/core/batch-manager.d.ts +0 -1
  16. package/es/core/batch-manager.js +15 -2
  17. package/es/core/batch-manager.js.map +1 -1
  18. package/es/core/create-store.d.ts +3 -3
  19. package/es/core/create-store.js +3 -3
  20. package/es/core/create-store.js.map +1 -1
  21. package/es/core/event-bus.d.ts +0 -1
  22. package/es/core/event-bus.js +1 -1
  23. package/es/core/event-bus.js.map +1 -1
  24. package/es/core/index.d.ts +1 -2
  25. package/es/core/index.js +2 -2
  26. package/es/core/pub-sub.d.ts +0 -1
  27. package/es/core/pub-sub.js +1 -1
  28. package/es/core/pub-sub.js.map +1 -1
  29. package/es/engine/index.d.ts +0 -1
  30. package/es/engine/index.js +1 -1
  31. package/es/engine/plugin.d.ts +0 -1
  32. package/es/engine/plugin.js +11 -2
  33. package/es/engine/plugin.js.map +1 -1
  34. package/es/engine/types.d.ts +0 -1
  35. package/es/engine/types.js +1 -1
  36. package/es/errors/index.d.ts +0 -1
  37. package/es/errors/index.js +17 -1
  38. package/es/errors/index.js.map +1 -1
  39. package/es/index.d.ts +3 -4
  40. package/es/index.js +8 -8
  41. package/es/index.js.map +1 -1
  42. package/es/middleware/index.d.ts +3 -4
  43. package/es/middleware/index.js +2 -2
  44. package/es/middleware/logger.d.ts +0 -1
  45. package/es/middleware/logger.js +2 -2
  46. package/es/middleware/logger.js.map +1 -1
  47. package/es/middleware/middleware-manager.d.ts +0 -1
  48. package/es/middleware/middleware-manager.js +5 -2
  49. package/es/middleware/middleware-manager.js.map +1 -1
  50. package/es/middleware/persist.d.ts +0 -1
  51. package/es/middleware/persist.js +3 -3
  52. package/es/middleware/persist.js.map +1 -1
  53. package/es/middleware/time-travel.d.ts +0 -1
  54. package/es/middleware/time-travel.js +1 -1
  55. package/es/middleware/time-travel.js.map +1 -1
  56. package/es/middleware/validation.d.ts +0 -1
  57. package/es/middleware/validation.js +2 -2
  58. package/es/middleware/validation.js.map +1 -1
  59. package/es/plugins/define-plugin.d.ts +1 -2
  60. package/es/plugins/define-plugin.js +2 -2
  61. package/es/plugins/define-plugin.js.map +1 -1
  62. package/es/plugins/index.d.ts +0 -1
  63. package/es/plugins/index.js +2 -2
  64. package/es/plugins/plugin-manager.d.ts +1 -31
  65. package/es/plugins/plugin-manager.js +58 -27
  66. package/es/plugins/plugin-manager.js.map +1 -1
  67. package/es/types/action.d.ts +2 -0
  68. package/es/types/action.js +10 -0
  69. package/es/types/batch.d.ts +2 -0
  70. package/es/types/batch.js +10 -0
  71. package/es/types/event.d.ts +2 -0
  72. package/es/types/event.js +10 -0
  73. package/es/types/index.d.ts +2 -3
  74. package/es/types/index.js +1 -1
  75. package/es/types/middleware.d.ts +10 -2
  76. package/es/types/middleware.js +1 -1
  77. package/es/types/mutation.d.ts +2 -0
  78. package/es/types/mutation.js +10 -0
  79. package/es/types/plugin.d.ts +4 -1
  80. package/es/types/plugin.js +1 -1
  81. package/es/types/state.d.ts +2 -0
  82. package/es/types/state.js +10 -0
  83. package/es/types/store.d.ts +19 -1
  84. package/es/types/store.js +1 -1
  85. package/es/types/subscription.d.ts +7 -2
  86. package/es/types/subscription.js +1 -1
  87. package/es/types/time-travel.d.ts +2 -0
  88. package/es/types/time-travel.js +10 -0
  89. package/es/types/utility.d.ts +3 -4
  90. package/es/types/utility.js +1 -1
  91. package/es/utils/debounce-throttle.d.ts +0 -1
  92. package/es/utils/debounce-throttle.js +1 -1
  93. package/es/utils/debounce-throttle.js.map +1 -1
  94. package/es/utils/deep-clone.d.ts +0 -1
  95. package/es/utils/deep-clone.js +1 -1
  96. package/es/utils/deep-clone.js.map +1 -1
  97. package/es/utils/index.d.ts +4 -5
  98. package/es/utils/index.js +1 -1
  99. package/es/utils/selector.d.ts +0 -1
  100. package/es/utils/selector.js +1 -1
  101. package/es/utils/selector.js.map +1 -1
  102. package/esm/core/async-action.js +83 -35
  103. package/esm/core/async-action.js.map +1 -1
  104. package/esm/core/base-store.js +174 -74
  105. package/esm/core/base-store.js.map +1 -1
  106. package/esm/core/batch-manager.js +15 -2
  107. package/esm/core/batch-manager.js.map +1 -1
  108. package/esm/core/create-store.js +3 -3
  109. package/esm/core/create-store.js.map +1 -1
  110. package/esm/core/event-bus.js +1 -1
  111. package/esm/core/event-bus.js.map +1 -1
  112. package/esm/core/index.js +2 -2
  113. package/esm/core/pub-sub.js +1 -1
  114. package/esm/core/pub-sub.js.map +1 -1
  115. package/esm/engine/index.js +1 -1
  116. package/esm/engine/plugin.js +11 -2
  117. package/esm/engine/plugin.js.map +1 -1
  118. package/esm/errors/index.js +17 -1
  119. package/esm/errors/index.js.map +1 -1
  120. package/esm/index.js +8 -8
  121. package/esm/index.js.map +1 -1
  122. package/esm/middleware/logger.js +2 -2
  123. package/esm/middleware/logger.js.map +1 -1
  124. package/esm/middleware/middleware-manager.js +5 -2
  125. package/esm/middleware/middleware-manager.js.map +1 -1
  126. package/esm/middleware/persist.js +3 -3
  127. package/esm/middleware/persist.js.map +1 -1
  128. package/esm/middleware/time-travel.js +1 -1
  129. package/esm/middleware/time-travel.js.map +1 -1
  130. package/esm/middleware/validation.js +2 -2
  131. package/esm/middleware/validation.js.map +1 -1
  132. package/esm/plugins/define-plugin.js +2 -2
  133. package/esm/plugins/define-plugin.js.map +1 -1
  134. package/esm/plugins/plugin-manager.js +58 -27
  135. package/esm/plugins/plugin-manager.js.map +1 -1
  136. package/esm/utils/debounce-throttle.js +1 -1
  137. package/esm/utils/debounce-throttle.js.map +1 -1
  138. package/esm/utils/deep-clone.js +1 -1
  139. package/esm/utils/deep-clone.js.map +1 -1
  140. package/esm/utils/selector.js +1 -1
  141. package/esm/utils/selector.js.map +1 -1
  142. package/lib/core/async-action.cjs +83 -35
  143. package/lib/core/async-action.cjs.map +1 -1
  144. package/lib/core/async-action.d.cts +25 -0
  145. package/lib/core/base-store.cjs +174 -74
  146. package/lib/core/base-store.cjs.map +1 -1
  147. package/lib/core/base-store.d.cts +50 -0
  148. package/lib/core/batch-manager.cjs +15 -2
  149. package/lib/core/batch-manager.cjs.map +1 -1
  150. package/{esm/core/batch-manager.d.ts → lib/core/batch-manager.d.cts} +0 -1
  151. package/lib/core/create-store.cjs +3 -3
  152. package/lib/core/create-store.cjs.map +1 -1
  153. package/lib/core/{create-store.d.ts → create-store.d.cts} +3 -3
  154. package/lib/core/event-bus.cjs +1 -1
  155. package/lib/core/event-bus.cjs.map +1 -1
  156. package/lib/core/{event-bus.d.ts → event-bus.d.cts} +0 -1
  157. package/lib/core/index.cjs +2 -2
  158. package/{esm/core/index.d.ts → lib/core/index.d.cts} +1 -2
  159. package/lib/core/pub-sub.cjs +1 -1
  160. package/lib/core/pub-sub.cjs.map +1 -1
  161. package/lib/core/{pub-sub.d.ts → pub-sub.d.cts} +0 -1
  162. package/lib/engine/index.cjs +1 -1
  163. package/{esm/engine/index.d.ts → lib/engine/index.d.cts} +0 -1
  164. package/lib/engine/plugin.cjs +11 -2
  165. package/lib/engine/plugin.cjs.map +1 -1
  166. package/{esm/engine/plugin.d.ts → lib/engine/plugin.d.cts} +0 -1
  167. package/lib/engine/types.cjs +1 -1
  168. package/lib/engine/{types.d.ts → types.d.cts} +0 -1
  169. package/lib/errors/index.cjs +17 -1
  170. package/lib/errors/index.cjs.map +1 -1
  171. package/lib/errors/{index.d.ts → index.d.cts} +0 -1
  172. package/lib/index.cjs +8 -8
  173. package/lib/index.cjs.map +1 -1
  174. package/lib/{index.d.ts → index.d.cts} +3 -4
  175. package/lib/middleware/index.cjs +2 -2
  176. package/lib/middleware/{index.d.ts → index.d.cts} +3 -4
  177. package/lib/middleware/logger.cjs +2 -2
  178. package/lib/middleware/logger.cjs.map +1 -1
  179. package/lib/middleware/{logger.d.ts → logger.d.cts} +0 -1
  180. package/lib/middleware/middleware-manager.cjs +5 -2
  181. package/lib/middleware/middleware-manager.cjs.map +1 -1
  182. package/lib/middleware/{middleware-manager.d.ts → middleware-manager.d.cts} +0 -1
  183. package/lib/middleware/persist.cjs +3 -3
  184. package/lib/middleware/persist.cjs.map +1 -1
  185. package/{esm/middleware/persist.d.ts → lib/middleware/persist.d.cts} +0 -1
  186. package/lib/middleware/time-travel.cjs +1 -1
  187. package/lib/middleware/time-travel.cjs.map +1 -1
  188. package/{esm/middleware/time-travel.d.ts → lib/middleware/time-travel.d.cts} +0 -1
  189. package/lib/middleware/validation.cjs +2 -2
  190. package/lib/middleware/validation.cjs.map +1 -1
  191. package/{esm/middleware/validation.d.ts → lib/middleware/validation.d.cts} +0 -1
  192. package/lib/plugins/define-plugin.cjs +2 -2
  193. package/lib/plugins/define-plugin.cjs.map +1 -1
  194. package/{esm/plugins/define-plugin.d.ts → lib/plugins/define-plugin.d.cts} +1 -2
  195. package/lib/plugins/index.cjs +2 -2
  196. package/{esm/plugins/index.d.ts → lib/plugins/index.d.cts} +0 -1
  197. package/lib/plugins/plugin-manager.cjs +58 -27
  198. package/lib/plugins/plugin-manager.cjs.map +1 -1
  199. package/lib/plugins/plugin-manager.d.cts +5 -0
  200. package/lib/types/action.cjs +12 -0
  201. package/lib/types/action.d.cts +2 -0
  202. package/lib/types/batch.cjs +12 -0
  203. package/lib/types/batch.d.cts +2 -0
  204. package/lib/types/event.cjs +12 -0
  205. package/lib/types/event.d.cts +2 -0
  206. package/lib/types/index.cjs +1 -1
  207. package/{esm/types/index.d.ts → lib/types/index.d.cts} +2 -3
  208. package/lib/types/middleware.cjs +1 -1
  209. package/lib/types/{middleware.d.ts → middleware.d.cts} +10 -2
  210. package/lib/types/mutation.cjs +12 -0
  211. package/lib/types/mutation.d.cts +2 -0
  212. package/lib/types/plugin.cjs +1 -1
  213. package/lib/types/{plugin.d.ts → plugin.d.cts} +4 -1
  214. package/lib/types/state.cjs +12 -0
  215. package/lib/types/state.d.cts +2 -0
  216. package/lib/types/store.cjs +1 -1
  217. package/lib/types/{store.d.ts → store.d.cts} +19 -1
  218. package/lib/types/subscription.cjs +1 -1
  219. package/lib/types/{subscription.d.ts → subscription.d.cts} +7 -2
  220. package/lib/types/time-travel.cjs +12 -0
  221. package/lib/types/time-travel.d.cts +2 -0
  222. package/lib/types/utility.cjs +1 -1
  223. package/lib/types/{utility.d.ts → utility.d.cts} +3 -4
  224. package/lib/utils/debounce-throttle.cjs +1 -1
  225. package/lib/utils/debounce-throttle.cjs.map +1 -1
  226. package/{esm/utils/debounce-throttle.d.ts → lib/utils/debounce-throttle.d.cts} +0 -1
  227. package/lib/utils/deep-clone.cjs +1 -1
  228. package/lib/utils/deep-clone.cjs.map +1 -1
  229. package/lib/utils/{deep-clone.d.ts → deep-clone.d.cts} +0 -1
  230. package/lib/utils/index.cjs +1 -1
  231. package/lib/utils/{index.d.ts → index.d.cts} +4 -5
  232. package/lib/utils/selector.cjs +1 -1
  233. package/lib/utils/selector.cjs.map +1 -1
  234. package/lib/utils/{selector.d.ts → selector.d.cts} +0 -1
  235. package/package.json +14 -11
  236. package/es/core/async-action.d.ts.map +0 -1
  237. package/es/core/base-store.d.ts.map +0 -1
  238. package/es/core/batch-manager.d.ts.map +0 -1
  239. package/es/core/create-store.d.ts.map +0 -1
  240. package/es/core/event-bus.d.ts.map +0 -1
  241. package/es/core/index.d.ts.map +0 -1
  242. package/es/core/pub-sub.d.ts.map +0 -1
  243. package/es/engine/index.d.ts.map +0 -1
  244. package/es/engine/plugin.d.ts.map +0 -1
  245. package/es/engine/types.d.ts.map +0 -1
  246. package/es/errors/index.d.ts.map +0 -1
  247. package/es/index.d.ts.map +0 -1
  248. package/es/middleware/index.d.ts.map +0 -1
  249. package/es/middleware/logger.d.ts.map +0 -1
  250. package/es/middleware/middleware-manager.d.ts.map +0 -1
  251. package/es/middleware/persist.d.ts.map +0 -1
  252. package/es/middleware/time-travel.d.ts.map +0 -1
  253. package/es/middleware/validation.d.ts.map +0 -1
  254. package/es/plugins/define-plugin.d.ts.map +0 -1
  255. package/es/plugins/index.d.ts.map +0 -1
  256. package/es/plugins/plugin-manager.d.ts.map +0 -1
  257. package/es/types/index.d.ts.map +0 -1
  258. package/es/types/middleware.d.ts.map +0 -1
  259. package/es/types/plugin.d.ts.map +0 -1
  260. package/es/types/store.d.ts.map +0 -1
  261. package/es/types/subscription.d.ts.map +0 -1
  262. package/es/types/utility.d.ts.map +0 -1
  263. package/es/utils/debounce-throttle.d.ts.map +0 -1
  264. package/es/utils/deep-clone.d.ts.map +0 -1
  265. package/es/utils/index.d.ts.map +0 -1
  266. package/es/utils/selector.d.ts.map +0 -1
  267. package/esm/core/async-action.d.ts +0 -95
  268. package/esm/core/base-store.d.ts +0 -85
  269. package/esm/core/create-store.d.ts +0 -66
  270. package/esm/core/event-bus.d.ts +0 -34
  271. package/esm/core/pub-sub.d.ts +0 -41
  272. package/esm/engine/types.d.ts +0 -81
  273. package/esm/errors/index.d.ts +0 -208
  274. package/esm/index.d.ts +0 -27
  275. package/esm/middleware/index.d.ts +0 -13
  276. package/esm/middleware/logger.d.ts +0 -67
  277. package/esm/middleware/middleware-manager.d.ts +0 -40
  278. package/esm/plugins/plugin-manager.d.ts +0 -35
  279. package/esm/types/middleware.d.ts +0 -172
  280. package/esm/types/plugin.d.ts +0 -136
  281. package/esm/types/store.d.ts +0 -198
  282. package/esm/types/subscription.d.ts +0 -158
  283. package/esm/types/utility.d.ts +0 -312
  284. package/esm/utils/deep-clone.d.ts +0 -143
  285. package/esm/utils/index.d.ts +0 -13
  286. package/esm/utils/selector.d.ts +0 -213
  287. package/lib/core/async-action.d.ts +0 -95
  288. package/lib/core/base-store.d.ts +0 -85
  289. package/lib/core/batch-manager.d.ts +0 -46
  290. package/lib/core/index.d.ts +0 -14
  291. package/lib/engine/index.d.ts +0 -10
  292. package/lib/engine/plugin.d.ts +0 -20
  293. package/lib/middleware/persist.d.ts +0 -34
  294. package/lib/middleware/time-travel.d.ts +0 -30
  295. package/lib/middleware/validation.d.ts +0 -100
  296. package/lib/plugins/define-plugin.d.ts +0 -74
  297. package/lib/plugins/index.d.ts +0 -8
  298. package/lib/plugins/plugin-manager.d.ts +0 -35
  299. package/lib/types/index.d.ts +0 -12
  300. package/lib/utils/debounce-throttle.d.ts +0 -86
@@ -1 +1 @@
1
- {"version":3,"file":"deep-clone.js","names":["result"],"sources":["../../src/utils/deep-clone.ts"],"sourcesContent":["/**\n * 深拷贝工具\n *\n * 提供高性能的深拷贝、浅拷贝和深度合并功能\n * @module utils/deep-clone\n */\n\nconst hasOwnProperty = Object.prototype.hasOwnProperty\n\nfunction hasOwnKey(value: object, key: PropertyKey): boolean {\n return hasOwnProperty.call(value, key)\n}\n\n/**\n * 判断是否为对象\n *\n * @param value - 待检查的值\n * @returns 是否为对象\n */\nexport function isObject(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === 'object'\n}\n\n/**\n * 判断是否为普通对象(非数组、非内置对象)\n *\n * @param value - 待检查的值\n * @returns 是否为普通对象\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n if (!isObject(value)) return false\n const proto = Object.getPrototypeOf(value)\n return proto === null || proto === Object.prototype\n}\n\n/**\n * 判断值是否可以被 structuredClone 处理\n *\n * @param value - 待检查的值\n * @returns 是否可以使用 structuredClone\n */\nfunction isStructuredCloneable(value: unknown): boolean {\n // 基础类型\n if (value === null || value === undefined) return true\n if (typeof value === 'boolean' || typeof value === 'number' || typeof value === 'string') return true\n if (typeof value === 'bigint') return true\n\n // 函数和 Symbol 不可克隆\n if (typeof value === 'function' || typeof value === 'symbol') return false\n\n // 内置可克隆对象\n if (value instanceof Date || value instanceof RegExp) return true\n if (value instanceof ArrayBuffer || value instanceof DataView) return true\n if (value instanceof Map || value instanceof Set) return true\n if (ArrayBuffer.isView(value)) return true\n\n // 普通对象和数组递归检查\n if (Array.isArray(value)) {\n return value.every(item => isStructuredCloneable(item))\n }\n\n if (isPlainObject(value)) {\n return Object.values(value).every(v => isStructuredCloneable(v))\n }\n\n return false\n}\n\n/**\n * 深拷贝配置选项\n */\nexport interface DeepCloneOptions {\n /** 是否优先使用 structuredClone(默认 true) */\n useStructuredClone?: boolean\n /** 是否克隆函数(默认 false,函数保持引用) */\n cloneFunctions?: boolean\n /** 是否克隆 Symbol 属性(默认 false) */\n cloneSymbols?: boolean\n /** 最大深度(默认无限制) */\n maxDepth?: number\n /** 自定义克隆器 */\n customCloner?: <T>(value: T, clone: <U>(v: U) => U) => T | undefined\n}\n\n/**\n * 深拷贝\n *\n * 高性能深拷贝实现,优先使用原生 structuredClone(如果可用)\n *\n * @template T - 值类型\n * @param value - 要拷贝的值\n * @param options - 配置选项\n * @returns 拷贝后的值\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: { c: 2 } }\n * const cloned = deepClone(obj)\n * cloned.b.c = 3\n * console.log(obj.b.c) // 2\n * ```\n *\n * @example\n * ```typescript\n * // 带配置的深拷贝\n * const cloned = deepClone(obj, {\n * maxDepth: 5,\n * cloneSymbols: true\n * })\n * ```\n */\nexport function deepClone<T>(value: T, options: DeepCloneOptions = {}): T {\n const {\n useStructuredClone: preferStructuredClone = true,\n cloneFunctions = false,\n cloneSymbols = false,\n maxDepth = Infinity,\n customCloner,\n } = options\n\n // 尝试使用 structuredClone(性能更好)\n if (preferStructuredClone && typeof structuredClone === 'function' && isStructuredCloneable(value)) {\n try {\n return structuredClone(value)\n }\n catch {\n // structuredClone 失败,回退到手动实现\n }\n }\n\n const cache = new WeakMap<object, unknown>()\n\n function cloneInternal<U>(val: U, depth: number): U {\n // 基础类型直接返回\n if (val === null || val === undefined) return val\n if (typeof val === 'boolean' || typeof val === 'number' || typeof val === 'string') return val\n if (typeof val === 'bigint') return val\n\n // Symbol 处理\n if (typeof val === 'symbol') {\n return cloneSymbols ? Symbol(val.description) as U : val\n }\n\n // 函数处理\n if (typeof val === 'function') {\n return cloneFunctions ? (val.bind({}) as U) : val\n }\n\n // 深度检查\n if (depth > maxDepth) {\n return val\n }\n\n // 自定义克隆器\n if (customCloner) {\n const customResult = customCloner(val, v => cloneInternal(v, depth + 1))\n if (customResult !== undefined) {\n return customResult\n }\n }\n\n // 检查循环引用\n if (typeof val === 'object' && val !== null) {\n if (cache.has(val)) {\n return cache.get(val) as U\n }\n }\n\n // 处理日期\n if (val instanceof Date) {\n return new Date(val.getTime()) as U\n }\n\n // 处理正则\n if (val instanceof RegExp) {\n const result = new RegExp(val.source, val.flags)\n ;(result as RegExp).lastIndex = val.lastIndex\n return result as U\n }\n\n // 处理 Error\n if (val instanceof Error) {\n const result = new (val.constructor as ErrorConstructor)(val.message)\n result.stack = val.stack\n result.name = val.name\n return result as U\n }\n\n // 处理 Map\n if (val instanceof Map) {\n const result = new Map()\n cache.set(val, result)\n val.forEach((v, k) => {\n result.set(cloneInternal(k, depth + 1), cloneInternal(v, depth + 1))\n })\n return result as U\n }\n\n // 处理 Set\n if (val instanceof Set) {\n const result = new Set()\n cache.set(val, result)\n val.forEach((v) => {\n result.add(cloneInternal(v, depth + 1))\n })\n return result as U\n }\n\n // 处理 ArrayBuffer\n if (val instanceof ArrayBuffer) {\n return val.slice(0) as U\n }\n\n // 处理 TypedArray\n if (ArrayBuffer.isView(val) && !(val instanceof DataView)) {\n const TypedArrayConstructor = val.constructor as new (buffer: ArrayBuffer) => typeof val\n return new TypedArrayConstructor((val as unknown as { buffer: ArrayBuffer }).buffer.slice(0)) as U\n }\n\n // 处理数组\n if (Array.isArray(val)) {\n const result: unknown[] = []\n cache.set(val, result)\n for (let i = 0; i < val.length; i++) {\n result[i] = cloneInternal(val[i], depth + 1)\n }\n return result as U\n }\n\n // 处理普通对象\n if (isPlainObject(val)) {\n const result: Record<string | symbol, unknown> = {}\n cache.set(val, result)\n\n // 克隆字符串键\n const keys = Object.keys(val)\n for (const key of keys) {\n result[key] = cloneInternal((val as Record<string, unknown>)[key], depth + 1)\n }\n\n // 克隆 Symbol 键\n if (cloneSymbols) {\n const symbolKeys = Object.getOwnPropertySymbols(val)\n for (const sym of symbolKeys) {\n result[sym] = cloneInternal((val as Record<symbol, unknown>)[sym], depth + 1)\n }\n }\n\n return result as U\n }\n\n // 其他对象类型(如自定义类实例)直接返回\n return val\n }\n\n return cloneInternal(value, 0)\n}\n\n/**\n * 浅拷贝\n *\n * @template T - 值类型\n * @param value - 要拷贝的值\n * @returns 拷贝后的值\n *\n * @example\n * ```typescript\n * const arr = [1, 2, { a: 3 }]\n * const cloned = shallowClone(arr)\n * cloned[2].a = 4\n * console.log(arr[2].a) // 4 (浅拷贝,嵌套对象共享引用)\n * ```\n */\nexport function shallowClone<T>(value: T): T {\n if (value === null || value === undefined) return value\n if (typeof value !== 'object') return value\n\n if (Array.isArray(value)) {\n return [...value] as T\n }\n\n if (value instanceof Map) {\n return new Map(value) as T\n }\n\n if (value instanceof Set) {\n return new Set(value) as T\n }\n\n if (value instanceof Date) {\n return new Date(value.getTime()) as T\n }\n\n return { ...value }\n}\n\n/**\n * 深度合并配置选项\n */\nexport interface DeepMergeOptions {\n /** 数组合并策略:'replace' 替换 | 'concat' 连接 | 'merge' 按索引合并 */\n arrayStrategy?: 'replace' | 'concat' | 'merge'\n /** 是否克隆源对象(默认 true) */\n clone?: boolean\n /** 最大深度 */\n maxDepth?: number\n}\n\n/**\n * 深度合并对象\n *\n * 将多个源对象深度合并到目标对象\n *\n * @template T - 目标对象类型\n * @param target - 目标对象\n * @param sources - 源对象列表\n * @returns 合并后的对象\n *\n * @example\n * ```typescript\n * const target = { a: 1, b: { c: 2 } }\n * const source = { b: { d: 3 }, e: 4 }\n * const result = deepMerge(target, source)\n * // { a: 1, b: { c: 2, d: 3 }, e: 4 }\n * ```\n */\nexport function deepMerge<T extends Record<string, unknown>>(\n target: T,\n ...sources: Array<Partial<T>>\n): T {\n return deepMergeWithOptions(target, {}, ...sources)\n}\n\n/**\n * 带配置的深度合并\n *\n * @template T - 目标对象类型\n * @param target - 目标对象\n * @param options - 合并配置\n * @param sources - 源对象列表\n * @returns 合并后的对象\n */\nexport function deepMergeWithOptions<T extends Record<string, unknown>>(\n target: T,\n options: DeepMergeOptions,\n ...sources: Array<Partial<T>>\n): T {\n const {\n arrayStrategy = 'replace',\n clone = true,\n maxDepth = Infinity,\n } = options\n\n function mergeInternal(\n targetObj: Record<string, unknown>,\n sourceObj: Record<string, unknown>,\n depth: number,\n ): Record<string, unknown> {\n if (depth > maxDepth) {\n return targetObj\n }\n\n for (const key of Object.keys(sourceObj)) {\n const sourceValue = sourceObj[key]\n const targetValue = targetObj[key]\n\n // 处理数组\n if (Array.isArray(sourceValue)) {\n if (arrayStrategy === 'concat' && Array.isArray(targetValue)) {\n targetObj[key] = [...targetValue, ...sourceValue]\n }\n else if (arrayStrategy === 'merge' && Array.isArray(targetValue)) {\n const result = [...targetValue]\n sourceValue.forEach((item, index) => {\n if (isPlainObject(item) && isPlainObject(result[index])) {\n result[index] = mergeInternal(result[index] as Record<string, unknown>, item, depth + 1)\n }\n else {\n result[index] = clone ? deepClone(item) : item\n }\n })\n targetObj[key] = result\n }\n else {\n targetObj[key] = clone ? deepClone(sourceValue) : sourceValue\n }\n }\n // 处理普通对象\n else if (isPlainObject(sourceValue)) {\n if (isPlainObject(targetValue)) {\n targetObj[key] = mergeInternal(\n targetValue as Record<string, unknown>,\n sourceValue,\n depth + 1,\n )\n }\n else {\n targetObj[key] = clone ? deepClone(sourceValue) : sourceValue\n }\n }\n // 其他类型直接赋值\n else {\n targetObj[key] = clone && isObject(sourceValue) ? deepClone(sourceValue) : sourceValue\n }\n }\n\n return targetObj\n }\n\n let result = target\n\n for (const source of sources) {\n if (source !== null && source !== undefined) {\n result = mergeInternal(result, source, 0) as T\n }\n }\n\n return result\n}\n\n/**\n * 比较两个值是否深度相等\n *\n * @param a - 第一个值\n * @param b - 第二个值\n * @returns 是否相等\n *\n * @example\n * ```typescript\n * deepEqual({ a: 1 }, { a: 1 }) // true\n * deepEqual([1, 2], [1, 2]) // true\n * deepEqual({ a: { b: 1 } }, { a: { b: 2 } }) // false\n * ```\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n // 严格相等\n if (a === b) return true\n\n // null/undefined 检查\n if (a === null || b === null || a === undefined || b === undefined) {\n return a === b\n }\n\n // 类型不同\n if (typeof a !== typeof b) return false\n\n // 基础类型\n if (typeof a !== 'object') return a === b\n\n // 日期比较\n if (a instanceof Date && b instanceof Date) {\n return a.getTime() === b.getTime()\n }\n\n // 正则比较\n if (a instanceof RegExp && b instanceof RegExp) {\n return a.source === b.source && a.flags === b.flags\n }\n\n // Map 比较\n if (a instanceof Map && b instanceof Map) {\n if (a.size !== b.size) return false\n for (const [key, value] of a) {\n if (!b.has(key) || !deepEqual(value, b.get(key))) {\n return false\n }\n }\n return true\n }\n\n // Set 比较\n if (a instanceof Set && b instanceof Set) {\n if (a.size !== b.size) return false\n for (const value of a) {\n if (!b.has(value)) return false\n }\n return true\n }\n\n // 数组比较\n if (Array.isArray(a) && Array.isArray(b)) {\n if (a.length !== b.length) return false\n for (let i = 0; i < a.length; i++) {\n if (!deepEqual(a[i], b[i])) return false\n }\n return true\n }\n\n // 对象比较\n if (isPlainObject(a) && isPlainObject(b)) {\n const keysA = Object.keys(a)\n const keysB = Object.keys(b)\n if (keysA.length !== keysB.length) return false\n for (const key of keysA) {\n if (!hasOwnKey(b, key)) return false\n if (!deepEqual(a[key], b[key])) return false\n }\n return true\n }\n\n return false\n}\n\n/**\n * 冻结对象(深度)\n *\n * @template T - 对象类型\n * @param obj - 要冻结的对象\n * @returns 冻结后的对象\n */\nexport function deepFreeze<T extends object>(obj: T): Readonly<T> {\n const propNames = Object.getOwnPropertyNames(obj)\n\n for (const name of propNames) {\n const value = (obj as Record<string, unknown>)[name]\n if (value && typeof value === 'object') {\n deepFreeze(value)\n }\n }\n\n return Object.freeze(obj)\n}\n\n"],"mappings":"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"}
1
+ {"version":3,"file":"deep-clone.js","names":["result"],"sources":["../../src/utils/deep-clone.ts"],"sourcesContent":["/**\r\n * 深拷贝工具\r\n *\r\n * 提供高性能的深拷贝、浅拷贝和深度合并功能\r\n * @module utils/deep-clone\r\n */\r\n\r\nconst hasOwnProperty = Object.prototype.hasOwnProperty\r\n\r\nfunction hasOwnKey(value: object, key: PropertyKey): boolean {\r\n return hasOwnProperty.call(value, key)\r\n}\r\n\r\n/**\r\n * 判断是否为对象\r\n *\r\n * @param value - 待检查的值\r\n * @returns 是否为对象\r\n */\r\nexport function isObject(value: unknown): value is Record<string, unknown> {\r\n return value !== null && typeof value === 'object'\r\n}\r\n\r\n/**\r\n * 判断是否为普通对象(非数组、非内置对象)\r\n *\r\n * @param value - 待检查的值\r\n * @returns 是否为普通对象\r\n */\r\nexport function isPlainObject(\r\n value: unknown\r\n): value is Record<string, unknown> {\r\n if (!isObject(value)) return false\r\n const proto = Object.getPrototypeOf(value)\r\n return proto === null || proto === Object.prototype\r\n}\r\n\r\n/**\r\n * 判断值是否可以被 structuredClone 处理\r\n *\r\n * @param value - 待检查的值\r\n * @returns 是否可以使用 structuredClone\r\n */\r\nfunction isStructuredCloneable(value: unknown): boolean {\r\n // 基础类型\r\n if (value === null || value === undefined) return true\r\n if (\r\n typeof value === 'boolean' ||\r\n typeof value === 'number' ||\r\n typeof value === 'string'\r\n )\r\n return true\r\n if (typeof value === 'bigint') return true\r\n\r\n // 函数和 Symbol 不可克隆\r\n if (typeof value === 'function' || typeof value === 'symbol') return false\r\n\r\n // 内置可克隆对象\r\n if (value instanceof Date || value instanceof RegExp) return true\r\n if (value instanceof ArrayBuffer || value instanceof DataView) return true\r\n if (value instanceof Map || value instanceof Set) return true\r\n if (ArrayBuffer.isView(value)) return true\r\n\r\n // 普通对象和数组递归检查\r\n if (Array.isArray(value)) {\r\n return value.every(item => isStructuredCloneable(item))\r\n }\r\n\r\n if (isPlainObject(value)) {\r\n return Object.values(value).every(v => isStructuredCloneable(v))\r\n }\r\n\r\n return false\r\n}\r\n\r\n/**\r\n * 深拷贝配置选项\r\n */\r\nexport interface DeepCloneOptions {\r\n /** 是否优先使用 structuredClone(默认 true) */\r\n useStructuredClone?: boolean\r\n /** 是否克隆函数(默认 false,函数保持引用) */\r\n cloneFunctions?: boolean\r\n /** 是否克隆 Symbol 属性(默认 false) */\r\n cloneSymbols?: boolean\r\n /** 最大深度(默认无限制) */\r\n maxDepth?: number\r\n /** 自定义克隆器 */\r\n customCloner?: <T>(value: T, clone: <U>(v: U) => U) => T | undefined\r\n}\r\n\r\n/**\r\n * 深拷贝\r\n *\r\n * 高性能深拷贝实现,优先使用原生 structuredClone(如果可用)\r\n *\r\n * @template T - 值类型\r\n * @param value - 要拷贝的值\r\n * @param options - 配置选项\r\n * @returns 拷贝后的值\r\n *\r\n * @example\r\n * ```typescript\r\n * const obj = { a: 1, b: { c: 2 } }\r\n * const cloned = deepClone(obj)\r\n * cloned.b.c = 3\r\n * console.log(obj.b.c) // 2\r\n * ```\r\n *\r\n * @example\r\n * ```typescript\r\n * // 带配置的深拷贝\r\n * const cloned = deepClone(obj, {\r\n * maxDepth: 5,\r\n * cloneSymbols: true\r\n * })\r\n * ```\r\n */\r\nexport function deepClone<T>(value: T, options: DeepCloneOptions = {}): T {\r\n const {\r\n useStructuredClone: preferStructuredClone = true,\r\n cloneFunctions = false,\r\n cloneSymbols = false,\r\n maxDepth = Infinity,\r\n customCloner,\r\n } = options\r\n\r\n // 尝试使用 structuredClone(性能更好)\r\n if (\r\n preferStructuredClone &&\r\n typeof structuredClone === 'function' &&\r\n isStructuredCloneable(value)\r\n ) {\r\n try {\r\n return structuredClone(value)\r\n } catch {\r\n // structuredClone 失败,回退到手动实现\r\n }\r\n }\r\n\r\n const cache = new WeakMap<object, unknown>()\r\n\r\n function cloneInternal<U>(val: U, depth: number): U {\r\n // 基础类型直接返回\r\n if (val === null || val === undefined) return val\r\n if (\r\n typeof val === 'boolean' ||\r\n typeof val === 'number' ||\r\n typeof val === 'string'\r\n )\r\n return val\r\n if (typeof val === 'bigint') return val\r\n\r\n // Symbol 处理\r\n if (typeof val === 'symbol') {\r\n return cloneSymbols ? (Symbol(val.description) as U) : val\r\n }\r\n\r\n // 函数处理\r\n if (typeof val === 'function') {\r\n return cloneFunctions ? (val.bind({}) as U) : val\r\n }\r\n\r\n // 深度检查\r\n if (depth > maxDepth) {\r\n return val\r\n }\r\n\r\n // 自定义克隆器\r\n if (customCloner) {\r\n const customResult = customCloner(val, v => cloneInternal(v, depth + 1))\r\n if (customResult !== undefined) {\r\n return customResult\r\n }\r\n }\r\n\r\n // 检查循环引用\r\n if (typeof val === 'object' && val !== null) {\r\n if (cache.has(val)) {\r\n return cache.get(val) as U\r\n }\r\n }\r\n\r\n // 处理日期\r\n if (val instanceof Date) {\r\n return new Date(val.getTime()) as U\r\n }\r\n\r\n // 处理正则\r\n if (val instanceof RegExp) {\r\n const result = new RegExp(val.source, val.flags)\r\n ;(result as RegExp).lastIndex = val.lastIndex\r\n return result as U\r\n }\r\n\r\n // 处理 Error\r\n if (val instanceof Error) {\r\n const result = new (val.constructor as ErrorConstructor)(val.message)\r\n result.stack = val.stack\r\n result.name = val.name\r\n return result as U\r\n }\r\n\r\n // 处理 Map\r\n if (val instanceof Map) {\r\n const result = new Map()\r\n cache.set(val, result)\r\n val.forEach((v, k) => {\r\n result.set(cloneInternal(k, depth + 1), cloneInternal(v, depth + 1))\r\n })\r\n return result as U\r\n }\r\n\r\n // 处理 Set\r\n if (val instanceof Set) {\r\n const result = new Set()\r\n cache.set(val, result)\r\n val.forEach(v => {\r\n result.add(cloneInternal(v, depth + 1))\r\n })\r\n return result as U\r\n }\r\n\r\n // 处理 ArrayBuffer\r\n if (val instanceof ArrayBuffer) {\r\n return val.slice(0) as U\r\n }\r\n\r\n // 处理 TypedArray\r\n if (ArrayBuffer.isView(val) && !(val instanceof DataView)) {\r\n const TypedArrayConstructor = val.constructor as new (\r\n buffer: ArrayBuffer\r\n ) => typeof val\r\n return new TypedArrayConstructor(\r\n (val as unknown as { buffer: ArrayBuffer }).buffer.slice(0)\r\n ) as U\r\n }\r\n\r\n // 处理数组\r\n if (Array.isArray(val)) {\r\n const result: unknown[] = []\r\n cache.set(val, result)\r\n for (let i = 0; i < val.length; i++) {\r\n result[i] = cloneInternal(val[i], depth + 1)\r\n }\r\n return result as U\r\n }\r\n\r\n // 处理普通对象\r\n if (isPlainObject(val)) {\r\n const result: Record<string | symbol, unknown> = {}\r\n cache.set(val, result)\r\n\r\n // 克隆字符串键\r\n const keys = Object.keys(val)\r\n for (const key of keys) {\r\n result[key] = cloneInternal(\r\n (val as Record<string, unknown>)[key],\r\n depth + 1\r\n )\r\n }\r\n\r\n // 克隆 Symbol 键\r\n if (cloneSymbols) {\r\n const symbolKeys = Object.getOwnPropertySymbols(val)\r\n for (const sym of symbolKeys) {\r\n result[sym] = cloneInternal(\r\n (val as Record<symbol, unknown>)[sym],\r\n depth + 1\r\n )\r\n }\r\n }\r\n\r\n return result as U\r\n }\r\n\r\n // 其他对象类型(如自定义类实例)直接返回\r\n return val\r\n }\r\n\r\n return cloneInternal(value, 0)\r\n}\r\n\r\n/**\r\n * 浅拷贝\r\n *\r\n * @template T - 值类型\r\n * @param value - 要拷贝的值\r\n * @returns 拷贝后的值\r\n *\r\n * @example\r\n * ```typescript\r\n * const arr = [1, 2, { a: 3 }]\r\n * const cloned = shallowClone(arr)\r\n * cloned[2].a = 4\r\n * console.log(arr[2].a) // 4 (浅拷贝,嵌套对象共享引用)\r\n * ```\r\n */\r\nexport function shallowClone<T>(value: T): T {\r\n if (value === null || value === undefined) return value\r\n if (typeof value !== 'object') return value\r\n\r\n if (Array.isArray(value)) {\r\n return [...value] as T\r\n }\r\n\r\n if (value instanceof Map) {\r\n return new Map(value) as T\r\n }\r\n\r\n if (value instanceof Set) {\r\n return new Set(value) as T\r\n }\r\n\r\n if (value instanceof Date) {\r\n return new Date(value.getTime()) as T\r\n }\r\n\r\n return { ...value }\r\n}\r\n\r\n/**\r\n * 深度合并配置选项\r\n */\r\nexport interface DeepMergeOptions {\r\n /** 数组合并策略:'replace' 替换 | 'concat' 连接 | 'merge' 按索引合并 */\r\n arrayStrategy?: 'replace' | 'concat' | 'merge'\r\n /** 是否克隆源对象(默认 true) */\r\n clone?: boolean\r\n /** 最大深度 */\r\n maxDepth?: number\r\n}\r\n\r\n/**\r\n * 深度合并对象\r\n *\r\n * 将多个源对象深度合并到目标对象\r\n *\r\n * @template T - 目标对象类型\r\n * @param target - 目标对象\r\n * @param sources - 源对象列表\r\n * @returns 合并后的对象\r\n *\r\n * @example\r\n * ```typescript\r\n * const target = { a: 1, b: { c: 2 } }\r\n * const source = { b: { d: 3 }, e: 4 }\r\n * const result = deepMerge(target, source)\r\n * // { a: 1, b: { c: 2, d: 3 }, e: 4 }\r\n * ```\r\n */\r\nexport function deepMerge<T extends Record<string, unknown>>(\r\n target: T,\r\n ...sources: Array<Partial<T>>\r\n): T {\r\n return deepMergeWithOptions(target, {}, ...sources)\r\n}\r\n\r\n/**\r\n * 带配置的深度合并\r\n *\r\n * @template T - 目标对象类型\r\n * @param target - 目标对象\r\n * @param options - 合并配置\r\n * @param sources - 源对象列表\r\n * @returns 合并后的对象\r\n */\r\nexport function deepMergeWithOptions<T extends Record<string, unknown>>(\r\n target: T,\r\n options: DeepMergeOptions,\r\n ...sources: Array<Partial<T>>\r\n): T {\r\n const {\r\n arrayStrategy = 'replace',\r\n clone = true,\r\n maxDepth = Infinity,\r\n } = options\r\n\r\n function mergeInternal(\r\n targetObj: Record<string, unknown>,\r\n sourceObj: Record<string, unknown>,\r\n depth: number\r\n ): Record<string, unknown> {\r\n if (depth > maxDepth) {\r\n return targetObj\r\n }\r\n\r\n for (const key of Object.keys(sourceObj)) {\r\n const sourceValue = sourceObj[key]\r\n const targetValue = targetObj[key]\r\n\r\n // 处理数组\r\n if (Array.isArray(sourceValue)) {\r\n if (arrayStrategy === 'concat' && Array.isArray(targetValue)) {\r\n targetObj[key] = [...targetValue, ...sourceValue]\r\n } else if (arrayStrategy === 'merge' && Array.isArray(targetValue)) {\r\n const result = [...targetValue]\r\n sourceValue.forEach((item, index) => {\r\n if (isPlainObject(item) && isPlainObject(result[index])) {\r\n result[index] = mergeInternal(\r\n result[index] as Record<string, unknown>,\r\n item,\r\n depth + 1\r\n )\r\n } else {\r\n result[index] = clone ? deepClone(item) : item\r\n }\r\n })\r\n targetObj[key] = result\r\n } else {\r\n targetObj[key] = clone ? deepClone(sourceValue) : sourceValue\r\n }\r\n }\r\n // 处理普通对象\r\n else if (isPlainObject(sourceValue)) {\r\n if (isPlainObject(targetValue)) {\r\n targetObj[key] = mergeInternal(\r\n targetValue as Record<string, unknown>,\r\n sourceValue,\r\n depth + 1\r\n )\r\n } else {\r\n targetObj[key] = clone ? deepClone(sourceValue) : sourceValue\r\n }\r\n }\r\n // 其他类型直接赋值\r\n else {\r\n targetObj[key] =\r\n clone && isObject(sourceValue) ? deepClone(sourceValue) : sourceValue\r\n }\r\n }\r\n\r\n return targetObj\r\n }\r\n\r\n let result = target\r\n\r\n for (const source of sources) {\r\n if (source !== null && source !== undefined) {\r\n result = mergeInternal(result, source, 0) as T\r\n }\r\n }\r\n\r\n return result\r\n}\r\n\r\n/**\r\n * 比较两个值是否深度相等\r\n *\r\n * @param a - 第一个值\r\n * @param b - 第二个值\r\n * @returns 是否相等\r\n *\r\n * @example\r\n * ```typescript\r\n * deepEqual({ a: 1 }, { a: 1 }) // true\r\n * deepEqual([1, 2], [1, 2]) // true\r\n * deepEqual({ a: { b: 1 } }, { a: { b: 2 } }) // false\r\n * ```\r\n */\r\nexport function deepEqual(a: unknown, b: unknown): boolean {\r\n // 严格相等\r\n if (a === b) return true\r\n\r\n // null/undefined 检查\r\n if (a === null || b === null || a === undefined || b === undefined) {\r\n return a === b\r\n }\r\n\r\n // 类型不同\r\n if (typeof a !== typeof b) return false\r\n\r\n // 基础类型\r\n if (typeof a !== 'object') return a === b\r\n\r\n // 日期比较\r\n if (a instanceof Date && b instanceof Date) {\r\n return a.getTime() === b.getTime()\r\n }\r\n\r\n // 正则比较\r\n if (a instanceof RegExp && b instanceof RegExp) {\r\n return a.source === b.source && a.flags === b.flags\r\n }\r\n\r\n // Map 比较\r\n if (a instanceof Map && b instanceof Map) {\r\n if (a.size !== b.size) return false\r\n for (const [key, value] of a) {\r\n if (!b.has(key) || !deepEqual(value, b.get(key))) {\r\n return false\r\n }\r\n }\r\n return true\r\n }\r\n\r\n // Set 比较\r\n if (a instanceof Set && b instanceof Set) {\r\n if (a.size !== b.size) return false\r\n for (const value of a) {\r\n if (!b.has(value)) return false\r\n }\r\n return true\r\n }\r\n\r\n // 数组比较\r\n if (Array.isArray(a) && Array.isArray(b)) {\r\n if (a.length !== b.length) return false\r\n for (let i = 0; i < a.length; i++) {\r\n if (!deepEqual(a[i], b[i])) return false\r\n }\r\n return true\r\n }\r\n\r\n // 对象比较\r\n if (isPlainObject(a) && isPlainObject(b)) {\r\n const keysA = Object.keys(a)\r\n const keysB = Object.keys(b)\r\n if (keysA.length !== keysB.length) return false\r\n for (const key of keysA) {\r\n if (!hasOwnKey(b, key)) return false\r\n if (!deepEqual(a[key], b[key])) return false\r\n }\r\n return true\r\n }\r\n\r\n return false\r\n}\r\n\r\n/**\r\n * 冻结对象(深度)\r\n *\r\n * @template T - 对象类型\r\n * @param obj - 要冻结的对象\r\n * @returns 冻结后的对象\r\n */\r\nexport function deepFreeze<T extends object>(obj: T): Readonly<T> {\r\n const propNames = Object.getOwnPropertyNames(obj)\r\n\r\n for (const name of propNames) {\r\n const value = (obj as Record<string, unknown>)[name]\r\n if (value && typeof value === 'object') {\r\n deepFreeze(value)\r\n }\r\n }\r\n\r\n return Object.freeze(obj)\r\n}\r\n"],"mappings":"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"}
@@ -2,7 +2,7 @@
2
2
  * ***********************************
3
3
  * @composy/store-core v0.0.1 *
4
4
  * Built with rollup *
5
- * Build time: 2024-08-17 11:27:33 *
5
+ * Build time: 2024-10-12 17:23:58 *
6
6
  * Build mode: production *
7
7
  * Minified: No *
8
8
  * ***********************************
@@ -1 +1 @@
1
- {"version":3,"file":"selector.js","names":[],"sources":["../../src/utils/selector.ts"],"sourcesContent":["/**\n * 状态选择器工具\n *\n * 提供高性能的状态选择器和路径操作工具\n * @module utils/selector\n */\n\nimport type { Selector, StateTree } from '../types'\n\nconst ARRAY_INDEX_RE = /^\\d+$/\n\n/**\n * 选择器相等性比较函数类型\n */\nexport type SelectorEqualityFn<R> = (a: R, b: R) => boolean\n\n/**\n * 记忆化选择器配置选项\n */\nexport interface MemoizedSelectorOptions<R> {\n /** 相等性比较函数 */\n equalityFn?: SelectorEqualityFn<R>\n /** 最大缓存大小(默认 1) */\n maxSize?: number\n /** 是否在开发模式下记录缓存命中率 */\n trackHitRate?: boolean\n}\n\n/**\n * 创建记忆化选择器\n *\n * 基本的记忆化选择器,只缓存最后一次结果\n *\n * @template S - 状态类型\n * @template R - 返回值类型\n * @param selector - 选择器函数\n * @param equalityFn - 相等性比较函数(默认使用 Object.is)\n * @returns 记忆化的选择器\n *\n * @example\n * ```typescript\n * const selectTodos = createSelector(\n * (state: AppState) => state.todos,\n * )\n *\n * const selectCompletedTodos = createSelector(\n * (state: AppState) => state.todos.filter(t => t.completed),\n * (a, b) => a.length === b.length && a.every((v, i) => v === b[i])\n * )\n * ```\n */\nexport function createSelector<S extends StateTree, R>(\n selector: Selector<S, R>,\n equalityFn: SelectorEqualityFn<R> = Object.is\n): Selector<S, R> {\n let lastState: S | undefined\n let lastResult: R | undefined\n let initialized = false\n\n return (state: S): R => {\n // 如果状态引用未变,直接返回缓存结果\n if (initialized && lastState === state) {\n return lastResult as R\n }\n\n const result = selector(state)\n\n // 检查结果是否改变\n if (!initialized || !equalityFn(result, lastResult as R)) {\n lastResult = result\n }\n\n lastState = state\n initialized = true\n\n return lastResult as R\n }\n}\n\n/**\n * 创建带依赖的选择器\n *\n * 类似 reselect 的实现,支持多个输入选择器\n *\n * @template S - 状态类型\n * @template Deps - 依赖结果类型\n * @template R - 返回值类型\n * @param dependencies - 依赖选择器数组\n * @param combiner - 组合函数\n * @param options - 配置选项\n * @returns 记忆化的选择器\n *\n * @example\n * ```typescript\n * const selectVisibleTodos = createSelectorWithDeps(\n * [\n * (state) => state.todos,\n * (state) => state.visibilityFilter,\n * ],\n * (todos, filter) => {\n * switch (filter) {\n * case 'SHOW_COMPLETED': return todos.filter(t => t.completed)\n * case 'SHOW_ACTIVE': return todos.filter(t => !t.completed)\n * default: return todos\n * }\n * }\n * )\n * ```\n */\nexport function createSelectorWithDeps<\n S extends StateTree,\n Deps extends unknown[],\n R,\n>(\n dependencies: { [K in keyof Deps]: Selector<S, Deps[K]> },\n combiner: (...args: Deps) => R,\n options: MemoizedSelectorOptions<R> = {}\n): Selector<S, R> {\n const { equalityFn = Object.is, trackHitRate = false } = options\n\n let lastDeps: Deps | undefined\n let lastResult: R | undefined\n let initialized = false\n\n // 缓存统计(仅开发模式)\n let hits = 0\n let calls = 0\n\n const selector = (state: S): R => {\n if (trackHitRate) calls++\n\n // 计算所有依赖的结果\n const deps = dependencies.map(dep => dep(state)) as Deps\n\n // 检查依赖是否改变\n if (initialized && lastDeps) {\n let changed = false\n for (let i = 0; i < deps.length; i++) {\n if (!Object.is(deps[i], lastDeps[i])) {\n changed = true\n break\n }\n }\n\n if (!changed) {\n if (trackHitRate) hits++\n return lastResult as R\n }\n }\n\n // 计算新结果\n const result = combiner(...deps)\n\n // 检查结果是否改变\n if (!initialized || !equalityFn(result, lastResult as R)) {\n lastResult = result\n }\n\n lastDeps = deps\n initialized = true\n\n return lastResult as R\n }\n\n // 添加缓存统计方法\n if (trackHitRate) {\n ;(selector as Selector<S, R> & { getHitRate: () => number }).getHitRate =\n () => {\n return calls > 0 ? hits / calls : 0\n }\n }\n\n return selector\n}\n\n/**\n * 组合多个选择器\n *\n * 简单的选择器组合,不带记忆化\n *\n * @template S - 状态类型\n * @template R - 结果类型数组\n * @template C - 组合结果类型\n * @param selectors - 选择器数组\n * @param combiner - 组合函数\n * @returns 组合后的选择器\n *\n * @example\n * ```typescript\n * const selectUserAndTodos = combineSelectors(\n * [\n * (state) => state.user,\n * (state) => state.todos,\n * ],\n * (user, todos) => ({ user, todos })\n * )\n * ```\n */\nexport function combineSelectors<S extends StateTree, R extends unknown[], C>(\n selectors: { [K in keyof R]: Selector<S, R[K]> },\n combiner: (...results: R) => C\n): Selector<S, C> {\n return (state: S): C => {\n const results = selectors.map(selector => selector(state)) as R\n return combiner(...results)\n }\n}\n\n/**\n * 创建带高级缓存的选择器\n *\n * 支持多个缓存条目,使用 LRU 策略\n *\n * @template S - 状态类型\n * @template R - 返回值类型\n * @param selector - 选择器函数\n * @param options - 配置选项\n * @returns 带缓存的选择器\n *\n * @example\n * ```typescript\n * const selectFilteredItems = createCachedSelector(\n * (state, filter) => state.items.filter(item => item.type === filter),\n * { maxSize: 5 }\n * )\n * ```\n */\nexport function createCachedSelector<S extends StateTree, R>(\n selector: Selector<S, R>,\n options: MemoizedSelectorOptions<R> = {}\n): Selector<S, R> & { clearCache: () => void; getCacheSize: () => number } {\n const { maxSize = 10 } = options\n\n // 使用 Map 保持插入顺序(LRU 策略)\n const cache = new Map<S, R>()\n\n const memoizedSelector = (state: S): R => {\n // 检查缓存\n if (cache.has(state)) {\n const cached = cache.get(state) as R\n // 移到末尾(最近使用)\n cache.delete(state)\n cache.set(state, cached)\n return cached\n }\n\n // 计算结果\n const result = selector(state)\n\n // 管理缓存大小(LRU 淘汰)\n if (cache.size >= maxSize) {\n const firstKey = cache.keys().next().value\n if (firstKey !== undefined) {\n cache.delete(firstKey)\n }\n }\n\n cache.set(state, result)\n return result\n }\n\n // 添加缓存管理方法\n memoizedSelector.clearCache = () => cache.clear()\n memoizedSelector.getCacheSize = () => cache.size\n\n return memoizedSelector\n}\n\n/**\n * 创建记忆化选择器(别名,同 createSelector)\n *\n * @template S - 状态类型\n * @template R - 返回值类型\n * @param selector - 选择器函数\n * @param options - 配置选项\n * @returns 记忆化的选择器\n */\nexport function createMemoizedSelector<S extends StateTree, R>(\n selector: Selector<S, R>,\n options: MemoizedSelectorOptions<R> = {}\n): Selector<S, R> {\n return createSelector(selector, options.equalityFn)\n}\n\n/**\n * 获取嵌套对象的值\n *\n * 支持点表示法和数组索引\n *\n * @template T - 返回值类型\n * @param obj - 对象\n * @param path - 路径(支持 'a.b.c' 或 'a[0].b')\n * @param defaultValue - 默认值(当路径不存在时返回)\n * @returns 值\n *\n * @example\n * ```typescript\n * const value = getByPath({ a: { b: { c: 1 } } }, 'a.b.c')\n * // value: 1\n *\n * const arr = getByPath({ items: [{ name: 'test' }] }, 'items[0].name')\n * // arr: 'test'\n *\n * const missing = getByPath({ a: 1 }, 'b.c', 'default')\n * // missing: 'default'\n * ```\n */\nexport function getByPath<T = unknown>(\n obj: unknown,\n path: string,\n defaultValue?: T\n): T | undefined {\n if (!path || path.length === 0) {\n return obj as T\n }\n\n // 解析路径(支持 'a.b.c' 和 'a[0].b')\n const keys = path\n .replace(/\\[([^\\]]+)\\]/g, '.$1') // 将 [0] 转换为 .0\n .split('.')\n .filter(Boolean)\n\n let result: unknown = obj\n\n for (const key of keys) {\n if (result === null || result === undefined) {\n return defaultValue\n }\n\n if (typeof result !== 'object') {\n return defaultValue\n }\n\n result = (result as Record<string, unknown>)[key]\n }\n\n return result === undefined ? defaultValue : (result as T)\n}\n\n/**\n * 设置嵌套对象的值\n *\n * 支持自动创建中间路径\n *\n * @param obj - 对象\n * @param path - 路径\n * @param value - 值\n * @returns 是否成功\n *\n * @example\n * ```typescript\n * const obj = {}\n * setByPath(obj, 'a.b.c', 1)\n * // obj: { a: { b: { c: 1 } } }\n *\n * setByPath(obj, 'items[0].name', 'test')\n * // obj: { a: { b: { c: 1 } }, items: [{ name: 'test' }] }\n * ```\n */\nexport function setByPath(\n obj: Record<string, unknown>,\n path: string,\n value: unknown\n): boolean {\n if (!path || path.length === 0) {\n return false\n }\n\n // 解析路径\n const keys = path\n .replace(/\\[([^\\]]+)\\]/g, '.$1')\n .split('.')\n .filter(Boolean)\n\n let current: Record<string, unknown> = obj\n\n for (let i = 0; i < keys.length - 1; i++) {\n const key = keys[i]\n const nextKey = keys[i + 1] ?? ''\n\n const nextValue = current[key] ?? (ARRAY_INDEX_RE.test(nextKey) ? [] : {})\n // 根据下一个键决定创建对象还是数组\n current[key] = nextValue\n current = current[key] as Record<string, unknown>\n }\n\n const lastKey = keys[keys.length - 1]\n current[lastKey] = value\n return true\n}\n\n/**\n * 删除嵌套对象的值\n *\n * @param obj - 对象\n * @param path - 路径\n * @returns 是否成功删除\n *\n * @example\n * ```typescript\n * const obj = { a: { b: { c: 1 } } }\n * deleteByPath(obj, 'a.b.c')\n * // obj: { a: { b: {} } }\n * ```\n */\nexport function deleteByPath(\n obj: Record<string, unknown>,\n path: string\n): boolean {\n if (!path || path.length === 0) {\n return false\n }\n\n const keys = path\n .replace(/\\[([^\\]]+)\\]/g, '.$1')\n .split('.')\n .filter(Boolean)\n\n let current: Record<string, unknown> = obj\n\n for (let i = 0; i < keys.length - 1; i++) {\n const key = keys[i]\n if (current[key] === undefined || current[key] === null) {\n return false\n }\n current = current[key] as Record<string, unknown>\n }\n\n const lastKey = keys[keys.length - 1]\n if (lastKey in current) {\n if (Array.isArray(current)) {\n const index = Number.parseInt(lastKey, 10)\n if (!Number.isNaN(index)) {\n current.splice(index, 1)\n return true\n }\n }\n delete current[lastKey]\n return true\n }\n\n return false\n}\n\n/**\n * 检查嵌套对象中是否存在指定路径\n *\n * @param obj - 对象\n * @param path - 路径\n * @returns 是否存在\n *\n * @example\n * ```typescript\n * hasPath({ a: { b: 1 } }, 'a.b') // true\n * hasPath({ a: { b: 1 } }, 'a.c') // false\n * ```\n */\nexport function hasPath(obj: unknown, path: string): boolean {\n if (!path || path.length === 0) {\n return true\n }\n\n const keys = path\n .replace(/\\[([^\\]]+)\\]/g, '.$1')\n .split('.')\n .filter(Boolean)\n\n let current: unknown = obj\n\n for (const key of keys) {\n if (current === null || current === undefined) {\n return false\n }\n\n if (typeof current !== 'object') {\n return false\n }\n\n if (!(key in (current as Record<string, unknown>))) {\n return false\n }\n\n current = (current as Record<string, unknown>)[key]\n }\n\n return true\n}\n"],"mappings":";;;;;;;;;;AASA,MAAM,iBAAiB;AA0ChB,SAAS,eACd,UACA,aAAoC,OAAO,IAC3B;CAChB,IAAI;CACJ,IAAI;CACJ,IAAI,cAAc;CAElB,QAAQ,UAAgB;EAEtB,IAAI,eAAe,cAAc,OAC/B,OAAO;EAGT,MAAM,SAAS,SAAS,KAAK;EAG7B,IAAI,CAAC,eAAe,CAAC,WAAW,QAAQ,UAAe,GACrD,aAAa;EAGf,YAAY;EACZ,cAAc;EAEd,OAAO;CACT;AACF;AAgCO,SAAS,uBAKd,cACA,UACA,UAAsC,CAAC,GACvB;CAChB,MAAM,EAAE,aAAa,OAAO,IAAI,eAAe,UAAU;CAEzD,IAAI;CACJ,IAAI;CACJ,IAAI,cAAc;CAGlB,IAAI,OAAO;CACX,IAAI,QAAQ;CAEZ,MAAM,YAAY,UAAgB;EAChC,IAAI,cAAc;EAGlB,MAAM,OAAO,aAAa,KAAI,QAAO,IAAI,KAAK,CAAC;EAG/C,IAAI,eAAe,UAAU;GAC3B,IAAI,UAAU;GACd,KAAA,IAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,IAAI,SAAS,EAAE,GAAG;IACpC,UAAU;IACV;GACF;GAGF,IAAI,CAAC,SAAS;IACZ,IAAI,cAAc;IAClB,OAAO;GACT;EACF;EAGA,MAAM,SAAS,SAAS,GAAG,IAAI;EAG/B,IAAI,CAAC,eAAe,CAAC,WAAW,QAAQ,UAAe,GACrD,aAAa;EAGf,WAAW;EACX,cAAc;EAEd,OAAO;CACT;CAGA,IAAI,cACA,SAA2D,mBACrD;EACJ,OAAO,QAAQ,IAAI,OAAO,QAAQ;CACpC;CAGJ,OAAO;AACT;AAyBO,SAAS,iBACd,WACA,UACgB;CAChB,QAAQ,UAAgB;EAEtB,OAAO,SAAS,GADA,UAAU,KAAI,aAAY,SAAS,KAAK,CACrC,CAAO;CAC5B;AACF;AAqBO,SAAS,qBACd,UACA,UAAsC,CAAC,GACkC;CACzE,MAAM,EAAE,UAAU,OAAO;CAGzB,MAAM,wBAAQ,IAAI,IAAU;CAE5B,MAAM,oBAAoB,UAAgB;EAExC,IAAI,MAAM,IAAI,KAAK,GAAG;GACpB,MAAM,SAAS,MAAM,IAAI,KAAK;GAE9B,MAAM,OAAO,KAAK;GAClB,MAAM,IAAI,OAAO,MAAM;GACvB,OAAO;EACT;EAGA,MAAM,SAAS,SAAS,KAAK;EAG7B,IAAI,MAAM,QAAQ,SAAS;GACzB,MAAM,WAAW,MAAM,KAAK,CAAA,CAAE,KAAK,CAAA,CAAE;GACrC,IAAI,aAAa,KAAA,GACf,MAAM,OAAO,QAAQ;EAEzB;EAEA,MAAM,IAAI,OAAO,MAAM;EACvB,OAAO;CACT;CAGA,iBAAiB,mBAAmB,MAAM,MAAM;CAChD,iBAAiB,qBAAqB,MAAM;CAE5C,OAAO;AACT;AAWO,SAAS,uBACd,UACA,UAAsC,CAAC,GACvB;CAChB,OAAO,eAAe,UAAU,QAAQ,UAAU;AACpD;AAyBO,SAAS,UACd,KACA,MACA,cACe;CACf,IAAI,CAAC,QAAQ,KAAK,WAAW,GAC3B,OAAO;CAIT,MAAM,OAAO,KACV,QAAQ,iBAAiB,KAAK,CAAA,CAC9B,MAAM,GAAG,CAAA,CACT,OAAO,OAAO;CAEjB,IAAI,SAAkB;CAEtB,KAAA,MAAW,OAAO,MAAM;EACtB,IAAI,WAAW,QAAQ,WAAW,KAAA,GAChC,OAAO;EAGT,IAAI,OAAO,WAAW,UACpB,OAAO;EAGT,SAAU,OAAmC;CAC/C;CAEA,OAAO,WAAW,KAAA,IAAY,eAAgB;AAChD;AAsBO,SAAS,UACd,KACA,MACA,OACS;CACT,IAAI,CAAC,QAAQ,KAAK,WAAW,GAC3B,OAAO;CAIT,MAAM,OAAO,KACV,QAAQ,iBAAiB,KAAK,CAAA,CAC9B,MAAM,GAAG,CAAA,CACT,OAAO,OAAO;CAEjB,IAAI,UAAmC;CAEvC,KAAA,IAAS,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,MAAM,KAAK;EACjB,MAAM,UAAU,KAAK,IAAI,MAAM;EAE/B,MAAM,YAAY,QAAQ,SAAS,eAAe,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC;EAExE,QAAQ,OAAO;EACf,UAAU,QAAQ;CACpB;CAEA,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,QAAQ,WAAW;CACnB,OAAO;AACT;AAgBO,SAAS,aACd,KACA,MACS;CACT,IAAI,CAAC,QAAQ,KAAK,WAAW,GAC3B,OAAO;CAGT,MAAM,OAAO,KACV,QAAQ,iBAAiB,KAAK,CAAA,CAC9B,MAAM,GAAG,CAAA,CACT,OAAO,OAAO;CAEjB,IAAI,UAAmC;CAEvC,KAAA,IAAS,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,MAAM,KAAK;EACjB,IAAI,QAAQ,SAAS,KAAA,KAAa,QAAQ,SAAS,MACjD,OAAO;EAET,UAAU,QAAQ;CACpB;CAEA,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,IAAI,WAAW,SAAS;EACtB,IAAI,MAAM,QAAQ,OAAO,GAAG;GAC1B,MAAM,QAAQ,OAAO,SAAS,SAAS,EAAE;GACzC,IAAI,CAAC,OAAO,MAAM,KAAK,GAAG;IACxB,QAAQ,OAAO,OAAO,CAAC;IACvB,OAAO;GACT;EACF;EACA,OAAO,QAAQ;EACf,OAAO;CACT;CAEA,OAAO;AACT;AAeO,SAAS,QAAQ,KAAc,MAAuB;CAC3D,IAAI,CAAC,QAAQ,KAAK,WAAW,GAC3B,OAAO;CAGT,MAAM,OAAO,KACV,QAAQ,iBAAiB,KAAK,CAAA,CAC9B,MAAM,GAAG,CAAA,CACT,OAAO,OAAO;CAEjB,IAAI,UAAmB;CAEvB,KAAA,MAAW,OAAO,MAAM;EACtB,IAAI,YAAY,QAAQ,YAAY,KAAA,GAClC,OAAO;EAGT,IAAI,OAAO,YAAY,UACrB,OAAO;EAGT,IAAI,EAAE,OAAQ,UACZ,OAAO;EAGT,UAAW,QAAoC;CACjD;CAEA,OAAO;AACT"}
1
+ {"version":3,"file":"selector.js","names":[],"sources":["../../src/utils/selector.ts"],"sourcesContent":["/**\r\n * 状态选择器工具\r\n *\r\n * 提供高性能的状态选择器和路径操作工具\r\n * @module utils/selector\r\n */\r\n\r\nimport type { Selector, StateTree } from '../types'\r\n\r\nconst ARRAY_INDEX_RE = /^\\d+$/\r\n\r\n/**\r\n * 选择器相等性比较函数类型\r\n */\r\nexport type SelectorEqualityFn<R> = (a: R, b: R) => boolean\r\n\r\n/**\r\n * 记忆化选择器配置选项\r\n */\r\nexport interface MemoizedSelectorOptions<R> {\r\n /** 相等性比较函数 */\r\n equalityFn?: SelectorEqualityFn<R>\r\n /** 最大缓存大小(默认 1) */\r\n maxSize?: number\r\n /** 是否在开发模式下记录缓存命中率 */\r\n trackHitRate?: boolean\r\n}\r\n\r\n/**\r\n * 创建记忆化选择器\r\n *\r\n * 基本的记忆化选择器,只缓存最后一次结果\r\n *\r\n * @template S - 状态类型\r\n * @template R - 返回值类型\r\n * @param selector - 选择器函数\r\n * @param equalityFn - 相等性比较函数(默认使用 Object.is)\r\n * @returns 记忆化的选择器\r\n *\r\n * @example\r\n * ```typescript\r\n * const selectTodos = createSelector(\r\n * (state: AppState) => state.todos,\r\n * )\r\n *\r\n * const selectCompletedTodos = createSelector(\r\n * (state: AppState) => state.todos.filter(t => t.completed),\r\n * (a, b) => a.length === b.length && a.every((v, i) => v === b[i])\r\n * )\r\n * ```\r\n */\r\nexport function createSelector<S extends StateTree, R>(\r\n selector: Selector<S, R>,\r\n equalityFn: SelectorEqualityFn<R> = Object.is\r\n): Selector<S, R> {\r\n let lastState: S | undefined\r\n let lastResult: R | undefined\r\n let initialized = false\r\n\r\n return (state: S): R => {\r\n // 如果状态引用未变,直接返回缓存结果\r\n if (initialized && lastState === state) {\r\n return lastResult as R\r\n }\r\n\r\n const result = selector(state)\r\n\r\n // 检查结果是否改变\r\n if (!initialized || !equalityFn(result, lastResult as R)) {\r\n lastResult = result\r\n }\r\n\r\n lastState = state\r\n initialized = true\r\n\r\n return lastResult as R\r\n }\r\n}\r\n\r\n/**\r\n * 创建带依赖的选择器\r\n *\r\n * 类似 reselect 的实现,支持多个输入选择器\r\n *\r\n * @template S - 状态类型\r\n * @template Deps - 依赖结果类型\r\n * @template R - 返回值类型\r\n * @param dependencies - 依赖选择器数组\r\n * @param combiner - 组合函数\r\n * @param options - 配置选项\r\n * @returns 记忆化的选择器\r\n *\r\n * @example\r\n * ```typescript\r\n * const selectVisibleTodos = createSelectorWithDeps(\r\n * [\r\n * (state) => state.todos,\r\n * (state) => state.visibilityFilter,\r\n * ],\r\n * (todos, filter) => {\r\n * switch (filter) {\r\n * case 'SHOW_COMPLETED': return todos.filter(t => t.completed)\r\n * case 'SHOW_ACTIVE': return todos.filter(t => !t.completed)\r\n * default: return todos\r\n * }\r\n * }\r\n * )\r\n * ```\r\n */\r\nexport function createSelectorWithDeps<\r\n S extends StateTree,\r\n Deps extends unknown[],\r\n R,\r\n>(\r\n dependencies: { [K in keyof Deps]: Selector<S, Deps[K]> },\r\n combiner: (...args: Deps) => R,\r\n options: MemoizedSelectorOptions<R> = {}\r\n): Selector<S, R> {\r\n const { equalityFn = Object.is, trackHitRate = false } = options\r\n\r\n let lastDeps: Deps | undefined\r\n let lastResult: R | undefined\r\n let initialized = false\r\n\r\n // 缓存统计(仅开发模式)\r\n let hits = 0\r\n let calls = 0\r\n\r\n const selector = (state: S): R => {\r\n if (trackHitRate) calls++\r\n\r\n // 计算所有依赖的结果\r\n const deps = dependencies.map(dep => dep(state)) as Deps\r\n\r\n // 检查依赖是否改变\r\n if (initialized && lastDeps) {\r\n let changed = false\r\n for (let i = 0; i < deps.length; i++) {\r\n if (!Object.is(deps[i], lastDeps[i])) {\r\n changed = true\r\n break\r\n }\r\n }\r\n\r\n if (!changed) {\r\n if (trackHitRate) hits++\r\n return lastResult as R\r\n }\r\n }\r\n\r\n // 计算新结果\r\n const result = combiner(...deps)\r\n\r\n // 检查结果是否改变\r\n if (!initialized || !equalityFn(result, lastResult as R)) {\r\n lastResult = result\r\n }\r\n\r\n lastDeps = deps\r\n initialized = true\r\n\r\n return lastResult as R\r\n }\r\n\r\n // 添加缓存统计方法\r\n if (trackHitRate) {\r\n ;(selector as Selector<S, R> & { getHitRate: () => number }).getHitRate =\r\n () => {\r\n return calls > 0 ? hits / calls : 0\r\n }\r\n }\r\n\r\n return selector\r\n}\r\n\r\n/**\r\n * 组合多个选择器\r\n *\r\n * 简单的选择器组合,不带记忆化\r\n *\r\n * @template S - 状态类型\r\n * @template R - 结果类型数组\r\n * @template C - 组合结果类型\r\n * @param selectors - 选择器数组\r\n * @param combiner - 组合函数\r\n * @returns 组合后的选择器\r\n *\r\n * @example\r\n * ```typescript\r\n * const selectUserAndTodos = combineSelectors(\r\n * [\r\n * (state) => state.user,\r\n * (state) => state.todos,\r\n * ],\r\n * (user, todos) => ({ user, todos })\r\n * )\r\n * ```\r\n */\r\nexport function combineSelectors<S extends StateTree, R extends unknown[], C>(\r\n selectors: { [K in keyof R]: Selector<S, R[K]> },\r\n combiner: (...results: R) => C\r\n): Selector<S, C> {\r\n return (state: S): C => {\r\n const results = selectors.map(selector => selector(state)) as R\r\n return combiner(...results)\r\n }\r\n}\r\n\r\n/**\r\n * 创建带高级缓存的选择器\r\n *\r\n * 支持多个缓存条目,使用 LRU 策略\r\n *\r\n * @template S - 状态类型\r\n * @template R - 返回值类型\r\n * @param selector - 选择器函数\r\n * @param options - 配置选项\r\n * @returns 带缓存的选择器\r\n *\r\n * @example\r\n * ```typescript\r\n * const selectFilteredItems = createCachedSelector(\r\n * (state, filter) => state.items.filter(item => item.type === filter),\r\n * { maxSize: 5 }\r\n * )\r\n * ```\r\n */\r\nexport function createCachedSelector<S extends StateTree, R>(\r\n selector: Selector<S, R>,\r\n options: MemoizedSelectorOptions<R> = {}\r\n): Selector<S, R> & { clearCache: () => void; getCacheSize: () => number } {\r\n const { maxSize = 10 } = options\r\n\r\n // 使用 Map 保持插入顺序(LRU 策略)\r\n const cache = new Map<S, R>()\r\n\r\n const memoizedSelector = (state: S): R => {\r\n // 检查缓存\r\n if (cache.has(state)) {\r\n const cached = cache.get(state) as R\r\n // 移到末尾(最近使用)\r\n cache.delete(state)\r\n cache.set(state, cached)\r\n return cached\r\n }\r\n\r\n // 计算结果\r\n const result = selector(state)\r\n\r\n // 管理缓存大小(LRU 淘汰)\r\n if (cache.size >= maxSize) {\r\n const firstKey = cache.keys().next().value\r\n if (firstKey !== undefined) {\r\n cache.delete(firstKey)\r\n }\r\n }\r\n\r\n cache.set(state, result)\r\n return result\r\n }\r\n\r\n // 添加缓存管理方法\r\n memoizedSelector.clearCache = () => cache.clear()\r\n memoizedSelector.getCacheSize = () => cache.size\r\n\r\n return memoizedSelector\r\n}\r\n\r\n/**\r\n * 创建记忆化选择器(别名,同 createSelector)\r\n *\r\n * @template S - 状态类型\r\n * @template R - 返回值类型\r\n * @param selector - 选择器函数\r\n * @param options - 配置选项\r\n * @returns 记忆化的选择器\r\n */\r\nexport function createMemoizedSelector<S extends StateTree, R>(\r\n selector: Selector<S, R>,\r\n options: MemoizedSelectorOptions<R> = {}\r\n): Selector<S, R> {\r\n return createSelector(selector, options.equalityFn)\r\n}\r\n\r\n/**\r\n * 获取嵌套对象的值\r\n *\r\n * 支持点表示法和数组索引\r\n *\r\n * @template T - 返回值类型\r\n * @param obj - 对象\r\n * @param path - 路径(支持 'a.b.c' 或 'a[0].b')\r\n * @param defaultValue - 默认值(当路径不存在时返回)\r\n * @returns 值\r\n *\r\n * @example\r\n * ```typescript\r\n * const value = getByPath({ a: { b: { c: 1 } } }, 'a.b.c')\r\n * // value: 1\r\n *\r\n * const arr = getByPath({ items: [{ name: 'test' }] }, 'items[0].name')\r\n * // arr: 'test'\r\n *\r\n * const missing = getByPath({ a: 1 }, 'b.c', 'default')\r\n * // missing: 'default'\r\n * ```\r\n */\r\nexport function getByPath<T = unknown>(\r\n obj: unknown,\r\n path: string,\r\n defaultValue?: T\r\n): T | undefined {\r\n if (!path || path.length === 0) {\r\n return obj as T\r\n }\r\n\r\n // 解析路径(支持 'a.b.c' 和 'a[0].b')\r\n const keys = path\r\n .replace(/\\[([^\\]]+)\\]/g, '.$1') // 将 [0] 转换为 .0\r\n .split('.')\r\n .filter(Boolean)\r\n\r\n let result: unknown = obj\r\n\r\n for (const key of keys) {\r\n if (result === null || result === undefined) {\r\n return defaultValue\r\n }\r\n\r\n if (typeof result !== 'object') {\r\n return defaultValue\r\n }\r\n\r\n result = (result as Record<string, unknown>)[key]\r\n }\r\n\r\n return result === undefined ? defaultValue : (result as T)\r\n}\r\n\r\n/**\r\n * 设置嵌套对象的值\r\n *\r\n * 支持自动创建中间路径\r\n *\r\n * @param obj - 对象\r\n * @param path - 路径\r\n * @param value - 值\r\n * @returns 是否成功\r\n *\r\n * @example\r\n * ```typescript\r\n * const obj = {}\r\n * setByPath(obj, 'a.b.c', 1)\r\n * // obj: { a: { b: { c: 1 } } }\r\n *\r\n * setByPath(obj, 'items[0].name', 'test')\r\n * // obj: { a: { b: { c: 1 } }, items: [{ name: 'test' }] }\r\n * ```\r\n */\r\nexport function setByPath(\r\n obj: Record<string, unknown>,\r\n path: string,\r\n value: unknown\r\n): boolean {\r\n if (!path || path.length === 0) {\r\n return false\r\n }\r\n\r\n // 解析路径\r\n const keys = path\r\n .replace(/\\[([^\\]]+)\\]/g, '.$1')\r\n .split('.')\r\n .filter(Boolean)\r\n\r\n let current: Record<string, unknown> = obj\r\n\r\n for (let i = 0; i < keys.length - 1; i++) {\r\n const key = keys[i]\r\n const nextKey = keys[i + 1] ?? ''\r\n\r\n const nextValue = current[key] ?? (ARRAY_INDEX_RE.test(nextKey) ? [] : {})\r\n // 根据下一个键决定创建对象还是数组\r\n current[key] = nextValue\r\n current = current[key] as Record<string, unknown>\r\n }\r\n\r\n const lastKey = keys[keys.length - 1]\r\n current[lastKey] = value\r\n return true\r\n}\r\n\r\n/**\r\n * 删除嵌套对象的值\r\n *\r\n * @param obj - 对象\r\n * @param path - 路径\r\n * @returns 是否成功删除\r\n *\r\n * @example\r\n * ```typescript\r\n * const obj = { a: { b: { c: 1 } } }\r\n * deleteByPath(obj, 'a.b.c')\r\n * // obj: { a: { b: {} } }\r\n * ```\r\n */\r\nexport function deleteByPath(\r\n obj: Record<string, unknown>,\r\n path: string\r\n): boolean {\r\n if (!path || path.length === 0) {\r\n return false\r\n }\r\n\r\n const keys = path\r\n .replace(/\\[([^\\]]+)\\]/g, '.$1')\r\n .split('.')\r\n .filter(Boolean)\r\n\r\n let current: Record<string, unknown> = obj\r\n\r\n for (let i = 0; i < keys.length - 1; i++) {\r\n const key = keys[i]\r\n if (current[key] === undefined || current[key] === null) {\r\n return false\r\n }\r\n current = current[key] as Record<string, unknown>\r\n }\r\n\r\n const lastKey = keys[keys.length - 1]\r\n if (lastKey in current) {\r\n if (Array.isArray(current)) {\r\n const index = Number.parseInt(lastKey, 10)\r\n if (!Number.isNaN(index)) {\r\n current.splice(index, 1)\r\n return true\r\n }\r\n }\r\n delete current[lastKey]\r\n return true\r\n }\r\n\r\n return false\r\n}\r\n\r\n/**\r\n * 检查嵌套对象中是否存在指定路径\r\n *\r\n * @param obj - 对象\r\n * @param path - 路径\r\n * @returns 是否存在\r\n *\r\n * @example\r\n * ```typescript\r\n * hasPath({ a: { b: 1 } }, 'a.b') // true\r\n * hasPath({ a: { b: 1 } }, 'a.c') // false\r\n * ```\r\n */\r\nexport function hasPath(obj: unknown, path: string): boolean {\r\n if (!path || path.length === 0) {\r\n return true\r\n }\r\n\r\n const keys = path\r\n .replace(/\\[([^\\]]+)\\]/g, '.$1')\r\n .split('.')\r\n .filter(Boolean)\r\n\r\n let current: unknown = obj\r\n\r\n for (const key of keys) {\r\n if (current === null || current === undefined) {\r\n return false\r\n }\r\n\r\n if (typeof current !== 'object') {\r\n return false\r\n }\r\n\r\n if (!(key in (current as Record<string, unknown>))) {\r\n return false\r\n }\r\n\r\n current = (current as Record<string, unknown>)[key]\r\n }\r\n\r\n return true\r\n}\r\n"],"mappings":"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"}
@@ -2,7 +2,7 @@
2
2
  * ***********************************
3
3
  * @composy/store-core v0.0.1 *
4
4
  * Built with rollup *
5
- * Build time: 2024-08-17 11:27:33 *
5
+ * Build time: 2024-10-12 17:23:58 *
6
6
  * Build mode: production *
7
7
  * Minified: No *
8
8
  * ***********************************
@@ -11,8 +11,24 @@
11
11
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
12
12
  const require_pub_sub = require("./pub-sub.cjs");
13
13
  //#region src/core/async-action.ts
14
- function delay(ms) {
15
- return new Promise((resolve) => setTimeout(resolve, ms));
14
+ function abortError() {
15
+ return /* @__PURE__ */ new Error("Aborted");
16
+ }
17
+ function delay(ms, signal) {
18
+ if (signal.aborted) return Promise.reject(abortError());
19
+ return new Promise((resolve, reject) => {
20
+ let timer;
21
+ const onAbort = () => {
22
+ clearTimeout(timer);
23
+ signal.removeEventListener("abort", onAbort);
24
+ reject(abortError());
25
+ };
26
+ timer = setTimeout(() => {
27
+ signal.removeEventListener("abort", onAbort);
28
+ resolve();
29
+ }, ms);
30
+ signal.addEventListener("abort", onAbort, { once: true });
31
+ });
16
32
  }
17
33
  function createAsyncAction(fn, options = {}) {
18
34
  const { retryCount = 0, retryDelay = 1e3, timeout = 0, resetOnExecute = true } = options;
@@ -26,39 +42,64 @@ function createAsyncAction(fn, options = {}) {
26
42
  const statePubSub = require_pub_sub.createPubSub();
27
43
  const successPubSub = require_pub_sub.createPubSub();
28
44
  const errorPubSub = require_pub_sub.createPubSub();
29
- let abortController = null;
30
- const notify = () => {
31
- statePubSub.publish({ ..._state });
32
- };
33
- const executeWithRetry = async (args, retriesLeft) => {
45
+ let nextExecutionId = 0;
46
+ let activeExecution = null;
47
+ const notify = () => statePubSub.publish({ ..._state });
48
+ const invoke = fn;
49
+ const executeWithRetry = async (args, retriesLeft, execution) => {
50
+ if (execution.controller.signal.aborted) throw execution.abortReason ?? abortError();
34
51
  try {
35
- return await fn(...args);
52
+ const result = await invoke(...args, execution.controller.signal);
53
+ if (execution.controller.signal.aborted) throw execution.abortReason ?? abortError();
54
+ return result;
36
55
  } catch (error) {
37
- if (retriesLeft > 0 && !abortController?.signal.aborted) {
38
- await delay(retryDelay);
39
- if (abortController?.signal.aborted) throw new Error("Aborted");
40
- return executeWithRetry(args, retriesLeft - 1);
41
- }
42
- throw error;
56
+ if (execution.controller.signal.aborted) throw execution.abortReason ?? abortError();
57
+ if (retriesLeft <= 0) throw error;
58
+ await delay(retryDelay, execution.controller.signal);
59
+ return executeWithRetry(args, retriesLeft - 1, execution);
60
+ }
61
+ };
62
+ const cancelExecution = (execution, reason) => {
63
+ execution.abortReason = reason;
64
+ if (!execution.controller.signal.aborted) execution.controller.abort();
65
+ execution.rejectAbort?.(reason);
66
+ if (execution.timeoutId) {
67
+ clearTimeout(execution.timeoutId);
68
+ execution.timeoutId = void 0;
43
69
  }
44
70
  };
45
71
  const execute = async (...args) => {
46
- if (abortController) abortController.abort();
47
- abortController = new AbortController();
72
+ if (activeExecution) cancelExecution(activeExecution, abortError());
73
+ const execution = {
74
+ id: ++nextExecutionId,
75
+ controller: new AbortController()
76
+ };
77
+ activeExecution = execution;
48
78
  if (resetOnExecute) _state.error = null;
49
79
  _state.loading = true;
50
80
  _state.executionCount++;
51
81
  _state.lastExecutedAt = Date.now();
52
82
  notify();
53
83
  try {
54
- let result;
55
- if (timeout > 0) {
56
- const timeoutPromise = new Promise((_, reject) => {
57
- setTimeout(() => reject(/* @__PURE__ */ new Error(`Timeout after ${timeout}ms`)), timeout);
58
- });
59
- result = await Promise.race([executeWithRetry(args, retryCount), timeoutPromise]);
60
- } else result = await executeWithRetry(args, retryCount);
61
- if (!abortController.signal.aborted) {
84
+ const work = executeWithRetry(args, retryCount, execution);
85
+ const abortPromise = new Promise((_, reject) => {
86
+ execution.rejectAbort = reject;
87
+ });
88
+ const timeoutPromise = timeout > 0 ? new Promise((_, reject) => {
89
+ execution.timeoutId = setTimeout(() => {
90
+ const error = /* @__PURE__ */ new Error(`Timeout after ${timeout}ms`);
91
+ execution.abortReason = error;
92
+ execution.controller.abort();
93
+ reject(error);
94
+ }, timeout);
95
+ }) : null;
96
+ execution.result = timeoutPromise ? Promise.race([
97
+ work,
98
+ abortPromise,
99
+ timeoutPromise
100
+ ]) : Promise.race([work, abortPromise]);
101
+ const result = await execution.result;
102
+ if (activeExecution?.id === execution.id && !execution.controller.signal.aborted) {
62
103
  _state.data = result;
63
104
  _state.error = null;
64
105
  _state.loading = false;
@@ -67,20 +108,27 @@ function createAsyncAction(fn, options = {}) {
67
108
  }
68
109
  return result;
69
110
  } catch (error) {
70
- if (!abortController.signal.aborted) {
111
+ if (activeExecution?.id === execution.id) {
71
112
  const err = error instanceof Error ? error : new Error(String(error));
72
113
  _state.error = err;
73
114
  _state.loading = false;
74
115
  notify();
75
- errorPubSub.publish(err);
116
+ if (execution.abortReason?.message !== "Aborted") errorPubSub.publish(err);
76
117
  }
77
118
  throw error;
119
+ } finally {
120
+ if (execution.timeoutId) {
121
+ clearTimeout(execution.timeoutId);
122
+ execution.timeoutId = void 0;
123
+ }
124
+ if (activeExecution?.id === execution.id) activeExecution = null;
78
125
  }
79
126
  };
80
127
  const reset = () => {
81
- if (abortController) {
82
- abortController.abort();
83
- abortController = null;
128
+ if (activeExecution) {
129
+ const execution = activeExecution;
130
+ activeExecution = null;
131
+ cancelExecution(execution, abortError());
84
132
  }
85
133
  _state.data = null;
86
134
  _state.error = null;
@@ -90,13 +138,13 @@ function createAsyncAction(fn, options = {}) {
90
138
  notify();
91
139
  };
92
140
  const abort = () => {
93
- if (abortController) {
94
- abortController.abort();
95
- abortController = null;
96
- }
141
+ const execution = activeExecution;
142
+ if (!execution) return;
143
+ activeExecution = null;
144
+ cancelExecution(execution, abortError());
97
145
  if (_state.loading) {
98
146
  _state.loading = false;
99
- _state.error = /* @__PURE__ */ new Error("Aborted");
147
+ _state.error = execution.abortReason ?? abortError();
100
148
  notify();
101
149
  }
102
150
  };
@@ -1 +1 @@
1
- {"version":3,"file":"async-action.cjs","names":[],"sources":["../../src/core/async-action.ts"],"sourcesContent":["/**\n * 异步 Action 工具\n *\n * 提供框架无关的异步操作状态管理\n * @module core/async-action\n */\n\nimport type { Unsubscribe } from '../types'\nimport { createPubSub } from './pub-sub'\n\n/**\n * 异步 Action 配置\n */\nexport interface AsyncActionOptions {\n /** 重试次数 (默认 0) */\n retryCount?: number\n /** 重试间隔 (毫秒, 默认 1000) */\n retryDelay?: number\n /** 超时时间 (毫秒, 0=不限) */\n timeout?: number\n /** 执行前是否自动清除上次错误 */\n resetOnExecute?: boolean\n}\n\n/**\n * 异步 Action 状态\n */\nexport interface AsyncActionState<T> {\n /** 返回数据 */\n data: T | null\n /** 错误信息 */\n error: Error | null\n /** 是否加载中 */\n loading: boolean\n /** 执行次数 */\n executionCount: number\n /** 最后执行时间 */\n lastExecutedAt: number | null\n}\n\n/**\n * 异步 Action 实例\n */\nexport interface AsyncAction<T, Args extends unknown[]> {\n /** 当前状态 */\n readonly state: AsyncActionState<T>\n /** 执行异步操作 */\n execute: (...args: Args) => Promise<T>\n /** 重置状态 */\n reset: () => void\n /** 取消当前执行 */\n abort: () => void\n /** 订阅状态变化 */\n subscribe: (callback: (state: AsyncActionState<T>) => void) => Unsubscribe\n /** 设置成功回调 */\n onSuccess: (callback: (data: T) => void) => Unsubscribe\n /** 设置错误回调 */\n onError: (callback: (error: Error) => void) => Unsubscribe\n}\n\n/**\n * 延迟工具函数\n */\nfunction delay(ms: number): Promise<void> {\n return new Promise(resolve => setTimeout(resolve, ms))\n}\n\n/**\n * 创建异步 Action\n *\n * 将异步函数包装为带状态追踪的 Action,自动管理 loading/data/error 状态\n *\n * @template T - 返回数据类型\n * @template Args - 参数类型\n * @param fn - 异步函数\n * @param options - 配置选项\n * @returns AsyncAction 实例\n *\n * @example\n * ```typescript\n * // 基本用法\n * const fetchUsers = createAsyncAction(async (page: number) => {\n * const res = await fetch(`/api/users?page=${page}`)\n * return res.json()\n * })\n *\n * await fetchUsers.execute(1)\n * console.log(fetchUsers.state.data) // 用户列表\n * console.log(fetchUsers.state.loading) // false\n *\n * // 带重试\n * const fetchWithRetry = createAsyncAction(\n * async () => fetch('/api/unstable').then(r => r.json()),\n * { retryCount: 3, retryDelay: 1000 }\n * )\n *\n * // 订阅状态变化\n * fetchUsers.subscribe((state) => {\n * console.log('loading:', state.loading, 'data:', state.data)\n * })\n *\n * // 成功/错误回调\n * fetchUsers.onSuccess((data) => console.log('Got:', data))\n * fetchUsers.onError((err) => console.error('Failed:', err))\n * ```\n */\nexport function createAsyncAction<T, Args extends unknown[] = []>(\n fn: (...args: Args) => Promise<T>,\n options: AsyncActionOptions = {},\n): AsyncAction<T, Args> {\n const {\n retryCount = 0,\n retryDelay = 1000,\n timeout = 0,\n resetOnExecute = true,\n } = options\n\n // 内部状态\n const _state: AsyncActionState<T> = {\n data: null,\n error: null,\n loading: false,\n executionCount: 0,\n lastExecutedAt: null,\n }\n\n // 发布/订阅\n const statePubSub = createPubSub<AsyncActionState<T>>()\n const successPubSub = createPubSub<T>()\n const errorPubSub = createPubSub<Error>()\n\n // 当前 AbortController\n let abortController: AbortController | null = null\n\n /** 通知状态变化 */\n const notify = (): void => {\n statePubSub.publish({ ..._state })\n }\n\n /** 执行带重试的异步函数 */\n const executeWithRetry = async (args: Args, retriesLeft: number): Promise<T> => {\n try {\n return await fn(...args)\n }\n catch (error) {\n if (retriesLeft > 0 && !abortController?.signal.aborted) {\n await delay(retryDelay)\n if (abortController?.signal.aborted) {\n throw new Error('Aborted')\n }\n return executeWithRetry(args, retriesLeft - 1)\n }\n throw error\n }\n }\n\n /** 执行 */\n const execute = async (...args: Args): Promise<T> => {\n // 取消上一次执行\n if (abortController) {\n abortController.abort()\n }\n abortController = new AbortController()\n\n if (resetOnExecute) {\n _state.error = null\n }\n\n _state.loading = true\n _state.executionCount++\n _state.lastExecutedAt = Date.now()\n notify()\n\n try {\n let result: T\n\n if (timeout > 0) {\n const timeoutPromise = new Promise<never>((_, reject) => {\n setTimeout(() => reject(new Error(`Timeout after ${timeout}ms`)), timeout)\n })\n result = await Promise.race([\n executeWithRetry(args, retryCount),\n timeoutPromise,\n ])\n }\n else {\n result = await executeWithRetry(args, retryCount)\n }\n\n if (!abortController.signal.aborted) {\n _state.data = result\n _state.error = null\n _state.loading = false\n notify()\n successPubSub.publish(result)\n }\n\n return result\n }\n catch (error) {\n if (!abortController.signal.aborted) {\n const err = error instanceof Error ? error : new Error(String(error))\n _state.error = err\n _state.loading = false\n notify()\n errorPubSub.publish(err)\n }\n throw error\n }\n }\n\n /** 重置 */\n const reset = (): void => {\n if (abortController) {\n abortController.abort()\n abortController = null\n }\n _state.data = null\n _state.error = null\n _state.loading = false\n _state.executionCount = 0\n _state.lastExecutedAt = null\n notify()\n }\n\n /** 取消 */\n const abort = (): void => {\n if (abortController) {\n abortController.abort()\n abortController = null\n }\n if (_state.loading) {\n _state.loading = false\n _state.error = new Error('Aborted')\n notify()\n }\n }\n\n return {\n get state() { return { ..._state } },\n execute,\n reset,\n abort,\n subscribe: (callback) => statePubSub.subscribe(callback),\n onSuccess: (callback) => successPubSub.subscribe(callback),\n onError: (callback) => errorPubSub.subscribe(callback),\n }\n}\n"],"mappings":";;;;;;;;;;;;;AA+DA,SAAS,MAAM,IAA2B;CACxC,OAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,EAAE,CAAC;AACvD;AAyCO,SAAS,kBACd,IACA,UAA8B,CAAC,GACT;CACtB,MAAM,EACJ,aAAa,GACb,aAAa,KACb,UAAU,GACV,iBAAiB,SACf;CAGJ,MAAM,SAA8B;EAClC,MAAM;EACN,OAAO;EACP,SAAS;EACT,gBAAgB;EAChB,gBAAgB;CAClB;CAGA,MAAM,cAAc,gBAAA,aAAkC;CACtD,MAAM,gBAAgB,gBAAA,aAAgB;CACtC,MAAM,cAAc,gBAAA,aAAoB;CAGxC,IAAI,kBAA0C;CAG9C,MAAM,eAAqB;EACzB,YAAY,QAAQ,EAAE,GAAG,OAAO,CAAC;CACnC;CAGA,MAAM,mBAAmB,OAAO,MAAY,gBAAoC;EAC9E,IAAI;GACF,OAAO,MAAM,GAAG,GAAG,IAAI;EACzB,SACO,OAAO;GACZ,IAAI,cAAc,KAAK,CAAC,iBAAiB,OAAO,SAAS;IACvD,MAAM,MAAM,UAAU;IACtB,IAAI,iBAAiB,OAAO,SAC1B,MAAM,IAAI,MAAM,SAAS;IAE3B,OAAO,iBAAiB,MAAM,cAAc,CAAC;GAC/C;GACA,MAAM;EACR;CACF;CAGA,MAAM,UAAU,OAAA,GAAU,SAA2B;EAEnD,IAAI,iBACF,gBAAgB,MAAM;EAExB,kBAAkB,IAAI,gBAAgB;EAEtC,IAAI,gBACF,OAAO,QAAQ;EAGjB,OAAO,UAAU;EACjB,OAAO;EACP,OAAO,iBAAiB,KAAK,IAAI;EACjC,OAAO;EAEP,IAAI;GACF,IAAI;GAEJ,IAAI,UAAU,GAAG;IACf,MAAM,iBAAiB,IAAI,SAAgB,GAAG,WAAW;KACvD,iBAAiB,uBAAO,IAAI,MAAM,iBAAiB,QAAO,GAAI,CAAC,GAAG,OAAO;IAC3E,CAAC;IACD,SAAS,MAAM,QAAQ,KAAK,CAC1B,iBAAiB,MAAM,UAAU,GACjC,cACF,CAAC;GACH,OAEE,SAAS,MAAM,iBAAiB,MAAM,UAAU;GAGlD,IAAI,CAAC,gBAAgB,OAAO,SAAS;IACnC,OAAO,OAAO;IACd,OAAO,QAAQ;IACf,OAAO,UAAU;IACjB,OAAO;IACP,cAAc,QAAQ,MAAM;GAC9B;GAEA,OAAO;EACT,SACO,OAAO;GACZ,IAAI,CAAC,gBAAgB,OAAO,SAAS;IACnC,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;IACpE,OAAO,QAAQ;IACf,OAAO,UAAU;IACjB,OAAO;IACP,YAAY,QAAQ,GAAG;GACzB;GACA,MAAM;EACR;CACF;CAGA,MAAM,cAAoB;EACxB,IAAI,iBAAiB;GACnB,gBAAgB,MAAM;GACtB,kBAAkB;EACpB;EACA,OAAO,OAAO;EACd,OAAO,QAAQ;EACf,OAAO,UAAU;EACjB,OAAO,iBAAiB;EACxB,OAAO,iBAAiB;EACxB,OAAO;CACT;CAGA,MAAM,cAAoB;EACxB,IAAI,iBAAiB;GACnB,gBAAgB,MAAM;GACtB,kBAAkB;EACpB;EACA,IAAI,OAAO,SAAS;GAClB,OAAO,UAAU;GACjB,OAAO,wBAAQ,IAAI,MAAM,SAAS;GAClC,OAAO;EACT;CACF;CAEA,OAAO;EACL,IAAI,QAAQ;GAAE,OAAO,EAAE,GAAG,OAAO;EAAE;EACnC;EACA;EACA;EACA,YAAY,aAAa,YAAY,UAAU,QAAQ;EACvD,YAAY,aAAa,cAAc,UAAU,QAAQ;EACzD,UAAU,aAAa,YAAY,UAAU,QAAQ;CACvD;AACF"}
1
+ {"version":3,"file":"async-action.cjs","names":[],"sources":["../../src/core/async-action.ts"],"sourcesContent":["/** Race-safe asynchronous action helper. */\n\nimport type { Unsubscribe } from '../types'\nimport { createPubSub } from './pub-sub'\n\nexport interface AsyncActionOptions {\n retryCount?: number\n retryDelay?: number\n timeout?: number\n resetOnExecute?: boolean\n}\n\nexport interface AsyncActionState<T> {\n data: T | null\n error: Error | null\n loading: boolean\n executionCount: number\n lastExecutedAt: number | null\n}\n\nexport interface AsyncAction<T, Args extends unknown[]> {\n readonly state: AsyncActionState<T>\n execute: (...args: Args) => Promise<T>\n reset: () => void\n abort: () => void\n subscribe: (callback: (state: AsyncActionState<T>) => void) => Unsubscribe\n onSuccess: (callback: (data: T) => void) => Unsubscribe\n onError: (callback: (error: Error) => void) => Unsubscribe\n}\n\ninterface Execution<T> {\n id: number\n controller: AbortController\n timeoutId?: ReturnType<typeof setTimeout>\n rejectAbort?: (error: Error) => void\n abortReason?: Error\n result?: Promise<T>\n}\n\nfunction abortError(): Error {\n return new Error('Aborted')\n}\n\nfunction delay(ms: number, signal: AbortSignal): Promise<void> {\n if (signal.aborted) {\n return Promise.reject(abortError())\n }\n\n return new Promise((resolve, reject) => {\n let timer: ReturnType<typeof setTimeout>\n const onAbort = (): void => {\n clearTimeout(timer)\n signal.removeEventListener('abort', onAbort)\n reject(abortError())\n }\n timer = setTimeout(() => {\n signal.removeEventListener('abort', onAbort)\n resolve()\n }, ms)\n signal.addEventListener('abort', onAbort, { once: true })\n })\n}\n\nexport function createAsyncAction<T, Args extends unknown[] = []>(\n fn: (...args: Args) => Promise<T>,\n options: AsyncActionOptions = {}\n): AsyncAction<T, Args> {\n const {\n retryCount = 0,\n retryDelay = 1000,\n timeout = 0,\n resetOnExecute = true,\n } = options\n\n const _state: AsyncActionState<T> = {\n data: null,\n error: null,\n loading: false,\n executionCount: 0,\n lastExecutedAt: null,\n }\n const statePubSub = createPubSub<AsyncActionState<T>>()\n const successPubSub = createPubSub<T>()\n const errorPubSub = createPubSub<Error>()\n let nextExecutionId = 0\n let activeExecution: Execution<T> | null = null\n\n const notify = (): void => statePubSub.publish({ ..._state })\n\n const invoke = fn as unknown as (\n ...args: [...Args, AbortSignal]\n ) => Promise<T>\n const executeWithRetry = async (\n args: Args,\n retriesLeft: number,\n execution: Execution<T>\n ): Promise<T> => {\n if (execution.controller.signal.aborted) {\n throw execution.abortReason ?? abortError()\n }\n\n try {\n const result = await invoke(...args, execution.controller.signal)\n if (execution.controller.signal.aborted) {\n throw execution.abortReason ?? abortError()\n }\n return result\n } catch (error) {\n if (execution.controller.signal.aborted) {\n throw execution.abortReason ?? abortError()\n }\n if (retriesLeft <= 0) {\n throw error\n }\n await delay(retryDelay, execution.controller.signal)\n return executeWithRetry(args, retriesLeft - 1, execution)\n }\n }\n\n const cancelExecution = (execution: Execution<T>, reason: Error): void => {\n execution.abortReason = reason\n if (!execution.controller.signal.aborted) {\n execution.controller.abort()\n }\n execution.rejectAbort?.(reason)\n if (execution.timeoutId) {\n clearTimeout(execution.timeoutId)\n execution.timeoutId = undefined\n }\n }\n\n const execute = async (...args: Args): Promise<T> => {\n if (activeExecution) {\n cancelExecution(activeExecution, abortError())\n }\n\n const execution: Execution<T> = {\n id: ++nextExecutionId,\n controller: new AbortController(),\n }\n activeExecution = execution\n\n if (resetOnExecute) {\n _state.error = null\n }\n _state.loading = true\n _state.executionCount++\n _state.lastExecutedAt = Date.now()\n notify()\n\n try {\n const work = executeWithRetry(args, retryCount, execution)\n const abortPromise = new Promise<never>((_, reject) => {\n execution.rejectAbort = reject\n })\n const timeoutPromise =\n timeout > 0\n ? new Promise<never>((_, reject) => {\n execution.timeoutId = setTimeout(() => {\n const error = new Error(`Timeout after ${timeout}ms`)\n execution.abortReason = error\n execution.controller.abort()\n reject(error)\n }, timeout)\n })\n : null\n\n execution.result = timeoutPromise\n ? Promise.race([work, abortPromise, timeoutPromise])\n : Promise.race([work, abortPromise])\n const result = await execution.result\n\n if (\n activeExecution?.id === execution.id &&\n !execution.controller.signal.aborted\n ) {\n _state.data = result\n _state.error = null\n _state.loading = false\n notify()\n successPubSub.publish(result)\n }\n\n return result\n } catch (error) {\n if (activeExecution?.id === execution.id) {\n const err = error instanceof Error ? error : new Error(String(error))\n _state.error = err\n _state.loading = false\n notify()\n if (execution.abortReason?.message !== 'Aborted') {\n errorPubSub.publish(err)\n }\n }\n throw error\n } finally {\n if (execution.timeoutId) {\n clearTimeout(execution.timeoutId)\n execution.timeoutId = undefined\n }\n if (activeExecution?.id === execution.id) {\n activeExecution = null\n }\n }\n }\n\n const reset = (): void => {\n if (activeExecution) {\n const execution = activeExecution\n activeExecution = null\n cancelExecution(execution, abortError())\n }\n _state.data = null\n _state.error = null\n _state.loading = false\n _state.executionCount = 0\n _state.lastExecutedAt = null\n notify()\n }\n\n const abort = (): void => {\n const execution = activeExecution\n if (!execution) return\n\n activeExecution = null\n cancelExecution(execution, abortError())\n if (_state.loading) {\n _state.loading = false\n _state.error = execution.abortReason ?? abortError()\n notify()\n }\n }\n\n return {\n get state() {\n return { ..._state }\n },\n execute,\n reset,\n abort,\n subscribe: callback => statePubSub.subscribe(callback),\n onSuccess: callback => successPubSub.subscribe(callback),\n onError: callback => errorPubSub.subscribe(callback),\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ /** Race-safe asynchronous action helper. */
2
+ import type { Unsubscribe } from '../types';
3
+ export interface AsyncActionOptions {
4
+ retryCount?: number;
5
+ retryDelay?: number;
6
+ timeout?: number;
7
+ resetOnExecute?: boolean;
8
+ }
9
+ export interface AsyncActionState<T> {
10
+ data: T | null;
11
+ error: Error | null;
12
+ loading: boolean;
13
+ executionCount: number;
14
+ lastExecutedAt: number | null;
15
+ }
16
+ export interface AsyncAction<T, Args extends unknown[]> {
17
+ readonly state: AsyncActionState<T>;
18
+ execute: (...args: Args) => Promise<T>;
19
+ reset: () => void;
20
+ abort: () => void;
21
+ subscribe: (callback: (state: AsyncActionState<T>) => void) => Unsubscribe;
22
+ onSuccess: (callback: (data: T) => void) => Unsubscribe;
23
+ onError: (callback: (error: Error) => void) => Unsubscribe;
24
+ }
25
+ export declare function createAsyncAction<T, Args extends unknown[] = []>(fn: (...args: Args) => Promise<T>, options?: AsyncActionOptions): AsyncAction<T, Args>;