@cardenelabs/dragon 0.28.0 → 0.32.0

package/src/focus.ts

@@ -4,12 +4,12 @@
  * 書き方は 2 通り。 箱の名前 1 つか、 矢印 (`A -> B`) で 2 者を指す形。
  *
  * 読み方をここに 1 つだけ置く。 id の形は図種で違う (順序図は縦列の上端 / 下端 / 手順箱、
- * 流れ図は箱 1 個) ため id への解決は図種ごとに残すが、 「どちらの書き方か」 の判断を
+ * フローは箱 1 個) ため id への解決は図種ごとに残すが、 「どちらの書き方か」 の判断を
  * 図種ごとに持つと、 同じ記述が図種によって別の意味になる。
  *
  * 以前は図種ごとに判定していて、 順序図と汎用の 2 経路が `-` 1 文字を矢印と見なしていた。
  * その結果 `api-gateway` のような名前が「api から gateway への矢印」 と読まれ、 順序図では
- * 光らず、 流れ図では名前に部分一致した別の矢印が光っていた (実測)。
+ * 光らず、 フローでは名前に部分一致した別の矢印が光っていた (実測)。
  */
 
 /** 光らせる相手の指定。 */

package/src/index.ts

@@ -24,8 +24,37 @@ export type { CompileNotice } from "./compile";
 export type { CdlDiagram } from "@cardenelabs/cdl";
 export { parseTextDslV05 } from "./v05";
 // 記法一覧が「実際に受け付ける値」 を実装から引くための公開。 手書きすると説明と実装がずれる。
-export { DRAW_TARGETS, DRAW_WORDS, PHASE_ITEM_WORDS, PRESET_TYPES, TOP_LEVEL_KEYS } from "./v05/parser";
-export { TONE_ALIAS, NODE_KIND_ALIAS, DIRECTION_ALIAS } from "./keywords";
+export {
+  DRAW_TARGETS,
+  DRAW_WORDS,
+  PHASE_ITEM_WORDS,
+  PRESET_TYPES,
+  TOP_LEVEL_KEYS,
+  TYPE_ALIASES,
+} from "./v05/parser";
+// 行頭の印の語 (#2782)。 見本がどの語を使っているかを数える検査が、一覧を実装から引く
+export { 行頭の語 } from "./compile/row-marks";
+export {
+  TONE_ALIAS,
+  NODE_KIND_ALIAS,
+  DIRECTION_ALIAS,
+  ORDERS,
+  ORDER_ALIAS,
+  SHAPES,
+  SWIMLANE_SHAPES,
+  DIAGRAM_SHAPES,
+  ALL_DIAGRAM_SHAPES,
+  THEMES,
+  THEME_ALIAS,
+  resolveTheme,
+  LEGEND_MARK_ALIAS,
+  resolveLegendMark,
+  意匠の字の測り方,
+  意匠の円の区画の間,
+  棒を描く節か,
+  意匠の棒の角,
+} from "./keywords";
+export type { DslTheme, DslShape, DslSwimlaneShape, DslDiagramShape } from "./keywords";
 export { lintDiagram, autoFix } from "./notation-lint";
 export type { LintIssue, LintReport, LintSeverity } from "./notation-lint";
 // canvas pivot 新 spec 図境界計算 helper (§diagram-boundary SSOT)
@@ -49,6 +78,9 @@ export { measureActorBoxes } from "./compile";
 // 本文に書いた部品の状態の上書きと色番号を、部品の図へ当てる。 編集画面が重ねて描く部品にも
 // 組み立て側と同じ値を使う (#1973)
 export { 部品に上書きを当てる } from "./compile";
+// 測るためだけの配置が受け取った、描かれない図についての知らせの数 (#2312)。 読み込み時の
+// 知らせを 0 行で固定する検査が、母数として読む (0 件なら測る経路を通っていない)
+export { 測るために受け取った知らせの数 } from "./compile";
 // パーツの見た目の大きさと、 位置を書かなかった時の格子。 画面側と組み立て側で同じ規則を使う。
 // 記法が受理する種類の全体。 画面側が「本文が見本を使っているか」 を判定するのに使う (#1022)。
 export { NODE_KIND_VALID } from "./v05/parser";
@@ -107,6 +139,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 +247,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.4 は 2026-12-31 廃止予定、 新規 source は v0.5 前提で default を v0.5 に倒す。
-  // v0.4 marker (Japanese header + v0.4-specific English syntax) を 1 個でも検出したら v0.4 route。
+  // 既定は v0.5 で、v0.4 の目印を 1 つでも見つけた時だけ v0.4 として読む (CAR-1657)。
+  // v0.4 は 2026-12-31 に廃止予定なので、新しく書かれた本文は v0.5 として扱うのが当たりやすい。
   //
-  // 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("");
+}