cos-design 3.5.4 → 3.6.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 (32) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/dist/index.cjs +3 -3
  3. package/dist/index.css +1 -1
  4. package/dist/index.js +2220 -534
  5. package/dist/src/components/bubbleField/background.d.ts +3 -0
  6. package/dist/src/components/bubbleField/constants.d.ts +10 -0
  7. package/dist/src/components/bubbleField/index.d.ts +5 -0
  8. package/dist/src/components/bubbleField/merge.d.ts +5 -0
  9. package/dist/src/components/bubbleField/physics.d.ts +12 -0
  10. package/dist/src/components/bubbleField/render.d.ts +3 -0
  11. package/dist/src/components/bubbleField/types.d.ts +81 -0
  12. package/dist/src/components/bubbleField/utils.d.ts +6 -0
  13. package/dist/src/components/countUp/index.d.ts +19 -0
  14. package/dist/src/components/gameOfLife/index.d.ts +17 -0
  15. package/dist/src/components/index.d.ts +27 -1
  16. package/dist/src/components/networkGraph/index.d.ts +24 -0
  17. package/dist/src/components/sandFall/index.d.ts +13 -0
  18. package/dist/src/components/splitText/index.d.ts +21 -0
  19. package/dist/src/components/springMass/index.d.ts +17 -0
  20. package/dist/src/components/textMorph/index.d.ts +15 -0
  21. package/dist/src/components/weatherBackground/day-cycle.d.ts +53 -0
  22. package/dist/src/components/weatherBackground/fog.d.ts +25 -0
  23. package/dist/src/components/weatherBackground/hail-level.d.ts +24 -0
  24. package/dist/src/components/weatherBackground/live-weather.d.ts +51 -2
  25. package/dist/src/components/weatherBackground/precipitation.d.ts +51 -0
  26. package/dist/src/components/weatherBackground/scene/init-state.d.ts +29 -0
  27. package/dist/src/components/weatherBackground/scene/runtime.d.ts +19 -2
  28. package/dist/src/components/weatherBackground/smog.d.ts +17 -0
  29. package/dist/src/components/weatherBackground/sprites/hail.d.ts +8 -2
  30. package/dist/src/components/weatherBackground/types.d.ts +63 -9
  31. package/dist/src/components/weatherBackground/wind.d.ts +68 -0
  32. package/package.json +1 -1
@@ -1,4 +1,7 @@
1
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';
2
5
  export interface WeatherSceneRuntime {
3
6
  ctx: CanvasRenderingContext2D;
4
7
  width: number;
@@ -11,11 +14,25 @@ export interface WeatherSceneRuntime {
11
14
  sunX: number;
12
15
  sunY: number;
13
16
  sunR: number;
14
- /** 缓存的天空线性渐变(整场不变) */
17
+ /** 缓存的天空线性渐变 */
15
18
  skyGradient: CanvasGradient;
16
- /** 预渲染的日/月贴图,白天为太阳、夜间为月亮,sun==='none' 时为 null */
19
+ /** 当前绘制的日/月贴图 */
17
20
  celestial: CelestialSprite | null;
21
+ /** 预烘焙太阳(日弧模式下与月亮并存) */
22
+ sunSprite: CelestialSprite | null;
23
+ /** 预烘焙月亮 */
24
+ moonSprite: CelestialSprite | null;
18
25
  /** 预渲染的雾团贴图,无雾时为 null */
19
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;
20
37
  state: SceneState;
21
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;
@@ -1,5 +1,11 @@
1
1
  import { Hailstone } from '../types';
2
2
  /** 预生成共享冰雹贴图池;reset 只换贴图引用,不再分配新 canvas */
3
3
  export declare const createHailSpritePool: (count?: number) => HTMLCanvasElement[];
4
- export declare const resetHailstone: (h: Hailstone, width: number, height: number, pool: HTMLCanvasElement[], spawnAbove?: boolean) => void;
5
- export declare const makeHailstone: (width: number, height: number, pool: HTMLCanvasElement[]) => Hailstone;
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;
@@ -1,19 +1,52 @@
1
- export type WeatherType = 'sunny' | 'partlyCloudy' | 'overcast' | 'lightRain' | 'moderateRain' | 'heavyRain' | 'thunderstorm' | 'fog' | 'lightSnow' | 'moderateSnow' | 'heavySnow' | 'sleet' | 'hail' | 'smog' | 'gale'
2
- /** @deprecated 请使用 moderateSnow */
3
- | 'snow';
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';
4
22
  export interface WeatherBackgroundProps {
5
23
  width?: number;
6
24
  height?: number;
7
- /** 天气类型:sunny 大晴天 / partlyCloudy 多云 / overcast 阴天 / lightRain 小雨 / moderateRain 中雨 / heavyRain 大雨 / thunderstorm 雷阵雨 / fog 雾 / lightSnow 小雪 / moderateSnow 中雪 / heavySnow 大雪 / sleet 雨夹雪 / hail 冰雹 / smog 霾 / gale 大风 */
25
+ /** 天气类型:sunny / partlyCloudy / overcast / rain 雨天 / thunderstorm / fog / snow 雪天 / sleet / hail / smog;雨量用 rainLevel,雪量用 snowLevel,风效用 windLevel */
8
26
  weather?: WeatherType;
9
- /** 夜间模式:渲染深夜天空、月亮与星空;live 模式下自动按当地实际日夜覆盖此值 */
10
- night?: boolean;
11
- /** 接入 Open-Meteo 实况:自动定位并按真实天气渲染,定位或请求失败时回退到 weather */
27
+ /**
28
+ * 场景时刻 `HH:mm`,默认 `14:00`(下午);夜间示例可用 `02:00`。
29
+ * 昼夜由 latitude / longitude 当地日出日落判定;live 模式下忽略,改用当前时钟。
30
+ */
31
+ time?: string;
32
+ /** 接入 Open-Meteo 实况:自动定位并按真实天气渲染,定位或请求失败时回退到 weather;时刻随当地时钟东升西落 */
12
33
  live?: boolean;
13
- /** live 模式查询纬度(-90 ~ 90),与 longitude 同时配置时跳过浏览器定位 */
34
+ /** 纬度(-90 ~ 90):用于日出日落与昼夜判定;live 未配置时可跳过浏览器定位 */
14
35
  latitude?: number;
15
- /** live 模式查询经度(-180 ~ 180),与 latitude 同时配置时跳过浏览器定位 */
36
+ /** 经度(-180 ~ 180):与 latitude 同时配置 */
16
37
  longitude?: number;
38
+ /** 蒲福风级 0~12,默认 3(微风);live 模式下使用 Open-Meteo 实况风速 */
39
+ windLevel?: number;
40
+ /** 雨量档 1~10:1~2 毛毛雨 / 3~4 小雨 / 5~6 中雨 / 7~8 暴雨 / 9~10 特大暴雨,默认 5;rain / thunderstorm / sleet 生效;live 模式下由实况推导 */
41
+ rainLevel?: number;
42
+ /** 雪量档 1~10:1~2 毛毛雪 / 3~4 小雪 / 5~6 中雪 / 7~8 暴雪 / 9~10 特大暴雪,默认 5;snow / sleet 生效;live 模式下由实况推导 */
43
+ snowLevel?: number;
44
+ /** 冰雹强度 1~3:1 细雹 / 2 密雹 / 3 巨雹,默认 2;仅 hail 天气生效;live 模式下由实况推导 */
45
+ hailLevel?: number;
46
+ /** 雾浓度 1~3:1 薄雾 / 2 中雾 / 3 浓雾,默认 2;仅 fog 天气生效;live 模式下由实况推导 */
47
+ fogLevel?: number;
48
+ /** 霾强度 1~3:1 轻霾 / 2 中霾 / 3 重霾,默认 2;仅 smog 天气生效;live 模式下由实况推导 */
49
+ smogLevel?: number;
17
50
  /** live 模式解析出真实天气后回调 */
18
51
  onLiveWeather?: (weather: WeatherType) => void;
19
52
  /** 外部受控 loading:在当前画面上叠加加载遮罩(live 模式定位/请求期间会自动显示,无需传入) */
@@ -124,6 +157,8 @@ export interface WindStreak {
124
157
  wave: number;
125
158
  alpha: number;
126
159
  width: number;
160
+ /** 个体相位,用于与全局风场错开 */
161
+ phase: number;
127
162
  }
128
163
  export interface MoonCrater {
129
164
  dx: number;
@@ -166,5 +201,24 @@ export interface WeatherSceneParams {
166
201
  width: number;
167
202
  height: number;
168
203
  activeWeather: WeatherType;
204
+ /** 由日弧推算的昼夜(内部更新) */
169
205
  activeNight: boolean;
206
+ /** 当地日出日落;有则启用日弧 */
207
+ dayCycleTimes?: DayCycleTimes | null;
208
+ /** 场景时刻(ms);live 模式下由动画循环用 Date.now() 覆盖 */
209
+ sceneTimeMs: number;
210
+ /** true = 每帧用当前时钟(live) */
211
+ liveClock?: boolean;
212
+ /** 风速驱动的运动参数 */
213
+ windMotion: WindMotion;
214
+ /** 雨量档 1~10;雨天时用于连续插值雨丝密度 */
215
+ rainLevel?: number;
216
+ /** 雪量档 1~10;雪天时用于连续插值雪花数量 */
217
+ snowLevel?: number;
218
+ /** 冰雹强度 1~3;冰雹天气时调节粒子数量与大小 */
219
+ hailLevel?: number;
220
+ /** 雾浓度 1~3;雾天时调节雾团与霾层 */
221
+ fogLevel?: number;
222
+ /** 霾强度 1~3;霾天时调节雾团与黄褐罩层 */
223
+ smogLevel?: number;
170
224
  }
@@ -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;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cos-design",
3
- "version": "3.5.4",
3
+ "version": "3.6.0",
4
4
  "description": "A React component library built with Vite",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",