import { type ChangeEvent, type PropsWithChildren, type ReactNode, useCallback, useId, useMemo, useState, } from "react"; import { cn } from "./cn.js"; import { ResiduesHeader } from "./toggles/ResidueHeader.js"; import { type Variant, residueVariants } from "./toggles/variants.js"; import { useChunked } from "./useChunked.js"; /** * Hook for handling residue selection change. */ export function useResidueChangeHandler({ selected, options, onChange, filter = () => true, }: { options: Residue[]; selected: ResidueSelection; onChange: (selected: ResidueSelection) => void; /** * The optional filter function to determine * if a residue should be included in a range selection. * * @param resno * @returns */ filter?: (resno: number) => boolean; }) { const [lastChecked, setLastChecked] = useState(null); const handler = useCallback( (e: ChangeEvent, index: number, actpass: ActPass) => { const residue = Number.parseInt(e.target.value); const ne = e.nativeEvent as KeyboardEvent; let newSelected: number[] = []; if (ne.shiftKey && lastChecked !== null) { const start = Math.min(lastChecked, index); const end = Math.max(lastChecked, index); newSelected = [...selected[actpass]]; for (let i = start; i <= end; i++) { const resno = options[i]!.resno; if (!newSelected.includes(resno) && filter(resno)) { newSelected.push(resno); } } } else { if (e.target.checked) { newSelected = [...selected[actpass], residue]; } else { newSelected = selected[actpass].filter((r) => r !== residue); } } if (actpass === "act") { // Active should take precedence over passive. // For example given passive is selected, // then selecting same residue as active should remove it from passive. const passiveWithoutAlsoActive = selected.pass.filter( (r) => !newSelected.includes(r), ); onChange({ act: newSelected, pass: passiveWithoutAlsoActive, }); } else { onChange({ pass: newSelected, act: selected.act, }); } if (e.target.checked) { setLastChecked(index); } }, [filter, lastChecked, onChange, options, selected], ); return handler; } export interface Residue { resno: number; resname: string; seq: string; surface?: boolean; } export function FormDescription({ children }: PropsWithChildren): ReactNode { return

{children}

; } /** * Renders a checkboxes component for a residue. * * This component is used to display a checkbox for a residue, allowing the user to toggle its active and passive states. * */ export function ResidueCheckbox({ resno, resname, seq, showActive, showPassive, highlight, activeChecked, passiveChecked, neighbourChecked, activeDisabled, passiveDisabled, onHover, onActiveChange, onPassiveChange, theme = "light", }: { resno: number; resname: string; seq: string; showActive: boolean; showPassive: boolean; /** * External component wants us to highlight this residue. */ highlight: boolean; activeChecked: boolean; passiveChecked: boolean; /** * If residue is selected as a neighbour the passive checkbox is checked. */ neighbourChecked: boolean; activeDisabled: boolean; passiveDisabled: boolean; /** * We want external component to know we are hovering */ onHover: () => void; onActiveChange: (event: ChangeEvent) => void; onPassiveChange: (event: ChangeEvent) => void; theme: "light" | "dark"; }) { const id = useId(); const style = { colorScheme: theme === "dark" ? "dark" : "light" }; let htmlFor = id + "act"; if (showPassive && !showActive) { htmlFor = id + "pass"; } let variant: Variant = ""; if (passiveChecked || neighbourChecked) { variant = "pass"; } if (activeChecked) { variant = "act"; } if (highlight) { variant = "highlight"; } // Make checkboxes the same height as ResidueHeader let className = "w-4"; if (seq === "X" && resname.length === 3) { className = "grid justify-items-center"; if (showActive && showPassive) { className += " h-[4.5rem]"; } else if (showActive || showPassive) { className += " h-[3rem]"; } } return (
{showActive && ( )} {showPassive && ( )}
); } export interface ResidueSelection { act: number[]; pass: number[]; } export interface ResidueNeighbourSelection extends ResidueSelection { neighbours: number[]; } export function ResiduesSelect({ options, selected, onChange, disabledPassive = false, disabledActive = false, showPassive = false, showActive = false, showNeighbours = false, onHover, highlight, theme = "light", }: { options: Residue[]; selected: ResidueNeighbourSelection; onChange: (selected: ResidueSelection) => void; disabledPassive?: boolean; disabledActive?: boolean; showPassive?: boolean; showActive?: boolean; showNeighbours?: boolean; onHover: (resno: number | undefined) => void; highlight: number | undefined; theme: "light" | "dark"; }) { const surface = useMemo( () => options.filter((r) => r.surface).map((r) => r.resno), [options], ); const handleChange = useResidueChangeHandler({ options, selected, onChange, filter: (resno: number) => surface.includes(resno), }); const chunkSize = 10; const chunks = useChunked(options, chunkSize); return ( <>
{chunks.map((chunk, cindex) => (

{chunk[0]!.resno}

onHover(undefined)} className="flex flex-row" > {chunk.map((r, index) => ( onHover(r.resno)} onActiveChange={(e) => handleChange(e, cindex * chunkSize + index, "act") } onPassiveChange={(e) => handleChange(e, cindex * chunkSize + index, "pass") } showActive={showActive} showPassive={showPassive || showNeighbours} neighbourChecked={selected.neighbours.includes(r.resno)} theme={theme} /> ))}
))}
(Hold Shift to select a range of residues. Click residue in 3D viewer to select.) ); } /** * Either active or passive. */ export type ActPass = "act" | "pass"; /** * Toggle to select if picking in 3D viewer should select active or passive residues. */ export function PickIn3D({ value, onChange, }: { value: ActPass; onChange: (value: ActPass) => void; }) { const idAct = useId(); const idPass = useId(); return (
3D viewer picks
{/* TODO make stylable from outside */}
onChange("act")} />
onChange("pass")} />
); } /** * Toggles the selection state of a residue number in either the "act" or "pass" list. * * @param resno - The residue number to toggle. * @param pick - The selection type, either "act" or "pass". * @param current - The current selection state containing "act" and "pass" lists. * @returns The new selection state with the residue number toggled in the appropriate list. */ export function toggleResidue( resno: number, pick: ActPass, current: ResidueSelection, ): ResidueSelection { const newSelection = { act: current.act, pass: current.pass, }; if (pick === "act") { if (newSelection.act.includes(resno)) { newSelection.act = newSelection.act.filter((r) => r !== resno); } else { newSelection.act = [...newSelection.act, resno]; newSelection.pass = current.pass.filter( (r) => !newSelection.act.includes(r), ); } } else { if (newSelection.pass.includes(resno)) { newSelection.pass = newSelection.pass.filter((r) => r !== resno); } else { newSelection.pass = [...newSelection.pass, resno]; newSelection.act = current.act.filter( (r) => !newSelection.pass.includes(r), ); } } return newSelection; }