@spidunno/desmos-types 1.13.7 → 1.13.9

package/internals/list-model.d.ts

@@ -1,36 +1,36 @@
-/**
- * `controller.listModel`: the expressions list, its lookup tables and
- * selection state.
- */
-declare namespace Desmos.Internals {
-  /**
-   * One pass of drawing. Layer `-1` holds background images (drawn under the
-   * grid), `0` everything else, and `1` folders marked "in front of
-   * everything". Layers -1 and 1 only exist when non-empty.
-   */
-  interface DrawLayer {
-    layer: -1 | 0 | 1;
-    /** Item ids (table column ids for tables) in paint order, back to front. */
-    drawOrder: ExpressionId[];
-    drawSet: Set<ExpressionId>;
-  }
-
-  interface ListModel extends Generated.ListModel {
-    controller: Controller;
-    /** Every item, in list order. Prefer `controller.getAllItemModels()`. */
-    __itemModelArray: ItemModel[];
-    /** Items by id. Prefer `controller.getItemModel(id)`. */
-    __itemIdToModel: Record<ExpressionId, ItemModel>;
-    /** Helper expressions by id. */
-    __helperIdToModel: Record<string, unknown>;
-    /** Ids of selected items. */
-    selectedItemMap: Record<ExpressionId, unknown>;
-    /** Item ids in keyboard tab order. */
-    tabOrder: ExpressionId[];
-    drawLayers: DrawLayer[];
-    /** Index into the palette for the next new item's color. */
-    colorIdx: number;
-    expressionAnalysis: Record<ExpressionId, ExpressionAnalysis>;
-    ticker: TickerModel;
-  }
-}
+/**
+ * `controller.listModel`: the expressions list, its lookup tables and
+ * selection state.
+ */
+declare namespace Desmos.Internals {
+  /**
+   * One pass of drawing. Layer `-1` holds background images (drawn under the
+   * grid), `0` everything else, and `1` folders marked "in front of
+   * everything". Layers -1 and 1 only exist when non-empty.
+   */
+  interface DrawLayer {
+    layer: -1 | 0 | 1;
+    /** Item ids (table column ids for tables) in paint order, back to front. */
+    drawOrder: ExpressionId[];
+    drawSet: Set<ExpressionId>;
+  }
+
+  interface ListModel extends Generated.ListModel {
+    controller: Controller;
+    /** Every item, in list order. Prefer `controller.getAllItemModels()`. */
+    __itemModelArray: ItemModel[];
+    /** Items by id. Prefer `controller.getItemModel(id)`. */
+    __itemIdToModel: Record<ExpressionId, ItemModel>;
+    /** Helper expressions by id. */
+    __helperIdToModel: Record<string, unknown>;
+    /** Ids of selected items. */
+    selectedItemMap: Record<ExpressionId, unknown>;
+    /** Item ids in keyboard tab order. */
+    tabOrder: ExpressionId[];
+    drawLayers: DrawLayer[];
+    /** Index into the palette for the next new item's color. */
+    colorIdx: number;
+    expressionAnalysis: Record<ExpressionId, ExpressionAnalysis>;
+    ticker: TickerModel;
+  }
+}

package/module/index.d.ts

@@ -2044,7 +2044,7 @@ declare namespace Desmos {
     /** Set global MathQuill configuration. */
     config(config: MathQuillConfig): void;
     /** The MathQuill API instance attached to `element`, if any. */
-    getApiInstanceForElement(element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+    getApiInstanceForElement(element: Element): MathQuillStaticMath | MathQuillMathField | null | undefined;
   }
 
   /** @remarks Undocumented: may change without notice. */
@@ -2099,3 +2099,11 @@ declare namespace Desmos {
 }
 
 export type { Desmos };
+
+/**
+ * The same namespace, exported as a value as well. This package has no
+ * JavaScript, so importing this from here fails at runtime: it exists for
+ * packages that supply the value themselves and re-export it as `Desmos`,
+ * like @spidunno/desmos-loader.
+ */
+export { Desmos as DesmosForLoaders };

package/module/internals.d.ts

@@ -2044,7 +2044,7 @@ declare namespace Desmos {
     /** Set global MathQuill configuration. */
     config(config: MathQuillConfig): void;
     /** The MathQuill API instance attached to `element`, if any. */
-    getApiInstanceForElement(element: HTMLElement): MathQuillStaticMath | MathQuillMathField | null | undefined;
+    getApiInstanceForElement(element: Element): MathQuillStaticMath | MathQuillMathField | null | undefined;
   }
 
   /** @remarks Undocumented: may change without notice. */
@@ -2101,7 +2101,7 @@ declare namespace Desmos {
 
 // AUTO-GENERATED by scripts/extract-internals.cjs. Do not edit by hand:
 // put precise types in the hand-written files in internals/ instead.
-// Source: Desmos v1.13-prerelease (commit c2616b6762c586165f75e322fbc6c7b6ab56b394).
+// Source: Desmos v1.13-prerelease (commit 7f0bcd732b59def63b568d6e527e004258e53995).
 // Runtime shapes of internal objects.
 declare namespace Desmos.Internals.Generated {
   interface Controller {
@@ -4771,7 +4771,7 @@ declare namespace Desmos.Internals.Generated {
 
 // AUTO-GENERATED by scripts/extract-internals.cjs. Do not edit by hand:
 // put precise types in the hand-written files in internals/ instead.
-// Source: Desmos v1.13-prerelease (commit c2616b6762c586165f75e322fbc6c7b6ab56b394).
+// Source: Desmos v1.13-prerelease (commit 7f0bcd732b59def63b568d6e527e004258e53995).
 // Actions accepted by each dispatch domain, from static analysis.
 declare namespace Desmos.Internals.Generated {
   /**
@@ -5529,7 +5529,7 @@ declare namespace Desmos.Internals.Generated {
 
 // AUTO-GENERATED by scripts/extract-internals.cjs. Do not edit by hand:
 // put precise types in the hand-written files in internals/ instead.
-// Source: Desmos v1.13-prerelease (commit c2616b6762c586165f75e322fbc6c7b6ab56b394).
+// Source: Desmos v1.13-prerelease (commit 7f0bcd732b59def63b568d6e527e004258e53995).
 // Props and instance members of the views on Private.Fragile.
 declare namespace Desmos.Internals.Generated {
   /**
@@ -7300,6 +7300,68 @@ declare namespace Desmos.Internals {
     };
   }
 
+  // ---------------------------------------------------------------------------
+  // Grid layer
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Grid spacing in math units: the axis step settings if they fit, otherwise
+   * steps picked so the axis numbers don't overlap. A minor step of 0 means no
+   * minor lines; both are NaN on a logarithmic axis.
+   */
+  interface GridSteps {
+    majorStepX: number;
+    minorStepX: number;
+    majorStepY: number;
+    minorStepY: number;
+  }
+
+  /** Where a logarithmic axis draws its lines (a linear axis has empty lists). */
+  interface LogAxisGrid {
+    label: number[];
+    major: number[];
+    minor: number[];
+    /** Multiplies the minor line opacity; fades minor lines as decades shrink. */
+    unitOpacity: number;
+  }
+
+  interface LogGrid {
+    x: LogAxisGrid;
+    y: LogAxisGrid;
+  }
+
+  /**
+   * `grapher2d.gridLayer` (also `privateGetGridLayer()`): draws the grid,
+   * axes and axis numbers, under every graph.
+   *
+   * Lines are drawn 1px wide at `Math.round(px - 0.5) + 0.5`, in the text
+   * color: minor lines at `minorAxisOpacity`, then major lines over them at
+   * an opacity that composites to `majorAxisOpacity`. Lines on the edges of
+   * the screen, and at 0 when that axis is shown, are skipped.
+   */
+  interface GridLayer extends Generated.Grapher2DGridLayer {
+    /**
+     * Draw the whole layer. The main redraw passes `grapher2d.scaleAxis`
+     * (the axis being dragged, highlighted); screenshots pass only `context`.
+     */
+    redrawToCtx(context: DrawContext, scaleAxis?: 'x' | 'y' | 'both'): void;
+    drawCartesianGrid(ctx: CanvasRenderingContext2D, projection: Projection, steps: GridSteps, logGrid?: LogGrid): void;
+    drawPolarGrid(ctx: CanvasRenderingContext2D, projection: Projection, steps: { majorStepR: number; minorStepR: number }): void;
+    /**
+     * Draw the numbers at every major step (each one a `strokeText` shadow
+     * then a `fillText`), plus tick marks on the axes when `drawTickMarks`
+     * (the grid is hidden). Returns the strips along each axis that the
+     * numbers cover, which `drawLabels` keeps the axis labels out of.
+     */
+    drawCartesianStepNumbers(
+      ctx: CanvasRenderingContext2D,
+      projection: Projection,
+      steps: GridSteps,
+      drawTickMarks: boolean,
+      logGrid?: LogGrid,
+    ): { x: PixelRect; y: PixelRect };
+  }
+
   /**
    * Options accepted by the grapher's own screenshot methods. The public
    * `asyncScreenshot` handles `mode` and `mathBounds` itself and passes the
@@ -7413,6 +7475,9 @@ declare namespace Desmos.Internals {
     settings: GrapherSettings;
     events: GrapherEvents;
     viewportController: ViewportController;
+    /** Draws the grid, axes and axis numbers. */
+    gridLayer: GridLayer;
+    privateGetGridLayer(): GridLayer;
     __projection: Projection;
     /** The viewport at the last animation frame (unset before the first one); used to detect viewport changes. */
     lastTickViewport?: Viewport;
@@ -7754,7 +7819,63 @@ declare namespace Desmos.Internals {
     controller: Controller;
   }
 
-  interface Grapher3D extends Generated.Grapher3D {}
+  /** A point in 3D math coordinates. */
+  interface Point3D {
+    x: number;
+    y: number;
+    z: number;
+  }
+
+  /** What the 3D grapher's worker found under the mouse. */
+  interface PickResult3D {
+    /** Where the ray from the mouse hit, in math coordinates. */
+    point: Point3D;
+  }
+
+  /** `grapher3d.controls`: mouse, touch and keyboard handling for the 3D graph paper. */
+  interface Grapher3DControls {
+    grapher3d: Grapher3D;
+    /** The graph paper element (`grapher3d.elt`). Desmos's wheel handler is attached here. */
+    domElement: HTMLElement;
+    /** -1 when idle, 0 while rotating with the mouse. */
+    state: -1 | 0;
+    /** Rotation speed while the graph is spinning, 0 when it isn't. */
+    speed3D: number;
+    /**
+     * `performance.now()` of the last wheel zoom, or 0. The tick calls
+     * `grapher3d.endZoom()` and resets it 100ms after the last one.
+     */
+    lastWheelEventTime: number;
+    /** Whether zoom and pan are disabled. */
+    isLocked(): boolean;
+    /** Whether rotating is disabled (the user lock, or the page is pinch zoomed). */
+    isRotationLocked(): boolean;
+    /** Set the viewport and commit it to history after a short delay. */
+    updateViewport(viewport: ViewportObject): void;
+  }
+
+  /** `grapher3d.viewportController`. */
+  interface Grapher3DViewportController {
+    getViewport(): Viewport;
+    /**
+     * Jump to a viewport. Invalid axes keep their current bounds, and each
+     * axis is clamped to a width between 1.34e-4 × its largest bound (at
+     * least 1.34e-4) and 134000, within ±67000.
+     */
+    setCurrentViewport(viewport: ViewportObject): void;
+  }
+
+  interface Grapher3D extends Generated.Grapher3D {
+    controls: Grapher3DControls;
+    viewportController: Grapher3DViewportController;
+    /** The 3D viewport always has z bounds (Desmos fills in defaults). */
+    getProjection(): { viewport: Viewport & { zmin: number; zmax: number } };
+    /**
+     * What's under the mouse, used as the center when zooming in with the
+     * scroll wheel. Undefined while the graph is spinning, or over nothing.
+     */
+    getZoomScrollWheelPickResult(): PickResult3D | null | undefined;
+  }
 
   interface Evaluator extends Generated.Evaluator {}
 
@@ -8165,6 +8286,17 @@ declare namespace Desmos.Internals {
 
   type FragileViewClass<P, Members> = DCGView.ViewClass<P, FragileView<P, Members>>;
 
+  /** Static helpers on `Fragile.MathquillView`. */
+  interface MathquillViewStatics {
+    /** The math field containing `document.activeElement`, if it's in one. */
+    getFocusedMathquill(): Desmos.MathQuillMathField | undefined;
+    /**
+     * Apply an arrow key to a math field. Returns true if the cursor was
+     * already at that edge (so focus should move to the next item).
+     */
+    applyArrowKeyAndReturnIfWasAtBounds(mathField: Desmos.MathQuillMathField, key: string, event: KeyboardEvent): boolean;
+  }
+
   /** The view classes on `Private.Fragile`. */
   interface FragileViews {
     ExpressionView: FragileViewClass<ExpressionViewProps, Generated.ExpressionViewMembers>;
@@ -8173,7 +8305,7 @@ declare namespace Desmos.Internals {
     ExpressionOptionsMenuView: FragileViewClass<ExpressionOptionsMenuViewProps, Generated.ExpressionOptionsMenuViewMembers>;
     ImageIconView: FragileViewClass<ImageIconViewProps, Generated.ImageIconViewMembers>;
     PromptSliderView: FragileViewClass<PromptSliderViewProps, Generated.PromptSliderViewMembers>;
-    MathquillView: FragileViewClass<MathquillViewProps, Generated.MathquillViewMembers>;
+    MathquillView: FragileViewClass<MathquillViewProps, Generated.MathquillViewMembers> & MathquillViewStatics;
     InlineMathInputView: FragileViewClass<InlineMathInputViewProps, Generated.InlineMathInputViewMembers>;
     StaticMathquillView: FragileViewClass<StaticMathquillViewProps, Generated.StaticMathquillViewMembers>;
     Checkbox: FragileViewClass<CheckboxProps, Generated.CheckboxMembers>;
@@ -8333,3 +8465,11 @@ declare namespace Desmos {
 }
 
 export type { Desmos };
+
+/**
+ * The same namespace, exported as a value as well. This package has no
+ * JavaScript, so importing this from here fails at runtime: it exists for
+ * packages that supply the value themselves and re-export it as `Desmos`,
+ * like @spidunno/desmos-loader.
+ */
+export { Desmos as DesmosForLoaders };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spidunno/desmos-types",
-  "version": "1.13.7",
+  "version": "1.13.9",
   "description": "TypeScript type definitions for the Desmos API v1.13",
   "types": "index.d.ts",
   "publishConfig": {
@@ -31,7 +31,9 @@
     "build:module": "node scripts/build-module-types.cjs",
     "prepack": "npm run build:module",
     "generate:internals": "node scripts/extract-internals.cjs",
-    "snapshot:sketches": "node scripts/snapshot-sketches.cjs"
+    "snapshot:sketches": "node scripts/snapshot-sketches.cjs",
+    "bundle-info": "node scripts/bundle-info.cjs",
+    "update:bundle": "node scripts/update-bundle.mjs"
   },
   "keywords": [
     "desmos",
@@ -40,9 +42,18 @@
     "calculator"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spidunno/desmos-types.git",
+    "directory": "packages/desmos-types"
+  },
   "devDependencies": {
     "acorn": "^8.14.0",
     "acorn-walk": "^8.3.4",
     "jsdom": "^24.1.3"
+  },
+  "desmos": {
+    "version": "v1.13-prerelease",
+    "commit": "7f0bcd732b59def63b568d6e527e004258e53995"
   }
 }

package/types/mathquill.d.ts

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