deck-plugin-sdk 0.17.0 → 0.18.0

package/package.json

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

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/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.