@spidunno/desmos-types 1.13.5 → 1.13.6

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.6
 ```
 
 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.6`), 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
 

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" />
 
@@ -1944,4 +1947,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" />
 
@@ -8178,4 +8181,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.6",
   "description": "TypeScript type definitions for the Desmos API v1.13",
   "types": "index.d.ts",
   "publishConfig": {