@cos-design/weather-background 3.5.6 → 4.1.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 (202) hide show
  1. package/dist/core/index.d.ts +1 -0
  2. package/dist/{index.js → core/index.js} +354 -384
  3. package/dist/core/packages/shared/src/canvas-box.d.ts +18 -0
  4. package/dist/core/packages/shared/src/element-options.d.ts +19 -0
  5. package/dist/core/packages/shared/src/host-layout.d.ts +22 -0
  6. package/dist/core/packages/shared/src/index.d.ts +13 -0
  7. package/dist/{packages → core/packages}/shared/src/math.d.ts +1 -0
  8. package/dist/{packages/shared/src/use-element-size.d.ts → core/packages/shared/src/react/index.d.ts} +4 -19
  9. package/dist/core/packages/weatherBackground/src/core.d.ts +1 -0
  10. package/dist/core/packages/weatherBackground/src/element.d.ts +1 -0
  11. package/dist/{packages → core/packages}/weatherBackground/src/index.d.ts +8 -8
  12. package/dist/core/packages/weatherBackground/src/react.d.ts +15 -0
  13. package/dist/core/packages/weatherBackground/src/vue.d.ts +4 -0
  14. package/dist/core/src/components/weatherBackground/core/engine.d.ts +2 -0
  15. package/dist/core/src/components/weatherBackground/core/index.d.ts +14 -0
  16. package/dist/core/src/components/weatherBackground/core/types.d.ts +7 -0
  17. package/dist/core/src/components/weatherBackground/element/index.d.ts +13 -0
  18. package/dist/core/src/components/weatherBackground/index.d.ts +5 -0
  19. package/dist/{src/components/weatherBackground/live-weather.d.ts → core/src/components/weatherBackground/live-weather-core.d.ts} +8 -10
  20. package/dist/core/src/components/weatherBackground/live-weather.d.ts +15 -0
  21. package/dist/core/src/components/weatherBackground/react/index.d.ts +3 -0
  22. package/dist/core/src/components/weatherBackground/vue/useLiveWeather.d.ts +15 -0
  23. package/dist/{src → core/src}/vite-env.d.ts +6 -0
  24. package/dist/element/element.css +1 -0
  25. package/dist/element/index.d.ts +1 -0
  26. package/dist/element/index.js +1523 -0
  27. package/dist/element/packages/shared/src/canvas-box.d.ts +18 -0
  28. package/dist/element/packages/shared/src/element-options.d.ts +19 -0
  29. package/dist/element/packages/shared/src/host-layout.d.ts +22 -0
  30. package/dist/element/packages/shared/src/index.d.ts +13 -0
  31. package/dist/element/packages/shared/src/math.d.ts +2 -0
  32. package/dist/element/packages/shared/src/photo.d.ts +15 -0
  33. package/dist/element/packages/shared/src/pointer.d.ts +14 -0
  34. package/dist/element/packages/shared/src/react/index.d.ts +30 -0
  35. package/dist/element/packages/shared/src/reduced-motion.d.ts +4 -0
  36. package/dist/element/packages/shared/src/size.d.ts +8 -0
  37. package/dist/element/packages/shared/src/visibility.d.ts +2 -0
  38. package/dist/element/packages/weatherBackground/src/core.d.ts +1 -0
  39. package/dist/element/packages/weatherBackground/src/element.d.ts +1 -0
  40. package/dist/element/packages/weatherBackground/src/index.d.ts +15 -0
  41. package/dist/element/packages/weatherBackground/src/react.d.ts +15 -0
  42. package/dist/element/packages/weatherBackground/src/vue.d.ts +4 -0
  43. package/dist/element/src/components/weatherBackground/configs.d.ts +9 -0
  44. package/dist/element/src/components/weatherBackground/core/engine.d.ts +2 -0
  45. package/dist/element/src/components/weatherBackground/core/index.d.ts +14 -0
  46. package/dist/element/src/components/weatherBackground/core/types.d.ts +7 -0
  47. package/dist/element/src/components/weatherBackground/day-cycle.d.ts +53 -0
  48. package/dist/element/src/components/weatherBackground/element/index.d.ts +13 -0
  49. package/dist/element/src/components/weatherBackground/fog.d.ts +25 -0
  50. package/dist/element/src/components/weatherBackground/hail-level.d.ts +24 -0
  51. package/dist/element/src/components/weatherBackground/index.d.ts +5 -0
  52. package/dist/element/src/components/weatherBackground/lightning.d.ts +1 -0
  53. package/dist/element/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  54. package/dist/element/src/components/weatherBackground/live-weather.d.ts +15 -0
  55. package/dist/element/src/components/weatherBackground/precipitation.d.ts +51 -0
  56. package/dist/element/src/components/weatherBackground/react/index.d.ts +3 -0
  57. package/dist/element/src/components/weatherBackground/scene/create-weather-scene.d.ts +2 -0
  58. package/dist/element/src/components/weatherBackground/scene/draw-atmosphere.d.ts +4 -0
  59. package/dist/element/src/components/weatherBackground/scene/draw-effects.d.ts +3 -0
  60. package/dist/element/src/components/weatherBackground/scene/draw-precipitation.d.ts +4 -0
  61. package/dist/element/src/components/weatherBackground/scene/draw-sky.d.ts +4 -0
  62. package/dist/element/src/components/weatherBackground/scene/init-state.d.ts +44 -0
  63. package/dist/element/src/components/weatherBackground/scene/runtime.d.ts +38 -0
  64. package/dist/element/src/components/weatherBackground/smog.d.ts +17 -0
  65. package/dist/element/src/components/weatherBackground/sprites/celestial.d.ts +11 -0
  66. package/dist/element/src/components/weatherBackground/sprites/cloud.d.ts +20 -0
  67. package/dist/element/src/components/weatherBackground/sprites/hail.d.ts +11 -0
  68. package/dist/element/src/components/weatherBackground/sprites/snow.d.ts +8 -0
  69. package/dist/element/src/components/weatherBackground/types.d.ts +230 -0
  70. package/dist/element/src/components/weatherBackground/vue/useLiveWeather.d.ts +15 -0
  71. package/dist/element/src/components/weatherBackground/wind.d.ts +68 -0
  72. package/dist/element/src/vite-env.d.ts +45 -0
  73. package/dist/react/index.cjs +1 -0
  74. package/dist/react/index.d.ts +89 -0
  75. package/dist/react/index.js +1571 -0
  76. package/dist/react/packages/shared/src/canvas-box.d.ts +18 -0
  77. package/dist/react/packages/shared/src/element-options.d.ts +19 -0
  78. package/dist/react/packages/shared/src/host-layout.d.ts +22 -0
  79. package/dist/react/packages/shared/src/index.d.ts +13 -0
  80. package/dist/react/packages/shared/src/math.d.ts +2 -0
  81. package/dist/react/packages/shared/src/photo.d.ts +15 -0
  82. package/dist/react/packages/shared/src/pointer.d.ts +14 -0
  83. package/dist/react/packages/shared/src/react/index.d.ts +30 -0
  84. package/dist/react/packages/shared/src/reduced-motion.d.ts +4 -0
  85. package/dist/react/packages/shared/src/size.d.ts +8 -0
  86. package/dist/react/packages/shared/src/visibility.d.ts +2 -0
  87. package/dist/react/packages/weatherBackground/src/core.d.ts +1 -0
  88. package/dist/react/packages/weatherBackground/src/element.d.ts +1 -0
  89. package/dist/react/packages/weatherBackground/src/index.d.ts +15 -0
  90. package/dist/react/packages/weatherBackground/src/react.d.ts +15 -0
  91. package/dist/react/packages/weatherBackground/src/vue.d.ts +4 -0
  92. package/dist/react/react.css +1 -0
  93. package/dist/react/src/components/weatherBackground/configs.d.ts +9 -0
  94. package/dist/react/src/components/weatherBackground/core/engine.d.ts +2 -0
  95. package/dist/react/src/components/weatherBackground/core/index.d.ts +14 -0
  96. package/dist/react/src/components/weatherBackground/core/types.d.ts +7 -0
  97. package/dist/react/src/components/weatherBackground/day-cycle.d.ts +53 -0
  98. package/dist/react/src/components/weatherBackground/element/index.d.ts +13 -0
  99. package/dist/react/src/components/weatherBackground/fog.d.ts +25 -0
  100. package/dist/react/src/components/weatherBackground/hail-level.d.ts +24 -0
  101. package/dist/react/src/components/weatherBackground/index.d.ts +5 -0
  102. package/dist/react/src/components/weatherBackground/lightning.d.ts +1 -0
  103. package/dist/react/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  104. package/dist/react/src/components/weatherBackground/live-weather.d.ts +15 -0
  105. package/dist/react/src/components/weatherBackground/precipitation.d.ts +51 -0
  106. package/dist/react/src/components/weatherBackground/react/index.d.ts +3 -0
  107. package/dist/react/src/components/weatherBackground/scene/create-weather-scene.d.ts +2 -0
  108. package/dist/react/src/components/weatherBackground/scene/draw-atmosphere.d.ts +4 -0
  109. package/dist/react/src/components/weatherBackground/scene/draw-effects.d.ts +3 -0
  110. package/dist/react/src/components/weatherBackground/scene/draw-precipitation.d.ts +4 -0
  111. package/dist/react/src/components/weatherBackground/scene/draw-sky.d.ts +4 -0
  112. package/dist/react/src/components/weatherBackground/scene/init-state.d.ts +44 -0
  113. package/dist/react/src/components/weatherBackground/scene/runtime.d.ts +38 -0
  114. package/dist/react/src/components/weatherBackground/smog.d.ts +17 -0
  115. package/dist/react/src/components/weatherBackground/sprites/celestial.d.ts +11 -0
  116. package/dist/react/src/components/weatherBackground/sprites/cloud.d.ts +20 -0
  117. package/dist/react/src/components/weatherBackground/sprites/hail.d.ts +11 -0
  118. package/dist/react/src/components/weatherBackground/sprites/snow.d.ts +8 -0
  119. package/dist/react/src/components/weatherBackground/types.d.ts +230 -0
  120. package/dist/react/src/components/weatherBackground/vue/useLiveWeather.d.ts +15 -0
  121. package/dist/react/src/components/weatherBackground/wind.d.ts +68 -0
  122. package/dist/react/src/vite-env.d.ts +45 -0
  123. package/dist/vue/index.d.ts +21 -0
  124. package/dist/vue/index.js +1590 -0
  125. package/dist/vue/packages/shared/src/canvas-box.d.ts +18 -0
  126. package/dist/vue/packages/shared/src/element-options.d.ts +19 -0
  127. package/dist/vue/packages/shared/src/host-layout.d.ts +22 -0
  128. package/dist/vue/packages/shared/src/index.d.ts +13 -0
  129. package/dist/vue/packages/shared/src/math.d.ts +2 -0
  130. package/dist/vue/packages/shared/src/photo.d.ts +15 -0
  131. package/dist/vue/packages/shared/src/pointer.d.ts +14 -0
  132. package/dist/vue/packages/shared/src/react/index.d.ts +30 -0
  133. package/dist/vue/packages/shared/src/reduced-motion.d.ts +4 -0
  134. package/dist/vue/packages/shared/src/size.d.ts +8 -0
  135. package/dist/vue/packages/shared/src/visibility.d.ts +2 -0
  136. package/dist/vue/packages/weatherBackground/src/core.d.ts +1 -0
  137. package/dist/vue/packages/weatherBackground/src/element.d.ts +1 -0
  138. package/dist/vue/packages/weatherBackground/src/index.d.ts +15 -0
  139. package/dist/vue/packages/weatherBackground/src/react.d.ts +15 -0
  140. package/dist/vue/packages/weatherBackground/src/vue.d.ts +4 -0
  141. package/dist/vue/src/components/weatherBackground/configs.d.ts +9 -0
  142. package/dist/vue/src/components/weatherBackground/core/engine.d.ts +2 -0
  143. package/dist/vue/src/components/weatherBackground/core/index.d.ts +14 -0
  144. package/dist/vue/src/components/weatherBackground/core/types.d.ts +7 -0
  145. package/dist/vue/src/components/weatherBackground/day-cycle.d.ts +53 -0
  146. package/dist/vue/src/components/weatherBackground/element/index.d.ts +13 -0
  147. package/dist/vue/src/components/weatherBackground/fog.d.ts +25 -0
  148. package/dist/vue/src/components/weatherBackground/hail-level.d.ts +24 -0
  149. package/dist/vue/src/components/weatherBackground/index.d.ts +5 -0
  150. package/dist/vue/src/components/weatherBackground/lightning.d.ts +1 -0
  151. package/dist/vue/src/components/weatherBackground/live-weather-core.d.ts +79 -0
  152. package/dist/vue/src/components/weatherBackground/live-weather.d.ts +15 -0
  153. package/dist/vue/src/components/weatherBackground/precipitation.d.ts +51 -0
  154. package/dist/vue/src/components/weatherBackground/react/index.d.ts +3 -0
  155. package/dist/vue/src/components/weatherBackground/scene/create-weather-scene.d.ts +2 -0
  156. package/dist/vue/src/components/weatherBackground/scene/draw-atmosphere.d.ts +4 -0
  157. package/dist/vue/src/components/weatherBackground/scene/draw-effects.d.ts +3 -0
  158. package/dist/vue/src/components/weatherBackground/scene/draw-precipitation.d.ts +4 -0
  159. package/dist/vue/src/components/weatherBackground/scene/draw-sky.d.ts +4 -0
  160. package/dist/vue/src/components/weatherBackground/scene/init-state.d.ts +44 -0
  161. package/dist/vue/src/components/weatherBackground/scene/runtime.d.ts +38 -0
  162. package/dist/vue/src/components/weatherBackground/smog.d.ts +17 -0
  163. package/dist/vue/src/components/weatherBackground/sprites/celestial.d.ts +11 -0
  164. package/dist/vue/src/components/weatherBackground/sprites/cloud.d.ts +20 -0
  165. package/dist/vue/src/components/weatherBackground/sprites/hail.d.ts +11 -0
  166. package/dist/vue/src/components/weatherBackground/sprites/snow.d.ts +8 -0
  167. package/dist/vue/src/components/weatherBackground/types.d.ts +230 -0
  168. package/dist/vue/src/components/weatherBackground/vue/useLiveWeather.d.ts +15 -0
  169. package/dist/vue/src/components/weatherBackground/wind.d.ts +68 -0
  170. package/dist/vue/src/vite-env.d.ts +45 -0
  171. package/dist/vue/vue.css +1 -0
  172. package/package.json +44 -12
  173. package/dist/index.cjs +0 -1
  174. package/dist/index.css +0 -1
  175. package/dist/index.d.ts +0 -5
  176. package/dist/packages/shared/src/index.d.ts +0 -10
  177. package/dist/src/components/weatherBackground/index.d.ts +0 -5
  178. /package/dist/{packages → core/packages}/shared/src/photo.d.ts +0 -0
  179. /package/dist/{packages → core/packages}/shared/src/pointer.d.ts +0 -0
  180. /package/dist/{packages → core/packages}/shared/src/reduced-motion.d.ts +0 -0
  181. /package/dist/{packages → core/packages}/shared/src/size.d.ts +0 -0
  182. /package/dist/{packages → core/packages}/shared/src/visibility.d.ts +0 -0
  183. /package/dist/{src → core/src}/components/weatherBackground/configs.d.ts +0 -0
  184. /package/dist/{src → core/src}/components/weatherBackground/day-cycle.d.ts +0 -0
  185. /package/dist/{src → core/src}/components/weatherBackground/fog.d.ts +0 -0
  186. /package/dist/{src → core/src}/components/weatherBackground/hail-level.d.ts +0 -0
  187. /package/dist/{src → core/src}/components/weatherBackground/lightning.d.ts +0 -0
  188. /package/dist/{src → core/src}/components/weatherBackground/precipitation.d.ts +0 -0
  189. /package/dist/{src → core/src}/components/weatherBackground/scene/create-weather-scene.d.ts +0 -0
  190. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-atmosphere.d.ts +0 -0
  191. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-effects.d.ts +0 -0
  192. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-precipitation.d.ts +0 -0
  193. /package/dist/{src → core/src}/components/weatherBackground/scene/draw-sky.d.ts +0 -0
  194. /package/dist/{src → core/src}/components/weatherBackground/scene/init-state.d.ts +0 -0
  195. /package/dist/{src → core/src}/components/weatherBackground/scene/runtime.d.ts +0 -0
  196. /package/dist/{src → core/src}/components/weatherBackground/smog.d.ts +0 -0
  197. /package/dist/{src → core/src}/components/weatherBackground/sprites/celestial.d.ts +0 -0
  198. /package/dist/{src → core/src}/components/weatherBackground/sprites/cloud.d.ts +0 -0
  199. /package/dist/{src → core/src}/components/weatherBackground/sprites/hail.d.ts +0 -0
  200. /package/dist/{src → core/src}/components/weatherBackground/sprites/snow.d.ts +0 -0
  201. /package/dist/{src → core/src}/components/weatherBackground/types.d.ts +0 -0
  202. /package/dist/{src → core/src}/components/weatherBackground/wind.d.ts +0 -0
@@ -0,0 +1,18 @@
1
+ import { ElementSize } from './size';
2
+ export interface CanvasBoxSizeInput {
3
+ /** 为 true 时跟随父容器尺寸(需父级有明确高度) */
4
+ fill?: boolean;
5
+ width?: number;
6
+ height?: number;
7
+ defaultWidth: number;
8
+ defaultHeight: number;
9
+ measured: ElementSize;
10
+ }
11
+ export interface CanvasBoxSize {
12
+ width: number;
13
+ height: number;
14
+ /** 是否处于 fill 模式且尚未量到有效尺寸 */
15
+ pending: boolean;
16
+ }
17
+ /** 根据 fill / 显式宽高 / 测量结果解析画布逻辑尺寸 */
18
+ export declare const resolveCanvasBoxSize: ({ fill, width, height, defaultWidth, defaultHeight, measured, }: CanvasBoxSizeInput) => CanvasBoxSize;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Web Component attribute → Core options parsing (v4 Element adapters).
3
+ * Keeps behavior consistent across 91 components.
4
+ */
5
+ export type BooleanAttrMode =
6
+ /** `options.key = el.hasAttribute(attr)` — always written */
7
+ 'presence'
8
+ /** Only when attribute present: `raw !== 'false' && raw !== '0'` (omit when absent) */
9
+ | 'optional-true'
10
+ /** Only when attribute present; when absent leave `undefined` (controlled props like `flipped`) */
11
+ | 'optional-undefined';
12
+ export declare const camelToKebabAttr: (name: string) => string;
13
+ export declare function readStringAttr<T extends object>(options: T, el: HTMLElement, key: keyof T & string, attr?: string): void;
14
+ export declare function readNumberAttr<T extends object>(options: T, el: HTMLElement, key: keyof T & string, attr?: string): void;
15
+ export declare function readBooleanAttr<T extends object>(options: T, el: HTMLElement, key: keyof T & string, attr?: string, mode?: BooleanAttrMode): void;
16
+ export declare function readJsonAttr<T extends object, K extends keyof T & string>(options: T, el: HTMLElement, key: K, attr?: string): void;
17
+ /** Property setters on the custom element class (`_prizes`, `_items`, …) override attributes. */
18
+ export declare function readPropertyOverride<T extends object, K extends keyof T & string>(options: T, el: HTMLElement, key: K, backingKey: string): void;
19
+ export declare function optionCallbackDispatcher(el: HTMLElement, eventName: string): (...args: unknown[]) => void;
@@ -0,0 +1,22 @@
1
+ /** Apply fill / explicit size to the adapter host and make the engine root fill it. */
2
+ export declare function applyCanvasHostBox(container: HTMLElement, root: HTMLElement, opts: {
3
+ fill: boolean;
4
+ width: number;
5
+ height: number;
6
+ }): void;
7
+ /**
8
+ * Size the adapter host (React/Vue div or custom element) so percentage widths
9
+ * don't collapse when the host is a shrink-wrapped flex child. Root fills the host
10
+ * unless `rootFillsHost` is false (e.g. PhotoAlbum sizes itself via CSS variables).
11
+ */
12
+ export declare function applyBlockHostBox(container: HTMLElement, root: HTMLElement, size: {
13
+ width?: number | string;
14
+ height?: number | string;
15
+ rootFillsHost?: boolean;
16
+ }): void;
17
+ /** Toggle empty-state nodes; author `display:` rules must not override `[hidden]`. */
18
+ export declare function setHidden(el: HTMLElement, hidden: boolean): void;
19
+ /** Stable JSON key for options, ignoring functions (callbacks). */
20
+ export declare function optionsFingerprint(value: unknown): string;
21
+ /** True when non-function fields differ (shallow). */
22
+ export declare function optionsVisualChanged(prev: Record<string, unknown>, next: Record<string, unknown>): boolean;
@@ -0,0 +1,13 @@
1
+ export { clamp, lerp } from './math';
2
+ export { bindVisibilityPause } from './visibility';
3
+ export { prefersReducedMotion, bindPrefersReducedMotion } from './reduced-motion';
4
+ export { observeElementSize } from './size';
5
+ export type { ElementSize } from './size';
6
+ export { getRelativePointerPosition } from './pointer';
7
+ export type { PointerPosition } from './pointer';
8
+ export type { PhotoItem, PhotoIndexChangeHandler, PhotoFaceChangeHandler } from './photo';
9
+ export { resolveCanvasBoxSize } from './canvas-box';
10
+ export type { CanvasBoxSizeInput, CanvasBoxSize } from './canvas-box';
11
+ export { applyCanvasHostBox, applyBlockHostBox, setHidden, optionsFingerprint, optionsVisualChanged, } from './host-layout';
12
+ export type { BooleanAttrMode } from './element-options';
13
+ export { camelToKebabAttr, optionCallbackDispatcher, readBooleanAttr, readJsonAttr, readNumberAttr, readPropertyOverride, readStringAttr, } from './element-options';
@@ -1 +1,2 @@
1
1
  export declare const clamp: (value: number, min: number, max: number) => number;
2
+ export declare const lerp: (a: number, b: number, t: number) => number;
@@ -1,28 +1,13 @@
1
1
  import { CSSProperties, RefObject } from 'react';
2
- import { ElementSize } from './size';
2
+ import { ElementSize } from '../size';
3
+ export type { CanvasBoxSize, CanvasBoxSizeInput } from '../canvas-box';
4
+ export { resolveCanvasBoxSize } from '../canvas-box';
3
5
  export interface UseElementSizeOptions {
4
6
  /** 为 false 时不观察 */
5
7
  enabled?: boolean;
6
8
  }
7
9
  /** 观察元素尺寸(clientWidth / clientHeight) */
8
10
  export declare const useElementSize: <T extends Element>(ref: RefObject<T | null>, options?: UseElementSizeOptions) => ElementSize;
9
- export interface CanvasBoxSizeInput {
10
- /** 为 true 时跟随父容器尺寸(需父级有明确高度) */
11
- fill?: boolean;
12
- width?: number;
13
- height?: number;
14
- defaultWidth: number;
15
- defaultHeight: number;
16
- measured: ElementSize;
17
- }
18
- export interface CanvasBoxSize {
19
- width: number;
20
- height: number;
21
- /** 是否处于 fill 模式且尚未量到有效尺寸 */
22
- pending: boolean;
23
- }
24
- /** 根据 fill / 显式宽高 / 测量结果解析画布逻辑尺寸 */
25
- export declare const resolveCanvasBoxSize: ({ fill, width, height, defaultWidth, defaultHeight, measured }: CanvasBoxSizeInput) => CanvasBoxSize;
26
11
  export interface UseCanvasBoxOptions {
27
12
  /** 为 true 时铺满父容器(父级需有明确高度) */
28
13
  fill?: boolean;
@@ -42,4 +27,4 @@ export interface UseCanvasBoxResult {
42
27
  pending: boolean;
43
28
  }
44
29
  /** 画布/效果宿主尺寸:fill 时跟随父容器,否则用显式宽高或默认值 */
45
- export declare const useCanvasBox: ({ fill, width: widthProp, height: heightProp, defaultWidth, defaultHeight }: UseCanvasBoxOptions) => UseCanvasBoxResult;
30
+ export declare const useCanvasBox: ({ fill, width: widthProp, height: heightProp, defaultWidth, defaultHeight, }: UseCanvasBoxOptions) => UseCanvasBoxResult;
@@ -0,0 +1 @@
1
+ export * from '../../../src/components/weatherBackground/core';
@@ -0,0 +1 @@
1
+ export * from '../../../src/components/weatherBackground/element';
@@ -1,15 +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 { formatLocalHm, mapWmoCodeToWeatherType, useLiveWeather, useSunTimes } from '../../../src/components/weatherBackground/live-weather';
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';
4
+ export { formatLocalHm, mapWmoCodeToWeatherType, useLiveWeather, useSunTimes, } from '../../../src/components/weatherBackground/live-weather';
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
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';
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
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';
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
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';
14
+ export { DEFAULT_WIND_LEVEL, buildWindMotion, kmhToWindLevel, sampleWindField, visualWindLevel, windLevelToKmh, windStreakSpec, } from '../../../src/components/weatherBackground/wind';
15
15
  export type { WindFieldSample, WindMotion } from '../../../src/components/weatherBackground/wind';
@@ -0,0 +1,15 @@
1
+ export { default } from '../../../src/components/weatherBackground/react';
2
+ export { default as WeatherBackground } from '../../../src/components/weatherBackground/react';
3
+ export type * from '../../../src/components/weatherBackground/core/types';
4
+ export { formatLocalHm, mapWmoCodeToWeatherType, useLiveWeather, useSunTimes, } from '../../../src/components/weatherBackground/live-weather';
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,4 @@
1
+ export { default as WeatherBackground } from '../../../src/components/weatherBackground/vue/WeatherBackground.vue';
2
+ export type * from '../../../src/components/weatherBackground/core/types';
3
+ export { useLiveWeather, useSunTimes, fetchLiveWeather, fetchSunTimes, formatLocalHm, getDayCycleTimesFromLive, IDLE_LIVE_WEATHER, isValidCoords, mapWmoCodeToWeatherType, subscribeLiveWeather, subscribeSunTimes, } from '../../../src/components/weatherBackground/vue/useLiveWeather';
4
+ export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent, } from '../../../src/components/weatherBackground/vue/useLiveWeather';
@@ -0,0 +1,2 @@
1
+ import { WeatherBackgroundController, WeatherBackgroundOptions } from './types';
2
+ export declare function createWeatherBackground(container: HTMLElement, initial?: WeatherBackgroundOptions): WeatherBackgroundController;
@@ -0,0 +1,14 @@
1
+ export { createWeatherBackground } from './engine';
2
+ export type { WeatherBackgroundController, WeatherBackgroundOptions, WeatherBackgroundProps, WeatherType, } from './types';
3
+ export { fetchLiveWeather, fetchSunTimes, formatLocalHm, getDayCycleTimesFromLive, IDLE_LIVE_WEATHER, isValidCoords, mapWmoCodeToWeatherType, subscribeLiveWeather, subscribeSunTimes, } from '../live-weather-core';
4
+ export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent, } from '../live-weather-core';
5
+ export { DEFAULT_FOG_LEVEL, FOG_LEVEL_LABELS, clampFogLevel, fogBankAlphaScale, fogLevelFromVisibility, fogLevelFromWmo, formatFogLevel, intensifyFogConfig, supportsFogLevel, } from '../fog';
6
+ export type { FogLevel } from '../fog';
7
+ export { DEFAULT_HAIL_LEVEL, HAIL_LEVEL_LABELS, clampHailLevel, formatHailLevel, hailLevelFromWmo, hailSpec, supportsHailLevel, } from '../hail-level';
8
+ export type { HailIntensitySpec, HailLevel } from '../hail-level';
9
+ export { DEFAULT_SMOG_LEVEL, SMOG_LEVEL_LABELS, clampSmogLevel, formatSmogLevel, intensifySmogConfig, smogBankAlphaScale, smogLevelFromVisibility, supportsSmogLevel, } from '../smog';
10
+ export type { SmogLevel } from '../smog';
11
+ 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 '../precipitation';
12
+ export type { PrecipLevel } from '../precipitation';
13
+ export { DEFAULT_WIND_LEVEL, buildWindMotion, kmhToWindLevel, sampleWindField, visualWindLevel, windLevelToKmh, windStreakSpec, } from '../wind';
14
+ export type { WindFieldSample, WindMotion } from '../wind';
@@ -0,0 +1,7 @@
1
+ import { WeatherBackgroundProps, WeatherType } from '../types';
2
+ export type { WeatherBackgroundProps, WeatherType };
3
+ export type WeatherBackgroundOptions = WeatherBackgroundProps;
4
+ export interface WeatherBackgroundController {
5
+ update(options: Partial<WeatherBackgroundOptions>): void;
6
+ destroy(): void;
7
+ }
@@ -0,0 +1,13 @@
1
+ import { WeatherBackgroundOptions } from '../core';
2
+ declare const TAG = "cos-weather-background";
3
+ declare class CosWeatherBackgroundElement extends HTMLElement {
4
+ private ctrl;
5
+ _weather?: WeatherBackgroundOptions['weather'];
6
+ get weather(): WeatherBackgroundOptions['weather'] | undefined;
7
+ set weather(value: WeatherBackgroundOptions['weather']);
8
+ static get observedAttributes(): string[];
9
+ connectedCallback(): void;
10
+ disconnectedCallback(): void;
11
+ attributeChangedCallback(): void;
12
+ }
13
+ export { CosWeatherBackgroundElement, TAG };
@@ -0,0 +1,5 @@
1
+ export { default } from './react';
2
+ export { default as WeatherBackground } from './react';
3
+ export type * from './core/types';
4
+ export { formatLocalHm, mapWmoCodeToWeatherType, useLiveWeather, useSunTimes, } from './live-weather';
5
+ export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent, } from './live-weather';
@@ -1,5 +1,5 @@
1
1
  import { DayCycleTimes } from './day-cycle';
2
- import { WeatherType } from './index';
2
+ import { WeatherType } from './types';
3
3
  import { FogLevel } from './fog';
4
4
  import { HailLevel } from './hail-level';
5
5
  import { PrecipLevel } from './precipitation';
@@ -55,10 +55,12 @@ export interface LiveWeatherState {
55
55
  }
56
56
  /** Open-Meteo / WMO 精简天气码 → WeatherType */
57
57
  export declare const mapWmoCodeToWeatherType: (code: number) => WeatherType;
58
+ export declare const IDLE_LIVE_WEATHER: LiveWeatherState;
58
59
  export interface LiveWeatherCoords {
59
60
  latitude: number;
60
61
  longitude: number;
61
62
  }
63
+ export declare const isValidCoords: (coords?: LiveWeatherCoords) => coords is LiveWeatherCoords;
62
64
  /**
63
65
  * 按 IANA 时区取当前当地 HH:mm(用于实况滑块随时钟走动)。
64
66
  * 时区无效时回退到 observationLocalTime。
@@ -66,16 +68,12 @@ export interface LiveWeatherCoords {
66
68
  export declare const formatLocalHm: (timeZone: string | null | undefined, fallbackHm?: string | null) => string | null;
67
69
  /** 从实况结果取出日弧用的日出日落;缺省时返回 null */
68
70
  export declare const getDayCycleTimesFromLive: (current: OpenMeteoCurrent | null) => DayCycleTimes | null;
71
+ export declare const fetchLiveWeather: (lat: number, lon: number, signal?: AbortSignal) => Promise<LiveWeatherState>;
69
72
  /**
70
- * Open-Meteo 实况天气。
71
- * 传入 coords 时直接按该经纬度查询;未传时使用浏览器定位(需 HTTPS 与用户授权)。
72
- * 失败时 status 为 error,调用方自行回退。
73
+ * 非 Hook 实况订阅:定位 + Open-Meteo。
74
+ * 返回取消函数;失败时 status 为 error。
73
75
  */
74
- export declare const useLiveWeather: (enabled?: boolean, coords?: LiveWeatherCoords) => LiveWeatherState;
76
+ export declare const subscribeLiveWeather: (enabled: boolean, coords: LiveWeatherCoords | undefined, onState: (state: LiveWeatherState) => void) => (() => void);
75
77
  /** 拉取指定经纬度当日日出日落(Open-Meteo daily) */
76
78
  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;
79
+ export declare const subscribeSunTimes: (coords: LiveWeatherCoords | undefined, onTimes: (times: DayCycleTimes | null) => void) => (() => void);
@@ -0,0 +1,15 @@
1
+ import { DayCycleTimes } from './day-cycle';
2
+ import { LiveWeatherCoords, LiveWeatherState } from './live-weather-core';
3
+ export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent, } from './live-weather-core';
4
+ export { fetchLiveWeather, fetchSunTimes, formatLocalHm, getDayCycleTimesFromLive, IDLE_LIVE_WEATHER, isValidCoords, mapWmoCodeToWeatherType, subscribeLiveWeather, subscribeSunTimes, } from './live-weather-core';
5
+ /**
6
+ * Open-Meteo 实况天气。
7
+ * 传入 coords 时直接按该经纬度查询;未传时使用浏览器定位(需 HTTPS 与用户授权)。
8
+ * 失败时 status 为 error,调用方自行回退。
9
+ */
10
+ export declare const useLiveWeather: (enabled?: boolean, coords?: LiveWeatherCoords) => LiveWeatherState;
11
+ /**
12
+ * 按经纬度获取当地日出日落,用于 `time` 参数判断昼夜。
13
+ * 未传 coords 或请求失败时不更新(调用方回退 approximateDayCycleTimes)。
14
+ */
15
+ export declare const useSunTimes: (coords?: LiveWeatherCoords) => DayCycleTimes | null;
@@ -0,0 +1,3 @@
1
+ export type { WeatherBackgroundOptions } from '../core/types';
2
+ declare const WeatherBackground: import('react').ForwardRefExoticComponent<import('packages/weatherBackground/src').WeatherBackgroundProps & import('react').RefAttributes<unknown>>;
3
+ export default WeatherBackground;
@@ -0,0 +1,15 @@
1
+ import { Ref } from 'vue';
2
+ import { DayCycleTimes } from '../day-cycle';
3
+ import { LiveWeatherCoords, LiveWeatherState } from '../live-weather-core';
4
+ export type { LiveWeatherCoords, LiveWeatherState, LiveWeatherStatus, OpenMeteoCurrent, } from '../live-weather-core';
5
+ export { fetchLiveWeather, fetchSunTimes, formatLocalHm, getDayCycleTimesFromLive, IDLE_LIVE_WEATHER, isValidCoords, mapWmoCodeToWeatherType, subscribeLiveWeather, subscribeSunTimes, } from '../live-weather-core';
6
+ /**
7
+ * Open-Meteo 实况天气(Vue composable,语义与 React `useLiveWeather` 对齐)。
8
+ * @param enabled 是否启用实况拉取
9
+ * @param coords 指定经纬度;省略时使用浏览器定位(需 HTTPS 与用户授权)
10
+ */
11
+ export declare function useLiveWeather(enabled?: boolean, coords?: LiveWeatherCoords): Ref<LiveWeatherState>;
12
+ /**
13
+ * 按经纬度获取当地日出日落(用于 `time` / 昼夜判断),与 React `useSunTimes` 对齐。
14
+ */
15
+ export declare function useSunTimes(coords?: LiveWeatherCoords): Ref<DayCycleTimes | null>;
@@ -1,5 +1,11 @@
1
1
  /// <reference types="vite/client" />
2
2
 
3
+ declare module '*.vue' {
4
+ import type { DefineComponent } from 'vue';
5
+ const component: DefineComponent<object, object, unknown>;
6
+ export default component;
7
+ }
8
+
3
9
  declare module '*.module.less' {
4
10
  const classes: { readonly [key: string]: string };
5
11
  export default classes;
@@ -0,0 +1 @@
1
+ .cos-weather-background{border-radius:12px;position:relative;overflow:hidden}.cos-weather-background__canvas{display:block}.cos-weather-background__loading-overlay{-webkit-backdrop-filter:blur(2px);backdrop-filter:blur(2px);color:#ffffffe0;pointer-events:none;background:#0c121c52;flex-direction:column;justify-content:center;align-items:center;gap:10px;font-size:13px;display:flex;position:absolute;inset:0}.cos-weather-background__loading-overlay[hidden]{display:none!important}.cos-weather-background__loading-spinner{border:3px solid #ffffff40;border-top-color:#ffffffeb;border-radius:50%;width:28px;height:28px;animation:.8s linear infinite weather-loading-spin}@keyframes weather-loading-spin{to{transform:rotate(360deg)}}@media (prefers-reduced-motion:reduce){.cos-weather-background__loading-spinner{animation:none}}
@@ -0,0 +1 @@
1
+ export * from './src/components/weatherBackground/element';