@cardenelabs/dragon 0.19.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardenelabs/dragon",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Dragon — Mermaid 感覚で animated SVG を生成する Text DSL。 cdl engine を内部利用。",
   "license": "MIT",
   "author": "cardene777",
@@ -57,7 +57,7 @@
     "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build"
   },
   "dependencies": {
-    "@cardenelabs/cdl": "^0.25.0"
+    "@cardenelabs/cdl": "^0.27.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/compile.ts

@@ -583,6 +583,8 @@ function 静止した図の焦点を外す(diagram: CdlDiagram, doc: DslDocument
   }
 }
 
+const 既定の配色を持つ図種: ReadonlySet<DslDocument["type"]> = new Set(["er", "class"]);
+
 /**
  * 図の配色と、表の箱の行の縞を当てる (#1553)。
  *
@@ -591,10 +593,14 @@ function 静止した図の焦点を外す(diagram: CdlDiagram, doc: DslDocument
  * cdl は色を持たない。 名前だけを `data-cdl-palette` として markup に出し、消費側
  * (`cdl-theme.css`) が名前を見て 7 つの口 (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線) に色を当てる。
  *
- * ER 図は書かなくても `kinari` (生成りに茶) になる。 ER 図は小さい字が密に並ぶので、他の図種と
- * 同じ色みだと行を追えない = 既定を持たせて「作れば必ずその色みになる」 形にする。
+ * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。
+ * どちらも箱の作りが同じ (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、
+ * 行を横に追う目印 (行の縞) が要る。
+ * 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に落ちて 1 本も出ない。
  * 書き手が `palette:` を書いた時はそちらが勝つ。
  *
+ * クラス図の意匠は `docs/design/class/note.md` が持つ。
+ *
  * ## 行の縞
  *
  * cdl の `er()` 組み立て器は縞を既定で敷くが、**動きを持つ ER 図はその経路を通らない**
@@ -605,7 +611,7 @@ function 静止した図の焦点を外す(diagram: CdlDiagram, doc: DslDocument
  * ここで対象を絞って「書いたのに出ない」 欄を残さない。
  */
 function 配色と縞を当てる(diagram: CdlDiagram, doc: DslDocument): void {
-  const 配色 = doc.palette ?? (doc.type === "er" ? "kinari" : undefined);
+  const 配色 = doc.palette ?? (既定の配色を持つ図種.has(doc.type) ? "kinari" : undefined);
   if (配色 !== undefined) diagram.palette = 配色;
   if (doc.type !== "er") return;
   for (const node of diagram.nodes) {
@@ -6685,6 +6691,17 @@ const 縦列を選べる図種: ReadonlySet<PresetType> = new Set<PresetType>([
   "swimlane",
   "class",
   "state",
+  /*
+   * ER 図 (#1571)。
+   *
+   * `er` の組み立て器は実体 1 つにつき帯を 1 本作り、必ず段 0 に置く = 表が横 1 列にしか
+   * 並ばない。 関係を 4 本持つ実体があると、どう並べ替えても 2 本は隣を飛び越す
+   * (意匠帳 `docs/design/er/note.md` § 記法の制約 が 4 通りを実測しており、1 列は縦横比 7.0 /
+   * 最長の線 4068、格子は 3.5 / 836)。
+   *
+   * **全ての箱が縦列を書いた時だけ** 効くので、書かない図はいままでどおり組み立て器が並べる。
+   */
+  "er",
 ]);
 
 /**

package/src/json-parser.ts

@@ -197,7 +197,10 @@ export interface DragonJson {
    * 図の配色 (#1553)。 記法の最上位 `palette:` と同じ。
    *
    * 名前だけを図に載せる = cdl は色を持たず、値は `cdl-theme.css` が決める。
-   * ER 図は書かなくても `kinari` になる。
+   * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+   * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+   * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+   * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
    */
   palette?: DslPalette;
 }

package/src/keywords.ts

@@ -61,7 +61,12 @@ export type DslPalette = (typeof PALETTES)[number];
 /**
  * 配色の別名。 向きと同じく日本語と英語の両方で書ける。
  *
- * `kinari` = 生成りに茶 (ER 図の既定)、 `celadon` = 青磁に墨。
+ * `kinari` = 生成りに茶、 `celadon` = 青磁に墨。
+ *
+ * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+ * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+ * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+ * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
  */
 export const PALETTE_ALIAS: Record<string, DslPalette> = {
   kinari: "kinari",

package/src/schemas/diagram.json

@@ -2216,7 +2216,7 @@
         "kinari",
         "celadon"
       ],
-      "description": "図の配色。 kinari = 生成りに茶 (ER 図の既定)。 celadon = 青磁に墨。 名前だけが図に載り、色の値は消費側が決める。"
+      "description": "図の配色 (`kinari` = 生成りに茶、`celadon` = 青磁に墨) で、ER 図とクラス図は書かなくても `kinari` になり、書いた `palette` が優先され、名前だけが図に載って色の値は消費側が決める。"
     },
     "reveal": {
       "type": "string",

package/src/types.ts

@@ -182,7 +182,10 @@ export type DslDocument = {
    * 図の配色 (`palette:`、 #1553)。
    *
    * 名前だけを持つ。 実際の色は消費側 (`cdl-theme.css`) が決めるので、ここには値を書かない。
-   * ER 図は書かなくても `kinari` (生成りに茶) になる = 別の色みにしたい時だけ書く。
+   * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+   * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+   * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+   * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
    */
   palette?: DslPalette;
   groups?: Record<string, DslGroup>;

package/src/v05/parser.ts

@@ -176,7 +176,10 @@ export const TOP_LEVEL_KEYS = [
    * cdl は色を持たないので、名前だけを図に載せる。 消費側 (`cdl-theme.css`) が名前を見て
    * 7 つの口 (台 / 行の面 / 縞 / 枠 / 字 / 型名 / 線) に色を当てる。
    *
-   * ER 図は書かなくても `kinari` になる = 別の色みにしたい時だけ書く。
+   * ER 図とクラス図は書かなくても `kinari` (生成りに茶) になる。 どちらも箱の作りが同じ
+   * (行頭の印 + 左に名前 + 右に型) で、名前と型が離れて並ぶため、行を横に追う目印
+   * (行の縞) が要る。 縞の色は配色からしか来ないので、既定が無いと縞が箱の面と同じ色に
+   * 落ちて 1 本も出ない。 書き手が `palette:` を書いた時はそちらが勝つ。
    */
   "palette",
 ] as const;