@xplortech/apollo-core 3.2.1 → 3.3.0

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

@@ -30,55 +30,62 @@ For **sortable** columns (`type="label"`), set **`sortable`** and optionally **`
 
 ---
 
-<!-- Auto Generated Below -->
-
-
-## Properties
-
-| Property            | Attribute             | Description                                                                                                                                                                                                                                    | Type                                         | Default     |
-| ------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ----------- |
-| `align`             | `align`               | Horizontal text alignment within the header cell.                                                                                                                                                                                              | `"center" \| "left" \| "right"`              | `'left'`    |
-| `checkboxAriaLabel` | `checkbox-aria-label` | Accessible name for the header checkbox (native `aria-label`). Defaults to “Select all rows” when `type` is `checkbox`.                                                                                                                        | `string`                                     | `undefined` |
-| `checked`           | `checked`             | Whether the header checkbox is checked                                                                                                                                                                                                         | `boolean`                                    | `false`     |
-| `columnWidth`       | `column-width`        | CSS grid track size for this column (e.g. `1fr`, `minmax(120px, 1fr)`, `auto`). When set, overrides `width`. Use this when you need flexible columns; default layout uses `auto` per column unless you set a track here.                       | `string`                                     | `undefined` |
-| `icon`              | `icon`                | Icon to display in the cell.  See [xpl-icon available icons](../xpl-icon/ICONS.md) for valid icon names.                                                                                                                                       | `string`                                     | `undefined` |
-| `indeterminate`     | `indeterminate`       | Whether the checkbox is in indeterminate (partially selected) state                                                                                                                                                                            | `boolean`                                    | `false`     |
-| `label`             | `label`               | Text to display in the cell.                                                                                                                                                                                                                   | `string`                                     | `''`        |
-| `sortDirection`     | `sort-direction`      | Active sort direction for this column when `sortable`. Set by `xpl-table` when used inside a compositional table; may be set by the app for controlled updates.                                                                                | `"asc" \| "desc"`                            | `undefined` |
-| `sortKey`           | `sort-key`            | When `sortable` is true, optional stable id used as the key in `sortChanged`’s detail object. Falls back to a slug of `label` when omitted.                                                                                                    | `string`                                     | `undefined` |
-| `sortable`          | `sortable`            | When true (and `type` is `label`), renders a sort control (button + affordance icon).                                                                                                                                                          | `boolean`                                    | `false`     |
-| `type`              | `type`                | The type of cell to render. **Reflected** to the host `type` attribute so `xpl-table` (and CSS `[type="checkbox"]`) can find the selection column after frameworks set the prop without syncing the attribute (e.g. Vue `:type="'checkbox'"`). | `"checkbox" \| "empty" \| "icon" \| "label"` | `'label'`   |
-| `width`             | `width`               | Fixed width for this column in pixels (minimum 48px). Sets the grid track to `Npx`. Ignored when `columnWidth` is set. When omitted, the column track defaults to `auto` (content-sized).                                                      | `number`                                     | `undefined` |
-
-
-## Events
-
-| Event                  | Description                                                                                                        | Type                                  |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
-| `headerCheckboxChange` | Emitted when header checkbox changes                                                                               | `CustomEvent<boolean>`                |
-| `headerSortChange`     | Emitted when a sortable label header is activated. Parent `xpl-table` coordinates columns and emits `sortChanged`. | `CustomEvent<HeaderSortChangeDetail>` |
-
-
-## Dependencies
-
-### Used by
-
- - [xpl-table](..)
-
-### Depends on
-
-- [xpl-icon](../../xpl-icon)
-- [xpl-checkbox](../../xpl-checkbox)
-
-### Graph
-```mermaid
-graph TD;
-  xpl-table-header-cell --> xpl-icon
-  xpl-table-header-cell --> xpl-checkbox
-  xpl-table --> xpl-table-header-cell
-  style xpl-table-header-cell fill:#f9f,stroke:#333,stroke-width:4px
-```
-
-----------------------------------------------
-
-*Built with [StencilJS](https://stenciljs.com/)*
+<!-- Auto Generated Below -->
+
+
+## Properties
+
+| Property            | Attribute             | Description                                                                                                                                                                                                                                    | Type                                         | Default     |
+| ------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ----------- |
+| `align`             | `align`               | Horizontal text alignment within the header cell.                                                                                                                                                                                              | `"center" \| "left" \| "right"`              | `'left'`    |
+| `checkboxAriaLabel` | `checkbox-aria-label` | Accessible name for the header checkbox (native `aria-label`). Defaults to “Select all rows” when `type` is `checkbox`.                                                                                                                        | `string`                                     | `undefined` |
+| `checked`           | `checked`             | Whether the header checkbox is checked                                                                                                                                                                                                         | `boolean`                                    | `false`     |
+| `columnWidth`       | `column-width`        | CSS grid track size for this column (e.g. `1fr`, `minmax(120px, 1fr)`, `auto`). When set, overrides `width`. Use this when you need flexible columns; default layout uses `auto` per column unless you set a track here.                       | `string`                                     | `undefined` |
+| `icon`              | `icon`                | Icon to display in the cell.  See [xpl-icon available icons](../xpl-icon/ICONS.md) for valid icon names.                                                                                                                                       | `string`                                     | `undefined` |
+| `indeterminate`     | `indeterminate`       | Whether the checkbox is in indeterminate (partially selected) state                                                                                                                                                                            | `boolean`                                    | `false`     |
+| `label`             | `label`               | Text to display in the cell.                                                                                                                                                                                                                   | `string`                                     | `''`        |
+| `sortDirection`     | `sort-direction`      | Active sort direction for this column when `sortable`. Set by `xpl-table` when used inside a compositional table; may be set by the app for controlled updates.                                                                                | `"asc" \| "desc"`                            | `undefined` |
+| `sortKey`           | `sort-key`            | When `sortable` is true, optional stable id used as the key in `sortChanged`’s detail object. Falls back to a slug of `label` when omitted.                                                                                                    | `string`                                     | `undefined` |
+| `sortable`          | `sortable`            | When true (and `type` is `label`), renders a sort control (button + affordance icon).                                                                                                                                                          | `boolean`                                    | `false`     |
+| `type`              | `type`                | The type of cell to render. **Reflected** to the host `type` attribute so `xpl-table` (and CSS `[type="checkbox"]`) can find the selection column after frameworks set the prop without syncing the attribute (e.g. Vue `:type="'checkbox'"`). | `"checkbox" \| "empty" \| "icon" \| "label"` | `'label'`   |
+| `width`             | `width`               | Fixed width for this column in pixels (minimum 48px). Sets the grid track to `Npx`. Ignored when `columnWidth` is set. When omitted, the column track defaults to `auto` (content-sized).                                                      | `number`                                     | `undefined` |
+
+
+## Events
+
+| Event                  | Description                                                                                                        | Type                                  |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
+| `headerCheckboxChange` | Emitted when header checkbox changes                                                                               | `CustomEvent<boolean>`                |
+| `headerSortChange`     | Emitted when a sortable label header is activated. Parent `xpl-table` coordinates columns and emits `sortChanged`. | `CustomEvent<HeaderSortChangeDetail>` |
+
+
+## Slots
+
+| Slot | Description                             |
+| ---- | --------------------------------------- |
+|      | The header cell content (column label). |
+
+
+## Dependencies
+
+### Used by
+
+ - [xpl-table](..)
+
+### Depends on
+
+- [xpl-icon](../../xpl-icon)
+- [xpl-checkbox](../../xpl-checkbox)
+
+### Graph
+```mermaid
+graph TD;
+  xpl-table-header-cell --> xpl-icon
+  xpl-table-header-cell --> xpl-checkbox
+  xpl-table --> xpl-table-header-cell
+  style xpl-table-header-cell fill:#f9f,stroke:#333,stroke-width:4px
+```
+
+----------------------------------------------
+
+*Built with [StencilJS](https://stenciljs.com/)*

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

@@ -33,6 +33,13 @@ Row state styles target descendant `.xpl-table-cell` nodes (see `table-row.css`)
 | `selected` | `selected` | Whether the row is visually selected.       | `boolean` | `false`     |
 
 
+## Slots
+
+| Slot | Description                                |
+| ---- | ------------------------------------------ |
+|      | The row cells (`xpl-table-cell` elements). |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

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

@@ -8,6 +8,13 @@ Component parts used to assemble the Dynamic Table.
 <!-- Auto Generated Below -->
 
 
+## Slots
+
+| Slot | Description                                            |
+| ---- | ------------------------------------------------------ |
+|      | The header content (`xpl-table-header-cell` elements). |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

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

@@ -315,8 +315,8 @@ Reorder / multi-container logic is unchanged: listen for native `dragstart`, `dr
 | Height (default) | `var(--xpl-size-150)` (24px) |
 | Height (small) | `var(--xpl-size-125)` (20px) |
 | Border radius | `var(--xpl-border-radius-button)` |
-| Typography (default) | `var(--xpl-font-size-body)` / `var(--xpl-font-weight-normal)` |
-| Typography (small) | `var(--xpl-font-size-callout)` / `var(--xpl-font-weight-semibold)` |
+| Typography (default) | `var(--xpl-font-size-body)` / `var(--xpl-font-weight-normal)` / `var(--xpl-line-height-body)` |
+| Typography (small) | `var(--xpl-font-size-callout)` / `var(--xpl-font-weight-semibold)` / `var(--xpl-line-height-callout)` |
 | Background (dragging) | `var(--xpl-background-surface-information-bold)` |
 | Cursor (draggable) | `cursor: grab` → `cursor: grabbing` while dragging |
 
@@ -382,6 +382,13 @@ These aliases will be removed in a future major version. New code should target
 | `tagRemove`    | Emitted when the tag dismiss (×) button is clicked                                                                                                                                                                                                                                                                                               | `CustomEvent<void>`               |
 
 
+## Slots
+
+| Slot | Description            |
+| ---- | ---------------------- |
+|      | The tag label content. |
+
+
 ## Dependencies
 
 ### Used by

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

@@ -159,6 +159,14 @@ Like `xpl-banner`, the messaging backgrounds resolve to transparent in dark mode
 | `variant`     | `variant`     | The sentiment of the toast.                                                                                                                                                                                                                                                   | `"neutral" \| "success" \| "warning"` | `'neutral'` |
 
 
+## Slots
+
+| Slot       | Description                                                                      |
+| ---------- | -------------------------------------------------------------------------------- |
+| `"action"` | Optional action content (e.g. a button) rendered on the right side of the toast. |
+| `"title"`  | The toast title text.                                                            |
+
+
 ## Dependencies
 
 ### Depends on

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

@@ -34,6 +34,14 @@ in both light and dark themes. Styling comes from Apollo Foundation tokens
 | `selectedItemCount` | `selected-item-count` | The number of selected items to display in the toolbar. | `number` | `0`     |
 
 
+## Slots
+
+| Slot              | Description                                         |
+| ----------------- | --------------------------------------------------- |
+| `"actions-left"`  | Actions rendered in the left group of the toolbar.  |
+| `"actions-right"` | Actions rendered in the right group of the toolbar. |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*

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

@@ -44,6 +44,13 @@ Tokens used by this component from `@xplortech/apollo-foundation`.
 | `text`      | `text`       | The tooltip text to display                     | `string`                                                                                                               | `undefined`    |
 
 
+## Slots
+
+| Slot | Description                                     |
+| ---- | ----------------------------------------------- |
+|      | The trigger element the tooltip is attached to. |
+
+
 ## Dependencies
 
 ### Used by

package/dist/docs/xpl-top-nav/xpl-nav-header-menu/readme.md

@@ -73,6 +73,7 @@ values even when the page root is light (same contract as **`xpl-top-nav`** / **
 
 | Slot                   | Description                                                                                                                                                                   |
 | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|                        | Menu items (**`xpl-top-nav-item`** rows and optional **`xpl-divider`** separators) rendered below the profile block.                                                          |
 | `"right-aside-mobile"` | Optional actions **below** **`username`** / **`email`** and **above** the default-slot list (e.g. mobile Inbox). Hidden on wide viewports by default (see **`top-nav.css`**). |
 
 

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

@@ -116,6 +116,7 @@ Type: `Promise<void>`
 
 | Slot              | Description                                                                                                                                                                                                                                                                                              |
 | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|                   | The row label content. Used when the **`label`** prop is not set.                                                                                                                                                                                                                                        |
 | `"dropdown"`      | Panel content (e.g. `<xpl-top-nav-menu>`). Presence of this slot makes the row a disclosure trigger.                                                                                                                                                                                                     |
 | `"leading-icon"`  | Illustrative icon before the label. Overrides the **`icon`** prop when present.                                                                                                                                                                                                                          |
 | `"trailing-icon"` | Functional icon after the label (e.g. **`external-link`** for "opens in new window"). When **`slot="dropdown"`** is present and no **`trailing-icon`** content is slotted, an auto chevron renders here: **`chevron-down`** on the desktop flyout, **`chevron-right`** on the mobile cascade (drill-in). |

package/dist/docs/xpl-top-nav/xpl-top-nav-menu/readme.md

@@ -72,6 +72,7 @@ resolve to dark-mode values even when the page root is light (consistent with th
 
 | Slot          | Description                  |
 | ------------- | ---------------------------- |
+|               | The default slot             |
 | `"(default)"` | **`xpl-top-nav-item`** rows. |
 
 

package/dist/docs/xpl-utility-bar/readme.md

@@ -49,6 +49,14 @@ The utility bar uses Apollo Foundation purpose-specific tokens, which theme auto
 | `navOpen` |             | `CustomEvent<boolean>` |
 
 
+## Slots
+
+| Slot      | Description                                                                            |
+| --------- | -------------------------------------------------------------------------------------- |
+| `"aside"` | Content rendered at the start of the bar, next to the nav-control toggle when present. |
+| `"main"`  | Main content of the utility bar.                                                       |
+
+
 ## Dependencies
 
 ### Depends on