cos-design 3.7.11 → 3.8.1

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 (30) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +13 -8
  3. package/dist/index.cjs +159 -3
  4. package/dist/index.css +1 -1
  5. package/dist/index.js +4461 -2013
  6. package/dist/src/components/auroraVeil/index.d.ts +19 -0
  7. package/dist/src/components/dandelionField/constants.d.ts +72 -0
  8. package/dist/src/components/dandelionField/draw.d.ts +33 -0
  9. package/dist/src/components/dandelionField/frame-cache.d.ts +22 -0
  10. package/dist/src/components/dandelionField/index.d.ts +5 -0
  11. package/dist/src/components/dandelionField/plant.d.ts +106 -0
  12. package/dist/src/components/dandelionField/scene.d.ts +13 -0
  13. package/dist/src/components/dandelionField/seed.d.ts +15 -0
  14. package/dist/src/components/dandelionField/types.d.ts +193 -0
  15. package/dist/src/components/dandelionField/utils.d.ts +18 -0
  16. package/dist/src/components/index.d.ts +10 -0
  17. package/dist/src/components/inkBloom/index.d.ts +21 -0
  18. package/dist/src/components/lavaBubble/gl.d.ts +3 -0
  19. package/dist/src/components/lavaBubble/index.d.ts +24 -0
  20. package/dist/src/components/lavaBubble/shaders.d.ts +2 -0
  21. package/dist/src/components/lavaBubble/sim.d.ts +60 -0
  22. package/dist/src/components/soapBubbles/draw-bubble.d.ts +20 -0
  23. package/dist/src/components/soapBubbles/film.d.ts +8 -0
  24. package/dist/src/components/soapBubbles/index.d.ts +20 -0
  25. package/dist/src/components/soapBubbles/lighting.d.ts +34 -0
  26. package/dist/src/components/soapBubbles/merge.d.ts +50 -0
  27. package/dist/src/components/soapBubbles/sky.d.ts +2 -0
  28. package/dist/src/components/soapBubbles/types.d.ts +40 -0
  29. package/dist/src/components/soapBubbles/utils.d.ts +12 -0
  30. package/package.json +1 -1
@@ -0,0 +1,19 @@
1
+ import { default as React } from 'react';
2
+ export interface AuroraVeilProps {
3
+ width?: number;
4
+ height?: number;
5
+ /** 为 true 时铺满父容器(父级需有明确高度) */
6
+ fill?: boolean;
7
+ /** 光带颜色列表 */
8
+ colors?: string[];
9
+ /** 光带数量,默认 5 */
10
+ bandCount?: number;
11
+ /** 运动速度倍率 0~3,默认 1 */
12
+ speed?: number;
13
+ /** 是否响应指针交互,默认 true */
14
+ interactive?: boolean;
15
+ /** 画布无障碍标签 */
16
+ ariaLabel?: string;
17
+ }
18
+ declare const AuroraVeil: React.FC<AuroraVeilProps>;
19
+ export default AuroraVeil;
@@ -0,0 +1,72 @@
1
+ export declare const PHASE: {
2
+ readonly WITHER: 3.8;
3
+ readonly SPROUT: 2.6;
4
+ readonly FLOWER: 4.8;
5
+ readonly PUFFING: 5.5;
6
+ };
7
+ /** 黄花/绒球花头视觉缩放 */
8
+ export declare const FLOWER_HEAD_GROW = 1.05;
9
+ /** 花头生命周期关键帧(归一化 0~1,区间可重叠以实现交叉渐变) */
10
+ export declare const HEAD_BLOOM_IN = 0.05;
11
+ export declare const HEAD_BLOOM_OUT = 0.46;
12
+ export declare const HEAD_WILT_IN = 0.54;
13
+ export declare const HEAD_WILT_OUT = 0.82;
14
+ /** 花托随凋谢渐显,与花心交叉渐变(非额外黑球) */
15
+ export declare const HEAD_RECEPTACLE_IN = 0.56;
16
+ export declare const HEAD_RECEPTACLE_OUT = 0.9;
17
+ /** 黄花视觉退场 ↔ 中心种子立刻起步(同一 wilt 阈值) */
18
+ export declare const FLOWER_WILT_YELLOW_END = 0.7;
19
+ export declare const PUFF_HEAD_START = 0.2;
20
+ export declare const MAX_PLANTS = 22;
21
+ export declare const MIN_PLANT_GAP = 0.06;
22
+ export declare const GERMINATION_CHANCE = 0.14;
23
+ export declare const GERMINATION_NEAR_CHANCE = 0.32;
24
+ export declare const NEAR_PARENT_RADIUS = 0.2;
25
+ /** 绒球成熟后静止时长(秒) */
26
+ export declare const MATURE_HOLD_MIN = 1;
27
+ export declare const MATURE_HOLD_MAX = 5;
28
+ /** 自然散种持续 3~5 秒 */
29
+ export declare const RELEASE_DURATION_MIN = 3;
30
+ export declare const RELEASE_DURATION_MAX = 5;
31
+ /** 干预_boost 最大倍率 */
32
+ export declare const RELEASE_BOOST_MULT = 14;
33
+ export declare const INTRO_DURATION = 3;
34
+ /** 落地后等待 1~2 秒再萌发 */
35
+ export declare const GERMINATION_DELAY_MIN = 1;
36
+ export declare const GERMINATION_DELAY_MAX = 2;
37
+ /** 未萌发种子在地面渐隐时长(秒量级,life 从 1 到 0) */
38
+ export declare const SEED_GROUND_FADE_RATE = 0.38;
39
+ /** 自然飘落时长 4~9 秒(按实际落地距离换算 px/s) */
40
+ export declare const SEED_FALL_DURATION_MIN = 4;
41
+ export declare const SEED_FALL_DURATION_MAX = 9;
42
+ /** 水平漂移倍率 */
43
+ export declare const SEED_DRIFT_SCALE = 54;
44
+ /** 垂直速度追随变化目标的惯性(越小越“自由”) */
45
+ export declare const SEED_VY_TRACK = 0.034;
46
+ /** 触地后缓冲贴地时长( settleT 0→1 ) */
47
+ export declare const SEED_SETTLE_SPEED = 2.4;
48
+ /** 茎干风摆弹簧刚度 / 阻尼 */
49
+ export declare const STEM_WIND_STIFF = 10.5;
50
+ export declare const STEM_WIND_DAMP = 4.6;
51
+ export declare const STEM_LIFT_STIFF = 6.5;
52
+ /** 绒球绒毛随风拖拽强度 */
53
+ export declare const FLUFF_WIND_DRAG = 0.38;
54
+ export declare const FLUFF_WIND_DRAG_Y = 0.46;
55
+ export declare const GRASS_WIND_STIFF = 13.5;
56
+ export declare const GRASS_WIND_DAMP = 5.4;
57
+ export declare const GRASS_LIFT_STIFF = 7.8;
58
+ export declare const GRASS_IDLE_AMP = 0.038;
59
+ /** 草地风摆视觉幅度倍率 */
60
+ export declare const GRASS_WIND_AMP = 0.32;
61
+ export declare const GOLDEN: number;
62
+ /** 茎底竖直段占全长比例(草图:先竖直再弯) */
63
+ export declare const STEM_BASE_VERTICAL = 0.4;
64
+ /** 茎尖最大倾角(草图:顶部轻弯,不大角度) */
65
+ export declare const STEM_TIP_MAX_TILT: number;
66
+ /** 茎干受风弯曲强度(0~1,越小越 stiff) */
67
+ export declare const STEM_WIND_BEND = 0.42;
68
+ /** 茎干垂直风摆强度(独立控制,通常远小于水平) */
69
+ export declare const STEM_WIND_LIFT = 0.18;
70
+ /** 吹落绒球种子:最低移速(px/帧)与对应 gust,低于此仅视觉风效、不触发散种 */
71
+ export declare const WIND_BLOW_SPEED_MIN = 9;
72
+ export declare const WIND_BLOW_GUST_MIN = 0.58;
@@ -0,0 +1,33 @@
1
+ import { Plant, Seed } from './types';
2
+ export declare const drawRosetteLeaves: (ctx: CanvasRenderingContext2D, plant: Plant) => void;
3
+ export declare const drawStem: (ctx: CanvasRenderingContext2D, plant: Plant) => void;
4
+ export declare const drawFlowerBud: (ctx: CanvasRenderingContext2D, head: {
5
+ x: number;
6
+ y: number;
7
+ }, scale: number, fade: number, sizeT: number, openT: number, plantId: number) => void;
8
+ export declare const drawFlowerReceptacle: (ctx: CanvasRenderingContext2D, head: {
9
+ x: number;
10
+ y: number;
11
+ }, scale: number, alpha: number, strength: number, puff?: number) => void;
12
+ export declare const drawFlowerBloomGlow: (ctx: CanvasRenderingContext2D, head: {
13
+ x: number;
14
+ y: number;
15
+ }, scale: number, alpha: number) => void;
16
+ export declare const drawYellowFlower: (ctx: CanvasRenderingContext2D, head: {
17
+ x: number;
18
+ y: number;
19
+ }, scale: number, fade: number, transition?: number, curl?: number) => void;
20
+ export declare const drawPlantHead: (ctx: CanvasRenderingContext2D, plant: Plant, head: {
21
+ x: number;
22
+ y: number;
23
+ }) => void;
24
+ export declare const drawHeadGlow: (ctx: CanvasRenderingContext2D, head: {
25
+ x: number;
26
+ y: number;
27
+ }, radius: number, alpha: number) => void;
28
+ export declare const drawWitheredStub: (ctx: CanvasRenderingContext2D, head: {
29
+ x: number;
30
+ y: number;
31
+ }, plant: Plant) => void;
32
+ export declare const drawEmergingPappus: (ctx: CanvasRenderingContext2D, seed: Seed, s: number, fluffLen: number, alpha: number, time: number) => void;
33
+ export declare const drawSeed: (ctx: CanvasRenderingContext2D, fluff: HTMLCanvasElement, seed: Seed, time: number, staticFrame: boolean, reveal: number, plantFade: number, growing?: boolean, fluffLen?: number) => void;
@@ -0,0 +1,22 @@
1
+ import { HeadLifecycle, Plant, StemCurve } from './types';
2
+ export interface PlantFrame {
3
+ curve: StemCurve;
4
+ head: StemCurve['head'];
5
+ life: HeadLifecycle;
6
+ }
7
+ /** 每帧缓存植株几何与花头生命周期,避免重复计算 */
8
+ export declare class PlantFrameCache {
9
+ private cache;
10
+ get(plant: Plant): PlantFrame;
11
+ clear(): void;
12
+ }
13
+ /** 跟踪每株附着种子数量,避免每帧 filter 统计 */
14
+ export declare class AttachedSeedTracker {
15
+ private counts;
16
+ increment(plantId: number, amount?: number): void;
17
+ decrement(plantId: number): void;
18
+ remove(plantId: number): void;
19
+ get(plantId: number): number;
20
+ has(plantId: number): boolean;
21
+ clear(): void;
22
+ }
@@ -0,0 +1,5 @@
1
+ import { default as React } from 'react';
2
+ import { DandelionFieldProps } from './types';
3
+ export type { DandelionFieldProps } from './types';
4
+ declare const DandelionField: React.FC<DandelionFieldProps>;
5
+ export default DandelionField;
@@ -0,0 +1,106 @@
1
+ import { HeadLifecycle, IntroSpawn, Plant, PlantLayout, Seed } from './types';
2
+ export declare const sproutLife: (stemLenRatio?: number, phaseTime?: number) => {
3
+ phase: "sprout";
4
+ phaseTime: number;
5
+ grow: number;
6
+ puffReveal: number;
7
+ stemLenRatio: number;
8
+ leafScale: number;
9
+ fade: number;
10
+ wilt: number;
11
+ stemBrown: number;
12
+ };
13
+ export declare const matureLife: () => {
14
+ phase: "mature";
15
+ phaseTime: number;
16
+ grow: number;
17
+ puffReveal: number;
18
+ stemLenRatio: number;
19
+ leafScale: number;
20
+ fade: number;
21
+ wilt: number;
22
+ stemBrown: number;
23
+ };
24
+ export declare const rollMatureHold: () => number;
25
+ export declare const rollReleaseDuration: (plantId: number) => number;
26
+ export declare const buildIntroQueue: (count: number, width: number, height: number, baseSeedCount: number) => IntroSpawn[];
27
+ export declare const placeSeed: (i: number, n: number, radius: number) => {
28
+ lx: number;
29
+ ly: number;
30
+ lz: number;
31
+ };
32
+ export declare const plantDepthAlpha: (plant: Plant) => number;
33
+ /** 茎尖高度系数:始终用完整 stemLen,避免 flower→puffing 时茎干突然变短 */
34
+ export declare const headGrowFactor: () => number;
35
+ /** 绒球花头视觉(puffing 与 mature 共用,避免阶段切换突变) */
36
+ export declare const puffBallHeadAt: (puff: number) => HeadLifecycle;
37
+ export declare const puffBallSeedMotion: (plant: Plant, puff: number, seed: Seed) => {
38
+ reveal: number;
39
+ expand: number;
40
+ fluffLen: number;
41
+ };
42
+ /** 统一花头时间线:各阶段权重交叉渐变,避免突变 */
43
+ export declare const headLifecycle: (plant: Plant) => HeadLifecycle;
44
+ export declare const stemBendSeed: (id: number, x: number) => number;
45
+ export declare const stemBendTraits: (seed: number) => {
46
+ stemBendX: number;
47
+ stemBendY: number;
48
+ stemBend2X: number;
49
+ stemBend2Y: number;
50
+ };
51
+ export declare const randomStemBendTraits: () => {
52
+ stemBendX: number;
53
+ stemBendY: number;
54
+ stemBend2X: number;
55
+ stemBend2Y: number;
56
+ };
57
+ /** 茎身弯度随抽茎进度 0→1,开花时继续缓慢到位 */
58
+ export declare const stemCurveAmount: (plant: Plant) => number;
59
+ /** 茎尖水平偏移:个体方向 × 弯度,带上限(风摆由 stemWindOffset 单独叠加) */
60
+ export declare const stemTipOffsetX: (plant: Plant, rise: number, curveT: number) => number;
61
+ /** 茎干风摆:弹簧阻尼追随风向,底部硬、顶部软(在 stemWindOffset 体现) */
62
+ export declare const updateStemWind: (plant: Plant, wind: {
63
+ x: number;
64
+ y: number;
65
+ }, idle: number, dt: number) => void;
66
+ /** 绒球绒毛:外圈轻、滞后大;弹簧回拉 + 风向拖拽 + 微幅紊流 */
67
+ export declare const updateAttachedFluff: (seed: Seed, plant: Plant, wind: {
68
+ x: number;
69
+ y: number;
70
+ }, time: number, dt: number, onPuffBall: boolean, plantRadius: number) => {
71
+ offX: number;
72
+ offY: number;
73
+ tiltX: number;
74
+ tiltY: number;
75
+ };
76
+ /** 风力导致的茎尖位移(随风向弯曲,随茎高放大) */
77
+ export declare const stemWindStrength: (plant: Plant) => 1 | 0.45 | 0.62;
78
+ export declare const stemWindOffset: (plant: Plant, rise: number) => {
79
+ dx: number;
80
+ dy: number;
81
+ };
82
+ /** 茎干几何:底段竖直出土,上段随高度渐弯(见用户草图) */
83
+ export declare const stemCurveGeometry: (plant: Plant) => {
84
+ base: {
85
+ x: number;
86
+ y: number;
87
+ };
88
+ cp1: {
89
+ x: number;
90
+ y: number;
91
+ };
92
+ cp2: {
93
+ x: number;
94
+ y: number;
95
+ };
96
+ head: {
97
+ x: number;
98
+ y: number;
99
+ };
100
+ };
101
+ export declare const buildPlantTraits: (x: number, ground: number, height: number, baseSeedCount: number, id: number) => PlantLayout;
102
+ type PlantLife = ReturnType<typeof sproutLife> | ReturnType<typeof matureLife>;
103
+ export type { PlantLife };
104
+ export declare const makePlant: (layout: PlantLayout, id: number, life: PlantLife) => Plant;
105
+ /** 随机散布位置,保证最小间距,避免均匀排布 */
106
+ export declare const scatterPlantLayouts: (count: number, width: number, height: number, baseSeedCount: number) => PlantLayout[];
@@ -0,0 +1,13 @@
1
+ import { GrassTuftDef, GrassTuftWind } from './types';
2
+ /** 静态天空 + 草地底色(不含草叶,草叶单独每帧绘制以响应风) */
3
+ export declare const buildSceneBackdrop: (width: number, height: number) => HTMLCanvasElement;
4
+ export declare const grassFadeAt: (y: number, height: number, grassStart: number) => number;
5
+ /** 预生成草簇布局(确定性,每帧只重绘形态) */
6
+ export declare const buildGrassField: (width: number, height: number) => GrassTuftDef[];
7
+ /** 每簇草独立弹簧阻尼,追随风向并带自然回弹 */
8
+ export declare const updateGrassFieldWind: (states: GrassTuftWind[], tufts: GrassTuftDef[], wind: {
9
+ x: number;
10
+ y: number;
11
+ speed: number;
12
+ }, time: number, dt: number) => void;
13
+ export declare const drawGrassField: (ctx: CanvasRenderingContext2D, tufts: GrassTuftDef[], states: GrassTuftWind[], height: number, time: number) => void;
@@ -0,0 +1,15 @@
1
+ import { Plant, Seed } from './types';
2
+ /** 绒球从中心向外展开:reveal 透明度 · expand 径向位置 · fluffLen 绒毛长度 */
3
+ export declare const puffSeedMotion: (plant: Plant, seed: Seed) => {
4
+ reveal: number;
5
+ expand: number;
6
+ fluffLen: number;
7
+ };
8
+ /** 绒球飘降时忽快忽慢的垂直目标速度 */
9
+ export declare const seedFallTargetVy: (seed: Seed, time: number, wind: {
10
+ x: number;
11
+ y: number;
12
+ }, sway: number) => number;
13
+ export declare const appendSeedsForPlant: (seeds: Seed[], plant: Plant, attached: boolean) => void;
14
+ /** Silky pappus with radiating hairs and a brown achene — photorealistic seed sprite */
15
+ export declare const makePappusSprite: () => HTMLCanvasElement;
@@ -0,0 +1,193 @@
1
+ export interface DandelionFieldProps {
2
+ width?: number;
3
+ height?: number;
4
+ /** 为 true 时铺满父容器(父级需有明确高度) */
5
+ fill?: boolean;
6
+ /** 初始批次蒲公英株数(入场批次,之后随种子落地自由增减),默认 10 */
7
+ plantCount?: number;
8
+ /** 每株种子数,默认 32 */
9
+ seedCount?: number;
10
+ /** 运动速度倍率 0~3,默认 1 */
11
+ speed?: number;
12
+ /** 是否响应指针交互,默认 true */
13
+ interactive?: boolean;
14
+ /** 画布无障碍标签 */
15
+ ariaLabel?: string;
16
+ }
17
+ export interface Seed {
18
+ plantId: number;
19
+ attached: boolean;
20
+ /** 脱离母体后是否具备萌发可能 */
21
+ canGerminate: boolean;
22
+ /** 散种原点,用于在母株周围萌发 */
23
+ originX?: number;
24
+ originGround?: number;
25
+ lx: number;
26
+ ly: number;
27
+ lz: number;
28
+ x: number;
29
+ y: number;
30
+ vx: number;
31
+ vy: number;
32
+ rot: number;
33
+ spin: number;
34
+ life: number;
35
+ size: number;
36
+ hairPhase: number;
37
+ /** 自然散种预定时刻(秒,相对 beginReleasing) */
38
+ scheduledRelease?: number;
39
+ /** 是否已落到地面 */
40
+ landed: boolean;
41
+ /** 落地时刻(秒),未落地为 -1 */
42
+ landedAt: number;
43
+ /** 落地后等待萌发时长 1~2 秒 */
44
+ germinateDelay: number;
45
+ /** 是否已完成萌发判定 */
46
+ germinateChecked: boolean;
47
+ /** 着地缓冲 0=飞行 · 0~1=贴地缓冲 · 1=静止 */
48
+ settleT: number;
49
+ /** 落点地面 Y,未触地为 -1 */
50
+ restGroundY: number;
51
+ /** 飘飞侧摆相位 */
52
+ swayPhase: number;
53
+ /** 个体终端下落速度(px/s) */
54
+ terminalVy: number;
55
+ /** 个体侧向漂移偏置 */
56
+ driftBias: number;
57
+ /** 景深 0=远 1=近,决定落点地面高度 */
58
+ depth: number;
59
+ /** 垂直飘动频率(个体化) */
60
+ fallFreqA: number;
61
+ fallFreqB: number;
62
+ /** 附着时随风相对花头的滞后偏移 */
63
+ fluffOx: number;
64
+ fluffOy: number;
65
+ }
66
+ export type PlantPhase = 'mature' | 'wither' | 'sprout' | 'flower' | 'puffing';
67
+ export interface Plant {
68
+ id: number;
69
+ x: number;
70
+ ground: number;
71
+ /** 完全长成的茎高 */
72
+ stem: number;
73
+ /** 当前可见茎长(萌芽时从 0 增长) */
74
+ stemLen: number;
75
+ sway: number;
76
+ /** 垂直风摆(鼠标上下) */
77
+ windLift: number;
78
+ /** 水平/垂直风摆角速度(弹簧阻尼) */
79
+ swayVel: number;
80
+ liftVel: number;
81
+ /** 个体风摆相位 */
82
+ swayPhase: number;
83
+ /** 个体风摆幅度 */
84
+ swayAmp: number;
85
+ /** 花头 / 绒球缩放 */
86
+ grow: number;
87
+ radius: number;
88
+ lean: number;
89
+ stemBendX: number;
90
+ stemBendY: number;
91
+ stemBend2X: number;
92
+ stemBend2Y: number;
93
+ depth: number;
94
+ /** 个体整体缩放 */
95
+ scale: number;
96
+ /** 本株种子数量(随大小变化) */
97
+ seedQuota: number;
98
+ /** mature=绒球期 · wither=凋谢 · sprout=抽茎 · flower=黄花 · puffing=转白 */
99
+ phase: PlantPhase;
100
+ phaseTime: number;
101
+ /** 茎干下垂 0~1 */
102
+ wilt: number;
103
+ /** 整体透明度 0~1 */
104
+ fade: number;
105
+ /** 绒球饱满度 0~1,控制种子渐显 */
106
+ puffReveal: number;
107
+ /** 基生叶展开 0~1 */
108
+ leafScale: number;
109
+ /** 茎色 0=绿 1=枯褐 */
110
+ stemBrown: number;
111
+ /** 绒球成熟后静止倒计时(秒),≤0 时开始自然散种;-1 表示未进入成熟期 */
112
+ matureHoldLeft: number;
113
+ /** 散种持续时长 3~5 秒 */
114
+ releaseDuration: number;
115
+ /** 散种已进行时间 */
116
+ releaseElapsed: number;
117
+ /** 开始散种时的种子总数 */
118
+ releaseSeedTotal: number;
119
+ /** 是否正在散种 */
120
+ releasing: boolean;
121
+ /** 人为干预加速散种 0~4 */
122
+ releaseBoost: number;
123
+ }
124
+ export interface PlantLayout {
125
+ x: number;
126
+ ground: number;
127
+ stem: number;
128
+ radius: number;
129
+ lean: number;
130
+ stemBendX: number;
131
+ stemBendY: number;
132
+ stemBend2X: number;
133
+ stemBend2Y: number;
134
+ depth: number;
135
+ scale: number;
136
+ seedQuota: number;
137
+ }
138
+ export interface IntroSpawn {
139
+ at: number;
140
+ layout: PlantLayout;
141
+ spawned: boolean;
142
+ }
143
+ export interface GrassTuftDef {
144
+ x: number;
145
+ y: number;
146
+ size: number;
147
+ alpha: number;
148
+ depth: number;
149
+ phase: number;
150
+ }
151
+ export interface GrassTuftWind {
152
+ sway: number;
153
+ swayVel: number;
154
+ lift: number;
155
+ liftVel: number;
156
+ }
157
+ export interface HeadLifecycle {
158
+ /** 闭合花苞体量 0~1 */
159
+ budSize: number;
160
+ /** 苞片展开 0~1 */
161
+ budOpen: number;
162
+ /** 黄花绽开 0~1 */
163
+ bloom: number;
164
+ /** 黄花凋谢卷曲 0~1 */
165
+ wilt: number;
166
+ /** 转白前花托 0~1 */
167
+ receptacle: number;
168
+ /** 绒球展开 0~1 */
169
+ puff: number;
170
+ /** 盛开光晕 0~1 */
171
+ glow: number;
172
+ }
173
+ export interface Point2 {
174
+ x: number;
175
+ y: number;
176
+ }
177
+ export interface StemCurve {
178
+ base: Point2;
179
+ cp1: Point2;
180
+ cp2: Point2;
181
+ head: Point2;
182
+ }
183
+ export interface WindState {
184
+ x: number;
185
+ y: number;
186
+ speed: number;
187
+ }
188
+ export interface SeedMotion {
189
+ reveal: number;
190
+ expand: number;
191
+ fluffLen: number;
192
+ }
193
+ export declare const MAX_DPR = 2;
@@ -0,0 +1,18 @@
1
+ export declare const hash: (n: number) => number;
2
+ export declare const easeOutCubic: (t: number) => number;
3
+ export declare const easeInOutCubic: (t: number) => number;
4
+ /** 平滑阶跃,用于交叉渐变 */
5
+ export declare const smoothstep: (edge0: number, edge1: number, x: number) => number;
6
+ export declare const softSat: (v: number, scale: number) => number;
7
+ export declare const lerpColor: (a: number, b: number, t: number) => number;
8
+ /** 鼠标帧移速 → 风力强度 0~1(约 14px/帧 视为满风) */
9
+ export declare const windGustFromSpeed: (pxPerFrame: number) => number;
10
+ /** 风力向量视觉强度(与 gust 解耦,避免风力衰减后绒毛立刻静止) */
11
+ export declare const windVisualStrength: (wind: {
12
+ x: number;
13
+ y: number;
14
+ }) => number;
15
+ /** 由落地 Y 反推景深,用于新株 */
16
+ export declare const depthFromGround: (ground: number, height: number) => number;
17
+ /** 由 X + 景深估算地面 Y(与植株布局公式一致) */
18
+ export declare const groundAt: (x: number, depth: number, height: number) => number;
@@ -112,6 +112,16 @@ export type { PlasmaBallProps } from './plasmaBall';
112
112
  export { default as SmokeFog } from './smokeFog';
113
113
  export { default as BubbleField } from './bubbleField';
114
114
  export type { BubbleFieldProps } from './bubbleField';
115
+ export { default as SoapBubbles } from './soapBubbles';
116
+ export type { SoapBubblesProps } from './soapBubbles';
117
+ export { default as DandelionField } from './dandelionField';
118
+ export type { DandelionFieldProps } from './dandelionField';
119
+ export { default as LavaBubble } from './lavaBubble';
120
+ export type { LavaBubbleProps } from './lavaBubble';
121
+ export { default as InkBloom } from './inkBloom';
122
+ export type { InkBloomProps } from './inkBloom';
123
+ export { default as AuroraVeil } from './auroraVeil';
124
+ export type { AuroraVeilProps } from './auroraVeil';
115
125
  export { default as SolarSystem } from './solarSystem';
116
126
  export type { SolarSystemProps } from './solarSystem';
117
127
  export type { SmokeFogProps } from './smokeFog';
@@ -0,0 +1,21 @@
1
+ import { default as React } from 'react';
2
+ export interface InkBloomProps {
3
+ width?: number;
4
+ height?: number;
5
+ /** 为 true 时铺满父容器(父级需有明确高度) */
6
+ fill?: boolean;
7
+ /** 墨水色 */
8
+ inkColor?: string;
9
+ /** 扩散速度倍率 0~3,默认 1 */
10
+ speed?: number;
11
+ /** 是否响应指针交互,默认 true */
12
+ interactive?: boolean;
13
+ /** 画布无障碍标签 */
14
+ ariaLabel?: string;
15
+ }
16
+ /**
17
+ * 墨染清水:密度场 + 速度场流体近似。
18
+ * 滴入浓墨靠浮力/涡旋/扩散自然晕开;溶开后质量转入染色场,点击越多背景越深。
19
+ */
20
+ declare const InkBloom: React.FC<InkBloomProps>;
21
+ export default InkBloom;
@@ -0,0 +1,3 @@
1
+ export declare const createShader: (gl: WebGLRenderingContext, type: number, source: string) => WebGLShader | null;
2
+ export declare const createProgram: (gl: WebGLRenderingContext, vert: string, frag: string) => WebGLProgram | null;
3
+ export declare const createFieldTexture: (gl: WebGLRenderingContext) => WebGLTexture;
@@ -0,0 +1,24 @@
1
+ import { default as React } from 'react';
2
+ export interface LavaBubbleProps {
3
+ width?: number;
4
+ height?: number;
5
+ /** 为 true 时铺满父容器(父级需有明确高度) */
6
+ fill?: boolean;
7
+ /** 热度 0~2,默认 1 */
8
+ heat?: number;
9
+ /** 运动速度倍率 0~3,默认 1 */
10
+ speed?: number;
11
+ /** 是否自动在表面随机鼓起气泡,默认 true */
12
+ autoSpawn?: boolean;
13
+ /** 自动鼓起活跃度 0~2,默认 1 */
14
+ activity?: number;
15
+ /** 是否响应指针交互(点击鼓起),默认 true */
16
+ interactive?: boolean;
17
+ /** 画布无障碍标签 */
18
+ ariaLabel?: string;
19
+ }
20
+ /**
21
+ * WebGL 熔岩湖:表面会不定期随机鼓起闷裂;也可点击指定位置鼓起。
22
+ */
23
+ declare const LavaBubble: React.FC<LavaBubbleProps>;
24
+ export default LavaBubble;
@@ -0,0 +1,2 @@
1
+ export declare const VERT = "\nattribute vec2 a_pos;\nvarying vec2 v_uv;\nvoid main() {\n v_uv = a_pos * 0.5 + 0.5;\n gl_Position = vec4(a_pos, 0.0, 1.0);\n}\n";
2
+ export declare const FRAG = "\nprecision highp float;\n\nuniform float u_time;\nuniform vec2 u_res;\nuniform vec2 u_sim;\nuniform float u_heat;\nuniform sampler2D u_field;\n\nvarying vec2 v_uv;\n\nfloat hash(vec2 p) {\n return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453);\n}\n\nfloat noise(vec2 p) {\n vec2 i = floor(p);\n vec2 f = fract(p);\n vec2 u = f * f * (3.0 - 2.0 * f);\n float a = hash(i);\n float b = hash(i + vec2(1.0, 0.0));\n float c = hash(i + vec2(0.0, 1.0));\n float d = hash(i + vec2(1.0, 1.0));\n return mix(mix(a, b, u.x), mix(c, d, u.x), u.y);\n}\n\nfloat fbm(vec2 p) {\n float v = 0.0;\n float a = 0.5;\n for (int i = 0; i < 5; i++) {\n v += a * noise(p);\n p *= 2.05;\n a *= 0.5;\n }\n return v;\n}\n\nvec3 heatColor(float t) {\n // \u6700\u4F4E\u4E5F\u662F\u6697\u7EA2\u7194\u58F3\uFF0C\u7EDD\u4E0D\u8D70\u5230\u7EAF\u9ED1\n t = clamp(t, 0.18, 1.0);\n vec3 c0 = vec3(0.28, 0.07, 0.02);\n vec3 c1 = vec3(0.48, 0.12, 0.03);\n vec3 c2 = vec3(0.72, 0.2, 0.04);\n vec3 c3 = vec3(0.95, 0.4, 0.08);\n vec3 c4 = vec3(1.0, 0.7, 0.28);\n vec3 c5 = vec3(1.0, 0.9, 0.58);\n if (t < 0.35) return mix(c0, c1, (t - 0.18) / 0.17);\n if (t < 0.52) return mix(c1, c2, (t - 0.35) / 0.17);\n if (t < 0.7) return mix(c2, c3, (t - 0.52) / 0.18);\n if (t < 0.88) return mix(c3, c4, (t - 0.7) / 0.18);\n return mix(c4, c5, (t - 0.88) / 0.12);\n}\n\nfloat sampleH(vec2 uv) {\n return texture2D(u_field, uv).r;\n}\n\nfloat sampleHeat(vec2 uv) {\n return texture2D(u_field, uv).g;\n}\n\nfloat sampleCav(vec2 uv) {\n return texture2D(u_field, uv).b;\n}\n\nvec3 calcNormal(vec2 uv) {\n vec2 e = vec2(1.0 / u_sim.x, 1.0 / u_sim.y);\n float hL = sampleH(uv - vec2(e.x, 0.0)) - sampleCav(uv - vec2(e.x, 0.0)) * 0.3;\n float hR = sampleH(uv + vec2(e.x, 0.0)) - sampleCav(uv + vec2(e.x, 0.0)) * 0.3;\n float hD = sampleH(uv - vec2(0.0, e.y)) - sampleCav(uv - vec2(0.0, e.y)) * 0.3;\n float hU = sampleH(uv + vec2(0.0, e.y)) - sampleCav(uv + vec2(0.0, e.y)) * 0.3;\n return normalize(vec3((hL - hR) * 8.2, (hD - hU) * 8.2, 1.6));\n}\n\nvoid main() {\n vec2 uv = v_uv;\n float aspect = u_res.x / max(u_res.y, 1.0);\n vec2 p = (uv - 0.5) * vec2(aspect, 1.0);\n\n float h = sampleH(uv);\n float extra = min(sampleHeat(uv), 0.38);\n float cav = sampleCav(uv);\n\n vec3 N = calcNormal(uv);\n vec2 stretchUv = uv - N.xy * h * 0.028;\n\n float plate = fbm(stretchUv * vec2(4.0, 3.5) + u_time * 0.022);\n float plate2 = fbm(stretchUv * vec2(8.0, 7.2) - u_time * 0.015);\n float seam = pow(1.0 - abs(plate2 - 0.5) * 2.0, 3.0);\n float micro = fbm(stretchUv * 16.0 + h * 1.5);\n\n float dome = smoothstep(0.02, 0.28, h);\n float domeCore = smoothstep(0.18, 0.88, h);\n // \u5BBD\u67D4\u63A5\u89E6\u5F71\uFF1A\u6709\u6DF1\u5EA6\u4F46\u4E0D\u63CF\u9ED1\u8FB9\n float contact = smoothstep(0.012, 0.12, h) * (1.0 - smoothstep(0.12, 0.42, h));\n float shoulder = smoothstep(0.07, 0.22, h) * (1.0 - smoothstep(0.22, 0.55, h));\n float apex = pow(domeCore, 1.35);\n float thinSpot = pow(micro, 2.4) * domeCore;\n\n float cavFloor = cav * 0.08;\n float cavDeep = pow(cav, 1.4);\n float cavRim = smoothstep(0.03, 0.14, cav) * (1.0 - smoothstep(0.14, 0.4, cav));\n\n float t = plate * 0.5 * u_heat + 0.26 + seam * 0.18 + micro * 0.045;\n t += extra * 0.7;\n t -= contact * 0.025;\n t += apex * 0.05;\n t += thinSpot * 0.055;\n t += cavFloor;\n t = clamp(t, 0.26, 0.87);\n\n vec3 col = heatColor(t);\n\n vec3 L = normalize(vec3(-0.3, 0.42, 0.86));\n vec3 V = vec3(0.0, 0.0, 1.0);\n float wrap = clamp((dot(N, L) + 0.5) / 1.5, 0.0, 1.0);\n float facing = clamp(N.z, 0.0, 1.0);\n float softSpec = pow(max(dot(reflect(-L, N), V), 0.0), 8.5);\n float broadSpec = pow(max(dot(reflect(-L, N), V), 0.0), 3.8);\n\n // \u4E2D\u7B49\u51F8\u611F\uFF1A\u9876\u4EAE + \u6839\u90E8\u6D45\u5F71 + \u67D4\u8FB9\n float volume = 0.92 + wrap * 0.12 + facing * apex * 0.13;\n col *= volume;\n col *= 1.0 + h * 0.1 * facing;\n col *= 1.0 - contact * 0.16;\n col = mix(col, heatColor(0.44), contact * 0.12);\n col += heatColor(0.6) * shoulder * wrap * 0.13;\n col += heatColor(0.68) * apex * 0.09;\n col += vec3(1.0, 0.52, 0.16) * softSpec * dome * 0.22 * (0.35 + 0.65 * facing);\n col += vec3(1.0, 0.42, 0.1) * broadSpec * dome * 0.08;\n col += heatColor(0.6) * thinSpot * 0.08;\n\n col += heatColor(min(0.76, 0.52 + extra)) * pow(extra, 1.35) * 0.22;\n\n // \u7206\u88C2\u53E3\uFF1A\u6DF1\u4E95\u538B\u6697 + \u6495\u88C2\u5507\u4F59\u6E29\uFF08\u4E0D\u662F\u4E2D\u5FC3\u767D\u5149\u56E2\uFF09\n col *= 1.0 - cavDeep * 0.38;\n col = mix(col, heatColor(0.34), cavDeep * 0.22);\n col *= 1.0 - cavRim * 0.22;\n col += vec3(1.0, 0.28, 0.04) * cavRim * 0.35;\n col += heatColor(0.58) * pow(cav, 2.8) * 0.05;\n\n col += (hash(uv * u_res + u_time) - 0.5) * 0.006;\n col = max(col, vec3(0.18, 0.045, 0.015));\n\n float vig = smoothstep(1.25, 0.35, length(p));\n col *= 0.95 + 0.05 * vig;\n\n gl_FragColor = vec4(col, 1.0);\n}\n";
@@ -0,0 +1,60 @@
1
+ export declare const SIM = 192;
2
+ export declare const MAX_DPR = 2;
3
+ export declare const MAX_BLISTERS = 8;
4
+ interface Crack {
5
+ a0: number;
6
+ a1: number;
7
+ bend: number;
8
+ width: number;
9
+ }
10
+ export interface Blister {
11
+ u: number;
12
+ v: number;
13
+ r: number;
14
+ maxR: number;
15
+ z: number;
16
+ phase: 'inflate' | 'thin' | 'burst' | 'cavity';
17
+ t: number;
18
+ seed: number;
19
+ aspect: number;
20
+ rot: number;
21
+ inflate: number;
22
+ thinTime: number;
23
+ cracks: Crack[];
24
+ tear: number;
25
+ bias: number;
26
+ }
27
+ export interface Spatter {
28
+ u: number;
29
+ v: number;
30
+ vu: number;
31
+ vv: number;
32
+ z: number;
33
+ vz: number;
34
+ life: number;
35
+ heat: number;
36
+ size: number;
37
+ kind: 0 | 1 | 2;
38
+ }
39
+ export interface StirState {
40
+ u: number;
41
+ v: number;
42
+ vu: number;
43
+ vv: number;
44
+ }
45
+ export interface LavaSimStepOpts {
46
+ autoSpawn: boolean;
47
+ activity: number;
48
+ click: {
49
+ u: number;
50
+ v: number;
51
+ } | null;
52
+ stir: StirState | null;
53
+ }
54
+ /** 熔岩湖场仿真:高度 / 热量 / 空腔 + 气泡生命周期 */
55
+ export declare const createLavaSim: () => {
56
+ step: (dt: number, rate: number, opts: LavaSimStepOpts) => void;
57
+ upload: (gl: WebGLRenderingContext, fieldTex: WebGLTexture) => void;
58
+ };
59
+ export type LavaSim = ReturnType<typeof createLavaSim>;
60
+ export {};
@@ -0,0 +1,20 @@
1
+ import { ActiveMerge, MergePose } from './merge';
2
+ import { Bubble, Droplet } from './types';
3
+ /**
4
+ * 真实感肥皂泡:球体 Lambert 明暗 + 背光内阴影 + 镜面高光 + 软色斑虹彩 + 背景投影。
5
+ */
6
+ export declare const drawSoapBubble: (ctx: CanvasRenderingContext2D, b: Bubble, time: number, lightX: number, lightY: number, opts?: {
7
+ alphaScale?: number;
8
+ skipShadow?: boolean;
9
+ }) => void;
10
+ /**
11
+ * 融合绘制:metaball 液滴 + 起步/收尾与单泡 crossfade。
12
+ */
13
+ export declare const drawMergingSoapPair: (ctx: CanvasRenderingContext2D, pose: MergePose, time: number, primary: Bubble, secondary: Bubble | undefined, mergeProgress: number, lightX: number, lightY: number, opts?: {
14
+ skipShadow?: boolean;
15
+ }) => void;
16
+ /** 融合中各阶段的地面投影 */
17
+ export declare const drawMergeShadows: (ctx: CanvasRenderingContext2D, merge: ActiveMerge, pose: MergePose, primary: Bubble, secondary: Bubble | undefined, lightX: number, lightY: number) => void;
18
+ /** 爆裂:刺破点张开 → 薄膜回缩珠串 → 细雾消散 */
19
+ export declare const drawPop: (ctx: CanvasRenderingContext2D, b: Bubble) => void;
20
+ export declare const drawDroplet: (ctx: CanvasRenderingContext2D, d: Droplet) => void;