@tetrascience-npm/tetrascience-react-ui 0.5.0-beta.70.1 → 0.5.0-beta.72.1

package/dist/index.d.ts

@@ -2310,6 +2310,99 @@ export declare interface PlateMapEditorProps<T extends WellRecord = WellRecord>
     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;
@@ -2322,6 +2415,35 @@ export declare interface PlateMapGroupOption {
     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;