π¬ A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots π
TypeScript browser-extensionchrome-extensiondocumentationfirefox-extensionguide-generatorlocal-firstmanifest-v3privacy-firstproductivityreactscreenshotstep-by-step-guidetutorialtypescriptworkflowwxt
feat: guide content viewer with step outline sync and intersection observer
Luis Ortize42bf75be5bb
diff --git a/src/fullview/GuideContent.tsx b/src/fullview/GuideContent.tsxnew file mode 100644index 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>></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>+ );+}