diff design_system/src/component_catalog.js @ 258:60a876c4587a

[ui] Add semantic primitive ownership Build a layered Zenbu token and sizing system, make authored controls use native-underneath primitives, migrate mrjunejune without imposing visual surfaces, and document/enforce HTML ownership in the catalog and wiki. Co-authored-by: Copilot <[email protected]>
author MrJuneJune <me@mrjunejune.com>
date Wed, 05 Aug 2026 05:25:40 -0700
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/design_system/src/component_catalog.js	Wed Aug 05 05:25:40 2026 -0700
@@ -0,0 +1,818 @@
+/** @const {!ReadonlyArray<!Object>} Component concepts shown by the catalog. */
+export const componentCatalog = [
+  {
+    name: "Accordion",
+    slug: "accordion",
+    element: "zen-accordion",
+    group: "Disclosure",
+    description: "A group of native details elements with optional single-open behavior.",
+    markup: `<zen-accordion>
+  <details open><summary>Is it accessible?</summary><p>It keeps native details and summary semantics.</p></details>
+  <details><summary>Can several open?</summary><p>Add the multiple attribute to allow it.</p></details>
+</zen-accordion>`,
+  },
+  {
+    name: "Alert",
+    slug: "alert",
+    element: "zen-alert",
+    group: "Feedback",
+    description: "Status messaging with semantic tones and optional dismissal.",
+    existing: true,
+  },
+  {
+    name: "Alert Dialog",
+    slug: "alert-dialog",
+    element: "zen-alert-dialog",
+    group: "Overlays",
+    description: "A native modal dialog for decisions that require confirmation.",
+    markup: `<zen-alert-dialog>
+  <zen-button size="md" variant="danger">
+    <button type="button" data-zen-trigger>Delete deployment</button>
+  </zen-button>
+  <dialog>
+    <h3>Delete deployment?</h3>
+    <p>This action cannot be undone.</p>
+    <zen-button size="md" variant="quiet">
+      <button type="button" data-zen-close>Cancel</button>
+    </zen-button>
+    <zen-button size="md" variant="danger">
+      <button type="button" value="confirm" data-zen-close>Delete</button>
+    </zen-button>
+  </dialog>
+</zen-alert-dialog>`,
+  },
+  {
+    name: "Aspect Ratio",
+    slug: "aspect-ratio",
+    element: "zen-aspect-ratio",
+    group: "Layout",
+    description: "A media frame driven by a readable ratio attribute.",
+    markup: `<zen-aspect-ratio ratio="16/9">
+  <div class="demo-media">16 / 9</div>
+</zen-aspect-ratio>`,
+  },
+  {
+    name: "Attachment",
+    slug: "attachment",
+    element: "zen-attachment",
+    group: "Chat",
+    description: "File and upload state presentation using ordinary links and buttons.",
+    markup: `<zen-attachment state="complete">
+  <span aria-hidden="true">PDF</span>
+  <div><strong>release-notes.pdf</strong><small>248 KB · Ready</small></div>
+  <button type="button" aria-label="Remove attachment"><zen-icon name="close"></zen-icon></button>
+</zen-attachment>`,
+  },
+  {
+    name: "Avatar",
+    slug: "avatar",
+    element: "zen-avatar",
+    group: "Display",
+    description: "A compact identity image with a visible text fallback.",
+    markup: `<zen-avatar aria-label="June Park"><span>JP</span></zen-avatar>`,
+  },
+  {
+    name: "Badge",
+    slug: "badge",
+    element: "zen-badge",
+    group: "Display",
+    description: "A small label for metadata, state, or counts.",
+    markup: `<zen-stack direction="row">
+  <zen-badge>Default</zen-badge>
+  <zen-badge tone="success">Healthy</zen-badge>
+  <zen-badge tone="danger">Failed</zen-badge>
+</zen-stack>`,
+  },
+  {
+    name: "Breadcrumb",
+    slug: "breadcrumb",
+    element: "zen-breadcrumb",
+    group: "Navigation",
+    description: "A native navigation landmark for hierarchical location.",
+    markup: `<zen-breadcrumb>
+  <nav><ol>
+    <li><a href="/">Home</a></li>
+    <li><a href="/components">Components</a></li>
+    <li aria-current="page">Breadcrumb</li>
+  </ol></nav>
+</zen-breadcrumb>`,
+  },
+  {
+    name: "Bubble",
+    slug: "bubble",
+    element: "zen-bubble",
+    group: "Chat",
+    description: "A message bubble with incoming and outgoing alignment.",
+    markup: `<zen-stack>
+  <zen-bubble><p>The deployment is ready.</p></zen-bubble>
+  <zen-bubble align="end"><p>Ship it.</p></zen-bubble>
+</zen-stack>`,
+  },
+  {
+    name: "Box",
+    slug: "box",
+    element: "zen-box",
+    group: "Layout",
+    description: "A container with canonical xs through xl padding.",
+    markup: `<zen-stack direction="row">
+  <zen-box padding="xs">XS padding</zen-box>
+  <zen-box padding="sm">SM padding</zen-box>
+  <zen-box padding="md">MD padding</zen-box>
+  <zen-box padding="lg">LG padding</zen-box>
+  <zen-box padding="xl">XL padding</zen-box>
+</zen-stack>`,
+  },
+  {
+    name: "Button",
+    slug: "button",
+    element: "zen-button",
+    group: "Actions",
+    description: "Native buttons and links with shared variants and states.",
+    existing: true,
+  },
+  {
+    name: "Button Group",
+    slug: "button-group",
+    element: "zen-button-group",
+    group: "Actions",
+    description: "Related native buttons joined into one visual control.",
+    markup: `<zen-button-group aria-label="Text alignment">
+  <button type="button">Left</button>
+  <button type="button">Center</button>
+  <button type="button">Right</button>
+</zen-button-group>`,
+  },
+  {
+    name: "Calendar",
+    slug: "calendar",
+    element: "zen-calendar",
+    group: "Forms",
+    description: "A first-party date month grid backed by a native form value.",
+    markup: `<zen-calendar>
+  <label for="calendar-demo">Release date</label>
+  <input id="calendar-demo" type="date" value="2026-08-04" />
+</zen-calendar>`,
+  },
+  {
+    name: "Card",
+    slug: "card",
+    element: "zen-card",
+    group: "Display",
+    description: "A visual container around native article or section content.",
+    existing: true,
+  },
+  {
+    name: "Carousel",
+    slug: "carousel",
+    element: "zen-carousel",
+    group: "Collections",
+    description: "A scroll-snap collection with native buttons and keyboard controls.",
+    markup: `<zen-carousel aria-label="Recent projects">
+  <div data-zen-viewport>
+    <article>Mercurial forge</article>
+    <article>HLS player</article>
+    <article>LaTeX editor</article>
+  </div>
+  <button type="button" data-zen-prev aria-label="Previous slide"><zen-icon name="arrow-left"></zen-icon></button>
+  <button type="button" data-zen-next aria-label="Next slide"><zen-icon name="arrow-right"></zen-icon></button>
+</zen-carousel>`,
+  },
+  {
+    name: "Chart",
+    slug: "chart",
+    element: "zen-chart",
+    group: "Data",
+    description: "A dependency-free chart frame for semantic labels and custom marks.",
+    markup: `<zen-chart aria-label="Build minutes by day">
+  <div data-zen-chart-plot>
+    <span style="--zen-chart-value: 42%" data-label="Mon"></span>
+    <span style="--zen-chart-value: 76%" data-label="Tue"></span>
+    <span style="--zen-chart-value: 58%" data-label="Wed"></span>
+    <span style="--zen-chart-value: 88%" data-label="Thu"></span>
+  </div>
+</zen-chart>`,
+  },
+  {
+    name: "Checkbox",
+    slug: "checkbox",
+    element: "zen-checkbox",
+    group: "Forms",
+    description: "A styled native checkbox that remains form-associated.",
+    markup: `<zen-checkbox>
+  <label><input type="checkbox" checked /> Include deployment artifacts</label>
+</zen-checkbox>`,
+  },
+  {
+    name: "Collapsible",
+    slug: "collapsible",
+    element: "zen-collapsible",
+    group: "Disclosure",
+    description: "A single native details disclosure.",
+    markup: `<zen-collapsible>
+  <details><summary>Three changed files</summary><p>server.c, styles.css, README.md</p></details>
+</zen-collapsible>`,
+  },
+  {
+    name: "Combobox",
+    slug: "combobox",
+    element: "zen-combobox",
+    group: "Forms",
+    description: "A filterable text input backed by an accessible option list.",
+    markup: `<zen-combobox>
+  <label for="repo-combobox">Repository</label>
+  <input id="repo-combobox" autocomplete="off" placeholder="Find repository" />
+  <div role="listbox">
+    <button type="button" role="option" data-value="zenbu">zenbu</button>
+    <button type="button" role="option" data-value="hg-web">hg-web</button>
+    <button type="button" role="option" data-value="seobeo">seobeo</button>
+  </div>
+</zen-combobox>`,
+  },
+  {
+    name: "Command",
+    slug: "command",
+    element: "zen-command",
+    group: "Navigation",
+    description: "A keyboard-first filterable command list.",
+    markup: `<zen-command>
+  <input type="search" aria-label="Commands" placeholder="Type a command" />
+  <div role="menu">
+    <button type="button" role="menuitem" data-value="new">New repository</button>
+    <button type="button" role="menuitem" data-value="deploy">Deploy release</button>
+    <button type="button" role="menuitem" data-value="theme">Toggle theme</button>
+  </div>
+</zen-command>`,
+  },
+  {
+    name: "Context Menu",
+    slug: "context-menu",
+    element: "zen-context-menu",
+    group: "Menus",
+    description: "A right-click menu with keyboard navigation and native buttons.",
+    markup: `<zen-context-menu>
+  <div data-zen-trigger tabindex="0">Right-click this repository</div>
+  <div role="menu" hidden>
+    <button type="button" role="menuitem">Open</button>
+    <button type="button" role="menuitem">Clone</button>
+    <button type="button" role="menuitem">Archive</button>
+  </div>
+</zen-context-menu>`,
+  },
+  {
+    name: "Data Table",
+    slug: "data-table",
+    element: "zen-data-table",
+    group: "Data",
+    description: "A native table enhanced with optional client-side sorting.",
+    markup: `<zen-data-table>
+  <table>
+    <thead><tr>
+      <th><button type="button" data-zen-sort="name">Repository</button></th>
+      <th><button type="button" data-zen-sort="commits">Commits</button></th>
+    </tr></thead>
+    <tbody>
+      <tr><td data-key="name">seobeo</td><td data-key="commits">87</td></tr>
+      <tr><td data-key="name">hg-web</td><td data-key="commits">142</td></tr>
+      <tr><td data-key="name">design-system</td><td data-key="commits">12</td></tr>
+    </tbody>
+  </table>
+</zen-data-table>`,
+  },
+  {
+    name: "Date Picker",
+    slug: "date-picker",
+    element: "zen-date-picker",
+    group: "Forms",
+    description: "A tokenized date trigger and first-party keyboard calendar.",
+    markup: `<zen-date-picker>
+  <label for="date-picker-demo">Deploy on</label>
+  <input id="date-picker-demo" type="date" />
+</zen-date-picker>`,
+  },
+  {
+    name: "Dialog",
+    slug: "dialog",
+    element: "zen-dialog",
+    group: "Overlays",
+    description: "A native modal dialog with trigger and close wiring.",
+    markup: `<zen-dialog>
+  <zen-button size="md">
+    <button type="button" data-zen-trigger>Edit profile</button>
+  </zen-button>
+  <dialog>
+    <h3>Edit profile</h3>
+    <zen-field>
+      <label>Display name</label>
+      <input value="June" />
+    </zen-field>
+    <zen-button size="md">
+      <button type="button" data-zen-close>Done</button>
+    </zen-button>
+  </dialog>
+</zen-dialog>`,
+  },
+  {
+    name: "Direction",
+    slug: "direction",
+    element: "zen-direction",
+    group: "Utilities",
+    description: "A light-DOM boundary for left-to-right or right-to-left content.",
+    markup: `<zen-direction dir="rtl"><p>مرحبا بالعالم</p></zen-direction>`,
+  },
+  {
+    name: "Drawer",
+    slug: "drawer",
+    element: "zen-drawer",
+    group: "Overlays",
+    description: "A native dialog presented as an edge drawer.",
+    markup: `<zen-drawer placement="bottom">
+  <zen-button size="md">
+    <button type="button" data-zen-trigger>Open drawer</button>
+  </zen-button>
+  <dialog>
+    <h3>Build queue</h3>
+    <p>Two jobs are running.</p>
+    <zen-button size="md">
+      <button type="button" data-zen-close>Close</button>
+    </zen-button>
+  </dialog>
+</zen-drawer>`,
+  },
+  {
+    name: "Dropdown Menu",
+    slug: "dropdown-menu",
+    element: "zen-dropdown-menu",
+    group: "Menus",
+    description: "A button-owned action menu with arrow-key navigation.",
+    markup: `<zen-dropdown-menu>
+  <button type="button" data-zen-trigger>Repository actions</button>
+  <div role="menu" hidden>
+    <button type="button" role="menuitem">Clone</button>
+    <button type="button" role="menuitem">Bookmark</button>
+    <button type="button" role="menuitem">Archive</button>
+  </div>
+</zen-dropdown-menu>`,
+  },
+  {
+    name: "Empty",
+    slug: "empty",
+    element: "zen-empty",
+    group: "Feedback",
+    description: "A structured empty state with an optional native action.",
+    markup: `<zen-empty>
+  <strong>No deployments yet</strong>
+  <p>Create the first release from the current default branch.</p>
+  <zen-button size="md"><button type="button">Create deployment</button></zen-button>
+</zen-empty>`,
+  },
+  {
+    name: "Field",
+    slug: "field",
+    element: "zen-field",
+    group: "Forms",
+    description: "Label, help text, validity, and a native form control.",
+    existing: true,
+  },
+  {
+    name: "Form",
+    slug: "form",
+    element: "zen-form",
+    group: "Forms",
+    description: "A native form boundary with visible browser validity state.",
+    markup: `<zen-form>
+  <form>
+    <zen-field><label>Repository name</label><input required /><small>Required</small></zen-field>
+    <zen-button size="md"><button type="submit">Create</button></zen-button>
+  </form>
+</zen-form>`,
+  },
+  {
+    name: "Hover Card",
+    slug: "hover-card",
+    element: "zen-hover-card",
+    group: "Overlays",
+    description: "Supplemental content shown on hover or keyboard focus.",
+    markup: `<zen-hover-card>
+  <a href="#" data-zen-trigger>@mrjunejune</a>
+  <div data-zen-content hidden><strong>June Park</strong><p>Building Zenbu in C and native HTML.</p></div>
+</zen-hover-card>`,
+  },
+  {
+    name: "Heading",
+    slug: "heading",
+    element: "zen-heading",
+    group: "Typography",
+    description: "Strong native headings on the canonical type scale.",
+    markup: `<zen-stack>
+  <zen-heading size="xs"><h3>Extra small heading</h3></zen-heading>
+  <zen-heading size="sm"><h3>Small heading</h3></zen-heading>
+  <zen-heading size="md"><h3>Medium heading</h3></zen-heading>
+  <zen-heading size="lg"><h3>Large heading</h3></zen-heading>
+  <zen-heading size="xl"><h3>Extra large heading</h3></zen-heading>
+</zen-stack>`,
+  },
+  {
+    name: "Input",
+    slug: "input",
+    element: "zen-input",
+    group: "Forms",
+    description: "A styled native input with no replacement semantics.",
+    markup: `<zen-input><input type="email" placeholder="[email protected]" aria-label="Email" /></zen-input>`,
+  },
+  {
+    name: "Input Group",
+    slug: "input-group",
+    element: "zen-input-group",
+    group: "Forms",
+    description: "A native input with prefix, suffix, or inline actions.",
+    markup: `<zen-input-group>
+  <span aria-hidden="true">https://</span>
+  <input aria-label="Host" value="zenbu.babocoder.com" />
+  <button type="button">Copy</button>
+</zen-input-group>`,
+  },
+  {
+    name: "Input OTP",
+    slug: "input-otp",
+    element: "zen-input-otp",
+    group: "Forms",
+    description: "A single native one-time-code input with visual slots.",
+    markup: `<zen-input-otp>
+  <label for="otp-demo">Verification code</label>
+  <input id="otp-demo" inputmode="numeric" autocomplete="one-time-code" maxlength="6" />
+  <div data-zen-otp-slots aria-hidden="true"></div>
+</zen-input-otp>`,
+  },
+  {
+    name: "Item",
+    slug: "item",
+    element: "zen-item",
+    group: "Display",
+    description: "A flexible list row for an icon, content, and actions.",
+    markup: `<zen-item>
+  <zen-icon name="repository"></zen-icon>
+  <div><strong>hg-web</strong><small>Updated two minutes ago</small></div>
+  <zen-button size="sm" variant="quiet"><button type="button">Open</button></zen-button>
+</zen-item>`,
+  },
+  {
+    name: "Kbd",
+    slug: "kbd",
+    element: "zen-kbd",
+    group: "Display",
+    description: "Keyboard shortcut presentation using native kbd elements.",
+    markup: `<p>Open commands with <zen-kbd><kbd>Ctrl</kbd><span>+</span><kbd>K</kbd></zen-kbd>.</p>`,
+  },
+  {
+    name: "Label",
+    slug: "label",
+    element: "zen-label",
+    group: "Forms",
+    description: "A styled native label that keeps browser association.",
+    markup: `<zen-label><label for="label-demo">Branch name</label></zen-label>
+<zen-input><input id="label-demo" value="default" /></zen-input>`,
+  },
+  {
+    name: "Link",
+    slug: "link",
+    element: "zen-link",
+    group: "Navigation",
+    description: "A native link with optional reusable first-party effects.",
+    markup: `<zen-link effect="paw">
+  <a href="/components/link">A link with the paw effect</a>
+</zen-link>`,
+  },
+  {
+    name: "Marker",
+    slug: "marker",
+    element: "zen-marker",
+    group: "Chat",
+    description: "An inline system marker for chat and activity streams.",
+    markup: `<zen-marker><span>Today</span></zen-marker>`,
+  },
+  {
+    name: "Menubar",
+    slug: "menubar",
+    element: "zen-menubar",
+    group: "Menus",
+    description: "A horizontal application menu using native buttons and menu roles.",
+    markup: `<zen-menubar>
+  <button type="button" data-zen-trigger>File</button>
+  <div role="menu" hidden><button role="menuitem">New</button><button role="menuitem">Open</button></div>
+  <button type="button" data-zen-trigger>View</button>
+  <div role="menu" hidden><button role="menuitem">Graph</button><button role="menuitem">History</button></div>
+</zen-menubar>`,
+  },
+  {
+    name: "Message",
+    slug: "message",
+    element: "zen-message",
+    group: "Chat",
+    description: "An avatar, author, and content row for conversations.",
+    markup: `<zen-message>
+  <zen-avatar aria-label="June"><span>JP</span></zen-avatar>
+  <div><strong>June</strong><zen-bubble><p>Can we deploy this release?</p></zen-bubble></div>
+</zen-message>`,
+  },
+  {
+    name: "Message Scroller",
+    slug: "message-scroller",
+    element: "zen-message-scroller",
+    group: "Chat",
+    description: "A chat viewport that follows new content until the reader scrolls away.",
+    markup: `<zen-message-scroller>
+  <div data-zen-viewport>
+    <p>Worker connected.</p><p>Build started.</p><p>Bundle created.</p><p>Deployment complete.</p>
+  </div>
+  <button type="button" data-zen-scroll-end hidden>Jump to latest</button>
+</zen-message-scroller>`,
+  },
+  {
+    name: "Native Select",
+    slug: "native-select",
+    element: "zen-native-select",
+    group: "Forms",
+    description: "A styled native select with full platform behavior.",
+    markup: `<zen-native-select><select aria-label="Environment"><option>Development</option><option>Production</option></select></zen-native-select>`,
+  },
+  {
+    name: "Navigation Menu",
+    slug: "navigation-menu",
+    element: "zen-navigation-menu",
+    group: "Navigation",
+    description: "Top-level navigation with optional keyboard-accessible flyouts.",
+    markup: `<zen-navigation-menu>
+  <nav aria-label="Products">
+    <button type="button" data-zen-trigger>Projects</button>
+    <div role="menu" hidden><a role="menuitem" href="/components">Zenbu UI</a><a role="menuitem" href="/">hg-web</a></div>
+    <a href="/tokens">Tokens</a>
+  </nav>
+</zen-navigation-menu>`,
+  },
+  {
+    name: "Pagination",
+    slug: "pagination",
+    element: "zen-pagination",
+    group: "Navigation",
+    description: "Page navigation built from native links.",
+    markup: `<zen-pagination>
+  <nav><a href="#">Previous</a><a href="#">1</a><a href="#" aria-current="page">2</a><a href="#">3</a><a href="#">Next</a></nav>
+</zen-pagination>`,
+  },
+  {
+    name: "Popover",
+    slug: "popover",
+    element: "zen-popover",
+    group: "Overlays",
+    description: "A lightweight panel using the native Popover API when available.",
+    markup: `<zen-popover>
+  <zen-button size="md">
+    <button type="button" data-zen-trigger>Open settings</button>
+  </zen-button>
+  <div data-zen-content>
+    <strong>Dimensions</strong>
+    <zen-field><label>Width</label><input value="100%" /></zen-field>
+  </div>
+</zen-popover>`,
+  },
+  {
+    name: "Progress",
+    slug: "progress",
+    element: "zen-progress",
+    group: "Feedback",
+    description: "A styled native progress element.",
+    markup: `<zen-progress><label for="progress-demo">Uploading</label><progress id="progress-demo" value="68" max="100">68%</progress></zen-progress>`,
+  },
+  {
+    name: "Radio Group",
+    slug: "radio-group",
+    element: "zen-radio-group",
+    group: "Forms",
+    description: "A fieldset of native radio inputs.",
+    markup: `<zen-radio-group>
+  <fieldset><legend>Visibility</legend>
+    <label><input type="radio" name="visibility" checked /> Public</label>
+    <label><input type="radio" name="visibility" /> Private</label>
+  </fieldset>
+</zen-radio-group>`,
+  },
+  {
+    name: "Resizable",
+    slug: "resizable",
+    element: "zen-resizable",
+    group: "Layout",
+    description: "Two native panels separated by a pointer and keyboard handle.",
+    markup: `<zen-resizable>
+  <section data-zen-panel>Repository tree</section>
+  <div data-zen-handle tabindex="0"></div>
+  <section data-zen-panel>File preview</section>
+</zen-resizable>`,
+  },
+  {
+    name: "Scroll Area",
+    slug: "scroll-area",
+    element: "zen-scroll-area",
+    group: "Layout",
+    description: "A bounded native scroll container with theme-aware scrollbars.",
+    markup: `<zen-scroll-area tabindex="0">
+  <p>default</p><p>feature/design-system</p><p>release/2026-08</p><p>experiment/trading</p>
+</zen-scroll-area>`,
+  },
+  {
+    name: "Select",
+    slug: "select",
+    element: "zen-select",
+    group: "Forms",
+    description: "A native select styled as the default accessible implementation.",
+    markup: `<zen-select><label>Branch <select><option>default</option><option>stable</option></select></label></zen-select>`,
+  },
+  {
+    name: "Separator",
+    slug: "separator",
+    element: "zen-separator",
+    group: "Layout",
+    description: "A native horizontal rule or ARIA separator.",
+    markup: `<div>Repository</div><zen-separator><hr /></zen-separator><div>Changesets</div>`,
+  },
+  {
+    name: "Sheet",
+    slug: "sheet",
+    element: "zen-sheet",
+    group: "Overlays",
+    description: "A native dialog presented from a selected screen edge.",
+    markup: `<zen-sheet placement="right">
+  <zen-button size="md">
+    <button type="button" data-zen-trigger>Open filters</button>
+  </zen-button>
+  <dialog>
+    <h3>Filters</h3>
+    <zen-field><label>Author</label><input /></zen-field>
+    <zen-button size="md">
+      <button type="button" data-zen-close>Apply</button>
+    </zen-button>
+  </dialog>
+</zen-sheet>`,
+  },
+  {
+    name: "Sidebar",
+    slug: "sidebar",
+    element: "zen-sidebar",
+    group: "Navigation",
+    description: "A collapsible navigation region with an explicit native trigger.",
+    markup: `<zen-sidebar open>
+  <button type="button" data-zen-sidebar-trigger>Toggle sidebar</button>
+  <aside data-zen-sidebar-panel><nav><a href="/">Overview</a><a href="/components">Components</a><a href="/tokens">Tokens</a></nav></aside>
+</zen-sidebar>`,
+  },
+  {
+    name: "Skeleton",
+    slug: "skeleton",
+    element: "zen-skeleton",
+    group: "Feedback",
+    description: "A reduced-motion-safe placeholder for pending content.",
+    markup: `<zen-stack>
+  <zen-skeleton shape="circle"></zen-skeleton>
+  <zen-skeleton></zen-skeleton>
+  <zen-skeleton width="60%"></zen-skeleton>
+</zen-stack>`,
+  },
+  {
+    name: "Slider",
+    slug: "slider",
+    element: "zen-slider",
+    group: "Forms",
+    description: "A native range input with browser keyboard and pointer behavior.",
+    markup: `<zen-slider><label for="slider-demo">Volume</label><input id="slider-demo" type="range" value="65" /></zen-slider>`,
+  },
+  {
+    name: "Notifications",
+    slug: "notifications",
+    element: "zen-notifications",
+    group: "Feedback",
+    description: "A bounded, scoped notification stack.",
+    existing: true,
+  },
+  {
+    name: "Spinner",
+    slug: "spinner",
+    element: "zen-spinner",
+    group: "Feedback",
+    description: "A small CSS loading indicator with status semantics.",
+    markup: `<zen-spinner aria-label="Loading repositories"></zen-spinner>`,
+  },
+  {
+    name: "Switch",
+    slug: "switch",
+    element: "zen-switch",
+    group: "Forms",
+    description: "A native checkbox presented with switch semantics.",
+    markup: `<zen-switch><label><input type="checkbox" checked /> Automatic deployment</label></zen-switch>`,
+  },
+  {
+    name: "Table",
+    slug: "table",
+    element: "zen-table",
+    group: "Data",
+    description: "Responsive styling around a native HTML table.",
+    markup: `<zen-table><table>
+  <caption>Recent changesets</caption>
+  <thead><tr><th>Revision</th><th>Author</th></tr></thead>
+  <tbody><tr><td>253:fdf3816959cb</td><td>June</td></tr><tr><td>252:7a7581f040e8</td><td>June</td></tr></tbody>
+</table></zen-table>`,
+  },
+  {
+    name: "Tabs",
+    slug: "tabs",
+    element: "zen-tabs",
+    group: "Disclosure",
+    description: "ARIA tabs with automatic or manual keyboard activation.",
+    markup: `<zen-tabs>
+  <div role="tablist" aria-label="Repository views">
+    <button type="button" role="tab" data-value="files">Files</button>
+    <button type="button" role="tab" data-value="history">History</button>
+    <button type="button" role="tab" data-value="graph">Graph</button>
+  </div>
+  <section role="tabpanel">Browse repository files.</section>
+  <section role="tabpanel">Inspect changesets.</section>
+  <section role="tabpanel">View branch topology.</section>
+</zen-tabs>`,
+  },
+  {
+    name: "Textarea",
+    slug: "textarea",
+    element: "zen-textarea",
+    group: "Forms",
+    description: "A styled native multiline text control.",
+    markup: `<zen-textarea><textarea aria-label="Commit message" placeholder="Describe this change"></textarea></zen-textarea>`,
+  },
+  {
+    name: "Text",
+    slug: "text",
+    element: "zen-text",
+    group: "Typography",
+    description: "Native text on the canonical xs through xl type scale.",
+    markup: `<zen-stack>
+  <zen-text size="xs"><p>Extra small text</p></zen-text>
+  <zen-text size="sm"><p>Small text</p></zen-text>
+  <zen-text size="md"><p>Medium text</p></zen-text>
+  <zen-text size="lg"><p>Large text</p></zen-text>
+  <zen-text size="xl"><p>Extra large text</p></zen-text>
+</zen-stack>`,
+  },
+  {
+    name: "Toast",
+    slug: "toast",
+    element: "zen-notifications",
+    group: "Feedback",
+    description: "The deprecated toast concept maps to zen-notifications.",
+    markup: `<zen-alert tone="warning"><p><strong>Toast is deprecated.</strong> Use <code>zen-notifications</code> for scoped transient messages.</p></zen-alert>`,
+  },
+  {
+    name: "Toggle",
+    slug: "toggle",
+    element: "zen-toggle",
+    group: "Actions",
+    description: "A native button with managed pressed state.",
+    markup: `<zen-toggle><button type="button">Bold</button></zen-toggle>`,
+  },
+  {
+    name: "Toggle Group",
+    slug: "toggle-group",
+    element: "zen-toggle-group",
+    group: "Actions",
+    description: "Single or multiple pressed-state buttons with roving keyboard focus.",
+    markup: `<zen-toggle-group type="single" value="center" aria-label="Alignment">
+  <button type="button" value="left">Left</button>
+  <button type="button" value="center">Center</button>
+  <button type="button" value="right">Right</button>
+</zen-toggle-group>`,
+  },
+  {
+    name: "Tooltip",
+    slug: "tooltip",
+    element: "zen-tooltip",
+    group: "Overlays",
+    description: "A delayed, non-interactive description for hover and focus.",
+    markup: `<zen-tooltip>
+  <zen-button size="sm" variant="quiet">
+    <button type="button" data-zen-trigger aria-label="Add repository"><zen-icon name="add"></zen-icon></button>
+  </zen-button>
+  <span data-zen-content hidden>Add repository</span>
+</zen-tooltip>`,
+  },
+  {
+    name: "Typography",
+    slug: "typography",
+    element: "zen-typography",
+    group: "Foundations",
+    description: "Readable defaults for native headings, paragraphs, lists, and code.",
+    markup: `<zen-typography>
+  <h2>The Mercurial forge</h2>
+  <p>Typography stays semantic and inherits Zenbu tokens.</p>
+  <blockquote>Own the stack, understand the stack.</blockquote>
+</zen-typography>`,
+  },
+];
+
+/** @const {number} Number of component concepts in the catalog. */
+export const componentConceptCount = componentCatalog.length;