@productcloudos/editor 1.0.0

package/dist/types/lib/clipboard/ClipboardManager.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ClipboardManager handles copy, cut, and paste operations for the PC Editor.
+ *
+ * Supports:
+ * - Proprietary format (full fidelity)
+ * - Plain text
+ * - HTML (for interoperability)
+ * - Image paste
+ */
+import { EventEmitter } from '../events/EventEmitter';
+import type { FlowingTextContent } from '../text/FlowingTextContent';
+import { type PCEditorClipboardData, type ClipboardContent, type ClipboardReadResult, type CopyOptions, type PasteOptions } from './types';
+/**
+ * Manages clipboard operations for the editor.
+ */
+export declare class ClipboardManager extends EventEmitter {
+    private htmlConverter;
+    constructor();
+    /**
+     * Copy the selected content from a FlowingTextContent to the clipboard.
+     * Returns true if content was copied, false if nothing was selected.
+     */
+    copy(flowingContent: FlowingTextContent, options?: CopyOptions): Promise<boolean>;
+    private cachedClipboardData;
+    /**
+     * Read content from the clipboard.
+     * Returns the best available format.
+     */
+    read(options?: PasteOptions): Promise<ClipboardReadResult>;
+    /**
+     * Extract content from a FlowingTextContent for a given range.
+     * All indices in the result are relative to the start of the selection (0-based).
+     */
+    extractSelectionContent(flowingContent: FlowingTextContent, start: number, end: number): PCEditorClipboardData;
+    /**
+     * Extract formatting runs for a range, adjusting indices to be 0-based.
+     */
+    private extractFormattingRuns;
+    /**
+     * Extract paragraph formatting for a range, adjusting indices to be 0-based.
+     */
+    private extractParagraphFormatting;
+    /**
+     * Extract substitution fields in a range, adjusting indices to be 0-based.
+     */
+    private extractSubstitutionFields;
+    /**
+     * Extract embedded objects in a range, adjusting indices to be 0-based.
+     */
+    private extractEmbeddedObjects;
+    /**
+     * Extract hyperlinks in a range, adjusting indices to be 0-based.
+     */
+    private extractHyperlinks;
+    /**
+     * Extract plain text from content, replacing embedded objects with placeholders.
+     */
+    private extractPlainText;
+    /**
+     * Parse HTML content into clipboard data format.
+     */
+    parseHtml(html: string): ClipboardContent;
+    /**
+     * Generate new IDs for all items in clipboard content.
+     * This is needed when pasting to avoid ID conflicts.
+     */
+    generateNewIds(content: ClipboardContent): ClipboardContent;
+    /**
+     * Create an ImageObject data from a Blob.
+     */
+    createImageFromBlob(blob: Blob): Promise<{
+        dataUrl: string;
+        width: number;
+        height: number;
+    }>;
+}
+//# sourceMappingURL=ClipboardManager.d.ts.map

package/dist/types/lib/clipboard/ClipboardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClipboardManager.d.ts","sourceRoot":"","sources":["../../../../src/lib/clipboard/ClipboardManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AASrE,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAErB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,aAAa,CAAgB;;IAOrC;;;OAGG;IACG,IAAI,CACR,cAAc,EAAE,kBAAkB,EAClC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,OAAO,CAAC;IA0DnB,OAAO,CAAC,mBAAmB,CAAsC;IAEjE;;;OAGG;IACG,IAAI,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0EpE;;;OAGG;IACH,uBAAuB,CACrB,cAAc,EAAE,kBAAkB,EAClC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,qBAAqB;IA8CxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkD7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwClC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAIzC;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB;IA4C3D;;OAEG;IACG,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAsBnG"}

package/dist/types/lib/clipboard/HtmlConverter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * HtmlConverter handles conversion between PC Editor content and HTML.
+ * Used for clipboard interoperability with external applications.
+ */
+import type { ClipboardContent } from './types';
+/**
+ * Converts between PC Editor content format and HTML.
+ */
+export declare class HtmlConverter {
+    /**
+     * Convert clipboard content to HTML string.
+     */
+    toHtml(content: ClipboardContent): string;
+    /**
+     * Parse HTML string into clipboard content format.
+     */
+    fromHtml(html: string): ClipboardContent;
+    /**
+     * Process a DOM node and extract text with formatting.
+     */
+    private processNode;
+    /**
+     * Extract formatting from an HTML element.
+     */
+    private extractFormatting;
+    /**
+     * Compare two formatting objects for equality.
+     */
+    private formattingEquals;
+    /**
+     * Create an HTML span with inline styles from formatting.
+     */
+    private createStyledSpan;
+    /**
+     * Escape HTML special characters.
+     */
+    private escapeHtml;
+    /**
+     * Normalize a color value to hex format.
+     */
+    private normalizeColor;
+}
+//# sourceMappingURL=HtmlConverter.d.ts.map

package/dist/types/lib/clipboard/HtmlConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlConverter.d.ts","sourceRoot":"","sources":["../../../../src/lib/clipboard/HtmlConverter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM;IAsDzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAoBxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAyDnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiDzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,cAAc;CAavB"}

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

@@ -0,0 +1,9 @@
+/**
+ * Clipboard module for PC Editor.
+ * Provides copy, cut, and paste functionality with support for
+ * proprietary format, HTML, plain text, and images.
+ */
+export { ClipboardManager } from './ClipboardManager';
+export { HtmlConverter } from './HtmlConverter';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/clipboard/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,76 @@
+/**
+ * Clipboard types for PC Editor copy/paste functionality.
+ */
+import type { TextFormattingRunData, ParagraphFormattingData, SubstitutionFieldData, EmbeddedObjectReference, HyperlinkSerializedData } from '../types';
+export declare const CLIPBOARD_FORMAT_VERSION = "1.0.0";
+export declare const PCEDITOR_MIME_TYPE = "application/x-pceditor-content";
+/**
+ * Type of content in the clipboard.
+ */
+export type ClipboardContentType = 'text' | 'object' | 'mixed';
+/**
+ * The proprietary clipboard format for PC Editor.
+ * Contains all information needed to preserve full fidelity on paste.
+ */
+export interface PCEditorClipboardData {
+    version: string;
+    type: ClipboardContentType;
+    content: ClipboardContent;
+    metadata?: ClipboardMetadata;
+}
+/**
+ * The actual content being copied.
+ */
+export interface ClipboardContent {
+    /** The plain text content (with U+FFFC for embedded objects) */
+    text: string;
+    /** Text formatting runs, with indices relative to the copied text (0-based) */
+    formattingRuns?: TextFormattingRunData[];
+    /** Paragraph formatting, with indices relative to the copied text (0-based) */
+    paragraphFormatting?: ParagraphFormattingData[];
+    /** Substitution fields, with indices relative to the copied text (0-based) */
+    substitutionFields?: SubstitutionFieldData[];
+    /** Embedded objects, with indices relative to the copied text (0-based) */
+    embeddedObjects?: EmbeddedObjectReference[];
+    /** Hyperlinks, with indices relative to the copied text (0-based) */
+    hyperlinks?: HyperlinkSerializedData[];
+}
+/**
+ * Metadata about the copy operation.
+ */
+export interface ClipboardMetadata {
+    /** Which section the content was copied from */
+    sourceSection?: 'header' | 'body' | 'footer';
+    /** If copied from a text box or table cell, the object ID */
+    sourceObjectId?: string;
+    /** Timestamp of when the content was copied */
+    copiedAt?: string;
+}
+/**
+ * Result of reading from the clipboard.
+ */
+export interface ClipboardReadResult {
+    /** The format that was successfully read */
+    type: 'pceditor' | 'html' | 'text' | 'image' | 'empty';
+    /** The data read from clipboard */
+    data: PCEditorClipboardData | string | Blob | null;
+}
+/**
+ * Options for the copy operation.
+ */
+export interface CopyOptions {
+    /** Include plain text fallback (default: true) */
+    includePlainText?: boolean;
+    /** Include HTML fallback (default: true) */
+    includeHtml?: boolean;
+}
+/**
+ * Options for the paste operation.
+ */
+export interface PasteOptions {
+    /** Preferred format to paste (default: auto-detect best available) */
+    preferredFormat?: 'pceditor' | 'html' | 'text';
+    /** If true, paste as plain text only, stripping all formatting */
+    asPlainText?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/clipboard/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzC,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAChD,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC7C,2EAA2E;IAC3E,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC5C,qEAAqE;IACrE,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,aAAa,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvD,mCAAmC;IACnC,IAAI,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,eAAe,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/types/lib/controls/BaseControl.d.ts

@@ -0,0 +1,72 @@
+/**
+ * BaseControl - Abstract base class for all editor controls.
+ *
+ * Controls are optional components that work with PCEditor via the public API only.
+ * They are completely decoupled from the core library.
+ */
+import { EventEmitter } from '../events/EventEmitter';
+import type { PCEditor } from '../core/PCEditor';
+import type { EditorControl, ControlAttachOptions, ControlOptions } from './types';
+/**
+ * Abstract base class for editor controls.
+ */
+export declare abstract class BaseControl extends EventEmitter implements EditorControl {
+    readonly id: string;
+    protected _isAttached: boolean;
+    protected _isVisible: boolean;
+    protected editor: PCEditor | null;
+    protected container: HTMLElement | null;
+    protected element: HTMLElement | null;
+    protected eventCleanup: Array<() => void>;
+    constructor(id: string, options?: ControlOptions);
+    get isAttached(): boolean;
+    get isVisible(): boolean;
+    /**
+     * Attach the control to an editor.
+     */
+    attach(options: ControlAttachOptions): void;
+    /**
+     * Detach the control from the editor.
+     */
+    detach(): void;
+    /**
+     * Show the control.
+     */
+    show(): void;
+    /**
+     * Hide the control.
+     */
+    hide(): void;
+    /**
+     * Toggle visibility.
+     */
+    toggle(): void;
+    /**
+     * Clean up and destroy the control.
+     */
+    destroy(): void;
+    /**
+     * Create the control's DOM element.
+     * Subclasses must implement this.
+     */
+    protected abstract createElement(): HTMLElement;
+    /**
+     * Set up event listeners on the editor.
+     * Subclasses should override this to add their own listeners.
+     */
+    protected setupEventListeners(): void;
+    /**
+     * Clean up event listeners.
+     */
+    protected cleanupEventListeners(): void;
+    /**
+     * Add an event listener with automatic cleanup.
+     */
+    protected addEditorListener<T>(event: string, handler: (data: T) => void): void;
+    /**
+     * Update the control's display.
+     * Subclasses must implement this.
+     */
+    abstract update(): void;
+}
+//# sourceMappingURL=BaseControl.d.ts.map

package/dist/types/lib/controls/BaseControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/controls/BaseControl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnF;;GAEG;AACH,8BAAsB,WAAY,SAAQ,YAAa,YAAW,aAAa;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,WAAW,EAAE,OAAO,CAAS;IACvC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAQ;IACrC,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACzC,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC/C,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC7C,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAM;gBAEnC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAMpD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IA4B3C;;OAEG;IACH,MAAM,IAAI,IAAI;IAqBd;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,WAAW;IAE/C;;;OAGG;IACH,SAAS,CAAC,mBAAmB,IAAI,IAAI;IAIrC;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAOvC;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GACzB,IAAI;IAOP;;;OAGG;IACH,QAAQ,CAAC,MAAM,IAAI,IAAI;CACxB"}

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

@@ -0,0 +1,11 @@
+/**
+ * Optional editor controls module.
+ *
+ * Controls are standalone components that interact with PCEditor
+ * via the public API only. They are completely decoupled from the core library.
+ */
+export { BaseControl } from './BaseControl';
+export * from './types';
+export { RulerControl, HorizontalRuler, VerticalRuler } from './rulers';
+export type { RulerOptions, RulerOrientation, TickMark } from './rulers';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/controls/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACT,MAAM,UAAU,CAAC"}

package/dist/types/lib/controls/rulers/HorizontalRuler.d.ts

@@ -0,0 +1,55 @@
+/**
+ * HorizontalRuler - Horizontal ruler control that displays above the editor canvas.
+ *
+ * This control only uses the PCEditor public API - no DOM queries into the editor.
+ */
+import { RulerControl } from './RulerControl';
+import type { RulerOptions, RulerOrientation, TickMark } from './types';
+/**
+ * Horizontal ruler control.
+ */
+export declare class HorizontalRuler extends RulerControl {
+    protected readonly orientation: RulerOrientation;
+    private contentOffsetX;
+    constructor(options?: RulerOptions);
+    /**
+     * Update scroll offset from the editor API.
+     */
+    protected updateScrollOffset(): void;
+    /**
+     * Get the content offset for horizontal orientation.
+     */
+    protected getContentOffset(): number;
+    /**
+     * Update from document metrics.
+     */
+    protected updateFromMetrics(metrics: {
+        pageWidth: number;
+        pageHeight: number;
+        margins: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+        totalPages: number;
+    } | null): void;
+    /**
+     * Calculate tick marks for the page, stopping at the page edge.
+     * Overrides the base class method to limit ticks to page width.
+     */
+    protected calculateTickMarks(): TickMark[];
+    /**
+     * Render margin indicators.
+     */
+    protected renderMargins(width: number, height: number): void;
+    /**
+     * Render tick marks.
+     */
+    protected renderTicks(ticks: TickMark[], _width: number, height: number): void;
+    /**
+     * Render cursor position indicator.
+     */
+    protected renderCursorIndicator(_width: number, height: number): void;
+}
+//# sourceMappingURL=HorizontalRuler.d.ts.map

package/dist/types/lib/controls/rulers/HorizontalRuler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HorizontalRuler.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controls/rulers/HorizontalRuler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAgB;IAChE,OAAO,CAAC,cAAc,CAAa;gBAEvB,OAAO,GAAE,YAAiB;IAItC;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAMpC;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAIpC;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,GAAG,IAAI;IAkBf;;;OAGG;IACH,SAAS,CAAC,kBAAkB,IAAI,QAAQ,EAAE;IAyC1C;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA0C5D;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAmC9E;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CActE"}

package/dist/types/lib/controls/rulers/RulerControl.d.ts

@@ -0,0 +1,98 @@
+/**
+ * RulerControl - Base class for horizontal and vertical rulers.
+ *
+ * Provides common functionality for calculating tick marks,
+ * rendering, and responding to editor events.
+ */
+import { BaseControl } from '../BaseControl';
+import { RulerOptions, RulerOrientation, TickMark } from './types';
+/**
+ * Abstract base class for ruler controls.
+ */
+export declare abstract class RulerControl extends BaseControl {
+    protected options: Required<RulerOptions>;
+    protected canvas: HTMLCanvasElement | null;
+    protected ctx: CanvasRenderingContext2D | null;
+    protected currentMousePosition: number | null;
+    protected zoomLevel: number;
+    protected scrollOffset: number;
+    protected documentSize: number;
+    protected marginStart: number;
+    protected marginEnd: number;
+    protected abstract readonly orientation: RulerOrientation;
+    constructor(id: string, options?: RulerOptions);
+    private resizeObserver;
+    /**
+     * Create the ruler element.
+     */
+    protected createElement(): HTMLElement;
+    /**
+     * Set up mouse position tracking.
+     */
+    protected setupMouseTracking(element: HTMLElement): void;
+    /**
+     * Set up event listeners on the editor.
+     */
+    protected setupEventListeners(): void;
+    /**
+     * Clean up event listeners and observers.
+     */
+    protected cleanupEventListeners(): void;
+    /**
+     * Update scroll offset from the editor.
+     */
+    protected abstract updateScrollOffset(): void;
+    /**
+     * Update the ruler based on current editor state.
+     */
+    update(): void;
+    /**
+     * Update ruler state from document metrics.
+     */
+    protected abstract updateFromMetrics(metrics: {
+        pageWidth: number;
+        pageHeight: number;
+        margins: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+        totalPages: number;
+    } | null): void;
+    /**
+     * Resize the canvas to match the container.
+     */
+    protected resizeCanvas(): void;
+    /**
+     * Calculate tick marks for the visible portion of the ruler.
+     * Takes into account the content offset to generate ticks for the
+     * document range that's currently visible.
+     */
+    protected calculateTickMarks(): TickMark[];
+    /**
+     * Get the content offset for this ruler orientation.
+     */
+    protected abstract getContentOffset(): number;
+    /**
+     * Get the visible length of the ruler.
+     */
+    protected getVisibleLength(): number;
+    /**
+     * Render the ruler.
+     */
+    protected render(): void;
+    /**
+     * Render margin indicators.
+     */
+    protected abstract renderMargins(width: number, height: number): void;
+    /**
+     * Render tick marks.
+     */
+    protected abstract renderTicks(ticks: TickMark[], width: number, height: number): void;
+    /**
+     * Render the cursor position indicator.
+     */
+    protected abstract renderCursorIndicator(width: number, height: number): void;
+}
+//# sourceMappingURL=RulerControl.d.ts.map

package/dist/types/lib/controls/rulers/RulerControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RulerControl.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controls/rulers/RulerControl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EAGT,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,8BAAsB,YAAa,SAAQ,WAAW;IACpD,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC1C,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAClD,SAAS,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI,CAAQ;IACtD,SAAS,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACrD,SAAS,CAAC,SAAS,EAAE,MAAM,CAAK;IAChC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAK;IACnC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAK;IACnC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAK;IAClC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAK;IAEhC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;gBAE9C,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;IAKlD,OAAO,CAAC,cAAc,CAA+B;IAErD;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,WAAW;IA+CtC;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAyBxD;;OAEG;IACH,SAAS,CAAC,mBAAmB,IAAI,IAAI;IAgCrC;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAQvC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,IAAI;IAE7C;;OAEG;IACH,MAAM,IAAI,IAAI;IAqBd;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,EAAE;QAC5C,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,GAAG,IAAI;IAEf;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IA8B9B;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,QAAQ,EAAE;IAwC1C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,MAAM;IAE7C;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAMpC;;OAEG;IACH,SAAS,CAAC,MAAM,IAAI,IAAI;IA6BxB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAErE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAEtF;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAC9E"}

package/dist/types/lib/controls/rulers/VerticalRuler.d.ts

@@ -0,0 +1,65 @@
+/**
+ * VerticalRuler - Vertical ruler control that displays to the left of the editor canvas.
+ *
+ * This control only uses the PCEditor public API - no DOM queries into the editor.
+ *
+ * The vertical ruler shows measurements starting from 0 at the top of each page,
+ * with gray areas displayed in the gaps between pages.
+ */
+import { RulerControl } from './RulerControl';
+import type { RulerOptions, RulerOrientation, TickMark } from './types';
+/**
+ * Vertical ruler control.
+ */
+export declare class VerticalRuler extends RulerControl {
+    protected readonly orientation: RulerOrientation;
+    private contentOffsetY;
+    private pageHeightPx;
+    private pageGap;
+    private totalPages;
+    constructor(options?: RulerOptions);
+    /**
+     * Update scroll offset from the editor API.
+     */
+    protected updateScrollOffset(): void;
+    /**
+     * Get the content offset for vertical orientation.
+     */
+    protected getContentOffset(): number;
+    /**
+     * Update from document metrics.
+     */
+    protected updateFromMetrics(metrics: {
+        pageWidth: number;
+        pageHeight: number;
+        margins: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+        totalPages: number;
+    } | null): void;
+    /**
+     * Render margin indicators - gray areas before document, after document, and between pages.
+     */
+    protected renderMargins(width: number, height: number): void;
+    /**
+     * Calculate tick marks for each page, starting from 0 at the top of each page.
+     * Overrides the base class method to handle per-page measurements.
+     */
+    protected calculateTickMarks(): TickMark[];
+    /**
+     * Render tick marks.
+     */
+    protected renderTicks(ticks: TickMark[], width: number, _height: number): void;
+    /**
+     * Check if a position (in document coordinates) falls within a page gap.
+     */
+    private isInPageGap;
+    /**
+     * Render cursor position indicator.
+     */
+    protected renderCursorIndicator(width: number, _height: number): void;
+}
+//# sourceMappingURL=VerticalRuler.d.ts.map

package/dist/types/lib/controls/rulers/VerticalRuler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VerticalRuler.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controls/rulers/VerticalRuler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxE;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAc;IAC9D,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAa;gBAEnB,OAAO,GAAE,YAAiB;IAItC;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAMpC;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAIpC;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,GAAG,IAAI;IAyBf;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA0D5D;;;OAGG;IACH,SAAS,CAAC,kBAAkB,IAAI,QAAQ,EAAE;IA4C1C;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA4C9E;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CActE"}

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

@@ -0,0 +1,8 @@
+/**
+ * Ruler controls module.
+ */
+export { RulerControl } from './RulerControl';
+export { HorizontalRuler } from './HorizontalRuler';
+export { VerticalRuler } from './VerticalRuler';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controls/rulers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,cAAc,SAAS,CAAC"}

package/dist/types/lib/controls/rulers/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Types for ruler controls.
+ */
+import type { Units, ControlOptions } from '../types';
+/**
+ * Options for creating a ruler control.
+ */
+export interface RulerOptions extends ControlOptions {
+    /** Measurement units to display */
+    units?: Units;
+    /** Interval for major tick marks (in the specified units) */
+    majorTickInterval?: number;
+    /** Number of minor ticks between major ticks */
+    minorTicksPerMajor?: number;
+    /** Whether to show labels on major ticks */
+    showLabels?: boolean;
+    /** Thickness of the ruler in pixels */
+    thickness?: number;
+    /** Background color */
+    backgroundColor?: string;
+    /** Color for tick marks */
+    tickColor?: string;
+    /** Color for labels */
+    labelColor?: string;
+    /** Color for the active position indicator */
+    activeColor?: string;
+    /** Font size for labels */
+    labelFontSize?: number;
+    /** Whether to show margin indicators */
+    showMargins?: boolean;
+    /** Color for margin indicators */
+    marginColor?: string;
+}
+/**
+ * Default ruler options.
+ */
+export declare const DEFAULT_RULER_OPTIONS: Required<RulerOptions>;
+/**
+ * Ruler orientation.
+ */
+export type RulerOrientation = 'horizontal' | 'vertical';
+/**
+ * A tick mark on the ruler.
+ */
+export interface TickMark {
+    /** Position in pixels (from ruler start) */
+    position: number;
+    /** Whether this is a major tick */
+    isMajor: boolean;
+    /** Label text (for major ticks with labels) */
+    label?: string;
+}
+/**
+ * Conversion factors from various units to pixels.
+ * Based on 96 DPI standard.
+ */
+export declare const PIXELS_PER_UNIT: Record<Units, number>;
+/**
+ * Get pixels per unit for a given unit type.
+ */
+export declare function getPixelsPerUnit(units: Units): number;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/lib/controls/rulers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controls/rulers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAcxD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAKjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAErD"}