ampless 1.0.0-alpha.45 → 1.0.0-alpha.46

package/docs/plugin-author-guide.ja.md

@@ -848,6 +848,12 @@ export default createAdminLayout(admin, { editorBootstrap: EditorBootstrap })
 
 `installAdminEditorExtensions` は idempotent で、render 時に client component 内で呼ばれる。admin の `<TiptapEditor>` は毎回 render 時に登録済みリストを built-in extensions の末尾に spread する。
 
+### markdown → tiptap の復元
+
+editor Node が markdown へ bare URL line として serialise される場合、逆方向の復元は paste rule ではなく `Node.parseHTML()` で扱う必要がある。admin の `markdown → tiptap` format switch は、まず markdown を HTML に変換する。GFM autolink により bare URL line は `<p><a href="https://...">https://...</a></p>` になり、その HTML を tiptap が document として parse する。paste rule は user paste / typing event 用なので、この HTML parse 経路では発火しない。
+
+embed 系 Node は、上記 paragraph shape 用の high-priority parse rule を追加し、必要に応じて他の HTML-to-tiptap 経路向けに `a[href]` rule も追加する。paragraph rule は「paragraph が単一 link だけを含み、その link text が `href` と同じ」場合だけ match させる。これにより parser は paragraph 全体を block embed Node に置換でき、embed の前に空 paragraph が残らない。`getAttrs` は URL を検証し、match しない link では `false` を返して通常の Link mark にフォールバックさせる。
+
 ### active source と完全無効化
 
 **エディタ配線の active source は `package.json#dependencies`**（= `node_modules`）であり、`cms.config.ts` ではない。

package/docs/plugin-author-guide.md

@@ -1104,6 +1104,24 @@ export default createAdminLayout(admin, { editorBootstrap: EditorBootstrap })
 inside a client component. The admin's `<TiptapEditor>` spreads the
 registered list onto its built-in extensions on every render.
 
+### Markdown to tiptap restoration
+
+If an editor Node serializes to markdown as a bare URL line, the reverse
+direction must be handled by `Node.parseHTML()`, not by paste rules. The
+admin's `markdown → tiptap` format switch first converts markdown to HTML;
+GFM autolinks emit a bare URL line as
+`<p><a href="https://...">https://...</a></p>`, then tiptap parses that
+HTML into a document. Paste rules only run for user paste / typing events,
+so they do not fire on this HTML parse path.
+
+Embed-style Nodes should add a high-priority parse rule for the paragraph
+shape above, and may also add an `a[href]` rule for other HTML-to-tiptap
+paths. The paragraph rule should only match when the paragraph contains a
+single link whose text equals its `href`; that lets the parser replace the
+whole paragraph with the block embed Node instead of leaving an empty
+paragraph before the embed. `getAttrs` should validate the URL and return
+`false` for non-matching links so the normal Link mark remains in place.
+
 ### Active source and full disable
 
 **The active source for editor wiring is `package.json#dependencies`**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ampless",
-  "version": "1.0.0-alpha.45",
+  "version": "1.0.0-alpha.46",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",