@productcloudos/editor 1.0.0

package/dist/types/lib/rendering/FlowingTextRenderer.d.ts

@@ -0,0 +1,348 @@
+import { FlowedPage, FlowedLine, FlowedSubstitutionField, RepeatingSection, EditableTextRegion } from '../text';
+import { Document } from '../core/Document';
+import { Page } from '../core/Page';
+import { Point, Rect, EditingSection } from '../types';
+import { EventEmitter } from '../events/EventEmitter';
+import { BaseEmbeddedObject, TableObject } from '../objects';
+import { HitTestManager } from '../hit-test';
+export declare class FlowingTextRenderer extends EventEmitter {
+    private document;
+    private flowedPages;
+    private headerFlowedPage;
+    private footerFlowedPage;
+    private _focusedRegion;
+    private selectedText;
+    private showControlCharacters;
+    private tableContinuations;
+    private pageTextOffsets;
+    private _hitTestManager;
+    constructor(document: Document);
+    /**
+     * Get the hit test manager for querying hit targets.
+     */
+    get hitTestManager(): HitTestManager;
+    /**
+     * Set whether control characters are shown.
+     */
+    setShowControlCharacters(show: boolean): void;
+    /**
+     * Find the cursor location (page, line) for a given text index in body content.
+     * Returns null if not found.
+     */
+    private findCursorLocationInBody;
+    /**
+     * Find the cursor location (line) for a given text index in header/footer.
+     */
+    private findCursorLocationInSection;
+    /**
+     * Calculate the cursor position for rendering.
+     * This is called on-demand during rendering instead of caching.
+     */
+    private calculateCursorPosition;
+    /**
+     * Set the focused region.
+     * This replaces the old setActiveSection method.
+     * The region provides both the FlowingTextContent and section type.
+     */
+    setFocusedRegion(region: EditableTextRegion | null): void;
+    /**
+     * Get the focused region.
+     */
+    getFocusedRegion(): EditableTextRegion | null;
+    /**
+     * Get the currently active section.
+     * Returns the section type derived from the focused region.
+     */
+    getActiveSection(): EditingSection;
+    /**
+     * Get the FlowingTextContent for the focused region.
+     */
+    private getActiveFlowingContent;
+    private setupFlowingContentListeners;
+    renderPageFlowingText(page: Page, ctx: CanvasRenderingContext2D, contentBounds: Rect): void;
+    /**
+     * Render header text content.
+     * @param page The page to get header bounds from
+     * @param ctx Canvas rendering context
+     * @param isActive Whether header is the active editing section
+     * @param region Optional region for unified rendering
+     * @param pageIndex The page index (for page number fields)
+     */
+    renderHeaderText(page: Page, ctx: CanvasRenderingContext2D, isActive: boolean, region?: EditableTextRegion, pageIndex?: number): void;
+    /**
+     * Render footer text content.
+     * @param page The page to get footer bounds from
+     * @param ctx Canvas rendering context
+     * @param isActive Whether footer is the active editing section
+     * @param region Optional region for unified rendering
+     * @param pageIndex The page index (for page number fields)
+     */
+    renderFooterText(page: Page, ctx: CanvasRenderingContext2D, isActive: boolean, region?: EditableTextRegion, pageIndex?: number): void;
+    /**
+     * Unified click handler for any EditableTextRegion.
+     *
+     * @param region The text region that was clicked
+     * @param point Click point in canvas coordinates
+     * @param pageIndex The page index where the click occurred
+     * @param ctx Canvas context for text measurement
+     * @returns Object with textIndex and lineIndex if click was in text, or null
+     */
+    handleRegionClick(region: EditableTextRegion, point: Point, pageIndex: number, ctx: CanvasRenderingContext2D): {
+        textIndex: number;
+        lineIndex: number;
+    } | null;
+    /**
+     * Get flowed lines for a region from the renderer's cache.
+     * This is the source of truth for flowed content.
+     */
+    private getFlowedLinesForRegion;
+    /**
+     * Get available width for a region.
+     */
+    private getAvailableWidthForRegion;
+    /**
+     * Unified rendering method for any EditableTextRegion.
+     * This can render body, header, footer, or text box content.
+     *
+     * @param region The text region to render
+     * @param ctx Canvas rendering context
+     * @param pageIndex The page index to render for
+     * @param options Rendering options
+     */
+    renderRegion(region: EditableTextRegion, ctx: CanvasRenderingContext2D, pageIndex: number, options?: {
+        renderCursor?: boolean;
+        renderSelection?: boolean;
+        clipToBounds?: boolean;
+    }): void;
+    /**
+     * Render selection highlight for a region.
+     */
+    private renderRegionSelection;
+    /**
+     * Render cursor for a region.
+     */
+    private renderRegionCursor;
+    private flowTextForPage;
+    private renderFlowedPage;
+    /**
+     * Render relative-positioned objects at their calculated positions.
+     * These are rendered after all text so they appear on top.
+     */
+    private renderRelativeObjects;
+    private renderFlowedLine;
+    /**
+     * Render a list marker (bullet or number) for a list item.
+     */
+    private renderListMarker;
+    /**
+     * Render a page break indicator.
+     * When control characters are enabled: Dashed line with "Page Break" label.
+     * When control characters are disabled: Subtle single-pixel horizontal rule.
+     */
+    private renderPageBreakIndicator;
+    /**
+     * Render a substitution field as styled text.
+     * Regular fields display as {{field: name}}.
+     * Page number fields display as the actual page number.
+     * Page count fields display as the total page count.
+     * Returns the new x position after rendering.
+     *
+     * Note: position.y is the TOP of the line, and line.baseline is the
+     * distance from the top to the text baseline.
+     */
+    private renderSubstitutionField;
+    /**
+     * Render an embedded object.
+     * Returns the new x position after rendering.
+     *
+     * Note: position.y is the TOP of the line. Objects are vertically
+     * centered within the line height.
+     */
+    private renderEmbeddedObject;
+    /**
+     * Render text content for table cells in a specific page slice.
+     * This handles proper positioning for cells within the slice, including
+     * header row repetition on continuation pages.
+     */
+    private renderTableCellText;
+    /**
+     * Clear table continuation tracking.
+     * Call this when reflowing text to reset multi-page table state.
+     */
+    clearTableContinuations(): void;
+    /**
+     * Check if there are pending table continuations for the next page.
+     */
+    hasTableContinuations(): boolean;
+    /**
+     * Get the Y offset for text content on a specific page.
+     * This accounts for table continuations that are rendered before text.
+     */
+    getPageTextOffset(pageIndex: number): number;
+    /**
+     * Register a table slice as a hit target.
+     * Tables are registered per-slice since they can span multiple pages.
+     */
+    private registerTableSliceHitTarget;
+    /**
+     * Update resize handle hit targets for selected objects.
+     * Call this when selection changes.
+     */
+    updateResizeHandleTargets(selectedObjects: BaseEmbeddedObject[]): void;
+    /**
+     * Register resize handles for a regular (non-table) embedded object.
+     */
+    private registerObjectResizeHandles;
+    /**
+     * Register resize handles for a table that may span multiple pages.
+     */
+    private registerTableResizeHandles;
+    /**
+     * Update table divider hit targets for a focused table.
+     * Call this when table focus changes.
+     * @param table The focused table, or null to clear dividers
+     */
+    updateTableDividerTargets(table: TableObject | null): void;
+    /**
+     * Render table continuations for a page that has no regular text flow content.
+     * This handles the case where a table spans more pages than the text flow creates.
+     */
+    private renderTableContinuationsForPage;
+    /**
+     * Render table continuations at a specific Y position within a page.
+     * Used when there's both table continuations AND text content on the same page.
+     * Returns the total height consumed by the continuations.
+     */
+    private renderTableContinuationsAtPosition;
+    /**
+     * Draw selection border and resize handles for an embedded object.
+     * @param sizeOverride Optional size to use instead of object.size (for sliced tables)
+     * @param slicePosition Position in multi-page sequence: 'only', 'first', 'middle', 'last'
+     *                      - 'only': single page, show all handles
+     *                      - 'first': first slice, show top + side handles
+     *                      - 'middle': middle slice, show side handles only
+     *                      - 'last': last slice, show bottom + side handles
+     */
+    private drawEmbeddedObjectHandles;
+    /**
+     * Get the position of a resize handle.
+     */
+    private getHandlePosition;
+    /**
+     * Convert formatting to CSS font string.
+     * Uses the same logic as TextMeasurer for consistency.
+     */
+    private getFontString;
+    /**
+     * Calculate the X offset for a line based on its alignment.
+     */
+    private getAlignmentOffset;
+    /**
+     * Check if the cursor is positioned right after a substitution field or embedded object.
+     * This is used to hide the cursor when a field/object is "selected".
+     */
+    private isCursorAfterFieldOrObject;
+    private renderCursor;
+    private renderTextSelection;
+    private lineContainsSelection;
+    private getSelectionBoundsInLine;
+    /**
+     * Get the text index at a given point without moving the cursor.
+     * Returns null if the point is not within text content.
+     */
+    getTextIndexAtPoint(point: Point, pageId: string): number | null;
+    private getTextIndexInLine;
+    private getInlineElementAtPoint;
+    /**
+     * Get an embedded object at a specific point in a line.
+     * Note: lineY is the TOP of the line (same as position.y in render methods).
+     * lineStartX is the content area's left edge (includes margin offset).
+     */
+    getEmbeddedObjectAtPoint(line: FlowedLine, point: Point, lineY: number, lineStartX: number): BaseEmbeddedObject | null;
+    /**
+     * Get a substitution field at a specific point in a line.
+     * Note: lineY is the TOP of the line (same as position.y in render methods).
+     */
+    getSubstitutionFieldAtPoint(line: FlowedLine, point: Point, lineY: number, lineStartX: number): FlowedSubstitutionField | null;
+    private getXPositionForTextIndex;
+    /**
+     * Count word gaps up to a certain text index for justify spacing calculation.
+     */
+    private countWordGapsUpTo;
+    /**
+     * Move cursor vertically by visual lines, maintaining X position.
+     * Returns the new text index. At document boundaries, moves to start/end of text.
+     */
+    moveCursorVertical(direction: -1 | 1, pageId: string): number | null;
+    /**
+     * Move cursor vertically within a single-page section (header/footer).
+     */
+    private moveCursorVerticalInSection;
+    /**
+     * Calculate the cursor's X position relative to the section area (on-demand).
+     */
+    private calculateCursorRelativeXForSection;
+    /**
+     * Calculate the cursor's X position relative to the content area (on-demand).
+     */
+    private calculateCursorRelativeX;
+    /**
+     * Get the text index at a given visual X position on a line.
+     * The visualX is relative to the content area start (includes alignment offset).
+     * We subtract the target line's alignment offset to get X relative to text start.
+     */
+    private getTextIndexAtVisualX;
+    setTextSelection(start: number, end: number): void;
+    clearTextSelection(): void;
+    getFlowedPagesForPage(pageId: string): FlowedPage[];
+    /**
+     * Get a complete snapshot of all flowed content for PDF export.
+     * Returns body pages, header, and footer content.
+     */
+    getFlowedPagesSnapshot(): {
+        body: FlowedPage[];
+        header: FlowedPage | null;
+        footer: FlowedPage | null;
+    };
+    /**
+     * Render repeating section indicators for a page.
+     * @param sections All repeating sections
+     * @param pageIndex Current page index
+     * @param ctx Canvas rendering context
+     * @param contentBounds Content area bounds
+     * @param flowedPage The flowed page content
+     * @param pageBounds Full page bounds (including margins)
+     * @param selectedSectionId ID of the currently selected section (for visual feedback)
+     */
+    renderRepeatingSectionIndicators(sections: RepeatingSection[], pageIndex: number, ctx: CanvasRenderingContext2D, contentBounds: Rect, flowedPage: FlowedPage, pageBounds: Rect, selectedSectionId?: string | null): void;
+    /**
+     * Render a single repeating section indicator.
+     */
+    private renderSectionIndicator;
+    /**
+     * Draw the "Loop" label in a rounded rectangle.
+     * When not selected, draws an outlined rectangle.
+     * When selected, draws a filled rectangle.
+     */
+    private drawLoopLabel;
+    /**
+     * Draw a rounded rectangle path.
+     */
+    private roundRect;
+    /**
+     * Find the Y position for a text index on a flowed page.
+     * Returns the Y position at the TOP of the line containing the text index.
+     */
+    private findLineYForTextIndex;
+    /**
+     * Check if a section spans across a flowed page (starts before and ends after).
+     */
+    private sectionSpansPage;
+    /**
+     * Get a repeating section at a point (for click detection).
+     * Checks if the point is on the Loop label or vertical connector.
+     */
+    getRepeatingSectionAtPoint(point: Point, sections: RepeatingSection[], _pageIndex: number, pageBounds: Rect, contentBounds: Rect, flowedPage: FlowedPage): RepeatingSection | null;
+    destroy(): void;
+}
+//# sourceMappingURL=FlowingTextRenderer.d.ts.map

package/dist/types/lib/rendering/FlowingTextRenderer.d.ts.map

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

package/dist/types/lib/rendering/PDFGenerator.d.ts

@@ -0,0 +1,103 @@
+/**
+ * PDFGenerator - Generates PDF documents from editor content.
+ *
+ * Renders content identically to canvas but excludes UI elements like:
+ * - Cursor, selection highlight, control characters
+ * - Grid lines, margin indicators, resize handles
+ * - Repeating section indicators, loop markers
+ */
+import { Document } from '../core/Document';
+import { PDFExportOptions } from '../types';
+import { FlowedPage } from '../text/types';
+/**
+ * Snapshot of flowed content for PDF generation.
+ */
+export interface FlowedContentSnapshot {
+    body: FlowedPage[];
+    header: FlowedPage | null;
+    footer: FlowedPage | null;
+}
+export declare class PDFGenerator {
+    private fontCache;
+    /**
+     * Generate a PDF from the document.
+     *
+     * @param document The document to export
+     * @param flowedContent Snapshot of flowed text content
+     * @param options Export options
+     */
+    generate(document: Document, flowedContent?: FlowedContentSnapshot, _options?: PDFExportOptions): Promise<Blob>;
+    /**
+     * Embed standard PDF fonts for all variants we might need.
+     */
+    private embedStandardFonts;
+    /**
+     * Filter text to only include WinAnsi-compatible characters.
+     * Standard PDF fonts (Helvetica, Times, Courier) only support WinAnsi encoding.
+     * This replaces unsupported characters with a placeholder or removes them.
+     */
+    private filterToWinAnsi;
+    /**
+     * Get a font from cache by formatting style.
+     */
+    private getFont;
+    /**
+     * Render a flowed page to PDF.
+     */
+    private renderFlowedPage;
+    /**
+     * Calculate alignment offset for a line.
+     */
+    private getAlignmentOffset;
+    /**
+     * Render a substitution field (page number, data field value).
+     */
+    private renderSubstitutionField;
+    /**
+     * Render an embedded object (image, text box, or table).
+     */
+    private renderEmbeddedObject;
+    /**
+     * Render relative-positioned objects at their calculated positions.
+     * Called after all lines are rendered so objects appear on top.
+     */
+    private renderRelativeObjects;
+    /**
+     * Render an image to PDF.
+     */
+    private renderImage;
+    /**
+     * Embed an image from a data URL into the PDF document.
+     */
+    private embedImageFromDataUrl;
+    /**
+     * Calculate image drawing parameters based on fit mode.
+     */
+    private calculateImageDrawParams;
+    /**
+     * Draw a tiled image pattern to fill the box.
+     */
+    private drawTiledImage;
+    /**
+     * Render a text box to PDF.
+     */
+    private renderTextBox;
+    /**
+     * Render a table to PDF.
+     * Handles multi-page tables by checking rendered slice info.
+     */
+    private renderTable;
+    /**
+     * Get the rows to render for a specific table slice.
+     * Handles header row repetition on continuation pages.
+     *
+     * Uses sliceIndex to look at all rendered pages and determine
+     * which data rows belong to this slice.
+     */
+    private getTableRowsForSlice;
+    /**
+     * Render cell borders.
+     */
+    private renderCellBorders;
+}
+//# sourceMappingURL=PDFGenerator.d.ts.map

package/dist/types/lib/rendering/PDFGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PDFGenerator.d.ts","sourceRoot":"","sources":["../../../../src/lib/rendering/PDFGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAmC,MAAM,eAAe,CAAC;AAa5E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAwB;IAEzC;;;;;;OAMG;IACG,QAAQ,CACZ,QAAQ,EAAE,QAAQ,EAClB,aAAa,CAAC,EAAE,qBAAqB,EACrC,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC;IA2FhB;;OAEG;YACW,kBAAkB;IAuBhC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;YACW,gBAAgB;IA4I9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmD/B;;OAEG;YACW,oBAAoB;IAkBlC;;;OAGG;YACW,qBAAqB;IAwBnC;;OAEG;YACW,WAAW;IA0DzB;;OAEG;YACW,qBAAqB;IA0BnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoDhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;YACW,aAAa;IAuE3B;;;OAGG;YACW,WAAW;IAuIzB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAyE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA+B1B"}

package/dist/types/lib/rendering/pdf-utils.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PDF utility functions for coordinate transformation and font mapping.
+ */
+import { StandardFonts, PDFFont, PDFPage, Color } from 'pdf-lib';
+/**
+ * PDF uses bottom-left origin, canvas uses top-left.
+ * Transform Y coordinate from canvas space to PDF space.
+ */
+export declare function transformY(y: number, pageHeight: number): number;
+/**
+ * Transform a rectangle from canvas coordinates to PDF coordinates.
+ * Canvas: (x, y) is top-left corner
+ * PDF: (x, y) is bottom-left corner
+ */
+export declare function transformRect(x: number, y: number, width: number, height: number, pageHeight: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * Font weight/style variants for PDF standard fonts.
+ */
+export type FontVariant = 'normal' | 'bold' | 'italic' | 'boldItalic';
+/**
+ * Get the StandardFonts enum value for a given font family and style.
+ */
+export declare function getStandardFont(fontFamily: string, fontWeight?: string, fontStyle?: string): StandardFonts;
+/**
+ * Create a unique font key for caching embedded fonts.
+ */
+export declare function getFontKey(fontFamily: string, fontWeight?: string, fontStyle?: string): string;
+/**
+ * Parse a CSS color string to pdf-lib Color.
+ * Supports hex (#RGB, #RRGGBB), rgb(), rgba(), and named colors.
+ */
+export declare function parseColor(cssColor: string): Color;
+/**
+ * Draw text on a PDF page with proper positioning and formatting.
+ */
+export declare function drawText(page: PDFPage, text: string, x: number, y: number, font: PDFFont, fontSize: number, color: Color, pageHeight: number): void;
+/**
+ * Draw a filled rectangle on a PDF page.
+ */
+export declare function drawFilledRect(page: PDFPage, x: number, y: number, width: number, height: number, color: Color, pageHeight: number): void;
+/**
+ * Draw a stroked rectangle on a PDF page.
+ */
+export declare function drawStrokedRect(page: PDFPage, x: number, y: number, width: number, height: number, borderColor: Color, borderWidth: number, pageHeight: number): void;
+/**
+ * Draw a line on a PDF page.
+ */
+export declare function drawLine(page: PDFPage, x1: number, y1: number, x2: number, y2: number, color: Color, thickness: number, pageHeight: number): void;
+//# sourceMappingURL=pdf-utils.d.ts.map

package/dist/types/lib/rendering/pdf-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-utils.d.ts","sourceRoot":"","sources":["../../../../src/lib/rendering/pdf-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOzD;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC;AAwEtE;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,CAsBf;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CA+DlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,GACjB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,GACjB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,KAAK,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CAON"}

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

@@ -0,0 +1,105 @@
+import { Point, Rect } from '../types';
+import { FlowedLine, FlowedPage } from './types';
+import { FlowingTextContent } from './FlowingTextContent';
+/**
+ * Types of editable text regions in the document.
+ */
+export type RegionType = 'body' | 'header' | 'footer' | 'textbox' | 'tablecell';
+/**
+ * Interface for editable text regions.
+ * This abstraction unifies body, header, footer, and text box contexts
+ * so that interaction logic (click handling, cursor positioning, selection)
+ * can be shared across all of them.
+ */
+export interface EditableTextRegion {
+    /**
+     * Unique identifier for this region.
+     * For body/header/footer this is a fixed string.
+     * For text boxes this is the text box ID.
+     */
+    readonly id: string;
+    /**
+     * The type of region.
+     */
+    readonly type: RegionType;
+    /**
+     * The underlying FlowingTextContent that manages text state.
+     */
+    readonly flowingContent: FlowingTextContent;
+    /**
+     * Get the bounds of this region on a specific page.
+     * @param pageIndex The page index (0-based)
+     * @returns The bounds in canvas coordinates, or null if not visible on this page
+     */
+    getRegionBounds(pageIndex: number): Rect | null;
+    /**
+     * Convert a point from global (canvas) coordinates to local (region) coordinates.
+     * @param point Point in canvas coordinates
+     * @param pageIndex The page index
+     * @returns Point in region-local coordinates, or null if point is outside this region
+     */
+    globalToLocal(point: Point, pageIndex: number): Point | null;
+    /**
+     * Convert a point from local (region) coordinates to global (canvas) coordinates.
+     * @param point Point in region-local coordinates
+     * @param pageIndex The page index
+     * @returns Point in canvas coordinates
+     */
+    localToGlobal(point: Point, pageIndex: number): Point;
+    /**
+     * Get the flowed lines for this region on a specific page.
+     * @param pageIndex The page index
+     * @returns Array of flowed lines for this page
+     */
+    getFlowedLines(pageIndex: number): FlowedLine[];
+    /**
+     * Get all flowed pages for this region.
+     * @returns Array of flowed pages
+     */
+    getFlowedPages(): FlowedPage[];
+    /**
+     * Get the available width for text in this region.
+     * This is used for alignment calculations.
+     */
+    getAvailableWidth(): number;
+    /**
+     * Whether this region spans multiple pages.
+     * Body text can span pages; header/footer/textbox cannot.
+     */
+    spansMultiplePages(): boolean;
+    /**
+     * Get the number of pages this region spans.
+     * For single-page regions, returns 1.
+     */
+    getPageCount(): number;
+    /**
+     * Check if a point is within this region.
+     * @param point Point in canvas coordinates
+     * @param pageIndex The page index
+     */
+    containsPointInRegion(point: Point, pageIndex: number): boolean;
+    /**
+     * Trigger a reflow of text in this region.
+     * @param ctx Canvas context for text measurement
+     */
+    reflow(ctx: CanvasRenderingContext2D): void;
+}
+/**
+ * Abstract base class providing common functionality for regions.
+ */
+export declare abstract class BaseTextRegion implements EditableTextRegion {
+    abstract readonly id: string;
+    abstract readonly type: RegionType;
+    abstract readonly flowingContent: FlowingTextContent;
+    abstract getRegionBounds(pageIndex: number): Rect | null;
+    abstract getFlowedLines(pageIndex: number): FlowedLine[];
+    abstract getFlowedPages(): FlowedPage[];
+    abstract getAvailableWidth(): number;
+    abstract spansMultiplePages(): boolean;
+    abstract reflow(ctx: CanvasRenderingContext2D): void;
+    globalToLocal(point: Point, pageIndex: number): Point | null;
+    localToGlobal(point: Point, pageIndex: number): Point;
+    getPageCount(): number;
+    containsPointInRegion(point: Point, pageIndex: number): boolean;
+}
+//# sourceMappingURL=EditableTextRegion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EditableTextRegion.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/EditableTextRegion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAE5C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAEhD;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAE7D;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAEtD;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAEhD;;;OAGG;IACH,cAAc,IAAI,UAAU,EAAE,CAAC;IAE/B;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC;IAE5B;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;OAGG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB;;;;OAIG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,8BAAsB,cAAe,YAAW,kBAAkB;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAErD,QAAQ,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IACxD,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IACxD,QAAQ,CAAC,cAAc,IAAI,UAAU,EAAE;IACvC,QAAQ,CAAC,iBAAiB,IAAI,MAAM;IACpC,QAAQ,CAAC,kBAAkB,IAAI,OAAO;IACtC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI;IAEpD,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAgB5D,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;IAarD,YAAY,IAAI,MAAM;IAItB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAOhE"}