index.js

/**
 * @git-stunts/git-warp-tui — Interactive terminal graph browser.
 *
 * Public API: startTui()
 */

import { App } from './src/app/App.js';
import { NodeTerminalAdapter } from './src/adapters/NodeTerminalAdapter.js';
import { loadGraphData } from './src/data/GraphDataSource.js';
import { loadPatchData } from './src/data/PatchDataSource.js';

/**
 * Start the interactive TUI.
 *
 * @param {Object} options
 * @param {string}  options.repo  - path to git repository
 * @param {string}  options.graph - graph name
 * @param {string}  [options.mode='list'] - initial mode
 * @returns {Promise<void>} resolves when user quits
 */
export async function startTui(options) {
  const { repo, graph, mode = 'list' } = options;

  let data;
  try {
    data = await loadGraphData({ repo, graph });
  } catch (err) {
    const msg = err.message || String(err);
    if (msg.includes('Cannot find module') || msg.includes('ERR_MODULE_NOT_FOUND')) {
      throw new Error(
        '@git-stunts/git-warp is not installed. Install with: npm i @git-stunts/git-warp',
      );
    }
    throw new Error(`Failed to load graph "${graph}" from ${repo}: ${msg}`);
  }

  // Lazy-load layoutGraph from git-warp's visualization export
  let layoutGraph = null;
  try {
    const viz = await import('@git-stunts/git-warp/visualization');
    layoutGraph = viz.layoutGraph;
  } catch {
    // Visualization module not available — graph mode won't have layout
  }

  const terminal = new NodeTerminalAdapter();
  const app = new App(terminal, {
    nodes: data.nodes,
    edges: data.edges,
    mode,
    layoutGraph,
    dataSources: {
      loadGraphData: () => loadGraphData({ repo, graph }),
      loadPatchData: () => loadPatchData({ repo, graph }),
    },
  });

  return app.start();
}

export { App } from './src/app/App.js';