π¬ 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 { logger } from '@mimik/core/logger';
import { createActor } from 'xstate';
import { captureStateUpdate } from '@/core/capture/capture-state-update';
import { type CaptureSnapshot, captureMachine } from '@/core/capture/machine';
import { sessionStorage } from '@/lib/browser-api/session-storage';
import type { PanelStateUpdate } from '@/lib/port/types';
import type { ActorRef } from './types';
const STORAGE_KEY = 'machineSnapshot';
let actor: ActorRef;
let readyResolve!: () => void;
const readyPromise = new Promise<void>((resolve) => {
readyResolve = resolve;
});
export function waitUntilReady(): Promise<void> {
return readyPromise;
}
export function getActor(): ActorRef {
return actor;
}
export async function initActor(): Promise<void> {
try {
const result = await sessionStorage.get(STORAGE_KEY);
const snapshot = (result[STORAGE_KEY] as CaptureSnapshot) ?? undefined;
actor = createActor(captureMachine, { snapshot });
actor.start();
logger.info('Actor restored from snapshot β state:', actor.getSnapshot().value);
} catch (err) {
logger.warn('Failed to restore snapshot, starting fresh', err);
await sessionStorage.remove(STORAGE_KEY);
actor = createActor(captureMachine);
actor.start();
}
actor.subscribe(() => {
const snap = actor.getSnapshot();
logger.debug('State transition β', snap.value, '| steps:', snap.context.stepCount);
sessionStorage.set({ [STORAGE_KEY]: actor.getPersistedSnapshot() });
});
readyResolve();
logger.info('Actor ready');
}
export function getStateUpdate(): PanelStateUpdate {
return { type: 'STATE_UPDATE', ...captureStateUpdate(actor.getSnapshot()) };
}
export function initActorFallback(): void {
logger.error(' initActor failed, starting fresh');
actor = createActor(captureMachine);
actor.start();
readyResolve();
}