deck-plugin-sdk 0.16.0 → 0.18.0

package/package.json

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

package/shim/bridge.js

@@ -50,12 +50,18 @@ export const fsWrite = (...a) => b().fsWrite(...a);
 export const fsWriteBytes = (...a) => b().fsWriteBytes(...a);
 export const getAutostart = (...a) => b().getAutostart(...a);
 export const getVaultRoot = (...a) => b().getVaultRoot(...a);
+export const ghPrLineComment = (...a) => b().ghPrLineComment(...a);
+export const ghPrThreads = (...a) => b().ghPrThreads(...a);
+export const ghRun = (...a) => b().ghRun(...a);
+export const ghThreadReply = (...a) => b().ghThreadReply(...a);
+export const ghThreadResolve = (...a) => b().ghThreadResolve(...a);
 export const gitAbortOp = (...a) => b().gitAbortOp(...a);
 export const gitAiCommitMsg = (...a) => b().gitAiCommitMsg(...a);
 export const gitBlameLine = (...a) => b().gitBlameLine(...a);
 export const gitBranchAt = (...a) => b().gitBranchAt(...a);
 export const gitBranchDelete = (...a) => b().gitBranchDelete(...a);
 export const gitBranchDeleteRemote = (...a) => b().gitBranchDeleteRemote(...a);
+export const gitBranchRename = (...a) => b().gitBranchRename(...a);
 export const gitBranches = (...a) => b().gitBranches(...a);
 export const gitCheckout = (...a) => b().gitCheckout(...a);
 export const gitCheckoutDetach = (...a) => b().gitCheckoutDetach(...a);
@@ -65,22 +71,32 @@ export const gitCherryPick = (...a) => b().gitCherryPick(...a);
 export const gitCommit = (...a) => b().gitCommit(...a);
 export const gitCommitAmend = (...a) => b().gitCommitAmend(...a);
 export const gitCommitFiles = (...a) => b().gitCommitFiles(...a);
+export const gitContinueOp = (...a) => b().gitContinueOp(...a);
 export const gitDiscard = (...a) => b().gitDiscard(...a);
 export const gitFetch = (...a) => b().gitFetch(...a);
+export const gitFetchPr = (...a) => b().gitFetchPr(...a);
 export const gitFileBytes = (...a) => b().gitFileBytes(...a);
 export const gitFileDiff = (...a) => b().gitFileDiff(...a);
+export const gitHead = (...a) => b().gitHead(...a);
 export const gitHeadFile = (...a) => b().gitHeadFile(...a);
 export const gitIndexFile = (...a) => b().gitIndexFile(...a);
 export const gitInfo = (...a) => b().gitInfo(...a);
 export const gitLogGraph = (...a) => b().gitLogGraph(...a);
 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 gitPull = (...a) => b().gitPull(...a);
 export const gitPullRebase = (...a) => b().gitPullRebase(...a);
 export const gitPush = (...a) => b().gitPush(...a);
 export const gitPushBranch = (...a) => b().gitPushBranch(...a);
+export const gitRangeFiles = (...a) => b().gitRangeFiles(...a);
+export const gitRangeSubjects = (...a) => b().gitRangeSubjects(...a);
+export const gitRebase = (...a) => b().gitRebase(...a);
 export const gitRefs = (...a) => b().gitRefs(...a);
+export const gitRemoteUrl = (...a) => b().gitRemoteUrl(...a);
 export const gitRemotes = (...a) => b().gitRemotes(...a);
+export const gitRepos = (...a) => b().gitRepos(...a);
 export const gitResetTo = (...a) => b().gitResetTo(...a);
 export const gitRevert = (...a) => b().gitRevert(...a);
 export const gitShowFile = (...a) => b().gitShowFile(...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/template/plugin.json

@@ -4,5 +4,5 @@
   "description": "One line on what this is for, shown under its name in Settings.",
   "icon": "Sparkles",
   "version": "0.1.0",
-  "minDeck": "0.16.0"
+  "minDeck": "0.17.0"
 }

package/types/core/bridge.d.ts

@@ -523,6 +523,8 @@ export declare const removeClaudeMcp: () => Promise<void>;
 export declare const removeClaudeHooks: () => Promise<void>;
 export declare const notifyOs: (title: string, body: string) => Promise<void>;
 export declare const gitStatus: (dir: string) => Promise<GitStatusRow[]>;
+/** The repos a folder holds: the one it is inside first, then any below it. Each a repo's top level. */
+export declare const gitRepos: (dir: string) => Promise<string[]>;
 export interface BlameLine {
     hash: string;
     author: string;
@@ -605,9 +607,37 @@ export declare const gitUndoCommit: (dir: string) => Promise<string>;
 export declare const gitBranchAt: (dir: string, name: string, rev: string) => Promise<string>;
 export declare const gitRevert: (dir: string, rev: string) => Promise<string>;
 export declare const gitCherryPick: (dir: string, rev: string) => Promise<string>;
-export declare const gitResetTo: (dir: string, rev: string, mode: "soft" | "mixed" | "hard") => Promise<string>;
+export declare const gitResetTo: (dir: string, rev: string, mode: "soft" | "mixed" | "hard" | "keep") => Promise<string>;
 export declare const gitTag: (dir: string, name: string, rev: string, message?: string) => Promise<string>;
 export declare const gitMerge: (dir: string, rev: string, noFf?: boolean) => Promise<string>;
+/** Rebase the current branch onto `onto`; a conflict leaves it pending (gitPendingOp → "rebase"). */
+export declare const gitRebase: (dir: string, onto: string) => Promise<string>;
+/** HEAD's commit and branch ("" when detached) — what an undo returns to. */
+export declare const gitHead: (dir: string) => Promise<{
+    hash: string;
+    branch: string;
+}>;
+/** Merge `rev` into the current branch: a merge commit always, fast-forward when possible, or squashed into one commit. */
+export declare const gitMergeAs: (dir: string, rev: string, style: "no-ff" | "ff" | "squash") => Promise<string>;
+/** Finish a merge, rebase, revert or cherry-pick (what gitPendingOp reported) once its conflicts are staged. */
+export declare const gitContinueOp: (dir: string, op: string) => Promise<string>;
+/** Subjects of the commits on `head` that `base` lacks, oldest first. */
+export declare const gitRangeSubjects: (dir: string, base: string, head: string) => Promise<string[]>;
+export declare const gitRemoteUrl: (dir: string, name: string) => Promise<string>;
+/** The GitHub CLI, `gh pr …` or `gh repo view …` only. Rejects with "gh-missing" when gh is not installed. */
+export declare const ghRun: (dir: string, args: string[]) => Promise<string>;
+/** Pull request N's review threads, as GitHub's GraphQL JSON (parsed by prs.ts parseThreads). */
+export declare const ghPrThreads: (dir: string, number: number) => Promise<string>;
+/** Comment on one line of a PR's diff: side "RIGHT" is the new version, "LEFT" the old. */
+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 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>;
+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>;
 export declare const gitBranchDelete: (dir: string, name: string, force?: boolean) => 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.