superdoc 2.6.0-next.13 → 2.6.0-next.15

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.6.0-next.13",
+	superdocVersion: "2.6.0-next.15",
 	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.6.0-next.13",
+	superdocVersion: "2.6.0-next.15",
 	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/header-footer-resolution.d.ts

@@ -24,5 +24,19 @@ export type HeaderFooterEffectiveRefResult = {
     matchedSectionIndex: number;
     matchedVariant: HeaderFooterVariant;
 };
+/**
+ * Ordered, snapshot-backed resolver for repeated header/footer lookups.
+ * Runtime section updates must go through `updateSection` so cached inherited
+ * results cannot outlive a reference change.
+ */
+export declare class HeaderFooterResolutionIndex {
+    #private;
+    constructor(sections: readonly HeaderFooterResolutionSection[]);
+    get revision(): number;
+    hasAny(kind: HeaderFooterKind): boolean;
+    resolve(sectionIndex: number, kind: HeaderFooterKind, variant: HeaderFooterVariant): HeaderFooterEffectiveRefResult | null;
+    updateSection(section: HeaderFooterResolutionSection): boolean;
+}
+export declare function createHeaderFooterResolutionIndex(sections: readonly HeaderFooterResolutionSection[]): HeaderFooterResolutionIndex;
 export declare function selectHeaderFooterVariantForPage({ documentPageNumber, sectionPageNumber, titlePg, alternateHeaders, }: HeaderFooterVariantSelectionInput): HeaderFooterVariant | null;
 export declare function resolveEffectiveHeaderFooterRef({ sections, sectionIndex, kind, variant, }: HeaderFooterEffectiveRefInput): HeaderFooterEffectiveRefResult | null;

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

@@ -10,7 +10,7 @@ export type { BaseDirection, WritingMode, SectionDirectionContext, TableDirectio
 export { getParagraphInlineDirection, getTableVisualDirection } from './direction-context.js';
 export { OOXML_PCT_DIVISOR, resolveTableWidthAttr, type TableWidthAttr, type TableColumnSpec, } from './engines/tables.js';
 export { effectiveTableCellSpacing } from './table-cell-spacing.js';
-export { selectHeaderFooterVariantForPage, resolveEffectiveHeaderFooterRef, type HeaderFooterKind, type HeaderFooterVariant, type HeaderFooterSectionRefs, type HeaderFooterResolutionSection, type HeaderFooterVariantSelectionInput, type HeaderFooterEffectiveRefInput, type HeaderFooterEffectiveRefResult, } from './header-footer-resolution.js';
+export { createHeaderFooterResolutionIndex, selectHeaderFooterVariantForPage, resolveEffectiveHeaderFooterRef, type HeaderFooterResolutionIndex, type HeaderFooterKind, type HeaderFooterVariant, type HeaderFooterSectionRefs, type HeaderFooterResolutionSection, type HeaderFooterVariantSelectionInput, type HeaderFooterEffectiveRefInput, type HeaderFooterEffectiveRefResult, } from './header-footer-resolution.js';
 export { rescaleColumnWidths } from './table-column-rescale.js';
 export { getCellSpacingPx } from './cell-spacing.js';
 export { normalizeZIndex, coerceRelativeHeight, isPlainObject, OOXML_Z_INDEX_BASE, resolveFloatingZIndex, getFragmentZIndex, } from './ooxml-z-index.js';

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

@@ -46,6 +46,10 @@ export type MeasureCacheStats = {
      */
     memorySizeEstimate: number;
 };
+declare const preparedMeasureCacheKeyBrand: unique symbol;
+export type PreparedMeasureCacheKey = string & {
+    readonly [preparedMeasureCacheKeyBrand]: true;
+};
 /**
  * LRU-enhanced MeasureCache
  *
@@ -77,6 +81,12 @@ export declare class MeasureCache<T> {
      * @returns The cached value or undefined
      */
     get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): T | undefined;
+    /**
+     * Compose the complete content, constraint, and font key once for a cache
+     * read followed by an insertion in the same measurement transaction.
+     */
+    prepareKey(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): PreparedMeasureCacheKey | undefined;
+    getPrepared(key: PreparedMeasureCacheKey | undefined): T | undefined;
     /**
      * Store a measure in the cache for the given block and dimensions.
      * Silently returns if the block is null/undefined or lacks an ID.
@@ -87,6 +97,7 @@ export declare class MeasureCache<T> {
      * @param value - The value to cache
      */
     set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string): void;
+    setPrepared(key: PreparedMeasureCacheKey | undefined, blockId: string | undefined, value: T): void;
     /**
      * Invalidates cached measurements for specific block IDs.
      * Removes all cache entries whose keys start with any of the provided block IDs.
@@ -144,3 +155,4 @@ export declare class MeasureCache<T> {
      */
     private composeKey;
 }
+export {};

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

@@ -95,6 +95,10 @@ export type IncrementalLayoutBridgeTiming = {
     /** Union wall time spent inside caller-owned measure callbacks across body and furniture. */
     measureCallbackWallMs: number;
     measureCacheLookupMs: number;
+    /** Body-measure cache insertion wall time, including content-key composition. */
+    measureCacheWriteMs: number;
+    /** Previous-measure content-adoption lookup/build wall time. */
+    measureContentAdoptionMs: number;
     measureActualMs: number;
     headerFooterPreLayoutMs: number;
     headerPreLayoutMs: number;
@@ -104,6 +108,14 @@ export type IncrementalLayoutBridgeTiming = {
     layoutDocumentMs: number;
     /** Initial body-layout wrapper work outside `layoutDocument` (proof, slice, convergence, splice). */
     layoutReuseOrchestrationMs: number;
+    /** Initial pagination invocation including bridge reuse orchestration. */
+    paginationInitialMs: number;
+    /** Body page-token convergence pagination only. */
+    paginationPageTokenMs: number;
+    /** Footnote convergence pagination only; overlaps `footnoteMs`. */
+    paginationFootnoteMs: number;
+    /** All initial, page-token, and footnote pagination invocation wall time. */
+    paginationTotalMs: number;
     paginationMs: number;
     pageTokenSetupMs: number;
     pageTokenTotalMs: number;
@@ -116,8 +128,16 @@ export type IncrementalLayoutBridgeTiming = {
     unattributedMs: number;
     counters: {
         blocksRead: number;
+        blocksByKind?: Record<FlowBlock['kind'], number>;
+        bodyBlocksMeasuredByKind: Record<FlowBlock['kind'], number>;
         cacheHits: number;
         cacheMisses: number;
+        bodyMeasureCacheReads: number;
+        bodyMeasureCacheWrites: number;
+        bodyMeasureCacheKeyComputations: number;
+        measureContentSignatureComputations: number;
+        fontSignaturePresent: number;
+        fontSignatureChanged: number;
         measuresAdopted: number;
         pagesPaginated: number | null;
         pagesSplicedByReuse: number;

package/dist/superdoc.cjs

@@ -18104,7 +18104,9 @@ function scrollToElement(targetElement, options = {
 	if (!targetElement) return;
 	const container = getScrollableParent(targetElement);
 	const containerRect = container.getBoundingClientRect();
-	const offsetTop = targetElement.getBoundingClientRect().top - containerRect.top + container.scrollTop;
+	const targetRect = targetElement.getBoundingClientRect();
+	const containerTop = container === (document.scrollingElement || document.documentElement) ? 0 : containerRect.top;
+	const offsetTop = targetRect.top - containerTop + container.scrollTop;
 	const scrollPaddingTopValue = window.getComputedStyle(container).scrollPaddingTop?.trim();
 	const resolvedScrollPaddingTop = scrollPaddingTopValue?.endsWith("px") ? Number(scrollPaddingTopValue.slice(0, -2)) : 0;
 	const scrollPaddingTop = Number.isFinite(resolvedScrollPaddingTop) && resolvedScrollPaddingTop >= 0 ? resolvedScrollPaddingTop : 0;
@@ -43603,7 +43605,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.6.0-next.13";
+		this.version = "2.6.0-next.15";
 		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

@@ -18072,7 +18072,9 @@ function scrollToElement(targetElement, options = {
 	if (!targetElement) return;
 	const container = getScrollableParent(targetElement);
 	const containerRect = container.getBoundingClientRect();
-	const offsetTop = targetElement.getBoundingClientRect().top - containerRect.top + container.scrollTop;
+	const targetRect = targetElement.getBoundingClientRect();
+	const containerTop = container === (document.scrollingElement || document.documentElement) ? 0 : containerRect.top;
+	const offsetTop = targetRect.top - containerTop + container.scrollTop;
 	const scrollPaddingTopValue = window.getComputedStyle(container).scrollPaddingTop?.trim();
 	const resolvedScrollPaddingTop = scrollPaddingTopValue?.endsWith("px") ? Number(scrollPaddingTopValue.slice(0, -2)) : 0;
 	const scrollPaddingTop = Number.isFinite(resolvedScrollPaddingTop) && resolvedScrollPaddingTop >= 0 ? resolvedScrollPaddingTop : 0;
@@ -43536,7 +43538,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.6.0-next.13";
+		this.version = "2.6.0-next.15";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];