superdoc 2.12.0-next.8 → 2.12.0-next.9

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.12.0-next.8",
+	superdocVersion: "2.12.0-next.9",
 	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.12.0-next.8",
+	superdocVersion: "2.12.0-next.9",
 	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/index.d.ts

@@ -2836,7 +2836,7 @@ export declare const extractHeaderFooterSpace: (margins?: PageMargins | null) =>
 };
 export type { ResolvedLayout, ResolvedPage, ResolvedPaintItem, ResolvedGroupItem, ResolvedFragmentItem, ResolvedParagraphContent, ResolvedTextLineItem, ResolvedDropCapItem, ResolvedListMarkerItem, ResolvedTableItem, ResolvedImageItem, ResolvedDrawingItem, ResolvedHeaderFooterPage, ResolvedHeaderFooterLayout, } from './resolved-layout.js';
 export { isResolvedTableItem, isResolvedImageItem, isResolvedDrawingItem } from './resolved-layout.js';
-export { expandRunsForInlineNewlines, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
+export { expandRunsForInlineNewlines, isBodyNoteReferenceRun, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
 export { INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
 export { inlineBoxStyleSignature, isFiniteNonNegativeInteger, normalizeInlineBoxLogicalSides, type InlineBoxLogicalSides, type ResolvedInlineBoxLogicalSides, } from './inline-box.js';
 export { INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES, PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, isValidIncrementalDependencyOwnerVersion, isValidNonFlowingPageRelativeAnchorDependencyProof, isValidPageCheckpointDependencyCertificate, type IncrementalDependencyCertificateClass, type IncrementalDependencyOwnerVersion, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyCertificate, type PageCheckpointDependencyClass, } from './incremental-dependency.js';

package/dist/layout-engine/contracts/src/run-helpers.d.ts

@@ -1,4 +1,12 @@
 import { FlowBlock, Line, Run, TextRun } from './index.js';
+export declare const NOTE_REFERENCE_MARKER_ATTR = "data-v2-note-ref";
+export declare const NOTE_LABEL_MARKER_ATTR = "data-v2-note-label";
+/** Body note markers paint text but occupy one source-coordinate unit. */
+export declare function isBodyNoteReferenceRun(run: Run): boolean;
+/** Synthetic note-band or appended-endnote label keyed to its source note. */
+export declare function isNoteLabelRun(run: Run): boolean;
+/** Numbered marker text whose measurement identity can use digit capabilities. */
+export declare function isNumberedNoteMarkerRun(run: Run): boolean;
 export declare function isEmptySdtPlaceholderRun(run: Run): run is TextRun & {
     visualPlaceholder: 'emptyInlineSdt' | 'emptyBlockSdt';
 };

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

@@ -1,4 +1,5 @@
 import { FlowBlock } from '../../contracts/src/index.js';
+import { FontMeasureCapabilities } from '../../../shared/font-system/src/index.js';
 /**
  * Generates a cache key hash from a block's content, incorporating text,
  * formatting, and embedded block data.
@@ -23,7 +24,7 @@ import { FlowBlock } from '../../contracts/src/index.js';
  * content component of that key, so adopting a previous measure on hash
  * equality is exactly as sound as a cache hit.
  */
-export declare const hashMeasureContent: (block: FlowBlock) => string;
+export declare const hashMeasureContent: (block: FlowBlock, capabilities?: FontMeasureCapabilities) => string;
 /**
  * Cache statistics with LRU eviction tracking
  */
@@ -80,12 +81,12 @@ export declare class MeasureCache<T> {
      * @param height - The height dimension for cache key
      * @returns The cached value or undefined
      */
-    get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): T | undefined;
+    get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string, capabilities?: FontMeasureCapabilities): 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;
+    prepareKey(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string, capabilities?: FontMeasureCapabilities): PreparedMeasureCacheKey | undefined;
     getPrepared(key: PreparedMeasureCacheKey | undefined): T | undefined;
     /**
      * Store a measure in the cache for the given block and dimensions.
@@ -96,7 +97,7 @@ export declare class MeasureCache<T> {
      * @param height - The height dimension for cache key
      * @param value - The value to cache
      */
-    set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string): void;
+    set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string, capabilities?: FontMeasureCapabilities): void;
     setPrepared(key: PreparedMeasureCacheKey | undefined, blockId: string | undefined, value: T): void;
     /**
      * Invalidates cached measurements for specific block IDs.

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

@@ -1,5 +1,5 @@
 import { NonFlowingPageRelativeAnchorDependencyProof, PageCheckpointDependencyClass, FlowBlock, Layout, LayoutBlockResumeCheckpoint, Measure, Page, HeaderFooterLayout, ColumnLayout } from '../../contracts/src/index.js';
-import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
+import { FontMeasureCapabilities, FontMeasureContext } from '../../../shared/font-system/src/index.js';
 import { LayoutOptions, HeaderFooterConstraints, LayoutExecutionCheckpoint } from '../../layout-engine/src/index.js';
 import { computeDirtyRegions } from './diff.js';
 import { MeasureCache } from './cache.js';
@@ -534,10 +534,13 @@ export declare function incrementalLayout(previousBlocks: FlowBlock[], _previous
 }, previousMeasures?: Measure[] | null, fontRuntime?: {
     fontContext?: FontMeasureContext;
     previousFontSignature?: string;
+    fontCapabilities?: FontMeasureCapabilities;
 }, warmStart?: {
     footnoteReserveSeed?: FootnoteReserveSeed | null;
     /** Host proved the authoritative note projection bundle was retained exactly. */
     noteMeasurePlaneRetainedExact?: true;
+    /** Host proved this seed is an exact, geometry-equivalent subset of the current note plane. */
+    noteMeasurePlaneRetainedSubset?: true;
     /** Extra note/decorative planes paired with the retained note bundle. */
     retainedFootnoteExtras?: {
         blocks: FlowBlock[];

package/dist/layout-engine/layout-bridge/src/note-marker-measure-key.d.ts

@@ -0,0 +1,3 @@
+import { TextRun } from '../../contracts/src/index.js';
+import { FontMeasureCapabilities } from '../../../shared/font-system/src/index.js';
+export declare function noteMarkerMeasureKey(run: TextRun, capabilities?: FontMeasureCapabilities): string;

package/dist/shared/font-system/src/index.d.ts

@@ -15,7 +15,7 @@
  */
 export type { FontLoadStatus, FontFaceSource, FontFaceDescriptor, RegisteredFace, RegisterFaceResult, FontLoadResult, FontLoadSummary, FontFaceRequest, FontFaceLoadResult, FontAssetUrlContext, FontAssetUrlResolver, RequiredFace, } from './types.js';
 export { SETTLED_STATUSES, isSettled } from './types.js';
-export type { FontResolution, FontResolutionReason, FaceKey, HasFace, FontMeasureContext, ResolvePhysicalFamily, ResolveNaturalLineMultiplier, } from './resolver.js';
+export type { FontResolution, FontResolutionReason, FaceKey, HasFace, FontMeasureCapabilities, FontMeasureContext, FontMeasureFace, ResolvePhysicalFamily, ResolveNaturalLineMultiplier, } from './resolver.js';
 export { FontResolver, createFontResolver, insertFontFamilyBeforeGeneric } from './resolver.js';
 export { resolveFontFamily, resolvePhysicalFamily, resolvePrimaryPhysicalFamily, resolvePhysicalFamilies, resolveFace, DEFAULT_FONT_MEASURE_CONTEXT, } from './resolver.js';
 export { getFontConfigVersion, bumpFontConfigVersion, __resetFontConfigVersion } from './epoch.js';

package/dist/shared/font-system/src/resolver.d.ts

@@ -212,6 +212,17 @@ export interface FontMeasureContext {
     resolveNaturalLineMultiplier?: ResolveNaturalLineMultiplier;
     fontSignature: string;
 }
+/** Font face inputs whose measured digit advances can affect layout reuse. */
+export interface FontMeasureFace {
+    family: string;
+    sizePx: number;
+    weight: FaceKey['weight'];
+    style: FaceKey['style'];
+}
+/** Immutable, invocation-scoped facts established by the active measurement surface. */
+export interface FontMeasureCapabilities {
+    hasTabularDigits(face: FontMeasureFace): boolean;
+}
 /**
  * The global-resolver / empty-signature context. The behavior-preserving default for outer entry
  * points and non-document callers (tests, the global measure path). Frozen so a stray

package/dist/superdoc.cjs

@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.12.0-next.8";
+		return "2.12.0-next.9";
 	} catch {
 		return "unknown";
 	}
@@ -45214,7 +45214,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.12.0-next.8";
+		this.version = "2.12.0-next.9";
 		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

@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.12.0-next.8";
+		return "2.12.0-next.9";
 	} catch {
 		return "unknown";
 	}
@@ -45145,7 +45145,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.12.0-next.8";
+		this.version = "2.12.0-next.9";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];