@cardenelabs/dragon 0.30.0 → 0.32.0

package/src/compile/class.ts

@@ -1,100 +0,0 @@
-import { diagram, classDiagram } from "@cardenelabs/cdl";
-import type { CdlDiagram } from "@cardenelabs/cdl";
-import type { DslDocument } from "../types";
-
-import { 箱の題 } from "./node-title";
-
-import { slugify } from "./slug";
-
-/**
- * クラス図の組み立て。
- *
- * 各クラスを 1 つの箱 (`storage`) にする。 描画側は題 (クラス名) と区切り線と行
- * (項目 / 手続き) を UML のクラス箱として描く。
- *
- * **クラスごとに縦列を 1 本作り、横に並べる** (#1263)。 組立て API 側がそう並べており、
- * 1 本にまとめると同じ内容でも横並びが縦並びになる (実測 = 見本は 3 縦列 450 幅)。
- * 縦列に見出しは付けない = クラスの名前は箱が既に描いており、縦列は並べるための入れ物
- * (`er` / `state` と同じ扱い、#1241)。
- *
- * 箱の種類は `storage` に強制する。 行と小見出しは `applyV05Extensions` が後から載せる。
- *
- * 矢印は継承や保有を表す (`extends` / `aggregates` 等を書き手が説明に書く)。
- */
-export function compileClass(doc: DslDocument): CdlDiagram {
-  /*
-   * **組み立て器 (`classDiagram`) に渡す** (#1466)。
-   *
-   * 以前は箱と矢印を直に組んでいたため、行頭の印・端の塗り・印が付く側・段の配置が
-   * 1 つも出なかった = 画面の図と記法の図が別物になっていた。 組み立て器へ渡せば、
-   * 意匠の決まり (`CLASS_RELATION_LOOK`) を 1 箇所から引ける。
-   */
-  const b = classDiagram({ id: slugify(doc.title), topic: doc.title });
-  // 登場人物が 0 人なら枠も作らない。 先に作ると中身の無い枠が 1 つ残る (#1096)
-  if (doc.actors.length === 0)
-    return diagram(slugify(doc.title), { topic: doc.title, type: "class" }).build();
-
-  /*
-   * 縦列は `lane:` の順、段は `stack:` で決まる (#1466)。
-   *
-   * 書かない図は宣言した順に横 1 列 = 従来どおり。 1 つでも書けば格子に置く =
-   * **箱の 1 つの辺には関係を 1 本まで** を守るには段が要る。
-   */
-  const 列番号 = new Map<string, number>();
-  for (const a of doc.actors) {
-    if (a.lane === undefined) continue;
-    if (!列番号.has(a.lane)) 列番号.set(a.lane, 列番号.size);
-  }
-
-  for (const a of doc.actors) {
-    /*
-     * 行を持ち物と振る舞いに割る (#1466)。 **1 行ずつ括弧の有無で見る**。
-     *
-     * 区切りの行 (`───`) の位置では割らない = 振る舞いしか持たない箱は区切りを書けず、
-     * 全部が持ち物に落ちる (実測 = `Auditable` の `audit()` が四角の印で出た)。
-     * 区切りの行そのものは、組み立て器が群の間を空の行で作るので捨てる。
-     */
-    const rows = (a.rows ?? []).filter((r) => !/^[─-]+$/.test(r.trim()));
-    const 振る舞い = (r: string): boolean => r.includes("(");
-    const attributes = rows.filter((r) => !振る舞い(r));
-    const methods = rows.filter(振る舞い);
-    b.class({
-      id: slugify(a.name),
-      title: 箱の題(a),
-      ...(attributes.length > 0 ? { attributes: [...attributes] } : {}),
-      ...(methods.length > 0 ? { methods: [...methods] } : {}),
-      ...(a.eyebrow ? { stereotype: a.eyebrow } : {}),
-      ...(a.lane !== undefined ? { col: 列番号.get(a.lane) ?? 0 } : {}),
-      ...(a.stack !== undefined ? { row: a.stack } : {}),
-    });
-  }
-
-  for (const s2 of doc.flow) {
-    b.relation({
-      from: slugify(s2.from),
-      to: slugify(s2.to),
-      // 種類を書かない矢印は「使う」 扱い = 端が開いた矢になり、線と印の組が最も素直
-      type: s2.relation ?? "uses",
-      ...(s2.label ? { label: s2.label } : {}),
-      ...(s2.sub ? { cardinality: s2.sub } : {}),
-      // 出どころ側の多重度 (#1771)。 engine が出どころの端に添える (cdl#825)
-      ...(s2.tailSub ? { tailCardinality: s2.tailSub } : {}),
-      ...(s2.tone ? { tone: s2.tone } : {}),
-      ...(s2.style ? { style: s2.style } : {}),
-      ...(s2.head ? { head: s2.head } : {}),
-      ...(s2.headFill ? { headFill: s2.headFill } : {}),
-      ...(s2.tailHead ? { tailHead: s2.tailHead } : {}),
-    });
-  }
-
-  const built = b.build();
-  /*
-   * 記法が段を書いた図では、組み立て器が作る 1 つの段を捨てる (#1466)。
-   *
-   * 段の注入 (`injectPhasesFallback`) は「段が 1 つも無い」 図にだけ効く。 組み立て器へ
-   * 渡すようにしたことで自動の段が 1 つ付き、書いた段が届かなくなった (実測 = 6 段書いた
-   * 図が 1 段で出た)。
-   */
-  const 書いた段がある = (doc.animate?.phases.length ?? 0) > 0;
-  return 書いた段がある ? { ...built, phases: [] } : built;
-}

package/src/compile/er.ts

@@ -1,44 +0,0 @@
-import { er } from "@cardenelabs/cdl";
-import { 箱の題 } from "./node-title";
-import type { CdlDiagram } from "@cardenelabs/cdl";
-import type { DslDocument } from "../types";
-
-import { ERの関係の指定を作る } from "./er-relation";
-import { compileGenericWithAnimate } from "./generic";
-
-import { slugify } from "./slug";
-
-export function compileEr(doc: DslDocument): CdlDiagram {
-  // v0.4 ... animation あり時 builder 直接経路 (entity を box として配置)
-  if (doc.animate && doc.animate.phases.length > 0) {
-    // 460 は preset 側の旧既定に合わせた値だった。 preset が箱 400 + 余白 25 × 2 = 450 を
-    // 宣言するようになった (cardene777/cdl#359) ので、 同じ図が animate の有無で 10 world
-    // ずれないようここも 450 にする。
-    return compileGenericWithAnimate(doc, { kind: "er", laneWidth: 450 });
-  }
-  // er preset ... actors を entity に、 流れ を relation に
-  const erBuilder = er({
-    id: slugify(doc.title),
-    topic: doc.title,
-  });
-  for (const a of doc.actors) {
-    // entity rows は DSL では宣言できないので、 actor 名のみ entity 化
-    // v0.3 で「列定義」 ブロックを追加検討
-    erBuilder.entity({
-      id: slugify(a.name) || a.name,
-      title: 箱の題(a),
-      rows: [], // v0.2 では rows なし
-    });
-  }
-  for (const s of doc.flow) {
-    // 多重度と名前と端は、段を持つ図と同じ 1 か所で決める (#2105)。
-    // 語を書かない関係に `1:N` を補わない = 書いていない語を字と端に出さない
-    erBuilder.relation({
-      from: slugify(s.from),
-      to: slugify(s.to),
-      ...ERの関係の指定を作る(s),
-      ...(s.tone ? { tone: s.tone } : {}),
-    });
-  }
-  return erBuilder.build();
-}

package/src/compile/solidity.ts

@@ -1,39 +0,0 @@
-import type { CdlDiagram } from "@cardenelabs/cdl";
-import type { DslDocument } from "../types";
-import { compileSequence } from "./sequence";
-/**
- * Solidity 専用 preset。
- *
- * 設計:
- * - actors を kind=contract / eoa / multisig 等で配置 (EOA は左、 contract は中央、 storage は右など layered layout)
- * - flow は function call の sequence (msg.sender → contract.fn() → internal call → emit event)
- * - storage 更新は state + rows binding で自動 (kind: storage の actor に rows: ["bal[A]: {balA}", ...])
- * - event は kind: event の actor を右端に並べ、 emit edge で発火を表現
- * - revert は tone: error の edge で表現
- *
- * sequence preset を base に使い、 Solidity 文脈に最適化した default を載せる:
- * - default tone: accent (call) / success (emit) / error (revert)
- * - default style: solid (call) / dotted-flow (state-change)
- */
-export function compileSolidity(doc: DslDocument): CdlDiagram {
-  // sequence preset と同等構造で組み立てる、 lane 順は eoa / contract / storage / event の優先順で sort
-  const kindOrder: Record<string, number> = {
-    eoa: 0,
-    actor: 0,
-    multisig: 0,
-    signer: 0,
-    wallet: 0,
-    contract: 1,
-    proxy: 1,
-    library: 1,
-    interface: 1,
-    storage: 2,
-    event: 3,
-  };
-  const sorted = [...doc.actors].sort(
-    (a, b) => (kindOrder[a.kind] ?? 5) - (kindOrder[b.kind] ?? 5),
-  );
-  // sorted を doc.actors に上書きしてから sequence preset 経由で compile
-  const sortedDoc: DslDocument = { ...doc, actors: sorted };
-  return compileSequence(sortedDoc);
-}

package/src/compile/state.ts

@@ -1,71 +0,0 @@
-import { stateMachine } from "@cardenelabs/cdl";
-import type { NodeKind } from "@cardenelabs/cdl";
-import { 箱の題 } from "./node-title";
-import type { CdlDiagram } from "@cardenelabs/cdl";
-import type { DslDocument } from "../types";
-
-import { compileGenericWithAnimate } from "./generic";
-import { 描ける種別 } from "./kinds";
-
-import { slugify } from "./slug";
-import { 始まりと終わりの決め方 } from "./actors";
-export function compileState(doc: DslDocument): CdlDiagram {
-  // v0.4 ... animation あり時 builder 直接経路 (各 state を lane で配置、 transition を edge)
-  //
-  // **種類を書いた形は動きの有無に関わらず generic 経路へ** (#1450、 #1263 と同じ理由)。
-  // 動く図だけで効かせると、同じ記法でも静止図では指定が黙って消える
-  // (実測 = `kind: mark-start` を書いた箱が `card` になり知らせも出ない)
-  if ((doc.animate && doc.animate.phases.length > 0) || 既定と違う種類を書いた(doc)) {
-    return compileGenericWithAnimate(doc, { kind: "state", laneWidth: 360 });
-  }
-  // stateMachine preset ... actors を state に、 流れ を transition に
-  const fsm = stateMachine({
-    id: slugify(doc.title),
-    topic: doc.title,
-  });
-  const 決め方 = 始まりと終わりの決め方(doc);
-  for (let i = 0; i < doc.actors.length; i++) {
-    const a = doc.actors[i]!;
-    // 書いた `initial:` / `final:` が勝つ。 1 つも書いていなければ順序で決める
-    const initial = 決め方.始まり(a, i);
-    const final = 決め方.終わり(a, i);
-    fsm.state({
-      id: slugify(a.name) || `s${i}`,
-      title: 箱の題(a),
-      ...(initial ? { initial: true } : {}),
-      ...(final ? { final: true } : {}),
-    });
-  }
-  for (const s of doc.flow) {
-    fsm.transition({
-      from: slugify(s.from),
-      to: slugify(s.to),
-      trigger: s.label,
-      ...(s.sub ? { guard: s.sub } : {}),
-      ...(s.tone ? { tone: s.tone } : {}),
-    });
-  }
-  return fsm.build();
-}
-
-/** 状態の図で `stateMachine` preset が全ての箱に使う種類 */
-export const 状態の図の既定の種類: NodeKind = "card";
-
-/**
- * 状態の図で、既定と違う種類を書いた登場人物がいるか (#1450)。
- *
- * `stateMachine` preset は全ての状態を `card` で描くため、書いた `kind:` が黙って消える。
- * 始点終点の印 (`mark-start` / `mark-end`) を書けるようにするには、書いた形を効かせる必要がある。
- *
- * **「書いたか」 だけでは広すぎる**。 記法だけの種類 (`kind: state` 等) は `card` に読み替わり、
- * preset の出す形と同じになる = 書いても何も変わらないので経路を切り替える理由が無い。
- * 切り替えると既存の図の id と枠の作りが変わる (実測で golden 8 件が落ちた)。
- *
- * 読み替えた後の種類が既定と違う時だけ切り替える。 こうすると「書いたのに効かない」 は消え、
- * 「書いたが結果が同じ」 は従来の経路に留まる。
- */
-export function 既定と違う種類を書いた(doc: DslDocument): boolean {
-  return doc.actors.some(
-    (a) => a.kindWritten === true && 描ける種別(a.kind) !== 状態の図の既定の種類,
-  );
-}