deck-plugin-sdk 0.17.0 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deck-plugin-sdk",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Build a plugin for Deck, outside the Deck repository.",
   "type": "module",
   "license": "MIT",

package/shim/bridge.js

@@ -86,6 +86,7 @@ export const gitMerge = (...a) => b().gitMerge(...a);
 export const gitMergeAs = (...a) => b().gitMergeAs(...a);
 export const gitMergeBase = (...a) => b().gitMergeBase(...a);
 export const gitPendingOp = (...a) => b().gitPendingOp(...a);
+export const gitPoll = (...a) => b().gitPoll(...a);
 export const gitPull = (...a) => b().gitPull(...a);
 export const gitPullRebase = (...a) => b().gitPullRebase(...a);
 export const gitPush = (...a) => b().gitPush(...a);
@@ -116,6 +117,8 @@ export const gitTagDeleteRemote = (...a) => b().gitTagDeleteRemote(...a);
 export const gitTagPush = (...a) => b().gitTagPush(...a);
 export const gitUndoCommit = (...a) => b().gitUndoCommit(...a);
 export const gitUnstage = (...a) => b().gitUnstage(...a);
+export const glabApi = (...a) => b().glabApi(...a);
+export const glabRun = (...a) => b().glabRun(...a);
 export const googleAccount = (...a) => b().googleAccount(...a);
 export const googleSignIn = (...a) => b().googleSignIn(...a);
 export const googleSignOut = (...a) => b().googleSignOut(...a);

package/shim/terminals.js

@@ -31,6 +31,7 @@ export const leafIds = (...a) => t().leafIds(...a);
 export const loadLayoutOnce = (...a) => t().loadLayoutOnce(...a);
 export const markAgentStarted = (...a) => t().markAgentStarted(...a);
 export const moveLeaf = (...a) => t().moveLeaf(...a);
+export const moveTabToZone = (...a) => t().moveTabToZone(...a);
 export const moveWorkspace = (...a) => t().moveWorkspace(...a);
 export const moveZone = (...a) => t().moveZone(...a);
 export const mutateLayout = (...a) => t().mutateLayout(...a);
@@ -46,6 +47,7 @@ export const pasteInto = (...a) => t().pasteInto(...a);
 export const publishLayout = (...a) => t().publishLayout(...a);
 export const queueInput = (...a) => t().queueInput(...a);
 export const refit = (...a) => t().refit(...a);
+export const reorderTab = (...a) => t().reorderTab(...a);
 export const restartPane = (...a) => t().restartPane(...a);
 export const sendInput = (...a) => t().sendInput(...a);
 export const setLeafLabel = (...a) => t().setLeafLabel(...a);

package/types/core/bridge.d.ts

@@ -8,6 +8,8 @@ export interface AppProc {
     path: string;
 }
 export declare const configRead: (name: string) => Promise<string>;
+/** Raw bytes rather than a JSON argument: a 13.8MB pinboard parsed as JSON on Deck's UI thread
+ *  held every other command up for 200ms per save (see config_write in config.rs). */
 export declare const configWrite: (name: string, json: string) => Promise<void>;
 export declare const getVaultRoot: () => Promise<string>;
 export declare const setVaultRoot: (path: string) => Promise<void>;
@@ -544,6 +546,11 @@ export interface GitInfo {
     behind: number;
 }
 export declare const gitInfo: (dir: string) => Promise<GitInfo>;
+/** gitStatus and gitInfo in one `git status -b`: what the editor's poll asks for every 3s. */
+export declare const gitPoll: (dir: string) => Promise<{
+    rows: GitStatusRow[];
+    info: GitInfo;
+}>;
 export declare const gitCommit: (dir: string, message: string) => Promise<string>;
 export declare const gitPush: (dir: string) => Promise<string>;
 export declare const gitPull: (dir: string) => Promise<string>;
@@ -632,11 +639,18 @@ export declare const ghPrThreads: (dir: string, number: number) => Promise<strin
 export declare const ghPrLineComment: (dir: string, number: number, commit: string, path: string, line: number, side: "LEFT" | "RIGHT", body: string) => Promise<string>;
 export declare const ghThreadReply: (dir: string, thread: string, body: string) => Promise<string>;
 export declare const ghThreadResolve: (dir: string, thread: string, resolve: boolean) => Promise<string>;
+/** The GitLab CLI, `glab mr …` only. Rejects with "glab-missing" when glab is not installed. */
+export declare const glabRun: (dir: string, args: string[]) => Promise<string>;
+/**
+ * One GitLab REST request about this repo's merge requests (`projects/:id/merge_requests…` or
+ * `user`). `fields` go as strings; `json` values must be objects or arrays.
+ */
+export declare const glabApi: (dir: string, method: "GET" | "POST" | "PUT", path: string, fields?: [string, string][], json?: Record<string, object>) => Promise<string>;
 /** The files that differ between two revisions. */
 export declare const gitRangeFiles: (dir: string, from: string, to: string) => Promise<CommitFile[]>;
 export declare const gitMergeBase: (dir: string, a: string, b: string) => Promise<string>;
-/** Fetch pull request N's head from `remote`, so its commits can be diffed here. */
-export declare const gitFetchPr: (dir: string, remote: string, number: number, base: string) => Promise<string>;
+/** Fetch pull request N's head from `remote`, so its commits can be diffed here. `gitlab`: a merge request's. */
+export declare const gitFetchPr: (dir: string, remote: string, number: number, base: string, gitlab?: boolean) => Promise<string>;
 export declare const gitBranchRename: (dir: string, from: string, to: string) => Promise<string>;
 export declare const gitPendingOp: (dir: string) => Promise<string>;
 export declare const gitAbortOp: (dir: string, op: string) => Promise<string>;

package/types/core/editorsettings.d.ts

@@ -52,7 +52,12 @@ export interface EditorSettings {
     theme: "deck-dark" | "vs-dark" | "hc-black";
     iconTheme: string;
     diffSideBySide: boolean;
+    /** The git graph's commit list, in px. Its own setting rather than `fontSize`: that is a
+     *  monospace code font, and the size someone wants for code is not the one for a commit list. */
+    graphFontSize: number;
 }
+/** The sizes the git graph offers — the Settings list and the Ctrl+wheel steps are the same. */
+export declare const GRAPH_FONT_SIZES: number[];
 export declare const DEFAULT_EDITOR_SETTINGS: EditorSettings;
 export declare function updateEditorSettings(patch: Partial<EditorSettings>): void;
 export declare function getEditorSettings(): EditorSettings;

package/types/core/keys.d.ts

@@ -10,7 +10,7 @@
  * It is also what lets two bindings share a chord honestly — the editor's save and a terminal
  * action can both be Ctrl+S if the two surfaces never have the keyboard at the same time.
  */
-export type Scope = "app" | "workspaces" | "editor" | "http" | "terminal" | `plugin:${string}`;
+export type Scope = "app" | "workspaces" | "editor" | "http" | "terminal" | "graph" | "graph-visible" | `plugin:${string}`;
 /** Which thing owns the chord. Absent means a plain window listener. */
 export type Surface = "monaco" | "xterm" | "codemirror";
 export interface KeyBinding {

package/types/core/keystore.d.ts

@@ -20,19 +20,32 @@ export declare function resetOverrides(): Promise<void>;
 export declare function useKeybindings(): number;
 /** The chord in force for a binding, for a label or a tooltip. */
 export declare function chordFor(id: string): string;
+/**
+ * An action, or an action with a `when` guard.
+ *
+ * `when` is how an action says "not here, not now" BEFORE the key is taken. The tree's Ctrl+C is
+ * the case it exists for: it only means something with focus in the file tree, and everywhere
+ * else Ctrl+C has to stay the text box's, Monaco's or the shell's. An action that simply did
+ * nothing was not enough — the key had already been claimed, so the browser's copy was cancelled
+ * and a focused terminal had swallowed it, and copy and paste broke across the whole window
+ * whenever the Editor was open.
+ */
+export type KeyAction = (() => void) | {
+    run: () => void;
+    when: () => boolean;
+};
 /** Register one action. Returns a disposer; call it on unmount. */
-export declare function onKey(id: string, run: () => void): () => void;
+export declare function onKey(id: string, run: () => void, when?: () => boolean): () => void;
 /** Register several at once — what a module with a dozen chords wants. */
-export declare function onKeys(map: Record<string, () => void>): () => void;
+export declare function onKeys(map: Record<string, KeyAction>): () => void;
 /** Claim a scope. Returns a disposer. */
 export declare function pushScope(scope: Scope): () => void;
 export declare function activeScopes(): ReadonlySet<Scope>;
 /**
  * Run whatever this event is bound to, and say whether anything did.
  *
- * The caller decides about preventDefault — this cannot, because some bindings want the default
- * suppressed (the palette) and some do not (a chord whose action declines to act, like Ctrl+7
- * with only three projects open).
+ * The caller preventDefaults only when this says something ran, so a chord nobody is listening
+ * for, or whose action's `when` declines, keeps its ordinary meaning.
  */
 export declare function dispatch(e: KeyboardEvent): boolean;
 /**

package/types/core/terminals.d.ts

@@ -112,6 +112,22 @@ export declare function moveZone(tabs: readonly LayoutTab[], id: string, to: {
     x: number;
     y: number;
 }): LayoutTab[];
+/**
+ * Move a tab to just before or after another — the order a zone's strip shows its tabs in, which
+ * is their order in the list.
+ *
+ * Every tab's cell is pinned first (placeAll): a tab with no stored position takes its cell from
+ * its index, so reordering the list could otherwise move a zone you never touched.
+ */
+export declare function reorderTab(tabs: readonly LayoutTab[], srcId: string, overId: string, after: boolean): LayoutTab[];
+/**
+ * Move one tab to another zone's cell — joining the zone there as the tab it shows, or making a
+ * new zone in an empty cell. The zone it left keeps its other tabs.
+ */
+export declare function moveTabToZone(tabs: readonly LayoutTab[], tabId: string, to: {
+    x: number;
+    y: number;
+}): LayoutTab[];
 /**
  * Add a tab to the zone holding `besideId`, as the tab it shows.
  *
@@ -239,7 +255,7 @@ export declare function isWorkspaceActive(ws: LayoutWorkspace): boolean;
 /**
  * Mark a pane as running an agent right now, without waiting for the sweep.
  *
- * agentPanes is refreshed from Rust every 45s, which is the right cadence for noticing an agent
+ * agentPanes is refreshed from Rust every 10s, which is the right cadence for noticing an agent
  * that EXITED but far too slow for one we just started ourselves — the menu would keep offering
  * to start a second one for most of a minute. The next sweep confirms it, or clears it if the
  * command never took.