superdoc 2.4.0-next.59 → 2.4.0-next.60

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.59",
+	superdocVersion: "2.4.0-next.60",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.59",
+	superdocVersion: "2.4.0-next.60",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/layout-engine/contracts/src/index.d.ts

@@ -1060,12 +1060,18 @@ export type VectorShapeStyle = {
     fillColor?: FillColor;
     strokeColor?: StrokeColor;
     strokeWidth?: number;
+    /** Physical CSS-pixel dash/gap lengths resolved from the source stroke. */
+    strokeDashArray?: number[];
+    strokeLineJoin?: 'round' | 'bevel' | 'miter';
+    strokeLineCap?: 'round' | 'square' | 'butt';
     /** Optional per-edge frame used by render-only table cells inside legacy shape groups. */
     borders?: CellBorders;
     lineEnds?: LineEnds;
     textContent?: ShapeTextContent;
     textAlign?: string;
     textVerticalAlign?: 'top' | 'center' | 'bottom';
+    /** Legacy VML textbox text-flow semantics. */
+    textFlow?: 'horizontal' | 'vertical' | 'vertical-ideographic' | 'horizontal-ideographic' | 'bottom-to-top';
     textInsets?: {
         top: number;
         right: number;
@@ -1146,11 +1152,15 @@ export type VectorShapeDrawing = DrawingBlockBase & {
     fillColor?: FillColor;
     strokeColor?: StrokeColor;
     strokeWidth?: number;
+    strokeDashArray?: number[];
+    strokeLineJoin?: 'round' | 'bevel' | 'miter';
+    strokeLineCap?: 'round' | 'square' | 'butt';
     lineEnds?: LineEnds;
     effectExtent?: EffectExtent;
     textContent?: ShapeTextContent;
     textAlign?: string;
     textVerticalAlign?: 'top' | 'center' | 'bottom';
+    textFlow?: 'horizontal' | 'vertical' | 'vertical-ideographic' | 'horizontal-ideographic' | 'bottom-to-top';
     textInsets?: {
         top: number;
         right: number;
@@ -1168,21 +1178,35 @@ export type TextboxDrawing = DrawingBlockBase & {
     fillColor?: FillColor;
     strokeColor?: StrokeColor;
     strokeWidth?: number;
+    strokeDashArray?: number[];
+    strokeLineJoin?: 'round' | 'bevel' | 'miter';
+    strokeLineCap?: 'round' | 'square' | 'butt';
     lineEnds?: LineEnds;
     effectExtent?: EffectExtent;
     textContent?: ShapeTextContent;
     textAlign?: string;
     textVerticalAlign?: 'top' | 'center' | 'bottom';
+    textFlow?: 'horizontal' | 'vertical' | 'vertical-ideographic' | 'horizontal-ideographic' | 'bottom-to-top';
     textInsets?: {
         top: number;
         right: number;
         bottom: number;
         left: number;
     };
-    contentBlocks: ParagraphBlock[];
-    /** Paragraph layout results for table-cell textboxes; populated by the layout bridge, read by the painter. */
-    contentMeasures?: ParagraphMeasure[];
+    /**
+     * Canonical block content owned by the textbox story.
+     *
+     * ECMA-376 permits general block-level WordprocessingML in `w:txbxContent`.
+     * V2 currently supports paragraphs and tables explicitly; keeping this as a
+     * named subset makes later block-family additions additive instead of
+     * flattening rich content into drawing primitives.
+     */
+    contentBlocks: TextboxContentBlock[];
+    /** Canonical layout results for textbox content; populated by measurement or the layout bridge. */
+    contentMeasures?: TextboxContentMeasure[];
 };
+export type TextboxContentBlock = ParagraphBlock | TableBlock;
+export type TextboxContentMeasure = ParagraphMeasure | TableMeasure;
 export type ShapeGroupDrawing = DrawingBlockBase & {
     drawingKind: 'shapeGroup';
     geometry: DrawingGeometry;
@@ -1254,6 +1278,13 @@ export type SectionBreakBlock = {
     kind: 'sectionBreak';
     id: BlockId;
     type?: 'continuous' | 'nextPage' | 'evenPage' | 'oddPage';
+    /**
+     * Physical page parity required for a `nextPage` break. Word derives this
+     * when distinct odd/even headers are enabled and the new section explicitly
+     * restarts page numbering; authored `evenPage`/`oddPage` breaks express the
+     * same constraint through `type` instead.
+     */
+    requiredPageParity?: 'even' | 'odd';
     pageSize?: {
         w: number;
         h: number;
@@ -2093,8 +2124,8 @@ export type DrawingMeasure = {
     naturalHeight: number;
     geometry: DrawingGeometry;
     groupTransform?: ShapeGroupTransform;
-    /** Canonical paragraph measurements for textbox content, when the drawing owns text. */
-    contentMeasures?: ParagraphMeasure[];
+    /** Canonical block measurements for textbox content, when the drawing owns a textbox story. */
+    contentMeasures?: TextboxContentMeasure[];
 };
 export type TableCellMeasure = {
     /** Multi-block cell measurements (new feature) */
@@ -2223,6 +2254,13 @@ export type FootnotePageLedger = {
 export type Page = {
     number: number;
     fragments: Fragment[];
+    /**
+     * Suppress header/footer stories on a physically inserted parity page.
+     * Word emits these pages to satisfy odd/even section starts, but leaves the
+     * page itself completely blank and does not treat it as page one of the new
+     * section.
+     */
+    suppressHeaderFooter?: boolean;
     margins?: PageMargins;
     /**
      * Extra bottom space reserved on this page for footnotes (in px).
@@ -2456,7 +2494,7 @@ export type DrawingFragment = {
     drawingContentId?: string;
     /** V2 textbox story id for DrawingML textbox content painted inside this drawing. */
     textboxId?: string;
-    contentMeasures?: ParagraphMeasure[];
+    contentMeasures?: TextboxContentMeasure[];
     pmStart?: number;
     pmEnd?: number;
     sourceAnchor?: SourceAnchor;

package/dist/layout-engine/layout-engine/src/layout-drawing.d.ts

@@ -1,4 +1,4 @@
-import { DrawingBlock, DrawingMeasure, ParagraphMeasure } from '../../contracts/src/index.js';
+import { DrawingBlock, DrawingMeasure, TextboxContentMeasure } from '../../contracts/src/index.js';
 import { NormalizedColumns } from './layout-image.js';
 import { PageState } from './paginator.js';
 /**
@@ -21,8 +21,8 @@ export type DrawingLayoutContext = {
     advanceColumn: (state: PageState) => PageState;
     /** Computes the X coordinate for a column in the given page state (SD-2629). */
     columnX: (state: PageState, columnIndex?: number) => number;
-    /** Optional textbox paragraph measurements carried alongside textbox drawings. */
-    textboxContentMeasures?: ParagraphMeasure[];
+    /** Optional canonical textbox block measurements carried alongside textbox drawings. */
+    textboxContentMeasures?: TextboxContentMeasure[];
 };
 /**
  * Layout a drawing block (vector shape) within the document flow.

package/dist/layout-engine/layout-engine/src/layout-textbox.d.ts

@@ -1,4 +1,4 @@
-import { DrawingMeasure, ParagraphMeasure, TextboxDrawing } from '../../contracts/src/index.js';
-export declare function layoutTextboxContent(block: TextboxDrawing, remeasureParagraph: (block: TextboxDrawing['contentBlocks'][number], maxWidth: number) => ParagraphMeasure): ParagraphMeasure[];
+import { DrawingMeasure, ParagraphBlock, ParagraphMeasure, TextboxContentMeasure, TextboxDrawing } from '../../contracts/src/index.js';
+export declare function layoutTextboxContent(block: TextboxDrawing, remeasureParagraph: (block: ParagraphBlock, maxWidth: number) => ParagraphMeasure): ParagraphMeasure[] | undefined;
 /** Prefer canonical measurement output, retaining the synchronous bridge as a legacy fallback. */
-export declare function resolveTextboxContentMeasures(block: TextboxDrawing, measure: DrawingMeasure, remeasureParagraph?: (block: TextboxDrawing['contentBlocks'][number], maxWidth: number) => ParagraphMeasure): ParagraphMeasure[] | undefined;
+export declare function resolveTextboxContentMeasures(block: TextboxDrawing, measure: DrawingMeasure, remeasureParagraph?: (block: ParagraphBlock, maxWidth: number) => ParagraphMeasure): TextboxContentMeasure[] | undefined;

package/dist/layout-engine/layout-engine/src/paginator.d.ts

@@ -94,7 +94,9 @@ export type PaginatorOptions = {
         w: number;
         h: number;
     }): Page;
-    onNewPage?: (state: PageState) => void;
+    onNewPage?: (state: PageState | undefined, options?: {
+        applyPendingSection: boolean;
+    }) => void;
     shouldStopBeforeNewPage?: (input: {
         completedPageIndex: number;
         pages: readonly Page[];
@@ -122,7 +124,10 @@ export declare function breakParagraphAdjacency(state: PageState): void;
 export declare function createPaginator(opts: PaginatorOptions): {
     readonly pages: Page[];
     readonly states: PageState[];
-    readonly startNewPage: () => PageState;
+    readonly startNewPage: (options?: {
+        applyPendingSection?: boolean;
+        replaceCurrentPage?: boolean;
+    }) => PageState;
     readonly ensurePage: () => PageState;
     readonly advanceColumn: (state: PageState) => PageState;
     readonly getActiveColumnsForState: (state: PageState) => ColumnLayout;

package/dist/layout-engine/painters/dom/src/renderer.d.ts

@@ -520,6 +520,14 @@ export declare class DomPainter {
      * Apply fill and stroke styles to a fallback shape container
      */
     private applyFallbackShapeStyle;
+    /**
+     * Shape stroke widths reach the painter in physical CSS pixels. Preset SVGs
+     * use a normalized 100 × 100 viewBox while VML custom geometry often uses a
+     * coordsize in the thousands. In both cases allowing the viewBox transform to
+     * scale the stroke changes the authored line weight, sometimes by orders of
+     * magnitude. Keep geometry scalable and paint the resolved width verbatim.
+     */
+    private applyPhysicalStrokeSemantics;
     private hasShapeTextContent;
     private createShapeTextElement;
     private createTextboxContentElement;
@@ -540,6 +548,7 @@ export declare class DomPainter {
      * @param _groupScaleY - Reserved parent-group scale factor
      */
     private createFallbackTextElement;
+    private applyShapeTextFlow;
     private tryCreatePresetSvg;
     /**
      * Creates an SVG string from custom geometry path data (a:custGeom).
@@ -566,6 +575,9 @@ export declare class DomPainter {
      */
     private createChartElement;
     private resolveTableRenderData;
+    private createTableCellLineRenderer;
+    /** Render drawing content nested in any canonical table, including a textbox-owned table. */
+    private renderDrawingContentForTable;
     private renderTableFragment;
     private renderLine;
     private createRunRenderContext;

package/dist/layout-engine/painters/dom/src/table/renderTableFragment.d.ts

@@ -39,7 +39,7 @@ export type TableRenderDependencies = {
     /** Built-in SDT chrome rendering mode. */
     chrome?: 'default' | 'none';
     /** Function to render a line of paragraph content */
-    renderLine: (block: ParagraphBlock, line: Line, context: FragmentRenderContext, lineIndex: number, isLastLine: boolean) => HTMLElement;
+    renderLine: (block: ParagraphBlock, line: Line, context: FragmentRenderContext, lineIndex: number, isLastLine: boolean, resolvedListTextStartPx?: number) => HTMLElement;
     /** Optional callback invoked after a table line's final styles/markers are applied. */
     captureLineSnapshot?: (lineEl: HTMLElement, context: FragmentRenderContext, options?: {
         inTableParagraph?: boolean;

package/dist/superdoc.cjs

@@ -43261,7 +43261,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.59";
+		this.version = "2.4.0-next.60";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -43194,7 +43194,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.59";
+		this.version = "2.4.0-next.60";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];