@sobree/core 0.1.35 → 0.1.36

package/dist/editor/view/docRenderer/sectionFlow.d.ts

@@ -12,10 +12,33 @@ import { SectionProperties } from '../../../doc/types';
  *   - `data-col-count`     — column count (every multi-column wrapper)
  *   - `data-pag-cid`       — stable section id, so the flow pass can
  *                            re-consolidate a section's per-page wrappers
+ *   - `data-col-fill`="1"  — fill column 0 to the page bottom, then column
+ *                            1 (newspaper) instead of balancing the last
+ *                            page; see `columnsFillNotBalance`
  *   - unequal: `data-col-widths-mm` + `data-col-gaps-mm` (explicit)
  *   - equal:   `data-col-gap-mm` (tracks sized by the flow pass)
+ *
+ * `nextSection` is the section that BEGINS immediately after this one; its
+ * break type is what TERMINATES this one, and so decides balance vs fill.
+ */
+export declare function openColumnContainerIfNeeded(host: HTMLElement, section: SectionProperties | undefined, sectionIndex?: number, nextSection?: SectionProperties | undefined): HTMLElement;
+/**
+ * Whether a multi-column section should FILL column-first (column 0 to the
+ * page bottom, then column 1) rather than balance its last page.
+ *
+ * Word balances a multi-column section's columns only when the section ends
+ * at a CONTINUOUS section break (or the document end); a section terminated
+ * by a hard page break (`nextPage` / `evenPage` / `oddPage`) fills column by
+ * column instead, leaving the second column short when the text runs out.
+ * `nextSection` is the section that begins right after — its break `type` is
+ * this section's terminator. No next section ⇒ document end ⇒ balance.
+ * (OOXML's `<w:type>` default is `nextPage`, so an unset type fills.)
  */
-export declare function openColumnContainerIfNeeded(host: HTMLElement, section: SectionProperties | undefined, sectionIndex?: number): HTMLElement;
+export declare function columnsFillNotBalance(nextSection: SectionProperties | undefined): boolean;
+/** Whether `section` begins on a fresh page — its break `type` is a hard
+ *  page break (`nextPage` / `evenPage` / `oddPage`). A continuous (or unset)
+ *  section continues on the running page. */
+export declare function sectionStartsOnFreshPage(section: SectionProperties | undefined): boolean;
 /**
  * If `container` is a column-flow container, move any trailing
  * visually-empty paragraphs out of it and append them to `host`. Keeps