cos-design 3.5.1 → 3.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,8 +2,34 @@ import { default as React } from 'react';
2
2
  export interface RippleWaterProps {
3
3
  width?: number;
4
4
  height?: number;
5
- /** 涟漪颜色 */
5
+ /** 水面渐变浅端(左上) */
6
+ fromColor?: string;
7
+ /** 水面渐变深端(右下) */
8
+ toColor?: string;
9
+ /** 涟漪高光色 */
6
10
  color?: string;
11
+ /** 环境波浪强度 0~2,默认 1 */
12
+ waveAmplitude?: number;
13
+ /** 环境波浪速度 0~3,默认 1 */
14
+ waveSpeed?: number;
15
+ /** 波光闪烁强度 0~2,默认 1 */
16
+ shimmer?: number;
17
+ /** 水面反射强度 0~1,默认 0.38 */
18
+ reflection?: number;
19
+ /** 点击涟漪力度 0~3,默认 1 */
20
+ rippleStrength?: number;
21
+ /** 涟漪落点半径(仿真格点 2~12),默认 6 */
22
+ rippleRadius?: number;
23
+ /** 涟漪衰减 0.9~0.999,越大越持久,默认 0.985 */
24
+ damping?: number;
25
+ /** 涟漪传播速度 0.3~0.7,默认 0.5 */
26
+ spread?: number;
27
+ /** 是否响应点击/触摸产生涟漪,默认 true */
28
+ interactive?: boolean;
29
+ /** 是否显示底部提示,默认 true */
30
+ showHint?: boolean;
31
+ /** 底部提示文案 */
32
+ hint?: string;
7
33
  }
8
34
  declare const RippleWater: React.FC<RippleWaterProps>;
9
35
  export default RippleWater;
@@ -2,7 +2,7 @@ import { default as React } from 'react';
2
2
  export interface SmokeFogProps {
3
3
  width?: number;
4
4
  height?: number;
5
- /** 雾气密度 0~1,默认 0.5 */
5
+ /** 雾气密度 0~1,默认 0.5;点击/触摸画面可使雾气向外散开 */
6
6
  density?: number;
7
7
  }
8
8
  declare const SmokeFog: React.FC<SmokeFogProps>;
@@ -0,0 +1,9 @@
1
+ import { WeatherConfig, WeatherType } from './types';
2
+ export declare const CONFIGS: Record<WeatherType, WeatherConfig>;
3
+ /** 夜间天空渐变与可见星星数量(云越多星越少) */
4
+ export declare const NIGHT_CONFIGS: Record<WeatherType, {
5
+ sky: [string, string];
6
+ stars: number;
7
+ }>;
8
+ /** 夜间云色:整体压暗并偏冷蓝 */
9
+ export declare const toNightCloudColor: ([r, g, b]: [number, number, number]) => [number, number, number];
@@ -1,24 +1,5 @@
1
1
  import { default as React } from 'react';
2
- export type WeatherType = 'sunny' | 'partlyCloudy' | 'overcast' | 'lightRain' | 'moderateRain' | 'heavyRain' | 'thunderstorm' | 'fog' | 'lightSnow' | 'moderateSnow' | 'heavySnow' | 'sleet' | 'hail' | 'smog' | 'gale'
3
- /** @deprecated 请使用 moderateSnow */
4
- | 'snow';
5
- export interface WeatherBackgroundProps {
6
- width?: number;
7
- height?: number;
8
- /** 天气类型:sunny 大晴天 / partlyCloudy 多云 / overcast 阴天 / lightRain 小雨 / moderateRain 中雨 / heavyRain 大雨 / thunderstorm 雷阵雨 / fog 雾 / lightSnow 小雪 / moderateSnow 中雪 / heavySnow 大雪 / sleet 雨夹雪 / hail 冰雹 / smog 霾 / gale 大风 */
9
- weather?: WeatherType;
10
- /** 夜间模式:渲染深夜天空、月亮与星空;live 模式下自动按当地实际日夜覆盖此值 */
11
- night?: boolean;
12
- /** 接入 Open-Meteo 实况:自动定位并按真实天气渲染,定位或请求失败时回退到 weather */
13
- live?: boolean;
14
- /** live 模式查询纬度(-90 ~ 90),与 longitude 同时配置时跳过浏览器定位 */
15
- latitude?: number;
16
- /** live 模式查询经度(-180 ~ 180),与 latitude 同时配置时跳过浏览器定位 */
17
- longitude?: number;
18
- /** live 模式解析出真实天气后回调 */
19
- onLiveWeather?: (weather: WeatherType) => void;
20
- /** 外部受控 loading:在当前画面上叠加加载遮罩(live 模式定位/请求期间会自动显示,无需传入) */
21
- loading?: boolean;
22
- }
2
+ import { WeatherBackgroundProps } from './types';
3
+ export type { WeatherBackgroundProps, WeatherType } from './types';
23
4
  declare const WeatherBackground: React.FC<WeatherBackgroundProps>;
24
5
  export default WeatherBackground;
@@ -0,0 +1 @@
1
+ export declare function displaceBolt(x1: number, y1: number, x2: number, y2: number, rough: number, depth: number): [number, number][];
@@ -1,6 +1,6 @@
1
1
  import { WeatherType } from './index';
2
2
  export interface OpenMeteoCurrent {
3
- /** WMO 天气码 */
3
+ /** Open-Meteo 精简天气码(WMO WW 子集,非完整 4677) */
4
4
  weatherCode: number;
5
5
  /** 10 米风速(km/h) */
6
6
  windSpeed: number;
@@ -18,7 +18,7 @@ export interface LiveWeatherState {
18
18
  /** Open-Meteo 原始实况数据 */
19
19
  current: OpenMeteoCurrent | null;
20
20
  }
21
- /** WMO 天气码 → WeatherType;无降水且风速达强风时映射为大风 */
21
+ /** Open-Meteo / WMO 精简天气码 → WeatherType;无降水且风速达强风时映射为大风 */
22
22
  export declare const mapWmoCodeToWeatherType: (code: number, windSpeedKmh?: number) => WeatherType;
23
23
  export interface LiveWeatherCoords {
24
24
  latitude: number;
@@ -0,0 +1,2 @@
1
+ import { WeatherSceneParams } from '../types';
2
+ export declare function createWeatherScene(params: WeatherSceneParams): () => void;
@@ -0,0 +1,4 @@
1
+ import { WeatherSceneRuntime } from './runtime';
2
+ export declare function drawClouds(scene: WeatherSceneRuntime): void;
3
+ export declare function drawFog(scene: WeatherSceneRuntime): void;
4
+ export declare function drawHaze(scene: WeatherSceneRuntime): void;
@@ -0,0 +1,3 @@
1
+ import { WeatherSceneRuntime } from './runtime';
2
+ export declare function drawWind(scene: WeatherSceneRuntime): void;
3
+ export declare function drawLightning(scene: WeatherSceneRuntime): void;
@@ -0,0 +1,4 @@
1
+ import { WeatherSceneRuntime } from './runtime';
2
+ export declare function drawRain(scene: WeatherSceneRuntime): void;
3
+ export declare function drawSnow(scene: WeatherSceneRuntime): void;
4
+ export declare function drawHail(scene: WeatherSceneRuntime): void;
@@ -0,0 +1,4 @@
1
+ import { WeatherSceneRuntime } from './runtime';
2
+ export declare function drawSky(scene: WeatherSceneRuntime): void;
3
+ export declare function drawStars(scene: WeatherSceneRuntime): void;
4
+ export declare function drawSun(scene: WeatherSceneRuntime): void;
@@ -0,0 +1,15 @@
1
+ import { CelestialSprite, FogSprite, SceneState, WeatherConfig, WeatherSceneParams } from '../types';
2
+ export interface WeatherSceneLayout {
3
+ sky: [string, string];
4
+ cloudRgb: [number, number, number];
5
+ cfg: WeatherConfig;
6
+ sunX: number;
7
+ sunY: number;
8
+ sunR: number;
9
+ skyGradient: CanvasGradient;
10
+ celestial: CelestialSprite | null;
11
+ fogSprite: FogSprite | null;
12
+ }
13
+ export declare function createSceneState(params: WeatherSceneParams): WeatherSceneLayout & {
14
+ state: SceneState;
15
+ };
@@ -0,0 +1,21 @@
1
+ import { CelestialSprite, FogSprite, SceneState, WeatherConfig, WeatherType } from '../types';
2
+ export interface WeatherSceneRuntime {
3
+ ctx: CanvasRenderingContext2D;
4
+ width: number;
5
+ height: number;
6
+ activeWeather: WeatherType;
7
+ activeNight: boolean;
8
+ sky: [string, string];
9
+ cloudRgb: [number, number, number];
10
+ cfg: WeatherConfig;
11
+ sunX: number;
12
+ sunY: number;
13
+ sunR: number;
14
+ /** 缓存的天空线性渐变(整场不变) */
15
+ skyGradient: CanvasGradient;
16
+ /** 预渲染的日/月贴图,白天为太阳、夜间为月亮,sun==='none' 时为 null */
17
+ celestial: CelestialSprite | null;
18
+ /** 预渲染的雾团贴图,无雾时为 null */
19
+ fogSprite: FogSprite | null;
20
+ state: SceneState;
21
+ }
@@ -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,5 @@
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) => void;
5
+ export declare const makeHailstone: (width: number, height: number, pool: HTMLCanvasElement[]) => 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,170 @@
1
+ export type WeatherType = 'sunny' | 'partlyCloudy' | 'overcast' | 'lightRain' | 'moderateRain' | 'heavyRain' | 'thunderstorm' | 'fog' | 'lightSnow' | 'moderateSnow' | 'heavySnow' | 'sleet' | 'hail' | 'smog' | 'gale'
2
+ /** @deprecated 请使用 moderateSnow */
3
+ | 'snow';
4
+ export interface WeatherBackgroundProps {
5
+ width?: number;
6
+ height?: number;
7
+ /** 天气类型:sunny 大晴天 / partlyCloudy 多云 / overcast 阴天 / lightRain 小雨 / moderateRain 中雨 / heavyRain 大雨 / thunderstorm 雷阵雨 / fog 雾 / lightSnow 小雪 / moderateSnow 中雪 / heavySnow 大雪 / sleet 雨夹雪 / hail 冰雹 / smog 霾 / gale 大风 */
8
+ weather?: WeatherType;
9
+ /** 夜间模式:渲染深夜天空、月亮与星空;live 模式下自动按当地实际日夜覆盖此值 */
10
+ night?: boolean;
11
+ /** 接入 Open-Meteo 实况:自动定位并按真实天气渲染,定位或请求失败时回退到 weather */
12
+ live?: boolean;
13
+ /** live 模式查询纬度(-90 ~ 90),与 longitude 同时配置时跳过浏览器定位 */
14
+ latitude?: number;
15
+ /** live 模式查询经度(-180 ~ 180),与 latitude 同时配置时跳过浏览器定位 */
16
+ longitude?: number;
17
+ /** live 模式解析出真实天气后回调 */
18
+ onLiveWeather?: (weather: WeatherType) => void;
19
+ /** 外部受控 loading:在当前画面上叠加加载遮罩(live 模式定位/请求期间会自动显示,无需传入) */
20
+ loading?: boolean;
21
+ }
22
+ export interface WeatherConfig {
23
+ sky: [string, string];
24
+ sun: 'full' | 'soft' | 'dim' | 'none';
25
+ cloudCount: number;
26
+ cloudColor: [number, number, number];
27
+ cloudAlpha: number;
28
+ cloudSpread: number;
29
+ rain: {
30
+ count: number;
31
+ speed: number;
32
+ wind: number;
33
+ alpha: number;
34
+ splash: boolean;
35
+ } | null;
36
+ fogBanks: number;
37
+ haze: number;
38
+ snowCount: number;
39
+ lightning: boolean;
40
+ }
41
+ export interface Star {
42
+ x: number;
43
+ y: number;
44
+ r: number;
45
+ phase: number;
46
+ speed: number;
47
+ }
48
+ export interface Cloud {
49
+ x: number;
50
+ y: number;
51
+ scale: number;
52
+ speed: number;
53
+ puffs: {
54
+ dx: number;
55
+ dy: number;
56
+ r: number;
57
+ }[];
58
+ /** 预渲染贴图(puffs 已烘焙),每帧只平移绘制 */
59
+ sprite: HTMLCanvasElement;
60
+ /** 贴图左上角相对 cloud.x/cloud.y 的偏移 */
61
+ ox: number;
62
+ oy: number;
63
+ }
64
+ export interface Drop {
65
+ x: number;
66
+ y: number;
67
+ len: number;
68
+ speed: number;
69
+ }
70
+ export interface Splash {
71
+ x: number;
72
+ r: number;
73
+ alpha: number;
74
+ }
75
+ export interface FogBank {
76
+ x: number;
77
+ y: number;
78
+ rw: number;
79
+ rh: number;
80
+ speed: number;
81
+ alpha: number;
82
+ }
83
+ export interface Flake {
84
+ x: number;
85
+ y: number;
86
+ size: number;
87
+ speed: number;
88
+ phase: number;
89
+ drift: number;
90
+ rotation: number;
91
+ rotationSpeed: number;
92
+ opacity: number;
93
+ /** 来自共享贴图池 */
94
+ sprite: HTMLCanvasElement;
95
+ /** 绘制边长(贴图按此缩放) */
96
+ drawSize: number;
97
+ }
98
+ export interface Hailstone {
99
+ x: number;
100
+ y: number;
101
+ r: number;
102
+ vx: number;
103
+ vy: number;
104
+ bounces: number;
105
+ opacity: number;
106
+ /** 帧延迟:>0 时不渲染,用于打散同时出现的批次感 */
107
+ delay: number;
108
+ gravity: number;
109
+ phase: number;
110
+ gust: number;
111
+ maxBounces: number;
112
+ /** 来自共享贴图池 */
113
+ sprite: HTMLCanvasElement;
114
+ /** 绘制边长(贴图按此缩放) */
115
+ drawSize: number;
116
+ rotation: number;
117
+ rotationSpeed: number;
118
+ }
119
+ export interface WindStreak {
120
+ x: number;
121
+ y: number;
122
+ length: number;
123
+ speed: number;
124
+ wave: number;
125
+ alpha: number;
126
+ width: number;
127
+ }
128
+ export interface MoonCrater {
129
+ dx: number;
130
+ dy: number;
131
+ r: number;
132
+ }
133
+ /** 预渲染的日/月贴图,绘制时按 breath 轻微缩放 */
134
+ export interface CelestialSprite {
135
+ canvas: HTMLCanvasElement;
136
+ /** 贴图中心到边的半长 */
137
+ half: number;
138
+ breathSpeed: number;
139
+ breathAmp: number;
140
+ }
141
+ /** 预渲染的雾团贴图(alpha=1 的柔边圆),绘制时按 bank 缩放并叠加透明度 */
142
+ export interface FogSprite {
143
+ canvas: HTMLCanvasElement;
144
+ baseR: number;
145
+ }
146
+ export interface SceneState {
147
+ stars: Star[];
148
+ moonCraters: MoonCrater[];
149
+ clouds: Cloud[];
150
+ drops: Drop[];
151
+ splashes: Splash[];
152
+ fogBanks: FogBank[];
153
+ flakes: Flake[];
154
+ hailstones: Hailstone[];
155
+ /** 冰雹共享贴图池,落地回收时复用 */
156
+ hailPool: HTMLCanvasElement[];
157
+ windStreaks: WindStreak[];
158
+ t: number;
159
+ flashAlpha: number;
160
+ boltLife: number;
161
+ boltPoints: [number, number][];
162
+ nextStrike: number;
163
+ }
164
+ export interface WeatherSceneParams {
165
+ ctx: CanvasRenderingContext2D;
166
+ width: number;
167
+ height: number;
168
+ activeWeather: WeatherType;
169
+ activeNight: boolean;
170
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cos-design",
3
- "version": "3.5.1",
3
+ "version": "3.5.3",
4
4
  "description": "A React component library built with Vite",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",