import { ComputedRef, Ref } from 'vue';
import { SampleGroup } from '../types';
export type SampleGroupSource<T> = T | Ref<T> | ComputedRef<T> | (() => T);
export interface DisplaySampleSubGroup extends SampleGroup {
    displayColor: string;
    displayBg: string;
    displayBorder: string;
}
export interface SampleMajorGroup {
    name: string;
    color: string;
    subGroups: DisplaySampleSubGroup[];
    allSamples: string[];
}
/**
 * One node of the sample-group display hierarchy. Interior nodes are path
 * prefixes of the group names (`Liver`, `Liver / High`); leaves carry the
 * concrete group. A group's `name` stays the full path on its leaf because
 * every mutation — drag, delete, colour, selection — resolves groups by name.
 */
export interface SampleGroupNode {
    /** Unique across the tree; use for `:key` and expansion state. */
    key: string;
    /** This node's own path segment, not the full path. */
    label: string;
    color: string;
    displayBg: string;
    displayBorder: string;
    /** Every sample beneath this node, in group order. */
    allSamples: string[];
    /** Empty for leaves. */
    children: SampleGroupNode[];
    /** Present only on leaves. */
    group?: DisplaySampleSubGroup;
}
export interface UseSampleGroupsOptions {
    groups: SampleGroupSource<readonly SampleGroup[]>;
    samples?: SampleGroupSource<readonly string[]>;
    separator?: SampleGroupSource<string | null | undefined>;
    fallbackColor?: SampleGroupSource<string | null | undefined>;
}
export interface UseSampleGroupsReturn {
    groups: ComputedRef<SampleGroup[]>;
    separator: ComputedRef<string>;
    /** Full N-layer display hierarchy; one level per group-name segment. */
    groupTree: ComputedRef<SampleGroupNode[]>;
    /** Deepest layer count across the tree (1 when groups are flat). */
    maxDepth: ComputedRef<number>;
    hierarchicalGroups: ComputedRef<SampleMajorGroup[]>;
    showHierarchy: ComputedRef<boolean>;
    groupedSamples: ComputedRef<Set<string>>;
    ungroupedSamples: ComputedRef<string[]>;
    findGroup: (groupName: string) => SampleGroup | undefined;
    getGroupColor: (groupName: string) => string;
}
/** Shared sample-group hierarchy, color, and ungrouped-sample derivation for lab selectors. */
export declare function useSampleGroups(options: UseSampleGroupsOptions): UseSampleGroupsReturn;