@openuverse/uvapi 0.0.0-stage → 1.1.3

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 (137) hide show
  1. package/README.md +17 -2
  2. package/dist/_virtual/_commonjsHelpers.js +6 -0
  3. package/dist/_virtual/index.js +4 -0
  4. package/dist/api/RestAPIClient.d.ts +191 -0
  5. package/dist/api/RestAPIClient.js +328 -0
  6. package/dist/api/WebSocketClient.d.ts +174 -0
  7. package/dist/api/WebSocketClient.js +277 -0
  8. package/dist/api/index.d.ts +6 -0
  9. package/dist/api/modules/index.d.ts +2 -0
  10. package/dist/api/modules/task.d.ts +124 -0
  11. package/dist/api/modules/task.js +121 -0
  12. package/dist/api/modules/user.d.ts +114 -0
  13. package/dist/api/modules/user.js +113 -0
  14. package/dist/config/index.d.ts +120 -0
  15. package/dist/config/index.js +112 -0
  16. package/dist/hooks/index.d.ts +1 -0
  17. package/dist/hooks/useAttributeMonitor.d.ts +45 -0
  18. package/dist/hooks/useAttributeMonitor.js +115 -0
  19. package/dist/index.d.ts +20 -0
  20. package/dist/index.js +93 -0
  21. package/dist/locale/de-DE.d.ts +18 -0
  22. package/dist/locale/de-DE.js +20 -0
  23. package/dist/locale/en-US.d.ts +18 -0
  24. package/dist/locale/en-US.js +20 -0
  25. package/dist/locale/es-ES.d.ts +18 -0
  26. package/dist/locale/es-ES.js +20 -0
  27. package/dist/locale/fr-FR.d.ts +18 -0
  28. package/dist/locale/fr-FR.js +20 -0
  29. package/dist/locale/id-ID.d.ts +18 -0
  30. package/dist/locale/id-ID.js +20 -0
  31. package/dist/locale/index.d.ts +19 -0
  32. package/dist/locale/index.js +70 -0
  33. package/dist/locale/ja-JP.d.ts +18 -0
  34. package/dist/locale/ja-JP.js +20 -0
  35. package/dist/locale/ko-KR.d.ts +18 -0
  36. package/dist/locale/ko-KR.js +20 -0
  37. package/dist/locale/pl-PL.d.ts +18 -0
  38. package/dist/locale/pl-PL.js +20 -0
  39. package/dist/locale/pt-BR.d.ts +18 -0
  40. package/dist/locale/pt-BR.js +20 -0
  41. package/dist/locale/ru-RU.d.ts +18 -0
  42. package/dist/locale/ru-RU.js +20 -0
  43. package/dist/locale/th-TH.d.ts +18 -0
  44. package/dist/locale/th-TH.js +20 -0
  45. package/dist/locale/zh-CN.d.ts +18 -0
  46. package/dist/locale/zh-CN.js +20 -0
  47. package/dist/locale/zh-TW.d.ts +18 -0
  48. package/dist/locale/zh-TW.js +20 -0
  49. package/dist/node_modules/@msgpack/msgpack/dist.esm/CachedKeyDecoder.js +38 -0
  50. package/dist/node_modules/@msgpack/msgpack/dist.esm/DecodeError.js +14 -0
  51. package/dist/node_modules/@msgpack/msgpack/dist.esm/Decoder.js +474 -0
  52. package/dist/node_modules/@msgpack/msgpack/dist.esm/Encoder.js +232 -0
  53. package/dist/node_modules/@msgpack/msgpack/dist.esm/ExtData.js +8 -0
  54. package/dist/node_modules/@msgpack/msgpack/dist.esm/ExtensionCodec.js +46 -0
  55. package/dist/node_modules/@msgpack/msgpack/dist.esm/decode.js +7 -0
  56. package/dist/node_modules/@msgpack/msgpack/dist.esm/encode.js +7 -0
  57. package/dist/node_modules/@msgpack/msgpack/dist.esm/timestamp.js +66 -0
  58. package/dist/node_modules/@msgpack/msgpack/dist.esm/utils/int.js +24 -0
  59. package/dist/node_modules/@msgpack/msgpack/dist.esm/utils/prettyByte.js +6 -0
  60. package/dist/node_modules/@msgpack/msgpack/dist.esm/utils/typedArrays.js +9 -0
  61. package/dist/node_modules/@msgpack/msgpack/dist.esm/utils/utf8.js +93 -0
  62. package/dist/node_modules/axios/index.js +38 -0
  63. package/dist/node_modules/axios/lib/adapters/adapters.js +55 -0
  64. package/dist/node_modules/axios/lib/adapters/fetch.js +169 -0
  65. package/dist/node_modules/axios/lib/adapters/xhr.js +72 -0
  66. package/dist/node_modules/axios/lib/axios.js +46 -0
  67. package/dist/node_modules/axios/lib/cancel/CancelToken.js +77 -0
  68. package/dist/node_modules/axios/lib/cancel/CanceledError.js +11 -0
  69. package/dist/node_modules/axios/lib/cancel/isCancel.js +6 -0
  70. package/dist/node_modules/axios/lib/core/Axios.js +136 -0
  71. package/dist/node_modules/axios/lib/core/AxiosError.js +56 -0
  72. package/dist/node_modules/axios/lib/core/AxiosHeaders.js +181 -0
  73. package/dist/node_modules/axios/lib/core/InterceptorManager.js +58 -0
  74. package/dist/node_modules/axios/lib/core/buildFullPath.js +9 -0
  75. package/dist/node_modules/axios/lib/core/dispatchRequest.js +31 -0
  76. package/dist/node_modules/axios/lib/core/mergeConfig.js +70 -0
  77. package/dist/node_modules/axios/lib/core/settle.js +14 -0
  78. package/dist/node_modules/axios/lib/core/transformData.js +13 -0
  79. package/dist/node_modules/axios/lib/defaults/index.js +89 -0
  80. package/dist/node_modules/axios/lib/defaults/transitional.js +8 -0
  81. package/dist/node_modules/axios/lib/env/data.js +4 -0
  82. package/dist/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +33 -0
  83. package/dist/node_modules/axios/lib/helpers/HttpStatusCode.js +71 -0
  84. package/dist/node_modules/axios/lib/helpers/bind.js +8 -0
  85. package/dist/node_modules/axios/lib/helpers/buildURL.js +23 -0
  86. package/dist/node_modules/axios/lib/helpers/combineURLs.js +6 -0
  87. package/dist/node_modules/axios/lib/helpers/composeSignals.js +30 -0
  88. package/dist/node_modules/axios/lib/helpers/cookies.js +32 -0
  89. package/dist/node_modules/axios/lib/helpers/formDataToJSON.js +31 -0
  90. package/dist/node_modules/axios/lib/helpers/isAbsoluteURL.js +6 -0
  91. package/dist/node_modules/axios/lib/helpers/isAxiosError.js +7 -0
  92. package/dist/node_modules/axios/lib/helpers/isURLSameOrigin.js +8 -0
  93. package/dist/node_modules/axios/lib/helpers/null.js +4 -0
  94. package/dist/node_modules/axios/lib/helpers/parseHeaders.js +30 -0
  95. package/dist/node_modules/axios/lib/helpers/parseProtocol.js +7 -0
  96. package/dist/node_modules/axios/lib/helpers/progressEventReducer.js +35 -0
  97. package/dist/node_modules/axios/lib/helpers/resolveConfig.js +33 -0
  98. package/dist/node_modules/axios/lib/helpers/speedometer.js +19 -0
  99. package/dist/node_modules/axios/lib/helpers/spread.js +8 -0
  100. package/dist/node_modules/axios/lib/helpers/throttle.js +15 -0
  101. package/dist/node_modules/axios/lib/helpers/toFormData.js +85 -0
  102. package/dist/node_modules/axios/lib/helpers/toURLEncodedForm.js +14 -0
  103. package/dist/node_modules/axios/lib/helpers/trackStream.js +63 -0
  104. package/dist/node_modules/axios/lib/helpers/validator.js +54 -0
  105. package/dist/node_modules/axios/lib/platform/browser/classes/Blob.js +4 -0
  106. package/dist/node_modules/axios/lib/platform/browser/classes/FormData.js +4 -0
  107. package/dist/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +5 -0
  108. package/dist/node_modules/axios/lib/platform/browser/index.js +15 -0
  109. package/dist/node_modules/axios/lib/platform/common/utils.js +9 -0
  110. package/dist/node_modules/axios/lib/platform/index.js +9 -0
  111. package/dist/node_modules/axios/lib/utils.js +237 -0
  112. package/dist/node_modules/postcss-pxtorem/index.js +109 -0
  113. package/dist/node_modules/postcss-pxtorem/lib/filter-prop-list.js +13 -0
  114. package/dist/node_modules/postcss-pxtorem/lib/pixel-unit-regex.js +7 -0
  115. package/dist/node_modules/postcss-pxtorem/lib/type.js +14 -0
  116. package/dist/preload/index.d.ts +125 -0
  117. package/dist/preload/index.js +79 -0
  118. package/dist/store/index.d.ts +1 -0
  119. package/dist/store/storeFactory.d.ts +584 -0
  120. package/dist/store/storeFactory.js +216 -0
  121. package/dist/theme/index.d.ts +1 -0
  122. package/dist/theme/index.js +14 -0
  123. package/dist/types/index.d.ts +57 -0
  124. package/dist/types/uVerseAPI.d.ts +67 -0
  125. package/dist/utils/_internal.d.ts +14 -0
  126. package/dist/utils/_internal.js +72 -0
  127. package/dist/utils/constance.d.ts +16 -0
  128. package/dist/utils/constance.js +7 -0
  129. package/dist/utils/index.d.ts +79 -0
  130. package/dist/utils/index.js +96 -0
  131. package/dist/utils/logger.d.ts +118 -0
  132. package/dist/utils/logger.js +170 -0
  133. package/dist/utils/px2rem/remAdapter.d.ts +17 -0
  134. package/dist/utils/px2rem/remAdapter.js +62 -0
  135. package/dist/utils/px2rem/vite.d.ts +14 -0
  136. package/dist/utils/px2rem/vite.js +33 -0
  137. package/package.json +102 -4
@@ -0,0 +1,79 @@
1
+ import { SceneType as i } from "../utils/constance.js";
2
+ const p = () => {
3
+ const e = {};
4
+ if (!process.argv || !Array.isArray(process.argv))
5
+ return e;
6
+ for (const s of process.argv)
7
+ if (s.startsWith("--") && s.includes("=")) {
8
+ const [a, ...g] = s.slice(2).split("=");
9
+ e[a] = g.join("=");
10
+ }
11
+ return e;
12
+ }, c = (e) => {
13
+ const s = p();
14
+ let a;
15
+ try {
16
+ a = e.sendSync("get-platform-config-sync");
17
+ } catch {
18
+ }
19
+ const g = {
20
+ language: (a == null ? void 0 : a.language) || s["initial-language"] || "zh-CN",
21
+ theme: (a == null ? void 0 : a.theme) || s["initial-theme"] || "dark",
22
+ supported_languages: a == null ? void 0 : a.supported_languages
23
+ }, v = {
24
+ hostname: s["server-hostname"] || "localhost",
25
+ port: s["server-port"] || "9898",
26
+ protocol: s["server-protocol"] || "http",
27
+ mcp_port: s["mcp-port"] || "9899"
28
+ };
29
+ return {
30
+ viewType: s.view_type || (s["standalone-appid"] ? i.ELECTRON_BROWSERWINDOW : i.ELECTRON_WEBCONTENTSVIEW),
31
+ runningEnvironment: "UVerse",
32
+ initialConfig: g,
33
+ serverConfig: v,
34
+ // ========== 事件监听 API ==========
35
+ /**
36
+ * 注册语言变更事件监听器
37
+ *
38
+ * 由 UV-API 插件调用,监听平台语言配置变化
39
+ * 当主窗口修改语言时,所有视图(包括用户应用)会收到通知
40
+ *
41
+ * @param callback 回调函数,参数为新的语言代码
42
+ * @returns 取消注册的函数
43
+ */
44
+ registerLanguageChangeEvent: (t) => {
45
+ const n = (o, r) => t(r);
46
+ return e.on("language-changed", n), () => e.off("language-changed", n);
47
+ },
48
+ /**
49
+ * 注册主题变更事件监听器
50
+ *
51
+ * 由 UV-API 插件调用,监听平台主题配置变化
52
+ * 当主窗口修改主题时,所有视图(包括用户应用)会收到通知
53
+ *
54
+ * @param callback 回调函数,参数为新的主题名称
55
+ * @returns 取消注册的函数
56
+ */
57
+ registerThemeChangeEvent: (t) => {
58
+ const n = (o, r) => t(r);
59
+ return e.on("theme-changed", n), () => e.off("theme-changed", n);
60
+ },
61
+ navTo: (t, n) => e.invoke("nav-to", t, n),
62
+ registerAppEvent: (t, n) => {
63
+ const o = (r, ...l) => n(...l);
64
+ return e.on(`app-event:${t}`, o), () => e.off(`app-event:${t}`, o);
65
+ },
66
+ emitAppEvent: (t, n, ...o) => e.send("app-event-emit", { targetAppId: t, event: n, args: o }),
67
+ sendLog: (t, n, o, r) => {
68
+ e.send("log-from-renderer", { level: t, message: n, args: o, source: r });
69
+ },
70
+ update: () => e.send("update-runtime"),
71
+ showOpenDialog: (t) => e.invoke("show-open-dialog", t),
72
+ showSaveDialog: (t) => e.invoke("show-save-dialog", t)
73
+ };
74
+ };
75
+ export {
76
+ i as SceneType,
77
+ p as getMainProcessArgs,
78
+ c as initMandatoryUVerseAPI
79
+ };
@@ -0,0 +1 @@
1
+ export { storeManager, type Store, type StoreOptions } from './storeFactory';
@@ -0,0 +1,584 @@
1
+ import { ToRefs } from 'vue';
2
+ import { DeepPartial } from '../types';
3
+ /**
4
+ * Store 配置选项
5
+ */
6
+ export interface StoreOptions<T> {
7
+ /** 状态变化时的回调函数 */
8
+ onChange?: (newState: T, oldState: T) => void;
9
+ /** 是否深度监听,默认 true */
10
+ deep?: boolean;
11
+ /**
12
+ * 数据同步函数
13
+ *
14
+ * @description
15
+ * 用于主动从后端或其他数据源获取最新数据的异步函数。
16
+ * 当 Store 注册时会自动调用一次,获取初始数据并更新状态。
17
+ * 也可以通过外部手动调用来刷新数据。
18
+ *
19
+ * @returns 返回 Promise,resolve 时返回最新的完整状态数据
20
+ *
21
+ * @example
22
+ * ```typescript
23
+ * // 定义带同步功能的 Store
24
+ * const configStore = defineStore('config', {
25
+ * theme: 'light',
26
+ * language: 'zh-CN'
27
+ * }, {
28
+ * syncData: async () => {
29
+ * // 从后端获取最新配置
30
+ * const response = await api.action('getConfig')
31
+ * return response.data
32
+ * }
33
+ * })
34
+ *
35
+ * // Store 注册时会自动调用 syncData 获取初始数据
36
+ *
37
+ * // 也可以手动调用同步函数刷新数据
38
+ * const freshData = await options.syncData()
39
+ * configStore.setState(freshData)
40
+ * ```
41
+ */
42
+ syncData?: () => Promise<T>;
43
+ }
44
+ /**
45
+ * Store 实例接口
46
+ *
47
+ * @template T - Store 状态的类型,必须是对象类型
48
+ *
49
+ * @description
50
+ * Store 实例提供了完整的状态管理功能,包括响应式状态访问、
51
+ * 状态更新、批量修改、重置和订阅等能力。
52
+ */
53
+ export interface Store<T extends Record<string, any>> {
54
+ /**
55
+ * Store 的唯一标识符
56
+ *
57
+ * @description
58
+ * Store 在全局管理器中的唯一 ID,用于标识和查找 Store 实例。
59
+ * 支持格式:`${workerId}:${attributeGroup}` 或单独的 `attributeGroup`
60
+ *
61
+ * @example
62
+ * ```typescript
63
+ * console.log(store.id) // 'app1:DemoTaskAttributes' 或 'user'
64
+ * ```
65
+ */
66
+ readonly id?: string;
67
+ /**
68
+ * 属性组名称
69
+ *
70
+ * @description
71
+ * 从 id 中解析出的属性组名称,用于后端 API 调用。
72
+ * - 如果 id 包含 `:`,则取 `:` 后面的部分作为 attributeGroup
73
+ * - 如果 id 不包含 `:`,则 attributeGroup 等于 id
74
+ *
75
+ * @example
76
+ * ```typescript
77
+ * // id = 'app1:DemoTaskAttributes'
78
+ * console.log(store.attributeGroup) // 'DemoTaskAttributes'
79
+ *
80
+ * // id = 'user'
81
+ * console.log(store.attributeGroup) // 'user'
82
+ * ```
83
+ */
84
+ readonly attributeGroup?: string;
85
+ /**
86
+ * 响应式状态对象
87
+ *
88
+ * @description
89
+ * 可直接访问和修改的响应式状态,支持 Vue 的所有响应式特性,
90
+ * 包括 v-model 绑定和多层级嵌套对象的深度响应。
91
+ *
92
+ * @example
93
+ * ```typescript
94
+ * // 直接读取
95
+ * console.log(store.state.name)
96
+ *
97
+ * // 直接修改(会触发响应)
98
+ * store.state.name = 'New Name'
99
+ *
100
+ * // 在模板中使用
101
+ * <input v-model="store.state.name" />
102
+ * ```
103
+ */
104
+ readonly state: T;
105
+ /**
106
+ * 响应式状态的解构引用
107
+ *
108
+ * @description
109
+ * 通过 toRefs 转换后的响应式引用对象,可以安全地解构使用。
110
+ * 适用于 Composition API 中需要保持响应性的场景。
111
+ *
112
+ * @example
113
+ * ```typescript
114
+ * // 在 setup 中解构使用
115
+ * const { name, age } = store.refs
116
+ *
117
+ * // 在模板中直接使用
118
+ * <div>{{ name }}</div>
119
+ * ```
120
+ */
121
+ readonly refs: ToRefs<T>;
122
+ /**
123
+ * 获取当前状态的深拷贝副本
124
+ *
125
+ * @returns 状态的深拷贝对象
126
+ *
127
+ * @description
128
+ * 返回状态的完整深拷贝,修改返回值不会影响原状态。
129
+ * 适用于需要获取快照或进行对比的场景。
130
+ *
131
+ * @example
132
+ * ```typescript
133
+ * const snapshot = store.getState()
134
+ * snapshot.name = 'Modified' // 不影响 store.state
135
+ * ```
136
+ */
137
+ getState: () => T;
138
+ /**
139
+ * 更新部分状态
140
+ *
141
+ * @param partial - 部分状态对象或返回部分状态的函数
142
+ * @param timestamp - 可选的时间戳,不传则不更新时间戳
143
+ *
144
+ * @description
145
+ * 支持两种更新方式:
146
+ * 1. 直接传入部分状态对象(支持深度合并)
147
+ * 2. 传入函数,接收当前状态副本,返回要更新的部分
148
+ *
149
+ * 更新时会进行深度合并,不会覆盖未指定的嵌套属性。
150
+ * 可选传入时间戳参数来更新 Store 的时间戳。
151
+ *
152
+ * @example
153
+ * ```typescript
154
+ * // 方式1:直接传入对象
155
+ * store.setState({ name: 'Alice' })
156
+ *
157
+ * // 方式2:传入函数(适合基于当前状态计算)
158
+ * store.setState(state => ({ age: state.age + 1 }))
159
+ *
160
+ * // 深度合并(不会覆盖未指定的嵌套属性)
161
+ * store.setState({
162
+ * profile: {
163
+ * city: 'Beijing' // 只更新 city,保留其他 profile 属性
164
+ * }
165
+ * })
166
+ *
167
+ * // 同时更新时间戳
168
+ * store.setState({ name: 'Alice' }, Date.now())
169
+ * ```
170
+ */
171
+ setState: (partial: DeepPartial<T> | ((state: T) => DeepPartial<T>), timestamp?: number) => void;
172
+ /**
173
+ * 批量更新状态
174
+ *
175
+ * @param updater - 接收响应式状态对象的更新函数
176
+ *
177
+ * @description
178
+ * 直接操作响应式状态对象,适合进行多个属性的批量修改。
179
+ * 在函数执行期间的所有修改会被合并为一次响应式更新。
180
+ *
181
+ * @example
182
+ * ```typescript
183
+ * // 批量修改多个属性
184
+ * store.batchUpdate(state => {
185
+ * state.name = 'Tom'
186
+ * state.age = 30
187
+ * state.email = 'tom@example.com'
188
+ * })
189
+ * ```
190
+ */
191
+ batchUpdate: (updater: (state: T) => void) => void;
192
+ /**
193
+ * 重置状态到初始值
194
+ *
195
+ * @description
196
+ * 将所有状态属性恢复到创建 Store 时的初始值。
197
+ *
198
+ * @example
199
+ * ```typescript
200
+ * store.state.name = 'Modified'
201
+ * store.reset()
202
+ * console.log(store.state.name) // 恢复为初始值
203
+ * ```
204
+ */
205
+ reset: () => void;
206
+ /**
207
+ * 订阅状态变化
208
+ *
209
+ * @param callback - 状态变化时的回调函数,接收新旧状态的深拷贝
210
+ * @returns 取消订阅的函数
211
+ *
212
+ * @description
213
+ * 注册一个回调函数,在状态发生变化时被调用。
214
+ * 回调函数接收的新旧状态都是深拷贝,可以安全使用。
215
+ *
216
+ * @example
217
+ * ```typescript
218
+ * // 订阅状态变化
219
+ * const unsubscribe = store.subscribe((newState, oldState) => {
220
+ * console.log('状态变化:', { old: oldState.name, new: newState.name })
221
+ * })
222
+ *
223
+ * // 取消订阅
224
+ * unsubscribe()
225
+ * ```
226
+ */
227
+ subscribe: (callback: (newState: T, oldState: T) => void) => () => void;
228
+ /**
229
+ * 获取当前时间戳
230
+ *
231
+ * @returns 当前 Store 的时间戳(毫秒级),初始值为 0(1970-01-01 00:00:00)
232
+ *
233
+ * @description
234
+ * 获取 Store 的时间戳,可用于追踪数据更新时间。
235
+ * 初始值为 0,需要在 setState 时传入时间戳或主动调用 setTimestamp 来更新。
236
+ *
237
+ * @example
238
+ * ```typescript
239
+ * const timestamp = store.getTimestamp()
240
+ * console.log(timestamp) // 0 或最后更新的时间戳
241
+ * console.log(new Date(timestamp)) // Date 对象
242
+ * ```
243
+ */
244
+ getTimestamp: () => number;
245
+ /**
246
+ * 设置时间戳
247
+ *
248
+ * @param timestamp - 要设置的时间戳(毫秒级)
249
+ *
250
+ * @description
251
+ * 主动设置 Store 的时间戳。
252
+ * 通常在接收到后端数据时,将后端的时间戳同步到 Store。
253
+ *
254
+ * @example
255
+ * ```typescript
256
+ * // 设置为当前时间
257
+ * store.setTimestamp(Date.now())
258
+ *
259
+ * // 设置为后端返回的时间戳
260
+ * store.setTimestamp(backendData.timestamp)
261
+ *
262
+ * // 重置为初始值
263
+ * store.setTimestamp(0)
264
+ * ```
265
+ */
266
+ setTimestamp: (timestamp: number) => void;
267
+ }
268
+ /**
269
+ * 创建一个响应式 Store
270
+ *
271
+ * @template T - Store 状态的类型
272
+ * @param initialState - 初始状态数据
273
+ * @param options - Store 配置选项
274
+ * @param id - Store 的唯一标识符(可选),支持格式:`${workerId}:${attributeGroup}` 或单独的 `attributeGroup`
275
+ * @returns Store 实例
276
+ *
277
+ * @example
278
+ * ```typescript
279
+ * interface UserState {
280
+ * name: string
281
+ * age: number
282
+ * email: string
283
+ * }
284
+ *
285
+ * const userStore = createStore<UserState>({
286
+ * name: 'John',
287
+ * age: 25,
288
+ * email: 'john@example.com'
289
+ * }, {
290
+ * onChange: (newState, oldState) => {
291
+ * console.log('状态变化:', newState)
292
+ * }
293
+ * }, 'user')
294
+ *
295
+ * // 使用
296
+ * console.log(userStore.id) // 'user'
297
+ * console.log(userStore.attributeGroup) // 'user'
298
+ * console.log(userStore.getTimestamp()) // 0 (初始值)
299
+ * console.log(userStore.state.name) // 'John'
300
+ *
301
+ * // 区分不同 app 的 Store
302
+ * const taskStore = createStore<TaskState>(initialState, {}, 'app1:DemoTaskAttributes')
303
+ * console.log(taskStore.id) // 'app1:DemoTaskAttributes'
304
+ * console.log(taskStore.attributeGroup) // 'DemoTaskAttributes'
305
+ *
306
+ * // 直接修改状态
307
+ * userStore.state.name = 'Jane'
308
+ *
309
+ * // 使用 setState 更新(同时更新时间戳)
310
+ * userStore.setState({ name: 'Alice' }, Date.now())
311
+ *
312
+ * // 主动设置时间戳
313
+ * userStore.setTimestamp(Date.now())
314
+ *
315
+ * // 批量更新
316
+ * userStore.batchUpdate((state) => {
317
+ * state.name = 'Tom'
318
+ * state.age = 30
319
+ * })
320
+ *
321
+ * // 重置状态
322
+ * userStore.reset()
323
+ * ```
324
+ */
325
+ export declare function createStore<T extends Record<string, any>>(initialState: T, options?: StoreOptions<T>, id?: string): Store<T>;
326
+ /**
327
+ * Store 管理器类
328
+ *
329
+ * @description
330
+ * 用于统一管理多个 Store 实例的管理器。
331
+ * 提供注册、获取、移除等功能,确保同一 ID 的 Store 只有一个实例。
332
+ *
333
+ * @example
334
+ * ```typescript
335
+ * const manager = new StoreManager()
336
+ *
337
+ * // 注册 Store
338
+ * const userStore = manager.register('user', { name: 'John' })
339
+ *
340
+ * // 获取 Store
341
+ * const store = manager.get('user')
342
+ *
343
+ * // 移除 Store
344
+ * manager.remove('user')
345
+ * ```
346
+ */
347
+ declare class StoreManager {
348
+ private stores;
349
+ /**
350
+ * 注册一个新的 Store
351
+ *
352
+ * @template T - Store 状态类型
353
+ * @param id - Store 的唯一标识符,支持格式:`${workerId}:${attributeGroup}` 或单独的 `attributeGroup`
354
+ * @param initialState - 初始状态
355
+ * @param options - Store 配置选项(不包含 id)
356
+ * @returns Store 实例
357
+ *
358
+ * @description
359
+ * 创建并注册一个新的 Store 实例。
360
+ * 如果指定的 ID 已存在,会返回已有实例并输出警告。
361
+ * 如果配置了 syncData 函数,会在注册后自动调用一次以获取初始数据。
362
+ *
363
+ * id 格式约定:
364
+ * - 格式 `${workerId}:${attributeGroup}`:用于区分不同 app 的同名属性组
365
+ * - 格式 `${attributeGroup}`:向后兼容,直接使用属性组名称
366
+ *
367
+ * Store 实例会自动解析 attributeGroup:
368
+ * - 如果 id 包含 `:`,则 `store.attributeGroup` 为 `:` 后面的部分
369
+ * - 如果 id 不包含 `:`,则 `store.attributeGroup` 等于 id
370
+ *
371
+ * @example
372
+ * ```typescript
373
+ * // 示例1:基础用法(向后兼容)
374
+ * const userStore = manager.register('user', {
375
+ * name: 'John',
376
+ * age: 25
377
+ * }, {
378
+ * onChange: (newState, oldState) => {
379
+ * console.log('用户状态变化')
380
+ * }
381
+ * })
382
+ * // userStore.id = 'user'
383
+ * // userStore.attributeGroup = 'user'
384
+ *
385
+ * // 示例2:区分不同 app 的同名 Store
386
+ * const store = manager.register(
387
+ * `${workerId}:DemoTaskAttributes`, // id 格式:workerId:attributeGroup
388
+ * initialState,
389
+ * {}
390
+ * )
391
+ * // store.id = 'app1:DemoTaskAttributes'
392
+ * // store.attributeGroup = 'DemoTaskAttributes'(用于 API 调用)
393
+ *
394
+ * // 示例3:带数据同步功能
395
+ * const configStore = manager.register('config', {
396
+ * theme: 'light',
397
+ * language: 'zh-CN'
398
+ * }, {
399
+ * syncData: async () => {
400
+ * // 注册时会自动调用此函数获取初始数据
401
+ * const response = await api.action('getConfig')
402
+ * return response.data
403
+ * }
404
+ * })
405
+ * ```
406
+ */
407
+ register<T extends Record<string, any>>(id: string, initialState: T, options?: StoreOptions<T>): Store<T>;
408
+ /**
409
+ * 根据 ID 获取 Store 实例
410
+ *
411
+ * @template T - Store 状态类型
412
+ * @param id - Store 的唯一标识符
413
+ * @returns Store 实例,如果不存在则返回 undefined
414
+ *
415
+ * @description
416
+ * 通过 ID 查找并返回对应的 Store 实例。
417
+ *
418
+ * @example
419
+ * ```typescript
420
+ * // 基础用法
421
+ * const userStore = manager.get<UserState>('user')
422
+ * if (userStore) {
423
+ * console.log(userStore.state.name)
424
+ * }
425
+ *
426
+ * // 获取带 workerId 前缀的 Store
427
+ * const store = manager.get<DemoTaskAttributes>(`${workerId}:DemoTaskAttributes`)
428
+ * ```
429
+ */
430
+ get<T extends Record<string, any>>(id: string): Store<T> | undefined;
431
+ /**
432
+ * 移除指定 ID 的 Store
433
+ *
434
+ * @param id - Store 的唯一标识符
435
+ * @returns 如果移除成功返回 true,否则返回 false
436
+ *
437
+ * @description
438
+ * 从管理器中移除指定的 Store 实例。
439
+ * 注意:移除后 Store 实例本身仍然可用,只是不再被管理器追踪。
440
+ *
441
+ * @example
442
+ * ```typescript
443
+ * // 基础用法
444
+ * const removed = manager.remove('user')
445
+ * console.log(removed) // true 或 false
446
+ *
447
+ * // 移除带 workerId 前缀的 Store
448
+ * manager.remove(`${workerId}:DemoTaskAttributes`)
449
+ * ```
450
+ */
451
+ remove(id: string): boolean;
452
+ /**
453
+ * 清空所有已注册的 Store
454
+ *
455
+ * @description
456
+ * 移除管理器中的所有 Store 实例。
457
+ * 注意:已创建的 Store 实例本身仍然可用,只是不再被管理器追踪。
458
+ *
459
+ * @example
460
+ * ```typescript
461
+ * manager.clear()
462
+ * console.log(manager.getAllIds()) // []
463
+ * ```
464
+ */
465
+ clear(): void;
466
+ /**
467
+ * 获取所有已注册的 Store ID 列表
468
+ *
469
+ * @returns 所有 Store ID 的数组
470
+ *
471
+ * @description
472
+ * 返回当前管理器中所有已注册 Store 的 ID。
473
+ *
474
+ * @example
475
+ * ```typescript
476
+ * const ids = manager.getAllIds()
477
+ * console.log(ids) // ['user', 'settings', 'theme']
478
+ * ```
479
+ */
480
+ getAllIds(): string[];
481
+ }
482
+ /**
483
+ * 全局 Store 管理器实例
484
+ *
485
+ * @description
486
+ * 全局单例 Store 管理器,用于在应用中统一管理所有 Store。
487
+ * 可以通过此实例直接调用管理器的所有方法。
488
+ *
489
+ * @example
490
+ * ```typescript
491
+ * import { storeManager } from './storeFactory'
492
+ *
493
+ * // 注册 Store
494
+ * storeManager.register('user', { name: 'John' })
495
+ *
496
+ * // 获取 Store
497
+ * const userStore = storeManager.get('user')
498
+ *
499
+ * // 查看所有已注册的 Store
500
+ * console.log(storeManager.getAllIds())
501
+ * ```
502
+ */
503
+ export declare const storeManager: StoreManager;
504
+ /**
505
+ * 定义并注册一个新的 Store
506
+ *
507
+ * @template T - Store 状态类型
508
+ * @param id - Store 的唯一标识符,支持格式:`${workerId}:${attributeGroup}` 或单独的 `attributeGroup`
509
+ * @param initialState - 初始状态
510
+ * @param options - Store 配置选项
511
+ * @returns Store 实例
512
+ *
513
+ * @description
514
+ * 这是创建 Store 的推荐方式,会自动将 Store 注册到全局管理器中。
515
+ * 类似于 Pinia 的 defineStore API,提供了更便捷的使用体验。
516
+ *
517
+ * id 格式约定:
518
+ * - 格式 `${workerId}:${attributeGroup}`:用于区分不同 app 的同名属性组
519
+ * - 格式 `${attributeGroup}`:向后兼容,直接使用属性组名称
520
+ *
521
+ * @example
522
+ * ```typescript
523
+ * import { defineStore } from './storeFactory'
524
+ *
525
+ * // 定义用户 Store(向后兼容)
526
+ * export const userStore = defineStore('user', {
527
+ * name: 'John',
528
+ * age: 25,
529
+ * email: 'john@example.com'
530
+ * }, {
531
+ * onChange: (newState, oldState) => {
532
+ * console.log('用户信息已更新')
533
+ * }
534
+ * })
535
+ * // userStore.id = 'user'
536
+ * // userStore.attributeGroup = 'user'
537
+ *
538
+ * // 区分不同 app 的同名 Store
539
+ * const store = defineStore(
540
+ * `${workerId}:DemoTaskAttributes`, // id 格式:workerId:attributeGroup
541
+ * initialState,
542
+ * {}
543
+ * )
544
+ * // store.id = 'app1:DemoTaskAttributes'
545
+ * // store.attributeGroup = 'DemoTaskAttributes'
546
+ *
547
+ * // 在组件中使用
548
+ * console.log(userStore.state.name)
549
+ * userStore.setState({ name: 'Jane' })
550
+ * ```
551
+ */
552
+ export declare function defineStore<T extends Record<string, any>>(id: string, initialState: T, options?: StoreOptions<T>): Store<T>;
553
+ /**
554
+ * 获取已注册的 Store 实例
555
+ *
556
+ * @template T - Store 状态类型
557
+ * @param id - Store 的唯一标识符
558
+ * @returns Store 实例,如果不存在则返回 undefined
559
+ *
560
+ * @description
561
+ * 通过 ID 获取已注册的 Store 实例。
562
+ * 类似于 Pinia 的 useStore,适合在不同模块间共享 Store。
563
+ * 如果 Store 不存在,返回 undefined,使用时需要进行存在性检查。
564
+ *
565
+ * @example
566
+ * ```typescript
567
+ * import { useStore } from './storeFactory'
568
+ *
569
+ * // 基础用法
570
+ * const userStore = useStore<UserState>('user')
571
+ *
572
+ * if (userStore) {
573
+ * console.log(userStore.state.name)
574
+ * userStore.setState({ name: 'Alice' })
575
+ * } else {
576
+ * console.error('User store not found')
577
+ * }
578
+ *
579
+ * // 获取带 workerId 前缀的 Store
580
+ * const store = useStore<DemoTaskAttributes>(`${workerId}:DemoTaskAttributes`)
581
+ * ```
582
+ */
583
+ export declare function useStore<T extends Record<string, any>>(id: string): Store<T> | undefined;
584
+ export {};