cinny/src/app/components/setting-tile/SettingTile.tsx

import React, { ReactNode, useEffect, useId, useRef } from 'react';
import { Box, Text } from 'folds';
import { BreakWord } from '../../styles/Text.css';

type SettingTileProps = {
  title?: ReactNode;
  description?: ReactNode;
  before?: ReactNode;
  after?: ReactNode;
  children?: ReactNode;
};
export function SettingTile({ title, description, before, after, children }: SettingTileProps) {
  const titleId = useId();
  const afterRef = useRef<HTMLDivElement>(null);

  // [Gitea #185] The control in `after` is almost always an icon-only Switch
  // (or a bare select/input) whose only visible label is this tile's title.
  // Point it at the title so screen readers announce "Show Notifications,
  // switch, on" instead of "switch, on". Explicit labels are left alone.
  useEffect(() => {
    if (!title || !afterRef.current) return;
    afterRef.current
      .querySelectorAll<HTMLElement>('[role="switch"], input, select, textarea, [role="combobox"]')
      .forEach((el) => {
        if (el.hasAttribute('aria-label') || el.hasAttribute('aria-labelledby')) return;
        if (
          el.tagName === 'INPUT' &&
          el.id &&
          afterRef.current?.querySelector(`label[for="${el.id}"]`)
        )
          return;
        el.setAttribute('aria-labelledby', titleId);
      });
  });

  return (
    <Box alignItems="Center" gap="300">
      {before && <Box shrink="No">{before}</Box>}
      <Box grow="Yes" direction="Column" gap="100">
        {title && (
          <Text id={titleId} className={BreakWord} size="T300">
            {title}
          </Text>
        )}
        {description && (
          <Text className={BreakWord} size="T200" priority="300">
            {description}
          </Text>
        )}
        {children}
      </Box>
      {after && (
        <Box shrink="No" ref={afterRef}>
          {after}
        </Box>
      )}
    </Box>
  );
}