@termaxjs/editor-core 0.1.1

package/dist/collab/AwarenessState.js

@@ -0,0 +1,76 @@
+/**
+ * Manages multi-user presence, remote cursors, and active selections.
+ */
+export class AwarenessManager {
+    localClientId;
+    localUser;
+    peers = new Map();
+    listeners = new Set();
+    constructor(clientId, name = "Anonymous", color = "#58a6ff") {
+        this.localClientId = clientId;
+        this.localUser = {
+            clientId,
+            name,
+            color,
+            cursor: { line: 0, column: 0 },
+            selection: null,
+            lastActive: Date.now(),
+        };
+    }
+    setLocalState(cursor, selection = null) {
+        this.localUser.cursor = { ...cursor };
+        this.localUser.selection = selection ? { ...selection } : null;
+        this.localUser.lastActive = Date.now();
+        this.notify();
+    }
+    setLocalUserProfile(name, color) {
+        this.localUser.name = name;
+        this.localUser.color = color;
+        this.localUser.lastActive = Date.now();
+        this.notify();
+    }
+    getLocalUser() {
+        return { ...this.localUser };
+    }
+    updateRemotePeer(peer) {
+        if (peer.clientId === this.localClientId)
+            return;
+        this.peers.set(peer.clientId, { ...peer, lastActive: Date.now() });
+        this.notify();
+    }
+    removeRemotePeer(clientId) {
+        if (this.peers.delete(clientId)) {
+            this.notify();
+        }
+    }
+    getRemotePeers() {
+        this.pruneStalePeers();
+        return Array.from(this.peers.values());
+    }
+    pruneStalePeers(timeoutMs = 30000) {
+        const now = Date.now();
+        let changed = false;
+        for (const [id, peer] of this.peers.entries()) {
+            if (now - peer.lastActive > timeoutMs) {
+                this.peers.delete(id);
+                changed = true;
+            }
+        }
+        if (changed)
+            this.notify();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getRemotePeers());
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify() {
+        const peers = this.getRemotePeers();
+        for (const listener of this.listeners) {
+            listener(peers);
+        }
+    }
+}
+//# sourceMappingURL=AwarenessState.js.map

package/dist/collab/AwarenessState.js.map

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

package/dist/collab/CollabProvider.d.ts

@@ -0,0 +1,45 @@
+import type { PieceTable } from "../buffer/PieceTable.js";
+export interface CollabDelta {
+    type: "insert" | "delete";
+    from: number;
+    to?: number;
+    text?: string;
+    clientId: string;
+    clock: number;
+}
+export type CollabDeltaBroadcast = (delta: CollabDelta) => void;
+/**
+ * Live Collaborative Editing CRDT Engine.
+ * Supports multi-client real-time synchronization with local undo isolation.
+ */
+export declare class CollabProvider {
+    readonly clientId: string;
+    private clock;
+    private broadcast;
+    private localUndoStack;
+    private localRedoStack;
+    constructor(clientId: string, broadcast?: CollabDeltaBroadcast);
+    setBroadcast(broadcast: CollabDeltaBroadcast): void;
+    /**
+     * Apply a local edit initiated by the current user.
+     */
+    applyLocalInsert(doc: PieceTable, offset: number, text: string): CollabDelta;
+    /**
+     * Apply a local deletion initiated by the current user.
+     */
+    applyLocalDelete(doc: PieceTable, from: number, length: number): CollabDelta;
+    /**
+     * Ingest and apply a remote delta from another client.
+     * Remote edits do NOT pollute the local undo stack.
+     */
+    applyRemoteDelta(doc: PieceTable, delta: CollabDelta): void;
+    /**
+     * Revert the most recent edit made specifically by the local user.
+     */
+    undoLocal(doc: PieceTable): CollabDelta | null;
+    /**
+     * Redo the most recent undone local edit.
+     */
+    redoLocal(doc: PieceTable): CollabDelta | null;
+}
+//# sourceMappingURL=CollabProvider.d.ts.map

package/dist/collab/CollabProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabProvider.d.ts","sourceRoot":"","sources":["../../src/collab/CollabProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAOhE;;;GAGG;AACH,qBAAa,cAAc;IACzB,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,cAAc,CAAyB;gBAEnC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,oBAAoB;IAKvD,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAI1D;;OAEG;IACI,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAkBnF;;OAEG;IACI,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW;IAmBnF;;;OAGG;IACI,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAgBlE;;OAEG;IACI,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAqCrD;;OAEG;IACI,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;CAkCtD"}

package/dist/collab/CollabProvider.js

@@ -0,0 +1,153 @@
+/**
+ * Live Collaborative Editing CRDT Engine.
+ * Supports multi-client real-time synchronization with local undo isolation.
+ */
+export class CollabProvider {
+    clientId;
+    clock = 0;
+    broadcast = null;
+    localUndoStack = [];
+    localRedoStack = [];
+    constructor(clientId, broadcast) {
+        this.clientId = clientId;
+        if (broadcast)
+            this.broadcast = broadcast;
+    }
+    setBroadcast(broadcast) {
+        this.broadcast = broadcast;
+    }
+    /**
+     * Apply a local edit initiated by the current user.
+     */
+    applyLocalInsert(doc, offset, text) {
+        doc.insert(offset, text);
+        this.clock++;
+        const delta = {
+            type: "insert",
+            from: offset,
+            text,
+            clientId: this.clientId,
+            clock: this.clock,
+        };
+        this.localUndoStack.push({ delta });
+        this.localRedoStack = [];
+        this.broadcast?.(delta);
+        return delta;
+    }
+    /**
+     * Apply a local deletion initiated by the current user.
+     */
+    applyLocalDelete(doc, from, length) {
+        const deletedText = doc.getText(from, length);
+        doc.delete(from, length);
+        this.clock++;
+        const delta = {
+            type: "delete",
+            from,
+            to: from + length,
+            clientId: this.clientId,
+            clock: this.clock,
+        };
+        this.localUndoStack.push({ delta, revertedText: deletedText });
+        this.localRedoStack = [];
+        this.broadcast?.(delta);
+        return delta;
+    }
+    /**
+     * Ingest and apply a remote delta from another client.
+     * Remote edits do NOT pollute the local undo stack.
+     */
+    applyRemoteDelta(doc, delta) {
+        if (delta.clientId === this.clientId)
+            return;
+        this.clock = Math.max(this.clock, delta.clock) + 1;
+        if (delta.type === "insert" && delta.text) {
+            const safeFrom = Math.min(doc.length, delta.from);
+            doc.insert(safeFrom, delta.text);
+        }
+        else if (delta.type === "delete" && delta.to !== undefined) {
+            const safeFrom = Math.min(doc.length, delta.from);
+            const safeLen = Math.min(doc.length - safeFrom, delta.to - delta.from);
+            if (safeLen > 0) {
+                doc.delete(safeFrom, safeLen);
+            }
+        }
+    }
+    /**
+     * Revert the most recent edit made specifically by the local user.
+     */
+    undoLocal(doc) {
+        const record = this.localUndoStack.pop();
+        if (!record)
+            return null;
+        let inverseDelta = null;
+        if (record.delta.type === "insert" && record.delta.text) {
+            // Revert insertion -> delete
+            const len = record.delta.text.length;
+            doc.delete(record.delta.from, len);
+            this.clock++;
+            inverseDelta = {
+                type: "delete",
+                from: record.delta.from,
+                to: record.delta.from + len,
+                clientId: this.clientId,
+                clock: this.clock,
+            };
+        }
+        else if (record.delta.type === "delete" && record.revertedText) {
+            // Revert deletion -> insert back
+            doc.insert(record.delta.from, record.revertedText);
+            this.clock++;
+            inverseDelta = {
+                type: "insert",
+                from: record.delta.from,
+                text: record.revertedText,
+                clientId: this.clientId,
+                clock: this.clock,
+            };
+        }
+        if (inverseDelta) {
+            this.localRedoStack.push(record);
+            this.broadcast?.(inverseDelta);
+        }
+        return inverseDelta;
+    }
+    /**
+     * Redo the most recent undone local edit.
+     */
+    redoLocal(doc) {
+        const record = this.localRedoStack.pop();
+        if (!record)
+            return null;
+        let delta = null;
+        if (record.delta.type === "insert" && record.delta.text) {
+            doc.insert(record.delta.from, record.delta.text);
+            this.clock++;
+            delta = {
+                type: "insert",
+                from: record.delta.from,
+                text: record.delta.text,
+                clientId: this.clientId,
+                clock: this.clock,
+            };
+        }
+        else if (record.delta.type === "delete" && record.delta.to) {
+            const len = record.delta.to - record.delta.from;
+            doc.delete(record.delta.from, len);
+            this.clock++;
+            delta = {
+                type: "delete",
+                from: record.delta.from,
+                to: record.delta.to,
+                clientId: this.clientId,
+                clock: this.clock,
+            };
+        }
+        if (delta) {
+            this.localUndoStack.push(record);
+            this.broadcast?.(delta);
+        }
+        return delta;
+    }
+}
+//# sourceMappingURL=CollabProvider.js.map

package/dist/collab/CollabProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabProvider.js","sourceRoot":"","sources":["../../src/collab/CollabProvider.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACT,QAAQ,CAAS;IACzB,KAAK,GAAG,CAAC,CAAC;IACV,SAAS,GAAgC,IAAI,CAAC;IAC9C,cAAc,GAAsB,EAAE,CAAC;IACvC,cAAc,GAAsB,EAAE,CAAC;IAE/C,YAAY,QAAgB,EAAE,SAAgC;QAC5D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5C,CAAC;IAEM,YAAY,CAAC,SAA+B;QACjD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,GAAe,EAAE,MAAc,EAAE,IAAY;QACnE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,KAAK,GAAgB;YACzB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM;YACZ,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,GAAe,EAAE,IAAY,EAAE,MAAc;QACnE,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,KAAK,GAAgB;YACzB,IAAI,EAAE,QAAQ;YACd,IAAI;YACJ,EAAE,EAAE,IAAI,GAAG,MAAM;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACI,gBAAgB,CAAC,GAAe,EAAE,KAAkB;QACzD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,QAAQ,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACvE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,GAAe;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,YAAY,GAAuB,IAAI,CAAC;QAC5C,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxD,6BAA6B;YAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACrC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,YAAY,GAAG;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACjE,iCAAiC;YACjC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,YAAY,GAAG;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,IAAI,EAAE,MAAM,CAAC,YAAY;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,GAAe;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,KAAK,GAAuB,IAAI,CAAC;QACrC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAChD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/coordinates.d.ts

@@ -0,0 +1,132 @@
+import type { Position, Range, Selection } from "./types.js";
+/**
+ * Compute or retrieve cached line starts table for a given lines array.
+ */
+export declare function computeLineStarts(lines: string[]): Uint32Array;
+/**
+ * Convert 0-indexed (line, column) to character offset in full text.
+ */
+export declare function positionToOffset(lines: string[], pos: Position): number;
+/**
+ * Convert character offset to 0-indexed (line, column).
+ */
+export declare function offsetToPosition(lines: string[], offset: number): Position;
+export declare function isLeadSurrogate(code: number): boolean;
+export declare function isTrailSurrogate(code: number): boolean;
+/**
+ * Step one code point backward, keeping surrogate pairs (emoji, astral CJK)
+ * whole so backspace never leaves a lone surrogate behind.
+ */
+export declare function stepBackCodePoint(text: string, offset: number): number;
+/**
+ * Step one code point forward, keeping surrogate pairs whole so
+ * forward-delete never leaves a lone surrogate behind.
+ */
+export declare function stepForwardCodePoint(text: string, offset: number): number;
+/**
+ * Convert pixel (x, y) coordinates to (line, column) position.
+ */
+export declare function pointToPosition(x: number, y: number, lineHeight: number, charWidth: number): Position;
+/**
+ * Convert (line, column) position to pixel (x, y) coordinates.
+ */
+export declare function positionToPoint(pos: Position, lineHeight: number, charWidth: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Clamp a position to valid buffer bounds.
+ */
+export declare function clampPosition(lines: string[] | {
+    length: number;
+}, pos: Position): Position;
+/**
+ * Check if two positions are equal.
+ */
+export declare function arePositionsEqual(a: Position, b: Position): boolean;
+/**
+ * Check if position a is strictly before or equal to position b.
+ */
+export declare function isPositionBefore(a: Position, b: Position): boolean;
+/**
+ * Normalize a Range ensuring start is before or equal to end.
+ */
+export declare function normalizeRange(range: Range): Range;
+/**
+ * Check if a position lies within a Range (inclusive).
+ */
+export declare function isPositionInRange(pos: Position, range: Range): boolean;
+/**
+ * Find the word boundaries at a given column in a line of text.
+ */
+export declare function getWordRangeAt(lineText: string, line: number, column: number): Range;
+/**
+ * Extract text within a given Range across lines.
+ */
+export declare function getTextInRange(lines: string[], range: Range | null): string;
+/**
+ * Convert a Selection (anchor + head) to a normalized Range (start <= end).
+ */
+export declare function normalizeSelection(sel: Selection): Range;
+/**
+ * Check if a selection is collapsed (anchor == head).
+ */
+export declare function isSelectionCollapsed(sel: Selection): boolean;
+/**
+ * Sort selections descending by maximum position (bottom-to-top, right-to-left).
+ * Necessary for multi-cursor mutations to avoid invalidating earlier offsets.
+ */
+export declare function sortSelectionsDescending(selections: Selection[]): Selection[];
+/**
+ * Remove duplicate cursors/selections.
+ */
+export declare function deduplicateSelections(selections: Selection[]): Selection[];
+export interface MultiEditResult {
+    newLines: string[];
+    newSelections: Selection[];
+}
+/**
+ * Apply text insertion across multiple cursors or selections in a single atomic pass.
+ */
+export declare function applyMultiCursorInsert(lines: string[], selections: Selection[], insertText: string): MultiEditResult;
+/**
+ * Apply deletion (backspace or forward delete) across multiple cursors or selections.
+ */
+export declare function applyMultiCursorDelete(lines: string[], selections: Selection[], isForward: boolean): MultiEditResult;
+/**
+ * Find word boundary in a line of text for word-by-word cursor navigation (Ctrl/Alt + Arrow).
+ */
+export declare function findWordBoundary(lineText: string, column: number, direction: -1 | 1): number;
+/**
+ * Toggle single-line comment on a range of lines.
+ */
+export declare function toggleLinesComment(lines: string[], startLine: number, endLine: number, commentPrefix?: string): {
+    newLines: string[];
+};
+/**
+ * Check if the cursor is directly between an open/close bracket pair (e.g. `(|)`),
+ * in which case backspace should delete both characters.
+ */
+export declare function isPairedBracketDelete(lineText: string, column: number): boolean;
+/**
+ * Compute rectangular / column selection spanning across multiple lines from start to end position.
+ * Returns an array of Selections, one for each line in the rectangular bounding box.
+ */
+export declare function computeColumnSelection(lines: string[], start: Position, end: Position): Selection[];
+/**
+ * Compute column positions for vertical indent guides on a line of code.
+ */
+export declare function computeIndentGuides(lineText: string, tabSize?: number): number[];
+export interface RainbowBracket {
+    col: number;
+    depth: number;
+    char: string;
+}
+/**
+ * Calculate rainbow bracket nesting depths and column positions across a line.
+ */
+export declare function computeRainbowBrackets(lineText: string, _language?: string, startDepth?: number): {
+    nextDepth: number;
+    brackets: RainbowBracket[];
+};
+//# sourceMappingURL=coordinates.d.ts.map

package/dist/coordinates.d.ts.map

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