Skip to content

armgit / mimik

Public Imported from GitHub
0

🎬 A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots 📖

feat(desktop): re-zoom a recorded guide from its toolbar

Luis Ortiz2b58106ef243
diff --git a/AGENTS.md b/AGENTS.md
index 7aaa7a7..ffb60a7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -599,6 +599,20 @@ gives 2.25, a 1200 px window gives 1, and a small one gives 1 — the same butto
every page of the guide, which a fixed fraction of the frame cannot do. The level is stored beside
the region in `edits.zoomLevel`, so it can be re-derived or overridden later without recapturing.
+A setting only seeds new recordings, so the guide view carries its own Zoom control and `rezoomEdits`
+rewrites the steps already captured. It recomputes from `clickPoint` and the frame, which every row
+already holds, so nothing is re-captured and nothing is lost. A guide therefore stores no zoom of its
+own — the level lives per screenshot and the control simply rewrites each one.
+
+Which steps it may touch is `edits.zoomLevel` itself: present means the app chose the region, absent
+means a person did. `AnnotationEditor` clears it whenever the crop tool writes a new viewport, so a
+hand-cropped step survives every later re-zoom. `rezoomEdits` returns null for those, and for a step
+already at the wanted level, so the pass writes only what changes.
+
+`guideActions` on `TopNav` is the slot it mounts into, beside Edit and Export and under the same
+`exportData` guard, so the control appears exactly when the rest of the guide toolbar does. The
+extension passes nothing.
+
`zoomLevel` in capture settings overrides the automatic choice; `null` means derive it. Main cannot
value-import core, so `settings.ts` carries its own three-line `snapZoom` rather than the one in
`record.ts` — the same constraint that keeps `clamp` local in `capture/screenshot.ts`. The renderer
diff --git a/apps/desktop/src/renderer/App.tsx b/apps/desktop/src/renderer/App.tsx
index 4beea09..6fe83d9 100644
--- a/apps/desktop/src/renderer/App.tsx
+++ b/apps/desktop/src/renderer/App.tsx
@@ -6,6 +6,7 @@ import SearchModal from '@mimik/ui/fullview/SearchModal';
import TopNav from '@mimik/ui/fullview/TopNav';
import { useEffect, useState } from 'react';
import CaptureSheet from './CaptureSheet';
+import GuideZoom from './GuideZoom';
import SettingsPanel from './SettingsPanel';
export default function App() {
@@ -23,6 +24,7 @@ export default function App() {
}, []);
const library = route.page === 'library';
+ const [guideKey, setGuideKey] = useState(0);
return (
<TooltipProvider>
@@ -31,6 +33,11 @@ export default function App() {
route={route}
onSettings={library ? () => setSettingsOpen(true) : undefined}
onNavigate={() => setSettingsOpen(false)}
+ guideActions={
+ route.page === 'guide' ? (
+ <GuideZoom guideId={route.guideId} onDone={() => setGuideKey((n) => n + 1)} />
+ ) : undefined
+ }
/>
{settingsOpen ? (
<main className="flex-1 min-h-0">
@@ -39,7 +46,12 @@ export default function App() {
) : route.page === 'guide' ? (
<main className="flex-1 py-10 px-6">
<div className="mx-auto max-w-[780px]">
- <GuideContent guideId={route.guideId} initialStepId={route.stepId} initialTool={route.tool} />
+ <GuideContent
+ key={guideKey}
+ guideId={route.guideId}
+ initialStepId={route.stepId}
+ initialTool={route.tool}
+ />
</div>
</main>
) : (
diff --git a/apps/desktop/src/renderer/GuideZoom.tsx b/apps/desktop/src/renderer/GuideZoom.tsx
new file mode 100644
index 0000000..d981ed9
--- /dev/null
+++ b/apps/desktop/src/renderer/GuideZoom.tsx
@@ -0,0 +1,55 @@
+import { i18n } from '@mimik/core/env';
+import { getGuide, updateScreenshotEdits } from '@mimik/core/guides/service';
+import { MAX_ZOOM, MIN_ZOOM, rezoomEdits, ZOOM_STEP } from '@mimik/core/screenshot/record';
+import { Button } from '@mimik/ui/components/ui/button';
+import { Select, SelectContent, SelectItem, SelectTrigger } from '@mimik/ui/components/ui/select';
+import { ZoomIn } from 'lucide-react';
+import { useState } from 'react';
+
+const LEVELS = Array.from(
+ { length: Math.round((MAX_ZOOM - MIN_ZOOM) / ZOOM_STEP) + 1 },
+ (_, i) => MIN_ZOOM + i * ZOOM_STEP,
+);
+
+export default function GuideZoom({ guideId, onDone }: { guideId: string; onDone: () => void }) {
+ const [busy, setBusy] = useState(false);
+
+ const apply = async (value: string) => {
+ setBusy(true);
+ try {
+ const found = await getGuide(guideId);
+ if (!found) return;
+ const level = value === 'auto' ? null : Number(value);
+ for (const shot of found.screenshots.values()) {
+ const next = rezoomEdits(shot, level);
+ if (next) await updateScreenshotEdits(shot.id, next);
+ }
+ onDone();
+ } finally {
+ setBusy(false);
+ }
+ };
+
+ return (
+ <Select disabled={busy} onValueChange={apply}>
+ <SelectTrigger
+ aria-label={i18n.t('desktop_zoomLevel')}
+ className="h-8 w-auto gap-1.5 rounded-lg border-border bg-card px-3 text-[13px] font-medium hover:bg-secondary"
+ asChild
+ >
+ <Button size="sm" variant="ghost">
+ <ZoomIn size={14} />
+ {i18n.t('desktop_zoomGuide')}
+ </Button>
+ </SelectTrigger>
+ <SelectContent>
+ <SelectItem value="auto">{i18n.t('desktop_zoomAuto')}</SelectItem>
+ {LEVELS.map((level) => (
+ <SelectItem key={level} value={String(level)}>
+ {String(level)}&times;
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ );
+}
diff --git a/packages/core/src/screenshot/__tests__/record.test.ts b/packages/core/src/screenshot/__tests__/record.test.ts
index e22d41a..1dd2ad8 100644
--- a/packages/core/src/screenshot/__tests__/record.test.ts
+++ b/packages/core/src/screenshot/__tests__/record.test.ts
@@ -1,7 +1,7 @@
import { describe, expect, it } from 'vitest';
import type { ElementMeta } from '@/core/guides/types';
import { resolveViewport } from '@/core/screenshot/geometry';
-import { autoZoom, clickZoomViewport, screenshotForElement, snapZoom } from '@/core/screenshot/record';
+import { autoZoom, clickZoomViewport, rezoomEdits, screenshotForElement, snapZoom } from '@/core/screenshot/record';
const meta: ElementMeta = {
textContent: null,
@@ -93,3 +93,27 @@ describe('clickZoomViewport', () => {
expect(clickZoomViewport(2560, 1440, { x: 2550, y: 1430 }, 2)).toMatchObject({ x: 1280, y: 720 });
});
});
+
+describe('rezoomEdits', () => {
+ const auto = screenshotForElement({ ...bytes, width: 2560, height: 1440, zoom: 'click' }, meta);
+
+ it('recomputes the region at a new level', () => {
+ const next = rezoomEdits(auto, 3);
+ expect(next?.zoomLevel).toBe(3);
+ expect(next?.viewport?.width).toBeCloseTo(2560 / 3, 1);
+ });
+
+ it('re-derives the automatic level when given null', () => {
+ const next = rezoomEdits({ ...auto, edits: { ...auto.edits, zoomLevel: 4 } }, null);
+ expect(next?.zoomLevel).toBe(autoZoom(2560, 2));
+ });
+
+ it('leaves a step alone when nothing would change', () => {
+ expect(rezoomEdits(auto, auto.edits?.zoomLevel ?? 0)).toBeNull();
+ });
+
+ it('leaves a hand-cropped step alone', () => {
+ const cropped = { ...auto, edits: { ...auto.edits, zoomLevel: undefined } };
+ expect(rezoomEdits(cropped, 3)).toBeNull();
+ });
+});
diff --git a/packages/core/src/screenshot/record.ts b/packages/core/src/screenshot/record.ts
index 328304d..85ff020 100644
--- a/packages/core/src/screenshot/record.ts
+++ b/packages/core/src/screenshot/record.ts
@@ -1,5 +1,5 @@
import type { ElementMeta, ScreenshotBounds, StoredScreenshot } from '@/core/guides/types';
-import { type CursorMark, DEFAULT_TARGET_COLOR } from '@/core/screenshot/types';
+import { type CursorMark, DEFAULT_TARGET_COLOR, type ScreenshotEdits } from '@/core/screenshot/types';
export type ZoomMode = 'element' | 'click' | 'none';
@@ -82,3 +82,17 @@ export function screenshotForElement(bytes: ScreenshotBytes, meta: ElementMeta):
},
};
}
+
+export function rezoomEdits(screenshot: StoredScreenshot, level: number | null): ScreenshotEdits | null {
+ if (screenshot.edits?.zoomLevel === undefined) return null;
+ const click = screenshot.clickPoint;
+ if (!click) return null;
+ const ratio = screenshot.pixelRatio || 1;
+ const next = level ?? autoZoom(screenshot.width, ratio);
+ if (next === screenshot.edits.zoomLevel) return null;
+ return {
+ ...screenshot.edits,
+ zoomLevel: next,
+ viewport: clickZoomViewport(screenshot.width, screenshot.height, { x: click.x * ratio, y: click.y * ratio }, next),
+ };
+}
diff --git a/packages/ui/src/fullview/TopNav.tsx b/packages/ui/src/fullview/TopNav.tsx
index e6fb641..ac2018b 100644
--- a/packages/ui/src/fullview/TopNav.tsx
+++ b/packages/ui/src/fullview/TopNav.tsx
@@ -18,6 +18,7 @@ import {
Star,
Trash2,
} from 'lucide-react';
+import type { ReactNode } from 'react';
import { useState } from 'react';
import ExportPreviewModal from './ExportPreviewModal';
@@ -25,6 +26,7 @@ interface TopNavProps {
route: Route;
onSettings?: () => void;
onNavigate?: () => void;
+ guideActions?: ReactNode;
}
const navItems = [
@@ -35,7 +37,7 @@ const navItems = [
const NAV_CONTROL = 'h-8 rounded-lg border border-border bg-card text-foreground hover:bg-secondary hover:text-accent';
-export default function TopNav({ route, onSettings, onNavigate }: TopNavProps) {
+export default function TopNav({ route, onSettings, onNavigate, guideActions }: TopNavProps) {
const {
counts,
guideTitle,
@@ -162,6 +164,7 @@ export default function TopNav({ route, onSettings, onNavigate }: TopNavProps) {
)}
{route.page === 'guide' && exportData && (
<>
+ {guideActions}
<Button size="sm" variant="ghost" onClick={() => toggleEditing(exportData.guideId)} className={NAV_CONTROL}>
{editing ? <Check size={14} /> : <Pencil size={14} />}
{editing ? i18n.t('editor.done') : i18n.t('editor.edit')}
diff --git a/packages/ui/src/shared/AnnotationEditor.tsx b/packages/ui/src/shared/AnnotationEditor.tsx
index 43e7d26..1b37f68 100644
--- a/packages/ui/src/shared/AnnotationEditor.tsx
+++ b/packages/ui/src/shared/AnnotationEditor.tsx
@@ -880,7 +880,12 @@ export default function AnnotationEditor({ screenshot, tool, onDone, onCancel }:
annotations: annotations.filter((a) => a.id !== TARGET_ID),
target: nextTarget,
};
- if (viewport) nextEdits.viewport = viewport;
+ if (viewport && viewport !== screenshot.edits?.viewport) {
+ nextEdits.viewport = viewport;
+ nextEdits.zoomLevel = undefined;
+ } else if (viewport) {
+ nextEdits.viewport = viewport;
+ }
await updateScreenshotEdits(screenshot.id, nextEdits);
onDone(nextEdits);
};
diff --git a/src/locales/de.yml b/src/locales/de.yml
index 9bdb5a9..fdc1d12 100644
--- a/src/locales/de.yml
+++ b/src/locales/de.yml
@@ -188,6 +188,7 @@ desktop:
zoomLevel: "Auf den Klick zoomen"
zoomLevelHint: "Neue Aufzeichnungen starten hier. Automatisch hält alle Schritte gleich groß."
zoomAuto: "Automatisch"
+ zoomGuide: "Zoom"
captureKeys: "Kürzel und benannte Tasten aufzeichnen"
captureTyping: "Eingaben aufzeichnen"
typingDebounce: "Eingabeschritt beenden nach"
diff --git a/src/locales/en.yml b/src/locales/en.yml
index 75bb0f3..97cc877 100644
--- a/src/locales/en.yml
+++ b/src/locales/en.yml
@@ -188,6 +188,7 @@ desktop:
zoomLevel: "Zoom toward the click"
zoomLevelHint: "New recordings start here. Automatic keeps every step the same size."
zoomAuto: "Automatic"
+ zoomGuide: "Zoom"
captureKeys: "Record shortcuts and named keys"
captureTyping: "Record what you type"
typingDebounce: "Close a typing step after"
diff --git a/src/locales/es.yml b/src/locales/es.yml
index 5f4d7b9..2546966 100644
--- a/src/locales/es.yml
+++ b/src/locales/es.yml
@@ -188,6 +188,7 @@ desktop:
zoomLevel: "Acercar hacia el clic"
zoomLevelHint: "Las grabaciones nuevas empiezan aquí. Automático mantiene todos los pasos del mismo tamaño."
zoomAuto: "Automático"
+ zoomGuide: "Zoom"
captureKeys: "Registrar atajos y teclas con nombre"
captureTyping: "Registrar lo que escribes"
typingDebounce: "Cerrar el paso de escritura tras"
diff --git a/src/locales/fr.yml b/src/locales/fr.yml
index 6966342..631766c 100644
--- a/src/locales/fr.yml
+++ b/src/locales/fr.yml
@@ -188,6 +188,7 @@ desktop:
zoomLevel: "Zoomer vers le clic"
zoomLevelHint: "Les nouveaux enregistrements partent d’ici. Automatique garde toutes les étapes à la même taille."
zoomAuto: "Automatique"
+ zoomGuide: "Zoom"
captureKeys: "Enregistrer les raccourcis et touches nommées"
captureTyping: "Enregistrer ce que vous tapez"
typingDebounce: "Clôturer l'étape de saisie après"
diff --git a/src/locales/pt-BR.yml b/src/locales/pt-BR.yml
index 455bbcd..cde682c 100644
--- a/src/locales/pt-BR.yml
+++ b/src/locales/pt-BR.yml
@@ -188,6 +188,7 @@ desktop:
zoomLevel: "Aproximar no clique"
zoomLevelHint: "Novas gravações começam aqui. Automático mantém todas as etapas do mesmo tamanho."
zoomAuto: "Automático"
+ zoomGuide: "Zoom"
captureKeys: "Registrar atalhos e teclas nomeadas"
captureTyping: "Registrar o que você digita"
typingDebounce: "Encerrar a etapa de digitação após"
diff --git a/src/locales/zh-CN.yml b/src/locales/zh-CN.yml
index 8aa02c2..19dc818 100644
--- a/src/locales/zh-CN.yml
+++ b/src/locales/zh-CN.yml
@@ -188,6 +188,7 @@ desktop:
zoomLevel: "向点击处缩放"
zoomLevelHint: "新录制从这里开始。自动会让每一步保持相同大小。"
zoomAuto: "自动"
+ zoomGuide: "缩放"
captureKeys: "记录快捷键和命名按键"
captureTyping: "记录输入内容"
typingDebounce: "输入步骤结束延迟"