@cardenelabs/dragon 0.41.1 → 0.42.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 (44) hide show
  1. package/README.md +21 -1
  2. package/dist/cli.cjs +4094 -961
  3. package/dist/cli.cjs.map +1 -1
  4. package/dist/cli.js +4094 -961
  5. package/dist/cli.js.map +1 -1
  6. package/dist/export.cjs +3681 -939
  7. package/dist/export.cjs.map +1 -1
  8. package/dist/export.d.cts +1 -1
  9. package/dist/export.d.ts +1 -1
  10. package/dist/export.js +3681 -939
  11. package/dist/export.js.map +1 -1
  12. package/dist/index.cjs +4016 -815
  13. package/dist/index.cjs.map +1 -1
  14. package/dist/index.d.cts +159 -3
  15. package/dist/index.d.ts +159 -3
  16. package/dist/index.js +4016 -815
  17. package/dist/index.js.map +1 -1
  18. package/dist/{ink-B_7OXxtb.d.cts → ink-B8EZL7JV.d.cts} +95 -3
  19. package/dist/{ink-B_7OXxtb.d.ts → ink-B8EZL7JV.d.ts} +95 -3
  20. package/dist/node.cjs +2461 -726
  21. package/dist/node.cjs.map +1 -1
  22. package/dist/node.js +2461 -726
  23. package/dist/node.js.map +1 -1
  24. package/dist/player.global.js +2 -2
  25. package/package.json +1 -1
  26. package/src/field-messages.ts +12 -0
  27. package/src/figure-text.ts +26 -0
  28. package/src/index.ts +11 -1
  29. package/src/layout/scene.ts +23 -2
  30. package/src/layout/time.ts +680 -0
  31. package/src/look/values.ts +142 -2
  32. package/src/messages.ts +108 -5
  33. package/src/parser.ts +427 -6
  34. package/src/player.ts +48 -10
  35. package/src/printer.ts +63 -12
  36. package/src/render/icons.ts +2 -0
  37. package/src/render/parts.ts +29 -9
  38. package/src/render/svg.ts +129 -21
  39. package/src/render/time.ts +291 -0
  40. package/src/schema.ts +109 -10
  41. package/src/schemas/diagram.schema.json +224 -12
  42. package/src/schemas/validate-diagram.js +1 -1
  43. package/src/timeline.ts +147 -10
  44. package/src/words.ts +39 -6
package/README.md CHANGED
@@ -50,6 +50,23 @@ CSS と字の file は、束ねる道具 (Vite など) が頁へ運ぶ。
50
50
 
51
51
  `mountDiagram` が返す `player` で段を動かす (`next`、`prev`、`play`、`pause`、`destroy`)。
52
52
  3 つめの引数には色味や段が替わった時に呼ぶ関数などの設定 (`PlayerOptions`) を渡す。
53
+ 置いた時に流さず決めた段の止め絵で止めて置くには `pausedAt` に段の番号 (0 から) を、1 度だけ流して最後の段で止めるには `playOnce: true` を渡す。
54
+ `still: true` を渡すと、最後の段の止め絵に全ての段の線の名前と箱の中の処理を最後の段と同じ濃さで出し、動かさない読者にも流れ全体を 1 枚で見せる。
55
+ `still` は `renderDiagram` にも渡せる。
56
+ どれも渡さなければ、置いた時から全ての段を繰り返し流す。
57
+
58
+ 色味は名前 (`palette`) で選び、`colors` に色の変数の名前と値を渡すと、渡した色だけを描く明暗 (`theme`) の色として上書きする。
59
+ 鍵は色味が持つ名前 (`bg`、`surf`、`ink`、`line`、`c-green`、`t-green` など。型は `ColorName`) で、渡さない色は名前で選んだ色味の値のまま残る。
60
+ 置いた図、寄って追う時の全体図、釦と段の帯のどれも同じ色で塗る。`renderDiagram` も同じ `colors` を受ける。
61
+
62
+ ```ts
63
+ mountDiagram(host, parsed.diagram, {
64
+ palette: "night",
65
+ colors: { bg: "#0a0f0a", surf: "#101810", ink: "#39ff14", line: "#1f9a0b", "c-green": "#39ff14" },
66
+ });
67
+ ```
68
+
69
+ 色味に無い名前と、`;`、`"`、`<` などを含む色として読めない値を渡すと、その名前を挙げて描かずに断る。
53
70
 
54
71
  ## dragon記法
55
72
 
@@ -60,7 +77,10 @@ CSS と字の file は、束ねる道具 (Vite など) が頁へ運ぶ。
60
77
  3. 空白を含む名前と文は、行末か `[` の前に置く。`,` か `]` を含む値と、`[` を含む名前だけを `"` で囲む
61
78
  4. 入れ子は `group … end` だけ。段は次の `step` までで、字下げは読みやすさのために付ける。`say` の続きの行だけは `say` より深く字下げする
62
79
 
63
- 行の頭の語は `sequence` `architecture` `state` `git` `group` `end` `box` `branch` `strip` `step` `say` `code` `commit` `act` `note` `set` で、線の行は `名札 -> 名札` と書く。
80
+ 行の頭の語は `sequence` `architecture` `state` `git` `group` `end` `box` `branch` `strip` `step` `say` `code` `source` `commit` `act` `note` `set` で、線の行は `名札 -> 名札` と書く。
81
+ 箱の行の属性 `link` に飛び先を書くと、描いた図でその箱が飛び先への link になる。
82
+ 段の中の `source <名前> [url: <URL>]` の行は段の出典になり、1 つの段に何行でも書け、読み上げの段の一覧に名前の link で出る。
83
+ 飛び先と出典の URL には、`/` で始まる path か、`http://` か `https://` で始まる URL だけを書ける。
64
84
 
65
85
  ```dragon
66
86
  architecture 注文を倉庫へ回す