@scm-js/plugin-api 1.42.0 → 1.44.0

package/index.d.ts

@@ -671,6 +671,63 @@ export interface PaletteBand {
 	min: number;
 	max: number;
 }
+/** A parsed `.dds.vr4`: where each megatile's compressed pixels start in `bytes`. */
+export interface HdTileFile {
+	bytes: Uint8Array;
+	count: number;
+	/** Offset of megatile N's DXT1 data (past its DDS header). */
+	offsets: Uint32Array;
+}
+/** The 2x pictures of one tileset, decoded as they are asked for. */
+export interface HdTiles {
+	file: HdTileFile;
+	/** Source pixels per megatile. */
+	tileSize: number;
+	pages: HTMLCanvasElement[];
+	/** Megatile → slot across the pages, or -1 while it has not been drawn. */
+	slot: Int32Array;
+	used: number;
+	/** One cell's pixels, reused for every decode. */
+	scratch: ImageData | null;
+	/** The tileset's moving water or lava, where the data set has the files for it. */
+	effects?: HdEffects | null;
+}
+/** One picture of a `.dds.grp`: its size, and where its DXT1 blocks start. */
+export interface GrpPicture {
+	width: number;
+	height: number;
+	data: number;
+	/** The blocks' length in bytes — what a compressed upload to the graphics card takes whole. */
+	size: number;
+}
+/** How a tileset's masked ground moves: ripples over water, or shimmer over lava. */
+export type HdEffectKind = "water" | "heat";
+/** A sequence of pictures in one file, for the graphics card: the bytes and where each picture's blocks are. */
+export interface PictureSequence {
+	bytes: Uint8Array;
+	pictures: GrpPicture[];
+}
+/** The textures an effect is read from, shared by every tileset that has it. */
+export interface HdEffectTextures {
+	/** Water: the slow, large ripples and the fine ones over them. */
+	large?: PictureSequence;
+	fine?: PictureSequence;
+	/** Heat: the noise the shimmer follows. */
+	noise?: {
+		width: number;
+		height: number;
+		rgba: Uint8Array;
+	};
+}
+/** Everything the viewport needs to animate a tileset's water or lava. */
+export interface HdEffects {
+	kind: HdEffectKind;
+	/** Megatile → picture number in `masks`, or -1 for ground that stands still. */
+	maskOf: Int32Array;
+	/** The mask pictures, decoded on first use like the tiles: white where the effect is. */
+	masks: HdTiles;
+	textures: HdEffectTextures;
+}
 /**
  * All of a tileset's megatiles rendered once into a single image, so the viewport can
  * draw terrain with one `drawImage` per visible tile instead of decoding minitiles on
@@ -686,6 +743,15 @@ export interface TilesetAtlas {
 	averages: Uint32Array;
 	/** The cycling (water/lava) megatiles, or null when the tileset has none. */
 	animation: AtlasAnimation | null;
+	/**
+	 * StarCraft: Remastered's 2x pictures (`hd.ts`), when View ▸ Remastered Terrain is on
+	 * and the data set has them. `atlasSource` then answers from these, at twice the source
+	 * size, and nothing cycles: Remastered moves water and lava by bending the finished
+	 * picture (`hd.effects`, `viewport/effectPass.ts`), so a megatile here is always the
+	 * still one. `image`, `averages` and `animation` stay the classic ones — the minimap
+	 * and the far zooms use the averages either way.
+	 */
+	hd?: HdTiles | null;
 }
 /**
  * A second, small atlas holding only the megatiles that reference cycling palette
@@ -858,6 +924,18 @@ export interface UnitsDat {
 	groupFlags: Uint8Array;
 	/** StarEdit availability flags; all zero for the legacy layout. */
 	availability: Uint16Array;
+	/**
+	 * The unit's voice, as sfxdata.dat ids (0 for none): the one it says when trained, and
+	 * first–last ranges for a click, repeated clicks and an order. Only the first
+	 * `VOICED_UNITS` have ready / annoyed / yes sounds; every unit has a "what".
+	 */
+	readySound: Uint16Array;
+	whatSoundStart: Uint16Array;
+	whatSoundEnd: Uint16Array;
+	annoyedSoundStart: Uint16Array;
+	annoyedSoundEnd: Uint16Array;
+	yesSoundStart: Uint16Array;
+	yesSoundEnd: Uint16Array;
 }
 export interface FlingyDat {
 	/** sprites.dat index. */
@@ -979,6 +1057,127 @@ export interface LocationPatch {
 	bottom?: number;
 	elevationFlags?: number;
 }
+export interface WireListChange<T> {
+	index: number;
+	before: T | null;
+	after: T | null;
+}
+export interface WireLocationChange {
+	index: number;
+	after: LocationRecord;
+	/** The name as text (`after.nameIndex` is resolved again where it lands); null for none. */
+	name: string | null;
+	/** The slot was empty before: a new location, which moves to a free slot if someone else took this one. */
+	created: boolean;
+}
+/**
+ * One undo step's worth of terrain and objects. The grids are flat number lists: terrain
+ * `[at, mtxm, tile, …]`, the others `[at, value, …]`. `reverse` marks the undo of an edit:
+ * its parts go in the reverse of the usual order, as undo walks them.
+ */
+export interface SyncEditOp {
+	kind: "edit";
+	label: string;
+	/** The map size the cells index; a grid part is skipped on a map of another size. */
+	width: number;
+	height: number;
+	reverse?: boolean;
+	terrain?: number[];
+	isom?: number[];
+	doodadTiles?: number[];
+	fog?: number[];
+	/** The whole ISOM lattice (base64 of the u16 cells) the edit gave the map, or null for taking it away. */
+	isomWhole?: string | null;
+	maskWhole?: string | null;
+	units?: WireListChange<UnitRecord>[];
+	doodads?: WireListChange<DoodadRecord>[];
+	sprites?: WireListChange<SpriteRecord>[];
+	locations?: WireLocationChange[];
+}
+declare const SYNC_FIELDS: readonly [
+	"type",
+	"fileVersion",
+	"nameIndex",
+	"descriptionIndex",
+	"playerTypes",
+	"editorPlayerTypes",
+	"playerRaces",
+	"playerColors",
+	"playerRgb",
+	"forces",
+	"unitSettings",
+	"unitAvailability",
+	"upgradeSettings",
+	"upgradeRestrictions",
+	"techSettings",
+	"techRestrictions",
+	"wavs",
+	"cuwp",
+	"cuwpUsed",
+	"triggers",
+	"briefing",
+	"switchNames"
+];
+export type SyncField = (typeof SYNC_FIELDS)[number];
+export interface SyncFieldsOp {
+	kind: "fields";
+	/** Each changed field's new value, packed (`pack`). */
+	set: Partial<Record<SyncField, unknown>>;
+	/** String slots that changed: `[index, before, after]`. */
+	strings?: [
+		number,
+		string | null,
+		string | null
+	][];
+	/** The table's length afterwards (trailing blank slots are dropped). */
+	stringsLength?: number;
+	/** The table's width and text encoding, when they changed. */
+	stringsFormat?: {
+		extended: boolean;
+		encoding: TextEncoding;
+	};
+}
+export interface SyncExtrasOp {
+	kind: "extras";
+	/** `[member name, base64 bytes]`, or null bytes for a member taken out. */
+	set: [
+		string,
+		string | null
+	][];
+}
+export interface SyncResetOp {
+	kind: "reset";
+	label: string;
+	/** The whole scenario, base64. */
+	chk: string;
+}
+export type SyncOp = SyncEditOp | SyncFieldsOp | SyncExtrasOp | SyncResetOp;
+export type ListField = "triggers" | "briefing";
+export type ValueField = Exclude<SyncField, ListField>;
+export interface StringsFormat {
+	extended: boolean;
+	encoding: TextEncoding;
+}
+export interface Change<T> {
+	before: T;
+	after: T;
+}
+/** What one dialog commit changed, each part with both of its sides. */
+export interface TablesEdit {
+	/** The changed tables as JSON text (`pack`ed). */
+	values?: Partial<Record<ValueField, Change<string>>>;
+	lists?: Partial<Record<ListField, Change<TriggerRecord[]>>>;
+	/** String slots that changed: `[index, before, after]`. */
+	strings?: [
+		number,
+		string | null,
+		string | null
+	][];
+	stringsLength?: Change<number>;
+	stringsFormat?: Change<StringsFormat>;
+	/** The archive's files, when the commit changed them too (the Sound Editor). */
+	extras?: Change<Map<string, Uint8Array>>;
+}
 /** The change lists of one edit; `HistoryEntry` adds the label. */
 export interface HistoryEdit {
 	changes: TileChange[];
@@ -1017,10 +1216,16 @@ export interface HistoryEdit {
 	 * on such a map). Undo removes the section again.
 	 */
 	createdMask?: Uint8Array;
+	/**
+	 * What a dialog wrote — settings, triggers, the briefing, strings (editor/tableHistory.ts).
+	 * An entry with this part has no other: `applyEntry` leaves it alone, and the undo and
+	 * redo atoms apply it with `applyTables`.
+	 */
+	tables?: TablesEdit;
 }
 /**
  * Why the map changed: an edit recorded in the history, an undo or redo of one, a dialog
- * writing its tables (settings, triggers, strings — outside the history), a change to the
+ * writing its tables (settings, triggers, strings), a change to the
  * whole document (resize, tileset change, raw section edit), or other people's edits on a
  * shared map.
  */
@@ -1104,6 +1309,8 @@ export interface ViewFlags {
 	animateWater: boolean;
 	/** Run the units' iscript idle animations (turrets, pulsing buildings, fires, smoke). */
 	animateUnits: boolean;
+	/** Draw terrain and sprites from StarCraft: Remastered's 2x pictures, where the data set in use has them. */
+	hdGraphics: boolean;
 }
 /**
  * A short notice over the map that leaves by itself — what a save says when it is done,
@@ -1217,7 +1424,7 @@ export interface StackedLine {
 	pieces: number;
 }
 /** Every built-in dialog, by the id `openDialogAtom` takes; `DialogHost` maps each to its component. */
-export type DialogId = "newMap" | "openMap" | "saveAs" | "exportImage" | "mapProperties" | "resizeMap" | "mapRevision" | "playerSettings" | "forceSettings" | "playerColors" | "unitSettings" | "upgradeSettings" | "techSettings" | "stringEditor" | "soundEditor" | "switches" | "locationList" | "unitProperties" | "locationProperties" | "spriteProperties" | "triggerEditor" | "missionBriefing" | "cuwpEditor" | "replaceTerrain" | "autoStarts" | "testMap" | "symmetry" | "gridSettings" | "preferences" | "shortcuts" | "validateMap" | "statistics" | "importTriggers" | "exportTriggers" | "importStrings" | "exportStrings" | "find" | "about" | "confirmClose" | "recovery" | "previousVersions" | "plugins" | "confirmPlugin" | "pluginDialog" | "gameData" | "update";
+export type DialogId = "newMap" | "openMap" | "saveAs" | "exportImage" | "mapProperties" | "resizeMap" | "mapRevision" | "playerSettings" | "forceSettings" | "playerColors" | "unitSettings" | "upgradeSettings" | "techSettings" | "stringEditor" | "soundEditor" | "switches" | "locationList" | "unitProperties" | "locationProperties" | "spriteProperties" | "triggerEditor" | "missionBriefing" | "cuwpEditor" | "replaceTerrain" | "autoStarts" | "testMap" | "symmetry" | "gridSettings" | "preferences" | "shortcuts" | "validateMap" | "statistics" | "importTriggers" | "exportTriggers" | "importStrings" | "exportStrings" | "find" | "about" | "confirmClose" | "recovery" | "previousVersions" | "plugins" | "confirmPlugin" | "pluginDialog" | "gameData" | "update" | "whatsNew";
 export interface MapImageOptions {
 	/** Output pixels per map tile. 32 matches the game's art 1:1; 1 is a minimap. */
 	pixelsPerTile: number;
@@ -1854,101 +2061,6 @@ export interface ChangeTilesetResult {
 	spritesDropped: number;
 	refilled: boolean;
 }
-export interface WireListChange<T> {
-	index: number;
-	before: T | null;
-	after: T | null;
-}
-export interface WireLocationChange {
-	index: number;
-	after: LocationRecord;
-	/** The name as text (`after.nameIndex` is resolved again where it lands); null for none. */
-	name: string | null;
-	/** The slot was empty before: a new location, which moves to a free slot if someone else took this one. */
-	created: boolean;
-}
-/**
- * One undo step's worth of terrain and objects. The grids are flat number lists: terrain
- * `[at, mtxm, tile, …]`, the others `[at, value, …]`. `reverse` marks the undo of an edit:
- * its parts go in the reverse of the usual order, as undo walks them.
- */
-export interface SyncEditOp {
-	kind: "edit";
-	label: string;
-	/** The map size the cells index; a grid part is skipped on a map of another size. */
-	width: number;
-	height: number;
-	reverse?: boolean;
-	terrain?: number[];
-	isom?: number[];
-	doodadTiles?: number[];
-	fog?: number[];
-	/** The whole ISOM lattice (base64 of the u16 cells) the edit gave the map, or null for taking it away. */
-	isomWhole?: string | null;
-	maskWhole?: string | null;
-	units?: WireListChange<UnitRecord>[];
-	doodads?: WireListChange<DoodadRecord>[];
-	sprites?: WireListChange<SpriteRecord>[];
-	locations?: WireLocationChange[];
-}
-declare const SYNC_FIELDS: readonly [
-	"type",
-	"fileVersion",
-	"nameIndex",
-	"descriptionIndex",
-	"playerTypes",
-	"editorPlayerTypes",
-	"playerRaces",
-	"playerColors",
-	"playerRgb",
-	"forces",
-	"unitSettings",
-	"unitAvailability",
-	"upgradeSettings",
-	"upgradeRestrictions",
-	"techSettings",
-	"techRestrictions",
-	"wavs",
-	"cuwp",
-	"cuwpUsed",
-	"triggers",
-	"briefing",
-	"switchNames"
-];
-export type SyncField = (typeof SYNC_FIELDS)[number];
-export interface SyncFieldsOp {
-	kind: "fields";
-	/** Each changed field's new value, packed (`pack`). */
-	set: Partial<Record<SyncField, unknown>>;
-	/** String slots that changed: `[index, before, after]`. */
-	strings?: [
-		number,
-		string | null,
-		string | null
-	][];
-	/** The table's length afterwards (trailing blank slots are dropped). */
-	stringsLength?: number;
-	/** The table's width and text encoding, when they changed. */
-	stringsFormat?: {
-		extended: boolean;
-		encoding: TextEncoding;
-	};
-}
-export interface SyncExtrasOp {
-	kind: "extras";
-	/** `[member name, base64 bytes]`, or null bytes for a member taken out. */
-	set: [
-		string,
-		string | null
-	][];
-}
-export interface SyncResetOp {
-	kind: "reset";
-	label: string;
-	/** The whole scenario, base64. */
-	chk: string;
-}
-export type SyncOp = SyncEditOp | SyncFieldsOp | SyncExtrasOp | SyncResetOp;
 export type SymmetryMode = "none" | "h" | "v" | "hv" | "rot180" | "rot90" | "diag" | "adiag";
 export type StartLayout = "ring" | "corners";
 export interface StartPlacementResult {
@@ -2039,6 +2151,25 @@ export type Locale = "en" | "ko";
 export type LanguagePreference = "auto" | Locale;
 /** What `Preferences.hotkeys` holds: the commands the user changed, each with its whole list (`[]` = no keys). */
 export type HotkeyOverrides = Record<string, string[]>;
+/**
+ * The adjustable part of Remastered's moving water and lava (`viewport/effectPass.ts`).
+ * How far the picture bends and how the ripple layers drift are the game's own figures;
+ * how large the ripples lie on the map and how fast their pictures change are not in its
+ * files, so these start from values set by eye and can be moved.
+ */
+export interface RemasteredEffects {
+	/** How far water bends the ground under it, as a multiple of the game's amount. 0 leaves it still. */
+	bend: number;
+	/** How much the ripples catch the light. 0 is none. */
+	glint: number;
+	/** The size of the large, slow ripples and of the fine ones over them, in map pixels a repeat. */
+	large: number;
+	fine: number;
+	/** How many ripple pictures go by a second. */
+	rate: number;
+	/** How far lava's heat reaches, in map pixels at its strongest. 0 leaves it still. */
+	heat: number;
+}
 export interface Preferences {
 	/** The editor's own language: `"auto"` follows the browser's (the system's, in the desktop app), else one of `LOCALES`. Applied live. */
 	language: LanguagePreference;
@@ -2120,6 +2251,10 @@ export interface Preferences {
 	/** Initial View ▸ Animate Water / Animate Units. */
 	animateWater: boolean;
 	animateUnits: boolean;
+	/** Initial View ▸ Remastered Graphics: the 2x terrain and sprites, where the data set in use has them. */
+	hdGraphics: boolean;
+	/** How Remastered's water and lava move — the part of the effect the game's files do not fix. */
+	remasteredEffects: RemasteredEffects;
 	/**
 	 * How fast the two animations run, as a multiple of the game's own speed (1 = the
 	 * game's "Fastest"). One of `ANIMATION_SPEEDS`; applied live, not just at startup.
@@ -2678,16 +2813,16 @@ export interface DocumentApi {
 	 */
 	edit<R>(label: string, build: (tx: EditTransaction) => Sync<R>): EditResult;
 	/**
-	 * The second kind of write: the tables and settings that live outside the undo model
-	 * — triggers, the string table, switch names, the scenario's own properties — as one
-	 * transaction, the way a settings dialog's OK applies its whole form at once.
-	 * Operations apply as they are called; the commit marks the map modified and bumps
-	 * what the chrome reads. There is no undo entry: keep your own if you need one.
+	 * The second kind of write: the tables and settings the dialogs edit — triggers, the
+	 * string table, switch names, the scenario's own properties — as one transaction, the
+	 * way a settings dialog's OK applies its whole form at once. Operations apply as they
+	 * are called; the commit marks the map modified, bumps what the chrome reads and
+	 * records what changed as one undo entry under `label`.
 	 * `build` is synchronous, as `edit`'s is, and closed when it returns.
 	 *
-	 * There is nothing to roll an update back with, so a builder that throws leaves what
-	 * it wrote: the sections it touched are committed — the map is modified and the
-	 * chrome re-reads — and the error reaches you.
+	 * An update is not rolled back, so a builder that throws leaves what it wrote: the
+	 * sections it touched are committed — the map is modified, the chrome re-reads, the
+	 * undo entry holds what was written — and the error reaches you.
 	 *
 	 * @example
 	 * api.document.update("Rename", (tx) => {

package/package.json

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