add schema-generated types, start replacing \any\ with real types

- Add \`tasks/gen-schema-types.mjs\`: generates TypeScript interfaces
  from \`plot-schema.json\` (the formal plotly attribute schema)
- Generate \`types/schema.d.ts\` (1,368 lines): typed \`ScatterTrace\`,
  \`SchemaLayout\` with proper \`valType\` → TS mappings
- Replace \`gd: any\` → \`GraphDiv\` and \`trace: any\` → \`FullTrace\`
  in \`drawing/index.ts\` (14 + 12 replacements)
- Fix \`CalcData\` type (was double-nested)
- Properly type \`fx/calc.ts\` as example of real typing

The \`[key: string]: any\` escape hatch on core interfaces means these
types provide documentation + IDE autocomplete without breaking anything.
Removing the escape hatch requires exhaustively listing all properties
(which the schema-generated types enable, as a future step).

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

Author: ryan-williams

src/components/drawing/index.ts

@@ -1,4 +1,5 @@
 import { select } from 'd3-selection';
+import type { GraphDiv, FullTrace, FullAxis } from '../../../types/core';
 function d3Round(x: number, n: number): number { return n ? Math.round(x * (n = Math.pow(10, n))) / n : Math.round(x); }
 import { ensureSingle, ensureSingleById, extendFlat, extractOption, identity, isArrayOrTypedArray, nestedProperty, numberFormat, strTranslate, texttemplateString } from '../../lib/index.js';
 import isNumeric from 'fast-isnumeric';
@@ -132,7 +133,7 @@ export function hideOutsideRangePoints(traceGroups: any, subplot: any): void {
     });
 }
 
-export function crispRound(gd: any, lineWidth: number, dflt?: number): number {
+export function crispRound(gd: GraphDiv, lineWidth: number, dflt?: number): number {
     if (!lineWidth || !isNumeric(lineWidth)) return dflt || 0;
 
     if (gd._context.staticPlot) return lineWidth;
@@ -191,7 +192,7 @@ export function dashStyle(dash: string, lineWidth: number): string {
     return dash;
 }
 
-function setFillStyle(sel: any, trace: any, gd: any, forLegend: boolean): void {
+function setFillStyle(sel: any, trace: FullTrace, gd: GraphDiv, forLegend: boolean): void {
     var markerPattern = trace.fillpattern;
     var fillgradient = trace.fillgradient;
     var pAttr = getPatternAttr;
@@ -274,14 +275,14 @@ function setFillStyle(sel: any, trace: any, gd: any, forLegend: boolean): void {
     }
 }
 
-export function singleFillStyle(sel: any, gd: any): void {
+export function singleFillStyle(sel: any, gd: GraphDiv): void {
     var node = select(sel.node());
     var data = node.data();
     var trace = ((data[0] || [])[0] || {}).trace || {};
     setFillStyle(sel, trace, gd, false);
 }
 
-export function fillGroupStyle(s: any, gd: any, forLegend?: boolean): void {
+export function fillGroupStyle(s: any, gd: GraphDiv, forLegend?: boolean): void {
     s.style('stroke-width', 0).each(function (this: any, d: any) {
         var shape = select(this);
         if (d[0].trace) {
@@ -375,7 +376,7 @@ var gradientInfo: Record<string, any> = {
     verticalreversed: { type: 'linear', start: { x: 0, y: 1 }, stop: { x: 0, y: 0 }, reversed: true }
 };
 
-export function gradient(sel: any, gd: any, gradientID: string, type: string, colorscale: any[], prop: string): void {
+export function gradient(sel: any, gd: GraphDiv, gradientID: string, type: string, colorscale: any[], prop: string): void {
     var info = gradientInfo[type];
     return gradientWithBounds(
         sel,
@@ -391,7 +392,7 @@ export function gradient(sel: any, gd: any, gradientID: string, type: string, co
     );
 }
 
-function gradientWithBounds(sel: any, gd: any, gradientID: string, type: string, colorscale: any[], prop: string, start: any, stop: any, inUserSpace: boolean, reversed: boolean): void {
+function gradientWithBounds(sel: any, gd: GraphDiv, gradientID: string, type: string, colorscale: any[], prop: string, start: any, stop: any, inUserSpace: boolean, reversed: boolean): void {
     var len = colorscale.length;
 
     var info: any;
@@ -464,7 +465,7 @@ function gradientWithBounds(sel: any, gd: any, gradientID: string, type: string,
 export function pattern(
     sel: any,
     calledBy: string,
-    gd: any,
+    gd: GraphDiv,
     patternID: string,
     shape: string,
     size: number,
@@ -760,7 +761,7 @@ export function pattern(
     sel.classed('pattern_filled', true);
 }
 
-export function initGradients(gd: any): void {
+export function initGradients(gd: GraphDiv): void {
     var fullLayout = gd._fullLayout;
 
     var gradientsGroup = ensureSingle(fullLayout._defs, 'g', 'gradients');
@@ -769,7 +770,7 @@ export function initGradients(gd: any): void {
     select(gd).selectAll('.gradient_filled').classed('gradient_filled', false);
 }
 
-export function initPatterns(gd: any): void {
+export function initPatterns(gd: GraphDiv): void {
     var fullLayout = gd._fullLayout;
 
     var patternsGroup = ensureSingle(fullLayout._defs, 'g', 'patterns');
@@ -785,7 +786,7 @@ export function getPatternAttr(mp: any, i: number, dflt: any): any {
     return mp;
 }
 
-export function pointStyle(s: any, trace: any, gd: any, pt?: any): void {
+export function pointStyle(s: any, trace: FullTrace, gd: GraphDiv, pt?: any): void {
     if (!s.size()) return;
 
     var fns = makePointStyleFns(trace);
@@ -795,7 +796,7 @@ export function pointStyle(s: any, trace: any, gd: any, pt?: any): void {
     });
 }
 
-export function singlePointStyle(d: any, sel: any, trace: any, fns: any, gd: any, pt?: any): void {
+export function singlePointStyle(d: any, sel: any, trace: FullTrace, fns: any, gd: GraphDiv, pt?: any): void {
     var marker = trace.marker;
     var markerLine = marker.line;
 
@@ -955,7 +956,7 @@ export function singlePointStyle(d: any, sel: any, trace: any, fns: any, gd: any
     }
 }
 
-export function makePointStyleFns(trace: any): any {
+export function makePointStyleFns(trace: FullTrace): any {
     var out: Record<string, any> = {};
     var marker = trace.marker;
 
@@ -977,7 +978,7 @@ export function makePointStyleFns(trace: any): any {
     return out;
 }
 
-export function makeSelectedPointStyleFns(trace: any): any {
+export function makeSelectedPointStyleFns(trace: FullTrace): any {
     var out: Record<string, any> = {};
 
     var selectedAttrs = trace.selected || {};
@@ -1042,7 +1043,7 @@ export function makeSelectedPointStyleFns(trace: any): any {
     return out;
 }
 
-export function makeSelectedTextStyleFns(trace: any): any {
+export function makeSelectedTextStyleFns(trace: FullTrace): any {
     var out: Record<string, any> = {};
 
     var selectedAttrs = trace.selected || {};
@@ -1070,7 +1071,7 @@ export function makeSelectedTextStyleFns(trace: any): any {
     return out;
 }
 
-export function selectedPointStyle(s: any, trace: any): void {
+export function selectedPointStyle(s: any, trace: FullTrace): void {
     if (!s.size() || !trace.selectedpoints) return;
 
     var fns = makeSelectedPointStyleFns(trace);
@@ -1151,12 +1152,12 @@ function textPointPosition(s: any, textPosition: string, fontSize: number, marke
     }
 }
 
-function extracTextFontSize(d: any, trace: any): number {
+function extracTextFontSize(d: any, trace: FullTrace): number {
     var fontSize = d.ts || trace.textfont.size;
     return isNumeric(fontSize) && fontSize > 0 ? fontSize : 0;
 }
 
-export function textPointStyle(s: any, trace: any, gd: any): void {
+export function textPointStyle(s: any, trace: FullTrace, gd: GraphDiv): void {
     if (!s.size()) return;
 
     var selectedTextColorFn: any;
@@ -1215,7 +1216,7 @@ export function textPointStyle(s: any, trace: any, gd: any): void {
     });
 }
 
-export function selectedTextStyle(s: any, trace: any): void {
+export function selectedTextStyle(s: any, trace: FullTrace): void {
     if (!s.size() || !trace.selectedpoints) return;
 
     var fns = makeSelectedTextStyleFns(trace);
@@ -1498,11 +1499,11 @@ function nodeHash(node: any): string | undefined {
     return inputText + node.getAttribute('data-math') + node.getAttribute('text-anchor') + node.getAttribute('style');
 }
 
-export function setClipUrl(s: any, localId: string, gd: any): void {
+export function setClipUrl(s: any, localId: string, gd: GraphDiv): void {
     s.attr('clip-path', getFullUrl(localId, gd));
 }
 
-function getFullUrl(localId: string, gd: any): string | null {
+function getFullUrl(localId: string, gd: GraphDiv): string | null {
     if (!localId) return null;
 
     var context = gd._context;
@@ -1629,7 +1630,7 @@ export function setTextPointsScale(selection: any, xScale: number, yScale: numbe
     });
 }
 
-function getMarkerStandoff(d: any, trace: any): number {
+function getMarkerStandoff(d: any, trace: FullTrace): number {
     var standoff: number;
 
     if (d) standoff = d.mf;
@@ -1664,7 +1665,7 @@ var previousY: number;
 var previousI: number;
 var previousTraceUid: string;
 
-function getMarkerAngle(d: any, trace: any): number | null {
+function getMarkerAngle(d: any, trace: FullTrace): number | null {
     var angle: any = d.ma;
 
     if (angle === undefined) {

src/components/fx/calc.ts

@@ -1,18 +1,20 @@
-import { coerceHoverinfo, fillArray, identity } from '../../lib/index.js';
+import type { GraphDiv, FullTrace, CalcDatum } from '../../../types/core';
+import { fillArray, identity } from '../../lib/index.js';
+import { coerceHoverinfo } from '../../lib/index.js';
 import Registry from '../../registry.js';
 
-export default function calc(gd: any): void {
+export default function calc(gd: GraphDiv): void {
     var calcdata = gd.calcdata;
     var fullLayout = gd._fullLayout;
 
-    function makeCoerceHoverInfo(trace: any): (val: any) => any {
+    function makeCoerceHoverInfo(trace: FullTrace): (val: any) => any {
         return function(val: any): any {
             return coerceHoverinfo({hoverinfo: val}, {_module: trace._module}, fullLayout);
         };
     }
 
     for(var i = 0; i < calcdata.length; i++) {
-        var cd = calcdata[i];
+        var cd: CalcDatum[] = calcdata[i];
         var trace = cd[0].trace;
 
         // don't include hover calc fields for pie traces
@@ -42,7 +44,7 @@ export default function calc(gd: any): void {
     }
 }
 
-function paste(traceAttr: any, cd: any, cdAttr: string, fn?: (val: any) => any): void {
+function paste(traceAttr: any, cd: CalcDatum[], cdAttr: string, fn?: (val: any) => any): void {
     fn = fn || identity;
 
     if(Array.isArray(traceAttr)) {

tasks/gen-schema-types.mjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * Generate TypeScript interfaces from plot-schema.json.
+ *
+ * Reads the plotly schema and emits typed interfaces for traces and layout.
+ * valType mapping:
+ *   string, color, colorscale, subplotid → string
+ *   number, integer, angle → number
+ *   boolean → boolean
+ *   enumerated → union of values
+ *   flaglist → string
+ *   data_array, info_array → any[]
+ *   any → any
+ *   nested objects → recursive interface
+ */
+import { readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+const schema = JSON.parse(readFileSync(join(root, 'dist/plot-schema.json'), 'utf-8'));
+
+function valTypeToTS(attr) {
+    if(!attr || !attr.valType) {
+        if(attr && typeof attr === 'object' && !Array.isArray(attr)) {
+            return null; // nested object, handle recursively
+        }
+        return 'any';
+    }
+    switch(attr.valType) {
+        case 'string': return 'string';
+        case 'color': return 'string';
+        case 'colorscale': return 'string | [number, string][]';
+        case 'subplotid': return 'string';
+        case 'number': return 'number';
+        case 'integer': return 'number';
+        case 'angle': return 'number';
+        case 'boolean': return 'boolean';
+        case 'flaglist': return 'string';
+        case 'data_array': return 'any[]';
+        case 'info_array': return 'any[]';
+        case 'any': return 'any';
+        case 'enumerated':
+            if(attr.values) {
+                return attr.values.map(v => {
+                    if(typeof v === 'string') return `'${v}'`;
+                    if(typeof v === 'boolean') return String(v);
+                    return String(v);
+                }).join(' | ');
+            }
+            return 'any';
+        default: return 'any';
+    }
+}
+
+function generateInterface(name, attrs, indent = '') {
+    const lines = [];
+    const skip = new Set(['editType', 'description', 'role', '_isSubplotObj',
+        '_isLinkedToArray', '_arrayAttrRegexps', '_deprecated', 'impliedEdits',
+        'uid', '_noTemplating', 'uirevision']);
+
+    for(const [key, attr] of Object.entries(attrs)) {
+        if(skip.has(key)) continue;
+        if(key.startsWith('_')) continue;
+        if(key.endsWith('src')) continue; // data source refs
+
+        const tsType = valTypeToTS(attr);
+        if(tsType === null) {
+            // nested object
+            const nestedAttrs = Object.fromEntries(
+                Object.entries(attr).filter(([k]) => !skip.has(k) && !k.startsWith('_'))
+            );
+            if(Object.keys(nestedAttrs).length > 0) {
+                lines.push(`${indent}    ${safeName(key)}?: {`);
+                const inner = generateInterface(key, nestedAttrs, indent + '    ');
+                lines.push(...inner);
+                lines.push(`${indent}    };`);
+            }
+        } else {
+            lines.push(`${indent}    ${safeName(key)}?: ${tsType};`);
+        }
+    }
+    return lines;
+}
+
+function safeName(key) {
+    if(/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)) return key;
+    return `'${key}'`;
+}
+
+// Generate trace interfaces
+const output = [];
+output.push('/**');
+output.push(' * Auto-generated from plot-schema.json');
+output.push(' * DO NOT EDIT — regenerate with: node tasks/gen-schema-types.mjs');
+output.push(' */');
+output.push('');
+
+for(const [traceName, traceSchema] of Object.entries(schema.traces)) {
+    const attrs = traceSchema.attributes || {};
+    const iface = `${traceName.charAt(0).toUpperCase() + traceName.slice(1)}Trace`;
+    output.push(`export interface ${iface} {`);
+    output.push(`    type: '${traceName}';`);
+    output.push(...generateInterface(iface, attrs));
+    output.push('}');
+    output.push('');
+}
+
+// Generate layout interface
+output.push('export interface SchemaLayout {');
+const layoutAttrs = schema.layout.layoutAttributes || {};
+output.push(...generateInterface('SchemaLayout', layoutAttrs));
+output.push('}');
+output.push('');
+
+// Union type for all traces
+const traceNames = Object.keys(schema.traces);
+output.push('export type AnyTrace = ' + traceNames.map(t =>
+    `${t.charAt(0).toUpperCase() + t.slice(1)}Trace`
+).join(' | ') + ';');
+output.push('');
+
+const outPath = join(root, 'types/schema.d.ts');
+writeFileSync(outPath, output.join('\n') + '\n');
+console.log(`Generated ${outPath}`);
+console.log(`  ${traceNames.length} trace interfaces`);
+console.log(`  ${output.length} lines`);

types/core.d.ts

@@ -19,7 +19,7 @@ export interface GraphDiv extends HTMLDivElement {
     _fullData: FullTrace[];
     _fullLayout: FullLayout;
     _transitionData?: TransitionData;
-    calcdata: CalcData[][];
+    calcdata: CalcData[];
     _context: PlotConfig;
     _promises: Promise<void>[];
     _ev?: EventEmitter;