@json-to-office/shared-docx 0.14.0 → 0.17.0

package/dist/{chunk-PQGT7BU5.js → chunk-Y5KKRSXX.js}

@@ -1,7 +1,7 @@
 import {
   createAllComponentSchemasNarrowed,
   getStandardComponent
-} from "./chunk-CY6IVMEZ.js";
+} from "./chunk-WIWVYW2G.js";
 
 // src/schemas/generator.ts
 import { Type } from "@sinclair/typebox";
@@ -128,4 +128,4 @@ function generateUnifiedDocumentSchema(options = {}) {
 export {
   generateUnifiedDocumentSchema
 };
-//# sourceMappingURL=chunk-PQGT7BU5.js.map
+//# sourceMappingURL=chunk-Y5KKRSXX.js.map

package/dist/{document-validator-CiaGiy1v.d.ts → document-validator-SsJ_brnh.d.ts}

@@ -36,6 +36,18 @@ interface ValidationOptions {
     jsonString?: string;
     /** Maximum number of errors to collect */
     maxErrors?: number;
+    /**
+     * When true, unknown/extra properties are stripped before validation instead
+     * of being rejected by additionalProperties:false. Escape hatch for callers
+     * migrating onto strict schemas.
+     */
+    allowUnknownFields?: boolean;
+    /**
+     * Names of registered plugin components. They are not flagged as unknown and
+     * their props are not checked against a standard schema here — the plugin
+     * layer validates custom props version-aware separately.
+     */
+    knownCustomNames?: Set<string>;
 }
 /**
  * Result specifically for JSON parsing with validation

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { RevisionSegment, ComponentDefinition as ComponentDefinition$1, ComponentDefinitionSchema, ColumnsPropsSchema, ReportPropsSchema, SectionPropsSchema, HeadingPropsSchema, ParagraphPropsSchema, TextBoxPropsSchema, ImagePropsSchema, HighchartsPropsSchema, StatisticPropsSchema, TablePropsSchema, ListPropsSchema, TocPropsSchema } from './schemas/components.js';
-export { Alignment, AlignmentSchema, BaseComponentProps, BaseComponentPropsSchema, BorderSchema, ColumnsProps, HeadingLevel, HeadingLevelSchema, HeadingProps, HighchartsProps, ImageProps, Indent, IndentSchema, JustifiedAlignment, JustifiedAlignmentSchema, LineSpacing, LineSpacingSchema, ListProps, MarginsSchema, Numbering, NumberingSchema, ParagraphProps, ReportProps, Revision, RevisionSchema, RevisionSegmentSchema, SectionProps, Spacing, SpacingSchema, StandardComponentDefinitionSchema, StatisticProps, TableProps, TextBoxProps, TocProps } from './schemas/components.js';
+import { RevisionSegment, ComponentDefinition as ComponentDefinition$1, ComponentDefinitionSchema, ColumnsPropsSchema, ReportPropsSchema, SectionPropsSchema, HeadingPropsSchema, ParagraphPropsSchema, TextBoxPropsSchema, ImagePropsSchema, HighchartsPropsSchema, VisualPropsSchema, StatisticPropsSchema, TablePropsSchema, ListPropsSchema, TocPropsSchema } from './schemas/components.js';
+export { Alignment, AlignmentSchema, BaseComponentProps, BaseComponentPropsSchema, BorderSchema, ColumnsProps, HeadingLevel, HeadingLevelSchema, HeadingProps, HighchartsProps, ImageProps, Indent, IndentSchema, JustifiedAlignment, JustifiedAlignmentSchema, LineSpacing, LineSpacingSchema, ListProps, MarginsSchema, Numbering, NumberingSchema, ParagraphProps, ReportProps, Revision, RevisionSchema, RevisionSegmentSchema, SectionProps, Spacing, SpacingSchema, StandardComponentDefinitionSchema, StatisticProps, TableProps, TextBoxProps, TocProps, VisualCanvas, VisualCanvasBackgroundSchema, VisualCanvasSchema, VisualProps } from './schemas/components.js';
 export { AddWarningFunction, ComponentSchemaConfig, DEFAULT_ERROR_CONFIG, ERROR_EMOJIS, ErrorFormatterConfig, GenerationWarning, ParsedSemver, ComponentDefinition as SharedComponentDefinition, ValidationError, ValidationResult, calculatePosition, clearComponentNamesCache, compareSemver, convertToJsonSchema, createComponentSchema, createErrorConfig, createJsonParseError, exportSchemaToFile, extractStandardComponentNames, fixSchemaReferences, formatErrorMessage, formatErrorSummary, getLiteralValue, getObjectSchemaPropertyNames, getSchemaMetadata, groupErrorsByPath, isLiteralSchema, isObjectSchema, isUnionSchema, isValidSemver, latestVersion, parseSemver, createComponentSchemaObject as sharedCreateComponentSchemaObject, transformValueError, transformValueErrors } from '@json-to-office/shared';
 import { DocumentValidationResult, ValidationError } from './schemas/document.js';
 export { JSON_SCHEMA_URLS, JsonComponentDefinitionSchema } from './schemas/document.js';
@@ -14,7 +14,7 @@ export { CustomComponentDefinitionSchema, TextSpaceAfterComponentSchema, TextSpa
 export { BASE_SCHEMA_METADATA, COMPONENT_METADATA, ComponentSchemaConfig as DocxComponentSchemaConfig, THEME_SCHEMA_METADATA, convertToJsonSchema as convertDocxToJsonSchema, createComponentSchema as createDocxComponentSchema, exportSchemaToFile as exportDocxSchemaToFile, fixSchemaReferences as fixDocxSchemaReferences } from './schemas/export.js';
 export { CustomComponentInfo, GenerateDocumentSchemaOptions, generateUnifiedDocumentSchema } from './schemas/generator.js';
 export { ColumnsComponentDefaults, ComponentDefaults, HeadingComponentDefaults, ImageComponentDefaults, ListComponentDefaults, ParagraphComponentDefaults, SectionComponentDefaults, StatisticComponentDefaults, TableComponentDefaults } from './schemas/component-defaults.js';
-export { C as ComponentValidationResult, E as EnhancedValueError, J as JsonValidationResult, T as ThemeValidationResult, V as ValidationOptions, c as createDocumentValidator, d as documentValidator, i as isValidDocument, s as strictDocumentValidator, v as validateDocument, a as validateDocumentWithSchema, b as validateJsonComponent, e as validateJsonComponentDoc, b as validateJsonDocument } from './document-validator-CiaGiy1v.js';
+export { C as ComponentValidationResult, E as EnhancedValueError, J as JsonValidationResult, T as ThemeValidationResult, V as ValidationOptions, c as createDocumentValidator, d as documentValidator, i as isValidDocument, s as strictDocumentValidator, v as validateDocument, a as validateDocumentWithSchema, b as validateJsonComponent, e as validateJsonComponentDoc, b as validateJsonDocument } from './document-validator-SsJ_brnh.js';
 import './schemas/font.js';
 
 /**
@@ -936,6 +936,17 @@ interface HighchartsComponent {
     enabled?: boolean;
     props: Static<typeof HighchartsPropsSchema>;
 }
+/**
+ * Visual component with literal name discriminator.
+ * A pptx-rendered free-canvas graphic embedded as a rasterized image.
+ */
+interface VisualComponent {
+    name: 'visual';
+    id?: string;
+    /** When false, this component is filtered out and not rendered. Defaults to true */
+    enabled?: boolean;
+    props: Static<typeof VisualPropsSchema>;
+}
 /**
  * Text Box component with literal name discriminator
  * Container for child components with floating positioning
@@ -981,12 +992,12 @@ interface TextSpaceAfterComponent {
 /**
  * Union of all standard component types
  */
-type StandardComponentDefinition = ReportComponent | SectionComponent | ColumnsComponent | HeadingComponent | ParagraphComponent | TextBoxComponent | ImageComponent | HighchartsComponent | StatisticComponent | TableComponent | ListComponent | TocComponent;
+type StandardComponentDefinition = ReportComponent | SectionComponent | ColumnsComponent | HeadingComponent | ParagraphComponent | TextBoxComponent | ImageComponent | HighchartsComponent | VisualComponent | StatisticComponent | TableComponent | ListComponent | TocComponent;
 /**
  * Array of all standard component names.
  * Useful for iterating, validation, or displaying available components to users.
  */
-declare const STANDARD_COMPONENTS: readonly ["columns", "heading", "highcharts", "image", "list", "paragraph", "docx", "section", "statistic", "table", "text-box", "toc"];
+declare const STANDARD_COMPONENTS: readonly ["columns", "heading", "highcharts", "image", "list", "paragraph", "docx", "section", "statistic", "table", "text-box", "toc", "visual"];
 /**
  * Set of all standard component names for O(1) lookup.
  */
@@ -1028,10 +1039,11 @@ declare function isTableComponent(component: ComponentDefinition): component is
 declare function isListComponent(component: ComponentDefinition): component is ListComponent;
 declare function isTocComponent(component: ComponentDefinition): component is TocComponent;
 declare function isHighchartsComponent(component: ComponentDefinition): component is HighchartsComponent;
+declare function isVisualComponent(component: ComponentDefinition): component is VisualComponent;
 declare function isTextSpaceAfterComponent(component: ComponentDefinition): component is TextSpaceAfterComponent;
 
 type ThemeName = 'minimal' | 'verizon' | 'a2a' | 'hitachi';
 
 declare const SHARED_DOCX_VERSION = "1.0.0";
 
-export { type ColumnsComponent, ColumnsPropsSchema, type ComponentDefinition, ComponentDefinitionSchema, type CoreValidationResult, type DiffDocumentsOptions, type DiffDocumentsResult, type DiffSegment, type DiffSummary, ValidationError as DocumentValidationError, DocumentValidationResult, type FormattedError, type HeadingComponent, HeadingPropsSchema, type HighchartsComponent, HighchartsPropsSchema, type ImageComponent, ImagePropsSchema, JsonDocumentParser, type JsonNode, JsonParsingError, JsonValidationError, type ListComponent, ListPropsSchema, type ParagraphComponent, ParagraphPropsSchema, type ReportComponent, ReportPropsSchema, RevisionSegment, SHARED_DOCX_VERSION, STANDARD_COMPONENTS, STANDARD_COMPONENTS_SET, type SectionComponent, SectionPropsSchema, type StandardComponentDefinition, type StandardComponentName, type StatisticComponent, StatisticPropsSchema, type TableComponent, TablePropsSchema, type TextBoxComponent, TextBoxPropsSchema, type TextSpaceAfterComponent, TextSpaceAfterPropsSchema, type ThemeName, type TocComponent, TocPropsSchema, type UntrackedChange, createValidatedComponent, diffDocuments, diffWords, formatErrorReport, formatValidationError, formatValidationErrorStrings, formatValidationErrors, getErrorSummary, getValidationContext, getValidationErrors, hasCriticalErrors, isColumnsComponent, isHeadingComponent, isHighchartsComponent, isImageComponent, isListComponent, isParagraphComponent, isReportComponent, isSectionComponent, isStatisticComponent, isTableComponent, isTextBoxComponent, isTextSpaceAfterComponent, isTocComponent, isValidComponent, parseJsonComponent, parseJsonWithLineNumbers, safeValidateComponentDefinition, safeValidateComponentProps, stripMarkdown, transformAndValidate, validateComponent, validateComponentDefinition, validateComponents };
+export { type ColumnsComponent, ColumnsPropsSchema, type ComponentDefinition, ComponentDefinitionSchema, type CoreValidationResult, type DiffDocumentsOptions, type DiffDocumentsResult, type DiffSegment, type DiffSummary, ValidationError as DocumentValidationError, DocumentValidationResult, type FormattedError, type HeadingComponent, HeadingPropsSchema, type HighchartsComponent, HighchartsPropsSchema, type ImageComponent, ImagePropsSchema, JsonDocumentParser, type JsonNode, JsonParsingError, JsonValidationError, type ListComponent, ListPropsSchema, type ParagraphComponent, ParagraphPropsSchema, type ReportComponent, ReportPropsSchema, RevisionSegment, SHARED_DOCX_VERSION, STANDARD_COMPONENTS, STANDARD_COMPONENTS_SET, type SectionComponent, SectionPropsSchema, type StandardComponentDefinition, type StandardComponentName, type StatisticComponent, StatisticPropsSchema, type TableComponent, TablePropsSchema, type TextBoxComponent, TextBoxPropsSchema, type TextSpaceAfterComponent, TextSpaceAfterPropsSchema, type ThemeName, type TocComponent, TocPropsSchema, type UntrackedChange, type VisualComponent, VisualPropsSchema, createValidatedComponent, diffDocuments, diffWords, formatErrorReport, formatValidationError, formatValidationErrorStrings, formatValidationErrors, getErrorSummary, getValidationContext, getValidationErrors, hasCriticalErrors, isColumnsComponent, isHeadingComponent, isHighchartsComponent, isImageComponent, isListComponent, isParagraphComponent, isReportComponent, isSectionComponent, isStatisticComponent, isTableComponent, isTextBoxComponent, isTextSpaceAfterComponent, isTocComponent, isValidComponent, isVisualComponent, parseJsonComponent, parseJsonWithLineNumbers, safeValidateComponentDefinition, safeValidateComponentProps, stripMarkdown, transformAndValidate, validateComponent, validateComponentDefinition, validateComponents };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   generateUnifiedDocumentSchema
-} from "./chunk-PQGT7BU5.js";
+} from "./chunk-Y5KKRSXX.js";
 import {
   DOC_LINKS,
   ERROR_TEMPLATES,
@@ -32,21 +32,21 @@ import {
   validateTheme,
   validateThemeJson,
   validateThemeWithEnhancement
-} from "./chunk-HJIS6RRQ.js";
+} from "./chunk-3XWQYKTW.js";
 import {
   ThemeConfigSchema,
   isValidThemeConfig
-} from "./chunk-X2B5OVWA.js";
+} from "./chunk-XVCODWSU.js";
 import {
   GenerateDocumentRequestSchema,
   GenerateDocumentResponseSchema,
   ValidateDocumentRequestSchema,
   ValidateDocumentResponseSchema
-} from "./chunk-QUA2GDH7.js";
+} from "./chunk-CVIUFVXH.js";
 import {
   JSON_SCHEMA_URLS,
   JsonComponentDefinitionSchema
-} from "./chunk-FA6FKO3L.js";
+} from "./chunk-TTT3L236.js";
 import {
   comprehensiveValidateDocument,
   createDocumentValidator,
@@ -68,11 +68,11 @@ import {
   validateJsonComponent,
   validateJsonDocument,
   validateWithEnhancement
-} from "./chunk-5BKZFYJL.js";
+} from "./chunk-V5DHEETI.js";
 import {
   ComponentDefinitionSchema,
   StandardComponentDefinitionSchema
-} from "./chunk-52PV5JQK.js";
+} from "./chunk-G6C2WMTW.js";
 import {
   CustomComponentDefinitionSchema,
   TextSpaceAfterComponentSchema,
@@ -86,13 +86,16 @@ import {
   createComponentSchema,
   exportSchemaToFile,
   fixSchemaReferences
-} from "./chunk-6IXK54YE.js";
+} from "./chunk-WZPPVJN6.js";
 import {
   HighchartsPropsSchema,
   ReportPropsSchema,
   TextBoxPropsSchema,
-  TocPropsSchema
-} from "./chunk-CY6IVMEZ.js";
+  TocPropsSchema,
+  VisualCanvasBackgroundSchema,
+  VisualCanvasSchema,
+  VisualPropsSchema
+} from "./chunk-WIWVYW2G.js";
 import {
   AlignmentSchema,
   BaseComponentPropsSchema,
@@ -114,8 +117,8 @@ import {
   SpacingSchema,
   StatisticPropsSchema,
   TablePropsSchema
-} from "./chunk-CGMJ665Z.js";
-import "./chunk-H56RLQOF.js";
+} from "./chunk-NRDLQSF3.js";
+import "./chunk-B66TAIK6.js";
 
 // src/diff/word-diff.ts
 var MAX_LCS_CELLS = 1e6;
@@ -1576,7 +1579,8 @@ var STANDARD_COMPONENTS = [
   "statistic",
   "table",
   "text-box",
-  "toc"
+  "toc",
+  "visual"
 ];
 var STANDARD_COMPONENTS_SET = new Set(STANDARD_COMPONENTS);
 function isReportComponent(component) {
@@ -1615,6 +1619,9 @@ function isTocComponent(component) {
 function isHighchartsComponent(component) {
   return component.name === "highcharts";
 }
+function isVisualComponent(component) {
+  return component.name === "visual";
+}
 function isTextSpaceAfterComponent(component) {
   return component.name === "text-space-after";
 }
@@ -1671,6 +1678,9 @@ export {
   TocPropsSchema,
   ValidateDocumentRequestSchema,
   ValidateDocumentResponseSchema,
+  VisualCanvasBackgroundSchema,
+  VisualCanvasSchema,
+  VisualPropsSchema,
   calculatePosition,
   clearComponentNamesCache,
   compareSemver,
@@ -1749,6 +1759,7 @@ export {
   isValidThemeConfig,
   isValidTheme as isValidThemeJson,
   isValidationSuccess,
+  isVisualComponent,
   latestVersion,
   parseJsonComponent,
   parseJsonWithLineNumbers,