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.