@tetrascience-npm/tetrascience-react-ui 0.5.0-beta.55.1 → 0.5.0-beta.58.1

package/dist/index.d.ts

@@ -39,6 +39,7 @@ import { NavigationMenu as NavigationMenu_2 } from 'radix-ui';
 import { OnChange } from '@monaco-editor/react';
 import { OTPInput } from 'input-otp';
 import { PaginationState } from '@tanstack/react-table';
+import { Popover as Popover_2 } from 'radix-ui';
 import { PropsWithChildren } from 'react';
 import { RadioGroup as RadioGroup_2 } from 'radix-ui';
 import * as React_2 from 'react';
@@ -115,6 +116,10 @@ declare const alertVariants: (props?: ({
     variant?: "default" | "destructive" | "info" | "positive" | "warning" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+export declare function allPositions(dims: PlateDimensions): WellId[];
+
+export declare function applyFilterCondition(cellValue: string, operator: FilterOperator, filterValue: string): boolean;
+
 export declare interface AreaDataSeries {
     x: number[];
     y: number[];
@@ -220,6 +225,33 @@ export declare type AttachmentsProps = HTMLAttributes<HTMLDivElement> & {
 
 export declare type AttachmentVariant = "grid" | "inline" | "list";
 
+export declare interface AutoFillOptions {
+    dims: PlateDimensions;
+    /** Number of distinct items to place. Each is repeated `replicates` times. */
+    count: number;
+    /** First well in fill order. Defaults to position (0,0). */
+    startWellId?: WellId;
+    /** Traversal strategy. Defaults to `"row-major"`. */
+    strategy?: FillStrategy;
+    /** Consecutive cells assigned per item. Defaults to 1. */
+    replicates?: number;
+}
+
+/**
+ * Compute the ordered list of well ids to assign to `count` items (each
+ * repeated `replicates` times) starting from `startWellId`. Returns at most
+ * `dims.rows * dims.columns` ids — overflow is silently truncated so callers
+ * can paginate onto multiple plates themselves.
+ */
+export declare function autoFillPositions(options: AutoFillOptions): WellId[];
+
+/**
+ * Convenience wrapper: assigns each input item to `replicates` consecutive
+ * wells, returning a `Map<WellId, T>`. The mapper builds the record stored at
+ * each well (e.g. stamp item-specific fields onto a base record).
+ */
+export declare function autoFillRecords<T>(items: T[], buildRecord: (item: T, index: number, wellId: WellId) => T, options: Omit<AutoFillOptions, "count">): Map<WellId, T>;
+
 export declare function Avatar({ className, size, ...props }: React_2.ComponentProps<typeof Avatar_2.Root> & {
     size?: "default" | "sm" | "lg";
 }): JSX.Element;
@@ -1134,7 +1166,7 @@ export declare interface DataAppShellProps {
     className?: string;
 }
 
-export declare function DataTable<TData, TValue>({ columns, data, toolbar, enableSorting, enableColumnVisibility, children, columnOrder: controlledColumnOrder, onColumnOrderChange, columnVisibility: controlledColumnVisibility, onColumnVisibilityChange, columnLabels: controlledColumnLabels, onColumnLabelChange, enablePagination, defaultPageSize, pagination: controlledPagination, onPaginationChange, enableColumnReorder, enableFiltering, filters: controlledFilters, onFiltersChange, filterConfig, manualFiltering, density, className, variant, containerClassName, truncate, }: DataTableProps<TData, TValue>): JSX.Element;
+export declare function DataTable<TData, TValue>({ columns, data, toolbar, enableSorting, enableColumnVisibility, children, columnOrder: controlledColumnOrder, onColumnOrderChange, columnVisibility: controlledColumnVisibility, onColumnVisibilityChange, columnLabels: controlledColumnLabels, onColumnLabelChange, enablePagination, defaultPageSize, pagination: controlledPagination, onPaginationChange, enableColumnReorder, enableFiltering, filters: controlledFilters, onFiltersChange, filterConfig, manualFiltering, enableGrouping, grouping: controlledGrouping, onGroupingChange, groupConfig, density, className, variant, containerClassName, truncate, }: DataTableProps<TData, TValue>): JSX.Element;
 
 export declare function DataTableColumnToggle({ className }: DataTableColumnToggleProps): JSX.Element | null;
 
@@ -1152,6 +1184,16 @@ export declare interface DataTableFilterProps {
     className?: string;
 }
 
+export declare function DataTableGroup({ className }: DataTableGroupProps): JSX.Element | null;
+
+export declare namespace DataTableGroup {
+    var displayName: string;
+}
+
+export declare interface DataTableGroupProps {
+    className?: string;
+}
+
 export declare function DataTablePagination({ pageSizeOptions, className, }: DataTablePaginationProps): JSX.Element | null;
 
 export declare interface DataTablePaginationProps {
@@ -1183,6 +1225,11 @@ export declare interface DataTableProps<TData, TValue> {
     filterConfig?: FilterColumnConfig[];
     /** When true, filtering is handled externally — onFiltersChange fires but rows are not filtered client-side. */
     manualFiltering?: boolean;
+    enableGrouping?: boolean;
+    /** ID of the column currently grouped by, or null for no grouping. */
+    grouping?: string | null;
+    onGroupingChange?: (grouping: string | null) => void;
+    groupConfig?: GroupColumnConfig[];
     density?: "compact" | "default" | "relaxed";
     children?: React_2.ReactNode;
     className?: string;
@@ -1356,6 +1403,8 @@ declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+export declare type FillStrategy = "row-major" | "column-major" | "row-snake" | "column-snake";
+
 export declare interface FilterColumnConfig {
     columnId: string;
     label?: string;
@@ -1384,6 +1433,8 @@ export declare const getAttachmentLabel: (data: AttachmentData) => string;
 
 export declare const getMediaCategory: (data: AttachmentData) => AttachmentMediaCategory;
 
+export declare function getPlateMapScopedWellId(plateBarcode: string, wellId: WellId): WellId;
+
 export declare const getStatusBadge: (status: ToolPart["state"]) => JSX.Element;
 
 /**
@@ -1411,6 +1462,11 @@ export declare const getStatusBadge: (status: ToolPart["state"]) => JSX.Element;
  */
 export declare function getTdpBaseUrlFromReferrer(): string | null;
 
+export declare interface GroupColumnConfig {
+    columnId: string;
+    label?: string;
+}
+
 export declare const Heatmap: default_2.FC<HeatmapProps>;
 
 /**
@@ -1484,6 +1540,13 @@ export declare function HoverCardContent({ className, align, sideOffset, ...prop
 
 export declare function HoverCardTrigger({ ...props }: React_2.ComponentProps<typeof HoverCard_2.Trigger>): JSX.Element;
 
+export declare interface ImportExportHandlers {
+    onImportCsv?: (file: File, triage?: PlateMapCsvTriage) => void | Promise<void>;
+    onExportCsv?: () => void;
+    onImportTemplate?: (file: File) => void | Promise<void>;
+    onExportTemplate?: () => void;
+}
+
 export declare const InlineCitation: ({ className, ...props }: InlineCitationProps) => JSX.Element;
 
 export declare const InlineCitationCard: (props: InlineCitationCardProps) => JSX.Element;
@@ -1733,6 +1796,19 @@ export declare type LineGraphVariant = "lines" | "lines+markers" | "lines+marker
 
 export declare const LocalReferencedSourcesContext: Context_2<ReferencedSourcesContext | null>;
 
+export declare function ManifestFilterPopover({ columns, columnLabel, filters, onFiltersChange, triggerLabel, className, }: ManifestFilterPopoverProps): JSX.Element;
+
+export declare interface ManifestFilterPopoverProps {
+    /** Filterable columns. Operator subsets can be specified per column. */
+    columns: FilterColumnConfig[];
+    /** Column id → display label resolver. */
+    columnLabel?: (columnId: string) => string;
+    filters: FilterCondition[];
+    onFiltersChange: (next: FilterCondition[]) => void;
+    triggerLabel?: string;
+    className?: string;
+}
+
 export declare type MarkerSymbol = "circle" | "circle-open" | "circle-dot" | "circle-open-dot" | "square" | "square-open" | "square-dot" | "square-open-dot" | "diamond" | "diamond-open" | "diamond-dot" | "diamond-open-dot" | "cross" | "cross-open" | "cross-dot" | "cross-open-dot" | "x" | "x-open" | "x-dot" | "x-open-dot" | "triangle-up" | "triangle-up-open" | "triangle-up-dot" | "triangle-up-open-dot" | "triangle-down" | "triangle-down-open" | "triangle-down-dot" | "triangle-down-open-dot" | "triangle-left" | "triangle-left-open" | "triangle-left-dot" | "triangle-left-open-dot" | "triangle-right" | "triangle-right-open" | "triangle-right-dot" | "triangle-right-open-dot" | "triangle-ne" | "triangle-ne-open" | "triangle-ne-dot" | "triangle-ne-open-dot" | "triangle-se" | "triangle-se-open" | "triangle-se-dot" | "triangle-se-open-dot" | "triangle-sw" | "triangle-sw-open" | "triangle-sw-dot" | "triangle-sw-open-dot" | "triangle-nw" | "triangle-nw-open" | "triangle-nw-dot" | "triangle-nw-open-dot" | "pentagon" | "pentagon-open" | "pentagon-dot" | "pentagon-open-dot" | "hexagon" | "hexagon-open" | "hexagon-dot" | "hexagon-open-dot" | "hexagon2" | "hexagon2-open" | "hexagon2-dot" | "hexagon2-open-dot" | "octagon" | "octagon-open" | "octagon-dot" | "octagon-open-dot" | "star" | "star-open" | "star-dot" | "star-open-dot" | "hexagram" | "hexagram-open" | "hexagram-dot" | "hexagram-open-dot" | "star-triangle-up" | "star-triangle-up-open" | "star-triangle-up-dot" | "star-triangle-up-open-dot" | "star-triangle-down" | "star-triangle-down-open" | "star-triangle-down-dot" | "star-triangle-down-open-dot" | "star-square" | "star-square-open" | "star-square-dot" | "star-square-open-dot" | "star-diamond" | "star-diamond-open" | "star-diamond-dot" | "star-diamond-open-dot" | "diamond-tall" | "diamond-tall-open" | "diamond-tall-dot" | "diamond-tall-open-dot" | "diamond-wide" | "diamond-wide-open" | "diamond-wide-dot" | "diamond-wide-open-dot" | "hourglass" | "hourglass-open" | "bowtie" | "bowtie-open" | "circle-cross" | "circle-cross-open" | "circle-x" | "circle-x-open" | "square-cross" | "square-cross-open" | "square-x" | "square-x-open" | "diamond-cross" | "diamond-cross-open" | "diamond-x" | "diamond-x-open" | "cross-thin" | "cross-thin-open" | "x-thin" | "x-thin-open" | "asterisk" | "asterisk-open" | "hash" | "hash-open" | "hash-dot" | "hash-open-dot" | "y-up" | "y-up-open" | "y-down" | "y-down-open" | "y-left" | "y-left-open" | "y-right" | "y-right-open" | "line-ew" | "line-ew-open" | "line-ns" | "line-ns-open" | "line-ne" | "line-ne-open" | "line-nw" | "line-nw-open" | "arrow" | "arrow-open" | "arrow-wide" | "arrow-wide-open";
 
 declare type MarkerSymbol_2 = "circle" | "square" | "diamond" | "triangle-up" | "triangle-down" | "star";
@@ -1950,6 +2026,13 @@ export declare interface NavPage {
     onClick?: () => void;
 }
 
+export declare function parsePos(id: WellId, dims: PlateDimensions): {
+    row: number;
+    col: number;
+} | null;
+
+export declare function parseRowLabel(label: string): number;
+
 /**
  * Peak annotation for labeling peaks on the chromatogram.
  * Used for both user-provided annotations and auto-detected peaks.
@@ -2033,6 +2116,11 @@ declare const PLATE_FORMAT_96: "96";
 
 declare const PLATE_FORMAT_CUSTOM: "custom";
 
+export declare interface PlateDimensions {
+    rows: number;
+    columns: number;
+}
+
 /**
  * Plate format presets for standard microplate configurations.
  * - `"96"`: 8 rows × 12 columns (wells A1-H12)
@@ -2067,6 +2155,204 @@ export declare type PlateFormat = typeof PLATE_FORMAT_96 | typeof PLATE_FORMAT_3
  */
 export declare const PlateMap: default_2.FC<PlateMapProps>;
 
+export declare function PlateMapActionsMenu({ templates, templateId, onTemplateChange, onClearTemplate, hasEntries, onImportCsv, onExportCsv, onImportTemplate, onExportTemplate, label, align, side, csvAccept, templateAccept, importTemplateLabel, exportTemplateLabel, importCsvLabel, exportCsvLabel, clearLabel, className, }: PlateMapActionsMenuProps): JSX.Element | null;
+
+export declare interface PlateMapActionsMenuProps extends ImportExportHandlers {
+    templates?: TemplateOption[];
+    templateId?: string;
+    onTemplateChange?: (id: string) => void;
+    onClearTemplate?: () => void;
+    /** Disable export/save actions when there is nothing to export. */
+    hasEntries?: boolean;
+    label?: React_2.ReactNode;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    csvAccept?: string;
+    templateAccept?: string;
+    importTemplateLabel?: string;
+    exportTemplateLabel?: string;
+    importCsvLabel?: string;
+    exportCsvLabel?: string;
+    clearLabel?: string;
+    className?: string;
+}
+
+export declare interface PlateMapCsvPlate {
+    /** User-provided plate barcode used as the selectable plate id. */
+    id: string;
+    barcode: string;
+    rows: PlateMapCsvRow[];
+    rowCount: number;
+}
+
+export declare interface PlateMapCsvRow {
+    /** 1-based CSV line number, including the header line. */
+    line: number;
+    values: Record<string, string>;
+}
+
+export declare interface PlateMapCsvTriage {
+    headers: string[];
+    /** Resolved header name for the plate barcode column, when present. */
+    plateBarcodeColumn?: string;
+    rows: PlateMapCsvRow[];
+    plates: PlateMapCsvPlate[];
+    /** Rows missing a barcode. The editor does not create fallback barcodes. */
+    missingBarcodeRows: PlateMapCsvRow[];
+}
+
+export declare interface PlateMapCsvTriageOptions {
+    /** Exact column name to use before trying aliases. */
+    plateBarcodeColumn?: string;
+    /** Additional accepted names for the plate barcode column. */
+    plateBarcodeColumnAliases?: readonly string[];
+}
+
+export declare function PlateMapEditor<T extends WellRecord = WellRecord>({ format, rows, columns, values, onChange, selection, onSelectionChange, fields, tableColumns, colorForWell, emptyEntry, mergeOnApply, isPopulated, cycleFieldOnWellDoubleClick, title, badges, banner, legend, formExtras, formSlot, footer, plateTitle, plateToolbar, plates, activePlateId, onPlateChange, onAddPlate, onRemovePlate, addPlateLabel, removePlateLabel, plateSelectorLabel, plateSelectorVariant, plateBarcodeField, plateBarcodeColumnHeader, hidePlateBarcodeColumn, groups, activeGroupId, onGroupClick, renderHoverSummary, cellSize, emptyWellFillColor, wellShape, framedPlate, wrapWell, highlightedWellIds, onHoveredWellChange, manifestFilterable, manifestGroupable, autoScaleGrid, minCellSize, maxCellSize, className, templates, templateId, onTemplateChange, onClearTemplate, onImportCsv, onExportCsv, onImportTemplate, onExportTemplate, csvAccept, templateAccept, label, align, side, importTemplateLabel, exportTemplateLabel, importCsvLabel, exportCsvLabel, clearLabel, }: PlateMapEditorProps<T>): JSX.Element;
+
+export declare interface PlateMapEditorProps<T extends WellRecord = WellRecord> extends Omit<PlateMapActionsMenuProps, "hasEntries" | "className"> {
+    format: PlateFormat;
+    rows?: number;
+    columns?: number;
+    values: Map<WellId, T>;
+    onChange: (next: Map<WellId, T>) => void;
+    selection: Set<WellId>;
+    onSelectionChange: (next: Set<WellId>) => void;
+    fields: WellField<T>[];
+    tableColumns: WellColumn<T>[];
+    /** Resolves the SVG fill color for a well. */
+    colorForWell: (well: T | undefined, wellId: WellId) => string;
+    /** Builds an empty record when a well is freshly created. */
+    emptyEntry: (wellId: WellId) => T;
+    /**
+     * Merges the staged form record onto an existing well record on Apply.
+     * Defaults to a shallow merge (form keys overwrite existing keys when set).
+     */
+    mergeOnApply?: (existing: T | undefined, staged: Partial<T>, wellId: WellId) => T;
+    /** Filter for the manifest's "hide empty" mode. */
+    isPopulated?: (row: T) => boolean;
+    /** Select field cycled when double-clicking a single well, e.g. role painting. */
+    cycleFieldOnWellDoubleClick?: keyof T & string;
+    /** Optional header title (e.g. plate set name). */
+    title?: string;
+    /** Optional badges shown in the header next to the title. */
+    badges?: React_2.ReactNode;
+    /** Optional banner (e.g. import/error alert) shown above the layout. */
+    banner?: React_2.ReactNode;
+    /** Legend block rendered under the form column. */
+    legend?: React_2.ReactNode;
+    /** Form helper slot rendered between fields and the action row. */
+    formExtras?: React_2.ReactNode;
+    /**
+     * Fully replaces the left column. When set, the built-in `WellMetadataForm`
+     * is omitted — use this for alternative workflows like a drag-and-drop
+     * source palette. The legend slot still renders beneath the replacement.
+     */
+    formSlot?: React_2.ReactNode;
+    /** Footer actions (e.g. Save, Back). */
+    footer?: React_2.ReactNode;
+    /** Title for the plate grid panel. */
+    plateTitle?: React_2.ReactNode;
+    /** Optional controls shown next to the built-in actions menu. */
+    plateToolbar?: React_2.ReactNode;
+    /** User-provided plates available for this editor. Barcodes are never generated by the editor. */
+    plates?: PlateMapPlateOption[];
+    activePlateId?: string;
+    onPlateChange?: (plateId: string) => void;
+    /** Opens the host app's manual barcode entry flow for creating a plate. */
+    onAddPlate?: () => void;
+    /** Removes a plate (typically when using `plateSelectorVariant="tabs"`). */
+    onRemovePlate?: (plateId: string) => void;
+    addPlateLabel?: string;
+    removePlateLabel?: string;
+    plateSelectorLabel?: string;
+    /** Layout of the plate selector. Defaults to `"dropdown"`. */
+    plateSelectorVariant?: PlateMapPlateSelectorVariant;
+    /** Row field used to stamp the active user-provided barcode onto edited wells. Defaults to `plateBarcode`. */
+    plateBarcodeField?: keyof T & string;
+    /** Header for the automatic manifest barcode column. */
+    plateBarcodeColumnHeader?: string;
+    /** Hide the automatic manifest barcode column when plate-scoped editing is active. */
+    hidePlateBarcodeColumn?: boolean;
+    /** Optional grouped well shortcuts rendered under the grid. */
+    groups?: PlateMapGroupOption[];
+    activeGroupId?: string;
+    onGroupClick?: (group: PlateMapGroupOption) => void;
+    /** Custom hover summary for the strip above the grid. */
+    renderHoverSummary?: (well: T | undefined, wellId: WellId) => React_2.ReactNode;
+    /** Fixed well size. When unset, the grid grows with the available width. */
+    cellSize?: number;
+    /** Fill color for empty wells. Pass `null` to delegate empty wells to `colorForWell`. */
+    emptyWellFillColor?: string | null;
+    /** Well shape forwarded to `PlatePaintGrid`. Defaults to `"rect"`. */
+    wellShape?: WellShape;
+    /** When true, wraps the grid in a card-like plate frame (rounded + border + soft shadow). */
+    framedPlate?: boolean;
+    /**
+     * Forwarded to `PlatePaintGrid`. Render-prop that places a node inside each
+     * absolute-positioned well cell — used to wire drop targets without binding
+     * the kit to a specific DnD library.
+     */
+    wrapWell?: (wellId: WellId, cellSize: number) => React_2.ReactNode;
+    /** Wells to highlight (e.g. when hovering a legend item externally). */
+    highlightedWellIds?: ReadonlySet<WellId>;
+    /** Fires whenever the currently hovered well changes (null on leave). */
+    onHoveredWellChange?: (wellId: WellId | null) => void;
+    /** Enables the filter popover on the manifest table. */
+    manifestFilterable?: boolean;
+    /** Enables the group-by selector on the manifest table. */
+    manifestGroupable?: boolean;
+    autoScaleGrid?: boolean;
+    minCellSize?: number;
+    maxCellSize?: number;
+    className?: string;
+}
+
+export declare interface PlateMapGroupOption {
+    id: string;
+    label: string;
+    /** Well ids in the group; callers can use this to select the group. */
+    wellIds?: WellId[];
+    /** Optional explicit count; defaults to `wellIds.length` when present. */
+    count?: number;
+    color?: string;
+    borderColor?: string;
+    disabled?: boolean;
+}
+
+export declare interface PlateMapPlateOption {
+    /** Stable plate id. For imported CSVs this should be the user-provided barcode. */
+    id: string;
+    /** User-provided plate barcode. Barcodes are never generated by the editor. */
+    barcode: string;
+    /** Optional display label when it differs from the barcode. */
+    label?: string;
+    /** Optional count shown beside the plate pill, usually imported row/well count. */
+    count?: number;
+    disabled?: boolean;
+}
+
+export declare function PlateMapPlateSelector({ plates, activePlateId, onPlateChange, onAddPlate, onRemovePlate, addPlateLabel, removePlateLabel, label, variant, align, side, className, }: PlateMapPlateSelectorProps): JSX.Element;
+
+export declare interface PlateMapPlateSelectorProps {
+    plates?: PlateMapPlateOption[];
+    activePlateId?: string;
+    onPlateChange?: (plateId: string) => void;
+    onAddPlate?: () => void;
+    /** When supplied, the tabs variant renders a delete affordance per plate. */
+    onRemovePlate?: (plateId: string) => void;
+    addPlateLabel?: string;
+    removePlateLabel?: string;
+    label?: string;
+    /** Layout. `"dropdown"` is the default single-trigger menu, `"tabs"` is a horizontal tab strip. */
+    variant?: PlateMapPlateSelectorVariant;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    className?: string;
+}
+
+export declare type PlateMapPlateSelectorVariant = "dropdown" | "tabs";
+
 /**
  * Props for PlateMap component
  */
@@ -2168,6 +2454,76 @@ export declare interface PlateMapProps {
     onWellClick?: (wellData: WellData) => void;
 }
 
+export declare function plateOptionsFromCsvTriage(triage: PlateMapCsvTriage): PlateMapPlateOption[];
+
+/**
+ * Interactive plate grid with drag-rectangle selection.
+ * - Click & drag: replace selection
+ * - Shift + drag: add to selection
+ * - Alt + drag: remove from selection
+ */
+export declare function PlatePaintGrid<T extends WellRecord = WellRecord>({ format, rows, columns, values, selection, onSelectionChange, colorForWell, emptyWellFillColor, wellShape, framed, cellSize, autoScale, minCellSize, maxCellSize, borderColor, selectedBorderColor, selectedFillColor, selectedFillOpacity, selectionFillMode, flashWellId, flashWellKey, highlightedWellIds, highlightBorderColor, onWellHover, onWellDoubleClick, wrapWell, className, }: PlatePaintGridProps<T>): JSX.Element;
+
+export declare interface PlatePaintGridProps<T extends WellRecord = WellRecord> {
+    format: PlateFormat;
+    rows?: number;
+    columns?: number;
+    values: Map<WellId, T>;
+    selection: Set<WellId>;
+    onSelectionChange: (next: Set<WellId>) => void;
+    /** Returns the fill color for a given well record (or undefined if empty). */
+    colorForWell: (well: T | undefined, wellId: WellId) => string;
+    /** Fill color for empty wells. Pass `null` to delegate empty wells to `colorForWell`. */
+    emptyWellFillColor?: string | null;
+    /** Geometric shape of each well. `"circle"` matches scientific plate visuals. Defaults to `"rect"`. */
+    wellShape?: WellShape;
+    /**
+     * When true, wraps the grid in a card-like surface (rounded, bordered,
+     * padded, soft shadow) so it reads as a physical plate. Pairs well with
+     * `wellShape="circle"`.
+     */
+    framed?: boolean;
+    /** Pixel size of each well cell. Defaults to 34 when fixed. */
+    cellSize?: number;
+    /** Resize wells to fill available width when `cellSize` is not fixed. */
+    autoScale?: boolean;
+    minCellSize?: number;
+    /** Defaults to 72 for 96-well style plates and 36 for denser plates. */
+    maxCellSize?: number;
+    /** Stroke color for non-selected wells. Defaults to a light border. */
+    borderColor?: string;
+    /** Stroke color for selected wells. Defaults to the kit primary blue. */
+    selectedBorderColor?: string;
+    /** Fill color for selected wells. Defaults to the kit primary blue. */
+    selectedFillColor?: string;
+    /** Selected fill opacity. */
+    selectedFillOpacity?: number;
+    /** Whether selected wells use the selection fill or keep their assigned well color. */
+    selectionFillMode?: "selection" | "well";
+    /** Well id that should briefly flash, usually after a double-click assignment. */
+    flashWellId?: WellId;
+    /** Changing this value restarts the flash animation for the same well. */
+    flashWellKey?: number;
+    /**
+     * Well ids that should render with a highlight ring. Used for cross-component
+     * hover sync (e.g. hovering a legend item to highlight matching wells).
+     */
+    highlightedWellIds?: ReadonlySet<WellId>;
+    /** Stroke color for highlighted wells. Defaults to the kit primary blue. */
+    highlightBorderColor?: string;
+    onWellHover?: (wellId: WellId | null) => void;
+    onWellDoubleClick?: (wellId: WellId) => void;
+    /**
+     * Optional render-prop invoked once per well. The returned node is placed
+     * inside an absolutely-positioned cell on top of the SVG, sized to
+     * `cellSize`. The wrapper layer is `pointer-events: none` so the SVG keeps
+     * pointer interaction by default; consumers wiring drop targets are expected
+     * to set `pointer-events: auto` on their own element while a drag is active.
+     */
+    wrapWell?: (wellId: WellId, cellSize: number) => React_2.ReactNode;
+    className?: string;
+}
+
 /**
  * A region to highlight on the plate (e.g., controls, sample areas, empty wells)
  */
@@ -2189,6 +2545,30 @@ declare interface PlateRegion {
     fillColor?: string;
 }
 
+export declare function PlateZoomControl({ zoom, onZoomChange, step, min, max, showReadout, className, }: PlateZoomControlProps): JSX.Element;
+
+export declare interface PlateZoomControlProps {
+    zoom: number;
+    onZoomChange: (next: number) => void;
+    /** Increment per click. Defaults to 0.1. */
+    step?: number;
+    min?: number;
+    max?: number;
+    /** Render a percentage readout between the buttons. Defaults to true. */
+    showReadout?: boolean;
+    className?: string;
+}
+
+export declare function Popover({ ...props }: React_2.ComponentProps<typeof Popover_2.Root>): JSX.Element;
+
+export declare function PopoverAnchor({ ...props }: React_2.ComponentProps<typeof Popover_2.Anchor>): JSX.Element;
+
+export declare function PopoverContent({ className, align, sideOffset, ...props }: React_2.ComponentProps<typeof Popover_2.Content>): JSX.Element;
+
+export declare function PopoverTrigger({ ...props }: React_2.ComponentProps<typeof Popover_2.Trigger>): JSX.Element;
+
+export declare function pos(row: number, col: number, columns: number): WellId;
+
 export declare const PromptInput: ({ className, accept, multiple, globalDrop, syncHiddenInput, maxFiles, maxFileSize, onError, onSubmit, children, ...props }: PromptInputProps) => JSX.Element;
 
 export declare const PromptInputActionAddAttachments: ({ label, ...props }: PromptInputActionAddAttachmentsProps) => JSX.Element;
@@ -2521,6 +2901,8 @@ export declare type ReasoningTriggerProps = ComponentProps<typeof CollapsibleTri
     getThinkingMessage?: (isStreaming: boolean, duration?: number) => ReactNode;
 };
 
+export declare function rectPositions(r0: number, c0: number, r1: number, c1: number, columns: number): WellId[];
+
 export declare interface ReferencedSourcesContext {
     sources: (SourceDocumentUIPart & {
         id: string;
@@ -2538,6 +2920,8 @@ export declare function ResizablePanel({ ...props }: ResizablePrimitive.PanelPro
 
 export declare function ResizablePanelGroup({ className, ...props }: ResizablePrimitive.GroupProps): JSX.Element;
 
+export declare function resolveDimensions(format: PlateFormat, rows?: number, columns?: number): PlateDimensions;
+
 export declare function RichListItem({ leading, primary, secondary, trailing, actions, className, variant, size, ...props }: RichListItemProps): JSX.Element;
 
 export declare function RichListItemAvatar({ initials, className, fallbackClassName, size, ...props }: RichListItemAvatarProps): JSX.Element;
@@ -2560,6 +2944,9 @@ export declare interface RichListItemProps extends Omit<React_2.ComponentProps<t
     actions?: React_2.ReactNode;
 }
 
+/** Letter for a row index. Supports A-Z then AA-ZZ for 1536-format plates. */
+export declare function rowLabel(row: number): string;
+
 export declare interface ScatterDataPoint {
     x: number;
     y: number;
@@ -2880,6 +3267,10 @@ declare interface TableContextValue<TData> {
     setFilters: (filters: FilterCondition[]) => void;
     filterConfig: FilterColumnConfig[];
     enableFiltering: boolean;
+    grouping: string | null;
+    setGrouping: (columnId: string | null) => void;
+    groupConfig: GroupColumnConfig[];
+    enableGrouping: boolean;
 }
 
 export declare function TableFooter({ className, ...props }: React_2.ComponentProps<"tfoot">): JSX.Element;
@@ -3119,6 +3510,30 @@ export declare interface TdpSearchSort {
     order: "asc" | "desc";
 }
 
+export declare function TemplateIOPanel({ templates, templateId, onTemplateChange, onClearTemplate, hasEntries, onImportCsv, onExportCsv, onImportTemplate, onExportTemplate, className, csvAccept, templateAccept, }: TemplateIOPanelProps): JSX.Element;
+
+export declare interface TemplateIOPanelProps extends ImportExportHandlers {
+    templates?: TemplateOption[];
+    templateId?: string;
+    onTemplateChange?: (id: string) => void;
+    onClearTemplate?: () => void;
+    /** Disable export buttons when there's nothing to export. */
+    hasEntries?: boolean;
+    className?: string;
+    csvAccept?: string;
+    templateAccept?: string;
+}
+
+export declare interface TemplateOption {
+    id: string;
+    label: string;
+    /** Optional group header in the dropdown (e.g. "Built-in", "User"). */
+    group?: string;
+    /** Optional supporting text for richer chooser menus. */
+    description?: string;
+    disabled?: boolean;
+}
+
 export declare const TetraScienceIcon: React_2.ForwardRefExoticComponent<Omit<TetraScienceIconProps, "ref"> & React_2.RefAttributes<SVGSVGElement>>;
 
 export declare interface TetraScienceIconProps extends React_2.SVGProps<SVGSVGElement> {
@@ -3235,6 +3650,10 @@ declare type ToolUIPartApproval = {
     reason?: string;
 } | undefined;
 
+export declare function triagePlateMapCsvByBarcode(text: string, options?: PlateMapCsvTriageOptions): PlateMapCsvTriage;
+
+export declare function triagePlateMapCsvFile(file: File, options?: PlateMapCsvTriageOptions): Promise<PlateMapCsvTriage | undefined>;
+
 /** TetraScience brand gradient — Light Blue 300 → Purple 500 → Violet Marble */
 export declare const TS_SHIMMER_GRADIENT = "linear-gradient(90deg, #549DFF, #8243BA, #9665F4)";
 
@@ -3335,6 +3754,27 @@ export declare interface UseTdpNavigationReturn {
  */
 declare type VisualizationMode = "heatmap" | "categorical";
 
+export declare interface WellColumn<T extends WellRecord = WellRecord> {
+    /** Stable id; falls back to `field` if omitted. */
+    id?: string;
+    header: string;
+    /** Optional leading icon in the table header. */
+    icon?: React_2.ReactNode;
+    /** Read direct property when `field` is set. */
+    field?: keyof T & string;
+    /** Min width in px (applied via inline style). */
+    minWidth?: number;
+    /**
+     * Cell renderer. If omitted, the cell renders a display value. `select`
+     * fields render as badge-style custom cells using the matching option label.
+     */
+    render?: (ctx: {
+        row: T;
+        wellId: WellId;
+        update: (patch: Partial<T>) => void;
+    }) => React_2.ReactNode;
+}
+
 /**
  * Well data for individual wells.
  *
@@ -3390,6 +3830,145 @@ export declare interface WellData {
     tooltipData?: Record<string, unknown>;
 }
 
+export declare interface WellField<T extends WellRecord = WellRecord> {
+    /** Key in the well record this field reads/writes. */
+    key: keyof T & string;
+    label: string;
+    /** Optional leading icon shown in form labels and matching table headers. */
+    icon?: React_2.ReactNode;
+    kind: WellFieldKind;
+    placeholder?: string;
+    /** Required for `kind: "select"` and `kind: "multiselect"`. */
+    options?: WellSelectOption[];
+    /** Visual style for `kind: "boolean"`. Defaults to `"checkbox"`. */
+    boolStyle?: "checkbox" | "switch";
+    /**
+     * When true, matching `WellManifestTable` cells render an inline editor of
+     * this field's `kind` (mirroring the form). Defaults to false — cells stay
+     * read-only unless the developer opts in or supplies `WellColumn.render`.
+     */
+    editableInTable?: boolean;
+    /**
+     * Custom renderer for the form input. Receives current value and a setter
+     * that patches the field on the staged form record.
+     */
+    render?: (ctx: {
+        value: unknown;
+        onChange: (next: unknown) => void;
+        selectionSize: number;
+    }) => React_2.ReactNode;
+}
+
+/**
+ * Field kinds rendered by `WellMetadataForm` and (when `editableInTable`) by
+ * `WellManifestTable`.
+ */
+export declare type WellFieldKind = "text" | "number" | "integer" | "boolean" | "date" | "datetime" | "time" | "select" | "multiselect" | "custom";
+
+export declare type WellId = string;
+
+export declare function WellLegend({ items, renderItem, onHoverEnter, onHoverLeave, onRemove, removeLabel, emptyLabel, className, }: WellLegendProps): JSX.Element;
+
+export declare interface WellLegendItem {
+    id: string;
+    label: React_2.ReactNode;
+    color: string;
+    /** Optional secondary text shown beneath the label. */
+    meta?: React_2.ReactNode;
+    disabled?: boolean;
+}
+
+export declare interface WellLegendProps {
+    items: WellLegendItem[];
+    /** Render-prop for fully custom cards. Bypasses the default card layout. */
+    renderItem?: (item: WellLegendItem) => React_2.ReactNode;
+    onHoverEnter?: (id: string) => void;
+    onHoverLeave?: (id: string) => void;
+    onRemove?: (id: string) => void;
+    removeLabel?: string;
+    emptyLabel?: string;
+    className?: string;
+}
+
+export declare function WellManifestTable<T extends WellRecord = WellRecord>({ values, columns, fields, selection, onSelectionChange, onChange, emptyEntry, isPopulated, pageSize: initialPageSize, pageSizeOptions, enableFillDown, rowProps, filterable, filterColumns, groupable, className, }: WellManifestTableProps<T>): JSX.Element;
+
+export declare interface WellManifestTableProps<T extends WellRecord = WellRecord> {
+    values: Map<WellId, T>;
+    columns: WellColumn<T>[];
+    /**
+     * Field schema. If a column has `field` matching a `select`-kind field, a
+     * Select cell renders automatically with that field's options.
+     */
+    fields?: WellField<T>[];
+    selection?: Set<WellId>;
+    onSelectionChange?: (next: Set<WellId>) => void;
+    onChange: (next: Map<WellId, T>) => void;
+    /** Builds an empty record for a freshly-created row. */
+    emptyEntry: (id: WellId) => T;
+    /** Filter that controls which empty rows surface. Defaults to `false`. */
+    isPopulated?: (row: T) => boolean;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    /** Adds a column header action that copies the first non-empty value downward. */
+    enableFillDown?: boolean;
+    /**
+     * Extra props spread onto each `<tr>` — typically used to attach a DnD
+     * library's `setNodeRef`, listeners, and data attributes so rows can act as
+     * drag sources. The kit stays DnD-library-agnostic.
+     */
+    rowProps?: (ctx: WellManifestTableRowContext<T>) => React_2.ComponentProps<"tr"> | undefined;
+    /** Enables an inline filter popover above the table. Defaults to false. */
+    filterable?: boolean;
+    /**
+     * Optional override of filterable column configs. When omitted, every column
+     * with a `field` becomes filterable using the default operator set from the
+     * shared data-table filter system.
+     */
+    filterColumns?: FilterColumnConfig[];
+    /** Enables an inline group-by selector. Defaults to false. */
+    groupable?: boolean;
+    className?: string;
+}
+
+export declare interface WellManifestTableRowContext<T extends WellRecord = WellRecord> {
+    wellId: WellId;
+    row: T;
+    isSelected: boolean;
+}
+
+export declare function WellMetadataForm<T extends WellRecord = WellRecord>({ fields, value, onChange, selectionSize, onApply, onClear, applyLabel, clearLabel, extras, className, }: WellMetadataFormProps<T>): JSX.Element;
+
+export declare interface WellMetadataFormProps<T extends WellRecord = WellRecord> {
+    fields: WellField<T>[];
+    /** Staged values used to apply across the selection. */
+    value: Partial<T>;
+    onChange: (next: Partial<T>) => void;
+    selectionSize: number;
+    onApply: () => void;
+    onClear: () => void;
+    applyLabel?: string;
+    clearLabel?: string;
+    /** Optional extra slot rendered between fields and action row. */
+    extras?: React_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * Generic per-well record. Callers supply concrete shape via the `T` generic
+ * on `PlateMapEditor`. Permissive base accepts both interfaces and indexable
+ * record types.
+ */
+export declare type WellRecord = NonNullable<unknown>;
+
+export declare interface WellSelectOption {
+    value: string;
+    label: string;
+    /** Optional swatch color shown next to the label. */
+    swatch?: string;
+}
+
+export declare type WellShape = "rect" | "circle";
+
 export { }