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: guide content viewer with step outline sync and intersection observer

Luis Ortize42bf75be5bb
diff --git a/src/fullview/GuideContent.tsx b/src/fullview/GuideContent.tsx
new file mode 100644
index 0000000..6dbff64
--- /dev/null
+++ b/src/fullview/GuideContent.tsx
@@ -0,0 +1,199 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { getGuide, updateGuideTitle, updateStepDescription, deleteStep, reorderSteps, updateScreenshotBlob } from '../shared/guide-service';
+import type { Guide, Step, Screenshot } from '../shared/types';
+import StepCard from '../sidepanel/StepCard';
+import BlurCanvas from '../sidepanel/BlurCanvas';
+import ExportMenu from '../sidepanel/ExportMenu';
+import { navigate } from './router';
+
+interface GuideContentProps {
+ guideId: string;
+ onStepsLoaded: (steps: Step[], domain: string, favicon: string) => void;
+ scrollToStepId: string | null;
+ onActiveStepChange: (stepId: string | null) => void;
+}
+
+interface GuideData {
+ guide: Guide;
+ steps: Step[];
+ screenshots: Map<string, Screenshot>;
+}
+
+function extractDomain(url: string): string {
+ try { return new URL(url).hostname.replace(/^www\./, ''); } catch { return ''; }
+}
+function getFaviconUrl(url: string): string {
+ try { return `https://www.google.com/s2/favicons?domain=${new URL(url).hostname}&sz=32`; } catch { return ''; }
+}
+
+export default function GuideContent({ guideId, onStepsLoaded, scrollToStepId, onActiveStepChange }: GuideContentProps) {
+ const [data, setData] = useState<GuideData | null>(null);
+ const [loading, setLoading] = useState(true);
+ const [title, setTitle] = useState('');
+ const [dragIndex, setDragIndex] = useState<number | null>(null);
+ const [dragOverIndex, setDragOverIndex] = useState<number | null>(null);
+ const [blurringStepId, setBlurringStepId] = useState<string | null>(null);
+ const stepRefs = useRef<Map<string, HTMLDivElement>>(new Map());
+
+ const loadGuide = useCallback(async () => {
+ const result = await getGuide(guideId);
+ if (result) {
+ setData(result);
+ setTitle(result.guide.title);
+ document.title = `${result.guide.title} β€” Mimik`;
+ const firstUrl = result.steps[0]?.url || '';
+ onStepsLoaded(result.steps, extractDomain(firstUrl), getFaviconUrl(firstUrl));
+ }
+ setLoading(false);
+ }, [guideId, onStepsLoaded]);
+
+ useEffect(() => { loadGuide(); }, [loadGuide]);
+
+ useEffect(() => {
+ if (scrollToStepId) {
+ const el = stepRefs.current.get(scrollToStepId);
+ el?.scrollIntoView({ behavior: 'smooth', block: 'center' });
+ }
+ }, [scrollToStepId]);
+
+ useEffect(() => {
+ if (!data) return;
+ const observer = new IntersectionObserver(
+ (entries) => {
+ for (const entry of entries) {
+ if (entry.isIntersecting) {
+ onActiveStepChange(entry.target.getAttribute('data-step-id'));
+ }
+ }
+ },
+ { threshold: 0.5 }
+ );
+ stepRefs.current.forEach(el => observer.observe(el));
+ return () => observer.disconnect();
+ }, [data, onActiveStepChange]);
+
+ const handleTitleBlur = useCallback(async () => {
+ if (!data || title === data.guide.title) return;
+ await updateGuideTitle(guideId, title);
+ setData(prev => prev ? { ...prev, guide: { ...prev.guide, title } } : prev);
+ document.title = `${title} β€” Mimik`;
+ }, [data, guideId, title]);
+
+ const handleDescriptionChange = useCallback(async (stepId: string, description: string) => {
+ await updateStepDescription(stepId, description);
+ setData(prev => {
+ if (!prev) return prev;
+ return { ...prev, steps: prev.steps.map(s => s.id === stepId ? { ...s, description } : s) };
+ });
+ }, []);
+
+ const handleDeleteStep = useCallback(async (stepId: string) => {
+ await deleteStep(guideId, stepId);
+ await loadGuide();
+ }, [guideId, loadGuide]);
+
+ const handleBlurSave = useCallback(async (blob: Blob) => {
+ if (!blurringStepId || !data) return;
+ const blurScreenshot = data.screenshots.get(blurringStepId);
+ if (!blurScreenshot) return;
+ await updateScreenshotBlob(blurScreenshot.id, blob);
+ setData(prev => {
+ if (!prev) return prev;
+ const newScreenshots = new Map(prev.screenshots);
+ newScreenshots.set(blurringStepId, { ...blurScreenshot, blob });
+ return { ...prev, screenshots: newScreenshots };
+ });
+ setBlurringStepId(null);
+ }, [blurringStepId, data]);
+
+ if (loading) return <p className="text-sm text-gray-400 py-12 text-center">Loading...</p>;
+ if (!data) return <p className="text-sm text-red-500 py-12 text-center">Guide not found.</p>;
+
+ const blurScreenshot = blurringStepId ? data.screenshots.get(blurringStepId) : undefined;
+ const siteUrl = data.steps[0]?.url || '';
+ const domain = extractDomain(siteUrl);
+ const favicon = getFaviconUrl(siteUrl);
+
+ return (
+ <div>
+ {blurringStepId && blurScreenshot && (
+ <BlurCanvas screenshot={blurScreenshot} onSave={handleBlurSave} onCancel={() => setBlurringStepId(null)} />
+ )}
+
+ {/* Breadcrumb + Export */}
+ <div className="flex items-center justify-between mb-6">
+ <div className="flex items-center gap-2 text-sm text-gray-400">
+ <button onClick={() => navigate({ page: 'library', category: 'all' })} className="hover:text-gray-600">
+ All Guides
+ </button>
+ <span>&gt;</span>
+ <span className="text-gray-700 font-medium truncate max-w-xs">{data.guide.title}</span>
+ </div>
+ <ExportMenu guideId={guideId} guide={data.guide} steps={data.steps} screenshots={data.screenshots} />
+ </div>
+
+ {/* Created date */}
+ <p className="text-sm text-gray-400 mb-2">Created {new Date(data.guide.createdAt).toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' })}</p>
+
+ {/* Title */}
+ <input
+ className="text-3xl font-bold bg-transparent border-b-2 border-transparent hover:border-gray-300 focus:border-blue-500 focus:outline-none w-full mb-6"
+ value={title}
+ onChange={(e) => setTitle(e.target.value)}
+ onBlur={handleTitleBlur}
+ />
+
+ {/* Site card */}
+ {domain && (
+ <div className="flex items-center gap-3 p-4 border border-gray-200 rounded-xl mb-8">
+ {favicon && <img src={favicon} alt="" className="w-6 h-6 rounded" onError={(e) => { (e.target as HTMLImageElement).style.display = 'none'; }} />}
+ <span className="text-sm font-medium text-gray-700">{domain}</span>
+ </div>
+ )}
+
+ {/* Steps */}
+ {data.steps.length === 0 ? (
+ <p className="text-sm text-gray-500 text-center py-12">No steps in this guide.</p>
+ ) : (
+ <div className="space-y-4">
+ {data.steps.map((step, idx) => (
+ <div
+ key={step.id}
+ ref={(el) => { if (el) stepRefs.current.set(step.id, el); else stepRefs.current.delete(step.id); }}
+ data-step-id={step.id}
+ >
+ {dragOverIndex === idx && dragIndex !== null && dragIndex !== idx && (
+ <div className="h-1 bg-blue-500 rounded-full mx-4 mb-2" />
+ )}
+ <StepCard
+ step={step}
+ screenshot={data.screenshots.get(step.id)}
+ onDescriptionChange={handleDescriptionChange}
+ onDelete={handleDeleteStep}
+ onBlur={(stepId) => setBlurringStepId(stepId)}
+ dragHandleProps={{
+ onDragStart: (e: React.DragEvent) => { setDragIndex(idx); e.dataTransfer.effectAllowed = 'move'; },
+ onDragOver: (e: React.DragEvent) => { e.preventDefault(); setDragOverIndex(idx); },
+ onDragEnd: () => {
+ if (dragIndex !== null && dragOverIndex !== null && dragIndex !== dragOverIndex) {
+ setData(prev => {
+ if (!prev) return prev;
+ const newSteps = [...prev.steps];
+ const [moved] = newSteps.splice(dragIndex, 1);
+ newSteps.splice(dragOverIndex, 0, moved);
+ reorderSteps(guideId, newSteps.map(s => s.id));
+ return { ...prev, steps: newSteps };
+ });
+ }
+ setDragIndex(null);
+ setDragOverIndex(null);
+ },
+ }}
+ />
+ </div>
+ ))}
+ </div>
+ )}
+ </div>
+ );
+}