@productcloudos/editor 1.0.0

package/dist/types/lib/text/TextFormatting.d.ts

@@ -0,0 +1,85 @@
+import { EventEmitter } from '../events/EventEmitter';
+import { TextFormattingStyle } from './types';
+/**
+ * Manages per-character text formatting.
+ * Stores formatting overrides for specific character positions.
+ */
+export declare class TextFormattingManager extends EventEmitter {
+    private formatting;
+    private _defaultFormatting;
+    private _pendingFormatting;
+    constructor(defaultFormatting?: Partial<TextFormattingStyle>);
+    /**
+     * Get the default formatting applied to unformatted text.
+     */
+    get defaultFormatting(): TextFormattingStyle;
+    /**
+     * Update the default formatting.
+     */
+    setDefaultFormatting(formatting: Partial<TextFormattingStyle>): void;
+    /**
+     * Get formatting at a specific character position.
+     * Returns the position-specific formatting or the default.
+     */
+    getFormattingAt(position: number): TextFormattingStyle;
+    /**
+     * Apply formatting to a range of characters.
+     * @param start Start position
+     * @param end End position
+     * @param formatting Formatting to apply
+     * @param silent If true, don't emit the formatting-changed event (used for inherited formatting during text insertion)
+     */
+    applyFormatting(start: number, end: number, formatting: Partial<TextFormattingStyle>, silent?: boolean): void;
+    /**
+     * Remove formatting from a range, reverting to default.
+     */
+    clearFormatting(start: number, end: number): void;
+    /**
+     * Shift formatting positions when text is inserted or deleted.
+     * @param fromIndex The position where the change occurred
+     * @param delta Positive for insertion, negative for deletion
+     */
+    shiftFormatting(fromIndex: number, delta: number): void;
+    /**
+     * Remove formatting for deleted text range and shift remaining.
+     * @param start Start of deleted range
+     * @param length Length of deleted text
+     */
+    handleDeletion(start: number, length: number): void;
+    /**
+     * Get all formatting entries (for serialization).
+     */
+    getAllFormatting(): Map<number, TextFormattingStyle>;
+    /**
+     * Restore formatting from a map (for deserialization).
+     */
+    setAllFormatting(formatting: Map<number, TextFormattingStyle>): void;
+    /**
+     * Clear all formatting.
+     */
+    clear(): void;
+    /**
+     * Set pending formatting to apply to the next inserted character.
+     * Used when formatting is applied with just a cursor (no selection).
+     */
+    setPendingFormatting(formatting: Partial<TextFormattingStyle>): void;
+    /**
+     * Get the current pending formatting, if any.
+     */
+    getPendingFormatting(): Partial<TextFormattingStyle> | null;
+    /**
+     * Check if there is pending formatting.
+     */
+    hasPendingFormatting(): boolean;
+    /**
+     * Clear pending formatting.
+     */
+    clearPendingFormatting(): void;
+    /**
+     * Apply pending formatting to a range.
+     * Called when text is inserted. Does NOT clear pending formatting
+     * so it can be applied to subsequent typed characters.
+     */
+    applyPendingFormatting(start: number, length: number): void;
+}
+//# sourceMappingURL=TextFormatting.d.ts.map

package/dist/types/lib/text/TextFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextFormatting.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/TextFormatting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,SAAS,CAAC;AAElE;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,kBAAkB,CAA6C;gBAE3D,iBAAiB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAK5D;;OAEG;IACH,IAAI,iBAAiB,IAAI,mBAAmB,CAE3C;IAED;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAKpE;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAQtD;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI;IAUpH;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAOjD;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAuBvD;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUnD;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAIpD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,IAAI;IAKpE;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;OAGG;IACH,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IASpE;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAO9B;;;;OAIG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAO5D"}

package/dist/types/lib/text/TextLayout.d.ts

@@ -0,0 +1,126 @@
+import { TextMeasurer } from './TextMeasurer';
+import { TextFormattingManager } from './TextFormatting';
+import { ParagraphFormattingManager } from './ParagraphFormatting';
+import { SubstitutionFieldManager } from './SubstitutionFieldManager';
+import { EmbeddedObjectManager } from './EmbeddedObjectManager';
+import { FlowedPage } from './types';
+/**
+ * Context for text layout operations.
+ */
+export interface LayoutContext {
+    availableWidth: number;
+    availableHeight: number;
+    measurer: TextMeasurer;
+    formatting: TextFormattingManager;
+    paragraphFormatting: ParagraphFormattingManager;
+    substitutionFields: SubstitutionFieldManager;
+    embeddedObjects: EmbeddedObjectManager;
+    content: string;
+}
+/**
+ * Handles text layout: line breaking and page flow.
+ * This is the core algorithm for flowing text across multiple lines and pages.
+ */
+export declare class TextLayout {
+    /**
+     * Flow text content into pages based on available dimensions.
+     */
+    flowText(content: string, context: LayoutContext): FlowedPage[];
+    /**
+     * Split content by newline and page break characters.
+     */
+    private splitIntoLogicalLines;
+    /**
+     * Wrap a single logical line into one or more visual lines.
+     * Handles per-character formatting by creating separate runs when formatting changes.
+     * Uses a segment-based approach for more robust line breaking.
+     */
+    private wrapLogicalLine;
+    /**
+     * Create a dedicated line for a block-positioned object.
+     */
+    private createBlockObjectLine;
+    /**
+     * Split text into segments at whitespace boundaries, measuring each segment.
+     */
+    private splitIntoSegments;
+    /**
+     * Measure a segment of text, creating runs for formatting changes.
+     */
+    private measureSegment;
+    /**
+     * Add a segment to a line, adjusting x positions.
+     */
+    private addSegmentToLine;
+    /**
+     * Compare two formatting objects for equality.
+     */
+    private formattingEquals;
+    /**
+     * Create a new line builder with default values.
+     */
+    private createLineBuilder;
+    /**
+     * Finalize a line builder into a FlowedLine.
+     */
+    private finalizeLineBuilder;
+    /**
+     * Count word gaps in text (transitions from word to whitespace).
+     */
+    private countWordGaps;
+    /**
+     * Get the width of a line excluding trailing whitespace.
+     */
+    private getTrimmedLineWidth;
+    /**
+     * Create an empty line for newline-only content.
+     */
+    private createEmptyLine;
+    /**
+     * Create an empty page with one empty line.
+     */
+    private createEmptyPage;
+    /**
+     * Split lines into pages based on available height.
+     */
+    private paginateLines;
+    /**
+     * Find which page and line contains a given text index.
+     */
+    findPositionForIndex(pages: FlowedPage[], textIndex: number): {
+        pageIndex: number;
+        lineIndex: number;
+    } | null;
+    /**
+     * Get all paragraph boundaries in the content.
+     * Returns indices that are valid start points for repeating sections:
+     * - Index 0 (start of content)
+     * - Index immediately after each newline character
+     */
+    getParagraphBoundaries(content: string): number[];
+    /**
+     * Calculate total indent for a list nesting level.
+     */
+    private calculateListIndent;
+    /**
+     * Get the marker text for a list item.
+     */
+    private getListMarkerText;
+    /**
+     * Get bullet character based on style and nesting level.
+     */
+    private getBulletCharacter;
+    /**
+     * Format a number according to the numbering style.
+     */
+    private formatNumber;
+    /**
+     * Convert a number to alphabetic representation (1=a, 2=b, ... 26=z, 27=aa, ...)
+     */
+    private toAlpha;
+    /**
+     * Convert a number to Roman numerals.
+     */
+    private toRoman;
+}
+//# sourceMappingURL=TextLayout.d.ts.map

package/dist/types/lib/text/TextLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextLayout.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/TextLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAIL,UAAU,EAUX,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,qBAAqB,CAAC;IAClC,mBAAmB,EAAE,0BAA0B,CAAC;IAChD,kBAAkB,EAAE,wBAAwB,CAAC;IAC7C,eAAe,EAAE,qBAAqB,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD;;;GAGG;AACH,qBAAa,UAAU;IACrB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,EAAE;IA4D/D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAmIvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuEzB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2LtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmC3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiGrB;;OAEG;IACH,oBAAoB,CAClB,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAuBlD;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBjD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,CAAC,OAAO;CAgBhB"}

package/dist/types/lib/text/TextMeasurer.d.ts

@@ -0,0 +1,107 @@
+import { TextFormattingStyle, SubstitutionField } from './types';
+import { BaseEmbeddedObject } from '../objects';
+/**
+ * Result of measuring embedded content at a position.
+ */
+export interface EmbeddedMeasurement {
+    width: number;
+    height: number;
+    type: 'field' | 'object' | 'none';
+    field?: SubstitutionField;
+    object?: BaseEmbeddedObject;
+}
+/**
+ * Encapsulates all text measurement operations.
+ * Single source of truth for font string generation and text metrics.
+ */
+export declare class TextMeasurer {
+    private ctx;
+    private fontCache;
+    constructor(ctx: CanvasRenderingContext2D);
+    /**
+     * Convert formatting to a CSS font string.
+     * This is the canonical implementation - all other code should use this.
+     */
+    toFontString(formatting: TextFormattingStyle): string;
+    /**
+     * Measure the width of text with given formatting.
+     */
+    measureText(text: string, formatting: TextFormattingStyle): number;
+    /**
+     * Measure a single character width.
+     * Handles special characters like tabs.
+     */
+    measureCharacter(char: string, formatting: TextFormattingStyle): number;
+    /**
+     * Calculate the line height for given formatting.
+     */
+    getLineHeight(formatting: TextFormattingStyle): number;
+    /**
+     * Calculate the baseline offset for given formatting.
+     */
+    getBaseline(formatting: TextFormattingStyle): number;
+    /**
+     * Find the character index at a given x position within text.
+     * Returns the index of the character at or just before the x position.
+     */
+    getCharacterIndexAtX(text: string, x: number, formatting: TextFormattingStyle, startIndex?: number): number;
+    /**
+     * Get the x position for a character index within text.
+     */
+    getXPositionForIndex(text: string, index: number, formatting: TextFormattingStyle, startIndex?: number): number;
+    /**
+     * Update the canvas context (e.g., when switching pages).
+     */
+    setContext(ctx: CanvasRenderingContext2D): void;
+    /**
+     * Get the display text for a substitution field.
+     * @param field The substitution field
+     * @param pageNumber Optional current page number (1-based) for page number fields
+     * @param pageCount Optional total page count for page count fields
+     */
+    getFieldDisplayText(field: SubstitutionField, pageNumber?: number, pageCount?: number): string;
+    /**
+     * Measure a substitution field's display text.
+     * @param field The substitution field
+     * @param defaultFormatting Default formatting to use if field has none
+     * @param pageNumber Optional current page number (1-based) for page number fields
+     * @param pageCount Optional total page count for page count fields
+     */
+    measureSubstitutionField(field: SubstitutionField, defaultFormatting?: TextFormattingStyle, pageNumber?: number, pageCount?: number): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Measure an embedded object.
+     */
+    measureEmbeddedObject(object: BaseEmbeddedObject): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Measure embedded content at a specific position.
+     * Checks both substitution fields and embedded objects.
+     */
+    measureEmbeddedAt(textIndex: number, fields: Map<number, SubstitutionField>, objects: Map<number, BaseEmbeddedObject>, defaultFormatting?: TextFormattingStyle): EmbeddedMeasurement;
+    /**
+     * Measure a word, accounting for both substitution fields and embedded objects.
+     * Returns the total width including all embedded content widths, plus x offsets
+     * for each field and object within the word.
+     */
+    measureWordWithEmbedded(word: string, formatting: TextFormattingStyle, fields: Map<number, SubstitutionField>, objects: Map<number, BaseEmbeddedObject>, wordStartIndex: number): {
+        width: number;
+        height: number;
+        fields: Array<{
+            field: SubstitutionField;
+            textIndex: number;
+            width: number;
+            xOffset: number;
+        }>;
+        objects: Array<{
+            object: BaseEmbeddedObject;
+            textIndex: number;
+            xOffset: number;
+        }>;
+    };
+}
+//# sourceMappingURL=TextMeasurer.d.ts.map

package/dist/types/lib/text/TextMeasurer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextMeasurer.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/TextMeasurer.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/text/TextPositionCalculator.d.ts

@@ -0,0 +1,72 @@
+import { FlowedLine, TextFormattingStyle } from './types';
+/**
+ * Result of finding a line at a Y position.
+ */
+export interface LineAtYResult {
+    line: FlowedLine;
+    lineIndex: number;
+    lineY: number;
+}
+/**
+ * Utility class for text position calculations.
+ * Consolidates duplicated logic from FlowingTextRenderer and TextBoxObject.
+ * All methods are static - no instance state required.
+ */
+export declare class TextPositionCalculator {
+    /**
+     * Build a CSS font string from formatting properties.
+     */
+    static getFontString(formatting: TextFormattingStyle): string;
+    /**
+     * Calculate the alignment offset for a line.
+     * @param line The flowed line
+     * @param maxWidth The available width for the line
+     * @returns The X offset to apply before rendering the line
+     */
+    static getAlignmentOffset(line: FlowedLine, maxWidth: number): number;
+    /**
+     * Find which line is at a given Y position.
+     * @param flowedLines Array of flowed lines
+     * @param y Y position relative to the top of the first line
+     * @returns The line info or null if y is outside the lines
+     */
+    static findLineAtY(flowedLines: FlowedLine[], y: number): LineAtYResult | null;
+    /**
+     * Get the X position for a text index within a line.
+     * Does NOT include alignment offset - caller should add that separately.
+     *
+     * @param line The flowed line
+     * @param textIndex The text index to find the X position for
+     * @param ctx Canvas context for text measurement (must have font set per-run)
+     * @returns The X position relative to the line start (before alignment)
+     */
+    static getXPositionForTextIndex(line: FlowedLine, textIndex: number, ctx: CanvasRenderingContext2D): number;
+    /**
+     * Get the text index at an X position within a line.
+     * The x parameter should NOT include alignment offset - caller should subtract that first.
+     *
+     * @param line The flowed line
+     * @param x X position relative to line start (after removing alignment offset)
+     * @param ctx Canvas context for text measurement
+     * @returns The text index at that position
+     */
+    static getTextIndexAtX(line: FlowedLine, x: number, ctx: CanvasRenderingContext2D): number;
+    /**
+     * Get the width of a character, handling special cases like substitution fields,
+     * embedded objects, tabs, and orphaned replacement characters.
+     */
+    private static getCharWidth;
+    /**
+     * Build a map of substitution fields by text index for quick lookup.
+     */
+    private static buildSubstitutionFieldMap;
+    /**
+     * Build a map of embedded objects by text index for quick lookup.
+     */
+    private static buildEmbeddedObjectMap;
+    /**
+     * Count word gaps up to a certain text index for justify spacing calculation.
+     */
+    private static countWordGapsUpTo;
+}
+//# sourceMappingURL=TextPositionCalculator.d.ts.map

package/dist/types/lib/text/TextPositionCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextPositionCalculator.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/TextPositionCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiD,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEzG;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM;IAI7D;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAarE;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IA0B9E;;;;;;;;OAQG;IACH,MAAM,CAAC,wBAAwB,CAC7B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,wBAAwB,GAC5B,MAAM;IA6CT;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CACpB,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,wBAAwB,GAC5B,MAAM;IAyDT;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA+B3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAQxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAqBjC"}

package/dist/types/lib/text/TextState.d.ts

@@ -0,0 +1,236 @@
+import { EventEmitter } from '../events/EventEmitter';
+/**
+ * Callback to check if a position contains a substitution field.
+ */
+export type FieldCheckCallback = (textIndex: number) => boolean;
+/**
+ * Pure state container for text content and cursor position.
+ * Handles text manipulation operations and emits change events.
+ * Supports cursor skipping over substitution fields.
+ */
+export declare class TextState extends EventEmitter {
+    private content;
+    private cursorPosition;
+    private fieldCheckCallback;
+    private selectionAnchor;
+    constructor(initialContent?: string);
+    /**
+     * Set a callback to check if a position contains a substitution field.
+     * Used for cursor skipping behavior.
+     */
+    setFieldCheckCallback(callback: FieldCheckCallback | null): void;
+    /**
+     * Check if a character is the object replacement character.
+     */
+    private isReplacementChar;
+    /**
+     * Check if a position contains a substitution field.
+     */
+    private isFieldAt;
+    /**
+     * Get the current text content.
+     */
+    getText(): string;
+    /**
+     * Set the entire text content.
+     */
+    setText(text: string): void;
+    /**
+     * Insert text at a specific position or at the cursor.
+     * @returns The position after the inserted text
+     */
+    insertText(text: string, position?: number): number;
+    /**
+     * Delete text from a range.
+     * @returns The removed text
+     */
+    deleteText(start: number, length: number): string;
+    /**
+     * Perform a backspace operation at the current cursor position.
+     * If cursor is immediately after a substitution field, deletes the entire field.
+     * @returns True if something was deleted, false otherwise
+     */
+    backspace(): boolean;
+    /**
+     * Perform a delete operation at the current cursor position.
+     * If cursor is at a substitution field, deletes the entire field.
+     * @returns True if something was deleted, false otherwise
+     */
+    deleteForward(): boolean;
+    /**
+     * Get the current cursor position.
+     */
+    getCursorPosition(): number;
+    /**
+     * Set the cursor position directly.
+     * Note: This does not skip over substitution fields - use moveCursorLeft/Right
+     * for navigation that should skip fields.
+     */
+    setCursorPosition(position: number): void;
+    /**
+     * Move cursor by a delta, skipping over substitution fields.
+     */
+    moveCursor(delta: number): void;
+    /**
+     * Move cursor left, skipping over substitution fields.
+     * When cursor is after a field, it moves to before the field.
+     */
+    moveCursorLeft(): void;
+    /**
+     * Move cursor right, skipping over substitution fields.
+     * When cursor is before a field, it moves to after the field.
+     */
+    moveCursorRight(): void;
+    /**
+     * Get the length of the content.
+     */
+    get length(): number;
+    /**
+     * Check if the content is empty.
+     */
+    get isEmpty(): boolean;
+    /**
+     * Get a character at a specific position.
+     */
+    charAt(position: number): string;
+    /**
+     * Get a substring of the content.
+     */
+    substring(start: number, end?: number): string;
+    /**
+     * Find the index of a substring.
+     */
+    indexOf(searchString: string, position?: number): number;
+    /**
+     * Clear all content.
+     */
+    clear(): void;
+    /**
+     * Set the selection anchor point.
+     * Call this when starting a selection (e.g., shift key pressed).
+     */
+    setSelectionAnchor(position?: number): void;
+    /**
+     * Get the current selection range.
+     * Returns null if no selection is active.
+     */
+    getSelection(): {
+        start: number;
+        end: number;
+    } | null;
+    /**
+     * Check if there is an active selection.
+     */
+    hasSelection(): boolean;
+    /**
+     * Check if the selection anchor is set (even if cursor equals anchor).
+     */
+    hasSelectionAnchor(): boolean;
+    /**
+     * Clear the selection anchor.
+     */
+    clearSelection(): void;
+    /**
+     * Get the selected text content.
+     */
+    getSelectedText(): string;
+    /**
+     * Delete the selected text and clear selection.
+     * Returns true if text was deleted.
+     */
+    deleteSelection(): boolean;
+    /**
+     * Move cursor left while extending selection.
+     */
+    selectLeft(): void;
+    /**
+     * Move cursor right while extending selection.
+     */
+    selectRight(): void;
+    /**
+     * Emit selection change event.
+     */
+    private emitSelectionChange;
+    /**
+     * Check if character is a word character (alphanumeric or underscore).
+     * Includes accented characters common in European languages.
+     */
+    private isWordChar;
+    /**
+     * Find word boundaries at a text position.
+     * Words are sequences of alphanumeric characters, not including spaces/punctuation.
+     */
+    getWordBoundaries(position: number): {
+        start: number;
+        end: number;
+    };
+    /**
+     * Find paragraph boundaries at a text position.
+     * Paragraphs are delimited by newline characters.
+     */
+    getParagraphBoundaries(position: number): {
+        start: number;
+        end: number;
+    };
+    /**
+     * Select the word at the current cursor position.
+     */
+    selectWord(): void;
+    /**
+     * Select the paragraph at the current cursor position.
+     */
+    selectParagraph(): void;
+    /**
+     * Select all text content.
+     */
+    selectAll(): void;
+    /**
+     * Move cursor to the start of the current line.
+     */
+    moveCursorToLineStart(): void;
+    /**
+     * Move cursor to the end of the current line.
+     */
+    moveCursorToLineEnd(): void;
+    /**
+     * Move cursor to the start of the document.
+     */
+    moveCursorToDocumentStart(): void;
+    /**
+     * Move cursor to the end of the document.
+     */
+    moveCursorToDocumentEnd(): void;
+    /**
+     * Select from current cursor to line start.
+     */
+    selectToLineStart(): void;
+    /**
+     * Select from current cursor to line end.
+     */
+    selectToLineEnd(): void;
+    /**
+     * Select from current cursor to document start.
+     */
+    selectToDocumentStart(): void;
+    /**
+     * Select from current cursor to document end.
+     */
+    selectToDocumentEnd(): void;
+    /**
+     * Move cursor to the start of the previous word.
+     */
+    moveCursorWordLeft(): void;
+    /**
+     * Move cursor to the start of the next word.
+     */
+    moveCursorWordRight(): void;
+    /**
+     * Select word left from current position.
+     */
+    selectWordLeft(): void;
+    /**
+     * Select word right from current position.
+     */
+    selectWordRight(): void;
+}
+//# sourceMappingURL=TextState.d.ts.map

package/dist/types/lib/text/TextState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextState.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/TextState.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/text/index.d.ts

@@ -0,0 +1,27 @@
+export type { Focusable, TextFormattingStyle, TextRun, SubstitutionField, SubstitutionFieldConfig, FlowedLine, FlowedPage, FlowedSubstitutionField, FlowedEmbeddedObject, RepeatingSection, RepeatingSectionVisualState, ObjectPosition, TextAlignment, ParagraphFormatting, ListFormatting, ListMarker, BulletStyle, NumberStyle, ListType, FieldValueType, FieldFormatConfig, NumberFormatPreset, CurrencyFormatPreset, DateFormatPreset } from './types';
+export { DEFAULT_FORMATTING, OBJECT_REPLACEMENT_CHAR } from './types';
+export { FlowingTextContent } from './FlowingTextContent';
+export { TextState } from './TextState';
+export type { FieldCheckCallback } from './TextState';
+export { TextFormattingManager } from './TextFormatting';
+export { SubstitutionFieldManager } from './SubstitutionFieldManager';
+export { EmbeddedObjectManager } from './EmbeddedObjectManager';
+export type { EmbeddedObjectEntry } from './EmbeddedObjectManager';
+export { RepeatingSectionManager } from './RepeatingSectionManager';
+export { TextMeasurer } from './TextMeasurer';
+export type { EmbeddedMeasurement } from './TextMeasurer';
+export { TextLayout } from './TextLayout';
+export type { LayoutContext } from './TextLayout';
+export { TextPositionCalculator } from './TextPositionCalculator';
+export type { LineAtYResult } from './TextPositionCalculator';
+export { BaseTextRegion } from './EditableTextRegion';
+export type { EditableTextRegion, RegionType } from './EditableTextRegion';
+export { RegionManager } from './RegionManager';
+export { HyperlinkManager } from './HyperlinkManager';
+export type { Hyperlink, HyperlinkData, HyperlinkFormatting, HyperlinkOptions, HyperlinkUpdate } from './HyperlinkManager';
+export { BodyTextRegion, HeaderTextRegion, FooterTextRegion } from './regions';
+export type { PageBoundsProvider, HeaderBoundsProvider, FooterBoundsProvider } from './regions';
+export { formatFieldValue, isMarkdownFormat, getFormatDisplayName } from './FieldFormatter';
+export { parseMarkdown, applyMarkdownFormatting, containsMarkdown, stripMarkdown } from './MarkdownParser';
+export type { MarkdownSegment, MarkdownSegmentType, ParsedMarkdown } from './MarkdownParser';
+//# sourceMappingURL=index.d.ts.map