@spidunno/desmos-types 1.13.5 → 1.13.7

package/README.md

@@ -6,11 +6,11 @@ the graphing calculator, geometry tool, 3D calculator, and the four-function and
 ## Install
 
 ```sh
-npm install --save-dev @spidunno/desmos-types@~1.13.5
+npm install --save-dev @spidunno/desmos-types@~1.13.7
 ```
 
 The package's major and minor version match the Desmos API version it describes; patch releases
-are fixes to the types. Use a tilde range (`~1.13.5`), not npm's default caret (`^`), so you only
+are fixes to the types. Use a tilde range (`~1.13.7`), not npm's default caret (`^`), so you only
 get type fixes for the API version you load.
 
 ## Usage
@@ -62,7 +62,7 @@ script. If you load the API some other way, for example into a scope of your own
 types, but nothing global:
 
 ```ts
-import type * as Desmos from '@spidunno/desmos-types/module'; // or '/module/internals'
+import type { Desmos } from '@spidunno/desmos-types/module'; // or '/module/internals'
 
 async function loadDesmos(): Promise<typeof Desmos> {
   /* ... */
@@ -72,8 +72,10 @@ const api = await loadDesmos();
 const calculator: Desmos.GraphingCalculator = api.GraphingCalculator(element);
 ```
 
-Don't also include the default entry points (in `compilerOptions.types` or a `/// <reference>`), or
-the global comes back.
+`Desmos` is a type-only export, since the package contains no JavaScript: using it as a value is a
+compile error, and editors auto-import it with `import type` (or with a plain import that
+TypeScript removes, unless `verbatimModuleSyntax` is on). Don't also include the default entry
+points (in `compilerOptions.types` or a `/// <reference>`), or the global comes back.
 
 ## Layout
 
@@ -122,7 +124,8 @@ members are typed separately (see [Internals](#internals)). `Desmos.TestInternal
 - `Desmos.Colors.GREEN` is `#348543`, not the documented `#388c46`. The palette still cycles through `#388c46` for new items.
 - `asyncScreenshot()` without a `mode` uses `'preserveX'` when the axes are square and `'stretch'` otherwise, not the documented `'contain'`.
 - On `Calculator3D`, `asyncScreenshot()` always throws, and `mathToPixels` / `pixelsToMath` are `undefined`. The types leave all three out.
-- `substitutions`, `regressionTemplates`, `intervalComprehensions` and `recursion` are accepted as options but never appear on `calculator.settings`.
+- The calculator accepts many options the docs don't mention, such as `complex`, `restrictGridToFirstQuadrant` and `advancedStyling`. All of them are typed (as `UndocumentedGraphingCalculatorConfig`, `InternalGraphingCalculatorOptions` and the undocumented members of `GraphSettings`), along with the deprecated aliases (`menus`, `solutions`, ...), which are marked `@deprecated`.
+- `substitutions`, `regressionTemplates`, `intervalComprehensions`, `recursion` and the internal and deprecated options are accepted but never appear on `calculator.settings`.
 - `setMathBounds()` also accepts `{ xmin, xmax, ymin, ymax }`, plus `zmin` / `zmax` on 3D.
 
 ## Internals

package/module/index.d.ts

@@ -3,7 +3,10 @@
 //
 // 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.
+// for example when you load calculator.js into a scope of your own:
+//
+//   import type { Desmos } from '@spidunno/desmos-types/module';
+//   declare const api: typeof Desmos;
 
 /// <reference lib="dom" />
 
@@ -565,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;
@@ -583,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.
@@ -1944,4 +2098,4 @@ declare namespace Desmos {
   const commit: string;
 }
 
-export = Desmos;
+export type { Desmos };

package/module/internals.d.ts

@@ -3,7 +3,10 @@
 //
 // 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.
+// for example when you load calculator.js into a scope of your own:
+//
+//   import type { Desmos } from '@spidunno/desmos-types/module';
+//   declare const api: typeof Desmos;
 
 /// <reference lib="dom" />
 
@@ -565,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;
@@ -583,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.
@@ -8178,4 +8332,4 @@ declare namespace Desmos {
   }
 }
 
-export = Desmos;
+export type { Desmos };

package/package.json

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

package/types/options/graphing.d.ts

@@ -266,12 +266,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;
@@ -284,37 +454,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.