# 弹窗 API

从公开源码生成的签名、参数、返回值与数据字段。

以下签名与说明从包的公开入口和 JSDoc 提取；中文说明与当前源码对账。Vue 组件接入见[嵌入 Vue 工作台](/guide/vue)。

## 独立工作台

### openTextDiagramDialog

`@quirekit/text-diagram-editor` · MIT

根据 options 打开一个独立的编辑请求，返回幂等的取消句柄。

```ts
function openTextDiagramDialog(options: TextDiagramDialogOptions): TextDiagramDialogHandle
```

### TextDiagramDialogOptions

`@quirekit/text-diagram-editor` · MIT

由独立宿主持有的一个文本绘图任务。

```ts
export interface TextDiagramDialogOptions {
    readonly request: TextDiagramEditRequest;
    readonly ownerDocument: Document;
    readonly locale?: string;
    readonly theme?: QuireKitTheme;
    readonly signal?: AbortSignal;
}
```

**request** — 初始源码与最终原子提交的宿主所有者。

**ownerDocument** — 弹层所属的浏览器 Document。

**locale** — 宿主界面语言。

**theme** — 宿主主题，与持久化预览外观独立。

**signal** — 宿主任务的生命周期。

### TextDiagramDialogHandle

`@quirekit/text-diagram-editor` · MIT

懒加载弹窗挂载前后均可安全使用的句柄。

```ts
export interface TextDiagramDialogHandle {
    close(): void;
}
```

**close** — 取消并释放任务，不保存。

### textDiagramMessages

`@quirekit/text-diagram-editor` · MIT

根据宿主语言 locale 返回文本绘图拥有的全部界面文案。

```ts
function textDiagramMessages(locale?: string): { title: string; language: string; template: string; apply: string; source: string; preview: string; name: string; cancel: string; save: string; loading: string; empty: string; retry: string; svg: string; png: string; local: string; error: string; conflict: string; readonly: string; missing: string; composing: string; find: string; sourceHint: string; sourceLimit: string; }
```