# XWUIHrPayrollAnalyticsPage

Insights shell page (extends `HrInsightsPageBase`) that surfaces headline workforce KPIs above the payroll analytics view. Its `buildKpiStrip` turns the fetched `InsightsKpis` into four colored stat tiles: Employees (`totalEmployees`, info), Active Today (`activeToday`, success), Open Roles (`openRoles`, warning), and Avg Tenure (`avgTenureYears` shown as "N y", neutral). Configure through `conf_comp` (`hrApiOptions`, `locale`, plus the shared shell options `maxWidth`, `padding`, `hideHeader`, `hideBreadcrumbs`, aside controls, `className`); pass `title`/`description`/`titleAr` via `data`. Use it as the Payroll Analytics dashboard. Default title is "Payroll Analytics".

## Basic Usage

Builds the Payroll Analytics page in `#app` with an English title and a sandbox HR API, rendering the KPI strip from the mock backend's insights data.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Renders the Payroll Analytics insights page bound to a sandbox IHrApi, showing Employees, Active Today, Open Roles, and Avg Tenure KPI tiles.
```

## Month-End Payroll Snapshot

A frozen closing-period view that renders pre-computed figures from `data.kpis` with no API round-trip.

```example
file: examples/MonthEndPayrollSnapshot.ts
html: examples/MonthEndPayrollSnapshot.html
title: Month-End Payroll Snapshot
description: Renders the Payroll Analytics page from a supplied InsightsKpis snapshot (1284 employees, 2 open payroll runs) instead of fetching, for the month-end sign-off pack.
```

## Multi-Entity Payroll Board

A group-level board pointed at the staging service, with drill-down breadcrumbs for a consolidated finance review.

```example
file: examples/MultiEntityPayrollBoard.ts
html: examples/MultiEntityPayrollBoard.html
title: Multi-Entity Payroll Board
description: Renders the consolidated Group Payroll KPI board from the staging IHrApi with Finance → Payroll → Consolidated breadcrumbs and a 1320px column.
```

```api
```