@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/ai-chat-input/AIChatInput.svelte.d.ts

@@ -0,0 +1,146 @@
+import type { Snippet } from 'svelte';
+import type { Editor } from '@tiptap/core';
+import { type AIChatInputSendHotKey, type AIChatInputMessageContent, type AIChatInputContent, type AIChatInputChangePayload, type AIChatInputAttachment, type AIChatInputReference, type AIChatInputSuggestion, type AIChatInputSkill, type AIChatInputConfigureValue } from '@chenzy-design/core';
+interface Props {
+    /** 初始内容（HTML 或纯文本，tiptap Content）。 */
+    defaultContent?: string;
+    /** 占位文本（缺省走 locale AIChatInput.placeholder）。 */
+    placeholder?: string | undefined;
+    /**
+     * 是否可发送（对齐 Semi canSend）。未设置时按内容/附件推断；显式设置以此为准。
+     */
+    canSend?: boolean | undefined;
+    /** 生成中：发送按钮变停止按钮，Enter 不发送。 */
+    generating?: boolean;
+    /** 发送快捷键：enter（默认）/ shift+enter。 */
+    sendHotKey?: AIChatInputSendHotKey;
+    /** 是否展示上传按钮。 */
+    showUploadButton?: boolean;
+    /** 透传给内部 Upload 的 props。 */
+    uploadProps?: Record<string, unknown> | undefined;
+    /** 圆角样式（对齐 Semi round）。 */
+    round?: boolean;
+    /** 附加 tiptap extensions（阶段 1 追加到 StarterKit 之后）。 */
+    extensions?: unknown[];
+    /** 富文本节点归一覆盖（对齐 Semi transformer）。 */
+    transformer?: Map<string, (node: unknown) => AIChatInputContent> | undefined;
+    /** 内容变化回调。 */
+    onContentChange?: ((payload: AIChatInputChangePayload) => void) | undefined;
+    /** 发送回调，载荷对齐 Semi MessageContent。 */
+    onMessageSend?: ((message: AIChatInputMessageContent) => void) | undefined;
+    /** 停止生成回调。 */
+    onStopGenerate?: (() => void) | undefined;
+    /** 上传附件变化回调。 */
+    onUploadChange?: ((attachments: AIChatInputAttachment[]) => void) | undefined;
+    /** 自定义发送/停止按钮区渲染（对齐 Semi renderActionArea 子集）。 */
+    renderActionArea?: Snippet<[{
+        canSend: boolean;
+        generating: boolean;
+    }]> | undefined;
+    /** 受控引用列表，渲染于编辑区上方 top area（对齐 Semi references）。 */
+    references?: AIChatInputReference[];
+    /** 是否展示引用条（对齐 Semi showReference，默认 true）。 */
+    showReference?: boolean;
+    /** 自定义单条引用渲染（对齐 Semi renderReference）。 */
+    renderReference?: Snippet<[AIChatInputReference]> | undefined;
+    /** 引用点击回调。 */
+    onReferenceClick?: ((reference: AIChatInputReference) => void) | undefined;
+    /** 引用删除回调。 */
+    onReferenceDelete?: ((reference: AIChatInputReference) => void) | undefined;
+    /** 建议列表：聚焦空编辑区时弹出面板（对齐 Semi suggestions）。 */
+    suggestions?: AIChatInputSuggestion[];
+    /** 自定义单条建议渲染（对齐 Semi renderSuggestionItem）。 */
+    renderSuggestionItem?: Snippet<[{
+        suggestion: AIChatInputSuggestion;
+        active: boolean;
+    }]> | undefined;
+    /**
+     * 建议点击/选中回调。未提供时默认把建议文本 setContent 进编辑器。
+     * 提供时以回调为准（不再默认插入）。
+     */
+    onSuggestClick?: ((suggestion: AIChatInputSuggestion) => void) | undefined;
+    /** 自定义 top slot 渲染（对齐 Semi renderTopSlot）。 */
+    renderTopSlot?: Snippet<[{
+        references: AIChatInputReference[];
+        attachments: AIChatInputAttachment[];
+    }]> | undefined;
+    /** top slot 相对引用条的位置（对齐 Semi topSlotPosition，默认 top）。 */
+    topSlotPosition?: 'top' | 'bottom';
+    /** 技能列表：空编辑区按 skillHotKey 弹出面板，选中后插入 skillSlot 节点（对齐 Semi skills）。 */
+    skills?: AIChatInputSkill[];
+    /** 触发技能面板的按键（对齐 Semi skillHotKey，默认 '/'）。 */
+    skillHotKey?: string;
+    /** 自定义单条技能渲染（对齐 Semi renderSkillItem）。 */
+    renderSkillItem?: Snippet<[{
+        skill: AIChatInputSkill;
+        active: boolean;
+    }]> | undefined;
+    /** 技能选中回调。 */
+    onSkillChange?: ((skill: AIChatInputSkill) => void) | undefined;
+    /**
+     * 模版面板渲染（对齐 Semi renderTemplate）：当前技能 hasTemplate 时，点击模版按钮弹出，
+     * 参数 (skill, setContent)——调 setContent 把模版内容填入编辑器。
+     */
+    renderTemplate?: Snippet<[{
+        skill: AIChatInputSkill;
+        setContent: (html: string) => void;
+    }]> | undefined;
+    /** 是否展示模版按钮（对齐 Semi showTemplateButton，默认 true；仅当前技能 hasTemplate 时生效）。 */
+    showTemplateButton?: boolean;
+    /** 模版面板显隐变化回调。 */
+    onTemplateVisibleChange?: ((visible: boolean) => void) | undefined;
+    /**
+     * 配置区渲染（对齐 Semi renderConfigureArea）：渲染于 footer 左侧。里面放
+     * AIChatInputConfigureSelect/Button/RadioButton 等（经 configure context 绑定），
+     * 其值发送时并入 MessageContent.setup。
+     */
+    renderConfigureArea?: Snippet | undefined;
+    /** 配置区初始值（对齐 Semi Configure defaultValue）。 */
+    configureDefaultValue?: AIChatInputConfigureValue;
+    /** 配置区变更回调（value 为全量，changed 为本次变更字段，对齐 Semi onConfigureChange）。 */
+    onConfigureChange?: ((value: AIChatInputConfigureValue, changed: AIChatInputConfigureValue) => void) | undefined;
+    /** 是否在 top area 展示上传附件列表（对齐 Semi showUploadFile，默认 true）。 */
+    showUploadFile?: boolean;
+    /**
+     * 自定义上传按钮 UI（对齐 Semi renderUploadButton），保留内置上传/粘贴逻辑。
+     * 参数 defaultNode=默认按钮、openFileDialog=打开文件选择、disabled、attachments。
+     */
+    renderUploadButton?: Snippet<[
+        {
+            openFileDialog: () => void;
+            disabled: boolean;
+            attachments: AIChatInputAttachment[];
+        }
+    ]> | undefined;
+    /** generating 从 false→true 时清空输入（对齐 Semi clearContentOnGenerating，默认 true）。 */
+    clearContentOnGenerating?: boolean;
+    /** 编辑区聚焦回调。 */
+    onFocus?: ((event: FocusEvent) => void) | undefined;
+    /** 编辑区失焦回调。 */
+    onBlur?: ((event: FocusEvent) => void) | undefined;
+    /** 粘贴回调（携带粘贴的文件，对齐 Semi onPaste；不改变默认粘贴行为）。 */
+    onPaste?: ((files: File[]) => void) | undefined;
+    /** 附加类名。 */
+    class?: string;
+    /** 内联样式。 */
+    style?: string;
+}
+declare const AIChatInput: import("svelte").Component<Props, {
+    setContent: (next: string) => void;
+    focusEditor: () => void;
+    getText: () => string;
+    getHTML: () => string;
+    getEditor: () => Editor | undefined;
+    clearContent: () => void;
+    changeTemplateVisible: (visible: boolean) => void;
+    getConfigureValue: () => AIChatInputConfigureValue;
+    deleteContent: (content: {
+        type?: string;
+        text?: string;
+    }) => void;
+    setContentWhileSaveTool: (next: string) => void;
+    deleteUploadFile: (attachment: AIChatInputAttachment) => void;
+}, "">;
+type AIChatInput = ReturnType<typeof AIChatInput>;
+export default AIChatInput;
+//# sourceMappingURL=AIChatInput.svelte.d.ts.map

package/dist/ai-chat-input/AIChatInput.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatInput.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/AIChatInput.svelte.ts"],"names":[],"mappings":"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"}

package/dist/ai-chat-input/AIChatInputConfigureButton.svelte

@@ -0,0 +1,94 @@
+<!--
+  AIChatInputConfigureButton — 配置区开关按钮字段（阶段 4，对齐 Semi Configure.Button）。
+  点击在 true/false 间切换，写回 value[field]；active 态用 aria-pressed + 类名标记。
+  用于「联网 / 深度思考」等布尔开关。放在 AIChatInput 的 renderConfigureArea 里使用。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { untrack } from 'svelte';
+  import { getConfigureContext } from './configure-context.js';
+
+  interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: boolean;
+    /** 按钮文案。 */
+    children?: Snippet;
+    /** 附加变更回调。 */
+    onChange?: ((value: boolean) => void) | undefined;
+    /** 禁用。 */
+    disabled?: boolean;
+  }
+
+  let { field, initValue, children, onChange, disabled = false }: Props = $props();
+
+  const ctx = getConfigureContext();
+
+  // untrack：切断对 configureValue 的追踪，避免 setField 写主组件 state → snippet 重渲染 → 自循环。
+  $effect(() => {
+    untrack(() => {
+      if (initValue !== undefined) ctx?.setField({ [field]: initValue }, true);
+    });
+    return () => untrack(() => ctx?.removeField(field));
+  });
+
+  const active = $derived(!!ctx?.getValue()[field]);
+
+  function handleClick(): void {
+    const next = !active;
+    ctx?.setField({ [field]: next });
+    onChange?.(next);
+  }
+</script>
+
+<button
+  type="button"
+  class="cd-ai-chat-input-configure-button"
+  class:cd-ai-chat-input-configure-button--active={active}
+  aria-pressed={active}
+  {disabled}
+  onclick={handleClick}
+>
+  {#if children}{@render children()}{/if}
+</button>
+
+<style>
+  .cd-ai-chat-input-configure-button {
+    appearance: none;
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    gap: var(--cd-spacing-extra-tight);
+    padding: var(--cd-ai-chat-input-action-padding) var(--cd-spacing-tight);
+    border: 1px solid var(--cd-color-border);
+    border-radius: var(--cd-ai-chat-input-action-radius);
+    background: transparent;
+    color: var(--cd-ai-chat-input-template-color);
+    font: inherit;
+    transition:
+      background var(--cd-ai-chat-input-motion-duration) ease,
+      border-color var(--cd-ai-chat-input-motion-duration) ease,
+      color var(--cd-ai-chat-input-motion-duration) ease;
+  }
+
+  .cd-ai-chat-input-configure-button:hover:not(:disabled) {
+    background: var(--cd-ai-chat-input-template-bg-hover);
+  }
+
+  .cd-ai-chat-input-configure-button--active {
+    border-color: var(--cd-color-primary);
+    background: var(--cd-color-primary-light-default);
+    color: var(--cd-color-primary);
+  }
+
+  .cd-ai-chat-input-configure-button:disabled {
+    cursor: not-allowed;
+    opacity: 0.6;
+  }
+
+  .cd-ai-chat-input-configure-button:focus-visible {
+    outline: 2px solid var(--cd-color-primary);
+    outline-offset: 2px;
+  }
+</style>

package/dist/ai-chat-input/AIChatInputConfigureButton.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: boolean;
+    /** 按钮文案。 */
+    children?: Snippet;
+    /** 附加变更回调。 */
+    onChange?: ((value: boolean) => void) | undefined;
+    /** 禁用。 */
+    disabled?: boolean;
+}
+declare const AIChatInputConfigureButton: import("svelte").Component<Props, {}, "">;
+type AIChatInputConfigureButton = ReturnType<typeof AIChatInputConfigureButton>;
+export default AIChatInputConfigureButton;
+//# sourceMappingURL=AIChatInputConfigureButton.svelte.d.ts.map

package/dist/ai-chat-input/AIChatInputConfigureButton.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatInputConfigureButton.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/AIChatInputConfigureButton.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKpC,UAAU,KAAK;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClD,UAAU;IACV,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAqCH,QAAA,MAAM,0BAA0B,2CAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}

package/dist/ai-chat-input/AIChatInputConfigureItem.svelte

@@ -0,0 +1,40 @@
+<!--
+  AIChatInputConfigureItem — 通用配置字段包装（对齐 Semi getConfigureItem HOC 的 Svelte 等价）。
+  把任意受控组件接入配置区 context：用 field 绑定，通过 children snippet 提供 { value, onChange }，
+  用户在里面放任意受控组件（如自定义 Switch/Slider）。变更经 onChange 写回 value[field]。
+  放在 AIChatInput 的 renderConfigureArea 里使用。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { untrack } from 'svelte';
+  import { getConfigureContext } from './configure-context.js';
+
+  interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: unknown;
+    /** 渲染受控组件，参数提供当前 value 与 onChange 写回。 */
+    children: Snippet<[{ value: unknown; onChange: (v: unknown) => void }]>;
+  }
+
+  let { field, initValue, children }: Props = $props();
+
+  const ctx = getConfigureContext();
+
+  // untrack：切断对 configureValue 的追踪，避免 setField → snippet 重渲染 → effect 自循环。
+  $effect(() => {
+    untrack(() => {
+      if (initValue !== undefined) ctx?.setField({ [field]: initValue }, true);
+    });
+    return () => untrack(() => ctx?.removeField(field));
+  });
+
+  const value = $derived(ctx?.getValue()[field]);
+
+  function handleChange(v: unknown): void {
+    ctx?.setField({ [field]: v });
+  }
+</script>
+
+{@render children({ value, onChange: handleChange })}

package/dist/ai-chat-input/AIChatInputConfigureItem.svelte.d.ts

@@ -0,0 +1,16 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: unknown;
+    /** 渲染受控组件，参数提供当前 value 与 onChange 写回。 */
+    children: Snippet<[{
+        value: unknown;
+        onChange: (v: unknown) => void;
+    }]>;
+}
+declare const AIChatInputConfigureItem: import("svelte").Component<Props, {}, "">;
+type AIChatInputConfigureItem = ReturnType<typeof AIChatInputConfigureItem>;
+export default AIChatInputConfigureItem;
+//# sourceMappingURL=AIChatInputConfigureItem.svelte.d.ts.map

package/dist/ai-chat-input/AIChatInputConfigureItem.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatInputConfigureItem.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/AIChatInputConfigureItem.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKpC,UAAU,KAAK;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;CACzE;AA+BH,QAAA,MAAM,wBAAwB,2CAAwC,CAAC;AACvE,KAAK,wBAAwB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC5E,eAAe,wBAAwB,CAAC"}

package/dist/ai-chat-input/AIChatInputConfigureMcp.svelte

@@ -0,0 +1,94 @@
+<!--
+  AIChatInputConfigureMcp — 配置区 MCP 服务多选字段（对齐 Semi Configure.Mcp）。
+  触发器显示「MCP · N」（N=已选数）；下拉菜单勾选启用的 MCP 服务，选中集写回 value[field]。
+  用 field 绑定配置区 context。放在 AIChatInput 的 renderConfigureArea 里使用。
+-->
+<script lang="ts">
+  import { untrack } from 'svelte';
+  import { Dropdown } from '../dropdown/index.js';
+  import { getConfigureContext } from './configure-context.js';
+
+  interface McpOption {
+    label: string;
+    value: string;
+  }
+
+  interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 可选 MCP 服务。 */
+    options?: McpOption[];
+    /** 初始已选（value 数组）。 */
+    initValue?: string[] | undefined;
+    /** 附加变更回调（已选 value 数组）。 */
+    onChange?: ((selected: string[]) => void) | undefined;
+  }
+
+  let { field, options = [], initValue, onChange }: Props = $props();
+
+  const ctx = getConfigureContext();
+
+  // 仅挂载时注册初始值 + 卸载清理。untrack 切断对 configureValue 的追踪，避免
+  // setField 写主组件 state → snippet 重渲染 → effect 重跑的自循环。
+  $effect(() => {
+    untrack(() => {
+      if (initValue !== undefined) ctx?.setField({ [field]: initValue }, true);
+    });
+    return () => untrack(() => ctx?.removeField(field));
+  });
+
+  const selected = $derived((ctx?.getValue()[field] as string[] | undefined) ?? []);
+
+  // 已选项打勾（active，showTick 时显示对勾），点击 toggle。
+  function handleSelect(value: string): void {
+    const next = selected.includes(value)
+      ? selected.filter((v) => v !== value)
+      : [...selected, value];
+    ctx?.setField({ [field]: next });
+    onChange?.(next);
+  }
+</script>
+
+<Dropdown trigger="click" clickToHide={false} showTick>
+  <button type="button" class="cd-ai-chat-input-configure-mcp-trigger">
+    MCP · {selected.length}
+  </button>
+  {#snippet render()}
+    <Dropdown.Menu>
+      {#each options as o (o.value)}
+        <Dropdown.Item
+          key={o.value}
+          active={selected.includes(o.value)}
+          onClick={() => handleSelect(o.value)}
+        >
+          {o.label}
+        </Dropdown.Item>
+      {/each}
+    </Dropdown.Menu>
+  {/snippet}
+</Dropdown>
+
+<style>
+  .cd-ai-chat-input-configure-mcp-trigger {
+    appearance: none;
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    padding: var(--cd-ai-chat-input-action-padding) var(--cd-spacing-tight);
+    border: 1px solid var(--cd-color-border);
+    border-radius: var(--cd-ai-chat-input-action-radius);
+    background: transparent;
+    color: var(--cd-ai-chat-input-template-color);
+    font: inherit;
+    transition: background var(--cd-ai-chat-input-motion-duration) ease;
+  }
+
+  .cd-ai-chat-input-configure-mcp-trigger:hover {
+    background: var(--cd-ai-chat-input-template-bg-hover);
+  }
+
+  .cd-ai-chat-input-configure-mcp-trigger:focus-visible {
+    outline: 2px solid var(--cd-color-primary);
+    outline-offset: 2px;
+  }
+</style>

package/dist/ai-chat-input/AIChatInputConfigureMcp.svelte.d.ts

@@ -0,0 +1,18 @@
+interface McpOption {
+    label: string;
+    value: string;
+}
+interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 可选 MCP 服务。 */
+    options?: McpOption[];
+    /** 初始已选（value 数组）。 */
+    initValue?: string[] | undefined;
+    /** 附加变更回调（已选 value 数组）。 */
+    onChange?: ((selected: string[]) => void) | undefined;
+}
+declare const AIChatInputConfigureMcp: import("svelte").Component<Props, {}, "">;
+type AIChatInputConfigureMcp = ReturnType<typeof AIChatInputConfigureMcp>;
+export default AIChatInputConfigureMcp;
+//# sourceMappingURL=AIChatInputConfigureMcp.svelte.d.ts.map

package/dist/ai-chat-input/AIChatInputConfigureMcp.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatInputConfigureMcp.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/AIChatInputConfigureMcp.svelte.ts"],"names":[],"mappings":"AAQE,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,KAAK;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACvD;AAqDH,QAAA,MAAM,uBAAuB,2CAAwC,CAAC;AACtE,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC1E,eAAe,uBAAuB,CAAC"}

package/dist/ai-chat-input/AIChatInputConfigureRadioButton.svelte

@@ -0,0 +1,52 @@
+<!--
+  AIChatInputConfigureRadioButton — 配置区单选按钮组字段（阶段 4，对齐 Semi Configure.RadioButton）。
+  用 field 绑定，包裹项目 RadioGroup（type='button'）。放在 renderConfigureArea 里使用。
+-->
+<script lang="ts">
+  import { untrack } from 'svelte';
+  import { RadioGroup } from '../radio/index.js';
+  import { getConfigureContext } from './configure-context.js';
+  import type { RadioValue, RadioChangeEvent } from '../radio/context.js';
+
+  interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: RadioValue;
+    /** 单选项（透传给 RadioGroup）。 */
+    options?: unknown[];
+    /** 附加变更回调。 */
+    onChange?: ((value: RadioValue) => void) | undefined;
+    /** 其余透传给 RadioGroup。 */
+    [key: string]: unknown;
+  }
+
+  let { field, initValue, options, onChange, ...rest }: Props = $props();
+
+  const ctx = getConfigureContext();
+
+  // untrack：切断对 configureValue 的追踪，避免 setField 写主组件 state → snippet 重渲染 → 自循环。
+  $effect(() => {
+    untrack(() => {
+      if (initValue !== undefined) ctx?.setField({ [field]: initValue }, true);
+    });
+    return () => untrack(() => ctx?.removeField(field));
+  });
+
+  const value = $derived(ctx?.getValue()[field] as RadioValue | undefined);
+
+  function handleChange(e: RadioChangeEvent): void {
+    const v = e.target.value;
+    if (v === undefined) return;
+    ctx?.setField({ [field]: v });
+    onChange?.(v);
+  }
+</script>
+
+<RadioGroup
+  {...rest}
+  type="button"
+  options={options as never}
+  {...(value !== undefined ? { value } : {})}
+  onChange={handleChange}
+/>

package/dist/ai-chat-input/AIChatInputConfigureRadioButton.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { RadioValue } from '../radio/context.js';
+interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: RadioValue;
+    /** 单选项（透传给 RadioGroup）。 */
+    options?: unknown[];
+    /** 附加变更回调。 */
+    onChange?: ((value: RadioValue) => void) | undefined;
+    /** 其余透传给 RadioGroup。 */
+    [key: string]: unknown;
+}
+declare const AIChatInputConfigureRadioButton: import("svelte").Component<Props, {}, "">;
+type AIChatInputConfigureRadioButton = ReturnType<typeof AIChatInputConfigureRadioButton>;
+export default AIChatInputConfigureRadioButton;
+//# sourceMappingURL=AIChatInputConfigureRadioButton.svelte.d.ts.map

package/dist/ai-chat-input/AIChatInputConfigureRadioButton.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatInputConfigureRadioButton.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/AIChatInputConfigureRadioButton.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,qBAAqB,CAAC;AAGtE,UAAU,KAAK;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,cAAc;IACd,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,wBAAwB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAmCH,QAAA,MAAM,+BAA+B,2CAAwC,CAAC;AAC9E,KAAK,+BAA+B,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAC1F,eAAe,+BAA+B,CAAC"}

package/dist/ai-chat-input/AIChatInputConfigureSelect.svelte

@@ -0,0 +1,50 @@
+<!--
+  AIChatInputConfigureSelect — 配置区下拉字段（阶段 4，对齐 Semi Configure.Select）。
+  用 field 绑定到配置区 context：读 value[field] 作 Select value，变更时写回 setField({[field]: v})。
+  放在 AIChatInput 的 renderConfigureArea 里使用（外层需有 AIChatInput 提供的 configure context）。
+-->
+<script lang="ts">
+  import { untrack } from 'svelte';
+  import { Select } from '../select/index.js';
+  import { getConfigureContext } from './configure-context.js';
+
+  interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: unknown;
+    /** 下拉选项（透传给 Select）。 */
+    options?: unknown[];
+    /** 附加变更回调（在写回 context 之外，额外通知）。 */
+    onChange?: ((value: unknown) => void) | undefined;
+    /** 其余透传给 Select 的 props。 */
+    [key: string]: unknown;
+  }
+
+  let { field, initValue, options, onChange, ...rest }: Props = $props();
+
+  const ctx = getConfigureContext();
+
+  // 注册初始值 + 卸载时清理该字段（对齐 Semi getConfigureItem 的 useEffect）。
+  // untrack：切断对 configureValue 的追踪，避免 setField 写主组件 state → snippet 重渲染 → 自循环。
+  $effect(() => {
+    untrack(() => {
+      if (initValue !== undefined) ctx?.setField({ [field]: initValue }, true);
+    });
+    return () => untrack(() => ctx?.removeField(field));
+  });
+
+  const value = $derived(ctx?.getValue()[field]);
+
+  function handleChange(v: unknown): void {
+    ctx?.setField({ [field]: v });
+    onChange?.(v);
+  }
+</script>
+
+<Select
+  {...rest}
+  optionList={options as never}
+  value={value as never}
+  onChange={handleChange as never}
+/>

package/dist/ai-chat-input/AIChatInputConfigureSelect.svelte.d.ts

@@ -0,0 +1,16 @@
+interface Props {
+    /** 绑定的配置字段名。 */
+    field: string;
+    /** 初始值（注册到配置区，不触发 onConfigureChange）。 */
+    initValue?: unknown;
+    /** 下拉选项（透传给 Select）。 */
+    options?: unknown[];
+    /** 附加变更回调（在写回 context 之外，额外通知）。 */
+    onChange?: ((value: unknown) => void) | undefined;
+    /** 其余透传给 Select 的 props。 */
+    [key: string]: unknown;
+}
+declare const AIChatInputConfigureSelect: import("svelte").Component<Props, {}, "">;
+type AIChatInputConfigureSelect = ReturnType<typeof AIChatInputConfigureSelect>;
+export default AIChatInputConfigureSelect;
+//# sourceMappingURL=AIChatInputConfigureSelect.svelte.d.ts.map

package/dist/ai-chat-input/AIChatInputConfigureSelect.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatInputConfigureSelect.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/AIChatInputConfigureSelect.svelte.ts"],"names":[],"mappings":"AAQE,UAAU,KAAK;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClD,4BAA4B;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiCH,QAAA,MAAM,0BAA0B,2CAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}

package/dist/ai-chat-input/InputSlotNode.svelte

@@ -0,0 +1,50 @@
+<!--
+  InputSlotNode — tiptap inputSlot 自定义节点的 Svelte NodeView（可选补充）。
+  对齐 Semi InputSlotComponent：可编辑的内联填空节点（NodeViewContent 承载子文本），
+  空态显示 placeholder。通常用于 renderTemplate 模版填空。用 svelte-tiptap NodeViewWrapper +
+  NodeViewContent 承载。props 由 SvelteNodeViewRenderer 注入（NodeViewProps：node）。
+
+  注：光标进出节点的精细处理（Semi 用零宽字符 + ProseMirror plugin 做全套微调）此处简化——
+  仅保证空态 placeholder 与内容归一正确，复杂光标微调留浏览器/后续（见 spec §0.7）。
+-->
+<script lang="ts">
+  import type { NodeViewProps } from '@tiptap/core';
+  import { NodeViewWrapper, NodeViewContent } from 'svelte-tiptap';
+
+  const ZERO_WIDTH = '';
+
+  let { node }: NodeViewProps = $props();
+
+  const placeholder = $derived((node.attrs.placeholder as string) || '');
+  // 空态：内容为空或仅零宽锚点。
+  const isEmpty = $derived(node.textContent === '' || node.textContent === ZERO_WIDTH);
+</script>
+
+<NodeViewWrapper as="span" class="cd-ai-chat-input-input-slot" data-empty={isEmpty || undefined}>
+  {#if isEmpty && placeholder}
+    <span class="cd-ai-chat-input-input-slot-placeholder" contenteditable="false" aria-hidden="true"
+      >{placeholder}</span
+    >
+  {/if}
+  <NodeViewContent as="span" class="cd-ai-chat-input-input-slot-content" />
+</NodeViewWrapper>
+
+<style>
+  /* NodeViewWrapper 的 class 在运行时注入，用 :global 命中（避免 unused-selector）。 */
+  :global(.cd-ai-chat-input-input-slot) {
+    display: inline;
+    position: relative;
+    border-bottom: 1px dashed var(--cd-color-primary);
+    padding: 0 var(--cd-spacing-extra-tight);
+  }
+
+  :global(.cd-ai-chat-input-input-slot-placeholder) {
+    color: var(--cd-ai-chat-input-placeholder-color);
+    pointer-events: none;
+    user-select: none;
+  }
+
+  :global(.cd-ai-chat-input-input-slot-content) {
+    outline: none;
+  }
+</style>

package/dist/ai-chat-input/InputSlotNode.svelte.d.ts

@@ -0,0 +1,5 @@
+import type { NodeViewProps } from '@tiptap/core';
+declare const InputSlotNode: import("svelte").Component<NodeViewProps, {}, "">;
+type InputSlotNode = ReturnType<typeof InputSlotNode>;
+export default InputSlotNode;
+//# sourceMappingURL=InputSlotNode.svelte.d.ts.map

package/dist/ai-chat-input/InputSlotNode.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputSlotNode.svelte.d.ts","sourceRoot":"","sources":["../../src/ai-chat-input/InputSlotNode.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4BlD,QAAA,MAAM,aAAa,mDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}