@jetlinks-web/components 3.3.13 → 3.3.14

package/es/AutoComplete/AutoComplete.md

@@ -0,0 +1,41 @@
+### AutoComplete
+
+带搜索的输入选择组件，支持单选与多选（tags）两种模式；单选时可输入任意值并自动补全，未匹配的输入值会作为自定义选项回填。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value | 当前值（可用 `v-model:value`） | `string \| string[]` | - |
+| multiple | 多选模式，为 `true` 时渲染为 Select tags | `boolean` | `true` |
+| searchKey | 选项匹配字段名，默认取 `options` 的 `label` 字段 | `string` | `'label'` |
+| options | 候选项 | `DefaultOptionType[]` | `[]` |
+| 其余 | 透传 ant-design-vue `Select` / `AutoComplete` 全部 props（`selectProps()`） | - | - |
+
+#### 事件
+
+| 事件 | 说明 | 回调参数 |
+| --- | --- | --- |
+| select | 选中选项时 | `(value, option)` |
+| change | 值变化时 | `(value)` |
+| update:value | 值变化（v-model） | `(value: string \| string[] \| undefined)` |
+
+#### 用法
+
+```vue
+<template>
+  <JAutoComplete
+    v-model:value="value"
+    :options="[{ label: '设备A', value: 'device-a' }]"
+    multiple
+    placeholder="输入或选择"
+  />
+</template>
+```
+
+#### Rules
+
+- 单选模式下输入框中未命中任何选项的值，会在 `select` / `blur` 时自动追加为自定义选项。
+- 匹配逻辑同时支持 `value` 与 `searchKey` 命中的字段（含 `label`），默认大小写敏感、去除首尾空格后比较。
+- `multiple` 模式下使用 `Select` 的 `tags` 模式，选项与自定义值合并展示、按值去重。
+- 其余 props（如 `placeholder`、`disabled`、`allowClear`）直接透传给底层组件，`allowClear` 默认开启。

package/es/BadgeStatus/BadgeStatus.md

@@ -0,0 +1,37 @@
+### BadgeStatus
+
+状态徽标组件，将业务状态值（如 `success` / `error` / 数字）映射为 Ant Design `Badge` 的颜色徽标。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| text | 徽标文本 | `string` | - |
+| status | 状态值，作为 `statusNames` 的键 | `string \| number` | `'default'` |
+| statusNames | 状态值 → 语义色映射表，支持自定义任意业务状态 | `Record<string, string>` | `{ success, warning, error, default }` |
+
+#### 用法
+
+```vue
+<template>
+  <JBadgeStatus :status="row.status" :text="row.statusText" />
+</template>
+```
+
+自定义状态映射：
+
+```vue
+<template>
+  <JBadgeStatus
+    status="1"
+    text="启用"
+    :status-names="{ 1: 'success', 0: 'error' }"
+  />
+</template>
+```
+
+#### Rules
+
+- 颜色取自内置语义色板：`success`(绿) / `warning`(橙) / `error`(红) / `processing`(蓝) / `default`(灰)，未命中的状态回退为 `default`。
+- `statusNames` 中的值使用语义色名，组件内部通过 `getHexColor` 转为带透明度的 `rgba` 色（默认透明度 0.1）。
+- `text` 为空时仅显示色点，不渲染文字。

package/es/CardSelect/CardSelect.md

@@ -0,0 +1,56 @@
+### CardSelect
+
+卡片式选择组件，以网格布局渲染一组卡片供单选或多选，可自定义卡片内容。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value | 当前选中值，可用 `v-model:value` | `string \| string[]` | - |
+| options | 选项列表 | `{ value, label, describe?, disabled? }[]` | `[]` |
+| multiple | 是否多选 | `boolean` | `false` |
+| disabled | 整体禁用 | `boolean` | `false` |
+| column | 网格列数（仅 `layout="horizontal"` 生效） | `number` | `3` |
+| layout | 布局方向：`horizontal` / `vertical` | `string` | `'horizontal'` |
+| itemLayout | 卡片内部布局方向：`horizontal` / `vertical` | `string` | `'horizontal'` |
+
+#### 事件
+
+| 事件 | 说明 | 回调参数 |
+| --- | --- | --- |
+| select | 选中时 | `(value, node)`；多选时为 `(values: string[], nodes)` |
+| change | 值变化时 | 同上 |
+| update:value | 值变化（v-model） | `(value)` |
+
+#### 插槽
+
+| 名称 | 说明 | 作用域参数 |
+| --- | --- | --- |
+| itemRender | 自定义卡片内容 | `{ node }` 当前选项 |
+
+#### 用法
+
+```vue
+<template>
+  <JCardSelect
+    v-model:value="value"
+    :options="options"
+    :column="3"
+    multiple
+  />
+</template>
+
+<script setup lang="ts">
+const options = [
+  { value: '1', label: '基础版', describe: '适合小规模接入' },
+  { value: '2', label: '专业版', describe: '适合中等规模接入' },
+]
+</script>
+```
+
+#### Rules
+
+- 多选模式下通过 `multiple` 属性区分；单选时 `value` 为字符串，多选时为字符串数组。
+- `vertical` 布局下 `column` 不生效（强制 1 列）。
+- 选项项可单独设置 `disabled` 禁用，优先于全局 `disabled`。
+- 选中变化会同步通知 Form 上下文（`Form.useInjectFormItemContext`），与表单校验联动。

package/es/CheckButton/CheckButton.md

@@ -0,0 +1,37 @@
+### CheckButton
+
+选择按钮组，以按钮形式呈现多选选项，可单独使用或与 `a-checkbox-group` 组合使用。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| multiple | 多选 | `boolean` | `false` |
+| disabled | 失效状态 | `boolean` | `false` |
+| value | 与 CheckboxGroup 组合使用时的值 | `boolean \| string \| number` | - |
+| options | 选择项 | `{ label: string; value: string; disabled?: boolean }[]` | `[]` |
+| class | 类名 | `string` | - |
+| style | CSS 样式 | `CSSProperties` | `{}` |
+
+#### 事件
+
+| 事件 | 说明 | 回调参数 |
+| --- | --- | --- |
+| change | 变化时回调 | `(keys: string \| string[], nodes: any[])` |
+
+#### 用法
+
+```vue
+<template>
+  <JCheckButton
+    v-model:value="value"
+    :options="[{ label: '在线', value: 'online' }, { label: '离线', value: 'offline' }]"
+  />
+</template>
+```
+
+#### Rules
+
+- `options` 中的每项可单独设置 `disabled`。
+- `multiple` 决定单选还是多选，单选时 `change` 返回单个值。
+- 该组件数据录入语义为"选择"，与表单组件（CheckboxGroup）组合使用时通过 `value` 对接。

package/es/ConfigProvider/ConfigProvider.md

@@ -0,0 +1,40 @@
+### ConfigProvider
+
+全局配置 Provider，为 JetLinks 组件体系提供统一的应用级配置与国际化上下文，同时透传 ant-design-vue `ConfigProvider` 的能力。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| IconConfig | 全局 Icon 配置（如 iconfont `scriptUrl`） | `object` | `{}` |
+| MapConfig | 全局地图配置 | `object` | `{}` |
+| SearchConfig | 全局搜索组件配置 | `object` | `{}` |
+| PermissionButtonConfig | 全局权限按钮配置（如自定义 `components`） | `object` | `{}` |
+| FullPageConfig | 全屏页面容器配置（如 `reduceHeight`） | `object` | `{}` |
+| TableConfig | ProTable 全局配置 | `object` | `{}` |
+| componentsLocale | 组件文案语言包 | `object` | 内置 `zh-CN` |
+| 其余 | 透传 ant-design-vue `ConfigProvider` props（如 `locale`、`theme`） | - | - |
+
+#### 插槽
+
+| 名称 | 说明 |
+| --- | --- |
+| default | 应用内容 |
+| renderEmpty | 自定义全局空状态渲染（默认使用 `JEmpty`） |
+
+#### 用法
+
+```vue
+<template>
+  <JConfigProvider :locale="zhCN" :theme="{ token: { colorPrimary: '#1677ff' } }">
+    <router-view />
+  </JConfigProvider>
+</template>
+```
+
+#### Rules
+
+- 通过 Vue `provide` 注入以下配置，供全组件体系消费：Icon / Map / Search / PermissionButton / FullPage / ProTable（Table）。
+- 空状态统一由内置 `JEmpty` 兜底，可通过 `renderEmpty` 插槽覆盖。
+- 内部自动包装 `JLocaleProvider`，`componentsLocale` 缺省使用内置中文语言包。
+- 兼容 `ConfigProvider.config()` 静态方法（如 `Message` 主题配置）。

package/es/DragModal/DragModal.md

@@ -0,0 +1,47 @@
+### DragModal
+
+可拖拽、可缩放的模态弹窗，替代固定尺寸弹窗用于需要调整视口的场景；支持右下角手柄缩放、标题栏拖拽。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| title | 标题；传 `false` 隐藏标题栏 | `string \| boolean` | `''` |
+| width | 初始宽度（px） | `number` | `400` |
+| height | 初始高度（px） | `number` | `100` |
+| dragRang | 最小缩放尺寸 `[最小宽, 最小高]`（px） | `number[] \| number` | `[400, 200]` |
+| bodyStyle | 内容区自定义样式 | `object` | `{}` |
+| footer | 是否显示底部按钮区；传 `false` 隐藏 | `boolean` | `true` |
+
+#### 事件
+
+| 事件 | 说明 | 回调参数 |
+| --- | --- | --- |
+| cancel | 点击取消 / 关闭按钮 | - |
+| ok | 点击确认按钮 | - |
+| visibleChange | 可见状态变化 | `(visible: boolean)` |
+| heightChange | 拖动改变高度时 | `(height: number)` |
+
+#### 插槽
+
+| 名称 | 说明 |
+| --- | --- |
+| default | 弹窗内容 |
+| footer | 自定义底部按钮区 |
+
+#### 用法
+
+```vue
+<template>
+  <JDragModal v-model:visible="visible" title="高级筛选" :width="640" :drag-rang="[400, 200]">
+    <div>弹窗内容</div>
+  </JDragModal>
+</template>
+```
+
+#### Rules
+
+- 挂载时自动居中于视口；默认位置 `(right - width) / 2, top + 200`。
+- 拖拽/缩放边界以 `dragRang` 为最小宽高，无法缩小到更小。
+- 高度变化通过 `heightChange` 事件实时上报，便于外部记录位置。
+- 底部默认渲染"取消 / 确认"按钮，文案随 `LocaleProvider` 国际化；关闭与取消均触发 `cancel` + `visibleChange(false)`。

package/es/EditTable/EditTable.md

@@ -0,0 +1,62 @@
+### EditTable
+
+可编辑表格组件，基于虚拟滚动大表（VirtualTable）实现单元格编辑、校验、分组、行内表单、右键菜单与全屏切换，适合大数据的参数/明细录入场景。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| columns | 列配置（ant-design-vue Table columns，支持编辑列） | `array` | `[]` |
+| dataSource | 数据数组 | `array` | `[]` |
+| rowKey | 行主键字段 | `string` | `'id'` |
+| height | 表格高度（px） | `number` | `300` |
+| cellHeight | 行高（px），虚拟滚动按此计算 | `number` | `65` |
+| readonly | 只读模式，内容区覆盖遮罩禁止编辑 | `boolean` | `false` |
+| serial | 序号列配置，`false` 关闭 | `object \| boolean` | `{ width: 70, title: '' }` |
+| searchColumns | 搜索列配置（如 `[{ title: '标识', dataIndex: 'id' }]`） | `array` | 内置 `id` / `name` 两列 |
+| openGroup | 开启分组（表头分组条） | `boolean` | `false` |
+| rowSelection | 行选择配置 | `object` | - |
+| validateRowKey | 是否按行校验 | `boolean` | `false` |
+| disableMenu | 禁用右键菜单 | `boolean` | `true` |
+| 其余 | 透传 ant-design-vue `Table` props（`tableProps()`） | - | - |
+
+#### 事件
+
+| 事件 | 说明 | 回调参数 |
+| --- | --- | --- |
+| editChange | 单元格编辑变化 | - |
+| scrollDown | 滚动到底部 | - |
+| rightMenuClick | 右键菜单点击 | - |
+| searchVisibleChange | 搜索可见性变化 | - |
+| groupDelete / groupEdit | 分组删除 / 编辑 | - |
+
+#### 插槽
+
+| 名称 | 说明 | 作用域参数 |
+| --- | --- | --- |
+| extra | 工具栏扩展区 | `{ isFullscreen, fullScreenToggle }` |
+| bodyExtra | 表格主体底部扩展 | - |
+| `#列dataIndex` | 按列自定义单元格渲染 | `{ column, record, index, visibleIndex }` |
+| 其他插槽 | 透传给内部 VirtualTable | - |
+
+#### 用法
+
+```vue
+<template>
+  <JEditTable
+    v-model:dataSource="dataSource"
+    :columns="columns"
+    :height="400"
+    :open-group="true"
+    @editChange="onEditChange"
+  />
+</template>
+```
+
+#### Rules
+
+- 编辑字段通过 `FormItem` 注册（与 `JEditTable` 同步安装），单元格渲染约定见 `CellRender.vue`。
+- 校验错误按行/分组聚合，`fieldsErrMap` / `fieldsGroupError` 驱动行高亮与提示。
+- 大数据量下基于虚拟滚动（`virtual.itemHeight = cellHeight`，`threshold = height / cellHeight`），请勿关闭。
+- 分组功能需在 `openGroup` 时配合 `rowSelection` 使用，分组操作会同步更新 `dataSource` 的分组标记。
+- 全屏切换通过工具栏 `extra` 插槽暴露的 `fullScreenToggle` 触发，全屏态表格占满可视区。

package/es/EditTable/components/Search/sort.js

@@ -83,8 +83,8 @@ const __sfc_main__ = Object.assign({
     emits: ['click'],
     setup(__props, { emit: __emit }) {
         _useCssVars(_ctx => ({
-            "1787815589145-sortIconColor": (sortIconColor.value),
-            "1787815589145-sortIconActiveColor": (sortIconActiveColor.value)
+            "1787918239736-sortIconColor": (sortIconColor.value),
+            "1787918239736-sortIconActiveColor": (sortIconActiveColor.value)
         }));
         const props = __props;
         const emit = __emit;

package/es/Ellipsis/Ellipsis.md

@@ -0,0 +1,45 @@
+### Ellipsis
+
+文本省略组件，支持单行 / 多行（`lineClamp`）省略，溢出时自动显示 Tooltip 完整内容，也可改为点击展开/收起。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| lineClamp | 多行省略行数；不传则单行省略 | `number \| string` | `1` |
+| tooltip | 是否显示完整内容 Tooltip，`false` 关闭；传对象可配置 Tooltip props | `boolean \| object` | `true` |
+| expandTrigger | 展开方式，`'click'` 时点击切换展开/收起 | `string` | - |
+
+#### 插槽
+
+| 名称 | 说明 |
+| --- | --- |
+| default | 需要省略的内容 |
+| tooltip | Tooltip 内的自定义完整内容（默认复用内容本身） |
+
+#### 用法
+
+```vue
+<template>
+  <!-- 单行省略 + hover 显示完整内容 -->
+  <JEllipsis>这是一段很长的描述文字，超出后显示省略号……</JEllipsis>
+
+  <!-- 两行省略 + 点击展开 -->
+  <JEllipsis :line-clamp="2" expand-trigger="click">
+    多行内容，默认截断为两行，点击可在展开/收起间切换。
+  </JEllipsis>
+
+  <!-- 自定义 Tooltip 内容 -->
+  <JEllipsis :tooltip="{ placement: 'bottom' }">
+    <template #tooltip>完整内容详情</template>
+    省略的内容
+  </JEllipsis>
+</template>
+```
+
+#### Rules
+
+- 溢出判定基于 `scrollHeight > offsetHeight` 动态计算，未溢出时不弹 Tooltip、不出现省略号。
+- `lineClamp` 使用 `-webkit-line-clamp` 实现，需要 WebKit/Blink 内核支持。
+- `expandTrigger="click"` 时追加 pointer 光标样式；展开后不再触发 Tooltip。
+- 其余属性（class / style 等）自动透传到内容容器。

package/es/Empty/Empty.md

@@ -0,0 +1,34 @@
+### Empty
+
+空状态组件，内置 JetLinks 空数据插画与默认文案（可国际化），透传 ant-design-vue `Empty` 全部能力。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| description | 空状态描述文案 | `string` | 语言包默认（如"暂无数据"） |
+| image | 插画图片地址或自定义插画 | `string` | 内置 NoData 插画 |
+| imageStyle | 插画样式 | `CSSProperties` | `{ height: '60px' }` |
+| 其余 | 透传 ant-design-vue `Empty` props | - | - |
+
+#### 插槽
+
+| 名称 | 说明 |
+| --- | --- |
+| default | 自定义空状态内容（替代插画 + 文案） |
+| 其他具名插槽 | 透传给 ant-design-vue `Empty` |
+
+#### 用法
+
+```vue
+<template>
+  <JEmpty description="暂未接入设备，先创建一个产品再添加设备" />
+</template>
+```
+
+#### Rules
+
+- 未传 `description` 时取 `LocaleProvider` 语言包中的默认文案。
+- 组件自带包裹 `LocaleProvider`，可独立使用。
+- 默认 `imageStyle` 高度 60px，自定义插画时按需覆盖。
+- 描述文案颜色为 `#b3b3b3`、14px，由组件内联样式控制。

package/es/FullPage/FullPage.md

@@ -0,0 +1,31 @@
+### FullPage
+
+全屏页面容器，自动测量容器顶部偏移并计算 `minHeight`，使内容区撑满剩余视口高度，背景使用主题容器色。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| reduceHeight | 视口高度缩减量（px），顶部还有固定工具条时设置 | `number` | 由 `ConfigProvider` 的 `FullPageConfig` 注入，默认 `24` |
+
+#### 插槽
+
+| 名称 | 说明 |
+| --- | --- |
+| default | 页面内容 |
+
+#### 用法
+
+```vue
+<template>
+  <JFullPage>
+    <div>内容区自动撑满剩余高度</div>
+  </JFullPage>
+</template>
+```
+
+#### Rules
+
+- 通过 `useElementBounding` 实时测量容器 `top`，滚动时高度自动跟随调整。
+- `reduceHeight` 可在 `JConfigProvider` 的 `FullPageConfig` 中全局配置，组件 props 不直接暴露时优先使用全局注入值。
+- 背景色取自 ant-design-vue 主题 token 的 `colorBgContainer`。

package/es/Icon/Icon.md

@@ -0,0 +1,33 @@
+### Icon
+
+图标组件（注册名 `AIcon`），统一承载 ant-design-vue 图标与 iconfont 自定义图标；按 `type` 自动路由到对应图标源。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| type | 图标名，优先匹配 `@ant-design/icons-vue` 导出；未匹配时走 iconfont | `string` | - |
+| scriptUrl | iconfont 的 script 地址（含 `//at.alicdn.com/...` 前缀），优先级高于全局配置 | `string` | 全局 `IconConfig.scriptUrl` |
+| class | 图标类名 | `string` | - |
+| style | 图标样式（透传） | `CSSProperties` | - |
+
+#### 事件
+
+| 事件 | 说明 |
+| --- | --- |
+| click | 点击图标 |
+
+#### 用法
+
+```vue
+<template>
+  <AIcon type="CloseOutlined" />
+  <AIcon type="icon-device" script-url="//at.alicdn.com/t/c/font_xxx.js" />
+</template>
+```
+
+#### Rules
+
+- `type` 命中 `@ant-design/icons-vue` 导出名时直接渲染 Ant 图标；否则渲染 iconfont 图标，因此两种图标体系可混用。
+- `scriptUrl` 未在组件上传入时，回退到 `JConfigProvider` 的 `IconConfig.scriptUrl` 全局配置。
+- 未配置任何 scriptUrl 且 type 不匹配时渲染空节点，不报错。

package/es/LocaleProvider/LocaleProvider.md

@@ -0,0 +1,25 @@
+### LocaleProvider
+
+语言包 Provider，向组件树提供统一的文案语言包（默认中文），供 `useLocaleReceiver` 消费。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| locale | 组件文案语言包对象，按组件名分组 | `Record<string, any>` | 内置 `zh-CN` |
+
+#### 用法
+
+```vue
+<template>
+  <JLocaleProvider :locale="enUS">
+    <app-content />
+  </JLocaleProvider>
+</template>
+```
+
+#### Rules
+
+- 通过 provide `componentLocaleData` 向下注入；子组件用 `useLocaleReceiver('组件名')` 获取对应分组的文案。
+- `locale` 变化时深监听并重新注入。
+- 通常无需单独使用：`JConfigProvider` 内部已包含本组件，直接配 `componentsLocale` 即可。

package/es/LocaleReciver/LocaleReciver.md

@@ -0,0 +1,42 @@
+### LocaleReceiver
+
+国际化接收 Hook（目录名 `LocaleReciver`），在组合式 API 中读取 `JLocaleProvider` 注入的语言包片段，供组件消费多语言文案。
+
+#### 签名
+
+```ts
+useLocaleReceiver<T extends string>(
+  componentName: T,
+  defaultLocale?: Record<string, any>[T] | Function | ComputedRef,
+  propsLocale?: Ref<Record<string, any>[T]>,
+): [ComputedRef<Record<string, any>[T]>]
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| componentName | 语言包分组名（如 `'DragModal'`、`'Empty'`），对应 `locale/zh-CN` 中的键 |
+| defaultLocale | 兜底文案，可传对象 / 函数 / 响应式值 |
+| propsLocale | 组件 props 上的语言覆盖 |
+
+#### 返回值
+
+| 返回值 | 说明 |
+| --- | --- |
+| `[componentLocale]` | 响应式文案对象：`defaultLocale ⊕ 上下文中 componentName 分组 ⊕ propsLocale`（后者覆盖前者） |
+
+#### 用法
+
+```vue
+<script setup lang="ts">
+import { useLocaleReceiver } from '../LocaleReciver'
+
+const [contextLocale] = useLocaleReceiver('DragModal')
+// contextLocale.value.cancel / contextLocale.value.confirm
+</script>
+```
+
+#### Rules
+
+- 未注入 `JLocaleProvider` 时回退到内置 `zh-CN` 语言包，组件可安全单独使用。
+- 三个来源合并顺序：`defaultLocale` → 上下文语言包 → `propsLocale`，越靠后优先级越高。
+- 该文件是 hook 而非组件，不参与 `app.component` 注册。

package/es/Markdown/Markdown.md

@@ -0,0 +1,40 @@
+### Markdown
+
+Markdown 渲染组件，基于 `markdown-it` 并预装常用插件（锚点、任务列表、脚注、TOC、代码高亮、上下标、删除线等）。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| source | Markdown 源文本 | `string` | `''` |
+| html | 是否渲染内联 HTML | `boolean` | `false` |
+| breaks | 换行符是否转为 `<br>` | `boolean` | `false` |
+| linkify | 自动识别链接 | `boolean` | `false` |
+| typographer | 排版化（引号、破折号等） | `boolean` | `false` |
+| quotes | 排版引号字符 | `string` | `'"“”‘’'` |
+| xhtmlOut | 输出 XHTML 兼容标签 | `boolean` | `false` |
+| langPrefix | 代码块语言类名前缀 | `string` | `'language-'` |
+| anchor | 锚点插件配置（`markdown-it-anchor`） | `object` | `{}` |
+| highlight | 代码高亮配置（`markdown-it-highlightjs`） | `object` | `{}` |
+| tasklists | 任务列表配置（`markdown-it-task-lists`） | `object` | `{}` |
+| toc | 目录插件配置（`markdown-it-toc-done-right`） | `object` | `{}` |
+| emoji | 表情插件配置 | `object` | `{}` |
+| plugins | 额外插件数组 `{ plugin, options }[]` | `array` | `[]` |
+
+#### 用法
+
+```vue
+<template>
+  <JMarkdown :source="markdownText" />
+</template>
+
+<script setup lang="ts">
+const markdownText = '# 设备说明书\n\n- [x] 支持任务列表\n- [ ] 待办项'
+</script>
+```
+
+#### Rules
+
+- 预装插件：abbr / anchor / deflist / footnote / highlightjs / ins / mark / sub / sup / task-lists / toc。
+- 额外插件通过 `plugins` 传入 `{ plugin, options }`，渲染时按顺序 `markdown.use`。
+- 渲染输出包在高度 100% 的容器中；`source` 变化时自动重新渲染（`onUpdated`）。

package/es/PermissionButton/PermissionButton.md

@@ -0,0 +1,40 @@
+### PermissionButton
+
+权限按钮组件，根据权限码自动控制按钮的可用性：无权限时禁用并提示，有确认需求时内置 Popconfirm / Modal 二次确认，并支持 Tooltip 与自定义确认组件。
+
+#### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| hasPermission | 权限码；`true` 或 `undefined` 视为有权限，支持字符串 / 数组（任一命中） | `string \| string[] \| boolean` | `undefined` |
+| noPermissionTitle | 无权限时 Tooltip 文案 | `string` | 语言包（默认"暂无权限"） |
+| popConfirm | 点击后的二次确认配置（ant-design-vue `PopconfirmProps`，可用 `onConfirm` / `onCancel`） | `object` | - |
+| popConfirmBefore | 点击时先执行的异步函数，返回值合并进 `popConfirm`（可用于动态确认内容） | `Function` | - |
+| tooltip | 按钮 Tooltip 配置（`TooltipProps`） | `object` | - |
+| style | 按钮样式 | `CSSProperties` | - |
+| 其余 | 透传 ant-design-vue `Button` props（`buttonProps()`，去除 `icon`） | - | - |
+
+#### 插槽
+
+| 名称 | 说明 |
+| --- | --- |
+| default | 按钮文字 / 内容 |
+| icon | 按钮图标 |
+| button | 完全自定义按钮节点（跳过内部 Button 渲染，仅保留权限逻辑） |
+
+#### 用法
+
+```vue
+<template>
+  <JPermissionButton has-permission="device:delete" danger :pop-confirm="{ title: '确认删除该设备？' }">
+    删除设备
+  </JPermissionButton>
+</template>
+```
+
+#### Rules
+
+- 权限判定基于 `usePermission`（来自 `@jetlinks-web/hooks`）；`hasPermission` 传 `true` 或省略时恒有权限。
+- 有权限且配置 `popConfirm` 时：优先使用 `JConfigProvider` 中 `PermissionButtonConfig.components` 自定义确认组件，否则回退 `Modal.confirm`。
+- 无权限时不渲染原始按钮逻辑，改为渲染带提示的禁用态（Tooltip 包裹）。
+- `disabled` 透传自 Button props，与权限判定叠加。