@productcloudos/editor 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/text/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,OAAO,EACP,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG3H,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGhG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3G,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/lib/text/regions/BodyTextRegion.d.ts

@@ -0,0 +1,68 @@
+import { Rect } from '../../types';
+import { FlowedLine, FlowedPage } from '../types';
+import { FlowingTextContent } from '../FlowingTextContent';
+import { BaseTextRegion, RegionType } from '../EditableTextRegion';
+/**
+ * Callback to get a page by index for bounds calculation.
+ */
+export type PageBoundsProvider = (pageIndex: number) => {
+    getContentBounds(): {
+        position: {
+            x: number;
+            y: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+} | null;
+/**
+ * Body text region - handles the main document content.
+ * Body text can span multiple pages.
+ */
+export declare class BodyTextRegion extends BaseTextRegion {
+    readonly id = "body";
+    readonly type: RegionType;
+    private _flowingContent;
+    private _getPage;
+    private _flowedPages;
+    private _availableWidth;
+    /**
+     * Create a body text region.
+     * @param flowingContent The FlowingTextContent for body text (from first page)
+     * @param getPage Callback to get page bounds by index
+     */
+    constructor(flowingContent: FlowingTextContent, getPage: PageBoundsProvider);
+    get flowingContent(): FlowingTextContent;
+    /**
+     * Get the bounds of the body content area on a specific page.
+     */
+    getRegionBounds(pageIndex: number): Rect | null;
+    /**
+     * Get flowed lines for a specific page.
+     */
+    getFlowedLines(pageIndex: number): FlowedLine[];
+    /**
+     * Get all flowed pages.
+     */
+    getFlowedPages(): FlowedPage[];
+    /**
+     * Get the available width for text.
+     */
+    getAvailableWidth(): number;
+    /**
+     * Body text can span multiple pages.
+     */
+    spansMultiplePages(): boolean;
+    /**
+     * Reflow the text content.
+     */
+    reflow(ctx: CanvasRenderingContext2D): void;
+    /**
+     * Update the flowed pages from external source.
+     * This is useful when FlowingTextRenderer has already computed the flow.
+     */
+    setFlowedPages(pages: FlowedPage[], availableWidth: number): void;
+}
+//# sourceMappingURL=BodyTextRegion.d.ts.map

package/dist/types/lib/text/regions/BodyTextRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BodyTextRegion.d.ts","sourceRoot":"","sources":["../../../../../src/lib/text/regions/BodyTextRegion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK;IACtD,gBAAgB,IAAI;QAAE,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACrG,GAAG,IAAI,CAAC;AAET;;;GAGG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAU;IAEnC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,eAAe,CAAa;IAEpC;;;;OAIG;gBACS,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB;IAM3E,IAAI,cAAc,IAAI,kBAAkB,CAEvC;IAED;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAa/C;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAO/C;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI;IAmB3C;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;CAIlE"}

package/dist/types/lib/text/regions/FooterTextRegion.d.ts

@@ -0,0 +1,68 @@
+import { Rect } from '../../types';
+import { FlowedLine, FlowedPage } from '../types';
+import { FlowingTextContent } from '../FlowingTextContent';
+import { BaseTextRegion, RegionType } from '../EditableTextRegion';
+/**
+ * Callback to get footer bounds for a page.
+ */
+export type FooterBoundsProvider = (pageIndex: number) => {
+    getFooterBounds(): {
+        position: {
+            x: number;
+            y: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+} | null;
+/**
+ * Footer text region - handles document footer content.
+ * Footer content is shared across all pages but renders at the bottom of each page.
+ */
+export declare class FooterTextRegion extends BaseTextRegion {
+    readonly id = "footer";
+    readonly type: RegionType;
+    private _flowingContent;
+    private _getPage;
+    private _flowedPage;
+    private _availableWidth;
+    /**
+     * Create a footer text region.
+     * @param flowingContent The FlowingTextContent for footer text
+     * @param getPage Callback to get page footer bounds by index
+     */
+    constructor(flowingContent: FlowingTextContent, getPage: FooterBoundsProvider);
+    get flowingContent(): FlowingTextContent;
+    /**
+     * Get the bounds of the footer area on a specific page.
+     * Footer renders at the same position on every page.
+     */
+    getRegionBounds(pageIndex: number): Rect | null;
+    /**
+     * Get flowed lines. Footer uses the same content on all pages.
+     */
+    getFlowedLines(_pageIndex: number): FlowedLine[];
+    /**
+     * Get all flowed pages (footer has just one "page" of content).
+     */
+    getFlowedPages(): FlowedPage[];
+    /**
+     * Get the available width for text.
+     */
+    getAvailableWidth(): number;
+    /**
+     * Footer does not span multiple pages (content is shared).
+     */
+    spansMultiplePages(): boolean;
+    /**
+     * Reflow the text content.
+     */
+    reflow(ctx: CanvasRenderingContext2D): void;
+    /**
+     * Update the flowed page from external source.
+     */
+    setFlowedPage(page: FlowedPage | null, availableWidth: number): void;
+}
+//# sourceMappingURL=FooterTextRegion.d.ts.map

package/dist/types/lib/text/regions/FooterTextRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FooterTextRegion.d.ts","sourceRoot":"","sources":["../../../../../src/lib/text/regions/FooterTextRegion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK;IACxD,eAAe,IAAI;QAAE,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACpG,GAAG,IAAI,CAAC;AAET;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAY;IAErC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAAa;IAEpC;;;;OAIG;gBACS,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB;IAM7E,IAAI,cAAc,IAAI,kBAAkB,CAEvC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAa/C;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE;IAIhD;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI;IAc3C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;CAIrE"}

package/dist/types/lib/text/regions/HeaderTextRegion.d.ts

@@ -0,0 +1,68 @@
+import { Rect } from '../../types';
+import { FlowedLine, FlowedPage } from '../types';
+import { FlowingTextContent } from '../FlowingTextContent';
+import { BaseTextRegion, RegionType } from '../EditableTextRegion';
+/**
+ * Callback to get header bounds for a page.
+ */
+export type HeaderBoundsProvider = (pageIndex: number) => {
+    getHeaderBounds(): {
+        position: {
+            x: number;
+            y: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+} | null;
+/**
+ * Header text region - handles document header content.
+ * Header content is shared across all pages but renders at the top of each page.
+ */
+export declare class HeaderTextRegion extends BaseTextRegion {
+    readonly id = "header";
+    readonly type: RegionType;
+    private _flowingContent;
+    private _getPage;
+    private _flowedPage;
+    private _availableWidth;
+    /**
+     * Create a header text region.
+     * @param flowingContent The FlowingTextContent for header text
+     * @param getPage Callback to get page header bounds by index
+     */
+    constructor(flowingContent: FlowingTextContent, getPage: HeaderBoundsProvider);
+    get flowingContent(): FlowingTextContent;
+    /**
+     * Get the bounds of the header area on a specific page.
+     * Header renders at the same position on every page.
+     */
+    getRegionBounds(pageIndex: number): Rect | null;
+    /**
+     * Get flowed lines. Header uses the same content on all pages.
+     */
+    getFlowedLines(_pageIndex: number): FlowedLine[];
+    /**
+     * Get all flowed pages (header has just one "page" of content).
+     */
+    getFlowedPages(): FlowedPage[];
+    /**
+     * Get the available width for text.
+     */
+    getAvailableWidth(): number;
+    /**
+     * Header does not span multiple pages (content is shared).
+     */
+    spansMultiplePages(): boolean;
+    /**
+     * Reflow the text content.
+     */
+    reflow(ctx: CanvasRenderingContext2D): void;
+    /**
+     * Update the flowed page from external source.
+     */
+    setFlowedPage(page: FlowedPage | null, availableWidth: number): void;
+}
+//# sourceMappingURL=HeaderTextRegion.d.ts.map

package/dist/types/lib/text/regions/HeaderTextRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderTextRegion.d.ts","sourceRoot":"","sources":["../../../../../src/lib/text/regions/HeaderTextRegion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK;IACxD,eAAe,IAAI;QAAE,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACpG,GAAG,IAAI,CAAC;AAET;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAY;IAErC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAAa;IAEpC;;;;OAIG;gBACS,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB;IAM7E,IAAI,cAAc,IAAI,kBAAkB,CAEvC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAa/C;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE;IAIhD;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI;IAc3C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;CAIrE"}

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

@@ -0,0 +1,7 @@
+export { BodyTextRegion } from './BodyTextRegion';
+export type { PageBoundsProvider } from './BodyTextRegion';
+export { HeaderTextRegion } from './HeaderTextRegion';
+export type { HeaderBoundsProvider } from './HeaderTextRegion';
+export { FooterTextRegion } from './FooterTextRegion';
+export type { FooterBoundsProvider } from './FooterTextRegion';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/text/regions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,268 @@
+import { BaseEmbeddedObject, ObjectPosition } from '../objects';
+/**
+ * Interface for controls that can receive keyboard focus.
+ * Only one Focusable can be active at a time in the editor.
+ */
+export interface Focusable {
+    /**
+     * Called when this control receives focus.
+     * Should start cursor blinking and prepare for keyboard input.
+     */
+    focus(): void;
+    /**
+     * Called when this control loses focus.
+     * Should stop cursor blinking and hide cursor.
+     */
+    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).
+     */
+    onCursorBlink(handler: () => void): void;
+    /**
+     * Unsubscribe from cursor blink events.
+     */
+    offCursorBlink(handler: () => void): void;
+}
+/**
+ * Alignment options for paragraphs.
+ */
+export type TextAlignment = 'left' | 'center' | 'right' | 'justify';
+/**
+ * Bullet point styles for unordered lists.
+ */
+export type BulletStyle = 'disc' | 'circle' | 'square' | 'dash' | 'none';
+/**
+ * Numbering styles for ordered lists.
+ */
+export type NumberStyle = 'decimal' | 'lower-alpha' | 'upper-alpha' | 'lower-roman' | 'upper-roman';
+/**
+ * Type of list (bullet, numbered, or none).
+ */
+export type ListType = 'bullet' | 'number' | 'none';
+/**
+ * List formatting properties for a paragraph.
+ */
+export interface ListFormatting {
+    listType: ListType;
+    bulletStyle?: BulletStyle;
+    numberStyle?: NumberStyle;
+    nestingLevel: number;
+    startNumber?: number;
+}
+/**
+ * Default list formatting values.
+ */
+export declare const DEFAULT_LIST_FORMATTING: ListFormatting;
+/**
+ * Indent per nesting level in pixels.
+ */
+export declare const LIST_INDENT_PER_LEVEL = 24;
+/**
+ * Paragraph formatting properties.
+ * Applied at paragraph level (delimited by \n characters).
+ */
+export interface ParagraphFormatting {
+    alignment: TextAlignment;
+    listFormatting?: ListFormatting;
+}
+/**
+ * Text formatting style applied to characters.
+ */
+export interface TextFormattingStyle {
+    fontFamily: string;
+    fontSize: number;
+    fontWeight?: string;
+    fontStyle?: string;
+    color: string;
+    backgroundColor?: string;
+}
+/**
+ * A run of text with consistent formatting.
+ */
+export interface TextRun {
+    text: string;
+    formatting: TextFormattingStyle;
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Type of substitution field.
+ * - 'data': Regular field replaced by merge data
+ * - 'pageNumber': Replaced by current page number during rendering
+ * - 'pageCount': Replaced by total page count during rendering
+ */
+export type SubstitutionFieldType = 'data' | 'pageNumber' | 'pageCount';
+/**
+ * Type of value expected for formatting purposes.
+ */
+export type FieldValueType = 'string' | 'number' | 'currency' | 'date' | 'markdown';
+/**
+ * Predefined format patterns for numbers.
+ */
+export type NumberFormatPreset = 'integer' | 'decimal' | 'decimal-1' | 'decimal-3' | 'thousands' | 'percent' | 'scientific';
+/**
+ * Predefined format patterns for currency.
+ */
+export type CurrencyFormatPreset = 'USD' | 'EUR' | 'GBP' | 'JPY' | 'custom';
+/**
+ * Predefined format patterns for dates.
+ */
+export type DateFormatPreset = 'short' | 'medium' | 'long' | 'full' | 'iso' | 'time-short' | 'time-long' | 'datetime-short' | 'datetime-long';
+/**
+ * Configuration for field value formatting.
+ */
+export interface FieldFormatConfig {
+    /** Type of value for formatting purposes */
+    valueType?: FieldValueType;
+    /** Preset or custom format pattern for numbers */
+    numberFormat?: NumberFormatPreset | string;
+    /** Number of decimal places */
+    decimalPlaces?: number;
+    /** Use thousands separator grouping */
+    useGrouping?: boolean;
+    /** Currency format preset */
+    currencyFormat?: CurrencyFormatPreset;
+    /** Custom currency symbol (when currencyFormat is 'custom') */
+    currencySymbol?: string;
+    /** Position of currency symbol */
+    currencyPosition?: 'before' | 'after';
+    /** Date format preset or custom pattern */
+    dateFormat?: DateFormatPreset | string;
+    /** Locale for formatting (e.g., 'en-US', 'de-DE') */
+    locale?: string;
+}
+/**
+ * Configuration for a substitution field.
+ */
+export interface SubstitutionFieldConfig {
+    displayFormat?: string;
+    defaultValue?: string;
+    fieldType?: SubstitutionFieldType;
+    formatting?: TextFormattingStyle;
+    /** Format configuration for value transformation */
+    formatConfig?: FieldFormatConfig;
+}
+/**
+ * A substitution field - text placeholder for data merge or page numbers.
+ * Regular fields rendered as {{fieldName}} and replaced during merge.
+ * Page number fields rendered as the current page number.
+ */
+export interface SubstitutionField {
+    id: string;
+    textIndex: number;
+    fieldName: string;
+    fieldType?: SubstitutionFieldType;
+    displayFormat?: string;
+    defaultValue?: string;
+    formatting?: TextFormattingStyle;
+    /** Format configuration for value transformation during merge */
+    formatConfig?: FieldFormatConfig;
+}
+/**
+ * Reference to an embedded object within a flowed line.
+ */
+export interface FlowedEmbeddedObject {
+    object: BaseEmbeddedObject;
+    textIndex: number;
+    x: number;
+    isBlock?: boolean;
+    isAnchor?: boolean;
+}
+/**
+ * Reference to a substitution field within a flowed line.
+ */
+export interface FlowedSubstitutionField {
+    field: SubstitutionField;
+    textIndex: number;
+    x: number;
+    width: number;
+}
+/**
+ * List marker information for a line.
+ */
+export interface ListMarker {
+    text: string;
+    width: number;
+    indent: number;
+    isFirstLineOfListItem: boolean;
+}
+/**
+ * A single line of flowed text with its measurements and content.
+ */
+export interface FlowedLine {
+    text: string;
+    width: number;
+    height: number;
+    baseline: number;
+    runs: TextRun[];
+    substitutionFields: FlowedSubstitutionField[];
+    embeddedObjects: FlowedEmbeddedObject[];
+    startIndex: number;
+    endIndex: number;
+    endsWithNewline?: boolean;
+    endsWithPageBreak?: boolean;
+    alignment: TextAlignment;
+    extraWordSpacing?: number;
+    isBlockObjectLine?: boolean;
+    allowPageBreakBefore?: boolean;
+    listMarker?: ListMarker;
+}
+/**
+ * A page of flowed text content.
+ */
+export interface FlowedPage {
+    lines: FlowedLine[];
+    height: number;
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Default text formatting values.
+ */
+export declare const DEFAULT_FORMATTING: TextFormattingStyle;
+/**
+ * Default paragraph formatting values.
+ */
+export declare const DEFAULT_PARAGRAPH_FORMATTING: ParagraphFormatting;
+/**
+ * The Unicode Object Replacement Character used for embedded content.
+ * Both substitution fields and embedded objects use this character.
+ */
+export declare const OBJECT_REPLACEMENT_CHAR = "\uFFFC";
+/**
+ * The Form Feed character used for page breaks.
+ * Inserted via Ctrl+Enter and forces content to start on a new page.
+ */
+export declare const PAGE_BREAK_CHAR = "\f";
+/**
+ * Visual state of a repeating section, computed during render.
+ */
+export interface RepeatingSectionVisualState {
+    startPageIndex: number;
+    startY: number;
+    endPageIndex: number;
+    endY: number;
+    spansMultiplePages: boolean;
+}
+/**
+ * A repeating section that loops over array data during merge.
+ * Starts and ends at paragraph boundaries.
+ */
+export interface RepeatingSection {
+    id: string;
+    fieldPath: string;
+    startIndex: number;
+    endIndex: number;
+    visualState?: RepeatingSectionVisualState;
+}
+export type { ObjectPosition };
+//# sourceMappingURL=types.d.ts.map

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

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