@kwtv/components 0.9.0 → 0.10.0

package/README.md

@@ -7,15 +7,19 @@ there is no separate library build or consumer alias configuration.
 
 ## What ships
 
-| Path                      | What it is                                                                                                                                                                                |
-| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `src/astro/*.astro`       | Static components. Scoped styles, no client JS.                                                                                                                                           |
-| `src/react/*.tsx`         | Interactive islands. Select, Modal, Toast, Drawer, QuantityStepper, NewsCarousel, OrderStatus, OrderTimeline.                                                                             |
-| `src/styles/base.css`     | The shared primitives the React islands import: focus ring, touch targets, screen-reader helper. Astro components carry their own scoped styles.                                          |
-| `src/styles/controls.css` | The one copy of the button and icon-button styles. `Button` and `IconButton` import it. React islands import it for the `ui-btn` / `ui-iconbtn` classes.                                  |
-| `src/styles/navlink.css`  | The one copy of the header nav link styles. `NavLink` and `NavDropdown` import it.                                                                                                        |
-| `src/styles/feedback.css` | The one copy of the alert, empty state and skeleton styles. `Alert`, `EmptyState` and `Skeleton` import it. React islands import it for the `ui-alert`, `ui-empty` and `ui-skel` classes. |
-| `src/styles/motion.css`   | The `pl-` motion layer: lift, underline, arrow and row nudges, rise, marquee, chip rail and swipe carousel.                                                                               |
+| Path                          | What it is                                                                                                                                                                                                                                              |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `src/astro/*.astro`           | Static components. Scoped styles, no client JS.                                                                                                                                                                                                         |
+| `src/react/*.tsx`             | Interactive islands. Select, Modal, Toast, Drawer, QuantityStepper, NewsCarousel, OrderStatus, OrderTimeline.                                                                                                                                           |
+| `src/styles/base.css`         | The shared primitives the React islands import: focus ring, touch targets, screen-reader helper. Most Astro components carry their own scoped styles.                                                                                                   |
+| `src/styles/controls.css`     | The one copy of the button and icon-button styles. `Button` and `IconButton` import it. React islands import it for the `ui-btn` / `ui-iconbtn` classes.                                                                                                |
+| `src/styles/navlink.css`      | The one copy of the header nav link styles. `NavLink` and `NavDropdown` import it.                                                                                                                                                                      |
+| `src/styles/feedback.css`     | The one copy of the alert, empty state and skeleton styles. `Alert`, `EmptyState` and `Skeleton` import it. React islands import it for the `ui-alert`, `ui-empty` and `ui-skel` classes.                                                               |
+| `src/styles/filters.css`      | The one copy of the chip, swatch, checkbox, radio and active filter tag styles. `Chip`, `Swatch`, `Checkbox`, `Radio` and `ActiveFilterTags` import it. React islands import it for the `ui-chip`, `ui-swatch`, `ui-check` and `ui-filtertags` classes. |
+| `src/styles/badge.css`        | The one copy of the badge styles. `Badge` imports it. React islands import it for the `ui-badge` classes, also for the active filter tags.                                                                                                              |
+| `src/styles/pager.css`        | The one copy of the pager styles. `Pager` imports it. React islands import it for the `ui-pager` classes.                                                                                                                                               |
+| `src/styles/product-card.css` | The one copy of the product card and ribbon styles. `ProductCard` imports it. React islands import it for the `ui-product` and `ui-ribbon` classes.                                                                                                     |
+| `src/styles/motion.css`       | The `pl-` motion layer: lift, underline, arrow and row nudges, rise, marquee, chip rail and swipe carousel.                                                                                                                                             |
 
 ## Install
 
@@ -64,16 +68,86 @@ import Select from "@kwtv/components/react/Select.tsx";
 />
 ```
 
-The React islands need their shared stylesheets once in the app. Import
-`controls.css` too if any React code renders the `ui-btn` / `ui-iconbtn`
-classes (Astro cannot pass its scoped styles into a React island):
+The React islands need their shared stylesheets once in the app. Astro
+cannot pass its scoped styles into a React island, so an island that writes
+the markup of an Astro component imports that component's sheet:
 
 ```ts
 import "@kwtv/components/styles/base.css";
-import "@kwtv/components/styles/controls.css";
-import "@kwtv/components/styles/feedback.css";
+import "@kwtv/components/styles/controls.css"; // ui-btn, ui-iconbtn
+import "@kwtv/components/styles/feedback.css"; // ui-alert, ui-empty, ui-skel
+import "@kwtv/components/styles/filters.css"; // ui-chip, ui-swatch, ui-check, ui-filtertags
+import "@kwtv/components/styles/badge.css"; // ui-badge
+import "@kwtv/components/styles/pager.css"; // ui-pager
+import "@kwtv/components/styles/product-card.css"; // ui-product, ui-ribbon
 ```
 
+The island writes the same markup as the Astro component, class for class.
+The rules in these sheets are not scoped, so a consumer rule of equal
+specificity in the `components` layer wins on source order.
+
+## Labels and other languages
+
+The visible and screen-reader text inside the components defaults to Dutch.
+Every such string has its own optional prop named `<thing>Label`. Leave it
+out and the Dutch text renders exactly as before. Pass it to render another
+language.
+
+| Component          | Prop                                                                            | Default                 |
+| ------------------ | ------------------------------------------------------------------------------- | ----------------------- |
+| `ProductCard`      | `newLabel`                                                                      | `Nieuw`                 |
+|                    | `promoLabel`                                                                    | `Promo`                 |
+|                    | `lastLabel`                                                                     | `Laatste`               |
+|                    | `favLabel`                                                                      | `Favoriet`              |
+|                    | `soldOutLabel`                                                                  | `Uitverkocht`           |
+| `Pager`            | `label`                                                                         | `Paginering`            |
+|                    | `previousLabel`                                                                 | `Vorige pagina`         |
+|                    | `nextLabel`                                                                     | `Volgende pagina`       |
+| `Swatch`           | `selectedLabel`                                                                 | `geselecteerd`          |
+| `Filters`          | `titleLabel`                                                                    | `Filters`               |
+|                    | `clearLabel`                                                                    | `Wissen`                |
+| `ActiveFilterTags` | `clearAllLabel`                                                                 | `Alles wissen`          |
+| `Badge`            | `removeLabel`                                                                   | `Verwijderen`           |
+| `Breadcrumb`       | `label`                                                                         | `Kruimelpad`            |
+| `ChipRail`         | `label`                                                                         | `Categorieën`           |
+| `SwipeCarousel`    | `label`                                                                         | `Uitgelichte artikelen` |
+| `CartLine`         | `removeLabel`                                                                   | `Verwijderen`           |
+| `CopyChip`         | `label`                                                                         | `Copy`                  |
+|                    | `copiedLabel`                                                                   | `Copied`                |
+| `Newsletter`       | `label`, `placeholder`, `buttonText`                                            | Dutch                   |
+| `Social`           | `label`                                                                         | The platform name       |
+| `Drawer`           | `label`                                                                         | `Menu`                  |
+| `Toast`            | `closeLabel`                                                                    | `Melding sluiten`       |
+| `Select`           | `placeholder`                                                                   | `Kies een optie`        |
+| `QuantityStepper`  | `decrementLabel`, `incrementLabel`, `removeLabel`, `announce`, `announceRemove` | Dutch                   |
+| `NewsCarousel`     | `prevLabel`, `nextLabel`, `dotLabel`                                            | Dutch                   |
+| `OrderStatus`      | `title`, `orderLabel`                                                           | Dutch                   |
+| `OrderTimeline`    | `stateWords`                                                                    | Dutch                   |
+
+`Swatch` adds `selectedLabel` to the colour name after a comma, so
+`label="Sage" selectedLabel="selected"` is read as "Sage, selected". The
+`ProductCard` screen-reader text is `soldOutLabel` followed by a full stop.
+`AccountNav`, `AuthCard`, `StepIndicator`, `TextField`, `Totals` and `Modal`
+take all their text from props or slots.
+
+Older props that do not follow the `<thing>Label` name, such as `label`,
+`buttonText` and `stateWords`, keep their names.
+
+## Toggle chips and plain buttons
+
+`Chip` is a toggle by default and always carries `aria-pressed`, `"true"` or
+`"false"` from `selected`. Pass `toggle={false}` for a chip that only opens or
+runs something, such as the button that opens the filter sheet. It then has
+no `aria-pressed`.
+
+## Drawer title and width
+
+`title` shows an `h2` in the top row of the `Drawer`, left of the close button,
+and names the drawer through `aria-labelledby` in place of `label`.
+`size="full"` lets a `start` or `end` drawer fill the viewport width on
+screens up to 700 px wide. Bottom drawers and the panel under the header are
+full width already. Without these props the drawer renders as before.
+
 ## Cascade layers
 
 Every stylesheet in this package and in `@kwtv/tokens` sits in a cascade
@@ -88,7 +162,7 @@ layer, in one fixed order:
 | `reset`      | Empty in the packages. The app's element defaults go here.      |
 | `tokens`     | The token custom properties, in `palette`, `theme` and `scale`. |
 | `base`       | `base.css`: focus ring, touch targets, screen-reader helper.    |
-| `components` | Astro component styles, React island CSS and `controls.css`.    |
+| `components` | Astro component styles, React island CSS and the shared sheets. |
 | `motion`     | `motion.css`. Above components, because it adjusts their parts. |
 | `utilities`  | `@kwtv/tokens/utilities.css`.                                   |
 
@@ -114,8 +188,9 @@ statement or has a rule outside its layer.
 - Use the `.astro`, `.tsx` and `.css` extensions shown in these examples.
 - Import `@kwtv/components/styles/motion.css` when using the motion utilities.
 - Class names keep the `ui-` prefix from the component library so markup reads
-  the same across both sites. Astro scopes them; the prefix is for readability
-  and for consumer overrides.
+  the same across both sites. Astro scopes most of them; the shared sheets in
+  `src/styles/` are not scoped. The prefix is for readability and for consumer
+  overrides.
 - Colour, space, type, radius, shadow and motion all come from the token CSS
   variables. Components never hardcode a hex value.
 - Status is never colour alone. Every status pairs an icon with a word.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kwtv/components",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "UNLICENSED",
   "type": "module",
   "description": "KWTV UI components for Astro, with React islands. Built on the KWTV design tokens.",
@@ -39,6 +39,6 @@
     }
   },
   "dependencies": {
-    "@kwtv/tokens": "^0.9.0"
+    "@kwtv/tokens": "^0.10.0"
   }
 }

package/src/astro/ActiveFilterTags.astro

@@ -1,5 +1,6 @@
 ---
 import Badge from "./Badge.astro";
+import "../styles/filters.css";
 
 /**
  * The active filters repeated as removable tags above the grid, so the reader
@@ -7,6 +8,9 @@ import Badge from "./Badge.astro";
  * names the filter it clears. A trailing clear-all action removes them at once.
  *
  * The row wraps. The consumer wires each removeLabel to the matching filter.
+ *
+ * React and Preact islands write the same markup and import
+ * `@kwtv/components/styles/badge.css` and `@kwtv/components/styles/filters.css`.
  */
 interface Tag {
   label: string;
@@ -42,37 +46,3 @@ const classes = ["ui-filtertags", className].filter(Boolean).join(" ");
     </button>
   )}
 </div>
-
-<style>
-  @layer reset, tokens, base, components, motion, utilities;
-
-  @layer components {
-    .ui-filtertags {
-      display: flex;
-      flex-wrap: wrap;
-      align-items: center;
-      gap: var(--space-2);
-    }
-
-    .ui-filtertags__clear {
-      padding: var(--space-1-5) var(--space-2);
-      background: transparent;
-      border: 0;
-      border-radius: var(--radius-sm);
-      font-family: var(--font-sans);
-      font-size: var(--text-xs);
-      font-weight: var(--weight-semibold);
-      color: var(--link);
-      cursor: pointer;
-    }
-    .ui-filtertags__clear:hover {
-      background: var(--surface-hover);
-      color: var(--link-hover);
-    }
-    .ui-filtertags__clear:focus-visible {
-      outline: 2px solid var(--focus);
-      outline-offset: 2px;
-      box-shadow: 0 0 0 4px var(--focus-outer);
-    }
-  }
-</style>

package/src/astro/Badge.astro

@@ -1,5 +1,6 @@
 ---
 import Icon from "./Icon.astro";
+import "../styles/badge.css";
 
 /**
  * Badge. Status and stock. Each status tone carries an icon so the meaning
@@ -9,6 +10,9 @@ import Icon from "./Icon.astro";
  *
  * Stock badges should repeat the exact number in text rather than only shading
  * the pill.
+ *
+ * React and Preact islands write the same markup and import
+ * `@kwtv/components/styles/badge.css`.
  */
 interface Props {
   tone?: "neutral" | "success" | "warning" | "danger" | "outline";
@@ -60,87 +64,3 @@ const classes = [
     </button>
   )}
 </span>
-
-<style>
-  @layer reset, tokens, base, components, motion, utilities;
-
-  @layer components {
-    .ui-badge {
-      display: inline-flex;
-      align-items: center;
-      gap: var(--space-1-5);
-      min-height: 24px;
-      padding: 0 var(--space-2);
-      border: 1px solid transparent;
-      border-radius: var(--radius-full);
-      font-family: var(--font-sans);
-      font-size: var(--text-xs);
-      font-weight: var(--weight-medium);
-      line-height: 1;
-      white-space: nowrap;
-    }
-
-    .ui-badge__icon {
-      display: inline-flex;
-      flex-shrink: 0;
-    }
-
-    .ui-badge--neutral {
-      background: var(--surface-accent);
-      color: var(--surface-accent-fg, var(--text));
-    }
-
-    .ui-badge--success {
-      background: var(--success-bg);
-      color: var(--success);
-    }
-
-    .ui-badge--warning {
-      background: var(--warning-bg);
-      color: var(--warning);
-    }
-
-    .ui-badge--danger {
-      background: var(--danger-bg);
-      color: var(--danger);
-    }
-
-    /* Outline keeps the strong border and full-strength text, so it reads */
-    /* without relying on a fill. */
-    .ui-badge--outline {
-      background: transparent;
-      border: 1px solid var(--border-strong);
-      color: var(--text);
-    }
-
-    .ui-badge--removable {
-      padding-right: var(--space-1);
-    }
-
-    /* Small × target grows with padding plus an equal negative margin, so the */
-    /* hit area grows without moving the layout. */
-    .ui-badge__x {
-      display: inline-flex;
-      align-items: center;
-      justify-content: center;
-      padding: var(--space-2);
-      margin: calc(-1 * var(--space-2));
-      margin-left: 0;
-      background: transparent;
-      border: 0;
-      border-radius: var(--radius-sm);
-      color: inherit;
-      cursor: pointer;
-    }
-
-    .ui-badge__x:hover {
-      color: var(--danger);
-    }
-
-    .ui-badge__x:focus-visible {
-      outline: 2px solid var(--focus);
-      outline-offset: 2px;
-      box-shadow: 0 0 0 4px var(--focus-outer);
-    }
-  }
-</style>

package/src/astro/Checkbox.astro

@@ -1,4 +1,6 @@
 ---
+import "../styles/filters.css";
+
 /**
  * Checkbox. Custom-styled native control: appearance:none box with a CSS
  * checkmark SVG, so the checked state is consistent across surfaces and themes.
@@ -7,6 +9,9 @@
  *
  * When several checkboxes form a question, put them in a <fieldset> with a
  * <legend> in the consuming page so the question is announced first.
+ *
+ * React and Preact islands write the same markup and import
+ * `@kwtv/components/styles/filters.css`.
  */
 interface Props {
   label?: string;
@@ -46,67 +51,3 @@ const classes = ["ui-check", disabled && "is-disabled", className]
   />
   <slot>{label}</slot>
 </label>
-
-<style>
-  @layer reset, tokens, base, components, motion, utilities;
-
-  @layer components {
-    .ui-check {
-      display: flex;
-      align-items: flex-start;
-      gap: var(--space-2);
-      min-height: 32px;
-      font-family: var(--font-sans);
-      font-size: var(--text-sm);
-      color: var(--text);
-      cursor: pointer;
-    }
-
-    .ui-check input {
-      appearance: none;
-      -webkit-appearance: none;
-      width: 17px;
-      height: 17px;
-      flex-shrink: 0;
-      margin-top: calc((var(--leading-sm, 1.375rem) - 17px) / 2);
-      border: 1.5px solid var(--border-strong);
-      border-radius: var(--radius-xs, 3px);
-      background: var(--surface);
-      cursor: pointer;
-      transition:
-        background-color var(--duration-fast, 100ms) var(--ease-standard, ease),
-        border-color var(--duration-fast, 100ms) var(--ease-standard, ease);
-    }
-
-    .ui-check input:checked {
-      background: var(--primary);
-      border-color: var(--primary);
-      background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 10' fill='none' stroke='white' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='1 5 4.5 8.5 11 1'/%3E%3C/svg%3E");
-      background-repeat: no-repeat;
-      background-position: center;
-      background-size: 10px 8px;
-    }
-
-    .ui-check input:focus-visible {
-      outline: 2px solid var(--focus);
-      outline-offset: 2px;
-      box-shadow: 0 0 0 4px var(--focus-outer);
-    }
-
-    .ui-check.is-disabled {
-      cursor: not-allowed;
-      color: var(--text-muted);
-    }
-
-    .ui-check.is-disabled input {
-      cursor: not-allowed;
-      opacity: 0.45;
-    }
-
-    @media (max-width: 700px), (pointer: coarse) {
-      .ui-check {
-        min-height: 40px;
-      }
-    }
-  }
-</style>

package/src/astro/Chip.astro

@@ -1,4 +1,6 @@
 ---
+import "../styles/filters.css";
+
 /**
  * Chip. Size selection and filter shortcuts. A <button> with aria-pressed, not
  * a link. Selection adds a 2 px border so it reads without colour. Sold-out
@@ -7,12 +9,22 @@
  *
  * The `--filter` variant is the 32 px shortcut that opens the filter sheet on
  * mobile.
+ *
+ * A chip is a toggle by default and always carries aria-pressed. Pass
+ * `toggle={false}` for a chip that is a plain button, such as the one that
+ * opens the filter sheet. It then has no aria-pressed, and `selected` only
+ * sets the look.
+ *
+ * React and Preact islands write the same markup and import
+ * `@kwtv/components/styles/filters.css`.
  */
 interface Props {
   variant?: "default" | "filter";
   selected?: boolean;
   disabled?: boolean;
   strikethrough?: boolean;
+  /** Set to false for a plain button. Drops aria-pressed. Defaults to true. */
+  toggle?: boolean;
   type?: "button" | "submit";
   class?: string;
 }
@@ -22,6 +34,7 @@ const {
   selected = false,
   disabled = false,
   strikethrough = false,
+  toggle = true,
   type = "button",
   class: className,
   ...rest
@@ -42,93 +55,9 @@ const classes = [
 <button
   class={classes}
   type={type}
-  aria-pressed={String(selected)}
+  aria-pressed={toggle ? String(selected) : undefined}
   disabled={disabled}
   {...rest}
 >
   <slot />
 </button>
-
-<style>
-  @layer reset, tokens, base, components, motion, utilities;
-
-  @layer components {
-    .ui-chip {
-      display: inline-flex;
-      align-items: center;
-      justify-content: center;
-      min-height: 36px;
-      padding: 0 var(--space-4);
-      background: var(--surface);
-      border: 1px solid var(--border);
-      border-radius: var(--radius-md);
-      font-family: var(--font-sans);
-      font-size: var(--text-sm);
-      font-weight: var(--weight-medium);
-      color: var(--text);
-      cursor: pointer;
-      transition:
-        border-color var(--duration-fast) var(--ease-standard),
-        background-color var(--duration-fast) var(--ease-standard);
-    }
-
-    .ui-chip:hover,
-    .ui-chip.is-hover {
-      border-color: var(--border-strong);
-    }
-
-    .ui-chip:focus-visible,
-    .ui-chip.is-focus {
-      outline: 2px solid var(--focus);
-      outline-offset: 2px;
-      box-shadow: 0 0 0 4px var(--focus-outer);
-    }
-
-    /* Selected: 2 px border plus the accent surface, readable without colour. */
-    .ui-chip.is-selected,
-    .ui-chip[aria-pressed="true"] {
-      border-width: 2px;
-      border-color: var(--border-strong);
-      background: var(--surface-accent);
-      color: var(--surface-accent-fg, var(--text));
-      font-weight: var(--weight-semibold);
-    }
-
-    .ui-chip.is-disabled,
-    .ui-chip:disabled {
-      opacity: 0.5;
-      cursor: not-allowed;
-    }
-
-    .ui-chip--struck {
-      text-decoration: line-through;
-    }
-
-    /* Filter chip: 32 px. */
-    .ui-chip--filter {
-      min-height: 32px;
-      border-radius: var(--radius-full);
-      padding: 0 var(--space-3);
-    }
-
-    .ui-chip--filter.is-selected,
-    .ui-chip--filter[aria-pressed="true"] {
-      background: var(--surface-accent);
-    }
-
-    @media (prefers-reduced-motion: reduce) {
-      .ui-chip {
-        transition: none;
-      }
-    }
-
-    @media (max-width: 700px), (pointer: coarse) {
-      .ui-chip {
-        min-height: 36px;
-      }
-      .ui-chip--filter {
-        min-height: 40px;
-      }
-    }
-  }
-</style>

package/src/astro/CopyChip.astro

@@ -7,19 +7,37 @@
  *
  * @prop {string} text   The value to display and copy.
  * @prop {string} [label] Accessible label for the copy button (default: "Copy").
+ * @prop {string} [copiedLabel] Accessible label once copied (default: "Copied").
  * @prop {string} [class]
+ *
+ * The script reads both labels from `data-label` and `data-copied-label`.
+ * They are written only when they differ from the default, so markup with the
+ * defaults stays the same.
  */
 interface Props {
   text: string;
   label?: string;
+  copiedLabel?: string;
   class?: string;
 }
 
-const { text, label = "Copy", class: className, ...rest } = Astro.props;
+const {
+  text,
+  label = "Copy",
+  copiedLabel = "Copied",
+  class: className,
+  ...rest
+} = Astro.props;
 const classes = ["ui-copy-chip", className].filter(Boolean).join(" ");
 ---
 
-<span class={classes} data-copy={text} {...rest}>
+<span
+  class={classes}
+  data-copy={text}
+  data-label={label !== "Copy" ? label : undefined}
+  data-copied-label={copiedLabel !== "Copied" ? copiedLabel : undefined}
+  {...rest}
+>
   <span class="ui-copy-chip__text">{text}</span>
 </span>
 
@@ -29,6 +47,7 @@ const classes = ["ui-copy-chip", className].filter(Boolean).join(" ");
 
     const text = el.getAttribute("data-copy") ?? "";
     const label = el.getAttribute("data-label") ?? "Copy";
+    const copiedLabel = el.getAttribute("data-copied-label") ?? "Copied";
 
     const COPY_ICON = `<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="5" y="5" width="9" height="9" rx="1.5"/><path d="M3 11V3a1 1 0 0 1 1-1h8"/></svg>`;
     const CHECK_ICON = `<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="2 8 6 12 14 4"/></svg>`;
@@ -43,7 +62,7 @@ const classes = ["ui-copy-chip", className].filter(Boolean).join(" ");
       try {
         await navigator.clipboard.writeText(text);
         btn.innerHTML = CHECK_ICON;
-        btn.setAttribute("aria-label", "Copied");
+        btn.setAttribute("aria-label", copiedLabel);
         setTimeout(() => {
           btn.innerHTML = COPY_ICON;
           btn.setAttribute("aria-label", label);

package/src/astro/Filters.astro

@@ -8,21 +8,30 @@
  * with variant="sheet" and place the FilterGroups inside it. The result count
  * should be announced in a polite live region by the consumer when filters
  * change.
+ *
+ * `titleLabel` is the bar's eyebrow. It defaults to "Filters".
  */
 interface Props {
   /** Text for the clear-all action. Omit to hide it. */
   clearLabel?: string;
+  /** The eyebrow in the bar. Defaults to "Filters". */
+  titleLabel?: string;
   class?: string;
 }
 
-const { clearLabel = "Wissen", class: className, ...rest } = Astro.props;
+const {
+  clearLabel = "Wissen",
+  titleLabel = "Filters",
+  class: className,
+  ...rest
+} = Astro.props;
 
 const classes = ["ui-filters", className].filter(Boolean).join(" ");
 ---
 
 <aside class={classes} {...rest}>
   <div class="ui-filterbar">
-    <span class="ui-eyebrow">Filters</span>
+    <span class="ui-eyebrow">{titleLabel}</span>
     {clearLabel && (
       <slot name="clear">
         <button class="ui-filters__clear" type="button">