chalk-talk 0.7.0 → 0.9.0

package/scripts/build.mjs

@@ -6,12 +6,15 @@
 //
 //   node build.mjs <recipe.json|.chalk|.mmd|.md> [out.html] [--no-review]
 //   node build.mjs <one> <two> … --out course.html [--title "The course"] [--no-review]
+//   node build.mjs <recipe> [out.svg] --svg      an SVG that draws itself, with no script: it plays inside an <img>,
+//                                                in a README on GitHub too (one SVG per lesson, named by its id)
 //
-// Only a path ending in .html is ever written. Exit codes: 0 drawn and checked (or no browser to check with); 1 a recipe
-// breaks the contract (nothing written); 2 bad arguments; 3 drawn, but the reviewer found something to fix (off the
-// paper, text over text, a line across a text). Needs Node 18 or later and nothing else; the review uses Chrome,
-// Chromium or Edge when one is installed.
-import { readFileSync, statSync, writeFileSync } from 'node:fs'
+// Only paths ending in .html or .svg are ever written. Exit codes: 0 drawn and checked (or no browser to check with); 1 a
+// recipe breaks the contract (nothing written); 2 bad arguments; 3 drawn, but the reviewer found something to fix (off
+// the paper, text over text, a line across a text); 4 --svg with no browser to draw it in. Needs Node 18 or later and
+// nothing else; the review and --svg use Chrome, Chromium or Edge.
+import { mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
 import { basename, dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { runPage } from './browser.mjs'
@@ -26,11 +29,13 @@ const option = (name) => {
 const valued = new Set(['--out', '--title'])
 const args = argv.filter((a, i) => !a.startsWith('--') && !valued.has(argv[i - 1]))
 const noReview = argv.includes('--no-review')
+const asSvg = argv.includes('--svg')
+const ext = asSvg ? '.svg' : '.html'
 const KINDS = ['.json', '.chalk', '.mmd', '.md']
 const sources = args.filter((a) => KINDS.some((k) => a.endsWith(k)))
-const outArg = option('--out') ?? args.find((a) => a.endsWith('.html'))
-const usage = 'usage: node build.mjs <recipe.json> [out.html] [--no-review]\n       node build.mjs <one.json> <two.json> … --out course.html [--title "…"] [--no-review]'
-if (!sources.length || args.some((a) => !KINDS.some((k) => a.endsWith(k)) && !a.endsWith('.html')) || (outArg && !outArg.endsWith('.html'))) {
+const outArg = option('--out') ?? args.find((a) => a.endsWith(ext))
+const usage = 'usage: node build.mjs <recipe.json> [out.html] [--no-review]\n       node build.mjs <one.json> <two.json> … --out course.html [--title "…"] [--no-review]\n       node build.mjs <recipe.json> [out.svg] --svg'
+if (!sources.length || args.some((a) => !KINDS.some((k) => a.endsWith(k)) && !a.endsWith(ext)) || (outArg && !outArg.endsWith(ext))) {
   console.error(usage)
   process.exit(2)
 }
@@ -64,8 +69,11 @@ for (const file of sources) {
 }
 
 const course = scenes.length > 1
-const slug = String(scenes[0].id || basename(sources[0]).replace(/\.[^.]+$/, '')).replace(/[^a-z0-9-]+/gi, '-').slice(0, 60) || 'drawing'
-const out = resolve(outArg ?? join(dirname(resolve(sources[0])), `${slug}.html`))
+const slugOf = (scene, file) => String(scene.id || basename(file).replace(/\.[^.]+$/, '')).replace(/[^a-z0-9-]+/gi, '-').slice(0, 60) || 'drawing'
+const slug = slugOf(scenes[0], sources[0])
+// With --svg the page is only the browser's workbench: it goes to a folder of its own and away at the end.
+const work = asSvg ? mkdtempSync(join(tmpdir(), 'chalk-talk-svg-')) : undefined
+const out = work ? join(work, 'page.html') : resolve(outArg ?? join(dirname(resolve(sources[0])), `${slug}.html`))
 const content = course ? { course: option('--title') ?? scenes[0].title, lessons: scenes } : scenes[0]
 // JSON inside a <script> tag: "<" escaped so no text in a recipe can end the tag.
 const recipe = JSON.stringify(content).replace(/</g, '\\u003c')
@@ -96,5 +104,28 @@ else {
     }
   }
 }
-console.log(`→ ${out} (${Math.round(statSync(out).size / 1024)} KB, opens offline${course ? `, ${scenes.length} lessons` : ''})`)
+if (!asSvg) {
+  console.log(`→ ${out} (${Math.round(statSync(out).size / 1024)} KB, opens offline${course ? `, ${scenes.length} lessons` : ''})`)
+  process.exit(code)
+}
+
+// --svg: each lesson drawn by the browser with its timing as CSS; one file, or one per lesson beside the first source.
+const where = outArg && !course ? undefined : dirname(resolve(outArg ?? sources[0]))
+for (let k = 0; k < scenes.length; k++) {
+  const r = runPage(out, 'svg', course ? `lesson=${k + 1}` : '')
+  if (!r) {
+    console.error('✗ svg       no Chrome, Chromium or Edge here to draw it (set CHROME_PATH)')
+    code = 4
+    break
+  }
+  if (r.error) {
+    console.error(`✗ svg       ${r.error}`)
+    code = 4
+    break
+  }
+  const file = where ? join(where, `${slugOf(scenes[k], sources[0])}.svg`) : resolve(outArg)
+  writeFileSync(file, r.svg)
+  console.log(`→ ${file} (${Math.round(statSync(file).size / 1024)} KB, draws itself in ${Math.round(r.ms / 1000)} s)`)
+}
+rmSync(work, { recursive: true, force: true })
 process.exit(code)

package/scripts/contract.mjs

@@ -1,4 +1,4 @@
-// GENERATED by tools/assets.mjs from the drawing engine v0.243.2. Do not edit.
+// GENERATED by tools/assets.mjs from the drawing engine v0.244.1. Do not edit.
 var WORDS = ["and", "or", "not"];
 
 var PROP_NAMES = [