From fbaff37505e6e99fc58cc2aca332d2c740b5e36b Mon Sep 17 00:00:00 2001
From: Amit Haridas <amit.wh@gmail.com>
Date: Sat, 6 Jun 2026 08:20:48 +0530
Subject: [PATCH] feat(renderer): Minimap (custom overview, wired to
 settings.minimap)

---
 .../components/editor/CodeMirrorEditor.tsx    | 10 +++++-
 src/renderer/components/editor/Minimap.tsx    | 33 +++++++++++++++++++
 tests/component/editor/Minimap.test.tsx       | 20 +++++++++++
 3 files changed, 62 insertions(+), 1 deletion(-)
 create mode 100644 src/renderer/components/editor/Minimap.tsx
 create mode 100644 tests/component/editor/Minimap.test.tsx

diff --git a/src/renderer/components/editor/CodeMirrorEditor.tsx b/src/renderer/components/editor/CodeMirrorEditor.tsx
index b32d58f..68c1a99 100644
--- a/src/renderer/components/editor/CodeMirrorEditor.tsx
+++ b/src/renderer/components/editor/CodeMirrorEditor.tsx
@@ -9,6 +9,8 @@ import { oneDark } from '@codemirror/theme-one-dark';
 import { useTheme } from 'next-themes';
 import { lightTheme, lightHighlight } from './themes/light';
 import { useEditorStore } from '@/stores/editor-store';
+import { useSettingsStore } from '@/stores/settings-store';
+import { Minimap } from './Minimap';
 
 interface Props {
   bufferId: string;
@@ -24,6 +26,7 @@ export function CodeMirrorEditor({ bufferId, initialContent, onChange, onCursorC
   const { resolvedTheme } = useTheme();
   const updateContent = useEditorStore((s) => s.updateContent);
   const setCursor = useEditorStore((s) => s.setCursor);
+  const minimap = useSettingsStore((s) => s.minimap);
 
   useEffect(() => {
     if (!ref.current) return;
@@ -76,5 +79,10 @@ export function CodeMirrorEditor({ bufferId, initialContent, onChange, onCursorC
     });
   }, [resolvedTheme]);
 
-  return <div ref={ref} className="h-full overflow-hidden" />;
+  return (
+    <div className="relative h-full overflow-hidden">
+      <div ref={ref} className="h-full overflow-hidden" />
+      {minimap && <Minimap content={initialContent} />}
+    </div>
+  );
 }
\ No newline at end of file
diff --git a/src/renderer/components/editor/Minimap.tsx b/src/renderer/components/editor/Minimap.tsx
new file mode 100644
index 0000000..2e31a7f
--- /dev/null
+++ b/src/renderer/components/editor/Minimap.tsx
@@ -0,0 +1,33 @@
+interface Props {
+  content: string;
+  scrollRatio?: number;       // 0-1, where the viewport is
+  visibleRatio?: number;      // 0-1, what fraction of content is visible
+}
+
+export function Minimap({ content, scrollRatio = 0, visibleRatio = 1 }: Props) {
+  const lines = content.split('\n');
+  // Compute viewport position in the minimap
+  const viewportTop = Math.round(scrollRatio * 100);
+  const viewportHeight = Math.round(visibleRatio * 100);
+
+  return (
+    <div
+      data-testid="minimap"
+      className="pointer-events-none absolute right-0 top-0 h-full w-[100px] overflow-hidden border-l border-border bg-card/30 p-1 font-mono text-[6px] leading-[8px] text-muted-foreground"
+      aria-hidden="true"
+    >
+      <pre className="w-full truncate whitespace-pre">
+        {lines.map((line, i) => (
+          <div key={i} data-testid="minimap-line">
+            {line || ' '}
+          </div>
+        ))}
+      </pre>
+      <div
+        data-testid="minimap-viewport"
+        className="pointer-events-none absolute left-0 right-0 bg-brand/15"
+        style={{ top: `${viewportTop}%`, height: `${Math.max(viewportHeight, 5)}%` }}
+      />
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/tests/component/editor/Minimap.test.tsx b/tests/component/editor/Minimap.test.tsx
new file mode 100644
index 0000000..3429686
--- /dev/null
+++ b/tests/component/editor/Minimap.test.tsx
@@ -0,0 +1,20 @@
+import { describe, it, expect } from 'vitest';
+import { render, screen } from '@testing-library/react';
+import { Minimap } from '@/components/editor/Minimap';
+
+describe('Minimap', () => {
+  it('renders lines of content as shrunk text', () => {
+    const content = 'line 1\nline 2\nline 3';
+    render(<Minimap content={content} />);
+    const lines = screen.getAllByTestId('minimap-line');
+    expect(lines).toHaveLength(3);
+  });
+
+  it('renders a viewport indicator', () => {
+    render(
+      <Minimap content={'line 1\nline 2\nline 3'} scrollRatio={0.5} visibleRatio={0.5} />
+    );
+    const indicator = screen.getByTestId('minimap-viewport');
+    expect(indicator).toBeInTheDocument();
+  });
+});
\ No newline at end of file