convert 23 small lib modules to TypeScript

All lib utility files under 100 lines converted to .ts with type
annotations. Total: 36 of 53 lib files now TypeScript.

Remaining 17 are larger modules (100-1,656 lines): extend, d3-compat,
keyed_container, queue, geometry2d, events, matrix, dom,
nested_property, polygon, array, geo_location_utils, dates, coerce,
svg_text_utils, trace_categories, index.

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

Author: ryan-williams

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

@@ -1,39 +1,46 @@
-export var isLeftAnchor = function isLeftAnchor(opts) {
+interface AnchorOpts {
+    xanchor: string;
+    yanchor: string;
+    x: number;
+    y: number;
+}
+
+export var isLeftAnchor = function isLeftAnchor(opts: AnchorOpts): boolean {
     return (
       opts.xanchor === 'left' ||
       (opts.xanchor === 'auto' && opts.x <= 1 / 3)
     );
 };
 
-export var isCenterAnchor = function isCenterAnchor(opts) {
+export var isCenterAnchor = function isCenterAnchor(opts: AnchorOpts): boolean {
     return (
         opts.xanchor === 'center' ||
         (opts.xanchor === 'auto' && opts.x > 1 / 3 && opts.x < 2 / 3)
     );
 };
 
-export var isRightAnchor = function isRightAnchor(opts) {
+export var isRightAnchor = function isRightAnchor(opts: AnchorOpts): boolean {
     return (
       opts.xanchor === 'right' ||
       (opts.xanchor === 'auto' && opts.x >= 2 / 3)
     );
 };
 
-export var isTopAnchor = function isTopAnchor(opts) {
+export var isTopAnchor = function isTopAnchor(opts: AnchorOpts): boolean {
     return (
         opts.yanchor === 'top' ||
         (opts.yanchor === 'auto' && opts.y >= 2 / 3)
     );
 };
 
-export var isMiddleAnchor = function isMiddleAnchor(opts) {
+export var isMiddleAnchor = function isMiddleAnchor(opts: AnchorOpts): boolean {
     return (
         opts.yanchor === 'middle' ||
         (opts.yanchor === 'auto' && opts.y > 1 / 3 && opts.y < 2 / 3)
     );
 };
 
-export var isBottomAnchor = function isBottomAnchor(opts) {
+export var isBottomAnchor = function isBottomAnchor(opts: AnchorOpts): boolean {
     return (
       opts.yanchor === 'bottom' ||
       (opts.yanchor === 'auto' && opts.y <= 1 / 3)

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

@@ -5,7 +5,7 @@ const { BADNUM } = _numerical;
 // precompile for speed
 var JUNK = /^['"%,$#\s']+|[, ]|['"%,$#\s']+$/g;
 
-export default function cleanNumber(v) {
+export default function cleanNumber(v: any): number {
     if(typeof v === 'string') {
         v = v.replace(JUNK, '');
     }

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

@@ -1,8 +1,8 @@
-export default function clearGlCanvases(gd) {
+export default function clearGlCanvases(gd: any): void {
     var fullLayout = gd._fullLayout;
 
     if(fullLayout._glcanvas && fullLayout._glcanvas.size()) {
-        fullLayout._glcanvas.each(function(d) {
+        fullLayout._glcanvas.each(function(d: any) {
             if(d.regl) d.regl.clear({color: true, depth: true});
         });
     }

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

@@ -1,6 +1,6 @@
-export default function filterUnique(array) {
-    var seen = {};
-    var out = [];
+export default function filterUnique(array: any[]): any[] {
+    var seen: Record<string, number> = {};
+    var out: any[] = [];
     var j = 0;
 
     for(var i = 0; i < array.length; i++) {

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

@@ -1,6 +1,6 @@
-export default function filterVisible(container) {
+export default function filterVisible(container: any[]): any[] {
     var filterFn = isCalcData(container) ? calcDataFilter : baseFilter;
-    var out = [];
+    var out: any[] = [];
 
     for(var i = 0; i < container.length; i++) {
         var item = container[i];
@@ -10,16 +10,16 @@ export default function filterVisible(container) {
     return out;
 }
 
-function baseFilter(item) {
+function baseFilter(item: any): boolean {
     return item.visible === true;
 }
 
-function calcDataFilter(item) {
+function calcDataFilter(item: any): boolean {
     var trace = item[0].trace;
     return trace.visible === true && trace._length !== 0;
 }
 
-function isCalcData(cont) {
+function isCalcData(cont: any[]): boolean {
     return (
         Array.isArray(cont) &&
         Array.isArray(cont[0]) &&

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

@@ -1,12 +1,12 @@
 import _numerical from '../constants/numerical.js';
 const { BADNUM } = _numerical;
 
-export var calcTraceToLineCoords = function(calcTrace) {
+export var calcTraceToLineCoords = function(calcTrace: any[]): number[][][] {
     var trace = calcTrace[0].trace;
     var connectgaps = trace.connectgaps;
 
-    var coords = [];
-    var lineString = [];
+    var coords: number[][][] = [];
+    var lineString: number[][] = [];
 
     for(var i = 0; i < calcTrace.length; i++) {
         var calcPt = calcTrace[i];
@@ -27,7 +27,12 @@ export var calcTraceToLineCoords = function(calcTrace) {
     return coords;
 };
 
-export var makeLine = function(coords) {
+interface GeoJSONGeometry {
+    type: string;
+    coordinates: any;
+}
+
+export var makeLine = function(coords: number[][][]): GeoJSONGeometry {
     if(coords.length === 1) {
         return {
             type: 'LineString',
@@ -41,7 +46,7 @@ export var makeLine = function(coords) {
     }
 };
 
-export var makePolygon = function(coords) {
+export var makePolygon = function(coords: number[][][]): GeoJSONGeometry {
     if(coords.length === 1) {
         return {
             type: 'Polygon',
@@ -61,7 +66,7 @@ export var makePolygon = function(coords) {
     }
 };
 
-export var makeBlank = function() {
+export var makeBlank = function(): GeoJSONGeometry {
     return {
         type: 'Point',
         coordinates: []

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

@@ -8,34 +8,34 @@ import { isArrayOrTypedArray } from './array.js';
 var colorDfltRgba = rgba(colorDflt);
 var opacityDflt = 1;
 
-function calculateColor(colorIn, opacityIn) {
+function calculateColor(colorIn: number[], opacityIn: number): number[] {
     var colorOut = colorIn;
     colorOut[3] *= opacityIn;
     return colorOut;
 }
 
-function validateColor(colorIn) {
+function validateColor(colorIn: any): number[] {
     if(isNumeric(colorIn)) return colorDfltRgba;
 
     var colorOut = rgba(colorIn);
 
     return colorOut.length ? colorOut : colorDfltRgba;
 }
 
-function validateOpacity(opacityIn) {
+function validateOpacity(opacityIn: any): number {
     return isNumeric(opacityIn) ? opacityIn : opacityDflt;
 }
 
-function formatColor(containerIn, opacityIn, len) {
+function formatColor(containerIn: any, opacityIn: any, len: number): number[] | number[][] {
     var colorIn = containerIn.color;
     if(colorIn && colorIn._inputArray) colorIn = colorIn._inputArray;
 
     var isArrayColorIn = isArrayOrTypedArray(colorIn);
     var isArrayOpacityIn = isArrayOrTypedArray(opacityIn);
     var cOpts = Colorscale.extractOpts(containerIn);
-    var colorOut = [];
+    var colorOut: any[] = [];
 
-    var sclFunc, getColor, getOpacity, colori, opacityi;
+    var sclFunc: any, getColor: any, getOpacity: any, colori: any, opacityi: any;
 
     if(cOpts.colorscale !== undefined) {
         sclFunc = Colorscale.makeColorScaleFuncFromTrace(containerIn);
@@ -44,14 +44,14 @@ function formatColor(containerIn, opacityIn, len) {
     }
 
     if(isArrayColorIn) {
-        getColor = function(c, i) {
+        getColor = function(c: any, i: number): number[] {
             // FIXME: there is double work, considering that sclFunc does the opposite
             return c[i] === undefined ? colorDfltRgba : rgba(sclFunc(c[i]));
         };
     } else getColor = validateColor;
 
     if(isArrayOpacityIn) {
-        getOpacity = function(o, i) {
+        getOpacity = function(o: any, i: number): number {
             return o[i] === undefined ? opacityDflt : validateOpacity(o[i]);
         };
     } else getOpacity = validateOpacity;
@@ -67,13 +67,13 @@ function formatColor(containerIn, opacityIn, len) {
     return colorOut;
 }
 
-function parseColorScale(cont) {
+function parseColorScale(cont: any): { index: number; rgb: number[] }[] {
     var cOpts = Colorscale.extractOpts(cont);
 
     var colorscale = cOpts.colorscale;
     if(cOpts.reversescale) colorscale = Colorscale.flipScale(cOpts.colorscale);
 
-    return colorscale.map(function(elem) {
+    return colorscale.map(function(elem: any[]) {
         var index = elem[0];
         var color = tinycolor(elem[1]);
         var rgb = color.toRgb();

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

@@ -1,6 +1,6 @@
 import identity from './identity.js';
 
-function wrap(d) {return [d];}
+function wrap(d: any): any[] {return [d];}
 
 export default {
 
@@ -11,7 +11,7 @@ export default {
     // of elements, e.g. points, lines, rows, requiring an array as input.
     // The role of the `keyFun` is to identify what elements are being entered/exited/updated,
     // otherwise D3 reverts to using a plain index which would screw up `transition`s.
-    keyFun: function(d) {return d.key;},
+    keyFun: function(d: any): string {return d.key;},
     repeat: wrap,
     descend: identity,
 
@@ -20,5 +20,5 @@ export default {
     // newcomer to the codebase may not know what the `[0]` is, and whether there can be further
     // elements (not atm).
     wrap: wrap,
-    unwrap: function(d) {return d[0];}
+    unwrap: function(d: any[]): any {return d[0];}
 };

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

@@ -1,4 +1,4 @@
-export default function incrementNumeric(x, delta) {
+export default function incrementNumeric(x: number, delta: number): number {
     if(!delta) return x;
 
     // Note 1:
@@ -20,7 +20,7 @@ export default function incrementNumeric(x, delta) {
         var lenX0 = String(x).length;
 
         if(lenX1 >= lenX0 + lenDt) { // likely a rounding error!
-            var s = parseFloat(newX).toPrecision(12);
+            var s = parseFloat(newX as any).toPrecision(12);
             if(s.indexOf('e+') === -1) newX = +s;
         }
     }

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

@@ -1,6 +1,6 @@
 import Registry from '../registry.js';
 
-export default function localize(gd, s) {
+export default function localize(gd: any, s: string): string {
     var locale = gd._context.locale;
 
     /*