@xplortech/apollo-core 3.2.1 → 3.3.0

package/dist/docs/xpl-avatar/readme.md

@@ -291,6 +291,13 @@ This component now depends on `xpl-badge`. Ensure `xpl-badge` is loaded in your
 | `variant`   | `variant`    | Optional layout: `profile` (large profile sizes), `group` (stacked faces + `groupData`; `status` not shown), `with-text` (avatar with `name` / `subText` beside it). Omit for the default single avatar.                                                                                                                                                              | `"group" \| "profile" \| "with-text"`                                                                             | `undefined` |
 
 
+## Slots
+
+| Slot | Description                                                                        |
+| ---- | ---------------------------------------------------------------------------------- |
+|      | Custom placeholder content (e.g. initials) shown when no `src` image is available. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-badge/readme.md

@@ -141,6 +141,13 @@ Tokens used by this component from `@xplortech/apollo-foundation`.
 | `variant`  | `variant`  | Badge variant (color).  Preferred values: `purple`, `green`, `yellow`, `orange`, `gray`, `red`, `blue`.  The legacy semantic names `success`, `warning`, `inactive`, and `error` are still accepted and map to `green`, `yellow`, `gray`, and `red` respectively. Prefer the color names for new code. | `"blue" \| "error" \| "gray" \| "green" \| "inactive" \| "orange" \| "purple" \| "red" \| "success" \| "warning" \| "yellow"` | `'purple'`  |
 
 
+## Slots
+
+| Slot | Description              |
+| ---- | ------------------------ |
+|      | The badge label content. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-breadcrumbs/xpl-breadcrumb-item/readme.md

@@ -11,6 +11,7 @@ This component yields an unnamed slot. Only links and buttons (styled as links)
 
 | Slot        | Description                                                             |
 | ----------- | ----------------------------------------------------------------------- |
+|             | The default slot                                                        |
 | `"unnamed"` | content rendered inside <li>, should be link or button (styled as link) |
 
 

package/dist/docs/xpl-breadcrumbs/xpl-breadcrumbs/readme.md

@@ -23,6 +23,7 @@ Tokens used by this component from `@xplortech/apollo-foundation` (light/dark ha
 
 | Slot        | Description                                                               |
 | ----------- | ------------------------------------------------------------------------- |
+|             | The default slot                                                          |
 | `"unnamed"` | content rendered <ol>, should be a group of <li> or <xpl-breadcrumb-item> |
 
 

package/dist/docs/xpl-button/readme.md

@@ -154,6 +154,13 @@ The **`state`** prop (`neutral` | `warning` | `success`) is deprecated. Use **`s
 | `variant`      | `variant`       | Button variant/style. Use "primary", "secondary", "tertiary" for new usage. "subtle" is deprecated but still supported for backward compatibility.                                                                                     | `"primary" \| "secondary" \| "subtle" \| "tertiary"`                                                                      | `'primary'` |
 
 
+## Slots
+
+| Slot | Description               |
+| ---- | ------------------------- |
+|      | The button label content. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-checkbox/readme.md

@@ -62,6 +62,13 @@ The checkbox label and description are styled by the shared `.xpl-label` / `.xpl
 | `checkboxChange` | Emits the new checked state of the checkbox after a user interaction.  Always emits a boolean so the event payload reliably represents whether the checkbox is now on or off. This is what Vue `v-model` binds to via the `checked` attribute — emitting the `value` string here would coerce any non-empty string to `true` and make it impossible to uncheck a checkbox that has a `value` prop set. Consumers that need the `value` can read it from the host element (`event.target.value`) or rely on native form submission (`name`/`value` pair). | `CustomEvent<boolean>` |
 
 
+## Slots
+
+| Slot | Description                 |
+| ---- | --------------------------- |
+|      | The checkbox label content. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-content-area/readme.md

@@ -20,6 +20,13 @@ Tokens used by this component from `@xplortech/apollo-foundation`.
 | `size`   | `size`    |             | `"full" \| "narrow" \| "wide"` | `'wide'` |
 
 
+## Slots
+
+| Slot | Description       |
+| ---- | ----------------- |
+|      | The page content. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-dashboard/readme.md

@@ -5,6 +5,13 @@ The XPL-Dashboard component is a code-only utility component for responsive layo
 <!-- Auto Generated Below -->
 
 
+## Slots
+
+| Slot | Description            |
+| ---- | ---------------------- |
+|      | The dashboard content. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-data-card/readme.md

@@ -27,6 +27,7 @@ The card is styled entirely with Apollo Foundation purpose-specific tokens (dark
 | Anchor hover shadow | `box-shadow` | `--xpl-elevation-2` (theme-aware) |
 | Header / stat spacing | `margin` | `--xpl-space-4`, `--xpl-space-6` |
 | Container-query stat | `font-size` | `--xpl-font-size-title-2` |
+| Container-query stat | `line-height` | `--xpl-line-height-title-2` |
 
 The resting anchor overlay keeps a `0.375rem` (6px) radius to match the card's `rounded-md`; Foundation has no 6px radius token (see `TECH_DEBT.md`).
 

package/dist/docs/xpl-divider/readme.md

@@ -30,6 +30,13 @@ Tokens used by this component from `@xplortech/apollo-foundation`.
 | `tier`   | `tier`    | The tier should be an integer between 0 and 3. Tier 0 dividers do not display text, and 1-3 increase in size with each increasing tier. | `number` | `undefined` |
 
 
+## Slots
+
+| Slot | Description                                                                   |
+| ---- | ----------------------------------------------------------------------------- |
+|      | Optional text content rendered inside the divider (not displayed for tier 0). |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-dropdown/readme.md

@@ -78,6 +78,14 @@ Type: `Promise<void>`
 
 
 
+## Slots
+
+| Slot        | Description                                                                                      |
+| ----------- | ------------------------------------------------------------------------------------------------ |
+| `"header"`  | Optional header content rendered above the options list.                                         |
+| `"options"` | The `xpl-dropdown-option` / `xpl-dropdown-group` items. Used when the `options` prop is not set. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-dropdown/xpl-dropdown-group/readme.md

@@ -13,6 +13,13 @@
 | `options`   | --        | options that are listed    | `Partial<DropdownOption & DropdownOptionGroup>[]` | `undefined` |
 
 
+## Slots
+
+| Slot        | Description                                                                             |
+| ----------- | --------------------------------------------------------------------------------------- |
+| `"options"` | The `xpl-dropdown-option` items in this group. Used when the `options` prop is not set. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-dropdown/xpl-dropdown-heading/readme.md

@@ -12,6 +12,13 @@
 | `label`  | `label`   | text to display as heading | `string` | `undefined` |
 
 
+## Slots
+
+| Slot        | Description                                                    |
+| ----------- | -------------------------------------------------------------- |
+| `"heading"` | Custom heading content. Used when the `label` prop is not set. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-dropdown/xpl-dropdown-option/readme.md

@@ -17,6 +17,13 @@
 | `value`      | `value`    | The selected options value to be submitted with the form, should this option be selected. | `string`  | `undefined` |
 
 
+## Slots
+
+| Slot       | Description                                                   |
+| ---------- | ------------------------------------------------------------- |
+| `"option"` | Custom option content. Used when the `label` prop is not set. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-dynamic-table/readme.md

@@ -52,6 +52,14 @@ The table, cells, and rows use Apollo Foundation purpose-specific tokens (light
 | `selectedItemCountChange` | Emitted when the number of selected items changes. | `CustomEvent<string[]>` |
 
 
+## Slots
+
+| Slot       | Description                     |
+| ---------- | ------------------------------- |
+| `"body"`   | The body region of the table.   |
+| `"header"` | The header region of the table. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-dynamic-table-cell/readme.md

@@ -15,6 +15,13 @@
 | `disabled` | `disabled` | Whether the cell and its contents are disabled. | `boolean` | `false` |
 
 
+## Slots
+
+| Slot | Description       |
+| ---- | ----------------- |
+|      | The cell content. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-dynamic-table-row/readme.md

@@ -16,6 +16,13 @@
 | `selected` | `selected` | Whether the row is selected.                | `boolean` | `false` |
 
 
+## Slots
+
+| Slot | Description                                        |
+| ---- | -------------------------------------------------- |
+|      | The row cells (`xpl-dynamic-table-cell` elements). |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-grid-item/readme.md

@@ -15,6 +15,13 @@
 | `xs`     | `xs`      | The number of columns the element should span  out of a 6 column grid on a  xs size screen | `number` | `6`     |
 
 
+## Slots
+
+| Slot | Description                            |
+| ---- | -------------------------------------- |
+|      | Content rendered inside the grid item. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-header-accordion/readme.md

@@ -37,6 +37,14 @@ The header uses Apollo Foundation purpose-specific tokens (light / dark resolve
 | `selectedCount`   | `selected-count`   | The number of selected child items, or -1 to auto-calculate.  | `number`  | `-1`        |
 
 
+## Slots
+
+| Slot        | Description                                                    |
+| ----------- | -------------------------------------------------------------- |
+| `"content"` | Content rendered inside the collapsible body of the accordion. |
+| `"title"`   | The header content of the accordion toggle.                    |
+
+
 ## Dependencies
 
 ### Depends on

package/dist/docs/xpl-icon/readme.md

@@ -2,7 +2,7 @@
 
 ## Available Icons
 
-For a complete list of available icon names, see [ICONS.md](./ICONS.md) (164 icons).
+For a complete list of available icon names, see [ICONS.md](./ICONS.md) (554 icons).
 
 You can also browse icons visually in [Storybook](?path=/story/components-icons--icons) with search functionality.
 

package/dist/docs/xpl-input/readme.md

@@ -128,6 +128,14 @@ Type: `Promise<void>`
 
 
 
+## Slots
+
+| Slot        | Description                                                                          |
+| ----------- | ------------------------------------------------------------------------------------ |
+| `"pre"`     | Leading add-on content rendered before the input. Falls back to the `pre` prop text. |
+| `"trigger"` | Custom trigger element for the file picker. Only used with `type="file"`.            |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-list/readme.md

@@ -318,6 +318,13 @@ Type: `Promise<void>`
 
 
 
+## Slots
+
+| Slot | Description                                |
+| ---- | ------------------------------------------ |
+|      | The list items (`xpl-list-item` elements). |
+
+
 ## Dependencies
 
 ### Depends on

package/dist/docs/xpl-list/xpl-list-item/readme.md

@@ -64,6 +64,22 @@ Single row for [`xpl-list`](../xpl-list/readme.md). **Slot-based** rows expose `
 | `itemSelect`    | Emitted when the item is selected (radio change).                       | `CustomEvent<{ itemId?: string; }>`                    |
 
 
+## Slots
+
+| Slot                | Description                                                          |
+| ------------------- | -------------------------------------------------------------------- |
+| `"actions"`         | Right-side action controls.                                          |
+| `"avatar"`          | Leading avatar/media cell.                                           |
+| `"badges"`          | Right-side badges group.                                             |
+| `"details"`         | Right-side details content.                                          |
+| `"error-text"`      | Error message shown below the row; puts the item in the error state. |
+| `"metadata"`        | Secondary metadata row rendered below the title.                     |
+| `"stacked-extra-1"` | First additional stacked row, rendered below `metadata`.             |
+| `"stacked-extra-2"` | Second additional stacked row, rendered below `stacked-extra-1`.     |
+| `"stacked-extra-3"` | Third additional stacked row, rendered below `stacked-extra-2`.      |
+| `"title"`           | The primary title text.                                              |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-main-nav/readme.md

@@ -18,6 +18,8 @@ The bottom area is fixed to the bottom and should be used for actions. To render
 
 **Typography**
 - `--xpl-font-size-body` — collapsed (`sm`/`md`) nav item label size
+- `--xpl-line-height-body` — collapsed (`sm`/`md`) nav item label line height
+- `--xpl-line-height-title-4` — brand lockup text line height (title-4)
 
 **Layout**
 - Collapse-state widths (240 / 112 / 74px) and the 42px brand logo box are raw literals — no matching Foundation size token (see `TECH_DEBT.md`)
@@ -39,6 +41,16 @@ The bottom area is fixed to the bottom and should be used for actions. To render
 | `navWidth` |             | `CustomEvent<string>` |
 
 
+## Slots
+
+| Slot           | Description                                                            |
+| -------------- | ---------------------------------------------------------------------- |
+| `"brand-name"` | Brand or product name rendered next to the logo in the sidebar header. |
+| `"footer"`     | Footer content pinned to the bottom of the sidebar.                    |
+| `"logo"`       | Brand logo rendered in the sidebar header.                             |
+| `"navigation"` | Primary navigation items.                                              |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-nav-item/readme.md

@@ -33,6 +33,15 @@ This component should be used within sections of the `<xpl-main-nav>`. This comp
 | `navOpen` |             | `CustomEvent<boolean>` |
 
 
+## Slots
+
+| Slot     | Description                                                        |
+| -------- | ------------------------------------------------------------------ |
+|          | The item label content.                                            |
+| `"icon"` | Leading icon content rendered before the label.                    |
+| `"link"` | Optional wrapper around the item content (e.g. an anchor element). |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-popover/readme.md

@@ -49,6 +49,7 @@ Tokens used by this component from `@xplortech/apollo-foundation`.
 
 | Slot              | Description                                           |
 | ----------------- | ----------------------------------------------------- |
+|                   | The default slot                                      |
 | `"Inner Content"` | Content inside the popover                            |
 | `"trigger"`       | The element that, when clicked, will open the popover |
 

package/dist/docs/xpl-radio/readme.md

@@ -55,6 +55,13 @@ The radio label and description are styled by the shared `.xpl-label` / `.xpl-de
 | `radioChange` | Event that emits the current value of the radio input  Returns the value of the radio input if a value is provided, otherwise returns the checked state | `CustomEvent<boolean \| string>` |
 
 
+## Slots
+
+| Slot | Description              |
+| ---- | ------------------------ |
+|      | The radio label content. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-secondary-nav/readme.md

@@ -30,6 +30,13 @@ The horizontal-scroll fade (`nav::after`, mobile only) fills a strip with `--xpl
 <!-- Auto Generated Below -->
 
 
+## Slots
+
+| Slot | Description           |
+| ---- | --------------------- |
+|      | The navigation items. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-select/readme.md

@@ -69,6 +69,13 @@ Type: `Promise<void>`
 
 
 
+## Slots
+
+| Slot                     | Description                                                                                                     |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------- |
+| `"custom-display-value"` | Custom content rendered as the selected-value display. Only rendered when the `customDisplayValue` prop is set. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-side-nav/xpl-side-nav-item/readme.md

@@ -240,6 +240,15 @@ anchor container (`link` mode). Three slot positions are available:
 | `navigate`       | Emitted when a leaf item is activated (pointer click or keyboard activation of the native `<button>`). Expandable parents use `expandedChange` instead. | `CustomEvent<void>`    |
 
 
+## Slots
+
+| Slot         | Description                                                                                                                                                         |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|              | Nested `xpl-side-nav-item` children (expandable parents only).                                                                                                      |
+| `"leading"`  | Leading icon column. The `icon` prop renders an `xpl-icon` here when no slotted `leading` content is present.                                                       |
+| `"trailing"` | Trailing content (e.g. `xpl-icon icon="external-link"`). On parent rows (`has-children`), an auto chevron renders here when no `trailing` slot content is provided. |
+
+
 ## Dependencies
 
 ### Depends on

package/dist/docs/xpl-side-nav/xpl-side-nav-section/readme.md

@@ -108,6 +108,14 @@ row. The wrapper is suppressed when the slot is empty.
 | `expandedChange` | Emitted when the expanded state changes (collapsible sections only). Detail is the new expanded value. | `CustomEvent<boolean>` |
 
 
+## Slots
+
+| Slot      | Description                                                                                                           |
+| --------- | --------------------------------------------------------------------------------------------------------------------- |
+|           | Section children (nested `xpl-side-nav-item` elements, optionally separated by dividers).                             |
+| `"badge"` | Optional badge (e.g. `xpl-badge`) rendered in the header title row. The wrapper is suppressed when the slot is empty. |
+
+
 ## Dependencies
 
 ### Depends on

package/dist/docs/xpl-slideout/readme.md

@@ -45,6 +45,19 @@ The `.content.has-shadow` shadow is a scroll affordance applied only to the top
 | `isOpenChange` | Emitted when the isOpen property changes. | `CustomEvent<boolean>` |
 
 
+## Slots
+
+| Slot          | Description                                                          |
+| ------------- | -------------------------------------------------------------------- |
+| `"content"`   | The main scrollable body content.                                    |
+| `"primary"`   | The primary footer action. Rendered only when `showFooter` is set.   |
+| `"search"`    | Search content rendered in the header.                               |
+| `"secondary"` | The secondary footer action. Rendered only when `showFooter` is set. |
+| `"subtitle"`  | Subtitle content rendered below the title.                           |
+| `"tertiary"`  | The tertiary footer action. Rendered only when `showFooter` is set.  |
+| `"title"`     | The slideout header title.                                           |
+
+
 ## Dependencies
 
 ### Depends on

package/dist/docs/xpl-spotlight/readme.md

@@ -138,6 +138,7 @@ The component relies on Foundation purpose tokens in `spotlight.css` so light/da
 | Host stacking | `var(--xpl-z-index-800)` |
 | Placeholder pattern | `var(--xpl-background-surface-subtle)` |
 | Heading text | `var(--xpl-text-default)` |
+| Heading line-height | `var(--xpl-line-height-title-3)` (title-3) |
 | Body text | `var(--xpl-text-default)` |
 | Step text | `var(--xpl-text-subdued)` |
 | Open/closed visibility | `opacity` transition on `.xpl-spotlight--visible` |

package/dist/docs/xpl-table/readme.md

@@ -9,6 +9,18 @@ Tables are used to organize and display information from a data set.
 
 Composable **selection** (`selectable`), **toolbar**, and copy-paste examples live under **[Usage](#usage)** below (read the breaking-change note first if you are migrating from auto-injected selection cells).
 
+### Breaking change — global table class names (Apollo Core 3.0.0)
+
+Apollo Core 3.0.0 introduced the compositional table ([#982](https://github.com/xplor/apollo/pull/982)) and ships global CSS for `.xpl-table`, `.xpl-table-row`, `.xpl-table-cell`, `.xpl-table-header-*`, `.xpl-table-body`, and `.xpl-table-footer-*`. In 2.x many of these class names had **no Apollo styles** (or only applied on native `<table>` via `.xpl-table`). These styles are **not scoped** to the `<xpl-table>` element — any element carrying these class names picks them up. If your application used these names as styling hooks on its own native table markup, upgrading to 3.x can break layout.
+
+| Symptom | Typical cause | Fix |
+| --- | --- | --- |
+| All table rows render side by side in one line | `xpl-table-row` class hook on native `<tr>` applies `display: contents` | Remove the hook class from native rows, or migrate to `<xpl-table-row>` inside `<xpl-table>` |
+| Native `<table class="xpl-table">` layout is destroyed | Compositional grid targets the `.xpl-table` **class** (`display: grid` + `grid-template-columns`), so it also matches native `<table class="xpl-table">` | Add `xpl-table--legacy`: `<table class="xpl-table xpl-table--legacy">` |
+| Sticky freeze column lost on native tables | Compositional `.xpl-table--freeze` sticky rules target compositional cell classes (`.xpl-table-cell` etc.); the 2.x native-table freeze lives under `.xpl-table--legacy.xpl-table--freeze` | Add `xpl-table--legacy` to the native `<table>` |
+
+**`xpl-table--legacy`:** opt-in class for native `<table>` markup (or the deprecated `columns` / `data` render path) that restores pre-compositional Apollo table styling. Scheduled for removal in **Apollo Core 4.0.0** — migrate to compositional `<xpl-table>` or application-owned table styles before then.
+
 ### Row reorder (`row-reorderable`, managed grip column)
 
 When `row-reorderable` is set, Apollo can **inject** a leading reorder column with a native **button** + optional `xpl-icon` on each body row (unless you author that column yourself). Keyboard and pointer reorder share the same grip; **keyboard mode** is indicated by `aria-pressed`, updated labels, the class `xpl-table__row-drag-handle--keyboard-mode`, and optionally a **different icon**.

package/dist/docs/xpl-table/xpl-table-body/readme.md

@@ -11,6 +11,13 @@ Row group for compositional table body content. Uses `display: contents` so slot
 <!-- Auto Generated Below -->
 
 
+## Slots
+
+| Slot | Description                               |
+| ---- | ----------------------------------------- |
+|      | The body rows (`xpl-table-row` elements). |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-table/xpl-table-cell/readme.md

@@ -35,6 +35,13 @@ Extends `.xpl-table-cell-base` (`table-cell-base.css`); row states (selected, di
 | `underline` | `underline` | Adds an underline to cell text.                                                                 | `boolean`                       | `false`  |
 
 
+## Slots
+
+| Slot | Description       |
+| ---- | ----------------- |
+|      | The cell content. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-table/xpl-table-footer/readme.md

@@ -11,6 +11,13 @@ Row group for compositional table footer content. Uses `display: contents` so sl
 <!-- Auto Generated Below -->
 
 
+## Slots
+
+| Slot | Description                                            |
+| ---- | ------------------------------------------------------ |
+|      | The footer content (`xpl-table-footer-cell` elements). |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

package/dist/docs/xpl-table/xpl-table-footer-cell/readme.md

@@ -22,6 +22,13 @@ Footer cell for compositional tables. Extends the shared `.xpl-table-cell-base`
 | `align`  | `align`   | Horizontal alignment of footer cell content. | `"center" \| "left" \| "right"` | `'left'` |
 
 
+## Slots
+
+| Slot | Description              |
+| ---- | ------------------------ |
+|      | The footer cell content. |
+
+
 ## Dependencies
 
 ### Used by