@spidunno/desmos-types 1.13.3 → 1.13.5

package/module/index.d.ts

@@ -0,0 +1,1947 @@
+// AUTO-GENERATED by scripts/build-module-types.cjs from index.d.ts. Do not edit by hand.
+// The public Desmos API v1.13 types, as a module.
+//
+// Unlike the default entry points, this declares no globals: `Desmos` exists
+// only where you import it. Use it when the API object is not `window.Desmos`,
+// for example when you load calculator.js into a scope of your own.
+
+/// <reference lib="dom" />
+
+// ---- types/common.d.ts ----
+
+/**
+ * Shared primitive types and the observable-property mechanism used throughout
+ * the Desmos API.
+ */
+declare namespace Desmos {
+  /**
+   * A LaTeX string in Desmos syntax, e.g. `'y=x^2'` or `'\\sin(x)'`.
+   *
+   * Remember that backslashes must be escaped in ordinary JS strings
+   * (`'\\pi'`), or use `String.raw` (`` String.raw`\pi` ``).
+   */
+  type Latex = string;
+
+  /** A CSS hex color such as `'#c74440'`. */
+  type HexColor = string;
+
+  /** A value that may be given either as a number or as LaTeX that evaluates to a number. */
+  type NumberOrLatex = number | Latex;
+
+  /**
+   * Identifier of an item in the expressions list. Should be a valid JS
+   * property name (letters, numbers and `_`).
+   */
+  type ExpressionId = string;
+
+  /**
+   * Language codes documented for v1.13. Translations must be requested when
+   * loading `calculator.js` (via the `lang` URL parameter) before they can be used;
+   * check {@link Desmos.supportedLanguages} at runtime.
+   */
+  type LanguageCode =
+    | 'de'
+    | 'en'
+    | 'es'
+    | 'et'
+    | 'fr'
+    | 'id'
+    | 'it'
+    | 'ja'
+    | 'ko'
+    | 'nl'
+    | 'pl'
+    | 'pt-BR'
+    | 'ru'
+    | 'sv-SE'
+    | 'th'
+    | 'tr'
+    | 'vi'
+    | 'zh-CN'
+    | 'zh-TW'
+    // Allow codes added in future patch releases while keeping autocompletion.
+    | (string & {});
+
+  /** Braille code used for input and output on refreshable Braille displays. */
+  type BrailleMode = 'nemeth' | 'ueb' | 'none';
+
+  // ---------------------------------------------------------------------------
+  // Observables
+  // ---------------------------------------------------------------------------
+
+  /**
+   * A property name accepted by `observe`/`unobserve`, optionally namespaced
+   * (`'xAxisLabel.myObserver'`) so individual observers can be removed.
+   */
+  type ObservableProperty<Props> =
+    | Extract<keyof Props, string>
+    | `${Extract<keyof Props, string>}.${string}`;
+
+  /**
+   * Called when an observed property changes. Receives the (un-namespaced)
+   * property name and the object that owns the property.
+   */
+  type ObserverCallback<Owner, Props> = (
+    propertyName: Extract<keyof Props, string>,
+    owner: Owner
+  ) => void;
+
+  /**
+   * An object whose properties can be observed for changes. See
+   * "Managing Observers" in the Desmos docs.
+   *
+   * @typeParam Props - the observable properties and their value types.
+   */
+  interface Observable<Props> {
+    /**
+     * Register `callback` to run whenever `property` changes. Several
+     * observers may be added to one property. Namespace the property
+     * (`'prop.name'`) to be able to remove a single observer later.
+     */
+    observe(property: ObservableProperty<Props>, callback: ObserverCallback<this, Props>): void;
+
+    /**
+     * Remove observers. `'prop'` removes every observer of `prop`;
+     * `'prop.name'` removes only the observer registered with that namespace.
+     */
+    unobserve(property: ObservableProperty<Props>): void;
+  }
+
+  /**
+   * An event name accepted by `observeEvent`/`unobserveEvent`, optionally
+   * namespaced (`'change.autosave'`).
+   */
+  type EventName<Name extends string> = Name | `${Name}.${string}`;
+}
+// ---- types/enums.d.ts ----
+
+/**
+ * Enum-like constant objects exposed on the `Desmos` global, together with
+ * the union types of their values.
+ */
+declare namespace Desmos {
+  // ---------------------------------------------------------------------------
+  // Colors
+  // ---------------------------------------------------------------------------
+
+  /** The default color palette. */
+  const Colors: {
+    /** `#c74440` */
+    readonly RED: HexColor;
+    /** `#2d70b3` */
+    readonly BLUE: HexColor;
+    /**
+     * `#348543` in the v1.13 bundle. (The documentation lists `#388c46`,
+     * which is still the color the calculator cycles through for new items.)
+     */
+    readonly GREEN: HexColor;
+    /** `#fa7e19` */
+    readonly ORANGE: HexColor;
+    /** `#6042a6` */
+    readonly PURPLE: HexColor;
+    /** `#000000` */
+    readonly BLACK: HexColor;
+  };
+
+  /**
+   * A color palette: names mapped to valid CSS colors. Used by the `colors`
+   * constructor option and exposed as `calculator.colors`.
+   */
+  type ColorPalette = Readonly<Record<string, string>>;
+
+  // ---------------------------------------------------------------------------
+  // Styles
+  // ---------------------------------------------------------------------------
+
+  /** Drawing styles for points and curves. */
+  const Styles: {
+    // Curves
+    readonly SOLID: 'SOLID';
+    readonly DASHED: 'DASHED';
+    readonly DOTTED: 'DOTTED';
+    // Points
+    readonly POINT: 'POINT';
+    readonly OPEN: 'OPEN';
+    readonly CROSS: 'CROSS';
+    readonly SQUARE: 'SQUARE';
+    readonly PLUS: 'PLUS';
+    readonly TRIANGLE: 'TRIANGLE';
+    readonly DIAMOND: 'DIAMOND';
+    readonly STAR: 'STAR';
+  };
+
+  /** A line style for curves and point-list segments. */
+  type LineStyle = 'SOLID' | 'DASHED' | 'DOTTED';
+
+  /** A point style for points and point lists. */
+  type PointStyle = 'POINT' | 'OPEN' | 'CROSS' | 'SQUARE' | 'PLUS' | 'TRIANGLE' | 'DIAMOND' | 'STAR';
+
+  // ---------------------------------------------------------------------------
+  // Column modes (deprecated)
+  // ---------------------------------------------------------------------------
+
+  /**
+   * @deprecated Since API v1.1, use the boolean `points` and `lines`
+   * properties of a table column instead.
+   */
+  const ColumnModes: {
+    readonly POINTS: 'POINTS';
+    readonly LINES: 'LINES';
+    readonly POINTS_AND_LINES: 'POINTS_AND_LINES';
+  };
+
+  /** @deprecated Use the `points` and `lines` table column properties instead. */
+  type ColumnMode = 'POINTS' | 'LINES' | 'POINTS_AND_LINES';
+
+  // ---------------------------------------------------------------------------
+  // Drag modes
+  // ---------------------------------------------------------------------------
+
+  /** Directions in which a point (or table column's points) can be dragged. */
+  const DragModes: {
+    readonly NONE: 'NONE';
+    readonly X: 'X';
+    readonly Y: 'Y';
+    readonly XY: 'XY';
+    /** Use the calculator's normal rules for deciding how a point can move. */
+    readonly AUTO: 'AUTO';
+  };
+
+  type DragMode = 'NONE' | 'X' | 'Y' | 'XY' | 'AUTO';
+
+  // ---------------------------------------------------------------------------
+  // Axis arrow modes
+  // ---------------------------------------------------------------------------
+
+  /** Whether arrows are drawn at one or both ends of an axis. */
+  const AxisArrowModes: {
+    readonly NONE: 'NONE';
+    readonly POSITIVE: 'POSITIVE';
+    readonly BOTH: 'BOTH';
+  };
+
+  type AxisArrowMode = 'NONE' | 'POSITIVE' | 'BOTH';
+
+  // ---------------------------------------------------------------------------
+  // Font sizes
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Predefined values for the `fontSize` option. Any number is accepted;
+   * these are conveniences.
+   */
+  const FontSizes: {
+    readonly VERY_SMALL: 9;
+    readonly SMALL: 12;
+    readonly MEDIUM: 16;
+    readonly LARGE: 20;
+    readonly VERY_LARGE: 24;
+  };
+
+  // ---------------------------------------------------------------------------
+  // Label sizes
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Predefined LaTeX values for the `labelSize` expression property.
+   *
+   * @remarks Undocumented: present in the v1.13 bundle but not in the docs.
+   */
+  const LabelSizes: {
+    readonly SMALL: '0.85';
+    readonly MEDIUM: '1';
+    readonly LARGE: '1.35';
+  };
+
+  // ---------------------------------------------------------------------------
+  // Label orientations
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Positions of a point's label relative to the point. The docs list
+   * `ABOVE`, `BELOW`, `LEFT`, `RIGHT` and `DEFAULT`; the remaining values
+   * exist in the v1.13 bundle but are undocumented.
+   */
+  const LabelOrientations: {
+    /** Let the calculator position the label to keep it legible. */
+    readonly DEFAULT: 'default';
+    readonly ABOVE: 'above';
+    readonly BELOW: 'below';
+    readonly LEFT: 'left';
+    readonly RIGHT: 'right';
+    /** @remarks Undocumented. */
+    readonly CENTER: 'center';
+    /** @remarks Undocumented. */
+    readonly CENTER_AUTO: 'center_auto';
+    /** @remarks Undocumented. */
+    readonly AUTO_CENTER: 'auto_center';
+    /** @remarks Undocumented. */
+    readonly ABOVE_LEFT: 'above_left';
+    /** @remarks Undocumented. */
+    readonly ABOVE_RIGHT: 'above_right';
+    /** @remarks Undocumented. */
+    readonly ABOVE_AUTO: 'above_auto';
+    /** @remarks Undocumented. */
+    readonly BELOW_LEFT: 'below_left';
+    /** @remarks Undocumented. */
+    readonly BELOW_RIGHT: 'below_right';
+    /** @remarks Undocumented. */
+    readonly BELOW_AUTO: 'below_auto';
+    /** @remarks Undocumented. */
+    readonly AUTO_LEFT: 'auto_left';
+    /** @remarks Undocumented. */
+    readonly AUTO_RIGHT: 'auto_right';
+  };
+
+  type LabelOrientation = (typeof LabelOrientations)[keyof typeof LabelOrientations];
+}
+// ---- types/options/graphing.d.ts ----
+
+/**
+ * Constructor options and settings for the graphing calculator. The geometry
+ * tool and the 3D calculator accept the same options.
+ */
+declare namespace Desmos {
+  /**
+   * Custom handling for user-uploaded images. Store `file` somewhere with a
+   * public URL, then call `done(null, url)`, or `done(error)` on failure.
+   */
+  type ImageUploadCallback = (file: File, done: ImageUploadDone) => void;
+
+  /** The completion callback passed to an {@link ImageUploadCallback}. */
+  interface ImageUploadDone {
+    (error: null | undefined, url: string): void;
+    /** Any truthy value signals an error (the docs' example passes `true`). */
+    (error: unknown): void;
+  }
+
+  /**
+   * Configuration options. These belong to the calculator instance: they are
+   * not serialized in graph states and survive `setState()` / `setBlank()`.
+   */
+  interface GraphingCalculatorConfig {
+    /** Show the graphpaper. @defaultValue `true` */
+    graphpaper?: boolean;
+    /** Show the expressions list. @defaultValue `true` */
+    expressions?: boolean;
+    /** Show the settings wrench for changing graph display. @defaultValue `true` */
+    settingsMenu?: boolean;
+    /** Show onscreen zoom buttons. @defaultValue `true` */
+    zoomButtons?: boolean;
+    /** Show the onscreen keypad. @defaultValue `true` */
+    keypad?: boolean;
+    /**
+     * When `true`, the onscreen keypad opens whenever focus is in a math input.
+     * Ignored on touch devices, where the keypad is always activated.
+     * @defaultValue `false`
+     */
+    keypadActivated?: boolean;
+    /** If a default state is set, show an onscreen reset button. @defaultValue `false` */
+    showResetButtonOnGraphpaper?: boolean;
+    /** Show the bar on top of the expressions list. @defaultValue `true` */
+    expressionsTopbar?: boolean;
+    /** Show Points of Interest as clickable gray dots. @defaultValue `true` */
+    pointsOfInterest?: boolean;
+    /** Allow tracing curves and showing point coordinates on click. @defaultValue `true` */
+    trace?: boolean;
+    /** Add a subtle 1px gray border around the calculator. @defaultValue `true` */
+    border?: boolean;
+    /** Disable user panning and zooming of the graphpaper. @defaultValue `false` */
+    lockViewport?: boolean;
+    /** Collapse the expressions list. @defaultValue `false` */
+    expressionsCollapsed?: boolean;
+    /** Limit expressions to 500 LaTeX tokens and a nesting depth of 30. @defaultValue `false` */
+    capExpressionSize?: boolean;
+    /** Enable content-authoring features (secret folders, readonly expressions, ...). @defaultValue `false` */
+    authorFeatures?: boolean;
+    /** Allow adding images. @defaultValue `true` */
+    images?: boolean;
+    /** Custom processing for user-uploaded images. @defaultValue {@link Desmos.imageFileToDataURL} */
+    imageUploadCallback?: ImageUploadCallback;
+    /** Allow folders in the expressions list. @defaultValue `true` */
+    folders?: boolean;
+    /** Allow text notes in the expressions list. @defaultValue `true` */
+    notes?: boolean;
+    /** Allow sliders in the expressions list. @defaultValue `true` */
+    sliders?: boolean;
+    /**
+     * Allow Actions. With `'auto'`, actions are enabled but some UI only
+     * appears after the user enters a valid action.
+     * @defaultValue `'auto'`
+     */
+    actions?: boolean | 'auto';
+    /**
+     * Allow "with" substitutions and list comprehensions. Accepted as an option
+     * but not reflected on `calculator.settings`.
+     * @defaultValue `true`
+     */
+    substitutions?: boolean;
+    /** Allow hyperlinks in notes/folders and links to help documentation. @defaultValue `true` */
+    links?: boolean;
+    /** Show the keypad in QWERTY layout (`false` is alphabetical). @defaultValue `true` */
+    qwertyKeyboard?: boolean;
+    /** Enable distributions, univariate data visualizations and hypothesis tests. @defaultValue `true` */
+    distributions?: boolean;
+    /** Show a restricted menu of available functions. @defaultValue `false` */
+    restrictedFunctions?: boolean;
+    /** Keep `distance` and `midpoint` enabled even when `restrictedFunctions` is `true`. @defaultValue `false` */
+    forceEnableGeometryFunctions?: boolean;
+    /** When `false`, derivatives and integrals are disabled. @defaultValue `true` */
+    calculus?: boolean;
+    /** Import a graph when the user pastes a valid Desmos graph URL. @defaultValue `false` */
+    pasteGraphLink?: boolean;
+    /**
+     * Pause animations behind an opt-in cover when the user prefers reduced motion.
+     * @defaultValue `false`
+     */
+    showReducedMotionCover?: boolean;
+    /** Create a table (up to 50 rows) from pasted table data. @defaultValue `true` */
+    pasteTableData?: boolean;
+    /**
+     * When `true`, clearing the graph leaves the calculator in degree mode.
+     * @defaultValue matches `degreeMode` at instantiation
+     */
+    clearIntoDegreeMode?: boolean;
+    /** The color palette the calculator cycles through. @defaultValue {@link Desmos.Colors} */
+    colors?: ColorPalette;
+    /**
+     * Resize automatically when the container element's dimensions change.
+     * When `false`, call `.resize()` yourself.
+     * @defaultValue `true`
+     */
+    autosize?: boolean;
+    /** Plot inequalities. @defaultValue `true` */
+    plotInequalities?: boolean;
+    /** Plot implicit equations and inequalities. @defaultValue `true` */
+    plotImplicits?: boolean;
+    /** Plot single-variable implicit equations. @defaultValue `true` */
+    plotSingleVariableImplicitEquations?: boolean;
+    /** Increase font sizes and line thicknesses for legibility. @defaultValue `false` */
+    projectorMode?: boolean;
+    /** Let users toggle between decimal and fraction output. @defaultValue `true` */
+    decimalToFraction?: boolean;
+    /** Base font size in pixels. See {@link Desmos.FontSizes}. @defaultValue `16` */
+    fontSize?: number;
+    /**
+     * How touch and scroll gestures over the graphpaper are handled.
+     * `'cooperative'` requires a modifier or two fingers to pan/zoom.
+     * @defaultValue `'greedy'`
+     */
+    gestureHandling?: 'greedy' | 'cooperative';
+    /** Invert every displayed color. No longer recommended. @defaultValue `false` */
+    invertedColors?: boolean;
+    /** When `false`, hide the "Reverse Contrast" checkbox. @defaultValue `true` */
+    invertedColorsControl?: boolean;
+    /** **Beta.** Background color as a 3- or 6-digit hex string. @defaultValue `'#fff'` */
+    backgroundColor?: HexColor;
+    /** **Beta.** Text color as a 3- or 6-digit hex string. @defaultValue `'#000'` */
+    textColor?: HexColor;
+    /** **Beta.** Accent color for interactive UI elements. @defaultValue `'#2f72dc'` */
+    accentColor?: HexColor;
+    /** Display language. @defaultValue `'en'` */
+    language?: LanguageCode;
+    /** Braille code for input and output. @defaultValue `'none'` */
+    brailleMode?: BrailleMode;
+    /** Allow six-key Braille input on the home row. Requires a Braille mode. @defaultValue `false` */
+    sixKeyInput?: boolean;
+    /** Show Braille controls in the settings menu and enable Braille shortcut keys. @defaultValue `true` */
+    brailleControls?: boolean;
+    /** Allow the calculator to produce sound (tones, Audio Trace). @defaultValue `true` */
+    audio?: boolean;
+    /**
+     * Replace the generated description of the graph canvas. `''` removes it;
+     * `undefined` restores the generated text.
+     * @defaultValue `undefined`
+     */
+    graphDescription?: string | undefined;
+    /** Show a "zoom to fit" icon on tables and distributions. @defaultValue `true` */
+    zoomFit?: boolean;
+    /** Force log mode on linearizable regressions and hide its checkbox. @defaultValue `false` */
+    forceLogModeRegressions?: boolean;
+    /** Enable log mode on linearizable regressions by default. @defaultValue `false` */
+    defaultLogModeRegressions?: boolean;
+    /** Allow arbitrary regression models. @defaultValue `true` */
+    customRegressions?: boolean;
+    /**
+     * Allow regressions from a menu of models in the table column interface.
+     * Accepted as an option but not reflected on `calculator.settings`.
+     * @defaultValue `true`
+     */
+    regressionTemplates?: boolean;
+    /** Allow logarithmic axis scales. @defaultValue `true` */
+    logScales?: boolean;
+    /** Enable the `tone` command. @defaultValue `true` */
+    tone?: boolean;
+    /**
+     * Enable interval comprehension syntax. Accepted as an option but not
+     * reflected on `calculator.settings`.
+     * @defaultValue `true`
+     */
+    intervalComprehensions?: boolean;
+    /**
+     * Globally mute sound from `tone()`. Browsers block audio before user
+     * interaction, so unmute only in response to a user action.
+     * @defaultValue `true`
+     */
+    muted?: boolean;
+    /** Enable the "Complex Mode" toggle in the settings menu. @defaultValue `true` */
+    allowComplex?: boolean;
+    /** Allow matrices and matrix functions. @defaultValue `true` */
+    matrices?: boolean;
+    /**
+     * How object positions are reported to screen readers. `'default'` uses
+     * coordinates when an axis is visible, percentages otherwise.
+     * @defaultValue `'default'`
+     */
+    reportPosition?: 'coordinates' | 'percents' | 'default';
+    /** Show a button that copies an evaluation's LaTeX. @defaultValue `false` */
+    showEvaluationCopyButtons?: boolean;
+    /**
+     * Called with the evaluation LaTeX when a copy button is clicked.
+     * @defaultValue copy to the system clipboard
+     */
+    onEvaluationCopyClick?: (latex: Latex) => void;
+    /**
+     * Allow recursive functions. Accepted as an option but not reflected on
+     * `calculator.settings`.
+     * @defaultValue `true`
+     */
+    recursion?: boolean;
+  }
+
+  /**
+   * Graph settings. Unlike configuration options, these belong to the graph
+   * state: they are serialized by `getState()` and overwritten by
+   * `setState()` / `setBlank()`.
+   */
+  interface GraphSettings {
+    /** Trig functions take degrees instead of radians. @defaultValue `false` */
+    degreeMode?: boolean;
+    /** Show grid lines. @defaultValue `true` */
+    showGrid?: boolean;
+    /** Use a polar grid instead of a cartesian one. @defaultValue `false` */
+    polarMode?: boolean;
+    /** Show the x axis. @defaultValue `true` */
+    showXAxis?: boolean;
+    /** Show the y axis. @defaultValue `true` */
+    showYAxis?: boolean;
+    /** Show numeric tick labels on the x axis. @defaultValue `true` */
+    xAxisNumbers?: boolean;
+    /** Show numeric tick labels on the y axis. @defaultValue `true` */
+    yAxisNumbers?: boolean;
+    /** Show numeric tick labels at successive angles (polar mode only). @defaultValue `true` */
+    polarNumbers?: boolean;
+    /** Spacing between x-axis ticks. `0` chooses automatically. @defaultValue `0` */
+    xAxisStep?: number;
+    /** Spacing between y-axis ticks. `0` chooses automatically. @defaultValue `0` */
+    yAxisStep?: number;
+    /**
+     * Subdivisions between x-axis ticks, an integer from 0 to 5. `1` shows only
+     * major grid lines; `0` chooses automatically.
+     * @defaultValue `0`
+     */
+    xAxisMinorSubdivisions?: number;
+    /**
+     * Subdivisions between y-axis ticks, an integer from 0 to 5. `1` shows only
+     * major grid lines; `0` chooses automatically.
+     * @defaultValue `0`
+     */
+    yAxisMinorSubdivisions?: number;
+    /** Arrows on the x axis. @defaultValue `'NONE'` */
+    xAxisArrowMode?: AxisArrowMode;
+    /** Arrows on the y axis. @defaultValue `'NONE'` */
+    yAxisArrowMode?: AxisArrowMode;
+    /** Label placed below the x axis. @defaultValue `''` */
+    xAxisLabel?: string;
+    /** Label placed beside the y axis. @defaultValue `''` */
+    yAxisLabel?: string;
+    /** Scale of the x axis. @defaultValue `'linear'` */
+    xAxisScale?: AxisScale;
+    /** Scale of the y axis. @defaultValue `'linear'` */
+    yAxisScale?: AxisScale;
+    /**
+     * Global seed for the built-in `random()` function. Changing it
+     * re-randomizes every expression that uses `random()`.
+     * @defaultValue a random 128-bit hex string
+     */
+    randomSeed?: string;
+  }
+
+  type AxisScale = 'linear' | 'logarithmic';
+
+  /** Everything that can be passed to the `GraphingCalculator` constructor or `updateSettings()`. */
+  interface GraphingCalculatorOptions extends GraphingCalculatorConfig, GraphSettings {}
+
+  /** Options for `Desmos.Geometry`. Any graphing calculator option is accepted. */
+  type GeometryOptions = GraphingCalculatorOptions;
+
+  /** Options for `Desmos.Calculator3D`. Any graphing calculator option is accepted. */
+  type Calculator3DOptions = GraphingCalculatorOptions;
+
+  /** Options that are accepted but never appear on `calculator.settings`. */
+  type WriteOnlyGraphingOption =
+    | '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;
+  }
+
+  /** The current value of every documented option and graph setting. */
+  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.
+   * Change them with `calculator.updateSettings()`.
+   *
+   * @example
+   * calculator.settings.observe('xAxisLabel', () => {
+   *   console.log(calculator.settings.xAxisLabel);
+   * });
+   */
+  type GraphingCalculatorSettings = GraphingCalculatorSettingsValues & Observable<GraphingCalculatorSettingsValues>;
+}
+// ---- types/options/basic.d.ts ----
+
+/**
+ * Constructor options and settings for the four-function and scientific
+ * calculators.
+ */
+declare namespace Desmos {
+  /** Options shared by the four-function and scientific calculators. */
+  interface BasicCalculatorOptions {
+    /** Allow external hyperlinks (e.g. to Braille examples). @defaultValue `true` */
+    links?: boolean;
+    /** Base font size in pixels. @defaultValue `16` */
+    fontSize?: number;
+    /** Display an inverted color scheme. @defaultValue `false` */
+    invertedColors?: boolean;
+    /** When `false`, hide the "Reverse Contrast" checkbox. @defaultValue `true` */
+    invertedColorsControl?: boolean;
+    /** **Beta.** Background color as a 3- or 6-digit hex string. @defaultValue `'#fff'` */
+    backgroundColor?: HexColor;
+    /** **Beta.** Text color as a 3- or 6-digit hex string. @defaultValue `'#000'` */
+    textColor?: HexColor;
+    /** **Beta.** Accent color for interactive UI elements. @defaultValue `'#2f72dc'` */
+    accentColor?: HexColor;
+    /** Display the settings menu. @defaultValue `true` */
+    settingsMenu?: boolean;
+    /** Display language. @defaultValue `'en'` */
+    language?: LanguageCode;
+    /** Braille code for input and output. @defaultValue `'none'` */
+    brailleMode?: BrailleMode;
+    /** Allow six-key Braille input on the home row. Requires a Braille mode. @defaultValue `false` */
+    sixKeyInput?: boolean;
+    /** Let the user export a Braille rendering of the expression list. Requires a Braille mode. @defaultValue `true` */
+    brailleExpressionDownload?: boolean;
+    /** Display a larger font. @defaultValue `false` */
+    projectorMode?: boolean;
+    /**
+     * Let users toggle between decimal and fraction output.
+     * @defaultValue `false` (four-function), `true` (scientific)
+     */
+    decimalToFraction?: boolean;
+    /** Limit expressions to 500 LaTeX tokens and a nesting depth of 30. @defaultValue `false` */
+    capExpressionSize?: boolean;
+  }
+
+  /** An extra function button for the four-function calculator's top bar. */
+  type FourFunctionAdditionalFunction = 'exponent' | 'percent' | 'fraction' | 'sqrt';
+
+  interface FourFunctionCalculatorOptions extends BasicCalculatorOptions {
+    /**
+     * Extra function(s) shown in the top bar: at least 1, at most 2.
+     * @defaultValue `['sqrt']`
+     */
+    additionalFunctions?:
+      | FourFunctionAdditionalFunction
+      | readonly [FourFunctionAdditionalFunction]
+      | readonly [FourFunctionAdditionalFunction, FourFunctionAdditionalFunction];
+    /**
+     * Require numbers to be `0` or have magnitude in `[1e-7, 1e8)`; anything
+     * else is an error. Results never use scientific notation.
+     * @defaultValue `false`
+     */
+    limitNumberScale?: boolean;
+  }
+
+  interface ScientificCalculatorOptions extends BasicCalculatorOptions {
+    /** Show the keypad in QWERTY layout (`false` is alphabetical). @defaultValue `true` */
+    qwertyKeyboard?: boolean;
+    /** Trig functions take degrees instead of radians. @defaultValue `false` */
+    degreeMode?: boolean;
+    /** Allow function definitions such as `f(x) = 2x`. @defaultValue `true` */
+    functionDefinition?: boolean;
+    /**
+     * Resize automatically when the container element's dimensions change.
+     * When `false`, call `.resize()` yourself.
+     * @defaultValue `true`
+     */
+    autosize?: boolean;
+    /** Enable the "Complex Mode" toggle in the settings menu. @defaultValue `true` */
+    allowComplex?: boolean;
+  }
+
+  /**
+   * Option keys accepted by a basic calculator but not kept on its
+   * `settings` object at runtime.
+   */
+  type WriteOnlyBasicOption = 'additionalFunctions' | 'limitNumberScale' | 'autosize' | 'allowComplex';
+
+  /** The current value of each option of a basic calculator. */
+  type BasicCalculatorSettingsValues<TOptions extends BasicCalculatorOptions> = {
+    readonly [K in Exclude<keyof TOptions, WriteOnlyBasicOption>]-?: NonNullable<TOptions[K]>;
+  };
+
+  /**
+   * `calculator.settings` on a basic calculator: current settings, observable
+   * per property.
+   *
+   * @remarks Undocumented for basic calculators, but present at runtime.
+   */
+  type BasicCalculatorSettings<TOptions extends BasicCalculatorOptions> = BasicCalculatorSettingsValues<TOptions> &
+    Observable<BasicCalculatorSettingsValues<TOptions>>;
+}
+// ---- types/expressions.d.ts ----
+
+/**
+ * Expression-list items: what `setExpression()` accepts, what
+ * `getExpressions()` returns, and the per-expression analysis.
+ */
+declare namespace Desmos {
+  /** Bounds as LaTeX strings (numbers are coerced to strings). */
+  interface Domain {
+    min?: NumberOrLatex;
+    max?: NumberOrLatex;
+  }
+
+  /**
+   * Slider bounds. Bounds may use numbers and the constants `e`, `\pi` and
+   * `\tau`, but not variables. Omit `step` (or pass `''`) for a continuous slider.
+   */
+  interface SliderBounds extends Domain {
+    step?: NumberOrLatex;
+  }
+
+  // ---------------------------------------------------------------------------
+  // setExpression() input
+  // ---------------------------------------------------------------------------
+
+  /**
+   * A math expression. When `id` matches an existing expression, only the
+   * provided properties change; the rest are left as they were.
+   */
+  interface ExpressionState {
+    type?: 'expression';
+    id?: ExpressionId;
+    /** The expression, in Desmos LaTeX. */
+    latex?: Latex;
+    /** Defaults to cycling through the palette. */
+    color?: HexColor;
+    /** Line style for curves or point lists. */
+    lineStyle?: LineStyle;
+    /** Line width in pixels: a positive number or LaTeX evaluating to one. @defaultValue `2.5` */
+    lineWidth?: NumberOrLatex;
+    /** Line opacity from 0 to 1, or LaTeX evaluating to one. @defaultValue `0.9` */
+    lineOpacity?: NumberOrLatex;
+    /** Point style for points and point lists. */
+    pointStyle?: PointStyle;
+    /** Point diameter in pixels: a positive number or LaTeX evaluating to one. @defaultValue `9` */
+    pointSize?: NumberOrLatex;
+    /** Point opacity from 0 to 1, or LaTeX evaluating to one. @defaultValue `0.9` */
+    pointOpacity?: NumberOrLatex;
+    /** Draw a white outline around points to separate them from overlapping items. */
+    pointOutline?: boolean;
+    /** Fill opacity of a polygon or parametric curve, 0 to 1. @defaultValue `0.4` */
+    fillOpacity?: NumberOrLatex;
+    /** Plot points for point lists. */
+    points?: boolean;
+    /** Plot line segments for point lists. */
+    lines?: boolean;
+    /** Shade the interior of a polygon or parametric curve. */
+    fill?: boolean;
+    /** Don't draw the graph. @defaultValue `false` */
+    hidden?: boolean;
+    /** Hide the expression from the expressions list; doesn't affect the graph. @defaultValue `false` */
+    secret?: boolean;
+    /** Bounds of a slider. */
+    sliderBounds?: SliderBounds;
+    /** Animate the slider. @defaultValue `false` */
+    playing?: boolean;
+    /** Bounds of a parametric curve. */
+    parametricDomain?: Domain;
+    /** Bounds of a polar curve. */
+    polarDomain?: Domain;
+    /** How a point can be dragged. @defaultValue `'AUTO'` */
+    dragMode?: DragMode;
+    /** Text label of a point. `''` restores the default label (its coordinates). */
+    label?: string;
+    /** Show the point's label. */
+    showLabel?: boolean;
+    /**
+     * Label size as LaTeX, multiplying the standard label font size. See
+     * {@link Desmos.LabelSizes}.
+     * @defaultValue `'1'`
+     */
+    labelSize?: Latex;
+    /** Where the label sits relative to the point. @defaultValue `'default'` */
+    labelOrientation?: LabelOrientation;
+    /** Prevent the user from editing or deleting the expression (author feature). */
+    readonly?: boolean;
+  }
+
+  /** A column of a table. */
+  interface TableColumnState {
+    /** Column header: a variable, or an expression for computed columns. */
+    latex: Latex;
+    /** Cell values as LaTeX. Not needed for computed columns. */
+    values?: Latex[];
+    /** Ignored for the first column. */
+    color?: HexColor;
+    /** Ignored for the first column. @defaultValue `false` */
+    hidden?: boolean;
+    points?: boolean;
+    lines?: boolean;
+    lineStyle?: LineStyle;
+    /** @defaultValue `2.5` */
+    lineWidth?: NumberOrLatex;
+    /** @defaultValue `0.9` */
+    lineOpacity?: NumberOrLatex;
+    pointStyle?: PointStyle;
+    /** @defaultValue `9` */
+    pointSize?: NumberOrLatex;
+    /** @defaultValue `0.9` */
+    pointOpacity?: NumberOrLatex;
+    /** @deprecated Use `points` and `lines` instead. */
+    columnMode?: ColumnMode;
+    /** Only affects explicitly specified values, not computed ones. @defaultValue `'NONE'` */
+    dragMode?: DragMode;
+  }
+
+  interface TableState {
+    type: 'table';
+    id?: ExpressionId;
+    columns: TableColumnState[];
+  }
+
+  /** A text note. */
+  interface NoteState {
+    type: 'text';
+    id?: ExpressionId;
+    /** @defaultValue `''` */
+    text?: string;
+  }
+
+  /** Anything accepted by `setExpression()`. */
+  type SettableExpressionState = ExpressionState | TableState | NoteState;
+
+  // ---------------------------------------------------------------------------
+  // getExpressions() output
+  // ---------------------------------------------------------------------------
+
+  /** Bounds as returned by `getExpressions()`: `''` means "use the default". */
+  interface DomainItem {
+    min: Latex;
+    max: Latex;
+  }
+
+  /**
+   * An expression as returned by `getExpressions()`. Numeric styling values
+   * come back as LaTeX strings, with `''` meaning "use the default".
+   */
+  interface ExpressionItem {
+    type: 'expression';
+    id: ExpressionId;
+    latex: Latex;
+    color: HexColor;
+    lineStyle: LineStyle;
+    lineWidth: Latex;
+    lineOpacity: Latex;
+    pointStyle: PointStyle;
+    pointSize: Latex;
+    movablePointSize: Latex;
+    pointOpacity: Latex;
+    pointOutline?: boolean;
+    fillOpacity: Latex;
+    points?: boolean;
+    lines?: boolean;
+    fill?: boolean;
+    hidden: boolean;
+    secret: boolean;
+    dragMode: DragMode;
+    label: string;
+    showLabel: boolean;
+    labelSize: Latex;
+    labelOrientation: LabelOrientation;
+    interactiveLabel: boolean;
+    readonly: boolean;
+    /** Present only for sliders; omitted bounds were not set. */
+    sliderBounds?: { min?: Latex; max?: Latex; step?: Latex };
+    playing: boolean;
+    parametricDomain: DomainItem;
+    parametricDomain3Du: DomainItem;
+    parametricDomain3Dv: DomainItem;
+    parametricDomain3Dr: DomainItem;
+    parametricDomain3Dphi: DomainItem;
+    polarDomain: DomainItem;
+    domain: DomainItem;
+  }
+
+  interface TableColumnItem {
+    id: ExpressionId;
+    latex: Latex;
+    values: Latex[];
+    color: HexColor;
+    hidden: boolean;
+    points: boolean;
+    lines: boolean;
+    lineStyle: LineStyle;
+    lineWidth: Latex;
+    lineOpacity: Latex;
+    pointStyle: PointStyle;
+    pointOutline: boolean;
+    pointSize: Latex;
+    pointOpacity: Latex;
+    dragMode: DragMode;
+  }
+
+  interface TableItem {
+    type: 'table';
+    id: ExpressionId;
+    columns: TableColumnItem[];
+  }
+
+  interface NoteItem {
+    type: 'text';
+    id: ExpressionId;
+    text: string;
+    secret: boolean;
+  }
+
+  /**
+   * A folder. Cannot be created with `setExpression()`; folders come from
+   * the user or from `setState()`.
+   */
+  interface FolderItem {
+    type: 'folder';
+    id: ExpressionId;
+    title: string;
+    hidden: boolean;
+    secret: boolean;
+  }
+
+  /**
+   * An image. Only its identity and visibility are reported. Cannot be
+   * created with `setExpression()`.
+   */
+  interface ImageItem {
+    type: 'image';
+    id: ExpressionId;
+    hidden: boolean;
+    secret: boolean;
+  }
+
+  /** Any item returned by `getExpressions()`. */
+  type ExpressionListItem = ExpressionItem | TableItem | NoteItem | FolderItem | ImageItem;
+
+  // ---------------------------------------------------------------------------
+  // Analysis
+  // ---------------------------------------------------------------------------
+
+  type ExpressionEvaluation = { type: 'Number'; value: number } | { type: 'ListOfNumber'; value: number[] };
+
+  /**
+   * The calculator's analysis of one expression. Evaluation is asynchronous,
+   * so read this inside an `observe('expressionAnalysis', ...)` callback.
+   */
+  interface ExpressionAnalysis {
+    /** The expression can be plotted. */
+    isGraphable: boolean;
+    /** The expression produces an evaluation error. */
+    isError: boolean;
+    /** The localized error message, if any. */
+    errorMessage?: string;
+    /** Evaluation information is shown in the expressions list. */
+    evaluationDisplayed?: boolean;
+    /** Numeric value(s), when the expression evaluates to numbers. */
+    evaluation?: ExpressionEvaluation;
+  }
+}
+// ---- types/state.d.ts ----
+
+/**
+ * Serialized calculator states and the options for loading them.
+ */
+declare namespace Desmos {
+  /**
+   * A serialized graph, as returned by `getState()` on a graphing, geometry
+   * or 3D calculator. Safe to `JSON.stringify`.
+   *
+   * Treat states as opaque: modifying them by hand can produce a state that
+   * `setState()` cannot load.
+   */
+  interface GraphState {
+    /** State format version. */
+    readonly version: number;
+    readonly [key: string]: unknown;
+  }
+
+  /**
+   * A serialized four-function or scientific calculator state. Treat as opaque.
+   */
+  interface BasicCalculatorState {
+    readonly [key: string]: unknown;
+  }
+
+  interface SetBlankOptions {
+    /** Keep the undo/redo history. @defaultValue `false` */
+    allowUndo?: boolean;
+  }
+
+  interface SetStateOptions extends SetBlankOptions {
+    /**
+     * Replace colors in the state with the perceptually closest colors in
+     * the calculator's current palette (`calculator.colors`).
+     * @defaultValue `false`
+     */
+    remapColors?: boolean;
+  }
+
+  /**
+   * A snapshot of the current state plus its undo/redo history, for use with
+   * `restoreHistory()`. Not serializable.
+   *
+   * @remarks Undocumented: may change without notice.
+   */
+  interface CalculatorHistory {
+    readonly currentState: GraphState;
+  }
+}
+// ---- types/coordinates.d.ts ----
+
+/**
+ * Viewport bounds, coordinate conversion and screenshot options.
+ */
+declare namespace Desmos {
+  /** Viewport bounds in math coordinates. Requires `right > left` and `top > bottom`. */
+  interface MathBounds {
+    left: number;
+    right: number;
+    bottom: number;
+    top: number;
+  }
+
+  /**
+   * Viewport bounds using `xmin`/`xmax`/`ymin`/`ymax` names. Accepted by
+   * `setMathBounds()` in place of {@link MathBounds}.
+   *
+   * @remarks Undocumented alias.
+   */
+  interface ViewportBounds {
+    xmin: number;
+    xmax: number;
+    ymin: number;
+    ymax: number;
+  }
+
+  /** 3D viewport bounds; `setMathBounds()` on a `Calculator3D` also accepts `zmin`/`zmax`. */
+  interface ViewportBounds3D extends ViewportBounds {
+    zmin: number;
+    zmax: number;
+  }
+
+  /** A rectangle in math or pixel coordinates. */
+  interface Rect {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    width: number;
+    height: number;
+  }
+
+  /** Math coordinates of the graphpaper. Note `top > bottom`. */
+  interface MathCoordinates extends Rect {
+    xmin: number;
+    xmax: number;
+    ymin: number;
+    ymax: number;
+    /** Present on 3D calculators. */
+    zmin?: number;
+    /** Present on 3D calculators. */
+    zmax?: number;
+  }
+
+  /**
+   * The graphpaper bounds. Pixel coordinates are relative to the top left of
+   * the calculator's container element, so `pixelCoordinates.top <
+   * pixelCoordinates.bottom` while `mathCoordinates.top > mathCoordinates.bottom`.
+   */
+  interface GraphpaperBounds {
+    mathCoordinates: MathCoordinates;
+    pixelCoordinates: Rect;
+  }
+
+  /** A point with an `x` property, a `y` property, or both. */
+  type PartialPoint = { x: number; y?: number } | { x?: number; y: number };
+
+  /** The result of a coordinate conversion: the same properties as the input. */
+  type ConvertedPoint<T extends PartialPoint> = { [K in keyof T & ('x' | 'y')]: number };
+
+  // ---------------------------------------------------------------------------
+  // Screenshots
+  // ---------------------------------------------------------------------------
+
+  interface ScreenshotOptions {
+    /** Width in pixels. @defaultValue current graphpaper width */
+    width?: number;
+    /** Height in pixels. @defaultValue current graphpaper height */
+    height?: number;
+    /**
+     * Oversampling factor for high-density screens. With `2`, the image is
+     * physically twice `width` × `height` but meant to be displayed at
+     * `width` × `height`.
+     * @defaultValue `1`
+     */
+    targetPixelRatio?: number;
+    /**
+     * Keep axis numbers on small images (below 256px in either dimension),
+     * where they are normally removed.
+     * @defaultValue `false`
+     */
+    preserveAxisNumbers?: boolean;
+    /** Draw movable points with their interactive halo. @defaultValue `false` */
+    showMovablePoints?: boolean;
+  }
+
+  /**
+   * How `asyncScreenshot()` computes the captured viewport:
+   *
+   * - `contain`: smallest box containing `mathBounds` that keeps the math aspect ratio.
+   * - `stretch`: use `mathBounds` exactly; the aspect ratio is not kept.
+   * - `preserveX`: use `left`/`right`, adjust `y` about the midline to keep the aspect ratio.
+   * - `preserveY`: use `top`/`bottom`, adjust `x` about the midline to keep the aspect ratio.
+   */
+  type ScreenshotMode = 'contain' | 'stretch' | 'preserveX' | 'preserveY';
+
+  /**
+   * Desired screenshot bounds. Any omitted property uses the current viewport,
+   * but `top` requires `bottom` and `left` requires `right`.
+   */
+  type ScreenshotMathBounds = ({ top: number; bottom: number } | { top?: never; bottom?: never }) &
+    ({ left: number; right: number } | { left?: never; right?: never });
+
+  interface AsyncScreenshotOptions extends ScreenshotOptions {
+    /** Image format. @defaultValue `'png'` */
+    format?: 'png' | 'svg';
+    /**
+     * Viewport strategy. The docs give `'contain'` as the default, but the
+     * v1.13 bundle uses `'preserveX'` when the axes are square and `'stretch'`
+     * otherwise. Pass a mode explicitly if it matters.
+     */
+    mode?: ScreenshotMode;
+    /** Region to capture. Invalid bounds log a warning and use the current viewport. */
+    mathBounds?: ScreenshotMathBounds;
+    /** Include point labels. @defaultValue `false` */
+    showLabels?: boolean;
+  }
+
+  /**
+   * Receives a PNG data URI or an SVG string, or `undefined` if the
+   * screenshot failed.
+   */
+  type AsyncScreenshotCallback = (data: string | undefined) => void;
+}
+// ---- types/calculators/helper-expression.d.ts ----
+
+/**
+ * Helper expressions: evaluated like normal expressions but hidden from the
+ * expressions list.
+ */
+declare namespace Desmos {
+  interface HelperExpressionObservables {
+    /** The value, when the expression evaluates to a number. May be `NaN`. */
+    numericValue: number | undefined;
+    /** The values, when the expression evaluates to a list. */
+    listValue: number[] | undefined;
+  }
+
+  /** Created by `calculator.HelperExpression({ latex })`. */
+  interface HelperExpression
+    extends Observable<HelperExpressionObservables>,
+      Readonly<HelperExpressionObservables> {
+    /** The LaTeX being evaluated. */
+    readonly latex: Latex;
+  }
+}
+// ---- types/calculators/base.d.ts ----
+
+/**
+ * The API shared by the graphing calculator, the geometry tool and the 3D
+ * calculator. All three are built on the same underlying class.
+ */
+declare namespace Desmos {
+  /** Events emitted by graphing-family calculators, mapped to their payloads. */
+  interface GraphingCalculatorEventMap {
+    /**
+     * Any change that affects the persisted state, from the user or from API
+     * calls. Useful for autosaving without polling.
+     */
+    change: { isUserInitiated: boolean };
+    /** The user clicked "Delete All" or "Reset" in the expressions list top bar. */
+    graphReset: unknown;
+  }
+
+  type GraphingCalculatorEvent = Extract<keyof GraphingCalculatorEventMap, string>;
+
+  /**
+   * Called when an observed calculator event fires. Receives the
+   * un-namespaced event name (e.g. `'change'` even when observing
+   * `'change.autosave'`) and the event payload.
+   */
+  type GraphingCalculatorEventCallback<K extends GraphingCalculatorEvent> = (
+    eventName: K,
+    event: GraphingCalculatorEventMap[K]
+  ) => void;
+
+  /** Observable properties of a graphing-family calculator. */
+  interface GraphingCalculatorObservables {
+    /** Graphpaper bounds in math and pixel coordinates. Changes on pan and zoom. */
+    graphpaperBounds: GraphpaperBounds;
+    /** Analysis of each expression, keyed by expression id. */
+    expressionAnalysis: Readonly<Record<ExpressionId, ExpressionAnalysis>>;
+    /** `true` while an expression is selected. */
+    isAnyExpressionSelected: boolean;
+    /** Id of the selected expression, or `undefined` if none is selected. */
+    selectedExpressionId: ExpressionId | undefined;
+    /** `true` while audio trace mode is active. */
+    isAudioTraceActive: boolean;
+  }
+
+  /**
+   * Members shared by {@link GraphingCalculator}, {@link Geometry} and
+   * {@link Calculator3D}.
+   */
+  interface GraphingCalculatorBase
+    extends Observable<GraphingCalculatorObservables>,
+      Readonly<GraphingCalculatorObservables> {
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+
+    /**
+     * Destroy the instance, unbind listeners and free resources. Call this
+     * when the container element is removed from the DOM. Methods called
+     * afterwards do nothing and log a warning.
+     */
+    destroy(): void;
+
+    /**
+     * Resize the calculator to fill its container. Only needed when the
+     * `autosize` option is `false`: call it whenever the container's size
+     * changes or it is added to or removed from the DOM.
+     */
+    resize(): void;
+
+    // -------------------------------------------------------------------------
+    // Saving and loading
+    // -------------------------------------------------------------------------
+
+    /** The current state. Treat it as opaque; it can be serialized with `JSON.stringify`. */
+    getState(): GraphState;
+
+    /** Load a state previously returned by `getState()`. */
+    setState(state: GraphState, options?: SetStateOptions): void;
+
+    /** Reset to a blank state. */
+    setBlank(options?: SetBlankOptions): void;
+
+    /**
+     * Replace "Delete All" with a "Reset" button that restores `state`, and
+     * make the "home" zoom button return to that state's viewport.
+     */
+    setDefaultState(state: GraphState): void;
+
+    /** Return to the previous state in the undo/redo history, if any. */
+    undo(): void;
+
+    /** Advance to the next state in the undo/redo history, if any. */
+    redo(): void;
+
+    /** Clear the undo/redo history without changing the current state. */
+    clearHistory(): void;
+
+    /**
+     * Run `callback` so that its changes replace the current history entry
+     * instead of adding one. Keeps programmatic changes out of the user's undo stack.
+     */
+    withHistoryReplacement(callback: () => void): void;
+
+    /**
+     * The current state together with its undo/redo history.
+     * @remarks Undocumented: may change without notice.
+     */
+    getHistory(): CalculatorHistory;
+
+    /**
+     * Restore a value returned by `getHistory()`, including its undo/redo history.
+     * @remarks Undocumented: may change without notice.
+     */
+    restoreHistory(history: CalculatorHistory): void;
+
+    // -------------------------------------------------------------------------
+    // Screenshots
+    // -------------------------------------------------------------------------
+
+    /** A PNG data URI of the current graphpaper. */
+    screenshot(options?: ScreenshotOptions): string;
+
+    /**
+     * A 200×200 PNG data URI at `targetPixelRatio: 2`.
+     * @remarks Undocumented: may change without notice.
+     */
+    makeThumbnail(): string;
+
+    // -------------------------------------------------------------------------
+    // Events
+    // -------------------------------------------------------------------------
+
+    /**
+     * Listen for a calculator event. Namespace the name (`'change.autosave'`)
+     * to be able to remove this observer on its own.
+     *
+     * @example
+     * calculator.observeEvent('change', (eventName, event) => {
+     *   if (event.isUserInitiated) save(calculator.getState());
+     * });
+     */
+    observeEvent<K extends GraphingCalculatorEvent>(
+      event: EventName<K>,
+      callback: GraphingCalculatorEventCallback<K>
+    ): void;
+
+    /** Remove event observers; `'change'` removes all of them, `'change.ns'` just one. */
+    unobserveEvent(event: EventName<GraphingCalculatorEvent>): void;
+
+    // -------------------------------------------------------------------------
+    // Expressions
+    // -------------------------------------------------------------------------
+
+    /**
+     * Create an expression, or update the one with the same `id`. Only the
+     * given properties change. An expression's `type` can't be changed;
+     * remove it first. Invalid input is ignored.
+     */
+    setExpression(expression: SettableExpressionState): void;
+
+    /** Call `setExpression()` for each item. */
+    setExpressions(expressions: readonly SettableExpressionState[]): void;
+
+    /** Remove the expression with the given `id`. */
+    removeExpression(expression: { id: ExpressionId }): void;
+
+    /** Remove each expression with one of the given ids. */
+    removeExpressions(expressions: ReadonlyArray<{ id: ExpressionId }>): void;
+
+    /** The items in the expressions list. */
+    getExpressions(): ExpressionListItem[];
+
+    /**
+     * Create a helper expression: evaluated like a normal expression but not
+     * shown in the expressions list. Observe its `numericValue` or
+     * `listValue` to react to changes.
+     *
+     * @example
+     * const a = calculator.HelperExpression({ latex: 'a' });
+     * a.observe('numericValue', () => console.log(a.numericValue));
+     */
+    HelperExpression(expression: { latex: Latex }): HelperExpression;
+
+    /**
+     * All helper expressions created on this calculator.
+     * @remarks Undocumented: may change without notice.
+     */
+    getHelperExpressions(): HelperExpression[];
+
+    // -------------------------------------------------------------------------
+    // Settings
+    // -------------------------------------------------------------------------
+
+    /**
+     * Update options and graph settings. Properties that aren't given keep
+     * their current value. Some combinations conflict and get adjusted:
+     * avoid `graphpaper: false` with `expressionsCollapsed: true` or
+     * `zoomButtons: true`, and `lockViewport: true` with `zoomButtons: true`.
+     */
+    updateSettings(settings: GraphingCalculatorOptions): void;
+
+    /** @deprecated Use {@link GraphingCalculatorBase.updateSettings} instead. */
+    setGraphSettings(settings: GraphingCalculatorOptions): void;
+
+    /** Current settings, observable per property. */
+    readonly settings: GraphingCalculatorSettings;
+
+    /** @deprecated Use {@link GraphingCalculatorBase.settings} instead. */
+    readonly graphSettings: GraphingCalculatorSettings;
+
+    /** The palette in use: the `colors` option or the default palette. */
+    readonly colors: ColorPalette;
+
+    /** Set `settings.randomSeed` to a new random value, re-randomizing `random()`. */
+    newRandomSeed(): void;
+
+    // -------------------------------------------------------------------------
+    // Viewport
+    // -------------------------------------------------------------------------
+
+    /** Set the graphpaper bounds. Invalid bounds (`right <= left` or `top <= bottom`) are ignored. */
+    setMathBounds(bounds: MathBounds | ViewportBounds): void;
+
+    /** Whether the projection is uniform (square math aspect ratio). */
+    isProjectionUniform(): boolean;
+
+    // -------------------------------------------------------------------------
+    // Selection and focus
+    // -------------------------------------------------------------------------
+
+    /**
+     * Focus the first expression. It isn't focused by default because the
+     * browser would scroll it into view on page load.
+     */
+    focusFirstExpression(): void;
+
+    /**
+     * Open the keypad, focusing the first expression if none is focused.
+     * @deprecated Use the `keypadActivated` option, optionally followed by
+     * `focusFirstExpression()`.
+     */
+    openKeypad(): void;
+
+    /** Select the expression with this id, as if the user had clicked it. */
+    setSelectedExpressionId(id: ExpressionId): void;
+
+    /** Remove the selected expression. Returns its id, or `undefined` if nothing was selected. */
+    removeSelected(): ExpressionId | undefined;
+
+    // -------------------------------------------------------------------------
+    // Accessibility
+    // -------------------------------------------------------------------------
+
+    /**
+     * Open the audio-trace keypad for the selected expression, or the first
+     * traceable expression if none is selected. Requires `audio: true`.
+     */
+    enterAudioTrace(): void;
+
+    /** Exit audio trace mode if it is active. */
+    exitAudioTrace(): void;
+  }
+}
+// ---- types/calculators/graphing.d.ts ----
+
+/**
+ * The 2D graphing calculator.
+ */
+declare namespace Desmos {
+  /**
+   * A graphing calculator embedded in a DOM element. Create one with
+   * `Desmos.GraphingCalculator(element, options)`.
+   */
+  interface GraphingCalculator extends GraphingCalculatorBase {
+    /**
+     * Asynchronous screenshot. Guarantees the state is fully evaluated
+     * before capture, can capture regions outside the current viewport, and
+     * can produce SVG.
+     */
+    asyncScreenshot(callback: AsyncScreenshotCallback): void;
+    asyncScreenshot(options: AsyncScreenshotOptions, callback: AsyncScreenshotCallback): void;
+
+    /** Convert math coordinates to pixel coordinates. Returns the same properties as `coords`. */
+    mathToPixels<T extends PartialPoint>(coords: T): ConvertedPoint<T>;
+
+    /** Convert pixel coordinates to math coordinates. Inverse of `mathToPixels`. */
+    pixelsToMath<T extends PartialPoint>(coords: T): ConvertedPoint<T>;
+  }
+
+  interface GraphingCalculatorConstructor {
+    (element: HTMLElement, options?: GraphingCalculatorOptions): GraphingCalculator;
+    new (element: HTMLElement, options?: GraphingCalculatorOptions): GraphingCalculator;
+    readonly prototype: GraphingCalculator;
+  }
+
+  /**
+   * Create a graphing calculator in `element`. The calculator fills the
+   * element; give the element a size.
+   *
+   * @throws If the graphing calculator isn't enabled for the API key.
+   *
+   * @example
+   * const calculator = Desmos.GraphingCalculator(document.getElementById('calculator')!, {
+   *   keypad: false,
+   * });
+   */
+  const GraphingCalculator: GraphingCalculatorConstructor;
+
+  /**
+   * Alias of {@link Desmos.GraphingCalculator}.
+   * @remarks Undocumented alias kept for backward compatibility.
+   */
+  const Calculator: GraphingCalculatorConstructor;
+}
+// ---- types/calculators/geometry.d.ts ----
+
+/**
+ * The geometry tool. Built on the graphing calculator and shares its API.
+ */
+declare namespace Desmos {
+  /**
+   * A geometry tool instance. Create one with `Desmos.Geometry(element, options)`.
+   *
+   * With `authorFeatures: true`, the settings menu also lets authors
+   * customize the toolbar. Toolbar customizations are saved in the state.
+   */
+  interface Geometry extends GraphingCalculator {}
+
+  interface GeometryConstructor {
+    (element: HTMLElement, options?: GeometryOptions): Geometry;
+    new (element: HTMLElement, options?: GeometryOptions): Geometry;
+    readonly prototype: Geometry;
+  }
+
+  /**
+   * Create a geometry tool in `element`. It can be created before `element`
+   * is in the DOM; the view appears once it is inserted. Call `destroy()`
+   * when done.
+   *
+   * @throws If the geometry tool isn't enabled for the API key.
+   */
+  const Geometry: GeometryConstructor;
+}
+// ---- types/calculators/calculator3d.d.ts ----
+
+/**
+ * The 3D graphing calculator. Built on the graphing calculator and shares
+ * most of its API.
+ */
+declare namespace Desmos {
+  /**
+   * Camera orientation as two angles in radians: the tilt of the z-axis
+   * toward the viewer, and the rotation about the z-axis. Inferred from the
+   * v1.13 bundle.
+   */
+  type Orientation3D = [tilt: number, spin: number];
+
+  /**
+   * A 3D calculator. Create one with `Desmos.Calculator3D(element, options)`.
+   *
+   * Compared with {@link GraphingCalculator}: `asyncScreenshot()` always
+   * throws in v1.13 (use `screenshot()`), and `mathToPixels` / `pixelsToMath`
+   * are `undefined`, so neither is declared here.
+   */
+  interface Calculator3D extends GraphingCalculatorBase {
+    /** Set the bounds, including the z range. */
+    setMathBounds(bounds: MathBounds | ViewportBounds | ViewportBounds3D): void;
+
+    /**
+     * The current camera orientation.
+     * @remarks Undocumented: may change without notice.
+     */
+    getOrientation(): Orientation3D;
+
+    /**
+     * Set the camera orientation immediately and stop any auto-rotation.
+     * Non-finite angles are ignored.
+     * @remarks Undocumented: may change without notice.
+     */
+    setOrientation(tilt: number, spin: number): void;
+
+    /**
+     * Animate the camera to an orientation. Non-finite angles are ignored.
+     * @remarks Undocumented: may change without notice.
+     */
+    animateToOrientation(tilt: number, spin: number): void;
+
+    /**
+     * Set the perspective distortion. `0` gives an orthographic projection;
+     * the default is `1`. Values outside the supported range are ignored.
+     * @remarks Undocumented: may change without notice.
+     */
+    setPerspectiveDistortion(value: number): void;
+  }
+
+  interface Calculator3DConstructor {
+    (element: HTMLElement, options?: Calculator3DOptions): Calculator3D;
+    new (element: HTMLElement, options?: Calculator3DOptions): Calculator3D;
+    readonly prototype: Calculator3D;
+  }
+
+  /**
+   * Create a 3D calculator in `element`. It can be created before `element`
+   * is in the DOM; the view appears once it is inserted. Call `destroy()`
+   * when done.
+   *
+   * @throws If the 3D calculator isn't enabled for the API key.
+   */
+  const Calculator3D: Calculator3DConstructor;
+}
+// ---- types/calculators/basic.d.ts ----
+
+/**
+ * The four-function and scientific calculators.
+ */
+declare namespace Desmos {
+  /**
+   * A four-function or scientific calculator. Its methods behave like the
+   * graphing calculator's, with a smaller set of settings.
+   *
+   * @typeParam TOptions - options accepted by `updateSettings()`.
+   */
+  interface BasicCalculator<TOptions extends BasicCalculatorOptions = BasicCalculatorOptions> {
+    /** Destroy the instance, unbind listeners and free resources. */
+    destroy(): void;
+
+    /** Resize to fill the container. Only needed when auto-sizing is off. */
+    resize(): void;
+
+    /** The current state. Treat it as opaque; it can be serialized with `JSON.stringify`. */
+    getState(): BasicCalculatorState;
+
+    /** Load a state previously returned by `getState()`. */
+    setState(state: BasicCalculatorState, options?: SetBlankOptions): void;
+
+    /** Reset to a blank state. */
+    setBlank(options?: SetBlankOptions): void;
+
+    undo(): void;
+    redo(): void;
+    clearHistory(): void;
+
+    focusFirstExpression(): void;
+
+    /** Update settings. Properties that aren't given keep their current value. */
+    updateSettings(settings: TOptions): void;
+
+    /**
+     * Current settings, observable per property.
+     * @remarks Undocumented for basic calculators, but present at runtime.
+     */
+    readonly settings: BasicCalculatorSettings<TOptions>;
+
+    /** Listen for changes to the calculator's state. Supports namespacing (`'change.ns'`). */
+    observeEvent(event: EventName<'change'>, callback: () => void): void;
+
+    /** Remove `'change'` observers. */
+    unobserveEvent(event: EventName<'change'>): void;
+  }
+
+  type FourFunctionCalculator = BasicCalculator<FourFunctionCalculatorOptions>;
+  type ScientificCalculator = BasicCalculator<ScientificCalculatorOptions>;
+
+  interface FourFunctionCalculatorConstructor {
+    (element: HTMLElement, options?: FourFunctionCalculatorOptions): FourFunctionCalculator;
+    new (element: HTMLElement, options?: FourFunctionCalculatorOptions): FourFunctionCalculator;
+    readonly prototype: FourFunctionCalculator;
+  }
+
+  interface ScientificCalculatorConstructor {
+    (element: HTMLElement, options?: ScientificCalculatorOptions): ScientificCalculator;
+    new (element: HTMLElement, options?: ScientificCalculatorOptions): ScientificCalculator;
+    readonly prototype: ScientificCalculator;
+  }
+
+  /**
+   * Create a four-function calculator in `element`.
+   * @throws If the four-function calculator isn't enabled for the API key.
+   */
+  const FourFunctionCalculator: FourFunctionCalculatorConstructor;
+
+  /**
+   * Create a scientific calculator in `element`.
+   * @throws If the scientific calculator isn't enabled for the API key.
+   */
+  const ScientificCalculator: ScientificCalculatorConstructor;
+}
+// ---- types/abraham.d.ts ----
+
+/**
+ * Abraham: Desmos's library for translating between LaTeX and the Nemeth and
+ * UEB Braille math codes, bundled into `calculator.js`.
+ *
+ * Documented at https://www.desmos.com/api/v1.13/docs/abraham.html. Desmos
+ * asks that you contact partnerships@desmos.com before using it.
+ */
+declare namespace Desmos {
+  /** A position in the translator's input. */
+  interface AbrahamLocation {
+    first_line: number;
+    last_line: number;
+    first_column: number;
+    last_column: number;
+  }
+
+  /** A place where permissive Braille→LaTeX translation inserted a missing delimiter. */
+  interface AbrahamWarning {
+    location: AbrahamLocation;
+  }
+
+  /** A successful LaTeX→Braille translation. */
+  interface AbrahamBrailleSuccess {
+    isError: false;
+    /** Six-dot Unicode Braille. */
+    value: string;
+  }
+
+  /** A successful Braille→LaTeX translation. */
+  interface AbrahamLatexSuccess {
+    isError: false;
+    value: Latex;
+    /** Where missing delimiters were inserted. Always empty with `strict: true`. */
+    warnings: AbrahamWarning[];
+  }
+
+  /** A successful translation in either direction. */
+  interface AbrahamSuccess {
+    isError: false;
+    value: string;
+    /** Present on Braille→LaTeX results. */
+    warnings?: AbrahamWarning[];
+  }
+
+  /** A failed translation (a parse error). */
+  interface AbrahamFailure {
+    isError: true;
+    error: {
+      /** Where the parse error occurred. */
+      location: AbrahamLocation;
+      /** Developer diagnostics. Not part of the public API; its contents may change. */
+      _diagnostic?: unknown;
+    };
+  }
+
+  /** The result of `latexToNemeth` / `latexToUeb`. */
+  type AbrahamBrailleResult = AbrahamBrailleSuccess | AbrahamFailure;
+
+  /** The result of `nemethToLatex` / `uebToLatex`. */
+  type AbrahamLatexResult = AbrahamLatexSuccess | AbrahamFailure;
+
+  /** The result of any translation. */
+  type AbrahamResult = AbrahamSuccess | AbrahamFailure;
+
+  interface AbrahamLatexToBrailleOptions {
+    /**
+     * Operator names to recognize. Neither Braille code has a convention for
+     * `\operatorname`, so these are written as plain letters.
+     * @defaultValue Desmos's built-in list (`floor`, `mean`, `normaldist`, ...)
+     */
+    operatorNames?: readonly string[];
+  }
+
+  interface AbrahamBrailleToLatexOptions {
+    /**
+     * Treat missing delimiters (e.g. an unclosed fraction or radical) as parse
+     * errors instead of inserting them and reporting `warnings`.
+     * @defaultValue `false`
+     */
+    strict?: boolean;
+    /**
+     * Operator names to recognize in the Braille input, e.g. `['blah']` turns
+     * `blah(abc)` into `\operatorname{blah}(abc)`.
+     * @defaultValue Desmos's built-in list (`floor`, `mean`, `normaldist`, ...)
+     */
+    operatorNames?: readonly string[];
+  }
+
+  interface Abraham {
+    /** Library version, e.g. `'1.0.3'`. */
+    readonly version: string;
+
+    /**
+     * LaTeX → Nemeth Braille.
+     * @example Abraham.latexToNemeth('e_{f}^{x^{2}}') // { isError: false, value: '⠑⠰⠋⠘⠭⠘⠘⠆' }
+     */
+    latexToNemeth(latex: Latex, options?: AbrahamLatexToBrailleOptions): AbrahamBrailleResult;
+
+    /**
+     * LaTeX → UEB Braille.
+     * @example Abraham.latexToUeb('1+1') // { isError: false, value: '⠼⠁⠐⠖⠼⠁' }
+     */
+    latexToUeb(latex: Latex, options?: AbrahamLatexToBrailleOptions): AbrahamBrailleResult;
+
+    /**
+     * Nemeth Braille → LaTeX. `braille` must be six-dot Unicode Braille; use
+     * `UnicodeBraille.coerceToSixDotCells` to convert other formats first.
+     * Unless `strict` is set, missing delimiters are inserted and reported in `warnings`.
+     * @example Abraham.nemethToLatex('⠹⠂⠌⠆') // value '\\frac{1}{2}', with one warning
+     */
+    nemethToLatex(braille: string, options?: AbrahamBrailleToLatexOptions): AbrahamLatexResult;
+
+    /**
+     * UEB Braille → LaTeX. `braille` must be six-dot Unicode Braille; use
+     * `UnicodeBraille.coerceToSixDotCells` to convert other formats first.
+     * Unless `strict` is set, missing delimiters are inserted and reported in `warnings`.
+     * @example Abraham.uebToLatex('⠼⠁⠐⠖⠼⠁') // { isError: false, value: '1+1', warnings: [] }
+     */
+    uebToLatex(braille: string, options?: AbrahamBrailleToLatexOptions): AbrahamLatexResult;
+
+    /** Conversions between Unicode Braille and Braille ASCII. */
+    readonly UnicodeBraille: {
+      /**
+       * Unicode Braille → Braille ASCII (upper case letters as a comma + letter digraph).
+       * @example toBrailleAscii('⠼⠁⠐⠖⠼⠁') // '#A"6#A'
+       */
+      toBrailleAscii(braille: string): string;
+      /**
+       * Unicode Braille → Expanded Braille ASCII, the eight-dot encoding common
+       * on refreshable displays.
+       * @example toExpandedBrailleAscii('⠼⠁⠐⠖⠼⠁') // '#a"6#a'
+       */
+      toExpandedBrailleAscii(braille: string): string;
+      /**
+       * Coerce input to the six-dot Unicode Braille the translators expect:
+       * converts Braille ASCII or Expanded Braille ASCII (ignoring case), and
+       * strips the bottom pair of dots from eight-dot Unicode cells.
+       * @example coerceToSixDotCells('#A"6#A') // '⠼⠁⠐⠖⠼⠁'
+       */
+      coerceToSixDotCells(input: string): string;
+    };
+  }
+
+  /** The Abraham Braille translation library. */
+  const Abraham: Abraham;
+}
+// ---- types/mathquill.d.ts ----
+
+/**
+ * The MathQuill build bundled into `calculator.js`. It is Desmos's own fork,
+ * and some standard MathQuill methods (such as `cmd`, `reflow` and `revert`)
+ * are missing. Only methods present in the v1.13 bundle are declared.
+ *
+ * @remarks Undocumented: may change without notice.
+ */
+declare namespace Desmos {
+  /** A MathQuill config object. The option set of Desmos's fork is not documented. */
+  type MathQuillConfig = Record<string, unknown>;
+
+  /** A static (read-only) math field. */
+  interface MathQuillStaticMath {
+    /** The field's root element. */
+    el(): HTMLElement;
+    /** The current LaTeX. */
+    latex(): Latex;
+    /** Replace the contents with `latex`. */
+    latex(latex: Latex): this;
+    /** A spoken-math description of the contents. */
+    mathspeak(): string;
+    focus(): this;
+    blur(): this;
+    getAriaLabel(): string;
+    setAriaLabel(label: string): this;
+    getAriaPostLabel(): string;
+    setAriaPostLabel(label: string): this;
+  }
+
+  /** An editable math field. */
+  interface MathQuillMathField extends MathQuillStaticMath {
+    /** Insert `latex` at the cursor. */
+    write(latex: Latex): this;
+    /** Simulate typing `text`. */
+    typedText(text: string): this;
+    /** Simulate a key press, e.g. `'Left'`, `'Shift-Left'` or `'Backspace'`. */
+    keystroke(keys: string): this;
+    /** Select the whole contents. */
+    select(): this;
+    clearSelection(): this;
+    moveToLeftEnd(): this;
+    moveToRightEnd(): this;
+  }
+
+  interface MathQuill {
+    /** The MathQuill API instance attached to `element`, if any. */
+    (element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+    /** Turn `element` into an editable math field. */
+    MathField(element: HTMLElement, config?: MathQuillConfig): MathQuillMathField;
+    /** Render `element`'s LaTeX text content as static math. */
+    StaticMath(element: HTMLElement, config?: MathQuillConfig): MathQuillStaticMath;
+    /** Set global MathQuill configuration. */
+    config(config: MathQuillConfig): void;
+    /** The MathQuill API instance attached to `element`, if any. */
+    getApiInstanceForElement(element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+  }
+
+  /** @remarks Undocumented: may change without notice. */
+  const MathQuill: MathQuill;
+}
+// ---- types/desmos.d.ts ----
+
+/**
+ * Top-level values on the `Desmos` global that don't belong to a specific
+ * calculator.
+ */
+declare namespace Desmos {
+  /**
+   * Which calculators the API key allows. Calling a disabled calculator's
+   * constructor throws.
+   */
+  interface EnabledFeatures {
+    GraphingCalculator: boolean;
+    FourFunctionCalculator: boolean;
+    ScientificCalculator: boolean;
+    GeometryCalculator: boolean;
+    Calculator3D: boolean;
+  }
+
+  /** Features enabled for the API key used to load `calculator.js`. */
+  const enabledFeatures: Readonly<EnabledFeatures>;
+
+  /**
+   * Language codes loaded into this copy of `calculator.js`. `'en'` is always
+   * included; others must be requested with the `lang` URL parameter.
+   */
+  const supportedLanguages: readonly LanguageCode[];
+
+  /**
+   * The default `imageUploadCallback`. Converts `file` to a data URL, taking
+   * EXIF orientation into account and recompressing large images.
+   * `dataURL` is set only when `error` is falsy.
+   */
+  function imageFileToDataURL(file: File, callback: (error: unknown, dataURL: string) => void): void;
+
+  /**
+   * Build version, e.g. `'v1.13'` or `'v1.13-prerelease'`.
+   * @remarks Undocumented.
+   */
+  const version: string;
+
+  /**
+   * Git commit the build was made from.
+   * @remarks Undocumented.
+   */
+  const commit: string;
+}
+
+export = Desmos;