revert: drop expandable flag tables, use plain markdown tables

The pure-CSS checkbox hack for expandable flag containers didn't work
reliably in mkdocs-material. Revert to plain full markdown tables with
command descriptions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: bordumb

crates/xtask/src/gen_docs.rs

@@ -401,10 +401,7 @@ pub fn run(workspace_root: &Path, check: bool) -> Result<()> {
     Ok(())
 }
 
-/// Run `auths <args> -h` and render a description + HTML flag table.
-///
-/// The first 5 flags are shown immediately. If more exist, an expandable
-/// `<details>` section exposes the rest.
+/// Run `auths <args> -h` and render a description + markdown flag table.
 fn generate_table(binary: &Path, args: &[&str]) -> Result<String> {
     let mut full_args: Vec<&str> = args.to_vec();
     full_args.push("-h");
@@ -421,84 +418,29 @@ fn generate_table(binary: &Path, args: &[&str]) -> Result<String> {
     let description = extract_description(&text);
     let rows = parse_help_rows(&text)?;
 
-    let mut html = String::new();
+    let mut out = String::new();
     if !description.is_empty() {
-        html.push_str(&description);
-        html.push_str("\n\n");
+        out.push_str(&description);
+        out.push_str("\n\n");
     }
 
     if rows.is_empty() {
-        html.push_str("_No options._");
-        return Ok(html);
-    }
-
-    const VISIBLE: usize = 5;
-    let has_overflow = rows.len() > VISIBLE;
-
-    // Each expandable section needs a unique id so multiple sections on the
-    // same page don't conflict. We derive it from the first flag name.
-    let section_id = rows
-        .first()
-        .map(|(f, _, _)| {
-            f.chars()
-                .filter(|c| c.is_ascii_alphanumeric() || *c == '-')
-                .collect::<String>()
-        })
-        .unwrap_or_default();
-
-    if has_overflow {
-        html.push_str(&format!(
-            "<div class=\"flags-container\">\n\
-             <input type=\"checkbox\" id=\"flags-{section_id}\" class=\"flags-state\">\n"
-        ));
-    }
-
-    html.push_str("<table>\n<thead><tr>");
-    html.push_str("<th>Flag</th><th>Default</th><th>Description</th>");
-    html.push_str("</tr></thead>\n<tbody>\n");
-
-    for (i, (flag, default, desc)) in rows.iter().enumerate() {
-        if i == VISIBLE && has_overflow {
-            html.push_str("</tbody>\n<tbody class=\"flags-overflow\">\n");
-        }
-        write_html_row(&mut html, flag, default, desc);
+        out.push_str("_No options._");
+        return Ok(out);
     }
 
-    html.push_str("</tbody>\n</table>\n");
-
-    if has_overflow {
-        html.push_str(&format!(
-            "<label for=\"flags-{section_id}\" class=\"flags-toggle\">\
-             <span class=\"flags-show\">Show all flags</span>\
-             <span class=\"flags-hide\">Show less</span>\
-             </label>\n</div>\n"
-        ));
+    out.push_str("| Flag | Default | Description |\n");
+    out.push_str("|------|---------|-------------|\n");
+    for (flag, default, desc) in rows {
+        let d = if default.is_empty() {
+            "—".to_string()
+        } else {
+            format!("`{default}`")
+        };
+        let desc = desc.replace('|', "\\|");
+        out.push_str(&format!("| `{flag}` | {d} | {desc} |\n"));
     }
-
-    Ok(html)
-}
-
-/// Write a single `<tr>` for the flag table.
-fn write_html_row(html: &mut String, flag: &str, default: &str, desc: &str) {
-    let d = if default.is_empty() {
-        "—".to_string()
-    } else {
-        format!("<code>{}</code>", escape_html(default))
-    };
-    html.push_str(&format!(
-        "<tr><td><code>{}</code></td><td>{}</td><td>{}</td></tr>\n",
-        escape_html(flag),
-        d,
-        escape_html(desc),
-    ));
-}
-
-/// Minimal HTML escaping for table cell content.
-fn escape_html(s: &str) -> String {
-    s.replace('&', "&amp;")
-        .replace('<', "&lt;")
-        .replace('>', "&gt;")
-        .replace('"', "&quot;")
+    Ok(out)
 }
 
 /// Extract the command description from clap's help output.

docs/stylesheets/extra.css

@@ -408,85 +408,6 @@ body {
     border-color: var(--md-default-fg-color--lightest);
 }
 
-/* ----------------------------------------
-   FLAGS TOGGLE (CLI docs)
-   Pure-CSS expandable flag tables.
-   A hidden checkbox + label controls overflow.
-   ---------------------------------------- */
-.flags-container {
-    position: relative;
-    border: 1px solid #e5e7eb;
-    border-radius: 8px;
-    overflow: hidden;
-    margin-bottom: 1rem;
-}
-
-[data-md-color-scheme="slate"] .flags-container {
-    border-color: #2a2a3a;
-}
-
-/* Remove default table border inside container */
-.flags-container table {
-    margin: 0 !important;
-    border: none !important;
-    border-radius: 0 !important;
-    width: 100%;
-}
-
-/* Hidden checkbox drives the state — use offscreen positioning
-   instead of display:none so label `for` always toggles it */
-.flags-state {
-    position: absolute;
-    opacity: 0;
-    pointer-events: none;
-}
-
-/* Overflow rows hidden by default */
-.flags-container .flags-overflow {
-    display: none;
-}
-
-/* When checked, show overflow rows — must beat the rule above */
-.flags-container .flags-state:checked ~ table .flags-overflow {
-    display: table-row-group;
-}
-
-.flags-state:checked ~ .flags-toggle .flags-show {
-    display: none;
-}
-
-.flags-state:not(:checked) ~ .flags-toggle .flags-hide {
-    display: none;
-}
-
-/* Toggle label — centered at container bottom */
-.flags-toggle {
-    display: block;
-    text-align: center;
-    padding: 0.45em 0;
-    font-size: 0.8rem;
-    font-weight: 500;
-    color: #5b21b6;
-    background: #f8fafc;
-    border-top: 1px solid #e5e7eb;
-    cursor: pointer;
-    user-select: none;
-    transition: background 0.2s;
-}
-
-.flags-toggle:hover {
-    background: rgba(91, 33, 182, 0.06);
-}
-
-[data-md-color-scheme="slate"] .flags-toggle {
-    color: #a78bfa;
-    background: #12121a;
-    border-top-color: #2a2a3a;
-}
-
-[data-md-color-scheme="slate"] .flags-toggle:hover {
-    background: rgba(167, 139, 250, 0.1);
-}
 
 /* ----------------------------------------
    RESPONSIVE