#!/usr/bin/env node
/**
 * export_deck_pptx.mjs — 把多文件 slide deck 导出为可编辑 PPTX
 *
 * 用法：
 *   node export_deck_pptx.mjs --slides <dir> --out <file.pptx>
 *   node export_deck_pptx.mjs --slides <dir> --out <file.pptx> --skip-preflight
 *
 * 行为：
 *   - 默认先跑 preflight 质量门（editable PPTX 严格模式）
 *   - 调用 scripts/html2pptx.js 把 HTML DOM 逐元素翻译成 PowerPoint 原生对象
 *   - 文字是真文本框，PPT 里直接双击能编辑
 *   - body 尺寸 960pt × 540pt（LAYOUT_WIDE，13.333″ × 7.5″）
 *
 * ⚠️ HTML 必须符合 4 条硬约束（见 references/editable-pptx.md）：
 *   1. 文字包在 <p>/<h1>-<h6> 里（div 不能直接放文字）
 *   2. 不用 CSS 渐变
 *   3. <p>/<h*> 不能有 background/border/shadow（放外层 div）
 *   4. div 不能 background-image（用 <img>）
 *
 * 视觉驱动的 HTML 几乎无法 pass —— 必须从写 HTML 的第一行就按约束写。
 * 视觉自由度优先的场景（动画、web component、CSS 渐变、复杂 SVG）
 * 应改用 export_deck_pdf.mjs / export_deck_stage_pdf.mjs 导出 PDF。
 *
 * 依赖：npm install playwright pptxgenjs sharp
 *
 * 按文件名排序（01-xxx.html → 02-xxx.html → ...）。
 */

import fs from 'fs/promises';
import fsSync from 'fs';
import path from 'path';
import { fileURLToPath } from 'url';
import { spawnSync } from 'child_process';
import { createRequire } from 'module';

const __dirname = path.dirname(fileURLToPath(import.meta.url));

function parseArgs() {
  const args = { skipPreflight: false };
  const a = process.argv.slice(2);
  for (let i = 0; i < a.length; i += 1) {
    const token = a[i];
    if (token === '--skip-preflight') {
      args.skipPreflight = true;
      continue;
    }
    const k = token.replace(/^--/, '');
    const v = a[i + 1];
    if (!v || v.startsWith('--')) {
      console.error(`缺少参数值：${token}`);
      process.exit(1);
    }
    args[k] = v;
    i += 1;
  }
  if (!args.slides || !args.out) {
    console.error('用法: node export_deck_pptx.mjs --slides <dir> --out <file.pptx>');
    console.error('      node export_deck_pptx.mjs --slides <dir> --out <file.pptx> --skip-preflight');
    console.error('');
    console.error('⚠️ HTML 必须符合 4 条硬约束（见 references/editable-pptx.md）。');
    console.error('   视觉自由度优先的场景请改用 export_deck_pdf.mjs 导出 PDF。');
    process.exit(1);
  }
  return args;
}

function resolvePythonCommand() {
  const candidates = process.platform === 'win32'
    ? [
        ['python', []],
        ['py', ['-3']],
      ]
    : [
        ['python3', []],
        ['python', []],
      ];

  for (const [cmd, prefixArgs] of candidates) {
    const probe = spawnSync(cmd, [...prefixArgs, '--version'], { encoding: 'utf8' });
    if (probe.status === 0) {
      return { cmd, prefixArgs };
    }
  }
  return null;
}

function discoverPreflightTargets(slidesDir, explicitSource) {
  if (explicitSource) return [path.resolve(explicitSource)];

  const deckRoot = path.dirname(slidesDir);
  const indexHtml = path.join(deckRoot, 'index.html');
  if (fsSync.existsSync(indexHtml)) return [indexHtml];

  return fsSync.readdirSync(slidesDir)
    .filter((file) => file.endsWith('.html'))
    .sort()
    .map((file) => path.join(slidesDir, file));
}

function runPreflight(slidesDir, explicitSource) {
  const python = resolvePythonCommand();
  if (!python) {
    console.error('✗ 找不到 Python，无法运行 preflight 质量门。');
    console.error('  可手动安装 Python，或在应急场景下显式传入 --skip-preflight 跳过。');
    process.exit(1);
  }

  const preflightScript = path.join(__dirname, 'preflight_deck.py');
  const targets = discoverPreflightTargets(slidesDir, explicitSource);
  console.log(`Running gate 1/2 (HTML preflight) on ${targets.length} target(s)...`);

  for (const target of targets) {
    const args = [
      ...python.prefixArgs,
      preflightScript,
      target,
      '--editable-pptx',
      '--strict',
    ];
    const result = spawnSync(python.cmd, args, {
      stdio: 'inherit',
      encoding: 'utf8',
    });

    if (result.status !== 0) {
      console.error('');
      console.error(`✗ Preflight gate failed for ${target}`);
      console.error('  先修 blocker 再导出；如确需跳过，请显式使用 --skip-preflight。');
      process.exit(result.status || 1);
    }
  }

  console.log('✓ Gate 1/2 passed.');
}

function loadPptxGen() {
  const require = createRequire(import.meta.url);
  try {
    return require('pptxgenjs');
  } catch (e) {
    console.error(`✗ 加载 pptxgenjs 失败：${e.message}`);
    console.error('  请先安装 Node 依赖：npm install pptxgenjs playwright sharp');
    process.exit(1);
  }
}

async function main() {
  const { slides, out, skipPreflight, preflightSource } = parseArgs();
  const slidesDir = path.resolve(slides);
  const outFile = path.resolve(out);

  const files = (await fs.readdir(slidesDir))
    .filter(f => f.endsWith('.html'))
    .sort();
  if (!files.length) {
    console.error(`No .html files found in ${slidesDir}`);
    process.exit(1);
  }

  if (!skipPreflight) {
    runPreflight(slidesDir, preflightSource);
    console.log('');
  } else {
    console.log('⚠️ Skipping gate 1/2 because --skip-preflight was provided.');
  }

  const pptxgen = loadPptxGen();
  console.log(`Running gate 2/2 (post-conversion PPTX safety check) during html2pptx for ${files.length} slides...`);

  const require = createRequire(import.meta.url);
  let html2pptx;
  try {
    html2pptx = require(path.join(__dirname, 'html2pptx.js'));
  } catch (e) {
    console.error(`✗ 加载 html2pptx.js 失败：${e.message}`);
    console.error(`  依赖缺失时请跑：npm install playwright pptxgenjs sharp`);
    process.exit(1);
  }

  const pres = new pptxgen();
  pres.layout = 'LAYOUT_WIDE';  // 13.333 × 7.5 inch，对应 HTML body 960 × 540 pt

  const errors = [];
  for (let i = 0; i < files.length; i++) {
    const f = files[i];
    const fullPath = path.join(slidesDir, f);
    try {
      await html2pptx(fullPath, pres);
      console.log(`  [${i + 1}/${files.length}] ${f} ✓`);
    } catch (e) {
      console.error(`  [${i + 1}/${files.length}] ${f} ✗  ${e.message}`);
      errors.push({ file: f, error: e.message });
    }
  }

  if (errors.length) {
    console.error(`\n⚠️ ${errors.length} 张 slide 转换失败。常见原因：HTML 不符合 4 条硬约束。`);
    console.error(`  详见 references/editable-pptx.md 的「常见错误速查」。`);
    if (errors.length === files.length) {
      console.error(`✗ 全部失败，不生成 PPTX。`);
      process.exit(1);
    }
  }

  await pres.writeFile({ fileName: outFile });
  console.log(`\n✓ Wrote ${outFile}  (${files.length - errors.length}/${files.length} slides, 可编辑 PPTX)`);
}

main().catch(e => { console.error(e); process.exit(1); });
