x-next 1.13.0 → 1.15.0

package/AI_USAGE/components/watermark-api.md

@@ -0,0 +1,87 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# Watermark 完整公开 API
+
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
+
+从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
+
+## Watermark API
+
+公开声明：`dist/components/watermark/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| content | 水印文字内容，数组表示多行文字 | undefined &#124; string &#124; string[] | 否 | undefined |
+| image | 图片水印地址，支持 base64 | undefined &#124; string | 否 | undefined |
+| width | 水印宽度，未设置时按内容计算 | undefined &#124; number | 否 | undefined |
+| height | 水印高度，未设置时按内容计算 | undefined &#124; number | 否 | undefined |
+| gap | 水印之间的间距 | undefined &#124; [number, number] | 否 | 工厂函数（每个实例初始化；有效值见行为说明） |
+| offset | 水印距离容器左上角的偏移量，默认是 gap / 2 | undefined &#124; [number, number] | 否 | undefined |
+| rotate | 水印旋转角度 | undefined &#124; number | 否 | -22 |
+| font | 水印字体样式 | undefined &#124; WatermarkFont | 否 | undefined |
+| zIndex | 水印层级 | undefined &#124; number | 否 | 6 |
+| alpha | 水印透明度 | undefined &#124; number | 否 | 1 |
+| antiTamper | 是否开启水印防篡改 | undefined &#124; false &#124; true | 否 | true |
+| grayscale | 是否生成灰阶水印 | undefined &#124; false &#124; true | 否 | false |
+| repeat | 是否重复水印 | undefined &#124; false &#124; true | 否 | true |
+| staggered | 重复水印时是否错位排列 | undefined &#124; false &#124; true | 否 | true |
+
+### Events
+
+未声明组件 emits；原生事件与包装透传按本页用法核实。
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| default | 需要添加水印的内容区域 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+interface WatermarkFont {
+    /**
+     * @zh 字体颜色
+     * @en Font color
+     */
+    color?: string;
+    /**
+     * @zh 字体大小
+     * @en Font size
+     */
+    fontSize?: number;
+    /**
+     * @zh 字体类型
+     * @en Font family
+     */
+    fontFamily?: string;
+    /**
+     * @zh 字体样式
+     * @en Font style
+     */
+    fontStyle?: 'none' | 'normal' | 'italic' | 'oblique';
+    /**
+     * @zh 字体对齐方式
+     * @en Font align
+     */
+    textAlign?: 'start' | 'end' | 'left' | 'right' | 'center';
+    /**
+     * @zh 字体粗细
+     * @en Font weight
+     */
+    fontWeight?: 'normal' | 'bold' | 'bolder' | 'lighter' | number;
+}
+
+type WatermarkGap = [number, number];
+```
+
+
+返回 [Watermark 用法](./watermark.md)。

package/AI_USAGE/components/watermark.md

@@ -0,0 +1,200 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# Watermark AI 使用
+
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
+
+先读 [通用接入](../core.md)。公开导出：`Watermark`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./watermark-api.md)，包含本组件族全部子组件和别名。
+
+按需样式：`x-next/style/watermark`（包含 base.css、watermark.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
+
+## 场景用法
+
+以下示例从本地 `src/docs/components/watermark.md` 显式导入到独立 AI 源，补齐局部注册、状态和样式后进行严格模板检查。上方已核验行为优先；原始 prop 默认值、包装透传和示例业务适配分别查 [完整 API](./watermark-api.md) 与场景说明。类型通过不代表所有散文和交互已验证。
+
+### 用途与选型
+
+用于给页面或指定内容区域添加不可交互遮挡的水印，适合版权标识、内部资料标记、截图追踪等场景。
+
+
+### 何时使用
+
+- 页面、卡片、表格或详情区域需要展示版权、来源或用户标识。
+- 需要用浅色重复文字或图片降低截图外泄风险。
+- 希望水印不影响区域内按钮、链接、输入框等交互。
+
+
+### 基础用法
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Watermark, Space, Button } from 'x-next';
+
+</script>
+<template>
+<Watermark content="X-Next">
+    <section class="panel">
+      <h4>项目日报</h4>
+      <p>水印层不会阻断内部按钮、链接或输入框交互。</p>
+      <Space>
+        <Button size="small">查看详情</Button>
+        <Button size="small" type="primary">导出</Button>
+      </Space>
+    </section>
+  </Watermark>
+</template>
+```
+
+### 多行文字
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Watermark } from 'x-next';
+
+</script>
+<template>
+<Watermark :content="['X-Next', 'Confidential']">
+    <section class="panel">
+      <h4>多行水印</h4>
+      <p>通过字符串数组设置多行内容。</p>
+    </section>
+  </Watermark>
+</template>
+```
+
+### 图片水印
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Watermark } from 'x-next';
+const imageWatermark = 'data:image/svg+xml;utf8,...';
+</script>
+<template>
+<Watermark :image="imageWatermark" :width="120" :height="48" :gap="[72, 72]">
+    <section class="panel">
+      <h4>图片水印</h4>
+      <p>适合使用品牌标识、图章或自定义 SVG / base64 图片作为水印。</p>
+    </section>
+  </Watermark>
+</template>
+```
+
+### 自定义参数
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Watermark } from 'x-next';
+import { ref } from 'vue';
+
+const watermarkText = ref('X-Next');
+const watermarkRotate = ref(-22);
+const watermarkAlpha = ref(0.8);
+const watermarkFont = ref({
+  color: 'rgba(15, 118, 110, 0.18)',
+  fontSize: 18,
+  fontWeight: 600,
+});
+</script>
+<template>
+<Watermark
+    :content="watermarkText"
+    :gap="[80, 80]"
+    :rotate="watermarkRotate"
+    :alpha="watermarkAlpha"
+    :font="watermarkFont"
+  >
+    <section class="panel">可配置水印</section>
+  </Watermark>
+</template>
+```
+
+### 局部交互
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Watermark, Input, Button } from 'x-next';
+
+</script>
+<template>
+<Watermark content="Editable">
+    <section class="panel">
+      <Input placeholder="输入内容仍可聚焦" />
+      <Button type="primary">保存</Button>
+    </section>
+  </Watermark>
+</template>
+```
+
+### 指令用法
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { vWatermark } from 'x-next';
+
+</script>
+<template>
+<div v-watermark="'内部资料'" class="panel">
+    默认指令水印
+  </div>
+</template>
+```
+
+### 指令配置
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { vWatermark } from 'x-next';
+
+</script>
+<template>
+<div
+    v-watermark="{
+      content: ['Directive', 'X-Next'],
+      gap: [88, 72],
+      rotate: -18,
+      alpha: 0.75,
+      font: { color: 'rgba(190, 24, 93, 0.16)', fontSize: 16, fontWeight: 700 }
+    }"
+    class="panel"
+  >
+    给已有 div 添加水印
+  </div>
+</template>
+```
+
+### 防篡改
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Watermark, Button } from 'x-next';
+function removeWatermarkLayer() {
+  document.querySelector('.tamper-demo .x-watermark--layer')?.remove();
+}
+</script>
+<template>
+<Watermark class="tamper-demo" content="Anti Tamper">
+    <section class="panel">
+      <Button @click="removeWatermarkLayer">删除水印层</Button>
+    </section>
+  </Watermark>
+</template>
+```
+
+### 交互说明
+
+- 水印层使用 `pointer-events: none`，不会阻断默认插槽中的按钮、链接和输入控件。
+- `v-watermark` 适合给已有 DOM 直接添加水印；全量安装时会自动注册，也可以按需导入 `vWatermark`。
+- `content` 和 `image` 都为空时不绘制水印，只保留内容容器。
+- 图片水印会通过 canvas 绘制，跨域图片需要服务端允许 CORS；无法读取的图片不会影响默认插槽内容。
+- 默认开启防篡改监听；当水印层被删除或样式被改写时会自动重绘。
+
+
+
+返回 [AI 索引](../index.md)。先查本页与 [本地 API](./watermark-api.md)；需要更深类型时查 [公开组件导航](../catalog.md)，不默认上网查找本包用法。

package/AI_USAGE/core.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 通用接入
 
-适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 ```sh
 npm install x-next

package/AI_USAGE/index.md

@@ -1,9 +1,9 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 按需入口
 
-适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
-AI 专用资料，与文档站独立分发。先读 [core.md](./core.md)，再只读本任务需要的组件页；每页提供真实约束、公共导出、模型/事件/样式和完整 Vue SFC。代码与同版本完整手册同源并严格检查；本索引不塞入完整示例。
+AI 专用资料，与文档站独立分发。先读 [core.md](./core.md)，再只读本任务需要的组件页；各页含场景 SFC，完整 API 位于对应 `*-api.md`。全部公开组件与服务有本地导航，查本包用法优先包内文件，不默认网络搜索。
 
 用 `require.resolve('x-next/AI_USAGE/index.md')` 定位本页，组件例如 `require.resolve('x-next/AI_USAGE/components/select.md')`。升级或本地 dist 重建后重新核对；文件不会被所有工具自动加载，消费项目须合并 [AI_CODING.md](../AI_CODING.md) 中的 AGENTS 建议。
 
@@ -36,17 +36,46 @@ AI 专用资料，与文档站独立分发。先读 [core.md](./core.md)，再
 | Pagination | [pagination](./components/pagination.md) | v-model:current、v-model:page-size | `x-next/style/pagination` |
 | Steps | [steps](./components/steps.md) | v-model:current | `x-next/style/steps` |
 | Tabs | [tabs](./components/tabs.md) | v-model:active-key | `x-next/style/tabs` |
+| TreeSelect | [tree-select](./components/tree-select.md) | v-model、v-model:input-value、v-model:popup-visible、v-model:expanded-keys | `x-next/style/tree-select` |
 | Empty | [empty](./components/empty.md) | 无 | `x-next/style/empty` |
 | Upload | [upload](./components/upload.md) | v-model:file-list | `x-next/style/upload` |
 | BarChart | [bar-chart](./components/bar-chart.md) | 无 | `x-next/style/bar-chart` |
 | LineChart | [line-chart](./components/line-chart.md) | 无 | `x-next/style/line-chart` |
 | PieChart | [pie-chart](./components/pie-chart.md) | 无 | `x-next/style/pie-chart` |
+| Draggable | [draggable](./components/draggable.md) | v-model | `x-next/style/base.css` |
+| Drawer | [drawer](./components/drawer.md) | v-model | `x-next/style/drawer` |
+| Form | [form](./components/form.md) | 无 | `x-next/style/form` |
+| Grid | [grid](./components/grid.md) | 无 | `x-next/style/grid` |
+| Heatmap | [heatmap](./components/heatmap.md) | 无 | `x-next/style/heatmap` |
+| Icon | [icon](./components/icon.md) | 无 | `x-next/style/base.css` |
+| Image | [image](./components/image.md) | v-model:preview-visible | `x-next/style/image` |
+| InputNumber | [input-number](./components/input-number.md) | v-model | `x-next/style/form-input-number` |
+| InputTag | [input-tag](./components/input-tag.md) | v-model、v-model:input-value | `x-next/style/form-input-tag` |
+| Layout | [layout](./components/layout.md) | 无 | `x-next/style/layout` |
+| Link | [link](./components/link.md) | 无 | `x-next/style/link` |
+| Menu | [menu](./components/menu.md) | v-model:selected-keys、v-model:open-keys、v-model:collapsed | `x-next/style/menu` |
+| Network | [network](./components/network.md) | 无 | `x-next/style/network` |
+| Popup | [popup](./components/popup.md) | v-model:popup-visible | `x-next/style/popup` |
+| ResizeBox | [resize-box](./components/resize-box.md) | v-model:width、v-model:height | `x-next/style/resize-box` |
+| Scrollbar | [scrollbar](./components/scrollbar.md) | 无 | `x-next/style/scrollbar-v2` |
+| Skeleton | [skeleton](./components/skeleton.md) | 无 | `x-next/style/skeleton` |
+| Space | [space](./components/space.md) | 无 | `x-next/style/space` |
+| Spin | [spin](./components/spin.md) | 无 | `x-next/style/spin` |
+| Table | [table](./components/table.md) | v-model:selected-keys、v-model:expanded-keys | `x-next/style/table` |
+| Tag | [tag](./components/tag.md) | v-model:visible、v-model:checked | `x-next/style/tag` |
+| TimeRangeSelector | [time-range-selector](./components/time-range-selector.md) | v-model | `x-next/style/time-range-selector` |
+| Timeline | [timeline](./components/timeline.md) | 无 | `x-next/style/timeline` |
+| Tooltip | [tooltip](./components/tooltip.md) | v-model:popup-visible | `x-next/style/tooltip` |
+| TrendChart | [trend-chart](./components/trend-chart.md) | 无 | `x-next/style/base.css` |
+| Trigger | [trigger](./components/trigger.md) | v-model:popup-visible | `x-next/style/trigger` |
+| Watermark | [watermark](./components/watermark.md) | 无 | `x-next/style/watermark` |
 
-## 组合和未收录能力
+## 组合和公共导航
 
 - [按需表单完整 SFC](./recipes/form-on-demand.md)：Input + Textarea + Select + Checkbox + ConfigProvider。
-- 编辑弹窗：读 Dialog、Input、Select；需要 Form 时再查 [公开组件导航](./catalog.md) 中的类型与组件文档。不要因手册缺节就判断没有组件。
-- [公开组件/服务导航](./catalog.md)：更多组件、子组件、别名和声明定位；精选覆盖 30 个契约，不代表全部导出。
-- [完整兼容手册](../AI_USAGE.md)：旧用法保留；新任务不默认读取全文。
+- 编辑弹窗：读 Dialog、Form、Input、Select；列表查 Table，子组件和服务查 [公开导航](./catalog.md)。
+- [图表选型](./components/charts.md)、[Boxicons](./components/boxicons.md)、[Finicon](./components/finicon.md)。
+- [公开组件/服务导航](./catalog.md)：58 个组件族、105 个公共导出，含本地 API 和声明。
+- [完整兼容手册](../AI_USAGE.md)：新任务不默认读取全文。
 
-按需读取不能保证模型绝不读多或 API 绝不出错。保留通用规则和组件完整约束，并用严格类型、构建及真实浏览器验证；不以“读取过”代替验收。
+本地资料仍须配合严格类型、构建与真实浏览器验证；若查到缺口，反馈当前安装版本和具体 API，不套用其他库用法。

package/AI_USAGE/recipes/form-on-demand.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # 按需样式与表单接入
 
-适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)，相关组件规则：[config-provider](../components/config-provider.md)、[input](../components/input.md)、[textarea](../components/textarea.md)、[select](../components/select.md)、[checkbox](../components/checkbox.md)。