@yoka-ui/ui 1.0.6 → 1.0.7

package/dist/lib/creative/SkillsWriter/index.js

@@ -0,0 +1,200 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/creative/SkillsWriter/index.tsx
+var SkillsWriter_exports = {};
+__export(SkillsWriter_exports, {
+  default: () => SkillsWriter_default
+});
+module.exports = __toCommonJS(SkillsWriter_exports);
+var import_icons = require("@ant-design/icons");
+var import_antd = require("antd");
+var import_jszip = __toESM(require("jszip"));
+var import_react = __toESM(require("react"));
+var import_index_module = __toESM(require("./index.module.less"));
+var { Text, Title } = import_antd.Typography;
+var { Group: CheckboxGroup } = import_antd.Checkbox;
+var skillsOptions = [
+  {
+    id: "traue",
+    path: ".trae/skills/",
+    label: "Traue",
+    description: "Traue IDE 的 skills 插件目录"
+  },
+  {
+    id: "cursor",
+    path: ".cursor/skills/",
+    label: "Cursor",
+    description: "Cursor IDE 的 skills 插件目录"
+  },
+  {
+    id: "codebuddy",
+    path: ".codebuddy/skills/",
+    label: "CodeBuddy",
+    description: "CodeBuddy 的 skills 插件目录"
+  },
+  {
+    id: "claudeCode",
+    path: ".claude/skills/",
+    label: "Claude Code",
+    description: "Claude Code 的 skills 插件目录"
+  },
+  {
+    id: "qwenCode",
+    path: ".qwen/skills/",
+    label: "Qwen Code",
+    description: "Qwen Code 的 skills 插件目录"
+  },
+  {
+    id: "openAICodex",
+    path: ".codex/skills/",
+    label: "OpenAI Codex",
+    description: "OpenAI Codex 的 skills 插件目录"
+  },
+  {
+    id: "standard",
+    path: ".skills/",
+    label: "标准目录",
+    description: "标准 skills 配置目录"
+  }
+];
+var SkillsWriter = () => {
+  const [selectedIds, setSelectedIds] = (0, import_react.useState)([]);
+  const [loading, setLoading] = (0, import_react.useState)(false);
+  const isSupported = typeof window !== "undefined" && "showDirectoryPicker" in window;
+  const handleCheckboxChange = (checkedIds) => {
+    setSelectedIds(checkedIds);
+  };
+  const selectedSkills = skillsOptions.filter((opt) => selectedIds.includes(opt.id));
+  const createDirectoryHandle = async (baseHandle, pathParts) => {
+    let currentHandle = baseHandle;
+    for (const part of pathParts) {
+      try {
+        currentHandle = await currentHandle.getDirectoryHandle(part, { create: true });
+      } catch {
+        currentHandle = await currentHandle.getDirectoryHandle(part);
+      }
+    }
+    return currentHandle;
+  };
+  const writeFile = async (handle, filePath, content) => {
+    const pathParts = filePath.split("/").filter((p) => p);
+    const fileName = pathParts.pop();
+    const dirHandle = await createDirectoryHandle(handle, pathParts);
+    const fileHandle = await dirHandle.getFileHandle(fileName, { create: true });
+    const writable = await fileHandle.createWritable();
+    await writable.write(content);
+    await writable.close();
+  };
+  const downloadAndExtractSkills = async () => {
+    if (selectedSkills.length === 0) {
+      import_antd.message.error("请至少选择一个工具");
+      return;
+    }
+    if (!("showDirectoryPicker" in window)) {
+      import_antd.message.error("当前浏览器不支持目录选择器");
+      return;
+    }
+    try {
+      const handle = await window.showDirectoryPicker();
+      setLoading(true);
+      const response = await fetch("/skills.zip");
+      if (!response.ok) {
+        throw new Error("下载失败，请稍后重试");
+      }
+      const blob = await response.blob();
+      const zip = await import_jszip.default.loadAsync(blob);
+      const selectedPaths = selectedSkills.map((s) => s.path);
+      const skillsFolderEntry = Object.entries(zip.files).find(
+        ([path]) => path === "yoka-ui" || path.startsWith("yoka-ui/")
+      );
+      if (!skillsFolderEntry) {
+        throw new Error("压缩包中未找到 yoka-ui 目录");
+      }
+      let totalCount = 0;
+      for (const selectedPath of selectedPaths) {
+        const normalizedPath = selectedPath.replace(/^\//, "").replace(/\/$/, "");
+        const pathParts = normalizedPath.split("/");
+        let currentHandle = handle;
+        for (const part of pathParts) {
+          try {
+            currentHandle = await currentHandle.getDirectoryHandle(part, { create: true });
+          } catch {
+            currentHandle = await currentHandle.getDirectoryHandle(part);
+          }
+        }
+        let skillsHandle;
+        try {
+          skillsHandle = await currentHandle.getDirectoryHandle("yoka-ui", { create: true });
+        } catch {
+          skillsHandle = await currentHandle.getDirectoryHandle("yoka-ui");
+        }
+        for (const [filePath, zipEntry] of Object.entries(zip.files)) {
+          if (filePath.startsWith("yoka-ui/")) {
+            const relativePath = filePath.replace("yoka-ui/", "");
+            if (!zipEntry.dir && relativePath) {
+              const content = await zipEntry.async("uint8array");
+              await writeFile(skillsHandle, relativePath, content);
+              totalCount++;
+            }
+          }
+        }
+      }
+      import_antd.message.success(`成功添加 ${totalCount} 个文件到项目`);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+      } else {
+        console.error("添加到项目失败:", err);
+        import_antd.message.error(err instanceof Error ? err.message : "添加到项目失败");
+      }
+    } finally {
+      setLoading(false);
+    }
+  };
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.skillsWriter }, /* @__PURE__ */ import_react.default.createElement(import_antd.Card, { className: import_index_module.default.card }, /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.header }, /* @__PURE__ */ import_react.default.createElement(import_icons.CloudDownloadOutlined, { style: { fontSize: 20, color: "#1890ff" } }), /* @__PURE__ */ import_react.default.createElement(Title, { level: 5, style: { margin: 0, fontSize: 20, fontWeight: 600 } }, "Skills 同步工具")), /* @__PURE__ */ import_react.default.createElement(Text, { type: "secondary", style: { display: "block", marginBottom: 16 } }, "将 YokaUI Skills 同步到本地 IDE 的插件目录中"), /* @__PURE__ */ import_react.default.createElement(
+    CheckboxGroup,
+    {
+      value: selectedIds,
+      onChange: (values) => handleCheckboxChange(values),
+      style: { display: "flex", flexDirection: "column", gap: 8 }
+    },
+    skillsOptions.map((option) => /* @__PURE__ */ import_react.default.createElement(import_antd.Checkbox, { key: option.id, value: option.id, style: { alignItems: "flex-start" } }, /* @__PURE__ */ import_react.default.createElement("div", { style: { display: "flex", flexDirection: "column" } }, /* @__PURE__ */ import_react.default.createElement(import_antd.Space, null, /* @__PURE__ */ import_react.default.createElement(Text, { strong: true }, option.label), /* @__PURE__ */ import_react.default.createElement(Text, { type: "secondary", style: { fontSize: 12 } }, "(", option.path, ")")), /* @__PURE__ */ import_react.default.createElement(Text, { type: "secondary", style: { fontSize: 12, marginTop: 2 } }, option.description))))
+  ), /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.actions }, /* @__PURE__ */ import_react.default.createElement(import_antd.Space, { direction: "vertical", style: { width: "100%" } }, /* @__PURE__ */ import_react.default.createElement(import_antd.Space, null, /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Button,
+    {
+      type: "primary",
+      icon: /* @__PURE__ */ import_react.default.createElement(import_icons.FolderOpenOutlined, null),
+      onClick: downloadAndExtractSkills,
+      loading,
+      disabled: selectedSkills.length === 0 || !isSupported
+    },
+    "同步到本地"
+  ), !isSupported && /* @__PURE__ */ import_react.default.createElement(Text, { type: "warning", style: { fontSize: 12 } }, "需要 HTTPS 或 localhost 环境，请手动下载")), /* @__PURE__ */ import_react.default.createElement(import_antd.Space, null, /* @__PURE__ */ import_react.default.createElement(import_antd.Button, { icon: /* @__PURE__ */ import_react.default.createElement(import_icons.CloudDownloadOutlined, null), href: "/skills.zip", download: true }, "手动下载 skills.zip"), /* @__PURE__ */ import_react.default.createElement(Text, { type: "secondary", style: { fontSize: 12 } }, "解压到对应工具的 skills 目录"))))));
+};
+var SkillsWriter_default = SkillsWriter;
+//# sourceMappingURL=index.js.map

package/dist/lib/creative/SkillsWriter/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/creative/SkillsWriter/index.tsx"],
+  "sourcesContent": ["import { CloudDownloadOutlined, FolderOpenOutlined } from '@ant-design/icons';\nimport { Button, Card, Checkbox, message, Space, Typography } from 'antd';\nimport JSZip from 'jszip';\nimport React, { useState } from 'react';\nimport styles from './index.module.less';\n\nconst { Text, Title } = Typography;\nconst { Group: CheckboxGroup } = Checkbox;\n\n// 确认支持 skills 的工具及其路径\nconst skillsOptions = [\n  {\n    id: 'traue',\n    path: '.trae/skills/',\n    label: 'Traue',\n    description: 'Traue IDE 的 skills 插件目录',\n  },\n  {\n    id: 'cursor',\n    path: '.cursor/skills/',\n    label: 'Cursor',\n    description: 'Cursor IDE 的 skills 插件目录',\n  },\n  {\n    id: 'codebuddy',\n    path: '.codebuddy/skills/',\n    label: 'CodeBuddy',\n    description: 'CodeBuddy 的 skills 插件目录',\n  },\n  {\n    id: 'claudeCode',\n    path: '.claude/skills/',\n    label: 'Claude Code',\n    description: 'Claude Code 的 skills 插件目录',\n  },\n  {\n    id: 'qwenCode',\n    path: '.qwen/skills/',\n    label: 'Qwen Code',\n    description: 'Qwen Code 的 skills 插件目录',\n  },\n  {\n    id: 'openAICodex',\n    path: '.codex/skills/',\n    label: 'OpenAI Codex',\n    description: 'OpenAI Codex 的 skills 插件目录',\n  },\n  {\n    id: 'standard',\n    path: '.skills/',\n    label: '标准目录',\n    description: '标准 skills 配置目录',\n  },\n];\n\nconst SkillsWriter: React.FC = () => {\n  const [selectedIds, setSelectedIds] = useState<string[]>([]);\n  const [loading, setLoading] = useState(false);\n\n  const isSupported = typeof window !== 'undefined' && 'showDirectoryPicker' in window;\n\n  const handleCheckboxChange = (checkedIds: string[]) => {\n    setSelectedIds(checkedIds);\n  };\n\n  const selectedSkills = skillsOptions.filter((opt) => selectedIds.includes(opt.id));\n\n  // 递归创建目录\n  const createDirectoryHandle = async (baseHandle: FileSystemDirectoryHandle, pathParts: string[]) => {\n    let currentHandle = baseHandle;\n    for (const part of pathParts) {\n      try {\n        currentHandle = await currentHandle.getDirectoryHandle(part, { create: true });\n      } catch {\n        currentHandle = await currentHandle.getDirectoryHandle(part);\n      }\n    }\n    return currentHandle;\n  };\n\n  // 递归写入文件\n  const writeFile = async (handle: FileSystemDirectoryHandle, filePath: string, content: Uint8Array) => {\n    const pathParts = filePath.split('/').filter((p) => p);\n    const fileName = pathParts.pop()!;\n    const dirHandle = await createDirectoryHandle(handle, pathParts);\n    const fileHandle = await dirHandle.getFileHandle(fileName, { create: true });\n    const writable = await fileHandle.createWritable();\n    await writable.write(content as BufferSource);\n    await writable.close();\n  };\n\n  // 下载并解压 skills.zip\n  const downloadAndExtractSkills = async () => {\n    if (selectedSkills.length === 0) {\n      message.error('请至少选择一个工具');\n      return;\n    }\n\n    // 检查是否支持目录选择器\n    if (!('showDirectoryPicker' in window)) {\n      message.error('当前浏览器不支持目录选择器');\n      return;\n    }\n\n    try {\n      // 1. 先让用户选择目录\n      const handle = await (window as Window & { showDirectoryPicker?: () => Promise<FileSystemDirectoryHandle> })\n        .showDirectoryPicker!();\n\n      // 2. 用户选择目录后开始处理\n      setLoading(true);\n\n      // 3. 下载 skills.zip\n      const response = await fetch('/skills.zip');\n      if (!response.ok) {\n        throw new Error('下载失败，请稍后重试');\n      }\n      const blob = await response.blob();\n\n      // 4. 解压 zip 文件，把 skills/yoka-ui 文件夹写入到用户选择的路径下\n      const zip = await JSZip.loadAsync(blob);\n\n      // 获取用户选择的路径列表\n      const selectedPaths = selectedSkills.map((s) => s.path);\n\n      // 找到 zip 中的 yoka-ui 文件夹\n      const skillsFolderEntry = Object.entries(zip.files).find(\n        ([path]) => path === 'yoka-ui' || path.startsWith('yoka-ui/'),\n      );\n\n      if (!skillsFolderEntry) {\n        throw new Error('压缩包中未找到 yoka-ui 目录');\n      }\n\n      // 对每个用户选择的路径，创建 yoka-ui 文件夹并写入内容\n      let totalCount = 0;\n\n      for (const selectedPath of selectedPaths) {\n        // 在用户选择的路径下创建 yoka-ui 文件夹\n        const normalizedPath = selectedPath.replace(/^\\//, '').replace(/\\/$/, '');\n        const pathParts = normalizedPath.split('/');\n\n        let currentHandle = handle;\n        for (const part of pathParts) {\n          try {\n            currentHandle = await currentHandle.getDirectoryHandle(part, { create: true });\n          } catch {\n            currentHandle = await currentHandle.getDirectoryHandle(part);\n          }\n        }\n\n        // 创建 yoka-ui 文件夹\n        let skillsHandle: FileSystemDirectoryHandle;\n        try {\n          skillsHandle = await currentHandle.getDirectoryHandle('yoka-ui', { create: true });\n        } catch {\n          skillsHandle = await currentHandle.getDirectoryHandle('yoka-ui');\n        }\n\n        // 遍历 zip 中 yoka-ui 文件夹下的所有文件\n        for (const [filePath, zipEntry] of Object.entries(zip.files)) {\n          if (filePath.startsWith('yoka-ui/')) {\n            const relativePath = filePath.replace('yoka-ui/', '');\n\n            if (!zipEntry.dir && relativePath) {\n              // 写入文件\n              const content = await zipEntry.async('uint8array');\n              await writeFile(skillsHandle, relativePath, content);\n              totalCount++;\n            }\n          }\n        }\n      }\n\n      message.success(`成功添加 ${totalCount} 个文件到项目`);\n    } catch (err: unknown) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        // 用户取消选择，不显示任何消息\n      } else {\n        console.error('添加到项目失败:', err);\n        message.error(err instanceof Error ? err.message : '添加到项目失败');\n      }\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  return (\n    <div className={styles.skillsWriter}>\n      <Card className={styles.card}>\n        <div className={styles.header}>\n          <CloudDownloadOutlined style={{ fontSize: 20, color: '#1890ff' }} />\n          <Title level={5} style={{ margin: 0, fontSize: 20, fontWeight: 600 }}>\n            Skills 同步工具\n          </Title>\n        </div>\n\n        <Text type='secondary' style={{ display: 'block', marginBottom: 16 }}>\n          将 YokaUI Skills 同步到本地 IDE 的插件目录中\n        </Text>\n\n        <CheckboxGroup\n          value={selectedIds}\n          onChange={(values) => handleCheckboxChange(values as string[])}\n          style={{ display: 'flex', flexDirection: 'column', gap: 8 }}\n        >\n          {skillsOptions.map((option) => (\n            <Checkbox key={option.id} value={option.id} style={{ alignItems: 'flex-start' }}>\n              <div style={{ display: 'flex', flexDirection: 'column' }}>\n                <Space>\n                  <Text strong>{option.label}</Text>\n                  <Text type='secondary' style={{ fontSize: 12 }}>\n                    ({option.path})\n                  </Text>\n                </Space>\n                <Text type='secondary' style={{ fontSize: 12, marginTop: 2 }}>\n                  {option.description}\n                </Text>\n              </div>\n            </Checkbox>\n          ))}\n        </CheckboxGroup>\n\n        <div className={styles.actions}>\n          <Space direction='vertical' style={{ width: '100%' }}>\n            <Space>\n              <Button\n                type='primary'\n                icon={<FolderOpenOutlined />}\n                onClick={downloadAndExtractSkills}\n                loading={loading}\n                disabled={selectedSkills.length === 0 || !isSupported}\n              >\n                同步到本地\n              </Button>\n              {!isSupported && (\n                <Text type='warning' style={{ fontSize: 12 }}>\n                  需要 HTTPS 或 localhost 环境，请手动下载\n                </Text>\n              )}\n            </Space>\n            <Space>\n              <Button icon={<CloudDownloadOutlined />} href='/skills.zip' download>\n                手动下载 skills.zip\n              </Button>\n              <Text type='secondary' style={{ fontSize: 12 }}>\n                解压到对应工具的 skills 目录\n              </Text>\n            </Space>\n          </Space>\n        </div>\n      </Card>\n    </div>\n  );\n};\n\nexport default SkillsWriter;\n"],
+  "mappings": "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",
+  "names": ["JSZip", "React", "styles"]
+}

package/dist/lib/creative/SkillsWriter/index.module.less

@@ -0,0 +1,21 @@
+.skillsWriter {
+  margin: 24px 0;
+}
+
+.card {
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
+}
+
+.header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 16px;
+}
+
+.actions {
+  margin-top: 24px;
+  padding-top: 16px;
+  border-top: 1px solid #f0f0f0;
+}

package/dist/lib/index.less

@@ -5,7 +5,6 @@
  */
 
 // 自动聚合的样式文件
-@import "../../src/Themes/TableTheme/index.less";
 @import "../../src/assets/less/ant-reset.less";
 @import "../../src/assets/less/index.less";
 @import "../../src/assets/less/variables.less";
@@ -14,6 +13,9 @@
 @import "../../src/business/ModCommonFilter/components/FilterButton/index.module.less";
 @import "../../src/business/ModCommonFilter/components/PopoverContent/index.module.less";
 @import "../../src/business/ModCommonFilter/index.module.less";
+@import "../../src/business/YkCharts/index.module.less";
+@import "../../src/business/YkCharts/tooltip.less";
+@import "../../src/business/YkCharts/variables.less";
 @import "../../src/business/YkLoginModule/styles.module.less";
 @import "../../src/business/YkPorjectSelect/index.module.less";
 @import "../../src/business/YkSqlEdit/code-mirror-custom.module.less";
@@ -23,13 +25,16 @@
 @import "../../src/components/TreeTransfer/components/TreeTransferPanel/index.less";
 @import "../../src/components/TreeTransfer/index.less";
 @import "../../src/components/YkDateRangePicker/index.module.less";
+@import "../../src/components/YKMarkdown/index.module.less";
 @import "../../src/components/YkRangeDateWithVS/index.module.less";
 @import "../../src/components/YkRangeTimeWithRecent/index.module.less";
 @import "../../src/creative/ArcCheckbox/index.module.less";
 @import "../../src/creative/ButtonRadioWithInfo/index.less";
 @import "../../src/creative/ButtonWithProgress/index.less";
 @import "../../src/creative/GlassSegmentedRadio/index.module.less";
+@import "../../src/creative/SkillsWriter/index.module.less";
 @import "../../src/layout/YkDrawer/index.module.less";
+@import "../../src/Themes/TableTheme/index.less";
 @import "../../src/ui/LogicOperator/index.module.less";
 @import "../../src/ui/YkCard/index.module.less";
 @import "../../src/ui/YkCheckbox/index.module.less";

package/dist/lib/utils/ykStorybookDoc.d.ts

@@ -13,5 +13,20 @@ export type YkStoryDocInput = {
      * 组件特有备注（交互、API、Story 限制等）；环境类说明由函数自动追加。
      */
     notes?: string[];
+    /**
+     * 代码示例数组，每个示例包含标题和代码。
+     * 将在文档中以 ```tsx 代码块形式展示。
+     */
+    examples?: YkStoryDocExample[];
+};
+/** 代码示例类型 */
+export type YkStoryDocExample = {
+    /** 示例标题 */
+    title?: string;
+    /** 代码示例内容（tsx 代码块） */
+    code: string;
 };
+/**
+ * 生成完整的 Storybook 文档字符串
+ */
 export declare function ykStoryDoc(input: YkStoryDocInput): string;

package/dist/lib/utils/ykStorybookDoc.js

@@ -23,16 +23,38 @@ __export(ykStorybookDoc_exports, {
 });
 module.exports = __toCommonJS(ykStorybookDoc_exports);
 var YK_STORYBOOK_PLATFORM_NOTE = "业务侧使用 `@yoka-ui/ui` 时需保证 React 18、与库一致的 Ant Design 5；入口引入 Ant Design 全局样式（可与库一致使用 `antd/dist/reset.css`），并引入 `@yoka-ui/ui/dist/index.less`（以 README 为准）。";
+function formatExamples(examples) {
+  if (!examples || examples.length === 0) {
+    return "";
+  }
+  return examples.map((example) => {
+    const title = example.title ? `### ${example.title}
+
+` : "";
+    return `${title}\`\`\`tsx
+${example.code}
+\`\`\``;
+  }).join("\n\n");
+}
 function ykStoryDoc(input) {
   const deps = input.dependencies.length > 0 ? input.dependencies.join("、") : "`react`、`antd`（具体见源码 import）";
   const extra = (input.notes ?? []).filter(Boolean);
   const remarks = [...extra, YK_STORYBOOK_PLATFORM_NOTE];
-  return `**描述**：${input.summary}
+  const baseDoc = `**描述**：${input.summary}
 
 **依赖**：${deps}
 
 **备注**：
 ${remarks.map((line) => `- ${line}`).join("\n")}`;
+  const examplesStr = formatExamples(input.examples ?? []);
+  if (examplesStr) {
+    return `${baseDoc}
+
+## 代码示例
+
+${examplesStr}`;
+  }
+  return baseDoc;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/lib/utils/ykStorybookDoc.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/utils/ykStorybookDoc.ts"],
-  "sourcesContent": ["/**\n * Storybook Autodocs 统一文案：**描述** / **依赖** / **备注**。\n * 用于各 `*.stories.tsx` 的 `meta.parameters.docs.description.component`。\n */\nexport type YkStoryDocInput = {\n  /** 一句话概括组件用途（建议以句号结尾） */\n  summary: string;\n  /**\n   * 运行时主要依赖：`npm 包（用到的子模块）` 或 `本库 · 模块名`\n   */\n  dependencies: string[];\n  /**\n   * 组件特有备注（交互、API、Story 限制等）；环境类说明由函数自动追加。\n   */\n  notes?: string[];\n};\n\nconst YK_STORYBOOK_PLATFORM_NOTE =\n  '业务侧使用 `@yoka-ui/ui` 时需保证 React 18、与库一致的 Ant Design 5；入口引入 Ant Design 全局样式（可与库一致使用 `antd/dist/reset.css`），并引入 `@yoka-ui/ui/dist/index.less`（以 README 为准）。';\n\nexport function ykStoryDoc(input: YkStoryDocInput): string {\n  const deps = input.dependencies.length > 0 ? input.dependencies.join('、') : '`react`、`antd`（具体见源码 import）';\n\n  const extra = (input.notes ?? []).filter(Boolean);\n  const remarks = [...extra, YK_STORYBOOK_PLATFORM_NOTE];\n\n  return `**描述**：${input.summary}\\n\\n**依赖**：${deps}\\n\\n**备注**：\\n${remarks.map((line) => `- ${line}`).join('\\n')}`;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,IAAM,6BACJ;AAEK,SAAS,WAAW,OAAgC;AACzD,QAAM,OAAO,MAAM,aAAa,SAAS,IAAI,MAAM,aAAa,KAAK,GAAG,IAAI;AAE5E,QAAM,SAAS,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO;AAChD,QAAM,UAAU,CAAC,GAAG,OAAO,0BAA0B;AAErD,SAAO,UAAU,MAAM;AAAA;AAAA,SAAqB;AAAA;AAAA;AAAA,EAAoB,QAAQ,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,KAAK,IAAI;AAC9G;",
+  "sourcesContent": ["/**\n * Storybook Autodocs 统一文案：**描述** / **依赖** / **备注**。\n * 用于各 `*.stories.tsx` 的 `meta.parameters.docs.description.component`。\n */\nexport type YkStoryDocInput = {\n  /** 一句话概括组件用途（建议以句号结尾） */\n  summary: string;\n  /**\n   * 运行时主要依赖：`npm 包（用到的子模块）` 或 `本库 · 模块名`\n   */\n  dependencies: string[];\n  /**\n   * 组件特有备注（交互、API、Story 限制等）；环境类说明由函数自动追加。\n   */\n  notes?: string[];\n  /**\n   * 代码示例数组，每个示例包含标题和代码。\n   * 将在文档中以 ```tsx 代码块形式展示。\n   */\n  examples?: YkStoryDocExample[];\n};\n\n/** 代码示例类型 */\nexport type YkStoryDocExample = {\n  /** 示例标题 */\n  title?: string;\n  /** 代码示例内容（tsx 代码块） */\n  code: string;\n};\n\nconst YK_STORYBOOK_PLATFORM_NOTE =\n  '业务侧使用 `@yoka-ui/ui` 时需保证 React 18、与库一致的 Ant Design 5；入口引入 Ant Design 全局样式（可与库一致使用 `antd/dist/reset.css`），并引入 `@yoka-ui/ui/dist/index.less`（以 README 为准）。';\n\n/**\n * 生成代码示例的 Markdown 格式字符串\n */\nfunction formatExamples(examples: YkStoryDocExample[]): string {\n  if (!examples || examples.length === 0) {\n    return '';\n  }\n\n  return examples\n    .map((example) => {\n      const title = example.title ? `### ${example.title}\\n\\n` : '';\n      return `${title}\\`\\`\\`tsx\\n${example.code}\\n\\`\\`\\``;\n    })\n    .join('\\n\\n');\n}\n\n/**\n * 生成完整的 Storybook 文档字符串\n */\nexport function ykStoryDoc(input: YkStoryDocInput): string {\n  const deps = input.dependencies.length > 0 ? input.dependencies.join('、') : '`react`、`antd`（具体见源码 import）';\n\n  const extra = (input.notes ?? []).filter(Boolean);\n  const remarks = [...extra, YK_STORYBOOK_PLATFORM_NOTE];\n\n  const baseDoc = `**描述**：${input.summary}\\n\\n**依赖**：${deps}\\n\\n**备注**：\\n${remarks.map((line) => `- ${line}`).join('\\n')}`;\n\n  // 如果有代码示例，添加到文档末尾\n  const examplesStr = formatExamples(input.examples ?? []);\n  if (examplesStr) {\n    return `${baseDoc}\\n\\n## 代码示例\\n\\n${examplesStr}`;\n  }\n\n  return baseDoc;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BA,IAAM,6BACJ;AAKF,SAAS,eAAe,UAAuC;AAC7D,MAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,SAAO,SACJ,IAAI,CAAC,YAAY;AAChB,UAAM,QAAQ,QAAQ,QAAQ,OAAO,QAAQ;AAAA;AAAA,IAAc;AAC3D,WAAO,GAAG;AAAA,EAAmB,QAAQ;AAAA;AAAA,EACvC,CAAC,EACA,KAAK,MAAM;AAChB;AAKO,SAAS,WAAW,OAAgC;AACzD,QAAM,OAAO,MAAM,aAAa,SAAS,IAAI,MAAM,aAAa,KAAK,GAAG,IAAI;AAE5E,QAAM,SAAS,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO;AAChD,QAAM,UAAU,CAAC,GAAG,OAAO,0BAA0B;AAErD,QAAM,UAAU,UAAU,MAAM;AAAA;AAAA,SAAqB;AAAA;AAAA;AAAA,EAAoB,QAAQ,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,KAAK,IAAI;AAGrH,QAAM,cAAc,eAAe,MAAM,YAAY,CAAC,CAAC;AACvD,MAAI,aAAa;AACf,WAAO,GAAG;AAAA;AAAA;AAAA;AAAA,EAAyB;AAAA,EACrC;AAEA,SAAO;AACT;",
   "names": []
 }