sky-ui-kit 0.1.2 → 0.1.4

package/docs/CONSUMERS.md

@@ -0,0 +1,86 @@
+# 一体机组件库接入约定
+
+用户要求：一体机 Web 的通用组件全部使用 sky-ui-kit，缺失能力先补充库，再由应用消费。
+
+消费项目：D:/Work/01-项目code/一体化平台/一体机项目。库源码：D:/sky-ui-kit。参考业务平台只读。
+
+新增 WorkbenchShell、WorkbenchPanel、MetricCard、ProcessChart；MapTools 支持 items 自定义工具。ProcessChart 由应用注入 ECharts engine，库不耦合业务 API。基础表单、按钮、导航、表格、卡片使用库公开出口。地图引擎、业务查询、数据快照留在应用。
+
+CSS 入口按顺序仅导入一次 Element Plus CSS 和 sky-ui-kit/style.css。暗色使用 html.theme-dark。工作台样式隔离在 .sky-workbench 内。
+
+本次使用 0.1.3-dev.0 本地开发包，未发布 npm。npm 正式版本仍为 0.1.2。后续修改必须同步 AI 文档，构建、打包后更新应用 vendor 包及锁文件。不要提交、推送或发布，除非用户明确要求。
+
+其他对话进入上述目录时应读取 AGENTS.md 和本文件；这是磁盘上的共享约定，不代表自动向其他聊天发送消息。
+
+验证：库完整类型检查、包构建、应用 ui:check 与生产构建通过。浏览器验证 RID 563666 返回流量过程，深浅色组件切换正常，数据卡片可显示。构建存在大体积 chunk 提示，后续可继续拆分。
+
+## 2026-10-13：顶部菜单修复（0.1.3-dev.1）
+
+删除工作台残留的 primary-nav 样式，选中效果由 ProjectMenu 统一负责。顶部菜单按内容宽度居中，不再拉满或撑满头部高度；横向菜单不换行，仅允许横向滚动并隐藏滚动条，保留滚轮、触摸和键盘操作。应用升级本地开发包，未发布 npm。
+
+## 2026-10-13：左侧胶囊布局（0.1.3-dev.2）
+
+工作台左侧采用留白悬浮圆角侧栏，内部菜单使用胶囊圆角，移除选中项侧边竖线和嵌套菜单外框。数据范围卡片统一圆角。样式限定 sky-workbench，不改变独立 ProjectMenu。更新本地消费包，未发布 npm。
+
+## 2026-10-13：地图布局（0.1.3-dev.3）
+
+一体机应用彻底移除左侧工作台、数据范围及侧栏开关，导航由顶部菜单提供。WorkbenchShell collapsed=true 使用单列布局，地图占满导航下方；指标、列表、工具和过程图保持悬浮。修复 collapsed 根节点选择器，取消地图定位的侧栏留白。该布局替代此前胶囊侧栏方案。
+
+## 地图左侧胶囊导航（0.1.3-dev.4）
+
+移除顶部横向菜单，使用 ProjectMenu 在地图左侧悬浮展示五个胶囊入口；不占侧栏列、不恢复数据范围与终端信息。工作台提供 map-capsule-menu 样式变体。
+
+## 透明地图顶部栏（0.1.3-dev.5）
+
+地图布局下头部绝对定位悬浮，无背景、边框或阴影；地图延伸至页面顶部。业务标题、指标、列表保留顶部避让。独立带侧栏布局不受影响。
+
+## 地图排版统一（0.1.3-dev.6）
+
+左侧标题与胶囊导航对齐，去除重复面包屑及介绍；四项指标合为紧凑统计栏。右侧与过程面板使用实底、统一圆角和留白，图例固定左下。过程图初始隐藏，查询站点或预报后打开。
+
+## 顶部可读性与地图穿透（0.1.3-dev.7）
+
+品牌和操作按钮分组使用实底胶囊，顶部整条容器 pointer-events:none，仅品牌及操作区恢复 auto。空白处拖拽、滚轮交给地图；去掉冗余本地应用文字和分隔线。
+
+## 使用正式地图胶囊菜单（0.1.3-dev.8）
+
+一体机左侧改用已有 MapSideMenu，保留搜索、图标模式、分组折叠及选中样式。替代此前 ProjectMenu 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+## 一级地图胶囊菜单（0.1.3-dev.9）
+
+MapSideMenu 新增 flat:boolean，默认 false 保持分组模式。flat=true 隐藏父节点，将各项显示为一级胶囊，去除缩进及连线。一体机使用 flat=true 展示五个主菜单。
+
+## 图层控制封装（0.1.3-dev.10）
+
+MapLayerControl 参考平台 LayerControl/LayerTreeNode，提供底图选择、注记、树分组、搜索、显隐、拖拽排序、透明度、定位与可移除图层事件。数据及地图操作由消费方提供，未绑定平台 Pinia 或假服务。
+
+## 地图胶囊选中修复（0.1.3-dev.11）
+
+flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+
+## 一体机正式包接入（2026-10-13）
+
+D:/dev/TasksBot 已从本地 tgz 切换为 npm sky-ui-kit@0.1.3。安装包多选的选中、取消、清空和外部 activeKeys 同步已浏览器验证。五个主菜单继续作为单选业务导航；多选消费者使用 change/activeKeys 获取最终集合，select 在取消时也会触发。具体交接见消费项目 docs/UI-KIT-INTEGRATION.md。
+# 一体机管理布局演示（2026-10-13）
+
+四个地图主菜单保留；数据接入移至右上角账号演示登录后的管理平台。管理信息为固定假数据，无真实认证和后台修改。WorkbenchShell 的 management-layout 及 management.css 由共享库维护；演示业务留在消费项目。
+
+
+## 独立演示登录页（0.1.3-dev.13）
+
+账号入口：当前会话已演示登录则直接进入管理平台；未登录显示独立登录页，移除原弹窗。模拟账号通过 sessionStorage 保存，退出时清除，不是真实认证。登录页共享样式由库 management.css 提供，当前本地 dev.13 测试包；登录、刷新后直达管理平台及构建已验证。
+
+## 平台业务菜单接入（2026-10-13）
+
+删除实时雨水情独立入口，综合一张图保留雨量站/水库/河道/视频及历史查询。气象预报入口更名中尺度数值预报，沿用已接入的 WRF 小时产品。水库调度沿用参考平台 ReservoirDispatch.vue 的外部 dashboard iframe，不执行调度写操作。气象大模型接入 GraphCast 六要素、发布批次、时次 WMS 与点位过程接口，参考 weatherLlm/api/weatherLlm.ts、weatherLlmConfig.ts；不虚构新批次。图层依赖 geoserver 65255 服务，生产需同样配置 /graphcast-wms 反向代理。业务 iframe 共享布局样式在 management.css。当前共享库为 dev.14 本地测试包，未发布 npm。
+
+0.1.3-dev.15：工作台没有 status-bar 时取消地图底部 30px 预留，避免空白边。保留带状态栏消费方的布局。
+
+2026-10-14：新增工作台 map-top-navigation 浮动顶部导航、forecast-form 预报表单与 forecast-product-switch 产品选择布局。四个顶部菜单由消费方提供；地图交互仍通过未覆盖区域。窄屏导航换行，右侧面板避让。无业务接口进入组件库。
+
+0.1.3-dev.17：预报表单补充两列色带与评价图例布局；forecast-workspace 的过程面板取消左侧菜单预留。消费方负责真实色阶、指标分类和过程查询。
+
+0.1.3-dev.18：ProcessChart 增加 kind=line 与 label 可选属性，用于温度、风速等通用过程线与可访问名称；保留 rain/flow 现有行为，不将所有非降雨要素称为流量。
+
+
+2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。

package/docs/CSS-THEME.md

@@ -61,4 +61,68 @@ import 'sky-ui-kit/global.css'
 
 全局缩放/主题融合以 GLOBAL-ADAPTATION.md 为准：原 App.vue 写根 --cp-vfit-scale，scoped-vfit 不重置它；保留原主题 store。不要在已消费 cp token 的组件外再增加第二套缩放。body 浮层核对根变量，局部变量需显式接入。
 
-SvgIcon 样式仅作用于 scoped 的 .sky-svg-icon，不覆盖原生 ElIcon 或原项目 .svg-icon。默认继承 currentColor；数字 size 读取 --cp-font-1，缺失回退 1px；固定色 / 多色路径保持原配色。公共样式仍只在 main.ts 引入一次。
+SvgIcon 样式仅作用于 scoped 的 .sky-svg-icon，不覆盖原生 ElIcon 或原项目 .svg-icon。默认继承 currentColor；数字 size 读取 --cp-font-1，缺失回退 1px；固定色 / 多色路径保持原配色。公共样式仍只在 main.ts 引入一次。
+
+## 2026-10-13：一体机本地开发接入
+
+新增四个工作台组件和 MapTools.items。工作台 CSS 在 .sky-workbench 下隔离，使用库主题变量；应用消费本地 0.1.3-dev.0，未发布。详情见 [消费项目记录](CONSUMERS.md)。
+
+## 2026-10-13：顶部菜单修复（0.1.3-dev.1）
+
+删除工作台残留的 primary-nav 样式，选中效果由 ProjectMenu 统一负责。顶部菜单按内容宽度居中，不再拉满或撑满头部高度；横向菜单不换行，仅允许横向滚动并隐藏滚动条，保留滚轮、触摸和键盘操作。应用升级本地开发包，未发布 npm。
+
+## 2026-10-13：左侧胶囊布局（0.1.3-dev.2）
+
+工作台左侧采用留白悬浮圆角侧栏，内部菜单使用胶囊圆角，移除选中项侧边竖线和嵌套菜单外框。数据范围卡片统一圆角。样式限定 sky-workbench，不改变独立 ProjectMenu。更新本地消费包，未发布 npm。
+
+## 2026-10-13：地图布局（0.1.3-dev.3）
+
+一体机应用彻底移除左侧工作台、数据范围及侧栏开关，导航由顶部菜单提供。WorkbenchShell collapsed=true 使用单列布局，地图占满导航下方；指标、列表、工具和过程图保持悬浮。修复 collapsed 根节点选择器，取消地图定位的侧栏留白。该布局替代此前胶囊侧栏方案。
+
+## 地图左侧胶囊导航（0.1.3-dev.4）
+
+移除顶部横向菜单，使用 ProjectMenu 在地图左侧悬浮展示五个胶囊入口；不占侧栏列、不恢复数据范围与终端信息。工作台提供 map-capsule-menu 样式变体。
+
+## 透明地图顶部栏（0.1.3-dev.5）
+
+地图布局下头部绝对定位悬浮，无背景、边框或阴影；地图延伸至页面顶部。业务标题、指标、列表保留顶部避让。独立带侧栏布局不受影响。
+
+## 地图排版统一（0.1.3-dev.6）
+
+左侧标题与胶囊导航对齐，去除重复面包屑及介绍；四项指标合为紧凑统计栏。右侧与过程面板使用实底、统一圆角和留白，图例固定左下。过程图初始隐藏，查询站点或预报后打开。
+
+## 顶部可读性与地图穿透（0.1.3-dev.7）
+
+品牌和操作按钮分组使用实底胶囊，顶部整条容器 pointer-events:none，仅品牌及操作区恢复 auto。空白处拖拽、滚轮交给地图；去掉冗余本地应用文字和分隔线。
+
+## 使用正式地图胶囊菜单（0.1.3-dev.8）
+
+一体机左侧改用已有 MapSideMenu，保留搜索、图标模式、分组折叠及选中样式。替代此前 ProjectMenu 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+## 一级地图胶囊菜单（0.1.3-dev.9）
+
+MapSideMenu 新增 flat:boolean，默认 false 保持分组模式。flat=true 隐藏父节点，将各项显示为一级胶囊，去除缩进及连线。一体机使用 flat=true 展示五个主菜单。
+
+## 图层控制封装（0.1.3-dev.10）
+
+MapLayerControl 参考平台 LayerControl/LayerTreeNode，提供底图选择、注记、树分组、搜索、显隐、拖拽排序、透明度、定位与可移除图层事件。数据及地图操作由消费方提供，未绑定平台 Pinia 或假服务。
+
+## 地图胶囊选中修复（0.1.3-dev.11）
+
+flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+# 管理平台布局
+
+management.css 由 WorkbenchShell 引入，management-layout 提供管理平台顶部栏、侧栏与可滚动内容区；management-metrics、management-card、account-entry 为相关共享样式。遵循工作台现有主题变量，登录表单使用 UiDialog / UiForm。业务认证与数据不在库中。
+
+独立登录页共享样式：management-login-page、login-layout、login-card 在 management.css 内维护，桌面双列、窄屏单卡。
+
+business-embed：management.css 提供工作台业务 iframe 布局，保留顶部与左侧导航操作区域。
+
+0.1.3-dev.15：工作台没有 status-bar 时取消地图底部 30px 预留，避免空白边。保留带状态栏消费方的布局。
+
+2026-10-14：新增工作台 map-top-navigation 浮动顶部导航、forecast-form 预报表单与 forecast-product-switch 产品选择布局。四个顶部菜单由消费方提供；地图交互仍通过未覆盖区域。窄屏导航换行，右侧面板避让。无业务接口进入组件库。
+
+0.1.3-dev.17：预报表单补充两列色带与评价图例布局；forecast-workspace 的过程面板取消左侧菜单预留。消费方负责真实色阶、指标分类和过程查询。
+
+
+2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。

package/docs/ELEMENT-PLUS-COVERAGE.md

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

package/docs/INTEGRATION.md

@@ -87,3 +87,54 @@ Header / SideMenu / MainLayout 的路由、权限、用户和布局状态；Laye
 ## TemplateLayout 地图业务布局
 
 原 TemplateLayout 保留在业务应用中，组件库布局页提供独立区域说明和组合轮廓示例。替换其子组件时保留 ui store 右栏状态、地图工具事件、图层与区域逻辑、默认图例和主题弹窗；保留图例/时间轴 ResizeObserver 测量及卸载释放。不能直接从 sky-ui-kit 导入 TemplateLayout。
+
+## 2026-10-13：一体机本地开发接入
+
+新增四个工作台组件和 MapTools.items。工作台 CSS 在 .sky-workbench 下隔离，使用库主题变量；应用消费本地 0.1.3-dev.0，未发布。详情见 [消费项目记录](CONSUMERS.md)。
+
+## 2026-10-13：顶部菜单修复（0.1.3-dev.1）
+
+删除工作台残留的 primary-nav 样式，选中效果由 ProjectMenu 统一负责。顶部菜单按内容宽度居中，不再拉满或撑满头部高度；横向菜单不换行，仅允许横向滚动并隐藏滚动条，保留滚轮、触摸和键盘操作。应用升级本地开发包，未发布 npm。
+
+## 2026-10-13：左侧胶囊布局（0.1.3-dev.2）
+
+工作台左侧采用留白悬浮圆角侧栏，内部菜单使用胶囊圆角，移除选中项侧边竖线和嵌套菜单外框。数据范围卡片统一圆角。样式限定 sky-workbench，不改变独立 ProjectMenu。更新本地消费包，未发布 npm。
+
+## 2026-10-13：地图布局（0.1.3-dev.3）
+
+一体机应用彻底移除左侧工作台、数据范围及侧栏开关，导航由顶部菜单提供。WorkbenchShell collapsed=true 使用单列布局，地图占满导航下方；指标、列表、工具和过程图保持悬浮。修复 collapsed 根节点选择器，取消地图定位的侧栏留白。该布局替代此前胶囊侧栏方案。
+
+## 地图左侧胶囊导航（0.1.3-dev.4）
+
+移除顶部横向菜单，使用 ProjectMenu 在地图左侧悬浮展示五个胶囊入口；不占侧栏列、不恢复数据范围与终端信息。工作台提供 map-capsule-menu 样式变体。
+
+## 透明地图顶部栏（0.1.3-dev.5）
+
+地图布局下头部绝对定位悬浮，无背景、边框或阴影；地图延伸至页面顶部。业务标题、指标、列表保留顶部避让。独立带侧栏布局不受影响。
+
+## 地图排版统一（0.1.3-dev.6）
+
+左侧标题与胶囊导航对齐，去除重复面包屑及介绍；四项指标合为紧凑统计栏。右侧与过程面板使用实底、统一圆角和留白，图例固定左下。过程图初始隐藏，查询站点或预报后打开。
+
+## 顶部可读性与地图穿透（0.1.3-dev.7）
+
+品牌和操作按钮分组使用实底胶囊，顶部整条容器 pointer-events:none，仅品牌及操作区恢复 auto。空白处拖拽、滚轮交给地图；去掉冗余本地应用文字和分隔线。
+
+## 使用正式地图胶囊菜单（0.1.3-dev.8）
+
+一体机左侧改用已有 MapSideMenu，保留搜索、图标模式、分组折叠及选中样式。替代此前 ProjectMenu 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+
+地图要素叠加可用 MapSideMenu multiple + v-model:active-keys，change 中差量更新业务图层；路由菜单继续单选，不对多个 key 执行多次路由跳转。原 SideMenuMap 为路由单选，新增能力只在库中实现。
+
+## 一级地图胶囊菜单（0.1.3-dev.9）
+
+MapSideMenu 新增 flat:boolean，默认 false 保持分组模式。flat=true 隐藏父节点，将各项显示为一级胶囊，去除缩进及连线。一体机使用 flat=true 展示五个主菜单。
+
+## 图层控制封装（0.1.3-dev.10）
+
+MapLayerControl 参考平台 LayerControl/LayerTreeNode，提供底图选择、注记、树分组、搜索、显隐、拖拽排序、透明度、定位与可移除图层事件。数据及地图操作由消费方提供，未绑定平台 Pinia 或假服务。
+
+## 地图胶囊选中修复（0.1.3-dev.11）
+
+flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。