@airalogy/aimd-renderer 2.6.0 → 2.8.0

package/README.md

@@ -30,6 +30,20 @@ console.log(html)
 console.log(fields)
 ```
 
+## Review Marks
+
+Renderer output supports CriticMarkup-style review marks in normal Markdown text:
+
+| Purpose | AIMD source |
+| --- | --- |
+| Addition | `{++added text++}` |
+| Deletion | `{--deleted text--}` |
+| Substitution | `{~~old wording~>new wording~~}` |
+| Comment | `{>>review note<<}` |
+| Highlight | `{==important text==}` |
+
+These marks render through `renderToHtml`, `renderToVue`, and readonly `AiralogyMarkdown` fields. Inline code and fenced code blocks keep the source text literal.
+
 ## Assigner Visibility
 
 ```ts
@@ -96,6 +110,30 @@ const { nodes } = await renderToVue(content, {
 
 Use this when you want a ready-made Vue step-card surface without first mapping AIMD nodes into your own custom elements.
 
+## Readonly Record Rendering
+
+```ts
+import { renderReadonlyRecordToVue } from "@airalogy/aimd-renderer"
+
+const { nodes } = await renderReadonlyRecordToVue(protocolContent, {
+  data: {
+    var: {
+      sample_id: { value: "S-001" },
+      site_photo: "airalogy.id.file.site-photo.png",
+    },
+    check: { prepared: { checked: true } },
+  },
+}, {
+  resolveAsset: ({ fileId, fieldPath }) => assets.get(fileId ?? "") ?? assets.get(fieldPath) ?? null,
+})
+```
+
+Use this when a host app needs to show a completed AIMD protocol as a static document. The helper accepts either a Record payload wrapper with `data` or the `data` object itself, then renders the protocol in a readonly field context.
+
+`resolveAsset` lets the host map Record file ids, field paths, or archive manifest entries to `ReadonlyRecordAsset` objects. The renderer uses that mapping to show image/audio/video fields inline, render ordinary files as readonly links, and resolve Markdown image `src` values that point at Airalogy file ids. Archive readers should keep storage-specific work, such as building `blob:` URLs from `.aira` payloads, in the host app and pass only display-ready URLs into the renderer.
+
+Readonly `AiralogyMarkdown` values are rendered through the AIMD Vue renderer, so headings, lists, nested AIMD preview tokens, and resolved Markdown image assets appear as document content instead of raw Markdown source.
+
 Math styles are loaded automatically when calling async render APIs (`renderToHtml` / `renderToVue`) in browser environments.  
 Use `@airalogy/aimd-renderer/styles` only if you want to preload styles manually.
 

package/README.zh-CN.md

@@ -30,6 +30,20 @@ console.log(html)
 console.log(fields)
 ```
 
+## 审阅标记
+
+Renderer 输出支持普通 Markdown 文本中的 CriticMarkup 风格审阅标记：
+
+| 用途 | AIMD 源码 |
+| --- | --- |
+| 添加 | `{++新增文字++}` |
+| 删除 | `{--删除文字--}` |
+| 替换 | `{~~旧表述~>新表述~~}` |
+| 注释 | `{>>审阅备注<<}` |
+| 高亮 | `{==重点文字==}` |
+
+这些标记会通过 `renderToHtml`、`renderToVue` 和只读 `AiralogyMarkdown` 字段渲染出来。行内代码和 fenced 代码块会保留原始文本。
+
 ## Assigner 可见性
 
 ```ts
@@ -96,6 +110,30 @@ const { nodes } = await renderToVue(content, {
 
 当你想直接得到现成的 Vue 步骤卡片渲染，而不是先把 AIMD 节点映射到自定义元素时，可以使用这组 API。
 
+## 只读 Record 渲染
+
+```ts
+import { renderReadonlyRecordToVue } from "@airalogy/aimd-renderer"
+
+const { nodes } = await renderReadonlyRecordToVue(protocolContent, {
+  data: {
+    var: {
+      sample_id: { value: "S-001" },
+      site_photo: "airalogy.id.file.site-photo.png",
+    },
+    check: { prepared: { checked: true } },
+  },
+}, {
+  resolveAsset: ({ fileId, fieldPath }) => assets.get(fileId ?? "") ?? assets.get(fieldPath) ?? null,
+})
+```
+
+当宿主应用需要把已完成的 AIMD Protocol 展示为静态文档时，可以使用这个 helper。它既接受带 `data` 的 Record payload，也接受 `data` 对象本身，然后在只读字段上下文中渲染协议内容。
+
+`resolveAsset` 由宿主应用负责把 Record 文件 id、字段路径或 archive manifest 条目映射成 `ReadonlyRecordAsset`。renderer 会基于这个映射把图片、音频、视频字段内嵌渲染，把普通文件渲染为只读链接，并解析指向 Airalogy file id 的 Markdown 图片 `src`。`.aira` 读取、`blob:` URL 创建、对象存储签名 URL 等存储细节应留在宿主应用中，renderer 只接收可显示的 URL。
+
+只读 `AiralogyMarkdown` 值会通过 AIMD Vue renderer 渲染，因此标题、列表、嵌套 AIMD 预览 token，以及已解析的 Markdown 图片资源都会作为文档内容显示，而不是显示原始 Markdown 文本。
+
 在浏览器环境中调用异步渲染 API（`renderToHtml` / `renderToVue`）时，会自动加载公式样式。  
 只有在你希望手动预加载样式时，才需要引入 `@airalogy/aimd-renderer/styles`。