fix(ui): Document QEditor.caret computedProp (#14476)

ui/src/components/editor/QEditor.json

@@ -312,5 +312,14 @@
         "__exemption": [ "examples" ]
       }
     }
+  },
+
+  "computedProps": {
+    "caret": {
+      "type": "Object",
+      "tsType": "QEditorCaret",
+      "desc": "The current caret state",
+      "__exemption": [ "examples" ]
+    }
   }
 }

ui/types/api.d.ts

@@ -6,6 +6,7 @@ export * from "./api/qtable";
 export * from "./api/qtree";
 export * from "./api/quploader";
 export * from "./api/qnotify";
+export * from "./api/qeditor";
 export * from "./api/qloading";
 export * from "./api/touchswipe";
 export * from "./api/web-storage";

ui/types/api/qeditor.d.ts

@@ -0,0 +1,17 @@
+// src/components/editor/editor-caret.js#Caret
+// We are not exposing the whole API, just the ones that might be needed outside.
+export interface QEditorCaret {
+  readonly selection: Selection | null;
+  readonly hasSelection: boolean;
+  readonly range: Range | null;
+  readonly parent: Element | null;
+  readonly blockParent: Element | null;
+
+  save(range: Range): void;
+  restore(range?: Range): void;
+  savePosition(): void;
+  restorePosition(length?: number): void;
+  is(commandId: string, param?: string): boolean;
+  can(commandId: string): boolean;
+  apply(commandId: string, param?: string, done?: () => void): boolean;
+}