@cardenelabs/cdl 0.40.5 → 0.40.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardenelabs/cdl",
-  "version": "0.40.5",
+  "version": "0.40.6",
   "description": "CDL (Chainome Diagram Language). Mermaid-like declarative DSL that compiles to animated SVG diagrams. Built for blockchain / Solidity flows, generic enough for sequence / flow / state / ER / topology diagrams.",
   "license": "MIT",
   "author": "cardene777",

package/src/validate.ts

@@ -1,4 +1,4 @@
-import type { CdlDiagram } from "./types";
+import type { CdlDiagram, CdlNode } from "./types";
 import { TONES as TONE_NAMES, NODE_KINDS } from "./types";
 import { templateRefIds } from "./render/utils";
 import { nodeTemplateTexts } from "./render/template-fields";
@@ -46,6 +46,31 @@ export const DRAW_KINDS: ReadonlySet<string> = new Set([
 const KINDS = new Set<string>(NODE_KINDS);
 const ENG_BANNED = /\b(FUNCTION|STORAGE|EVENT LOG|BALANCES MAPPING|READ|WRITE|EMIT|CALL)\b/;
 
+/**
+ * 図表の荷 (payload) を持つ節の欄 (cdl#743)。
+ *
+ * これらの欄を持つ節は **その節自体が図** で、段が指し示す相手ではない。 記法にも図表の節を
+ * activate する書き方が無いため、「どの phase でも activate されていない」 は書き手に直せない。
+ *
+ * **種別の一覧を持たない** = 図表の種別は増える (実測で 15 種)。 一覧を手で書くと、種別を
+ * 足した時にここへの追記を忘れて警告が復活する。 荷の欄で判定すれば自動で追従する
+ * (`rules/quality.md § 導出可能記述は人手で書かない` の経路 1)。
+ */
+const 図表の荷の欄 = [
+  "chartData",
+  "ganttData",
+  "mindData",
+  "funnelData",
+  "quadrantData",
+  "treeData",
+  "journeyData",
+] as const satisfies readonly (keyof CdlNode)[];
+
+/** 図表の荷を 1 つでも持つか。 持つ節は「使われていない」 の判定から外す */
+function 図表の節(n: CdlNode): boolean {
+  return 図表の荷の欄.some((欄) => n[欄] !== undefined);
+}
+
 /**
  * cdl が compile される前に通る validator。
  * 構造的破綻 (重複 id / 不存在 id 参照 / 必須要素 0 件 等) は throw、
@@ -263,7 +288,7 @@ export function validate(diag: CdlDiagram): void {
     for (const id of p.activate) allActivated.add(id);
   }
   for (const n of diag.nodes) {
-    if (!allActivated.has(n.id)) {
+    if (!allActivated.has(n.id) && !図表の節(n)) {
       warnings.push(`node "${n.id}" がどの phase でも activate されていない (unused、 typo の可能性)`);
     }
   }