sky-ui-kit 0.1.4 → 0.1.5

package/docs/AI-CHANGELOG.md

@@ -214,3 +214,10 @@ WorkbenchShell 添加 management-layout 样式变体：顶部栏、侧栏、滚
 ## 2026-10-14 · 0.1.4 发布准备
 
 汇集当前工作区地图布局 TemplateLayout、工作台与管理样式、图层控制、过程图 line/label 以及菜单修订。重新生成 API 与 AI 文档，发布状态以 npm 注册表为准。
+
+
+2026-10-14 / dev.20：一体机雨量站按参考平台 /atlas/elments/rain 原源码迁移，保留 RainfallRankingTable、RainfallProcessChart、MapValueLegend 的 DOM、CSS、分级与交互，主题变量仅映射到既有 userssite 命名。公开 RainfallRankingTable、RainfallProcessChart、MapValueLegend、AtlasRankingPanel、AtlasProcessPanel、AtlasProcessChart、StationComparisonPanel、MapOperationPanel、SpaceAnalysisPanel；MapTools 新增 before/after/panel 插槽。TemplateLayout 增加 variant=atlas，采用原页面右栏贴右、工具栏右栏左侧、右下图例与底部过程面板的避让几何，workbench 默认行为保留。图表通过 provide('sky-chart-engine', engine) 注入，无业务请求或地图实例进入组件库。MapOperationPanel 接受 tools 和 drawTools；SpaceAnalysisPanel 接受 selectionStore 与 provider，绘制、GIS、空间分析业务由消费方注入。消费项目新雨量页通过平台地图单例绘制非聚合圆点，多数据源各自独立图层，原七级雨量颜色和缩放半径；复用原时间范围、数据源差量请求与批量过程接口。未构建、未打包、未浏览器验证、未发布 npm。需用户发布含新出口版本后更新消费包；当前项目保留旧包兼容显示，避免缺少新出口导致白屏。
+
+2026-10-14：TemplateLayout 新增 contentTop（布局相对地图容器的顶部避让）和 edge（右栏与工具栏共用边距）。工具栏默认顶部跟随右栏，移除186独立偏移；toolbar插槽内MapTools/map-toolbar取消再次绝对定位，避免偏移叠加。当前仅源码修改，发布时必须重新构建产物，再升级版本发布；消费项目仍安装0.1.4，尚未获得此修复。
+
+0.1.5 / 2026-10-14：右侧插槽容器采用flex并限制内部溢出，AtlasRankingPanel铺满容器；图例默认底部与右侧面板共用 --template-right-bottom，过程图展开时才额外避让。contentTop/edge控制顶部工作区和共同间距，toolbar插槽的工具栏取消重复绝对定位。修复雨量分级与虚拟行局部CSS变量命名、过程图tooltip参数类型。移除误加的本地消费项目file依赖，库不能依赖使用它的业务项目。打包和类型检查通过；地图页面已检查工具栏/右面板顶部76px、面板/图例底部874px对齐。

package/docs/COMPONENT-API.md

@@ -249,7 +249,7 @@ export interface MapMenuItem { key: string; label: string; icon?: Component }
 - `tool-click` — `[key: string]`
 - `context-change` — `[enabled: boolean]`
 
-Slots: No declared content slots.
+Slots: before, after, panel
 
 ```ts
 export interface MapToolItem { key: string; label: string; icon?: Component }
@@ -410,6 +410,10 @@ export interface MapLayerNode { id: string; name: string; visible?: boolean; opa
 | rightOpen | boolean | false | false |
 | rightPanelEnabled | boolean | false | true |
 | rightPanelWidth | string | false | '' |
+| toolbarTop | string | false | '' |
+| contentTop | string | false | '' |
+| edge | string | false | '' |
+| variant | 'workbench' | 'atlas' | false | 'workbench' |
 
 ### Events
 
@@ -417,6 +421,262 @@ No declared events.
 
 Slots: top, toolbar, right, legend, timeline, content, default
 
+## RainfallRankingTable
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| rows | RainfallRankingRow[] | false | () => [] |
+| period | string | false | '24h' |
+| unit | string | false | 'mm' |
+| dataSource | string[] | false | () => [] |
+| dataSourceOptions | DataSourceOption[] | false | () => [] |
+| dataSourceLoading | boolean | false | false |
+| rainfallLevels | RainfallLevelOption[] | false | () => [
+    { key: 'extremeStorm', label: '≥250', min: 250, color: 'rgba(129, 0, 64, 1)', textColor: '#ffffff' },
+    { key: 'hardStorm', label: '100~250', min: 100, color: 'rgba(244, 5, 237, 1)', textColor: '#ffffff' },
+    { key: 'storm', label: '50~100', min: 50, color: 'rgba(2, 1, 252, 1)', textColor: '#ffffff' },
+    { key: 'heavy', label: '25~50', min: 25, color: 'rgba(100, 184, 245, 1)', textColor: '#ffffff' },
+    { key: 'moderate', label: '10~25', min: 10, color: 'rgba(61, 185, 63, 1)', textColor: '#ffffff' },
+    { key: 'light', label: '0.5~10', min: 0.5, color: 'rgba(164, 243, 143, 1)', textColor: '#1f2937' },
+    { key: 'none', label: '0~0.5', min: 0, color: '#ffffff', textColor: '#334155' }
+  ] |
+| visibleLevelKeys | RainfallLevelKey[] | false | () => ['none', 'light', 'moderate', 'heavy', 'storm', 'hardStorm', 'extremeStorm'] |
+| loading | boolean | false | false |
+
+### Events
+
+- `close` — `[]`
+- `locate` — `[row: RainfallRankingRow]`
+- `rangeChange` — `[payload: { label: string, range: DateRangeValue }]`
+- `sourceChange` — `[value: string[], payload: DataSourceChangePayload]`
+- `levelVisibilityChange` — `[key: RainfallLevelKey, visible: boolean]`
+
+Slots: No declared content slots.
+
+```ts
+type SortDirection = 'asc' | 'desc'
+export type RainfallLevelKey = 'none' | 'light' | 'moderate' | 'heavy' | 'storm' | 'hardStorm' | 'extremeStorm'
+type RangeShortcutKey = 'current' | '1h' | '24h' | '3d' | '7d' | '1m'
+type DateRangeValue = [string, string]
+type RangeShortcut = {
+  key: RangeShortcutKey
+  label: string
+  amount: number
+  unit: 'current' | 'hour' | 'day' | 'month',
+  type: '1' | '2' // 1是显示日期 2是显示文字
+}
+export type DataSourceOption = {
+  label: string
+  value: string
+}
+export type DataSourceChangePayload = {
+  selectedSources: string[]
+  addedSources: string[]
+  removedSources: string[]
+}
+export type RainfallLevelOption = {
+  key: RainfallLevelKey
+  label: string
+  min: number
+  color: string
+  textColor: string
+}
+export type RainfallRankingRow = {
+  id?: string | number
+  stationName: string
+  rainfall: number
+  region?: string
+  longitude?: number
+  latitude?: number
+  elevation?: number | null
+  dataSource?: string
+  dataSourceName?: string
+  sourceCode?: string | number
+}
+```
+
+## RainfallProcessChart
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| stations | RainfallRankingRow[] | false | () => [] |
+| selectedStations | RainfallRankingRow[] | false | () => [] |
+| rowsByStation | Record<string, RainHourlyPrecipitation[]> | false | () => ({}) |
+| range | [string, string] | true | undefined / no declared default |
+| loading | boolean | false | false |
+
+### Events
+
+- `close` — `[]`
+- `query` — `[payload: { stationIds: StationId[], range: [string, string], quickKey?: QuickRangeKey }]`
+
+Slots: No declared content slots.
+
+```ts
+type EChartsOption = Record<string, any>
+type RainHourlyPrecipitation = { dt: string; drp?: number | null; [key: string]: number | string | null | undefined }
+type StationId = string
+type ProcessSeries = {
+  station: RainfallRankingRow
+  rainfallName: string
+  totalName: string
+  rainfallData: Array<number | null>
+  totalData: number[]
+  latestTotal: number
+}
+type QuickRangeKey = 'current' | '24h' | '7d' | '1m' | '3m'
+```
+
+## MapValueLegend
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | true | undefined / no declared default |
+| layerName | string | false | '' |
+| unit | string | false | '' |
+| variant | MapValueLegendVariant | false | 'list' |
+| items | MapValueLegendItem[] | false | () => [] |
+| gradientStops | MapValueLegendGradientStop[] | false | () => [] |
+| tickLabels | string[] | false | () => [] |
+| allVisible | boolean | false | true |
+| toggleable | boolean | false | true |
+
+### Events
+
+- `toggle` — `[key: string, visible: boolean, layerName: string]`
+- `toggleAll` — `[visible: boolean, layerName: string]`
+
+Slots: No declared content slots.
+
+```ts
+type MapValueLegendVariant = 'list' | 'gradient'
+export type MapValueLegendItem = {
+  key: string
+  label: string
+  color: string
+  count?: number
+  visible?: boolean
+  empty?: boolean
+}
+export type MapValueLegendGradientStop = {
+  offset: number
+  color: string
+}
+```
+
+## AtlasRankingPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+
+### Events
+
+No declared events.
+
+Slots: default
+
+## AtlasProcessPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+
+### Events
+
+No declared events.
+
+Slots: default
+
+## AtlasProcessChart
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| option | EChartsOption &#124; null | false | null |
+| loading | boolean | false | false |
+| empty | boolean | false | false |
+| loadingText | string | false | '加载中...' |
+| emptyText | string | false | '暂无过程线数据' |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+type EChartsOption = Record<string, any>
+```
+
+## StationComparisonPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| rows | { id: string; label: string }[] | true | undefined / no declared default |
+| selected | string[] | true | undefined / no declared default |
+
+### Events
+
+- `update:selected` — `[ids: string[]]`
+- `compare` — `[]`
+- `locate` — `[id: string]`
+- `close` — `[]`
+
+Slots: No declared content slots.
+
+## MapOperationPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| tools | any | true | undefined / no declared default |
+| drawTools | { mode: string; label: string; iconPath: string }[] | true | undefined / no declared default |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+type MapDrawMode = string
+type MapMeasureMode = string
+type MapOperationSnapshot = any
+```
+
+## SpaceAnalysisPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| selectionStore | any | true | undefined / no declared default |
+| provider | any | true | undefined / no declared default |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+type GisSelectionRecord = any
+type SpaceAnalysisAction = any
+```
+
 ## UiAffix
 
 固钉 · 导航组件. Original: ElAffix. Import from: sky-ui-kit. [API](https://element-plus.org/zh-CN/component/affix.html). See dist/components/element-plus.d.ts.

package/docs/CONSUMERS.md

@@ -84,3 +84,10 @@ D:/dev/TasksBot 已从本地 tgz 切换为 npm sky-ui-kit@0.1.3。安装包多
 
 
 2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。
+
+
+2026-10-14 / dev.20：一体机雨量站按参考平台 /atlas/elments/rain 原源码迁移，保留 RainfallRankingTable、RainfallProcessChart、MapValueLegend 的 DOM、CSS、分级与交互，主题变量仅映射到既有 userssite 命名。公开 RainfallRankingTable、RainfallProcessChart、MapValueLegend、AtlasRankingPanel、AtlasProcessPanel、AtlasProcessChart、StationComparisonPanel、MapOperationPanel、SpaceAnalysisPanel；MapTools 新增 before/after/panel 插槽。TemplateLayout 增加 variant=atlas，采用原页面右栏贴右、工具栏右栏左侧、右下图例与底部过程面板的避让几何，workbench 默认行为保留。图表通过 provide('sky-chart-engine', engine) 注入，无业务请求或地图实例进入组件库。MapOperationPanel 接受 tools 和 drawTools；SpaceAnalysisPanel 接受 selectionStore 与 provider，绘制、GIS、空间分析业务由消费方注入。消费项目新雨量页通过平台地图单例绘制非聚合圆点，多数据源各自独立图层，原七级雨量颜色和缩放半径；复用原时间范围、数据源差量请求与批量过程接口。未构建、未打包、未浏览器验证、未发布 npm。需用户发布含新出口版本后更新消费包；当前项目保留旧包兼容显示，避免缺少新出口导致白屏。
+
+2026-10-14：TemplateLayout 新增 contentTop（布局相对地图容器的顶部避让）和 edge（右栏与工具栏共用边距）。工具栏默认顶部跟随右栏，移除186独立偏移；toolbar插槽内MapTools/map-toolbar取消再次绝对定位，避免偏移叠加。当前仅源码修改，发布时必须重新构建产物，再升级版本发布；消费项目仍安装0.1.4，尚未获得此修复。
+
+0.1.5 / 2026-10-14：右侧插槽容器采用flex并限制内部溢出，AtlasRankingPanel铺满容器；图例默认底部与右侧面板共用 --template-right-bottom，过程图展开时才额外避让。contentTop/edge控制顶部工作区和共同间距，toolbar插槽的工具栏取消重复绝对定位。修复雨量分级与虚拟行局部CSS变量命名、过程图tooltip参数类型。移除误加的本地消费项目file依赖，库不能依赖使用它的业务项目。打包和类型检查通过；地图页面已检查工具栏/右面板顶部76px、面板/图例底部874px对齐。

package/docs/CSS-THEME.md

@@ -126,3 +126,10 @@ business-embed：management.css 提供工作台业务 iframe 布局，保留顶
 
 
 2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。
+
+
+2026-10-14 / dev.20：一体机雨量站按参考平台 /atlas/elments/rain 原源码迁移，保留 RainfallRankingTable、RainfallProcessChart、MapValueLegend 的 DOM、CSS、分级与交互，主题变量仅映射到既有 userssite 命名。公开 RainfallRankingTable、RainfallProcessChart、MapValueLegend、AtlasRankingPanel、AtlasProcessPanel、AtlasProcessChart、StationComparisonPanel、MapOperationPanel、SpaceAnalysisPanel；MapTools 新增 before/after/panel 插槽。TemplateLayout 增加 variant=atlas，采用原页面右栏贴右、工具栏右栏左侧、右下图例与底部过程面板的避让几何，workbench 默认行为保留。图表通过 provide('sky-chart-engine', engine) 注入，无业务请求或地图实例进入组件库。MapOperationPanel 接受 tools 和 drawTools；SpaceAnalysisPanel 接受 selectionStore 与 provider，绘制、GIS、空间分析业务由消费方注入。消费项目新雨量页通过平台地图单例绘制非聚合圆点，多数据源各自独立图层，原七级雨量颜色和缩放半径；复用原时间范围、数据源差量请求与批量过程接口。未构建、未打包、未浏览器验证、未发布 npm。需用户发布含新出口版本后更新消费包；当前项目保留旧包兼容显示，避免缺少新出口导致白屏。
+
+2026-10-14：TemplateLayout 新增 contentTop（布局相对地图容器的顶部避让）和 edge（右栏与工具栏共用边距）。工具栏默认顶部跟随右栏，移除186独立偏移；toolbar插槽内MapTools/map-toolbar取消再次绝对定位，避免偏移叠加。当前仅源码修改，发布时必须重新构建产物，再升级版本发布；消费项目仍安装0.1.4，尚未获得此修复。
+
+0.1.5 / 2026-10-14：右侧插槽容器采用flex并限制内部溢出，AtlasRankingPanel铺满容器；图例默认底部与右侧面板共用 --template-right-bottom，过程图展开时才额外避让。contentTop/edge控制顶部工作区和共同间距，toolbar插槽的工具栏取消重复绝对定位。修复雨量分级与虚拟行局部CSS变量命名、过程图tooltip参数类型。移除误加的本地消费项目file依赖，库不能依赖使用它的业务项目。打包和类型检查通过；地图页面已检查工具栏/右面板顶部76px、面板/图例底部874px对齐。

package/docs/ELEMENT-PLUS-COVERAGE.md

@@ -1,6 +1,6 @@
 # Element Plus 完整组件目录
 
-基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 17 个项目特色组件。
+基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 26 个项目特色组件。
 
 清单覆盖官方组件注册表及服务 / 指令，不包含内部工具函数。出口覆盖不代表所有组件的交互、独立示例和视觉状态均已验证。网站每项均提供导入和官方 API 索引，新增组合示例见 AI-GUIDE.md。
 

package/docs/INTEGRATION.md

@@ -138,3 +138,10 @@ MapLayerControl 参考平台 LayerControl/LayerTreeNode，提供底图选择、
 ## 地图胶囊选中修复（0.1.3-dev.11）
 
 flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+
+
+2026-10-14 / dev.20：一体机雨量站按参考平台 /atlas/elments/rain 原源码迁移，保留 RainfallRankingTable、RainfallProcessChart、MapValueLegend 的 DOM、CSS、分级与交互，主题变量仅映射到既有 userssite 命名。公开 RainfallRankingTable、RainfallProcessChart、MapValueLegend、AtlasRankingPanel、AtlasProcessPanel、AtlasProcessChart、StationComparisonPanel、MapOperationPanel、SpaceAnalysisPanel；MapTools 新增 before/after/panel 插槽。TemplateLayout 增加 variant=atlas，采用原页面右栏贴右、工具栏右栏左侧、右下图例与底部过程面板的避让几何，workbench 默认行为保留。图表通过 provide('sky-chart-engine', engine) 注入，无业务请求或地图实例进入组件库。MapOperationPanel 接受 tools 和 drawTools；SpaceAnalysisPanel 接受 selectionStore 与 provider，绘制、GIS、空间分析业务由消费方注入。消费项目新雨量页通过平台地图单例绘制非聚合圆点，多数据源各自独立图层，原七级雨量颜色和缩放半径；复用原时间范围、数据源差量请求与批量过程接口。未构建、未打包、未浏览器验证、未发布 npm。需用户发布含新出口版本后更新消费包；当前项目保留旧包兼容显示，避免缺少新出口导致白屏。
+
+2026-10-14：TemplateLayout 新增 contentTop（布局相对地图容器的顶部避让）和 edge（右栏与工具栏共用边距）。工具栏默认顶部跟随右栏，移除186独立偏移；toolbar插槽内MapTools/map-toolbar取消再次绝对定位，避免偏移叠加。当前仅源码修改，发布时必须重新构建产物，再升级版本发布；消费项目仍安装0.1.4，尚未获得此修复。
+
+0.1.5 / 2026-10-14：右侧插槽容器采用flex并限制内部溢出，AtlasRankingPanel铺满容器；图例默认底部与右侧面板共用 --template-right-bottom，过程图展开时才额外避让。contentTop/edge控制顶部工作区和共同间距，toolbar插槽的工具栏取消重复绝对定位。修复雨量分级与虚拟行局部CSS变量命名、过程图tooltip参数类型。移除误加的本地消费项目file依赖，库不能依赖使用它的业务项目。打包和类型检查通过；地图页面已检查工具栏/右面板顶部76px、面板/图例底部874px对齐。