@qingwu-ui/ai-editor 0.9.0-beta.17 → 0.9.0-beta.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -5
- package/dist/editor/ai-editor.d.ts.map +1 -1
- package/dist/editor/extensions/code-block.d.ts.map +1 -1
- package/dist/editor/extensions/ime-commit-space-guard.d.ts +3 -0
- package/dist/editor/extensions/ime-commit-space-guard.d.ts.map +1 -0
- package/dist/editor/extensions/index.d.ts.map +1 -1
- package/dist/editor/extensions/slash-command.d.ts.map +1 -1
- package/dist/index.cjs +7 -7
- package/dist/index.js +145 -123
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -9,12 +9,14 @@
|
|
|
9
9
|
## 特性
|
|
10
10
|
|
|
11
11
|
- **智能辅助写作** - 续写、润色、精简、扩写、修正、翻译、自定义指令,基于 Vercel AI SDK 统一接口
|
|
12
|
+
- **AI 替换保护** - 选中 / 全文 AI 替换前弹确认弹窗列出将被移除的媒体;替换后孤儿媒体延迟 30s 删除,期间 `Ctrl+Z` 还原 URL 即取消,避免 undo 后资源 404
|
|
12
13
|
- **丰富的媒体嵌入** - 图片、视频(B站 / 直链 / 小红书)、音频、附件(支持 206+ 格式在线预览)
|
|
13
|
-
- **Markdown 粘贴** - Obsidian 风格的 `[[链接]]` 和 `![[图片]]`
|
|
14
|
+
- **Markdown 粘贴** - Obsidian 风格的 `[[链接]]` 和 `![[图片]]` 语法支持;粘贴外部 Markdown(Obsidian / Typora)时自动检测本地相对路径图片/附件,匹配剪贴板文件上传换链,找不到时引导文件夹选择 / 拖拽补救
|
|
15
|
+
- **文档目录(TOC)** - 宽屏桌面侧栏 + 移动端抽屉 + 只读态悬浮球入口;滚动自动跟踪当前章节并高亮,点击目录平滑跳转,悬浮框滚到顶/底后滚轮接力滚动正文
|
|
14
16
|
- **多存储后端** - 本地存储 / 阿里云 OSS / 腾讯云 COS / S3 兼容存储,配置持久化
|
|
15
17
|
- **中英双语** - 运行时可切换,无需刷新页面
|
|
16
18
|
- **斜杠命令** - `/` 快速插入标题、列表、图片、视频等
|
|
17
|
-
-
|
|
19
|
+
- **代码块** - 30+ 语言语法高亮(lowlight)、行号列、折叠/展开、语言图标,兼容 Obsidian 逐行 div 导出格式;Mermaid 图表渲染
|
|
18
20
|
- **视频播放** - [xgplayer](https://h5player.bytedance.com/)
|
|
19
21
|
- **文件预览** - 基于 @file-viewer/react-full,支持 Office / PDF / CAD / 压缩包等 206+ 格式
|
|
20
22
|
- **导出** - HTML / Markdown / JSON / 纯文本 / PDF
|
|
@@ -287,7 +289,7 @@ startBrowserClipperReceiver({
|
|
|
287
289
|
|
|
288
290
|
| 参数 | 类型 | 默认值 | 说明 |
|
|
289
291
|
|------|------|--------|------|
|
|
290
|
-
| `initialContent` | `string` | `""` |
|
|
292
|
+
| `initialContent` | `string \| object` | `""` | 初始内容:HTML 字符串(自动安全清洗 / Markdown 识别)或 ProseMirror JSON 文档对象(原样使用,宿主回显可直传 `getJSON()` 产物,避免二次解析失真);运行期变化会原地更新文档,不丢撤销栈 |
|
|
291
293
|
| `onChange` | `(html: string, json: object) => void` | - | 内容变化回调 |
|
|
292
294
|
| `placeholder` | `string` | `"输入 '/' 打开菜单…"` | 占位文本 |
|
|
293
295
|
| `mode` | `"edit" \| "view"` | `"edit"` | 编辑模式;`"view"` 为只读查看 |
|
|
@@ -300,8 +302,8 @@ startBrowserClipperReceiver({
|
|
|
300
302
|
| `style` | `React.CSSProperties` | - | 容器自定义样式 |
|
|
301
303
|
| `borderless` | `boolean` | `false` | 隐藏编辑器外边框 |
|
|
302
304
|
| `showToolbar` | `boolean` | `true` | 显示顶部工具栏(导出) |
|
|
303
|
-
| `showToc` | `boolean` | `true` |
|
|
304
|
-
| `showSearch` | `boolean` | `true` |
|
|
305
|
+
| `showToc` | `boolean` | `true` | 目录**默认展开状态**:`true` 默认展开;`false` 控件仍可用但默认收起(工具栏按钮 / 悬浮球 / 抽屉均可展开,不关闭目录功能)。运行期变化会同步进内部状态 |
|
|
306
|
+
| `showSearch` | `boolean` | `true` | 启用全文搜索:`true` 唤起 Ctrl+F 搜索浮层,`false` 禁用且不拦截快捷键 |
|
|
305
307
|
| `onEditorReady` | `(editor: Editor) => void` | - | 编辑器实例就绪回调 |
|
|
306
308
|
| `immediatelyRender` | `boolean` | - | 是否立即渲染编辑器;SSR/Next.js 配合 `dynamic` ssr:false 传 `true` |
|
|
307
309
|
|
|
@@ -362,6 +364,16 @@ setConfirmProvider(({ title, message, confirmText, cancelText, onConfirm, onCanc
|
|
|
362
364
|
|
|
363
365
|
- **导入选择**:拖入 MD 文件时优先走宿主 `chooseMd`(内置 `MdImportDialog`);未接入时回退到内置项目风格选择弹窗(渲染 / 附加 / 取消),不再使用原生 `window.confirm`。
|
|
364
366
|
|
|
367
|
+
#### 目录(TOC)宿主注意事项
|
|
368
|
+
|
|
369
|
+
- 入口:宽屏(≥64rem 且非全屏)显示工具栏「目录」按钮 + 右侧悬浮侧栏;窄屏 / 全屏改由抽屉承载(首次挂载自动展开一次);侧栏 / 抽屉未展示时(用户收起后,或只读 `mode="view"` 态且文档含标题)由悬浮球作为入口。
|
|
370
|
+
- 桌面侧栏与移动抽屉均经 `createPortal` 直挂 `document.body`(避免宿主 GSAP 入场 / 步骤切换动画的祖先 `transform` 抢走 `fixed` 包含块、被站点头部层叠上下文压制)。宿主**不要**以「编辑器容器后代」关系选择这两个面板,请用全局类 `.qingwu-toc-desktop` / `.qingwu-toc-drawer`。
|
|
371
|
+
- 编辑器实例常驻、仅靠祖先 `display:none` 切换视图的宿主:portal 出 body 的面板不会随隐藏容器一起消失,需按自身步骤 / 视图状态额外收掉,例如:
|
|
372
|
+
```css
|
|
373
|
+
body:has(.scene:not([data-step="1"])) > .qingwu-toc-desktop { display: none; }
|
|
374
|
+
```
|
|
375
|
+
- 滚动跟踪:滚动正文时目录实时高亮当前章节、激活项自动保持在目录视野内;悬浮框自身滚到顶 / 底后滚轮接力滚动正文;宿主使用 Lenis 时抽屉内已挂 `data-lenis-prevent` 放行原生滚动。
|
|
376
|
+
|
|
365
377
|
### 写作助手相关
|
|
366
378
|
|
|
367
379
|
```ts
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ai-editor.d.ts","sourceRoot":"","sources":["../../src/editor/ai-editor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAK3C,OAAO,EACL,KAAK,EAAE,EASR,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4JnE,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,aAAa;IACb,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9E;AAED,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,
|
|
1
|
+
{"version":3,"file":"ai-editor.d.ts","sourceRoot":"","sources":["../../src/editor/ai-editor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAK3C,OAAO,EACL,KAAK,EAAE,EASR,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4JnE,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,aAAa;IACb,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9E;AAED,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CA8uClD,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"code-block.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/code-block.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc;;;GA0B1B,CAAC;
|
|
1
|
+
{"version":3,"file":"code-block.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/code-block.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc;;;GA0B1B,CAAC;AAiKF,eAAO,MAAM,SAAS,4GAgLI,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ime-commit-space-guard.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/ime-commit-space-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAazC,eAAO,MAAM,mBAAmB,qBAoC9B,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAwCjD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAKvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAwCjD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAKvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAA2B,MAAM,iBAAiB,CAAC;AAEvF,OAAO,EACL,eAAe,EACf,UAAU,EACV,SAAS,EACT,2BAA2B,EAC3B,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,KAAK,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,GACX,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,sBAA2B,GAAG,YAAY,EAAE,CAsDvF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/slash-command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAU,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOrD,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,qBAAqB,gBAAgC,CAAC;AAEnE,uDAAuD;AACvD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,gBAAgB,EAAE,
|
|
1
|
+
{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../../../src/editor/extensions/slash-command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAU,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOrD,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,qBAAqB,gBAAgC,CAAC;AAEnE,uDAAuD;AACvD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,gBAAgB,EAAE,uBAsX7E;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAC1B,aAAa,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACxC,gBAAgB,EAAE,CAoLpB"}
|