@embedpdf/web 3.0.0-next.12 → 3.0.0-next.13

package/dist/index.d.cts

@@ -616,5 +616,237 @@ interface IndexedDbByteStoreOptions {
 /** Open (creating on first use) one IndexedDB object store keyed by id. */
 declare function indexedDbByteStore(dbName: string, opts?: IndexedDbByteStoreOptions): ByteStore;
 //#endregion
-export { type ActionsUiAdapterShape, type ActionsUiEffectContext, type ActionsUiOrigin, type AnchorTarget, type AnchoredPlacement, type AnchoredPoint, type AnchoredPosition, type AnchoredRect, type AttachSelectionHandleOptions, type ByteStore, type ClipboardSelectionSource, type DefaultActionsUiAdapterOptions, type IndexedDbByteStoreOptions, type ObjectUrlImageSource, type PaintedImageCallbacks, type PickFileOptions, type SelectionClipboardOptions, type SelectionHandleSession, type StageGestureHost, type StageGestureOptions, type StageGestureSink, type StagePointerKind, type StageSurfaceHost, type StageSurfaceHub, type StageSurfaceOptions, type StageSurfaceSample, type StageWheelSample, type SvgCursorOptions, type ViewProjector, type WebPlatformFeedback, type WheelSample, attachSelectionHandle, bindPaintedImage, computeReleaseVelocity, copySelection, createDefaultActionsUiAdapter, createStageGestureController, createStageSurface, indexedDbByteStore, observeClientGeometry, pickFile, pickImageFile, positionAnchoredRect, projectAnchoredTarget, sanitizeExternalUri, saveFile, svgCursor, vibrationFeedback, wheelZoomFactor, wireSelectionClipboard, wkFeedback };
+//#region src/rich-text-editor.d.ts
+/**
+ * Rich text editor binding — the ONE contentEditable mechanics module for a
+ * FreeText annotation, shared by every framework adapter (React, Angular,
+ * Vue, Svelte…) so editing can never drift between them:
+ *
+ *   • render a rich document (runs of style deltas over a body) into the
+ *     element as paragraphs of inline-styled spans
+ *   • serialise the element back into runs on `input` — inline styles only,
+ *     never computed styles, so the editor cannot invent properties
+ *   • map the DOM selection to flat offsets over the plain projection (and
+ *     back), and keep the caret through a model-driven re-render
+ *   • hold re-renders during IME composition, paste as plain text, forward
+ *     Cmd/Ctrl+B/I/U as commands
+ *
+ * The browser owns typing; this module only translates. The POLICY — what a
+ * command does to the document, when to commit, what a family maps to —
+ * belongs to the host (the annotation plugin), reached through the
+ * structural {@link RichTextEditorHost}: @embedpdf/web imports no plugin,
+ * per the layering law. The return shape is a Svelte action; the other
+ * frameworks call the same two functions from their effects.
+ *
+ * Offsets: positions in the plain projection — paragraphs joined by `\r`,
+ * runs concatenated, a hard break inside a run is a `\r` too. The same
+ * arithmetic the core's run algebra uses.
+ *
+ * Known limits (by design, recorded in the plan): the browser's native undo
+ * stack does not span a host-driven restyle; DOM line wrapping approximates
+ * the engine's layout, the appearance stream is the truth.
+ */
+type RichTextEditorDecoration = 'underline' | 'line-through' | 'word';
+type RichTextEditorScript = 'normal' | 'sub' | 'super';
+type RichTextEditorAlign = 'left' | 'center' | 'right' | 'justify';
+/** A run's style delta — the engine's `RichTextRunStyle`, structurally. */
+interface RichTextEditorStyle {
+  family?: string;
+  weight?: number;
+  italic?: boolean;
+  size?: number;
+  color?: string;
+  decoration?: RichTextEditorDecoration[];
+  script?: RichTextEditorScript;
+  letterSpacing?: number;
+  horizontalScale?: number;
+  unknown?: string;
+}
+interface RichTextEditorRun {
+  text: string;
+  style?: RichTextEditorStyle;
+}
+interface RichTextEditorParagraph {
+  align?: RichTextEditorAlign;
+  dir?: 'ltr' | 'rtl';
+  runs: RichTextEditorRun[];
+}
+/** The document the editor renders and produces (the engine's input shape). */
+interface RichTextEditorDocument {
+  paragraphs: RichTextEditorParagraph[];
+}
+interface RichTextEditorRange {
+  start: number;
+  end: number;
+}
+type RichTextEditorCommand = 'bold' | 'italic' | 'underline';
+/** What the binding needs from the plugin — structural, no plugin import. */
+interface RichTextEditorHost {
+  /** The element's content changed by typing: here is the serialised document. */
+  onInput(doc: RichTextEditorDocument): void;
+  /** The selection inside the editor moved (null: the editor has none). */
+  onSelectionChange(range: RichTextEditorRange | null): void;
+  /** A keyboard command the host applies to the current selection. */
+  onCommand(command: RichTextEditorCommand): void;
+  /** The CSS family list for a PDF family ("Helvetica" → a web stack, a
+   *  registered family → itself, mounted as a @font-face). */
+  cssFontFamily(family: string): string;
+}
+interface RichTextEditorProps {
+  document: RichTextEditorDocument;
+  /** Screen px per content unit (the page scale): sizes are content points. */
+  scale: number;
+}
+interface RichTextEditorBinding {
+  update(props: RichTextEditorProps): void;
+  /** The current selection as flat offsets, or null when not in the editor. */
+  selection(): RichTextEditorRange | null;
+  /** Place the selection (after the host restyled the document). */
+  select(range: RichTextEditorRange): void;
+  detach(): void;
+}
+interface EditorStyle {
+  marginTop?: string;
+  lineHeight?: string;
+  fontWeight: string;
+  fontStyle: string;
+  textDecoration: string;
+  textDecorationLine?: string;
+  color: string;
+  fontSize: string;
+  fontFamily: string;
+  verticalAlign: string;
+  letterSpacing: string;
+  textAlign: string;
+  direction: string;
+}
+interface EditorNode {
+  nodeType: number;
+  nodeName: string;
+  nodeValue?: string | null;
+  childNodes: ArrayLike<EditorNode>;
+  parentNode?: EditorNode | null;
+  style?: EditorStyle;
+}
+interface EditorElement extends EditorNode {
+  style: EditorStyle;
+  appendChild(node: EditorNode): unknown;
+}
+interface EditorDocumentFactory {
+  createElement(tag: string): EditorElement;
+  createTextNode(text: string): EditorNode;
+}
+interface EditorRoot extends EditorNode {
+  ownerDocument: EditorDocumentFactory | null;
+  appendChild(node: EditorNode): unknown;
+  replaceChildren?(...nodes: EditorNode[]): void;
+  removeChild?(node: EditorNode): unknown;
+  firstChild?: EditorNode | null;
+}
+/** The inline style declarations a span carries, as a style delta. Only what
+ *  the span itself sets: an unset property means "inherit", never a value. */
+declare function styleDeltaOf(style: EditorStyle | undefined, scale: number): RichTextEditorStyle;
+/** Render a document into the element: one block per paragraph, one span per
+ *  styled run, `<br>` for a hard break, a placeholder `<br>` at the end of a
+ *  block that is empty or ends on a break so the caret has a home. */
+declare function renderRichText(root: EditorRoot, doc: RichTextEditorDocument, options: {
+  scale: number;
+  cssFontFamily: (family: string) => string;
+}): void;
+/** Keep the baseline adjustment on the first block after Enter clones it. */
+declare function applyFirstLineShift(root: EditorNode, shift: number | undefined): void;
+/** The element's content as a document. Inline styles (and the semantic
+ *  b/i/u/sub/sup tags a browser may insert) only. */
+declare function serializeRichText(root: EditorNode, scale: number): RichTextEditorDocument;
+interface EditorPosition {
+  node: EditorNode;
+  offset: number;
+}
+/** The flat offset of a DOM position (a node and an offset within it). */
+declare function offsetOfPosition(root: EditorNode, position: EditorPosition): number;
+/** The DOM position of a flat offset: inside a text node when one covers it,
+ *  else the empty block / the slot after a hard break the offset names. */
+declare function positionOfOffset(root: EditorNode, offset: number): EditorPosition | null;
+/** Bind one contentEditable element. Returns the Svelte-action-shaped handle. */
+declare function attachRichTextEditor(el: HTMLElement, host: RichTextEditorHost, initial: RichTextEditorProps): RichTextEditorBinding;
+//#endregion
+//#region src/web-font.d.ts
+/**
+ * Mount a registered font for the DOM: the engine lays text out with the
+ * font's bytes, the browser needs the same face as a `@font-face` so the
+ * live editor and the vector renderer show the glyphs the appearance stream
+ * will bake. The family name is the font's KEY — the CSS family the
+ * annotation plugin emits for a registered font (`cssFontFamily`) — so
+ * mounting under the key is what makes the two agree.
+ *
+ * Returns the unmount. Idempotent per (document, key): a second mount of a
+ * key already in the document's font set is a no-op that still returns an
+ * unmount of its own (the face leaves when the LAST holder unmounts).
+ */
+declare function mountWebFont(key: string, data: ArrayBuffer | Uint8Array, options?: {
+  document?: Document;
+  weight?: number | string;
+  style?: 'normal' | 'italic';
+}): Promise<() => void>;
+//#endregion
+//#region src/web-font-metrics.d.ts
+/**
+ * Acrobat's line model, stated in CSS — private to the rich text binding.
+ *
+ * The engine lays a line out the way Acrobat does: the line box is the
+ * face's ascent + descent (its `hhea` metrics) + a constant 0.2 × size of
+ * leading, with the baseline at the ascent and the leading entirely below.
+ * The standard 14 carry no font program, so the engine uses the metrics of
+ * Acrobat's bundled substitutes (Helvetica 0.83/0.17, Times 0.784/0.216,
+ * Courier 0.627/0.373); any other face — a registered font, an embedded
+ * one — uses its own `hhea` table.
+ *
+ * Canvas provides browser metrics, which can be rounded or differ from the
+ * font program's metrics. They approximate the registered font's line model;
+ * standard families use the engine's known values below. CSS still chooses
+ * wrapping and combines mixed runs differently from the engine.
+ *
+ * One thing CSS cannot express: it centres a line's leading (half above the
+ * glyphs), and the substitute face's ascent differs from the engine's, so
+ * the first baseline can land lower by the half-leading plus that ascent
+ * gap. The binding compensates using the body's face and size; mixed runs
+ * remain approximate.
+ */
+interface WebFontMetrics {
+  /** Ascent above the baseline, per em. */
+  ascent: number;
+  /** Descent below the baseline, per em. */
+  descent: number;
+}
+/** A face's approximate CSS line model. */
+interface LineModel {
+  ascent: number;
+  descent: number;
+  /** Unitless CSS line height: ascent + descent + Acrobat's 0.2 leading. */
+  lineHeight: number;
+}
+/**
+ * The browser's own ascent and descent for a CSS family list, per em,
+ * measured through a canvas. `null` when the platform cannot measure
+ * (no canvas, no `fontBoundingBoxAscent`). Reads the currently resolved face
+ * on every call, including while the intended font is loading.
+ */
+declare function webFontMetrics(cssFamily: string, doc?: Document | undefined, face?: {
+  weight?: number | string;
+  style?: string;
+}): WebFontMetrics | null;
+/**
+ * The standard families' engine metrics, or a browser approximation for
+ * other families. `measure` is injectable for tests and resolved face styles.
+ */
+declare function lineModelFor(cssFamily: string, measure?: (cssFamily: string) => WebFontMetrics | null): LineModel;
+/**
+ * Screen px to raise a box's first line by so its baseline matches the
+ * engine's: CSS puts half the leading above the glyphs and draws them with
+ * the browser's face, whose ascent differs from the engine's for the
+ * standard families. `fontSize` in screen px.
+ */
+declare function firstLineShiftFor(cssFamily: string, fontSize: number, measure?: (cssFamily: string) => WebFontMetrics | null): number;
+//#endregion
+export { type ActionsUiAdapterShape, type ActionsUiEffectContext, type ActionsUiOrigin, type AnchorTarget, type AnchoredPlacement, type AnchoredPoint, type AnchoredPosition, type AnchoredRect, type AttachSelectionHandleOptions, type ByteStore, type ClipboardSelectionSource, type DefaultActionsUiAdapterOptions, type EditorDocumentFactory, type EditorElement, type EditorNode, type EditorPosition, type EditorRoot, type EditorStyle, type IndexedDbByteStoreOptions, type LineModel, type ObjectUrlImageSource, type PaintedImageCallbacks, type PickFileOptions, type RichTextEditorAlign, type RichTextEditorBinding, type RichTextEditorCommand, type RichTextEditorDecoration, type RichTextEditorDocument, type RichTextEditorHost, type RichTextEditorParagraph, type RichTextEditorProps, type RichTextEditorRange, type RichTextEditorRun, type RichTextEditorScript, type RichTextEditorStyle, type SelectionClipboardOptions, type SelectionHandleSession, type StageGestureHost, type StageGestureOptions, type StageGestureSink, type StagePointerKind, type StageSurfaceHost, type StageSurfaceHub, type StageSurfaceOptions, type StageSurfaceSample, type StageWheelSample, type SvgCursorOptions, type ViewProjector, type WebFontMetrics, type WebPlatformFeedback, type WheelSample, applyFirstLineShift, attachRichTextEditor, attachSelectionHandle, bindPaintedImage, computeReleaseVelocity, copySelection, createDefaultActionsUiAdapter, createStageGestureController, createStageSurface, firstLineShiftFor, indexedDbByteStore, lineModelFor, mountWebFont, observeClientGeometry, offsetOfPosition, pickFile, pickImageFile, positionAnchoredRect, positionOfOffset, projectAnchoredTarget, renderRichText, sanitizeExternalUri, saveFile, serializeRichText, styleDeltaOf, svgCursor, vibrationFeedback, webFontMetrics, wheelZoomFactor, wireSelectionClipboard, wkFeedback };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -616,5 +616,237 @@ interface IndexedDbByteStoreOptions {
 /** Open (creating on first use) one IndexedDB object store keyed by id. */
 declare function indexedDbByteStore(dbName: string, opts?: IndexedDbByteStoreOptions): ByteStore;
 //#endregion
-export { type ActionsUiAdapterShape, type ActionsUiEffectContext, type ActionsUiOrigin, type AnchorTarget, type AnchoredPlacement, type AnchoredPoint, type AnchoredPosition, type AnchoredRect, type AttachSelectionHandleOptions, type ByteStore, type ClipboardSelectionSource, type DefaultActionsUiAdapterOptions, type IndexedDbByteStoreOptions, type ObjectUrlImageSource, type PaintedImageCallbacks, type PickFileOptions, type SelectionClipboardOptions, type SelectionHandleSession, type StageGestureHost, type StageGestureOptions, type StageGestureSink, type StagePointerKind, type StageSurfaceHost, type StageSurfaceHub, type StageSurfaceOptions, type StageSurfaceSample, type StageWheelSample, type SvgCursorOptions, type ViewProjector, type WebPlatformFeedback, type WheelSample, attachSelectionHandle, bindPaintedImage, computeReleaseVelocity, copySelection, createDefaultActionsUiAdapter, createStageGestureController, createStageSurface, indexedDbByteStore, observeClientGeometry, pickFile, pickImageFile, positionAnchoredRect, projectAnchoredTarget, sanitizeExternalUri, saveFile, svgCursor, vibrationFeedback, wheelZoomFactor, wireSelectionClipboard, wkFeedback };
+//#region src/rich-text-editor.d.ts
+/**
+ * Rich text editor binding — the ONE contentEditable mechanics module for a
+ * FreeText annotation, shared by every framework adapter (React, Angular,
+ * Vue, Svelte…) so editing can never drift between them:
+ *
+ *   • render a rich document (runs of style deltas over a body) into the
+ *     element as paragraphs of inline-styled spans
+ *   • serialise the element back into runs on `input` — inline styles only,
+ *     never computed styles, so the editor cannot invent properties
+ *   • map the DOM selection to flat offsets over the plain projection (and
+ *     back), and keep the caret through a model-driven re-render
+ *   • hold re-renders during IME composition, paste as plain text, forward
+ *     Cmd/Ctrl+B/I/U as commands
+ *
+ * The browser owns typing; this module only translates. The POLICY — what a
+ * command does to the document, when to commit, what a family maps to —
+ * belongs to the host (the annotation plugin), reached through the
+ * structural {@link RichTextEditorHost}: @embedpdf/web imports no plugin,
+ * per the layering law. The return shape is a Svelte action; the other
+ * frameworks call the same two functions from their effects.
+ *
+ * Offsets: positions in the plain projection — paragraphs joined by `\r`,
+ * runs concatenated, a hard break inside a run is a `\r` too. The same
+ * arithmetic the core's run algebra uses.
+ *
+ * Known limits (by design, recorded in the plan): the browser's native undo
+ * stack does not span a host-driven restyle; DOM line wrapping approximates
+ * the engine's layout, the appearance stream is the truth.
+ */
+type RichTextEditorDecoration = 'underline' | 'line-through' | 'word';
+type RichTextEditorScript = 'normal' | 'sub' | 'super';
+type RichTextEditorAlign = 'left' | 'center' | 'right' | 'justify';
+/** A run's style delta — the engine's `RichTextRunStyle`, structurally. */
+interface RichTextEditorStyle {
+  family?: string;
+  weight?: number;
+  italic?: boolean;
+  size?: number;
+  color?: string;
+  decoration?: RichTextEditorDecoration[];
+  script?: RichTextEditorScript;
+  letterSpacing?: number;
+  horizontalScale?: number;
+  unknown?: string;
+}
+interface RichTextEditorRun {
+  text: string;
+  style?: RichTextEditorStyle;
+}
+interface RichTextEditorParagraph {
+  align?: RichTextEditorAlign;
+  dir?: 'ltr' | 'rtl';
+  runs: RichTextEditorRun[];
+}
+/** The document the editor renders and produces (the engine's input shape). */
+interface RichTextEditorDocument {
+  paragraphs: RichTextEditorParagraph[];
+}
+interface RichTextEditorRange {
+  start: number;
+  end: number;
+}
+type RichTextEditorCommand = 'bold' | 'italic' | 'underline';
+/** What the binding needs from the plugin — structural, no plugin import. */
+interface RichTextEditorHost {
+  /** The element's content changed by typing: here is the serialised document. */
+  onInput(doc: RichTextEditorDocument): void;
+  /** The selection inside the editor moved (null: the editor has none). */
+  onSelectionChange(range: RichTextEditorRange | null): void;
+  /** A keyboard command the host applies to the current selection. */
+  onCommand(command: RichTextEditorCommand): void;
+  /** The CSS family list for a PDF family ("Helvetica" → a web stack, a
+   *  registered family → itself, mounted as a @font-face). */
+  cssFontFamily(family: string): string;
+}
+interface RichTextEditorProps {
+  document: RichTextEditorDocument;
+  /** Screen px per content unit (the page scale): sizes are content points. */
+  scale: number;
+}
+interface RichTextEditorBinding {
+  update(props: RichTextEditorProps): void;
+  /** The current selection as flat offsets, or null when not in the editor. */
+  selection(): RichTextEditorRange | null;
+  /** Place the selection (after the host restyled the document). */
+  select(range: RichTextEditorRange): void;
+  detach(): void;
+}
+interface EditorStyle {
+  marginTop?: string;
+  lineHeight?: string;
+  fontWeight: string;
+  fontStyle: string;
+  textDecoration: string;
+  textDecorationLine?: string;
+  color: string;
+  fontSize: string;
+  fontFamily: string;
+  verticalAlign: string;
+  letterSpacing: string;
+  textAlign: string;
+  direction: string;
+}
+interface EditorNode {
+  nodeType: number;
+  nodeName: string;
+  nodeValue?: string | null;
+  childNodes: ArrayLike<EditorNode>;
+  parentNode?: EditorNode | null;
+  style?: EditorStyle;
+}
+interface EditorElement extends EditorNode {
+  style: EditorStyle;
+  appendChild(node: EditorNode): unknown;
+}
+interface EditorDocumentFactory {
+  createElement(tag: string): EditorElement;
+  createTextNode(text: string): EditorNode;
+}
+interface EditorRoot extends EditorNode {
+  ownerDocument: EditorDocumentFactory | null;
+  appendChild(node: EditorNode): unknown;
+  replaceChildren?(...nodes: EditorNode[]): void;
+  removeChild?(node: EditorNode): unknown;
+  firstChild?: EditorNode | null;
+}
+/** The inline style declarations a span carries, as a style delta. Only what
+ *  the span itself sets: an unset property means "inherit", never a value. */
+declare function styleDeltaOf(style: EditorStyle | undefined, scale: number): RichTextEditorStyle;
+/** Render a document into the element: one block per paragraph, one span per
+ *  styled run, `<br>` for a hard break, a placeholder `<br>` at the end of a
+ *  block that is empty or ends on a break so the caret has a home. */
+declare function renderRichText(root: EditorRoot, doc: RichTextEditorDocument, options: {
+  scale: number;
+  cssFontFamily: (family: string) => string;
+}): void;
+/** Keep the baseline adjustment on the first block after Enter clones it. */
+declare function applyFirstLineShift(root: EditorNode, shift: number | undefined): void;
+/** The element's content as a document. Inline styles (and the semantic
+ *  b/i/u/sub/sup tags a browser may insert) only. */
+declare function serializeRichText(root: EditorNode, scale: number): RichTextEditorDocument;
+interface EditorPosition {
+  node: EditorNode;
+  offset: number;
+}
+/** The flat offset of a DOM position (a node and an offset within it). */
+declare function offsetOfPosition(root: EditorNode, position: EditorPosition): number;
+/** The DOM position of a flat offset: inside a text node when one covers it,
+ *  else the empty block / the slot after a hard break the offset names. */
+declare function positionOfOffset(root: EditorNode, offset: number): EditorPosition | null;
+/** Bind one contentEditable element. Returns the Svelte-action-shaped handle. */
+declare function attachRichTextEditor(el: HTMLElement, host: RichTextEditorHost, initial: RichTextEditorProps): RichTextEditorBinding;
+//#endregion
+//#region src/web-font.d.ts
+/**
+ * Mount a registered font for the DOM: the engine lays text out with the
+ * font's bytes, the browser needs the same face as a `@font-face` so the
+ * live editor and the vector renderer show the glyphs the appearance stream
+ * will bake. The family name is the font's KEY — the CSS family the
+ * annotation plugin emits for a registered font (`cssFontFamily`) — so
+ * mounting under the key is what makes the two agree.
+ *
+ * Returns the unmount. Idempotent per (document, key): a second mount of a
+ * key already in the document's font set is a no-op that still returns an
+ * unmount of its own (the face leaves when the LAST holder unmounts).
+ */
+declare function mountWebFont(key: string, data: ArrayBuffer | Uint8Array, options?: {
+  document?: Document;
+  weight?: number | string;
+  style?: 'normal' | 'italic';
+}): Promise<() => void>;
+//#endregion
+//#region src/web-font-metrics.d.ts
+/**
+ * Acrobat's line model, stated in CSS — private to the rich text binding.
+ *
+ * The engine lays a line out the way Acrobat does: the line box is the
+ * face's ascent + descent (its `hhea` metrics) + a constant 0.2 × size of
+ * leading, with the baseline at the ascent and the leading entirely below.
+ * The standard 14 carry no font program, so the engine uses the metrics of
+ * Acrobat's bundled substitutes (Helvetica 0.83/0.17, Times 0.784/0.216,
+ * Courier 0.627/0.373); any other face — a registered font, an embedded
+ * one — uses its own `hhea` table.
+ *
+ * Canvas provides browser metrics, which can be rounded or differ from the
+ * font program's metrics. They approximate the registered font's line model;
+ * standard families use the engine's known values below. CSS still chooses
+ * wrapping and combines mixed runs differently from the engine.
+ *
+ * One thing CSS cannot express: it centres a line's leading (half above the
+ * glyphs), and the substitute face's ascent differs from the engine's, so
+ * the first baseline can land lower by the half-leading plus that ascent
+ * gap. The binding compensates using the body's face and size; mixed runs
+ * remain approximate.
+ */
+interface WebFontMetrics {
+  /** Ascent above the baseline, per em. */
+  ascent: number;
+  /** Descent below the baseline, per em. */
+  descent: number;
+}
+/** A face's approximate CSS line model. */
+interface LineModel {
+  ascent: number;
+  descent: number;
+  /** Unitless CSS line height: ascent + descent + Acrobat's 0.2 leading. */
+  lineHeight: number;
+}
+/**
+ * The browser's own ascent and descent for a CSS family list, per em,
+ * measured through a canvas. `null` when the platform cannot measure
+ * (no canvas, no `fontBoundingBoxAscent`). Reads the currently resolved face
+ * on every call, including while the intended font is loading.
+ */
+declare function webFontMetrics(cssFamily: string, doc?: Document | undefined, face?: {
+  weight?: number | string;
+  style?: string;
+}): WebFontMetrics | null;
+/**
+ * The standard families' engine metrics, or a browser approximation for
+ * other families. `measure` is injectable for tests and resolved face styles.
+ */
+declare function lineModelFor(cssFamily: string, measure?: (cssFamily: string) => WebFontMetrics | null): LineModel;
+/**
+ * Screen px to raise a box's first line by so its baseline matches the
+ * engine's: CSS puts half the leading above the glyphs and draws them with
+ * the browser's face, whose ascent differs from the engine's for the
+ * standard families. `fontSize` in screen px.
+ */
+declare function firstLineShiftFor(cssFamily: string, fontSize: number, measure?: (cssFamily: string) => WebFontMetrics | null): number;
+//#endregion
+export { type ActionsUiAdapterShape, type ActionsUiEffectContext, type ActionsUiOrigin, type AnchorTarget, type AnchoredPlacement, type AnchoredPoint, type AnchoredPosition, type AnchoredRect, type AttachSelectionHandleOptions, type ByteStore, type ClipboardSelectionSource, type DefaultActionsUiAdapterOptions, type EditorDocumentFactory, type EditorElement, type EditorNode, type EditorPosition, type EditorRoot, type EditorStyle, type IndexedDbByteStoreOptions, type LineModel, type ObjectUrlImageSource, type PaintedImageCallbacks, type PickFileOptions, type RichTextEditorAlign, type RichTextEditorBinding, type RichTextEditorCommand, type RichTextEditorDecoration, type RichTextEditorDocument, type RichTextEditorHost, type RichTextEditorParagraph, type RichTextEditorProps, type RichTextEditorRange, type RichTextEditorRun, type RichTextEditorScript, type RichTextEditorStyle, type SelectionClipboardOptions, type SelectionHandleSession, type StageGestureHost, type StageGestureOptions, type StageGestureSink, type StagePointerKind, type StageSurfaceHost, type StageSurfaceHub, type StageSurfaceOptions, type StageSurfaceSample, type StageWheelSample, type SvgCursorOptions, type ViewProjector, type WebFontMetrics, type WebPlatformFeedback, type WheelSample, applyFirstLineShift, attachRichTextEditor, attachSelectionHandle, bindPaintedImage, computeReleaseVelocity, copySelection, createDefaultActionsUiAdapter, createStageGestureController, createStageSurface, firstLineShiftFor, indexedDbByteStore, lineModelFor, mountWebFont, observeClientGeometry, offsetOfPosition, pickFile, pickImageFile, positionAnchoredRect, positionOfOffset, projectAnchoredTarget, renderRichText, sanitizeExternalUri, saveFile, serializeRichText, styleDeltaOf, svgCursor, vibrationFeedback, webFontMetrics, wheelZoomFactor, wireSelectionClipboard, wkFeedback };
 //# sourceMappingURL=index.d.ts.map