slides-grab 1.2.2 → 1.2.3

package/src/editor/codex-edit.js

@@ -1,11 +1,21 @@
 import { readFileSync } from 'node:fs';
 import { mkdir } from 'node:fs/promises';
+import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
 import sharp from 'sharp';
 
 import { getPackageRoot } from '../resolve.js';
 
+const require = createRequire(import.meta.url);
+const {
+  DEFAULT_SLIDE_MODE,
+  getSlideModeConfig,
+} = require('../slide-mode.cjs');
+
 export const SLIDE_SIZE = { width: 960, height: 540 };
+export function getSlideSize(slideMode = DEFAULT_SLIDE_MODE) {
+  return getSlideModeConfig(slideMode).framePx;
+}
 
 const PPT_DESIGN_SKILL_PATH = join(getPackageRoot(), 'skills', 'slides-grab-design', 'SKILL.md');
 const EDITOR_CODEX_PROMPT_PATH = join(dirname(new URL(import.meta.url).pathname), 'editor-codex-prompt.md');
@@ -18,9 +28,13 @@ const EDITOR_PPT_DESIGN_SECTION_HEADINGS = [
 const DETAILED_DESIGN_SECTION_HEADINGS = [
   '## Base Settings',
   '## Text Usage Rules',
+  '## Icon Usage Rules',
   '## Workflow (Stage 2: Design + Human Review)',
   '## Important Notes',
 ];
+const DETAILED_DESIGN_REQUIRED_SECTION_HEADINGS = [
+  '## Icon Usage Rules',
+];
 const BEAUTIFUL_SLIDE_DEFAULTS_SECTION_HEADINGS = [
   '## Working Model',
   '## Beautiful Defaults for Slides',
@@ -49,6 +63,8 @@ const EDITOR_PPT_DESIGN_SKILL_FALLBACK = [
   '## Rules',
   '- Keep slide size 720pt x 405pt.',
   '- Keep semantic text tags (`p`, `h1-h6`, `ul`, `ol`, `li`).',
+  '- Prefer Lucide as the default icon library for slide UI elements, callouts, and supporting visuals.',
+  '- Do not default to emoji for iconography unless the brief explicitly asks for a playful or native-emoji tone.',
   '- Put local images and videos under `<slides-dir>/assets/` and reference them as `./assets/<file>`.',
   '- Allow `data:` URLs when the slide must be fully self-contained.',
   '- Do not leave remote `http(s)://` image URLs in saved slide HTML; download source images into `<slides-dir>/assets/` and reference them as `./assets/<file>`.',
@@ -87,8 +103,14 @@ const DETAILED_DESIGN_SKILL_FALLBACK = [
   '- All text must be inside <p>, <h1>-<h6>, <ul>, <ol>, or <li>.',
   '- Never place text directly in <div> or <span>.',
   '',
+  '## Icon Usage Rules',
+  '- Prefer Lucide as the default icon library for slide UI elements, callouts, and supporting visuals.',
+  '- Do not default to emoji for iconography; reserve emoji for cases where the brief explicitly wants a playful or native-emoji tone.',
+  '- Keep icon sizing, stroke weight, and color aligned with the deck\'s approved design tokens.',
+  '',
   '## Workflow (Stage 2: Design + Human Review)',
-  '- After slide generation or edits, run slides-grab build-viewer --slides-dir <path>.',
+  '- After slide generation or edits, run slides-grab validate --slides-dir <path>.',
+  '- Only after validation passes, run slides-grab build-viewer --slides-dir <path>.',
   '- Edit only the relevant HTML file during revision loops.',
   '- Prefer slides-grab image before remote image sourcing when a slide explicitly needs bespoke imagery.',
   '- Never start PPTX conversion without explicit approval.',
@@ -281,14 +303,20 @@ function pruneDuplicateLines(markdown, patterns) {
   return filtered.join('\n').trim();
 }
 
-function loadMarkdownSections(markdownPath, headings, fallback) {
+function loadMarkdownSections(markdownPath, headings, fallback, options = {}) {
   try {
     const markdown = readFileSync(markdownPath, 'utf8');
+    const { requiredHeadings = [] } = options;
+    const sectionsByHeading = new Map(headings.map((heading) => [
+      heading,
+      extractMarkdownSection(markdown, heading),
+    ]));
     const sections = headings
-      .map((heading) => extractMarkdownSection(markdown, heading))
+      .map((heading) => sectionsByHeading.get(heading))
       .filter(Boolean);
+    const isMissingRequiredSection = requiredHeadings.some((requiredHeading) => !sectionsByHeading.get(requiredHeading));
 
-    return sections.length > 0
+    return sections.length > 0 && !isMissingRequiredSection
       ? sections.join('\n\n')
       : fallback;
   } catch {
@@ -305,6 +333,9 @@ function getStructuralDesignSkillPrompt() {
     DETAILED_DESIGN_SKILL_PATH,
     DETAILED_DESIGN_SECTION_HEADINGS,
     DETAILED_DESIGN_SKILL_FALLBACK,
+    {
+      requiredHeadings: DETAILED_DESIGN_REQUIRED_SECTION_HEADINGS,
+    },
   );
 
   return cachedStructuralDesignSkillPrompt;
@@ -331,11 +362,12 @@ export function getDetailedDesignSkillPrompt() {
   ].filter(Boolean).join('\n\n');
 }
 
-export function buildCodexEditPrompt({ slideFile, slidePath, userPrompt, selections = [] }) {
+export function buildCodexEditPrompt({ slideFile, slidePath, userPrompt, slideMode = DEFAULT_SLIDE_MODE, selections = [] }) {
   const sanitizedPrompt = typeof userPrompt === 'string' ? userPrompt.trim() : '';
   if (!sanitizedPrompt) {
     throw new Error('Prompt must be a non-empty string.');
   }
+  const { coordinateSpaceLabel, sizeLabel } = getSlideModeConfig(slideMode);
 
   const normalizedSlidePath = typeof slidePath === 'string' && slidePath.trim() !== ''
     ? slidePath.trim()
@@ -357,7 +389,12 @@ export function buildCodexEditPrompt({ slideFile, slidePath, userPrompt, selecti
     ];
   });
 
-  const editorPrompt = getEditorPptDesignSkillPrompt();
+  const editorPrompt = getEditorPptDesignSkillPrompt()
+    .replaceAll('720pt x 405pt', sizeLabel)
+    .replace(
+      'Run `slides-grab validate --slides-dir <path>` after editing.',
+      `Run \`slides-grab validate --slides-dir <path>${slideMode === DEFAULT_SLIDE_MODE ? '' : ` --mode ${slideMode}`}\` after editing.`,
+    );
   const editorPromptLines = editorPrompt
     ? [
         'Slide edit rules (follow strictly):',
@@ -373,13 +410,13 @@ export function buildCodexEditPrompt({ slideFile, slidePath, userPrompt, selecti
     'User edit request (this is the primary objective — follow it faithfully):',
     sanitizedPrompt,
     '',
-    'Selected regions on slide (960x540 coordinate space):',
+    `Selected regions on slide (${coordinateSpaceLabel} coordinate space):`,
     ...selectionLines,
     'Rules:',
     '- Edit only the requested slide HTML file among slide-*.html files.',
     '- Do not modify any other slide HTML files unless explicitly requested.',
     '- Keep existing structure/content unless the request requires a change.',
-    '- Keep slide dimensions at 720pt x 405pt.',
+    `- Keep slide dimensions at ${sizeLabel}.`,
     '- Keep text in semantic tags (<p>, <h1>-<h6>, <ul>, <ol>, <li>).',
     '- You may add or update supporting files required for the requested slide, including local images and videos under <slides-dir>/assets/ and tldraw source/export files used to generate those assets.',
     '- When the request needs bespoke imagery, prefer `slides-grab image --prompt "<prompt>" --slides-dir <path>` so Nano Banana Pro saves the asset under <slides-dir>/assets/.',

package/src/editor/editor-codex-prompt.md

@@ -15,7 +15,7 @@ The user's edit request is the primary objective. All rules below exist to suppo
 5. Return after applying the change.
 
 ## Slide Rules
-- Keep slide size 720pt x 405pt.
+- Keep slide size appropriate for the current mode (`720pt x 405pt` for presentation, `720pt x 720pt` for card-news).
 - Keep semantic text tags (`p`, `h1-h6`, `ul`, `ol`, `li`).
 - Never place text directly in `<div>` or `<span>`.
 - Always include `#` prefix in CSS colors.
@@ -38,6 +38,8 @@ The user's edit request is the primary objective. All rules below exist to suppo
 - Give each slide one job, one dominant visual anchor, one primary takeaway.
 - Keep copy short enough to scan in seconds.
 - Use whitespace, alignment, scale, cropping, and contrast before adding decorative chrome.
+- Prefer Lucide as the default icon library for slide UI elements, callouts, and supporting visuals.
+- Do not default to emoji for iconography unless the brief explicitly asks for a playful or native-emoji tone.
 - Default to cardless layouts unless a card improves structure.
 - Limit to two typefaces max and one accent color.
 

package/src/editor/js/editor-init.js

@@ -1,8 +1,8 @@
 // editor-init.js — Entry point: imports, event bindings, init()
 
-import { state, TOOL_MODE_DRAW, TOOL_MODE_SELECT } from './editor-state.js';
+import { state, TOOL_MODE_DRAW, TOOL_MODE_SELECT, setSlideFrame } from './editor-state.js';
 import {
-  btnPrev, btnNext, slideIframe, drawLayer, promptInput, modelSelect,
+  btnPrev, btnNext, slideIframe, slideWrapper, drawLayer, promptInput, modelSelect,
   btnSend, btnClearBboxes, slideCounter,
   toggleBold, toggleItalic, toggleUnderline, toggleStrike,
   alignLeft, alignCenter, alignRight,
@@ -256,10 +256,42 @@ slideIframe.addEventListener('load', () => {
   updateSendState();
 });
 
+function applySlideFrameCss(width, height) {
+  if (slideWrapper) {
+    slideWrapper.style.width = `${width}px`;
+    slideWrapper.style.height = `${height}px`;
+  }
+  if (slideIframe) {
+    slideIframe.style.width = `${width}px`;
+    slideIframe.style.height = `${height}px`;
+  }
+}
+
+async function loadEditorConfig() {
+  try {
+    const res = await fetch('/api/config');
+    if (!res.ok) return;
+    const cfg = await res.json();
+    const w = cfg?.framePx?.width;
+    const h = cfg?.framePx?.height;
+    if (w && h) {
+      setSlideFrame(w, h);
+      applySlideFrameCss(w, h);
+    }
+    if (cfg?.slideMode && document?.body) {
+      document.body.dataset.slideMode = cfg.slideMode;
+    }
+  } catch {
+    // Defaults (960x540) stay in effect.
+  }
+}
+
 // Init
 async function init() {
   setStatus('Loading slide list...');
 
+  await loadEditorConfig();
+
   try {
     const res = await fetch('/api/slides');
     if (!res.ok) {

package/src/editor/js/editor-state.js

@@ -1,7 +1,14 @@
 // editor-state.js — State variables, constants, Maps/Sets
 
-export const SLIDE_W = 960;
-export const SLIDE_H = 540;
+export let SLIDE_W = 960;
+export let SLIDE_H = 540;
+
+export function setSlideFrame(width, height) {
+  const w = Number(width);
+  const h = Number(height);
+  if (Number.isFinite(w) && w > 0) SLIDE_W = Math.round(w);
+  if (Number.isFinite(h) && h > 0) SLIDE_H = Math.round(h);
+}
 export const TOOL_MODE_DRAW = 'draw';
 export const TOOL_MODE_SELECT = 'select';
 export const POPOVER_TEXT = 'text';

package/src/editor/screenshot.js

@@ -17,8 +17,8 @@ export async function createScreenshotBrowser() {
  * Create a fresh screenshot page/context from an existing browser.
  * Caller must close the returned context.
  */
-export async function createScreenshotPage(browser) {
-  const context = await browser.newContext({ viewport: SCREENSHOT_SIZE });
+export async function createScreenshotPage(browser, screenshotSize = SCREENSHOT_SIZE) {
+  const context = await browser.newContext({ viewport: screenshotSize });
   const page = await context.newPage();
   return { context, page };
 }
@@ -34,6 +34,7 @@ export async function createScreenshotPage(browser) {
  * @param {boolean} [options.useHttp]       – if true, slidesDir is treated as a base URL
  */
 export async function captureSlideScreenshot(page, slideFile, screenshotPath, slidesDir, options = {}) {
+  const screenshotSize = options.screenshotSize || SCREENSHOT_SIZE;
   const slideUrl = options.useHttp
     ? `${slidesDir}/${slideFile}`
     : pathToFileURL(join(slidesDir, slideFile)).href;
@@ -64,7 +65,7 @@ export async function captureSlideScreenshot(page, slideFile, screenshotPath, sl
     const scale = Math.min(width / sourceWidth, height / sourceHeight);
 
     bodyStyle.transform = `scale(${scale})`;
-  }, SCREENSHOT_SIZE);
+  }, screenshotSize);
 
   await page.screenshot({
     path: screenshotPath,

package/src/export-resolution.cjs

@@ -1,8 +1,13 @@
-const RESOLUTION_PRESETS = Object.freeze({
-  '720p': { width: 1280, height: 720 },
-  '1080p': { width: 1920, height: 1080 },
-  '1440p': { width: 2560, height: 1440 },
-  '2160p': { width: 3840, height: 2160 },
+const {
+  DEFAULT_SLIDE_MODE,
+  getSlideModeConfig,
+} = require('./slide-mode.cjs');
+
+const RESOLUTION_HEIGHTS = Object.freeze({
+  '720p': 720,
+  '1080p': 1080,
+  '1440p': 1440,
+  '2160p': 2160,
 });
 
 const RESOLUTION_ALIASES = Object.freeze({
@@ -11,7 +16,7 @@ const RESOLUTION_ALIASES = Object.freeze({
 });
 
 function getResolutionChoices() {
-  return Object.keys(RESOLUTION_PRESETS);
+  return Object.keys(RESOLUTION_HEIGHTS);
 }
 
 function normalizeResolutionPreset(value, options = {}) {
@@ -33,25 +38,30 @@ function normalizeResolutionPreset(value, options = {}) {
   }
 
   const normalized = RESOLUTION_ALIASES[trimmed] || trimmed;
-  if (!RESOLUTION_PRESETS[normalized]) {
+  if (!RESOLUTION_HEIGHTS[normalized]) {
     throw new Error(`Unknown resolution "${value}". Expected one of: ${getResolutionChoices().join(', ')}, 4k`);
   }
 
   return normalized;
 }
 
-function getResolutionSize(value) {
+function getResolutionSize(value, slideMode = DEFAULT_SLIDE_MODE) {
   const normalized = normalizeResolutionPreset(value);
   if (!normalized) {
     return null;
   }
 
-  const preset = RESOLUTION_PRESETS[normalized];
-  return { width: preset.width, height: preset.height };
+  const height = RESOLUTION_HEIGHTS[normalized];
+  const { framePx } = getSlideModeConfig(slideMode);
+  const aspectRatio = framePx.width / framePx.height;
+  return {
+    width: Math.round(height * aspectRatio),
+    height,
+  };
 }
 
 module.exports = {
-  RESOLUTION_PRESETS,
+  RESOLUTION_PRESETS: RESOLUTION_HEIGHTS,
   getResolutionChoices,
   getResolutionSize,
   normalizeResolutionPreset,

package/src/figma.js

@@ -1,6 +1,13 @@
+import { createRequire } from 'node:module';
 import { mkdir } from 'node:fs/promises';
 import { basename, dirname, extname, join, resolve } from 'node:path';
 
+const require = createRequire(import.meta.url);
+const {
+  DEFAULT_SLIDE_MODE,
+  getSlideModeConfig,
+} = require('./slide-mode.cjs');
+
 export const DEFAULT_FIGMA_SUFFIX = '-figma.pptx';
 export const SLIDE_FILE_PATTERN = /^slide-.*\.html$/i;
 export const FIGMA_EXPORT_LAYOUT_NAME = 'SLIDES_GRAB_STANDARD';
@@ -36,11 +43,12 @@ export function getFigmaManualImportInstructions() {
   return 'Figma Slides -> Import -> select the generated .pptx file.';
 }
 
-export function configureFigmaExportPresentation(pres) {
+export function configureFigmaExportPresentation(pres, slideMode = DEFAULT_SLIDE_MODE) {
+  const { figmaSizeIn } = getSlideModeConfig(slideMode);
   pres.defineLayout({
     name: FIGMA_EXPORT_LAYOUT_NAME,
-    width: SLIDE_WIDTH_INCHES,
-    height: SLIDE_HEIGHT_INCHES,
+    width: figmaSizeIn.width,
+    height: figmaSizeIn.height,
   });
   pres.layout = FIGMA_EXPORT_LAYOUT_NAME;
   return pres;

package/src/pptx-raster-export.cjs

@@ -9,14 +9,19 @@ const {
   getResolutionSize,
   normalizeResolutionPreset,
 } = require('./export-resolution.cjs');
+const {
+  DEFAULT_SLIDE_MODE,
+  getSlideModeChoices,
+  getSlideModeConfig,
+  normalizeSlideMode,
+} = require('./slide-mode.cjs');
 
 const DEFAULT_SLIDES_DIR = 'slides';
 const DEFAULT_OUTPUT = 'output.pptx';
 const DEFAULT_RESOLUTION = '2160p';
-const DEFAULT_CAPTURE_VIEWPORT = { width: 960, height: 540 };
 const DEFAULT_CAPTURE_DEVICE_SCALE_FACTOR = 2;
 const TARGET_RASTER_DPI = 150;
-const TARGET_SLIDE_SIZE_IN = { width: 13.33, height: 7.5 };
+const SLIDE_FILE_PATTERN = /^slide-.*\.html$/i;
 
 function normalizeDimension(value, fallback) {
   if (!Number.isFinite(value) || value <= 0) {
@@ -25,31 +30,63 @@ function normalizeDimension(value, fallback) {
   return Math.max(1, Math.round(value));
 }
 
-function buildPageOptions(resolution = '') {
-  const targetResolution = getResolutionSize(resolution);
+function buildPageOptions(resolution = '', slideMode = DEFAULT_SLIDE_MODE) {
+  const { framePx } = getSlideModeConfig(slideMode);
+  const targetResolution = getResolutionSize(resolution, slideMode);
   return {
     viewport: {
-      width: DEFAULT_CAPTURE_VIEWPORT.width,
-      height: DEFAULT_CAPTURE_VIEWPORT.height,
+      width: framePx.width,
+      height: framePx.height,
     },
     deviceScaleFactor: targetResolution
-      ? targetResolution.height / DEFAULT_CAPTURE_VIEWPORT.height
+      ? targetResolution.height / framePx.height
       : DEFAULT_CAPTURE_DEVICE_SCALE_FACTOR,
   };
 }
 
-function getTargetRasterSize(resolution = '') {
-  const targetResolution = getResolutionSize(resolution);
+function getTargetRasterSize(resolution = '', slideMode = DEFAULT_SLIDE_MODE) {
+  const targetResolution = getResolutionSize(resolution, slideMode);
   if (targetResolution) {
     return targetResolution;
   }
 
+  const { pptxSizeIn } = getSlideModeConfig(slideMode);
   return {
-    width: Math.round(TARGET_SLIDE_SIZE_IN.width * TARGET_RASTER_DPI),
-    height: Math.round(TARGET_SLIDE_SIZE_IN.height * TARGET_RASTER_DPI),
+    width: Math.round(pptxSizeIn.width * TARGET_RASTER_DPI),
+    height: Math.round(pptxSizeIn.height * TARGET_RASTER_DPI),
   };
 }
 
+function toSlideOrder(fileName) {
+  const match = fileName.match(/\d+/);
+  return match ? Number.parseInt(match[0], 10) : Number.POSITIVE_INFINITY;
+}
+
+function sortSlideFiles(a, b) {
+  const orderA = toSlideOrder(a);
+  const orderB = toSlideOrder(b);
+  if (orderA !== orderB) {
+    return orderA - orderB;
+  }
+  return a.localeCompare(b);
+}
+
+function getHtmlSlides(slidesDir) {
+  if (!fs.existsSync(slidesDir)) {
+    throw new Error(`Slides directory not found: ${slidesDir}`);
+  }
+
+  const files = fs.readdirSync(slidesDir)
+    .filter((fileName) => SLIDE_FILE_PATTERN.test(fileName))
+    .sort(sortSlideFiles);
+
+  if (files.length === 0) {
+    throw new Error(`No slide-*.html files found in ${slidesDir}`);
+  }
+
+  return files;
+}
+
 function printUsage() {
   process.stdout.write(
     [
@@ -58,6 +95,7 @@ function printUsage() {
       'Options:',
       `  --slides-dir <path>  Slide directory (default: ${DEFAULT_SLIDES_DIR})`,
       `  --output <path>      Output pptx path (default: ${DEFAULT_OUTPUT})`,
+      `  --mode <mode>        Slide mode: ${getSlideModeChoices().join('|')} (default: ${DEFAULT_SLIDE_MODE})`,
       `  --resolution <preset> Raster size preset: ${getResolutionChoices().join('|')}|4k (default: ${DEFAULT_RESOLUTION})`,
       '  -h, --help           Show this help message',
     ].join('\n'),
@@ -77,6 +115,7 @@ function parseArgs(args) {
   const options = {
     slidesDir: DEFAULT_SLIDES_DIR,
     output: DEFAULT_OUTPUT,
+    mode: DEFAULT_SLIDE_MODE,
     resolution: DEFAULT_RESOLUTION,
     help: false,
   };
@@ -110,6 +149,17 @@ function parseArgs(args) {
       continue;
     }
 
+    if (arg === '--mode') {
+      options.mode = normalizeSlideMode(readOptionValue(args, i, '--mode'));
+      i += 1;
+      continue;
+    }
+
+    if (arg.startsWith('--mode=')) {
+      options.mode = normalizeSlideMode(arg.slice('--mode='.length));
+      continue;
+    }
+
     if (arg === '--resolution') {
       options.resolution = normalizeResolutionPreset(readOptionValue(args, i, '--resolution'));
       i += 1;
@@ -134,14 +184,17 @@ function parseArgs(args) {
 
   options.slidesDir = options.slidesDir.trim();
   options.output = options.output.trim();
+  options.mode = normalizeSlideMode(options.mode);
   options.resolution = normalizeResolutionPreset(options.resolution);
   return options;
 }
 
 async function convertSlide(htmlFile, pres, browser, options = {}) {
   const filePath = path.isAbsolute(htmlFile) ? htmlFile : path.join(process.cwd(), htmlFile);
+  const slideMode = normalizeSlideMode(options.mode || DEFAULT_SLIDE_MODE);
+  const fallbackSize = getSlideModeConfig(slideMode).framePx;
 
-  const page = await browser.newPage(buildPageOptions(options.resolution));
+  const page = await browser.newPage(buildPageOptions(options.resolution, slideMode));
   await page.goto(`file://${filePath}`);
 
   const bodyDimensions = await page.evaluate(() => {
@@ -154,14 +207,14 @@ async function convertSlide(htmlFile, pres, browser, options = {}) {
   });
 
   await page.setViewportSize({
-    width: normalizeDimension(bodyDimensions.width, DEFAULT_CAPTURE_VIEWPORT.width),
-    height: normalizeDimension(bodyDimensions.height, DEFAULT_CAPTURE_VIEWPORT.height),
+    width: normalizeDimension(bodyDimensions.width, fallbackSize.width),
+    height: normalizeDimension(bodyDimensions.height, fallbackSize.height),
   });
 
   const screenshot = await page.screenshot({ type: 'png' });
   await page.close();
 
-  const targetSize = getTargetRasterSize(options.resolution);
+  const targetSize = getTargetRasterSize(options.resolution, slideMode);
 
   const resized = await sharp(screenshot)
     .resize(targetSize.width, targetSize.height, { fit: 'fill' })
@@ -191,14 +244,18 @@ async function main(argv = process.argv.slice(2)) {
   }
 
   const pres = new PptxGenJS();
-  pres.layout = 'LAYOUT_WIDE';
+  const { pptxSizeIn } = getSlideModeConfig(options.mode);
+  pres.defineLayout({
+    name: 'SLIDES_GRAB_DYNAMIC',
+    width: pptxSizeIn.width,
+    height: pptxSizeIn.height,
+  });
+  pres.layout = 'SLIDES_GRAB_DYNAMIC';
 
   const slidesDir = path.resolve(process.cwd(), options.slidesDir);
   const { ensureSlidesPassValidation } = await import('../scripts/validate-slides.js');
-  await ensureSlidesPassValidation(slidesDir, { exportLabel: 'PPTX export' });
-  const files = fs.readdirSync(slidesDir)
-    .filter((fileName) => fileName.endsWith('.html'))
-    .sort();
+  await ensureSlidesPassValidation(slidesDir, { exportLabel: 'PPTX export', slideMode: options.mode });
+  const files = getHtmlSlides(slidesDir);
 
   console.log(`Converting ${files.length} slides...`);
 
@@ -209,7 +266,7 @@ async function main(argv = process.argv.slice(2)) {
     const filePath = path.join(slidesDir, file);
     console.log(`  Processing: ${file}`);
     try {
-      const tmpPath = await convertSlide(filePath, pres, browser, { resolution: options.resolution });
+      const tmpPath = await convertSlide(filePath, pres, browser, { mode: options.mode, resolution: options.resolution });
       tmpFiles.push(tmpPath);
       console.log(`    ✓ ${file} done`);
     } catch (error) {
@@ -232,6 +289,7 @@ async function main(argv = process.argv.slice(2)) {
 
 module.exports = {
   buildPageOptions,
+  getHtmlSlides,
   getTargetRasterSize,
   main,
   parseArgs,

package/src/slide-mode.cjs

@@ -0,0 +1,72 @@
+const DEFAULT_SLIDE_MODE = 'presentation';
+const PT_TO_PX = 96 / 72;
+
+const SLIDE_MODES = Object.freeze({
+  presentation: Object.freeze({
+    name: 'presentation',
+    framePt: Object.freeze({ width: 720, height: 405 }),
+    framePx: Object.freeze({ width: 720 * PT_TO_PX, height: 405 * PT_TO_PX }),
+    screenshotPx: Object.freeze({ width: 1600, height: 900 }),
+    pptxSizeIn: Object.freeze({ width: 13.33, height: 7.5 }),
+    figmaSizeIn: Object.freeze({ width: 10, height: 5.625 }),
+    sizeLabel: '720pt x 405pt',
+    coordinateSpaceLabel: '960x540',
+    aspectRatioLabel: '16:9',
+  }),
+  'card-news': Object.freeze({
+    name: 'card-news',
+    framePt: Object.freeze({ width: 720, height: 720 }),
+    framePx: Object.freeze({ width: 720 * PT_TO_PX, height: 720 * PT_TO_PX }),
+    screenshotPx: Object.freeze({ width: 1600, height: 1600 }),
+    pptxSizeIn: Object.freeze({ width: 10, height: 10 }),
+    figmaSizeIn: Object.freeze({ width: 10, height: 10 }),
+    sizeLabel: '720pt x 720pt',
+    coordinateSpaceLabel: '960x960',
+    aspectRatioLabel: '1:1',
+  }),
+});
+
+function getSlideModeChoices() {
+  return Object.keys(SLIDE_MODES);
+}
+
+function normalizeSlideMode(value, options = {}) {
+  const {
+    allowEmpty = false,
+    optionName = '--mode',
+  } = options;
+
+  if (typeof value !== 'string') {
+    if (allowEmpty) {
+      return '';
+    }
+    throw new Error(`${optionName} must be one of: ${getSlideModeChoices().join(', ')}`);
+  }
+
+  const normalized = value.trim().toLowerCase();
+  if (normalized === '') {
+    if (allowEmpty) {
+      return '';
+    }
+    throw new Error(`${optionName} must be one of: ${getSlideModeChoices().join(', ')}`);
+  }
+
+  if (!SLIDE_MODES[normalized]) {
+    throw new Error(`Unknown ${optionName} value: ${value}. Expected one of: ${getSlideModeChoices().join(', ')}`);
+  }
+
+  return normalized;
+}
+
+function getSlideModeConfig(value = DEFAULT_SLIDE_MODE) {
+  return SLIDE_MODES[normalizeSlideMode(value, { optionName: '--mode' })];
+}
+
+module.exports = {
+  DEFAULT_SLIDE_MODE,
+  PT_TO_PX,
+  SLIDE_MODES,
+  getSlideModeChoices,
+  getSlideModeConfig,
+  normalizeSlideMode,
+};

package/src/validation/cli.js

@@ -1,3 +1,12 @@
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const {
+  DEFAULT_SLIDE_MODE,
+  getSlideModeChoices,
+  normalizeSlideMode,
+} = require('../slide-mode.cjs');
+
 export const DEFAULT_SLIDES_DIR = 'slides';
 export const DEFAULT_VALIDATE_FORMAT = 'concise';
 export const VALIDATE_FORMATS = ['concise', 'json', 'json-full'];
@@ -14,6 +23,7 @@ export function parseValidateCliArgs(args) {
   const options = {
     slidesDir: DEFAULT_SLIDES_DIR,
     format: DEFAULT_VALIDATE_FORMAT,
+    mode: DEFAULT_SLIDE_MODE,
     help: false,
     slides: [],
   };
@@ -48,6 +58,17 @@ export function parseValidateCliArgs(args) {
       continue;
     }
 
+    if (arg === '--mode') {
+      options.mode = normalizeSlideMode(readOptionValue(args, i, '--mode'));
+      i += 1;
+      continue;
+    }
+
+    if (arg.startsWith('--mode=')) {
+      options.mode = normalizeSlideMode(arg.slice('--mode='.length));
+      continue;
+    }
+
     if (arg === '--slide') {
       options.slides.push(readOptionValue(args, i, '--slide'));
       i += 1;
@@ -72,6 +93,7 @@ export function parseValidateCliArgs(args) {
 
   options.slidesDir = options.slidesDir.trim();
   options.format = options.format.trim();
+  options.mode = normalizeSlideMode(options.mode);
 
   if (!VALIDATE_FORMATS.includes(options.format)) {
     throw new Error(`Unknown --format value: ${options.format}. Expected one of: ${VALIDATE_FORMATS.join(', ')}`);
@@ -91,6 +113,7 @@ export function getValidateUsage() {
     'Options:',
     `  --slides-dir <path>  Slide directory (default: ${DEFAULT_SLIDES_DIR})`,
     `  --format <format>   Output format: ${VALIDATE_FORMATS.join(', ')} (default: ${DEFAULT_VALIDATE_FORMAT})`,
+    `  --mode <mode>       Slide mode: ${getSlideModeChoices().join(', ')} (default: ${DEFAULT_SLIDE_MODE})`,
     '  --slide <file>      Validate only the named slide file (repeatable)',
     '  -h, --help           Show this help message',
   ].join('\n');