@crouton-kit/crouter 0.3.14 → 0.3.15

package/dist/types.d.ts

@@ -53,6 +53,28 @@ export interface AutoUpdateConfig {
     content: AutoUpdateMode;
     interval_hours: number;
 }
+/** One canvas-nav action binding: a `crtr` argv string (templated with
+ *  {id|self|name|manager|subtree}) plus optional confirm gate + menu label.
+ *  `run` of the sentinel `__graph__` toggles the in-pi GRAPH modal instead of
+ *  shelling a command. */
+export interface CanvasBind {
+    run: string;
+    confirm?: boolean;
+    desc?: string;
+}
+/** Canvas-nav config (`canvasNav` in config.json). `prefixBinds` are consumed
+ *  at the tmux alt+c menu layer; `graphBinds` are consumed in-process by the
+ *  canvas-nav pi extension while in GRAPH. Built-in GRAPH keys
+ *  (j/k/h/l/g/G/enter/m/e/x/esc) are reserved — `graphBinds` is strictly
+ *  additive. */
+export interface CanvasNavConfig {
+    /** Fallback pi shortcut for GRAPH toggle when NOT in tmux. Default 'alt+g'. */
+    prefixKey?: string;
+    /** chord key (after alt+c) → action; tmux-menu layer. */
+    prefixBinds: Record<string, CanvasBind>;
+    /** extra raw key in GRAPH → action; pi-extension layer (additive only). */
+    graphBinds: Record<string, CanvasBind>;
+}
 export interface ScopeConfig {
     schema_version: number;
     marketplaces: Record<string, ConfigMarketplaceEntry>;
@@ -60,6 +82,7 @@ export interface ScopeConfig {
     skills: Record<string, ConfigSkillEntry>;
     auto_update: AutoUpdateConfig;
     max_panes_per_window: number;
+    canvasNav: CanvasNavConfig;
 }
 export interface ScopeState {
     marketplaces: Record<string, {
@@ -141,5 +164,10 @@ export declare const AGENTS_DIR = "agents";
 export declare const SCOPE_SKILL_PLUGIN = "_";
 export declare const DEFAULT_MAX_PANES_PER_WINDOW = 3;
 export declare function defaultScopeConfig(): ScopeConfig;
+/** Built-in canvas-nav binds so an absent config still gives the intended UX.
+ *  prefixBinds: g→GRAPH toggle (sentinel), m→focus manager, e→expand to tmux.
+ *  1..9 (focus report N) are generated by the menu layer, not literal entries.
+ *  graphBinds: empty — built-in GRAPH keys are reserved, custom keys add on. */
+export declare function defaultCanvasNavConfig(): CanvasNavConfig;
 export declare function skillConfigKey(plugin: string, name: string): string;
 export declare function defaultScopeState(): ScopeState;

package/dist/types.js

@@ -36,6 +36,22 @@ export function defaultScopeConfig() {
         skills: {},
         auto_update: { crtr: 'notify', content: 'notify', interval_hours: 24 },
         max_panes_per_window: DEFAULT_MAX_PANES_PER_WINDOW,
+        canvasNav: defaultCanvasNavConfig(),
+    };
+}
+/** Built-in canvas-nav binds so an absent config still gives the intended UX.
+ *  prefixBinds: g→GRAPH toggle (sentinel), m→focus manager, e→expand to tmux.
+ *  1..9 (focus report N) are generated by the menu layer, not literal entries.
+ *  graphBinds: empty — built-in GRAPH keys are reserved, custom keys add on. */
+export function defaultCanvasNavConfig() {
+    return {
+        prefixKey: 'alt+g',
+        prefixBinds: {
+            g: { run: '__graph__', desc: 'graph view' },
+            m: { run: 'node focus {manager}', desc: 'focus manager' },
+            e: { run: 'canvas tmux-spread {self}', desc: 'expand to tmux' },
+        },
+        graphBinds: {},
     };
 }
 export function skillConfigKey(plugin, name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "description": "crtr — fast access to skills, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",