Expose Range type

slab · Apr 4, 2024 · 1021587 · 1021587
1 parent 91a7346
commit 1021587
Show file tree

Hide file tree

Showing 3 changed files with 13 additions and 18 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,7 @@
 - **Clipboard** Add support for Quill v1 list attributes
 - Fix overload declarations for `quill.formatText()` and other methods
 - Expose Bounds type for getBounds()
+- Expose Range type
 
 # 2.0.0-rc.4
 

diff --git a/packages/quill/src/core/quill.ts b/packages/quill/src/core/quill.ts
@@ -402,7 +402,7 @@ class Quill {
   }
 
   formatText(
-    range: { index: number; length: number },
+    range: Range,
     name: string,
     value: unknown,
     source?: EmitterSource,
@@ -421,7 +421,7 @@ class Quill {
     source?: EmitterSource,
   ): Delta;
   formatText(
-    index: number | { index: number; length: number },
+    index: number | Range,
     length: number | string,
     name: string | unknown,
     value?: unknown | EmitterSource,
@@ -473,11 +473,11 @@ class Quill {
   }
 
   getFormat(index?: number, length?: number): { [format: string]: unknown };
-  getFormat(range?: { index: number; length: number }): {
+  getFormat(range?: Range): {
     [format: string]: unknown;
   };
   getFormat(
-    index: { index: number; length: number } | number = this.getSelection(true),
+    index: Range | number = this.getSelection(true),
     length = 0,
   ): { [format: string]: unknown } {
     if (typeof index === 'number') {
@@ -502,10 +502,10 @@ class Quill {
     return this.scroll.line(index);
   }
 
-  getLines(range: { index: number; length: number }): (Block | BlockEmbed)[];
+  getLines(range: Range): (Block | BlockEmbed)[];
   getLines(index?: number, length?: number): (Block | BlockEmbed)[];
   getLines(
-    index: { index: number; length: number } | number = 0,
+    index: Range | number = 0,
     length = Number.MAX_VALUE,
   ): (Block | BlockEmbed)[] {
     if (typeof index !== 'number') {
@@ -526,12 +526,9 @@ class Quill {
     return this.selection.getRange()[0];
   }
 
-  getSemanticHTML(range: { index: number; length: number }): string;
+  getSemanticHTML(range: Range): string;
   getSemanticHTML(index?: number, length?: number): string;
-  getSemanticHTML(
-    index: { index: number; length: number } | number = 0,
-    length?: number,
-  ) {
+  getSemanticHTML(index: Range | number = 0, length?: number) {
     if (typeof index === 'number') {
       length = length ?? this.getLength() - index;
     }
@@ -540,12 +537,9 @@ class Quill {
     return this.editor.getHTML(index, length);
   }
 
-  getText(range?: { index: number; length: number }): string;
+  getText(range?: Range): string;
   getText(index?: number, length?: number): string;
-  getText(
-    index: { index: number; length: number } | number = 0,
-    length?: number,
-  ): string {
+  getText(index: Range | number = 0, length?: number): string {
     if (typeof index === 'number') {
       length = length ?? this.getLength() - index;
     }

diff --git a/packages/quill/src/core/selection.ts b/packages/quill/src/core/selection.ts
@@ -28,7 +28,7 @@ export interface Bounds {
   width: number;
 }
 
-class Range {
+export class Range {
   constructor(
     public index: number,
     public length = 0,
@@ -484,4 +484,4 @@ function contains(parent: Node, descendant: Node) {
   return parent.contains(descendant);
 }
 
-export { Range, Selection as default };
+export default Selection;