@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/watermark/watermark.meta.md

@@ -4,10 +4,11 @@ name: Watermark
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 水印
 ---
 
-# Watermark
+# Watermark 水印
 
 水印 — antd 独有补足。**等价 antd `Watermark`**(v5.1+)。在容器内部生成重复平铺的 SVG 水印(文字 / 图片),用于敏感页面 / 内部文档 / 演示场景。
 
@@ -24,33 +25,41 @@ package: "@teamix-evo/ui"
 - 通知 / 提示语 → `Alert` / `Tag`(语义不一样)
 - 装饰背景图 → CSS `background-image`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `content` | `string \| string[]` | – | – | 水印文字(antd `content` 并集) — 单行字符串或多行字符串数组。 |
-| `image` | `string` | – | – | 水印图片(antd `image` 并集) — 优先级高于 `content`。建议透明 PNG / SVG。 |
-| `width` | `number` | `120` | – | 单块水印宽度(px)。 |
-| `height` | `number` | `64` | – | 单块水印高度(px)。 |
-| `rotate` | `number` | `-22` | – | 水印旋转角度(deg)。 |
-| `fontSize` | `number` | `14` | – | 字体大小(px)。 |
-| `fontColor` | `string` | `"rgba(0,0,0,0.15)"` | – | 字体颜色(支持 rgba 设置透明度)。 |
-| `fontWeight` | `'normal' \| 'medium' \| 'bold'` | `"normal"` | – | 字体粗细。 |
-| `gapX` | `number` | `80` | – | 水印块之间的水平间距(px)。 |
-| `gapY` | `number` | `80` | – | 水印块之间的垂直间距(px)。 |
+
+| 名称         | 类型                             | 默认值               | 必填 | 说明                                                                     |
+| ------------ | -------------------------------- | -------------------- | ---- | ------------------------------------------------------------------------ |
+| `content`    | `string \| string[]`             | –                    | –    | 水印文字(antd `content` 并集) — 单行字符串或多行字符串数组。             |
+| `image`      | `string`                         | –                    | –    | 水印图片(antd `image` 并集) — 优先级高于 `content`。建议透明 PNG / SVG。 |
+| `width`      | `number`                         | `120`                | –    | 单块水印宽度(px)。                                                       |
+| `height`     | `number`                         | `64`                 | –    | 单块水印高度(px)。                                                       |
+| `rotate`     | `number`                         | `-22`                | –    | 水印旋转角度(deg)。                                                      |
+| `fontSize`   | `number`                         | `14`                 | –    | 字体大小(px)。                                                           |
+| `fontColor`  | `string`                         | `"rgba(0,0,0,0.15)"` | –    | 字体颜色(支持 rgba 设置透明度)。                                         |
+| `fontWeight` | `'normal' \| 'medium' \| 'bold'` | `"normal"`           | –    | 字体粗细。                                                               |
+| `gapX`       | `number`                         | `80`                 | –    | 水印块之间的水平间距(px)。                                               |
+| `gapY`       | `number`                         | `80`                 | –    | 水印块之间的垂直间距(px)。                                               |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add watermark` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
 _无 — 本组件不依赖任何 npm 包。_
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/watermark/watermark.stories.tsx

@@ -9,7 +9,7 @@ const meta: Meta<typeof Watermark> = {
     docs: {
       description: {
         component:
-          '水印 — 容器内重复平铺的 SVG 文字 / 图片水印(内部敏感页面 / 文档预览 / demo 录屏)。前端视觉效果,不作为安全防护。等价 antd `Watermark`(v5.1+)。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '水印 — 容器内重复平铺的 SVG 文字 / 图片水印（内部敏感页面 / 文档预览 / demo 录屏）。前端视觉效果，不作为安全防护。等价 antd `Watermark`（v5.1+）。',
       },
     },
   },
@@ -72,7 +72,9 @@ export const ColoredAndDense: Story = {
       className="h-72 w-full rounded-md border bg-card p-6"
     >
       <h3 className="mb-3 text-lg font-semibold">红色密集水印</h3>
-      <p className="text-sm text-muted-foreground">配合 fontWeight / gap / rotate 调整视觉强度。</p>
+      <p className="text-sm text-muted-foreground">
+        配合 fontWeight / gap / rotate 调整视觉强度。
+      </p>
     </Watermark>
   ),
 };

package/src/components/watermark/watermark.tsx

@@ -112,6 +112,7 @@ const Watermark = React.forwardRef<HTMLDivElement, WatermarkProps>(
       height = 64,
       rotate = -22,
       fontSize = 14,
+      // eslint-disable-next-line teamix-evo/no-color-literal -- Watermark renders to canvas; CSS var() not supported in canvas API. Default value matches --overlay-watermark token.
       fontColor = 'rgba(0,0,0,0.15)',
       fontWeight = 'normal',
       gapX = 80,