shortcutxl 0.2.12 → 0.2.13

package/agent-docs/examples/extensions/dirty-repo-guard.ts

@@ -1,56 +1,56 @@
-/**
- * Dirty Repo Guard Extension
- *
- * Prevents session changes when there are uncommitted git changes.
- * Useful to ensure work is committed before switching context.
- */
-
-import type { ExtensionAPI, ExtensionContext } from 'shortcutxl';
-
-async function checkDirtyRepo(
-  shortcut: ExtensionAPI,
-  ctx: ExtensionContext,
-  action: string
-): Promise<{ cancel: boolean } | undefined> {
-  // Check for uncommitted changes
-  const { stdout, code } = await shortcut.exec('git', ['status', '--porcelain']);
-
-  if (code !== 0) {
-    // Not a git repo, allow the action
-    return;
-  }
-
-  const hasChanges = stdout.trim().length > 0;
-  if (!hasChanges) {
-    return;
-  }
-
-  if (!ctx.hasUI) {
-    // In non-interactive mode, block by default
-    return { cancel: true };
-  }
-
-  // Count changed files
-  const changedFiles = stdout.trim().split('\n').filter(Boolean).length;
-
-  const choice = await ctx.ui.select(
-    `You have ${changedFiles} uncommitted file(s). ${action} anyway?`,
-    ['Yes, proceed anyway', 'No, let me commit first']
-  );
-
-  if (choice !== 'Yes, proceed anyway') {
-    ctx.ui.notify('Commit your changes first', 'warning');
-    return { cancel: true };
-  }
-}
-
-export default function (shortcut: ExtensionAPI) {
-  shortcut.on('session_before_switch', async (event, ctx) => {
-    const action = event.reason === 'new' ? 'new session' : 'switch session';
-    return checkDirtyRepo(shortcut, ctx, action);
-  });
-
-  shortcut.on('session_before_fork', async (_event, ctx) => {
-    return checkDirtyRepo(shortcut, ctx, 'fork');
-  });
-}
+/**
+ * Dirty Repo Guard Extension
+ *
+ * Prevents session changes when there are uncommitted git changes.
+ * Useful to ensure work is committed before switching context.
+ */
+
+import type { ExtensionAPI, ExtensionContext } from 'shortcutxl';
+
+async function checkDirtyRepo(
+  shortcut: ExtensionAPI,
+  ctx: ExtensionContext,
+  action: string
+): Promise<{ cancel: boolean } | undefined> {
+  // Check for uncommitted changes
+  const { stdout, code } = await shortcut.exec('git', ['status', '--porcelain']);
+
+  if (code !== 0) {
+    // Not a git repo, allow the action
+    return;
+  }
+
+  const hasChanges = stdout.trim().length > 0;
+  if (!hasChanges) {
+    return;
+  }
+
+  if (!ctx.hasUI) {
+    // In non-interactive mode, block by default
+    return { cancel: true };
+  }
+
+  // Count changed files
+  const changedFiles = stdout.trim().split('\n').filter(Boolean).length;
+
+  const choice = await ctx.ui.select(
+    `You have ${changedFiles} uncommitted file(s). ${action} anyway?`,
+    ['Yes, proceed anyway', 'No, let me commit first']
+  );
+
+  if (choice !== 'Yes, proceed anyway') {
+    ctx.ui.notify('Commit your changes first', 'warning');
+    return { cancel: true };
+  }
+}
+
+export default function (shortcut: ExtensionAPI) {
+  shortcut.on('session_before_switch', async (event, ctx) => {
+    const action = event.reason === 'new' ? 'new session' : 'switch session';
+    return checkDirtyRepo(shortcut, ctx, action);
+  });
+
+  shortcut.on('session_before_fork', async (_event, ctx) => {
+    return checkDirtyRepo(shortcut, ctx, 'fork');
+  });
+}

package/agent-docs/examples/extensions/doom-overlay/doom-component.ts

@@ -1,133 +1,133 @@
-/**
- * DOOM Component for overlay mode
- *
- * Renders DOOM frames using half-block characters (▀) with 24-bit color.
- * Height is calculated from width to maintain DOOM's aspect ratio.
- */
-
-import type { Component } from 'shortcutxl';
-import { isKeyRelease, type TUI } from 'shortcutxl';
-import type { DoomEngine } from './doom-engine.js';
-import { DoomKeys, mapKeyToDoom } from './doom-keys.js';
-
-function renderHalfBlock(
-  rgba: Uint8Array,
-  width: number,
-  height: number,
-  targetCols: number,
-  targetRows: number
-): string[] {
-  const lines: string[] = [];
-  const scaleX = width / targetCols;
-  const scaleY = height / (targetRows * 2);
-
-  for (let row = 0; row < targetRows; row++) {
-    let line = '';
-    const srcY1 = Math.floor(row * 2 * scaleY);
-    const srcY2 = Math.floor((row * 2 + 1) * scaleY);
-
-    for (let col = 0; col < targetCols; col++) {
-      const srcX = Math.floor(col * scaleX);
-      const idx1 = (srcY1 * width + srcX) * 4;
-      const idx2 = (srcY2 * width + srcX) * 4;
-      const r1 = rgba[idx1] ?? 0,
-        g1 = rgba[idx1 + 1] ?? 0,
-        b1 = rgba[idx1 + 2] ?? 0;
-      const r2 = rgba[idx2] ?? 0,
-        g2 = rgba[idx2 + 1] ?? 0,
-        b2 = rgba[idx2 + 2] ?? 0;
-      line += `\x1b[38;2;${r1};${g1};${b1}m\x1b[48;2;${r2};${g2};${b2}m▀`;
-    }
-    line += '\x1b[0m';
-    lines.push(line);
-  }
-  return lines;
-}
-
-export class DoomOverlayComponent implements Component {
-  private engine: DoomEngine;
-  private tui: TUI;
-  private interval: ReturnType<typeof setInterval> | null = null;
-  private onExit: () => void;
-
-  // Opt-in to key release events for smooth movement
-  wantsKeyRelease = true;
-
-  constructor(tui: TUI, engine: DoomEngine, onExit: () => void, resume = false) {
-    this.tui = tui;
-    this.engine = engine;
-    this.onExit = onExit;
-
-    // Unpause if resuming
-    if (resume) {
-      this.engine.pushKey(true, DoomKeys.KEY_PAUSE);
-      this.engine.pushKey(false, DoomKeys.KEY_PAUSE);
-    }
-
-    this.startGameLoop();
-  }
-
-  private startGameLoop(): void {
-    this.interval = setInterval(() => {
-      try {
-        this.engine.tick();
-        this.tui.requestRender();
-      } catch {
-        // WASM error (e.g., exit via DOOM menu) - treat as quit
-        this.dispose();
-        this.onExit();
-      }
-    }, 1000 / 35);
-  }
-
-  handleInput(data: string): void {
-    // Q to pause and exit (but not on release)
-    if (!isKeyRelease(data) && (data === 'q' || data === 'Q')) {
-      // Send DOOM's pause key before exiting
-      this.engine.pushKey(true, DoomKeys.KEY_PAUSE);
-      this.engine.pushKey(false, DoomKeys.KEY_PAUSE);
-      this.dispose();
-      this.onExit();
-      return;
-    }
-
-    const doomKeys = mapKeyToDoom(data);
-    if (doomKeys.length === 0) return;
-
-    const released = isKeyRelease(data);
-
-    for (const key of doomKeys) {
-      this.engine.pushKey(!released, key);
-    }
-  }
-
-  render(width: number): string[] {
-    // DOOM renders at 640x400 (1.6:1 ratio)
-    // With half-block characters, each terminal row = 2 pixels
-    // So effective ratio is 640:200 = 3.2:1 (width:height in terminal cells)
-    // Add 1 row for footer
-    const ASPECT_RATIO = 3.2;
-    const MIN_HEIGHT = 10;
-    const height = Math.max(MIN_HEIGHT, Math.floor(width / ASPECT_RATIO));
-
-    const rgba = this.engine.getFrameRGBA();
-    const lines = renderHalfBlock(rgba, this.engine.width, this.engine.height, width, height);
-
-    // Footer
-    const footer =
-      ' DOOM | Q=Pause | WASD=Move | Shift+WASD=Run | Space=Use | F=Fire | 1-7=Weapons';
-    const truncatedFooter = footer.length > width ? footer.slice(0, width) : footer;
-    lines.push(`\x1b[2m${truncatedFooter}\x1b[0m`);
-
-    return lines;
-  }
-
-  invalidate(): void {}
-
-  dispose(): void {
-    if (this.interval) {
-      clearInterval(this.interval);
-      this.interval = null;
-    }
-  }
-}
+/**
+ * DOOM Component for overlay mode
+ *
+ * Renders DOOM frames using half-block characters (▀) with 24-bit color.
+ * Height is calculated from width to maintain DOOM's aspect ratio.
+ */
+
+import type { Component } from 'shortcutxl';
+import { isKeyRelease, type TUI } from 'shortcutxl';
+import type { DoomEngine } from './doom-engine.js';
+import { DoomKeys, mapKeyToDoom } from './doom-keys.js';
+
+function renderHalfBlock(
+  rgba: Uint8Array,
+  width: number,
+  height: number,
+  targetCols: number,
+  targetRows: number
+): string[] {
+  const lines: string[] = [];
+  const scaleX = width / targetCols;
+  const scaleY = height / (targetRows * 2);
+
+  for (let row = 0; row < targetRows; row++) {
+    let line = '';
+    const srcY1 = Math.floor(row * 2 * scaleY);
+    const srcY2 = Math.floor((row * 2 + 1) * scaleY);
+
+    for (let col = 0; col < targetCols; col++) {
+      const srcX = Math.floor(col * scaleX);
+      const idx1 = (srcY1 * width + srcX) * 4;
+      const idx2 = (srcY2 * width + srcX) * 4;
+      const r1 = rgba[idx1] ?? 0,
+        g1 = rgba[idx1 + 1] ?? 0,
+        b1 = rgba[idx1 + 2] ?? 0;
+      const r2 = rgba[idx2] ?? 0,
+        g2 = rgba[idx2 + 1] ?? 0,
+        b2 = rgba[idx2 + 2] ?? 0;
+      line += `\x1b[38;2;${r1};${g1};${b1}m\x1b[48;2;${r2};${g2};${b2}m▀`;
+    }
+    line += '\x1b[0m';
+    lines.push(line);
+  }
+  return lines;
+}
+
+export class DoomOverlayComponent implements Component {
+  private engine: DoomEngine;
+  private tui: TUI;
+  private interval: ReturnType<typeof setInterval> | null = null;
+  private onExit: () => void;
+
+  // Opt-in to key release events for smooth movement
+  wantsKeyRelease = true;
+
+  constructor(tui: TUI, engine: DoomEngine, onExit: () => void, resume = false) {
+    this.tui = tui;
+    this.engine = engine;
+    this.onExit = onExit;
+
+    // Unpause if resuming
+    if (resume) {
+      this.engine.pushKey(true, DoomKeys.KEY_PAUSE);
+      this.engine.pushKey(false, DoomKeys.KEY_PAUSE);
+    }
+
+    this.startGameLoop();
+  }
+
+  private startGameLoop(): void {
+    this.interval = setInterval(() => {
+      try {
+        this.engine.tick();
+        this.tui.requestRender();
+      } catch {
+        // WASM error (e.g., exit via DOOM menu) - treat as quit
+        this.dispose();
+        this.onExit();
+      }
+    }, 1000 / 35);
+  }
+
+  handleInput(data: string): void {
+    // Q to pause and exit (but not on release)
+    if (!isKeyRelease(data) && (data === 'q' || data === 'Q')) {
+      // Send DOOM's pause key before exiting
+      this.engine.pushKey(true, DoomKeys.KEY_PAUSE);
+      this.engine.pushKey(false, DoomKeys.KEY_PAUSE);
+      this.dispose();
+      this.onExit();
+      return;
+    }
+
+    const doomKeys = mapKeyToDoom(data);
+    if (doomKeys.length === 0) return;
+
+    const released = isKeyRelease(data);
+
+    for (const key of doomKeys) {
+      this.engine.pushKey(!released, key);
+    }
+  }
+
+  render(width: number): string[] {
+    // DOOM renders at 640x400 (1.6:1 ratio)
+    // With half-block characters, each terminal row = 2 pixels
+    // So effective ratio is 640:200 = 3.2:1 (width:height in terminal cells)
+    // Add 1 row for footer
+    const ASPECT_RATIO = 3.2;
+    const MIN_HEIGHT = 10;
+    const height = Math.max(MIN_HEIGHT, Math.floor(width / ASPECT_RATIO));
+
+    const rgba = this.engine.getFrameRGBA();
+    const lines = renderHalfBlock(rgba, this.engine.width, this.engine.height, width, height);
+
+    // Footer
+    const footer =
+      ' DOOM | Q=Pause | WASD=Move | Shift+WASD=Run | Space=Use | F=Fire | 1-7=Weapons';
+    const truncatedFooter = footer.length > width ? footer.slice(0, width) : footer;
+    lines.push(`\x1b[2m${truncatedFooter}\x1b[0m`);
+
+    return lines;
+  }
+
+  invalidate(): void {}
+
+  dispose(): void {
+    if (this.interval) {
+      clearInterval(this.interval);
+      this.interval = null;
+    }
+  }
+}

package/agent-docs/examples/extensions/doom-overlay/doom-keys.ts

@@ -1,108 +1,108 @@
-/**
- * DOOM key codes (from doomkeys.h)
- */
-export const DoomKeys = {
-  KEY_RIGHTARROW: 0xae,
-  KEY_LEFTARROW: 0xac,
-  KEY_UPARROW: 0xad,
-  KEY_DOWNARROW: 0xaf,
-  KEY_STRAFE_L: 0xa0,
-  KEY_STRAFE_R: 0xa1,
-  KEY_USE: 0xa2,
-  KEY_FIRE: 0xa3,
-  KEY_ESCAPE: 27,
-  KEY_ENTER: 13,
-  KEY_TAB: 9,
-  KEY_F1: 0x80 + 0x3b,
-  KEY_F2: 0x80 + 0x3c,
-  KEY_F3: 0x80 + 0x3d,
-  KEY_F4: 0x80 + 0x3e,
-  KEY_F5: 0x80 + 0x3f,
-  KEY_F6: 0x80 + 0x40,
-  KEY_F7: 0x80 + 0x41,
-  KEY_F8: 0x80 + 0x42,
-  KEY_F9: 0x80 + 0x43,
-  KEY_F10: 0x80 + 0x44,
-  KEY_F11: 0x80 + 0x57,
-  KEY_F12: 0x80 + 0x58,
-  KEY_BACKSPACE: 127,
-  KEY_PAUSE: 0xff,
-  KEY_EQUALS: 0x3d,
-  KEY_MINUS: 0x2d,
-  KEY_RSHIFT: 0x80 + 0x36,
-  KEY_RCTRL: 0x80 + 0x1d,
-  KEY_RALT: 0x80 + 0x38
-} as const;
-
-import { Key, matchesKey, parseKey } from 'shortcutxl';
-
-/**
- * Map terminal key input to DOOM key codes
- * Supports both raw terminal input and Kitty protocol sequences
- */
-export function mapKeyToDoom(data: string): number[] {
-  // Arrow keys
-  if (matchesKey(data, Key.up)) return [DoomKeys.KEY_UPARROW];
-  if (matchesKey(data, Key.down)) return [DoomKeys.KEY_DOWNARROW];
-  if (matchesKey(data, Key.right)) return [DoomKeys.KEY_RIGHTARROW];
-  if (matchesKey(data, Key.left)) return [DoomKeys.KEY_LEFTARROW];
-
-  // WASD - check both raw char and Kitty sequences
-  if (data === 'w' || matchesKey(data, 'w')) return [DoomKeys.KEY_UPARROW];
-  if (data === 'W' || matchesKey(data, Key.shift('w')))
-    return [DoomKeys.KEY_UPARROW, DoomKeys.KEY_RSHIFT];
-  if (data === 's' || matchesKey(data, 's')) return [DoomKeys.KEY_DOWNARROW];
-  if (data === 'S' || matchesKey(data, Key.shift('s')))
-    return [DoomKeys.KEY_DOWNARROW, DoomKeys.KEY_RSHIFT];
-  if (data === 'a' || matchesKey(data, 'a')) return [DoomKeys.KEY_STRAFE_L];
-  if (data === 'A' || matchesKey(data, Key.shift('a')))
-    return [DoomKeys.KEY_STRAFE_L, DoomKeys.KEY_RSHIFT];
-  if (data === 'd' || matchesKey(data, 'd')) return [DoomKeys.KEY_STRAFE_R];
-  if (data === 'D' || matchesKey(data, Key.shift('d')))
-    return [DoomKeys.KEY_STRAFE_R, DoomKeys.KEY_RSHIFT];
-
-  // Fire - F key
-  if (data === 'f' || data === 'F' || matchesKey(data, 'f') || matchesKey(data, Key.shift('f'))) {
-    return [DoomKeys.KEY_FIRE];
-  }
-
-  // Use/Open
-  if (data === ' ' || matchesKey(data, Key.space)) return [DoomKeys.KEY_USE];
-
-  // Menu/UI keys
-  if (matchesKey(data, Key.enter)) return [DoomKeys.KEY_ENTER];
-  if (matchesKey(data, Key.escape)) return [DoomKeys.KEY_ESCAPE];
-  if (matchesKey(data, Key.tab)) return [DoomKeys.KEY_TAB];
-  if (matchesKey(data, Key.backspace)) return [DoomKeys.KEY_BACKSPACE];
-
-  // Ctrl keys (except Ctrl+C) = fire (legacy support)
-  const parsed = parseKey(data);
-  if (parsed?.startsWith('ctrl+') && parsed !== 'ctrl+c') {
-    return [DoomKeys.KEY_FIRE];
-  }
-  if (data.length === 1 && data.charCodeAt(0) < 32 && data !== '\x03') {
-    return [DoomKeys.KEY_FIRE];
-  }
-
-  // Weapon selection (0-9)
-  if (data >= '0' && data <= '9') return [data.charCodeAt(0)];
-
-  // Plus/minus for screen size
-  if (data === '+' || data === '=') return [DoomKeys.KEY_EQUALS];
-  if (data === '-') return [DoomKeys.KEY_MINUS];
-
-  // Y/N for prompts
-  if (data === 'y' || data === 'Y' || matchesKey(data, 'y') || matchesKey(data, Key.shift('y'))) {
-    return ['y'.charCodeAt(0)];
-  }
-  if (data === 'n' || data === 'N' || matchesKey(data, 'n') || matchesKey(data, Key.shift('n'))) {
-    return ['n'.charCodeAt(0)];
-  }
-
-  // Other printable characters (for cheats)
-  if (data.length === 1 && data.charCodeAt(0) >= 32) {
-    return [data.toLowerCase().charCodeAt(0)];
-  }
-
-  return [];
-}
+/**
+ * DOOM key codes (from doomkeys.h)
+ */
+export const DoomKeys = {
+  KEY_RIGHTARROW: 0xae,
+  KEY_LEFTARROW: 0xac,
+  KEY_UPARROW: 0xad,
+  KEY_DOWNARROW: 0xaf,
+  KEY_STRAFE_L: 0xa0,
+  KEY_STRAFE_R: 0xa1,
+  KEY_USE: 0xa2,
+  KEY_FIRE: 0xa3,
+  KEY_ESCAPE: 27,
+  KEY_ENTER: 13,
+  KEY_TAB: 9,
+  KEY_F1: 0x80 + 0x3b,
+  KEY_F2: 0x80 + 0x3c,
+  KEY_F3: 0x80 + 0x3d,
+  KEY_F4: 0x80 + 0x3e,
+  KEY_F5: 0x80 + 0x3f,
+  KEY_F6: 0x80 + 0x40,
+  KEY_F7: 0x80 + 0x41,
+  KEY_F8: 0x80 + 0x42,
+  KEY_F9: 0x80 + 0x43,
+  KEY_F10: 0x80 + 0x44,
+  KEY_F11: 0x80 + 0x57,
+  KEY_F12: 0x80 + 0x58,
+  KEY_BACKSPACE: 127,
+  KEY_PAUSE: 0xff,
+  KEY_EQUALS: 0x3d,
+  KEY_MINUS: 0x2d,
+  KEY_RSHIFT: 0x80 + 0x36,
+  KEY_RCTRL: 0x80 + 0x1d,
+  KEY_RALT: 0x80 + 0x38
+} as const;
+
+import { Key, matchesKey, parseKey } from 'shortcutxl';
+
+/**
+ * Map terminal key input to DOOM key codes
+ * Supports both raw terminal input and Kitty protocol sequences
+ */
+export function mapKeyToDoom(data: string): number[] {
+  // Arrow keys
+  if (matchesKey(data, Key.up)) return [DoomKeys.KEY_UPARROW];
+  if (matchesKey(data, Key.down)) return [DoomKeys.KEY_DOWNARROW];
+  if (matchesKey(data, Key.right)) return [DoomKeys.KEY_RIGHTARROW];
+  if (matchesKey(data, Key.left)) return [DoomKeys.KEY_LEFTARROW];
+
+  // WASD - check both raw char and Kitty sequences
+  if (data === 'w' || matchesKey(data, 'w')) return [DoomKeys.KEY_UPARROW];
+  if (data === 'W' || matchesKey(data, Key.shift('w')))
+    return [DoomKeys.KEY_UPARROW, DoomKeys.KEY_RSHIFT];
+  if (data === 's' || matchesKey(data, 's')) return [DoomKeys.KEY_DOWNARROW];
+  if (data === 'S' || matchesKey(data, Key.shift('s')))
+    return [DoomKeys.KEY_DOWNARROW, DoomKeys.KEY_RSHIFT];
+  if (data === 'a' || matchesKey(data, 'a')) return [DoomKeys.KEY_STRAFE_L];
+  if (data === 'A' || matchesKey(data, Key.shift('a')))
+    return [DoomKeys.KEY_STRAFE_L, DoomKeys.KEY_RSHIFT];
+  if (data === 'd' || matchesKey(data, 'd')) return [DoomKeys.KEY_STRAFE_R];
+  if (data === 'D' || matchesKey(data, Key.shift('d')))
+    return [DoomKeys.KEY_STRAFE_R, DoomKeys.KEY_RSHIFT];
+
+  // Fire - F key
+  if (data === 'f' || data === 'F' || matchesKey(data, 'f') || matchesKey(data, Key.shift('f'))) {
+    return [DoomKeys.KEY_FIRE];
+  }
+
+  // Use/Open
+  if (data === ' ' || matchesKey(data, Key.space)) return [DoomKeys.KEY_USE];
+
+  // Menu/UI keys
+  if (matchesKey(data, Key.enter)) return [DoomKeys.KEY_ENTER];
+  if (matchesKey(data, Key.escape)) return [DoomKeys.KEY_ESCAPE];
+  if (matchesKey(data, Key.tab)) return [DoomKeys.KEY_TAB];
+  if (matchesKey(data, Key.backspace)) return [DoomKeys.KEY_BACKSPACE];
+
+  // Ctrl keys (except Ctrl+C) = fire (legacy support)
+  const parsed = parseKey(data);
+  if (parsed?.startsWith('ctrl+') && parsed !== 'ctrl+c') {
+    return [DoomKeys.KEY_FIRE];
+  }
+  if (data.length === 1 && data.charCodeAt(0) < 32 && data !== '\x03') {
+    return [DoomKeys.KEY_FIRE];
+  }
+
+  // Weapon selection (0-9)
+  if (data >= '0' && data <= '9') return [data.charCodeAt(0)];
+
+  // Plus/minus for screen size
+  if (data === '+' || data === '=') return [DoomKeys.KEY_EQUALS];
+  if (data === '-') return [DoomKeys.KEY_MINUS];
+
+  // Y/N for prompts
+  if (data === 'y' || data === 'Y' || matchesKey(data, 'y') || matchesKey(data, Key.shift('y'))) {
+    return ['y'.charCodeAt(0)];
+  }
+  if (data === 'n' || data === 'N' || matchesKey(data, 'n') || matchesKey(data, Key.shift('n'))) {
+    return ['n'.charCodeAt(0)];
+  }
+
+  // Other printable characters (for cheats)
+  if (data.length === 1 && data.charCodeAt(0) >= 32) {
+    return [data.toLowerCase().charCodeAt(0)];
+  }
+
+  return [];
+}