@pierre/diffs 1.2.6 → 1.3.0-beta.1

package/dist/editor/selection.d.ts

@@ -0,0 +1,126 @@
+import { DiffLineAnnotation } from "../types.js";
+import { Position, Range, ResolvedTextEdit, TextDocument, TextDocumentChange, TextEdit } from "./textDocument.js";
+
+//#region src/editor/selection.d.ts
+declare const DirectionBackward = -1;
+declare const DirectionNone = 0;
+declare const DirectionForward = 1;
+type SelectionDirection = typeof DirectionBackward | typeof DirectionNone | typeof DirectionForward;
+interface EditorSelection extends Range {
+  direction: SelectionDirection;
+}
+/**
+ * Converts a selection from a web selection to an editor selection.
+ */
+declare function convertSelection(range: StaticRange, direction?: SelectionDirection): EditorSelection | undefined;
+/**
+ * Resolves the indent edits for a selection.
+ */
+declare function resolveIndentEdits(textDocument: TextDocument<unknown>, selection: EditorSelection, tabSize: number, outdent: boolean): [edits: TextEdit[], nextSelection: EditorSelection];
+/**
+ * Maps the cursor move to all selections.
+ */
+declare function mapCursorMove(textDocument: TextDocument<unknown>, selections: EditorSelection[], shortcut: 'textStart' | 'start' | 'end' | 'up' | 'down' | 'left' | 'right'): EditorSelection[];
+/**
+ * Same as mapCursorMove, but with shift key pressed.
+ */
+declare function mapSelectionShift(textDocument: TextDocument<unknown>, selections: EditorSelection[], shortcut: 'textStart' | 'start' | 'end' | 'up' | 'down' | 'left' | 'right'): EditorSelection[];
+/**
+ * Applies a text change to the given text document
+ */
+declare function applyTextChangeToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], edit: ResolvedTextEdit, lineAnnotations?: DiffLineAnnotation<LAnnotation>[], tabSize?: number): {
+  nextSelections: EditorSelection[];
+  change?: TextDocumentChange;
+};
+/**
+ * Applies a text replace to multiple selections.
+ */
+declare function applyTextReplaceToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], texts: string[], lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): {
+  nextSelections: EditorSelection[];
+  change?: TextDocumentChange;
+};
+/**
+ * Swaps the two characters adjacent to a collapsed selection, matching browser
+ * insertTranspose (Ctrl+T) behavior.
+ */
+declare function applyTransposeToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): {
+  nextSelections: EditorSelection[];
+  change?: TextDocumentChange;
+};
+/**
+ * Deletes from each selection to the end of its line, including the line break
+ * when the caret is already at the end of a non-final line. Non-collapsed
+ * selections delete their selected text instead.
+ */
+declare function applyDeleteHardLineForwardToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): {
+  nextSelections: EditorSelection[];
+  change?: TextDocumentChange;
+};
+/**
+ * Checks if a selection is collapsed.
+ */
+declare function isCollapsedSelection(selection: EditorSelection): boolean;
+/**
+ * Returns the caret (focus) position for a selection.
+ */
+declare function getCaretPosition(selection: EditorSelection): Position;
+/**
+ * Checks if a line is editable.
+ */
+declare function isLineEditable(lineType: string): boolean;
+/**
+ * Checks whether selections `a` and `b` intersect.
+ */
+declare function selectionIntersects(a: EditorSelection, b: EditorSelection): boolean;
+/**
+ * Compares two positions.
+ */
+declare function comparePosition(a: Position, b: Position): number;
+/**
+ * Creates a selection from anchor and focus offsets.
+ */
+declare function createSelectionFromAnchorAndFocusOffsets(textDocument: TextDocument<unknown>, anchorOffset: number, focusOffset: number): EditorSelection;
+/**
+ * Creates a selection from a anchor and focus selection.
+ */
+declare function createSelectionFrom(anchorSelection: EditorSelection, focusSelection: EditorSelection): EditorSelection;
+/**
+ * Extends or shrinks the selection `original` using the endpoints of `target`, \
+ * matching contenteditable shift + click extend behavior.
+ */
+declare function extendSelection(original: EditorSelection, target: EditorSelection): EditorSelection;
+/**
+ * Extends multiple selections.
+ */
+declare function extendSelections(selections: EditorSelection[], target: EditorSelection): EditorSelection[];
+/**
+ * Merges overlapping selections.
+ */
+declare function mergeOverlappingSelections(selections: EditorSelection[]): EditorSelection[];
+/**
+ * Finds the next matching word and updates the selections.
+ */
+declare function findNexMatch(textDocument: TextDocument<unknown>, selections: EditorSelection[]): EditorSelection[] | undefined;
+/**
+ * Get the full selection of the document.
+ */
+declare function getDocumentFullSelection(textDocument: TextDocument<unknown>): EditorSelection;
+/**
+ * Get the boundary selection of the document.
+ */
+declare function getDocumentBoundarySelection(textDocument: TextDocument<unknown>, atEnd: boolean): EditorSelection;
+/**
+ * Get the text of the selections for the given text document.
+ */
+declare function getSelectionText(textDocument: TextDocument<unknown>, selections: EditorSelection[]): string;
+/**
+ * Get the anchor node and offset for a selection.
+ */
+declare function getSelectionAnchor(lineElement: HTMLElement, character: number): [Node, number];
+/**
+ * Expands a zero-width selection to the word-like segment that contains the caret.
+ */
+declare function expandCollapsedSelectionToWord(textDocument: TextDocument<unknown>, selection: EditorSelection): EditorSelection;
+//#endregion
+export { DirectionBackward, DirectionForward, DirectionNone, EditorSelection, SelectionDirection, applyDeleteHardLineForwardToSelections, applyTextChangeToSelections, applyTextReplaceToSelections, applyTransposeToSelections, comparePosition, convertSelection, createSelectionFrom, createSelectionFromAnchorAndFocusOffsets, expandCollapsedSelectionToWord, extendSelection, extendSelections, findNexMatch, getCaretPosition, getDocumentBoundarySelection, getDocumentFullSelection, getSelectionAnchor, getSelectionText, isCollapsedSelection, isLineEditable, mapCursorMove, mapSelectionShift, mergeOverlappingSelections, resolveIndentEdits, selectionIntersects };
+//# sourceMappingURL=selection.d.ts.map

package/dist/editor/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","names":["DiffLineAnnotation","Position","Range","ResolvedTextEdit","TextDocument","TextDocumentChange","TextEdit","DirectionBackward","DirectionNone","DirectionForward","SelectionDirection","EditorSelection","convertSelection","StaticRange","resolveIndentEdits","mapCursorMove","mapSelectionShift","applyTextChangeToSelections","LAnnotation","applyTextReplaceToSelections","applyTransposeToSelections","applyDeleteHardLineForwardToSelections","isCollapsedSelection","getCaretPosition","isLineEditable","selectionIntersects","comparePosition","createSelectionFromAnchorAndFocusOffsets","createSelectionFrom","extendSelection","extendSelections","mergeOverlappingSelections","findNexMatch","getDocumentFullSelection","getDocumentBoundarySelection","getSelectionText","getSelectionAnchor","HTMLElement","Node","expandCollapsedSelectionToWord"],"sources":["../../src/editor/selection.d.ts"],"sourcesContent":["import type { DiffLineAnnotation } from '../types';\nimport type { Position, Range, ResolvedTextEdit, TextDocument, TextDocumentChange, TextEdit } from './textDocument';\nexport declare const DirectionBackward = -1;\nexport declare const DirectionNone = 0;\nexport declare const DirectionForward = 1;\nexport type SelectionDirection = typeof DirectionBackward | typeof DirectionNone | typeof DirectionForward;\nexport interface EditorSelection extends Range {\n    direction: SelectionDirection;\n}\n/**\n * Converts a selection from a web selection to an editor selection.\n */\nexport declare function convertSelection(range: StaticRange, direction?: SelectionDirection): EditorSelection | undefined;\n/**\n * Resolves the indent edits for a selection.\n */\nexport declare function resolveIndentEdits(textDocument: TextDocument<unknown>, selection: EditorSelection, tabSize: number, outdent: boolean): [edits: TextEdit[], nextSelection: EditorSelection];\n/**\n * Maps the cursor move to all selections.\n */\nexport declare function mapCursorMove(textDocument: TextDocument<unknown>, selections: EditorSelection[], shortcut: 'textStart' | 'start' | 'end' | 'up' | 'down' | 'left' | 'right'): EditorSelection[];\n/**\n * Same as mapCursorMove, but with shift key pressed.\n */\nexport declare function mapSelectionShift(textDocument: TextDocument<unknown>, selections: EditorSelection[], shortcut: 'textStart' | 'start' | 'end' | 'up' | 'down' | 'left' | 'right'): EditorSelection[];\n/**\n * Applies a text change to the given text document\n */\nexport declare function applyTextChangeToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], edit: ResolvedTextEdit, lineAnnotations?: DiffLineAnnotation<LAnnotation>[], tabSize?: number): {\n    nextSelections: EditorSelection[];\n    change?: TextDocumentChange;\n};\n/**\n * Applies a text replace to multiple selections.\n */\nexport declare function applyTextReplaceToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], texts: string[], lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): {\n    nextSelections: EditorSelection[];\n    change?: TextDocumentChange;\n};\n/**\n * Swaps the two characters adjacent to a collapsed selection, matching browser\n * insertTranspose (Ctrl+T) behavior.\n */\nexport declare function applyTransposeToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): {\n    nextSelections: EditorSelection[];\n    change?: TextDocumentChange;\n};\n/**\n * Deletes from each selection to the end of its line, including the line break\n * when the caret is already at the end of a non-final line. Non-collapsed\n * selections delete their selected text instead.\n */\nexport declare function applyDeleteHardLineForwardToSelections<LAnnotation>(textDocument: TextDocument<LAnnotation>, selections: EditorSelection[], lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): {\n    nextSelections: EditorSelection[];\n    change?: TextDocumentChange;\n};\n/**\n * Checks if a selection is collapsed.\n */\nexport declare function isCollapsedSelection(selection: EditorSelection): boolean;\n/**\n * Returns the caret (focus) position for a selection.\n */\nexport declare function getCaretPosition(selection: EditorSelection): Position;\n/**\n * Checks if a line is editable.\n */\nexport declare function isLineEditable(lineType: string): boolean;\n/**\n * Checks whether selections `a` and `b` intersect.\n */\nexport declare function selectionIntersects(a: EditorSelection, b: EditorSelection): boolean;\n/**\n * Compares two positions.\n */\nexport declare function comparePosition(a: Position, b: Position): number;\n/**\n * Creates a selection from anchor and focus offsets.\n */\nexport declare function createSelectionFromAnchorAndFocusOffsets(textDocument: TextDocument<unknown>, anchorOffset: number, focusOffset: number): EditorSelection;\n/**\n * Creates a selection from a anchor and focus selection.\n */\nexport declare function createSelectionFrom(anchorSelection: EditorSelection, focusSelection: EditorSelection): EditorSelection;\n/**\n * Extends or shrinks the selection `original` using the endpoints of `target`, \\\n * matching contenteditable shift + click extend behavior.\n */\nexport declare function extendSelection(original: EditorSelection, target: EditorSelection): EditorSelection;\n/**\n * Extends multiple selections.\n */\nexport declare function extendSelections(selections: EditorSelection[], target: EditorSelection): EditorSelection[];\n/**\n * Merges overlapping selections.\n */\nexport declare function mergeOverlappingSelections(selections: EditorSelection[]): EditorSelection[];\n/**\n * Finds the next matching word and updates the selections.\n */\nexport declare function findNexMatch(textDocument: TextDocument<unknown>, selections: EditorSelection[]): EditorSelection[] | undefined;\n/**\n * Get the full selection of the document.\n */\nexport declare function getDocumentFullSelection(textDocument: TextDocument<unknown>): EditorSelection;\n/**\n * Get the boundary selection of the document.\n */\nexport declare function getDocumentBoundarySelection(textDocument: TextDocument<unknown>, atEnd: boolean): EditorSelection;\n/**\n * Get the text of the selections for the given text document.\n */\nexport declare function getSelectionText(textDocument: TextDocument<unknown>, selections: EditorSelection[]): string;\n/**\n * Get the anchor node and offset for a selection.\n */\nexport declare function getSelectionAnchor(lineElement: HTMLElement, character: number): [Node, number];\n/**\n * Expands a zero-width selection to the word-like segment that contains the caret.\n */\nexport declare function expandCollapsedSelectionToWord(textDocument: TextDocument<unknown>, selection: EditorSelection): EditorSelection;\n//# sourceMappingURL=selection.d.ts.map"],"mappings":"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"}