Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

4.1 KB
Raw Blame
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0

import {
  Tooltip,
  TooltipContent,
  TooltipTrigger,
} from "@/components/ui/tooltip";
import { cn } from "@/lib/utils";
import { InformationCircleIcon } from "@hugeicons/core-free-icons";
import { HugeiconsIcon } from "@hugeicons/react";
import type { ReactNode } from "react";

export function SettingsRow({
  label,
  description,
  hint,
  badge,
  icon,
  iconAlign = "center",
  children,
  destructive,
  className,
  below,
  wideControl = false,
}: {
  label: string;
  description?: ReactNode;
  /** Shown on hover; plain text because it doubles as the trigger's aria-label. */
  hint?: string;
  badge?: ReactNode;
  icon?: ReactNode;
  iconAlign?: "center" | "top";
  children?: ReactNode;
  destructive?: boolean;
  className?: string;
  below?: ReactNode;
  /** Lets a control that shows a value it must not clip (a folder path) pass the shared cap. */
  wideControl?: boolean;
}) {
  return (
    <div
      data-settings-label={label}
      className={cn(
        // Controls are fixed-width, so wrap to avoid starving the label.
        "flex flex-wrap justify-end gap-x-6 gap-y-2 py-3",
        description ? "items-start" : "items-center",
        destructive && "border-t border-border/60 mt-2 pt-4",
        className,
      )}
    >
      <div className="flex min-w-[calc(11rem*var(--ui-space-scale,1))] flex-1 basis-0 items-center gap-2.5">
        {icon ? (
          <span className={cn("flex shrink-0 items-center text-foreground", iconAlign === "top" && "self-start")}>
            {icon}
          </span>
        ) : null}
        <div className="flex min-w-0 w-full max-w-[calc(32rem*var(--ui-space-scale,1))] flex-col gap-0.5">
          <span className="text-sm font-medium text-foreground">
            {label}
            {badge ? <span className="ml-1.5 inline-flex align-middle">{badge}</span> : null}
            {hint ? (
              <Tooltip>
                <TooltipTrigger asChild={true}>
                  {/* Focusable and labelled, so keyboard users reach the
                      text too. Matches the secure-HTTPS hint. Inline on the
                      baseline, so it follows the label's last word like a glyph. */}
                  <button
                    type="button"
                    aria-label={hint}
                    className="ml-1.5 inline-flex align-baseline rounded-full text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
                  >
                    {/* Sized off the token, not size-3.5: the label beside it is
                        scaled by the UI font size preference, and a fixed 14px
                        glyph drifts out of proportion with it. Same curve the
                        app's other small glyphs follow. */}
                    <HugeiconsIcon
                      icon={InformationCircleIcon}
                      className="size-[var(--ui-icon-size-hint)]"
                    />
                  </button>
                </TooltipTrigger>
                <TooltipContent className="max-w-[calc(300px*var(--ui-space-scale,1))] text-ui-11 leading-snug">
                  {hint}
                </TooltipContent>
              </Tooltip>
            ) : null}
          </span>
          {description ? (
            <span className="text-xs text-muted-foreground leading-snug">
              {description}
            </span>
          ) : null}
        </div>
      </div>
      {children ? (
        <div
          // Aligned to the title line by index.css; an items-center here would override it.
          data-title-line-control={description ? true : undefined}
          className={cn(
            "flex max-w-full shrink-0",
            !description && "items-center",
            !wideControl &&
              "max-w-[min(100%,calc(20rem*var(--ui-space-scale,1)))] [&>*]:max-w-full",
          )}
        >
          {children}
        </div>
      ) : null}
      {below ? (
        <div className="flex basis-full justify-end">{below}</div>
      ) : null}
    </div>
  );
}