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

package/dist/display/Card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Card.js","names":["_vtp_readonlyProp","_vtp_childrenProp","_vtp_restProps","_vue_shallowRef","_vtp_untrack","_createVNode"],"sources":["../../src/display/Card.tsx"],"sourcesContent":["/**\n * 卡片（div）：把一组相关内容放在一块表面上。可选的页头、页脚与正文之间有分隔线。\n *\n *   <Card header={<H3 size=\"md\">订单 #1024</H3>} footer={<Button>查看</Button>}>…</Card>\n *   <Card header=\"超时最久的项目\" extra={<Link href=\"/overdue\">全部</Link>}>…</Card>   页头右边的操作\n *   <Card loading={loading} header={…}>…</Card>      正文加载中：换成几行扫光的骨架，卡片带 aria-busy\n *   <Card effect=\"spotlight\">…</Card>                  装饰效果：tilt 倾斜、spotlight 聚光、beam 流光边框\n *\n * 需要语义容器（article、section）时在外面包，或把语义标签放进 header 里的标题。\n * effect 是纯 CSS 的装饰（官网、活动页的卡片）：光层对读屏隐藏、不接收指针；减少动态效果时不倾斜、流光不动。\n * 光要画在卡片的边框上，而卡片裁掉了边框以内之外的内容，所以有 effect 时外面多一层定位用的 div，\n * 未声明的属性落在这一层上。\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport type { VNodeChild } from 'vue';\nimport { useDefaults } from '../config/defaults';\nimport { useRecipe, type PartLayer } from '../config/styles';\nimport { t } from '../config/theme/tokens';\nimport { SkeletonText, type SkeletonTextProps } from '../feedback/SkeletonText';\nimport { useReducedMotion } from '../utils/dom/media-query';\nimport { useDelayedLoading } from '../utils/motion/delayed-loading';\nimport { usePointer } from '../utils/motion/pointer';\nimport { hasContent, mergeAttrs, mergePartProps, type PartProps } from '../utils/props';\nimport { shimmerStyles } from '../utils/style/shimmer';\nimport { radiusStyles, type Radius, type Space } from '../utils/style/styles';\n\n/** 卡片样式 */\nexport interface CardVariants {\n  /** 表面色加细边框（默认） */\n  surface: unknown;\n  /** 只有边框，底色透明 */\n  outline: unknown;\n  /** 表面色加阴影，浮在页面上 */\n  elevated: unknown;\n  /** 没有底色与边框，只保留内边距与分区 */\n  ghost: unknown;\n}\n\n/** 卡片的装饰效果 */\nexport interface CardEffects {\n  /** 指针在上面移动时整块向指针方向倾斜，带一层跟随指针的高光；离开后弹回平放 */\n  tilt: unknown;\n  /** 一团柔和的光跟着指针，靠近边框的地方把边框也点亮；并排的几张卡片光会在它们之间传递 */\n  spotlight: unknown;\n  /** 一段渐变的光（品牌色到紫色）沿着边框循环流动 */\n  beam: unknown;\n}\n\n/** 卡片的外观选项；可以用 createUi / Provider 的 defaults.Card 统一改默认值 */\nexport interface CardOptions {\n  /** 样式，默认 surface */\n  variant?: keyof CardVariants;\n  /** 内边距档位，对应主题的 space，默认 lg */\n  padding?: Space;\n  /** 圆角，默认 lg */\n  radius?: Radius;\n}\n\n/** 忙碌由组件按 loading 管理 */\nexport type CardManaged = 'aria-busy';\n\n/** 未声明的属性落到外层 div 上 */\nexport interface CardProps extends PartProps<'div', CardManaged>, CardOptions {\n  /** 页头：标题、操作；与正文之间有分隔线 */\n  header?: VNodeChild;\n  /** 页头结束边的内容（“全部 ↗”、按钮、筛选）：和 header 排在一行，放不下时换行 */\n  extra?: VNodeChild;\n  /** 页脚：按钮等操作；与正文之间有分隔线 */\n  footer?: VNodeChild;\n  /**\n   * 正文加载中：正文换成几行扫光的骨架（页头、页脚照常显示），卡片带 aria-busy；很快完成时不闪\n   * @default false\n   */\n  loading?: boolean;\n  /** 装饰效果（见 CardEffects）；有效果时外面多一层定位用的 div，未声明的属性落在它上面 */\n  effect?: keyof CardEffects;\n  /** 效果的光层（倾斜的高光、聚光的表面光、流光）的部件属性 */\n  propsEffect?: PartProps<'span', 'aria-hidden'>;\n  /** 页头的部件属性 */\n  propsHeader?: PartProps<'div'>;\n  /** 正文的部件属性 */\n  propsBody?: PartProps<'div'>;\n  /** 页脚的部件属性 */\n  propsFooter?: PartProps<'div'>;\n  /** 加载中的骨架（SkeletonText）的部件属性，如行数 `{ lines: 5 }` */\n  propsSkeleton?: Partial<SkeletonTextProps>;\n  children?: VNodeChild;\n}\n\nconst travel = css.keyframes({\n  from: { offsetDistance: '0%' },\n  to: { offsetDistance: '100%' },\n});\n\n/**\n * 卡片的配方。部件：root（卡片本身）、header、body、footer、skeleton（加载中的骨架）；\n * 有 effect 时另有 frame（外面定位用的一层，未声明的属性落在它上面）、effect（倾斜的高光、聚光的表面光）、\n * ring（只露出边框一圈的光层：聚光的边框光、流光的轨道）、beam（流光的光带）。\n * 样式、内边距、有无 extra、装饰效果是档位\n */\nexport const cardRecipe = css.recipe({\n  name: 'Card',\n  parts: ['root', 'header', 'body', 'footer', 'skeleton', 'frame', 'effect', 'ring', 'beam'],\n  base: {\n    root: {\n      boxSizing: 'border-box',\n      display: 'flex',\n      flexDirection: 'column',\n      minWidth: 0,\n      borderWidth: '_xs',\n      borderStyle: 'solid',\n      borderColor: 'transparent',\n      color: '_text',\n      overflow: 'hidden',\n    },\n    header: {\n      borderBottomWidth: '_xs',\n      borderBottomStyle: 'solid',\n      borderBottomColor: '_borderMuted',\n    },\n    footer: {\n      display: 'flex',\n      justifyContent: 'flex-end',\n      gap: '_sm',\n      borderTopWidth: '_xs',\n      borderTopStyle: 'solid',\n      borderTopColor: '_borderMuted',\n    },\n    frame: { position: 'relative', display: 'flex', flexDirection: 'column', minWidth: 0 },\n    effect: { position: 'absolute', inset: 0, borderRadius: 'inherit', pointerEvents: 'none' },\n    ring: { position: 'absolute', inset: 0, borderRadius: 'inherit', pointerEvents: 'none' },\n    beam: {\n      position: 'absolute',\n      width: '80px',\n      aspectRatio: '1',\n      offsetAnchor: '90% 50%',\n      backgroundImage: `linear-gradient(to left, ${t.colors.chart5}, ${t.colors.accent}, transparent)`,\n      animationName: { default: travel, _reducedMotion: 'none' },\n      animationDuration: '6s',\n      animationTimingFunction: 'linear',\n      animationIterationCount: 'infinite',\n    },\n  },\n  variants: {\n    variant: {\n      surface: { root: { backgroundColor: '_surface', borderColor: '_border' } },\n      outline: { root: { borderColor: '_border' } },\n      elevated: { root: { backgroundColor: '_surfaceRaised', boxShadow: '_md' } },\n      ghost: {},\n    },\n    // 页头、正文、页脚的内边距\n    padding: {\n      none: {\n        header: { padding: '_none' },\n        body: { padding: '_none' },\n        footer: { padding: '_none' },\n      },\n      xs: { header: { padding: '_xs' }, body: { padding: '_xs' }, footer: { padding: '_xs' } },\n      sm: { header: { padding: '_sm' }, body: { padding: '_sm' }, footer: { padding: '_sm' } },\n      md: { header: { padding: '_md' }, body: { padding: '_md' }, footer: { padding: '_md' } },\n      lg: { header: { padding: '_lg' }, body: { padding: '_lg' }, footer: { padding: '_lg' } },\n      xl: { header: { padding: '_xl' }, body: { padding: '_xl' }, footer: { padding: '_xl' } },\n    },\n    // 有 extra 时：标题在起始边、extra 在结束边\n    extra: {\n      true: {\n        header: {\n          display: 'flex',\n          flexWrap: 'wrap',\n          alignItems: 'center',\n          justifyContent: 'space-between',\n          gap: '_sm',\n        },\n      },\n    },\n    // 有效果时卡片撑满外层\n    effect: {\n      tilt: {\n        frame: { transformStyle: 'preserve-3d', willChange: 'transform' },\n        root: { flexGrow: 1 },\n        effect: { mixBlendMode: 'soft-light' },\n      },\n      // 只留边框那一圈：内容盒与整个盒子的遮罩相减\n      spotlight: {\n        root: { flexGrow: 1 },\n        ring: {\n          padding: '_borderWidths.md',\n          maskImage: 'linear-gradient(#000 0 0), linear-gradient(#000 0 0)',\n          maskClip: 'content-box, border-box',\n          maskComposite: 'exclude',\n        },\n      },\n      // 流光：光带沿外层的圆角矩形走（offset-path），只在边框那一圈露出来\n      beam: {\n        root: { flexGrow: 1 },\n        ring: {\n          borderWidth: '_md',\n          borderStyle: 'solid',\n          borderColor: 'transparent',\n          maskImage: 'linear-gradient(transparent, transparent), linear-gradient(#000, #000)',\n          maskClip: 'padding-box, border-box',\n          maskComposite: 'intersect',\n        },\n      },\n    },\n  },\n});\n\n/** 卡片的部件（createUi / Provider 的 styles.Card 按它定制） */\nexport type CardPart = (typeof cardRecipe.parts)[number];\n\n/** 一次渲染里各部件的默认层（useRecipe 的结果） */\ntype CardParts = Readonly<Record<CardPart, PartLayer>>;\n\n// 倾斜角度、光的位置每帧变化，用动态样式；单独一个 create，见 COMPONENTS.md §4\n/** Card 效果的样式：tiltTransform、glare（高光的位置与强度）、light（光斑）、beamPath（流光的路径） */\nexport const cardEffectDynamicStyles = css.create({\n  tiltTransform: (rotateX: number, rotateY: number, scale: number) => ({\n    transform: `perspective(60em) rotateX(${rotateX}deg) rotateY(${rotateY}deg) scale(${scale})`,\n  }),\n  glare: (x: number, y: number, opacity: number) => ({\n    opacity,\n    backgroundImage: `radial-gradient(circle at ${x}% ${y}%, color-mix(in oklab, ${t.colors.accentSoft} 40%, ${t.colors.surfaceRaised}), transparent 60%)`,\n  }),\n  light: (x: number, y: number, size: string, color: string, strength: number) => ({\n    opacity: strength,\n    backgroundImage: `radial-gradient(${size} circle at ${x}% ${y}%, ${color}, transparent 70%)`,\n  }),\n  beamPath: (radius: string) => ({ offsetPath: `rect(0 auto auto 0 round ${radius})` }),\n});\n\n/** 倾斜的最大角度（度）与悬停时的放大倍数 */\nconst TILT = 10;\nconst TILT_SCALE = 1.02;\n\n/** 卡片：表面 + 可选的页头与页脚，正文可以显示加载骨架 */\nexport const Card = _component(\n  ({\n    variant,\n    padding,\n    radius,\n    header,\n    extra,\n    footer,\n    loading = false,\n    effect,\n    propsEffect,\n    propsHeader,\n    propsBody,\n    propsFooter,\n    propsSkeleton,\n    children,\n    ...rest\n  }: CardProps) => {\n    const appearance = useDefaults('Card', () => ({ variant, padding, radius }), {\n      variant: 'surface',\n      padding: 'lg',\n      radius: 'lg',\n    });\n    const recipe = useRecipe(cardRecipe);\n    // 骨架防闪烁；aria-busy 按真实的 loading\n    const skeleton = useDelayedLoading(() => loading);\n    // 出现过骨架之后，骨架与正文互换时都淡入（样式在切换的那一刻加上，动画才会播）；一开始就有内容的卡片不播\n    let revealing = false;\n    const reducedMotion = useReducedMotion();\n    let frame = _state.raw<HTMLElement | null>(null);\n    // 阻尼后的指针位置（-1 到 1，向上为正）；离开时位置不动、strength 淡出。倾斜要慢一点、带回弹；\n    // 阻尼参数按挂上时的效果定（效果一般不中途切换），跟踪的目标随 effect 变\n    const pointer = usePointer(\n      () => (effect === 'tilt' || effect === 'spotlight' ? frame : null),\n      _untrack(effect) === 'tilt' ? { bounce: 0.3, duration: 'lg' } : { duration: 'sm' },\n    );\n\n    /** 效果的光层：倾斜是一层高光，聚光是表面与边框两层，流光是边框一圈里走的光带 */\n    function effectLayers(s: CardParts, shownRadius: Radius) {\n      const x = (pointer.x + 1) * 50;\n      const y = (1 - pointer.y) * 50;\n      const layer = (part: PartLayer, sx?: css.SxStyles, child?: VNodeChild) => (\n        <span\n          {...mergeAttrs<'span'>({ ...part, sx: [part.sx, sx] }, propsEffect, {\n            'aria-hidden': true,\n          })}\n        >\n          {child}\n        </span>\n      );\n      if (effect === 'tilt')\n        return layer(s.effect, cardEffectDynamicStyles.glare(x, y, pointer.strength));\n      if (effect === 'spotlight')\n        return [\n          layer(\n            s.effect,\n            cardEffectDynamicStyles.light(\n              x,\n              y,\n              '20em',\n              `color-mix(in oklab, ${t.colors.accent} 16%, transparent)`,\n              pointer.strength,\n            ),\n          ),\n          layer(\n            s.ring,\n            cardEffectDynamicStyles.light(\n              x,\n              y,\n              '12em',\n              `color-mix(in oklab, ${t.colors.accent} 85%, transparent)`,\n              pointer.strength,\n            ),\n          ),\n        ];\n      return layer(\n        s.ring,\n        undefined,\n        <span\n          {...mergeAttrs<'span'>({\n            ...s.beam,\n            sx: [s.beam.sx, cardEffectDynamicStyles.beamPath(t.radii[shownRadius])],\n          })}\n        />,\n      );\n    }\n\n    return () => {\n      const { variant: shownVariant, padding: shownPadding, radius: shownRadius } = appearance();\n      const s = recipe({\n        variant: shownVariant,\n        padding: shownPadding,\n        extra: extra != null,\n        effect,\n      });\n      if (skeleton.value) revealing = true;\n      const surface = { ...s.root, sx: [s.root.sx, radiusStyles[shownRadius]] };\n      const content = renderContent(s);\n      if (!effect)\n        return (\n          <div {...mergeAttrs<'div'>(surface, rest, { 'aria-busy': loading || undefined })}>\n            {content}\n          </div>\n        );\n      const tilt = effect === 'tilt' && !reducedMotion.value ? pointer.strength : 0;\n      return (\n        <div\n          {...mergeAttrs<'div'>(\n            {\n              ...s.frame,\n              sx: [\n                s.frame.sx,\n                radiusStyles[shownRadius],\n                effect === 'tilt' &&\n                  cardEffectDynamicStyles.tiltTransform(\n                    pointer.y * TILT * tilt,\n                    pointer.x * TILT * tilt,\n                    1 + (TILT_SCALE - 1) * tilt,\n                  ),\n              ],\n            },\n            rest,\n            { 'aria-busy': loading || undefined, ref: _toRef(frame) },\n          )}\n        >\n          <div {...mergeAttrs<'div'>(surface)}>{content}</div>\n          {effectLayers(s, shownRadius)}\n        </div>\n      );\n    };\n\n    /** 页头、正文（或骨架）、页脚 */\n    function renderContent(s: CardParts) {\n      return [\n        (header != null || extra != null) && (\n          <div {...mergeAttrs<'div'>(s.header, propsHeader)}>\n            {header}\n            {extra}\n          </div>\n        ),\n        <div\n          {...mergeAttrs<'div'>(\n            { ...s.body, sx: [s.body.sx, revealing && !skeleton.value && shimmerStyles.reveal] },\n            propsBody,\n          )}\n        >\n          {skeleton.value ? (\n            <SkeletonText\n              {...mergePartProps<SkeletonTextProps>(\n                { ...s.skeleton, sx: [s.skeleton.sx, shimmerStyles.reveal] },\n                propsSkeleton,\n              )}\n            />\n          ) : (\n            children\n          )}\n        </div>,\n        hasContent(footer) && <div {...mergeAttrs<'div'>(s.footer, propsFooter)}>{footer}</div>,\n      ];\n    }\n  },\n);\n"],"mappings":"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"}

package/dist/display/Checklist.d.ts

@@ -0,0 +1,93 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import { type VNodeChild } from 'vue';
+import { type PartProps } from '../utils/props';
+import { type TextSize } from '../utils/style/typography';
+/** 一项的状态 */
+export interface ChecklistStatuses {
+    /** 完成 */
+    done: unknown;
+    /** 待办（默认） */
+    todo: unknown;
+    /** 超时：过了计划日期还没完成 */
+    overdue: unknown;
+    /** 受阻：等别人、缺前提 */
+    blocked: unknown;
+    /** 不适用：这一次不用做，不算进进度 */
+    skipped: unknown;
+}
+/** 清单的一项 */
+export interface ChecklistItem {
+    /** 唯一的 key；不写时用 label（label 是文字时）或位置 */
+    key?: string;
+    /** 名称 */
+    label: VNodeChild;
+    /** 状态，默认 todo */
+    status?: keyof ChecklistStatuses;
+    /** 说明：怎么做、要什么材料、缺的由谁出具 */
+    description?: VNodeChild;
+    /** 负责人（谁处理、谁出具） */
+    owner?: VNodeChild;
+    /** 日期：完成的日期，或计划日期（超时时用危险色） */
+    date?: VNodeChild;
+    /** 证据：附件、报告的链接 */
+    evidence?: VNodeChild;
+    /** 操作：上传证据、去处理、催办（结束边） */
+    action?: VNodeChild;
+}
+/** 清单的排法 */
+export interface ChecklistLayouts {
+    /** 一项一行（默认）：状态、名称与说明、负责人 · 日期 · 证据，操作在结束边 */
+    list: unknown;
+    /** 一行排开、放不下换行：状态、名称、日期、证据 */
+    inline: unknown;
+    /** 只有一排状态图标：表格的格子里；悬停与读屏有每一项的说明 */
+    icons: unknown;
+}
+/** 未声明的属性落到外层元素上（list 是 div，inline 是 ul，icons 是 span） */
+export interface ChecklistProps extends PartProps<'div'> {
+    /** 各项 */
+    items: readonly ChecklistItem[];
+    /**
+     * 排法
+     * @default 'list'
+     */
+    layout?: keyof ChecklistLayouts;
+    /** 上面显示“已完成 2 / 3”与进度条（list 排法） */
+    summary?: boolean;
+    /** 字号档位；不写时继承 */
+    size?: TextSize;
+    /** 可以勾选：状态图标变成复选按钮，点了报告新的完成状态（不适用、受阻的不能勾） */
+    onCheckedChange?: (item: ChecklistItem, done: boolean) => void;
+    /** 每一项（li）的部件属性，可以按项计算 */
+    propsItem?: PartProps<'li'> | ((item: ChecklistItem) => PartProps<'li'>);
+}
+/** Checklist 的样式 */
+export declare const checklistStyles: Readonly<{
+    action: css.CompiledStyles;
+    body: css.CompiledStyles;
+    description: css.CompiledStyles;
+    icons: css.CompiledStyles;
+    inline: css.CompiledStyles;
+    inlineItem: css.CompiledStyles;
+    item: css.CompiledStyles;
+    label: css.CompiledStyles;
+    labelPending: css.CompiledStyles;
+    labelSkipped: css.CompiledStyles;
+    late: css.CompiledStyles;
+    list: css.CompiledStyles;
+    meta: css.CompiledStyles;
+    root: css.CompiledStyles;
+    status: css.CompiledStyles;
+    summary: css.CompiledStyles;
+    toggle: css.CompiledStyles;
+}>;
+/** 各状态的图标与颜色 */
+export declare const checklistStatusStyles: Readonly<{
+    blocked: css.CompiledStyles;
+    done: css.CompiledStyles;
+    overdue: css.CompiledStyles;
+    skipped: css.CompiledStyles;
+    todo: css.CompiledStyles;
+}>;
+/** 完成清单 */
+export declare const Checklist: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<ChecklistProps>;

package/dist/display/Checklist.js

@@ -0,0 +1,260 @@
+import { useLang } from "../config/context.js";
+import { hasContent, mergeAttrs } from "../utils/props.js";
+import { fontSizeStyles } from "../utils/style/typography.js";
+import { focusRingStyles } from "../utils/style/styles.js";
+import { Icon } from "../base/Icon.js";
+import { VisuallyHidden } from "../base/VisuallyHidden.js";
+import { Progress } from "../feedback/Progress.js";
+import { createVNode, mergeProps, useId } from "vue";
+import { _component, readonlyProp, restProps } from "@zerodep-dev/vue-tsx-pro-tsx";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+import { Ban, CircleAlert, CircleCheck, CircleDashed, CircleMinus } from "@lucide/icons";
+//#region src/display/Checklist.tsx
+/**
+* 完成清单：一组要做完的事，每项的状态（完成、待办、超时、不适用、受阻）与它的上下文——怎么做、谁负责、哪天、证据、去处理。
+* 里程碑与交付证据、结项材料、上线检查、新用户的引导任务。参考 Shopify Polaris 的 Setup guide、GitHub 的任务列表。
+*
+*   <Checklist
+*     title="结项材料"
+*     summary
+*     items={[
+*       { label: '验收报告', status: 'done', date: '10-12', evidence: <Link href={url}>验证报告.pdf</Link> },
+*       { label: '财务复核意见', status: 'overdue', owner: '财务部', date: '计划 10-20', action: <Button>催办</Button> },
+*       { label: '合同签订记录', description: '谈定价格与生效日期，采购经理签字', owner: '采购部' },
+*     ]}
+*   />
+*   <Checklist layout="inline" items={…} />                    一行排开、放不下换行（详情行、卡片的一角）
+*   <Checklist layout="icons" aria-label="里程碑" items={…} />  只有一排状态图标（表格的格子里），读屏念每一项
+*   <Checklist items={tasks} onCheckedChange={(item, done) => save(item.key, done)} />   可以勾选（上线检查、引导任务）
+*
+* summary 在上面显示“已完成 2 / 3”与进度条（不适用的不算）。没完成的名称是次要色，不适用的划掉；
+* 超时的日期用危险色。每项的状态写在给读屏的文字里。
+*
+* 部件：Root（div）、Summary（汇总行）、List（ul）、Item（li，可以按项计算）、Status（状态图标，可勾选时是按钮）、Label、Meta。
+*/
+/** 一项的状态 */
+/** 清单的一项 */
+/** 清单的排法 */
+/** 未声明的属性落到外层元素上（list 是 div，inline 是 ul，icons 是 span） */
+/** Checklist 的样式 */
+var checklistStyles = css.create({
+	root: {
+		display: "grid",
+		gap: "_sm"
+	},
+	summary: {
+		display: "grid",
+		gridTemplateColumns: "auto 1fr",
+		alignItems: "center",
+		gap: "_md",
+		fontSize: "_sm",
+		color: "_textMuted"
+	},
+	list: {
+		display: "grid",
+		margin: 0,
+		padding: 0,
+		listStyle: "none"
+	},
+	item: {
+		display: "grid",
+		gridTemplateColumns: "auto minmax(0, 1fr) auto",
+		columnGap: "_sm",
+		alignItems: "start",
+		paddingBlock: "_xs"
+	},
+	status: {
+		display: "flex",
+		alignItems: "center",
+		minHeight: "1lh",
+		fontSize: "1.125em"
+	},
+	toggle: {
+		display: "inline-flex",
+		padding: 0,
+		margin: 0,
+		borderWidth: 0,
+		backgroundColor: "transparent",
+		color: "inherit",
+		font: "inherit",
+		borderRadius: "_full",
+		cursor: {
+			default: "pointer",
+			":disabled": "default"
+		}
+	},
+	body: {
+		display: "grid",
+		gap: "2px",
+		minWidth: 0
+	},
+	label: {
+		color: "_text",
+		overflowWrap: "anywhere"
+	},
+	labelPending: { color: "_textMuted" },
+	labelSkipped: {
+		color: "_textMuted",
+		textDecorationLine: "line-through"
+	},
+	description: {
+		fontSize: "_sm",
+		color: "_textMuted"
+	},
+	meta: {
+		display: "flex",
+		flexWrap: "wrap",
+		alignItems: "center",
+		columnGap: "_sm",
+		rowGap: "2px",
+		fontSize: "_sm",
+		color: "_textMuted"
+	},
+	late: { color: "_dangerText" },
+	action: {
+		display: "flex",
+		alignItems: "center",
+		gap: "_xs"
+	},
+	inline: {
+		display: "flex",
+		flexWrap: "wrap",
+		columnGap: "_lg",
+		rowGap: "_xs",
+		margin: 0,
+		padding: 0,
+		listStyle: "none"
+	},
+	inlineItem: {
+		display: "inline-flex",
+		alignItems: "center",
+		gap: "_xs",
+		whiteSpace: "nowrap"
+	},
+	icons: {
+		display: "inline-flex",
+		alignItems: "center",
+		gap: "2px"
+	}
+});
+/** 各状态的图标与颜色 */
+var checklistStatusStyles = css.create({
+	done: { color: "_successText" },
+	todo: { color: "_textMuted" },
+	overdue: { color: "_dangerText" },
+	blocked: { color: "_warningText" },
+	skipped: { color: "_textMuted" }
+});
+var statusIcons = {
+	done: CircleCheck,
+	todo: CircleDashed,
+	overdue: CircleAlert,
+	blocked: Ban,
+	skipped: CircleMinus
+};
+var keyOf = (item, index) => item.key ?? (typeof item.label === "string" ? item.label : String(index));
+var statusOf = (item) => item.status ?? "todo";
+/** 完成清单 */
+var Checklist = /*#__PURE__*/ _component((_props, _ctx) => {
+	const items = readonlyProp(_props, "items");
+	const layout = readonlyProp(_props, "layout", "list");
+	const summary = readonlyProp(_props, "summary", false);
+	const size = readonlyProp(_props, "size");
+	const onCheckedChange = readonlyProp(_props, "onCheckedChange");
+	const propsItem = readonlyProp(_props, "propsItem");
+	const rest = restProps(_props, _ctx, true);
+	const lang = useLang();
+	const id = useId();
+	const statusIcon = (item) => {
+		const status = statusOf(item);
+		return createVNode(Icon, {
+			"icon": statusIcons[status],
+			"sx": checklistStatusStyles[status]
+		}, null);
+	};
+	/** 状态：可以勾选时是复选按钮（名称是这一项的名称），否则是图标加给读屏的状态文字 */
+	const status = (item, labelId) => {
+		const state = statusOf(item);
+		if (!onCheckedChange.value) return createVNode("span", css.attrs(checklistStyles.status), [statusIcon(item), createVNode(VisuallyHidden, null, { default: () => [lang.checklistStatus[state]] })]);
+		const done = state === "done";
+		return createVNode("span", css.attrs(checklistStyles.status), [createVNode("button", mergeProps({
+			"type": "button",
+			"role": "checkbox",
+			"aria-checked": done,
+			"aria-labelledby": labelId,
+			"aria-describedby": `${labelId}-status`,
+			"disabled": state === "skipped" || state === "blocked",
+			"onClick": () => onCheckedChange.value(item, !done)
+		}, css.attrs(checklistStyles.toggle, focusRingStyles.visible)), [statusIcon(item)]), createVNode(VisuallyHidden, { "id": `${labelId}-status` }, { default: () => [lang.checklistStatus[state]] })]);
+	};
+	const labelSx = (item) => {
+		const state = statusOf(item);
+		return [checklistStyles.label, state === "skipped" ? checklistStyles.labelSkipped : state !== "done" && checklistStyles.labelPending];
+	};
+	/** 读屏念的整组：名称与状态（icons 排法） */
+	const iconsLabel = () => lang.checklistIconsLabel(items.value.map((item) => lang.checklistItemState(typeof item.label === "string" ? item.label : "", lang.checklistStatus[statusOf(item)])));
+	const counted = () => items.value.filter((item) => statusOf(item) !== "skipped");
+	const doneCount = () => counted().filter((item) => statusOf(item) === "done").length;
+	return () => {
+		if (layout.value === "icons") {
+			const label = iconsLabel();
+			return createVNode("span", mergeAttrs({ sx: [checklistStyles.icons, size.value && fontSizeStyles[size.value]] }, rest, {
+				role: "img",
+				"aria-label": label,
+				title: label
+			}), [items.value.map((item, index) => createVNode("span", { "key": keyOf(item, index) }, [statusIcon(item)]))]);
+		}
+		if (layout.value === "inline") return createVNode("ul", mergeAttrs({ sx: [checklistStyles.inline, size.value && fontSizeStyles[size.value]] }, rest), [items.value.map((item, index) => {
+			const labelId = `${id}-${index}`;
+			return createVNode("li", mergeProps({ "key": keyOf(item, index) }, css.attrs(checklistStyles.inlineItem)), [
+				status(item, labelId),
+				createVNode("span", mergeProps({ "id": labelId }, css.attrs(labelSx(item))), [item.label]),
+				hasContent(item.date) && createVNode("span", css.attrs(checklistStyles.meta, statusOf(item) === "overdue" && checklistStyles.late), [item.date]),
+				item.evidence
+			]);
+		})]);
+		const total = counted().length;
+		return createVNode("div", mergeAttrs({ sx: [checklistStyles.root, size.value && fontSizeStyles[size.value]] }, rest), [summary.value && total > 0 && createVNode("div", css.attrs(checklistStyles.summary), [createVNode("span", null, [lang.checklistSummary(doneCount(), total)]), createVNode(Progress, {
+			"value": doneCount(),
+			"max": total,
+			"size": "xs",
+			"tone": doneCount() === total ? "success" : "accent",
+			"aria-label": lang.checklistSummary(doneCount(), total)
+		}, null)]), createVNode("ul", css.attrs(checklistStyles.list), [items.value.map((item, index) => {
+			const own = typeof propsItem.value === "function" ? propsItem.value(item) : propsItem.value;
+			const labelId = `${id}-${index}`;
+			const meta = [
+				item.owner,
+				item.date,
+				item.evidence
+			].some(hasContent);
+			return createVNode("li", mergeProps({ "key": keyOf(item, index) }, mergeAttrs({ sx: checklistStyles.item }, own), { "data-status": statusOf(item) }), [
+				status(item, labelId),
+				createVNode("div", css.attrs(checklistStyles.body), [
+					createVNode("span", mergeProps({ "id": labelId }, css.attrs(labelSx(item))), [item.label]),
+					hasContent(item.description) && createVNode("span", css.attrs(checklistStyles.description), [item.description]),
+					meta && createVNode("span", css.attrs(checklistStyles.meta), [
+						hasContent(item.owner) && createVNode("span", null, [item.owner]),
+						hasContent(item.date) && createVNode("span", css.attrs(statusOf(item) === "overdue" && checklistStyles.late), [item.date]),
+						item.evidence
+					])
+				]),
+				hasContent(item.action) ? createVNode("div", css.attrs(checklistStyles.action), [item.action]) : createVNode("span", null, null)
+			]);
+		})])]);
+	};
+}, {
+	name: "Checklist",
+	props: [
+		"items",
+		"layout",
+		"summary",
+		"size",
+		"onCheckedChange",
+		"propsItem"
+	]
+});
+//#endregion
+export { Checklist, checklistStatusStyles, checklistStyles };
+
+//# sourceMappingURL=Checklist.js.map

package/dist/display/Checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checklist.js","names":["_vtp_readonlyProp","_vtp_restProps","_createVNode","_mergeProps"],"sources":["../../src/display/Checklist.tsx"],"sourcesContent":["/**\n * 完成清单：一组要做完的事，每项的状态（完成、待办、超时、不适用、受阻）与它的上下文——怎么做、谁负责、哪天、证据、去处理。\n * 里程碑与交付证据、结项材料、上线检查、新用户的引导任务。参考 Shopify Polaris 的 Setup guide、GitHub 的任务列表。\n *\n *   <Checklist\n *     title=\"结项材料\"\n *     summary\n *     items={[\n *       { label: '验收报告', status: 'done', date: '10-12', evidence: <Link href={url}>验证报告.pdf</Link> },\n *       { label: '财务复核意见', status: 'overdue', owner: '财务部', date: '计划 10-20', action: <Button>催办</Button> },\n *       { label: '合同签订记录', description: '谈定价格与生效日期，采购经理签字', owner: '采购部' },\n *     ]}\n *   />\n *   <Checklist layout=\"inline\" items={…} />                    一行排开、放不下换行（详情行、卡片的一角）\n *   <Checklist layout=\"icons\" aria-label=\"里程碑\" items={…} />  只有一排状态图标（表格的格子里），读屏念每一项\n *   <Checklist items={tasks} onCheckedChange={(item, done) => save(item.key, done)} />   可以勾选（上线检查、引导任务）\n *\n * summary 在上面显示“已完成 2 / 3”与进度条（不适用的不算）。没完成的名称是次要色，不适用的划掉；\n * 超时的日期用危险色。每项的状态写在给读屏的文字里。\n *\n * 部件：Root（div）、Summary（汇总行）、List（ul）、Item（li，可以按项计算）、Status（状态图标，可勾选时是按钮）、Label、Meta。\n */\nimport { Ban, CircleAlert, CircleCheck, CircleDashed, CircleMinus } from '@lucide/icons';\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { useId, type VNodeChild } from 'vue';\nimport { Icon, type IconData } from '../base/Icon';\nimport { VisuallyHidden } from '../base/VisuallyHidden';\nimport { useLang } from '../config/context';\nimport { Progress } from '../feedback/Progress';\nimport { hasContent, mergeAttrs, type PartProps } from '../utils/props';\nimport { focusRingStyles } from '../utils/style/styles';\nimport { fontSizeStyles, type TextSize } from '../utils/style/typography';\n\n/** 一项的状态 */\nexport interface ChecklistStatuses {\n  /** 完成 */\n  done: unknown;\n  /** 待办（默认） */\n  todo: unknown;\n  /** 超时：过了计划日期还没完成 */\n  overdue: unknown;\n  /** 受阻：等别人、缺前提 */\n  blocked: unknown;\n  /** 不适用：这一次不用做，不算进进度 */\n  skipped: unknown;\n}\n\n/** 清单的一项 */\nexport interface ChecklistItem {\n  /** 唯一的 key；不写时用 label（label 是文字时）或位置 */\n  key?: string;\n  /** 名称 */\n  label: VNodeChild;\n  /** 状态，默认 todo */\n  status?: keyof ChecklistStatuses;\n  /** 说明：怎么做、要什么材料、缺的由谁出具 */\n  description?: VNodeChild;\n  /** 负责人（谁处理、谁出具） */\n  owner?: VNodeChild;\n  /** 日期：完成的日期，或计划日期（超时时用危险色） */\n  date?: VNodeChild;\n  /** 证据：附件、报告的链接 */\n  evidence?: VNodeChild;\n  /** 操作：上传证据、去处理、催办（结束边） */\n  action?: VNodeChild;\n}\n\n/** 清单的排法 */\nexport interface ChecklistLayouts {\n  /** 一项一行（默认）：状态、名称与说明、负责人 · 日期 · 证据，操作在结束边 */\n  list: unknown;\n  /** 一行排开、放不下换行：状态、名称、日期、证据 */\n  inline: unknown;\n  /** 只有一排状态图标：表格的格子里；悬停与读屏有每一项的说明 */\n  icons: unknown;\n}\n\n/** 未声明的属性落到外层元素上（list 是 div，inline 是 ul，icons 是 span） */\nexport interface ChecklistProps extends PartProps<'div'> {\n  /** 各项 */\n  items: readonly ChecklistItem[];\n  /**\n   * 排法\n   * @default 'list'\n   */\n  layout?: keyof ChecklistLayouts;\n  /** 上面显示“已完成 2 / 3”与进度条（list 排法） */\n  summary?: boolean;\n  /** 字号档位；不写时继承 */\n  size?: TextSize;\n  /** 可以勾选：状态图标变成复选按钮，点了报告新的完成状态（不适用、受阻的不能勾） */\n  onCheckedChange?: (item: ChecklistItem, done: boolean) => void;\n  /** 每一项（li）的部件属性，可以按项计算 */\n  propsItem?: PartProps<'li'> | ((item: ChecklistItem) => PartProps<'li'>);\n}\n\n/** Checklist 的样式 */\nexport const checklistStyles = css.create({\n  root: { display: 'grid', gap: '_sm' },\n  summary: {\n    display: 'grid',\n    gridTemplateColumns: 'auto 1fr',\n    alignItems: 'center',\n    gap: '_md',\n    fontSize: '_sm',\n    color: '_textMuted',\n  },\n  list: { display: 'grid', margin: 0, padding: 0, listStyle: 'none' },\n  // 状态一列、内容一列、操作一列；状态贴着名称那一行\n  item: {\n    display: 'grid',\n    gridTemplateColumns: 'auto minmax(0, 1fr) auto',\n    columnGap: '_sm',\n    alignItems: 'start',\n    paddingBlock: '_xs',\n  },\n  status: {\n    display: 'flex',\n    alignItems: 'center',\n    minHeight: '1lh',\n    fontSize: '1.125em',\n  },\n  // 可以勾选时的按钮：只有图标，去掉按钮的外观\n  toggle: {\n    display: 'inline-flex',\n    padding: 0,\n    margin: 0,\n    borderWidth: 0,\n    backgroundColor: 'transparent',\n    color: 'inherit',\n    font: 'inherit',\n    borderRadius: '_full',\n    cursor: { default: 'pointer', ':disabled': 'default' },\n  },\n  body: { display: 'grid', gap: '2px', minWidth: 0 },\n  label: { color: '_text', overflowWrap: 'anywhere' },\n  labelPending: { color: '_textMuted' },\n  labelSkipped: { color: '_textMuted', textDecorationLine: 'line-through' },\n  description: { fontSize: '_sm', color: '_textMuted' },\n  meta: {\n    display: 'flex',\n    flexWrap: 'wrap',\n    alignItems: 'center',\n    columnGap: '_sm',\n    rowGap: '2px',\n    fontSize: '_sm',\n    color: '_textMuted',\n  },\n  late: { color: '_dangerText' },\n  action: { display: 'flex', alignItems: 'center', gap: '_xs' },\n  inline: {\n    display: 'flex',\n    flexWrap: 'wrap',\n    columnGap: '_lg',\n    rowGap: '_xs',\n    margin: 0,\n    padding: 0,\n    listStyle: 'none',\n  },\n  inlineItem: { display: 'inline-flex', alignItems: 'center', gap: '_xs', whiteSpace: 'nowrap' },\n  icons: { display: 'inline-flex', alignItems: 'center', gap: '2px' },\n});\n\n/** 各状态的图标与颜色 */\nexport const checklistStatusStyles = css.create({\n  done: { color: '_successText' },\n  todo: { color: '_textMuted' },\n  overdue: { color: '_dangerText' },\n  blocked: { color: '_warningText' },\n  skipped: { color: '_textMuted' },\n});\n\nconst statusIcons: Record<keyof ChecklistStatuses, IconData> = {\n  done: CircleCheck,\n  todo: CircleDashed,\n  overdue: CircleAlert,\n  blocked: Ban,\n  skipped: CircleMinus,\n};\n\nconst keyOf = (item: ChecklistItem, index: number) =>\n  item.key ?? (typeof item.label === 'string' ? item.label : String(index));\n\nconst statusOf = (item: ChecklistItem): keyof ChecklistStatuses => item.status ?? 'todo';\n\n/** 完成清单 */\nexport const Checklist = _component(\n  ({\n    items,\n    layout = 'list',\n    summary = false,\n    size,\n    onCheckedChange,\n    propsItem,\n    ...rest\n  }: ChecklistProps) => {\n    const lang = useLang();\n    const id = useId();\n\n    const statusIcon = (item: ChecklistItem) => {\n      const status = statusOf(item);\n      return <Icon icon={statusIcons[status]} sx={checklistStatusStyles[status]} />;\n    };\n\n    /** 状态：可以勾选时是复选按钮（名称是这一项的名称），否则是图标加给读屏的状态文字 */\n    const status = (item: ChecklistItem, labelId: string) => {\n      const state = statusOf(item);\n      if (!onCheckedChange)\n        return (\n          <span {...css.attrs(checklistStyles.status)}>\n            {statusIcon(item)}\n            <VisuallyHidden>{lang.checklistStatus[state]}</VisuallyHidden>\n          </span>\n        );\n      const done = state === 'done';\n      return (\n        <span {...css.attrs(checklistStyles.status)}>\n          <button\n            type=\"button\"\n            role=\"checkbox\"\n            aria-checked={done}\n            aria-labelledby={labelId}\n            aria-describedby={`${labelId}-status`}\n            disabled={state === 'skipped' || state === 'blocked'}\n            onClick={() => onCheckedChange(item, !done)}\n            {...css.attrs(checklistStyles.toggle, focusRingStyles.visible)}\n          >\n            {statusIcon(item)}\n          </button>\n          <VisuallyHidden id={`${labelId}-status`}>{lang.checklistStatus[state]}</VisuallyHidden>\n        </span>\n      );\n    };\n\n    const labelSx = (item: ChecklistItem) => {\n      const state = statusOf(item);\n      return [\n        checklistStyles.label,\n        state === 'skipped'\n          ? checklistStyles.labelSkipped\n          : state !== 'done' && checklistStyles.labelPending,\n      ];\n    };\n\n    /** 读屏念的整组：名称与状态（icons 排法） */\n    const iconsLabel = () =>\n      lang.checklistIconsLabel(\n        items.map((item) =>\n          lang.checklistItemState(\n            typeof item.label === 'string' ? item.label : '',\n            lang.checklistStatus[statusOf(item)],\n          ),\n        ),\n      );\n\n    const counted = () => items.filter((item) => statusOf(item) !== 'skipped');\n    const doneCount = () => counted().filter((item) => statusOf(item) === 'done').length;\n\n    return () => {\n      if (layout === 'icons') {\n        const label = iconsLabel();\n        return (\n          <span\n            {...mergeAttrs<'span'>(\n              { sx: [checklistStyles.icons, size && fontSizeStyles[size]] },\n              rest as PartProps<'span'>,\n              { role: 'img', 'aria-label': label, title: label },\n            )}\n          >\n            {items.map((item, index) => (\n              <span key={keyOf(item, index)}>{statusIcon(item)}</span>\n            ))}\n          </span>\n        );\n      }\n\n      if (layout === 'inline')\n        return (\n          <ul\n            {...mergeAttrs<'ul'>(\n              { sx: [checklistStyles.inline, size && fontSizeStyles[size]] },\n              rest as PartProps<'ul'>,\n            )}\n          >\n            {items.map((item, index) => {\n              const labelId = `${id}-${index}`;\n              return (\n                <li key={keyOf(item, index)} {...css.attrs(checklistStyles.inlineItem)}>\n                  {status(item, labelId)}\n                  <span id={labelId} {...css.attrs(labelSx(item))}>\n                    {item.label}\n                  </span>\n                  {hasContent(item.date) && (\n                    <span\n                      {...css.attrs(\n                        checklistStyles.meta,\n                        statusOf(item) === 'overdue' && checklistStyles.late,\n                      )}\n                    >\n                      {item.date}\n                    </span>\n                  )}\n                  {item.evidence}\n                </li>\n              );\n            })}\n          </ul>\n        );\n\n      const total = counted().length;\n      return (\n        <div\n          {...mergeAttrs<'div'>({ sx: [checklistStyles.root, size && fontSizeStyles[size]] }, rest)}\n        >\n          {summary && total > 0 && (\n            <div {...css.attrs(checklistStyles.summary)}>\n              <span>{lang.checklistSummary(doneCount(), total)}</span>\n              <Progress\n                value={doneCount()}\n                max={total}\n                size=\"xs\"\n                tone={doneCount() === total ? 'success' : 'accent'}\n                aria-label={lang.checklistSummary(doneCount(), total)}\n              />\n            </div>\n          )}\n          <ul {...css.attrs(checklistStyles.list)}>\n            {items.map((item, index) => {\n              const own = typeof propsItem === 'function' ? propsItem(item) : propsItem;\n              const labelId = `${id}-${index}`;\n              const meta = [item.owner, item.date, item.evidence].some(hasContent);\n              return (\n                <li\n                  key={keyOf(item, index)}\n                  {...mergeAttrs<'li'>({ sx: checklistStyles.item }, own)}\n                  data-status={statusOf(item)}\n                >\n                  {status(item, labelId)}\n                  <div {...css.attrs(checklistStyles.body)}>\n                    <span id={labelId} {...css.attrs(labelSx(item))}>\n                      {item.label}\n                    </span>\n                    {hasContent(item.description) && (\n                      <span {...css.attrs(checklistStyles.description)}>{item.description}</span>\n                    )}\n                    {meta && (\n                      <span {...css.attrs(checklistStyles.meta)}>\n                        {hasContent(item.owner) && <span>{item.owner}</span>}\n                        {hasContent(item.date) && (\n                          <span\n                            {...css.attrs(statusOf(item) === 'overdue' && checklistStyles.late)}\n                          >\n                            {item.date}\n                          </span>\n                        )}\n                        {item.evidence}\n                      </span>\n                    )}\n                  </div>\n                  {hasContent(item.action) ? (\n                    <div {...css.attrs(checklistStyles.action)}>{item.action}</div>\n                  ) : (\n                    <span />\n                  )}\n                </li>\n              );\n            })}\n          </ul>\n        </div>\n      );\n    };\n  },\n);\n"],"mappings":"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"}

package/dist/display/Collapse.d.ts

@@ -0,0 +1,24 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import type { VNodeChild } from 'vue';
+import { type PartProps } from '../utils/props';
+/** 未声明的属性落到外层的 div 上；要分区语义时在外面包 section */
+export interface CollapseProps extends PartProps<'div', 'hidden' | 'inert'> {
+    /** 是否展开：父级写 _open={x}；页内搜索命中收起的内容时自动展开并写回 */
+    _open?: boolean;
+    children?: VNodeChild;
+    /** 内容层：外层负责高度过渡，内容层裁掉溢出 */
+    propsContent?: PartProps<'div'>;
+    /**
+     * 第一次展开时才渲染内容，之后收起也保留（内容很重、多数人不会展开时用）。
+     * 代价：还没展开过的内容页内搜索找不到
+     */
+    lazy?: boolean;
+}
+/** Collapse 的样式：root、open、content */
+export declare const collapseStyles: Readonly<{
+    content: css.CompiledStyles;
+    open: css.CompiledStyles;
+    root: css.CompiledStyles;
+}>;
+/** 展开收起的内容区（div），带高度过渡；收起后可被页内搜索找到并自动展开 */
+export declare const Collapse: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<CollapseProps>;

package/dist/display/Collapse.js

@@ -0,0 +1,65 @@
+import { t } from "../config/theme/tokens.js";
+import { mergeAttrs } from "../utils/props.js";
+import { afterTransitions } from "../utils/style/transitions.js";
+import { useLazyContent } from "../utils/motion/presence.js";
+import { createVNode, mergeProps, ref, shallowRef } from "vue";
+import { _component, bindable, childrenProp, effect, readonlyProp, restProps, untrack } from "@zerodep-dev/vue-tsx-pro-tsx";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/display/Collapse.tsx
+/** 未声明的属性落到外层的 div 上；要分区语义时在外面包 section */
+var supportsUntilFound = typeof HTMLElement !== "undefined" && "onbeforematch" in HTMLElement.prototype;
+/** Collapse 的样式：root、open、content */
+var collapseStyles = css.create({
+	root: {
+		display: "grid",
+		gridTemplateRows: "0fr",
+		transition: `grid-template-rows ${t.durations.md} ${t.easings.standard}`
+	},
+	open: { gridTemplateRows: "1fr" },
+	content: {
+		minHeight: 0,
+		overflow: "hidden"
+	}
+});
+/** 展开收起的内容区（div），带高度过渡；收起后可被页内搜索找到并自动展开 */
+var Collapse = /*#__PURE__*/ _component((_props, _ctx) => {
+	const open = bindable(_props, "_open", () => false, _ctx.emit);
+	const children = childrenProp(_props);
+	const propsContent = readonlyProp(_props, "propsContent");
+	const lazy = readonlyProp(_props, "lazy", false);
+	const rest = restProps(_props, _ctx, false);
+	let root = shallowRef(null);
+	let collapsed = ref(untrack(() => !open.value));
+	const showContent = useLazyContent(() => open.value, () => lazy.value);
+	effect(() => {
+		if (open.value) {
+			collapsed.value = false;
+			return;
+		}
+		if (untrack(() => collapsed.value)) return;
+		let cancelled = false;
+		afterTransitions(root.value).then(() => {
+			if (!cancelled) collapsed.value = true;
+		});
+		return () => cancelled = true;
+	});
+	return () => createVNode("div", mergeProps(mergeAttrs({ sx: collapseStyles.root }, rest, {
+		sx: open.value && collapseStyles.open,
+		ref: root,
+		hidden: collapsed.value && supportsUntilFound ? "until-found" : void 0,
+		inert: collapsed.value && !supportsUntilFound ? true : void 0,
+		onBeforematch: () => open.value = true
+	}), { "data-state": open.value ? "open" : "closed" }), [createVNode("div", mergeAttrs({ sx: collapseStyles.content }, propsContent.value), [showContent() && children.value])]);
+}, {
+	name: "Collapse",
+	props: [
+		"_open",
+		"onUpdate:_open",
+		"propsContent",
+		"lazy"
+	]
+});
+//#endregion
+export { Collapse, collapseStyles };
+
+//# sourceMappingURL=Collapse.js.map

package/dist/display/Collapse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collapse.js","names":["_vtp_bindable","_vtp_childrenProp","_vtp_readonlyProp","_vtp_restProps","_vue_shallowRef","_vue_ref","_vtp_untrack","_createVNode","_mergeProps"],"sources":["../../src/display/Collapse.tsx"],"sourcesContent":["/**\n * 展开收起的内容区，带高度过渡。触发器另外写，或者用 Collapsible。\n *\n *   <Collapse _open={open}>内容</Collapse>\n *\n * 高度过渡用 grid-template-rows 0fr ↔ 1fr，各浏览器都能动画（interpolate-size 只有 Chromium）。\n * 收起并且过渡结束后：\n *   - 支持 hidden=\"until-found\" 的浏览器加上它：页内搜索、锚点命中时浏览器自动展开，这里把 open 写回\n *   - 不支持的（Safari）加 inert：收起的内容不能被 Tab 聚焦，读屏也读不到\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport type { VNodeChild } from 'vue';\nimport { useLazyContent } from '../utils/motion/presence';\nimport { mergeAttrs, type PartProps } from '../utils/props';\nimport { afterTransitions } from '../utils/style/transitions';\nimport { t } from '../config/theme/tokens';\n\n/** 未声明的属性落到外层的 div 上；要分区语义时在外面包 section */\nexport interface CollapseProps extends PartProps<'div', 'hidden' | 'inert'> {\n  /** 是否展开：父级写 _open={x}；页内搜索命中收起的内容时自动展开并写回 */\n  _open?: boolean;\n  children?: VNodeChild;\n  /** 内容层：外层负责高度过渡，内容层裁掉溢出 */\n  propsContent?: PartProps<'div'>;\n  /**\n   * 第一次展开时才渲染内容，之后收起也保留（内容很重、多数人不会展开时用）。\n   * 代价：还没展开过的内容页内搜索找不到\n   */\n  lazy?: boolean;\n}\n\nconst supportsUntilFound =\n  typeof HTMLElement !== 'undefined' && 'onbeforematch' in HTMLElement.prototype;\n\n/** Collapse 的样式：root、open、content */\nexport const collapseStyles = css.create({\n  root: {\n    display: 'grid',\n    gridTemplateRows: '0fr',\n    transition: `grid-template-rows ${t.durations.md} ${t.easings.standard}`,\n  },\n  open: { gridTemplateRows: '1fr' },\n  // 网格项默认的最小高度是内容高度，要设为 0 才能收到 0fr\n  content: { minHeight: 0, overflow: 'hidden' },\n});\n\n/** 展开收起的内容区（div），带高度过渡；收起后可被页内搜索找到并自动展开 */\nexport const Collapse = _component(\n  ({\n    _open: open = _bindable(false),\n    children,\n    propsContent,\n    lazy = false,\n    ...rest\n  }: CollapseProps) => {\n    let root = _state.raw<HTMLElement | null>(null);\n    // 完全收起（过渡已结束）：这时才隐藏内容，收起的过程中内容仍要可见\n    let collapsed = _state(_untrack(!open));\n    const showContent = useLazyContent(\n      () => open,\n      () => lazy,\n    );\n\n    _effect(() => {\n      if (open) {\n        collapsed = false;\n        return;\n      }\n      // 一开始就是收起的：没有过渡要等。不然每个收起的 Collapse 挂载时都要对整棵内容 getAnimations，\n      // 一页十来个收起的源码就是十来次样式计算\n      if (_untrack(collapsed)) return;\n      let cancelled = false;\n      void afterTransitions(root!).then(() => {\n        if (!cancelled) collapsed = true;\n      });\n      return () => (cancelled = true);\n    });\n\n    return () => (\n      <div\n        {...mergeAttrs<'div'>({ sx: collapseStyles.root }, rest, {\n          sx: open && collapseStyles.open,\n          ref: _toRef(root),\n          hidden: collapsed && supportsUntilFound ? 'until-found' : undefined,\n          inert: collapsed && !supportsUntilFound ? true : undefined,\n          onBeforematch: () => (open = true),\n        })}\n        data-state={open ? 'open' : 'closed'}\n      >\n        <div {...mergeAttrs<'div'>({ sx: collapseStyles.content }, propsContent)}>\n          {showContent() && children}\n        </div>\n      </div>\n    );\n  },\n);\n"],"mappings":";;;;;;;;;AAgCA,IAAM,qBACJ,OAAO,gBAAgB,eAAe,mBAAmB,YAAY;;AAGvE,IAAa,iBAAiB,IAAI,OAAO;CACvC,MAAM;EACJ,SAAS;EACT,kBAAkB;EAClB,YAAY,sBAAsB,EAAE,UAAU,GAAE,GAAI,EAAE,QAAQ;CAChE;CACA,MAAM,EAAE,kBAAkB,MAAM;CAEhC,SAAS;EAAE,WAAW;EAAG,UAAU;CAAS;AAC9C,CAAC;;AAGD,IAAa,WAAW,0BACtB,QAAA,SAMqB;CAAA,MAAA,OAAAA,SAAA,QAAA,eALK,OAAK,KAAA,IAAA;CAAA,MAAA,WAAAC,aAAA,MAAA;CAAA,MAAA,eAAAC,aAAA,QAAA,cAAA;CAAA,MAAA,OAAAA,aAAA,QAAA,QAGtB,KAAK;CAAA,MACT,OAAIC,UAAA,QAAA,MAAA,KAAA;CAEP,IAAI,OAAIC,WAAkC,IAAI;CAE9C,IAAI,YAASC,IAAAC,cAAmB,CAAA,KAAA,KAAK,CAAA;CACrC,MAAM,cAAc,qBAClB,KAAA,aACA,KAAA,KACF;CAEA,aAAc;EACZ,IAAA,KAAA,OAAU;GACR,UAAA,QAAY;GACZ;EACF;EAGA,IAAAA,cAAA,UAAA,KAAA,GAAyB;EACzB,IAAI,YAAY;EAChB,iBAAqB,KAAA,KAAM,CAAC,CAAC,WAAW;GACtC,IAAI,CAAC,WAAW,UAAA,QAAY;EAC9B,CAAC;EACD,aAAc,YAAY;CAC5B,CAAC;CAED,aAAOC,YAAA,OAAAC,WAEC,WAAkB,EAAE,IAAI,eAAe,KAAK,GAAG,MAAM;EACvD,IAAI,KAAA,SAAQ,eAAe;EAC3B,KAAG;EACH,QAAQ,UAAA,SAAa,qBAAqB,gBAAgB,KAAA;EAC1D,OAAO,UAAA,SAAa,CAAC,qBAAqB,OAAO,KAAA;EACjD,qBAAsB,KAAA,QAAO;CAC/B,CAAC,GAAC,EAAA,cACU,KAAA,QAAO,SAAS,SAAQ,CAAA,GAAA,CAAAD,YAAA,OAE3B,WAAkB,EAAE,IAAI,eAAe,QAAQ,GAAC,aAAA,KAAc,GAAC,CACrE,YAAY,KAAC,SAAA,KAAY,CAAA,CAAA,CAAA;AAIlC,GAAC;CAAA,MAAA;CAAA,OAAA;EAAA;EAAA;EAAA;EAAA;CAAA;AAAA,CACH"}

package/dist/display/Collapsible.d.ts

@@ -0,0 +1,12 @@
+import { type VNodeChild } from 'vue';
+import type { TriggerProps } from '../utils/props';
+import { type CollapseProps } from './Collapse';
+/** 未声明的属性落到 Collapse 上 */
+export interface CollapsibleProps extends CollapseProps {
+    /** 触发器：`(props) => <Button {...props}>更多</Button>`，props 带 aria-expanded 与 aria-controls */
+    trigger: (props: TriggerProps) => VNodeChild;
+    /** 不可用：触发器带上 disabled，点击不切换（open 仍可由父级控制） */
+    disabled?: boolean;
+}
+/** 触发器 + 展开收起的内容区（Disclosure 模式），触发器自动带上 aria-expanded 与 aria-controls */
+export declare const Collapsible: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<CollapsibleProps>;

package/dist/display/Collapsible.js

@@ -0,0 +1,41 @@
+import { Collapse } from "./Collapse.js";
+import { Fragment, computed, createVNode, mergeProps, useId } from "vue";
+import { _component, bindable, readonlyProp, restProps } from "@zerodep-dev/vue-tsx-pro-tsx";
+//#region src/display/Collapsible.tsx
+/** 未声明的属性落到 Collapse 上 */
+/** 触发器 + 展开收起的内容区（Disclosure 模式），触发器自动带上 aria-expanded 与 aria-controls */
+var Collapsible = /*#__PURE__*/ _component((_props, _ctx) => {
+	const _cache = [];
+	const open = bindable(_props, "_open", () => false, _ctx.emit);
+	const trigger = readonlyProp(_props, "trigger");
+	const disabled = readonlyProp(_props, "disabled", false);
+	const id = readonlyProp(_props, "id");
+	const rest = restProps(_props, _ctx, true);
+	const generatedId = useId();
+	const contentId = computed(() => id.value ?? generatedId);
+	return () => createVNode(Fragment, null, [trigger.value({
+		onClick: () => {
+			if (!disabled.value) open.value = !open.value;
+		},
+		"aria-expanded": open.value,
+		"aria-controls": contentId.value,
+		disabled: disabled.value || void 0
+	}), createVNode(Collapse, mergeProps(rest, {
+		"id": contentId.value,
+		"_open": open.value,
+		"onUpdate:_open": _cache[0] || (_cache[0] = ($event) => open.value = $event)
+	}), null)]);
+}, {
+	name: "Collapsible",
+	props: [
+		"_open",
+		"onUpdate:_open",
+		"trigger",
+		"disabled",
+		"id"
+	]
+});
+//#endregion
+export { Collapsible };
+
+//# sourceMappingURL=Collapsible.js.map

package/dist/display/Collapsible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collapsible.js","names":["_vtp_bindable","_vtp_readonlyProp","_vtp_restProps","_vue_computed","_createVNode","_Fragment","_mergeProps"],"sources":["../../src/display/Collapsible.tsx"],"sourcesContent":["/**\n * 可展开收起的区域：触发器 + Collapse（WAI-ARIA 的 Disclosure 模式）。Accordion 的每一项也建在 Collapse 上。\n *\n *   <Collapsible trigger={(props) => <Button {...props}>高级选项</Button>}>…</Collapsible>\n *\n * 触发器用渲染函数而不是原生 <summary>：<summary> 必须是 <details> 的第一个子元素，触发器不能放在别处。\n * 键盘操作由触发器元素自己提供（按钮的 Enter、空格）。\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport { useId, type VNodeChild } from 'vue';\nimport type { TriggerProps } from '../utils/props';\nimport { Collapse, type CollapseProps } from './Collapse';\n\n/** 未声明的属性落到 Collapse 上 */\nexport interface CollapsibleProps extends CollapseProps {\n  /** 触发器：`(props) => <Button {...props}>更多</Button>`，props 带 aria-expanded 与 aria-controls */\n  trigger: (props: TriggerProps) => VNodeChild;\n  /** 不可用：触发器带上 disabled，点击不切换（open 仍可由父级控制） */\n  disabled?: boolean;\n}\n\n/** 触发器 + 展开收起的内容区（Disclosure 模式），触发器自动带上 aria-expanded 与 aria-controls */\nexport const Collapsible = _component(\n  ({\n    _open: open = _bindable(false),\n    trigger,\n    disabled = false,\n    id,\n    ...rest\n  }: CollapsibleProps) => {\n    const generatedId = useId();\n    const contentId = _derived(id ?? generatedId);\n\n    return () => (\n      <>\n        {trigger({\n          onClick: () => {\n            if (!disabled) open = !open;\n          },\n          'aria-expanded': open,\n          'aria-controls': contentId,\n          disabled: disabled || undefined,\n        })}\n        <Collapse {...rest} id={contentId} _open={open} />\n      </>\n    );\n  },\n);\n"],"mappings":";;;;;;AAsBA,IAAa,cAAc,0BACzB,QAAA,SAMwB;CAAA,MAAA,SAAA,CAAA;CAAA,MAAA,OAAAA,SAAA,QAAA,eALE,OAAK,KAAA,IAAA;CAAA,MAAA,UAAAC,aAAA,QAAA,SAAA;CAAA,MAAA,WAAAA,aAAA,QAAA,YAElB,KAAK;CAAA,MAAA,KAAAA,aAAA,QAAA,IAAA;CAAA,MAEb,OAAIC,UAAA,QAAA,MAAA,IAAA;CAEP,MAAM,cAAc,MAAM;CAC1B,MAAM,YAASC,eAAY,GAAA,SAAM,WAAW;CAE5C,aAAOC,YAAAC,UAAA,MAAA,CAEF,QAAA,MAAQ;EACP,eAAe;GACb,IAAI,CAAA,SAAA,OAAW,KAAA,QAAO,CAAA,KAAA;EACxB;EACA,iBAAe,KAAA;EACf,iBAAe,UAAA;EACf,UAAU,SAAA,SAAY,KAAA;CACxB,CAAC,GAACD,YAAA,UAAAE,WACY,MAAI;EAAA,MAAA,UAAA;EAAA,SAAA,KAAA;EAAA,kBAAA,OAAA,OAAA,OAAA,MAAA,WAAA,KAAA,QAAA;CAAA,CAAA,GAAA,IAAA,CAAA,CAAA;AAGxB,GAAC;CAAA,MAAA;CAAA,OAAA;EAAA;EAAA;EAAA;EAAA;EAAA;CAAA;AAAA,CACH"}