@cardenelabs/dragon 0.12.0 → 0.13.0

package/src/types.ts

@@ -3,9 +3,19 @@
  * docs/cdl/text-dsl-spec.md の文法を AST に変換した中間表現
  */
 
-import type { NodeKind, Tone, EdgeStyle } from "@cardenelabs/cdl";
+import type { CdlDiagram, NodeKind, Tone, EdgeStyle } from "@cardenelabs/cdl";
 import type { RelativePos } from "./relative-pos";
 
+/**
+ * 箱の中に描く図形 (#1374)。 **描画側の型をそのまま使う**。
+ *
+ * 写して持つと欄が増えた時にずれる。 指した先が変われば型検査が教える。
+ */
+export type DslDynShape = NonNullable<CdlDiagram["nodes"][number]["shape"]>;
+
+/** 値を見せる部品 (#1374)。 図形と同じ理由で描画側の型をそのまま使う */
+export type DslReadout = NonNullable<CdlDiagram["readouts"]>[number];
+
 export type PresetType =
   | "sequence"
   | "flow"
@@ -96,6 +106,12 @@ export type DslDocument = {
   viewport?: DslViewport;
   lanes?: Record<string, DslLane>;
   groups?: Record<string, DslGroup>;
+  /**
+   * 値を見せる部品 (`readouts:`、 #1374)。 割合の輪や数え上げを図の脇に出す。
+   *
+   * 箱ではないので縦列に載らない。 図全体に 1 つの並びとして持つ。
+   */
+  readouts?: DslReadout[];
   /**
    * canvas pivot (CAR-1693 Phase 1) diagram-level layout mode。 未指定は "auto" default で
    * catalog 100+ backward compat。 "manual" は Phase 4 で drag → pos: 保存の完全 manual mode。
@@ -128,6 +144,26 @@ export type DslActor = {
   eyebrow?: string;
   value?: string;
   rows?: string[];
+  /**
+   * 箱の中に描く図形 (`shape:`、 #1374)。 水位や角度を状態で動かせる。
+   *
+   * 種類ごとに書ける欄が違う (`図形の表`)。 知らない種類と欄は読み取りが知らせる。
+   */
+  shape?: DslDynShape;
+  /**
+   * 箱に出す題 (`title:`、 #1381)。 書かなければ名前がそのまま題になる。
+   *
+   * 名前は図の中で 1 つに決まる必要がある (`focus:` と `flow:` が名前で指すため) 一方、
+   * 題は重なってよい。 同じ題の箱を並べる図と、題を持たない箱を、名前と切り離して書ける。
+   */
+  title?: string;
+  /**
+   * その箱を出すかどうかの条件 (`visibleIf:`、 #1381)。
+   *
+   * 状態を差し込める文字列で、描画側が真偽を判定する。 `"0"` / `"false"` / 空文字が偽で、
+   * それ以外は真。 値だけを見せる図が、場所を空けるためだけの見えない箱を置くのに使う。
+   */
+  visibleIf?: string;
   /**
    * 工程の並び (`type: gantt`) で、その工程の担当 (#1251)。
    *
@@ -261,6 +297,8 @@ export type DslStep = {
   /** v0.5+ inline option */
   guard?: string;
   cardinality?: string;
+  /** 矢印がどの辺から出るか (#1385)。 書かなければ描画側が自動で選ぶ */
+  side?: "top" | "right" | "bottom" | "left";
   labelOffsetX?: number;
   labelOffsetY?: number;
   /** true で説明文を矢印の線の上に重ねる。 分岐図の条件ラベル用。 */

package/src/v05/parser-types.ts

@@ -0,0 +1,17 @@
+/**
+ * 中括弧の中身を表で読むための型 (#1385 で `parser.ts` から切り出した)。
+ *
+ * **生成した表 (`readout-table.generated.ts`) がこの型を使う**。 `parser.ts` に置いたままだと
+ * 生成した表 → `parser.ts` → 生成した表 の輪ができる。 型だけを別に置けば輪が消える。
+ */
+
+/**
+ * 欄に書ける値の形。
+ *
+ * `真偽` は #1385 で足した。 描画側の部品に `boolean` の欄が 2 つあり、それまでの 5 形では
+ * 書けなかった。
+ */
+export type 欄の形 = "数" | "文字列" | "数か文字列" | "文字列の並び" | "向き" | "組の並び" | "真偽";
+
+/** 1 つの種類が受ける、必須の欄と全欄の形 */
+export type 図形の定義 = { 必須: readonly string[]; 欄: Record<string, 欄の形> };