@nocturnium/svelte-ide 1.0.0-rc.1

package/dist/components/editor/core/state.d.ts

@@ -0,0 +1,367 @@
+/**
+ * Core editor state management
+ *
+ * This module provides the fundamental state management for the custom editor,
+ * handling document content, cursor positions, selections, and history.
+ * Supports multi-cursor editing with automatic cursor merging.
+ */
+import type { TokenizedLine } from '../tokenizer/types';
+import { CursorManager, type Cursor } from './multi-cursor';
+/**
+ * Position in the document
+ */
+export interface Position {
+    /** Line number (0-based) */
+    line: number;
+    /** Column number (0-based, represents character index in line) */
+    column: number;
+}
+/**
+ * A selection range in the document
+ */
+export interface Selection {
+    /** Start of selection (anchor) */
+    anchor: Position;
+    /** End of selection (head/cursor position) */
+    head: Position;
+}
+/**
+ * A single line in the document
+ */
+export interface Line {
+    /** Line number (0-based) */
+    number: number;
+    /** Raw text content */
+    text: string;
+    /** Tokenized content for syntax highlighting */
+    tokens?: TokenizedLine;
+}
+/**
+ * History entry for undo/redo
+ */
+export interface HistoryEntry {
+    /** Document content before this change */
+    content: string;
+    /** Selection state before this change (deprecated, use cursors) */
+    selection: Selection;
+    /** All cursors state before this change */
+    cursors?: Cursor[];
+    /** Primary cursor ID */
+    primaryCursorId?: string;
+    /** Timestamp of the change */
+    timestamp: number;
+}
+/**
+ * Editor state configuration
+ */
+export interface EditorStateConfig {
+    /** Initial document content */
+    content?: string;
+    /** Language for syntax highlighting */
+    language?: string;
+    /** Maximum history entries */
+    maxHistorySize?: number;
+    /** Tab size in spaces */
+    tabSize?: number;
+    /** Insert spaces instead of tabs */
+    insertSpaces?: boolean;
+    /** Maximum number of cursors (default: 100) */
+    maxCursors?: number;
+}
+/**
+ * Change event for document updates
+ */
+export interface ChangeEvent {
+    /** Type of change */
+    type: 'insert' | 'delete' | 'replace';
+    /** Start position of change */
+    from: Position;
+    /** End position of change (for delete/replace) */
+    to?: Position;
+    /** Inserted text (for insert/replace) */
+    text?: string;
+    /** Removed text (for delete/replace) */
+    removed?: string;
+}
+/**
+ * Core editor state class
+ */
+export declare class EditorState {
+    /** Document lines */
+    private _lines;
+    /** Multi-cursor manager */
+    private _cursorManager;
+    /** Language for syntax highlighting */
+    private _language;
+    /** Tokenizer state for incremental tokenization */
+    private _tokenizerStates;
+    /** Undo history */
+    private _undoStack;
+    /** Redo history */
+    private _redoStack;
+    /** Maximum history size */
+    private maxHistorySize;
+    /** Tab settings */
+    private tabSize;
+    private insertSpaces;
+    /** Maximum listeners per type to prevent memory leaks */
+    private static readonly MAX_LISTENERS;
+    /** Change listeners */
+    private changeListeners;
+    /** Selection change listeners */
+    private selectionListeners;
+    /** Cursor change listeners (for multi-cursor) */
+    private cursorListeners;
+    /** Undo grouping: timestamp of last history save */
+    private lastHistoryTimestamp;
+    /** Undo grouping: type of last change */
+    private lastHistoryType;
+    /** Undo grouping: time window in ms for grouping consecutive edits */
+    private readonly historyGroupTimeout;
+    /** Cached content string (invalidated on changes) */
+    private _contentCache;
+    /** Flag to suppress notifications during atomic operations (e.g., CRDT sync) */
+    private _suppressNotifications;
+    constructor(config?: EditorStateConfig);
+    /**
+     * Get all lines
+     */
+    get lines(): readonly Line[];
+    /**
+     * Get line count
+     */
+    get lineCount(): number;
+    /**
+     * Get a specific line
+     */
+    getLine(lineNumber: number): Line | undefined;
+    /**
+     * Get document content as string (cached for performance)
+     */
+    getContent(): string;
+    /**
+     * Invalidate content cache (call when lines change)
+     */
+    private invalidateContentCache;
+    /**
+     * Set document content (replaces everything)
+     */
+    setContent(content: string): void;
+    /**
+     * Get current language
+     */
+    get language(): string;
+    /**
+     * Set language (triggers re-tokenization)
+     */
+    setLanguage(language: string): void;
+    /**
+     * Get current selection (primary cursor)
+     */
+    get selection(): Selection;
+    /**
+     * Get cursor position (primary cursor head)
+     */
+    get cursor(): Position;
+    /**
+     * Check if primary cursor has a selection
+     */
+    get hasSelection(): boolean;
+    /**
+     * Get normalized selection (start before end) for primary cursor
+     */
+    get normalizedSelection(): {
+        start: Position;
+        end: Position;
+    };
+    /**
+     * Set cursor position (clears selection, affects primary cursor only)
+     */
+    setCursor(position: Position): void;
+    /**
+     * Set selection range (affects primary cursor only, clears secondary cursors)
+     */
+    setSelection(anchor: Position, head: Position): void;
+    /**
+     * Extend selection to position (keeps anchor, primary cursor only)
+     */
+    extendSelection(head: Position): void;
+    /**
+     * Select all
+     */
+    selectAll(): void;
+    /**
+     * Get selected text (primary cursor)
+     */
+    getSelectedText(): string;
+    /**
+     * Get selected text from all cursors
+     * Joins multiple selections with newlines (VS Code behavior)
+     */
+    getSelectedTextFromAllCursors(): string;
+    /**
+     * Check if any cursor has a selection
+     */
+    get hasAnySelection(): boolean;
+    /**
+     * Get text within a selection range
+     */
+    getTextInSelection(selection: Selection): string;
+    /**
+     * Get cursor manager for advanced multi-cursor operations
+     */
+    get cursorManager(): CursorManager;
+    /**
+     * Get all cursors
+     */
+    get allCursors(): readonly Cursor[];
+    /**
+     * Get primary cursor
+     */
+    get primaryCursor(): Cursor;
+    /**
+     * Check if there are multiple cursors
+     */
+    get hasMultipleCursors(): boolean;
+    /**
+     * Add a new cursor at position
+     */
+    addCursor(position: Position, makePrimary?: boolean): Cursor;
+    /**
+     * Add a cursor with selection
+     */
+    addCursorWithSelection(anchor: Position, head: Position, makePrimary?: boolean): Cursor;
+    /**
+     * Add cursor above primary cursor
+     */
+    addCursorAbove(): boolean;
+    /**
+     * Add cursor below primary cursor
+     */
+    addCursorBelow(): boolean;
+    /**
+     * Remove last added secondary cursor
+     */
+    removeLastCursor(): boolean;
+    /**
+     * Clear all secondary cursors
+     */
+    clearSecondaryCursors(): void;
+    /**
+     * Insert text at all cursor positions
+     */
+    insert(text: string): void;
+    /**
+     * Insert text at a specific position (internal, doesn't update cursor)
+     * @returns New position after insert
+     */
+    private insertAtInternal;
+    /**
+     * Insert text at a specific position (public API - single cursor)
+     */
+    insertAt(position: Position, text: string): void;
+    /**
+     * Delete the current selection (all cursors)
+     */
+    deleteSelection(): void;
+    /**
+     * Delete a range of text (internal, doesn't update cursor)
+     */
+    private deleteRangeInternal;
+    /**
+     * Delete a range of text (public API - single cursor)
+     */
+    deleteRange(from: Position, to: Position): void;
+    /**
+     * Delete character before all cursors (backspace)
+     */
+    deleteBackward(): void;
+    /**
+     * Delete character after all cursors (delete key)
+     */
+    deleteForward(): void;
+    /**
+     * Insert a new line (enter key)
+     */
+    insertNewline(): void;
+    /**
+     * Insert tab
+     */
+    insertTab(): void;
+    /**
+     * Save current state to history with optional grouping
+     * @param changeType - Type of change for grouping consecutive edits
+     */
+    private saveHistory;
+    /**
+     * Undo last change
+     */
+    undo(): boolean;
+    /**
+     * Redo last undone change
+     */
+    redo(): boolean;
+    /**
+     * Deep copy a selection to prevent reference issues in history
+     */
+    private deepCopySelection;
+    /**
+     * Check if undo is available
+     */
+    get canUndo(): boolean;
+    /**
+     * Check if redo is available
+     */
+    get canRedo(): boolean;
+    /**
+     * Compare two tokenizer states for equality
+     */
+    private tokenizerStatesEqual;
+    /**
+     * Re-tokenize a range of lines with early-exit optimization
+     */
+    private retokenize;
+    /**
+     * Clamp a position to valid document bounds
+     */
+    private clampPosition;
+    /**
+     * Get end position of document
+     */
+    private endPosition;
+    /**
+     * Renumber lines from a starting point
+     */
+    private renumberLines;
+    /**
+     * Helper to add a listener with overflow protection
+     * In development mode, throws an error to catch memory leaks early.
+     * In production, warns and evicts the oldest listener.
+     */
+    private addListener;
+    /**
+     * Add change listener
+     */
+    onContentChange(callback: (event: ChangeEvent) => void): () => void;
+    /**
+     * Add selection change listener
+     */
+    onSelectionChange(callback: (selection: Selection) => void): () => void;
+    /**
+     * Add cursor change listener (for multi-cursor updates)
+     */
+    onCursorChange(callback: (cursors: readonly Cursor[]) => void): () => void;
+    private emitChange;
+    private emitSelectionChange;
+    private emitCursorChange;
+    /**
+     * Run a function with notifications suppressed.
+     * Useful for atomic operations like CRDT sync where we want to
+     * update content and selection without triggering intermediate events.
+     */
+    runWithoutNotifications<T>(fn: () => T): T;
+}
+/**
+ * Create editor state
+ */
+export declare function createEditorState(config?: EditorStateConfig): EditorState;