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

package/dist/core/generator.d.ts

@@ -6,13 +6,22 @@
 import PptxGenJS from 'pptxgenjs';
 import type { PresentationComponentDefinition, PptxThemeConfig, PipelineWarning } from '../types';
 import type { ServicesConfig, FontRuntimeOpts } from '@json-to-office/shared';
+import { type ValidationError } from '@json-to-office/shared-pptx';
+import { type PresentationPackagingOptions } from './packagePresentation';
+export interface GenerationValidationOptions {
+    /** Validate the complete component tree before rendering. Defaults to true. */
+    enabled?: boolean;
+    /** Accept unknown props while still enforcing required fields and types. */
+    allowUnknownFields?: boolean;
+}
 /**
  * Options for the generation pipeline
  */
-export interface GenerationOptions {
+export interface GenerationOptions extends PresentationPackagingOptions {
     customThemes?: Record<string, PptxThemeConfig>;
     services?: ServicesConfig;
     fonts?: FontRuntimeOpts;
+    validation?: GenerationValidationOptions;
 }
 /**
  * Result from generateBufferWithWarnings
@@ -21,6 +30,11 @@ export interface GenerationResult {
     buffer: Buffer;
     warnings: PipelineWarning[];
 }
+/** Error thrown when a presentation fails the generation validation gate. */
+export declare class PresentationValidationError extends Error {
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}
 /**
  * Type guard for presentation component
  */
@@ -44,11 +58,11 @@ export declare function generateAndSaveFromJson(jsonConfig: string | Presentatio
 /**
  * Generate from a JSON file path
  */
-export declare function generateFromFile(filePath: string, outputPath: string): Promise<void>;
+export declare function generateFromFile(filePath: string, outputPath: string, options?: GenerationOptions): Promise<void>;
 /**
  * Save a PptxGenJS instance to file
  */
-export declare function savePresentation(pptx: PptxGenJS, outputPath: string): Promise<void>;
+export declare function savePresentation(pptx: PptxGenJS, outputPath: string, options?: PresentationPackagingOptions): Promise<void>;
 /**
  * Export the main API
  */

package/dist/core/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;;AAEH,OAAO,SAAS,MAAM,WAAW,CAAC;AAGlC,OAAO,KAAK,EACV,+BAA+B,EAC/B,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQ9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAID;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,OAAO,GAClB,UAAU,IAAI,+BAA+B,CAI/C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,+BAA+B,EACzC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,SAAS,CAAC,CAoBpB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GAAG,+BAA+B,EACpD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,GAAG,+BAA+B,EACpD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CA4F3B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GAAG,+BAA+B,EACpD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAyBD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;CAQjC,CAAC"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;;AAEH,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EACV,+BAA+B,EAC/B,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9E,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,4BAA4B;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAID;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,6EAA6E;AAC7E,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;gBAE9B,MAAM,EAAE,eAAe,EAAE;CAStC;AAqBD;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,OAAO,GAClB,UAAU,IAAI,+BAA+B,CAI/C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,+BAA+B,EACzC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,SAAS,CAAC,CAsBpB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GAAG,+BAA+B,EACpD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,GAAG,+BAA+B,EACpD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CA8F3B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GAAG,+BAA+B,EACpD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;CAQjC,CAAC"}

package/dist/core/packagePresentation.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="node" />
+/** Stable default shared by package entries and OOXML core metadata. */
+export declare const DEFAULT_GENERATED_AT = "2000-01-01T00:00:00.000Z";
+export interface PresentationPackagingOptions {
+    /** Normalize metadata and ZIP timestamps. Defaults to true. */
+    deterministic?: boolean;
+    /** Clock used when deterministic packaging is enabled. */
+    generatedAt?: Date | string;
+}
+/**
+ * Apply post-generation OOXML fixes and deterministic package metadata.
+ *
+ * PptxGenJS stamps both core.xml and ZIP entries with the wall clock. Rewriting
+ * both layers makes equivalent inputs byte-identical across invocations.
+ */
+export declare function packagePresentationBuffer(buffer: Buffer, options?: PresentationPackagingOptions): Promise<Buffer>;
+//# sourceMappingURL=packagePresentation.d.ts.map

package/dist/core/packagePresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packagePresentation.d.ts","sourceRoot":"","sources":["../../src/core/packagePresentation.ts"],"names":[],"mappings":";AAKA,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAE/D,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC7B;AA2ID;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 export declare function getPptxCoreVersion(): string;
-export { generatePresentation, generateBufferFromJson, generateBufferWithWarnings, generateAndSaveFromJson, generateFromFile, savePresentation, isPresentationComponentDefinition, PresentationGenerator, } from './core/generator';
-export type { GenerationOptions, GenerationResult } from './core/generator';
+export { generatePresentation, generateBufferFromJson, generateBufferWithWarnings, generateAndSaveFromJson, generateFromFile, savePresentation, isPresentationComponentDefinition, PresentationValidationError, PresentationGenerator, } from './core/generator';
+export type { GenerationOptions, GenerationResult, GenerationValidationOptions, } from './core/generator';
+export { DEFAULT_GENERATED_AT, packagePresentationBuffer, } from './core/packagePresentation';
+export type { PresentationPackagingOptions } from './core/packagePresentation';
 export type { PptxComponentInput, PresentationComponentDefinition, SlideComponentDefinition, ProcessedPresentation, ProcessedSlide, PptxThemeConfig, PipelineWarning, SlideContext, SlideRenderContext, } from './types';
 export { isPresentationComponent, isSlideComponent } from './types';
 export { W as WarningCodes } from './utils/warn';
 export type { WarningCode } from './utils/warn';
 export { DEFAULT_PPTX_THEME, getPptxTheme, pptxThemes } from './themes';
 export { createComponent, createVersion, createPresentationGenerator, resolveComponentVersion, validateComponentProps, validatePresentation, cleanComponentProps, ComponentValidationError, DuplicateComponentError, generatePluginPresentationSchema, exportPluginSchema, } from './plugin';
-export type { CustomComponent, ComponentVersion, ComponentVersionMap, RenderFunction, RenderContext, PresentationGeneratorOptions, PresentationGenerator as PluginPresentationGenerator, PresentationGeneratorBuilder, BufferGenerationResult as PluginBufferGenerationResult, FileGenerationResult as PluginFileGenerationResult, ValidationResult as PluginValidationResult, ExtractCustomComponentType, CustomComponentUnion, ExtendedPptxComponentInput, ExtendedPresentationComponent, InferBuilderComponents, InferDocumentType, InferComponentDefinition, ComponentValidationResult, ValidationError as PluginValidationError, } from './plugin';
+export type { CustomComponent, ComponentVersion, ComponentVersionMap, RenderFunction, RenderContext, PresentationGeneratorOptions, PresentationGenerator as PluginPresentationGenerator, PresentationGeneratorBuilder, BufferGenerationResult as PluginBufferGenerationResult, FileGenerationResult as PluginFileGenerationResult, GenerateFileOptions as PluginGenerateFileOptions, GenerateOptions as PluginGenerateOptions, GenerationValidationOptions as PluginGenerationValidationOptions, ValidationResult as PluginValidationResult, ExtractCustomComponentType, CustomComponentUnion, ExtendedPptxComponentInput, ExtendedPresentationComponent, InferBuilderComponents, InferDocumentType, InferComponentDefinition, ComponentValidationResult, ValidationError as PluginValidationError, } from './plugin';
 export { renderTextComponent, renderImageComponent, renderShapeComponent, renderTableComponent, renderHighchartsComponent, renderComponent, } from './components';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAGD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,YAAY,EACV,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,qBAAqB,IAAI,2BAA2B,EACpD,4BAA4B,EAC5B,sBAAsB,IAAI,4BAA4B,EACtD,oBAAoB,IAAI,0BAA0B,EAClD,gBAAgB,IAAI,sBAAsB,EAC1C,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,IAAI,qBAAqB,GACzC,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAGD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,iCAAiC,EACjC,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG/E,YAAY,EACV,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,qBAAqB,IAAI,2BAA2B,EACpD,4BAA4B,EAC5B,sBAAsB,IAAI,4BAA4B,EACtD,oBAAoB,IAAI,0BAA0B,EAClD,mBAAmB,IAAI,yBAAyB,EAChD,eAAe,IAAI,qBAAqB,EACxC,2BAA2B,IAAI,iCAAiC,EAChE,gBAAgB,IAAI,sBAAsB,EAC1C,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,IAAI,qBAAqB,GACzC,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,4 @@
 // src/core/generator.ts
-import JSZip from "jszip";
 import { writeFileSync } from "fs";
 
 // src/types.ts
@@ -1612,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");
   }
@@ -1637,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);
@@ -1705,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);
-}
-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;
+  await generateAndSaveFromJson(json, outputPath, options);
 }
-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 = {
@@ -1754,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,
@@ -1767,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
       );
@@ -1796,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(
@@ -1816,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: [] };
@@ -1866,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."
@@ -1915,6 +2043,8 @@ function createBuilderImpl(state) {
               componentWithVersion.children,
               warningsCollector,
               theme,
+              validateEmitted,
+              void 0,
               depth + 1
             );
           }
@@ -1934,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);
@@ -1961,6 +2094,8 @@ function createBuilderImpl(state) {
             componentData.children,
             warningsCollector,
             theme,
+            validateEmitted,
+            componentData.name,
             depth + 1
           );
           processed.push({
@@ -1990,16 +2125,31 @@ 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 {
       let internalDocument = document;
-      if (!internalDocument || internalDocument.name !== "pptx") {
+      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;
@@ -2030,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,
@@ -2038,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,
@@ -2054,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) {
@@ -2063,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 };
@@ -2162,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);
 }
@@ -2176,9 +2384,11 @@ function getPptxCoreVersion() {
 }
 export {
   ComponentValidationError2 as ComponentValidationError,
+  DEFAULT_GENERATED_AT,
   DEFAULT_PPTX_THEME,
   DuplicateComponentError,
   PresentationGenerator,
+  PresentationValidationError,
   W as WarningCodes,
   cleanComponentProps,
   createComponent,
@@ -2196,6 +2406,7 @@ export {
   isPresentationComponent,
   isPresentationComponentDefinition,
   isSlideComponent,
+  packagePresentationBuffer,
   pptxThemes,
   renderComponent,
   renderHighchartsComponent,