@cardenelabs/dragon 0.36.3 → 0.37.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { N as NotationLang, D as Diagram, F as FieldError, C as CheckOptions, a as ColorKey, b as Carry, T as Theme, V as ViewMode } from './schema-9VLameDG.cjs';
-export { B as Box, c as Checked, d as Color, e as DEFAULT_PALETTE, f as DiagramEvent, L as LabelSide, P as PALETTES, g as Palette, R as READABLE_PX, h as Region, S as Step, r as resolvePalette, v as validateDiagram } from './schema-9VLameDG.cjs';
+import { N as NotationLang, D as Diagram, F as FieldError, C as CheckOptions, a as ColorKey, b as Carry, T as Theme, V as ViewMode } from './schema-B2MTRv66.cjs';
+export { B as Box, c as Checked, d as Color, e as DEFAULT_PALETTE, f as DiagramEvent, L as LabelSide, P as PALETTES, g as Palette, R as READABLE_PX, h as Region, S as StatePath, i as Step, r as resolvePalette, v as validateDiagram } from './schema-B2MTRv66.cjs';
 
 /**
  * 図が使う 2 つの字。どちらも package の依存として同梱する。
@@ -52,6 +52,7 @@ declare function parseNotation(notation: string, options?: ParseOptions): Parsed
  * 並べ方は決まった形に整える。JSON の欄の並び順は見ず、欄の名前で読むので、
  * 同じ内容の JSON からは毎回同じ文字列になる。書き手の行の並べ方とコメントは保たない。
  * 段の中で起きることは JSON の並び順 (起きる順) のまま書く。
+ * 状態遷移図の移れる道 (`state.paths`) は、帯の宣言の後、最初の `step` より前に JSON の並びのまま書く (#3163)。
  *
  * `"` で囲むのは要る時だけにする。`[` を含む名前と、`,` か `]` を含む属性の値と、`"` で始まる字を囲む。
  * 箱は JSON の並びのまま書き、同じ区画の箱が続く所を 1 つの `group … end` にする。
@@ -100,6 +101,8 @@ interface SceneBox extends Rect {
     color: ColorKey;
     cx: number;
     cy: number;
+    /** 状態遷移図で、どの段も辿り着かない状態。点線の箱で脇道の囲みに描く */
+    ghost?: boolean;
 }
 interface SceneRegion extends Rect {
     id: string;
@@ -130,6 +133,34 @@ interface SceneLabel extends Rect {
     family: Family;
     color: ColorKey;
 }
+/** 状態遷移図の、最初の段より前に書いてどの段にも出ない線。点線で描き、運ぶ物を走らせない */
+interface ScenePath {
+    from: string;
+    to: string;
+    points: Point[];
+    label?: Rect & {
+        text: string;
+        family: Family;
+    };
+}
+/** 状態遷移図の始まりと終わりの印。`ghost` は脇道の中の終わりの印 */
+interface SceneEnd {
+    kind: "start" | "finish";
+    x: number;
+    y: number;
+    r: number;
+    ghost: boolean;
+    /** 印の右に添える字 */
+    text: string;
+    /** 終わりの印へ線を引く状態 */
+    box?: string;
+}
+/** 状態遷移図の脇道の囲み。`title` と `notes` は囲みの左上に置く字 */
+interface SceneSide extends Rect {
+    title: string;
+    /** 囲みの名前の下に 1 行ずつ置く添え書き */
+    notes: string[];
+}
 /** 時系列図の箱の中の処理。生存線の上に札で出す。 */
 interface SceneAction extends Rect {
     step: number;
@@ -156,9 +187,21 @@ interface SceneField {
     y: number;
     w: number;
 }
+/** 状態遷移図の帯の最後の欄。段が辿り着く順に状態を点で並べ、着いた状態を塗る (#3171) */
+interface SceneTrail {
+    title: string;
+    states: {
+        box: string;
+        color: ColorKey;
+    }[];
+    x: number;
+    y: number;
+    w: number;
+}
 interface SceneStrip extends Rect {
     title: string;
     fields: SceneField[];
+    trail?: SceneTrail;
 }
 interface Layout {
     kind: Diagram["kind"];
@@ -172,6 +215,12 @@ interface Layout {
     actions: SceneAction[];
     badges: SceneBadge[];
     strip?: SceneStrip;
+    /** 状態遷移図の通らない道。他の図の種類では空 */
+    paths: ScenePath[];
+    /** 状態遷移図の始まりと終わりの印。他の図の種類では空 */
+    ends: SceneEnd[];
+    /** 状態遷移図の脇道の囲み。通らない状態が無ければ無い */
+    side?: SceneSide;
 }
 
 /** 秒で表した、見えている間。`end` の時刻は含まない。 */
@@ -196,6 +245,8 @@ interface CarrierTime extends Span {
 interface LabelTime extends Span {
     step: number;
     event: number;
+    /** 状態遷移図だけが持つ。段が終わった後に薄く残す間 */
+    after?: Span;
 }
 /** 処理、箱の字の書き換え、中身の帯の値が起きる時刻。 */
 interface EventTime {
@@ -203,6 +254,12 @@ interface EventTime {
     event: number;
     at: number;
 }
+/** 状態遷移図の状態ごとの、光っている間と、済んだ印が出る時刻。運ぶ物が出ていない状態は `done` を持たない */
+interface StateTime {
+    box: string;
+    lit: Span[];
+    done?: number;
+}
 interface Timeline {
     /** 1 周の長さ */
     total: number;
@@ -219,6 +276,8 @@ interface Timeline {
     events: EventTime[];
     /** 段ごとの止め絵の時刻。その段で起きることが全部見えている */
     stills: number[];
+    /** 状態遷移図だけが持つ */
+    states?: StateTime[];
 }
 
 interface RenderOptions {
@@ -267,9 +326,24 @@ interface Player {
 }
 declare function mountDiagram(host: HTMLElement, diagram: unknown, options?: PlayerOptions): Player;
 
+/**
+ * 箱と区画の印の形。どれも (0, 0) を中心に 20 四方へ収める。
+ *
+ * 見本帳 (`docs/design/base/engine.js` の `G`) と同じ形を持つ。`block` だけは見本帳が絵を手で描いていたので、ここで足した。
+ * `undo` (戻る矢印) と `yen` (円の印) は、注文の試作 (`docs/design/base/scenes/order.js`) が返品と返金に足した形 (#3171)。
+ * package の入口からも出し、見本帳の部品「絵」の頁がこの表から使える絵柄の一覧を作る。1 つずつの絵は `iconSvg` が描く (#3172)。
+ */
+declare const ICONS: Readonly<Record<string, string>>;
+
+/**
+ * 絵柄を 1 つだけ描いた SVG (#3172)。見本帳の部品「絵」の頁が、使える絵柄を並べる時に使う。
+ * 線の太さは箱の印と同じ割合 (印の線の太さ × 印の縮み) で、色は置いた所の字の色 (`currentColor`) を使う。知らない名前は `undefined`
+ */
+declare function iconSvg(name: string): string | undefined;
+
 declare function chooseView(rendered: Pick<Rendered, "layout" | "view">, frameWidth: number, frameHeight?: number): {
     mode: ViewMode;
     textPx: number;
 };
 
-export { type CarrierTime, Carry, CheckOptions, ColorKey, Diagram, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, FieldError, type LabelTime, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, type Read, type Rect, type RenderOptions, type Rendered, type SceneAction, type SceneBadge, type SceneBox, type SceneEdge, type SceneField, type SceneLabel, type SceneLifeline, type SceneRegion, type SceneStrip, type Span, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };
+export { type CarrierTime, Carry, CheckOptions, ColorKey, Diagram, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, FieldError, ICONS, type LabelTime, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, type Read, type Rect, type RenderOptions, type Rendered, type SceneAction, type SceneBadge, type SceneBox, type SceneEdge, type SceneEnd, type SceneField, type SceneLabel, type SceneLifeline, type ScenePath, type SceneRegion, type SceneSide, type SceneStrip, type SceneTrail, type Span, type StateTime, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, iconSvg, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { N as NotationLang, D as Diagram, F as FieldError, C as CheckOptions, a as ColorKey, b as Carry, T as Theme, V as ViewMode } from './schema-9VLameDG.js';
-export { B as Box, c as Checked, d as Color, e as DEFAULT_PALETTE, f as DiagramEvent, L as LabelSide, P as PALETTES, g as Palette, R as READABLE_PX, h as Region, S as Step, r as resolvePalette, v as validateDiagram } from './schema-9VLameDG.js';
+import { N as NotationLang, D as Diagram, F as FieldError, C as CheckOptions, a as ColorKey, b as Carry, T as Theme, V as ViewMode } from './schema-B2MTRv66.js';
+export { B as Box, c as Checked, d as Color, e as DEFAULT_PALETTE, f as DiagramEvent, L as LabelSide, P as PALETTES, g as Palette, R as READABLE_PX, h as Region, S as StatePath, i as Step, r as resolvePalette, v as validateDiagram } from './schema-B2MTRv66.js';
 
 /**
  * 図が使う 2 つの字。どちらも package の依存として同梱する。
@@ -52,6 +52,7 @@ declare function parseNotation(notation: string, options?: ParseOptions): Parsed
  * 並べ方は決まった形に整える。JSON の欄の並び順は見ず、欄の名前で読むので、
  * 同じ内容の JSON からは毎回同じ文字列になる。書き手の行の並べ方とコメントは保たない。
  * 段の中で起きることは JSON の並び順 (起きる順) のまま書く。
+ * 状態遷移図の移れる道 (`state.paths`) は、帯の宣言の後、最初の `step` より前に JSON の並びのまま書く (#3163)。
  *
  * `"` で囲むのは要る時だけにする。`[` を含む名前と、`,` か `]` を含む属性の値と、`"` で始まる字を囲む。
  * 箱は JSON の並びのまま書き、同じ区画の箱が続く所を 1 つの `group … end` にする。
@@ -100,6 +101,8 @@ interface SceneBox extends Rect {
     color: ColorKey;
     cx: number;
     cy: number;
+    /** 状態遷移図で、どの段も辿り着かない状態。点線の箱で脇道の囲みに描く */
+    ghost?: boolean;
 }
 interface SceneRegion extends Rect {
     id: string;
@@ -130,6 +133,34 @@ interface SceneLabel extends Rect {
     family: Family;
     color: ColorKey;
 }
+/** 状態遷移図の、最初の段より前に書いてどの段にも出ない線。点線で描き、運ぶ物を走らせない */
+interface ScenePath {
+    from: string;
+    to: string;
+    points: Point[];
+    label?: Rect & {
+        text: string;
+        family: Family;
+    };
+}
+/** 状態遷移図の始まりと終わりの印。`ghost` は脇道の中の終わりの印 */
+interface SceneEnd {
+    kind: "start" | "finish";
+    x: number;
+    y: number;
+    r: number;
+    ghost: boolean;
+    /** 印の右に添える字 */
+    text: string;
+    /** 終わりの印へ線を引く状態 */
+    box?: string;
+}
+/** 状態遷移図の脇道の囲み。`title` と `notes` は囲みの左上に置く字 */
+interface SceneSide extends Rect {
+    title: string;
+    /** 囲みの名前の下に 1 行ずつ置く添え書き */
+    notes: string[];
+}
 /** 時系列図の箱の中の処理。生存線の上に札で出す。 */
 interface SceneAction extends Rect {
     step: number;
@@ -156,9 +187,21 @@ interface SceneField {
     y: number;
     w: number;
 }
+/** 状態遷移図の帯の最後の欄。段が辿り着く順に状態を点で並べ、着いた状態を塗る (#3171) */
+interface SceneTrail {
+    title: string;
+    states: {
+        box: string;
+        color: ColorKey;
+    }[];
+    x: number;
+    y: number;
+    w: number;
+}
 interface SceneStrip extends Rect {
     title: string;
     fields: SceneField[];
+    trail?: SceneTrail;
 }
 interface Layout {
     kind: Diagram["kind"];
@@ -172,6 +215,12 @@ interface Layout {
     actions: SceneAction[];
     badges: SceneBadge[];
     strip?: SceneStrip;
+    /** 状態遷移図の通らない道。他の図の種類では空 */
+    paths: ScenePath[];
+    /** 状態遷移図の始まりと終わりの印。他の図の種類では空 */
+    ends: SceneEnd[];
+    /** 状態遷移図の脇道の囲み。通らない状態が無ければ無い */
+    side?: SceneSide;
 }
 
 /** 秒で表した、見えている間。`end` の時刻は含まない。 */
@@ -196,6 +245,8 @@ interface CarrierTime extends Span {
 interface LabelTime extends Span {
     step: number;
     event: number;
+    /** 状態遷移図だけが持つ。段が終わった後に薄く残す間 */
+    after?: Span;
 }
 /** 処理、箱の字の書き換え、中身の帯の値が起きる時刻。 */
 interface EventTime {
@@ -203,6 +254,12 @@ interface EventTime {
     event: number;
     at: number;
 }
+/** 状態遷移図の状態ごとの、光っている間と、済んだ印が出る時刻。運ぶ物が出ていない状態は `done` を持たない */
+interface StateTime {
+    box: string;
+    lit: Span[];
+    done?: number;
+}
 interface Timeline {
     /** 1 周の長さ */
     total: number;
@@ -219,6 +276,8 @@ interface Timeline {
     events: EventTime[];
     /** 段ごとの止め絵の時刻。その段で起きることが全部見えている */
     stills: number[];
+    /** 状態遷移図だけが持つ */
+    states?: StateTime[];
 }
 
 interface RenderOptions {
@@ -267,9 +326,24 @@ interface Player {
 }
 declare function mountDiagram(host: HTMLElement, diagram: unknown, options?: PlayerOptions): Player;
 
+/**
+ * 箱と区画の印の形。どれも (0, 0) を中心に 20 四方へ収める。
+ *
+ * 見本帳 (`docs/design/base/engine.js` の `G`) と同じ形を持つ。`block` だけは見本帳が絵を手で描いていたので、ここで足した。
+ * `undo` (戻る矢印) と `yen` (円の印) は、注文の試作 (`docs/design/base/scenes/order.js`) が返品と返金に足した形 (#3171)。
+ * package の入口からも出し、見本帳の部品「絵」の頁がこの表から使える絵柄の一覧を作る。1 つずつの絵は `iconSvg` が描く (#3172)。
+ */
+declare const ICONS: Readonly<Record<string, string>>;
+
+/**
+ * 絵柄を 1 つだけ描いた SVG (#3172)。見本帳の部品「絵」の頁が、使える絵柄を並べる時に使う。
+ * 線の太さは箱の印と同じ割合 (印の線の太さ × 印の縮み) で、色は置いた所の字の色 (`currentColor`) を使う。知らない名前は `undefined`
+ */
+declare function iconSvg(name: string): string | undefined;
+
 declare function chooseView(rendered: Pick<Rendered, "layout" | "view">, frameWidth: number, frameHeight?: number): {
     mode: ViewMode;
     textPx: number;
 };
 
-export { type CarrierTime, Carry, CheckOptions, ColorKey, Diagram, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, FieldError, type LabelTime, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, type Read, type Rect, type RenderOptions, type Rendered, type SceneAction, type SceneBadge, type SceneBox, type SceneEdge, type SceneField, type SceneLabel, type SceneLifeline, type SceneRegion, type SceneStrip, type Span, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };
+export { type CarrierTime, Carry, CheckOptions, ColorKey, Diagram, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, FieldError, ICONS, type LabelTime, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, type Read, type Rect, type RenderOptions, type Rendered, type SceneAction, type SceneBadge, type SceneBox, type SceneEdge, type SceneEnd, type SceneField, type SceneLabel, type SceneLifeline, type ScenePath, type SceneRegion, type SceneSide, type SceneStrip, type SceneTrail, type Span, type StateTime, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, iconSvg, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };