@productcloudos/editor 1.0.0

package/dist/types/lib/objects/TextBoxObject.d.ts

@@ -0,0 +1,208 @@
+import { BaseEmbeddedObject } from './BaseEmbeddedObject';
+import { TextBoxObjectConfig, EmbeddedObjectData, Point, TextBoxBorder, Rect } from './types';
+import { FlowingTextContent } from '../text/FlowingTextContent';
+import { FlowedLine, FlowedPage, Focusable } from '../text/types';
+import { EditableTextRegion, RegionType } from '../text/EditableTextRegion';
+/**
+ * Text box object - editable text within a box with flowing text support.
+ * Implements Focusable for unified focus management, delegating to internal FlowingTextContent.
+ * Implements EditableTextRegion for unified text interaction.
+ */
+export declare class TextBoxObject extends BaseEmbeddedObject implements Focusable, EditableTextRegion {
+    private _content;
+    private _fontFamily;
+    private _fontSize;
+    private _color;
+    private _backgroundColor;
+    private _border;
+    private _padding;
+    private _editing;
+    private _flowingContent;
+    private _flowedLines;
+    private _flowedPage;
+    constructor(config: TextBoxObjectConfig);
+    get objectType(): string;
+    readonly type: RegionType;
+    get content(): string;
+    set content(value: string);
+    get fontFamily(): string;
+    set fontFamily(value: string);
+    get fontSize(): number;
+    set fontSize(value: number);
+    get color(): string;
+    set color(value: string);
+    get backgroundColor(): string;
+    set backgroundColor(value: string);
+    get border(): TextBoxBorder;
+    set border(value: TextBoxBorder);
+    /** @deprecated Use border instead */
+    get borderColor(): string;
+    /** @deprecated Use border instead */
+    set borderColor(value: string);
+    get padding(): number;
+    set padding(value: number);
+    get editing(): boolean;
+    set editing(value: boolean);
+    /**
+     * Get the internal FlowingTextContent for direct manipulation.
+     */
+    get flowingContent(): FlowingTextContent;
+    /**
+     * Get available text bounds (size minus padding and borders).
+     */
+    getTextBounds(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Get the text area offset (padding + border) from the top-left of the text box.
+     */
+    getTextOffset(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Get the text area bounds in global coordinates.
+     * This is the area where text is rendered, inside padding and borders.
+     * Returns null if the text box hasn't been positioned yet.
+     */
+    getTextAreaBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /**
+     * Render the text box container (background, border, indicators).
+     * Text content is rendered separately by FlowingTextRenderer.renderRegion().
+     * @param ctx Canvas rendering context (should be translated to text box position)
+     */
+    render(ctx: CanvasRenderingContext2D): void;
+    private renderBackground;
+    private renderBorder;
+    private drawBorderSide;
+    /**
+     * Get X position for a text index within a line.
+     * Used for vertical cursor navigation.
+     */
+    private getXPositionInLine;
+    private renderEditingBorder;
+    /**
+     * Move cursor vertically by one line.
+     * @param direction -1 for up, 1 for down
+     * @param ctx Canvas context for text measurement
+     * @returns true if cursor was moved, false if at boundary
+     */
+    moveCursorVertical(direction: -1 | 1, ctx: CanvasRenderingContext2D): boolean;
+    /**
+     * Find the text index at a given X position within a line.
+     */
+    private getTextIndexAtX;
+    /**
+     * Called when this control receives focus.
+     * Delegates to internal FlowingTextContent.
+     */
+    focus(): void;
+    /**
+     * Called when this control loses focus.
+     * Delegates to internal FlowingTextContent.
+     */
+    blur(): void;
+    /**
+     * Returns whether this control currently has focus.
+     */
+    hasFocus(): boolean;
+    /**
+     * Handle a keyboard event.
+     * @returns true if the event was handled, false otherwise
+     */
+    handleKeyDown(e: KeyboardEvent): boolean;
+    /**
+     * Subscribe to cursor blink events (for re-rendering).
+     * Delegates to internal FlowingTextContent.
+     */
+    onCursorBlink(handler: () => void): void;
+    /**
+     * Unsubscribe from cursor blink events.
+     * Delegates to internal FlowingTextContent.
+     */
+    offCursorBlink(handler: () => void): void;
+    handleDoubleClick(_point: Point): void;
+    /**
+     * Exit editing mode.
+     */
+    finishEditing(): void;
+    toData(): EmbeddedObjectData;
+    /**
+     * Restore the text box state from serialized data.
+     * Used for undo/redo operations.
+     */
+    restoreFromData(data: EmbeddedObjectData): void;
+    clone(): TextBoxObject;
+    /**
+     * Get the minimum size needed to fit the current content.
+     */
+    getContentSize(ctx: CanvasRenderingContext2D): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Resize to fit the current content.
+     */
+    resizeToContent(ctx: CanvasRenderingContext2D): void;
+    /**
+     * Get the bounds of the text area within this text box on a specific page.
+     * Text boxes are single-page objects, so pageIndex is ignored.
+     * Returns the text area bounds (accounting for padding/borders) in canvas coordinates.
+     * This is the area where text is rendered, used by FlowingTextRenderer.renderRegion().
+     */
+    getRegionBounds(_pageIndex: number): Rect | null;
+    /**
+     * Convert a point from global (canvas) coordinates to local (text box) coordinates.
+     * @param point Point in canvas coordinates
+     * @param pageIndex The page index (ignored for text boxes)
+     * @returns Point in local coordinates, or null if point is outside this text box
+     */
+    globalToLocal(point: Point, pageIndex: number): Point | null;
+    /**
+     * Convert a point from local (text box) coordinates to global (canvas) coordinates.
+     * @param point Point in local coordinates
+     * @param pageIndex The page index (ignored for text boxes)
+     * @returns Point in canvas coordinates
+     */
+    localToGlobal(point: Point, pageIndex: number): Point;
+    /**
+     * Get the flowed lines for this text box.
+     * Text boxes don't span pages, so pageIndex is ignored.
+     */
+    getFlowedLines(_pageIndex: number): FlowedLine[];
+    /**
+     * Get all flowed pages for this text box.
+     * Text boxes have a single "page" of content.
+     */
+    getFlowedPages(): FlowedPage[];
+    /**
+     * Get the available width for text in this text box.
+     */
+    getAvailableWidth(): number;
+    /**
+     * Text boxes do not span multiple pages.
+     */
+    spansMultiplePages(): boolean;
+    /**
+     * Text boxes are always on a single page.
+     */
+    getPageCount(): number;
+    /**
+     * Check if a point is within this text box region.
+     * @param point Point in canvas coordinates
+     * @param pageIndex The page index (ignored for text boxes)
+     */
+    containsPointInRegion(point: Point, pageIndex: number): boolean;
+    /**
+     * Trigger a reflow of text in this text box.
+     * @param ctx Canvas context for text measurement
+     */
+    reflow(ctx: CanvasRenderingContext2D): void;
+}
+//# sourceMappingURL=TextBoxObject.d.ts.map

package/dist/types/lib/objects/TextBoxObject.d.ts.map

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

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

@@ -0,0 +1,9 @@
+export type { ObjectPosition, ResizeHandle, Size, Point, Rect, EmbeddedObjectConfig, EmbeddedObjectData, ImageObjectConfig, TextBoxObjectConfig, ImageFitMode, BorderStyle, BorderSide, TextBoxBorder } from './types';
+export { DEFAULT_BORDER_SIDE } from './types';
+export { BaseEmbeddedObject } from './BaseEmbeddedObject';
+export { ImageObject } from './ImageObject';
+export { TextBoxObject } from './TextBoxObject';
+export { TableObject, TableRow, TableCell } from './table';
+export type { TableObjectConfig, TableObjectData, TableRowConfig, TableRowData, TableCellConfig, TableCellData, TableColumnConfig, CellAddress, CellRange, CellBorder, CellPadding, VerticalAlign } from './table';
+export { EmbeddedObjectFactory } from './EmbeddedObjectFactory';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/objects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/objects/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/lib/objects/table/TableCell.d.ts

@@ -0,0 +1,165 @@
+/**
+ * TableCell - A cell within a table that contains editable text.
+ * Implements EditableTextRegion for unified text interaction.
+ */
+import { EventEmitter } from '../../events/EventEmitter';
+import { FlowingTextContent } from '../../text/FlowingTextContent';
+import { FlowedLine, FlowedPage, Focusable, SubstitutionFieldConfig } from '../../text/types';
+import { EditableTextRegion, RegionType } from '../../text/EditableTextRegion';
+import { Point, Rect } from '../../types';
+import { TableCellConfig, TableCellData, CellBorder, CellPadding, VerticalAlign } from './types';
+/**
+ * TableCell represents a single cell in a table.
+ * It contains FlowingTextContent for rich text editing and implements
+ * EditableTextRegion for unified text interaction.
+ */
+export declare class TableCell extends EventEmitter implements EditableTextRegion, Focusable {
+    private _id;
+    readonly type: RegionType;
+    private _rowSpan;
+    private _colSpan;
+    private _backgroundColor;
+    private _border;
+    private _padding;
+    private _verticalAlign;
+    private _fontFamily;
+    private _fontSize;
+    private _color;
+    private _flowingContent;
+    private _flowedLines;
+    private _flowedPage;
+    private _bounds;
+    private _renderedPosition;
+    private _renderedPageIndex;
+    private _editing;
+    private _reflowDirty;
+    private _lastReflowWidth;
+    private _cachedContentHeight;
+    constructor(config: TableCellConfig);
+    get id(): string;
+    get rowSpan(): number;
+    set rowSpan(value: number);
+    get colSpan(): number;
+    set colSpan(value: number);
+    get backgroundColor(): string;
+    set backgroundColor(value: string);
+    get border(): CellBorder;
+    set border(value: CellBorder);
+    get padding(): CellPadding;
+    set padding(value: CellPadding);
+    get verticalAlign(): VerticalAlign;
+    set verticalAlign(value: VerticalAlign);
+    get fontFamily(): string;
+    set fontFamily(value: string);
+    get fontSize(): number;
+    set fontSize(value: number);
+    get color(): string;
+    set color(value: string);
+    get flowingContent(): FlowingTextContent;
+    get content(): string;
+    set content(value: string);
+    /**
+     * Insert a substitution field at the current cursor position.
+     * This is the only type of embedded content allowed in table cells.
+     */
+    insertSubstitutionField(fieldName: string, config?: SubstitutionFieldConfig): void;
+    /**
+     * Set the bounds of this cell within the table (table-local coordinates).
+     */
+    setBounds(bounds: Rect): void;
+    /**
+     * Get the bounds of this cell within the table.
+     */
+    getBounds(): Rect | null;
+    /**
+     * Set the rendered position (global canvas coordinates).
+     */
+    setRenderedPosition(pos: Point): void;
+    /**
+     * Get the rendered position.
+     */
+    getRenderedPosition(): Point | null;
+    /**
+     * Set the page index where this cell was rendered.
+     */
+    set renderedPageIndex(index: number);
+    /**
+     * Get the page index where this cell was rendered.
+     */
+    get renderedPageIndex(): number;
+    /**
+     * Get the content area bounds (inside padding and borders).
+     */
+    getContentBounds(): Rect | null;
+    /**
+     * Calculate the content height based on flowed text.
+     * Uses caching to avoid recalculation when nothing has changed.
+     */
+    getContentHeight(ctx: CanvasRenderingContext2D): number;
+    /**
+     * Get the bounds of this cell's text area in canvas coordinates.
+     */
+    getRegionBounds(_pageIndex: number): Rect | null;
+    /**
+     * Convert global (canvas) point to local (cell content) coordinates.
+     */
+    globalToLocal(point: Point, pageIndex: number): Point | null;
+    /**
+     * Convert local (cell content) point to global (canvas) coordinates.
+     */
+    localToGlobal(point: Point, pageIndex: number): Point;
+    /**
+     * Get flowed lines for this cell.
+     */
+    getFlowedLines(_pageIndex: number): FlowedLine[];
+    /**
+     * Get flowed pages (cells have one "page").
+     */
+    getFlowedPages(): FlowedPage[];
+    /**
+     * Get available width for text.
+     */
+    getAvailableWidth(): number;
+    /**
+     * Cells don't span multiple pages.
+     */
+    spansMultiplePages(): boolean;
+    /**
+     * Cells have one page.
+     */
+    getPageCount(): number;
+    /**
+     * Check if a point is within this cell.
+     */
+    containsPointInRegion(point: Point, pageIndex: number): boolean;
+    /**
+     * Reflow text within this cell.
+     * Uses caching to avoid unnecessary reflow operations.
+     */
+    reflow(ctx: CanvasRenderingContext2D): void;
+    /**
+     * Mark this cell as needing reflow.
+     * Call this when cell bounds change.
+     */
+    markReflowDirty(): void;
+    get editing(): boolean;
+    set editing(value: boolean);
+    focus(): void;
+    blur(): void;
+    hasFocus(): boolean;
+    handleKeyDown(e: KeyboardEvent): boolean;
+    onCursorBlink(handler: () => void): void;
+    offCursorBlink(handler: () => void): void;
+    /**
+     * Render the cell background and border.
+     * Text content is rendered separately by FlowingTextRenderer.
+     */
+    render(ctx: CanvasRenderingContext2D): void;
+    private renderBackground;
+    private renderBorder;
+    private renderBorderSide;
+    toData(): TableCellData;
+    static fromData(data: TableCellData): TableCell;
+    clone(): TableCell;
+}
+//# sourceMappingURL=TableCell.d.ts.map

package/dist/types/lib/objects/table/TableCell.d.ts.map

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

package/dist/types/lib/objects/table/TableCellMerger.d.ts

@@ -0,0 +1,66 @@
+/**
+ * TableCellMerger - Handles cell merge and split operations for tables.
+ */
+import { TableObject } from './TableObject';
+import { TableCell } from './TableCell';
+import { CellRange } from './types';
+/**
+ * Result of a merge operation.
+ */
+export interface MergeResult {
+    success: boolean;
+    error?: string;
+    mergedCell?: TableCell;
+}
+/**
+ * Result of a split operation.
+ */
+export interface SplitResult {
+    success: boolean;
+    error?: string;
+    newCells?: TableCell[];
+}
+/**
+ * TableCellMerger provides utilities for merging and splitting table cells.
+ */
+export declare class TableCellMerger {
+    /**
+     * Normalize a cell range so start is always top-left and end is bottom-right.
+     */
+    static normalizeRange(range: CellRange): CellRange;
+    /**
+     * Check if a range is valid for the given table.
+     */
+    static isValidRange(table: TableObject, range: CellRange): boolean;
+    /**
+     * Check if a cell range can be merged.
+     * Returns an error message if it cannot be merged, or null if it can.
+     */
+    static canMerge(table: TableObject, range: CellRange): string | null;
+    /**
+     * Merge cells in the given range.
+     * The top-left cell becomes the merged cell, other cells are cleared.
+     */
+    static mergeCells(table: TableObject, range: CellRange): MergeResult;
+    /**
+     * Check if a cell can be split.
+     */
+    static canSplit(table: TableObject, row: number, col: number): string | null;
+    /**
+     * Split a merged cell back into individual cells.
+     */
+    static splitCell(table: TableObject, row: number, col: number): SplitResult;
+    /**
+     * Get all cells in a range (accounting for merged cells).
+     */
+    static getCellsInRange(table: TableObject, range: CellRange): TableCell[];
+    /**
+     * Check if two ranges overlap.
+     */
+    static rangesOverlap(range1: CellRange, range2: CellRange): boolean;
+    /**
+     * Get the bounding range of a merged cell.
+     */
+    static getMergedCellRange(cell: TableCell, row: number, col: number): CellRange;
+}
+//# sourceMappingURL=TableCellMerger.d.ts.map

package/dist/types/lib/objects/table/TableCellMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableCellMerger.d.ts","sourceRoot":"","sources":["../../../../../src/lib/objects/table/TableCellMerger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAalD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO;IAUlE;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI;IAiDpE;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW;IAwCpE;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAa5E;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW;IAuC3E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE;IAqBzE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO;IAYnE;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS;CAShF"}