@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/ai-chat-input/meta.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * AIChatInput — 对齐 Semi Design AIChatInput（tiptap 富文本输入）。
+ * 阶段 1（基础输入）：richTextInput + 发送（sendHotKey/canSend/generating/stop）+ Upload 附件。
+ * 阶段 2（引用/建议）：references 引用条 + suggestions 建议浮层 + 自定义渲染插槽。
+ * 阶段 3（技能/模版）：skill-slot 自定义 NodeView（svelte-tiptap SvelteNodeViewRenderer）+ skillHotKey 面板 + renderTemplate。
+ * 阶段 4（配置区）：renderConfigureArea + Configure 子组件（Select/Button/RadioButton，context+field 绑定）+ setup。
+ * 阶段 5（Adapter 桥）：messageToChatInput / chatInputToChatCompletion 把 onMessageSend 载荷转成
+ * AIDialogueMessage / OpenAI ChatCompletion，接 AIChatDialogue 展示或喂 API（core 纯函数透传）。
+ * 可选补充（全部完成）：select-slot（内联下拉）+ input-slot（可编辑填空，全套零宽锚点 + 光标 plugin）
+ * 自定义节点，用于 renderTemplate 模版填空（getSelectSlotHTML/getInputSlotHTML 生成）；
+ * Configure.Mcp（MCP 服务多选下拉）。tiptap 内核 + pm + svelte-tiptap 动态 import（不进主 bundle）。
+ * headless 判定在 @chenzy-design/core。
+ */
+export declare const meta: {
+    readonly name: "AIChatInput";
+    readonly category: "ai";
+    readonly description: "AI 聊天输入框：基于 tiptap 富文本编辑器（内核 + svelte-tiptap 动态 import 懒加载，绝不进主 bundle）。阶段 1 富文本输入 + 发送（sendHotKey、canSend、generating 停止键）+ Upload 附件。阶段 2 references 引用条（可点击/删除/renderReference 覆盖）+ suggestions 建议浮层（聚焦弹出，↑↓/Enter/Esc/点击外部，renderSuggestionItem 覆盖）+ renderTopSlot。阶段 3 skills 技能面板（空编辑区按 skillHotKey 弹出，↑↓/Enter/Esc，选中插入 skill-slot 自定义节点并 onSkillChange）+ skill-slot NodeView（inline atom chip，含删除，用 svelte-tiptap SvelteNodeViewRenderer 渲染 SkillSlotNode.svelte）+ renderTemplate 模版面板（当前技能 hasTemplate 时展示模版按钮，点击弹出，setContent 填入）。阶段 4 renderConfigureArea 配置区（footer 左侧，放 AIChatInputConfigureSelect/Button/RadioButton 经 configure context 用 field 绑定）+ configureDefaultValue + onConfigureChange，配置值发送时并入 MessageContent.setup。onMessageSend 载荷对齐 Semi MessageContent（inputContents/attachments/references/setup）。headless（canSend/sendHotKey/MessageContent/doc→contents/suggestion 键盘/reference 归一/skill 归一/getSkillSlotHTML/skillHotKey 判定/configure setField-removeField）在 @chenzy-design/core，可单测。ref 方法 setContent/focusEditor/getText/getHTML/getEditor/clearContent/changeTemplateVisible/getConfigureValue。阶段 5 Adapter 桥（messageToChatInput → AIDialogueMessage 喂 AIChatDialogue；chatInputToChatCompletion → OpenAI ChatCompletion user message）为 core 纯函数，从 svelte 包透传。";
+    readonly exports: readonly ["AIChatInput", "AIChatInputConfigureSelect", "AIChatInputConfigureButton", "AIChatInputConfigureRadioButton", "AIChatInputConfigureMcp", "AIChatInputConfigureItem"];
+    readonly props: readonly [{
+        readonly name: "defaultContent";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "初始内容（HTML 或纯文本，tiptap Content）";
+    }, {
+        readonly name: "placeholder";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "占位文本（缺省走 locale AIChatInput.placeholder）";
+    }, {
+        readonly name: "canSend";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "是否可发送；未设置按内容/附件推断，显式设置以此为准";
+    }, {
+        readonly name: "generating";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "生成中：发送键变停止键，Enter 不发送";
+    }, {
+        readonly name: "sendHotKey";
+        readonly type: "'enter'|'shift+enter'";
+        readonly default: "'enter'";
+        readonly desc: "发送快捷键";
+    }, {
+        readonly name: "showUploadButton";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否展示上传按钮";
+    }, {
+        readonly name: "uploadProps";
+        readonly type: "object";
+        readonly default: "undefined";
+        readonly desc: "透传给内部 Upload 的 props";
+    }, {
+        readonly name: "round";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "圆角样式（对齐 Semi round）";
+    }, {
+        readonly name: "extensions";
+        readonly type: "unknown[]";
+        readonly default: "[]";
+        readonly desc: "追加 tiptap extensions（StarterKit 之后）";
+    }, {
+        readonly name: "transformer";
+        readonly type: "Map<string, (node)=>Content>";
+        readonly default: "undefined";
+        readonly desc: "富文本节点归一覆盖（对齐 Semi transformer）";
+    }, {
+        readonly name: "references";
+        readonly type: "AIChatInputReference[]";
+        readonly default: "[]";
+        readonly desc: "受控引用列表，渲染于编辑区上方（阶段 2）";
+    }, {
+        readonly name: "showReference";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否展示引用条（阶段 2）";
+    }, {
+        readonly name: "suggestions";
+        readonly type: "AIChatInputSuggestion[]";
+        readonly default: "[]";
+        readonly desc: "建议列表，聚焦空编辑区弹出面板（阶段 2）";
+    }, {
+        readonly name: "topSlotPosition";
+        readonly type: "'top'|'bottom'";
+        readonly default: "'top'";
+        readonly desc: "renderTopSlot 相对引用条位置（阶段 2）";
+    }, {
+        readonly name: "skills";
+        readonly type: "AIChatInputSkill[]";
+        readonly default: "[]";
+        readonly desc: "技能列表，空编辑区按 skillHotKey 弹面板（阶段 3）";
+    }, {
+        readonly name: "skillHotKey";
+        readonly type: "string";
+        readonly default: "'/'";
+        readonly desc: "触发技能面板的按键（阶段 3）";
+    }, {
+        readonly name: "showTemplateButton";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否展示模版按钮（仅当前技能 hasTemplate 时生效，阶段 3）";
+    }, {
+        readonly name: "configureDefaultValue";
+        readonly type: "Record<string, unknown>";
+        readonly default: "undefined";
+        readonly desc: "配置区初始值（阶段 4）";
+    }, {
+        readonly name: "showUploadFile";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "top area 展示上传附件列表";
+    }, {
+        readonly name: "clearContentOnGenerating";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "generating false→true 时清空输入";
+    }];
+    readonly events: readonly [{
+        readonly name: "onContentChange";
+        readonly payload: "{ text, html, json }";
+        readonly desc: "内容变化";
+    }, {
+        readonly name: "onMessageSend";
+        readonly payload: "MessageContent（inputContents/attachments/references）";
+        readonly desc: "发送消息";
+    }, {
+        readonly name: "onStopGenerate";
+        readonly payload: "()";
+        readonly desc: "停止生成";
+    }, {
+        readonly name: "onUploadChange";
+        readonly payload: "attachments";
+        readonly desc: "上传附件变化";
+    }, {
+        readonly name: "onReferenceClick";
+        readonly payload: "reference";
+        readonly desc: "点击引用（阶段 2）";
+    }, {
+        readonly name: "onReferenceDelete";
+        readonly payload: "reference";
+        readonly desc: "删除引用（阶段 2）";
+    }, {
+        readonly name: "onSuggestClick";
+        readonly payload: "suggestion";
+        readonly desc: "选中建议；未提供时默认填入编辑器（阶段 2）";
+    }, {
+        readonly name: "onSkillChange";
+        readonly payload: "skill";
+        readonly desc: "选中技能（阶段 3）";
+    }, {
+        readonly name: "onTemplateVisibleChange";
+        readonly payload: "visible";
+        readonly desc: "模版面板显隐变化（阶段 3）";
+    }, {
+        readonly name: "onConfigureChange";
+        readonly payload: "(value, changed)";
+        readonly desc: "配置区变更（阶段 4）";
+    }, {
+        readonly name: "onFocus";
+        readonly payload: "event";
+        readonly desc: "编辑区聚焦";
+    }, {
+        readonly name: "onBlur";
+        readonly payload: "event";
+        readonly desc: "编辑区失焦";
+    }, {
+        readonly name: "onPaste";
+        readonly payload: "files";
+        readonly desc: "粘贴（携带剪贴板文件）";
+    }];
+    readonly slots: readonly [{
+        readonly name: "renderActionArea";
+        readonly payload: "{ canSend, generating }";
+        readonly desc: "自定义发送/停止按钮区";
+    }, {
+        readonly name: "renderReference";
+        readonly payload: "reference";
+        readonly desc: "自定义单条引用渲染（阶段 2）";
+    }, {
+        readonly name: "renderSuggestionItem";
+        readonly payload: "{ suggestion, active }";
+        readonly desc: "自定义单条建议渲染（阶段 2）";
+    }, {
+        readonly name: "renderTopSlot";
+        readonly payload: "{ references, attachments }";
+        readonly desc: "自定义 top slot 渲染（阶段 2）";
+    }, {
+        readonly name: "renderSkillItem";
+        readonly payload: "{ skill, active }";
+        readonly desc: "自定义单条技能渲染（阶段 3）";
+    }, {
+        readonly name: "renderTemplate";
+        readonly payload: "{ skill, setContent }";
+        readonly desc: "模版面板渲染（阶段 3）";
+    }, {
+        readonly name: "renderConfigureArea";
+        readonly payload: "()";
+        readonly desc: "footer 配置区渲染（放 Configure 子组件，阶段 4）";
+    }, {
+        readonly name: "renderUploadButton";
+        readonly payload: "{ openFileDialog, disabled, attachments }";
+        readonly desc: "自定义上传按钮 UI（保留内置上传/粘贴逻辑）";
+    }];
+    readonly methods: readonly [{
+        readonly name: "setContent";
+        readonly desc: "设置编辑器内容";
+    }, {
+        readonly name: "focusEditor";
+        readonly desc: "聚焦编辑器";
+    }, {
+        readonly name: "getText";
+        readonly desc: "取纯文本";
+    }, {
+        readonly name: "getHTML";
+        readonly desc: "取 HTML";
+    }, {
+        readonly name: "getEditor";
+        readonly desc: "取 tiptap Editor 实例";
+    }, {
+        readonly name: "clearContent";
+        readonly desc: "清空编辑器内容";
+    }, {
+        readonly name: "changeTemplateVisible";
+        readonly desc: "显隐模版面板（阶段 3）";
+    }, {
+        readonly name: "getConfigureValue";
+        readonly desc: "取当前配置区值（阶段 4）";
+    }, {
+        readonly name: "deleteContent";
+        readonly desc: "删除编辑器中匹配 content.text 的一段";
+    }, {
+        readonly name: "setContentWhileSaveTool";
+        readonly desc: "设置内容但保留当前技能 slot 前缀";
+    }, {
+        readonly name: "deleteUploadFile";
+        readonly desc: "从附件列表删除一项";
+    }];
+    readonly a11y: {
+        readonly role: "编辑区 role=textbox aria-multiline；建议/技能面板 role=listbox / 项 role=option aria-selected；模版按钮 aria-expanded；引用 chip 名称与删除为平级 button（避免 nested-interactive）；skill-slot chip 含删除按钮；input-slot 可编辑填空空态显示 placeholder（aria-hidden）；Configure.Mcp 下拉 role=menuitemcheckbox；aria-label 全走 i18n";
+        readonly keyboard: "Enter 发送（sendHotKey=enter，Shift+Enter 换行）/ Shift+Enter 发送；建议/技能面板可见时 ↑↓ 环绕导航、Enter 选中高亮项、Esc 关闭；空编辑区按 skillHotKey 弹技能面板；IME 组字中不发送；generating 时 Enter 不发送";
+    };
+    readonly tokens: readonly ["--cd-ai-chat-input-*（容器/编辑区/占位符/上传图标/发送-停止/引用条/建议-技能面板/skill-slot chip/模版按钮，深浅双主题；配置区 Button 复用 template/primary token）"];
+    readonly examples: readonly [{
+        readonly title: "基础输入";
+        readonly desc: "defaultContent + placeholder + onMessageSend";
+    }, {
+        readonly title: "受控发送态";
+        readonly desc: "canSend + generating + onStopGenerate";
+    }, {
+        readonly title: "快捷键";
+        readonly desc: "sendHotKey='shift+enter'";
+    }, {
+        readonly title: "附件";
+        readonly desc: "showUploadButton + uploadProps + onUploadChange";
+    }, {
+        readonly title: "引用";
+        readonly desc: "references + onReferenceClick/onReferenceDelete + renderReference";
+    }, {
+        readonly title: "建议";
+        readonly desc: "suggestions + onSuggestClick + renderSuggestionItem（↑↓/Enter/Esc）";
+    }, {
+        readonly title: "技能";
+        readonly desc: "skills + skillHotKey + onSkillChange（选中插入 skill-slot 节点）";
+    }, {
+        readonly title: "模版";
+        readonly desc: "skill.hasTemplate + renderTemplate（模版按钮弹面板 setContent）";
+    }, {
+        readonly title: "配置区";
+        readonly desc: "renderConfigureArea + ConfigureSelect/Button/RadioButton + onConfigureChange（值进 setup）";
+    }, {
+        readonly title: "接入对话";
+        readonly desc: "messageToChatInput 把发送载荷转 Message 喂 AIChatDialogue（Adapter 桥）";
+    }, {
+        readonly title: "模版填空节点";
+        readonly desc: "getSelectSlotHTML/getInputSlotHTML 在模版嵌内联下拉/可编辑填空（select-slot/input-slot）";
+    }, {
+        readonly title: "MCP 配置";
+        readonly desc: "AIChatInputConfigureMcp 多选 MCP 服务，选中集进 setup";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/ai-chat-input/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FP,CAAC"}

package/dist/ai-chat-input/meta.js

@@ -0,0 +1,106 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * AIChatInput — 对齐 Semi Design AIChatInput（tiptap 富文本输入）。
+ * 阶段 1（基础输入）：richTextInput + 发送（sendHotKey/canSend/generating/stop）+ Upload 附件。
+ * 阶段 2（引用/建议）：references 引用条 + suggestions 建议浮层 + 自定义渲染插槽。
+ * 阶段 3（技能/模版）：skill-slot 自定义 NodeView（svelte-tiptap SvelteNodeViewRenderer）+ skillHotKey 面板 + renderTemplate。
+ * 阶段 4（配置区）：renderConfigureArea + Configure 子组件（Select/Button/RadioButton，context+field 绑定）+ setup。
+ * 阶段 5（Adapter 桥）：messageToChatInput / chatInputToChatCompletion 把 onMessageSend 载荷转成
+ * AIDialogueMessage / OpenAI ChatCompletion，接 AIChatDialogue 展示或喂 API（core 纯函数透传）。
+ * 可选补充（全部完成）：select-slot（内联下拉）+ input-slot（可编辑填空，全套零宽锚点 + 光标 plugin）
+ * 自定义节点，用于 renderTemplate 模版填空（getSelectSlotHTML/getInputSlotHTML 生成）；
+ * Configure.Mcp（MCP 服务多选下拉）。tiptap 内核 + pm + svelte-tiptap 动态 import（不进主 bundle）。
+ * headless 判定在 @chenzy-design/core。
+ */
+export const meta = {
+    name: 'AIChatInput',
+    category: 'ai',
+    description: 'AI 聊天输入框：基于 tiptap 富文本编辑器（内核 + svelte-tiptap 动态 import 懒加载，绝不进主 bundle）。阶段 1 富文本输入 + 发送（sendHotKey、canSend、generating 停止键）+ Upload 附件。阶段 2 references 引用条（可点击/删除/renderReference 覆盖）+ suggestions 建议浮层（聚焦弹出，↑↓/Enter/Esc/点击外部，renderSuggestionItem 覆盖）+ renderTopSlot。阶段 3 skills 技能面板（空编辑区按 skillHotKey 弹出，↑↓/Enter/Esc，选中插入 skill-slot 自定义节点并 onSkillChange）+ skill-slot NodeView（inline atom chip，含删除，用 svelte-tiptap SvelteNodeViewRenderer 渲染 SkillSlotNode.svelte）+ renderTemplate 模版面板（当前技能 hasTemplate 时展示模版按钮，点击弹出，setContent 填入）。阶段 4 renderConfigureArea 配置区（footer 左侧，放 AIChatInputConfigureSelect/Button/RadioButton 经 configure context 用 field 绑定）+ configureDefaultValue + onConfigureChange，配置值发送时并入 MessageContent.setup。onMessageSend 载荷对齐 Semi MessageContent（inputContents/attachments/references/setup）。headless（canSend/sendHotKey/MessageContent/doc→contents/suggestion 键盘/reference 归一/skill 归一/getSkillSlotHTML/skillHotKey 判定/configure setField-removeField）在 @chenzy-design/core，可单测。ref 方法 setContent/focusEditor/getText/getHTML/getEditor/clearContent/changeTemplateVisible/getConfigureValue。阶段 5 Adapter 桥（messageToChatInput → AIDialogueMessage 喂 AIChatDialogue；chatInputToChatCompletion → OpenAI ChatCompletion user message）为 core 纯函数，从 svelte 包透传。',
+    exports: [
+        'AIChatInput',
+        'AIChatInputConfigureSelect',
+        'AIChatInputConfigureButton',
+        'AIChatInputConfigureRadioButton',
+        'AIChatInputConfigureMcp',
+        'AIChatInputConfigureItem',
+    ],
+    props: [
+        { name: 'defaultContent', type: 'string', default: "''", desc: '初始内容（HTML 或纯文本，tiptap Content）' },
+        { name: 'placeholder', type: 'string', default: 'undefined', desc: '占位文本（缺省走 locale AIChatInput.placeholder）' },
+        { name: 'canSend', type: 'boolean', default: 'undefined', desc: '是否可发送；未设置按内容/附件推断，显式设置以此为准' },
+        { name: 'generating', type: 'boolean', default: 'false', desc: '生成中：发送键变停止键，Enter 不发送' },
+        { name: 'sendHotKey', type: "'enter'|'shift+enter'", default: "'enter'", desc: '发送快捷键' },
+        { name: 'showUploadButton', type: 'boolean', default: 'true', desc: '是否展示上传按钮' },
+        { name: 'uploadProps', type: 'object', default: 'undefined', desc: '透传给内部 Upload 的 props' },
+        { name: 'round', type: 'boolean', default: 'false', desc: '圆角样式（对齐 Semi round）' },
+        { name: 'extensions', type: 'unknown[]', default: '[]', desc: '追加 tiptap extensions（StarterKit 之后）' },
+        { name: 'transformer', type: 'Map<string, (node)=>Content>', default: 'undefined', desc: '富文本节点归一覆盖（对齐 Semi transformer）' },
+        { name: 'references', type: 'AIChatInputReference[]', default: '[]', desc: '受控引用列表，渲染于编辑区上方（阶段 2）' },
+        { name: 'showReference', type: 'boolean', default: 'true', desc: '是否展示引用条（阶段 2）' },
+        { name: 'suggestions', type: 'AIChatInputSuggestion[]', default: '[]', desc: '建议列表，聚焦空编辑区弹出面板（阶段 2）' },
+        { name: 'topSlotPosition', type: "'top'|'bottom'", default: "'top'", desc: 'renderTopSlot 相对引用条位置（阶段 2）' },
+        { name: 'skills', type: 'AIChatInputSkill[]', default: '[]', desc: '技能列表，空编辑区按 skillHotKey 弹面板（阶段 3）' },
+        { name: 'skillHotKey', type: 'string', default: "'/'", desc: '触发技能面板的按键（阶段 3）' },
+        { name: 'showTemplateButton', type: 'boolean', default: 'true', desc: '是否展示模版按钮（仅当前技能 hasTemplate 时生效，阶段 3）' },
+        { name: 'configureDefaultValue', type: 'Record<string, unknown>', default: 'undefined', desc: '配置区初始值（阶段 4）' },
+        { name: 'showUploadFile', type: 'boolean', default: 'true', desc: 'top area 展示上传附件列表' },
+        { name: 'clearContentOnGenerating', type: 'boolean', default: 'true', desc: 'generating false→true 时清空输入' },
+    ],
+    events: [
+        { name: 'onContentChange', payload: '{ text, html, json }', desc: '内容变化' },
+        { name: 'onMessageSend', payload: 'MessageContent（inputContents/attachments/references）', desc: '发送消息' },
+        { name: 'onStopGenerate', payload: '()', desc: '停止生成' },
+        { name: 'onUploadChange', payload: 'attachments', desc: '上传附件变化' },
+        { name: 'onReferenceClick', payload: 'reference', desc: '点击引用（阶段 2）' },
+        { name: 'onReferenceDelete', payload: 'reference', desc: '删除引用（阶段 2）' },
+        { name: 'onSuggestClick', payload: 'suggestion', desc: '选中建议；未提供时默认填入编辑器（阶段 2）' },
+        { name: 'onSkillChange', payload: 'skill', desc: '选中技能（阶段 3）' },
+        { name: 'onTemplateVisibleChange', payload: 'visible', desc: '模版面板显隐变化（阶段 3）' },
+        { name: 'onConfigureChange', payload: '(value, changed)', desc: '配置区变更（阶段 4）' },
+        { name: 'onFocus', payload: 'event', desc: '编辑区聚焦' },
+        { name: 'onBlur', payload: 'event', desc: '编辑区失焦' },
+        { name: 'onPaste', payload: 'files', desc: '粘贴（携带剪贴板文件）' },
+    ],
+    slots: [
+        { name: 'renderActionArea', payload: '{ canSend, generating }', desc: '自定义发送/停止按钮区' },
+        { name: 'renderReference', payload: 'reference', desc: '自定义单条引用渲染（阶段 2）' },
+        { name: 'renderSuggestionItem', payload: '{ suggestion, active }', desc: '自定义单条建议渲染（阶段 2）' },
+        { name: 'renderTopSlot', payload: '{ references, attachments }', desc: '自定义 top slot 渲染（阶段 2）' },
+        { name: 'renderSkillItem', payload: '{ skill, active }', desc: '自定义单条技能渲染（阶段 3）' },
+        { name: 'renderTemplate', payload: '{ skill, setContent }', desc: '模版面板渲染（阶段 3）' },
+        { name: 'renderConfigureArea', payload: '()', desc: 'footer 配置区渲染（放 Configure 子组件，阶段 4）' },
+        { name: 'renderUploadButton', payload: '{ openFileDialog, disabled, attachments }', desc: '自定义上传按钮 UI（保留内置上传/粘贴逻辑）' },
+    ],
+    methods: [
+        { name: 'setContent', desc: '设置编辑器内容' },
+        { name: 'focusEditor', desc: '聚焦编辑器' },
+        { name: 'getText', desc: '取纯文本' },
+        { name: 'getHTML', desc: '取 HTML' },
+        { name: 'getEditor', desc: '取 tiptap Editor 实例' },
+        { name: 'clearContent', desc: '清空编辑器内容' },
+        { name: 'changeTemplateVisible', desc: '显隐模版面板（阶段 3）' },
+        { name: 'getConfigureValue', desc: '取当前配置区值（阶段 4）' },
+        { name: 'deleteContent', desc: '删除编辑器中匹配 content.text 的一段' },
+        { name: 'setContentWhileSaveTool', desc: '设置内容但保留当前技能 slot 前缀' },
+        { name: 'deleteUploadFile', desc: '从附件列表删除一项' },
+    ],
+    a11y: {
+        role: '编辑区 role=textbox aria-multiline；建议/技能面板 role=listbox / 项 role=option aria-selected；模版按钮 aria-expanded；引用 chip 名称与删除为平级 button（避免 nested-interactive）；skill-slot chip 含删除按钮；input-slot 可编辑填空空态显示 placeholder（aria-hidden）；Configure.Mcp 下拉 role=menuitemcheckbox；aria-label 全走 i18n',
+        keyboard: 'Enter 发送（sendHotKey=enter，Shift+Enter 换行）/ Shift+Enter 发送；建议/技能面板可见时 ↑↓ 环绕导航、Enter 选中高亮项、Esc 关闭；空编辑区按 skillHotKey 弹技能面板；IME 组字中不发送；generating 时 Enter 不发送',
+    },
+    tokens: ['--cd-ai-chat-input-*（容器/编辑区/占位符/上传图标/发送-停止/引用条/建议-技能面板/skill-slot chip/模版按钮，深浅双主题；配置区 Button 复用 template/primary token）'],
+    examples: [
+        { title: '基础输入', desc: 'defaultContent + placeholder + onMessageSend' },
+        { title: '受控发送态', desc: 'canSend + generating + onStopGenerate' },
+        { title: '快捷键', desc: "sendHotKey='shift+enter'" },
+        { title: '附件', desc: 'showUploadButton + uploadProps + onUploadChange' },
+        { title: '引用', desc: 'references + onReferenceClick/onReferenceDelete + renderReference' },
+        { title: '建议', desc: 'suggestions + onSuggestClick + renderSuggestionItem（↑↓/Enter/Esc）' },
+        { title: '技能', desc: 'skills + skillHotKey + onSkillChange（选中插入 skill-slot 节点）' },
+        { title: '模版', desc: 'skill.hasTemplate + renderTemplate（模版按钮弹面板 setContent）' },
+        { title: '配置区', desc: 'renderConfigureArea + ConfigureSelect/Button/RadioButton + onConfigureChange（值进 setup）' },
+        { title: '接入对话', desc: 'messageToChatInput 把发送载荷转 Message 喂 AIChatDialogue（Adapter 桥）' },
+        { title: '模版填空节点', desc: 'getSelectSlotHTML/getInputSlotHTML 在模版嵌内联下拉/可编辑填空（select-slot/input-slot）' },
+        { title: 'MCP 配置', desc: 'AIChatInputConfigureMcp 多选 MCP 服务，选中集进 setup' },
+    ],
+};

package/dist/ai-chat-input/select-slot-extension.d.ts

@@ -0,0 +1,16 @@
+/**
+ * selectSlot tiptap 自定义节点（可选补充）。对齐 Semi extension/selectSlot：
+ * inline atom 节点，attrs（value/options[JSON]），parseHTML `<select-slot>`，
+ * NodeView 用 svelte-tiptap 的 SvelteNodeViewRenderer 渲染 SelectSlotNode.svelte（内联下拉）。
+ *
+ * 工厂形态同 skill-slot-extension：@tiptap/core 与 svelte-tiptap 由调用方在动态 import 链内提供，
+ * 避免把 tiptap 内核拖进主 bundle。
+ */
+import type { Node as TiptapNode, Extension } from '@tiptap/core';
+import type { SvelteNodeViewRenderer } from 'svelte-tiptap';
+type NodeCtor = typeof TiptapNode;
+type MergeAttributes = (...args: Record<string, unknown>[]) => Record<string, unknown>;
+type SvelteNodeViewRendererFn = typeof SvelteNodeViewRenderer;
+export declare function createSelectSlotExtension(Node: NodeCtor, mergeAttributes: MergeAttributes, svelteNodeViewRenderer: SvelteNodeViewRendererFn): Extension | ReturnType<NodeCtor['create']>;
+export {};
+//# sourceMappingURL=select-slot-extension.d.ts.map

package/dist/ai-chat-input/select-slot-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-slot-extension.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/select-slot-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG5D,KAAK,QAAQ,GAAG,OAAO,UAAU,CAAC;AAClC,KAAK,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvF,KAAK,wBAAwB,GAAG,OAAO,sBAAsB,CAAC;AAE9D,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,eAAe,EAChC,sBAAsB,EAAE,wBAAwB,GAC/C,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAsC5C"}

package/dist/ai-chat-input/select-slot-extension.js

@@ -0,0 +1,35 @@
+import SelectSlotNode from './SelectSlotNode.svelte';
+export function createSelectSlotExtension(Node, mergeAttributes, svelteNodeViewRenderer) {
+    return Node.create({
+        name: 'selectSlot',
+        inline: true,
+        group: 'inline',
+        atom: true,
+        selectable: false,
+        addAttributes() {
+            return {
+                value: {
+                    default: '',
+                    parseHTML: (el) => el.getAttribute('value'),
+                    renderHTML: (attrs) => ({ value: attrs.value }),
+                },
+                options: {
+                    default: '',
+                    parseHTML: (el) => el.getAttribute('options') ?? '',
+                    renderHTML: (attrs) => attrs.options ? { options: attrs.options } : {},
+                },
+                // 光标处理 plugin 靠此标记识别自定义节点（与 input-slot/skill-slot 共用锚点逻辑）。
+                isCustomSlot: { default: true, rendered: false },
+            };
+        },
+        parseHTML() {
+            return [{ tag: 'select-slot' }];
+        },
+        renderHTML({ HTMLAttributes }) {
+            return ['select-slot', mergeAttributes(HTMLAttributes)];
+        },
+        addNodeView() {
+            return svelteNodeViewRenderer(SelectSlotNode);
+        },
+    });
+}

package/dist/ai-chat-input/skill-slot-extension.d.ts

@@ -0,0 +1,22 @@
+/**
+ * skillSlot tiptap 自定义节点（阶段 3）。对齐 Semi extension/skillSlot：
+ * inline atom 节点，attrs（value/label/hasTemplate），parseHTML `<skill-slot>`，
+ * NodeView 用 svelte-tiptap 的 SvelteNodeViewRenderer 渲染 SkillSlotNode.svelte。
+ *
+ * 工厂形态：@tiptap/core 与 svelte-tiptap 由调用方在动态 import 链内提供，避免把
+ * tiptap 内核拖进主 bundle（见 AIChatInput.svelte 的懒加载）。
+ */
+import type { Node as TiptapNode, Extension } from '@tiptap/core';
+import type { SvelteNodeViewRenderer } from 'svelte-tiptap';
+type NodeCtor = typeof TiptapNode;
+type MergeAttributes = (...args: Record<string, unknown>[]) => Record<string, unknown>;
+type SvelteNodeViewRendererFn = typeof SvelteNodeViewRenderer;
+/**
+ * 创建 skillSlot 节点扩展。
+ * @param Node @tiptap/core 的 Node
+ * @param mergeAttributes @tiptap/core 的 mergeAttributes
+ * @param svelteNodeViewRenderer svelte-tiptap 的 SvelteNodeViewRenderer
+ */
+export declare function createSkillSlotExtension(Node: NodeCtor, mergeAttributes: MergeAttributes, svelteNodeViewRenderer: SvelteNodeViewRendererFn): Extension | ReturnType<NodeCtor['create']>;
+export {};
+//# sourceMappingURL=skill-slot-extension.d.ts.map

package/dist/ai-chat-input/skill-slot-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-slot-extension.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/skill-slot-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG5D,KAAK,QAAQ,GAAG,OAAO,UAAU,CAAC;AAClC,KAAK,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvF,KAAK,wBAAwB,GAAG,OAAO,sBAAsB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,eAAe,EAChC,sBAAsB,EAAE,wBAAwB,GAC/C,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CA0C5C"}

package/dist/ai-chat-input/skill-slot-extension.js

@@ -0,0 +1,46 @@
+import SkillSlotNode from './SkillSlotNode.svelte';
+/**
+ * 创建 skillSlot 节点扩展。
+ * @param Node @tiptap/core 的 Node
+ * @param mergeAttributes @tiptap/core 的 mergeAttributes
+ * @param svelteNodeViewRenderer svelte-tiptap 的 SvelteNodeViewRenderer
+ */
+export function createSkillSlotExtension(Node, mergeAttributes, svelteNodeViewRenderer) {
+    return Node.create({
+        name: 'skillSlot',
+        inline: true,
+        group: 'inline',
+        atom: true,
+        selectable: false,
+        addAttributes() {
+            return {
+                value: {
+                    default: '',
+                    parseHTML: (el) => el.getAttribute('data-value'),
+                    renderHTML: (attrs) => ({ 'data-value': attrs.value }),
+                },
+                label: {
+                    default: '',
+                    parseHTML: (el) => el.getAttribute('data-label'),
+                    renderHTML: (attrs) => ({ 'data-label': attrs.label }),
+                },
+                hasTemplate: {
+                    default: false,
+                    parseHTML: (el) => el.getAttribute('data-template') === 'true',
+                    renderHTML: (attrs) => ({ 'data-template': attrs.hasTemplate }),
+                },
+                // 光标处理 plugin 靠此标记识别自定义节点（与 input-slot/select-slot 共用锚点逻辑）。
+                isCustomSlot: { default: true, rendered: false },
+            };
+        },
+        parseHTML() {
+            return [{ tag: 'skill-slot' }];
+        },
+        renderHTML({ HTMLAttributes }) {
+            return ['skill-slot', mergeAttributes(HTMLAttributes)];
+        },
+        addNodeView() {
+            return svelteNodeViewRenderer(SkillSlotNode);
+        },
+    });
+}