@cardenelabs/dragon 0.8.0 → 0.9.0

package/package.json

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

package/src/compile.ts

@@ -17,6 +17,7 @@ import {
   applyDerivedValues, parseFormula,
 } from "@cardenelabs/cdl";
 import { parseFocusEntry } from "./focus";
+import { DRAW_TARGETS } from "./v05/parser";
 import { isColorValue, stripExternalPaint } from "./color";
 import {
   MAX_INPUT_ELEMENTS,
@@ -91,7 +92,11 @@ export type CompileNotice = {
     // 最上位に `eyebrow:` を書いたが、 箱ごとに分かれる図種で相手が決まらなかった (#1247)
     | "eyebrow-not-honored"
     // 静止した `type: flow` で、書いた矢印の端が使われなかった (#1269)
-    | "flow-endpoint-not-honored";
+    | "flow-endpoint-not-honored"
+    // 起点から描く動きを持たない図種で段に `draw:` を書いた (#1312)
+    | "draw-not-honored"
+    // `draw:` の語がその図種と食い違う (`type: bar` に `draw: pie`、 #1314)
+    | "draw-target-mismatch";
   /** 対象の名前。 光らせる相手なら書かれた指定そのまま */
   actor: string;
   /** 書かれていた行 */
@@ -212,6 +217,7 @@ export function compileToCdl(doc: DslDocument, opts?: CompileToCdlOpts): CdlDiag
   reportFlowEndpointNotHonored(doc, 分けた.元の名前, opts?.onNotice);
   reportLaneNotHonored(書いたまま, opts?.onNotice);
   reportDocEyebrowNotHonored(書いたまま, opts?.onNotice);
+  reportDrawNotHonored(書いたまま, opts?.onNotice);
   reportChartFieldsNotHonored(書いたまま, opts?.onNotice);
   reportAxesNotHonored(書いたまま, opts?.onNotice);
   // `位置: Web の右` を実際の配置から絶対座標に直す。 以降は座標を直接書いた時と同じ経路
@@ -553,6 +559,52 @@ function reportDocEyebrowNotHonored(doc: DslDocument, onNotice?: (n: CompileNoti
   });
 }
 
+/**
+ * 左から描く動きを持たない図種で段に `draw:` を書いた時に伝える (#1312)。
+ *
+ * 描く動きを持つのは今のところ折れ線だけ。 他の図種では書いても何も起きないため、
+ * 黙って捨てると「書いたのに伸びない」 が手掛かりなしで起きる。
+ *
+ * 段ごとに知らせる = 5 段のうち 1 段だけに書いた形で、どの段が効いていないかを読めるようにする。
+ */
+function reportDrawNotHonored(doc: DslDocument, onNotice?: (n: CompileNotice) => void): void {
+  if (!onNotice) return;
+  for (const phase of doc.animate?.phases ?? []) {
+    if (phase.draw === undefined) continue;
+    // 段の `pos` は `- step:` の行を指す。 書いた行に辿り着けるよう `drawPos` を優先する
+    const line = phase.drawPos?.line ?? phase.pos?.line ?? 0;
+    if (!DRAWABLE_DOC_TYPES.has(doc.type)) {
+      onNotice({
+        kind: "draw-not-honored",
+        actor: phase.name,
+        line,
+        message: `段 "${phase.name}" に書いた draw は効きません (type: ${doc.type} は起点から描く動きを持ちません)`,
+        hint: `draw が効くのは type: ${[...DRAWABLE_DOC_TYPES].join(" / ")} です`,
+      });
+      continue;
+    }
+    // 語が別の図種を指している形 (#1314)。 図は描けるので誤りにはしない
+    const 語の図種 = DRAW_TARGETS.get(phase.draw);
+    if (語の図種 !== undefined && 語の図種 !== doc.type) {
+      onNotice({
+        kind: "draw-target-mismatch",
+        actor: phase.name,
+        line,
+        message: `段 "${phase.name}" の draw: ${phase.draw} は type: ${doc.type} では効きません (${phase.draw} は type: ${語の図種} の図に書きます)`,
+        hint: `この図では draw: ${doc.type} と書いてください`,
+      });
+    }
+  }
+}
+
+/**
+ * 段の `draw:` が効く図種 (#1312 / #1314)。
+ *
+ * **語と図種の対応表から導く** (`DRAW_TARGETS`)。 一覧を写すと、語を足した時に片方だけ
+ * 古いまま残る。 描画側 (`cdl` の `CdlPhase.draw`) が対応する 3 種と一致する。
+ */
+const DRAWABLE_DOC_TYPES: ReadonlySet<PresetType> = new Set<PresetType>(DRAW_TARGETS.values());
+
 /**
  * 縦列を選べる図種で、一部の箱だけが縦列を書いた時に伝える (#1263)。
  *
@@ -5563,12 +5615,24 @@ function injectPhasesFallback(diagram: CdlDiagram, doc: DslDocument): void {
   // phase 注入。 CdlPhase.tweens[].stateId / sets[].stateId で state 参照 (state ではない)。
   for (const p of doc.animate.phases) {
     const activateIds: string[] = [...resolveIds(p.highlight ?? [])];
+    // `draw: line` を描画側の欄へ写す (#1312)。 相手は 1 箱で図全体を描く種別の箱で、
+    // 折れ線は必ずこの形になるため名前を書かせずに引ける。
+    //
+    // **`activate` と兼ねない**。 描画側は焦点と別集合で持つ (`cdl#512`) = 焦点が当たり
+    // 続ける図で毎段引き直しになるため。 書いた段だけが欄を持つ
+    const drawIds =
+      p.draw !== undefined &&
+      DRAW_TARGETS.get(p.draw) === doc.type &&
+      singleBoxNode !== undefined
+        ? [singleBoxNode.id]
+        : [];
     diagram.phases.push({
       id: slugify(p.name) || p.name,
       duration: p.durationMs,
       title: p.name,
       body: p.body ?? "",
       activate: activateIds,
+      ...(drawIds.length > 0 ? { draw: drawIds } : {}),
       tweens: (p.tweens ?? []).map((t) => ({ stateId: t.state, from: t.from, to: t.to })),
       sets: (p.sets ?? []).map((s) => ({ stateId: s.state, value: s.value })),
       ...(p.badge ? { badge: p.badge } : {}),

package/src/index.ts

@@ -13,16 +13,12 @@ export { compileToCdl } from "./compile";
 export type { CompileNotice } from "./compile";
 export { parseTextDslV05 } from "./v05";
 // 記法一覧が「実際に受け付ける値」 を実装から引くための公開。 手書きすると説明と実装がずれる。
-export { PRESET_TYPES, TOP_LEVEL_KEYS } from "./v05/parser";
+export { DRAW_TARGETS, DRAW_WORDS, PRESET_TYPES, TOP_LEVEL_KEYS } from "./v05/parser";
 export { TONE_ALIAS, NODE_KIND_ALIAS } from "./keywords";
 export { lintDiagram, autoFix } from "./notation-lint";
 export type { LintIssue, LintReport, LintSeverity } from "./notation-lint";
 // canvas pivot 新 spec 図境界計算 helper (§diagram-boundary SSOT)
-export {
-  computeDiagramBoundingBox,
-  rectsOverlap,
-  DIAGRAM_BOUNDARY_PADDING,
-} from "./canvas-bounds";
+export { computeDiagramBoundingBox, rectsOverlap, DIAGRAM_BOUNDARY_PADDING } from "./canvas-bounds";
 export type { DiagramBoundingBox } from "./canvas-bounds";
 // 位置を相対で書くための解決。 組み立て側と画面側の両方が同じ規則を使うために公開する。
 export {
@@ -78,6 +74,10 @@ export { isColorValue, pointsOutside, stripExternalPaint } from "./color";
 // 別々に持つと、片方だけが読める本文ができる (実測 = `位置: '300,200"` が
 // 画面側では座標 300 として通り、組み立て側では読めない値として知らせが出た)
 export { stripQuotes } from "./v05/parser";
+
+// 画面で色分けするための分解器 (#1310)。 色は持たず、種類名と位置だけを返す
+export { 記法を分解する, JSONを分解する, 区間に広げる } from "./tokenize";
+export type { トークン, トークンの種類 } from "./tokenize";
 // 大きすぎる入力を組み立てる前に止める上限 (#1005)。 画面側も同じ物差しで事前に知らせられるよう公開する。
 export {
   MAX_INPUT_ELEMENTS,
@@ -96,6 +96,8 @@ export { diagramJsonSchema } from "./schema";
 export type {
   DragonJson,
   JsonActor,
+  JsonActorNodeOverride,
+  JsonAxes,
   JsonStep,
   JsonPhase,
   JsonDslError,
@@ -204,15 +206,24 @@ function isV05Source(src: string): boolean {
   // 判定不足。 v0.4-specific syntax (`step "..." Xs` = colon なし step / `^\d+\.\s+` = 番号 flow) を
   // negative marker に追加。
   const V04_KEYWORDS = [
-    // Japanese v0.4 専用 keyword (v0.5 は英語のみ)
-    /^\s*タイトル\s*[:：]/,     // title (JA)
-    /^\s*種類\s*[:：]/,          // type (JA)
-    /^\s*登場人物\s*[:：]/,      // actors (JA)
-    /^\s*流れ\s*[:：]/,          // flow (JA)
-    /^\s*アニメーション\s*[:：]/,  // animation (JA)
-    /^\s*動作\s*[:：]/,          // step (JA)
-    /^\s*状態\s*[:：]/,          // state (JA)
-    /^\s*ステップ\s*[「『]/,     // step (JA)
+    // Japanese v0.4 専用 keyword (v0.5 は英語のみ)。
+    //
+    // **字下げした行には当てない** (#1300)。 v0.4 の見出しは行頭に書くが、v0.5 の縦書き形は
+    // 必ず字下げする。 同じ語が「v0.4 の見出し」 と「v0.5 の箱の欄 / 見本の状態名」 の両方で
+    // 使われるため、`\s*` を許すと **正しい v0.5 の本文が旧 parser へ回る**。
+    //
+    // 実測 = `種類:` を箱の欄として縦に書いた本文と、見本の状態名が下の 7 語のいずれかである
+    // 本文が、いずれも v0.4 として読まれて別の行を指す誤りを返していた。
+    /^タイトル\s*[:：]/, // title (JA)
+    /^種類\s*[:：]/, // type (JA)
+    /^登場人物\s*[:：]/, // actors (JA)
+    /^流れ\s*[:：]/, // flow (JA)
+    /^アニメーション\s*[:：]/, // animation (JA)
+    /^動作\s*[:：]/, // step (JA)
+    /^状態\s*[:：]/, // state (JA)
+    // 鉤括弧が続く形は v0.5 に無い (状態名は `ステップ: 5` の形しか取れない) ため、
+    // 字下げを許しても v0.5 と衝突しない。 v0.4 では `アニメーション:` の下に字下げして書く
+    /^\s*ステップ\s*[「『]/, // step (JA)
     // v0.4 English-specific syntax = colon なし step (v0.5 は step: 必須)
     /^\s*step\s+"[^"]+"\s+[\d.]+\s*s\b/,
     /^\s*step\s+'[^']+'\s+[\d.]+\s*s\b/,