let d = import "../defaults.ncl" in

d.make_mode String {
  id      = "validate-hydration",
  trigger = "Validate SSR/WASM hydration parity for routes that opt into the Leptos hydration profile: scan for empty HashMap in *Client components, verify SsrTranslator usage, and check FTL registry population. Guards the rendering-mode dimension.",

  preconditions = [
    "code/crates/ exists",
    "rg (ripgrep) available on PATH",
  ],

  steps = [
    {
      id     = "scan-empty-hashmap",
      action = "Scan for HashMap::new() in *Client page components. Any hit in a lang_content context is a hydration violation — the client must hydrate the same content the server rendered.",
      cmd    = "rg 'HashMap::new\\(\\)' code/crates/ --type rust -g '*client*' -g '*Client*' --count 2>/dev/null || echo '0 — clean: no HashMap::new() in Client components'",
      actor  = 'Both,
      on_error = { strategy = 'Continue },
    },
    {
      id     = "verify-ssr-translator",
      action = "Verify *Client page components use SsrTranslator or build_page_content_patterns so translations resolve identically on server and client.",
      cmd    = "rg 'SsrTranslator' code/crates/ --type rust --count 2>/dev/null || echo '0 — SsrTranslator not referenced yet'",
      actor  = 'Both,
      on_error = { strategy = 'Continue },
    },
    {
      id     = "verify-ftl-registry",
      action = "Verify the WASM FTL registry is populated during client initialization (populate_wasm_ftl_registry or equivalent) so the hydration path has the same locale bundles as SSR.",
      cmd    = "rg 'populate_wasm_ftl_registry|wasm_ftl' code/crates/client/ 2>/dev/null || echo '— FTL registry hook not found (expected until a route opts into hydration)'",
      actor  = 'Both,
      depends_on = [
        { step = "scan-empty-hashmap" },
        { step = "verify-ssr-translator" },
      ],
      on_error = { strategy = 'Continue },
    },
    {
      id     = "report",
      action = "Report hydration parity status. Any empty-HashMap hit in a Client component blocks the rendering-mode transition to dual-mode-verified. Since the site defaults to the HTMX profile, this mode is advisory until routes opt into hydration.",
      actor  = 'Both,
      depends_on = [{ step = "verify-ftl-registry" }],
      on_error = { strategy = 'Stop },
    },
  ],
}