Functions

Produces a filesystem-safe, cross-platform slug from a logical filename.

Neutralizes every character Windows forbids in a filename (< > : " / \\ | ? *) plus .. traversal, so a malformed entity/namespace name – or an overloaded C++ operator function whose own name IS one of these characters (confirmed crash: operator| produced function_operator|.html, rejected by Windows with Invalid argument during a real Kernel SDK render) – can never produce an illegal or output-directory-escaping path. Kept deliberately minimal so it matches the pre-existing per-family behaviour for every ordinary name and only adds* uniform escaping the per-language _resolve_base_filename hooks don’t already cover (some handle */& themselves for C++ pointer/ reference types; re-escaping here is idempotent, a harmless no-op for characters already gone by the time this runs). A single trailing extension (.html/.md) is preserved and the intentional __ scope separator is left intact.

Produces a safe HTML id attribute value from a raw entity name.

Unlike sanitize_filename_slug, this targets HTML id semantics, not filesystem safety: a primary template’s display name carries its formal parameter list with literal </>/whitespace (e.g. "NwExchangeTraits< NwExchangeType::kNw2Ifc >") – valid inside a double-quoted HTML attribute per spec, but the whitespace and angle brackets break #id-style CSS/JS selectors and anchor-link ergonomics. Collapses any run of characters outside [A-Za-z0-9_-] to a single underscore, trims leading/trailing underscores, and falls back to a literal “_” for an empty/all-punctuation input so the id is never blank.