@brimveyn/aimux-config 0.1.0

package/src/defaults.ts

@@ -0,0 +1,244 @@
+import type { ResolvedKeymapConfig } from './types'
+
+import * as actions from './actions'
+import { KeymapBuilder } from './keymap-builder'
+
+/**
+ * Build the default keymap — 1:1 transcription of all existing handlers.
+ */
+export function getDefaultKeymapConfig(): ResolvedKeymapConfig {
+  const kb = new KeymapBuilder()
+    .leader('<C-w>')
+    .timeout(300)
+
+    // -----------------------------------------------------------------------
+    // Navigation mode (src/input/modes/handlers/navigation.ts)
+    // -----------------------------------------------------------------------
+    .mode('navigation', (m) =>
+      m
+        .map('<C-c>', actions.quit)
+        .map('<C-n>', actions.newTab)
+        .map('<C-g>', actions.sessionPicker)
+        .map('<C-z>', actions.ctrlZSidebar)
+        .map('dd', actions.closeTab)
+        .map('<C-b>', actions.toggleSidebar)
+        .map('<C-r>', actions.restartTab)
+        .map('<C-s>', actions.snippetPicker)
+        .map('<C-t>', actions.themePicker)
+        .map('<C-h>', actions.resizeSidebar(-2))
+        .map('<C-l>', actions.resizeSidebar(2))
+        .map('G', actions.toggleGitPanel)
+        .map('<C-j>', actions.resizeGitPanel(-0.05))
+        .map('<C-k>', actions.resizeGitPanel(0.05))
+        .map('J', actions.reorderTab(1))
+        .map('j', actions.nextTab)
+        .map('K', actions.reorderTab(-1))
+        .map('k', actions.prevTab)
+        .map('r', actions.renameTab)
+        .map('i', actions.enterInsert)
+        .map('?', actions.helpModal)
+    )
+
+    // -----------------------------------------------------------------------
+    // Terminal-input mode
+    // Bindings here are processed by raw-input-handler.ts before bytes reach
+    // the PTY. Only single-chord <C-*> sequences are supported (no multi-key).
+    // -----------------------------------------------------------------------
+    .mode('terminal-input', (m) =>
+      m
+        .map('<C-z>', actions.leaveTerminalInput)
+        .map('<Leader>', actions.enterLayoutMode)
+        .map('<C-b>', actions.toggleSidebarFromInput)
+    )
+
+    // -----------------------------------------------------------------------
+    // Layout mode (src/input/modes/handlers/layout.ts)
+    // -----------------------------------------------------------------------
+    .mode('layout', (m) =>
+      m
+        .map('<Esc>', actions.exitLayoutToInput)
+        .map('<Leader>', actions.exitLayoutToInput)
+        .map('<C-z>', actions.exitLayoutToNavigation)
+        .map('H', actions.resizePane(-1, 'vertical'))
+        .map('L', actions.resizePane(1, 'vertical'))
+        .map('K', actions.resizePane(-1, 'horizontal'))
+        .map('J', actions.resizePane(1, 'horizontal'))
+        .map('h', actions.focusPane('left'))
+        .map('j', actions.focusPane('down'))
+        .map('k', actions.focusPane('up'))
+        .map('l', actions.focusPane('right'))
+        .map('|', actions.splitVertical)
+        .map('-', actions.splitHorizontal)
+        .map('q', actions.closePane)
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: help (src/input/modes/handlers/modal-help.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.help', (m) => m.map('<Esc>', actions.closeModal))
+
+    // -----------------------------------------------------------------------
+    // Modal: theme-picker (src/input/modes/handlers/modal-theme-picker.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.theme-picker', (m) =>
+      m
+        .map('<Esc>', actions.restoreTheme)
+        .map('j', actions.previewTheme(1))
+        .map('k', actions.previewTheme(-1))
+        .map('<Down>', actions.previewTheme(1))
+        .map('<Up>', actions.previewTheme(-1))
+        .map('<CR>', actions.confirmTheme)
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: rename-tab (src/input/modes/handlers/modal-rename-tab.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.rename-tab', (m) =>
+      m.map('<Esc>', actions.closeModal).map('<CR>', actions.confirmRenameTab).passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: new-tab (src/input/modes/handlers/modal-new-tab.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.new-tab', (m) =>
+      m
+        .map('<Esc>', actions.closeModal)
+        .map('j', actions.moveModalSelection(1))
+        .map('k', actions.moveModalSelection(-1))
+        .map('<Down>', actions.moveModalSelection(1))
+        .map('<Up>', actions.moveModalSelection(-1))
+        .map('<CR>', actions.launchSelectedAssistant)
+        .map('e', actions.beginCommandEdit)
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: new-tab command-edit
+    // (src/input/modes/handlers/modal-new-tab-command-edit.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.new-tab.command-edit', (m) =>
+      m
+        .map('<Esc>', actions.cancelCommandEdit('modal.new-tab'))
+        .map('<CR>', actions.commitCommandEdit)
+        .map('<C-n>', actions.moveModalSelection(1))
+        .map('<C-p>', actions.moveModalSelection(-1))
+        .passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: session-picker (src/input/modes/handlers/modal-session-picker.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.session-picker', (m) =>
+      m
+        .map('<Esc>', actions.sessionPickerEscape)
+        .map('j', actions.moveModalSelection(1))
+        .map('k', actions.moveModalSelection(-1))
+        .map('<Down>', actions.moveModalSelection(1))
+        .map('<Up>', actions.moveModalSelection(-1))
+        .map('<CR>', actions.confirmSelectedSession)
+        .map('n', actions.openCreateSessionModal)
+        .map('r', actions.openRenameSelectedSession)
+        .map('d', actions.deleteSelectedSession)
+        .map('/', actions.beginSessionFilter)
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: session-picker filtering
+    // (src/input/modes/handlers/modal-session-picker-filter.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.session-picker.filtering', (m) =>
+      m
+        .map('<Esc>', actions.cancelCommandEdit('modal.session-picker'))
+        .map('<CR>', actions.confirmSelectedSession)
+        .map('<C-n>', actions.moveModalSelection(1))
+        .map('<C-p>', actions.moveModalSelection(-1))
+        .passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: session-name (src/input/modes/handlers/modal-session-name.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.session-name', (m) =>
+      m
+        .map('<Esc>', actions.backToSessionPicker)
+        .map('<CR>', actions.confirmSessionRename)
+        .passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: create-session
+    // (src/input/modes/handlers/modal-create-session.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.create-session', (m) =>
+      m
+        .map('<Esc>', actions.backToSessionPicker)
+        .map('<Tab>', actions.switchField)
+        .map('<CR>', actions.confirmCreateSession)
+        .map('<C-n>', actions.moveModalSelection(1))
+        .map('<C-p>', actions.moveModalSelection(-1))
+        .passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: snippet-picker
+    // (src/input/modes/handlers/modal-snippet-picker.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.snippet-picker', (m) =>
+      m
+        .map('<Esc>', actions.closeModal)
+        .map('j', actions.moveModalSelection(1))
+        .map('k', actions.moveModalSelection(-1))
+        .map('<Down>', actions.moveModalSelection(1))
+        .map('<Up>', actions.moveModalSelection(-1))
+        .map('<CR>', actions.pasteSelectedSnippet)
+        .map('a', actions.pasteSnippetToGroup)
+        .map('n', actions.openSnippetEditor)
+        .map('r', actions.editSelectedSnippet)
+        .map('e', actions.editSelectedSnippet)
+        .map('d', actions.deleteSelectedSnippet)
+        .map('/', actions.beginSnippetFilter)
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: snippet-picker filtering
+    // (src/input/modes/handlers/modal-snippet-picker-filter.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.snippet-picker.filtering', (m) =>
+      m
+        .map('<Esc>', actions.cancelCommandEdit('modal.snippet-picker'))
+        .map('<CR>', actions.snippetFilterPaste)
+        .map('<C-a>', actions.snippetFilterPasteToGroup)
+        .map('<C-n>', actions.moveModalSelection(1))
+        .map('<C-p>', actions.moveModalSelection(-1))
+        .passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: snippet-editor
+    // (src/input/modes/handlers/modal-snippet-editor.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.snippet-editor', (m) =>
+      m
+        .map('<Esc>', actions.backToSnippetPicker)
+        .map('<Tab>', actions.switchField)
+        .map('<CR>', actions.saveSnippetEditor)
+        .map('<C-n>', actions.moveModalSelection(1))
+        .map('<C-p>', actions.moveModalSelection(-1))
+        .passthrough()
+    )
+
+    // -----------------------------------------------------------------------
+    // Modal: split-picker
+    // (src/input/modes/handlers/modal-split-picker.ts)
+    // -----------------------------------------------------------------------
+    .mode('modal.split-picker', (m) =>
+      m
+        .map('<Esc>', actions.closeModal)
+        .map('j', actions.moveModalSelection(1))
+        .map('k', actions.moveModalSelection(-1))
+        .map('<Down>', actions.moveModalSelection(1))
+        .map('<Up>', actions.moveModalSelection(-1))
+        .map('<CR>', actions.confirmSplit)
+    )
+
+  return kb._build()
+}

package/src/define-config.ts

@@ -0,0 +1,20 @@
+import type { AimuxUserConfig } from './types'
+
+/**
+ * Define an aimux configuration.
+ * This is the entry point for user config files (`~/.config/aimux/aimux.config.ts`).
+ *
+ * ```ts
+ * import { defineConfig, actions } from '@brimveyn/aimux-config'
+ *
+ * export default defineConfig({
+ *   keymaps: (k) => k
+ *     .mode('navigation', (m) => m
+ *       .map('j', actions.nextTab)
+ *       .map('k', actions.prevTab)),
+ * })
+ * ```
+ */
+export function defineConfig(config: AimuxUserConfig): AimuxUserConfig {
+  return config
+}

package/src/index.ts

@@ -0,0 +1,50 @@
+// Public API — this is what users import from '@brimveyn/aimux-config'
+
+export { defineConfig } from './define-config'
+export * as actions from './actions'
+export { THEME_IDS, themes, THEMES } from './themes'
+export { GroupBuilder, KeymapBuilder, ModeBindingBuilder } from './keymap-builder'
+export { getDefaultKeymapConfig } from './defaults'
+export { resolveConfig } from './resolver'
+
+// Type exports
+export type {
+  // Action types
+  Action,
+  ActionFn,
+  // User-facing config
+  AimuxUserConfig,
+  AppAction,
+  AppState,
+  BackendConfig,
+  BindingDef,
+  FocusMode,
+  GroupBuilderApi,
+  HooksConfig,
+  KeyInput,
+  // Keymap builder API (type surface)
+  KeymapBuilderApi,
+  KeyResult,
+  // Layout
+  LayoutNode,
+  ModalState,
+  ModeBindingBuilderApi,
+  ModeContext,
+  // Mode / state
+  ModeId,
+  ModeKeymapDef,
+  // Resolved config (internal, but exported for tooling)
+  ResolvedConfig,
+  ResolvedKeymapConfig,
+  SessionRecord,
+  SidebarConfig,
+  SideEffect,
+  SnippetDef,
+  SnippetRecord,
+  SplitDirection,
+  TabSession,
+  // Themes
+  ThemeColors,
+  ThemeDefinition,
+  ThemeId,
+} from './types'

package/src/keymap-builder.ts

@@ -0,0 +1,112 @@
+import type {
+  Action,
+  BindingDef,
+  GroupBuilderApi,
+  KeymapBuilderApi,
+  ModeBindingBuilderApi,
+  ModeId,
+  ModeKeymapDef,
+  ResolvedKeymapConfig,
+} from './types'
+
+// ---------------------------------------------------------------------------
+// GroupBuilder — sugar for <leader>-prefixed sub-trees
+// ---------------------------------------------------------------------------
+
+export class GroupBuilder implements GroupBuilderApi {
+  readonly bindings: BindingDef[] = []
+
+  constructor(
+    private readonly prefix: string,
+    private readonly groupName: string
+  ) {}
+
+  map(keys: string, action: Action): this {
+    this.bindings.push({ group: this.groupName, keys: `${this.prefix}${keys}`, result: action })
+    return this
+  }
+
+  group(prefix: string, name: string, configure: (g: GroupBuilderApi) => GroupBuilderApi): this {
+    const sub = new GroupBuilder(`${this.prefix}${prefix}`, name)
+    configure(sub)
+    this.bindings.push(...sub.bindings)
+    return this
+  }
+}
+
+// ---------------------------------------------------------------------------
+// ModeBindingBuilder
+// ---------------------------------------------------------------------------
+
+export class ModeBindingBuilder implements ModeBindingBuilderApi {
+  private readonly bindings: BindingDef[] = []
+  private readonly removals: string[] = []
+  private _passthrough = false
+
+  map(keys: string, action: Action): this {
+    this.bindings.push({ keys, result: action })
+    return this
+  }
+
+  unmap(keys: string): this {
+    this.removals.push(keys)
+    return this
+  }
+
+  group(prefix: string, name: string, configure: (g: GroupBuilderApi) => GroupBuilderApi): this {
+    const gb = new GroupBuilder(prefix, name)
+    configure(gb)
+    this.bindings.push(...gb.bindings)
+    return this
+  }
+
+  passthrough(): this {
+    this._passthrough = true
+    return this
+  }
+
+  /** @internal */
+  _build(): ModeKeymapDef {
+    return {
+      bindings: this.bindings,
+      isPassthrough: this._passthrough,
+      removals: this.removals,
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// KeymapBuilder
+// ---------------------------------------------------------------------------
+
+export class KeymapBuilder implements KeymapBuilderApi {
+  private _leader = '<Space>'
+  private _timeout = 300
+  private readonly modes = new Map<ModeId, ModeKeymapDef>()
+
+  leader(key: string): this {
+    this._leader = key
+    return this
+  }
+
+  timeout(ms: number): this {
+    this._timeout = ms
+    return this
+  }
+
+  mode(id: ModeId, configure: (m: ModeBindingBuilderApi) => ModeBindingBuilderApi): this {
+    const builder = new ModeBindingBuilder()
+    configure(builder)
+    this.modes.set(id, builder._build())
+    return this
+  }
+
+  /** @internal — build the resolved config */
+  _build(): ResolvedKeymapConfig {
+    return {
+      leader: this._leader,
+      modes: this.modes,
+      timeout: this._timeout,
+    }
+  }
+}

package/src/resolver.ts

@@ -0,0 +1,76 @@
+import type {
+  AimuxUserConfig,
+  ModeId,
+  ModeKeymapDef,
+  ResolvedConfig,
+  ResolvedKeymapConfig,
+} from './types'
+
+import { getDefaultKeymapConfig } from './defaults'
+import { KeymapBuilder } from './keymap-builder'
+
+/**
+ * Resolve a user config by merging it with defaults.
+ * User bindings override defaults; user unmaps remove defaults.
+ */
+export function resolveConfig(userConfig: AimuxUserConfig): ResolvedConfig {
+  const keymaps = resolveKeymaps(userConfig)
+
+  return {
+    backends: userConfig.backends ?? {},
+    hooks: userConfig.hooks ?? {},
+    keymaps,
+    sidebar: userConfig.sidebar ?? {},
+    snippets: userConfig.snippets ?? [],
+    theme: userConfig.theme,
+  }
+}
+
+function resolveKeymaps(userConfig: AimuxUserConfig): ResolvedKeymapConfig {
+  const defaults = getDefaultKeymapConfig()
+
+  if (!userConfig.keymaps) {
+    return defaults
+  }
+
+  // Run the user's keymaps callback on a fresh builder
+  const userBuilder = new KeymapBuilder()
+  userConfig.keymaps(userBuilder)
+  const userKeymaps = userBuilder._build()
+
+  // Merge: user leader/timeout override defaults
+  const leader = userKeymaps.leader !== '<Space>' ? userKeymaps.leader : defaults.leader
+  const timeout = userKeymaps.timeout !== 300 ? userKeymaps.timeout : defaults.timeout
+
+  // Merge modes: for each mode, user bindings overlay on top of defaults
+  const mergedModes = new Map<ModeId, ModeKeymapDef>(defaults.modes)
+
+  for (const [modeId, userModeDef] of userKeymaps.modes) {
+    const defaultModeDef = defaults.modes.get(modeId)
+
+    if (!defaultModeDef) {
+      // User defines a mode that has no defaults — use as-is
+      mergedModes.set(modeId, userModeDef)
+      continue
+    }
+
+    // Start with default bindings, remove unmaps, then overlay user bindings
+    const removedKeys = new Set(userModeDef.removals)
+    const filteredDefaults = defaultModeDef.bindings.filter((b) => !removedKeys.has(b.keys))
+
+    // Build a map for deduplication: user bindings override same-key defaults
+    const userKeySet = new Set(userModeDef.bindings.map((b) => b.keys))
+    const mergedBindings = [
+      ...filteredDefaults.filter((b) => !userKeySet.has(b.keys)),
+      ...userModeDef.bindings,
+    ]
+
+    mergedModes.set(modeId, {
+      bindings: mergedBindings,
+      isPassthrough: userModeDef.isPassthrough || defaultModeDef.isPassthrough,
+      removals: [],
+    })
+  }
+
+  return { leader, modes: mergedModes, timeout }
+}