@cardenelabs/dragon 0.18.3 → 0.20.0

package/dist/index.d.cts

@@ -58,7 +58,7 @@ type V05ParseResult = {
  * 書くと、項目を足した時に案内か一覧のどちらかが取り残される (実際に `states` / `values` が
  * 一覧に 1 件も無い状態で放置されていた)。
  */
-declare const TOP_LEVEL_KEYS: readonly ["title", "type", "actors", "flow", "states", "values", "animation", "viewport", "lanes", "groups", "eyebrow", "axes", "readouts", "inputs", "formulas", "events", "scrolls", "bands", "reveal", "direction"];
+declare const TOP_LEVEL_KEYS: readonly ["title", "type", "actors", "flow", "states", "values", "animation", "viewport", "lanes", "groups", "eyebrow", "axes", "readouts", "inputs", "formulas", "events", "scrolls", "bands", "reveal", "direction", "palette"];
 /** 受け付ける図種。 記法一覧はここを見る。 */
 declare const PRESET_TYPES: ReadonlySet<PresetType>;
 /**
@@ -146,6 +146,18 @@ declare const DRAW_WORDS: ReadonlySet<string>;
  */
 declare const DIRECTIONS: readonly ["縦", "横"];
 type DslDirection = (typeof DIRECTIONS)[number];
+/**
+ * 図の配色 (`palette:`、 #1553)。
+ *
+ * cdl は色を持たない (形だけを描く)。 名前を `data-cdl-palette` として markup に出すので、
+ * dragon の `cdl-theme.css` がその名前を見て 7 つの口 (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線)
+ * に色を当てる。
+ *
+ * **名前を自由文字列にしない**。 書き間違えると既定の色みのまま出るので、書き手には
+ * 「効かない」 としか見えない。 語を絞れば読めない語をその場で知らせられる。
+ */
+declare const PALETTES: readonly ["kinari", "celadon"];
+type DslPalette = (typeof PALETTES)[number];
 /** NodeKind 別名 (日本語 → English) */
 declare const NODE_KIND_ALIAS: Record<string, NodeKind>;
 /** Tone 別名 */
@@ -382,6 +394,16 @@ type DslDocument = {
     directionPos?: {
         line: number;
     };
+    /**
+     * 図の配色 (`palette:`、 #1553)。
+     *
+     * 名前だけを持つ。 実際の色は消費側 (`cdl-theme.css`) が決めるので、ここには値を書かない。
+     * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+     * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+     * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+     * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
+     */
+    palette?: DslPalette;
     groups?: Record<string, DslGroup>;
     /**
      * 値を見せる部品 (`readouts:`、 #1374)。 割合の輪や数え上げを図の脇に出す。
@@ -686,6 +708,10 @@ type DslStep = {
      * `kind` にしないのは、箱の種類 (`DslActor.kind`) と同じ語が別の意味を持つため。
      */
     msgKind?: SequenceMessageKind;
+    /** 辺の役目 (cdl#618)。 `main` を書いた辺だけ「いま」 の色で引く */
+    role?: "main";
+    /** 名前の下地を敷くか (cdl#618)。 書かなければ敷く */
+    labelPlate?: boolean;
     labelOffsetX?: number;
     labelOffsetY?: number;
     /** true で説明文を矢印の線の上に重ねる。 分岐図の条件ラベル用。 */
@@ -1598,6 +1624,16 @@ interface DragonJson {
     reveal?: EdgeReveal;
     /** 図の並ぶ向き (#1494)。 記法の最上位 `direction:` と同じ。 JSON は英語の語で書く */
     direction?: "vertical" | "horizontal";
+    /**
+     * 図の配色 (#1553)。 記法の最上位 `palette:` と同じ。
+     *
+     * 名前だけを図に載せる = cdl は色を持たず、値は `cdl-theme.css` が決める。
+     * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+     * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+     * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+     * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
+     */
+    palette?: DslPalette;
 }
 interface JsonActor {
     name: string;
@@ -1758,6 +1794,14 @@ interface JsonStep {
     tailHead?: EdgeHead;
     headFill?: EdgeHeadFill;
     tailHeadFill?: EdgeHeadFill;
+    /**
+     * 辺の役目 (cdl#618)。 記法の `{ role: main }` と同じ。
+     *
+     * `main` を書いた辺だけ「いま」 の色で引く。 主となる 1 本 (または 1 続き) にだけ書く。
+     */
+    role?: "main";
+    /** 名前の下地を敷くか (cdl#618)。 記法の `{ labelPlate: false }` と同じ。 既定は敷く */
+    labelPlate?: boolean;
     /** クラス図の関係の語 (#1466)。 書くと端の形 / 塗り / 線種がまとめて決まる */
     relation?: ClassRelationType;
     /** 順序図の言づての種類 (#1466)。 `call` / `return` / `fire` */
@@ -2309,6 +2353,15 @@ declare const diagramJsonSchema: {
                         enum: string[];
                         description: string;
                     };
+                    role: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    labelPlate: {
+                        type: string;
+                        description: string;
+                    };
                     kind: {
                         type: string;
                         enum: string[];
@@ -3083,6 +3136,11 @@ declare const diagramJsonSchema: {
             enum: string[];
             description: string;
         };
+        palette: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
         reveal: {
             type: string;
             enum: string[];

package/dist/index.d.ts

@@ -58,7 +58,7 @@ type V05ParseResult = {
  * 書くと、項目を足した時に案内か一覧のどちらかが取り残される (実際に `states` / `values` が
  * 一覧に 1 件も無い状態で放置されていた)。
  */
-declare const TOP_LEVEL_KEYS: readonly ["title", "type", "actors", "flow", "states", "values", "animation", "viewport", "lanes", "groups", "eyebrow", "axes", "readouts", "inputs", "formulas", "events", "scrolls", "bands", "reveal", "direction"];
+declare const TOP_LEVEL_KEYS: readonly ["title", "type", "actors", "flow", "states", "values", "animation", "viewport", "lanes", "groups", "eyebrow", "axes", "readouts", "inputs", "formulas", "events", "scrolls", "bands", "reveal", "direction", "palette"];
 /** 受け付ける図種。 記法一覧はここを見る。 */
 declare const PRESET_TYPES: ReadonlySet<PresetType>;
 /**
@@ -146,6 +146,18 @@ declare const DRAW_WORDS: ReadonlySet<string>;
  */
 declare const DIRECTIONS: readonly ["縦", "横"];
 type DslDirection = (typeof DIRECTIONS)[number];
+/**
+ * 図の配色 (`palette:`、 #1553)。
+ *
+ * cdl は色を持たない (形だけを描く)。 名前を `data-cdl-palette` として markup に出すので、
+ * dragon の `cdl-theme.css` がその名前を見て 7 つの口 (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線)
+ * に色を当てる。
+ *
+ * **名前を自由文字列にしない**。 書き間違えると既定の色みのまま出るので、書き手には
+ * 「効かない」 としか見えない。 語を絞れば読めない語をその場で知らせられる。
+ */
+declare const PALETTES: readonly ["kinari", "celadon"];
+type DslPalette = (typeof PALETTES)[number];
 /** NodeKind 別名 (日本語 → English) */
 declare const NODE_KIND_ALIAS: Record<string, NodeKind>;
 /** Tone 別名 */
@@ -382,6 +394,16 @@ type DslDocument = {
     directionPos?: {
         line: number;
     };
+    /**
+     * 図の配色 (`palette:`、 #1553)。
+     *
+     * 名前だけを持つ。 実際の色は消費側 (`cdl-theme.css`) が決めるので、ここには値を書かない。
+     * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+     * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+     * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+     * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
+     */
+    palette?: DslPalette;
     groups?: Record<string, DslGroup>;
     /**
      * 値を見せる部品 (`readouts:`、 #1374)。 割合の輪や数え上げを図の脇に出す。
@@ -686,6 +708,10 @@ type DslStep = {
      * `kind` にしないのは、箱の種類 (`DslActor.kind`) と同じ語が別の意味を持つため。
      */
     msgKind?: SequenceMessageKind;
+    /** 辺の役目 (cdl#618)。 `main` を書いた辺だけ「いま」 の色で引く */
+    role?: "main";
+    /** 名前の下地を敷くか (cdl#618)。 書かなければ敷く */
+    labelPlate?: boolean;
     labelOffsetX?: number;
     labelOffsetY?: number;
     /** true で説明文を矢印の線の上に重ねる。 分岐図の条件ラベル用。 */
@@ -1598,6 +1624,16 @@ interface DragonJson {
     reveal?: EdgeReveal;
     /** 図の並ぶ向き (#1494)。 記法の最上位 `direction:` と同じ。 JSON は英語の語で書く */
     direction?: "vertical" | "horizontal";
+    /**
+     * 図の配色 (#1553)。 記法の最上位 `palette:` と同じ。
+     *
+     * 名前だけを図に載せる = cdl は色を持たず、値は `cdl-theme.css` が決める。
+     * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+     * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+     * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+     * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
+     */
+    palette?: DslPalette;
 }
 interface JsonActor {
     name: string;
@@ -1758,6 +1794,14 @@ interface JsonStep {
     tailHead?: EdgeHead;
     headFill?: EdgeHeadFill;
     tailHeadFill?: EdgeHeadFill;
+    /**
+     * 辺の役目 (cdl#618)。 記法の `{ role: main }` と同じ。
+     *
+     * `main` を書いた辺だけ「いま」 の色で引く。 主となる 1 本 (または 1 続き) にだけ書く。
+     */
+    role?: "main";
+    /** 名前の下地を敷くか (cdl#618)。 記法の `{ labelPlate: false }` と同じ。 既定は敷く */
+    labelPlate?: boolean;
     /** クラス図の関係の語 (#1466)。 書くと端の形 / 塗り / 線種がまとめて決まる */
     relation?: ClassRelationType;
     /** 順序図の言づての種類 (#1466)。 `call` / `return` / `fire` */
@@ -2309,6 +2353,15 @@ declare const diagramJsonSchema: {
                         enum: string[];
                         description: string;
                     };
+                    role: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    labelPlate: {
+                        type: string;
+                        description: string;
+                    };
                     kind: {
                         type: string;
                         enum: string[];
@@ -3083,6 +3136,11 @@ declare const diagramJsonSchema: {
             enum: string[];
             description: string;
         };
+        palette: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
         reveal: {
             type: string;
             enum: string[];