@spidunno/desmos-types 1.13.8 → 1.13.9

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.8
+npm install --save-dev @spidunno/desmos-types@~1.13.9
 ```
 
 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.8`), not npm's default caret (`^`), so you only
+are fixes to the types. Use a tilde range (`~1.13.9`), not npm's default caret (`^`), so you only
 get type fixes for the API version you load.
 
 ## Usage
@@ -366,10 +366,36 @@ g.events.unobserveEvent('.myMod');
 Moving the viewport this way doesn't add an undo step. Call
 `g.debounceUserRequestedViewportChange()` afterwards if you want one.
 
+### Which Desmos build a version matches
+
+Desmos updates the v1.13 bundle without changing its version, so the internal types are
+regenerated automatically whenever `Desmos.commit` changes, and each regeneration is published as a
+new patch version. The `desmos` field in `package.json` records the commit a version was generated
+from, and [CHANGELOG.md](CHANGELOG.md) lists every version's commit and what changed in the
+internals:
+
+```sh
+npm view @spidunno/desmos-types@1.13.9 desmos   # { version: 'v1.13-prerelease', commit: '…' }
+```
+
+```js
+// is the live bundle the one the installed types were generated from?
+console.log(Desmos.commit);
+```
+
 ### Regenerating for a new bundle
 
 ```sh
 curl -o calculator.js "https://www.desmos.com/api/v1.13/calculator.js?apiKey=YOUR_API_KEY"
+npm run update:bundle -- calculator.js
+```
+
+`update:bundle` does the whole update: it reads the bundle's commit (stopping if it's the one in
+`package.json`, unless you pass `--force`), runs both generators, runs `npm test`, bumps the patch
+version, records the commit and adds a CHANGELOG entry. It doesn't commit or publish. The
+generators can also be run on their own:
+
+```sh
 npm run generate:internals -- calculator.js
 npm run snapshot:sketches -- calculator.js
 npm test

package/internals/generated/actions.d.ts

@@ -1,6 +1,6 @@
 // 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 {
   /**

package/internals/generated/objects.d.ts

@@ -1,6 +1,6 @@
 // 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 {

package/internals/generated/views.d.ts

@@ -1,6 +1,6 @@
 // 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 {
   /**

package/internals/grapher2d.d.ts

@@ -411,6 +411,19 @@ declare namespace Desmos.Internals {
     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 };
   }
 
   /**

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

@@ -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

@@ -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 {
   /**
@@ -7347,6 +7347,19 @@ declare namespace Desmos.Internals {
     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 };
   }
 
   /**
@@ -8452,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.8",
+  "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"
   }
 }