@betteroffice/docx 0.0.1 → 0.0.3

package/dist/{rustDisplayList-dqunvwxH.d.mts → frameDelta-D965X8yK.d.mts}

@@ -1,7 +1,5 @@
-import { a as Layout } from './types-DNrYr6yQ.mjs';
-import { M as MeasuredBlock } from './measuredBlock-DZwz8zhD.mjs';
-import { Z as DrawingScene, b0 as ShapeTextBodyProperties } from './content-sSHuWw49.mjs';
-import { x as TextModernEffects } from './formatting-DoL7KBSL.mjs';
+import { D as DrawingScene, d as ShapeTextBodyProperties } from './content-MOZ6hKP4.mjs';
+import { T as TextModernEffects } from './formatting-D1EPSaJP.mjs';
 
 interface DisplayList {
     /** Contract version. Undefined reads as legacy version 0. */
@@ -764,273 +762,4 @@ declare function applyFrameDelta(previous: RetainedFrame | null, delta: DecodedF
  */
 declare function applyFrameDeltaOwned(previous: RetainedFrame | null, delta: DecodedFrameDelta): RetainedFrame;
 
-/**
- * JS seam to the Rust display-list builder (crates/docx-layout).
- *
- * Marshals the same `{ measured, options, layout }` triple the golden
- * fixtures pin (see scripts/export-displaylist-fixtures.ts) across the wasm
- * boundary and parses the resulting DisplayList. All paint/geometry decisions
- * happen in Rust — this module is serialization glue only.
- *
- * The wasm module is loaded lazily via dynamic import on first build, so the
- * ~800KB inlined binary costs nothing until the experimental canvas renderer
- * is actually enabled.
- *
- * @experimental part of the rust-canvas-engine change; shape may evolve.
- */
-
-/**
- * One header/footer part in the `headersFooters` envelope field: the measured
- * blocks of the HF ProseMirror doc identified by `rId`, plus the band metrics
- * `convertHeaderFooterPmDocToContent` computed (passed through verbatim — the
- * Rust builder re-derives nothing).
- */
-interface DisplayListHfVariant {
-    rId: string;
-    kind: 'header' | 'footer';
-    type: 'default' | 'first' | 'even';
-    /** `toMeasuredBlocks(content.blocks, content.measures)` — same schema as body `measured` */
-    measured: MeasuredBlock[];
-    /** HeaderFooterContent.height (in-flow stack incl. floating blocks) */
-    height: number;
-    /** HeaderFooterContent.flowHeight (in-flow band height; fallback: height) */
-    flowHeight?: number;
-    visualTop?: number;
-    visualBottom?: number;
-    /**
-     * Per-page resolved widths of PAGE/NUMPAGES field runs in this HF part, so a
-     * centered/right-aligned line carrying such a field re-centers per page. The
-     * line width is measured ONCE at the field's fallback text ("1"), so without
-     * this the builder holds the same centered position on every page even though
-     * "Page 2 of 3"/"Page 10 of 12" have different widths. Omitted ⇒ the fields
-     * ride the char-distributed fallback width (byte-identical to before).
-     */
-    fieldWidths?: DisplayListFieldWidths[];
-}
-/**
- * Per-page widths of one PAGE/NUMPAGES field run in an HF part. `pmStart` is the
- * field run's position in the HF ProseMirror doc (the key the Rust builder
- * matches). `fallbackWidth` is the width the measure baked into `line.width`
- * (the field's fallback text); `perPage[i]` is the width of the field's resolved
- * text on layout page index `i` (PAGE → that page's number, NUMPAGES → total).
- */
-interface DisplayListFieldWidths {
-    pmStart: number;
-    fallbackWidth: number;
-    perPage: number[];
-}
-/**
- * Optional header/footer payload of the builder envelope. Absent ⇒ the Rust
- * output is byte-identical to the body-only build. Flags come off the section
- * properties / settings the DOM painter uses; distances are the same px the
- * painter resolves (`headerDistance ?? page.margins.header ?? 48`).
- */
-interface DisplayListHeadersFooters {
-    titlePg?: boolean;
-    evenAndOddHeaders?: boolean;
-    headerDistance?: number;
-    footerDistance?: number;
-    /** Page-level Word watermark, painted behind body/header/footer content. */
-    watermark?: DisplayListWatermark;
-    variants: DisplayListHfVariant[];
-    /** Stable section identity. Undefined = document-global legacy envelope. */
-    sectionId?: string;
-    /** Zero-based section index. */
-    sectionIndex?: number;
-}
-type DisplayListWatermark = DisplayListTextWatermark | DisplayListPictureWatermark;
-interface DisplayListTextWatermark {
-    kind: 'text';
-    text: string;
-    font: string;
-    color: string;
-    semitransparent: boolean;
-    layout: 'diagonal' | 'horizontal';
-    fontSize?: number;
-    /** Undefined defaults to true for watermarks. */
-    decorative?: boolean;
-}
-interface DisplayListPictureWatermark {
-    kind: 'picture';
-    relId?: string;
-    dataUrl?: string;
-    scale: number;
-    washout: boolean;
-    widthEmu?: number;
-    heightEmu?: number;
-    /** Undefined defaults to true for watermarks. */
-    decorative?: boolean;
-}
-/** One measured note in a page/section note area. */
-interface DisplayListNoteItem {
-    kind?: 'footnote' | 'endnote';
-    id?: number;
-    displayLabel?: string;
-    measured?: MeasuredBlock[];
-    height?: number;
-    anchorDocStart?: number;
-    anchorDocEnd?: number;
-    customMarkFollows?: boolean;
-}
-/** Typed non-fragmented note-region input for the Rust display builder. */
-interface DisplayListNoteArea {
-    pageIndex?: number;
-    sectionId?: string;
-    kind?: 'footnote' | 'endnote';
-    placement?: 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
-    y?: number;
-    height?: number;
-    columns?: number;
-    separator?: DisplayListNoteItem;
-    notes?: DisplayListNoteItem[];
-}
-/** Stable reviewer palette entry for comments/revisions. */
-interface DisplayListCommentAuthor {
-    id?: string;
-    name?: string;
-    paletteIndex?: number;
-    color?: string;
-}
-/** One reply of a comment thread (a11y announcement input). */
-interface DisplayListCommentReply {
-    id?: number;
-    authorId?: string;
-    authorName?: string;
-    date?: string;
-    /** Plain-text body (the builder caps it before it reaches primitives). */
-    text?: string;
-}
-/**
- * Per-comment thread metadata keyed by comment id, joined by the builder onto
- * every primitive carrying that id in `commentIds` so the a11y mirror can
- * announce the complete thread (author name, date, body, replies). All string
- * values are file-derived/attacker-controlled; consumers must only ever
- * assign them via textContent/setAttribute.
- */
-interface DisplayListCommentThread {
-    /** Comment id — matches the numeric ids in `resolvedCommentIds`/`commentIds`. */
-    id?: number;
-    authorId?: string;
-    authorName?: string;
-    date?: string;
-    /** Plain-text body (builder-capped before emission). */
-    text?: string;
-    /** Replies in thread order (builder-capped count and text). */
-    replies?: DisplayListCommentReply[];
-}
-/** The `{ measured, options, layout }` envelope the Rust builder consumes. */
-interface DisplayListBuildInputs {
-    /** Serialization contract version. Undefined reads as legacy version 0. */
-    contractVersion?: number;
-    measured: MeasuredBlock[];
-    options: unknown;
-    layout: Layout;
-    /** header/footer parts + section flags; omitted ⇒ body-only display list */
-    headersFooters?: DisplayListHeadersFooters;
-    /**
-     * Doc-wide font-id chains keyed `"<family lowercase>|<bold 0|1>|<italic 0|1>"`
-     * → measurement `FontStore` ids — the SAME map the measurement input carries.
-     * Present only under Rust measurement (the ids must belong to a populated
-     * store); its presence against that store is what gates GlyphRun emission.
-     * Omitted ⇒ every text run takes the browser-measured `TextRunPrimitive` path
-     * (byte-identical to the pre-glyph build).
-     */
-    fontChains?: Record<string, number[]>;
-    /** Page/section note regions. Undefined = no note emission. */
-    noteAreas?: DisplayListNoteArea[];
-    /** Resolved comments suppressed from active tint. Undefined = none known. */
-    resolvedCommentIds?: number[];
-    /** Stable reviewer palette. Undefined = legacy hard-coded colors. */
-    commentAuthors?: DisplayListCommentAuthor[];
-    /** Per-comment thread metadata for a11y announcements. Undefined = none. */
-    commentThreads?: DisplayListCommentThread[];
-}
-/** Minimal engine surface, injectable so tests can fake the wasm module. */
-interface RustDisplayListEngine {
-    buildDisplayListJson(input: string): string;
-    /** Resident editing engines expose binary deltas; the stateless layout wasm does not. */
-    buildDisplayListFrame?(input: string, expectedFrameEpoch: number): Uint8Array;
-    /** One-owner ordinary input path; available on the resident editing engine. */
-    applyInput?(text: string, expectedFrameEpoch: number): Uint8Array;
-    displayHitTestRegionsJson?(pageIndex: number, x: number, y: number): string;
-    displayRangeRectsJson?(from: number, to: number): string;
-    displayRangeRectsRegionJson?(region: 'body' | 'header' | 'footer', rId: string, from: number, to: number): string;
-}
-type RustDisplayListSourceErrorStage = 'load' | 'build' | 'parse' | 'decode' | 'apply';
-interface RustDisplayFrameResult {
-    displayList: DisplayList;
-    /** Null only on the compatibility JSON engine path. */
-    frame: RetainedFrame | null;
-    transport: 'frame-delta-v1' | 'json';
-}
-/**
- * Typed terminal error from the mandatory Rust display-list source. Hosts may
- * surface this through their editor error boundary; it is never permission to
- * silently substitute painter geometry.
- */
-declare class RustDisplayListSourceError extends Error {
-    readonly stage: RustDisplayListSourceErrorStage;
-    constructor(stage: RustDisplayListSourceErrorStage, cause: unknown);
-}
-/**
- * Query surface over an already-built display list, injectable so tests can
- * fake the wasm module.
- *
- * The `*Json` calls take the display-list JSON string as an argument (the Rust
- * side re-parses it per query — callers should cache the string). The
- * session-handle members parse the list ONCE (`openDisplayList` → handle) and
- * answer many queries by handle with no re-serialization, reusing the same
- * hit/range logic so results are byte-identical. The handle members are
- * OPTIONAL: the embedded wasm carries them only after the integrator re-embeds,
- * so `createDisplayListQueries` feature-detects `hasDisplayListSession` and
- * falls back to the `*Json` path when they are absent.
- */
-interface RustDisplayListQueryEngine {
-    /** region-aware hit test → `{"region","rId"?,"pos"}` or `"null"` JSON */
-    hitTestRegionsJson(displayList: string, pageIndex: number, x: number, y: number): string;
-    /** body PM range → JSON array of `{pageIndex,x,y,width,height}` rects */
-    rangeRectsJson(displayList: string, from: number, to: number): string;
-    /**
-     * Region-aware PM range → JSON array of rects. `region` is
-     * `'body' | 'header' | 'footer'`; `rId` scopes header/footer to one HF part
-     * (empty for body / match-any). OPTIONAL: the embedded wasm carries it only
-     * after the integrator re-embeds, so `createDisplayListQueries` falls back to
-     * `[]` when absent (HF selection geometry stays a documented gap until then).
-     */
-    rangeRectsRegionJson?(displayList: string, region: string, rId: string, from: number, to: number): string;
-    /** true when the embedded wasm carries the region-aware range-rect exports */
-    hasRangeRectsRegion?(): boolean;
-    /** true when the embedded wasm carries the session-handle exports below */
-    hasDisplayListSession?(): boolean;
-    /** parse a display list once, return a handle for the by-handle queries */
-    openDisplayList?(displayList: string): number;
-    /** free a handle's parsed display list */
-    closeDisplayList?(handle: number): void;
-    /** region-aware hit test against a stored display list (by handle) */
-    hitTestRegionsByHandle?(handle: number, pageIndex: number, x: number, y: number): string;
-    /** body PM range against a stored display list (by handle) */
-    rangeRectsByHandle?(handle: number, from: number, to: number): string;
-    /** region-aware PM range against a stored display list (by handle) */
-    rangeRectsRegionByHandle?(handle: number, region: string, rId: string, from: number, to: number): string;
-}
-/**
- * Lazily load the wasm query surface (hit-test + range-rects). Shares the
- * module promise with `buildRustDisplayList`, so on the canvas-renderer path
- * the engine is already resolved by the time the first display list lands.
- */
-declare function loadRustDisplayListQueryEngine(): Promise<RustDisplayListQueryEngine>;
-/** Display-only fields sent to an engine that already retains pagination. */
-declare function encodeDisplayListFrameExtras(inputs: DisplayListBuildInputs): string;
-/**
- * Build a DisplayList for a computed layout through the Rust engine. Throws
- * when the wasm module fails to load or the builder rejects the input — the
- * caller is expected to fall back to the DOM painter.
- */
-declare function buildRustDisplayList(inputs: DisplayListBuildInputs, engine?: RustDisplayListEngine): Promise<DisplayList>;
-/**
- * Production display build. Resident editing engines return FrameDelta v1;
- * older/stateless engines retain the full-JSON parity path.
- */
-declare function buildRustDisplayFrame(inputs: DisplayListBuildInputs, engine?: RustDisplayListEngine, previous?: RetainedFrame | null): Promise<RustDisplayFrameResult>;
-
-export { applyFrameDeltaOwned as A, buildRustDisplayFrame as B, buildRustDisplayList as C, type DisplayList as D, decodeFrameDelta as E, FRAME_DELTA_HEADER_BYTES as F, type GlyphRunPrimitive as G, type HfRegion as H, type ImagePrimitive as I, encodeDisplayListFrameExtras as J, loadRustDisplayListQueryEngine as K, type LinePrimitive as L, type PositionedGlyph as P, type RustDisplayListQueryEngine as R, type TextRunPrimitive as T, type DisplayListHeadersFooters as a, type DisplayPage as b, type DisplayPrimitive as c, type DecodedFrameDelta as d, type DecorationPrimitive as e, type DisplayBounds as f, type DisplayListBuildInputs as g, type DisplayListHfVariant as h, type DisplayListPictureWatermark as i, type DisplayListTextWatermark as j, type DisplayListWatermark as k, type DocAttrs as l, FRAME_DELTA_PAGE_OP_BYTES as m, FRAME_DELTA_VERSION as n, FrameDeltaError as o, type FrameDeltaErrorCode as p, type FramePageOperation as q, type RectPrimitive as r, type RetainedFrame as s, type RetainedFramePage as t, type RustDisplayFrameResult as u, type RustDisplayListEngine as v, RustDisplayListSourceError as w, type RustDisplayListSourceErrorStage as x, type TableCellRef as y, applyFrameDelta as z };
+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 };