@cardenelabs/dragon 0.34.0 → 0.35.0

package/src/v05/removed-syntax.ts

@@ -1,115 +0,0 @@
-/**
- * 外した書き方と置き換え先 (#2947)。
- *
- * dragon はどの分野にも寄らずに図を描く道具なので、特定の技術や会社に向けた書き方を外した。
- * 外した書き方を黙って受けないために、**書いた人に置き換え先を誤りとして返す**。
- *
- * 外した語を受理集合 (`NODE_KIND_VALID` / `TYPE_ALIASES`) から消すだけだと、箱の種類は
- * 見本 (parts) の名前として扱われて「そんな部品は無い」 と出て、図種は「図種が読めません」
- * と出る。 どちらも何に書き換えればよいかが読み取れない。
- *
- * 記法 (`v05/parser.ts`) と JSON (`json-parser.ts`) の両方の入口がこの表を引く。
- * 入口ごとに表を持つと、片方だけ受け付ける形が残る。
- */
-
-/** 外した図種と、同じ図を描く書き方 */
-export const 外した図種: ReadonlyMap<string, string> = new Map<string, string>([
-  ["solidity", "`type: sequence` と `order: 種類`"],
-]);
-
-/**
- * cdl から外した挿絵の種類 (cardene777/cdl#1256)。
- *
- * 業界ごとに手で描いた形で、どこまで足しても偏るため cdl 0.140.0 で外した。
- * 外す前の形は cdl の tag `archive/illustration-shapes` から取り出せる。
- */
-export const 外した挿絵の種類: readonly string[] = [
-  "shape-kanban-card",
-  "shape-message-bubble",
-  "shape-gear",
-  "shape-network-node",
-  "shape-iot-sensor",
-  "shape-robot-arm",
-  "shape-satellite",
-  "shape-website",
-  "shape-cdn-edge",
-  "shape-api-gateway",
-  "shape-storefront",
-  "shape-warehouse",
-  "shape-online-shop",
-  "shape-customer-service",
-  "shape-lawyer",
-  "shape-auditor",
-  "shape-regulator",
-  "shape-notary",
-  "shape-trader",
-  "shape-smart-contract",
-  "shape-blockchain-block",
-  "shape-blockchain",
-  "shape-bitcoin-chain",
-  "shape-ethereum-chain",
-  "shape-blockchain-node",
-  "shape-rpc-node",
-  "shape-wallet",
-  "shape-nft",
-  "shape-token",
-  "shape-bank",
-  "shape-trust-bank",
-  "shape-payment-provider",
-  "shape-credit-card",
-  "shape-brokerage",
-  "shape-exchange",
-  "shape-atm",
-];
-
-/** 外した挿絵の代わり。 1 つに決まらないので、選べる 2 つの道を示す */
-const 挿絵の代わり =
-  "基本の形 (`shape-file` / `shape-cylinder` など) を使うか、箱に `kindForm: icon` と `icon` を書く";
-
-/**
- * 外した箱の種類と、置き換え先。
- *
- * | 外した種類 | 置き換え先 | 元の役目 |
- * |---|---|---|
- * | `contract` / `proxy` / `library` / `interface` | `card` | Solidity の図の契約 |
- * | `eoa` | `person` | Solidity の図の人が持つ財布 |
- * | `multisig` | `signer` | Solidity の図の複数人の署名 |
- * | `alb` / `ecs` / `iam` / `kms` / `lambda` / `rds` / `s3` | 同じ役目の汎用の種類 | AWS の名前の読み替え |
- * | cdl から外した挿絵 | 基本の形か `kindForm: icon` | 業界ごとの挿絵 |
- *
- * 置き換え先は外す前に読み替えていた先と同じ種類にした (`alb` だけは読み替え先の挿絵が
- * 外れたので `api` にした)。 書き換えた図は外す前と同じ形で描かれる。
- */
-export const 外した種類: ReadonlyMap<string, string> = new Map<string, string>([
-  ["contract", "`card`"],
-  ["proxy", "`card`"],
-  ["library", "`card`"],
-  ["interface", "`card`"],
-  ["eoa", "`person`"],
-  ["multisig", "`signer`"],
-  ["alb", "`api`"],
-  ["ecs", "`microservice`"],
-  ["iam", "`admin`"],
-  ["kms", "`admin`"],
-  ["lambda", "`function`"],
-  ["rds", "`database`"],
-  ["s3", "`storage`"],
-  ...外した挿絵の種類.map((k): [string, string] => [k, 挿絵の代わり]),
-]);
-
-/** 外した箱の種類なら、知らせの文面を返す */
-export function 外した種類の知らせ(kind: string): { message: string; hint: string } | undefined {
-  const 代わり = 外した種類.get(kind);
-  if (代わり === undefined) return undefined;
-  return {
-    message: `箱の種類 "${kind}" は外しました`,
-    hint: 外した挿絵の種類.includes(kind) ? 代わり : `代わりに ${代わり} を書く`,
-  };
-}
-
-/** 外した図種なら、知らせの文面を返す */
-export function 外した図種の知らせ(type: string): { message: string; hint: string } | undefined {
-  const 代わり = 外した図種.get(type);
-  if (代わり === undefined) return undefined;
-  return { message: `図種 "${type}" は外しました`, hint: `代わりに ${代わり} を書く` };
-}

package/src/value-syntax.ts

@@ -1,313 +0,0 @@
-/**
- * 値 (`values`) と状態 (`states`) の名前と式が、記法として書ける範囲に収まっているかの判定。
- *
- * **入口が 2 つあるので 1 か所に置く** (#1181)。 記法 (`v05/parser.ts`) と JSON
- * (`json-parser.ts`) が同じ判定を使う。 別々に持つと片方だけが受け付ける形ができ、
- * 「YAML では弾かれるのに JSON では通る」 (またはその逆) が生まれる。
- *
- * 位置の付け方だけが入口で違う (記法は行番号、JSON は field の path)。 そのため本 file は
- * 位置を持たない指摘だけを返し、呼出側が自分の形に包む。
- */
-
-/** 値と状態の名前。 描画側が `{名前}` を置き換える時に見る範囲と揃える (英数字と `_` のみ) */
-const VALUE_NAME_RE = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-
-/** 式に書ける関数。 spec が「関数呼び出しは入れない」 としつつ例外にしている 2 つだけ */
-const VALUE_FNS: ReadonlySet<string> = new Set(["min", "max"]);
-
-/** 位置を持たない指摘。 呼出側が行番号 (記法) か path (JSON) を付けて報告する */
-export type ValueSyntaxIssue = {
-  message: string;
-  hint?: string;
-};
-
-/** 値 / 状態の名前として使えるか */
-export function isValueName(name: string): boolean {
-  return VALUE_NAME_RE.test(name);
-}
-
-/** 名前が使えない時の指摘 */
-export function valueNameIssue(name: string): ValueSyntaxIssue {
-  return {
-    message: `invalid value name: "${name}"`,
-    hint: "英字か _ で始め、 英数字と _ だけを使う (states と同じ規則)",
-  };
-}
-
-/** きっかけ形の読み取り結果。 位置は呼出側が付ける (本 file の方針) */
-export type ParsedValueTrigger = {
-  trigger:
-    | { kind: "step"; step: string }
-    | { kind: "reaches"; source: string; op: TriggerOp; threshold: number };
-  to: number;
-  durationMs: number;
-};
-
-export type TriggerOp = ">=" | ">" | "<=" | "<" | "==" | "!=";
-
-/** 比較の記号。 **2 文字を先に見る** = `>=` を `>` と読むと境目が 1 つずれる */
-const TRIGGER_OPS: readonly TriggerOp[] = [">=", "<=", "==", "!=", ">", "<"];
-
-/**
- * 動く長さを ms に直す。 段の頭 (`"取込み" 2s`) と同じ書き方を受ける。
- *
- * 単位を書かない形は秒として読む (段の頭と揃える)。 0 以下は動かないので受けない。
- */
-export function parseDurationMs(text: string): number | null {
-  const m = text.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s)?$/);
-  if (!m) return null;
-  const n = parseFloat(m[1] ?? "0");
-  if (!Number.isFinite(n) || n <= 0) return null;
-  const unit = m[2] ?? "s";
-  const durationMs = unit === "ms" ? Math.round(n) : Math.round(n * 1000);
-  // 描画側の時計は ms の整数。 正の小数でも丸めた結果が 0ms なら、 後段で傾斜の式が
-  // 0 除算になるため、この入口で「動く長さではない」として弾く。
-  return durationMs > 0 ? durationMs : null;
-}
-
-/**
- * 引用の外にある `,` だけで切る。
- *
- * 素朴な `split(",")` を使えない。 段の名前に `,` を書ける (`step "取込み, 検証"`) ため、
- * 引用の中で切ると名前が 2 つに割れる。
- */
-function splitOutsideQuotes(body: string): string[] {
-  const out: string[] = [];
-  let cur = "";
-  let quote: string | null = null;
-  for (const ch of body) {
-    if (quote) {
-      if (ch === quote) quote = null;
-      cur += ch;
-      continue;
-    }
-    if (ch === '"' || ch === "'") {
-      quote = ch;
-      cur += ch;
-      continue;
-    }
-    if (ch === ",") {
-      out.push(cur);
-      cur = "";
-      continue;
-    }
-    cur += ch;
-  }
-  out.push(cur);
-  return out.map((s) => s.trim()).filter((s) => s !== "");
-}
-
-/** 引用を外す。 引用の中の `,` を守るために引用を残したまま切っているので、 ここで落とす */
-function unquote(s: string): string {
-  const t = s.trim();
-  if (t.length >= 2 && (t[0] === '"' || t[0] === "'") && t[t.length - 1] === t[0]) {
-    return t.slice(1, -1);
-  }
-  return t;
-}
-
-/**
- * きっかけの本体を読む (`step "取込み"` / `vDone >= 100`)。
- *
- * **`step` を先に見る**。 後に回すと `step "x"` が比較の記号を含まない形として
- * 「相手の値の名前」 に落ち、 名前として不正という別の理由で弾かれる = 直し方が伝わらない。
- */
-function parseTriggerExpression(raw: string, name: string): ParsedValueTrigger["trigger"] | ValueSyntaxIssue {
-  const text = raw.trim();
-  const stepMatch = text.match(/^step\s+(.+)$/);
-  if (stepMatch) {
-    const step = unquote(stepMatch[1] ?? "");
-    if (step === "") {
-      return { message: `trigger の段名が空です ("${name}")`, hint: '`trigger: step "取込み"` の形で段の名前を書く' };
-    }
-    return { kind: "step", step };
-  }
-  for (const op of TRIGGER_OPS) {
-    const at = text.indexOf(op);
-    if (at < 0) continue;
-    const source = text.slice(0, at).trim();
-    const rhs = text.slice(at + op.length).trim();
-    if (!isValueName(source)) {
-      return {
-        message: `trigger が見張る値の名前が使えません: "${source}" ("${name}")`,
-        hint: "英字か _ で始め、 英数字と _ だけを使う",
-      };
-    }
-    const threshold = Number(rhs);
-    if (rhs === "" || !Number.isFinite(threshold)) {
-      return {
-        message: `trigger の境目が数ではありません: "${rhs}" ("${name}")`,
-        hint: "`trigger: vDone >= 100` のように数で書く",
-      };
-    }
-    return { kind: "reaches", source, op, threshold };
-  }
-  return {
-    message: `trigger の形が読めません: "${text}" ("${name}")`,
-    hint: '`step "取込み"` か `vDone >= 100` の形で書く',
-  };
-}
-
-/**
- * 中括弧で囲まれた本体が「きっかけ形」 かを見分ける。
- *
- * 式も中括弧で始まり中括弧で終わることがある (`{a} + {b}` / `{a}`)。 見分けるのは
- * **引用の外に `:` があるか**で、 式の中括弧は値の名前しか包まないため `:` を持たない。
- *
- * 名前で見分けない (`trigger` を含むか等)。 `{trigger} + 1` のように `trigger` という名前の値を
- * 読む式が書けるため、 名前で見ると式をきっかけ形と読み違える。
- */
-export function isTriggerBody(raw: string): boolean {
-  const t = raw.trim();
-  if (!t.startsWith("{") || !t.endsWith("}") || t.length < 2) return false;
-  const inner = t.slice(1, -1);
-  let quote: string | null = null;
-  for (const ch of inner) {
-    if (quote) {
-      if (ch === quote) quote = null;
-      continue;
-    }
-    if (ch === '"' || ch === "'") {
-      quote = ch;
-      continue;
-    }
-    if (ch === ":") return true;
-  }
-  return false;
-}
-
-/**
- * きっかけ形の中身を読む (`{ trigger: step "取込み", to: 100, dur: 2s }`)。
- *
- * 3 つとも必須にする。 既定値を置くと「書かなかった」 と「その値を書いた」 が同じになり、
- * 動かない時に何を直せばよいか分からなくなる。
- */
-export function parseValueTriggerBody(
-  body: string,
-  name: string,
-): { spec: ParsedValueTrigger; issues: [] } | { spec: null; issues: ValueSyntaxIssue[] } {
-  const issues: ValueSyntaxIssue[] = [];
-  const seen = new Map<string, string>();
-  for (const part of splitOutsideQuotes(body)) {
-    const at = part.indexOf(":");
-    if (at < 0) {
-      issues.push({ message: `"${part}" は key: value の形ではありません ("${name}")`, hint: "`trigger: ... , to: 100, dur: 2s` の形で書く" });
-      continue;
-    }
-    const key = part.slice(0, at).trim().toLowerCase();
-    const value = part.slice(at + 1).trim();
-    if (seen.has(key)) {
-      issues.push({ message: `"${key}" を 2 度書いています ("${name}")`, hint: "同じ項目は 1 度だけ書く" });
-      continue;
-    }
-    seen.set(key, value);
-  }
-
-  const known = new Set(["trigger", "to", "dur"]);
-  for (const key of seen.keys()) {
-    if (known.has(key)) continue;
-    issues.push({
-      message: `"${key}" は values に書けません ("${name}")`,
-      hint: `書けるのは ${[...known].join(" / ")} だけ`,
-    });
-  }
-
-  const triggerRaw = seen.get("trigger");
-  let trigger: ParsedValueTrigger["trigger"] | null = null;
-  if (triggerRaw === undefined) {
-    issues.push({ message: `trigger がありません ("${name}")`, hint: '`trigger: step "取込み"` か `trigger: vDone >= 100` を書く' });
-  } else {
-    const parsed = parseTriggerExpression(triggerRaw, name);
-    if ("message" in parsed) issues.push(parsed);
-    else trigger = parsed;
-  }
-
-  const toRaw = seen.get("to");
-  let to = 0;
-  if (toRaw === undefined) {
-    issues.push({ message: `to がありません ("${name}")`, hint: "`to: 100` のように動いた先の値を書く" });
-  } else {
-    to = Number(unquote(toRaw));
-    if (!Number.isFinite(to)) {
-      issues.push({ message: `to が数ではありません: "${toRaw}" ("${name}")`, hint: "`to: 100` のように数で書く" });
-    }
-  }
-
-  const durRaw = seen.get("dur");
-  let durationMs = 0;
-  if (durRaw === undefined) {
-    issues.push({ message: `dur がありません ("${name}")`, hint: "`dur: 2s` のように動く長さを書く" });
-  } else {
-    const parsedDur = parseDurationMs(unquote(durRaw));
-    if (parsedDur === null) {
-      issues.push({ message: `dur が読めません: "${durRaw}" ("${name}")`, hint: "`2s` / `1.5s` / `500ms` の形で、 0 より大きい長さを書く" });
-    } else {
-      durationMs = parsedDur;
-    }
-  }
-
-  if (issues.length > 0 || trigger === null) return { spec: null, issues };
-  return { spec: { trigger, to, durationMs }, issues: [] };
-}
-
-/**
- * 式が記法として書ける範囲に収まっているかを見る。
- *
- * 式が文法として正しいかは見ない。 そこは描画側が評価する時に判定して、その値だけを止める
- * (spec § 4.2 = 1 箇所の壊れで図全体を止めない)。 ここで見るのは **記法として書ける範囲に
- * 収まっているか**で、描画側が受け付けるが記法としては認めない書き方 (余り / 条件分岐 /
- * `min` `max` 以外の関数) を弾く。
- *
- * `{名前}` の中身と外側を分けて見る。 分けないと、名前に紛れた記号を式の記号と読み違える。
- */
-export function checkValueExpression(expression: string, name: string): ValueSyntaxIssue[] {
-  const issues: ValueSyntaxIssue[] = [];
-
-  // `{名前}` の中身は名前の規則で見る
-  const refRe = /\{([^}]*)\}/g;
-  let m: RegExpExecArray | null;
-  while ((m = refRe.exec(expression)) !== null) {
-    const ref = (m[1] ?? "").trim();
-    if (!VALUE_NAME_RE.test(ref)) {
-      issues.push({
-        message: `invalid reference "{${ref}}" in "${name}"`,
-        hint: "英字か _ で始め、 英数字と _ だけを使う",
-      });
-    }
-  }
-  if (expression.includes("{") && !expression.includes("}")) {
-    issues.push({ message: `unclosed "{" in "${name}"`, hint: "`{名前}` の形で閉じる" });
-  }
-
-  // 名前を外した残りが式の骨格。 ここに記法外の記号や関数が無いかを見る
-  const outside = expression.replace(/\{[^}]*\}/g, " ");
-  if (outside.includes("%")) {
-    issues.push({ message: `"%" は式に書けない ("${name}")`, hint: "四則 (+ - * /) だけを使う" });
-  }
-  if (outside.includes("?")) {
-    issues.push({
-      message: `条件分岐 (?:) は式に書けない ("${name}")`,
-      hint: "比較の結果は真 = 1 / 偽 = 0 の数になるので、 掛け算で切り替える",
-    });
-  }
-  for (const fn of outside.matchAll(/[a-zA-Z_][a-zA-Z0-9_.]*/g)) {
-    const word = fn[0];
-    if (VALUE_FNS.has(word)) continue;
-    issues.push({
-      message: `"${word}" は式に書けない ("${name}")`,
-      hint:
-        word.startsWith("Math.")
-          ? "min / max は Math. を付けずに書く"
-          : `使えるのは ${[...VALUE_FNS].join(" / ")} だけ。 値は {名前} で読む`,
-    });
-  }
-  const stray = outside.replace(/[a-zA-Z_][a-zA-Z0-9_.]*/g, " ").match(/[^0-9.,+\-*/()<>=!\s]/g);
-  if (stray) {
-    issues.push({
-      message: `"${[...new Set(stray)].join("")}" は式に書けない ("${name}")`,
-      hint: "四則 (+ - * /) / 括弧 / 比較 (> >= < <= == !=) / min / max だけを使う",
-    });
-  }
-
-  return issues;
-}

package/src/write-position.ts

@@ -1,270 +0,0 @@
-/**
- * 登場人物 1 人の位置を DSL 本文に書き込む。
- *
- * editor の画面で見えている座標を、 そのまま記法に落とすために使う。 書く人は図を見ながら
- * 数値を決められないので、 今の位置を出発点として渡す経路が要る。
- *
- * 記法を知っているのは本 package なので、 本文の書き換えもここに置く。 画面側に置くと
- * 記法が増えた時に画面側だけが取り残される。
- *
- * 書き方は 4 通りあり、 元の形を保ったまま位置だけを差し替える。 形を勝手に揃えると、
- * 書いた人の見た目が変わって差分が読めなくなる。
- */
-
-/** 位置の書き込み結果。 対象が見つからなければ null。 */
-export function writeActorPosition(
-  src: string,
-  actorName: string,
-  posX: number,
-  posY: number,
-): string | null {
-  if (!Number.isFinite(posX) || !Number.isFinite(posY)) return null;
-  const x = Math.round(posX);
-  const y = Math.round(posY);
-
-  // 改行コードは行ごとに元のまま残す。 buffer 全体で一括判定すると、 混在した本文で
-  // 無関係な行の改行まで書き換わって差分が変更箇所の外に広がる
-  const seg = src.split(/(\r\n|\n)/);
-  const lineAt = (i: number): string => seg[i * 2] ?? "";
-  const lineCount = Math.ceil(seg.length / 2);
-
-  // 探すのは `actors:` の中だけ。 全文を走ると、 別の項目に同じ名前で並ぶ行
-  // (`notes:` の下の `- API: service` 等) を先に掴んで書き換える (実測)
-  const span = actorsSpan(lineAt, lineCount);
-  if (!span) return null;
-
-  for (let i = span.from; i < span.to; i += 1) {
-    const head = matchActorHead(lineAt(i));
-    if (!head || head.name !== actorName) continue;
-
-    // 1. `- API: { kind: service }` = 中括弧の中に座標を入れる
-    if (head.rest.startsWith("{") && head.rest.endsWith("}")) {
-      seg[i * 2] = `${head.prefix}{ ${upsertInlineFields(head.rest.slice(1, -1), x, y)} }`;
-      return seg.join("");
-    }
-
-    // 2. `- API:` だけの行 = 続く字下げ行に `位置:` を入れる
-    if (head.hasColon && head.rest === "") {
-      return writeVerticalForm(seg, i, span.to, head.indent, x, y);
-    }
-
-    // 3. `- API: service` = 値の並びに `@x,y` を入れる
-    if (head.hasColon) {
-      seg[i * 2] = `${head.prefix}${upsertAtToken(head.rest, x, y)}`;
-      return seg.join("");
-    }
-
-    // 4. `- API` = 名前だけ。 値を書ける形にしてから座標を足す
-    seg[i * 2] = `${head.indentText}- ${head.rawName}: @${x},${y}`;
-    return seg.join("");
-  }
-  return null;
-}
-
-/**
- * `actors:` block の行範囲。 見つからなければ null。
- *
- * 開始は行頭の `actors:` に限る。 終わりは次の行頭項目 (字下げなしの `key:`) の直前。
- *
- * `actors:` が複数ある本文では最後のものを返す。 記法側は同じ項目が 2 度現れると後の方で
- * 上書きするため、 最初のものを見ると parser が採らない箱を書き換えることになる
- * (実測 = 後の block に居る箱の書き戻しが `null` になった)。
- */
-function actorsSpan(
-  lineAt: (i: number) => string,
-  lineCount: number,
-): { from: number; to: number } | null {
-  let from = -1;
-  let to = lineCount;
-  for (let i = 0; i < lineCount; i += 1) {
-    const line = lineAt(i);
-    if (/^actors[ \t]*:[ \t]*$/.test(line)) {
-      from = i + 1;
-      to = lineCount;
-      continue;
-    }
-    // 字下げのない `key:` は次の項目の始まり。 直前の block はそこで閉じる
-    if (from >= 0 && to === lineCount && /^[^\s#][^:]*:/.test(line)) to = i;
-  }
-  return from < 0 ? null : { from, to };
-}
-
-type ActorHead = {
-  /** 行頭から `:` までをそのまま保つ。 元の空白の入れ方を壊さないために持つ */
-  prefix: string;
-  indentText: string;
-  indent: number;
-  rawName: string;
-  name: string;
-  hasColon: boolean;
-  rest: string;
-};
-
-/**
- * `  - API: service` の形を、 前置き / 名前 / 残りに分ける。
- *
- * `:` を任意にした 1 本の正規表現では書けない。 名前の部分を控えめに取ると `A` で切って
- * 残りを `PI: service` と読んでしまう (実測)。 `:` のある形を先に当てる。
- */
-function matchActorHead(line: string): ActorHead | null {
-  const NAME = String.raw`"(?:[^"\\]|\\.)*"|[^:\s][^:]*?`;
-  const withColon = line.match(new RegExp(String.raw`^(\s*)-[ \t]+(${NAME})[ \t]*:[ \t]*(.*)$`));
-  if (withColon) {
-    const [, indentText = "", rawName = "", rest = ""] = withColon;
-    return {
-      // 元の空白の入れ方を壊さないよう、 行頭から値の直前までをそのまま持つ
-      prefix: line.slice(0, line.length - rest.length),
-      indentText,
-      indent: indentText.length,
-      rawName,
-      name: unquote(rawName),
-      hasColon: true,
-      rest: rest.trimEnd(),
-    };
-  }
-  const nameOnly = line.match(new RegExp(String.raw`^(\s*)-[ \t]+("(?:[^"\\]|\\.)*"|\S+)[ \t]*$`));
-  if (!nameOnly) return null;
-  const [, indentText = "", rawName = ""] = nameOnly;
-  return {
-    prefix: line,
-    indentText,
-    indent: indentText.length,
-    rawName,
-    name: unquote(rawName),
-    hasColon: false,
-    rest: "",
-  };
-}
-
-function unquote(raw: string): string {
-  if (!raw.startsWith('"') || !raw.endsWith('"') || raw.length < 2) return raw;
-  return raw.slice(1, -1).replace(/\\(.)/g, "$1");
-}
-
-/**
- * 空白区切りの値の並びに `@x,y` を差し込む。 既に書かれていれば差し替える。
- *
- * 引用符の中は触らない。 補足 (`"@1,2 の話"`) を座標と取り違えないため。
- */
-function upsertAtToken(rest: string, x: number, y: number): string {
-  const kept = splitOutsideQuotes(rest).filter((t) => !/^@-?\d+(\.\d+)?\s*[,、]\s*-?\d+(\.\d+)?$/.test(t));
-  kept.push(`@${x},${y}`);
-  return kept.join(" ");
-}
-
-/** 引用符と角括弧の外の空白で区切る。 */
-function splitOutsideQuotes(s: string): string[] {
-  const out: string[] = [];
-  let buf = "";
-  let quote: '"' | "'" | null = null;
-  let depth = 0;
-  for (let i = 0; i < s.length; i += 1) {
-    const c = s[i]!;
-    if (quote) {
-      buf += c;
-      if (quote === '"' && c === "\\") {
-        buf += s[i + 1] ?? "";
-        i += 1;
-        continue;
-      }
-      if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'") {
-      quote = c;
-      buf += c;
-      continue;
-    }
-    if (c === "[") depth += 1;
-    if (c === "]") depth -= 1;
-    if (/\s/.test(c) && depth === 0) {
-      if (buf) out.push(buf);
-      buf = "";
-      continue;
-    }
-    buf += c;
-  }
-  if (buf) out.push(buf);
-  return out;
-}
-
-/** 中括弧の中の `posX` / `posY` を差し替える。 他の項目は順番ごと残す。 */
-function upsertInlineFields(inner: string, x: number, y: number): string {
-  const kept = splitTopLevel(inner).filter((f) => {
-    const key = f.slice(0, f.indexOf(":")).trim();
-    return key !== "posX" && key !== "posY";
-  });
-  kept.push(`posX: ${x}`, `posY: ${y}`);
-  return kept.join(", ");
-}
-
-/** 中括弧と角括弧の深さ 0 の `,` で区切る。 入れ子の中の項目を top-level と取り違えない。 */
-function splitTopLevel(inner: string): string[] {
-  const out: string[] = [];
-  let depth = 0;
-  let start = 0;
-  let quote: '"' | "'" | null = null;
-  for (let i = 0; i < inner.length; i += 1) {
-    const c = inner[i]!;
-    if (quote) {
-      if (quote === '"' && c === "\\") {
-        i += 1;
-        continue;
-      }
-      if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'") quote = c;
-    else if (c === "{" || c === "[") depth += 1;
-    else if (c === "}" || c === "]") depth -= 1;
-    else if (c === "," && depth === 0) {
-      out.push(inner.slice(start, i));
-      start = i + 1;
-    }
-  }
-  out.push(inner.slice(start));
-  return out.map((f) => f.trim()).filter((f) => f.length > 0);
-}
-
-/**
- * 縦に並べた形に `位置:` を入れる。
- *
- * 既にあれば値だけ差し替える。 無ければ最後の項目の次に足す。 字下げは既にある項目に
- * 合わせ、 項目が 1 つも無ければ頭の字下げに 4 を足す。
- *
- * 差し替える対象は登場人物の直下の項目だけ。 深さを見ないと、 入れ子の中の `位置:`
- * (`nodes: → header: → 位置:`) を掴んで書き換える (実測)。
- */
-function writeVerticalForm(
-  seg: string[],
-  headIdx: number,
-  lineCount: number,
-  headIndent: number,
-  x: number,
-  y: number,
-): string {
-  let lastChild = -1;
-  let childIndent = -1;
-  for (let j = headIdx + 1; j < lineCount; j += 1) {
-    const line = seg[j * 2] ?? "";
-    if (line.trim() === "") continue;
-    const indent = line.length - line.trimStart().length;
-    if (indent <= headIndent) break;
-    if (childIndent < 0) childIndent = indent;
-    lastChild = j;
-    // 位置 / pos の行が既にあれば、 その行の値だけ差し替える。 直下の深さのものだけを見る
-    const key = indent === childIndent ? line.trim().match(/^(位置|pos)\s*:/) : null;
-    if (key) {
-      seg[j * 2] = `${" ".repeat(indent)}${key[1]}: ${x},${y}`;
-      return seg.join("");
-    }
-  }
-  const indent = childIndent >= 0 ? childIndent : headIndent + 4;
-  const newLine = `${" ".repeat(indent)}位置: ${x},${y}`;
-  const insertAt = (lastChild >= 0 ? lastChild : headIdx) + 1;
-  // 挿入位置の直前で実際に使われている改行に合わせる。 末尾に足す時は最後の区切りを見る
-  const sep = seg[insertAt * 2 - 1] ?? seg[seg.length - 2] ?? "\n";
-  if (insertAt * 2 >= seg.length) seg.push(sep, newLine);
-  else seg.splice(insertAt * 2, 0, newLine, sep);
-  return seg.join("");
-}