/**
 * Builds a stable, traceable DOM id for a component instance.
 *
 * The generated id is `${component}-${useId()}` (React's `useId` output is
 * normalized so the value is a valid CSS selector), which makes it easy to
 * locate a specific rendered component in the DOM, in snapshots, or in
 * browser/e2e tooling.
 *
 * A caller-provided `id` always wins so consumers keep full control.
 *
 * @example
 * const id = useTraceId("auth-card-header", props.id)
 * // -> "auth-card-header-r1a"
 */
export declare function useTraceId(component: string, id?: string): string;