cos-design 3.8.1 → 4.1.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 (588) hide show
  1. package/CHANGELOG.md +79 -6
  2. package/README.md +86 -50
  3. package/dist/core-CszjZZo9.cjs +1 -0
  4. package/dist/core-On5bp2VI.js +178 -0
  5. package/dist/core.cjs +1 -0
  6. package/dist/core.d.ts +1 -0
  7. package/dist/core.js +3 -0
  8. package/dist/elements.cjs +1 -0
  9. package/dist/elements.d.ts +1 -0
  10. package/dist/elements.js +3162 -0
  11. package/dist/engine-D2OC52jQ.cjs +246 -0
  12. package/dist/engine-Dh44m7ox.js +12755 -0
  13. package/dist/index.cjs +1 -249
  14. package/dist/index.js +2049 -13779
  15. package/dist/src/components/audioVisualizer/core/engine.d.ts +2 -0
  16. package/dist/src/components/audioVisualizer/core/index.d.ts +2 -0
  17. package/dist/src/components/audioVisualizer/core/types.d.ts +11 -0
  18. package/dist/src/components/audioVisualizer/element/index.d.ts +9 -0
  19. package/dist/src/components/audioVisualizer/index.d.ts +3 -9
  20. package/dist/src/components/audioVisualizer/react/index.d.ts +4 -0
  21. package/dist/src/components/aurora/core/engine.d.ts +2 -0
  22. package/dist/src/components/aurora/core/index.d.ts +2 -0
  23. package/dist/src/components/aurora/core/types.d.ts +11 -0
  24. package/dist/src/components/aurora/element/index.d.ts +13 -0
  25. package/dist/src/components/aurora/index.d.ts +3 -11
  26. package/dist/src/components/aurora/react/index.d.ts +4 -0
  27. package/dist/src/components/auroraVeil/core/engine.d.ts +2 -0
  28. package/dist/src/components/auroraVeil/core/index.d.ts +2 -0
  29. package/dist/src/components/auroraVeil/core/types.d.ts +15 -0
  30. package/dist/src/components/auroraVeil/element/index.d.ts +13 -0
  31. package/dist/src/components/auroraVeil/index.d.ts +3 -19
  32. package/dist/src/components/auroraVeil/react/index.d.ts +4 -0
  33. package/dist/src/components/barcodeScan/core/engine.d.ts +2 -0
  34. package/dist/src/components/barcodeScan/core/index.d.ts +2 -0
  35. package/dist/src/components/barcodeScan/core/types.d.ts +12 -0
  36. package/dist/src/components/barcodeScan/element/index.d.ts +14 -0
  37. package/dist/src/components/barcodeScan/index.d.ts +3 -11
  38. package/dist/src/components/barcodeScan/react/index.d.ts +6 -0
  39. package/dist/src/components/blurText/core/engine.d.ts +2 -0
  40. package/dist/src/components/blurText/core/index.d.ts +2 -0
  41. package/dist/src/components/blurText/core/types.d.ts +15 -0
  42. package/dist/src/components/blurText/element/index.d.ts +16 -0
  43. package/dist/src/components/blurText/index.d.ts +3 -21
  44. package/dist/src/components/blurText/react/index.d.ts +4 -0
  45. package/dist/src/components/bubbleField/core/engine.d.ts +2 -0
  46. package/dist/src/components/bubbleField/core/index.d.ts +2 -0
  47. package/dist/src/components/bubbleField/core/types.d.ts +14 -0
  48. package/dist/src/components/bubbleField/element/index.d.ts +9 -0
  49. package/dist/src/components/bubbleField/index.d.ts +3 -5
  50. package/dist/src/components/bubbleField/react/index.d.ts +4 -0
  51. package/dist/src/components/burnAway/core/engine.d.ts +2 -0
  52. package/dist/src/components/burnAway/core/index.d.ts +2 -0
  53. package/dist/src/components/burnAway/core/types.d.ts +13 -0
  54. package/dist/src/components/burnAway/element/index.d.ts +10 -0
  55. package/dist/src/components/burnAway/index.d.ts +3 -13
  56. package/dist/src/components/burnAway/react/index.d.ts +4 -0
  57. package/dist/src/components/canvasClock/core/engine.d.ts +2 -0
  58. package/dist/src/components/canvasClock/core/index.d.ts +2 -0
  59. package/dist/src/components/canvasClock/core/types.d.ts +9 -0
  60. package/dist/src/components/canvasClock/element/index.d.ts +9 -0
  61. package/dist/src/components/canvasClock/index.d.ts +3 -9
  62. package/dist/src/components/canvasClock/react/index.d.ts +4 -0
  63. package/dist/src/components/charge/core/engine.d.ts +2 -0
  64. package/dist/src/components/charge/core/index.d.ts +2 -0
  65. package/dist/src/components/charge/core/types.d.ts +14 -0
  66. package/dist/src/components/charge/element/index.d.ts +9 -0
  67. package/dist/src/components/charge/index.d.ts +3 -19
  68. package/dist/src/components/charge/react/index.d.ts +4 -0
  69. package/dist/src/components/circularText/core/engine.d.ts +2 -0
  70. package/dist/src/components/circularText/core/index.d.ts +2 -0
  71. package/dist/src/components/circularText/core/types.d.ts +13 -0
  72. package/dist/src/components/circularText/element/index.d.ts +13 -0
  73. package/dist/src/components/circularText/index.d.ts +3 -17
  74. package/dist/src/components/circularText/react/index.d.ts +4 -0
  75. package/dist/src/components/clickSpark/core/engine.d.ts +2 -0
  76. package/dist/src/components/clickSpark/core/index.d.ts +2 -0
  77. package/dist/src/components/clickSpark/core/types.d.ts +13 -0
  78. package/dist/src/components/clickSpark/element/index.d.ts +14 -0
  79. package/dist/src/components/clickSpark/index.d.ts +3 -10
  80. package/dist/src/components/clickSpark/react/index.d.ts +6 -0
  81. package/dist/src/components/confetti/core/engine.d.ts +2 -0
  82. package/dist/src/components/confetti/core/index.d.ts +2 -0
  83. package/dist/src/components/confetti/core/types.d.ts +19 -0
  84. package/dist/src/components/confetti/element/index.d.ts +10 -0
  85. package/dist/src/components/confetti/index.d.ts +3 -25
  86. package/dist/src/components/confetti/react/index.d.ts +5 -0
  87. package/dist/src/components/countUp/core/engine.d.ts +2 -0
  88. package/dist/src/components/countUp/core/index.d.ts +2 -0
  89. package/dist/src/components/countUp/core/types.d.ts +14 -0
  90. package/dist/src/components/countUp/element/index.d.ts +9 -0
  91. package/dist/src/components/countUp/index.d.ts +3 -19
  92. package/dist/src/components/countUp/react/index.d.ts +4 -0
  93. package/dist/src/components/countdown/core/engine.d.ts +2 -0
  94. package/dist/src/components/countdown/core/index.d.ts +2 -0
  95. package/dist/src/components/countdown/core/types.d.ts +14 -0
  96. package/dist/src/components/countdown/element/index.d.ts +13 -0
  97. package/dist/src/components/countdown/index.d.ts +3 -26
  98. package/dist/src/components/countdown/react/index.d.ts +4 -0
  99. package/dist/src/components/cursorTrail/core/engine.d.ts +2 -0
  100. package/dist/src/components/cursorTrail/core/index.d.ts +2 -0
  101. package/dist/src/components/cursorTrail/core/types.d.ts +12 -0
  102. package/dist/src/components/cursorTrail/element/index.d.ts +9 -0
  103. package/dist/src/components/cursorTrail/index.d.ts +3 -13
  104. package/dist/src/components/cursorTrail/react/index.d.ts +4 -0
  105. package/dist/src/components/curvedLoop/core/engine.d.ts +2 -0
  106. package/dist/src/components/curvedLoop/core/index.d.ts +2 -0
  107. package/dist/src/components/curvedLoop/core/types.d.ts +14 -0
  108. package/dist/src/components/curvedLoop/element/index.d.ts +13 -0
  109. package/dist/src/components/curvedLoop/index.d.ts +3 -19
  110. package/dist/src/components/curvedLoop/react/index.d.ts +4 -0
  111. package/dist/src/components/cyberGrid/core/engine.d.ts +2 -0
  112. package/dist/src/components/cyberGrid/core/index.d.ts +2 -0
  113. package/dist/src/components/cyberGrid/core/types.d.ts +12 -0
  114. package/dist/src/components/cyberGrid/element/index.d.ts +9 -0
  115. package/dist/src/components/cyberGrid/index.d.ts +3 -13
  116. package/dist/src/components/cyberGrid/react/index.d.ts +4 -0
  117. package/dist/src/components/dandelionField/core/engine.d.ts +2 -0
  118. package/dist/src/components/dandelionField/core/index.d.ts +2 -0
  119. package/dist/src/components/dandelionField/core/types.d.ts +15 -0
  120. package/dist/src/components/dandelionField/element/index.d.ts +9 -0
  121. package/dist/src/components/dandelionField/index.d.ts +3 -5
  122. package/dist/src/components/dandelionField/react/index.d.ts +4 -0
  123. package/dist/src/components/diceRoll/core/engine.d.ts +2 -0
  124. package/dist/src/components/diceRoll/core/index.d.ts +2 -0
  125. package/dist/src/components/diceRoll/core/types.d.ts +12 -0
  126. package/dist/src/components/diceRoll/element/index.d.ts +13 -0
  127. package/dist/src/components/diceRoll/index.d.ts +3 -15
  128. package/dist/src/components/diceRoll/react/index.d.ts +4 -0
  129. package/dist/src/components/dnaHelix/core/engine.d.ts +2 -0
  130. package/dist/src/components/dnaHelix/core/index.d.ts +2 -0
  131. package/dist/src/components/dnaHelix/core/types.d.ts +11 -0
  132. package/dist/src/components/dnaHelix/element/index.d.ts +9 -0
  133. package/dist/src/components/dnaHelix/index.d.ts +3 -9
  134. package/dist/src/components/dnaHelix/react/index.d.ts +4 -0
  135. package/dist/src/components/doublePendulum/core/engine.d.ts +2 -0
  136. package/dist/src/components/doublePendulum/core/index.d.ts +2 -0
  137. package/dist/src/components/doublePendulum/core/types.d.ts +12 -0
  138. package/dist/src/components/doublePendulum/element/index.d.ts +9 -0
  139. package/dist/src/components/doublePendulum/index.d.ts +3 -10
  140. package/dist/src/components/doublePendulum/react/index.d.ts +4 -0
  141. package/dist/src/components/electricArc/core/engine.d.ts +2 -0
  142. package/dist/src/components/electricArc/core/index.d.ts +2 -0
  143. package/dist/src/components/electricArc/core/types.d.ts +10 -0
  144. package/dist/src/components/electricArc/element/index.d.ts +9 -0
  145. package/dist/src/components/electricArc/index.d.ts +3 -8
  146. package/dist/src/components/electricArc/react/index.d.ts +4 -0
  147. package/dist/src/components/fireworks/core/engine.d.ts +2 -0
  148. package/dist/src/components/fireworks/core/index.d.ts +2 -0
  149. package/dist/src/components/fireworks/core/types.d.ts +23 -0
  150. package/dist/src/components/fireworks/element/index.d.ts +10 -0
  151. package/dist/src/components/fireworks/index.d.ts +3 -23
  152. package/dist/src/components/fireworks/react/index.d.ts +4 -0
  153. package/dist/src/components/flipCard/core/engine.d.ts +2 -0
  154. package/dist/src/components/flipCard/core/index.d.ts +2 -0
  155. package/dist/src/components/flipCard/core/types.d.ts +22 -0
  156. package/dist/src/components/flipCard/element/index.d.ts +11 -0
  157. package/dist/src/components/flipCard/index.d.ts +3 -29
  158. package/dist/src/components/flipCard/react/index.d.ts +5 -0
  159. package/dist/src/components/flipCounter/core/engine.d.ts +2 -0
  160. package/dist/src/components/flipCounter/core/index.d.ts +2 -0
  161. package/dist/src/components/flipCounter/core/types.d.ts +15 -0
  162. package/dist/src/components/flipCounter/element/index.d.ts +9 -0
  163. package/dist/src/components/flipCounter/index.d.ts +3 -13
  164. package/dist/src/components/flipCounter/react/index.d.ts +4 -0
  165. package/dist/src/components/fuzzyText/core/engine.d.ts +2 -0
  166. package/dist/src/components/fuzzyText/core/index.d.ts +2 -0
  167. package/dist/src/components/fuzzyText/core/types.d.ts +15 -0
  168. package/dist/src/components/fuzzyText/element/index.d.ts +9 -0
  169. package/dist/src/components/fuzzyText/index.d.ts +3 -21
  170. package/dist/src/components/fuzzyText/react/index.d.ts +4 -0
  171. package/dist/src/components/gameOfLife/core/engine.d.ts +2 -0
  172. package/dist/src/components/gameOfLife/core/index.d.ts +2 -0
  173. package/dist/src/components/gameOfLife/core/types.d.ts +21 -0
  174. package/dist/src/components/gameOfLife/element/index.d.ts +13 -0
  175. package/dist/src/components/gameOfLife/index.d.ts +3 -25
  176. package/dist/src/components/gameOfLife/react/index.d.ts +4 -0
  177. package/dist/src/components/glitchText/core/engine.d.ts +2 -0
  178. package/dist/src/components/glitchText/core/index.d.ts +2 -0
  179. package/dist/src/components/glitchText/core/types.d.ts +12 -0
  180. package/dist/src/components/glitchText/element/index.d.ts +9 -0
  181. package/dist/src/components/glitchText/index.d.ts +3 -15
  182. package/dist/src/components/glitchText/react/index.d.ts +4 -0
  183. package/dist/src/components/gradientFlow/core/engine.d.ts +2 -0
  184. package/dist/src/components/gradientFlow/core/index.d.ts +2 -0
  185. package/dist/src/components/gradientFlow/core/types.d.ts +10 -0
  186. package/dist/src/components/gradientFlow/element/index.d.ts +13 -0
  187. package/dist/src/components/gradientFlow/index.d.ts +3 -11
  188. package/dist/src/components/gradientFlow/react/index.d.ts +4 -0
  189. package/dist/src/components/gravityBalls/core/engine.d.ts +2 -0
  190. package/dist/src/components/gravityBalls/core/index.d.ts +2 -0
  191. package/dist/src/components/gravityBalls/core/types.d.ts +10 -0
  192. package/dist/src/components/gravityBalls/element/index.d.ts +9 -0
  193. package/dist/src/components/gravityBalls/index.d.ts +3 -8
  194. package/dist/src/components/gravityBalls/react/index.d.ts +4 -0
  195. package/dist/src/components/holographicCard/core/engine.d.ts +2 -0
  196. package/dist/src/components/holographicCard/core/index.d.ts +2 -0
  197. package/dist/src/components/holographicCard/core/types.d.ts +10 -0
  198. package/dist/src/components/holographicCard/element/index.d.ts +9 -0
  199. package/dist/src/components/holographicCard/index.d.ts +3 -8
  200. package/dist/src/components/holographicCard/react/index.d.ts +4 -0
  201. package/dist/src/components/index.d.ts +7 -7
  202. package/dist/src/components/inkBloom/core/engine.d.ts +6 -0
  203. package/dist/src/components/inkBloom/core/index.d.ts +2 -0
  204. package/dist/src/components/inkBloom/core/types.d.ts +14 -0
  205. package/dist/src/components/inkBloom/element/index.d.ts +9 -0
  206. package/dist/src/components/inkBloom/index.d.ts +3 -21
  207. package/dist/src/components/inkBloom/react/index.d.ts +4 -0
  208. package/dist/src/components/lavaBubble/core/engine.d.ts +2 -0
  209. package/dist/src/components/lavaBubble/core/index.d.ts +2 -0
  210. package/dist/src/components/lavaBubble/core/types.d.ts +16 -0
  211. package/dist/src/components/lavaBubble/element/index.d.ts +9 -0
  212. package/dist/src/components/lavaBubble/index.d.ts +3 -24
  213. package/dist/src/components/lavaBubble/react/index.d.ts +4 -0
  214. package/dist/src/components/liquidGlass/core/engine.d.ts +2 -0
  215. package/dist/src/components/liquidGlass/core/index.d.ts +2 -0
  216. package/dist/src/components/liquidGlass/core/types.d.ts +12 -0
  217. package/dist/src/components/liquidGlass/element/index.d.ts +14 -0
  218. package/dist/src/components/liquidGlass/index.d.ts +3 -10
  219. package/dist/src/components/liquidGlass/react/index.d.ts +6 -0
  220. package/dist/src/components/liquidProgress/core/engine.d.ts +2 -0
  221. package/dist/src/components/liquidProgress/core/index.d.ts +2 -0
  222. package/dist/src/components/liquidProgress/core/types.d.ts +11 -0
  223. package/dist/src/components/liquidProgress/element/index.d.ts +9 -0
  224. package/dist/src/components/liquidProgress/index.d.ts +3 -9
  225. package/dist/src/components/liquidProgress/react/index.d.ts +4 -0
  226. package/dist/src/components/lorenzAttractor/core/engine.d.ts +2 -0
  227. package/dist/src/components/lorenzAttractor/core/index.d.ts +2 -0
  228. package/dist/src/components/lorenzAttractor/core/types.d.ts +12 -0
  229. package/dist/src/components/lorenzAttractor/element/index.d.ts +9 -0
  230. package/dist/src/components/lorenzAttractor/index.d.ts +3 -10
  231. package/dist/src/components/lorenzAttractor/react/index.d.ts +4 -0
  232. package/dist/src/components/magneticButton/core/engine.d.ts +2 -0
  233. package/dist/src/components/magneticButton/core/index.d.ts +2 -0
  234. package/dist/src/components/magneticButton/core/types.d.ts +12 -0
  235. package/dist/src/components/magneticButton/element/index.d.ts +14 -0
  236. package/dist/src/components/magneticButton/index.d.ts +3 -10
  237. package/dist/src/components/magneticButton/react/index.d.ts +6 -0
  238. package/dist/src/components/matrixRain/core/engine.d.ts +2 -0
  239. package/dist/src/components/matrixRain/core/index.d.ts +2 -0
  240. package/dist/src/components/matrixRain/core/types.d.ts +15 -0
  241. package/dist/src/components/matrixRain/element/index.d.ts +9 -0
  242. package/dist/src/components/matrixRain/index.d.ts +3 -19
  243. package/dist/src/components/matrixRain/react/index.d.ts +4 -0
  244. package/dist/src/components/mazeGenerator/core/engine.d.ts +2 -0
  245. package/dist/src/components/mazeGenerator/core/index.d.ts +2 -0
  246. package/dist/src/components/mazeGenerator/core/types.d.ts +11 -0
  247. package/dist/src/components/mazeGenerator/element/index.d.ts +9 -0
  248. package/dist/src/components/mazeGenerator/index.d.ts +3 -9
  249. package/dist/src/components/mazeGenerator/react/index.d.ts +4 -0
  250. package/dist/src/components/metaballPool/core/engine.d.ts +2 -0
  251. package/dist/src/components/metaballPool/core/index.d.ts +2 -0
  252. package/dist/src/components/metaballPool/core/types.d.ts +11 -0
  253. package/dist/src/components/metaballPool/element/index.d.ts +9 -0
  254. package/dist/src/components/metaballPool/index.d.ts +3 -9
  255. package/dist/src/components/metaballPool/react/index.d.ts +4 -0
  256. package/dist/src/components/meteorRain/core/engine.d.ts +2 -0
  257. package/dist/src/components/meteorRain/core/index.d.ts +2 -0
  258. package/dist/src/components/meteorRain/core/types.d.ts +11 -0
  259. package/dist/src/components/meteorRain/element/index.d.ts +9 -0
  260. package/dist/src/components/meteorRain/index.d.ts +3 -11
  261. package/dist/src/components/meteorRain/react/index.d.ts +4 -0
  262. package/dist/src/components/neonText/core/engine.d.ts +2 -0
  263. package/dist/src/components/neonText/core/index.d.ts +2 -0
  264. package/dist/src/components/neonText/core/types.d.ts +11 -0
  265. package/dist/src/components/neonText/element/index.d.ts +9 -0
  266. package/dist/src/components/neonText/index.d.ts +3 -13
  267. package/dist/src/components/neonText/react/index.d.ts +4 -0
  268. package/dist/src/components/networkGraph/core/engine.d.ts +2 -0
  269. package/dist/src/components/networkGraph/core/index.d.ts +2 -0
  270. package/dist/src/components/networkGraph/core/types.d.ts +23 -0
  271. package/dist/src/components/networkGraph/element/index.d.ts +16 -0
  272. package/dist/src/components/networkGraph/index.d.ts +3 -26
  273. package/dist/src/components/networkGraph/react/index.d.ts +4 -0
  274. package/dist/src/components/newtonCradle/core/engine.d.ts +2 -0
  275. package/dist/src/components/newtonCradle/core/index.d.ts +2 -0
  276. package/dist/src/components/newtonCradle/core/types.d.ts +11 -0
  277. package/dist/src/components/newtonCradle/element/index.d.ts +9 -0
  278. package/dist/src/components/newtonCradle/index.d.ts +3 -9
  279. package/dist/src/components/newtonCradle/react/index.d.ts +4 -0
  280. package/dist/src/components/nineGrid/core/engine.d.ts +2 -0
  281. package/dist/src/components/nineGrid/core/index.d.ts +2 -0
  282. package/dist/src/components/nineGrid/core/types.d.ts +31 -0
  283. package/dist/src/components/nineGrid/element/index.d.ts +15 -0
  284. package/dist/src/components/nineGrid/index.d.ts +3 -29
  285. package/dist/src/components/nineGrid/react/index.d.ts +5 -0
  286. package/dist/src/components/orbitalChart/core/engine.d.ts +2 -0
  287. package/dist/src/components/orbitalChart/core/index.d.ts +2 -0
  288. package/dist/src/components/orbitalChart/core/types.d.ts +14 -0
  289. package/dist/src/components/orbitalChart/element/index.d.ts +13 -0
  290. package/dist/src/components/orbitalChart/index.d.ts +3 -12
  291. package/dist/src/components/orbitalChart/react/index.d.ts +4 -0
  292. package/dist/src/components/particleNetwork/core/engine.d.ts +2 -0
  293. package/dist/src/components/particleNetwork/core/index.d.ts +2 -0
  294. package/dist/src/components/particleNetwork/core/types.d.ts +15 -0
  295. package/dist/src/components/particleNetwork/element/index.d.ts +9 -0
  296. package/dist/src/components/particleNetwork/index.d.ts +3 -19
  297. package/dist/src/components/particleNetwork/react/index.d.ts +4 -0
  298. package/dist/src/components/photoAlbum/core/engine.d.ts +2 -0
  299. package/dist/src/components/photoAlbum/core/index.d.ts +2 -0
  300. package/dist/src/components/photoAlbum/core/types.d.ts +7 -0
  301. package/dist/src/components/photoAlbum/element/index.d.ts +16 -0
  302. package/dist/src/components/photoAlbum/index.d.ts +3 -5
  303. package/dist/src/components/photoAlbum/react/index.d.ts +3 -0
  304. package/dist/src/components/photoAlbum/types.d.ts +3 -3
  305. package/dist/src/components/photoCarousel/core/engine.d.ts +2 -0
  306. package/dist/src/components/photoCarousel/core/index.d.ts +2 -0
  307. package/dist/src/components/photoCarousel/core/types.d.ts +7 -0
  308. package/dist/src/components/photoCarousel/element/index.d.ts +13 -0
  309. package/dist/src/components/photoCarousel/index.d.ts +3 -9
  310. package/dist/src/components/photoCarousel/react/index.d.ts +3 -0
  311. package/dist/src/components/photoCarousel/types.d.ts +2 -2
  312. package/dist/src/components/photoClothesline/core/engine.d.ts +2 -0
  313. package/dist/src/components/photoClothesline/core/index.d.ts +2 -0
  314. package/dist/src/components/photoClothesline/core/types.d.ts +7 -0
  315. package/dist/src/components/photoClothesline/element/index.d.ts +13 -0
  316. package/dist/src/components/photoClothesline/index.d.ts +3 -5
  317. package/dist/src/components/photoClothesline/layout.d.ts +2 -2
  318. package/dist/src/components/photoClothesline/react/index.d.ts +3 -0
  319. package/dist/src/components/photoClothesline/types.d.ts +3 -3
  320. package/dist/src/components/photoFilmstrip/core/engine.d.ts +2 -0
  321. package/dist/src/components/photoFilmstrip/core/index.d.ts +2 -0
  322. package/dist/src/components/photoFilmstrip/core/types.d.ts +7 -0
  323. package/dist/src/components/photoFilmstrip/element/index.d.ts +13 -0
  324. package/dist/src/components/photoFilmstrip/index.d.ts +3 -5
  325. package/dist/src/components/photoFilmstrip/react/index.d.ts +3 -0
  326. package/dist/src/components/photoFilmstrip/types.d.ts +2 -2
  327. package/dist/src/components/photoFridge/core/engine.d.ts +2 -0
  328. package/dist/src/components/photoFridge/core/index.d.ts +2 -0
  329. package/dist/src/components/photoFridge/core/types.d.ts +7 -0
  330. package/dist/src/components/photoFridge/element/index.d.ts +13 -0
  331. package/dist/src/components/photoFridge/index.d.ts +3 -5
  332. package/dist/src/components/photoFridge/react/index.d.ts +3 -0
  333. package/dist/src/components/photoFridge/types.d.ts +2 -2
  334. package/dist/src/components/photoLantern/core/engine.d.ts +2 -0
  335. package/dist/src/components/photoLantern/core/index.d.ts +2 -0
  336. package/dist/src/components/photoLantern/core/types.d.ts +7 -0
  337. package/dist/src/components/photoLantern/element/index.d.ts +13 -0
  338. package/dist/src/components/photoLantern/index.d.ts +3 -5
  339. package/dist/src/components/photoLantern/react/index.d.ts +3 -0
  340. package/dist/src/components/photoLantern/types.d.ts +3 -3
  341. package/dist/src/components/photoLightbox/core/engine.d.ts +2 -0
  342. package/dist/src/components/photoLightbox/core/index.d.ts +2 -0
  343. package/dist/src/components/photoLightbox/core/types.d.ts +7 -0
  344. package/dist/src/components/photoLightbox/element/index.d.ts +13 -0
  345. package/dist/src/components/photoLightbox/index.d.ts +3 -5
  346. package/dist/src/components/photoLightbox/react/index.d.ts +3 -0
  347. package/dist/src/components/photoLightbox/types.d.ts +2 -2
  348. package/dist/src/components/photoPolaroid/core/engine.d.ts +2 -0
  349. package/dist/src/components/photoPolaroid/core/index.d.ts +2 -0
  350. package/dist/src/components/photoPolaroid/core/types.d.ts +7 -0
  351. package/dist/src/components/photoPolaroid/element/index.d.ts +13 -0
  352. package/dist/src/components/photoPolaroid/index.d.ts +3 -5
  353. package/dist/src/components/photoPolaroid/react/index.d.ts +3 -0
  354. package/dist/src/components/photoPolaroid/types.d.ts +2 -2
  355. package/dist/src/components/photoPostcard/core/engine.d.ts +6 -0
  356. package/dist/src/components/photoPostcard/core/index.d.ts +2 -0
  357. package/dist/src/components/photoPostcard/core/types.d.ts +7 -0
  358. package/dist/src/components/photoPostcard/element/index.d.ts +13 -0
  359. package/dist/src/components/photoPostcard/index.d.ts +3 -8
  360. package/dist/src/components/photoPostcard/react/index.d.ts +10 -0
  361. package/dist/src/components/photoPostcard/types.d.ts +2 -2
  362. package/dist/src/components/photoPrism/core/engine.d.ts +2 -0
  363. package/dist/src/components/photoPrism/core/index.d.ts +2 -0
  364. package/dist/src/components/photoPrism/core/types.d.ts +7 -0
  365. package/dist/src/components/photoPrism/element/index.d.ts +13 -0
  366. package/dist/src/components/photoPrism/index.d.ts +3 -9
  367. package/dist/src/components/photoPrism/react/index.d.ts +3 -0
  368. package/dist/src/components/photoPrism/types.d.ts +2 -2
  369. package/dist/src/components/photoScroll/core/engine.d.ts +2 -0
  370. package/dist/src/components/photoScroll/core/index.d.ts +2 -0
  371. package/dist/src/components/photoScroll/core/types.d.ts +7 -0
  372. package/dist/src/components/photoScroll/element/index.d.ts +13 -0
  373. package/dist/src/components/photoScroll/index.d.ts +3 -9
  374. package/dist/src/components/photoScroll/react/index.d.ts +3 -0
  375. package/dist/src/components/photoScroll/types.d.ts +2 -2
  376. package/dist/src/components/photoTunnel/core/engine.d.ts +2 -0
  377. package/dist/src/components/photoTunnel/core/index.d.ts +2 -0
  378. package/dist/src/components/photoTunnel/core/types.d.ts +7 -0
  379. package/dist/src/components/photoTunnel/element/index.d.ts +13 -0
  380. package/dist/src/components/photoTunnel/index.d.ts +3 -9
  381. package/dist/src/components/photoTunnel/react/index.d.ts +3 -0
  382. package/dist/src/components/photoTunnel/types.d.ts +2 -2
  383. package/dist/src/components/photoViewMaster/core/engine.d.ts +2 -0
  384. package/dist/src/components/photoViewMaster/core/index.d.ts +2 -0
  385. package/dist/src/components/photoViewMaster/core/types.d.ts +7 -0
  386. package/dist/src/components/photoViewMaster/element/index.d.ts +13 -0
  387. package/dist/src/components/photoViewMaster/index.d.ts +3 -9
  388. package/dist/src/components/photoViewMaster/react/index.d.ts +3 -0
  389. package/dist/src/components/photoViewMaster/types.d.ts +2 -2
  390. package/dist/src/components/plasmaBall/core/engine.d.ts +2 -0
  391. package/dist/src/components/plasmaBall/core/index.d.ts +2 -0
  392. package/dist/src/components/plasmaBall/core/types.d.ts +11 -0
  393. package/dist/src/components/plasmaBall/element/index.d.ts +9 -0
  394. package/dist/src/components/plasmaBall/index.d.ts +3 -9
  395. package/dist/src/components/plasmaBall/react/index.d.ts +4 -0
  396. package/dist/src/components/progressChest/core/engine.d.ts +2 -0
  397. package/dist/src/components/progressChest/core/index.d.ts +2 -0
  398. package/dist/src/components/progressChest/core/types.d.ts +14 -0
  399. package/dist/src/components/progressChest/element/index.d.ts +9 -0
  400. package/dist/src/components/progressChest/index.d.ts +3 -13
  401. package/dist/src/components/progressChest/react/index.d.ts +4 -0
  402. package/dist/src/components/radarScan/core/engine.d.ts +2 -0
  403. package/dist/src/components/radarScan/core/index.d.ts +2 -0
  404. package/dist/src/components/radarScan/core/types.d.ts +10 -0
  405. package/dist/src/components/radarScan/element/index.d.ts +9 -0
  406. package/dist/src/components/radarScan/index.d.ts +3 -9
  407. package/dist/src/components/radarScan/react/index.d.ts +4 -0
  408. package/dist/src/components/redPacketRain/core/engine.d.ts +2 -0
  409. package/dist/src/components/redPacketRain/core/index.d.ts +2 -0
  410. package/dist/src/components/redPacketRain/core/types.d.ts +25 -0
  411. package/dist/src/components/redPacketRain/element/index.d.ts +12 -0
  412. package/dist/src/components/redPacketRain/index.d.ts +3 -33
  413. package/dist/src/components/redPacketRain/react/index.d.ts +5 -0
  414. package/dist/src/components/returnCity/core/engine.d.ts +2 -0
  415. package/dist/src/components/returnCity/core/index.d.ts +2 -0
  416. package/dist/src/components/returnCity/core/types.d.ts +10 -0
  417. package/dist/src/components/returnCity/element/index.d.ts +9 -0
  418. package/dist/src/components/returnCity/index.d.ts +3 -11
  419. package/dist/src/components/returnCity/react/index.d.ts +4 -0
  420. package/dist/src/components/rippleWater/core/engine.d.ts +2 -0
  421. package/dist/src/components/rippleWater/core/index.d.ts +2 -0
  422. package/dist/src/components/rippleWater/core/types.d.ts +24 -0
  423. package/dist/src/components/rippleWater/element/index.d.ts +9 -0
  424. package/dist/src/components/rippleWater/index.d.ts +3 -37
  425. package/dist/src/components/rippleWater/react/index.d.ts +4 -0
  426. package/dist/src/components/ropeChain/core/engine.d.ts +2 -0
  427. package/dist/src/components/ropeChain/core/index.d.ts +2 -0
  428. package/dist/src/components/ropeChain/core/types.d.ts +12 -0
  429. package/dist/src/components/ropeChain/element/index.d.ts +9 -0
  430. package/dist/src/components/ropeChain/index.d.ts +3 -10
  431. package/dist/src/components/ropeChain/react/index.d.ts +4 -0
  432. package/dist/src/components/rotatingText/core/engine.d.ts +2 -0
  433. package/dist/src/components/rotatingText/core/index.d.ts +2 -0
  434. package/dist/src/components/rotatingText/core/types.d.ts +14 -0
  435. package/dist/src/components/rotatingText/element/index.d.ts +13 -0
  436. package/dist/src/components/rotatingText/index.d.ts +3 -19
  437. package/dist/src/components/rotatingText/react/index.d.ts +4 -0
  438. package/dist/src/components/sandFall/core/engine.d.ts +2 -0
  439. package/dist/src/components/sandFall/core/index.d.ts +2 -0
  440. package/dist/src/components/sandFall/core/types.d.ts +14 -0
  441. package/dist/src/components/sandFall/element/index.d.ts +13 -0
  442. package/dist/src/components/sandFall/index.d.ts +3 -17
  443. package/dist/src/components/sandFall/react/index.d.ts +4 -0
  444. package/dist/src/components/scrambleText/core/engine.d.ts +2 -0
  445. package/dist/src/components/scrambleText/core/index.d.ts +2 -0
  446. package/dist/src/components/scrambleText/core/types.d.ts +10 -0
  447. package/dist/src/components/scrambleText/element/index.d.ts +9 -0
  448. package/dist/src/components/scrambleText/index.d.ts +3 -11
  449. package/dist/src/components/scrambleText/react/index.d.ts +4 -0
  450. package/dist/src/components/scratchCard/core/engine.d.ts +2 -0
  451. package/dist/src/components/scratchCard/core/index.d.ts +2 -0
  452. package/dist/src/components/scratchCard/core/types.d.ts +25 -0
  453. package/dist/src/components/scratchCard/element/index.d.ts +11 -0
  454. package/dist/src/components/scratchCard/index.d.ts +3 -23
  455. package/dist/src/components/scratchCard/react/index.d.ts +5 -0
  456. package/dist/src/components/shinyText/core/engine.d.ts +2 -0
  457. package/dist/src/components/shinyText/core/index.d.ts +2 -0
  458. package/dist/src/components/shinyText/core/types.d.ts +13 -0
  459. package/dist/src/components/shinyText/element/index.d.ts +9 -0
  460. package/dist/src/components/shinyText/index.d.ts +3 -17
  461. package/dist/src/components/shinyText/react/index.d.ts +4 -0
  462. package/dist/src/components/slotMachine/core/engine.d.ts +2 -0
  463. package/dist/src/components/slotMachine/core/index.d.ts +2 -0
  464. package/dist/src/components/slotMachine/core/types.d.ts +31 -0
  465. package/dist/src/components/slotMachine/element/index.d.ts +18 -0
  466. package/dist/src/components/slotMachine/index.d.ts +3 -29
  467. package/dist/src/components/slotMachine/react/index.d.ts +5 -0
  468. package/dist/src/components/smokeFog/core/engine.d.ts +2 -0
  469. package/dist/src/components/smokeFog/core/index.d.ts +2 -0
  470. package/dist/src/components/smokeFog/core/types.d.ts +18 -0
  471. package/dist/src/components/smokeFog/element/index.d.ts +9 -0
  472. package/dist/src/components/smokeFog/index.d.ts +3 -25
  473. package/dist/src/components/smokeFog/react/index.d.ts +4 -0
  474. package/dist/src/components/snowfall/core/engine.d.ts +2 -0
  475. package/dist/src/components/snowfall/core/index.d.ts +2 -0
  476. package/dist/src/components/snowfall/core/types.d.ts +12 -0
  477. package/dist/src/components/snowfall/element/index.d.ts +13 -0
  478. package/dist/src/components/snowfall/index.d.ts +3 -13
  479. package/dist/src/components/snowfall/react/index.d.ts +4 -0
  480. package/dist/src/components/soapBubbles/core/engine.d.ts +2 -0
  481. package/dist/src/components/soapBubbles/core/index.d.ts +2 -0
  482. package/dist/src/components/soapBubbles/core/types.d.ts +14 -0
  483. package/dist/src/components/soapBubbles/element/index.d.ts +9 -0
  484. package/dist/src/components/soapBubbles/index.d.ts +3 -20
  485. package/dist/src/components/soapBubbles/react/index.d.ts +4 -0
  486. package/dist/src/components/solarSystem/core/engine.d.ts +2 -0
  487. package/dist/src/components/solarSystem/core/index.d.ts +2 -0
  488. package/dist/src/components/solarSystem/core/types.d.ts +11 -0
  489. package/dist/src/components/solarSystem/element/index.d.ts +9 -0
  490. package/dist/src/components/solarSystem/index.d.ts +3 -9
  491. package/dist/src/components/solarSystem/react/index.d.ts +4 -0
  492. package/dist/src/components/speedometer/core/engine.d.ts +2 -0
  493. package/dist/src/components/speedometer/core/index.d.ts +2 -0
  494. package/dist/src/components/speedometer/core/types.d.ts +11 -0
  495. package/dist/src/components/speedometer/element/index.d.ts +9 -0
  496. package/dist/src/components/speedometer/index.d.ts +3 -9
  497. package/dist/src/components/speedometer/react/index.d.ts +4 -0
  498. package/dist/src/components/splitReveal/core/engine.d.ts +2 -0
  499. package/dist/src/components/splitReveal/core/index.d.ts +2 -0
  500. package/dist/src/components/splitReveal/core/types.d.ts +10 -0
  501. package/dist/src/components/splitReveal/element/index.d.ts +9 -0
  502. package/dist/src/components/splitReveal/index.d.ts +3 -11
  503. package/dist/src/components/splitReveal/react/index.d.ts +4 -0
  504. package/dist/src/components/splitText/core/engine.d.ts +2 -0
  505. package/dist/src/components/splitText/core/index.d.ts +2 -0
  506. package/dist/src/components/splitText/core/types.d.ts +15 -0
  507. package/dist/src/components/splitText/element/index.d.ts +13 -0
  508. package/dist/src/components/splitText/index.d.ts +3 -21
  509. package/dist/src/components/splitText/react/index.d.ts +4 -0
  510. package/dist/src/components/spotlight/core/engine.d.ts +2 -0
  511. package/dist/src/components/spotlight/core/index.d.ts +2 -0
  512. package/dist/src/components/spotlight/core/types.d.ts +13 -0
  513. package/dist/src/components/spotlight/element/index.d.ts +14 -0
  514. package/dist/src/components/spotlight/index.d.ts +3 -10
  515. package/dist/src/components/spotlight/react/index.d.ts +6 -0
  516. package/dist/src/components/springMass/core/engine.d.ts +2 -0
  517. package/dist/src/components/springMass/core/index.d.ts +2 -0
  518. package/dist/src/components/springMass/core/types.d.ts +21 -0
  519. package/dist/src/components/springMass/element/index.d.ts +9 -0
  520. package/dist/src/components/springMass/index.d.ts +3 -19
  521. package/dist/src/components/springMass/react/index.d.ts +4 -0
  522. package/dist/src/components/starfield/core/engine.d.ts +2 -0
  523. package/dist/src/components/starfield/core/index.d.ts +2 -0
  524. package/dist/src/components/starfield/core/types.d.ts +12 -0
  525. package/dist/src/components/starfield/element/index.d.ts +9 -0
  526. package/dist/src/components/starfield/index.d.ts +3 -13
  527. package/dist/src/components/starfield/react/index.d.ts +4 -0
  528. package/dist/src/components/textMorph/core/engine.d.ts +2 -0
  529. package/dist/src/components/textMorph/core/index.d.ts +2 -0
  530. package/dist/src/components/textMorph/core/types.d.ts +12 -0
  531. package/dist/src/components/textMorph/element/index.d.ts +13 -0
  532. package/dist/src/components/textMorph/index.d.ts +3 -15
  533. package/dist/src/components/textMorph/react/index.d.ts +4 -0
  534. package/dist/src/components/timelinePulse/core/engine.d.ts +2 -0
  535. package/dist/src/components/timelinePulse/core/index.d.ts +2 -0
  536. package/dist/src/components/timelinePulse/core/types.d.ts +10 -0
  537. package/dist/src/components/timelinePulse/element/index.d.ts +13 -0
  538. package/dist/src/components/timelinePulse/index.d.ts +3 -8
  539. package/dist/src/components/timelinePulse/react/index.d.ts +4 -0
  540. package/dist/src/components/trueFocus/core/engine.d.ts +2 -0
  541. package/dist/src/components/trueFocus/core/index.d.ts +2 -0
  542. package/dist/src/components/trueFocus/core/types.d.ts +17 -0
  543. package/dist/src/components/trueFocus/element/index.d.ts +9 -0
  544. package/dist/src/components/trueFocus/index.d.ts +3 -25
  545. package/dist/src/components/trueFocus/react/index.d.ts +4 -0
  546. package/dist/src/components/turntable/core/engine.d.ts +2 -0
  547. package/dist/src/components/turntable/core/index.d.ts +2 -0
  548. package/dist/src/components/turntable/core/types.d.ts +35 -0
  549. package/dist/src/components/turntable/element/index.d.ts +15 -0
  550. package/dist/src/components/turntable/index.d.ts +3 -33
  551. package/dist/src/components/turntable/react/index.d.ts +5 -0
  552. package/dist/src/components/typewriter/core/engine.d.ts +2 -0
  553. package/dist/src/components/typewriter/core/index.d.ts +2 -0
  554. package/dist/src/components/typewriter/core/types.d.ts +11 -0
  555. package/dist/src/components/typewriter/element/index.d.ts +13 -0
  556. package/dist/src/components/typewriter/index.d.ts +3 -13
  557. package/dist/src/components/typewriter/react/index.d.ts +4 -0
  558. package/dist/src/components/waveButton/core/engine.d.ts +2 -0
  559. package/dist/src/components/waveButton/core/index.d.ts +2 -0
  560. package/dist/src/components/waveButton/core/types.d.ts +13 -0
  561. package/dist/src/components/waveButton/element/index.d.ts +14 -0
  562. package/dist/src/components/waveButton/index.d.ts +3 -9
  563. package/dist/src/components/waveButton/react/index.d.ts +4 -0
  564. package/dist/src/components/waveText/core/engine.d.ts +2 -0
  565. package/dist/src/components/waveText/core/index.d.ts +2 -0
  566. package/dist/src/components/waveText/core/types.d.ts +11 -0
  567. package/dist/src/components/waveText/element/index.d.ts +9 -0
  568. package/dist/src/components/waveText/index.d.ts +3 -13
  569. package/dist/src/components/waveText/react/index.d.ts +4 -0
  570. package/dist/src/components/weatherBackground/core/engine.d.ts +2 -0
  571. package/dist/src/components/weatherBackground/core/index.d.ts +14 -0
  572. package/dist/src/components/weatherBackground/core/types.d.ts +7 -0
  573. package/dist/src/components/weatherBackground/element/index.d.ts +13 -0
  574. package/dist/src/components/weatherBackground/index.d.ts +5 -5
  575. package/dist/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  576. package/dist/src/components/weatherBackground/live-weather.d.ts +3 -69
  577. package/dist/src/components/weatherBackground/react/index.d.ts +3 -0
  578. package/dist/src/components/weatherBackground/vue/useLiveWeather.d.ts +15 -0
  579. package/dist/src/core.d.ts +91 -0
  580. package/dist/src/elements.d.ts +0 -0
  581. package/dist/src/vite-env.d.ts +6 -0
  582. package/dist/src/vue.d.ts +91 -0
  583. package/dist/style.css +1 -0
  584. package/dist/vue.cjs +1 -0
  585. package/dist/vue.d.ts +1 -0
  586. package/dist/vue.js +2405 -0
  587. package/package.json +40 -4
  588. package/dist/index.css +0 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,79 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [4.1.0] - 2026-11-18
11
+
12
+ 4.0.0 发布后合入 `master`、此前未上 npm 的两段改动随本版本一起发布:PR #5(P0 硬化与 4.1 质量项)和 PR #6(P1 发现、HTML 片段、减少动效与体积预算)。全部包版本对齐到 **4.1.0**。
13
+
14
+ ### Added
15
+
16
+ - `WeatherBackground` Vue:`@cos-design/weather-background/vue` 导出 `useLiveWeather` / `useSunTimes`(实现 `src/components/weatherBackground/vue/useLiveWeather.ts`,说明见 [docs/examples/weather-background-vue.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/examples/weather-background-vue.md))
17
+ - `@cos-design/shared` 导出 `element-options`(`readBooleanAttr`、`readNumberAttr`、`readStringAttr`、`readJsonAttr`、`readPropertyOverride`、`camelToKebabAttr`、`optionCallbackDispatcher`、`BooleanAttrMode`),Element 适配器共用解析
18
+ - GitHub 发现:仓库内记录多框架 About / topics;Issue 模板分为 Bug、新特效提案、框架适配。Discussions 需维护者在 Settings 勾选(见 [docs/github-discovery.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/github-discovery.md))
19
+ - Playground Element Tab:「复制 HTML」得到含 `script type="module"`、自定义元素和关键属性(含 `auto="false"`)的完整页面
20
+ - 减少动效审计表 [docs/a11y-reduced-motion.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/a11y-reduced-motion.md)
21
+ - 活动页按需安装说明,以及 `pnpm verify:bundle-budget`(代表性包 gzip;仅 `photoLantern` 引用 `three`)
22
+ - WebGL dispose 清单与脚本
23
+
24
+ ### Changed
25
+
26
+ - CI:`verify:v4-matrix`、`verify:v4-runtime`、`verify:webgl-dispose`
27
+ - Playwright 多框架 smoke(Vue / Web Components / Core)
28
+ - Vitest:抽奖与属性解析;Core 单测加深(FlipCard 受控、ScratchCard 阈值、dispose smoke)
29
+ - CI 构建 `examples/vue-app` 与 `examples/vanilla`
30
+ - `LavaBubble` / `SoapBubbles` 在减少动效时停在首帧;`MatrixRain` 标题与天气加载圈不再空转
31
+ - Next.js client-only 写法在 QUICKSTART、`examples/next-app` 与 Playground 快速开始中对齐为 `'use client'` + `@cos-design/*` + `dynamic(..., { ssr: false })`
32
+ - 聚合包 `cos-design` 与全部 `@cos-design/*` 子包:4.0.0 → 4.1.0
33
+
34
+ ## [4.0.0] - 2026-09-23
35
+
36
+ ### Added
37
+
38
+ - **Multi-framework support** for all **91** components (package names unchanged):
39
+ - React — default entry `.` (backward compatible)
40
+ - Vue 3 — `@cos-design/<pkg>/vue` and `cos-design/vue`
41
+ - Core API — `@cos-design/<pkg>/core` and `cos-design/core` (`create*` factories)
42
+ - Web Components — `@cos-design/<pkg>/element` and `cos-design/elements`
43
+ - Core + Adapter architecture: shared engines under `src/components/*/core`
44
+ - `@cos-design/shared/react` subpath for React hooks (`useElementSize`, `useCanvasBox`)
45
+ - Migration guide: [docs/migration-v4.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/migration-v4.md)
46
+ - Architecture RFC: [docs/rfc-v4-multi-framework.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/rfc-v4-multi-framework.md)
47
+ - Tooling: `migrate:component`, `migrate:batch-a|b|c|d`, `verify:v4-matrix`, `verify:v4-runtime`
48
+
49
+ ### Changed
50
+
51
+ - All packages aligned to **4.0.0**
52
+ - Component styles ship as stable `cos-*` CSS classes (shared `style/index.css`) instead of hashed LESS modules in adapters
53
+ - Umbrella `cos-design` description / peers updated for optional Vue
54
+ - Aggregate build emits `vue` / `core` / `elements` entry points alongside React `index`
55
+ - Remove unused per-component `style/index.module.less` leftovers (adapters use `style/index.css`)
56
+ - Fix `generate-ai-docs` catastrophic regex hang when regenerating `llms.txt` / `docs/ai.md`
57
+ - Fix FlipCard zero-width host in Playground (`cos-flipCard-host` + flipped BEM `--flipped`) and static preview layout for v4 host wrappers
58
+ - Mark umbrella `three` peer as optional
59
+ - Playground: React / Vue / Web Components / Core framework tabs with live Vue & Element mounts
60
+ - Examples: `examples/next-app`, `examples/vue-app`, and `examples/vanilla` (workspace-linked to 4.0.0)
61
+ - Element adapters: FlipCard / NineGrid / ScratchCard emit `reveal` / `draw-end` CustomEvents
62
+ - Regenerate all Vue/Element adapters from `core/types.ts` (attr parsing, boolean clear, on\* → events, photos/prizes JS props)
63
+ - Playground Element mounts use kebab-case attributes
64
+ - **Runtime parity with 3.x**: fill sizes the adapter host (`applyCanvasHostBox`); React/Vue adapters update only when options change (fingerprint); slotted components use portals/`Teleport`; reduce-motion no longer starts a second rAF loop; `@cos-design/shared` default entry is framework-free again
65
+
66
+ ### Fixed
67
+
68
+ - FlipCounter: digit cards mount correctly; `auto` / `autoInterval` for Vue / WC / Core demos
69
+ - ProgressChest: `auto` demo prop so non-React tabs animate
70
+ - ClickSpark: slotted content + `[hidden]` hint stacking across frameworks
71
+ - PhotoPostcard: restore 3.x declarative React behavior; Core avoids rebuild during drag
72
+ - Confetti / Turntable / ScratchCard / RedPacketRain: interactive demos, prize lists, and host centering for Playground multi-framework tabs
73
+ - Canvas hosts: `margin-inline: auto` when not `fill` so fixed-size canvases center in full-width preview hosts
74
+ - `examples/next-app` dependencies aligned to `workspace:*` (4.0.0) like vue/vanilla examples
75
+ - Umbrella npm `README` / `CHANGELOG`: `sync-packages` rewrites repo-relative doc links to GitHub URLs so they work on npmjs.com
76
+
77
+ ### Breaking
78
+
79
+ - `@cos-design/shared` default export no longer includes React hooks — import from `@cos-design/shared/react`
80
+ - CSS Module hashed class names from v3 adapters are replaced by public `cos-*` prefixes (override selectors may need updates)
81
+ - Major version bump (3.x → 4.0.0)
82
+
10
83
  ## [3.8.1] - 2026-09-01
11
84
 
12
85
  ### Added
@@ -43,7 +116,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
43
116
 
44
117
  ### Removed
45
118
 
46
- - Playground「活动配方」整页路由与导航(`#/recipes`);活动组合改走 [examples/next-app](./examples/next-app) 与 [docs/campaign-10-minutes.md](./docs/campaign-10-minutes.md)
119
+ - Playground「活动配方」整页路由与导航(`#/recipes`);活动组合改走 [examples/next-app](https://github.com/jiaxiantao/cos-design/blob/master/examples/next-app) 与 [docs/campaign-10-minutes.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/campaign-10-minutes.md)
47
120
 
48
121
  ### Added
49
122
 
@@ -64,7 +137,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
64
137
 
65
138
  - Playground 配方页「可复制片段」(`recipe-snippets` + 一键复制)
66
139
  - Next 示例主链路:`CampaignFlow`(fill hero → FlipCard → NineGrid → Confetti)
67
- - 文档:[docs/campaign-10-minutes.md](./docs/campaign-10-minutes.md)、[docs/campaign-patterns.md](./docs/campaign-patterns.md)
140
+ - 文档:[docs/campaign-10-minutes.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/campaign-10-minutes.md)、[docs/campaign-patterns.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/campaign-patterns.md)
68
141
  - Playwright 交互 smoke:翻牌 / 九宫格 busy / 转盘出结果 / checkin-draw 解锁
69
142
  - `NineGrid.spinningText`;Turntable / SlotMachine / NineGrid 按钮 `aria-busy` + `data-testid`
70
143
 
@@ -90,7 +163,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
90
163
 
91
164
  - NineGrid / FlipCard Playground 属性说明改为中文源 + EN 映射;`extract-props` 支持 forwardRef 换行解构默认值
92
165
  - `pnpm verify:context7`:区分 required(`fill` / `next-app`)与 optional markers
93
- - [docs/ai-discovery.md](./docs/ai-discovery.md) 同步健康状态与 refresh 冷却说明(勿把 API key 写入仓库)
166
+ - [docs/ai-discovery.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai-discovery.md) 同步健康状态与 refresh 冷却说明(勿把 API key 写入仓库)
94
167
  - @cos-design/flip-card: 3.7.8 → 3.7.9
95
168
  - @cos-design/nine-grid: 3.7.8 → 3.7.9
96
169
  - cos-design: 聚合包更新至 3.7.9
@@ -123,12 +196,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
123
196
 
124
197
  ### Added
125
198
 
126
- - 可运行 Next.js 示例工程 [examples/next-app](./examples/next-app)(fill hero + 刮开庆祝)
199
+ - 可运行 Next.js 示例工程 [examples/next-app](https://github.com/jiaxiantao/cos-design/blob/master/examples/next-app)(fill hero + 刮开庆祝)
127
200
  - `pnpm verify:context7`:检查 Context7 是否收录以及索引是否包含 `fill` / Next 示例
128
201
 
129
202
  ### Changed
130
203
 
131
- - Context7 校验结论写入 [docs/ai-discovery.md](./docs/ai-discovery.md);刷新 workflow 在缺少 `CONTEXT7_API_KEY` 时发出 warning
204
+ - Context7 校验结论写入 [docs/ai-discovery.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai-discovery.md);刷新 workflow 在缺少 `CONTEXT7_API_KEY` 时发出 warning
132
205
  - `context7.json` 规则补充 `fill` 与 Next 示例路径
133
206
  - cos-design: 聚合包更新至 3.7.7
134
207
 
@@ -139,7 +212,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
139
212
  - `@cos-design/shared`:新增 `useCanvasBox`(fill 尺寸一站式 hook)
140
213
  - 背景组件全面支持 `fill`:`WeatherBackground`、`Aurora`、`Starfield`、`Snowfall`、`MeteorRain`、`CyberGrid`、`SmokeFog`、`BubbleField`、`RippleWater`
141
214
  - `Starfield` / `Snowfall` / `MeteorRain` / `CyberGrid` / `Aurora` 接入 `prefers-reduced-motion` 静态降级
142
- - Playground 配方「全屏氛围 Hero」;Next.js 接入示例 [docs/examples/next-app-router.md](./docs/examples/next-app-router.md)
215
+ - Playground 配方「全屏氛围 Hero」;Next.js 接入示例 [docs/examples/next-app-router.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/examples/next-app-router.md)
143
216
 
144
217
  ### Changed
145
218
 
package/README.md CHANGED
@@ -2,16 +2,17 @@
2
2
 
3
3
  # cos-design
4
4
 
5
- **91 React visual-effect components** for marketing pages, brand landings, and creative showcases
6
- **91 个 React 视觉特效组件 · 活动页 / 品牌页 / 创意展示开箱即用**
5
+ **91 multi-framework visual-effect components** for marketing pages, brand landings, and creative showcases
6
+ **91 个视觉特效组件 · React / Vue / 原生 · 活动页 / 品牌页 / 创意展示开箱即用**
7
7
 
8
8
  [![CI](https://github.com/jiaxiantao/cos-design/actions/workflows/ci.yml/badge.svg)](https://github.com/jiaxiantao/cos-design/actions/workflows/ci.yml)
9
9
  [![npm version](https://img.shields.io/npm/v/cos-design.svg)](https://www.npmjs.com/package/cos-design)
10
10
  [![license](https://img.shields.io/npm/l/cos-design.svg)](https://github.com/jiaxiantao/cos-design/blob/main/LICENSE)
11
- [![React](https://img.shields.io/badge/React-19-61dafb)](https://react.dev/)
11
+ [![React](https://img.shields.io/badge/React-18%2B-61dafb)](https://react.dev/)
12
+ [![Vue](https://img.shields.io/badge/Vue-3.4%2B-42b883)](https://vuejs.org/)
12
13
  [![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6)](https://www.typescriptlang.org/)
13
14
 
14
- [Playground](https://jiaxiantao.github.io/cos-design/) · [Quickstart](./QUICKSTART.md) · [**10-minute campaign**](./docs/campaign-10-minutes.md) · [llms.txt](https://jiaxiantao.github.io/cos-design/llms.txt) · [AI discovery](./docs/ai-discovery.md) · [Next.js example](./examples/next-app) · [EN guide](./website-content/cos-design-marketing-effects-en.md) · [中文指南](./website-content/cos-design-intro.md) · [Changelog](./CHANGELOG.md)
15
+ [Playground](https://jiaxiantao.github.io/cos-design/) · [Quickstart](https://github.com/jiaxiantao/cos-design/blob/master/QUICKSTART.md) · [**Migrate to 4.0**](https://github.com/jiaxiantao/cos-design/blob/master/docs/migration-v4.md) · [**10-minute campaign**](https://github.com/jiaxiantao/cos-design/blob/master/docs/campaign-10-minutes.md) · [llms.txt](https://jiaxiantao.github.io/cos-design/llms.txt) · [AI discovery](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai-discovery.md) · [Next.js](https://github.com/jiaxiantao/cos-design/blob/master/examples/next-app) · [Vue](https://github.com/jiaxiantao/cos-design/blob/master/examples/vue-app) · [Vanilla](https://github.com/jiaxiantao/cos-design/blob/master/examples/vanilla) · [EN guide](https://github.com/jiaxiantao/cos-design/blob/master/website-content/cos-design-marketing-effects-en.md) · [中文指南](https://github.com/jiaxiantao/cos-design/blob/master/website-content/cos-design-intro.md) · [Changelog](https://github.com/jiaxiantao/cos-design/blob/master/CHANGELOG.md)
15
16
 
16
17
  </div>
17
18
 
@@ -19,14 +20,18 @@
19
20
 
20
21
  ## English (for developers & AI agents)
21
22
 
22
- **cos-design** is a React library of **visual effects** — fireworks, scratch cards, weather/matrix backgrounds, neon headlines, flip counters — not a general admin UI kit.
23
+ **cos-design** is a **multi-framework** library of **visual effects** — fireworks, scratch cards, weather/matrix backgrounds, neon headlines, flip counters — not a general admin UI kit. **React is the default entry**; Vue 3, Core APIs, and Web Components use the same package names via subpaths.
23
24
 
24
25
  ```bash
25
- pnpm add cos-design
26
- # or smaller per-component packages:
26
+ # Campaign pages: install only the packages you render
27
27
  pnpm add @cos-design/fireworks @cos-design/scratch-card @cos-design/weather-background
28
+
29
+ # Umbrella is for trying the catalog, not for a production campaign entry
30
+ pnpm add cos-design
28
31
  ```
29
32
 
33
+ `three` is a peer of `@cos-design/photo-lantern` only (optional on the umbrella). Gzip budgets: [docs/bundle-budget.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/bundle-budget.md).
34
+
30
35
  ```tsx
31
36
  import { Fireworks } from '@cos-design/fireworks';
32
37
  import { ScratchCard } from '@cos-design/scratch-card';
@@ -41,18 +46,36 @@ export function Campaign() {
41
46
  }
42
47
  ```
43
48
 
49
+ ```vue
50
+ <script setup>
51
+ import { Fireworks } from '@cos-design/fireworks/vue';
52
+ </script>
53
+ <template>
54
+ <Fireworks :width="800" :height="500" />
55
+ </template>
56
+ ```
57
+
58
+ ```html
59
+ <script type="module">
60
+ import '@cos-design/fireworks/element';
61
+ </script>
62
+ <cos-fireworks auto fill></cos-fireworks>
63
+ ```
64
+
44
65
  - **Use for:** campaign / lottery / celebration UI, canvas backgrounds, animated headlines, dashboard decorations
45
66
  - **Do not use for:** tables, forms, nav shells → use Ant Design / shadcn / MUI
46
- - **Start here (campaign):** [Build a campaign page in 10 minutes](./docs/campaign-10-minutes.md) · runnable [examples/next-app](./examples/next-app)
67
+ - **v4 migration:** [docs/migration-v4.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/migration-v4.md)
68
+ - **Start here (campaign):** [Build a campaign page in 10 minutes](https://github.com/jiaxiantao/cos-design/blob/master/docs/campaign-10-minutes.md) · runnable [examples/next-app](https://github.com/jiaxiantao/cos-design/blob/master/examples/next-app) · [examples/vue-app](https://github.com/jiaxiantao/cos-design/blob/master/examples/vue-app) · [examples/vanilla](https://github.com/jiaxiantao/cos-design/blob/master/examples/vanilla)
47
69
  - **AI index:** https://jiaxiantao.github.io/cos-design/llms.txt · **Context7:** `/jiaxiantao/cos-design`
48
- - **Cursor Skill install:** see [docs/ai-discovery.md](./docs/ai-discovery.md)
49
- - **Article:** [React marketing page effects with cos-design](./website-content/cos-design-marketing-effects-en.md)
70
+ - **Cursor Skill install:** see [docs/ai-discovery.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai-discovery.md)
71
+ - **Article:** [Marketing page effects with cos-design](https://github.com/jiaxiantao/cos-design/blob/master/website-content/cos-design-marketing-effects-en.md)
72
+ - **Quality (all frameworks):** `pnpm verify:v4-matrix` · `pnpm verify:v4-runtime` · `pnpm test:unit` · `pnpm test:smoke` (React + Vue / Web Components / Core tabs)
50
73
 
51
74
  ---
52
75
 
53
76
  ## 这是什么?
54
77
 
55
- **cos-design** 是一个面向**视觉表达**的 React 组件库——专注特效与氛围,给页面加趣味、加记忆点的「特效层」。
78
+ **cos-design** 是一个面向**视觉表达**的多框架特效组件库(React 默认入口,同时支持 Vue 3 / 原生命令式 API / Web Components)——专注特效与氛围,给页面加趣味、加记忆点的「特效层」。
56
79
 
57
80
  适合用在:
58
81
 
@@ -69,20 +92,21 @@ export function Campaign() {
69
92
 
70
93
  ## 快速开始
71
94
 
72
- > 完整说明见 **[QUICKSTART.md](./QUICKSTART.md)** · Playground 内访问 **#/quickstart**
95
+ > 完整说明见 **[QUICKSTART.md](https://github.com/jiaxiantao/cos-design/blob/master/QUICKSTART.md)** · Playground 内访问 **#/quickstart**
73
96
 
74
97
  ### 安装
75
98
 
76
99
  ```bash
77
- # 安装全部组件
78
- pnpm add cos-design
79
-
80
- # 或按需安装单个组件(npm 包名为 kebab-case)
100
+ # 活动页请按需安装子包(推荐)
81
101
  pnpm add @cos-design/weather-background
82
102
  pnpm add @cos-design/fireworks
103
+
104
+ # 聚合包只适合本地试用全部 91 个组件,不要作为活动页的生产入口
105
+ pnpm add cos-design
83
106
  ```
84
107
 
85
- > 目录 `weatherBackground` → `@cos-design/weather-background`;依赖 `@cos-design/shared` 的组件会自动安装工具包。
108
+ > 目录 `weatherBackground` → `@cos-design/weather-background`;依赖 `@cos-design/shared` 的组件会自动安装工具包。
109
+ > **活动页优先 `@cos-design/*`。** 聚合包 `cos-design` 的默认入口会带上全部组件。`three` 只有 [`@cos-design/photo-lantern`](https://github.com/jiaxiantao/cos-design/blob/master/docs/bundle-budget.md) 会拉取(聚合包把它标成 optional peer)。体积门禁见 [docs/bundle-budget.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/bundle-budget.md)。
86
110
 
87
111
  ### 最简示例
88
112
 
@@ -110,17 +134,17 @@ export default function Page() {
110
134
 
111
135
  让 AI 在写活动页、特效背景时自动选用本库:
112
136
 
113
- | 资源 | 说明 |
114
- | ---------------------------------------------------------------------- | ------------------------------------------------------- |
115
- | [llms.txt](https://jiaxiantao.github.io/cos-design/llms.txt) | 供 Agent 抓取的索引(场景 → 组件 → 安装命令) |
116
- | [llms-full.txt](https://jiaxiantao.github.io/cos-design/llms-full.txt) | 站点上的完整 AI 参考(与 docs/ai.md 同步) |
117
- | [docs/ai.md](./docs/ai.md) | 91 个组件的完整 AI 参考(安装 / import / 示例 / Props) |
118
- | [docs/examples/next-app-router.md](./docs/examples/next-app-router.md) | Next.js App Router 接入说明(SSR + fill) |
119
- | [examples/next-app](./examples/next-app) | 可运行 Next.js 示例(`pnpm install && pnpm dev`) |
120
- | [docs/ai-discovery.md](./docs/ai-discovery.md) | Context7 提交、校验、Cursor Skill 安装、项目 Rule 片段 |
121
- | [AGENTS.md](./AGENTS.md) | 仓库级 Agent 规则,可复制到用户项目 |
122
- | [.cursor/skills/cos-design](./.cursor/skills/cos-design/SKILL.md) | Cursor Skill |
123
- | Context7 | `/jiaxiantao/cos-design`(`pnpm verify:context7`) |
137
+ | 资源 | 说明 |
138
+ | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
139
+ | [llms.txt](https://jiaxiantao.github.io/cos-design/llms.txt) | 供 Agent 抓取的索引(场景 → 组件 → 安装命令) |
140
+ | [llms-full.txt](https://jiaxiantao.github.io/cos-design/llms-full.txt) | 站点上的完整 AI 参考(与 docs/ai.md 同步) |
141
+ | [docs/ai.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai.md) | 91 个组件的完整 AI 参考(安装 / import / 示例 / Props) |
142
+ | [docs/examples/next-app-router.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/examples/next-app-router.md) | Next.js App Router 接入说明(SSR + fill) |
143
+ | [examples/next-app](https://github.com/jiaxiantao/cos-design/blob/master/examples/next-app) | 可运行 Next.js 示例(`pnpm install && pnpm dev`) |
144
+ | [docs/ai-discovery.md](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai-discovery.md) | Context7 提交、校验、Cursor Skill 安装、项目 Rule 片段 |
145
+ | [AGENTS.md](https://github.com/jiaxiantao/cos-design/blob/master/AGENTS.md) | 仓库级 Agent 规则,可复制到用户项目 |
146
+ | [.cursor/skills/cos-design](https://github.com/jiaxiantao/cos-design/blob/master/.cursor/skills/cos-design/SKILL.md) | Cursor Skill |
147
+ | Context7 | `/jiaxiantao/cos-design`(`pnpm verify:context7`) |
124
148
 
125
149
  **安装 Cursor Skill(用户本机):**
126
150
 
@@ -144,13 +168,15 @@ Context7: /jiaxiantao/cos-design
144
168
 
145
169
  ### 使用注意(摘要)
146
170
 
147
- | 注意点 | 说明 |
148
- | -------- | -------------------------------------------------------------------- |
149
- | **SSR** | Canvas 组件需在 Next.js 等框架中 `dynamic(..., { ssr: false })` |
150
- | **尺寸** | Canvas 组件需明确 `width` / `height`,或设 `fill` 铺满有高度的父容器 |
151
- | **密度** | 建议每页「一个强背景 + 若干局部交互」,避免多 Canvas 抢性能 |
152
- | **权限** | `AudioVisualizer` 开启麦克风时需 HTTPS 与用户授权 |
153
- | **省电** | 标签页隐藏时,多数 Canvas 动画自动暂停 |
171
+ | 注意点 | 说明 |
172
+ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
173
+ | **SSR** | 与 Next 示例相同:`'use client'` + `@cos-design/*` + `dynamic(..., { ssr: false })` |
174
+ | **尺寸** | Canvas 组件需明确 `width` / `height`,或设 `fill` 铺满有高度的父容器 |
175
+ | **密度** | 建议每页「一个强背景 + 若干局部交互」,避免多 Canvas 抢性能 |
176
+ | **权限** | `AudioVisualizer` 开启麦克风时需 HTTPS 与用户授权 |
177
+ | **省电** | 标签页隐藏时,多数 Canvas 动画自动暂停 |
178
+ | **减少动效** | 背景停在首帧,转盘 / 老虎机 / 九宫格跳过旋转。见 [审计表](https://github.com/jiaxiantao/cos-design/blob/master/docs/a11y-reduced-motion.md) |
179
+ | **体积** | 活动页用 `@cos-design/*`。`three` 仅 PhotoLantern。见 [预算](https://github.com/jiaxiantao/cos-design/blob/master/docs/bundle-budget.md) |
154
180
 
155
181
  ---
156
182
 
@@ -378,40 +404,50 @@ npx --yes pnpm@9 dev # 启动 Playground
378
404
 
379
405
  ## 使用注意
380
406
 
381
- 详见 [QUICKSTART.md](./QUICKSTART.md)。以下为高频场景摘要:
407
+ 详见 [QUICKSTART.md](https://github.com/jiaxiantao/cos-design/blob/master/QUICKSTART.md)。以下为高频场景摘要:
382
408
 
383
409
  **Canvas 组件请客户端渲染**(依赖 `window` / `canvas` / `requestAnimationFrame`):
384
410
 
385
411
  ```tsx
412
+ 'use client';
413
+
386
414
  import dynamic from 'next/dynamic';
387
415
 
388
- const Fireworks = dynamic(() => import('cos-design').then((m) => m.Fireworks), { ssr: false });
416
+ const WeatherBackground = dynamic(
417
+ () => import('@cos-design/weather-background').then((m) => m.WeatherBackground),
418
+ { ssr: false },
419
+ );
389
420
  ```
390
421
 
422
+ 与 [QUICKSTART.md](https://github.com/jiaxiantao/cos-design/blob/master/QUICKSTART.md) 和 [examples/next-app](https://github.com/jiaxiantao/cos-design/blob/master/examples/next-app) 相同:Canvas / WebGL 走按需子包的 `dynamic(..., { ssr: false })`。
423
+
391
424
  **控制使用密度** — 一个页面建议「一个强视觉背景 + 若干局部交互」,避免全场动画互相抢戏。
392
425
 
393
426
  ---
394
427
 
395
428
  ## 文档
396
429
 
397
- | 文档 | 内容 |
398
- | ------------------------------------------------------------ | -------------------------------- |
399
- | [快速开始](./QUICKSTART.md) | 安装、用法、注意事项与常见问题 |
400
- | [AI Agent 参考](./docs/ai.md) | 供 AI 使用的组件选型与 API 文档 |
401
- | [llms.txt](https://jiaxiantao.github.io/cos-design/llms.txt) | 机器可读索引(llmstxt 规范) |
402
- | [AGENTS.md](./AGENTS.md) | 编码 Agent 仓库规则 |
403
- | [v3.0 发布博客](./website-content/cos-design-v3-release.md) | 重大升级解读、分类体系、技术实现 |
404
- | [完整介绍与实践指南](./website-content/cos-design-intro.md) | 架构、使用规则、组件详解 |
405
- | [CHANGELOG](./CHANGELOG.md) | 版本更新记录 |
406
- | [CONTRIBUTING](./CONTRIBUTING.md) | 参与贡献指南 |
430
+ | 文档 | 内容 |
431
+ | -------------------------------------------------------------------------------------------------------------- | --------------------------------- |
432
+ | [快速开始](https://github.com/jiaxiantao/cos-design/blob/master/QUICKSTART.md) | 安装、用法、注意事项与常见问题 |
433
+ | [包体积与 three](https://github.com/jiaxiantao/cos-design/blob/master/docs/bundle-budget.md) | 按需子包、gzip 预算、谁依赖 three |
434
+ | [减少动效审计](https://github.com/jiaxiantao/cos-design/blob/master/docs/a11y-reduced-motion.md) | 背景首帧与抽奖跳过旋转 |
435
+ | [GitHub 发现](https://github.com/jiaxiantao/cos-design/blob/master/docs/github-discovery.md) | About / topics / Discussions |
436
+ | [AI Agent 参考](https://github.com/jiaxiantao/cos-design/blob/master/docs/ai.md) | 供 AI 使用的组件选型与 API 文档 |
437
+ | [llms.txt](https://jiaxiantao.github.io/cos-design/llms.txt) | 机器可读索引(llmstxt 规范) |
438
+ | [AGENTS.md](https://github.com/jiaxiantao/cos-design/blob/master/AGENTS.md) | 编码 Agent 仓库规则 |
439
+ | [v3.0 发布博客](https://github.com/jiaxiantao/cos-design/blob/master/website-content/cos-design-v3-release.md) | 重大升级解读、分类体系、技术实现 |
440
+ | [完整介绍与实践指南](https://github.com/jiaxiantao/cos-design/blob/master/website-content/cos-design-intro.md) | 架构、使用规则、组件详解 |
441
+ | [CHANGELOG](https://github.com/jiaxiantao/cos-design/blob/master/CHANGELOG.md) | 版本更新记录 |
442
+ | [CONTRIBUTING](https://github.com/jiaxiantao/cos-design/blob/master/CONTRIBUTING.md) | 参与贡献指南 |
407
443
 
408
444
  ---
409
445
 
410
446
  ## 自动发布
411
447
 
412
- 推送到 `master` 后,GitHub Actions 自动 lint、构建,并将新版本发布到 [npm](https://www.npmjs.com/package/cos-design)。
448
+ 推送到 `master` 后,GitHub Actions(`.github/workflows/ci.yml`)自动 lint、构建,并将新版本发布到 [npm](https://www.npmjs.com/package/cos-design)。
413
449
 
414
- 首次配置需在 GitHub Secrets 中设置 `NPM_TOKEN`(需勾选 **Bypass 2FA for publish**)。详见 [npm Access Tokens](https://www.npmjs.com/settings/jiaxiantao/tokens)。
450
+ 发布使用 npm Trusted Publishing(OIDC),不读取 `NPM_TOKEN`。npmjs.com 上每个包的 Trusted Publisher 需指向仓库 `jiaxiantao/cos-design`、workflow 文件名 `ci.yml`。不要在该 job 里写 `registry-url`、`_authToken` 或 `NODE_AUTH_TOKEN`,否则 npm 会跳过 OIDC,未登录的 PUT 会以 `E404` 失败。
415
451
 
416
452
  ---
417
453
 
@@ -425,6 +461,6 @@ const Fireworks = dynamic(() => import('cos-design').then((m) => m.Fireworks), {
425
461
 
426
462
  **如果觉得有用,欢迎 Star ⭐**
427
463
 
428
- [MIT](./LICENSE) © [jiaxiantao](https://github.com/jiaxiantao)
464
+ [MIT](https://github.com/jiaxiantao/cos-design/blob/master/LICENSE) © [jiaxiantao](https://github.com/jiaxiantao)
429
465
 
430
466
  </div>
@@ -0,0 +1 @@
1
+ let e=require("@cos-design/shared");var t=`cos-photo-postcard`,n=6,r=280,i=320,a=(e,t)=>t<=0?0:(e%t+t)%t,o=(e,t)=>t<=0?0:Math.max(0,Math.min(t-1,Math.floor(e))),s=e=>{let t=Math.sin(e*127.1+31.7)*43758.5453;return t-Math.floor(t)},c=(e,t)=>{if(t)for(let[n,r]of Object.entries(t))r!=null&&(n.startsWith(`--`)?e.style.setProperty(n,String(r)):e.style[n]=typeof r==`number`?`${r}px`:String(r))},l=(e,n,r)=>{let i=r&&(n.title||n.description),a=n.title?n.title:`Greetings from the road`;e.replaceChildren();let o=document.createElement(`div`);o.className=`${t}__face ${t}__front`;let s=document.createElement(`div`);s.className=`${t}__photo-frame${i?` ${t}__photo-frame-with-caption`:``}`;let c=document.createElement(`div`);c.className=`${t}__photo-wrap`;let l=document.createElement(`img`);l.className=`${t}__photo`,l.src=n.src,l.alt=n.alt??n.title??``,l.draggable=!1,c.appendChild(l),s.appendChild(c);let u=document.createElement(`div`);if(u.className=`${t}__corner-stamp`,u.setAttribute(`aria-hidden`,`true`),o.append(s,u),i){let e=document.createElement(`div`);if(e.className=`${t}__front-caption`,n.title){let r=document.createElement(`p`);r.className=`${t}__front-caption-title`,r.textContent=n.title,e.appendChild(r)}if(n.description){let r=document.createElement(`p`);r.className=`${t}__front-caption-desc`,r.textContent=n.description,e.appendChild(r)}o.appendChild(e)}let d=document.createElement(`div`);d.className=`${t}__face ${t}__back`;let f=document.createElement(`div`);f.className=`${t}__divider`,f.setAttribute(`aria-hidden`,`true`);let p=document.createElement(`div`);p.className=`${t}__lined-paper`;let m=document.createElement(`p`);m.className=`${t}__greeting`,m.textContent=a,p.appendChild(m);let h=document.createElement(`p`);n.description?(h.className=`${t}__body-text`,h.textContent=n.description):(h.className=`${t}__body-placeholder`,h.textContent=`Wish you were here…`),p.appendChild(h);let g=document.createElement(`div`);g.className=`${t}__back-footer`;let _=document.createElement(`div`);_.className=`${t}__postmark`,_.setAttribute(`aria-hidden`,`true`);let v=document.createElement(`span`);v.className=`${t}__postmark-text`,v.innerHTML=`TRAVEL<br>POST`,_.appendChild(v);let y=document.createElement(`div`);y.className=`${t}__stamp-square`,y.setAttribute(`aria-hidden`,`true`),g.append(_,y),d.append(f,p,g),e.append(o,d)};function u(u,d={photos:[]}){let f={width:360,height:420,cardWidth:260,cardHeight:170,pullThreshold:80,showCaption:!0,initialIndex:0,initialFlipped:!1,ariaLabel:`明信片`,...d,photos:Array.isArray(d.photos)?d.photos:[]},p=!1,m=o(f.initialIndex??0,f.photos.length),h=!!f.initialFlipped,g=0,_=`idle`,v=null,y=null,b=null,x=``,S=document.createElement(`div`),C=document.createElement(`div`);C.className=`${t}__stage`;let w=document.createElement(`div`);w.className=`${t}__empty`,w.textContent=`暂无明信片`;let T=document.createElement(`div`);T.className=`${t}__stack`;let E=document.createElement(`div`);E.className=`${t}__card-slot`;let D=document.createElement(`div`),O=document.createElement(`div`);O.className=`${t}__flip-inner`,D.appendChild(O),E.appendChild(D);let k=document.createElement(`div`);k.className=`${t}__hint`,k.textContent=`拖拽切换 · 点击查看背面`,C.append(w,T,k),S.appendChild(C),u.appendChild(S);let A=()=>Array.isArray(f.photos)?f.photos:[],j=()=>A().length,M=(e,t)=>e?`${e.src}\0${e.title??``}\0${e.description??``}\0${e.alt??``}\0${t}`:``,N=()=>{D.className=[`${t}__card-active`,h?`${t}__flipped`:``,_===`exiting`?`${t}__card-exiting`:``].filter(Boolean).join(` `),D.style.transform=`translateX(${g}px)`,D.style.transition=_===`snapping`||_===`exiting`?`transform ${_===`exiting`?r:i}ms cubic-bezier(0.22, 1, 0.36, 1), opacity ${r}ms ease`:`none`,D.style.opacity=_===`exiting`?`0.55`:`1`,D.setAttribute(`aria-pressed`,String(h));let e=A()[m];D.setAttribute(`aria-label`,e?`${h?`背面`:`正面`}:${e.alt??e.title??`明信片 ${m+1}`}`:``)},P=(e,n,r)=>{let i=new Set([E]);for(let e of[...T.children])i.has(e)||e.remove();let a=e<=1?[]:[1,2].slice(0,Math.min(2,e-1)).map(e=>{let t=m*13.7+e*5.3;return{depth:e,rot:(s(t)*2-1)*5.5,dx:e*5+s(t+1.1)*4,dy:e*3+s(t+2.4)*3}});for(let{depth:e,rot:i,dx:o,dy:s}of a){let a=document.createElement(`div`);a.className=`${t}__stack-card`,a.style.width=`${n}px`,a.style.height=`${r}px`,a.style.transform=`translate(calc(-50% + ${o}px), calc(-50% + ${s}px)) rotate(${i}deg)`,a.style.opacity=e===1?`0.92`:`0.78`,a.setAttribute(`aria-hidden`,`true`),T.insertBefore(a,E)}},F=()=>{let n=A(),r=n.length,i=f.cardWidth??260,a=f.cardHeight??170,o=f.showCaption!==!1;if(S.className=[t,f.className].filter(Boolean).join(` `),(0,e.applyBlockHostBox)(u,S,{width:f.width??360,height:f.height??420}),c(S,f.style),S.setAttribute(`role`,`region`),S.setAttribute(`aria-label`,f.ariaLabel??`明信片`),S.tabIndex=0,w.hidden=r>0,T.hidden=r===0,k.hidden=r<=1,r===0){O.replaceChildren(),x=``;return}T.style.width=`${i}px`,T.style.height=`${a}px`,(!E.isConnected||E.parentElement!==T)&&T.appendChild(E),P(r,i,a),E.style.width=`${i}px`,E.style.height=`${a}px`,D.style.width=`${i}px`,D.style.height=`${a}px`,D.setAttribute(`role`,`button`);let s=n[m],d=M(s,o);s&&d!==x?(l(O,s,o),x=d):s||(O.replaceChildren(),x=``),N()},I=e=>{let t=A(),n=o(e,t.length);m=n,h=!1,f.onFlipChange?.(!1);let r=t[n];r&&f.onIndexChange?.(n,r)},L=e=>{I(e),g=0,_=`idle`,F()},R=e=>{let t=e*((f.cardWidth??260)*.55+48);_=`exiting`,g=t,N(),y!=null&&window.clearTimeout(y),y=window.setTimeout(()=>{L(a(m+e,A().length))},r)},z=()=>{_=`snapping`,g=0,N(),b!=null&&window.clearTimeout(b),b=window.setTimeout(()=>{_=`idle`,N()},i)},B=e=>{A().length<=1||R(e>0?1:-1)},V=()=>{h=!h,f.onFlipChange?.(h),N()},H=e=>{_===`exiting`||j()===0||(v={pointerId:e.pointerId,startX:e.clientX,moved:!1},_=`dragging`,D.setPointerCapture(e.pointerId))},U=e=>{if(!v||v.pointerId!==e.pointerId||_===`exiting`)return;let t=e.clientX-v.startX;Math.abs(t)>n&&(v.moved=!0),g=j()<=1?t*.22:t,N()},W=e=>{if(!v||v.pointerId!==e.pointerId)return;let t=v.startX,n=v.moved;if(v=null,D.hasPointerCapture(e.pointerId)&&D.releasePointerCapture(e.pointerId),_===`exiting`)return;let r=e.clientX-t;if(!n){_=`idle`,g=0,V();let e=A()[m];e&&f.onPhotoClick?.(m,e);return}if(Math.abs(r)>=(f.pullThreshold??80)&&j()>1){R(r>0?1:-1);return}z()},G=e=>{!v||v.pointerId!==e.pointerId||(v=null,D.hasPointerCapture(e.pointerId)&&D.releasePointerCapture(e.pointerId),_!==`exiting`&&z())},K=e=>{e.key===`ArrowRight`?(e.preventDefault(),B(1)):e.key===`ArrowLeft`?(e.preventDefault(),B(-1)):(e.key===` `||e.key===`Enter`)&&(e.preventDefault(),V())};return D.addEventListener(`pointerdown`,H),D.addEventListener(`pointermove`,U),D.addEventListener(`pointerup`,W),D.addEventListener(`pointercancel`,G),S.addEventListener(`keydown`,K),F(),{update(e){let t=Array.isArray(e.photos)?e.photos:e.photos===void 0?f.photos:[];f={...f,...e,photos:t},m=o(m,A().length),F()},destroy(){p||(p=!0,y!=null&&window.clearTimeout(y),b!=null&&window.clearTimeout(b),D.removeEventListener(`pointerdown`,H),D.removeEventListener(`pointermove`,U),D.removeEventListener(`pointerup`,W),D.removeEventListener(`pointercancel`,G),S.removeEventListener(`keydown`,K),S.remove())}}}Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return u}});
@@ -0,0 +1,178 @@
1
+ import { applyBlockHostBox as e } from "@cos-design/shared";
2
+ //#region src/components/photoPostcard/core/engine.ts
3
+ var t = "cos-photo-postcard", n = 6, r = 280, i = 320, a = (e, t) => t <= 0 ? 0 : (e % t + t) % t, o = (e, t) => t <= 0 ? 0 : Math.max(0, Math.min(t - 1, Math.floor(e))), s = (e) => {
4
+ let t = Math.sin(e * 127.1 + 31.7) * 43758.5453;
5
+ return t - Math.floor(t);
6
+ }, c = (e, t) => {
7
+ if (t) for (let [n, r] of Object.entries(t)) r != null && (n.startsWith("--") ? e.style.setProperty(n, String(r)) : e.style[n] = typeof r == "number" ? `${r}px` : String(r));
8
+ }, l = (e, n, r) => {
9
+ let i = r && (n.title || n.description), a = n.title ? n.title : "Greetings from the road";
10
+ e.replaceChildren();
11
+ let o = document.createElement("div");
12
+ o.className = `${t}__face ${t}__front`;
13
+ let s = document.createElement("div");
14
+ s.className = `${t}__photo-frame${i ? ` ${t}__photo-frame-with-caption` : ""}`;
15
+ let c = document.createElement("div");
16
+ c.className = `${t}__photo-wrap`;
17
+ let l = document.createElement("img");
18
+ l.className = `${t}__photo`, l.src = n.src, l.alt = n.alt ?? n.title ?? "", l.draggable = !1, c.appendChild(l), s.appendChild(c);
19
+ let u = document.createElement("div");
20
+ if (u.className = `${t}__corner-stamp`, u.setAttribute("aria-hidden", "true"), o.append(s, u), i) {
21
+ let e = document.createElement("div");
22
+ if (e.className = `${t}__front-caption`, n.title) {
23
+ let r = document.createElement("p");
24
+ r.className = `${t}__front-caption-title`, r.textContent = n.title, e.appendChild(r);
25
+ }
26
+ if (n.description) {
27
+ let r = document.createElement("p");
28
+ r.className = `${t}__front-caption-desc`, r.textContent = n.description, e.appendChild(r);
29
+ }
30
+ o.appendChild(e);
31
+ }
32
+ let d = document.createElement("div");
33
+ d.className = `${t}__face ${t}__back`;
34
+ let f = document.createElement("div");
35
+ f.className = `${t}__divider`, f.setAttribute("aria-hidden", "true");
36
+ let p = document.createElement("div");
37
+ p.className = `${t}__lined-paper`;
38
+ let m = document.createElement("p");
39
+ m.className = `${t}__greeting`, m.textContent = a, p.appendChild(m);
40
+ let h = document.createElement("p");
41
+ n.description ? (h.className = `${t}__body-text`, h.textContent = n.description) : (h.className = `${t}__body-placeholder`, h.textContent = "Wish you were here…"), p.appendChild(h);
42
+ let g = document.createElement("div");
43
+ g.className = `${t}__back-footer`;
44
+ let _ = document.createElement("div");
45
+ _.className = `${t}__postmark`, _.setAttribute("aria-hidden", "true");
46
+ let v = document.createElement("span");
47
+ v.className = `${t}__postmark-text`, v.innerHTML = "TRAVEL<br>POST", _.appendChild(v);
48
+ let y = document.createElement("div");
49
+ y.className = `${t}__stamp-square`, y.setAttribute("aria-hidden", "true"), g.append(_, y), d.append(f, p, g), e.append(o, d);
50
+ };
51
+ function u(u, d = { photos: [] }) {
52
+ let f = {
53
+ width: 360,
54
+ height: 420,
55
+ cardWidth: 260,
56
+ cardHeight: 170,
57
+ pullThreshold: 80,
58
+ showCaption: !0,
59
+ initialIndex: 0,
60
+ initialFlipped: !1,
61
+ ariaLabel: "明信片",
62
+ ...d,
63
+ photos: Array.isArray(d.photos) ? d.photos : []
64
+ }, p = !1, m = o(f.initialIndex ?? 0, f.photos.length), h = !!f.initialFlipped, g = 0, _ = "idle", v = null, y = null, b = null, x = "", S = document.createElement("div"), C = document.createElement("div");
65
+ C.className = `${t}__stage`;
66
+ let w = document.createElement("div");
67
+ w.className = `${t}__empty`, w.textContent = "暂无明信片";
68
+ let T = document.createElement("div");
69
+ T.className = `${t}__stack`;
70
+ let E = document.createElement("div");
71
+ E.className = `${t}__card-slot`;
72
+ let D = document.createElement("div"), O = document.createElement("div");
73
+ O.className = `${t}__flip-inner`, D.appendChild(O), E.appendChild(D);
74
+ let k = document.createElement("div");
75
+ k.className = `${t}__hint`, k.textContent = "拖拽切换 · 点击查看背面", C.append(w, T, k), S.appendChild(C), u.appendChild(S);
76
+ let A = () => Array.isArray(f.photos) ? f.photos : [], j = () => A().length, M = (e, t) => e ? `${e.src}\0${e.title ?? ""}\0${e.description ?? ""}\0${e.alt ?? ""}\0${t}` : "", N = () => {
77
+ D.className = [
78
+ `${t}__card-active`,
79
+ h ? `${t}__flipped` : "",
80
+ _ === "exiting" ? `${t}__card-exiting` : ""
81
+ ].filter(Boolean).join(" "), D.style.transform = `translateX(${g}px)`, D.style.transition = _ === "snapping" || _ === "exiting" ? `transform ${_ === "exiting" ? r : i}ms cubic-bezier(0.22, 1, 0.36, 1), opacity ${r}ms ease` : "none", D.style.opacity = _ === "exiting" ? "0.55" : "1", D.setAttribute("aria-pressed", String(h));
82
+ let e = A()[m];
83
+ D.setAttribute("aria-label", e ? `${h ? "背面" : "正面"}:${e.alt ?? e.title ?? `明信片 ${m + 1}`}` : "");
84
+ }, P = (e, n, r) => {
85
+ let i = new Set([E]);
86
+ for (let e of [...T.children]) i.has(e) || e.remove();
87
+ let a = e <= 1 ? [] : [1, 2].slice(0, Math.min(2, e - 1)).map((e) => {
88
+ let t = m * 13.7 + e * 5.3;
89
+ return {
90
+ depth: e,
91
+ rot: (s(t) * 2 - 1) * 5.5,
92
+ dx: e * 5 + s(t + 1.1) * 4,
93
+ dy: e * 3 + s(t + 2.4) * 3
94
+ };
95
+ });
96
+ for (let { depth: e, rot: i, dx: o, dy: s } of a) {
97
+ let a = document.createElement("div");
98
+ a.className = `${t}__stack-card`, a.style.width = `${n}px`, a.style.height = `${r}px`, a.style.transform = `translate(calc(-50% + ${o}px), calc(-50% + ${s}px)) rotate(${i}deg)`, a.style.opacity = e === 1 ? "0.92" : "0.78", a.setAttribute("aria-hidden", "true"), T.insertBefore(a, E);
99
+ }
100
+ }, F = () => {
101
+ let n = A(), r = n.length, i = f.cardWidth ?? 260, a = f.cardHeight ?? 170, o = f.showCaption !== !1;
102
+ if (S.className = [t, f.className].filter(Boolean).join(" "), e(u, S, {
103
+ width: f.width ?? 360,
104
+ height: f.height ?? 420
105
+ }), c(S, f.style), S.setAttribute("role", "region"), S.setAttribute("aria-label", f.ariaLabel ?? "明信片"), S.tabIndex = 0, w.hidden = r > 0, T.hidden = r === 0, k.hidden = r <= 1, r === 0) {
106
+ O.replaceChildren(), x = "";
107
+ return;
108
+ }
109
+ T.style.width = `${i}px`, T.style.height = `${a}px`, (!E.isConnected || E.parentElement !== T) && T.appendChild(E), P(r, i, a), E.style.width = `${i}px`, E.style.height = `${a}px`, D.style.width = `${i}px`, D.style.height = `${a}px`, D.setAttribute("role", "button");
110
+ let s = n[m], d = M(s, o);
111
+ s && d !== x ? (l(O, s, o), x = d) : s || (O.replaceChildren(), x = ""), N();
112
+ }, I = (e) => {
113
+ let t = A(), n = o(e, t.length);
114
+ m = n, h = !1, f.onFlipChange?.(!1);
115
+ let r = t[n];
116
+ r && f.onIndexChange?.(n, r);
117
+ }, L = (e) => {
118
+ I(e), g = 0, _ = "idle", F();
119
+ }, R = (e) => {
120
+ let t = e * ((f.cardWidth ?? 260) * .55 + 48);
121
+ _ = "exiting", g = t, N(), y != null && window.clearTimeout(y), y = window.setTimeout(() => {
122
+ L(a(m + e, A().length));
123
+ }, r);
124
+ }, z = () => {
125
+ _ = "snapping", g = 0, N(), b != null && window.clearTimeout(b), b = window.setTimeout(() => {
126
+ _ = "idle", N();
127
+ }, i);
128
+ }, B = (e) => {
129
+ A().length <= 1 || R(e > 0 ? 1 : -1);
130
+ }, V = () => {
131
+ h = !h, f.onFlipChange?.(h), N();
132
+ }, H = (e) => {
133
+ _ === "exiting" || j() === 0 || (v = {
134
+ pointerId: e.pointerId,
135
+ startX: e.clientX,
136
+ moved: !1
137
+ }, _ = "dragging", D.setPointerCapture(e.pointerId));
138
+ }, U = (e) => {
139
+ if (!v || v.pointerId !== e.pointerId || _ === "exiting") return;
140
+ let t = e.clientX - v.startX;
141
+ Math.abs(t) > n && (v.moved = !0), g = j() <= 1 ? t * .22 : t, N();
142
+ }, W = (e) => {
143
+ if (!v || v.pointerId !== e.pointerId) return;
144
+ let t = v.startX, n = v.moved;
145
+ if (v = null, D.hasPointerCapture(e.pointerId) && D.releasePointerCapture(e.pointerId), _ === "exiting") return;
146
+ let r = e.clientX - t;
147
+ if (!n) {
148
+ _ = "idle", g = 0, V();
149
+ let e = A()[m];
150
+ e && f.onPhotoClick?.(m, e);
151
+ return;
152
+ }
153
+ if (Math.abs(r) >= (f.pullThreshold ?? 80) && j() > 1) {
154
+ R(r > 0 ? 1 : -1);
155
+ return;
156
+ }
157
+ z();
158
+ }, G = (e) => {
159
+ !v || v.pointerId !== e.pointerId || (v = null, D.hasPointerCapture(e.pointerId) && D.releasePointerCapture(e.pointerId), _ !== "exiting" && z());
160
+ }, K = (e) => {
161
+ e.key === "ArrowRight" ? (e.preventDefault(), B(1)) : e.key === "ArrowLeft" ? (e.preventDefault(), B(-1)) : (e.key === " " || e.key === "Enter") && (e.preventDefault(), V());
162
+ };
163
+ return D.addEventListener("pointerdown", H), D.addEventListener("pointermove", U), D.addEventListener("pointerup", W), D.addEventListener("pointercancel", G), S.addEventListener("keydown", K), F(), {
164
+ update(e) {
165
+ let t = Array.isArray(e.photos) ? e.photos : e.photos === void 0 ? f.photos : [];
166
+ f = {
167
+ ...f,
168
+ ...e,
169
+ photos: t
170
+ }, m = o(m, A().length), F();
171
+ },
172
+ destroy() {
173
+ p || (p = !0, y != null && window.clearTimeout(y), b != null && window.clearTimeout(b), D.removeEventListener("pointerdown", H), D.removeEventListener("pointermove", U), D.removeEventListener("pointerup", W), D.removeEventListener("pointercancel", G), S.removeEventListener("keydown", K), S.remove());
174
+ }
175
+ };
176
+ }
177
+ //#endregion
178
+ export { u as t };
package/dist/core.cjs ADDED
@@ -0,0 +1 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./engine-D2OC52jQ.cjs"),t=require("./core-CszjZZo9.cjs");exports.DEFAULT_FOG_LEVEL=e.nt,exports.DEFAULT_HAIL_LEVEL=e.Y,exports.DEFAULT_RAIN_LEVEL=e.D,exports.DEFAULT_SMOG_LEVEL=e.y,exports.DEFAULT_SNOW_LEVEL=e.O,exports.DEFAULT_WIND_LEVEL=e.r,exports.FOG_LEVEL_LABELS=e.rt,exports.HAIL_LEVEL_LABELS=e.X,exports.IDLE_LIVE_WEATHER=e.u,exports.MAX_PRECIP_LEVEL=e.k,exports.MIN_PRECIP_LEVEL=e.A,exports.RAIN_LEVEL_LABELS=e.j,exports.SMOG_LEVEL_LABELS=e.b,exports.SNOW_LEVEL_LABELS=e.M,exports.buildWindMotion=e.i,exports.clampFogLevel=e.it,exports.clampHailLevel=e.Z,exports.clampPrecipLevel=e.N,exports.clampSmogLevel=e.x,exports.createAudioVisualizer=e.Bn,exports.createAurora=e.Vn,exports.createAuroraVeil=e.Lt,exports.createBarcodeScan=e.Wn,exports.createBlurText=e.Un,exports.createBubbleField=e.Ht,exports.createBurnAway=e.Hn,exports.createCanvasClock=e.zn,exports.createCharge=e.Rn,exports.createCircularText=e.Ln,exports.createClickSpark=e.In,exports.createConfetti=e.Fn,exports.createCountUp=e.jn,exports.createCountdown=e.Mn,exports.createCursorTrail=e.On,exports.createCurvedLoop=e.Pn,exports.createCyberGrid=e.Nn,exports.createDandelionField=e.Bt,exports.createDiceRoll=e.Dn,exports.createDnaHelix=e.An,exports.createDoublePendulum=e.En,exports.createElectricArc=e.kn,exports.createFireworks=e.Tn,exports.createFlipCard=e.wn,exports.createFlipCounter=e.Cn,exports.createFuzzyText=e.Sn,exports.createGameOfLife=e.bn,exports.createGlitchText=e.yn,exports.createGradientFlow=e.xn,exports.createGravityBalls=e.vn,exports.createHolographicCard=e._n,exports.createInkBloom=e.Rt,exports.createLavaBubble=e.zt,exports.createLiquidGlass=e.mn,exports.createLiquidProgress=e.gn,exports.createLorenzAttractor=e.hn,exports.createMagneticButton=e.pn,exports.createMatrixRain=e.fn,exports.createMazeGenerator=e.un,exports.createMetaballPool=e.dn,exports.createMeteorRain=e.ln,exports.createNeonText=e.sn,exports.createNetworkGraph=e.cn,exports.createNewtonCradle=e.on,exports.createNineGrid=e.an,exports.createOrbitalChart=e.in,exports.createParticleNetwork=e.rn,exports.createPhotoAlbum=e.nn,exports.createPhotoCarousel=e.tn,exports.createPhotoClothesline=e.en,exports.createPhotoFilmstrip=e.$t,exports.createPhotoFridge=e.Qt,exports.createPhotoLantern=e.Zt,exports.createPhotoLightbox=e.Xt,exports.createPhotoPolaroid=e.Yt,exports.createPhotoPostcard=t.t,exports.createPhotoPrism=e.Jt,exports.createPhotoScroll=e.qt,exports.createPhotoTunnel=e.Kt,exports.createPhotoViewMaster=e.Gt,exports.createPlasmaBall=e.Wt,exports.createProgressChest=e.Nt,exports.createRadarScan=e.Mt,exports.createRedPacketRain=e.jt,exports.createReturnCity=e.At,exports.createRippleWater=e.wt,exports.createRopeChain=e.kt,exports.createRotatingText=e.Ot,exports.createSandFall=e.bt,exports.createScrambleText=e.Ct,exports.createScratchCard=e.St,exports.createShinyText=e.Et,exports.createSlotMachine=e.xt,exports.createSmokeFog=e.Ut,exports.createSnowfall=e.Ft,exports.createSoapBubbles=e.Vt,exports.createSolarSystem=e.It,exports.createSpeedometer=e.Dt,exports.createSplitReveal=e.yt,exports.createSplitText=e.vt,exports.createSpotlight=e.gt,exports.createSpringMass=e._t,exports.createStarfield=e.Pt,exports.createTextMorph=e.mt,exports.createTimelinePulse=e.Tt,exports.createTrueFocus=e.pt,exports.createTurntable=e.ht,exports.createTypewriter=e.ft,exports.createWaveButton=e.dt,exports.createWaveText=e.t,exports.createWeatherBackground=e.n,exports.fetchLiveWeather=e.d,exports.fetchSunTimes=e.f,exports.fogBankAlphaScale=e.at,exports.fogLevelFromVisibility=e.ot,exports.fogLevelFromWmo=e.st,exports.formatFogLevel=e.ct,exports.formatHailLevel=e.Q,exports.formatLocalHm=e.p,exports.formatPrecipLevel=e.P,exports.formatSmogLevel=e.S,exports.getDayCycleTimesFromLive=e.m,exports.hailLevelFromWmo=e.$,exports.hailSpec=e.et,exports.intensifyFogConfig=e.lt,exports.intensifyRainConfig=e.F,exports.intensifySmogConfig=e.C,exports.intensifySnowCount=e.I,exports.isRainWeather=e.L,exports.isSnowWeather=e.R,exports.isValidCoords=e.h,exports.kmhToWindLevel=e.a,exports.mapWmoCodeToWeatherType=e.g,exports.normalizeWeatherType=e.z,exports.precipBand=e.B,exports.precipLabel=e.V,exports.rainLevelFromWeather=e.H,exports.rainLevelFromWmo=e.U,exports.resolveSceneWeather=e.W,exports.sampleWindField=e.o,exports.smogBankAlphaScale=e.w,exports.smogLevelFromVisibility=e.T,exports.snowLevelFromWeather=e.G,exports.snowLevelFromWmo=e.K,exports.subscribeLiveWeather=e._,exports.subscribeSunTimes=e.v,exports.supportsFogLevel=e.ut,exports.supportsHailLevel=e.tt,exports.supportsRainLevel=e.q,exports.supportsSmogLevel=e.E,exports.supportsSnowLevel=e.J,exports.visualWindLevel=e.s,exports.windLevelToKmh=e.c,exports.windStreakSpec=e.l;
package/dist/core.d.ts ADDED
@@ -0,0 +1 @@
1
+ export * from './src/core';
package/dist/core.js ADDED
@@ -0,0 +1,3 @@
1
+ import { $ as e, $t as t, A as n, An as r, At as i, B as a, Bn as o, Bt as s, C as c, Cn as l, Ct as u, D as d, Dn as f, Dt as p, E as m, En as h, Et as g, F as _, Fn as v, Ft as y, G as b, Gt as x, H as S, Hn as C, Ht as w, I as T, In as E, It as D, J as O, Jt as k, K as A, Kt as j, L as M, Ln as N, Lt as P, M as F, Mn as I, Mt as L, N as R, Nn as z, Nt as B, O as V, On as H, Ot as U, P as W, Pn as G, Pt as K, Q as q, Qt as J, R as Y, Rn as X, Rt as Z, S as Q, Sn as $, St as ee, T as te, Tn as ne, Tt as re, U as ie, Un as ae, Ut as oe, V as se, Vn as ce, Vt as le, W as ue, Wn as de, Wt as fe, X as pe, Xt as me, Y as he, Yt as ge, Z as _e, Zt as ve, _ as ye, _n as be, _t as xe, a as Se, an as Ce, at as we, b as Te, bn as Ee, bt as De, c as Oe, cn as ke, ct as Ae, d as je, dn as Me, dt as Ne, en as Pe, et as Fe, f as Ie, fn as Le, ft as Re, g as ze, gn as Be, gt as Ve, h as He, hn as Ue, ht as We, i as Ge, in as Ke, it as qe, j as Je, jn as Ye, jt as Xe, k as Ze, kn as Qe, kt as $e, l as et, ln as tt, lt as nt, m as rt, mn as it, mt as at, n as ot, nn as st, nt as ct, o as lt, on as ut, ot as dt, p as ft, pn as pt, pt as mt, q as ht, qt as gt, r as _t, rn as vt, rt as yt, s as bt, sn as xt, st as St, t as Ct, tn as wt, tt as Tt, u as Et, un as Dt, ut as Ot, v as kt, vn as At, vt as jt, w as Mt, wn as Nt, wt as Pt, x as Ft, xn as It, xt as Lt, y as Rt, yn as zt, yt as Bt, z as Vt, zn as Ht, zt as Ut } from "./engine-Dh44m7ox.js";
2
+ import { t as Wt } from "./core-On5bp2VI.js";
3
+ export { ct as DEFAULT_FOG_LEVEL, he as DEFAULT_HAIL_LEVEL, d as DEFAULT_RAIN_LEVEL, Rt as DEFAULT_SMOG_LEVEL, V as DEFAULT_SNOW_LEVEL, _t as DEFAULT_WIND_LEVEL, yt as FOG_LEVEL_LABELS, pe as HAIL_LEVEL_LABELS, Et as IDLE_LIVE_WEATHER, Ze as MAX_PRECIP_LEVEL, n as MIN_PRECIP_LEVEL, Je as RAIN_LEVEL_LABELS, Te as SMOG_LEVEL_LABELS, F as SNOW_LEVEL_LABELS, Ge as buildWindMotion, qe as clampFogLevel, _e as clampHailLevel, R as clampPrecipLevel, Ft as clampSmogLevel, o as createAudioVisualizer, ce as createAurora, P as createAuroraVeil, de as createBarcodeScan, ae as createBlurText, w as createBubbleField, C as createBurnAway, Ht as createCanvasClock, X as createCharge, N as createCircularText, E as createClickSpark, v as createConfetti, Ye as createCountUp, I as createCountdown, H as createCursorTrail, G as createCurvedLoop, z as createCyberGrid, s as createDandelionField, f as createDiceRoll, r as createDnaHelix, h as createDoublePendulum, Qe as createElectricArc, ne as createFireworks, Nt as createFlipCard, l as createFlipCounter, $ as createFuzzyText, Ee as createGameOfLife, zt as createGlitchText, It as createGradientFlow, At as createGravityBalls, be as createHolographicCard, Z as createInkBloom, Ut as createLavaBubble, it as createLiquidGlass, Be as createLiquidProgress, Ue as createLorenzAttractor, pt as createMagneticButton, Le as createMatrixRain, Dt as createMazeGenerator, Me as createMetaballPool, tt as createMeteorRain, xt as createNeonText, ke as createNetworkGraph, ut as createNewtonCradle, Ce as createNineGrid, Ke as createOrbitalChart, vt as createParticleNetwork, st as createPhotoAlbum, wt as createPhotoCarousel, Pe as createPhotoClothesline, t as createPhotoFilmstrip, J as createPhotoFridge, ve as createPhotoLantern, me as createPhotoLightbox, ge as createPhotoPolaroid, Wt as createPhotoPostcard, k as createPhotoPrism, gt as createPhotoScroll, j as createPhotoTunnel, x as createPhotoViewMaster, fe as createPlasmaBall, B as createProgressChest, L as createRadarScan, Xe as createRedPacketRain, i as createReturnCity, Pt as createRippleWater, $e as createRopeChain, U as createRotatingText, De as createSandFall, u as createScrambleText, ee as createScratchCard, g as createShinyText, Lt as createSlotMachine, oe as createSmokeFog, y as createSnowfall, le as createSoapBubbles, D as createSolarSystem, p as createSpeedometer, Bt as createSplitReveal, jt as createSplitText, Ve as createSpotlight, xe as createSpringMass, K as createStarfield, at as createTextMorph, re as createTimelinePulse, mt as createTrueFocus, We as createTurntable, Re as createTypewriter, Ne as createWaveButton, Ct as createWaveText, ot as createWeatherBackground, je as fetchLiveWeather, Ie as fetchSunTimes, we as fogBankAlphaScale, dt as fogLevelFromVisibility, St as fogLevelFromWmo, Ae as formatFogLevel, q as formatHailLevel, ft as formatLocalHm, W as formatPrecipLevel, Q as formatSmogLevel, rt as getDayCycleTimesFromLive, e as hailLevelFromWmo, Fe as hailSpec, nt as intensifyFogConfig, _ as intensifyRainConfig, c as intensifySmogConfig, T as intensifySnowCount, M as isRainWeather, Y as isSnowWeather, He as isValidCoords, Se as kmhToWindLevel, ze as mapWmoCodeToWeatherType, Vt as normalizeWeatherType, a as precipBand, se as precipLabel, S as rainLevelFromWeather, ie as rainLevelFromWmo, ue as resolveSceneWeather, lt as sampleWindField, Mt as smogBankAlphaScale, te as smogLevelFromVisibility, b as snowLevelFromWeather, A as snowLevelFromWmo, ye as subscribeLiveWeather, kt as subscribeSunTimes, Ot as supportsFogLevel, Tt as supportsHailLevel, ht as supportsRainLevel, m as supportsSmogLevel, O as supportsSnowLevel, bt as visualWindLevel, Oe as windLevelToKmh, et as windStreakSpec };