@cardenelabs/dragon 0.44.0 → 0.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +21 -0
  2. package/dist/cli.cjs +3603 -3541
  3. package/dist/cli.cjs.map +1 -1
  4. package/dist/cli.js +3603 -3541
  5. package/dist/cli.js.map +1 -1
  6. package/dist/export.cjs +3462 -3400
  7. package/dist/export.cjs.map +1 -1
  8. package/dist/export.js +3461 -3401
  9. package/dist/export.js.map +1 -1
  10. package/dist/index.cjs +12239 -12177
  11. package/dist/index.cjs.map +1 -1
  12. package/dist/index.js +12239 -12177
  13. package/dist/index.js.map +1 -1
  14. package/dist/light/chunk-6ZUKJ3VO.js +489 -0
  15. package/dist/light/chunk-6ZUKJ3VO.js.map +1 -0
  16. package/dist/light/chunk-CLS6JVKK.cjs +84 -0
  17. package/dist/light/chunk-CLS6JVKK.cjs.map +1 -0
  18. package/dist/light/chunk-JNSHZTPF.js +1141 -0
  19. package/dist/light/chunk-JNSHZTPF.js.map +1 -0
  20. package/dist/light/chunk-OUQ44P45.cjs +489 -0
  21. package/dist/light/chunk-OUQ44P45.cjs.map +1 -0
  22. package/dist/light/chunk-VRAW7VAQ.cjs +1141 -0
  23. package/dist/light/chunk-VRAW7VAQ.cjs.map +1 -0
  24. package/dist/light/chunk-YDKPEKGZ.js +84 -0
  25. package/dist/light/chunk-YDKPEKGZ.js.map +1 -0
  26. package/dist/light/git-C4RVNFT6.js +637 -0
  27. package/dist/light/git-C4RVNFT6.js.map +1 -0
  28. package/dist/light/git-I7D7RIW2.cjs +637 -0
  29. package/dist/light/git-I7D7RIW2.cjs.map +1 -0
  30. package/dist/light/index.cjs +9885 -0
  31. package/dist/light/index.cjs.map +1 -0
  32. package/dist/light/index.d.cts +976 -0
  33. package/dist/light/index.d.ts +976 -0
  34. package/dist/light/index.js +9885 -0
  35. package/dist/light/index.js.map +1 -0
  36. package/dist/light/lineup-FAIKTH3Y.cjs +283 -0
  37. package/dist/light/lineup-FAIKTH3Y.cjs.map +1 -0
  38. package/dist/light/lineup-YEG4HHEI.js +283 -0
  39. package/dist/light/lineup-YEG4HHEI.js.map +1 -0
  40. package/dist/light/state-P3LIVI3K.js +335 -0
  41. package/dist/light/state-P3LIVI3K.js.map +1 -0
  42. package/dist/light/state-ZZUK6AQT.cjs +335 -0
  43. package/dist/light/state-ZZUK6AQT.cjs.map +1 -0
  44. package/dist/light/time-64DJKYAL.cjs +719 -0
  45. package/dist/light/time-64DJKYAL.cjs.map +1 -0
  46. package/dist/light/time-B5WUQOFP.js +719 -0
  47. package/dist/light/time-B5WUQOFP.js.map +1 -0
  48. package/dist/light/tree-5HPREYW2.js +478 -0
  49. package/dist/light/tree-5HPREYW2.js.map +1 -0
  50. package/dist/light/tree-66EH4QVI.cjs +478 -0
  51. package/dist/light/tree-66EH4QVI.cjs.map +1 -0
  52. package/dist/player.global.js +3 -3
  53. package/package.json +14 -2
  54. package/src/api.ts +71 -0
  55. package/src/figure-text.ts +4 -0
  56. package/src/index.ts +6 -69
  57. package/src/kinds/all.ts +16 -0
  58. package/src/kinds/git.ts +3 -0
  59. package/src/kinds/lineup.ts +3 -0
  60. package/src/kinds/registry.ts +46 -0
  61. package/src/kinds/state.ts +2 -0
  62. package/src/kinds/time.ts +3 -0
  63. package/src/kinds/tree.ts +3 -0
  64. package/src/layout/git.ts +0 -1
  65. package/src/layout/lineup.ts +0 -1
  66. package/src/layout/time.ts +0 -1
  67. package/src/layout/tree.ts +0 -1
  68. package/src/light.ts +31 -0
  69. package/src/player-global.ts +3 -0
  70. package/src/player.ts +1 -1
  71. package/src/render/draw.ts +731 -0
  72. package/src/render/parts.ts +3 -0
  73. package/src/render/svg.ts +4 -725
  74. package/src/render/time.ts +1 -4
  75. package/src/view.ts +1 -1
@@ -0,0 +1,976 @@
1
+ type Color = "blue" | "amber" | "green" | "violet" | "rose" | "slate" | "coin";
2
+ interface Region {
3
+ id: string;
4
+ name: string;
5
+ note?: string;
6
+ color?: Color;
7
+ icon?: string;
8
+ }
9
+ interface Box {
10
+ id: string;
11
+ name: string;
12
+ sub?: string;
13
+ color?: Color;
14
+ icon?: string;
15
+ region?: string;
16
+ /** 飛び先。描いた図ではこの箱がここへの link になる。`/` で始まる path か、http:// か https:// で始まる URL (#3199) */
17
+ link?: string;
18
+ }
19
+ type Carry = {
20
+ kind: "envelope";
21
+ } | {
22
+ kind: "tag";
23
+ text: string;
24
+ } | {
25
+ kind: "coin";
26
+ } | {
27
+ kind: "none";
28
+ };
29
+ type LabelSide = "above" | "below" | "left" | "right";
30
+ /** 見せ方。`fixed` は全体を止めて中だけ動かし、`follow` は寄って動かし全体図で今どこかを示す。 */
31
+ type ViewMode = "fixed" | "follow";
32
+ type DiagramEvent = {
33
+ type: "edge";
34
+ from: string;
35
+ to: string;
36
+ label?: string;
37
+ carry: Carry;
38
+ labelSide?: LabelSide;
39
+ at?: number;
40
+ into?: number;
41
+ } | {
42
+ type: "action";
43
+ box: string;
44
+ label: string;
45
+ } | {
46
+ type: "swap";
47
+ box: string;
48
+ text: string;
49
+ color?: Color;
50
+ } | {
51
+ type: "strip";
52
+ field: string;
53
+ value?: string;
54
+ tag?: string;
55
+ } | GitCommit | {
56
+ type: "branch";
57
+ branch: string;
58
+ from: string;
59
+ } | {
60
+ type: "now";
61
+ to: number;
62
+ } | TimeMarkEvent | TimeSpanEvent | TreeLeaf | TreeNode | LineupOrder | {
63
+ type: "seal" | "open" | "pick";
64
+ box: string;
65
+ } | LineupStamp$1;
66
+ /** 時間軸の図 (#3165) の、印の列 `row` の `from` から `to` の目盛りの印の色を変える出来事 */
67
+ interface TimeMarkEvent {
68
+ type: "mark";
69
+ row: string;
70
+ from: number;
71
+ to: number;
72
+ color: Color;
73
+ }
74
+ /** 時間軸の図の、`from` から `to` の目盛りの括弧と字。`shape` が `box` なら印の列を囲み、字を縁の札にする */
75
+ interface TimeSpanEvent {
76
+ type: "span";
77
+ from: number;
78
+ to: number;
79
+ text: string;
80
+ shape?: "box";
81
+ color?: Color;
82
+ }
83
+ /** 時間軸の図の目盛り。`unit` の名前の目盛りを `length` の長さ (`12s` など) で `count` 個並べ、最初の目盛りの番号を `from` にする */
84
+ interface TimeScale {
85
+ unit: string;
86
+ length: string;
87
+ count: number;
88
+ from?: number;
89
+ }
90
+ /** 時間軸の図の区切り。目盛り `length` 個ごとに `name` の区切りを置き、最初の区切りの番号を `from` にする */
91
+ interface TimePeriod {
92
+ name: string;
93
+ length: number;
94
+ from?: number;
95
+ }
96
+ /** 時間軸の図の印の列。目盛りごとに印を 1 つ置き、`empty` の目盛りは空きの印にする */
97
+ interface TimeRow {
98
+ id: string;
99
+ name: string;
100
+ color?: Color;
101
+ empty?: number[];
102
+ }
103
+ /** 時間軸の図の節目。`at` の目盛りの印の下に旗の丸と名札を置く */
104
+ interface TimePoint {
105
+ id: string;
106
+ at: number;
107
+ }
108
+ /** 時間軸の図の種類の欄 */
109
+ interface TimeSpec {
110
+ scale: TimeScale;
111
+ period?: TimePeriod;
112
+ rows: TimeRow[];
113
+ points?: TimePoint[];
114
+ /** 拡大の帯に列を作る目盛りの範囲 */
115
+ zoom?: {
116
+ from: number;
117
+ to: number;
118
+ };
119
+ }
120
+ /** 中身の帯の物差しの欄。`line` の割合 (`2/3` か `97%`) の所に線を引く */
121
+ interface StripMeter {
122
+ field: string;
123
+ line: string;
124
+ }
125
+ /**
126
+ * 枝分かれの図 (#3164) の commit を積む出来事。積んだ枝の札と、その枝を指す HEAD が新しい commit へ進む。
127
+ * 当て直し (`copy`) は枝の札を動かさず、merge commit (`merge`) は取り込む枝の先端も親に持つ
128
+ */
129
+ interface GitCommit {
130
+ type: "commit";
131
+ id: string;
132
+ branch: string;
133
+ copy?: string;
134
+ merge?: string;
135
+ hash?: string;
136
+ note?: string;
137
+ }
138
+ /**
139
+ * 木の図 (#3233) の葉を出す出来事。書いた段で葉の箱が現れる。`hash` を書くと箱に値を出し、名札を葉の下の札に出す
140
+ */
141
+ interface TreeLeaf {
142
+ type: "leaf";
143
+ id: string;
144
+ hash?: string;
145
+ }
146
+ /** 木の図の、1 つ以上の子から親を組む出来事。書いた段で親の箱と、子から親への木の線が現れる */
147
+ interface TreeNode {
148
+ type: "node";
149
+ id: string;
150
+ children: string[];
151
+ hash?: string;
152
+ }
153
+ /** 列の図 (#3239) の、列 `box` の並びを `items` に書き換える出来事。前の段との差分を描く部品が滑る動きに変える */
154
+ interface LineupOrder {
155
+ type: "line";
156
+ box: string;
157
+ items: string[];
158
+ }
159
+ /** 列の図の、列 `box` の右に `text` の札を押す出来事 */
160
+ interface LineupStamp$1 {
161
+ type: "stamp";
162
+ box: string;
163
+ text: string;
164
+ }
165
+ /** 列の図のチップ。`color` を書かないチップは薄い色で、`label` を書かないチップは色だけで出す */
166
+ interface LineupItem {
167
+ id: string;
168
+ color?: Color;
169
+ label?: string;
170
+ }
171
+ /** 枝分かれの図の枝。上から宣言した順に帯を並べる */
172
+ interface GitBranch {
173
+ id: string;
174
+ note?: string;
175
+ }
176
+ /** 状態遷移図の、最初の段より前に書いた移れる道。`from` に `start`、`to` に `finish` を書ける */
177
+ interface StatePath {
178
+ from: string;
179
+ to: string;
180
+ label?: string;
181
+ }
182
+ /** 段の出典。読み上げの段の一覧に、名前を URL への link にして出す。URL の形は箱の飛び先と同じ (#3199) */
183
+ interface StepSource {
184
+ name: string;
185
+ url: string;
186
+ }
187
+ interface Step {
188
+ title: string;
189
+ body: string;
190
+ code?: string;
191
+ /** 書いた順の出典。書かない段は欄を持たない */
192
+ sources?: StepSource[];
193
+ events: DiagramEvent[];
194
+ }
195
+ interface Diagram {
196
+ version: number;
197
+ kind: "sequence" | "architecture" | "state" | "git" | "time" | "tree" | "lineup";
198
+ title: string;
199
+ view?: ViewMode;
200
+ regions?: Region[];
201
+ boxes: Box[];
202
+ strip?: {
203
+ title: string;
204
+ fields: string[];
205
+ meters?: StripMeter[];
206
+ };
207
+ steps: Step[];
208
+ sequence?: {
209
+ lifelines: string[];
210
+ };
211
+ state?: {
212
+ paths: StatePath[];
213
+ };
214
+ git?: {
215
+ branches: GitBranch[];
216
+ };
217
+ time?: TimeSpec;
218
+ lineup?: {
219
+ items: LineupItem[];
220
+ };
221
+ }
222
+ interface FieldError {
223
+ /** 誤った欄の場所 (JSON Pointer) */
224
+ pointer: string;
225
+ message: string;
226
+ }
227
+ type Checked = {
228
+ ok: true;
229
+ } | {
230
+ ok: false;
231
+ errors: FieldError[];
232
+ };
233
+ interface CheckOptions {
234
+ /** 誤りの文の言葉。渡さなければ日本語 */
235
+ lang?: NotationLang;
236
+ }
237
+ /** 原本の JSON を検査する。版が道具より新しいかは見ない (`readDiagram` が見る)。 */
238
+ declare function validateDiagram(input: unknown, options?: CheckOptions): Checked;
239
+
240
+ /**
241
+ * dragon記法の語 (#3137)。
242
+ *
243
+ * 行の種類は行の頭の英語の語で決まり、属性は `[<鍵>: <値>]` で書く。
244
+ * 語は英語だけで、原本の JSON が使う名前に揃え、記法と JSON で覚える語を 1 組にする。
245
+ *
246
+ * 言葉の型 (`NotationLang`) は、誤りの文と図の中の字の言葉を選ぶために持つ。
247
+ * 語が英語だけなので、記法の file から言葉は決めず、呼ぶ側が渡す。
248
+ *
249
+ * 型が欠けを止める。原本の JSON の値 (図の種類、運ぶ物、見せ方、名前の側) に語が無い時は、型の検査が落ちる。
250
+ */
251
+
252
+ type NotationLang = "ja" | "en";
253
+
254
+ /**
255
+ * 図が使う 2 つの字。どちらも package の依存として同梱する。
256
+ *
257
+ * 描いた SVG は字をこの 2 つの名前でしか名指さない。端末の字の名前を持たないので、
258
+ * 同梱した字が読み込まれていない時に、端末の字へ黙って落ちて幅が変わることが無い。
259
+ * 頁に字を読み込むのは `@cardenelabs/dragon/fonts` の入口 (`load-fonts.ts`) が持つ。
260
+ */
261
+ declare const FONTS: {
262
+ readonly sans: "Noto Sans JP Variable";
263
+ readonly mono: "JetBrains Mono Variable";
264
+ };
265
+ type Family = keyof typeof FONTS;
266
+
267
+ type Theme = "light" | "dark";
268
+ interface Palette {
269
+ id: string;
270
+ name: string;
271
+ note: string;
272
+ light: Record<string, string>;
273
+ dark: Record<string, string>;
274
+ }
275
+ /** 色味を指定しない時と、知らない名前を渡した時に使う色味。 */
276
+ declare const DEFAULT_PALETTE = "paper";
277
+ declare const PALETTES: Readonly<Record<string, Palette>>;
278
+ /** 名前から色味を引く。指定が無いか、知らない名前 (外した墨と朱の `ink` を含む) なら紙と墨。 */
279
+ declare function resolvePalette(id?: string): Palette;
280
+ /**
281
+ * 色味が持つ色の変数の名前 (#3198)。呼ぶ側が `colors` で値を渡せる鍵。
282
+ * 外へ出す型を `palettes.json` から作ると、束ねた型の file に JSON の中身が初期値付きで写り、型の検査を通らなくなるため、名前を並べて作る。
283
+ * 並びが `palettes.json` の明るい背景の名前と食い違うと、下の 2 つの `_` で始まる型が、余る名前か足りない名前を挙げて型の検査で落ちる
284
+ */
285
+ declare const COLOR_NAMES: readonly ["page", "bg", "surf", "sunk", "ink", "ink2", "mute", "hair", "line", "sh", "on-c", "c-blue", "t-blue", "c-amber", "t-amber", "c-green", "t-green", "c-violet", "t-violet", "c-rose", "t-rose", "c-slate", "t-slate", "coin", "coint", "coinin", "tint", "edge", "shA", "shB", "carry"];
286
+ type ColorName = (typeof COLOR_NAMES)[number];
287
+ /** 名前で選んだ色味に重ねる色の値。渡さない色は色味の値のまま残る (#3198) */
288
+ type Colors = Partial<Record<ColorName, string>>;
289
+ /** 区画や箱を分ける色の役。灰 (slate) と硬貨 (coin) は分類の色として順に配らない。 */
290
+ declare const COLOR_ORDER: readonly ["blue", "amber", "green", "violet", "rose"];
291
+ type ColorKey = (typeof COLOR_ORDER)[number] | "slate" | "coin";
292
+ interface TextStyle {
293
+ size: number;
294
+ weight: number;
295
+ family: Family;
296
+ }
297
+ /** 見せ方を決める字の大きさ。全体を枠に収めた時の箱の名前がこれを下回ると寄って追う。 */
298
+ declare const READABLE_PX = 10.5;
299
+
300
+ /**
301
+ * Markdown の中の dragon の囲み (```dragon) を、囲みごとに取り出す。
302
+ *
303
+ * 囲みの開き方と閉じ方は CommonMark に従う。` か ~ を 3 つ以上並べて開き、同じ字を開いた数以上
304
+ * 並べて閉じる。閉じていない囲みは文書の終わりまでを中身にする。dragon 以外の言語の囲みの中は読まない。
305
+ */
306
+ interface Fence {
307
+ /** 囲みの中身 (記法) */
308
+ source: string;
309
+ /** 中身の 1 行目が文書の何行目か。記法の誤りの行を文書の行に直す時に足す */
310
+ line: number;
311
+ }
312
+ declare function extractDiagrams(markdown: string): Fence[];
313
+
314
+ interface LineError {
315
+ line: number;
316
+ column: number;
317
+ message: string;
318
+ }
319
+ type Parsed = {
320
+ ok: true;
321
+ diagram: Diagram;
322
+ } | {
323
+ ok: false;
324
+ errors: LineError[];
325
+ };
326
+ interface ParseOptions {
327
+ /** 誤りの文の言葉。既定は日本語 */
328
+ lang?: NotationLang;
329
+ }
330
+ declare function parseNotation(notation: string, options?: ParseOptions): Parsed;
331
+
332
+ /**
333
+ * 図の原本の JSON を、人が書く dragon記法へ書き戻す (#3137)。
334
+ *
335
+ * 並べ方は決まった形に整える。JSON の欄の並び順は見ず、欄の名前で読むので、
336
+ * 同じ内容の JSON からは毎回同じ文字列になる。書き手の行の並べ方とコメントは保たない。
337
+ * 段の中で起きることは JSON の並び順 (起きる順) のまま書く。
338
+ * 状態遷移図の移れる道 (`state.paths`) は、帯の宣言の後、最初の `step` より前に JSON の並びのまま書く (#3163)。
339
+ *
340
+ * `"` で囲むのは要る時だけにする。`[` を含む名前と、`,` か `]` を含む属性の値と、`"` で始まる字を囲む。
341
+ * 箱は JSON の並びのまま書き、同じ区画の箱が続く所を 1 つの `group … end` にする。
342
+ * 区画の箱が飛び飛びの時は同じ `group` を開き直す。区画の並びが箱の現れる順と違う時と、
343
+ * 箱の無い区画がある時は、先に全ての区画を中の無い `group … end` で宣言してから開き直す。
344
+ * 枝分かれの図 (#3164) は、枝の `branch` の行を箱より前に書き、札を動かす線の運ぶ物が送る側の名前の札なら書かない。
345
+ * 時間軸の図 (#3165) は、目盛りと区切りと印の列と節目と拡大の範囲の行を箱より前に書き、物差しの欄の後ろに `[meter: <割合>]` を書く。
346
+ * 時間軸の図の `note` は属性を持てるので、`[` を含む字を `"` で囲む。
347
+ * 木の図 (#3233) の葉と親は、段の中に `leaf` と `node … of …` の行で書く。
348
+ * 列の図 (#3239) のチップは箱の後ろに `item` の行で書き、色が同じで字を持たないチップが続く所は 1 行に並べる。
349
+ * 段の出典 (#3199) は `say` と `code` の後ろ、段の中で起きることより前に、JSON の並びのまま 1 つずつ `source` の行に書く。
350
+ */
351
+
352
+ declare function printNotation(diagram: Diagram): string;
353
+
354
+ /** この道具が読める原本の版 */
355
+ declare const FORMAT_VERSION = 1;
356
+ type Read = {
357
+ ok: true;
358
+ diagram: Diagram;
359
+ warnings: string[];
360
+ } | {
361
+ ok: false;
362
+ errors: FieldError[];
363
+ };
364
+ /** 原本を読む。道具より新しい版は描かずに断り、形の誤りは検査の誤りとして返す。誤りの文は `options.lang` (渡さなければ日本語) で出す。 */
365
+ declare function readDiagram(input: unknown, options?: CheckOptions): Read;
366
+
367
+ /** 時間軸。`x` から目盛り 1 つの幅 `unit` で `count` 個並べ、`line` の高さに時刻の目盛りの線を引く */
368
+ interface TimeAxis {
369
+ x: number;
370
+ w: number;
371
+ unit: number;
372
+ count: number;
373
+ line: number;
374
+ }
375
+ /** 印の列 */
376
+ interface TimeRowPlaced extends Rect {
377
+ id: string;
378
+ name: string;
379
+ color: ColorKey;
380
+ }
381
+ /** 目盛り 1 つの印。`empty` は空きの印。`colors` は色を変えた段と出来事と色 */
382
+ interface TimeMark extends Rect {
383
+ row: string;
384
+ unit: number;
385
+ empty: boolean;
386
+ color: ColorKey;
387
+ colors: {
388
+ step: number;
389
+ event: number;
390
+ color: ColorKey;
391
+ }[];
392
+ }
393
+ /** 時刻の字。目盛りの境 `at` に置き、字の左端を `left` に、基準線を `y` に置く */
394
+ interface TimeTick {
395
+ at: number;
396
+ x: number;
397
+ text: string;
398
+ left: number;
399
+ y: number;
400
+ }
401
+ /** 区切り。`name` は区切りの名前と番号、`range` はその区切りの目盛りの番号の範囲。字は区切りの真ん中に置く */
402
+ interface TimePeriodPlaced extends Rect {
403
+ index: number;
404
+ from: number;
405
+ to: number;
406
+ name: string;
407
+ range: string;
408
+ nameY: number;
409
+ rangeY: number;
410
+ }
411
+ /** 節目。置いた目盛り `unit` の印の下の旗の丸。`text` は名札と状態の字が占める所、`changes` は状態の字と色を変えた段と出来事 */
412
+ interface TimePointPlaced {
413
+ id: string;
414
+ unit: number;
415
+ cx: number;
416
+ cy: number;
417
+ r: number;
418
+ text: Rect;
419
+ changes: {
420
+ step: number;
421
+ event: number;
422
+ text: string;
423
+ color?: ColorKey;
424
+ }[];
425
+ }
426
+ /** 拡大の帯の箱。`row` は同じ名札の印の列、`empty` はその列が空きにした目盛りの列の箱 */
427
+ interface TimeBox extends SceneBox {
428
+ row?: string;
429
+ empty?: boolean;
430
+ }
431
+ /** 拡大の帯の列。目盛り `unit` の列に、宣言した箱を同じ並びで置く。`head` は列の上の字 */
432
+ interface TimeColumn extends Rect {
433
+ unit: number;
434
+ head: string;
435
+ boxes: TimeBox[];
436
+ }
437
+ /** 拡大の帯。軸の上の拡大した範囲の枠 `frame` と、枠から帯へつなぐ点線 `guides`。`empty` は空きの枠の字、`headY` は列の上の字の基準線 */
438
+ interface TimeZoom {
439
+ from: number;
440
+ to: number;
441
+ frame: Rect;
442
+ guides: Point[][];
443
+ columns: TimeColumn[];
444
+ empty: string;
445
+ headY: number;
446
+ }
447
+ /** 範囲の括弧 (`bracket`) か囲み (`box`)。`until` は消える段 (無ければ最後の段まで残る)。`textY` は字の基準線 */
448
+ interface TimeSpanPlaced extends Rect {
449
+ step: number;
450
+ event: number;
451
+ kind: "bracket" | "box";
452
+ from: number;
453
+ to: number;
454
+ text: string;
455
+ textRect: Rect;
456
+ textY: number;
457
+ until?: number;
458
+ color: ColorKey;
459
+ }
460
+ /** 拡大の帯の線の両端の箱。`column` は線を出す列、`into` は受ける列の目盛り */
461
+ interface TimeWire {
462
+ step: number;
463
+ event: number;
464
+ from: TimeBox;
465
+ to: TimeBox;
466
+ column: number;
467
+ into: number;
468
+ }
469
+ interface TimeLayout extends Layout {
470
+ kind: "time";
471
+ axis: TimeAxis;
472
+ rows: TimeRowPlaced[];
473
+ marks: TimeMark[];
474
+ ticks: TimeTick[];
475
+ /** 細かい目盛りの線を引く境 */
476
+ minor: number[];
477
+ periods: TimePeriodPlaced[];
478
+ points: TimePointPlaced[];
479
+ zoom?: TimeZoom;
480
+ spans: TimeSpanPlaced[];
481
+ wires: TimeWire[];
482
+ /** 針の線の上端と下端 */
483
+ needle: {
484
+ y1: number;
485
+ y2: number;
486
+ };
487
+ }
488
+
489
+ /**
490
+ * 木の図の置き場所 (#3233)。見た目の元は step 2 で本人が選んだ「根を上」の試作 (`.context/propose/merkle-look/`)。
491
+ *
492
+ * 葉 (`leaf`) と親 (`node`) の出来事を書いた順に辿り、親を持たない最後の箱を根にする。根を上に置き、根からの深さごとに段を下げて並べる。
493
+ * 子を持たない箱 (葉) は書いた順に左から同じ間で並べ、親は最初の子と最後の子の真ん中の上に置く。
494
+ * 子から親への木の線は、子の上端から縦に出て、子の段と親の段の間の高さで横に渡り、親の下端へ縦に入る。
495
+ * 値を持つ葉は箱に値だけを出し、名札を葉の下の札に出す。値を持つ親は値を大きく、名札を小さく出す。値を持たない箱は名札だけを出す。
496
+ * 根の箱は左に枝の絵柄を持ち、ほかの木の箱より大きい。
497
+ *
498
+ * 木でない箱 (`box`) は木の右に、根の上端の高さから縦に並べる。中身の帯は図の下に置く。
499
+ * 親子の箱どうしの線は木の線の上を走り、ほかの線は箱の向き合う辺どうしを結ぶ。
500
+ * 段の番号は、箱が現れる段では最初に現れた箱の左に、線を引く段では最初の線の上に置く。
501
+ *
502
+ * 原本の JSON が書く前の名札を子に持つ時や、もう親を持つ箱を子にする時は、その子を除いて描く。箱と同じ名札の木の箱は描かない。
503
+ */
504
+
505
+ /** 木の箱。`lines` は箱の中の字を上から並べた行で、`baselines` と `styles` は行ごとの基準線の高さと字の形 */
506
+ interface TreePlaced extends Rect {
507
+ id: string;
508
+ kind: "leaf" | "node";
509
+ /** 根からの深さ。根が 0 */
510
+ depth: number;
511
+ parent?: string;
512
+ children: string[];
513
+ /** 箱を書いた段と、段の中の出来事の番号 */
514
+ step: number;
515
+ event: number;
516
+ hash?: string;
517
+ root: boolean;
518
+ cx: number;
519
+ cy: number;
520
+ color: ColorKey;
521
+ lines: string[];
522
+ baselines: number[];
523
+ styles: TextStyle[];
524
+ /** 値を持つ葉の下に置く、名札の札 */
525
+ card?: Rect & {
526
+ text: string;
527
+ };
528
+ }
529
+ /** 子 (`from`) から親 (`to`) への木の線。親を書いた段と出来事で現れる */
530
+ interface TreeLink {
531
+ from: string;
532
+ to: string;
533
+ step: number;
534
+ event: number;
535
+ points: Point[];
536
+ }
537
+ /** 木の線の上を走る線。`link` は走る木の線の子の名札 */
538
+ interface TreeRun {
539
+ step: number;
540
+ event: number;
541
+ link: string;
542
+ }
543
+ interface TreeLayout extends Layout {
544
+ kind: "tree";
545
+ nodes: TreePlaced[];
546
+ links: TreeLink[];
547
+ runs: TreeRun[];
548
+ }
549
+
550
+ /** 列の中の字。`text` は描く字で、`y` から `h` は字の形の高さ */
551
+ interface LaneText extends Rect {
552
+ text: string;
553
+ /** 基準線の高さ */
554
+ baseline: number;
555
+ }
556
+ /** 列。`track` はチップを並べる所で、上限の枚数の席が入る */
557
+ interface LineupLane extends SceneBox {
558
+ title: LaneText;
559
+ /** 右上の字の最初の字。書かない列は持たない */
560
+ note?: LaneText;
561
+ /** 右上の字の右端 */
562
+ noteRight: number;
563
+ track: Rect;
564
+ }
565
+ /** 段の出来事の場所 */
566
+ interface LineupAt {
567
+ step: number;
568
+ event: number;
569
+ }
570
+ /** チップが列の席に居る間 1 回分。`from` は滑り始める左上で、弾んで現れるチップは持たない。`until` は席を離れる出来事 */
571
+ interface LineupSeat extends Rect, LineupAt {
572
+ id: string;
573
+ lane: string;
574
+ index: number;
575
+ from?: Point;
576
+ until?: LineupAt;
577
+ }
578
+ /** 封。`until` は開ける出来事 */
579
+ interface LineupSeal extends Rect, LineupAt {
580
+ lane: string;
581
+ until?: LineupAt;
582
+ }
583
+ /** 札 */
584
+ interface LineupStamp extends Rect, LineupAt {
585
+ lane: string;
586
+ text: string;
587
+ }
588
+ /** 列を選ぶ出来事。同じ列を続けて選んだ時は最初の 1 つだけを持つ */
589
+ interface LineupPick extends LineupAt {
590
+ lane: string;
591
+ }
592
+ interface LineupLayout extends Layout {
593
+ kind: "lineup";
594
+ lanes: LineupLane[];
595
+ chips: LineupSeat[];
596
+ seals: LineupSeal[];
597
+ stamps: LineupStamp[];
598
+ picks: LineupPick[];
599
+ }
600
+
601
+ /** 秒で表した、見えている間。`end` の時刻は含まない。 */
602
+ interface Span {
603
+ start: number;
604
+ end: number;
605
+ }
606
+ /** 線を引いている間。`start` で引き始め、`drawn` で引き終わり、`end` (段の終わり) まで濃く残す。枝分かれの図では commit を積む出来事と枝を切る出来事も持つ */
607
+ interface EdgeTime extends Span {
608
+ step: number;
609
+ event: number;
610
+ drawn: number;
611
+ }
612
+ /** 運ぶ物が見えている間。`depart` に出発し `arrive` に着く。出発を待つ間と、着いた先で留まる間も含む。 */
613
+ interface CarrierTime extends Span {
614
+ step: number;
615
+ event: number;
616
+ who: "main" | "coin";
617
+ depart: number;
618
+ arrive: number;
619
+ }
620
+ interface LabelTime extends Span {
621
+ step: number;
622
+ event: number;
623
+ /** 状態遷移図だけが持つ。段が終わった後に薄く残す間 */
624
+ after?: Span;
625
+ /** 止め絵を選んだ図だけが持つ。最後の段で起きることが済んでから、最後の段と同じ濃さで出し直す間 (#3200) */
626
+ again?: Span;
627
+ }
628
+ /** 処理、箱の字の書き換え、中身の帯の値が起きる時刻。 */
629
+ interface EventTime {
630
+ step: number;
631
+ event: number;
632
+ at: number;
633
+ }
634
+ /** 状態遷移図の状態ごとの、光っている間と、済んだ印が出る時刻。運ぶ物が出ていない状態は `done` を持たない */
635
+ interface StateTime {
636
+ box: string;
637
+ lit: Span[];
638
+ done?: number;
639
+ }
640
+ interface Timeline {
641
+ /** 1 周の長さ */
642
+ total: number;
643
+ /** 繰り返す前に消えていく所の始まり */
644
+ last: number;
645
+ steps: Span[];
646
+ edges: EdgeTime[];
647
+ carriers: CarrierTime[];
648
+ labels: LabelTime[];
649
+ badges: {
650
+ step: number;
651
+ appears: number;
652
+ }[];
653
+ events: EventTime[];
654
+ /** 段ごとの止め絵の時刻。その段で起きることが全部見えている */
655
+ stills: number[];
656
+ /** 止め絵を選んだ図だけが持つ。最後の段で起きることが済んでから繰り返す前まで、全ての段の線の名前と箱の中の処理を出す間 (#3200) */
657
+ whole?: Span;
658
+ /** 状態遷移図だけが持つ */
659
+ states?: StateTime[];
660
+ /** 時間軸の図だけが持つ (#3165)。針の動き。[時刻, 目盛りの境の位置] の並びで、間は真っ直ぐ進む */
661
+ needle?: [number, number][];
662
+ /** 時間軸の図だけが持つ。針が目盛りを過ぎた (右の境に着いた) 時刻 */
663
+ units?: {
664
+ unit: number;
665
+ passed: number;
666
+ }[];
667
+ /** 時間軸の図だけが持つ。物差しの欄の満ち具合の動き。[時刻, 割合] の並びで、間は真っ直ぐ変わる */
668
+ meters?: {
669
+ field: string;
670
+ keys: [number, number][];
671
+ }[];
672
+ }
673
+
674
+ /** 書き手が書いていない図の部品。`icon` は箱 `box` の絵柄、`coin` と `envelope` は運ぶ物の硬貨と封筒 (#3184) */
675
+ type InkPart = {
676
+ kind: "icon";
677
+ box: string;
678
+ } | {
679
+ kind: "coin";
680
+ } | {
681
+ kind: "envelope";
682
+ };
683
+ /** 重なる字。`rect` は字 (札に入った字は札) の四角、`badge` は段の番号の丸の字か、`part` は図の部品の種類 (部品の時だけ持つ) */
684
+ interface OverlapSpot {
685
+ text: string;
686
+ rect: Rect;
687
+ badge: boolean;
688
+ part?: InkPart;
689
+ }
690
+ /**
691
+ * 重なり。`step` は重なりが見える段 (0 から数える)。
692
+ * `texts` は重なる 2 つの字、`line` は札を持たない字 `text` を横切る線の両端の名札。
693
+ * `spots` は重なる字で、`texts` は 2 つの字を同じ順に、`line` は横切られる字を 1 つ持つ
694
+ */
695
+ type Overlap = {
696
+ kind: "texts";
697
+ step: number;
698
+ texts: [string, string];
699
+ spots: [OverlapSpot, OverlapSpot];
700
+ } | {
701
+ kind: "line";
702
+ step: number;
703
+ text: string;
704
+ line: {
705
+ from: string;
706
+ to: string;
707
+ };
708
+ spots: [OverlapSpot];
709
+ };
710
+ /**
711
+ * 重なりを知らせる文 (#3178)。段の番号は「段の番号 N」と呼び、図の部品は言葉ごとの呼び方で呼び (#3184)、ほかの字は鉤括弧か引用符で囲む。
712
+ * 段の番号は文に含めない
713
+ */
714
+ declare function describeOverlap(overlap: Overlap, lang?: NotationLang): string;
715
+
716
+ interface RenderOptions {
717
+ /** 色味の名前。書かないか知らない名前なら紙と墨 */
718
+ palette?: string;
719
+ /**
720
+ * `palette` の色味に重ねる色の値 (#3198)。鍵は色味が持つ色の変数の名前 (`bg`、`ink`、`c-green` など) で、値は描く `theme` の色になる。
721
+ * 渡さない色は色味の値のまま残る。色味に無い名前と、色の値として読めない値は、名前を挙げて描かずに断る
722
+ */
723
+ colors?: Colors;
724
+ theme?: Theme;
725
+ /** 描く部品が出す字 (断りの文、全体図の札、読み上げの名前) の言葉。書かなければ日本語 (#3001) */
726
+ lang?: NotationLang;
727
+ /**
728
+ * 最後の段の止め絵に、全ての段の線の名前と箱の中の処理を最後の段と同じ濃さで出す (#3200)。途中の段の止め絵は今の段の名前だけを出す。
729
+ * 箱の下の 1 行に出す処理は、その箱で最後に起きた処理か書き換えの字を出す。違う段の名前が重なっても置き直さず、最後の段の重なり (`overlaps`) に出す
730
+ */
731
+ still?: boolean;
732
+ }
733
+ interface Rendered {
734
+ svg: string;
735
+ palette: string;
736
+ theme: Theme;
737
+ /** 書き手が原本で決めた見せ方 */
738
+ view?: ViewMode;
739
+ fonts: {
740
+ sans: string;
741
+ mono: string;
742
+ };
743
+ layout: Layout;
744
+ timeline: Timeline;
745
+ diagram: Diagram;
746
+ /** 段ごとの止め絵で、同時に見えている字どうしの重なりと、線が札を持たない字を横切る所 (#3175)。重なりが無ければ空 */
747
+ overlaps: Overlap[];
748
+ }
749
+ /** 原本の JSON から図を描く。原本が形に合わない時は、誤りの場所を添えて断る。 */
750
+ declare function renderDiagram(input: unknown, options?: RenderOptions): Rendered;
751
+
752
+ interface PlayerOptions extends RenderOptions {
753
+ /** 段が替わるたびに今の段 (0 から) を受け取る。置いた時にも最初の段で 1 度呼ぶ。頁の側で段の札や進み具合を出す時に使う (#3031) */
754
+ onStep?: (step: number) => void;
755
+ /**
756
+ * 図を、図の枠の中で見える高さに収める (#3047)。高さに収めると字が読めない図は寄って追う図にし、寄って追う窓と全体図をその高さに収める。
757
+ * 枠の高さが決まっている置き場 (カタログの拡大の重ね窓) で使う。枠の高さが図に合わせて伸びる置き場で使うと、描くたびに低くなる
758
+ */
759
+ fitHeight?: boolean;
760
+ /** 置いた時に流さず、段 `pausedAt` (0 から) の止め絵で止めて置く。段の数を超えた時は最後の段で止める。書かなければ置いた時から流す (#3200) */
761
+ pausedAt?: number;
762
+ /** 流した時に最後の段の止め絵で止め、繰り返さない。最後の段で止まった図を流すと、最初の段から流し直す (#3200) */
763
+ playOnce?: boolean;
764
+ }
765
+ interface Player {
766
+ /** 今の段 (0 から) */
767
+ readonly step: number;
768
+ /** 動いているか */
769
+ readonly playing: boolean;
770
+ next(): void;
771
+ prev(): void;
772
+ play(): void;
773
+ pause(): void;
774
+ /** 段 `step` (0 から) へ移って止める。段の数を超えた時は最後の段で止める (#3178) */
775
+ goTo(step: number): void;
776
+ /** 図の上に点線の四角を描く。四角は図の座標で渡し、空を渡すと消す。図を置き直しても残る (#3178) */
777
+ mark(rects: readonly Rect[]): void;
778
+ destroy(): void;
779
+ }
780
+ declare function mountDiagram(host: HTMLElement, diagram: unknown, options?: PlayerOptions): Player;
781
+
782
+ /**
783
+ * 箱と区画の印の形。どれも (0, 0) を中心に 20 四方へ収める。
784
+ *
785
+ * 見本帳 (`docs/design/base/engine.js` の `G`) と同じ形を持つ。`block` だけは見本帳が絵を手で描いていたので、ここで足した。
786
+ * `undo` (戻る矢印) と `yen` (円の印) は、注文の試作 (`docs/design/base/scenes/order.js`) が返品と返金に足した形 (#3171)。
787
+ * package の入口からも出し、見本帳の部品「絵」の頁がこの表から使える絵柄の一覧を作る。1 つずつの絵は `iconSvg` が描く (#3172)。
788
+ * `flag` (旗) は、時間軸の図の節目の丸に描く形 (#3165)。ブロックの確定の試作 (`docs/design/base/scenes/finality.js`) が持っていた。
789
+ * `tree` (親子に分かれる木) は、木の図の根の箱に描く形 (#3233)。step 2 で本人が選んだ試作が持っていた。
790
+ */
791
+ declare const ICONS: Readonly<Record<string, string>>;
792
+
793
+ /**
794
+ * 絵柄を 1 つだけ描いた SVG (#3172)。見本帳の部品「絵」の頁が、使える絵柄を並べる時に使う。
795
+ * 線の太さは箱の印と同じ割合 (印の線の太さ × 印の縮み) で、色は置いた所の字の色 (`currentColor`) を使う。知らない名前は `undefined`
796
+ */
797
+ declare function iconSvg(name: string): string | undefined;
798
+
799
+ declare function chooseView(rendered: Pick<Rendered, "layout" | "view">, frameWidth: number, frameHeight?: number): {
800
+ mode: ViewMode;
801
+ textPx: number;
802
+ };
803
+
804
+ type Point = [number, number];
805
+ interface Rect {
806
+ x: number;
807
+ y: number;
808
+ w: number;
809
+ h: number;
810
+ }
811
+ interface SceneBox extends Rect {
812
+ id: string;
813
+ name: string;
814
+ sub?: string;
815
+ icon?: string;
816
+ color: ColorKey;
817
+ cx: number;
818
+ cy: number;
819
+ /** 状態遷移図で、どの段も辿り着かない状態。点線の箱で脇道の囲みに描く */
820
+ ghost?: boolean;
821
+ /** 運ぶ物の置き場の枠 (#3176)。運ぶ物を出し入れする箱だけが持つ */
822
+ slot?: Rect;
823
+ /** 絵柄の真ん中の x。置き場を持つ箱は、絵柄を左へ寄せて右を置き場にする。無ければ箱の真ん中 */
824
+ iconX?: number;
825
+ }
826
+ interface SceneRegion extends Rect {
827
+ id: string;
828
+ /** 名前を折り返した行 */
829
+ lines: string[];
830
+ note?: string;
831
+ icon?: string;
832
+ color: ColorKey;
833
+ /** 名前と印が占める所 */
834
+ header: Rect;
835
+ }
836
+ /** 線。`step` と `event` は原本の `steps[step].events[event]` を指す。 */
837
+ interface SceneEdge {
838
+ step: number;
839
+ event: number;
840
+ from: string;
841
+ to: string;
842
+ points: Point[];
843
+ color: ColorKey;
844
+ carry: Carry;
845
+ /** 着いた運ぶ物が留まる点。無ければ線の終わり */
846
+ settle?: Point;
847
+ /** 走り出す前に運ぶ物が待つ点 (#3176)。運ぶ物はここから線の始まりへ出て線を走る。無ければ線の始まり */
848
+ wait?: Point;
849
+ }
850
+ interface SceneLabel extends Rect {
851
+ step: number;
852
+ event: number;
853
+ text: string;
854
+ family: Family;
855
+ color: ColorKey;
856
+ /** 同じ線の同じ名前を次に置く段 (状態遷移図、#3184)。その段が始まると、薄く残した名前を消す */
857
+ until?: number;
858
+ }
859
+ /** 状態遷移図の、最初の段より前に書いてどの段にも出ない線。点線で描き、運ぶ物を走らせない */
860
+ interface ScenePath {
861
+ from: string;
862
+ to: string;
863
+ points: Point[];
864
+ label?: Rect & {
865
+ text: string;
866
+ family: Family;
867
+ };
868
+ }
869
+ /** 状態遷移図の始まりと終わりの印。`ghost` は脇道の中の終わりの印 */
870
+ interface SceneEnd {
871
+ kind: "start" | "finish";
872
+ x: number;
873
+ y: number;
874
+ r: number;
875
+ ghost: boolean;
876
+ /** 印の右に添える字 */
877
+ text: string;
878
+ /** 終わりの印へ線を引く状態 */
879
+ box?: string;
880
+ }
881
+ /** 状態遷移図の脇道の囲み。`title` と `notes` は囲みの左上に置く字 */
882
+ interface SceneSide extends Rect {
883
+ title: string;
884
+ /** 囲みの名前の下に 1 行ずつ置く添え書き */
885
+ notes: string[];
886
+ }
887
+ /** 時系列図の箱の中の処理。生存線の上に札で出す。 */
888
+ interface SceneAction extends Rect {
889
+ step: number;
890
+ event: number;
891
+ box: string;
892
+ text: string;
893
+ color: ColorKey;
894
+ }
895
+ interface SceneBadge {
896
+ step: number;
897
+ x: number;
898
+ y: number;
899
+ color: ColorKey;
900
+ /** 同じ所に次に番号を置く段 (#3184)。その段が始まると、この番号を消して数字を入れ替える。無ければ最後まで残る */
901
+ until?: number;
902
+ }
903
+ interface SceneLifeline {
904
+ id: string;
905
+ x: number;
906
+ y1: number;
907
+ y2: number;
908
+ }
909
+ interface SceneField {
910
+ name: string;
911
+ x: number;
912
+ y: number;
913
+ w: number;
914
+ /** 時間軸の図の物差しの欄 (#3165)。`line` の割合の所に線を引き、線の字 `text` を添える。棒は `x` から幅 `w` */
915
+ meter?: {
916
+ line: number;
917
+ text: string;
918
+ x: number;
919
+ w: number;
920
+ };
921
+ }
922
+ /** 状態遷移図の帯の最後の欄。段が辿り着く順に状態を点で並べ、着いた状態を塗る (#3171) */
923
+ interface SceneTrail {
924
+ title: string;
925
+ states: {
926
+ box: string;
927
+ color: ColorKey;
928
+ }[];
929
+ x: number;
930
+ y: number;
931
+ w: number;
932
+ }
933
+ interface SceneStrip extends Rect {
934
+ title: string;
935
+ fields: SceneField[];
936
+ trail?: SceneTrail;
937
+ }
938
+ interface Layout {
939
+ kind: Diagram["kind"];
940
+ width: number;
941
+ height: number;
942
+ regions: SceneRegion[];
943
+ boxes: SceneBox[];
944
+ lifelines: SceneLifeline[];
945
+ edges: SceneEdge[];
946
+ labels: SceneLabel[];
947
+ actions: SceneAction[];
948
+ badges: SceneBadge[];
949
+ strip?: SceneStrip;
950
+ /** 状態遷移図の通らない道。他の図の種類では空 */
951
+ paths: ScenePath[];
952
+ /** 状態遷移図の始まりと終わりの印。他の図の種類では空 */
953
+ ends: SceneEnd[];
954
+ /** 状態遷移図の脇道の囲み。通らない状態が無ければ無い */
955
+ side?: SceneSide;
956
+ }
957
+
958
+ /** 後から読む種類の名前。部品の型から導くと、部品の型が軽い入口の型の file へ漏れるので字で書く */
959
+ type LaterKind = "git" | "lineup" | "state" | "time" | "tree";
960
+ /** 後から読む種類 */
961
+ declare const LATER_KINDS: readonly LaterKind[];
962
+ /** 種類の部品を今すぐ描ける形で持っているか。時系列図と構成図は常に持つ */
963
+ declare function kindLoaded(kind: string | undefined): boolean;
964
+
965
+ /**
966
+ * dragon の軽い入口 (`@cardenelabs/dragon/light`、#3248)。
967
+ *
968
+ * 既定の入口と同じ部品を出すが、git、lineup、state、time、tree の描く部品を持たず、`loadKind` を待った時に読む。
969
+ * 読んだ後は既定の入口と同じ関数で、待たずに同じ図を描く。読んでいない種類を描くと、その種類の名前を含む誤りで止まる。
970
+ * 最初に読む量を抑えたい頁を束ねる時に使い、この入口と既定の入口を 1 つの頁で混ぜない (混ぜると全ての部品が頁に入る)。
971
+ */
972
+
973
+ /** 種類の描く部品を読む。時系列図と構成図は初めから持つので何もしない。読み込みが落ちると拒否され、次に呼ぶと読み直す */
974
+ declare function loadKind(kind: string | undefined): Promise<void>;
975
+
976
+ export { type Box, type CarrierTime, type Carry, type CheckOptions, type Checked, type Color, type ColorKey, type ColorName, type Colors, DEFAULT_PALETTE, type Diagram, type DiagramEvent, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, type FieldError, type GitBranch, type GitCommit, ICONS, type InkPart, LATER_KINDS, type LabelSide, type LabelTime, type LaneText, type LaterKind, type Layout, type LineError, type LineupAt, type LineupItem, type LineupLane, type LineupLayout, type LineupOrder, type LineupPick, type LineupSeal, type LineupSeat, type LineupStamp$1 as LineupStamp, type LineupStamp as LineupStampPlaced, type NotationLang, type Overlap, type OverlapSpot, PALETTES, type Palette, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, READABLE_PX, type Read, type Rect, type Region, 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 StatePath, type StateTime, type Step, type StepSource, type StripMeter, type TextStyle, type Theme, type TimeAxis, type TimeBox, type TimeColumn, type TimeLayout, type TimeMark, type TimeMarkEvent, type TimePeriod, type TimePeriodPlaced, type TimePoint, type TimePointPlaced, type TimeRow, type TimeRowPlaced, type TimeScale, type TimeSpanEvent, type TimeSpanPlaced, type TimeSpec, type TimeTick, type TimeWire, type TimeZoom, type Timeline, type TreeLayout, type TreeLeaf, type TreeLink, type TreeNode, type TreePlaced, type TreeRun, type ViewMode, chooseView, describeOverlap, extractDiagrams, iconSvg, kindLoaded, loadKind, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram, resolvePalette, validateDiagram };