@docx-editor.dev/core 0.0.1-placeholder → 2.0.1

package/dist/editor.d.cts

@@ -0,0 +1,271 @@
+import { F as FontConfiguration, E as EditorFontError, a as EditorCommand, C as CanResult } from './editor-D0UDock4.cjs';
+export { I as ImageContext, b as ImageCropPercent, c as ImageCropPermille, S as SelectedImageState, d as cropPercentFromCropPermille, e as cropPercentFromPermille, f as cropPercentFromSourceCrop, g as cropPermilleFromCropPercent, h as cropPermilleFromPercent, s as sourceCropFromCropPercent, v as validateImageCropPercent } from './editor-D0UDock4.cjs';
+import { L as LayoutShapingOptions } from './shaped-measurer-CNIT_svZ.cjs';
+import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-CrW-IxXt.cjs';
+export { A as AnchorFrameOrigin, C as CHROME_GROUPS, b as CHROME_MENUS, c as CHROME_UNAVAILABLE_KEY, d as ChromeControl, e as ChromeControlId, f as ChromeControlState, g as ChromeGroup, h as ChromeGroupId, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, p as DEFAULT_TABLE_CHROME_DRAFT, q as DocxEditorConfig, E as EMU_PER_POINT, F as FinalizedImageOverlayInteraction, r as FontConfigurationBase, s as FontConfigurationFragment, t as FontLoadFailure, u as FontLoadFailureReason, v as FontMeasurementState, w as FontResolutionRequest, x as FontResolver, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, B as HyperlinkOps, I as IMAGE_OVERLAY_NUDGE_PT, G as IMAGE_OVERLAY_NUDGE_SHIFT_PT, J as ImageInteractionSession, K as ImageOverlayScrollPort, L as ImageResizeHandle, M as ImageResizeResult, N as LoadFontsRequest, Q as LoadFontsResult, R as MAX_RESOLVER_FAMILIES, S as OverlayFrameRect, U as PaginatedSurfaceState, V as RunTableChromeCommandResult, W as SelectedDrawingOverlayTarget, X as SurfaceFormatting, Y as SurfaceHyperlink, Z as SurfaceNavigation, _ as SurfaceOverlayCoordinates, $ as TABLE_BORDER_STYLE_OPTIONS, a0 as TABLE_BORDER_TARGET_OPTIONS, a1 as TABLE_BORDER_WIDTH_OPTIONS, a2 as TABLE_CHROME_SLOT_IDS, a3 as TableBorderStyleOption, a4 as TableBorderTargetOption, a5 as TableBorderTargetValue, a6 as TableBorderWidthOption, a7 as TableChromeDraft, a8 as TableChromePick, a9 as TableChromeSlotId, aa as TableInteractionLabelKey, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ad as applyTableChromePick, ae as blankDocumentBytes, af as canExecuteImageCommand, ag as captureImageMutationPreconditions, ah as chromeControlCount, ai as chromeMenuSlots, aj as chromeProbeForSlot, ak as chromeSlotId, al as commandForSlot, am as commandForSlotValue, an as commandForTableChromeSlotValue, ao as composeFontConfiguration, ap as computeImageResizeResult, aq as computeMovedImagePosition, ar as computeResizedImageExtentEmu, as as createDocxEditor, at as createFontSource, au as createImageOverlayScrollPort, av as cssPixelsToLayoutPoints, aw as defaultChromeGroups, ax as defaultTableLabel, ay as emuToOverlayPoints, az as executeImageCommand, aA as finalizeImageOverlayInteraction, aB as formattingBarChromeGroups, aC as isStaleImageInteractionCommit, aD as isTableChromeSlot, aE as layoutPointsToCssPixels, aF as loadFonts, aG as overlayFrameToSheetCssPixels, aH as pointsToEmu, aI as probeTableChromeCommand, aJ as resizePreservesAspect, aK as runSave, aL as runTableChromeCommand, aM as runTableCommand, aN as runToolbarCommand, aO as selectedDrawingOverlayTargetOf, aP as selectedImageStateOf, aQ as surfacePaintScale, aR as tableChromeIconPaths, aS as tableChromeLabelKeyForTarget, aT as tableChromeToolbarState, aU as tableChromeVisible, aV as tableCommandToolbarState, aW as toolbarCommandState, aX as toolbarCommandStates } from './index-CrW-IxXt.cjs';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-CAkOBBGE.cjs';
+export { CollectReviewItems, EditorModule, EditorModuleRegistry, ReviewModuleContribution, resolveEditorModules } from './contracts/modules.cjs';
+import { ColorValue } from './contracts/types.cjs';
+import { h as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-DMiW6nIH.cjs';
+export { i as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-DMiW6nIH.cjs';
+import { f as DocumentThemeColorEntry } from './tree-session-D47_imvR.cjs';
+import { S as SemanticLayout } from './semantic-records-CJR3BvHs.cjs';
+export { T as TextMeasurer } from './semantic-records-CJR3BvHs.cjs';
+export { D as DEFAULT_IMAGE_RESOURCE_LIMITS, b as ImageDecodePort, c as ImageResourceLimits, R as RenderableImageMime, S as SupportedImageMime, a as VectorImageMime, r as resolveImageResourceLimits, d as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './image-resources-BpIydXtU.cjs';
+export { S as SectionProperties } from './semantic-cell-selection-CZjBSmMv.cjs';
+export { R as ReviewModelInput } from './review-support-DS8DYX2a.cjs';
+export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-D-Dszxrn.cjs';
+import './contracts/document.cjs';
+import './revision-projection-72ZApe-g.cjs';
+import './ooxml-tree-BU0e3DVi.cjs';
+import './note-properties-CnmCoory.cjs';
+import './ooxml-package-CR5us6ad.cjs';
+import './tree-package-store-DOKMtCnh.cjs';
+import './hf-references-CgEOSw3i.cjs';
+import './note-nodes-C6DLxlvj.cjs';
+import './tree-store-CxifqwIv.cjs';
+import './semantic-paint-drawings-D7qbB0E2.cjs';
+import 'prosemirror-model';
+
+interface LayoutShapingInstrumentation {
+    readonly onFontByteCopy?: () => void;
+    readonly onFontHash?: () => void;
+    readonly onFontAdmission?: () => void;
+}
+/**
+ * Normalize anything thrown during font work into an {@link EditorFontError}.
+ *
+ * One error type reaches consumers whether the failure came from resolution, admission or
+ * shaping, so a host branches on `code` rather than on which layer happened to throw.
+ */
+declare function toEditorFontError(error: unknown): EditorFontError;
+/** Adapt the published byte-source contract to the private deterministic layout snapshot. */
+declare function createLayoutShaping(configuration: FontConfiguration, instrumentation?: LayoutShapingInstrumentation): Promise<LayoutShapingOptions>;
+/**
+ * Release a shaping environment's native resources.
+ *
+ * The shaper holds WASM memory that garbage collection cannot reclaim on its own, so a host that
+ * builds shaping options must dispose them when the editor goes away. Safe on a shaper that has
+ * no `dispose`.
+ */
+declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
+
+/** The engine paints at 96 px per inch (twips / 15, 1440 twips per inch). */
+declare const PX_PER_INCH = 96;
+/** Painted pixels per centimetre, derived from {@link PX_PER_INCH}. */
+declare const PX_PER_CM: number;
+/** Which measurement system the ruler shows. Drives both tick cadence and drag snapping. */
+type RulerUnit = 'inch' | 'cm';
+/** One tick on the ruler: where it sits, how tall it is, and its label if it carries one. */
+interface RulerTick {
+    /** Offset along the ruler in content pixels. */
+    readonly position: number;
+    readonly height: number;
+    /** Whole-unit label, omitted at the origin and on minor ticks. */
+    readonly label?: string;
+}
+/**
+ * Ticks across one page dimension, matching the legacy cadence: eighth-inch
+ * minors with labelled inches, or millimetre minors with labelled centimetres.
+ */
+declare function generateRulerTicks(lengthPx: number, unit: RulerUnit): RulerTick[];
+/** The first page's box, which the rulers measure against. */
+declare function rulerPageBox(pages: readonly {
+    readonly index: number;
+    readonly box: {
+        width: number;
+        height: number;
+    };
+}[]): {
+    width: number;
+    height: number;
+} | null;
+
+/** Twips per inch, as OOXML defines them. */
+declare const TWIPS_PER_INCH = 1440;
+/** Twips per centimetre, as Word rounds them. */
+declare const TWIPS_PER_CM = 567;
+/** Word snaps ruler drags to the eighth-inch grid its ticks already draw. */
+declare const SNAP_TWIPS_INCH: number;
+/** The centimetre ruler's grid is the millimetre. */
+declare const SNAP_TWIPS_CM: number;
+
+/**
+ * The four handles Word's ruler carries.
+ *
+ * `hanging` and `left` sit at the SAME position and differ only in what a drag takes with
+ * them — the box moves the whole paragraph, the triangle leaves the first line where it is.
+ */
+type RulerIndentHandle = 'firstLine' | 'hanging' | 'left' | 'right';
+/** A paragraph's indent as the ruler works with it. Twips; `firstLine` signed. */
+interface RulerIndent {
+    readonly left: number;
+    readonly right: number;
+    readonly firstLine: number;
+}
+/** The page the handles are placed against. Twips. */
+interface RulerPageMetrics {
+    readonly pageWidth: number;
+    readonly leftMargin: number;
+    readonly rightMargin: number;
+}
+/**
+ * How a ruler drag resolves: which grid it snaps to, and whether it snaps at all.
+ *
+ * @public
+ */
+interface RulerDragOptions {
+    /** Which snap grid applies. Defaults to inches. */
+    readonly unit?: RulerUnit;
+    /** Alt held: continuous, twip-precision drag, bypassing the snap grid — as in Word. */
+    readonly precise?: boolean;
+}
+/** Where a handle sits, in twips from the page's LEFT SHEET EDGE (not the margin). */
+declare function handlePosition(handle: RulerIndentHandle, indent: RulerIndent, page: RulerPageMetrics): number;
+/** Round to the ruler's grid, or to the twip when the drag is precise. */
+declare function snapTwips(value: number, unit: RulerUnit, precise: boolean): number;
+/**
+ * The indent a drag of `handle` to `positionTwips` produces.
+ *
+ * Clamps differ from the MARGIN drags this ruler also carries, and deliberately:
+ *
+ * - Indents may go NEGATIVE, pulling text into the margin, which Word allows. The floor is
+ *   the sheet edge, not the margin.
+ * - There is no minimum text width. The 720-twip floor the margin drags use mirrors an
+ *   engine refusal that does not exist for indents, and enforcing one here would make a
+ *   narrow pull-quote unreachable. Left and right markers may MEET; they may not cross.
+ * - The left box needs a first-line clamp of its own. It does not move `firstLine`, so on a
+ *   hanging paragraph dragging the box left can push the first-line marker off the sheet
+ *   while the box itself is still in range. The drag stops when the LEADING marker lands.
+ */
+declare function dragIndent(handle: RulerIndentHandle, positionTwips: number, indent: RulerIndent, page: RulerPageMetrics, options?: RulerDragOptions): RulerIndent;
+
+/**
+ * Mount a paginated surface over DOCX bytes.
+ *
+ * Returns a typed rejection rather than throwing: a failure here is a property of the file,
+ * and a host must be able to tell "not a package" from "no body" without parsing an error
+ * message.
+ */
+declare function mountPaginatedSurface(container: HTMLElement, bytes: Uint8Array, options?: PaginatedSurfaceOptions): OpenPaginatedResult;
+
+/** Planner-backed can/plan pair — production gate for table commands. Task 9 maps chrome slots. */
+declare function tableCommandState(command: EditorCommand, surface: PaginatedSurface): {
+    readonly can: CanResult;
+    readonly plan: TableCommandPlan;
+};
+
+/**
+ * What a browser host can do.
+ *
+ * `selection`, `scrolling` and `layout` are true because a mounted editor genuinely has a
+ * caret, a scroll container and paginated layout — a consumer may branch on them. The
+ * DOCUMENT operations behave identically to the headless host regardless; the extra
+ * capabilities widen what may be asked later, never what an existing operation means.
+ */
+declare const BROWSER_AUTOMATION_CAPABILITIES: AutomationCapabilities;
+/**
+ * An automation host over a live editor.
+ *
+ * The editor keeps its own lifetime: `dispose()` on the returned host releases the change
+ * subscription this adapter took and leaves the editor mounted and editable.
+ */
+declare function createBrowserAutomationHost(editor: DocxEditorInstance): AutomationHost;
+
+/** Clamp and validate an OOXML theme modifier fraction (0, 1]. */
+declare function validateThemeModifier(value: unknown): value is number;
+/** Blend toward white. `keep` is the fraction of the base colour retained (OOXML themeTint byte). */
+declare function applyThemeTint(hex: string, keep: number): string;
+/** Blend toward black. `keep` is the fraction of the base colour retained (OOXML themeShade byte). */
+declare function applyThemeShade(hex: string, keep: number): string;
+/** Resolve a theme colour to literal hex. When both tint and shade are present, ECMA-376
+ *  §17.3.2.6 / §17.3.4 / §17.3.5 require tint precedence — shade is ignored for paint. */
+declare function resolveThemeColorHex(color: Extract<ColorValue, {
+    kind: 'theme';
+}>, themeColors: readonly DocumentThemeColorEntry[]): {
+    ok: true;
+    hex: string;
+} | {
+    ok: false;
+    reason: string;
+};
+type ColorLowerRefusal = {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * A public colour lowered for a border or fill op, or the reason it could not be.
+ *
+ * Refusals happen because paint needs a literal: a theme colour the document's theme does not
+ * define has no hex to draw, and inventing one would show a border in a colour the file never
+ * named.
+ */
+type ColorLowerResult = {
+    readonly ok: true;
+    readonly color: TreeDocColorValue;
+} | ColorLowerRefusal;
+/**
+ * Lower a public colour for table border ops. Theme colours require a resolved literal for
+ * paint; `auto` preserves OOXML automatic semantics with a black render fallback.
+ */
+declare function lowerColorValueForBorder(color: ColorValue, themeColors: readonly DocumentThemeColorEntry[]): ColorLowerResult;
+/**
+ * Lower a public colour for cell fill. `auto` refuses because the cascade literal
+ * cannot be named honestly at commit time.
+ */
+declare function lowerColorValueForFill(color: ColorValue, themeColors: readonly DocumentThemeColorEntry[]): ColorLowerResult;
+/** Resolve any public colour to a CSS `#RRGGBB` string for chrome display. */
+declare function resolveColorValueToCss(color: ColorValue | undefined | null, themeColors: readonly DocumentThemeColorEntry[], defaultHex?: string): string;
+
+/** Surface sizing derived from layout records, in layout points (not CSS pixels). */
+interface SurfaceExtent {
+    /** Width the surface container should occupy. */
+    readonly width: number;
+    /** Total document height (always from every page, for scroll extent). */
+    readonly height: number;
+    /**
+     * Extra horizontal offset per page, in layout points, so narrower sheets centre inside a
+     * mixed-width materialized window. Absent entries mean no offset beyond layout `box.x`.
+     */
+    readonly pageOffsetX: ReadonlyMap<number, number>;
+}
+/**
+ * How wide and tall the paginated surface should be.
+ *
+ * When `materialize` is set — virtualization is active — width follows only those pages so a
+ * distant landscape section does not stretch a portrait viewport. Without it (print, export,
+ * tests with no scroller) every page contributes, which is the safe reading.
+ */
+declare function surfaceExtent(layout: SemanticLayout, materialize: ReadonlySet<number> | undefined): SurfaceExtent;
+
+/** Validate a position input, refusing offsets or bases outside what OOXML allows. */
+declare function validateDrawingPositionInput(position: DrawingPositionInput): boolean;
+/** Legal `relativeFrom` bases for a horizontal offset (page, margin, column, character, …). */
+declare const DRAWING_REL_FROM_H: readonly string[];
+/** Legal `relativeFrom` bases for a vertical offset (page, margin, paragraph, line, …). */
+declare const DRAWING_REL_FROM_V: readonly string[];
+/** Whether an image-properties command carries any positioning fields at all. */
+declare function propertiesCommandHasPositionFields(command: {
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: string;
+    readonly relativeToV?: string;
+}): boolean;
+/** Extract the position input from an image-properties command, or null when it carries none. */
+declare function positionInputFromPropertiesCommand(command: {
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: string;
+    readonly relativeToV?: string;
+}, selected: {
+    readonly position?: DrawingPositionInput | null;
+} | null): DrawingPositionInput;
+/** Validate a set-position command before it reaches the store. */
+declare function validateSetImagePositionCommand(command: {
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: string;
+    readonly relativeToV?: string;
+}, mode: 'frame' | 'simple'): boolean;
+
+export { BROWSER_AUTOMATION_CAPABILITIES, type ColorLowerResult, DRAWING_REL_FROM_H, DRAWING_REL_FROM_V, DocxEditorInstance, DrawingPositionInput, OpenPaginatedResult, PX_PER_CM, PX_PER_INCH, PaginatedSurface, PaginatedSurfaceOptions, type RulerDragOptions, type RulerIndent, type RulerIndentHandle, type RulerPageMetrics, type RulerTick, type RulerUnit, SNAP_TWIPS_CM, SNAP_TWIPS_INCH, type SurfaceExtent, TWIPS_PER_CM, TWIPS_PER_INCH, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, rulerPageBox, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };

package/dist/editor.d.ts

@@ -0,0 +1,271 @@
+import { F as FontConfiguration, E as EditorFontError, a as EditorCommand, C as CanResult } from './editor-C1QRi1v4.js';
+export { I as ImageContext, b as ImageCropPercent, c as ImageCropPermille, S as SelectedImageState, d as cropPercentFromCropPermille, e as cropPercentFromPermille, f as cropPercentFromSourceCrop, g as cropPermilleFromCropPercent, h as cropPermilleFromPercent, s as sourceCropFromCropPercent, v as validateImageCropPercent } from './editor-C1QRi1v4.js';
+import { L as LayoutShapingOptions } from './shaped-measurer-B-TAtcQU.js';
+import { P as PaginatedSurfaceOptions, O as OpenPaginatedResult, a as PaginatedSurface, T as TableCommandPlan, D as DocxEditorInstance } from './index-ZqBEOrTV.js';
+export { A as AnchorFrameOrigin, C as CHROME_GROUPS, b as CHROME_MENUS, c as CHROME_UNAVAILABLE_KEY, d as ChromeControl, e as ChromeControlId, f as ChromeControlState, g as ChromeGroup, h as ChromeGroupId, i as ChromeMenu, j as ChromeMenuEntry, k as ChromeMenuId, l as ChromeMenuItemEntry, m as ChromeMenuSeparatorEntry, n as ChromeMenuSubmenuEntry, o as ChromeSlotId, p as DEFAULT_TABLE_CHROME_DRAFT, q as DocxEditorConfig, E as EMU_PER_POINT, F as FinalizedImageOverlayInteraction, r as FontConfigurationBase, s as FontConfigurationFragment, t as FontLoadFailure, u as FontLoadFailureReason, v as FontMeasurementState, w as FontResolutionRequest, x as FontResolver, y as FontUrlSource, H as HyperlinkActivation, z as HyperlinkChromeHandlers, B as HyperlinkOps, I as IMAGE_OVERLAY_NUDGE_PT, G as IMAGE_OVERLAY_NUDGE_SHIFT_PT, J as ImageInteractionSession, K as ImageOverlayScrollPort, L as ImageResizeHandle, M as ImageResizeResult, N as LoadFontsRequest, Q as LoadFontsResult, R as MAX_RESOLVER_FAMILIES, S as OverlayFrameRect, U as PaginatedSurfaceState, V as RunTableChromeCommandResult, W as SelectedDrawingOverlayTarget, X as SurfaceFormatting, Y as SurfaceHyperlink, Z as SurfaceNavigation, _ as SurfaceOverlayCoordinates, $ as TABLE_BORDER_STYLE_OPTIONS, a0 as TABLE_BORDER_TARGET_OPTIONS, a1 as TABLE_BORDER_WIDTH_OPTIONS, a2 as TABLE_CHROME_SLOT_IDS, a3 as TableBorderStyleOption, a4 as TableBorderTargetOption, a5 as TableBorderTargetValue, a6 as TableBorderWidthOption, a7 as TableChromeDraft, a8 as TableChromePick, a9 as TableChromeSlotId, aa as TableInteractionLabelKey, ab as ToolbarCommandState, ac as WORD_DEFAULT_FONT, ad as applyTableChromePick, ae as blankDocumentBytes, af as canExecuteImageCommand, ag as captureImageMutationPreconditions, ah as chromeControlCount, ai as chromeMenuSlots, aj as chromeProbeForSlot, ak as chromeSlotId, al as commandForSlot, am as commandForSlotValue, an as commandForTableChromeSlotValue, ao as composeFontConfiguration, ap as computeImageResizeResult, aq as computeMovedImagePosition, ar as computeResizedImageExtentEmu, as as createDocxEditor, at as createFontSource, au as createImageOverlayScrollPort, av as cssPixelsToLayoutPoints, aw as defaultChromeGroups, ax as defaultTableLabel, ay as emuToOverlayPoints, az as executeImageCommand, aA as finalizeImageOverlayInteraction, aB as formattingBarChromeGroups, aC as isStaleImageInteractionCommit, aD as isTableChromeSlot, aE as layoutPointsToCssPixels, aF as loadFonts, aG as overlayFrameToSheetCssPixels, aH as pointsToEmu, aI as probeTableChromeCommand, aJ as resizePreservesAspect, aK as runSave, aL as runTableChromeCommand, aM as runTableCommand, aN as runToolbarCommand, aO as selectedDrawingOverlayTargetOf, aP as selectedImageStateOf, aQ as surfacePaintScale, aR as tableChromeIconPaths, aS as tableChromeLabelKeyForTarget, aT as tableChromeToolbarState, aU as tableChromeVisible, aV as tableCommandToolbarState, aW as toolbarCommandState, aX as toolbarCommandStates } from './index-ZqBEOrTV.js';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-oxHaWmt4.js';
+export { CollectReviewItems, EditorModule, EditorModuleRegistry, ReviewModuleContribution, resolveEditorModules } from './contracts/modules.js';
+import { ColorValue } from './contracts/types.js';
+import { h as TreeDocColorValue, d as DrawingPositionInput } from './tree-op-types-CwOeiaQ8.js';
+export { i as IMAGE_WRAP_TARGETS, b as ImageWrapTarget } from './tree-op-types-CwOeiaQ8.js';
+import { f as DocumentThemeColorEntry } from './tree-session-CiUel5Kz.js';
+import { S as SemanticLayout } from './semantic-records-CWodBJsz.js';
+export { T as TextMeasurer } from './semantic-records-CWodBJsz.js';
+export { D as DEFAULT_IMAGE_RESOURCE_LIMITS, b as ImageDecodePort, c as ImageResourceLimits, R as RenderableImageMime, S as SupportedImageMime, a as VectorImageMime, r as resolveImageResourceLimits, d as resolveSvgIntrinsicSize, s as sniffImageMime, v as validateRasterHeader } from './image-resources-BJnTpG66.js';
+export { S as SectionProperties } from './semantic-cell-selection-DsmHmLJ5.js';
+export { R as ReviewModelInput } from './review-support-Fy3vdIea.js';
+export { N as NavigationCommand, S as SemanticPosition, a as SemanticSelection } from './semantic-interaction-Dy-dCUFF.js';
+import './contracts/document.js';
+import './revision-projection-DHAkcD_L.js';
+import './ooxml-tree-BU0e3DVi.js';
+import './note-properties-m75hmP70.js';
+import './ooxml-package-D_CtywTW.js';
+import './tree-package-store-D5S7VKs5.js';
+import './hf-references-BdjsQNE_.js';
+import './note-nodes-BPSTVDMr.js';
+import './tree-store-hLtjeyWE.js';
+import './semantic-paint-drawings-BA3z9jl8.js';
+import 'prosemirror-model';
+
+interface LayoutShapingInstrumentation {
+    readonly onFontByteCopy?: () => void;
+    readonly onFontHash?: () => void;
+    readonly onFontAdmission?: () => void;
+}
+/**
+ * Normalize anything thrown during font work into an {@link EditorFontError}.
+ *
+ * One error type reaches consumers whether the failure came from resolution, admission or
+ * shaping, so a host branches on `code` rather than on which layer happened to throw.
+ */
+declare function toEditorFontError(error: unknown): EditorFontError;
+/** Adapt the published byte-source contract to the private deterministic layout snapshot. */
+declare function createLayoutShaping(configuration: FontConfiguration, instrumentation?: LayoutShapingInstrumentation): Promise<LayoutShapingOptions>;
+/**
+ * Release a shaping environment's native resources.
+ *
+ * The shaper holds WASM memory that garbage collection cannot reclaim on its own, so a host that
+ * builds shaping options must dispose them when the editor goes away. Safe on a shaper that has
+ * no `dispose`.
+ */
+declare function disposeLayoutShaping(shaping: LayoutShapingOptions): void;
+
+/** The engine paints at 96 px per inch (twips / 15, 1440 twips per inch). */
+declare const PX_PER_INCH = 96;
+/** Painted pixels per centimetre, derived from {@link PX_PER_INCH}. */
+declare const PX_PER_CM: number;
+/** Which measurement system the ruler shows. Drives both tick cadence and drag snapping. */
+type RulerUnit = 'inch' | 'cm';
+/** One tick on the ruler: where it sits, how tall it is, and its label if it carries one. */
+interface RulerTick {
+    /** Offset along the ruler in content pixels. */
+    readonly position: number;
+    readonly height: number;
+    /** Whole-unit label, omitted at the origin and on minor ticks. */
+    readonly label?: string;
+}
+/**
+ * Ticks across one page dimension, matching the legacy cadence: eighth-inch
+ * minors with labelled inches, or millimetre minors with labelled centimetres.
+ */
+declare function generateRulerTicks(lengthPx: number, unit: RulerUnit): RulerTick[];
+/** The first page's box, which the rulers measure against. */
+declare function rulerPageBox(pages: readonly {
+    readonly index: number;
+    readonly box: {
+        width: number;
+        height: number;
+    };
+}[]): {
+    width: number;
+    height: number;
+} | null;
+
+/** Twips per inch, as OOXML defines them. */
+declare const TWIPS_PER_INCH = 1440;
+/** Twips per centimetre, as Word rounds them. */
+declare const TWIPS_PER_CM = 567;
+/** Word snaps ruler drags to the eighth-inch grid its ticks already draw. */
+declare const SNAP_TWIPS_INCH: number;
+/** The centimetre ruler's grid is the millimetre. */
+declare const SNAP_TWIPS_CM: number;
+
+/**
+ * The four handles Word's ruler carries.
+ *
+ * `hanging` and `left` sit at the SAME position and differ only in what a drag takes with
+ * them — the box moves the whole paragraph, the triangle leaves the first line where it is.
+ */
+type RulerIndentHandle = 'firstLine' | 'hanging' | 'left' | 'right';
+/** A paragraph's indent as the ruler works with it. Twips; `firstLine` signed. */
+interface RulerIndent {
+    readonly left: number;
+    readonly right: number;
+    readonly firstLine: number;
+}
+/** The page the handles are placed against. Twips. */
+interface RulerPageMetrics {
+    readonly pageWidth: number;
+    readonly leftMargin: number;
+    readonly rightMargin: number;
+}
+/**
+ * How a ruler drag resolves: which grid it snaps to, and whether it snaps at all.
+ *
+ * @public
+ */
+interface RulerDragOptions {
+    /** Which snap grid applies. Defaults to inches. */
+    readonly unit?: RulerUnit;
+    /** Alt held: continuous, twip-precision drag, bypassing the snap grid — as in Word. */
+    readonly precise?: boolean;
+}
+/** Where a handle sits, in twips from the page's LEFT SHEET EDGE (not the margin). */
+declare function handlePosition(handle: RulerIndentHandle, indent: RulerIndent, page: RulerPageMetrics): number;
+/** Round to the ruler's grid, or to the twip when the drag is precise. */
+declare function snapTwips(value: number, unit: RulerUnit, precise: boolean): number;
+/**
+ * The indent a drag of `handle` to `positionTwips` produces.
+ *
+ * Clamps differ from the MARGIN drags this ruler also carries, and deliberately:
+ *
+ * - Indents may go NEGATIVE, pulling text into the margin, which Word allows. The floor is
+ *   the sheet edge, not the margin.
+ * - There is no minimum text width. The 720-twip floor the margin drags use mirrors an
+ *   engine refusal that does not exist for indents, and enforcing one here would make a
+ *   narrow pull-quote unreachable. Left and right markers may MEET; they may not cross.
+ * - The left box needs a first-line clamp of its own. It does not move `firstLine`, so on a
+ *   hanging paragraph dragging the box left can push the first-line marker off the sheet
+ *   while the box itself is still in range. The drag stops when the LEADING marker lands.
+ */
+declare function dragIndent(handle: RulerIndentHandle, positionTwips: number, indent: RulerIndent, page: RulerPageMetrics, options?: RulerDragOptions): RulerIndent;
+
+/**
+ * Mount a paginated surface over DOCX bytes.
+ *
+ * Returns a typed rejection rather than throwing: a failure here is a property of the file,
+ * and a host must be able to tell "not a package" from "no body" without parsing an error
+ * message.
+ */
+declare function mountPaginatedSurface(container: HTMLElement, bytes: Uint8Array, options?: PaginatedSurfaceOptions): OpenPaginatedResult;
+
+/** Planner-backed can/plan pair — production gate for table commands. Task 9 maps chrome slots. */
+declare function tableCommandState(command: EditorCommand, surface: PaginatedSurface): {
+    readonly can: CanResult;
+    readonly plan: TableCommandPlan;
+};
+
+/**
+ * What a browser host can do.
+ *
+ * `selection`, `scrolling` and `layout` are true because a mounted editor genuinely has a
+ * caret, a scroll container and paginated layout — a consumer may branch on them. The
+ * DOCUMENT operations behave identically to the headless host regardless; the extra
+ * capabilities widen what may be asked later, never what an existing operation means.
+ */
+declare const BROWSER_AUTOMATION_CAPABILITIES: AutomationCapabilities;
+/**
+ * An automation host over a live editor.
+ *
+ * The editor keeps its own lifetime: `dispose()` on the returned host releases the change
+ * subscription this adapter took and leaves the editor mounted and editable.
+ */
+declare function createBrowserAutomationHost(editor: DocxEditorInstance): AutomationHost;
+
+/** Clamp and validate an OOXML theme modifier fraction (0, 1]. */
+declare function validateThemeModifier(value: unknown): value is number;
+/** Blend toward white. `keep` is the fraction of the base colour retained (OOXML themeTint byte). */
+declare function applyThemeTint(hex: string, keep: number): string;
+/** Blend toward black. `keep` is the fraction of the base colour retained (OOXML themeShade byte). */
+declare function applyThemeShade(hex: string, keep: number): string;
+/** Resolve a theme colour to literal hex. When both tint and shade are present, ECMA-376
+ *  §17.3.2.6 / §17.3.4 / §17.3.5 require tint precedence — shade is ignored for paint. */
+declare function resolveThemeColorHex(color: Extract<ColorValue, {
+    kind: 'theme';
+}>, themeColors: readonly DocumentThemeColorEntry[]): {
+    ok: true;
+    hex: string;
+} | {
+    ok: false;
+    reason: string;
+};
+type ColorLowerRefusal = {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * A public colour lowered for a border or fill op, or the reason it could not be.
+ *
+ * Refusals happen because paint needs a literal: a theme colour the document's theme does not
+ * define has no hex to draw, and inventing one would show a border in a colour the file never
+ * named.
+ */
+type ColorLowerResult = {
+    readonly ok: true;
+    readonly color: TreeDocColorValue;
+} | ColorLowerRefusal;
+/**
+ * Lower a public colour for table border ops. Theme colours require a resolved literal for
+ * paint; `auto` preserves OOXML automatic semantics with a black render fallback.
+ */
+declare function lowerColorValueForBorder(color: ColorValue, themeColors: readonly DocumentThemeColorEntry[]): ColorLowerResult;
+/**
+ * Lower a public colour for cell fill. `auto` refuses because the cascade literal
+ * cannot be named honestly at commit time.
+ */
+declare function lowerColorValueForFill(color: ColorValue, themeColors: readonly DocumentThemeColorEntry[]): ColorLowerResult;
+/** Resolve any public colour to a CSS `#RRGGBB` string for chrome display. */
+declare function resolveColorValueToCss(color: ColorValue | undefined | null, themeColors: readonly DocumentThemeColorEntry[], defaultHex?: string): string;
+
+/** Surface sizing derived from layout records, in layout points (not CSS pixels). */
+interface SurfaceExtent {
+    /** Width the surface container should occupy. */
+    readonly width: number;
+    /** Total document height (always from every page, for scroll extent). */
+    readonly height: number;
+    /**
+     * Extra horizontal offset per page, in layout points, so narrower sheets centre inside a
+     * mixed-width materialized window. Absent entries mean no offset beyond layout `box.x`.
+     */
+    readonly pageOffsetX: ReadonlyMap<number, number>;
+}
+/**
+ * How wide and tall the paginated surface should be.
+ *
+ * When `materialize` is set — virtualization is active — width follows only those pages so a
+ * distant landscape section does not stretch a portrait viewport. Without it (print, export,
+ * tests with no scroller) every page contributes, which is the safe reading.
+ */
+declare function surfaceExtent(layout: SemanticLayout, materialize: ReadonlySet<number> | undefined): SurfaceExtent;
+
+/** Validate a position input, refusing offsets or bases outside what OOXML allows. */
+declare function validateDrawingPositionInput(position: DrawingPositionInput): boolean;
+/** Legal `relativeFrom` bases for a horizontal offset (page, margin, column, character, …). */
+declare const DRAWING_REL_FROM_H: readonly string[];
+/** Legal `relativeFrom` bases for a vertical offset (page, margin, paragraph, line, …). */
+declare const DRAWING_REL_FROM_V: readonly string[];
+/** Whether an image-properties command carries any positioning fields at all. */
+declare function propertiesCommandHasPositionFields(command: {
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: string;
+    readonly relativeToV?: string;
+}): boolean;
+/** Extract the position input from an image-properties command, or null when it carries none. */
+declare function positionInputFromPropertiesCommand(command: {
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: string;
+    readonly relativeToV?: string;
+}, selected: {
+    readonly position?: DrawingPositionInput | null;
+} | null): DrawingPositionInput;
+/** Validate a set-position command before it reaches the store. */
+declare function validateSetImagePositionCommand(command: {
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: string;
+    readonly relativeToV?: string;
+}, mode: 'frame' | 'simple'): boolean;
+
+export { BROWSER_AUTOMATION_CAPABILITIES, type ColorLowerResult, DRAWING_REL_FROM_H, DRAWING_REL_FROM_V, DocxEditorInstance, DrawingPositionInput, OpenPaginatedResult, PX_PER_CM, PX_PER_INCH, PaginatedSurface, PaginatedSurfaceOptions, type RulerDragOptions, type RulerIndent, type RulerIndentHandle, type RulerPageMetrics, type RulerTick, type RulerUnit, SNAP_TWIPS_CM, SNAP_TWIPS_INCH, type SurfaceExtent, TWIPS_PER_CM, TWIPS_PER_INCH, applyThemeShade, applyThemeTint, createBrowserAutomationHost, createLayoutShaping, disposeLayoutShaping, dragIndent, generateRulerTicks, handlePosition, lowerColorValueForBorder, lowerColorValueForFill, mountPaginatedSurface, positionInputFromPropertiesCommand, propertiesCommandHasPositionFields, resolveColorValueToCss, resolveThemeColorHex, rulerPageBox, snapTwips, surfaceExtent, tableCommandState, toEditorFontError, validateDrawingPositionInput, validateSetImagePositionCommand, validateThemeModifier };

package/dist/editor.js

@@ -0,0 +1 @@
+export{Da as BROWSER_AUTOMATION_CAPABILITIES,sa as CHROME_GROUPS,wa as CHROME_MENUS,za as CHROME_UNAVAILABLE_KEY,W as DEFAULT_TABLE_CHROME_DRAFT,O as EMU_PER_POINT,M as IMAGE_OVERLAY_NUDGE_PT,N as IMAGE_OVERLAY_NUDGE_SHIFT_PT,d as MAX_RESOLVER_FAMILIES,k as PX_PER_CM,j as PX_PER_INCH,q as SNAP_TWIPS_CM,p as SNAP_TWIPS_INCH,aa as TABLE_BORDER_STYLE_OPTIONS,$ as TABLE_BORDER_TARGET_OPTIONS,ba as TABLE_BORDER_WIDTH_OPTIONS,X as TABLE_CHROME_SLOT_IDS,o as TWIPS_PER_CM,n as TWIPS_PER_INCH,e as WORD_DEFAULT_FONT,ca as applyTableChromePick,w as applyThemeShade,v as applyThemeTint,g as blankDocumentBytes,K as canExecuteImageCommand,J as captureImageMutationPreconditions,ya as chromeControlCount,xa as chromeMenuSlots,ga as chromeProbeForSlot,ta as chromeSlotId,ha as commandForSlot,ja as commandForSlotValue,ia as commandForTableChromeSlotValue,f as composeFontConfiguration,Ka as computeImageResizeResult,T as computeMovedImagePosition,S as computeResizedImageExtentEmu,Ea as createBrowserAutomationHost,Ca as createDocxEditor,i as createFontSource,La as createImageOverlayScrollPort,b as createLayoutShaping,G as cropPercentFromCropPermille,E as cropPercentFromPermille,B as cropPercentFromSourceCrop,F as cropPermilleFromCropPercent,D as cropPermilleFromPercent,Ha as cssPixelsToLayoutPoints,ua as defaultChromeGroups,Y as defaultTableLabel,c as disposeLayoutShaping,t as dragIndent,R as emuToOverlayPoints,L as executeImageCommand,Ma as finalizeImageOverlayInteraction,va as formattingBarChromeGroups,l as generateRulerTicks,r as handlePosition,U as isStaleImageInteractionCommit,Z as isTableChromeSlot,Ga as layoutPointsToCssPixels,h as loadFonts,y as lowerColorValueForBorder,z as lowerColorValueForFill,Ba as mountPaginatedSurface,Ia as overlayFrameToSheetCssPixels,Q as pointsToEmu,da as probeTableChromeCommand,Ja as resizePreservesAspect,A as resolveColorValueToCss,x as resolveThemeColorHex,m as rulerPageBox,pa as runSave,na as runTableChromeCommand,ra as runTableCommand,oa as runToolbarCommand,P as selectedDrawingOverlayTargetOf,I as selectedImageStateOf,s as snapTwips,C as sourceCropFromCropPercent,Aa as surfaceExtent,Fa as surfacePaintScale,fa as tableChromeIconPaths,ea as tableChromeLabelKeyForTarget,ka as tableChromeToolbarState,_ as tableChromeVisible,V as tableCommandState,qa as tableCommandToolbarState,a as toEditorFontError,la as toolbarCommandState,ma as toolbarCommandStates,H as validateImageCropPercent,u as validateThemeModifier}from'./chunk-DLPL5DAG.js';import'./chunk-5KSCB2OZ.js';import'./chunk-HVAV2JSN.js';import'./chunk-PHDVKUWZ.js';import'./chunk-BSC44TIT.js';import'./chunk-ZUALAR4M.js';import'./chunk-DOEIARE2.js';export{D as DEFAULT_IMAGE_RESOURCE_LIMITS,Re as DRAWING_REL_FROM_H,Se as DRAWING_REL_FROM_V,Wa as IMAGE_WRAP_TARGETS,Ue as positionInputFromPropertiesCommand,Te as propertiesCommandHasPositionFields,E as resolveImageResourceLimits,mb as resolveSvgIntrinsicSize,ib as sniffImageMime,Qe as validateDrawingPositionInput,nb as validateRasterHeader,Ve as validateSetImagePositionCommand}from'./chunk-RNBHTPW7.js';import'./chunk-REZUWYB7.js';export{a as resolveEditorModules}from'./chunk-HR7K3W6A.js';

package/dist/hf-references-BdjsQNE_.d.ts

@@ -0,0 +1,71 @@
+import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
+import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
+
+/** `w:headerReference w:type` vocabulary (ECMA-376 §17.10.5): default, first page, even pages. */
+type HeaderFooterVariant = 'default' | 'first' | 'even';
+/** Header vs footer region kind for chrome and lifecycle ops. */
+type HeaderFooterKind = 'header' | 'footer';
+/**
+ * A section's resolved header and footer parts, by variant.
+ *
+ * The `even` variant is only honoured when `w:evenAndOddHeaders` is set in settings.xml —
+ * without it Word ignores an authored even header, and so does this.
+ */
+interface HeaderFooterParts {
+    readonly headers: ReadonlyMap<HeaderFooterVariant, OoxmlPart>;
+    readonly footers: ReadonlyMap<HeaderFooterVariant, OoxmlPart>;
+    /** `w:evenAndOddHeaders` in settings.xml — without it the `even` variant is ignored. */
+    readonly evenAndOddHeaders: boolean;
+    /** Whether this section enables first-page header/footer furniture (`w:titlePg`). */
+    readonly titlePage: boolean;
+}
+/**
+ * One resolved furniture slot with enough metadata for "Same as previous" chrome.
+ *
+ * `inherited: true` means this section has no declared reference for the slot and the
+ * part comes from a predecessor. The first section never reports inherited — omitting a
+ * ref there is blank furniture, not inheritance from a later section.
+ */
+interface HeaderFooterSlotMeta {
+    readonly part: OoxmlPart;
+    readonly partName: string;
+    readonly rId: string;
+    readonly inherited: boolean;
+}
+/** Per-section resolution including declared-vs-inherited metadata. */
+interface HeaderFooterSectionResolution {
+    readonly headers: ReadonlyMap<HeaderFooterVariant, HeaderFooterSlotMeta>;
+    readonly footers: ReadonlyMap<HeaderFooterVariant, HeaderFooterSlotMeta>;
+    readonly evenAndOddHeaders: boolean;
+    readonly titlePage: boolean;
+}
+/**
+ * `w:sectPr` nodes in section order, aligned with layout's `enumerateDocumentSections`.
+ *
+ * `null` means a section with no `w:sectPr` node (Word defaults, inherits HF from previous).
+ * Paragraph-level breaks first; the final entry covers remaining blocks (body-level or null).
+ */
+declare function collectSectionPropertyNodes(root: OoxmlNode): Array<OoxmlElement | null>;
+/**
+ * Resolve header/footer parts for every section with declared-vs-inherited metadata.
+ *
+ * Index aligns with `enumerateDocumentSections` in the layout package. Existing merged
+ * maps stay available via {@link resolveHeaderFooterPartsBySection}.
+ */
+declare function resolveHeaderFooterResolutionBySection(pkg: OoxmlPackage): readonly HeaderFooterSectionResolution[];
+/**
+ * Resolve header/footer parts for every section, applying OOXML inheritance.
+ *
+ * Index aligns with `enumerateDocumentSections` in the layout package.
+ */
+declare function resolveHeaderFooterPartsBySection(pkg: OoxmlPackage): readonly HeaderFooterParts[];
+/**
+ * Resolve the main-document header/footer references to their parts, gated by the
+ * settings the section actually declares.
+ *
+ * Returns the FINAL section's effective parts (after inheritance). Multi-section hosts
+ * should prefer `resolveHeaderFooterPartsBySection`.
+ */
+declare function resolveHeaderFooterParts(pkg: OoxmlPackage): HeaderFooterParts;
+
+export { type HeaderFooterVariant as H, type HeaderFooterParts as a, type HeaderFooterSectionResolution as b, type HeaderFooterKind as c, type HeaderFooterSlotMeta as d, collectSectionPropertyNodes as e, resolveHeaderFooterPartsBySection as f, resolveHeaderFooterResolutionBySection as g, resolveHeaderFooterParts as r };