@docx-editor.dev/core 2.27.0 → 2.29.0

package/dist/{protocol-aKYr8r3u.d.ts → protocol-DYzzz2ej.d.ts}

@@ -1,5 +1,5 @@
-import { a6 as AutomationTableMutation, a3 as RevisionBatchResult } from './types-barrel-BFKR8Pzp.js';
-import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-fragment-DYZIk1rY.js';
+import { aw as AutomationTableMutation, a9 as RevisionBatchResult, a8 as RevisionAuthorResult } from './types-barrel-DuC5QBNC.js';
+import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-store-CovjNARF.js';
 
 /** Word's shape types, as `Word.ShapeType` spells them. */
 type AutomationShapeType = 'TextBox' | 'GeometricShape' | 'Picture' | 'Group' | 'Canvas' | 'Unsupported';
@@ -25,6 +25,11 @@ interface AutomationInlinePictureWrite {
 
 /** Alignment as this protocol publishes it. `Mixed`/`Unknown` are read-only answers. */
 type AutomationAlignment = 'Mixed' | 'Unknown' | 'Left' | 'Centered' | 'Right' | 'Justified';
+/**
+ * A paragraph's base direction (`w:bidi`) as this protocol publishes it: the direction the
+ * paragraph reads in, after its style cascade.
+ */
+type AutomationReadingOrder = 'LeftToRight' | 'RightToLeft';
 /**
  * What a range agrees about its characters' formatting.
  *
@@ -78,6 +83,8 @@ interface AutomationParagraphFormatRead {
     readonly spaceBefore: number | null;
     readonly spaceAfter: number | null;
     readonly widowControl: boolean | null;
+    /** The direction the paragraph reads in: its own `w:bidi` if any, else the style cascade's. */
+    readonly readingOrder: AutomationReadingOrder;
 }
 /**
  * A paragraph-property write. Every field optional; omitted means "leave alone".
@@ -103,6 +110,12 @@ interface AutomationParagraphFormatWrite {
     readonly spaceBefore?: number;
     readonly spaceAfter?: number;
     readonly widowControl?: boolean;
+    /**
+     * The direction the paragraph should read in. Nothing is written when it already does. Else the
+     * paragraph's own `w:bidi` is removed when that alone set the other direction, or stated:
+     * `<w:bidi/>`, or `<w:bidi w:val="0"/>` over a right-to-left style.
+     */
+    readonly readingOrder?: AutomationReadingOrder;
 }
 
 declare const MEMBERS: {
@@ -984,6 +997,19 @@ type AutomationOperation = AutomationAuthoringOperation | {
     readonly action: 'accept' | 'reject';
     readonly revisions?: readonly AutomationHandle[];
 }
+/**
+ * Attribute pending decisions in one story to another author, keeping them pending. Omit
+ * revisions to select every canonical decision. `date` is `xsd:dateTime`; omitted keeps each.
+ */
+ | {
+    readonly op: 'setRevisionAuthorBatch';
+    readonly body: AutomationHandle;
+    readonly author: string;
+    readonly date?: string;
+    readonly revisions?: readonly AutomationHandle[];
+    /** Keep only changes these authors made. Not allowed with `revisions`. */
+    readonly authors?: readonly string[];
+}
 /** Word's name for the kind of change: `Insert`, `Delete`, `Replace`, `Property`, … */
  | {
     readonly op: 'getRevisionType';
@@ -1329,7 +1355,11 @@ interface AutomationCapabilities {
  * `stale-revision` must not retry an `invalid-handle`.
  */
 type AutomationErrorCode = 
-/** `expectedRevision` did not match the host's current revision; nothing was applied. */
+/**
+ * Nothing was applied because the request was built from an older read: `expectedRevision`
+ * did not match the host's current revision, or an endpoint's `readAt` names a position
+ * that moved since. Read again before retrying; resending the same endpoints fails again.
+ */
 'stale-revision'
 /** A handle this host never minted, or one naming a different kind of object. */
  | 'invalid-handle'
@@ -1406,6 +1436,13 @@ interface AutomationEndpoint {
      */
     readonly paragraph: AutomationHandle;
     readonly offset: number;
+    /**
+     * The host revision this endpoint was read at. Hosts stamp every endpoint they answer with
+     * it; send it back unchanged. An endpoint whose paragraph text changed since then is refused
+     * with `stale-revision` instead of addressing whatever text now sits at its offset. Omit it
+     * for an endpoint built by hand, which the host then takes as current.
+     */
+    readonly readAt?: number;
 }
 /** A stretch of a story between two endpoints, in reading order. */
 interface AutomationSpan {
@@ -1416,6 +1453,9 @@ interface AutomationSpan {
 type AutomationValue = {
     readonly kind: 'revisionBatch';
     readonly result: RevisionBatchResult;
+} | {
+    readonly kind: 'revisionAuthors';
+    readonly result: RevisionAuthorResult;
 } | {
     readonly kind: 'field';
     readonly field: {
@@ -1608,4 +1648,4 @@ interface AutomationHost {
     dispose(): void;
 }
 
-export type { AutomationOperation as A, AutomationPoint as B, AutomationSaveResult as C, AutomationSearchOptions as D, AutomationSelectionMode as E, AutomationSpan as F, AutomationSpanRef as G, AutomationTextProjection as H, AutomationUnsubscribe as I, AutomationValue as J, AutomationCapabilities as a, AutomationHost as b, AutomationAlignment as c, AutomationBatchRequest as d, AutomationBatchResponse as e, AutomationChangeEvent as f, AutomationContentControlLock as g, AutomationContentControlRangeLocation as h, AutomationContentControlScope as i, AutomationContentControlSubtype as j, AutomationContentControlValue as k, AutomationError as l, AutomationErrorCode as m, AutomationFontRead as n, AutomationFontWrite as o, AutomationHandle as p, AutomationHandleRef as q, AutomationObjectKind as r, AutomationOperationKind as s, AutomationOperationResult as t, AutomationPageOrientation as u, AutomationPageSetupRead as v, AutomationPageSetupWrite as w, AutomationParagraphFormatRead as x, AutomationParagraphFormatWrite as y, AutomationParagraphRef as z };
+export type { AutomationOperation as A, AutomationPoint as B, AutomationReadingOrder as C, AutomationSaveResult as D, AutomationSearchOptions as E, AutomationSelectionMode as F, AutomationSpan as G, AutomationSpanRef as H, AutomationTextProjection as I, AutomationUnsubscribe as J, AutomationValue as K, AutomationCapabilities as a, AutomationHost as b, AutomationAlignment as c, AutomationBatchRequest as d, AutomationBatchResponse as e, AutomationChangeEvent as f, AutomationContentControlLock as g, AutomationContentControlRangeLocation as h, AutomationContentControlScope as i, AutomationContentControlSubtype as j, AutomationContentControlValue as k, AutomationError as l, AutomationErrorCode as m, AutomationFontRead as n, AutomationFontWrite as o, AutomationHandle as p, AutomationHandleRef as q, AutomationObjectKind as r, AutomationOperationKind as s, AutomationOperationResult as t, AutomationPageOrientation as u, AutomationPageSetupRead as v, AutomationPageSetupWrite as w, AutomationParagraphFormatRead as x, AutomationParagraphFormatWrite as y, AutomationParagraphRef as z };

package/dist/{review-paragraph-order-Ddj5d6rp.d.ts → review-paragraph-order-CN_0l2Cb.d.ts}

@@ -1,4 +1,4 @@
-import { N as OoxmlNode, Z as OoxmlElement, _ as OoxmlContentControlNode, V as OoxmlGenericElementNode, $ as OoxmlContentControlContentNode, C as CommentRecord, O as OoxmlPart } from './types-barrel-BFKR8Pzp.js';
+import { N as OoxmlNode, ak as OoxmlElement, al as OoxmlContentControlNode, V as OoxmlGenericElementNode, am as OoxmlContentControlContentNode, C as CommentRecord, O as OoxmlPart } from './types-barrel-DuC5QBNC.js';
 
 /** Nested content-control wrappers deeper than this stop flattening; content stays preserved. */
 declare const MAX_CONTENT_CONTROL_NESTING = 32;
@@ -63,7 +63,10 @@ declare function walkParagraphInline(children: readonly OoxmlNode[], depth: numb
  * run walk.
  */
 declare function commentBodyText(comment: CommentRecord): string;
-/** Author initials for an avatar, from `@w:initials` or the name. */
+/**
+ * Author initials for an avatar, from `@w:initials` or the name, at most three characters.
+ * Characters are code points, so a surrogate pair is never split.
+ */
 declare function commentInitials(comment: CommentRecord): string;
 
 /**

package/dist/{semantic-cell-selection-DoqYCz_F.d.ts → semantic-cell-selection-eYag3P47.d.ts}

@@ -1,212 +1,5 @@
-import { O as OoxmlPart, Z as OoxmlElement, N as OoxmlNode } from './types-barrel-BFKR8Pzp.js';
-import { b as RevisionDisplayMode, c as RevisionAuthorFilter } from './revision-projection-CSNFudZY.js';
-import { f as SectionPageBorders, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, e as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, g as TableRowFragmentRecord, h as TableCellFragmentRecord } from './semantic-records-B9OolWGN.js';
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-G0bjmmmk.js';
-
-/** Page geometry, in points. */
-interface PageGeometry {
-    readonly width: number;
-    readonly height: number;
-    readonly margin: {
-        readonly top: number;
-        readonly right: number;
-        readonly bottom: number;
-        readonly left: number;
-    };
-    /** `w:pgMar/@header` — sheet edge to header top, in points. Defaults to 36 (720 twips). */
-    readonly headerDistance?: number;
-    /** `w:pgMar/@footer` — sheet edge to footer bottom, in points. Defaults to 36. */
-    readonly footerDistance?: number;
-}
-/** US Letter with one-inch margins, in points. */
-declare const DEFAULT_PAGE_GEOMETRY: PageGeometry;
-
-/**
- * Hard ceiling on sections enumerated from a document (matches write-path
- * `MAX_SECTIONS` in note/hf lifecycle). Hostile packages with unbounded `w:sectPr`
- * marks fail closed here rather than amplifying layout props arrays.
- */
-declare const MAX_DOCUMENT_SECTIONS = 4096;
-/** A section's margins in twips, including the header and footer reserve bands. */
-interface SectionMargins {
-    readonly topTwips: number;
-    readonly rightTwips: number;
-    readonly bottomTwips: number;
-    readonly leftTwips: number;
-    readonly headerTwips: number;
-    readonly footerTwips: number;
-    readonly gutterTwips: number;
-}
-/** One explicit `w:col`: its width and the gap after it. */
-interface SectionColumnDefinition {
-    readonly widthTwips: number;
-    /** Space after this column; zero on the final column. */
-    readonly gapTwips: number;
-}
-/**
- * A section's column layout.
- *
- * Equal-width and explicit-width columns are one type because a file may declare `w:num` with no
- * `w:col` children at all, and layout must handle both without branching at every use site.
- */
-interface SectionColumns {
-    readonly count: number;
-    /** Shared gap for equal-width columns and fallback gap for incomplete explicit definitions. */
-    readonly gapTwips: number;
-    readonly equalWidth?: boolean;
-    readonly separator?: boolean;
-    /** Authored `w:col` geometry when `equalWidth` is false. */
-    readonly definitions?: readonly SectionColumnDefinition[];
-}
-/**
- * How this section is placed relative to the previous one (ECMA-376 17.6.22,
- * `ST_SectionMark`).
- *
- * All five schema values are read. `nextColumn` paginates like `nextPage` for now: in a
- * single-column section that IS Word's behaviour, and multi-column flow is not modelled,
- * so collapsing it at the parse boundary would only hide the authored value from a
- * consumer that asks.
- */
-type SectionBreakType = 'nextPage' | 'continuous' | 'evenPage' | 'oddPage' | 'nextColumn';
-/**
- * Authored `w:pgNumType` (ECMA-376 CT_PageNumber).
- *
- * Distinguishes three states via {@link SectionProperties.pageNumbering}:
- * - element absent → `undefined` (Word defaults; no empty element to re-emit)
- * - empty `<w:pgNumType/>` → `{}` (present, no authored attrs; must round-trip empty)
- * - attributes set → only those keys appear (never invent schema defaults like `fmt=decimal`)
- *
- * `chapStyle` / `chapSep` are preserved for consumers; PAGE projection does not yet compose
- * chapter numbers (heading outline resolution is out of this slice).
- */
-interface SectionPageNumbering {
-    /** Authored `@w:start` when present and in range; otherwise omitted. */
-    readonly start?: number;
-    /** Authored `@w:fmt` (ST_NumberFormat) when present; otherwise omitted. */
-    readonly fmt?: string;
-    /** Authored `@w:chapStyle` outline level when present and in range. */
-    readonly chapStyle?: number;
-    /** Authored `@w:chapSep` when present (hyphen / period / colon / emDash / enDash). */
-    readonly chapSep?: string;
-}
-/**
- * One section's resolved `w:sectPr`, as layout needs it.
- *
- * Resolved, not raw: defaults the file omitted are filled in here (an absent `w:type` is
- * `nextPage`), so layout never has to know which attributes were authored and which were
- * inherited.
- */
-interface SectionProperties {
-    /** Active document grid line pitch: line-unit paragraph margins and line snapping. */
-    readonly gridLinePitchTwips?: number;
-    readonly pageSize: {
-        readonly widthTwips: number;
-        readonly heightTwips: number;
-    };
-    readonly margins: SectionMargins;
-    readonly columns: SectionColumns;
-    readonly landscape: boolean;
-    readonly titlePage: boolean;
-    /** Absent `w:type` defaults to `nextPage`. */
-    readonly breakType: SectionBreakType;
-    /**
-     * Authored page-number type. Absent when `w:pgNumType` is missing; empty object when the
-     * element is present with no attributes (comprehensive-fixture shape).
-     */
-    readonly pageNumbering?: SectionPageNumbering;
-    /**
-     * Resolved `w:pgBorders` (§17.6.10). Absent when the section declares none, or when every
-     * edge it declares is off or an art border — see {@link parsePageBorders}.
-     */
-    readonly pageBorders?: SectionPageBorders;
-}
-/**
- * One section of the body story: contiguous top-level blocks plus the properties that end it.
- *
- * `blockStart` / `blockEndExclusive` index into `storyBlocks(part)`.
- */
-interface DocumentSection {
-    readonly index: number;
-    readonly properties: SectionProperties;
-    readonly blockStart: number;
-    readonly blockEndExclusive: number;
-}
-/** US Letter, portrait, one-inch margins: Word's own default when a section says nothing. */
-declare const DEFAULT_SECTION_PROPERTIES: SectionProperties;
-/**
- * Parse authored `w:pgNumType` without inventing schema defaults.
- *
- * Returns `undefined` when the element is absent. An empty element yields `{}` so callers
- * can tell "present but unauthored" from "missing" and serialization can re-emit empty.
- * Hostile / out-of-range attribute values are dropped rather than clamped into meaning.
- */
-declare function parsePageNumbering(sectPr: OoxmlNode): SectionPageNumbering | undefined;
-/** Parse one `w:sectPr` into geometry/break properties (null reads as Word's defaults). */
-declare function parseSectionProperties(sectPr: OoxmlNode | null | undefined): SectionProperties;
-/** `w:sectPr` nested under a paragraph's `w:pPr`, if present. */
-declare function paragraphSectionNode(paragraph: OoxmlElement): OoxmlElement | undefined;
-/**
- * The section properties a part declares, or Word's defaults where it says nothing.
- *
- * Returns the FINAL section (body-level `w:sectPr`, else the last paragraph-level one).
- * Multi-section geometry belongs to `enumerateDocumentSections`; chrome that needs "the
- * document's page" still reads the last section, which is what Word's body-level sectPr is.
- */
-declare function readSectionProperties(part: OoxmlPart): SectionProperties;
-/**
- * Split the body story into sections.
- *
- * A paragraph carrying `w:pPr/w:sectPr` ends the current section (that paragraph is IN the
- * section being ended). The body-level `w:sectPr` ends the final section. A document with
- * neither yields one section of Word defaults covering every block.
- *
- * Enumeration is capped at {@link MAX_DOCUMENT_SECTIONS}. Further paragraph-level section
- * breaks are ignored and remaining blocks fold into the last accepted section (fail closed).
- *
- * `displayMode` MUST match the one the caller passes to `storyBlocks`. `blockStart` /
- * `blockEndExclusive` are indices into that list, and the list changes shape with the mode:
- * the proposed view drops a paragraph whose mark and content a revision both removed. Slicing
- * a filtered list with indices counted over an unfiltered one puts body text under another
- * section's page geometry — the wrong paper size, the wrong margins, the wrong header.
- */
-declare function enumerateDocumentSections(part: OoxmlPart, displayMode?: RevisionDisplayMode, authorFilter?: RevisionAuthorFilter): DocumentSection[];
-/**
- * Canonical section index behind each section in a revision-projected body.
- *
- * A removed paragraph mark can collapse an entire section. The projected section keeps the
- * surviving paragraph's geometry, while package APIs such as header/footer resolution remain
- * indexed over the canonical tree. This bridge prevents those two index spaces from being
- * paired positionally.
- */
-declare function projectedSectionSourceIndexes(part: OoxmlPart, displayMode?: RevisionDisplayMode, authorFilter?: RevisionAuthorFilter): readonly number[];
-/**
- * Every section in a document, with a flag saying whether the list was cut short.
- *
- * `truncated` is reported rather than silent: section count comes from a file, so a crafted
- * document declaring thousands of paragraph-level `w:sectPr` marks is bounded, and a reader
- * should be able to tell that happened.
- */
-interface DocumentSectionsEnumeration {
-    readonly sections: DocumentSection[];
-    /** True when paragraph-level sectPr marks beyond {@link MAX_DOCUMENT_SECTIONS} were dropped. */
-    readonly truncated: boolean;
-}
-/**
- * Like {@link enumerateDocumentSections}, but reports whether the section bound clipped
- * hostile input. Prefer the plain enumerator for normal layout; use this when a caller
- * needs a named fail-closed diagnostic.
- */
-declare function enumerateDocumentSectionsBounded(part: OoxmlPart, displayMode?: RevisionDisplayMode, authorFilter?: RevisionAuthorFilter): DocumentSectionsEnumeration;
-/**
- * Section properties as the geometry layout paginates against.
- *
- * The gutter is added to the LEFT margin: it is binding allowance, extra space on the inner
- * edge, and folding it into the content width instead would silently narrow every line.
- *
- * Top and bottom keep the authored sign of `w:pgMar`: a negative value is an exact inset that
- * header and footer height never moves. Read them through `page-body-margins.ts`.
- */
-declare function geometryOfSection(section: SectionProperties): PageGeometry;
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-kR_QB845.js';
+import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, g as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, h as TableRowFragmentRecord, i as TableCellFragmentRecord } from './semantic-records-DQmumPgL.js';
 
 /** A point in the coordinate space named by the function taking it. */
 interface HitPoint {
@@ -310,8 +103,10 @@ declare function hitTestSheet(layout: SemanticLayout, point: HitPoint, options?:
  */
 declare function contentControlAtPoint(layout: SemanticLayout, pageIndex: number, point: HitPoint): ContentControlBoundaryRecord | null;
 /**
- * Logical line end, excluding the wrap space or hard break whose following position
- * belongs to the next line. Page breaks are excluded even on the paragraph's last line.
+ * Logical line end, excluding a hard break, whose following position belongs to the next line.
+ * Trailing spaces of a soft wrap stay on the line: the end is after them, where End puts the
+ * caret, and the caret shows on this line through its line affinity. Page breaks are excluded
+ * even on the paragraph's last line.
  */
 declare function lineEndOffset(layout: SemanticLayout, line: LineRecord): number;
 /**
@@ -458,5 +253,5 @@ interface TableCellContext {
  */
 declare function tableContextAt(layout: SemanticLayout, paragraphId: string): TableCellContext | null;
 
-export { isFurniturePoint as A, lineEndOffset as B, DEFAULT_PAGE_GEOMETRY as D, pageAtY as E, paragraphSectionNode as F, paragraphsInCells as G, parsePageNumbering as I, parseSectionProperties as J, projectedSectionSourceIndexes as K, readSectionProperties as L, MAX_DOCUMENT_SECTIONS as M, spanOffsetX as N, spansInCells as O, tableContextAt as Q, DEFAULT_SECTION_PROPERTIES as b, DEFAULT_VERTICAL_WEIGHT as c, caretBoxOnLine as p, cellSelectionBetween as q, cellSelectionRects as r, cellSelectionText as s, contentControlAtPoint as t, enumerateDocumentSections as u, enumerateDocumentSectionsBounded as v, findDrawingOverlayFrameInLayout as w, geometryOfSection as x, hitTestPage as y, hitTestSheet as z };
-export type { CellSelection as C, HitPoint as H, PageGeometry as P, SectionProperties as S, TableCellAddress as T, SectionColumns as a, DocumentSection as d, DocumentSectionsEnumeration as e, DrawingOverlayFrame as f, HitTestOptions as g, PlacedCell as h, SectionBreakType as i, SectionColumnDefinition as j, SectionMargins as k, SectionPageNumbering as l, SemanticHit as m, SemanticHitDrawing as n, TableCellContext as o };
+export { DEFAULT_VERTICAL_WEIGHT as D, caretBoxOnLine as e, cellSelectionBetween as f, cellSelectionRects as g, cellSelectionText as h, contentControlAtPoint as i, findDrawingOverlayFrameInLayout as j, hitTestPage as k, hitTestSheet as l, isFurniturePoint as m, lineEndOffset as n, paragraphsInCells as o, pageAtY as p, spansInCells as q, spanOffsetX as s, tableContextAt as t };
+export type { CellSelection as C, HitPoint as H, PlacedCell as P, SemanticHit as S, TableCellAddress as T, DrawingOverlayFrame as a, HitTestOptions as b, SemanticHitDrawing as c, TableCellContext as d };

package/dist/{semantic-interaction-G0bjmmmk.d.ts → semantic-interaction-kR_QB845.d.ts}

@@ -1,4 +1,17 @@
-import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, e as StyleSpanRecord } from './semantic-records-B9OolWGN.js';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, g as StyleSpanRecord } from './semantic-records-DQmumPgL.js';
+
+/** How `moveCaret` resolves a motion. */
+interface MoveCaretOptions {
+    /** Precomputed active-story stops; body navigation keeps the indexed default. */
+    readonly stops?: readonly CaretGeometry[];
+    readonly measurer?: TextMeasurer;
+    /**
+     * The line the caret shows on (its line affinity), for an offset that ends one wrapped line
+     * and starts the next. Home, End, Up, and Down then start from that line. A line that does
+     * not hold the offset is ignored, and the default line for the offset applies.
+     */
+    readonly lineId?: string;
+}
 
 /** A caret position in the model. */
 interface SemanticPosition {
@@ -56,35 +69,12 @@ interface CaretAtOptions {
      * (shared header/footer copies).
      */
     readonly preferredPageIndex?: number;
+    /** Prefer this visual line when one model boundary has several painted occurrences. */
+    readonly preferredLineId?: string;
 }
 /** Geometry for one model position, or null when it is not laid out. */
 declare function caretAt(layout: SemanticLayout, position: SemanticPosition, measurerOrOptions?: TextMeasurer | CaretAtOptions): CaretGeometry | null;
-/**
- * The caret position nearest a point, in PAGE-CONTENT coordinates.
- *
- * Never returns null for a point inside the document: a click in the margin, past the end of
- * a line, or below the last line still has an obvious intended caret, and refusing to answer
- * would make those clicks do nothing.
- *
- * The rules live in `semantic-hit-test.ts`, which answers with the cell address and the
- * on-glyphs flag a pointer controller needs too; this keeps the geometry-only shape for
- * callers that want nothing else.
- */
-declare function hitTestSemantic(layout: SemanticLayout, point: {
-    readonly x: number;
-    readonly y: number;
-    readonly pageIndex?: number;
-}): CaretGeometry | null;
-/**
- * Innermost content-control boundary at a page-content point, or null outside every control.
- *
- * Prefers the deepest nesting depth when nested boundaries share geometry.
- */
-declare function contentControlAtSemantic(layout: SemanticLayout, point: {
-    readonly x: number;
-    readonly y: number;
-    readonly pageIndex?: number;
-}): ContentControlBoundaryRecord | null;
+
 /** Layout-published content-control boundaries in document order. */
 declare function contentControlsInLayout(layout: SemanticLayout): readonly ContentControlBoundaryRecord[];
 /**
@@ -104,16 +94,17 @@ type NavigationCommand = 'left' | 'right' | 'up' | 'down' | 'wordLeft' | 'wordRi
 declare function paragraphTextFromLayout(layout: SemanticLayout, paragraphId: string): string;
 /** Visible deletion boundaries split words without changing canonical text offsets. */
 declare function deletedTextBoundaries(layout: SemanticLayout, paragraphId: string): ReadonlySet<number>;
-/** Story-scoped stops are required when navigating inside an open header or footer. */
-interface MoveCaretOptions {
-    /** Precomputed active-story stops; body navigation keeps the indexed default. */
-    readonly stops?: readonly CaretGeometry[];
-    readonly measurer?: TextMeasurer;
-}
+
 /** Move a caret; vertical movement carries a desired X through shorter lines. */
 declare function moveCaret(layout: SemanticLayout, position: SemanticPosition, command: NavigationCommand, desiredX?: number | null, options?: MoveCaretOptions): {
     position: SemanticPosition;
     desiredX: number | null;
+    /**
+     * The line the caret shows on after the motion, when it is not the default line for the
+     * position (End at a wrap shows on the upper line). Pass it back as
+     * {@link MoveCaretOptions.lineId} and as `CaretAtOptions.preferredLineId`.
+     */
+    lineId?: string;
 } | null;
 /**
  * The anchor an IME composition is attached to.
@@ -140,5 +131,5 @@ declare function spansInSelection(layout: SemanticLayout, selection: SemanticSel
  */
 order: readonly string[]): StyleSpanRecord[];
 
-export { caretAt as d, caretStops as e, caretStopsForBlocks as f, compositionAnchor as g, contentControlAtSemantic as h, contentControlsInLayout as i, deletedTextBoundaries as j, hitTestSemantic as k, moveCaret as m, paragraphTextFromLayout as p, spansInSelection as s };
+export { caretAt as d, caretStops as e, caretStopsForBlocks as f, compositionAnchor as g, contentControlsInLayout as h, deletedTextBoundaries as i, moveCaret as m, paragraphTextFromLayout as p, spansInSelection as s };
 export type { CaretGeometry as C, MoveCaretOptions as M, NavigationCommand as N, SemanticPosition as S, SemanticSelection as a, SelectionRect as b, CaretAtOptions as c };

package/dist/{semantic-paint-CsMzF8-O.d.ts → semantic-paint-ZayFF3tD.d.ts}

@@ -1,7 +1,6 @@
-import { d as ResolvedRevisionMarkup } from './revision-projection-CSNFudZY.js';
-import { a as PageRecord, C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-B9OolWGN.js';
-import { S as SemanticRootStoryKind } from './semantic-record-queries-1du6lQqS.js';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-BDFxcu7W.js';
+import { c as PageRecord, q as ResolvedRevisionMarkup, C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-DQmumPgL.js';
+import { S as SemanticRootStoryKind } from './semantic-record-queries-Bsgth6lv.js';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-tXLQShoC.js';
 
 /**
  * Everything a host can say about ONE author's presentation. Every field is optional and
@@ -137,6 +136,17 @@ interface DrawingPaintStrings {
     readonly pendingResource: string;
 }
 
+/** Localized break labels; adapters supply i18n-backed implementations. */
+interface BreakMarkStrings {
+    readonly pageBreak: string;
+    readonly columnBreak: string;
+    readonly sectionBreakContinuous: string;
+    readonly sectionBreakNextPage: string;
+    readonly sectionBreakEvenPage: string;
+    readonly sectionBreakOddPage: string;
+    readonly sectionBreakNextColumn: string;
+}
+
 /** Which bars a paint draws. @public */
 type ChangeBarsMode = 'all-markup' | 'simple-markup' | 'none';
 /** Which story a bar stands beside; the header-editing chrome dims every other story's. */
@@ -220,6 +230,8 @@ interface PaintOptions {
     readonly fieldShading?: FieldShadingMode;
     /** Paint paragraph-end and manual-line-break furniture. Tracked marks also follow Show/Hide. */
     readonly showParagraphMarks?: boolean;
+    /** Localized labels for the break furniture paragraph marks show (defaults to English). */
+    readonly breakMarkStrings?: BreakMarkStrings;
     /** See {@link PaintContext.shadeFormFields}. */
     readonly shadeFormFields?: boolean;
     /**
@@ -323,4 +335,4 @@ interface PaintOptions {
 declare function paintSemanticLayout(container: HTMLElement, layout: SemanticLayout, options?: PaintOptions): void;
 
 export { DEFAULT_FIELD_SHADING as D, collectPageChangeBars as e, paintSemanticLayout as p };
-export type { ChangeBarsMode as C, FieldShadingMode as F, PageChangeBars as P, ReviewAuthorInfo as R, PaintOptions as a, RevisionAuthorAssignments as b, RevisionAuthorStyle as c, RevisionStyles as d, DrawingPaintStrings as f };
+export type { BreakMarkStrings as B, ChangeBarsMode as C, FieldShadingMode as F, PageChangeBars as P, ReviewAuthorInfo as R, PaintOptions as a, RevisionAuthorAssignments as b, RevisionAuthorStyle as c, RevisionStyles as d, DrawingPaintStrings as f };

package/dist/{semantic-record-queries-1du6lQqS.d.ts → semantic-record-queries-Bsgth6lv.d.ts}

@@ -1,4 +1,4 @@
-import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, P as ParagraphFragmentRecord, L as LineRecord, a as PageRecord, N as NoteAreaRecord, b as LayoutBox, H as HeaderFooterStoryRecord, c as NoteStoryRecord, B as BlockFragmentRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, d as ContentControlLock } from './semantic-records-B9OolWGN.js';
+import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, P as ParagraphFragmentRecord, L as LineRecord, c as PageRecord, N as NoteAreaRecord, d as LayoutBox, H as HeaderFooterStoryRecord, e as NoteStoryRecord, B as BlockFragmentRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, f as ContentControlLock } from './semantic-records-DQmumPgL.js';
 
 /**
  * Depth-first paragraph fragments of one page, in reading order.