@gemboss/website-ui 0.7.0 → 0.8.0

package/AGENTS.md

@@ -10,10 +10,11 @@ Files you will use, all inside `node_modules/@gemboss/website-ui/`:
 | file | what it is |
 |---|---|
 | `website.css` | the whole kit, one file (tokens, base, layout, components, sections) |
-| `js/website.js` | header, mega menu, mobile menu, theme toggle, scroll reveal, segmented control, busy buttons, an article's contents and its tables' scroll box, the footer's folds; no dependencies; `window.gwWebsite.init(root)` |
+| `js/website.js` | header, mega menu, mobile menu (and its drill-down), language switcher, theme toggle, scroll reveal, segmented control, busy buttons, an article's contents and its tables' scroll box, the footer's folds; no dependencies; `window.gwWebsite.init(root)` |
 | `js/website.mjs` | the same script as an ES module for apps: `import { init, destroy } from '@gemboss/website-ui/website.mjs'` |
 | `system.json` | every value of the system: colours, spacing, type, radii, shadows, widths |
 | `templates/page.html` | the page skeleton: start every new page from it |
+| `templates/header.html` | the header of every site, with its two options (the drill-down mobile menu, the language switcher): fill it once, in the site's shared partial |
 | `templates/footer.html` | the footer of every site (the footer of gemboss.ai): fill it once, in the site's shared partial |
 | `templates/sections/*.html` | ready sections: hero, features, split, showcase, logos, stats, steps, pricing, FAQ, CTA, prose, article, post list, a short form, testimonials… |
 | `demo/index.html` | every component on one page: open it to see what exists before you build anything |
@@ -21,6 +22,7 @@ Files you will use, all inside `node_modules/@gemboss/website-ui/`:
 | `demo/article.html`, `demo/blog.html` | a whole blog post (breadcrumbs, meta, contents, prose, callouts, FAQ) and the blog index (post list, pagination) |
 | `demo/forms.html` | fields in every state, choices, the footer newsletter, a short form, stars, the testimonial wall and the rating badge |
 | `demo/footer.html` | the full footer (Ask AI, columns that fold on phones, family rows, theme toggle, wordmark), and the same for a GemPages-style brand |
+| `demo/header.html` | the header of gemboss.ai: the mobile menu that drills down with its bar of actions, and the language switcher, and the same for a GemPages-style brand |
 | `docs/components.md` | every class, what it is for, its variants |
 | `docs/theming.md` | what a brand other than GemBoss chooses (accent, wash, logo, three named profiles), and what it must not change |
 
@@ -101,6 +103,11 @@ Files you will use, all inside `node_modules/@gemboss/website-ui/`:
   `<summary>`: rows that fold on phones, open columns from 768px, no script needed. A link that leaves the site gets the
   ↗ (`.gw-footer__ext`); one with `target="_blank"` also `<span class="gw-visually-hidden"> (opens in a new tab)</span>`.
   The wordmark is `aria-hidden="true"`.
+- **Header** (0.8.0): `templates/header.html`. Two options. The mobile menu drills down (`data-gw-menu="drill"`): each
+  group carries its head, `<button class="gw-mobile-menu__back">` and `<h2 class="gw-mobile-menu__title" tabindex="-1">`
+  in the page's language, and the actions sit in a bar at the bottom. The language switcher (`.gw-lang`, kept `hidden`,
+  its list empty) lists the page's `<link rel="alternate" hreflang>` from `<head>` and shows itself when there is
+  another language; its word for "Language" goes in `data-gw-label-language`.
 - **Ratings** (0.6.0): stars `.gw-stars` (`role="img"`, `aria-label="4.9 out of 5"`, `style="--gw-stars: 4.9"`), the
   wall `.gw-testimonials` of `.gw-card.gw-testimonial`, the badge `.gw-rating-badge` (`templates/sections/testimonials.html`).
 - **One choice out of two to four** (Monthly / Yearly) is `.gw-segmented`, a radio group; what each option shows
@@ -147,6 +154,8 @@ Files you will use, all inside `node_modules/@gemboss/website-ui/`:
 - Don't make a callout whose kind only its colour tells: `.gw-callout` starts with its `.gw-callout__label` in words.
 - Don't type separators (›, /, >) between breadcrumbs, and don't build a contents list whose links point at ids the
   page does not have: build it from the article's own h2s.
+- Don't build your own language menu or phone menu, don't type the switcher's links (it reads `<link rel="alternate"
+  hreflang>`), and don't show it on a page that has one language. Don't leave Back in English on a translated page.
 - Don't add a footer part the template does not have, and don't build footer columns that fold with your own script:
   fill `templates/footer.html` (its family rows take another brand's siblings: GemBoss, GemX, GemUpsells on a
   GemPages site). Don't put the assistants' logos in the Ask AI row.
@@ -262,8 +271,9 @@ a waiting button not marked with `aria-busy`, a segmented control without its ra
 with numbers and no caption, an unknown brand profile or one set off `<html>`, `.gw-header--float` off the header,
 words on the accent button below 4.5:1, breadcrumbs without their markup, a contents link to an id that is not on
 the page, a callout without its label, stars without their value in words, a rating or a testimonial without a link to
-its source, a footer fold without its heading in the summary or a wordmark a screen reader reads, and patterns that
-repeat across pages (likely gaps). It does not replace looking at the page at 320px and 1366px.
+its source, a footer fold without its heading in the summary or a wordmark a screen reader reads, a drill-down level
+without its Back or its title, a language switcher shown by the markup or a translation without `hreflang`, and
+patterns that repeat across pages (likely gaps). It does not replace looking at the page at 320px and 1366px.
 
 ## 11. Upgrading the kit
 

package/CHANGELOG.md

@@ -4,6 +4,75 @@ Every release lists what changed for a site that uses the kit. A release that ad
 says so with `Closes gap #N` (the GitHub issue number), so `npx gemboss-website upgrade` can tell that site which
 stopgap (`kitgap-*`) it can now delete.
 
+## 0.8.0 (2026-10-25)
+
+The header of gemboss.ai on a phone, so the site's header can move onto the kit: a mobile menu that drills down into
+each section with its actions in a bar at the bottom, and the language switcher. Both are options: a header without them
+looks and works exactly as before. The demo index (without its new link), `brand-profiles.html`, `article.html`,
+`blog.html`, `forms.html`, `footer.html` and `theme-example.html` are pixel-identical to 0.7.0 at 390 and 1366px, light
+and dark.
+
+- Drill-down mobile menu, opt-in: `data-gw-menu="drill"` on `.gw-mobile-menu`, as gemboss.ai's phone menu (v4, approved
+  15/10/2026). The markup is the 0.7.0 menu, plus a head in each group: `<div class="gw-mobile-menu__head">` holding
+  `<button class="gw-mobile-menu__back" type="button">Back</button>` and `<h2 class="gw-mobile-menu__title"
+  tabindex="-1">`, in the page's language. The top level lists the sections in 64px rows (24px words, a chevron that
+  points right); a press on one shows its level alone, with Back on the left and its title in the middle; a level may
+  carry headings over runs of links (`.gw-mobile-menu__heading`), a 32px icon tile and a line under a link's name
+  (`.gw-mobile-menu__icon`, `<b>`, `<i>`), and a last link to the section's own page (`.gw-mobile-menu__all`, in the
+  accent, with its arrow). The actions sit in a bar that stays at the bottom of the sheet while the list scrolls: what is
+  not a button on its first line (the language on the left, Sign in on the right), the two buttons side by side under it
+  (`gw-btn--lg`: 48px), one hairline above, the safe area below.
+  Closes gap #41
+- Its script, wired like every other part (one record, `init` once per element, `destroy` takes it back): a press on a
+  section (tap, click, Enter, Space) opens its level and moves the focus to the level's title; Back shows the top level
+  and puts the focus back on the section; Escape closes the sheet from anywhere in it, back on the top level, the focus on
+  the toggle; while it is open, Tab and Shift+Tab go round the toggle and the sheet (the focus trap); the page under it
+  is locked (as in 0.7.0); the sheet starts where the header ends (measured as it opens, `--gw-menu-top`) and the header
+  stays in place, so an announcement bar above it no longer jumps away. A level slides in from the right (0.24s, the
+  kit's ease, transform and opacity), the sections slide back from the left; under `prefers-reduced-motion` they switch
+  at once. Without the script (or before `init`) the groups are the 0.7.0 `<details>` that open in place. `.is-drill`
+  (wired), `.is-drilled` (a level in view) and `.is-back` (the slide back) are the script's states.
+- `gw:menu`, a new event on the menu (`.gw-mobile-menu`), `detail: { open, level }`: `level` is the title of the level
+  in view, `''` for the top level. It fires when a menu opens or closes (every mobile menu, the 0.7.0 one too) and when
+  a drill-down menu moves to a level or back; closing from a level says only `{ open: false, level: '' }`.
+- Language switcher `.gw-lang` (`data-gw-lang`, `hidden` in the markup): a ghost button with the globe and the current
+  language's short code (`.gw-lang__btn`, `.gw-lang__short`), and the list of the other languages (`.gw-lang__menu`), a
+  small popover card with the card radius of the site's profile. `website.js` fills the list from the page's own
+  `<link rel="alternate" hreflang href>` (not `x-default`): the links search engines read, so the switcher offers
+  exactly the translations they are told about, and a page with no other language keeps the switcher hidden (gemboss.ai
+  today, while `liveLangs` is empty). The current language is the one whose `hreflang` is `<html lang>` (else the same
+  base language: `zh` for `zh-Hans`). Each other one is a real link (`.gw-lang__link`, with `hreflang` and `lang`), named
+  in its own language: the `<link>`'s `title`, else the kit's name (English, Tiếng Việt, 中文), else the browser's. A link
+  to the host of `<link rel="canonical">` keeps only its path, so a preview deployment stays on itself. Every `init`
+  reads the links again (a route change). Keyboard: the button opens and closes it; ArrowDown and ArrowUp on it open the
+  list on its first or last link, move in it (wrapping), Home and End; Escape closes it with the focus back on the
+  button, and goes no further; focus leaving it or a click outside closes it. Its words come from the markup:
+  `data-gw-label-language` (else the button's `aria-label`, else "Language") names the button "Language: English" and
+  the list "Language". In the header's actions it shows from 1080px; below, a second one sits in the mobile menu's bar
+  and its list opens upward. No new dependency: it replaces loading `@gemboss/ui`'s plain switcher next to the kit.
+  Closes gap #29
+- Templates: `templates/header.html` shows both options, with comments: the drill-down menu (and how to leave it out),
+  the switcher in the actions and in the bar. `templates/page.html` keeps the 0.7.0 menu.
+- Demo: `demo/header.html`, the header of gemboss.ai with its words, sections, links and icons, the drill-down menu, an
+  announcement bar, and the switcher with three languages (en, vi, zh-Hans) whose alternates point at the demo itself
+  (`?hl=`), with a switch to the same header for a GemPages-style brand (soft corners, the accent button, the floating
+  header from 1080px, GemPages' blue). Linked from `demo/index.html`.
+- `check`: `menu-markup` (an error): in a `data-gw-menu="drill"` menu, a group that is not a `<details>`, has no
+  `<summary>`, no back button, no title, or a title without `tabindex="-1"`; `data-gw-menu` with another value.
+  `lang-markup` (an error): a `.gw-lang` not `hidden` in the markup, without `data-gw-lang`, without its button, a button
+  naming no list inside it or without `aria-expanded`, links typed into its list; and, on a page with a switcher, a
+  translation's `<link rel="alternate">` (no `type`) without `hreflang` or `href`.
+- `AGENTS.md`, the skill and the docs (`components.md`, `markup-contract.md`): the two options, their markup, the
+  script's behaviour and `gw:menu`.
+- Budget: `website.min.css` is 71.8 KB, 12.2 KB gzipped (0.7.0: 65.8 KB, 11.4 KB). `js/website.js` is 20.8 KB
+  unminified, 6.4 KB gzipped (0.7.0: 14.5 KB, 4.7 KB): the test's budget is now 22 KB and 7 KB.
+- Tests: `test/run.mjs` holds the 0.7.0 rules of `header.css` byte for byte and every 0.8.0 rule to a 0.8.0 part, and
+  covers the drill-down menu, the trap, `gw:menu` and the switcher in its fake DOM (which now sets text, has
+  `getClientRects`, style properties, `URL` and `Intl`) and the two rules; `test/browser.mjs` drives `demo/header.html`
+  in Chromium (by touch and by keyboard, the focus, Escape, the trap, the scroll lock, the bar at the bottom of a long
+  level, reduced motion, without the script, the switcher shown and hidden by the head's links, its keys and a real
+  switch to the Vietnamese page, init twice, destroy then init, 320 and 390px light and dark, the GemPages-style switch).
+
 ## 0.7.0 (2026-10-25)
 
 The footer as gemboss.ai has it today (gap #71): the kit's footer, built on 24/10 from gemboss.ai, had fallen behind

package/README.md

@@ -12,11 +12,11 @@ it. Made so that a team working with Claude Code, even without a designer, ships
 
 | | |
 |---|---|
-| `website.css`, `website.min.css` | toàn bộ kit trong một tệp (khoảng 92 KB, 66 KB bản min, 11,4 KB khi nén gzip): token sáng và tối, chữ, bố cục, nút (cả trạng thái nhấn, đang chờ và nút xoá), link, nhãn, chip, segmented control, badge, card (kèm ảnh trên đầu thẻ), khung cửa sổ kèm chú thích "Illustrative data.", bảng, FAQ, chữ bài dài (`.gw-prose`), bộ khung bài blog (breadcrumb, dòng tác giả và ngày, mục lục dính, hộp lưu ý, danh sách bài, phân trang), ô nhập và trạng thái lỗi (ô chữ, danh sách chọn, ô nhiều dòng, checkbox, radio, hàng một ô một nút cho newsletter), sao đánh giá, tường review, huy hiệu điểm App Store, header + mega menu + menu điện thoại, footer như gemboss.ai (cột gập lại trên điện thoại, hàng Ask AI, hàng sản phẩm cùng nhà, nút sáng/tối, wordmark; ô newsletter tuỳ chọn), 16 section, 3 hồ sơ thương hiệu |
-| `js/website.js`, `js/website.mjs` | mega menu, menu điện thoại, đổi giao diện sáng/tối, hiện dần khi cuộn, đánh dấu trang hiện tại, segmented control, chặn bấm lần hai khi nút đang chờ, đánh dấu mục đang đọc trong mục lục bài viết, khung cuộn cho bảng trong bài, cột footer gập/mở theo khổ màn; không phụ thuộc thư viện nào, khoảng 4,7 KB khi nén gzip. `website.js` là script thường (tự chạy khi trang tải xong), `website.mjs` là bản ES module cho app; cả hai có `init(root)` để gắn lại phần markup chèn sau (`docs/markup-contract.md`, mục "Script") |
+| `website.css`, `website.min.css` | toàn bộ kit trong một tệp (khoảng 101 KB, 72 KB bản min, 12,2 KB khi nén gzip): token sáng và tối, chữ, bố cục, nút (cả trạng thái nhấn, đang chờ và nút xoá), link, nhãn, chip, segmented control, badge, card (kèm ảnh trên đầu thẻ), khung cửa sổ kèm chú thích "Illustrative data.", bảng, FAQ, chữ bài dài (`.gw-prose`), bộ khung bài blog (breadcrumb, dòng tác giả và ngày, mục lục dính, hộp lưu ý, danh sách bài, phân trang), ô nhập và trạng thái lỗi (ô chữ, danh sách chọn, ô nhiều dòng, checkbox, radio, hàng một ô một nút cho newsletter), sao đánh giá, tường review, huy hiệu điểm App Store, header + mega menu + menu điện thoại (tuỳ chọn đi sâu từng mục kèm thanh nút dính đáy, như gemboss.ai) + nút đổi ngôn ngữ, footer như gemboss.ai (cột gập lại trên điện thoại, hàng Ask AI, hàng sản phẩm cùng nhà, nút sáng/tối, wordmark; ô newsletter tuỳ chọn), 16 section, 3 hồ sơ thương hiệu |
+| `js/website.js`, `js/website.mjs` | mega menu, menu điện thoại (kể cả bản đi sâu từng mục: Back, giữ focus trong menu, sự kiện `gw:menu`), nút đổi ngôn ngữ (đọc `<link rel="alternate" hreflang>` của trang, ẩn khi trang chỉ có một ngôn ngữ), đổi giao diện sáng/tối, hiện dần khi cuộn, đánh dấu trang hiện tại, segmented control, chặn bấm lần hai khi nút đang chờ, đánh dấu mục đang đọc trong mục lục bài viết, khung cuộn cho bảng trong bài, cột footer gập/mở theo khổ màn; không phụ thuộc thư viện nào, khoảng 6,4 KB khi nén gzip. `website.js` là script thường (tự chạy khi trang tải xong), `website.mjs` là bản ES module cho app; cả hai có `init(root)` để gắn lại phần markup chèn sau (`docs/markup-contract.md`, mục "Script") |
 | `AGENTS.md` | luật mà Claude Code (và người) phải theo: 10 luật, cách dựng trang, điều cấm, chữ, khả năng truy cập, đổi thương hiệu, khi kit thiếu |
-| `templates/` | khung một trang, header, footer (`footer.html`: footer của gemboss.ai, mọi phần tuỳ chọn đều ghi rõ) và 16 section (hero, logos, stats, features, split, showcase, steps, quote, pricing, faq, cta, prose, article, post-list, form, testimonials) |
-| `demo/` | mọi thành phần trên một trang; `theme-example.html` cho thấy một thương hiệu khác đổi màu nhấn; `brand-profiles.html` là một thương hiệu kiểu GemPages bật cả 3 hồ sơ; `article.html` là một bài blog trọn vẹn, `blog.html` là trang danh sách bài; `forms.html` là mọi trạng thái của ô nhập, newsletter ở footer, tường review và huy hiệu điểm (dữ liệu mẫu); `footer.html` là footer đầy đủ như gemboss.ai, kèm nút chuyển sang bản kiểu GemPages |
+| `templates/` | khung một trang, header (`header.html`: hai tuỳ chọn, menu điện thoại đi sâu và nút ngôn ngữ), footer (`footer.html`: footer của gemboss.ai, mọi phần tuỳ chọn đều ghi rõ) và 16 section (hero, logos, stats, features, split, showcase, steps, quote, pricing, faq, cta, prose, article, post-list, form, testimonials) |
+| `demo/` | mọi thành phần trên một trang; `theme-example.html` cho thấy một thương hiệu khác đổi màu nhấn; `brand-profiles.html` là một thương hiệu kiểu GemPages bật cả 3 hồ sơ; `article.html` là một bài blog trọn vẹn, `blog.html` là trang danh sách bài; `forms.html` là mọi trạng thái của ô nhập, newsletter ở footer, tường review và huy hiệu điểm (dữ liệu mẫu); `footer.html` là footer đầy đủ như gemboss.ai, kèm nút chuyển sang bản kiểu GemPages; `header.html` là header của gemboss.ai trên điện thoại (menu đi sâu từng mục, thanh nút dính đáy, nút đổi ngôn ngữ với ba ngôn ngữ), cũng có bản kiểu GemPages |
 | `docs/` | danh mục class (`components.md`), đổi thương hiệu (`theming.md`), triết lý (`philosophy.md`), hợp đồng markup |
 | `system.json` | mọi giá trị của hệ thống (màu, khoảng cách, chữ, bo góc, bóng, khung): nguồn duy nhất |
 | CLI `gemboss-website` | `init`, `check`, `gap`, `upgrade` |
@@ -40,9 +40,9 @@ nó đọc `AGENTS.md` của kit trước, dựng từ mẫu, và chạy `check`
 **Site HTML tĩnh hoặc không có bước build:** dùng CDN của npm, ghim đúng phiên bản.
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@gemboss/website-ui@0.7.0/website.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@gemboss/website-ui@0.8.0/website.min.css">
 <link rel="stylesheet" href="/site.css">   <!-- CSS riêng của site, luôn SAU kit -->
-<script src="https://cdn.jsdelivr.net/npm/@gemboss/website-ui@0.7.0/js/website.js" defer></script>
+<script src="https://cdn.jsdelivr.net/npm/@gemboss/website-ui@0.8.0/js/website.js" defer></script>
 ```
 
 Chèn markup của kit sau khi trang đã tải (block của builder, bản xem trước CMS): gọi `gwWebsite.init(phầnMới)` ngay
@@ -113,7 +113,7 @@ viết hoa vẫn cấm. Công thức và các phép kiểm tương phản: `docs
 | lệnh | làm gì |
 |---|---|
 | `npx gemboss-website init` | nối luật của kit vào Claude Code của dự án (CLAUDE.md + skill) |
-| `npx gemboss-website check` | kiểm mọi `.html` và `.css` của site: màu, khoảng cách, chữ, bo góc ngoài thang, bóng, nút tự tô màu, nhãn viết hoa giãn chữ, đè class `gw-`, đổi token của kit, hồ sơ thương hiệu sai tên hoặc sai chỗ, chữ trên nút màu nhấn dưới 4,5:1, dấu gạch dài, ảnh thiếu `alt`, link mơ hồ, sao thiếu giá trị bằng chữ, điểm hay review không có link nguồn, cột footer gập thiếu tiêu đề trong summary, wordmark không ẩn với trình đọc màn hình… và gợi ý chỗ kit có thể đang thiếu |
+| `npx gemboss-website check` | kiểm mọi `.html` và `.css` của site: màu, khoảng cách, chữ, bo góc ngoài thang, bóng, nút tự tô màu, nhãn viết hoa giãn chữ, đè class `gw-`, đổi token của kit, hồ sơ thương hiệu sai tên hoặc sai chỗ, chữ trên nút màu nhấn dưới 4,5:1, dấu gạch dài, ảnh thiếu `alt`, link mơ hồ, sao thiếu giá trị bằng chữ, điểm hay review không có link nguồn, cột footer gập thiếu tiêu đề trong summary, wordmark không ẩn với trình đọc màn hình, mục của menu đi sâu thiếu nút Back hay tiêu đề, nút ngôn ngữ không ẩn sẵn hay bản dịch thiếu `hreflang`… và gợi ý chỗ kit có thể đang thiếu |
 | `npx gemboss-website gap` | báo một chỗ kit còn thiếu: mở GitHub Issue ở repo của kit (nếu `gh` đã đăng nhập và có quyền), không thì ghi `kit-gaps/<tên>.md` để gửi |
 | `npx gemboss-website upgrade` | so bản đang dùng với bản mới nhất, in thay đổi, gap đã có trong kit, và lệnh nâng cấp |
 
@@ -141,7 +141,7 @@ gemboss-www; mọi thay đổi đi qua PR, giá trị của hệ thống chỉ s
 cd packages/website-ui
 node scripts/build.mjs        # sinh css/tokens.css từ system.json, ghép website.css và website.min.css, sinh js/website.js từ js/website.mjs
 node test/run.mjs             # tự kiểm CLI, CSS và website.js (DOM giả)
-node test/browser.mjs         # demo trong Chromium thật: bài viết (cuộn, Tab, mục lục, bảng), form, sao, review và footer (gập, Tab, nút sáng/tối) (cần .ci của repo)
+node test/browser.mjs         # demo trong Chromium thật: bài viết (cuộn, Tab, mục lục, bảng), form, sao, review, footer (gập, Tab, nút sáng/tối) và header (menu đi sâu bằng chạm và bàn phím, giữ focus, nút ngôn ngữ) (cần .ci của repo)
 node scripts/gate-demo.mjs    # cổng thị giác và khoảng thở của gemboss.ai trên demo (cần .ci của repo)
 ```
 

package/bin/lib/check.mjs

@@ -149,6 +149,16 @@ export const RULES = {
     why: "A footer column folds on phones as a <details class=\"gw-footer__fold\"> whose <summary> holds the column's heading (<h2 class=\"gw-footer__heading\">): the summary is the row a reader taps, and a screen reader names the row by that heading. The wordmark (.gw-footer__wordmark) repeats the brand's name as decoration; without aria-hidden=\"true\" a screen reader reads the name a second time.",
     fix: "Copy the markup from templates/footer.html: <details class=\"gw-footer__fold\"><summary><h2 class=\"gw-footer__heading\">Product</h2></summary><ul>…</ul></details>, and <div class=\"gw-footer__wordmark\" aria-hidden=\"true\">.",
   },
+  "menu-markup": {
+    level: "error", title: "Drill-down menu level without its head",
+    why: "In a mobile menu with data-gw-menu=\"drill\" each <details class=\"gw-mobile-menu__group\"> is a level the reader opens on its own, from its <summary>. Its head is the only way back (a <button class=\"gw-mobile-menu__back\">) and its title (.gw-mobile-menu__title with tabindex=\"-1\") is where website.js puts the focus. Without them a phone visitor is stuck in the level, or a keyboard and a screen reader lose their place. data-gw-menu has one value: drill.",
+    fix: "Copy the group from templates/header.html: <details class=\"gw-mobile-menu__group\"><summary>Product</summary><div class=\"gw-mobile-menu__head\"><button class=\"gw-mobile-menu__back\" type=\"button\">Back</button><h2 class=\"gw-mobile-menu__title\" tabindex=\"-1\">Product</h2></div><ul class=\"gw-mobile-menu__list\">…</ul></details>, with Back in the page's language.",
+  },
+  "lang-markup": {
+    level: "error", title: "Language switcher without its markup",
+    why: "website.js fills .gw-lang from the page's <link rel=\"alternate\" hreflang href> and shows it only when there is another language: it starts hidden, its button (.gw-lang__btn) names its list with aria-controls and says aria-expanded, and the list is empty in the markup. A switcher shown by the markup is an empty button on a page with one language; links typed into the list are replaced; a translation's <link rel=\"alternate\"> without hreflang is one the switcher (and search engines) cannot list.",
+    fix: "Copy the switcher from templates/header.html: <div class=\"gw-lang\" data-gw-lang hidden><button class=\"gw-lang__btn\" type=\"button\" aria-expanded=\"false\" aria-controls=\"gw-lang-menu\">…</button><ul class=\"gw-lang__menu\" id=\"gw-lang-menu\" hidden></ul></div>, and give each translation <link rel=\"alternate\" hreflang=\"vi\" href=\"…\"> in <head>.",
+  },
   "uppercase-text": {
     level: "warning", title: "Uppercase text",
     why: "Headings, buttons, labels and menu items are sentence case.",
@@ -552,7 +562,8 @@ function analyzeHtml(file, text, out) {
   }
 
   const classes = new Set();
-  const ids = new Set(), tocs = [];
+  const ids = new Set(), tocs = [], drills = [], alts = [];
+  let langs = 0;
   let h1 = 0;
   for (const m of scanText.matchAll(TAG_RE)) {
     const tag = m[1].toLowerCase();
@@ -647,6 +658,40 @@ function analyzeHtml(file, text, out) {
       ].filter(Boolean);
       if (missing.length) add("footer-markup", where(`${m[0].replace(/\s+/g, " ").slice(0, 80)}  missing: ${missing.join(", ")}`));
     }
+    if (cls.includes("gw-mobile-menu") && "data-gw-menu" in a) {
+      if (a["data-gw-menu"] !== "drill") add("menu-markup", where(`${m[0].replace(/\s+/g, " ").slice(0, 80)}  missing: data-gw-menu="drill" (the one option; leave the attribute out for the 0.7.0 menu)`));
+      else drills.push([m.index, elementEnd(scanText, m.index, tag)]);
+    }
+    if (cls.includes("gw-mobile-menu__group") && drills.some(([s0, e0]) => m.index > s0 && (e0 < 0 || m.index < e0))) {
+      const body = inner();
+      const t = /<[a-z][\w-]*\b([^>]*\bclass\s*=\s*["'][^"']*\bgw-mobile-menu__title\b[^>]*)>/i.exec(body);
+      const missing = [
+        tag !== "details" && `a <details> (the class is on <${tag}>)`,
+        !/<summary\b/i.test(body) && "a <summary> (the row that opens the level)",
+        !/<button\b[^>]*\bclass\s*=\s*["'][^"']*\bgw-mobile-menu__back\b/i.test(body) && 'a back button (<button class="gw-mobile-menu__back" type="button">)',
+        !t && 'the level\'s title (<h2 class="gw-mobile-menu__title" tabindex="-1">)',
+        t && parseAttrs(t[1]).tabindex !== "-1" && 'tabindex="-1" on the title (the script puts the focus there)',
+      ].filter(Boolean);
+      if (missing.length) add("menu-markup", where(`${m[0].replace(/\s+/g, " ").slice(0, 80)}  missing: ${missing.join(", ")}`));
+    }
+    if (cls.includes("gw-lang")) {
+      langs++;
+      const body = inner();
+      const b = /<button\b([^>]*\bclass\s*=\s*["'][^"']*\bgw-lang__btn\b[^>]*)>/i.exec(body);
+      const ba = b ? parseAttrs(b[1]) : {};
+      const list = ba["aria-controls"] && new RegExp(`<([a-z]+)\\b[^>]*\\bid\\s*=\\s*["']${ba["aria-controls"].replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["'][^>]*>`, "i").exec(body);
+      const missing = [
+        !("hidden" in a) && "hidden (the script shows it when the page has another language)",
+        !("data-gw-lang" in a) && "data-gw-lang",
+        !b && 'a <button class="gw-lang__btn" type="button">',
+        b && !ba["aria-controls"] && "aria-controls on the button, naming its list",
+        b && ba["aria-controls"] && !list && `the list the button names (id="${ba["aria-controls"]}") inside the switcher`,
+        b && !("aria-expanded" in ba) && 'aria-expanded="false" on the button',
+        /<a\b/i.test(body) && "an empty list (the script writes the links from <link rel=\"alternate\" hreflang>)",
+      ].filter(Boolean);
+      if (missing.length) add("lang-markup", where(`${m[0].replace(/\s+/g, " ").slice(0, 80)}  missing: ${missing.join(", ")}`));
+    }
+    if (tag === "link" && /(?:^|\s)alternate(?:\s|$)/i.test(a.rel || "") && !a.type) alts.push({ a, where: where() });
     if (cls.includes("gw-rating-badge") || cls.includes("gw-testimonial")) {
       const linked = (tag === "a" && "href" in a) || /<a\b[^>]*\bhref\s*=/i.test(inner());
       if (!linked) add("rating-source", where(`${m[0].replace(/\s+/g, " ").slice(0, 80)} ${decode(visible.slice(m.index, elementEnd(scanText, m.index, tag))).replace(/\s+/g, " ").trim().slice(0, 60)}`));
@@ -688,6 +733,13 @@ function analyzeHtml(file, text, out) {
       if (!ids.has(id)) add("toc-target", { file: relFile, line: lineAt(t.start + x.index), excerpt: `href="#${x[1]}": no element on the page has id="${id}"` });
     }
   }
+  // A page with a switcher: each translation it links in <head> needs its hreflang and its href.
+  if (langs) {
+    for (const x of alts) {
+      const missing = [!(x.a.hreflang || "").trim() && "hreflang (the switcher lists a translation by it)", !(x.a.href || "").trim() && "href"].filter(Boolean);
+      if (missing.length) add("lang-markup", { ...x.where, excerpt: `${x.where.excerpt}  missing: ${missing.join(", ")}` });
+    }
+  }
   out.pageClasses.push({ file: relFile, classes });
 }
 

package/css/header.css

@@ -261,3 +261,179 @@ html.is-menu-open .gw-header { position: fixed; top: 0; left: 0; right: 0; }
 @supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
   .gw-header--float { background: var(--gw-surface); }
 }
+
+/* ---- 0.8.0: the drill-down mobile menu (gap #41) and the language switcher (gap #29) --------------------------------
+   Every rule below selects a part 0.7.0 does not have (data-gw-menu="drill", the script's .is-drill, the menu's
+   __head, __back, __title, __heading and __icon, .gw-lang), so a 0.7.0 header looks and works exactly as before. */
+
+/* The drill-down menu, as gemboss.ai's phone menu (v4, approved 15/10/2026), opt-in on the sheet:
+   <div class="gw-mobile-menu" data-gw-menu="drill">. Its look needs only the attribute: top-level rows of 64px with
+   24px words and one hairline each, a level's links with an optional icon and line, and the actions in a bar that
+   stays at the bottom of the sheet while the list scrolls (the sheet has no bottom padding, so nothing peeks out under
+   the bar; nor sideways while a level slides in). Without the script the groups are the 0.7.0 <details> that open in
+   place, their chevron pointing down. */
+.gw-mobile-menu[data-gw-menu="drill"] { display: flex; flex-direction: column; overflow-x: hidden; padding-bottom: 0; }
+.gw-mobile-menu[data-gw-menu="drill"] > nav { display: flex; flex: 1 0 auto; flex-direction: column; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__group > summary,
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__top { min-height: 64px; font-size: 24px; letter-spacing: -0.01em; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__group > summary::after { width: 20px; height: 20px; -webkit-mask-size: 20px; mask-size: 20px; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__list { padding: 0; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__list .gw-mobile-menu__link {
+  gap: 12px;
+  min-height: 56px;
+  padding-block: 12px;
+  border-bottom: 1px solid var(--gw-line);
+  color: var(--gw-ink);
+  font-weight: 500;
+}
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__link b { display: block; font-size: 16px; font-weight: 500; line-height: 20px; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__link i { display: block; margin-top: 2px; color: var(--gw-muted); font-size: 13px; font-style: normal; line-height: 18px; }
+/* a level's optional parts: a muted heading over a run of links, a 32px icon tile before a link's words */
+.gw-mobile-menu__heading { padding: 16px 0 8px; color: var(--gw-muted); font-size: 12px; font-weight: 500; line-height: 1.5; }
+.gw-mobile-menu__icon {
+  display: grid;
+  place-items: center;
+  flex: none;
+  width: 32px;
+  height: 32px;
+  border: 1px solid var(--gw-line);
+  border-radius: var(--gw-radius-action);
+  color: var(--gw-muted);
+}
+.gw-mobile-menu__icon svg { width: 16px; height: 16px; }
+/* a level's last link, to the section's own page: its row opens the level instead of going there */
+.gw-mobile-menu__all { display: flex; align-items: center; gap: 6px; min-height: 56px; color: var(--gw-accent-strong); font-size: 16px; font-weight: 500; }
+.gw-mobile-menu__all::after { content: "\2192"; }
+/* the action bar: what is not a button (Sign in, the language) on the first line, the last one on the right; the
+   buttons side by side under it (gw-btn--lg: 48px, as gemboss.ai) */
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__actions {
+  position: sticky;
+  bottom: 0;
+  z-index: 1;
+  grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+  align-items: center;
+  gap: 8px 16px;
+  margin-top: auto;
+  padding-block: 12px calc(12px + env(safe-area-inset-bottom));
+  border-top: 1px solid var(--gw-line);
+  background: var(--gw-bg);
+}
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__actions > .gw-btn { grid-row: 2; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__actions > :not(.gw-btn) { grid-row: 1; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__actions > :not(.gw-btn):last-child { grid-column: 2; justify-self: end; }
+.gw-mobile-menu[data-gw-menu="drill"] .gw-mobile-menu__actions > .gw-mobile-menu__link { color: var(--gw-ink); font-weight: 500; }
+
+/* Wired (.is-drill, set by website.js): a group's row points right and opens its level, which shows alone
+   (.is-drilled) under its head: Back on the left, the level's title in the middle. The sheet starts where the header
+   ends (--gw-menu-top, measured by the script) and the header stays in place, so an announcement bar above it does not
+   jump away. */
+.gw-mobile-menu.is-drill { top: var(--gw-menu-top, calc(var(--gw-header-height) + 1px)); }
+html.is-menu-open .gw-header:has(> .gw-mobile-menu.is-drill) { position: sticky; }
+.gw-mobile-menu.is-drill .gw-mobile-menu__group > summary::after { transform: rotate(-90deg); transition: none; }
+.gw-mobile-menu.is-drilled > nav > :not([open], .gw-mobile-menu__actions),
+.gw-mobile-menu.is-drilled .gw-mobile-menu__group[open] > summary { display: none; }
+.gw-mobile-menu__head { display: none; }
+.gw-mobile-menu.is-drilled .gw-mobile-menu__group[open] > .gw-mobile-menu__head {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
+  align-items: center;
+  gap: 8px;
+  min-height: 56px;
+  margin-bottom: 8px;
+  border-bottom: 1px solid var(--gw-line);
+}
+.gw-mobile-menu__back {
+  display: inline-flex;
+  align-items: center;
+  justify-self: start;
+  gap: 4px;
+  min-height: var(--gw-tap-min);
+  padding: 0 8px 0 0;
+  border: 0;
+  background: transparent;
+  color: var(--gw-muted);
+  font-size: 16px;
+  line-height: 1.5;
+}
+.gw-mobile-menu__back:hover { color: var(--gw-ink); }
+.gw-mobile-menu__back::before {
+  content: "";
+  flex: none;
+  width: 16px;
+  height: 16px;
+  background: currentColor;
+  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M15 18l-6-6 6-6' fill='none' stroke='%23000' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / 16px no-repeat;
+  mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M15 18l-6-6 6-6' fill='none' stroke='%23000' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / 16px no-repeat;
+}
+.gw-mobile-menu__title { color: var(--gw-ink); font-size: 16px; font-weight: 600; letter-spacing: 0; line-height: 1.5; text-align: center; }
+/* a level slides in from the right, the top level back in from the left; under reduced motion they just switch */
+@media (prefers-reduced-motion: no-preference) {
+  .gw-mobile-menu.is-drilled .gw-mobile-menu__group[open] { animation: gw-drill-in 0.24s var(--gw-ease); }
+  .gw-mobile-menu.is-back > nav > :not(.gw-mobile-menu__actions) { animation: gw-drill-back 0.24s var(--gw-ease); }
+}
+@keyframes gw-drill-in { from { opacity: 0; transform: translateX(32px); } }
+@keyframes gw-drill-back { from { opacity: 0; transform: translateX(-32px); } }
+
+/* The language switcher: <div class="gw-lang" data-gw-lang hidden>, a ghost button with the globe and the current
+   language's short code, and its list of the other languages, a small popover card (the card radius of the site's
+   profile, one hairline, the raised shadow). website.js fills the list from the page's <link rel="alternate" hreflang>
+   and takes `hidden` away when there is another language. In the header's actions it shows from 1080px, where the nav
+   is; below that a second one sits in the mobile menu's action bar, and its list opens upward. */
+.gw-lang { position: relative; flex: none; }
+.gw-header__actions > .gw-lang { display: none; }
+.gw-lang__btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 40px;
+  padding: 0 12px;
+  border: 0;
+  border-radius: var(--gw-radius-action);
+  background: transparent;
+  color: var(--gw-ink-2);
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 1.4;
+  white-space: nowrap;
+}
+.gw-lang__btn:hover,
+.gw-lang__btn[aria-expanded="true"] { background: var(--gw-bg-soft); color: var(--gw-ink); }
+.gw-lang__btn svg { flex: none; width: 18px; height: 18px; }
+.gw-lang__menu {
+  position: absolute;
+  top: calc(100% + 8px);
+  right: 0;
+  z-index: 1;
+  display: grid;
+  gap: 2px;
+  min-width: 200px;
+  margin: 0;
+  padding: 8px;
+  list-style: none;
+  border: 1px solid var(--gw-line);
+  border-radius: var(--gw-radius-card);
+  background: var(--gw-surface);
+  box-shadow: var(--gw-shadow-raised);
+}
+.gw-lang__link {
+  display: flex;
+  align-items: center;
+  min-height: 40px;
+  padding: 0 12px;
+  border-radius: var(--gw-radius-action);
+  color: var(--gw-ink);
+  font-size: 14px;
+  font-weight: 500;
+  white-space: nowrap;
+}
+.gw-lang__link:hover { background: var(--gw-bg-soft); }
+.gw-mobile-menu .gw-lang__btn { padding: 0 8px 0 0; color: var(--gw-muted); font-size: 16px; }
+.gw-mobile-menu .gw-lang__btn:hover,
+.gw-mobile-menu .gw-lang__btn[aria-expanded="true"] { background: transparent; color: var(--gw-ink); }
+.gw-mobile-menu .gw-lang__menu { top: auto; right: auto; bottom: calc(100% + 8px); left: 0; }
+@media (max-width: 768px), (pointer: coarse) {
+  .gw-lang__btn, .gw-lang__link { min-height: var(--gw-tap-min); }
+}
+@media (min-width: 1080px) {
+  .gw-header__actions > .gw-lang { display: block; }
+}