@edv4h/usketch-plugin-markdown-to-shape

Markdown を複数の native shape に分解する uSketch プラグイン。「どの Markdown 構造をどの shape にするか」は変換レジストリに登録する方式（IoC）で、このプラグインは具体的な shape に一切依存しない。

仕組み

1. ctx.markdownConverters（@edv4h/usketch-core が提供、PluginContext 経由）に converter を登録する:

   ctx.markdownConverters.register({
     id: "app:heading-to-text",
     nodeTypes: ["heading"],        // mdast のノード種別
     order: 0,                       // 高いほど優先、同点は後勝ち
     convert: (node, cctx) => [{ type: "text", text: /* ... */, fontSize: 28 }],
   });

2. Control HUD の Action 「🧩 Markdown を図形に分解」（markdown shape を単一選択時のみ有効）を実行すると:
   • remark-parse + remark-gfm で source を mdast に parse。
   • top-level ブロックごとに登録 converter を解決（nodeTypes/match → order 最大 → 後勝ち）。
   • 未登録のブロックは markdown shape にフォールバック（生ソースを slice して保持するので、表・コード・mermaid もそのまま整形描画される）。
   • 生成 shape を縦フローで配置し、元 markdown shape を置き換える（1 操作で undo 可能）。

依存の向き（デカップリング）

• このプラグインは @edv4h/usketch-shared のみに依存し、text / table などの shape プラグインを import しない。
• 変換先は「登録する側」が持つ（例: apps/web の adapter が heading→text を登録）。将来 code/table 等の native shape を足すときも converter を登録するだけで、本体は無改変。
• フォールバックの markdown shape は型文字列だけで生成するため、markdown-shape プラグインへのコード依存も無い。

Mermaid フローチャートの分解

mermaid の graph / flowchart（TD/LR 等）を、rectangle + text ノード と connector の編集可能な図に分解する converter を同梱（createMermaidFlowchartConverter）。app 側 adapter で登録して使う。

• 自前パーサ + @dagrejs/dagre レイアウト（同期 なので converter は同期のまま）。
• ctx.origin を起点に絶対配置。connector は node の id で接続するので、ノードを動かすと線も追従。
• 非 flowchart の mermaid（sequence / gantt 等）や解析失敗は markdown shape にフォールバック（図としてそのまま描画）。
• サブグラフ・スタイル定義・複雑なエッジ種別は v1 では簡略化。

「1 ブロック → 相互接続されたサブグラフ」を返せるよう、MarkdownShapeSpec は id/x/y を、MarkdownConverterContext は origin を持つ。単発 spec（見出し等）はこれらを省略でき、orchestrator が縦フロー枠に配置する。

エクスポート

• createMarkdownToShapePlugin() — プラグイン本体。
• createMermaidFlowchartConverter() — mermaid flowchart → 図分解 converter（app が登録）。
• parseFlowchart(code) — mermaid flowchart 構文パーサ（純粋関数）。
• convertMarkdownToShapes(opts) — source → 配置済み ShapeData[]（オーケストレータ）。
• parseMarkdown / topLevelBlocks / mdastText / nodeSource — converter 実装用の mdast ヘルパ。

非スコープ / 今後

• 高さは v1 では推定（描画前は未確定）。measure ベース精緻化は後段。
• code / table の native shape が無いため当面は markdown フォールバック（設計どおり）。
• 段落内インライン装飾の分解は行わない（段落 = 1 text）。