@cardenelabs/dragon 0.49.0 → 0.51.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 (198) hide show
  1. package/README.ja.md +38 -0
  2. package/README.md +36 -0
  3. package/dist/cdn/chunk-2CSGFWPY.js +2 -0
  4. package/dist/cdn/chunk-2CSGFWPY.js.map +1 -0
  5. package/dist/cdn/chunk-2RADRUCB.js +2 -0
  6. package/dist/cdn/chunk-2RADRUCB.js.map +1 -0
  7. package/dist/cdn/chunk-3S6ZF5ZL.js +3 -0
  8. package/dist/cdn/chunk-3S6ZF5ZL.js.map +1 -0
  9. package/dist/cdn/chunk-4VN3WCGJ.js +2 -0
  10. package/dist/cdn/chunk-4VN3WCGJ.js.map +1 -0
  11. package/dist/cdn/chunk-67FSUDA7.js +2 -0
  12. package/dist/cdn/chunk-67FSUDA7.js.map +1 -0
  13. package/dist/cdn/chunk-6GMISRZ2.js +2 -0
  14. package/dist/cdn/chunk-6GMISRZ2.js.map +1 -0
  15. package/dist/cdn/chunk-6NQGW7KH.js +2 -0
  16. package/dist/cdn/chunk-6NQGW7KH.js.map +1 -0
  17. package/dist/cdn/chunk-7K45VDGR.js +2 -0
  18. package/dist/cdn/chunk-7K45VDGR.js.map +1 -0
  19. package/dist/cdn/chunk-CN2LY7RJ.js +2 -0
  20. package/dist/cdn/chunk-CN2LY7RJ.js.map +1 -0
  21. package/dist/cdn/chunk-EE4P4NP7.js +3 -0
  22. package/dist/cdn/chunk-EE4P4NP7.js.map +1 -0
  23. package/dist/cdn/chunk-ENWY2HOL.js +2 -0
  24. package/dist/cdn/chunk-ENWY2HOL.js.map +1 -0
  25. package/dist/cdn/chunk-EPDBW2EK.js +2 -0
  26. package/dist/cdn/chunk-EPDBW2EK.js.map +1 -0
  27. package/dist/cdn/chunk-GCAATUAG.js +2 -0
  28. package/dist/cdn/chunk-GCAATUAG.js.map +1 -0
  29. package/dist/cdn/chunk-HIPXC3NW.js +2 -0
  30. package/dist/cdn/chunk-HIPXC3NW.js.map +1 -0
  31. package/dist/cdn/chunk-HJPEBK24.js +2 -0
  32. package/dist/cdn/chunk-HJPEBK24.js.map +1 -0
  33. package/dist/cdn/chunk-JE6XU3YT.js +2 -0
  34. package/dist/cdn/chunk-JE6XU3YT.js.map +1 -0
  35. package/dist/cdn/chunk-KVYLF55R.js +3 -0
  36. package/dist/cdn/chunk-KVYLF55R.js.map +1 -0
  37. package/dist/cdn/chunk-MLUUPXJK.js +2 -0
  38. package/dist/cdn/chunk-MLUUPXJK.js.map +1 -0
  39. package/dist/cdn/chunk-MSKBH4EM.js +2 -0
  40. package/dist/cdn/chunk-MSKBH4EM.js.map +1 -0
  41. package/dist/cdn/chunk-N4BVNCXR.js +2 -0
  42. package/dist/cdn/chunk-N4BVNCXR.js.map +1 -0
  43. package/dist/cdn/chunk-OJ3GHPCA.js +2 -0
  44. package/dist/cdn/chunk-OJ3GHPCA.js.map +1 -0
  45. package/dist/cdn/chunk-PJHOQVMY.js +2 -0
  46. package/dist/cdn/chunk-PJHOQVMY.js.map +1 -0
  47. package/dist/cdn/chunk-QGPPJ7VJ.js +2 -0
  48. package/dist/cdn/chunk-QGPPJ7VJ.js.map +1 -0
  49. package/dist/cdn/chunk-QNSCUYRJ.js +2 -0
  50. package/dist/cdn/chunk-QNSCUYRJ.js.map +1 -0
  51. package/dist/cdn/chunk-SBPSZ5Y3.js +2 -0
  52. package/dist/cdn/chunk-SBPSZ5Y3.js.map +1 -0
  53. package/dist/cdn/chunk-SKTNCU35.js +2 -0
  54. package/dist/cdn/chunk-SKTNCU35.js.map +1 -0
  55. package/dist/cdn/chunk-V7UQ2V6L.js +2 -0
  56. package/dist/cdn/chunk-V7UQ2V6L.js.map +1 -0
  57. package/dist/cdn/chunk-YOG32U5M.js +2 -0
  58. package/dist/cdn/chunk-YOG32U5M.js.map +1 -0
  59. package/dist/cdn/chunk-ZVZRZOMA.js +2 -0
  60. package/dist/cdn/chunk-ZVZRZOMA.js.map +1 -0
  61. package/dist/cdn/dragon-main.js +16 -0
  62. package/dist/cdn/dragon-main.js.map +1 -0
  63. package/dist/cdn/dragon.js +2 -0
  64. package/dist/cdn/dragon.js.map +1 -0
  65. package/dist/cdn/git-WX3RETOK.js +2 -0
  66. package/dist/cdn/git-WX3RETOK.js.map +1 -0
  67. package/dist/cdn/lineup-U3FH5CYD.js +2 -0
  68. package/dist/cdn/lineup-U3FH5CYD.js.map +1 -0
  69. package/dist/cdn/read-2J7H3GDH.js +2 -0
  70. package/dist/cdn/read-2J7H3GDH.js.map +1 -0
  71. package/dist/cdn/read-34PFCORQ.js +2 -0
  72. package/dist/cdn/read-34PFCORQ.js.map +1 -0
  73. package/dist/cdn/read-3TVX26CP.js +2 -0
  74. package/dist/cdn/read-3TVX26CP.js.map +1 -0
  75. package/dist/cdn/read-4KCMSG7Q.js +2 -0
  76. package/dist/cdn/read-4KCMSG7Q.js.map +1 -0
  77. package/dist/cdn/read-4XV4JARL.js +2 -0
  78. package/dist/cdn/read-4XV4JARL.js.map +1 -0
  79. package/dist/cdn/read-575JEUU2.js +3 -0
  80. package/dist/cdn/read-575JEUU2.js.map +1 -0
  81. package/dist/cdn/read-6JESRCXY.js +2 -0
  82. package/dist/cdn/read-6JESRCXY.js.map +1 -0
  83. package/dist/cdn/read-7UEBTLNP.js +2 -0
  84. package/dist/cdn/read-7UEBTLNP.js.map +1 -0
  85. package/dist/cdn/read-DCXYX3JV.js +2 -0
  86. package/dist/cdn/read-DCXYX3JV.js.map +1 -0
  87. package/dist/cdn/read-E25B7BKW.js +2 -0
  88. package/dist/cdn/read-E25B7BKW.js.map +1 -0
  89. package/dist/cdn/read-FXJUIQDF.js +2 -0
  90. package/dist/cdn/read-FXJUIQDF.js.map +1 -0
  91. package/dist/cdn/read-GR4ZYUA5.js +2 -0
  92. package/dist/cdn/read-GR4ZYUA5.js.map +1 -0
  93. package/dist/cdn/read-K2KRRL6K.js +3 -0
  94. package/dist/cdn/read-K2KRRL6K.js.map +1 -0
  95. package/dist/cdn/read-M7QHQUF3.js +3 -0
  96. package/dist/cdn/read-M7QHQUF3.js.map +1 -0
  97. package/dist/cdn/read-QMLMJCQK.js +2 -0
  98. package/dist/cdn/read-QMLMJCQK.js.map +1 -0
  99. package/dist/cdn/read-RR63XECR.js +2 -0
  100. package/dist/cdn/read-RR63XECR.js.map +1 -0
  101. package/dist/cdn/read-SBGLIZA2.js +2 -0
  102. package/dist/cdn/read-SBGLIZA2.js.map +1 -0
  103. package/dist/cdn/read-STCHJY7U.js +2 -0
  104. package/dist/cdn/read-STCHJY7U.js.map +1 -0
  105. package/dist/cdn/read-SZ5OPR25.js +2 -0
  106. package/dist/cdn/read-SZ5OPR25.js.map +1 -0
  107. package/dist/cdn/read-TKPM5DTN.js +2 -0
  108. package/dist/cdn/read-TKPM5DTN.js.map +1 -0
  109. package/dist/cdn/read-TSIIDGYU.js +3 -0
  110. package/dist/cdn/read-TSIIDGYU.js.map +1 -0
  111. package/dist/cdn/read-U4QCYWDX.js +2 -0
  112. package/dist/cdn/read-U4QCYWDX.js.map +1 -0
  113. package/dist/cdn/read-VL4YQUQ5.js +2 -0
  114. package/dist/cdn/read-VL4YQUQ5.js.map +1 -0
  115. package/dist/cdn/read-X4YAGYMZ.js +2 -0
  116. package/dist/cdn/read-X4YAGYMZ.js.map +1 -0
  117. package/dist/cdn/read-Y3IRTQAC.js +3 -0
  118. package/dist/cdn/read-Y3IRTQAC.js.map +1 -0
  119. package/dist/cdn/state-42S2SYX4.js +2 -0
  120. package/dist/cdn/state-42S2SYX4.js.map +1 -0
  121. package/dist/cdn/time-NDAJ3Y2Y.js +2 -0
  122. package/dist/cdn/time-NDAJ3Y2Y.js.map +1 -0
  123. package/dist/cdn/tree-HWVTEP5F.js +3 -0
  124. package/dist/cdn/tree-HWVTEP5F.js.map +1 -0
  125. package/dist/cdn/try-HWOC3JUH.js +3 -0
  126. package/dist/cdn/try-HWOC3JUH.js.map +1 -0
  127. package/dist/cli.cjs +83 -4
  128. package/dist/cli.cjs.map +1 -1
  129. package/dist/cli.js +84 -5
  130. package/dist/cli.js.map +1 -1
  131. package/dist/light/chunk-2ZZNRPZI.cjs.map +1 -1
  132. package/dist/light/chunk-3X7C7W73.cjs.map +1 -1
  133. package/dist/light/chunk-ABHVNNIX.cjs.map +1 -1
  134. package/dist/light/chunk-BGI7VUO4.cjs.map +1 -1
  135. package/dist/light/chunk-C3T6RGAI.cjs.map +1 -1
  136. package/dist/light/chunk-DQHIFCPR.cjs.map +1 -1
  137. package/dist/light/chunk-EWKIFSIY.cjs.map +1 -1
  138. package/dist/light/chunk-FX3AI6DD.cjs.map +1 -1
  139. package/dist/light/chunk-IDTTUWLJ.cjs.map +1 -1
  140. package/dist/light/chunk-IMXBW6IE.cjs.map +1 -1
  141. package/dist/light/chunk-INW5MFVL.cjs.map +1 -1
  142. package/dist/light/chunk-IX7JWHZA.cjs.map +1 -1
  143. package/dist/light/chunk-LYSEMMIK.cjs.map +1 -1
  144. package/dist/light/chunk-MC2FRYQM.cjs.map +1 -1
  145. package/dist/light/chunk-MNKFIGKV.cjs.map +1 -1
  146. package/dist/light/chunk-N3SQJDCE.cjs.map +1 -1
  147. package/dist/light/chunk-O6TNVMAE.cjs.map +1 -1
  148. package/dist/light/chunk-PESRNT2K.cjs.map +1 -1
  149. package/dist/light/chunk-PK2IAFV7.cjs.map +1 -1
  150. package/dist/light/chunk-QF2WCA42.cjs.map +1 -1
  151. package/dist/light/chunk-RWGOB6BI.cjs.map +1 -1
  152. package/dist/light/chunk-SPO6C3DK.cjs.map +1 -1
  153. package/dist/light/chunk-UZ7P2KL7.cjs.map +1 -1
  154. package/dist/light/chunk-VUDVXBNS.cjs.map +1 -1
  155. package/dist/light/chunk-XEMPBLLY.cjs.map +1 -1
  156. package/dist/light/chunk-XTMF6DU3.cjs.map +1 -1
  157. package/dist/light/chunk-Z65BLQHP.cjs.map +1 -1
  158. package/dist/light/chunk-ZPDMD2HM.cjs.map +1 -1
  159. package/dist/light/git-NP5754AH.cjs.map +1 -1
  160. package/dist/light/index.cjs.map +1 -1
  161. package/dist/light/lineup-FH7IEWCQ.cjs.map +1 -1
  162. package/dist/light/read-3TGEKIWC.cjs.map +1 -1
  163. package/dist/light/read-4662YCBN.cjs.map +1 -1
  164. package/dist/light/read-7BSCLIBE.cjs.map +1 -1
  165. package/dist/light/read-7OID45SR.cjs.map +1 -1
  166. package/dist/light/read-AZNIUZRQ.cjs.map +1 -1
  167. package/dist/light/read-BWNWKOPK.cjs.map +1 -1
  168. package/dist/light/read-CCXPVHWE.cjs.map +1 -1
  169. package/dist/light/read-CP6UXVHG.cjs.map +1 -1
  170. package/dist/light/read-FD77MQ5D.cjs.map +1 -1
  171. package/dist/light/read-FTUHYOPX.cjs.map +1 -1
  172. package/dist/light/read-HQVX62P3.cjs.map +1 -1
  173. package/dist/light/read-HWNH6P24.cjs.map +1 -1
  174. package/dist/light/read-IZU6AJ2Z.cjs.map +1 -1
  175. package/dist/light/read-J3B35XE7.cjs.map +1 -1
  176. package/dist/light/read-K2HTSR6T.cjs.map +1 -1
  177. package/dist/light/read-MLWM6XDJ.cjs.map +1 -1
  178. package/dist/light/read-Q7OXFGPT.cjs.map +1 -1
  179. package/dist/light/read-RFXK5SUP.cjs.map +1 -1
  180. package/dist/light/read-S4YR3S2H.cjs.map +1 -1
  181. package/dist/light/read-S5XLQOSN.cjs.map +1 -1
  182. package/dist/light/read-UJMXEWAV.cjs.map +1 -1
  183. package/dist/light/read-UKSQ5PIN.cjs.map +1 -1
  184. package/dist/light/read-VEDXP7TO.cjs.map +1 -1
  185. package/dist/light/read-XMDEPGF3.cjs.map +1 -1
  186. package/dist/light/read-YPV7U6CJ.cjs.map +1 -1
  187. package/dist/light/state-SRPBN3JK.cjs.map +1 -1
  188. package/dist/light/time-HWLKFZEV.cjs.map +1 -1
  189. package/dist/light/tree-AHPW5CVX.cjs.map +1 -1
  190. package/dist/light/try-CGFAHWMP.cjs.map +1 -1
  191. package/dist/offline.global.js +20 -0
  192. package/package.json +1 -1
  193. package/src/cli.ts +78 -6
  194. package/src/export/embed.ts +26 -0
  195. package/src/page-blocks.ts +70 -0
  196. package/src/script-loader.ts +19 -0
  197. package/src/script-offline.ts +11 -0
  198. package/src/script.ts +32 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cardenelabs/dragon",
3
- "version": "0.49.0",
3
+ "version": "0.51.0",
4
4
  "description": "Animated diagrams that people write in a plain notation and AI writes as JSON. Plays on a page and exports MP4, GIF, HTML, and PNG.",
5
5
  "license": "MIT",
6
6
  "author": "cardene777",
package/src/cli.ts CHANGED
@@ -2,15 +2,17 @@
2
2
  /**
3
3
  * `dragon export <図の file>` の命令。原本の JSON (`.json`) か記法 (`.dragon`) を読み、mp4、GIF、HTML、PNG を書き出す。
4
4
  * 書き出した file の path を 1 行ずつ出す。
5
+ * `dragon embed <HTML の file>` の命令は、頁の script の1行の入口を束ねた script の中身に置き換え、外へ通信しない1 file を書く (#3343)。
5
6
  * 図に字の重なりがある時は、書き出したうえで重なりを段と文で 1 件 1 行ずつ標準エラーに出し、終わり方は 0 のままにする (#3178)。
6
7
  * 重なりは描けない誤りではなく、止めると避けられない重なりを持つ図を書き出せなくなるため。
7
8
  *
8
9
  * 使い方の文と誤りの文は、図の中の字と同じ言葉で出す (#3003)。`--lang` を渡せばその言葉、無ければ英語 (#3338)。
9
10
  * dragon記法の語は英語だけで file から言葉が決まらないため、記法の file も JSON の原本と同じに扱う (#3137)。
10
11
  */
11
- import { readFileSync } from "node:fs";
12
- import { basename, extname, resolve } from "node:path";
12
+ import { readFileSync, writeFileSync } from "node:fs";
13
+ import { basename, dirname, extname, join, resolve } from "node:path";
13
14
  import { parseArgs } from "node:util";
15
+ import { embedPage } from "./export/embed";
14
16
  import { type ExportFormat, exportDiagram, FORMATS } from "./export/index";
15
17
  import { PALETTES, type Theme } from "./look/values";
16
18
  import { parseNotation } from "./parser";
@@ -28,6 +30,9 @@ const OPTIONS = {
28
30
  format: { type: "string" },
29
31
  } as const;
30
32
 
33
+ /** `dragon embed` の設定 */
34
+ const EMBED_OPTIONS = { out: { type: "string" }, lang: { type: "string" } } as const;
35
+
31
36
  type Values = Partial<Record<keyof typeof OPTIONS, string>>;
32
37
 
33
38
  const THEMES: readonly Theme[] = ["light", "dark"];
@@ -36,6 +41,10 @@ const PALETTE_NAMES = Object.keys(PALETTES).join(" / ");
36
41
 
37
42
  interface CliText {
38
43
  usage: string;
44
+ /** `dragon embed` の使い方 */
45
+ embedUsage: string;
46
+ /** `dragon embed` の誤りの文 */
47
+ embed: { extraFiles: (extra: string[]) => string; noFile: (path: string) => string; unreadable: (path: string, detail: string) => string; noEntry: (path: string) => string };
39
48
  unknownOption: (name: string) => string;
40
49
  missingValue: (name: string) => string;
41
50
  extraFiles: (extra: string[]) => string;
@@ -64,6 +73,17 @@ const CLI_TEXT: Record<NotationLang, CliText> = {
64
73
  " --gif-fps <数> GIF の 1 秒のコマの数 (既定 10)",
65
74
  " --format <形> 書き出す形を , で区切る (既定 mp4,gif,html,png)",
66
75
  ].join("\n"),
76
+ embedUsage: [
77
+ "使い方: dragon embed <HTML の file> [設定]",
78
+ " --out <file> 書き出す file (既定は元の file の隣の <名前>.offline.html)",
79
+ " --lang <言葉> 命令の文の言葉 (ja か en)。既定は en",
80
+ ].join("\n"),
81
+ embed: {
82
+ extraFiles: (extra) => `HTML の file は 1 つだけ渡す。余分な引数: ${extra.join(" ")}`,
83
+ noFile: (path) => `HTML の file が無い: ${path}`,
84
+ unreadable: (path, detail) => `HTML の file を読めない: ${path} (${detail})`,
85
+ noEntry: (path) => `入口の1行 (src が dist/cdn/dragon.js で終わる script) が無い: ${path}`,
86
+ },
67
87
  unknownOption: (name) => `知らない設定: ${name}`,
68
88
  missingValue: (name) => `設定に値が無い: ${name}`,
69
89
  extraFiles: (extra) => `図の file は 1 つだけ渡す。余分な引数: ${extra.join(" ")}`,
@@ -87,6 +107,17 @@ const CLI_TEXT: Record<NotationLang, CliText> = {
87
107
  " --gif-fps <n> Frames per second of the GIF (default 10)",
88
108
  " --format <list> Formats to write, separated by , (default mp4,gif,html,png)",
89
109
  ].join("\n"),
110
+ embedUsage: [
111
+ "Usage: dragon embed <HTML file> [options]",
112
+ " --out <file> Where to write (default: <name>.offline.html next to the file)",
113
+ " --lang <lang> Language of the command messages (ja or en). Defaults to en",
114
+ ].join("\n"),
115
+ embed: {
116
+ extraFiles: (extra) => `Pass only one HTML file. Extra arguments: ${extra.join(" ")}`,
117
+ noFile: (path) => `No such HTML file: ${path}`,
118
+ unreadable: (path, detail) => `Cannot read the HTML file: ${path} (${detail})`,
119
+ noEntry: (path) => `No entry line (a script whose src ends with dist/cdn/dragon.js): ${path}`,
120
+ },
90
121
  unknownOption: (name) => `Unknown option: ${name}`,
91
122
  missingValue: (name) => `Option needs a value: ${name}`,
92
123
  extraFiles: (extra) => `Pass only one diagram file. Extra arguments: ${extra.join(" ")}`,
@@ -119,11 +150,11 @@ function langOf(args: string[]): string | undefined {
119
150
  * 設定の誤りを、Node の文ではなく命令の言葉で返す。誤りが無ければ `undefined`。
120
151
  * 値の要る設定の後ろに `-` で始まる語が続く時は、その語を値と取り違えずに値が無いとみなす (Node も同じ形を断る)。
121
152
  */
122
- function optionProblem(args: string[], text: CliText): string | undefined {
123
- const { tokens } = parseArgs({ args, options: OPTIONS, allowPositionals: true, strict: false, tokens: true });
153
+ function optionProblem(args: string[], text: CliText, options: typeof OPTIONS | typeof EMBED_OPTIONS = OPTIONS): string | undefined {
154
+ const { tokens } = parseArgs({ args, options, allowPositionals: true, strict: false, tokens: true });
124
155
  for (const token of tokens) {
125
156
  if (token.kind !== "option") continue;
126
- if (!Object.hasOwn(OPTIONS, token.name)) return text.unknownOption(token.rawName);
157
+ if (!Object.hasOwn(options, token.name)) return text.unknownOption(token.rawName);
127
158
  if (token.value === undefined || (!token.inlineValue && token.value.startsWith("-"))) return text.missingValue(token.rawName);
128
159
  }
129
160
  return undefined;
@@ -175,13 +206,54 @@ function read(file: string, text: CliText, lang: NotationLang): unknown {
175
206
  return parsed.diagram;
176
207
  }
177
208
 
209
+ /** `dragon embed <HTML の file>`。埋めた1 file を書き、その path を出す (#3343) */
210
+ function embed(args: string[], text: CliText): number {
211
+ const problem = optionProblem(args, text, EMBED_OPTIONS);
212
+ if (problem !== undefined) {
213
+ console.error(`${problem}\n${text.embedUsage}`);
214
+ return 2;
215
+ }
216
+ const { values, positionals } = parseArgs({ args, options: EMBED_OPTIONS, allowPositionals: true });
217
+ if (values.lang !== undefined && !isLang(values.lang)) {
218
+ console.error(`${text.badValue("--lang", values.lang, text.allowed.lang)}\n${text.embedUsage}`);
219
+ return 2;
220
+ }
221
+ const [file, ...extra] = positionals;
222
+ if (!file) {
223
+ console.error(text.embedUsage);
224
+ return 2;
225
+ }
226
+ if (extra.length > 0) {
227
+ console.error(`${text.embed.extraFiles(extra)}\n${text.embedUsage}`);
228
+ return 2;
229
+ }
230
+ let html: string;
231
+ try {
232
+ html = readFileSync(file, "utf8");
233
+ } catch (error) {
234
+ const missing = error instanceof Error && "code" in error && error.code === "ENOENT";
235
+ throw new Error(missing ? text.embed.noFile(file) : text.embed.unreadable(file, detail(error)));
236
+ }
237
+ const page = embedPage(html);
238
+ if (page === undefined) throw new Error(text.embed.noEntry(file));
239
+ const out = resolve(values.out ?? join(dirname(file), `${basename(file, extname(file))}.offline.html`));
240
+ try {
241
+ writeFileSync(out, page);
242
+ } catch (error) {
243
+ throw new Error(text.cannotWrite(out, detail(error)));
244
+ }
245
+ console.log(out);
246
+ return 0;
247
+ }
248
+
178
249
  async function main(argv: string[]): Promise<number> {
179
250
  const [command, ...rest] = argv;
180
251
  const chosen = langOf(argv);
181
252
  // file を読む前の文は、渡した言葉か既定の英語で出す。知らない言葉は英語の使い方で断る
182
253
  const early = CLI_TEXT[isLang(chosen) ? chosen : DEFAULT_LANG];
254
+ if (command === "embed") return embed(rest, early);
183
255
  if (command !== "export") {
184
- console.error(early.usage);
256
+ console.error(`${early.usage}\n\n${early.embedUsage}`);
185
257
  return 2;
186
258
  }
187
259
  const problem = optionProblem(rest, early);
@@ -0,0 +1,26 @@
1
+ /**
2
+ * `dragon embed` が書く、外へ通信しない1 file の HTML (#3343)。
3
+ *
4
+ * 頁の入口の1行 (src が `dist/cdn/dragon.js` で終わる script) を、全ての種類の部品を束ねた script の中身に置き換える。
5
+ * 埋めた script は字の CSS を読まないので、図は端末の字で描く。記法の塊と、頁のほかの部分は書いたまま残す。
6
+ */
7
+ import { readFileSync } from "node:fs";
8
+
9
+ /** 埋める script。build で `script-offline.ts` を 1 file に束ねた物 */
10
+ const OFFLINE = new URL("./offline.global.js", import.meta.url);
11
+
12
+ /** 入口の1行。jsDelivr のほか、手元や別の置き場の写しを読む行も同じに扱う */
13
+ const ENTRY_LINE = /<script\b[^>]*\bsrc\s*=\s*(["'])[^"']*\/dist\/cdn\/dragon\.js\1[^>]*>\s*<\/script\s*>/giu;
14
+
15
+ /** 入口の1行を埋めた script に置き換えた HTML。1行が無ければ `undefined`。2行目からは同じ script を2度回さないよう消す */
16
+ export function embedPage(html: string): string | undefined {
17
+ if (html.search(ENTRY_LINE) < 0) return undefined;
18
+ // `</script>` で script が途切れないよう、書き出しの頁と同じく逃がす
19
+ const script = readFileSync(OFFLINE, "utf8").replace(/<\/script/giu, "<\\/script");
20
+ let first = true;
21
+ return html.replace(ENTRY_LINE, () => {
22
+ if (!first) return "";
23
+ first = false;
24
+ return `<script>${script}</script>`;
25
+ });
26
+ }
@@ -0,0 +1,70 @@
1
+ /**
2
+ * 頁に置いた記法の塊 (`<pre class="dragon">`) を動く図に置き換える (#3343)。script の1行の入口と、`dragon embed` が埋める script が共に使う。
3
+ *
4
+ * 塊の字から共通の字下げを外して記法として読み、塊を図の枠 (`<div class="dragon-figure">`) に置き換えて描く。
5
+ * 記法に誤りがある塊は図にせず、誤りの文を行ごとに並べた `<pre class="dragon-error">` に置き換える。
6
+ * 言葉は頁の `lang` 属性が `ja` で始まれば日本語、ほかは英語にする。図の中の字と誤りの文の両方に使う。
7
+ * 頁を読み終えた時に在る塊だけを描き、後から足した塊は見張らない。
8
+ */
9
+ import { parseNotation } from "./parser";
10
+ import { mountDiagram } from "./player";
11
+ import type { NotationLang } from "./words";
12
+
13
+ const detail = (error: unknown): string => (error instanceof Error ? error.message : String(error));
14
+
15
+ /** 塊の字から、空でない行に共通の字下げを外す。入れ子の HTML の中で書いた塊は、全ての行に同じ字下げが付くため */
16
+ function dedent(text: string): string {
17
+ const lines = text.split("\n");
18
+ const indents = lines.filter((line) => line.trim() !== "").map((line) => /^[ \t]*/u.exec(line)?.[0].length ?? 0);
19
+ const cut = indents.length === 0 ? 0 : Math.min(...indents);
20
+ return lines.map((line) => line.slice(cut)).join("\n");
21
+ }
22
+
23
+ /** 誤りの文を行ごとに並べた要素。読み上げにも誤りと伝える。誤りの文は使える語を並べて長くなるので、枠の幅で折り返して頁の横へはみ出させない */
24
+ function errorBox(doc: Document, lines: string[]): HTMLElement {
25
+ const box = doc.createElement("pre");
26
+ box.className = "dragon-error";
27
+ box.setAttribute("role", "alert");
28
+ box.style.whiteSpace = "pre-wrap";
29
+ box.style.overflowWrap = "anywhere";
30
+ box.textContent = lines.join("\n");
31
+ return box;
32
+ }
33
+
34
+ async function drawBlock(block: Element, prepare: (text: string) => Promise<void>, lang: NotationLang): Promise<void> {
35
+ const doc = block.ownerDocument;
36
+ const text = dedent(block.textContent ?? "");
37
+ try {
38
+ await prepare(text);
39
+ } catch (error) {
40
+ block.replaceWith(errorBox(doc, [detail(error)]));
41
+ return;
42
+ }
43
+ const parsed = parseNotation(text, { lang });
44
+ if (!parsed.ok) {
45
+ block.replaceWith(errorBox(doc, parsed.errors.map((error) => `${error.line}: ${error.message}`)));
46
+ return;
47
+ }
48
+ // 図は枠の幅で見せ方を選ぶので、枠を頁に置いてから描く
49
+ const host = doc.createElement("div");
50
+ host.className = "dragon-figure";
51
+ block.replaceWith(host);
52
+ try {
53
+ mountDiagram(host, parsed.diagram, { lang });
54
+ } catch (error) {
55
+ host.replaceWith(errorBox(doc, [detail(error)]));
56
+ }
57
+ }
58
+
59
+ /**
60
+ * 頁の記法の塊を全て図に置き換える。`prepare` は記法を読む前に待ち、その記法が使う部品を読む。
61
+ * 頁を読み終える前に呼ばれた時は、読み終えてから置き換える
62
+ */
63
+ export function drawPageBlocks(doc: Document, prepare: (text: string) => Promise<void>): void {
64
+ const lang: NotationLang = doc.documentElement.lang.toLowerCase().startsWith("ja") ? "ja" : "en";
65
+ const draw = (): void => {
66
+ for (const block of doc.querySelectorAll("pre.dragon")) void drawBlock(block, prepare, lang);
67
+ };
68
+ if (doc.readyState === "loading") doc.addEventListener("DOMContentLoaded", draw, { once: true });
69
+ else draw();
70
+ }
@@ -0,0 +1,19 @@
1
+ /**
2
+ * script の1行の入口の案内役 (#3375)。build で `dist/cdn/dragon.js` になり、頁が `<script type="module">` で読む。
3
+ *
4
+ * jsDelivr は版の範囲の URL (`@0.50`) を file ごとに解き、応答を browser に7日残す。
5
+ * 入口が塊を相対の場所で読むと、修正版を出した後に残った入口が新しい版へ解かれた場所へ塊を取りに行き、名前の変わった塊が 404 になる。
6
+ * 案内役は自分の版を全て書いた場所 (`@0.50.1` など) から本体 `dragon-main.js` を読むので、本体と本体が読む塊は全て案内役と同じ版になる。
7
+ * URL が `/@cardenelabs/dragon@<版>/` を含まない置き場 (自分の server など) では、隣の本体を読む。
8
+ *
9
+ * 案内役は何も import しない。import すると、その部品が範囲の場所からの相対で読まれる。
10
+ */
11
+
12
+ /** この file の版。build が package の版を入れる (`tsup.config.ts`) */
13
+ declare const __DRAGON_VERSION__: string;
14
+
15
+ /** URL の中の package の名前と版の部分 */
16
+ const PACKAGE_AT_VERSION = /\/@cardenelabs\/dragon@[^/]+\//u;
17
+
18
+ const pinned = import.meta.url.replace(PACKAGE_AT_VERSION, `/@cardenelabs/dragon@${__DRAGON_VERSION__}/`);
19
+ await import(new URL("dragon-main.js", pinned).href);
@@ -0,0 +1,11 @@
1
+ /**
2
+ * `dragon embed` が頁に埋める script の入口 (#3343)。build で依存ごと `dist/offline.global.js` の1 file に束ねる。
3
+ *
4
+ * 埋めた頁は外を読めないので、全ての図の種類の部品を持ち、字の CSS も読まない (図は端末の字で描く)。
5
+ * 頁の記法の塊を図に置き換える処理は、script の1行の入口と同じ物を使う。
6
+ */
7
+ import "./kinds/all";
8
+
9
+ import { drawPageBlocks } from "./page-blocks";
10
+
11
+ drawPageBlocks(document, () => Promise.resolve());
package/src/script.ts ADDED
@@ -0,0 +1,32 @@
1
+ /**
2
+ * script の1行の入口の本体 (#3343)。build で `dist/cdn/dragon-main.js` になり、頁は jsDelivr から ES module として読む。
3
+ * 頁が読む `dist/cdn/dragon.js` は案内役 (`script-loader.ts`) で、自分と同じ版の場所からこの本体を読む (#3375)。
4
+ *
5
+ * ```html
6
+ * <script type="module" src="https://cdn.jsdelivr.net/npm/@cardenelabs/dragon@<版>/dist/cdn/dragon.js"></script>
7
+ * <pre class="dragon">sequence ...</pre>
8
+ * ```
9
+ *
10
+ * 読み込むと、図の字の CSS を jsDelivr から読む `<link>` を頁に1度だけ足し、頁の記法の塊を図に置き換える。
11
+ * 描く部品は軽い入口 (`light.ts`) と同じく、書いた図の種類の部品と使う個別ブロックだけを後から読む。
12
+ */
13
+ import { loadFor } from "./light";
14
+ import { drawPageBlocks } from "./page-blocks";
15
+
16
+ /** 図の字の package と版。build が依存の版を入れる (`tsup.config.ts`) */
17
+ declare const __DRAGON_FONT_VERSIONS__: Readonly<Record<string, string>>;
18
+
19
+ /** 図の字の CSS を読む `<link>` を足す。同じ CSS を読む `<link>` が頁に在れば足さない */
20
+ function addFontLinks(doc: Document): void {
21
+ for (const [name, version] of Object.entries(__DRAGON_FONT_VERSIONS__)) {
22
+ const href = `https://cdn.jsdelivr.net/npm/@fontsource-variable/${name}@${version}/index.css`;
23
+ if ([...doc.querySelectorAll("link")].some((link) => link.getAttribute("href") === href)) continue;
24
+ const link = doc.createElement("link");
25
+ link.rel = "stylesheet";
26
+ link.href = href;
27
+ doc.head.append(link);
28
+ }
29
+ }
30
+
31
+ addFontLinks(document);
32
+ drawPageBlocks(document, loadFor);