convert plots/, plot_api/, cartesian/ to TypeScript

57 files: 13 plots/ root, 13 plot_api/, 31 cartesian/.
Includes the biggest files: axes.ts (4,700L), plot_api.ts (3,800L),
plots.ts (3,300L), dragbox.ts (1,400L), set_convert.ts (900L).

Total: 221 .ts / 614 .js (26% converted).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ryan-williams

src/components/fx/click.ts

@@ -1,7 +1,7 @@
 import Registry from '../../registry.js';
 import { hover } from './hover.js';
 
-export default function click(gd: any, evt: any, subplot: any): void {
+export default function click(gd: any, evt: any, subplot?: any): void {
     var annotationsDone = Registry.getComponentMethod('annotations', 'onClick')(gd, gd._hoverdata);
 
     // fallback to fail-safe in case the plot type's hover method doesn't pass the subplot.

src/plot_api/container_array_match.js src/plot_api/container_array_match.tssrc/plot_api/container_array_match.js renamed to src/plot_api/container_array_match.ts

@@ -1,6 +1,6 @@
 import Registry from '../registry.js';
 
-export default function containerArrayMatch(astr) {
+export default function containerArrayMatch(astr?: any): any {
     var rootContainers = Registry.layoutArrayContainers;
     var regexpContainers = Registry.layoutArrayRegexes;
     var rootPart = astr.split('[')[0];

src/plot_api/edit_types.js src/plot_api/edit_types.tssrc/plot_api/edit_types.js renamed to src/plot_api/edit_types.ts

@@ -83,7 +83,7 @@ export default {
     overrideAll: overrideAll
 };
 
-function falseObj(keys) {
+function falseObj(keys?: any): any {
     var out = {};
     for(var i = 0; i < keys.length; i++) out[keys[i]] = false;
     return out;
@@ -104,7 +104,7 @@ function falseObj(keys) {
  *
  * @return {object} a new attributes object with `editType` modified as directed
  */
-function overrideAll(attrs, editTypeOverride, overrideContainers) {
+function overrideAll(attrs?: any, editTypeOverride?: any, overrideContainers?: any): any {
     var out = extendFlat({}, attrs);
     for(var key in out) {
         var attr = out[key];
@@ -117,7 +117,7 @@ function overrideAll(attrs, editTypeOverride, overrideContainers) {
     return out;
 }
 
-function overrideOne(attr, editTypeOverride, overrideContainers, key) {
+function overrideOne(attr?: any, editTypeOverride?: any, overrideContainers?: any, key?: any): any {
     if(attr.valType) {
         var out = extendFlat({}, attr);
         out.editType = editTypeOverride;

src/plot_api/helpers.js src/plot_api/helpers.tssrc/plot_api/helpers.js renamed to src/plot_api/helpers.ts

@@ -12,15 +12,15 @@ var traceIs = Registry.traceIs;
 
 const AX_LETTERS = ['x', 'y', 'z'];
 
-export var clearPromiseQueue = function (gd) {
+export var clearPromiseQueue = function (gd?: any) {
     if (Array.isArray(gd._promises) && gd._promises.length > 0) {
         log('Clearing previous rejected promises from queue.');
     }
 
     gd._promises = [];
 };
 
-export var cleanLayout = function (layout) {
+export var cleanLayout = function (layout?: any) {
     var i, j;
 
     if (!layout) layout = {};
@@ -146,15 +146,15 @@ export var cleanLayout = function (layout) {
     return layout;
 };
 
-function cleanAxRef(container, attr) {
+function cleanAxRef(container?: any, attr?: any): any {
     var valIn = container[attr];
     var axLetter = attr.charAt(0);
     if (valIn && valIn !== 'paper') {
         container[attr] = cleanId(valIn, axLetter, true);
     }
 }
 
-export var cleanData = function (data) {
+export var cleanData = function (data?: any) {
     for (var tracei = 0; tracei < data.length; tracei++) {
         var trace = data[tracei];
         var i;
@@ -281,7 +281,7 @@ export var cleanData = function (data) {
     }
 };
 
-function cleanFinanceDir(dirContainer) {
+function cleanFinanceDir(dirContainer?: any): any {
     if (!isPlainObject(dirContainer)) return false;
 
     var dirName = dirContainer.name;
@@ -292,7 +292,7 @@ function cleanFinanceDir(dirContainer) {
     return (typeof dirName === 'string' || typeof dirName === 'number') && String(dirName);
 }
 
-function commonPrefix(name1, name2, show1, show2) {
+function commonPrefix(name1?: any, name2?: any, show1?: any, show2?: any): any {
     // if only one is shown in the legend, use that
     if (show1 && !show2) return name1;
     if (show2 && !show1) return name2;
@@ -315,7 +315,7 @@ function commonPrefix(name1, name2, show1, show2) {
 
 // textposition - support partial attributes (ie just 'top')
 // and incorrect use of middle / center etc.
-function cleanTextPosition(textposition) {
+function cleanTextPosition(textposition?: any): any {
     var posY = 'middle';
     var posX = 'center';
 
@@ -330,11 +330,11 @@ function cleanTextPosition(textposition) {
     return posY + ' ' + posX;
 }
 
-function emptyContainer(outer, innerStr) {
+function emptyContainer(outer?: any, innerStr?: any): any {
     return innerStr in outer && typeof outer[innerStr] === 'object' && Object.keys(outer[innerStr]).length === 0;
 }
 
-export var swapXYData = function (trace) {
+export var swapXYData = function (trace?: any) {
     var i;
     swapAttrs(trace, ['?', '?0', 'd?', '?bins', 'nbins?', 'autobin?', '?src', 'error_?']);
     if (Array.isArray(trace.z) && Array.isArray(trace.z[0])) {
@@ -360,11 +360,11 @@ export var swapXYData = function (trace) {
     }
 };
 
-export var coerceTraceIndices = function (gd, traceIndices) {
+export var coerceTraceIndices = function (gd?: any, traceIndices?: any) {
     if (isNumeric(traceIndices)) {
         return [traceIndices];
     } else if (!Array.isArray(traceIndices) || !traceIndices.length) {
-        return gd.data.map(function (_, i) {
+        return gd.data.map(function (_?: any, i?: any) {
             return i;
         });
     } else if (Array.isArray(traceIndices)) {
@@ -382,7 +382,7 @@ export var coerceTraceIndices = function (gd, traceIndices) {
     return traceIndices;
 };
 
-export var manageArrayContainers = function (np, newVal, undoit) {
+export var manageArrayContainers = function (np?: any, newVal?: any, undoit?: any) {
     var obj = np.obj;
     var parts = np.parts;
     var pLength = parts.length;
@@ -424,12 +424,12 @@ export var manageArrayContainers = function (np, newVal, undoit) {
  */
 var ATTR_TAIL_RE = /(\.[^\[\]\.]+|\[[^\[\]\.]+\])$/;
 
-function getParent(attr) {
+function getParent(attr?: any): any {
     var tail = attr.search(ATTR_TAIL_RE);
     if (tail > 0) return attr.slice(0, tail);
 }
 
-export var hasParent = function (aobj, attr) {
+export var hasParent = function (aobj?: any, attr?: any) {
     var attrParent = getParent(attr);
     while (attrParent) {
         if (attrParent in aobj) return true;
@@ -438,7 +438,7 @@ export var hasParent = function (aobj, attr) {
     return false;
 };
 
-export var clearAxisTypes = function (gd, traces, layoutUpdate) {
+export var clearAxisTypes = function (gd?: any, traces?: any, layoutUpdate?: any) {
     for (var i = 0; i < traces.length; i++) {
         var trace = gd._fullData[i];
         for (var j = 0; j < 3; j++) {

src/plot_api/index.js src/plot_api/index.tssrc/plot_api/index.js renamed to src/plot_api/index.ts

@@ -28,7 +28,7 @@ export var deleteFrames = main.deleteFrames;
 export var animate = main.animate;
 export var setPlotConfig = main.setPlotConfig;
 
-export var deleteActiveShape = function(gd) {
+export var deleteActiveShape = function(gd?: any): any {
     return Registry.getComponentMethod('shapes', 'eraseActiveShape')(getGraphDiv(gd));
 };
 

src/plot_api/manage_arrays.js src/plot_api/manage_arrays.tssrc/plot_api/manage_arrays.js renamed to src/plot_api/manage_arrays.ts

@@ -6,15 +6,15 @@ import Registry from '../registry.js';
 import _req0 from './container_array_match.js';
 export var containerArrayMatch = _req0;
 
-export var isAddVal = function isAddVal(val) {
+export var isAddVal = function isAddVal(val?: any): any {
     return val === 'add' || isPlainObject(val);
 };
 
-export var isRemoveVal = function isRemoveVal(val) {
+export var isRemoveVal = function isRemoveVal(val?: any): any {
     return val === null || val === 'remove';
 };
 
-export var applyContainerArrayChanges = function applyContainerArrayChanges(gd, np, edits, flags, _nestedProperty) {
+export var applyContainerArrayChanges = function applyContainerArrayChanges(gd?: any, np?: any, edits?: any, flags?: any, _nestedProperty?: any): any {
     var componentType = np.astr;
     var supplyComponentDefaults = Registry.getComponentMethod(componentType, 'supplyLayoutDefaults');
     var draw = Registry.getComponentMethod(componentType, 'draw');