create-openclass-uniminuto 1.4.0

package/template/scripts/generar-desde-config.mjs

@@ -0,0 +1,279 @@
+/**
+ * Genera o actualiza una Open Class Slidev a partir de openclass.config.json.
+ *
+ * Uso principal:
+ *   npm run config
+ *   node scripts/generar-desde-config.mjs --config config/openclass.config.iot-ejemplo.json --force
+ */
+import fs from "node:fs";
+import path from "node:path";
+
+const args = process.argv.slice(2);
+
+function valueAfter(flag, fallback) {
+  const i = args.indexOf(flag);
+  if (i >= 0 && args[i + 1]) return args[i + 1];
+  const pair = args.find((arg) => arg.startsWith(`${flag}=`));
+  if (pair) return pair.slice(flag.length + 1);
+  return fallback;
+}
+
+const configPath = valueAfter("--config", "openclass.config.json");
+const force = args.includes("--force") || args.includes("-f");
+const dryRun = args.includes("--dry-run");
+
+function fail(message) {
+  console.error(`\n❌ ${message}\n`);
+  process.exit(1);
+}
+
+function readJson(filePath) {
+  if (!fs.existsSync(filePath)) fail(`No se encontró el archivo de configuración: ${filePath}`);
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch (error) {
+    fail(`No se pudo leer ${filePath}. Revisa que sea JSON válido.\n${error.message}`);
+  }
+}
+
+function ensureDir(dir) {
+  if (!dryRun) fs.mkdirSync(dir, { recursive: true });
+}
+
+function writeFileSafe(filePath, content, { overwrite = true, label = filePath } = {}) {
+  ensureDir(path.dirname(filePath));
+
+  if (fs.existsSync(filePath) && !overwrite) {
+    console.log(`⏭  Conservado: ${label}`);
+    return false;
+  }
+
+  if (!dryRun) fs.writeFileSync(filePath, content, "utf-8");
+  console.log(`${dryRun ? "🔎" : "✓"}  ${label}`);
+  return true;
+}
+
+function cleanShortName(value) {
+  return String(value || "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "")
+    .trim();
+}
+
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function replaceTokens(template, tokens) {
+  return Object.entries(tokens).reduce(
+    (content, [key, value]) => content.replaceAll(`{{${key}}}`, String(value ?? "")),
+    template,
+  );
+}
+
+function readTemplate(filePath, fallback) {
+  return fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : fallback;
+}
+
+function normalizeBase(value) {
+  let base = value || "/";
+  if (!base.startsWith("/")) base = `/${base}`;
+  if (!base.endsWith("/")) base = `${base}/`;
+  return base;
+}
+
+const config = readJson(configPath);
+const course = config.course || {};
+const generation = config.generation || {};
+
+const courseShort = cleanShortName(course.shortName || config.shortName || config.courseCode || "curso");
+const courseName = String(course.fullName || course.name || config.courseName || "Nombre del curso").trim();
+const courseYear = String(course.year || config.year || new Date().getFullYear()).trim();
+const description = String(course.description || config.description || "Agrega aquí la descripción general del curso.").trim();
+const openClassLabel = String(course.openClassLabel || "Open Class").trim();
+const weeksTotal = Number(generation.weeksTotal || config.weeksTotal || config.totalWeeks || asArray(config.weeks).length || 8);
+
+if (!courseShort) fail("El campo course.shortName es obligatorio.");
+if (!courseName) fail("El campo course.fullName es obligatorio.");
+if (!Number.isInteger(weeksTotal) || weeksTotal < 1) fail("generation.weeksTotal debe ser un número entero mayor o igual a 1.");
+
+const configuredWeeks = new Map(asArray(config.weeks).map((week) => [Number(week.number), week]));
+
+function weekInfo(number) {
+  const week = configuredWeeks.get(number) || {};
+  const title = String(week.title || `Título semana ${number}`).trim();
+  return {
+    number,
+    title,
+    date: String(week.date || courseYear).trim(),
+    centralTheme: String(week.centralTheme || week.theme || title).trim(),
+    activity: String(week.activity || "Actividad o evaluación relacionada").trim(),
+    duration: String(week.duration || "90 minutos").trim(),
+    status: String(week.status || "active").trim(),
+  };
+}
+
+const allWeeks = Array.from({ length: weeksTotal }, (_, i) => weekInfo(i + 1));
+const activeWeeksRaw = asArray(generation.activeWeeks || config.activeWeeks);
+const activeWeekNumbers = activeWeeksRaw.length
+  ? activeWeeksRaw.map(Number).filter((n) => Number.isInteger(n) && n >= 1 && n <= weeksTotal)
+  : allWeeks.filter((week) => week.status !== "draft" && week.status !== "inactive").map((week) => week.number);
+
+const activeWeeks = allWeeks.filter((week) => activeWeekNumbers.includes(week.number));
+const overwriteLaunchers = generation.overwriteLaunchers !== false || force;
+const overwritePortal = generation.overwritePortal !== false || force;
+const overwriteDecks = generation.overwriteDecks !== false || force;
+const overwritePackageScripts = generation.overwritePackageScripts !== false || force;
+const overwriteWeekContent = generation.overwriteWeekContent === true || force;
+const exportPortal = generation.exportPortal === true;
+
+const semanaTemplate = readTemplate(
+  "plantillas/semana.md",
+  `---\nlayout: slide-01-portada\n---\n\n::title::\n{{COURSE_NAME}}\n\n::week::\nSemana {{WEEK_NUMBER}} — {{WEEK_TITLE}}\n\n::date::\n{{WEEK_DATE}}\n\n---\nlayout: slide-12-cierre\n---\n`,
+);
+
+const launcherTemplate = readTemplate(
+  "plantillas/launcher.md",
+  `---\ntheme: ./theme/uniminuto\ntitle: {{COURSE_NAME}} — Semana {{WEEK_NUMBER}} — {{WEEK_TITLE}}\nfavicon: /favicon.png\ncodeCopy: true\ntransition: fade\nrouterMode: hash\ndrawings:\n  persist: false\nsrc: ./semanas/{{COURSE_SHORT}}_semana{{WEEK_NUMBER}}.md\n---\n`,
+);
+
+function weekTokens(week) {
+  return {
+    COURSE_SHORT: courseShort,
+    COURSE_NAME: courseName,
+    COURSE_YEAR: courseYear,
+    OPEN_CLASS_LABEL: openClassLabel,
+    WEEK_NUMBER: week.number,
+    WEEK_TITLE: week.title,
+    WEEK_DATE: week.date,
+    WEEK_THEME: week.centralTheme,
+    WEEK_ACTIVITY: week.activity,
+    WEEK_DURATION: week.duration,
+  };
+}
+
+function portalWeekItem(week) {
+  const slug = `${courseShort}_semana${week.number}`;
+  return `### **Semana ${week.number}**\n\n<a href="./semanas/${slug}/#/1" target="_self">${week.title}</a>\n\n<a href="./descargas/${slug}.pdf" download>Descargar PDF</a> · <a href="./descargas/${slug}.pptx" download>Descargar PPTX</a>`;
+}
+
+function buildPortal() {
+  const left = activeWeeks.length
+    ? activeWeeks.filter((_, index) => index < Math.ceil(activeWeeks.length / 2)).map(portalWeekItem).join("\n\n")
+    : "### Sin semanas activas\n\nEjecuta `npm run semana -- 1` para generar la primera semana.";
+  const right = activeWeeks.filter((_, index) => index >= Math.ceil(activeWeeks.length / 2)).map(portalWeekItem).join("\n\n") || "### Próximamente\n\nActiva más semanas con `npm run semana -- 2`, `npm run semana -- 3` y así sucesivamente.";
+
+  return `---\ntheme: ./theme/uniminuto\ntitle: ${courseName} — ${openClassLabel}\nfavicon: /favicon.png\ncodeCopy: true\ntransition: fade\nrouterMode: hash\ndrawings:\n  persist: false\nlayout: slide-01-portada\n---\n\n::title::\n${courseName}\n\n::week::\n${openClassLabel}\n\n::date::\n${courseYear}\n\n---\nlayout: slide-08-titulo-texto\n---\n\n::title::\nDescripción general del curso\n\n::content::\n${description}\n\n---\nlayout: slide-08-titulo-texto\n---\n\n::title::\nRuta de aprendizaje\n\n::content::\nEl curso se organiza en semanas. Cada semana cuenta con un lanzador raíz y un archivo interno en la carpeta \`semanas/\`.\n\nLas presentaciones activas se controlan desde \`openclass.config.json\` mediante el campo \`generation.activeWeeks\`.\n\n---\nlayout: slide-10-titulo-dos-columnas\n---\n\n::title::\nPresentaciones disponibles\n\n::left::\n${left}\n\n::right::\n${right}\n\n---\nlayout: slide-12-cierre\n---\n`;
+}
+
+function buildDecks() {
+  const entries = [
+    `function normalizeBase(value) {\n  let base = value || "/";\n  if (!base.startsWith("/")) base = \`/\${base}\`;\n  if (!base.endsWith("/")) base = \`\${base}/\`;\n  return base;\n}\n\nconst SITE_BASE = normalizeBase(process.env.SITE_BASE || "/");\n\nfunction withBase(path = "") {\n  return \`\${SITE_BASE}\${path.replace(/^\\/+/, "")}\`;\n}\n\nexport const decks = [\n  {\n    name: "openclass-${courseShort}",\n    entry: "slides.md",\n    out: "dist",\n    base: SITE_BASE,\n    exportable: ${exportPortal ? "true" : "false"},\n  },`,
+  ];
+
+  for (const week of activeWeeks) {
+    const slug = `${courseShort}_semana${week.number}`;
+    entries.push(`  {\n    name: "${slug}",\n    entry: "${slug}.md",\n    out: "dist/semanas/${slug}",\n    base: withBase("semanas/${slug}/"),\n    exportable: true,\n  },`);
+  }
+
+  entries.push(`];\n`);
+  return entries.join("\n");
+}
+
+function buildScripts() {
+  const scripts = {
+    dev: "slidev slides.md --open --port 3000",
+    config: "node scripts/generar-desde-config.mjs",
+    semana: "node scripts/semana.mjs",
+    "pages:check": "node scripts/preparar-github-pages.mjs",
+  };
+
+  for (let i = 1; i <= weeksTotal; i++) {
+    const slug = `${courseShort}_semana${i}`;
+    scripts[`dev:s${i}`] = `slidev ${slug}.md --open --port ${3000 + i}`;
+  }
+
+  scripts.clean = "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"";
+  scripts["clean:downloads"] = "node -e \"require('fs').rmSync('public/descargas',{recursive:true,force:true})\"";
+  scripts["clean:cache"] = "node -e \"require('fs').rmSync('.slidev',{recursive:true,force:true}); require('fs').rmSync('node_modules/.vite',{recursive:true,force:true})\"";
+  scripts["build:index"] = "slidev build slides.md --out dist --base / --without-notes";
+
+  for (let i = 1; i <= weeksTotal; i++) {
+    const slug = `${courseShort}_semana${i}`;
+    scripts[`build:s${i}`] = `slidev build ${slug}.md --out dist/semanas/${slug} --base /semanas/${slug}/ --without-notes`;
+  }
+
+  scripts["build:all"] = "node scripts/build-site.mjs";
+  scripts["build:incremental"] = "node scripts/build-incremental.mjs";
+  scripts["export:downloads"] = "node scripts/export-downloads.mjs";
+  scripts["export:incremental"] = "node scripts/export-incremental.mjs";
+  scripts.vista = "npm run clean && npm run export:downloads && npm run build:all && http-server dist -p 4173 -c-1 -o";
+  scripts.publicar = "node scripts/publicar.mjs";
+  scripts["dev:todo"] = "node scripts/dev-all.mjs";
+  scripts.nuevo = "node scripts/nuevo-curso.mjs";
+  scripts["zip:template"] = "node scripts/zip-template.mjs";
+  scripts["preview:static"] = "npm run build:all && http-server dist -p 4173 -c-1";
+  scripts["preview:pages"] = "npm run export:downloads && npm run build:all && http-server dist -p 4173 -c-1";
+  scripts["pages:build"] = "npm run export:downloads && npm run build:all";
+  scripts["pages:preview"] = "npm run preview:pages";
+
+  return scripts;
+}
+
+console.log("\n┌──────────────────────────────────────────────┐");
+console.log("│ Generador Open Class UNIMINUTO desde config │");
+console.log("└──────────────────────────────────────────────┘\n");
+console.log(`Configuración : ${configPath}`);
+console.log(`Curso         : ${courseName}`);
+console.log(`Nombre corto  : ${courseShort}`);
+console.log(`Semanas       : ${weeksTotal}`);
+console.log(`Activas       : ${activeWeeks.map((w) => w.number).join(", ") || "ninguna"}\n`);
+
+ensureDir("semanas");
+ensureDir("public/descargas");
+ensureDir("public/imagenes");
+ensureDir("public/videos");
+
+writeFileSafe("slides.md", buildPortal(), { overwrite: overwritePortal, label: "slides.md" });
+writeFileSafe("scripts/decks.mjs", buildDecks(), { overwrite: overwriteDecks, label: "scripts/decks.mjs" });
+
+for (const week of allWeeks) {
+  const slug = `${courseShort}_semana${week.number}`;
+  const tokens = weekTokens(week);
+  writeFileSafe(`${slug}.md`, replaceTokens(launcherTemplate, tokens), {
+    overwrite: overwriteLaunchers,
+    label: `${slug}.md`,
+  });
+  writeFileSafe(path.join("semanas", `${slug}.md`), replaceTokens(semanaTemplate, tokens), {
+    overwrite: overwriteWeekContent,
+    label: path.join("semanas", `${slug}.md`),
+  });
+}
+
+if (overwritePackageScripts && fs.existsSync("package.json")) {
+  const pkg = JSON.parse(fs.readFileSync("package.json", "utf-8"));
+  pkg.name = `openclass-${courseShort}`;
+  pkg.description = `Presentaciones Open Class del curso ${courseName}.`;
+  pkg.scripts = buildScripts();
+  writeFileSafe("package.json", JSON.stringify(pkg, null, 2) + "\n", { overwrite: true, label: "package.json" });
+}
+
+if (fs.existsSync("package-lock.json")) {
+  try {
+    const lock = JSON.parse(fs.readFileSync("package-lock.json", "utf-8"));
+    lock.name = `openclass-${courseShort}`;
+    if (lock.packages && lock.packages[""]) {
+      lock.packages[""].name = `openclass-${courseShort}`;
+    }
+    writeFileSafe("package-lock.json", JSON.stringify(lock, null, 2) + "\n", { overwrite: true, label: "package-lock.json" });
+  } catch {
+    console.log("⚠️  package-lock.json no se actualizó porque no parece ser JSON válido.");
+  }
+}
+
+console.log("\n✅ Configuración generada.");
+console.log("   Próximo paso sugerido: npm install");
+console.log("   Vista de una semana:   npm run dev:s1");
+console.log("   Vista completa:        npm run vista\n");

package/template/scripts/nuevo-curso.mjs

@@ -0,0 +1,104 @@
+/**
+ * Asistente interactivo para crear openclass.config.json y generar el curso.
+ *
+ * Uso:
+ *   npm run nuevo
+ */
+import { createInterface } from "node:readline/promises";
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+function ask(question, fallback = "") {
+  const hint = fallback ? ` [${fallback}]` : "";
+  return rl.question(`  ${question}${hint}: `);
+}
+
+function cleanShortName(value) {
+  return String(value || "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "")
+    .trim();
+}
+
+console.log("\n┌──────────────────────────────────────────┐");
+console.log("│ Nuevo curso Open Class · UNIMINUTO       │");
+console.log("└──────────────────────────────────────────┘\n");
+
+const shortRaw = await ask("Nombre corto del curso. Ejemplo: iot, bigdata, gestionseguridad");
+const shortName = cleanShortName(shortRaw);
+const fullName = (await ask("Nombre completo del curso")).trim();
+const year = (await ask("Año", String(new Date().getFullYear()))).trim() || String(new Date().getFullYear());
+const weeksTotal = 8;
+console.log("  Número de semanas [8]: 8");
+const description = (await ask("Descripción breve del curso", "Agrega aquí la descripción general del curso")).trim();
+
+if (!shortName || !fullName) {
+  console.error("\n❌ El nombre corto y el nombre completo son obligatorios.\n");
+  process.exit(1);
+}
+
+const activeRaw = (await ask("Semanas activas iniciales separadas por coma", "1")).trim() || "1";
+const activeWeeks = activeRaw
+  .split(",")
+  .map((value) => Number(value.trim()))
+  .filter((value) => Number.isInteger(value) && value >= 1 && value <= weeksTotal);
+
+const configureWeeks = (await ask("¿Configurar título y fecha de cada semana ahora? S/N", "S")).trim().toLowerCase();
+const weeks = [];
+
+for (let i = 1; i <= weeksTotal; i++) {
+  if (configureWeeks === "n" || configureWeeks === "no") {
+    weeks.push({
+      number: i,
+      title: `Título semana ${i}`,
+      date: year,
+      centralTheme: "Tema central de la semana",
+      activity: "Actividad o evaluación relacionada",
+    });
+    continue;
+  }
+
+  console.log(`\n  Semana ${i}`);
+  const title = (await ask("Título", `Título semana ${i}`)).trim() || `Título semana ${i}`;
+  const date = (await ask("Fecha", year)).trim() || year;
+  const centralTheme = (await ask("Tema central", title)).trim() || title;
+  const activity = (await ask("Actividad/evaluación relacionada", "Actividad o evaluación relacionada")).trim() || "Actividad o evaluación relacionada";
+  weeks.push({ number: i, title, date, centralTheme, activity });
+}
+
+rl.close();
+
+const config = {
+  course: {
+    shortName,
+    fullName,
+    year,
+    description,
+    openClassLabel: "Open Class",
+  },
+  generation: {
+    weeksTotal: 8,
+    activeWeeks: activeWeeks.length ? activeWeeks : [1],
+    exportPortal: false,
+    overwriteLaunchers: true,
+    overwritePortal: true,
+    overwriteDecks: true,
+    overwritePackageScripts: true,
+    overwriteWeekContent: false,
+  },
+  weeks,
+};
+
+fs.writeFileSync("openclass.config.json", JSON.stringify(config, null, 2) + "\n", "utf-8");
+console.log("\n✓ openclass.config.json creado");
+
+const result = spawnSync(process.execPath, ["scripts/generar-desde-config.mjs", "--force"], {
+  stdio: "inherit",
+  shell: false,
+});
+
+process.exit(result.status ?? 0);

package/template/scripts/preparar-github-pages.mjs

@@ -0,0 +1,52 @@
+/**
+ * Verifica la configuración mínima para publicar en GitHub Pages.
+ * No crea el repositorio remoto: deja los comandos listos para ejecutar.
+ */
+import fs from "node:fs";
+import { execSync } from "node:child_process";
+
+function exists(path) {
+  return fs.existsSync(path);
+}
+
+function tryRead(command) {
+  try {
+    return execSync(command, { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return "";
+  }
+}
+
+console.log("\n┌──────────────────────────────────────────┐");
+console.log("│ Preparación para GitHub Pages            │");
+console.log("└──────────────────────────────────────────┘\n");
+
+const workflow = ".github/workflows/deploy.yml";
+const ok = [
+  ["Workflow de GitHub Pages", exists(workflow)],
+  ["package.json", exists("package.json")],
+  ["scripts/decks.mjs", exists("scripts/decks.mjs")],
+  ["openclass.config.json", exists("openclass.config.json")],
+];
+
+for (const [label, status] of ok) {
+  console.log(`${status ? "✓" : "✗"} ${label}`);
+}
+
+const remote = tryRead("git remote get-url origin");
+const branch = tryRead("git branch --show-current") || "main";
+console.log(`\nRama actual    : ${branch}`);
+console.log(`Remoto origin : ${remote || "no configurado"}`);
+
+console.log("\nComandos sugeridos:\n");
+if (!exists(".git")) {
+  console.log("  git init");
+  console.log("  git branch -M main");
+}
+if (!remote) {
+  console.log("  git remote add origin https://github.com/TU_USUARIO/TU_REPOSITORIO.git");
+}
+console.log("  git add -A");
+console.log('  git commit -m "Publicación inicial Open Class"');
+console.log("  git push -u origin main");
+console.log("\nLuego, en GitHub: Settings → Pages → Build and deployment → Source: GitHub Actions.\n");

package/template/scripts/publicar.mjs

@@ -0,0 +1,36 @@
+import { execSync } from 'child_process';
+
+const fecha = new Date().toLocaleString('es-CO', {
+  timeZone: 'America/Bogota',
+  year: 'numeric',
+  month: '2-digit',
+  day: '2-digit',
+  hour: '2-digit',
+  minute: '2-digit',
+});
+
+const mensaje = `Actualización de diapositivas - ${fecha}`;
+
+function run(cmd) {
+  execSync(cmd, { stdio: 'inherit' });
+}
+
+console.log('\n🔍 Verificando cambios...');
+const status = execSync('git status --porcelain').toString().trim();
+
+if (!status) {
+  console.log('⚠️  No hay cambios para publicar.');
+  process.exit(0);
+}
+
+console.log('\n📦 Preparando archivos...');
+run('git add -A');
+
+console.log('\n💾 Confirmando cambios...');
+run(`git commit -m "${mensaje}"`);
+
+console.log('\n🚀 Subiendo a GitHub...');
+run('git push');
+
+console.log(`\n✅ Publicado: ${mensaje}`);
+console.log('   GitHub Actions desplegará el sitio automáticamente.\n');

package/template/scripts/semana.mjs

@@ -0,0 +1,122 @@
+/**
+ * Activa o genera una semana específica del curso Open Class.
+ *
+ * Uso básico:
+ *   npm run semana -- 1
+ *   npm run semana -- 3 --title "Sensores y actuadores" --date "Junio 15 de 2026"
+ *
+ * Este comando:
+ * - Mantiene el curso en 8 semanas.
+ * - Agrega la semana indicada a generation.activeWeeks.
+ * - Actualiza los metadatos de la semana si se pasan flags.
+ * - Regenera portal, lanzadores, scripts y decks.
+ * - No sobrescribe el contenido ya editado en semanas/*.md, salvo con --force-content.
+ */
+import fs from "node:fs";
+import { spawnSync } from "node:child_process";
+
+const args = process.argv.slice(2);
+
+function valueAfter(flag) {
+  const i = args.indexOf(flag);
+  if (i >= 0 && args[i + 1]) return args[i + 1];
+  const pair = args.find((arg) => arg.startsWith(`${flag}=`));
+  if (pair) return pair.slice(flag.length + 1);
+  return undefined;
+}
+
+function fail(message) {
+  console.error(`\n❌ ${message}\n`);
+  process.exit(1);
+}
+
+function readJson(filePath) {
+  if (!fs.existsSync(filePath)) fail(`No se encontró ${filePath}. Ejecuta primero npm run nuevo o crea openclass.config.json.`);
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch (error) {
+    fail(`No se pudo leer ${filePath}. Revisa que sea JSON válido.\n${error.message}`);
+  }
+}
+
+function toWeekNumber() {
+  const fromFlag = valueAfter("--week") || valueAfter("-w");
+  const positional = args.find((arg) => /^\d+$/.test(arg));
+  const value = Number(fromFlag || positional);
+  if (!Number.isInteger(value) || value < 1 || value > 8) {
+    fail("Debes indicar una semana entre 1 y 8. Ejemplo: npm run semana -- 3");
+  }
+  return value;
+}
+
+function normalizeWeek(weekNumber, existing = {}) {
+  const title = String(existing.title || `Título semana ${weekNumber}`).trim();
+  return {
+    number: weekNumber,
+    title,
+    date: String(existing.date || new Date().getFullYear()).trim(),
+    centralTheme: String(existing.centralTheme || existing.theme || title || "Tema central de la semana").trim(),
+    activity: String(existing.activity || "Actividad o evaluación relacionada").trim(),
+    duration: String(existing.duration || "90 minutos").trim(),
+    status: String(existing.status || "active").trim(),
+  };
+}
+
+const weekNumber = toWeekNumber();
+const configPath = valueAfter("--config") || "openclass.config.json";
+const forceContent = args.includes("--force-content");
+const removeOtherWeeks = args.includes("--only");
+
+const title = valueAfter("--title");
+const date = valueAfter("--date");
+const centralTheme = valueAfter("--theme") || valueAfter("--central-theme");
+const activity = valueAfter("--activity");
+const duration = valueAfter("--duration");
+
+const config = readJson(configPath);
+config.course ||= {};
+config.generation ||= {};
+config.weeks = Array.isArray(config.weeks) ? config.weeks : [];
+
+config.generation.weeksTotal = 8;
+config.generation.overwriteLaunchers = true;
+config.generation.overwritePortal = true;
+config.generation.overwriteDecks = true;
+config.generation.overwritePackageScripts = true;
+config.generation.overwriteWeekContent = forceContent;
+
+const byNumber = new Map(config.weeks.map((week) => [Number(week.number), week]));
+for (let i = 1; i <= 8; i++) {
+  byNumber.set(i, normalizeWeek(i, byNumber.get(i)));
+}
+
+const target = byNumber.get(weekNumber);
+if (title) target.title = title;
+if (date) target.date = date;
+if (centralTheme) target.centralTheme = centralTheme;
+if (activity) target.activity = activity;
+if (duration) target.duration = duration;
+target.status = "active";
+
+const previousActive = Array.isArray(config.generation.activeWeeks) ? config.generation.activeWeeks.map(Number) : [];
+const nextActive = removeOtherWeeks ? [weekNumber] : [...new Set([...previousActive, weekNumber])];
+config.generation.activeWeeks = nextActive.filter((n) => Number.isInteger(n) && n >= 1 && n <= 8).sort((a, b) => a - b);
+config.weeks = Array.from(byNumber.values()).sort((a, b) => a.number - b.number);
+
+fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+
+console.log("\n┌──────────────────────────────────────────┐");
+console.log("│ Generar / activar semana Open Class      │");
+console.log("└──────────────────────────────────────────┘\n");
+console.log(`Configuración : ${configPath}`);
+console.log(`Semana        : ${weekNumber}`);
+console.log(`Activas       : ${config.generation.activeWeeks.join(", ")}`);
+console.log(`Contenido     : ${forceContent ? "se sobrescribirá" : "se conserva si ya existe"}\n`);
+
+const generatorArgs = ["scripts/generar-desde-config.mjs", "--config", configPath];
+const result = spawnSync(process.execPath, generatorArgs, {
+  stdio: "inherit",
+  shell: false,
+});
+
+process.exit(result.status ?? 0);

package/template/scripts/zip-template.mjs

@@ -0,0 +1,70 @@
+/**
+ * Genera un ZIP limpio del proyecto actual.
+ *
+ * Uso:
+ *   npm run zip:template
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const OUT = "openclass-template.zip";
+const ROOT = process.cwd();
+const TEMP = path.join(ROOT, "__zip_openclass_template__");
+
+const exclude = new Set([
+  ".git",
+  ".slidev",
+  "node_modules",
+  "dist",
+  "__zip_openclass_template__",
+]);
+
+const excludeFiles = new Set([OUT]);
+
+function copyFiltered(src, dest) {
+  const name = path.basename(src);
+  if (exclude.has(name) || excludeFiles.has(name)) return;
+
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const child of fs.readdirSync(src)) {
+      copyFiltered(path.join(src, child), path.join(dest, child));
+    }
+    return;
+  }
+
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+fs.rmSync(TEMP, { recursive: true, force: true });
+fs.rmSync(OUT, { force: true });
+fs.mkdirSync(TEMP, { recursive: true });
+
+const folderName = path.basename(ROOT);
+const packageRoot = path.join(TEMP, folderName);
+fs.mkdirSync(packageRoot, { recursive: true });
+
+for (const item of fs.readdirSync(ROOT)) {
+  copyFiltered(path.join(ROOT, item), path.join(packageRoot, item));
+}
+
+let result;
+if (process.platform === "win32") {
+  const ps = `Add-Type -AssemblyName System.IO.Compression.FileSystem; [System.IO.Compression.ZipFile]::CreateFromDirectory('${TEMP.replaceAll("'", "''")}', '${path.resolve(OUT).replaceAll("'", "''")}')`;
+  result = spawnSync("powershell", ["-NoProfile", "-Command", ps], { stdio: "inherit" });
+} else {
+  result = spawnSync("zip", ["-r", path.resolve(OUT), "."], { cwd: TEMP, stdio: "inherit" });
+}
+
+fs.rmSync(TEMP, { recursive: true, force: true });
+
+if (result.status !== 0) {
+  console.error("\n❌ No se pudo generar el ZIP. En Linux/macOS verifica que el comando zip esté instalado.\n");
+  process.exit(result.status ?? 1);
+}
+
+const sizeKb = Math.round(fs.statSync(OUT).size / 1024);
+console.log(`\n✅ ${OUT} generado (${sizeKb} KB).\n`);