@xplortech/apollo-core 2.7.0 → 2.7.1

package/dist/types/components.d.ts

@@ -9,23 +9,21 @@ import { AvatarColor, AvatarGroupItem, AvatarStatus, AvatarVariant } from "./com
 import { BadgeVariantProp } from "./components/xpl-badge/xpl-badge";
 import { Choice } from "./components/xpl-choicelist/choice";
 import { DropdownItem, DropdownOptionGroup } from "./components/xpl-dropdown/dropdown-option";
+import { Placement } from "@floating-ui/dom";
 import { ListItem, XplListOrderChangeDetail } from "./components/xpl-list/listitem";
 import { BadgeVariantProp as BadgeVariantProp1 } from "./components/xpl-badge/xpl-badge";
 import { PopoverPosition } from "./components/xpl-popover/xpl-popover";
 import { SpotlightActionLayout, SpotlightAnchorPosition } from "./components/xpl-spotlight/xpl-spotlight";
-import { XplTableRowOrderChangeDetail, XplTableSortChangedDetail } from "./components/xpl-table/xpl-table";
-import { HeaderSortChangeDetail } from "./components/xpl-table/xpl-table-header-cell/xpl-table-header-cell";
 import { TagDragEndDetail, TagDragStartDetail } from "./components/xpl-tag/xpl-tag";
 export { AvatarColor, AvatarGroupItem, AvatarStatus, AvatarVariant } from "./components/xpl-avatar/xpl-avatar";
 export { BadgeVariantProp } from "./components/xpl-badge/xpl-badge";
 export { Choice } from "./components/xpl-choicelist/choice";
 export { DropdownItem, DropdownOptionGroup } from "./components/xpl-dropdown/dropdown-option";
+export { Placement } from "@floating-ui/dom";
 export { ListItem, XplListOrderChangeDetail } from "./components/xpl-list/listitem";
 export { BadgeVariantProp as BadgeVariantProp1 } from "./components/xpl-badge/xpl-badge";
 export { PopoverPosition } from "./components/xpl-popover/xpl-popover";
 export { SpotlightActionLayout, SpotlightAnchorPosition } from "./components/xpl-spotlight/xpl-spotlight";
-export { XplTableRowOrderChangeDetail, XplTableSortChangedDetail } from "./components/xpl-table/xpl-table";
-export { HeaderSortChangeDetail } from "./components/xpl-table/xpl-table-header-cell/xpl-table-header-cell";
 export { TagDragEndDetail, TagDragStartDetail } from "./components/xpl-tag/xpl-tag";
 export namespace Components {
     interface XplAccordion {
@@ -498,6 +496,10 @@ export namespace Components {
           * @default true
          */
         "closeOnSelect": boolean;
+        /**
+          * When `anchorToTrigger` is true, additional placements to try when the default `placement` does not fit (passed to Floating UI `flip`).
+         */
+        "flipFallbackPlacements"?: Placement[];
         /**
           * called on dropdown option click and keydown events to update isSelected states
          */
@@ -516,6 +518,11 @@ export namespace Components {
           * options that are listed
          */
         "options"?: DropdownItem[];
+        /**
+          * Floating UI placement when `anchorToTrigger` is true (e.g. `bottom-start`, `top-start`).
+          * @default 'bottom-start'
+         */
+        "placement": Placement;
         /**
           * whether selection should be made when focusing on interactive element
           * @default false
@@ -576,16 +583,8 @@ export namespace Components {
          */
         "value"?: string;
     }
-    /**
-     * @deprecated Use the compositional `<xpl-table>` API instead.
-     * This component will be removed in a future major release.
-     */
     interface XplDynamicTable {
     }
-    /**
-     * @deprecated Use `<xpl-table-cell>` instead.
-     * This component will be removed in a future major release.
-     */
     interface XplDynamicTableCell {
         /**
           * Whether the cell and its contents are disabled.
@@ -593,10 +592,6 @@ export namespace Components {
          */
         "disabled": boolean;
     }
-    /**
-     * @deprecated Use `<xpl-table-row>` instead.
-     * This component will be removed in a future major release.
-     */
     interface XplDynamicTableRow {
         /**
           * Whether the row and its cells are disabled.
@@ -1475,6 +1470,15 @@ export namespace Components {
           * Whether the field is disabled
          */
         "disabled"?: boolean;
+        /**
+          * Additional placements to try for the options panel when the default `dropdownPlacement` does not fit. Passed to `xpl-dropdown` / Floating UI `flip`.
+         */
+        "dropdownFlipFallbackPlacements"?: Placement[];
+        /**
+          * Initial Floating UI placement for the options panel (e.g. `top-start`, `bottom-start`). Forwarded to the inner `xpl-dropdown` when the menu is open.
+          * @default 'bottom-start'
+         */
+        "dropdownPlacement": Placement;
         /**
           * If an empty string (attribute present with no value), will display visually as an error. If a string is included, will display visually as an error and include the value as an error message.
          */
@@ -1754,62 +1758,39 @@ export namespace Components {
          */
         "target": string;
     }
-    /**
-     * Compositional tables use CSS grid on the host (`role="grid"`). Legacy mode uses a `<table>`.
-     */
     interface XplTable {
         /**
-          * @deprecated Legacy data-driven table API only (`columns` / `data` / `footer`). May be removed in a future major release.  The header values for each column.
+          * The header values for each column.
          */
         "columns"?: string[];
         /**
-          * @deprecated Legacy data-driven table API only (`columns` / `data` / `footer`). May be removed in a future major release.  The data for the body of the table.
+          * The data for the body of the table.
          */
         "data"?: string[][];
         /**
-          * @deprecated Legacy data-driven table API only (`columns` / `data` / `footer`). May be removed in a future major release.  The data for the footer of the table.
+          * The data for the footer of the table.
          */
         "footer"?: string[][];
         /**
-          * When true, the first **data** column (per row) is sticky during horizontal scroll. Leading compositional columns are skipped: `selectable` (checkbox) and/or `row-reorderable` (grip) are not frozen so they scroll with the grid; the next column stays pinned at `left: 0`.
+          * When true, the first column of the table is sticky and will cover the leftmost rows in a horizontally scrollable container.
          */
         "freeze"?: boolean;
         /**
-          * @deprecated Legacy data-driven table API only. May be removed in a future major release.  Toggles to show the sort button on each table head.
+          * Toggles to show the sort button on each table head
           * @default false
          */
         "isSortable"?: boolean;
         /**
-          * Accessible label for the table. Maps to `aria-label` in compositional mode.
-         */
-        "label"?: string;
-        /**
-          * @deprecated Legacy data-driven table API only. May be removed in a future major release.  Toggles a selectable checkbox for each row in the table.
+          * Toggles a selectable checkbox for each row in the table
          */
         "multiselect"?: boolean;
         /**
-          * Icon name for the optional `xpl-icon` inside each **managed** reorder grip when the row is **not** in keyboard reorder mode (pointer / idle). Set to `""` to omit the icon so you can style the button or author a fully custom reorder column in markup. When omitted, defaults to `grip-dots-vertical`.
-         */
-        "reorderHandleIcon"?: string;
-        /**
-          * Icon name for the managed reorder grip **while that row is in keyboard reorder mode** (after the user activates the grip with Enter or Space). Use a different icon than `reorder-handle-icon` so users can see they should use arrow keys. When omitted, defaults to `caret-expand-y` (same as `xpl-list` keyboard reorder). Set to `""` to show no icon in keyboard mode only (combine with CSS on `.xpl-table__row-drag-handle--keyboard-mode` if needed).
-         */
-        "reorderHandleIconKeyboard"?: string;
-        /**
-          * When true (compositional mode only), **prepends** a managed reorder column as the **first** grid column (empty header + grip button per body row) and enables HTML5 drag-and-drop row reordering (same interaction model as `xpl-list`). With `selectable`, DOM order is **reorder | selection | data** unless you author a custom reorder column. The table updates the DOM and emits `rowOrderChange`; consumers should persist order if needed. Ignored in legacy `columns`/`data` mode.
-         */
-        "rowReorderable"?: boolean;
-        /**
-          * When true (compositional mode only), enables row selection state, the selection toolbar (“N Selected”), and `rowSelectionChange`. **You must add the selection column in your markup:** a header cell with `type="checkbox"`, a body cell containing `xpl-checkbox` per row (aligned with that column), and matching `xpl-table-footer-cell` cells when you use a footer. Each body row should use `row-id` on `xpl-table-row` (or accept auto-generated ids) so `rowSelectionChange` can report `selectedRowIds`.  The toolbar uses the same layout as `xpl-toolbar` and is visible only while at least one row is selected. Use `toolbar-actions-left` / `toolbar-actions-right` slots on this host for bulk actions.
-         */
-        "selectable"?: boolean;
-        /**
-          * @deprecated Legacy data-driven table API only. May be removed in a future major release.  The values for the input for each row when multiselect is activated.
+          * The values for the input for each row when multiselect is activated.
           * @default []
          */
         "selectedValues"?: string[];
         /**
-          * @deprecated Use the compositional slot-based API instead. Will be removed in a future major release.  Manually determined if the column is sortable.
+          * Manually determined if the column is sortable
           * @default []
          */
         "sortableColumns"?: boolean[];
@@ -1818,113 +1799,33 @@ export namespace Components {
          */
         "striped"?: boolean;
     }
-    interface XplTableBody {
-    }
-    interface XplTableCell {
-        /**
-          * Horizontal text alignment within the cell.
-          * @default 'left'
-         */
-        "align": 'left' | 'right' | 'center';
-        /**
-          * Renders cell text in bold (--xpl-font-weight-semibold).
-          * @default false
-         */
-        "bold": boolean;
-        /**
-          * Whether the cell and its interactive children are disabled. Set automatically by xpl-table-row.
-          * @default false
-         */
-        "disabled": boolean;
-        /**
-          * Adds an underline to cell text.
-          * @default false
-         */
-        "underline": boolean;
-    }
-    interface XplTableFooter {
-    }
-    interface XplTableFooterCell {
-        /**
-          * Horizontal text alignment within the cell.
-          * @default 'left'
-         */
-        "align": 'left' | 'right' | 'center';
-    }
     interface XplTableHeader {
     }
     interface XplTableHeaderCell {
-        /**
-          * Horizontal text alignment within the header cell.
-          * @default 'left'
-         */
-        "align": 'left' | 'right' | 'center';
-        /**
-          * Accessible name for the header checkbox (native `aria-label`). Defaults to “Select all rows” when `type` is `checkbox`.
-         */
-        "checkboxAriaLabel"?: string;
-        /**
-          * Whether the header checkbox is checked
-          * @default false
-         */
-        "checked": boolean;
-        /**
-          * 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.
-         */
-        "columnWidth"?: string;
         /**
           * Icon to display in the cell.  See [xpl-icon available icons](../xpl-icon/ICONS.md) for valid icon names.
          */
         "icon"?: string;
         /**
-          * Whether the checkbox is in indeterminate (partially selected) state
-          * @default false
-         */
-        "indeterminate": boolean;
-        /**
-          * Text to display in the cell.
+          * @property {string} - Text to display in the cell
           * @default ''
          */
         "label"?: string;
         /**
-          * 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.
-         */
-        "sortDirection"?: 'asc' | 'desc' | null;
-        /**
-          * 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.
-         */
-        "sortKey"?: string;
-        /**
-          * When true (and `type` is `label`), renders a sort control (button + affordance icon).
+          * @property {boolean} - Whether the cell is sortable or not
           * @default false
          */
-        "sortable": boolean;
+        "sortable"?: boolean;
         /**
-          * The type of cell to render.
+          * @property {string} - The type of cell to render
           * @default 'label'
          */
-        "type": 'label' | 'checkbox' | 'icon' | 'empty';
+        "type": 'label' | 'checkbox' | 'icon';
         /**
-          * 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).
+          * @property {number} - Width of the cell, in pixels. Minimum width is 48px. If no value is provided, it will default to fit the content of the cell with 16px of padding on each side
          */
         "width"?: number;
     }
-    interface XplTableRow {
-        /**
-          * Whether the row and its cells are disabled.
-          * @default false
-         */
-        "disabled": boolean;
-        /**
-          * Stable identifier for this row when used with a selectable compositional `xpl-table`. If omitted, the parent table assigns a unique id.
-         */
-        "rowId"?: string;
-        /**
-          * Whether the row is visually selected.
-          * @default false
-         */
-        "selected": boolean;
-    }
     interface XplTabs {
         /**
           * Disables the whole tab group (headings, mobile select, and segment pills).
@@ -2500,10 +2401,6 @@ declare global {
     interface HTMLXplDynamicTableElementEventMap {
         "selectedItemCountChange": string[];
     }
-    /**
-     * @deprecated Use the compositional `<xpl-table>` API instead.
-     * This component will be removed in a future major release.
-     */
     interface HTMLXplDynamicTableElement extends Components.XplDynamicTable, HTMLStencilElement {
         addEventListener<K extends keyof HTMLXplDynamicTableElementEventMap>(type: K, listener: (this: HTMLXplDynamicTableElement, ev: XplDynamicTableCustomEvent<HTMLXplDynamicTableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2518,20 +2415,12 @@ declare global {
         prototype: HTMLXplDynamicTableElement;
         new (): HTMLXplDynamicTableElement;
     };
-    /**
-     * @deprecated Use `<xpl-table-cell>` instead.
-     * This component will be removed in a future major release.
-     */
     interface HTMLXplDynamicTableCellElement extends Components.XplDynamicTableCell, HTMLStencilElement {
     }
     var HTMLXplDynamicTableCellElement: {
         prototype: HTMLXplDynamicTableCellElement;
         new (): HTMLXplDynamicTableCellElement;
     };
-    /**
-     * @deprecated Use `<xpl-table-row>` instead.
-     * This component will be removed in a future major release.
-     */
     interface HTMLXplDynamicTableRowElement extends Components.XplDynamicTableRow, HTMLStencilElement {
     }
     var HTMLXplDynamicTableRowElement: {
@@ -3013,14 +2902,13 @@ declare global {
         new (): HTMLXplTabPanelElement;
     };
     interface HTMLXplTableElementEventMap {
-        "rowOrderChange": XplTableRowOrderChangeDetail;
-        "rowSelectionChange": { selectedRowIds: string[] };
-        "sortChanged": XplTableSortChangedDetail;
         "tableSelect": any;
+        "sortChanged": {
+        colNum: number;
+        colName: string;
+        sortTypeArr: string[];
+    };
     }
-    /**
-     * Compositional tables use CSS grid on the host (`role="grid"`). Legacy mode uses a `<table>`.
-     */
     interface HTMLXplTableElement extends Components.XplTable, HTMLStencilElement {
         addEventListener<K extends keyof HTMLXplTableElementEventMap>(type: K, listener: (this: HTMLXplTableElement, ev: XplTableCustomEvent<HTMLXplTableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3035,30 +2923,6 @@ declare global {
         prototype: HTMLXplTableElement;
         new (): HTMLXplTableElement;
     };
-    interface HTMLXplTableBodyElement extends Components.XplTableBody, HTMLStencilElement {
-    }
-    var HTMLXplTableBodyElement: {
-        prototype: HTMLXplTableBodyElement;
-        new (): HTMLXplTableBodyElement;
-    };
-    interface HTMLXplTableCellElement extends Components.XplTableCell, HTMLStencilElement {
-    }
-    var HTMLXplTableCellElement: {
-        prototype: HTMLXplTableCellElement;
-        new (): HTMLXplTableCellElement;
-    };
-    interface HTMLXplTableFooterElement extends Components.XplTableFooter, HTMLStencilElement {
-    }
-    var HTMLXplTableFooterElement: {
-        prototype: HTMLXplTableFooterElement;
-        new (): HTMLXplTableFooterElement;
-    };
-    interface HTMLXplTableFooterCellElement extends Components.XplTableFooterCell, HTMLStencilElement {
-    }
-    var HTMLXplTableFooterCellElement: {
-        prototype: HTMLXplTableFooterCellElement;
-        new (): HTMLXplTableFooterCellElement;
-    };
     interface HTMLXplTableHeaderElement extends Components.XplTableHeader, HTMLStencilElement {
     }
     var HTMLXplTableHeaderElement: {
@@ -3066,8 +2930,7 @@ declare global {
         new (): HTMLXplTableHeaderElement;
     };
     interface HTMLXplTableHeaderCellElementEventMap {
-        "headerCheckboxChange": boolean;
-        "headerSortChange": HeaderSortChangeDetail;
+        "sortChanged": 'asc' | 'desc' | 'none';
     }
     interface HTMLXplTableHeaderCellElement extends Components.XplTableHeaderCell, HTMLStencilElement {
         addEventListener<K extends keyof HTMLXplTableHeaderCellElementEventMap>(type: K, listener: (this: HTMLXplTableHeaderCellElement, ev: XplTableHeaderCellCustomEvent<HTMLXplTableHeaderCellElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3083,12 +2946,6 @@ declare global {
         prototype: HTMLXplTableHeaderCellElement;
         new (): HTMLXplTableHeaderCellElement;
     };
-    interface HTMLXplTableRowElement extends Components.XplTableRow, HTMLStencilElement {
-    }
-    var HTMLXplTableRowElement: {
-        prototype: HTMLXplTableRowElement;
-        new (): HTMLXplTableRowElement;
-    };
     interface HTMLXplTabsElementEventMap {
         "tabChange": string;
     }
@@ -3299,13 +3156,8 @@ declare global {
         "xpl-tab": HTMLXplTabElement;
         "xpl-tab-panel": HTMLXplTabPanelElement;
         "xpl-table": HTMLXplTableElement;
-        "xpl-table-body": HTMLXplTableBodyElement;
-        "xpl-table-cell": HTMLXplTableCellElement;
-        "xpl-table-footer": HTMLXplTableFooterElement;
-        "xpl-table-footer-cell": HTMLXplTableFooterCellElement;
         "xpl-table-header": HTMLXplTableHeaderElement;
         "xpl-table-header-cell": HTMLXplTableHeaderCellElement;
-        "xpl-table-row": HTMLXplTableRowElement;
         "xpl-tabs": HTMLXplTabsElement;
         "xpl-tag": HTMLXplTagElement;
         "xpl-toast": HTMLXplToastElement;
@@ -3821,6 +3673,10 @@ declare namespace LocalJSX {
           * @default true
          */
         "closeOnSelect"?: boolean;
+        /**
+          * When `anchorToTrigger` is true, additional placements to try when the default `placement` does not fit (passed to Floating UI `flip`).
+         */
+        "flipFallbackPlacements"?: Placement[];
         /**
           * text to display as heading
           * @default false
@@ -3839,6 +3695,11 @@ declare namespace LocalJSX {
           * options that are listed
          */
         "options"?: DropdownItem[];
+        /**
+          * Floating UI placement when `anchorToTrigger` is true (e.g. `bottom-start`, `top-start`).
+          * @default 'bottom-start'
+         */
+        "placement"?: Placement;
         /**
           * whether selection should be made when focusing on interactive element
           * @default false
@@ -3899,20 +3760,12 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
-    /**
-     * @deprecated Use the compositional `<xpl-table>` API instead.
-     * This component will be removed in a future major release.
-     */
     interface XplDynamicTable {
         /**
           * Emitted when the number of selected items changes.
          */
         "onSelectedItemCountChange"?: (event: XplDynamicTableCustomEvent<string[]>) => void;
     }
-    /**
-     * @deprecated Use `<xpl-table-cell>` instead.
-     * This component will be removed in a future major release.
-     */
     interface XplDynamicTableCell {
         /**
           * Whether the cell and its contents are disabled.
@@ -3920,10 +3773,6 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
     }
-    /**
-     * @deprecated Use `<xpl-table-row>` instead.
-     * This component will be removed in a future major release.
-     */
     interface XplDynamicTableRow {
         /**
           * Whether the row and its cells are disabled.
@@ -4920,6 +4769,15 @@ declare namespace LocalJSX {
           * Whether the field is disabled
          */
         "disabled"?: boolean;
+        /**
+          * Additional placements to try for the options panel when the default `dropdownPlacement` does not fit. Passed to `xpl-dropdown` / Floating UI `flip`.
+         */
+        "dropdownFlipFallbackPlacements"?: Placement[];
+        /**
+          * Initial Floating UI placement for the options panel (e.g. `top-start`, `bottom-start`). Forwarded to the inner `xpl-dropdown` when the menu is open.
+          * @default 'bottom-start'
+         */
+        "dropdownPlacement"?: Placement;
         /**
           * If an empty string (attribute present with no value), will display visually as an error. If a string is included, will display visually as an error and include the value as an error message.
          */
@@ -5224,78 +5082,51 @@ declare namespace LocalJSX {
          */
         "target"?: string;
     }
-    /**
-     * Compositional tables use CSS grid on the host (`role="grid"`). Legacy mode uses a `<table>`.
-     */
     interface XplTable {
         /**
-          * @deprecated Legacy data-driven table API only (`columns` / `data` / `footer`). May be removed in a future major release.  The header values for each column.
+          * The header values for each column.
          */
         "columns"?: string[];
         /**
-          * @deprecated Legacy data-driven table API only (`columns` / `data` / `footer`). May be removed in a future major release.  The data for the body of the table.
+          * The data for the body of the table.
          */
         "data"?: string[][];
         /**
-          * @deprecated Legacy data-driven table API only (`columns` / `data` / `footer`). May be removed in a future major release.  The data for the footer of the table.
+          * The data for the footer of the table.
          */
         "footer"?: string[][];
         /**
-          * When true, the first **data** column (per row) is sticky during horizontal scroll. Leading compositional columns are skipped: `selectable` (checkbox) and/or `row-reorderable` (grip) are not frozen so they scroll with the grid; the next column stays pinned at `left: 0`.
+          * When true, the first column of the table is sticky and will cover the leftmost rows in a horizontally scrollable container.
          */
         "freeze"?: boolean;
         /**
-          * @deprecated Legacy data-driven table API only. May be removed in a future major release.  Toggles to show the sort button on each table head.
+          * Toggles to show the sort button on each table head
           * @default false
          */
         "isSortable"?: boolean;
         /**
-          * Accessible label for the table. Maps to `aria-label` in compositional mode.
-         */
-        "label"?: string;
-        /**
-          * @deprecated Legacy data-driven table API only. May be removed in a future major release.  Toggles a selectable checkbox for each row in the table.
+          * Toggles a selectable checkbox for each row in the table
          */
         "multiselect"?: boolean;
         /**
-          * Emitted after body rows are reordered via drag-and-drop (compositional `row-reorderable` mode).
+          * Emits an event whenever the sort changes. The 'sortChanged' event passes an object with colNum (number), colName (string), sortTypeArr(string[]). The default action can be overridden by calling event.preventDefault().
          */
-        "onRowOrderChange"?: (event: XplTableCustomEvent<XplTableRowOrderChangeDetail>) => void;
-        /**
-          * Emitted when row selection changes in compositional `selectable` mode. Listen on this `xpl-table` instance only; the event does not bubble to parents—use `table.addEventListener('rowSelectionChange', …)` on the same element. When wiring from a script in static HTML, wait for `customElements.whenDefined('xpl-table')` so the host is ready. (Named `rowSelectionChange` to avoid clashing with the native `selectionchange` event.)
-         */
-        "onRowSelectionChange"?: (event: XplTableCustomEvent<{ selectedRowIds: string[] }>) => void;
-        /**
-          * Emitted when sort changes in **legacy** or **compositional** mode. `event.detail` is a plain object: **sort-key slug → `'asc' | 'desc' | null`** (null = that column not sorted). Keys match legacy column titles (slugified) or compositional `sort-key` / label slugs. Call `event.preventDefault()` in legacy mode to skip built-in row sorting; compositional tables do not reorder rows automatically.
-         */
-        "onSortChanged"?: (event: XplTableCustomEvent<XplTableSortChangedDetail>) => void;
+        "onSortChanged"?: (event: XplTableCustomEvent<{
+        colNum: number;
+        colName: string;
+        sortTypeArr: string[];
+    }>) => void;
         /**
-          * Callback function that is called when the checkbox for a row of a `multiselect` table is checked.
+          * Callback function that is called when the checkbox for a row of a `multiselect` table is checked
          */
         "onTableSelect"?: (event: XplTableCustomEvent<any>) => void;
         /**
-          * Icon name for the optional `xpl-icon` inside each **managed** reorder grip when the row is **not** in keyboard reorder mode (pointer / idle). Set to `""` to omit the icon so you can style the button or author a fully custom reorder column in markup. When omitted, defaults to `grip-dots-vertical`.
-         */
-        "reorderHandleIcon"?: string;
-        /**
-          * Icon name for the managed reorder grip **while that row is in keyboard reorder mode** (after the user activates the grip with Enter or Space). Use a different icon than `reorder-handle-icon` so users can see they should use arrow keys. When omitted, defaults to `caret-expand-y` (same as `xpl-list` keyboard reorder). Set to `""` to show no icon in keyboard mode only (combine with CSS on `.xpl-table__row-drag-handle--keyboard-mode` if needed).
-         */
-        "reorderHandleIconKeyboard"?: string;
-        /**
-          * When true (compositional mode only), **prepends** a managed reorder column as the **first** grid column (empty header + grip button per body row) and enables HTML5 drag-and-drop row reordering (same interaction model as `xpl-list`). With `selectable`, DOM order is **reorder | selection | data** unless you author a custom reorder column. The table updates the DOM and emits `rowOrderChange`; consumers should persist order if needed. Ignored in legacy `columns`/`data` mode.
-         */
-        "rowReorderable"?: boolean;
-        /**
-          * When true (compositional mode only), enables row selection state, the selection toolbar (“N Selected”), and `rowSelectionChange`. **You must add the selection column in your markup:** a header cell with `type="checkbox"`, a body cell containing `xpl-checkbox` per row (aligned with that column), and matching `xpl-table-footer-cell` cells when you use a footer. Each body row should use `row-id` on `xpl-table-row` (or accept auto-generated ids) so `rowSelectionChange` can report `selectedRowIds`.  The toolbar uses the same layout as `xpl-toolbar` and is visible only while at least one row is selected. Use `toolbar-actions-left` / `toolbar-actions-right` slots on this host for bulk actions.
-         */
-        "selectable"?: boolean;
-        /**
-          * @deprecated Legacy data-driven table API only. May be removed in a future major release.  The values for the input for each row when multiselect is activated.
+          * The values for the input for each row when multiselect is activated.
           * @default []
          */
         "selectedValues"?: string[];
         /**
-          * @deprecated Use the compositional slot-based API instead. Will be removed in a future major release.  Manually determined if the column is sortable.
+          * Manually determined if the column is sortable
           * @default []
          */
         "sortableColumns"?: boolean[];
@@ -5304,121 +5135,37 @@ declare namespace LocalJSX {
          */
         "striped"?: boolean;
     }
-    interface XplTableBody {
-    }
-    interface XplTableCell {
-        /**
-          * Horizontal text alignment within the cell.
-          * @default 'left'
-         */
-        "align"?: 'left' | 'right' | 'center';
-        /**
-          * Renders cell text in bold (--xpl-font-weight-semibold).
-          * @default false
-         */
-        "bold"?: boolean;
-        /**
-          * Whether the cell and its interactive children are disabled. Set automatically by xpl-table-row.
-          * @default false
-         */
-        "disabled"?: boolean;
-        /**
-          * Adds an underline to cell text.
-          * @default false
-         */
-        "underline"?: boolean;
-    }
-    interface XplTableFooter {
-    }
-    interface XplTableFooterCell {
-        /**
-          * Horizontal text alignment within the cell.
-          * @default 'left'
-         */
-        "align"?: 'left' | 'right' | 'center';
-    }
     interface XplTableHeader {
     }
     interface XplTableHeaderCell {
-        /**
-          * Horizontal text alignment within the header cell.
-          * @default 'left'
-         */
-        "align"?: 'left' | 'right' | 'center';
-        /**
-          * Accessible name for the header checkbox (native `aria-label`). Defaults to “Select all rows” when `type` is `checkbox`.
-         */
-        "checkboxAriaLabel"?: string;
-        /**
-          * Whether the header checkbox is checked
-          * @default false
-         */
-        "checked"?: boolean;
-        /**
-          * 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.
-         */
-        "columnWidth"?: string;
         /**
           * Icon to display in the cell.  See [xpl-icon available icons](../xpl-icon/ICONS.md) for valid icon names.
          */
         "icon"?: string;
         /**
-          * Whether the checkbox is in indeterminate (partially selected) state
-          * @default false
-         */
-        "indeterminate"?: boolean;
-        /**
-          * Text to display in the cell.
+          * @property {string} - Text to display in the cell
           * @default ''
          */
         "label"?: string;
         /**
-          * Emitted when header checkbox changes
+          * Emitted when the sort direction changes.
          */
-        "onHeaderCheckboxChange"?: (event: XplTableHeaderCellCustomEvent<boolean>) => void;
+        "onSortChanged"?: (event: XplTableHeaderCellCustomEvent<'asc' | 'desc' | 'none'>) => void;
         /**
-          * Emitted when a sortable label header is activated. Parent `xpl-table` coordinates columns and emits `sortChanged`.
-         */
-        "onHeaderSortChange"?: (event: XplTableHeaderCellCustomEvent<HeaderSortChangeDetail>) => void;
-        /**
-          * 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.
-         */
-        "sortDirection"?: 'asc' | 'desc' | null;
-        /**
-          * 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.
-         */
-        "sortKey"?: string;
-        /**
-          * When true (and `type` is `label`), renders a sort control (button + affordance icon).
+          * @property {boolean} - Whether the cell is sortable or not
           * @default false
          */
         "sortable"?: boolean;
         /**
-          * The type of cell to render.
+          * @property {string} - The type of cell to render
           * @default 'label'
          */
-        "type"?: 'label' | 'checkbox' | 'icon' | 'empty';
+        "type"?: 'label' | 'checkbox' | 'icon';
         /**
-          * 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).
+          * @property {number} - Width of the cell, in pixels. Minimum width is 48px. If no value is provided, it will default to fit the content of the cell with 16px of padding on each side
          */
         "width"?: number;
     }
-    interface XplTableRow {
-        /**
-          * Whether the row and its cells are disabled.
-          * @default false
-         */
-        "disabled"?: boolean;
-        /**
-          * Stable identifier for this row when used with a selectable compositional `xpl-table`. If omitted, the parent table assigns a unique id.
-         */
-        "rowId"?: string;
-        /**
-          * Whether the row is visually selected.
-          * @default false
-         */
-        "selected"?: boolean;
-    }
     interface XplTabs {
         /**
           * Disables the whole tab group (headings, mobile select, and segment pills).
@@ -5776,14 +5523,14 @@ declare namespace LocalJSX {
     interface XplCheckboxAttributes {
         "ariaLabel": string;
         "checked": boolean;
-        "dataId": string;
         "description": string;
         "disabled": boolean;
         "indeterminate": boolean;
         "name": string;
+        "value": string;
         "required": boolean;
         "styled": boolean;
-        "value": string;
+        "dataId": string;
     }
     interface XplChoicelistAttributes {
         "description": string;
@@ -5818,6 +5565,7 @@ declare namespace LocalJSX {
         "closeOnSelect": boolean;
         "mode": 'single' | 'multi';
         "anchorToTrigger": boolean;
+        "placement": Placement;
         "selectedValues": string | string[];
         "selectOnFocus": boolean;
         "triggerId": string;
@@ -5851,10 +5599,10 @@ declare namespace LocalJSX {
     }
     interface XplHeaderAccordionAttributes {
         "contentId": string;
-        "disabled": boolean;
-        "hasCheckbox": boolean;
         "initialExpanded": boolean;
+        "disabled": boolean;
         "selectedCount": number;
+        "hasCheckbox": boolean;
     }
     interface XplIconAttributes {
         "icon": string;
@@ -6061,6 +5809,7 @@ declare namespace LocalJSX {
         "selectIcon": string;
         "description": string;
         "disabled": boolean;
+        "dropdownPlacement": Placement;
         "error": string;
         "label": string;
         "mode": 'single' | 'multi';
@@ -6136,43 +5885,17 @@ declare namespace LocalJSX {
     }
     interface XplTableAttributes {
         "freeze": boolean;
-        "isSortable": boolean;
-        "label": string;
         "multiselect": boolean;
-        "reorderHandleIcon": string;
-        "reorderHandleIconKeyboard": string;
-        "rowReorderable": boolean;
-        "selectable": boolean;
         "striped": boolean;
-    }
-    interface XplTableCellAttributes {
-        "align": 'left' | 'right' | 'center';
-        "bold": boolean;
-        "disabled": boolean;
-        "underline": boolean;
-    }
-    interface XplTableFooterCellAttributes {
-        "align": 'left' | 'right' | 'center';
+        "isSortable": boolean;
     }
     interface XplTableHeaderCellAttributes {
-        "align": 'left' | 'right' | 'center';
-        "checkboxAriaLabel": string;
-        "checked": boolean;
-        "columnWidth": string;
         "icon": string;
-        "indeterminate": boolean;
-        "label": string;
         "sortable": boolean;
-        "sortDirection": 'asc' | 'desc' | null;
-        "sortKey": string;
-        "type": 'label' | 'checkbox' | 'icon' | 'empty';
+        "label": string;
+        "type": 'label' | 'checkbox' | 'icon';
         "width": number;
     }
-    interface XplTableRowAttributes {
-        "disabled": boolean;
-        "rowId": string;
-        "selected": boolean;
-    }
     interface XplTabsAttributes {
         "disabled": boolean;
         "fullWidth": boolean;
@@ -6297,13 +6020,8 @@ declare namespace LocalJSX {
         "xpl-tab": Omit<XplTab, keyof XplTabAttributes> & { [K in keyof XplTab & keyof XplTabAttributes]?: XplTab[K] } & { [K in keyof XplTab & keyof XplTabAttributes as `attr:${K}`]?: XplTabAttributes[K] } & { [K in keyof XplTab & keyof XplTabAttributes as `prop:${K}`]?: XplTab[K] };
         "xpl-tab-panel": Omit<XplTabPanel, keyof XplTabPanelAttributes> & { [K in keyof XplTabPanel & keyof XplTabPanelAttributes]?: XplTabPanel[K] } & { [K in keyof XplTabPanel & keyof XplTabPanelAttributes as `attr:${K}`]?: XplTabPanelAttributes[K] } & { [K in keyof XplTabPanel & keyof XplTabPanelAttributes as `prop:${K}`]?: XplTabPanel[K] };
         "xpl-table": Omit<XplTable, keyof XplTableAttributes> & { [K in keyof XplTable & keyof XplTableAttributes]?: XplTable[K] } & { [K in keyof XplTable & keyof XplTableAttributes as `attr:${K}`]?: XplTableAttributes[K] } & { [K in keyof XplTable & keyof XplTableAttributes as `prop:${K}`]?: XplTable[K] };
-        "xpl-table-body": XplTableBody;
-        "xpl-table-cell": Omit<XplTableCell, keyof XplTableCellAttributes> & { [K in keyof XplTableCell & keyof XplTableCellAttributes]?: XplTableCell[K] } & { [K in keyof XplTableCell & keyof XplTableCellAttributes as `attr:${K}`]?: XplTableCellAttributes[K] } & { [K in keyof XplTableCell & keyof XplTableCellAttributes as `prop:${K}`]?: XplTableCell[K] };
-        "xpl-table-footer": XplTableFooter;
-        "xpl-table-footer-cell": Omit<XplTableFooterCell, keyof XplTableFooterCellAttributes> & { [K in keyof XplTableFooterCell & keyof XplTableFooterCellAttributes]?: XplTableFooterCell[K] } & { [K in keyof XplTableFooterCell & keyof XplTableFooterCellAttributes as `attr:${K}`]?: XplTableFooterCellAttributes[K] } & { [K in keyof XplTableFooterCell & keyof XplTableFooterCellAttributes as `prop:${K}`]?: XplTableFooterCell[K] };
         "xpl-table-header": XplTableHeader;
         "xpl-table-header-cell": Omit<XplTableHeaderCell, keyof XplTableHeaderCellAttributes> & { [K in keyof XplTableHeaderCell & keyof XplTableHeaderCellAttributes]?: XplTableHeaderCell[K] } & { [K in keyof XplTableHeaderCell & keyof XplTableHeaderCellAttributes as `attr:${K}`]?: XplTableHeaderCellAttributes[K] } & { [K in keyof XplTableHeaderCell & keyof XplTableHeaderCellAttributes as `prop:${K}`]?: XplTableHeaderCell[K] };
-        "xpl-table-row": Omit<XplTableRow, keyof XplTableRowAttributes> & { [K in keyof XplTableRow & keyof XplTableRowAttributes]?: XplTableRow[K] } & { [K in keyof XplTableRow & keyof XplTableRowAttributes as `attr:${K}`]?: XplTableRowAttributes[K] } & { [K in keyof XplTableRow & keyof XplTableRowAttributes as `prop:${K}`]?: XplTableRow[K] };
         "xpl-tabs": Omit<XplTabs, keyof XplTabsAttributes> & { [K in keyof XplTabs & keyof XplTabsAttributes]?: XplTabs[K] } & { [K in keyof XplTabs & keyof XplTabsAttributes as `attr:${K}`]?: XplTabsAttributes[K] } & { [K in keyof XplTabs & keyof XplTabsAttributes as `prop:${K}`]?: XplTabs[K] };
         "xpl-tag": Omit<XplTag, keyof XplTagAttributes> & { [K in keyof XplTag & keyof XplTagAttributes]?: XplTag[K] } & { [K in keyof XplTag & keyof XplTagAttributes as `attr:${K}`]?: XplTagAttributes[K] } & { [K in keyof XplTag & keyof XplTagAttributes as `prop:${K}`]?: XplTag[K] };
         "xpl-toast": Omit<XplToast, keyof XplToastAttributes> & { [K in keyof XplToast & keyof XplToastAttributes]?: XplToast[K] } & { [K in keyof XplToast & keyof XplToastAttributes as `attr:${K}`]?: XplToastAttributes[K] } & { [K in keyof XplToast & keyof XplToastAttributes as `prop:${K}`]?: XplToast[K] };
@@ -6340,20 +6058,8 @@ declare module "@stencil/core" {
             "xpl-dropdown-group": LocalJSX.IntrinsicElements["xpl-dropdown-group"] & JSXBase.HTMLAttributes<HTMLXplDropdownGroupElement>;
             "xpl-dropdown-heading": LocalJSX.IntrinsicElements["xpl-dropdown-heading"] & JSXBase.HTMLAttributes<HTMLXplDropdownHeadingElement>;
             "xpl-dropdown-option": LocalJSX.IntrinsicElements["xpl-dropdown-option"] & JSXBase.HTMLAttributes<HTMLXplDropdownOptionElement>;
-            /**
-             * @deprecated Use the compositional `<xpl-table>` API instead.
-             * This component will be removed in a future major release.
-             */
             "xpl-dynamic-table": LocalJSX.IntrinsicElements["xpl-dynamic-table"] & JSXBase.HTMLAttributes<HTMLXplDynamicTableElement>;
-            /**
-             * @deprecated Use `<xpl-table-cell>` instead.
-             * This component will be removed in a future major release.
-             */
             "xpl-dynamic-table-cell": LocalJSX.IntrinsicElements["xpl-dynamic-table-cell"] & JSXBase.HTMLAttributes<HTMLXplDynamicTableCellElement>;
-            /**
-             * @deprecated Use `<xpl-table-row>` instead.
-             * This component will be removed in a future major release.
-             */
             "xpl-dynamic-table-row": LocalJSX.IntrinsicElements["xpl-dynamic-table-row"] & JSXBase.HTMLAttributes<HTMLXplDynamicTableRowElement>;
             "xpl-grid": LocalJSX.IntrinsicElements["xpl-grid"] & JSXBase.HTMLAttributes<HTMLXplGridElement>;
             "xpl-grid-item": LocalJSX.IntrinsicElements["xpl-grid-item"] & JSXBase.HTMLAttributes<HTMLXplGridItemElement>;
@@ -6413,17 +6119,9 @@ declare module "@stencil/core" {
             "xpl-spotlight": LocalJSX.IntrinsicElements["xpl-spotlight"] & JSXBase.HTMLAttributes<HTMLXplSpotlightElement>;
             "xpl-tab": LocalJSX.IntrinsicElements["xpl-tab"] & JSXBase.HTMLAttributes<HTMLXplTabElement>;
             "xpl-tab-panel": LocalJSX.IntrinsicElements["xpl-tab-panel"] & JSXBase.HTMLAttributes<HTMLXplTabPanelElement>;
-            /**
-             * Compositional tables use CSS grid on the host (`role="grid"`). Legacy mode uses a `<table>`.
-             */
             "xpl-table": LocalJSX.IntrinsicElements["xpl-table"] & JSXBase.HTMLAttributes<HTMLXplTableElement>;
-            "xpl-table-body": LocalJSX.IntrinsicElements["xpl-table-body"] & JSXBase.HTMLAttributes<HTMLXplTableBodyElement>;
-            "xpl-table-cell": LocalJSX.IntrinsicElements["xpl-table-cell"] & JSXBase.HTMLAttributes<HTMLXplTableCellElement>;
-            "xpl-table-footer": LocalJSX.IntrinsicElements["xpl-table-footer"] & JSXBase.HTMLAttributes<HTMLXplTableFooterElement>;
-            "xpl-table-footer-cell": LocalJSX.IntrinsicElements["xpl-table-footer-cell"] & JSXBase.HTMLAttributes<HTMLXplTableFooterCellElement>;
             "xpl-table-header": LocalJSX.IntrinsicElements["xpl-table-header"] & JSXBase.HTMLAttributes<HTMLXplTableHeaderElement>;
             "xpl-table-header-cell": LocalJSX.IntrinsicElements["xpl-table-header-cell"] & JSXBase.HTMLAttributes<HTMLXplTableHeaderCellElement>;
-            "xpl-table-row": LocalJSX.IntrinsicElements["xpl-table-row"] & JSXBase.HTMLAttributes<HTMLXplTableRowElement>;
             "xpl-tabs": LocalJSX.IntrinsicElements["xpl-tabs"] & JSXBase.HTMLAttributes<HTMLXplTabsElement>;
             "xpl-tag": LocalJSX.IntrinsicElements["xpl-tag"] & JSXBase.HTMLAttributes<HTMLXplTagElement>;
             "xpl-toast": LocalJSX.IntrinsicElements["xpl-toast"] & JSXBase.HTMLAttributes<HTMLXplToastElement>;