Bug 1869678 - Fixup and improve JSDocs for better type inference r=robwu

Differential Revision: https://phabricator.services.mozilla.com/D196385

UltraBlame original commit: 1c6e48c2b096e91d8c9304bffabd3c22f07ea5a8

toolkit/components/extensions/ConduitsParent.sys.mjs

@@ -190,7 +190,9 @@ property
 {
 ConduitID
 }
+[
 id
+]
 Globally
 unique
 across
@@ -238,6 +240,104 @@ string
 cast
 ]
 *
+*
+property
+{
+*
+}
+[
+actor
+]
+*
+property
+{
+boolean
+}
+[
+verified
+]
+*
+property
+{
+string
+}
+[
+url
+]
+*
+property
+{
+number
+}
+[
+frameId
+]
+*
+property
+{
+string
+}
+[
+workerScriptURL
+]
+*
+property
+{
+string
+}
+[
+extensionId
+]
+*
+property
+{
+string
+}
+[
+envType
+]
+*
+property
+{
+string
+}
+[
+instanceId
+]
+*
+property
+{
+number
+}
+[
+portId
+]
+*
+property
+{
+boolean
+}
+[
+native
+]
+*
+property
+{
+boolean
+}
+[
+source
+]
+*
+property
+{
+string
+}
+[
+reportOnClosed
+]
+*
+*
 Lists
 of
 recvX
@@ -2026,8 +2126,16 @@ arg
 returns
 {
 Promise
+<
+any
 [
 ]
+>
+|
+Promise
+<
+Response
+>
 }
 *
 /
@@ -2373,11 +2481,27 @@ errors
 .
 *
 *
+typedef
+{
+{
+response
+?
+:
+any
+received
+?
+:
+boolean
+}
+}
+Response
+*
+*
 param
 {
 Promise
 <
-response
+Response
 >
 [
 ]
@@ -2388,7 +2512,7 @@ returns
 {
 Promise
 <
-response
+Response
 ?
 >
 }
@@ -2686,6 +2810,17 @@ name
 *
 param
 {
+import
+(
+"
+ConduitsChild
+.
+sys
+.
+mjs
+"
+)
+.
 MessageData
 }
 data
@@ -2919,6 +3054,17 @@ name
 *
 param
 {
+import
+(
+"
+ConduitsChild
+.
+sys
+.
+mjs
+"
+)
+.
 MessageData
 }
 options

toolkit/components/extensions/Extension.sys.mjs

@@ -6219,6 +6219,8 @@ function
 type
 id
 )
+:
+boolean
 }
 options
 .
@@ -6272,7 +6274,10 @@ temporary
 *
 returns
 {
+Promise
+<
 ExtensionData
+>
 }
 *
 /
@@ -6912,9 +6917,12 @@ directory
 *
 returns
 {
+Promise
+<
 string
 [
 ]
+>
 }
 *
 An
@@ -9236,7 +9244,10 @@ necessary
 *
 returns
 {
+Promise
+<
 object
+>
 }
 normalized
 manifest
@@ -13313,6 +13324,25 @@ getAPIManager
 (
 )
 {
+/
+*
+*
+type
+{
+(
+InstanceType
+<
+typeof
+ExtensionCommon
+.
+LazyAPIManager
+>
+)
+[
+]
+}
+*
+/
 let
 apiManagers
 =
@@ -15444,9 +15474,11 @@ param
 {
 boolean
 }
+[
 options
 .
 collapseOrigins
+]
 *
 Wether
 to
@@ -15468,9 +15500,11 @@ param
 {
 boolean
 }
+[
 options
 .
 buildOptionalOrigins
+]
 *
 Wether
 to
@@ -21748,10 +21782,10 @@ necessary
 param
 {
 string
-|
-undefined
 }
+[
 reason
+]
 *
 If
 provided
@@ -22233,6 +22267,15 @@ startup
 was
 interrupted
 .
+/
+*
+*
+type
+{
+callback
+}
+*
+/
 let
 resolveReadyPromise
 ;

toolkit/components/extensions/ExtensionActions.sys.mjs

@@ -888,7 +888,8 @@ string
 }
 prop
 *
-String
+Name
+of
 property
 to
 retrieve
@@ -901,10 +902,10 @@ of
 "
 icon
 "
+*
 "
 title
 "
-*
 "
 badgeText
 "
@@ -922,7 +923,7 @@ enabled
 *
 returns
 {
-string
+any
 }
 value
 *

toolkit/components/extensions/ExtensionActivityLog.sys.mjs

@@ -331,9 +331,11 @@ data
 *
 param
 {
-string
+Date
 }
+[
 timeStamp
+]
 The
 timestamp
 for