@productcloudos/editor 1.0.0

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

@@ -0,0 +1,206 @@
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Rect extends Point, Size {
+}
+export interface Margin {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export type PageSize = 'A4' | 'Letter' | 'Legal' | 'A3' | 'Custom';
+export type PageOrientation = 'portrait' | 'landscape';
+export type Units = 'px' | 'mm' | 'in' | 'pt';
+/**
+ * Represents which section of the document is being edited.
+ */
+export type EditingSection = 'header' | 'body' | 'footer';
+export interface PageDimensions {
+    width: number;
+    height: number;
+    units: Units;
+}
+export interface EditorOptions {
+    pageSize?: PageSize;
+    pageOrientation?: PageOrientation;
+    customPageSize?: PageDimensions | undefined;
+    units?: Units;
+    gridSize?: number;
+    showGrid?: boolean;
+    showRulers?: boolean;
+    showControlCharacters?: boolean;
+    defaultFont?: string;
+    defaultFontSize?: number;
+    theme?: 'light' | 'dark';
+}
+/**
+ * Complete serialized FlowingTextContent.
+ */
+export interface FlowingTextContentData {
+    text: string;
+    formattingRuns?: TextFormattingRunData[];
+    paragraphFormatting?: ParagraphFormattingData[];
+    substitutionFields?: SubstitutionFieldData[];
+    repeatingSections?: RepeatingSectionData[];
+    embeddedObjects?: EmbeddedObjectReference[];
+    hyperlinks?: HyperlinkSerializedData[];
+}
+export interface DocumentData {
+    version: string;
+    pages: PageData[];
+    settings?: DocumentSettings;
+    bodyContent?: FlowingTextContentData;
+    headerContent?: FlowingTextContentData;
+    footerContent?: FlowingTextContentData;
+    metadata?: {
+        createdAt?: string;
+        modifiedAt?: string;
+        title?: string;
+        author?: string;
+    };
+}
+export interface DocumentSettings {
+    pageSize: PageSize;
+    pageOrientation: PageOrientation;
+    customPageSize?: PageDimensions;
+    margins: Margin;
+    units: Units;
+}
+export interface PageData {
+    id: string;
+}
+export interface EditorEvent {
+    type: string;
+    data?: any;
+}
+/**
+ * Unified selection type representing cursor position, text selection, or no selection.
+ * Text-based selections (cursor, text) include which section is being edited.
+ */
+export type EditorSelection = {
+    type: 'cursor';
+    position: number;
+    section: EditingSection;
+} | {
+    type: 'text';
+    start: number;
+    end: number;
+    section: EditingSection;
+} | {
+    type: 'repeating-section';
+    sectionId: string;
+} | {
+    type: 'none';
+};
+export interface SelectionEvent extends EditorEvent {
+    type: 'selection-change';
+    data: {
+        selection: EditorSelection;
+    };
+}
+export interface DocumentChangeEvent extends EditorEvent {
+    type: 'document-change';
+    data: {
+        document: DocumentData;
+    };
+}
+export interface DataBindingContext {
+    [key: string]: any;
+}
+export interface PDFExportOptions {
+    quality?: number;
+    compress?: boolean;
+    embedFonts?: boolean;
+    /** If true, apply merge data before generating PDF */
+    applyMergeData?: boolean;
+    /** Data to use for merge (requires applyMergeData: true) */
+    mergeData?: Record<string, unknown>;
+}
+/**
+ * Serialized text formatting run.
+ * Represents formatting applied at a specific character index.
+ */
+export interface TextFormattingRunData {
+    index: number;
+    formatting: {
+        fontFamily: string;
+        fontSize: number;
+        fontWeight?: string;
+        fontStyle?: string;
+        color: string;
+        backgroundColor?: string;
+    };
+}
+/**
+ * Serialized paragraph formatting.
+ */
+export interface ParagraphFormattingData {
+    paragraphStart: number;
+    formatting: {
+        alignment: 'left' | 'center' | 'right' | 'justify';
+    };
+}
+/**
+ * Serialized field format configuration.
+ */
+export interface FieldFormatConfigData {
+    valueType?: 'string' | 'number' | 'currency' | 'date' | 'markdown';
+    numberFormat?: string;
+    decimalPlaces?: number;
+    useGrouping?: boolean;
+    currencyFormat?: 'USD' | 'EUR' | 'GBP' | 'JPY' | 'custom';
+    currencySymbol?: string;
+    currencyPosition?: 'before' | 'after';
+    dateFormat?: string;
+    locale?: string;
+}
+/**
+ * Serialized substitution field.
+ */
+export interface SubstitutionFieldData {
+    id: string;
+    textIndex: number;
+    fieldName: string;
+    fieldType?: 'data' | 'pageNumber' | 'pageCount';
+    displayFormat?: string;
+    defaultValue?: string;
+    formatting?: TextFormattingRunData['formatting'];
+    formatConfig?: FieldFormatConfigData;
+}
+/**
+ * Serialized repeating section.
+ */
+export interface RepeatingSectionData {
+    id: string;
+    fieldPath: string;
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Serialized embedded object reference in FlowingTextContent.
+ */
+export interface EmbeddedObjectReference {
+    textIndex: number;
+    object: import('../objects').EmbeddedObjectData;
+}
+/**
+ * Serialized hyperlink.
+ */
+export interface HyperlinkSerializedData {
+    id: string;
+    url: string;
+    startIndex: number;
+    endIndex: number;
+    title?: string;
+    formatting?: {
+        color?: string;
+        underline?: boolean;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Undo/Redo System Module Exports
+ *
+ * Transaction-based undo/redo system that works across all content sources
+ * (body, header, footer, table cells, text boxes).
+ */
+export * from './transaction';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/undo/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,eAAe,CAAC"}

package/dist/types/lib/undo/transaction/ContentDiscovery.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ContentDiscovery - Automatically discovers and registers content sources.
+ *
+ * Listens for focus events and registers FlowingTextContent instances
+ * with the TextMutationObserver when they become active.
+ */
+import { EventEmitter } from '../../events/EventEmitter';
+import { FlowingTextContent } from '../../text/FlowingTextContent';
+import { TextMutationObserver } from './TextMutationObserver';
+import { ContentSourceId } from './types';
+import { BaseEmbeddedObject } from '../../objects';
+/**
+ * Interface for the document that provides FlowingTextContent.
+ */
+export interface DocumentProvider {
+    bodyFlowingContent: FlowingTextContent;
+    headerFlowingContent: FlowingTextContent;
+    footerFlowingContent: FlowingTextContent;
+}
+/**
+ * Interface for the canvas manager that provides focus events.
+ */
+export interface FocusEventSource extends EventEmitter {
+}
+/**
+ * ContentDiscovery manages automatic content registration.
+ */
+export declare class ContentDiscovery {
+    private mutationObserver;
+    private document;
+    private focusEventSource;
+    private currentFocusedContent;
+    private currentSourceId;
+    private registeredContent;
+    constructor(mutationObserver: TextMutationObserver, document: DocumentProvider, focusEventSource: FocusEventSource);
+    /**
+     * Register body/header/footer content (always present).
+     */
+    private registerDocumentContent;
+    /**
+     * Set up tracking for dynamic content (tables, text boxes).
+     */
+    private setupFocusTracking;
+    /**
+     * Register a FlowingTextContent with the mutation observer.
+     */
+    registerContent(content: FlowingTextContent, sourceId: ContentSourceId): void;
+    /**
+     * Unregister a FlowingTextContent.
+     */
+    unregisterContent(content: FlowingTextContent): void;
+    /**
+     * Set the currently focused content.
+     */
+    private setCurrentFocus;
+    /**
+     * Clear the current focus.
+     */
+    private clearCurrentFocus;
+    /**
+     * Get the currently focused content.
+     */
+    getCurrentFocus(): {
+        content: FlowingTextContent;
+        sourceId: ContentSourceId;
+    } | null;
+    /**
+     * Get content for a document section.
+     */
+    private getContentForSection;
+    /**
+     * Get FlowingTextContent by source ID.
+     */
+    getContentBySourceId(sourceId: ContentSourceId): FlowingTextContent | null;
+    /**
+     * Check if two source IDs are the same.
+     */
+    private sameSourceId;
+    /**
+     * Register an embedded object for potential content tracking.
+     * Called when an object is inserted or focused.
+     */
+    registerObject(object: BaseEmbeddedObject): void;
+    /**
+     * Register all cells of a table.
+     */
+    private registerTableCells;
+    /**
+     * Unregister an object and its content.
+     */
+    unregisterObject(object: BaseEmbeddedObject): void;
+    /**
+     * Unregister all cells of a table.
+     */
+    private unregisterTableCells;
+    /**
+     * Clear all registrations.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ContentDiscovery.d.ts.map

package/dist/types/lib/undo/transaction/ContentDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentDiscovery.d.ts","sourceRoot":"","sources":["../../../../../src/lib/undo/transaction/ContentDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAA8B,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;CAMrD;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAG3C,OAAO,CAAC,qBAAqB,CAAmC;IAChE,OAAO,CAAC,eAAe,CAAgC;IAGvD,OAAO,CAAC,iBAAiB,CAAuD;gBAG9E,gBAAgB,EAAE,oBAAoB,EACtC,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,EAAE,gBAAgB;IAUpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoD1B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQ7E;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,eAAe,IAAI;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI;IAUpF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,kBAAkB,GAAG,IAAI;IAgB1E;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAiBhD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAUlD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/types/lib/undo/transaction/FocusTracker.d.ts

@@ -0,0 +1,49 @@
+/**
+ * FocusTracker - Captures and restores focus/cursor state.
+ *
+ * Tracks which content source is active (body, header, footer, table cell, textbox)
+ * and the cursor/selection state within that source.
+ */
+import { FocusState } from './types';
+import { FlowingTextContent } from '../../text/FlowingTextContent';
+/**
+ * Callback to get the currently active FlowingTextContent.
+ */
+export type GetActiveContentFn = () => {
+    content: FlowingTextContent | null;
+    section: 'body' | 'header' | 'footer';
+    focusedObjectId: string | null;
+    tableCellAddress: {
+        row: number;
+        col: number;
+    } | null;
+};
+/**
+ * Callback to restore focus to a specific state.
+ */
+export type RestoreFocusFn = (state: FocusState) => void;
+/**
+ * FocusTracker captures and restores focus state for undo/redo.
+ */
+export declare class FocusTracker {
+    private getActiveContent;
+    private restoreFocus;
+    constructor(getActiveContent: GetActiveContentFn, restoreFocus: RestoreFocusFn);
+    /**
+     * Capture the current focus state.
+     */
+    capture(): FocusState;
+    /**
+     * Restore focus to a previously captured state.
+     */
+    restore(state: FocusState): void;
+    /**
+     * Capture focus state for a specific FlowingTextContent.
+     * Used when we know exactly which content to capture from.
+     */
+    captureFromContent(content: FlowingTextContent, section: 'body' | 'header' | 'footer', focusedObjectId?: string | null, tableCellAddress?: {
+        row: number;
+        col: number;
+    } | null): FocusState;
+}
+//# sourceMappingURL=FocusTracker.d.ts.map

package/dist/types/lib/undo/transaction/FocusTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusTracker.d.ts","sourceRoot":"","sources":["../../../../../src/lib/undo/transaction/FocusTracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM;IACrC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEzD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,YAAY,CAAiB;gBAGnC,gBAAgB,EAAE,kBAAkB,EACpC,YAAY,EAAE,cAAc;IAM9B;;OAEG;IACH,OAAO,IAAI,UAAU;IAyBrB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIhC;;;OAGG;IACH,kBAAkB,CAChB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,EACrC,eAAe,GAAE,MAAM,GAAG,IAAW,EACrC,gBAAgB,GAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAW,GAC3D,UAAU;CAWd"}

package/dist/types/lib/undo/transaction/MutationUndo.d.ts

@@ -0,0 +1,57 @@
+/**
+ * MutationUndo - Handles undoing and redoing mutations.
+ *
+ * Provides the logic for reversing text and object mutations.
+ */
+import { FlowingTextContent } from '../../text/FlowingTextContent';
+import { MutationRecord, ContentSourceId, ObjectSourceId } from './types';
+import { BaseEmbeddedObject } from '../../objects';
+/**
+ * Callback to get a FlowingTextContent by source ID.
+ */
+export type GetContentFn = (sourceId: ContentSourceId) => FlowingTextContent | null;
+/**
+ * Callback to get an object by source ID.
+ */
+export type GetObjectFn = (sourceId: ObjectSourceId) => BaseEmbeddedObject | null;
+/**
+ * MutationUndo provides undo/redo logic for mutations.
+ */
+export declare class MutationUndo {
+    private getContent;
+    private getObject;
+    constructor(getContent: GetContentFn, getObject: GetObjectFn);
+    /**
+     * Undo a mutation.
+     */
+    undoMutation(mutation: MutationRecord): void;
+    /**
+     * Redo a mutation.
+     */
+    redoMutation(mutation: MutationRecord): void;
+    private undoInsert;
+    private redoInsert;
+    private undoDelete;
+    private redoDelete;
+    private undoFormat;
+    private redoFormat;
+    private undoAlignment;
+    private redoAlignment;
+    private undoFieldInsert;
+    private redoFieldInsert;
+    private undoFieldUpdate;
+    private redoFieldUpdate;
+    private undoObjectInsert;
+    private redoObjectInsert;
+    private undoObjectDelete;
+    private redoObjectDelete;
+    private undoResize;
+    private redoResize;
+    private undoMove;
+    private redoMove;
+    private undoProperty;
+    private redoProperty;
+    private undoTableStructure;
+    private redoTableStructure;
+}
+//# sourceMappingURL=MutationUndo.d.ts.map

package/dist/types/lib/undo/transaction/MutationUndo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationUndo.d.ts","sourceRoot":"","sources":["../../../../../src/lib/undo/transaction/MutationUndo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EAYf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAsC,MAAM,eAAe,CAAC;AAGvF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,kBAAkB,GAAG,IAAI,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,kBAAkB,GAAG,IAAI,CAAC;AAElF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,SAAS,CAAc;gBAEnB,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW;IAK5D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAgD5C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAkD5C,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/types/lib/undo/transaction/ObjectMutationObserver.d.ts

@@ -0,0 +1,79 @@
+/**
+ * ObjectMutationObserver - Intercepts object methods to capture mutations.
+ *
+ * Uses method wrapping to intercept object mutations (resize, move, table structure, properties)
+ * without requiring changes to the object classes themselves.
+ */
+import { BaseEmbeddedObject } from '../../objects';
+import { TransactionManager } from './TransactionManager';
+/**
+ * ObjectMutationObserver intercepts object methods to capture mutations.
+ */
+export declare class ObjectMutationObserver {
+    private manager;
+    private observedObjects;
+    constructor(manager: TransactionManager);
+    /**
+     * Find a property descriptor by traversing the prototype chain.
+     */
+    private findPropertyDescriptor;
+    /**
+     * Start observing an embedded object.
+     * Wraps mutation methods to intercept changes.
+     */
+    observe(object: BaseEmbeddedObject): void;
+    /**
+     * Wrap common object methods (resize, size setters, offset).
+     */
+    private wrapCommonMethods;
+    /**
+     * Wrap ImageObject property setters.
+     */
+    private wrapImageProperties;
+    /**
+     * Wrap TextBoxObject property setters.
+     */
+    private wrapTextBoxProperties;
+    /**
+     * Wrap TableObject-specific methods.
+     */
+    private wrapTableMethods;
+    /**
+     * Stop observing an embedded object.
+     * Restores original methods.
+     */
+    unobserve(object: BaseEmbeddedObject): void;
+    /**
+     * Check if an object is being observed.
+     */
+    isObserving(object: BaseEmbeddedObject): boolean;
+    /**
+     * Get the object type for an ObjectSourceId.
+     */
+    private getObjectType;
+    /**
+     * Create an ObjectState from current object data.
+     */
+    private createObjectState;
+    /**
+     * Record a resize mutation.
+     */
+    private recordResizeMutation;
+    /**
+     * Record a move mutation.
+     */
+    private recordMoveMutation;
+    /**
+     * Record a property mutation.
+     */
+    private recordPropertyMutation;
+    /**
+     * Record a table structure mutation.
+     */
+    private recordTableStructureMutation;
+    /**
+     * Capture a snapshot of table state for undo/redo.
+     */
+    private captureTableSnapshot;
+}
+//# sourceMappingURL=ObjectMutationObserver.d.ts.map

package/dist/types/lib/undo/transaction/ObjectMutationObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectMutationObserver.d.ts","sourceRoot":"","sources":["../../../../../src/lib/undo/transaction/ObjectMutationObserver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAA2C,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAyD1D;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,eAAe,CAMJ;gBAEP,OAAO,EAAE,kBAAkB;IAIvC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA8DzC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwGzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0E3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6I7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0FxB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAwD3C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO;IAIhD;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAwBpC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAG7B"}

package/dist/types/lib/undo/transaction/TextMutationObserver.d.ts

@@ -0,0 +1,60 @@
+/**
+ * TextMutationObserver - Intercepts FlowingTextContent methods to capture text mutations.
+ *
+ * Uses method wrapping to intercept mutations without requiring changes to FlowingTextContent.
+ * Each observed FlowingTextContent has its methods wrapped to capture before/after state.
+ */
+import { FlowingTextContent } from '../../text/FlowingTextContent';
+import { TransactionManager } from './TransactionManager';
+import { ContentSourceId } from './types';
+/**
+ * TextMutationObserver intercepts FlowingTextContent methods.
+ */
+export declare class TextMutationObserver {
+    private manager;
+    private observedContents;
+    constructor(manager: TransactionManager);
+    /**
+     * Start observing a FlowingTextContent instance.
+     * Wraps mutation methods to intercept changes.
+     */
+    observe(content: FlowingTextContent, sourceId: ContentSourceId): void;
+    /**
+     * Stop observing a FlowingTextContent instance.
+     * Restores original methods.
+     */
+    unobserve(content: FlowingTextContent): void;
+    /**
+     * Check if a FlowingTextContent is being observed.
+     */
+    isObserving(content: FlowingTextContent): boolean;
+    /**
+     * Get the source ID for a FlowingTextContent.
+     */
+    private getSourceId;
+    /**
+     * Capture current content state.
+     */
+    private captureState;
+    /**
+     * Capture formatting in a range.
+     */
+    private captureFormattingInRange;
+    /**
+     * Capture substitution fields in a range.
+     */
+    private captureFieldsInRange;
+    /**
+     * Capture embedded objects in a range.
+     */
+    private captureObjectsInRange;
+    /**
+     * Get paragraph index from cursor position and paragraph boundaries.
+     */
+    private getParagraphIndexFromBoundaries;
+    /**
+     * Record a mutation with the transaction manager.
+     */
+    private recordMutation;
+}
+//# sourceMappingURL=TextMutationObserver.d.ts.map

package/dist/types/lib/undo/transaction/TextMutationObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextMutationObserver.d.ts","sourceRoot":"","sources":["../../../../../src/lib/undo/transaction/TextMutationObserver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,eAAe,EAUhB,MAAM,SAAS,CAAC;AAqBjB;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,gBAAgB,CAGL;gBAEP,OAAO,EAAE,kBAAkB;IAIvC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IA0TrE;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAqB5C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO;IAIjD;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IASvC;;OAEG;IACH,OAAO,CAAC,cAAc;CAGvB"}