@json-to-office/core-pptx 0.19.0 → 0.21.0

package/dist/index.js

@@ -1,5 +1,4 @@
 // src/core/generator.ts
-import JSZip from "jszip";
 import { writeFileSync } from "fs";
 
 // src/types.ts
@@ -311,8 +310,7 @@ function resolveComponentTree(components, theme) {
 import { mergeWithDefaults as mergeWithDefaults2 } from "@json-to-office/shared";
 function processPresentation(document, options) {
   const { props, children = [] } = document;
-  const themeName = props.theme ?? "default";
-  const baseTheme = options?.customThemes?.[themeName] ?? getPptxTheme(themeName);
+  const baseTheme = typeof props.theme === "object" && props.theme !== null ? props.theme : options?.customThemes?.[props.theme ?? "default"] ?? getPptxTheme(props.theme ?? "default");
   const presDefaults = props.componentDefaults;
   const theme = presDefaults ? {
     ...baseTheme,
@@ -413,12 +411,25 @@ var SEMANTIC_TO_THEME_KEY = {
   bg1: "background",
   bg2: "background2"
 };
+var DEFAULT_CHART_THEME_COLORS = [
+  "primary",
+  "secondary",
+  "accent",
+  "accent4",
+  "accent5",
+  "accent6"
+];
 function resolveColor(color, theme, warnings) {
   const themeKey = SEMANTIC_TO_THEME_KEY[color];
   if (themeKey) {
     const resolved = theme.colors[themeKey];
-    if (resolved) return resolved.startsWith("#") ? resolved.slice(1) : resolved;
-    warn(warnings, W.THEME_COLOR_FALLBACK, `Theme color "${themeKey}" not defined, falling back to primary`);
+    if (resolved)
+      return resolved.startsWith("#") ? resolved.slice(1) : resolved;
+    warn(
+      warnings,
+      W.THEME_COLOR_FALLBACK,
+      `Theme color "${themeKey}" not defined, falling back to primary`
+    );
     return theme.colors.primary.startsWith("#") ? theme.colors.primary.slice(1) : theme.colors.primary;
   }
   const bare = color.startsWith("#") ? color.slice(1) : color;
@@ -426,7 +437,11 @@ function resolveColor(color, theme, warnings) {
     return bare[0] + bare[0] + bare[1] + bare[1] + bare[2] + bare[2];
   }
   if (!/^[0-9A-Fa-f]{6}$/.test(bare)) {
-    warn(warnings, W.UNKNOWN_COLOR, `Unknown color value: "${color}", treating as literal`);
+    warn(
+      warnings,
+      W.UNKNOWN_COLOR,
+      `Unknown color value: "${color}", treating as literal`
+    );
   }
   return bare;
 }
@@ -1113,8 +1128,21 @@ Cause: ${error instanceof Error ? error.message : String(error)}`
     height: config.options.chart?.height ?? 720
   };
 }
-async function renderHighchartsComponent(slide, props, _theme, _warnings, servicesConfig) {
-  const chart = await generateChart(props, servicesConfig);
+function withThemeColors(props, theme, warnings) {
+  if (!props.options || props.options.colors || !theme?.colors) return props;
+  const palette = DEFAULT_CHART_THEME_COLORS.map(
+    (token) => `#${resolveColor(token, theme, warnings)}`
+  );
+  return {
+    ...props,
+    options: { ...props.options, colors: palette }
+  };
+}
+async function renderHighchartsComponent(slide, props, theme, warnings, servicesConfig) {
+  const chart = await generateChart(
+    withThemeColors(props, theme, warnings),
+    servicesConfig
+  );
   const w = props.w ?? chart.width / PX_PER_INCH;
   const h = props.h ?? chart.height / PX_PER_INCH;
   slide.addImage({
@@ -1138,25 +1166,39 @@ var CHART_TYPE_MAP = {
   radar: "radar",
   scatter: "scatter"
 };
-var DEFAULT_THEME_COLORS = ["primary", "secondary", "accent", "accent4", "accent5", "accent6"];
+var DEFAULT_THEME_COLORS = DEFAULT_CHART_THEME_COLORS;
 function renderChartComponent(slide, props, theme, _pptx, warnings) {
   const chartType = CHART_TYPE_MAP[props.type];
   if (!chartType) {
-    warn(warnings, W.UNKNOWN_CHART_TYPE, `Unknown chart type: ${props.type}`, { component: "chart" });
+    warn(warnings, W.UNKNOWN_CHART_TYPE, `Unknown chart type: ${props.type}`, {
+      component: "chart"
+    });
     return;
   }
   if (!props.data || props.data.length === 0) {
-    warn(warnings, W.CHART_NO_DATA, "Chart component has no data series", { component: "chart" });
+    warn(warnings, W.CHART_NO_DATA, "Chart component has no data series", {
+      component: "chart"
+    });
     return;
   }
   for (const series of props.data) {
     if (!series.labels || !series.values) {
-      warn(warnings, W.CHART_INVALID_SERIES, `Chart series "${series.name ?? "(unnamed)"}" missing labels or values`, { component: "chart" });
+      warn(
+        warnings,
+        W.CHART_INVALID_SERIES,
+        `Chart series "${series.name ?? "(unnamed)"}" missing labels or values`,
+        { component: "chart" }
+      );
       return;
     }
   }
   if ((chartType === "pie" || chartType === "doughnut") && props.data.length > 1) {
-    warn(warnings, W.CHART_MULTI_SERIES, `${props.type} chart has ${props.data.length} series \u2014 only the first will render`, { component: "chart" });
+    warn(
+      warnings,
+      W.CHART_MULTI_SERIES,
+      `${props.type} chart has ${props.data.length} series \u2014 only the first will render`,
+      { component: "chart" }
+    );
   }
   const data = props.data.map((series) => {
     const d = {};
@@ -1185,41 +1227,60 @@ function renderChartComponent(slide, props, theme, _pptx, warnings) {
   if (props.showLabel !== void 0) opts.showLabel = props.showLabel;
   if (props.showSerName !== void 0) opts.showSerName = props.showSerName;
   if (props.title !== void 0) opts.title = props.title;
-  if (props.titleFontSize !== void 0) opts.titleFontSize = props.titleFontSize;
-  if (props.titleFontFace !== void 0) opts.titleFontFace = props.titleFontFace;
+  if (props.titleFontSize !== void 0)
+    opts.titleFontSize = props.titleFontSize;
+  if (props.titleFontFace !== void 0)
+    opts.titleFontFace = props.titleFontFace;
   if (props.legendPos !== void 0) opts.legendPos = props.legendPos;
-  if (props.legendFontSize !== void 0) opts.legendFontSize = props.legendFontSize;
-  if (props.legendFontFace !== void 0) opts.legendFontFace = props.legendFontFace;
+  if (props.legendFontSize !== void 0)
+    opts.legendFontSize = props.legendFontSize;
+  if (props.legendFontFace !== void 0)
+    opts.legendFontFace = props.legendFontFace;
   if (props.catAxisTitle !== void 0) {
     opts.catAxisTitle = props.catAxisTitle;
     opts.showCatAxisTitle = true;
   }
-  if (props.catAxisHidden !== void 0) opts.catAxisHidden = props.catAxisHidden;
-  if (props.catAxisLabelRotate !== void 0) opts.catAxisLabelRotate = props.catAxisLabelRotate;
-  if (props.catAxisLabelFontSize !== void 0) opts.catAxisLabelFontSize = props.catAxisLabelFontSize;
+  if (props.catAxisHidden !== void 0)
+    opts.catAxisHidden = props.catAxisHidden;
+  if (props.catAxisLabelRotate !== void 0)
+    opts.catAxisLabelRotate = props.catAxisLabelRotate;
+  if (props.catAxisLabelFontSize !== void 0)
+    opts.catAxisLabelFontSize = props.catAxisLabelFontSize;
   if (props.valAxisTitle !== void 0) {
     opts.valAxisTitle = props.valAxisTitle;
     opts.showValAxisTitle = true;
   }
-  if (props.valAxisHidden !== void 0) opts.valAxisHidden = props.valAxisHidden;
-  if (props.valAxisMinVal !== void 0) opts.valAxisMinVal = props.valAxisMinVal;
-  if (props.valAxisMaxVal !== void 0) opts.valAxisMaxVal = props.valAxisMaxVal;
-  if (props.valAxisLabelFormatCode !== void 0) opts.valAxisLabelFormatCode = props.valAxisLabelFormatCode;
-  if (props.valAxisMajorUnit !== void 0) opts.valAxisMajorUnit = props.valAxisMajorUnit;
+  if (props.valAxisHidden !== void 0)
+    opts.valAxisHidden = props.valAxisHidden;
+  if (props.valAxisMinVal !== void 0)
+    opts.valAxisMinVal = props.valAxisMinVal;
+  if (props.valAxisMaxVal !== void 0)
+    opts.valAxisMaxVal = props.valAxisMaxVal;
+  if (props.valAxisLabelFormatCode !== void 0)
+    opts.valAxisLabelFormatCode = props.valAxisLabelFormatCode;
+  if (props.valAxisMajorUnit !== void 0)
+    opts.valAxisMajorUnit = props.valAxisMajorUnit;
   if (props.barDir !== void 0) opts.barDir = props.barDir;
   if (props.barGrouping !== void 0) opts.barGrouping = props.barGrouping;
-  if (props.barGapWidthPct !== void 0) opts.barGapWidthPct = props.barGapWidthPct;
+  if (props.barGapWidthPct !== void 0)
+    opts.barGapWidthPct = props.barGapWidthPct;
   if (props.lineSmooth !== void 0) opts.lineSmooth = props.lineSmooth;
-  if (props.lineDataSymbol !== void 0) opts.lineDataSymbol = props.lineDataSymbol;
+  if (props.lineDataSymbol !== void 0)
+    opts.lineDataSymbol = props.lineDataSymbol;
   if (props.lineSize !== void 0) opts.lineSize = props.lineSize;
-  if (props.firstSliceAng !== void 0) opts.firstSliceAng = props.firstSliceAng;
+  if (props.firstSliceAng !== void 0)
+    opts.firstSliceAng = props.firstSliceAng;
   if (props.holeSize !== void 0) opts.holeSize = props.holeSize;
   if (props.radarStyle !== void 0) opts.radarStyle = props.radarStyle;
   opts.dataLabelColor = props.dataLabelColor ? resolveColor(props.dataLabelColor, theme, warnings) : themeTextColor;
-  if (props.dataLabelFontSize !== void 0) opts.dataLabelFontSize = props.dataLabelFontSize;
-  if (props.dataLabelFontFace !== void 0) opts.dataLabelFontFace = props.dataLabelFontFace;
-  if (props.dataLabelFontBold !== void 0) opts.dataLabelFontBold = props.dataLabelFontBold;
-  if (props.dataLabelPosition !== void 0) opts.dataLabelPosition = props.dataLabelPosition;
+  if (props.dataLabelFontSize !== void 0)
+    opts.dataLabelFontSize = props.dataLabelFontSize;
+  if (props.dataLabelFontFace !== void 0)
+    opts.dataLabelFontFace = props.dataLabelFontFace;
+  if (props.dataLabelFontBold !== void 0)
+    opts.dataLabelFontBold = props.dataLabelFontBold;
+  if (props.dataLabelPosition !== void 0)
+    opts.dataLabelPosition = props.dataLabelPosition;
   slide.addChart(chartType, data, opts);
 }
 
@@ -1550,13 +1611,161 @@ async function resolveDocumentFonts(document, theme, warnings, fonts) {
 
 // src/core/generator.ts
 import { applyExportMode, scopedThemeName } from "@json-to-office/shared";
-import { collectImageSourceConflicts } from "@json-to-office/shared-pptx";
+import {
+  collectImageSourceConflicts,
+  validateJsonPresentationDocument,
+  validatePresentationDocument
+} from "@json-to-office/shared-pptx";
+
+// src/core/packagePresentation.ts
+import JSZip from "jszip";
+var MEDIUM_STYLE_2_ACCENT_1 = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
+var NO_STYLE_NO_GRID = "{2D5ABB26-0587-4C30-8999-92F81FD0307C}";
+var DEFAULT_GENERATED_AT = "2000-01-01T00:00:00.000Z";
+function resolveGeneratedAt(value) {
+  const date = value === void 0 ? new Date(DEFAULT_GENERATED_AT) : new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    throw new Error(`Invalid generatedAt value: ${String(value)}`);
+  }
+  if (date.getUTCFullYear() < 1980) {
+    throw new Error(
+      "generatedAt must be on or after 1980-01-01 for ZIP compatibility"
+    );
+  }
+  return date;
+}
+function replaceCoreTimestamp(xml, tag, value) {
+  const expression = new RegExp(
+    `(<dcterms:${tag}\\b[^>]*>)[^<]*(</dcterms:${tag}>)`,
+    "g"
+  );
+  return xml.replace(expression, `$1${value}$2`);
+}
+var EMBEDDED_OFFICE_PACKAGE = /\.(?:docx|pptx|xlsx|xlsm)$/i;
+function remapChartReferences(value, chartIds) {
+  return value.replace(/chart(\d+)\.xml/g, (match, rawId) => {
+    const id = chartIds.get(Number(rawId));
+    return id === void 0 ? match : `chart${id}.xml`;
+  }).replace(
+    /Microsoft_Excel_Worksheet(\d+)\.xlsx/g,
+    (match, rawId) => {
+      const id = chartIds.get(Number(rawId));
+      return id === void 0 ? match : `Microsoft_Excel_Worksheet${id}.xlsx`;
+    }
+  );
+}
+async function canonicalizeChartIds(zip) {
+  const sourceIds = Object.keys(zip.files).map((path2) => path2.match(/^ppt\/charts\/chart(\d+)\.xml$/)?.[1]).filter((value) => value !== void 0).map(Number).sort((a, b) => a - b);
+  const chartIds = new Map(sourceIds.map((id, index) => [id, index + 1]));
+  if (chartIds.size === 0) return;
+  for (const [path2, entry] of Object.entries(zip.files)) {
+    if (entry.dir || !path2.endsWith(".xml") && !path2.endsWith(".rels")) {
+      continue;
+    }
+    const xml = await entry.async("string");
+    const remapped = remapChartReferences(xml, chartIds);
+    if (remapped !== xml) zip.file(path2, remapped);
+  }
+  const renames = [];
+  for (const [path2, entry] of Object.entries(zip.files)) {
+    if (entry.dir) continue;
+    const remappedPath = remapChartReferences(path2, chartIds);
+    if (remappedPath === path2) continue;
+    renames.push({
+      from: path2,
+      to: remappedPath,
+      data: await entry.async("nodebuffer"),
+      date: entry.date
+    });
+  }
+  for (const entry of renames) zip.remove(entry.from);
+  for (const entry of renames) {
+    zip.file(entry.to, entry.data, { date: entry.date });
+  }
+}
+async function generateZip(zip) {
+  return await zip.generateAsync({
+    type: "nodebuffer",
+    compression: "DEFLATE",
+    compressionOptions: { level: 6 },
+    platform: "DOS",
+    streamFiles: false
+  });
+}
+async function canonicalizePackage(zip, generatedAt, depth = 0) {
+  const timestamp = generatedAt.toISOString().replace(/\.\d{3}Z$/, "Z");
+  const coreEntry = zip.file("docProps/core.xml");
+  if (coreEntry) {
+    let coreXml = await coreEntry.async("string");
+    coreXml = replaceCoreTimestamp(coreXml, "created", timestamp);
+    coreXml = replaceCoreTimestamp(coreXml, "modified", timestamp);
+    zip.file("docProps/core.xml", coreXml);
+  }
+  if (depth < 3) {
+    for (const [path2, entry] of Object.entries(zip.files)) {
+      if (entry.dir || !EMBEDDED_OFFICE_PACKAGE.test(path2)) continue;
+      try {
+        const nested = await JSZip.loadAsync(await entry.async("nodebuffer"));
+        await canonicalizePackage(nested, generatedAt, depth + 1);
+        zip.file(path2, await generateZip(nested));
+      } catch {
+      }
+    }
+  }
+  for (const entry of Object.values(zip.files)) {
+    entry.date = generatedAt;
+  }
+}
+async function packagePresentationBuffer(buffer, options = {}) {
+  const zip = await JSZip.loadAsync(buffer);
+  let changed = false;
+  for (const [path2, entry] of Object.entries(zip.files)) {
+    if (!path2.match(/^ppt\/slides\/slide\d+\.xml$/)) continue;
+    const xml = await entry.async("string");
+    if (xml.includes(MEDIUM_STYLE_2_ACCENT_1)) {
+      zip.file(path2, xml.replaceAll(MEDIUM_STYLE_2_ACCENT_1, NO_STYLE_NO_GRID));
+      changed = true;
+    }
+  }
+  if (options.deterministic !== false) {
+    const generatedAt = resolveGeneratedAt(options.generatedAt);
+    await canonicalizeChartIds(zip);
+    await canonicalizePackage(zip, generatedAt);
+    changed = true;
+  }
+  if (!changed) return buffer;
+  return generateZip(zip);
+}
+
+// src/core/generator.ts
+var PresentationValidationError = class extends Error {
+  errors;
+  constructor(errors) {
+    super(
+      `Presentation validation failed:
+${errors.map((error) => `  - ${error.path}: ${error.message}`).join("\n")}`
+    );
+    this.name = "PresentationValidationError";
+    this.errors = errors;
+  }
+};
+function assertValidPresentation(input, validation) {
+  if (validation?.enabled === false) return;
+  const options = {
+    allowUnknownFields: validation?.allowUnknownFields
+  };
+  const result = typeof input === "string" ? validateJsonPresentationDocument(input, options) : validatePresentationDocument(input, options);
+  if (!result.valid) {
+    throw new PresentationValidationError(result.errors);
+  }
+}
 function isPresentationComponentDefinition(definition) {
   if (typeof definition !== "object" || definition === null) return false;
   const def = definition;
   return def.name === "pptx" && "props" in def;
 }
 async function generatePresentation(document, options, warnings) {
+  assertValidPresentation(document, options?.validation);
   if (!document || document.name !== "pptx") {
     throw new Error("Top-level component must be a pptx component");
   }
@@ -1575,6 +1784,7 @@ async function generateBufferFromJson(jsonConfig, options) {
   return result.buffer;
 }
 async function generateBufferWithWarnings(jsonConfig, options) {
+  assertValidPresentation(jsonConfig, options?.validation);
   let component;
   if (typeof jsonConfig === "string") {
     const parsed = JSON.parse(jsonConfig);
@@ -1586,6 +1796,21 @@ async function generateBufferWithWarnings(jsonConfig, options) {
     component = jsonConfig;
   }
   const warnings = [];
+  if (typeof component.props?.theme === "object" && component.props.theme !== null) {
+    const inlineTheme = component.props.theme;
+    const inlineName = inlineTheme.name || "inline-theme";
+    component = {
+      ...component,
+      props: { ...component.props, theme: inlineName }
+    };
+    options = {
+      ...options,
+      customThemes: {
+        ...options?.customThemes ?? {},
+        [inlineName]: inlineTheme
+      }
+    };
+  }
   const baseThemeName = component.props?.theme ?? "default";
   let resolvedTheme = options?.customThemes?.[baseThemeName] ?? getPptxTheme(baseThemeName);
   const mode = applyExportMode({
@@ -1628,36 +1853,21 @@ async function generateBufferWithWarnings(jsonConfig, options) {
     warnings
   );
   const data = await pptx.write({ outputType: "nodebuffer" });
-  const buffer = await neutralizeTableStyle(data);
+  const buffer = await packagePresentationBuffer(data, options);
   return { buffer, warnings };
 }
 async function generateAndSaveFromJson(jsonConfig, outputPath, options) {
   const buffer = await generateBufferFromJson(jsonConfig, options);
   writeFileSync(outputPath, buffer);
 }
-async function generateFromFile(filePath, outputPath) {
+async function generateFromFile(filePath, outputPath, options) {
   const { readFileSync } = await import("fs");
   const json = readFileSync(filePath, "utf-8");
-  await generateAndSaveFromJson(json, outputPath);
+  await generateAndSaveFromJson(json, outputPath, options);
 }
-var MEDIUM_STYLE_2_ACCENT_1 = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
-var NO_STYLE_NO_GRID = "{2D5ABB26-0587-4C30-8999-92F81FD0307C}";
-async function neutralizeTableStyle(buffer) {
-  const zip = await JSZip.loadAsync(buffer);
-  let changed = false;
-  for (const [path2, entry] of Object.entries(zip.files)) {
-    if (!path2.match(/^ppt\/slides\/slide\d+\.xml$/)) continue;
-    const xml = await entry.async("string");
-    if (xml.includes(MEDIUM_STYLE_2_ACCENT_1)) {
-      zip.file(path2, xml.replaceAll(MEDIUM_STYLE_2_ACCENT_1, NO_STYLE_NO_GRID));
-      changed = true;
-    }
-  }
-  return changed ? await zip.generateAsync({ type: "nodebuffer" }) : buffer;
-}
-async function savePresentation(pptx, outputPath) {
+async function savePresentation(pptx, outputPath, options) {
   const data = await pptx.write({ outputType: "nodebuffer" });
-  const buffer = await neutralizeTableStyle(data);
+  const buffer = await packagePresentationBuffer(data, options);
   writeFileSync(outputPath, buffer);
 }
 var PresentationGenerator = {
@@ -1677,7 +1887,6 @@ import {
 } from "@json-to-office/shared/plugin";
 
 // src/plugin/createPresentationGenerator.ts
-import JSZip2 from "jszip";
 import {
   resolveComponentVersion as resolveComponentVersion2,
   DuplicateComponentError as DuplicateComponentError2,
@@ -1690,23 +1899,33 @@ import {
   validateCustomComponentProps,
   ComponentValidationError
 } from "@json-to-office/shared/plugin";
-import { collectImageSourceConflicts as collectImageSourceConflicts2 } from "@json-to-office/shared-pptx";
+import { validatePresentationDocument as validatePresentationDocument2 } from "@json-to-office/shared-pptx";
 import {
   DuplicateComponentError,
   ComponentValidationError as ComponentValidationError2
 } from "@json-to-office/shared/plugin";
-function validateComponentProps(schema, props, componentName) {
+function validateComponentProps(schema, props, componentName, opts) {
   return validateCustomComponentProps(schema.propsSchema, props, {
-    clean: true,
-    applyDefaults: true,
+    // Render-time cleaning remains the default. The document-validation path
+    // passes clean:false so unknown custom props are rejected when the custom
+    // schema declares additionalProperties:false.
+    clean: opts?.clean ?? true,
+    applyDefaults: opts?.applyDefaults ?? true,
     componentName
   });
 }
-function validatePresentation(document, customComponents) {
-  const errors = [];
-  errors.push(...collectImageSourceConflicts2(document));
+function validatePresentation(document, customComponents, options) {
+  const knownCustomNames = new Set(customComponents.map((c) => c.name));
+  const documentResult = validatePresentationDocument2(document, {
+    knownCustomNames,
+    allowUnknownFields: options?.allowUnknownFields
+  });
+  const errors = [...documentResult.errors];
   function validateComponents(components, pathPrefix = "children") {
     components.forEach((componentData, index) => {
+      if (!componentData || typeof componentData !== "object" || Array.isArray(componentData)) {
+        return;
+      }
       const customComponent = customComponents.find(
         (cc) => cc.name === componentData.name
       );
@@ -1719,7 +1938,8 @@ function validatePresentation(document, customComponents) {
         const validation = validateComponentProps(
           versionEntry,
           componentData.props,
-          customComponent.name
+          customComponent.name,
+          { clean: options?.allowUnknownFields === true }
         );
         if (!validation.valid && validation.errors) {
           const indexedErrors = validation.errors.map(
@@ -1739,7 +1959,7 @@ function validatePresentation(document, customComponents) {
       }
     });
   }
-  if (document.children) {
+  if (document && Array.isArray(document.children)) {
     validateComponents(document.children);
   }
   return errors.length > 0 ? { valid: false, errors } : { valid: true, errors: [] };
@@ -1789,24 +2009,9 @@ async function exportPluginSchema(customComponents, outputPath, options = {}) {
 
 // src/plugin/createPresentationGenerator.ts
 import { applyExportMode as applyExportMode2, scopedThemeName as scopedThemeName2 } from "@json-to-office/shared";
-var MEDIUM_STYLE_2_ACCENT_12 = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
-var NO_STYLE_NO_GRID2 = "{2D5ABB26-0587-4C30-8999-92F81FD0307C}";
-async function neutralizeTableStyle2(buffer) {
-  const zip = await JSZip2.loadAsync(buffer);
-  let changed = false;
-  for (const [path2, entry] of Object.entries(zip.files)) {
-    if (!path2.match(/^ppt\/slides\/slide\d+\.xml$/)) continue;
-    const xml = await entry.async("string");
-    if (xml.includes(MEDIUM_STYLE_2_ACCENT_12)) {
-      zip.file(path2, xml.replaceAll(MEDIUM_STYLE_2_ACCENT_12, NO_STYLE_NO_GRID2));
-      changed = true;
-    }
-  }
-  return changed ? await zip.generateAsync({ type: "nodebuffer" }) : buffer;
-}
 function createBuilderImpl(state) {
   const componentMap = new Map(state.components.map((c) => [c.name, c]));
-  async function processSlideComponents(components, warningsCollector, theme, depth = 0) {
+  async function processSlideComponents(components, warningsCollector, theme, validateEmitted, parentName, depth = 0) {
     if (depth > 20) {
       throw new Error(
         "Maximum component nesting depth exceeded (20). Check for circular component references."
@@ -1838,6 +2043,8 @@ function createBuilderImpl(state) {
               componentWithVersion.children,
               warningsCollector,
               theme,
+              validateEmitted,
+              void 0,
               depth + 1
             );
           }
@@ -1857,10 +2064,13 @@ function createBuilderImpl(state) {
             children: nestedChildren
           });
           const resultComponents = Array.isArray(result) ? result : [result];
+          validateEmitted?.(resultComponents, versionLabel, parentName);
           const processedResult = await processSlideComponents(
             resultComponents,
             warningsCollector,
             theme,
+            validateEmitted,
+            parentName,
             depth + 1
           );
           processed.push(...processedResult);
@@ -1884,6 +2094,8 @@ function createBuilderImpl(state) {
             componentData.children,
             warningsCollector,
             theme,
+            validateEmitted,
+            componentData.name,
             depth + 1
           );
           processed.push({
@@ -1913,21 +2125,47 @@ function createBuilderImpl(state) {
       customThemes: state.customThemes,
       debug: state.debug,
       services: state.services,
-      fonts: state.fonts
+      fonts: state.fonts,
+      validation: state.validation,
+      packaging: state.packaging
     };
     return createBuilderImpl(
       newState
     );
   }
-  async function generate(document) {
+  async function generate(document, options) {
     try {
-      const internalDocument = document;
-      if (!internalDocument || internalDocument.name !== "pptx") {
+      let internalDocument = document;
+      const validationOptions = {
+        ...state.validation,
+        ...options?.validation
+      };
+      if (validationOptions.enabled !== false) {
+        const result = validatePresentation(
+          internalDocument,
+          state.components,
+          { allowUnknownFields: validationOptions.allowUnknownFields }
+        );
+        if (!result.valid) {
+          throw new ComponentValidationError3(result.errors, internalDocument);
+        }
+      } else if (!internalDocument || internalDocument.name !== "pptx") {
         throw new Error("Top-level component must be a pptx component");
       }
+      let inlineTheme;
+      if (typeof internalDocument.props.theme === "object" && internalDocument.props.theme !== null) {
+        inlineTheme = internalDocument.props.theme;
+        internalDocument = {
+          ...internalDocument,
+          props: {
+            ...internalDocument.props,
+            theme: inlineTheme.name || "inline-theme"
+          }
+        };
+      }
       const docThemeName = internalDocument.props.theme;
       const baseThemeName = docThemeName ?? (typeof state.theme === "string" ? state.theme : "default");
-      let resolvedTheme = state.customThemes?.[baseThemeName] ?? (typeof state.theme === "object" && state.theme !== null ? state.theme : getPptxTheme(baseThemeName));
+      let resolvedTheme = inlineTheme ?? state.customThemes?.[baseThemeName] ?? (typeof state.theme === "object" && state.theme !== null ? state.theme : getPptxTheme(baseThemeName));
       const warnings = [];
       const mode = applyExportMode2({
         doc: internalDocument,
@@ -1942,7 +2180,39 @@ function createBuilderImpl(state) {
           component: "fontRegistry"
         });
       }
-      const processedChildren = mode.doc.children ? await processAllSlides(mode.doc.children, warnings, resolvedTheme) : [];
+      const validateEmitted = validationOptions.enabled === false ? void 0 : (emitted, componentLabel, parentName) => {
+        let validationDocument;
+        if (parentName === "pptx") {
+          validationDocument = { ...mode.doc, children: emitted };
+        } else if (parentName === "slide") {
+          validationDocument = {
+            ...mode.doc,
+            children: [{ name: "slide", props: {}, children: emitted }]
+          };
+        } else {
+          return;
+        }
+        const result = validatePresentation(
+          validationDocument,
+          state.components,
+          { allowUnknownFields: validationOptions.allowUnknownFields }
+        );
+        if (!result.valid) {
+          throw new ComponentValidationError3(
+            result.errors.map((error) => ({
+              ...error,
+              message: `custom component '${componentLabel}' emitted invalid output \u2014 ${error.message}`
+            })),
+            emitted
+          );
+        }
+      };
+      const processedChildren = mode.doc.children ? await processAllSlides(
+        mode.doc.children,
+        warnings,
+        resolvedTheme,
+        validateEmitted
+      ) : [];
       const themeName = scopedThemeName2(baseThemeName, state.fonts?.mode);
       const docWithScopedTheme = themeName !== baseThemeName ? {
         ...mode.doc,
@@ -1950,6 +2220,20 @@ function createBuilderImpl(state) {
         children: processedChildren
       } : { ...mode.doc, children: processedChildren };
       const processedDocument = docWithScopedTheme;
+      if (validationOptions.enabled !== false) {
+        const result = validatePresentation(processedDocument, [], {
+          allowUnknownFields: validationOptions.allowUnknownFields
+        });
+        if (!result.valid) {
+          throw new ComponentValidationError3(
+            result.errors.map((error) => ({
+              ...error,
+              message: `expanded plugin output failed validation \u2014 ${error.message}`
+            })),
+            processedDocument
+          );
+        }
+      }
       await resolveDocumentFonts(
         processedDocument,
         resolvedTheme,
@@ -1966,7 +2250,10 @@ function createBuilderImpl(state) {
       });
       const pptx = await renderPresentation(processed, warnings);
       const data = await pptx.write({ outputType: "nodebuffer" });
-      const buffer = await neutralizeTableStyle2(data);
+      const buffer = await packagePresentationBuffer(data, {
+        deterministic: options?.deterministic ?? state.packaging.deterministic,
+        generatedAt: options?.generatedAt ?? state.packaging.generatedAt
+      });
       return { buffer, warnings };
     } catch (error) {
       if (state.debug) {
@@ -1975,29 +2262,33 @@ function createBuilderImpl(state) {
       throw error;
     }
   }
-  async function processAllSlides(children, warnings, theme) {
+  async function processAllSlides(children, warnings, theme, validateEmitted) {
     const result = [];
     for (const child of children) {
       if (child.name === "slide" && child.children) {
         const processedSlideChildren = await processSlideComponents(
           child.children,
           warnings,
-          theme
+          theme,
+          validateEmitted,
+          "slide"
         );
         result.push({ ...child, children: processedSlideChildren });
       } else {
         const processedTopLevel = await processSlideComponents(
           [child],
           warnings,
-          theme
+          theme,
+          validateEmitted,
+          "pptx"
         );
         result.push(...processedTopLevel);
       }
     }
     return result;
   }
-  async function generateFile(document, outputPath) {
-    const { buffer, warnings } = await generate(document);
+  async function generateFile(document, outputPath, options) {
+    const { buffer, warnings } = await generate(document, options);
     const fs = await import("fs/promises");
     await fs.writeFile(outputPath, new Uint8Array(buffer));
     return { warnings };
@@ -2074,7 +2365,12 @@ function createPresentationGenerator(options = {}) {
     customThemes: options.customThemes,
     debug: options.debug ?? false,
     services: options.services,
-    fonts: options.fonts
+    fonts: options.fonts,
+    validation: options.validation,
+    packaging: {
+      deterministic: options.deterministic,
+      generatedAt: options.generatedAt
+    }
   };
   return createBuilderImpl(initialState);
 }
@@ -2088,9 +2384,11 @@ function getPptxCoreVersion() {
 }
 export {
   ComponentValidationError2 as ComponentValidationError,
+  DEFAULT_GENERATED_AT,
   DEFAULT_PPTX_THEME,
   DuplicateComponentError,
   PresentationGenerator,
+  PresentationValidationError,
   W as WarningCodes,
   cleanComponentProps,
   createComponent,
@@ -2108,6 +2406,7 @@ export {
   isPresentationComponent,
   isPresentationComponentDefinition,
   isSlideComponent,
+  packagePresentationBuffer,
   pptxThemes,
   renderComponent,
   renderHighchartsComponent,