@cordwainer/cw-elements 1.3.0-alpha.1 → 1.3.0-alpha.3

package/dist/types/vue/index.d.ts

@@ -16,13 +16,13 @@ import type { CwCheckbox } from "../../components/checkbox/checkbox.component.js
 import type { CwColorPicker } from "../../components/color-picker/color-picker.component.js";
 import type { CwCombobox } from "../../components/combobox/combobox.component.js";
 import type { CwCopyButton } from "../../components/copy-button/copy-button.component.js";
-import type { CwDataTableColumn } from "../../components/data-table-column/data-table-column.component.js";
 import type {
   CwDataTable,
   SortChangeEvent,
   CwRowSelectionChangeEvent,
   RowClickEvent,
 } from "../../components/data-table/data-table.component.js";
+import type { CwDataTableColumn } from "../../components/data-table-column/data-table-column.component.js";
 import type { CwDatePicker } from "../../components/date-picker/date-picker.component.js";
 import type { CwDetails } from "../../components/details/details.component.js";
 import type { CwDialog } from "../../components/dialog/dialog.component.js";
@@ -32,6 +32,7 @@ import type { CwDropdown } from "../../components/dropdown/dropdown.component.js
 import type { CwFormatBytes } from "../../components/format-bytes/format-bytes.component.js";
 import type { CwFormatDate } from "../../components/format-date/format-date.component.js";
 import type { CwFormatNumber } from "../../components/format-number/format-number.component.js";
+import type { CwHeader } from "../../components/header/header.component.js";
 import type { CwIcon } from "../../components/icon/icon.component.js";
 import type { CwIconButton } from "../../components/icon-button/icon-button.component.js";
 import type { CwImageComparer } from "../../components/image-comparer/image-comparer.component.js";
@@ -58,6 +59,8 @@ import type { CwRange } from "../../components/range/range.component.js";
 import type { CwRating } from "../../components/rating/rating.component.js";
 import type { CwRelativeTime } from "../../components/relative-time/relative-time.component.js";
 import type { CwResizeObserver } from "../../components/resize-observer/resize-observer.component.js";
+import type { CwSecondaryNavigation } from "../../components/secondary-navigation/secondary-navigation.component.js";
+import type { CwSecondaryNavigationItem } from "../../components/secondary-navigation-item/secondary-navigation-item.component.js";
 import type { CwSelect } from "../../components/select/select.component.js";
 import type { CwSkeleton } from "../../components/skeleton/skeleton.component.js";
 import type { CwSpinner } from "../../components/spinner/spinner.component.js";
@@ -577,26 +580,6 @@ scenarios. */
   "oncw-error"?: (e: CustomEvent<never>) => void;
 };
 
-type CwDataTableColumnProps = {
-  /** The key in each row data object that this column displays. Required. */
-  name?: CwDataTableColumn["name"];
-  /** The column header label. Falls back to `name` if not set. */
-  label?: CwDataTableColumn["label"];
-  /** Makes the column header clickable for sorting. */
-  sortable?: CwDataTableColumn["sortable"];
-  /** A CSS width value for this column, e.g. "200px" or "20%". */
-  width?: CwDataTableColumn["width"];
-  /** A CSS min-width value for this column. */
-  "min-width"?: CwDataTableColumn["minWidth"];
-  /** Alignment of cell content within the column. */
-  align?: CwDataTableColumn["align"];
-  /** Hides the column without removing it from the DOM. */
-  hidden?: CwDataTableColumn["hidden"];
-  /** A custom cell renderer. Called once per row with the cell value, the full row object,
-and this column element. Return a Lit `TemplateResult` or a plain string. */
-  renderCell?: CwDataTableColumn["renderCell"];
-};
-
 type CwDataTableProps = {
   /** The key in each row object used as a stable row identity for selection. Falls back to row index when not set. */
   "row-id"?: CwDataTable["rowId"];
@@ -632,6 +615,26 @@ Each object's keys correspond to column `name` values. */
   "oncw-row-click"?: (e: CustomEvent<RowClickEvent>) => void;
 };
 
+type CwDataTableColumnProps = {
+  /** The key in each row data object that this column displays. Required. */
+  name?: CwDataTableColumn["name"];
+  /** The column header label. Falls back to `name` if not set. */
+  label?: CwDataTableColumn["label"];
+  /** Makes the column header clickable for sorting. */
+  sortable?: CwDataTableColumn["sortable"];
+  /** A CSS width value for this column, e.g. "200px" or "20%". */
+  width?: CwDataTableColumn["width"];
+  /** A CSS min-width value for this column. */
+  "min-width"?: CwDataTableColumn["minWidth"];
+  /** Alignment of cell content within the column. */
+  align?: CwDataTableColumn["align"];
+  /** Hides the column without removing it from the DOM. */
+  hidden?: CwDataTableColumn["hidden"];
+  /** A custom cell renderer. Called once per row with the cell value, the full row object,
+and this column element. Return a Lit `TemplateResult` or a plain string. */
+  renderCell?: CwDataTableColumn["renderCell"];
+};
+
 type CwDatePickerProps = {
   /** The name of the date picker, submitted as a name/value pair with form data. */
   name?: CwDatePicker["name"];
@@ -916,6 +919,32 @@ type CwFormatNumberProps = {
   "maximum-significant-digits"?: CwFormatNumber["maximumSignificantDigits"];
 };
 
+type CwHeaderProps = {
+  /** The viewport width, in pixels, below which the header switches to its stacked mobile layout. */
+  "mobile-breakpoint"?: CwHeader["mobileBreakpoint"];
+  /**  */
+  panel?: CwHeader["panel"];
+  /**  */
+  actionsRow?: CwHeader["actionsRow"];
+  /**  */
+  indicator?: CwHeader["indicator"];
+  /**  */
+  triggers?: CwHeader["triggers"];
+  /** The name of the currently open action panel, or `null` if none is open. Not reflected as an attribute — `null`
+is a legitimate, frequently-reached value here (no panel open), which doesn't play well with `CwElement`'s
+reflected-attribute "morph fix" (`src/internal/cw-element.ts`), designed around properties whose first non-null
+value is a permanent default rather than a value that legitimately toggles back to `null` at runtime. */
+  activePanel?: CwHeader["activePanel"];
+  /** Emitted when an action panel opens. */
+  "oncw-panel-show"?: (e: CustomEvent<{ name: String }>) => void;
+  /** Emitted after an action panel opens and all animations are complete. */
+  "oncw-panel-after-show"?: (e: CustomEvent<{ name: String }>) => void;
+  /** Emitted when an action panel closes. */
+  "oncw-panel-hide"?: (e: CustomEvent<{ name: String }>) => void;
+  /** Emitted after an action panel closes and all animations are complete. */
+  "oncw-panel-after-hide"?: (e: CustomEvent<{ name: String }>) => void;
+};
+
 type CwIconProps = {
   /** The name of the icon to draw. Available names depend on the icon library being used. */
   name?: CwIcon["name"];
@@ -1520,6 +1549,27 @@ type CwResizeObserverProps = {
   "oncw-resize"?: (e: CustomEvent<{ entries: ResizeObserverEntry[] }>) => void;
 };
 
+type CwSecondaryNavigationProps = {
+  /** The accessible label for the `<nav>` landmark. Defaults to a localized "Secondary navigation". */
+  label?: CwSecondaryNavigation["label"];
+  /** Disables the scroll arrows that appear when items overflow. */
+  "no-scroll-controls"?: CwSecondaryNavigation["noScrollControls"];
+  /**  */
+  nav?: CwSecondaryNavigation["nav"];
+};
+
+type CwSecondaryNavigationItemProps = {
+  /** The URL to navigate to. */
+  href?: CwSecondaryNavigationItem["href"];
+  /** Tells the browser where to open the link. Only used when `href` is set. */
+  target?: CwSecondaryNavigationItem["target"];
+  /** The `rel` attribute for the link. Only used when `href` is set. */
+  rel?: CwSecondaryNavigationItem["rel"];
+  /** Indicates this item represents the current page. Reflects `aria-current="page"` on the internal link. The
+component has no router/URL awareness — consumers set this explicitly based on their own routing state. */
+  current?: CwSecondaryNavigationItem["current"];
+};
+
 type CwSelectProps = {
   /** The name of the select, submitted as a name/value pair with form data. */
   name?: CwSelect["name"];
@@ -2451,16 +2501,6 @@ export type CustomElements = {
    */
   "cw-copy-button": DefineComponent<CwCopyButtonProps>;
 
-  /**
-   * Data table columns define the columns of a [data table](/components/data-table).
-   * ---
-   *
-   *
-   * ### **Slots:**
-   *  - _default_ - This element has no rendered output; it is a configuration element only.
-   */
-  "cw-data-table-column": DefineComponent<CwDataTableColumnProps>;
-
   /**
    * Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.
    * ---
@@ -2498,6 +2538,16 @@ export type CustomElements = {
    */
   "cw-data-table": DefineComponent<CwDataTableProps>;
 
+  /**
+   * Data table columns define the columns of a [data table](/components/data-table).
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - This element has no rendered output; it is a configuration element only.
+   */
+  "cw-data-table-column": DefineComponent<CwDataTableColumnProps>;
+
   /**
    * Date pickers let users select a date from a calendar.
    * ---
@@ -2732,6 +2782,53 @@ export type CustomElements = {
    */
   "cw-format-number": DefineComponent<CwFormatNumberProps>;
 
+  /**
+   * Page header region composing branding, primary navigation, icon-triggered action panels, and secondary
+   * navigation into one piece of chrome.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **cw-panel-show** - Emitted when an action panel opens.
+   * - **cw-panel-after-show** - Emitted after an action panel opens and all animations are complete.
+   * - **cw-panel-hide** - Emitted when an action panel closes.
+   * - **cw-panel-after-hide** - Emitted after an action panel closes and all animations are complete.
+   *
+   * ### **Methods:**
+   *  - **showPanel(name: _HeaderAction['name']_)** - Opens the named action panel. No-op if that slot has no content.
+   * - **hidePanel()** - Closes the currently open action panel, if any.
+   *
+   * ### **Slots:**
+   *  - **logo** - A `<cw-logo>`.
+   * - **primary-navigation** - A `<cw-primary-navigation>`.
+   * - **utility** - Content for the utility action panel, opened via a gear icon trigger.
+   * - **search** - Content for the search action panel, opened via a search icon trigger.
+   * - **notification** - Content for the notification action panel, opened via a bell icon trigger.
+   * - **user** - Content for the user/account action panel, opened via a person icon trigger.
+   * - **cart** - Content for the cart action panel, opened via a cart icon trigger.
+   * - **secondary-navigation** - A `<cw-secondary-navigation>`, rendered on its own row below everything else.
+   *
+   * ### **CSS Properties:**
+   *  - **--panel-width** - The width of an open action panel above `mobile-breakpoint`. Below it, panels are always full width. Defaults to `50%`. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper, a `<header>` landmark element.
+   * - **logo** - The container that wraps the slotted logo.
+   * - **primary-navigation** - The container that wraps the slotted primary navigation.
+   * - **actions** - The container that wraps the action triggers.
+   * - **trigger** - Each action trigger, a `<cw-icon-button>`.
+   * - **trigger--utility** - The utility action trigger.
+   * - **trigger--search** - The search action trigger.
+   * - **trigger--notification** - The notification action trigger.
+   * - **trigger--user** - The user action trigger.
+   * - **trigger--cart** - The cart action trigger.
+   * - **trigger__base** - A trigger's exported `base` part.
+   * - **indicator** - The line that highlights the currently open action trigger.
+   * - **panel** - The panel shown below the header when an action trigger is open.
+   * - **secondary-navigation** - The container that wraps the slotted secondary navigation.
+   */
+  "cw-header": DefineComponent<CwHeaderProps>;
+
   /**
    * Icons are symbols that can be used to represent various options within an application.
    * ---
@@ -3298,6 +3395,40 @@ export type CustomElements = {
    */
   "cw-resize-observer": DefineComponent<CwResizeObserverProps>;
 
+  /**
+   * Second-level site navigation for linking pages related to the current one, beneath a
+   * `<cw-primary-navigation>`. A flat, horizontal strip of links — unlike primary navigation, it has no
+   * disclosure/dropdown items; overflow is handled with scroll buttons instead.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - One or more `<cw-secondary-navigation-item>` elements.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper, a `<nav>` landmark element.
+   * - **nav** - The container that wraps the slotted navigation items and the scroll buttons.
+   * - **scroll-button** - The previous/next scroll buttons that show when items overflow, an `<cw-icon-button>`.
+   * - **scroll-button--start** - The starting scroll button.
+   * - **scroll-button--end** - The ending scroll button.
+   * - **scroll-button__base** - The scroll button's exported `base` part.
+   */
+  "cw-secondary-navigation": DefineComponent<CwSecondaryNavigationProps>;
+
+  /**
+   * A link in a `<cw-secondary-navigation>`, pointing to a page related to the current one.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - The item's label content (text, or an icon + text).
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **link** - The internal `<a>`, present only when `href` is set.
+   */
+  "cw-secondary-navigation-item": DefineComponent<CwSecondaryNavigationItemProps>;
+
   /**
    * Selects allow you to choose items from a menu of predefined options.
    * ---

package/dist/utilities/icon-library.js

@@ -2,9 +2,9 @@ import "../chunks/chunk.HAL7R4WT.js";
 import {
   registerIconLibrary,
   unregisterIconLibrary
-} from "../chunks/chunk.XIIPR36B.js";
-import "../chunks/chunk.CJFFVBAI.js";
+} from "../chunks/chunk.YYBORLW3.js";
 import "../chunks/chunk.PLKIFY5H.js";
+import "../chunks/chunk.CJFFVBAI.js";
 import "../chunks/chunk.4EHT37C5.js";
 import "../chunks/chunk.Q44EX5TP.js";
 export {

package/dist/utilities/localize.d.ts

@@ -7,7 +7,9 @@ export interface Translation extends DefaultTranslation {
     $code: string;
     $name: string;
     $dir: 'ltr' | 'rtl';
+    account?: string;
     carousel: string;
+    cart?: string;
     clearEntry: string;
     close: string;
     closeMenu?: string;
@@ -26,6 +28,7 @@ export interface Translation extends DefaultTranslation {
     nextMonth?: string;
     nextPage?: string;
     nextSlide: string;
+    notifications?: string;
     numOptionsSelected: (num: number) => string;
     openMenu?: string;
     pagination?: string;
@@ -39,8 +42,11 @@ export interface Translation extends DefaultTranslation {
     resize: string;
     scrollToEnd: string;
     scrollToStart: string;
+    search?: string;
+    secondaryNavigation?: string;
     selectAColorFromTheScreen: string;
     showPassword: string;
     slideNum: (slide: number) => string;
     toggleColorFormat: string;
+    utility?: string;
 }

package/dist/utilities/localize.js

@@ -1,8 +1,8 @@
 import {
   LocalizeController,
   registerTranslation
-} from "../chunks/chunk.746GMAQ3.js";
-import "../chunks/chunk.47CTIY27.js";
+} from "../chunks/chunk.OFFCHZOX.js";
+import "../chunks/chunk.CYBF35P2.js";
 import "../chunks/chunk.Q44EX5TP.js";
 export {
   LocalizeController,

package/dist/vscode.html-custom-data.json

@@ -840,57 +840,6 @@
         }
       ]
     },
-    {
-      "name": "cw-data-table-column",
-      "description": "Data table columns define the columns of a [data table](/components/data-table).\n---\n\n\n### **Slots:**\n - _default_ - This element has no rendered output; it is a configuration element only.",
-      "attributes": [
-        {
-          "name": "name",
-          "description": "The key in each row data object that this column displays. Required.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "The column header label. Falls back to `name` if not set.",
-          "values": []
-        },
-        {
-          "name": "sortable",
-          "description": "Makes the column header clickable for sorting.",
-          "values": []
-        },
-        {
-          "name": "width",
-          "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
-          "values": []
-        },
-        {
-          "name": "min-width",
-          "description": "A CSS min-width value for this column.",
-          "values": []
-        },
-        {
-          "name": "align",
-          "description": "Alignment of cell content within the column.",
-          "values": [
-            { "name": "start" },
-            { "name": "center" },
-            { "name": "end" }
-          ]
-        },
-        {
-          "name": "hidden",
-          "description": "Hides the column without removing it from the DOM.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://cordwainer.dev/components/data-table-column"
-        }
-      ]
-    },
     {
       "name": "cw-data-table",
       "description": "Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.\n---\n\n\n### **Events:**\n - **cw-sort-change** - Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`.\n- **cw-row-selection-change** - Emitted when row selection changes. `detail: { selectedRows: object[] }`.\n- **cw-row-click** - Emitted when a body row is clicked. `detail: { row: object, index: number }`.\n\n### **Slots:**\n - _default_ - Place `<cw-data-table-column>` elements here to define columns.\n- **empty** - Content shown when `data` is empty and not loading.\n\n### **CSS Properties:**\n - **--cw-data-table-border-color** - Border color used when `bordered` is set. Default: `var(--cw-color-neutral-200)`. _(default: undefined)_\n- **--cw-data-table-stripe-color** - Alternate row background color when `striped` is set. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_\n- **--cw-data-table-row-hover-color** - Row background on hover. Default: `var(--cw-color-neutral-100)`. _(default: undefined)_\n- **--cw-data-table-selected-row-color** - Selected row background. Default: `var(--cw-color-primary-50)`. _(default: undefined)_\n- **--cw-data-table-header-background** - Header row background. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The outer scrollable wrapper.\n- **table** - The `<table>` element.\n- **header-row** - The `<tr>` in `<thead>`.\n- **header-cell** - Each `<th>` element.\n- **sort-button** - The clickable button inside a sortable `<th>`.\n- **sort-icon** - The sort direction icon inside a sortable `<th>`.\n- **body-row** - Each `<tr>` in `<tbody>`.\n- **body-row--selected** - Added to body rows that are selected.\n- **body-cell** - Each `<td>` element.\n- **checkbox-cell** - The `<th>` or `<td>` that holds the selection checkbox.\n- **loading** - The loading overlay shown when `loading` is true.\n- **empty** - The empty-state container shown when `data` is empty.",
@@ -957,6 +906,57 @@
         }
       ]
     },
+    {
+      "name": "cw-data-table-column",
+      "description": "Data table columns define the columns of a [data table](/components/data-table).\n---\n\n\n### **Slots:**\n - _default_ - This element has no rendered output; it is a configuration element only.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The key in each row data object that this column displays. Required.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "The column header label. Falls back to `name` if not set.",
+          "values": []
+        },
+        {
+          "name": "sortable",
+          "description": "Makes the column header clickable for sorting.",
+          "values": []
+        },
+        {
+          "name": "width",
+          "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
+          "values": []
+        },
+        {
+          "name": "min-width",
+          "description": "A CSS min-width value for this column.",
+          "values": []
+        },
+        {
+          "name": "align",
+          "description": "Alignment of cell content within the column.",
+          "values": [
+            { "name": "start" },
+            { "name": "center" },
+            { "name": "end" }
+          ]
+        },
+        {
+          "name": "hidden",
+          "description": "Hides the column without removing it from the DOM.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://cordwainer.dev/components/data-table-column"
+        }
+      ]
+    },
     {
       "name": "cw-date-picker",
       "description": "Date pickers let users select a date from a calendar.\n---\n\n\n### **Events:**\n - **cw-change** - Emitted when the control's value changes.\n- **cw-clear** - Emitted when the control's value is cleared.\n- **cw-input** - Emitted when the control receives input.\n- **cw-focus** - Emitted when the control gains focus.\n- **cw-blur** - Emitted when the control loses focus.\n- **cw-show** - Emitted when the date picker's calendar opens.\n- **cw-after-show** - Emitted after the date picker's calendar opens and all animations are complete.\n- **cw-hide** - Emitted when the date picker's calendar closes.\n- **cw-after-hide** - Emitted after the date picker's calendar closes and all animations are complete.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **show()** - Shows the calendar.\n- **hide()** - Hides the calendar.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The date picker's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container the wraps the prefix, suffix, display input, clear icon, and expand icon.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected date, an `<input>` element.\n- **calendar** - The calendar container where the header and date grid are rendered.\n- **header** - The calendar's header containing the previous/next buttons and heading.\n- **heading** - The heading that displays the focused month and year.\n- **previous-button** - The button that navigates to the previous month.\n- **next-button** - The button that navigates to the next month.\n- **grid** - The grid that contains the weekday headers and days.\n- **day** - An individual day within the grid.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",
@@ -1434,6 +1434,23 @@
         }
       ]
     },
+    {
+      "name": "cw-header",
+      "description": "Page header region composing branding, primary navigation, icon-triggered action panels, and secondary\nnavigation into one piece of chrome.\n---\n\n\n### **Events:**\n - **cw-panel-show** - Emitted when an action panel opens.\n- **cw-panel-after-show** - Emitted after an action panel opens and all animations are complete.\n- **cw-panel-hide** - Emitted when an action panel closes.\n- **cw-panel-after-hide** - Emitted after an action panel closes and all animations are complete.\n\n### **Methods:**\n - **showPanel(name: _HeaderAction['name']_)** - Opens the named action panel. No-op if that slot has no content.\n- **hidePanel()** - Closes the currently open action panel, if any.\n\n### **Slots:**\n - **logo** - A `<cw-logo>`.\n- **primary-navigation** - A `<cw-primary-navigation>`.\n- **utility** - Content for the utility action panel, opened via a gear icon trigger.\n- **search** - Content for the search action panel, opened via a search icon trigger.\n- **notification** - Content for the notification action panel, opened via a bell icon trigger.\n- **user** - Content for the user/account action panel, opened via a person icon trigger.\n- **cart** - Content for the cart action panel, opened via a cart icon trigger.\n- **secondary-navigation** - A `<cw-secondary-navigation>`, rendered on its own row below everything else.\n\n### **CSS Properties:**\n - **--panel-width** - The width of an open action panel above `mobile-breakpoint`. Below it, panels are always full width. Defaults to `50%`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, a `<header>` landmark element.\n- **logo** - The container that wraps the slotted logo.\n- **primary-navigation** - The container that wraps the slotted primary navigation.\n- **actions** - The container that wraps the action triggers.\n- **trigger** - Each action trigger, a `<cw-icon-button>`.\n- **trigger--utility** - The utility action trigger.\n- **trigger--search** - The search action trigger.\n- **trigger--notification** - The notification action trigger.\n- **trigger--user** - The user action trigger.\n- **trigger--cart** - The cart action trigger.\n- **trigger__base** - A trigger's exported `base` part.\n- **indicator** - The line that highlights the currently open action trigger.\n- **panel** - The panel shown below the header when an action trigger is open.\n- **secondary-navigation** - The container that wraps the slotted secondary navigation.",
+      "attributes": [
+        {
+          "name": "mobile-breakpoint",
+          "description": "The viewport width, in pixels, below which the header switches to its stacked mobile layout.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://cordwainer.dev/components/header"
+        }
+      ]
+    },
     {
       "name": "cw-icon",
       "description": "Icons are symbols that can be used to represent various options within an application.\n---\n\n\n### **Events:**\n - **cw-load** - Emitted when the icon has loaded. When using `spriteSheet: true` this will not emit.\n- **cw-error** - Emitted when the icon fails to load due to an error. When using `spriteSheet: true` this will not emit.\n\n### **CSS Parts:**\n - **svg** - The internal SVG element.\n- **use** - The <use> element generated when using `spriteSheet: true`",
@@ -2601,6 +2618,65 @@
         }
       ]
     },
+    {
+      "name": "cw-secondary-navigation",
+      "description": "Second-level site navigation for linking pages related to the current one, beneath a\n`<cw-primary-navigation>`. A flat, horizontal strip of links — unlike primary navigation, it has no\ndisclosure/dropdown items; overflow is handled with scroll buttons instead.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<cw-secondary-navigation-item>` elements.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, a `<nav>` landmark element.\n- **nav** - The container that wraps the slotted navigation items and the scroll buttons.\n- **scroll-button** - The previous/next scroll buttons that show when items overflow, an `<cw-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "The accessible label for the `<nav>` landmark. Defaults to a localized \"Secondary navigation\".",
+          "values": []
+        },
+        {
+          "name": "no-scroll-controls",
+          "description": "Disables the scroll arrows that appear when items overflow.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://cordwainer.dev/components/secondary-navigation"
+        }
+      ]
+    },
+    {
+      "name": "cw-secondary-navigation-item",
+      "description": "A link in a `<cw-secondary-navigation>`, pointing to a page related to the current one.\n---\n\n\n### **Slots:**\n - _default_ - The item's label content (text, or an icon + text).\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **link** - The internal `<a>`, present only when `href` is set.",
+      "attributes": [
+        {
+          "name": "href",
+          "description": "The URL to navigate to.",
+          "values": []
+        },
+        {
+          "name": "target",
+          "description": "Tells the browser where to open the link. Only used when `href` is set.",
+          "values": [
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_self" },
+            { "name": "_top" }
+          ]
+        },
+        {
+          "name": "rel",
+          "description": "The `rel` attribute for the link. Only used when `href` is set.",
+          "values": []
+        },
+        {
+          "name": "current",
+          "description": "Indicates this item represents the current page. Reflects `aria-current=\"page\"` on the internal link. The\ncomponent has no router/URL awareness — consumers set this explicitly based on their own routing state.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://cordwainer.dev/components/secondary-navigation-item"
+        }
+      ]
+    },
     {
       "name": "cw-select",
       "description": "Selects allow you to choose items from a menu of predefined options.\n---\n\n\n### **Events:**\n - **cw-change** - Emitted when the control's value changes.\n- **cw-clear** - Emitted when the control's value is cleared.\n- **cw-input** - Emitted when the control receives input.\n- **cw-focus** - Emitted when the control gains focus.\n- **cw-blur** - Emitted when the control loses focus.\n- **cw-show** - Emitted when the select's menu opens.\n- **cw-after-show** - Emitted after the select's menu opens and all animations are complete.\n- **cw-hide** - Emitted when the select's menu closes.\n- **cw-after-hide** - Emitted after the select's menu closes and all animations are complete.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **show()** - Shows the listbox.\n- **hide()** - Hides the listbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The listbox options. Must be `<cw-option>` elements. You can use `<cw-divider>` to group items visually.\n- **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed. Rotates on open and close.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The select's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container the wraps the prefix, suffix, combobox, clear icon, and expand button.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected option's label, an `<input>` element.\n- **listbox** - The listbox container where options are slotted.\n- **tags** - The container that houses option tags when `multiselect` is used.\n- **tag** - The individual tags that represent each multiselect option.\n- **tag__base** - The tag's base part.\n- **tag__content** - The tag's content part.\n- **tag__remove-button** - The tag's remove button.\n- **tag__remove-button__base** - The tag's remove button base part.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",