@scm-js/plugin-api 1.38.0 → 1.40.0

package/index.d.ts

@@ -2029,6 +2029,8 @@ export interface StringImport {
 export type Locale = "en" | "ko";
 /** `"auto"` follows the browser (or the desktop app's system language). */
 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[]>;
 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;
@@ -2155,6 +2157,28 @@ export interface Preferences {
 	plugins: {
 		updates: PluginUpdateMode;
 	};
+	/**
+	 * Preferences ▸ Hotkeys: the commands whose keys the user changed, by command id
+	 * (`editor/commands.ts`), each with its whole list — `[]` leaves it with none. A
+	 * command not here has the keys it ships with.
+	 */
+	hotkeys: HotkeyOverrides;
+	/**
+	 * Which cells the status bar shows (Preferences ▸ View). The message, the symmetry badge
+	 * while a mode is on, and the plugins' items always show.
+	 */
+	statusBar: StatusBarCells;
+}
+/** See `Preferences.statusBar`, in the order the bar draws them. */
+export interface StatusBarCells {
+	tile: boolean;
+	pixel: boolean;
+	tileId: boolean;
+	size: boolean;
+	tileset: boolean;
+	layer: boolean;
+	zoom: boolean;
+	revision: boolean;
 }
 /** See `Preferences.plugins.updates`. */
 export type PluginUpdateMode = "notify" | "manual" | "auto";
@@ -3300,7 +3324,12 @@ export interface TriggerClaimRange {
  * in it — by a hash of the records, say — or null when the records are not there.
  */
 export interface TriggerClaimSpec {
-	/** What generated the run, in words, as a sentence would use it: `"the trigger script"`. */
+	/**
+	 * What generated the run, in words, as a sentence would use it: `"the trigger script"`.
+	 * `label`, `badge` and `openLabel` are given in English and shown through the plugin's
+	 * registered catalogues, so they follow a language change; `api.triggers.claims` hands
+	 * back the English.
+	 */
 	label: string;
 	/** The word on the badge the trigger list shows on each row; the plugin's id by default. */
 	badge?: string;
@@ -4581,7 +4610,7 @@ export type OverlayAbove =
  * it goes away with the plugin.
  */
 export interface OverlaySpec {
-	/** Shown in View ▸ Overlays and the Layers panel. Unique per plugin. */
+	/** Shown in View ▸ Overlays and the Layers panel. Unique per plugin. In English, like a menu label: shown through the plugin's registered catalogues. */
 	name: string;
 	/** Start visible; true by default. What the user last set for this name wins for the session. */
 	visible?: boolean;
@@ -5081,6 +5110,11 @@ export type TopMenu = "File" | "Edit" | "View" | "Layer" | "Scenario" | "Trigger
  */
 export type MenuPath = TopMenu | `${TopMenu}/${string}` | (string & {});
 export interface MenuItemSpec {
+	/**
+	 * In English, like the path's segments: it is the item's identity (another plugin's
+	 * `after` names it), and the menu shows it translated through the catalogues the plugin
+	 * registered with `i18n.register`, so it follows a language change.
+	 */
 	label: string;
 	/** Display only — bind the key with `hotkeys.add`. */
 	shortcut?: string;
@@ -5142,6 +5176,10 @@ export interface ContextMenuContext {
 	markedArea: Rect | null;
 }
 export interface ContextItemSpec {
+	/**
+	 * A fixed label is given in English and shown through the plugin's registered catalogues;
+	 * a function is called when the menu opens, so it translates with `i18n.t` itself.
+	 */
 	label: string | ((ctx: ContextMenuContext) => string);
 	enabled?: (ctx: ContextMenuContext) => boolean;
 	visible?: (ctx: ContextMenuContext) => boolean;

package/package.json

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