@deot/docs-client 1.1.5 → 1.1.7

package/README.md

@@ -106,7 +106,7 @@ const { app, router, disconnect } = await bootstrap(window.$docs);
 | `base` | production 资源的基准 URL。可省略；未配置时由客户端在路由启动前根据当前地址推导。 |
 | `namespace` | IndexedDB 缓存隔离标识；未设置时使用规范化后的 `base`。 |
 | `repository` | 当前文档项目的远程仓库页面。Header 在语言与工具之间展示入口，并在新窗口打开；GitHub 地址还会用于生成默认 Footer 的 Issues、需求与 Releases 链接。 |
-| `modules` | 站点级裸模块名到 URL 的映射，对所有 Playground（含 Markdown）生效；远程 SFC 仍可通过实例 `builtinImportMap` 覆盖。`doc dev` 会把工作区源码编到 `/__docs/module/<包名>`；development 下可以把同名 key 指到该地址，直接打开 HTML 时不要使用它。 |
+| `modules` | 站点级裸模块名到 URL 的映射，对所有 Playground（含 Markdown）生效；各预览可通过实例 `options.builtinImportMap.imports` 覆盖，优先级高于站点配置和管理页覆盖；远程 SFC 也可通过实例 `builtinImportMap` 覆盖。`doc dev` 会把工作区源码编到 `/__docs/module/<包名>`；development 下可以把同名 key 指到该地址，直接打开 HTML 时不要使用它。 |
 | `styles` | 站点级预览 CSS 默认地址；同名 key 覆盖内置样式表，也可追加。管理页 `/:lang/__docs/playground-resource` 与 `modules` 同一张表管理。 |
 | `prefetch` | 空闲预加载开关或 `{ batchSize, idleTimeout }` 配置，默认开启。 |
 | `theme` | 主题开关或 `{ default: 'system' \| 'light' \| 'dark' }`，默认跟随系统。 |
@@ -234,8 +234,9 @@ const query = new URLSearchParams({ raw: encode(JSON.stringify(config)) });
 const href = `/__docs/preview?${query}`;
 ```
 
-`modules` 是模块说明符到 ESM URL 的映射，在当前远程 SFC 的导入表中覆盖站点默认，
-不修改全站配置。`playground` 复用现有组件参数，作用于 `.vue` 和 page.json 内的
+`modules` 是模块说明符到 ESM URL 的映射，仅覆盖当前远程 SFC 的导入表。
+`local: true` 与 `local: false` 均按「实例配置 > 管理页覆盖 > `$docs.modules` > 内置默认」合并，不修改全站配置。
+`playground` 复用现有组件参数，作用于 `.vue` 和 page.json 内的
 `docs:sfc` 块；省略时沿用站点默认，`styleless` 默认 `true`。
 支持 `local`、`styleless`、`previewScroller`（布尔值）、`views`（`runtime` / `files` 数组）、
 `viewport`（`auto`、宽度或宽高数组）、`previewInset`（数值或垂直/水平数组）、
@@ -243,9 +244,24 @@ const href = `/__docs/preview?${query}`;
 这里只检查 `playground` 是对象，并提取上述展示参数；具体参数由 Playground 自身处理，
 `files`、`entry` 等源码数据不接受链接覆盖。
 
-`/__docs/preview-config-generate` 提供表单实时生成链接、一键复制和打开预览。
-访问 `/__docs/preview-config-generate?raw=...` 自动解析并回填；也可粘贴现有
-`?raw=...` 或 `?url=...&styles=...` 预览链接进行解析。JSON 或字段无效时显示错误并停用复制。
+`/__docs/raw-editor` 提供通用 JSON 编辑器和目标地址，实时生成带 `raw` 的链接，支持复制和打开。
+JSON 可以是对象、数组或其他 JSON 值；目标页面负责验证自己的配置。默认目标为 preview，
+也可选择 markdown-editor 或输入 HTTP(S) / 相对地址，原有查询参数和 hash 会保留。
+访问 `?raw=...&target=...` 自动解码回填；粘贴已有 `?raw=...` 或 `?url=...&styles=...`
+链接也能导入。JSON 或目标地址无效时保留输入并停用链接操作。
+
+`/__docs/markdown-editor` 使用本仓库的 `Markdown` 组件实时预览，支持 `?url=...` 和相同的
+`?raw=...` 配置协议。`styles` 加载预览 CSS，`modules` 覆盖当前 Markdown Playground 的模块映射，
+`playground` 提供块级配置可覆盖的默认展示参数。相对图片和链接以实际加载的 Markdown 地址为基准。
+编辑区保留行号与撤销，编辑和预览都使用 `Scroller`；支持打开本地 Markdown、复制原文、
+重置初始内容、按 Markdown 块双向同步滚动及主题切换。同步默认关闭并保存设置。
+两栏之间的分隔线可拖动调整宽度，也可聚焦后使用左右方向键；窄屏继续上下排列。
+显式链接优先于草稿；裸路由恢复最近草稿，否则使用示例。重置远程/本地文件时恢复其初始内容，
+裸路由恢复示例；只有编辑、打开本地文件及重置会写入草稿。
+
+PDF 使用浏览器打印对话框，可另存为 PDF；正文、代码和表格保留文字，原始图片/SVG 保留其内容。
+最新 Markdown 和代码块挂载完成后可以导出，默认 A4 纵向、10mm 页边距及浅色打印排版。
+Playground iframe 的运行态与正文挂载完成不同，具体动态内容输出受浏览器打印能力影响。
 
 相对资源地址沿用现有 Resolver；源码依赖相对于源文件解析。
 缺失参数、不支持的资源以及加载或解析失败会显示页面错误。