@xihan-ui/web-components 1.0.0-alpha.3 → 1.0.0

package/custom-elements.json

@@ -704,6 +704,9 @@
             {
               "name": "--xh-alert-gap"
             },
+            {
+              "name": "--xh-alert-icon-box"
+            },
             {
               "name": "--xh-alert-icon-fg"
             },
@@ -1627,12 +1630,16 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<xh-badge>` —— 徽标展示宿主，无状态机，外观来自 variant 属性。",
+          "description": "`<xh-badge>` —— 角标宿主，无状态机。\n\n被标记的东西写进 root，角标本身写进 indicator；角标是挂在别的元素角上的一枚标记，\n行内的状态药丸请用 `<xh-tag>`。",
           "name": "XhBadgeElement",
           "cssParts": [
             {
-              "description": "承载 data-scope/data-part/data-* 的展示节点",
+              "description": "锚点：被标记的那个东西放进它里面",
               "name": "root"
+            },
+            {
+              "description": "角标本身，绝对定位在 root 的某个角上",
+              "name": "indicator"
             }
           ],
           "members": [
@@ -1647,12 +1654,12 @@
             },
             {
               "kind": "field",
-              "name": "variant",
+              "name": "placement",
               "privacy": "public",
               "type": {
-                "text": "BadgeVariant | undefined"
+                "text": "BadgePlacement | undefined"
               },
-              "attribute": "variant"
+              "attribute": "placement"
             },
             {
               "kind": "field",
@@ -1731,11 +1738,11 @@
           "attributes": [
             {
               "type": {
-                "text": "BadgeVariant | undefined"
+                "text": "BadgePlacement | undefined"
               },
-              "description": "视觉变体",
-              "name": "variant",
-              "fieldName": "variant"
+              "description": "挂在哪个角上，默认 top-end",
+              "name": "placement",
+              "fieldName": "placement"
             },
             {
               "type": {
@@ -1789,7 +1796,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "读屏怎么念这枚徽标，例如「3 条未读」",
+              "description": "读屏怎么念这枚角标，例如「3 条未读」",
               "name": "label",
               "fieldName": "label"
             }
@@ -1815,6 +1822,18 @@
             },
             {
               "name": "--xh-badge-font-weight"
+            },
+            {
+              "name": "--xh-badge-min-size"
+            },
+            {
+              "name": "--xh-badge-px"
+            },
+            {
+              "name": "--xh-badge-radius"
+            },
+            {
+              "name": "--xh-badge-ring"
             }
           ]
         }
@@ -3167,12 +3186,30 @@
             {
               "name": "--xh-card-bg"
             },
+            {
+              "name": "--xh-card-body-pt"
+            },
             {
               "name": "--xh-card-border"
             },
+            {
+              "name": "--xh-card-divider"
+            },
             {
               "name": "--xh-card-fg"
             },
+            {
+              "name": "--xh-card-footer-gap"
+            },
+            {
+              "name": "--xh-card-footer-pt"
+            },
+            {
+              "name": "--xh-card-header-gap"
+            },
+            {
+              "name": "--xh-card-header-pb"
+            },
             {
               "name": "--xh-card-radius"
             },
@@ -3941,6 +3978,14 @@
               "readonly": true,
               "default": "new MachineController<CascaderSchema>( this, cascaderMachine, () => this.machineProps(), { scope: this.cascaderScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), axes: ['horizontal'], props: () => ({ dir: this.direction }), })",
+              "description": "列区的自绘条：与 content 同级挂在已经 fixed 的 positioner 上。\n只摆横的——列多到放不下时整体横向滚动，纵向溢出归每一列自己；\n横条的正负按排版方向算，而组件不读计算样式，把作者写的那份显式交过去。"
+            },
             {
               "kind": "method",
               "name": "machineProps",
@@ -4338,6 +4383,9 @@
             {
               "name": "--xh-cascader-column-divider"
             },
+            {
+              "name": "--xh-cascader-column-gap"
+            },
             {
               "name": "--xh-cascader-column-h"
             },
@@ -4494,6 +4542,12 @@
             {
               "name": "--xh-cascader-row-selected-font-weight"
             },
+            {
+              "name": "--xh-cascader-search-divider"
+            },
+            {
+              "name": "--xh-cascader-search-list-gap"
+            },
             {
               "name": "--xh-cascader-search-p"
             },
@@ -5250,6 +5304,9 @@
             },
             {
               "name": "--xh-checkbox-label-gap"
+            },
+            {
+              "name": "--xh-checkbox-radius"
             }
           ]
         }
@@ -6175,6 +6232,15 @@
               },
               "attribute": "name"
             },
+            {
+              "kind": "field",
+              "name": "size",
+              "privacy": "public",
+              "type": {
+                "text": "Size | undefined"
+              },
+              "attribute": "size"
+            },
             {
               "kind": "field",
               "name": "direction",
@@ -6272,6 +6338,14 @@
               "readonly": true,
               "default": "new MachineController<ColorPickerSchema>( this, colorPickerMachine, () => this.machineProps(), { scope: this.pickerScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "面板的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "method",
               "name": "machineProps",
@@ -6491,6 +6565,14 @@
               "name": "swatches",
               "fieldName": "swatches"
             },
+            {
+              "type": {
+                "text": "Size | undefined"
+              },
+              "description": "尺寸",
+              "name": "size",
+              "fieldName": "size"
+            },
             {
               "type": {
                 "text": "Direction | undefined"
@@ -7102,6 +7184,14 @@
               "readonly": true,
               "default": "new MachineController<ComboboxSchema>( this, comboboxMachine, () => this.machineProps(), { scope: this.comboboxScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "候选列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "field",
               "name": "declaredDisabled",
@@ -7421,6 +7511,9 @@
             {
               "name": "--xh-combobox-content-fg"
             },
+            {
+              "name": "--xh-combobox-content-gap"
+            },
             {
               "name": "--xh-combobox-content-max-h"
             },
@@ -7532,6 +7625,9 @@
             {
               "name": "--xh-combobox-input-font-size"
             },
+            {
+              "name": "--xh-combobox-input-py"
+            },
             {
               "name": "--xh-combobox-item-bg-hover"
             },
@@ -7550,6 +7646,9 @@
             {
               "name": "--xh-combobox-item-gap"
             },
+            {
+              "name": "--xh-combobox-item-group-gap"
+            },
             {
               "name": "--xh-combobox-item-indicator-fg"
             },
@@ -8229,6 +8328,14 @@
               "readonly": true,
               "default": "new MachineController<ContextMenuSchema>( this, contextMenuMachine, () => this.machineProps(), { scope: this.menuScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "条目列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "field",
               "name": "declaredDisabled",
@@ -8448,9 +8555,15 @@
             {
               "name": "--xh-context-menu-border"
             },
+            {
+              "name": "--xh-context-menu-content-gap"
+            },
             {
               "name": "--xh-context-menu-fg"
             },
+            {
+              "name": "--xh-context-menu-group-gap"
+            },
             {
               "name": "--xh-context-menu-group-label-fg"
             },
@@ -9519,6 +9632,24 @@
               },
               "attribute": "visible-count"
             },
+            {
+              "kind": "field",
+              "name": "fixedWeeks",
+              "privacy": "public",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "attribute": "fixed-weeks"
+            },
+            {
+              "kind": "field",
+              "name": "defaultFocusedValue",
+              "privacy": "public",
+              "type": {
+                "text": "string | undefined"
+              },
+              "attribute": "default-focused-value"
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -9756,6 +9887,14 @@
               "readonly": true,
               "default": "new MachineController<DateFieldSchema>( this, dateFieldMachine, () => datePickerFieldEndProps(this.rootCtrl.service), { scope: this.pickerScope }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "浮层面板的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "method",
               "name": "services",
@@ -10048,10 +10187,26 @@
               "type": {
                 "text": "number | undefined"
               },
-              "description": "并排展示几页",
+              "description": "并排展示几页；缺省单选 1，区间按两端定，同一页放得下就 1",
               "name": "visible-count",
               "fieldName": "visibleCount"
             },
+            {
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "日历恒渲染六行，默认开；写 fixed-weeks=\"false\" 关掉",
+              "name": "fixed-weeks",
+              "fieldName": "fixedWeeks"
+            },
+            {
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "初始聚焦日，同时决定展开时先落在哪一页",
+              "name": "default-focused-value",
+              "fieldName": "defaultFocusedValue"
+            },
             {
               "type": {
                 "text": "boolean | undefined"
@@ -10197,6 +10352,9 @@
             {
               "name": "--xh-date-picker-calendar-gap"
             },
+            {
+              "name": "--xh-date-picker-column-divider"
+            },
             {
               "name": "--xh-date-picker-confirm-bg"
             },
@@ -10206,6 +10364,12 @@
             {
               "name": "--xh-date-picker-confirm-fg"
             },
+            {
+              "name": "--xh-date-picker-confirm-trigger-px"
+            },
+            {
+              "name": "--xh-date-picker-confirm-trigger-radius"
+            },
             {
               "name": "--xh-date-picker-content-bg"
             },
@@ -10311,18 +10475,33 @@
             {
               "name": "--xh-date-picker-preset-fg-selected"
             },
+            {
+              "name": "--xh-date-picker-preset-px"
+            },
+            {
+              "name": "--xh-date-picker-preset-py"
+            },
+            {
+              "name": "--xh-date-picker-preset-radius"
+            },
             {
               "name": "--xh-date-picker-presets-gap"
             },
             {
               "name": "--xh-date-picker-presets-h"
             },
+            {
+              "name": "--xh-date-picker-presets-padding"
+            },
             {
               "name": "--xh-date-picker-time-column-gap"
             },
             {
               "name": "--xh-date-picker-time-column-h"
             },
+            {
+              "name": "--xh-date-picker-time-column-padding"
+            },
             {
               "name": "--xh-date-picker-time-item-bg-hover"
             },
@@ -10331,6 +10510,15 @@
             },
             {
               "name": "--xh-date-picker-time-item-fg-selected"
+            },
+            {
+              "name": "--xh-date-picker-time-item-px"
+            },
+            {
+              "name": "--xh-date-picker-time-item-py"
+            },
+            {
+              "name": "--xh-date-picker-time-item-radius"
             }
           ]
         }
@@ -10476,6 +10664,9 @@
             {
               "name": "--xh-descriptions-border"
             },
+            {
+              "name": "--xh-descriptions-divider"
+            },
             {
               "name": "--xh-descriptions-fg"
             },
@@ -10887,6 +11078,9 @@
             {
               "name": "--xh-dialog-max-w"
             },
+            {
+              "name": "--xh-dialog-positioner-padding"
+            },
             {
               "name": "--xh-dialog-px"
             },
@@ -14115,7 +14309,7 @@
           "name": "XhFlexElement",
           "cssParts": [
             {
-              "description": "排布容器，承载 data-direction / data-align / data-justify / data-gap / data-wrap / data-inline",
+              "description": "排布容器，承载 data-orientation / data-align / data-justify / data-gap / data-wrap / data-inline",
               "name": "root"
             }
           ],
@@ -14129,6 +14323,15 @@
               "static": true,
               "default": "{ anatomy: flexAnatomy, meta: flexMeta }"
             },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "privacy": "public",
+              "type": {
+                "text": "string | undefined"
+              },
+              "attribute": "orientation"
+            },
             {
               "kind": "field",
               "name": "direction",
@@ -14199,7 +14402,15 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "主轴方向，缺省 row",
+              "description": "主轴方向，缺省 horizontal",
+              "name": "orientation",
+              "fieldName": "orientation"
+            },
+            {
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "主轴方向的旧写法，两个都写时以 orientation 为准",
               "name": "direction",
               "fieldName": "direction"
             },
@@ -16605,6 +16816,9 @@
             {
               "name": "--xh-highlight-fg"
             },
+            {
+              "name": "--xh-highlight-mark-px"
+            },
             {
               "name": "--xh-highlight-radius"
             }
@@ -17125,6 +17339,14 @@
               "readonly": true,
               "default": "new MachineController<HoverCardSchema>( this, hoverCardMachine, () => this.machineProps(), { scope: this.hoverCardScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "卡片内容的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "method",
               "name": "machineProps",
@@ -18652,6 +18874,9 @@
             {
               "name": "--xh-image-viewer-close-size"
             },
+            {
+              "name": "--xh-image-viewer-counter-padding"
+            },
             {
               "name": "--xh-image-viewer-fg"
             },
@@ -18660,6 +18885,18 @@
             },
             {
               "name": "--xh-image-viewer-layer"
+            },
+            {
+              "name": "--xh-image-viewer-overlay-radius"
+            },
+            {
+              "name": "--xh-image-viewer-toolbar-gap"
+            },
+            {
+              "name": "--xh-image-viewer-toolbar-padding"
+            },
+            {
+              "name": "--xh-image-viewer-toolbar-radius"
             }
           ]
         }
@@ -19170,6 +19407,15 @@
               },
               "attribute": "sort-keys"
             },
+            {
+              "kind": "field",
+              "name": "view",
+              "privacy": "public",
+              "type": {
+                "text": "'tree' | 'text' | undefined"
+              },
+              "attribute": "view"
+            },
             {
               "kind": "field",
               "name": "loop",
@@ -19218,6 +19464,24 @@
               "readonly": true,
               "default": "new MachineController<JsonViewerSchema>(this, jsonViewerMachine, () => this.machineProps())"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('root'), scrollable: () => scrollLayerOf(this.getPart('root')), axes: ['vertical', 'horizontal'], props: () => ({ dir: this.direction }), })",
+              "description": "两档的自绘条：与滚动层同级挂在根上。两档互斥，交此刻在场的那个——\n两个容器都归本元素建，身上没有 data-xh-part，从 root 里现查。\n两条轴都摆：深层缩进往行首方向推、长字符串往行尾伸。"
+            },
+            {
+              "kind": "field",
+              "name": "wiredLayer",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "条子上一轮接的是哪一档的容器。"
+            },
             {
               "kind": "method",
               "name": "machineProps",
@@ -19237,6 +19501,14 @@
               "privacy": "private",
               "description": "树容器与每一行都归本元素建，按路径留着复用。"
             },
+            {
+              "kind": "field",
+              "name": "textEl",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "rows",
@@ -19338,6 +19610,48 @@
                   "text": "void"
                 }
               }
+            },
+            {
+              "kind": "method",
+              "name": "syncBars",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "把条子接到此刻在场的那一档容器上。\n机器的追踪器在本轮渲染之前就跑完了，这一轮换掉的容器它看不见；\n换了档就再催一轮，下一轮的追踪器才把滚动监听与容器标记挪过去。"
+            },
+            {
+              "kind": "method",
+              "name": "adopt",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "root",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "keep",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "drop",
+                  "type": {
+                    "text": "HTMLElement | undefined"
+                  }
+                }
+              ],
+              "description": "root 里只留这一档的容器：摘走另一档，作者写在里面的东西也一并清掉。\n自绘条同样挂在 root 上，按 scope 认出来留着——整份 replaceChildren 会把条子一起抹掉。\n已经就位的节点一个都不碰：移动一个节点等于把它摘下来再插回去，焦点在树里会掉回 body。"
             }
           ],
           "events": [
@@ -19413,6 +19727,13 @@
               "description": "尺寸",
               "name": "size",
               "fieldName": "size"
+            },
+            {
+              "name": "view",
+              "type": {
+                "text": "'tree' | 'text' | undefined"
+              },
+              "fieldName": "view"
             }
           ],
           "superclass": {
@@ -19502,6 +19823,9 @@
             },
             {
               "name": "--xh-json-viewer-string-fg"
+            },
+            {
+              "name": "--xh-json-viewer-text-fg"
             }
           ]
         }
@@ -19755,21 +20079,33 @@
             {
               "name": "--xh-layout-border"
             },
+            {
+              "name": "--xh-layout-content-padding"
+            },
             {
               "name": "--xh-layout-fg"
             },
             {
               "name": "--xh-layout-footer-bg"
             },
+            {
+              "name": "--xh-layout-footer-padding"
+            },
             {
               "name": "--xh-layout-header-bg"
             },
+            {
+              "name": "--xh-layout-header-gap"
+            },
             {
               "name": "--xh-layout-header-h"
             },
             {
               "name": "--xh-layout-header-layer"
             },
+            {
+              "name": "--xh-layout-header-px"
+            },
             {
               "name": "--xh-layout-scrollport-h"
             },
@@ -19779,6 +20115,9 @@
             {
               "name": "--xh-layout-sider-collapsed-width"
             },
+            {
+              "name": "--xh-layout-sider-padding"
+            },
             {
               "name": "--xh-layout-sider-trigger-bg"
             },
@@ -19788,6 +20127,12 @@
             {
               "name": "--xh-layout-sider-trigger-fg"
             },
+            {
+              "name": "--xh-layout-sider-trigger-gap"
+            },
+            {
+              "name": "--xh-layout-sider-trigger-px"
+            },
             {
               "name": "--xh-layout-sider-trigger-radius"
             },
@@ -19962,6 +20307,9 @@
             {
               "name": "--xh-list-description-font-size"
             },
+            {
+              "name": "--xh-list-divider"
+            },
             {
               "name": "--xh-list-fg"
             },
@@ -19974,6 +20322,15 @@
             {
               "name": "--xh-list-item-px"
             },
+            {
+              "name": "--xh-list-item-px-lg"
+            },
+            {
+              "name": "--xh-list-item-px-md"
+            },
+            {
+              "name": "--xh-list-item-px-sm"
+            },
             {
               "name": "--xh-list-item-py"
             },
@@ -20371,6 +20728,9 @@
             {
               "name": "--xh-listbox-content-fg"
             },
+            {
+              "name": "--xh-listbox-content-gap"
+            },
             {
               "name": "--xh-listbox-content-max-h"
             },
@@ -20425,6 +20785,9 @@
             {
               "name": "--xh-listbox-item-gap"
             },
+            {
+              "name": "--xh-listbox-item-group-gap"
+            },
             {
               "name": "--xh-listbox-item-indicator-fg"
             },
@@ -21605,6 +21968,14 @@
               "readonly": true,
               "default": "new MachineController<MentionSchema>( this, mentionMachine, () => this.machineProps(), { scope: this.mentionScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "候选列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "field",
               "name": "declaredDisabled",
@@ -21843,6 +22214,9 @@
             {
               "name": "--xh-mention-content-fg"
             },
+            {
+              "name": "--xh-mention-content-gap"
+            },
             {
               "name": "--xh-mention-content-max-h"
             },
@@ -22180,6 +22554,14 @@
               "readonly": true,
               "default": "new MachineController<MenuSchema>( this, menuMachine, () => this.machineProps(), { scope: this.menuScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "条目列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "field",
               "name": "declaredDisabled",
@@ -22412,9 +22794,15 @@
             {
               "name": "--xh-menu-border"
             },
+            {
+              "name": "--xh-menu-content-gap"
+            },
             {
               "name": "--xh-menu-fg"
             },
+            {
+              "name": "--xh-menu-group-gap"
+            },
             {
               "name": "--xh-menu-group-label-fg"
             },
@@ -23002,9 +23390,15 @@
             {
               "name": "--xh-menubar-border"
             },
+            {
+              "name": "--xh-menubar-content-gap"
+            },
             {
               "name": "--xh-menubar-fg"
             },
+            {
+              "name": "--xh-menubar-group-gap"
+            },
             {
               "name": "--xh-menubar-group-label-fg"
             },
@@ -23592,6 +23986,763 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/elements/notification.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<xh-notification>` —— Light-DOM 行为宿主：作者写 root 与若干 group 角色节点，\n元素跑 notification 机器并把 connect 产出打上去。每个 group 用 `placement` 属性声明自己是哪个位置，\n不写就落在队列的 placement 上。\n\n单条通知的节点由作者按队列渲染（读 `items` 或听 `items-change`），元素不替作者生成：\n生成节点就等于收走模板控制权，图标、进度条、i18n 文案都再塞不进来。\n每条渲染成一个 `<xh-notification-item>`，它走完退场会冒泡一条 status-change，本元素据此把记录删掉。",
+          "name": "XhNotificationElement",
+          "cssParts": [
+            {
+              "description": "队列的作用域包装（display: contents，不占布局），承载 data-count / data-empty",
+              "name": "root"
+            },
+            {
+              "description": "role=region 的地标，某一个位置上的那一摞；可自带 placement 属性，承载 data-placement / data-count / data-empty 与间距",
+              "name": "group"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "partContract",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ anatomy: notificationAnatomy, meta: notificationMeta }"
+            },
+            {
+              "kind": "field",
+              "name": "items",
+              "privacy": "public",
+              "type": {
+                "text": "NotificationRecord[] | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultItems",
+              "privacy": "public",
+              "type": {
+                "text": "NotificationRecord[] | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "privacy": "public",
+              "type": {
+                "text": "NotificationPlacement | undefined"
+              },
+              "attribute": "placement"
+            },
+            {
+              "kind": "field",
+              "name": "max",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "max"
+            },
+            {
+              "kind": "field",
+              "name": "gap",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "gap"
+            },
+            {
+              "kind": "field",
+              "name": "duration",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "duration"
+            },
+            {
+              "kind": "field",
+              "name": "removeDelay",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "remove-delay"
+            },
+            {
+              "kind": "field",
+              "name": "pauseOnPageIdle",
+              "privacy": "public",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "attribute": "pause-on-page-idle"
+            },
+            {
+              "kind": "field",
+              "name": "translations",
+              "privacy": "public",
+              "type": {
+                "text": "Partial<NotificationTranslations> | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "notify",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "ctrl",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new MachineController<NotificationSchema>(this, notificationMachine, () => this.machineProps())"
+            },
+            {
+              "kind": "method",
+              "name": "machineProps",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Partial<NotificationSchema['props']>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "commands",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "NotificationApi"
+                }
+              },
+              "description": "命令式入口共用的取法。机器要到进文档（hostConnected）才建：\n还没进文档就发通知是调用方的时序问题，明说好过把这条通知静默丢掉。"
+            },
+            {
+              "kind": "method",
+              "name": "create",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "NotificationOptions"
+                  }
+                }
+              ],
+              "description": "入队并返回 id；同 id 已存在则就地改写，位置不动（处理中转已完成走的就是这条）。"
+            },
+            {
+              "kind": "method",
+              "name": "updateItem",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "Partial<NotificationOptions>"
+                  }
+                }
+              ],
+              "description": "刻意不叫 `update`：那是 Lit 自己的渲染生命周期钩子，占用它会让宿主每次重渲\n都拐进这里来（还带着一个 changedProperties 当 id），组件当场不工作。\nVue 侧没有这层基类，composable 上仍叫 `update`。"
+            },
+            {
+              "kind": "method",
+              "name": "dismiss",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "dismissAll",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "visibleNotifications",
+              "type": {
+                "text": "ResolvedNotification[]"
+              },
+              "description": "max 之内、按加入先后排列的可见条目，已补齐默认值，可直接摊给 `<xh-notification-item>`。",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "placements",
+              "type": {
+                "text": "NotificationPlacement[]"
+              },
+              "description": "当前有条目的位置，按九宫格固定顺序。",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "count",
+              "type": {
+                "text": "number"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "getItemsByPlacement",
+              "return": {
+                "type": {
+                  "text": "ResolvedNotification[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "placement",
+                  "type": {
+                    "text": "NotificationPlacement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "onItemStatus",
+              "privacy": "private",
+              "readonly": true,
+              "description": "单条通知走完退场会冒泡上来：记录该从队列里删掉了。\n认元素名而不是只认事件名——avatar 之类的部件也派 status-change，且完全可能就摆在通知内部。"
+            },
+            {
+              "kind": "method",
+              "name": "wire",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "description": "队列变化；detail 为 `{ items: NotificationRecord[] }`",
+              "name": "items-change",
+              "type": {
+                "text": "NotificationItemsChangeDetails"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "type": {
+                "text": "NotificationPlacement | undefined"
+              },
+              "description": "默认落位，默认 bottom-end",
+              "name": "placement",
+              "fieldName": "placement"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "每个位置最多同时留几条，超出挤掉最旧的；不给即不限",
+              "name": "max",
+              "fieldName": "max"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "同一摞内的间距（px），默认 16",
+              "name": "gap",
+              "fieldName": "gap"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "单条没写 duration 时的默认停留毫秒",
+              "name": "duration",
+              "fieldName": "duration"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "单条没写 remove-delay 时的默认退场窗口毫秒",
+              "name": "remove-delay",
+              "fieldName": "removeDelay"
+            },
+            {
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "页面切到后台时按住计时，逐条下发",
+              "name": "pause-on-page-idle",
+              "fieldName": "pauseOnPageIdle"
+            }
+          ],
+          "superclass": {
+            "name": "XhElement",
+            "module": "/src/element-base"
+          },
+          "tagName": "xh-notification",
+          "customElement": true,
+          "cssProperties": [
+            {
+              "name": "--xh-notification-action-bg"
+            },
+            {
+              "name": "--xh-notification-action-bg-active"
+            },
+            {
+              "name": "--xh-notification-action-bg-hover"
+            },
+            {
+              "name": "--xh-notification-action-border"
+            },
+            {
+              "name": "--xh-notification-action-fg"
+            },
+            {
+              "name": "--xh-notification-action-font-weight"
+            },
+            {
+              "name": "--xh-notification-action-h"
+            },
+            {
+              "name": "--xh-notification-action-px"
+            },
+            {
+              "name": "--xh-notification-action-radius"
+            },
+            {
+              "name": "--xh-notification-bg"
+            },
+            {
+              "name": "--xh-notification-border"
+            },
+            {
+              "name": "--xh-notification-close-bg-active"
+            },
+            {
+              "name": "--xh-notification-close-bg-hover"
+            },
+            {
+              "name": "--xh-notification-close-fg"
+            },
+            {
+              "name": "--xh-notification-close-fg-hover"
+            },
+            {
+              "name": "--xh-notification-close-inset"
+            },
+            {
+              "name": "--xh-notification-close-radius"
+            },
+            {
+              "name": "--xh-notification-close-size"
+            },
+            {
+              "name": "--xh-notification-description-fg"
+            },
+            {
+              "name": "--xh-notification-description-font-size"
+            },
+            {
+              "name": "--xh-notification-fg"
+            },
+            {
+              "name": "--xh-notification-font-size"
+            },
+            {
+              "name": "--xh-notification-gap"
+            },
+            {
+              "name": "--xh-notification-icon-size"
+            },
+            {
+              "name": "--xh-notification-indicator-fg"
+            },
+            {
+              "name": "--xh-notification-indicator-size"
+            },
+            {
+              "name": "--xh-notification-inset"
+            },
+            {
+              "name": "--xh-notification-layer"
+            },
+            {
+              "name": "--xh-notification-leading"
+            },
+            {
+              "name": "--xh-notification-px"
+            },
+            {
+              "name": "--xh-notification-py"
+            },
+            {
+              "name": "--xh-notification-radius"
+            },
+            {
+              "name": "--xh-notification-row-gap"
+            },
+            {
+              "name": "--xh-notification-shadow"
+            },
+            {
+              "name": "--xh-notification-title-fg"
+            },
+            {
+              "name": "--xh-notification-title-font-size"
+            },
+            {
+              "name": "--xh-notification-title-font-weight"
+            },
+            {
+              "name": "--xh-notification-title-leading"
+            },
+            {
+              "name": "--xh-notification-w"
+            }
+          ]
+        },
+        {
+          "kind": "class",
+          "description": "`<xh-notification-item>` —— 单条通知卡片：作者写 item/item-indicator/item-title/\nitem-description/item-action-trigger/item-close-trigger 角色节点，\n元素跑生命周期机器并把 connect 产出打上去。\n\nitem 承载 role 与 aria-live：默认 status + polite（排队等读屏的空隙），\ntype=\"error\" 换成 alert + assertive（打断当前朗读）。指针停在卡片上、\n或焦点落进卡片内部都会把倒计时按住，离开才接着走剩下的那一段。\n\n退场窗口走完只把卡片收起、不删节点：作者写在里面的内容归作者，\n什么时候把这条从队列里删掉是 `<xh-notification>` 的事（它收本元素冒泡上去的 status-change）。",
+          "name": "XhNotificationItemElement",
+          "cssParts": [
+            {
+              "description": "role=status（error 时 alert）的卡片，承载 data-type / data-tone / data-state / data-paused",
+              "name": "item"
+            },
+            {
+              "description": "类型指示符；留空即由皮肤按 data-type 画一枚兜底字形",
+              "name": "item-indicator"
+            },
+            {
+              "description": "标题，aria-labelledby 的目标",
+              "name": "item-title"
+            },
+            {
+              "description": "补充说明，aria-describedby 的目标",
+              "name": "item-description"
+            },
+            {
+              "description": "操作按钮：先发 action 再进入退场",
+              "name": "item-action-trigger"
+            },
+            {
+              "description": "关闭按钮；closable=false 时转原生 disabled 并收起",
+              "name": "item-close-trigger"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "partContract",
+              "static": true,
+              "default": "{ anatomy: notificationAnatomy, meta: { component: 'notification', requiredParts: ['item'] } }",
+              "type": {
+                "text": "object"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "itemId",
+              "privacy": "public",
+              "type": {
+                "text": "string | undefined"
+              },
+              "attribute": "id"
+            },
+            {
+              "kind": "field",
+              "name": "titleText",
+              "privacy": "public",
+              "type": {
+                "text": "string | undefined"
+              },
+              "attribute": "title"
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "privacy": "public",
+              "type": {
+                "text": "string | undefined"
+              },
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "privacy": "public",
+              "type": {
+                "text": "NotificationType | undefined"
+              },
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "duration",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "duration"
+            },
+            {
+              "kind": "field",
+              "name": "removeDelay",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "remove-delay"
+            },
+            {
+              "kind": "field",
+              "name": "closable",
+              "privacy": "public",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "attribute": "closable"
+            },
+            {
+              "kind": "field",
+              "name": "pauseOnPageIdle",
+              "privacy": "public",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "attribute": "pause-on-page-idle"
+            },
+            {
+              "kind": "field",
+              "name": "translations",
+              "privacy": "public",
+              "type": {
+                "text": "Partial<NotificationTranslations> | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "notifyStatus",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "notifyAction",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "ctrl",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new MachineController<ToastSchema>(this, toastMachine, () => this.machineProps(), { configName: 'notification' })"
+            },
+            {
+              "kind": "method",
+              "name": "machineProps",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Partial<ToastSchema['props']>"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "authorOwnsText",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new WeakMap<HTMLElement, boolean>()",
+              "description": "这个部件的文字归不归作者：头一回见到它时定案，之后不再改口。"
+            },
+            {
+              "kind": "method",
+              "name": "fillText",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement | null"
+                  }
+                },
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "作者没往部件里写内容时，用 props 上的文案填进去。\n\n归属只判一次：判完本轮就会把文字写进去，再回读分不清是作者写的还是自己写的，\n从那以后 title 属性改了也再刷不动（Vue 侧是响应式渲染，会跟着改，两侧就此分叉）。"
+            },
+            {
+              "kind": "method",
+              "name": "wire",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "description": "生命周期落位；detail 为 `{ id: string, status: 'dismissing'|'unmounted' }`",
+              "name": "status-change",
+              "type": {
+                "text": "ToastStatusChangeDetails"
+              }
+            },
+            {
+              "description": "操作按钮被按下；detail 为 `{ id: string }`",
+              "name": "action",
+              "type": {
+                "text": "ToastActionDetails"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "队列身份，`<xh-notification>` 按它寻址；不给就用实例自己的 scope id",
+              "name": "id",
+              "fieldName": "itemId"
+            },
+            {
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "标题文案；作者没在 item-title 部件里写内容时由元素填入",
+              "name": "title",
+              "fieldName": "titleText"
+            },
+            {
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "补充说明；作者没在 item-description 部件里写内容时由元素填入",
+              "name": "description",
+              "fieldName": "description"
+            },
+            {
+              "type": {
+                "text": "NotificationType | undefined"
+              },
+              "description": "语气，默认 info；loading 不自动消失",
+              "name": "type",
+              "fieldName": "type"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "停留毫秒，默认 5000；<=0 即关掉自动消失",
+              "name": "duration",
+              "fieldName": "duration"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "退场窗口毫秒，默认 200，留给退场动画",
+              "name": "remove-delay",
+              "fieldName": "removeDelay"
+            },
+            {
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "是否给可用的关闭按钮，默认 true；写 closable=\"false\" 关掉",
+              "name": "closable",
+              "fieldName": "closable"
+            },
+            {
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "页面切到后台时按住计时，默认关",
+              "name": "pause-on-page-idle",
+              "fieldName": "pauseOnPageIdle"
+            }
+          ],
+          "superclass": {
+            "name": "XhElement",
+            "module": "/src/element-base"
+          },
+          "tagName": "xh-notification-item",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "XhNotificationElement",
+          "declaration": {
+            "name": "XhNotificationElement",
+            "module": "src/elements/notification.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "XhNotificationItemElement",
+          "declaration": {
+            "name": "XhNotificationItemElement",
+            "module": "src/elements/notification.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/elements/number-animation.ts",
@@ -24546,7 +25697,7 @@
               "name": "item"
             },
             {
-              "description": "折叠掉的那几页的占位，对读屏隐藏",
+              "description": "折进去那几页的入口，须自带 side 属性（start / end）；承载 data-side 与 aria-expanded",
               "name": "ellipsis"
             }
           ],
@@ -24578,6 +25729,24 @@
               },
               "attribute": "page-size"
             },
+            {
+              "kind": "field",
+              "name": "defaultPageSize",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "default-page-size"
+            },
+            {
+              "kind": "field",
+              "name": "pageSizeOptions",
+              "privacy": "public",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "可选的每页条数档位，默认 [10, 20, 50, 100]"
+            },
             {
               "kind": "field",
               "name": "page",
@@ -24640,18 +25809,164 @@
                 "text": "Partial<PaginationTranslations> | undefined"
               }
             },
+            {
+              "kind": "field",
+              "name": "placement",
+              "privacy": "public",
+              "type": {
+                "text": "Placement | undefined"
+              },
+              "attribute": "placement"
+            },
+            {
+              "kind": "field",
+              "name": "offset",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "offset"
+            },
+            {
+              "kind": "field",
+              "name": "openDelay",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "open-delay"
+            },
+            {
+              "kind": "field",
+              "name": "closeDelay",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "close-delay"
+            },
+            {
+              "kind": "field",
+              "name": "idGen",
+              "type": {
+                "text": "IdGenerator"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "paginationScope",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "positionEngine",
+              "type": {
+                "text": "PositionEnginePort"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "config",
+              "type": {
+                "text": "RuntimeConfig | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "exit",
+              "type": {
+                "text": "OverlayExit | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "退场闸门：收起从跟着展开态走改成跟着 presence 走，退场动画播完才真收。"
+            },
             {
               "kind": "field",
               "name": "notify",
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "notifyPageSize",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "ctrl",
               "privacy": "private",
               "readonly": true,
-              "default": "new MachineController<PaginationSchema>(this, paginationMachine, () => this.machineProps())"
+              "default": "new MachineController<PaginationSchema>( this, paginationMachine, () => this.machineProps(), { scope: this.paginationScope, onBuilt: svc => this.injectRefs(svc) }, )"
+            },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "折叠页码列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
+            {
+              "kind": "method",
+              "name": "ensureConfig",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "openEllipsisEl",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "side",
+                  "type": {
+                    "text": "PaginationEllipsisSide | null"
+                  }
+                }
+              ],
+              "description": "此刻摊开的是哪个省略位的节点——它是定位锚点。"
+            },
+            {
+              "kind": "field",
+              "name": "registerLayer",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "injectRefs",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "svc",
+                  "type": {
+                    "text": "Service<PaginationSchema>"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -24681,6 +25996,10 @@
               "type": {
                 "text": "PaginationPageChangeDetails"
               }
+            },
+            {
+              "description": "每页条数变化；detail 为 `{ pageSize: number, page: number }`，页码是换算后的",
+              "name": "page-size-change"
             }
           ],
           "attributes": [
@@ -24747,6 +26066,46 @@
               "description": "尺寸",
               "name": "size",
               "fieldName": "size"
+            },
+            {
+              "type": {
+                "text": "Placement | undefined"
+              },
+              "description": "省略位摊开后的落点，默认 bottom-start",
+              "name": "placement",
+              "fieldName": "placement"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "浮层与省略位之间的间距（px），默认 8",
+              "name": "offset",
+              "fieldName": "offset"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "指针停在省略位多久才摊开（ms），默认 200",
+              "name": "open-delay",
+              "fieldName": "openDelay"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "指针离开后多久收起（ms），默认 300",
+              "name": "close-delay",
+              "fieldName": "closeDelay"
+            },
+            {
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "非受控初始每页条数，默认 10",
+              "name": "default-page-size",
+              "fieldName": "defaultPageSize"
             }
           ],
           "superclass": {
@@ -24756,6 +26115,27 @@
           "tagName": "xh-pagination",
           "customElement": true,
           "cssProperties": [
+            {
+              "name": "--xh-pagination-content-bg"
+            },
+            {
+              "name": "--xh-pagination-content-border"
+            },
+            {
+              "name": "--xh-pagination-content-max-h"
+            },
+            {
+              "name": "--xh-pagination-content-max-w"
+            },
+            {
+              "name": "--xh-pagination-content-p"
+            },
+            {
+              "name": "--xh-pagination-content-radius"
+            },
+            {
+              "name": "--xh-pagination-content-shadow"
+            },
             {
               "name": "--xh-pagination-ellipsis-fg"
             },
@@ -24765,6 +26145,9 @@
             {
               "name": "--xh-pagination-gap"
             },
+            {
+              "name": "--xh-pagination-icon-size"
+            },
             {
               "name": "--xh-pagination-item-bg"
             },
@@ -24812,6 +26195,18 @@
             },
             {
               "name": "--xh-pagination-item-radius"
+            },
+            {
+              "name": "--xh-pagination-layer"
+            },
+            {
+              "name": "--xh-pagination-page-size-bg"
+            },
+            {
+              "name": "--xh-pagination-page-size-border"
+            },
+            {
+              "name": "--xh-pagination-page-size-border-hover"
             }
           ]
         }
@@ -26093,6 +27488,9 @@
           "tagName": "xh-popconfirm",
           "customElement": true,
           "cssProperties": [
+            {
+              "name": "--xh-popconfirm-action-radius"
+            },
             {
               "name": "--xh-popconfirm-bg"
             },
@@ -26105,6 +27503,9 @@
             {
               "name": "--xh-popconfirm-cancel-fg"
             },
+            {
+              "name": "--xh-popconfirm-cancel-trigger-px"
+            },
             {
               "name": "--xh-popconfirm-confirm-bg"
             },
@@ -26349,6 +27750,14 @@
               "readonly": true,
               "default": "new MachineController<PopoverSchema>( this, popoverMachine, () => this.machineProps(), { scope: this.popoverScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "面板内容的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "method",
               "name": "machineProps",
@@ -26848,6 +28257,14 @@
               "readonly": true,
               "default": "new MachineController<ListboxSchema>( this, listboxMachine, () => this.listboxProps(), { scope: this.popselectScope }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), })",
+              "description": "候选列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上"
+            },
             {
               "kind": "field",
               "name": "declaredDisabled",
@@ -27162,6 +28579,9 @@
             {
               "name": "--xh-popselect-content-fg"
             },
+            {
+              "name": "--xh-popselect-content-gap"
+            },
             {
               "name": "--xh-popselect-content-max-h"
             },
@@ -27529,6 +28949,9 @@
             {
               "name": "--xh-progress-range"
             },
+            {
+              "name": "--xh-progress-range-radius"
+            },
             {
               "name": "--xh-progress-size"
             },
@@ -27537,6 +28960,9 @@
             },
             {
               "name": "--xh-progress-track"
+            },
+            {
+              "name": "--xh-progress-track-radius"
             }
           ]
         }
@@ -28203,6 +29629,9 @@
             {
               "name": "--xh-radio-group-indicator-dot"
             },
+            {
+              "name": "--xh-radio-group-indicator-radius"
+            },
             {
               "name": "--xh-radio-group-indicator-size"
             },
@@ -29031,7 +30460,7 @@
               "type": {
                 "text": "ScrollbarType | undefined"
               },
-              "description": "滚动条露面的时机，默认 hover",
+              "description": "滚动条露面的时机，默认 scroll-hover",
               "name": "type",
               "fieldName": "type"
             },
@@ -29039,7 +30468,7 @@
               "type": {
                 "text": "number | undefined"
               },
-              "description": "收起前的等待毫秒（type 为 scroll / hover 时生效），默认 600",
+              "description": "收起前的等待毫秒（type 为 scroll / hover / scroll-hover 时生效），默认 600",
               "name": "hide-delay",
               "fieldName": "hideDelay"
             },
@@ -29383,7 +30812,7 @@
               "type": {
                 "text": "ScrollbarType | undefined"
               },
-              "description": "露面的时机，默认 hover",
+              "description": "露面的时机，默认 scroll-hover",
               "name": "type",
               "fieldName": "type"
             },
@@ -29391,7 +30820,7 @@
               "type": {
                 "text": "number | undefined"
               },
-              "description": "收起前的等待毫秒（type 为 scroll / hover 时生效），默认 600",
+              "description": "收起前的等待毫秒（type 为 scroll / hover / scroll-hover 时生效），默认 600",
               "name": "hide-delay",
               "fieldName": "hideDelay"
             },
@@ -30800,9 +32229,6 @@
             {
               "name": "--xh-select-control-h"
             },
-            {
-              "name": "--xh-select-control-max-w"
-            },
             {
               "name": "--xh-select-control-min-w"
             },
@@ -30905,6 +32331,9 @@
             {
               "name": "--xh-select-layer"
             },
+            {
+              "name": "--xh-select-list-gap"
+            },
             {
               "name": "--xh-select-placeholder-fg"
             },
@@ -31486,12 +32915,27 @@
             {
               "name": "--xh-side-nav-gap"
             },
+            {
+              "name": "--xh-side-nav-group-label-px"
+            },
+            {
+              "name": "--xh-side-nav-group-label-py"
+            },
             {
               "name": "--xh-side-nav-icon-size"
             },
             {
               "name": "--xh-side-nav-indent"
             },
+            {
+              "name": "--xh-side-nav-link-gap"
+            },
+            {
+              "name": "--xh-side-nav-link-px"
+            },
+            {
+              "name": "--xh-side-nav-link-radius"
+            },
             {
               "name": "--xh-side-nav-p"
             },
@@ -32585,6 +34029,9 @@
             {
               "name": "--xh-slider-mark-label-gap"
             },
+            {
+              "name": "--xh-slider-mark-radius"
+            },
             {
               "name": "--xh-slider-mark-size"
             },
@@ -32675,6 +34122,15 @@
               "static": true,
               "default": "{ anatomy: spaceAnatomy, meta: spaceMeta }"
             },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "privacy": "public",
+              "type": {
+                "text": "SpaceProps['orientation'] | undefined"
+              },
+              "attribute": "orientation"
+            },
             {
               "kind": "field",
               "name": "direction",
@@ -32743,9 +34199,17 @@
           "attributes": [
             {
               "type": {
-                "text": "SpaceProps['direction'] | undefined"
+                "text": "SpaceProps['orientation'] | undefined"
               },
               "description": "排布方向，缺省 horizontal",
+              "name": "orientation",
+              "fieldName": "orientation"
+            },
+            {
+              "type": {
+                "text": "SpaceProps['direction'] | undefined"
+              },
+              "description": "排布方向的旧写法，两个都写时以 orientation 为准",
               "name": "direction",
               "fieldName": "direction"
             },
@@ -32797,21 +34261,6 @@
           "tagName": "xh-space",
           "customElement": true,
           "cssProperties": [
-            {
-              "name": "--xh-space-1"
-            },
-            {
-              "name": "--xh-space-2"
-            },
-            {
-              "name": "--xh-space-3"
-            },
-            {
-              "name": "--xh-space-4"
-            },
-            {
-              "name": "--xh-space-6"
-            },
             {
               "name": "--xh-space-gap"
             }
@@ -33779,6 +35228,9 @@
             {
               "name": "--xh-steps-indicator-font-size"
             },
+            {
+              "name": "--xh-steps-indicator-radius"
+            },
             {
               "name": "--xh-steps-indicator-size"
             },
@@ -33797,6 +35249,9 @@
             {
               "name": "--xh-steps-separator-min-length"
             },
+            {
+              "name": "--xh-steps-separator-radius"
+            },
             {
               "name": "--xh-steps-separator-thickness"
             },
@@ -34143,9 +35598,15 @@
             {
               "name": "--xh-switch-loading-fg"
             },
+            {
+              "name": "--xh-switch-radius"
+            },
             {
               "name": "--xh-switch-thumb"
             },
+            {
+              "name": "--xh-switch-thumb-radius"
+            },
             {
               "name": "--xh-switch-thumb-shadow"
             },
@@ -34325,6 +35786,50 @@
               },
               "attribute": "selection-mode"
             },
+            {
+              "kind": "field",
+              "name": "prefixColumns",
+              "privacy": "public",
+              "type": {
+                "text": "TableColumnKind[]"
+              },
+              "description": "要哪几列前缀列，按给定顺序插在最前面"
+            },
+            {
+              "kind": "field",
+              "name": "columnPreference",
+              "privacy": "public",
+              "type": {
+                "text": "TableColumnPreference"
+              },
+              "description": "列偏好（显隐/顺序/宽/冻结），给定即受控"
+            },
+            {
+              "kind": "field",
+              "name": "defaultColumnPreference",
+              "privacy": "public",
+              "type": {
+                "text": "TableColumnPreference | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "page",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "page"
+            },
+            {
+              "kind": "field",
+              "name": "pageSize",
+              "privacy": "public",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "page-size"
+            },
             {
               "kind": "field",
               "name": "loading",
@@ -34415,6 +35920,12 @@
               },
               "attribute": "size"
             },
+            {
+              "kind": "field",
+              "name": "notifyColumnPreference",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "notifySort",
@@ -34568,6 +36079,10 @@
                 "text": "TableSortChangeDetails"
               }
             },
+            {
+              "description": "列偏好变化；detail 为 `{ value: TableColumnPreference }`",
+              "name": "column-preference-change"
+            },
             {
               "description": "选中集合变化；detail 为 `{ value: string[] | 'all' }`",
               "name": "selection-change",
@@ -34671,6 +36186,20 @@
               "description": "密度：只换单元格的纵向内边距与字号，列宽不受影响",
               "name": "size",
               "fieldName": "size"
+            },
+            {
+              "name": "page",
+              "type": {
+                "text": "number | undefined"
+              },
+              "fieldName": "page"
+            },
+            {
+              "name": "page-size",
+              "type": {
+                "text": "number | undefined"
+              },
+              "fieldName": "pageSize"
             }
           ],
           "superclass": {
@@ -38207,6 +39736,9 @@
             {
               "name": "--xh-time-picker-preset-py"
             },
+            {
+              "name": "--xh-time-picker-preset-radius"
+            },
             {
               "name": "--xh-time-picker-presets-gap"
             },
@@ -38576,9 +40108,21 @@
             {
               "name": "--xh-timeline-connector-min-length"
             },
+            {
+              "name": "--xh-timeline-connector-radius"
+            },
             {
               "name": "--xh-timeline-connector-thickness"
             },
+            {
+              "name": "--xh-timeline-content-gap"
+            },
+            {
+              "name": "--xh-timeline-content-pb"
+            },
+            {
+              "name": "--xh-timeline-content-pt"
+            },
             {
               "name": "--xh-timeline-description-fg"
             },
@@ -38600,6 +40144,9 @@
             {
               "name": "--xh-timeline-indicator-font-size"
             },
+            {
+              "name": "--xh-timeline-indicator-radius"
+            },
             {
               "name": "--xh-timeline-indicator-size"
             },
@@ -38986,7 +40533,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<xh-toast>` —— Light-DOM 行为宿主：作者写 root/title/description/action-trigger/close-trigger\n角色节点，元素跑 toast 机器并把 connect 产出打上去。\n\nroot 承载 role 与 aria-live：默认 status + polite（排队等读屏的空隙），\ntype=\"error\" 换成 alert + assertive（打断当前朗读）。指针停在通知上、\n或焦点落进通知内部都会把倒计时按住，离开才接着走剩下的那一段。\n\n退场窗口走完只把 root 收起、不删节点：作者写在里面的内容归作者，\n什么时候把这条从队列里删掉是 `<xh-toaster>` 的事（它收本元素冒泡上去的 status-change）。",
+          "description": "`<xh-toast>` —— Light-DOM 行为宿主：作者写 root/title/action-trigger/close-trigger\n角色节点，元素跑 toast 机器并把 connect 产出打上去。\n\nroot 承载 role 与 aria-live：默认 status + polite（排队等读屏的空隙），\ntype=\"error\" 换成 alert + assertive（打断当前朗读）。指针停在条子上、\n或焦点落进条子内部都会把倒计时按住，离开才接着走剩下的那一段。\n\n退场窗口走完只把 root 收起、不删节点：作者写在里面的内容归作者，\n什么时候把这条从队列里删掉是全局服务的事（它收本元素冒泡上去的 status-change）。",
           "name": "XhToastElement",
           "cssParts": [
             {
@@ -38997,10 +40544,6 @@
               "description": "标题，aria-labelledby 的目标",
               "name": "title"
             },
-            {
-              "description": "补充说明，aria-describedby 的目标",
-              "name": "description"
-            },
             {
               "description": "操作按钮：先发 action 再进入退场",
               "name": "action-trigger"
@@ -39038,15 +40581,6 @@
               },
               "attribute": "title"
             },
-            {
-              "kind": "field",
-              "name": "description",
-              "privacy": "public",
-              "type": {
-                "text": "string | undefined"
-              },
-              "attribute": "description"
-            },
             {
               "kind": "field",
               "name": "type",
@@ -39194,7 +40728,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "队列身份，`<xh-toaster>` 按它寻址；不给就用实例自己的 scope id",
+              "description": "队列身份，全局服务按它寻址；不给就用实例自己的 scope id",
               "name": "id",
               "fieldName": "toastId"
             },
@@ -39206,14 +40740,6 @@
               "name": "title",
               "fieldName": "titleText"
             },
-            {
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "补充说明；作者没在 description 部件里写内容时由元素填入",
-              "name": "description",
-              "fieldName": "description"
-            },
             {
               "type": {
                 "text": "ToastType | undefined"
@@ -39262,12 +40788,6 @@
           "tagName": "xh-toast",
           "customElement": true,
           "cssProperties": [
-            {
-              "name": "--xh-toast-accent"
-            },
-            {
-              "name": "--xh-toast-accent-width"
-            },
             {
               "name": "--xh-toast-action-bg"
             },
@@ -39319,12 +40839,6 @@
             {
               "name": "--xh-toast-close-size"
             },
-            {
-              "name": "--xh-toast-description-fg"
-            },
-            {
-              "name": "--xh-toast-description-font-size"
-            },
             {
               "name": "--xh-toast-fg"
             },
@@ -39337,6 +40851,12 @@
             {
               "name": "--xh-toast-icon-size"
             },
+            {
+              "name": "--xh-toast-inset"
+            },
+            {
+              "name": "--xh-toast-layer"
+            },
             {
               "name": "--xh-toast-leading"
             },
@@ -39381,362 +40901,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/elements/toaster.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "`<xh-toaster>` —— Light-DOM 行为宿主：作者写 root 与若干 group 角色节点，\n元素跑 toaster 机器并把 connect 产出打上去。每个 group 用 `placement` 属性声明自己是哪个位置，\n不写就落在 toaster 的 placement 上。\n\n单条通知的节点由作者按队列渲染（读 `visibleToasts` 或听 `toasts-change`），元素不替作者生成：\n生成节点就等于收走模板控制权，图标、进度条、i18n 文案都再塞不进来。\n每条渲染成一个 `<xh-toast>`，它走完退场会冒泡一条 status-change，本元素据此把记录删掉。",
-          "name": "XhToasterElement",
-          "cssParts": [
-            {
-              "description": "role=region 的地标容器，承载 data-count / data-empty",
-              "name": "root"
-            },
-            {
-              "description": "某一个位置上的那一摞，可自带 placement 属性；承载 data-placement / data-count / data-empty 与间距",
-              "name": "group"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "partContract",
-              "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{ anatomy: toasterAnatomy, meta: toasterMeta }"
-            },
-            {
-              "kind": "field",
-              "name": "toasts",
-              "privacy": "public",
-              "type": {
-                "text": "ToastRecord[] | undefined"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "defaultToasts",
-              "privacy": "public",
-              "type": {
-                "text": "ToastRecord[] | undefined"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "placement",
-              "privacy": "public",
-              "type": {
-                "text": "ToastPlacement | undefined"
-              },
-              "attribute": "placement"
-            },
-            {
-              "kind": "field",
-              "name": "max",
-              "privacy": "public",
-              "type": {
-                "text": "number | undefined"
-              },
-              "attribute": "max"
-            },
-            {
-              "kind": "field",
-              "name": "gap",
-              "privacy": "public",
-              "type": {
-                "text": "number | undefined"
-              },
-              "attribute": "gap"
-            },
-            {
-              "kind": "field",
-              "name": "duration",
-              "privacy": "public",
-              "type": {
-                "text": "number | undefined"
-              },
-              "attribute": "duration"
-            },
-            {
-              "kind": "field",
-              "name": "removeDelay",
-              "privacy": "public",
-              "type": {
-                "text": "number | undefined"
-              },
-              "attribute": "remove-delay"
-            },
-            {
-              "kind": "field",
-              "name": "pauseOnPageIdle",
-              "privacy": "public",
-              "type": {
-                "text": "boolean | undefined"
-              },
-              "attribute": "pause-on-page-idle"
-            },
-            {
-              "kind": "field",
-              "name": "translations",
-              "privacy": "public",
-              "type": {
-                "text": "Partial<ToasterTranslations> | undefined"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "notify",
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "ctrl",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new MachineController<ToasterSchema>(this, toasterMachine, () => this.machineProps())"
-            },
-            {
-              "kind": "method",
-              "name": "machineProps",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Partial<ToasterSchema['props']>"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "commands",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "ToasterApi"
-                }
-              },
-              "description": "命令式入口共用的取法。机器要到进文档（hostConnected）才建：\n还没进文档就发通知是调用方的时序问题，明说好过把这条通知静默丢掉。"
-            },
-            {
-              "kind": "method",
-              "name": "create",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "options",
-                  "default": "{}",
-                  "type": {
-                    "text": "ToastOptions"
-                  }
-                }
-              ],
-              "description": "入队并返回 id；同 id 已存在则就地改写，位置不动（loading 转 success 走的就是这条）。"
-            },
-            {
-              "kind": "method",
-              "name": "updateToast",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "options",
-                  "type": {
-                    "text": "Partial<ToastOptions>"
-                  }
-                }
-              ],
-              "description": "刻意不叫 `update`：那是 Lit 自己的渲染生命周期钩子，占用它会让宿主每次重渲\n都拐进这里来（还带着一个 changedProperties 当 id），组件当场不工作。\nVue 侧没有这层基类，composable 上仍叫 `update`。"
-            },
-            {
-              "kind": "method",
-              "name": "dismiss",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "dismissAll",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "visibleToasts",
-              "type": {
-                "text": "ResolvedToast[]"
-              },
-              "description": "max 之内、按加入先后排列的可见条目，已补齐默认值，可直接摊给 `<xh-toast>`。",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "placements",
-              "type": {
-                "text": "ToastPlacement[]"
-              },
-              "description": "当前有条目的位置，按九宫格固定顺序。",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "count",
-              "type": {
-                "text": "number"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "getToastsByPlacement",
-              "return": {
-                "type": {
-                  "text": "ResolvedToast[]"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "placement",
-                  "type": {
-                    "text": "ToastPlacement"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "onToastStatus",
-              "privacy": "private",
-              "readonly": true,
-              "description": "单条通知走完退场会冒泡上来：记录该从队列里删掉了。\n认元素名而不是只认事件名——avatar 之类的部件也派 status-change，且完全可能就摆在通知内部。"
-            },
-            {
-              "kind": "method",
-              "name": "wire",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            }
-          ],
-          "events": [
-            {
-              "description": "队列变化；detail 为 `{ toasts: ToastRecord[] }`",
-              "name": "toasts-change",
-              "type": {
-                "text": "ToasterToastsChangeDetails"
-              }
-            }
-          ],
-          "attributes": [
-            {
-              "type": {
-                "text": "ToastPlacement | undefined"
-              },
-              "description": "默认落位，默认 bottom-end",
-              "name": "placement",
-              "fieldName": "placement"
-            },
-            {
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "每个位置最多同时留几条，超出挤掉最旧的；不给即不限",
-              "name": "max",
-              "fieldName": "max"
-            },
-            {
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "同一摞内的间距（px），默认 16",
-              "name": "gap",
-              "fieldName": "gap"
-            },
-            {
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "单条没写 duration 时的默认停留毫秒",
-              "name": "duration",
-              "fieldName": "duration"
-            },
-            {
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "单条没写 remove-delay 时的默认退场窗口毫秒",
-              "name": "remove-delay",
-              "fieldName": "removeDelay"
-            },
-            {
-              "type": {
-                "text": "boolean | undefined"
-              },
-              "description": "页面切到后台时按住计时，逐条下发",
-              "name": "pause-on-page-idle",
-              "fieldName": "pauseOnPageIdle"
-            }
-          ],
-          "superclass": {
-            "name": "XhElement",
-            "module": "/src/element-base"
-          },
-          "tagName": "xh-toaster",
-          "customElement": true,
-          "cssProperties": [
-            {
-              "name": "--xh-toaster-inset"
-            },
-            {
-              "name": "--xh-toaster-layer"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "XhToasterElement",
-          "declaration": {
-            "name": "XhToasterElement",
-            "module": "src/elements/toaster.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/elements/toggle-group.ts",
@@ -39818,6 +40982,15 @@
               },
               "attribute": "disallow-empty"
             },
+            {
+              "kind": "field",
+              "name": "size",
+              "privacy": "public",
+              "type": {
+                "text": "Size | undefined"
+              },
+              "attribute": "size"
+            },
             {
               "kind": "field",
               "name": "orientation",
@@ -39999,6 +41172,14 @@
               "name": "disallow-empty",
               "fieldName": "disallowEmpty"
             },
+            {
+              "type": {
+                "text": "Size | undefined"
+              },
+              "description": "尺寸",
+              "name": "size",
+              "fieldName": "size"
+            },
             {
               "type": {
                 "text": "Orientation | undefined"
@@ -41490,6 +42671,9 @@
           "tagName": "xh-tour",
           "customElement": true,
           "cssProperties": [
+            {
+              "name": "--xh-tour-action-radius"
+            },
             {
               "name": "--xh-tour-arrow-size"
             },
@@ -41547,6 +42731,9 @@
             {
               "name": "--xh-tour-positioner-layer"
             },
+            {
+              "name": "--xh-tour-positioner-padding"
+            },
             {
               "name": "--xh-tour-progress-fg"
             },
@@ -41565,6 +42752,9 @@
             {
               "name": "--xh-tour-shadow"
             },
+            {
+              "name": "--xh-tour-skip-trigger-px"
+            },
             {
               "name": "--xh-tour-spotlight-layer"
             },
@@ -41995,6 +43185,9 @@
             {
               "name": "--xh-transfer-item-radius"
             },
+            {
+              "name": "--xh-transfer-list-gap"
+            },
             {
               "name": "--xh-transfer-list-h"
             },
@@ -42476,6 +43669,14 @@
               "readonly": true,
               "default": "new MachineController<TreeSelectSchema>( this, treeSelectMachine, () => this.machineProps(), { scope: this.treeSelectScope, onBuilt: svc => this.injectRefs(svc) }, )"
             },
+            {
+              "kind": "field",
+              "name": "bars",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ScrollbarsController(this, { shell: () => this.getPart('positioner'), scrollable: () => this.getPart('content'), axes: ['vertical', 'horizontal'], props: () => ({ dir: this.direction }), })",
+              "description": "树的自绘条：与 content 同级挂在已经 fixed 的 positioner 上。\n两条轴都摆——深层节点靠缩进往行末推，横向溢出与纵向一样是常态；\n横条的正负按排版方向算，而组件不读计算样式，把作者写的那份显式交过去。"
+            },
             {
               "kind": "method",
               "name": "machineProps",
@@ -42808,6 +44009,12 @@
             {
               "name": "--xh-tree-select-action-size"
             },
+            {
+              "name": "--xh-tree-select-branch-content-gap"
+            },
+            {
+              "name": "--xh-tree-select-branch-gap"
+            },
             {
               "name": "--xh-tree-select-branch-indicator-fg"
             },
@@ -42943,6 +44150,9 @@
             {
               "name": "--xh-tree-select-row-selected-font-weight"
             },
+            {
+              "name": "--xh-tree-select-tree-gap"
+            },
             {
               "name": "--xh-tree-select-trigger-fg"
             },
@@ -43085,6 +44295,24 @@
                 "text": "string[] | undefined"
               }
             },
+            {
+              "kind": "field",
+              "name": "multiple",
+              "privacy": "public",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "attribute": "multiple"
+            },
+            {
+              "kind": "field",
+              "name": "leafOrientation",
+              "privacy": "public",
+              "type": {
+                "text": "Orientation | undefined"
+              },
+              "attribute": "leaf-orientation"
+            },
             {
               "kind": "field",
               "name": "selectionMode",
@@ -43258,11 +44486,27 @@
             }
           ],
           "attributes": [
+            {
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "复选，默认关闭",
+              "name": "multiple",
+              "fieldName": "multiple"
+            },
+            {
+              "type": {
+                "text": "Orientation | undefined"
+              },
+              "description": "末端那一层怎么排，默认 vertical；horizontal 让子节点全是叶子的那层并排铺开",
+              "name": "leaf-orientation",
+              "fieldName": "leafOrientation"
+            },
             {
               "type": {
                 "text": "TreeSelectionMode | undefined"
               },
-              "description": "选择模式，默认 single",
+              "description": "选择模式的旧写法，默认 single；与 multiple 同时给时以它为准",
               "name": "selection-mode",
               "fieldName": "selectionMode"
             },
@@ -43336,6 +44580,12 @@
             {
               "name": "--xh-tree-border"
             },
+            {
+              "name": "--xh-tree-branch-content-gap"
+            },
+            {
+              "name": "--xh-tree-branch-gap"
+            },
             {
               "name": "--xh-tree-branch-indicator-fg"
             },
@@ -43390,6 +44640,9 @@
             {
               "name": "--xh-tree-label-font-weight"
             },
+            {
+              "name": "--xh-tree-leaf-row-gap"
+            },
             {
               "name": "--xh-tree-max-h"
             },
@@ -43431,6 +44684,9 @@
             },
             {
               "name": "--xh-tree-row-selected-font-weight"
+            },
+            {
+              "name": "--xh-tree-tree-gap"
             }
           ]
         }
@@ -43529,6 +44785,9 @@
             {
               "name": "--xh-typography-code-bg"
             },
+            {
+              "name": "--xh-typography-code-font"
+            },
             {
               "name": "--xh-typography-code-font-size"
             },