@json-to-office/shared-docx 1.6.0 → 1.9.0

package/dist/{chunk-PWLVDZHJ.js → chunk-3ELXAZC3.js}

@@ -3,19 +3,19 @@ import {
   strictDocumentValidator,
   validateAgainstSchema,
   validateJson
-} from "./chunk-3DLMRNA7.js";
+} from "./chunk-S7CHEAUQ.js";
 import {
   ComponentDefinitionSchema
-} from "./chunk-JGD54FUF.js";
+} from "./chunk-M2GYRM4P.js";
 import {
   CustomComponentDefinitionSchema
 } from "./chunk-7GGTZ4TA.js";
 import {
   ReportPropsSchema
-} from "./chunk-KMKQOMP7.js";
+} from "./chunk-64CLASFN.js";
 import {
   ThemeConfigSchema
-} from "./chunk-5SMBRJIZ.js";
+} from "./chunk-N6CCWDPF.js";
 import {
   ColumnsPropsSchema,
   HeadingPropsSchema,
@@ -25,7 +25,7 @@ import {
   SectionPropsSchema,
   StatisticPropsSchema,
   TablePropsSchema
-} from "./chunk-MCS7JCUD.js";
+} from "./chunk-P43S7QYT.js";
 
 // src/validation/unified/index.ts
 import {
@@ -410,4 +410,4 @@ export {
   createErrorConfig,
   formatErrorMessage
 };
-//# sourceMappingURL=chunk-PWLVDZHJ.js.map
+//# sourceMappingURL=chunk-3ELXAZC3.js.map

package/dist/{chunk-KMKQOMP7.js → chunk-64CLASFN.js}

@@ -2,10 +2,10 @@ import {
   DOCX_RENDERER_IDS,
   VisualPropsSchema,
   docxPropsSchemaForRenderer
-} from "./chunk-KGQAQE4S.js";
+} from "./chunk-JW5NOPVQ.js";
 import {
   ThemeOverridesSchema
-} from "./chunk-5SMBRJIZ.js";
+} from "./chunk-N6CCWDPF.js";
 import {
   ColumnsPropsSchema,
   ComponentDefaultsSchema,
@@ -18,19 +18,19 @@ import {
   TablePropsSchema,
   createSectionPropsSchema,
   createTablePropsSchema
-} from "./chunk-MCS7JCUD.js";
+} from "./chunk-P43S7QYT.js";
 import {
   AlignmentSchema,
   FloatingPropertiesSchema,
   SpacingSchema
-} from "./chunk-ZKBTTJN6.js";
+} from "./chunk-V3YRROBV.js";
 import {
   HexColorSchema,
   NoProofWordsSchema
-} from "./chunk-7TTAAYQ5.js";
+} from "./chunk-Y3XKLR27.js";
 
 // src/schemas/component-registry.ts
-import { Type as Type6 } from "@sinclair/typebox";
+import { Type as Type7 } from "@sinclair/typebox";
 
 // src/schemas/components/report.ts
 import { Type } from "@sinclair/typebox";
@@ -452,45 +452,103 @@ var TocPropsSchema = Type3.Object(
   }
 );
 
-// src/schemas/components/highcharts.ts
+// src/schemas/components/rule.ts
 import { Type as Type4 } from "@sinclair/typebox";
-var HighchartsPropsSchema = Type4.Object({
+var RulePropsSchema = Type4.Object(
+  {
+    thickness: Type4.Optional(
+      Type4.Number({
+        minimum: 0.25,
+        maximum: 12,
+        description: "Line weight in points (default 1). OOXML measures a border in eighths of a point and Word stops at 12pt, so this is the whole usable range."
+      })
+    ),
+    color: Type4.Optional(HexColorSchema),
+    style: Type4.Optional(
+      Type4.Union(
+        [
+          Type4.Literal("solid"),
+          Type4.Literal("dashed"),
+          Type4.Literal("dotted"),
+          Type4.Literal("double")
+        ],
+        {
+          description: 'Line style (default "solid"). `double` draws two lines and is measured per line, so it reads about twice as tall as its thickness.'
+        }
+      )
+    ),
+    width: Type4.Optional(
+      Type4.Union(
+        [
+          Type4.Number({
+            minimum: 1,
+            description: "Rule width in points"
+          }),
+          Type4.String({
+            pattern: "^\\d+(\\.\\d+)?%$",
+            description: 'Rule width as a percentage of the text measure (e.g. "40%")'
+          })
+        ],
+        {
+          description: "How far the rule runs (default: the full text measure). A percentage or a point width is turned into paragraph indents, resolved against the theme page \u2014 so a partial rule inside a column or a re-margined section is measured against the page, while the default full-measure rule is exact everywhere."
+        }
+      )
+    ),
+    alignment: Type4.Optional(
+      Type4.Union(
+        [Type4.Literal("left"), Type4.Literal("center"), Type4.Literal("right")],
+        {
+          description: 'Which end of the measure a partial rule sits at (default "left"). Ignored at full width.'
+        }
+      )
+    ),
+    spacing: Type4.Optional(SpacingSchema)
+  },
+  {
+    description: "Horizontal rule \u2014 a thin line across the measure, drawn as a Word paragraph border so it stays editable in Word.",
+    additionalProperties: false
+  }
+);
+
+// src/schemas/components/highcharts.ts
+import { Type as Type5 } from "@sinclair/typebox";
+var HighchartsPropsSchema = Type5.Object({
   // Highcharts chart options - can be anything but must at least have chart.width and chart.height
-  options: Type4.Intersect([
-    Type4.Record(Type4.String(), Type4.Unknown()),
-    Type4.Object({
-      chart: Type4.Object({
-        width: Type4.Number(),
-        height: Type4.Number()
+  options: Type5.Intersect([
+    Type5.Record(Type5.String(), Type5.Unknown()),
+    Type5.Object({
+      chart: Type5.Object({
+        width: Type5.Number(),
+        height: Type5.Number()
       })
     })
   ]),
   // Optional scale factor for export
-  scale: Type4.Optional(Type4.Number()),
+  scale: Type5.Optional(Type5.Number()),
   // Optional resources forwarded verbatim to the export server (CSS/JS/files).
   // Notably enables @font-face rules so charts render in custom fonts.
-  resources: Type4.Optional(
-    Type4.Object({
-      css: Type4.Optional(Type4.String()),
-      js: Type4.Optional(Type4.String()),
-      files: Type4.Optional(Type4.Array(Type4.String()))
+  resources: Type5.Optional(
+    Type5.Object({
+      css: Type5.Optional(Type5.String()),
+      js: Type5.Optional(Type5.String()),
+      files: Type5.Optional(Type5.Array(Type5.String()))
     })
   ),
   // Optional Highcharts Export Server URL override
-  serverUrl: Type4.Optional(
-    Type4.String({
+  serverUrl: Type5.Optional(
+    Type5.String({
       description: "Highcharts Export Server URL (default: http://localhost:7801)"
     })
   ),
   // Optional width for rendering (overrides chart width)
-  width: Type4.Optional(
-    Type4.Union(
+  width: Type5.Optional(
+    Type5.Union(
       [
-        Type4.Number({
+        Type5.Number({
           minimum: 1,
           description: "Image width in pixels"
         }),
-        Type4.String({
+        Type5.String({
           pattern: "^\\d+(\\.\\d+)?%$",
           description: 'Image width as percentage (e.g., "90%") relative to content width'
         })
@@ -501,14 +559,14 @@ var HighchartsPropsSchema = Type4.Object({
     )
   ),
   // Optional height for rendering (overrides chart height)
-  height: Type4.Optional(
-    Type4.Union(
+  height: Type5.Optional(
+    Type5.Union(
       [
-        Type4.Number({
+        Type5.Number({
           minimum: 1,
           description: "Image height in pixels"
         }),
-        Type4.String({
+        Type5.String({
           pattern: "^\\d+(\\.\\d+)?%$",
           description: 'Image height as percentage (e.g., "90%") relative to content height'
         })
@@ -521,112 +579,112 @@ var HighchartsPropsSchema = Type4.Object({
 });
 
 // src/schemas/components/chart.ts
-import { Type as Type5 } from "@sinclair/typebox";
-var ChartTypeSchema = Type5.Union(
+import { Type as Type6 } from "@sinclair/typebox";
+var ChartTypeSchema = Type6.Union(
   [
-    Type5.Literal("area"),
-    Type5.Literal("bar"),
-    Type5.Literal("column"),
-    Type5.Literal("doughnut"),
-    Type5.Literal("line"),
-    Type5.Literal("pie"),
-    Type5.Literal("radar"),
-    Type5.Literal("scatter")
+    Type6.Literal("area"),
+    Type6.Literal("bar"),
+    Type6.Literal("column"),
+    Type6.Literal("doughnut"),
+    Type6.Literal("line"),
+    Type6.Literal("pie"),
+    Type6.Literal("radar"),
+    Type6.Literal("scatter")
   ],
   { description: "Chart type" }
 );
-var ChartDataSeriesSchema = Type5.Object(
+var ChartDataSeriesSchema = Type6.Object(
   {
-    name: Type5.Optional(Type5.String({ description: "Series name" })),
-    labels: Type5.Optional(
-      Type5.Array(Type5.String(), {
+    name: Type6.Optional(Type6.String({ description: "Series name" })),
+    labels: Type6.Optional(
+      Type6.Array(Type6.String(), {
         description: "Category labels. Needed on every series, not just the first, and the same length as `values`; a series without both `labels` and `values` drops the whole chart."
       })
     ),
-    values: Type5.Optional(
-      Type5.Array(Type5.Number(), {
+    values: Type6.Optional(
+      Type6.Array(Type6.Number(), {
         description: "Data values, one per label. Needed on every series \u2014 see `labels`."
       })
     )
   },
   { additionalProperties: false }
 );
-var ChartPropsSchema = Type5.Object(
+var ChartPropsSchema = Type6.Object(
   {
     type: ChartTypeSchema,
-    data: Type5.Array(ChartDataSeriesSchema, {
+    data: Type6.Array(ChartDataSeriesSchema, {
       description: "Chart data series",
       minItems: 1
     }),
     // Title
-    title: Type5.Optional(Type5.String({ description: "Chart title text" })),
-    showTitle: Type5.Optional(
-      Type5.Boolean({
+    title: Type6.Optional(Type6.String({ description: "Chart title text" })),
+    showTitle: Type6.Optional(
+      Type6.Boolean({
         description: "Show the chart title. Defaults to true when `title` is set."
       })
     ),
     // Legend
-    showLegend: Type5.Optional(
-      Type5.Boolean({ description: "Show chart legend" })
+    showLegend: Type6.Optional(
+      Type6.Boolean({ description: "Show chart legend" })
     ),
-    legendPos: Type5.Optional(
-      Type5.Union(
+    legendPos: Type6.Optional(
+      Type6.Union(
         [
-          Type5.Literal("b"),
-          Type5.Literal("l"),
-          Type5.Literal("r"),
-          Type5.Literal("t"),
-          Type5.Literal("tr")
+          Type6.Literal("b"),
+          Type6.Literal("l"),
+          Type6.Literal("r"),
+          Type6.Literal("t"),
+          Type6.Literal("tr")
         ],
         { description: "Legend position" }
       )
     ),
     // Series colors
-    chartColors: Type5.Optional(
-      Type5.Array(Type5.String(), {
+    chartColors: Type6.Optional(
+      Type6.Array(Type6.String(), {
         description: "Series colors (hex or semantic theme names). Defaults to the theme palette."
       })
     ),
     // Axis titles
-    catAxisTitle: Type5.Optional(
-      Type5.String({ description: "Category axis title" })
+    catAxisTitle: Type6.Optional(
+      Type6.String({ description: "Category axis title" })
     ),
-    valAxisTitle: Type5.Optional(
-      Type5.String({ description: "Value axis title" })
+    valAxisTitle: Type6.Optional(
+      Type6.String({ description: "Value axis title" })
     ),
     // Flow placement — the same vocabulary as `image` and `highcharts`.
-    width: Type5.Optional(
-      Type5.Number({
+    width: Type6.Optional(
+      Type6.Number({
         minimum: 0,
         exclusiveMinimum: 0,
         description: "Chart width in inches. Defaults to the content width."
       })
     ),
-    height: Type5.Optional(
-      Type5.Number({
+    height: Type6.Optional(
+      Type6.Number({
         minimum: 0,
         exclusiveMinimum: 0,
         description: "Chart height in inches. Defaults to 3."
       })
     ),
-    alignment: Type5.Optional(AlignmentSchema),
-    caption: Type5.Optional(
-      Type5.String({
+    alignment: Type6.Optional(AlignmentSchema),
+    caption: Type6.Optional(
+      Type6.String({
         description: "Chart caption (supports rich text with **bold**, *italic*, ***both***)"
       })
     ),
-    alt: Type5.Optional(
-      Type5.String({ description: "Alternative text for accessibility" })
+    alt: Type6.Optional(
+      Type6.String({ description: "Alternative text for accessibility" })
     ),
-    spacing: Type5.Optional(SpacingSchema),
-    floating: Type5.Optional(FloatingPropertiesSchema),
-    keepNext: Type5.Optional(
-      Type5.Boolean({
+    spacing: Type6.Optional(SpacingSchema),
+    floating: Type6.Optional(FloatingPropertiesSchema),
+    keepNext: Type6.Optional(
+      Type6.Boolean({
         description: "Keep paragraph with next paragraph on same page"
       })
     ),
-    keepLines: Type5.Optional(
-      Type5.Boolean({
+    keepLines: Type6.Optional(
+      Type6.Boolean({
         description: "Keep all lines of paragraph together on same page"
       })
     )
@@ -658,6 +716,13 @@ var STANDARD_COMPONENTS_REGISTRY = [
     name: "section",
     propsSchema: SectionPropsSchema,
     createPropsSchema: createSectionPropsSchema,
+    embeddedComponents: [
+      // The static schema types both regions as an array of Type.Any() (or
+      // the 'linkToPrevious' literal), so the walk is their only structural
+      // checker — report malformed entries too.
+      { path: ["header"], arity: "component-array", reportStructure: true },
+      { path: ["footer"], arity: "component-array", reportStructure: true }
+    ],
     hasChildren: true,
     allowedChildren: [
       "heading",
@@ -667,6 +732,7 @@ var STANDARD_COMPONENTS_REGISTRY = [
       "table",
       "list",
       "toc",
+      "rule",
       "highcharts",
       "chart",
       "visual",
@@ -688,6 +754,7 @@ var STANDARD_COMPONENTS_REGISTRY = [
       "table",
       "list",
       "toc",
+      "rule",
       "highcharts",
       "chart",
       "visual",
@@ -700,7 +767,7 @@ var STANDARD_COMPONENTS_REGISTRY = [
     name: "text-box",
     propsSchema: TextBoxPropsSchema,
     hasChildren: true,
-    allowedChildren: ["heading", "paragraph", "image"],
+    allowedChildren: ["heading", "paragraph", "image", "rule"],
     category: "layout",
     description: "Floating text container - allows positioning text anywhere on the page with absolute or relative positioning."
   },
@@ -739,6 +806,22 @@ var STANDARD_COMPONENTS_REGISTRY = [
     name: "table",
     propsSchema: TablePropsSchema,
     createPropsSchema: createTablePropsSchema,
+    embeddedComponents: [
+      // Cell content is `string | component`. The table's own props schema
+      // already validates the cell structure, so the walk only adds the
+      // per-component prop errors the loose static content ref misses —
+      // reporting structure here would double-report.
+      {
+        path: ["columns", "*", "header", "content"],
+        arity: "component",
+        reportStructure: false
+      },
+      {
+        path: ["columns", "*", "cells", "*", "content"],
+        arity: "component",
+        reportStructure: false
+      }
+    ],
     hasChildren: false,
     category: "content",
     description: "Data table, declared COLUMN-MAJOR: `props.columns[]`, each with its own `header` and its own `cells[]` running down the column. Note the PPTX `table` is the other way round \u2014 rows of cells \u2014 so a table cannot be moved between the formats unchanged. Fixed column widths are points and must fit the page; leave some columns unsized so they share the leftover space."
@@ -757,6 +840,13 @@ var STANDARD_COMPONENTS_REGISTRY = [
     category: "content",
     description: "Table of contents - automatically generates TOC from document headings. Supports depth ranges and custom styles."
   },
+  {
+    name: "rule",
+    propsSchema: RulePropsSchema,
+    hasChildren: false,
+    category: "content",
+    description: "Horizontal rule - a thin line across the measure, for separating sections. Drawn as a Word paragraph border, so it stays a real Word object. Use this rather than collapsing a paragraph's line spacing to fake one."
+  },
   {
     name: "highcharts",
     propsSchema: HighchartsPropsSchema,
@@ -807,26 +897,26 @@ function demandsProps(propsSchema) {
 }
 function createComponentSchemaObject(component, childrenType, selfRef, profile) {
   const schema = {
-    name: Type6.Literal(component.name),
-    id: Type6.Optional(Type6.String()),
-    enabled: Type6.Optional(
-      Type6.Boolean({
+    name: Type7.Literal(component.name),
+    id: Type7.Optional(Type7.String()),
+    enabled: Type7.Optional(
+      Type7.Boolean({
         default: true,
         description: "When false, this component is filtered out and not rendered. Defaults to true. Useful for conditional component inclusion."
       })
     )
   };
   if (component.special?.hasSchemaField) {
-    schema.$schema = Type6.Optional(Type6.String({ format: "uri" }));
-    schema.renderer = profile ? profile.requireDiscriminator ? Type6.Literal(profile.renderer, {
+    schema.$schema = Type7.Optional(Type7.String({ format: "uri" }));
+    schema.renderer = profile ? profile.requireDiscriminator ? Type7.Literal(profile.renderer, {
       description: "Renderer backend for this document"
-    }) : Type6.Optional(
-      Type6.Literal(profile.renderer, {
+    }) : Type7.Optional(
+      Type7.Literal(profile.renderer, {
         description: 'Renderer backend. Omitted defaults to "docxjs".'
       })
-    ) : Type6.Optional(
-      Type6.Union(
-        DOCX_RENDERER_IDS.map((renderer) => Type6.Literal(renderer)),
+    ) : Type7.Optional(
+      Type7.Union(
+        DOCX_RENDERER_IDS.map((renderer) => Type7.Literal(renderer)),
         {
           description: 'Renderer backend. Omitted defaults to "docxjs".'
         }
@@ -839,11 +929,11 @@ function createComponentSchemaObject(component, childrenType, selfRef, profile)
     basePropsSchema,
     profile.renderer
   ) : basePropsSchema;
-  schema.props = demandsProps(propsSchema) ? propsSchema : Type6.Optional(propsSchema);
+  schema.props = demandsProps(propsSchema) ? propsSchema : Type7.Optional(propsSchema);
   if (component.hasChildren && childrenType) {
-    schema.children = component.special?.hasSchemaField ? Type6.Array(childrenType) : Type6.Optional(Type6.Array(childrenType));
+    schema.children = component.special?.hasSchemaField ? Type7.Array(childrenType) : Type7.Optional(Type7.Array(childrenType));
   }
-  return Type6.Object(schema, {
+  return Type7.Object(schema, {
     additionalProperties: false,
     description: component.description
   });
@@ -888,7 +978,7 @@ function createAllComponentSchemasNarrowed(selfRef, pluginSchemas = [], profile)
       if (!containerDeps.every((d) => resolved.has(d))) continue;
       const childSchemas = comp.allowedChildren.map((name) => resolved.get(name) ?? leafSchemas.get(name)).filter((s) => s !== void 0);
       const allChildSchemas = [...childSchemas, ...pluginSchemas];
-      const childrenType = allChildSchemas.length === 1 ? allChildSchemas[0] : Type6.Union(allChildSchemas);
+      const childrenType = allChildSchemas.length === 1 ? allChildSchemas[0] : Type7.Union(allChildSchemas);
       resolved.set(
         comp.name,
         createComponentSchemaObject(comp, childrenType, selfRef, profile)
@@ -914,6 +1004,7 @@ export {
   TocStyleMappingSchema,
   TocDepthRangeSchema,
   TocPropsSchema,
+  RulePropsSchema,
   HighchartsPropsSchema,
   ChartPropsSchema,
   STANDARD_COMPONENTS_REGISTRY,
@@ -927,4 +1018,4 @@ export {
   createAllComponentSchemas,
   createAllComponentSchemasNarrowed
 };
-//# sourceMappingURL=chunk-KMKQOMP7.js.map
+//# sourceMappingURL=chunk-64CLASFN.js.map