memorix 1.4.5 → 1.4.6

package/src/cli/tui/markdown-render.tsx

@@ -1,371 +0,0 @@
-/**
- * Lightweight Markdown renderer for Ink TUI.
- *
- * Parses markdown text and renders it using Ink's <Text> component
- * with bold/italic/color support. No external dependencies.
- *
- * Supported:
- * - **bold** → <Text bold>
- * - *italic* → <Text italic>
- * - `inline code` → <Text color="cyan">
- * - # ## ### headings → <Text bold color="brand">
- * - - unordered lists → bullet + indent
- * - 1. ordered lists → number + indent
- * - > blockquotes → <Text color="muted"> with │ prefix
- * - [obs:N] citation links → <Text color="brand">
- * - --- horizontal rules → ─── separator
- */
-
-import React from 'react';
-import { Box, Text } from 'ink';
-
-// ── Inline markdown tokenizer ────────────────────────────────────
-
-interface InlineToken {
-  type: 'text' | 'bold' | 'italic' | 'code' | 'citation';
-  content: string;
-}
-
-function tokenizeInline(text: string): InlineToken[] {
-  const tokens: InlineToken[] = [];
-  let i = 0;
-
-  while (i < text.length) {
-    // **bold**
-    if (text[i] === '*' && text[i + 1] === '*') {
-      const end = text.indexOf('**', i + 2);
-      if (end !== -1) {
-        tokens.push({ type: 'bold', content: text.slice(i + 2, end) });
-        i = end + 2;
-        continue;
-      }
-    }
-
-    // *italic* (but not **)
-    if (text[i] === '*' && text[i + 1] !== '*' && i > 0 && text[i - 1] !== '*') {
-      const end = text.indexOf('*', i + 1);
-      if (end !== -1 && text[end + 1] !== '*') {
-        tokens.push({ type: 'italic', content: text.slice(i + 1, end) });
-        i = end + 1;
-        continue;
-      }
-    }
-
-    // `inline code`
-    if (text[i] === '`') {
-      const end = text.indexOf('`', i + 1);
-      if (end !== -1) {
-        tokens.push({ type: 'code', content: text.slice(i + 1, end) });
-        i = end + 1;
-        continue;
-      }
-    }
-
-    // [obs:N] citation
-    const citationMatch = text.slice(i).match(/^\[obs:(\d+)\]/);
-    if (citationMatch) {
-      tokens.push({ type: 'citation', content: citationMatch[0] });
-      i += citationMatch[0].length;
-      continue;
-    }
-
-    // Accumulate plain text
-    let plain = '';
-    while (i < text.length) {
-      if (
-        (text[i] === '*' && text[i + 1] === '*') ||
-        (text[i] === '*' && text[i + 1] !== '*') ||
-        text[i] === '`' ||
-        text.slice(i).startsWith('[obs:')
-      ) break;
-      plain += text[i];
-      i++;
-    }
-    if (plain) tokens.push({ type: 'text', content: plain });
-  }
-
-  return tokens;
-}
-
-// ── Block-level parser ───────────────────────────────────────────
-
-interface BlockNode {
-  type: 'heading' | 'paragraph' | 'list' | 'blockquote' | 'hr' | 'code_block';
-  level?: number;          // heading level 1-3
-  items?: string[];        // list items
-  ordered?: boolean;       // ordered list?
-  content?: string;        // paragraph/heading/blockquote content
-  language?: string;       // code block language
-}
-
-function parseBlocks(text: string): BlockNode[] {
-  const lines = text.split('\n');
-  const blocks: BlockNode[] = [];
-  let i = 0;
-
-  while (i < lines.length) {
-    const line = lines[i];
-
-    // Horizontal rule
-    if (/^-{3,}$/.test(line.trim()) || /^\*{3,}$/.test(line.trim())) {
-      blocks.push({ type: 'hr' });
-      i++;
-      continue;
-    }
-
-    // Heading
-    const headingMatch = line.match(/^(#{1,3})\s+(.+)/);
-    if (headingMatch) {
-      blocks.push({
-        type: 'heading',
-        level: headingMatch[1].length,
-        content: headingMatch[2],
-      });
-      i++;
-      continue;
-    }
-
-    // Code block (fenced)
-    if (line.trim().startsWith('```')) {
-      const lang = line.trim().slice(3).trim();
-      const codeLines: string[] = [];
-      i++;
-      while (i < lines.length && !lines[i].trim().startsWith('```')) {
-        codeLines.push(lines[i]);
-        i++;
-      }
-      i++; // skip closing ```
-      blocks.push({
-        type: 'code_block',
-        language: lang || undefined,
-        content: codeLines.join('\n'),
-      });
-      continue;
-    }
-
-    // Blockquote
-    if (line.startsWith('>')) {
-      const quoteLines: string[] = [];
-      while (i < lines.length && lines[i].startsWith('>')) {
-        quoteLines.push(lines[i].replace(/^>\s?/, ''));
-        i++;
-      }
-      blocks.push({ type: 'blockquote', content: quoteLines.join('\n') });
-      continue;
-    }
-
-    // Unordered list
-    if (/^[-*]\s+/.test(line.trimStart())) {
-      const items: string[] = [];
-      while (i < lines.length && /^[-*]\s+/.test(lines[i].trimStart())) {
-        items.push(lines[i].trimStart().replace(/^[-*]\s+/, ''));
-        i++;
-      }
-      blocks.push({ type: 'list', ordered: false, items });
-      continue;
-    }
-
-    // Ordered list
-    if (/^\d+\.\s+/.test(line.trimStart())) {
-      const items: string[] = [];
-      while (i < lines.length && /^\d+\.\s+/.test(lines[i].trimStart())) {
-        items.push(lines[i].trimStart().replace(/^\d+\.\s+/, ''));
-        i++;
-      }
-      blocks.push({ type: 'list', ordered: true, items });
-      continue;
-    }
-
-    // Empty line — skip
-    if (line.trim() === '') {
-      i++;
-      continue;
-    }
-
-    // Paragraph — accumulate consecutive non-empty lines
-    const paraLines: string[] = [];
-    while (i < lines.length && lines[i].trim() !== '' && !lines[i].startsWith('#') && !lines[i].startsWith('>') && !lines[i].startsWith('```') && !/^[-*]\s+/.test(lines[i].trimStart()) && !/^\d+\.\s+/.test(lines[i].trimStart())) {
-      paraLines.push(lines[i]);
-      i++;
-    }
-    if (paraLines.length > 0) {
-      blocks.push({ type: 'paragraph', content: paraLines.join(' ') });
-    }
-  }
-
-  return blocks;
-}
-
-// ── Colors ───────────────────────────────────────────────────────
-
-const COLORS = {
-  brand: '#6C9BD2',
-  heading: '#89B4FA',
-  code: '#94E2D5',
-  codeBlock: '#6C7086',
-  quote: '#585B70',
-  citation: '#6C9BD2',
-  bullet: '#89B4FA',
-  hr: '#45475A',
-  text: '#CAD3F5',
-};
-
-// ── Rendering ────────────────────────────────────────────────────
-
-function renderInlineTokens(tokens: InlineToken[]): React.ReactElement[] {
-  return tokens.map((token, idx) => {
-    switch (token.type) {
-      case 'bold':
-        return <Text key={idx} bold>{token.content}</Text>;
-      case 'italic':
-        return <Text key={idx} italic>{token.content}</Text>;
-      case 'code':
-        return <Text key={idx} color={COLORS.code}>{token.content}</Text>;
-      case 'citation':
-        return <Text key={idx} color={COLORS.citation} bold>{token.content}</Text>;
-      default:
-        return <Text key={idx}>{token.content}</Text>;
-    }
-  });
-}
-
-function renderBlock(block: BlockNode, key: number, maxWidth: number): React.ReactElement {
-  switch (block.type) {
-    case 'heading':
-      return (
-        <Text key={key} bold color={COLORS.heading} wrap="truncate-end">
-          {'#'.repeat(block.level ?? 1) + ' '}
-          {renderInlineTokens(tokenizeInline(block.content ?? ''))}
-        </Text>
-      );
-
-    case 'paragraph': {
-      // CJK-aware wrapping: split text by display width, render each line
-      const lines = cjkAwareLines(block.content ?? '', maxWidth);
-      return (
-        <Box key={key} flexDirection="column">
-          {lines.map((ln, i) => (
-            <Text key={i}>{renderInlineTokens(tokenizeInline(ln))}</Text>
-          ))}
-        </Box>
-      );
-    }
-
-    case 'blockquote': {
-      const lines = cjkAwareLines(block.content ?? '', maxWidth - 2);
-      return (
-        <Box key={key} flexDirection="column">
-          {lines.map((ln, i) => (
-            <Text key={i} color={COLORS.quote}>{'│ '}{ln}</Text>
-          ))}
-        </Box>
-      );
-    }
-
-    case 'hr':
-      return (
-        <Text key={key} color={COLORS.hr}>{'─'.repeat(Math.min(40, maxWidth))}</Text>
-      );
-
-    case 'list': {
-      const items = block.items ?? [];
-      const prefixLen = block.ordered ? 3 : 2;
-      return (
-        <React.Fragment key={key}>
-          {items.map((item, idx) => {
-            const lines = cjkAwareLines(item, maxWidth - prefixLen);
-            return (
-              <Box key={idx} flexDirection="column">
-                {lines.map((ln, li) => (
-                  <Text key={li}>
-                    {li === 0 && <Text color={COLORS.bullet}>{block.ordered ? `${idx + 1}. ` : '• '}</Text>}
-                    {li > 0 && <Text>{' '.repeat(prefixLen)}</Text>}
-                    {renderInlineTokens(tokenizeInline(ln))}
-                  </Text>
-                ))}
-              </Box>
-            );
-          })}
-        </React.Fragment>
-      );
-    }
-
-    case 'code_block': {
-      const lines = cjkAwareLines(block.content ?? '', maxWidth);
-      return (
-        <Box key={key} flexDirection="column">
-          {lines.map((ln, i) => (
-            <Text key={i} color={COLORS.codeBlock}>{ln}</Text>
-          ))}
-        </Box>
-      );
-    }
-
-    default:
-      return <Text key={key} />;
-  }
-}
-
-interface MarkdownProps {
-  children: string;
-  /** Max display width for CJK-aware line wrapping. Defaults to 80. */
-  maxWidth?: number;
-}
-
-/** Measure display width counting CJK chars as 2 columns. */
-function displayWidth(str: string): number {
-  let w = 0;
-  for (const ch of str) {
-    const cp = ch.codePointAt(0)!;
-    if ((cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0x3040 && cp <= 0x30FF) ||
-        (cp >= 0xAC00 && cp <= 0xD7AF) || (cp >= 0xFF01 && cp <= 0xFF60) ||
-        (cp >= 0x3400 && cp <= 0x4DBF)) {
-      w += 2;
-    } else {
-      w += 1;
-    }
-  }
-  return w;
-}
-
-/** Split text into lines respecting CJK double-width characters. */
-function cjkAwareLines(text: string, maxCols: number): string[] {
-  if (maxCols < 4) return [text];
-  const lines: string[] = [];
-  let line = '';
-  let lineW = 0;
-  for (const ch of text) {
-    if (ch === '\n') {
-      lines.push(line);
-      line = '';
-      lineW = 0;
-      continue;
-    }
-    const cw = displayWidth(ch);
-    if (lineW + cw > maxCols && line.length > 0) {
-      lines.push(line);
-      line = ch;
-      lineW = cw;
-    } else {
-      line += ch;
-      lineW += cw;
-    }
-  }
-  if (line) lines.push(line);
-  return lines.length > 0 ? lines : [''];
-}
-
-/**
- * Render markdown text in the terminal using Ink components.
- * Uses CJK-aware line wrapping instead of Ink's wrap="wrap"
- * which doesn't understand double-width CJK characters.
- */
-export function Markdown({ children, maxWidth = 80 }: MarkdownProps): React.ReactElement {
-  const blocks = parseBlocks(children);
-
-  return (
-    <React.Fragment>
-      {blocks.map((block, idx) => renderBlock(block, idx, maxWidth))}
-    </React.Fragment>
-  );
-}

package/src/cli/tui/use-mouse.ts

@@ -1,157 +0,0 @@
-/**
- * useMouse — Ink hook for terminal mouse events via SGR protocol (1006).
- *
- * Enables mouse tracking on mount and parses SGR escape sequences from stdin.
- * Supports left/middle/right click, wheel scroll, and drag.
- * Automatically disables mouse tracking on unmount.
- *
- * Compatible terminals: Windows Terminal, iTerm2, WezTerm, GNOME Terminal,
- * Konsole, MinTTY. NOT compatible with CMD.exe.
- */
-
-import { useEffect, useCallback, useRef } from 'react';
-import { useStdin } from 'ink';
-
-export interface MouseEvent {
-  /** 0-based column position */
-  x: number;
-  /** 0-based row position */
-  y: number;
-  button: 'left' | 'middle' | 'right' | 'wheelUp' | 'wheelDown';
-  action: 'press' | 'release' | 'drag';
-  shift: boolean;
-  alt: boolean;
-  ctrl: boolean;
-}
-
-// SGR mouse protocol regex: ESC[<code;col;rowM or ESC[<code;col;rowm
-const SGR_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
-
-function toMouseEvent(m: RegExpExecArray): MouseEvent {
-  const code = parseInt(m[1], 10);
-  const col = parseInt(m[2], 10);
-  const row = parseInt(m[3], 10);
-  const suffix = m[4];
-
-  const wheel = code & 0b11000000;
-  const btnId = code & 0b11;
-
-  const button =
-    wheel === 64 ? 'wheelUp' :
-    wheel === 65 ? 'wheelDown' :
-    btnId === 0 ? 'left' :
-    btnId === 1 ? 'middle' :
-    'right';
-
-  const action: MouseEvent['action'] =
-    wheel !== 0 ? 'press' :
-    suffix === 'M' ? 'press' :
-    'release';
-
-  const isMotion = !!(code & 0x20);
-  const finalAction = isMotion && suffix === 'M' ? 'drag' : action;
-
-  return {
-    x: col - 1,
-    y: row - 1,
-    button,
-    action: finalAction,
-    shift: !!(code & 4),
-    alt: !!(code & 8),
-    ctrl: !!(code & 16),
-  };
-}
-
-export function parseSGRSequence(buf: string): MouseEvent[] {
-  const events: MouseEvent[] = [];
-  SGR_RE.lastIndex = 0;
-  let match: RegExpExecArray | null;
-  while ((match = SGR_RE.exec(buf)) !== null) {
-    events.push(toMouseEvent(match));
-  }
-  return events;
-}
-
-export function parseSGRBuffer(buf: string): { events: MouseEvent[]; remainder: string } {
-  const events: MouseEvent[] = [];
-  SGR_RE.lastIndex = 0;
-  let match: RegExpExecArray | null;
-  let lastConsumed = 0;
-  while ((match = SGR_RE.exec(buf)) !== null) {
-    events.push(toMouseEvent(match));
-    lastConsumed = SGR_RE.lastIndex;
-  }
-
-  const tail = lastConsumed > 0 ? buf.slice(lastConsumed) : buf;
-  const remainderStart = tail.lastIndexOf('\x1b[<');
-  return {
-    events,
-    remainder: remainderStart >= 0 ? tail.slice(remainderStart) : '',
-  };
-}
-
-// ANSI sequences to enable/disable SGR mouse mode
-const ENABLE_SGR = '\x1b[?1006h\x1b[?1000h';
-const DISABLE_SGR = '\x1b[?1000l\x1b[?1006l';
-
-export type MouseHandler = (event: MouseEvent) => void;
-
-export interface UseMouseOptions {
-  /** Whether mouse tracking is active (default: true) */
-  isActive?: boolean;
-  /** Whether to manage SGR terminal mode (enable/disable). Set to false when
-   *  a parent component centrally manages SGR mode. (default: true) */
-  manageMode?: boolean;
-}
-
-/**
- * Hook that listens for terminal mouse events using the SGR protocol.
- *
- * Usage:
- * ```tsx
- * useMouse((e) => {
- *   if (e.button === 'left' && e.action === 'press') {
- *     console.log(`Clicked at (${e.x}, ${e.y})`);
- *   }
- * });
- * ```
- */
-export function useMouse(handler: MouseHandler, options: UseMouseOptions = {}): void {
-  const { isActive = true, manageMode = true } = options;
-  const handlerRef = useRef(handler);
-  handlerRef.current = handler;
-  const bufferRef = useRef('');
-
-  const { stdin } = useStdin();
-
-  const onData = useCallback((data: Buffer | string) => {
-    const str = typeof data === 'string' ? data : data.toString('utf8');
-    const { events, remainder } = parseSGRBuffer(bufferRef.current + str);
-    bufferRef.current = remainder;
-    for (const event of events) {
-      handlerRef.current(event);
-    }
-  }, []);
-
-  useEffect(() => {
-    if (!isActive || !stdin) return;
-    bufferRef.current = '';
-
-    // Enable SGR mouse mode (unless parent manages it centrally)
-    if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
-      process.stdout.write(ENABLE_SGR);
-    }
-
-    // Attach listener
-    stdin.on('data', onData);
-
-    return () => {
-      bufferRef.current = '';
-      // Disable mouse mode (unless parent manages it centrally)
-      if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
-        process.stdout.write(DISABLE_SGR);
-      }
-      stdin.off('data', onData);
-    };
-  }, [isActive, stdin, onData, manageMode]);
-}

package/src/cli/tui/useNavigation.ts

@@ -1,56 +0,0 @@
-/**
- * Centralized keyboard navigation for the Memorix TUI.
- *
- * Three-layer priority model:
- * 1. Action view local keys (1-9, h, w, Esc) — highest
- * 2. CommandBar input mode — captures all printable chars when focused
- * 3. Global nav keys (s, r, v, d, b, w, p, c, i, h) — lowest, only when idle
- */
-
-import type { ViewType } from './theme.js';
-
-/** Maps single-char shortcut keys to view navigation commands */
-export const NAV_KEY_MAP: Record<string, string> = {
-  s: '/search',
-  r: '/remember',
-  v: '/recent',
-  d: '/doctor',
-  b: '/background',
-  w: '/dashboard',
-  p: '/project',
-  c: '/configure',
-  i: '/integrate',
-  h: '/home',
-};
-
-/** Views that handle their own number/letter keys (action views) */
-export const ACTION_VIEWS: Set<ViewType> = new Set([
-  'cleanup', 'ingest', 'background', 'dashboard', 'integrate', 'configure',
-]);
-
-/** Views where Esc returns to home */
-export const ESC_RETURNABLE_VIEWS: Set<ViewType> = new Set([
-  'chat', 'recent', 'doctor', 'project', 'cleanup', 'ingest',
-  'background', 'dashboard', 'integrate', 'configure', 'search', 'wiki',
-]);
-
-/**
- * Determine if a key press should be handled as global navigation.
- *
- * Returns the command string (e.g. '/recent') if the key is a nav key
- * and the current context allows it, or null otherwise.
- */
-export function resolveGlobalNav(
-  ch: string,
-  currentView: ViewType,
-  isInputFocused: boolean,
-): string | null {
-  // Never intercept during input
-  if (isInputFocused) return null;
-
-  // Action views handle their own keys — only allow 'h' for home
-  if (ACTION_VIEWS.has(currentView)) return null;
-
-  const cmd = NAV_KEY_MAP[ch];
-  return cmd ?? null;
-}