@brimveyn/aimux-config 0.11.2 → 0.11.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brimveyn/aimux-config",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "description": "TypeScript configuration API for aimux — keymaps, themes, and backends with a fluent builder.",
   "keywords": [
     "aimux",

package/src/actions.ts

@@ -187,6 +187,11 @@ export function focusPane(direction: 'left' | 'right' | 'up' | 'down'): KeyResul
   )
 }
 
+/** Exchanges the active pane with its neighbour; the keyboard goes with it. */
+export function swapPane(direction: 'left' | 'right' | 'up' | 'down'): KeyResult {
+  return r([{ direction, type: 'swap-pane' }])
+}
+
 export function resizePane(delta: number, axis: 'horizontal' | 'vertical'): ActionFn {
   return (ctx: ModeContext) => {
     const tabId = ctx.state.activeTabId

package/src/app-types.ts

@@ -100,6 +100,7 @@ export type ModalType =
   | 'workspace-delete-confirm'
   | 'flash-jump'
   | 'setting-text'
+  | 'setting-keybind'
   | 'settings-search'
   /**
    * Every plugin modal, the way `plugin-view` covers every plugin view. Which
@@ -315,6 +316,13 @@ export interface TabSession {
    * to `TabSessionSummary` if that ever matters.
    */
   role?: 'setup'
+  /**
+   * The qualified id of the plugin command pane this tab is (`<pluginId>.<paneId>`),
+   * when a plugin's `panes[]` or `registerCommand` spawned it. Session-scoped
+   * like every plugin pane: never persisted, never on the wire, so it comes
+   * back from a restart as a plain terminal tab running the same argv.
+   */
+  pluginPane?: string
 }
 
 export type BarSide = 'left' | 'right'
@@ -527,6 +535,15 @@ export interface ModalSettingText extends ModalBase {
   settingId: string
   settingLabel: string
 }
+export interface ModalSettingKeybind extends ModalBase {
+  type: 'setting-keybind'
+  settingId: string
+  settingLabel: string
+  mode: string
+  captured: string[]
+  conflict: string | null
+  returnTo: 'settings'
+}
 
 export interface ModalRenameWorkspace extends ModalBase {
   type: 'rename-workspace'
@@ -738,6 +755,7 @@ export type ModalState =
   | ModalWorkspaceDeleteConfirm
   | ModalFlashJump
   | ModalSettingText
+  | ModalSettingKeybind
   | ModalSettingsSearch
   | ModalPlugin
 
@@ -934,6 +952,7 @@ export type BuiltinModeId =
   | 'modal.rename-tab'
   | 'modal.rename-workspace'
   | 'modal.setting-text'
+  | 'modal.setting-keybind'
   | 'modal.settings-search.filtering'
   | 'modal.snippet-picker.filtering'
   | 'modal.snippet-editor'
@@ -1064,6 +1083,7 @@ export type SideEffect =
   | { type: 'reset-settings-row' }
   | { type: 'confirm-settings-search' }
   | { type: 'commit-setting-text'; settingId: string; value: string }
+  | { type: 'commit-setting-keybind'; settingId: string; value: string }
   | PluginSideEffect
 
 export interface KeyResult {
@@ -1255,6 +1275,11 @@ export type LayoutAction =
       type: 'focus-pane-direction'
       direction: 'left' | 'right' | 'up' | 'down'
     }
+  /** Exchanges the pane holding the keyboard with its neighbour. Focus follows it. */
+  | {
+      type: 'swap-pane'
+      direction: 'left' | 'right' | 'up' | 'down'
+    }
   | {
       type: 'resize-pane'
       tabId: string
@@ -1313,6 +1338,9 @@ export type SettingsAction =
   | { type: 'settings-select-row'; rowIndex: number }
   | { type: 'open-settings-search' }
   | { type: 'open-setting-text-modal'; settingId: string; label: string; value: string }
+  | { type: 'open-setting-keybind-modal'; settingId: string; label: string; mode: string }
+  | { type: 'keybind-capture-push'; chord: string }
+  | { type: 'keybind-capture-pop' }
 
 export type StatsAction =
   | { type: 'enter-stats' }

package/src/index.ts

@@ -35,7 +35,9 @@ export { isAutoCommitEnabled, setAutoCommitEnabled } from './auto-commit-runtime
 export {
   clearPluginActions,
   hasPluginAction,
+  listPluginActions,
   pluginAction,
+  type PluginActionInfo,
   pluginActionNames,
   registerPluginAction,
 } from './plugin-actions-runtime'

package/src/plugin-actions-runtime.ts

@@ -15,25 +15,52 @@ import type { ActionFn, KeyResult, ModeContext } from './types'
  * action factories a config file calls already are.
  */
 
+/** What a palette shows for an action. */
+export interface PluginActionInfo {
+  /** Qualified `<pluginId>.<verb>`. */
+  name: string
+  title?: string
+  description?: string
+}
+
 /** Qualified `<pluginId>.<verb>` — the id a keymap writes. */
 const handlers = new Map<string, ActionFn>()
+const meta = new Map<string, Omit<PluginActionInfo, 'name'>>()
 
-export function registerPluginAction(name: string, handler: ActionFn): () => void {
+export function registerPluginAction(
+  name: string,
+  handler: ActionFn,
+  info: Omit<PluginActionInfo, 'name'> = {}
+): () => void {
   handlers.set(name, handler)
+  meta.set(name, info)
   return () => {
-    if (handlers.get(name) === handler) handlers.delete(name)
+    if (handlers.get(name) !== handler) return
+    handlers.delete(name)
+    meta.delete(name)
   }
 }
 
 /** Test seam. Never called by the app. */
 export function clearPluginActions(): void {
   handlers.clear()
+  meta.clear()
 }
 
 export function pluginActionNames(): string[] {
   return [...handlers.keys()]
 }
 
+/**
+ * Every registered action with whatever it said about itself. The list a
+ * palette is built from: an action without a title is still listed, under
+ * its verb, because hiding it would make "why is my action not in the
+ * palette" a question with no answer.
+ */
+export function listPluginActions(): PluginActionInfo[] {
+  return [...handlers.keys()].map((name) => ({ name, ...meta.get(name) }))
+}
+
 export function hasPluginAction(name: string): boolean {
   return handlers.has(name)
 }

package/src/settings-types.ts

@@ -34,6 +34,7 @@ type SettingKind =
   | { kind: 'number'; min: number; max: number; step: number }
   /** Activating it opens a one-field modal. Empty means "unset", not "empty string". */
   | { kind: 'text'; placeholder?: string }
+  | { kind: 'keybind' }
 
 interface SettingRowBase {
   id: string

package/src/types.ts

@@ -118,6 +118,8 @@ export interface PluginConfigEntry {
   enabled?: boolean
   /** Merged over the manifest defaults and the registry, and wins over both. */
   config?: Record<string, unknown>
+  /** Per-binding overrides keyed by the manifest binding id. `null` unbinds it. */
+  keymaps?: Record<string, string | null>
 }
 
 /** A bare string is shorthand for `{ path }`. */
@@ -340,6 +342,12 @@ export interface AimuxThemeConfig {
 export type AIUsageTool = 'claude' | 'codex' | (string & {})
 
 export interface AIUsageToolConfig {
+  /**
+   * Whether the indicator runs. The same switch as
+   * `plugins: [{ id: 'aimux.ai-usage', enabled }]`, kept because it is the key
+   * the feature had before it was a plugin. Off by default: the service reads
+   * the Claude keychain entry and calls two OAuth endpoints.
+   */
   enabled?: boolean
   pollSeconds?: number
   claudePlan?: 'auto' | 'pro' | 'max5' | 'max20'