postext 0.3.19 → 0.3.20

package/dist/pipeline/build.d.ts

@@ -1,6 +1,7 @@
 import type { PostextContent, PostextConfig } from '../types';
 import { type VDTDocument } from '../vdt';
 import type { MeasurementCache } from '../measure';
+import { type BandCap, type BandPassReport } from './bandCaps';
 export interface BuildDocumentOptions {
     /**
      * Cooperative cancellation hook. Called once per top-level content block
@@ -13,5 +14,36 @@ export interface BuildDocumentOptions {
 export declare class BuildCancelledError extends Error {
     constructor();
 }
+/** Cross-pass hints a placement pass consumes. All keyed by content-block
+ *  index; every map is optional so the plain first pass carries none. */
+export interface PassHints {
+    /** Column balancing: extra top spacing (px) per heading / list-end target. */
+    balanceExtraPx?: ReadonlyMap<number, number>;
+    /** Column balancing: K-P looseness per paragraph re-broken one line longer. */
+    balanceLooseness?: ReadonlyMap<number, number>;
+    /** Band caps keyed by the span block's content index (see `bandCaps.ts`). */
+    bandCaps?: ReadonlyMap<number, BandCap>;
+}
+export interface PassResult extends BandPassReport {
+    doc: VDTDocument;
+    /** Pages whose break into the next page was explicit (`:::pagebreak`,
+     *  heading `breakBefore`, chapter opener) rather than natural content
+     *  overflow — those pages keep their short last column. */
+    forcedBreakPages: Set<number>;
+    bandCapProposals: Map<number, BandCap>;
+    spanPlacedInBand: Set<number>;
+    bandCapsApplied: Set<number>;
+}
+/**
+ * Single placement pass. `hints` carries the cross-pass adjustments: the
+ * column-balancing spacing / looseness and the band caps of page-span
+ * blocks. Besides the document it reports `forcedBreakPages` (for
+ * balancing) and the band-cap bookkeeping the driver in `buildDocument`
+ * needs — new cap proposals, the span blocks that landed in their capped
+ * band, and the caps that were actually applied.
+ *
+ * @internal Exposed for tests only; use `buildDocument`.
+ */
+export declare function buildDocumentPass(content: PostextContent, config?: PostextConfig, cache?: MeasurementCache, options?: BuildDocumentOptions, hints?: PassHints): PassResult;
 export declare function buildDocument(content: PostextContent, config?: PostextConfig, cache?: MeasurementCache, options?: BuildDocumentOptions): VDTDocument;
 //# sourceMappingURL=build.d.ts.map

package/dist/pipeline/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/pipeline/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAA0B,MAAM,UAAU,CAAC;AAGtF,OAAO,EAIL,KAAK,WAAW,EAIjB,MAAM,QAAQ,CAAC;AAWhB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkDnD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAmjCD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,WAAW,CA8Db"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/pipeline/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAA8C,MAAM,UAAU,CAAC;AAG1G,OAAO,EAIL,KAAK,WAAW,EAKjB,MAAM,QAAQ,CAAC;AAWhB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiEnD,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAWD;yEACyE;AACzE,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,GAAG,EAAE,WAAW,CAAC;IACjB;;+DAE2D;IAC3D,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,KAAK,GAAE,SAAc,GACpB,UAAU,CAw7CZ;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,WAAW,CAiFb"}