@fresh-editor/fresh-editor 0.3.6 → 0.3.7

package/plugins/git_statusbar.i18n.json

@@ -0,0 +1,72 @@
+{
+  "cs": {
+    "status.detecting_branch": "Detekuji větev ...",
+    "status.not_in_git": "Není v git",
+    "status.git_branch": "Git: větev"
+  },
+  "de": {
+    "status.detecting_branch": "Branch erkennen ...",
+    "status.not_in_git": "Nicht in git",
+    "status.git_branch": "Git: Branch"
+  },
+  "en": {
+    "status.detecting_branch": "Detecting branch ...",
+    "status.not_in_git": "Not in git",
+    "status.git_branch": "Git: branch"
+  },
+  "es": {
+    "status.detecting_branch": "Detectando rama ...",
+    "status.not_in_git": "No está en git",
+    "status.git_branch": "Git: rama"
+  },
+  "fr": {
+    "status.detecting_branch": "Détection de la branche ...",
+    "status.not_in_git": "Pas dans git",
+    "status.git_branch": "Git : branche"
+  },
+  "it": {
+    "status.detecting_branch": "Rilevamento branch ...",
+    "status.not_in_git": "Non in git",
+    "status.git_branch": "Git: branch"
+  },
+  "ja": {
+    "status.detecting_branch": "ブランチを検出中...",
+    "status.not_in_git": "git外",
+    "status.git_branch": "Git: ブランチ"
+  },
+  "ko": {
+    "status.detecting_branch": "브랜치 감지 중...",
+    "status.not_in_git": "git 아님",
+    "status.git_branch": "Git: 브랜치"
+  },
+  "pt-BR": {
+    "status.detecting_branch": "Detectando ramo ...",
+    "status.not_in_git": "Não está em git",
+    "status.git_branch": "Git: ramo"
+  },
+  "ru": {
+    "status.detecting_branch": "Определение ветки ...",
+    "status.not_in_git": "Не в git",
+    "status.git_branch": "Git: ветка"
+  },
+  "th": {
+    "status.detecting_branch": "กำลังตรวจจับสาขา ...",
+    "status.not_in_git": "ไม่ได้อยู่ใน git",
+    "status.git_branch": "Git: สาขา"
+  },
+  "uk": {
+    "status.detecting_branch": "Визначення гілки ...",
+    "status.not_in_git": "Не в git",
+    "status.git_branch": "Git: гілка"
+  },
+  "vi": {
+    "status.detecting_branch": "Đang phát hiện nhánh ...",
+    "status.not_in_git": "Không trong git",
+    "status.git_branch": "Git: nhánh"
+  },
+  "zh-CN": {
+    "status.detecting_branch": "正在检测分支...",
+    "status.not_in_git": "不在 git 中",
+    "status.git_branch": "Git: 分支"
+  }
+}

package/plugins/git_statusbar.ts

@@ -0,0 +1,133 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+const editor = getEditor();
+
+const GIT_BRANCH = "branch";
+
+let lastDetectedBranch = editor.t("status.detecting_branch");
+let inFlight: Promise<string> | null = null;
+
+// HEAD-file watcher. Branch changes correspond exactly to mutations of
+// the `HEAD` file inside the relevant git dir (resolved by
+// `git rev-parse --git-path HEAD` so worktrees / submodules / `--git-dir`
+// setups work). When HEAD changes we re-spawn `git rev-parse --abbrev-ref`
+// and push the new value; otherwise we never spawn git on the hot path.
+let headWatchHandle: number | null = null;
+let watchedCwd: string | null = null;
+let watchedHeadPath: string | null = null;
+let ensureWatchInFlight: Promise<void> | null = null;
+
+async function discoverHeadPath(cwd: string): Promise<string | null> {
+  const result = await editor.spawnProcess(
+    "git",
+    ["rev-parse", "--git-path", "HEAD"],
+    cwd,
+  );
+  if (result.exit_code !== 0) return null;
+  const headPath = result.stdout.trim();
+  if (!headPath) return null;
+  // `--git-path` returns a path relative to cwd unless the git dir is
+  // outside (e.g. worktree). Make absolute so notify gets a stable target.
+  return headPath.startsWith("/") ? headPath : `${cwd}/${headPath}`;
+}
+
+async function ensureHeadWatch(): Promise<void> {
+  const cwd = editor.getCwd();
+  if (watchedCwd === cwd && headWatchHandle !== null) return;
+  if (ensureWatchInFlight) return ensureWatchInFlight;
+
+  ensureWatchInFlight = (async () => {
+    try {
+      if (headWatchHandle !== null) {
+        editor.unwatchPath(headWatchHandle);
+        headWatchHandle = null;
+        watchedHeadPath = null;
+      }
+      watchedCwd = cwd;
+      const headPath = await discoverHeadPath(cwd);
+      if (!headPath) return;
+      try {
+        headWatchHandle = await editor.watchPath(headPath, false);
+        watchedHeadPath = headPath;
+      } catch (_e) {
+        // Watch registration failed (path missing, kernel limit). Fall
+        // back to event-driven refresh — getCurrentGitBranch is still
+        // gated by inFlight + the per-event invocation pattern below.
+      }
+    } finally {
+      ensureWatchInFlight = null;
+    }
+  })();
+  return ensureWatchInFlight;
+}
+
+async function getCurrentGitBranch(): Promise<string> {
+  if (inFlight) return inFlight;
+  inFlight = (async () => {
+    try {
+      const cwd = editor.getCwd();
+      const result = await editor.spawnProcess(
+        "git",
+        ["rev-parse", "--abbrev-ref", "HEAD"],
+        cwd,
+      );
+      if (result.exit_code === 0) {
+        const branch = result.stdout.trim();
+        lastDetectedBranch = branch || "HEAD";
+      } else {
+        lastDetectedBranch = editor.t("status.not_in_git");
+      }
+      return lastDetectedBranch;
+    } finally {
+      inFlight = null;
+    }
+  })();
+  return inFlight;
+}
+
+async function refreshForActiveBuffer(): Promise<void> {
+  // Lazy: pick up cwd changes (Orchestrator window switch, etc.) the next
+  // time anything triggers us.
+  ensureHeadWatch();
+  const bufferId = editor.getActiveBufferId();
+  if (bufferId === 0) return;
+  const branch = await getCurrentGitBranch();
+  editor.setStatusBarValue(bufferId, GIT_BRANCH, branch);
+}
+
+editor.registerStatusBarElement(GIT_BRANCH, editor.t("status.git_branch"));
+
+// Refresh the branch label when:
+// - The user switches to a different buffer (the per-buffer value may not
+//   be set yet for that buffer).
+// - A file is freshly opened (same reason).
+// - A file is saved (best-effort UX: the user may have committed via an
+//   external terminal between events; the watchPath below catches actual
+//   HEAD mutations).
+// - The editor regains focus from another window — covers the case of
+//   running `git checkout` in an external terminal while fresh was unfocused.
+//
+// Notably *not* in this list (compared to the legacy version): render_start,
+// cursor_moved, after_insert, after_delete, buffer_deactivated, buffer_closed.
+// None of them can change the current branch, and render_start was being
+// fired ~300/s — see #2009 for the feedback-loop investigation.
+[
+  "buffer_activated",
+  "after_file_open",
+  "after_file_save",
+  "focus_gained",
+].forEach((event) => {
+  editor.on(event, async () => {
+    await refreshForActiveBuffer();
+  });
+});
+
+// path_changed → HEAD file mutated → branch may have changed.
+editor.on("path_changed", async (args) => {
+  if (args.handle !== headWatchHandle) return;
+  await refreshForActiveBuffer();
+});
+
+// Kick off the first detection at load time so the status bar populates
+// before any user event fires.
+refreshForActiveBuffer();

package/plugins/lib/fresh.d.ts

@@ -252,6 +252,10 @@ type ViewportInfo = {
 	*/
 	height: number;
 };
+type ScreenSize = {
+	width: number;
+	height: number;
+};
 type KeyEventPayload = {
 	/**
 	* Key name (e.g. `"a"`, `"escape"`, `"f1"`).
@@ -319,15 +323,18 @@ type ViewTokenWireKind = {
 } | "Newline" | "Space" | "Break" | {
 	"BinaryByte": number;
 };
+type TokenColor = [number, number, number] | string;
 type ViewTokenStyle = {
 	/**
-	* Foreground color as RGB tuple
+	* Foreground color. Either `[r, g, b]` or a named/theme string —
+	* see [`TokenColor`].
 	*/
-	fg: [number, number, number] | null;
+	fg: TokenColor | null;
 	/**
-	* Background color as RGB tuple
+	* Background color. Either `[r, g, b]` or a named/theme string —
+	* see [`TokenColor`].
 	*/
-	bg: [number, number, number] | null;
+	bg: TokenColor | null;
 	/**
 	* Whether to render in bold
 	*/
@@ -336,6 +343,10 @@ type ViewTokenStyle = {
 	* Whether to render in italic
 	*/
 	italic: boolean;
+	/**
+	* Whether to render with underline
+	*/
+	underline: boolean;
 };
 type PromptSuggestion = {
 	/**
@@ -445,6 +456,23 @@ type WindowInfo = {
 	* Absolute project root.
 	*/
 	root: string;
+	/**
+	* Project this session belongs to — the canonical repo
+	* root (or arbitrary directory) the user pointed the
+	* new-session form at. `null` for legacy sessions that
+	* predate the Project Path field. The Orchestrator Open
+	* dialog filters by this so the "this project's sessions"
+	* view is one keystroke away from the all-projects view.
+	*/
+	project_path?: string | null;
+	/**
+	* `true` when the session shares its working tree with
+	* other sessions (worktree-creation was off at session
+	* time, or the session lives in a non-git directory).
+	* Persistence-only field; defaults to `false` and isn't
+	* emitted when false.
+	*/
+	shared_worktree?: boolean;
 };
 type JsDiagnostic = {
 	/**
@@ -629,6 +657,27 @@ type CreateTerminalOptions = {
 	* target session's membership set rather than the active one's.
 	*/
 	windowId?: WindowId;
+	/**
+	* Argv to spawn directly inside the PTY instead of the host's
+	* configured shell. `None` (default) keeps the historical
+	* behaviour: spawn the user's shell and let the caller type into
+	* it via `sendTerminalInput`. `Some([cmd, ...args])` runs that
+	* exact command as the PTY child — no shell middleman, so the
+	* process exits cleanly when the agent does and the
+	* terminal-buffer's `terminal_exit` plugin hook reflects the
+	* agent's real exit status. Used by Orchestrator so a session
+	* with agent `python3` is just python3 in the PTY rather than
+	* bash-running-python3-as-a-subshell-command.
+	*/
+	command?: Array<string>;
+	/**
+	* Tab title for the terminal buffer. Defaults to `command[0]`
+	* (when `command` is set) or `"Terminal N"` (the historical
+	* auto-numbered title). If another terminal in the same window
+	* already uses the requested title, the host appends `" (k)"`
+	* to disambiguate. Empty string is treated the same as `None`.
+	*/
+	title?: string;
 };
 type CursorInfo = {
 	/**
@@ -816,6 +865,15 @@ type WidgetSpec = {
 	focused: boolean;
 	intent: ButtonKind;
 	key?: string | null;
+	/**
+	* When true, the button renders in a muted style, is dropped
+	* from the Tab cycle, and clicks on it are ignored. Use for
+	* actions that aren't currently available against the
+	* surrounding state (e.g. "Archive" on the base session). The
+	* button still occupies its layout cell so the surrounding
+	* row doesn't reshuffle when the disabled flag flips.
+	*/
+	disabled: boolean;
 } | {
 	"kind": "spacer";
 	cols: number;
@@ -923,6 +981,41 @@ type WidgetSpec = {
 	* `LabeledSection` or a flexible row.
 	*/
 	fullWidth: boolean;
+	/**
+	* Optional completion candidates. When non-empty AND
+	* `label` is non-empty (the chrome trigger), the
+	* renderer paints a popup directly under the input,
+	* inside a unified box: the input's normal `╰─...─╯`
+	* bottom border becomes a dimmed `┄` separator, the
+	* labeled section's side borders extend down through
+	* the candidate rows, and a single `╰─...─╯` bottom
+	* closes the whole block. Candidates render left-
+	* aligned with the input's text (the position right
+	* after `[`), with the host-managed selected index
+	* highlighted.
+	*
+	* Smart-key dispatch on a focused Text-with-completions:
+	* Up/Down moves selection (host-internal, no event),
+	* Tab fires `completion_accept` with the selected
+	* candidate, Enter / Escape fire `completion_dismiss`
+	* (the dispatcher's normal "Enter focus-advance / Esc
+	* close panel" only runs once the popup is closed).
+	*
+	* Plugins push candidates in response to the text
+	* widget's `change` event via
+	* `WidgetMutation::SetCompletions`. An empty `items`
+	* closes the popup.
+	*/
+	completions?: Array<string>;
+	/**
+	* How many candidate rows the popup paints at once
+	* when it opens. Excess candidates stay reachable
+	* via Up/Down (host auto-scrolls to keep selection
+	* in view) or the mouse wheel; a thumb glyph paints
+	* in the right edge of the popup whenever there's
+	* more to scroll. `0` (default) falls back to `5`.
+	*/
+	completionsVisibleRows: number;
 	key?: string | null;
 } | {
 	"kind": "labeledSection";
@@ -967,6 +1060,10 @@ type WidgetSpec = {
 	"kind": "raw";
 	entries: Array<TextPropertyEntry>;
 	key?: string | null;
+} | {
+	"kind": "overlay";
+	child: WidgetSpec;
+	key?: string | null;
 };
 type WidgetAction = {
 	"kind": "focusAdvance";
@@ -991,6 +1088,10 @@ type WidgetMutation = {
 	widgetKey: string;
 	value: string;
 	cursorByte?: number | null;
+} | {
+	"kind": "setCompletions";
+	widgetKey: string;
+	items: Array<string>;
 } | {
 	"kind": "setChecked";
 	widgetKey: string;
@@ -1013,6 +1114,18 @@ type WidgetMutation = {
 	widgetKey: string;
 	checked: boolean;
 	keys: Array<string>;
+} | {
+	"kind": "appendTreeNodes";
+	widgetKey: string;
+	newNodes: Array<TreeNode>;
+	newItemKeys: Array<string>;
+} | {
+	"kind": "setRawEntries";
+	widgetKey: string;
+	entries: Array<TextPropertyEntry>;
+} | {
+	"kind": "setFocusKey";
+	widgetKey: string;
 };
 type SearchTakeResult = {
 	/**
@@ -1442,7 +1555,9 @@ interface EditorAPI {
 	* contexts only (e.g. `"tour-active"`, `"review-mode"`), not built-in
 	* editor modes.
 	*/
-	registerCommand(name: string, description: string, handlerName: string, context?: string | null): boolean;
+	registerCommand(name: string, description: string, handlerName: string, context?: string | null, options?: {
+		terminalBypass?: boolean;
+	} | null): boolean;
 	/**
 	* Unregister a command by name
 	*/
@@ -1456,6 +1571,17 @@ interface EditorAPI {
 	*/
 	executeAction(actionName: string): boolean;
 	/**
+	* Register a custom statusbar token.
+	* Token will be named "plugin_name:token_name" where plugin_name is the current plugin.
+	* Returns true if registration succeeded, false if invalid or already registered.
+	*/
+	registerStatusBarElement(tokenName: string, title: string): boolean;
+	/**
+	* Set the value of a status-bar token for a specific buffer.
+	* The full token key sent to the editor is "plugin_name:token_name".
+	*/
+	setStatusBarValue(bufferId: number, tokenName: string, value: string): boolean;
+	/**
 	* Translate a string - reads plugin name from __pluginName__ global
 	* Args is optional - can be omitted, undefined, null, or an object
 	*/
@@ -1502,6 +1628,13 @@ interface EditorAPI {
 	*/
 	getViewport(): ViewportInfo | null;
 	/**
+	* Total terminal dimensions in cells. Unlike `getViewport()`
+	* (which reports the active split, shrunk by any vertical
+	* split layout), this reflects the full terminal — what a
+	* floating overlay sized by `heightPct` actually gets.
+	*/
+	getScreenSize(): ScreenSize;
+	/**
 	* List every split with its active buffer and viewport.
 	* 
 	* Plugins that need to operate on every visible buffer
@@ -1585,6 +1718,27 @@ interface EditorAPI {
 	*/
 	openFileInSplit(splitId: number, path: string, line: number, column: number): boolean;
 	/**
+	* Open `path` as a regular buffer in forced large-file (file-backed)
+	* mode. The file is created (empty) if missing — designed for
+	* buffers that will be filled by a concurrent `spawnProcess` with
+	* `stdoutTo`. Resolves with the new buffer's id, or `null` on
+	* failure.
+	* 
+	* Pair with `refreshBufferFromDisk` to grow the buffer as the
+	* streaming write advances.
+	*/
+	openFileStreaming(path: string): Promise<number | null>;
+	/**
+	* Re-stat the file backing `bufferId` and extend the buffer if the
+	* file has grown. Resolves with the new total byte length, or
+	* `null` if the buffer has no file path or doesn't exist.
+	* 
+	* Used to drive a streaming display: while a `spawnProcess` writes
+	* to a temp file, the plugin polls this on a timer so the buffer
+	* length tracks the file length.
+	*/
+	refreshBufferFromDisk(bufferId: number): Promise<number | null>;
+	/**
 	* Show a buffer in the current split
 	*/
 	showBuffer(bufferId: number): boolean;
@@ -1593,6 +1747,30 @@ interface EditorAPI {
 	*/
 	closeBuffer(bufferId: number): boolean;
 	/**
+	* Close other buffers in split
+	*/
+	closeOtherBuffersInSplit(bufferId: number, splitId: number): boolean;
+	/**
+	* Close all buffers in split
+	*/
+	closeAllBuffersInSplit(splitId: number): boolean;
+	/**
+	* Close buffers to right in split
+	*/
+	closeBuffersToRightInSplit(bufferId: number, splitId: number): boolean;
+	/**
+	* Close buffers to left in split
+	*/
+	closeBuffersToLeftInSplit(bufferId: number, splitId: number): boolean;
+	/**
+	* Move the active tab to the left in the active split
+	*/
+	moveTabToLeft(): boolean;
+	/**
+	* Move the active tab to the right in the active split
+	*/
+	moveTabToRight(): boolean;
+	/**
 	* Start a frame-buffer animation over an arbitrary screen region.
 	* Returns an animation id usable with `cancelAnimation`.
 	*/
@@ -1750,6 +1928,64 @@ interface EditorAPI {
 	*/
 	getUserConfig(): unknown;
 	/**
+	* Declare a boolean config field for the calling plugin.
+	* 
+	* Validates `options` synchronously: the JS call throws if any
+	* unknown key is present or if `default` isn't a boolean. The
+	* Settings UI grows a "Plugin Settings → <plugin>" sub-category
+	* containing a toggle for this field. Returns the current value
+	* (user-set if present, otherwise the declared `default`).
+	*/
+	defineConfigBoolean(name: string, options: {
+		default: boolean;
+		description?: string;
+	}): boolean;
+	/**
+	* Declare an integer config field for the calling plugin. Throws on
+	* invalid options or if the default falls outside `minimum/maximum`.
+	*/
+	defineConfigInteger(name: string, options: {
+		default: number;
+		description?: string;
+		minimum?: number;
+		maximum?: number;
+	}): number;
+	/**
+	* Declare a floating-point number config field. Throws on bad
+	* options or default outside `minimum/maximum`.
+	*/
+	defineConfigNumber(name: string, options: {
+		default: number;
+		description?: string;
+		minimum?: number;
+		maximum?: number;
+	}): number;
+	/**
+	* Declare a free-form string config field.
+	*/
+	defineConfigString(name: string, options: {
+		default: string;
+		description?: string;
+	}): string;
+	/**
+	* Declare an array-of-strings config field (e.g. a list of
+	* patterns). The Settings UI renders this as a list editor.
+	*/
+	defineConfigStringArray(name: string, options: {
+		default: string[];
+		description?: string;
+	}): string[];
+	/**
+	* Get the calling plugin's settings as a JS object.
+	* 
+	* Returns the merged value at `config.plugins.<plugin_name>.settings`.
+	* The shape comes from whatever the plugin declared via
+	* `editor.definePluginConfig(...)` (defaults pre-populated by the
+	* host, user overrides on top from the Settings UI). Returns `null`
+	* if the plugin hasn't declared a schema and has no user-set value.
+	*/
+	getPluginConfig(): unknown;
+	/**
 	* Reload configuration from file
 	*/
 	reloadConfig(): void;
@@ -1972,6 +2208,21 @@ interface EditorAPI {
 	*/
 	clearFolds(bufferId: number): boolean;
 	/**
+	* Publish a set of toggleable fold ranges on the buffer. Same
+	* shape an LSP `foldingRange` response would take. Unlike
+	* `addFold`, this does *not* pre-collapse anything — the
+	* standard fold-toggle keybinding finds the range under the
+	* cursor and collapses or expands it on demand. Replacing call
+	* replaces the prior set.
+	* 
+	* `ranges` is a JS array of objects shaped
+	* `{ startLine, endLine, kind? }` (lines are 0-indexed).
+	* `kind` is one of `"comment"`, `"imports"`, `"region"` per
+	* the LSP spec; omitted/unknown values are accepted as plain
+	* folds.
+	*/
+	setFoldingRanges(bufferId: number, rangesArr: Record<string, unknown>[]): boolean;
+	/**
 	* Add a soft break point for marker-based line wrapping
 	*/
 	addSoftBreak(bufferId: number, namespace: string, position: number, indent: number): boolean;
@@ -2046,6 +2297,13 @@ interface EditorAPI {
 	* theme-key string (e.g. `"editor.line_number_fg"`).  Theme keys
 	* are resolved at render time so the line follows theme changes.
 	* Both default to `null` (no foreground / transparent background).
+	* * `gutterGlyph` — optional single character (any short string)
+	* rendered in the line-number column on this virtual line's
+	* first visual row. Use to mark e.g. a deletion line with "-"
+	* so the indicator sits next to the deleted content instead
+	* of on the following source line.
+	* * `gutterColor` — color for `gutterGlyph`, same shape as
+	* `fg`/`bg`. Falls back to the theme's line-number fg.
 	*/
 	addVirtualLine(bufferId: number, position: number, text: string, options: Record<string, unknown>, above: boolean, namespace: string, priority: number): boolean;
 	/**
@@ -2409,6 +2667,15 @@ interface EditorAPI {
 	*/
 	focusBufferGroupPanel(groupId: number, panelName: string): boolean;
 	/**
+	* Re-point a buffer-group's panel at a different buffer id.
+	* 
+	* Streaming plugins (e.g. git-log) allocate one file-backed
+	* buffer per item and call this on navigation to swap which
+	* buffer the panel displays — instead of mutating a single
+	* shared buffer's contents. Resolves with `true` on success.
+	*/
+	setBufferGroupPanelBuffer(groupId: number, panelName: string, bufferId: number): Promise<boolean>;
+	/**
 	* Set virtual buffer content (takes array of entry objects)
 	* 
 	* Note: entries should be TextPropertyEntry[] - uses manual parsing for HashMap support
@@ -2474,8 +2741,13 @@ interface EditorAPI {
 	unmountFloatingWidget(panelId: number): boolean;
 	/**
 	* Spawn a process (async, returns request_id)
+	* 
+	* Optional 4th argument `stdoutTo: string` pipes the child's stdout
+	* directly into the named file instead of buffering it. The
+	* resolved `SpawnResult.stdout` is empty in that case; the bytes
+	* land on disk for `openFile` to pick up as a file-backed buffer.
 	*/
-	spawnProcess(command: string, args: string[], cwd?: string): ProcessHandle<SpawnResult>;
+	spawnProcess(command: string, args: string[], cwd?: string, stdoutTo?: string): ProcessHandle<SpawnResult>;
 	/**
 	* Spawn a process on the host regardless of the active authority.
 	* 
@@ -2635,6 +2907,33 @@ interface EditorAPI {
 	getPluginApi<K extends keyof FreshPluginRegistry>(name: K): FreshPluginRegistry[K] | null;
 }
 /**
+* Typed overload of `editor.defineConfigEnum`. The macro-generated
+* signature can't express `<E extends string>` propagating from the
+* `values` array into the return type, so it's declared here. Use
+* `as const` on the `values` array to get a literal-union return:
+*
+* ```ts
+* const mode = editor.defineConfigEnum("mode", {
+*   values: ["normal", "insert"] as const,
+*   default: "normal",
+* });
+* mode; // typed as "normal" | "insert"
+* ```
+*
+* Typed overload of `editor.getPluginConfig`. Plugins that declared
+* their fields via `defineConfigX` can pass the shape type explicitly:
+* `editor.getPluginConfig<{ autoEnable: boolean; ... }>()`. Without
+* the generic, falls back to `unknown`.
+*/
+interface EditorAPI {
+	defineConfigEnum<E extends string>(name: string, options: {
+		values: readonly E[];
+		default: NoInfer<E>;
+		description?: string;
+	}): E;
+	getPluginConfig<T = unknown>(): T;
+}
+/**
 * Maps every hook event name to its payload type.
 *
 * Payloads match the flat JSON produced by `hook_args_to_json` on the Rust