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

package/dist/config/lang/zh-CN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.js","names":[],"sources":["../../../src/config/lang/zh-CN.ts"],"sourcesContent":["import zodMessages from 'zod/v4/locales/zh-CN.js';\nimport type { Lang } from './lang';\n\n/** 简体中文 */\nexport const zhCN: Lang = {\n  code: 'zh-CN',\n  direction: 'ltr',\n  calendar: 'gregory',\n  currency: 'CNY',\n\n  confirm: '确定',\n  cancel: '取消',\n  close: '关闭',\n  imagePreview: (alt) => `查看大图：${alt}`,\n  imageError: '图片加载失败',\n  requestFailed: '请求失败，请稍后重试',\n  errorCodes: {\n    'http.network': '网络连接失败，请检查网络后重试',\n    'http.timeout': ({ seconds }) =>\n      typeof seconds === 'number'\n        ? `请求超时（${seconds} 秒），请稍后重试`\n        : '请求超时，请稍后重试',\n    'http.aborted': '请求已取消',\n    'http.status': ({ status }) =>\n      typeof status === 'number'\n        ? `服务暂时不可用（${status}），请稍后重试`\n        : '服务暂时不可用，请稍后重试',\n    'http.parse': '服务返回的内容无法识别，请稍后重试',\n    'query.request-invalid': '查询条件有误，请检查后重试',\n    'query.empty-result': '数据不存在或已被删除',\n    'query.too-many-rows': '找到了多条数据，无法确定是哪一条',\n    'query.unexpected-row-count': '数据已被他人修改或删除，请刷新后重试',\n    'query.statement-timeout': '查询超时，请缩小范围后重试',\n    'query.execution-failed': '数据操作失败，请稍后重试',\n    'query.invalid-row': '数据不完整，无法保存',\n    'query.batch-write-failed': '部分数据无法保存，本次全部未保存',\n    'query.transaction-closed': '保存被中断，请重试',\n    'query.quota-exceeded': '浏览器存储空间不足，请清理后重试',\n  },\n  lightboxLabel: '图片预览',\n  lightboxZoomIn: '放大',\n  lightboxZoomOut: '缩小',\n  lightboxRotateLeft: '向左旋转',\n  lightboxRotateRight: '向右旋转',\n  lightboxReset: '还原',\n  lightboxDownload: '下载',\n  lightboxPrevious: '上一张',\n  lightboxNext: '下一张',\n  lightboxCounter: (index, total) => `第 ${index} 张，共 ${total} 张`,\n  descriptionsCopy: (label) => `复制${label}`,\n  fieldCompareHeaders: ['字段', '原值', '新值', '变化'],\n  fieldCompareTo: '改为',\n  fieldCompareNone: '没有改动',\n  timelineShowMore: (count) => `展开其余 ${count} 条`,\n  timelineShowLess: '收起',\n  timelineDetails: '查看详情',\n  mentionsList: '可以提及的人',\n  mentionsEmpty: '没有匹配的人',\n  checklistStatus: {\n    done: '已完成',\n    todo: '未完成',\n    overdue: '已超时',\n    blocked: '受阻',\n    skipped: '不适用',\n  },\n  checklistItemState: (label, state) => `${label}${state}`,\n  checklistIconsLabel: (parts) => parts.join('，'),\n  checklistSummary: (done, total) => `已完成 ${done} / ${total}`,\n  chartExport: '导出',\n  chartExportImage: '导出图片（PNG）',\n  chartExportData: '导出数据（CSV）',\n  chartExportName: '图表',\n  chartZoom: '显示范围',\n  chartZoomReset: '显示全部',\n  chartZoomIn: '放大',\n  chartZoomOut: '缩小',\n  chartZoomFit: '复位',\n  chartZoomWheelHint: '按住 Ctrl 滚动缩放地图',\n  chartSeries: '系列',\n  chartStart: '开始',\n  chartEnd: '结束',\n  chartDuration: '时长',\n  chartToday: '今天',\n  chartDays: (days) => `${days} 天`,\n  sparklineSummary: (count, first, last, min, max) =>\n    `${count} 个值，从 ${first} 到 ${last}，最低 ${min}，最高 ${max}`,\n  clear: '清空',\n  loading: '加载中',\n  remove: '移除',\n  copy: '复制',\n  copied: '已复制',\n  emptyValue: '—',\n  formRequired: '必填',\n  formErrorSummary: (count) => `有 ${count} 项需要修改`,\n  formErrorItem: (label, message) => `${label}：${message}`,\n  formIssues: zodMessages().localeError,\n  leaveTitle: '离开这个页面？',\n  leaveDescription: '有未保存的修改，离开后会丢失。',\n  leaveConfirm: '离开',\n\n  toasterLabel: '通知',\n  linkNewWindow: '（在新窗口打开）',\n  passwordShow: '显示密码',\n  characterCount: (count, max) =>\n    max == null ? `已输入 ${count} 个字符` : `已输入 ${count} 个字符，最多 ${max} 个`,\n  sliderMin: '最小值',\n  sliderMax: '最大值',\n  indicatorCount: (count) => `${count} 条新消息`,\n  indicatorDot: '有新消息',\n  avatarMore: (count) => `还有 ${count} 人`,\n  numberDecrement: '减少',\n  numberIncrement: '增加',\n  comboboxToggle: '显示选项',\n  tableSelectAll: '全选',\n  tableSelectColumn: '选择',\n  tableSelectRow: (row) => `选择第 ${row} 行`,\n  tableResizeColumn: (column) => `调整“${column}”的列宽`,\n  tableEmpty: '暂无数据',\n  tableSummary: '合计',\n  tableSelectedCount: (count) => `已选 ${count} 项`,\n  listResultCount: (count) => `${count} 个选项`,\n  listLoadFailed: '加载失败，请重试',\n  tableClearSelection: '取消选择',\n  tableDetails: '详情',\n  tableRowDetails: (row) => `${row} 的详情`,\n  tableFilterColumn: (column, active) => `筛选“${column}”${active ? '（已筛选）' : ''}`,\n  tableFilterSearch: '搜索',\n  tableFilterClear: '清除筛选',\n  tableColumnMenu: (column) => `“${column}”列的操作`,\n  tableSortAscending: '升序',\n  tableSortDescending: '降序',\n  tableSortClear: '取消排序',\n  tableSortPriority: (priority, direction) => `第 ${priority} 排序，${direction}`,\n  tablePinStart: '固定在开头',\n  tablePinEnd: '固定在结尾',\n  tableUnpin: '取消固定',\n  tableMoveBackward: '向前移',\n  tableMoveForward: '向后移',\n  tableHideColumn: '隐藏这一列',\n  tableColumnSettings: '列设置',\n  tableColumnSettingsReset: '重置',\n  chartEmpty: '暂无数据',\n  chartCategory: '类目',\n  chartValue: '数值',\n  chartShare: '占比',\n  chartTotal: '合计',\n  chartFlow: '流向',\n  chartFlowLabel: (source, target) => `${source} → ${target}`,\n  chartIncrease: '增加',\n  chartDecrease: '减少',\n  chartChange: '变动',\n  chartCumulative: '累计',\n  chartStepRate: '环节转化',\n  chartOverallRate: '总转化',\n  chartStage: '环节',\n  chartLink: '连接',\n  chartDegree: (count) => `连接 ${count} 个`,\n  treeToggle: (row) => `${row} 的子项`,\n  splitterResize: '调整分栏',\n  splitterCollapse: '收起',\n  splitterExpand: '展开',\n  fileDrop: '点击或拖放文件到这里',\n  fileTooLarge: (max) => `文件不能超过 ${max}`,\n  fileTypeRejected: '不支持这种文件类型',\n  uploadFailed: '上传失败',\n  uploadDone: '已上传',\n  uploadRetry: (file) => `重新上传 ${file}`,\n  uploadRemove: (file) => `移除 ${file}`,\n  uploadAddImage: '添加图片',\n  uploadPasteHint: '也可以粘贴图片',\n  progressTarget: (value) => `目标 ${value}`,\n  backToTop: '回到顶部',\n  ellipsisExpand: '展开',\n  ellipsisCollapse: '收起',\n  ratingStar: (value) => `${value} 星`,\n  ratingSummary: (value, count) => (value == null ? '未评分' : `${value} 星，满分 ${count} 星`),\n  resultStatus: {\n    403: { title: '没有访问权限', description: '这个页面需要更高的权限，可以联系管理员开通。' },\n    404: { title: '找不到这个页面', description: '地址可能写错了，或者页面已经移走。' },\n    500: {\n      title: '服务出错了',\n      description: '服务器暂时无法处理请求，请稍后重试；问题持续时请联系管理员。',\n    },\n  },\n  sortableHandle: (item) => `移动 ${item}`,\n  sortableInstructions: '按空格拿起，用方向键移动，再按空格放下，Esc 取消',\n  sortableGrabbed: (item, position, total) => `已拿起 ${item}，在第 ${position} 位，共 ${total} 项`,\n  sortableMoved: (item, position, total) => `${item} 移到第 ${position} 位，共 ${total} 项`,\n  sortableDropped: (item, position, total) => `已放下 ${item}，在第 ${position} 位，共 ${total} 项`,\n  sortableCancelled: (item, position) => `已取消，${item} 回到第 ${position} 位`,\n  sortableGroupInstructions:\n    '按空格拿起，上下方向键在组内移动、左右方向键换组，再按空格放下，Esc 取消',\n  sortableGroupGrabbed: (item, group, position) => `已拿起 ${item}，在 ${group} 第 ${position} 位`,\n  sortableOver: (item, group, position, reason) =>\n    reason ? `${group}：不能放，${reason}` : `${item} 到了 ${group} 第 ${position} 位，按空格放下`,\n  sortableGroupDropped: (item, group, position) => `已把 ${item} 放到 ${group} 第 ${position} 位`,\n  sortableGroupCancelled: (item, group, position) =>\n    `已取消，${item} 回到 ${group} 第 ${position} 位`,\n  sortableRejected: (item, reason) => `不能移动：${reason}。${item} 回到原处`,\n  tourPrevious: '上一步',\n  tourNext: '下一步',\n  tourFinish: '完成',\n  tourSkip: '跳过',\n  tourProgress: (current, total) => `${current} / ${total}`,\n  selectEmpty: '没有选项',\n  selectPlaceholder: '请选择',\n  selectSearch: '搜索',\n  selectNoMatch: '没有匹配的选项',\n  selectCreate: (text) => `新建“${text}”`,\n  selectSummary: (labels) => labels.join('、'),\n  selectMoreTags: (count) => `+${count}`,\n  paginationTotal: (total) => `共 ${total.toLocaleString('zh-CN')} 条`,\n  paginationRange: (from, to, total) =>\n    `第 ${from.toLocaleString('zh-CN')}–${to.toLocaleString('zh-CN')} 条，共 ${total.toLocaleString('zh-CN')} 条`,\n  pagination: '分页',\n  pageSizeOption: (size) => `${size} 条/页`,\n  pageSizeLabel: '每页条数',\n  pageJumpBefore: '跳至',\n  pageJumpAfter: '页',\n  pageJumpLabel: '跳到第几页',\n  contextMenuLabel: '更多操作',\n  previousPage: '上一页',\n  nextPage: '下一页',\n  pageLabel: (page) => `第 ${page} 页`,\n  treeEmpty: '暂无数据',\n  tabClose: (label) => `关闭 ${label}`,\n  tabAdd: '新建标签页',\n  navBarMore: '更多',\n  tabList: '全部标签页',\n  tabScrollPrevious: '往前滚',\n  tabScrollNext: '往后滚',\n  tabMoved: (label, position, total) => `${label}移到第 ${position} 个，共 ${total} 个`,\n  treeNoMatch: '没有匹配的节点',\n  treeMoved: (item, parent, position) =>\n    parent ? `${item}移到${parent}下第 ${position} 位` : `${item}移到第一层第 ${position} 位`,\n  transferSource: '可选',\n  transferTarget: '已选',\n  transferMoveTo: (title) => `移到${title}`,\n  transferSelectAll: (title) => `全选${title}`,\n  transferCount: (checked, total) => `${checked} / ${total}`,\n  transferMoved: (count, title) => `已把 ${count} 项移到${title}`,\n  conditionModes: { all: '全部满足', any: '任一满足', none: '都不满足', notAll: '不全满足' },\n  conditionMode: '满足方式',\n  conditionAnd: '且',\n  conditionOr: '或',\n  conditionOperators: {\n    eq: '等于',\n    ne: '不等于',\n    gt: '大于',\n    gte: '大于等于',\n    lt: '小于',\n    lte: '小于等于',\n    between: '介于',\n    in: '是其中之一',\n    notIn: '不是其中任何一个',\n    contains: '包含',\n    notContains: '不包含',\n    startsWith: '开头是',\n    exists: '不为空',\n    empty: '为空',\n  },\n  conditionTypeOperators: {\n    date: { eq: '是', gt: '晚于', gte: '不早于', lt: '早于', lte: '不晚于' },\n    select: { eq: '是', ne: '不是' },\n    boolean: { eq: '为' },\n  },\n  conditionTrue: '是',\n  conditionFalse: '否',\n  conditionTo: '至',\n  conditionRange: (low, high) =>\n    low && high ? `${low} 至 ${high}` : low ? `${low} 以上` : `${high} 以下`,\n  conditionValueSeparator: '、',\n  conditionAndJoiner: '，且 ',\n  conditionOrJoiner: '，或 ',\n  conditionNotPrefix: '不满足：',\n  conditionField: '字段',\n  conditionOperator: '比较方式',\n  conditionValue: (field) => `${field}的值`,\n  conditionAddRule: '添加条件',\n  conditionAddGroup: '添加条件组',\n  conditionRemoveRule: '删除条件',\n  conditionRemoveGroup: '删除条件组',\n  conditionEmpty: '还没有条件',\n  conditionGroup: '条件组',\n  conditionRule: (index) => `条件 ${index}`,\n  peopleTypes: { user: '人员', department: '部门', role: '角色' },\n  peopleSearch: '搜索人员、部门、角色',\n  peoplePages: '浏览方式',\n  peopleOrg: '组织架构',\n  peopleRoles: '角色',\n  peopleRecent: '最近',\n  peopleRoot: '全部',\n  peopleChildren: '下级',\n  peopleOpen: (name) => `下级：${name}`,\n  peopleCount: (count, max) => (max ? `已选 ${count} / ${max}` : `已选 ${count}`),\n  peopleSelected: '已选',\n  peopleRemove: (name) => `移除${name}`,\n  peopleSelectAll: '全选',\n  peopleEmpty: '这里没有可选的',\n  peopleNoResult: '没有找到',\n  peopleNothingSelected: '还没有选',\n  peoplePlaceholder: '选择人员',\n  breadcrumbs: '面包屑',\n  breadcrumbsExpand: '显示被折叠的路径',\n  stepState: (state) => `（${{ complete: '已完成', upcoming: '未开始', error: '出错' }[state]}）`,\n  calendarPreviousMonth: '上个月',\n  calendarNextMonth: '下个月',\n  calendarPreviousYear: '上一年',\n  calendarNextYear: '下一年',\n  calendarYear: (year) => `${year}年`,\n  calendarQuarter: (quarter) => `${'一二三四'[quarter - 1]}季度`,\n  calendarBoardCount: (count) => `${count} 项日程`,\n  calendarBoardMore: (count) => `还有 ${count} 项`,\n  calendarPreviousDecade: '上一个十年',\n  calendarNextDecade: '下一个十年',\n  calendarChooseMonth: (current) => `选择月份：${current}`,\n  calendarChooseYear: (current) => `选择年份：${current}`,\n  calendarWeek: '周',\n  calendarWeekNumber: (week) => `第 ${week} 周`,\n  calendarToday: (date) => `今天，${date}`,\n  calendarPickEnd: '请选择结束日期',\n  datePickerOpen: '选择日期',\n  timePickerOpen: '选择时间',\n  dateRangeStart: '开始日期',\n  dateRangeEnd: '结束日期',\n  dateRangePresets: '快捷选项',\n  datePickerPresets: '快捷选项',\n  datePickerThisQuarter: '本季度',\n  dateRangePreset: {\n    today: '今天',\n    yesterday: '昨天',\n    last7Days: '最近 7 天',\n    last30Days: '最近 30 天',\n    thisWeek: '本周',\n    thisMonth: '本月',\n    lastMonth: '上月',\n    thisYear: '今年',\n  },\n  timePickerNow: '此刻',\n  dateFieldEmpty: '未填写',\n  dateFieldPlaceholders: {\n    year: '年',\n    month: '月',\n    day: '日',\n    quarter: '季',\n    week: '周',\n    hour: '时',\n    minute: '分',\n    second: '秒',\n    dayPeriod: '上午',\n  },\n  dateFieldPeriodPatterns: { quarter: '{year}年第{quarter}季度', week: '{year}年第{week}周' },\n\n  modelViewerLoading: '正在加载模型',\n  modelViewerError: '模型加载失败',\n\n  codeExpand: '展开全部',\n  codeCollapse: '收起',\n  headingAnchor: '链接到本节',\n  skipToContent: '跳到正文',\n  tableOfContents: '本页目录',\n  drawerResize: '调整抽屉宽度',\n  searchLabel: '搜索',\n  searchPlaceholder: '搜索文档',\n  searchEmpty: '没有找到相关内容',\n  themeLight: '亮色',\n  themeSystem: '跟随系统',\n  themeDark: '暗色',\n  themePaper: '纸张',\n  themeMidnight: '午夜',\n  themeHighContrast: '高对比',\n  themeOcean: '海洋',\n  themeForest: '森林',\n  themeLemon: '柠檬',\n  themeSakura: '樱花',\n  themeFestive: '喜庆',\n  themeCyberpunk: '赛博朋克',\n  themeCoffee: '咖啡',\n  colorPick: '选择颜色',\n  pagerLabel: '翻页',\n  pagerPrevious: '上一篇',\n  pagerNext: '下一篇',\n};\n"],"mappings":"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"}

package/dist/config/pinyin.d.ts

@@ -0,0 +1,3 @@
+import type { TextMatcher } from './context';
+/** 拼音匹配器：交给 createUi / Provider 的 textMatcher */
+export declare function createPinyinMatcher(): TextMatcher;

package/dist/config/pinyin.js

@@ -0,0 +1,26 @@
+import { match } from "pinyin-pro";
+//#region src/config/pinyin.ts
+/**
+* 拼音匹配（子路径 `@zerodep-dev/vue-tsx-pro-ui/pinyin`；pinyin-pro 是可选的 peer 依赖，用到才安装）：
+* 选项过滤、命令面板、树的搜索除了按字面匹配，还认全拼、首字母与两者混写（“bj”“beijing”“beij”都能搜到“北京”）。
+*
+*   app.use(createUi({ textMatcher: createPinyinMatcher() }))
+*
+* 多音字任一读音都算（“会计”既能搜 kuaiji 也能搜 huiji）；拼音要对上连续的几个字（“hanpin”搜不到“汉语拼音”），
+* 不在中间跳字，免得结果太宽。只有输入里都是字母（可带空格）时才按拼音匹配，输入汉字时就是普通的字面匹配。
+* pinyin-pro 的字典约 300 KB：只有用到这个子路径的应用才打包它。
+*/
+/** 输入是拼音：只有字母与空格 */
+var PINYIN_QUERY = /^[a-z\s]+$/i;
+/** 拼音匹配器：交给 createUi / Provider 的 textMatcher */
+function createPinyinMatcher() {
+	return (text, query) => {
+		const input = query.trim();
+		if (!input || !PINYIN_QUERY.test(input) || !/[㐀-鿿]/.test(text)) return false;
+		return match(text, input.replace(/\s+/g, ""), { continuous: true }) != null;
+	};
+}
+//#endregion
+export { createPinyinMatcher };
+
+//# sourceMappingURL=pinyin.js.map

package/dist/config/pinyin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinyin.js","names":[],"sources":["../../src/config/pinyin.ts"],"sourcesContent":["/**\n * 拼音匹配（子路径 `@zerodep-dev/vue-tsx-pro-ui/pinyin`；pinyin-pro 是可选的 peer 依赖，用到才安装）：\n * 选项过滤、命令面板、树的搜索除了按字面匹配，还认全拼、首字母与两者混写（“bj”“beijing”“beij”都能搜到“北京”）。\n *\n *   app.use(createUi({ textMatcher: createPinyinMatcher() }))\n *\n * 多音字任一读音都算（“会计”既能搜 kuaiji 也能搜 huiji）；拼音要对上连续的几个字（“hanpin”搜不到“汉语拼音”），\n * 不在中间跳字，免得结果太宽。只有输入里都是字母（可带空格）时才按拼音匹配，输入汉字时就是普通的字面匹配。\n * pinyin-pro 的字典约 300 KB：只有用到这个子路径的应用才打包它。\n */\nimport { match } from 'pinyin-pro';\nimport type { TextMatcher } from './context';\n\n/** 输入是拼音：只有字母与空格 */\nconst PINYIN_QUERY = /^[a-z\\s]+$/i;\n\n/** 拼音匹配器：交给 createUi / Provider 的 textMatcher */\nexport function createPinyinMatcher(): TextMatcher {\n  return (text, query) => {\n    const input = query.trim();\n    if (!input || !PINYIN_QUERY.test(input) || !/[㐀-鿿]/.test(text)) return false;\n    return match(text, input.replace(/\\s+/g, ''), { continuous: true }) != null;\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,IAAM,eAAe;;AAGrB,SAAgB,sBAAmC;CACjD,QAAQ,MAAM,UAAU;EACtB,MAAM,QAAQ,MAAM,KAAK;EACzB,IAAI,CAAC,SAAS,CAAC,aAAa,KAAK,KAAK,KAAK,CAAC,QAAQ,KAAK,IAAI,GAAG,OAAO;EACvE,OAAO,MAAM,MAAM,MAAM,QAAQ,QAAQ,EAAE,GAAG,EAAE,YAAY,KAAK,CAAC,KAAK;CACzE;AACF"}

package/dist/config/query-state.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 放在地址查询参数里的状态（参考 nuqs 的 useQueryState、VueUse 的 useRouteQuery）：刷新、分享链接、后退回来都还在。
+ *
+ *   let view = _fromRef(useQueryState('view', 'all'));            ?view=mine
+ *   const filters = useQueryStates({ keyword: '', year: 2026 });  ?keyword=泵&year=2025
+ *
+ * - 返回的 Ref 是这一页的状态本身：改了立即生效，随后合并写进地址（replace，不加历史记录）；
+ *   地址变了（后退、点了带参数的链接）跟着变
+ * - 等于初始值的键从地址里删掉；地址里的值读不出（格式不对）时用初始值
+ * - 读写按初始值的类型（queryCodecs）：数字、布尔、字符串数组、对象（JSON），其余按字符串；初始值是 null 时按字符串，
+ *   别的类型（数字、日期）写 codec
+ * - 路由适配没有 query、replaceQuery（没配路由、服务端渲染）时就是普通的状态
+ */
+import { type Ref } from 'vue';
+/** 一个值在地址里的写法 */
+export interface QueryCodec<T> {
+    /** 从地址读回；读不出时返回 undefined，用初始值 */
+    parse(value: string | readonly string[]): T | undefined;
+    /** 写进地址的文字；数组写成同名的多个参数 */
+    serialize(value: T): string | readonly string[];
+}
+declare const first: (value: string | readonly string[]) => string;
+/** 常用的写法；useQueryState 按初始值的类型自动选 */
+export declare const queryCodecs: {
+    /** 原样 */
+    string: {
+        parse: typeof first;
+        serialize: (value: string | null) => string;
+    };
+    /** 数字；空着是 null */
+    number: {
+        parse(value: string | readonly string[]): number | null | undefined;
+        serialize: (value: number | null) => string;
+    };
+    /** true / false */
+    boolean: {
+        parse: (value: string | readonly string[]) => boolean | undefined;
+        serialize: StringConstructor;
+    };
+    /** 几个固定值之一（页签、类型）：别的值读不出，用初始值 */
+    oneOf: <const T extends string>(values: readonly T[]) => QueryCodec<T>;
+    /** 字符串数组：同名的多个参数（?tag=a&tag=b） */
+    strings: {
+        parse: (value: string | readonly string[]) => string[];
+        serialize: (value: readonly string[]) => readonly string[];
+    };
+    /** JSON */
+    json: {
+        parse(value: string | readonly string[]): unknown;
+        serialize: (value: unknown) => string;
+    };
+};
+/** 各键的写法；没写的按初始值的类型 */
+export type QueryCodecs<T> = {
+    [K in keyof T]?: QueryCodec<T[K]>;
+};
+/** 地址里的一个参数 ↔ 一个状态（在 setup 里调用；见文件开头） */
+export declare function useQueryState<T>(key: string, initial: T, codec?: QueryCodec<T>): Ref<T>;
+/** 地址里的几个参数 ↔ 一个对象，键名就是参数名（在 setup 里调用；见文件开头） */
+export declare function useQueryStates<T extends object>(initial: T, codecs?: QueryCodecs<T>): Ref<T>;
+export {};

package/dist/config/query-state.js

@@ -0,0 +1,113 @@
+import { useConfig } from "./context.js";
+import { sameValue } from "../utils/data/equality.js";
+import { shallowRef, watch } from "vue";
+//#region src/config/query-state.ts
+/**
+* 放在地址查询参数里的状态（参考 nuqs 的 useQueryState、VueUse 的 useRouteQuery）：刷新、分享链接、后退回来都还在。
+*
+*   let view = _fromRef(useQueryState('view', 'all'));            ?view=mine
+*   const filters = useQueryStates({ keyword: '', year: 2026 });  ?keyword=泵&year=2025
+*
+* - 返回的 Ref 是这一页的状态本身：改了立即生效，随后合并写进地址（replace，不加历史记录）；
+*   地址变了（后退、点了带参数的链接）跟着变
+* - 等于初始值的键从地址里删掉；地址里的值读不出（格式不对）时用初始值
+* - 读写按初始值的类型（queryCodecs）：数字、布尔、字符串数组、对象（JSON），其余按字符串；初始值是 null 时按字符串，
+*   别的类型（数字、日期）写 codec
+* - 路由适配没有 query、replaceQuery（没配路由、服务端渲染）时就是普通的状态
+*/
+var first = (value) => typeof value === "string" ? value : value[0] ?? "";
+/** 常用的写法；useQueryState 按初始值的类型自动选 */
+var queryCodecs = {
+	/** 原样 */
+	string: {
+		parse: first,
+		serialize: (value) => value ?? ""
+	},
+	/** 数字；空着是 null */
+	number: {
+		parse(value) {
+			const text = first(value);
+			if (text === "") return null;
+			const number = Number(text);
+			return Number.isFinite(number) ? number : void 0;
+		},
+		serialize: (value) => value == null ? "" : String(value)
+	},
+	/** true / false */
+	boolean: {
+		parse: (value) => first(value) === "true" ? true : first(value) === "false" ? false : void 0,
+		serialize: String
+	},
+	/** 几个固定值之一（页签、类型）：别的值读不出，用初始值 */
+	oneOf: (values) => ({
+		parse: (value) => values.find((item) => item === first(value)),
+		serialize: (value) => value
+	}),
+	/** 字符串数组：同名的多个参数（?tag=a&tag=b） */
+	strings: {
+		parse: (value) => typeof value === "string" ? [value] : [...value],
+		serialize: (value) => value
+	},
+	/** JSON */
+	json: {
+		parse(value) {
+			try {
+				return JSON.parse(first(value));
+			} catch {
+				return;
+			}
+		},
+		serialize: (value) => JSON.stringify(value)
+	}
+};
+/** 按初始值的类型选写法 */
+function codecOf(initial) {
+	return typeof initial === "number" ? queryCodecs.number : typeof initial === "boolean" ? queryCodecs.boolean : Array.isArray(initial) ? queryCodecs.strings : typeof initial === "object" && initial !== null ? queryCodecs.json : queryCodecs.string;
+}
+/** 一个参数：读回来（没有、读不出时是 initial），写进去（等于 initial 时删掉） */
+function param(key, initial, codec) {
+	return {
+		read: (query) => {
+			const text = query[key];
+			const parsed = text === void 0 ? void 0 : codec.parse(text);
+			return parsed === void 0 ? initial : parsed;
+		},
+		write: (value) => sameValue(value, initial) ? void 0 : codec.serialize(value)
+	};
+}
+/** 地址里的一个参数 ↔ 一个状态（在 setup 里调用；见文件开头） */
+function useQueryState(key, initial, codec = codecOf(initial)) {
+	const { read, write } = param(key, initial, codec);
+	return useQuerySync(initial, read, (value) => ({ [key]: write(value) }));
+}
+/** 地址里的几个参数 ↔ 一个对象，键名就是参数名（在 setup 里调用；见文件开头） */
+function useQueryStates(initial, codecs = {}) {
+	const params = Object.keys(initial).map((key) => ({
+		key,
+		...param(key, initial[key], codecs[key] ?? codecOf(initial[key]))
+	}));
+	return useQuerySync(initial, (query) => {
+		const value = { ...initial };
+		for (const { key, read } of params) value[key] = read(query);
+		return value;
+	}, (value) => Object.fromEntries(params.map(({ key, write }) => [key, write(value[key])])));
+}
+/** 状态以本地为准，与地址双向同步 */
+function useQuerySync(initial, read, write) {
+	const router = useConfig().router;
+	const query = router?.query;
+	const replaceQuery = router?.replaceQuery;
+	const state = shallowRef(query ? read(query()) : initial);
+	if (!query || !replaceQuery) return state;
+	watch(() => read(query()), (value) => {
+		if (!sameValue(value, state.value)) state.value = value;
+	});
+	watch(state, (value) => {
+		if (!sameValue(read(query()), value)) replaceQuery(write(value));
+	});
+	return state;
+}
+//#endregion
+export { queryCodecs, useQueryState, useQueryStates };
+
+//# sourceMappingURL=query-state.js.map

package/dist/config/query-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-state.js","names":[],"sources":["../../src/config/query-state.ts"],"sourcesContent":["/**\n * 放在地址查询参数里的状态（参考 nuqs 的 useQueryState、VueUse 的 useRouteQuery）：刷新、分享链接、后退回来都还在。\n *\n *   let view = _fromRef(useQueryState('view', 'all'));            ?view=mine\n *   const filters = useQueryStates({ keyword: '', year: 2026 });  ?keyword=泵&year=2025\n *\n * - 返回的 Ref 是这一页的状态本身：改了立即生效，随后合并写进地址（replace，不加历史记录）；\n *   地址变了（后退、点了带参数的链接）跟着变\n * - 等于初始值的键从地址里删掉；地址里的值读不出（格式不对）时用初始值\n * - 读写按初始值的类型（queryCodecs）：数字、布尔、字符串数组、对象（JSON），其余按字符串；初始值是 null 时按字符串，\n *   别的类型（数字、日期）写 codec\n * - 路由适配没有 query、replaceQuery（没配路由、服务端渲染）时就是普通的状态\n */\nimport { shallowRef, watch, type Ref } from 'vue';\nimport { sameValue } from '../utils/data/equality';\nimport { useConfig, type QueryPatch, type QueryValues } from './context';\n\n/** 一个值在地址里的写法 */\nexport interface QueryCodec<T> {\n  /** 从地址读回；读不出时返回 undefined，用初始值 */\n  parse(value: string | readonly string[]): T | undefined;\n  /** 写进地址的文字；数组写成同名的多个参数 */\n  serialize(value: T): string | readonly string[];\n}\n\nconst first = (value: string | readonly string[]) =>\n  typeof value === 'string' ? value : (value[0] ?? '');\n\n/** 常用的写法；useQueryState 按初始值的类型自动选 */\nexport const queryCodecs = {\n  /** 原样 */\n  string: {\n    parse: first,\n    serialize: (value) => value ?? '',\n  } satisfies QueryCodec<string | null>,\n  /** 数字；空着是 null */\n  number: {\n    parse(value) {\n      const text = first(value);\n      if (text === '') return null;\n      const number = Number(text);\n      return Number.isFinite(number) ? number : undefined;\n    },\n    serialize: (value) => (value == null ? '' : String(value)),\n  } satisfies QueryCodec<number | null>,\n  /** true / false */\n  boolean: {\n    parse: (value) =>\n      first(value) === 'true' ? true : first(value) === 'false' ? false : undefined,\n    serialize: String,\n  } satisfies QueryCodec<boolean>,\n  /** 几个固定值之一（页签、类型）：别的值读不出，用初始值 */\n  oneOf: <const T extends string>(values: readonly T[]): QueryCodec<T> => ({\n    parse: (value) => values.find((item) => item === first(value)),\n    serialize: (value) => value,\n  }),\n  /** 字符串数组：同名的多个参数（?tag=a&tag=b） */\n  strings: {\n    parse: (value) => (typeof value === 'string' ? [value] : [...value]),\n    serialize: (value) => value,\n  } satisfies QueryCodec<readonly string[]>,\n  /** JSON */\n  json: {\n    parse(value) {\n      try {\n        return JSON.parse(first(value)) as unknown;\n      } catch {\n        return undefined;\n      }\n    },\n    serialize: (value) => JSON.stringify(value),\n  } satisfies QueryCodec<unknown>,\n};\n\n/** 按初始值的类型选写法 */\nfunction codecOf<T>(initial: T): QueryCodec<T> {\n  const codec =\n    typeof initial === 'number'\n      ? queryCodecs.number\n      : typeof initial === 'boolean'\n        ? queryCodecs.boolean\n        : Array.isArray(initial)\n          ? queryCodecs.strings\n          : typeof initial === 'object' && initial !== null\n            ? queryCodecs.json\n            : queryCodecs.string;\n  return codec as QueryCodec<unknown> as QueryCodec<T>;\n}\n\n/** 各键的写法；没写的按初始值的类型 */\nexport type QueryCodecs<T> = { [K in keyof T]?: QueryCodec<T[K]> };\n\n/** 一个参数：读回来（没有、读不出时是 initial），写进去（等于 initial 时删掉） */\nfunction param<T>(key: string, initial: T, codec: QueryCodec<T>) {\n  return {\n    read: (query: QueryValues): T => {\n      const text = query[key];\n      const parsed = text === undefined ? undefined : codec.parse(text);\n      return parsed === undefined ? initial : parsed;\n    },\n    write: (value: T) => (sameValue(value, initial) ? undefined : codec.serialize(value)),\n  };\n}\n\n/** 地址里的一个参数 ↔ 一个状态（在 setup 里调用；见文件开头） */\nexport function useQueryState<T>(\n  key: string,\n  initial: T,\n  codec: QueryCodec<T> = codecOf(initial),\n): Ref<T> {\n  const { read, write } = param(key, initial, codec);\n  return useQuerySync(initial, read, (value) => ({ [key]: write(value) }));\n}\n\n/** 地址里的几个参数 ↔ 一个对象，键名就是参数名（在 setup 里调用；见文件开头） */\nexport function useQueryStates<T extends object>(initial: T, codecs: QueryCodecs<T> = {}): Ref<T> {\n  const params = (Object.keys(initial) as (keyof T & string)[]).map((key) => ({\n    key,\n    ...param(key, initial[key], codecs[key] ?? codecOf(initial[key])),\n  }));\n  return useQuerySync(\n    initial,\n    (query) => {\n      const value = { ...initial };\n      for (const { key, read } of params) value[key] = read(query);\n      return value;\n    },\n    (value) => Object.fromEntries(params.map(({ key, write }) => [key, write(value[key])])),\n  );\n}\n\n/** 状态以本地为准，与地址双向同步 */\nfunction useQuerySync<T>(\n  initial: T,\n  read: (query: QueryValues) => T,\n  write: (value: T) => QueryPatch,\n): Ref<T> {\n  const router = useConfig().router;\n  const query = router?.query;\n  const replaceQuery = router?.replaceQuery;\n  const state = shallowRef(query ? read(query()) : initial) as Ref<T>;\n  if (!query || !replaceQuery) return state;\n  // 地址变了：跟着变（自己写进去的那次读回来相等，不再写）\n  watch(\n    () => read(query()),\n    (value) => {\n      if (!sameValue(value, state.value)) state.value = value;\n    },\n  );\n  watch(state, (value) => {\n    if (!sameValue(read(query()), value)) replaceQuery(write(value));\n  });\n  return state;\n}\n"],"mappings":"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"}

package/dist/config/shiki.d.ts

@@ -0,0 +1,13 @@
+import type { LanguageInput } from 'shiki/types';
+import type { Highlighter } from './context';
+/** createShikiHighlighter 的选项 */
+export interface ShikiHighlighterOptions {
+    /**
+     * 可用的语言：语言名（含别名，如 ts）→ 加载语法的函数。不传时用 Shiki 自带的全部语言（第一次高亮时才加载这张表），
+     * 构建时每种语言单独成块、用到才下载。只用几种语言时传上（Shiki 推荐的细粒度写法），开发服务器不用处理两百多种语法：
+     * `{ ts: () => import('@shikijs/langs/typescript'), tsx: () => import('@shikijs/langs/tsx') }`
+     */
+    languages?: Record<string, () => Promise<LanguageInput>>;
+}
+/** 生成高亮器；Shiki 本身在第一次高亮时才创建，同一个高亮器里的语言只加载一次 */
+export declare function createShikiHighlighter(options?: ShikiHighlighterOptions): Highlighter;

package/dist/config/shiki.js

@@ -0,0 +1,97 @@
+import { colors } from "./theme/tokens.js";
+//#region src/config/shiki.ts
+var THEME = "vue-tsx-pro";
+/** 组件库的 Shiki 主题；createCssVariablesTheme 来自按需加载的 shiki/core */
+function theme(createCssVariablesTheme) {
+	const base = createCssVariablesTheme({
+		name: THEME,
+		variableDefaults: {
+			foreground: String(colors.text),
+			background: "transparent",
+			"token-comment": String(colors.codeComment),
+			"token-punctuation": String(colors.codeComment),
+			"token-keyword": String(colors.codeKeyword),
+			"token-link": String(colors.codeKeyword),
+			"token-string": String(colors.codeString),
+			"token-string-expression": String(colors.codeString),
+			"token-constant": String(colors.codeNumber),
+			"token-function": String(colors.codeFunction),
+			"token-parameter": String(colors.text),
+			"token-inserted": String(colors.codeString),
+			"token-deleted": String(colors.dangerText),
+			"token-changed": String(colors.codeNumber)
+		}
+	});
+	return {
+		...base,
+		tokenColors: [...base.tokenColors ?? [], ...extraTokenColors]
+	};
+}
+/** Shiki 的 CSS 变量主题不区分类型、标签名、属性名：追加几条规则，同样可以用 --shiki-token-* 覆盖 */
+var extraTokenColors = [
+	{
+		scope: [
+			"entity.name.type",
+			"entity.name.class",
+			"support.type",
+			"support.class",
+			"entity.other.inherited-class"
+		],
+		settings: { foreground: `var(--shiki-token-type, ${String(colors.codeType)})` }
+	},
+	{
+		scope: ["entity.name.tag", "support.class.component"],
+		settings: { foreground: `var(--shiki-token-tag, ${String(colors.codeTag)})` }
+	},
+	{
+		scope: ["entity.other.attribute-name"],
+		settings: { foreground: `var(--shiki-token-attribute, ${String(colors.codeAttribute)})` }
+	}
+];
+/** 生成高亮器；Shiki 本身在第一次高亮时才创建，同一个高亮器里的语言只加载一次 */
+function createShikiHighlighter(options = {}) {
+	let languages;
+	const languageTable = () => languages ??= options.languages ? Promise.resolve(options.languages) : import("shiki/langs").then((module) => module.bundledLanguages);
+	let core;
+	const loadCore = async () => {
+		const [shiki, engine] = await Promise.all([import("shiki/core"), import("shiki/engine/javascript")]);
+		return shiki.createHighlighterCore({
+			themes: [theme(shiki.createCssVariablesTheme)],
+			langs: [],
+			engine: engine.createJavaScriptRegexEngine({ forgiving: true })
+		});
+	};
+	const loading = /* @__PURE__ */ new Map();
+	/** 加载语言，返回能否高亮；不认识的语言返回 false */
+	const ensureLanguage = async (highlighter, lang) => {
+		if (highlighter.getLoadedLanguages().includes(lang)) return true;
+		const load = (await languageTable())[lang];
+		if (!load) return false;
+		let pending = loading.get(lang);
+		if (!pending) {
+			pending = load().then(async (grammar) => {
+				await highlighter.loadLanguage(grammar);
+				return true;
+			}, (error) => {
+				loading.delete(lang);
+				throw error;
+			});
+			loading.set(lang, pending);
+		}
+		return pending;
+	};
+	return async (code, lang) => {
+		const highlighter = await (core ??= loadCore());
+		const name = lang.toLowerCase();
+		const known = await ensureLanguage(highlighter, name);
+		return highlighter.codeToHtml(code, {
+			lang: known ? name : "text",
+			theme: THEME,
+			structure: "inline"
+		});
+	};
+}
+//#endregion
+export { createShikiHighlighter };
+
+//# sourceMappingURL=shiki.js.map

package/dist/config/shiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiki.js","names":[],"sources":["../../src/config/shiki.ts"],"sourcesContent":["/**\n * Shiki 代码高亮器（子路径 `@zerodep-dev/vue-tsx-pro-ui/shiki`；shiki 是可选的 peer 依赖，用到才安装）：\n *\n *   app.use(createUi({ highlighter: createShikiHighlighter() }))\n *\n * - 正则引擎用 JavaScript 版（不加载 wasm），语法不完全支持的语言尽量高亮而不是报错\n * - 语言按需加载：第一次遇到某种语言时才下载它的语法；不认识的语言按纯文本显示\n * - Shiki 与正则引擎在第一次高亮时才加载：放在入口里的高亮器不会把它们带进首屏（文档站首屏因此少了约 240 KB）\n * - 颜色用 Shiki 的 CSS 变量主题（另加类型、标签名、属性名三类），默认值指向组件库的代码高亮 tokens（colors.code*）：\n *   切换主题、覆盖 tokens 都不需要重新高亮；使用方也可以用 --shiki-token-keyword 这类变量单独调整\n */\nimport type { HighlighterCore } from 'shiki/core';\nimport type { LanguageInput } from 'shiki/types';\nimport type { Highlighter } from './context';\nimport { colors } from './theme/tokens';\n\n/** createShikiHighlighter 的选项 */\nexport interface ShikiHighlighterOptions {\n  /**\n   * 可用的语言：语言名（含别名，如 ts）→ 加载语法的函数。不传时用 Shiki 自带的全部语言（第一次高亮时才加载这张表），\n   * 构建时每种语言单独成块、用到才下载。只用几种语言时传上（Shiki 推荐的细粒度写法），开发服务器不用处理两百多种语法：\n   * `{ ts: () => import('@shikijs/langs/typescript'), tsx: () => import('@shikijs/langs/tsx') }`\n   */\n  languages?: Record<string, () => Promise<LanguageInput>>;\n}\n\nconst THEME = 'vue-tsx-pro';\n\n/** 组件库的 Shiki 主题；createCssVariablesTheme 来自按需加载的 shiki/core */\nfunction theme(createCssVariablesTheme: typeof import('shiki/core').createCssVariablesTheme) {\n  // colors.x 在运行时是 var(--哈希) 字符串，作为 Shiki 变量的默认值：跟随当前主题\n  const base = createCssVariablesTheme({\n    name: THEME,\n    variableDefaults: {\n      foreground: String(colors.text),\n      background: 'transparent',\n      'token-comment': String(colors.codeComment),\n      'token-punctuation': String(colors.codeComment),\n      'token-keyword': String(colors.codeKeyword),\n      'token-link': String(colors.codeKeyword),\n      'token-string': String(colors.codeString),\n      'token-string-expression': String(colors.codeString),\n      'token-constant': String(colors.codeNumber),\n      'token-function': String(colors.codeFunction),\n      'token-parameter': String(colors.text),\n      'token-inserted': String(colors.codeString),\n      'token-deleted': String(colors.dangerText),\n      'token-changed': String(colors.codeNumber),\n    },\n  });\n  return { ...base, tokenColors: [...(base.tokenColors ?? []), ...extraTokenColors] };\n}\n\n/** Shiki 的 CSS 变量主题不区分类型、标签名、属性名：追加几条规则，同样可以用 --shiki-token-* 覆盖 */\nconst extraTokenColors = [\n  {\n    scope: [\n      'entity.name.type',\n      'entity.name.class',\n      'support.type',\n      'support.class',\n      'entity.other.inherited-class',\n    ],\n    settings: { foreground: `var(--shiki-token-type, ${String(colors.codeType)})` },\n  },\n  {\n    scope: ['entity.name.tag', 'support.class.component'],\n    settings: { foreground: `var(--shiki-token-tag, ${String(colors.codeTag)})` },\n  },\n  {\n    scope: ['entity.other.attribute-name'],\n    settings: { foreground: `var(--shiki-token-attribute, ${String(colors.codeAttribute)})` },\n  },\n];\n\n/** 生成高亮器；Shiki 本身在第一次高亮时才创建，同一个高亮器里的语言只加载一次 */\nexport function createShikiHighlighter(options: ShikiHighlighterOptions = {}): Highlighter {\n  // 全部语言的表有两百多项、每项一个动态导入：传了 languages 的应用不加载它\n  type LanguageTable = Record<string, () => Promise<LanguageInput>>;\n  let languages: Promise<LanguageTable> | undefined;\n  const languageTable = (): Promise<LanguageTable> =>\n    (languages ??= options.languages\n      ? Promise.resolve(options.languages)\n      : import('shiki/langs').then((module): LanguageTable => module.bundledLanguages));\n  let core: Promise<HighlighterCore> | undefined;\n  const loadCore = async () => {\n    const [shiki, engine] = await Promise.all([\n      import('shiki/core'),\n      import('shiki/engine/javascript'),\n    ]);\n    return shiki.createHighlighterCore({\n      themes: [theme(shiki.createCssVariablesTheme)],\n      langs: [],\n      engine: engine.createJavaScriptRegexEngine({ forgiving: true }),\n    });\n  };\n  const loading = new Map<string, Promise<boolean>>();\n\n  /** 加载语言，返回能否高亮；不认识的语言返回 false */\n  const ensureLanguage = async (highlighter: HighlighterCore, lang: string) => {\n    if (highlighter.getLoadedLanguages().includes(lang)) return true;\n    const load = (await languageTable())[lang];\n    if (!load) return false;\n    let pending = loading.get(lang);\n    if (!pending) {\n      pending = load().then(\n        async (grammar) => {\n          await highlighter.loadLanguage(grammar);\n          return true;\n        },\n        (error: unknown) => {\n          // 下载失败（如断网）不缓存，下次再试\n          loading.delete(lang);\n          throw error;\n        },\n      );\n      loading.set(lang, pending);\n    }\n    return pending;\n  };\n\n  return async (code, lang) => {\n    const highlighter = await (core ??= loadCore());\n    const name = lang.toLowerCase();\n    const known = await ensureLanguage(highlighter, name);\n    return highlighter.codeToHtml(code, {\n      lang: known ? name : 'text',\n      theme: THEME,\n      // 只要行内的 span 与 br，外层的 pre、code 由 CodeBlock 渲染\n      structure: 'inline',\n    });\n  };\n}\n"],"mappings":";;AA0BA,IAAM,QAAQ;;AAGd,SAAS,MAAM,yBAA8E;CAE3F,MAAM,OAAO,wBAAwB;EACnC,MAAM;EACN,kBAAkB;GAChB,YAAY,OAAO,OAAO,IAAI;GAC9B,YAAY;GACZ,iBAAiB,OAAO,OAAO,WAAW;GAC1C,qBAAqB,OAAO,OAAO,WAAW;GAC9C,iBAAiB,OAAO,OAAO,WAAW;GAC1C,cAAc,OAAO,OAAO,WAAW;GACvC,gBAAgB,OAAO,OAAO,UAAU;GACxC,2BAA2B,OAAO,OAAO,UAAU;GACnD,kBAAkB,OAAO,OAAO,UAAU;GAC1C,kBAAkB,OAAO,OAAO,YAAY;GAC5C,mBAAmB,OAAO,OAAO,IAAI;GACrC,kBAAkB,OAAO,OAAO,UAAU;GAC1C,iBAAiB,OAAO,OAAO,UAAU;GACzC,iBAAiB,OAAO,OAAO,UAAU;EAC3C;CACF,CAAC;CACD,OAAO;EAAE,GAAG;EAAM,aAAa,CAAC,GAAI,KAAK,eAAe,CAAC,GAAI,GAAG,gBAAgB;CAAE;AACpF;;AAGA,IAAM,mBAAmB;CACvB;EACE,OAAO;GACL;GACA;GACA;GACA;GACA;EACF;EACA,UAAU,EAAE,YAAY,2BAA2B,OAAO,OAAO,QAAQ,EAAE,GAAG;CAChF;CACA;EACE,OAAO,CAAC,mBAAmB,yBAAyB;EACpD,UAAU,EAAE,YAAY,0BAA0B,OAAO,OAAO,OAAO,EAAE,GAAG;CAC9E;CACA;EACE,OAAO,CAAC,6BAA6B;EACrC,UAAU,EAAE,YAAY,gCAAgC,OAAO,OAAO,aAAa,EAAE,GAAG;CAC1F;AACF;;AAGA,SAAgB,uBAAuB,UAAmC,CAAC,GAAgB;CAGzF,IAAI;CACJ,MAAM,sBACH,cAAc,QAAQ,YACnB,QAAQ,QAAQ,QAAQ,SAAS,IACjC,OAAO,cAAc,CAAC,MAAM,WAA0B,OAAO,gBAAgB;CACnF,IAAI;CACJ,MAAM,WAAW,YAAY;EAC3B,MAAM,CAAC,OAAO,UAAU,MAAM,QAAQ,IAAI,CACxC,OAAO,eACP,OAAO,0BACT,CAAC;EACD,OAAO,MAAM,sBAAsB;GACjC,QAAQ,CAAC,MAAM,MAAM,uBAAuB,CAAC;GAC7C,OAAO,CAAC;GACR,QAAQ,OAAO,4BAA4B,EAAE,WAAW,KAAK,CAAC;EAChE,CAAC;CACH;CACA,MAAM,0BAAU,IAAI,IAA8B;;CAGlD,MAAM,iBAAiB,OAAO,aAA8B,SAAiB;EAC3E,IAAI,YAAY,mBAAmB,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO;EAC5D,MAAM,QAAQ,MAAM,cAAc,EAAA,CAAG;EACrC,IAAI,CAAC,MAAM,OAAO;EAClB,IAAI,UAAU,QAAQ,IAAI,IAAI;EAC9B,IAAI,CAAC,SAAS;GACZ,UAAU,KAAK,CAAC,CAAC,KACf,OAAO,YAAY;IACjB,MAAM,YAAY,aAAa,OAAO;IACtC,OAAO;GACT,IACC,UAAmB;IAElB,QAAQ,OAAO,IAAI;IACnB,MAAM;GACR,CACF;GACA,QAAQ,IAAI,MAAM,OAAO;EAC3B;EACA,OAAO;CACT;CAEA,OAAO,OAAO,MAAM,SAAS;EAC3B,MAAM,cAAc,OAAO,SAAS,SAAS;EAC7C,MAAM,OAAO,KAAK,YAAY;EAC9B,MAAM,QAAQ,MAAM,eAAe,aAAa,IAAI;EACpD,OAAO,YAAY,WAAW,MAAM;GAClC,MAAM,QAAQ,OAAO;GACrB,OAAO;GAEP,WAAW;EACb,CAAC;CACH;AACF"}

package/dist/config/styles.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 组件的主题定制：应用级 `createUi({ styles })`、局部 `<Provider styles>` 改组件的样式与档位，不必包一层组件
+ * （参考 MUI 主题的 styleOverrides / variants、Panda 的配方扩展）。
+ *
+ *   createUi({
+ *     styles: {
+ *       Button: {
+ *         base: { root: { letterSpacing: '0.02em' } },                  // 追加在组件自己的样式之后
+ *         variants: { size: { xl: { root: { fontSize: '_xxl' } } } },  // 新档位：先扩展 ButtonVariants 接口
+ *       },
+ *     },
+ *   })
+ *
+ * 合并顺序：组件的基础 < 档位 < 组合档位 < createUi 的定制 < 外层 Provider < 内层 Provider < 使用方的 sx。
+ * 用配方写的组件（css.recipe 给了 name）才认这里的定制；部件上的 data-scope / data-part 也来自配方（partAttrs）。
+ */
+import type { CompiledStyles, Recipe, RecipeExtension } from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import type { BadgePart } from '../base/badge-styles';
+import type { AlertPart } from '../feedback/Alert';
+import type { ButtonPart } from '../base/button-core';
+import type { TabPart } from '../navigation/Tabs';
+import type { DataTablePart } from '../table/table-styles';
+import type { TablePart } from '../table/Table';
+import type { ChoicePart } from '../input/choice-styles';
+import type { InputPart } from '../input/control';
+import type { IndicatorPart } from '../base/Indicator';
+import type { LinkPart } from '../base/Link';
+import type { AvatarPart } from '../display/Avatar';
+import type { CardPart } from '../display/Card';
+import type { EmptyPart } from '../feedback/Empty';
+import type { ProgressPart } from '../feedback/Progress';
+import type { ResultPart } from '../feedback/Result';
+import type { DialogPart } from '../overlay/Dialog';
+import type { DrawerPart } from '../overlay/Drawer';
+/** 可以定制样式的组件与它们的部件；新的配方组件在这里登记 */
+export interface ComponentStyles {
+    /** Button、LinkButton、IconButton、IconLinkButton 共用 */
+    Button?: RecipeExtension<ButtonPart>;
+    /** Badge、Tag 共用 */
+    Badge?: RecipeExtension<BadgePart>;
+    /** Alert */
+    Alert?: RecipeExtension<AlertPart>;
+    /** Tabs 里的标签（Tab） */
+    Tab?: RecipeExtension<TabPart>;
+    /** Link */
+    Link?: RecipeExtension<LinkPart>;
+    /** Indicator */
+    Indicator?: RecipeExtension<IndicatorPart>;
+    /** Avatar（AvatarGroup 的“+N”也取它的外层样式） */
+    Avatar?: RecipeExtension<AvatarPart>;
+    /** Card */
+    Card?: RecipeExtension<CardPart>;
+    /** Progress（条形与环形） */
+    Progress?: RecipeExtension<ProgressPart>;
+    /** Empty */
+    Empty?: RecipeExtension<EmptyPart>;
+    /** Result */
+    Result?: RecipeExtension<ResultPart>;
+    /** Dialog、AlertDialog 共用：dialog 元素与标题行、标题、关闭按钮、说明、正文、页脚 */
+    Dialog?: RecipeExtension<DialogPart>;
+    /** Drawer：同 Dialog 的部件 */
+    Drawer?: RecipeExtension<DrawerPart>;
+    /** TextField、Textarea、NumberField、Select、Combobox、Cascader、TreeSelect、TagsInput、ColorField 与日期输入框的外壳共用 */
+    Input?: RecipeExtension<InputPart>;
+    /** Checkbox、Radio、Switch 与复选组、单选组共用 */
+    Choice?: RecipeExtension<ChoicePart>;
+    /** DataTable、TreeDataTable 共用 */
+    DataTable?: RecipeExtension<DataTablePart>;
+    /** 静态表格 Table 及其行、单元格 */
+    Table?: RecipeExtension<TablePart>;
+}
+/** 各层的定制：外层在前，组件按顺序交给配方（内层排在后面、盖过外层） */
+export type StyleLayers = {
+    readonly [Name in keyof ComponentStyles]?: readonly NonNullable<ComponentStyles[Name]>[];
+};
+/** 加上一层定制：按组件逐个追加在外层之后；这一层没写的组件沿用外层的数组（同一个对象，配方的缓存照样命中） */
+export declare function mergeStyles(outer: StyleLayers, inner: ComponentStyles | undefined): StyleLayers;
+/** 一个部件交给 mergeAttrs / mergeProps 的默认层：样式与部件标记 */
+export type PartLayer = Readonly<{
+    sx: readonly CompiledStyles[];
+    'data-scope': string;
+    'data-part': string;
+}>;
+/**
+ * 配方加上 createUi / Provider 里这个组件的定制：在 setup 里调用，返回的函数在渲染时传档位选择，
+ * 得到每个部件的默认层（样式 + data-scope / data-part），直接交给部件的合并：
+ *
+ *   const recipe = useRecipe(alertRecipe);
+ *   return () => {
+ *     const s = recipe({ variant });
+ *     return <div {...mergeAttrs<'div'>(s.root, rest)}><div {...mergeAttrs<'div'>(s.title, propsTitle)} /></div>;
+ *   };
+ *
+ * 根元素还要加别的样式时：`{ ...s.root, sx: [s.root.sx, 别的] }`
+ */
+export declare function useRecipe<P extends string, V>(recipe: Recipe<P, V>): (selection?: Parameters<Recipe<P, V>>[0]) => Readonly<Record<P, PartLayer>>;
+/** 部件的 data 属性 */
+export type PartAttrs = Readonly<{
+    'data-scope': string;
+    'data-part': string;
+}>;
+/**
+ * 部件的标记：`data-scope="button" data-part="icon"`（组件名转成连字符小写）。使用方的全局 CSS、测试
+ * 都能稳定地选中部件，不依赖生成的类名（同 Ark UI、Zag 的约定）。同一组合返回同一个对象
+ */
+export declare function partAttrs(recipe: {
+    readonly name: string | undefined;
+}, part: string): PartAttrs;

package/dist/config/styles.js

@@ -0,0 +1,59 @@
+import { useConfig } from "./context.js";
+//#region src/config/styles.ts
+/** 加上一层定制：按组件逐个追加在外层之后；这一层没写的组件沿用外层的数组（同一个对象，配方的缓存照样命中） */
+function mergeStyles(outer, inner) {
+	if (!inner) return outer;
+	const merged = { ...outer };
+	for (const [name, extension] of Object.entries(inner)) if (extension) merged[name] = [...merged[name] ?? [], extension];
+	return merged;
+}
+/** 配方算出的样式 → 各部件的默认层；同一组样式（配方按档位组合缓存）返回同一个对象，渲染里不新建 */
+var layerCache = /* @__PURE__ */ new WeakMap();
+/**
+* 配方加上 createUi / Provider 里这个组件的定制：在 setup 里调用，返回的函数在渲染时传档位选择，
+* 得到每个部件的默认层（样式 + data-scope / data-part），直接交给部件的合并：
+*
+*   const recipe = useRecipe(alertRecipe);
+*   return () => {
+*     const s = recipe({ variant });
+*     return <div {...mergeAttrs<'div'>(s.root, rest)}><div {...mergeAttrs<'div'>(s.title, propsTitle)} /></div>;
+*   };
+*
+* 根元素还要加别的样式时：`{ ...s.root, sx: [s.root.sx, 别的] }`
+*/
+function useRecipe(recipe) {
+	const config = useConfig();
+	const name = recipe.name;
+	return (selection) => {
+		const layers = name && config.styles[name];
+		const styles = layers?.length ? recipe(selection, ...layers) : recipe(selection);
+		let result = layerCache.get(styles);
+		if (!result) {
+			result = Object.fromEntries(recipe.parts.map((part) => [part, {
+				sx: styles[part],
+				...partAttrs(recipe, part)
+			}]));
+			layerCache.set(styles, result);
+		}
+		return result;
+	};
+}
+var partCache = /* @__PURE__ */ new Map();
+/**
+* 部件的标记：`data-scope="button" data-part="icon"`（组件名转成连字符小写）。使用方的全局 CSS、测试
+* 都能稳定地选中部件，不依赖生成的类名（同 Ark UI、Zag 的约定）。同一组合返回同一个对象
+*/
+function partAttrs(recipe, part) {
+	const scope = (recipe.name ?? "").replace(/[A-Z]/g, (c, index) => index ? `-${c.toLowerCase()}` : c.toLowerCase());
+	const key = `${scope}\0${part}`;
+	let attrs = partCache.get(key);
+	if (!attrs) partCache.set(key, attrs = Object.freeze({
+		"data-scope": scope,
+		"data-part": part
+	}));
+	return attrs;
+}
+//#endregion
+export { mergeStyles, partAttrs, useRecipe };
+
+//# sourceMappingURL=styles.js.map

package/dist/config/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","names":[],"sources":["../../src/config/styles.ts"],"sourcesContent":["/**\n * 组件的主题定制：应用级 `createUi({ styles })`、局部 `<Provider styles>` 改组件的样式与档位，不必包一层组件\n * （参考 MUI 主题的 styleOverrides / variants、Panda 的配方扩展）。\n *\n *   createUi({\n *     styles: {\n *       Button: {\n *         base: { root: { letterSpacing: '0.02em' } },                  // 追加在组件自己的样式之后\n *         variants: { size: { xl: { root: { fontSize: '_xxl' } } } },  // 新档位：先扩展 ButtonVariants 接口\n *       },\n *     },\n *   })\n *\n * 合并顺序：组件的基础 < 档位 < 组合档位 < createUi 的定制 < 外层 Provider < 内层 Provider < 使用方的 sx。\n * 用配方写的组件（css.recipe 给了 name）才认这里的定制；部件上的 data-scope / data-part 也来自配方（partAttrs）。\n */\nimport type { CompiledStyles, Recipe, RecipeExtension } from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { useConfig } from './context';\nimport type { BadgePart } from '../base/badge-styles';\nimport type { AlertPart } from '../feedback/Alert';\nimport type { ButtonPart } from '../base/button-core';\nimport type { TabPart } from '../navigation/Tabs';\nimport type { DataTablePart } from '../table/table-styles';\nimport type { TablePart } from '../table/Table';\nimport type { ChoicePart } from '../input/choice-styles';\nimport type { InputPart } from '../input/control';\nimport type { IndicatorPart } from '../base/Indicator';\nimport type { LinkPart } from '../base/Link';\nimport type { AvatarPart } from '../display/Avatar';\nimport type { CardPart } from '../display/Card';\nimport type { EmptyPart } from '../feedback/Empty';\nimport type { ProgressPart } from '../feedback/Progress';\nimport type { ResultPart } from '../feedback/Result';\nimport type { DialogPart } from '../overlay/Dialog';\nimport type { DrawerPart } from '../overlay/Drawer';\n\n/** 可以定制样式的组件与它们的部件；新的配方组件在这里登记 */\nexport interface ComponentStyles {\n  /** Button、LinkButton、IconButton、IconLinkButton 共用 */\n  Button?: RecipeExtension<ButtonPart>;\n  /** Badge、Tag 共用 */\n  Badge?: RecipeExtension<BadgePart>;\n  /** Alert */\n  Alert?: RecipeExtension<AlertPart>;\n  /** Tabs 里的标签（Tab） */\n  Tab?: RecipeExtension<TabPart>;\n  /** Link */\n  Link?: RecipeExtension<LinkPart>;\n  /** Indicator */\n  Indicator?: RecipeExtension<IndicatorPart>;\n  /** Avatar（AvatarGroup 的“+N”也取它的外层样式） */\n  Avatar?: RecipeExtension<AvatarPart>;\n  /** Card */\n  Card?: RecipeExtension<CardPart>;\n  /** Progress（条形与环形） */\n  Progress?: RecipeExtension<ProgressPart>;\n  /** Empty */\n  Empty?: RecipeExtension<EmptyPart>;\n  /** Result */\n  Result?: RecipeExtension<ResultPart>;\n  /** Dialog、AlertDialog 共用：dialog 元素与标题行、标题、关闭按钮、说明、正文、页脚 */\n  Dialog?: RecipeExtension<DialogPart>;\n  /** Drawer：同 Dialog 的部件 */\n  Drawer?: RecipeExtension<DrawerPart>;\n  /** TextField、Textarea、NumberField、Select、Combobox、Cascader、TreeSelect、TagsInput、ColorField 与日期输入框的外壳共用 */\n  Input?: RecipeExtension<InputPart>;\n  /** Checkbox、Radio、Switch 与复选组、单选组共用 */\n  Choice?: RecipeExtension<ChoicePart>;\n  /** DataTable、TreeDataTable 共用 */\n  DataTable?: RecipeExtension<DataTablePart>;\n  /** 静态表格 Table 及其行、单元格 */\n  Table?: RecipeExtension<TablePart>;\n}\n\n/** 各层的定制：外层在前，组件按顺序交给配方（内层排在后面、盖过外层） */\nexport type StyleLayers = {\n  readonly [Name in keyof ComponentStyles]?: readonly NonNullable<ComponentStyles[Name]>[];\n};\n\n/** 加上一层定制：按组件逐个追加在外层之后；这一层没写的组件沿用外层的数组（同一个对象，配方的缓存照样命中） */\nexport function mergeStyles(outer: StyleLayers, inner: ComponentStyles | undefined): StyleLayers {\n  if (!inner) return outer;\n  const merged: Record<string, readonly unknown[] | undefined> = { ...outer };\n  for (const [name, extension] of Object.entries(inner)) {\n    if (extension) merged[name] = [...(merged[name] ?? []), extension];\n  }\n  return merged as StyleLayers;\n}\n\n/** 一个部件交给 mergeAttrs / mergeProps 的默认层：样式与部件标记 */\nexport type PartLayer = Readonly<{\n  sx: readonly CompiledStyles[];\n  'data-scope': string;\n  'data-part': string;\n}>;\n\n/** 配方算出的样式 → 各部件的默认层；同一组样式（配方按档位组合缓存）返回同一个对象，渲染里不新建 */\nconst layerCache = new WeakMap<object, Readonly<Record<string, PartLayer>>>();\n\n/**\n * 配方加上 createUi / Provider 里这个组件的定制：在 setup 里调用，返回的函数在渲染时传档位选择，\n * 得到每个部件的默认层（样式 + data-scope / data-part），直接交给部件的合并：\n *\n *   const recipe = useRecipe(alertRecipe);\n *   return () => {\n *     const s = recipe({ variant });\n *     return <div {...mergeAttrs<'div'>(s.root, rest)}><div {...mergeAttrs<'div'>(s.title, propsTitle)} /></div>;\n *   };\n *\n * 根元素还要加别的样式时：`{ ...s.root, sx: [s.root.sx, 别的] }`\n */\nexport function useRecipe<P extends string, V>(\n  recipe: Recipe<P, V>,\n): (selection?: Parameters<Recipe<P, V>>[0]) => Readonly<Record<P, PartLayer>> {\n  const config = useConfig();\n  const name = recipe.name as keyof ComponentStyles | undefined;\n  return (selection) => {\n    const layers = name && (config.styles[name] as readonly RecipeExtension<P>[] | undefined);\n    const styles = layers?.length ? recipe(selection, ...layers) : recipe(selection);\n    let result = layerCache.get(styles);\n    if (!result) {\n      result = Object.fromEntries(\n        recipe.parts.map((part) => [part, { sx: styles[part], ...partAttrs(recipe, part) }]),\n      );\n      layerCache.set(styles, result);\n    }\n    return result as Readonly<Record<P, PartLayer>>;\n  };\n}\n\n/** 部件的 data 属性 */\nexport type PartAttrs = Readonly<{ 'data-scope': string; 'data-part': string }>;\n\nconst partCache = new Map<string, PartAttrs>();\n\n/**\n * 部件的标记：`data-scope=\"button\" data-part=\"icon\"`（组件名转成连字符小写）。使用方的全局 CSS、测试\n * 都能稳定地选中部件，不依赖生成的类名（同 Ark UI、Zag 的约定）。同一组合返回同一个对象\n */\nexport function partAttrs(recipe: { readonly name: string | undefined }, part: string): PartAttrs {\n  const scope = (recipe.name ?? '').replace(/[A-Z]/g, (c, index: number) =>\n    index ? `-${c.toLowerCase()}` : c.toLowerCase(),\n  );\n  const key = `${scope}\\0${part}`;\n  let attrs = partCache.get(key);\n  if (!attrs)\n    partCache.set(key, (attrs = Object.freeze({ 'data-scope': scope, 'data-part': part })));\n  return attrs;\n}\n"],"mappings":";;;AAgFA,SAAgB,YAAY,OAAoB,OAAiD;CAC/F,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,SAAyD,EAAE,GAAG,MAAM;CAC1E,KAAK,MAAM,CAAC,MAAM,cAAc,OAAO,QAAQ,KAAK,GAClD,IAAI,WAAW,OAAO,QAAQ,CAAC,GAAI,OAAO,SAAS,CAAC,GAAI,SAAS;CAEnE,OAAO;AACT;;AAUA,IAAM,6BAAa,IAAI,QAAqD;;;;;;;;;;;;;AAc5E,SAAgB,UACd,QAC6E;CAC7E,MAAM,SAAS,UAAU;CACzB,MAAM,OAAO,OAAO;CACpB,QAAQ,cAAc;EACpB,MAAM,SAAS,QAAS,OAAO,OAAO;EACtC,MAAM,SAAS,QAAQ,SAAS,OAAO,WAAW,GAAG,MAAM,IAAI,OAAO,SAAS;EAC/E,IAAI,SAAS,WAAW,IAAI,MAAM;EAClC,IAAI,CAAC,QAAQ;GACX,SAAS,OAAO,YACd,OAAO,MAAM,KAAK,SAAS,CAAC,MAAM;IAAE,IAAI,OAAO;IAAO,GAAG,UAAU,QAAQ,IAAI;GAAE,CAAC,CAAC,CACrF;GACA,WAAW,IAAI,QAAQ,MAAM;EAC/B;EACA,OAAO;CACT;AACF;AAKA,IAAM,4BAAY,IAAI,IAAuB;;;;;AAM7C,SAAgB,UAAU,QAA+C,MAAyB;CAChG,MAAM,SAAS,OAAO,QAAQ,GAAA,CAAI,QAAQ,WAAW,GAAG,UACtD,QAAQ,IAAI,EAAE,YAAY,MAAM,EAAE,YAAY,CAChD;CACA,MAAM,MAAM,GAAG,MAAM,IAAI;CACzB,IAAI,QAAQ,UAAU,IAAI,GAAG;CAC7B,IAAI,CAAC,OACH,UAAU,IAAI,KAAM,QAAQ,OAAO,OAAO;EAAE,cAAc;EAAO,aAAa;CAAK,CAAC,CAAE;CACxF,OAAO;AACT"}