03Auto-flip via anchor positioning

<main class="stage">
  <button class="trigger" type="button" aria-describedby="tip03">Menu</button>
  <span class="tooltip is-demo" role="tooltip" id="tip03">Saves up to 5 recent items</span>
</main>

@use "../../../../site/static/demo-tokens" as *;

$duration: $dur-loop;                              // 숨김→표시→숨김 한 주기
$easing: $ease-out;
$color: $subject-cream;                            // 트리거 버튼 색 (주황 무대라 크림)

@include stage($stage-orange);
.stage { position: relative; }                     // 트리거·툴팁의 절대 위치 기준

// 트리거를 무대 위쪽에 둔다 — 기본 위치(위)에 자리가 없어야 뒤집힌다
.trigger {
  anchor-name: --tip03;                            // 앵커 이름 등록. 지원: Chrome 125+
  position: absolute;
  top: 22px;
  left: 50%;
  transform: translateX(-50%);
  border: 0;
  border-radius: $r-control;
  padding: 12px 22px;
  font-weight: 600;
  font-size: 15px;
  line-height: 1;
  font-family: inherit;
  color: $subject-orange-deep;               // AA: 크림 면 위 주황 글자 5.04:1
  background: $color;
  cursor: pointer;
}

.tooltip {
  position: absolute;                               // 폴백: 앵커 없이도 버튼 아래에 뜬다
  top: calc(22px + 100% + 10px);
  left: 50%;
  transform-origin: top center; // 규칙8: 버튼 쪽 윗변 축 — 흔들림의 회전 중심
  transform: translateX(-50%) translateY(-4px);
  opacity: 0;
  background: $stage-ink;
  color: $subject-cream;
  padding: 8px 14px;
  border-radius: $r-control;
  font-size: clamp(12px, 3.4vw, 14px);
  white-space: nowrap;
  pointer-events: none;
}

// 앵커 위치 지정 지원 브라우저: 버튼을 기준으로 아래에 붙이되, 위에 자리가 없으면 자동으로 아래로 뒤집는다
// https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_anchor_positioning
@supports (position-anchor: --tip03) {
  .tooltip {
    position: fixed;
    position-anchor: --tip03;
    top: auto;
    inset: unset;
    position-area: top;                             // 기본은 버튼 위
    position-try-fallbacks: flip-block;              // 위에 자리가 없으면 아래로 뒤집힘
    margin-block: 10px;
    transform: translateY(0);
  }
  .tooltip.is-demo { animation-name: tip-loop-anchor; }
}

.tooltip.is-demo {
  animation: tip-loop $duration $easing infinite;
}

// 등장 스프링 한 겹(폴백 축) — 스케일 .85 → 1.1 오버슛 → 감쇠 반동, 회전은 윗변 축으로 2.2° → -1.3° → .5° 감쇠
@keyframes tip-loop {
  0%       { opacity: 0; transform: translateX(-50%) translateY(-4px) scale(.85) rotate(0deg); }
  12%      { opacity: 1; transform: translateX(-50%) translateY(0) scale(1.1) rotate(2.2deg); }
  22%      { opacity: 1; transform: translateX(-50%) translateY(0) scale(.95) rotate(-1.3deg); }
  30%      { opacity: 1; transform: translateX(-50%) translateY(0) scale(1.02) rotate(.5deg); }
  36%, 55% { opacity: 1; transform: translateX(-50%) translateY(0) scale(1) rotate(0deg); }
  80%      { opacity: 0; transform: translateX(-50%) translateY(-4px) scale(.85) rotate(0deg); }
  100%     { opacity: 0; transform: translateX(-50%) translateY(-4px) scale(.85) rotate(0deg); }
}

// 등장 스프링 한 겹(앵커 축) — 같은 오버슛·감쇠를 앵커 배치 버튼에도 그대로
@keyframes tip-loop-anchor {
  0%       { opacity: 0; transform: scale(.85) rotate(0deg); }
  12%      { opacity: 1; transform: scale(1.1) rotate(2.2deg); }
  22%      { opacity: 1; transform: scale(.95) rotate(-1.3deg); }
  30%      { opacity: 1; transform: scale(1.02) rotate(.5deg); }
  36%, 55% { opacity: 1; transform: scale(1) rotate(0deg); }
  80%      { opacity: 0; transform: scale(.85) rotate(0deg); }
  100%     { opacity: 0; transform: scale(.85) rotate(0deg); }
}

@media (prefers-reduced-motion: reduce) {
  .tooltip.is-demo { animation: none; opacity: 1; transform: scale(1) rotate(0deg); }
}

html, body {
  margin: 0;
  overflow: hidden;
}

.stage {
  box-sizing: border-box;
  min-height: 100vh;
  display: grid;
  place-items: center;
  margin: 0;
  background: #ff4d1f;
  font-family: -apple-system, "Segoe UI", "Noto Sans KR", sans-serif;
  padding: clamp(8px, 4vw, 24px);
}

.stage {
  position: relative;
}

.trigger {
  anchor-name: --tip03;
  position: absolute;
  top: 22px;
  left: 50%;
  transform: translateX(-50%);
  border: 0;
  border-radius: 12px;
  padding: 12px 22px;
  font-weight: 600;
  font-size: 15px;
  line-height: 1;
  font-family: inherit;
  color: #c93000;
  background: #fff7e6;
  cursor: pointer;
}

.tooltip {
  position: absolute;
  top: calc(22px + 100% + 10px);
  left: 50%;
  transform-origin: top center;
  transform: translateX(-50%) translateY(-4px);
  opacity: 0;
  background: #17141a;
  color: #fff7e6;
  padding: 8px 14px;
  border-radius: 12px;
  font-size: clamp(12px, 3.4vw, 14px);
  white-space: nowrap;
  pointer-events: none;
}

@supports (position-anchor: --tip03) {
  .tooltip {
    position: fixed;
    position-anchor: --tip03;
    top: auto;
    inset: unset;
    position-area: top;
    position-try-fallbacks: flip-block;
    margin-block: 10px;
    transform: translateY(0);
  }
  .tooltip.is-demo {
    animation-name: tip-loop-anchor;
  }
}
.tooltip.is-demo {
  animation: tip-loop 2s ease-out infinite;
}

@keyframes tip-loop {
  0% {
    opacity: 0;
    transform: translateX(-50%) translateY(-4px) scale(0.85) rotate(0deg);
  }
  12% {
    opacity: 1;
    transform: translateX(-50%) translateY(0) scale(1.1) rotate(2.2deg);
  }
  22% {
    opacity: 1;
    transform: translateX(-50%) translateY(0) scale(0.95) rotate(-1.3deg);
  }
  30% {
    opacity: 1;
    transform: translateX(-50%) translateY(0) scale(1.02) rotate(0.5deg);
  }
  36%, 55% {
    opacity: 1;
    transform: translateX(-50%) translateY(0) scale(1) rotate(0deg);
  }
  80% {
    opacity: 0;
    transform: translateX(-50%) translateY(-4px) scale(0.85) rotate(0deg);
  }
  100% {
    opacity: 0;
    transform: translateX(-50%) translateY(-4px) scale(0.85) rotate(0deg);
  }
}
@keyframes tip-loop-anchor {
  0% {
    opacity: 0;
    transform: scale(0.85) rotate(0deg);
  }
  12% {
    opacity: 1;
    transform: scale(1.1) rotate(2.2deg);
  }
  22% {
    opacity: 1;
    transform: scale(0.95) rotate(-1.3deg);
  }
  30% {
    opacity: 1;
    transform: scale(1.02) rotate(0.5deg);
  }
  36%, 55% {
    opacity: 1;
    transform: scale(1) rotate(0deg);
  }
  80% {
    opacity: 0;
    transform: scale(0.85) rotate(0deg);
  }
  100% {
    opacity: 0;
    transform: scale(0.85) rotate(0deg);
  }
}
@media (prefers-reduced-motion: reduce) {
  .tooltip.is-demo {
    animation: none;
    opacity: 1;
    transform: scale(1) rotate(0deg);
  }
}

import { useState } from "react";
import type { CSSProperties, ReactNode } from "react";
import styles from "./AnchorFlipTooltip.module.scss";

export type AnchorFlipTooltipProps = {
  label: ReactNode;
  text: string;
  duration?: number;
  easing?: string;
  color?: string;
};

type Vars = CSSProperties & { "--duration"?: string; "--easing"?: string; "--color"?: string };

// anchor-name/position-anchor 는 Chrome 125+ 에서만 동작한다. 미지원 브라우저는
// .module.scss 의 기본 position:absolute 규칙이 버튼 아래에 그대로 띄운다.
export default function AnchorFlipTooltip({
  label,
  text,
  duration = 200,
  easing = "ease-out",
  color = "#fff7e6",
}: AnchorFlipTooltipProps) {
  const [open, setOpen] = useState(false);
  const vars: Vars = { "--duration": `${duration}ms`, "--easing": easing, "--color": color };

  return (
    <span className={styles.wrap} style={vars}>
      <button
        type="button"
        className={styles.trigger}
        aria-describedby="anchor-tooltip"
        onMouseEnter={() => setOpen(true)}
        onMouseLeave={() => setOpen(false)}
        onFocus={() => setOpen(true)}
        onBlur={() => setOpen(false)}
      >
        {label}
      </button>
      <span id="anchor-tooltip" role="tooltip" className={styles.tooltip} data-open={open}>
        {text}
      </span>
    </span>
  );
}