@docx-editor.dev/core 2.14.0 → 2.15.0

package/dist/{index-C5ZnSRkF.d.ts → index-C3Gvq4jN.d.ts}

@@ -1,254 +1,22 @@
-import { T as TreeDocOp, C as ImageDecodePort, v as DrawingPositionInput, W as DrawingTransform, F as DrawingTreeDocOp, y as SupportedImageMime } from './tree-op-types-D6HzlPR4.js';
+import { T as TreeDocOp, E as ImageDecodePort, v as DrawingPositionInput, X as DrawingTransform, F as DrawingTreeDocOp, y as SupportedImageMime } from './tree-op-types-egdarvH_.js';
 import { Unsubscribe, ExecResult, ParagraphTabStop, IndentFormatting, ParagraphFlags, ParagraphDisagreements, SelectionPin } from './contracts/types.js';
-import { g as ReviewRevisionKind } from './review-items-CCS1h93f.js';
+import { g as ReviewRevisionKind } from './review-items-DYRx187i.js';
 import { EditorModule, ReviewModuleContribution } from './contracts/modules.js';
-import { k as FontSource, l as FontSourceSubstitution, m as FontFaceRequest, F as FontConfiguration, D as DocumentSource, Z as ZoomMode, E as EditorFontError, n as Editor, b as EditorCommand, C as CanResult, S as SelectedImageState, o as FormatPainterSurfaceState, e as TrackedChangePredicate, T as TrackedChangeFilterMode, V as ViewScope, I as ImageContext, p as TableBorderEdgeTarget, q as TableBorderSpec, r as TableBorderStyle, t as TableContext } from './editor-a6VvsfYU.js';
-import { R as RevisionDisplayMode } from './revision-projection-BeXVrSSV.js';
-import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-BmQ7h2cq.js';
+import { D as DocumentSource, c as FontConfiguration, Z as ZoomMode, E as EditorFontError, n as Editor, e as EditorCommand, C as CanResult, S as SelectedImageState, o as FormatPainterSurfaceState, h as TrackedChangePredicate, T as TrackedChangeFilterMode, V as ViewScope, b as FontFaceRequest, F as FontSource, I as ImageContext, p as TableBorderEdgeTarget, q as TableBorderSpec, r as TableBorderStyle, t as TableContext } from './editor-sRxrFJd8.js';
+import { R as RevisionDisplayMode } from './revision-projection-DHRJH48u.js';
+import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-DZsDmPg5.js';
+import { e as FontConfigurationFragment, g as FontResolver } from './font-resolver-BYEHQGTw.js';
 import { EditorCollaborationSession, CollaborationRemoteSelection, CollaborationModuleContribution } from './collaboration.js';
-import { c as RevisionStyles, R as ReviewAuthorInfo, b as RevisionAuthorStyle, F as FieldShadingMode, d as DrawingPaintStrings } from './semantic-paint-WJD2KeG1.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-CDFiNXcD.js';
-import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-92UnKeU_.js';
-import { B as BookmarkIndex } from './custom-node-writes-DntmaAVW.js';
-import { I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, d as ImageIntentResult } from './tree-package-fragment-CWFjgH6a.js';
-import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-BK91NCCG.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-B2HfGt79.js';
+import { c as RevisionStyles, R as ReviewAuthorInfo, b as RevisionAuthorStyle, d as DrawingPaintStrings, F as FieldShadingMode } from './semantic-paint-f7SqN4oW.js';
+import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-DSe8igrz.js';
+import { S as SemanticLayout, C as ContentControlBoundaryRecord, T as TextMeasurer } from './semantic-records-EIdwId-a.js';
+import { B as BookmarkIndex } from './custom-node-writes-C9ArIlJh.js';
+import { I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, b as ImageIntentResult } from './tree-package-fragment-DjkH4ESI.js';
+import { C as CellSelection, S as SectionProperties } from './semantic-cell-selection-BXVWCBYm.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CGOOgPjW.js';
 import { C as CollaborationStatus } from './failure-BnGjoXf0.js';
 import './contracts/document.js';
 
-/**
- * A partial font configuration one origin contributes: sources, substitutions, or both.
- * `loadDefaultFonts()` (the substitute package) and `loadFonts()` (the fetch helper) both
- * return this shape, so every origin composes through `composeFontConfiguration` the
- * same way.
- */
-interface FontConfigurationFragment {
-    readonly sources?: readonly FontSource[];
-    readonly substitutions?: readonly FontSourceSubstitution[];
-}
-/**
- * The base of a composition: everything a `FontConfiguration` carries, all optional.
- * Omitted fields take the documented defaults (`epoch` 0, `maxFontBytes` at the engine
- * hard maximum, `defaultFont` Calibri at 11pt — Word's own default face and size).
- */
-interface FontConfigurationBase extends FontConfigurationFragment {
-    /**
-     * Identity of this configuration's byte set. The engine uses it to tell one resolved
-     * font set from another; leave it unset and the editor supplies the load sequence.
-     */
-    readonly epoch?: number;
-    /** Per-face byte ceiling. Defaults to the engine hard maximum; lower it to tighten intake. */
-    readonly maxFontBytes?: number;
-    /** The face used when a run names no font. Defaults to Word's own: Calibri at 11pt. */
-    readonly defaultFont?: FontConfiguration['defaultFont'];
-    /** BCP-47 tag passed to the shaper for language-sensitive shaping. */
-    readonly language?: string;
-}
-/**
- * What the document turned out to need, handed to an on-demand resolver.
- *
- * The families are the ones the file actually names — already name-validated and capped,
- * so a resolver may treat them as a list to look up, never as URLs or paths to build.
- */
-interface FontResolutionRequest {
-    /**
-     * Families declared anywhere in the document (body, headers/footers, styles), deduped,
-     * sorted, and capped at {@link MAX_RESOLVER_FAMILIES}.
-     */
-    readonly families: readonly string[];
-    /** The face a run naming no font resolves to, so a resolver can cover it too. */
-    readonly defaultFamily: string;
-    /**
-     * Faces an EARLIER origin in the same composition can already PAINT — either because it
-     * supplied the bytes, or because it mapped that face onto one it did supply.
-     *
-     * Absent, not empty, when there is nothing to report: the engine calling a resolver
-     * directly, and the first origin of a composition.
-     *
-     * FACES, not families, and only faces backed by bytes. Both narrowings are load-bearing.
-     * A family-grained list would let an origin holding only regular Arial suppress the bold
-     * and italic a later origin would have supplied, and a list built from substitutions
-     * alone would let an origin whose fetches all failed suppress the failover behind it,
-     * because both shipped resolvers emit their substitution map before fetching. Together
-     * they are what makes honouring this an OPTIMIZATION rather than a correctness
-     * requirement: skipping a reported face cannot lose one, so a resolver that ignores this
-     * list only spends bytes on a face first-wins composition would drop anyway.
-     *
-     * Match it case-insensitively. Word matches font names that way and both shipped
-     * resolvers do.
-     */
-    readonly resolvedFaces?: readonly FontFaceRequest[];
-}
-/**
- * Resolve fonts once the document's needs are known, instead of ahead of them.
- *
- * Called once per load, AFTER the file is parsed and mounted, with the families it
- * declares; whatever it returns composes exactly like a statically supplied fragment.
- * Returning nothing is a valid answer — it means "I cover none of this", and the
- * document stays on the fixed measurer.
- *
- * A resolver that fetches makes opening a document perform network requests. That is a
- * real change in posture and it must stay the APP's decision: the engine never supplies
- * one, and the families here are file-derived, so a resolver must look them up in a set
- * it shipped rather than interpolate them into a URL.
- */
-type FontResolver = (request: FontResolutionRequest) => FontConfiguration | FontConfigurationFragment | undefined | Promise<FontConfiguration | FontConfigurationFragment | undefined>;
-/**
- * Ceiling on the families one document can put in front of a resolver.
- *
- * A resolver typically turns each family into up to four faces, and the resource snapshot
- * refuses more than `HARD_MAX_FONT_SOURCES` (256) sources — so 64 families is the point
- * past which a document could no longer be served anyway. Capping here means a file
- * declaring thousands of distinct `w:rFonts` cannot fan a resolver out across thousands
- * of lookups (or fetches) before that limit is ever reached.
- */
-declare const MAX_RESOLVER_FAMILIES = 64;
-/** Word's document default when nothing else says otherwise: Calibri at 11pt. */
-declare const WORD_DEFAULT_FONT: FontConfiguration['defaultFont'];
-/**
- * Merge a base and any number of fragments into one frozen `FontConfiguration`.
- *
- * A bare fragment IS a valid base, so the single-origin case is one argument:
- * `composeFontConfiguration(await loadDefaultFonts())`. Pass extra fragments to layer
- * origins, and set `epoch`/`maxFontBytes`/`defaultFont` on the base only when you need
- * something other than the documented defaults.
- *
- * - Sources dedupe first-wins by (family, weight, style), in argument order — base
- *   before fragments, earlier fragments before later ones.
- * - Substitutions dedupe first-wins by their `from` face, in the same order, and every
- *   substitution whose `from` face has a direct source anywhere in the composition is
- *   dropped: a real face always beats a stand-in.
- * - The result is frozen (arrays included); the byte arrays themselves are the callers'
- *   and are not copied here — the resource snapshot takes its own defensive copy.
- */
-declare function composeFontConfiguration(base: FontConfigurationBase, ...fragments: readonly FontConfigurationFragment[]): FontConfiguration;
-
-/**
- * The namespaced key carrying the type-level half of the mark, and the runtime property
- * name that backs it.
- *
- * A plain string rather than a symbol on purpose: `@docx-editor.dev/fonts` has no runtime
- * or type dependency on the engine, so it declares the same mark itself, and two
- * `unique symbol`s in two packages would not unify. Two identical string keys do.
- *
- * @public
- */
-declare const FONT_RESOLVER_MARK_KEY = "docx-editor.dev/font-resolver";
-/**
- * The runtime marker `defineFontResolver` sets and {@link isFontResolver} reads.
- *
- * Exported because a package mirroring the font contract structurally still has to mark
- * the resolvers it builds. A package in that position sets
- * `Symbol.for('docx-editor.dev/font-resolver')` itself; this constant is the same symbol,
- * named, for everyone who can import it.
- *
- * @public
- */
-declare const FONT_RESOLVER_BRAND: unique symbol;
-/**
- * The type-level half of the mark: what {@link defineFontResolver} adds to a function's
- * type so a `FontOrigin` list can REQUIRE it.
- *
- * Declared with a string key so `@docx-editor.dev/fonts` can declare an identical
- * interface and have the two unify without importing anything from the engine. Set at
- * runtime as well as in the type — non-enumerable, so it stays out of `Object.keys` and
- * out of a host's own spread.
- *
- * @public
- */
-interface FontResolverMark {
-    /** Always `true`. Set non-enumerably by {@link defineFontResolver}. */
-    readonly 'docx-editor.dev/font-resolver': true;
-}
-/**
- * A {@link FontResolver} that has been through {@link defineFontResolver}.
- *
- * This, not bare `FontResolver`, is what a `FontOrigin` list accepts. The mark is the only
- * thing separating a resolver from a zero-argument loader, and getting that wrong loses
- * every font silently, so the type asks for it up front.
- *
- * @public
- */
-type MarkedFontResolver<T extends FontResolver = FontResolver> = T & FontResolverMark;
-/**
- * Mark a function as an on-demand {@link FontResolver}.
- *
- * Wrap every resolver you put in a `fonts` list — `useFonts(...)`, `useDocxSource`'s
- * `fonts` option, `composeFontOrigins`. The `fonts` PROP needs no marking, because a
- * function there is always a resolver; a list also accepts the older zero-argument loader
- * form (`{ fonts: defaultFonts }`), and this is what keeps the two apart.
- *
- * Returns the same function object, mutated, so the mark survives being passed around and
- * a marked resolver stays `===` to itself. It does NOT survive `.bind()` or being wrapped:
- * both make a new function object. Re-mark the result.
- *
- * ```ts
- * const brandFonts = defineFontResolver(async ({ families }) => ({
- *   sources: await loadMine(families),
- * }));
- * ```
- *
- * Throws a `TypeError` on a frozen or sealed function, which cannot take the mark. That is
- * deliberate: returning it unmarked would compile — the return TYPE says marked — and then
- * lose every font at runtime.
- *
- * @public
- */
-declare function defineFontResolver<T extends FontResolver>(resolve: T): MarkedFontResolver<T>;
-/**
- * Whether a value is a function marked by {@link defineFontResolver}.
- *
- * False for an unmarked function, which callers read as a zero-argument loader. Calling a
- * resolver that way reads `request.defaultFamily` off `undefined` and throws, so the
- * callers that make this choice say so rather than swallowing it — and the type-level mark
- * on {@link MarkedFontResolver} is there to stop it reaching runtime at all.
- *
- * @public
- */
-declare function isFontResolver(value: unknown): value is MarkedFontResolver;
-/**
- * ONE font origin, in the one shape every origin takes: a finished configuration, a
- * fragment, a promise for either, or a marked resolver that answers per document.
- *
- * The point of the union is that `packagedFonts()`, `googleFonts()`, `await defaultFonts()`
- * and a hand-built `{ sources }` are all the same kind of thing, so a list of them needs no
- * ordering rule beyond "first wins".
- *
- * The resolver arm is {@link MarkedFontResolver}, not bare `FontResolver`: a list may also
- * hold a zero-argument loader, and only the mark separates the two.
- *
- * @public
- */
-type FontOrigin = FontConfiguration | FontConfigurationFragment | MarkedFontResolver | Promise<FontConfiguration | FontConfigurationFragment | undefined> | undefined;
-/**
- * Resolve a list of {@link FontOrigin}s against one document's needs and merge them,
- * first-wins in list order.
- *
- * Origins resolve IN ORDER, one after another, and each is told which faces the ones
- * before it can already paint ({@link FontResolutionRequest.resolvedFaces}). Sequential
- * rather than a `Promise.all`, and that is a real cost — one extra origin's latency on the
- * critical path — bought deliberately: composition is first-wins, so a later origin's copy
- * of a face an earlier one supplied can never be used, and fetching it anyway spends the
- * bytes twice and tells a font host which families the document uses for a result that
- * gets thrown away. Order origins cheapest-first.
- *
- * A resolver that ignores `resolvedFaces` still composes correctly; it just spends more.
- *
- * ONE ORIGIN CANNOT SINK THE REST. An origin that throws, answers `null`, or answers
- * something malformed is reported and skipped whole, and the origins around it still
- * compose — an app that listed a flaky network origin behind a bundled one keeps the
- * bundled faces. Skipped WHOLE: an answer is read completely before any of it is
- * committed, so a half-ingested origin can never reach composition.
- *
- * The result carries NO `epoch`: it is a fragment for the engine to stamp with the load
- * sequence. A fixed epoch from here would label every document's byte set as the same one.
- * `undefined` means no origin contributed anything, which is a normal answer — the document
- * stays on the fixed measurer.
- *
- * @public
- */
-declare function composeFontOrigins(origins: readonly FontOrigin[], request: FontResolutionRequest): Promise<FontConfigurationFragment | undefined>;
-
 /**
  * A Word-faithful blank document, freshly zipped per call (the caller may hand the
  * bytes to a loader that takes ownership). Calibri 11pt and Word's Normal paragraph
@@ -675,6 +443,41 @@ interface DocxEditorInstance extends Editor {
      * author colour it will receive after commit.
      */
     getConfiguredAuthor(): string | null;
+    /**
+     * Set the author for runtime editor state.
+     *
+     * Unlike the construction-time {@link DocxEditorConfig.author}, this value applies to every
+     * later comment, reply, and tracked change. It does not rewrite existing revisions. The value
+     * survives document reloads and font remounts. An empty or whitespace value clears the author,
+     * after which suggesting refuses writes with its existing reason.
+     *
+     * @public
+     */
+    setAuthor(author: string | undefined): void;
+    /**
+     * Set the host editing mode without rebuilding the editor.
+     *
+     * This has the same meaning as {@link DocxEditorConfig.mode}. Passing `undefined` lets the
+     * document's tracking settings select the mode again. A host change clears the reader's
+     * toolbar choice, so a later document reload can adopt `w:trackRevisions` again.
+     *
+     * @public
+     */
+    setMode(mode: 'edit' | 'view' | 'suggesting' | undefined): void;
+    /**
+     * Set the drawing-label resolver without rebuilding the editor. Painted placeholders update
+     * immediately, and later surface mounts use the same resolver.
+     *
+     * @public
+     */
+    setTranslate(translate: ((key: string, params?: Record<string, string | number>) => string) | undefined): void;
+    /**
+     * Set the engine locale without rebuilding the editor. Later table-of-contents insertions use
+     * the resolved locale label. Unsupported and omitted locales resolve to English.
+     *
+     * @public
+     */
+    setLocale(locale: string | undefined): void;
     /**
      * The style declared for one author, whether or not the SURFACE has published them yet —
      * so review chrome can draw a card the rail is holding before the roster catches up.
@@ -1943,6 +1746,12 @@ interface PaginatedSurface {
      */
     editingMode(): SurfaceEditingMode;
     setEditingMode(mode: SurfaceEditingMode): void;
+    /** Set the ambient author after buffered text commits under the previous author. */
+    setAuthor(author: string | undefined): void;
+    /** Replace localized drawing labels and repaint materialized pages. */
+    setDrawingStrings(strings: DrawingPaintStrings): void;
+    /** Replace the localized title used by later TOC insertions. */
+    setTocLabels(labels: NonNullable<PaginatedSurfaceOptions['tocLabels']>): void;
     /**
      * Every author with a revision in the CURRENT layout, mapped to Word's colour slot by
      * order of first appearance. One map instance per layout, so a caller can key caches on
@@ -3388,4 +3197,4 @@ declare function runTableCommand(editor: Editor | null, command: EditorCommand):
  */
 declare function createDocxEditor(config: DocxEditorConfig): DocxEditorInstance;
 
-export { type MarkedFontResolver as $, type AnchorFrameOrigin as A, type FontLoadFailureReason as B, CHROME_GROUPS as C, type DocxEditorInstance as D, EMU_PER_POINT as E, FONT_RESOLVER_BRAND as F, type FontMeasurementState as G, type FontOrigin as H, type FontResolutionRequest as I, type FontResolver as J, type FontResolverMark as K, type FontUrlSource as L, type HyperlinkActivation as M, type HyperlinkChromeHandlers as N, type OpenPaginatedResult as O, type PaginatedSurfaceOptions as P, type HyperlinkOps as Q, IMAGE_OVERLAY_NUDGE_PT as R, IMAGE_OVERLAY_NUDGE_SHIFT_PT as S, type TableCommandPlan as T, type ImageInteractionSession as U, type ImageOverlayScrollPort as V, type ImageResizeHandle as W, type ImageResizeResult as X, type LoadFontsRequest as Y, type LoadFontsResult as Z, MAX_RESOLVER_FAMILIES as _, type PaginatedSurface as a, layoutPointsToCssPixels as a$, type OverlayFrameRect as a0, type PaginatedSurfaceState as a1, type ParagraphPropertyEdit as a2, type RemoteCaretLabelAnchor as a3, type RemoteCaretLabelHost as a4, type ReviewWriteIntent as a5, type RunTableChromeCommandResult as a6, type SectionAnchor as a7, type SectionBreakInsertType as a8, type SelectedDrawingOverlayTarget as a9, chromeMenuSlots as aA, chromeProbeForSlot as aB, chromeSlotId as aC, chromeSlotIsToggle as aD, commandForSlot as aE, commandForSlotValue as aF, commandForTableChromeSlotValue as aG, composeFontConfiguration as aH, composeFontOrigins as aI, computeImageResizeResult as aJ, computeMovedImagePosition as aK, computeResizedImageExtentEmu as aL, createDocxEditor as aM, createFontSource as aN, createImageOverlayScrollPort as aO, cssPixelsToLayoutPoints as aP, defaultChromeGroups as aQ, defaultTableLabel as aR, defineFontResolver as aS, emuToOverlayPoints as aT, equationAtPosition as aU, executeImageCommand as aV, finalizeImageOverlayInteraction as aW, formattingBarChromeGroups as aX, isFontResolver as aY, isStaleImageInteractionCommit as aZ, isTableChromeSlot as a_, type SurfaceEquation as aa, type SurfaceFormatting as ab, type SurfaceHyperlink as ac, type SurfaceInsertImageInput as ad, type SurfaceNavigation as ae, type SurfaceOverlayCoordinates as af, type SurfaceParagraphFormat as ag, TABLE_BORDER_STYLE_OPTIONS as ah, TABLE_BORDER_TARGET_OPTIONS as ai, TABLE_BORDER_WIDTH_OPTIONS as aj, TABLE_CHROME_SLOT_IDS as ak, type TableBorderStyleOption as al, type TableBorderTargetOption as am, type TableBorderTargetValue as an, type TableBorderWidthOption as ao, type TableChromeDraft as ap, type TableChromePick as aq, type TableChromeSlotId as ar, type TableInteractionLabelKey as as, type ToolbarCommandState as at, WORD_DEFAULT_FONT as au, applyTableChromePick as av, blankDocumentBytes as aw, canExecuteImageCommand as ax, captureImageMutationPreconditions as ay, chromeControlCount as az, CHROME_MENUS as b, loadFonts as b0, overlayFrameToSheetCssPixels as b1, overlayHostOrigin as b2, pointsToEmu as b3, probeTableChromeCommand as b4, resizePreservesAspect as b5, runSave as b6, runTableChromeCommand as b7, runTableCommand as b8, runToolbarCommand as b9, selectedDrawingOverlayTargetOf as ba, selectedImageStateOf as bb, surfacePaintScale as bc, tableChromeIconPaths as bd, tableChromeLabelKeyForTarget as be, tableChromeToolbarState as bf, tableChromeVisible as bg, tableCommandToolbarState as bh, toolbarCommandState as bi, toolbarCommandStates as bj, CHROME_UNAVAILABLE_KEY as c, type ChromeControl as d, type ChromeControlId as e, type ChromeControlState as f, type ChromeGroup as g, type ChromeGroupId as h, type ChromeMenu as i, type ChromeMenuEntry as j, type ChromeMenuId as k, type ChromeMenuItemEntry as l, type ChromeMenuSeparatorEntry as m, type ChromeMenuSubmenuEntry as n, type ChromeSlotId as o, DEFAULT_TABLE_CHROME_DRAFT as p, type DocxEditorConfig as q, type DrawingSelectionIntent as r, type EquationActivation as s, type EquationChromeHandlers as t, type EquationOps as u, FONT_RESOLVER_MARK_KEY as v, type FinalizedImageOverlayInteraction as w, type FontConfigurationBase as x, type FontConfigurationFragment as y, type FontLoadFailure as z };
+export { type SelectedDrawingOverlayTarget as $, type AnchorFrameOrigin as A, type HyperlinkOps as B, CHROME_GROUPS as C, type DocxEditorInstance as D, EMU_PER_POINT as E, type FinalizedImageOverlayInteraction as F, IMAGE_OVERLAY_NUDGE_SHIFT_PT as G, type HyperlinkActivation as H, IMAGE_OVERLAY_NUDGE_PT as I, type ImageInteractionSession as J, type ImageOverlayScrollPort as K, type ImageResizeHandle as L, type ImageResizeResult as M, type LoadFontsRequest as N, type OpenPaginatedResult as O, type PaginatedSurfaceOptions as P, type LoadFontsResult as Q, type OverlayFrameRect as R, type PaginatedSurfaceState as S, type TableCommandPlan as T, type ParagraphPropertyEdit as U, type RemoteCaretLabelAnchor as V, type RemoteCaretLabelHost as W, type ReviewWriteIntent as X, type RunTableChromeCommandResult as Y, type SectionAnchor as Z, type SectionBreakInsertType as _, type PaginatedSurface as a, tableChromeLabelKeyForTarget as a$, type SurfaceEquation as a0, type SurfaceFormatting as a1, type SurfaceHyperlink as a2, type SurfaceInsertImageInput as a3, type SurfaceNavigation as a4, type SurfaceOverlayCoordinates as a5, type SurfaceParagraphFormat as a6, TABLE_BORDER_STYLE_OPTIONS as a7, TABLE_BORDER_TARGET_OPTIONS as a8, TABLE_BORDER_WIDTH_OPTIONS as a9, createFontSource as aA, createImageOverlayScrollPort as aB, cssPixelsToLayoutPoints as aC, defaultChromeGroups as aD, defaultTableLabel as aE, emuToOverlayPoints as aF, equationAtPosition as aG, executeImageCommand as aH, finalizeImageOverlayInteraction as aI, formattingBarChromeGroups as aJ, isStaleImageInteractionCommit as aK, isTableChromeSlot as aL, layoutPointsToCssPixels as aM, loadFonts as aN, overlayFrameToSheetCssPixels as aO, overlayHostOrigin as aP, pointsToEmu as aQ, probeTableChromeCommand as aR, resizePreservesAspect as aS, runSave as aT, runTableChromeCommand as aU, runTableCommand as aV, runToolbarCommand as aW, selectedDrawingOverlayTargetOf as aX, selectedImageStateOf as aY, surfacePaintScale as aZ, tableChromeIconPaths as a_, TABLE_CHROME_SLOT_IDS as aa, type TableBorderStyleOption as ab, type TableBorderTargetOption as ac, type TableBorderTargetValue as ad, type TableBorderWidthOption as ae, type TableChromeDraft as af, type TableChromePick as ag, type TableChromeSlotId as ah, type TableInteractionLabelKey as ai, type ToolbarCommandState as aj, applyTableChromePick as ak, blankDocumentBytes as al, canExecuteImageCommand as am, captureImageMutationPreconditions as an, chromeControlCount as ao, chromeMenuSlots as ap, chromeProbeForSlot as aq, chromeSlotId as ar, chromeSlotIsToggle as as, commandForSlot as at, commandForSlotValue as au, commandForTableChromeSlotValue as av, computeImageResizeResult as aw, computeMovedImagePosition as ax, computeResizedImageExtentEmu as ay, createDocxEditor as az, CHROME_MENUS as b, tableChromeToolbarState as b0, tableChromeVisible as b1, tableCommandToolbarState as b2, toolbarCommandState as b3, toolbarCommandStates as b4, CHROME_UNAVAILABLE_KEY as c, type ChromeControl as d, type ChromeControlId as e, type ChromeControlState as f, type ChromeGroup as g, type ChromeGroupId as h, type ChromeMenu as i, type ChromeMenuEntry as j, type ChromeMenuId as k, type ChromeMenuItemEntry as l, type ChromeMenuSeparatorEntry as m, type ChromeMenuSubmenuEntry as n, type ChromeSlotId as o, DEFAULT_TABLE_CHROME_DRAFT as p, type DocxEditorConfig as q, type DrawingSelectionIntent as r, type EquationActivation as s, type EquationChromeHandlers as t, type EquationOps as u, type FontLoadFailure as v, type FontLoadFailureReason as w, type FontMeasurementState as x, type FontUrlSource as y, type HyperlinkChromeHandlers as z };

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var chunkF2K6SDHA_cjs=require('./chunk-F2K6SDHA.cjs');require('./chunk-ZKWRCLT2.cjs'),require('./chunk-O5M4CR4P.cjs'),require('./chunk-NDJGSR6M.cjs'),require('./chunk-2PIHW2QM.cjs'),require('./chunk-LBAHXZCU.cjs'),require('./chunk-DRQHIQ4R.cjs'),require('./chunk-5TKAPFZT.cjs'),require('./chunk-4Z5MODAE.cjs'),require('./chunk-BTQKU64Q.cjs'),require('./chunk-KIAP7PFQ.cjs'),require('./chunk-NJNFJPGB.cjs'),require('./chunk-OHJQ7GPZ.cjs');Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.Da}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.Ha}});Object.defineProperty(exports,"FONT_RESOLVER_BRAND",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.i}});Object.defineProperty(exports,"FONT_RESOLVER_MARK_KEY",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.h}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.f}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.m}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.Ia}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.qa}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.sa}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.g}});Object.defineProperty(exports,"composeFontOrigins",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.l}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.Ua}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.r}});Object.defineProperty(exports,"defineFontResolver",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.j}});Object.defineProperty(exports,"isFontResolver",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.k}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.q}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.ya}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkF2K6SDHA_cjs.ua}});
+'use strict';var chunkQRC37MWG_cjs=require('./chunk-QRC37MWG.cjs');require('./chunk-ZKWRCLT2.cjs'),require('./chunk-AS7YZNQE.cjs');var chunkHOEWFH5U_cjs=require('./chunk-HOEWFH5U.cjs');require('./chunk-AVGCKH6A.cjs'),require('./chunk-LGFKIF4M.cjs'),require('./chunk-CDYVDQRI.cjs'),require('./chunk-PMHGONET.cjs'),require('./chunk-FGBADUSK.cjs'),require('./chunk-PXKZUTHX.cjs'),require('./chunk-Q4AB7E4O.cjs'),require('./chunk-2YH4MSHX.cjs'),require('./chunk-BTQKU64Q.cjs'),require('./chunk-YL4Q5LZP.cjs'),require('./chunk-24APKZAN.cjs'),require('./chunk-OHJQ7GPZ.cjs');Object.defineProperty(exports,"CHROME_GROUPS",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.ua}});Object.defineProperty(exports,"CHROME_MENUS",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.ya}});Object.defineProperty(exports,"blankDocumentBytes",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.d}});Object.defineProperty(exports,"chromeMenuSlots",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.za}});Object.defineProperty(exports,"commandForSlot",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.ha}});Object.defineProperty(exports,"commandForSlotValue",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.ja}});Object.defineProperty(exports,"createDocxEditor",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.La}});Object.defineProperty(exports,"createFontSource",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.i}});Object.defineProperty(exports,"loadFonts",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.h}});Object.defineProperty(exports,"runToolbarCommand",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.pa}});Object.defineProperty(exports,"toolbarCommandState",{enumerable:true,get:function(){return chunkQRC37MWG_cjs.la}});Object.defineProperty(exports,"FONT_RESOLVER_BRAND",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.g}});Object.defineProperty(exports,"FONT_RESOLVER_MARK_KEY",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.f}});Object.defineProperty(exports,"WORD_DEFAULT_FONT",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.c}});Object.defineProperty(exports,"composeFontConfiguration",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.d}});Object.defineProperty(exports,"composeFontOrigins",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.j}});Object.defineProperty(exports,"defineFontResolver",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.h}});Object.defineProperty(exports,"isFontResolver",{enumerable:true,get:function(){return chunkHOEWFH5U_cjs.i}});

package/dist/index.d.ts

@@ -1,23 +1,25 @@
-export { z as DrawingHorizontalReferenceFrame, D as DrawingKind, w as DrawingLocks, v as DrawingPositionInput, A as DrawingVerticalReferenceFrame, x as ImageResourceState, u as ImageWrapTarget, P as PreservedImageMime, t as RenderableImageMime, R as RevisionAddress, y as SupportedImageMime, V as ValidatedImageBytesHandle, B as VectorImageMime } from './tree-op-types-D6HzlPR4.js';
+export { z as DrawingHorizontalReferenceFrame, D as DrawingKind, w as DrawingLocks, v as DrawingPositionInput, A as DrawingVerticalReferenceFrame, x as ImageResourceState, u as ImageWrapTarget, P as PreservedImageMime, t as RenderableImageMime, R as RevisionAddress, y as SupportedImageMime, V as ValidatedImageBytesHandle, B as VectorImageMime } from './tree-op-types-egdarvH_.js';
 export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, InsertableContentControlType, NumberingRef, PageMargins, Paragraph, ParagraphDisagreements, ParagraphFlags, ParagraphFormatCommand, ParagraphTabStop, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, SelectionPin, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './contracts/types.js';
-export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from './review-items-CCS1h93f.js';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from './review-items-DYRx187i.js';
 export { CollectReviewItems, EditorModule, ReviewModuleContribution } from './contracts/modules.js';
-export { A as AuthoredNoteNumbering, C as CanResult, u as DocumentChange, w as DocumentEditingMode, x as DocumentHandle, D as DocumentSource, n as Editor, b as EditorCommand, y as EditorCommandShape, z as EditorCommands, B as EditorError, G as EditorEvents, E as EditorFontError, H as EditorFontErrorCode, J as EditorFormatPainterCommands, K as EditorHeaderFooterCommands, L as EditorNoteCommands, M as EditorPosition, N as EditorQueries, O as EditorQuery, P as EditorQueryResults, Q as EditorScope, R as EditorSelection, a as EditorSnapshot, F as FontConfiguration, m as FontFaceRequest, k as FontSource, l as FontSourceSubstitution, U as FormatPainterLevel, W as FormatPainterMode, o as FormatPainterSurfaceState, X as FurnitureVariant, Y as HeaderFooterSlotArgs, _ as HeaderFooterState, $ as HyperlinkInfo, I as ImageContext, c as ImageCropPercent, a0 as InteractionAffinity, a1 as InteractionOutcome, a2 as InteractionOutcomeCode, a3 as NoteKind, a4 as NotePropertiesSide, a5 as NotePropertiesState, a6 as PageSetup, a7 as ResolvedNoteNumbering, a8 as ReviewActivationOptions, a9 as ReviewCommentPlacement, aa as ReviewCustomPlacement, ab as ReviewItemPlacement, ac as ReviewItemPlacementBase, ad as ReviewItemQuery, ae as ReviewRevisionPlacement, S as SelectedImageState, af as SemanticIdentity, ag as SemanticTarget, p as TableBorderEdgeTarget, q as TableBorderSpec, r as TableBorderStyle, ah as TableBorderTarget, ai as TableCellVerticalAlignment, aj as TableColumnDividerResizeTarget, ak as TableColumnOccurrenceTarget, t as TableContext, al as TableRightEdgeResizeTarget, am as TableRowOccurrenceTarget, an as TextMatch, T as TrackedChangeFilterMode, e as TrackedChangePredicate, V as ViewScope, ao as ZoomFitTarget, Z as ZoomMode } from './editor-a6VvsfYU.js';
-export { R as RevisionDisplayMode } from './revision-projection-BeXVrSSV.js';
-export { S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-BmQ7h2cq.js';
-export { C as CHROME_GROUPS, b as CHROME_MENUS, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, q as DocxEditorConfig, D as DocxEditorInstance, F as FONT_RESOLVER_BRAND, v as FONT_RESOLVER_MARK_KEY, x as FontConfigurationBase, y as FontConfigurationFragment, z as FontLoadFailure, B as FontLoadFailureReason, G as FontMeasurementState, H as FontOrigin, I as FontResolutionRequest, J as FontResolver, K as FontResolverMark, L as FontUrlSource, M as HyperlinkActivation, N as HyperlinkChromeHandlers, Y as LoadFontsRequest, Z as LoadFontsResult, $ as MarkedFontResolver, ac as SurfaceHyperlink, at as ToolbarCommandState, au as WORD_DEFAULT_FONT, aw as blankDocumentBytes, aA as chromeMenuSlots, aE as commandForSlot, aF as commandForSlotValue, aH as composeFontConfiguration, aI as composeFontOrigins, aM as createDocxEditor, aN as createFontSource, aS as defineFontResolver, aY as isFontResolver, b0 as loadFonts, b9 as runToolbarCommand, bi as toolbarCommandState } from './index-C5ZnSRkF.js';
+export { A as AuthoredNoteNumbering, C as CanResult, u as DocumentChange, w as DocumentEditingMode, x as DocumentHandle, D as DocumentSource, n as Editor, e as EditorCommand, y as EditorCommandShape, z as EditorCommands, B as EditorError, G as EditorEvents, E as EditorFontError, H as EditorFontErrorCode, J as EditorFormatPainterCommands, K as EditorHeaderFooterCommands, L as EditorNoteCommands, M as EditorPosition, N as EditorQueries, O as EditorQuery, P as EditorQueryResults, Q as EditorScope, R as EditorSelection, d as EditorSnapshot, c as FontConfiguration, b as FontFaceRequest, F as FontSource, a as FontSourceSubstitution, U as FormatPainterLevel, W as FormatPainterMode, o as FormatPainterSurfaceState, X as FurnitureVariant, Y as HeaderFooterSlotArgs, _ as HeaderFooterState, $ as HyperlinkInfo, I as ImageContext, f as ImageCropPercent, a0 as InteractionAffinity, a1 as InteractionOutcome, a2 as InteractionOutcomeCode, a3 as NoteKind, a4 as NotePropertiesSide, a5 as NotePropertiesState, a6 as PageSetup, a7 as ResolvedNoteNumbering, a8 as ReviewActivationOptions, a9 as ReviewCommentPlacement, aa as ReviewCustomPlacement, ab as ReviewItemPlacement, ac as ReviewItemPlacementBase, ad as ReviewItemQuery, ae as ReviewRevisionPlacement, S as SelectedImageState, af as SemanticIdentity, ag as SemanticTarget, p as TableBorderEdgeTarget, q as TableBorderSpec, r as TableBorderStyle, ah as TableBorderTarget, ai as TableCellVerticalAlignment, aj as TableColumnDividerResizeTarget, ak as TableColumnOccurrenceTarget, t as TableContext, al as TableRightEdgeResizeTarget, am as TableRowOccurrenceTarget, an as TextMatch, T as TrackedChangeFilterMode, h as TrackedChangePredicate, V as ViewScope, ao as ZoomFitTarget, Z as ZoomMode } from './editor-sRxrFJd8.js';
+export { R as RevisionDisplayMode } from './revision-projection-DHRJH48u.js';
+export { S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-DZsDmPg5.js';
+export { C as ComposeFontOriginsOptions, b as FONT_RESOLVER_BRAND, c as FONT_RESOLVER_MARK_KEY, d as FontConfigurationBase, e as FontConfigurationFragment, a as FontOrigin, F as FontOriginFailure, f as FontResolutionRequest, g as FontResolver, h as FontResolverMark, i as MarkedFontResolver, W as WORD_DEFAULT_FONT, j as composeFontConfiguration, k as composeFontOrigins, l as defineFontResolver, m as isFontResolver } from './font-resolver-BYEHQGTw.js';
+export { C as CHROME_GROUPS, b as CHROME_MENUS, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, q as DocxEditorConfig, D as DocxEditorInstance, v as FontLoadFailure, w as FontLoadFailureReason, x as FontMeasurementState, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, N as LoadFontsRequest, Q as LoadFontsResult, a2 as SurfaceHyperlink, aj as ToolbarCommandState, al as blankDocumentBytes, ap as chromeMenuSlots, at as commandForSlot, au as commandForSlotValue, az as createDocxEditor, aA as createFontSource, aN as loadFonts, aW as runToolbarCommand, b3 as toolbarCommandState } from './index-C3Gvq4jN.js';
 export { ApplyResult, ContentControlSummary, DocEdit, DocEdits, DocQueries, DocQuery, DocQueryResults, ParagraphSummary } from './contracts/document.js';
 import './collaboration.js';
-import './tree-package-fragment-CWFjgH6a.js';
-import './tree-store-APgWx6qn.js';
+import './tree-package-fragment-DjkH4ESI.js';
+import './hf-references-DTrHkktY.js';
+import './tree-store-DKJB0IcA.js';
 import './collaboration/replication.js';
 import './failure-BnGjoXf0.js';
-import './semantic-records-92UnKeU_.js';
-import './omml-equation-BY49UOIF.js';
-import './semantic-paint-WJD2KeG1.js';
-import './note-properties-CDFiNXcD.js';
-import './custom-node-writes-DntmaAVW.js';
-import './semantic-cell-selection-BK91NCCG.js';
-import './tree-session-contract-B2HfGt79.js';
-import './document-properties-D6Ahr8D6.js';
+import './semantic-records-EIdwId-a.js';
+import './omml-equation-BpRmfDAf.js';
+import './semantic-paint-f7SqN4oW.js';
+import './note-properties-DSe8igrz.js';
+import './custom-node-writes-C9ArIlJh.js';
+import './semantic-cell-selection-BXVWCBYm.js';
+import './tree-session-contract-CGOOgPjW.js';
+import './headless-document-view-DELC4E5v.js';
 import 'prosemirror-model';

package/dist/index.js

@@ -1 +1 @@
-export{Da as CHROME_GROUPS,Ha as CHROME_MENUS,i as FONT_RESOLVER_BRAND,h as FONT_RESOLVER_MARK_KEY,f as WORD_DEFAULT_FONT,m as blankDocumentBytes,Ia as chromeMenuSlots,qa as commandForSlot,sa as commandForSlotValue,g as composeFontConfiguration,l as composeFontOrigins,Ua as createDocxEditor,r as createFontSource,j as defineFontResolver,k as isFontResolver,q as loadFonts,ya as runToolbarCommand,ua as toolbarCommandState}from'./chunk-KTAQ7BRQ.js';import'./chunk-D5EHDHYV.js';import'./chunk-VQ4R5LTU.js';import'./chunk-UKUOZXUD.js';import'./chunk-RIYSCEFQ.js';import'./chunk-2QTY5S6T.js';import'./chunk-MCDUQYWP.js';import'./chunk-MQP26KCF.js';import'./chunk-ZVTW7RGD.js';import'./chunk-FBA57EUJ.js';import'./chunk-6JIJOZDW.js';import'./chunk-OKEDGR65.js';import'./chunk-ZBEJHJN2.js';import'./chunk-GOEBQ26R.js';
+export{ua as CHROME_GROUPS,ya as CHROME_MENUS,d as blankDocumentBytes,za as chromeMenuSlots,ha as commandForSlot,ja as commandForSlotValue,La as createDocxEditor,i as createFontSource,h as loadFonts,pa as runToolbarCommand,la as toolbarCommandState}from'./chunk-SB54HLFJ.js';import'./chunk-D5EHDHYV.js';import'./chunk-XCESLTJL.js';export{g as FONT_RESOLVER_BRAND,f as FONT_RESOLVER_MARK_KEY,c as WORD_DEFAULT_FONT,d as composeFontConfiguration,j as composeFontOrigins,h as defineFontResolver,i as isFontResolver}from'./chunk-MNUKSXRO.js';import'./chunk-RJSB6RJ7.js';import'./chunk-RIYSCEFQ.js';import'./chunk-5Y7AADI6.js';import'./chunk-Z4527AXR.js';import'./chunk-M52QXFKI.js';import'./chunk-VP7SDFCM.js';import'./chunk-PBOIGBDO.js';import'./chunk-QJYH6AYD.js';import'./chunk-KFELX7CN.js';import'./chunk-6JIJOZDW.js';import'./chunk-KXPVOPR5.js';import'./chunk-AREFLNUP.js';import'./chunk-GOEBQ26R.js';

package/dist/{shaped-measurer-CFPnXFs9.d.cts → layout-shaping-DoGR5cf8.d.ts}

@@ -1,4 +1,4 @@
-import { F as FontResourceSnapshot, b as TextShaper, V as VersionedShapingLibrary, N as NormalizationPolicy, c as FixedPointRoundingMode, R as ResolvedRunStyle, d as ResolvedFont, T as TextMeasurer } from './semantic-records-BpozY7-j.cjs';
+import { d as ShapingEnvironmentInput, e as TextShaper, R as ResolvedRunStyle, f as ResolvedFont, T as TextMeasurer, F as FontResourceSnapshot, V as VersionedShapingLibrary, N as NormalizationPolicy, g as FixedPointRoundingMode, h as FontRequest } from './semantic-records-EIdwId-a.js';
 
 /** Immutable per-operation environment. Configuration, extension, shaping, and producer changes are
  * coarse gates; resource changes are compared through CacheProvenance.resourceDependencies. */
@@ -104,6 +104,9 @@ declare class ResolvedCache<V> {
     get size(): number;
 }
 
+/** Fingerprinted, operation-wide portion of every shaping call. @public */
+type LayoutShapingEnvironment = Omit<ShapingEnvironmentInput, 'font' | 'direction' | 'fallbackOrder'>;
+
 /**
  * A fully resolved shaping bundle: fonts, shaper, and the environment they were admitted
  * under. Produced by the editor lane's font configuration (`createLayoutShaping`) and
@@ -117,16 +120,7 @@ interface LayoutShapingOptions {
         readonly family: string;
         readonly sizeHalfPoints: number;
     };
-    readonly environment: {
-        readonly variationAxes: Readonly<Record<string, number>>;
-        readonly shapingLibrary: VersionedShapingLibrary;
-        readonly unicodeDataVersion: string;
-        readonly normalization: NormalizationPolicy;
-        readonly language: string;
-        readonly features: Readonly<Record<string, number>>;
-        readonly fixedPointScale: number;
-        readonly roundingMode: FixedPointRoundingMode;
-    };
+    readonly environment: LayoutShapingEnvironment;
     readonly ligatureCaretPolicy: 'cluster-edges-only';
     readonly operation: OperationSnapshot;
 }
@@ -155,6 +149,21 @@ interface ShapedMeasurerOptions {
     /** ISO 15924 script and BCP 47 language for shaping. Latin/English by default. */
     readonly script?: string;
     readonly language?: string;
+    /** Optional low-level shaping controls; omitted values preserve the released defaults. */
+    readonly normalization?: NormalizationPolicy;
+    readonly features?: Readonly<Record<string, number>>;
+    readonly roundingMode?: FixedPointRoundingMode;
+}
+/** Environment-bound production options that cannot drift from layout cache identity. @public */
+interface LayoutEnvironmentShapedMeasurerOptions {
+    /** Shaper from the same admitted layout operation. */
+    readonly shaper: TextShaper;
+    /** Resolve a run to an admitted face, or null to use the bounded fallback. */
+    readonly resolveFont: (style: ResolvedRunStyle) => ResolvedFont | null;
+    /** Bounded measurement fallback when no admitted face resolves. */
+    readonly fallback: TextMeasurer;
+    /** Fingerprinted shaping environment; all geometry-affecting controls come from here. */
+    readonly environment: LayoutShapingOptions['environment'];
 }
 /**
  * A {@link TextMeasurer} that measures through the shaper rather than through a canvas.
@@ -164,5 +173,70 @@ interface ShapedMeasurerOptions {
  * throwing, because a document naming a font nobody has must still lay out.
  */
 declare function createShapedMeasurer(options: ShapedMeasurerOptions): TextMeasurer;
+declare function createShapedMeasurer(options: LayoutEnvironmentShapedMeasurerOptions): TextMeasurer;
+/**
+ * Bind measurement directly to the environment whose operation identity keys layout caches.
+ * Production browser/server hosts use this adapter so fingerprinted and executed shaping cannot
+ * drift through independently forwarded fields.
+ * @public
+ */
+declare function createLayoutShapedMeasurer(shaping: LayoutShapingOptions, options: Pick<ShapedMeasurerOptions, 'resolveFont' | 'fallback'>): TextMeasurer;
+
+/** Byte-backed face accepted by neutral shaping. @public */
+interface LayoutFontSource {
+    readonly request: FontRequest;
+    readonly id: string;
+    readonly bytes: Uint8Array;
+    readonly hash: string;
+    readonly faceIndex: number;
+    readonly availability?: 'available' | 'forbidden';
+}
+/** Explicit face substitution accepted by neutral shaping. @public */
+interface LayoutFontSubstitution {
+    readonly from: FontRequest;
+    readonly to: FontRequest;
+    readonly lineMetrics?: {
+        readonly heightEm: number;
+        readonly baselineEm: number;
+    };
+}
+/** Structural font configuration shared by browser and server hosts. @public */
+interface LayoutFontConfiguration {
+    readonly epoch: number;
+    readonly maxFontBytes: number;
+    readonly sources: readonly LayoutFontSource[];
+    readonly substitutions?: readonly LayoutFontSubstitution[];
+    readonly defaultFont: {
+        readonly family: string;
+        readonly sizeHalfPoints: number;
+    };
+    readonly language?: string;
+}
+/** Optional measurements for resource-budget tests and host diagnostics. @public */
+interface LayoutShapingInstrumentation {
+    readonly onFontByteCopy?: () => void;
+    readonly onFontHash?: () => void;
+    readonly onFontAdmission?: () => void;
+}
+/** Invalid host configuration caught before any bytes reach HarfBuzz. @public */
+declare class LayoutShapingConfigurationError extends Error {
+    readonly code: "overLimit";
+    constructor(message: string);
+}
+declare const PREPARED_LAYOUT_FONT_CONFIGURATION_BRAND: unique symbol;
+/** Opaque owned configuration shared by cache identity and font admission. @public */
+interface PreparedLayoutFontConfiguration {
+    readonly [PREPARED_LAYOUT_FONT_CONFIGURATION_BRAND]: true;
+    /** Stable identity of the exact owned bytes and every layout-affecting font option. */
+    readonly fingerprint: string;
+}
+/** Copy and hash each usable face once for shared cache identity and admission. @public */
+declare function prepareLayoutFontConfiguration(configuration: LayoutFontConfiguration, instrumentation?: LayoutShapingInstrumentation): PreparedLayoutFontConfiguration;
+/** Stable identity for every layout-affecting font configuration input. @public */
+declare function layoutFontConfigurationFingerprint(configuration: LayoutFontConfiguration): string;
+/** Build one shaped-layout environment without importing an editor or DOM lane. @public */
+declare function createLayoutShaping(configuration: LayoutFontConfiguration | PreparedLayoutFontConfiguration, instrumentation?: LayoutShapingInstrumentation): Promise<LayoutShapingOptions>;
+/** Release native resources held by a shaping environment. @public */
+declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
 
-export { type CacheLookup as C, type LayoutShapingOptions as L, type OperationSnapshot as O, ResolvedCache as R, type ShapedMeasurerOptions as S, type CacheMiss as a, type CacheProvenance as b, type OperationSnapshotField as c, type OperationSnapshotGuard as d, type ResourceDependencyProvenance as e, captureOperationSnapshot as f, createShapedMeasurer as g, guardOperationSnapshot as h };
+export { type CacheLookup as C, type LayoutShapingInstrumentation as L, type OperationSnapshot as O, type PreparedLayoutFontConfiguration as P, ResolvedCache as R, type ShapedMeasurerOptions as S, type LayoutShapingOptions as a, type CacheMiss as b, type CacheProvenance as c, disposeLayoutShaping as d, type LayoutEnvironmentShapedMeasurerOptions as e, type LayoutFontConfiguration as f, type LayoutFontSource as g, type LayoutFontSubstitution as h, LayoutShapingConfigurationError as i, type LayoutShapingEnvironment as j, type OperationSnapshotField as k, type OperationSnapshotGuard as l, type ResourceDependencyProvenance as m, captureOperationSnapshot as n, createLayoutShapedMeasurer as o, createLayoutShaping as p, createShapedMeasurer as q, guardOperationSnapshot as r, layoutFontConfigurationFingerprint as s, prepareLayoutFontConfiguration as t };