@baseline-ui/mcp 2.0.0 → 2.2.0

package/dist/{index.cjs → server.cjs}

@@ -1,14 +1,4 @@
-#!/usr/bin/env node
-'use strict';var mcp_js=require('@modelcontextprotocol/sdk/server/mcp.js'),stdio_js=require('@modelcontextprotocol/sdk/server/stdio.js'),zod=require('zod');/**
- * Copyright (c) 2023-2024 PSPDFKit GmbH. All rights reserved.
- *
- * THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW
- * AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
- * UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
- * This notice may not be removed from this file.
- *
- */
-var o={BarChart:{id:"charts-barchart",breadcrumb:"Charts/BarChart",importStatement:`import { BarChart } from "@baseline-ui/charts";
+'use strict';var mcp_js=require('@modelcontextprotocol/sdk/server/mcp.js'),zod=require('zod');var t={BarChart:{id:"charts-barchart",breadcrumb:"Charts/BarChart",importStatement:`import { BarChart } from "@baseline-ui/charts";
 import { Box } from "@baseline-ui/core";`,description:"The `BarChart` component renders a responsive bar chart for categorical data. It is built on top of [Recharts](https://recharts.org/) and styled with Baseline UI design tokens so it picks up the active theme automatically.",documentation:`The \`BarChart\` component renders a responsive bar chart for categorical data. It is built on top of [Recharts](https://recharts.org/) and styled with Baseline UI design tokens so it picks up the active theme automatically.
 
 * Renders one or more bar series from a single dataset, keyed by \`xAxisDataKey\` and the per-bar \`dataKey\`.
@@ -992,7 +982,7 @@ export const AccordionWithDisabledItemsExample: React.FC<
  Omit<React.ComponentProps<typeof AccordionExample>, "disabledKeys">
 > = (props) => {
  return <AccordionExample {...props} disabledKeys={new Set(["item-1"])} />;
-};`},similarTo:[],figmaUrl:null},ActionButton:{id:"core-buttons-actionbutton",breadcrumb:"Core/Buttons/ActionButton",importStatement:'import { ActionButton, Menu, VariantViewer } from "@baseline-ui/core";',description:"`ActionButton` is a labeled button that triggers an action when activated by mouse, touch, or keyboard. Use it for primary user actions such as submitting a form, confirming a choice, or invoking a command.",documentation:'`ActionButton` is a labeled button that triggers an action when activated by mouse, touch, or keyboard. Use it for primary user actions such as submitting a form, confirming a choice, or invoking a command.\n\n* Mouse and touch event handling, and press state management\n* Keyboard focus management and cross browser normalization\n* Keyboard event support for Space and Enter keys\n\nYou can import the ActionButton component like so:\n\n```jsx\nimport { ActionButton } from "@baseline-ui/core";\n\nexport default function App() {\n return <ActionButton label="Click Me" />;\n}\n```\n\nIf you want to use a button that can be toggled on and off, you can use the `ToggleButton` component.\n\nThere are nine variants of the button: `primary`, `secondary`, `tertiary`, `popover`, `toolbar`, `ghost`, `success`, `warning` and `error`. The default variant is `primary`. You can change the variant by passing the `variant` prop.\n\n```jsx\n<ActionButton label="Primary" />\n<ActionButton label="Secondary" variant="secondary" />\n<ActionButton label="Tertiary" variant="tertiary" />\n<ActionButton label={"Toolbar"} variant={"toolbar"} />\n<ActionButton label="Ghost" variant="ghost" />\n<ActionButton label="Popover" variant="popover" />\n<ActionButton label="Success" variant="success" />\n<ActionButton label="Warning" variant="warning" />\n<ActionButton label="Error" variant="error" />\n```\n\nActionButton supports three sizes: `sm` (default), `md`, and `lg`. You can change the size by passing the `size` prop.\n\n```jsx\n<ActionButton label="Small (default)" size="sm" />\n<ActionButton label="Medium" size="md" />\n<ActionButton label="Large" size="lg" />\n```\n\nYou can disable a button by passing the `isDisabled` prop. This will disable all mouse, touch, and keyboard interactions.\n\n```jsx\n<ActionButton label="Primary" isDisabled />\n<ActionButton label="Secondary" variant="secondary" isDisabled />\n<ActionButton label="Tertiary" variant="tertiary" isDisabled />\n<ActionButton label="Ghost" variant="ghost" isDisabled />\n<ActionButton label="Toolbar" variant="toolbar" isDisabled />\n<ActionButton label="Popover" variant="popover" isDisabled />\n<ActionButton label="Success" variant="success" isDisabled />\n<ActionButton label="Warning" variant="warning" isDisabled />\n<ActionButton label="Error" variant="error" isDisabled />\n```\n\nYou can place an icon before or after the label by passing the `iconStart` or `iconEnd` props. Choose the icon entrypoint that matches your button size: `@baseline-ui/icons/16` for `sm`, `@baseline-ui/icons/20` for `md`, and `@baseline-ui/icons/24` for `lg`.\n\n```jsx\nimport { EllipseIcon } from "@baseline-ui/icons/16";\n\n<ActionButton label="Label" iconStart={EllipseIcon} />\n<ActionButton label="Label" iconEnd={EllipseIcon} />\n```\n\nYou can listen for events by passing the `onPress` prop. The `onPress` prop will fire when the button is activated by mouse, touch, or keyboard interactions.\n\n```jsx\n<ActionButton label="Click Me" onPress={() => alert("Hello World")} />\n```\n\n| Selector | Description |\n| -------------------- | -------------------------------------------------------------- |\n| \\[data-disabled] | Whether the button is disabled. |\n| \\[data-focused] | Whether the button is focused, either via a mouse or keyboard. |\n| \\[data-hovered] | Whether the button is currently hovered with a mouse. |\n| \\[data-focus-visible] | Whether the button is keyboard focused. |\n| \\[data-pressed] | Whether the button is currently pressed. |\n\n| Key | Function |\n| ------- | --------------------- |\n| `Space` | Activates the button. |\n| `Enter` | Activates the button. |',props:`interface ActionButtonProps {
+};`},similarTo:[],figmaUrl:null},ActionButton:{id:"core-buttons-actionbutton",breadcrumb:"Core/Buttons/ActionButton",importStatement:'import { ActionButton, Menu, VariantViewer } from "@baseline-ui/core";',description:"`ActionButton` is a labeled button that triggers an action when activated by mouse, touch, or keyboard. Use it for primary user actions such as submitting a form, confirming a choice, or invoking a command.",documentation:'`ActionButton` is a labeled button that triggers an action when activated by mouse, touch, or keyboard. Use it for primary user actions such as submitting a form, confirming a choice, or invoking a command.\n\n* Mouse and touch event handling, and press state management\n* Keyboard focus management and cross browser normalization\n* Keyboard event support for Space and Enter keys\n\nYou can import the ActionButton component like so:\n\n```jsx\nimport { ActionButton } from "@baseline-ui/core";\n\nexport default function App() {\n return <ActionButton label="Click Me" />;\n}\n```\n\nIf you want to use a button that can be toggled on and off, you can use the `ToggleButton` component.\n\nThe button has six neutral variants: `primary`, `secondary`, `tertiary`, `popover`, `toolbar` and `ghost`. The default variant is `primary`. You can change the variant by passing the `variant` prop.\n\n```jsx\n<ActionButton label="Primary" />\n<ActionButton label="Secondary" variant="secondary" />\n<ActionButton label="Tertiary" variant="tertiary" />\n<ActionButton label={"Toolbar"} variant={"toolbar"} />\n<ActionButton label="Ghost" variant="ghost" />\n<ActionButton label="Popover" variant="popover" />\n```\n\n`success`, `warning` and `error` carry a support colour for actions whose outcome matters \u2014 confirming, acknowledging a risk, or deleting. Each comes in the same three emphasis levels as the neutral variants, so a support-coloured button can sit at whatever weight the surrounding layout calls for:\n\n* `{name}` \u2014 filled, for the primary action in its context\n* `{name}-secondary` \u2014 tinted fill, for a lower-emphasis action\n* `{name}-tertiary` \u2014 outline that fills with the support colour on hover and on keyboard focus\n\nWhen disabled, all three levels drop the support colour and render in the neutral disabled treatment.\n\n```jsx\n<ActionButton label="Success" variant="success" />\n<ActionButton label="Success" variant="success-secondary" />\n<ActionButton label="Success" variant="success-tertiary" />\n<ActionButton label="Warning" variant="warning" />\n<ActionButton label="Warning" variant="warning-secondary" />\n<ActionButton label="Warning" variant="warning-tertiary" />\n<ActionButton label="Error" variant="error" />\n<ActionButton label="Error" variant="error-secondary" />\n<ActionButton label="Error" variant="error-tertiary" />\n```\n\nActionButton supports three sizes: `sm` (default), `md`, and `lg`. You can change the size by passing the `size` prop.\n\n```jsx\n<ActionButton label="Small (default)" size="sm" />\n<ActionButton label="Medium" size="md" />\n<ActionButton label="Large" size="lg" />\n```\n\nYou can disable a button by passing the `isDisabled` prop. This will disable all mouse, touch, and keyboard interactions. The `-secondary` and `-tertiary` support variants are omitted below because they render identically to disabled `secondary` and `tertiary`.\n\n```jsx\n<ActionButton label="Primary" isDisabled />\n<ActionButton label="Secondary" variant="secondary" isDisabled />\n<ActionButton label="Tertiary" variant="tertiary" isDisabled />\n<ActionButton label="Ghost" variant="ghost" isDisabled />\n<ActionButton label="Toolbar" variant="toolbar" isDisabled />\n<ActionButton label="Popover" variant="popover" isDisabled />\n<ActionButton label="Success" variant="success" isDisabled />\n<ActionButton label="Warning" variant="warning" isDisabled />\n<ActionButton label="Error" variant="error" isDisabled />\n```\n\nYou can place an icon before or after the label by passing the `iconStart` or `iconEnd` props. Choose the icon entrypoint that matches your button size: `@baseline-ui/icons/16` for `sm`, `@baseline-ui/icons/20` for `md`, and `@baseline-ui/icons/24` for `lg`.\n\n```jsx\nimport { EllipseIcon } from "@baseline-ui/icons/16";\n\n<ActionButton label="Label" iconStart={EllipseIcon} />\n<ActionButton label="Label" iconEnd={EllipseIcon} />\n```\n\nYou can listen for events by passing the `onPress` prop. The `onPress` prop will fire when the button is activated by mouse, touch, or keyboard interactions.\n\n```jsx\n<ActionButton label="Click Me" onPress={() => alert("Hello World")} />\n```\n\n| Selector | Description |\n| -------------------- | -------------------------------------------------------------- |\n| \\[data-disabled] | Whether the button is disabled. |\n| \\[data-focused] | Whether the button is focused, either via a mouse or keyboard. |\n| \\[data-hovered] | Whether the button is currently hovered with a mouse. |\n| \\[data-focus-visible] | Whether the button is keyboard focused. |\n| \\[data-pressed] | Whether the button is currently pressed. |\n\n| Key | Function |\n| ------- | --------------------- |\n| `Space` | Activates the button. |\n| `Enter` | Activates the button. |',props:`interface ActionButtonProps {
 /**
  * The button's class name.
  */
@@ -1010,6 +1000,13 @@ slot?: string | null
 /**
  * The button's variant.
  * 
+ * The \`success\`, \`warning\` and \`error\` variants carry a support colour. Each
+ * comes in three emphasis levels, mirroring \`primary\`/\`secondary\`/\`tertiary\`:
+ * the bare name is the filled treatment, \`-secondary\` is a tinted fill and
+ * \`-tertiary\` is an outline that fills with the support colour on hover and
+ * on keyboard focus. When disabled, all three drop the support colour and
+ * render in the neutral disabled treatment.
+ * 
  * @default primary
  */
 variant?: | "primary"
@@ -1019,8 +1016,14 @@ variant?: | "primary"
 | "popover"
 | "toolbar"
 | "success"
+| "success-secondary"
+| "success-tertiary"
 | "warning"
+| "warning-secondary"
+| "warning-tertiary"
 | "error"
+| "error-secondary"
+| "error-tertiary"
 /**
  * The button's label.
  */
@@ -1207,6 +1210,114 @@ size?: "sm" | "md" | "lg"
         { variant: "error", size: "lg", iconStart: E24 },
         { variant: "error", size: "lg", iconEnd: E24 },
       ],
+      "Success Secondary": [
+        { variant: "success-secondary" },
+        { variant: "success-secondary", isDisabled: true },
+        { variant: "success-secondary", iconStart: EllipseIcon },
+        { variant: "success-secondary", iconEnd: EllipseIcon },
+      ],
+      "Success Secondary Medium": [
+        { variant: "success-secondary", size: "md" },
+        { variant: "success-secondary", size: "md", isDisabled: true },
+        { variant: "success-secondary", size: "md", iconStart: E20 },
+        { variant: "success-secondary", size: "md", iconEnd: E20 },
+      ],
+      "Success Secondary Large": [
+        { variant: "success-secondary", size: "lg" },
+        { variant: "success-secondary", size: "lg", isDisabled: true },
+        { variant: "success-secondary", size: "lg", iconStart: E24 },
+        { variant: "success-secondary", size: "lg", iconEnd: E24 },
+      ],
+      "Success Tertiary": [
+        { variant: "success-tertiary" },
+        { variant: "success-tertiary", isDisabled: true },
+        { variant: "success-tertiary", iconStart: EllipseIcon },
+        { variant: "success-tertiary", iconEnd: EllipseIcon },
+      ],
+      "Success Tertiary Medium": [
+        { variant: "success-tertiary", size: "md" },
+        { variant: "success-tertiary", size: "md", isDisabled: true },
+        { variant: "success-tertiary", size: "md", iconStart: E20 },
+        { variant: "success-tertiary", size: "md", iconEnd: E20 },
+      ],
+      "Success Tertiary Large": [
+        { variant: "success-tertiary", size: "lg" },
+        { variant: "success-tertiary", size: "lg", isDisabled: true },
+        { variant: "success-tertiary", size: "lg", iconStart: E24 },
+        { variant: "success-tertiary", size: "lg", iconEnd: E24 },
+      ],
+      "Warning Secondary": [
+        { variant: "warning-secondary" },
+        { variant: "warning-secondary", isDisabled: true },
+        { variant: "warning-secondary", iconStart: EllipseIcon },
+        { variant: "warning-secondary", iconEnd: EllipseIcon },
+      ],
+      "Warning Secondary Medium": [
+        { variant: "warning-secondary", size: "md" },
+        { variant: "warning-secondary", size: "md", isDisabled: true },
+        { variant: "warning-secondary", size: "md", iconStart: E20 },
+        { variant: "warning-secondary", size: "md", iconEnd: E20 },
+      ],
+      "Warning Secondary Large": [
+        { variant: "warning-secondary", size: "lg" },
+        { variant: "warning-secondary", size: "lg", isDisabled: true },
+        { variant: "warning-secondary", size: "lg", iconStart: E24 },
+        { variant: "warning-secondary", size: "lg", iconEnd: E24 },
+      ],
+      "Warning Tertiary": [
+        { variant: "warning-tertiary" },
+        { variant: "warning-tertiary", isDisabled: true },
+        { variant: "warning-tertiary", iconStart: EllipseIcon },
+        { variant: "warning-tertiary", iconEnd: EllipseIcon },
+      ],
+      "Warning Tertiary Medium": [
+        { variant: "warning-tertiary", size: "md" },
+        { variant: "warning-tertiary", size: "md", isDisabled: true },
+        { variant: "warning-tertiary", size: "md", iconStart: E20 },
+        { variant: "warning-tertiary", size: "md", iconEnd: E20 },
+      ],
+      "Warning Tertiary Large": [
+        { variant: "warning-tertiary", size: "lg" },
+        { variant: "warning-tertiary", size: "lg", isDisabled: true },
+        { variant: "warning-tertiary", size: "lg", iconStart: E24 },
+        { variant: "warning-tertiary", size: "lg", iconEnd: E24 },
+      ],
+      "Error Secondary": [
+        { variant: "error-secondary" },
+        { variant: "error-secondary", isDisabled: true },
+        { variant: "error-secondary", iconStart: EllipseIcon },
+        { variant: "error-secondary", iconEnd: EllipseIcon },
+      ],
+      "Error Secondary Medium": [
+        { variant: "error-secondary", size: "md" },
+        { variant: "error-secondary", size: "md", isDisabled: true },
+        { variant: "error-secondary", size: "md", iconStart: E20 },
+        { variant: "error-secondary", size: "md", iconEnd: E20 },
+      ],
+      "Error Secondary Large": [
+        { variant: "error-secondary", size: "lg" },
+        { variant: "error-secondary", size: "lg", isDisabled: true },
+        { variant: "error-secondary", size: "lg", iconStart: E24 },
+        { variant: "error-secondary", size: "lg", iconEnd: E24 },
+      ],
+      "Error Tertiary": [
+        { variant: "error-tertiary" },
+        { variant: "error-tertiary", isDisabled: true },
+        { variant: "error-tertiary", iconStart: EllipseIcon },
+        { variant: "error-tertiary", iconEnd: EllipseIcon },
+      ],
+      "Error Tertiary Medium": [
+        { variant: "error-tertiary", size: "md" },
+        { variant: "error-tertiary", size: "md", isDisabled: true },
+        { variant: "error-tertiary", size: "md", iconStart: E20 },
+        { variant: "error-tertiary", size: "md", iconEnd: E20 },
+      ],
+      "Error Tertiary Large": [
+        { variant: "error-tertiary", size: "lg" },
+        { variant: "error-tertiary", size: "lg", isDisabled: true },
+        { variant: "error-tertiary", size: "lg", iconStart: E24 },
+        { variant: "error-tertiary", size: "lg", iconEnd: E24 },
+      ],
     }}
   />
 );`},{id:"core-buttons-actionbutton--disabled",name:"Disabled",snippet:'const Disabled = () => <ActionButton onPress={fn()} label="Label" isDisabled />;'},{id:"core-buttons-actionbutton--with-icon",name:"With Icon",snippet:'const WithIcon = () => <ActionButton onPress={fn()} label="Label" iconStart={EllipseIcon} />;'},{id:"core-buttons-actionbutton--with-both-icons",name:"With Both Icons",snippet:`const WithBothIcons = () => <ActionButton
@@ -2237,6 +2348,14 @@ contentClassName?: string
  * The class name for the close button.
  */
 closeButtonClassName?: string
+/**
+ * Overrides the accessible label of the close button (X) that dismisses
+ * the dialog. This is distinct from \`cancelLabel\`, which is the visible
+ * text of the footer cancel button.
+ * 
+ * Message id: \`bui.alertDialog.close\`. Defaults to \`"Close"\`.
+ */
+closeLabel?: string
 /**
  * The class name for the button group wrapper.
  */
@@ -2424,6 +2543,40 @@ sources: {
  * @default "lg"
  */
 size?: "sm" | "lg"
+/**
+ * Overrides the accessible name of the button that starts audio playback.
+ * 
+ * Message id: \`bui.audioPlayer.play\`. Defaults to \`"Play"\`.
+ */
+playLabel?: string
+/**
+ * Overrides the accessible name of the button that pauses audio playback.
+ * 
+ * Message id: \`bui.audioPlayer.pause\`. Defaults to \`"Pause"\`.
+ */
+pauseLabel?: string
+/**
+ * Overrides the accessible name of the slider used to seek through the
+ * audio track.
+ * 
+ * Message id: \`bui.audioPlayer.audioTimeline\`. Defaults to
+ * \`"Audio timeline"\`.
+ */
+audioTimelineLabel?: string
+/**
+ * Overrides the screen reader announcement made when audio playback
+ * starts.
+ * 
+ * Message id: \`bui.useMedia.playing\`. Defaults to \`"Playing"\`.
+ */
+playingLabel?: string
+/**
+ * Overrides the screen reader announcement made when audio playback is
+ * paused.
+ * 
+ * Message id: \`bui.useMedia.paused\`. Defaults to \`"Paused"\`.
+ */
+pausedLabel?: string
 }`,stories:{usage:[{id:"core-media-audioplayer--basic",name:"Basic",snippet:'const Basic = () => <AudioPlayer sources={[{ url: "/sound.mp3", type: "audio/mpeg" }]} />;'},{id:"core-media-audioplayer--small",name:"Small",snippet:'const Small = () => <AudioPlayer sources={[{ url: "/sound.mp3", type: "audio/mpeg" }]} size="sm" />;'}],implementation:""},similarTo:[],figmaUrl:null},Avatar:{id:"core-content-avatar",breadcrumb:"Core/Content/Avatar",importStatement:'import { Avatar, VariantViewer } from "@baseline-ui/core";',description:"`Avatar` is a small visual representation of a user, showing either a profile image or initials derived from the user's name. Use it to identify people in lists, comments, mentions, or anywhere a user needs to be visually attributed.",documentation:`\`Avatar\` is a small visual representation of a user, showing either a profile image or initials derived from the user's name. Use it to identify people in lists, comments, mentions, or anywhere a user needs to be visually attributed.
 
 \`\`\`jsx
@@ -3060,6 +3213,42 @@ title?: string
 headerVariant?: | "title"
 | "selectMonth"
 | "selectMonthAndYear"
+/**
+ * Overrides the accessible label of the button that moves the calendar forward one month.
+ * 
+ * Message id: \`bui.calendar.nextMonth\`. Defaults to \`"Next month"\`.
+ */
+nextMonthLabel?: string
+/**
+ * Overrides the accessible label of the button that moves the calendar back one month.
+ * 
+ * Message id: \`bui.calendar.previousMonth\`. Defaults to \`"Previous month"\`.
+ */
+previousMonthLabel?: string
+/**
+ * Overrides the accessible label of the button that moves the calendar forward one year.
+ * 
+ * Message id: \`bui.calendar.nextYear\`. Defaults to \`"Next year"\`.
+ */
+nextYearLabel?: string
+/**
+ * Overrides the accessible label of the button that moves the calendar back one year.
+ * 
+ * Message id: \`bui.calendar.previousYear\`. Defaults to \`"Previous year"\`.
+ */
+previousYearLabel?: string
+/**
+ * Overrides the accessible label of the dropdown that jumps the calendar to a chosen month.
+ * 
+ * Message id: \`bui.calendar.selectMonth\`. Defaults to \`"Select month"\`.
+ */
+selectMonthLabel?: string
+/**
+ * Overrides the accessible label of the dropdown that jumps the calendar to a chosen year.
+ * 
+ * Message id: \`bui.calendar.selectYear\`. Defaults to \`"Select year"\`.
+ */
+selectYearLabel?: string
 }`,stories:{usage:[{id:"core-forms-calendar--default",name:"Default",snippet:'const Default = () => <Calendar size="sm" aria-label="Event date" />;'},{id:"core-forms-calendar--with-title",name:"With Title",snippet:'const WithTitle = () => <Calendar size="sm" aria-label="Event date" title="Date" />;'},{id:"core-forms-calendar--with-default-value",name:"With Default Value",snippet:`const WithDefaultValue = () => <Calendar
     size="sm"
     aria-label="Event date"
@@ -3498,6 +3687,42 @@ title?: string
 headerVariant?: | "title"
 | "selectMonth"
 | "selectMonthAndYear"
+/**
+ * Overrides the accessible label of the button that moves the calendar forward one month.
+ * 
+ * Message id: \`bui.calendar.nextMonth\`. Defaults to \`"Next month"\`.
+ */
+nextMonthLabel?: string
+/**
+ * Overrides the accessible label of the button that moves the calendar back one month.
+ * 
+ * Message id: \`bui.calendar.previousMonth\`. Defaults to \`"Previous month"\`.
+ */
+previousMonthLabel?: string
+/**
+ * Overrides the accessible label of the button that moves the calendar forward one year.
+ * 
+ * Message id: \`bui.calendar.nextYear\`. Defaults to \`"Next year"\`.
+ */
+nextYearLabel?: string
+/**
+ * Overrides the accessible label of the button that moves the calendar back one year.
+ * 
+ * Message id: \`bui.calendar.previousYear\`. Defaults to \`"Previous year"\`.
+ */
+previousYearLabel?: string
+/**
+ * Overrides the accessible label of the dropdown that jumps the calendar to a chosen month.
+ * 
+ * Message id: \`bui.calendar.selectMonth\`. Defaults to \`"Select month"\`.
+ */
+selectMonthLabel?: string
+/**
+ * Overrides the accessible label of the dropdown that jumps the calendar to a chosen year.
+ * 
+ * Message id: \`bui.calendar.selectYear\`. Defaults to \`"Select year"\`.
+ */
+selectYearLabel?: string
 }`,stories:{usage:[{id:"core-forms-rangecalendar--default",name:"Default",snippet:'const Default = () => <RangeCalendar size="sm" aria-label="Trip dates" />;'},{id:"core-forms-rangecalendar--with-title",name:"With Title",snippet:'const WithTitle = () => <RangeCalendar size="sm" aria-label="Trip dates" title="Date" />;'},{id:"core-forms-rangecalendar--with-default-value",name:"With Default Value",snippet:`const WithDefaultValue = () => <RangeCalendar
     size="sm"
     aria-label="Trip dates"
@@ -3946,7 +4171,9 @@ pickerMode?: "active" | "lazy"
  */
 storePickedColorKey?: string
 /**
- * The label to show on the add color button.
+ * The label to show on the add color button that opens the color picker
+ * for defining a new custom color. Not to be confused with \`addLabel\`,
+ * which labels the "Add" confirmation button inside that picker.
  * 
  * @default Add Color
  */
@@ -3963,6 +4190,52 @@ removeColorButtonLabel?: string
  * @default Custom Colors
  */
 customColorsLabel?: string
+/**
+ * Overrides the label of the button that saves the custom color being
+ * defined into the palette (shown inside the new-color picker in
+ * \`pickerMode="lazy"\`). Not to be confused with \`addColorButtonLabel\`,
+ * which labels the button that opens that picker.
+ * 
+ * Message id: \`bui.colorInput.add\`. Defaults to \`"Add"\`.
+ */
+addLabel?: string
+/**
+ * Overrides the label of the button that abandons the custom color being
+ * defined (shown inside the new-color picker in \`pickerMode="lazy"\`).
+ * 
+ * Message id: \`bui.colorInput.cancel\`. Defaults to \`"Cancel"\`.
+ */
+cancelLabel?: string
+/**
+ * Overrides the accessible name of the dialog holding the color picker
+ * used to define a new custom color, in \`pickerMode="lazy"\`.
+ * 
+ * Message id: \`bui.colorInput.newColor\`. Defaults to \`"New Custom Color"\`.
+ */
+newColorLabel?: string
+/**
+ * Overrides the accessible name of the control that switches the notation
+ * a color is entered in (HEX, RGB).
+ * 
+ * Message id: \`bui.colorInput.colorFormat\`. Defaults to \`"Color Format"\`.
+ */
+colorFormatLabel?: string
+/**
+ * Overrides the accessible name of the group of predefined color swatches.
+ * 
+ * Message id: \`bui.colorInput.colorPresets\`. Defaults to \`"Color Presets"\`.
+ */
+colorPresetsLabel?: string
+/**
+ * Overrides the label of the swatch that clears the color selection, and the
+ * accessible name of the trigger swatch while no color is set. Triggers that
+ * render no swatch are unaffected; a custom \`renderTriggerButton\` must
+ * forward the \`noneLabel\` it receives.
+ * 
+ * Message ids: \`bui.colorInput.noColor\` (preset swatch),
+ * \`bui.colorSwatch.none\` (trigger swatch). Both default to \`"None"\`.
+ */
+noColorLabel?: string
 /**
  * An optional function to render the custom trigger button.
  * 
@@ -3976,7 +4249,10 @@ renderTriggerButton?: (
     colorName?: string | boolean;
     triggerProps: AriaButtonProps<"button">;
     labelId?: string;
-  } & Pick<ColorSwatchProps, "isIndeterminate" | "indeterminateIcon">,
+  } & Pick<
+    ColorSwatchProps,
+    "isIndeterminate" | "indeterminateIcon" | "noneLabel"
+  >,
 ) => React.JSX.Element
 /**
  * Handler that is called when the user stops dragging or clicking on the
@@ -3990,6 +4266,20 @@ onChangeEnd?: (color: Color | null) => void
  * @default false
  */
 isIndeterminate?: boolean
+/**
+ * Overrides the accessible name of the color trigger when the current
+ * selection spans several different colors (\`isIndeterminate\` is \`true\`).
+ * 
+ * Message id: \`bui.colorInput.indeterminate\`. Defaults to \`"Indeterminate"\`.
+ */
+indeterminateLabel?: string
+/**
+ * Overrides the label of the swatch representing a fully transparent
+ * color.
+ * 
+ * Message id: \`bui.colorInput.transparent\`. Defaults to \`"Transparent"\`.
+ */
+transparentLabel?: string
 /**
  * Handler that is called when the user presses the trigger button. This can
  * be used to track events like clicks on the trigger button.
@@ -4262,6 +4552,13 @@ isIndeterminate?: boolean
  * @default HelpIcon
  */
 indeterminateIcon?: React.FC<IconProps> | null
+/**
+ * Overrides the accessible label used when the swatch has no colour
+ * applied.
+ * 
+ * Message id: \`bui.colorSwatch.none\`. Defaults to \`"None"\`.
+ */
+noneLabel?: string
 }`,stories:{usage:[{id:"core-content-colorswatch--basic",name:"Basic",snippet:'const Basic = () => <ColorSwatch color="#800800" />;'},{id:"core-content-colorswatch--variants",name:"Variants",snippet:`const Variants = (args) => (
   <VariantViewer
     header={["Enabled", "Focused", "Disabled"]}
@@ -4576,6 +4873,28 @@ By default the ComboBox current value cannot be set to values not included in it
 />
 \`\`\`
 
+\`renderOption\` replaces the entire contents of each option \u2014 including the default selection checkmark, so render your own affordance from \`isSelected\` if you need one. Selection and keyboard behavior are unchanged. \`optionClassName\` and \`optionStyle\` accept either a value or a function of the item and its render state, and apply to the option element itself.
+
+Keep all three referentially stable. The collection caches its elements per option and rebuilds every one of them whenever one of these changes identity, so an inline arrow rebuilds the list on each render.
+
+\`\`\`jsx
+const renderOption = React.useCallback(
+ (item) => (
+ <span>
+ {item.label}
+ <span style={{ color: color.text.secondary }}> \u2014 custom</span>
+ </span>
+ ),
+ [],
+);
+
+<ComboBox
+ label="Custom option rendering"
+ items={items}
+ renderOption={renderOption}
+/>;
+\`\`\`
+
 The \`ComboBox\` input field filters visible items in the list to show only the ones that match the typed text. By default, only items that contain that text are shown. A custom filter function can be provided to modify this behavior.
 
 This example provides a filter that will only show items that match exactly the typed text, case sensitive.
@@ -5019,7 +5338,17 @@ onValueChange?: (option: { value?: string; key?: string | null }) => void
   <AddItemDecorator>
     {(items) => <ComboBox label="Select a fruit" {...args} items={items} />}
   </AddItemDecorator>
-);`},{id:"core-forms-combobox--with-tooltip",name:"With Tooltip",snippet:`const WithTooltip = () => <ComboBox
+);`},{id:"core-forms-combobox--with-render-option",name:"With Render Option",snippet:`const WithRenderOption = () => <ComboBox
+    items={items}
+    aria-label="ComboBox"
+    label="Custom option rendering"
+    placeholder="Placeholder"
+    renderOption={(item) => (
+      <span style={{ ...typography.label.md.regular }}>
+        {item.label}
+        <span style={{ color: color.text.secondary }}> \u2014 custom</span>
+      </span>
+    )} />;`},{id:"core-forms-combobox--with-tooltip",name:"With Tooltip",snippet:`const WithTooltip = () => <ComboBox
     items={items}
     aria-label="This is aria-label"
     tooltip
@@ -5090,11 +5419,36 @@ export const itemsWithSections = [
 ] as ListItem[];
 
 export const ComboBoxExample: React.FC<
- Omit<React.ComponentProps<typeof ComboBox>, "items">
-> = (args) => {
+ Omit<React.ComponentProps<typeof ComboBox>, "items"> & {
+ items?: ListItem[];
+ /** Must stay focusable \u2014 the outside-click test asserts focus lands on it. */
+ withSiblingField?: boolean;
+ onNonFocusingPress?: () => void;
+ }
+> = ({
+ items: comboBoxItems = items,
+ withSiblingField,
+ onNonFocusingPress,
+ ...args
+}) => {
  return (
  <Box style={{ width: "100%", height: 200 }}>
- <ComboBox items={items} aria-label="Combo box" {...args} />
+ {/* Above the ComboBox: the popover opens downwards and would otherwise cover
+ the spot a test means to click "outside" on. */}
+ {withSiblingField ? <input aria-label="Sibling field" /> : null}
+ {onNonFocusingPress ? (
+ <button
+ // Stands in for \`preventFocusOnPress\`: the press lands but the input
+ // never blurs.
+ onMouseDown={(e) => {
+ e.preventDefault();
+ }}
+ onClick={onNonFocusingPress}
+ >
+ Toolbar action
+ </button>
+ ) : null}
+ <ComboBox items={comboBoxItems} aria-label="Combo box" {...args} />
  </Box>
  );
 };
@@ -5227,6 +5581,47 @@ export const LabelledByComboBoxExample: React.FC<
  );
 };
 
+export const CustomOptionComboBoxExample: React.FC = () => {
+ return (
+ <ComboBoxExample
+ renderOption={(item) => <span>{item.label} \u2014 custom</span>}
+ optionClassName={(item) => \`custom-option-\${item.id}\`}
+ optionStyle={(_item, { isSelected }) => ({
+ outline: isSelected
+ ? "1px solid rgb(0, 128, 0)"
+ : "1px solid rgb(255, 0, 0)",
+ })}
+ />
+ );
+};
+
+export const CountingOptionComboBoxExample: React.FC<{
+ withSections?: boolean;
+}> = ({ withSections = false }) => {
+ const [count, setCount] = React.useState(0);
+
+ return (
+ <>
+ <button
+ onClick={() => {
+ setCount(count + 1);
+ }}
+ >
+ Increment
+ </button>
+ <ComboBoxExample
+ items={withSections ? itemsWithSections : items}
+ renderOption={(item) => (
+ <span>
+ {item.label} #{count}
+ </span>
+ )}
+ optionClassName={() => \`count-\${count}\`}
+ />
+ </>
+ );
+};
+
 export const SectionComboBoxExample: React.FC = () => {
  return (
  <Box style={{ width: "100%", height: 300 }}>
@@ -5506,6 +5901,13 @@ warningMessage?: string
  * @default "none"
  */
 pickerType?: "none" | "presentation" | "calendar"
+/**
+ * Overrides the accessible label of the button that opens the calendar
+ * picker popover.
+ * 
+ * Message id: \`bui.dateField.openCalendar\`. Defaults to \`"Open calendar"\`.
+ */
+openCalendarLabel?: string
 }`,stories:{usage:[{id:"core-forms-datefield--basic",name:"Basic",snippet:'const Basic = () => <DateField onChange={fn()} aria-label="Event Date" granularity="day" />;'},{id:"core-forms-datefield--with-label",name:"With Label",snippet:'const WithLabel = () => <DateField onChange={fn()} label="Event Date" granularity="day" />;'},{id:"core-forms-datefield--variants",name:"Variants",snippet:`const Variants = (args) => (
   <VariantViewer<React.ComponentProps<typeof DateField>>
     cellStyle={{ minWidth: 300 }}
@@ -7094,6 +7496,12 @@ contentStyle?: React.CSSProperties
  * The class name of the content container.
  */
 contentClassName?: string
+/**
+ * Overrides the accessible label of the close button.
+ * 
+ * Message id: \`bui.drawer.close\`. Defaults to \`"Close"\`.
+ */
+closeLabel?: string
 }`,stories:{usage:[{id:"core-overlays-drawer--basic",name:"Basic",snippet:'const Basic = () => <Drawer title=""><div style={{ height: 400 }} /></Drawer>;'},{id:"core-overlays-drawer--with-action",name:"With Action",snippet:`const WithAction = () => <Drawer
     action={{
       icon: EllipseIcon,
@@ -7325,6 +7733,182 @@ saveOnEnter?: boolean
  * @default true
  */
 autoLink?: boolean
+/**
+ * Overrides the accessible name of the toolbar button that inserts an
+ * @-mention, and the accessible name of the mention combobox it opens.
+ * 
+ * Message id: \`bui.editor.mention\`. Defaults to \`"Mention"\`.
+ */
+mentionLabel?: string
+/**
+ * Overrides the accessible name of the rich text toolbar's Bold toggle, and
+ * the matching row in the keyboard shortcut dialog.
+ * 
+ * Message id: \`bui.editor.bold\`. Defaults to \`"Bold"\`.
+ */
+boldLabel?: string
+/**
+ * Overrides the accessible name of the rich text toolbar's Italic toggle,
+ * and the matching row in the keyboard shortcut dialog.
+ * 
+ * Message id: \`bui.editor.italic\`. Defaults to \`"Italic"\`.
+ */
+italicLabel?: string
+/**
+ * Overrides the accessible name of the rich text toolbar's Underline
+ * toggle, and the matching row in the keyboard shortcut dialog.
+ * 
+ * Message id: \`bui.editor.underline\`. Defaults to \`"Underline"\`.
+ */
+underlineLabel?: string
+/**
+ * Overrides the accessible name of the toolbar control that sets the
+ * colour of the selected text.
+ * 
+ * Message id: \`bui.editor.fontColor\`. Defaults to \`"Font color"\`.
+ */
+fontColorLabel?: string
+/**
+ * Overrides the accessible name of the toolbar control that sets the
+ * highlight colour drawn behind the selected text.
+ * 
+ * Message id: \`bui.editor.backgroundColor\`. Defaults to \`"Background color"\`.
+ */
+backgroundColorLabel?: string
+/**
+ * Overrides the title of the keyboard shortcut dialog, and the accessible
+ * name of the toolbar button that opens it.
+ * 
+ * Message id: \`bui.editor.help\`. Defaults to \`"Help"\`.
+ */
+helpLabel?: string
+/**
+ * Overrides the accessible name of the icon button that dismisses the
+ * keyboard shortcut dialog.
+ * 
+ * Message id: \`bui.editor.close\`. Defaults to \`"Close"\`.
+ */
+closeLabel?: string
+/**
+ * Overrides the "Action" column header of the keyboard shortcut dialog's
+ * table.
+ * 
+ * Message id: \`bui.editor.action\`. Defaults to \`"Action"\`.
+ */
+actionLabel?: string
+/**
+ * Overrides the "Shortcut" column header of the keyboard shortcut dialog's
+ * table.
+ * 
+ * Message id: \`bui.editor.shortcut\`. Defaults to \`"Shortcut"\`.
+ */
+shortcutLabel?: string
+/**
+ * Overrides the row label for the "move focus to the toolbar" command in
+ * the keyboard shortcut dialog.
+ * 
+ * Message id: \`bui.editor.toolbarFocus\`. Defaults to \`"Toolbar Focus"\`.
+ */
+toolbarFocusLabel?: string
+/**
+ * Overrides the row label for the "select all" command in the keyboard
+ * shortcut dialog.
+ * 
+ * Message id: \`bui.editor.selectAll\`. Defaults to \`"Select All"\`.
+ */
+selectAllLabel?: string
+/**
+ * Overrides the row label for the "cut" command in the keyboard shortcut
+ * dialog.
+ * 
+ * Message id: \`bui.editor.cut\`. Defaults to \`"Cut"\`.
+ */
+cutLabel?: string
+/**
+ * Overrides the row label for the "copy" command in the keyboard shortcut
+ * dialog.
+ * 
+ * Message id: \`bui.editor.copy\`. Defaults to \`"Copy"\`.
+ */
+copyLabel?: string
+/**
+ * Overrides the row label for the "paste" command in the keyboard shortcut
+ * dialog.
+ * 
+ * Message id: \`bui.editor.paste\`. Defaults to \`"Paste"\`.
+ */
+pasteLabel?: string
+/**
+ * Overrides the row label for the "undo" command in the keyboard shortcut
+ * dialog.
+ * 
+ * Message id: \`bui.editor.undo\`. Defaults to \`"Undo"\`.
+ */
+undoLabel?: string
+/**
+ * Overrides the row label for the "redo" command in the keyboard shortcut
+ * dialog.
+ * 
+ * Message id: \`bui.editor.redo\`. Defaults to \`"Redo"\`.
+ */
+redoLabel?: string
+/**
+ * Overrides the row label for the "open help dialog" command in the
+ * keyboard shortcut dialog.
+ * 
+ * Message id: \`bui.editor.openHelpDialog\`. Defaults to \`"Open Help Dialog"\`.
+ */
+openHelpDialogLabel?: string
+/**
+ * Overrides the row label for the "submit" command in the keyboard
+ * shortcut dialog.
+ * 
+ * Message id: \`bui.editor.submit\`. Defaults to \`"Submit"\`.
+ */
+submitLabel?: string
+/**
+ * Overrides the accessible name of the link popover's toolbar trigger
+ * button.
+ * 
+ * Message id: \`bui.editor.addLink\`. Defaults to \`"Add Link"\`.
+ */
+addLinkLabel?: string
+/**
+ * Overrides the label of the button that changes the URL of an existing
+ * link, shown in the link popover.
+ * 
+ * Message id: \`bui.editor.editLink\`. Defaults to \`"Edit Link"\`.
+ */
+editLinkLabel?: string
+/**
+ * Overrides the label of the button that unlinks the selected text, shown
+ * in the link popover.
+ * 
+ * Message id: \`bui.editor.removeLink\`. Defaults to \`"Remove Link"\`.
+ */
+removeLinkLabel?: string
+/**
+ * Overrides the label of the URL field in the link popover.
+ * 
+ * Message id: \`bui.editor.linkAnnotation\`. Defaults to \`"Link"\`.
+ */
+linkAnnotationLabel?: string
+/**
+ * Overrides the label of the Cancel button in the link popover's edit mode.
+ * Distinct from \`cancelButtonAriaLabel\`, which labels the editor footer's
+ * Cancel button.
+ * 
+ * Message id: \`bui.editor.cancel\`. Defaults to \`"Cancel"\`.
+ */
+linkCancelLabel?: string
+/**
+ * Overrides the label of the Save button in the link popover's edit mode.
+ * Distinct from \`submitButtonAriaLabel\`, which labels the editor footer's
+ * Save button.
+ * 
+ * Message id: \`bui.editor.save\`. Defaults to \`"Save"\`.
+ */
+linkSaveLabel?: string
 }`,stories:{usage:[{id:"core-miscellaneous-editor-rich-text--default",name:"Default",snippet:`const Default = () => <Editor
     placeholder="Placeholder"
     aria-label="Editor"
@@ -8035,6 +8619,27 @@ onRemove?: (id: string) => void
  * button or keyboard.
  */
 disabledKeys?: Iterable<string> | "all"
+/**
+ * Overrides the accessible name of a file row while it is loading, and of
+ * its spinner.
+ * 
+ * Message id: \`bui.fileList.loading\`. Defaults to \`"Loading {fileName}"\`.
+ * A string is used as-is, with no placeholder substitution. To include
+ * \`fileName\`, pass a function \u2014 it receives \`{ fileName }\` and its return
+ * value is used verbatim.
+ */
+loadingLabel?: string | ((values: { fileName: string }) => string)
+/**
+ * Overrides the accessible name of a removable file row, telling keyboard
+ * users how to delete it.
+ * 
+ * Message id: \`bui.fileList.removeHint\`. Defaults to
+ * \`"{fileName}, press Delete or Backspace to remove"\`. A string is used
+ * as-is, with no placeholder substitution. To include \`fileName\`, pass a
+ * function \u2014 it receives \`{ fileName }\` and its return value is used
+ * verbatim.
+ */
+removeHintLabel?: string | ((values: { fileName: string }) => string)
 }`,stories:{usage:[{id:"core-collections-filelist--basic",name:"Basic",snippet:`const Basic = () => {
     const [items, setItems] = React.useState(args.items);
     React.useEffect(() => {
@@ -8163,7 +8768,7 @@ disabledKeys?: Iterable<string> | "all"
 import { ActionButton } from "../../ActionButton";
 import { FileList } from "../FileList";
 
-import type { FileListItem } from "../FileList.types";
+import type { FileListItem, FileListProps } from "../FileList.types";
 
 export const defaultItems: FileListItem[] = [
  { id: "1", name: "report.pdf" },
@@ -8244,11 +8849,16 @@ export const UploadingFileList: React.FC = () => {
 interface BasicProps {
  onRemove?: (id: string) => void;
  disabledKeys?: Iterable<string> | "all";
+ removeHintLabel?: FileListProps["removeHintLabel"];
+ /** Playwright cannot serialize a function prop, so the callback form is built here. */
+ useFunctionLabel?: boolean;
 }
 
 export const BasicFileList: React.FC<BasicProps> = ({
  onRemove,
  disabledKeys,
+ removeHintLabel,
+ useFunctionLabel,
 }) => {
  const [items, setItems] = React.useState<FileListItem[]>(defaultItems);
  return (
@@ -8256,6 +8866,11 @@ export const BasicFileList: React.FC<BasicProps> = ({
  aria-label="Uploaded files"
  items={items}
  disabledKeys={disabledKeys}
+ removeHintLabel={
+ useFunctionLabel
+ ? ({ fileName }) => \`Remove \${fileName}?\`
+ : removeHintLabel
+ }
  onRemove={(id) => {
  onRemove?.(id);
  setItems((current) => current.filter((item) => item.id !== id));
@@ -8268,8 +8883,25 @@ export const EmptyFileList: React.FC = () => (
  <FileList aria-label="Empty" items={[]} />
 );
 
-export const LoadingFileList: React.FC = () => (
- <FileList aria-label="Uploaded files" items={loadingItems} />
+interface LoadingProps {
+ loadingLabel?: FileListProps["loadingLabel"];
+ /** Playwright cannot serialize a function prop, so the callback form is built here. */
+ useFunctionLabel?: boolean;
+}
+
+export const LoadingFileList: React.FC<LoadingProps> = ({
+ loadingLabel,
+ useFunctionLabel,
+}) => (
+ <FileList
+ aria-label="Uploaded files"
+ items={loadingItems}
+ loadingLabel={
+ useFunctionLabel
+ ? ({ fileName }) => \`Working on \${fileName}\`
+ : loadingLabel
+ }
+ />
 );
 
 export const ErrorFileList: React.FC = () => (
@@ -9998,9 +10630,9 @@ children: React.ReactNode
 This example shows how to use \`I18nProvider\` to override the default locale.
 
 \`\`\`jsx
-import { I18nProvider } from "@storybook/core";
+import { I18nProvider } from "@baseline-ui/core";
 
-export const App = () => (
+export const Root = () => (
  <I18nProvider locale="en">
  <App />
  </I18nProvider>
@@ -10011,14 +10643,18 @@ The \`App\` component will receive the new locale through \`useLocale\`.
 
 \`\`\`jsx
 // App.js
-import { useLocale } from "@storybook/core";
+import { useLocale } from "@baseline-ui/core";
 
 const App = () => {
- const locale = useLocale();
+ const { locale } = useLocale();
 
  return <div>Current locale: {locale}</div>;
 };
-\`\`\``,props:`interface I18nProviderProps {
+\`\`\`
+
+\`locale\` only switches date, number and collation formatting and text direction. To
+translate the strings Baseline UI renders, pass a catalog through \`messages\` \u2014 see
+[Internationalization](/?path=/docs/internationalization--docs#loading-a-translation-catalog).`,props:`interface I18nProviderProps {
 /**
  * Contents that should have the locale applied.
  */
@@ -10044,6 +10680,8 @@ shouldLogMissingMessages?: boolean
 import React from "react";
 
 import { useI18n } from "../../../hooks";
+import { Pagination } from "../../Pagination";
+import { I18nProvider } from "../I18nProvider";
 
 export const messages = {
  en: { greeting: "Hello, {name} !" },
@@ -10095,7 +10733,23 @@ export const LocaleStringExample: React.FC<{
  {formatter.formatMessage("greeting", { name })}
  </div>
  );
-};`},similarTo:[],figmaUrl:null},ImageDropZone:{id:"core-forms-imagedropzone",breadcrumb:"Core/Forms/ImageDropZone",importStatement:'import { ImageDropZone, VariantViewer } from "@baseline-ui/core";',description:"`ImageDropZone` is a single-image input that accepts a file via drag-and-drop, paste, or the native picker and previews it in place. Use it when collecting one representative image, such as an avatar, logo, or thumbnail, with an optional replace and remove flow.",documentation:`\`ImageDropZone\` is a single-image input that accepts a file via drag-and-drop, paste, or the native picker and previews it in place. Use it when collecting one representative image, such as an avatar, logo, or thumbnail, with an optional replace and remove flow.
+};
+
+const paginationCatalog = {
+ en: { "bui.pagination.pageXofY": "Catalog position" },
+};
+
+/** The same ID resolved twice: from the catalog, and from an override prop. */
+export const OverridePrecedenceExample: React.FC = () => (
+ <I18nProvider locale="en" messages={paginationCatalog}>
+ <Pagination aria-label="from catalog" maxValue={10} />
+ <Pagination
+ aria-label="from prop"
+ maxValue={10}
+ pageXofYLabel="Prop position"
+ />
+ </I18nProvider>
+);`},similarTo:[],figmaUrl:null},ImageDropZone:{id:"core-forms-imagedropzone",breadcrumb:"Core/Forms/ImageDropZone",importStatement:'import { ImageDropZone, VariantViewer } from "@baseline-ui/core";',description:"`ImageDropZone` is a single-image input that accepts a file via drag-and-drop, paste, or the native picker and previews it in place. Use it when collecting one representative image, such as an avatar, logo, or thumbnail, with an optional replace and remove flow.",documentation:`\`ImageDropZone\` is a single-image input that accepts a file via drag-and-drop, paste, or the native picker and previews it in place. Use it when collecting one representative image, such as an avatar, logo, or thumbnail, with an optional replace and remove flow.
 
 * Automatic handling of Keyboard focus management and cross browser normalization
 * Labeling support for screen readers (aria-describedby)
@@ -10630,6 +11284,28 @@ layoutTransition?: Transition | boolean
  * @default "Are you sure you want to delete this item?"
  */
 deleteConfirmationTitle?: string | ((selectedKeys: Selection) => string)
+/**
+ * Overrides the label of the button that permanently deletes the selected
+ * image(s), and the accessible label of each image's individual delete
+ * button.
+ * 
+ * Message id: \`bui.imageGallery.delete\`. Defaults to \`"Delete"\`.
+ */
+deleteLabel?: string
+/**
+ * Overrides the label of the button that dismisses the delete confirmation
+ * modal without deleting anything.
+ * 
+ * Message id: \`bui.imageGallery.cancel\`. Defaults to \`"Cancel"\`.
+ */
+cancelLabel?: string
+/**
+ * Overrides the accessible label announced while an image is still
+ * loading.
+ * 
+ * Message id: \`bui.imageGallery.loading\`. Defaults to \`"Loading"\`.
+ */
+loadingLabel?: string
 }`,stories:{usage:[{id:"core-collections-imagegallery--basic",name:"Basic",snippet:'const Basic = () => <ImageGallery fit="cover" aria-label="Image gallery" defaultItems={items.slice(0, 4)} />;'},{id:"core-collections-imagegallery--more-items",name:"More Items",snippet:'const MoreItems = () => <ImageGallery fit="cover" aria-label="Image gallery" defaultItems={items} />;'},{id:"core-collections-imagegallery--with-medium-size",name:"With Medium Size",snippet:`const WithMediumSize = () => <ImageGallery
     fit="cover"
     aria-label="Image gallery"
@@ -10790,6 +11466,10 @@ import { Box } from "../../Box";
 import { I18nProvider } from "../../I18nProvider";
 import { NumberInput } from "../../NumberInput";
 import { Text } from "../../Text";
+import {
+ VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS,
+ Virtualizer,
+} from "../../Virtualizer";
 import { ImageGallery, ImageSize } from "../ImageGallery";
 import { items } from "./data";
 
@@ -11102,6 +11782,43 @@ export function RTLImageGalleryExample(
  <ImageGallery {...props} />
  </I18nProvider>
  );
+}
+
+/**
+ * Driven by a window event rather than a button, because clicking anything would move focus
+ * and end the keyboard drag by itself.
+ */
+export function RerenderOnDemandImageGalleryExample({
+ isVirtualized = false,
+ ...props
+}: Omit<React.ComponentProps<typeof ImageGallery>, "onDelete"> & {
+ isVirtualized?: boolean;
+}) {
+ const [, rerender] = React.useReducer((tick: number) => tick + 1, 0);
+
+ React.useEffect(() => {
+ const onRerender = () => {
+ rerender();
+ };
+
+ window.addEventListener("repro:rerender", onRerender);
+
+ return () => {
+ window.removeEventListener("repro:rerender", onRerender);
+ };
+ }, []);
+
+ const gallery = <ImageGallery defaultItems={items} {...props} />;
+
+ if (!isVirtualized) {
+ return gallery;
+ }
+
+ return (
+ <Virtualizer {...VIRTUALIZER_LAYOUT_DEFAULT_OPTIONS.IMAGE_GALLERY}>
+ {gallery}
+ </Virtualizer>
+ );
 }`},similarTo:[],figmaUrl:null},InlineAlert:{id:"core-status-inlinealert",breadcrumb:"Core/Status/InlineAlert",importStatement:'import { InlineAlert } from "@baseline-ui/core";',description:"`InlineAlert` is a status message anchored next to related content, with success, warning, error, or info styling and optional action and dismiss buttons. Use it for persistent, in-context feedback that should stay visible without interrupting the user's flow.",documentation:`\`InlineAlert\` is a status message anchored next to related content, with success, warning, error, or info styling and optional action and dismiss buttons. Use it for persistent, in-context feedback that should stay visible without interrupting the user's flow.
 
 * Exposed to assistive technology with \`role="alert"\`.
@@ -11272,6 +11989,12 @@ onAction?: () => void
  * close button will be rendered.
  */
 onClose?: () => void
+/**
+ * Overrides the accessible label of the close button.
+ * 
+ * Message id: \`bui.inlineAlert.close\`. Defaults to \`"Close"\`.
+ */
+closeLabel?: string
 /**
  * The arrangement of the variable.
  * 
@@ -14694,6 +15417,18 @@ size?: "xs" | "sm" | "md" | "lg"
  * Whether to hide the increment and decrement actions.
  */
 hideActions?: boolean
+/**
+ * Overrides the accessible name announcing the current position in the
+ * document.
+ * 
+ * Message id: \`bui.pagination.pageXofY\`. Defaults to
+ * \`"Page {arg0} of {arg1}"\`, where \`arg0\` is the current page and \`arg1\`
+ * the total page count. A string is used as-is, with no placeholder
+ * substitution. To include the numbers, pass a function \u2014 it receives
+ * \`{ page, totalPages }\` and its return value is used verbatim.
+ */
+pageXofYLabel?: | string
+| ((values: { page: number; totalPages: number }) => string)
 minValue?: any
 defaultValue?: any
 }`,stories:{usage:[{id:"core-forms-pagination--primary",name:"Primary",snippet:'const Primary = () => <Pagination maxValue={10} aria-label="Pagination" />;'},{id:"core-forms-pagination--variants",name:"Variants",snippet:`const Variants = (args) => (
@@ -14757,7 +15492,29 @@ defaultValue?: any
       },
     }}>
     <Pagination maxValue={10} aria-label="Pagination" />
-</I18nProvider>;`}],implementation:""},similarTo:[],figmaUrl:null},Panel:{id:"core-utilities-panel",breadcrumb:"Core/Utilities/Panel",importStatement:`import {
+</I18nProvider>;`}],implementation:`import React from "react";
+
+import { Pagination } from "../Pagination";
+
+/**
+ * Pagination whose \`pageXofYLabel\` is the callback form. Playwright cannot
+ * serialize a function prop, so it is built here rather than in the spec.
+ *
+ * The label does arithmetic on \`page\` so the assertion fails if the callback
+ * is ever handed the formatted string instead of the number.
+ */
+export function FunctionPageLabelPagination() {
+ return (
+ <Pagination
+ aria-label="test"
+ maxValue={100}
+ defaultValue={5}
+ pageXofYLabel={({ page, totalPages }) =>
+ \`Currently \${page}/\${totalPages}, next is \${page + 1}\`
+ }
+ />
+ );
+}`},similarTo:[],figmaUrl:null},Panel:{id:"core-utilities-panel",breadcrumb:"Core/Utilities/Panel",importStatement:`import {
     PanelCollapsibleStoryExample,
     PanelConditionalExample,
     PanelControlledExample,
@@ -19297,6 +20054,36 @@ hideSelectAll?: boolean
  * @default false
  */
 hideClear?: boolean
+/**
+ * Overrides the label of the button that unticks every selected option.
+ * 
+ * Message id: \`bui.select.clear\`. Defaults to \`"Clear"\`.
+ */
+clearLabel?: string
+/**
+ * Overrides the placeholder and accessible name of the input that filters
+ * the option list.
+ * 
+ * Message id: \`bui.select.search\`. Defaults to \`"Search"\`.
+ */
+searchLabel?: string
+/**
+ * Overrides the label of the button that ticks every option in a
+ * multi-select list.
+ * 
+ * Message id: \`bui.select.selectAll\`. Defaults to \`"Select All"\`.
+ */
+selectAllLabel?: string
+/**
+ * Overrides the tag shown on the select trigger standing in for the
+ * selected options that did not fit.
+ * 
+ * Message id: \`bui.select.more\`. Defaults to \`"+{count} more"\`, where
+ * \`count\` is the number of hidden options. A string is used as-is, with
+ * no placeholder substitution. To include \`count\`, pass a function \u2014 it
+ * receives \`{ count }\` and its return value is used verbatim.
+ */
+moreLabel?: string | ((values: { count: number }) => string)
 }`,stories:{usage:[{id:"core-forms-select-multiselect--basic",name:"Basic",error:{name:"SyntaxError",message:`Expected story to be a function or variable declaration
   32 | type Story = StoryObj<typeof meta>;
   33 |
@@ -19518,13 +20305,19 @@ import type { IconSelectProps } from "../Select.types";
 import type { Key } from "@react-types/shared";
 
 export const SelectExample: React.FC<
- Omit<React.ComponentProps<typeof Select>, "items">
-> = (args) => {
+ Omit<React.ComponentProps<typeof Select>, "items"> & {
+ /** Playwright cannot serialize a function prop, so the callback form is built here. */
+ useFunctionLabel?: boolean;
+ }
+> = ({ useFunctionLabel, ...args }) => {
  return (
  <Select
  placeholder="Choose an item"
  optionClassName={(item) => item.label}
  {...args}
+ moreLabel={
+ useFunctionLabel ? ({ count }) => \`\${count} others\` : args.moreLabel
+ }
  items={items}
  />
  );
@@ -20652,6 +21445,23 @@ isDisabled?: boolean
  * (e.g. "Checkout").
  */
 aria-label?: string
+/**
+ * Overrides the fallback accessible name of a step when the application
+ * supplies no title.
+ * 
+ * Message id: \`bui.stepper.step\`. Defaults to \`"Step {index}"\`, where
+ * \`index\` is the step's 1-based position. A string is used as-is, with
+ * no placeholder substitution. To include \`index\`, pass a function \u2014 it
+ * receives \`{ index }\` and its return value is used verbatim.
+ */
+stepLabel?: string | ((values: { index: number }) => string)
+/**
+ * Overrides the screen-reader-only suffix marking a step the reader has
+ * finished.
+ * 
+ * Message id: \`bui.stepper.completed\`. Defaults to \`"Completed"\`.
+ */
+completedLabel?: string
 }`,stories:{usage:[{id:"core-navigation-stepper--default",name:"Default",snippet:`const Default = () => <Stepper
     items={items}
     aria-label="Checkout"
@@ -20824,6 +21634,22 @@ export const checkoutItems: StepperItem[] = [
 
 const defaultItems = checkoutItems;
 
+/**
+ * Condensed Stepper whose \`stepLabel\` is the callback form. Playwright cannot
+ * serialize a function prop, so it is built here rather than in the spec.
+ */
+export function FunctionStepLabelStepper() {
+ return (
+ <Stepper
+ items={defaultItems.map(({ key }) => ({ key }))}
+ variant="condensed"
+ defaultSelectedStep="cart"
+ aria-label="Checkout"
+ stepLabel={({ index }) => \`Phase \${index}\`}
+ />
+ );
+}
+
 export interface ControlledStepperProps {
  items?: StepperItem[];
  initialSelected?: Key;
@@ -22787,6 +23613,7 @@ interface AsyncLoadingTableExampleProps {
  totalCount?: number;
  loadingDelay?: number;
  scrollOffset?: number;
+ loadingLabel?: string;
 }
 
 /** Virtualized table that loads more rows automatically near the end. */
@@ -22800,6 +23627,7 @@ export const AsyncLoadingTableExample: React.FC<
  totalCount = 60,
  loadingDelay = 50,
  scrollOffset = 1,
+ loadingLabel,
 }) => {
  const dataset = generateLargeDataset(totalCount);
  const [visibleCount, setVisibleCount] = useState(initialCount);
@@ -22865,6 +23693,7 @@ export const AsyncLoadingTableExample: React.FC<
  }
  isLoading={isLoading}
  scrollOffset={scrollOffset}
+ loadingLabel={loadingLabel}
  >
  {(row) => {
  const typedRow = row as ReturnType<typeof generateLargeDataset>[0];
@@ -26317,6 +27146,14 @@ onKeyDown?: KeyboardProps["onKeyDown"]
  * @default true
  */
 isSingleTabStop?: boolean
+/**
+ * Overrides the accessible label of the overflow button that reveals the
+ * toolbar items which did not fit in the available width. This prop is
+ * only relevant when \`isCollapsible\` is true.
+ * 
+ * Message id: \`bui.toolbar.more\`. Defaults to \`"More"\`.
+ */
+moreLabel?: string
 }`,stories:{usage:[{id:"core-miscellaneous-toolbar--basic",name:"Basic",snippet:'const Basic = () => <Toolbar style={{ display: "flex", flexDirection: "row", alignItems: "center" }}><ToolbarChildren /></Toolbar>;'},{id:"core-miscellaneous-toolbar--vertical",name:"Vertical",snippet:`const Vertical = () => <Toolbar
     orientation="vertical"
     style={{ display: "flex", flexDirection: "column", alignItems: "center" }} />;`},{id:"core-miscellaneous-toolbar--with-tooltip",name:"With Tooltip",snippet:"const WithTooltip = () => <Toolbar><ChildrenWithTooltip /></Toolbar>;"},{id:"core-miscellaneous-toolbar--with-over-flow",name:"With Over Flow",snippet:'const WithOverFlow = () => <Toolbar style={{ width: "max-content", display: "flex", alignItems: "center" }} />;'},{id:"core-miscellaneous-toolbar--with-tabbing-within",name:"With Tabbing Within",snippet:`const WithTabbingWithin = () => <Toolbar
@@ -26391,6 +27228,7 @@ export const CollapsibleChildren: React.FC<{
  onDisabledPress?: () => void;
  maxWidth?: number;
  onKeyDown?: (e: React.KeyboardEvent) => void;
+ moreLabel?: string;
 }> = ({
  onPageAdd,
  onPageRemove,
@@ -26399,6 +27237,7 @@ export const CollapsibleChildren: React.FC<{
  onDisabledPress,
  maxWidth: _maxWidth,
  onKeyDown,
+ moreLabel,
 }) => {
  const [maxWidth, setMaxWidth] = useState(_maxWidth);
 
@@ -26428,7 +27267,11 @@ export const CollapsibleChildren: React.FC<{
  justifyContent: "center",
  }}
  onKeyDown={onKeyDown}
- collapsibleMenuProps={{
+ moreLabel={moreLabel}
+ collapsibleMenuProps={
+ moreLabel
+ ? undefined
+ : {
  renderTrigger: ({ buttonProps, ref }) => (
  <ActionIconButton
  {...buttonProps}
@@ -26440,7 +27283,8 @@ export const CollapsibleChildren: React.FC<{
  tooltip={true}
  />
  ),
- }}
+ }
+ }
  >
  <ActionButton
  iconStart={EllipseIcon}
@@ -27164,11 +28008,32 @@ secondaryActionAriaLabel?: string | ((key: Key) => string)
  * @default "start"
  */
 actionsPosition?: "start" | "end"
+/**
+ * Overrides the accessible label of the button that expands a tree item to
+ * reveal its children.
+ * 
+ * Message id: \`bui.treeView.expand\`. Defaults to \`"Expand"\`.
+ */
+expandLabel?: string
+/**
+ * Overrides the accessible label of the button that collapses a tree item
+ * to hide its children.
+ * 
+ * Message id: \`bui.treeView.collapse\`. Defaults to \`"Collapse"\`.
+ */
+collapseLabel?: string
 /**
  * The callback function that is called when the item is renamed. The rename
  * functionality is disabled if not provided.
  */
 onRename?: (options: { key: Key; value: string }) => void
+/**
+ * Overrides the accessible label of the input shown while an item is being
+ * renamed.
+ * 
+ * Message id: \`bui.treeView.rename\`. Defaults to \`"Rename"\`.
+ */
+renameLabel?: string
 /**
  * The callback function that is called when the item is clicked.
  */
@@ -27386,6 +28251,27 @@ export function TreeViewWithPrimaryActionAtEnd({
  );
 }
 
+export function TreeViewWithSwappableLabels(): React.JSX.Element {
+ const [swapped, setSwapped] = useState(false);
+ const items = useMemo(() => getTreeItems({}), []);
+
+ return (
+ <Box display="flex" flexDirection="column" gap="md">
+ <ActionButton
+ label="Swap labels"
+ onPress={() => {
+ setSwapped(true);
+ }}
+ />
+ <TreeView
+ items={items}
+ defaultExpandedKeys={["documents"]}
+ expandLabel={swapped ? "Aufklappen" : "Expand"}
+ />
+ </Box>
+ );
+}
+
 export function TreeViewWithCustomTitle(): React.JSX.Element {
  return (
  <TreeView
@@ -27785,6 +28671,10 @@ style?: React.CSSProperties
 /**
  * The custom render function for the listbox options.
  * 
+ * Replaces the option's entire contents, including the default selection
+ * indicator \u2014 render your own affordance from \`options.isSelected\` if you
+ * need one. Selection and keyboard behavior are unaffected.
+ * 
  * Reading component state here works, at the cost of rebuilding every cached option and
  * section whenever the function's identity changes \u2014 see {@link UNSAFE_ListBoxProps.items}
  * for when that cost applies.
@@ -27797,7 +28687,7 @@ renderOption?: (
   options: ListBoxItemRenderProps,
 ) => React.ReactNode
 /**
- * The CSS class name for the option.
+ * A CSS class name added to the option's built-in classes.
  * 
  * Compared by identity, so an inline function or an unmemoized value rebuilds every
  * cached option and section on each render. A plain string is compared by value.
@@ -28109,8 +28999,27 @@ export const ListBoxWithSectionsExample: React.FC<
 export const DragAndDropListBoxExample: React.FC<
  Omit<React.ComponentProps<typeof ListBox>, "items" | "onReorder"> & {
  customPreview?: boolean;
+ rerenderOnEvent?: boolean;
  }
-> = ({ orientation, layout, customPreview, ...rest }) => {
+> = ({ orientation, layout, customPreview, rerenderOnEvent, ...rest }) => {
+ const [, rerender] = React.useReducer((tick: number) => tick + 1, 0);
+
+ React.useEffect(() => {
+ if (!rerenderOnEvent) {
+ return;
+ }
+
+ const onRerender = () => {
+ rerender();
+ };
+
+ window.addEventListener("repro:rerender", onRerender);
+
+ return () => {
+ window.removeEventListener("repro:rerender", onRerender);
+ };
+ }, [rerenderOnEvent]);
+
  const list = useListData({
  initialItems: Array.from({ length: 20 }).map((_, i) => ({
  id: \`item-\${i}\`,
@@ -33837,13 +34746,19 @@ import type { IconSelectProps } from "../Select.types";
 import type { Key } from "@react-types/shared";
 
 export const SelectExample: React.FC<
- Omit<React.ComponentProps<typeof Select>, "items">
-> = (args) => {
+ Omit<React.ComponentProps<typeof Select>, "items"> & {
+ /** Playwright cannot serialize a function prop, so the callback form is built here. */
+ useFunctionLabel?: boolean;
+ }
+> = ({ useFunctionLabel, ...args }) => {
  return (
  <Select
  placeholder="Choose an item"
  optionClassName={(item) => item.label}
  {...args}
+ moreLabel={
+ useFunctionLabel ? ({ count }) => \`\${count} others\` : args.moreLabel
+ }
  items={items}
  />
  );
@@ -34178,7 +35093,7 @@ popoverContentProps?: Omit<PopoverContentProps, "children">
     formatValue={(value: number) => \`\${value} pt\`}
     aria-label="Icon slider"
     onTriggerPress={fn()}
-    isDisabled />;`}],implementation:""},similarTo:[],figmaUrl:null}};var i={gettingStarted:`# Getting started
+    isDisabled />;`}],implementation:""},similarTo:[],figmaUrl:null}};var o={gettingStarted:`# Getting started
 
 Install the packages required for using Baseline UI with the following command:
 
@@ -34497,7 +35412,7 @@ Localization is the process of translating your website into different languages
 
 Baseline UI automatically detects a user\u2019s preferred language from the browser, and it uses that language for all localization. It\u2019s possible to override the language used for localization by providing a \`locale\` prop to the \`I18nProvider\` component.
 
-See [\`useMessageFormatter\`](https://react-spectrum.adobe.com/react-aria/useMessageFormatter.html), [\`DateFormat\`](/?path=/docs/utilities-dateformat--docs), [\`NumberFormat\`](/?path=/docs/utilities-numberformat--docs), and [\`useCollator\`](https://react-spectrum.adobe.com/react-aria/useCollator.html) for more information about using our internationalization hooks.
+See [\`useMessageFormatter\`](https://react-spectrum.adobe.com/react-aria/useMessageFormatter.html), [\`DateFormat\`](/?path=/docs/core-utilities-dateformat--docs), [\`NumberFormat\`](/?path=/docs/core-utilities-numberformat--docs), and [\`useCollator\`](https://react-spectrum.adobe.com/react-aria/useCollator.html) for more information about using our internationalization hooks.
 
 ### Example
 
@@ -34517,7 +35432,7 @@ function YourApp() {
 }
 \`\`\`
 
-You can also override the language used for localization with the [\`I18nProvider\`](/?path=/docs/utilities-i18nprovider--docs) component:
+You can also override the language used for localization with the [\`I18nProvider\`](/?path=/docs/core-utilities-i18nprovider--docs) component:
 
 \`\`\`jsx
 import { I18nProvider } from "@baseline-ui/core";
@@ -34556,6 +35471,10 @@ so \`{ de }\` answers for \`de\`, \`de-DE\` and \`de-AT\` alike, and \`{ de, "de
 TypeScript needs \`resolveJsonModule\` enabled to import the files, and Node ESM needs a
 \`with { type: "json" }\` import attribute.
 
+Key each catalog with a BCP 47 locale ID. An underscored key (\`de_DE\`) is read as its
+hyphenated form, so both spellings resolve \u2014 but supplying the same locale under both is
+reported once, and the hyphenated entry wins.
+
 To avoid shipping every language up front, put each catalog behind a dynamic \`import()\`
 and load one when the user picks a language. Write the specifiers out in full \u2014 a
 template literal over a bare package subpath is not statically analyzable, so bundlers
@@ -34583,8 +35502,70 @@ ship it. Outside production, each such ID is reported once in the console.
 If you supply catalogs but none of them matches the active locale \u2014 \`{ de }\` while the
 locale is \`ja-JP\`, say \u2014 every string falls back to English and that is reported once for
 the locale rather than once per ID. It means the catalog keys and the locale disagree,
-which no per-ID warning can tell you. Supplying no catalogs at all is the supported
-English-only mode and stays silent.
+which no per-ID warning can tell you. It stays quiet when the active locale is itself
+English, since falling back to English is then the intended result. Supplying no catalogs
+at all is the supported English-only mode and stays silent.
+
+Only \`bui.*\` IDs are reported. An app that routes its own strings through
+[\`useI18n\`](#your-own-strings) is missing no translation Baseline UI can tell it how to add.
+
+### Controlling the warnings
+
+The warnings above \u2014 the missing-ID, no-matching-catalog, duplicate-locale-key and
+[bare-ID deprecation](#migrating-from-bare-ids) ones \u2014 are development guidance, so they
+are off when \`process.env.NODE_ENV === "production"\`. That keeps a consumer who never
+touched \`messages\` from logging Baseline UI's internal IDs to their end users. Set
+\`shouldLogMissingMessages\` to force them either way:
+
+\`\`\`jsx
+// Surface them in a production build \u2014 e.g. a staging deploy checking catalog coverage.
+<I18nProvider locale="de-DE" messages={messages} shouldLogMissingMessages>
+ <YourApp />
+</I18nProvider>;
+
+// Or silence them in development, while a catalog is still being filled in.
+<I18nProvider
+ locale="de-DE"
+ messages={messages}
+ shouldLogMissingMessages={false}
+>
+ <YourApp />
+</I18nProvider>;
+\`\`\`
+
+Each distinct warning is logged once and reset when the locale changes, so switching
+languages re-reports what the new locale is missing.
+
+### Your own strings
+
+\`useI18n\` is the same hook the components use, so you can put your application's strings
+through it and get one formatter for both:
+
+\`\`\`tsx
+import { defineMessages, useI18n } from "@baseline-ui/core";
+
+const messages = defineMessages({
+ greeting: {
+ id: "myApp.greeting",
+ defaultMessage: "Hello, {name}",
+ description:
+ "Greeting on the dashboard header. {name} is the user's first name.",
+ },
+});
+
+// Hoisted for the same reason as the catalogs above.
+const catalogs = { de: { "myApp.greeting": "Hallo, {name}" } };
+
+function Header({ name }) {
+ const { formatMessage } = useI18n(catalogs);
+
+ return <h1>{formatMessage(messages.greeting, { name })}</h1>;
+}
+\`\`\`
+
+The catalogs you pass to \`useI18n\` are merged per locale with the ones on \`I18nProvider\`,
+and the provider wins on a shared key \u2014 so an application can hold its own strings locally
+while a host app still overrides any \`bui.*\` string from above.
 
 ### Supported locales
 
@@ -34602,8 +35583,10 @@ import { messageIds } from "@baseline-ui/core";
 const uncovered = messageIds.filter((id) => !(id in ourCatalog.en));
 \`\`\`
 
-For the English string behind each ID \u2014 and the translator context that goes with it \u2014
-read \`@baseline-ui/core/messages.json\`, the extracted source messages keyed by ID.
+Below is every ID with the English string it renders, and the prop that overrides it on a
+single component instance (see [Overriding one instance](#overriding-one-instance)). For
+the translator context that goes with each one, read \`@baseline-ui/core/messages.json\` \u2014
+the extracted source messages keyed by ID.
 
 ### Translating them yourself
 
@@ -34643,13 +35626,56 @@ import de from "@baseline-ui/core/intl/de.json";
 </I18nProvider>;
 \`\`\`
 
+### Overriding one instance
+
+\`I18nProvider.messages\` changes a string everywhere it renders. To change it for one
+component instance \u2014 two galleries on the same page whose delete buttons should read
+differently \u2014 pass the override prop from the [Message IDs](#translations-list) table
+instead:
+
+\`\`\`jsx
+<ImageGallery deleteLabel="Remove page" />
+<ImageGallery deleteLabel="Remove signature" />
+\`\`\`
+
+A prop wins over an \`I18nProvider\` catalog entry for the same ID, which in turn wins over
+the built-in English default. For most props an empty string is a real override:
+\`closeLabel=""\` renders an empty label rather than falling back to \`"Close"\`.
+
+The props that pre-date this feature keep their existing behaviour and treat \`""\` as
+unset: \`aria-label\` on \`Pagination\` and \`Stepper\`, \`Pagination\`'s \`incrementAriaLabel\` and
+\`decrementAriaLabel\`, \`ButtonSelect\`'s \`moreAriaLabel\`, \`ColorInput\`'s
+\`addColorButtonLabel\`, \`removeColorButtonLabel\` and \`customColorsLabel\`, \`Editor\`'s
+\`submitButtonAriaLabel\` and \`cancelButtonAriaLabel\`, \`FreehandCanvas\`'s \`undoLabel\` and
+\`redoLabel\`, and \`ImageDropZone\`'s \`pickerButtonLabel\`.
+
+Five IDs interpolate a value \u2014 \`bui.fileList.loading\`, \`bui.fileList.removeHint\`,
+\`bui.pagination.pageXofY\`, \`bui.select.more\`, and \`bui.stepper.step\`. Their props accept
+either form:
+
+\`\`\`jsx
+{
+ /* A string renders verbatim \u2014 placeholders are not substituted. */
+}
+<Stepper stepLabel="Current stage" />;
+
+{
+ /* A function receives the values and returns the finished string. */
+}
+<Stepper stepLabel={({ index }) => \`Phase \${index}\`} />;
+\`\`\`
+
+The props only cover Baseline UI's own \`bui.*\` strings. Strings that come from the
+underlying accessibility layer \u2014 drag-and-drop announcements, calendar cell descriptions \u2014
+are not overridable this way.
+
 Each component's documentation lists its overridable keys and shows an example. See:
 
-* [Pagination](?path=/docs/components-pagination--docs#translations)
-* [ColorInput](?path=/docs/components-colorinput--docs#translations)
-* [ImageDropZone](?path=/docs/components-imagedropzone--docs#translations)
-* [FreehandCanvas](?path=/docs/components-freehandcanvas--docs#translations)
-* [InlineAlert](?path=/docs/components-inlinealert--docs#translations)
+* [Pagination](?path=/docs/core-forms-pagination--docs#translations)
+* [ColorInput](?path=/docs/core-forms-colorinput--docs#translations)
+* [ImageDropZone](?path=/docs/core-forms-imagedropzone--docs#translations)
+* [FreehandCanvas](?path=/docs/core-miscellaneous-freehandcanvas--docs#translations)
+* [InlineAlert](?path=/docs/core-status-inlinealert--docs#translations)
 
 ### Migrating from bare IDs
 
@@ -35595,7 +36621,7 @@ padding={[null, "lg", "xl"]}
 
 * [vanilla-extract sprinkles documentation](https://vanilla-extract.style/documentation/packages/sprinkles/) - Learn about the underlying sprinkles framework
 * [Box component documentation](/docs/core-utilities-box--docs) - Detailed information about the Box component
-* [Theme documentation](/docs/theming--docs) - Learn about Baseline UI's theming system`};var c={"8":["CaretDownIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","ChevronRightFilledIcon","ChevronRightIcon","EllipseIcon","MinusIcon","PlusIcon","XIcon"],"12":["CaretDownIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","CheckmarkIcon","DragIndicatorIcon","DragIndicatorVerticalIcon","EditIcon","EllipseIcon","EnterKeyIcon","LockFilledIcon","LockIcon","MinusIcon","MoreVIcon","MoreIcon","PlaceholderIcon","PlusIcon","SearchIcon","SizeIcon","TrashIcon","XIcon","ZoomIcon"],"16":["AlignBottomIcon","AlignMiddleIcon","AlignTopIcon","AnonymousIcon","ArrowDiagonalTopLeftBottomRightIcon","ArrowDownCircleFilledIcon","ArrowDownIcon","ArrowIcon","ArrowLeftRightIcon","ArrowRightIcon","ArrowUpArrowDownIcon","ArrowUpIcon","AtIcon","AttachmentsIcon","AvatarIcon","BoldIcon","BookmarkFilledIcon","BookmarkIcon","BulletListIcon","CalendarIcon","CaretLeftIcon","CaretRightIcon","CheckmarkCircleFilledIcon","CheckmarkCircleIcon","CheckmarkIcon","CircleFilledIcon","ClockIcon","CopyIcon","CustomizeIcon","DocumentEditIcon","DownloadIcon","DuplicateIcon","EditIcon","ElipseAreaIcon","EllipseCloudyIcon","EllipseDashedIcon","EllipseIcon","EmbedIcon","EmojiSmileIcon","ErrorAltCircleFilledIcon","ErrorCircleFilledIcon","ErrorCircleIcon","ExpandIcon","FilterAltIcon","FolderIcon","FormButtonIcon","FormChoiceIcon","FormComboboxIcon","FormDateIcon","FormListboxIcon","FormRadioButtonIcon","FormSignatureIcon","FormTextFieldIcon","FullScreenIcon","HelpCircleIcon","HelpIcon","HereIcon","HideIcon","HighlightTextAltIcon","HighlightTextIcon","HorizontalScrollIcon","ImageIcon","InfoCircleFilledIcon","InsertIcon","ItalicIcon","LightBulbIcon","LineIcon","LinkIcon","ListIcon","LockIcon","MagicIcon","MeasureIcon","MinusIcon","MoreIcon","MoreVerticalIcon","NoteArrowRightIcon","NoteCheckIcon","NoteCircleIcon","NoteCloudIcon","NoteCrossIcon","NoteHelpIcon","NoteInsetIcon","NoteKeyIcon","NoteNewParagraphAltIcon","NoteNewParagraphIcon","NoteNoteIcon","NotePointerRightIcon","NoteSpeechBubbleIcon","NoteStarIcon","NumberedListIcon","OpenIcon","PageFittingFillIcon","PageFittingFitIcon","PageHorizontalScrollIcon","PageLayoutDoubleIcon","PageLayoutSingleIcon","PageVerticalScrollIcon","PauseIcon","PenHighlighterIcon","PenIcon","PerimeterIcon","PlaceholderIcon","PlayIcon","PlusIcon","PolygonAreaIcon","PolygonCloudyIcon","PolygonDashedIcon","PolygonIcon","PolylineIcon","ReadOnlyIcon","RectangleAreaIcon","RectangleCloudyIcon","RectangleDashedIcon","RectangleIcon","RedoIcon","RemoveFormattingIcon","ReorderIcon","RotateClockwiseIcon","RotateCounterClockwiseIcon","RulerIcon","SearchIcon","SettingsIcon","ShowIcon","SlashCommandsIcon","SoundRecordIcon","StampIcon","StarFilledIcon","StarIcon","StrikeoutTextAltIcon","TableCellIcon","TableColumnIcon","TableHeaderIcon","TableIcon","TableRowIcon","TextAlignCenterIcon","TextAlignJustifyIcon","TextAlignLeftIcon","TextAlignRightIcon","TextCalloutIcon","TextDecreaseIndentIcon","TextIcon","TextIncreaseIndentIcon","TextMarkIcon","ThumbnailsIcon","ThumbsDownIcon","ThumbsUpIcon","TrashIcon","TypeTextIcon","UnderlineIcon","UndoIcon","UnlockIcon","VerticalScrollIcon","VideoIcon","WarningFilledIcon","WarningIcon","WindowedIcon","WorkflowIcon","XCircleFilledIcon","XIcon"],"20":["AddPageIcon","AnonymousIcon","ArrowLeftIcon","ArrowRightIcon","ArrowUpCircleFilledIcon","AtIcon","AvatarFilledIcon","BoldIcon","CalloutIcon","CaretDownIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","CheckCircleFilledIcon","CheckmarkCircleIcon","CheckmarkIcon","ClockIcon","CollapseIcon","CommentIcon","CopyIcon","CutIcon","DistanceIcon","DownloadIcon","DuplicateIcon","EditIcon","EllipseIcon","EmojiSmileIcon","ErrorAltCircleFilledIcon","ErrorAlternativeCircleIcon","ErrorCircleFilledIcon","ErrorCircleIcon","ExpandIcon","FormDateIcon","FormSignatureIcon","FormTextFieldIcon","HelpCircleIcon","HighlightTextIcon","HomeIcon","ImageIcon","InfoCircleFilledIcon","InfoCircleIcon","ItalicIcon","LinkIcon","ListIcon","LockIcon","MagicIcon","MinusIcon","MoreIcon","MoreVerticalIcon","MoveIcon","NoteArrowRightIcon","NoteCheckIcon","NoteCircleIcon","NoteCrossIcon","NoteHelpIcon","NoteInsetIcon","NoteKeyIcon","NoteNewParagraphAltIcon","NoteNewParagraphIcon","NoteNoteIcon","NotePointerRightIcon","NoteSpeechBubbleIcon","NoteStarIcon","OpenIcon","PageMoveLeftIcon","PageMoveRightIcon","PagesInsertIcon","PasteIcon","PipetteIcon","PlusIcon","PrintIcon","RotateClockwiseIcon","SearchIcon","SettingsIcon","ShapeIcon","ShareIcon","SoundIcon","SoundRecordIcon","StarFilledIcon","StarIcon","StyleIcon","TextAlignCenterIcon","TextAlignJustifyIcon","TextAlignLeftIcon","TextAlignRightIcon","TextIcon","ThumbnailsIcon","ThumbsDownIcon","ThumbsUpIcon","TrashIcon","TypeTextIcon","UnderlineIcon","UploadIcon","WarningFilledIcon","WarningIcon","XCircleFilledIcon","XCircleIcon","XIcon"],"24":["AddNoteCloudIcon","AddNoteIcon","AddTextSerifIcon","AiIcon","AirplaneIcon","AlignBottomIcon","AlignHorizontalCenterIcon","AlignMiddleIcon","AlignTopIcon","AnonymousIcon","ArrowDownIcon","ArrowIcon","ArrowLeftIcon","ArrowRightIcon","ArrowUpIcon","AtIcon","AttachmentIcon","AvatarFilledIcon","AvatarIcon","BlendModeIcon","BoldIcon","BookmarkFilledIcon","BookmarkIcon","BorderColorIcon","BottomBorderIcon","BulletListIcon","CalibrateIcon","CaptureAddIcon","CaretDownIcon","CaretIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","CheckmarkCircleFilledIcon","CheckmarkCircleIcon","CheckmarkIcon","ChevronListIcon","ClockIcon","CloudyBorderIcon","CollapseIcon","ColorPaletteIcon","ColorSwatchIcon","CommentIcon","CommentInSidebarIcon","CommentOnPageIcon","CompareDocumentsIcon","CopyIcon","CopyPageIcon","CropIcon","CustomizeIcon","CutIcon","DateModifiedIcon","DatePlusIcon","DebugIcon","DocumentArrowDownCircleIcon","DocumentArrowDownIcon","DocumentArrowRightIcon","DocumentFilledIcon","DocumentLockIcon","DocumentPdfIcon","DownloadIcon","DragIndicatorIcon","DragIndicatorVerticalIcon","DuplicateIcon","EditAnnotationsIcon","EditContentIcon","EditDocumentIcon","EditIcon","EditThumbnailsIcon","EllipseAreaIcon","EllipseCloudyIcon","EllipseDashedIcon","EllipseIcon","EmbedIcon","EmojiSmileIcon","EndCapArrowFilledIcon","EndCapArrowIcon","EndCapChevronFilledIcon","EndCapChevronIcon","EndCapCircleIcon","EndCapDiamondIcon","EndCapNoneIcon","EndCapSlantedIcon","EndCapSquareIcon","EndCapStraightIcon","EraserIcon","ErrorAltCircleFilledIcon","ErrorAltIcon","ErrorCircleFilledIcon","ErrorCircleIcon","ExpandIcon","ExpandVerticalIcon","FillColorIcon","FilterIcon","FitToHeightIcon","FivePagesHorizontalFilledIcon","FivePagesVerticalFilledIcon","FolderAddIcon","FolderIcon","FontListIcon","FontSizeIcon","FormButtonIcon","FormChoiceIcon","FormComboboxIcon","FormDateIcon","FormListboxIcon","FormPageIcon","FormRadioButtonIcon","FormSignatureIcon","FormTextFieldIcon","FormTwoRadioButtonsIcon","FourPagesGridFilledIcon","FourPagesHorizontalFilledIcon","FourPagesStackedFilledIcon","FourPagesVerticalFilledIcon","GroupIcon","HamburgerMenuIcon","HandIcon","HeartIcon","HideIcon","HideRevealIcon","HighlightTextIcon","HomeIcon","HorizontalScollIcon","ImageIcon","InfoCircleFilledIcon","InfoCircleIcon","InitialsIcon","InnerHorizontalBorderIcon","InnerVerticalBorderIcon","InsertIcon","ItalicIcon","LayerBottomIcon","LayerDownIcon","LayerTopIcon","LayerUpIcon","LayersIcon","LeftBindingIcon","LeftBorderIcon","LineCapsIcon","LineIcon","LineSpacingIcon","LineStyleCloudyIcon","LineStyleDashedDoubleDashIcon","LineStyleDashedDoubleGapIcon","LineStyleDashedQuadrupleDashIcon","LineStyleDashedSingleGapIcon","LineStyleIcon","LineStyleSolidIcon","LineWidthIcon","LinkIcon","LockFilledIcon","LockIcon","MagicIcon","MagicPenIcon","MailIcon","MarkupIcon","MarqueeZoomIcon","MeasureIcon","MergeIcon","MessageCloudIcon","MinusIcon","MoonIcon","MoreCircleIcon","MoreIcon","MoreVerticalIcon","MoveAllDirectionsIcon","MoveLeftIcon","MoveLeftRightIcon","MoveRightIcon","MultiplePagesIcon","NonEditableIcon","NoteArrowRightIcon","NoteCheckIcon","NoteCircleIcon","NoteCloudIcon","NoteCrossIcon","NoteHelpIcon","NoteIcon","NoteInsetIcon","NoteKeyIcon","NoteNewParagraphAltIcon","NoteNewParagraphIcon","NoteNoteIcon","NotePointerRightIcon","NoteSpeechBubbleIcon","NoteStarIcon","OcrIcon","OpacityIcon","PageAddIcon","PageCurlIcon","PageDuplicateIcon","PageFittingFillIcon","PageFittingFitIcon","PageHorizontalScrollIcon","PageLandscapeIcon","PageLayoutDoubleIcon","PageLayoutSingleIcon","PageMoveLeftIcon","PageMoveRightIcon","PageNumberCircleIcon","PageNumberIcon","PagePortraitIcon","PageRemoveIcon","PageVerticalScrollIcon","PagesInsertAltIcon","PagesInsertIcon","PagesNewFromSelectionAltIcon","PagesNewFromSelectionIcon","PagesSelectAllIcon","PagesSelectNoneIcon","PasteBoardIcon","PastePageIcon","PauseIcon","PenHighlighterIcon","PenIcon","PerimeterIcon","PinDropFilledIcon","PinDropIcon","PipetteIcon","PlayIcon","PlusCircleFilledIcon","PlusCircleIcon","PlusIcon","PointerIcon","PolygonAreaIcon","PolygonCloudyIcon","PolygonDashedIcon","PolygonIcon","PolylineIcon","PrecisionIcon","PrintIcon","PrivateModeIcon","PushPinIcon","QuestionmarkCircleIcon","ReaderViewIcon","RectangleAreaIcon","RectangleCloudyIcon","RectangleDashedIcon","RectangleIcon","RedactIcon","RedactRectangleIcon","RedactTextHighlighterIcon","RedactionTextRepeatingIcon","RedactionTextSingleIcon","RedoAllIcon","RedoIcon","RegexIcon","ReplaceIcon","RightBindingIcon","RightBorderIcon","RotateClockwiseIcon","RotateCounterClockwiseIcon","RotateObjectClockwiseIcon","RotateObjectCounterClockwiseIcon","RulerIcon","ScaleIcon","SearchCircleIcon","SearchIcon","SearchSelectionIcon","SelectAllIcon","SelectionToolIcon","SettingsIcon","ShapesIcon","ShareAltIcon","ShareIcon","ShieldAddIcon","ShieldCheckmarkIcon","ShieldWarningIcon","ShieldXIcon","ShowIcon","SidebarIcon","SignOutIcon","SignatureDigitalIcon","SignatureIcon","SinglePageFilledIcon","SoundIcon","SquigglyTextIcon","StampAddIcon","StampIcon","StarFilledIcon","StarIcon","StartCapArrowFilledIcon","StartCapArrowIcon","StartCapChevronFilledIcon","StartCapChevronIcon","StartCapCircleIcon","StartCapDiamondIcon","StartCapNoneIcon","StartCapSlantedIcon","StartCapSquareIcon","StartCapStraightIcon","StrikeoutTextIcon","StyleFilledIcon","StyleIcon","StylusFilledIcon","StylusIcon","SunIcon","TableCellIcon","TextAlignCenterIcon","TextAlignJustifyIcon","TextAlignLeftIcon","TextAlignRightIcon","TextCalloutIcon","TextColorIcon","TextIcon","TextPropertiesHideIcon","TextPropertiesShowIcon","TextSerifIcon","TextSmallerIcon","ThreePagesHorizontalFilledIcon","ThreePagesStackedFilledIcon","ThreePagesVerticalFilledIcon","ThumbnailsIcon","ThumbsDownIcon","ThumbsUpIcon","TopBorderIcon","TrashIcon","TwoPagesHorizontalFilledIcon","TwoPagesVerticalFilledIcon","TypeTextIcon","UnderlineIcon","UnderlineTextIcon","UndoAllIcon","UndoIcon","UndoRedoIcon","UngroupIcon","UnlockIcon","UploadIcon","UserIcon","VerticalScrollIcon","VideoIcon","WarningFilledIcon","WarningIcon","WidgetIcon","WorkflowIcon","XCircleFilledIcon","XCircleIcon","XIcon","ZoomInIcon","ZoomOutIcon"],"36":["ArrowRight","Check","Circle","Cross","Help","Inset","Key","NewParagraphAlt","NewParagraph","Note","PointerRight","SpeechBubble","Star"]};var p={version:"2.0.0"};var u=`
+* [Theme documentation](/docs/theming--docs) - Learn about Baseline UI's theming system`};var c={"8":["CaretDownIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","ChevronRightFilledIcon","ChevronRightIcon","EllipseIcon","MinusIcon","PlusIcon","XIcon"],"12":["CaretDownIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","CheckmarkIcon","DragIndicatorIcon","DragIndicatorVerticalIcon","EditIcon","EllipseIcon","EnterKeyIcon","LockFilledIcon","LockIcon","MinusIcon","MoreVIcon","MoreIcon","PlaceholderIcon","PlusIcon","SearchIcon","SizeIcon","TrashIcon","XIcon","ZoomIcon"],"16":["AlignBottomIcon","AlignMiddleIcon","AlignTopIcon","AnonymousIcon","ArrowDiagonalTopLeftBottomRightIcon","ArrowDownCircleFilledIcon","ArrowDownIcon","ArrowIcon","ArrowLeftRightIcon","ArrowRightIcon","ArrowUpArrowDownIcon","ArrowUpIcon","AtIcon","AttachmentsIcon","AvatarIcon","BoldIcon","BookmarkFilledIcon","BookmarkIcon","BulletListIcon","CalendarIcon","CaretLeftIcon","CaretRightIcon","CheckmarkCircleFilledIcon","CheckmarkCircleIcon","CheckmarkIcon","CircleFilledIcon","ClockIcon","CopyIcon","CustomizeIcon","DocumentEditIcon","DownloadIcon","DuplicateIcon","EditIcon","ElipseAreaIcon","EllipseCloudyIcon","EllipseDashedIcon","EllipseIcon","EmbedIcon","EmojiSmileIcon","ErrorAltCircleFilledIcon","ErrorCircleFilledIcon","ErrorCircleIcon","ExpandIcon","FilterAltIcon","FolderIcon","FormButtonIcon","FormChoiceIcon","FormComboboxIcon","FormDateIcon","FormListboxIcon","FormRadioButtonIcon","FormSignatureIcon","FormTextFieldIcon","FullScreenIcon","HelpCircleIcon","HelpIcon","HereIcon","HideIcon","HighlightTextAltIcon","HighlightTextIcon","HorizontalScrollIcon","ImageIcon","InfoCircleFilledIcon","InsertIcon","ItalicIcon","LightBulbIcon","LineIcon","LinkIcon","ListIcon","LockIcon","MagicIcon","MeasureIcon","MinusIcon","MoreIcon","MoreVerticalIcon","NoteArrowRightIcon","NoteCheckIcon","NoteCircleIcon","NoteCloudIcon","NoteCrossIcon","NoteHelpIcon","NoteInsetIcon","NoteKeyIcon","NoteNewParagraphAltIcon","NoteNewParagraphIcon","NoteNoteIcon","NotePointerRightIcon","NoteSpeechBubbleIcon","NoteStarIcon","NumberedListIcon","OpenIcon","PageFittingFillIcon","PageFittingFitIcon","PageHorizontalScrollIcon","PageLayoutDoubleIcon","PageLayoutSingleIcon","PageVerticalScrollIcon","PauseIcon","PenHighlighterIcon","PenIcon","PerimeterIcon","PlaceholderIcon","PlayIcon","PlusIcon","PolygonAreaIcon","PolygonCloudyIcon","PolygonDashedIcon","PolygonIcon","PolylineIcon","ReadOnlyIcon","RectangleAreaIcon","RectangleCloudyIcon","RectangleDashedIcon","RectangleIcon","RedoIcon","RemoveFormattingIcon","ReorderIcon","RotateClockwiseIcon","RotateCounterClockwiseIcon","RulerIcon","SearchIcon","SettingsIcon","ShowIcon","SlashCommandsIcon","SoundRecordIcon","StampIcon","StarFilledIcon","StarIcon","StrikeoutTextAltIcon","TableCellIcon","TableColumnIcon","TableHeaderIcon","TableIcon","TableRowIcon","TextAlignCenterIcon","TextAlignJustifyIcon","TextAlignLeftIcon","TextAlignRightIcon","TextCalloutIcon","TextDecreaseIndentIcon","TextIcon","TextIncreaseIndentIcon","TextMarkIcon","ThumbnailsIcon","ThumbsDownIcon","ThumbsUpIcon","TrashIcon","TypeTextIcon","UnderlineIcon","UndoIcon","UnlockIcon","VerticalScrollIcon","VideoIcon","WarningFilledIcon","WarningIcon","WindowedIcon","WorkflowIcon","XCircleFilledIcon","XIcon"],"20":["AddPageIcon","AnonymousIcon","ArrowLeftIcon","ArrowRightIcon","ArrowUpCircleFilledIcon","AtIcon","AvatarFilledIcon","BoldIcon","CalloutIcon","CaretDownIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","CheckCircleFilledIcon","CheckmarkCircleIcon","CheckmarkIcon","ClockIcon","CollapseIcon","CommentIcon","CopyIcon","CutIcon","DistanceIcon","DownloadIcon","DuplicateIcon","EditIcon","EllipseIcon","EmojiSmileIcon","ErrorAltCircleFilledIcon","ErrorAlternativeCircleIcon","ErrorCircleFilledIcon","ErrorCircleIcon","ExpandIcon","FormDateIcon","FormSignatureIcon","FormTextFieldIcon","HelpCircleIcon","HighlightTextIcon","HomeIcon","ImageIcon","InfoCircleFilledIcon","InfoCircleIcon","ItalicIcon","LinkIcon","ListIcon","LockIcon","MagicIcon","MinusIcon","MoreIcon","MoreVerticalIcon","MoveIcon","NoteArrowRightIcon","NoteCheckIcon","NoteCircleIcon","NoteCrossIcon","NoteHelpIcon","NoteInsetIcon","NoteKeyIcon","NoteNewParagraphAltIcon","NoteNewParagraphIcon","NoteNoteIcon","NotePointerRightIcon","NoteSpeechBubbleIcon","NoteStarIcon","OpenIcon","PageMoveLeftIcon","PageMoveRightIcon","PagesInsertIcon","PasteIcon","PipetteIcon","PlusIcon","PrintIcon","RotateClockwiseIcon","SearchIcon","SettingsIcon","ShapeIcon","ShareIcon","SoundIcon","SoundRecordIcon","StarFilledIcon","StarIcon","StyleIcon","TextAlignCenterIcon","TextAlignJustifyIcon","TextAlignLeftIcon","TextAlignRightIcon","TextIcon","ThumbnailsIcon","ThumbsDownIcon","ThumbsUpIcon","TrashIcon","TypeTextIcon","UnderlineIcon","UploadIcon","WarningFilledIcon","WarningIcon","XCircleFilledIcon","XCircleIcon","XIcon"],"24":["AddNoteCloudIcon","AddNoteIcon","AddTextSerifIcon","AiIcon","AirplaneIcon","AlignBottomIcon","AlignHorizontalCenterIcon","AlignMiddleIcon","AlignTopIcon","AnonymousIcon","ArrowDownIcon","ArrowIcon","ArrowLeftIcon","ArrowRightIcon","ArrowUpIcon","AtIcon","AttachmentIcon","AvatarFilledIcon","AvatarIcon","BlendModeIcon","BoldIcon","BookmarkFilledIcon","BookmarkIcon","BorderColorIcon","BottomBorderIcon","BulletListIcon","CalibrateIcon","CaptureAddIcon","CaretDownIcon","CaretIcon","CaretLeftIcon","CaretRightIcon","CaretUpIcon","CheckmarkCircleFilledIcon","CheckmarkCircleIcon","CheckmarkIcon","ChevronListIcon","ClockIcon","CloudyBorderIcon","CollapseIcon","ColorPaletteIcon","ColorSwatchIcon","CommentIcon","CommentInSidebarIcon","CommentOnPageIcon","CompareDocumentsIcon","CopyIcon","CopyPageIcon","CropIcon","CustomizeIcon","CutIcon","DateModifiedIcon","DatePlusIcon","DebugIcon","DocumentArrowDownCircleIcon","DocumentArrowDownIcon","DocumentArrowRightIcon","DocumentFilledIcon","DocumentLockIcon","DocumentPdfIcon","DownloadIcon","DragIndicatorIcon","DragIndicatorVerticalIcon","DuplicateIcon","EditAnnotationsIcon","EditContentIcon","EditDocumentIcon","EditIcon","EditThumbnailsIcon","EllipseAreaIcon","EllipseCloudyIcon","EllipseDashedIcon","EllipseIcon","EmbedIcon","EmojiSmileIcon","EndCapArrowFilledIcon","EndCapArrowIcon","EndCapChevronFilledIcon","EndCapChevronIcon","EndCapCircleIcon","EndCapDiamondIcon","EndCapNoneIcon","EndCapSlantedIcon","EndCapSquareIcon","EndCapStraightIcon","EraserIcon","ErrorAltCircleFilledIcon","ErrorAltIcon","ErrorCircleFilledIcon","ErrorCircleIcon","ExpandIcon","ExpandVerticalIcon","FillColorIcon","FilterIcon","FitToHeightIcon","FivePagesHorizontalFilledIcon","FivePagesVerticalFilledIcon","FolderAddIcon","FolderIcon","FontListIcon","FontSizeIcon","FormButtonIcon","FormChoiceIcon","FormComboboxIcon","FormDateIcon","FormListboxIcon","FormPageIcon","FormRadioButtonIcon","FormSignatureIcon","FormTextFieldIcon","FormTwoRadioButtonsIcon","FourPagesGridFilledIcon","FourPagesHorizontalFilledIcon","FourPagesStackedFilledIcon","FourPagesVerticalFilledIcon","GroupIcon","HamburgerMenuIcon","HandIcon","HeartIcon","HideIcon","HideRevealIcon","HighlightTextIcon","HomeIcon","HorizontalScollIcon","ImageIcon","InfoCircleFilledIcon","InfoCircleIcon","InitialsIcon","InnerHorizontalBorderIcon","InnerVerticalBorderIcon","InsertIcon","ItalicIcon","LayerBottomIcon","LayerDownIcon","LayerTopIcon","LayerUpIcon","LayersIcon","LeftBindingIcon","LeftBorderIcon","LineCapsIcon","LineIcon","LineSpacingIcon","LineStyleCloudyIcon","LineStyleDashedDoubleDashIcon","LineStyleDashedDoubleGapIcon","LineStyleDashedQuadrupleDashIcon","LineStyleDashedSingleGapIcon","LineStyleIcon","LineStyleSolidIcon","LineWidthIcon","LinkIcon","LockFilledIcon","LockIcon","MagicIcon","MagicPenIcon","MailIcon","MarkupIcon","MarqueeZoomIcon","MeasureIcon","MergeIcon","MessageCloudIcon","MinusIcon","MoonIcon","MoreCircleIcon","MoreIcon","MoreVerticalIcon","MoveAllDirectionsIcon","MoveLeftIcon","MoveLeftRightIcon","MoveRightIcon","MultiplePagesIcon","NonEditableIcon","NoteArrowRightIcon","NoteCheckIcon","NoteCircleIcon","NoteCloudIcon","NoteCrossIcon","NoteHelpIcon","NoteIcon","NoteInsetIcon","NoteKeyIcon","NoteNewParagraphAltIcon","NoteNewParagraphIcon","NoteNoteIcon","NotePointerRightIcon","NoteSpeechBubbleIcon","NoteStarIcon","OcrIcon","OpacityIcon","PageAddIcon","PageCurlIcon","PageDuplicateIcon","PageFittingFillIcon","PageFittingFitIcon","PageHorizontalScrollIcon","PageLandscapeIcon","PageLayoutDoubleIcon","PageLayoutSingleIcon","PageMoveLeftIcon","PageMoveRightIcon","PageNumberCircleIcon","PageNumberIcon","PagePortraitIcon","PageRemoveIcon","PageVerticalScrollIcon","PagesInsertAltIcon","PagesInsertIcon","PagesNewFromSelectionAltIcon","PagesNewFromSelectionIcon","PagesSelectAllIcon","PagesSelectNoneIcon","PasteBoardIcon","PastePageIcon","PauseIcon","PenHighlighterIcon","PenIcon","PerimeterIcon","PinDropFilledIcon","PinDropIcon","PipetteIcon","PlayIcon","PlusCircleFilledIcon","PlusCircleIcon","PlusIcon","PointerIcon","PolygonAreaIcon","PolygonCloudyIcon","PolygonDashedIcon","PolygonIcon","PolylineIcon","PrecisionIcon","PrintIcon","PrivateModeIcon","PushPinIcon","QuestionmarkCircleIcon","ReaderViewIcon","RectangleAreaIcon","RectangleCloudyIcon","RectangleDashedIcon","RectangleIcon","RedactIcon","RedactRectangleIcon","RedactTextHighlighterIcon","RedactionTextRepeatingIcon","RedactionTextSingleIcon","RedoAllIcon","RedoIcon","RegexIcon","ReplaceIcon","RightBindingIcon","RightBorderIcon","RotateClockwiseIcon","RotateCounterClockwiseIcon","RotateObjectClockwiseIcon","RotateObjectCounterClockwiseIcon","RulerIcon","ScaleIcon","SearchCircleIcon","SearchIcon","SearchSelectionIcon","SelectAllIcon","SelectionToolIcon","SettingsIcon","ShapesIcon","ShareAltIcon","ShareIcon","ShieldAddIcon","ShieldCheckmarkIcon","ShieldWarningIcon","ShieldXIcon","ShowIcon","SidebarIcon","SignOutIcon","SignatureDigitalIcon","SignatureIcon","SinglePageFilledIcon","SoundIcon","SquigglyTextIcon","StampAddIcon","StampIcon","StarFilledIcon","StarIcon","StartCapArrowFilledIcon","StartCapArrowIcon","StartCapChevronFilledIcon","StartCapChevronIcon","StartCapCircleIcon","StartCapDiamondIcon","StartCapNoneIcon","StartCapSlantedIcon","StartCapSquareIcon","StartCapStraightIcon","StrikeoutTextIcon","StyleFilledIcon","StyleIcon","StylusFilledIcon","StylusIcon","SunIcon","TableCellIcon","TextAlignCenterIcon","TextAlignJustifyIcon","TextAlignLeftIcon","TextAlignRightIcon","TextCalloutIcon","TextColorIcon","TextIcon","TextPropertiesHideIcon","TextPropertiesShowIcon","TextSerifIcon","TextSmallerIcon","ThreePagesHorizontalFilledIcon","ThreePagesStackedFilledIcon","ThreePagesVerticalFilledIcon","ThumbnailsIcon","ThumbsDownIcon","ThumbsUpIcon","TopBorderIcon","TrashIcon","TwoPagesHorizontalFilledIcon","TwoPagesVerticalFilledIcon","TypeTextIcon","UnderlineIcon","UnderlineTextIcon","UndoAllIcon","UndoIcon","UndoRedoIcon","UngroupIcon","UnlockIcon","UploadIcon","UserIcon","VerticalScrollIcon","VideoIcon","WarningFilledIcon","WarningIcon","WidgetIcon","WorkflowIcon","XCircleFilledIcon","XCircleIcon","XIcon","ZoomInIcon","ZoomOutIcon"],"36":["ArrowRight","Check","Circle","Cross","Help","Inset","Key","NewParagraphAlt","NewParagraph","Note","PointerRight","SpeechBubble","Star"]};var p={version:"2.2.0"};var u=`
 # Baseline UI MCP Server Guidelines
 
 This MCP server provides AI assistants with structured access to Baseline UI's comprehensive component documentation, icon library, theming resources, and design guidelines.
@@ -35750,13 +36776,14 @@ Use this tool to:
 - Consult **list_components** to find the right component for your needs
 - Reference **theming** for custom design systems
 - Check **styling** for CSS and design token guidance
-`;var S=`# List of available components in Baseline UI design system
+`;var C=`# List of available components in Baseline UI design system
 | Name | Description | Similar To |
 | --- | --- | --- |
-${Object.entries(o).toSorted(([n],[t])=>n.localeCompare(t)).map(([n,{description:t,similarTo:e}])=>`|${n}|${t}|${e?.join(", ")||""}|`).join(`
+${Object.entries(t).toSorted(([n],[e])=>n.localeCompare(e)).map(([n,{description:e,similarTo:i}])=>`|${n}|${e}|${i?.join(", ")||""}|`).join(`
 `)}
-`,P=Object.entries(c).map(([n,t])=>`${n}
+`,T=Object.entries(c).map(([n,e])=>`${n}
 
-      ${t.map(e=>"- "+e).join(`
+      ${e.map(i=>"- "+i).join(`
 `)}`).join(`
-`);async function k(){let n=new mcp_js.McpServer({name:"baseline-ui",version:p.version});n.registerResource("list_components","resource://baseline-ui/list_components.md",{description:a,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:S}]})),n.registerResource("list_icons","resource://baseline-ui/list_icons.md",{description:r,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:P}]})),n.registerResource("getting_started","resource://baseline-ui/getting_started.md",{description:"Quick start guide for integrating Baseline UI into new projects",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:i.gettingStarted}]})),n.registerResource("nutrient_web_viewer_theming","resource://baseline-ui/nutrient_web_viewer_theming.md",{description:"Specialized theming guide for customizing Baseline UI in Nutrient Web Viewer. This is not applicable if you are not theming the Nutrient Web Viewer SDK.",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:i.nutrientWebViewerTheming}]})),n.registerResource("theming","resource://baseline-ui/theming.md",{description:"Comprehensive guide for implementing custom themes and color schemes in Baseline UI",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:i.theming}]})),n.registerResource("internationalization","resource://baseline-ui/internationalization.md",{description:"Guide for implementing multi-language support and localization in Baseline UI",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:i.internationalization}]})),n.registerResource("styling","resource://baseline-ui/styling.md",{description:l,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:i.styling}]})),n.registerResource("guidelines","resource://baseline-ui/guidelines.md",{description:s,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:u}]})),n.registerTool("get_component_info",{title:"Get component info",description:m,inputSchema:{componentName:zod.z.enum(Object.keys(o))}},({componentName:e})=>({content:[{type:"text",text:JSON.stringify(Object.fromEntries(Object.entries(o[e]).filter(([f])=>!["description","similarTo","figmaUrl"].includes(f))),null,2)}]})),n.registerTool("get_story_url",{title:"Get story demo URL",description:h,inputSchema:{storyId:zod.z.string()}},({storyId:e})=>({content:[{type:"text",text:`https://nutrient.io/baseline-ui/iframe.html?id=${e}`}]})),n.registerTool("get_figma_url",{title:"Get Figma URL",description:b,inputSchema:{componentName:zod.z.enum(Object.keys(o))}},({componentName:e})=>({content:[{type:"text",text:o[e].figmaUrl}]})),n.registerTool("list_available_resources",{title:"List Available Resources",description:g,inputSchema:{}},()=>({content:[{type:"text",text:JSON.stringify([{name:"list_components",uri:"resource://baseline-ui/list_components.md",description:a,mimeType:"text/markdown"},{name:"list_icons",uri:"resource://baseline-ui/list_icons.md",description:r,mimeType:"text/markdown"},{name:"getting_started",uri:"resource://baseline-ui/getting_started.md",description:"Quick start guide for integrating Baseline UI into new projects",mimeType:"text/markdown"},{name:"nutrient_web_viewer_theming",uri:"resource://baseline-ui/nutrient_web_viewer_theming.md",description:"Specialized theming guide for customizing Baseline UI in Nutrient Web Viewer. This is not applicable if you are not theming the Nutrient Web Viewer SDK.",mimeType:"text/markdown"},{name:"theming",uri:"resource://baseline-ui/theming.md",description:"Comprehensive guide for implementing custom themes and color schemes in Baseline UI",mimeType:"text/markdown"},{name:"internationalization",uri:"resource://baseline-ui/internationalization.md",description:"Guide for implementing multi-language support and localization in Baseline UI",mimeType:"text/markdown"},{name:"styling",uri:"resource://baseline-ui/styling.md",description:l,mimeType:"text/markdown"},{name:"guidelines",uri:"resource://baseline-ui/guidelines.md",description:s,mimeType:"text/markdown"}],null,2)}]}));let t=new stdio_js.StdioServerTransport;await n.connect(t);}(async()=>await k())();
+`);function z(){let n=new mcp_js.McpServer({name:"baseline-ui",version:p.version});return n.registerResource("list_components","resource://baseline-ui/list_components.md",{description:a,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:C}]})),n.registerResource("list_icons","resource://baseline-ui/list_icons.md",{description:r,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:T}]})),n.registerResource("getting_started","resource://baseline-ui/getting_started.md",{description:"Quick start guide for integrating Baseline UI into new projects",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:o.gettingStarted}]})),n.registerResource("nutrient_web_viewer_theming","resource://baseline-ui/nutrient_web_viewer_theming.md",{description:"Specialized theming guide for customizing Baseline UI in Nutrient Web Viewer. This is not applicable if you are not theming the Nutrient Web Viewer SDK.",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:o.nutrientWebViewerTheming}]})),n.registerResource("theming","resource://baseline-ui/theming.md",{description:"Comprehensive guide for implementing custom themes and color schemes in Baseline UI",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:o.theming}]})),n.registerResource("internationalization","resource://baseline-ui/internationalization.md",{description:"Guide for implementing multi-language support and localization in Baseline UI",mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:o.internationalization}]})),n.registerResource("styling","resource://baseline-ui/styling.md",{description:l,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:o.styling}]})),n.registerResource("guidelines","resource://baseline-ui/guidelines.md",{description:s,mimeType:"text/markdown"},e=>({contents:[{uri:e.href,mimeType:"text/markdown",text:u}]})),n.registerTool("get_component_info",{title:"Get component info",description:m,inputSchema:{componentName:zod.z.enum(Object.keys(t))}},({componentName:e})=>({content:[{type:"text",text:JSON.stringify(Object.fromEntries(Object.entries(t[e]).filter(([i])=>!["description","similarTo","figmaUrl"].includes(i))),null,2)}]})),n.registerTool("get_story_url",{title:"Get story demo URL",description:h,inputSchema:{storyId:zod.z.string()}},({storyId:e})=>({content:[{type:"text",text:`https://nutrient.io/baseline-ui/iframe.html?id=${e}`}]})),n.registerTool("get_figma_url",{title:"Get Figma URL",description:b,inputSchema:{componentName:zod.z.enum(Object.keys(t))}},({componentName:e})=>({content:[{type:"text",text:t[e].figmaUrl}]})),n.registerTool("list_available_resources",{title:"List Available Resources",description:g,inputSchema:{}},()=>({content:[{type:"text",text:JSON.stringify([{name:"list_components",uri:"resource://baseline-ui/list_components.md",description:a,mimeType:"text/markdown"},{name:"list_icons",uri:"resource://baseline-ui/list_icons.md",description:r,mimeType:"text/markdown"},{name:"getting_started",uri:"resource://baseline-ui/getting_started.md",description:"Quick start guide for integrating Baseline UI into new projects",mimeType:"text/markdown"},{name:"nutrient_web_viewer_theming",uri:"resource://baseline-ui/nutrient_web_viewer_theming.md",description:"Specialized theming guide for customizing Baseline UI in Nutrient Web Viewer. This is not applicable if you are not theming the Nutrient Web Viewer SDK.",mimeType:"text/markdown"},{name:"theming",uri:"resource://baseline-ui/theming.md",description:"Comprehensive guide for implementing custom themes and color schemes in Baseline UI",mimeType:"text/markdown"},{name:"internationalization",uri:"resource://baseline-ui/internationalization.md",description:"Guide for implementing multi-language support and localization in Baseline UI",mimeType:"text/markdown"},{name:"styling",uri:"resource://baseline-ui/styling.md",description:l,mimeType:"text/markdown"},{name:"guidelines",uri:"resource://baseline-ui/guidelines.md",description:s,mimeType:"text/markdown"}],null,2)}]})),n}
+exports.createServer=z;