@cardenelabs/dragon 0.27.0 → 0.30.0

package/src/near-name.ts

@@ -0,0 +1,42 @@
+/**
+ * 書き間違えた名前に綴りの近い候補を探す (#1295 で JSON の項目名に作り、#2113 で部品の名前と共有した)。
+ *
+ * 「知らない名前です」 だけだと、書いた人は正しい綴りを探しに行く必要がある。
+ * 2 文字の違い (足りない / 多い / 別の字) までを候補とする。 隣どうしの入れ替わりは 2 文字の違いに数える。
+ *
+ * 遠い名前は勧めない。 無関係な名前を勧めると、書いた人がそちらへ直して二度手間になる。
+ * 大文字と小文字は区別しない。
+ */
+export function 近い名前(語: string, 候補: Iterable<string>): string | undefined {
+  const 小文字 = 語.toLowerCase();
+  let 最短: { 名: string; 距離: number } | undefined;
+  for (const c of 候補) {
+    const d = 編集距離(小文字, c.toLowerCase(), 2);
+    if (d <= 2 && (最短 === undefined || d < 最短.距離)) 最短 = { 名: c, 距離: d };
+  }
+  return 最短?.名;
+}
+
+/**
+ * 2 つの語の編集距離 (上限付き)。
+ *
+ * 上限を持つのは、長い語どうしで表を全部埋めないため。 上限を超えた時点で打ち切る。
+ */
+function 編集距離(a: string, b: string, 上限: number): number {
+  if (Math.abs(a.length - b.length) > 上限) return 上限 + 1;
+  let 前 = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i += 1) {
+    const 今: number[] = [i];
+    let 行の最小 = i;
+    for (let j = 1; j <= b.length; j += 1) {
+      const 費用 = a[i - 1] === b[j - 1] ? 0 : 1;
+      const v = Math.min(今[j - 1]! + 1, 前[j]! + 1, 前[j - 1]! + 費用);
+      今.push(v);
+      if (v < 行の最小) 行の最小 = v;
+    }
+    // その行の最小が上限を超えたら、以降どう進んでも上限以下にはならない
+    if (行の最小 > 上限) return 上限 + 1;
+    前 = 今;
+  }
+  return 前[b.length]!;
+}

package/src/notation-lint.ts

@@ -1,22 +1,22 @@
 /**
- * Notation lint (author 向け修正システム)。
+ * 記法の検査 (図を書く人向けの修正システム)。
  *
- * cdl / dragon 記法で書かれた CdlDiagram を rule-based に検査し、
- * 「もっと良い書き方」 を suggestion として返す純粋関数。 LLM 不要、 rule のみ。
+ * cdl / dragon の記法で書いた図 (`CdlDiagram`) を決まった規則で検査し、直し方を修正案
+ * (`suggestion`) として返す純粋関数。 言語モデルは使わない。
  *
- * 検知システム (`check:cdl` / `check:dragon` / `check:kind`) は開発陣向けで
- * 「実装バグ」 を検出するが、 本 notation-lint は **author 向け** で
- * 「書き方の癖 / 冗長表現 / 未定義参照 / 空 payload」 等を検出する。
+ * 検知システム (`check:cdl` / `check:dragon` / `check:kind`) は開発者向けで実装の不具合を
+ * 見つける。 こちらは図を書く人向けで、読む人へ伝わらない書き方 (図の説明に入り込んだ実装の
+ * 書き方、無い部品を指す参照、値や項目が空の図表など) を見つける。
  *
  * 使い方:
- *   import { lintDiagram } from "@cardenelabs/dragon";
+ *   import { lintDiagram, autoFix } from "@cardenelabs/dragon";
  *   const report = lintDiagram(diagram);
- *   // report.issues[] = LintIssue[]
- *   // report.fixed = LintIssue[] のうち自動修正で解消される件
- *   // report.autoFix(diagram) = 修正済 CdlDiagram
+ *   // report.issues = LintIssue[]
+ *   // report.autoFixableCount = 自動修正で実際に解消できる指摘の数
+ *   const patched = autoFix(diagram); // 自動修正を当てた新しい図 (元の図は変えない)
  *
- * CLI:
- *   pnpm dragon-lint apps/playground-spa/src/topics/catalog/presets.cdl.ts
+ * 道具:
+ *   node packages/dragon/scripts/dragon-lint.mjs apps/playground-spa/src/topics/catalog/presets.cdl.ts
  */
 import type { CdlDiagram, CdlNode } from "@cardenelabs/cdl";
 
@@ -28,9 +28,12 @@ export type LintIssue = {
   severity: LintSeverity;
   /** 該当対象 (node id / edge id / diagram id) */
   target: string;
-  /** 人間向けメッセージ */
+  /**
+   * 書き手向けの指摘の文。 書き手が打ち込む識別子と書き手の値は `` ` `` で囲み、 残りは日本語で書く
+   * (画面側の `lint-message-words.test.ts` が全規則の文を判定に通す)
+   */
   message: string;
-  /** 修正案 (自動修正可能なら適用後の値、 手動修正必要なら null) */
+  /** 修正案。 自動修正できる指摘は自動修正が書く値そのもの、 できない指摘は直し方の文 */
   suggestion?: string;
   /** autoFix() が本 issue を自動解消できるか */
   autoFixable: boolean;
@@ -43,11 +46,21 @@ export type LintReport = {
   autoFixableCount: number;
 };
 
+/**
+ * 図の説明に入り込んだ実装の書き方と、 読む人に何が伝わらないか。
+ *
+ * 文は理由だけを持ち、 直し方の例を書かない。 直し方は修正案 (`suggestion`) が自動修正の
+ * 出力から作る。 例を字で書くと、 自動修正の出力を変えた日に例だけが古い文型で残る
+ * (実測 = #1934 で出力を変えた後も `「〜 を示す図」 のように` が残っていた、 #1940)。
+ */
 const REDUNDANT_TOPIC_PATTERNS: Array<{ pattern: RegExp; hint: string }> = [
-  { pattern: /\bpreset\s*\(/i, hint: "「〜 preset (詳細)」 は実装表現、 「〜 を示す図」 のように読者向け説明に" },
-  { pattern: /render\s*未実装/, hint: "「render 未実装」 は開発者向け内部メモ、 catalog 表示では省く" },
-  { pattern: /SVG\s+(polyline|arc|rect|path)/i, hint: "「SVG polyline / arc / rect / path」 は実装詳細、 「〜 を示す図」 に置換" },
-  { pattern: /\bpolygon\b/i, hint: "「polygon」 は実装用語、 図の意味を説明する自然文に置換" },
+  { pattern: /\bpreset\s*\(/i, hint: "`preset (…)` は作り手の書き方で、 読む人には何を示す図かが伝わらない" },
+  { pattern: /render\s*未実装/, hint: "`render 未実装` は作り手向けの控えで、 カタログに出す説明には要らない" },
+  {
+    pattern: /SVG\s+(polyline|arc|rect|path)/i,
+    hint: "`SVG` の描き方の名前 (`polyline` / `arc` / `rect` / `path`) は実装の詳細で、 何を示す図かが伝わらない",
+  },
+  { pattern: /\bpolygon\b/i, hint: "`polygon` は実装の言葉で、 何を示す図かが伝わらない" },
 ];
 
 /**
@@ -85,32 +98,46 @@ export function autoFix(d: CdlDiagram): CdlDiagram {
   return patched;
 }
 
-const KIND_TO_JA: Record<string, string> = {
-  chart: "統計チャート",
-  "line chart": "折れ線グラフ",
-  "pie chart": "円グラフ",
-  "bar chart": "棒グラフ",
-  flow: "処理の流れ",
-  swimlane: "スイムレーン (役割別レーン)",
-  sequence: "時系列のやり取り",
-  topology: "システム構成",
-  er: "テーブル関係 (ER 図)",
-  stateMachine: "状態遷移 (ステート図)",
-  stateMachine2: "拡張ステート図 (階層状態)",
-  infrastructure: "クラウド構成",
-  classDiagram: "UML クラス図",
-  tree: "階層ツリー",
-  userJourney: "ユーザージャーニー",
-  mindMap: "マインドマップ",
-  funnel: "ファネル (段階別離脱)",
-  quadrant: "四象限マトリクス",
-  gantt: "ガントチャート",
-  flowchart: "分岐フローチャート",
-  network: "ネットワーク構成",
+/**
+ * 図の型ごとに、 自動修正が書く説明「{shows}を示す{name}」 の 2 つの部品。
+ *
+ * `name` はカタログが同じ型の見本に付けた名前 (`apps/playground-spa/src/lib/i18n.ts` の
+ * `ITEM_NAME_JA` の `preset*`) と同じ字にする。 利用者は自動修正で書き換わった説明の名前で
+ * カタログを探すため、 呼び名が割れると同じ型の見本に辿り着けない。 照らす検査は画面側の
+ * `lint-topic-names.test.ts` が持つ (この package は画面側の file を読まない)。
+ *
+ * 説明の末尾を型の名前にするのは、 名前の多くが `図` で終わるため。 旧い文型
+ * 「{名前} を示す図」 のまま名前を差し替えると `工程表 を示す図` / `状態遷移図 を示す図` の
+ * ように図が重なる。 カタログの見本の説明 (`全体に対する内訳の割合を示す円グラフ`) と同じ並びにした。
+ *
+ * `chart` と `bar chart` はカタログに同じ型の見本が無いので、 図表の日常語で呼ぶ。
+ */
+const KIND_TO_JA: Record<string, { shows: string; name: string }> = {
+  chart: { shows: "項目ごとの数値", name: "グラフ" },
+  "line chart": { shows: "値の移り変わり", name: "折れ線グラフ" },
+  "pie chart": { shows: "全体に対する内訳の割合", name: "円グラフ" },
+  "bar chart": { shows: "項目ごとの値の大きさ", name: "棒グラフ" },
+  flow: { shows: "処理の順番", name: "フロー" },
+  swimlane: { shows: "役割ごとの縦列に分けた処理の流れ", name: "スイムレーン" },
+  sequence: { shows: "要素どうしのやり取りの順番", name: "シーケンス図" },
+  topology: { shows: "システムの構成要素と接続", name: "トポロジー図" },
+  er: { shows: "表どうしの関係", name: "ER図" },
+  stateMachine: { shows: "状態と遷移の条件", name: "状態遷移図" },
+  stateMachine2: { shows: "親の状態の中に置いた子の状態と遷移の条件", name: "入れ子の状態遷移図" },
+  infrastructure: { shows: "クラウドとネットワークの構成", name: "階層構成図" },
+  classDiagram: { shows: "クラスどうしの関係", name: "クラス図" },
+  tree: { shows: "組織や分類の親子の関係", name: "階層図" },
+  userJourney: { shows: "利用者の気持ちの移り変わり", name: "体験の道筋" },
+  mindMap: { shows: "中心の主題から広がる発想", name: "枝分かれ図" },
+  funnel: { shows: "段階ごとに残る数と離れる数", name: "絞り込み図" },
+  quadrant: { shows: "2 つの軸で分けた項目の位置", name: "四象限図" },
+  gantt: { shows: "作業の期間と前後の関係", name: "工程表" },
+  flowchart: { shows: "分岐や判定を含む処理の順番", name: "流れ図" },
+  network: { shows: "機器と区画のつながり", name: "ネットワーク図" },
 };
 
 function applyTopicAutoFix(topic: string): string {
-  // 1. 先頭の kind name を検出、 マッチしたら JA description に置換
+  // 1. 先頭の kind name を検出、 マッチしたら「{shows}を示す{name}」 に置換
   const kindMatch = topic.match(
     /^\s*(chart|flow|swimlane|sequence|topology|er|stateMachine2?|infrastructure|classDiagram|tree|userJourney|mindMap|funnel|quadrant|gantt|flowchart|network|line chart|pie chart|bar chart)\b/i,
   );
@@ -118,7 +145,8 @@ function applyTopicAutoFix(topic: string): string {
     const kind = kindMatch[1]!.toLowerCase();
     const canonical = Object.keys(KIND_TO_JA).find((k) => k.toLowerCase() === kind);
     if (canonical) {
-      return `${KIND_TO_JA[canonical]} を示す図`;
+      const { shows, name } = KIND_TO_JA[canonical]!;
+      return `${shows}を示す${name}`;
     }
   }
 
@@ -131,21 +159,31 @@ function applyTopicAutoFix(topic: string): string {
   return out;
 }
 
+/**
+ * 図の説明に実装の書き方が入っていないかを見る。
+ *
+ * **自動修正で消えるかは、 直した後の説明にもう 1 度当てて決める** (#1940)。 自動修正が消すのは
+ * 先頭の型の名前と、 括弧の中の実装の言葉だけで、 括弧の外の `SVG polyline を使う` は字が変わらない。
+ * 当てずに「直せる」 と返すと、 道具が直せる数に入れ、 直したはずの指摘が次の検査でまた出る。
+ *
+ * 修正案は、 直せる時は自動修正が書く値そのもの (`LintIssue.suggestion` の約束)、 直せない時は
+ * 直し方の文にする。 文の例は書き換え先の表から作り、 字で書かない。
+ */
 function ruleTopicRedundancy(d: CdlDiagram): LintIssue[] {
-  const out: LintIssue[] = [];
-  for (const { pattern, hint } of REDUNDANT_TOPIC_PATTERNS) {
-    if (pattern.test(d.topic)) {
-      out.push({
-        rule: "topic-redundant-implementation-detail",
-        severity: "warn",
-        target: d.id,
-        message: `topic に実装詳細が含まれる: "${d.topic}"`,
-        suggestion: hint,
-        autoFixable: true,
-      });
-    }
-  }
-  return out;
+  const 当たる = REDUNDANT_TOPIC_PATTERNS.filter(({ pattern }) => pattern.test(d.topic));
+  if (当たる.length === 0) return [];
+  const 直した後 = applyTopicAutoFix(d.topic);
+  const 直せる = !REDUNDANT_TOPIC_PATTERNS.some(({ pattern }) => pattern.test(直した後));
+  const 例 = KIND_TO_JA.gantt!;
+  const 手で直す = `何を示す図かを文で書き直す (「${例.shows}を示す${例.name}」 のように)`;
+  return 当たる.map(({ hint }) => ({
+    rule: "topic-redundant-implementation-detail",
+    severity: "warn",
+    target: d.id,
+    message: `図の説明 \`${d.topic}\` に実装の書き方が入っている。 ${hint}`,
+    suggestion: 直せる ? 直した後 : 手で直す,
+    autoFixable: 直せる,
+  }));
 }
 
 function ruleEmptyChartData(d: CdlDiagram): LintIssue[] {
@@ -158,8 +196,8 @@ function ruleEmptyChartData(d: CdlDiagram): LintIssue[] {
           rule: "chart-empty-datum",
           severity: "warn",
           target: n.id,
-          message: `chart node "${n.id}" が datum 0 件、 chart は非表示になる`,
-          suggestion: `.datum({ id: ..., label: ..., value: ... }) を 1 件以上追加`,
+          message: `図表 \`${n.id}\` に値 (\`datum\`) が 1 件も無く、 図表が描かれない`,
+          suggestion: `\`.datum({ id, label, value })\` で値を 1 件以上足す`,
           autoFixable: false,
         });
       }
@@ -168,8 +206,8 @@ function ruleEmptyChartData(d: CdlDiagram): LintIssue[] {
           rule: "chart-single-datum",
           severity: "info",
           target: n.id,
-          message: `chart node "${n.id}" が datum 1 件、 比較 / 推移として意味が薄い`,
-          suggestion: `2 件以上の datum を推奨 (line 系は 3 件以上で trend が見える)`,
+          message: `図表 \`${n.id}\` の値 (\`datum\`) が 1 件だけで、 比べることも移り変わりを追うこともできない`,
+          suggestion: `値を 2 件以上にする (折れ線グラフは 3 件以上で傾きが読める)`,
           autoFixable: false,
         });
       }
@@ -190,8 +228,8 @@ function ruleGanttUnknownDependsOn(d: CdlDiagram): LintIssue[] {
             rule: "gantt-unknown-depends-on",
             severity: "warn",
             target: t.id,
-            message: `task "${t.id}" が未定義 task "${t.dependsOn}" に dependsOn 参照`,
-            suggestion: `参照先 id を修正 or dependsOn を除去`,
+            message: `作業 \`${t.id}\` の \`dependsOn\` が、 無い作業 \`${t.dependsOn}\` を指している`,
+            suggestion: `\`dependsOn\` を既にある作業の \`id\` に直すか、 \`dependsOn\` を外す`,
             autoFixable: false,
           });
         }
@@ -225,8 +263,8 @@ function ruleMindMapParentReference(d: CdlDiagram): LintIssue[] {
             rule: "mindmap-unknown-parent",
             severity: "warn",
             target: b.id,
-            message: `branch "${b.id}" が未定義 parent "${b.parent}" を参照`,
-            suggestion: `parent を rootId ("${n.mindData.rootId}") または既存 branch id に修正`,
+            message: `枝 \`${b.id}\` の \`parent\` が、 無い枝 \`${b.parent}\` を指している`,
+            suggestion: `\`parent\` を中心 (\`${n.mindData.rootId}\`) か、 既にある枝の \`id\` に直す`,
             autoFixable: false,
           });
         }
@@ -247,8 +285,8 @@ function ruleTreeParentReference(d: CdlDiagram): LintIssue[] {
             rule: "tree-unknown-parent",
             severity: "warn",
             target: t.id,
-            message: `tree node "${t.id}" が未定義 parent "${t.parent}" を参照`,
-            suggestion: `parent id を既存 tree node に修正 or parent 除去 (root にする)`,
+            message: `階層図の項目 \`${t.id}\` の \`parent\` が、 無い項目 \`${t.parent}\` を指している`,
+            suggestion: `\`parent\` を既にある項目の \`id\` に直すか、 \`parent\` を外して一番上の項目にする`,
             autoFixable: false,
           });
         }
@@ -268,8 +306,8 @@ function ruleQuadrantMissingItems(d: CdlDiagram): LintIssue[] {
           rule: "quadrant-empty",
           severity: "warn",
           target: n.id,
-          message: `quadrant "${n.id}" が item 0 件、 軸のみ表示される`,
-          suggestion: `.item({ id: ..., title: ..., quadrant: "topLeft" | ... }) を 1 件以上追加`,
+          message: `四象限図 \`${n.id}\` に項目 (\`item\`) が 1 件も無く、 軸だけが描かれる`,
+          suggestion: `\`.item({ id, title, quadrant })\` で項目を 1 件以上足す (\`quadrant\` は \`topLeft\` などの 4 区画から選ぶ)`,
           autoFixable: false,
         });
       }
@@ -279,8 +317,8 @@ function ruleQuadrantMissingItems(d: CdlDiagram): LintIssue[] {
           rule: "quadrant-single-quadrant",
           severity: "info",
           target: n.id,
-          message: `quadrant "${n.id}" の item が 1 象限に集中、 マトリクスの意味が薄い`,
-          suggestion: `2 象限以上に item を分散 (SWOT / Priority matrix 等は 4 象限 balanced を推奨)`,
+          message: `四象限図 \`${n.id}\` の項目がすべて 1 つの区画に集まり、 4 つに分けた意味が薄い`,
+          suggestion: `項目を 2 つ以上の区画に分ける。 強みと弱みを並べる分析 (\`SWOT\`) や優先度を決める図は、 4 つの区画に散らして使う`,
           autoFixable: false,
         });
       }
@@ -290,13 +328,13 @@ function ruleQuadrantMissingItems(d: CdlDiagram): LintIssue[] {
 }
 
 /**
- * 段の人数が減っていくことを見る。
+ * 段階の人数が減っていくことを見る。
  *
  * 人数の欄は `{名前}` を書ける (状態から取る形、 cdl の `render/payload-binding.ts` が解く)。
  * その場合ここでは値が決まらないので、**数どうしの組だけを比べる** (#1194)。
  *
  * 素通しで比べると文字列の大小比較になり、`{trial}` が `{signup}` より大きいという理由で
- * 発火する。 実際に見本帳の funnel を状態から取る形にした時、その偽発火が出た。
+ * 発火する。 実際にカタログの funnel を状態から取る形にした時、その偽発火が出た。
  */
 function ruleFunnelMonotonicCount(d: CdlDiagram): LintIssue[] {
   const out: LintIssue[] = [];
@@ -312,8 +350,8 @@ function ruleFunnelMonotonicCount(d: CdlDiagram): LintIssue[] {
             rule: "funnel-increasing-count",
             severity: "warn",
             target: stages[i]!.id,
-            message: `stage "${stages[i]!.id}" (${stages[i]!.count}) が前段 (${stages[i - 1]!.count}) より増加、 funnel は単調減少が期待される`,
-            suggestion: `stage 順を再確認、 増加 pattern なら別 preset (chart-line 等) を検討`,
+            message: `段階 \`${stages[i]!.id}\` の数 (${今}) が前の段階 (${前}) より多い。 絞り込み図は段階が進むほど数が減る`,
+            suggestion: `段階の順番を確かめる。 数が増える流れを示すなら、 折れ線グラフ (\`chart-line\`) などの別の図にする`,
             autoFixable: false,
           });
         }

package/src/relative-pos.ts

@@ -12,8 +12,20 @@
  * 直らない事故を、 規則を共有することで構造的に防ぐ。
  */
 
-/** 基準からどちら側に置くか。 */
-export type RelativeDirection = "right" | "left" | "above" | "below";
+/**
+ * 基準からどちら側に置くか。
+ *
+ * 語の一覧は下の `RELATIVE_DIRECTIONS` が持つ。 型を並べ直さず、一覧から導く。
+ */
+export type RelativeDirection = (typeof RELATIVE_DIRECTIONS)[number];
+
+/**
+ * 向きとして受ける語の一覧。
+ *
+ * 読み取りの入口が 2 つある (本文の `位置: Web の右 200` と JSON の `posRel.dir`) ため、
+ * 一覧を 1 箇所に置いて両方から引く。 2 度書くと、向きを足した時に片方だけが取り残される。
+ */
+export const RELATIVE_DIRECTIONS = ["right", "left", "above", "below"] as const;
 
 /** 相対で書かれた位置の指定。 */
 export type RelativePos = {
@@ -180,3 +192,60 @@ export function orderByDependency(
   }
   return { order, cyclic: [...cyclic] };
 }
+
+/** 解けない書き方の種類。 誤りの文は入口ごとに作るので、ここでは種類だけを返す */
+export type RelativeProblemKind = "self" | "missing-anchor" | "cyclic";
+
+/** 解けない書き方 1 件。 `anchor` は相手が居ない時だけ持つ */
+export type RelativeProblem = {
+  name: string;
+  kind: RelativeProblemKind;
+  anchor?: string;
+};
+
+/**
+ * 解けない相対の指定を挙げる (#2039)。
+ *
+ * 解けない書き方は 3 通りある。 相手が居ない / 自分を基準にした / 基準が輪になっている。
+ * どれも「書いたのに図が変わらない」 形で表に出るため、図を出す前に知らせる。
+ *
+ * **判定は本 file に 1 つだけ置く**。 読み取りの入口が 2 つある (本文と JSON) ため、
+ * 片方だけに判定を持つと、同じ書き方が入口によって通ったり通らなかったりする。
+ * 実際 JSON 側には判定が無く、相対で置く欄そのものが無かった。
+ *
+ * 誤りの文は返さない。 本文側は行番号を、JSON 側は欄の場所を添えるため、文の組み立ては
+ * 入口に任せる。 ここが返すのは「誰の」「どの種類の」 解けなさか だけ。
+ *
+ * 呼ぶ側は、挙がった名前から相対の指定を外す。 残したままだと、誤りを無視して読み込んだ
+ * 経路で解決できない指定が組み立てまで届く。
+ */
+export function findRelativeProblems(
+  items: ReadonlyArray<{ name: string; rel?: RelativePos }>,
+): RelativeProblem[] {
+  const named = new Set(items.map((i) => i.name));
+  const broken = new Set<string>();
+  const out: RelativeProblem[] = [];
+
+  for (const it of items) {
+    const rel = it.rel;
+    if (!rel) continue;
+    if (rel.anchor === it.name) {
+      out.push({ name: it.name, kind: "self" });
+      broken.add(it.name);
+      continue;
+    }
+    if (!named.has(rel.anchor)) {
+      out.push({ name: it.name, kind: "missing-anchor", anchor: rel.anchor });
+      broken.add(it.name);
+    }
+  }
+
+  // 輪は、既に解けないと判った分を外してから探す。 外さないと「相手が居ない」 1 件が
+  // 「輪になっている」 としても挙がり、同じ 1 つの誤りが 2 通りの直し方で出る
+  const { cyclic } = orderByDependency(
+    items.map((i) => ({ name: i.name, rel: broken.has(i.name) ? undefined : i.rel })),
+  );
+  for (const name of cyclic) out.push({ name, kind: "cyclic" });
+
+  return out;
+}

package/src/schema.ts

@@ -13,7 +13,7 @@
  *   });
  *   const diagram = jsonToDiagram(res.content[0].input);
  *
- * schema JSON は `packages/dragon/schemas/diagram.json` が SSOT、 本 file は import して再 export するだけ。
+ * schema JSON は `packages/dragon/src/schemas/diagram.json` が SSOT、 本 file は import して再 export するだけ。
  */
 
 import schemaJson from "./schemas/diagram.json" with { type: "json" };