feat(types): add database type help

This commit is contained in:
二丫讲梵 authored and GitHub committed 2026-07-12 13:28:46 +08:00
1 parent fdb33ef477
commit 4f1997d8eb
30 files changed
+2006 -79

No files matched your search

@@ -0,0 +1,13 @@
export interface OptionHelpPanelOffsetInput {
activeItemTop: number;
listCardHeight: number;
panelHeight: number;
}
/** Aligns a help card to its active row without allowing it past the list card. */
export function optionHelpPanelOffsetTop({ activeItemTop, listCardHeight, panelHeight }: OptionHelpPanelOffsetInput): number {
if (![activeItemTop, listCardHeight, panelHeight].every(Number.isFinite)) return 0;
const desiredTop = Math.max(0, activeItemTop);
const maxTop = Math.max(0, listCardHeight - Math.max(0, panelHeight));
return Math.min(desiredTop, maxTop);
}
@@ -0,0 +1,19 @@
export type SearchableSelectOptionTooltip = (option: string) => string | undefined;
/** Keep the option list aligned with its trigger while help expands rightward. */
export const SEARCHABLE_SELECT_HELP_PANEL_ALIGN = "start";
/**
* Returns the option whose help panel is activated by keyboard navigation
* while focus remains in the searchable input. Empty-string options are valid.
*/
export function searchableSelectKeyboardTooltipOption(options: readonly string[], highlightIndex: number, optionTooltip?: SearchableSelectOptionTooltip): string | undefined {
const option = options[highlightIndex];
return option === undefined || !optionTooltip?.(option) ? undefined : option;
}
/** Returns the selected option's help, or the first available option's help. */
export function searchableSelectSelectedOrFirstHelpOption(options: readonly string[], selectedOption: string, optionTooltip?: SearchableSelectOptionTooltip): string | undefined {
if (options.includes(selectedOption) && optionTooltip?.(selectedOption)) return selectedOption;
return options.find((option) => !!optionTooltip?.(option));
}