@cardenelabs/dragon 0.34.0 → 0.35.0

package/src/export/index.ts

@@ -0,0 +1,146 @@
+/**
+ * 同じ原本の JSON から、mp4、GIF、HTML、PNG を書き出す。
+ *
+ * 見せ方は頁と同じく枠の幅で選ぶ (`chooseView`)。幅は寄って見せる窓の幅にもなる。
+ * 寄って見せる図で幅の指定が無い時は、記事の本文ほどの枠 (`DEFAULTS.followWidth`) で寄る。
+ * PNG は最後の段の止め絵を、全体を止めた見せ方で撮る。
+ * 字は図で描く字だけに削り、撮る頁と HTML の両方に同じ物を埋める。
+ */
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { paletteVars, resolvePalette, type Theme } from "../look/values";
+import { BUTTON_TEXT, stepNo } from "../player";
+import { drawSvg, type Rendered, renderDiagram } from "../render/svg";
+import type { ViewMode } from "../schema";
+import { chooseView } from "../view";
+import type { NotationLang } from "../words";
+import { film, launch, sizeOf, stage, still } from "./capture";
+import { charsOf, fontFaces } from "./fonts";
+import { pageHtml } from "./html";
+
+export type ExportFormat = "mp4" | "gif" | "html" | "png";
+
+export interface ExportOptions {
+  /** 書き出す先の dir。無ければ作り、書き出しに失敗した時は作った dir を残さない (#3013) */
+  outDir: string;
+  /** file の名前 (拡張子を除く)。既定は `diagram` */
+  name?: string;
+  /** 書き出す形。既定は 4 つ全て */
+  formats?: ExportFormat[];
+  /** 枠の幅 (CSS の px)。見せ方を選び、寄って見せる窓の幅になる */
+  width?: number;
+  palette?: string;
+  theme?: Theme;
+  /** mp4 の 1 秒のコマの数 */
+  fps?: number;
+  /** GIF の 1 秒のコマの数 */
+  gifFps?: number;
+  /** 図の中の字 (全体図の札、HTML の読み上げの名前、描けない時の断りの文) の言葉。書かなければ日本語 (#3001) */
+  lang?: NotationLang;
+}
+
+export interface ExportResult {
+  /** 書き出した file の path */
+  files: Partial<Record<ExportFormat, string>>;
+  view: ViewMode;
+  /** 撮ったコマの数 */
+  frames: number;
+  /** 動画のコマの大きさ (CSS の px)。撮る画素はこの 2 倍 */
+  width: number;
+  height: number;
+}
+
+/** 書き出せる形。命令が `--format` の値を確かめる時にも使う */
+export const FORMATS: readonly ExportFormat[] = ["mp4", "gif", "html", "png"];
+const DEFAULTS = { fps: 30, gifFps: 10, followWidth: 728 };
+
+const unescape = (s: string): string => s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&amp;/g, "&");
+
+/** SVG の中で描かれる字 (`<text>` の中身) */
+const svgTexts = (svg: string): string[] => [...svg.matchAll(/<text\b[^>]*>([\s\S]*?)<\/text>/g)].map((m) => unescape((m[1] ?? "").replace(/<[^>]+>/g, "")));
+
+/** 頁と書き出しで描かれうる字。寄って見せる時の全体図の題 (`followSvg` の中) と、釦と段の番号の字も含む */
+function drawnTexts(rendered: Rendered, followSvg: string | undefined): string[] {
+  const { diagram } = rendered;
+  const svgs = followSvg === undefined ? [rendered.svg] : [rendered.svg, followSvg];
+  const count = diagram.steps.length;
+  return [...svgs.flatMap(svgTexts), ...diagram.steps.flatMap((step, s) => [step.title, step.body, stepNo(s, count)]), ...Object.values(BUTTON_TEXT)];
+}
+
+export async function exportDiagram(input: unknown, options: ExportOptions): Promise<ExportResult> {
+  const formats = options.formats ?? FORMATS;
+  const lang = options.lang ?? "ja";
+  const rendered = renderDiagram(input, {
+    ...(options.palette ? { palette: options.palette } : {}),
+    ...(options.theme ? { theme: options.theme } : {}),
+    lang,
+  });
+  const { diagram, layout, timeline, theme } = rendered;
+  const palette = resolvePalette(rendered.palette);
+  const vars = paletteVars(palette, theme);
+  const width = options.width ?? (rendered.view === "follow" ? DEFAULTS.followWidth : layout.width);
+  const view = chooseView(rendered, width).mode;
+  // 寄って見せる図は動画と字の file の両方に使うので 1 度だけ描き、2 つの全体図の札の言葉を揃える
+  const followSvg = rendered.view === "fixed" ? undefined : drawSvg(diagram, layout, timeline, palette, theme, { width, lang });
+  const videoSvg = view === "follow" && followSvg ? followSvg : rendered.svg;
+  const fontCss = await fontFaces(charsOf(drawnTexts(rendered, followSvg)));
+
+  // 撮る物を全て撮り終えてから書く。撮る所で失敗した時に、書き出し先の dir と途中の file を残さないため (#3013)
+  const outputs: [ExportFormat, string | Buffer][] = [];
+
+  if (formats.includes("html")) outputs.push(["html", pageHtml(diagram, { palette: palette.id, theme, vars, lang }, fontCss)]);
+
+  let frames = 0;
+  const mp4 = formats.includes("mp4");
+  const gif = formats.includes("gif");
+  if (mp4 || gif || formats.includes("png")) {
+    const browser = await launch(lang);
+    try {
+      if (formats.includes("png")) {
+        const fixed = await stage(browser, rendered.svg, fontCss, "");
+        outputs.push(["png", await still(fixed, timeline.stills[timeline.stills.length - 1] ?? 0)]);
+      }
+      if (mp4 || gif) {
+        const fps = mp4 ? (options.fps ?? DEFAULTS.fps) : (options.gifFps ?? DEFAULTS.gifFps);
+        const gifEvery = gif ? Math.max(1, Math.round(fps / (options.gifFps ?? DEFAULTS.gifFps))) : 0;
+        const shot = await film(await stage(browser, videoSvg, fontCss, `${vars};background:var(--bg)`), {
+          total: timeline.total,
+          fps,
+          mp4,
+          gifEvery,
+          // GIF の色の表は、最初の絵と段ごとの止め絵から作る
+          samples: [0, ...timeline.stills],
+        });
+        frames = shot.frames;
+        if (shot.mp4) outputs.push(["mp4", shot.mp4]);
+        if (shot.gif) outputs.push(["gif", shot.gif]);
+      }
+    } finally {
+      await browser.close();
+    }
+  }
+  const files = writeOutputs(options.outDir, options.name ?? "diagram", outputs);
+  return { files, view, frames, ...sizeOf(videoSvg) };
+}
+
+/**
+ * 書き出し先の dir を作り、撮った物を並びの順に書く。
+ * 書いている途中で失敗した時は、この回に作った dir を中身ごと消してから投げ直す (#3013)。
+ * 前から在った dir は消さない。
+ */
+function writeOutputs(outDir: string, name: string, outputs: [ExportFormat, string | Buffer][]): Partial<Record<ExportFormat, string>> {
+  // 作った dir の内で一番上の path。前から在った時は undefined
+  const created = mkdirSync(outDir, { recursive: true });
+  const files: Partial<Record<ExportFormat, string>> = {};
+  try {
+    for (const [format, data] of outputs) {
+      const path = join(outDir, `${name}.${format}`);
+      writeFileSync(path, data);
+      files[format] = path;
+    }
+  } catch (error) {
+    if (created !== undefined) rmSync(created, { recursive: true, force: true });
+    throw error;
+  }
+  return files;
+}

package/src/field-messages.ts

@@ -0,0 +1,104 @@
+/**
+ * 原本の JSON の誤りの文 (#2999)。
+ *
+ * JSON は語を持たず file から言葉を決められないので、呼ぶ側 (頁なら頁の言葉) が言葉を渡す。
+ * 文は schema が使う決まり (JSON Schema の keyword) ごとに持ち、ajv の英語の文はそのまま出さない。
+ * schema に決まりを足して文が無い時は、`every-schema-keyword-has-messages` の検査が落ちる。
+ */
+import type { NotationLang } from "./words";
+
+/** `^[^…]+$` の形の決まりが書けないとする字。`space` は空白 (`\s`) */
+export interface Forbidden {
+  space: boolean;
+  chars: string[];
+}
+
+/** 書けない組み合わせ (`not`) の欄と、その欄を書ける時の `kind` の値 */
+export interface Allowed {
+  field: string;
+  kind: string;
+}
+
+export interface FieldMessages {
+  additionalProperties: (key: string) => string;
+  required: (key: string) => string;
+  enum: (values: readonly string[]) => string;
+  type: (type: string) => string;
+  minLength: (limit: number) => string;
+  /** 書けない字を読めない形の決まりでは `undefined` */
+  pattern: (forbidden: Forbidden | undefined) => string;
+  minItems: (limit: number) => string;
+  minimum: (limit: number) => string;
+  const: (value: string) => string;
+  /** どの欄の組み合わせか判らない場所では `undefined` */
+  not: (allowed: Allowed | undefined) => string;
+  /** 選べる決まりがどれも欄が足りない時の、足りない欄。それ以外の時は空 */
+  anyOf: (fields: readonly string[]) => string;
+  oneOf: string;
+  discriminator: (tag: string, values: readonly string[]) => string;
+  /** 道具より新しい版の図 */
+  newer: (version: number, tool: number) => string;
+}
+
+const TYPES_JA: Record<string, string> = {
+  string: "文字列にする",
+  integer: "整数にする",
+  number: "数にする",
+  object: "オブジェクトにする",
+  array: "配列にする",
+  boolean: "true か false にする",
+  null: "null にする",
+};
+
+const TYPES_EN: Record<string, string> = {
+  string: "Use a string",
+  integer: "Use an integer",
+  number: "Use a number",
+  object: "Use an object",
+  array: "Use an array",
+  boolean: "Use true or false",
+  null: "Use null",
+};
+
+const plural = (count: number, word: string): string => `${count} ${word}${count === 1 ? "" : "s"}`;
+
+const ja: FieldMessages = {
+  additionalProperties: (key) => `${key} という欄は書けない`,
+  required: (key) => `${key} の欄が要る`,
+  enum: (values) => `${values.join(" / ")} のどれかにする`,
+  type: (type) => TYPES_JA[type] ?? `${type} にする`,
+  minLength: (limit) => `${limit} 字以上書く`,
+  pattern: (forbidden) =>
+    forbidden ? `${forbidden.space ? "空白と " : ""}${forbidden.chars.join(" ")} は使えない` : "使えない字が入っている",
+  minItems: (limit) => `${limit} つ以上書く`,
+  minimum: (limit) => `${limit} 以上にする`,
+  const: (value) => `${value} にする`,
+  not: (allowed) => (allowed ? `${allowed.field} の欄は kind が ${allowed.kind} の時だけ書ける` : "この欄の組み合わせは書けない"),
+  anyOf: (fields) =>
+    fields.length > 0 ? `${fields.join(" か ")} の${fields.length === 2 ? "どちらか" : "どれか"}の欄が要る` : "書ける形のどれにも合わない",
+  oneOf: "書ける形のどれか 1 つだけに合わせる",
+  discriminator: (tag, values) => `${tag} は ${values.join(" / ")} のどれかにする`,
+  newer: (version, tool) => `版 ${version} の図は、この道具 (版 ${tool}) より新しいので読めない。道具を新しくする`,
+};
+
+const en: FieldMessages = {
+  additionalProperties: (key) => `The ${key} field is not allowed`,
+  required: (key) => `The ${key} field is required`,
+  enum: (values) => `Use one of ${values.join(" / ")}`,
+  type: (type) => TYPES_EN[type] ?? `Use ${type}`,
+  minLength: (limit) => `Write at least ${plural(limit, "character")}`,
+  pattern: (forbidden) =>
+    forbidden
+      ? `Cannot contain ${forbidden.space ? "spaces or " : ""}${forbidden.chars.join(" ")}`
+      : "Contains characters that are not allowed",
+  minItems: (limit) => `Write at least ${plural(limit, "item")}`,
+  minimum: (limit) => `Use ${limit} or greater`,
+  const: (value) => `Use ${value}`,
+  not: (allowed) => (allowed ? `The ${allowed.field} field is allowed only when kind is ${allowed.kind}` : "This combination of fields is not allowed"),
+  anyOf: (fields) => (fields.length > 0 ? `Write one of the ${fields.join(" or ")} fields` : "Does not match any of the allowed shapes"),
+  oneOf: "Match exactly one of the allowed shapes",
+  discriminator: (tag, values) => `${tag} is one of ${values.join(" / ")}`,
+  newer: (version, tool) => `Version ${version} diagrams are newer than this tool (version ${tool}) and cannot be read. Update the tool`,
+};
+
+export const FIELD_MESSAGES: Record<NotationLang, FieldMessages> = { ja, en };

package/src/figure-text.ts

@@ -0,0 +1,42 @@
+/**
+ * 描く部品が出す字 (#3001)。
+ *
+ * 図の原本は語を持たないので、呼ぶ側が言葉を渡す。渡さなければ日本語で出す。
+ * 頁は頁の言葉を、`dragon export` は記法の file の言葉 (`--lang` を渡せばその言葉) を渡す。
+ */
+import type { NotationLang } from "./words";
+
+export interface FigureText {
+  /** 描けない時の断りの文。`detail` は誤りの場所と文を並べた物 */
+  cannotDraw: (detail: string) => string;
+  /** 寄って動かす見せ方の、隅の全体図の札 */
+  overview: string;
+  /** 再生の釦の読み上げの名前 */
+  prev: string;
+  pause: string;
+  play: string;
+  next: string;
+  /** 段の一覧の読み上げの名前 */
+  steps: (title: string) => string;
+}
+
+export const FIGURE_TEXT: Record<NotationLang, FigureText> = {
+  ja: {
+    cannotDraw: (detail) => `図を描けない: ${detail}`,
+    overview: "全体図",
+    prev: "前の段",
+    pause: "止める",
+    play: "動かす",
+    next: "次の段",
+    steps: (title) => `${title} の段`,
+  },
+  en: {
+    cannotDraw: (detail) => `Cannot draw the diagram: ${detail}`,
+    overview: "Overview",
+    prev: "Previous step",
+    pause: "Pause",
+    play: "Play",
+    next: "Next step",
+    steps: (title) => `Steps of ${title}`,
+  },
+};

package/src/index.ts

@@ -1,287 +1,34 @@
 /**
- * Dragon — Text DSL public API
+ * dragon の入口。
  *
- * Mermaid 感覚で animated SVG を生成する Text DSL。 cdl engine を呼出して CdlDiagram を返す。
- *
- * 使い方:
- *   const diagram = textDslToDiagram(source);
- *   // diagram は @cardenelabs/cdl の CdlDiagram、 そのまま CdlDiagramView 等に渡せる
- */
-
-export { parseTextDsl } from "./parser";
-export { compileToCdl } from "./compile";
-export type { CompileNotice } from "./compile";
-/**
- * 組み立てた図の型 (#1415)。
- *
- * `textDslToDiagram` が返す型そのもので、実体は `@cardenelabs/cdl` が持つ。 使う側が
- * 戻り値に型を付けるには必ず要るので、ここから引けるようにする。
- *
- * 再 export が無い間、使う側は `@cardenelabs/cdl` を直接の依存に足す必要があった。
- * 足さずに書くと **型が暗黙の `any` に落ち、その先の `.map((n) => ...)` まで検査が効かなく
- * なる** (実測 = この 1 件が 39 件の暗黙 `any` を生んでいた)。
+ * 図の原本は JSON で、人は 1 行が 1 本の線になる記法で書く。記法と JSON は行き来でき、
+ * JSON は JSON Schema 1 本で検査する。原本から図を描き、頁に置いて段ごとに動かす。
+ * 頁に字を読み込むのは別の入口 `@cardenelabs/dragon/fonts`。
  */
-export type { CdlDiagram } from "@cardenelabs/cdl";
-export { parseTextDslV05 } from "./v05";
-// 記法一覧が「実際に受け付ける値」 を実装から引くための公開。 手書きすると説明と実装がずれる。
-export {
-  DRAW_TARGETS,
-  DRAW_WORDS,
-  PHASE_ITEM_WORDS,
-  PRESET_TYPES,
-  TOP_LEVEL_KEYS,
-  TYPE_ALIASES,
-} from "./v05/parser";
-// 行頭の印の語 (#2782)。 見本がどの語を使っているかを数える検査が、一覧を実装から引く
-export { 行頭の語 } from "./compile/row-marks";
-export {
-  TONE_ALIAS,
-  NODE_KIND_ALIAS,
-  DIRECTION_ALIAS,
-  ORDERS,
-  ORDER_ALIAS,
-  SHAPES,
-  SWIMLANE_SHAPES,
-  DIAGRAM_SHAPES,
-  ALL_DIAGRAM_SHAPES,
-  THEMES,
-  THEME_ALIAS,
-  resolveTheme,
-  LEGEND_MARK_ALIAS,
-  resolveLegendMark,
-  意匠の字の測り方,
-  意匠の円の区画の間,
-  棒を描く節か,
-  意匠の棒の角,
-} from "./keywords";
-export type { DslTheme, DslShape, DslSwimlaneShape, DslDiagramShape } 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 type { DiagramBoundingBox } from "./canvas-bounds";
-// 位置を相対で書くための解決。 組み立て側と画面側の両方が同じ規則を使うために公開する。
-export {
-  parseRelativePos,
-  resolveRelativePos,
-  orderByDependency,
-  RELATIVE_GAP_DEFAULT,
-} from "./relative-pos";
-export type { RelativePos, RelativeDirection, AnchorBox } from "./relative-pos";
-// 光らせる相手の書き方の読み取り。 図種ごとの解決経路が同じ規則を共有する。
-export { parseFocusEntry } from "./focus";
-export type { FocusEntry } from "./focus";
-// 画面で見えている座標を記法に落とすための書込み。 記法を知る側に置く。
-export { writeActorPosition } from "./write-position";
-// 図の上での位置を測る。 editor が現在位置を出すのと、 相対指定を解くので同じ規則を使う。
-export { measureActorBoxes } from "./compile";
-// 本文に書いた部品の状態の上書きと色番号を、部品の図へ当てる。 編集画面が重ねて描く部品にも
-// 組み立て側と同じ値を使う (#1973)
-export { 部品に上書きを当てる } from "./compile";
-// 測るためだけの配置が受け取った、描かれない図についての知らせの数 (#2312)。 読み込み時の
-// 知らせを 0 行で固定する検査が、母数として読む (0 件なら測る経路を通っていない)
-export { 測るために受け取った知らせの数 } from "./compile";
-// パーツの見た目の大きさと、 位置を書かなかった時の格子。 画面側と組み立て側で同じ規則を使う。
-// 記法が受理する種類の全体。 画面側が「本文が見本を使っているか」 を判定するのに使う (#1022)。
-export { NODE_KIND_VALID } from "./v05/parser";
-
-// パーツの大きさを測る 3 つ。 用途で使い分ける (取り違えると経路ごとに絵が変わる)。
-//
-// - `partRenderSize` = 図枠。 画面が描く大きさと、 格子が確保する場所に使う
-// - `partBoxInFrame` = 図枠の中の箱 (パーツ自身の座標)。 画面が書いた座標と相対指定を解くのに使う
-// - `partVisualSize` = 箱の外接矩形 (merge の座標)。 組み立て側が取り込んだ後の大きさに使う
-//
-// 格子だけ図枠なのは、 隣と重ならない幅を確保するのが目的で描く大きさそのものが要るため。
-// 座標と間隔は見えている箱で測る (#937 / #1014)。
-// `大きさ:` の倍率は `partTargetScale` が持つ。 画面側も同じ規則で拡大しないと、
-// 書いた見本だけ経路で大きさが変わる (#1018)。
-// `partDrawsInDiagram` = その見本が図の中に描かれる部品を持つか。 実体が操作パネルの
-// 部品だけの見本 (catalog 80 件中 17 件) は重ねても図に出ないため、画面側が知らせる (#1017)。
-// `倍率:` (`scale`) は図形の倍率として予約する (#1026)。 画面と組み立てで意味が違うと、
-// 同じ本文が経路で別の絵になる。 正規化 (`normalizePartScale`) と `大きさ:` との掛け合わせ
-// (`partTargetSize`) を engine 側に置き、画面側も同じ関数を呼ぶ。
+export { extractDiagrams, type Fence } from "./markdown";
+export { type LineError, type ParseOptions, type Parsed, parseNotation } from "./parser";
+export { type PrintOptions, printNotation } from "./printer";
+export { type NotationLang, notationLanguage } from "./words";
 export {
-  partRenderSize,
-  partVisualSize,
-  partBoxInFrame,
-  partTargetScale,
-  partTargetSize,
-  partScaleFactor,
-  normalizePartScale,
-  MAX_PART_SCALE,
-  partDrawsInDiagram,
-  partIsMeasurable,
-  partsBaseBottom,
-  partsGridCenters,
-} from "./compile";
-// 色として読めるかの判定と、 図の外を指す値かの判定。 状態の上書きを受け取る側 / 画面が色欄を
-// 作る側 / 画面が背景色を直接書く側で同じ物差しを使う (別々に持つと、 片方だけ直した時に片方が通す)。
-export { isColorValue, pointsOutside, stripExternalPaint } from "./color";
-// 引用符の外し方 (#1028)。 画面側が本文から見本を抜く時に同じ判定を使う。
-// 別々に持つと、片方だけが読める本文ができる (実測 = `位置: '300,200"` が
-// 画面側では座標 300 として通り、組み立て側では読めない値として知らせが出た)
-export { stripQuotes } from "./v05/parser";
-
-// 画面で色分けするための分解器 (#1310)。 色は持たず、種類名と位置だけを返す
-export { 記法を分解する, JSONを分解する, 区間に広げる } from "./tokenize";
-export type { トークン, トークンの種類 } from "./tokenize";
-// 大きすぎる入力を組み立てる前に止める上限 (#1005)。 画面側も同じ物差しで事前に知らせられるよう公開する。
-export {
-  MAX_INPUT_ELEMENTS,
-  MAX_INPUT_BYTES,
-  countDocElements,
-  countDiagramElements,
-  countBytes,
-  describeOversize,
-  describeOversizeSource,
-} from "./input-size";
-export type { InputSize } from "./input-size";
-
-// LLM 向け JSON DSL (Issue #208)
-export { jsonToDiagram, validateDragonJson } from "./json-parser";
-// JSON / YAML の本文で書いた場所を指す鍵 (#2117)。 表を作る側 (画面の YAML 欄) と引く側
-// (`json-parser.ts`) が同じ規則を使うために公開する
-export { 書いた場所の鍵 } from "./json-line-map";
-export type { 書いた行の表 } from "./json-line-map";
-export { diagramJsonSchema } from "./schema";
-export type {
-  DragonJson,
-  JsonActor,
-  JsonAxes,
-  JsonStep,
-  JsonPhase,
-  JsonDslError,
-} from "./json-parser";
-export type {
-  DslDocument,
-  DslActor,
-  DslStep,
-  DslAnimate,
-  DslState,
-  DslPhase,
-  DslTween,
-  DslSet,
-  // `DslDocument.values` を触る利用者が型を import できるようにする (#1169)。
-  // 兄弟の `DslState` / `DslTween` / `DslSet` は公開されており、これだけ漏れていた
-  DslValue,
-  DslError,
-  PresetType,
-  DslLane,
-  DslGroup,
-  DslViewport,
-  // CAR-1693 Phase 1: canvas pivot DSL 表面 pos + layout mode の public 型
-  LayoutPos,
-  LayoutMode,
-} from "./types";
-
-import { parseTextDsl } from "./parser";
-import { parseTextDslV05 } from "./v05";
-import { compileToCdl } from "./compile";
-import { describeOversizeSource } from "./input-size";
-import type { CompileNotice } from "./compile";
-import type { CdlDiagram } from "@cardenelabs/cdl";
-
-/**
- * CAR-1657 = compile 時 parts identifier lookup 用 catalog。
- * caller (CdlEditor 等) が loadPartsItems() の結果を Record<partId, CdlDiagram> で inject。
- * 未渡し時 partId set actor は「未解決」 として skip + console.warn (diagram render は継続)。
- */
-export interface CompileOpts {
-  partsCatalog?: Record<string, CdlDiagram>;
-  /**
-   * 図は出せるが書いた通りにならなかったことの受け取り口 (`位置: Web の下` が順序図で
-   * 効かない等)。 判定は組み立て側が持ち、 呼出側は受け取って表示するだけにする。
-   */
-  onNotice?: (notice: CompileNotice) => void;
-  /**
-   * edge が DSL のどの行から来たかの受け取り口 (#998)。
-   *
-   * preset によっては書いた step と生成される edge が一致しない (`type: flow` は actor を鎖状に
-   * 繋ぐため `a -> c` と書いても `a -> b` になる)。 edge を起点に本文の行を直す機能 (自動修正の
-   * 書き戻し等) は、 この対応が無いと別の行を書き換える。
-   *
-   * **対応が取れない edge については呼ばれない**。 「対応が無い」 と「行 0」 を区別するため。
-   */
-  onEdgeSource?: (edgeId: string, line: number) => void;
-}
-
-/**
- * Dragon DSL から CdlDiagram に一発変換。 v0.5 (英語 keyword) / v0.4 (日本語 keyword) を auto-detect。
- *
- * 判定 ... src 内に v0.5 専用 syntax (`animation:` block / `- A -> B` flow / `step: "..."` ) を含むなら v0.5、
- * 含まなければ v0.4 (deprecated、 console.warn を出す)。
- *
- * エラー時は throw、 詳細を取りたい場合は parseTextDslV05 / parseTextDsl を直接呼ぶ。
- * opts.partsCatalog を渡すと CAR-1657 parts kind (arc-gauge 等) の actor が merge 展開される。
- */
-export function textDslToDiagram(src: string, opts?: CompileOpts): CdlDiagram {
-  // 読み取る前に大きさを見る (#1005)。 要素数の上限は読み取った後にしか分からないため、
-  // 巨大な本文そのものによる待ちと記憶の消費はここでしか防げない
-  const oversize = describeOversizeSource(src);
-  if (oversize) throw new Error(oversize);
-
-  if (isV05Source(src)) {
-    const r = parseTextDslV05(src);
-    if (!r.ok) {
-      const msg = r.errors
-        .map((e) => `  L${e.line}: ${e.message}${e.hint ? `\n         hint: ${e.hint}` : ""}`)
-        .join("\n");
-      throw new Error(`Dragon DSL v0.5 parse error:\n${msg}`);
-    }
-    return compileToCdl(r.doc, opts);
-  }
-  // v0.4 fallback (deprecated)
-  if (typeof console !== "undefined" && console.warn) {
-    console.warn(
-      "[dragon] v0.4 syntax (Japanese keywords) is deprecated. Please migrate to v0.5 (English keywords) by 2026-12-31.",
-    );
-  }
-  const r = parseTextDsl(src);
-  if (!r.ok) {
-    const msg = r.errors
-      .map((e) => `  L${e.line}: ${e.message}${e.hint ? `\n         ヒント: ${e.hint}` : ""}`)
-      .join("\n");
-    throw new Error(`Dragon DSL parse error:\n${msg}`);
-  }
-  return compileToCdl(r.doc, opts);
-}
-
-function isV05Source(src: string): boolean {
-  // 既定は v0.5 で、v0.4 の目印を 1 つでも見つけた時だけ v0.4 として読む (CAR-1657)。
-  // v0.4 は 2026-12-31 に廃止予定なので、新しく書かれた本文は v0.5 として扱うのが当たりやすい。
-  //
-  // 目印に見出しの名前だけを使うと足りない = v0.4 も英語の別名 (`animate:` / `animation:`) を受けるため。
-  // v0.4 にしかない書き方 (`step "..." Xs` = コロンの無い段、`^\d+\.\s+` = 番号付きの流れ) も目印に足す。
-  const V04_KEYWORDS = [
-    // 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/,
-    // v0.4 numbered flow (`1. A → B`、 v0.5 は `- A -> B`)
-    /^\s*\d+\.\s+\S+\s*(?:→|->)\s*\S+/,
-  ];
-  const lines = src.split("\n");
-  for (const ln of lines) {
-    for (const kw of V04_KEYWORDS) {
-      if (kw.test(ln)) return false; // v0.4 detected → false
-    }
-  }
-  return true; // no v0.4 marker → v0.5 default
-}
+  type Box,
+  type Carry,
+  type Checked,
+  type CheckOptions,
+  type Color,
+  type Diagram,
+  type DiagramEvent,
+  type FieldError,
+  type LabelSide,
+  type Region,
+  type Step,
+  validateDiagram,
+  type ViewMode,
+} from "./schema";
+export { FORMAT_VERSION, type Migrated, migrateFile, type Read, readDiagram } from "./version";
+export type { Layout } from "./layout/scene";
+export { FONTS } from "./look/fonts";
+export { DEFAULT_PALETTE, type Palette, PALETTES, resolvePalette, type Theme } from "./look/values";
+export { mountDiagram, type Player } from "./player";
+export { type Rendered, type RenderOptions, renderDiagram } from "./render/svg";
+export type { Timeline } from "./timeline";
+export { chooseView } from "./view";