[FRAME-5] Generate TypeScript definitions from docs (#9936)

* [FRAME-5] Generate TypeScript definitions from docs

* [FRAME-5] Remove unused method

* [FRAME-5] Allow string values as point coordinates

In various places a point needs to be described in devie specific units or as a percent value for which we need string values.

* Remove unnecessary quotes

* [FRAME-5] Use method overloads and use inheritance where possible

* [FRAME-5] Use default array type for rest parameters

* Add more JSDocs

* [FRAME-5] Use correct path for index.d.ts output file

apidoc/Titanium/UI/Tab.yml

@@ -75,6 +75,7 @@ methods:
             Identical to the `options` parameter to [Window.open](Titanium.UI.Window.open).
             iOS only supports the **animated** parameter.
         type: Object
+        optional: true
 
   - name: close
     summary: Closes the top-level window for this tab.

apidoc/Titanium/UI/View.yml

@@ -737,6 +737,7 @@ methods:
       - name: callback
         summary: Function to be invoked upon completion of the animation.
         type: Callback<Object>
+        optional: true
 
   - name: finishLayout
     since: "2.0.0"
@@ -1088,7 +1089,7 @@ properties:
 
             { x: 30, y: 30 }
         Or:
-        
+
             { x: '50%', y: '50%' }
 
         When specifying multiple colors, you can specify an *offset* value for each color, defining
@@ -1769,11 +1770,11 @@ since: "1.8.0"
 platforms: [android, iphone, ipad]
 properties:
   - name: x
-    type: Number
+    type: [Number, String]
     summary: The x-axis coordinate of this point.
 
   - name: y
-    type: Number
+    type: [Number, String]
     summary: The y-axis coordinate of this point.
 ---
 name: Gradient

apidoc/docgen.js

@@ -992,6 +992,9 @@ formats.forEach(function (format) {
 		case 'solr' :
 			render = JSON.stringify(exportData, null, '    ');
 			output = pathMod.join(outputPath, 'api_solr.json');
+		case 'typescript':
+			render = exportData;
+			output = pathMod.join(outputPath, 'index.d.ts');
 	}
 
 	if (!~[ 'addon' ].indexOf(format)) {