superdoc 2.24.0 → 2.25.0-next.10

package/dist/layout-engine/layout-bridge/src/text-measurement.d.ts

@@ -1,3 +1,4 @@
+import { LayoutMeasurementContext } from './measurement-environment.js';
 import { FlowBlock, Line, Run } from '../../contracts/src/index.js';
 import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
 /**
@@ -7,6 +8,13 @@ import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
  * @returns CSS font string (e.g., "italic bold 16px Arial")
  */
 export declare function getRunFontString(run: Run, fontContext?: FontMeasureContext): string;
+/** Native caret text box for inline-image paragraphs, including wrapped text lines. */
+export declare function measureInlineImageCaretTextBox(block: FlowBlock, line: Line, charOffset: number, fontContext?: FontMeasureContext, measurementContext?: LayoutMeasurementContext): {
+    ascent: number;
+    height: number;
+    bottomAligned: boolean;
+    bottomInset: number;
+} | null;
 export declare function measureCharacterX(block: FlowBlock, line: Line, charOffset: number, availableWidthOverride?: number, alignmentOverride?: string, fontContext?: FontMeasureContext): number;
 /**
  * Convert a character offset within a line back to a ProseMirror position.

package/dist/layout-engine/painters/dom/src/decoration-geometry.d.ts

@@ -0,0 +1,17 @@
+import { Fragment, ResolvedPage, ResolvedPaintItem } from '../../../contracts/src/index.js';
+import { PageDecorationPayload } from './renderer.js';
+export type DecorationPageGeometry = Pick<ResolvedPage, 'height' | 'margins' | 'baseMargins' | 'footnoteReserved' | 'index'>;
+export declare function resolveDecorationBandGeometry(data: PageDecorationPayload, kind: 'header' | 'footer'): {
+    effectiveHeight: number;
+    effectiveOffset: number;
+    footerYOffset: number;
+};
+/** Page-local coordinates shared by canonical painting and neutral edit geometry. */
+export declare function resolveDecorationFragmentPosition(page: DecorationPageGeometry, kind: 'header' | 'footer', data: PageDecorationPayload, fragment: Fragment, item: ResolvedPaintItem | undefined, band?: {
+    effectiveHeight: number;
+    effectiveOffset: number;
+    footerYOffset: number;
+}, behindDocument?: boolean): {
+    x: number;
+    y: number;
+};

package/dist/layout-engine/painters/dom/src/index.d.ts

@@ -133,3 +133,8 @@ export type DomPainterHandle = {
  * `mode-ownership.test.ts` battery pins the surface deleted.
  */
 export declare const createDomPainter: (options: DomPainterOptions) => DomPainterHandle;
+export { resolveRunTypographyStyles, resolveRunDecorationStyles } from './runs/text-style-facts.js';
+export { resolveTrackedChangeDecorationFacts, getTrackedChangeLayers, resolveTrackedChangesConfig, } from './runs/tracked-changes.js';
+export { buildLinkRenderData } from './runs/links.js';
+export { INLINE_TRACKED_CHANGE_DEFAULTS } from './styles.js';
+export { resolveDecorationFragmentPosition } from './decoration-geometry.js';

package/dist/layout-engine/painters/dom/src/renderer.d.ts

@@ -433,26 +433,6 @@ export declare class DomPainter {
     private resolveSeparatorColumnGeometry;
     private renderDecorationsForPage;
     private renderDecorationsForPageWork;
-    /**
-     * Check if a fragment is vertically anchored to the page.
-     * Used to determine special Y positioning for page-relative anchored content
-     * in header/footer decoration sections.
-     */
-    private isPageRelativeAnchoredFragment;
-    private isPageRelativeParagraphFrame;
-    private isPageRelativeHorizontalAnchoredFragment;
-    /**
-     * Header/footer layout emits normalized anchor Y coordinates:
-     * - headers: local to the header container origin
-     * - footers: local to the top of the footer band (pageHeight - bottomMargin)
-     *
-     * Footer containers can grow upward when content overflows the reserved footer
-     * band, so their top edge is not always the same as the footer band origin.
-     * This helper returns the page-space origin that normalized anchor Y values
-     * are measured from.
-     */
-    private getDecorationAnchorPageOriginY;
-    private getFooterFragmentAnchorPageOriginY;
     private renderDecorationSectionWork;
     private resetState;
     dispose(): void;
@@ -681,15 +661,4 @@ export declare class DomPainter {
     private applyFragmentWrapperZIndex;
     private applyResolvedFragmentFrame;
     private applyFragmentColumnOwnership;
-    /**
-     * Estimates the height of a fragment when explicit height is not available.
-     *
-     * This method provides fallback height calculations for footer bottom-alignment
-     * from resolved layout data, or using the fragment's height property for
-     * tables, images, and drawings.
-     *
-     * @param fragment - The fragment to estimate height for
-     * @returns Estimated height in pixels, or 0 if height cannot be determined
-     */
-    private estimateFragmentHeight;
 }

package/dist/layout-engine/painters/dom/src/runs/text-run.d.ts

@@ -2,6 +2,8 @@ import { Run, TextRun } from '../../../../contracts/src/index.js';
 import { FragmentRenderContext } from '../renderer.js';
 import { BROWSER_DEFAULT_FONT_SIZE } from '../styles.js';
 import { RunRenderContext, TrackedChangesRenderConfig } from './types.js';
+import { ResolvePhysicalFont } from './text-style-facts.js';
+export { underlineThicknessPx } from './text-style-facts.js';
 export type CheckboxGlyphs = {
     checked: string;
     unchecked: string;
@@ -10,23 +12,6 @@ export type CheckboxGlyphs = {
 export declare const checkboxGlyphs: (run: TextRun) => CheckboxGlyphs | null;
 /** Stamps the authored states needed to reflect an accepted checkbox toggle. */
 export declare const applyCheckboxGlyphMetadata: (element: HTMLElement, run: TextRun) => CheckboxGlyphs | null;
-/**
- * Underline thickness in px, scaled to font size. Shared by text runs
- * (`text-decoration-thickness`) and tab underlines (border width) so a run's
- * underline renders as a single uniform weight across text and tab characters,
- * matching Word, on any display density (SD-3330). The divisor approximates the
- * font's natural underline weight (≈ what `text-decoration-thickness: auto`
- * produces) while staying deterministic across platforms.
- *
- * Rounded to an integer px because CSS borders snap to integer device pixels
- * while `text-decoration-thickness` keeps fractional values; using an integer
- * makes the tab border and the text underline rasterize to the same line weight.
- */
-export declare const underlineThicknessPx: (fontSize: number) => number;
-type ResolvePhysicalFont = (cssFontFamily: string, face: {
-    weight: '400' | '700';
-    style: 'normal' | 'italic';
-}) => string;
 export declare const applyRunTypographyStyles: (element: HTMLElement, run: TextRun, resolvePhysical?: ResolvePhysicalFont) => void;
 /**
  * Applies run styling properties to a DOM element.

package/dist/layout-engine/painters/dom/src/runs/text-style-facts.d.ts

@@ -0,0 +1,9 @@
+import { TextRun } from '../../../../contracts/src/index.js';
+export type ResolvePhysicalFont = (family: string, face: {
+    weight: '400' | '700';
+    style: 'normal' | 'italic';
+}) => string;
+/** The same paint-ready typography is consumed by the DOM painter and worker sinks. */
+export declare function resolveRunTypographyStyles(run: TextRun, resolvePhysical?: ResolvePhysicalFont): Record<string, string>;
+export declare const underlineThicknessPx: (fontSize: number) => number;
+export declare function resolveRunDecorationStyles(run: TextRun): Record<string, string>;

package/dist/layout-engine/painters/dom/src/runs/tracked-changes.d.ts

@@ -21,17 +21,9 @@ export declare const resolveTrackedChangeVisualColor: (layer: TrackedChangeMeta)
  * `colorWithAlpha` can safely extend (named/non-hex visual colors still set
  * border/text but never fabricate a derived background).
  */
+export declare const resolveTrackedChangeColorVariables: (layer: TrackedChangeMeta) => Record<string, string>;
 export declare const applyTrackedChangeColorVariables: (elem: HTMLElement, layer: TrackedChangeMeta) => void;
 export declare const TRACK_CHANGE_MODIFIER_CLASS: Record<TrackedChangeKind, Record<TrackedChangesMode, string | undefined>>;
-/**
- * Stamps the semantic class + datasets for a tracked-change layer. Shared by
- * inline, row-level, and cell-level paint paths so the dataset/class vocabulary
- * stays identical. Only fields that are present are stamped; this never reads
- * or writes the author `color` dataset. The semantic datasets are namespaced
- * (`data-track-change-semantic-*`, `-type`, `-subtype`, `-target-kind`,
- * `-semantic-anchor-scope`) so they never collide with the existing author/
- * structural datasets even when row + cell metadata coexist.
- */
 export declare const applySemanticTrackedChangeMetadata: (elem: HTMLElement, meta: TrackedChangeMeta) => void;
 type TrackedChangeCarrier = Partial<Pick<TextRun, 'trackedChange' | 'trackedChanges'>>;
 type TrackedChangeDecoratable = Run | TrackedChangeCarrier;
@@ -86,5 +78,10 @@ export declare const applyRowTrackedChangeToCell: (elem: HTMLElement, meta: Trac
  * @param config - Tracked-changes mode/enabled (same source inline runs use).
  */
 export declare const applyCellTrackedChangeToCell: (elem: HTMLElement, meta: TrackedChangeMeta, config: TrackedChangesRenderConfig) => void;
+export declare const resolveTrackedChangeDecorationFacts: (run: TrackedChangeDecoratable, config: TrackedChangesRenderConfig) => {
+    classes: string[];
+    style: Record<string, string>;
+    attributes: Record<string, string>;
+};
 export declare const applyTrackedChangeDecorations: (elem: HTMLElement, run: TrackedChangeDecoratable, config: TrackedChangesRenderConfig) => void;
 export {};

package/dist/layout-engine/painters/dom/src/styles.d.ts

@@ -31,6 +31,27 @@ export declare const fragmentStyles: Partial<CSSStyleDeclaration>;
  * element itself gets z-index for layering within the line (e.g. above tab leaders).
  */
 export declare const lineStyles: (lineHeight: number) => Partial<CSSStyleDeclaration>;
+/** Default inline tracking paint values shared with non-DOM drawing consumers. */
+export declare const INLINE_TRACKED_CHANGE_DEFAULTS: {
+    readonly insert: {
+        readonly border: "#1f6feb";
+        readonly background: "#1f6feb22";
+        readonly borderWidth: 1;
+        readonly strikeWidth: 0;
+    };
+    readonly delete: {
+        readonly border: "#cb0e47";
+        readonly background: "#cb0e4722";
+        readonly borderWidth: 1;
+        readonly strikeWidth: 2;
+    };
+    readonly format: {
+        readonly border: "gold";
+        readonly background: "transparent";
+        readonly borderWidth: 2;
+        readonly strikeWidth: 0;
+    };
+};
 /** One document-scoped stylesheet the paint surface requires: head marker attribute + CSS payload. */
 export type SurfaceStylePreflightEntry = {
     markerAttribute: string;

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-bTFGKVRb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-ABeUNZlq.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-8UTu16Lw.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-CCNvH6mr.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-bTFGKVRb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-ABeUNZlq.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-8UTu16Lw.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-CCNvH6mr.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-bTFGKVRb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-ABeUNZlq.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-8UTu16Lw.es.js";
+import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-CCNvH6mr.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

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

@@ -75,7 +75,9 @@ export declare class FontRegistry {
      * constructor: the family is recorded as `unloaded` and will resolve to
      * `fallback_used` when awaited.
      */
-    register(descriptor: FontFaceDescriptor): RegisterFaceResult;
+    register(descriptor: FontFaceDescriptor, options?: {
+        preserveDescriptors?: boolean;
+    }): RegisterFaceResult;
     /** True if this registry created a managed face for the family. */
     isManaged(family: string): boolean;
     /**
@@ -126,6 +128,8 @@ export declare class FontRegistry {
      * Distinct from {@link isAvailable}, which asks whether a face is LOADED right now.
      */
     hasFace(family: string, weight: '400' | '700', style: 'normal' | 'italic'): boolean;
+    /** Face facts captured without retaining this registry or consulting later load state. */
+    snapshotFaces(): Pick<FontRegistry, 'hasFace' | 'getFaceStatus'>;
     /**
      * Synchronous availability check: is a real face for this family loaded and
      * usable in the set *right now*? Used by the gate's late-load handler to detect

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

@@ -124,6 +124,8 @@ export declare class FontResolver {
      * fonts must not leak into the next). Bumps {@link version} only if something was actually cleared.
      */
     reset(): void;
+    /** Immutable resolution owner for geometry retained with an already displayed scene. */
+    snapshot(): Pick<FontResolver, 'resolvePhysicalFamilyForFace' | 'signature'>;
     /** Monotonic version; bumps on every mapping change. A lightweight "did it change" signal. */
     get version(): number;
     /**