@cos-design/weather-background 3.5.5 → 4.0.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 (193) hide show
  1. package/dist/core/index.d.ts +1 -0
  2. package/dist/core/index.js +1527 -0
  3. package/dist/core/packages/shared/src/canvas-box.d.ts +18 -0
  4. package/dist/core/packages/shared/src/host-layout.d.ts +22 -0
  5. package/dist/{packages → core/packages}/shared/src/index.d.ts +4 -3
  6. package/dist/{packages → core/packages}/shared/src/math.d.ts +1 -0
  7. package/dist/{packages/shared/src/use-element-size.d.ts → core/packages/shared/src/react/index.d.ts} +4 -19
  8. package/dist/core/packages/weatherBackground/src/core.d.ts +1 -0
  9. package/dist/core/packages/weatherBackground/src/element.d.ts +1 -0
  10. package/dist/{packages → core/packages}/weatherBackground/src/index.d.ts +8 -8
  11. package/dist/core/packages/weatherBackground/src/react.d.ts +15 -0
  12. package/dist/core/packages/weatherBackground/src/vue.d.ts +2 -0
  13. package/dist/core/src/components/weatherBackground/core/engine.d.ts +2 -0
  14. package/dist/core/src/components/weatherBackground/core/index.d.ts +14 -0
  15. package/dist/core/src/components/weatherBackground/core/types.d.ts +7 -0
  16. package/dist/core/src/components/weatherBackground/element/index.d.ts +13 -0
  17. package/dist/core/src/components/weatherBackground/index.d.ts +5 -0
  18. package/dist/{src/components/weatherBackground/live-weather.d.ts → core/src/components/weatherBackground/live-weather-core.d.ts} +8 -10
  19. package/dist/core/src/components/weatherBackground/live-weather.d.ts +15 -0
  20. package/dist/core/src/components/weatherBackground/react/index.d.ts +3 -0
  21. package/dist/{src → core/src}/vite-env.d.ts +6 -0
  22. package/dist/element/element.css +1 -0
  23. package/dist/element/index.d.ts +1 -0
  24. package/dist/element/index.js +1541 -0
  25. package/dist/element/packages/shared/src/canvas-box.d.ts +18 -0
  26. package/dist/element/packages/shared/src/host-layout.d.ts +22 -0
  27. package/dist/element/packages/shared/src/index.d.ts +11 -0
  28. package/dist/element/packages/shared/src/math.d.ts +2 -0
  29. package/dist/element/packages/shared/src/photo.d.ts +15 -0
  30. package/dist/element/packages/shared/src/pointer.d.ts +14 -0
  31. package/dist/element/packages/shared/src/react/index.d.ts +30 -0
  32. package/dist/element/packages/shared/src/reduced-motion.d.ts +4 -0
  33. package/dist/element/packages/shared/src/size.d.ts +8 -0
  34. package/dist/element/packages/shared/src/visibility.d.ts +2 -0
  35. package/dist/element/packages/weatherBackground/src/core.d.ts +1 -0
  36. package/dist/element/packages/weatherBackground/src/element.d.ts +1 -0
  37. package/dist/element/packages/weatherBackground/src/index.d.ts +15 -0
  38. package/dist/element/packages/weatherBackground/src/react.d.ts +15 -0
  39. package/dist/element/packages/weatherBackground/src/vue.d.ts +2 -0
  40. package/dist/element/src/components/weatherBackground/configs.d.ts +9 -0
  41. package/dist/element/src/components/weatherBackground/core/engine.d.ts +2 -0
  42. package/dist/element/src/components/weatherBackground/core/index.d.ts +14 -0
  43. package/dist/element/src/components/weatherBackground/core/types.d.ts +7 -0
  44. package/dist/element/src/components/weatherBackground/day-cycle.d.ts +53 -0
  45. package/dist/element/src/components/weatherBackground/element/index.d.ts +13 -0
  46. package/dist/element/src/components/weatherBackground/fog.d.ts +25 -0
  47. package/dist/element/src/components/weatherBackground/hail-level.d.ts +24 -0
  48. package/dist/element/src/components/weatherBackground/index.d.ts +5 -0
  49. package/dist/element/src/components/weatherBackground/lightning.d.ts +1 -0
  50. package/dist/element/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  51. package/dist/element/src/components/weatherBackground/live-weather.d.ts +15 -0
  52. package/dist/element/src/components/weatherBackground/precipitation.d.ts +51 -0
  53. package/dist/element/src/components/weatherBackground/react/index.d.ts +3 -0
  54. package/dist/element/src/components/weatherBackground/scene/create-weather-scene.d.ts +2 -0
  55. package/dist/element/src/components/weatherBackground/scene/draw-atmosphere.d.ts +4 -0
  56. package/dist/element/src/components/weatherBackground/scene/draw-effects.d.ts +3 -0
  57. package/dist/element/src/components/weatherBackground/scene/draw-precipitation.d.ts +4 -0
  58. package/dist/element/src/components/weatherBackground/scene/draw-sky.d.ts +4 -0
  59. package/dist/element/src/components/weatherBackground/scene/init-state.d.ts +44 -0
  60. package/dist/element/src/components/weatherBackground/scene/runtime.d.ts +38 -0
  61. package/dist/element/src/components/weatherBackground/smog.d.ts +17 -0
  62. package/dist/element/src/components/weatherBackground/sprites/celestial.d.ts +11 -0
  63. package/dist/element/src/components/weatherBackground/sprites/cloud.d.ts +20 -0
  64. package/dist/element/src/components/weatherBackground/sprites/hail.d.ts +11 -0
  65. package/dist/element/src/components/weatherBackground/sprites/snow.d.ts +8 -0
  66. package/dist/element/src/components/weatherBackground/types.d.ts +230 -0
  67. package/dist/element/src/components/weatherBackground/wind.d.ts +68 -0
  68. package/dist/element/src/vite-env.d.ts +45 -0
  69. package/dist/react/index.cjs +1 -0
  70. package/dist/react/index.d.ts +89 -0
  71. package/dist/{index.js → react/index.js} +444 -424
  72. package/dist/react/packages/shared/src/canvas-box.d.ts +18 -0
  73. package/dist/react/packages/shared/src/host-layout.d.ts +22 -0
  74. package/dist/react/packages/shared/src/index.d.ts +11 -0
  75. package/dist/react/packages/shared/src/math.d.ts +2 -0
  76. package/dist/react/packages/shared/src/photo.d.ts +15 -0
  77. package/dist/react/packages/shared/src/pointer.d.ts +14 -0
  78. package/dist/react/packages/shared/src/react/index.d.ts +30 -0
  79. package/dist/react/packages/shared/src/reduced-motion.d.ts +4 -0
  80. package/dist/react/packages/shared/src/size.d.ts +8 -0
  81. package/dist/react/packages/shared/src/visibility.d.ts +2 -0
  82. package/dist/react/packages/weatherBackground/src/core.d.ts +1 -0
  83. package/dist/react/packages/weatherBackground/src/element.d.ts +1 -0
  84. package/dist/react/packages/weatherBackground/src/index.d.ts +15 -0
  85. package/dist/react/packages/weatherBackground/src/react.d.ts +15 -0
  86. package/dist/react/packages/weatherBackground/src/vue.d.ts +2 -0
  87. package/dist/react/react.css +1 -0
  88. package/dist/react/src/components/weatherBackground/configs.d.ts +9 -0
  89. package/dist/react/src/components/weatherBackground/core/engine.d.ts +2 -0
  90. package/dist/react/src/components/weatherBackground/core/index.d.ts +14 -0
  91. package/dist/react/src/components/weatherBackground/core/types.d.ts +7 -0
  92. package/dist/react/src/components/weatherBackground/day-cycle.d.ts +53 -0
  93. package/dist/react/src/components/weatherBackground/element/index.d.ts +13 -0
  94. package/dist/react/src/components/weatherBackground/fog.d.ts +25 -0
  95. package/dist/react/src/components/weatherBackground/hail-level.d.ts +24 -0
  96. package/dist/react/src/components/weatherBackground/index.d.ts +5 -0
  97. package/dist/react/src/components/weatherBackground/lightning.d.ts +1 -0
  98. package/dist/react/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  99. package/dist/react/src/components/weatherBackground/live-weather.d.ts +15 -0
  100. package/dist/react/src/components/weatherBackground/precipitation.d.ts +51 -0
  101. package/dist/react/src/components/weatherBackground/react/index.d.ts +3 -0
  102. package/dist/react/src/components/weatherBackground/scene/create-weather-scene.d.ts +2 -0
  103. package/dist/react/src/components/weatherBackground/scene/draw-atmosphere.d.ts +4 -0
  104. package/dist/react/src/components/weatherBackground/scene/draw-effects.d.ts +3 -0
  105. package/dist/react/src/components/weatherBackground/scene/draw-precipitation.d.ts +4 -0
  106. package/dist/react/src/components/weatherBackground/scene/draw-sky.d.ts +4 -0
  107. package/dist/react/src/components/weatherBackground/scene/init-state.d.ts +44 -0
  108. package/dist/react/src/components/weatherBackground/scene/runtime.d.ts +38 -0
  109. package/dist/react/src/components/weatherBackground/smog.d.ts +17 -0
  110. package/dist/react/src/components/weatherBackground/sprites/celestial.d.ts +11 -0
  111. package/dist/react/src/components/weatherBackground/sprites/cloud.d.ts +20 -0
  112. package/dist/react/src/components/weatherBackground/sprites/hail.d.ts +11 -0
  113. package/dist/react/src/components/weatherBackground/sprites/snow.d.ts +8 -0
  114. package/dist/react/src/components/weatherBackground/types.d.ts +230 -0
  115. package/dist/react/src/components/weatherBackground/wind.d.ts +68 -0
  116. package/dist/react/src/vite-env.d.ts +45 -0
  117. package/dist/vue/index.d.ts +2 -0
  118. package/dist/vue/index.js +1517 -0
  119. package/dist/vue/packages/shared/src/canvas-box.d.ts +18 -0
  120. package/dist/vue/packages/shared/src/host-layout.d.ts +22 -0
  121. package/dist/vue/packages/shared/src/index.d.ts +11 -0
  122. package/dist/vue/packages/shared/src/math.d.ts +2 -0
  123. package/dist/vue/packages/shared/src/photo.d.ts +15 -0
  124. package/dist/vue/packages/shared/src/pointer.d.ts +14 -0
  125. package/dist/vue/packages/shared/src/react/index.d.ts +30 -0
  126. package/dist/vue/packages/shared/src/reduced-motion.d.ts +4 -0
  127. package/dist/vue/packages/shared/src/size.d.ts +8 -0
  128. package/dist/vue/packages/shared/src/visibility.d.ts +2 -0
  129. package/dist/vue/packages/weatherBackground/src/core.d.ts +1 -0
  130. package/dist/vue/packages/weatherBackground/src/element.d.ts +1 -0
  131. package/dist/vue/packages/weatherBackground/src/index.d.ts +15 -0
  132. package/dist/vue/packages/weatherBackground/src/react.d.ts +15 -0
  133. package/dist/vue/packages/weatherBackground/src/vue.d.ts +2 -0
  134. package/dist/vue/src/components/weatherBackground/configs.d.ts +9 -0
  135. package/dist/vue/src/components/weatherBackground/core/engine.d.ts +2 -0
  136. package/dist/vue/src/components/weatherBackground/core/index.d.ts +14 -0
  137. package/dist/vue/src/components/weatherBackground/core/types.d.ts +7 -0
  138. package/dist/vue/src/components/weatherBackground/day-cycle.d.ts +53 -0
  139. package/dist/vue/src/components/weatherBackground/element/index.d.ts +13 -0
  140. package/dist/vue/src/components/weatherBackground/fog.d.ts +25 -0
  141. package/dist/vue/src/components/weatherBackground/hail-level.d.ts +24 -0
  142. package/dist/vue/src/components/weatherBackground/index.d.ts +5 -0
  143. package/dist/vue/src/components/weatherBackground/lightning.d.ts +1 -0
  144. package/dist/vue/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  145. package/dist/vue/src/components/weatherBackground/live-weather.d.ts +15 -0
  146. package/dist/vue/src/components/weatherBackground/precipitation.d.ts +51 -0
  147. package/dist/vue/src/components/weatherBackground/react/index.d.ts +3 -0
  148. package/dist/vue/src/components/weatherBackground/scene/create-weather-scene.d.ts +2 -0
  149. package/dist/vue/src/components/weatherBackground/scene/draw-atmosphere.d.ts +4 -0
  150. package/dist/vue/src/components/weatherBackground/scene/draw-effects.d.ts +3 -0
  151. package/dist/vue/src/components/weatherBackground/scene/draw-precipitation.d.ts +4 -0
  152. package/dist/vue/src/components/weatherBackground/scene/draw-sky.d.ts +4 -0
  153. package/dist/vue/src/components/weatherBackground/scene/init-state.d.ts +44 -0
  154. package/dist/vue/src/components/weatherBackground/scene/runtime.d.ts +38 -0
  155. package/dist/vue/src/components/weatherBackground/smog.d.ts +17 -0
  156. package/dist/vue/src/components/weatherBackground/sprites/celestial.d.ts +11 -0
  157. package/dist/vue/src/components/weatherBackground/sprites/cloud.d.ts +20 -0
  158. package/dist/vue/src/components/weatherBackground/sprites/hail.d.ts +11 -0
  159. package/dist/vue/src/components/weatherBackground/sprites/snow.d.ts +8 -0
  160. package/dist/vue/src/components/weatherBackground/types.d.ts +230 -0
  161. package/dist/vue/src/components/weatherBackground/wind.d.ts +68 -0
  162. package/dist/vue/src/vite-env.d.ts +45 -0
  163. package/dist/vue/vue.css +1 -0
  164. package/package.json +43 -11
  165. package/dist/index.cjs +0 -1
  166. package/dist/index.css +0 -1
  167. package/dist/index.d.ts +0 -5
  168. package/dist/src/components/weatherBackground/index.d.ts +0 -5
  169. /package/dist/{packages → core/packages}/shared/src/photo.d.ts +0 -0
  170. /package/dist/{packages → core/packages}/shared/src/pointer.d.ts +0 -0
  171. /package/dist/{packages → core/packages}/shared/src/reduced-motion.d.ts +0 -0
  172. /package/dist/{packages → core/packages}/shared/src/size.d.ts +0 -0
  173. /package/dist/{packages → core/packages}/shared/src/visibility.d.ts +0 -0
  174. /package/dist/{src → core/src}/components/weatherBackground/configs.d.ts +0 -0
  175. /package/dist/{src → core/src}/components/weatherBackground/day-cycle.d.ts +0 -0
  176. /package/dist/{src → core/src}/components/weatherBackground/fog.d.ts +0 -0
  177. /package/dist/{src → core/src}/components/weatherBackground/hail-level.d.ts +0 -0
  178. /package/dist/{src → core/src}/components/weatherBackground/lightning.d.ts +0 -0
  179. /package/dist/{src → core/src}/components/weatherBackground/precipitation.d.ts +0 -0
  180. /package/dist/{src → core/src}/components/weatherBackground/scene/create-weather-scene.d.ts +0 -0
  181. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-atmosphere.d.ts +0 -0
  182. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-effects.d.ts +0 -0
  183. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-precipitation.d.ts +0 -0
  184. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-sky.d.ts +0 -0
  185. /package/dist/{src → core/src}/components/weatherBackground/scene/init-state.d.ts +0 -0
  186. /package/dist/{src → core/src}/components/weatherBackground/scene/runtime.d.ts +0 -0
  187. /package/dist/{src → core/src}/components/weatherBackground/smog.d.ts +0 -0
  188. /package/dist/{src → core/src}/components/weatherBackground/sprites/celestial.d.ts +0 -0
  189. /package/dist/{src → core/src}/components/weatherBackground/sprites/cloud.d.ts +0 -0
  190. /package/dist/{src → core/src}/components/weatherBackground/sprites/hail.d.ts +0 -0
  191. /package/dist/{src → core/src}/components/weatherBackground/sprites/snow.d.ts +0 -0
  192. /package/dist/{src → core/src}/components/weatherBackground/types.d.ts +0 -0
  193. /package/dist/{src → core/src}/components/weatherBackground/wind.d.ts +0 -0
@@ -0,0 +1,38 @@
1
+ import { CelestialSprite, FogSprite, SceneState, WeatherConfig, WeatherType } from '../types';
2
+ import { DayCycleState, DayCycleTimes } from '../day-cycle';
3
+ import { HailIntensitySpec } from '../hail-level';
4
+ import { WindFieldSample, WindMotion } from '../wind';
5
+ export interface WeatherSceneRuntime {
6
+ ctx: CanvasRenderingContext2D;
7
+ width: number;
8
+ height: number;
9
+ activeWeather: WeatherType;
10
+ activeNight: boolean;
11
+ sky: [string, string];
12
+ cloudRgb: [number, number, number];
13
+ cfg: WeatherConfig;
14
+ sunX: number;
15
+ sunY: number;
16
+ sunR: number;
17
+ /** 缓存的天空线性渐变 */
18
+ skyGradient: CanvasGradient;
19
+ /** 当前绘制的日/月贴图 */
20
+ celestial: CelestialSprite | null;
21
+ /** 预烘焙太阳(日弧模式下与月亮并存) */
22
+ sunSprite: CelestialSprite | null;
23
+ /** 预烘焙月亮 */
24
+ moonSprite: CelestialSprite | null;
25
+ /** 预渲染的雾团贴图,无雾时为 null */
26
+ fogSprite: FogSprite | null;
27
+ /** 当地日出日落 */
28
+ dayCycleTimes: DayCycleTimes | null;
29
+ dayCycle: DayCycleState | null;
30
+ sceneTimeMs: number;
31
+ liveClock: boolean;
32
+ windMotion: WindMotion;
33
+ /** 本帧全局风场(阵风 + 风向),绘制前更新 */
34
+ windField: WindFieldSample;
35
+ /** 冰雹强度规格;非冰雹为 null */
36
+ hailSpec: HailIntensitySpec | null;
37
+ state: SceneState;
38
+ }
@@ -0,0 +1,17 @@
1
+ import { WeatherConfig, WeatherType } from './types';
2
+ /** 霾强度:1 轻霾 · 2 中霾 · 3 重霾 */
3
+ export type SmogLevel = 1 | 2 | 3;
4
+ export declare const DEFAULT_SMOG_LEVEL: SmogLevel;
5
+ export declare const SMOG_LEVEL_LABELS: readonly ["", "轻霾", "中霾", "重霾"];
6
+ export declare const clampSmogLevel: (level: number) => SmogLevel;
7
+ export declare const formatSmogLevel: (level: number) => string;
8
+ export declare const supportsSmogLevel: (weather: WeatherType) => weather is "smog";
9
+ /** 按强度档调节霾层、雾团与天空通透度 */
10
+ export declare const intensifySmogConfig: (cfg: WeatherConfig, level: number) => WeatherConfig;
11
+ /** 霾雾团透明度倍率 */
12
+ export declare const smogBankAlphaScale: (level: number) => number;
13
+ /**
14
+ * 能见度(米)→ 霾强度。
15
+ * ≥5km 轻霾 · 1~5km 中霾 · <1km 重霾
16
+ */
17
+ export declare const smogLevelFromVisibility: (visibilityMeters: number | null | undefined) => SmogLevel | null;
@@ -0,0 +1,11 @@
1
+ import { CelestialSprite, MoonCrater, WeatherConfig } from '../types';
2
+ /**
3
+ * 预渲染太阳贴图。原本每帧要创建 6+ 个径向渐变(散射 / 光冕 / 霾 / bloom / 日轮),
4
+ * 这里一次性烘焙到离屏 canvas,主循环只需按 breath 缩放绘制。
5
+ */
6
+ export declare function makeSunSprite(cfg: WeatherConfig, sunR: number): CelestialSprite | null;
7
+ /**
8
+ * 预渲染月亮贴图(含月光散射、月轮、月海、环形山、受光高光与软边 bloom)。
9
+ * sun==='none' 时不渲染月亮(与原逻辑一致)。
10
+ */
11
+ export declare function makeMoonSprite(cfg: WeatherConfig, sunR: number, moonCraters: MoonCrater[]): CelestialSprite | null;
@@ -0,0 +1,20 @@
1
+ import { Cloud, FogSprite } from '../types';
2
+ type Puff = {
3
+ dx: number;
4
+ dy: number;
5
+ r: number;
6
+ };
7
+ /**
8
+ * 预渲染单朵云。原本每帧要为每个 puff 创建径向渐变(阴天/雷暴可达 60 个/帧),
9
+ * 云的形状与颜色整场不变、仅横向平移,这里把 puffs 烘焙成一张贴图。
10
+ */
11
+ export declare function makeCloudSprite(scale: number, puffs: Puff[], rgb: [number, number, number], alpha: number): {
12
+ sprite: HTMLCanvasElement;
13
+ ox: number;
14
+ oy: number;
15
+ };
16
+ /** 组装带贴图的云对象(供 init-state 使用) */
17
+ export declare function makeCloud(width: number, height: number, cloudSpread: number, rgb: [number, number, number], alpha: number): Cloud;
18
+ /** 柔边圆雾贴图(alpha=1),绘制时按 bank 缩放并用 globalAlpha 叠加透明度 */
19
+ export declare function makeFogSprite(rgb: string, baseR?: number): FogSprite;
20
+ export {};
@@ -0,0 +1,11 @@
1
+ import { Hailstone } from '../types';
2
+ /** 预生成共享冰雹贴图池;reset 只换贴图引用,不再分配新 canvas */
3
+ export declare const createHailSpritePool: (count?: number) => HTMLCanvasElement[];
4
+ export declare const resetHailstone: (h: Hailstone, width: number, height: number, pool: HTMLCanvasElement[], spawnAbove?: boolean, sizeRange?: {
5
+ min: number;
6
+ max: number;
7
+ }, speedMul?: number) => void;
8
+ export declare const makeHailstone: (width: number, height: number, pool: HTMLCanvasElement[], sizeRange?: {
9
+ min: number;
10
+ max: number;
11
+ }, speedMul?: number) => Hailstone;
@@ -0,0 +1,8 @@
1
+ import { Flake } from '../types';
2
+ export interface FlakeSpritePool {
3
+ dots: HTMLCanvasElement[];
4
+ crystals: HTMLCanvasElement[];
5
+ }
6
+ /** 预生成少量雪花贴图供粒子复用(大雪 300 片不再各自一张 canvas) */
7
+ export declare const createFlakeSpritePool: () => FlakeSpritePool;
8
+ export declare const makeFlake: (width: number, height: number, pool: FlakeSpritePool, y?: number) => Flake;
@@ -0,0 +1,230 @@
1
+ import { DayCycleTimes } from './day-cycle';
2
+ import { WindMotion } from './wind';
3
+ export type WeatherType = 'sunny' | 'partlyCloudy' | 'overcast'
4
+ /** 雨天(雨量由 rainLevel 控制) */
5
+ | 'rain'
6
+ /** @deprecated 请使用 weather="rain" + rainLevel={2} */
7
+ | 'lightRain'
8
+ /** @deprecated 请使用 weather="rain" + rainLevel={5} */
9
+ | 'moderateRain'
10
+ /** @deprecated 请使用 weather="rain" + rainLevel={9} */
11
+ | 'heavyRain' | 'thunderstorm' | 'fog'
12
+ /** 雪天(雪量由 snowLevel 控制) */
13
+ | 'snow'
14
+ /** @deprecated 请使用 weather="snow" + snowLevel={2} */
15
+ | 'lightSnow'
16
+ /** @deprecated 请使用 weather="snow" + snowLevel={5} */
17
+ | 'moderateSnow'
18
+ /** @deprecated 请使用 weather="snow" + snowLevel={9} */
19
+ | 'heavySnow' | 'sleet' | 'hail' | 'smog'
20
+ /** @deprecated 请用 windLevel 控制风效,不再作为独立天气场景 */
21
+ | 'gale';
22
+ export interface WeatherBackgroundProps {
23
+ width?: number;
24
+ height?: number;
25
+ /** 为 true 时铺满父容器(父级需有明确高度) */
26
+ fill?: boolean;
27
+ /** 天气类型:sunny / partlyCloudy / overcast / rain 雨天 / thunderstorm / fog / snow 雪天 / sleet / hail / smog;雨量用 rainLevel,雪量用 snowLevel,风效用 windLevel */
28
+ weather?: WeatherType;
29
+ /**
30
+ * 场景时刻 `HH:mm`,默认 `14:00`(下午);夜间示例可用 `02:00`。
31
+ * 昼夜由 latitude / longitude 当地日出日落判定;live 模式下忽略,改用当前时钟。
32
+ */
33
+ time?: string;
34
+ /** 接入 Open-Meteo 实况:自动定位并按真实天气渲染,定位或请求失败时回退到 weather;时刻随当地时钟东升西落 */
35
+ live?: boolean;
36
+ /** 纬度(-90 ~ 90):用于日出日落与昼夜判定;live 未配置时可跳过浏览器定位 */
37
+ latitude?: number;
38
+ /** 经度(-180 ~ 180):与 latitude 同时配置 */
39
+ longitude?: number;
40
+ /** 蒲福风级 0~12,默认 3(微风);live 模式下使用 Open-Meteo 实况风速 */
41
+ windLevel?: number;
42
+ /** 雨量档 1~10:1~2 毛毛雨 / 3~4 小雨 / 5~6 中雨 / 7~8 暴雨 / 9~10 特大暴雨,默认 5;rain / thunderstorm / sleet 生效;live 模式下由实况推导 */
43
+ rainLevel?: number;
44
+ /** 雪量档 1~10:1~2 毛毛雪 / 3~4 小雪 / 5~6 中雪 / 7~8 暴雪 / 9~10 特大暴雪,默认 5;snow / sleet 生效;live 模式下由实况推导 */
45
+ snowLevel?: number;
46
+ /** 冰雹强度 1~3:1 细雹 / 2 密雹 / 3 巨雹,默认 2;仅 hail 天气生效;live 模式下由实况推导 */
47
+ hailLevel?: number;
48
+ /** 雾浓度 1~3:1 薄雾 / 2 中雾 / 3 浓雾,默认 2;仅 fog 天气生效;live 模式下由实况推导 */
49
+ fogLevel?: number;
50
+ /** 霾强度 1~3:1 轻霾 / 2 中霾 / 3 重霾,默认 2;仅 smog 天气生效;live 模式下由实况推导 */
51
+ smogLevel?: number;
52
+ /** live 模式解析出真实天气后回调 */
53
+ onLiveWeather?: (weather: WeatherType) => void;
54
+ /** 外部受控 loading:在当前画面上叠加加载遮罩(live 模式定位/请求期间会自动显示,无需传入) */
55
+ loading?: boolean;
56
+ /** 画布无障碍标签;不传时使用默认中文描述 */
57
+ ariaLabel?: string;
58
+ /** 加载状态文案 */
59
+ loadingText?: string;
60
+ }
61
+ export interface WeatherConfig {
62
+ sky: [string, string];
63
+ sun: 'full' | 'soft' | 'dim' | 'none';
64
+ cloudCount: number;
65
+ cloudColor: [number, number, number];
66
+ cloudAlpha: number;
67
+ cloudSpread: number;
68
+ rain: {
69
+ count: number;
70
+ speed: number;
71
+ wind: number;
72
+ alpha: number;
73
+ splash: boolean;
74
+ } | null;
75
+ fogBanks: number;
76
+ haze: number;
77
+ snowCount: number;
78
+ lightning: boolean;
79
+ }
80
+ export interface Star {
81
+ x: number;
82
+ y: number;
83
+ r: number;
84
+ phase: number;
85
+ speed: number;
86
+ }
87
+ export interface Cloud {
88
+ x: number;
89
+ y: number;
90
+ scale: number;
91
+ speed: number;
92
+ puffs: {
93
+ dx: number;
94
+ dy: number;
95
+ r: number;
96
+ }[];
97
+ /** 预渲染贴图(puffs 已烘焙),每帧只平移绘制 */
98
+ sprite: HTMLCanvasElement;
99
+ /** 贴图左上角相对 cloud.x/cloud.y 的偏移 */
100
+ ox: number;
101
+ oy: number;
102
+ }
103
+ export interface Drop {
104
+ x: number;
105
+ y: number;
106
+ len: number;
107
+ speed: number;
108
+ }
109
+ export interface Splash {
110
+ x: number;
111
+ r: number;
112
+ alpha: number;
113
+ }
114
+ export interface FogBank {
115
+ x: number;
116
+ y: number;
117
+ rw: number;
118
+ rh: number;
119
+ speed: number;
120
+ alpha: number;
121
+ }
122
+ export interface Flake {
123
+ x: number;
124
+ y: number;
125
+ size: number;
126
+ speed: number;
127
+ phase: number;
128
+ drift: number;
129
+ rotation: number;
130
+ rotationSpeed: number;
131
+ opacity: number;
132
+ /** 来自共享贴图池 */
133
+ sprite: HTMLCanvasElement;
134
+ /** 绘制边长(贴图按此缩放) */
135
+ drawSize: number;
136
+ }
137
+ export interface Hailstone {
138
+ x: number;
139
+ y: number;
140
+ r: number;
141
+ vx: number;
142
+ vy: number;
143
+ bounces: number;
144
+ opacity: number;
145
+ /** 帧延迟:>0 时不渲染,用于打散同时出现的批次感 */
146
+ delay: number;
147
+ gravity: number;
148
+ phase: number;
149
+ gust: number;
150
+ maxBounces: number;
151
+ /** 来自共享贴图池 */
152
+ sprite: HTMLCanvasElement;
153
+ /** 绘制边长(贴图按此缩放) */
154
+ drawSize: number;
155
+ rotation: number;
156
+ rotationSpeed: number;
157
+ }
158
+ export interface WindStreak {
159
+ x: number;
160
+ y: number;
161
+ length: number;
162
+ speed: number;
163
+ wave: number;
164
+ alpha: number;
165
+ width: number;
166
+ /** 个体相位,用于与全局风场错开 */
167
+ phase: number;
168
+ }
169
+ export interface MoonCrater {
170
+ dx: number;
171
+ dy: number;
172
+ r: number;
173
+ }
174
+ /** 预渲染的日/月贴图,绘制时按 breath 轻微缩放 */
175
+ export interface CelestialSprite {
176
+ canvas: HTMLCanvasElement;
177
+ /** 贴图中心到边的半长 */
178
+ half: number;
179
+ breathSpeed: number;
180
+ breathAmp: number;
181
+ }
182
+ /** 预渲染的雾团贴图(alpha=1 的柔边圆),绘制时按 bank 缩放并叠加透明度 */
183
+ export interface FogSprite {
184
+ canvas: HTMLCanvasElement;
185
+ baseR: number;
186
+ }
187
+ export interface SceneState {
188
+ stars: Star[];
189
+ moonCraters: MoonCrater[];
190
+ clouds: Cloud[];
191
+ drops: Drop[];
192
+ splashes: Splash[];
193
+ fogBanks: FogBank[];
194
+ flakes: Flake[];
195
+ hailstones: Hailstone[];
196
+ /** 冰雹共享贴图池,落地回收时复用 */
197
+ hailPool: HTMLCanvasElement[];
198
+ windStreaks: WindStreak[];
199
+ t: number;
200
+ flashAlpha: number;
201
+ boltLife: number;
202
+ boltPoints: [number, number][];
203
+ nextStrike: number;
204
+ }
205
+ export interface WeatherSceneParams {
206
+ ctx: CanvasRenderingContext2D;
207
+ width: number;
208
+ height: number;
209
+ activeWeather: WeatherType;
210
+ /** 由日弧推算的昼夜(内部更新) */
211
+ activeNight: boolean;
212
+ /** 当地日出日落;有则启用日弧 */
213
+ dayCycleTimes?: DayCycleTimes | null;
214
+ /** 场景时刻(ms);live 模式下由动画循环用 Date.now() 覆盖 */
215
+ sceneTimeMs: number;
216
+ /** true = 每帧用当前时钟(live) */
217
+ liveClock?: boolean;
218
+ /** 风速驱动的运动参数 */
219
+ windMotion: WindMotion;
220
+ /** 雨量档 1~10;雨天时用于连续插值雨丝密度 */
221
+ rainLevel?: number;
222
+ /** 雪量档 1~10;雪天时用于连续插值雪花数量 */
223
+ snowLevel?: number;
224
+ /** 冰雹强度 1~3;冰雹天气时调节粒子数量与大小 */
225
+ hailLevel?: number;
226
+ /** 雾浓度 1~3;雾天时调节雾团与霾层 */
227
+ fogLevel?: number;
228
+ /** 霾强度 1~3;霾天时调节雾团与黄褐罩层 */
229
+ smogLevel?: number;
230
+ }
@@ -0,0 +1,68 @@
1
+ export declare const REFERENCE_WIND_KMH = 16;
2
+ export declare const DEFAULT_WIND_LEVEL = 3;
3
+ export declare const clampWindLevel: (level: number) => number;
4
+ /** 展示风级 → 视觉风级(整体降两档:3 级≈原 1 级,5 级≈原 3 级) */
5
+ export declare const visualWindLevel: (level: number) => number;
6
+ export interface WindMotion {
7
+ /** 等效风速 km/h */
8
+ speedKmh: number;
9
+ /** 蒲福风级 0~12(展示/实况) */
10
+ level: number;
11
+ /** 用于渲染的视觉风级(比 level 低两档) */
12
+ visualLevel: number;
13
+ /** 相对三级风的强度比 */
14
+ scale: number;
15
+ /** 云层漂移倍率 */
16
+ cloud: number;
17
+ /** 雨/毛毛雨水平风分量倍率(作用于 cfg.rain.wind) */
18
+ rain: number;
19
+ /** 雪花水平飘移 px/帧(负值=向左,与雨丝一致) */
20
+ snowDrift: number;
21
+ /** 冰雹侧向 gust 倍率 */
22
+ hail: number;
23
+ /** 雾团漂移倍率 */
24
+ fog: number;
25
+ /** 风条速度倍率 */
26
+ streak: number;
27
+ /** 风条可见度 0~1(风级越高越明显) */
28
+ streakVisibility: number;
29
+ /** 阵风起伏幅度 0~1(风级越高越剧烈) */
30
+ gustiness: number;
31
+ /** 风向扰动幅度(弧度) */
32
+ wander: number;
33
+ }
34
+ /** 瞬时风场:阵风强度 + 方向扰动 */
35
+ export interface WindFieldSample {
36
+ /** 相对基准的瞬时强度,约 0.15~2.2 */
37
+ intensity: number;
38
+ /** 相对水平的偏角(弧度),正=偏下 */
39
+ angle: number;
40
+ /** 单位方向 x(主风向约定为向右 +1 附近) */
41
+ ux: number;
42
+ /** 单位方向 y */
43
+ uy: number;
44
+ }
45
+ /**
46
+ * 采样自然风场:多层正弦叠加阵风/静歇,并带空间相位差。
47
+ * `t` 为场景帧计数;`x/y` 用于让画面不同位置不同步。
48
+ */
49
+ export declare const sampleWindField: (t: number, motion: Pick<WindMotion, "gustiness" | "wander">, x?: number, y?: number) => WindFieldSample;
50
+ /** 按风级生成风条数量与透明度(全天气场景通用) */
51
+ export declare const windStreakSpec: (level: number) => {
52
+ count: number;
53
+ alphaMul: number;
54
+ };
55
+ /** 风级 → 典型 km/h */
56
+ export declare const windLevelToKmh: (level: number) => number;
57
+ /** km/h → 蒲福风级 */
58
+ export declare const kmhToWindLevel: (kmh: number) => number;
59
+ /**
60
+ * 根据风速构建运动参数。
61
+ * 展示风级比视觉风级高两档;三级风视觉上接近原先一级风感。
62
+ */
63
+ export declare const buildWindMotion: (speedKmh: number) => WindMotion;
64
+ export declare const resolveWindKmh: (options: {
65
+ live: boolean;
66
+ windLevel: number;
67
+ liveWindKmh?: number | null;
68
+ }) => number;
@@ -0,0 +1,45 @@
1
+ /// <reference types="vite/client" />
2
+
3
+ declare module '*.vue' {
4
+ import type { DefineComponent } from 'vue';
5
+ const component: DefineComponent<object, object, unknown>;
6
+ export default component;
7
+ }
8
+
9
+ declare module '*.module.less' {
10
+ const classes: { readonly [key: string]: string };
11
+ export default classes;
12
+ }
13
+
14
+ declare module '*.less' {
15
+ const classes: { readonly [key: string]: string };
16
+ export default classes;
17
+ }
18
+
19
+ declare module '*.png' {
20
+ const src: string;
21
+ export default src;
22
+ }
23
+
24
+ declare module '*.jpg' {
25
+ const src: string;
26
+ export default src;
27
+ }
28
+
29
+ declare module '*.mp4' {
30
+ const src: string;
31
+ export default src;
32
+ }
33
+
34
+ declare module '*.mp3' {
35
+ const src: string;
36
+ export default src;
37
+ }
38
+
39
+ declare module '*.svg' {
40
+ import type { FC, SVGProps } from 'react';
41
+
42
+ export const ReactComponent: FC<SVGProps<SVGSVGElement>>;
43
+ const src: string;
44
+ export default src;
45
+ }
@@ -0,0 +1,2 @@
1
+ export { default as WeatherBackground } from './src/components/weatherBackground/vue/WeatherBackground.vue';
2
+ export type * from './src/components/weatherBackground/core/types';