# XWUIHrDocumentRepository

Standalone HR document-repository widget that extends `XWUIComponent` (not a shell page) and mounts a `xwui-hr--document-repository` root element. It is currently a scaffold: `mountContent` renders a single localized placeholder label ("HR data" / "بيانات HR" when `locale: 'ar'`). The headless contract is open - `XWUIHrDocumentRepositoryData` is an extensible `{ [key: string]: unknown }` bag and `XWUIHrDocumentRepositoryConfig` accepts `className` and `locale` ('en' | 'ar'). Use it as the embeddable mount point for an employee/company document library; pass your own `data` and style hook via `className`.

## Basic Usage

Mounts the document repository into the page with `locale: 'en'`, producing the `xwui-hr--document-repository` container with its placeholder content.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Instantiates XWUIHrDocumentRepository with empty data and { locale: 'en' }, rendering the repository's root container and placeholder label.
```

## Arabic locale (RTL)

Constructs the widget with `{ locale: 'ar' }`, so the root renders its Arabic placeholder text (`بيانات HR`).

```example
file: examples/ArabicLocale.ts
html: examples/ArabicLocale.html
title: Arabic locale (RTL)
description: `{ locale: 'ar' }` switches the placeholder copy to Arabic for right-to-left hosts.
```

## Custom class hook

Passes `{ className: 'docs--grid' }`, appended to the `xwui-hr--document-repository` root class so host CSS can target this instance.

```example
file: examples/CustomClass.ts
html: examples/CustomClass.html
title: Custom class hook
description: A `className` is merged onto the widget root for host-level styling.
```

```api
```