add types to docstrings

Author: aminya

lib_src/misc/scopes.ts

@@ -25,13 +25,21 @@ const openers = [
 ]
 const reopeners = ["else", "elseif", "catch", "finally"]
 
+/**
+ * 
+ * @param {readonly string[]} scopes
+ */
 function isKeywordScope(scopes: readonly string[]) {
   // Skip 'source.julia'
   return scopes.slice(1).some(scope => {
     return scope.indexOf("keyword") > -1
   })
 }
 
+/**
+ *
+ * @param {readonly string[]} scopes
+ */
 export function isStringScope(scopes: readonly string[]) {
   let isString = false
   let isInterp = false
@@ -46,6 +54,11 @@ export function isStringScope(scopes: readonly string[]) {
   return isString && !isInterp
 }
 
+/**
+ *
+ * @param {TextEditor} editor
+ * @param {RangeCompatible} range
+ */
 function forRange(editor: TextEditor, range: RangeCompatible) {
   // this should happen here and not a top-level so that we aren't relying on
   // Atom to load packages in a specific order:
@@ -90,13 +103,23 @@ function forRange(editor: TextEditor, range: RangeCompatible) {
   return scopes
 }
 
+/**
+ *
+ * @param {TextEditor} editor
+ * @param {number} start
+ * @param {number} end
+ */
 export function forLines(editor: TextEditor, start: number, end: number) {
   const startPoint = new Point(start, 0)
   const endPoint = new Point(end, Infinity)
   const range = new Range(startPoint, endPoint)
   return forRange(editor, range)
 }
 
+/**
+ *
+ * @param {readonly string[]} scopes
+ */
 export function isCommentScope(scopes: readonly string[]) {
   // Skip 'source.julia'
   return scopes.slice(1).some(scope => {
@@ -108,6 +131,9 @@ export function isCommentScope(scopes: readonly string[]) {
  * Returns `true` if the scope at `bufferPosition` in `editor` is valid code scope to be inspected.
  * Supposed to be used within Atom-IDE integrations, whose `grammarScopes` setting doesn't support
  * embedded scopes by default.
+ *
+ * @param {TextEditor} editor
+ * @param {PointCompatible} bufferPosition
  */
 export function isValidScopeToInspect(editor: TextEditor, bufferPosition: PointCompatible) {
   const scopes = editor.scopeDescriptorForBufferPosition(bufferPosition).getScopesArray()