@betteroffice/docx 0.3.0 → 0.4.1

package/dist/{fontLoader-CkXcPB1C.d.mts → fontLoader-BNSs0E8K.d.mts}

@@ -222,6 +222,28 @@ declare function colorsEqual(color1: ColorValue | undefined | null, color2: Colo
  * - Callback notifications
  * - Font availability detection
  */
+/**
+ * The loads and notifications of one editor instance; see
+ * {@link createFontLoadScope}.
+ *
+ * @public
+ */
+interface FontLoadScope {
+    /** Hears the loads this scope asked for and module-level loads, not other scopes' loads. */
+    onFontsLoaded(callback: (fonts: string[]) => void): () => void;
+    /** Hears the failures of this scope's loads and of module-level loads. */
+    onFontError(callback: (error: Error) => void): () => void;
+    /** {@link loadDocumentFonts} on behalf of this scope. */
+    loadDocumentFonts(document: unknown): Promise<void>;
+    /** {@link loadFontsWithMapping} on behalf of this scope. */
+    loadFontsWithMapping(families: string[]): Promise<void>;
+    /** {@link loadFontDefinitions} on behalf of this scope. */
+    loadFontDefinitions(defs: ReadonlyArray<FontDefinition> | undefined): Promise<void>;
+    /** Drops the listeners and releases the embedded faces this scope holds; a later listener revives it. */
+    dispose(): void;
+    /** Whether it is disposed and not revived since. */
+    readonly disposed: boolean;
+}
 /**
  * Load a font from Google Fonts
  *
@@ -341,6 +363,28 @@ declare function loadFontFromBuffer(fontFamily: string, buffer: ArrayBuffer, opt
     weight?: number | string;
     style?: 'normal' | 'italic';
 }): Promise<boolean>;
+/** One face of a font file's bytes, as {@link registerDocumentFaces} takes it. */
+interface BufferFaceInput {
+    family: string;
+    data: ArrayBuffer;
+    weight?: number | string;
+    style?: 'normal' | 'italic';
+}
+/**
+ * Registers one document's font faces from their bytes. Each family takes its
+ * own name, as {@link loadFontFromBuffer} registers it, unless a live
+ * registration holds different bytes under that name; then all its faces take
+ * an alias, so both documents keep their own glyphs. Faces with the same bytes
+ * are registered once. With a scope, the faces are held until the scope loads
+ * its next document or is disposed; without one, for the page's lifetime.
+ * `faces` may be a promise: the scope's next document is the one whose call
+ * came last, whichever faces arrive first. Resolves to the CSS family each
+ * family was registered under, for the families with at least one face that
+ * loaded, or to an empty map once a later document or disposal replaced it.
+ *
+ * @public
+ */
+declare function registerDocumentFaces(faces: readonly BufferFaceInput[] | PromiseLike<readonly BufferFaceInput[]>, scope?: FontLoadScope): Promise<Map<string, string>>;
 /**
  * Load a font face from a URL (woff2, woff, ttf, otf).
  *
@@ -450,5 +494,14 @@ declare function extractFontsFromDocument(document: unknown): Set<string>;
  * @returns Promise resolving when fonts are loaded
  */
 declare function loadDocumentFonts(document: unknown): Promise<void>;
+/**
+ * A scope for one editor instance's font loads. Loads made through it notify
+ * its own `onFontsLoaded` / `onFontError` listeners and the module-level ones,
+ * never another scope's; module-level loads still reach every scope, so a
+ * single editor hears what it heard before. Dedupe and caches stay shared.
+ *
+ * @public
+ */
+declare function createFontLoadScope(): FontLoadScope;
 
-export { resolveShadingColor as A, setGoogleFontsEnabled as B, type FontDefinition as C, extractFontsFromDocument as D, getGoogleFontEquivalent as E, FONT_MAPPING as F, loadDocumentFonts as G, loadFontDefinitions as H, loadFontFromUrl as I, loadFontWithMapping as J, loadFontsWithMapping as K, onFontError as L, resolveColorToHex as M, type ThemeMatrixCell as T, colorsEqual as a, blendColors as b, canRenderFont as c, createRgbColor as d, createThemeColor as e, darkenColor as f, ensureHexPrefix as g, generateThemeTintShadeMatrix as h, getContrastingColor as i, getLoadedFonts as j, getThemeTintShadeHex as k, isBlack as l, isFontLoaded as m, isLoading as n, isGoogleFontsEnabled as o, isWhite as p, lightenColor as q, loadFont as r, loadFontFromBuffer as s, loadFonts as t, onFontsLoaded as u, parseColorString as v, preloadCommonFonts as w, resolveColor as x, resolveHighlightColor as y, resolveHighlightToCss as z };
+export { resolveShadingColor as A, setGoogleFontsEnabled as B, type BufferFaceInput as C, FONT_MAPPING as D, type FontDefinition as E, type FontLoadScope as F, createFontLoadScope as G, extractFontsFromDocument as H, getGoogleFontEquivalent as I, loadDocumentFonts as J, loadFontDefinitions as K, loadFontFromUrl as L, loadFontWithMapping as M, loadFontsWithMapping as N, onFontError as O, registerDocumentFaces as P, resolveColorToHex as Q, type ThemeMatrixCell as T, colorsEqual as a, blendColors as b, canRenderFont as c, createRgbColor as d, createThemeColor as e, darkenColor as f, ensureHexPrefix as g, generateThemeTintShadeMatrix as h, getContrastingColor as i, getLoadedFonts as j, getThemeTintShadeHex as k, isBlack as l, isFontLoaded as m, isLoading as n, isGoogleFontsEnabled as o, isWhite as p, lightenColor as q, loadFont as r, loadFontFromBuffer as s, loadFonts as t, onFontsLoaded as u, parseColorString as v, preloadCommonFonts as w, resolveColor as x, resolveHighlightColor as y, resolveHighlightToCss as z };

package/dist/{frameDelta-CVt5FAXT.d.mts → frameDelta-ByU7HBuB.d.mts}

@@ -31,6 +31,8 @@ interface DisplayPage {
     /** Formatted PAGE label (for example, "vii"). */
     pageLabel?: string;
     primitives: DisplayPrimitive[];
+    /** Leading primitives painted beneath the header and footer. */
+    watermarkPrimitiveCount?: number;
     /** Resolved page background. Undefined = transparent/host white. */
     background?: string;
     pageBorders?: PageBorderPrimitive[];
@@ -38,6 +40,10 @@ interface DisplayPage {
     footer?: HfRegion;
     /** Footnote/endnote regions in page coordinates. Undefined = none. */
     noteAreas?: NoteRegion[];
+    /** Geometry only: the page's content is built when the host asks for it. */
+    unbuilt?: boolean;
+    /** For an unbuilt page, the lowest and highest body position its layout places. */
+    positionSpan?: [number, number];
 }
 /** A page-local rectangle emitted as display-list metadata. */
 interface DisplayBounds {
@@ -716,12 +722,20 @@ interface FramePositionShiftRun {
     readonly changedMask: number;
     readonly delta: number;
 }
+/** A note region note's new backlink anchor; null clears the field. */
+interface FrameNoteAnchor {
+    readonly area: number;
+    readonly note: number;
+    readonly start: number | null;
+    readonly end: number | null;
+}
 interface FramePagePositionShift {
     readonly kind: 'shift-positions';
     readonly pageIndex: number;
     readonly pageId: bigint;
     readonly fingerprint: bigint;
     readonly runs: readonly FramePositionShiftRun[];
+    readonly anchors: readonly FrameNoteAnchor[];
 }
 type FramePageOperation = FramePageUpsert | FramePageRemove | FramePageMove | FramePagePositionPatch | FramePagePositionShift;
 interface DecodedFrameDelta {
@@ -780,5 +794,11 @@ declare function applyFrameDeltaOwned(previous: RetainedFrame | null, delta: Dec
  * it.
  */
 declare function displayPageRevision(page: DisplayPage): number;
+/**
+ * Counts the owned shifts that moved this page's note anchors in place, for
+ * consumers that render the anchors (the accessibility mirror) and otherwise
+ * key on page identity.
+ */
+declare function displayPageNoteAnchorRevision(page: DisplayPage): number;
 
-export { type DisplayList as D, FRAME_DELTA_HEADER_BYTES as F, type GlyphRunPrimitive as G, type HfRegion as H, type ImagePrimitive as I, type LinePrimitive as L, type PositionedGlyph as P, type RetainedFrame as R, type TextRunPrimitive as T, type DisplayPage as a, type DisplayPrimitive as b, type DecodedFrameDelta as c, type DecorationPrimitive as d, type DisplayBounds as e, type DocAttrs as f, FRAME_DELTA_PAGE_OP_BYTES as g, FRAME_DELTA_VERSION as h, FrameDeltaError as i, type FrameDeltaErrorCode as j, type FramePageOperation as k, type RectPrimitive as l, type RetainedFramePage as m, type TableCellRef as n, applyFrameDelta as o, applyFrameDeltaOwned as p, decodeFrameDelta as q, displayPageRevision as r };
+export { type DisplayList as D, FRAME_DELTA_HEADER_BYTES as F, type GlyphRunPrimitive as G, type HfRegion as H, type ImagePrimitive as I, type LinePrimitive as L, type PositionedGlyph as P, type RetainedFrame as R, type TextRunPrimitive as T, type DisplayPage as a, type DisplayPrimitive as b, type DecodedFrameDelta as c, type DecorationPrimitive as d, type DisplayBounds as e, type DocAttrs as f, FRAME_DELTA_PAGE_OP_BYTES as g, FRAME_DELTA_VERSION as h, FrameDeltaError as i, type FrameDeltaErrorCode as j, type FramePageOperation as k, type RectPrimitive as l, type RetainedFramePage as m, type TableCellRef as n, applyFrameDelta as o, applyFrameDeltaOwned as p, decodeFrameDelta as q, displayPageNoteAnchorRevision as r, displayPageRevision as s };