@cardenelabs/dragon 0.14.0 → 0.16.0

package/src/v05/parser.ts

@@ -56,6 +56,7 @@ import type {
   DslAxes,
   DslDocument,
   DslActor,
+  DslNodeKind,
   DslDynShape,
   DslReadout,
   DslInput,
@@ -248,6 +249,11 @@ export const PRESET_TYPES: ReadonlySet<PresetType> = new Set([
   "pie",
   "bar",
   "line",
+  "gauge",
+  "radial",
+  "stat",
+  "waffle",
+  "stacked",
   "funnel",
   "tree",
   "journey",
@@ -262,10 +268,13 @@ const NODE_KIND_DEFAULT: NodeKind = "actor";
  * 記法だけが持つ種類。 描画側には無いが、 図種ごとの組み立てで意味を持つ。
  *
  * `contract` / `eoa` / `multisig` / `proxy` / `library` / `interface` は Solidity 図の
- * 役割分けに、 `entity` / `state` は ER 図と状態遷移図に使う。 組み立ての段階で描画できる
- * 種類に置き換わるため、 そのまま描画側に渡ることはない。
+ * 役割分けに、 `entity` / `state` は ER 図と状態遷移図に使う。
+ *
+ * **描画側へ渡す前に必ず読み替える** (`compile.ts` の `描ける種別`)。 読み替えを通さずに渡すと
+ * 図の組み立てが落ちる = 描画側は知らない種類の大きさを引けない (#1420 で実測、
+ * `Cannot read properties of undefined (reading 'h')`)。
  */
-const DSL_ONLY_KINDS = [
+export const DSL_ONLY_KINDS = [
   "entity",
   "state",
   "contract",
@@ -276,6 +285,9 @@ const DSL_ONLY_KINDS = [
   "interface",
 ] as const;
 
+/** 記法だけが持つ種類。 描画側の `NodeKind` には含まれない */
+export type DslOnlyKind = (typeof DSL_ONLY_KINDS)[number];
+
 /**
  * AWS などの固有名を、 同じ役割を表す汎用の種類に読み替える表。
  *
@@ -1082,15 +1094,16 @@ function classifyValues(values: string[], line: number, errors: DslError[]): Act
 }
 
 /**
- * 書かれた種類名を、 描画できる種類に解決する。
+ * 書かれた種類名を、 記法が扱う種類に解決する。
  *
- * 固有名 (`lambda` / `rds` 等) は読み替え表を通す。 それ以外はそのまま返す。
+ * 固有名 (`lambda` / `rds` 等) は読み替え表を通す。 記法だけが持つ種類はそのまま返し、
+ * 描画側へ渡す時に `compile.ts` の `描ける種別` が読み替える。
  */
-export function resolveNodeKind(raw: string): NodeKind {
+export function resolveNodeKind(raw: string): DslNodeKind {
   if (raw === "") return NODE_KIND_DEFAULT;
   // `Object.hasOwn` で引く。 素の添字だと `toString` 等の既定の持ち物が引けてしまい、
   // 種類として関数が返る。 呼ぶ前に受理集合で弾いてはいるが、 表を引く側でも閉じておく。
-  return Object.hasOwn(INFRA_KIND_ALIAS, raw) ? INFRA_KIND_ALIAS[raw]! : (raw as NodeKind);
+  return Object.hasOwn(INFRA_KIND_ALIAS, raw) ? INFRA_KIND_ALIAS[raw]! : (raw as DslNodeKind);
 }
 
 function numberOrUndef(s: string | undefined): number | undefined {
@@ -2368,6 +2381,11 @@ function applyContinuationLines(actor: DslActor, rest: Line[], errors: DslError[
       case "値":
         out.value = stripQuotes(raw);
         break;
+      // 前の時点の値 (#1450)。 内訳を帯で示す図と値 1 つを大きく示す図が読む
+      case "previous":
+      case "前の値":
+        out.previous = stripQuotes(raw);
+        break;
       case "shape":
       case "図形":
         out.shape = 図形として読む(raw, ln.no, errors);
@@ -2564,6 +2582,9 @@ export const ACTOR_ITEM_KEYS: ReadonlySet<string> = new Set([
   "補足",
   "value",
   "値",
+  // 前の時点の値 (#1450)。 内訳の変化を帯で示す図と、値 1 つを大きく示す図が読む
+  "previous",
+  "前の値",
   "rows",
   "行",
   // 箱の中に描く図形 (#1374)
@@ -2728,6 +2749,7 @@ const ACTOR_RESERVED_FIELDS: ReadonlySet<string> = new Set([
   "subtitle",
   "eyebrow",
   "value",
+  "previous",
   "rows",
   "lane",
   "stack",
@@ -2880,6 +2902,7 @@ export const INLINE_ACTOR_ALIASES: Record<string, string> = {
   種類: "kind",
   補足: "subtitle",
   値: "value",
+  前の値: "previous",
   行: "rows",
 };
 
@@ -2902,6 +2925,7 @@ export const INLINE_ACTOR_KEYS: ReadonlySet<string> = new Set([
   "subtitle",
   "eyebrow",
   "value",
+  "previous",
   "rows",
   "lane",
   "stack",
@@ -3072,6 +3096,7 @@ function parseActor(line: Line, errors: DslError[]): DslActor | null {
       owner: isPart ? undefined : opts.owner,
       end: isPart ? undefined : opts.end,
       value: opts.value,
+      previous: opts.previous,
       rows: opts.rows
         ? opts.rows
             .replace(/^\[|\]$/g, "")
@@ -3504,7 +3529,10 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
       continue;
     }
     if (key === "draw") {
-      const 語 = stripQuotes(value).trim();
+      // `draw: line 0.4` = 語の後ろに「描き終えるまでに段の何割を使うか」 を書ける (#1441)。
+      // 割合を別の項目にすると「割合だけ書いて `draw` が無い段」 が書けてしまい、
+      // 何も起きない指定になる。 同じ行なら書けない
+      const [語 = "", 割合の文字, ...余り] = stripQuotes(value).trim().split(/\s+/);
       // **読めない語を黙って捨てない** (#1304 / #1306 と同じ扱い)。 受ける語は 1 つだけで、
       // 書き間違いはその段が何も描かない形になって手掛かりが残らない
       if (!DRAW_WORDS.has(語)) {
@@ -3513,9 +3541,29 @@ function parsePhase(block: Line[], errors: DslError[]): DslPhase | null {
           message: `draw に書けない語です: "${語}"`,
           hint: `使える語 = ${[...DRAW_WORDS].join(", ")}`,
         });
+      } else if (余り.length > 0) {
+        errors.push({
+          line: ln.no,
+          message: `draw に書ける項目は語と割合の 2 つまでです: "${stripQuotes(value).trim()}"`,
+          hint: "use `draw: line 0.4`",
+        });
       } else {
         phase.draw = 語;
         phase.drawPos = { line: ln.no };
+        if (割合の文字 !== undefined) {
+          const 割合 = Number(割合の文字);
+          // 範囲外を黙って捨てない。 描画側は 1 に落として図を出すため、
+          // 知らせが無いと「書いたのに速さが変わらない」 が手掛かりなしで起きる
+          if (!Number.isFinite(割合) || 割合 <= 0 || 割合 > 1) {
+            errors.push({
+              line: ln.no,
+              message: `draw の割合が範囲外です: "${割合の文字}"`,
+              hint: "0 より大きく 1 以下で書きます (例 `draw: line 0.4`)",
+            });
+          } else {
+            phase.drawRatio = 割合;
+          }
+        }
       }
       i += 1;
       continue;