@scm-js/plugin-api 1.68.0 → 1.70.0

package/index.d.ts

@@ -1395,6 +1395,20 @@ export interface Toast {
 		label: string;
 		run: () => void;
 	};
+	/**
+	 * Buttons in a row under the text, for a notice that offers more than one way on — the
+	 * terrain notice's data set to switch to, folder to draw from and Game Data…. Pressing
+	 * one dismisses the toast unless it says `keep` (a button that opens a picker the person
+	 * may back out of).
+	 */
+	actions?: ToastAction[];
+}
+/** One of a toast's `actions`. */
+export interface ToastAction {
+	label: string;
+	run: () => void;
+	/** Leave the toast up when pressed. */
+	keep?: boolean;
 }
 /**
  * The colour and layout codes StarCraft reads out of a string, and what a string looks
@@ -4348,9 +4362,10 @@ export interface GameDataSource {
 	/** Set when the desktop app extracted the files from a StarCraft installation. */
 	desktop: boolean;
 	/**
-	 * The data set's hash, where one is known: what a map saved with it records. Sixteen hex
-	 * digits over the files of the set that differ from the game's, by the rule `scmjs mod
-	 * play` hands the play page (`docs/cli.md`, "Playing a mod on the play page").
+	 * The data set's hash, where one is known: what a map saved with it records. The mod's
+	 * hash, as the play page and `scmjs mod info` work it out (`docs/mods.md`, "The mod's
+	 * hash"): sixteen hex digits over every file the set provides — its game files, the
+	 * plugins it carries and its FireGraft project — never compared with anyone's copy.
 	 */
 	hash?: string;
 	/**
@@ -4523,7 +4538,7 @@ export interface GameDataApi {
 	 * @example
 	 * // Draw from the edit at once, and name it when its digest is ready.
 	 * api.gameData.reload();
-	 * api.gameData.rehash(await digestOfChangedFiles());
+	 * api.gameData.rehash(await modHashOfTheFiles());
 	 */
 	rehash(hash: string | null): GameDataSource | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scm-js/plugin-api",
-  "version": "1.68.0",
+  "version": "1.70.0",
   "description": "Type declarations for the scmJS plugin API",
   "license": "MIT",
   "types": "index.d.ts",