π¬ 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
fix: debugging fixes β unified messaging, plain div Shadow DOM, tab message blur activation
Luis Ortiz6bbb3d70a7b4
diff --git a/src/core/blur/element-picker.ts b/src/core/blur/element-picker.tsindex 8d2b5fe..082d5c7 100644--- a/src/core/blur/element-picker.ts+++ b/src/core/blur/element-picker.ts@@ -91,48 +91,35 @@ export class ElementPicker {}private mount() {- if (!customElements.get(PICKER_TAG)) {- customElements.define(- PICKER_TAG,- class extends HTMLElement {- constructor() {- super();- const shadow = this.attachShadow({ mode: 'closed' });- const style = document.createElement('style');- style.textContent = STYLES;- shadow.appendChild(style);+ this.host = document.createElement('div');+ this.host.setAttribute('data-mimik-ignore', '');- const ring = document.createElement('div');- ring.className = 'ring';- shadow.appendChild(ring);+ const shadow = this.host.attachShadow({ mode: 'closed' });+ const style = document.createElement('style');+ style.textContent = STYLES;+ shadow.appendChild(style);- const bar = document.createElement('div');- bar.className = 'bar';- bar.innerHTML = `- <div class="bar-left">- <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 3l7.07 16.97 2.51-7.39 7.39-2.51L3 3z"/></svg>- Select elements to blur- </div>- `;- const doneBtn = document.createElement('button');- doneBtn.className = 'bar-done';- doneBtn.textContent = 'Done';- doneBtn.addEventListener('click', () => {- this.dispatchEvent(new CustomEvent('picker-done'));- });- bar.appendChild(doneBtn);- shadow.appendChild(bar);+ const ring = document.createElement('div');+ ring.className = 'ring';+ shadow.appendChild(ring);- (this as any)._ring = ring;- }- },- );- }- this.host = document.createElement(PICKER_TAG);- this.host.setAttribute('data-mimik-ignore', '');- this.host.addEventListener('picker-done', () => this.onDone?.());+ const bar = document.createElement('div');+ bar.className = 'bar';+ bar.innerHTML = `+ <div class="bar-left">+ <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 3l7.07 16.97 2.51-7.39 7.39-2.51L3 3z"/></svg>+ Select elements to blur+ </div>+ `;+ const doneBtn = document.createElement('button');+ doneBtn.className = 'bar-done';+ doneBtn.textContent = 'Done';+ doneBtn.addEventListener('click', () => this.onDone?.());+ bar.appendChild(doneBtn);+ shadow.appendChild(bar);++ this.ring = ring;document.documentElement.appendChild(this.host);- this.ring = (this.host as any)._ring;}private isMimikElement(el: Element): boolean {diff --git a/src/core/blur/manager.ts b/src/core/blur/manager.tsindex 86ceaf9..b55ebc6 100644--- a/src/core/blur/manager.ts+++ b/src/core/blur/manager.ts@@ -1,4 +1,5 @@import { browser } from '#imports';+import { sendMessage } from '@/lib/messaging';import { ElementPicker } from './element-picker';import { BlurPanel } from './panel';import type { PresetKey } from './regexes';@@ -16,7 +17,10 @@ export class BlurManager {this.active = true;injectBlurStyles();- const stored = await browser.storage.local.get(['blurPresets', 'blurAiEnabled']);+ let stored: Record<string, unknown> = {};+ try {+ stored = await browser.storage.local.get(['blurPresets', 'blurAiEnabled']);+ } catch {}const presets = (stored.blurPresets as Record<PresetKey, boolean>) || {email: true,phone: true,@@ -82,11 +86,10 @@ export class BlurManager {private onToggleAi = ((e: CustomEvent<{ enabled: boolean }>) => {if (e.detail.enabled) {- browser.runtime- .sendMessage({ type: 'BLUR_AI_DETECT', text: document.body.innerText })- .then((res: any) => {+ sendMessage('blurAiDetect', { text: document.body.innerText })+ .then((res) => {if (res?.patterns) {- const regexes = res.patterns.map((p: string) => new RegExp(p.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi'));+ const regexes = res.patterns.map((p) => new RegExp(p.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi'));this.scanner.setAiPatterns(regexes);}})diff --git a/src/core/blur/panel.ts b/src/core/blur/panel.tsindex 7eda7ff..81514bc 100644--- a/src/core/blur/panel.ts+++ b/src/core/blur/panel.ts@@ -255,11 +255,8 @@ export class BlurPanel {}mount() {- if (!customElements.get(PANEL_TAG)) {- customElements.define(PANEL_TAG, class extends HTMLElement {});- }-- this.host = document.createElement(PANEL_TAG);+ this.host = document.createElement('div');+ this.host.setAttribute('data-mimik-ignore', '');this.host.setAttribute('data-mimik-ignore', '');const shadow = this.host.attachShadow({ mode: 'closed' });diff --git a/src/entrypoints/background/index.ts b/src/entrypoints/background/index.tsindex 0533e08..b5a490a 100644--- a/src/entrypoints/background/index.ts+++ b/src/entrypoints/background/index.ts@@ -2,7 +2,7 @@ import { defineBackground } from '#imports';import { generateGuideTitle } from '@/core/capture/ai/title';import { advanceSession, cancelSession, completeSession, getSession, startSession } from '@/core/guideme/session';import { createGuide, getStepsForGuide, saveRrwebChunk, updateGuideTitle } from '@/core/guides/service';-import { getActiveTab, localStorage, setSidePanelBehavior, updateTab } from '@/lib/browser-api';+import { getActiveTab, localStorage, sendMessageToTab, setSidePanelBehavior, updateTab } from '@/lib/browser-api';import { logger } from '@/lib/logger';import { onMessage } from '@/lib/messaging';import { broadcastStateToPanel, setupPortListener } from '@/lib/port';@@ -109,7 +109,10 @@ export default defineBackground(() => {onMessage('enterBlurMode', async () => {await waitUntilReady();await broadcastStopCapture();- await localStorage.set({ mimikBlurMode: true });+ const activeTab = await getActiveTab();+ if (activeTab?.id) {+ sendMessageToTab(activeTab.id, { type: 'START_BLUR' }).catch(() => {});+ }return { entered: true };});@@ -222,24 +225,15 @@ export default defineBackground(() => {return { moved: true };});- chrome.runtime.onMessage.addListener((msg, _sender, sendResponse) => {- if (msg.type === 'offscreen:ready') return false;-- if (msg.type === 'BLUR_AI_DETECT') {- ensureOffscreen()- .then(() => chrome.runtime.sendMessage({ type: 'offscreen:ai:detect', text: msg.text }))- .then((res) => {- if (res?.entities) {- const patterns = res.entities.map((e: { text: string }) => e.text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));- sendResponse({ patterns });- } else {- sendResponse({ patterns: [] });- }- })- .catch(() => sendResponse({ patterns: [] }));- return true;- }-- return false;+ onMessage('blurAiDetect', async ({ data }) => {+ await ensureOffscreen();+ try {+ const res: any = await chrome.runtime.sendMessage({ type: 'offscreen:ai:detect', text: data.text });+ if (res?.entities) {+ const patterns = res.entities.map((e: { text: string }) => e.text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));+ return { patterns };+ }+ } catch {}+ return { patterns: [] };});});diff --git a/src/entrypoints/content.ts b/src/entrypoints/content.tsindex 9a65306..9efc5f3 100644--- a/src/entrypoints/content.ts+++ b/src/entrypoints/content.ts@@ -12,7 +12,7 @@ import { TabMessage } from '@/lib/tab-messages';const CLEANUP_EVENT = `mimik_cleanup_${browser.runtime.id}`;-function createTabMessageHandler(session: CaptureSession, guideMe: GuideMeController) {+function createTabMessageHandler(session: CaptureSession, guideMe: GuideMeController, blurManager: BlurManager) {return function handleTabMessage(msg: Record<string, unknown>, _sender: unknown, sendResponse: (r: unknown) => void) {if (session.isDisabled) return false;@@ -56,6 +56,11 @@ function createTabMessageHandler(session: CaptureSession, guideMe: GuideMeControsendResponse({ stopped: true });return true;+ case TabMessage.START_BLUR:+ if (window.self === window.top) blurManager.start();+ sendResponse({ started: true });+ return true;+default:return false;}@@ -86,38 +91,22 @@ export default defineContentScript({const guideMe = new GuideMeController();const blurManager = new BlurManager();guideMe.start();- const handleTabMessage = createTabMessageHandler(session, guideMe);- const isTopFrame = window.self === window.top;- let removeBlurListener: (() => void) | null = null;+ const handleTabMessage = createTabMessageHandler(session, guideMe, blurManager);document.addEventListener(CLEANUP_EVENT, () => {session.dispose();guideMe.dispose();browser.runtime.onMessage.removeListener(handleTabMessage);blurManager.stop();- removeBlurListener?.();});window.addEventListener('beforeunload', () => session.stop());browser.runtime.onMessage.addListener(handleTabMessage);syncWithBackground(session);- if (isTopFrame) {- const blurHandler = (changes: Record<string, { newValue?: unknown }>) => {- if (!('mimikBlurMode' in changes)) return;- if (changes.mimikBlurMode?.newValue === true) {- blurManager.start();- } else {- blurManager.stop();- }- };- browser.storage.local.onChanged.addListener(blurHandler);- removeBlurListener = () => browser.storage.local.onChanged.removeListener(blurHandler);-- document.addEventListener('mimik-blur:done', () => {- browser.storage.local.set({ mimikBlurMode: false });- sendMessage('exitBlurMode', undefined).catch(() => {});- });- }++ document.addEventListener('mimik-blur:done', () => {+ sendMessage('exitBlurMode', undefined).catch(() => {});+ });logger.info('Content script loaded β', window.location.href);},diff --git a/src/lib/messaging.ts b/src/lib/messaging.tsindex a794d3f..1dfb7ad 100644--- a/src/lib/messaging.ts+++ b/src/lib/messaging.ts@@ -99,6 +99,14 @@ export interface ExitBlurModeResponse {exited: boolean;}+export interface BlurAiDetectData {+ text: string;+}++export interface BlurAiDetectResponse {+ patterns: string[];+}+interface MimikProtocol {getState(): GetStateResponse;startRecording(data: StartRecordingData): StartRecordingResponse;@@ -113,6 +121,7 @@ interface MimikProtocol {guideMePrev(data: GuideMe_PrevData): GuideMe_PrevResponse;enterBlurMode(): EnterBlurModeResponse;exitBlurMode(): ExitBlurModeResponse;+ blurAiDetect(data: BlurAiDetectData): BlurAiDetectResponse;}export const { sendMessage, onMessage } = defineExtensionMessaging<MimikProtocol>();diff --git a/src/lib/tab-messages.ts b/src/lib/tab-messages.tsindex a79d3d2..5072154 100644--- a/src/lib/tab-messages.ts+++ b/src/lib/tab-messages.ts@@ -8,6 +8,7 @@ export const TabMessage = {SHOW_OVERLAY: 'SHOW_OVERLAY',SHOW_NOTIFICATION: 'SHOW_NOTIFICATION',GUIDEME_STOP: 'GUIDEME_STOP',+ START_BLUR: 'START_BLUR',} as const;export type TabMessageType = (typeof TabMessage)[keyof typeof TabMessage];diff --git a/src/ui/sidepanel/RecordingView.tsx b/src/ui/sidepanel/RecordingView.tsxindex 490de46..8f8fb5c 100644--- a/src/ui/sidepanel/RecordingView.tsx+++ b/src/ui/sidepanel/RecordingView.tsx@@ -85,8 +85,8 @@ export default function RecordingView({ guideId, onStop }: RecordingViewProps) {setIsBlurring(false);}};- chrome.storage.local.onChanged.addListener(handler);- return () => chrome.storage.local.onChanged.removeListener(handler);+ chrome.storage.onChanged.addListener(handler);+ return () => chrome.storage.onChanged.removeListener(handler);}, []);const handleDeleteStep = useCallback(