SHCD MuchWOW Theme — build validation
=====================================
Theme folder/slug: shcd-muchwow-theme
Theme version: 1.0.0
Framework: Shabnam — توسعه ارتباطات شبنم — shabnam.dev

Source package inspected:
- home-one
- home-two
- home-three
- sign-in
- sign-up
- reset-password
- page-contact
- page-privacy
- page-terms

Demo / Elementor validation:
- Demo one: 9 original wrapper sections -> 9 native MuchWOW Elementor section widgets.
- Demo two: 13 original wrapper sections -> 13 native MuchWOW Elementor section widgets.
- Demo three: 10 original wrapper sections -> 10 native MuchWOW Elementor section widgets.
- No Elementor raw-code widget exists in any of the three demo documents.
- Demo sections expose editable text, image and link controls in Elementor.
- Shop and blog remain dynamic Elementor widgets and are intentionally added before FAQ.
- Original CSS variants remain mapped to main.min.purge.css, theme-two.min.purge.css and theme-three.min.purge.css.

Inner pages:
- Login, registration, password reset, contact, privacy and terms use native Elementor heading/text/shortcode widgets.
- Contact uses the internal [shcd_contact_form] shortcode and stores messages privately in WordPress.
- Contact submissions include phone number, admin-menu badge, admin-bar notification and admin notice.
- Legacy theme-managed inner pages are migrated once with a backup and schema marker.

Page lifecycle / duplicate prevention:
- Page creation is idempotent and keyed by stored ID + a theme-owned registry marker.
- Existing user pages with matching slugs are reused and never overwritten.
- Theme-managed pages are not duplicated when Elementor/WooCommerce/other plugins are activated or deactivated.
- A deleted theme-managed page is restored from Trash when possible, otherwise recreated only when truly missing.
- Elementor documents are seeded only when empty; later activations do not reseed edited content.

Responsive / layout refinements:
- Blog card metadata uses one compact wrapping row with controlled separators and one primary category.
- Light inner-page header follows the second-demo palette and uses readable hover/content colors.
- Auth/contact/legal pages receive stable top spacing, centered page headings and responsive content widths.
- Contact/auth forms use one- or two-column layouts based on viewport width.
- Demo-section Elementor wrappers are neutralized to avoid extra gaps on desktop/tablet/mobile.

Security notes:
- Auth/contact forms use WordPress nonces and admin-post handlers.
- Contact form has a honeypot and per-IP transient rate limit.
- Input is sanitized by expected type and output is escaped.
- Contact messages are private/non-queryable and restricted to administrators.
- Registration uses WordPress account APIs; password-reset response is generic to reduce account enumeration.
- No eval/create_function/custom unserialize was added.

[2026-08-11 Smart UI/Elementor pass]
- Blog archive received additional safe spacing below the floating header.
- Shabnam framework wording standardized around «پوسته» and Persian help copy revised.
- Color preview contrast corrected for selected background/text colors.
- About screen now includes animated macOS-style compatibility diagnostics and support-report actions.
- Plan cards stay synchronized with the active-plan select field.
- Existing generic MuchWOW demo-section widgets migrate in-place to semantic Elementor widget types without rebuilding pages or discarding user settings.
- New semantic widgets: hero, marquee, about, numbers, tokenomics, roadmap, FAQ, features, decoration, newsletter, contact information, contact form.
- Shared Elementor Style controls added for colors, buttons, hover states, typography, padding, radius, alignment and images.
- Managed page creation remains idempotent; no duplicate pages are created by plugin toggles.
- Public theme version remains 1.0.0.

[2026-08-11 SPA / Smart Setup / Health / Performance pass]
- Site-wide internal navigation can use the Shabnam SPA layer: same-origin page content is prefetched/fetched and swapped without a visual loader, with history/back-forward support and a full-page fallback on incompatibility.
- Sensitive actions, downloads, WordPress admin/login URLs, nonce links, cart-removal and add-to-cart actions are excluded from interception.
- Smart Setup Wizard added with the supplied SHCD logo, plan/color/font/content/performance steps and idempotent managed-page provisioning.
- Shabnam Health Center checks WordPress/PHP/Elementor/WooCommerce/REST/memory/permalinks/uploads/HTTPS/WebP/cache/SPA/theme version and builds a copyable support report.
- Shabnam Performance Center adds conservative anonymous page caching, cache TTL/clear controls, theme-script defer, lazy image attributes, mobile animation reduction and WebP generation/serving.
- The cache explicitly excludes personalized/cookie sessions, WooCommerce dynamic/account/cart/checkout pages and nonce-bearing auth/contact pages.
- Speed benchmark records an uncached baseline and an optimized warm/cached HTML response in the same browser; the UI labels optimization percentages as estimates rather than guaranteed PageSpeed values.
- Animated liquid speed meter: green at >=90, orange at 50-89, red below 50.
- Performance diagnostics report likely bottlenecks such as slow PHP generation, excessive query counts, cache misses, large theme assets and remaining JPEG/PNG images.
- JPEG/PNG attachments can be converted to WebP in small REST batches; originals remain intact and generated variants are served only when present.
- Blog single pages support an optional reading-progress bar.
- Homepage blog query now stays entirely inside WP_Query APIs; no raw database query fallback is used.
- Performance REST operations require edit_theme_options plus a valid WordPress REST nonce.
- Public theme version remains 1.0.0 and folder/slug remains shcd-muchwow-theme.
