chalk-talk 0.6.0 → 0.7.0

package/scripts/build.mjs

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 // Checks chalk-talk recipes and turns them into one HTML file that plays the lesson — or, given several, a course: one
-// file with every lesson and a list to go from one to another.
+// file with every lesson and a list to go from one to another. A recipe can be JSON (.json), text (.chalk), a Mermaid
+// flowchart (.mmd, with `%% # chapter` and `%% > narration`), or Markdown (.md): each ```chalk-talk or ```mermaid block
+// in it is a lesson.
 //
-//   node build.mjs <recipe.json> [out.html] [--no-review]
-//   node build.mjs <one.json> <two.json> … --out course.html [--title "The course"] [--no-review]
+//   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]
 //
 // 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
@@ -13,7 +15,7 @@ import { readFileSync, statSync, writeFileSync } from 'node:fs'
 import { basename, dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { runPage } from './browser.mjs'
-import { chaptersFor, validateScene } from './contract.mjs'
+import { ChalkTextError, chaptersFor, parseChalk, PROP_ALIASES, PROP_NAMES, validateScene } from './contract.mjs'
 
 const here = dirname(fileURLToPath(import.meta.url))
 const argv = process.argv.slice(2)
@@ -24,26 +26,45 @@ 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 sources = args.filter((a) => a.endsWith('.json'))
+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) => !a.endsWith('.json') && !a.endsWith('.html')) || (outArg && !outArg.endsWith('.html')) || (sources.length > 1 && !outArg)) {
+if (!sources.length || args.some((a) => !KINDS.some((k) => a.endsWith(k)) && !a.endsWith('.html')) || (outArg && !outArg.endsWith('.html'))) {
   console.error(usage)
   process.exit(2)
 }
 
+const PROPS = [...PROP_NAMES, ...Object.keys(PROP_ALIASES)]
+// The Mermaid converter is large: loaded only for a Mermaid block.
+const mermaid = async (text) => (await import('./mermaid.mjs')).fromMermaid(text)
+
+/** The recipes a file holds: one for .json, .chalk and .mmd; one per ```chalk-talk / ```mermaid block in a .md. */
+async function recipesOf(file) {
+  const text = readFileSync(resolve(file), 'utf8')
+  if (file.endsWith('.json')) return [JSON.parse(text)]
+  if (file.endsWith('.chalk')) return [parseChalk(text, PROPS)]
+  if (file.endsWith('.mmd')) return [await mermaid(text)]
+  const blocks = [...text.matchAll(/^```(chalk-talk|mermaid)[^\n]*\n([\s\S]*?)^```/gm)]
+  if (!blocks.length) throw new Error('no ```chalk-talk or ```mermaid block in this file.')
+  const out = []
+  for (const [, kind, body] of blocks) out.push(kind === 'mermaid' ? await mermaid(body) : parseChalk(body, PROPS))
+  return out
+}
+
 const scenes = []
 for (const file of sources) {
   try {
-    scenes.push(validateScene(JSON.parse(readFileSync(resolve(file), 'utf8'))))
+    for (const recipe of await recipesOf(file)) scenes.push(validateScene(recipe))
   } catch (e) {
-    console.error(`✗ contract: ${sources.length > 1 ? `${basename(file)}: ` : ''}${e.message}`)
+    const where = sources.length > 1 || file.endsWith('.md') ? `${basename(file)}: ` : ''
+    console.error(`✗ ${e instanceof ChalkTextError ? 'text' : 'contract'}: ${where}${e.message}`)
     process.exit(1)
   }
 }
 
 const course = scenes.length > 1
-const slug = String(scenes[0].id || basename(sources[0], '.json')).replace(/[^a-z0-9-]+/gi, '-').slice(0, 60) || 'drawing'
+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 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.