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
@@ -0,0 +1,3 @@
1
+ export declare const drawStaticBackground: (ctx: CanvasRenderingContext2D, width: number, height: number, tint: string) => void;
2
+ export declare const drawDynamicBackground: (ctx: CanvasRenderingContext2D, width: number, height: number, time: number, snowSprite: HTMLCanvasElement, reduceMotion: boolean) => void;
3
+ export declare const createSnowSprite: () => HTMLCanvasElement;
@@ -0,0 +1,10 @@
1
+ import { PointerState } from './types';
2
+ export declare const BLOB_SEGMENTS = 48;
3
+ export declare const META_SEGMENTS = 56;
4
+ export declare const LIGHT_X = 0.82;
5
+ export declare const LIGHT_Y = 0.08;
6
+ export declare const MAX_RADIUS = 46;
7
+ export declare const MAX_DPR = 2;
8
+ export declare const FRAME_MS: number;
9
+ export declare const MERGE_CELL_SIZE: number;
10
+ export declare const createPointerState: () => PointerState;
@@ -0,0 +1,5 @@
1
+ import { default as React } from 'react';
2
+ import { BubbleFieldProps } from './types';
3
+ export type { ActiveMerge, Bubble, BubbleFieldProps, PointerState } from './types';
4
+ declare const BubbleField: React.FC<BubbleFieldProps>;
5
+ export default BubbleField;
@@ -0,0 +1,5 @@
1
+ import { ActiveMerge, Bubble, MergePose } from './types';
2
+ export declare const resolveMergePose: (merge: ActiveMerge) => MergePose;
3
+ export declare const applyMergeAttraction: (bubbles: Bubble[]) => void;
4
+ export declare const startNearbyMerges: (bubbles: Bubble[], merges: ActiveMerge[], busyIds: Set<number>) => void;
5
+ export declare const updateMerges: (bubbles: Bubble[], merges: ActiveMerge[], speedScale: number, frameScale: number) => void;
@@ -0,0 +1,12 @@
1
+ import { Bubble } from './types';
2
+ export declare const createSeabedBubble: (id: number, width: number, height: number, speed: number, deep?: boolean) => Bubble;
3
+ export declare const integrateBubbleMotion: (bubble: Bubble, time: number, height: number, speedScale: number, frameScale: number) => void;
4
+ export declare const samplePointerFlow: (bx: number, by: number, px: number, py: number, pvx: number, pvy: number, pSpeed: number) => {
5
+ fx: number;
6
+ fy: number;
7
+ strain: number;
8
+ strainAngle: number;
9
+ excite: number;
10
+ };
11
+ export declare const integrateSurfaceModes: (bubble: Bubble, frameScale: number) => void;
12
+ export declare const exciteBubbleFromFlow: (bubble: Bubble, strain: number, strainAngle: number, excite: number, fx: number, fy: number) => void;
@@ -0,0 +1,3 @@
1
+ import { Bubble } from './types';
2
+ export declare const drawBubble: (ctx: CanvasRenderingContext2D, bubble: Bubble, time: number, tint: string, width: number, height: number) => void;
3
+ export declare const drawMergingPair: (ctx: CanvasRenderingContext2D, ax: number, ay: number, ar: number, bx: number, by: number, br: number, tint: string, width: number, height: number, alpha: number) => void;
@@ -0,0 +1,81 @@
1
+ export interface BubbleFieldProps {
2
+ width?: number;
3
+ height?: number;
4
+ /** 气泡数量上限 */
5
+ bubbleCount?: number;
6
+ /** 上浮速度 */
7
+ speed?: number;
8
+ /** 水体主色 */
9
+ color?: string;
10
+ /** 是否启用鼠标划过扰动 */
11
+ interactive?: boolean;
12
+ }
13
+ export interface PointerState {
14
+ x: number;
15
+ y: number;
16
+ prevX: number;
17
+ prevY: number;
18
+ vx: number;
19
+ vy: number;
20
+ speed: number;
21
+ active: boolean;
22
+ lastTs: number;
23
+ }
24
+ export interface Bubble {
25
+ id: number;
26
+ x: number;
27
+ y: number;
28
+ radius: number;
29
+ /** 目标终端上升速度(向上为正) */
30
+ terminalRise: number;
31
+ drift: number;
32
+ vx: number;
33
+ /** 竖直速度,向上为负(屏幕坐标) */
34
+ vy: number;
35
+ phase: number;
36
+ alpha: number;
37
+ /** 轻微椭圆度(接近 1 = 近球形) */
38
+ aspect: number;
39
+ deformAmp: number;
40
+ deformPhase: number;
41
+ deformSpeed: number;
42
+ tilt: number;
43
+ pulseBoost: number;
44
+ /** 粘性拉伸强度(沿相对流速) */
45
+ streamStretch: number;
46
+ /** 拉伸主轴方向 */
47
+ streamAngle: number;
48
+ /** 二阶表面模态振幅(椭圆振荡) */
49
+ mode2: number;
50
+ mode2Vel: number;
51
+ mode2Angle: number;
52
+ /** 三阶表面模态振幅(非对称抖动) */
53
+ mode3: number;
54
+ mode3Vel: number;
55
+ mode3Phase: number;
56
+ /** 融合后短暂振荡(快速衰减) */
57
+ settle: number;
58
+ }
59
+ export interface MergePose {
60
+ ax: number;
61
+ ay: number;
62
+ ar: number;
63
+ bx: number;
64
+ by: number;
65
+ br: number;
66
+ approach: number;
67
+ absorb: number;
68
+ }
69
+ export interface ActiveMerge {
70
+ primaryId: number;
71
+ secondaryId: number;
72
+ progress: number;
73
+ targetRadius: number;
74
+ startPrimaryRadius: number;
75
+ startSecondaryRadius: number;
76
+ startPrimaryX: number;
77
+ startPrimaryY: number;
78
+ startSecondaryX: number;
79
+ startSecondaryY: number;
80
+ pose?: MergePose;
81
+ }
@@ -0,0 +1,6 @@
1
+ export declare const easeInOut: (t: number) => number;
2
+ export declare const easeOutCubic: (t: number) => number;
3
+ export declare const smoothstep: (edge0: number, edge1: number, x: number) => number;
4
+ export declare const frameDamp: (value: number, frameScale: number) => number;
5
+ export declare const hash01: (n: number) => number;
6
+ export declare const terminalRiseForRadius: (radius: number, speed: number, randomize?: boolean) => number;
@@ -0,0 +1,19 @@
1
+ import { default as React } from 'react';
2
+ export interface CountUpProps {
3
+ /** 目标值 */
4
+ value: number;
5
+ /** 起始值 */
6
+ start?: number;
7
+ /** 动画时长(毫秒) */
8
+ duration?: number;
9
+ /** 小数位数 */
10
+ decimals?: number;
11
+ /** 前缀 */
12
+ prefix?: string;
13
+ /** 后缀 */
14
+ suffix?: string;
15
+ /** 主色 */
16
+ color?: string;
17
+ }
18
+ declare const CountUp: React.FC<CountUpProps>;
19
+ export default CountUp;
@@ -0,0 +1,17 @@
1
+ import { default as React } from 'react';
2
+ export interface GameOfLifeProps {
3
+ width?: number;
4
+ height?: number;
5
+ /** 单元格大小 */
6
+ cellSize?: number;
7
+ /** 演化速度(毫秒/代) */
8
+ speed?: number;
9
+ /** 初始存活密度 0~1 */
10
+ density?: number;
11
+ /** 存活颜色 */
12
+ aliveColor?: string;
13
+ /** 网格线颜色 */
14
+ gridColor?: string;
15
+ }
16
+ declare const GameOfLife: React.FC<GameOfLifeProps>;
17
+ export default GameOfLife;
@@ -17,6 +17,7 @@ export { default as CyberGrid } from './cyberGrid';
17
17
  export type { CyberGridProps } from './cyberGrid';
18
18
  export type { ConfettiHandle, ConfettiProps } from './confetti';
19
19
  export { default as Countdown } from './countdown';
20
+ export { default as CountUp } from './countUp';
20
21
  export { default as DnaHelix } from './dnaHelix';
21
22
  export type { DnaHelixProps } from './dnaHelix';
22
23
  export { default as ElectricArc } from './electricArc';
@@ -31,9 +32,12 @@ export type { DoublePendulumProps } from './doublePendulum';
31
32
  export { default as Fireworks } from './fireworks';
32
33
  export type { FireworksHandle, FireworksProps } from './fireworks';
33
34
  export { default as FlipCounter } from './flipCounter';
35
+ export type { CountUpProps } from './countUp';
34
36
  export { default as GradientFlow } from './gradientFlow';
35
37
  export type { GradientFlowProps } from './gradientFlow';
36
38
  export type { FlipCounterProps } from './flipCounter';
39
+ export { default as GameOfLife } from './gameOfLife';
40
+ export type { GameOfLifeProps } from './gameOfLife';
37
41
  export { default as GlitchText } from './glitchText';
38
42
  export { default as GravityBalls } from './gravityBalls';
39
43
  export type { GravityBallsProps } from './gravityBalls';
@@ -56,6 +60,8 @@ export type { MazeGeneratorProps } from './mazeGenerator';
56
60
  export type { MatrixRainProps } from './matrixRain';
57
61
  export { default as MeteorRain } from './meteorRain';
58
62
  export type { MeteorRainProps } from './meteorRain';
63
+ export { default as NetworkGraph } from './networkGraph';
64
+ export type { NetworkGraphEdge, NetworkGraphNode, NetworkGraphProps } from './networkGraph';
59
65
  export { default as NeonText } from './neonText';
60
66
  export { default as NewtonCradle } from './newtonCradle';
61
67
  export type { NewtonCradleProps } from './newtonCradle';
@@ -66,6 +72,8 @@ export { default as ParticleNetwork } from './particleNetwork';
66
72
  export { default as PlasmaBall } from './plasmaBall';
67
73
  export type { PlasmaBallProps } from './plasmaBall';
68
74
  export { default as SmokeFog } from './smokeFog';
75
+ export { default as BubbleField } from './bubbleField';
76
+ export type { BubbleFieldProps } from './bubbleField';
69
77
  export { default as SolarSystem } from './solarSystem';
70
78
  export type { SolarSystemProps } from './solarSystem';
71
79
  export type { SmokeFogProps } from './smokeFog';
@@ -95,20 +103,38 @@ export { default as ScratchCard } from './scratchCard';
95
103
  export type { ScratchCardProps } from './scratchCard';
96
104
  export { default as SlotMachine } from './slotMachine';
97
105
  export type { SlotMachineProps } from './slotMachine';
106
+ export { default as SandFall } from './sandFall';
107
+ export type { SandFallProps } from './sandFall';
98
108
  export { default as SplitReveal } from './splitReveal';
99
109
  export type { SplitRevealProps } from './splitReveal';
110
+ export { default as SplitText } from './splitText';
111
+ export type { SplitTextProps } from './splitText';
112
+ export { default as SpringMass } from './springMass';
113
+ export type { SpringMassProps } from './springMass';
100
114
  export { default as Spotlight } from './spotlight';
101
115
  export type { SpotlightProps } from './spotlight';
102
116
  export type { ReturnCityProps } from './returnCity';
103
117
  export type { TurntablePrize, TurntableProps } from './turntable';
104
118
  export { default as Turntable } from './turntable';
119
+ export { default as TextMorph } from './textMorph';
120
+ export type { TextMorphProps } from './textMorph';
105
121
  export { default as Typewriter } from './typewriter';
106
122
  export type { TypewriterProps } from './typewriter';
107
123
  export { default as WaveButton } from './waveButton';
108
124
  export type { WaveButtonProps } from './waveButton';
109
125
  export { default as WeatherBackground } from './weatherBackground';
110
126
  export type { WeatherBackgroundProps, WeatherType } from './weatherBackground';
111
- export { mapWmoCodeToWeatherType, useLiveWeather } from './weatherBackground/live-weather';
127
+ export { formatLocalHm, mapWmoCodeToWeatherType, useLiveWeather, useSunTimes } from './weatherBackground/live-weather';
112
128
  export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent } from './weatherBackground/live-weather';
129
+ export { DEFAULT_FOG_LEVEL, FOG_LEVEL_LABELS, clampFogLevel, fogBankAlphaScale, fogLevelFromVisibility, fogLevelFromWmo, formatFogLevel, intensifyFogConfig, supportsFogLevel } from './weatherBackground/fog';
130
+ export type { FogLevel } from './weatherBackground/fog';
131
+ export { DEFAULT_HAIL_LEVEL, HAIL_LEVEL_LABELS, clampHailLevel, formatHailLevel, hailLevelFromWmo, hailSpec, supportsHailLevel } from './weatherBackground/hail-level';
132
+ export type { HailIntensitySpec, HailLevel } from './weatherBackground/hail-level';
133
+ export { DEFAULT_SMOG_LEVEL, SMOG_LEVEL_LABELS, clampSmogLevel, formatSmogLevel, intensifySmogConfig, smogBankAlphaScale, smogLevelFromVisibility, supportsSmogLevel } from './weatherBackground/smog';
134
+ export type { SmogLevel } from './weatherBackground/smog';
135
+ export { DEFAULT_RAIN_LEVEL, DEFAULT_SNOW_LEVEL, MAX_PRECIP_LEVEL, MIN_PRECIP_LEVEL, RAIN_LEVEL_LABELS, SNOW_LEVEL_LABELS, clampPrecipLevel, formatPrecipLevel, intensifyRainConfig, intensifySnowCount, isRainWeather, isSnowWeather, normalizeWeatherType, precipBand, precipLabel, rainLevelFromWeather, rainLevelFromWmo, resolveSceneWeather, snowLevelFromWeather, snowLevelFromWmo, supportsRainLevel, supportsSnowLevel } from './weatherBackground/precipitation';
136
+ export type { PrecipLevel } from './weatherBackground/precipitation';
137
+ export { DEFAULT_WIND_LEVEL, buildWindMotion, kmhToWindLevel, sampleWindField, visualWindLevel, windLevelToKmh, windStreakSpec } from './weatherBackground/wind';
138
+ export type { WindFieldSample, WindMotion } from './weatherBackground/wind';
113
139
  export { default as WaveText } from './waveText';
114
140
  export type { WaveTextProps } from './waveText';
@@ -0,0 +1,24 @@
1
+ import { default as React } from 'react';
2
+ export interface NetworkGraphNode {
3
+ id: string;
4
+ label?: string;
5
+ color?: string;
6
+ }
7
+ export interface NetworkGraphEdge {
8
+ source: string;
9
+ target: string;
10
+ }
11
+ export interface NetworkGraphProps {
12
+ width?: number;
13
+ height?: number;
14
+ /** 节点列表 */
15
+ nodes?: NetworkGraphNode[];
16
+ /** 边列表 */
17
+ edges?: NetworkGraphEdge[];
18
+ /** 连线颜色 */
19
+ linkColor?: string;
20
+ /** 节点半径 */
21
+ nodeRadius?: number;
22
+ }
23
+ declare const NetworkGraph: React.FC<NetworkGraphProps>;
24
+ export default NetworkGraph;
@@ -0,0 +1,13 @@
1
+ import { default as React } from 'react';
2
+ export interface SandFallProps {
3
+ width?: number;
4
+ height?: number;
5
+ /** 像素格大小 */
6
+ cellSize?: number;
7
+ /** 沙粒颜色列表(仅支持 #RRGGBB) */
8
+ colors?: string[];
9
+ /** 每帧生成粒子数 */
10
+ spawnRate?: number;
11
+ }
12
+ declare const SandFall: React.FC<SandFallProps>;
13
+ export default SandFall;
@@ -0,0 +1,21 @@
1
+ import { default as React } from 'react';
2
+ export interface SplitTextProps {
3
+ /** 显示文字 */
4
+ text?: string;
5
+ /** 动画类型 */
6
+ animation?: 'fadeUp' | 'scale' | 'rotate' | 'blur';
7
+ /** 字符间隔延迟(毫秒) */
8
+ stagger?: number;
9
+ /** 单字符动画时长(毫秒) */
10
+ duration?: number;
11
+ /** 是否循环播放 */
12
+ loop?: boolean;
13
+ /** 循环间歇(毫秒) */
14
+ loopPause?: number;
15
+ /** 字号 */
16
+ fontSize?: number;
17
+ /** 颜色 */
18
+ color?: string;
19
+ }
20
+ declare const SplitText: React.FC<SplitTextProps>;
21
+ export default SplitText;
@@ -0,0 +1,17 @@
1
+ import { default as React } from 'react';
2
+ export interface SpringMassProps {
3
+ width?: number;
4
+ height?: number;
5
+ /** 横向质点数量 */
6
+ cols?: number;
7
+ /** 纵向质点数量 */
8
+ rows?: number;
9
+ /** 弹簧刚度 0~1 */
10
+ stiffness?: number;
11
+ /** 速度阻尼 0~1 */
12
+ damping?: number;
13
+ /** 主色 */
14
+ color?: string;
15
+ }
16
+ declare const SpringMass: React.FC<SpringMassProps>;
17
+ export default SpringMass;
@@ -0,0 +1,15 @@
1
+ import { default as React } from 'react';
2
+ export interface TextMorphProps {
3
+ /** 轮播文案 */
4
+ texts?: string[];
5
+ /** 切换周期(毫秒) */
6
+ interval?: number;
7
+ /** 单次 morph 时长(毫秒) */
8
+ duration?: number;
9
+ /** 字号 */
10
+ fontSize?: number;
11
+ /** 主色 */
12
+ color?: string;
13
+ }
14
+ declare const TextMorph: React.FC<TextMorphProps>;
15
+ export default TextMorph;
@@ -0,0 +1,53 @@
1
+ /** 昼夜太阳/月亮位置与天空色温 —— 按真实日出日落推进 */
2
+ export type RGB = [number, number, number];
3
+ export interface DayCycleTimes {
4
+ /** 当日日出(本地时间戳 ms) */
5
+ sunrise: number;
6
+ /** 当日日落(本地时间戳 ms) */
7
+ sunset: number;
8
+ }
9
+ export interface DayCycleState {
10
+ /** 太阳是否在地平线之上 */
11
+ isDay: boolean;
12
+ /**
13
+ * 当前天体沿东→西弧的进度 0~1。
14
+ * 白天:日出→日落;夜晚:日落→次日日出。
15
+ */
16
+ arcProgress: number;
17
+ /** 高度代理 0~1(地平线→天顶) */
18
+ elevation: number;
19
+ /**
20
+ * 晨昏余晖强度 0~1:靠近日出/日落越高,深夜为 0。
21
+ * 用于天空暖色与星空淡入。
22
+ */
23
+ twilight: number;
24
+ }
25
+ /** 无日出日落数据时的本地近似(6:00 / 18:00) */
26
+ export declare const approximateDayCycleTimes: (now?: number) => DayCycleTimes;
27
+ /** 默认演示时刻:下午 14:00;夜间示例可用 02:00 */
28
+ export declare const DEFAULT_SCENE_TIME = "14:00";
29
+ /** 将 `HH:mm` 解析为「今天」本地时间戳;非法格式返回 null */
30
+ export declare const parseTimeString: (time: string, base?: Date) => number | null;
31
+ /** 解析时刻,失败时回退默认 14:00 */
32
+ export declare const resolveSceneTimeMs: (time: string | undefined, base?: Date) => number;
33
+ /**
34
+ * 根据当前时刻与日出日落计算日弧进度。
35
+ * 若 now 在日落之后,夜晚弧延伸到「次日日出」= 今日日出 + 24h(近似)。
36
+ */
37
+ export declare const computeDayCycle: (nowMs: number, times: DayCycleTimes) => DayCycleState;
38
+ /** 东升西落弧:左侧东 → 右侧西,中间最高 */
39
+ export declare const celestialScreenPosition: (width: number, height: number, arcProgress: number) => {
40
+ x: number;
41
+ y: number;
42
+ };
43
+ /**
44
+ * 按日周期混合天气日/夜天空色。
45
+ * daySky / nightSky 来自 CONFIGS / NIGHT_CONFIGS。
46
+ */
47
+ export declare const resolveSkyByDayCycle: (daySky: [string, string], nightSky: [string, string], cycle: DayCycleState) => [string, string];
48
+ export declare const buildSkyGradient: (ctx: CanvasRenderingContext2D, height: number, sky: [string, string]) => CanvasGradient;
49
+ /** 近地平线时天体略收小、略淡 */
50
+ export declare const celestialDrawScale: (cycle: DayCycleState) => {
51
+ scale: number;
52
+ alpha: number;
53
+ };
@@ -0,0 +1,25 @@
1
+ import { WeatherConfig, WeatherType } from './types';
2
+ /** 雾浓度:1 薄雾 · 2 中雾 · 3 浓雾(整体偏淡,避免铺满白屏) */
3
+ export type FogLevel = 1 | 2 | 3;
4
+ export declare const DEFAULT_FOG_LEVEL: FogLevel;
5
+ export declare const FOG_LEVEL_LABELS: readonly ["", "薄雾", "中雾", "浓雾"];
6
+ export declare const clampFogLevel: (level: number) => FogLevel;
7
+ export declare const formatFogLevel: (level: number) => string;
8
+ export declare const supportsFogLevel: (weather: WeatherType) => weather is "fog";
9
+ /**
10
+ * 按浓度档调节雾团数量与霾层。
11
+ * 相对旧版整体降一档:新浓雾≈旧中雾,新中雾≈旧薄雾,新薄雾再淡一档。
12
+ */
13
+ export declare const intensifyFogConfig: (cfg: WeatherConfig, level: number) => WeatherConfig;
14
+ /** 雾团单层透明度倍率(与浓度档配套,减轻叠层发白) */
15
+ export declare const fogBankAlphaScale: (level: number) => number;
16
+ /**
17
+ * Open-Meteo WMO → 雾浓度。
18
+ * 45 雾 → 中雾;48 雾凇雾 → 浓雾。
19
+ */
20
+ export declare const fogLevelFromWmo: (code: number) => FogLevel | null;
21
+ /**
22
+ * 能见度(米)→ 雾浓度。
23
+ * ≥5km 薄雾 · 1~5km 中雾 · <1km 浓雾
24
+ */
25
+ export declare const fogLevelFromVisibility: (visibilityMeters: number | null | undefined) => FogLevel | null;
@@ -0,0 +1,24 @@
1
+ /** 冰雹强度:1 细雹 · 2 密雹 · 3 巨雹 */
2
+ export type HailLevel = 1 | 2 | 3;
3
+ export declare const DEFAULT_HAIL_LEVEL: HailLevel;
4
+ export declare const HAIL_LEVEL_LABELS: readonly ["", "细雹", "密雹", "巨雹"];
5
+ export declare const clampHailLevel: (level: number) => HailLevel;
6
+ export declare const formatHailLevel: (level: number) => string;
7
+ export declare const supportsHailLevel: (weather: string) => weather is "hail";
8
+ export interface HailIntensitySpec {
9
+ /** 冰雹粒子数量 */
10
+ count: number;
11
+ /** 半径下限 */
12
+ sizeMin: number;
13
+ /** 半径上限 */
14
+ sizeMax: number;
15
+ /** 下落速度倍率 */
16
+ speedMul: number;
17
+ }
18
+ /** 三档冰雹视觉参数 */
19
+ export declare const hailSpec: (level: number) => HailIntensitySpec;
20
+ /**
21
+ * Open-Meteo WMO → 冰雹强度。
22
+ * 96 雷暴伴冰雹 → 密雹;99 强雷暴伴冰雹 → 巨雹。
23
+ */
24
+ export declare const hailLevelFromWmo: (code: number) => HailLevel | null;
@@ -1,4 +1,9 @@
1
+ import { DayCycleTimes } from './day-cycle';
1
2
  import { WeatherType } from './index';
3
+ import { FogLevel } from './fog';
4
+ import { HailLevel } from './hail-level';
5
+ import { PrecipLevel } from './precipitation';
6
+ import { SmogLevel } from './smog';
2
7
  export interface OpenMeteoCurrent {
3
8
  /** Open-Meteo 精简天气码(WMO WW 子集,非完整 4677) */
4
9
  weatherCode: number;
@@ -8,25 +13,69 @@ export interface OpenMeteoCurrent {
8
13
  isDay: boolean;
9
14
  latitude: number;
10
15
  longitude: number;
16
+ /** 当地时区(IANA,如 Asia/Shanghai),来自 Open-Meteo timezone=auto */
17
+ timezone: string | null;
18
+ /** 观测时刻(当地墙钟 HH:mm) */
19
+ localTime: string | null;
20
+ /** 能见度(米);可能缺失 */
21
+ visibility: number | null;
22
+ /** 实况雨量档 1~10;非雨为 null */
23
+ rainLevel: PrecipLevel | null;
24
+ /** 实况雪量档 1~10;非雪为 null */
25
+ snowLevel: PrecipLevel | null;
26
+ /** 实况雾浓度 1~3;非雾为 null */
27
+ fogLevel: FogLevel | null;
28
+ /** 实况冰雹强度 1~3;非冰雹为 null */
29
+ hailLevel: HailLevel | null;
30
+ /** 实况霾强度 1~3;非霾为 null */
31
+ smogLevel: SmogLevel | null;
32
+ /** 当日日出(ms),来自 Open-Meteo daily */
33
+ sunrise: number | null;
34
+ /** 当日日落(ms),来自 Open-Meteo daily */
35
+ sunset: number | null;
11
36
  }
12
37
  export type LiveWeatherStatus = 'idle' | 'locating' | 'fetching' | 'success' | 'error';
13
38
  export interface LiveWeatherState {
14
39
  /** 映射后的组件天气类型,成功前为 null */
15
40
  weather: WeatherType | null;
41
+ /** 实况雨量档;非雨天为 null */
42
+ rainLevel: PrecipLevel | null;
43
+ /** 实况雪量档;非雪天为 null */
44
+ snowLevel: PrecipLevel | null;
45
+ /** 实况雾浓度;非雾天为 null */
46
+ fogLevel: FogLevel | null;
47
+ /** 实况冰雹强度;非冰雹为 null */
48
+ hailLevel: HailLevel | null;
49
+ /** 实况霾强度;非霾天为 null */
50
+ smogLevel: SmogLevel | null;
16
51
  status: LiveWeatherStatus;
17
52
  error: string | null;
18
53
  /** Open-Meteo 原始实况数据 */
19
54
  current: OpenMeteoCurrent | null;
20
55
  }
21
- /** Open-Meteo / WMO 精简天气码 → WeatherType;无降水且风速达强风时映射为大风 */
22
- export declare const mapWmoCodeToWeatherType: (code: number, windSpeedKmh?: number) => WeatherType;
56
+ /** Open-Meteo / WMO 精简天气码 → WeatherType */
57
+ export declare const mapWmoCodeToWeatherType: (code: number) => WeatherType;
23
58
  export interface LiveWeatherCoords {
24
59
  latitude: number;
25
60
  longitude: number;
26
61
  }
62
+ /**
63
+ * 按 IANA 时区取当前当地 HH:mm(用于实况滑块随时钟走动)。
64
+ * 时区无效时回退到 observationLocalTime。
65
+ */
66
+ export declare const formatLocalHm: (timeZone: string | null | undefined, fallbackHm?: string | null) => string | null;
67
+ /** 从实况结果取出日弧用的日出日落;缺省时返回 null */
68
+ export declare const getDayCycleTimesFromLive: (current: OpenMeteoCurrent | null) => DayCycleTimes | null;
27
69
  /**
28
70
  * Open-Meteo 实况天气。
29
71
  * 传入 coords 时直接按该经纬度查询;未传时使用浏览器定位(需 HTTPS 与用户授权)。
30
72
  * 失败时 status 为 error,调用方自行回退。
31
73
  */
32
74
  export declare const useLiveWeather: (enabled?: boolean, coords?: LiveWeatherCoords) => LiveWeatherState;
75
+ /** 拉取指定经纬度当日日出日落(Open-Meteo daily) */
76
+ export declare const fetchSunTimes: (lat: number, lon: number, signal?: AbortSignal) => Promise<DayCycleTimes | null>;
77
+ /**
78
+ * 按经纬度获取当地日出日落,用于 `time` 参数判断昼夜。
79
+ * 未传 coords 或请求失败时不更新(调用方回退 approximateDayCycleTimes)。
80
+ */
81
+ export declare const useSunTimes: (coords?: LiveWeatherCoords) => DayCycleTimes | null;
@@ -0,0 +1,51 @@
1
+ import { WeatherConfig, WeatherType } from './types';
2
+ /** 雨量/雪量档位:1~10,5~6 为中雨/中雪 */
3
+ export type PrecipLevel = number;
4
+ export declare const MIN_PRECIP_LEVEL = 1;
5
+ export declare const MAX_PRECIP_LEVEL = 10;
6
+ export declare const DEFAULT_RAIN_LEVEL = 5;
7
+ export declare const DEFAULT_SNOW_LEVEL = 5;
8
+ export declare const clampPrecipLevel: (level: number) => number;
9
+ /**
10
+ * 五档强度:
11
+ * 1~2 毛毛 · 3~4 小 · 5~6 中 · 7~8 暴 · 9~10 特大暴
12
+ */
13
+ export declare const precipBand: (level: number) => 1 | 2 | 3 | 4 | 5;
14
+ export declare const precipLabel: (level: number, kind: "rain" | "snow") => string;
15
+ /** 滑块文案,如 `5 · 中雨` */
16
+ export declare const formatPrecipLevel: (level: number, kind: "rain" | "snow") => string;
17
+ /** @deprecated 请用 precipLabel / formatPrecipLevel */
18
+ export declare const RAIN_LEVEL_LABELS: readonly ["", "毛毛雨", "小雨", "中雨", "暴雨", "特大暴雨"];
19
+ /** @deprecated 请用 precipLabel / formatPrecipLevel */
20
+ export declare const SNOW_LEVEL_LABELS: readonly ["", "毛毛雪", "小雪", "中雪", "暴雪", "特大暴雪"];
21
+ /** 对外展示用天气(小/中/大雨雪 → 雨天/雪天) */
22
+ export declare const normalizeWeatherType: (weather: WeatherType) => WeatherType;
23
+ export declare const isRainWeather: (weather: WeatherType) => weather is "rain" | "lightRain" | "moderateRain" | "heavyRain";
24
+ export declare const isSnowWeather: (weather: WeatherType) => weather is "snow" | "lightSnow" | "moderateSnow" | "heavySnow";
25
+ /** 可调节雨量:雨天 + 雷阵雨 + 雨夹雪 */
26
+ export declare const supportsRainLevel: (weather: WeatherType) => weather is "rain" | "lightRain" | "moderateRain" | "heavyRain" | "thunderstorm" | "sleet";
27
+ /** 可调节雪量:雪天 + 雨夹雪 */
28
+ export declare const supportsSnowLevel: (weather: WeatherType) => weather is "snow" | "lightSnow" | "moderateSnow" | "heavySnow" | "sleet";
29
+ /** 从旧版细分天气类型推断雨量档(映射到 1~10) */
30
+ export declare const rainLevelFromWeather: (weather: WeatherType, fallback?: number) => number;
31
+ /** 从旧版细分天气类型推断雪量档(映射到 1~10) */
32
+ export declare const snowLevelFromWeather: (weather: WeatherType, fallback?: number) => number;
33
+ /**
34
+ * 将对外 weather + 雨/雪量解析为内部 CONFIGS 键(天空/云层)。
35
+ * 粒子密度另由 intensifyRainConfig / intensifySnowCount 按 1~10 连续插值。
36
+ */
37
+ export declare const resolveSceneWeather: (weather: WeatherType, rainLevel?: number, snowLevel?: number) => WeatherType;
38
+ /** 按 1~10 档连续插值雨丝参数(毛毛雨极淡 → 特大暴雨极密) */
39
+ export declare const intensifyRainConfig: (rain: NonNullable<WeatherConfig["rain"]>, level: number) => NonNullable<WeatherConfig["rain"]>;
40
+ /** 按 1~10 档连续插值雪花数量 */
41
+ export declare const intensifySnowCount: (level: number) => number;
42
+ /**
43
+ * Open-Meteo WMO 码 → 雨量档 1~10;非雨返回 null。
44
+ * 毛毛雨→2,小雨→3,中雨→5,暴雨→8,特大→10
45
+ */
46
+ export declare const rainLevelFromWmo: (code: number) => number | null;
47
+ /**
48
+ * Open-Meteo WMO 码 → 雪量档 1~10;非雪返回 null。
49
+ * 毛毛雪→2,小雪→3,中雪→5,暴雪→8,特大→10
50
+ */
51
+ export declare const snowLevelFromWmo: (code: number) => number | null;
@@ -1,3 +1,5 @@
1
+ import { DayCycleState, DayCycleTimes } from '../day-cycle';
2
+ import { HailIntensitySpec } from '../hail-level';
1
3
  import { CelestialSprite, FogSprite, SceneState, WeatherConfig, WeatherSceneParams } from '../types';
2
4
  export interface WeatherSceneLayout {
3
5
  sky: [string, string];
@@ -8,8 +10,35 @@ export interface WeatherSceneLayout {
8
10
  sunR: number;
9
11
  skyGradient: CanvasGradient;
10
12
  celestial: CelestialSprite | null;
13
+ sunSprite: CelestialSprite | null;
14
+ moonSprite: CelestialSprite | null;
11
15
  fogSprite: FogSprite | null;
16
+ dayCycleTimes: DayCycleTimes | null;
17
+ dayCycle: DayCycleState | null;
18
+ sceneTimeMs: number;
19
+ liveClock: boolean;
20
+ hailSpec: HailIntensitySpec | null;
12
21
  }
13
22
  export declare function createSceneState(params: WeatherSceneParams): WeatherSceneLayout & {
14
23
  state: SceneState;
15
24
  };
25
+ /** 按时刻刷新日弧位置、天空与日/月切换 */
26
+ export declare function applyDayCycleToScene(scene: {
27
+ ctx: CanvasRenderingContext2D;
28
+ width: number;
29
+ height: number;
30
+ activeNight: boolean;
31
+ sky: [string, string];
32
+ skyGradient: CanvasGradient;
33
+ sunX: number;
34
+ sunY: number;
35
+ celestial: CelestialSprite | null;
36
+ sunSprite: CelestialSprite | null;
37
+ moonSprite: CelestialSprite | null;
38
+ dayCycleTimes: DayCycleTimes | null;
39
+ dayCycle: DayCycleState | null;
40
+ sceneTimeMs: number;
41
+ liveClock: boolean;
42
+ cfg: WeatherConfig;
43
+ activeWeather: import('../types').WeatherType;
44
+ }, nowMs?: number): void;