@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.2.0

package/dist/display/Tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tree.js","names":["_vtp_readonlyProp","_vtp_bindable","_vtp_restProps","_vue_shallowRef","_vue_ref","_vue_computed","_vtp_untrack","_createVNode","_mergeProps","mergeProps"],"sources":["../../src/display/Tree.tsx"],"sourcesContent":["/**\n * 树（WAI-ARIA Tree）：可展开的层级列表（文件夹、组织架构、分类），可单选 / 多选、勾选（父子联动、半选）、懒加载子节点。\n * 数据驱动，始终虚拟滚动（上万个节点也只渲染看得见的几十个）：\n *\n *   <Tree\n *     items={folders}\n *     getKey={(node) => node.id}\n *     getLabel={(node) => node.name}\n *     getChildren={(node) => node.children}\n *     _expanded={open}\n *     selectionMode=\"single\"\n *     _selected={current}\n *     aria-label=\"目录\"\n *   />\n *\n * - 键盘：焦点在树上，当前项经 aria-activedescendant 告诉读屏。↑↓ 移动，→ 展开 / 进入第一个子节点，← 收起 / 回到父节点，\n *   Home / End，Enter 选中（没有选择时展开或收起），空格勾选（checkable 时）或选中，按字母跳到以它开头的节点。\n * - 勾选：checkable 时每项前有勾选框，_checked={keys} 是勾上的全部节点；勾上父节点会勾上它的子孙，\n *   子节点全勾上时父节点也勾上，只勾了一部分时父节点半选（aria-checked=\"mixed\"）。\n * - 懒加载：hasChildren 说有子节点、getChildren 还没有时，展开会调用 loadChildren（加载中显示加载指示）。\n * - 节点平铺渲染（虚拟滚动没法嵌套 role=\"group\"），层级经 aria-level / aria-setsize / aria-posinset 告诉读屏。\n *\n * 展开状态与勾选联动见 utils/data/tree.ts（TreeDataTable 共用）。部件：Root（div，role=\"tree\"）、\n * Row（虚拟滚动定位的一行，包着 Item）、Item（div，role=\"treeitem\"）、Toggle（展开箭头）、\n * Checkbox（勾选框，只是外观，状态在 treeitem 的 aria-checked 上）、Label、ScrollArea（外层的滚动区域）。\n */\nimport { Check, ChevronRight, Minus } from '@lucide/icons';\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { onScopeDispose, useId, watch, type VNodeChild } from 'vue';\nimport { Icon, type IconData } from '../base/Icon';\nimport { Spinner } from '../base/Spinner';\nimport { useLang, useTextMatcher } from '../config/context';\nimport { t } from '../config/theme/tokens';\nimport { announce } from '../utils/dom/announcer';\nimport { startMove } from '../utils/dom/move';\nimport { Empty, type EmptyProps } from '../feedback/Empty';\nimport { Skeleton, type SkeletonProps, type SkeletonShapeProps } from '../feedback/Skeleton';\nimport { useDelayedLoading } from '../utils/motion/delayed-loading';\nimport { SHIMMER_STAGGER } from '../utils/style/shimmer';\nimport { checkboxStyles } from '../input/Checkbox';\nimport { choiceInputStyles, choiceRecipe } from '../input/choice-styles';\nimport { useRecipe } from '../config/styles';\nimport { toneFillStyles } from '../utils/style/tone-styles';\nimport { inlineArrows, isRtl } from '../utils/dom/direction';\nimport { toggleSelection, type SelectionModes } from '../utils/data/selection';\nimport {\n  checkStates,\n  filterTree,\n  flattenTree,\n  indexTree,\n  toggleChecked,\n  useTreeExpansion,\n  type CheckState,\n  type TreeAccessors,\n  type TreeMoveTarget,\n} from '../utils/data/tree';\nimport { createTypeahead } from '../utils/dom/typeahead';\nimport { mergeAttrs, mergePartProps, mergeProps, type PartProps } from '../utils/props';\nimport { ScrollArea, type ScrollAreaProps } from '../layout/ScrollArea';\nimport { itemStyles } from '../utils/style/item-styles';\nimport { focusRingStyles } from '../utils/style/styles';\nimport { useVirtualizer } from '../utils/virtual/use-virtualizer';\nimport { defaultRangeExtractor } from '../utils/virtual/virtualizer';\nimport { disclosureStyles } from '../utils/style/transitions';\n\n/** 节点的渲染状态 */\nexport interface TreeItemRenderState {\n  /** 层级，第一层为 0 */\n  depth: number;\n  /** 展开着 */\n  expanded: boolean;\n  /** 已选 */\n  selected: boolean;\n  /** 勾选状态（checkable 时） */\n  checked: CheckState;\n  /** 键盘所在的当前项 */\n  active: boolean;\n}\n\n/** 一次移动：把 key 移到 target（交给 moveNode） */\nexport interface TreeMove<T> {\n  /** 移动的节点的 key */\n  key: string;\n  /** 移动的节点 */\n  node: T;\n  /** 放到哪个节点下的第几位（按移走之后的同级算） */\n  target: TreeMoveTarget;\n}\n\n/** 拖动时的落点：放在 key 这一项的前面、后面或里面 */\ninterface DropSpot {\n  key: string;\n  zone: 'before' | 'after' | 'inside';\n}\n\n/** 未声明的属性落到 div（role=\"tree\"）上；aria-label 或 aria-labelledby 是树的名称 */\nexport interface TreeProps<T> extends PartProps<'div', 'role'> {\n  /** 第一层的节点 */\n  items: readonly T[];\n  /** 节点的 key，整棵树里唯一 */\n  getKey: (node: T) => string;\n  /** 节点的文字：默认显示它，类型搜索也按它 */\n  getLabel: (node: T) => string;\n  /** 子节点；叶子或还没加载时返回 undefined / 空数组 */\n  getChildren: (node: T) => readonly T[] | undefined;\n  /** 有没有子节点（懒加载时子节点还没取回来也要能展开）；不写时看 getChildren 是否非空 */\n  hasChildren?: (node: T) => boolean;\n  /** 展开一个还没有子节点的节点时调用：取回子节点并放进数据里；返回 Promise 时显示加载中 */\n  loadChildren?: (node: T) => Promise<unknown> | void;\n  /** 子节点加载失败（loadChildren 的 Promise 被拒绝）：节点收回去，再展开会重试；不写时在控制台报错 */\n  onLoadError?: (error: unknown, node: T) => void;\n  /** 节点不可用：可以经过、展开，不能选中、勾选 */\n  isDisabled?: (node: T) => boolean;\n  /** 文字前的图标，可以按展开状态换（文件夹开 / 合） */\n  getIcon?: (node: T, expanded: boolean) => IconData | undefined;\n  /** 展开的节点：父级写 _expanded={keys} */\n  _expanded?: string[];\n  /** 选择方式；不写时不能选中 */\n  selectionMode?: keyof SelectionModes;\n  /** 选中的节点：父级写 _selected={keys} */\n  _selected?: string[];\n  /** 每项前显示勾选框，默认父子联动 */\n  checkable?: boolean;\n  /** 勾选父子不联动：每个节点各自勾选（权限树里“只给这一级”） */\n  checkStrictly?: boolean;\n  /** 勾上的节点（联动时含勾上的父节点与子孙）：父级写 _checked={keys} */\n  _checked?: string[];\n  /** 正在取节点：还没有节点时显示骨架行，树带 aria-busy */\n  loading?: boolean;\n  /** 没有节点时显示的内容；默认是 Empty（文案取语言包） */\n  empty?: VNodeChild;\n  /** 每一层缩进多少（em），默认 1.25 */\n  indent?: number;\n  /** 每项的估计高度（px），默认 32；渲染后以实际高度为准 */\n  estimateSize?: number;\n  /**\n   * 搜索过滤：字符串时按节点文字匹配（忽略大小写与重音，或 createUi 的 textMatcher），函数时自己判断。\n   * 留下匹配的节点与它们的祖先并展开祖先，匹配的节点文字加粗；只看已加载的节点。清空后回到原来的展开状态\n   */\n  filter?: string | ((node: T) => boolean);\n  /**\n   * 拖动节点改变层级与顺序：放下（或 Alt + 方向键）时报告移动，用 moveNode 生成新数据交回 items；不写时不能拖。\n   * 指针拖动只用鼠标、笔（触摸时照常滚动）\n   */\n  onMove?: (move: TreeMove<T>) => void;\n  /** 能不能放到这里（如文件不能放进文件里）；不写时都能放（放进自己和自己的子孙里除外） */\n  canDrop?: (node: T, target: TreeMoveTarget) => boolean;\n  /** 自定义文字部分的内容 */\n  renderItem?: (node: T, state: TreeItemRenderState) => VNodeChild;\n  /** 每一项的部件属性，可以按节点计算 */\n  propsItem?:\n    PartProps<'div', 'role' | 'id'> | ((node: T, state: TreeItemRenderState) => PartProps<'div'>);\n  /** 每一行（虚拟滚动定位的容器，包着 treeitem）的部件属性 */\n  propsRow?: PartProps<'div', 'role'>;\n  /** 展开箭头的部件属性（只是外观，键盘与读屏走 treeitem） */\n  propsToggle?: PartProps<'span', 'aria-hidden'>;\n  /** 勾选框的部件属性（只是外观，状态在 treeitem 的 aria-checked 上） */\n  propsCheckbox?: PartProps<'span', 'aria-hidden'>;\n  /** 文字的部件属性 */\n  propsLabel?: PartProps<'span'>;\n  /** 默认空状态（Empty）的部件属性 */\n  propsEmpty?: Partial<EmptyProps>;\n  /** 加载中的骨架行的部件属性 */\n  propsSkeleton?: SkeletonShapeProps;\n  /** 外层滚动区域（ScrollArea）的部件属性：放进弹出层、弹性布局时给它 sx；树元素本身是它的视口 */\n  propsScrollArea?: Partial<Omit<ScrollAreaProps, 'propsViewport'>>;\n}\n\n/** Tree 的样式：root、sizer、row、item、toggle、checkbox、label 等 */\nexport const treeStyles = css.create({\n  // 树元素就是 ScrollArea 的视口（浮层滚动条）；焦点与 aria-activedescendant 在它上面\n  root: {\n    position: 'relative',\n    overscrollBehavior: 'contain',\n    padding: '_xs',\n    outlineStyle: 'none',\n  },\n  sizer: { position: 'relative', width: '_full' },\n  skeleton: { display: 'block', height: '1em', marginBlock: '0.625em', marginInline: '_sm' },\n  row: { position: 'absolute', top: 0, insetInline: 0, paddingBlock: '1px' },\n  item: { gap: '_xs', minHeight: '_sizes.minTarget', paddingInlineStart: '_xs' },\n  toggle: {\n    display: 'grid',\n    placeItems: 'center',\n    flexShrink: 0,\n    width: '1.5em',\n    height: '1.5em',\n    color: '_textMuted',\n  },\n  chevronOpen: { rotate: '90deg' },\n  checkbox: { marginInlineEnd: '_xs' },\n  checkMark: { width: '0.875em', height: '0.875em', color: '_accentContrast' },\n  hidden: { visibility: 'hidden' },\n  // 搜索时匹配的节点\n  matched: { fontWeight: '_semibold' },\n  // 拖动：被拖的那一项变淡；放进某一项里时它带品牌色的框；放在前后时画一条线\n  dragging: { opacity: 0.5 },\n  dropInside: {\n    outlineStyle: 'solid',\n    outlineWidth: '_borderWidths.sm',\n    outlineColor: '_accent',\n    outlineOffset: `calc(-1 * ${t.borderWidths.sm})`,\n    backgroundColor: '_accentSoft',\n  },\n  dropLine: {\n    position: 'absolute',\n    insetInlineEnd: 0,\n    height: '_borderWidths.sm',\n    backgroundColor: '_accent',\n    borderRadius: '_full',\n    pointerEvents: 'none',\n  },\n  dropBefore: { top: `calc(-1 * ${t.borderWidths.xs})` },\n  dropAfter: { bottom: `calc(-1 * ${t.borderWidths.xs})` },\n  // 画线的那一项要作定位参照\n  positioned: { position: 'relative' },\n});\n\n// 缩进与位置是任意值，用动态样式；单独一个 create，见 COMPONENTS.md §4\n/** Tree 的样式：indent（缩进）、y、height */\nexport const treeDynamicStyles = css.create({\n  indent: (em: number) => ({ width: `${em}em`, flexShrink: 0 }),\n  y: (px: number) => ({ transform: `translateY(${px}px)` }),\n  height: (px: number) => ({ height: px }),\n  width: (value: string) => ({ width: value }),\n  // 落点线从这一层的缩进处开始\n  lineStart: (em: number) => ({ insetInlineStart: `${em}em` }),\n});\n\n/** 加载中显示几行骨架 */\nconst SKELETON_ROWS = 4;\n\nconst ARIA_CHECKED: Record<CheckState, 'true' | 'false' | 'mixed'> = {\n  checked: 'true',\n  unchecked: 'false',\n  indeterminate: 'mixed',\n};\n\n/** 树：可展开的层级列表，单选 / 多选、父子联动的勾选、懒加载、方向键导航、虚拟滚动 */\nexport const Tree = _component(\n  <T,>({\n    items,\n    getKey,\n    getLabel,\n    getChildren,\n    hasChildren,\n    loadChildren,\n    onLoadError,\n    isDisabled,\n    getIcon,\n    _expanded: expanded = _bindable<string[]>([]),\n    selectionMode,\n    _selected: selected = _bindable<string[]>([]),\n    checkable = false,\n    checkStrictly = false,\n    _checked: checked = _bindable<string[]>([]),\n    loading = false,\n    empty,\n    indent = 1.25,\n    estimateSize = 32,\n    filter,\n    onMove,\n    canDrop,\n    renderItem,\n    propsItem,\n    propsRow,\n    propsToggle,\n    propsCheckbox,\n    propsLabel,\n    propsEmpty,\n    propsSkeleton,\n    propsScrollArea,\n    id,\n    ...rest\n  }: TreeProps<T>) => {\n    const lang = useLang();\n    // 骨架防闪烁：很快就取回来时不显示；aria-busy 按真实的 loading\n    const indicator = useDelayedLoading(() => loading);\n    const generatedId = useId();\n    const prefix = () => id ?? generatedId;\n    let root = _state.raw<HTMLElement | null>(null);\n    let sizer = _state.raw<HTMLElement | null>(null);\n    // 键盘所在的当前项；焦点在树上时才高亮\n    let active = _state<string | undefined>(undefined);\n    let focused = _state(false);\n    const typeahead = createTypeahead();\n    // 勾选框画成 Checkbox 的样子，跟着 styles.Choice 的定制\n    const choice = useRecipe(choiceRecipe);\n\n    const accessors = (): TreeAccessors<T> => ({\n      getKey: (node) => getKey(node),\n      getChildren,\n      hasChildren,\n    });\n\n    // 搜索过滤：匹配的节点与祖先；为 null 时不过滤\n    const textMatcher = useTextMatcher();\n    const filtering = _derived.by(() => {\n      const query = typeof filter === 'string' ? filter.trim() : filter;\n      if (!query) return null;\n      const match =\n        typeof query === 'string' ? (node: T) => textMatcher()(getLabel(node), query) : query;\n      return filterTree(items, accessors(), match);\n    });\n    // 过滤时的展开状态单独记：一开始展开匹配项的祖先，可以再收起；清空过滤后回到原来的 expanded\n    let filterExpanded = _state<string[]>([]);\n    watch(\n      () => filtering,\n      (result) => (filterExpanded = result ? [...result.expand] : []),\n      { immediate: true },\n    );\n    const shownExpanded = () => (filtering ? filterExpanded : expanded);\n\n    const expansion = useTreeExpansion<T>({\n      expanded: shownExpanded,\n      setExpanded: (keys) => (filtering ? (filterExpanded = keys) : (expanded = keys)),\n      getChildren: (node) => getChildren(node),\n      loadChildren: (node) => loadChildren?.(node),\n      // 没给 onLoadError 时交给 useTreeExpansion 在控制台报错\n      onLoadError: _untrack(onLoadError) && ((error, node) => onLoadError?.(error, node)),\n    });\n\n    const rows = _derived.by(() =>\n      flattenTree(items, accessors(), new Set(shownExpanded()), { include: filtering?.include }),\n    );\n    const rowOf = _derived.by(() => new Map(rows.map((row, index) => [row.key, index])));\n    // 勾选联动要看到折叠着的节点：只在联动勾选时建整棵树的索引\n    const index = _derived.by(() =>\n      checkable && !checkStrictly ? indexTree(items, accessors()) : null,\n    );\n    const states = _derived.by(() => (index ? checkStates(index, checked) : null));\n    const checkedSet = _derived.by(() => new Set(checked));\n    const selectedSet = _derived.by(() => new Set(selected));\n\n    /** 当前项的行号；没有时 -1 */\n    const activeRow = () => (active === undefined ? -1 : (rowOf.get(active) ?? -1));\n\n    const virtual = useVirtualizer(() => {\n      const current = rows;\n      // 读一下当前项：它变了要重新算渲染范围（当前项总要渲染，aria-activedescendant 才指得到）\n      const focusedRow = activeRow();\n      // 先读出来：每一项都要调用一次估计高度，不要每次都经过 props 的响应式读取\n      const size = estimateSize;\n      return {\n        count: current.length,\n        scrollElement: root,\n        list: sizer,\n        estimateSize: () => size,\n        getItemKey: (position: number) => current[position]!.key,\n        overscan: 6,\n        rangeExtractor: (range) => {\n          const indices = defaultRangeExtractor(range);\n          if (focusedRow >= 0 && !indices.includes(focusedRow)) {\n            indices.push(focusedRow);\n            indices.sort((a, b) => a - b);\n          }\n          return indices;\n        },\n      };\n    });\n\n    watch(\n      () => active,\n      () => {\n        const position = activeRow();\n        if (position >= 0) virtual.scrollToIndex(position, { align: 'auto' });\n      },\n      { flush: 'post' },\n    );\n\n    // 当前项所在的父节点被收起：当前项移到还看得见的最近祖先\n    watch(\n      () => rows,\n      (next, previous) => {\n        if (active === undefined || rowOf.has(active)) return;\n        let parent = previous.find((row) => row.key === active)?.parent;\n        while (parent !== undefined && !rowOf.has(parent)) {\n          parent = previous.find((row) => row.key === parent)?.parent;\n        }\n        active = parent ?? next[0]?.key;\n      },\n    );\n\n    const disabledAt = (position: number) => {\n      const row = rows[position];\n      return !row || (isDisabled?.(row.node) ?? false);\n    };\n\n    function select(position: number) {\n      const row = rows[position];\n      if (!row || !selectionMode || disabledAt(position)) return;\n      selected = [...toggleSelection(selected, row.key, { mode: selectionMode })];\n    }\n\n    function check(position: number) {\n      const row = rows[position];\n      if (!row || !checkable || disabledAt(position)) return;\n      checked = index\n        ? toggleChecked(index, checked, row.key)\n        : [...toggleSelection(checked, row.key, { mode: 'multiple' })];\n    }\n\n    function toggle(position: number) {\n      const row = rows[position];\n      if (row?.expandable)\n        void expansion.setOpen(row.node, row.key, !expansion.isExpanded(row.key));\n    }\n\n    // —— 移动节点（onMove）：指针拖动，或 Alt + 方向键 ——\n    let dragging = _state<string | undefined>(undefined);\n    let drop = _state.raw<DropSpot | null>(null);\n    let expandTimer: ReturnType<typeof setTimeout> | undefined;\n    let stopDrag: (() => void) | undefined;\n    onScopeDispose(() => {\n      clearTimeout(expandTimer);\n      stopDrag?.();\n    });\n\n    const rowByKey = (key: string | undefined) =>\n      key === undefined ? undefined : rows[rowOf.get(key) ?? -1];\n\n    /** key 是不是 ancestor 自己或它的子孙（看得见的行里，祖先总是看得见的） */\n    function isWithin(key: string, ancestor: string) {\n      for (let at: string | undefined = key; at !== undefined; at = rowByKey(at)?.parent) {\n        if (at === ancestor) return true;\n      }\n      return false;\n    }\n\n    /** 落点换算成移动的目标（按移走之后的同级算）；放不下时 null */\n    function targetOf(key: string, spot: DropSpot): TreeMoveTarget | null {\n      const moving = rowByKey(key);\n      const row = rowByKey(spot.key);\n      if (!moving || !row || isWithin(spot.key, key)) return null;\n      let target: TreeMoveTarget;\n      if (spot.zone === 'inside') target = { parent: row.key, index: Number.MAX_SAFE_INTEGER };\n      else {\n        const offset = spot.zone === 'before' ? row.position - 1 : row.position;\n        // 同一层里从前面移过来：移走之后，后面的都往前挪了一位\n        const shift = moving.parent === row.parent && moving.position <= offset ? 1 : 0;\n        target = { parent: row.parent, index: offset - shift };\n      }\n      return canDrop && !canDrop(moving.node, target) ? null : target;\n    }\n\n    /** 报告移动，并告诉读屏移到了哪里 */\n    function emitMove(key: string, target: TreeMoveTarget) {\n      const row = rowByKey(key);\n      if (!row || !onMove) return;\n      const parent = rowByKey(target.parent);\n      // 移走之后的同级个数：同一层里移动时要去掉自己\n      const count =\n        (parent ? (getChildren(parent.node)?.length ?? 0) : items.length) -\n        (row.parent === target.parent ? 1 : 0);\n      onMove({ key, node: row.node, target });\n      announce(\n        lang.treeMoved(\n          getLabel(row.node),\n          parent && getLabel(parent.node),\n          Math.min(target.index, count) + 1,\n        ),\n      );\n    }\n\n    /** 指针下的落点：一项的上四分之一放在它前面，下四分之一放在后面，中间放进它里面 */\n    function spotAt(clientX: number, clientY: number): DropSpot | null {\n      const element = document\n        .elementFromPoint(clientX, clientY)\n        ?.closest<HTMLElement>('[data-index]');\n      if (!element || !root?.contains(element)) return null;\n      const row = rows[Number(element.dataset.index)];\n      if (!row) return null;\n      const rect = element.getBoundingClientRect();\n      const ratio = (clientY - rect.top) / rect.height;\n      return { key: row.key, zone: ratio < 0.25 ? 'before' : ratio > 0.75 ? 'after' : 'inside' };\n    }\n\n    /** 拖到靠近上下边缘时滚动 */\n    function autoScroll(clientY: number) {\n      if (!root) return;\n      const rect = root.getBoundingClientRect();\n      if (clientY < rect.top + 32) root.scrollTop -= 12;\n      else if (clientY > rect.bottom - 32) root.scrollTop += 12;\n    }\n\n    /** 拖到收起的节点里停一会儿：展开它，好放到更深的地方 */\n    function scheduleExpand(spot: DropSpot | null) {\n      clearTimeout(expandTimer);\n      const row = spot?.zone === 'inside' ? rowByKey(spot.key) : undefined;\n      if (!row?.expandable || expansion.isExpanded(row.key)) return;\n      expandTimer = setTimeout(() => void expansion.setOpen(row.node, row.key, true), 600);\n    }\n\n    function onItemPointerdown(event: PointerEvent, key: string) {\n      // 焦点留在树上\n      event.preventDefault();\n      // 触摸时照常滚动，不拖\n      if (!onMove || event.pointerType === 'touch' || !root) return;\n      stopDrag = startMove(event, {\n        threshold: 4,\n        // 虚拟滚动会换掉行元素：捕获在不动的树上\n        captureTarget: root,\n        onMove: ({ clientX, clientY }) => {\n          dragging = key;\n          // 先按当前的位置算落点，再滚动：滚动后指针下面换成了别的项\n          const spot = spotAt(clientX, clientY);\n          autoScroll(clientY);\n          const next = spot && targetOf(key, spot) ? spot : null;\n          if (next?.key === drop?.key && next?.zone === drop?.zone) return;\n          drop = next;\n          scheduleExpand(next);\n        },\n        onEnd: ({ moved, cancelled }) => {\n          const spot = drop;\n          dragging = undefined;\n          drop = null;\n          stopDrag = undefined;\n          clearTimeout(expandTimer);\n          if (!moved || cancelled || !spot) return;\n          const target = targetOf(key, spot);\n          if (target) emitMove(key, target);\n        },\n      });\n    }\n\n    /** Alt + ↑↓ 在同级里移动，Alt + → 放进上一个同级的最后，Alt + ← 移到父节点后面（从右到左时左右对调） */\n    function moveByKey(event: KeyboardEvent): boolean {\n      const row = rows[activeRow()];\n      if (!row) return false;\n      const { forward, backward } = inlineArrows(!!root && isRtl(root));\n      let target: TreeMoveTarget | undefined;\n      switch (event.key) {\n        case 'ArrowUp':\n          if (row.position > 1) target = { parent: row.parent, index: row.position - 2 };\n          break;\n        case 'ArrowDown':\n          if (row.position < row.setSize) target = { parent: row.parent, index: row.position };\n          break;\n        case forward: {\n          const previous = rows.find(\n            (item) => item.parent === row.parent && item.position === row.position - 1,\n          );\n          if (!previous) break;\n          target = { parent: previous.key, index: Number.MAX_SAFE_INTEGER };\n          // 展开新的父节点：移过去之后还看得见\n          void expansion.setOpen(previous.node, previous.key, true);\n          break;\n        }\n        case backward: {\n          const parent = rowByKey(row.parent);\n          if (parent) target = { parent: parent.parent, index: parent.position };\n          break;\n        }\n        default:\n          return false;\n      }\n      if (target && (!canDrop || canDrop(row.node, target))) emitMove(row.key, target);\n      return true;\n    }\n\n    function onKeydown(event: KeyboardEvent) {\n      if (event.altKey && onMove && !event.ctrlKey && !event.metaKey) {\n        if (moveByKey(event)) event.preventDefault();\n        return;\n      }\n      if (event.altKey || event.ctrlKey || event.metaKey || rows.length === 0) return;\n      const position = Math.max(activeRow(), 0);\n      const row = rows[position]!;\n      const open = row.expandable && expansion.isExpanded(row.key);\n      const { forward, backward } = inlineArrows(!!root && isRtl(root));\n      const go = (target: number) => (active = rows[target]?.key ?? active);\n      switch (event.key) {\n        case 'ArrowDown':\n          go(Math.min(position + 1, rows.length - 1));\n          break;\n        case 'ArrowUp':\n          go(Math.max(position - 1, 0));\n          break;\n        case 'Home':\n          go(0);\n          break;\n        case 'End':\n          go(rows.length - 1);\n          break;\n        case forward:\n          if (!row.expandable) break;\n          if (!open) void expansion.setOpen(row.node, row.key, true);\n          // 已展开：进入第一个子节点（子节点还没加载出来时不动）\n          else if (rows[position + 1]?.parent === row.key) go(position + 1);\n          break;\n        case backward:\n          if (open) void expansion.setOpen(row.node, row.key, false);\n          else if (row.parent !== undefined) active = row.parent;\n          break;\n        case 'Enter':\n          if (selectionMode) select(position);\n          else toggle(position);\n          break;\n        case ' ':\n          if (checkable) check(position);\n          else select(position);\n          break;\n        default: {\n          const found = typeahead.next(\n            event.key,\n            rows.map((item) => getLabel(item.node)),\n            activeRow(),\n          );\n          if (found < 0) return;\n          go(found);\n        }\n      }\n      event.preventDefault();\n    }\n\n    function onFocus() {\n      focused = true;\n      if (active !== undefined && rowOf.has(active)) return;\n      // 第一次进入：落在第一个已选的可见节点上，没有时落在第一项\n      active = rows.find((row) => selectedSet.has(row.key))?.key ?? rows[0]?.key;\n    }\n\n    function renderRow(position: number) {\n      const row = rows[position]!;\n      const open = row.expandable && expansion.isExpanded(row.key);\n      const disabled = disabledAt(position);\n      const state: TreeItemRenderState = {\n        depth: row.depth,\n        expanded: open,\n        selected: selectedSet.has(row.key),\n        checked: states\n          ? (states.get(row.key) ?? 'unchecked')\n          : checkedSet.has(row.key)\n            ? 'checked'\n            : 'unchecked',\n        active: active === row.key,\n      };\n      const own = typeof propsItem === 'function' ? propsItem(row.node, state) : propsItem;\n      const icon = getIcon?.(row.node, open);\n      const loading = expansion.isLoading(row.key);\n      const marked = state.checked !== 'unchecked';\n      const box = choice();\n      const dropZone = drop?.key === row.key ? drop.zone : undefined;\n      return (\n        <div\n          {...mergeAttrs<'div'>(\n            {\n              sx: [\n                itemStyles.row,\n                itemStyles.hoverable,\n                treeStyles.item,\n                focused && state.active && itemStyles.highlighted,\n                state.selected && itemStyles.current,\n                disabled && itemStyles.disabled,\n                dragging === row.key && treeStyles.dragging,\n                dropZone === 'inside' && treeStyles.dropInside,\n                dropZone && dropZone !== 'inside' && treeStyles.positioned,\n              ],\n            },\n            own,\n            {\n              id: `${prefix()}-${position}`,\n              role: 'treeitem',\n              'aria-level': row.depth + 1,\n              'aria-setsize': row.setSize,\n              'aria-posinset': row.position,\n              'aria-expanded': row.expandable ? open : undefined,\n              'aria-selected': selectionMode ? state.selected : undefined,\n              'aria-checked': checkable ? ARIA_CHECKED[state.checked] : undefined,\n              'aria-disabled': disabled || undefined,\n              'aria-busy': loading || undefined,\n              onPointerdown: (event: PointerEvent) => onItemPointerdown(event, row.key),\n              onClick: () => {\n                active = row.key;\n                root?.focus({ preventScroll: true });\n                if (selectionMode) select(position);\n                else if (checkable) check(position);\n                else toggle(position);\n              },\n            },\n          )}\n          data-state={state.selected ? 'selected' : undefined}\n          data-active={state.active || undefined}\n          data-disabled={disabled || undefined}\n        >\n          {row.depth > 0 && <span {...css.attrs(treeDynamicStyles.indent(row.depth * indent))} />}\n          <span\n            {...mergeAttrs<'span'>({ sx: treeStyles.toggle }, propsToggle, {\n              'aria-hidden': true,\n              onClick: (event: MouseEvent) => {\n                if (!row.expandable) return;\n                event.stopPropagation();\n                active = row.key;\n                root?.focus({ preventScroll: true });\n                toggle(position);\n              },\n            })}\n          >\n            {loading ? (\n              <Spinner />\n            ) : (\n              row.expandable && (\n                <Icon\n                  icon={ChevronRight}\n                  flipInRtl\n                  sx={[disclosureStyles.icon, open && treeStyles.chevronOpen]}\n                />\n              )\n            )}\n          </span>\n          {checkable && (\n            <span\n              {...mergeAttrs<'span'>(\n                // 勾选框的实底色取色调变量（同 Checkbox 的 choiceParts）\n                { sx: [box.control.sx, toneFillStyles.accent, treeStyles.checkbox] },\n                propsCheckbox,\n                {\n                  'aria-hidden': true,\n                  onClick: (event: MouseEvent) => {\n                    event.stopPropagation();\n                    active = row.key;\n                    root?.focus({ preventScroll: true });\n                    check(position);\n                  },\n                },\n              )}\n            >\n              <span\n                {...css.attrs(\n                  box.input.sx,\n                  focusRingStyles.tight,\n                  checkboxStyles.box,\n                  marked && choiceInputStyles.checked,\n                )}\n              />\n              <Icon\n                icon={state.checked === 'indeterminate' ? Minus : Check}\n                strokeWidth={3}\n                sx={[box.indicator.sx, treeStyles.checkMark, !marked && treeStyles.hidden]}\n              />\n            </span>\n          )}\n          {icon && <Icon icon={icon} />}\n          <span\n            {...mergeAttrs<'span'>(\n              { sx: [itemStyles.label, filtering?.matched.has(row.key) && treeStyles.matched] },\n              propsLabel,\n            )}\n          >\n            {renderItem ? renderItem(row.node, state) : getLabel(row.node)}\n          </span>\n          {dropZone && dropZone !== 'inside' && (\n            <span\n              aria-hidden=\"true\"\n              {...css.attrs(\n                treeStyles.dropLine,\n                dropZone === 'before' ? treeStyles.dropBefore : treeStyles.dropAfter,\n                treeDynamicStyles.lineStart(row.depth * indent + 1.75),\n              )}\n            />\n          )}\n        </div>\n      );\n    }\n\n    /** 没有节点时：加载中是几行骨架，否则是空状态 */\n    function renderPlaceholder() {\n      if (loading) {\n        if (!indicator.value) return null;\n        return Array.from({ length: SKELETON_ROWS }, (_, row) => (\n          <Skeleton\n            key={row}\n            {...mergePartProps<SkeletonProps>(\n              {\n                sx: [treeStyles.skeleton, treeDynamicStyles.width(`${85 - row * 15}%`)],\n                delay: row * SHIMMER_STAGGER,\n              },\n              propsSkeleton,\n            )}\n          />\n        ));\n      }\n      return (\n        empty ?? (\n          <Empty\n            {...mergePartProps<EmptyProps>(\n              {\n                size: 'sm',\n                icon: false,\n                description: filtering ? lang.treeNoMatch : lang.treeEmpty,\n              },\n              propsEmpty,\n            )}\n          />\n        )\n      );\n    }\n\n    return () => {\n      const position = activeRow();\n      return (\n        <ScrollArea\n          {...mergePartProps<ScrollAreaProps>({}, propsScrollArea)}\n          focusable={false}\n          propsViewport={\n            mergeProps<'div'>({ sx: [treeStyles.root, focusRingStyles.visible] }, rest, {\n              ref: _toRef(root),\n              id: prefix(),\n              role: 'tree',\n              tabindex: rows.length > 0 ? 0 : -1,\n              'aria-multiselectable': selectionMode === 'multiple' || undefined,\n              'aria-activedescendant': position >= 0 ? `${prefix()}-${position}` : undefined,\n              'aria-busy': loading || undefined,\n              onFocus,\n              onBlur: () => (focused = false),\n              onKeydown,\n            }) as PartProps<'div'>\n          }\n        >\n          {rows.length === 0 && renderPlaceholder()}\n          <div\n            ref={_toRef(sizer)}\n            role=\"presentation\"\n            {...css.attrs(treeStyles.sizer, treeDynamicStyles.height(virtual.total))}\n          >\n            {virtual.items.map((item) => (\n              <div\n                key={item.key}\n                {...mergeAttrs<'div'>({ sx: treeStyles.row }, propsRow, {\n                  ref: virtual.measure,\n                  role: 'presentation',\n                  sx: treeDynamicStyles.y(item.start),\n                })}\n                data-index={item.index}\n              >\n                {renderRow(item.index)}\n              </div>\n            ))}\n          </div>\n        </ScrollArea>\n      );\n    };\n  },\n  { name: 'Tree' },\n);\n"],"mappings":"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"}

package/dist/display/VirtualList.d.ts

@@ -0,0 +1,80 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import { type VNodeChild } from 'vue';
+import { type SkeletonShapeProps } from '../feedback/Skeleton';
+import { type PartProps } from '../utils/props';
+import type { VirtualScrollOptions, VisibleRange } from '../utils/virtual/virtualizer';
+/** 跟着谁滚动 */
+export interface VirtualListScrolls {
+    /** 组件自己是滚动容器（默认）：要给它高度（横向时给宽度） */
+    container: unknown;
+    /** 随页面（window）滚动：列表按总高度撑开，放在页面的普通流里 */
+    window: unknown;
+}
+/** handle 拿到的方法 */
+export interface VirtualListHandle {
+    /** 滚动到第 index 项；align 默认 auto（已经完整可见就不动） */
+    scrollToIndex: (index: number, options?: VirtualScrollOptions) => void;
+    /** 滚动到相对列表开头的位置（px） */
+    scrollToOffset: (offset: number, options?: VirtualScrollOptions) => void;
+}
+/** 受管属性：角色与可聚焦由组件决定 */
+export type VirtualListManaged = 'role' | 'tabindex';
+/** 未声明的属性落到外层元素（滚动容器）上；aria-label 写在这里就是列表的名称 */
+export interface VirtualListProps<T> extends PartProps<'div', VirtualListManaged> {
+    /** 数据 */
+    items: readonly T[];
+    /** 渲染一项：`{(item, index) => …}` */
+    children: (item: T, index: number) => VNodeChild;
+    /** 每项的 key，默认用序号；数据会重排、增删时一定要给，测量结果与组件状态才对得上 */
+    getKey?: (item: T, index: number) => PropertyKey;
+    /** 每项的估计大小（px），数字或按项计算；渲染后以实际大小为准，默认 40 */
+    estimateSize?: number | ((item: T, index: number) => number);
+    /** 可见范围前后各多渲染几项，默认 4 */
+    overscan?: number;
+    /** 跟着谁滚动，默认 container */
+    scroll?: keyof VirtualListScrolls;
+    /** 横向排列与滚动 */
+    horizontal?: boolean;
+    /** 没有数据时显示的内容 */
+    empty?: VNodeChild;
+    /** 加载中：没有数据时显示骨架行，已有数据时顶部显示进度条 */
+    loading?: boolean;
+    /** 加载中占位行的部件属性 */
+    propsSkeleton?: SkeletonShapeProps;
+    /** 拿到滚动方法：`handle={(list) => (listHandle = list)}` */
+    handle?: (handle: VirtualListHandle) => void;
+    /** 可见范围变化（不含 overscan）：接近末尾时加载更多 */
+    onRangeChange?: (range: VisibleRange) => void;
+    /** 列表层（撑开总高度、role="list" 的项都在它里面）的部件属性 */
+    propsList?: PartProps<'div', 'role'>;
+    /**
+     * 每一项外层（role="listitem"）的部件属性；可以按项计算：`(item, index) => ({ class: … })`。
+     * 位置、序号与无障碍属性由组件管理
+     */
+    propsItem?: ItemProps | ((item: T, index: number) => ItemProps);
+}
+/** 项外层可以定制的属性 */
+type ItemProps = PartProps<'div', 'role' | 'aria-setsize' | 'aria-posinset'>;
+/** VirtualList 的样式：root、container、list、item、itemVertical、itemHorizontal 等 */
+export declare const virtualListStyles: Readonly<{
+    container: css.CompiledStyles;
+    item: css.CompiledStyles;
+    itemHorizontal: css.CompiledStyles;
+    itemVertical: css.CompiledStyles;
+    list: css.CompiledStyles;
+    progress: css.CompiledStyles;
+    root: css.CompiledStyles;
+    skeleton: css.CompiledStyles;
+    skeletonRow: css.CompiledStyles;
+}>;
+/** VirtualList 的样式：height、width、y、x、skeleton */
+export declare const virtualListSizeStyles: Readonly<{
+    readonly height: (px: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+    readonly width: (px: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+    readonly y: (px: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+    readonly x: (px: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+    readonly skeleton: (px: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+}>;
+/** 虚拟列表：只渲染可见范围内的项，行高渲染后自动测量 */
+export declare const VirtualList: <T>(props: VirtualListProps<T>) => import("@zerodep-dev/vue-tsx-pro-tsx").TsxNode;
+export {};

package/dist/display/VirtualList.js

@@ -0,0 +1,166 @@
+import { useLang } from "../config/context.js";
+import { elementProps, mergeAttrs, mergePartProps, mergeProps as mergeProps$1 } from "../utils/props.js";
+import { focusRingStyles } from "../utils/style/styles.js";
+import { useDelayedLoading } from "../utils/motion/delayed-loading.js";
+import { ScrollArea } from "../layout/ScrollArea.js";
+import "../utils/style/shimmer.js";
+import { Skeleton } from "../feedback/Skeleton.js";
+import { Progress } from "../feedback/Progress.js";
+import { useVirtualizer } from "../utils/virtual/use-virtualizer.js";
+import { Fragment, createVNode, isVNode, mergeProps, shallowRef, watch } from "vue";
+import { _component, childrenProp, readonlyProp, restProps } from "@zerodep-dev/vue-tsx-pro-tsx";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/display/VirtualList.tsx
+/** 跟着谁滚动 */
+/** handle 拿到的方法 */
+/** 受管属性：角色与可聚焦由组件决定 */
+/** 未声明的属性落到外层元素（滚动容器）上；aria-label 写在这里就是列表的名称 */
+/** 项外层可以定制的属性 */
+function _isSlot(s) {
+	return typeof s === "function" || Object.prototype.toString.call(s) === "[object Object]" && !isVNode(s);
+}
+/** 加载中显示几行骨架 */
+var SKELETON_ROWS = 5;
+/** VirtualList 的样式：root、container、list、item、itemVertical、itemHorizontal 等 */
+var virtualListStyles = css.create({
+	root: { overflowAnchor: "none" },
+	container: { overscrollBehavior: "contain" },
+	list: {
+		position: "relative",
+		overflowAnchor: "none"
+	},
+	item: {
+		position: "absolute",
+		top: 0,
+		left: 0,
+		overflowAnchor: "none"
+	},
+	itemVertical: { width: "_full" },
+	itemHorizontal: { height: "_full" },
+	progress: {
+		position: "sticky",
+		top: 0,
+		zIndex: 1,
+		height: 0
+	},
+	skeletonRow: { paddingBlock: "_xs" },
+	skeleton: {
+		display: "block",
+		width: "_full"
+	}
+});
+/** VirtualList 的样式：height、width、y、x、skeleton */
+var virtualListSizeStyles = css.create({
+	height: (px) => ({ height: px }),
+	width: (px) => ({
+		width: px,
+		height: "_full"
+	}),
+	y: (px) => ({ transform: `translateY(${px}px)` }),
+	x: (px) => ({ transform: `translateX(${px}px)` }),
+	skeleton: (px) => ({ height: Math.max(8, px - 8) })
+});
+/** 虚拟列表：只渲染可见范围内的项，行高渲染后自动测量 */
+var VirtualList = /*#__PURE__*/ _component((_props, _ctx) => {
+	const items = readonlyProp(_props, "items");
+	const children = childrenProp(_props);
+	const getKey = readonlyProp(_props, "getKey");
+	const estimateSize = readonlyProp(_props, "estimateSize", 40);
+	const overscan = readonlyProp(_props, "overscan", 4);
+	const scroll = readonlyProp(_props, "scroll", "container");
+	const horizontal = readonlyProp(_props, "horizontal", false);
+	const empty = readonlyProp(_props, "empty");
+	const loading = readonlyProp(_props, "loading", false);
+	const propsSkeleton = readonlyProp(_props, "propsSkeleton");
+	const handle = readonlyProp(_props, "handle");
+	const onRangeChange = readonlyProp(_props, "onRangeChange");
+	const propsList = readonlyProp(_props, "propsList");
+	const propsItem = readonlyProp(_props, "propsItem");
+	const rest = restProps(_props, _ctx, false);
+	const lang = useLang();
+	const indicator = useDelayedLoading(() => loading.value);
+	let root = shallowRef(null);
+	let list = shallowRef(null);
+	const virtual = useVirtualizer(() => {
+		const data = items.value;
+		const estimate = estimateSize.value;
+		const keyOf = getKey.value;
+		return {
+			count: data.length,
+			overscan: overscan.value,
+			horizontal: horizontal.value,
+			scrollElement: scroll.value === "window" ? window : root.value,
+			list: list.value,
+			estimateSize: (index) => typeof estimate === "number" ? estimate : estimate(data[index], index),
+			getItemKey: keyOf ? (index) => keyOf(data[index], index) : void 0,
+			onRangeChange: onRangeChange.value
+		};
+	});
+	const api = {
+		scrollToIndex: virtual.scrollToIndex,
+		scrollToOffset: virtual.scrollToOffset
+	};
+	watch(() => root.value, (element) => {
+		if (element) handle.value?.(api);
+	}, { flush: "post" });
+	return () => {
+		const isContainer = scroll.value === "container";
+		const hasItems = items.value.length > 0;
+		const props = mergeProps$1({ sx: [virtualListStyles.root, isContainer && [virtualListStyles.container, focusRingStyles.visible]] }, rest, {
+			ref: root,
+			role: hasItems ? "list" : "group",
+			"aria-busy": loading.value || void 0,
+			tabindex: isContainer ? 0 : void 0
+		});
+		const content = createVNode(Fragment, null, [indicator.value && hasItems && createVNode("div", mergeProps({ "aria-hidden": "true" }, css.attrs(virtualListStyles.progress)), [createVNode(Progress, {
+			"size": "xs",
+			"aria-label": lang.loading
+		}, null)]), hasItems ? createVNode("div", mergeAttrs({ sx: virtualListStyles.list }, propsList.value, {
+			sx: horizontal.value ? css.bind(virtualListSizeStyles.width, () => [virtual.total], true) : css.bind(virtualListSizeStyles.height, () => [virtual.total], true),
+			ref: list,
+			role: "presentation"
+		}), [virtual.items.map((item) => {
+			const data = items.value[item.index];
+			const own = typeof propsItem.value === "function" ? propsItem.value(data, item.index) : propsItem.value;
+			return createVNode("div", mergeProps({ "key": item.key }, mergeAttrs({ sx: [virtualListStyles.item, horizontal.value ? virtualListStyles.itemHorizontal : virtualListStyles.itemVertical] }, own, {
+				sx: horizontal.value ? css.bind(virtualListSizeStyles.x, () => [item.start]) : css.bind(virtualListSizeStyles.y, () => [item.start]),
+				ref: virtual.measure,
+				role: "listitem",
+				"aria-setsize": items.value.length,
+				"aria-posinset": item.index + 1
+			}), { "data-index": item.index }), [children.value(data, item.index)]);
+		})]) : loading.value ? indicator.value && Array.from({ length: SKELETON_ROWS }, (_, index) => createVNode("div", mergeProps({
+			"key": index,
+			"aria-hidden": "true"
+		}, css.attrs(virtualListStyles.skeletonRow)), [createVNode(Skeleton, mergePartProps({
+			sx: [virtualListStyles.skeleton, css.bind(virtualListSizeStyles.skeleton, () => [typeof estimateSize.value === "number" ? estimateSize.value : 40], true)],
+			delay: index * 120
+		}, propsSkeleton.value), null)])) : empty.value]);
+		return isContainer ? createVNode(ScrollArea, {
+			"axis": horizontal.value ? "x" : "y",
+			"focusable": false,
+			"propsViewport": props
+		}, _isSlot(content) ? content : { default: () => [content] }) : createVNode("div", elementProps(props), [content]);
+	};
+}, {
+	name: "VirtualList",
+	props: [
+		"items",
+		"getKey",
+		"estimateSize",
+		"overscan",
+		"scroll",
+		"horizontal",
+		"empty",
+		"loading",
+		"propsSkeleton",
+		"handle",
+		"onRangeChange",
+		"propsList",
+		"propsItem"
+	]
+});
+//#endregion
+export { VirtualList, virtualListSizeStyles, virtualListStyles };
+
+//# sourceMappingURL=VirtualList.js.map

package/dist/display/VirtualList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualList.js","names":["_isVNode","_vtp_readonlyProp","_vtp_childrenProp","_vtp_restProps","_vue_shallowRef","mergeProps","_createVNode","_Fragment","_mergeProps"],"sources":["../../src/display/VirtualList.tsx"],"sourcesContent":["/**\n * 虚拟列表：只渲染可见范围内的项，上万条数据也流畅。行高可以不固定，渲染后自动测量（COMPONENTS.md §10.7）。\n *\n *   <VirtualList items={users} getKey={(user) => user.id} estimateSize={48} sx={styles.list}>\n *     {(user) => <UserRow user={user} />}\n *   </VirtualList>\n *\n * 默认组件自己是滚动容器，高度由使用方给（sx、class 或 style）；scroll=\"window\" 时随页面滚动。\n * 读屏：role=\"list\"，每项带 aria-setsize / aria-posinset，未渲染的项也算在总数里；没有数据时是 role=\"group\"（空状态、骨架不是列表项）。\n * loading：没有数据时显示骨架行（按 estimateSize 的高度），已有数据（刷新、加载更多）时顶部显示进度条；带 aria-busy。\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { watch, type VNodeChild } from 'vue';\nimport { useDelayedLoading } from '../utils/motion/delayed-loading';\nimport { useLang } from '../config/context';\nimport { Progress } from '../feedback/Progress';\nimport { Skeleton, type SkeletonProps, type SkeletonShapeProps } from '../feedback/Skeleton';\nimport { SHIMMER_STAGGER } from '../utils/style/shimmer';\nimport {\n  elementProps,\n  mergeAttrs,\n  mergePartProps,\n  mergeProps,\n  type PartProps,\n} from '../utils/props';\nimport { ScrollArea } from '../layout/ScrollArea';\nimport { focusRingStyles } from '../utils/style/styles';\nimport { useVirtualizer } from '../utils/virtual/use-virtualizer';\nimport type { VirtualScrollOptions, VisibleRange } from '../utils/virtual/virtualizer';\n\n/** 跟着谁滚动 */\nexport interface VirtualListScrolls {\n  /** 组件自己是滚动容器（默认）：要给它高度（横向时给宽度） */\n  container: unknown;\n  /** 随页面（window）滚动：列表按总高度撑开，放在页面的普通流里 */\n  window: unknown;\n}\n\n/** handle 拿到的方法 */\nexport interface VirtualListHandle {\n  /** 滚动到第 index 项；align 默认 auto（已经完整可见就不动） */\n  scrollToIndex: (index: number, options?: VirtualScrollOptions) => void;\n  /** 滚动到相对列表开头的位置（px） */\n  scrollToOffset: (offset: number, options?: VirtualScrollOptions) => void;\n}\n\n/** 受管属性：角色与可聚焦由组件决定 */\nexport type VirtualListManaged = 'role' | 'tabindex';\n\n/** 未声明的属性落到外层元素（滚动容器）上；aria-label 写在这里就是列表的名称 */\nexport interface VirtualListProps<T> extends PartProps<'div', VirtualListManaged> {\n  /** 数据 */\n  items: readonly T[];\n  /** 渲染一项：`{(item, index) => …}` */\n  children: (item: T, index: number) => VNodeChild;\n  /** 每项的 key，默认用序号；数据会重排、增删时一定要给，测量结果与组件状态才对得上 */\n  getKey?: (item: T, index: number) => PropertyKey;\n  /** 每项的估计大小（px），数字或按项计算；渲染后以实际大小为准，默认 40 */\n  estimateSize?: number | ((item: T, index: number) => number);\n  /** 可见范围前后各多渲染几项，默认 4 */\n  overscan?: number;\n  /** 跟着谁滚动，默认 container */\n  scroll?: keyof VirtualListScrolls;\n  /** 横向排列与滚动 */\n  horizontal?: boolean;\n  /** 没有数据时显示的内容 */\n  empty?: VNodeChild;\n  /** 加载中：没有数据时显示骨架行，已有数据时顶部显示进度条 */\n  loading?: boolean;\n  /** 加载中占位行的部件属性 */\n  propsSkeleton?: SkeletonShapeProps;\n  /** 拿到滚动方法：`handle={(list) => (listHandle = list)}` */\n  handle?: (handle: VirtualListHandle) => void;\n  /** 可见范围变化（不含 overscan）：接近末尾时加载更多 */\n  onRangeChange?: (range: VisibleRange) => void;\n  /** 列表层（撑开总高度、role=\"list\" 的项都在它里面）的部件属性 */\n  propsList?: PartProps<'div', 'role'>;\n  /**\n   * 每一项外层（role=\"listitem\"）的部件属性；可以按项计算：`(item, index) => ({ class: … })`。\n   * 位置、序号与无障碍属性由组件管理\n   */\n  propsItem?: ItemProps | ((item: T, index: number) => ItemProps);\n}\n\n/** 项外层可以定制的属性 */\ntype ItemProps = PartProps<'div', 'role' | 'aria-setsize' | 'aria-posinset'>;\n\n/** 加载中显示几行骨架 */\nconst SKELETON_ROWS = 5;\n\n/** VirtualList 的样式：root、container、list、item、itemVertical、itemHorizontal 等 */\nexport const virtualListStyles = css.create({\n  // 自己调整滚动位置（见 virtualizer.ts），不要浏览器再按锚点调整一次\n  root: { overflowAnchor: 'none' },\n  // 容器模式：列表元素是 ScrollArea 的视口（浮层滚动条）\n  container: { overscrollBehavior: 'contain' },\n  list: { position: 'relative', overflowAnchor: 'none' },\n  item: { position: 'absolute', top: 0, left: 0, overflowAnchor: 'none' },\n  itemVertical: { width: '_full' },\n  itemHorizontal: { height: '_full' },\n  // 刷新中的进度条贴在可见区域顶部\n  progress: { position: 'sticky', top: 0, zIndex: 1, height: 0 },\n  skeletonRow: { paddingBlock: '_xs' },\n  skeleton: { display: 'block', width: '_full' },\n});\n\n// 总大小与位置是任意值，用动态样式（编译为 CSS 变量）；单独一个 create，见 COMPONENTS.md §4\n/** VirtualList 的样式：height、width、y、x、skeleton */\nexport const virtualListSizeStyles = css.create({\n  height: (px: number) => ({ height: px }),\n  width: (px: number) => ({ width: px, height: '_full' }),\n  y: (px: number) => ({ transform: `translateY(${px}px)` }),\n  x: (px: number) => ({ transform: `translateX(${px}px)` }),\n  // 骨架行比一项略矮：上下留出间隔\n  skeleton: (px: number) => ({ height: Math.max(8, px - 8) }),\n});\n\n/** 虚拟列表：只渲染可见范围内的项，行高渲染后自动测量 */\nexport const VirtualList = _component(\n  <T,>({\n    items,\n    children,\n    getKey,\n    estimateSize = 40,\n    overscan = 4,\n    scroll = 'container',\n    horizontal = false,\n    empty,\n    loading = false,\n    propsSkeleton,\n    handle,\n    onRangeChange,\n    propsList,\n    propsItem,\n    ...rest\n  }: VirtualListProps<T>) => {\n    const lang = useLang();\n    // 骨架、进度条防闪烁；aria-busy 按真实的 loading\n    const indicator = useDelayedLoading(() => loading);\n    let root = _state.raw<HTMLElement | null>(null);\n    let list = _state.raw<HTMLElement | null>(null);\n    const virtual = useVirtualizer(() => {\n      const data = items;\n      const estimate = estimateSize;\n      const keyOf = getKey;\n      return {\n        count: data.length,\n        overscan,\n        horizontal,\n        scrollElement: scroll === 'window' ? window : root,\n        list,\n        estimateSize: (index: number) =>\n          typeof estimate === 'number' ? estimate : estimate(data[index]!, index),\n        getItemKey: keyOf ? (index: number) => keyOf(data[index]!, index) : undefined,\n        onRangeChange,\n      };\n    });\n\n    // 挂载之后才交出 handle：使用方在回调里立即滚动（恢复上次的位置）也能生效。\n    // handle 不放进监听源：父级写的箭头函数每次渲染都是新的，不该因此重新交出\n    const api: VirtualListHandle = {\n      scrollToIndex: virtual.scrollToIndex,\n      scrollToOffset: virtual.scrollToOffset,\n    };\n    watch(\n      () => root,\n      (element) => {\n        if (element) handle?.(api);\n      },\n      { flush: 'post' },\n    );\n\n    return () => {\n      const isContainer = scroll === 'container';\n      const hasItems = items.length > 0;\n      const props = mergeProps<'div'>(\n        {\n          sx: [\n            virtualListStyles.root,\n            isContainer && [virtualListStyles.container, focusRingStyles.visible],\n          ],\n        },\n        rest,\n        {\n          ref: _toRef(root),\n          // 没有数据（空状态、首次加载的骨架）时不是列表；仍给 group 角色，写在外层的 aria-label 才有效\n          role: hasItems ? 'list' : 'group',\n          'aria-busy': loading || undefined,\n          // 容器模式下可以用键盘滚动\n          tabindex: isContainer ? 0 : undefined,\n        },\n      );\n      const content = (\n        <>\n          {indicator.value && hasItems && (\n            <div aria-hidden=\"true\" {...css.attrs(virtualListStyles.progress)}>\n              <Progress size=\"xs\" aria-label={lang.loading} />\n            </div>\n          )}\n          {hasItems ? (\n            <div\n              {...mergeAttrs<'div'>({ sx: virtualListStyles.list }, propsList, {\n                sx: horizontal\n                  ? virtualListSizeStyles.width(virtual.total)\n                  : virtualListSizeStyles.height(virtual.total),\n                ref: _toRef(list),\n                role: 'presentation',\n              })}\n            >\n              {virtual.items.map((item) => {\n                const data = items[item.index]!;\n                const own =\n                  typeof propsItem === 'function' ? propsItem(data, item.index) : propsItem;\n                return (\n                  <div\n                    key={item.key}\n                    {...mergeAttrs<'div'>(\n                      {\n                        sx: [\n                          virtualListStyles.item,\n                          horizontal\n                            ? virtualListStyles.itemHorizontal\n                            : virtualListStyles.itemVertical,\n                        ],\n                      },\n                      own,\n                      {\n                        sx: horizontal\n                          ? virtualListSizeStyles.x(item.start)\n                          : virtualListSizeStyles.y(item.start),\n                        ref: virtual.measure,\n                        role: 'listitem',\n                        'aria-setsize': items.length,\n                        'aria-posinset': item.index + 1,\n                      },\n                    )}\n                    data-index={item.index}\n                  >\n                    {children(data, item.index)}\n                  </div>\n                );\n              })}\n            </div>\n          ) : loading ? (\n            indicator.value &&\n            Array.from({ length: SKELETON_ROWS }, (_, index) => (\n              <div key={index} aria-hidden=\"true\" {...css.attrs(virtualListStyles.skeletonRow)}>\n                <Skeleton\n                  {...mergePartProps<SkeletonProps>(\n                    {\n                      sx: [\n                        virtualListStyles.skeleton,\n                        virtualListSizeStyles.skeleton(\n                          typeof estimateSize === 'number' ? estimateSize : 40,\n                        ),\n                      ],\n                      delay: index * SHIMMER_STAGGER,\n                    },\n                    propsSkeleton,\n                  )}\n                />\n              </div>\n            ))\n          ) : (\n            empty\n          )}\n        </>\n      );\n      // 容器模式：列表元素就是 ScrollArea 的视口，滚动条是浮层的；跟着页面滚动时就是普通的 div\n      return isContainer ? (\n        <ScrollArea\n          axis={horizontal ? 'x' : 'y'}\n          focusable={false}\n          propsViewport={props as PartProps<'div'>}\n        >\n          {content}\n        </ScrollArea>\n      ) : (\n        <div {...elementProps(props)}>{content}</div>\n      );\n    };\n  },\n);\n"],"mappings":"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"}

package/dist/display/Watermark.d.ts

@@ -0,0 +1,39 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import { type VNodeChild } from 'vue';
+import { type PartProps } from '../utils/props';
+/** 未声明的属性落到外层 div 上 */
+export interface WatermarkProps extends PartProps<'div'> {
+    /** 文字：一行写字符串，多行写数组（姓名、日期） */
+    content?: string | readonly string[];
+    /** 图片地址：给了就画图片（同源或允许跨域的图片），不画文字 */
+    image?: string;
+    /** 图片的宽（px），默认 120 */
+    width?: number;
+    /** 图片的高（px），默认 40 */
+    height?: number;
+    /** 旋转角度（度），默认 -22 */
+    rotate?: number;
+    /** 每格之间的空隙 [横, 竖]（px），默认 [120, 100] */
+    gap?: readonly [number, number];
+    /** 字号（px），默认 14 */
+    fontSize?: number;
+    /** 颜色，默认半透明的灰 */
+    color?: string;
+    /** 盖住整页（position: fixed），而不只是包着的内容 */
+    fullscreen?: boolean;
+    /** 水印那一层的部件属性 */
+    propsLayer?: PartProps<'div'>;
+    children?: VNodeChild;
+}
+/** Watermark 的样式：root、layer、fullscreen */
+export declare const watermarkStyles: Readonly<{
+    fullscreen: css.CompiledStyles;
+    layer: css.CompiledStyles;
+    root: css.CompiledStyles;
+}>;
+/** 水印那一层的背景（data URL 与一格的大小） */
+export declare const watermarkTileStyles: Readonly<{
+    readonly tile: (url: string, size: string) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+}>;
+/** 水印：一层不挡操作的平铺文字或图片 */
+export declare const Watermark: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<WatermarkProps>;

package/dist/display/Watermark.js

@@ -0,0 +1,130 @@
+import { mergeAttrs } from "../utils/props.js";
+import { createVNode, mergeProps, onMounted, ref, watch } from "vue";
+import { _component, childrenProp, readonlyProp, restProps } from "@zerodep-dev/vue-tsx-pro-tsx";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/display/Watermark.tsx
+/** 未声明的属性落到外层 div 上 */
+/** Watermark 的样式：root、layer、fullscreen */
+var watermarkStyles = css.create({
+	root: { position: "relative" },
+	layer: {
+		position: "absolute",
+		inset: 0,
+		zIndex: 9,
+		pointerEvents: "none",
+		backgroundRepeat: "repeat",
+		forcedColorAdjust: "auto"
+	},
+	fullscreen: {
+		position: "fixed",
+		zIndex: 1e3
+	}
+});
+/** 水印那一层的背景（data URL 与一格的大小） */
+var watermarkTileStyles = css.create({ tile: (url, size) => ({
+	backgroundImage: url,
+	backgroundSize: size
+}) });
+var DEFAULT_COLOR = "rgba(128, 128, 128, 0.16)";
+/** 水印：一层不挡操作的平铺文字或图片 */
+var Watermark = /*#__PURE__*/ _component((_props, _ctx) => {
+	const content = readonlyProp(_props, "content");
+	const image = readonlyProp(_props, "image");
+	const width = readonlyProp(_props, "width", 120);
+	const height = readonlyProp(_props, "height", 40);
+	const rotate = readonlyProp(_props, "rotate", -22);
+	const gap = readonlyProp(_props, "gap", () => [120, 100]);
+	const fontSize = readonlyProp(_props, "fontSize", 14);
+	const color = readonlyProp(_props, "color", () => DEFAULT_COLOR);
+	const fullscreen = readonlyProp(_props, "fullscreen", false);
+	const propsLayer = readonlyProp(_props, "propsLayer");
+	const children = childrenProp(_props);
+	const rest = restProps(_props, _ctx, false);
+	let tile = ref(null);
+	let drawing = 0;
+	/**
+	* 画一块平铺单元：两行两列的格子里斜对角各画一份（同 antd），平铺后相邻两行错开半格，铺得匀；
+	* 每份居中、旋转，四周留出 gap 的一半
+	*/
+	async function draw() {
+		if (typeof document === "undefined") return;
+		const current = ++drawing;
+		const ratio = window.devicePixelRatio || 1;
+		const lines = typeof content.value === "string" ? [content.value] : [...content.value ?? []];
+		const canvas = document.createElement("canvas");
+		const context = canvas.getContext("2d");
+		if (!context) return;
+		const font = `${fontSize.value}px sans-serif`;
+		context.font = font;
+		const lineHeight = fontSize.value * 1.4;
+		const [contentWidth, contentHeight] = image.value ? [width.value, height.value] : [Math.max(1, ...lines.map((line) => context.measureText(line).width)), lines.length * lineHeight];
+		const cellWidth = contentWidth + gap.value[0];
+		const cellHeight = contentHeight + gap.value[1];
+		let picture;
+		if (image.value) {
+			picture = new Image();
+			picture.crossOrigin = "anonymous";
+			picture.src = image.value;
+			await picture.decode().catch(() => void 0);
+			if (current !== drawing) return;
+		}
+		canvas.width = cellWidth * 2 * ratio;
+		canvas.height = cellHeight * 2 * ratio;
+		context.scale(ratio, ratio);
+		context.font = font;
+		context.fillStyle = color.value;
+		context.textAlign = "center";
+		context.textBaseline = "middle";
+		for (const [x, y] of [[cellWidth / 2, cellHeight / 2], [cellWidth * 1.5, cellHeight * 1.5]]) {
+			context.save();
+			context.translate(x, y);
+			context.rotate(rotate.value * Math.PI / 180);
+			if (picture?.naturalWidth) context.drawImage(picture, -width.value / 2, -height.value / 2, width.value, height.value);
+			else if (!image.value) lines.forEach((line, index) => context.fillText(line, 0, (index - (lines.length - 1) / 2) * lineHeight));
+			context.restore();
+		}
+		tile.value = {
+			url: canvas.toDataURL(),
+			width: cellWidth * 2,
+			height: cellHeight * 2
+		};
+	}
+	onMounted(() => void draw());
+	watch(() => [
+		content.value,
+		image.value,
+		width.value,
+		height.value,
+		rotate.value,
+		gap.value,
+		fontSize.value,
+		color.value
+	], () => void draw(), { deep: true });
+	return () => {
+		const layer = createVNode("div", mergeProps({ "aria-hidden": "true" }, mergeAttrs({ sx: [
+			watermarkStyles.layer,
+			fullscreen.value && watermarkStyles.fullscreen,
+			tile.value && css.bind(watermarkTileStyles.tile, () => [`url(${tile.value.url})`, `${tile.value.width}px ${tile.value.height}px`], true)
+		] }, propsLayer.value), { "data-watermark": "" }), null);
+		if (fullscreen.value && children.value == null) return layer;
+		return createVNode("div", mergeAttrs({ sx: watermarkStyles.root }, rest), [children.value, layer]);
+	};
+}, {
+	name: "Watermark",
+	props: [
+		"content",
+		"image",
+		"width",
+		"height",
+		"rotate",
+		"gap",
+		"fontSize",
+		"color",
+		"fullscreen",
+		"propsLayer"
+	]
+});
+//#endregion
+export { Watermark, watermarkStyles, watermarkTileStyles };
+
+//# sourceMappingURL=Watermark.js.map

package/dist/display/Watermark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watermark.js","names":["_vtp_readonlyProp","_vtp_childrenProp","_vtp_restProps","_vue_ref","_createVNode","_mergeProps"],"sources":["../../src/display/Watermark.tsx"],"sourcesContent":["/**\n * 水印：在内容上（或整页）铺满斜着的文字或图片，截图、拍屏时能看出来源（查看人、时间、密级）。\n *\n *   <Watermark content={['林小满', '2026-10-24']}>{report}</Watermark>\n *   <Watermark content=\"内部资料\" fullscreen />                       整页\n *   <Watermark image=\"/logo.svg\" width={120} height={40}>…</Watermark>\n *\n * 用 canvas 画一格（按设备像素比放大，高分屏不糊），作为一层盖在内容上的背景平铺：pointer-events: none，\n * 不挡点击与选择；aria-hidden，读屏不念。默认颜色是半透明的灰，亮色、暗色主题上都看得见、不抢内容。\n * 只是提示性的：前端的水印删得掉，真正的保密要靠服务端（导出时打水印、权限）。\n * 部件：Root（div：包着内容，position: relative）、Layer（div：水印那一层）。\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { onMounted, watch, type VNodeChild } from 'vue';\nimport { mergeAttrs, type PartProps } from '../utils/props';\n\n/** 未声明的属性落到外层 div 上 */\nexport interface WatermarkProps extends PartProps<'div'> {\n  /** 文字：一行写字符串，多行写数组（姓名、日期） */\n  content?: string | readonly string[];\n  /** 图片地址：给了就画图片（同源或允许跨域的图片），不画文字 */\n  image?: string;\n  /** 图片的宽（px），默认 120 */\n  width?: number;\n  /** 图片的高（px），默认 40 */\n  height?: number;\n  /** 旋转角度（度），默认 -22 */\n  rotate?: number;\n  /** 每格之间的空隙 [横, 竖]（px），默认 [120, 100] */\n  gap?: readonly [number, number];\n  /** 字号（px），默认 14 */\n  fontSize?: number;\n  /** 颜色，默认半透明的灰 */\n  color?: string;\n  /** 盖住整页（position: fixed），而不只是包着的内容 */\n  fullscreen?: boolean;\n  /** 水印那一层的部件属性 */\n  propsLayer?: PartProps<'div'>;\n  children?: VNodeChild;\n}\n\n/** Watermark 的样式：root、layer、fullscreen */\nexport const watermarkStyles = css.create({\n  root: { position: 'relative' },\n  layer: {\n    position: 'absolute',\n    inset: 0,\n    zIndex: 9,\n    pointerEvents: 'none',\n    backgroundRepeat: 'repeat',\n    // Windows 高对比下系统会去掉背景图：水印本来就是装饰，不需要\n    forcedColorAdjust: 'auto',\n  },\n  fullscreen: { position: 'fixed', zIndex: 1000 },\n});\n\n/** 水印那一层的背景（data URL 与一格的大小） */\nexport const watermarkTileStyles = css.create({\n  tile: (url: string, size: string) => ({ backgroundImage: url, backgroundSize: size }),\n});\n\nconst DEFAULT_COLOR = 'rgba(128, 128, 128, 0.16)';\n\n/** 水印：一层不挡操作的平铺文字或图片 */\nexport const Watermark = _component(\n  ({\n    content,\n    image,\n    width = 120,\n    height = 40,\n    rotate = -22,\n    gap = [120, 100],\n    fontSize = 14,\n    color = DEFAULT_COLOR,\n    fullscreen = false,\n    propsLayer,\n    children,\n    ...rest\n  }: WatermarkProps) => {\n    // 一格的图（data URL）与它在页面上的大小（CSS px）\n    let tile = _state<{ url: string; width: number; height: number } | null>(null);\n\n    let drawing = 0;\n\n    /**\n     * 画一块平铺单元：两行两列的格子里斜对角各画一份（同 antd），平铺后相邻两行错开半格，铺得匀；\n     * 每份居中、旋转，四周留出 gap 的一半\n     */\n    async function draw() {\n      if (typeof document === 'undefined') return;\n      const current = ++drawing;\n      const ratio = window.devicePixelRatio || 1;\n      const lines = typeof content === 'string' ? [content] : [...(content ?? [])];\n      const canvas = document.createElement('canvas');\n      const context = canvas.getContext('2d');\n      if (!context) return;\n      const font = `${fontSize}px sans-serif`;\n      context.font = font;\n      const lineHeight = fontSize * 1.4;\n      const [contentWidth, contentHeight] = image\n        ? [width, height]\n        : [\n            Math.max(1, ...lines.map((line) => context.measureText(line).width)),\n            lines.length * lineHeight,\n          ];\n      const cellWidth = contentWidth + gap[0];\n      const cellHeight = contentHeight + gap[1];\n      let picture: HTMLImageElement | undefined;\n      if (image) {\n        picture = new Image();\n        picture.crossOrigin = 'anonymous';\n        picture.src = image;\n        await picture.decode().catch(() => undefined);\n        // 等图片时参数又变了：交给后一次\n        if (current !== drawing) return;\n      }\n      canvas.width = cellWidth * 2 * ratio;\n      canvas.height = cellHeight * 2 * ratio;\n      context.scale(ratio, ratio);\n      // canvas 的尺寸改过之后要重新设字体\n      context.font = font;\n      context.fillStyle = color;\n      context.textAlign = 'center';\n      context.textBaseline = 'middle';\n      for (const [x, y] of [\n        [cellWidth / 2, cellHeight / 2],\n        [cellWidth * 1.5, cellHeight * 1.5],\n      ] as const) {\n        context.save();\n        context.translate(x, y);\n        context.rotate((rotate * Math.PI) / 180);\n        if (picture?.naturalWidth)\n          context.drawImage(picture, -width / 2, -height / 2, width, height);\n        else if (!image)\n          lines.forEach((line, index) =>\n            context.fillText(line, 0, (index - (lines.length - 1) / 2) * lineHeight),\n          );\n        context.restore();\n      }\n      tile = { url: canvas.toDataURL(), width: cellWidth * 2, height: cellHeight * 2 };\n    }\n\n    onMounted(() => void draw());\n    watch(\n      () => [content, image, width, height, rotate, gap, fontSize, color],\n      () => void draw(),\n      {\n        deep: true,\n      },\n    );\n\n    return () => {\n      const layer = (\n        <div\n          aria-hidden=\"true\"\n          {...mergeAttrs<'div'>(\n            {\n              sx: [\n                watermarkStyles.layer,\n                fullscreen && watermarkStyles.fullscreen,\n                tile &&\n                  watermarkTileStyles.tile(`url(${tile.url})`, `${tile.width}px ${tile.height}px`),\n              ],\n            },\n            propsLayer,\n          )}\n          data-watermark=\"\"\n        />\n      );\n      // 整页且没有包着内容：只渲染那一层\n      if (fullscreen && children == null) return layer;\n      return (\n        <div {...mergeAttrs<'div'>({ sx: watermarkStyles.root }, rest)}>\n          {children}\n          {layer}\n        </div>\n      );\n    };\n  },\n);\n"],"mappings":"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"}

package/dist/docs-kit/CodeGroup.d.ts

@@ -0,0 +1,29 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import { type CodeBlockProps } from '../base/CodeBlock';
+import { type TabListProps } from '../navigation/Tabs';
+import { type PartProps } from '../utils/props';
+/** 一组代码里的一段 */
+export interface CodeGroupItem extends Omit<CodeBlockProps, 'title'> {
+    /** 标签上的文字；也是这一段的值（没给 value 时） */
+    label: string;
+    /** 这一段的值，默认等于 label */
+    value?: string;
+}
+/** 未声明的属性落到外层的 div 上 */
+export interface CodeGroupProps extends PartProps<'div'> {
+    /** 各段代码 */
+    items: readonly CodeGroupItem[];
+    /** 选中的那一段的值：父级可以写 _value={x}；默认第一段 */
+    _value?: string;
+    /** 标签栏的部件属性；名称（aria-label）默认是各段标签连起来 */
+    propsList?: Partial<TabListProps>;
+}
+/** CodeGroup 的样式：外框与标签栏；代码块去掉自己的外框 */
+export declare const codeGroupStyles: Readonly<{
+    block: css.CompiledStyles;
+    list: css.CompiledStyles;
+    panel: css.CompiledStyles;
+    root: css.CompiledStyles;
+}>;
+/** 一组代码，标签页切换 */
+export declare const CodeGroup: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<CodeGroupProps>;