@curio-sd/e-module-builder 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 Curio Software Developer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/bin/cli.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { fileURLToPath, pathToFileURL } from 'url'
+import path from 'path'
+import { cpSync, existsSync, watch } from 'fs'
+import { spawn, spawnSync } from 'child_process'
+
+const PKG_DIR = path.dirname(path.dirname(fileURLToPath(import.meta.url)))
+const PROJECT_DIR = process.cwd()
+const command = process.argv[2]
+
+if (!command || !['build', 'dev', 'preview'].includes(command)) {
+  console.error('Usage: e-module-builder <build|dev|preview>')
+  process.exit(1)
+}
+
+function copyAssets() {
+  for (const dir of ['js', 'css', 'partials']) {
+    const src = path.join(PKG_DIR, 'src', dir)
+    if (existsSync(src)) {
+      cpSync(src, path.join(PROJECT_DIR, 'src', dir), { recursive: true })
+    }
+  }
+}
+
+const PIPELINE_ENV = { ...process.env, E_MODULE_PROJECT_DIR: PROJECT_DIR, E_MODULE_PKG_DIR: PKG_DIR }
+const PIPELINE_ARGS = [path.join(PKG_DIR, 'build.mjs')]
+
+function runContentPipeline() {
+  const result = spawnSync(process.execPath, PIPELINE_ARGS, { cwd: PROJECT_DIR, stdio: 'inherit', env: PIPELINE_ENV })
+  if (result.status !== 0) process.exit(result.status ?? 1)
+}
+
+function runContentPipelineAsync() {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, PIPELINE_ARGS, { cwd: PROJECT_DIR, stdio: 'inherit', env: PIPELINE_ENV })
+    child.on('close', code => code === 0 ? resolve() : reject(new Error(`build.mjs exited with code ${code}`)))
+  })
+}
+
+async function main() {
+  if (command === 'preview') {
+    const { preview } = await import('vite')
+    const server = await preview({
+      root: PROJECT_DIR,
+      build: { outDir: path.join(PROJECT_DIR, 'dist') },
+    })
+    server.printUrls()
+    return
+  }
+
+  copyAssets()
+  runContentPipeline()
+
+  const { createConfig } = await import(pathToFileURL(path.join(PKG_DIR, 'vite.config.js')).href)
+  const cfg = createConfig({ projectDir: PROJECT_DIR, pkgDir: PKG_DIR })
+
+  if (command === 'build') {
+    const { build } = await import('vite')
+    await build(cfg)
+  } else {
+    const { createServer } = await import('vite')
+    const server = await createServer(cfg)
+    await server.listen()
+    server.printUrls()
+
+    const contentDir = path.join(PROJECT_DIR, 'content')
+    let rebuildTimer = null
+    watch(contentDir, { recursive: true }, () => {
+      clearTimeout(rebuildTimer)
+      rebuildTimer = setTimeout(async () => {
+        try {
+          await runContentPipelineAsync()
+          server.ws.send({ type: 'full-reload' })
+        } catch {
+          // build.mjs already printed the error
+        }
+      }, 80)
+    })
+    console.log(`\n  watching content/`)
+  }
+}
+
+main().catch(e => { console.error(e); process.exit(1) })

package/build.mjs

@@ -0,0 +1,339 @@
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import matter from 'gray-matter'
+import { Marked } from 'marked'
+import { markedHighlight } from "marked-highlight";
+import hljs from 'highlight.js';
+
+const PKG_DIR = path.dirname(fileURLToPath(import.meta.url))
+const PROJECT_DIR = process.env.E_MODULE_PROJECT_DIR ?? process.cwd()
+const CONTENT = path.join(PROJECT_DIR, 'content')
+const SRC_DATA = path.join(PROJECT_DIR, 'src/data')
+const PAGES = path.join(PROJECT_DIR, 'pages')
+const TEMPLATES = path.join(PKG_DIR, 'templates/pages')
+
+const marked = new Marked(
+  markedHighlight({
+    emptyLangClass: 'hljs',
+    langPrefix: 'hljs language-',
+    highlight(code, lang, info) {
+      const language = hljs.getLanguage(lang) ? lang : 'plaintext';
+      return hljs.highlight(code, { language }).value;
+    }
+  })
+)
+
+// ─── helpers ────────────────────────────────────────────────────────────────
+
+function readMd(filePath) {
+  const raw = fs.readFileSync(filePath, 'utf8')
+  return matter(raw)
+}
+
+function writeJson(dir, filename, data) {
+  fs.mkdirSync(dir, { recursive: true })
+  fs.writeFileSync(path.join(dir, filename), JSON.stringify(data, null, 2))
+}
+
+function applyTemplate(tpl, vars) {
+  return Object.entries(vars).reduce(
+    (str, [k, v]) => str.replace(new RegExp(`\\{\\{\\s*${k}\\s*\\}\\}`, 'g'), v),
+    tpl
+  )
+}
+
+// Recognize <x-*> tags as block-level elements so marked doesn't wrap them in <p>.
+marked.use({
+  extensions: [{
+    name: 'customElement',
+    level: 'block',
+    start(src) { return src.indexOf('<x-') },
+    tokenizer(src) {
+      const match = /^<(x-[a-z-]+)([^>]*)>([\s\S]*?)<\/\1>/.exec(src)
+      if (match) {
+        return { type: 'customElement', raw: match[0], tag: match[1], attrs: match[2].trim(), html: match[3] }
+      }
+    },
+    renderer(token) {
+      return `<${token.tag}${token.attrs ? ' ' + token.attrs : ''}>${marked.parse(token.html)}</${token.tag}>\n`
+    },
+  }],
+})
+
+// ─── 1. parse module.md ─────────────────────────────────────────────────────
+
+const moduleMd = readMd(path.join(CONTENT, 'module.md'))
+const mod = moduleMd.data
+
+// ─── 2. discover week directories ────────────────────────────────────────────
+
+const weekDirs = fs
+  .readdirSync(CONTENT)
+  .filter(d => /^week\d+$/.test(d) && fs.statSync(path.join(CONTENT, d)).isDirectory())
+  .sort((a, b) => parseInt(a.slice(4)) - parseInt(b.slice(4)))
+
+const weekCount = mod.weeks > 0 ? mod.weeks : weekDirs.length
+const activeWeeks = weekDirs.slice(0, weekCount)
+
+// ─── 3. process each week ────────────────────────────────────────────────────
+
+const weeksData = []
+
+for (const weekDir of activeWeeks) {
+  const weekNum = parseInt(weekDir.slice(4))
+  const dir = path.join(CONTENT, weekDir)
+
+  // theory.md → src/data/theory-weekN.json
+  const theoryMd = readMd(path.join(dir, 'theory.md'))
+  const theoryOut = {
+    week: theoryMd.data.week ?? weekNum,
+    title: theoryMd.data.title,
+    goal: theoryMd.data.goal,
+    accent: theoryMd.data.accent,
+    html: marked.parse(theoryMd.content ?? ''),
+  }
+  writeJson(SRC_DATA, `theory-week${weekNum}.json`, theoryOut)
+
+  // quiz.md → src/data/tussentoets-weekN.json
+  const quizMd = readMd(path.join(dir, 'quiz.md'))
+  const quizOut = {
+    title: quizMd.data.title,
+    passScore: quizMd.data.passScore ?? 70,
+    questions: quizMd.data.questions ?? [],
+  }
+  writeJson(SRC_DATA, `tussentoets-week${weekNum}.json`, quizOut)
+
+  // exercises/ subfolder → src/data/exercises/weekN.json
+  const exDir = path.join(dir, 'exercises')
+  const metaMd = readMd(path.join(exDir, '_meta.md'))
+  const exerciseFiles = fs.readdirSync(exDir)
+    .filter(f => f.endsWith('.md') && f !== '_meta.md')
+    .sort((a, b) => parseInt(a) - parseInt(b))
+  const exercises = exerciseFiles.map(f => {
+    const ex = readMd(path.join(exDir, f)).data
+    if (!ex.type || ex.type === 'text') {
+      ex.descriptionHtml = marked.parse(ex.description ?? '')
+    }
+    return ex
+  })
+  const exOut = {
+    week: metaMd.data.week ?? weekNum,
+    title: metaMd.data.title,
+    color: metaMd.data.color,
+    ...(metaMd.data.mode ? { mode: metaMd.data.mode } : {}),
+    exercises,
+  }
+  writeJson(path.join(SRC_DATA, 'exercises'), `week${weekNum}.json`, exOut)
+
+  // assignment.md → src/data/inleveropdracht-weekN.json
+  const hwMd = readMd(path.join(dir, 'assignment.md'))
+  const hwBody = hwMd.content.trim()
+  const hwParas = hwBody.split(/\n\n+/)
+  const hwOut = {
+    week: hwMd.data.week ?? weekNum,
+    title: hwMd.data.title,
+    subtitle: hwMd.data.subtitle ?? '',
+    client: hwMd.data.client ?? '',
+    case: hwParas[0] ?? '',
+    assignment: hwParas.slice(1).join('\n\n'),
+    deliverables: hwMd.data.deliverables ?? [],
+    criteria: hwMd.data.criteria ?? [],
+    maxPoints: hwMd.data.maxPoints ?? 0,
+    tips: hwMd.data.tips ?? [],
+  }
+  writeJson(SRC_DATA, `inleveropdracht-week${weekNum}.json`, hwOut)
+
+  weeksData.push({
+    week: weekNum,
+    title: theoryMd.data.title,
+    summary: theoryMd.data.summary ?? '',
+    goal: theoryMd.data.goal,
+    leeruitkomsten: theoryMd.data.leeruitkomsten ?? [],
+    color: theoryMd.data.accent,
+    pages: [
+      { key: 'theorie', href: `/pages/week${weekNum}-theorie.html`, label: 'Theorie' },
+      { key: 'oefeningen', href: `/pages/week${weekNum}-oefeningen.html`, label: 'Oefeningen' },
+      { key: 'toets', href: `/pages/week${weekNum}-toets.html`, label: 'Tussentoets' },
+      { key: 'oefening', href: `/pages/week${weekNum}-oefening.html`, label: 'Oefening' },
+      { key: 'inleveropdracht', href: `/pages/week${weekNum}-inleveropdracht.html`, label: 'Inleveropdracht' },
+    ],
+  })
+}
+
+// ─── 4. manifest.json ────────────────────────────────────────────────────────
+
+const manifest = {
+  module: {
+    name: mod.name,
+    subtitle: mod.subtitle ?? 'E-module',
+    youtube: mod.youtube ?? null,
+    weeks: weekCount,
+    language: mod.language ?? 'nl',
+    description: mod.description ?? '',
+    logoAlt: mod.logoAlt ?? mod.name,
+    exerciseMode: mod.exerciseMode ?? 'external',
+  },
+  weeks: weeksData,
+  nav: {
+    home: { href: '/index.html', label: 'Home' },
+    weeks: weeksData.map(wk => ({
+      label: `Week ${wk.week}`,
+      title: wk.title,
+      children: [
+        { href: `/pages/week${wk.week}-theorie.html`, label: 'Theorie' },
+        { href: `/pages/week${wk.week}-oefeningen.html`, label: 'Oefeningen' },
+        { href: `/pages/week${wk.week}-toets.html`, label: 'Tussentoets' },
+        { href: `/pages/week${wk.week}-inleveropdracht.html`, label: 'Inleveropdracht' },
+      ],
+    })),
+    examPages: [
+      { href: '/pages/checklist.html', label: 'Checklist' },
+      { href: '/pages/toets-theorie.html', label: 'Eindtoets theorie' },
+      { href: '/pages/toets-praktijk.html', label: 'Eindtoets praktijk' },
+    ],
+  },
+  pages: {
+    static: [
+      'index.html',
+      'pages/checklist.html',
+      'pages/toets-theorie.html',
+      'pages/toets-praktijk.html',
+    ],
+    week: weeksData.flatMap(wk => [
+      `pages/week${wk.week}-theorie.html`,
+      `pages/week${wk.week}-oefeningen.html`,
+      `pages/week${wk.week}-toets.html`,
+      `pages/week${wk.week}-oefening.html`,
+      `pages/week${wk.week}-inleveropdracht.html`,
+    ]),
+  },
+  content: {
+    status: 'generated',
+    aiInstructions: mod.aiInstructions ?? '',
+  },
+}
+
+writeJson(SRC_DATA, 'manifest.json', manifest)
+
+// ─── 5. checklist.json ───────────────────────────────────────────────────────
+
+const checklistGroups = weeksData.map(wk => ({
+  id: `week${wk.week}`,
+  title: `Week ${wk.week} — ${wk.title}`,
+  color: wk.color,
+  items: (wk.leeruitkomsten ?? []).map((text, i) => ({
+    id: `week${wk.week}-item-${i}`,
+    text,
+  })),
+}))
+
+if (mod.algemeen?.length) {
+  checklistGroups.push({
+    id: 'algemeen',
+    title: 'Algemeen',
+    color: 'slate',
+    items: mod.algemeen.map((text, i) => ({ id: `algemeen-item-${i}`, text })),
+  })
+}
+
+writeJson(SRC_DATA, 'checklist.json', { groups: checklistGroups })
+
+// ─── 5b. exam data files (optional content/exams/*.md, else empty placeholder) ─
+
+function buildExamData(filePath, fallbackTitle) {
+  if (fs.existsSync(filePath)) {
+    const md = readMd(filePath)
+    return {
+      title: md.data.title ?? fallbackTitle,
+      passScore: md.data.passScore ?? 70,
+      questions: md.data.questions ?? [],
+    }
+  }
+  return { title: fallbackTitle, passScore: 70, questions: [] }
+}
+
+const EXAMS_DIR = path.join(CONTENT, 'exams')
+writeJson(
+  SRC_DATA,
+  'toets-theorie.json',
+  buildExamData(path.join(EXAMS_DIR, 'theory-exam.md'), `Eindtoets theorie — ${mod.name}`)
+)
+writeJson(
+  SRC_DATA,
+  'toets-praktijk.json',
+  buildExamData(path.join(EXAMS_DIR, 'practical-exam.md'), `Eindtoets praktijk — ${mod.name}`)
+)
+
+// ─── 6. generate per-week page stubs ─────────────────────────────────────────
+
+const PAGE_TYPES = [
+  {
+    tplFile: 'theorie.html',
+    suffix: 'theorie',
+    pageTitle: wk => `Theorie Week ${wk.week} — ${wk.title}`,
+  },
+  {
+    tplFile: 'toets.html',
+    suffix: 'toets',
+    pageTitle: wk => `Tussentoets Week ${wk.week} — ${wk.title}`,
+  },
+  {
+    tplFile: 'oefeningen.html',
+    suffix: 'oefeningen',
+    pageTitle: wk => `Oefeningen Week ${wk.week} — ${wk.title}`,
+  },
+  {
+    tplFile: 'oefening.html',
+    suffix: 'oefening',
+    pageTitle: wk => `Oefening — Week ${wk.week}`,
+  },
+  {
+    tplFile: 'inleveropdracht.html',
+    suffix: 'inleveropdracht',
+    pageTitle: wk => `Inleveropdracht Week ${wk.week} — ${wk.title}`,
+  },
+]
+
+fs.mkdirSync(PAGES, { recursive: true })
+
+for (const { tplFile, suffix, pageTitle } of PAGE_TYPES) {
+  const tpl = fs.readFileSync(path.join(TEMPLATES, tplFile), 'utf8')
+  for (const wk of weeksData) {
+    const out = applyTemplate(tpl, {
+      week: String(wk.week),
+      weekPadded: String(wk.week).padStart(2, '0'),
+      weekTitle: wk.title,
+      pageTitle: pageTitle(wk),
+    })
+    fs.writeFileSync(path.join(PAGES, `week${wk.week}-${suffix}.html`), out)
+  }
+}
+
+// ─── 7. copy static pages (checklist, exams) with title substitution ─────────
+
+const STATIC_PAGES = [
+  { src: 'checklist.html', pageTitle: `Checklist — ${mod.name}` },
+  { src: 'toets-theorie.html', pageTitle: `Eindtoets theorie — ${mod.name}` },
+  { src: 'toets-praktijk.html', pageTitle: `Eindtoets praktijk — ${mod.name}` },
+]
+
+for (const { src, pageTitle } of STATIC_PAGES) {
+  const tpl = fs.readFileSync(path.join(TEMPLATES, src), 'utf8')
+  const out = applyTemplate(tpl, { pageTitle })
+  fs.writeFileSync(path.join(PAGES, src), out)
+}
+
+// ─── 8. copy content/*.html files verbatim to pages/ ─────────────────────────
+
+const htmlFiles = fs.readdirSync(CONTENT).filter(f => f.endsWith('.html'))
+for (const f of htmlFiles) {
+  fs.copyFileSync(path.join(CONTENT, f), path.join(PAGES, f))
+}
+
+// ─── 8b. generate index.html from template ───────────────────────────────────
+
+const indexTpl = fs.readFileSync(path.join(PKG_DIR, 'templates/index.html'), 'utf8')
+fs.writeFileSync(path.join(PROJECT_DIR, 'index.html'), applyTemplate(indexTpl, { pageTitle: mod.name }))
+
+console.log(`Build complete: ${weekCount} weeks → src/data/ and pages/`)

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@curio-sd/e-module-builder",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "A tool for building e-modules for Curio SD",
+  "license": "MIT",
+  "main": "./bin/cli.js",
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "public",
+    "build.mjs",
+    "vite.config.js",
+    "vite-plugin-html-includes.js"
+  ],
+  "bin": {
+    "e-module-builder": "./bin/cli.js"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.1.8",
+    "gray-matter": "^4.0.3",
+    "marked": "^18.0.5",
+    "monaco-editor": "^0.55.1",
+    "tailwindcss": "^4.1.8",
+    "vite": "^6.3.5",
+    "yaml": "^2.9.0"
+  }
+}