The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
TypeScript analyticsbibusiness-intelligencebusinessintelligenceclojuredashboarddatadata-analysisdata-visualizationdatabasemetabasemysqlpostgrespostgresqlreportingslacksql-editorvisualization
import {
Children,
type PropsWithChildren,
type ReactElement,
isValidElement,
} from "react";
import {
Popover,
type PopoverProps,
useStablePopoverPosition,
} from "metabase/ui";
type StepValue = string | number;
type StepProps = PropsWithChildren<{
value: StepValue;
}>;
const Step = ({ children }: PropsWithChildren<StepProps>) => {
return children;
};
const Target = ({ children }: PropsWithChildren) => {
return <>{children}</>;
};
export type MultiStepState<T extends StepValue = StepValue> = T | null;
type MultiStepPopoverProps<T extends StepValue = StepValue> =
PropsWithChildren<{
currentStep: MultiStepState<T>;
onClose?: () => void;
}>;
const MultiStepPopoverContent = ({
currentStep,
onClose,
children,
position = "bottom-start",
...popoverProps
}: MultiStepPopoverProps &
Omit<PopoverProps, "children" | "onClose" | "opened">) => {
const findChild = <T extends ReactElement>(
predicate: (child: ReactElement) => child is T,
): T | null => {
const child = Children.toArray(children).find(
(child): child is T => isValidElement(child) && predicate(child),
);
return child || null;
};
const currentStepContent = findChild(
(child): child is ReactElement<StepProps> => {
// A `child.type === Step` match guarantees the element carries StepProps.
const props = child.props as StepProps;
return child.type === Step && props.value === currentStep;
},
)?.props.children;
const targetElement = findChild(
(child): child is ReactElement<PropsWithChildren> => child.type === Target,
)?.props.children;
const stablePositionProps = useStablePopoverPosition(position);
return (
<Popover
position={stablePositionProps.position}
middlewares={stablePositionProps.middlewares}
onClose={stablePositionProps.onClose}
opened={currentStep !== null}
onDismiss={onClose}
{...popoverProps}
>
<Popover.Target>{targetElement}</Popover.Target>
<Popover.Dropdown>{currentStepContent}</Popover.Dropdown>
</Popover>
);
};
export const MultiStepPopover = Object.assign(MultiStepPopoverContent, {
Step,
Target,
});