fix(docs): resolve type errors

Resolves TypeScript errors in the `docs` directory by adding JSDoc annotations and making minor code adjustments.

- Casts `Element` to `any` to allow access to untyped properties.
- Adds a null check for the `cursor` object.
- Casts the `Docs` object to `any` to bypass the type checker.
- Converts a `number` to a `string` to satisfy a function signature.
- Replaces `Element` with the fully qualified `GoogleAppsScript.Document.Element` type.

Author: google-labs-jules[bot]

docs/cursorInspector/cursorInspector.gs

@@ -74,7 +74,7 @@ function getDocumentInfo() {
 
 /**
  * Gets information about a given element.
- * @param {Element} element The element.
+ * @param {GoogleAppsScript.Document.Element} element The element.
  * @return {Object} The information.
  */
 function getElementInfo(element) {

docs/dialog2sidebar/Code.gs

@@ -38,7 +38,7 @@ function showSidebar() {
  * @return {string} The dialog ID.
  */
 function openDialog() {
-  var dialogId = Utilities.base64Encode(Math.random());
+  var dialogId = Utilities.base64Encode(String(Math.random()));
   var template = HtmlService.createTemplateFromFile('Dialog');
   template.dialogId = dialogId;
   var page = template.evaluate()

docs/quickstart/quickstart.gs

@@ -21,7 +21,8 @@
  */
 function printDocTitle() {
   const documentId = '195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE';
-  const doc = Docs.Documents.get(documentId, {'includeTabsContent': true});
+  const doc = /** @type {any} */ (Docs).Documents.get(documentId,
+      {'includeTabsContent': true});
   console.log(`The title of the doc is: ${doc.title}`);
 }
 // [END docs_quickstart]

docs/translate/translate.gs

@@ -87,7 +87,7 @@ function getSelectedText() {
         const element = elements[i].getElement();
         // Only translate elements that can be edited as text; skip images and
         // other non-text elements.
-        if (element.editAsText) {
+        if ((/** @type {any} */ (element)).editAsText) {
           const elementText = element.asText().getText();
           // This check is necessary to exclude images, which return a blank
           // text element.
@@ -190,10 +190,10 @@ function insertText(newText) {
         }
       } else {
         const element = elements[i].getElement();
-        if (!replaced && element.editAsText) {
+        if (!replaced && (/** @type {any} */ (element)).editAsText) {
           // Only translate elements that can be edited as text, removing other
           // elements.
-          element.clear();
+          (/** @type {any} */ (element)).clear();
           element.asText().setText(newText);
           replaced = true;
         } else {
@@ -202,30 +202,32 @@ function insertText(newText) {
           if (element.getNextSibling()) {
             element.removeFromParent();
           } else {
-            element.clear();
+            (/** @type {any} */ (element)).clear();
           }
         }
       }
     }
   } else {
     const cursor = DocumentApp.getActiveDocument().getCursor();
-    const surroundingText = cursor.getSurroundingText().getText();
-    const surroundingTextOffset = cursor.getSurroundingTextOffset();
+    if (cursor) {
+      const surroundingText = cursor.getSurroundingText().getText();
+      const surroundingTextOffset = cursor.getSurroundingTextOffset();
 
-    // If the cursor follows or preceds a non-space character, insert a space
-    // between the character and the translation. Otherwise, just insert the
-    // translation.
-    if (surroundingTextOffset > 0) {
-      if (surroundingText.charAt(surroundingTextOffset - 1) !== ' ') {
-        newText = ' ' + newText;
+      // If the cursor follows or preceds a non-space character, insert a space
+      // between the character and the translation. Otherwise, just insert the
+      // translation.
+      if (surroundingTextOffset > 0) {
+        if (surroundingText.charAt(surroundingTextOffset - 1) !== ' ') {
+          newText = ' ' + newText;
+        }
       }
-    }
-    if (surroundingTextOffset < surroundingText.length) {
-      if (surroundingText.charAt(surroundingTextOffset) !== ' ') {
-        newText += ' ';
+      if (surroundingTextOffset < surroundingText.length) {
+        if (surroundingText.charAt(surroundingTextOffset) !== ' ') {
+          newText += ' ';
+        }
       }
+      cursor.insertText(newText);
     }
-    cursor.insertText(newText);
   }
 }