solely 0.7.0 → 0.8.0

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 (347) hide show
  1. package/README.md +46 -4
  2. package/dist/compiler/index.d.ts +2 -2
  3. package/dist/compiler/ir/buildIR.d.ts +1 -1
  4. package/dist/compiler/ir/index.d.ts +1 -1
  5. package/dist/compiler/parser/index.d.ts +1 -1
  6. package/dist/compiler/parser/parser.d.ts +1 -1
  7. package/dist/components/commands/drawer/index.cjs +1 -1
  8. package/dist/components/commands/drawer/index.d.ts +1 -1
  9. package/dist/components/commands/drawer/index.js +1 -1
  10. package/dist/components/commands/drawer/style.css.cjs +1 -1
  11. package/dist/components/commands/drawer/style.css.js +1 -1
  12. package/dist/components/commands/index.d.ts +12 -12
  13. package/dist/components/commands/message/index.cjs +1 -1
  14. package/dist/components/commands/message/index.d.ts +1 -1
  15. package/dist/components/commands/message/index.js +1 -1
  16. package/dist/components/commands/message/style.css.cjs +1 -1
  17. package/dist/components/commands/message/style.css.js +1 -1
  18. package/dist/components/commands/message/types.d.ts +1 -1
  19. package/dist/components/commands/modal/index.cjs +1 -1
  20. package/dist/components/commands/modal/index.d.ts +1 -1
  21. package/dist/components/commands/modal/index.js +1 -1
  22. package/dist/components/commands/modal/style.css.cjs +1 -1
  23. package/dist/components/commands/modal/style.css.js +1 -1
  24. package/dist/components/commands/modal/types.d.ts +8 -3
  25. package/dist/components/commands/popconfirm/index.cjs +1 -1
  26. package/dist/components/commands/popconfirm/index.d.ts +1 -1
  27. package/dist/components/commands/popconfirm/index.js +1 -1
  28. package/dist/components/commands/popconfirm/style.css.cjs +1 -1
  29. package/dist/components/commands/popconfirm/style.css.js +1 -1
  30. package/dist/components/commands/popconfirm/types.d.ts +10 -3
  31. package/dist/components/commands/tooltip/index.cjs +1 -1
  32. package/dist/components/commands/tooltip/index.d.ts +1 -1
  33. package/dist/components/commands/tooltip/index.js +1 -1
  34. package/dist/components/commands/tooltip/style.css.cjs +1 -1
  35. package/dist/components/commands/tooltip/style.css.js +1 -1
  36. package/dist/components/commands/tooltip/types.d.ts +1 -3
  37. package/dist/components/commands/utils.cjs +1 -1
  38. package/dist/components/commands/utils.d.ts +11 -0
  39. package/dist/components/commands/utils.js +1 -1
  40. package/dist/components/elements/alert/index.cjs +1 -1
  41. package/dist/components/elements/alert/index.d.ts +68 -6
  42. package/dist/components/elements/alert/index.html.cjs +1 -1
  43. package/dist/components/elements/alert/index.html.js +1 -1
  44. package/dist/components/elements/alert/index.js +1 -1
  45. package/dist/components/elements/alert/style.css.cjs +1 -1
  46. package/dist/components/elements/alert/style.css.js +1 -1
  47. package/dist/components/elements/alert/types.d.ts +5 -1
  48. package/dist/components/elements/backtop/index.cjs +1 -1
  49. package/dist/components/elements/backtop/index.d.ts +14 -2
  50. package/dist/components/elements/backtop/index.html.cjs +1 -1
  51. package/dist/components/elements/backtop/index.html.js +1 -1
  52. package/dist/components/elements/backtop/index.js +1 -1
  53. package/dist/components/elements/backtop/style.css.cjs +1 -1
  54. package/dist/components/elements/backtop/style.css.js +1 -1
  55. package/dist/components/elements/badge/index.cjs +1 -1
  56. package/dist/components/elements/badge/index.d.ts +12 -6
  57. package/dist/components/elements/badge/index.html.cjs +1 -1
  58. package/dist/components/elements/badge/index.html.js +1 -1
  59. package/dist/components/elements/badge/index.js +1 -1
  60. package/dist/components/elements/badge/types.d.ts +2 -4
  61. package/dist/components/elements/breadcrumb/index.cjs +1 -1
  62. package/dist/components/elements/breadcrumb/index.d.ts +13 -3
  63. package/dist/components/elements/breadcrumb/index.html.cjs +1 -1
  64. package/dist/components/elements/breadcrumb/index.html.js +1 -1
  65. package/dist/components/elements/breadcrumb/index.js +1 -1
  66. package/dist/components/elements/breadcrumb/style.css.cjs +1 -1
  67. package/dist/components/elements/breadcrumb/style.css.js +1 -1
  68. package/dist/components/elements/breadcrumb/types.d.ts +2 -0
  69. package/dist/components/elements/button/index.cjs +1 -1
  70. package/dist/components/elements/button/index.d.ts +14 -2
  71. package/dist/components/elements/button/index.html.cjs +1 -1
  72. package/dist/components/elements/button/index.html.js +1 -1
  73. package/dist/components/elements/button/index.js +1 -1
  74. package/dist/components/elements/button/style.css.cjs +1 -1
  75. package/dist/components/elements/button/style.css.js +1 -1
  76. package/dist/components/elements/button/types.d.ts +4 -0
  77. package/dist/components/elements/card/index.cjs +1 -1
  78. package/dist/components/elements/card/index.d.ts +22 -2
  79. package/dist/components/elements/card/index.html.cjs +1 -1
  80. package/dist/components/elements/card/index.html.js +1 -1
  81. package/dist/components/elements/card/index.js +1 -1
  82. package/dist/components/elements/card/style.css.cjs +1 -1
  83. package/dist/components/elements/card/style.css.js +1 -1
  84. package/dist/components/elements/card/types.d.ts +4 -2
  85. package/dist/components/elements/checkbox/index.cjs +1 -1
  86. package/dist/components/elements/checkbox/index.d.ts +56 -3
  87. package/dist/components/elements/checkbox/index.html.cjs +1 -1
  88. package/dist/components/elements/checkbox/index.html.js +1 -1
  89. package/dist/components/elements/checkbox/index.js +1 -1
  90. package/dist/components/elements/checkbox/style.css.cjs +1 -1
  91. package/dist/components/elements/checkbox/style.css.js +1 -1
  92. package/dist/components/elements/checkbox/types.d.ts +10 -0
  93. package/dist/components/elements/coordinate-input/index.cjs +1 -1
  94. package/dist/components/elements/coordinate-input/index.d.ts +27 -2
  95. package/dist/components/elements/coordinate-input/index.html.cjs +1 -1
  96. package/dist/components/elements/coordinate-input/index.html.js +1 -1
  97. package/dist/components/elements/coordinate-input/index.js +1 -1
  98. package/dist/components/elements/coordinate-input/style.css.cjs +1 -1
  99. package/dist/components/elements/coordinate-input/style.css.js +1 -1
  100. package/dist/components/elements/coordinate-input/types.d.ts +4 -4
  101. package/dist/components/elements/divider/index.cjs +1 -1
  102. package/dist/components/elements/divider/index.d.ts +11 -2
  103. package/dist/components/elements/divider/index.js +1 -1
  104. package/dist/components/elements/empty/index.cjs +1 -1
  105. package/dist/components/elements/empty/index.d.ts +14 -2
  106. package/dist/components/elements/empty/index.html.cjs +1 -1
  107. package/dist/components/elements/empty/index.html.js +1 -1
  108. package/dist/components/elements/empty/index.js +1 -1
  109. package/dist/components/elements/empty/style.css.cjs +1 -1
  110. package/dist/components/elements/empty/style.css.js +1 -1
  111. package/dist/components/elements/empty/types.d.ts +4 -2
  112. package/dist/components/elements/fab/index.cjs +1 -1
  113. package/dist/components/elements/fab/index.d.ts +12 -3
  114. package/dist/components/elements/fab/index.html.cjs +1 -1
  115. package/dist/components/elements/fab/index.html.js +1 -1
  116. package/dist/components/elements/fab/index.js +1 -1
  117. package/dist/components/elements/fab/style.css.cjs +1 -1
  118. package/dist/components/elements/fab/style.css.js +1 -1
  119. package/dist/components/elements/icon/index.cjs +1 -1
  120. package/dist/components/elements/icon/index.d.ts +23 -2
  121. package/dist/components/elements/icon/index.js +1 -1
  122. package/dist/components/elements/icon/style.css.cjs +1 -1
  123. package/dist/components/elements/icon/style.css.js +1 -1
  124. package/dist/components/elements/index.cjs +1 -1
  125. package/dist/components/elements/index.d.ts +61 -60
  126. package/dist/components/elements/index.js +1 -1
  127. package/dist/components/elements/input/index.cjs +1 -1
  128. package/dist/components/elements/input/index.d.ts +120 -5
  129. package/dist/components/elements/input/index.html.cjs +1 -1
  130. package/dist/components/elements/input/index.html.js +1 -1
  131. package/dist/components/elements/input/index.js +1 -1
  132. package/dist/components/elements/input/style.css.cjs +1 -1
  133. package/dist/components/elements/input/style.css.js +1 -1
  134. package/dist/components/elements/input/types.d.ts +46 -7
  135. package/dist/components/elements/not-found/index.cjs +1 -1
  136. package/dist/components/elements/not-found/index.d.ts +38 -2
  137. package/dist/components/elements/not-found/index.html.cjs +1 -1
  138. package/dist/components/elements/not-found/index.html.js +1 -1
  139. package/dist/components/elements/not-found/index.js +1 -1
  140. package/dist/components/elements/not-found/style.css.cjs +1 -1
  141. package/dist/components/elements/not-found/style.css.js +1 -1
  142. package/dist/components/elements/not-found/types.d.ts +2 -0
  143. package/dist/components/elements/pagination/index.cjs +1 -1
  144. package/dist/components/elements/pagination/index.d.ts +52 -7
  145. package/dist/components/elements/pagination/index.html.cjs +1 -1
  146. package/dist/components/elements/pagination/index.html.js +1 -1
  147. package/dist/components/elements/pagination/index.js +1 -1
  148. package/dist/components/elements/pagination/style.css.cjs +1 -1
  149. package/dist/components/elements/pagination/style.css.js +1 -1
  150. package/dist/components/elements/pagination/types.d.ts +1 -1
  151. package/dist/components/elements/progress/index.cjs +1 -1
  152. package/dist/components/elements/progress/index.d.ts +16 -7
  153. package/dist/components/elements/progress/index.html.cjs +1 -1
  154. package/dist/components/elements/progress/index.html.js +1 -1
  155. package/dist/components/elements/progress/index.js +1 -1
  156. package/dist/components/elements/progress/style.css.cjs +1 -1
  157. package/dist/components/elements/progress/style.css.js +1 -1
  158. package/dist/components/elements/progress/types.d.ts +4 -2
  159. package/dist/components/elements/radio/index.cjs +1 -1
  160. package/dist/components/elements/radio/index.d.ts +82 -3
  161. package/dist/components/elements/radio/index.html.cjs +1 -1
  162. package/dist/components/elements/radio/index.html.js +1 -1
  163. package/dist/components/elements/radio/index.js +1 -1
  164. package/dist/components/elements/radio/style.css.cjs +1 -1
  165. package/dist/components/elements/radio/style.css.js +1 -1
  166. package/dist/components/elements/radio/types.d.ts +6 -0
  167. package/dist/components/elements/rate/index.cjs +1 -1
  168. package/dist/components/elements/rate/index.d.ts +75 -3
  169. package/dist/components/elements/rate/index.html.cjs +1 -1
  170. package/dist/components/elements/rate/index.html.js +1 -1
  171. package/dist/components/elements/rate/index.js +1 -1
  172. package/dist/components/elements/rate/style.css.cjs +1 -1
  173. package/dist/components/elements/rate/style.css.js +1 -1
  174. package/dist/components/elements/rate/types.d.ts +2 -0
  175. package/dist/components/elements/select/index.cjs +1 -1
  176. package/dist/components/elements/select/index.d.ts +197 -22
  177. package/dist/components/elements/select/index.html.cjs +1 -1
  178. package/dist/components/elements/select/index.html.js +1 -1
  179. package/dist/components/elements/select/index.js +1 -1
  180. package/dist/components/elements/select/option.cjs +1 -0
  181. package/dist/components/elements/select/option.d.ts +2 -2
  182. package/dist/components/elements/select/option.js +1 -0
  183. package/dist/components/elements/select/style.css.cjs +1 -1
  184. package/dist/components/elements/select/style.css.js +1 -1
  185. package/dist/components/elements/select/types.d.ts +42 -6
  186. package/dist/components/elements/skeleton/index.cjs +1 -1
  187. package/dist/components/elements/skeleton/index.d.ts +15 -2
  188. package/dist/components/elements/skeleton/index.html.cjs +1 -1
  189. package/dist/components/elements/skeleton/index.html.js +1 -1
  190. package/dist/components/elements/skeleton/index.js +1 -1
  191. package/dist/components/elements/skeleton/style.css.cjs +1 -1
  192. package/dist/components/elements/skeleton/style.css.js +1 -1
  193. package/dist/components/elements/skeleton/types.d.ts +2 -1
  194. package/dist/components/elements/slider/index.cjs +1 -1
  195. package/dist/components/elements/slider/index.d.ts +115 -11
  196. package/dist/components/elements/slider/index.html.cjs +1 -1
  197. package/dist/components/elements/slider/index.html.js +1 -1
  198. package/dist/components/elements/slider/index.js +1 -1
  199. package/dist/components/elements/slider/style.css.cjs +1 -1
  200. package/dist/components/elements/slider/style.css.js +1 -1
  201. package/dist/components/elements/slider/types.d.ts +15 -4
  202. package/dist/components/elements/steps/index.cjs +1 -1
  203. package/dist/components/elements/steps/index.d.ts +73 -10
  204. package/dist/components/elements/steps/index.html.cjs +1 -1
  205. package/dist/components/elements/steps/index.html.js +1 -1
  206. package/dist/components/elements/steps/index.js +1 -1
  207. package/dist/components/elements/steps/style.css.cjs +1 -1
  208. package/dist/components/elements/steps/style.css.js +1 -1
  209. package/dist/components/elements/steps/types.d.ts +9 -2
  210. package/dist/components/elements/switch/index.cjs +1 -1
  211. package/dist/components/elements/switch/index.d.ts +52 -9
  212. package/dist/components/elements/switch/index.html.cjs +1 -1
  213. package/dist/components/elements/switch/index.html.js +1 -1
  214. package/dist/components/elements/switch/index.js +1 -1
  215. package/dist/components/elements/switch/types.d.ts +12 -0
  216. package/dist/components/elements/table/index.cjs +1 -1
  217. package/dist/components/elements/table/index.d.ts +251 -4
  218. package/dist/components/elements/table/index.html.cjs +1 -1
  219. package/dist/components/elements/table/index.html.js +1 -1
  220. package/dist/components/elements/table/index.js +1 -1
  221. package/dist/components/elements/table/style.css.cjs +1 -1
  222. package/dist/components/elements/table/style.css.js +1 -1
  223. package/dist/components/elements/table/types.d.ts +152 -7
  224. package/dist/components/elements/tabs/index.cjs +1 -1
  225. package/dist/components/elements/tabs/index.d.ts +47 -4
  226. package/dist/components/elements/tabs/index.html.cjs +1 -1
  227. package/dist/components/elements/tabs/index.html.js +1 -1
  228. package/dist/components/elements/tabs/index.js +1 -1
  229. package/dist/components/elements/tabs/style.css.cjs +1 -1
  230. package/dist/components/elements/tabs/style.css.js +1 -1
  231. package/dist/components/elements/tabs/types.d.ts +10 -0
  232. package/dist/components/elements/tag/index.cjs +1 -1
  233. package/dist/components/elements/tag/index.d.ts +11 -3
  234. package/dist/components/elements/tag/index.html.cjs +1 -1
  235. package/dist/components/elements/tag/index.html.js +1 -1
  236. package/dist/components/elements/tag/index.js +1 -1
  237. package/dist/components/elements/tag/style.css.cjs +1 -1
  238. package/dist/components/elements/tag/style.css.js +1 -1
  239. package/dist/components/elements/timeline/index.cjs +1 -1
  240. package/dist/components/elements/timeline/index.d.ts +8 -2
  241. package/dist/components/elements/timeline/index.js +1 -1
  242. package/dist/components/elements/timeline/style.css.cjs +1 -1
  243. package/dist/components/elements/timeline/style.css.js +1 -1
  244. package/dist/components/elements/timeline/types.d.ts +0 -1
  245. package/dist/components/elements/tooltip/index.cjs +1 -1
  246. package/dist/components/elements/tooltip/index.d.ts +78 -5
  247. package/dist/components/elements/tooltip/index.html.cjs +1 -1
  248. package/dist/components/elements/tooltip/index.html.js +1 -1
  249. package/dist/components/elements/tooltip/index.js +1 -1
  250. package/dist/components/elements/tooltip/style.css.cjs +1 -1
  251. package/dist/components/elements/tooltip/style.css.js +1 -1
  252. package/dist/components/elements/tooltip/types.d.ts +1 -1
  253. package/dist/components/elements/tree/index.cjs +1 -1
  254. package/dist/components/elements/tree/index.d.ts +163 -13
  255. package/dist/components/elements/tree/index.html.cjs +1 -1
  256. package/dist/components/elements/tree/index.html.js +1 -1
  257. package/dist/components/elements/tree/index.js +1 -1
  258. package/dist/components/elements/tree/style.css.cjs +1 -1
  259. package/dist/components/elements/tree/style.css.js +1 -1
  260. package/dist/components/elements/tree/types.d.ts +18 -4
  261. package/dist/components/elements/upload/index.cjs +1 -1
  262. package/dist/components/elements/upload/index.d.ts +59 -8
  263. package/dist/components/elements/upload/index.html.cjs +1 -1
  264. package/dist/components/elements/upload/index.html.js +1 -1
  265. package/dist/components/elements/upload/index.js +1 -1
  266. package/dist/components/elements/upload/style.css.cjs +1 -1
  267. package/dist/components/elements/upload/style.css.js +1 -1
  268. package/dist/components/elements/upload/types.d.ts +89 -5
  269. package/dist/components/elements/utils/helpers.cjs +1 -1
  270. package/dist/components/elements/utils/helpers.d.ts +10 -0
  271. package/dist/components/elements/utils/helpers.js +1 -1
  272. package/dist/components/index.cjs +1 -1
  273. package/dist/components/index.d.ts +3 -21
  274. package/dist/components/index.js +1 -1
  275. package/dist/components/theme/auto-inject.cjs +1 -0
  276. package/dist/components/theme/auto-inject.d.ts +23 -0
  277. package/dist/components/theme/auto-inject.js +1 -0
  278. package/dist/components/theme/index.cjs +1 -1
  279. package/dist/components/theme/index.d.ts +7 -1
  280. package/dist/components/theme/index.js +1 -1
  281. package/dist/components/theme/variables.css +25 -0
  282. package/dist/components/theme/variables.css.cjs +1 -0
  283. package/dist/components/theme/variables.css.js +1 -0
  284. package/dist/index.cjs +1 -1
  285. package/dist/index.d.ts +5 -5
  286. package/dist/index.js +1 -1
  287. package/dist/plugin.d.ts +2 -2
  288. package/dist/plugins/index.d.ts +2 -2
  289. package/dist/plugins/solely-vite-plugin.d.ts +1 -1
  290. package/dist/router/core.cjs +1 -1
  291. package/dist/router/core.d.ts +31 -1
  292. package/dist/router/core.js +1 -1
  293. package/dist/router/index.d.ts +4 -4
  294. package/dist/router/router-link.d.ts +1 -1
  295. package/dist/router/router-view.cjs +1 -1
  296. package/dist/router/router-view.d.ts +12 -2
  297. package/dist/router/router-view.js +1 -1
  298. package/dist/router/types.d.ts +3 -1
  299. package/dist/runtime/component/base-element.cjs +1 -1
  300. package/dist/runtime/component/base-element.d.ts +7 -0
  301. package/dist/runtime/component/base-element.js +1 -1
  302. package/dist/runtime/component/decorators.d.ts +7 -2
  303. package/dist/runtime/component/index.d.ts +2 -2
  304. package/dist/runtime/index.d.ts +3 -3
  305. package/dist/runtime/reactivity/computed.d.ts +1 -1
  306. package/dist/runtime/reactivity/index.d.ts +6 -6
  307. package/dist/runtime/reactivity/watch.d.ts +1 -1
  308. package/dist/runtime/renderer/index.d.ts +2 -2
  309. package/dist/runtime/renderer/renderIR.cjs +1 -1
  310. package/dist/runtime/renderer/renderIR.d.ts +1 -1
  311. package/dist/runtime/renderer/renderIR.js +1 -1
  312. package/dist/shared/aria.cjs +1 -0
  313. package/dist/shared/aria.d.ts +67 -0
  314. package/dist/shared/aria.js +1 -0
  315. package/dist/shared/boolean.cjs +1 -0
  316. package/dist/shared/boolean.d.ts +9 -0
  317. package/dist/shared/boolean.js +1 -0
  318. package/dist/shared/enum.cjs +1 -0
  319. package/dist/shared/enum.d.ts +10 -0
  320. package/dist/shared/enum.js +1 -0
  321. package/dist/shared/env.cjs +1 -1
  322. package/dist/shared/env.js +1 -1
  323. package/dist/shared/floating/overlay-stack.cjs +1 -0
  324. package/dist/shared/floating/overlay-stack.d.ts +56 -0
  325. package/dist/shared/floating/overlay-stack.js +1 -0
  326. package/dist/shared/floating/position.cjs +1 -0
  327. package/dist/shared/floating/position.d.ts +32 -0
  328. package/dist/shared/floating/position.js +1 -0
  329. package/dist/shared/floating/types.d.ts +112 -0
  330. package/dist/shared/form-associated.cjs +1 -0
  331. package/dist/shared/form-associated.d.ts +253 -0
  332. package/dist/shared/form-associated.js +1 -0
  333. package/dist/shared/gen-function.d.ts +1 -1
  334. package/dist/shared/icons.cjs +1 -0
  335. package/dist/shared/icons.d.ts +31 -0
  336. package/dist/shared/icons.js +1 -0
  337. package/dist/shared/index.cjs +1 -1
  338. package/dist/shared/index.d.ts +11 -9
  339. package/dist/shared/index.js +1 -1
  340. package/dist/shared/size.cjs +1 -0
  341. package/dist/shared/size.d.ts +17 -0
  342. package/dist/shared/size.js +1 -0
  343. package/dist/shared/templateError.d.ts +1 -1
  344. package/dist/types/index.d.ts +4 -4
  345. package/dist/types/ir.d.ts +1 -1
  346. package/package.json +27 -11
  347. package/dist/solely.svg +0 -1
@@ -12,6 +12,11 @@ export interface ThemeConfig {
12
12
  theme: 'light' | 'dark';
13
13
  colors?: Partial<Theme>;
14
14
  }
15
+ /**
16
+ * 由基础色派生 hover / active / light 三档色。
17
+ * 无法解析的颜色(颜色名、var()、渐变等)直接跳过,不覆盖用户已设置的值。
18
+ */
19
+ export declare function deriveColorTokens(colors: Partial<Theme>): Record<string, string>;
15
20
  /**
16
21
  * 设置主题
17
22
  * @param config 主题配置
@@ -28,7 +33,8 @@ export declare function getTheme(): ThemeConfig;
28
33
  export declare function toggleTheme(): void;
29
34
  /**
30
35
  * 初始化主题
31
- * 从 localStorage 读取或根据系统偏好设置
36
+ * 优先级:用户保存的设置 > 系统偏好(仅作为首次初始化的默认值) > 默认浅色
37
+ * 注意:这里只在初始化时读取一次系统偏好,不会持续监听系统主题变化
32
38
  */
33
39
  export declare function initTheme(): void;
34
40
  /**
@@ -1 +1 @@
1
- let e={theme:"light"};function t(t){if(e={...e,...t},document.documentElement.setAttribute("data-theme",t.theme),t.colors){const e=document.documentElement;Object.entries(t.colors).forEach(([t,o])=>{e.style.setProperty(`--solely-${t}`,o??"")})}}function o(){return{...e}}function n(){const o="light"===e.theme?"dark":"light";t({...e,theme:o})}function r(){const e=localStorage.getItem("solely-theme");if(e)try{return void t(JSON.parse(e))}catch{}t({theme:window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light"})}function c(){window.addEventListener("beforeunload",()=>{localStorage.setItem("solely-theme",JSON.stringify(e))})}"undefined"!=typeof window&&(r(),c());const i={setTheme:t,getTheme:o,toggleTheme:n,initTheme:r,persistTheme:c};export{i as default,o as getTheme,r as initTheme,c as persistTheme,t as setTheme,n as toggleTheme};
1
+ let e={theme:"light"};const t={r:255,g:255,b:255},n={r:0,g:0,b:0};function o(e){const t=e.trim(),n=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(t);if(n){const e=n[1],t=3===e.length?`${e[0]}${e[0]}${e[1]}${e[1]}${e[2]}${e[2]}`:e;return{r:parseInt(t.slice(0,2),16),g:parseInt(t.slice(2,4),16),b:parseInt(t.slice(4,6),16)}}const o=/^rgba?\(\s*([\d.]+)[,\s]+([\d.]+)[,\s]+([\d.]+)/i.exec(t);if(o){const e=e=>Math.max(0,Math.min(255,Math.round(e)));return{r:e(Number(o[1])),g:e(Number(o[2])),b:e(Number(o[3]))}}return null}function r(e,t,n){const o=(e,t)=>Math.round(e+(t-e)*n).toString(16).padStart(2,"0");return`#${o(e.r,t.r)}${o(e.g,t.g)}${o(e.b,t.b)}`}function c(e){const c={};for(const[i,s]of Object.entries(e)){if(!s)continue;const e=o(s);e&&(c[`${i}-light`]=r(e,t,.9),c[`${i}-hover`]=r(e,t,.2),c[`${i}-active`]=r(e,n,.15))}return c}function i(t){if(e={...e,...t},"undefined"!=typeof document&&document.documentElement&&(document.documentElement.setAttribute("data-theme",t.theme),t.colors)){const e=document.documentElement;Object.entries(c(t.colors)).forEach(([t,n])=>{e.style.setProperty(`--solely-${t}`,n)}),Object.entries(t.colors).forEach(([t,n])=>{e.style.setProperty(`--solely-${t}`,n??"")})}}function s(){return{...e}}function l(){const t="light"===e.theme?"dark":"light";i({...e,theme:t})}function d(){const e=function(){try{const e="undefined"!=typeof window?window.localStorage:void 0,t=e?.getItem("solely-theme");if(!t)return null;const n=JSON.parse(t);if(!n||"object"!=typeof n)return null;const{theme:o,colors:r}=n;return"light"!==o&&"dark"!==o?null:void 0===r||null!==r&&"object"==typeof r?void 0===r?{theme:o}:{theme:o,colors:r}:null}catch{return null}}();if(e)return void i(e);let t=!1;try{t="undefined"!=typeof window&&"function"==typeof window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches}catch{t=!1}i({theme:t?"dark":"light"})}function u(){"undefined"!=typeof window&&"function"==typeof window.addEventListener&&window.addEventListener("beforeunload",()=>{try{window.localStorage.setItem("solely-theme",JSON.stringify(e))}catch{}})}"undefined"!=typeof window&&(d(),u());const f={setTheme:i,getTheme:s,toggleTheme:l,initTheme:d,persistTheme:u};export{f as default,c as deriveColorTokens,s as getTheme,d as initTheme,u as persistTheme,i as setTheme,l as toggleTheme};
@@ -116,6 +116,13 @@
116
116
  --solely-shadow-2xl: 0 16px 48px rgba(0, 0, 0, 0.24);
117
117
  --solely-shadow-primary: 0 0 0 4px rgba(24, 144, 255, 0.2);
118
118
 
119
+ /* 品牌/功能色光晕阴影(带颜色的投影,用于按钮、图标等本身有色的元素) */
120
+ --solely-shadow-primary-glow-sm: 0 2px 8px rgba(24, 144, 255, 0.25);
121
+ --solely-shadow-primary-glow-md: 0 4px 16px rgba(24, 144, 255, 0.3);
122
+ --solely-shadow-primary-glow-lg: 0 6px 24px rgba(24, 144, 255, 0.4);
123
+ --solely-shadow-error-glow-sm: 0 4px 16px rgba(238, 90, 111, 0.2);
124
+ --solely-shadow-error-glow-lg: 0 8px 32px rgba(238, 90, 111, 0.3);
125
+
119
126
  /* ==================== 字体 - 统一命名 xs/sm/md/lg/xl/2xl ==================== */
120
127
  --solely-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
121
128
  --solely-font-size-xs: 10px;
@@ -148,6 +155,10 @@
148
155
  --solely-height-lg: 40px;
149
156
  --solely-height-xl: 48px;
150
157
 
158
+ /* ==================== 控件默认尺寸 ==================== */
159
+ /* 输入框默认宽度:宽度基准固定在宿主上,内部清空/复制/密码等按钮的显示不影响整体宽度 */
160
+ --solely-input-width: 220px;
161
+
151
162
  /* ==================== 过渡 ==================== */
152
163
  --solely-transition-duration: 0.3s;
153
164
  --solely-transition-duration-fast: 0.15s;
@@ -169,6 +180,13 @@
169
180
  --solely-focus-ring-warning: 0 0 0 2px var(--solely-warning-light);
170
181
  --solely-focus-ring-success: 0 0 0 2px var(--solely-success-light);
171
182
 
183
+ /* 键盘焦点环(outline 方案,供 :focus-visible 引用)
184
+ 颜色与宽度是默认值;需要外扩/内嵌的组件可局部覆盖 --solely-focus-ring-offset。
185
+ 颜色引用 --solely-primary,暗色主题下会随之解析,无需重复声明。 */
186
+ --solely-focus-ring-width: 2px;
187
+ --solely-focus-ring-color: var(--solely-primary);
188
+ --solely-focus-ring-offset: 2px;
189
+
172
190
  /* ==================== 品牌渐变 ==================== */
173
191
  --solely-gradient-brand: linear-gradient(135deg, #1890ff 0%, #096dd9 100%);
174
192
  --solely-gradient-brand-soft: linear-gradient(135deg, #e6f7ff 0%, #bae7ff 100%);
@@ -322,4 +340,11 @@
322
340
  --solely-shadow-xl: 0 12px 32px rgba(0, 0, 0, 0.45);
323
341
  --solely-shadow-2xl: 0 16px 48px rgba(0, 0, 0, 0.5);
324
342
  --solely-shadow-primary: 0 0 0 4px rgba(23, 125, 220, 0.25);
343
+
344
+ /* 品牌/功能色光晕阴影(暗色背景需要更高浓度才可见) */
345
+ --solely-shadow-primary-glow-sm: 0 2px 8px rgba(23, 125, 220, 0.4);
346
+ --solely-shadow-primary-glow-md: 0 4px 16px rgba(23, 125, 220, 0.45);
347
+ --solely-shadow-primary-glow-lg: 0 6px 24px rgba(23, 125, 220, 0.6);
348
+ --solely-shadow-error-glow-sm: 0 4px 16px rgba(211, 32, 41, 0.35);
349
+ --solely-shadow-error-glow-lg: 0 8px 32px rgba(211, 32, 41, 0.5);
325
350
  }
@@ -0,0 +1 @@
1
+ "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}}),exports.default=':root{--solely-primary: #1890ff;--solely-primary-hover: #40a9ff;--solely-primary-active: #096dd9;--solely-primary-light: #e6f7ff;--solely-secondary: #722ed1;--solely-secondary-hover: #9254de;--solely-secondary-active: #531dab;--solely-secondary-light: #f9f0ff;--solely-success: #52c41a;--solely-success-hover: #73d13d;--solely-success-active: #389e0d;--solely-success-light: #f6ffed;--solely-warning: #faad14;--solely-warning-hover: #ffc53d;--solely-warning-active: #d48806;--solely-warning-light: #fffbe6;--solely-error: #ff4d4f;--solely-error-hover: #ff7875;--solely-error-active: #cf1322;--solely-error-light: #fff2f0;--solely-info: #1890ff;--solely-info-hover: #40a9ff;--solely-info-active: #096dd9;--solely-info-light: #e6f7ff;--solely-cyan: #13c2c2;--solely-cyan-hover: #36cfc9;--solely-cyan-active: #08979c;--solely-cyan-light: #e6fffb;--solely-purple: #722ed1;--solely-purple-hover: #9254de;--solely-purple-active: #531dab;--solely-purple-light: #f9f0ff;--solely-pink: #eb2f96;--solely-pink-hover: #f759ab;--solely-pink-active: #c41d7f;--solely-pink-light: #fff0f6;--solely-orange: #fa8c16;--solely-orange-hover: #ffa940;--solely-orange-active: #d46b08;--solely-orange-light: #fff7e6;--solely-black: #000000;--solely-white: #ffffff;--solely-gray-1: #ffffff;--solely-gray-2: #fafafa;--solely-gray-3: #f5f5f5;--solely-gray-4: #f0f0f0;--solely-gray-5: #d9d9d9;--solely-gray-6: #bfbfbf;--solely-gray-7: #8c8c8c;--solely-gray-8: #595959;--solely-gray-9: #434343;--solely-gray-10: #262626;--solely-gray-11: #1f1f1f;--solely-gray-12: #141414;--solely-gray-13: #000000;--solely-text-primary: rgba(0, 0, 0, .85);--solely-text-secondary: rgba(0, 0, 0, .65);--solely-text-tertiary: rgba(0, 0, 0, .45);--solely-text-quaternary: rgba(0, 0, 0, .25);--solely-border-color: #d9d9d9;--solely-border-color-split: #f0f0f0;--solely-bg-color: #f0f2f5;--solely-bg-color-light: #fafafa;--solely-bg-color-dark: #1f1f1f;--solely-component-bg: #ffffff;--solely-component-bg-hover: #f5f5f5;--solely-fill-color: #e8e8e8;--solely-fill-color-light: #f5f5f5;--solely-inverted-bg: rgba(0, 0, 0, .75);--solely-inverted-text: var(--solely-white);--solely-border-radius-sm: 2px;--solely-border-radius-md: 4px;--solely-border-radius-lg: 8px;--solely-border-radius-xl: 12px;--solely-border-radius-full: 9999px;--solely-border-radius-circle: 50%;--solely-shadow-sm: 0 2px 8px rgba(0, 0, 0, .08);--solely-shadow-md: 0 4px 12px rgba(0, 0, 0, .12);--solely-shadow-lg: 0 8px 24px rgba(0, 0, 0, .16);--solely-shadow-xl: 0 12px 32px rgba(0, 0, 0, .2);--solely-shadow-2xl: 0 16px 48px rgba(0, 0, 0, .24);--solely-shadow-primary: 0 0 0 4px rgba(24, 144, 255, .2);--solely-shadow-primary-glow-sm: 0 2px 8px rgba(24, 144, 255, .25);--solely-shadow-primary-glow-md: 0 4px 16px rgba(24, 144, 255, .3);--solely-shadow-primary-glow-lg: 0 6px 24px rgba(24, 144, 255, .4);--solely-shadow-error-glow-sm: 0 4px 16px rgba(238, 90, 111, .2);--solely-shadow-error-glow-lg: 0 8px 32px rgba(238, 90, 111, .3);--solely-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--solely-font-size-xs: 10px;--solely-font-size-sm: 12px;--solely-font-size-md: 14px;--solely-font-size-lg: 16px;--solely-font-size-xl: 18px;--solely-font-size-2xl: 20px;--solely-font-size-3xl: 24px;--solely-font-size-4xl: 30px;--solely-font-size-5xl: 38px;--solely-line-height-sm: 1.25;--solely-line-height-md: 1.5;--solely-line-height-lg: 1.75;--solely-spacing-xs: 4px;--solely-spacing-sm: 8px;--solely-spacing-md: 12px;--solely-spacing-lg: 16px;--solely-spacing-xl: 24px;--solely-spacing-2xl: 32px;--solely-height-xs: 20px;--solely-height-sm: 24px;--solely-height-md: 32px;--solely-height-lg: 40px;--solely-height-xl: 48px;--solely-input-width: 220px;--solely-transition-duration: .3s;--solely-transition-duration-fast: .15s;--solely-transition-duration-slow: .5s;--solely-transition-timing: cubic-bezier(.4, 0, .2, 1);--solely-disabled-opacity: .6;--solely-success-bg: var(--solely-success-light);--solely-warning-bg: var(--solely-warning-light);--solely-error-bg: var(--solely-error-light);--solely-info-bg: var(--solely-info-light);--solely-focus-ring: 0 0 0 2px var(--solely-primary-light);--solely-focus-ring-error: 0 0 0 2px var(--solely-error-light);--solely-focus-ring-warning: 0 0 0 2px var(--solely-warning-light);--solely-focus-ring-success: 0 0 0 2px var(--solely-success-light);--solely-focus-ring-width: 2px;--solely-focus-ring-color: var(--solely-primary);--solely-focus-ring-offset: 2px;--solely-gradient-brand: linear-gradient(135deg, #1890ff 0%, #096dd9 100%);--solely-gradient-brand-soft: linear-gradient(135deg, #e6f7ff 0%, #bae7ff 100%);--solely-z-index-base: 1;--solely-z-index-dropdown: 1000;--solely-z-index-fixed: 100;--solely-z-index-modal: 1050;--solely-z-index-popover: 1060;--solely-z-index-tooltip: 1070;--solely-z-index-toast: 1100;--solely-z-index-table-fixed: 2;--solely-z-index-table-header: 3;--solely-z-index-switch-handle: 2;--solely-z-index-timeline-dot: 2;--solely-z-index-timeline-tail: 1;--solely-z-index-steps-icon: 1;--solely-z-index-steps-tail: 0;--solely-z-index-slider-handle: 1;--solely-mask-bg: rgba(0, 0, 0, .45);--solely-tooltip-arrow-size: 5px;--solely-popconfirm-arrow-size: 8px}[data-theme=dark]{--solely-primary: #177ddc;--solely-primary-hover: #3c9ae8;--solely-primary-active: #0958d9;--solely-primary-light: rgba(23, 125, 220, .2);--solely-secondary: #9254de;--solely-secondary-hover: #b37feb;--solely-secondary-active: #722ed1;--solely-secondary-light: rgba(146, 84, 222, .2);--solely-success: #49aa19;--solely-success-hover: #6abe39;--solely-success-active: #3c8618;--solely-success-light: rgba(73, 170, 25, .2);--solely-warning: #d89614;--solely-warning-hover: #e8b339;--solely-warning-active: #aa7714;--solely-warning-light: rgba(216, 150, 20, .2);--solely-error: #d32029;--solely-error-hover: #e84749;--solely-error-active: #ad2122;--solely-error-light: rgba(211, 32, 41, .2);--solely-info: #177ddc;--solely-info-hover: #3c9ae8;--solely-info-active: #0958d9;--solely-info-light: rgba(23, 125, 220, .2);--solely-cyan: #13a8a8;--solely-cyan-hover: #36cfc9;--solely-cyan-active: #119595;--solely-cyan-light: rgba(19, 168, 168, .2);--solely-purple: #9254de;--solely-purple-hover: #b37feb;--solely-purple-active: #722ed1;--solely-purple-light: rgba(146, 84, 222, .2);--solely-pink: #c41d7f;--solely-pink-hover: #e0529c;--solely-pink-active: #9e1068;--solely-pink-light: rgba(196, 29, 127, .2);--solely-orange: #d87a16;--solely-orange-hover: #e89a3c;--solely-orange-active: #aa5b15;--solely-orange-light: rgba(216, 122, 22, .2);--solely-text-primary: rgba(255, 255, 255, .85);--solely-text-secondary: rgba(255, 255, 255, .65);--solely-text-tertiary: rgba(255, 255, 255, .45);--solely-text-quaternary: rgba(255, 255, 255, .25);--solely-border-color: #434343;--solely-border-color-split: #303030;--solely-gray-1: #141414;--solely-gray-2: #1f1f1f;--solely-gray-3: #2c2c2c;--solely-gray-4: #303030;--solely-gray-5: #434343;--solely-gray-6: #595959;--solely-gray-7: #8c8c8c;--solely-gray-8: #a6a6a6;--solely-gray-9: #bfbfbf;--solely-gray-10: #d9d9d9;--solely-gray-11: #f0f0f0;--solely-gray-12: #f5f5f5;--solely-gray-13: #ffffff;--solely-bg-color: #141414;--solely-bg-color-light: #1f1f1f;--solely-bg-color-dark: #000000;--solely-component-bg: #1f1f1f;--solely-component-bg-hover: #2c2c2c;--solely-fill-color: #2c2c2c;--solely-fill-color-light: #1f1f1f;--solely-inverted-bg: rgba(255, 255, 255, .9);--solely-inverted-text: var(--solely-black);--solely-mask-bg: rgba(0, 0, 0, .65);--solely-success-bg: var(--solely-success-light);--solely-warning-bg: var(--solely-warning-light);--solely-error-bg: var(--solely-error-light);--solely-info-bg: var(--solely-info-light);--solely-focus-ring: 0 0 0 2px var(--solely-primary-light);--solely-focus-ring-error: 0 0 0 2px var(--solely-error-light);--solely-focus-ring-warning: 0 0 0 2px var(--solely-warning-light);--solely-focus-ring-success: 0 0 0 2px var(--solely-success-light);--solely-gradient-brand: linear-gradient(135deg, #177ddc 0%, #0958d9 100%);--solely-gradient-brand-soft: linear-gradient(135deg, rgba(23, 125, 220, .15) 0%, rgba(9, 88, 217, .15) 100%);--solely-shadow-sm: 0 2px 8px rgba(0, 0, 0, .3);--solely-shadow-md: 0 4px 12px rgba(0, 0, 0, .35);--solely-shadow-lg: 0 8px 24px rgba(0, 0, 0, .4);--solely-shadow-xl: 0 12px 32px rgba(0, 0, 0, .45);--solely-shadow-2xl: 0 16px 48px rgba(0, 0, 0, .5);--solely-shadow-primary: 0 0 0 4px rgba(23, 125, 220, .25);--solely-shadow-primary-glow-sm: 0 2px 8px rgba(23, 125, 220, .4);--solely-shadow-primary-glow-md: 0 4px 16px rgba(23, 125, 220, .45);--solely-shadow-primary-glow-lg: 0 6px 24px rgba(23, 125, 220, .6);--solely-shadow-error-glow-sm: 0 4px 16px rgba(211, 32, 41, .35);--solely-shadow-error-glow-lg: 0 8px 32px rgba(211, 32, 41, .5)}';
@@ -0,0 +1 @@
1
+ const l=':root{--solely-primary: #1890ff;--solely-primary-hover: #40a9ff;--solely-primary-active: #096dd9;--solely-primary-light: #e6f7ff;--solely-secondary: #722ed1;--solely-secondary-hover: #9254de;--solely-secondary-active: #531dab;--solely-secondary-light: #f9f0ff;--solely-success: #52c41a;--solely-success-hover: #73d13d;--solely-success-active: #389e0d;--solely-success-light: #f6ffed;--solely-warning: #faad14;--solely-warning-hover: #ffc53d;--solely-warning-active: #d48806;--solely-warning-light: #fffbe6;--solely-error: #ff4d4f;--solely-error-hover: #ff7875;--solely-error-active: #cf1322;--solely-error-light: #fff2f0;--solely-info: #1890ff;--solely-info-hover: #40a9ff;--solely-info-active: #096dd9;--solely-info-light: #e6f7ff;--solely-cyan: #13c2c2;--solely-cyan-hover: #36cfc9;--solely-cyan-active: #08979c;--solely-cyan-light: #e6fffb;--solely-purple: #722ed1;--solely-purple-hover: #9254de;--solely-purple-active: #531dab;--solely-purple-light: #f9f0ff;--solely-pink: #eb2f96;--solely-pink-hover: #f759ab;--solely-pink-active: #c41d7f;--solely-pink-light: #fff0f6;--solely-orange: #fa8c16;--solely-orange-hover: #ffa940;--solely-orange-active: #d46b08;--solely-orange-light: #fff7e6;--solely-black: #000000;--solely-white: #ffffff;--solely-gray-1: #ffffff;--solely-gray-2: #fafafa;--solely-gray-3: #f5f5f5;--solely-gray-4: #f0f0f0;--solely-gray-5: #d9d9d9;--solely-gray-6: #bfbfbf;--solely-gray-7: #8c8c8c;--solely-gray-8: #595959;--solely-gray-9: #434343;--solely-gray-10: #262626;--solely-gray-11: #1f1f1f;--solely-gray-12: #141414;--solely-gray-13: #000000;--solely-text-primary: rgba(0, 0, 0, .85);--solely-text-secondary: rgba(0, 0, 0, .65);--solely-text-tertiary: rgba(0, 0, 0, .45);--solely-text-quaternary: rgba(0, 0, 0, .25);--solely-border-color: #d9d9d9;--solely-border-color-split: #f0f0f0;--solely-bg-color: #f0f2f5;--solely-bg-color-light: #fafafa;--solely-bg-color-dark: #1f1f1f;--solely-component-bg: #ffffff;--solely-component-bg-hover: #f5f5f5;--solely-fill-color: #e8e8e8;--solely-fill-color-light: #f5f5f5;--solely-inverted-bg: rgba(0, 0, 0, .75);--solely-inverted-text: var(--solely-white);--solely-border-radius-sm: 2px;--solely-border-radius-md: 4px;--solely-border-radius-lg: 8px;--solely-border-radius-xl: 12px;--solely-border-radius-full: 9999px;--solely-border-radius-circle: 50%;--solely-shadow-sm: 0 2px 8px rgba(0, 0, 0, .08);--solely-shadow-md: 0 4px 12px rgba(0, 0, 0, .12);--solely-shadow-lg: 0 8px 24px rgba(0, 0, 0, .16);--solely-shadow-xl: 0 12px 32px rgba(0, 0, 0, .2);--solely-shadow-2xl: 0 16px 48px rgba(0, 0, 0, .24);--solely-shadow-primary: 0 0 0 4px rgba(24, 144, 255, .2);--solely-shadow-primary-glow-sm: 0 2px 8px rgba(24, 144, 255, .25);--solely-shadow-primary-glow-md: 0 4px 16px rgba(24, 144, 255, .3);--solely-shadow-primary-glow-lg: 0 6px 24px rgba(24, 144, 255, .4);--solely-shadow-error-glow-sm: 0 4px 16px rgba(238, 90, 111, .2);--solely-shadow-error-glow-lg: 0 8px 32px rgba(238, 90, 111, .3);--solely-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--solely-font-size-xs: 10px;--solely-font-size-sm: 12px;--solely-font-size-md: 14px;--solely-font-size-lg: 16px;--solely-font-size-xl: 18px;--solely-font-size-2xl: 20px;--solely-font-size-3xl: 24px;--solely-font-size-4xl: 30px;--solely-font-size-5xl: 38px;--solely-line-height-sm: 1.25;--solely-line-height-md: 1.5;--solely-line-height-lg: 1.75;--solely-spacing-xs: 4px;--solely-spacing-sm: 8px;--solely-spacing-md: 12px;--solely-spacing-lg: 16px;--solely-spacing-xl: 24px;--solely-spacing-2xl: 32px;--solely-height-xs: 20px;--solely-height-sm: 24px;--solely-height-md: 32px;--solely-height-lg: 40px;--solely-height-xl: 48px;--solely-input-width: 220px;--solely-transition-duration: .3s;--solely-transition-duration-fast: .15s;--solely-transition-duration-slow: .5s;--solely-transition-timing: cubic-bezier(.4, 0, .2, 1);--solely-disabled-opacity: .6;--solely-success-bg: var(--solely-success-light);--solely-warning-bg: var(--solely-warning-light);--solely-error-bg: var(--solely-error-light);--solely-info-bg: var(--solely-info-light);--solely-focus-ring: 0 0 0 2px var(--solely-primary-light);--solely-focus-ring-error: 0 0 0 2px var(--solely-error-light);--solely-focus-ring-warning: 0 0 0 2px var(--solely-warning-light);--solely-focus-ring-success: 0 0 0 2px var(--solely-success-light);--solely-focus-ring-width: 2px;--solely-focus-ring-color: var(--solely-primary);--solely-focus-ring-offset: 2px;--solely-gradient-brand: linear-gradient(135deg, #1890ff 0%, #096dd9 100%);--solely-gradient-brand-soft: linear-gradient(135deg, #e6f7ff 0%, #bae7ff 100%);--solely-z-index-base: 1;--solely-z-index-dropdown: 1000;--solely-z-index-fixed: 100;--solely-z-index-modal: 1050;--solely-z-index-popover: 1060;--solely-z-index-tooltip: 1070;--solely-z-index-toast: 1100;--solely-z-index-table-fixed: 2;--solely-z-index-table-header: 3;--solely-z-index-switch-handle: 2;--solely-z-index-timeline-dot: 2;--solely-z-index-timeline-tail: 1;--solely-z-index-steps-icon: 1;--solely-z-index-steps-tail: 0;--solely-z-index-slider-handle: 1;--solely-mask-bg: rgba(0, 0, 0, .45);--solely-tooltip-arrow-size: 5px;--solely-popconfirm-arrow-size: 8px}[data-theme=dark]{--solely-primary: #177ddc;--solely-primary-hover: #3c9ae8;--solely-primary-active: #0958d9;--solely-primary-light: rgba(23, 125, 220, .2);--solely-secondary: #9254de;--solely-secondary-hover: #b37feb;--solely-secondary-active: #722ed1;--solely-secondary-light: rgba(146, 84, 222, .2);--solely-success: #49aa19;--solely-success-hover: #6abe39;--solely-success-active: #3c8618;--solely-success-light: rgba(73, 170, 25, .2);--solely-warning: #d89614;--solely-warning-hover: #e8b339;--solely-warning-active: #aa7714;--solely-warning-light: rgba(216, 150, 20, .2);--solely-error: #d32029;--solely-error-hover: #e84749;--solely-error-active: #ad2122;--solely-error-light: rgba(211, 32, 41, .2);--solely-info: #177ddc;--solely-info-hover: #3c9ae8;--solely-info-active: #0958d9;--solely-info-light: rgba(23, 125, 220, .2);--solely-cyan: #13a8a8;--solely-cyan-hover: #36cfc9;--solely-cyan-active: #119595;--solely-cyan-light: rgba(19, 168, 168, .2);--solely-purple: #9254de;--solely-purple-hover: #b37feb;--solely-purple-active: #722ed1;--solely-purple-light: rgba(146, 84, 222, .2);--solely-pink: #c41d7f;--solely-pink-hover: #e0529c;--solely-pink-active: #9e1068;--solely-pink-light: rgba(196, 29, 127, .2);--solely-orange: #d87a16;--solely-orange-hover: #e89a3c;--solely-orange-active: #aa5b15;--solely-orange-light: rgba(216, 122, 22, .2);--solely-text-primary: rgba(255, 255, 255, .85);--solely-text-secondary: rgba(255, 255, 255, .65);--solely-text-tertiary: rgba(255, 255, 255, .45);--solely-text-quaternary: rgba(255, 255, 255, .25);--solely-border-color: #434343;--solely-border-color-split: #303030;--solely-gray-1: #141414;--solely-gray-2: #1f1f1f;--solely-gray-3: #2c2c2c;--solely-gray-4: #303030;--solely-gray-5: #434343;--solely-gray-6: #595959;--solely-gray-7: #8c8c8c;--solely-gray-8: #a6a6a6;--solely-gray-9: #bfbfbf;--solely-gray-10: #d9d9d9;--solely-gray-11: #f0f0f0;--solely-gray-12: #f5f5f5;--solely-gray-13: #ffffff;--solely-bg-color: #141414;--solely-bg-color-light: #1f1f1f;--solely-bg-color-dark: #000000;--solely-component-bg: #1f1f1f;--solely-component-bg-hover: #2c2c2c;--solely-fill-color: #2c2c2c;--solely-fill-color-light: #1f1f1f;--solely-inverted-bg: rgba(255, 255, 255, .9);--solely-inverted-text: var(--solely-black);--solely-mask-bg: rgba(0, 0, 0, .65);--solely-success-bg: var(--solely-success-light);--solely-warning-bg: var(--solely-warning-light);--solely-error-bg: var(--solely-error-light);--solely-info-bg: var(--solely-info-light);--solely-focus-ring: 0 0 0 2px var(--solely-primary-light);--solely-focus-ring-error: 0 0 0 2px var(--solely-error-light);--solely-focus-ring-warning: 0 0 0 2px var(--solely-warning-light);--solely-focus-ring-success: 0 0 0 2px var(--solely-success-light);--solely-gradient-brand: linear-gradient(135deg, #177ddc 0%, #0958d9 100%);--solely-gradient-brand-soft: linear-gradient(135deg, rgba(23, 125, 220, .15) 0%, rgba(9, 88, 217, .15) 100%);--solely-shadow-sm: 0 2px 8px rgba(0, 0, 0, .3);--solely-shadow-md: 0 4px 12px rgba(0, 0, 0, .35);--solely-shadow-lg: 0 8px 24px rgba(0, 0, 0, .4);--solely-shadow-xl: 0 12px 32px rgba(0, 0, 0, .45);--solely-shadow-2xl: 0 16px 48px rgba(0, 0, 0, .5);--solely-shadow-primary: 0 0 0 4px rgba(23, 125, 220, .25);--solely-shadow-primary-glow-sm: 0 2px 8px rgba(23, 125, 220, .4);--solely-shadow-primary-glow-md: 0 4px 16px rgba(23, 125, 220, .45);--solely-shadow-primary-glow-lg: 0 6px 24px rgba(23, 125, 220, .6);--solely-shadow-error-glow-sm: 0 4px 16px rgba(211, 32, 41, .35);--solely-shadow-error-glow-lg: 0 8px 32px rgba(211, 32, 41, .5)}';export{l as default};
package/dist/index.cjs CHANGED
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./router/index.cjs"),r=require("./shared/templateError.cjs"),t=require("./shared/gen-function.cjs"),s=require("./shared/functions.cjs"),o=require("./shared/event-listeners.cjs"),i=require("./shared/is-object.cjs"),c=require("./shared/url.cjs"),u=require("./shared/env.cjs"),a=require("./shared/case-convert.cjs"),p=require("./shared/svg-sanitize.cjs"),n=require("./types/ast.cjs"),d=require("./types/lifecycle.cjs"),l=require("./runtime/component/base-element.cjs"),x=require("./router/router-link.cjs"),m=require("./router/router-view.cjs"),j=require("./runtime/renderer/html-decode.cjs"),R=require("./runtime/component/decorators.cjs"),q=require("./runtime/renderer/renderIR.cjs"),y=require("./router/core.cjs"),h=require("./compiler/ir/buildIR.cjs"),b=require("./runtime/reactivity/computed.cjs"),S=require("./runtime/reactivity/observe.cjs"),f=require("./compiler/parser/parser.cjs"),E=require("./runtime/reactivity/watch.cjs");exports.createRouter=e.createRouter,exports.showTemplateError=r.showTemplateError,exports.genFunction=t.genFunction,exports.createFunction=s.createFunction,exports.isCSPBlocked=s.isCSPBlocked,exports.listeners=o.default,exports.isObject=i.isObject,exports.parseHashUrl=c.parseHashUrl,exports.IS_DEV=u.IS_DEV,exports.IS_PROD=u.IS_PROD,exports.SOLELY_VERSION=u.SOLELY_VERSION,exports.camelToKebab=a.camelToKebab,exports.sanitizeSvg=p.sanitizeSvg,exports.ASTType=n.ASTType,exports.LIFECYCLE_ATTRS_MAP=d.LIFECYCLE_ATTRS_MAP,exports.isLifecycleKind=d.isLifecycleKind,exports.mapAttrKeyToLifecycleKind=d.mapAttrKeyToLifecycleKind,exports.BaseElement=l.default,Object.defineProperty(exports,"RouterLink",{enumerable:!0,get:()=>x.default}),Object.defineProperty(exports,"RouterView",{enumerable:!0,get:()=>m.default}),exports.htmlDecode=j.default,exports.CustomElement=R.CustomElement,exports.IRRenderer=q.IRRenderer,exports.createRender=q.createRender,exports.Router=y.Router,exports.getRouter=y.getRouter,exports.routerReady=y.routerReady,exports.buildIR=h.buildIR,exports.clearIRCache=h.clearIRCache,exports.transformModel=h.transformModel,exports.computed=b.computed,exports.isProxy=S.isProxy,exports.observe=S.observe,exports.toProxy=S.toProxy,exports.toRaw=S.toRaw,exports.parseHtml=f.parseHtml,exports.watch=E.watch,exports.watchGetter=E.watchGetter;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./router/index.cjs"),r=require("./shared/templateError.cjs"),t=require("./shared/gen-function.cjs"),s=require("./shared/functions.cjs"),o=require("./shared/event-listeners.cjs"),i=require("./shared/is-object.cjs"),c=require("./shared/url.cjs"),a=require("./shared/env.cjs"),u=require("./shared/case-convert.cjs"),p=require("./shared/svg-sanitize.cjs"),n=require("./shared/aria.cjs"),d=require("./shared/size.cjs"),l=require("./types/ast.cjs"),x=require("./types/lifecycle.cjs"),m=require("./runtime/component/base-element.cjs"),j=require("./router/router-link.cjs"),R=require("./router/router-view.cjs"),q=require("./runtime/renderer/html-decode.cjs"),h=require("./runtime/component/decorators.cjs"),y=require("./runtime/renderer/renderIR.cjs"),S=require("./router/core.cjs"),b=require("./compiler/ir/buildIR.cjs"),I=require("./runtime/reactivity/computed.cjs"),f=require("./runtime/reactivity/observe.cjs"),T=require("./compiler/parser/parser.cjs"),E=require("./runtime/reactivity/watch.cjs");exports.createRouter=e.createRouter,exports.showTemplateError=r.showTemplateError,exports.genFunction=t.genFunction,exports.createFunction=s.createFunction,exports.isCSPBlocked=s.isCSPBlocked,exports.listeners=o.default,exports.isObject=i.isObject,exports.parseHashUrl=c.parseHashUrl,exports.IS_DEV=a.IS_DEV,exports.IS_PROD=a.IS_PROD,exports.SOLELY_VERSION=a.SOLELY_VERSION,exports.camelToKebab=u.camelToKebab,exports.sanitizeSvg=p.sanitizeSvg,exports.assertSameTree=n.assertSameTree,exports.createAriaId=n.createAriaId,exports.linkAria=n.linkAria,exports.normalizeSize=d.normalizeSize,exports.ASTType=l.ASTType,exports.LIFECYCLE_ATTRS_MAP=x.LIFECYCLE_ATTRS_MAP,exports.isLifecycleKind=x.isLifecycleKind,exports.mapAttrKeyToLifecycleKind=x.mapAttrKeyToLifecycleKind,exports.BaseElement=m.default,Object.defineProperty(exports,"RouterLink",{enumerable:!0,get:()=>j.default}),Object.defineProperty(exports,"RouterView",{enumerable:!0,get:()=>R.default}),exports.htmlDecode=q.default,exports.CustomElement=h.CustomElement,exports.IRRenderer=y.IRRenderer,exports.createRender=y.createRender,exports.Router=S.Router,exports.getRouter=S.getRouter,exports.routerReady=S.routerReady,exports.buildIR=b.buildIR,exports.clearIRCache=b.clearIRCache,exports.transformModel=b.transformModel,exports.computed=I.computed,exports.isProxy=f.isProxy,exports.observe=f.observe,exports.toProxy=f.toProxy,exports.toRaw=f.toRaw,exports.parseHtml=T.parseHtml,exports.watch=E.watch,exports.watchGetter=E.watchGetter;
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- export * from './compiler';
2
- export * from './router';
3
- export * from './runtime';
4
- export * from './shared';
5
- export * from './types';
1
+ export * from './compiler/index.js';
2
+ export * from './router/index.js';
3
+ export * from './runtime/index.js';
4
+ export * from './shared/index.js';
5
+ export * from './types/index.js';
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{createRouter as r}from"./router/index.js";import{showTemplateError as e}from"./shared/templateError.js";import{genFunction as o}from"./shared/gen-function.js";import{createFunction as t,isCSPBlocked as m}from"./shared/functions.js";import{default as s}from"./shared/event-listeners.js";import{isObject as i}from"./shared/is-object.js";import{parseHashUrl as a}from"./shared/url.js";import{IS_DEV as p,IS_PROD as f,SOLELY_VERSION as n}from"./shared/env.js";import{camelToKebab as j}from"./shared/case-convert.js";import{sanitizeSvg as u}from"./shared/svg-sanitize.js";import{ASTType as d}from"./types/ast.js";import{LIFECYCLE_ATTRS_MAP as c,isLifecycleKind as l,mapAttrKeyToLifecycleKind as h}from"./types/lifecycle.js";import{default as v}from"./runtime/component/base-element.js";import{default as y}from"./router/router-link.js";import{default as b}from"./router/router-view.js";import{default as R}from"./runtime/renderer/html-decode.js";import{CustomElement as w}from"./runtime/component/decorators.js";import{IRRenderer as g,createRender as k}from"./runtime/renderer/renderIR.js";import{Router as x,getRouter as E,routerReady as I}from"./router/core.js";import{buildIR as z,clearIRCache as B,transformModel as D}from"./compiler/ir/buildIR.js";import{computed as L}from"./runtime/reactivity/computed.js";import{isProxy as V,observe as q,toProxy as A,toRaw as C}from"./runtime/reactivity/observe.js";import{parseHtml as F}from"./compiler/parser/parser.js";import{watch as G,watchGetter as H}from"./runtime/reactivity/watch.js";export{d as ASTType,v as BaseElement,w as CustomElement,g as IRRenderer,p as IS_DEV,f as IS_PROD,c as LIFECYCLE_ATTRS_MAP,x as Router,y as RouterLink,b as RouterView,n as SOLELY_VERSION,z as buildIR,j as camelToKebab,B as clearIRCache,L as computed,t as createFunction,k as createRender,r as createRouter,o as genFunction,E as getRouter,R as htmlDecode,m as isCSPBlocked,l as isLifecycleKind,i as isObject,V as isProxy,s as listeners,h as mapAttrKeyToLifecycleKind,q as observe,a as parseHashUrl,F as parseHtml,I as routerReady,u as sanitizeSvg,e as showTemplateError,A as toProxy,C as toRaw,D as transformModel,G as watch,H as watchGetter};
1
+ import{createRouter as r}from"./router/index.js";import{showTemplateError as e}from"./shared/templateError.js";import{genFunction as o}from"./shared/gen-function.js";import{createFunction as t,isCSPBlocked as m}from"./shared/functions.js";import{default as s}from"./shared/event-listeners.js";import{isObject as i}from"./shared/is-object.js";import{parseHashUrl as a}from"./shared/url.js";import{IS_DEV as p,IS_PROD as f,SOLELY_VERSION as n}from"./shared/env.js";import{camelToKebab as j}from"./shared/case-convert.js";import{sanitizeSvg as d}from"./shared/svg-sanitize.js";import{assertSameTree as u,createAriaId as c,linkAria as l}from"./shared/aria.js";import{normalizeSize as h}from"./shared/size.js";import{ASTType as v}from"./types/ast.js";import{LIFECYCLE_ATTRS_MAP as y,isLifecycleKind as b,mapAttrKeyToLifecycleKind as R}from"./types/lifecycle.js";import{default as w}from"./runtime/component/base-element.js";import{default as g}from"./router/router-link.js";import{default as k}from"./router/router-view.js";import{default as x}from"./runtime/renderer/html-decode.js";import{CustomElement as z}from"./runtime/component/decorators.js";import{IRRenderer as E,createRender as I}from"./runtime/renderer/renderIR.js";import{Router as B,getRouter as D,routerReady as L}from"./router/core.js";import{buildIR as V,clearIRCache as q,transformModel as A}from"./compiler/ir/buildIR.js";import{computed as C}from"./runtime/reactivity/computed.js";import{isProxy as F,observe as G,toProxy as H,toRaw as J}from"./runtime/reactivity/observe.js";import{parseHtml as K}from"./compiler/parser/parser.js";import{watch as M,watchGetter as N}from"./runtime/reactivity/watch.js";export{v as ASTType,w as BaseElement,z as CustomElement,E as IRRenderer,p as IS_DEV,f as IS_PROD,y as LIFECYCLE_ATTRS_MAP,B as Router,g as RouterLink,k as RouterView,n as SOLELY_VERSION,u as assertSameTree,V as buildIR,j as camelToKebab,q as clearIRCache,C as computed,c as createAriaId,t as createFunction,I as createRender,r as createRouter,o as genFunction,D as getRouter,x as htmlDecode,m as isCSPBlocked,b as isLifecycleKind,i as isObject,F as isProxy,l as linkAria,s as listeners,R as mapAttrKeyToLifecycleKind,h as normalizeSize,G as observe,a as parseHashUrl,K as parseHtml,L as routerReady,d as sanitizeSvg,e as showTemplateError,H as toProxy,J as toRaw,A as transformModel,M as watch,N as watchGetter};
package/dist/plugin.d.ts CHANGED
@@ -35,5 +35,5 @@
35
35
  * }
36
36
  * ```
37
37
  */
38
- export { solelyVitePlugin, type SolelyVitePluginOptions } from './plugins/solely-vite-plugin';
39
- export { solelyVitePlugin as default } from './plugins/solely-vite-plugin';
38
+ export { solelyVitePlugin, type SolelyVitePluginOptions } from './plugins/solely-vite-plugin.js';
39
+ export { solelyVitePlugin as default } from './plugins/solely-vite-plugin.js';
@@ -3,5 +3,5 @@
3
3
  *
4
4
  * 提供构建时和运行时的扩展能力
5
5
  */
6
- export { solelyVitePlugin, type SolelyVitePluginOptions } from './solely-vite-plugin';
7
- export { solelyVitePlugin as default } from './solely-vite-plugin';
6
+ export { solelyVitePlugin, type SolelyVitePluginOptions } from './solely-vite-plugin.js';
7
+ export { solelyVitePlugin as default } from './solely-vite-plugin.js';
@@ -1,5 +1,5 @@
1
1
  import { Plugin } from 'vite';
2
- import { IRRoot } from '../types';
2
+ import { IRRoot } from '../types/index.js';
3
3
  export interface SolelyVitePluginOptions {
4
4
  /** 是否启用模板预编译,默认 true */
5
5
  precompile?: boolean;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../shared/env.cjs");let t=null,s=null,i=null;function r(){return t?Promise.resolve(t):(i||(i=new Promise(e=>{s=e})),i)}const a=(()=>{const e=()=>r();return Object.defineProperties(e,{then:{value:(e,t)=>r().then(e,t),writable:!1,enumerable:!1,configurable:!0},catch:{value:e=>r().catch(e),writable:!1,enumerable:!1,configurable:!0},finally:{value:e=>r().finally(e),writable:!1,enumerable:!1,configurable:!0},[Symbol.toStringTag]:{value:"Promise",writable:!1,enumerable:!1,configurable:!0}}),e})();class n{routes;base;mode;beforeEachGuard;afterEachGuard;currentRoute=null;listeners=new Set;componentCache=new Map;keepAliveCache=new Map;keepAliveKeys=[];navigationId=0;maxKeepAlive;constructor(e){this.routes=e.routes,this.base=this.normalizeBase(e.base),this.mode=e.mode||"history",this.beforeEachGuard=e.beforeEach,this.afterEachGuard=e.afterEach,this.maxKeepAlive=e.maxKeepAlive}normalizeBase(e){let t=e||"/";return t.startsWith("/")||(t="/"+t),t.length>1&&t.endsWith("/")&&(t=t.slice(0,-1)),t}static MAX_REDIRECTS=20;matchRoute(e="/"){return this.matchRouteInternal(e,new Set,0)}matchRouteInternal(t,s,i){if(i>=n.MAX_REDIRECTS)return e.IS_DEV&&console.error(`[Router] Too many redirects (max ${n.MAX_REDIRECTS}), last path: ${t}`),null;const r=this.normalizePath(t);if(s.has(r))return e.IS_DEV&&console.error(`[Router] Circular redirect detected: ${r}`),null;s.add(r);const[a,h]=r.split("?"),o=a.split("/").filter(Boolean),c=this.parseQuery(h),l=this.recursiveMatch(this.routes,o);if(l){const e=l.matched[l.matched.length-1];return e.config.redirect?this.matchRouteInternal(e.config.redirect,s,i+1):{matched:l.matched,params:l.params,query:c,fullPath:r,meta:l.matched.reduce((e,t)=>({...e,...t.config.meta||{}}),{})}}return null}recursiveMatch(e,t){const s=[...e].sort((e,t)=>this.calculateScore(t.path)-this.calculateScore(e.path));for(const i of s){const e=i.path.split("/").filter(Boolean),s={};let r=!0;if(0===e.length&&0===t.length)return{matched:[{config:i,params:{}}],params:{}};for(let i=0;i<e.length;i++){const a=e[i],n=t[i];if(a.startsWith(":")){if(!n){r=!1;break}Object.defineProperty(s,a.slice(1),{value:n,writable:!0,enumerable:!0,configurable:!0})}else{if("*"===a){r=!0;break}if(a!==n){r=!1;break}}}if(r){const r=e.length,a=t.slice(r),n={config:i,params:s};if(a.length>0&&i.children){const e=this.recursiveMatch(i.children,a);if(e)return{matched:[n,...e.matched],params:{...s,...e.params}}}else if(0===a.length||e.includes("*"))return{matched:[n],params:s}}}return null}calculateScore(e="/"){const t=e.split("/").filter(Boolean);return 0===t.length?1:t.reduce((e,t)=>t.startsWith(":")?e+5:"*"===t?e+0:e+10,0)}parseQuery(e){const t={};return e?(new URLSearchParams(e).forEach((e,s)=>{Object.defineProperty(t,s,{value:e,writable:!0,enumerable:!0,configurable:!0})}),t):t}normalizePath(e="/"){const t=e&&"string"==typeof e?e:"/",s=t.indexOf("?"),i=-1===s?t:t.slice(0,s),r=-1===s?"":t.slice(s+1);let a=i;return a.startsWith("/")||(a="/"+a),a.length>1&&a.endsWith("/")&&(a=a.slice(0,-1)),r?`${a}?${r}`:a}getPath(){let e;try{e="hash"===this.mode?window.location.hash.slice(1)||"/":`${window.location.pathname}${window.location.search}`}catch{e="/"}const t=this.base||"/";return"/"===t||e!==t&&!e.startsWith(t+"/")||(e=e.slice(t.length)||"/"),this.normalizePath(e)}updateBrowserHistory(e="/",t){const s=this.normalizePath(e),i=this.base||"/";if("hash"===this.mode)t?window.location.replace(`#${s}`):window.location.hash=s;else{const e=i.endsWith("/")?i.slice(0,-1):i,r="/"===e?s:e+s;t?window.history.replaceState({path:r},"",r):window.history.pushState({path:r},"",r)}}async navigate(e="/",t=!1,s=!1){const i=++this.navigationId,r=this.normalizePath(e),a=this.currentRoute,n=this.matchRoute(r);if(!n)return{success:!1,error:`No route matched: ${r}`};if(a&&a.fullPath===n.fullPath)return{success:!0};if(this.beforeEachGuard)try{const e=await this.beforeEachGuard(n,a);if(i!==this.navigationId)return{success:!1,cancelled:!0};if(!1===e)return{success:!1,cancelled:!0};if("string"==typeof e)return this.navigate(e,t)}catch(h){return i!==this.navigationId?{success:!1,cancelled:!0}:{success:!1,error:h instanceof Error?h.message:"Guard Error"}}return i!==this.navigationId?{success:!1,cancelled:!0}:(this.currentRoute=n,s||this.updateBrowserHistory(r,t),this.notifyListeners(),this.afterEachGuard&&this.afterEachGuard(n,a),{success:!0})}resolve(e="/"){const t=this.normalizePath(e);if("hash"===this.mode)return`#${t}`;const s=this.base.endsWith("/")?this.base.slice(0,-1):this.base;return"/"===s?t:s+t}get modeType(){return this.mode}pushWithQuery(e="/",t){const s=new URLSearchParams(t).toString(),i=e.includes("?")?"&":"?";return this.push(e+(s?i+s:""))}push(e="/"){return this.navigate(e,!1)}replace(e="/"){return this.navigate(e,!0)}back(){window.history.back()}forward(){window.history.forward()}listen(e){return this.listeners.add(e),()=>this.listeners.delete(e)}notifyListeners(){this.listeners.forEach(e=>e())}isStarted=!1;handleRouteChange=null;setupListeners(){this.isStarted||(this.isStarted=!0,this.handleRouteChange=()=>{this.navigate(this.getPath(),!0,!0)},"hash"===this.mode?window.addEventListener("hashchange",this.handleRouteChange):window.addEventListener("popstate",this.handleRouteChange),"hash"!==this.mode||window.location.hash||(window.location.hash="/"),this.navigate(this.getPath(),!0))}destroy(){this.handleRouteChange&&("hash"===this.mode?window.removeEventListener("hashchange",this.handleRouteChange):window.removeEventListener("popstate",this.handleRouteChange),this.handleRouteChange=null),this.isStarted=!1,this.listeners.clear(),this.componentCache.clear();for(const e of this.keepAliveCache.values())e.dispose?.();this.keepAliveCache.clear(),this.keepAliveKeys=[],this.currentRoute=null,t=null}getCurrentRoute(){return this.currentRoute}getKeepAlive(e){const t=this.keepAliveCache.get(e);if(t){const t=this.keepAliveKeys.indexOf(e);-1!==t&&(this.keepAliveKeys.splice(t,1),this.keepAliveKeys.push(e))}return t}setKeepAlive(e,t){if(this.keepAliveCache.has(e)){const s=this.keepAliveCache.get(e);s&&s!==t&&s.dispose?.(),this.keepAliveCache.set(e,t);const i=this.keepAliveKeys.indexOf(e);-1!==i&&(this.keepAliveKeys.splice(i,1),this.keepAliveKeys.push(e))}else this.keepAliveCache.set(e,t),this.keepAliveKeys.push(e),this.evictKeepAlive()}hasKeepAlive(e){return this.keepAliveCache.has(e)}evictKeepAlive(){if(this.maxKeepAlive)for(;this.keepAliveKeys.length>this.maxKeepAlive;){const e=this.keepAliveKeys.shift();if(e){const t=this.keepAliveCache.get(e);t?.dispose?.(),this.keepAliveCache.delete(e)}}}cacheKey(e){return this.normalizePath(e)}prefetch(e){const t=this.matchRoute(e);if(!t)return;const s=this.cacheKey(t.fullPath),i=t.matched[t.matched.length-1];if(!i?.config.component)return;const r=i.config.component;if("function"!=typeof r)return;if(this.componentCache.has(s))return;const a=r();this.componentCache.set(s,a),a.catch(()=>{this.componentCache.delete(s)})}getComponentFromCache(e){return this.componentCache.get(this.cacheKey(e))}}exports.Router=n,exports.createRouter=function(e){return t||(t=new n(e),s&&s(t),s=null,i=null,t)},exports.getRouter=function(){return t},exports.routerReady=a;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../shared/env.cjs");let t=null,i=null,s=null;function r(){return t?Promise.resolve(t):(s||(s=new Promise(e=>{i=e})),s)}const a=(()=>{const e=()=>r();return Object.defineProperties(e,{then:{value:(e,t)=>r().then(e,t),writable:!1,enumerable:!1,configurable:!0},catch:{value:e=>r().catch(e),writable:!1,enumerable:!1,configurable:!0},finally:{value:e=>r().finally(e),writable:!1,enumerable:!1,configurable:!0},[Symbol.toStringTag]:{value:"Promise",writable:!1,enumerable:!1,configurable:!0}}),e})();class n{routes;base;mode;beforeEachGuard;afterEachGuard;currentRoute=null;listeners=new Set;componentCache=new Map;keepAliveCache=new Map;keepAliveKeys=[];navigationId=0;maxKeepAlive;navigated=!1;pendingNavId=null;readyDeferred=null;constructor(e){this.routes=e.routes,this.base=this.normalizeBase(e.base),this.mode=e.mode||"history",this.beforeEachGuard=e.beforeEach,this.afterEachGuard=e.afterEach,this.maxKeepAlive=e.maxKeepAlive}normalizeBase(e){let t=e||"/";return t.startsWith("/")||(t="/"+t),t.length>1&&t.endsWith("/")&&(t=t.slice(0,-1)),t}static MAX_REDIRECTS=20;matchRoute(e="/"){return this.matchRouteInternal(e,new Set,0)}matchRouteInternal(t,i,s){if(s>=n.MAX_REDIRECTS)return e.IS_DEV&&console.error(`[Router] Too many redirects (max ${n.MAX_REDIRECTS}), last path: ${t}`),null;const r=this.normalizePath(t);if(i.has(r))return e.IS_DEV&&console.error(`[Router] Circular redirect detected: ${r}`),null;i.add(r);const[a,h]=r.split("?"),o=a.split("/").filter(Boolean),l=this.parseQuery(h),c=this.recursiveMatch(this.routes,o);if(c){const e=c.matched[c.matched.length-1];return e.config.redirect?this.matchRouteInternal(e.config.redirect,i,s+1):{matched:c.matched,params:c.params,query:l,fullPath:r,meta:c.matched.reduce((e,t)=>({...e,...t.config.meta||{}}),{})}}return null}recursiveMatch(e,t){const i=[...e].sort((e,t)=>this.calculateScore(t.path)-this.calculateScore(e.path));for(const s of i){const e=s.path.split("/").filter(Boolean),i={};let r=!0;if(0===e.length&&0===t.length)return{matched:[{config:s,params:{}}],params:{}};for(let s=0;s<e.length;s++){const a=e[s],n=t[s];if(a.startsWith(":")){if(!n){r=!1;break}Object.defineProperty(i,a.slice(1),{value:n,writable:!0,enumerable:!0,configurable:!0})}else{if("*"===a){r=!0;break}if(a!==n){r=!1;break}}}if(r){const r=e.length,a=t.slice(r),n={config:s,params:i};if(a.length>0&&s.children){const e=this.recursiveMatch(s.children,a);if(e)return{matched:[n,...e.matched],params:{...i,...e.params}}}else if(0===a.length||e.includes("*"))return{matched:[n],params:i}}}return null}calculateScore(e="/"){const t=e.split("/").filter(Boolean);return 0===t.length?1:t.reduce((e,t)=>t.startsWith(":")?e+5:"*"===t?e+0:e+10,0)}parseQuery(e){const t={};return e?(new URLSearchParams(e).forEach((e,i)=>{Object.defineProperty(t,i,{value:e,writable:!0,enumerable:!0,configurable:!0})}),t):t}normalizePath(e="/"){const t=e&&"string"==typeof e?e:"/",i=t.indexOf("?"),s=-1===i?t:t.slice(0,i),r=-1===i?"":t.slice(i+1);let a=s;return a.startsWith("/")||(a="/"+a),a.length>1&&a.endsWith("/")&&(a=a.slice(0,-1)),r?`${a}?${r}`:a}getPath(){let e;try{e="hash"===this.mode?window.location.hash.slice(1)||"/":`${window.location.pathname}${window.location.search}`}catch{e="/"}const t=this.base||"/";return"/"===t||e!==t&&!e.startsWith(t+"/")||(e=e.slice(t.length)||"/"),this.normalizePath(e)}updateBrowserHistory(e="/",t){const i=this.normalizePath(e),s=this.base||"/";if("hash"===this.mode)t?window.location.replace(`#${i}`):window.location.hash=i;else{const e=s.endsWith("/")?s.slice(0,-1):s,r="/"===e?i:e+i;t?window.history.replaceState({path:r},"",r):window.history.pushState({path:r},"",r)}}async navigate(e="/",t=!1,i=!1){const s=++this.navigationId;this.pendingNavId=s;try{const a=this.normalizePath(e),n=this.currentRoute,h=this.matchRoute(a);if(!h)return{success:!1,error:`No route matched: ${a}`};if(n&&n.fullPath===h.fullPath)return{success:!0};if(this.beforeEachGuard)try{const e=await this.beforeEachGuard(h,n);if(s!==this.navigationId)return{success:!1,cancelled:!0};if(!1===e)return{success:!1,cancelled:!0};if("string"==typeof e)return this.navigate(e,t)}catch(r){return s!==this.navigationId?{success:!1,cancelled:!0}:{success:!1,error:r instanceof Error?r.message:"Guard Error"}}return s!==this.navigationId?{success:!1,cancelled:!0}:(this.currentRoute=h,i||this.updateBrowserHistory(a,t),this.notifyListeners(),this.afterEachGuard&&this.afterEachGuard(h,n),{success:!0})}finally{this.pendingNavId===s&&(this.pendingNavId=null,s===this.navigationId&&this.markReady())}}resolve(e="/"){const t=this.normalizePath(e);if("hash"===this.mode)return`#${t}`;const i=this.base.endsWith("/")?this.base.slice(0,-1):this.base;return"/"===i?t:i+t}get modeType(){return this.mode}pushWithQuery(e="/",t){const i=new URLSearchParams(t).toString(),s=e.includes("?")?"&":"?";return this.push(e+(i?s+i:""))}push(e="/"){return this.navigate(e,!1)}replace(e="/"){return this.navigate(e,!0)}back(){window.history.back()}forward(){window.history.forward()}listen(e){return this.listeners.add(e),()=>this.listeners.delete(e)}notifyListeners(){this.listeners.forEach(e=>e())}isStarted=!1;handleRouteChange=null;setupListeners(){this.isStarted||(this.isStarted=!0,this.handleRouteChange=()=>{this.navigate(this.getPath(),!0,!0)},"hash"===this.mode?window.addEventListener("hashchange",this.handleRouteChange):window.addEventListener("popstate",this.handleRouteChange),"hash"!==this.mode||window.location.hash||(window.location.hash="/"),this.navigate(this.getPath(),!0).catch(t=>{e.IS_DEV&&console.error("[Router] 首导航异常:",t)}))}destroy(){this.navigationId++,this.handleRouteChange&&("hash"===this.mode?window.removeEventListener("hashchange",this.handleRouteChange):window.removeEventListener("popstate",this.handleRouteChange),this.handleRouteChange=null),this.isStarted=!1,this.listeners.clear(),this.componentCache.clear();for(const e of this.keepAliveCache.values())e.dispose?.();this.keepAliveCache.clear(),this.keepAliveKeys=[],this.currentRoute=null,this.navigated=!1,this.pendingNavId=null,this.readyDeferred?.resolve(),this.readyDeferred=null,t=null}getCurrentRoute(){return this.currentRoute}get hasNavigated(){return this.navigated}get isNavigating(){return null!==this.pendingNavId}isReady(){if(this.navigated&&null===this.pendingNavId)return Promise.resolve();if(!this.readyDeferred){let e;const t=new Promise(t=>{e=t});this.readyDeferred={promise:t,resolve:e}}return this.readyDeferred.promise}markReady(){this.navigated=!0,this.readyDeferred?.resolve(),this.readyDeferred=null}getKeepAlive(e){const t=this.keepAliveCache.get(e);if(t){const t=this.keepAliveKeys.indexOf(e);-1!==t&&(this.keepAliveKeys.splice(t,1),this.keepAliveKeys.push(e))}return t}setKeepAlive(e,t){if(this.keepAliveCache.has(e)){const i=this.keepAliveCache.get(e);i&&i!==t&&i.dispose?.(),this.keepAliveCache.set(e,t);const s=this.keepAliveKeys.indexOf(e);-1!==s&&(this.keepAliveKeys.splice(s,1),this.keepAliveKeys.push(e))}else this.keepAliveCache.set(e,t),this.keepAliveKeys.push(e),this.evictKeepAlive()}hasKeepAlive(e){return this.keepAliveCache.has(e)}evictKeepAlive(){if(this.maxKeepAlive)for(;this.keepAliveKeys.length>this.maxKeepAlive;){const e=this.keepAliveKeys.shift();if(e){const t=this.keepAliveCache.get(e);t?.dispose?.(),this.keepAliveCache.delete(e)}}}cacheKey(e){return this.normalizePath(e)}prefetch(e){const t=this.matchRoute(e);if(!t)return;const i=this.cacheKey(t.fullPath),s=t.matched[t.matched.length-1];if(!s?.config.component)return;const r=s.config.component;if("function"!=typeof r)return;if(this.componentCache.has(i))return;const a=r();this.componentCache.set(i,a),a.catch(()=>{this.componentCache.delete(i)})}getComponentFromCache(e){return this.componentCache.get(this.cacheKey(e))}}exports.Router=n,exports.createRouter=function(e){return t||(t=new n(e),i&&i(t),i=null,s=null,t)},exports.getRouter=function(){return t},exports.routerReady=a;
@@ -1,4 +1,4 @@
1
- import { RouteMatch, RouterOptions, NavigationResult } from './types';
1
+ import { RouteMatch, RouterOptions, NavigationResult } from './types.js';
2
2
  /**
3
3
  * 路由器就绪 Promise(向后兼容)
4
4
  *
@@ -32,6 +32,11 @@ export declare class Router {
32
32
  private keepAliveKeys;
33
33
  private navigationId;
34
34
  private maxKeepAlive;
35
+ /** 首次导航(含守卫与重定向)是否已 settled */
36
+ private navigated;
37
+ /** 尚未完成的「最新一次」导航的 navId;null 表示当前没有导航在飞 */
38
+ private pendingNavId;
39
+ private readyDeferred;
35
40
  constructor(options: RouterOptions);
36
41
  private normalizeBase;
37
42
  private static readonly MAX_REDIRECTS;
@@ -58,6 +63,31 @@ export declare class Router {
58
63
  setupListeners(): void;
59
64
  destroy(): void;
60
65
  getCurrentRoute(): RouteMatch | null;
66
+ /**
67
+ * 首次导航是否已完成(成功或失败均算完成)。
68
+ *
69
+ * 用于区分「启动中」与「真的没有匹配路由」:`currentRoute === null` 在启动阶段
70
+ * 是正常状态,不应被上层当成 404。
71
+ */
72
+ get hasNavigated(): boolean;
73
+ /**
74
+ * 是否有导航正在进行(含卡在异步守卫里的那次)。
75
+ *
76
+ * `isReady()` 在仍有导航在飞时保持 pending —— 否则调用方会在两次导航之间醒来,
77
+ * 读到 `currentRoute === null` 而把「还在导航」当成「无匹配」。
78
+ */
79
+ get isNavigating(): boolean;
80
+ /**
81
+ * 等待首次导航 settled。
82
+ *
83
+ * 语义与 `routerReady` 对齐:`setupListeners()` 之前调用会保持 pending,
84
+ * 需配合「先 setupListeners 再 await」的启动顺序;`destroy()` 后重置,
85
+ * 且销毁时仍 pending 的等待会被立即 resolve(不 reject),调用方据此结束等待;
86
+ * 销毁**之后**再调用会一直 pending —— 该实例已作废,不应继续使用。
87
+ */
88
+ isReady(): Promise<void>;
89
+ /** 唯一调用点(`navigate()` 的 finally)已保证 `pendingNavId` 为 null */
90
+ private markReady;
61
91
  getKeepAlive(key: string): HTMLElement | undefined;
62
92
  setKeepAlive(key: string, el: HTMLElement): void;
63
93
  hasKeepAlive(key: string): boolean;
@@ -1 +1 @@
1
- import{IS_DEV as e}from"../shared/env.js";let t=null,s=null,i=null;function a(){return t?Promise.resolve(t):(i||(i=new Promise(e=>{s=e})),i)}const r=(()=>{const e=()=>a();return Object.defineProperties(e,{then:{value:(e,t)=>a().then(e,t),writable:!1,enumerable:!1,configurable:!0},catch:{value:e=>a().catch(e),writable:!1,enumerable:!1,configurable:!0},finally:{value:e=>a().finally(e),writable:!1,enumerable:!1,configurable:!0},[Symbol.toStringTag]:{value:"Promise",writable:!1,enumerable:!1,configurable:!0}}),e})();function n(e){return t||(t=new o(e),s&&s(t),s=null,i=null,t)}function h(){return t}class o{routes;base;mode;beforeEachGuard;afterEachGuard;currentRoute=null;listeners=new Set;componentCache=new Map;keepAliveCache=new Map;keepAliveKeys=[];navigationId=0;maxKeepAlive;constructor(e){this.routes=e.routes,this.base=this.normalizeBase(e.base),this.mode=e.mode||"history",this.beforeEachGuard=e.beforeEach,this.afterEachGuard=e.afterEach,this.maxKeepAlive=e.maxKeepAlive}normalizeBase(e){let t=e||"/";return t.startsWith("/")||(t="/"+t),t.length>1&&t.endsWith("/")&&(t=t.slice(0,-1)),t}static MAX_REDIRECTS=20;matchRoute(e="/"){return this.matchRouteInternal(e,new Set,0)}matchRouteInternal(t,s,i){if(i>=o.MAX_REDIRECTS)return e&&console.error(`[Router] Too many redirects (max ${o.MAX_REDIRECTS}), last path: ${t}`),null;const a=this.normalizePath(t);if(s.has(a))return e&&console.error(`[Router] Circular redirect detected: ${a}`),null;s.add(a);const[r,n]=a.split("?"),h=r.split("/").filter(Boolean),c=this.parseQuery(n),l=this.recursiveMatch(this.routes,h);if(l){const e=l.matched[l.matched.length-1];return e.config.redirect?this.matchRouteInternal(e.config.redirect,s,i+1):{matched:l.matched,params:l.params,query:c,fullPath:a,meta:l.matched.reduce((e,t)=>({...e,...t.config.meta||{}}),{})}}return null}recursiveMatch(e,t){const s=[...e].sort((e,t)=>this.calculateScore(t.path)-this.calculateScore(e.path));for(const i of s){const e=i.path.split("/").filter(Boolean),s={};let a=!0;if(0===e.length&&0===t.length)return{matched:[{config:i,params:{}}],params:{}};for(let i=0;i<e.length;i++){const r=e[i],n=t[i];if(r.startsWith(":")){if(!n){a=!1;break}Object.defineProperty(s,r.slice(1),{value:n,writable:!0,enumerable:!0,configurable:!0})}else{if("*"===r){a=!0;break}if(r!==n){a=!1;break}}}if(a){const a=e.length,r=t.slice(a),n={config:i,params:s};if(r.length>0&&i.children){const e=this.recursiveMatch(i.children,r);if(e)return{matched:[n,...e.matched],params:{...s,...e.params}}}else if(0===r.length||e.includes("*"))return{matched:[n],params:s}}}return null}calculateScore(e="/"){const t=e.split("/").filter(Boolean);return 0===t.length?1:t.reduce((e,t)=>t.startsWith(":")?e+5:"*"===t?e+0:e+10,0)}parseQuery(e){const t={};return e?(new URLSearchParams(e).forEach((e,s)=>{Object.defineProperty(t,s,{value:e,writable:!0,enumerable:!0,configurable:!0})}),t):t}normalizePath(e="/"){const t=e&&"string"==typeof e?e:"/",s=t.indexOf("?"),i=-1===s?t:t.slice(0,s),a=-1===s?"":t.slice(s+1);let r=i;return r.startsWith("/")||(r="/"+r),r.length>1&&r.endsWith("/")&&(r=r.slice(0,-1)),a?`${r}?${a}`:r}getPath(){let e;try{e="hash"===this.mode?window.location.hash.slice(1)||"/":`${window.location.pathname}${window.location.search}`}catch{e="/"}const t=this.base||"/";return"/"===t||e!==t&&!e.startsWith(t+"/")||(e=e.slice(t.length)||"/"),this.normalizePath(e)}updateBrowserHistory(e="/",t){const s=this.normalizePath(e),i=this.base||"/";if("hash"===this.mode)t?window.location.replace(`#${s}`):window.location.hash=s;else{const e=i.endsWith("/")?i.slice(0,-1):i,a="/"===e?s:e+s;t?window.history.replaceState({path:a},"",a):window.history.pushState({path:a},"",a)}}async navigate(e="/",t=!1,s=!1){const i=++this.navigationId,a=this.normalizePath(e),r=this.currentRoute,n=this.matchRoute(a);if(!n)return{success:!1,error:`No route matched: ${a}`};if(r&&r.fullPath===n.fullPath)return{success:!0};if(this.beforeEachGuard)try{const e=await this.beforeEachGuard(n,r);if(i!==this.navigationId)return{success:!1,cancelled:!0};if(!1===e)return{success:!1,cancelled:!0};if("string"==typeof e)return this.navigate(e,t)}catch(h){return i!==this.navigationId?{success:!1,cancelled:!0}:{success:!1,error:h instanceof Error?h.message:"Guard Error"}}return i!==this.navigationId?{success:!1,cancelled:!0}:(this.currentRoute=n,s||this.updateBrowserHistory(a,t),this.notifyListeners(),this.afterEachGuard&&this.afterEachGuard(n,r),{success:!0})}resolve(e="/"){const t=this.normalizePath(e);if("hash"===this.mode)return`#${t}`;const s=this.base.endsWith("/")?this.base.slice(0,-1):this.base;return"/"===s?t:s+t}get modeType(){return this.mode}pushWithQuery(e="/",t){const s=new URLSearchParams(t).toString(),i=e.includes("?")?"&":"?";return this.push(e+(s?i+s:""))}push(e="/"){return this.navigate(e,!1)}replace(e="/"){return this.navigate(e,!0)}back(){window.history.back()}forward(){window.history.forward()}listen(e){return this.listeners.add(e),()=>this.listeners.delete(e)}notifyListeners(){this.listeners.forEach(e=>e())}isStarted=!1;handleRouteChange=null;setupListeners(){this.isStarted||(this.isStarted=!0,this.handleRouteChange=()=>{this.navigate(this.getPath(),!0,!0)},"hash"===this.mode?window.addEventListener("hashchange",this.handleRouteChange):window.addEventListener("popstate",this.handleRouteChange),"hash"!==this.mode||window.location.hash||(window.location.hash="/"),this.navigate(this.getPath(),!0))}destroy(){this.handleRouteChange&&("hash"===this.mode?window.removeEventListener("hashchange",this.handleRouteChange):window.removeEventListener("popstate",this.handleRouteChange),this.handleRouteChange=null),this.isStarted=!1,this.listeners.clear(),this.componentCache.clear();for(const e of this.keepAliveCache.values())e.dispose?.();this.keepAliveCache.clear(),this.keepAliveKeys=[],this.currentRoute=null,t=null}getCurrentRoute(){return this.currentRoute}getKeepAlive(e){const t=this.keepAliveCache.get(e);if(t){const t=this.keepAliveKeys.indexOf(e);-1!==t&&(this.keepAliveKeys.splice(t,1),this.keepAliveKeys.push(e))}return t}setKeepAlive(e,t){if(this.keepAliveCache.has(e)){const s=this.keepAliveCache.get(e);s&&s!==t&&s.dispose?.(),this.keepAliveCache.set(e,t);const i=this.keepAliveKeys.indexOf(e);-1!==i&&(this.keepAliveKeys.splice(i,1),this.keepAliveKeys.push(e))}else this.keepAliveCache.set(e,t),this.keepAliveKeys.push(e),this.evictKeepAlive()}hasKeepAlive(e){return this.keepAliveCache.has(e)}evictKeepAlive(){if(this.maxKeepAlive)for(;this.keepAliveKeys.length>this.maxKeepAlive;){const e=this.keepAliveKeys.shift();if(e){const t=this.keepAliveCache.get(e);t?.dispose?.(),this.keepAliveCache.delete(e)}}}cacheKey(e){return this.normalizePath(e)}prefetch(e){const t=this.matchRoute(e);if(!t)return;const s=this.cacheKey(t.fullPath),i=t.matched[t.matched.length-1];if(!i?.config.component)return;const a=i.config.component;if("function"!=typeof a)return;if(this.componentCache.has(s))return;const r=a();this.componentCache.set(s,r),r.catch(()=>{this.componentCache.delete(s)})}getComponentFromCache(e){return this.componentCache.get(this.cacheKey(e))}}export{o as Router,n as createRouter,h as getRouter,r as routerReady};
1
+ import{IS_DEV as e}from"../shared/env.js";let t=null,i=null,s=null;function a(){return t?Promise.resolve(t):(s||(s=new Promise(e=>{i=e})),s)}const r=(()=>{const e=()=>a();return Object.defineProperties(e,{then:{value:(e,t)=>a().then(e,t),writable:!1,enumerable:!1,configurable:!0},catch:{value:e=>a().catch(e),writable:!1,enumerable:!1,configurable:!0},finally:{value:e=>a().finally(e),writable:!1,enumerable:!1,configurable:!0},[Symbol.toStringTag]:{value:"Promise",writable:!1,enumerable:!1,configurable:!0}}),e})();function n(e){return t||(t=new o(e),i&&i(t),i=null,s=null,t)}function h(){return t}class o{routes;base;mode;beforeEachGuard;afterEachGuard;currentRoute=null;listeners=new Set;componentCache=new Map;keepAliveCache=new Map;keepAliveKeys=[];navigationId=0;maxKeepAlive;navigated=!1;pendingNavId=null;readyDeferred=null;constructor(e){this.routes=e.routes,this.base=this.normalizeBase(e.base),this.mode=e.mode||"history",this.beforeEachGuard=e.beforeEach,this.afterEachGuard=e.afterEach,this.maxKeepAlive=e.maxKeepAlive}normalizeBase(e){let t=e||"/";return t.startsWith("/")||(t="/"+t),t.length>1&&t.endsWith("/")&&(t=t.slice(0,-1)),t}static MAX_REDIRECTS=20;matchRoute(e="/"){return this.matchRouteInternal(e,new Set,0)}matchRouteInternal(t,i,s){if(s>=o.MAX_REDIRECTS)return e&&console.error(`[Router] Too many redirects (max ${o.MAX_REDIRECTS}), last path: ${t}`),null;const a=this.normalizePath(t);if(i.has(a))return e&&console.error(`[Router] Circular redirect detected: ${a}`),null;i.add(a);const[r,n]=a.split("?"),h=r.split("/").filter(Boolean),l=this.parseQuery(n),c=this.recursiveMatch(this.routes,h);if(c){const e=c.matched[c.matched.length-1];return e.config.redirect?this.matchRouteInternal(e.config.redirect,i,s+1):{matched:c.matched,params:c.params,query:l,fullPath:a,meta:c.matched.reduce((e,t)=>({...e,...t.config.meta||{}}),{})}}return null}recursiveMatch(e,t){const i=[...e].sort((e,t)=>this.calculateScore(t.path)-this.calculateScore(e.path));for(const s of i){const e=s.path.split("/").filter(Boolean),i={};let a=!0;if(0===e.length&&0===t.length)return{matched:[{config:s,params:{}}],params:{}};for(let s=0;s<e.length;s++){const r=e[s],n=t[s];if(r.startsWith(":")){if(!n){a=!1;break}Object.defineProperty(i,r.slice(1),{value:n,writable:!0,enumerable:!0,configurable:!0})}else{if("*"===r){a=!0;break}if(r!==n){a=!1;break}}}if(a){const a=e.length,r=t.slice(a),n={config:s,params:i};if(r.length>0&&s.children){const e=this.recursiveMatch(s.children,r);if(e)return{matched:[n,...e.matched],params:{...i,...e.params}}}else if(0===r.length||e.includes("*"))return{matched:[n],params:i}}}return null}calculateScore(e="/"){const t=e.split("/").filter(Boolean);return 0===t.length?1:t.reduce((e,t)=>t.startsWith(":")?e+5:"*"===t?e+0:e+10,0)}parseQuery(e){const t={};return e?(new URLSearchParams(e).forEach((e,i)=>{Object.defineProperty(t,i,{value:e,writable:!0,enumerable:!0,configurable:!0})}),t):t}normalizePath(e="/"){const t=e&&"string"==typeof e?e:"/",i=t.indexOf("?"),s=-1===i?t:t.slice(0,i),a=-1===i?"":t.slice(i+1);let r=s;return r.startsWith("/")||(r="/"+r),r.length>1&&r.endsWith("/")&&(r=r.slice(0,-1)),a?`${r}?${a}`:r}getPath(){let e;try{e="hash"===this.mode?window.location.hash.slice(1)||"/":`${window.location.pathname}${window.location.search}`}catch{e="/"}const t=this.base||"/";return"/"===t||e!==t&&!e.startsWith(t+"/")||(e=e.slice(t.length)||"/"),this.normalizePath(e)}updateBrowserHistory(e="/",t){const i=this.normalizePath(e),s=this.base||"/";if("hash"===this.mode)t?window.location.replace(`#${i}`):window.location.hash=i;else{const e=s.endsWith("/")?s.slice(0,-1):s,a="/"===e?i:e+i;t?window.history.replaceState({path:a},"",a):window.history.pushState({path:a},"",a)}}async navigate(e="/",t=!1,i=!1){const s=++this.navigationId;this.pendingNavId=s;try{const r=this.normalizePath(e),n=this.currentRoute,h=this.matchRoute(r);if(!h)return{success:!1,error:`No route matched: ${r}`};if(n&&n.fullPath===h.fullPath)return{success:!0};if(this.beforeEachGuard)try{const e=await this.beforeEachGuard(h,n);if(s!==this.navigationId)return{success:!1,cancelled:!0};if(!1===e)return{success:!1,cancelled:!0};if("string"==typeof e)return this.navigate(e,t)}catch(a){return s!==this.navigationId?{success:!1,cancelled:!0}:{success:!1,error:a instanceof Error?a.message:"Guard Error"}}return s!==this.navigationId?{success:!1,cancelled:!0}:(this.currentRoute=h,i||this.updateBrowserHistory(r,t),this.notifyListeners(),this.afterEachGuard&&this.afterEachGuard(h,n),{success:!0})}finally{this.pendingNavId===s&&(this.pendingNavId=null,s===this.navigationId&&this.markReady())}}resolve(e="/"){const t=this.normalizePath(e);if("hash"===this.mode)return`#${t}`;const i=this.base.endsWith("/")?this.base.slice(0,-1):this.base;return"/"===i?t:i+t}get modeType(){return this.mode}pushWithQuery(e="/",t){const i=new URLSearchParams(t).toString(),s=e.includes("?")?"&":"?";return this.push(e+(i?s+i:""))}push(e="/"){return this.navigate(e,!1)}replace(e="/"){return this.navigate(e,!0)}back(){window.history.back()}forward(){window.history.forward()}listen(e){return this.listeners.add(e),()=>this.listeners.delete(e)}notifyListeners(){this.listeners.forEach(e=>e())}isStarted=!1;handleRouteChange=null;setupListeners(){this.isStarted||(this.isStarted=!0,this.handleRouteChange=()=>{this.navigate(this.getPath(),!0,!0)},"hash"===this.mode?window.addEventListener("hashchange",this.handleRouteChange):window.addEventListener("popstate",this.handleRouteChange),"hash"!==this.mode||window.location.hash||(window.location.hash="/"),this.navigate(this.getPath(),!0).catch(t=>{e&&console.error("[Router] 首导航异常:",t)}))}destroy(){this.navigationId++,this.handleRouteChange&&("hash"===this.mode?window.removeEventListener("hashchange",this.handleRouteChange):window.removeEventListener("popstate",this.handleRouteChange),this.handleRouteChange=null),this.isStarted=!1,this.listeners.clear(),this.componentCache.clear();for(const e of this.keepAliveCache.values())e.dispose?.();this.keepAliveCache.clear(),this.keepAliveKeys=[],this.currentRoute=null,this.navigated=!1,this.pendingNavId=null,this.readyDeferred?.resolve(),this.readyDeferred=null,t=null}getCurrentRoute(){return this.currentRoute}get hasNavigated(){return this.navigated}get isNavigating(){return null!==this.pendingNavId}isReady(){if(this.navigated&&null===this.pendingNavId)return Promise.resolve();if(!this.readyDeferred){let e;const t=new Promise(t=>{e=t});this.readyDeferred={promise:t,resolve:e}}return this.readyDeferred.promise}markReady(){this.navigated=!0,this.readyDeferred?.resolve(),this.readyDeferred=null}getKeepAlive(e){const t=this.keepAliveCache.get(e);if(t){const t=this.keepAliveKeys.indexOf(e);-1!==t&&(this.keepAliveKeys.splice(t,1),this.keepAliveKeys.push(e))}return t}setKeepAlive(e,t){if(this.keepAliveCache.has(e)){const i=this.keepAliveCache.get(e);i&&i!==t&&i.dispose?.(),this.keepAliveCache.set(e,t);const s=this.keepAliveKeys.indexOf(e);-1!==s&&(this.keepAliveKeys.splice(s,1),this.keepAliveKeys.push(e))}else this.keepAliveCache.set(e,t),this.keepAliveKeys.push(e),this.evictKeepAlive()}hasKeepAlive(e){return this.keepAliveCache.has(e)}evictKeepAlive(){if(this.maxKeepAlive)for(;this.keepAliveKeys.length>this.maxKeepAlive;){const e=this.keepAliveKeys.shift();if(e){const t=this.keepAliveCache.get(e);t?.dispose?.(),this.keepAliveCache.delete(e)}}}cacheKey(e){return this.normalizePath(e)}prefetch(e){const t=this.matchRoute(e);if(!t)return;const i=this.cacheKey(t.fullPath),s=t.matched[t.matched.length-1];if(!s?.config.component)return;const a=s.config.component;if("function"!=typeof a)return;if(this.componentCache.has(i))return;const r=a();this.componentCache.set(i,r),r.catch(()=>{this.componentCache.delete(i)})}getComponentFromCache(e){return this.componentCache.get(this.cacheKey(e))}}export{o as Router,n as createRouter,h as getRouter,r as routerReady};
@@ -1,7 +1,7 @@
1
- import { Router, getRouter, routerReady } from './core';
2
- import { default as RouterView } from './router-view';
3
- import { default as RouterLink } from './router-link';
4
- import { RouteConfig, RouteMatch, NavigationGuard, RouterOptions, NavigationResult } from './types';
1
+ import { Router, getRouter, routerReady } from './core.js';
2
+ import { default as RouterView } from './router-view.js';
3
+ import { default as RouterLink } from './router-link.js';
4
+ import { RouteConfig, RouteMatch, NavigationGuard, RouterOptions, NavigationResult } from './types.js';
5
5
  /**
6
6
  * 创建路由器实例(自动注册 RouterView 和 RouterLink 组件)
7
7
  * @param options 路由器配置选项
@@ -1,4 +1,4 @@
1
- import { BaseElement } from '../runtime/component';
1
+ import { BaseElement } from '../runtime/component/index.js';
2
2
  declare class RouterLink extends BaseElement<{
3
3
  active: boolean;
4
4
  to: string;
@@ -1 +1 @@
1
- "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./core.cjs"),t=require("../runtime/component/base-element.cjs"),r=require("../runtime/component/decorators.cjs");Object.getOwnPropertyDescriptor;const o=new WeakMap;exports.default=class extends t.default{unsubscribe;level=0;currentElement=null;currentTagName=null;managedNodes=new Set;scheduled=!1;latestLoadId=0;abortController=null;disposed=!1;router=null;async mounted(){this.disposed=!1,this.detectLevel(),this.router=await e.routerReady(),this.disposed||(this.unsubscribe=this.router.listen(()=>this.scheduleLoad()),this.loadRoute(this.router.getCurrentRoute()))}unmounted(){this.disposed=!0,this.abortController?.abort(),this.abortController=null,this.unsubscribe?.(),this.clear()}scheduleLoad(){!this.router||this.scheduled||this.disposed||(this.scheduled=!0,queueMicrotask(()=>{this.scheduled=!1,!this.disposed&&this.router&&this.loadRoute(this.router.getCurrentRoute())}))}detectLevel(){let e=0,t=this.parentElement;for(;t;){const r=t.closest("router-view");if(r){if(e++,t=r.parentElement,!t){const e=r.getRootNode();t=e instanceof ShadowRoot?e.host:null}}else{const e=t.getRootNode();t=e instanceof ShadowRoot?e.host:null}}this.level=e}async loadRoute(e){this.abortController&&(this.abortController.abort(),this.abortController=null);const t=++this.latestLoadId,r=e?.matched[this.level];if(!r)return void this.handleEmptyRoute(e);const{config:o}=r;let s=o.tagName;if(!s&&"function"==typeof o.component){this.renderLoading();const r=new AbortController;this.abortController=r;try{const n=this.router?.getComponentFromCache?.(e?.fullPath),i=n?await n:await o.component();if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;s="string"==typeof i?i:i.tagName}catch(n){if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;return void this.renderError(`Load Error: ${n}`)}finally{this.abortController===r&&(this.abortController=null)}}if(t===this.latestLoadId&&!this.disposed)if(s)if(!o.forceReload&&this.currentElement&&this.currentTagName===s.toLowerCase())this.syncState(this.currentElement,e?.params||{},e?.query||{},o.props);else{this.clear();const t=this.getOrCreateComponent(s,o,e);this.syncState(t,e?.params||{},e?.query||{},o.props),this.appendManagedNode(t),this.currentElement=t,this.currentTagName=s.toLowerCase()}else this.clear()}syncState(e,t,r,s={}){const n=e=>e.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase(),i=function(e){let t=o.get(e);return t||(t={routerAttrs:new Set,propKeys:new Set},o.set(e,t)),t}(e),a=new Map;Object.entries(t).forEach(([e,t])=>a.set(n(e),String(t))),Object.entries(r).forEach(([e,t])=>a.set(`query-${n(e)}`,String(t))),i.routerAttrs.forEach(t=>{a.has(t)||(e.removeAttribute(t),i.routerAttrs.delete(t))}),a.forEach((t,r)=>{e.getAttribute(r)!==t&&e.setAttribute(r,t),i.routerAttrs.add(r)});const l=new Set(Object.keys(s)),d=e;i.propKeys.forEach(e=>{l.has(e)||(d[e]=void 0)}),Object.entries(s).forEach(([e,t])=>{d[e]!==t&&(d[e]=t)}),i.propKeys=l}getOrCreateComponent(e,t,r){if(!r)throw new Error("Route is required to create or retrieve component");const o=t.keepAliveKey?t.keepAliveKey(r,this.level):this.buildKeepAliveKey(e,r),s=t.keepAlive&&this.router?.getKeepAlive(o);if(s)return s;const n=document.createElement(e);return t.keepAlive&&this.router?.setKeepAlive(o,n),n}buildKeepAliveKey(e,t){const r=t.matched[this.level],o=r?.config.path??e.toLowerCase(),s=Object.values(r?.params??{});return s.length?`${this.level}:${o}:${s.join("|")}`:`${this.level}:${o}`}handleEmptyRoute(e){if(0===this.level){this.clear();const t=e?.matched?.[0],r=t?.config?.notFoundComponent||this.$data.notFound;if(r){const e=document.createElement(r);this.appendManagedNode(e),this.currentElement=e,this.currentTagName=r.toLowerCase()}else this.renderError("404 Not Found")}else this.clear()}appendManagedNode(e){e.parentNode!==this&&this.appendChild(e),this.managedNodes.add(e)}clear(){this.managedNodes.forEach(e=>{e.parentNode===this&&this.removeChild(e)}),this.managedNodes.clear(),this.currentElement=null,this.currentTagName=null}renderLoading(){this.clear();const e=document.createElement("div");e.style.cssText="padding:20px; color:#999;",e.textContent="Loading...",this.appendManagedNode(e)}renderError(e){this.clear();const t=document.createElement("div");t.style.cssText="padding:20px; color:#ff4d4f;",t.textContent=e,this.appendManagedNode(t)}},exports.default=((e,t)=>{for(var r,o=t,s=e.length-1;s>=0;s--)(r=e[s])&&(o=r(o)||o);return o})([r.CustomElement({tagName:"router-view",props:[{name:"notFound",type:"string",default:""}]})],exports.default);
1
+ "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./core.cjs"),t=require("../shared/env.cjs"),r=require("../runtime/component/base-element.cjs"),s=require("../runtime/component/decorators.cjs");Object.getOwnPropertyDescriptor;const o=new WeakMap;exports.default=class extends r.default{unsubscribe;level=0;currentElement=null;currentTagName=null;managedNodes=new Set;scheduled=!1;latestLoadId=0;abortController=null;disposed=!1;router=null;warnTimer;async mounted(){if(this.disposed=!1,this.detectLevel(),this.router=await e.routerReady(),!this.disposed){if(this.unsubscribe=this.router.listen(()=>this.scheduleLoad()),null===this.router.getCurrentRoute()){const r=this.latestLoadId;for(this.router.hasNavigated&&!this.router.isNavigating||(this.renderPending(),t.IS_DEV&&!this.router.hasNavigated&&this.warnIfNeverStarted()),await this.router.isReady();!this.disposed&&null===this.router.getCurrentRoute()&&this.router.isNavigating;)await this.router.isReady();if(this.disposed)return;if(e.getRouter()!==this.router)return;if(this.latestLoadId!==r)return}this.loadRoute(this.router.getCurrentRoute())}}unmounted(){this.disposed=!0,void 0!==this.warnTimer&&(window.clearTimeout(this.warnTimer),this.warnTimer=void 0),this.abortController?.abort(),this.abortController=null,this.unsubscribe?.(),this.clear()}scheduleLoad(){!this.router||this.scheduled||this.disposed||(this.scheduled=!0,queueMicrotask(()=>{this.scheduled=!1,!this.disposed&&this.router&&this.loadRoute(this.router.getCurrentRoute())}))}warnIfNeverStarted(){this.warnTimer=window.setTimeout(()=>{this.warnTimer=void 0,!this.disposed&&this.router&&!1===this.router.hasNavigated&&console.warn("[router-view] 首次导航 3s 内仍未完成,router-view 会保持占位状态:若尚未调用 router.setupListeners() 请补上;若守卫确实耗时较长,可忽略此提示")},3e3)}detectLevel(){let e=0,t=this.parentElement;for(;t;){const r=t.closest("router-view");if(r){if(e++,t=r.parentElement,!t){const e=r.getRootNode();t=e instanceof ShadowRoot?e.host:null}}else{const e=t.getRootNode();t=e instanceof ShadowRoot?e.host:null}}this.level=e}async loadRoute(e){this.abortController&&(this.abortController.abort(),this.abortController=null);const t=++this.latestLoadId,r=e?.matched[this.level];if(!r)return void this.handleEmptyRoute();const{config:s}=r;let o=s.tagName;if(!o&&"function"==typeof s.component){this.renderLoading();const r=new AbortController;this.abortController=r;try{const i=this.router?.getComponentFromCache?.(e?.fullPath),n=i?await i:await s.component();if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;o="string"==typeof n?n:n.tagName}catch(i){if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;return void this.renderError(`Load Error: ${i}`)}finally{this.abortController===r&&(this.abortController=null)}}if(t===this.latestLoadId&&!this.disposed)if(o)if(!s.forceReload&&this.currentElement&&this.currentTagName===o.toLowerCase())this.syncState(this.currentElement,e?.params||{},e?.query||{},s.props);else{this.clear();const t=this.getOrCreateComponent(o,s,e);this.syncState(t,e?.params||{},e?.query||{},s.props),this.appendManagedNode(t),this.currentElement=t,this.currentTagName=o.toLowerCase()}else this.clear()}syncState(e,t,r,s={}){const i=e=>e.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase(),n=function(e){let t=o.get(e);return t||(t={routerAttrs:new Set,propKeys:new Set},o.set(e,t)),t}(e),a=new Map;Object.entries(t).forEach(([e,t])=>a.set(i(e),String(t))),Object.entries(r).forEach(([e,t])=>a.set(`query-${i(e)}`,String(t))),n.routerAttrs.forEach(t=>{a.has(t)||(e.removeAttribute(t),n.routerAttrs.delete(t))}),a.forEach((t,r)=>{e.getAttribute(r)!==t&&e.setAttribute(r,t),n.routerAttrs.add(r)});const d=new Set(Object.keys(s)),l=e;n.propKeys.forEach(e=>{d.has(e)||(l[e]=void 0)}),Object.entries(s).forEach(([e,t])=>{l[e]!==t&&(l[e]=t)}),n.propKeys=d}getOrCreateComponent(e,t,r){if(!r)throw new Error("Route is required to create or retrieve component");const s=t.keepAliveKey?t.keepAliveKey(r,this.level):this.buildKeepAliveKey(e,r),o=t.keepAlive&&this.router?.getKeepAlive(s);if(o)return o;const i=document.createElement(e);return t.keepAlive&&this.router?.setKeepAlive(s,i),i}buildKeepAliveKey(e,t){const r=t.matched[this.level],s=r?.config.path??e.toLowerCase(),o=Object.values(r?.params??{});return o.length?`${this.level}:${s}:${o.join("|")}`:`${this.level}:${s}`}handleEmptyRoute(){if(0===this.level){this.clear();const e=this.$data.notFound;if(e){const t=document.createElement(e);this.appendManagedNode(t),this.currentElement=t,this.currentTagName=e.toLowerCase()}else this.renderError("404 Not Found")}else this.clear()}appendManagedNode(e){e.parentNode!==this&&this.appendChild(e),this.managedNodes.add(e)}clear(){this.managedNodes.forEach(e=>{e.parentNode===this&&this.removeChild(e)}),this.managedNodes.clear(),this.currentElement=null,this.currentTagName=null}renderPlaceholder(e){this.clear();const t=this.$data.loading;if(t)return void this.appendManagedNode(document.createElement(t));if(!e)return;const r=document.createElement("div");r.style.cssText="padding:20px; color:#999;",r.textContent=e,this.appendManagedNode(r)}renderLoading(){this.renderPlaceholder("Loading...")}renderPending(){this.renderPlaceholder()}renderError(e){this.clear();const t=document.createElement("div");t.style.cssText="padding:20px; color:#ff4d4f;",t.textContent=e,this.appendManagedNode(t)}},exports.default=((e,t)=>{for(var r,s=t,o=e.length-1;o>=0;o--)(r=e[o])&&(s=r(s)||s);return s})([s.CustomElement({tagName:"router-view",props:[{name:"notFound",type:"string",default:""},{name:"loading",type:"string",default:""}]})],exports.default);
@@ -1,7 +1,8 @@
1
- import { BaseElement } from '../runtime/component';
2
- import { RouteMatch } from './types';
1
+ import { BaseElement } from '../runtime/component/index.js';
2
+ import { RouteMatch } from './types.js';
3
3
  declare class RouterView extends BaseElement<{
4
4
  notFound: string;
5
+ loading: string;
5
6
  }> {
6
7
  private unsubscribe?;
7
8
  private level;
@@ -13,9 +14,12 @@ declare class RouterView extends BaseElement<{
13
14
  private abortController;
14
15
  private disposed;
15
16
  private router;
17
+ private warnTimer?;
16
18
  mounted(): Promise<void>;
17
19
  unmounted(): void;
18
20
  private scheduleLoad;
21
+ /** DEV 提示:首导航 3s 内未 settle —— 可能是忘了 setupListeners(),也可能是守卫本身很慢 */
22
+ private warnIfNeverStarted;
19
23
  private detectLevel;
20
24
  loadRoute(route: RouteMatch | null): Promise<void>;
21
25
  private syncState;
@@ -24,7 +28,13 @@ declare class RouterView extends BaseElement<{
24
28
  private handleEmptyRoute;
25
29
  private appendManagedNode;
26
30
  private clear;
31
+ /**
32
+ * 渲染占位内容:优先使用 `loading` 指定的占位组件,未配置时按需渲染兜底文本。
33
+ * 启动阶段(首导航未完成)不传 fallbackText,保持空白。
34
+ */
35
+ private renderPlaceholder;
27
36
  private renderLoading;
37
+ private renderPending;
28
38
  private renderError;
29
39
  }
30
40
  export default RouterView;
@@ -1 +1 @@
1
- import{routerReady as e}from"./core.js";import t from"../runtime/component/base-element.js";import{CustomElement as r}from"../runtime/component/decorators.js";Object.getOwnPropertyDescriptor;const o=new WeakMap;let s=class extends t{unsubscribe;level=0;currentElement=null;currentTagName=null;managedNodes=new Set;scheduled=!1;latestLoadId=0;abortController=null;disposed=!1;router=null;async mounted(){this.disposed=!1,this.detectLevel(),this.router=await e(),this.disposed||(this.unsubscribe=this.router.listen(()=>this.scheduleLoad()),this.loadRoute(this.router.getCurrentRoute()))}unmounted(){this.disposed=!0,this.abortController?.abort(),this.abortController=null,this.unsubscribe?.(),this.clear()}scheduleLoad(){!this.router||this.scheduled||this.disposed||(this.scheduled=!0,queueMicrotask(()=>{this.scheduled=!1,!this.disposed&&this.router&&this.loadRoute(this.router.getCurrentRoute())}))}detectLevel(){let e=0,t=this.parentElement;for(;t;){const r=t.closest("router-view");if(r){if(e++,t=r.parentElement,!t){const e=r.getRootNode();t=e instanceof ShadowRoot?e.host:null}}else{const e=t.getRootNode();t=e instanceof ShadowRoot?e.host:null}}this.level=e}async loadRoute(e){this.abortController&&(this.abortController.abort(),this.abortController=null);const t=++this.latestLoadId,r=e?.matched[this.level];if(!r)return void this.handleEmptyRoute(e);const{config:o}=r;let s=o.tagName;if(!s&&"function"==typeof o.component){this.renderLoading();const r=new AbortController;this.abortController=r;try{const n=this.router?.getComponentFromCache?.(e?.fullPath),i=n?await n:await o.component();if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;s="string"==typeof i?i:i.tagName}catch(n){if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;return void this.renderError(`Load Error: ${n}`)}finally{this.abortController===r&&(this.abortController=null)}}if(t===this.latestLoadId&&!this.disposed)if(s)if(!o.forceReload&&this.currentElement&&this.currentTagName===s.toLowerCase())this.syncState(this.currentElement,e?.params||{},e?.query||{},o.props);else{this.clear();const t=this.getOrCreateComponent(s,o,e);this.syncState(t,e?.params||{},e?.query||{},o.props),this.appendManagedNode(t),this.currentElement=t,this.currentTagName=s.toLowerCase()}else this.clear()}syncState(e,t,r,s={}){const n=e=>e.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase(),i=function(e){let t=o.get(e);return t||(t={routerAttrs:new Set,propKeys:new Set},o.set(e,t)),t}(e),a=new Map;Object.entries(t).forEach(([e,t])=>a.set(n(e),String(t))),Object.entries(r).forEach(([e,t])=>a.set(`query-${n(e)}`,String(t))),i.routerAttrs.forEach(t=>{a.has(t)||(e.removeAttribute(t),i.routerAttrs.delete(t))}),a.forEach((t,r)=>{e.getAttribute(r)!==t&&e.setAttribute(r,t),i.routerAttrs.add(r)});const l=new Set(Object.keys(s)),d=e;i.propKeys.forEach(e=>{l.has(e)||(d[e]=void 0)}),Object.entries(s).forEach(([e,t])=>{d[e]!==t&&(d[e]=t)}),i.propKeys=l}getOrCreateComponent(e,t,r){if(!r)throw new Error("Route is required to create or retrieve component");const o=t.keepAliveKey?t.keepAliveKey(r,this.level):this.buildKeepAliveKey(e,r),s=t.keepAlive&&this.router?.getKeepAlive(o);if(s)return s;const n=document.createElement(e);return t.keepAlive&&this.router?.setKeepAlive(o,n),n}buildKeepAliveKey(e,t){const r=t.matched[this.level],o=r?.config.path??e.toLowerCase(),s=Object.values(r?.params??{});return s.length?`${this.level}:${o}:${s.join("|")}`:`${this.level}:${o}`}handleEmptyRoute(e){if(0===this.level){this.clear();const t=e?.matched?.[0],r=t?.config?.notFoundComponent||this.$data.notFound;if(r){const e=document.createElement(r);this.appendManagedNode(e),this.currentElement=e,this.currentTagName=r.toLowerCase()}else this.renderError("404 Not Found")}else this.clear()}appendManagedNode(e){e.parentNode!==this&&this.appendChild(e),this.managedNodes.add(e)}clear(){this.managedNodes.forEach(e=>{e.parentNode===this&&this.removeChild(e)}),this.managedNodes.clear(),this.currentElement=null,this.currentTagName=null}renderLoading(){this.clear();const e=document.createElement("div");e.style.cssText="padding:20px; color:#999;",e.textContent="Loading...",this.appendManagedNode(e)}renderError(e){this.clear();const t=document.createElement("div");t.style.cssText="padding:20px; color:#ff4d4f;",t.textContent=e,this.appendManagedNode(t)}};s=((e,t)=>{for(var r,o=t,s=e.length-1;s>=0;s--)(r=e[s])&&(o=r(o)||o);return o})([r({tagName:"router-view",props:[{name:"notFound",type:"string",default:""}]})],s);export{s as default};
1
+ import{routerReady as e,getRouter as t}from"./core.js";import{IS_DEV as r}from"../shared/env.js";import o from"../runtime/component/base-element.js";import{CustomElement as s}from"../runtime/component/decorators.js";Object.getOwnPropertyDescriptor;const i=new WeakMap;let n=class extends o{unsubscribe;level=0;currentElement=null;currentTagName=null;managedNodes=new Set;scheduled=!1;latestLoadId=0;abortController=null;disposed=!1;router=null;warnTimer;async mounted(){if(this.disposed=!1,this.detectLevel(),this.router=await e(),!this.disposed){if(this.unsubscribe=this.router.listen(()=>this.scheduleLoad()),null===this.router.getCurrentRoute()){const e=this.latestLoadId;for(this.router.hasNavigated&&!this.router.isNavigating||(this.renderPending(),r&&!this.router.hasNavigated&&this.warnIfNeverStarted()),await this.router.isReady();!this.disposed&&null===this.router.getCurrentRoute()&&this.router.isNavigating;)await this.router.isReady();if(this.disposed)return;if(t()!==this.router)return;if(this.latestLoadId!==e)return}this.loadRoute(this.router.getCurrentRoute())}}unmounted(){this.disposed=!0,void 0!==this.warnTimer&&(window.clearTimeout(this.warnTimer),this.warnTimer=void 0),this.abortController?.abort(),this.abortController=null,this.unsubscribe?.(),this.clear()}scheduleLoad(){!this.router||this.scheduled||this.disposed||(this.scheduled=!0,queueMicrotask(()=>{this.scheduled=!1,!this.disposed&&this.router&&this.loadRoute(this.router.getCurrentRoute())}))}warnIfNeverStarted(){this.warnTimer=window.setTimeout(()=>{this.warnTimer=void 0,!this.disposed&&this.router&&!1===this.router.hasNavigated&&console.warn("[router-view] 首次导航 3s 内仍未完成,router-view 会保持占位状态:若尚未调用 router.setupListeners() 请补上;若守卫确实耗时较长,可忽略此提示")},3e3)}detectLevel(){let e=0,t=this.parentElement;for(;t;){const r=t.closest("router-view");if(r){if(e++,t=r.parentElement,!t){const e=r.getRootNode();t=e instanceof ShadowRoot?e.host:null}}else{const e=t.getRootNode();t=e instanceof ShadowRoot?e.host:null}}this.level=e}async loadRoute(e){this.abortController&&(this.abortController.abort(),this.abortController=null);const t=++this.latestLoadId,r=e?.matched[this.level];if(!r)return void this.handleEmptyRoute();const{config:o}=r;let s=o.tagName;if(!s&&"function"==typeof o.component){this.renderLoading();const r=new AbortController;this.abortController=r;try{const i=this.router?.getComponentFromCache?.(e?.fullPath),n=i?await i:await o.component();if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;s="string"==typeof n?n:n.tagName}catch(i){if(r.signal.aborted||t!==this.latestLoadId||this.disposed)return;return void this.renderError(`Load Error: ${i}`)}finally{this.abortController===r&&(this.abortController=null)}}if(t===this.latestLoadId&&!this.disposed)if(s)if(!o.forceReload&&this.currentElement&&this.currentTagName===s.toLowerCase())this.syncState(this.currentElement,e?.params||{},e?.query||{},o.props);else{this.clear();const t=this.getOrCreateComponent(s,o,e);this.syncState(t,e?.params||{},e?.query||{},o.props),this.appendManagedNode(t),this.currentElement=t,this.currentTagName=s.toLowerCase()}else this.clear()}syncState(e,t,r,o={}){const s=e=>e.replace(/([a-z])([A-Z])/g,"$1-$2").toLowerCase(),n=function(e){let t=i.get(e);return t||(t={routerAttrs:new Set,propKeys:new Set},i.set(e,t)),t}(e),a=new Map;Object.entries(t).forEach(([e,t])=>a.set(s(e),String(t))),Object.entries(r).forEach(([e,t])=>a.set(`query-${s(e)}`,String(t))),n.routerAttrs.forEach(t=>{a.has(t)||(e.removeAttribute(t),n.routerAttrs.delete(t))}),a.forEach((t,r)=>{e.getAttribute(r)!==t&&e.setAttribute(r,t),n.routerAttrs.add(r)});const d=new Set(Object.keys(o)),l=e;n.propKeys.forEach(e=>{d.has(e)||(l[e]=void 0)}),Object.entries(o).forEach(([e,t])=>{l[e]!==t&&(l[e]=t)}),n.propKeys=d}getOrCreateComponent(e,t,r){if(!r)throw new Error("Route is required to create or retrieve component");const o=t.keepAliveKey?t.keepAliveKey(r,this.level):this.buildKeepAliveKey(e,r),s=t.keepAlive&&this.router?.getKeepAlive(o);if(s)return s;const i=document.createElement(e);return t.keepAlive&&this.router?.setKeepAlive(o,i),i}buildKeepAliveKey(e,t){const r=t.matched[this.level],o=r?.config.path??e.toLowerCase(),s=Object.values(r?.params??{});return s.length?`${this.level}:${o}:${s.join("|")}`:`${this.level}:${o}`}handleEmptyRoute(){if(0===this.level){this.clear();const e=this.$data.notFound;if(e){const t=document.createElement(e);this.appendManagedNode(t),this.currentElement=t,this.currentTagName=e.toLowerCase()}else this.renderError("404 Not Found")}else this.clear()}appendManagedNode(e){e.parentNode!==this&&this.appendChild(e),this.managedNodes.add(e)}clear(){this.managedNodes.forEach(e=>{e.parentNode===this&&this.removeChild(e)}),this.managedNodes.clear(),this.currentElement=null,this.currentTagName=null}renderPlaceholder(e){this.clear();const t=this.$data.loading;if(t)return void this.appendManagedNode(document.createElement(t));if(!e)return;const r=document.createElement("div");r.style.cssText="padding:20px; color:#999;",r.textContent=e,this.appendManagedNode(r)}renderLoading(){this.renderPlaceholder("Loading...")}renderPending(){this.renderPlaceholder()}renderError(e){this.clear();const t=document.createElement("div");t.style.cssText="padding:20px; color:#ff4d4f;",t.textContent=e,this.appendManagedNode(t)}};n=((e,t)=>{for(var r,o=t,s=e.length-1;s>=0;s--)(r=e[s])&&(o=r(o)||o);return o})([s({tagName:"router-view",props:[{name:"notFound",type:"string",default:""},{name:"loading",type:"string",default:""}]})],n);export{n as default};
@@ -41,7 +41,9 @@ export interface RouteConfig {
41
41
  */
42
42
  async?: boolean;
43
43
  /** * 404 页面组件标签名。
44
- * 当没有匹配到路由时显示的组件,优先级高于 RouterView 的 not-found 属性。
44
+ * @deprecated 该字段从未生效:路径不匹配时 `matchRoute()` 直接返回 null,
45
+ * 不存在可读取的 config,因此无法取到本字段。
46
+ * 请改用 `{ path: '*', tagName: 'xxx' }` 兜底路由,或 RouterView 的 `not-found` 属性。
45
47
  */
46
48
  notFoundComponent?: string;
47
49
  }
@@ -1 +1 @@
1
- "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../shared/is-object.cjs"),t=require("../../shared/env.cjs"),s=require("../../shared/case-convert.cjs"),i=require("../reactivity/observe.cjs"),r=require("../renderer/renderIR.cjs"),a=Symbol.for("solely.manifest"),o="undefined"!=typeof HTMLElement?HTMLElement:class{};function n(e){if(null===e||"object"!=typeof e)return e;const t=globalThis.structuredClone;if("function"==typeof t)try{return t(e)}catch{}try{return JSON.parse(JSON.stringify(e))}catch{return e}}class c extends o{$refs={};#e;#t;#s;#i;#r;#a;#o=!1;#n=!1;#c=!1;#d=!1;#h=!1;#l=!1;#u=!1;#p=new Set;#f=!1;#b=!1;static#y=new Map;static#m=new WeakSet;#g=new Map;static#S=new Set(["$data","$refs","constructor","created","mounted","beforeUpdate","updated","unmounted","attributeChanged","beforeAttributesUpdate","afterAttributesUpdate","emit","emitNative","refresh","dispose","warn","error"]);static get observedAttributes(){const e=this[a];return e?.attributeMap?Array.from(e.attributeMap.keys()):[]}constructor(e={}){super();const t=this.constructor;this.#e=t[a]||{tagName:"base-element"};const s=this.#e;this.#r=s.shadowDOM?.use?this.attachShadow({mode:s.shadowDOM.mode||"open"}):this,this.#v(e),this.#A(s),queueMicrotask(()=>this.#O())}#C(){const e=Object.getOwnPropertyNames(this),t=["#","_"],s=c.#S,i=new Map;let r=Object.getPrototypeOf(this);for(;r&&r!==o.prototype;){const e=Object.getOwnPropertyDescriptors(r);for(const[t,s]of Object.entries(e))s.set&&!i.has(t)&&i.set(t,s);r=Object.getPrototypeOf(r)}for(const a of e){if(s.has(a))continue;if(t.some(e=>a.startsWith(e)))continue;const e=Object.getOwnPropertyDescriptor(this,a);if(!e||!("value"in e))continue;const r=e.value,o=i.get(a);o?.set&&(delete this[a],this[a]=r)}}#v(e){t.IS_DEV&&e&&"object"==typeof e&&(c.#m.has(e)&&console.warn(`[Solely] <${this.#e.tagName}>: 该初始数据对象已被其他实例使用,$data 会共享同一响应式代理(改一个实例会同时触发另一个实例刷新)。如需实例隔离,请为每个实例传入新对象。`),c.#m.add(e));const{proxy:s,dispose:r}=i.observe(e,e=>{if("set"===e.type||"array-replace"===e.type){const{key:t,newValue:s}=e,i=this.#e,r=String(t),a=i.propMap?.get(r);a?.reflect&&this.#R(a,s)}!1!==this.#e.dataChangeEvent&&this.emit("dataChange",{...e}),this.#w()});this.#i=s,this.#a=r}#R(e,t){const i=s.camelToKebab(e.name);this.#p.add(i);try{if(null==t)return void this.removeAttribute(i);if("boolean"===e.type)t?this.setAttribute(i,""):this.removeAttribute(i);else{const e="object"==typeof t?JSON.stringify(t):String(t);this.setAttribute(i,e)}}finally{this.#p.delete(i)}}#A(e){e.ir&&(this.#s=e.ir)}#j(e){const t=this.#g.get(e);if(void 0!==t)return t;let s=null,i=Object.getPrototypeOf(this);for(;i&&i!==o.prototype;){const t=Object.getOwnPropertyDescriptor(i,e);if(t){s=t.get||t.set?t:null;break}i=Object.getPrototypeOf(i)}return this.#g.set(e,s),s}#$(e,t){const s=this.#j(e.name);s?.set?this[e.name]=t:this.$data[e.name]=t}#N(){const e=this.#e;if(e.attributeMap)for(const[,t]of e.attributeMap)if(!1!==t.reactive&&!this.#j(t.name)){const e=Object.getOwnPropertyDescriptor(this,t.name);e&&"value"in e&&(this.$data[t.name]=e.value,delete this[t.name]),Object.defineProperty(this,t.name,{get:()=>this.$data[t.name],set:e=>{this.$data[t.name]=e},configurable:!0,enumerable:!0})}}#P(){this.#u||(this.#u=!0,this.#N())}get $data(){return this.#i}set $data(t){e.isObject(t)||(t={}),t!==this.#i&&(this.#a?.(),this.#v(t),this.#P(),this.#w())}#M(e,t,s){if(null===e)return"boolean"!==s&&t;switch(s){case"boolean":return!0;case"number":{const s=Number(e);return isNaN(s)?t:s}case"object":try{return JSON.parse(e)}catch(i){return console.error(`[Solely] Failed to parse object value: "${e}", using default value.`,i),t}case"array":try{const s=JSON.parse(e);return Array.isArray(s)?s:t}catch(i){return console.error(`[Solely] Failed to parse array value: "${e}", using default value.`,i),t}default:return e}}#w(){this.#f||(this.#h?!this.#n&&this.#t&&(this.#n=!0,queueMicrotask(()=>{this.#f||(this.#n=!1,this.#D())})):this.#l=!0)}#D(){if(!this.#f&&!this.#o&&this.#h){this.#o=!0;try{this.#c&&this.beforeAttributesUpdate(),this.beforeUpdate(),this.#t?.update(),this.updated(),this.#c&&(this.afterAttributesUpdate(),this.#c=!1)}finally{this.#o=!1}}}refresh(){this.#w()}#E(){const e=this.#e;if(!e.styles)return;const s=this.#r;if(e.sheet&&s instanceof ShadowRoot&&"adoptedStyleSheets"in s){if(!s.adoptedStyleSheets.includes(e.sheet)){const t=Array.from(s.adoptedStyleSheets);t.push(e.sheet),s.adoptedStyleSheets=t}return void(this.#b=!0)}const i=s instanceof ShadowRoot?s:document.head,r=`solely-style-${t.SOLELY_VERSION}-${e.tagName}`,a=!e.shadowDOM?.use,o="undefined"!=typeof CSS&&CSS.escape?CSS.escape(r):r.replace(/([.#:[\]()!])/g,"\\$1");if(!i.querySelector(`#${o}`)){const t=document.createElement("style");t.id=r,t.textContent=e.styles,i.appendChild(t)}if(a){const e=c.#y.get(r)||0;c.#y.set(r,e+1),this.#b=!0}}#U(){if(!this.#b)return;this.#b=!1;const e=this.#e;if(!e.shadowDOM?.use&&e.styles){const s=`solely-style-${t.SOLELY_VERSION}-${e.tagName}`,i=c.#y.get(s)||0;if(i<=1){const e="undefined"!=typeof CSS&&CSS.escape?CSS.escape(s):s.replace(/([.#:[\]()!])/g,"\\$1");document.head.querySelector(`#${e}`)?.remove(),c.#y.delete(s)}else c.#y.set(s,i-1)}}connectedCallback(){if(this.#f)return t.IS_DEV&&console.error(`[Solely] <${this.tagName.toLowerCase()}> has been disposed and cannot be reconnected.`),void this.remove();this.#h=!0;const s=this.#e;if(this.#O(),(s.className||s.tagName||"").split(" ").forEach(e=>e&&this.classList.add(e)),this.#E(),s.attributeMap&&e.isObject(this.$data)){this.#P();for(const[e,t]of s.attributeMap){const s=t.name;if(this.hasAttribute(e)){const s=this.getAttribute(e),i=this.#M(s,n(t.default),t.type);this.#$(t,i)}else"default"in t&&void 0===this.$data[s]&&(this.#$(t,n(t.default)),"boolean"===t.type&&!0===t.default&&this.setAttribute(e,""))}}this.#C(),this.#s&&!this.#t&&(this.#t=r.createRender(this.#s,this.#r,this)),this.#l&&(this.#l=!1,this.#w()),this.mounted()}disconnectedCallback(){this.#h=!1,this.#f||this.#U(),this.unmounted()}attributeChangedCallback(t,s,i){if(this.#f||s===i||!e.isObject(this.$data))return;if(this.#p.has(t))return;const r=this.#e,a=r.attributeMap?.get(t);if(!a)return;const o=a.name,c=this.$data[o],d=void 0!==a.default?n(a.default):c,h=this.#M(i,d,a.type);c!==h&&(this.#c=!0,this.#$(a,h),this.$data[o]===c&&(this.#c=!1),this.attributeChanged(t,c,h))}#O(){this.#d||(this.#d=!0,this.created())}emit(e,t,s){this.#f||this.dispatchEvent(new CustomEvent(e,{bubbles:!0,composed:!0,detail:t,...s}))}emitNative(e,t){this.#f||this.dispatchEvent(new Event(e,{bubbles:!0,composed:!0,...t}))}warn(e,s){if(t.IS_DEV&&e){const e=this.tagName.toLowerCase();console.warn(`[${e}] ${s}`)}}error(e,s){if(t.IS_DEV&&e){const e=this.tagName.toLowerCase();console.error(`[${e}] ${s}`)}}dispose(){this.#f||(this.#f=!0,this.#h=!1,this.#U(),this.#t?.destroy(),this.#t=void 0,this.#a?.(),this.#a=void 0,this.remove())}created(){}mounted(){}beforeUpdate(){}updated(){}unmounted(){}attributeChanged(e,t,s){}beforeAttributesUpdate(){}afterAttributesUpdate(){}}exports.default=c;
1
+ "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../shared/is-object.cjs"),e=require("../../shared/env.cjs"),s=require("../../shared/case-convert.cjs"),i=require("../../shared/boolean.cjs"),r=require("../reactivity/observe.cjs"),a=require("../renderer/renderIR.cjs"),o=Symbol.for("solely.manifest"),n="undefined"!=typeof HTMLElement?HTMLElement:class{};function c(t,e){return function(t){if(null===t||"object"!=typeof t)return t;const e=globalThis.structuredClone;if("function"==typeof e)try{return e(t)}catch{}try{return JSON.parse(JSON.stringify(t))}catch{return t}}("function"==typeof t?t(e):t)}const h=new Set(["value","checked"]);function d(s,i){if(null==i)return i;switch(s.type){case"number":if("string"==typeof i){if(""===i.trim())return i;const t=Number(i);return Number.isNaN(t)?(e.IS_DEV&&console.warn(`[Solely] number prop 收到非法字符串 "${i}",已保留原值。`),i):t}return i;case"boolean":if("string"==typeof i){const t=i.trim().toLowerCase();return"false"!==t&&"0"!==t}return Boolean(i);case"array":if("string"==typeof i)try{const t=JSON.parse(i);if(Array.isArray(t))return t}catch{}return i;case"object":if("string"==typeof i)try{const e=JSON.parse(i);if(t.isObject(e))return e}catch{}return i;case"string":return"number"==typeof i||"boolean"==typeof i?String(i):i;default:return i}}class l extends n{$refs={};#t;#e;#s;#i;#r;#a;#o=!1;#n=!1;#c=!1;#h=0;#d=!1;#l=!1;#u=!1;#p=!1;#f=!1;#y=new Set;#b=0;#m=!1;#S=!1;static#g=new Map;static#A=new WeakSet;#v=new Map;static#O=new Set(["$data","$refs","constructor","created","mounted","beforeUpdate","updated","unmounted","attributeChanged","beforeAttributesUpdate","afterAttributesUpdate","emit","emitNative","refresh","dispose","warn","error"]);static get observedAttributes(){const t=this[o];return t?.attributeMap?Array.from(t.attributeMap.keys()):[]}constructor(t={}){super();const e=this.constructor;this.#t=e[o]||{tagName:"base-element"};const s=this.#t;this.#r=s.shadowDOM?.use?this.attachShadow({mode:s.shadowDOM.mode||"open"}):this,this.#C(t),this.#w(s),queueMicrotask(()=>this.#j())}#$(){const t=Object.getOwnPropertyNames(this),e=["#","_"],s=l.#O,i=new Map;let r=Object.getPrototypeOf(this);for(;r&&r!==n.prototype;){const t=Object.getOwnPropertyDescriptors(r);for(const[e,s]of Object.entries(t))s.set&&!i.has(e)&&i.set(e,s);r=Object.getPrototypeOf(r)}for(const a of t){if(s.has(a))continue;if(e.some(t=>a.startsWith(t)))continue;const t=Object.getOwnPropertyDescriptor(this,a);if(!t||!("value"in t))continue;const r=t.value,o=i.get(a);if(o?.set){delete this[a],this.#h++;try{const t=this.#t.propMap?.get(a);this[a]=t?d(t,r):r}finally{this.#h--}}}}#C(t){e.IS_DEV&&t&&"object"==typeof t&&(l.#A.has(t)&&console.warn(`[Solely] <${this.#t.tagName}>: 该初始数据对象已被其他实例使用,$data 会共享同一响应式代理(改一个实例会同时触发另一个实例刷新)。如需实例隔离,请为每个实例传入新对象。`),l.#A.add(t));const{proxy:s,dispose:i}=r.observe(t,t=>{const e=t.path,s=!Array.isArray(e)||e.length<=1;if(("set"===t.type||"array-replace"===t.type)&&s){const{key:e,newValue:s}=t,i=this.#t,r=String(e),a=i.propMap?.get(r);a&&(!0===a.reflect?this.#R(a,s):0===this.#h&&0===this.#b&&this.#D(a)&&this.#N(a,s))}!1!==this.#t.dataChangeEvent&&this.emit("dataChange",{...t}),this.#M()});this.#i=s,this.#a=i}#R(t,e){const i=s.camelToKebab(t.name);this.#y.add(i);try{if(null==e)return void this.removeAttribute(i);if("boolean"===t.type)e?this.setAttribute(i,""):this.removeAttribute(i);else{const t="object"==typeof e?JSON.stringify(e):String(e);this.setAttribute(i,t)}}finally{this.#y.delete(i)}}#D(t){return!1!==t.reflect&&"object"!==t.type&&"array"!==t.type&&!h.has(t.name)}#N(t,e){const i=s.camelToKebab(t.name);if(!this.#y.has(i)){this.#y.add(i);try{if(null==e)return void(this.hasAttribute(i)&&this.removeAttribute(i));if("boolean"===t.type)return void(e?this.setAttribute(i,""):this.removeAttribute(i));const s="object"==typeof e?JSON.stringify(e):String(e);this.setAttribute(i,s)}finally{this.#y.delete(i)}}}#w(t){t.ir&&(this.#s=t.ir)}#P(t){const e=this.#v.get(t);if(void 0!==e)return e;let s=null,i=Object.getPrototypeOf(this);for(;i&&i!==n.prototype;){const e=Object.getOwnPropertyDescriptor(i,t);if(e){s=e.get||e.set?e:null;break}i=Object.getPrototypeOf(i)}return this.#v.set(t,s),s}#E(t,e){const s=d(t,e);this.#h++;try{const e=this.#P(t.name);e?.set?this[t.name]=s:this.$data[t.name]=s}finally{this.#h--}}get isSyncingProps(){return this.#h>0}#U(){const t=this.#t;if(t.attributeMap)for(const[,e]of t.attributeMap){if(!1===e.reactive)continue;const t=Object.getOwnPropertyDescriptor(this,e.name);if(t&&"value"in t){const s=d(e,t.value);if(delete this[e.name],this.#P(e.name)?.set){this.#h++;try{this.$data[e.name]=s}finally{this.#h--}this.#E(e,s)}else this.$data[e.name]=s}this.#P(e.name)||Object.defineProperty(this,e.name,{get:()=>this.$data[e.name],set:t=>{this.$data[e.name]=d(e,t)},configurable:!0,enumerable:!0})}}#k(){this.#p||(this.#p=!0,this.#U())}get $data(){return this.#i}set $data(e){t.isObject(e)||(e={}),e!==this.#i&&(this.#a?.(),this.#C(e),this.#k(),this.#M())}#T(t,e,s,r){if(null===t)return"boolean"===s?i.parseBooleanAttribute(null,"boolean"==typeof e&&e):e;switch(s){case"boolean":return i.parseBooleanAttribute(t);case"number":{const s=Number(t);return isNaN(s)?(this.warn(!0,`attribute ${r??""}="${t}" 不是合法数字,已回落到默认值 / 保留原值。`),e):s}case"object":try{return JSON.parse(t)}catch(a){return console.error(`[Solely] Failed to parse object value: "${t}", using default value.`,a),e}case"array":try{const s=JSON.parse(t);return Array.isArray(s)?s:e}catch(a){return console.error(`[Solely] Failed to parse array value: "${t}", using default value.`,a),e}default:return t}}#M(){this.#m||(this.#l?!this.#n&&this.#e&&(this.#n=!0,queueMicrotask(()=>{this.#m||(this.#n=!1,this.#I())})):this.#u=!0)}#I(){if(!this.#m&&!this.#o&&this.#l){this.#o=!0;try{this.#c&&this.beforeAttributesUpdate(),this.beforeUpdate(),this.#e?.update(),this.updated(),this.#c&&(this.afterAttributesUpdate(),this.#c=!1)}finally{this.#o=!1}}}refresh(){this.#M()}#L(){const t=this.#t;if(!t.styles)return;const s=this.#r;if(t.sheet&&s instanceof ShadowRoot&&"adoptedStyleSheets"in s){if(!s.adoptedStyleSheets.includes(t.sheet)){const e=Array.from(s.adoptedStyleSheets);e.push(t.sheet),s.adoptedStyleSheets=e}return void(this.#S=!0)}const i=s instanceof ShadowRoot?s:document.head,r=`solely-style-${e.SOLELY_VERSION}-${t.tagName}`,a=!t.shadowDOM?.use,o="undefined"!=typeof CSS&&CSS.escape?CSS.escape(r):r.replace(/([.#:[\]()!])/g,"\\$1");if(!i.querySelector(`#${o}`)){const e=document.createElement("style");e.id=r,e.textContent=t.styles,i.appendChild(e)}if(a){const t=l.#g.get(r)||0;l.#g.set(r,t+1),this.#S=!0}}#V(){if(!this.#S)return;this.#S=!1;const t=this.#t;if(!t.shadowDOM?.use&&t.styles){const s=`solely-style-${e.SOLELY_VERSION}-${t.tagName}`,i=l.#g.get(s)||0;if(i<=1){const t="undefined"!=typeof CSS&&CSS.escape?CSS.escape(s):s.replace(/([.#:[\]()!])/g,"\\$1");document.head.querySelector(`#${t}`)?.remove(),l.#g.delete(s)}else l.#g.set(s,i-1)}}connectedCallback(){if(this.#m)return e.IS_DEV&&console.error(`[Solely] <${this.tagName.toLowerCase()}> has been disposed and cannot be reconnected.`),void this.remove();this.#l=!0;const s=this.#t;if(this.#j(),(s.className||s.tagName||"").split(" ").forEach(t=>t&&this.classList.add(t)),this.#L(),s.attributeMap&&t.isObject(this.$data)&&(this.#k(),!this.#f))for(const[t,e]of s.attributeMap){const s=e.name;if(this.hasAttribute(t)){const s=this.getAttribute(t),i=this.#T(s,c(e.default,this),e.type,t);this.#E(e,i)}else"default"in e&&void 0===this.$data[s]&&(this.#E(e,c(e.default,this)),"boolean"===e.type&&!0===e.default&&this.setAttribute(t,""))}this.#$(),this.#s&&!this.#e&&(this.#e=a.createRender(this.#s,this.#r,this)),this.#u&&(this.#u=!1,this.#M()),this.#f=!0,this.mounted()}disconnectedCallback(){this.#l=!1,this.#m||this.#V(),this.unmounted()}attributeChangedCallback(e,s,i){if(this.#m||s===i||!t.isObject(this.$data))return;if(this.#y.has(e))return;const r=this.#t,a=r.attributeMap?.get(e);if(!a)return;const o=a.name,n=this.$data[o],h=void 0!==a.default,d=h?c(a.default,this):void 0;let l;l=null===i?h?d:"boolean"!==a.type&&void 0:h?d:n;const u=this.#T(i,l,a.type,e);if(n!==u){this.#c=!0,this.#E(a,u),this.$data[o]===n&&(this.#c=!1),this.#b++;try{this.attributeChanged(e,n,u)}finally{this.#b--}}}#j(){this.#d||(this.#d=!0,this.created())}emit(t,e,s){this.#m||this.dispatchEvent(new CustomEvent(t,{bubbles:!0,composed:!0,detail:e,...s}))}emitNative(t,e){this.#m||this.dispatchEvent(new Event(t,{bubbles:!0,composed:!0,...e}))}warn(t,s){if(e.IS_DEV&&t){const t=this.tagName.toLowerCase();console.warn(`[${t}] ${s}`)}}error(t,s){if(e.IS_DEV&&t){const t=this.tagName.toLowerCase();console.error(`[${t}] ${s}`)}}dispose(){this.#m||(this.#m=!0,this.#l=!1,this.#V(),this.#e?.destroy(),this.#e=void 0,this.#a?.(),this.#a=void 0,this.remove())}created(){}mounted(){}beforeUpdate(){}updated(){}unmounted(){}attributeChanged(t,e,s){}beforeAttributesUpdate(){}afterAttributesUpdate(){}}exports.default=l;
@@ -18,6 +18,13 @@ declare class BaseElement<TData extends object = Record<string, unknown>, TRefs
18
18
  $refs: TRefs;
19
19
  static get observedAttributes(): string[];
20
20
  constructor(initialData?: TData);
21
+ /**
22
+ * 框架是否正在同步 prop(组件初始化默认值、attribute → state、属性升级)
23
+ *
24
+ * 组件自定义 setter 可据此区分「框架写入」与「用户显式赋值」:
25
+ * 初始化阶段应保持静默,避免挂载时派发 change 等事件。
26
+ */
27
+ protected get isSyncingProps(): boolean;
21
28
  get $data(): TData;
22
29
  set $data(value: TData);
23
30
  refresh(): void;