sky-ui-kit 0.1.4 → 0.1.6

package/docs/COMPONENT-API.md

@@ -191,7 +191,7 @@ export type TimeRangeQuickOption = {
 Slots: No declared content slots.
 
 ```ts
-export interface ProjectMenuItem { key: string; label: string; disabled?: boolean; icon?: Component }
+export interface ProjectMenuItem { key: string; label: string; disabled?: boolean; icon?: Component; children?: ProjectMenuItem[] }
 export interface ProjectMenuGroup { label: string; items: ProjectMenuItem[] }
 ```
 
@@ -229,7 +229,7 @@ export interface ProjectMenuGroup { label: string; items: ProjectMenuItem[] }
 Slots: No declared content slots.
 
 ```ts
-export interface MapMenuItem { key: string; label: string; icon?: Component }
+export interface MapMenuItem { key: string; label: string; icon?: Component; children?: MapMenuItem[] }
 ```
 
 ## MapTools
@@ -242,14 +242,16 @@ export interface MapMenuItem { key: string; label: string; icon?: Component }
 | horizontal | boolean | false | false |
 | icons | Record<string, Component> | false | () => ({}) |
 | items | MapToolItem[] | false | undefined / no declared default |
+| contextEnabled | boolean | false | undefined |
 
 ### Events
 
 - `update:active` — `[key: string]`
 - `tool-click` — `[key: string]`
 - `context-change` — `[enabled: boolean]`
+- `update:contextEnabled` — `[enabled: boolean]`
 
-Slots: No declared content slots.
+Slots: before, after, panel
 
 ```ts
 export interface MapToolItem { key: string; label: string; icon?: Component }
@@ -310,12 +312,17 @@ Slots: No declared content slots.
 | Name | Type | Required | Default expression |
 |---|---|---|---|
 | collapsed | boolean | false | false |
+| management | boolean | false | false |
+| groups | ProjectMenuGroup[] | false | () => [] |
+| active | string | false | '' |
+| workspaceStyle | Record<string, string> | false | undefined / no declared default |
 
 ### Events
 
-No declared events.
+- `update:active` — `[key: string]`
+- `select` — `[item: ProjectMenuItem]`
 
-Slots: default
+Slots: header, sidebar-footer, workspace, default
 
 ## WorkbenchPanel
 
@@ -357,10 +364,13 @@ Slots: icon
 | Name | Type | Required | Default expression |
 |---|---|---|---|
 | rows | ProcessChartRow[] | true | undefined / no declared default |
+| series | { name: string; rows: ProcessChartRow[] }[] | false | undefined / no declared default |
 | engine | ProcessChartEngine | true | undefined / no declared default |
 | kind | 'rain' &#124; 'flow' &#124; 'line' | false | 'rain' |
 | unit | string | false | '' |
 | label | string | false | undefined / no declared default |
+| timeZone | string | false | undefined / no declared default |
+| currentTime | string | false | undefined / no declared default |
 
 ### Events
 
@@ -383,6 +393,9 @@ export interface ProcessChartEngine { init: (element: HTMLElement) => ProcessCha
 | nodes | MapLayerNode[] | true | undefined / no declared default |
 | basemap | string | false | 'imagery' |
 | annotation | boolean | false | true |
+| closable | boolean | false | true |
+| showLocate | boolean | false | true |
+| showOpacity | boolean | false | true |
 
 ### Events
 
@@ -407,15 +420,536 @@ export interface MapLayerNode { id: string; name: string; visible?: boolean; opa
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| timelineLeft | string | false | undefined / no declared default |
+| timelineRight | string | false | undefined / no declared default |
+| leftPanelWidth | string | false | '320px' |
 | rightOpen | boolean | false | false |
 | rightPanelEnabled | boolean | false | true |
 | rightPanelWidth | string | false | '' |
+| toolbarTop | string | false | '' |
+| contentTop | string | false | '' |
+| edge | string | false | '' |
+| variant | 'workbench' &#124; 'atlas' | false | 'workbench' |
+
+### Events
+
+- `timeline-height` — `[height: number]`
+
+Slots: left, 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 |
+| title | string | false | '地图工具' |
+| showDraw | boolean | false | true |
+| showMeasure | boolean | false | true |
+| showMap | boolean | false | true |
+| showImport | boolean | false | true |
+| showExport | boolean | false | true |
 
 ### Events
 
 No declared events.
 
-Slots: top, toolbar, right, legend, timeline, content, default
+Slots: message, footer
+
+```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
+```
+
+## SpatialScopeInput
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| reservoirOnly | boolean | false | undefined / no declared default |
+| modelValue | SpatialScopeValue | true | undefined / no declared default |
+| regions | Array<{ value: string; label: string; children?: any[] }> | false | () => [] |
+| reservoirs | Array<{ value: string; label: string }> | false | () => [] |
+| loading | boolean | false | false |
+| error | string | false | '' |
+| boundaryName | string | false | '' |
+| boundaryCount | number | false | 0 |
+| previewUrl | string | false | '' |
+| previewPaths | string[] | false | () => [] |
+| busy | boolean | false | false |
+
+### Events
+
+- `update:modelValue` — `[value: SpatialScopeValue]`
+- `upload` — `[file: File]`
+- `draw` — `[]`
+- `view` — `[]`
+- `clear` — `[]`
+- `retry` — `[]`
+
+Slots: No declared content slots.
+
+```ts
+export interface SpatialScopeValue { mode: 'catalog' | 'upload' | 'draw'; regionCodes: string[]; reservoirCodes: string[]; boundaryTarget?: 'region' | 'reservoir'; reservoirName?: string }
+```
+
+## MapEditorDialog
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| modelValue | boolean | true | undefined / no declared default |
+| title | string | false | '地图范围编辑' |
+| hint | string | false | '选择面、矩形或圆进行绘制；双击或 Enter 完成，Esc 取消，完成后可拖动编辑。' |
+
+### Events
+
+- `update:modelValue` — `[value: boolean]`
+- `ready` — `[host: HTMLElement]`
+
+Slots: map, tools, message, footer
+
+## ManagementFormDialog
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| modelValue | boolean | true | undefined / no declared default |
+| title | string | false | '编辑信息' |
+| split | boolean | false | true |
+| busy | boolean | false | false |
+
+### Events
+
+- `update:modelValue` — `[value:boolean]`
+
+Slots: message, primary, default, footer
+
+## ManagementResourceLayout
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | false | undefined / no declared default |
+| description | string | false | undefined / no declared default |
+| showIntro | boolean | false | true |
+
+### Events
+
+No declared events.
+
+Slots: summary, filters, heading, actions, default
+
+## GlobalMapLayerDock
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | false | '地图叠加图层' |
+| subtitle | string | false | '' |
+| enabled | boolean | false | false |
+| expanded | boolean | false | false |
+
+### Events
+
+- `update:enabled` — `[value:boolean]`
+- `update:expanded` — `[value:boolean]`
+
+Slots: actions, default, status
+
+## MapPointProcessDialog
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| modelValue | boolean | true | undefined / no declared default |
+| title | string | false | '降水预报过程' |
+| subtitle | string | false | '' |
+| loading | boolean | false | false |
+| error | string | false | '' |
+| rows | ProcessChartRow[] | true | undefined / no declared default |
+| engine | ProcessChartEngine | true | undefined / no declared default |
+| unit | string | false | 'mm' |
+
+### Events
+
+- `update:modelValue` — `[value:boolean]`
+
+Slots: No declared content slots.
+
+## MapFeatureListPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | true | undefined / no declared default |
+| rows | Record<string, any>[] | false | ()=>[] |
+| columns | {prop:string;label:string;width?:number}[] | false | ()=>[] |
+| searchFields | string[] | false | ()=>['name'] |
+| searchPlaceholder | string | false | '搜索名称' |
+| emptyText | string | false | '暂无数据' |
+
+### Events
+
+- `close` — `[]`
+- `locate` — `[row:Record<string,any>]`
+
+Slots: footer
+
+## MapBottomProcessPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | true | undefined / no declared default |
+| subtitle | string | false | '' |
+| demo | boolean | false | false |
+| series | {name:string;rows:ProcessChartRow[]}[] | true | undefined / no declared default |
+| engine | ProcessChartEngine | true | undefined / no declared default |
+| unit | string | false | 'mm' |
+| timeZone | string | false | undefined / no declared default |
+| currentTime | string | false | undefined / no declared default |
+
+### Events
+
+- `close` — `[]`
+
+Slots: No declared content slots.
+
+## MapWorkspacePanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | true | undefined / no declared default |
+| subtitle | string | false | undefined / no declared default |
+
+### Events
+
+No declared events.
+
+Slots: actions, default, footer
+
+## NationalHydroSidebar
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| selected | SelectedFeature | false | () => ({ rid: '', streamOrder: null }) |
+| locationLng | string | false | '' |
+| locationLat | string | false | '' |
+| meteoSource | string | false | 'wrf' |
+| model | string | false | 'chm' |
+| batchId | string | false | '' |
+| batchList | BatchOption[] | false | () => [] |
+| selectedTimeZone | string | false | '' |
+| timeZoneOptions | TimeZoneOption[] | false | () => [] |
+
+### Events
+
+- `undefined` — `void`
+- `undefined` — `void`
+- `undefined` — `void`
+- `undefined` — `void`
+- `undefined` — `void`
+- `undefined` — `void`
+- `undefined` — `void`
+
+Slots: status
+
+```ts
+type LocationField = 'lng' | 'lat'
+export interface SelectedFeature {
+    rid?: string | number
+    streamOrder?: string | number | null
+  }
+export interface BatchOption {
+    batchId?: string | number
+    [key: string]: unknown
+  }
+export interface TimeZoneOption {
+    label: string
+    value: string
+  }
+```
+
+## MapSchemeSelect
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| modelValue | string | false | '' |
+| options | {value:string;label:string}[] | true | undefined / no declared default |
+| placeholder | string | false | '选择预报方案' |
+
+### Events
+
+- `update:modelValue` — `[value:string]`
+- `create` — `[]`
+
+Slots: No declared content slots.
+
+## DefenseMapLayout
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+
+### Events
+
+No declared events.
+
+Slots: default
 
 ## UiAffix