/**
 * Creates a vanilla JS checkbox element
 */
export interface CreateCheckboxOptions {
    checked: boolean;
    /** When true, shows a minus mark and sets aria-checked="mixed" (partial selection). */
    indeterminate?: boolean;
    onChange: (checked: boolean) => void;
    ariaLabel?: string;
}
/** Shared checkmark SVG for checkbox custom visual (used by createCheckbox and update helpers). */
export declare const createCheckmarkSVG: () => SVGSVGElement;
/** Shared minus SVG for indeterminate checkbox custom visual. */
export declare const createMinusSVG: () => SVGSVGElement;
/**
 * Updates an existing checkbox DOM (created by createCheckbox) to match the given checked state.
 * Use when the checkbox element is reused (e.g. from cache) and selection state changed.
 * Clears any indeterminate state unless `indeterminate` is passed as true.
 * @param container - Element that contains .st-checkbox-input and .st-checkbox-custom (the label or a parent)
 */
export declare const updateCheckboxElement: (container: HTMLElement, checked: boolean, indeterminate?: boolean) => void;
export declare const createCheckbox: ({ checked, indeterminate, onChange, ariaLabel, }: CreateCheckboxOptions) => {
    element: HTMLLabelElement;
    update: (newChecked: boolean, newIndeterminate?: boolean) => void;
    destroy: () => void;
};