---

## BarChart
Categorical bar chart — single, grouped, or stacked. Zero-
dependency SVG rendering on the design-token chart palette, responsive via
ResizeObserver, dark-mode aware, with a screen-reader data-table fallback.

**Import:** `import { BarChart } from '@urbicon-ui/blocks';`

### Examples
```svelte
<BarChart
  data={[
    { label: 'Q1', values: [12, 8] },
    { label: 'Q2', values: [19, 11] }
  ]}
  series={[{ label: 'Revenue' }, { label: 'Cost' }]}
  formatValue={(v) => `${v}k`}
/>
```

### Api
| Prop | Type | Required | Default | Description |
| --- | --- | :---: | --- | --- |
| data | `BarChartDatum[]` | yes |  | Categories with per-series values. |
| ...HTMLAttributes<HTMLElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
| ariaLabel | `string` | no |  | Accessible label; a summary is generated when omitted. |
| class | `string` | no |  | Extra classes merged onto the wrapper. |
| formatValue | `(value: number) => string` | no |  | Format values for axis labels, tooltips, and the data table. |
| height | `number` | no | 240 | Height property for the BarChart component |
| locale | `string` | no |  | BCP-47 locale for the default number formatter (when no `formatValue`). |
| margin | `ChartMargin` | no |  | Plot margins; merged over the defaults. |
| preset | `string` | no |  | Apply a named preset registered on `<BlocksProvider>`. |
| series | `ChartSeries[]` | no |  | Series metadata (labels + colors). Defaults to one generic series per value column found in `data`. |
| showGrid | `boolean` | no | true | Render horizontal gridlines. |
| showLegend | `boolean` | no | true | Show the series legend (only renders with >1 series). |
| slotClasses | `ChartSlotClasses` | no |  | Per-slot class overrides. |
| stacked | `boolean` | no | false | Stack series instead of grouping them side by side. |
| unstyled | `boolean` | no |  | Remove all default tv classes. |
| width | `number` | no |  | Fixed width in px; omit for responsive width. |

Inherited from:
- Omit<HTMLAttributes<HTMLElement>, 'children'> (omit-pattern)