@cos-design/weather-background 3.5.2 → 3.5.4
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.
- package/dist/index.cjs +1 -1
- package/dist/index.js +715 -221
- package/dist/packages/weatherBackground/src/index.d.ts +11 -1
- package/dist/src/components/weatherBackground/day-cycle.d.ts +53 -0
- package/dist/src/components/weatherBackground/fog.d.ts +25 -0
- package/dist/src/components/weatherBackground/hail-level.d.ts +24 -0
- package/dist/src/components/weatherBackground/live-weather.d.ts +51 -2
- package/dist/src/components/weatherBackground/precipitation.d.ts +51 -0
- package/dist/src/components/weatherBackground/scene/init-state.d.ts +29 -0
- package/dist/src/components/weatherBackground/scene/runtime.d.ts +19 -2
- package/dist/src/components/weatherBackground/smog.d.ts +17 -0
- package/dist/src/components/weatherBackground/sprites/hail.d.ts +8 -2
- package/dist/src/components/weatherBackground/types.d.ts +63 -9
- package/dist/src/components/weatherBackground/wind.d.ts +68 -0
- package/package.json +2 -2
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
export { default } from '../../../src/components/weatherBackground';
|
|
2
2
|
export { default as WeatherBackground } from '../../../src/components/weatherBackground';
|
|
3
3
|
export type * from '../../../src/components/weatherBackground';
|
|
4
|
-
export { mapWmoCodeToWeatherType, useLiveWeather } from '../../../src/components/weatherBackground/live-weather';
|
|
4
|
+
export { formatLocalHm, mapWmoCodeToWeatherType, useLiveWeather, useSunTimes } from '../../../src/components/weatherBackground/live-weather';
|
|
5
5
|
export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent } from '../../../src/components/weatherBackground/live-weather';
|
|
6
|
+
export { DEFAULT_FOG_LEVEL, FOG_LEVEL_LABELS, clampFogLevel, fogBankAlphaScale, fogLevelFromVisibility, fogLevelFromWmo, formatFogLevel, intensifyFogConfig, supportsFogLevel } from '../../../src/components/weatherBackground/fog';
|
|
7
|
+
export type { FogLevel } from '../../../src/components/weatherBackground/fog';
|
|
8
|
+
export { DEFAULT_HAIL_LEVEL, HAIL_LEVEL_LABELS, clampHailLevel, formatHailLevel, hailLevelFromWmo, hailSpec, supportsHailLevel } from '../../../src/components/weatherBackground/hail-level';
|
|
9
|
+
export type { HailIntensitySpec, HailLevel } from '../../../src/components/weatherBackground/hail-level';
|
|
10
|
+
export { DEFAULT_SMOG_LEVEL, SMOG_LEVEL_LABELS, clampSmogLevel, formatSmogLevel, intensifySmogConfig, smogBankAlphaScale, smogLevelFromVisibility, supportsSmogLevel } from '../../../src/components/weatherBackground/smog';
|
|
11
|
+
export type { SmogLevel } from '../../../src/components/weatherBackground/smog';
|
|
12
|
+
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 '../../../src/components/weatherBackground/precipitation';
|
|
13
|
+
export type { PrecipLevel } from '../../../src/components/weatherBackground/precipitation';
|
|
14
|
+
export { DEFAULT_WIND_LEVEL, buildWindMotion, kmhToWindLevel, sampleWindField, visualWindLevel, windLevelToKmh, windStreakSpec } from '../../../src/components/weatherBackground/wind';
|
|
15
|
+
export type { WindFieldSample, WindMotion } from '../../../src/components/weatherBackground/wind';
|
|
@@ -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
|
|
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;
|
|
@@ -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
|
-
/**
|
|
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
|
|
5
|
-
|
|
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
|
-
|
|
2
|
-
|
|
3
|
-
| '
|
|
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
|
|
25
|
+
/** 天气类型:sunny / partlyCloudy / overcast / rain 雨天 / thunderstorm / fog / snow 雪天 / sleet / hail / smog;雨量用 rainLevel,雪量用 snowLevel,风效用 windLevel */
|
|
8
26
|
weather?: WeatherType;
|
|
9
|
-
/**
|
|
10
|
-
|
|
11
|
-
|
|
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
|
-
/**
|
|
34
|
+
/** 纬度(-90 ~ 90):用于日出日落与昼夜判定;live 未配置时可跳过浏览器定位 */
|
|
14
35
|
latitude?: number;
|
|
15
|
-
/**
|
|
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/weather-background",
|
|
3
|
-
"version": "3.5.
|
|
3
|
+
"version": "3.5.4",
|
|
4
4
|
"description": "WeatherBackground component from cos-design",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -52,6 +52,6 @@
|
|
|
52
52
|
"registry": "https://registry.npmjs.org"
|
|
53
53
|
},
|
|
54
54
|
"dependencies": {
|
|
55
|
-
"@cos-design/shared": "3.5.
|
|
55
|
+
"@cos-design/shared": "3.5.3"
|
|
56
56
|
}
|
|
57
57
|
}
|