[capjan]

What

Dashboard groups can now be folded, a row of the most used links can lead the page, status checks can be limited to some groups, and readers can switch to a compact view. Together they let a start page hold many links without showing them all at once.

Fold groups

• Every group label is a button that folds the group to its label; a folded label shows its number of tiles.
• New front matter options:
  • collapsed: true, one heading, or a list of headings that start folded (matched case-insensitively).
  • limit: each group shows its first tiles and a Show N more button for the rest. A group with only one tile past the limit shows it instead of a button.
• The filter still searches every tile, including folded groups and tiles past the limit; while it has text, every group shows its matches. Selecting a label while filtering clears the filter and opens that group.
• The reader's choices stay in localStorage per page (a folder's / and index.html share one entry). collapsed and limit only set the start.
• A link to a folded group or to anything inside it opens the group in full.

Frequently used

• New option frequent: a number, or true for 6. It adds a row of the links this reader opens most above the groups.
• Opening a tile by click, middle click, or Enter in the filter counts in localStorage per page; nothing leaves the browser. A link shows after two uses, ranked by uses with a 30-day half-life, so the row follows current habits. At most 50 links are kept, and links that are no longer on the page are skipped.
• The row changes only on the next visit, never under the pointer. It steps aside while the filter has text, so matches appear once, and the link count leaves the copies out. Clear forgets the counts.

Tiles, status, and compact view

• Every tile has two lines: its description, or else its host. A host that only repeats the name (GitHub, github.com) leaves the second line empty, so tiles in a group line up.
• status now also takes one heading or a list of headings; only the tiles of those groups are checked. A group label shows N offline for its unreachable sites, counting each address once, so a folded group still shows that something is down.
• New option compact: true starts the page in a view with names only and narrower tiles. A toolbar button (shown only with JavaScript) switches between the views, and the reader's choice stays per page.
• Subheadings, paragraphs, and lists without links after the last shown tile fold with the tiles past the limit.

Why

Large dashboards (dozens of links in a dozen groups) were hard to scan because everything had the same weight. Folding keeps everything one click or keystroke away, the frequently used row brings the daily links to the top without curating them by hand, and the compact view and per-group status reduce visual noise further.

Notes for reviewers

• Res/Js/dashboard-folds.js is inlined right after the groups. It enables folding, applies saved choices, and fills the frequently used row before the first paint, so there is no layout jump. Without JavaScript nothing folds, the labels stay disabled buttons, every tile is visible, and the frequently used row stays hidden.
• The frequently used row holds clones of tiles with fresh cell ids. dashboard.js leaves them out of the filter, the folds, and the rows it hides. With status: true, each address is requested once, so a tile and its copy share the answer.
• Group tiles are counted up front (IsTile, without rendering), so notes past the limit fold with their tiles.
• dashboard-folds.js shares its fold, scoring, and storage helpers with dashboard.js through the dashboard element, so both scripts follow one rule. Stored entries without a valid count or time are ignored and pruned.
• Footnote references in a group heading are placed after the button, so they keep their links; other links in a heading keep only their text, because a button cannot contain a link.
• Keyboard: labels, Show more, Clear, and the view switch use the standard focus ring (3px offset); typing on them continues in the filter, as on tiles.
• Docs: new "Fold groups" and "Frequently used" sections and options in Docs/Features/Dashboard.md; the example dashboard uses limit: 2, collapsed: [Icons], and frequent: 4; the options example shows status: [Operations] and compact.

Testing

• dotnet test Mdu.sln passes; new tests cover option parsing, folding markup, limits, single-overflow, notes, footnotes, the inline script, the hidden frequently used row, status groups, the compact view, and content folded past the limit.
• mdu lint Docs reports no errors.
• Checked in mdu serve at desktop and phone widths, in light and dark mode: keyboard focus, filtering into folded groups, Show more, saved state across reloads, fragment links, behavior without the fold script, for the frequently used row its ranking, counting, filtering, and Clear, the offline count of status groups, and the compact view switch.