Homura Time Travel & Form State Engine

Homura Time Travel & Form State Engine brings “Git for application state” and bulletproof state preservation to WordPress forms and WooCommerce checkout.

Rather than acting as a simple, destructive key-value autosave, Homura acts as an agnostic client-side state history layer built on top of your existing form builders. It tracks an immutable timeline of states, allowing users to undo/redo changes, recover from browser crashes or accidental refreshes, and seamlessly transfer their form progress across devices via QR codes.

🌟 Core Reliability (v1.5.1)

• Frozen immutable snapshots: published state is deep-frozen; accidental mutation of getState() cannot corrupt DAG history.

• Real scannable QR handoff: QR codes are generated with a real encoder; oversized payloads fall back to copy-link UX.

• SessionStorage drafts: persist="sessionstorage" / data-homura-persist="sessionstorage" for tab-scoped recovery.

• WooCommerce destroy cleanup: MutationObservers and jQuery hooks are disconnected on form destroy (no listener leaks).

• DevTools shortcut gating: ← / → /Space only while the diagnostic panel is open; playback follows branch-head timeline.

🌟 Revolutionary Features (v1.4.0+)

• 📱 Multidevice Time-Travel (“Passaggio di Testimone”): Generate dynamic QR codes ( [homura_handoff] ) allowing users to scan on desktop and immediately continue typing on mobile with the identical history timeline without registering an account.

• 👻 Behavioral “Ghost Assist” (Sensory UX): Proactively detects mass accidental deletions (>50% of paragraph) and rage-clicks, displaying a non-intrusive recovery toast with 1-click restore.

• 🔒 Privacy-First Zero-Knowledge Local Vault: Native 256-bit AES-GCM encryption using browser WebCrypto API ( crypto="aes-gcm" ). Raw LocalStorage bytes are unreadable by third-party extensions.

• 📝 Visual Copywriting Git Diff & Scrubber: Real-time word-level difference inspector ( [homura_visual_diff] ) with historical slider for long textareas and articles.

• 🧬 State Diff Engine: Inspect exactly what changed between the current form DOM and any saved draft with visual diff inspection.

• 🛡️ WooCommerce AJAX Conflict Recovery: Automatically detects when WooCommerce checkout recalculations ( update_order_review, cart totals) wipe input values and instantly restores them without disrupting user flow.

• 🔐 Zero-Leak Sensitive Field Policy: Passwords, CVVs, credit card numbers, payment nonces, and inputs tagged with data-homura-sensitive="true" or data-homura-persist="false" are strictly excluded from state storage and LocalStorage.

• 📦 Smart Recovery & Time-Travel: Prompt users with a non-intrusive recovery banner ( [homura_recovery_banner] ) allowing them to restore all, review differences, or dismiss previous drafts.

• 🔄 Form Schema Versioning & Migration: Seamlessly handles forms edited or upgraded by webmasters without breaking or corrupting visitor drafts.

• Auto-Hook for Top Form Builders & WooCommerce:

• WooCommerce Checkout (.woocommerce-checkout )

• Contact Form 7 (.wpcf7 form )

• WPForms (.wpforms-form )

• Gravity Forms (.gform_wrapper )

• Elementor Forms (.elementor-form )

• Fluent Forms (.fluentform )

• Ninja Forms (.nf-form-content form )

• Formidable Forms (.frm-show-form )

• WS Form (.wsf-form )

• Performance First: Deferred script execution ( wp_script_add_data ), passive event listeners, zero render blocking, and zero external tracking.

• 100% Client-Side & Local-First: No data is sent to external servers or remote databases.