# XWUIHrEventsCalendar

Compact HR events widget (extends `XWUIComponent`, not a shell page) that renders a card listing upcoming calendar events. It takes a `data.events` array of `CalendarEvent` items - each with `id`, `date`, `title`, and a `category` of `leave`/`holiday`/`birthday`/`anniversary`/`announcement`/`other` - and projects them into a `xwui-hr-card` with a localized "Events"/"التقويم" heading and one list row per event formatted as `date - title`, showing "No events" when the array is empty. Config accepts `locale` (`'en'`/`'ar'`) and `className`.

## Basic Usage

Renders the events card from an inline `events` array (a holiday and a meeting), producing one `date - title` row per entry under the "Events" heading.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Constructs XWUIHrEventsCalendar with two inline CalendarEvent items (Labour Day holiday, Team standup meeting) and lists them as date - title rows.
```

## Mixed event categories

Feeds five `events` covering `holiday`, `anniversary`, `birthday`, `announcement`, and `leave` so the card shows a full month of activity.

```example
file: examples/MixedCategories.ts
html: examples/MixedCategories.html
title: Mixed event categories
description: Five CalendarEvent items spanning every category, each rendered as a date - title row.
```

## Arabic locale (RTL)

Passes `{ locale: 'ar' }`, switching the card heading to `التقويم` above Arabic event rows.

```example
file: examples/ArabicLocale.ts
html: examples/ArabicLocale.html
title: Arabic locale (RTL)
description: Arabic events with locale 'ar', so the heading renders as التقويم.
```

```api
```