@spidunno/desmos-types 1.13.6 → 1.13.8

package/module/index.d.ts

@@ -568,12 +568,182 @@ declare namespace Desmos {
      * @defaultValue a random 128-bit hex string
      */
     randomSeed?: string;
+    /**
+     * Turn on Complex Mode, so expressions can use complex numbers. Ignored
+     * (forced to `false`) when `allowComplex` is `false`, and turns off
+     * `degreeMode`.
+     * @defaultValue `false`
+     * @remarks Undocumented.
+     */
+    complex?: boolean;
+    /**
+     * Draw the grid, axes and numbers only in the first quadrant.
+     * @defaultValue `false`
+     * @remarks Undocumented.
+     */
+    restrictGridToFirstQuadrant?: boolean;
+    /**
+     * The "lock viewport" toggle in the graph settings, which stops the user
+     * from panning and zooming. Unlike `lockViewport`, it is part of the graph
+     * state.
+     * @defaultValue `false`
+     * @remarks Undocumented.
+     */
+    userLockedViewport?: boolean;
+  }
+
+  /**
+   * Configuration options the docs don't mention that still appear on
+   * `calculator.settings`.
+   *
+   * @remarks Undocumented: may change without notice.
+   */
+  interface UndocumentedGraphingCalculatorConfig {
+    /**
+     * Show the author features enabled by `authorFeatures`. With `false`, they
+     * stay available but hidden, as when an author previews the student view.
+     * @defaultValue `true`
+     */
+    authorMode?: boolean;
+    /** Allow the advanced styling options in the style menu. @defaultValue `false` */
+    advancedStyling?: boolean;
+    /** Allow defining functions, like `f(x)=x^2`. @defaultValue `true` */
+    functionDefinition?: boolean;
+    /** 3D: put the viewport controls on the left instead of the right. @defaultValue `false` */
+    leftAlign3dViewportControls?: boolean;
+    /** 3D: draw surfaces with their opacity. When `false`, surfaces are opaque. @defaultValue `false` */
+    translucentSurfaces?: boolean;
+    /** Show keyboard shortcuts in tooltips. @defaultValue `false` */
+    showKeyboardShortcutsInTooltips?: boolean;
+    /** Show a performance meter over the graph paper. @defaultValue `false` */
+    showPerformanceMeter?: boolean;
+  }
+
+  /**
+   * Options Desmos uses for its own products, debugging and embedding. They
+   * are accepted by the constructor and `updateSettings()` but never appear
+   * on `calculator.settings`.
+   *
+   * @remarks Undocumented: may change without notice.
+   */
+  interface InternalGraphingCalculatorOptions {
+    /**
+     * Which product the calculator behaves as. `Desmos.Geometry` and
+     * `Desmos.Calculator3D` set this themselves.
+     * @defaultValue `'graphing'`
+     */
+    product?: 'graphing' | 'geometry-calculator' | 'graphing-3d';
+    /** Show the Desmos branding on the graph paper. @defaultValue `true` */
+    branding?: boolean;
+    /** Only trace and show points of interest for the selected expression. @defaultValue `false` */
+    onlyTraceSelected?: boolean;
+    /** Ignore mouse and touch input on the graph paper. @defaultValue `false` */
+    disableMouseInteractions?: boolean;
+    /** Accepted, but not read anywhere in the v1.13 bundle. @defaultValue `false` */
+    nativeOnscreenKeypad?: boolean;
+    /** 3D: draw surfaces as wireframes. @defaultValue `false` */
+    wireframe?: boolean;
+    /** 3D: debug rendering that shows ray-casting cost as a heat map. @defaultValue `false` */
+    raycastHeatmap?: boolean;
+    /** 3D: debugging flag for surface cost estimates (shows them in the expression list). @defaultValue `false` */
+    ignoreCostEstimate?: boolean;
+    /** 3D: ray-cast without interval arithmetic (debugging). @defaultValue `false` */
+    raycastDisableIntervals?: boolean;
+    /**
+     * With `pasteGraphLink`, called with the state of a pasted graph link
+     * before it is imported. Call `done(null, state)` to import it (possibly
+     * modified), or `done(error)` to reject it.
+     * @defaultValue imports the state unchanged
+     */
+    pasteGraphLinkCallback?: (state: GraphState, done: (error: unknown, state?: GraphState) => void) => void;
+    /** Link the branding to desmos.com, where the graph can be edited. @defaultValue `false` */
+    editOnWeb?: boolean;
+    /** Desmos testing: post the cross-origin save test to the current origin. @defaultValue `false` */
+    crossOriginSaveTest?: boolean;
+    /** Make the graph paper and its objects reachable with Tab. @defaultValue `true` */
+    enableTabindex?: boolean;
+    /** Audio Trace: step through expressions in reverse order. @defaultValue `false` */
+    audioTraceReverseExpressions?: boolean;
+    /** Draw the graph paper with a transparent background. @defaultValue `false` */
+    transparentBackground?: boolean;
+    /** Stop animating while the calculator is scrolled out of view. @defaultValue `false` */
+    pauseWhenOffscreen?: boolean;
+    /** 3D: release the WebGL context while the calculator is out of view. @defaultValue `true` */
+    releaseContextWhenOffscreen?: boolean;
+    /** Geometry: hide the geometry toolbar and tools. @defaultValue `false` */
+    hideGeoUI?: boolean;
+    /** 3D: beta features, such as per-surface resolution and translucent surfaces. @defaultValue `false` */
+    beta3d?: boolean;
+    /** Allow strings (categorical data) in expressions. @defaultValue `false` */
+    categoricalData?: boolean;
+    /** Pause the evaluator while the user is zooming. @defaultValue `false` */
+    disableWorkerOnZoom?: boolean;
+    /** Cache rendered SVG images. @defaultValue `false` */
+    cacheRenderedSvgs?: boolean;
+    /** Graph hidden expressions too (the "ghost mode" checkbox in advanced settings). @defaultValue `false` */
+    ghostMode?: boolean;
+    /** Geometry: draw an arc on reflection previews. @defaultValue `false` */
+    reflectionArc?: boolean;
+    /** Log the evaluator's internal errors to the console. @defaultValue `false` */
+    logInternalErrors?: boolean;
+    /** Show the compiler debugging panel. @defaultValue `false` */
+    debugCompiler?: boolean;
+    /** Show each item's id in the expression list. @defaultValue `false` */
+    showIDs?: boolean;
+    /** Show the evaluator's progress on each item, with a legend. @defaultValue `false` */
+    debugProgressUpdates?: boolean;
+    /** Maximum depth of recursive function calls, from 1 to 1,000,000. @defaultValue the evaluator's built-in limit */
+    recursionDepthLimit?: number;
+    /** Never narrate coordinates to screen readers, except during Audio Trace. @defaultValue `false` */
+    reportPositionNone?: boolean;
+    /** The calculator is embedded in a Desmos notebook. @defaultValue `false` */
+    insideDesNotebook?: boolean;
+    /** The expression list is rendered outside the calculator (split panel). @defaultValue `false` */
+    expressionsExternal?: boolean;
+    /** 3D: show the orientation buttons. @defaultValue `true` */
+    orientationButtons?: boolean;
+    /** Accepted, but not read anywhere in the v1.13 bundle. */
+    debug3dRender?: unknown;
+    /** 3D: force this many depth-peeling layers for translucent surfaces. @defaultValue chosen from the scene */
+    debugPeelLayers?: number;
+    /** 3D: choose the number of depth-peeling layers from the scene. @defaultValue `true` */
+    adaptivePeeling?: boolean;
+    /** Accepted, but not read anywhere in the v1.13 bundle. */
+    debugPixelRatio?: unknown;
+    /** 3D: opacity (as LaTeX) given to new translucent surfaces. @defaultValue `'0.8'` */
+    translucentOpacity?: Latex;
+    /** 3D: samples per pixel for depth peeling. @defaultValue chosen from the device pixel ratio */
+    peelUpsample?: number;
+    /** 3D: render surfaces by ray casting. @defaultValue `false` */
+    rayCast?: boolean;
+  }
+
+  /**
+   * Old options that still work: the calculator logs a deprecation warning
+   * and sets the replacement.
+   */
+  interface DeprecatedGraphingCalculatorOptions {
+    /** @deprecated Use `settingsMenu` and `expressionsTopbar`, which this sets. */
+    menus?: boolean;
+    /** @deprecated Use `pointsOfInterest`, which this sets. */
+    solutions?: boolean;
+    /** @deprecated Removed in API v1.0; ignored. */
+    singleVariableSolutions?: boolean;
+    /** @deprecated Use `actions`; `true` sets `actions: true`. */
+    clickableObjects?: boolean;
+    /** @deprecated Use `authorFeatures`, which this sets. */
+    administerSecretFolders?: boolean;
   }
 
   type AxisScale = 'linear' | 'logarithmic';
 
   /** Everything that can be passed to the `GraphingCalculator` constructor or `updateSettings()`. */
-  interface GraphingCalculatorOptions extends GraphingCalculatorConfig, GraphSettings {}
+  interface GraphingCalculatorOptions
+    extends GraphingCalculatorConfig,
+      GraphSettings,
+      UndocumentedGraphingCalculatorConfig,
+      InternalGraphingCalculatorOptions,
+      DeprecatedGraphingCalculatorOptions {}
 
   /** Options for `Desmos.Geometry`. Any graphing calculator option is accepted. */
   type GeometryOptions = GraphingCalculatorOptions;
@@ -586,37 +756,18 @@ declare namespace Desmos {
     | 'substitutions'
     | 'regressionTemplates'
     | 'intervalComprehensions'
-    | 'recursion';
-
-  /**
-   * Settings present on `calculator.settings` at runtime that the docs don't
-   * mention. They are read-only here because their behavior when set is not
-   * part of the public API.
-   *
-   * @remarks Undocumented: may change without notice.
-   */
-  interface UndocumentedGraphingSettings {
-    /** Whether Complex Mode is currently on. */
-    readonly complex: boolean;
-    readonly functionDefinition: boolean;
-    readonly restrictGridToFirstQuadrant: boolean;
-    readonly userLockedViewport: boolean;
-    readonly authorMode: boolean;
-    readonly advancedStyling: boolean;
-    readonly leftAlign3dViewportControls: boolean;
-    readonly translucentSurfaces: boolean;
-    readonly showKeyboardShortcutsInTooltips: boolean;
-    readonly showPerformanceMeter: boolean;
-  }
+    | 'recursion'
+    | keyof InternalGraphingCalculatorOptions
+    | keyof DeprecatedGraphingCalculatorOptions;
 
-  /** The current value of every documented option and graph setting. */
+  /** The current value of every option and graph setting that appears on `calculator.settings`. */
   type GraphingCalculatorSettingsValues = {
     readonly [K in Exclude<keyof GraphingCalculatorOptions, WriteOnlyGraphingOption | 'graphDescription'>]-?: NonNullable<
       GraphingCalculatorOptions[K]
     >;
   } & {
     readonly graphDescription: string | undefined;
-  } & UndocumentedGraphingSettings;
+  };
 
   /**
    * `calculator.settings`: the current settings, observable per property.
@@ -1893,7 +2044,7 @@ declare namespace Desmos {
     /** Set global MathQuill configuration. */
     config(config: MathQuillConfig): void;
     /** The MathQuill API instance attached to `element`, if any. */
-    getApiInstanceForElement(element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+    getApiInstanceForElement(element: Element): MathQuillStaticMath | MathQuillMathField | null | undefined;
   }
 
   /** @remarks Undocumented: may change without notice. */

package/module/internals.d.ts

@@ -568,12 +568,182 @@ declare namespace Desmos {
      * @defaultValue a random 128-bit hex string
      */
     randomSeed?: string;
+    /**
+     * Turn on Complex Mode, so expressions can use complex numbers. Ignored
+     * (forced to `false`) when `allowComplex` is `false`, and turns off
+     * `degreeMode`.
+     * @defaultValue `false`
+     * @remarks Undocumented.
+     */
+    complex?: boolean;
+    /**
+     * Draw the grid, axes and numbers only in the first quadrant.
+     * @defaultValue `false`
+     * @remarks Undocumented.
+     */
+    restrictGridToFirstQuadrant?: boolean;
+    /**
+     * The "lock viewport" toggle in the graph settings, which stops the user
+     * from panning and zooming. Unlike `lockViewport`, it is part of the graph
+     * state.
+     * @defaultValue `false`
+     * @remarks Undocumented.
+     */
+    userLockedViewport?: boolean;
+  }
+
+  /**
+   * Configuration options the docs don't mention that still appear on
+   * `calculator.settings`.
+   *
+   * @remarks Undocumented: may change without notice.
+   */
+  interface UndocumentedGraphingCalculatorConfig {
+    /**
+     * Show the author features enabled by `authorFeatures`. With `false`, they
+     * stay available but hidden, as when an author previews the student view.
+     * @defaultValue `true`
+     */
+    authorMode?: boolean;
+    /** Allow the advanced styling options in the style menu. @defaultValue `false` */
+    advancedStyling?: boolean;
+    /** Allow defining functions, like `f(x)=x^2`. @defaultValue `true` */
+    functionDefinition?: boolean;
+    /** 3D: put the viewport controls on the left instead of the right. @defaultValue `false` */
+    leftAlign3dViewportControls?: boolean;
+    /** 3D: draw surfaces with their opacity. When `false`, surfaces are opaque. @defaultValue `false` */
+    translucentSurfaces?: boolean;
+    /** Show keyboard shortcuts in tooltips. @defaultValue `false` */
+    showKeyboardShortcutsInTooltips?: boolean;
+    /** Show a performance meter over the graph paper. @defaultValue `false` */
+    showPerformanceMeter?: boolean;
+  }
+
+  /**
+   * Options Desmos uses for its own products, debugging and embedding. They
+   * are accepted by the constructor and `updateSettings()` but never appear
+   * on `calculator.settings`.
+   *
+   * @remarks Undocumented: may change without notice.
+   */
+  interface InternalGraphingCalculatorOptions {
+    /**
+     * Which product the calculator behaves as. `Desmos.Geometry` and
+     * `Desmos.Calculator3D` set this themselves.
+     * @defaultValue `'graphing'`
+     */
+    product?: 'graphing' | 'geometry-calculator' | 'graphing-3d';
+    /** Show the Desmos branding on the graph paper. @defaultValue `true` */
+    branding?: boolean;
+    /** Only trace and show points of interest for the selected expression. @defaultValue `false` */
+    onlyTraceSelected?: boolean;
+    /** Ignore mouse and touch input on the graph paper. @defaultValue `false` */
+    disableMouseInteractions?: boolean;
+    /** Accepted, but not read anywhere in the v1.13 bundle. @defaultValue `false` */
+    nativeOnscreenKeypad?: boolean;
+    /** 3D: draw surfaces as wireframes. @defaultValue `false` */
+    wireframe?: boolean;
+    /** 3D: debug rendering that shows ray-casting cost as a heat map. @defaultValue `false` */
+    raycastHeatmap?: boolean;
+    /** 3D: debugging flag for surface cost estimates (shows them in the expression list). @defaultValue `false` */
+    ignoreCostEstimate?: boolean;
+    /** 3D: ray-cast without interval arithmetic (debugging). @defaultValue `false` */
+    raycastDisableIntervals?: boolean;
+    /**
+     * With `pasteGraphLink`, called with the state of a pasted graph link
+     * before it is imported. Call `done(null, state)` to import it (possibly
+     * modified), or `done(error)` to reject it.
+     * @defaultValue imports the state unchanged
+     */
+    pasteGraphLinkCallback?: (state: GraphState, done: (error: unknown, state?: GraphState) => void) => void;
+    /** Link the branding to desmos.com, where the graph can be edited. @defaultValue `false` */
+    editOnWeb?: boolean;
+    /** Desmos testing: post the cross-origin save test to the current origin. @defaultValue `false` */
+    crossOriginSaveTest?: boolean;
+    /** Make the graph paper and its objects reachable with Tab. @defaultValue `true` */
+    enableTabindex?: boolean;
+    /** Audio Trace: step through expressions in reverse order. @defaultValue `false` */
+    audioTraceReverseExpressions?: boolean;
+    /** Draw the graph paper with a transparent background. @defaultValue `false` */
+    transparentBackground?: boolean;
+    /** Stop animating while the calculator is scrolled out of view. @defaultValue `false` */
+    pauseWhenOffscreen?: boolean;
+    /** 3D: release the WebGL context while the calculator is out of view. @defaultValue `true` */
+    releaseContextWhenOffscreen?: boolean;
+    /** Geometry: hide the geometry toolbar and tools. @defaultValue `false` */
+    hideGeoUI?: boolean;
+    /** 3D: beta features, such as per-surface resolution and translucent surfaces. @defaultValue `false` */
+    beta3d?: boolean;
+    /** Allow strings (categorical data) in expressions. @defaultValue `false` */
+    categoricalData?: boolean;
+    /** Pause the evaluator while the user is zooming. @defaultValue `false` */
+    disableWorkerOnZoom?: boolean;
+    /** Cache rendered SVG images. @defaultValue `false` */
+    cacheRenderedSvgs?: boolean;
+    /** Graph hidden expressions too (the "ghost mode" checkbox in advanced settings). @defaultValue `false` */
+    ghostMode?: boolean;
+    /** Geometry: draw an arc on reflection previews. @defaultValue `false` */
+    reflectionArc?: boolean;
+    /** Log the evaluator's internal errors to the console. @defaultValue `false` */
+    logInternalErrors?: boolean;
+    /** Show the compiler debugging panel. @defaultValue `false` */
+    debugCompiler?: boolean;
+    /** Show each item's id in the expression list. @defaultValue `false` */
+    showIDs?: boolean;
+    /** Show the evaluator's progress on each item, with a legend. @defaultValue `false` */
+    debugProgressUpdates?: boolean;
+    /** Maximum depth of recursive function calls, from 1 to 1,000,000. @defaultValue the evaluator's built-in limit */
+    recursionDepthLimit?: number;
+    /** Never narrate coordinates to screen readers, except during Audio Trace. @defaultValue `false` */
+    reportPositionNone?: boolean;
+    /** The calculator is embedded in a Desmos notebook. @defaultValue `false` */
+    insideDesNotebook?: boolean;
+    /** The expression list is rendered outside the calculator (split panel). @defaultValue `false` */
+    expressionsExternal?: boolean;
+    /** 3D: show the orientation buttons. @defaultValue `true` */
+    orientationButtons?: boolean;
+    /** Accepted, but not read anywhere in the v1.13 bundle. */
+    debug3dRender?: unknown;
+    /** 3D: force this many depth-peeling layers for translucent surfaces. @defaultValue chosen from the scene */
+    debugPeelLayers?: number;
+    /** 3D: choose the number of depth-peeling layers from the scene. @defaultValue `true` */
+    adaptivePeeling?: boolean;
+    /** Accepted, but not read anywhere in the v1.13 bundle. */
+    debugPixelRatio?: unknown;
+    /** 3D: opacity (as LaTeX) given to new translucent surfaces. @defaultValue `'0.8'` */
+    translucentOpacity?: Latex;
+    /** 3D: samples per pixel for depth peeling. @defaultValue chosen from the device pixel ratio */
+    peelUpsample?: number;
+    /** 3D: render surfaces by ray casting. @defaultValue `false` */
+    rayCast?: boolean;
+  }
+
+  /**
+   * Old options that still work: the calculator logs a deprecation warning
+   * and sets the replacement.
+   */
+  interface DeprecatedGraphingCalculatorOptions {
+    /** @deprecated Use `settingsMenu` and `expressionsTopbar`, which this sets. */
+    menus?: boolean;
+    /** @deprecated Use `pointsOfInterest`, which this sets. */
+    solutions?: boolean;
+    /** @deprecated Removed in API v1.0; ignored. */
+    singleVariableSolutions?: boolean;
+    /** @deprecated Use `actions`; `true` sets `actions: true`. */
+    clickableObjects?: boolean;
+    /** @deprecated Use `authorFeatures`, which this sets. */
+    administerSecretFolders?: boolean;
   }
 
   type AxisScale = 'linear' | 'logarithmic';
 
   /** Everything that can be passed to the `GraphingCalculator` constructor or `updateSettings()`. */
-  interface GraphingCalculatorOptions extends GraphingCalculatorConfig, GraphSettings {}
+  interface GraphingCalculatorOptions
+    extends GraphingCalculatorConfig,
+      GraphSettings,
+      UndocumentedGraphingCalculatorConfig,
+      InternalGraphingCalculatorOptions,
+      DeprecatedGraphingCalculatorOptions {}
 
   /** Options for `Desmos.Geometry`. Any graphing calculator option is accepted. */
   type GeometryOptions = GraphingCalculatorOptions;
@@ -586,37 +756,18 @@ declare namespace Desmos {
     | 'substitutions'
     | 'regressionTemplates'
     | 'intervalComprehensions'
-    | 'recursion';
+    | 'recursion'
+    | keyof InternalGraphingCalculatorOptions
+    | keyof DeprecatedGraphingCalculatorOptions;
 
-  /**
-   * Settings present on `calculator.settings` at runtime that the docs don't
-   * mention. They are read-only here because their behavior when set is not
-   * part of the public API.
-   *
-   * @remarks Undocumented: may change without notice.
-   */
-  interface UndocumentedGraphingSettings {
-    /** Whether Complex Mode is currently on. */
-    readonly complex: boolean;
-    readonly functionDefinition: boolean;
-    readonly restrictGridToFirstQuadrant: boolean;
-    readonly userLockedViewport: boolean;
-    readonly authorMode: boolean;
-    readonly advancedStyling: boolean;
-    readonly leftAlign3dViewportControls: boolean;
-    readonly translucentSurfaces: boolean;
-    readonly showKeyboardShortcutsInTooltips: boolean;
-    readonly showPerformanceMeter: boolean;
-  }
-
-  /** The current value of every documented option and graph setting. */
+  /** The current value of every option and graph setting that appears on `calculator.settings`. */
   type GraphingCalculatorSettingsValues = {
     readonly [K in Exclude<keyof GraphingCalculatorOptions, WriteOnlyGraphingOption | 'graphDescription'>]-?: NonNullable<
       GraphingCalculatorOptions[K]
     >;
   } & {
     readonly graphDescription: string | undefined;
-  } & UndocumentedGraphingSettings;
+  };
 
   /**
    * `calculator.settings`: the current settings, observable per property.
@@ -1893,7 +2044,7 @@ declare namespace Desmos {
     /** Set global MathQuill configuration. */
     config(config: MathQuillConfig): void;
     /** The MathQuill API instance attached to `element`, if any. */
-    getApiInstanceForElement(element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+    getApiInstanceForElement(element: Element): MathQuillStaticMath | MathQuillMathField | null | undefined;
   }
 
   /** @remarks Undocumented: may change without notice. */
@@ -7149,6 +7300,55 @@ declare namespace Desmos.Internals {
     };
   }
 
+  // ---------------------------------------------------------------------------
+  // Grid layer
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Grid spacing in math units: the axis step settings if they fit, otherwise
+   * steps picked so the axis numbers don't overlap. A minor step of 0 means no
+   * minor lines; both are NaN on a logarithmic axis.
+   */
+  interface GridSteps {
+    majorStepX: number;
+    minorStepX: number;
+    majorStepY: number;
+    minorStepY: number;
+  }
+
+  /** Where a logarithmic axis draws its lines (a linear axis has empty lists). */
+  interface LogAxisGrid {
+    label: number[];
+    major: number[];
+    minor: number[];
+    /** Multiplies the minor line opacity; fades minor lines as decades shrink. */
+    unitOpacity: number;
+  }
+
+  interface LogGrid {
+    x: LogAxisGrid;
+    y: LogAxisGrid;
+  }
+
+  /**
+   * `grapher2d.gridLayer` (also `privateGetGridLayer()`): draws the grid,
+   * axes and axis numbers, under every graph.
+   *
+   * Lines are drawn 1px wide at `Math.round(px - 0.5) + 0.5`, in the text
+   * color: minor lines at `minorAxisOpacity`, then major lines over them at
+   * an opacity that composites to `majorAxisOpacity`. Lines on the edges of
+   * the screen, and at 0 when that axis is shown, are skipped.
+   */
+  interface GridLayer extends Generated.Grapher2DGridLayer {
+    /**
+     * Draw the whole layer. The main redraw passes `grapher2d.scaleAxis`
+     * (the axis being dragged, highlighted); screenshots pass only `context`.
+     */
+    redrawToCtx(context: DrawContext, scaleAxis?: 'x' | 'y' | 'both'): void;
+    drawCartesianGrid(ctx: CanvasRenderingContext2D, projection: Projection, steps: GridSteps, logGrid?: LogGrid): void;
+    drawPolarGrid(ctx: CanvasRenderingContext2D, projection: Projection, steps: { majorStepR: number; minorStepR: number }): void;
+  }
+
   /**
    * Options accepted by the grapher's own screenshot methods. The public
    * `asyncScreenshot` handles `mode` and `mathBounds` itself and passes the
@@ -7262,6 +7462,9 @@ declare namespace Desmos.Internals {
     settings: GrapherSettings;
     events: GrapherEvents;
     viewportController: ViewportController;
+    /** Draws the grid, axes and axis numbers. */
+    gridLayer: GridLayer;
+    privateGetGridLayer(): GridLayer;
     __projection: Projection;
     /** The viewport at the last animation frame (unset before the first one); used to detect viewport changes. */
     lastTickViewport?: Viewport;
@@ -7603,7 +7806,63 @@ declare namespace Desmos.Internals {
     controller: Controller;
   }
 
-  interface Grapher3D extends Generated.Grapher3D {}
+  /** A point in 3D math coordinates. */
+  interface Point3D {
+    x: number;
+    y: number;
+    z: number;
+  }
+
+  /** What the 3D grapher's worker found under the mouse. */
+  interface PickResult3D {
+    /** Where the ray from the mouse hit, in math coordinates. */
+    point: Point3D;
+  }
+
+  /** `grapher3d.controls`: mouse, touch and keyboard handling for the 3D graph paper. */
+  interface Grapher3DControls {
+    grapher3d: Grapher3D;
+    /** The graph paper element (`grapher3d.elt`). Desmos's wheel handler is attached here. */
+    domElement: HTMLElement;
+    /** -1 when idle, 0 while rotating with the mouse. */
+    state: -1 | 0;
+    /** Rotation speed while the graph is spinning, 0 when it isn't. */
+    speed3D: number;
+    /**
+     * `performance.now()` of the last wheel zoom, or 0. The tick calls
+     * `grapher3d.endZoom()` and resets it 100ms after the last one.
+     */
+    lastWheelEventTime: number;
+    /** Whether zoom and pan are disabled. */
+    isLocked(): boolean;
+    /** Whether rotating is disabled (the user lock, or the page is pinch zoomed). */
+    isRotationLocked(): boolean;
+    /** Set the viewport and commit it to history after a short delay. */
+    updateViewport(viewport: ViewportObject): void;
+  }
+
+  /** `grapher3d.viewportController`. */
+  interface Grapher3DViewportController {
+    getViewport(): Viewport;
+    /**
+     * Jump to a viewport. Invalid axes keep their current bounds, and each
+     * axis is clamped to a width between 1.34e-4 × its largest bound (at
+     * least 1.34e-4) and 134000, within ±67000.
+     */
+    setCurrentViewport(viewport: ViewportObject): void;
+  }
+
+  interface Grapher3D extends Generated.Grapher3D {
+    controls: Grapher3DControls;
+    viewportController: Grapher3DViewportController;
+    /** The 3D viewport always has z bounds (Desmos fills in defaults). */
+    getProjection(): { viewport: Viewport & { zmin: number; zmax: number } };
+    /**
+     * What's under the mouse, used as the center when zooming in with the
+     * scroll wheel. Undefined while the graph is spinning, or over nothing.
+     */
+    getZoomScrollWheelPickResult(): PickResult3D | null | undefined;
+  }
 
   interface Evaluator extends Generated.Evaluator {}
 
@@ -8014,6 +8273,17 @@ declare namespace Desmos.Internals {
 
   type FragileViewClass<P, Members> = DCGView.ViewClass<P, FragileView<P, Members>>;
 
+  /** Static helpers on `Fragile.MathquillView`. */
+  interface MathquillViewStatics {
+    /** The math field containing `document.activeElement`, if it's in one. */
+    getFocusedMathquill(): Desmos.MathQuillMathField | undefined;
+    /**
+     * Apply an arrow key to a math field. Returns true if the cursor was
+     * already at that edge (so focus should move to the next item).
+     */
+    applyArrowKeyAndReturnIfWasAtBounds(mathField: Desmos.MathQuillMathField, key: string, event: KeyboardEvent): boolean;
+  }
+
   /** The view classes on `Private.Fragile`. */
   interface FragileViews {
     ExpressionView: FragileViewClass<ExpressionViewProps, Generated.ExpressionViewMembers>;
@@ -8022,7 +8292,7 @@ declare namespace Desmos.Internals {
     ExpressionOptionsMenuView: FragileViewClass<ExpressionOptionsMenuViewProps, Generated.ExpressionOptionsMenuViewMembers>;
     ImageIconView: FragileViewClass<ImageIconViewProps, Generated.ImageIconViewMembers>;
     PromptSliderView: FragileViewClass<PromptSliderViewProps, Generated.PromptSliderViewMembers>;
-    MathquillView: FragileViewClass<MathquillViewProps, Generated.MathquillViewMembers>;
+    MathquillView: FragileViewClass<MathquillViewProps, Generated.MathquillViewMembers> & MathquillViewStatics;
     InlineMathInputView: FragileViewClass<InlineMathInputViewProps, Generated.InlineMathInputViewMembers>;
     StaticMathquillView: FragileViewClass<StaticMathquillViewProps, Generated.StaticMathquillViewMembers>;
     Checkbox: FragileViewClass<CheckboxProps, Generated.CheckboxMembers>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spidunno/desmos-types",
-  "version": "1.13.6",
+  "version": "1.13.8",
   "description": "TypeScript type definitions for the Desmos API v1.13",
   "types": "index.d.ts",
   "publishConfig": {

package/types/mathquill.d.ts

@@ -52,7 +52,7 @@ declare namespace Desmos {
     /** Set global MathQuill configuration. */
     config(config: MathQuillConfig): void;
     /** The MathQuill API instance attached to `element`, if any. */
-    getApiInstanceForElement(element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+    getApiInstanceForElement(element: Element): MathQuillStaticMath | MathQuillMathField | null | undefined;
   }
 
   /** @remarks Undocumented: may change without notice. */