sky-ui-kit 0.1.5 → 0.1.7

package/docs/CONSUMERS.md

@@ -87,7 +87,156 @@ D:/dev/TasksBot 已从本地 tgz 切换为 npm sky-ui-kit@0.1.3。安装包多
 
 
 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对齐。
+
+0.1.6 / 2026-10-15：MapSideMenu items支持children子菜单（同一菜单树、同一搜索入口），multiple模式父子key共享activeKeys；点击已选父项折叠/展开子项，子项支持独立多选。消费方从change拆分模块与子项，不再拼接第二个菜单。
+
+2026-10-15：MapSideMenu移除固定360px高度与tree-scroll内部滚动，菜单按内容自然展开；宿主负责左侧整列边界。
+
+2026-10-15：父项点击只收展，选中状态由子项决定；取消最后一个子项移除父key，展开状态与选中独立。
+
+2026-10-15：管理布局统一使用 WorkbenchShell 的 management、groups、v-model:active；库内部渲染侧栏与 ProjectMenu。header、workspace、sidebar-footer 为内容插槽，workspaceStyle 传地图工作区变量。切换 management 不重建 workspace，默认插槽兼容旧用法。未构建、打包或发布，旧 npm 包不含新增 API。
+
+```vue
+<WorkbenchShell management :groups="groups" v-model:active="active">
+  <template #header><UiHeader class="app-header">管理平台</UiHeader></template>
+  <template #workspace><section class="data-workspace">业务内容</section></template>
+  <template #sidebar-footer>管理平台</template>
+</WorkbenchShell>
+```
+
+2026-10-15：管理侧栏和工作区结构统一收进共享WorkbenchShell，App通过management/groups/active及header/workspace/sidebar-footer插槽接入。地图保持挂载。本机Vite精确sky-ui-kit别名指向D:/sky-ui-kit/src/components/index.ts公开源码入口，不复制组件、不打包。正式发包后须移除此源码别名并升级包；旧0.1.6包不含新增API。库类型检查通过；ui:check仍报告App与五个业务Workspace的已有UI样式/原生控件问题，未做构建或浏览器验证。
+
+2026-10-15：修复ProjectMenu纵向一级与二级间距：原.project-menu ul重置覆盖menu-list padding-top；改用更高优先级菜单列表规则，顶部10、子级缩进12、行距6（随cp-font缩放）。管理侧栏纵向菜单统一16/12内边距，移除嵌套卡片边框与背景。仅共享库源码修改，应用公开源码入口自动使用；未构建、打包或浏览器验证。
+
+2026-10-15：管理布局统一可读字体规格：正文/表格/表单/按钮14px，卡片标题16px，页标题24px，辅助信息12px，标签和提示13px；表格行高22px、单元格上下12px，正文与表头使用主题正文色。规则仅作用management-layout，不改变地图业务密集标签。修复旧后台10/11px说明过小，消费方不加字体皮肤。未构建、打包或浏览器验证。
+
+2026-10-15：进一步定位后台表格字体未改根因：workbench.css原生table规则11px作用于ElTable内部原生表格，.cell继承该字号；原生th/td及第二列宽度同样污染UiTable。将四类原生选择器排除.el-table后代，management内明确table/cell/单元格14px并重置横向padding和第二列宽，兼容已引入旧包CSS。用户/角色操作通过公开UiSpace同行排列。未构建、打包或浏览器验证。
+
+2026-10-15：新增公开 SpatialScopeInput，复用 UiCascader（省市县多选/搜索）、UiSelect、UiUpload及现有表单展示，统一catalog/upload/draw三种互斥范围方式。modelValue={mode,regionCodes,reservoirCodes}；regions/reservoirs为调用方选项；boundaryName/boundaryCount展示有效面；loading/error/busy承载请求状态；upload(File)/draw/clear/retry交由业务方处理。组件库不请求行政区接口、不解析SHP、不创建地图、不执行后端授权。编辑时可切换方式，保存只保留当前方式。源码已接入一体机，尚未打包发布。
+
+```vue
+<SpatialScopeInput v-model="scope" :regions="regionOptions" :reservoirs="reservoirOptions"
+  :boundary-name="boundaryName" :boundary-count="boundaryCount" :busy="busy"
+  @upload="readShp" @draw="pickPolygon" @clear="clearBoundary" />
+```
+
+2026-10-15：MapOperationPanel沿用原平台地图工具DOM与操作，新增title及showDraw/showMeasure/showMap/showImport/showExport（默认均保留原行为）；message与footer（带snapshot）插槽允许嵌入校验、确认/返回动作。面板高度受宿主限制，内部可滚动。SpatialScopeInput增加view事件和“在地图上查看”按钮，绘制说明统一双击/Enter完成、Esc取消、完成后拖动编辑。调用方提供地图工具引擎，库不管理地图或GIS数据。
+示例：<MapOperationPanel :tools="tools" :draw-tools="areaDrawTools" title="地图工具 · 授权范围" :show-measure="false" :show-import="false"><template #footer><UiButton @click="confirmScope">确认范围</UiButton></template></MapOperationPanel>。本次源码修改，未构建、打包或发布。
+
+2026-10-15：新增公开MapEditorDialog：modelValue/title/hint，update:modelValue与ready(HTMLElement)事件；map/tools/message/footer插槽。统一地图弹窗尺寸、地图/工具两列布局、窄屏上下排列、操作提示和确认区；Esc不关闭弹窗，留给绘图引擎取消草图。组件仅提供地图宿主，调用方负责挂载既有地图与退出恢复，不初始化地图。
+SpatialScopeInput新增previewUrl/previewPaths展示小地图截图或SVG轮廓，点击预览触发view。库维护布局与样式，调用方提供截图或轮廓路径。示例：<MapEditorDialog v-model="open" @ready="mountExistingMap"><template #tools><MapOperationPanel :tools="tools" :draw-tools="drawTools" /></template><template #footer><UiButton @click="confirm">确认范围</UiButton></template></MapEditorDialog>。源码修改，未构建/打包/发布。
+
+2026-10-15：修复UiSelect搜索时双边框/内层圆角框：workbench原生input默认皮肤及focus-visible规则误作用于Element输入内核。原生input规则排除Element选择/输入/级联/日期/勾选等控件后代；共享workbench-controls中明确el-select__input使用透明无边框无描边的内部输入样式，保留外层选择器焦点框，并兼容联调时仍引入旧版style.css。仅修改组件库，无页面样式补丁，未构建/打包/浏览器验证。
+
+2026-10-15 最新范围规则（覆盖此前“上传/绘制无需选行政区”和“保存清空目录选择”的约定）：所有模式必须选择行政区，上传/绘制只补充边界并保留regionCodes/reservoirCodes。SpatialScopeValue新增boundaryTarget(region/reservoir)、reservoirName。水库边界必须明确名称，可选平台水库自动填入，也可手填用户水库名称；修改名称不匹配平台选项时自动解除ID关联，避免名称与编码错绑。自定义水库边界关联单个水库，行政区模式授权水库仍可多选。
+新增公开ManagementFormDialog，统一宽分区表单弹窗：modelValue/title/split/busy，update:modelValue，primary/default/message/footer插槽。split模式1180px上限，基本信息260px及范围区；SpatialScopeInput范围字段和预览区两栏。90dvh限制，头尾固定，仅内容区溢出滚动，小屏自动上下排列。角色single模式640px上限。布局、滚动与预览样式均由共享库维护。未构建/打包/发布/浏览器验证。
+
+2026-10-15：截图仍显示旧600px编辑弹窗与级联内双框。共享workbench-controls的输入内核重置从el-select__input补齐el-cascader__search-input（无padding/border/radius/outline/background、继承字体），清除旧包原生input规则影响，不增加页面补丁。只读HTTP检查5174服务返回AccessManagement已引用ManagementFormDialog、无旧600px宽度，库模块返回1180px及分栏结构；截图旧弹窗需关闭刷新重开以加载新结构，未进行浏览器运行验证。不构建/打包。
+
+2026-10-15：ManagementFormDialog底部footer插槽新增库内操作容器，右对齐、12px间距并支持换行，重置相邻Element按钮默认左间距，避免UiButton主题包装层使相邻按钮选择器失效或重复间距。消费页不加CSS补丁；未构建、打包、发布或浏览器验证。
+
+
+2026-10-15：新增公开ManagementResourceLayout：title/description属性；summary/filters/heading/actions/default插槽。统一资源管理页主题介绍区、查询栏、表格工具栏、操作间距及响应式布局，使用Element主题变量。示例：<ManagementResourceLayout title="菜单目录"><template #filters><UiInput placeholder="搜索菜单" /></template><UiTable :data="rows" /></ManagementResourceLayout>。消费项目使用公开布局及UiTable树形能力，不新增页面CSS；业务数据及CRUD由应用负责。未构建、打包、发布或浏览器验证。
+
+2026-10-15：ManagementResourceLayout默认内容槽新增management-resource-body纵向16px间距，统一表格、提示、筛选和分页的节奏；查询栏表单项去除多余底距。API及主题保持不变，消费方不加CSS。未构建/打包/发布/浏览器验证。
+
+2026-10-15：ProjectMenuItem新增可选children（递归菜单项）。vertical模式父项仅展开/收起，叶子项沿用update:active/select，后代选中高亮父项，active变化自动展开祖先及分组；支持键盘按钮及aria-expanded。原平铺/横向API保持兼容。WorkbenchShell groups直接支持此树形结构，无需消费方另写侧栏。
+示例：<WorkbenchShell management :groups="[{label:'管理平台',items:[{key:'data',label:'数据接入',children:[{key:'data:rain',label:'雨量站'}]}]}]" v-model:active="active" />。
+ManagementResourceLayout查询区使用底部对齐；内层el-form统一flex gap20px，form-item清零margin，标签8px下间距，行政区级联280px、雨量来源160px，刷新按钮和输入框对齐。尺寸/间距维护在库内，消费方不加CSS。库类型检查及SFC静态检查通过，未构建、打包、发布或浏览器验证。
+
+2026-10-15：ManagementResourceLayout新增showIntro:boolean，默认true。宿主已提供页标题时传false隐藏介绍卡，避免两套页头重复；summary槽随介绍卡一起隐藏，可将统计通过UiSpace放入heading。示例：<ManagementResourceLayout :show-intro="false"><template #heading><UiSpace><strong>数据列表</strong><UiTag>共10条</UiTag></UiSpace></template></ManagementResourceLayout>。未构建/打包/发布/浏览器验证。
+
+2026-10-15：cloud-server数据接入使用已有UiSelect multiple、UiButton/UiSpace及ManagementResourceLayout，保存本地行政区与多来源默认配置；业务配置、接口与空间过滤均留消费方，库未增加业务状态或页面皮肤。本次未改库组件，无需发包；详细边界见消费方docs/UI-KIT-INTEGRATION.md。未构建/发布/浏览器验证。
+
+2026-10-15：新增公开GlobalMapLayerDock：title/subtitle/enabled/expanded，update:enabled/update:expanded，default/status插槽。通用全局地图叠加卡：左下浮动、可收起、开关、控件与状态，宽420px上限、小屏自适应；展开体限高滚动，主题采用库变量。default插槽可用UiForm/UiSelect/UiSlider/UiSpace；global-map-layer-dock__legend为插槽色带容器，调用方传业务色带颜色，库不持有降水颜色。示例：<GlobalMapLayerDock title="降水等值面" v-model:enabled="enabled" v-model:expanded="expanded"><UiSelect v-model="batch" /><template #status>点击地图查询</template></GlobalMapLayerDock>。
+新增公开MapPointProcessDialog：modelValue/title/subtitle/loading/error/rows/engine/unit，update:modelValue。复用UiDialog与ProcessChart，统一地图选点过程弹窗、状态、缺测与300px图表宿主。engine由消费方提供；示例：<MapPointProcessDialog v-model="open" :rows="rows" :engine="chartEngine" subtitle="选定位置及批次" />。库仅展示，不查询API、不初始化地图。共享源码联调，未构建、打包、发布或浏览器验证。
+
+2026-10-15：修复右键菜单黑边/原生按钮皮肤。DOM菜单、箭头、临时标记补userssite-theme；可复用菜单样式迁至共享库公开mapContextMenuStyles，业务ContextMenu仍管理事件/DOM/地图动作，不复制库皮肤。共享样式提供Element主题及浅色边框/阴影fallback。rainContextMenu命中补已注册临时面/边界层；核心queryTemporaryPolygonFeatures对可见line/fill注册数据做Polygon/MultiPolygon内部判断（含孔洞、边界），返回完整面，避免只命中描边。优先完整面替代同source瓦片裁切面，保留站点命中与重叠候选切换。选面后已有面内站点选择/对比/Tip动作可用，名称补name/NAME。全局WMS为栅格，无矢量面要素，不伪造等值面多边形。共享库与地图核心类型检查通过，未构建/打包/发布/浏览器验证；依赖现有Vite共享源码alias，已发布npm包不含此次导出。
+
+
+2026-10-15：集水区右侧移除旧空白提示面板，使用共享库公开MapFeatureListPanel，统一蓝色标题、关闭、搜索和表格。按catchmentId（旧记录按名称+关联水库）分组显示真实信息，点击通过核心locateGeoJson定位完整边界。集水区工具栏改用现有StationMapToolbar，面板开关接布局rightOpen，不写页面皮肤。保存默认配置补catchmentId/reservoirCode。面雨量尚未计算。三SFC静态检查、库与核心类型检查通过；未构建、打包、发布或浏览器验证。当前Vite共享源码联调，npm旧包尚无新增导出。
+
+
+2026-10-15：修复集水区共用工具栏右键开关反向：共享MapTools内部默认false，StationMapToolbar业务context默认true，旧tool-click二次翻转使视觉启用时业务被关闭。MapTools增加可选contextEnabled及update:contextEnabled（支持v-model:context-enabled），未传时保持原内部状态；原context-change/tool-click兼容。StationMapToolbar绑定唯一context并跳过tool-click再次取反。默认开启且高亮一致。库类型检查、两SFC检查通过，未构建/打包/发布/浏览器验证；当前源码联调。
+
+
+2026-10-15：修正此前仅集水区隐藏按钮的局部处理。一张图六业务模块统一组件库公开MapTools：雨量/水库/水文停止引用本地rain/components/MapTools并删除各自按钮数组；视频/工程/集水区通过共用StationMapToolbar使用同一公开组件，移除hiddenTools特例。默认按钮由库单点维护为layers/refresh/locate/settings/context，移除module/analysis/system；保留before列表展开。统一map-tools宿主类应用库紧凑尺寸。雨量/水库/水文补v-model:context-enabled，删除tool-click二次翻转，避免右键状态反向。业务事件与地图引擎保留模块适配，不复制UI。六SFC静态检查和库类型检查通过，未构建/打包/发布/浏览器验证。当前源码联调，npm旧包不含默认菜单变更。
+
+
+2026-10-15：统一地图工具与集水区面板尺寸。MapTools和AtlasRightToggleButton共用--userssite-map-tool-size（默认cp-font-1×34），workbench-controls移除固定32px覆盖；MapTools基础尺寸选择器补宿主以覆盖源码联调仍加载的旧包规则。MapFeatureListPanel标题改同雨量cp-font-19/900字重/54单位高度，表格cp-font-12、行高44单位、搜索框32单位及cp-font-13，不再固定16px小标题。共享库类型检查通过；未构建/打包/发布/浏览器验证。
+
+
+2026-10-15最新尺寸约定覆盖上一条：用户明确雨量站正确、集水区错误。撤回上一轮共用工具尺寸改动：MapTools恢复control-height-l，工作台恢复原32px按钮，折叠按钮恢复原34个cp单位，不再用新map-tool-size变量改变雨量。只在MapFeatureListPanel对照雨量调整54单位标题栏、19号900字重标题、30单位关闭按钮、搜索间距、表头12号850字重、行文字13号/序号框与行高44单位。库类型检查通过，未构建/打包/发布/浏览器验证。
+
+
+2026-10-15：共用地图工具按钮纵向间距由工作台2px增至8px，按钮大小不变。MapTools组件同步8px并用宿主选择器覆盖源码联调仍加载的旧包2px规则，六模块统一生效。未构建/打包/发布或浏览器验证。
+
+
+2026-10-15：集水区左键降水过程、右键实况与预报对比。用户确认暂无接口，明确要求示例；src/catchment/demoRainfall.js提供固定2026-10-15的24小时演示实况/预报，含0且同时间对齐，不写配置、不请求接口、不冒充真实面平均雨量。App按集水区属性关联右侧同条记录，左键单序列、右键对比双序列，TemplateLayout.timeline放共享MapBottomProcessPanel，地图底部非模态、不居中；切离集水区/配置变更关闭，右侧关闭后底部宽度随布局调整。全局栅格选点避让configured-catchments，防止一次点击开两个过程。StationMapToolbar追加catchment-compare事件，右键动作仅命中集水区时显示。
+共享ProcessChart增加可选series(name/rows)多序列，时间并集排序、缺测null、不同主题色，旧rows用法兼容；新增公开MapBottomProcessPanel(title/subtitle/demo/series/engine/unit、close)，图表引擎消费方提供。TemplateLayout.timeline补z-index12使底部过程盖过全局图层卡。六SFC静态、共享库类型、按源码alias右键链类型检查通过；ui:check仍为原App和五Workspace历史问题。未构建/打包/发布/浏览器验证，npm旧包未包含新增导出，当前Vite源码联调。
+
+
+2026-10-15：修复悬浮顶部ProjectMenu无法点击。sidebar-hidden的app-header为地图空白区域穿透设置pointer-events:none，原来仅brand/header-actions恢复auto，遗漏header-menu。共享workbench-controls补header-menu的pointer-events:auto，保持空白区域地图交互；未复制页面皮肤、未更改路由逻辑。当前源码联调生效，未构建、打包、发布或浏览器验证。
+
+
+2026-10-15：ProjectMenu横向胶囊对齐修正：容器与按钮显式border-box，滚动行清除margin/padding并与32单位按钮等高，按钮margin归零、align-self:center；取消hover/focus向上位移，避免鼠标悬停时文字偏上。未添加定位偏移或消费页面皮肤。未构建、发布或浏览器验证。
+
+
+2026-10-15：用户截图确认上轮顶部菜单对齐未解决，撤回“已视觉修复”的判断。横向ProjectMenu补独立primary-nav-label，按钮用grid/place-items:center定位文字行盒；胶囊显式40单位border-box高度、上下3单位内边距，内行与按钮stretch占满可用高度，文字line-height:1.4；增强限定选择器覆盖宿主通用规则，不用translateY补偿。仅静态检查，未构建或浏览器验证，实际视觉效果仍待用户确认。
+
+
+2026-10-15：顶部切换整栏横跳根因为应用当前模块UiSelect仅一张图显示，右侧宽度变化触发header-menu的flex auto margin重新分配。共享悬浮布局将header-menu以header为包含块left/top50%+translate居中并清除auto margin，不再依赖左右区域宽度；仅地图sidebar-hidden布局生效，保留pointer-events:auto及胶囊尺寸，管理布局不受影响。选中态本身未改变margin/字号。未构建、打包、发布或浏览器验证。
+
+
+2026-10-15：预报方案工作流首版。公共TemplateLayout增加left插槽与leftPanelWidth（默认320px），left与right共享上下边距；timeline在有left插槽时自动避让左面板，无left时原行为保持。新增公开MapWorkspacePanel(title/subtitle，actions/default/footer插槽)，提供统一标题、可滚动内容及底部操作区，供方案列表/详情使用。例：
+```vue
+<TemplateLayout left-panel-width="300px" right-panel-width="360px" right-open>
+  <template #left><MapWorkspacePanel title="预报方案"><template #actions><UiButton>新建方案</UiButton></template>方案列表</MapWorkspacePanel></template>
+  <template #right><MapWorkspacePanel title="方案详情">业务内容</MapWorkspacePanel></template>
+</TemplateLayout>
+```
+业务数据、文件解析、地图与计算均由消费项目提供。未构建、打包或发布，当前metrics仍通过Vite源码alias消费；npm旧包尚无新组件/插槽。
+
+
+2026-10-15：全国水文原页样式迁入。新增公开NationalHydroSidebar，来源参考平台views/hydroforecast/mapHydro/components/Sidebar.vue：保留原分组卡片、当前拾取、坐标、原生单选、AppSelect、标题/间距/字号/按钮 scoped 样式，仅主题token转userssite命名、根类重命名避免工作台.sidebar覆盖。props沿用selected/locationLng/locationLat/meteoSource/model/batchId/batchList/selectedTimeZone/timeZoneOptions；事件沿用updateLocationField/coordinateLocate/updateMeteoSource/updateModel/updateBatchId/updateTimeZone/openStyle，追加status插槽承载消费方错误/加载状态。无业务接口或地图引擎。例：<NationalHydroSidebar :selected="selected" :batch-list="batches" :batch-id="batchId" @update-batch-id="batchId=$event" />，其余筛选由消费方传入并绑定事件。
+共享ProcessChart/MapBottomProcessPanel新增可选timeZone/currentTime：轴标签按时区显示，当前时刻数据点高亮，未传时保留原行为；图表引擎由消费方提供。TemplateLayout.timeline改flex纵向gap，容纳底部过程+时间轴。库vue-tsc通过；未构建、打包、发布或浏览器验证，metrics当前通过公开出口源码alias使用，npm旧包尚未包含新增出口。
+
+
+2026-10-15：方案页移除整列左侧白色列表，改TemplateLayout.top插槽的公开MapSchemeSelect：可搜索方案下拉+新建按钮。无left插槽时底部过程图自动恢复左边距，释放地图空间；演示标记保留在方案详情。新增MapSchemeSelect(modelValue/options/placeholder，update:modelValue/create)，皮肤集中共享库；TemplateLayout.top改用right-top变量，与右侧上沿一致（默认仍88px）。未构建、发布或浏览器验证。
+
+## 2026-10-15：DefenseMapLayout 综合研判多视图
+
+新增公开 DefenseMapLayout（默认 slot，无业务数据或地图实例），将参考 DefenseMapLinkage 的多视图、设置、图例、过程卡和简报展示样式封装到 .sky-defense-layout 内，使用 userssite 主题变量，适配工作台顶部64px导航；不包含业务 API、Pinia、MapLibre/DeckGL/ECharts引擎。设置抽屉 append-to=".sky-defense-layout" 保持主题与样式作用域，双击放大由消费方控制 is-fullscreen-* 类。基础 UiScrollbar 补公共封装，TimelinePoint / MapValueLegendItem / MapValueLegendGradientStop 补公共类型出口。消费项目 D:/Work/01-项目code/一体化平台/一体机项目 /defense-map-linkage 使用上述源码；本次未构建打包发布，npm 0.1.6 不包含新增能力。
+
+使用示例：
+```vue
+<script setup>
+import { DefenseMapLayout, UiButton } from 'sky-ui-kit'
+</script>
+<template>
+  <DefenseMapLayout>
+    <main class="defense-map-page">
+      <section v-for="id in ['forecast','observed','hydro','report']" :key="id" class="defense-map-panel">
+        <div class="defense-map-heading"><strong>{{ id }}</strong></div>
+        <!-- 消费方在此挂载地图引擎或简报内容 -->
+      </section>
+    </main>
+  </DefenseMapLayout>
+</template>
+```
+
+MapLayerControl 增加 closable/showLocate/showOpacity（均默认 true）；综合研判嵌入公共图层设置时设 false，只展示已接入的原页显隐/排序/移除能力，其他消费方保持不变。
+
+metricslab降水播放轴使用TemplateLayout.timeline插槽；timelineLeft/timelineRight为可选CSS长度覆盖，用于外部面板避让。2026-10-16源码联调，未发布。
+
+2026-10-16：metricslab现有legend插槽保留，宿主通过timeline-height共享全局降水时间轴实际高度，供各业务布局图例避让，不复制图例、不写固定bottom。
+
+2026-10-16：metricslab降水设置用GlobalMapLayerDock.actions放刷新图标，保持公开组件样式；底部内嵌色带移除。未发布。
+
+2026-10-16：metricslab用户使用范围用SpatialScopeInput reservoirOnly，默认draw、目标reservoir，保存regionCodes为空，必填水库名称及有效面；旧行政区授权编辑须补水库边界，不自动将行政区面认作水库。
+
+2026-10-20：media-ui最新用户约定仅消费npm sky-ui-kit@0.1.6，开发和交付均移除源码alias；库能力后续需发布可安装版本后应用再升级。

package/docs/CSS-THEME.md

@@ -129,7 +129,112 @@ business-embed：management.css 提供工作台业务 iframe 布局，保留顶
 
 
 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对齐。
+
+WorkbenchShell management模式统一持有侧栏与workspace布局，消费方不再手写aside/main。
+
+2026-10-15：修复ProjectMenu纵向一级与二级间距：原.project-menu ul重置覆盖menu-list padding-top；改用更高优先级菜单列表规则，顶部10、子级缩进12、行距6（随cp-font缩放）。管理侧栏纵向菜单统一16/12内边距，移除嵌套卡片边框与背景。仅共享库源码修改，应用公开源码入口自动使用；未构建、打包或浏览器验证。
+
+2026-10-15：管理布局统一可读字体规格：正文/表格/表单/按钮14px，卡片标题16px，页标题24px，辅助信息12px，标签和提示13px；表格行高22px、单元格上下12px，正文与表头使用主题正文色。规则仅作用management-layout，不改变地图业务密集标签。修复旧后台10/11px说明过小，消费方不加字体皮肤。未构建、打包或浏览器验证。
+
+2026-10-15：进一步定位后台表格字体未改根因：workbench.css原生table规则11px作用于ElTable内部原生表格，.cell继承该字号；原生th/td及第二列宽度同样污染UiTable。将四类原生选择器排除.el-table后代，management内明确table/cell/单元格14px并重置横向padding和第二列宽，兼容已引入旧包CSS。用户/角色操作通过公开UiSpace同行排列。未构建、打包或浏览器验证。
+
+SpatialScopeInput只设置级联/选择控件铺满表单宽度，其余外观继承公开Ui组件及现有主题。
+
+MapOperationPanel使用宿主最大高度并内部滚动，范围编辑复用原面板样式，不在消费项目重写工具栏皮肤。
+
+MapEditorDialog与SpatialScopeInput预览均使用userssite主题，地图宿主与工具区布局在库维护；图片与SVG范围预览具有同一边框、圆角、说明和键盘焦点样式。
+
+2026-10-15：修复UiSelect搜索时双边框/内层圆角框：workbench原生input默认皮肤及focus-visible规则误作用于Element输入内核。原生input规则排除Element选择/输入/级联/日期/勾选等控件后代；共享workbench-controls中明确el-select__input使用透明无边框无描边的内部输入样式，保留外层选择器焦点框，并兼容联调时仍引入旧版style.css。仅修改组件库，无页面样式补丁，未构建/打包/浏览器验证。
+
+2026-10-15 最新范围规则（覆盖此前“上传/绘制无需选行政区”和“保存清空目录选择”的约定）：所有模式必须选择行政区，上传/绘制只补充边界并保留regionCodes/reservoirCodes。SpatialScopeValue新增boundaryTarget(region/reservoir)、reservoirName。水库边界必须明确名称，可选平台水库自动填入，也可手填用户水库名称；修改名称不匹配平台选项时自动解除ID关联，避免名称与编码错绑。自定义水库边界关联单个水库，行政区模式授权水库仍可多选。
+新增公开ManagementFormDialog，统一宽分区表单弹窗：modelValue/title/split/busy，update:modelValue，primary/default/message/footer插槽。split模式1180px上限，基本信息260px及范围区；SpatialScopeInput范围字段和预览区两栏。90dvh限制，头尾固定，仅内容区溢出滚动，小屏自动上下排列。角色single模式640px上限。布局、滚动与预览样式均由共享库维护。未构建/打包/发布/浏览器验证。
+
+2026-10-15：截图仍显示旧600px编辑弹窗与级联内双框。共享workbench-controls的输入内核重置从el-select__input补齐el-cascader__search-input（无padding/border/radius/outline/background、继承字体），清除旧包原生input规则影响，不增加页面补丁。只读HTTP检查5174服务返回AccessManagement已引用ManagementFormDialog、无旧600px宽度，库模块返回1180px及分栏结构；截图旧弹窗需关闭刷新重开以加载新结构，未进行浏览器运行验证。不构建/打包。
+
+2026-10-15：ManagementFormDialog底部footer插槽新增库内操作容器，右对齐、12px间距并支持换行，重置相邻Element按钮默认左间距，避免UiButton主题包装层使相邻按钮选择器失效或重复间距。消费页不加CSS补丁；未构建、打包、发布或浏览器验证。
+
+
+2026-10-15：新增公开ManagementResourceLayout：title/description属性；summary/filters/heading/actions/default插槽。统一资源管理页主题介绍区、查询栏、表格工具栏、操作间距及响应式布局，使用Element主题变量。示例：<ManagementResourceLayout title="菜单目录"><template #filters><UiInput placeholder="搜索菜单" /></template><UiTable :data="rows" /></ManagementResourceLayout>。消费项目使用公开布局及UiTable树形能力，不新增页面CSS；业务数据及CRUD由应用负责。未构建、打包、发布或浏览器验证。
+
+2026-10-15：ManagementResourceLayout默认内容槽新增management-resource-body纵向16px间距，统一表格、提示、筛选和分页的节奏；查询栏表单项去除多余底距。API及主题保持不变，消费方不加CSS。未构建/打包/发布/浏览器验证。
+
+2026-10-15：ProjectMenuItem新增可选children（递归菜单项）。vertical模式父项仅展开/收起，叶子项沿用update:active/select，后代选中高亮父项，active变化自动展开祖先及分组；支持键盘按钮及aria-expanded。原平铺/横向API保持兼容。WorkbenchShell groups直接支持此树形结构，无需消费方另写侧栏。
+示例：<WorkbenchShell management :groups="[{label:'管理平台',items:[{key:'data',label:'数据接入',children:[{key:'data:rain',label:'雨量站'}]}]}]" v-model:active="active" />。
+ManagementResourceLayout查询区使用底部对齐；内层el-form统一flex gap20px，form-item清零margin，标签8px下间距，行政区级联280px、雨量来源160px，刷新按钮和输入框对齐。尺寸/间距维护在库内，消费方不加CSS。库类型检查及SFC静态检查通过，未构建、打包、发布或浏览器验证。
+
+2026-10-15：ManagementResourceLayout新增showIntro:boolean，默认true。宿主已提供页标题时传false隐藏介绍卡，避免两套页头重复；summary槽随介绍卡一起隐藏，可将统计通过UiSpace放入heading。示例：<ManagementResourceLayout :show-intro="false"><template #heading><UiSpace><strong>数据列表</strong><UiTag>共10条</UiTag></UiSpace></template></ManagementResourceLayout>。未构建/打包/发布/浏览器验证。
+
+2026-10-15：新增公开GlobalMapLayerDock：title/subtitle/enabled/expanded，update:enabled/update:expanded，default/status插槽。通用全局地图叠加卡：左下浮动、可收起、开关、控件与状态，宽420px上限、小屏自适应；展开体限高滚动，主题采用库变量。default插槽可用UiForm/UiSelect/UiSlider/UiSpace；global-map-layer-dock__legend为插槽色带容器，调用方传业务色带颜色，库不持有降水颜色。示例：<GlobalMapLayerDock title="降水等值面" v-model:enabled="enabled" v-model:expanded="expanded"><UiSelect v-model="batch" /><template #status>点击地图查询</template></GlobalMapLayerDock>。
+新增公开MapPointProcessDialog：modelValue/title/subtitle/loading/error/rows/engine/unit，update:modelValue。复用UiDialog与ProcessChart，统一地图选点过程弹窗、状态、缺测与300px图表宿主。engine由消费方提供；示例：<MapPointProcessDialog v-model="open" :rows="rows" :engine="chartEngine" subtitle="选定位置及批次" />。库仅展示，不查询API、不初始化地图。共享源码联调，未构建、打包、发布或浏览器验证。
+
+mapContextMenuStyles为外部地图DOM右键菜单提供公开主题皮肤，使用userssite-theme变量及Element后备值，避免body挂载时系统ButtonBorder黑框。
+
+MapFeatureListPanel满插槽高度，采用ranking-header-bg/right-panel-header-text主题标题色，搜索/表格/底部说明间距由库维护。
+
+
+2026-10-15：统一地图工具与集水区面板尺寸。MapTools和AtlasRightToggleButton共用--userssite-map-tool-size（默认cp-font-1×34），workbench-controls移除固定32px覆盖；MapTools基础尺寸选择器补宿主以覆盖源码联调仍加载的旧包规则。MapFeatureListPanel标题改同雨量cp-font-19/900字重/54单位高度，表格cp-font-12、行高44单位、搜索框32单位及cp-font-13，不再固定16px小标题。共享库类型检查通过；未构建/打包/发布/浏览器验证。
+
+
+2026-10-15最新尺寸约定覆盖上一条：用户明确雨量站正确、集水区错误。撤回上一轮共用工具尺寸改动：MapTools恢复control-height-l，工作台恢复原32px按钮，折叠按钮恢复原34个cp单位，不再用新map-tool-size变量改变雨量。只在MapFeatureListPanel对照雨量调整54单位标题栏、19号900字重标题、30单位关闭按钮、搜索间距、表头12号850字重、行文字13号/序号框与行高44单位。库类型检查通过，未构建/打包/发布/浏览器验证。
+
+
+2026-10-15：共用地图工具按钮纵向间距由工作台2px增至8px，按钮大小不变。MapTools组件同步8px并用宿主选择器覆盖源码联调仍加载的旧包2px规则，六模块统一生效。未构建/打包/发布或浏览器验证。
+
+MapBottomProcessPanel底部过程卡高度min(320px,42dvh)，库主题配色/标题/示例标签/图例/关闭，非居中模态。TemplateLayout.timeline的z-index为12以覆盖浮动图层卡。
+
+
+2026-10-15：修复悬浮顶部ProjectMenu无法点击。sidebar-hidden的app-header为地图空白区域穿透设置pointer-events:none，原来仅brand/header-actions恢复auto，遗漏header-menu。共享workbench-controls补header-menu的pointer-events:auto，保持空白区域地图交互；未复制页面皮肤、未更改路由逻辑。当前源码联调生效，未构建、打包、发布或浏览器验证。
+
+
+2026-10-15：ProjectMenu横向胶囊对齐修正：容器与按钮显式border-box，滚动行清除margin/padding并与32单位按钮等高，按钮margin归零、align-self:center；取消hover/focus向上位移，避免鼠标悬停时文字偏上。未添加定位偏移或消费页面皮肤。未构建、发布或浏览器验证。
+
+
+2026-10-15：用户截图确认上轮顶部菜单对齐未解决，撤回“已视觉修复”的判断。横向ProjectMenu补独立primary-nav-label，按钮用grid/place-items:center定位文字行盒；胶囊显式40单位border-box高度、上下3单位内边距，内行与按钮stretch占满可用高度，文字line-height:1.4；增强限定选择器覆盖宿主通用规则，不用translateY补偿。仅静态检查，未构建或浏览器验证，实际视觉效果仍待用户确认。
+
+
+2026-10-15：顶部切换整栏横跳根因为应用当前模块UiSelect仅一张图显示，右侧宽度变化触发header-menu的flex auto margin重新分配。共享悬浮布局将header-menu以header为包含块left/top50%+translate居中并清除auto margin，不再依赖左右区域宽度；仅地图sidebar-hidden布局生效，保留pointer-events:auto及胶囊尺寸，管理布局不受影响。选中态本身未改变margin/字号。未构建、打包、发布或浏览器验证。
+
+
+2026-10-15：预报方案工作流首版。公共TemplateLayout增加left插槽与leftPanelWidth（默认320px），left与right共享上下边距；timeline在有left插槽时自动避让左面板，无left时原行为保持。新增公开MapWorkspacePanel(title/subtitle，actions/default/footer插槽)，提供统一标题、可滚动内容及底部操作区，供方案列表/详情使用。例：
+```vue
+<TemplateLayout left-panel-width="300px" right-panel-width="360px" right-open>
+  <template #left><MapWorkspacePanel title="预报方案"><template #actions><UiButton>新建方案</UiButton></template>方案列表</MapWorkspacePanel></template>
+  <template #right><MapWorkspacePanel title="方案详情">业务内容</MapWorkspacePanel></template>
+</TemplateLayout>
+```
+业务数据、文件解析、地图与计算均由消费项目提供。未构建、打包或发布，当前metrics仍通过Vite源码alias消费；npm旧包尚无新组件/插槽。
+
+
+2026-10-15：全国水文原页样式迁入。新增公开NationalHydroSidebar，来源参考平台views/hydroforecast/mapHydro/components/Sidebar.vue：保留原分组卡片、当前拾取、坐标、原生单选、AppSelect、标题/间距/字号/按钮 scoped 样式，仅主题token转userssite命名、根类重命名避免工作台.sidebar覆盖。props沿用selected/locationLng/locationLat/meteoSource/model/batchId/batchList/selectedTimeZone/timeZoneOptions；事件沿用updateLocationField/coordinateLocate/updateMeteoSource/updateModel/updateBatchId/updateTimeZone/openStyle，追加status插槽承载消费方错误/加载状态。无业务接口或地图引擎。例：<NationalHydroSidebar :selected="selected" :batch-list="batches" :batch-id="batchId" @update-batch-id="batchId=$event" />，其余筛选由消费方传入并绑定事件。
+共享ProcessChart/MapBottomProcessPanel新增可选timeZone/currentTime：轴标签按时区显示，当前时刻数据点高亮，未传时保留原行为；图表引擎由消费方提供。TemplateLayout.timeline改flex纵向gap，容纳底部过程+时间轴。库vue-tsc通过；未构建、打包、发布或浏览器验证，metrics当前通过公开出口源码alias使用，npm旧包尚未包含新增出口。
+
+
+2026-10-15：方案页移除整列左侧白色列表，改TemplateLayout.top插槽的公开MapSchemeSelect：可搜索方案下拉+新建按钮。无left插槽时底部过程图自动恢复左边距，释放地图空间；演示标记保留在方案详情。新增MapSchemeSelect(modelValue/options/placeholder，update:modelValue/create)，皮肤集中共享库；TemplateLayout.top改用right-top变量，与右侧上沿一致（默认仍88px）。未构建、发布或浏览器验证。
+
+## 2026-10-15：DefenseMapLayout 综合研判多视图
+
+新增公开 DefenseMapLayout（默认 slot，无业务数据或地图实例），将参考 DefenseMapLinkage 的多视图、设置、图例、过程卡和简报展示样式封装到 .sky-defense-layout 内，使用 userssite 主题变量，适配工作台顶部64px导航；不包含业务 API、Pinia、MapLibre/DeckGL/ECharts引擎。设置抽屉 append-to=".sky-defense-layout" 保持主题与样式作用域，双击放大由消费方控制 is-fullscreen-* 类。基础 UiScrollbar 补公共封装，TimelinePoint / MapValueLegendItem / MapValueLegendGradientStop 补公共类型出口。消费项目 D:/Work/01-项目code/一体化平台/一体机项目 /defense-map-linkage 使用上述源码；本次未构建打包发布，npm 0.1.6 不包含新增能力。
+
+使用示例：
+```vue
+<script setup>
+import { DefenseMapLayout, UiButton } from 'sky-ui-kit'
+</script>
+<template>
+  <DefenseMapLayout>
+    <main class="defense-map-page">
+      <section v-for="id in ['forecast','observed','hydro','report']" :key="id" class="defense-map-panel">
+        <div class="defense-map-heading"><strong>{{ id }}</strong></div>
+        <!-- 消费方在此挂载地图引擎或简报内容 -->
+      </section>
+    </main>
+  </DefenseMapLayout>
+</template>
+```
+
+
+按需 JS 入口不改变 CSS 约定，style.css 仍为整体公共样式，不是逐组件 CSS。

package/docs/ELEMENT-PLUS-COVERAGE.md

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

package/docs/INTEGRATION.md

@@ -6,7 +6,7 @@
 
 ## 图标替换
 
-原 components/global/SvgIcon.vue 可替换为从 sky-ui-kit 导入 SvgIcon，保留 name / size / title / decorative。库内置 274 个项目 SVG，自动按需注册到 sky-icon- 命名空间；不依赖业务项目 Vite 插件。暂时保留旧 sprite 时传 prefix="icon-"，资源仍由原 virtual:svg-icons-register 提供。完成所有旧引用检查后才移除旧全局组件和插件，地图 PNG / Logo 的注册不变。子目录名称改为目录前缀以避免重名，按 projectIcons.source 与 name 对照迁移。Element Plus 图标仍从 @element-plus/icons-vue 导入，用 UiIcon 包裹。图标操作事件、路由和权限继续由业务方绑定。
+原 components/global/SvgIcon.vue 可替换为从 sky-ui-kit 导入 SvgIcon，保留 name / size / title / decorative。库内置 274 个项目 SVG，通过可选图库显式注册到 sky-icon- 命名空间；不依赖业务项目 Vite 插件。暂时保留旧 sprite 时传 prefix="icon-"，资源仍由原 virtual:svg-icons-register 提供。完成所有旧引用检查后才移除旧全局组件和插件，地图 PNG / Logo 的注册不变。子目录名称改为目录前缀以避免重名，按 projectIcons.source 与 name 对照迁移。Element Plus 图标仍从 @element-plus/icons-vue 导入，用 UiIcon 包裹。图标操作事件、路由和权限继续由业务方绑定。
 
 ## 当前交付范围
 
@@ -126,22 +126,39 @@ Header / SideMenu / MainLayout 的路由、权限、用户和布局状态；Laye
 
 
 地图要素叠加可用 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+
+## 一级地图胶囊菜单（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-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对齐。
+
+
+2026-10-15：全国水文原页样式迁入。新增公开NationalHydroSidebar，来源参考平台views/hydroforecast/mapHydro/components/Sidebar.vue：保留原分组卡片、当前拾取、坐标、原生单选、AppSelect、标题/间距/字号/按钮 scoped 样式，仅主题token转userssite命名、根类重命名避免工作台.sidebar覆盖。props沿用selected/locationLng/locationLat/meteoSource/model/batchId/batchList/selectedTimeZone/timeZoneOptions；事件沿用updateLocationField/coordinateLocate/updateMeteoSource/updateModel/updateBatchId/updateTimeZone/openStyle，追加status插槽承载消费方错误/加载状态。无业务接口或地图引擎。例：<NationalHydroSidebar :selected="selected" :batch-list="batches" :batch-id="batchId" @update-batch-id="batchId=$event" />，其余筛选由消费方传入并绑定事件。
+共享ProcessChart/MapBottomProcessPanel新增可选timeZone/currentTime：轴标签按时区显示，当前时刻数据点高亮，未传时保留原行为；图表引擎由消费方提供。TemplateLayout.timeline改flex纵向gap，容纳底部过程+时间轴。库vue-tsc通过；未构建、打包、发布或浏览器验证，metrics当前通过公开出口源码alias使用，npm旧包尚未包含新增出口。
+
+
+按需接入方案见 ON-DEMAND.md，新路径需等待下一版本发布；应用页面按需导入、路由懒加载，公共 CSS 在 main.ts 一次加载。
+
+
+## 2026-10-19 轻量入口更新（未发布）
+
+主入口不再导出 projectIcons / ProjectIconName / registerProjectIcons，改从 sky-ui-kit/icons 导入。SvgIcon 只引用已有 sprite，默认 prefix 仍为 sky-icon-；自有 sprite 用 prefix="icon-"。保留图库的应用需要在 main.ts 显式 registerProjectIcons([名称])，图标资源不会自动下载。可选图库约 980 KB，不需要时不要导入。此变更尚未发布，安装 0.1.6 不具备新子路径。
+
+
+## 0.1.7 正式安装与样式
+
+通过 npm 安装 sky-ui-kit，main.ts 依次引入 element-plus/dist/index.css 和 sky-ui-kit/style.css，包内已包含默认主题和组件样式，不依赖开发者电脑、原业务项目或远程样式服务。CSS 变量允许运行时主题覆盖。图标资源可从 sky-ui-kit/icons 显式注册，或由应用提供 sprite；SvgIcon 不再自动携带图库。按组件入口见 docs/ON-DEMAND.md。

package/docs/ON-DEMAND.md

@@ -0,0 +1,38 @@
+# 按需引入
+
+下一次发布后支持独立组件路径：
+
+```ts
+// main.ts 中公共 CSS 只加载一次
+import 'element-plus/dist/index.css'
+import 'sky-ui-kit/style.css'
+
+// 页面中只导入需要的组件；可使用默认或命名导入
+import UiButton from 'sky-ui-kit/components/UiButton'
+import { MapSideMenu } from 'sky-ui-kit/components/MapSideMenu'
+```
+
+原有 `import { UiButton } from 'sky-ui-kit'` 保持兼容。主题包装调用添加 PURE 标记，供 Vite/Rollup 等生产打包器裁剪未使用组件。独立入口共享必要的运行代码，不能把整个命名空间注册为全局组件后期待裁剪。
+
+这里是构建时按需包含。需要进入页面才下载代码时，在应用路由使用 `() => import('./pages/MapPage.vue')`，组件放到该页面导入。
+
+公共 style.css 仍包含整体主题和组件样式，不宣称 CSS 已逐组件拆分。Element Plus CSS 的按需方案由消费方配置；当前文档使用完整 CSS 以保证样式完整。SvgIcon 只引用 sprite，须由应用注册，但图标源码仍为完整集合；显式导入 projectIcons 也会包含图库，不宣称逐图标裁剪。
+
+该配置尚未构建验证，下一次用户授权打包时核对独立 JS、类型入口及消费项目产物体积；当前已发布的 0.1.6 不包含本次配置。
+
+
+## 2026-10-19 轻量入口更新（未发布）
+
+主入口不再导出 projectIcons / ProjectIconName / registerProjectIcons，改从 sky-ui-kit/icons 导入。SvgIcon 只引用已有 sprite，默认 prefix 仍为 sky-icon-；自有 sprite 用 prefix="icon-"。保留图库的应用需要在 main.ts 显式 registerProjectIcons([名称])，图标资源不会自动下载。可选图库约 980 KB，不需要时不要导入。此变更尚未发布，安装 0.1.6 不具备新子路径。
+
+## 构建对比（2026-10-19）
+
+采用 esbuild 对相同组件进行生产裁剪、压缩，Vue / Element Plus / 图标依赖 / motion-v 均外置；因此数据只表示库增量 JS，不含 CSS 和上游依赖。
+
+| 组件 | 0.1.6 JS / gzip | 新构建 JS / gzip |
+|---|---:|---:|
+| UiButton | 116602 / 35571 B | 1961 / 989 B |
+| MapSideMenu | 116605 / 35577 B | 8411 / 3487 B |
+| SvgIcon | 1092502 / 364357 B | 2224 / 1163 B |
+
+主入口文件从约 1161 KB 降到 178 KB，但还有共享 chunk；不能只看入口文件判断网站下载量。上表已包含各示例引用的库共享代码。可选 icons.js 约 980 KB，npm 安装包仍包含它；网站不导入即可不进入组件依赖链。