create-openclass-uniminuto 1.4.0 → 1.4.1

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

@@ -1,279 +1,632 @@
-/**
- * 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");
+/**
+ * Genera o actualiza una Open Class Slidev a partir de openclass.config.json.
+ *
+ * Uso principal:
+ *   npm run config
+<<<<<<< HEAD
+ *   npm run semana -- 6
+ *   node scripts/generar-desde-config.mjs --config config/openclass.config.iot-ejemplo.json --force
+ *
+ * Mejoras:
+ * - Mantiene el curso en 8 semanas.
+ * - Repara public/favicon.png si no existe.
+ * - Elimina demo_semanaX.md cuando el curso ya tiene un nombre corto diferente de "demo".
+ * - No sobrescribe el contenido académico ya editado en semanas/*.md salvo con --force.
+=======
+ *   node scripts/generar-desde-config.mjs --config config/openclass.config.iot-ejemplo.json --force
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+ */
+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];
+<<<<<<< HEAD
+
+  const pair = args.find((arg) => arg.startsWith(`${flag}=`));
+  if (pair) return pair.slice(flag.length + 1);
+
+=======
+  const pair = args.find((arg) => arg.startsWith(`${flag}=`));
+  if (pair) return pair.slice(flag.length + 1);
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  return fallback;
+}
+
+const configPath = valueAfter("--config", "openclass.config.json");
+const force = args.includes("--force") || args.includes("-f");
+const dryRun = args.includes("--dry-run");
+<<<<<<< HEAD
+const forceCleanDemo = args.includes("--clean-demo");
+
+/**
+ * Favicon PNG mínimo de respaldo.
+ *
+ * No reemplaza un favicon existente.
+ * Solo se usa si public/favicon.png no existe, para evitar que Slidev o GitHub Pages
+ * queden apuntando a un recurso inexistente.
+ */
+const FALLBACK_FAVICON_PNG_BASE64 =
+  "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/p9sAAAAASUVORK5CYII=";
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+
+function fail(message) {
+  console.error(`\n❌ ${message}\n`);
+  process.exit(1);
+}
+
+function readJson(filePath) {
+<<<<<<< HEAD
+  if (!fs.existsSync(filePath)) {
+    fail(`No se encontró el archivo de configuración: ${filePath}`);
+  }
+
+=======
+  if (!fs.existsSync(filePath)) fail(`No se encontró el archivo de configuración: ${filePath}`);
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  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;
+}
+
+<<<<<<< HEAD
+function writeBinaryFileIfMissing(filePath, base64Content, { label = filePath } = {}) {
+  ensureDir(path.dirname(filePath));
+
+  if (fs.existsSync(filePath)) {
+    console.log(`⏭  Conservado: ${label}`);
+    return false;
+  }
+
+  if (!dryRun) {
+    fs.writeFileSync(filePath, Buffer.from(base64Content, "base64"));
+  }
+
+  console.log(`${dryRun ? "🔎" : "✓"}  ${label} creado como respaldo`);
+  return true;
+}
+
+function removeFileIfExists(filePath, { label = filePath } = {}) {
+  if (!fs.existsSync(filePath)) return false;
+
+  if (!dryRun) fs.rmSync(filePath, { force: true });
+  console.log(`${dryRun ? "🔎" : "🧹"}  Eliminado: ${label}`);
+  return true;
+}
+
+function cleanShortName(value) {
+  return (
+    String(value || "")
+      .normalize("NFD")
+      .replace(/[\u0300-\u036f]/g, "")
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "")
+      .trim() || "curso"
+  );
+=======
+function cleanShortName(value) {
+  return String(value || "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "")
+    .trim();
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+}
+
+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;
+}
+
+<<<<<<< HEAD
+=======
+function normalizeBase(value) {
+  let base = value || "/";
+  if (!base.startsWith("/")) base = `/${base}`;
+  if (!base.endsWith("/")) base = `${base}/`;
+  return base;
+}
+
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+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.");
+<<<<<<< HEAD
+if (!Number.isInteger(weeksTotal) || weeksTotal < 1) {
+  fail("generation.weeksTotal debe ser un número entero mayor o igual a 1.");
+}
+=======
+if (!Number.isInteger(weeksTotal) || weeksTotal < 1) fail("generation.weeksTotal debe ser un número entero mayor o igual a 1.");
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+
+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();
+<<<<<<< HEAD
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  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));
+<<<<<<< HEAD
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+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));
+<<<<<<< HEAD
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+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;
+
+<<<<<<< HEAD
+/**
+ * Por defecto se eliminan los archivos demo cuando el curso ya no se llama "demo".
+ * Puede desactivarse desde openclass.config.json:
+ *
+ * "generation": {
+ *   "cleanDemoFiles": false
+ * }
+ */
+const cleanDemoFiles = generation.cleanDemoFiles !== false;
+
+const semanaTemplate = readTemplate(
+  "plantillas/semana.md",
+  `---
+layout: slide-01-portada
+---
+
+::title::
+{{COURSE_NAME}}
+
+::week::
+Semana {{WEEK_NUMBER}} — {{WEEK_TITLE}}
+
+::date::
+{{WEEK_DATE}}
+
+---
+layout: slide-12-cierre
+---
+`,
+=======
+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`,
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+);
+
+const launcherTemplate = readTemplate(
+  "plantillas/launcher.md",
+<<<<<<< HEAD
+  `---
+theme: ./theme/uniminuto
+title: {{COURSE_NAME}} — Semana {{WEEK_NUMBER}} — {{WEEK_TITLE}}
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+src: ./semanas/{{COURSE_SHORT}}_semana{{WEEK_NUMBER}}.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`,
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+);
+
+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}`;
+<<<<<<< HEAD
+
+  return `### **Semana ${week.number}**
+
+<a href="./semanas/${slug}/#/1" target="_self">${week.title}</a>
+
+<a href="./descargas/${slug}.pdf" download>Descargar PDF</a> · <a href="./descargas/${slug}.pptx" download>Descargar PPTX</a>`;
+=======
+  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>`;
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+}
+
+function buildPortal() {
+  const left = activeWeeks.length
+<<<<<<< HEAD
+    ? 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 `---
+theme: ./theme/uniminuto
+title: ${courseName} — ${openClassLabel}
+favicon: /favicon.png
+codeCopy: true
+transition: fade
+routerMode: hash
+drawings:
+  persist: false
+layout: slide-01-portada
+---
+
+::title::
+${courseName}
+
+::week::
+${openClassLabel}
+
+::date::
+${courseYear}
+
+---
+layout: slide-08-titulo-texto
+---
+
+::title::
+Descripción general del curso
+
+::content::
+${description}
+
+---
+layout: slide-08-titulo-texto
+---
+
+::title::
+Ruta de aprendizaje
+
+::content::
+El curso se organiza en semanas. Cada semana cuenta con un lanzador raíz y un archivo interno en la carpeta \`semanas/\`.
+
+Las presentaciones activas se controlan desde \`openclass.config.json\` mediante el campo \`generation.activeWeeks\`.
+
+---
+layout: slide-10-titulo-dos-columnas
+---
+
+::title::
+Presentaciones disponibles
+
+::left::
+${left}
+
+::right::
+${right}
+
+---
+layout: slide-12-cierre
+---
+`;
+=======
+    ? 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`;
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+}
+
+function buildDecks() {
+  const entries = [
+<<<<<<< HEAD
+    `function normalizeBase(value) {
+  let base = value || "/";
+  if (!base.startsWith("/")) base = \`/\${base}\`;
+  if (!base.endsWith("/")) base = \`\${base}/\`;
+  return base;
+}
+
+const SITE_BASE = normalizeBase(process.env.SITE_BASE || "/");
+
+function withBase(path = "") {
+  return \`\${SITE_BASE}\${path.replace(/^\\/+/, "")}\`;
+}
+
+export const decks = [
+  {
+    name: "openclass-${courseShort}",
+    entry: "slides.md",
+    out: "dist",
+    base: SITE_BASE,
+    exportable: ${exportPortal ? "true" : "false"},
+  },`,
+=======
+    `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  },`,
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  ];
+
+  for (const week of activeWeeks) {
+    const slug = `${courseShort}_semana${week.number}`;
+<<<<<<< HEAD
+
+    entries.push(`  {
+    name: "${slug}",
+    entry: "${slug}.md",
+    out: "dist/semanas/${slug}",
+    base: withBase("semanas/${slug}/"),
+    exportable: true,
+  },`);
+=======
+    entries.push(`  {\n    name: "${slug}",\n    entry: "${slug}.md",\n    out: "dist/semanas/${slug}",\n    base: withBase("semanas/${slug}/"),\n    exportable: true,\n  },`);
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  }
+
+  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})\"";
+<<<<<<< HEAD
+  scripts["clean:downloads"] = "node -e \"require('fs').rmSync('public/descargas',{recursive:true,force:true}); require('fs').mkdirSync('public/descargas',{recursive:true})\"";
+=======
+  scripts["clean:downloads"] = "node -e \"require('fs').rmSync('public/descargas',{recursive:true,force:true})\"";
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  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;
+}
+
+<<<<<<< HEAD
+function ensureProjectAssets() {
+  ensureDir("public");
+  ensureDir("public/descargas");
+  ensureDir("public/imagenes");
+  ensureDir("public/videos");
+
+  writeBinaryFileIfMissing("public/favicon.png", FALLBACK_FAVICON_PNG_BASE64, {
+    label: "public/favicon.png",
+  });
+}
+
+function cleanLegacyDemoFiles() {
+  const shouldClean = forceCleanDemo || (cleanDemoFiles && courseShort !== "demo");
+
+  if (!shouldClean) {
+    console.log("⏭  Archivos demo conservados.");
+    return;
+  }
+
+  for (let i = 1; i <= 8; i++) {
+    removeFileIfExists(`demo_semana${i}.md`, {
+      label: `demo_semana${i}.md`,
+    });
+
+    removeFileIfExists(path.join("semanas", `demo_semana${i}.md`), {
+      label: path.join("semanas", `demo_semana${i}.md`),
+    });
+  }
+}
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+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");
+<<<<<<< HEAD
+ensureProjectAssets();
+cleanLegacyDemoFiles();
+
+writeFileSafe("slides.md", buildPortal(), {
+  overwrite: overwritePortal,
+  label: "slides.md",
+});
+
+writeFileSafe("scripts/decks.mjs", buildDecks(), {
+  overwrite: overwriteDecks,
+  label: "scripts/decks.mjs",
+});
+=======
+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" });
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+
+for (const week of allWeeks) {
+  const slug = `${courseShort}_semana${week.number}`;
+  const tokens = weekTokens(week);
+<<<<<<< HEAD
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  writeFileSafe(`${slug}.md`, replaceTokens(launcherTemplate, tokens), {
+    overwrite: overwriteLaunchers,
+    label: `${slug}.md`,
+  });
+<<<<<<< HEAD
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  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"));
+<<<<<<< HEAD
+
+  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",
+  });
+=======
+  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" });
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+}
+
+if (fs.existsSync("package-lock.json")) {
+  try {
+    const lock = JSON.parse(fs.readFileSync("package-lock.json", "utf-8"));
+<<<<<<< HEAD
+
+=======
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+    lock.name = `openclass-${courseShort}`;
+    if (lock.packages && lock.packages[""]) {
+      lock.packages[""].name = `openclass-${courseShort}`;
+    }
+<<<<<<< HEAD
+
+    writeFileSafe("package-lock.json", JSON.stringify(lock, null, 2) + "\n", {
+      overwrite: true,
+      label: "package-lock.json",
+    });
+=======
+    writeFileSafe("package-lock.json", JSON.stringify(lock, null, 2) + "\n", { overwrite: true, label: "package-lock.json" });
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33
+  } catch {
+    console.log("⚠️  package-lock.json no se actualizó porque no parece ser JSON válido.");
+  }
+}
+
+console.log("\n✅ Configuración generada.");
+<<<<<<< HEAD
+console.log("   Vista de una semana:   npm run dev:s1");
+console.log("   Vista completa:        npm run vista");
+console.log("   Exportar PDF/PPTX:     npm run export:downloads\n");
+=======
+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");
+>>>>>>> 55a9d4cb0e83dc9640a84aea0dc007a5379aba33