superdoc 2.22.0-next.15 → 2.22.0-next.16

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.22.0-next.15",
+	superdocVersion: "2.22.0-next.16",
 	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.22.0-next.15",
+	superdocVersion: "2.22.0-next.16",
 	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

@@ -840,6 +840,8 @@ export declare const isExplicitNoneBorder: (border?: unknown) => boolean;
  */
 export declare const resolveBorderConflict: (first?: BorderSpec, second?: BorderSpec) => BorderSpec | undefined;
 export type TableCellAttrs = {
+    /** Resolved ordinary Latin text rotation from w:tcPr/w:textDirection. */
+    textDirection?: 'btLr' | 'tbRl';
     borders?: CellBorders;
     padding?: BoxSpacing;
     verticalAlign?: 'top' | 'middle' | 'center' | 'bottom';
@@ -891,6 +893,8 @@ export type TableCell = {
     attrs?: TableCellAttrs;
     sourceAnchor?: SourceAnchor;
 };
+/** Read the resolved cell axis, with compatibility for older raw carriers. */
+export declare function getTableCellTextDirection(attrs: TableCellAttrs | undefined): 'btLr' | 'tbRl' | undefined;
 export type TableRowProperties = {
     repeatHeader?: boolean;
     cantSplit?: boolean;
@@ -1671,13 +1675,9 @@ export declare function allExplicitColumnWidthsEqual(widths: readonly number[]):
 /**
  * Shared "genuinely unequal explicit column widths" predicate (SD-2324).
  *
- * The layout engine skips end-of-section column balancing exactly when this
- * is true: Word fills genuinely-unequal explicit columns column-by-column
- * rather than rebalancing them. Host retained-layout dependency scanning
- * (SD-3772) consumes the same predicate so checkpoint admission can never
- * drift from the engine's balancing semantics. Explicit widths that are all
- * EQUAL (`equalWidth="0"` with every `<w:col w:w>` equal) still balance like
- * implicit equal columns and are NOT genuinely unequal.
+ * Unequal geometry requires width-aware paragraph reflow during balancing;
+ * equal explicit widths can use the same fixed-line balancing as implicit
+ * equal columns. This predicate describes geometry, not balancing eligibility.
  */
 export declare function hasGenuinelyUnequalExplicitColumnWidths(columns: {
     equalWidth?: boolean | undefined;
@@ -2067,6 +2067,8 @@ export type ParagraphAttrs = {
      * See `@superdoc/contracts/direction-context` for axis semantics.
      */
     directionContext?: ParagraphDirectionContext;
+    /** Authored paragraph writing-mode override; kept distinct from inherited cell rotation. */
+    textDirection?: string;
     isTocEntry?: boolean;
     tocInstruction?: string;
     /** Stable id shared by every paragraph in the same TOC (docPartObj uniqueId or parent sdBlockId). */
@@ -2413,6 +2415,12 @@ export type TableCellMeasure = {
     paragraph?: ParagraphMeasure;
     width: number;
     height: number;
+    /** Resolved whole-cell rotated flow; dimensions exclude physical padding/borders. */
+    verticalText?: {
+        direction: 'btLr' | 'tbRl';
+        inlineSize: number;
+        blockSize: number;
+    };
     /** Starting grid column index (0-based) */
     gridColumnStart?: number;
     /** Number of grid columns this cell spans */

package/dist/layout-engine/layout-bridge/src/incrementalLayout.d.ts

@@ -372,8 +372,7 @@ export type IncrementalPaginationProof = IncrementalPaginationProofBase & ({
         predecessorBlockId: string | null;
     };
     /**
-     * SD-3772 D1: true means the host proved (via the shared
-     * `hasGenuinelyUnequalExplicitColumnWidths` predicate) that no
+     * SD-3772 D1: true means the host proved that no
      * potentially balanceable multi-column section exists anywhere in the
      * retained document. Balancing is a post-pagination finalizer that a
      * mid-section checkpoint cannot seed. False is admissible only

package/dist/layout-engine/layout-engine/src/column-balancing.d.ts

@@ -250,8 +250,8 @@ export interface BalanceSectionOnPageArgs {
  * Guards (skip balancing when):
  *   - Section has <= 1 column (nothing to balance)
  *   - Section contains an explicit column break (author intent wins)
- *   - Section uses GENUINELY-unequal column widths (Word fills these column-by-column;
- *     explicit widths that are all equal still balance — SD-2324)
+ *   - Section uses genuinely unequal widths, which require width-aware reflow
+ *     rather than this redistribution of fixed line measurements
  *   - No fragments on this page belong to the section
  */
 export declare function balanceSectionOnPage(args: BalanceSectionOnPageArgs): {

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

@@ -3,7 +3,7 @@ import { FootnotePageFlow } from './footnote-page-flow.js';
 import { PageState, ConstraintBoundary } from './paginator.js';
 import { LayoutExecutionControl } from './execution.js';
 export type { FootnotePageFlow } from './footnote-page-flow.js';
-export { findLineIndexForRunOrdinal } from './layout-utils.js';
+export { findLineIndexForRunOrdinal, findKeepNextChainStart, isOutOfFlowDrawing } from './layout-utils.js';
 type PageSize = {
     w: number;
     h: number;

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

@@ -21,6 +21,7 @@ export type ParagraphLayoutContext = {
     block: ParagraphBlock;
     measure: ParagraphMeasure;
     columnWidth: number;
+    columnWidthForState?: (state: PageState) => number;
     ensurePage: () => PageState;
     advanceColumn: (state: PageState) => PageState;
     columnX: (state: PageState, columnIndex?: number) => number;
@@ -32,6 +33,8 @@ export type ParagraphLayoutContext = {
      * When undefined, uses the value from block.attrs.spacing.after.
      */
     overrideSpacingAfter?: number;
+    /** A keep-next preflight moved this paragraph to a fresh page. */
+    suppressSpacingBefore?: boolean;
     /**
      * SD-3049 / SD-2656: footnote demand under the ordered-cluster rule.
      *

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

@@ -1,4 +1,4 @@
-import { Line, ParagraphBlock, ParagraphMeasure, LinePmRange } from '../../contracts/src/index.js';
+import { FlowBlock, Line, ParagraphBlock, ParagraphMeasure, LinePmRange } from '../../contracts/src/index.js';
 /**
  * Tracks which paragraph spacing properties were explicitly set.
  *
@@ -104,3 +104,7 @@ export declare function computeParagraphLayoutStartY(input: {
 export declare const extractBlockPmRange: (block: {
     attrs?: Record<string, unknown>;
 } | null | undefined) => LinePmRange;
+/** Positioned drawings are laid out by their owner, rather than consuming a flow slot. */
+export declare function isOutOfFlowDrawing(block: FlowBlock): boolean;
+/** Find the kept paragraph whose page decision also owns this flow block. */
+export declare function findKeepNextChainStart(blocks: readonly FlowBlock[], index: number): number;

package/dist/layout-engine/layout-engine/src/paragraph-continuation.d.ts

@@ -0,0 +1,6 @@
+import { Line, ParagraphBlock } from '../../contracts/src/index.js';
+/** Build a measurement-only suffix while keeping line coordinates in the original paragraph. */
+export declare function paragraphContinuation(block: ParagraphBlock, first: Line): {
+    block: ParagraphBlock;
+    mapLine: (line: Line) => Line;
+};

package/dist/superdoc.cjs

@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.22.0-next.15";
+		return "2.22.0-next.16";
 	} catch {
 		return "unknown";
 	}
@@ -46382,7 +46382,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.22.0-next.15";
+		this.version = "2.22.0-next.16";
 		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

@@ -314,7 +314,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.22.0-next.15";
+		return "2.22.0-next.16";
 	} catch {
 		return "unknown";
 	}
@@ -46311,7 +46311,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.22.0-next.15";
+		this.version = "2.22.0-next.16";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];