@sobree/core 0.1.16 → 0.1.18

package/dist/paperStack/paginationAdapter/columnFlow.d.ts

@@ -1,41 +1,42 @@
 /**
- * Unequal multi-column flow.
+ * Multi-column section flow — equal AND unequal, across pages.
  *
- * CSS multi-column only produces equal columns, so a Word section with
- * explicit per-column widths (`<w:cols w:equalWidth="0">`) can't be laid
- * out by CSS. The renderer (`openColumnContainerIfNeeded`) emits a flat
- * `.sobree-cols-unequal` wrapper stamped with the column geometry; this
- * pass — run after layout, when heights are measurable — restructures it
- * into explicit-width column tracks and flows the section's blocks across
- * them.
+ * A Word multi-column section (`<w:cols w:num="2">`, with or without
+ * explicit per-column widths) flows its content in newspaper order:
+ * fill column 0 to the page bottom, then column 1, then continue on the
+ * NEXT page. CSS can express neither unequal column widths nor a flow
+ * that fragments across our manually-paginated, fixed-height page boxes,
+ * so this pass owns the whole 2-D layout: it restructures a section's
+ * blocks into explicit width tracks, chunked one wrapper per page.
  *
- * Fill model: BALANCE, not fill-to-page. Word balances a multi-column
- * section that has no explicit column break and fits one page — it
- * equalises the column heights rather than packing the first column to
- * the page bottom and spilling the remainder. (CSS `column-count` does
- * the same for the equal-width path; this is the unequal-width analogue.)
- * A naive "fill column 1 to the page height, then spill" instead packs
- * the wide column nearly full before the narrow one starts, and — worse —
- * the page-height threshold sits far above the actual content, so a few
- * pixels of font-metric drift between renders (web fonts loaded vs not)
- * flip blocks across the boundary. Balancing both matches Word and is
- * stable: the split lands at the block boundary that minimises the
- * tallest column, which block granularity pins in place.
+ * The renderer (`openColumnContainerIfNeeded`) emits ONE flat
+ * `.sobree-cols` wrapper per section, stamped with the geometry and a
+ * stable section id (`data-pag-cid`). This pass — run after layout, when
+ * heights are measurable — replaces that wrapper with a sequence of
+ * page-sized wrappers (the first reused in place, the rest inserted as
+ * siblings). Each is at most one page tall, so the column-agnostic
+ * paginator downstream simply places each on its own page; the columns
+ * "snake" because page K+1 continues page K's content.
  *
- * Scope: single-page column sections (a section whose content fits one
- * page), which matches the equal-column path's current capability — that
- * wraps a section's content in one monolithic block the paginator places
- * on a single page. Blocks are moved whole (a paragraph is not split
- * across a column boundary); that's faithful for the templates this
- * targets, where columns break at block boundaries. `colHeightPx` is the
- * page content height — a hard ceiling no column may exceed (content
- * taller than that genuinely overflows the page, out of this scope).
- * Idempotent: re-running re-flattens and re-fills, so the iterative
- * paginate loop can call it each pass.
+ * Fill model:
+ *   - Interior pages are FILLED: column 0 packed to the page budget,
+ *     then column 1, etc.
+ *   - The FINAL page is BALANCED (equalised column heights), matching
+ *     Word's "balance columns at section end". A section that fits one
+ *     page is a single, balanced chunk — identical to the previous
+ *     single-page behaviour.
+ *
+ * Blocks move whole (a paragraph is never split across a column or page
+ * boundary); that's faithful for the templates this targets, where
+ * columns break at block boundaries.
+ *
+ * Idempotent: the repaginate loop re-collects every block and re-runs
+ * this pass each iteration. On entry we re-consolidate the per-page
+ * wrappers of each section (matched by `data-pag-cid`) back into one,
+ * then re-chunk — so re-running is a no-op on a settled layout.
  */
 /**
- * Flow every unequal-column section under `root` into its width tracks.
- * `colHeightPx` is the page content-height budget (the height each
- * column may fill before spilling to the next).
+ * Flow every multi-column section under `root` into per-page column
+ * chunks. `pageHeightPx` is the page content-height budget.
  */
-export declare function flowUnequalColumnSections(root: HTMLElement, colHeightPx: number): void;
+export declare function flowColumnSections(root: HTMLElement, pageHeightPx: number): void;

package/dist/sobree.d.ts

@@ -68,6 +68,11 @@ export interface SobreeOptions {
      * after a deploy) — it has no other behaviour.
      */
     versionBadge?: boolean;
+    /**
+     * Show hidden text (`<w:vanish/>`) from the start. Off by default
+     * (print-faithful). Toggle later with `editor.setShowHiddenText`.
+     */
+    showHiddenText?: boolean;
 }
 /**
  * Top-level embeddable product surface. Composes a framework-free `Editor`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sobree/core",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "publishConfig": {
     "access": "public"
   },