@tetrascience-npm/tetrascience-react-ui 0.5.0 → 0.6.0-beta.78.1

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { ColumnOrderState } from '@tanstack/react-table';
 import { Combobox as Combobox_2 } from '@base-ui/react';
 import { Command as Command_2 } from 'cmdk';
 import { ComponentProps } from 'react';
+import { ComponentPropsWithoutRef } from 'react';
 import { Context as Context_2 } from 'react';
 import { ContextMenu as ContextMenu_2 } from 'radix-ui';
 import { DayButton } from 'react-day-picker';
@@ -35,10 +36,12 @@ import { Locale } from 'react-day-picker';
 import { LucideIcon } from 'lucide-react';
 import { MemoExoticComponent } from 'react';
 import { Menubar as Menubar_2 } from 'radix-ui';
+import { MouseEvent as MouseEvent_2 } from 'react';
 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 +118,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 +227,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;
@@ -509,11 +543,38 @@ export declare type ChainOfThoughtTriggerProps = ComponentProps<typeof Collapsib
 };
 
 /**
- * Chart color palette for consistent graph styling
- * Uses the primary graph colors from the design system
+ * Chart color palette for consistent graph styling.
+ *
+ * CVD-friendly (deuteranopia / protanopia / tritanopia) categorical palette.
+ * Single source of truth is the `--chart-1` … `--chart-12` CSS variables in
+ * `index.tailwind.css`; the hex fallbacks below are used during SSR / before
+ * the stylesheet resolves. Slots 1–8 are recommended; 9–12 are for sparing use
+ * when more than 8 series are needed.
  */
 export declare const CHART_COLORS: readonly [string, string, string, string, string, string, string, string, string, string, string, string];
 
+/**
+ * CVD-friendly diverging ramps (midpoint at step 06/07). Red/green pairings
+ * are intentionally avoided (worst for deutan/protan).
+ * Source of truth: `--chart-div-*` CSS variables in `index.tailwind.css`.
+ */
+export declare const CHART_DIVERGING: {
+    readonly blueOrange: string[];
+    readonly tealMagenta: string[];
+    readonly purpleYellowGreen: string[];
+};
+
+/**
+ * CVD-friendly sequential ramps (light → dark, anchored on brand).
+ * 12 steps each — pass to a chart's colorscale / sequential interpolator.
+ * Source of truth: `--chart-seq-*` CSS variables in `index.tailwind.css`.
+ */
+export declare const CHART_SEQUENTIAL: {
+    readonly blue: string[];
+    readonly teal: string[];
+    readonly purple: string[];
+};
+
 export declare const Chat: ({ initialMessages, models, defaultModel, suggestions, onSend, className, }: ChatProps) => JSX.Element;
 
 export declare interface ChatMessage {
@@ -1134,7 +1195,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 +1213,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 +1254,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 +1432,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 +1462,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 +1491,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 +1569,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 +1825,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 +2055,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 +2145,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 +2184,326 @@ 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;
+}
+
+/**
+ * Card-agnostic metadata form panel. Renders the staged-value form (or a
+ * caller-supplied `formSlot`) plus an optional legend. Bring your own
+ * container — drop it bare into a sidebar, wrap it in a `Card`, or stack it
+ * above the grid.
+ */
+export declare function PlateMapForm<T extends WellRecord = WellRecord>({ fields, value, onChange, selectionSize, onApply, onClear, applyLabel, clearLabel, extras, legend, formSlot, className, }: PlateMapFormProps<T>): JSX.Element;
+
+export declare interface PlateMapFormProps<T extends WellRecord = WellRecord> {
+    fields: WellField<T>[];
+    /** Staged values applied across the current selection on Apply. */
+    value: Partial<T>;
+    onChange: (next: Partial<T>) => void;
+    selectionSize: number;
+    onApply: () => void;
+    onClear: () => void;
+    applyLabel?: string;
+    clearLabel?: string;
+    /** Helper slot rendered between the fields and the action row. */
+    extras?: React_2.ReactNode;
+    /** Legend block rendered beneath the form, separated by a divider. */
+    legend?: React_2.ReactNode;
+    /**
+     * Fully replaces the built-in `WellMetadataForm` — e.g. a drag-and-drop
+     * source palette. The legend slot still renders beneath the replacement.
+     */
+    formSlot?: React_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * Card-agnostic plate grid panel. Renders the selection toolbar, hover
+ * summary, the interactive `PlatePaintGrid`, and optional group shortcuts —
+ * and owns the ephemeral hover state internally. The plate title, plate
+ * selector, and actions menu are intentionally NOT part of this panel; compose
+ * `PlateMapPlateSelector` and `PlateMapActionsMenu` around it for full layout
+ * freedom.
+ */
+export declare function PlateMapGrid<T extends WellRecord = WellRecord>({ format, rows, columns, values, selection, onSelectionChange, colorForWell, fields, renderHoverSummary, onHoveredWellChange, hoveredWellId, toolbar, hideSelectionControls, selectAllLabel, deselectAllLabel, emptyWellFillColor, wellShape, framed, wrapWell, highlightedWellIds, onWellDoubleClick, selectionFillMode, flashWellId, flashWellKey, cellSize, autoScale, minCellSize, maxCellSize, groups, activeGroupId, onGroupClick, className, }: PlateMapGridProps<T>): JSX.Element;
+
+export declare interface PlateMapGridProps<T extends WellRecord = WellRecord> {
+    format: PlateFormat;
+    rows?: number;
+    columns?: number;
+    values: Map<WellId, T>;
+    selection: Set<WellId>;
+    onSelectionChange: (next: Set<WellId>) => void;
+    /** Resolves the SVG fill color for a well. */
+    colorForWell: (well: T | undefined, wellId: WellId) => string;
+    /** Field schema used to build the default hover summary string. */
+    fields?: WellField<T>[];
+    /** Custom hover summary for the strip above the grid. */
+    renderHoverSummary?: (well: T | undefined, wellId: WellId) => React_2.ReactNode;
+    /** Fires whenever the currently hovered well changes (null on leave). */
+    onHoveredWellChange?: (wellId: WellId | null) => void;
+    /**
+     * Controlled hovered well id. When provided, the panel reflects this value
+     * instead of tracking hover internally — useful for syncing the hover
+     * summary with external state (e.g. resetting it on a plate switch).
+     */
+    hoveredWellId?: WellId | null;
+    /** Controls rendered to the left of the built-in select/deselect links. */
+    toolbar?: React_2.ReactNode;
+    /** Hide the built-in "Select all" / "Deselect all" links. */
+    hideSelectionControls?: boolean;
+    selectAllLabel?: string;
+    deselectAllLabel?: string;
+    /** 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). */
+    framed?: boolean;
+    /** Render-prop that places a node inside each absolute-positioned well cell. */
+    wrapWell?: (wellId: WellId, cellSize: number) => React_2.ReactNode;
+    /** Wells to highlight (e.g. when hovering a legend item externally). */
+    highlightedWellIds?: ReadonlySet<WellId>;
+    onWellDoubleClick?: (wellId: WellId) => void;
+    selectionFillMode?: "selection" | "well";
+    flashWellId?: WellId;
+    flashWellKey?: number;
+    /** Fixed well size. When unset, the grid grows with the available width. */
+    cellSize?: number;
+    autoScale?: boolean;
+    minCellSize?: number;
+    maxCellSize?: number;
+    /** Optional grouped well shortcuts rendered under the grid. */
+    groups?: PlateMapGroupOption[];
+    activeGroupId?: string;
+    onGroupClick?: (group: PlateMapGroupOption) => void;
+    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;
+}
+
+/**
+ * Card-agnostic sample-manifest panel. A thin wrapper over `WellManifestTable`
+ * with an optional heading and no width constraint of its own, so it can span
+ * the full screen width or sit inside any container the caller chooses.
+ */
+export declare function PlateMapManifest<T extends WellRecord = WellRecord>({ values, onChange, columns, fields, selection, onSelectionChange, emptyEntry, isPopulated, filterable, groupable, pageSize, pageSizeOptions, title, className, }: PlateMapManifestProps<T>): JSX.Element;
+
+export declare interface PlateMapManifestProps<T extends WellRecord = WellRecord> {
+    values: Map<WellId, T>;
+    onChange: (next: Map<WellId, T>) => void;
+    columns: WellColumn<T>[];
+    fields?: WellField<T>[];
+    selection?: Set<WellId>;
+    onSelectionChange?: (next: Set<WellId>) => void;
+    /** Builds an empty record when a manifest row is freshly created. */
+    emptyEntry: (id: WellId) => T;
+    /** Filter for the manifest's "hide empty" mode. */
+    isPopulated?: (row: T) => boolean;
+    /** Enables the filter popover on the manifest table. */
+    filterable?: boolean;
+    /** Enables the group-by selector on the manifest table. */
+    groupable?: boolean;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    /** Optional heading rendered above the table. Omit for a bare table. */
+    title?: React_2.ReactNode;
+    className?: string;
+}
+
+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 +2605,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 +2696,127 @@ 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;
+
+/**
+ * Runtime list of the visual states supported by ProcessFlow steps.
+ * Use this for controls, schemas, and forms that need to present the same status values the component understands.
+ */
+export declare const PROCESS_FLOW_STEP_STATUSES: readonly ["pending", "active", "completed", "error", "disabled"];
+
+export declare function ProcessFlow({ steps, connections, selectedStepId, onStepSelect, orientation, size, showDescriptions, className, style, "aria-label": ariaLabel, ...props }: ProcessFlowProps): JSX.Element | null;
+
+/** Connection between two steps in a branching/configurable flow. Linear flows derive connections automatically. */
+export declare interface ProcessFlowConnection {
+    id?: string;
+    from: string;
+    to: string;
+    status?: ProcessFlowStepStatus;
+    ariaLabel?: string;
+}
+
+/** Direction for linear process flows. Branching flows are configured with step positions and connections. */
+export declare type ProcessFlowOrientation = "horizontal" | "vertical";
+
+/**
+ * Presentational process flow.
+ *
+ * ProcessFlow is fully controlled by props. It visualizes parent-owned workflow state and emits user selection through
+ * onStepSelect. It intentionally does not own status transitions or fire completion/error side effects.
+ */
+export declare interface ProcessFlowProps extends Omit<ComponentPropsWithoutRef<"nav">, "onSelect"> {
+    /** Ordered list of steps to render. Each step controls its own visual status. */
+    steps: ProcessFlowStep[];
+    /** Optional explicit connections for branching/configurable flows. */
+    connections?: ProcessFlowConnection[];
+    /** Selected/viewed step id. This is separate from the active workflow status. */
+    selectedStepId?: string;
+    /** Called when a selectable step is clicked. Disabled and non-selectable steps do not call this. */
+    onStepSelect?: (step: ProcessFlowStep, details: ProcessFlowStepSelectDetails) => void;
+    orientation?: ProcessFlowOrientation;
+    size?: ProcessFlowSize;
+    /** Defaults to true. Set to false to hide step descriptions. */
+    showDescriptions?: boolean;
+}
+
+/** Visual density of the process flow. */
+export declare type ProcessFlowSize = "default" | "compact";
+
+/**
+ * Configurable step rendered by ProcessFlow.
+ *
+ * Keep workflow-specific behavior in the parent. A step config should describe what to render, not what to do when a
+ * workflow completes or errors.
+ */
+export declare interface ProcessFlowStep {
+    /** Stable identifier used for selection and connections. */
+    id: string;
+    /** Visible step label. */
+    label: ReactNode;
+    /** Optional secondary text shown under or beside the label. */
+    description?: ReactNode;
+    /** Parent-controlled visual state. Defaults to "pending". */
+    status?: ProcessFlowStepStatus;
+    /** Accessible label for selectable steps. */
+    ariaLabel?: string;
+    /** Forces the step into the disabled visual/non-interactive state. */
+    disabled?: boolean;
+    /** Set to false when the step should render as non-navigable even when onStepSelect is provided. */
+    selectable?: boolean;
+    /** Optional grid position for simple branching/configurable layouts. */
+    position?: ProcessFlowStepPosition;
+}
+
+export declare type ProcessFlowStepConfig = ProcessFlowStep;
+
+export declare interface ProcessFlowStepPosition {
+    /** Zero-based row used when rendering a simple branching/configurable flow. */
+    row?: number;
+    /** Zero-based column used when rendering a simple branching/configurable flow. */
+    column?: number;
+}
+
+export declare interface ProcessFlowStepSelectDetails {
+    /** Zero-based index of the selected step in the steps prop. */
+    stepIndex: number;
+    /** Current visual status of the selected step. */
+    status: ProcessFlowStepStatus;
+    nativeEvent: MouseEvent_2<HTMLButtonElement>;
+}
+
+/**
+ * Visual state for a ProcessFlow step.
+ *
+ * The parent application owns this state. ProcessFlow renders the provided status and does not run workflow side effects.
+ */
+export declare type ProcessFlowStepStatus = (typeof PROCESS_FLOW_STEP_STATUSES)[number];
+
+export declare type ProcessStep = ProcessFlowStep;
+
+export declare type ProcessStepStatus = ProcessFlowStepStatus;
+
 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 +3149,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 +3168,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 +3192,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 +3515,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 +3758,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 +3898,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 +4002,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 +4078,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 { }