π¬ 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
import { i18n } from '#imports';
import { REDACT_ATTR } from '@/core/blur/redactor';
import { PICKED_CLASS } from '@/core/blur/styles';
import { isMimikElement } from '@/core/capture/dom/element-utils';
import { createOverlayRoot } from '@/core/capture/dom/overlay-root';
import { svgElement } from '@/core/capture/dom/svg-element';
import { HoverRing } from '@/lib/hover-ring';
const RING_COLOR = '#7C3AED';
const STYLES = `
:host {
position: fixed;
inset: 0;
z-index: 2147483645;
pointer-events: none;
}
.bar {
position: fixed;
bottom: 0;
left: 0;
right: 0;
background: rgba(255, 255, 255, 0.97);
backdrop-filter: blur(8px);
border-top: 1px solid #C7D2FE;
padding: 10px 18px;
display: flex;
align-items: center;
justify-content: space-between;
pointer-events: auto;
font-family: 'Poppins', system-ui, sans-serif;
}
.bar-left {
display: flex;
align-items: center;
gap: 8px;
font-size: 12px;
font-weight: 500;
color: #1E1B4B;
}
.bar-left svg { color: #7C3AED; }
.bar-done {
padding: 6px 16px;
border-radius: 8px;
font-size: 11px;
font-weight: 600;
border: none;
cursor: pointer;
font-family: inherit;
background: #1E1B4B;
color: #C7D2FE;
}
`;
export class ElementPicker {
private host: HTMLElement | null = null;
private ring = new HoverRing(RING_COLOR);
private listeners: [string, EventListener, AddEventListenerOptions][] = [];
private onDone: (() => void) | null = null;
start(onDone: () => void) {
this.onDone = onDone;
this.mount();
this.listeners = [
['click', this.onClick.bind(this), { capture: true }],
['mousedown', this.suppress.bind(this), { capture: true }],
['mouseup', this.suppress.bind(this), { capture: true }],
['pointerdown', this.suppress.bind(this), { capture: true }],
['pointerup', this.suppress.bind(this), { capture: true }],
['mouseover', this.onMouseOver.bind(this), { capture: true, passive: true }],
['mouseout', this.onMouseOut.bind(this), { capture: true, passive: true }],
];
for (const [event, handler, opts] of this.listeners) {
window.addEventListener(event, handler, opts);
}
document.documentElement.style.cursor = 'pointer';
}
stop() {
for (const [event, handler, opts] of this.listeners) {
window.removeEventListener(event, handler, opts);
}
this.listeners = [];
this.host?.remove();
this.host = null;
this.ring.dispose();
document.documentElement.style.removeProperty('cursor');
}
private mount() {
const { host, shadow } = createOverlayRoot(STYLES);
this.host = host;
const bar = document.createElement('div');
bar.className = 'bar';
const left = document.createElement('div');
left.className = 'bar-left';
left.append(
svgElement(
'<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>',
),
` ${i18n.t('blurPanel.selectElements')}`,
);
bar.append(left);
const doneBtn = document.createElement('button');
doneBtn.className = 'bar-done';
doneBtn.textContent = i18n.t('blurPanel.done');
doneBtn.addEventListener('click', () => this.onDone?.());
bar.appendChild(doneBtn);
shadow.appendChild(bar);
document.documentElement.appendChild(this.host);
}
private suppress(e: Event) {
if (e.target instanceof Element && isMimikElement(e.target)) return;
e.stopImmediatePropagation();
}
private onClick(e: Event) {
const raw = (e as MouseEvent).target;
if (!raw || !(raw instanceof HTMLElement)) return;
if (isMimikElement(raw)) return;
e.preventDefault();
e.stopImmediatePropagation();
this.toggleBlur(raw);
}
private toggleBlur(el: HTMLElement) {
if (el.classList.contains(PICKED_CLASS)) {
el.classList.remove(PICKED_CLASS);
el.removeAttribute(REDACT_ATTR);
} else {
el.classList.add(PICKED_CLASS);
el.setAttribute(REDACT_ATTR, 'manual');
}
}
private onMouseOver(e: Event) {
const raw = (e as MouseEvent).target;
if (!raw || !(raw instanceof HTMLElement) || isMimikElement(raw)) return;
this.ring.show(raw);
}
private onMouseOut() {
this.ring.hide();
}
}