@xplortech/apollo-core 2.7.0 → 2.8.0

package/.typings/apollo-components.html-data.json

@@ -590,7 +590,7 @@
       "name": "xpl-checkbox",
       "description": {
         "kind": "markdown",
-        "value": "Checkboxes allow users to make selections or choices. Checkboxes can be multi-select, and also act as controls.\r\n\r\nProvide visible label text in the default slot, or set `aria-label` when the checkbox has no adjacent label (for example, icon-only toolbars or table selection cells)."
+        "value": "Checkboxes allow users to make selections or choices. Checkboxes can be multi-select, and also act as controls.\n\nProvide visible label text in the default slot, or set `aria-label` when the checkbox has no adjacent label (for example, icon-only toolbars or table selection cells)."
       },
       "attributes": [
         {
@@ -820,6 +820,48 @@
             }
           ]
         },
+        {
+          "name": "placement",
+          "description": "Floating UI placement when `anchorToTrigger` is true (e.g. `bottom-start`, `top-start`).",
+          "values": [
+            {
+              "name": "bottom"
+            },
+            {
+              "name": "bottom-end"
+            },
+            {
+              "name": "bottom-start"
+            },
+            {
+              "name": "left"
+            },
+            {
+              "name": "left-end"
+            },
+            {
+              "name": "left-start"
+            },
+            {
+              "name": "right"
+            },
+            {
+              "name": "right-end"
+            },
+            {
+              "name": "right-start"
+            },
+            {
+              "name": "top"
+            },
+            {
+              "name": "top-end"
+            },
+            {
+              "name": "top-start"
+            }
+          ]
+        },
         {
           "name": "select-on-focus",
           "description": "whether selection should be made when focusing on interactive element"
@@ -897,7 +939,7 @@
       "name": "xpl-dynamic-table",
       "description": {
         "kind": "markdown",
-        "value": "> **Note:** This component is currently in beta. Use with caution as it may have breaking changes in future releases.\r\n\r\nThe Dynamic Table is a rich content table that can accommodate multiple types of data."
+        "value": "> **Note:** This component is currently in beta. Use with caution as it may have breaking changes in future releases.\n\nThe Dynamic Table is a rich content table that can accommodate multiple types of data."
       },
       "attributes": []
     },
@@ -2027,19 +2069,23 @@
         },
         {
           "name": "name",
-          "description": "The name attribute for the html input.\n(submittted in form as name/value pair)"
+          "description": "The name attribute for the html input.\n(submitted in form as name/value pair)"
         },
         {
           "name": "required",
           "description": "Whether the input is required"
         },
+        {
+          "name": "selected-value",
+          "description": "The currently selected value for the radio group this radio belongs to.\n\nWhen set, the radio renders as checked when `selectedValue` equals its\nown `value` prop. Use this to drive radio-group selection from a single\nsource of truth — e.g. Vue `v-model` on a shared `selectedValue` across\nevery radio in a group, where each radio still declares its own `value`.\n\nFalls back to the boolean `checked` prop when not set."
+        },
         {
           "name": "styled",
           "description": "Whether the input is contained in a box with a border and, in disabled\nstate, a background"
         },
         {
           "name": "value",
-          "description": "The value attribute for the radio input.\n(submittted in form as name/value pair)"
+          "description": "The value attribute for the radio input.\n(submitted in form as name/value pair)"
         }
       ]
     },
@@ -2074,6 +2120,48 @@
           "name": "disabled",
           "description": "Whether the field is disabled"
         },
+        {
+          "name": "dropdown-placement",
+          "description": "Initial Floating UI placement for the options panel (e.g. `top-start`, `bottom-start`).\nForwarded to the inner `xpl-dropdown` when the menu is open.",
+          "values": [
+            {
+              "name": "bottom"
+            },
+            {
+              "name": "bottom-end"
+            },
+            {
+              "name": "bottom-start"
+            },
+            {
+              "name": "left"
+            },
+            {
+              "name": "left-end"
+            },
+            {
+              "name": "left-start"
+            },
+            {
+              "name": "right"
+            },
+            {
+              "name": "right-end"
+            },
+            {
+              "name": "right-start"
+            },
+            {
+              "name": "top"
+            },
+            {
+              "name": "top-end"
+            },
+            {
+              "name": "top-start"
+            }
+          ]
+        },
         {
           "name": "error",
           "description": "If an empty string (attribute present with no value),\nwill display visually as an error. If a string is\nincluded, will display visually as an error and include\nthe value as an error message."
@@ -2429,120 +2517,24 @@
       "name": "xpl-table",
       "description": {
         "kind": "markdown",
-        "value": "Compositional tables use CSS grid on the host (`role=\"grid\"`). Legacy mode uses a `<table>`."
+        "value": "Tables are used to organize and display information from a data set."
       },
       "attributes": [
         {
           "name": "freeze",
-          "description": "When true, the first **data** column (per row) is sticky during horizontal scroll.\nLeading compositional columns are skipped: `selectable` (checkbox) and/or `row-reorderable`\n(grip) are not frozen so they scroll with the grid; the next column stays pinned at `left: 0`."
+          "description": "When true, the first column of the table is sticky and will cover the leftmost rows in a horizontally scrollable container."
         },
         {
           "name": "is-sortable",
-          "description": ""
-        },
-        {
-          "name": "label",
-          "description": "Accessible label for the table. Maps to `aria-label` in compositional mode."
+          "description": "Toggles to show the sort button on each table head"
         },
         {
           "name": "multiselect",
-          "description": ""
-        },
-        {
-          "name": "reorder-handle-icon",
-          "description": "Icon name for the optional `xpl-icon` inside each **managed** reorder grip when the row is **not** in\nkeyboard reorder mode (pointer / idle). Set to `\"\"` to omit the icon so you can style the button or author a\nfully custom reorder column in markup. When omitted, defaults to `grip-dots-vertical`."
-        },
-        {
-          "name": "reorder-handle-icon-keyboard",
-          "description": "Icon name for the managed reorder grip **while that row is in keyboard reorder mode** (after the user\nactivates the grip with Enter or Space). Use a different icon than `reorder-handle-icon` so users can see\nthey should use arrow keys. When omitted, defaults to `caret-expand-y` (same as `xpl-list` keyboard reorder).\nSet to `\"\"` to show no icon in keyboard mode only (combine with CSS on\n`.xpl-table__row-drag-handle--keyboard-mode` if needed)."
-        },
-        {
-          "name": "row-reorderable",
-          "description": "When true (compositional mode only), **prepends** a managed reorder column as the **first** grid\ncolumn (empty header + grip button per body row) and enables HTML5 drag-and-drop row reordering\n(same interaction model as `xpl-list`). With `selectable`, DOM order is **reorder | selection |\ndata** unless you author a custom reorder column. The table updates the DOM and emits\n`rowOrderChange`; consumers should persist order if needed. Ignored in legacy `columns`/`data` mode."
-        },
-        {
-          "name": "selectable",
-          "description": "When true (compositional mode only), enables row selection state, the selection toolbar\n(“N Selected”), and `rowSelectionChange`. **You must add the selection column in your\nmarkup:** a header cell with `type=\"checkbox\"`, a body cell containing `xpl-checkbox` per row\n(aligned with that column), and matching `xpl-table-footer-cell` cells when you use a footer.\nEach body row should use `row-id` on `xpl-table-row` (or accept auto-generated ids) so\n`rowSelectionChange` can report `selectedRowIds`.\n\nThe toolbar uses the same layout as `xpl-toolbar` and is visible only while at least one row\nis selected. Use `toolbar-actions-left` / `toolbar-actions-right` slots on this host for bulk\nactions."
+          "description": "Toggles a selectable checkbox for each row in the table"
         },
         {
           "name": "striped",
-          "description": "Toggles an optional styling of the background of each even row of the\ntable body."
-        }
-      ]
-    },
-    {
-      "name": "xpl-table-body",
-      "description": {
-        "kind": "markdown",
-        "value": ""
-      },
-      "attributes": []
-    },
-    {
-      "name": "xpl-table-cell",
-      "description": {
-        "kind": "markdown",
-        "value": "Body cell for compositional [`xpl-table`](../readme.md). Place content in the default slot; use `align`, `bold`, and `underline` for typography. Interactive controls inside the cell inherit `disabled` when the parent [`xpl-table-row`](../xpl-table-row) is disabled."
-      },
-      "attributes": [
-        {
-          "name": "align",
-          "description": "Horizontal text alignment within the cell.",
-          "values": [
-            {
-              "name": "center"
-            },
-            {
-              "name": "left"
-            },
-            {
-              "name": "right"
-            }
-          ]
-        },
-        {
-          "name": "bold",
-          "description": "Renders cell text in bold (--xpl-font-weight-semibold)."
-        },
-        {
-          "name": "disabled",
-          "description": "Whether the cell and its interactive children are disabled. Set automatically by xpl-table-row."
-        },
-        {
-          "name": "underline",
-          "description": "Adds an underline to cell text."
-        }
-      ]
-    },
-    {
-      "name": "xpl-table-footer",
-      "description": {
-        "kind": "markdown",
-        "value": ""
-      },
-      "attributes": []
-    },
-    {
-      "name": "xpl-table-footer-cell",
-      "description": {
-        "kind": "markdown",
-        "value": ""
-      },
-      "attributes": [
-        {
-          "name": "align",
-          "description": "Horizontal text alignment within the cell.",
-          "values": [
-            {
-              "name": "center"
-            },
-            {
-              "name": "left"
-            },
-            {
-              "name": "right"
-            }
-          ]
+          "description": "Toggles an optional styling of the background of each even row of the table body."
         }
       ]
     },
@@ -2550,7 +2542,7 @@
       "name": "xpl-table-header",
       "description": {
         "kind": "markdown",
-        "value": "Semantic wrapper for the header **row group** in a compositional `xpl-table` (`role=\"rowgroup\"`). Place one `xpl-table-row` (with `xpl-table-header-cell` children) inside.\r\n\r\n> **Note:** This component is currently in beta. Use with caution as it may have breaking changes in future releases."
+        "value": "Component parts used to assemble the Dynamic Table.\n\n> **Note:** This component is currently in beta. Use with caution as it may have breaking changes in future releases."
       },
       "attributes": []
     },
@@ -2558,78 +2550,28 @@
       "name": "xpl-table-header-cell",
       "description": {
         "kind": "markdown",
-        "value": "> **Note:** This component is currently in beta. Use with caution as it may have breaking changes in future releases.\r\n\r\nThe `icon` property accepts icon names as strings. See [xpl-icon available icons](../xpl-icon/ICONS.md) for the complete list.\r\n\r\nWhen this cell is used inside a compositional [`xpl-table`](../xpl-table) with `selectable`, **you** add a `type=\"checkbox\"` header cell for select-all; `xpl-table` keeps `checked` and `indeterminate` in sync with row selection.\r\n\r\nFor **sortable** columns (`type=\"label\"`), set **`sortable`** and optionally **`sort-key`**; the parent table emits **`sortChanged`** (see [`xpl-table` events](../xpl-table#events)).\r\n\r\n**Column width (compositional grid):** Each header cell defines one grid column on the parent `xpl-table`. By default the track is **`auto`** (sizes from content). Set **`width`** for a fixed pixel width (minimum 48px), or **`column-width`** for any CSS grid track string (`1fr`, `minmax(120px, 1fr)`, etc.). When both are set, **`column-width` wins**.\r\n\r\n---"
+        "value": "> **Note:** This component is currently in beta. Use with caution as it may have breaking changes in future releases.\n\nThe `icon` property accepts icon names as strings. See [xpl-icon available icons](../xpl-icon/ICONS.md) for the complete list.\n\n---"
       },
       "attributes": [
-        {
-          "name": "align",
-          "description": "Horizontal text alignment within the header cell.",
-          "values": [
-            {
-              "name": "center"
-            },
-            {
-              "name": "left"
-            },
-            {
-              "name": "right"
-            }
-          ]
-        },
-        {
-          "name": "checkbox-aria-label",
-          "description": "Accessible name for the header checkbox (native `aria-label`).\nDefaults to “Select all rows” when `type` is `checkbox`."
-        },
-        {
-          "name": "checked",
-          "description": "Whether the header checkbox is checked"
-        },
-        {
-          "name": "column-width",
-          "description": "CSS grid track size for this column (e.g. `1fr`, `minmax(120px, 1fr)`, `auto`). When set, overrides `width`.\nUse this when you need flexible columns; default layout uses `auto` per column unless you set a track here."
-        },
         {
           "name": "icon",
           "description": "Icon to display in the cell.\n\nSee [xpl-icon available icons](../xpl-icon/ICONS.md) for valid icon names."
         },
-        {
-          "name": "indeterminate",
-          "description": "Whether the checkbox is in indeterminate (partially selected) state"
-        },
         {
           "name": "label",
-          "description": "Text to display in the cell."
-        },
-        {
-          "name": "sort-direction",
-          "description": "Active sort direction for this column when `sortable`. Set by `xpl-table` when used inside\na compositional table; may be set by the app for controlled updates.",
-          "values": [
-            {
-              "name": "asc"
-            },
-            {
-              "name": "desc"
-            }
-          ]
-        },
-        {
-          "name": "sort-key",
-          "description": "When `sortable` is true, optional stable id used as the key in `sortChanged`’s detail object.\nFalls back to a slug of `label` when omitted."
+          "description": ""
         },
         {
           "name": "sortable",
-          "description": "When true (and `type` is `label`), renders a sort control (button + affordance icon)."
+          "description": ""
         },
         {
           "name": "type",
-          "description": "The type of cell to render.",
+          "description": "",
           "values": [
             {
               "name": "checkbox"
             },
-            {
-              "name": "empty"
-            },
             {
               "name": "icon"
             },
@@ -2640,28 +2582,7 @@
         },
         {
           "name": "width",
-          "description": "Fixed width for this column in pixels (minimum 48px). Sets the grid track to `Npx`.\nIgnored when `columnWidth` is set. When omitted, the column track defaults to `auto` (content-sized)."
-        }
-      ]
-    },
-    {
-      "name": "xpl-table-row",
-      "description": {
-        "kind": "markdown",
-        "value": ""
-      },
-      "attributes": [
-        {
-          "name": "disabled",
-          "description": "Whether the row and its cells are disabled."
-        },
-        {
-          "name": "row-id",
-          "description": "Stable identifier for this row when used with a selectable compositional\n`xpl-table`. If omitted, the parent table assigns a unique id."
-        },
-        {
-          "name": "selected",
-          "description": "Whether the row is visually selected."
+          "description": ""
         }
       ]
     },
@@ -2804,7 +2725,7 @@
         },
         {
           "name": "name",
-          "description": "The name attribute for the html input.\n(submittted in form as name/value pair)"
+          "description": "The name attribute for the html input.\n(submitted in form as name/value pair)"
         },
         {
           "name": "variant",