@adyen/bento-mcp 0.0.0 → 0.1.0

package/dist/assets/components/data-grid/components/data-grid-row/data-grid-row.vue

@@ -0,0 +1 @@
+<template> <div class="b-data-grid-row-container" role="presentation"> <div v-bind="ariaRowAttributes" :id="rowId?.toString()" :key="rowIndex" class="b-data-grid-row-container__row" :class="conditionalRowClasses(rowData, rowIndex)" role="row" :aria-selected="getRowAriaSelectedValue(rowData)" @click="onRowClick" @keyup.enter="onRowClick" @keyup.space="onRowClick" > <template v-for="({ columnSet, id, isFrozenColumns }, columnSetIndex) of columnSets"> <div v-if="columnSet?.length" :key="`data-grid-rows-${id}`" class="b-data-grid-row-container__cells" :class="conditionalRowSetClasses(isFrozenColumns, isSmallContainer)" :data-testid="`data-grid-${id}-rows`" > <data-grid-cell v-for="(column, colIndex) in columnSet" :key="`cell-${column.field}`" :ref="el => registerRowCellRef(el, column.field)" class="b-data-grid-row-container__cell" :column="column" :column-set-index="columnSetIndex" :col-index="colIndex" :column-sets="columnSets" :condensed="condensed" :dragging-columns="draggingColumns" :dragging-events-for-row-cell="draggingEventsForRowCell" :get-data-item-id="getDataItemId" :has-zebra-background="isRowEven" :is-highlighted="isHighlightedRow(rowData)" :is-selected="isSelectedRow(rowData)" :hovered-over-column-state="hoveredOverColumnState" :is-data-item-disabled="isDataItemDisabled" :is-measuring-column-widths="isMeasuringColumnWidths" :is-nested-content-expanded="isNestedContentShown" :nested-content="shouldShowNestedContentToggle" :nested-rows-element-ids="allNestedRowIds" :row-data="rowData" :row-index="rowIndex" :selection-is-indeterminate="hasUnSelectedNestedRows" :selectable="selectable" :selected-items="selectedItems" @cell-hovered="emit('cell-hovered', $event)" @cell-focus="emit('cell-focus', $event)" @on-frozen-columns-key-press="emit('on-frozen-columns-key-press', $event)" @select-row="onRowSelect" @nested-content-toggled="nestedContentToggled" > <template v-for="(_, innerSlot) of slots" #[innerSlot]="scope"> <slot :name="innerSlot" v-bind="scope" /> </template> </data-grid-cell> </div> <div v-if="!isFrozenColumns && rowActions" :key="`data-grid-row-actions-${id}`" ref="rowActionsRef" :aria-colindex="sumColumnAmountsInColumnSets().toString()" class="b-data-grid-row-container__row-actions-container" :class="conditionalRowActionsContainerClasses" :style="computedRowActionsStyles" :data-cellindex="getRowActionsCellIndex()" tabindex="-1" role="gridcell" @focus="onRowActionsCellFocus" @focusOut="onRowActionsCellFocusOut" @keydown="onRowActionsCellOnKeyDown" > <data-grid-cell-actions class="b-data-grid-row-container__row-actions" disable-arrow-down-opening-menu :cell-actions="rowActions" :has-right-overflow="hasRightOverflow" :row-data-item="rowData" teleport-menu @menu-open="onRowActionMenuOpen" @menu-close="onRowActionMenuClose" /> </div> </template> </div> <Transition v-if=" (hasNestedContent && hasSlot('nested-slot') && shouldShowNestedContent(rowData)) || (hasNestedRows && shouldShowNestedRowsBooleanResult) " :key="`${rowIndex}-nest-content`" name="b-data-grid-row-container__animation--nested-content" > <div v-if="isNestedContentShown && shouldShowRenderNestedRows" :class="conditionalNestedRowClasses" data-testid="nested-content-container" :style="nestedContentStyles" role="presentation" > <div ref="nestedContentRef"> <div v-if="isLoadingNestedRows" class="b-data-grid-row-container__row-nested-rows-loading-container" > <bento-loading-indicator /> </div> <data-grid-row v-for="(childRowData, childRowIndex) in rowData.children" v-bind="props" :id="getRowId(childRowIndex)" :key="`child-${childRowIndex}`" :row-data="childRowData" :row-index="childRowIndex" :row-set-size="rowData.children.length" is-nested-row @cell-hovered="emit('cell-hovered', $event)" @cell-focus="emit('cell-focus', $event)" @row-click="emit('row-click', ...$event)" @on-frozen-columns-key-press="emit('on-frozen-columns-key-press', $event)" @select-row="onNestedRowSelect(childRowData, $event)" > <template v-for="(_, innerSlot) of slots" #[innerSlot]="scope"> <slot :name="innerSlot" v-bind="scope" /> </template> </data-grid-row> </div> </div> <div v-else-if="isNestedContentShown" v-bind="nestedContentContainerDivAriaAttributes" :class="conditionalNestedRowClasses" data-testid="nested-content-container" :style="nestedContentStyles" role="row" tabindex="-1" > <div ref="nestedContentRef" role="gridcell"> <div v-if="isLoadingNestedRows" class="b-data-grid-row-container__row-nested-rows-loading-container" > <bento-loading-indicator /> </div> <div v-else-if="hasSlot('nested-slot') && shouldShowNestedContent(rowData)"> <slot :item="rowData" name="nested-slot" /> </div> </div> </div> </Transition> </div> </template> <script setup lang="ts"> import { type ComponentPublicInstance, computed, type ComputedRef, inject, onMounted, type PropType, ref, useSlots, watch, } from 'vue'; import { BentoLoadingIndicator } from '@/components/loading-indicator'; import { focusOnInteractiveChild, makeAllInteractiveChildrenFocusable, makeAllInteractiveChildrenUnFocusable, } from '@/components/data-grid/utils'; import DataGridRow from '@/components/data-grid/components/data-grid-row/data-grid-row.vue'; import DataGridCell from '@/components/data-grid/components/data-grid-cell/data-grid-cell.vue'; import DataGridCellActions from '@/components/data-grid/components/data-grid-cell-actions/data-grid-cell-actions.vue'; // Types and enums import { type BentoColumn, type BentoDatagridDataItem, type BentoDatagridDataItemId, type BentoDatagridGetDataItemIdFn, type BentoDatagridIsDataItemDisabledFn, type BentoDatagridShouldShowNestedContentFn, type BentoDatagridShouldShowNestedRowsFn, BentoDatagridStyleState, } from '@/components/data-grid/data-grid.types'; import type { DataGridCellColumnSet, DataGridCellDragEventsForColumn, } from '../data-grid-cell/data-grid-cell.types'; import type { BentoDatagridDraggingColumnState } from '../data-grid-columns/data-grid-columns.types'; import type { DatagridColumnHoveringState } from '@/components/data-grid/composables/use-column-hovering'; // Translations import { type Booleanish } from '@/types/prop-types'; import { useHasSlot } from '@/composables/use-has-slot/use-has-slot'; import { useExpandableContentHeight } from '@/composables/use-expandable-content-height/use-expandable-content-height'; import { observeSizeOfElement } from '@/utils/ts/resize'; import { DATAGRID_ACTIONS_COLUMN_FIELD_NAME, DATAGRID_CELL_OFFSET_PADDING, } from '@/components/data-grid/composables/use-calculate-column-width/use-calculate-column-width'; import { generateUid } from '@/core/utils/ts'; import { type BentoDataGridRowActionsProp } from '@/components/data-grid/components/data-grid-cell-actions/data-grid-cell-actions.types'; import type { HTMLAttributes } from 'vue/types/jsx'; import { EventKey } from '@/types/utils-events'; import { DATA_GRID_SMALL_CONTAINER } from '@/components/data-grid/data-grid.keys'; const slots = useSlots(); const hasSlot = useHasSlot(slots); const props = defineProps({ /** * Row actions property that generates which button to show in row actions area */ rowActions: { type: [Function, Array] as PropType<BentoDataGridRowActionsProp>, default: undefined, }, /** * When true, will emit a 'rowClick' event when a row is clicked. Will add cursor: pointer to rows. */ allowRowClicks: { type: Boolean, default: false }, /** * The columns sets including */ columnSets: { type: Array as PropType<Array<DataGridCellColumnSet>>, required: true, }, /** * Sets the row cells to the condensed padding state. */ condensed: { type: Boolean, default: false, }, /** * Columns being dragged, contains dragging column and a target column */ draggingColumns: { type: Object as PropType<BentoDatagridDraggingColumnState>, default: undefined, }, /** * Dragging event handlers for each row cell */ draggingEventsForRowCell: { type: Function as PropType<DataGridCellDragEventsForColumn>, required: true, }, /** * A customisable method to retrieve a unique identifier for a data item in the array of data supplied. * This is used selecting and performance reasons and must exist in each data item. */ getDataItemId: { type: Function as PropType<BentoDatagridGetDataItemIdFn>, default: (item: BentoDatagridDataItem) => item.id, }, /** * Set to true if the datagrid has been scrolled and the left side has overflowing space. */ hasLeftOverflow: { type: Boolean, default: false, }, /** * Enables the nested content slot functionality. */ hasNestedContent: { type: Boolean, default: false, }, /** * Enables the nested content slot functionality. */ hasNestedRows: { type: Boolean, default: false, }, /** * Set to true if the datagrid has been scrolled and the right side has overflowing space. */ hasRightOverflow: { type: Boolean, default: false, }, /** * Highlighted row IDs. */ highlightedRows: { type: Array as PropType<Array<BentoDatagridDataItemId>>, default: () => [], }, /** * The row index of a currently hovered row. */ hoveredRowIndex: { type: Number, default: -1, }, /** * The column hovered over state and whether the hovered over column should show a border right or left. */ hoveredOverColumnState: { type: Object as PropType<DatagridColumnHoveringState>, required: true, }, /** * A customisable method to determine if a row is not selectable. * The default is that every row is selectable. */ isDataItemDisabled: { type: Function as PropType<BentoDatagridIsDataItemDisabledFn>, default: () => false, }, /** * If the row is of an even number. * Rows are 0th based index e.g. index 0 is an odd-numbered row. */ isRowEven: { type: Boolean, default: false, }, /** * If the row is the last child in it's parent container. */ isRowLastChild: { type: Boolean, default: false, }, /** * If columns are being measured for the autoWidth functionality. */ isMeasuringColumnWidths: { type: Boolean, default: false, }, /** * Determines if this row is nested inside another row. */ isNestedRow: { type: Boolean, default: false, }, /** * The maximum width of the row actions in all rows */ rowActionsMaximumWidth: { type: Number, default: 0, }, /** * The row data object */ rowData: { type: Object as PropType<BentoDatagridDataItem>, required: true, }, /** * The row index. */ rowIndex: { type: Number, required: true, }, /** * The row ID to be using for the ID attribute. */ rowId: { type: Number, default: undefined, }, /** * The number of rows that this row is within. */ rowSetSize: { type: Number, default: 0, }, /** * Determines whether to render frozen seperator on the row. */ showFrozenColumnsSeparator: { type: Boolean, default: false, }, /** * Determines if the row selection is enabled. */ selectable: { type: Boolean, default: false, }, /** * The array of IDs for the selected rows. */ selectedItems: { type: Array as PropType<Array<BentoDatagridDataItemId>>, required: true, }, /** * Enables / Disables the nested-content slot */ shouldShowNestedContent: { type: Function as PropType<BentoDatagridShouldShowNestedContentFn>, default: (_item: BentoDatagridDataItem) => true, }, /** * Returns the nested rows for a given BentoDatagridDataItem. */ shouldShowNestedRows: { type: Function as PropType<BentoDatagridShouldShowNestedRowsFn>, default: (_item: BentoDatagridDataItem) => true, }, }); const emit = defineEmits<{ /** * Emitted when a cell has been hovered over. This is used to keep the row in a hovered state when hovering over a menu. */ (e: 'cell-hovered', value: number); /** * Emitted when an a frozen column cell fires a key up or down event. */ (e: 'on-frozen-columns-key-press', event: Event); /** * Emitted when a row has been selected. */ (e: 'select-row', value: Array<BentoDatagridDataItemId>, rowData: BentoDatagridDataItem); /** * Emitted when a nested row has been selected. */ ( e: 'select-nested-row', value: Array<BentoDatagridDataItemId>, parentRowData: BentoDatagridDataItem, rowData: BentoDatagridDataItem ); /** * Emitted when a row has been clicked. */ (e: 'row-click', rowData: BentoDatagridDataItem, event: MouseEvent | KeyboardEvent); /** * Emitted when a row with nested content is toggled */ (e: 'nested-content-toggled', rowData: BentoDatagridDataItem); /** * Emitted when a row cell is focused. */ ( e: 'cell-focus', value: { rowData: BentoDatagridDataItem; column: BentoColumn; rowIndex: number; colIndex: number } ); }>(); // Refs const gridcellRefs = ref<{ [key: string]: HTMLDivElement }>({}); const isNestedContentShown = ref(false); const nestedContentRef = ref(); const rowActionsRef = ref(); const nestedContentSlotId = generateUid('nested-content-slot'); const isRowActionMenuOpen = ref(false); const focusableItems = ref<Array<{ node: HTMLElement }>>(); onMounted(() => { if (rowActionsRef.value) { focusableItems.value = makeAllInteractiveChildrenUnFocusable(rowActionsRef.value); } }); const shouldShowNestedRowsBooleanResult = computed(() => props.shouldShowNestedRows(props.rowData)); const shouldShowRenderNestedRows = computed( () => !props.isNestedRow && props.hasNestedRows && shouldShowNestedRowsBooleanResult.value && props.rowData?.children?.length > 0 ); const isLoadingNestedRows = computed( () => !props.isNestedRow && props.hasNestedRows && shouldShowNestedRowsBooleanResult.value && (props.rowData?.children === undefined || props?.rowData?.children.length === 0) ); const shouldShowNestedContentToggle = computed( () => (props.hasNestedContent && props.shouldShowNestedContent(props.rowData)) || (props.hasNestedRows && shouldShowNestedRowsBooleanResult.value && !props.isNestedRow) ); const ariaRowAttributes = computed<HTMLAttributes>(() => { if (props.hasNestedContent || props.hasNestedRows) { const isNestedContentShownBooleanishVal = isNestedContentShown.value.toString() as Booleanish; return { 'aria-expanded': shouldShowNestedContentToggle.value ? isNestedContentShownBooleanishVal : undefined, 'aria-level': props.isNestedRow ? '2' : '1', 'aria-posinset': props.rowIndex + 1, 'aria-setsize': props.rowSetSize, }; } return { 'aria-rowindex': props.rowIndex + 1 }; }); const nestedContentContainerDivAriaAttributes = computed<HTMLAttributes>(() => { if (isLoadingNestedRows.value) { return { 'aria-busy': 'true', 'aria-live': 'polite', }; } if ( shouldShowRenderNestedRows.value || !props.hasNestedContent || !props.shouldShowNestedContent(props.rowData) ) { return undefined; } return { 'aria-level': props.isNestedRow ? '3' : '2', 'aria-posinset': '1', 'aria-setsize': '1', id: nestedContentSlotId, role: 'row', tabindex: '-1', }; }); const nestedRowIds = computed(() => { if (shouldShowRenderNestedRows.value) { return props.rowData?.children?.reduce((acc, _val, index) => { acc[index] = generateUid('nested-row'); return acc; }, {}); } return []; }); const allNestedRowIds = computed(() => { if (!isNestedContentShown.value) { return undefined; } if (props.hasNestedContent && props.shouldShowNestedContent(props.rowData)) { return [nestedContentSlotId]; } if (shouldShowRenderNestedRows.value && Object.keys(nestedRowIds.value)?.length > 0) { const generatedRowIds = Object.values(nestedRowIds.value); if (generatedRowIds?.length > 0) { return generatedRowIds; } } return []; }); const hasUnSelectedNestedRows = computed(() => { const childrendDataItemIds = props.rowData?.children?.map(nestedItem => props.getDataItemId(nestedItem)); if (childrendDataItemIds?.length > 0) { const everyChildIsSelected = childrendDataItemIds.every(childId => props?.selectedItems?.includes(childId)); const someItemsAreSelected = childrendDataItemIds.some(childId => props?.selectedItems?.includes(childId)); return !everyChildIsSelected && someItemsAreSelected; } return false; }); // Methods const registerRowCellRef = (el: Element | ComponentPublicInstance, field: string) => { // We always know this will be used on a DataGridCell component so we can cast it const gridCellComponent = el as InstanceType<typeof DataGridCell>; if (el !== null && gridCellComponent?.gridcellRef) { gridcellRefs.value[field] = gridCellComponent.gridcellRef as HTMLDivElement; } }; const getRowId = (childRowIndex: number) => { return nestedRowIds.value[childRowIndex]; }; const getRowAriaSelectedValue = (row: BentoDatagridDataItem): Booleanish => { if (!props.selectable) { return null; } const id = props.getDataItemId(row); return props.selectedItems.includes(id).toString() as Booleanish; }; /** * Handles row clicks when the `allowRowClicks` prop is true. * * This method also prevents the `row-click` event from firing if the click * originated from an interactive element (like a button, input, or link) * within the row. This is to avoid unintended behavior when a user * interacts with controls inside a row. * * @param event The mouse or keyboard event from the click or key press. */ const onRowClick = (event: MouseEvent | KeyboardEvent) => { // Only proceed if allowRowClicks is true if (!props.allowRowClicks) { return; } let isEventTargetInteractiveElement = false; const dataGridRowInteractiveTypes = ['button', 'input', 'a']; for (let i = 0; i < dataGridRowInteractiveTypes.length; i++) { if ((event?.target as HTMLElement)?.closest(dataGridRowInteractiveTypes[i])) { isEventTargetInteractiveElement = true; break; } } // Only trigger if element is NOT interactive if (!isEventTargetInteractiveElement) { emit('row-click', props.rowData, event); } }; const onRowSelect = (value: Array<BentoDatagridDataItemId>) => { emit('select-row', value, props.rowData); }; const onNestedRowSelect = (rowData: BentoDatagridDataItem, value: Array<BentoDatagridDataItemId>) => { emit('select-nested-row', value, props.rowData, rowData); }; /** * Sets the state to indicate that a row action menu is open. This is used to apply a higher * z-index to the row's action container, ensuring the menu displays correctly above * subsequent rows. */ const onRowActionMenuOpen = () => { isRowActionMenuOpen.value = true; }; /** * Resets the state when a row action menu is closed, removing the elevated z-index from the * row's action container. */ const onRowActionMenuClose = () => { isRowActionMenuOpen.value = false; }; /** * When the row actions cell is focused, make the first interactive child focusable and focus it. * This allows for keyboard navigation into the cell's actions. */ const onRowActionsCellFocus = () => { makeAllInteractiveChildrenFocusable([focusableItems.value?.[0]]); focusOnInteractiveChild(rowActionsRef.value); }; /** * When focus leaves the row actions cell, make all interactive children unfocusable. * This ensures that tabbing through the grid skips over the individual actions within the cell. */ const onRowActionsCellFocusOut = () => { makeAllInteractiveChildrenUnFocusable(rowActionsRef.value); }; /** * Handles keyboard navigation within the row actions cell. * Allows using left and right arrow keys to move between interactive elements (e.g., buttons) in the cell. * @param e The keyboard event. */ const onRowActionsCellOnKeyDown = (e: KeyboardEvent) => { if (e.key !== EventKey.TAB) { makeAllInteractiveChildrenUnFocusable(rowActionsRef.value); } if ( e.key === EventKey.ARROW_RIGHT && focusableItems.value?.length > 1 && focusableItems.value[0].node === document.activeElement ) { makeAllInteractiveChildrenUnFocusable(rowActionsRef.value); focusableItems.value[1].node.setAttribute('tabindex', '0'); focusableItems.value[1].node.focus(); e.stopPropagation(); e.preventDefault(); } else if ( e.key === EventKey.ARROW_LEFT && focusableItems.value?.length > 1 && focusableItems.value[1].node === document.activeElement ) { makeAllInteractiveChildrenUnFocusable(rowActionsRef.value); focusableItems.value[0].node.setAttribute('tabindex', '0'); focusableItems.value[0].node.focus(); e.stopPropagation(); e.preventDefault(); } }; // Cell and Columns index calculation const sumColumnAmountsInColumnSets = () => props.columnSets.reduce((total, { columnSet }) => total + columnSet.length, 0); const getRowActionsCellIndex = () => sumColumnAmountsInColumnSets() * props.rowIndex + sumColumnAmountsInColumnSets(); // Nested content expanding logic const { updateContentHeight, contentHeight } = useExpandableContentHeight(nestedContentRef, isNestedContentShown); const nestedContentStyles = computed(() => { if (props.hasNestedContent || props.hasNestedRows) { // calculate the padding by getting the action column width and the first column left padding: const paddingLeft = shouldShowRenderNestedRows.value || isLoadingNestedRows.value ? 0 : gridcellRefs.value[DATAGRID_ACTIONS_COLUMN_FIELD_NAME].offsetWidth + DATAGRID_CELL_OFFSET_PADDING; return { paddingLeft: `${paddingLeft}px`, 'max-height': (props.hasNestedContent || props.hasNestedRows) && contentHeight.value && !contentHeight?.value?.includes('null') ? contentHeight.value : 0, }; } return undefined; }); watch( () => nestedContentRef.value, () => { let observer: ResizeObserver | null = null; if (!observer && nestedContentRef.value) { observer = observeSizeOfElement(nestedContentRef.value, () => { if (nestedContentRef.value) { updateContentHeight(); } }); } } ); const nestedContentToggled = () => { isNestedContentShown.value = !isNestedContentShown.value; updateContentHeight(); emit('nested-content-toggled', props.rowData); }; watch( () => props.rowData?.children, (_newChildren, oldChildren) => { if (props?.rowData?.children?.length > 0 && oldChildren === undefined && !isNestedContentShown.value) { updateContentHeight(); } } ); const isSmallContainer: ComputedRef<boolean> = inject( DATA_GRID_SMALL_CONTAINER, computed(() => false) ); const isHighlightedRow = row => props.highlightedRows.includes(props.getDataItemId(row)); const isSelectedRow = row => props.selectedItems.includes(props.getDataItemId(row)); // Styling const conditionalRowClasses = (row: BentoDatagridDataItem, rowIndex: number) => ({ 'b-data-grid-row-container__row--disabled': props.isDataItemDisabled(row), 'b-data-grid-row-container__row--row-clicks-enabled': props.allowRowClicks, 'b-data-grid-row-container__row--highlighted': isHighlightedRow(row), 'b-data-grid-row-container__row--selected': isSelectedRow(row), 'b-data-grid-row-container__row--hovered': props.hoveredRowIndex === rowIndex, 'b-data-grid-row-container__row--is-last-child': props.isRowLastChild && !isNestedContentShown.value, 'b-data-grid-row-container__row--nested-row': props.isNestedRow, 'b-data-grid-row-container__row--zebra': props.isRowEven, }); const conditionalRowSetClasses = (isFrozenRowSet: boolean, isSmallContainer: boolean) => ({ 'b-data-grid-row-container__row-cell-set--frozen': isFrozenRowSet && !isSmallContainer, [`b-data-grid-row-container__row-cell-set--${BentoDatagridStyleState.OVERFLOW_SHADOW_LEFT}`]: !isSmallContainer && isFrozenRowSet && props.hasLeftOverflow, 'b-data-grid-row-container__row-cell-set--frozen-separator': !isSmallContainer && isFrozenRowSet && props.showFrozenColumnsSeparator, 'b-data-grid-row-container__row-cell-set--unfrozen': !isFrozenRowSet || isSmallContainer, 'b-data-grid-row-container__row-cell-set--is-measuring': props.isMeasuringColumnWidths, }); const conditionalNestedRowClasses = computed(() => ({ 'b-data-grid-row-container__row-nested-slot--is-last-child': props.isRowLastChild, 'b-data-grid-row-container__row-nested-slot': !shouldShowRenderNestedRows.value && props.shouldShowNestedContent(props.rowData), })); const conditionalRowActionsContainerClasses = computed(() => ({ 'b-data-grid-row-container__row-actions-container--row-actions-menu-open': isRowActionMenuOpen.value, })); const computedRowActionsStyles = computed(() => ({ minWidth: `${props.rowActionsMaximumWidth}px`, })); // Exposed refs defineExpose({ gridcellRefs, rowActionsRef, }); </script> <script lang="ts"> /** * Internal component to display the BentoDataGrid data rows containig the data row cells. * * @example * * export default { * components: { DataGridRow }, * template: ` * <data-grid-row * :ref="el => registerRowCellRefs(el, rowIndex)" * :style="gridColumnWidthStyle" * :allow-row-clicks="allowRowClicks" * :column-sets="columnSets" * :condensed="condensed" * :dragging-columns="draggingColumns" * :dragging-events-for-row-cell="draggingEventsForRowCell" * :get-data-item-id="getDataItemId" * :has-left-overflow="hasLeftOverflow" * :highlighted-rows="highlightedRows" * :hovered-row-index="hoveredRowIndex" * :hovered-over-column-state="hoveredOverColumnState" * :is-data-item-disabled="isDataItemDisabled" * :is-measuring-column-widths="isMeasuringColumnWidths" * :row-data="rowData" * :row-index="rowIndex" * :show-frozen-columns-separator="showFrozenColumnsSeparator" * :selectable="selectable" * :selected-items="selectedItems" * @cell-hovered="onCellHover" * @row-click="onRowClick" * @on-frozen-columns-key-press="updateScrollPositionOnFrozenColumnsNavigation" * @select-row="onRowSelect" * > * <template v-for="(_, innerSlot) of slots" #[innerSlot]="scope"> * <slot :name="innerSlot" v-bind="scope" /> * </template> * </data-grid-row> * ` */ export default { name: 'data-grid-row', }; </script> <style lang="scss" scoped src="./data-grid-row.scss" /> 

package/dist/assets/components/data-grid/components/data-grid-static-icon/data-grid-static-icon.docs.mdx

@@ -0,0 +1,61 @@
+import { Canvas, Meta } from '@storybook/blocks';
+import * as DataGridStaticIconStories from './data-grid-static-icon.stories';
+
+<Meta of={DataGridStaticIconStories} />
+
+# Data Grid Static Icon
+
+The `bento-data-grid-static-icon` is an icon component with an associated toltip to be used within cellls of the
+`bento-data-grid`.
+
+<Canvas of={DataGridStaticIconStories.Default} />
+
+## Use Cases
+
+Use a `bento-data-grid-static-icon` to display any kind of static information that can be visualized quickly, such as
+what access rights a certain user has.
+
+### Do not use
+
+Don't use the `bento-data-grid-static-icon` component outside the data grid. Also, only use to display simple visual
+information, and prefer row actions for anything more complex.
+
+## Variations
+
+### Variant
+
+Is the type of icon displayed. It can have one of the following values:
+
+-   `checkmark`
+-   `cross`
+-   `error`
+-   `no-value`
+-   `warning`
+
+## Modifiers
+
+### Colored
+
+Renders the icon in color. By default a black-and-white icon is rendered.
+
+## Accessibility
+
+The `bento-data-grid-static-icon` is accessible through the normal flow of the page via keyboard navigation.
+
+### Keyboard interaction
+
+| Keyboard interaction | Action                                                             |
+| -------------------- | ------------------------------------------------------------------ |
+| `Tab`                | Moves focus to the icon or away from it, showing or hiding tooltip |
+
+### Roles, states and properties
+
+Adhering to the [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) standard we apply the following:
+
+| ARIA attribute | is automatic?                              | fallback used | manual override |
+| -------------- | ------------------------------------------ | ------------- | --------------- |
+| `label`        | Yes, based on `tooltipText` property value | -             | -               |
+
+## Resources
+
+-   [Figma link](https://www.figma.com/design/uLabwF3243jdMDsNSP7U9I/Bento---Components?node-id=24201-114205&node-type=section&t=RQPeNywjMT1e8FWl-0)

package/dist/assets/components/data-grid/components/data-grid-static-icon/data-grid-static-icon.stories.ts

@@ -0,0 +1 @@
+import type { Meta, StoryObj } from '@storybook/vue'; import { action } from '@storybook/addon-actions'; import { isVue2 } from 'vue-demi'; import { storybookDocsParameter } from '@/utils/ts/storybook'; import BentoDataGridStaticIcon from './data-grid-static-icon.vue'; const meta: Meta = { title: 'Data Grid/Components/Data Grid Static Icon', component: BentoDataGridStaticIcon, argTypes: { variant: { options: ['checkmark', 'warning', 'error', 'cross', 'no-value'], control: { type: 'select' }, }, }, }; export default meta; type Story = StoryObj<typeof BentoDataGridStaticIcon>; const DEFAULT_TITLE = 'title'; const defaultCode = ` <bento-data-grid-static-icon> Default slot content </bento-button> `; export const Default: Story = { render: (_args, { argTypes }) => ({ components: { BentoDataGridStaticIcon }, props: Object.keys(argTypes), template: ` <bento-data-grid-static-icon v-bind="args" @input="clickedAction" /> `, setup(props) { const clickedAction = value => action('input')(value); return { // Values args: isVue2 ? props : _args, // Events clickedAction, }; }, }), args: { tooltipText: DEFAULT_TITLE, }, parameters: storybookDocsParameter(defaultCode), }; 

package/dist/assets/components/data-grid/components/data-grid-static-icon/data-grid-static-icon.vue

@@ -0,0 +1 @@
+<template> <div v-bento-tooltip-directive:[tooltipPosition]="tooltipText" :aria-label="tooltipText" class="b-data-grid-static-icon" :class="conditionalClasses" tabindex="0" > <component :is="computedIcon" :class="computedIconClass" :svg-title="tooltipText" /> </div> </template> <script setup lang="ts"> import { computed } from 'vue'; import CheckmarkIcon from '@adyen/ui-assets-icons-16/vue/checkmark-circle-fill'; import WarningIcon from '@adyen/ui-assets-icons-16/vue/warning-filled'; import ErrorIcon from '@adyen/ui-assets-icons-16/vue/warning-circle-fill'; import CrossIcon from '@adyen/ui-assets-icons-16/vue/cross'; import NoValueIcon from '@adyen/ui-assets-icons-16/vue/minus-small'; import { BentoTooltipDirective as vBentoTooltipDirective } from '@/directives'; import { PopperContainerPosition } from '@/components/popper-container'; import { type BentoDataGridStaticIconVariant } from './data-grid-static-icon.types'; const props = withDefaults( defineProps<{ /** * Renderes the icon with color. */ colored?: boolean; /** * The text displaying in the tooltip. */ tooltipText: string; /** * The variant of the icon. */ variant?: BentoDataGridStaticIconVariant; }>(), { variant: 'no-value', colored: false, } ); const computedIcon = computed(() => { switch (props.variant) { case 'checkmark': return CheckmarkIcon; case 'warning': return WarningIcon; case 'error': return ErrorIcon; case 'cross': return CrossIcon; case 'no-value': return NoValueIcon; default: return NoValueIcon; } }); const conditionalClasses = computed(() => ({ [`b-data-grid-static-icon--colored`]: props.colored && props.variant !== 'no-value', })); const computedIconClass = computed(() => `b-data-grid-static-icon__${props.variant}`); const tooltipPosition = computed(() => PopperContainerPosition.AUTO); </script> <script lang="ts"> /** * The bento-data-grid-static-icon is an icon component with an associated toltip to be used within cellls of the bento-data-grid * * @example * import { BentoDataGridStaticIcon } from '@adyen/bento-vue2'; * * export default { * components: { BentoDataGridStaticIcon }, * template: ` * <bento-data-grid-static-icon variant="warning" text="Your tooltip text" /> * ` * } */ export default {}; </script> <style lang="scss" scoped src="./data-grid-static-icon.scss" /> 

package/dist/assets/components/data-grid/components/data-grid-summary-cell/data-grid-summary-cell.docs.mdx

@@ -0,0 +1,56 @@
+import { Canvas, Meta, Controls, Source } from '@storybook/blocks';
+import * as DataGridSummaryCellStories from './data-grid-summary-cell.stories';
+
+<Meta of={DataGridSummaryCellStories} />
+
+# Data Grid Summary Cell
+
+The `bento-data-grid-summary-cell` is a specialized cell component for the `bento-data-grid`. It's designed to display a
+summary of multiple data points (e.g., "2 merchants"). When hovered or focused, it reveals a popover containing the full
+list of items. It can also highlight search terms within the list and display an optional tooltip.
+
+<Canvas of={DataGridSummaryCellStories.Default} />
+
+## Use Cases
+
+Use a `bento-data-grid-summary-cell` when a single data grid cell needs to represent a list of multiple items. It
+provides a clean summary (e.g., "3 items") and allows users to view the full list in a popover on demand. This is
+particularly useful for "one-to-many" relationships in your data.
+
+### Do not use
+
+Do not use the `bento-data-grid-summary-cell` component outside of a `bento-data-grid`. It is specifically styled and
+designed to work within that context.
+
+## How to use
+
+The component is intended to be used within a `bento-data-grid`'s item slot.
+
+<Source
+    dark
+    language="html"
+    code={`<bento-data-grid :columns="columns" :data="data" :filter-search-term.sync="searchTerm">
+    <template #item-company="{item}">
+        <bento-data-grid-summary-cell
+            :label="\`\${item.company.length} merchants\`"
+            :items="item.company"
+            :search-term="searchTerm"
+        />
+    </template>
+</bento-data-grid>`}
+/>
+
+## Props
+
+<Controls />
+
+## Accessibility
+
+### Keyboard interaction
+
+`bento-data-grid-summary-cell` is reachable through keyboard navigation as a focusable element. This allows for
+triggering the attached tooltip/popover/clickable action via keyboard only.
+
+| Keyboard interaction | Output                             |
+| -------------------- | ---------------------------------- |
+| `Tab`                | Moves focus to the annotated text. |

package/dist/assets/components/data-grid/components/data-grid-summary-cell/data-grid-summary-cell.stories.ts

@@ -0,0 +1 @@
+import { isVue2 } from 'vue-demi'; import { storybookDocsParameter } from '@/utils/ts/storybook'; import BentoDataGridSummaryCell from './data-grid-summary-cell.vue'; import type { Meta, StoryObj } from '@storybook/vue'; const meta: Meta = { title: 'Data Grid/Components/Data Grid Summary Cell', component: BentoDataGridSummaryCell, argTypes: { items: { table: { type: { summary: 'Array<string>' }, }, }, }, }; export default meta; type Story = StoryObj<typeof BentoDataGridSummaryCell>; const DEFAULT_TITLE = '2 merchants'; const defaultCode = ` <bento-data-grid-summary-cell label="${DEFAULT_TITLE}" items="['Merchant A', 'Merchant B']" /> `; export const Default: Story = { render: (_args, { argTypes }) => ({ components: { BentoDataGridSummaryCell }, props: Object.keys(argTypes), template: ` <bento-data-grid-summary-cell v-bind="args"/> `, setup(props) { return { // Values args: isVue2 ? props : _args, }; }, }), args: { label: DEFAULT_TITLE, items: ['Merchant A', 'Merchant B'], }, parameters: storybookDocsParameter(defaultCode), }; 

package/dist/assets/components/data-grid/components/data-grid-summary-cell/data-grid-summary-cell.vue

@@ -0,0 +1 @@
+<template> <div class="b-data-grid-summary-cell"> <bento-dashed-underline v-if="items.length > 1" ref="dashedUnderlineRef" v-bind="dashedUnderlineProps"> {{ label }} <template #popover-content> <bento-typography class="b-data-grid-summary-cell__popover-content"> <ul class="b-data-grid-summary-cell__list"> <li v-for="item in items" :key="item"> <component :is="highlightedComponent(item)">{{ item }}</component> </li> </ul> </bento-typography> </template> </bento-dashed-underline> <template v-else>{{ items[0] }}</template> <tooltip v-if="dashedUnderlineRef && computedToolTipText" :content="computedToolTipText" :disabled-focus-trap="true" :position="BentoTooltipPosition.RIGHT" :fallback-position="['left', 'bottom']" :is-shown="!!computedToolTipText" :target-element="dashedUnderlineRef" /> </div> </template> <script setup lang="ts"> import { computed, ref } from 'vue'; import { BentoDashedUnderline, type BentoDashedUnderlineProps } from '@/components/dashed-underline'; import { BentoTypography } from '@/components/typography'; import { Tooltip } from '@/components/internal'; import { BentoTooltipPosition } from '../../../internal/tooltip/tooltip.types'; import { useI18n } from '@/utils/ts/i18n'; import messages from './messages.json'; import type { BentoDataGridSummaryCellProps } from './data-grid-summary-cell.types'; type MessageSchema = (typeof messages)['en-US']; const { tc } = useI18n<{ message: MessageSchema }>({ messages }); const props = withDefaults(defineProps<BentoDataGridSummaryCellProps>(), { dashedUnderline: () => ({}), searchTerm: '', tooltipText: null, }); const dashedUnderlineRef = ref(); const dashedUnderlineProps = computed<BentoDashedUnderlineProps>(() => ({ popoverPosition: 'right', // Setting popover defaults, but they are overriden if used passes dashedUnderline prop popoverTitle: props.label, popoverSize: 'small', ...props.dashedUnderline, // We force teleport as this is needed for the popover to appear above all the data grid elements teleport: { disabled: false, }, })); const lowerCaseSearchTerm = computed(() => props.searchTerm?.toLowerCase() ?? ''); const highlightedComponent = (item: string) => props.searchTerm && item.toLowerCase().includes(lowerCaseSearchTerm.value) ? 'mark' : 'span'; const highlightedItemsCount = computed(() => { if (!props.searchTerm) { return 0; } return props.items.filter(item => item.toLowerCase().includes(lowerCaseSearchTerm.value)).length; }); const computedToolTipText = computed( () => props.tooltipText ?? (highlightedItemsCount.value > 0 ? tc('numberResults', highlightedItemsCount.value) : '') ); </script> <script lang="ts"> /** * A specialized cell for `bento-data-grid` to display a summary of multiple items. * * @example * import { BentoDataGridSummaryCell } from '@adyen/bento-vue2'; * * export default { * components: { BentoDataGridSummaryCell }, * template: ` * <bento-data-grid-summary-cell * label="2 merchants" * :items="['Merchant A', 'Merchant B']" * /> * ` * } */ export default { i18n: { messages }, }; </script> <style lang="scss" scoped src="./data-grid-summary-cell.scss" /> 

package/dist/assets/components/data-grid/components/data-grid-trend-cell/data-grid-trend-cell.docs.mdx

@@ -0,0 +1,48 @@
+import { Canvas, Meta, Controls, Source } from '@storybook/blocks';
+import * as DataGridTrendCellStories from './data-grid-trend-cell.stories';
+import DataGridTrendCellExample from '../../__tests__/data-grid-trend-cell-example.vue?raw';
+
+<Meta of={DataGridTrendCellStories} />
+
+# Data Grid Trend Cell
+
+The `bento-data-grid-trend-cell` is a component designed to be used within cells of the `bento-data-grid`. It displays a
+numeric value formatted as a percentage, accompanied by an icon indicating a trend (increase or decrease).
+
+<Canvas of={DataGridTrendCellStories.Default} />
+
+## Use Cases
+
+Use a `bento-data-grid-trend-cell` to display key performance indicators that involve change or comparison, such as:
+
+- Week-over-week growth rates
+- Performance change over time
+- Comparison against a benchmark
+
+### Do not use
+
+Don't use the `bento-data-grid-trend-cell` component outside of a data grid. For displaying simple values without a
+trend, use a standard grid cell.
+
+## How to use
+
+The component is intended to be used within a `bento-data-grid`'s item slot.
+
+<Source dark language="html" code={DataGridTrendCellExample} />
+
+## Props
+
+<Controls />
+
+## Accessibility
+
+The `bento-data-grid-trend-cell`'s trend icon is made accessible to screen readers.
+
+### Roles, states and properties
+
+The icon within the component receives a `title` attribute that describes the trend direction (e.g., "increase" or
+"decrease"). This provides context for users of assistive technology.
+
+| ARIA attribute equivalent | is automatic?                                  | fallback used | manual override |
+| ------------------------- | ---------------------------------------------- | ------------- | --------------- |
+| `title` (as label)        | Yes, based on the `direction` property's value | -             | -               |

package/dist/assets/components/data-grid/components/data-grid-trend-cell/data-grid-trend-cell.stories.ts

@@ -0,0 +1 @@
+import { storybookDocsParameter } from '@/utils/ts/storybook'; import type { Meta, StoryObj } from '@storybook/vue'; import { isVue2 } from 'vue-demi'; import BentoDataGridTrendCell from './data-grid-trend-cell.vue'; import DataGridTrendCellDefaultExample from './__tests__/data-grid-trend-cell-default-example.vue?raw'; const meta: Meta = { title: 'Data Grid/Components/Data Grid Trend Cell', component: BentoDataGridTrendCell, argTypes: { direction: { options: ['up', 'down', 'none'], control: { type: 'select' }, }, value: { control: { type: 'number' }, }, variant: { options: ['green', 'red', 'black'], control: { type: 'select' }, }, }, }; export default meta; type Story = StoryObj<typeof BentoDataGridTrendCell>; export const Default: Story = { render: (_args, { argTypes }) => ({ components: { BentoDataGridTrendCell }, props: Object.keys(argTypes), template: ` <bento-data-grid-trend-cell v-bind="args" /> `, setup(props) { return { // Values args: isVue2 ? props : _args, }; }, }), args: { value: 0.5, variant: 'green', direction: 'up', }, parameters: storybookDocsParameter(DataGridTrendCellDefaultExample), }; 

package/dist/assets/components/data-grid/components/data-grid-trend-cell/data-grid-trend-cell.vue

@@ -0,0 +1 @@
+<template> <div class="b-data-grid-trend-cell" :class="conditionalClasses"> <component :is="computedIcon" v-if="computedIcon" :svg-title="computedIconTitle" /> <bento-typography el="span">{{ computedValue }}</bento-typography> </div> </template> <script setup lang="ts"> import { computed } from 'vue'; import ArrowTopSmallIcon from '@adyen/ui-assets-icons-16/vue/arrow-top-small'; import ArrowBottomSmallIcon from '@adyen/ui-assets-icons-16/vue/arrow-bottom-small'; import { useI18n } from '@adyen/bento-vue-i18n-demi'; import { BentoTypography } from '@/components/typography'; import { type BentoDataGridTrendCellProps } from './data-grid-trend-cell.types'; import messages from './messages.json'; type MessageSchema = (typeof messages)['en-US']; const { t, locale } = useI18n<{ message: MessageSchema }>({ messages }); const props = withDefaults(defineProps<BentoDataGridTrendCellProps>(), { variant: 'black', direction: 'none', }); const conditionalClasses = computed(() => ({ [`b-data-grid-trend-cell--${props.variant}`]: props.variant !== 'black', })); const computedIconTitle = computed(() => { switch (props.direction) { case 'up': return t('increase'); case 'down': return t('decrease'); default: return null; } }); const computedIcon = computed(() => { switch (props.direction) { case 'up': return ArrowTopSmallIcon; case 'down': return ArrowBottomSmallIcon; default: return null; } }); const computedValue = computed(() => { const numberVal = typeof props.value === 'string' ? parseFloat(props.value) : props.value; if (isNaN(numberVal)) { return ''; } return new Intl.NumberFormat(locale.value, { style: 'percent', minimumFractionDigits: 0, // Don't force zeros maximumFractionDigits: 10, // Cap it reasonably to avoid float artifacts }).format(numberVal / 100); }); </script> <script lang="ts"> /** * The bento-data-grid-trend-cell is a component for `bento-data-grid` that displays a percentage value with a trend icon. * * @example * import { BentoDataGridTrendCell } from '@adyen/bento-vue2'; * * export default { * components: { BentoDataGridTrendCell }, * template: ` * <bento-data-grid-trend-cell :value="25.5" variant="green" direction="up" /> * ` * } */ export default { i18n: { messages }, }; </script> <style lang="scss" scoped src="./data-grid-trend-cell.scss" />