@cardenelabs/dragon 0.28.0 → 0.30.0

package/src/index.ts

@@ -107,6 +107,10 @@ export type { InputSize } from "./input-size";
 
 // LLM 向け JSON DSL (Issue #208)
 export { jsonToDiagram, validateDragonJson } from "./json-parser";
+// JSON / YAML の本文で書いた場所を指す鍵 (#2117)。 表を作る側 (画面の YAML 欄) と引く側
+// (`json-parser.ts`) が同じ規則を使うために公開する
+export { 書いた場所の鍵 } from "./json-line-map";
+export type { 書いた行の表 } from "./json-line-map";
 export { diagramJsonSchema } from "./schema";
 export type {
   DragonJson,
@@ -211,14 +215,11 @@ export function textDslToDiagram(src: string, opts?: CompileOpts): CdlDiagram {
 }
 
 function isV05Source(src: string): boolean {
-  // CAR-1657 (+ codex-review MAJOR fix) = v0.5 default + v0.4 marker detect。
+  // 既定は v0.5 で、v0.4 の目印を 1 つでも見つけた時だけ v0.4 として読む (CAR-1657)。
+  // v0.4 は 2026-12-31 に廃止予定なので、新しく書かれた本文は v0.5 として扱うのが当たりやすい。
   //
-  // v0.4 は 2026-12-31 廃止予定、 新規 source は v0.5 前提で default を v0.5 に倒す。
-  // v0.4 marker (Japanese header + v0.4-specific English syntax) を 1 個でも検出したら v0.4 route。
-  //
-  // codex 指摘 = v0.4 も英語 alias `animate:` / `animation:` を受理するため、 header 名だけでは
-  // 判定不足。 v0.4-specific syntax (`step "..." Xs` = colon なし step / `^\d+\.\s+` = 番号 flow) を
-  // negative marker に追加。
+  // 目印に見出しの名前だけを使うと足りない = v0.4 も英語の別名 (`animate:` / `animation:`) を受けるため。
+  // v0.4 にしかない書き方 (`step "..." Xs` = コロンの無い段、`^\d+\.\s+` = 番号付きの流れ) も目印に足す。
   const V04_KEYWORDS = [
     // Japanese v0.4 専用 keyword (v0.5 は英語のみ)。
     //

package/src/json-line-map.ts

@@ -0,0 +1,30 @@
+/**
+ * JSON / YAML の本文で「どこに書いたか」 を指す鍵と、そこから行番号を引く表 (#2117)。
+ *
+ * JSON を読む経路は行番号を持たないため、組み立ての知らせは全て 0 行になり、画面は
+ * 「どの行の話か」 を出せなかった。 本文の行が分かる入口 (編集画面の YAML 欄) は、本文を
+ * 読む時に場所ごとの行を集めてこの表で渡す。 表を渡さない呼出 (LLM が作った JSON を直に
+ * 渡す経路) は今までどおり 0 行になる。
+ *
+ * 鍵の形は RFC 6901 (JSON Pointer) と同じにする (`/actors/1` / `/values/sales`)。
+ * 名前をそのまま `.` で繋ぐ形にすると、`values` に `a.b` という名前を書いた場所と、
+ * `values.a` の中の `b` という欄が同じ鍵になる。 `/` と `~` を書き換える規則があるため、
+ * この形では重ならない。
+ *
+ * 表を作る側 (`apps/playground-spa/src/lib/yaml-lines.ts`) と引く側 (`json-parser.ts`) は
+ * 同じ関数を呼ぶ。 別々に持つと、片方だけ直した時に **全ての行が引けなくなる** =
+ * 引けない状態は知らせが 0 行に戻るだけで、図も誤りも変わらないため気付けない。
+ */
+
+/** 本文の場所 (JSON Pointer) から、元の本文の行番号 (1 始まり) を引く表。 */
+export type 書いた行の表 = ReadonlyMap<string, number>;
+
+/**
+ * 場所を指す鍵を作る。 引数は上から順に、欄の名前と並びの番号。
+ *
+ * 文書そのものは引数なしで空文字になる。 1 つずつ足す時は、親の鍵に
+ * `書いた場所の鍵(次の区切り)` を繋げる (同じ結果になる)。
+ */
+export function 書いた場所の鍵(...道: readonly (string | number)[]): string {
+  return 道.map((区切り) => `/${String(区切り).replace(/~/g, "~0").replace(/\//g, "~1")}`).join("");
+}