@sobree/core 0.1.32 → 0.1.33

package/dist/paperStack/paperStack.d.ts

@@ -143,6 +143,11 @@ export declare class PaperStack {
      * flow instead of accumulating inter-fragment margins.
      */
     repaginate(): void;
+    /** Adapter exposing the DOM-owning steps the repagination orchestrator
+     *  needs, without making PaperStack's internals public. Caret save/restore
+     *  is model-based (block id + offset + cell) so it survives the paper
+     *  rebuild — see `positionMap`'s selection descriptor. */
+    private get repaginationHost();
     /**
      * One round of consolidate → merge → paginate → distribute.
      * Re-entrant: each call re-collects blocks from every paper, so the

package/dist/paperStack/repagination/index.d.ts

@@ -0,0 +1,2 @@
+export { MAX_REPAGINATE_RETRIES, OVERFLOW_TOLERANCE_PX, repaginate } from './run';
+export type { RepaginationHost } from './types';

package/dist/paperStack/repagination/run.d.ts

@@ -0,0 +1,31 @@
+import { RepaginationHost } from './types';
+/** Cap on iterative repagination retries. Each iteration shrinks the
+ *  budget by the observed overflow, so convergence is exponential —
+ *  3 is plenty for any realistic doc and prevents accidental infinite
+ *  loops on pathological content. */
+export declare const MAX_REPAGINATE_RETRIES = 3;
+/** "Is this page actually overflowing enough to warrant a re-pack?"
+ *  Set to ~one body line — sub-line overflows are visually
+ *  imperceptible and re-paginating to fix them tends to shift page
+ *  breaks by a full line elsewhere, drifting AWAY from Word/LibreOffice
+ *  break points rather than toward them. We only iterate when the
+ *  overflow exceeds a typical line height. (~28px ≈ 21pt at 12pt
+ *  body — covers the common case where split-slippage adds a line.) */
+export declare const OVERFLOW_TOLERANCE_PX = 28;
+/**
+ * Redistribute blocks across papers until the page set is stable.
+ *
+ * 1. collect all blocks; if none, ensure one paper, render zones, emit, done.
+ * 2. save selection; compute the baseline page-height budget.
+ * 3. iterate (bounded by {@link MAX_REPAGINATE_RETRIES}):
+ *      a. paginate once with the current per-page budgets,
+ *      b. distribute footnotes (populates per-page zones),
+ *      c. rebuild per-page budgets from observed footnote-zone heights,
+ *      d. stop when the budgets are stable AND no paper overflows beyond
+ *         {@link OVERFLOW_TOLERANCE_PX}.
+ * 4. restore selection, render zones, apply per-section settings, emit.
+ *
+ * Each iteration's shrunken budget reserves footnote space, so the body
+ * re-flows to fit; convergence is exponential.
+ */
+export declare function repaginate(host: RepaginationHost): void;

package/dist/paperStack/repagination/types.d.ts

@@ -0,0 +1,30 @@
+import { SelectionDescriptor } from '../../editor/internal/positionMap';
+export interface RepaginationHost {
+    /** Every block element currently distributed across all papers. */
+    collectAllBlocks(): HTMLElement[];
+    /** Snapshot the live caret/selection as a model descriptor (block id +
+     *  offset + cell) that survives the paper DOM rebuild, or null. */
+    captureSelection(): SelectionDescriptor | null;
+    /** Re-apply a snapshot captured by {@link captureSelection} after the rebuild. */
+    restoreSelection(saved: SelectionDescriptor | null): void;
+    /** Create or remove papers so there are exactly `count` of them. */
+    ensurePaperCount(count: number): void;
+    /** The baseline per-page content height budget, in CSS px. */
+    pageContentHeightPx(): number;
+    /** Run ONE consolidate→merge→paginate→distribute pass at the given
+     *  baseline budget and per-page height overrides. */
+    runPaginationOnce(baselineBudgetPx: number, pageHeights: readonly number[]): void;
+    /** Populate each paper's footnote zone from the refs that landed on it. */
+    distributeFootnotes(): void;
+    /** Per-page budgets after subtracting observed footnote-zone heights;
+     *  trailing full-baseline entries trimmed (length 0 ⇒ no overrides). */
+    footnotePageHeights(baselineBudgetPx: number): number[];
+    /** The largest amount (px) any single paper currently overflows by. */
+    maxPaperOverflowPx(): number;
+    /** Re-render header/footer (and anchor) zones on every paper. */
+    renderAllZones(): void;
+    /** Apply per-section property overrides (e.g. vertical alignment). */
+    applyPerSectionSettings(): void;
+    /** Fire the `paginate` event to listeners. */
+    emitPaginate(): void;
+}

package/package.json

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