npm - @carto/ps-react-ui - Versions diffs - 5.1.0 → 6.0.0 - Mend

@carto/ps-react-ui 5.1.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1136) hide show

package/dist/table-BE4uO9pp.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"table-BE4uO9pp.js","names":["{\n columns,\n rows,\n total,\n page,\n pageSize,\n pageSizeOptions = DEFAULT_TABLE_PAGE_SIZE_OPTIONS,\n sort,\n keyColumn = 'id',\n selection,\n selectable = false,\n onSortChange,\n onPageChange,\n onPageSizeChange,\n onSelectionChange,\n onRowClick,\n onRowHover,\n labels,\n emptyContent,\n size,\n}: TableUIProps<T>","pageSizeOptions = DEFAULT_TABLE_PAGE_SIZE_OPTIONS","keyColumn = 'id'","selectable = false","{ ...DEFAULT_TABLE_LABELS, ...labels }","useMemo(\n () => ({ ...DEFAULT_TABLE_LABELS, ...labels }),\n [labels],\n )","makePaginationActions(_labels)","useMemo(\n () => makePaginationActions(_labels),\n [_labels],\n )","selection ?? []","new Set<string | number>(selection ?? [])","useMemo(\n () => new Set<string | number>(selection ?? []),\n [selection],\n )","(row: T, index: number): string | number =>\n (row[keyColumn] ?? index) as string | number","useCallback(\n (row: T, index: number): string | number =>\n (row[keyColumn] ?? index) as string | number,\n [keyColumn],\n )","rows.map(resolveRowId)","useMemo(() => rows.map(resolveRowId), [rows, resolveRowId])","pageRowIds.length > 0 && pageRowIds.every((id) => selectionSet.has(id))","pageRowIds.length","!allOnPageSelected && pageRowIds.some((id) => selectionSet.has(id))","id","(columnId: string) => {\n if (!onSortChange) return\n const sameCol = sort?.columnId === columnId\n const nextDir: TableSortDirection =\n sameCol && sort?.direction === 'asc' ? 'desc' : 'asc'\n onSortChange({ columnId, direction: nextDir })\n }","columnId","direction","() => {\n if (!onSelectionChange) return\n if (allOnPageSelected) {\n onSelectionChange(\n (selection ?? []).filter((id) => !pageRowIds.includes(id)),\n )\n } else {\n const merged = new Set<string | number>(selection ?? [])\n for (const id of pageRowIds) merged.add(id)\n onSelectionChange([...merged])\n }\n }","(rowId: string | number) => {\n if (!onSelectionChange) return\n const next = new Set<string | number>(selection ?? [])\n if (next.has(rowId)) next.delete(rowId)\n else next.add(rowId)\n onSelectionChange([...next])\n }","selectable ? (\n <TableCell padding='checkbox' sx={styles.headerCell}>\n <Checkbox\n checked={allOnPageSelected}\n indeterminate={someOnPageSelected}\n onChange={handleSelectAllOnPage}\n slotProps={{\n input: { 'aria-label': _labels.selectAll },\n }}\n />\n </TableCell>\n ) : null","_labels.selectAll","columns.map((column) => {\n const isSorted = sort?.columnId === column.id\n const direction = isSorted ? sort?.direction : undefined\n return (\n <TableCell\n key={column.id}\n align={column.align}\n sortDirection={direction}\n sx={styles.headerCell}\n style={\n column.width != null ? { width: column.width } : undefined\n }\n >\n {column.sortable && onSortChange ? (\n <TableSortLabel\n active={isSorted}\n direction={direction ?? 'asc'}\n onClick={() => handleSort(column.id)}\n >\n {column.label}\n </TableSortLabel>\n ) : (\n column.label\n )}\n </TableCell>\n )\n })","(column) => {\n const isSorted = sort?.columnId === column.id\n const direction = isSorted ? sort?.direction : undefined\n return (\n <TableCell\n key={column.id}\n align={column.align}\n sortDirection={direction}\n sx={styles.headerCell}\n style={\n column.width != null ? { width: column.width } : undefined\n }\n >\n {column.sortable && onSortChange ? (\n <TableSortLabel\n active={isSorted}\n direction={direction ?? 'asc'}\n onClick={() => handleSort(column.id)}\n >\n {column.label}\n </TableSortLabel>\n ) : (\n column.label\n )}\n </TableCell>\n )\n }","<TableHead>\n <MuiTableRow>\n {selectable ? (\n <TableCell padding='checkbox' sx={styles.headerCell}>\n <Checkbox\n checked={allOnPageSelected}\n indeterminate={someOnPageSelected}\n onChange={handleSelectAllOnPage}\n slotProps={{\n input: { 'aria-label': _labels.selectAll },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => {\n const isSorted = sort?.columnId === column.id\n const direction = isSorted ? sort?.direction : undefined\n return (\n <TableCell\n key={column.id}\n align={column.align}\n sortDirection={direction}\n sx={styles.headerCell}\n style={\n column.width != null ? { width: column.width } : undefined\n }\n >\n {column.sortable && onSortChange ? (\n <TableSortLabel\n active={isSorted}\n direction={direction ?? 'asc'}\n onClick={() => handleSort(column.id)}\n >\n {column.label}\n </TableSortLabel>\n ) : (\n column.label\n )}\n </TableCell>\n )\n })}\n </MuiTableRow>\n </TableHead>","rows.length === 0 ? (\n <MuiTableRow>\n <TableCell\n colSpan={columns.length + (selectable ? 1 : 0)}\n sx={styles.empty}\n >\n {emptyContent ?? null}\n </TableCell>\n </MuiTableRow>\n ) : (\n rows.map((row, index) => {\n const rowId = resolveRowId(row, index)\n const isSelected = selectionSet.has(rowId)\n return (\n <MuiTableRow\n key={rowId}\n hover\n selected={isSelected}\n onClick={() => onRowClick?.(row)}\n onMouseEnter={() => onRowHover?.(row)}\n onMouseLeave={() => onRowHover?.(null)}\n sx={{\n ...styles.row,\n ...(onRowClick ? styles.rowClickable : null),\n }}\n >\n {selectable ? (\n <TableCell padding='checkbox'>\n <Checkbox\n checked={isSelected}\n onClick={(e) => {\n e.stopPropagation()\n handleSelectRow(rowId)\n }}\n slotProps={{\n input: {\n 'aria-label': _labels.selectRow(rowId),\n },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => (\n <TableCell key={column.id} align={column.align}>\n {column.formatter\n ? column.formatter(row[column.id], row)\n : stringifyCell(row[column.id])}\n </TableCell>\n ))}\n </MuiTableRow>\n )\n })\n )","columns.length","rows.length","rowId","row","index","column","<TableBody>\n {rows.length === 0 ? (\n <MuiTableRow>\n <TableCell\n colSpan={columns.length + (selectable ? 1 : 0)}\n sx={styles.empty}\n >\n {emptyContent ?? null}\n </TableCell>\n </MuiTableRow>\n ) : (\n rows.map((row, index) => {\n const rowId = resolveRowId(row, index)\n const isSelected = selectionSet.has(rowId)\n return (\n <MuiTableRow\n key={rowId}\n hover\n selected={isSelected}\n onClick={() => onRowClick?.(row)}\n onMouseEnter={() => onRowHover?.(row)}\n onMouseLeave={() => onRowHover?.(null)}\n sx={{\n ...styles.row,\n ...(onRowClick ? styles.rowClickable : null),\n }}\n >\n {selectable ? (\n <TableCell padding='checkbox'>\n <Checkbox\n checked={isSelected}\n onClick={(e) => {\n e.stopPropagation()\n handleSelectRow(rowId)\n }}\n slotProps={{\n input: {\n 'aria-label': _labels.selectRow(rowId),\n },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => (\n <TableCell key={column.id} align={column.align}>\n {column.formatter\n ? column.formatter(row[column.id], row)\n : stringifyCell(row[column.id])}\n </TableCell>\n ))}\n </MuiTableRow>\n )\n })\n )}\n </TableBody>","<TableContainer>\n <MuiTable stickyHeader size={size} sx={styles.table}>\n <TableHead>\n <MuiTableRow>\n {selectable ? (\n <TableCell padding='checkbox' sx={styles.headerCell}>\n <Checkbox\n checked={allOnPageSelected}\n indeterminate={someOnPageSelected}\n onChange={handleSelectAllOnPage}\n slotProps={{\n input: { 'aria-label': _labels.selectAll },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => {\n const isSorted = sort?.columnId === column.id\n const direction = isSorted ? sort?.direction : undefined\n return (\n <TableCell\n key={column.id}\n align={column.align}\n sortDirection={direction}\n sx={styles.headerCell}\n style={\n column.width != null ? { width: column.width } : undefined\n }\n >\n {column.sortable && onSortChange ? (\n <TableSortLabel\n active={isSorted}\n direction={direction ?? 'asc'}\n onClick={() => handleSort(column.id)}\n >\n {column.label}\n </TableSortLabel>\n ) : (\n column.label\n )}\n </TableCell>\n )\n })}\n </MuiTableRow>\n </TableHead>\n <TableBody>\n {rows.length === 0 ? (\n <MuiTableRow>\n <TableCell\n colSpan={columns.length + (selectable ? 1 : 0)}\n sx={styles.empty}\n >\n {emptyContent ?? null}\n </TableCell>\n </MuiTableRow>\n ) : (\n rows.map((row, index) => {\n const rowId = resolveRowId(row, index)\n const isSelected = selectionSet.has(rowId)\n return (\n <MuiTableRow\n key={rowId}\n hover\n selected={isSelected}\n onClick={() => onRowClick?.(row)}\n onMouseEnter={() => onRowHover?.(row)}\n onMouseLeave={() => onRowHover?.(null)}\n sx={{\n ...styles.row,\n ...(onRowClick ? styles.rowClickable : null),\n }}\n >\n {selectable ? (\n <TableCell padding='checkbox'>\n <Checkbox\n checked={isSelected}\n onClick={(e) => {\n e.stopPropagation()\n handleSelectRow(rowId)\n }}\n slotProps={{\n input: {\n 'aria-label': _labels.selectRow(rowId),\n },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => (\n <TableCell key={column.id} align={column.align}>\n {column.formatter\n ? column.formatter(row[column.id], row)\n : stringifyCell(row[column.id])}\n </TableCell>\n ))}\n </MuiTableRow>\n )\n })\n )}\n </TableBody>\n </MuiTable>\n </TableContainer>","showPagination ? (\n <TablePagination\n component='div'\n count={total}\n page={page}\n rowsPerPage={pageSize}\n rowsPerPageOptions={[...pageSizeOptions]}\n onPageChange={(_, next) => onPageChange?.(next)}\n onRowsPerPageChange={(e) => {\n const next = parseInt(e.target.value, 10)\n onPageSizeChange?.(next)\n }}\n labelRowsPerPage={_labels.rowsPerPage}\n labelDisplayedRows={({ from, to, count }) =>\n _labels.paginationOf(from, to, count)\n }\n sx={styles.pagination}\n ActionsComponent={PaginationActions}\n />\n ) : null","next","e","{ from, to, count }","<Box sx={styles.container}>\n <TableContainer>\n <MuiTable stickyHeader size={size} sx={styles.table}>\n <TableHead>\n <MuiTableRow>\n {selectable ? (\n <TableCell padding='checkbox' sx={styles.headerCell}>\n <Checkbox\n checked={allOnPageSelected}\n indeterminate={someOnPageSelected}\n onChange={handleSelectAllOnPage}\n slotProps={{\n input: { 'aria-label': _labels.selectAll },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => {\n const isSorted = sort?.columnId === column.id\n const direction = isSorted ? sort?.direction : undefined\n return (\n <TableCell\n key={column.id}\n align={column.align}\n sortDirection={direction}\n sx={styles.headerCell}\n style={\n column.width != null ? { width: column.width } : undefined\n }\n >\n {column.sortable && onSortChange ? (\n <TableSortLabel\n active={isSorted}\n direction={direction ?? 'asc'}\n onClick={() => handleSort(column.id)}\n >\n {column.label}\n </TableSortLabel>\n ) : (\n column.label\n )}\n </TableCell>\n )\n })}\n </MuiTableRow>\n </TableHead>\n <TableBody>\n {rows.length === 0 ? (\n <MuiTableRow>\n <TableCell\n colSpan={columns.length + (selectable ? 1 : 0)}\n sx={styles.empty}\n >\n {emptyContent ?? null}\n </TableCell>\n </MuiTableRow>\n ) : (\n rows.map((row, index) => {\n const rowId = resolveRowId(row, index)\n const isSelected = selectionSet.has(rowId)\n return (\n <MuiTableRow\n key={rowId}\n hover\n selected={isSelected}\n onClick={() => onRowClick?.(row)}\n onMouseEnter={() => onRowHover?.(row)}\n onMouseLeave={() => onRowHover?.(null)}\n sx={{\n ...styles.row,\n ...(onRowClick ? styles.rowClickable : null),\n }}\n >\n {selectable ? (\n <TableCell padding='checkbox'>\n <Checkbox\n checked={isSelected}\n onClick={(e) => {\n e.stopPropagation()\n handleSelectRow(rowId)\n }}\n slotProps={{\n input: {\n 'aria-label': _labels.selectRow(rowId),\n },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => (\n <TableCell key={column.id} align={column.align}>\n {column.formatter\n ? column.formatter(row[column.id], row)\n : stringifyCell(row[column.id])}\n </TableCell>\n ))}\n </MuiTableRow>\n )\n })\n )}\n </TableBody>\n </MuiTable>\n </TableContainer>\n {showPagination ? (\n <TablePagination\n component='div'\n count={total}\n page={page}\n rowsPerPage={pageSize}\n rowsPerPageOptions={[...pageSizeOptions]}\n onPageChange={(_, next) => onPageChange?.(next)}\n onRowsPerPageChange={(e) => {\n const next = parseInt(e.target.value, 10)\n onPageSizeChange?.(next)\n }}\n labelRowsPerPage={_labels.rowsPerPage}\n labelDisplayedRows={({ from, to, count }) =>\n _labels.paginationOf(from, to, count)\n }\n sx={styles.pagination}\n ActionsComponent={PaginationActions}\n />\n ) : null}\n </Box>","initialPageSize = DEFAULT_TABLE_PAGE_SIZE","remote = false","{\n columns,\n visibleColumns,\n initialPageSize = DEFAULT_TABLE_PAGE_SIZE,\n selection,\n onSelectionChange,\n onRowClick,\n onRowHover,\n remote = false,\n total: remoteTotal,\n onSortChange,\n onPageChange,\n onPageSizeChange,\n ...uiProps\n}: TableProps<T>","(s) => s.data as readonly T[] | undefined","(s) => ({\n sort: s.sort,\n page: s.page ?? 0,\n pageSize: s.pageSize ?? initialPageSize,\n columnOrder: s.columnOrder,\n })","s","visibleColumns == null\n ? reordered\n : reordered.slice(0, visibleColumns)","columnOrder","useMemo(() => {\n const reordered = resolveColumns(columns, ui.columnOrder)\n return visibleColumns == null\n ? reordered\n : reordered.slice(0, visibleColumns)\n }, [columns, ui.columnOrder, visibleColumns])","useMemo(() => {\n if (remote) {\n return {\n rows: data ?? [],\n totalRows: remoteTotal ?? 0,\n }\n }\n const { sorted, visible } = deriveVisibleRows(data ?? [], {\n sort: ui.sort,\n page: ui.page,\n pageSize: ui.pageSize,\n })\n return { rows: visible, totalRows: sorted.length }\n }, [remote, data, remoteTotal, ui.sort, ui.page, ui.pageSize])","data ?? []","{\n rows: data ?? [],\n totalRows: remoteTotal ?? 0,\n }","remoteTotal ?? 0","deriveVisibleRows(data ?? [], {\n sort: ui.sort,\n page: ui.page,\n pageSize: ui.pageSize,\n })","page","pageSize","sort","{ rows: visible, totalRows: sorted.length }","length","(next: TableSortState) => {\n getWidgetStore(id).setState({\n sort: next,\n page: 0,\n } as Partial<TableWidgetState>)\n onSortChange?.(next)\n }","useCallback(\n (next: TableSortState) => {\n getWidgetStore(id).setState({\n sort: next,\n page: 0,\n } as Partial<TableWidgetState>)\n onSortChange?.(next)\n },\n [id, onSortChange],\n )","(page: number) => {\n getWidgetStore(id).setState({ page } as Partial<TableWidgetState>)\n onPageChange?.(page)\n }","useCallback(\n (page: number) => {\n getWidgetStore(id).setState({ page } as Partial<TableWidgetState>)\n onPageChange?.(page)\n },\n [id, onPageChange],\n )","(pageSize: number) => {\n getWidgetStore(id).setState({\n pageSize,\n page: 0,\n } as Partial<TableWidgetState>)\n onPageSizeChange?.(pageSize)\n }","useCallback(\n (pageSize: number) => {\n getWidgetStore(id).setState({\n pageSize,\n page: 0,\n } as Partial<TableWidgetState>)\n onPageSizeChange?.(pageSize)\n },\n [id, onPageSizeChange],\n )","<TableUI\n {...uiProps}\n columns={orderedColumns}\n rows={rows}\n total={totalRows}\n page={ui.page}\n pageSize={ui.pageSize}\n sort={ui.sort}\n selection={selection}\n onSortChange={handleSortChange}\n onPageChange={handlePageChange}\n onPageSizeChange={handlePageSizeChange}\n onSelectionChange={onSelectionChange}\n onRowClick={onRowClick}\n onRowHover={onRowHover}\n />","{\n rows = 5,\n columns = 4,\n size,\n}: TableSkeletonProps","rows = 5","columns = 4","<TableHead>\n <MuiTableRow>\n {Array.from({ length: columns }).map((_, c) => (\n <TableCell key={`head-${c}`} sx={styles.headerCell}>\n <Skeleton variant='text' width='80%' height={24} />\n </TableCell>\n ))}\n </MuiTableRow>\n </TableHead>","(_, c) => (\n <TableCell key={`head-${c}`} sx={styles.headerCell}>\n <Skeleton variant='text' width='80%' height={24} />\n </TableCell>\n )","Array.from({ length: rows })","<TableBody>\n {Array.from({ length: rows }).map((_, r) => (\n <MuiTableRow key={`row-${r}`} sx={styles.row}>\n {Array.from({ length: columns }).map((__, c) => (\n <TableCell key={`cell-${r}-${c}`}>\n <Skeleton variant='text' width='70%' height={20} />\n </TableCell>\n ))}\n </MuiTableRow>\n ))}\n </TableBody>","c","<Box sx={styles.container} aria-label='Table skeleton'>\n <MuiTable size={size} sx={styles.table} stickyHeader>\n <TableHead>\n <MuiTableRow>\n {Array.from({ length: columns }).map((_, c) => (\n <TableCell key={`head-${c}`} sx={styles.headerCell}>\n <Skeleton variant='text' width='80%' height={24} />\n </TableCell>\n ))}\n </MuiTableRow>\n </TableHead>\n <TableBody>\n {Array.from({ length: rows }).map((_, r) => (\n <MuiTableRow key={`row-${r}`} sx={styles.row}>\n {Array.from({ length: columns }).map((__, c) => (\n <TableCell key={`cell-${r}-${c}`}>\n <Skeleton variant='text' width='70%' height={20} />\n </TableCell>\n ))}\n </MuiTableRow>\n ))}\n </TableBody>\n </MuiTable>\n </Box>"],"sources":["../src/widgets/table/labels.tsx","../src/widgets/table/types.ts","../src/widgets/table/style.ts","../src/widgets/table/table-ui.tsx","../src/widgets/table/helpers.ts","../src/widgets/table/table.tsx","../src/widgets/table/skeleton.tsx","../src/widgets/table/download.ts","../src/widgets/table/transforms.ts"],"sourcesContent":["import { Box, type SxProps, type Theme } from '@mui/material'\nimport type { ReactNode } from 'react'\n\nexport interface TableLabels {\n selectAll: string\n selectRow: (rowId: string | number) => string\n rowsPerPage: string\n /**\n * Renders the displayed-rows summary in the pagination footer. Returns\n * a `ReactNode` so the default can emphasise the active range\n * (`from-to`) with a bolder weight while keeping the trailing\n * ` of total` muted. Override to localise wording or restyle.\n */\n paginationOf: (from: number, to: number, total: number) => ReactNode\n /** aria-label for the first-page pagination button. */\n firstPage: string\n /** aria-label for the previous-page pagination button. */\n previousPage: string\n /** aria-label for the next-page pagination button. */\n nextPage: string\n /** aria-label for the last-page pagination button. */\n lastPage: string\n}\n\nconst boldRange: SxProps<Theme> = { fontWeight: 600, color: 'text.primary' }\n\nexport const DEFAULT_TABLE_LABELS: TableLabels = {\n selectAll: 'Select all rows',\n selectRow: (id) => `Select row ${id}`,\n rowsPerPage: 'Rows per page:',\n paginationOf: (from, to, total) => (\n <>\n <Box component='span' sx={boldRange}>{`${from}–${to}`}</Box>\n {` of ${total}`}\n </>\n ),\n firstPage: 'First page',\n previousPage: 'Previous page',\n nextPage: 'Next page',\n lastPage: 'Last page',\n}\n","import type { ReactNode } from 'react'\nimport type { WidgetState } from '../stores'\n\n/**\n * Single row of tabular data.\n *\n * The default row-identity column is `id`. Consumers that don't have a\n * literal `id` field can point `<Table>` / `<TableUI>` at a different\n * column via the `keyColumn` prop; the library reads `row[keyColumn]`\n * for selection lookup, React keys, and aria labels.\n */\nexport interface TableRow extends Record<string, unknown> {\n /**\n * Default row identity. Required when no `keyColumn` is configured.\n * Omit when wiring `keyColumn` to a different column.\n */\n id?: string | number\n}\n\nexport type TableWidgetData = readonly TableRow[]\n\nexport type TableSortDirection = 'asc' | 'desc'\n\nexport interface TableSortState {\n columnId: string | null\n direction: TableSortDirection\n}\n\nexport interface TableColumn {\n /** Unique column identifier; matches the field name on each row. */\n id: string\n /** Header label. */\n label: ReactNode\n align?: 'left' | 'center' | 'right'\n width?: number | string\n sortable?: boolean\n /** Custom cell renderer. Falls back to a string-cast of the raw value. */\n formatter?: (value: unknown, row: TableRow) => ReactNode\n}\n\n/**\n * State extension carrying Table-specific UI state on the per-widget store.\n * Per R12: widget-specific UI state lives in widget-specific extensions of\n * `WidgetState`, not on the base type.\n */\nexport interface TableWidgetState extends WidgetState {\n /** Optional reordered column list driven by ChangeColumn. Falls back to props. */\n columnOrder?: readonly string[]\n sort?: TableSortState\n page: number\n pageSize: number\n}\n\nexport const DEFAULT_TABLE_PAGE_SIZE = 10\nexport const DEFAULT_TABLE_PAGE_SIZE_OPTIONS = [10, 25, 50, 100] as const\n","import type { SxProps, Theme } from '@mui/material'\n\nexport const styles = {\n container: {\n width: '100%',\n overflowX: 'auto',\n },\n\n table: {\n minWidth: 0,\n },\n headerCell: {\n fontWeight: 600,\n backgroundColor: 'background.paper',\n },\n /**\n * Strip the bottom border from the last body row so the body flushes\n * against the pagination border instead of doubling it up. Mirrors v1.\n */\n row: {\n '&:last-child td, &:last-child th': {\n border: 0,\n },\n },\n rowClickable: {\n cursor: 'pointer',\n },\n pagination: {\n borderTop: '1px solid',\n borderColor: 'divider',\n },\n paginationActions: {\n display: 'flex',\n alignItems: 'center',\n gap: 0.25,\n ml: 1,\n },\n empty: {\n textAlign: 'center',\n color: 'text.secondary',\n py: 3,\n },\n} satisfies Record<string, SxProps<Theme>>\n","import { useCallback, useMemo } from 'react'\nimport {\n Box,\n Checkbox,\n IconButton,\n Table as MuiTable,\n TableBody,\n TableCell,\n TableContainer,\n TableHead,\n TablePagination,\n TableRow as MuiTableRow,\n TableSortLabel,\n type TableProps as MuiTableProps,\n} from '@mui/material'\nimport type { TablePaginationActionsProps } from '@mui/material/TablePaginationActions'\nimport { FirstPage as FirstPageIcon } from '@mui/icons-material'\nimport { KeyboardArrowLeft } from '@mui/icons-material'\nimport { KeyboardArrowRight } from '@mui/icons-material'\nimport { LastPage as LastPageIcon } from '@mui/icons-material'\nimport { DEFAULT_TABLE_LABELS, type TableLabels } from './labels'\nimport {\n DEFAULT_TABLE_PAGE_SIZE_OPTIONS,\n type TableColumn,\n type TableRow,\n type TableSortDirection,\n type TableSortState,\n} from './types'\nimport { styles } from './style'\n\nexport interface TableUIProps<T extends TableRow = TableRow> {\n columns: readonly TableColumn[]\n /** Already-paginated, already-sorted rows for the current view. */\n rows: readonly T[]\n /** Total row count (across all pages). Required for pagination footer. */\n total: number\n page: number\n pageSize: number\n pageSizeOptions?: readonly number[]\n sort?: TableSortState\n /**\n * Column name to use as the row identity. Drives selection lookup,\n * React keys, and aria labels. Defaults to `'id'` — point it at\n * another column when your rows don't carry an `id` field.\n */\n keyColumn?: string\n /** Selected row ids. Destination-owned. */\n selection?: readonly (string | number)[]\n selectable?: boolean\n onSortChange?: (next: TableSortState) => void\n onPageChange?: (page: number) => void\n onPageSizeChange?: (pageSize: number) => void\n onSelectionChange?: (next: readonly (string | number)[]) => void\n onRowClick?: (row: T) => void\n onRowHover?: (row: T | null) => void\n labels?: Partial<TableLabels>\n /** Row rendered when `rows` is empty for the current page. */\n emptyContent?: React.ReactNode\n /**\n * Forwarded to MUI's `<Table size>` — `'small'` for compact rows,\n * `'medium'` for the default density. Leave `undefined` (the default)\n * to let MUI's own default kick in.\n */\n size?: MuiTableProps['size']\n}\n\n/**\n * Pure renderer for a paginated, sortable, optionally-selectable table.\n * Has no widget-store coupling — `<Table>` (the bridge) reads from the store\n * and feeds this UI with already-projected data.\n */\nexport function TableUI<T extends TableRow = TableRow>({\n columns,\n rows,\n total,\n page,\n pageSize,\n pageSizeOptions = DEFAULT_TABLE_PAGE_SIZE_OPTIONS,\n sort,\n keyColumn = 'id',\n selection,\n selectable = false,\n onSortChange,\n onPageChange,\n onPageSizeChange,\n onSelectionChange,\n onRowClick,\n onRowHover,\n labels,\n emptyContent,\n size,\n}: TableUIProps<T>) {\n if (process.env.NODE_ENV !== 'production') {\n // Dev-time guard: a nullish identity collapses every row into the\n // same selection-set entry, which manifests as \"click one → all\n // appear selected\". Surface it loudly instead of silently degrading.\n const missing = rows.some((r) => r[keyColumn] == null)\n if (missing) {\n // eslint-disable-next-line no-console\n console.error(\n `<TableUI>: rows are missing the identity column \\`${keyColumn}\\`. ` +\n 'Set the `keyColumn` prop to a column present on every row, or ' +\n 'add the column to the data.',\n )\n }\n }\n const _labels = useMemo(\n () => ({ ...DEFAULT_TABLE_LABELS, ...labels }),\n [labels],\n )\n // Auto-hide the pagination footer when every row already fits in the\n // smallest available page size — the Rows-per-page selector + prev /\n // next buttons would just be inert noise. Consumers force the footer\n // on by passing a smaller `pageSizeOptions[0]` than `total`.\n const minPageSize = Math.min(...pageSizeOptions)\n const showPagination = total > minPageSize\n // Own the `ActionsComponent` slot ourselves so the Meridian theme's\n // `theme.components.MuiTablePagination.defaultProps.ActionsComponent`\n // (which depends on `react-intl`) doesn't leak into the library. The\n // MUI / Meridian style overrides for `MuiIconButton` /\n // `MuiTablePagination` still apply.\n const PaginationActions = useMemo(\n () => makePaginationActions(_labels),\n [_labels],\n )\n const selectionSet = useMemo(\n () => new Set<string | number>(selection ?? []),\n [selection],\n )\n // Resolve each row's identity from `keyColumn`, falling back to the row's\n // index when the cell is nullish. The dev-time guard above surfaces the\n // misconfiguration loudly, but in production we must NOT collapse every\n // nullish-keyed row into the same selection-set entry (that's the\n // \"click one → all selected\" bug) — a per-index fallback keeps ids\n // distinct and React keys stable for a given page.\n const resolveRowId = useCallback(\n (row: T, index: number): string | number =>\n (row[keyColumn] ?? index) as string | number,\n [keyColumn],\n )\n const pageRowIds = useMemo(() => rows.map(resolveRowId), [rows, resolveRowId])\n const allOnPageSelected =\n pageRowIds.length > 0 && pageRowIds.every((id) => selectionSet.has(id))\n const someOnPageSelected =\n !allOnPageSelected && pageRowIds.some((id) => selectionSet.has(id))\n\n const handleSort = (columnId: string) => {\n if (!onSortChange) return\n const sameCol = sort?.columnId === columnId\n const nextDir: TableSortDirection =\n sameCol && sort?.direction === 'asc' ? 'desc' : 'asc'\n onSortChange({ columnId, direction: nextDir })\n }\n\n const handleSelectAllOnPage = () => {\n if (!onSelectionChange) return\n if (allOnPageSelected) {\n onSelectionChange(\n (selection ?? []).filter((id) => !pageRowIds.includes(id)),\n )\n } else {\n const merged = new Set<string | number>(selection ?? [])\n for (const id of pageRowIds) merged.add(id)\n onSelectionChange([...merged])\n }\n }\n\n const handleSelectRow = (rowId: string | number) => {\n if (!onSelectionChange) return\n const next = new Set<string | number>(selection ?? [])\n if (next.has(rowId)) next.delete(rowId)\n else next.add(rowId)\n onSelectionChange([...next])\n }\n\n return (\n <Box sx={styles.container}>\n <TableContainer>\n <MuiTable stickyHeader size={size} sx={styles.table}>\n <TableHead>\n <MuiTableRow>\n {selectable ? (\n <TableCell padding='checkbox' sx={styles.headerCell}>\n <Checkbox\n checked={allOnPageSelected}\n indeterminate={someOnPageSelected}\n onChange={handleSelectAllOnPage}\n slotProps={{\n input: { 'aria-label': _labels.selectAll },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => {\n const isSorted = sort?.columnId === column.id\n const direction = isSorted ? sort?.direction : undefined\n return (\n <TableCell\n key={column.id}\n align={column.align}\n sortDirection={direction}\n sx={styles.headerCell}\n style={\n column.width != null ? { width: column.width } : undefined\n }\n >\n {column.sortable && onSortChange ? (\n <TableSortLabel\n active={isSorted}\n direction={direction ?? 'asc'}\n onClick={() => handleSort(column.id)}\n >\n {column.label}\n </TableSortLabel>\n ) : (\n column.label\n )}\n </TableCell>\n )\n })}\n </MuiTableRow>\n </TableHead>\n <TableBody>\n {rows.length === 0 ? (\n <MuiTableRow>\n <TableCell\n colSpan={columns.length + (selectable ? 1 : 0)}\n sx={styles.empty}\n >\n {emptyContent ?? null}\n </TableCell>\n </MuiTableRow>\n ) : (\n rows.map((row, index) => {\n const rowId = resolveRowId(row, index)\n const isSelected = selectionSet.has(rowId)\n return (\n <MuiTableRow\n key={rowId}\n hover\n selected={isSelected}\n onClick={() => onRowClick?.(row)}\n onMouseEnter={() => onRowHover?.(row)}\n onMouseLeave={() => onRowHover?.(null)}\n sx={{\n ...styles.row,\n ...(onRowClick ? styles.rowClickable : null),\n }}\n >\n {selectable ? (\n <TableCell padding='checkbox'>\n <Checkbox\n checked={isSelected}\n onClick={(e) => {\n e.stopPropagation()\n handleSelectRow(rowId)\n }}\n slotProps={{\n input: {\n 'aria-label': _labels.selectRow(rowId),\n },\n }}\n />\n </TableCell>\n ) : null}\n {columns.map((column) => (\n <TableCell key={column.id} align={column.align}>\n {column.formatter\n ? column.formatter(row[column.id], row)\n : stringifyCell(row[column.id])}\n </TableCell>\n ))}\n </MuiTableRow>\n )\n })\n )}\n </TableBody>\n </MuiTable>\n </TableContainer>\n {showPagination ? (\n <TablePagination\n component='div'\n count={total}\n page={page}\n rowsPerPage={pageSize}\n rowsPerPageOptions={[...pageSizeOptions]}\n onPageChange={(_, next) => onPageChange?.(next)}\n onRowsPerPageChange={(e) => {\n const next = parseInt(e.target.value, 10)\n onPageSizeChange?.(next)\n }}\n labelRowsPerPage={_labels.rowsPerPage}\n labelDisplayedRows={({ from, to, count }) =>\n _labels.paginationOf(from, to, count)\n }\n sx={styles.pagination}\n ActionsComponent={PaginationActions}\n />\n ) : null}\n </Box>\n )\n}\n\nfunction stringifyCell(value: unknown): React.ReactNode {\n if (value == null) return ''\n if (typeof value === 'string' || typeof value === 'number') return value\n if (typeof value === 'boolean') return String(value)\n if (Array.isArray(value) || typeof value === 'object') {\n return JSON.stringify(value)\n }\n return ''\n}\n\n/**\n * Build the `ActionsComponent` used by `<TablePagination>` — four MUI\n * `IconButton`s for first / previous / next / last. We provide this\n * ourselves so the Meridian theme's `defaultProps.ActionsComponent`\n * (which depends on `react-intl`) is bypassed at the call site without\n * disturbing the rest of the Meridian theme. The factory closes over\n * the merged label set so aria-labels stay consistent with the rest\n * of the table's i18n surface.\n */\nfunction makePaginationActions(labels: TableLabels) {\n return function PaginationActions({\n count,\n page,\n rowsPerPage,\n onPageChange,\n }: TablePaginationActionsProps) {\n const lastPage = Math.max(0, Math.ceil(count / rowsPerPage) - 1)\n return (\n <Box sx={styles.paginationActions}>\n <IconButton\n size='small'\n onClick={(e) => onPageChange(e, 0)}\n disabled={page === 0}\n aria-label={labels.firstPage}\n >\n <FirstPageIcon fontSize='small' />\n </IconButton>\n <IconButton\n size='small'\n onClick={(e) => onPageChange(e, page - 1)}\n disabled={page === 0}\n aria-label={labels.previousPage}\n >\n <KeyboardArrowLeft fontSize='small' />\n </IconButton>\n <IconButton\n size='small'\n onClick={(e) => onPageChange(e, page + 1)}\n disabled={page >= lastPage}\n aria-label={labels.nextPage}\n >\n <KeyboardArrowRight fontSize='small' />\n </IconButton>\n <IconButton\n size='small'\n onClick={(e) => onPageChange(e, lastPage)}\n disabled={page >= lastPage}\n aria-label={labels.lastPage}\n >\n <LastPageIcon fontSize='small' />\n </IconButton>\n </Box>\n )\n }\n}\n","import { toCsvString } from '../actions/download'\nimport type {\n TableColumn,\n TableRow,\n TableSortDirection,\n TableWidgetData,\n} from './types'\n\n/**\n * Compares two values with a consistent ordering across primitive types.\n * Strings use locale comparison; numbers subtract; booleans rank false < true;\n * objects/arrays compare by JSON serialization. Null/undefined sort to the end\n * regardless of direction.\n */\nexport function compareValues(\n a: unknown,\n b: unknown,\n direction: TableSortDirection,\n): number {\n if (a == null && b == null) return 0\n if (a == null) return 1\n if (b == null) return -1\n let cmp = 0\n if (typeof a === 'string' && typeof b === 'string') {\n cmp = a.localeCompare(b)\n } else if (typeof a === 'number' && typeof b === 'number') {\n cmp = a - b\n } else if (typeof a === 'boolean' && typeof b === 'boolean') {\n cmp = a === b ? 0 : a ? 1 : -1\n } else if (typeof a === 'object' || typeof b === 'object') {\n cmp = JSON.stringify(a).localeCompare(JSON.stringify(b))\n }\n return direction === 'asc' ? cmp : -cmp\n}\n\n/** Returns a new array sorted by the named column. Does not mutate the input. */\nexport function sortRows<T extends TableRow>(\n rows: readonly T[],\n columnId: string,\n direction: TableSortDirection,\n): T[] {\n return [...rows].sort((a, b) =>\n compareValues(a[columnId], b[columnId], direction),\n )\n}\n\n/** Returns the slice for the requested page. Out-of-range pages return []. */\nexport function paginateRows<T>(\n rows: readonly T[],\n page: number,\n pageSize: number,\n): T[] {\n if (pageSize <= 0) return rows.slice()\n const start = page * pageSize\n return rows.slice(start, start + pageSize)\n}\n\n/**\n * Resolves the effective column list. When the widget store has a\n * `columnOrder` set (e.g. ChangeColumn was used), the column array is\n * reordered to match. Unknown ids in the order are skipped; columns not\n * present in the order keep their original relative position at the end.\n */\nexport function resolveColumns(\n columns: readonly TableColumn[],\n columnOrder: readonly string[] | undefined,\n): readonly TableColumn[] {\n if (!columnOrder || columnOrder.length === 0) return columns\n const byId = new Map(columns.map((c) => [c.id, c]))\n const ordered: TableColumn[] = []\n const seen = new Set<string>()\n for (const id of columnOrder) {\n const c = byId.get(id)\n if (c && !seen.has(id)) {\n ordered.push(c)\n seen.add(id)\n }\n }\n for (const c of columns) {\n if (!seen.has(c.id)) ordered.push(c)\n }\n return ordered\n}\n\n/** Applies sort and pagination to the input data. Pure. */\nexport function deriveVisibleRows<T extends TableRow>(\n rows: readonly T[],\n options: {\n sort?: { columnId: string | null; direction: TableSortDirection }\n page: number\n pageSize: number\n },\n): { sorted: readonly T[]; visible: T[] } {\n const sorted =\n options.sort?.columnId != null\n ? sortRows(rows, options.sort.columnId, options.sort.direction)\n : rows\n const visible = paginateRows(sorted, options.page, options.pageSize)\n return { sorted, visible }\n}\n\nexport function tableDataToCsv(\n data: TableWidgetData,\n columns: readonly TableColumn[],\n): string {\n // Pre-stringify with the table's own header/cell rules, then delegate the\n // CSV assembly (quoting + spreadsheet formula-injection guard) to the shared\n // `toCsvString` so escaping stays identical to every other widget's export.\n const rows: string[][] = [columns.map((c) => stringifyHeader(c.label))]\n for (const row of data) {\n rows.push(columns.map((c) => stringifyCell(row[c.id])))\n }\n return toCsvString(rows)\n}\n\nfunction stringifyHeader(label: unknown): string {\n if (typeof label === 'string') return label\n if (typeof label === 'number' || typeof label === 'boolean')\n return String(label)\n return ''\n}\n\nfunction stringifyCell(value: unknown): string {\n if (value == null) return ''\n if (typeof value === 'string') return value\n if (typeof value === 'number' || typeof value === 'boolean')\n return String(value)\n if (Array.isArray(value) || typeof value === 'object')\n return JSON.stringify(value)\n return ''\n}\n","import { useCallback, useMemo } from 'react'\nimport {\n getWidgetStore,\n useWidget,\n useWidgetId,\n useWidgetShallow,\n} from '../stores'\nimport { TableUI, type TableUIProps } from './table-ui'\nimport {\n DEFAULT_TABLE_PAGE_SIZE,\n type TableColumn,\n type TableRow,\n type TableSortState,\n type TableWidgetState,\n} from './types'\nimport { deriveVisibleRows, resolveColumns } from './helpers'\n\nexport interface TableProps<T extends TableRow = TableRow> extends Pick<\n TableUIProps<T>,\n | 'pageSizeOptions'\n | 'selectable'\n | 'labels'\n | 'emptyContent'\n | 'size'\n | 'keyColumn'\n> {\n /**\n * Column definitions. Order can be overridden by ChangeColumn via the\n * `columnOrder` field on the extended widget state.\n */\n columns: readonly TableColumn[]\n /**\n * When set, render only the first `visibleColumns` entries **after**\n * applying the user's `columnOrder` from the store. Useful for showing\n * a compact projection while letting consumers (e.g. `Widget.ChangeColumn`)\n * see the full column list. When omitted, every column renders.\n */\n visibleColumns?: number\n /** Initial page size (only on first mount; afterwards lives on the store). */\n initialPageSize?: number\n /** Selected row ids (destination-owned). */\n selection?: readonly (string | number)[]\n onSelectionChange?: (next: readonly (string | number)[]) => void\n onRowClick?: (row: T) => void\n onRowHover?: (row: T | null) => void\n /**\n * When `true`, the bridge stops sorting and paginating locally and\n * renders `data` as-is — the consumer is then responsible for\n * refetching the slice that matches the active `page` / `pageSize` /\n * `sort` from the outbound callbacks below. `total` is required in\n * this mode (the server already knows the full row count; the\n * widget can't infer it from a partial page).\n */\n remote?: boolean\n /**\n * Server-reported total row count. Required when `remote === true`;\n * ignored in local mode (where the bridge derives total from the\n * sorted result of `deriveVisibleRows`).\n */\n total?: number\n /** Fires after the store-level sort write so the consumer can refetch. */\n onSortChange?: (next: TableSortState) => void\n /** Fires after the store-level page write so the consumer can refetch. */\n onPageChange?: (page: number) => void\n /** Fires after the store-level pageSize write so the consumer can refetch. */\n onPageSizeChange?: (pageSize: number) => void\n}\n\n/**\n * Bridge component — reads the widget store's `data`, applies sort + pagination\n * locally, and feeds `<TableUI />`. Sort, page, and pageSize live on the\n * extended widget state ({@link TableWidgetState}).\n */\nexport function Table<T extends TableRow = TableRow>({\n columns,\n visibleColumns,\n initialPageSize = DEFAULT_TABLE_PAGE_SIZE,\n selection,\n onSelectionChange,\n onRowClick,\n onRowHover,\n remote = false,\n total: remoteTotal,\n onSortChange,\n onPageChange,\n onPageSizeChange,\n ...uiProps\n}: TableProps<T>) {\n const id = useWidgetId()\n const data = useWidget(id, (s) => s.data as readonly T[] | undefined)\n const ui = useWidgetShallow<\n {\n sort: TableSortState | undefined\n page: number\n pageSize: number\n columnOrder: readonly string[] | undefined\n },\n TableWidgetState\n >(id, (s) => ({\n sort: s.sort,\n page: s.page ?? 0,\n pageSize: s.pageSize ?? initialPageSize,\n columnOrder: s.columnOrder,\n }))\n\n const orderedColumns = useMemo(() => {\n const reordered = resolveColumns(columns, ui.columnOrder)\n return visibleColumns == null\n ? reordered\n : reordered.slice(0, visibleColumns)\n }, [columns, ui.columnOrder, visibleColumns])\n\n // In remote mode the consumer already paginated / sorted server-side,\n // so pass `data` and `total` straight through. Local mode keeps the\n // bridge-driven sort + slice via `deriveVisibleRows`.\n const { rows, totalRows } = useMemo(() => {\n if (remote) {\n return {\n rows: data ?? [],\n totalRows: remoteTotal ?? 0,\n }\n }\n const { sorted, visible } = deriveVisibleRows(data ?? [], {\n sort: ui.sort,\n page: ui.page,\n pageSize: ui.pageSize,\n })\n return { rows: visible, totalRows: sorted.length }\n }, [remote, data, remoteTotal, ui.sort, ui.page, ui.pageSize])\n\n const handleSortChange = useCallback(\n (next: TableSortState) => {\n getWidgetStore(id).setState({\n sort: next,\n page: 0,\n } as Partial<TableWidgetState>)\n onSortChange?.(next)\n },\n [id, onSortChange],\n )\n\n const handlePageChange = useCallback(\n (page: number) => {\n getWidgetStore(id).setState({ page } as Partial<TableWidgetState>)\n onPageChange?.(page)\n },\n [id, onPageChange],\n )\n\n const handlePageSizeChange = useCallback(\n (pageSize: number) => {\n getWidgetStore(id).setState({\n pageSize,\n page: 0,\n } as Partial<TableWidgetState>)\n onPageSizeChange?.(pageSize)\n },\n [id, onPageSizeChange],\n )\n\n return (\n <TableUI\n {...uiProps}\n columns={orderedColumns}\n rows={rows}\n total={totalRows}\n page={ui.page}\n pageSize={ui.pageSize}\n sort={ui.sort}\n selection={selection}\n onSortChange={handleSortChange}\n onPageChange={handlePageChange}\n onPageSizeChange={handlePageSizeChange}\n onSelectionChange={onSelectionChange}\n onRowClick={onRowClick}\n onRowHover={onRowHover}\n />\n )\n}\n","import {\n Box,\n Skeleton,\n Table as MuiTable,\n TableBody,\n TableCell,\n TableHead,\n TableRow as MuiTableRow,\n type TableProps as MuiTableProps,\n} from '@mui/material'\nimport { styles } from './style'\n\nexport interface TableSkeletonProps {\n /** Number of body rows to render. Defaults to `5` (matches v1). */\n rows?: number\n /** Number of columns to render. Defaults to `4` (matches v1). */\n columns?: number\n /**\n * Forwarded to MUI's `<Table size>` so the loading layout matches the\n * size you'll render in {@link TableUI}. Leave `undefined` (the\n * default) to use MUI's own default density.\n */\n size?: MuiTableProps['size']\n}\n\n/**\n * Loading placeholder for the Table widget. Renders the same MUI table\n * primitives that {@link TableUI} uses so the loading layout (column\n * widths, header band, row density) doesn't shift when data resolves.\n *\n * Mirrors the v1 widget's `<TableSkeleton>` structure with v2's themed\n * `styles.headerCell`.\n */\nexport function TableSkeleton({\n rows = 5,\n columns = 4,\n size,\n}: TableSkeletonProps) {\n return (\n <Box sx={styles.container} aria-label='Table skeleton'>\n <MuiTable size={size} sx={styles.table} stickyHeader>\n <TableHead>\n <MuiTableRow>\n {Array.from({ length: columns }).map((_, c) => (\n <TableCell key={`head-${c}`} sx={styles.headerCell}>\n <Skeleton variant='text' width='80%' height={24} />\n </TableCell>\n ))}\n </MuiTableRow>\n </TableHead>\n <TableBody>\n {Array.from({ length: rows }).map((_, r) => (\n <MuiTableRow key={`row-${r}`} sx={styles.row}>\n {Array.from({ length: columns }).map((__, c) => (\n <TableCell key={`cell-${r}-${c}`}>\n <Skeleton variant='text' width='70%' height={20} />\n </TableCell>\n ))}\n </MuiTableRow>\n ))}\n </TableBody>\n </MuiTable>\n </Box>\n )\n}\n","import {\n buildCsvDownloadItem,\n buildPngDownloadItem,\n type DownloadItem,\n} from '../actions/download'\nimport { tableDataToCsv } from './helpers'\nimport type { TableColumn, TableWidgetData } from './types'\n\n/**\n * Download menu items for the Table widget. Always includes a CSV item\n * that pulls the latest data from the widget store via `getData()` (so\n * locked / sorted / filtered state is honored); headers come from\n * `column.label`, cells from `row[column.id]`. When `getCaptureEl` is\n * supplied, prepends a PNG item that rasterises the captured element via\n * `html2canvas`.\n */\nexport function createTableDownloadConfig(opts: {\n filename: string\n getData: () => TableWidgetData\n columns: readonly TableColumn[]\n getCaptureEl?: () => HTMLElement | null\n pngPixelRatio?: number\n pngBackgroundColor?: string | null\n}): DownloadItem[] {\n const items: DownloadItem[] = []\n if (opts.getCaptureEl) {\n items.push(\n buildPngDownloadItem({\n filename: opts.filename,\n getCaptureEl: opts.getCaptureEl,\n pixelRatio: opts.pngPixelRatio,\n backgroundColor: opts.pngBackgroundColor,\n }),\n )\n }\n items.push(\n buildCsvDownloadItem({\n filename: opts.filename,\n getCsv: () => tableDataToCsv(opts.getData(), opts.columns),\n }),\n )\n return items\n}\n","/**\n * `LockSelection` filter for Table. Data is a FLAT `TableRow[]` (unlike every\n * other widget's `X[][]` series shape) and row identity comes from\n * `row[keyColumn]` (default `'id'`), not `name` — so `filterByLockedItems`\n * doesn't apply here (its outer `.map` treats each row as a \"series\", and a\n * plain row object isn't an array, so it would silently pass everything\n * through unfiltered). Falls back to the row's index when the identity\n * column is nullish, mirroring `TableUI`'s own `resolveRowId`.\n *\n * `keyColumn` arrives as `LockSelection`'s `filterKey`, so pass this by\n * reference: `filterFn={filterTableByLockedRows} filterKey={keyColumn}`.\n * Don't close over it — `filterFn`'s identity is not a pipeline dependency,\n * so a captured key changes without re-running anything.\n */\nexport function filterTableByLockedRows(\n input: unknown,\n lockedItems: readonly (string | number)[],\n keyColumn: string | number = 'id',\n): unknown {\n if (lockedItems.length === 0) return input\n if (!Array.isArray(input)) return input\n const locked = new Set<string | number>(lockedItems)\n return input.filter((row: unknown, index: number): boolean => {\n if (row == null || typeof row !== 'object') return false\n const id = (row as Record<string, unknown>)[keyColumn] ?? index\n return (typeof id === 'string' || typeof id === 'number') && locked.has(id)\n })\n}\n"],"mappings":";;;;;;;AAwBA,IAAM,IAA4B;CAAE,YAAY;CAAK,OAAO;AAAe,GAE9D,IAAoC;CAC/C,WAAW;CACX,YAAY,MAAO,cAAc;CACjC,aAAa;CACb,eAAe,GAAM,GAAI,MACvB,kBAAA,GAAA,EAAA,UAAA,CACE,kBAAC,GAAD;EAAK,WAAU;EAAO,IAAI;EAAY,UAAA,GAAG,EAAK,GAAG;CAAU,CAAA,GAC1D,OAAO,GACR,EAAA,CAAA;CAEJ,WAAW;CACX,cAAc;CACd,UAAU;CACV,UAAU;AACZ,GCaa,IAA0B,IAC1B,IAAkC;CAAC;CAAI;CAAI;CAAI;AAAG,GCpDlD,IAAS;CACpB,WAAW;EACT,OAAO;EACP,WAAW;CACb;CAEA,OAAO,EACL,UAAU,EACZ;CACA,YAAY;EACV,YAAY;EACZ,iBAAiB;CACnB;CAKA,KAAK,EACH,oCAAoC,EAClC,QAAQ,EACV,EACF;CACA,cAAc,EACZ,QAAQ,UACV;CACA,YAAY;EACV,WAAW;EACX,aAAa;CACf;CACA,mBAAmB;EACjB,SAAS;EACT,YAAY;EACZ,KAAK;EACL,IAAI;CACN;CACA,OAAO;EACL,WAAW;EACX,OAAO;EACP,IAAI;CACN;AACF;;;AC6BA,SAAgB,EAAA,GAoBI;iBApBmC,EACrD,YACA,SACA,UACA,SACA,aACA,iBAAA,GACA,SACA,WAAA,GACA,cACA,YAAA,GACA,iBACA,iBACA,qBACA,sBACA,eACA,eACA,WACA,iBACA,YAnBqDA,GAMrD,IAAA,MAAA,KAAA,IAAkB,IAAlBC,GAEA,IAAA,MAAA,KAAA,IAAY,OAAZC,GAEA,IAAA,MAAA,KAAA,KAAAC;CAWA,AAAA,QAAA,IAAA,aAA6B,gBAIX,EAAK,MAAM,MAAM,EAAE,MAAc,IAC7C,KAEF,QAAQ,MACN,qDAAqD,EAAU,gGAGjE;CAIKC,IAAAA;CAA8B,AAAA,EAAA,OAAA,gBAA9B,IAAA;EAAE,GAAG;EAAsB,GAAG;CAAO,GAAP,EAAA,KAAA;CADvC,IAAM,IAAUC,GASV,KAAiB,IADH,KAAK,IAAI,GAAG,CACD,GAOvBC;CAAsB,AAAA,EAAA,OAAA,iBAAtB,KAAA,GAAsB,CAAO,GAAP,EAAA,KAAA;CAD9B,IAAM,KAAoBC,IAKOC;0BAAa,IAAA,KAAA,CAAC,GAAd,EAAA,KAAA;CAAzBC,IAAAA;CAAyBD,AAAAA,EAAAA,OAAAA,iBAAzB,KAAA,IAAI,IAAqBA,CAAe,GAAfA,EAAAA,KAAAA;CADjC,IAAM,IAAeE,IAWnBC;CACO,AAAA,EAAA,OAAA,iBADP,MAAC,GAAQ,MACN,EAAI,MAAc,GAAd,EAAA,KAAA;CAFT,IAAM,IAAeC,IAKYC;CAAS,AAAA,EAAA,QAAA,KAAA,EAAA,QAAT,KAAK,KAAA,EAAA,IAAI,CAAY,GAAZ,EAAA,MAAA,GAAT,EAAA,MAAA;CAAjC,IAAM,IAAaC,IAEjBC;CAAkD,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAlD,KAAA,EAAW,SAAS,KAAK,EAAW,OAAO,MAAO,EAAa,IAAI,CAAE,CAAC,GAAtEC,EAAAA,MAAAA,GAAkD,EAAA,MAAA;CADpD,IAAM,IACJD,IAEAE;CAAC,AAAA,EAAA,QAAA,KAAA,EAAA,QAAqB,KAAA,EAAA,QAAwB,KAA9C,KAAA,CAAC,KAAqB,EAAW,MAAM,MAAO,EAAa,IAAIC,CAAE,CAAC,GAAjE,EAAA,MAAA,GAAqB,EAAA,MAAA,GAAwB,EAAA,MAAA;CADhD,IAAM,KACJD,IAEiBE;CACZ,AAAA,EAAA,QAAA,KAAA,EAAA,QACiBC,GAAAA,YAAAA,EAAAA,QAEHC,GAAAA,aAJF,MAAC,MAAqB;EACvC,IAAI,CAAC,GAAc;EAEnB,IAAM,IADU,GAAM,aAAa,KAEtB,GAAM,cAAc,QAAQ,SAAS;EAClD,EAAa;GAAE;GAAU,WAAW;EAAQ,CAAC;CAC/C,GALO,EAAA,MAAA,GACiBD,EAAAA,MAAAA,GAAAA,UAEHC,EAAAA,MAAAA,GAAAA;CAJrB,IAAM,IAAaF,IAQWG;CAExB,AAAA,EAAA,QAAA,KAAA,EAAA,QADC,KAAA,EAAA,QAGiC,KAAA,EAAA,QAAjC,KAJuB,WAAM;EAC7B,OACL;OAAI,GACF,GACG,KAAa,CAAC,EAAA,CAAG,QAAQ,MAAO,CAAC,EAAW,SAASJ,CAAE,CAAC,CAC3D;QACK;IACL,IAAM,IAAS,IAAI,IAAqB,KAAa,CAAC,CAAC;IACvD,KAAK,IAAMA,KAAM,GAAY,EAAO,IAAIA,CAAE;IAC1C,EAAkB,CAAC,GAAG,CAAM,CAAC;GAC/B;;CACF,GATM,EAAA,MAAA,GADC,EAAA,MAAA,GAGiC,EAAA,MAAA,GAAjC,EAAA,MAAA;CAJP,IAAM,KAAwBI,IAaNC;CACjB,AAAA,EAAA,QAAA,KAAA,EAAA,QACiC,KAFhB,MAAC,MAA2B;EAClD,IAAI,CAAC,GAAmB;EACxB,IAAM,IAAO,IAAI,IAAqB,KAAa,CAAC,CAAC;EAGrD,AAFI,EAAK,IAAI,CAAK,IAAG,EAAK,OAAO,CAAK,IACjC,EAAK,IAAI,CAAK,GACnB,EAAkB,CAAC,GAAG,CAAI,CAAC;CAC7B,GALO,EAAA,MAAA,GACiC,EAAA,MAAA;CAFxC,IAAM,KAAkBA,IAcXC;CAO8BC,AAAAA,EAAAA,QAAAA,KAAAA,EAAAA,QAJhB,KAAA,EAAA,QAEC,MAAA,EAAA,QALf,KAAA,EAAA,QAIoB,MAJpB,IAAA,IACC,kBAAC,GAAD;EAAW,SAAQ;EAAW,IAAI,EAAO;EACvC,UAAA,kBAAC,GAAD;GACE,SAAS;GACT,eAAe;GACf,UAAU;GACV,WAAW,EACT,OAAO,EAAE,cAAc,EAAQ,UAAU,EAC3C;EACD,CAAA;CACQ,CAAA,IACT,MAJ2BA,EAAAA,MAAAA,GAJhB,EAAA,MAAA,GAEC,EAAA,MAAA,IALf,EAAA,MAAA,GAIoB,EAAA,MAAA;CAQpBC,IAAAA;CAiBwB,IAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAJC,KAAA,EAAA,QAZDN,GAAAA,YAAAA,EAAAA,QACYC,GAAAA,WAAAA;EAFxBM,IAAAA;EAiBY,EAAA,QAAA,KAAA,EAAA,QAJC,KAAA,EAAA,QAZDP,GAAAA,YAAAA,EAAAA,QACYC,GAAAA,aAFxB,KAAC,MAAW;GACvB,IAAM,IAAW,GAAM,aAAa,EAAO,IACrC,IAAY,IAAW,GAAM,YAAY,KAAA;GAC/C,OACE,kBAAC,GAAD;IAEE,OAAO,EAAO;IACd,eAAe;IACf,IAAI,EAAO;IACX,OACE,EAAO,SAAS,OAAiC,KAAA,IAA1B,EAAE,OAAO,EAAO,MAAM;IAG9C,UAAA,EAAO,YAAY,IAClB,kBAAC,GAAD;KACE,QAAQ;KACR,WAAW,KAAa;KACxB,eAAe,EAAW,EAAO,EAAE;KAElC,UAAA,EAAO;IACM,CAAA,IAEhB,EAAO;GAEA,GAnBJ,EAAO,EAmBH;EAEf,GATyB,EAAA,MAAA,GAJC,EAAA,MAAA,GAZDD,EAAAA,MAAAA,GAAAA,UACYC,EAAAA,MAAAA,GAAAA,mCAFpC,IAAA,EAAQ,IAAIM,CA0BZ,GA1BA,EAAA,MAAA,GAiBwB,EAAA,MAAA,GAJC,EAAA,MAAA,GAZDP,EAAAA,MAAAA,GAAAA,UACYC,EAAAA,MAAAA,GAAAA;;CAhBzCO,IAAAA;CAEKJ,AAAAA,EAAAA,QAAAA,KAAAA,EAAAA,QAYAE,KAdL,IAAA,kBAAC,GAAD,EAAA,UACE,kBAAC,GAAD,EAAA,UAAA,CACGF,GAYAE,CA2BU,EAAA,CAAA,EACJ,CAAA,GAxCNF,EAAAA,MAAAA,GAYAE,EAAAA,MAAAA;CA8BFG,IAAAA;CAoC+B,AAAA,EAAA,QAAA,KAAA,EAAA,QAjCjBC,KAAAA,EAAAA,QAGR,KAAA,EAAA,QA0BS,MAAA,EAAA,QAdO,KAAA,EAAA,QACK,KAAA,EAAA,QARV,KAAA,EAAA,QAXjBC,KAAAA,EAAAA,QAGgC,KAAA,EAAA,QASV,KAZtB,IAAA,EAAK,WAAW,IACf,kBAAC,GAAD,EAAA,UACE,kBAAC,GAAD;EACE,SAAS,EAAQ,SAAU;EAC3B,IAAI,EAAO;EAEV,UAAA,KAAgB;CACR,CAAA,EACA,CAAA,IAEb,EAAK,KAAK,GAAK,MAAU;EACvB,IAAMC,IAAQ,EAAaC,GAAKC,CAAK,GAC/B,IAAa,EAAa,IAAIF,CAAK;EACzC,OACE,kBAAC,GAAD;GAEE,OAAA;GACA,UAAU;GACV,eAAe,IAAaC,CAAG;GAC/B,oBAAoB,IAAaA,CAAG;GACpC,oBAAoB,IAAa,IAAI;GACrC,IAAI;IACF,GAAG,EAAO;IACV,GAAI,IAAa,EAAO,eAAe;GACzC;GAVF,UAAA,CAYG,IACC,kBAAC,GAAD;IAAW,SAAQ;IACjB,UAAA,kBAAC,GAAD;KACE,SAAS;KACT,UAAU,MAAM;MAEd,AADA,EAAE,gBAAgB,GAClB,GAAgBD,CAAK;KACvB;KACA,WAAW,EACT,OAAO,EACL,cAAc,EAAQ,UAAUA,CAAK,EACvC,EACF;IACD,CAAA;GACQ,CAAA,IACT,MACH,EAAQ,KAAK,MACZ,kBAAC,GAAD;IAA2B,OAAOG,EAAO;IACtCA,UAAAA,EAAO,YACJA,EAAO,UAAUF,EAAIE,EAAO,KAAKF,CAAG,IACpC,GAAcA,EAAIE,EAAO,GAAG;GACvB,GAJKA,EAAO,EAIZ,CACZ,CACU;EAlCNH,GAAAA,CAkCM;CAEjB,CAAC,GAf6B,EAAA,MAAA,GAjCjBF,EAAAA,MAAAA,GAGR,EAAA,MAAA,GA0BS,EAAA,MAAA,IAdO,EAAA,MAAA,GACK,EAAA,MAAA,GARV,EAAA,MAAA,GAXjBC,EAAAA,MAAAA,GAGgC,EAAA,MAAA,GASV,EAAA,MAAA;CAbzBK,IAAAA;CACGP,AAAAA,EAAAA,QAAAA,iBADH,IAAA,kBAAC,GAAD,EAAA,UACGA,EAqDQ,CAAA,GArDRA,EAAAA,MAAAA;CA9CPQ,IAAAA;CAC+B,AAAA,EAAA,QAAA,KAAA,EAAA,QAC3BT,KAAAA,EAAAA,QA2CAQ,KA7CJ,IAAA,kBAAC,GAAD,EAAA,UACE,kBAAC,GAAD;EAAU,cAAA;EAAmB;EAAM,IAAI,EAAO;EAA9C,UAAA,CACER,GA2CAQ,CAuDQ;CACI,CAAA,EAAA,CAAA,GApGe,EAAA,MAAA,GAC3BR,EAAAA,MAAAA,GA2CAQ,EAAAA,MAAAA;CAyDHE,IAAAA;CAiBqB,AAAA,EAAA,QAAA,MAAA,EAAA,QAHhB,KAAA,EAAA,QAPyB,KAAA,EAAA,QAGzB,KAAA,EAAA,QANI,KAAA,EAAA,QACO,KAAA,EAAA,QACW,KAAA,EAAA,QAN3B,MAAA,EAAA,QAGU,KAHV,IAAA,KACC,kBAAC,GAAD;EACE,WAAU;EACV,OAAO;EACD;EACN,aAAa;EACb,oBAAoB,CAAC,GAAG,CAAe;EACvC,eAAe,GAAG,MAAS,IAAeC,CAAI;EAC9C,sBAAsB,MAAM;GAC1B,IAAMA,IAAO,SAASC,EAAE,OAAO,OAAO,EAAE;GACxC,IAAmBD,CAAI;EACzB;EACA,kBAAkB,EAAQ;EAC1B,qBAAA,MAAqB;GAAE,IAAA,EAAA,SAAM,OAAI,aAAZE;GACnB,OAAA,EAAQ,aAAa,GAAM,GAAI,CAAK;EADC;EAGvC,IAAI,EAAO;EACX,kBAAkB;CACnB,CAAA,IACC,MAFkB,EAAA,MAAA,IAHhB,EAAA,MAAA,GAPyB,EAAA,MAAA,GAGzB,EAAA,MAAA,GANI,EAAA,MAAA,GACO,EAAA,MAAA,GACW,EAAA,MAAA,GAN3B,EAAA,MAAA,IAGU,EAAA,MAAA;CA1GbC,IAAAA;CADF,OAEIL,EAAAA,QAAAA,KAAAA,EAAAA,QAsGCC,KAvGH,KAAA,kBAAC,GAAD;EAAK,IAAI,EAAO;EAAhB,UAAA,CACED,GAsGCC,CAoBE;KA1HHD,EAAAA,MAAAA,GAsGCC,EAAAA,MAAAA,6BAvGHI;AA6HJ;AAEA,SAAS,GAAc,GAAiC;CAOtD,OANI,KAAS,OAAa,KACtB,OAAO,KAAU,YAAY,OAAO,KAAU,WAAiB,IAC/D,OAAO,KAAU,YAAkB,OAAO,CAAK,IAC/C,MAAM,QAAQ,CAAK,KAAK,OAAO,KAAU,WACpC,KAAK,UAAU,CAAK,IAEtB;AACT;AAWA,SAAS,GAAsB,GAAqB;CAClD,OAAO,SAA2B,EAChC,UACA,SACA,gBACA,mBAC8B;EAC9B,IAAM,IAAW,KAAK,IAAI,GAAG,KAAK,KAAK,IAAQ,CAAW,IAAI,CAAC;EAC/D,OACE,kBAAC,GAAD;GAAK,IAAI,EAAO;GAAhB,UAAA;IACE,kBAAC,GAAD;KACE,MAAK;KACL,UAAU,MAAM,EAAa,GAAG,CAAC;KACjC,UAAU,MAAS;KACnB,cAAY,EAAO;KAEnB,UAAA,kBAAC,GAAD,EAAe,UAAS,QAAS,CAAA;IACvB,CAAA;IACZ,kBAAC,GAAD;KACE,MAAK;KACL,UAAU,MAAM,EAAa,GAAG,IAAO,CAAC;KACxC,UAAU,MAAS;KACnB,cAAY,EAAO;KAEnB,UAAA,kBAAC,GAAD,EAAmB,UAAS,QAAS,CAAA;IAC3B,CAAA;IACZ,kBAAC,GAAD;KACE,MAAK;KACL,UAAU,MAAM,EAAa,GAAG,IAAO,CAAC;KACxC,UAAU,KAAQ;KAClB,cAAY,EAAO;KAEnB,UAAA,kBAAC,GAAD,EAAoB,UAAS,QAAS,CAAA;IAC5B,CAAA;IACZ,kBAAC,GAAD;KACE,MAAK;KACL,UAAU,MAAM,EAAa,GAAG,CAAQ;KACxC,UAAU,KAAQ;KAClB,cAAY,EAAO;KAEnB,UAAA,kBAAC,GAAD,EAAc,UAAS,QAAS,CAAA;IACtB,CAAA;GACT;;CAET;AACF;;;ACjWA,SAAgB,EACd,GACA,GACA,GACQ;CACR,IAAI,KAAK,QAAQ,KAAK,MAAM,OAAO;CACnC,IAAI,KAAK,MAAM,OAAO;CACtB,IAAI,KAAK,MAAM,OAAO;CACtB,IAAI,IAAM;CAUV,OATI,OAAO,KAAM,YAAY,OAAO,KAAM,WACxC,IAAM,EAAE,cAAc,CAAC,IACd,OAAO,KAAM,YAAY,OAAO,KAAM,WAC/C,IAAM,IAAI,IACD,OAAO,KAAM,aAAa,OAAO,KAAM,YAChD,IAAM,MAAM,IAAI,IAAI,IAAI,IAAI,MACnB,OAAO,KAAM,YAAY,OAAO,KAAM,cAC/C,IAAM,KAAK,UAAU,CAAC,CAAC,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,IAElD,MAAc,QAAQ,IAAM,CAAC;AACtC;AAGA,SAAgB,EACd,GACA,GACA,GACK;CACL,OAAO,CAAC,GAAG,CAAI,CAAC,CAAC,MAAM,GAAG,MACxB,EAAc,EAAE,IAAW,EAAE,IAAW,CAAS,CACnD;AACF;AAGA,SAAgB,EACd,GACA,GACA,GACK;CACL,IAAI,KAAY,GAAG,OAAO,EAAK,MAAM;CACrC,IAAM,IAAQ,IAAO;CACrB,OAAO,EAAK,MAAM,GAAO,IAAQ,CAAQ;AAC3C;AAQA,SAAgB,EACd,GACA,GACwB;CACxB,IAAI,CAAC,KAAe,EAAY,WAAW,GAAG,OAAO;CACrD,IAAM,IAAO,IAAI,IAAI,EAAQ,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAC5C,IAAyB,CAAC,GAC1B,oBAAO,IAAI,IAAY;CAC7B,KAAK,IAAM,KAAM,GAAa;EAC5B,IAAM,IAAI,EAAK,IAAI,CAAE;EACrB,AAAI,KAAK,CAAC,EAAK,IAAI,CAAE,MACnB,EAAQ,KAAK,CAAC,GACd,EAAK,IAAI,CAAE;CAEf;CACA,KAAK,IAAM,KAAK,GACd,AAAK,EAAK,IAAI,EAAE,EAAE,KAAG,EAAQ,KAAK,CAAC;CAErC,OAAO;AACT;AAGA,SAAgB,EACd,GACA,GAKwC;CACxC,IAAM,IACJ,EAAQ,MAAM,YAAY,OAEtB,IADA,EAAS,GAAM,EAAQ,KAAK,UAAU,EAAQ,KAAK,SAAS;CAGlE,OAAO;EAAE;EAAQ,SADD,EAAa,GAAQ,EAAQ,MAAM,EAAQ,QAC1C;CAAQ;AAC3B;AAEA,SAAgB,EACd,GACA,GACQ;CAIR,IAAM,IAAmB,CAAC,EAAQ,KAAK,MAAM,EAAgB,EAAE,KAAK,CAAC,CAAC;CACtE,KAAK,IAAM,KAAO,GAChB,EAAK,KAAK,EAAQ,KAAK,MAAM,EAAc,EAAI,EAAE,GAAG,CAAC,CAAC;CAExD,OAAO,EAAY,CAAI;AACzB;AAEA,SAAS,EAAgB,GAAwB;CAI/C,OAHI,OAAO,KAAU,WAAiB,IAClC,OAAO,KAAU,YAAY,OAAO,KAAU,YACzC,OAAO,CAAK,IACd;AACT;AAEA,SAAS,EAAc,GAAwB;CAO7C,OANI,KAAS,OAAa,KACtB,OAAO,KAAU,WAAiB,IAClC,OAAO,KAAU,YAAY,OAAO,KAAU,YACzC,OAAO,CAAK,IACjB,MAAM,QAAQ,CAAK,KAAK,OAAO,KAAU,WACpC,KAAK,UAAU,CAAK,IACtB;AACT;;;ACzDA,SAAgB,EAAA,GAcE;iBAbhB,GAUA,GACA,GANA,GACA,GAFA,GAKA,GADO,GALP,GADAC,GAKAC,GAKG,GAXH;CAFmDC,AAAAA,EAAAA,OAAAA,8IACnD,gCAEA,iBAAA,qEAKA,QAAA,GACA,OAAO,0DAIP,GAAA,KAbmDA;CAGnD,IAAA,IAAA,MAAA,KAAA,IAAA,KAAAF,GAKA,IAAA,MAAA,KAAA,KAAAC,GAOM,IAAK,EAAY,GACjB,IAAO,EAAU,GAAIE,EAAyC,GAS9DC;CAGoB,AAAA,EAAA,QAAA,iBAHpB,KAAC,OAAO;EACZ,MAAMC,EAAE;EACR,MAAMA,EAAE,QAAQ;EAChB,UAAUA,EAAE,YAAY;EACxB,aAAaA,EAAE;CACjB,IAF0B,EAAA,MAAA;CAX1B,IAAM,IAAK,EAQT,GAAID,CAKJ,GAIOE;CAD0B,IAAA,EAAA,QAAA,KAAA,EAAA,QAAYC,EAAAA,eAAAA,EAAAA,QACtC,GAAA;EADP,IAAM,IAAY,EAAe,GAAS,EAAG,WAAW;EACjD,IAAA,KAAkB,OACrB,IACA,EAAU,MAAM,GAAG,CAAc,GAHJ,EAAA,MAAA,GAAYA,EAAAA,MAAAA,EAAAA,aACtC,EAAA,MAAA;;CAFT,IAAM,IAAiBC,GAUKC;;EAC1B,IAAI,GAAQ;GAEFC,IAAAA;8BAAQ,IAAA,KAAA,CAAC,GAAT,EAAA,MAAA;GACK,IAAA,IAAA,KAAe,GAFrBC;GAAP,AACQD,EAAAA,QAAAA,KAAAA,EAAAA,QACKE,KAFN,IAAA;IACL,MAAMF;IACN,WAAWE;GACb,GAFQF,EAAAA,MAAAA,GACKE,EAAAA,MAAAA,2BAFb,IAAOD;GAAP,MAAA;EAIF;EAC8CD,IAAAA;6BAAQ,IAAA,KAAA,CAAC,GAAT,EAAA,MAAA;EAAlBG,IAAAA;EAAkBH,AAAAA,EAAAA,QAAAA,KAAAA,EAAAA,QAEnCI,EAAAA,QAAAA,EAAAA,QACIC,EAAAA,YAAAA,EAAAA,QAFJC,EAAAA,QADiB,IAAA,EAAkBN,GAAY;GACxD,MAAM,EAAG;GACT,MAAM,EAAG;GACT,UAAU,EAAG;EACf,CAAC,GAJ6CA,EAAAA,MAAAA,GAEnCI,EAAAA,MAAAA,EAAAA,MACIC,EAAAA,MAAAA,EAAAA,UAFJC,EAAAA,MAAAA,EAAAA;EADX,IAAM,EAAE,WAAQ,eAAYH,GAKrBI;EAAP,AAA0CC,EAAAA,QAAAA,EAAAA,UAAAA,EAAAA,QAA3B,KAAR,IAAA;GAAE,MAAM;GAAS,WAAW,EAAO;EAAO,GAAPA,EAAAA,MAAAA,EAAAA,QAA3B,EAAA,MAAA,2BAAf,IAAOD;;CAZT,IAAM,EAAE,SAAM,iBAAcR,GAgB1BU;CACiB,AAAA,EAAA,QAAA,KAAA,EAAA,QAIf,KALF,MAAC,MAAyB;EAKxB,AAJA,EAAe,CAAE,CAAC,CAAC,SAAS;GAC1B,MAAM;GACN,MAAM;EACR,CAA8B,GAC9B,IAAe,CAAI;CACrB,GALiB,EAAA,MAAA,GAIf,EAAA,MAAA;CANJ,IAAM,KAAmBC,IAYvBC;CACiB,AAAA,EAAA,QAAA,KAAA,EAAA,QACf,KAFF,KAAC,MAAiB;EAEhB,AADA,EAAe,CAAE,CAAC,CAAC,SAAS,EAAE,QAAK,CAA8B,GACjE,IAAe,CAAI;CACrB,GAFiB,EAAA,MAAA,GACf,EAAA,MAAA;CAHJ,IAAM,IAAmBC,GASvBC;CACiB,AAAA,EAAA,QAAA,KAAA,EAAA,QAIf,KALF,KAAC,MAAqB;EAKpB,AAJA,EAAe,CAAE,CAAC,CAAC,SAAS;GAC1B;GACA,MAAM;EACR,CAA8B,GAC9B,IAAmB,CAAQ;CAC7B,GALiB,EAAA,MAAA,GAIf,EAAA,MAAA;CANJ,IAAM,IAAuBC,GAY3BC;CADF,OAWkB,EAAA,QAAA,KAAA,EAAA,QACI,KAAA,EAAA,QAFJ,MAAA,EAAA,QAIF,KAAA,EAAA,QACA,KAAA,EAAA,QAFO,KAAA,EAAA,QAVV,KAAA,EAAA,QACH,KAAA,EAAA,QAKK,KAAA,EAAA,QAJJ,KAAA,EAAA,QACEX,EAAAA,QAAAA,EAAAA,QACIC,EAAAA,YAAAA,EAAAA,QACJC,EAAAA,QAAAA,EAAAA,QANL,KADN,IAAA,kBAAC,GAAD;EACE,GAAI;EACJ,SAAS;EACH;EACN,OAAO;EACP,MAAM,EAAG;EACT,UAAU,EAAG;EACb,MAAM,EAAG;EACE;EACX,cAAc;EACd,cAAc;EACd,kBAAkB;EACC;EACP;EACA;CACb,CAAA,GALe,EAAA,MAAA,GACI,EAAA,MAAA,GAFJ,EAAA,MAAA,IAIF,EAAA,MAAA,GACA,EAAA,MAAA,GAFO,EAAA,MAAA,GAVV,EAAA,MAAA,GACH,EAAA,MAAA,GAKK,EAAA,MAAA,GAJJ,EAAA,MAAA,GACEF,EAAAA,MAAAA,EAAAA,MACIC,EAAAA,MAAAA,EAAAA,UACJC,EAAAA,MAAAA,EAAAA,MANL,EAAA,MAAA,2BADNS;AAiBJ;AAzF6B,SAAA,GAAC,GAAA;CAAM,OAAA,EAAE;;;;ACxDtC,SAAgB,GAAA,GAIO;iBAJO,EAC5B,MAAA,GACA,SAAA,GACA,YAH4BC,GAC5B,IAAA,MAAA,KAAA,IAAO,IAAPC,GACA,IAAA,MAAA,KAAA,IAAU,IAAVC,GAMMC;CAE0B,AAAA,EAAA,OAAA,gBAF1B,IAAA,kBAAC,GAAD,EAAA,UACE,kBAAC,GAAD,EAAA,UACG,MAAM,KAAK,EAAE,QAAQ,EAAQ,CAAC,CAAC,CAAC,IAAIC,EAIpC,EACU,CAAA,EACJ,CAAA,GANe,EAAA,KAAA;CAQvBC,IAAAA;CAAqB,AAAA,EAAA,OAAA,gBAArB,IAAA,MAAM,KAAK,EAAE,QAAQ,EAAK,CAAC,GAAN,EAAA,KAAA;CADxBC,IAAAA;CAG4B,AAAA,EAAA,OAAA,KAAA,EAAA,OAFzBD,KADH,IAAA,kBAAC,GAAD,EAAA,UACGA,EAA6B,KAAK,GAAG,MACpC,kBAAC,GAAD;EAA8B,IAAI,EAAO;EACtC,UAAA,MAAM,KAAK,EAAE,QAAQ,EAAQ,CAAC,CAAC,CAAC,KAAK,GAAI,MACxC,kBAAC,GAAD,EAAA,UACE,kBAAC,GAAD;GAAU,SAAQ;GAAO,OAAM;GAAM,QAAQ;EAAK,CAAA,EACzC,GAFK,QAAQ,EAAE,GAAGE,GAElB,CACZ;CACU,GANK,OAAO,GAMZ,CACd,EACQ,CAAA,GAPiB,EAAA,KAAA,GAFzBF,EAAAA,KAAAA;CAZPG,IAAAA;CADF,OAEoB,EAAA,OAAA,KAAA,EAAA,OACdL,KAAAA,EAAAA,OASAG,KAXJ,IAAA,kBAAC,GAAD;EAAK,IAAI,EAAO;EAAW,cAAW;EACpC,UAAA,kBAAC,GAAD;GAAgB;GAAM,IAAI,EAAO;GAAO,cAAA;GAAxC,UAAA,CACEH,GASAG,CAWQ;;CACP,CAAA,GAtBa,EAAA,KAAA,GACdH,EAAAA,KAAAA,GASAG,EAAAA,KAAAA,2BAXJE;AAyBJ;AArBiD,SAAA,GAAC,GAAG,GAAA;CACvC,OAAA,kBAAC,GAAD;EAA6B,IAAI,EAAO;EACtC,UAAA,kBAAC,GAAD;GAAU,SAAQ;GAAO,OAAM;GAAM,QAAQ;EAAK,CAAA;CACzC,GAFK,QAAQ,GAEb;;;;AC9BzB,SAAgB,EAA0B,GAOvB;CACjB,IAAM,IAAwB,CAAC;CAiB/B,OAhBI,EAAK,gBACP,EAAM,KACJ,EAAqB;EACnB,UAAU,EAAK;EACf,cAAc,EAAK;EACnB,YAAY,EAAK;EACjB,iBAAiB,EAAK;CACxB,CAAC,CACH,GAEF,EAAM,KACJ,EAAqB;EACnB,UAAU,EAAK;EACf,cAAc,EAAe,EAAK,QAAQ,GAAG,EAAK,OAAO;CAC3D,CAAC,CACH,GACO;AACT;;;AC5BA,SAAgB,GACd,GACA,GACA,IAA6B,MACpB;CAET,IADI,EAAY,WAAW,KACvB,CAAC,MAAM,QAAQ,CAAK,GAAG,OAAO;CAClC,IAAM,IAAS,IAAI,IAAqB,CAAW;CACnD,OAAO,EAAM,QAAQ,GAAc,MAA2B;EAC5D,IAAmB,OAAO,KAAQ,aAA9B,GAAwC,OAAO;EACnD,IAAM,IAAM,EAAgC,MAAc;EAC1D,QAAQ,OAAO,KAAO,YAAY,OAAO,KAAO,aAAa,EAAO,IAAI,CAAE;CAC5E,CAAC;AACH"}

package/dist/types/chat/bubbles/chat-suggestion-button.d.ts CHANGED Viewed

@@ -1,2 +1,2 @@
 import { ChatSuggestionButtonProps } from '../types.js';
-export declare function ChatSuggestionButton({ label, color, sx, ...props }: ChatSuggestionButtonProps): import('react').JSX.Element;
+export declare function ChatSuggestionButton({ label, backgroundColor, sx, ...props }: ChatSuggestionButtonProps): import('react').JSX.Element;

package/dist/types/chat/types.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { ButtonBaseProps, SxProps, Theme } from '@mui/material';
+import { PaletteColor } from '../components/types.js';
 export interface ChatSxProps {
     sx?: SxProps<Theme>;
 }
@@ -33,7 +34,8 @@ export interface ChatErrorMessageProps extends ChatSxProps {
 }
 export interface ChatSuggestionButtonProps extends ChatSxProps, Omit<ButtonBaseProps, 'children'> {
     label: ReactNode;
-    color?: string;
+    /** Tint painted behind the suggestion. Theme path or CSS colour. */
+    backgroundColor?: PaletteColor;
 }
 export interface ChatThinkingProps extends ChatSxProps {
     duration?: number;
@@ -127,7 +129,8 @@ export interface ChatModelOption {
 }
 export interface ChatStarterItem {
     label: string;
-    color?: string;
+    /** Tint painted behind the suggestion. Theme path or CSS colour. */
+    backgroundColor?: PaletteColor;
 }
 export interface ChatStarterProps extends ChatSxProps {
     icon?: ReactNode;

package/dist/types/components/index.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-export type { CustomMeasureMode, MeasurementMode, MeasurementModeOption, MeasurementModes, MeasurementModesMapping, MeasurementOptionsMode, MeasurementOptionsUnit, MeasurementSystem, MeasurementUnit, MeasurementUnitImperialDistance, MeasurementUnitMetricDistance, MeasurementUnitOption, MeasurementUnits, LassoToolsMode, LassoToolsModeOption, LassoToolsModes, LassoToolOptionsMode, LassoToolsModesMapping, } from './types.js';
+export type { CssColor, PaletteColor, CustomMeasureMode, MeasurementMode, MeasurementModeOption, MeasurementModes, MeasurementModesMapping, MeasurementOptionsMode, MeasurementOptionsUnit, MeasurementSystem, MeasurementUnit, MeasurementUnitImperialDistance, MeasurementUnitMetricDistance, MeasurementUnitOption, MeasurementUnits, LassoToolsMode, LassoToolsModeOption, LassoToolsModes, LassoToolOptionsMode, LassoToolsModesMapping, } from './types.js';
 export type { LassoToolsComponentProps, LassoToolsInlineComponentProps, LassoGeometryToolbarUIProps, LassoToolsUIContextValue, LassoGeometryType, LassoDrawColor, LassoDrawColorPreset, LassoDrawFill, LassoDrawStroke, LassoDrawStyle, LassoLayerFiltersUIProps, LassoLayerFilterItem, LassoMessageUIProps, } from './lasso-tool/types.js';
 export type { InteractionModeSectionProps } from './lasso-tool/options-sections.js';
 export { InteractionModeSection } from './lasso-tool/options-sections.js';
@@ -26,8 +26,6 @@ export type { GeolocationControlProps } from './geolocation-controls/types.js';
 export { GeolocationControls } from './geolocation-controls/geolocation-controls.js';
 export type { ZoomControlProps } from './zoom-controls/types.js';
 export { ZoomControlsUI } from './zoom-controls/zoom-controls.js';
-export type { ListDataProps, DataItem } from './list-data/types.js';
-export { ListDataUI } from './list-data/list-data.js';
 export { BasemapsUI } from './basemaps/basemaps.js';
 export type { BasemapsUIProps } from './basemaps/types.js';
 export { Tooltip, setTooltipEnterDelay } from './tooltip/tooltip.js';

package/dist/types/components/lasso-tool/geometry-toolbar.d.ts CHANGED Viewed

@@ -19,7 +19,7 @@ import { ConnectedColorAction, ConnectedDeleteAction, ConnectedDuplicateAction,
  * </LassoTools.GeometryToolbar>
  * ```
  *
- * Same contract as widgets-v2: the actions take no data props (they read the
+ * Same contract as widgets: the actions take no data props (they read the
  * context) and each one renders nothing when its handler is missing, so a
  * composition can list every action safely. Pre-composed toolbars are
  * application-level code and live outside this library — see

package/dist/types/components/lasso-tool/toolbar/context.d.ts CHANGED Viewed

@@ -3,7 +3,7 @@ import { LassoGeometryToolbarUIProps } from '../types.js';
 /**
  * Everything the connected actions need, derived once by
  * `LassoGeometryToolbarUI` from the props it gets from the controller. Mirrors
- * the widgets-v2 contract: an action reads its state from here instead of
+ * the widgets contract: an action reads its state from here instead of
  * having it threaded through the call site.
  */
 export interface LassoGeometryToolbarContextValue extends Omit<LassoGeometryToolbarUIProps, 'children' | 'PaperProps'> {

package/dist/types/components/types.d.ts CHANGED Viewed

@@ -1 +1,16 @@
 export * from './common-types.js';
+/**
+ * A theme palette path (`'primary.main'`, `'text.secondary'`) or a literal CSS
+ * color, for a prop the component resolves into `sx` itself.
+ *
+ * Never forwarded as Material UI's own `color` prop: since v9 that prop only
+ * matches generated variants (`'primary'`, `'textSecondary'`), so a palette
+ * path reaches the DOM as an inert attribute and the styling silently
+ * disappears.
+ */
+export type PaletteColor = string;
+/**
+ * A literal CSS color that arrives as data — a ramp entry, a category swatch,
+ * a series tint — and is painted as given. Not resolved against the theme.
+ */
+export type CssColor = string;

package/dist/types/legend/components/legend-actions/legend-actions.d.ts CHANGED Viewed

@@ -3,7 +3,7 @@ export interface LegendActionsProps {
     children?: ReactNode;
 }
 /**
- * Header actions slot for `Legend.Row` / `Legend.Group` (widgets-v2 `Actions`
+ * Header actions slot for `Legend.Row` / `Legend.Group` (widgets `Actions`
  * parity): the wrapper partitions its children by component identity and
  * renders this slot inside the header, wrapped in the hover-fade group
  * (`PsLegend-rowFade` in rows, `PsLegend-groupFade` in group headers —
@@ -17,7 +17,7 @@ export declare function LegendActions({ children }: LegendActionsProps): import(
  * Splits a wrapper's children by component identity: `<Legend.Actions>`
  * elements belong in the header, everything else in the collapsible body.
  * Identity comparison works because consumers import the slot from the same
- * module (same pattern as widgets-v2 `Wrapper`).
+ * module (same pattern as widgets `Wrapper`).
  */
 export declare function partitionLegendChildren(children: ReactNode): {
     actions: ReactNode[];

package/dist/types/legend/components/legend-swatch/legend-swatch.d.ts CHANGED Viewed

@@ -1,9 +1,10 @@
+import { CssColor } from '../../../components/types.js';
 import { LegendFillPattern, LegendStrokeStyle, LegendSwatchShape } from '../../stores/index.js';
 export interface LegendSwatchProps {
     /** Shape to render. Default `'circle'`. */
     shape?: LegendSwatchShape;
     /** CSS color string (hex / rgb / named). */
-    color: string;
+    color: CssColor;
     /** Paint the outline/border instead of the fill (square/circle only). */
     isStrokeColor?: boolean;
     /** Fill pattern when filled. Default `'solid'`. */

package/dist/types/legend/index.d.ts CHANGED Viewed

@@ -22,7 +22,7 @@ import { LegendIconUI } from './components/legend-icon/legend-icon-ui.js';
 /**
  * Curated namespace export — the entry point to the legend module.
  *
- * Composable, widgets-v2 style: the lib ships wrapper shells + standalone
+ * Composable, widgets style: the lib ships wrapper shells + standalone
  * store-connected actions, and the **app mounts the legend** in its own
  * chrome (panel/drawer/sidebar). `Legend.Row`/`Legend.Group` partition their
  * children — `<Legend.Actions>` renders in the sticky header (hover-fade),

package/dist/types/legend/provider/legend-provider.d.ts CHANGED Viewed

@@ -7,7 +7,7 @@ export interface LegendProviderProps {
     /**
      * Layer definitions. Interactive fields (visible/opacity/…) are seeded.
      * Pass stable references — `layers`, `groups`, and each layer's `variables`
-     * should be memoized or module constants (same contract as widgets-v2
+     * should be memoized or module constants (same contract as widgets
      * `data`); the store bails out of unchanged syncs by reference.
      */
     layers: LegendLayerInput[];
@@ -31,7 +31,7 @@ export interface LegendProviderProps {
  * state), and exposes the `id` via `LegendContext` so descendants resolve their
  * store with `useLegendId()`. Labels are surfaced via `LegendConfigContext`.
  *
- * Modeled on the widgets-v2 `Widget.Provider`.
+ * Modeled on the widgets `Widget.Provider`.
  *
  * @experimental This API is new and may change in a future release.
  */

package/dist/types/migration/v4/classes.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+/**
+ * The classes a consolidated name splits into, or `null` if the name is
+ * already a v9 one.
+ *
+ * `MuiButton-colorPrimary` and `MuiChip-sizeSmall` are the *result* of the
+ * consolidation, not input to it, so a slot of `color` or `size` is left
+ * alone — rewriting those would produce `MuiButton-color`, a class that
+ * does not exist.
+ */
+export declare function consolidateClassName(name: string): string[] | null;
+/**
+ * Rewrites every consolidated class inside a selector or a class list,
+ * preserving the leading `.` where there is one so it works on both
+ * `.MuiButton-textPrimary` and a bare `className` value.
+ */
+export declare function consolidateSelectors(text: string): string;

package/dist/types/migration/v4/icons.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+/**
+ * The 17 `*Outline` icons Material UI v9 removed, mapped to the icon whose
+ * SVG path is byte-identical in 9.4.0. `null` means no icon anywhere in v9
+ * draws this glyph.
+ *
+ * Built by diffing the path data of `@mui/icons-material` 5.18.0 against
+ * 9.4.0, not from the changelog, because the obvious rename is wrong: for 15
+ * of these 17, replacing the `Outline` suffix with `Outlined` resolves to
+ * the outlined variant of the *solid* icon — `ErrorOutline` is a ring,
+ * `ErrorOutlined` is a filled circle. It compiles and nothing fails.
+ *
+ * Both authorities you would otherwise consult give the wrong answer here:
+ * the compiler suggests the naive rename, and Meridian's own changelog
+ * states it.
+ */
+export declare const REMOVED_OUTLINE_ICONS: Readonly<Record<string, string | null>>;
+export declare const REMOVED_ICON_NAMES: string[];
+/**
+ * The v9 replacement for a removed icon: a name when one exists, `null` when
+ * no icon draws the glyph, `undefined` when the name was never removed.
+ *
+ * Goes through `Object.hasOwn` because the name comes from the source, and a
+ * bare lookup on an identifier called `toString` or `constructor` returns
+ * whatever `Object.prototype` has under that key.
+ */
+export declare function replacementFor(name: string): string | null | undefined;
+/**
+ * What the naive rename produces for each removed icon. These names exist in
+ * v9, so nothing fails — they are just a different drawing.
+ */
+export declare const NAIVE_RENAMES: string[];

package/dist/types/migration/v4/index.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * MUI v9 / Meridian 5 migration codemod.
+ *
+ * The rules are applied by a jscodeshift transform — see `./transform.ts`
+ * for how to run it — and exported here as data, so a tool can report what
+ * a jump involves without running it:
+ *
+ *   import { RULES, jumpsFor } from '@carto/ps-react-ui/migration/v4'
+ *
+ * The prose walkthrough is `docs/migration/mui-9-meridian-5.md`, which
+ * documents the rules in `./rules`; a test keeps the two in sync.
+ */
+export { RULES, JUMPS, jumpsFor } from './rules.js';
+export type { Rule, Jump, Handling, Severity } from './rules.js';
+export { REMOVED_OUTLINE_ICONS } from './icons.js';
+export { consolidateClassName, consolidateSelectors } from './classes.js';
+export { default as transform } from './transform.js';

package/dist/types/migration/v4/rules.d.ts ADDED Viewed

@@ -0,0 +1,42 @@
+import { RuleContext } from './transforms/helpers.js';
+/**
+ * The version hops, in the order they must be done. There is no MUI v8.
+ * `ps-react-ui` is this library's own major, the one that ships v9: it
+ * removed widgets v1 and moved widgets v2 onto the `widgets` paths.
+ */
+export declare const JUMPS: readonly ["v5-v6", "v6-v7", "v7-v9", "meridian-5", "ps-react-ui"];
+export type Jump = (typeof JUMPS)[number];
+/**
+ * What the rule does to the code. `annotate` marks the rules that cannot be
+ * applied mechanically — they are the ones worth reading one by one, and
+ * several of them fail at runtime rather than at compile time.
+ */
+export type Handling = 'rewrite' | 'annotate';
+/**
+ * `silent` marks the rules that produce no error anywhere: the class name
+ * stops matching, the styling disappears, and every build and test stays
+ * green. They are the reason this codemod exists.
+ */
+export type Severity = 'silent' | 'build-error' | 'runtime-error';
+export interface Rule {
+    id: string;
+    jump: Jump;
+    handling: Handling;
+    severity: Severity;
+    /** One line, imperative: what the rule does, or what the reader must do. */
+    action: string;
+    /** Applies the rule to a parsed module. Returns the number of sites hit. */
+    apply?: (context: RuleContext) => number;
+    /**
+     * Applies the rule to a file jscodeshift cannot parse — a stylesheet, an
+     * `.md` or an `.mdx`. The codemods never touch documentation, so sample
+     * snippets keep teaching the old API long after the source moved on, and
+     * people copy them. Found the hard way: this repo's docs still had 58
+     * `<Grid item>` and a documented `componentsProps` prop after the source
+     * was fully migrated.
+     */
+    applyText?: (source: string) => string;
+}
+export declare const RULES: readonly Rule[];
+/** Which jumps a codebase still has to do, given what it currently has. */
+export declare function jumpsFor(muiMajor: number, meridianMajor: number): Jump[];

package/dist/types/migration/v4/transform.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { API, FileInfo, Options } from 'jscodeshift';
+export default function transform(file: FileInfo, api: API, options: Options): string | undefined;
+/** jscodeshift reads this instead of being told `--parser` on every run. */
+export declare const parser = "tsx";

package/dist/types/migration/v4/transforms/helpers.d.ts ADDED Viewed

@@ -0,0 +1,97 @@
+import { API, ASTPath, Collection, JSCodeshift, JSXAttribute, JSXElement, JSXExpressionContainer, JSXOpeningElement } from 'jscodeshift';
+export interface RuleContext {
+    j: JSCodeshift;
+    root: Collection;
+    path: string;
+    api: API;
+}
+/** Anything that can stand on the right of `=` in an expression position. */
+export type Expression = Exclude<JSXExpressionContainer['expression'], {
+    type: 'JSXEmptyExpression';
+}>;
+/** The value of a node that is a string literal, or undefined otherwise. */
+export declare function stringValue(node: unknown): string | undefined;
+/** Prefix for every comment a rule leaves behind, so they are greppable. */
+export declare const TODO = "TODO(mui9):";
+/** The `name` of an identifier-ish node, or '' when it is something else. */
+export declare function nameOf(node: unknown): string;
+/** The type of a path's parent node, or '' at the root. */
+export declare function parentType(path: ASTPath): string;
+/**
+ * Leaves a `TODO(mui9)` comment above the statement containing `path`.
+ *
+ * Used by the rules that have no mechanical rewrite — `freeSolo` narrowing,
+ * a `Grid container` whose parent we cannot see. Dropping them silently
+ * would be worse than the checker this replaces: the run would report
+ * success over code that still has to be read.
+ *
+ * Idempotent: running the codemod twice does not stack comments.
+ */
+export declare function annotate(j: JSCodeshift, path: ASTPath, message: string): boolean;
+/** The opening element's name, for `<Grid>` / `<Mui.Grid>` alike. */
+export declare function elementName(node: JSXOpeningElement): string;
+/** Every JSX element in the file whose tag is one of `names`. */
+export declare function elementsNamed(j: JSCodeshift, root: Collection, names: readonly string[]): Collection<JSXElement>;
+/** The named attribute of an opening element, if it is written plainly. */
+export declare function attribute(node: JSXOpeningElement, name: string): JSXAttribute | undefined;
+/** Drops the named attributes from an opening element. */
+export declare function removeAttributes(node: JSXOpeningElement, names: readonly string[]): void;
+/**
+ * The expression behind an attribute value: `foo='bar'` gives the string
+ * literal, `foo={expr}` gives `expr`, and a bare `foo` gives `true`.
+ */
+export declare function attributeValue(j: JSCodeshift, attr: JSXAttribute): Expression;
+/** Merges entries into the element's `sx`. See `mergeIntoObjectProp`. */
+export declare function mergeIntoSx(j: JSCodeshift, opening: JSXOpeningElement, entries: readonly (readonly [string, Expression])[]): boolean;
+/**
+ * Merges `{ [key]: value }` into an object-valued prop, creating it if
+ * absent. This is the shape of most of the v9 migration: a prop that used
+ * to stand alone folds into `sx` or into `slotProps`.
+ *
+ * A target that is not an object literal — a variable, an array, a spread —
+ * is not something we can merge into safely, so the caller is told no and
+ * annotates instead.
+ */
+export declare function mergeIntoObjectProp(j: JSCodeshift, opening: JSXOpeningElement, prop: string, entries: readonly (readonly [string, Expression])[]): boolean;
+/** Whether an import brings in a value or only a type. */
+export type ImportKind = 'value' | 'type';
+/**
+ * The kind of an import declaration or of a single specifier, defaulting to
+ * a value import.
+ *
+ * Takes `unknown` because ast-types does not declare `importKind` on
+ * `ImportSpecifier` at all, though both the parser and recast carry it.
+ */
+export declare function importKind(node: unknown): ImportKind;
+/**
+ * Adds a named import to `source`, reusing an existing declaration.
+ *
+ * `kind` has to be carried across: moving a specifier out of
+ * `import type { AlertProps } from '@mui/lab'` into a value import turns a
+ * type into a runtime binding, which fails under `verbatimModuleSyntax` and
+ * at runtime for a type-only export.
+ */
+export declare function ensureImport(j: JSCodeshift, root: Collection, source: string, imported: string, kind?: ImportKind): void;
+/** Drops a named import, and the whole declaration once it is empty. */
+export declare function removeImport(j: JSCodeshift, root: Collection, source: string, imported: string): void;
+/** Whether the identifier is still referenced anywhere outside imports. */
+export declare function isUsed(j: JSCodeshift, root: Collection, name: string): boolean;
+/**
+ * Visits every `Identifier` and `JSXIdentifier` in the file.
+ *
+ * A rename has to reach both — `import { AiTool }` and `<AiTool />` are
+ * different node types — and the two cannot be searched in one pass because
+ * their builders have different types.
+ */
+export declare function eachIdentifier(j: JSCodeshift, root: Collection, visit: (node: {
+    name: string;
+}, parent: string) => void): void;
+/**
+ * The module a local name is imported from, or undefined when it is not
+ * imported at all.
+ *
+ * Used to tell a Material UI component apart from one that merely takes a
+ * prop with the same name. `@mui/codemod` matches on the prop, not on where
+ * the component came from, so it happily rewrites a third party's API.
+ */
+export declare function importSourceOf(j: JSCodeshift, root: Collection, local: string): string | undefined;

package/dist/types/migration/v4/transforms/meridian-5.d.ts ADDED Viewed

@@ -0,0 +1,22 @@
+import { RuleContext } from './helpers.js';
+/** `AiTool` → `McpTool`, `CodeAreaProps` → `CodeAreaFieldProps`. */
+export declare function meridianRenamedApi({ j, root }: RuleContext): number;
+/**
+ * `cartoThemeOptions as unknown as Theme` → the exported `theme`.
+ *
+ * Meridian 5 exports a built theme; reading the options object and casting
+ * it into a `Theme` was always a lie, and in 5 the two have diverged enough
+ * that the cast produces wrong values rather than a type error.
+ */
+export declare function cartoThemeOptions({ j, root }: RuleContext): number;
+/**
+ * Flags imports of the widgets Meridian 4.0.0 removed.
+ *
+ * No rewrite: the replacement is either `@carto/ps-react-ui`'s own widget,
+ * with a different API, or Meridian's new `./charts` and `./hooks` subpaths.
+ * Only flagged when the import is FROM Meridian — codebases routinely define
+ * their own `CategoryWidgetUI`, and matching the bare name turned a real
+ * finding into a page of noise on the project template, where 19 of 40
+ * matches were the app's own components.
+ */
+export declare function meridianRemovedWidgets({ j, root }: RuleContext): number;

package/dist/types/migration/v4/transforms/ps-react-ui.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import { RuleContext } from './helpers.js';
+/**
+ * `@carto/ps-react-ui/widgets-v2/*` → `@carto/ps-react-ui/widgets/*`.
+ *
+ * Every string literal, not only import sources: `vi.mock(…)`, `import(…)`
+ * and `export … from` carry the same specifier, and a mock left on the old
+ * path silently stops mocking anything.
+ */
+export declare function widgetsV2Path({ j, root }: RuleContext): number;
+/** The same rename in stylesheets and docs, whose snippets people copy. */
+export declare function widgetsV2PathText(source: string): string;
+/**
+ * Flags imports of names only widgets v1 exported.
+ *
+ * No rewrite: v1 and v2 differ in shape (config objects against composers,
+ * one global store against one store per widget), and the mapping is the v1
+ * → v2 migration guide, not a table. The widgets paths still resolve after
+ * the upgrade, so without this the only signal is `has no exported member`.
+ */
+export declare function widgetsV1Removed({ j, root }: RuleContext): number;

package/dist/types/migration/v4/transforms/v5-v6.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { RuleContext } from './helpers.js';
+/**
+ * `<ListItem button>` → `<ListItemButton>`.
+ *
+ * `button` disappears (it is what the new component *is*); the other three
+ * props move across unchanged.
+ */
+export declare function listItemRemovedProps({ j, root }: RuleContext): number;
+/**
+ * `<Typography color={(theme) => …}>` → `sx={{ color: (theme) => … }}`.
+ *
+ * Only the callback spelling breaks here. `color='text.secondary'` still
+ * resolves through v6 and v7 and is handled in the v7 → v9 pass, so leaving
+ * it alone is correct rather than an omission.
+ */
+export declare function typographyColorCallback({ j, root }: RuleContext): number;
+/**
+ * `querySelectorAll('hr')` → `querySelectorAll('.MuiDivider-root')`.
+ *
+ * A vertical `Divider` renders a `<div>`. The reason this rule is worth a
+ * rewrite rather than a report is that the broken query returns zero both
+ * before and after the upgrade, so the assertion around it keeps passing
+ * while asserting nothing — there is no failure to lead anyone here.
+ */
+export declare function dividerHrSelector({ j, root }: RuleContext): number;
+/** `hr.MuiDivider-root` and bare `hr` rules in a stylesheet. */
+export declare function dividerHrSelectorText(source: string): string;