@scm-js/plugin-api 1.62.0 → 1.64.0

package/index.d.ts

@@ -1049,6 +1049,7 @@ export interface DoodadVerdict {
 	/** Cell indices (row-major) whose ground fails the check, for the ghost to mark red. */
 	bad: number[];
 }
+export type SymmetryMode = "none" | "h" | "v" | "hv" | "rot180" | "rot90" | "diag" | "adiag";
 export interface LocationStringChange {
 	index: number;
 	before: string | null;
@@ -2081,7 +2082,6 @@ export interface ChangeTilesetResult {
 	spritesDropped: number;
 	refilled: boolean;
 }
-export type SymmetryMode = "none" | "h" | "v" | "hv" | "rot180" | "rot90" | "diag" | "adiag";
 export type StartLayout = "ring" | "corners";
 export interface StartPlacementResult {
 	changes: UnitChange[];
@@ -2687,7 +2687,8 @@ export interface BuildStepSpec {
 	 * Build. Return an archive (or a bare scenario) — the editor takes the scenario and any
 	 * *new* members from it and lays the final file out with the user's save options; the
 	 * map's own members are written as they were. Throw an `Error` whose message says what
-	 * is wrong in the user's terms.
+	 * is wrong in the user's terms. A plain `Error` is logged as a warning, a refusal the step
+	 * meant; anything else thrown (a `TypeError`, a class of your own) is logged as an error.
 	 */
 	run(input: BuildStepInput): Promise<Uint8Array>;
 }
@@ -2707,7 +2708,8 @@ export interface BeforeBuildSpec {
 	/**
 	 * May be asynchronous and may write to the document. A throw does not stop the save:
 	 * the map is written as it stands and a notice shows the error's message, so word it
-	 * for the user. Inside it `document.export()` answers the map as it stands, without
+	 * for the user. As with a build step, a plain `Error` is logged as a warning and anything
+	 * else as an error. Inside it `document.export()` answers the map as it stands, without
 	 * running anything.
 	 */
 	run(ctx: {

package/package.json

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