sky-ui-kit 0.1.8 → 0.1.9

package/llms-full.txt

@@ -1,6 +1,6 @@
 # sky-ui-kit
 
-> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.8. AI tools must explicitly load these files.
+> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.9. AI tools must explicitly load these files.
 
 ## Documentation
 
@@ -258,6 +258,39 @@ MapLayerControl 参考平台 LayerControl/LayerTreeNode，提供底图选择、
 
 flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
 
+## 2026-11-03：可配置 VFit 尺寸（源码待发布）
+
+数字尺寸代表设计单位，由组件转换为 `calc(var(--cp-font-1, 1px) * n)`；CSS 字符串原样使用，不额外注册 VFit 或 transform。DesignSpacing 支持单值及2/3/4项数组，遵循CSS间距顺序。0是有效值。调用方传裸字符串 `"12"` 不是合法CSS长度，应使用 `:gap="12"`；`"12px"` 是固定CSS像素。
+
+所有新增参数有默认值；下表空字符串表示使用组件现有布局/样式默认值，不是0。根style可控制组件根尺寸，内部内边距通过对应props调整，无需deep覆盖。
+
+| 组件 | 参数与默认值 |
+| --- | --- |
+| MapPageLayout | 新增gap=12；已有rightPanelWidth=328、leftPanelWidth=320、edge=12等参数兼容字符串并支持数字；top/bottom/toolbar/timeline偏移默认空字符串，沿用自动避让 |
+| DefenseMapLayout | gap=4、padding=4、toolbarGap=12、toolbarPadding=12；topOffset默认64设计单位，兼容数字/字符串 |
+| MapWorkspacePanel | headerPadding=16、bodyPadding=16、footerPadding=[12,16]、gap=16 |
+| ModelWorkspacePanel | headerPadding=[12,16]、bodyPadding=16、footerPadding=[12,16]、gap=12 |
+| WorkbenchPanel | width='auto'、height='auto'、padding=0、gap=0；gap只在调用方使用flex/grid时产生间距，不强改display |
+| ManagementResourceLayout | gap=20、padding=[0,24,20]（内容区域）、introPadding=24、filterGap=20、filterPadding=[20,24]、inputWidth=260、selectWidth=160、cascaderWidth=280、responsive=false |
+| AppSelect | width='100%'、controlHeight=''（按size取主题小/中/大高度）、controlPadding=[0,10]；多选内容可增高；浮层不再设100%最小宽度，使用底层fit-input-width等配置 |
+| ProjectMenu | width=''、itemHeight=''、itemPadding=''、padding=''（分别保留横/纵菜单已有默认值）、gap=2 |
+| MapTimeline | padding=[10,12]、gap=9、trackHeight=88、controlHeight=30；不改变播放/时次数据API |
+| MapBottomProcessPanel | height=320、maxHeight='42dvh'、headerPadding=[10,16]、metaPadding=[8,16,0]、gap=12 |
+| ProcessDataTable | cellPadding=[6,10]、paginationGap=12、paginationPadding=5 |
+
+ManagementResourceLayout默认按VFit保持结构，不在700px阈值自动切换；旧调用方如需原断点布局显式传responsive=true。这是需要在升级说明中说明的行为变化。其内容区域padding与介绍区padding分开，避免改变原默认留白。
+
+地图布局时间轴测量改为offsetHeight，使用布局坐标而非transform后的视口像素，防止再次乘入缩放系数。UiButton/UiSelect/UiTable等基础组件继续使用底层size、width、height及主题token，无重复同义接口。旧TemplateLayout保留兼容接口，不冒充MapPageLayout别名。
+
+示例：
+```vue
+<MapWorkspacePanel title="降水统计" :header-padding="[12, 16]" :body-padding="[8, 12]" :gap="8">
+  业务内容
+</MapWorkspacePanel>
+<MapPageLayout :right-panel-width="320" :edge="12" :gap="8" />
+```
+预览入口：MapPageLayout布局演示，点击“查看紧凑尺寸”比较右栏宽度、边距与面板内边距。其他组件参数与默认值可在生成API查询。当前未构建、打包、发布或浏览器验证，用户预览确认后自行发版。
+
 <!-- GENERATED EXAMPLES -->
 
 ### 快速开始：安装最新正式版本
@@ -1001,26 +1034,29 @@ const items = [{ key: 'overview', label: '运行概览' }, { key: 'data', label:
 ```vue
 <script setup lang="ts">
 import { ref } from 'vue'
-import { MapPageLayout, DefenseMapLayout, UiButton, MapTools, WorkbenchPanel } from 'sky-ui-kit'
+import { MapPageLayout, DefenseMapLayout, UiButton, MapTools, WorkbenchPanel, MapWorkspacePanel } from 'sky-ui-kit'
 const rightOpen = ref(true)
 const showTimeline = ref(true)
 const overlap = ref(false)
+const compactDimensions = ref(false)
 </script>
 <template>
   <div class="layout-demo-controls">
+    <UiButton @click="compactDimensions = !compactDimensions">{{ compactDimensions ? '切回默认尺寸' : '查看紧凑尺寸' }}</UiButton>
     <UiButton @click="rightOpen = !rightOpen">{{ rightOpen ? '收起右栏' : '展开右栏' }}</UiButton>
     <UiButton @click="showTimeline = !showTimeline">{{ showTimeline ? '隐藏时间轴' : '显示时间轴' }}</UiButton>
     <UiButton @click="overlap = !overlap">{{ overlap ? '恢复正常避让' : '模拟模块遮挡' }}</UiButton>
   </div>
   <div class="layout-demo-map" >
-    <MapPageLayout v-model:right-open="rightOpen" :timeline-right="overlap ? 'var(--map-layout-edge)' : ''">
+    <MapPageLayout v-model:right-open="rightOpen" :gap="compactDimensions ? 6 : 12" :edge="compactDimensions ? 6 : 12" :right-panel-width="compactDimensions ? 280 : 328" :timeline-right="overlap ? 'var(--map-layout-edge)' : ''">
       <template #top><span>地图标题 / 查询区域</span></template>
       <template #toolbar><MapTools :items="[{ key: 'layers', label: '图层' }]" /><WorkbenchPanel v-if="overlap" class="layout-demo-expanded">右上展开面板<br>鼠标移入时整个工具区域置顶</WorkbenchPanel></template>
-      <template #right><WorkbenchPanel style="height: 100%">右栏 · 放参数表单或业务列表<br>鼠标移入当前区域时置顶</WorkbenchPanel></template>
+      <template #right><MapWorkspacePanel title="可配置面板" :header-padding="compactDimensions ? [8, 12] : 16" :body-padding="compactDimensions ? [8, 12] : 16" :gap="compactDimensions ? 8 : 16">数字为 VFit 设计尺寸；默认值无需重复传入。<template #footer>鼠标移入当前区域时置顶</template></MapWorkspacePanel></template>
       <template #legend><WorkbenchPanel :class="{ 'layout-demo-overlap-legend': overlap }">图例 · 鼠标移入置顶</WorkbenchPanel></template>
       <template v-if="showTimeline" #timeline><WorkbenchPanel class="layout-demo-timeline">时间轴 / 过程图区域 · 鼠标移入置顶</WorkbenchPanel></template>
     </MapPageLayout>
   </div>
+  <p>尺寸参数：数字自动跟随 VFit，数组为上/右/下/左间距，CSS 字符串原样使用。例如 :body-padding="[8, 12]"、:gap="8"。</p>
   <h3>会商布局 · 顶部操作区 + 四个地图位置</h3>
   <p>以下仅展示区域，不创建地图。保持两列布局，尺寸沿用 VFit 缩放变量；四个地图位置均分剩余高度，不产生内部滚动条。</p>
   <div class="layout-demo-map" >
@@ -3482,10 +3518,49 @@ SVG 图库从主入口移到可选 icons 入口，SvgIcon 不再自动注册；
 ## 2026-10-30 · HTML / Vue 双接入文档
 
 新增独立 model-workspace.css 发布出口，原生 HTML 用 CSS 和结构类，Vue 用主题组件与公共 CSS。补齐两套完整示例、主题切换、事件绑定和部署路径说明，未构建发布。
+
+## 2026-11-02 · 0.1.8 发布准备
+
+- 发布当前组件源码、按需入口及模型工作区主题；HTML 使用 model-workspace.css，Vue 使用组件与 style.css。清除旧消费项目锁记录。发布状态以 npm 注册表为准。
+
+
+
+## 2026-11-03：可配置 VFit 尺寸（源码待发布）
+
+数字尺寸代表设计单位，由组件转换为 `calc(var(--cp-font-1, 1px) * n)`；CSS 字符串原样使用，不额外注册 VFit 或 transform。DesignSpacing 支持单值及2/3/4项数组，遵循CSS间距顺序。0是有效值。调用方传裸字符串 `"12"` 不是合法CSS长度，应使用 `:gap="12"`；`"12px"` 是固定CSS像素。
+
+所有新增参数有默认值；下表空字符串表示使用组件现有布局/样式默认值，不是0。根style可控制组件根尺寸，内部内边距通过对应props调整，无需deep覆盖。
+
+| 组件 | 参数与默认值 |
+| --- | --- |
+| MapPageLayout | 新增gap=12；已有rightPanelWidth=328、leftPanelWidth=320、edge=12等参数兼容字符串并支持数字；top/bottom/toolbar/timeline偏移默认空字符串，沿用自动避让 |
+| DefenseMapLayout | gap=4、padding=4、toolbarGap=12、toolbarPadding=12；topOffset默认64设计单位，兼容数字/字符串 |
+| MapWorkspacePanel | headerPadding=16、bodyPadding=16、footerPadding=[12,16]、gap=16 |
+| ModelWorkspacePanel | headerPadding=[12,16]、bodyPadding=16、footerPadding=[12,16]、gap=12 |
+| WorkbenchPanel | width='auto'、height='auto'、padding=0、gap=0；gap只在调用方使用flex/grid时产生间距，不强改display |
+| ManagementResourceLayout | gap=20、padding=[0,24,20]（内容区域）、introPadding=24、filterGap=20、filterPadding=[20,24]、inputWidth=260、selectWidth=160、cascaderWidth=280、responsive=false |
+| AppSelect | width='100%'、controlHeight=''（按size取主题小/中/大高度）、controlPadding=[0,10]；多选内容可增高；浮层不再设100%最小宽度，使用底层fit-input-width等配置 |
+| ProjectMenu | width=''、itemHeight=''、itemPadding=''、padding=''（分别保留横/纵菜单已有默认值）、gap=2 |
+| MapTimeline | padding=[10,12]、gap=9、trackHeight=88、controlHeight=30；不改变播放/时次数据API |
+| MapBottomProcessPanel | height=320、maxHeight='42dvh'、headerPadding=[10,16]、metaPadding=[8,16,0]、gap=12 |
+| ProcessDataTable | cellPadding=[6,10]、paginationGap=12、paginationPadding=5 |
+
+ManagementResourceLayout默认按VFit保持结构，不在700px阈值自动切换；旧调用方如需原断点布局显式传responsive=true。这是需要在升级说明中说明的行为变化。其内容区域padding与介绍区padding分开，避免改变原默认留白。
+
+地图布局时间轴测量改为offsetHeight，使用布局坐标而非transform后的视口像素，防止再次乘入缩放系数。UiButton/UiSelect/UiTable等基础组件继续使用底层size、width、height及主题token，无重复同义接口。旧TemplateLayout保留兼容接口，不冒充MapPageLayout别名。
+
+示例：
+```vue
+<MapWorkspacePanel title="降水统计" :header-padding="[12, 16]" :body-padding="[8, 12]" :gap="8">
+  业务内容
+</MapWorkspacePanel>
+<MapPageLayout :right-panel-width="320" :edge="12" :gap="8" />
+```
+预览入口：MapPageLayout布局演示，点击“查看紧凑尺寸”比较右栏宽度、边距与面板内边距。其他组件参数与默认值可在生成API查询。当前未构建、打包、发布或浏览器验证，用户预览确认后自行发版。
 
-## 2026-11-02 · 0.1.8 发布准备
+## 2026-11-03 · 0.1.9 发布准备
 
-- 发布当前组件源码、按需入口及模型工作区主题；HTML 使用 model-workspace.css，Vue 使用组件与 style.css。清除旧消费项目锁记录。发布状态以 npm 注册表为准。
+- 将当前布局、面板、尺寸适配与主题调整纳入新版，重新生成 AI 文档并检查组件包。发布结果以 npm 注册表为准。
 
 
 # Component API reference
@@ -3517,6 +3592,9 @@ Slots: No declared content slots.
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| width | DesignLength | false | '100%' |
+| controlHeight | DesignLength | false | '' |
+| controlPadding | DesignSpacing | false | () => [0, 10] |
 | modelValue | AppSelectValue | false | undefined |
 | options | AppSelectOption[] | false | () => [] |
 | emptyLabel | string | false | '暂无可选项' |
@@ -3531,6 +3609,10 @@ Slots: No declared content slots.
 Slots: No declared content slots.
 
 ```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
 export type AppSelectValue = string | number | boolean | Record<string, unknown> | AppSelectValue[] | null | undefined
 export type AppSelectOption = {
   label: string
@@ -3545,6 +3627,10 @@ export type AppSelectOption = {
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| padding | DesignSpacing | false | () => [10, 12] |
+| gap | DesignLength | false | 9 |
+| trackHeight | DesignLength | false | 88 |
+| controlHeight | DesignLength | false | 30 |
 | modelValue | number | false | 0 |
 | startTime | TimelineTimeInput | false | () => new Date() |
 | points | TimelinePoint[] | false | () => [] |
@@ -3579,6 +3665,10 @@ export type AppSelectOption = {
 Slots: date-select
 
 ```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
 type IntervalUnit = 'minute' | 'hour' | 'day' | 'month' | 'year'
 type TimelineKind = 'observed' | 'forecast'
 type TimelineTimeInput = string | number | Date
@@ -3668,6 +3758,11 @@ export type TimeRangeQuickOption = {
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| width | DesignLength | false | '' |
+| itemHeight | DesignLength | false | '' |
+| itemPadding | DesignSpacing | false | '' |
+| padding | DesignSpacing | false | '' |
+| gap | DesignLength | false | 2 |
 | direction | 'horizontal' &#124; 'vertical' | false | 'horizontal' |
 | active | string | false | '' |
 | items | ProjectMenuItem[] | false | () => [] |
@@ -3681,6 +3776,10 @@ export type TimeRangeQuickOption = {
 Slots: No declared content slots.
 
 ```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
 export interface ProjectMenuItem { key: string; label: string; disabled?: boolean; icon?: Component; children?: ProjectMenuItem[] }
 export interface ProjectMenuGroup { label: string; items: ProjectMenuItem[] }
 ```
@@ -3788,6 +3887,9 @@ Slots: No declared content slots.
 | times | string[] | true | undefined / no declared default |
 | series | { name: string; data: (number &#124; null)[] }[] | true | undefined / no declared default |
 | loading | boolean | false | undefined / no declared default |
+| cellPadding | DesignSpacing | false | () => [6, 10] |
+| paginationGap | DesignLength | false | 12 |
+| paginationPadding | DesignSpacing | false | 5 |
 
 ### Events
 
@@ -3795,6 +3897,13 @@ No declared events.
 
 Slots: No declared content slots.
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## WorkbenchShell
 
 ### Props
@@ -3822,6 +3931,10 @@ Slots: header, sidebar-footer, workspace, default
 |---|---|---|---|
 | as | 'section' &#124; 'aside' &#124; 'div' | false | 'section' |
 | floating | boolean | false | true |
+| width | DesignLength | false | 'auto' |
+| height | DesignLength | false | 'auto' |
+| padding | DesignSpacing | false | 0 |
+| gap | DesignLength | false | 0 |
 
 ### Events
 
@@ -3829,6 +3942,13 @@ No declared events.
 
 Slots: default
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## MetricCard
 
 ### Props
@@ -3933,17 +4053,18 @@ Slots: left, top, toolbar, right, legend, timeline, content, default
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| gap | DesignLength | false | 12 |
 | rightOpen | boolean | false | false |
 | rightPanelEnabled | boolean | false | true |
-| rightPanelWidth | string | false | 'calc(var(--cp-font-1, 1px) * 328)' |
-| leftPanelWidth | string | false | 'calc(var(--cp-font-1, 1px) * 320)' |
-| edge | string | false | 'calc(var(--cp-font-1, 1px) * 12)' |
-| topOffset | string | false | '' |
-| bottomOffset | string | false | '' |
-| toolbarTop | string | false | '' |
-| timelineLeft | string | false | '' |
-| timelineRight | string | false | '' |
-| timelineBottom | string | false | '' |
+| rightPanelWidth | DesignLength | false | 'calc(var(--cp-font-1, 1px) * 328)' |
+| leftPanelWidth | DesignLength | false | 'calc(var(--cp-font-1, 1px) * 320)' |
+| edge | DesignLength | false | 'calc(var(--cp-font-1, 1px) * 12)' |
+| topOffset | DesignLength | false | '' |
+| bottomOffset | DesignLength | false | '' |
+| toolbarTop | DesignLength | false | '' |
+| timelineLeft | DesignLength | false | '' |
+| timelineRight | DesignLength | false | '' |
+| timelineBottom | DesignLength | false | '' |
 
 ### Events
 
@@ -3952,6 +4073,13 @@ Slots: left, top, toolbar, right, legend, timeline, content, default
 
 Slots: left, top, toolbar, right, legend, timeline, content, default
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## RainfallRankingTable
 
 ### Props
@@ -4290,6 +4418,15 @@ Slots: message, primary, default, footer
 | title | string | false | undefined / no declared default |
 | description | string | false | undefined / no declared default |
 | showIntro | boolean | false | true |
+| gap | DesignLength | false | 20 |
+| padding | DesignSpacing | false | () => [0, 24, 20] |
+| introPadding | DesignSpacing | false | 24 |
+| filterGap | DesignLength | false | 20 |
+| filterPadding | DesignSpacing | false | () => [20, 24] |
+| inputWidth | DesignLength | false | 260 |
+| selectWidth | DesignLength | false | 160 |
+| cascaderWidth | DesignLength | false | 280 |
+| responsive | boolean | false | false |
 
 ### Events
 
@@ -4297,6 +4434,13 @@ No declared events.
 
 Slots: summary, filters, heading, actions, default
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## GlobalMapLayerDock
 
 ### Props
@@ -4362,6 +4506,11 @@ Slots: footer
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| height | DesignLength | false | 320 |
+| maxHeight | DesignLength | false | '42dvh' |
+| headerPadding | DesignSpacing | false | ()=>[10,16] |
+| metaPadding | DesignSpacing | false | ()=>[8,16,0] |
+| gap | DesignLength | false | 12 |
 | title | string | true | undefined / no declared default |
 | subtitle | string | false | '' |
 | demo | boolean | false | false |
@@ -4377,6 +4526,13 @@ Slots: footer
 
 Slots: No declared content slots.
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## MapWorkspacePanel
 
 ### Props
@@ -4385,6 +4541,10 @@ Slots: No declared content slots.
 |---|---|---|---|
 | title | string | true | undefined / no declared default |
 | subtitle | string | false | undefined / no declared default |
+| headerPadding | DesignSpacing | false | 16 |
+| bodyPadding | DesignSpacing | false | 16 |
+| footerPadding | DesignSpacing | false | () => [12, 16] |
+| gap | DesignLength | false | 16 |
 
 ### Events
 
@@ -4392,6 +4552,13 @@ No declared events.
 
 Slots: actions, default, footer
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## NationalHydroSidebar
 
 ### Props
@@ -4461,7 +4628,11 @@ Slots: No declared content slots.
 |---|---|---|---|
 | structured | boolean | false | false |
 | columns | 1 &#124; 2 | false | 2 |
-| topOffset | string | false | 'calc(var(--cp-font-1, 1px) * 64)' |
+| gap | DesignLength | false | 4 |
+| padding | DesignSpacing | false | 4 |
+| toolbarGap | DesignLength | false | 12 |
+| toolbarPadding | DesignSpacing | false | 12 |
+| topOffset | DesignLength | false | 'calc(var(--cp-font-1, 1px) * 64)' |
 
 ### Events
 
@@ -4469,6 +4640,13 @@ No declared events.
 
 Slots: toolbar, default
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## ModelWorkspace
 
 ### Props
@@ -4506,6 +4684,10 @@ Slots: title, actions
 | Name | Type | Required | Default expression |
 |---|---|---|---|
 | title | string | false | undefined / no declared default |
+| headerPadding | DesignSpacing | false | () => [12, 16] |
+| bodyPadding | DesignSpacing | false | 16 |
+| footerPadding | DesignSpacing | false | () => [12, 16] |
+| gap | DesignLength | false | 12 |
 
 ### Events
 
@@ -4513,6 +4695,13 @@ No declared events.
 
 Slots: header, actions, default, footer
 
+```ts
+/** Numeric dimensions are VFit design units; CSS strings pass through unchanged. */
+export type DesignLength = number | string
+export type DesignSpacing = DesignLength | readonly [DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength] | readonly [DesignLength, DesignLength, DesignLength, DesignLength]
+
+```
+
 ## 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.
@@ -5895,6 +6084,40 @@ import { DefenseMapLayout, UiButton } from 'sky-ui-kit'
 
 
 独立 model-workspace.css 面向原生 HTML，无 Vue/Element Plus 样式依赖；与 style.css 的模型主题来自同一源文件，Vue 无需重复导入。
+
+
+## 2026-11-03：可配置 VFit 尺寸（源码待发布）
+
+数字尺寸代表设计单位，由组件转换为 `calc(var(--cp-font-1, 1px) * n)`；CSS 字符串原样使用，不额外注册 VFit 或 transform。DesignSpacing 支持单值及2/3/4项数组，遵循CSS间距顺序。0是有效值。调用方传裸字符串 `"12"` 不是合法CSS长度，应使用 `:gap="12"`；`"12px"` 是固定CSS像素。
+
+所有新增参数有默认值；下表空字符串表示使用组件现有布局/样式默认值，不是0。根style可控制组件根尺寸，内部内边距通过对应props调整，无需deep覆盖。
+
+| 组件 | 参数与默认值 |
+| --- | --- |
+| MapPageLayout | 新增gap=12；已有rightPanelWidth=328、leftPanelWidth=320、edge=12等参数兼容字符串并支持数字；top/bottom/toolbar/timeline偏移默认空字符串，沿用自动避让 |
+| DefenseMapLayout | gap=4、padding=4、toolbarGap=12、toolbarPadding=12；topOffset默认64设计单位，兼容数字/字符串 |
+| MapWorkspacePanel | headerPadding=16、bodyPadding=16、footerPadding=[12,16]、gap=16 |
+| ModelWorkspacePanel | headerPadding=[12,16]、bodyPadding=16、footerPadding=[12,16]、gap=12 |
+| WorkbenchPanel | width='auto'、height='auto'、padding=0、gap=0；gap只在调用方使用flex/grid时产生间距，不强改display |
+| ManagementResourceLayout | gap=20、padding=[0,24,20]（内容区域）、introPadding=24、filterGap=20、filterPadding=[20,24]、inputWidth=260、selectWidth=160、cascaderWidth=280、responsive=false |
+| AppSelect | width='100%'、controlHeight=''（按size取主题小/中/大高度）、controlPadding=[0,10]；多选内容可增高；浮层不再设100%最小宽度，使用底层fit-input-width等配置 |
+| ProjectMenu | width=''、itemHeight=''、itemPadding=''、padding=''（分别保留横/纵菜单已有默认值）、gap=2 |
+| MapTimeline | padding=[10,12]、gap=9、trackHeight=88、controlHeight=30；不改变播放/时次数据API |
+| MapBottomProcessPanel | height=320、maxHeight='42dvh'、headerPadding=[10,16]、metaPadding=[8,16,0]、gap=12 |
+| ProcessDataTable | cellPadding=[6,10]、paginationGap=12、paginationPadding=5 |
+
+ManagementResourceLayout默认按VFit保持结构，不在700px阈值自动切换；旧调用方如需原断点布局显式传responsive=true。这是需要在升级说明中说明的行为变化。其内容区域padding与介绍区padding分开，避免改变原默认留白。
+
+地图布局时间轴测量改为offsetHeight，使用布局坐标而非transform后的视口像素，防止再次乘入缩放系数。UiButton/UiSelect/UiTable等基础组件继续使用底层size、width、height及主题token，无重复同义接口。旧TemplateLayout保留兼容接口，不冒充MapPageLayout别名。
+
+示例：
+```vue
+<MapWorkspacePanel title="降水统计" :header-padding="[12, 16]" :body-padding="[8, 12]" :gap="8">
+  业务内容
+</MapWorkspacePanel>
+<MapPageLayout :right-panel-width="320" :edge="12" :gap="8" />
+```
+预览入口：MapPageLayout布局演示，点击“查看紧凑尺寸”比较右栏宽度、边距与面板内边距。其他组件参数与默认值可在生成API查询。当前未构建、打包、发布或浏览器验证，用户预览确认后自行发版。
 
 # 按需引入
 

package/llms.txt

@@ -1,6 +1,6 @@
 # sky-ui-kit
 
-> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.8. AI tools must explicitly load these files.
+> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.9. AI tools must explicitly load these files.
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sky-ui-kit",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Vue UI components compatible with Element Plus and the project theme",
   "type": "module",
   "files": [