convert 12 medium lib modules to TypeScript

extend, d3-compat, trace_categories, keyed_container, queue,
geometry2d, events (MiniEmitter → class), matrix, dom,
nested_property, polygon, array.

Added local interfaces: KeyedContainerObj, Point, PolygonTester,
NestedPropertyResult, TextLocation, SVGPathLike, etc.

Total: 48 of 53 lib files now TypeScript. Remaining 5 large files:
coerce (574L), dates (506L), geo_location_utils (377L),
svg_text_utils (983L), index (1,656L).

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

Author: ryan-williams

src/lib/array.js src/lib/array.tssrc/lib/array.js renamed to src/lib/array.ts

@@ -6,12 +6,12 @@ var isArray = Array.isArray;
 var ab = ArrayBuffer;
 var dv = DataView;
 
-function isTypedArray(a) {
+function isTypedArray(a: any): boolean {
     return ab.isView(a) && !(a instanceof dv);
 }
 export { isTypedArray };
 
-function isArrayOrTypedArray(a) {
+function isArrayOrTypedArray(a: any): boolean {
     return isArray(a) || isTypedArray(a);
 }
 export { isArrayOrTypedArray };
@@ -24,12 +24,12 @@ export { isArrayOrTypedArray };
  * Looks only at the first element, if the dimensionality is
  * not consistent we won't figure that out here.
  */
-function isArray1D(a) {
+function isArray1D(a: any): boolean {
     return !isArrayOrTypedArray(a[0]);
 }
 export { isArray1D };
 
-export var ensureArray = function(out, n) {
+export var ensureArray = function(out: any, n: number): any[] {
     // TODO: typed array support here? This is only used in
     // traces/carpet/compute_control_points
     if(!isArray(out)) out = [];
@@ -41,7 +41,7 @@ export var ensureArray = function(out, n) {
     return out;
 };
 
-var typedArrays = {
+var typedArrays: Record<string, any> = {
     u1c: typeof Uint8ClampedArray === 'undefined' ? undefined :
                 Uint8ClampedArray, // not supported in numpy?
 
@@ -89,25 +89,25 @@ typedArrays.int32 = typedArrays.i4;
 typedArrays.float32 = typedArrays.f4;
 typedArrays.float64 = typedArrays.f8;
 
-function isArrayBuffer(a) {
+function isArrayBuffer(a: any): boolean {
     return a.constructor === ArrayBuffer;
 }
 export { isArrayBuffer };
 
-export var decodeTypedArraySpec = function(vIn) {
-    var out = [];
+export var decodeTypedArraySpec = function(vIn: any): any {
+    var out: any = [];
     var v = coerceTypedArraySpec(vIn);
     var dtype = v.dtype;
 
     var T = typedArrays[dtype];
     if(!T) throw new Error('Error in dtype: "' + dtype + '"');
-    var BYTES_PER_ELEMENT = T.BYTES_PER_ELEMENT;
+    var BYTES_PER_ELEMENT: number = T.BYTES_PER_ELEMENT;
 
     var buffer = v.bdata;
     if(!isArrayBuffer(buffer)) {
         buffer = b64decode(buffer);
     }
-    var shape = v.shape === undefined ?
+    var shape: any[] = v.shape === undefined ?
         // detect 1-d length
         [buffer.byteLength / BYTES_PER_ELEMENT] :
         // convert number to string and split to array
@@ -116,7 +116,7 @@ export var decodeTypedArraySpec = function(vIn) {
     shape.reverse(); // i.e. to match numpy order
     var ndim = shape.length;
 
-    var nj, j;
+    var nj: number, j: number;
     var ni = +shape[0];
 
     var rowBytes = BYTES_PER_ELEMENT * ni;
@@ -154,7 +154,7 @@ export var decodeTypedArraySpec = function(vIn) {
     return out;
 };
 
-export var isTypedArraySpec = function(v) {
+export var isTypedArraySpec = function(v: any): boolean {
     return (
         isPlainObject(v) &&
         v.hasOwnProperty('dtype') && (typeof v.dtype === 'string') &&
@@ -167,23 +167,23 @@ export var isTypedArraySpec = function(v) {
     );
 };
 
-function coerceTypedArraySpec(v) {
+function coerceTypedArraySpec(v: any): { bdata: any; dtype: string; shape: any } {
     return {
         bdata: v.bdata,
         dtype: v.dtype,
         shape: v.shape
     };
 }
 
-export var concat = function() {
-    var args = [];
+export var concat = function(...arrays: any[]): any {
+    var args: any[] = [];
     var allArray = true;
     var totalLen = 0;
 
-    var _constructor, arg0, i, argi, posi, leni, out, j;
+    var _constructor: any, arg0: any, i: number, argi: any, posi: number, leni: number, out: any, j: number;
 
-    for(i = 0; i < arguments.length; i++) {
-        argi = arguments[i];
+    for(i = 0; i < arrays.length; i++) {
+        argi = arrays[i];
         leni = argi.length;
         if(leni) {
             if(arg0) args.push(argi);
@@ -219,8 +219,8 @@ export var concat = function() {
         out.set(arg0);
         for(i = 0; i < args.length; i++) {
             argi = args[i];
-            out.set(argi, posi);
-            posi += argi.length;
+            out.set(argi, posi!);
+            posi! += argi.length;
         }
         return out;
     }
@@ -230,21 +230,21 @@ export var concat = function() {
     for(j = 0; j < arg0.length; j++) out[j] = arg0[j];
     for(i = 0; i < args.length; i++) {
         argi = args[i];
-        for(j = 0; j < argi.length; j++) out[posi + j] = argi[j];
-        posi += j;
+        for(j = 0; j < argi.length; j++) out[posi! + j] = argi[j];
+        posi! += j;
     }
     return out;
 };
 
-export var maxRowLength = function(z) {
+export var maxRowLength = function(z: any): number {
     return _rowLength(z, Math.max, 0);
 };
 
-export var minRowLength = function(z) {
+export var minRowLength = function(z: any): number {
     return _rowLength(z, Math.min, Infinity);
 };
 
-function _rowLength(z, fn, len0) {
+function _rowLength(z: any, fn: (a: number, b: number) => number, len0: number): number {
     if(isArrayOrTypedArray(z)) {
         if(isArrayOrTypedArray(z[0])) {
             var len = len0;

src/lib/d3-compat.js src/lib/d3-compat.tssrc/lib/d3-compat.js renamed to src/lib/d3-compat.ts

@@ -14,18 +14,18 @@
 import { selection } from 'd3-selection';
 import 'd3-transition';
 
-var _origStyle = selection.prototype.style;
-var _origAttr = selection.prototype.attr;
-var _origEnter = selection.prototype.enter;
-var _origSelect = selection.prototype.select;
+var _origStyle = (selection.prototype as any).style;
+var _origAttr = (selection.prototype as any).attr;
+var _origEnter = (selection.prototype as any).enter;
+var _origSelect = (selection.prototype as any).select;
 
 // Patch .select() to NOT propagate parent data to child (v3 behavior).
 // In d3 v4+, select() copies parent.__data__ to child.__data__, which breaks
 // plotly.js code that uses .select() just to find elements without affecting data.
-selection.prototype.select = function(selector) {
+(selection.prototype as any).select = function(this: any, selector: any): any {
     if(typeof selector === 'string') {
         // Save __data__ on all elements that might be affected
-        var savedData = [];
+        var savedData: Array<{ node: any; data: any }> = [];
         var groups = this._groups;
         for(var j = 0; j < groups.length; ++j) {
             for(var i = 0; i < groups[j].length; ++i) {
@@ -49,7 +49,7 @@ selection.prototype.select = function(selector) {
 };
 
 // Patch .style() to accept object arg
-selection.prototype.style = function(nameOrObj, value, priority) {
+(selection.prototype as any).style = function(this: any, nameOrObj: any, value?: any, priority?: any): any {
     if(typeof nameOrObj === 'object' && nameOrObj !== null) {
         for(var key in nameOrObj) {
             _origStyle.call(this, key, nameOrObj[key]);
@@ -60,7 +60,7 @@ selection.prototype.style = function(nameOrObj, value, priority) {
 };
 
 // Patch .attr() to accept object arg AND handle null-node getters
-selection.prototype.attr = function(nameOrObj, value) {
+(selection.prototype as any).attr = function(this: any, nameOrObj: any, value?: any): any {
     // Object form: .attr({key: val, ...})
     if(typeof nameOrObj === 'object' && nameOrObj !== null && !(nameOrObj instanceof String)) {
         for(var key in nameOrObj) {
@@ -79,13 +79,13 @@ selection.prototype.attr = function(nameOrObj, value) {
 // In d3 v3, after enter().append(), the appended nodes were automatically part of the
 // update selection. In v4+, enter and update are separate selections. This polyfill
 // wraps .append() and .insert() on enter selections to merge entered nodes back.
-selection.prototype.enter = function() {
+(selection.prototype as any).enter = function(this: any): any {
     var enterSel = _origEnter.call(this);
     var updateSel = this;
     var _origAppend = enterSel.append;
     var _origInsert = enterSel.insert;
 
-    enterSel.append = function() {
+    enterSel.append = function(this: any): any {
         var result = _origAppend.apply(this, arguments);
         // Merge entered nodes into the update selection's _groups
         var enterGroups = result._groups;
@@ -100,7 +100,7 @@ selection.prototype.enter = function() {
         return result;
     };
 
-    enterSel.insert = function() {
+    enterSel.insert = function(this: any): any {
         var result = _origInsert.apply(this, arguments);
         var enterGroups = result._groups;
         var updateGroups = updateSel._groups;