06メタボール融合 — 滑らかな和集合

<main class="stage">
<div class="mt is-demo" id="mtRoot">
  <p class="mt__hint">
    <svg class="mt__ico" viewBox="0 0 256 256" aria-hidden="true"><g fill="currentColor"><path d="M128 24a16 16 0 0 1 16 16v8a80.06 80.06 0 0 1 63.94 63.94h8a16 16 0 0 1 0 32h-8A80.06 80.06 0 0 1 144 207.94v8a16 16 0 0 1-32 0v-8A80.06 80.06 0 0 1 48.06 144h-8a16 16 0 0 1 0-32h8A80.06 80.06 0 0 1 112 48.06v-8A16 16 0 0 1 128 24m-16 57.35V96a16 16 0 0 0 32 0V81.35A48.09 48.09 0 0 0 81.35 112H96a16 16 0 0 0 0-32h14.65M174.65 144H160a16 16 0 0 0 0 32h14.65A48.09 48.09 0 0 0 144 174.65V160a16 16 0 0 0-32 0v14.65A48.09 48.09 0 0 0 81.35 144" opacity=".2"/><path d="M232 128a104 104 0 1 1-104-104a104 104 0 0 1 104 104m-32 0a8 8 0 0 0-8-8h-9.34A56.1 56.1 0 0 0 136 77.34V68a8 8 0 0 0-16 0v9.34A56.1 56.1 0 0 0 77.34 120H68a8 8 0 0 0 0 16h9.34A56.1 56.1 0 0 0 120 179.66V188a8 8 0 0 0 16 0v-8.34A56.1 56.1 0 0 0 178.66 136H192a8 8 0 0 0 8-8m-40 0a32 32 0 1 1-32-32a32 32 0 0 1 32 32m-16 0a16 16 0 1 0-16 16a16 16 0 0 0 16-16"/></g></svg>
    <span>2つの球が触れた瞬間、首が伸びて融合します — ポインターで視点が回ります</span>
  </p>
  <div class="mt__field" id="mtField" role="application" aria-label="メタボールのレイマーチング実験盤" tabindex="0">
    <canvas class="mt__cv" id="mtCv"></canvas>
  </div>
  <div class="mt__bar">
    <span class="mt__meta"><b class="mt__val" id="mtRes">56×35</b> レンダーターゲット・64ステップ</span>
    <span class="mt__meta mt__meta--dim">smin k=0.35・3球の和集合</span>
  </div>
</div>
</main>

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

// 메타볼 합체(06) — CSS 애니메이션·@keyframes 를 아예 두지 않는다 —
// 움직임은 전부 캔버스 rAF 루프가 만들므로 렌더러가 실시간 24장을 찍는다.
// 무대는 페이퍼 밝은 톤(파스텔 라인). 왼쪽 구는 캔디 핑크·오른쪽 구는 하늘색,
// 목 지점에서 두 색이 자연스럽게 섞인다. 그림자는 라일락 진한 톤.

$duration: $dur-loop;
$easing: $ease-spring;
$color: $subject-pink;

@include stage($stage-paper);

.mt {
  // 렌더러가 읽는 색 — JS 는 getComputedStyle 로 --rm-* 를 받아 쓴다
  --rm-blob-a: #{$subject-pink};                            // 왼쪽 구 — 캔디 핑크 파스텔
  --rm-blob-b: #{$subject-sky};                             // 오른쪽 구 — 하늘색 파스텔
  --rm-hilite: #{$subject-cream};                           // 하이라이트·하늘 밝은 끝 — 크림
  --rm-floor:  #{mix($subject-sky, $stage-paper, 46%)};     // 바닥 — 옅은 하늘색
  --rm-shade:  #{mix($subject-lilac, $subject-ink, 52%)};   // 그림자 — 라일락 진한 톤
  --rm-sky:    #{mix($subject-cream, $stage-paper, 62%)};   // 하늘 — 크림에 가까운 페이퍼
  --rm-sky2:   #{mix($subject-pink, $stage-paper, 40%)};    // 하늘 파동 — 옅은 핑크 (그라데이션이 흐른다)

  display: flex; flex-direction: column; gap: $sp-2;
  width: 100%; max-width: 424px;
}

.mt__hint {
  display: flex; align-items: center; gap: $sp-1; margin: 0;
  font-weight: 700; font-size: clamp(10px, 2.8vw, 12px); line-height: 1.35;
  color: $subject-ink;
}
.mt__ico { width: 16px; height: 16px; flex: 0 0 auto; color: $subject-ink; }

.mt__field {
  position: relative; height: 180px;
  border-radius: $r-card; overflow: hidden;
  background: $stage-paper;
  box-shadow: inset 0 0 0 1px rgba($subject-ink, .16);
  cursor: crosshair; touch-action: none;
}
.mt__field:focus-visible { outline: 2px solid $subject-blue; outline-offset: 2px; }

.mt__cv { display: block; width: 100%; height: 100%; image-rendering: auto; }

.mt__bar { display: flex; align-items: baseline; justify-content: space-between; gap: $sp-2; }
.mt__meta { font-size: 10px; font-weight: 500; color: rgba($subject-ink, .72); }
.mt__val { color: $subject-blue; font-weight: 700; }
.mt__meta--dim { font-size: 10px; }

@media (max-width: 340px) {
  .mt { gap: $sp-1; }
  .mt__field { height: 100px; }
  .mt__meta--dim { display: none; }
}

// reduce — rAF 를 돌리지 않고 한 장만 남는다. 커서 신호만 거둔다.
@media (prefers-reduced-motion: reduce) {
  .mt.is-still .mt__field { cursor: default !important; }
}

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

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

.mt {
  --rm-blob-a: #ff9ebb;
  --rm-blob-b: #6ec8ff;
  --rm-hilite: #fff7e6;
  --rm-floor: rgb(73.8431372549%, 90.0784313725%, 100%);
  --rm-shade: rgb(42.0549019608%, 36.3921568627%, 56.8941176471%);
  --rm-sky: rgb(100%, 98.0549019608%, 93.9215686275%);
  --rm-sky2: rgb(100%, 84.7843137255%, 89.3333333333%);
  display: flex;
  flex-direction: column;
  gap: 8px;
  width: 100%;
  max-width: 424px;
}

.mt__hint {
  display: flex;
  align-items: center;
  gap: 4px;
  margin: 0;
  font-weight: 700;
  font-size: clamp(10px, 2.8vw, 12px);
  line-height: 1.35;
  color: #17141a;
}

.mt__ico {
  width: 16px;
  height: 16px;
  flex: 0 0 auto;
  color: #17141a;
}

.mt__field {
  position: relative;
  height: 180px;
  border-radius: 16px;
  overflow: hidden;
  background: #ffffff;
  box-shadow: inset 0 0 0 1px rgba(23, 20, 26, 0.16);
  cursor: crosshair;
  touch-action: none;
}

.mt__field:focus-visible {
  outline: 2px solid #2f6df6;
  outline-offset: 2px;
}

.mt__cv {
  display: block;
  width: 100%;
  height: 100%;
  image-rendering: auto;
}

.mt__bar {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  gap: 8px;
}

.mt__meta {
  font-size: 10px;
  font-weight: 500;
  color: rgba(23, 20, 26, 0.72);
}

.mt__val {
  color: #2f6df6;
  font-weight: 700;
}

.mt__meta--dim {
  font-size: 10px;
}

@media (max-width: 340px) {
  .mt {
    gap: 4px;
  }
  .mt__field {
    height: 100px;
  }
  .mt__meta--dim {
    display: none;
  }
}
@media (prefers-reduced-motion: reduce) {
  .mt.is-still .mt__field {
    cursor: default !important;
  }
}

// 메타볼 합체(06) — smooth min(smin) 으로 구 셋을 하나의 매끈한 덩어리로 합친다.
// 다항식 smin 은 두 거리를 k 반경 안에서 이어 붙인다:
//   h = clamp(0.5 + 0.5(d1-d2)/k, 0, 1),  mix(d2, d1, h) - k·h(1-h)
// 중심이 시간에 따라 궤도를 돌아 가까워지는 순간 목이 늘어나는 "합체" 가 보인다.
// WebGL 없이 ImageData 픽셀 계산만으로 나온다.
(function () {
  // ── 변형 상수 블록 — 아래 값 하나만 바꿔 변형 3종을 만든다 ──
  var RT_W = 56;          // レンダーターゲット 폭(버퍼 픽셀). smin 장면은 가볍다
  var STEPS = 64;         // 최대 전진 스텝 수 — 변형 "스텝 수" 축(48 → 96)
  var HIT_EPS = 0.005;    // 표면 도달 판정 거리(월드 단위)
  var LOOP_MS = 2000;     // 미리보기 가상 포인터 주기
  var K = 0.35;           // smin 혼합 반경 — 변형 "목 두께" 축(0.15 · 0.35 · 0.6)
  var PERIOD = 3.2;       // 메타볼 궤도 주기(초) — 합체-분리 리듬
  // ────────────────────────────────────────────────────

  var root = document.getElementById('mtRoot');
  var field = document.getElementById('mtField');
  var cv = document.getElementById('mtCv');
  var ctx = cv.getContext('2d');
  var resOut = document.getElementById('mtRes');

  // 색은 CSS 커스텀 프로퍼티(--rm-*)에서 getComputedStyle 로 읽는다 — 파스텔 토큰이 scss 한 곳에
  var css = getComputedStyle(root);
  function tokRGB(name) {
    var s = css.getPropertyValue(name).trim();
    if (s.charAt(0) === '#') {
      var hx = s.length === 4
        ? s.charAt(1) + s.charAt(1) + s.charAt(2) + s.charAt(2) + s.charAt(3) + s.charAt(3)
        : s.slice(1);
      return [parseInt(hx.slice(0, 2), 16), parseInt(hx.slice(2, 4), 16), parseInt(hx.slice(4, 6), 16)];
    }
    var p = s.replace(/[^\d,.]/g, '').split(',');
    return [Number(p[0]) || 0, Number(p[1]) || 0, Number(p[2]) || 0];
  }
  var C_BLOB_A = tokRGB('--rm-blob-a');
  var C_BLOB_B = tokRGB('--rm-blob-b');
  var C_HILITE = tokRGB('--rm-hilite');
  var C_FLOOR  = tokRGB('--rm-floor');
  var C_SHADE  = tokRGB('--rm-shade');
  var C_SKY    = tokRGB('--rm-sky');
  var C_SKY2   = tokRGB('--rm-sky2');

  var TAU = Math.PI * 2;
  var reduce = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
  var W = 0, H = 0;
  var buf, bctx, img;             // 저해상 レンダーターゲット 버퍼(캔버스와 별개)
  var heading = 0.55;             // 편요(라디안) — 포인터 좌우
  var pitch = 0.27;               // 상하각(라디안) — 포인터 상하
  var px01 = 0.5, py01 = 0.5;
  var manual = false;
  var raf = 0, t0 = -1;

  // 구 하나의 부호 거리 — p 에서 구 표면까지, 안이면 음수
  function sdSphere(px, py, pz, cx, cy, cz, rad) {
    var dx = px - cx, dy = py - cy, dz = pz - cz;
    return Math.sqrt(dx * dx + dy * dy + dz * dz) - rad;
  }

  // 다항식 smooth min — k 반경 안에서 두 거리를 이어 붙인다(목이 만들어진다)
  function smin(a, b, k) {
    var h = 0.5 + 0.5 * (b - a) / k;
    if (h < 0) h = 0; else if (h > 1) h = 1;
    return b + (a - b) * h - k * h * (1 - h);
  }

  // 이 프레임의 메타볼 중심 셋 — 시간에 따라 모였다 벌어진다
  var centers = [0, 0, 0, 0, 0, 0, 0, 0, 0];
  function updateBlobs(tSec) {
    var ph = tSec / PERIOD * TAU;
    var sway = 0.34 + 0.5 * Math.sin(ph);            // 0.34..0.84 — 가장 가까울 때 목이 잇는다
    var orbit = Math.sin(ph * 0.5);
    centers[0] = -sway;                              // A — 좌우로 모였다 벌어진다
    centers[1] = 1.0 + 0.42 * Math.sin(ph * 0.7 + 1.1);
    centers[2] = 0.1 * orbit;
    centers[3] = sway;                               // B — A 의 거울
    centers[4] = 1.0 - 0.4 * Math.sin(ph * 0.7 + 1.1);
    centers[5] = -0.1 * orbit;
    centers[6] = 0.15 * Math.sin(ph * 1.3 + 2.0);    // C — 작은 구가 위에서 맴돈다
    centers[7] = 1.95 + 0.3 * Math.sin(ph * 0.9);
    centers[8] = 0.42 + 0.3 * Math.sin(ph * 0.6);
  }

  var lastMix = 0.5;               // 직전 map 호출의 A/B 가중치 — 색 변조용
  // 장면 거리 = 구 셋의 smin 합집합(바닥 포함)
  function map(px, py, pz) {
    var dA = sdSphere(px, py, pz, centers[0], centers[1], centers[2], 0.72);
    var dB = sdSphere(px, py, pz, centers[3], centers[4], centers[5], 0.72);
    var dC = sdSphere(px, py, pz, centers[6], centers[7], centers[8], 0.42);
    lastMix = dA < dB ? 0 : 1;                       // 어떤 구 쪽 표면인지
    var dAB = smin(dA, dB, K);
    var dS = smin(dAB, dC, K * 0.8);                 // 작은 구는 더 가는 목으로 붙는다
    var dF = py;                                     // 바닥 평면 y=0
    return dS < dF ? dS : dF;
  }

  // 거리장의 기울기(전방 차분) = 표면 법선
  function normalAt(px, py, pz) {
    var e = 0.002;
    var nx = map(px + e, py, pz) - map(px - e, py, pz);
    var ny = map(px, py + e, pz) - map(px, py - e, pz);
    var nz = map(px, py, pz + e) - map(px, py, pz - e);
    var l = Math.sqrt(nx * nx + ny * ny + nz * nz) || 1;
    return [nx / l, ny / l, nz / l];
  }

  // 부드러운 그림자 — 바닥 점에서 광원 방향으로 다시 마칭한다. 광원은 draw 의 궤도와 같은 위상
  function softShadow(px, py, pz, lph) {
    var lx = -0.5 + 0.3 * Math.cos(lph), ly = 0.78, lz = 0.38 + 0.3 * Math.sin(lph);
    var ll = Math.sqrt(lx * lx + ly * ly + lz * lz);
    lx /= ll; ly /= ll; lz /= ll;
    var t = 0.02, res = 1.0;
    for (var i = 0; i < 24; i++) {
      var qx = px + lx * t, qy = py + ly * t, qz = pz + lz * t;
      var dA = sdSphere(qx, qy, qz, centers[0], centers[1], centers[2], 0.72);
      var dB = sdSphere(qx, qy, qz, centers[3], centers[4], centers[5], 0.72);
      var dC = sdSphere(qx, qy, qz, centers[6], centers[7], centers[8], 0.42);
      var d = Math.min(dA, Math.min(dB, dC));   // 그림자 레이는 smin 없이 최소만
      if (d < -0.001) return 0.0;
      res = Math.min(res, 10.0 * d / t);
      if (res < 0.005 || t > 7.0) break;
      t += Math.max(d, 0.02);
    }
    return res < 0 ? 0 : (res > 1 ? 1 : res);
  }

  function mix3(c1, c2, t) {
    return [c1[0] + (c2[0] - c1[0]) * t, c1[1] + (c2[1] - c1[1]) * t, c1[2] + (c2[2] - c1[2]) * t];
  }
  function clamp255(v) { return v > 255 ? 255 : (v < 0 ? 0 : v); }

  function draw(tSec) {
    if (!img) return;
    updateBlobs(tSec);
    var data = img.data;
    var bw = buf.width, bh = buf.height;

    // 카메라 — 장면 중심(0,1,0) 을 도는 궤도. heading/pitch 를 눈 위치로
    var ch = Math.cos(heading), sh = Math.sin(heading);
    var cp = Math.cos(pitch), sp = Math.sin(pitch);
    var D = 4.0;                                    // 눈-중심 거리
    var ex = sh * cp * D, ey = 1.0 + sp * D, ez = ch * cp * D;
    // 전방(눈→중심) · 오른쪽 · 위 — 오른손 기저
    var fx = -sh * cp, fy = -sp, fz = -ch * cp;
    var rx = -fz, rz = fx;                          // right = normalize(f × worldUp)
    var rl = Math.sqrt(rx * rx + rz * rz) || 1;
    rx /= rl; rz /= rl;
    var ux = -rz * fy, uy = rz * fx - rx * fz, uz = rx * fy;   // up = right × forward
    // 광원 궤도 — 왼쪽 위를 도는 파스텔 키 라이트. 목 하이라이트가 프레임마다 흐른다
    var lph = tSec * 0.9 + 2.1;
    var lx = -0.5 + 0.3 * Math.cos(lph), ly = 0.78, lz = 0.38 + 0.3 * Math.sin(lph);
    var ll = Math.sqrt(lx * lx + ly * ly + lz * lz);
    lx /= ll; ly /= ll; lz /= ll;

    var i = 0;
    for (var y = 0; y < bh; y++) {
      var vy = (1 - 2 * (y + 0.5) / bh) * 0.5;      // -0.5..+0.5 (화면 위가 +)
      for (var x = 0; x < bw; x++) {
        var vx = (2 * (x + 0.5) / bw - 1) * 0.8;    // -0.8..+0.8
        // 레이 방향 = 전방 + 화면 오프셋, 정규화
        var dx = fx + rx * vx + ux * vy;
        var dy = fy + uy * vy;
        var dz = fz + rz * vx + uz * vy;
        var dl = Math.sqrt(dx * dx + dy * dy + dz * dz);
        dx /= dl; dy /= dl; dz /= dl;

        // ── march 루프 — smin 거리도 정확한 SDF 니 그대로 전진한다 ──
        var t = 0.0, hit = 0, px = ex, py = ey, pz = ez;
        for (var s = 0; s < STEPS; s++) {
          var d = map(px, py, pz);
          if (d < HIT_EPS) { hit = 1; break; }      // 표면 도달
          if (t > 12.0) break;                      // 멀어지면 하늘로 놓아준다
          t += d;
          px = ex + dx * t; py = ey + dy * t; pz = ez + dz * t;
        }

        var r, g, b;
        if (hit) {
          var isFloor = py < 0.02;                  // 낮게 맞았으면 바닥
          var n = normalAt(px, py, pz);
          var lam = Math.max(0, n[0] * lx + n[1] * ly + n[2] * lz);
          if (isFloor) {
            // 바닥 — 그림자 레이로 두 덩어리의 부드러운 접시 음영
            var shd = softShadow(px, py, pz, lph);
            var lit = (0.4 + 0.6 * lam) * (0.25 + 0.75 * shd);
            r = C_FLOOR[0] * lit + C_SHADE[0] * (1 - lit);
            g = C_FLOOR[1] * lit + C_SHADE[1] * (1 - lit);
            b = C_FLOOR[2] * lit + C_SHADE[2] * (1 - lit);
          } else {
            // 메타볼 — 왼쪽 핑크·오른쪽 하늘색, 목 지점에서 자연스럽게 섞인다
            var base = mix3(C_BLOB_A, C_BLOB_B, lastMix);
            var dif = 0.26 + 0.74 * lam;
            var rim = Math.max(0, n[0] * -dx + n[1] * -dy + n[2] * -dz);
            var spec = Math.pow(rim, 16) * 0.45;
            r = base[0] * dif + C_HILITE[0] * spec;
            g = base[1] * dif + C_HILITE[1] * spec;
            b = base[2] * dif + C_HILITE[2] * spec;
          }
        } else {
          // 하늘 — 핑크↔크림 파동 그라데이션이 프레임마다 흐른다
          var sky = dy > 0 ? dy : 0;
          var wave = 0.5 + 0.5 * Math.sin(tSec * 1.4 + vx * 3.0);
          var gr = 0.35 * wave;
          r = C_SKY[0] + (C_HILITE[0] - C_SKY[0]) * sky * 0.3 + (C_SKY2[0] - C_SKY[0]) * gr;
          g = C_SKY[1] + (C_HILITE[1] - C_SKY[1]) * sky * 0.3 + (C_SKY2[1] - C_SKY[1]) * gr;
          b = C_SKY[2] + (C_HILITE[2] - C_SKY[2]) * sky * 0.3 + (C_SKY2[2] - C_SKY[2]) * gr;
        }
        data[i] = clamp255(r);
        data[i + 1] = clamp255(g);
        data[i + 2] = clamp255(b);
        data[i + 3] = 255;
        i += 4;
      }
    }
    bctx.putImageData(img, 0, 0);
    // 저해상 버퍼를 캔버스 CSS 크기로 부드럽게 확대 — dpr 을 곱하지 않는다(버퍼가 저해상)
    ctx.imageSmoothingEnabled = true;
    ctx.imageSmoothingQuality = 'high';
    ctx.clearRect(0, 0, W, H);
    ctx.drawImage(buf, 0, 0, W, H);
  }

  function fit() {
    var r = field.getBoundingClientRect();
    W = r.width; H = r.height;
    cv.width = Math.round(W); cv.height = Math.round(H);
    var bh = Math.max(12, Math.round(RT_W * H / W));
    buf = document.createElement('canvas');
    buf.width = RT_W; buf.height = bh;
    bctx = buf.getContext('2d');
    img = bctx.createImageData(RT_W, bh);
    resOut.textContent = RT_W + '×' + bh;
  }

  function aim() {
    // 포인터/키 입력 → 목표 각도. heading ±1.15 · pitch 0.1..0.5 — 목 순간이 번갈아 보인다
    return [(px01 - 0.5) * 2.3, 0.3 + (py01 - 0.5) * 0.4];
  }

  function frame(now) {
    if (t0 < 0) t0 = now;
    var t = (now - t0) / 1000;
    if (!manual) {
      // 미리보기 가상 포인터 — 시드 고정 Lissajous(표 밖 자연 경로). 진폭을 끝까지 쓴다
      var ph = ((now - t0) % LOOP_MS) / LOOP_MS * TAU;
      px01 = 0.5 + 0.48 * Math.sin(ph);
      py01 = 0.5 + 0.42 * Math.sin(2 * ph + 0.7);
    }
    var a = aim();
    heading += (a[0] - heading) * 0.14;
    pitch += (a[1] - pitch) * 0.14;
    draw(t);
    raf = requestAnimationFrame(frame);
  }

  field.addEventListener('pointermove', function (e) {
    var r = field.getBoundingClientRect();
    px01 = Math.min(1, Math.max(0, (e.clientX - r.left) / r.width));
    py01 = Math.min(1, Math.max(0, (e.clientY - r.top) / r.height));
    if (!manual) { manual = true; root.classList.remove('is-demo'); }
    if (reduce) { var a1 = aim(); heading = a1[0]; pitch = a1[1]; draw(1.6); }
  });
  field.addEventListener('pointerleave', function () {
    if (manual) { px01 = 0.5; py01 = 0.5; }
  });
  field.addEventListener('keydown', function (e) {
    var d = { ArrowLeft: [-0.07, 0], ArrowRight: [0.07, 0], ArrowUp: [0, -0.06], ArrowDown: [0, 0.06] }[e.key];
    if (!d) return;
    e.preventDefault();
    if (!manual) { manual = true; root.classList.remove('is-demo'); }
    px01 = Math.max(0, Math.min(1, px01 + d[0]));
    py01 = Math.max(0, Math.min(1, py01 + d[1]));
    if (reduce) { var a2 = aim(); heading = a2[0]; pitch = a2[1]; draw(1.6); }
  });
  window.addEventListener('resize', function () { fit(); if (reduce) draw(1.6); });

  fit();
  if (reduce) {
    // reduce — rAF 를 돌리지 않고 목이 잇는 순간의 한 장만 그린다
    heading = 0.55; pitch = 0.3;
    draw(1.6);
    root.classList.add('is-still');
  } else {
    raf = requestAnimationFrame(frame);
  }
})();

// BlendMetaballMerge — vanilla 판(run/312/demo/06-rm-blend-metaball-merge/index.html) 의 React 포트.
// smooth min(smin, 다항식 k) 으로 구 셋을 하나의 매끈한 덩어리로 합친다.
// 중심이 시간에 따라 궤도를 돌아 가까워지는 순간 목이 늘어나는 "합체" 가 보인다.
// WebGL 없이 ImageData 픽셀 계산만으로 3D 가 나온다. 미리보기는 시드 고정 Lissajous 자동 재생.
import { useEffect, useRef, useState } from "react";
import type { CSSProperties } from "react";
import styles from "./BlendMetaballMerge.module.scss";

export type BlendMetaballMergeProps = {
  duration?: string;
  easing?: string;
  color?: string;
  renderWidth?: number;   // 렌더 타깃 폭(버퍼 픽셀) — 변형 "해상도" 축
  steps?: number;         // 최대 전진 스텝 수 — 변형 "스텝 수" 축
  neck?: number;          // smin 혼합 반경 — 변형 "목 두께" 축(0.15 · 0.35 · 0.6)
};

type Vars = CSSProperties & { "--duration"?: string; "--easing"?: string; "--color"?: string };
// useRef 는 T | null 을 돌려준다. 처음부터 값이 있고 절대 비지 않는 상자는 이렇게 좁혀 쓴다
type Box<T> = { current: T };
// React 의 이벤트 제네릭이 없는 환경이라 필요한 것만 로컬로 선언한다
type PointerEvt = { clientX: number; clientY: number };
type KeyEvt = { key: string; preventDefault(): void };
type RGB = [number, number, number];
type Size = { w: number; h: number };

const TAU = Math.PI * 2;
const FIELD_LABEL = "메타볼 레이 마칭 실험판";
const STILL_T = 1.6;     // reduce 에서 그리는 시각 — 목이 잇는 순간의 한 장
const PERIOD = 3.2;      // 메타볼 궤도 주기(초) — 합체-분리 리듬
let gK = 0.35;           // smin 혼합 반경 — props 로 교체된다

// 구 하나의 부호 거리 — p 에서 구 표면까지, 안이면 음수
function sdSphere(px: number, py: number, pz: number, cx: number, cy: number, cz: number, rad: number): number {
  const dx = px - cx, dy = py - cy, dz = pz - cz;
  return Math.sqrt(dx * dx + dy * dy + dz * dz) - rad;
}

// 다항식 smooth min — k 반경 안에서 두 거리를 이어 붙인다(목이 만들어진다)
function smin(a: number, b: number, k: number): number {
  let h = 0.5 + 0.5 * (b - a) / k;
  if (h < 0) h = 0; else if (h > 1) h = 1;
  return b + (a - b) * h - k * h * (1 - h);
}

// 이 프레임의 메타볼 중심 셋 — 시간에 따라 모였다 벌어진다
const centers = [0, 0, 0, 0, 0, 0, 0, 0, 0];
function updateBlobs(tSec: number): void {
  const ph = tSec / PERIOD * TAU;
  const sway = 0.34 + 0.5 * Math.sin(ph);            // 0.34..0.84 — 가장 가까울 때 목이 잇는다
  const orbit = Math.sin(ph * 0.5);
  centers[0] = -sway;                                // A — 좌우로 모였다 벌어진다
  centers[1] = 1.0 + 0.42 * Math.sin(ph * 0.7 + 1.1);
  centers[2] = 0.1 * orbit;
  centers[3] = sway;                                 // B — A 의 거울
  centers[4] = 1.0 - 0.4 * Math.sin(ph * 0.7 + 1.1);
  centers[5] = -0.1 * orbit;
  centers[6] = 0.15 * Math.sin(ph * 1.3 + 2.0);      // C — 작은 구가 위에서 맴돈다
  centers[7] = 1.95 + 0.3 * Math.sin(ph * 0.9);
  centers[8] = 0.42 + 0.3 * Math.sin(ph * 0.6);
}

let lastMix = 0.5;        // 직전 map 호출의 A/B 가중치 — 색 변조용
// 장면 거리 = 구 셋의 smin 합집합(바닥 포함)
function map(px: number, py: number, pz: number): number {
  const dA = sdSphere(px, py, pz, centers[0], centers[1], centers[2], 0.72);
  const dB = sdSphere(px, py, pz, centers[3], centers[4], centers[5], 0.72);
  const dC = sdSphere(px, py, pz, centers[6], centers[7], centers[8], 0.42);
  lastMix = dA < dB ? 0 : 1;                         // 어떤 구 쪽 표면인지
  const dAB = smin(dA, dB, gK);
  const dS = smin(dAB, dC, gK * 0.8);                // 작은 구는 더 가는 목으로 붙는다
  const dF = py;                                     // 바닥 평면 y=0
  return dS < dF ? dS : dF;
}

// 거리장의 기울기(전방 차분) = 표면 법선
function normalAt(px: number, py: number, pz: number): RGB {
  const e = 0.002;
  const nx = map(px + e, py, pz) - map(px - e, py, pz);
  const ny = map(px, py + e, pz) - map(px, py - e, pz);
  const nz = map(px, py, pz + e) - map(px, py, pz - e);
  const l = Math.sqrt(nx * nx + ny * ny + nz * nz) || 1;
  return [nx / l, ny / l, nz / l];
}

// 부드러운 그림자 — 바닥 점에서 광원 방향으로 다시 마칭한다. 광원은 draw 의 궤도와 같은 위상
function softShadow(px: number, py: number, pz: number, lph: number): number {
  let lx = -0.5 + 0.3 * Math.cos(lph), ly = 0.78, lz = 0.38 + 0.3 * Math.sin(lph);
  const ll = Math.sqrt(lx * lx + ly * ly + lz * lz);
  lx /= ll; ly /= ll; lz /= ll;
  let t = 0.02, res = 1.0;
  for (let i = 0; i < 24; i++) {
    const qx = px + lx * t, qy = py + ly * t, qz = pz + lz * t;
    const dA = sdSphere(qx, qy, qz, centers[0], centers[1], centers[2], 0.72);
    const dB = sdSphere(qx, qy, qz, centers[3], centers[4], centers[5], 0.72);
    const dC = sdSphere(qx, qy, qz, centers[6], centers[7], centers[8], 0.42);
    const d = Math.min(dA, Math.min(dB, dC));   // 그림자 레이는 smin 없이 최소만
    if (d < -0.001) return 0.0;
    res = Math.min(res, 10.0 * d / t);
    if (res < 0.005 || t > 7.0) break;
    t += Math.max(d, 0.02);
  }
  return res < 0 ? 0 : (res > 1 ? 1 : res);
}

function clamp255(v: number): number { return v > 255 ? 255 : (v < 0 ? 0 : v); }

export default function BlendMetaballMerge({
  duration = "2s",
  easing = "cubic-bezier(.2, .8, .2, 1)",
  color = "#ff9ebb",
  renderWidth = 56,
  steps = 64,
  neck = 0.35,
}: BlendMetaballMergeProps) {
  const rootRef = useRef<HTMLDivElement | null>(null);
  const fieldRef = useRef<HTMLDivElement | null>(null);
  const cvRef = useRef<HTMLCanvasElement | null>(null);
  const ctxRef = useRef<CanvasRenderingContext2D | null>(null);
  const bufRef = useRef<HTMLCanvasElement | null>(null);
  const bctxRef = useRef<CanvasRenderingContext2D | null>(null);
  const imgRef = useRef<ImageData | null>(null);
  const sizeRef = useRef({ w: 0, h: 0 }) as Box<Size>;
  const colRef = useRef<{ blobA: RGB; blobB: RGB; hilite: RGB; floor: RGB; shade: RGB; sky: RGB; sky2: RGB } | null>(null);
  const rtRef = useRef(renderWidth) as Box<number>;     // 렌더 타깃 폭
  const stepRef = useRef(steps) as Box<number>;         // 최대 스텝 수
  const headingRef = useRef(0.55) as Box<number>;       // 편요(라디안)
  const pitchRef = useRef(0.27) as Box<number>;         // 상하각(라디안)
  const pxRef = useRef(0.5) as Box<number>;
  const pyRef = useRef(0.5) as Box<number>;
  const manualRef = useRef(false) as Box<boolean>;
  const rafRef = useRef(0) as Box<number>;
  const t0Ref = useRef(-1) as Box<number>;
  const [res, setRes] = useState("56×35");
  const [still, setStill] = useState(false);
  const vars: Vars = { "--duration": duration, "--easing": easing, "--color": color };

  function reduced(): boolean {
    return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
  }

  // 색은 CSS 커스텀 프로퍼티(--rm-*)에서 getComputedStyle 로 읽는다 — 파스텔 토큰이 scss 한 곳에
  function tokRGB(root: HTMLDivElement, name: string): RGB {
    const s = getComputedStyle(root).getPropertyValue(name).trim();
    if (s.charAt(0) === "#") {
      const hx = s.length === 4
        ? s.charAt(1) + s.charAt(1) + s.charAt(2) + s.charAt(2) + s.charAt(3) + s.charAt(3)
        : s.slice(1);
      return [parseInt(hx.slice(0, 2), 16), parseInt(hx.slice(2, 4), 16), parseInt(hx.slice(4, 6), 16)];
    }
    const p = s.replace(/[^\d,.]/g, "").split(",");
    return [Number(p[0]) || 0, Number(p[1]) || 0, Number(p[2]) || 0];
  }

  function fit(): void {
    const field = fieldRef.current;
    const cv = cvRef.current;
    if (!field || !cv) return;
    const ctx = cv.getContext("2d");
    if (!ctx) return;
    const size = sizeRef.current;
    const r = field.getBoundingClientRect();
    size.w = r.width; size.h = r.height;
    // 캔버스는 dpr 을 곱하지 않는다 — 버퍼가 저해상이라 확대가 곧 표시 해상도다
    cv.width = Math.round(size.w); cv.height = Math.round(size.h);
    ctxRef.current = ctx;
    const bh = Math.max(12, Math.round(rtRef.current * size.h / size.w));
    const buf = document.createElement("canvas");
    buf.width = rtRef.current; buf.height = bh;
    const bctx = buf.getContext("2d");
    if (!bctx) return;
    bufRef.current = buf; bctxRef.current = bctx;
    imgRef.current = bctx.createImageData(rtRef.current, bh);
    setRes(rtRef.current + "×" + bh);
  }

  function draw(tSec: number): void {
    const img = imgRef.current, bctx = bctxRef.current, buf = bufRef.current, ctx = ctxRef.current;
    const col = colRef.current;
    if (!img || !bctx || !buf || !ctx || !col) return;
    updateBlobs(tSec);
    const data = img.data;
    const size = sizeRef.current;
    const bw = buf.width, bh = buf.height;
    const STEPS = stepRef.current, HIT_EPS = 0.005;

    // 카메라 — 장면 중심(0,1,0) 을 도는 궤도. heading/pitch 를 눈 위치로
    const heading = headingRef.current, pitch = pitchRef.current;
    const ch = Math.cos(heading), sh = Math.sin(heading);
    const cp = Math.cos(pitch), sp = Math.sin(pitch);
    const D = 4.0;
    const ex = sh * cp * D, ey = 1.0 + sp * D, ez = ch * cp * D;
    // 전방(눈→중심) · 오른쪽 · 위 — 오른손 기저
    const fx = -sh * cp, fy = -sp, fz = -ch * cp;
    let rx = -fz, rz = fx;                          // right = f × worldUp 방향
    const rl = Math.sqrt(rx * rx + rz * rz) || 1;
    rx /= rl; rz /= rl;
    const ux = -rz * fy, uy = rz * fx - rx * fz, uz = rx * fy;   // up = right × forward
    // 광원 궤도 — 왼쪽 위를 도는 파스텔 키 라이트. 목 하이라이트가 프레임마다 흐른다
    const lph = tSec * 0.9 + 2.1;
    let lx = -0.5 + 0.3 * Math.cos(lph), ly = 0.78, lz = 0.38 + 0.3 * Math.sin(lph);
    const ll = Math.sqrt(lx * lx + ly * ly + lz * lz);
    lx /= ll; ly /= ll; lz /= ll;

    let i = 0;
    for (let y = 0; y < bh; y++) {
      const vy = (1 - 2 * (y + 0.5) / bh) * 0.5;      // -0.5..+0.5 (화면 위가 +)
      for (let x = 0; x < bw; x++) {
        const vx = (2 * (x + 0.5) / bw - 1) * 0.8;    // -0.8..+0.8
        // 레이 방향 = 전방 + 화면 오프셋, 정규화
        let dx = fx + rx * vx + ux * vy;
        let dy = fy + uy * vy;
        let dz = fz + rz * vx + uz * vy;
        const dl = Math.sqrt(dx * dx + dy * dy + dz * dz);
        dx /= dl; dy /= dl; dz /= dl;

        // ── march 루프 — smin 거리도 정확한 SDF 니 그대로 전진한다 ──
        let t = 0.0, hit = 0, px = ex, py = ey, pz = ez;
        for (let s = 0; s < STEPS; s++) {
          const d = map(px, py, pz);
          if (d < HIT_EPS) { hit = 1; break; }        // 표면 도달
          if (t > 12.0) break;                        // 멀어지면 하늘로 놓아준다
          t += d;
          px = ex + dx * t; py = ey + dy * t; pz = ez + dz * t;
        }

        let r: number, g: number, b: number;
        if (hit) {
          const isFloor = py < 0.02;                  // 낮게 맞았으면 바닥
          const n = normalAt(px, py, pz);
          const lam = Math.max(0, n[0] * lx + n[1] * ly + n[2] * lz);
          if (isFloor) {
            // 바닥 — 그림자 레이로 두 덩어리의 부드러운 접시 음영
            const shd = softShadow(px, py, pz, lph);
            const lit = (0.4 + 0.6 * lam) * (0.25 + 0.75 * shd);
            r = col.floor[0] * lit + col.shade[0] * (1 - lit);
            g = col.floor[1] * lit + col.shade[1] * (1 - lit);
            b = col.floor[2] * lit + col.shade[2] * (1 - lit);
          } else {
            // 메타볼 — 왼쪽 핑크·오른쪽 하늘색, 목 지점에서 자연스럽게 섞인다
            const base0 = col.blobA[0] + (col.blobB[0] - col.blobA[0]) * lastMix;
            const base1 = col.blobA[1] + (col.blobB[1] - col.blobA[1]) * lastMix;
            const base2 = col.blobA[2] + (col.blobB[2] - col.blobA[2]) * lastMix;
            const dif = 0.26 + 0.74 * lam;
            const rim = Math.max(0, n[0] * -dx + n[1] * -dy + n[2] * -dz);
            const spec = Math.pow(rim, 16) * 0.45;
            r = base0 * dif + col.hilite[0] * spec;
            g = base1 * dif + col.hilite[1] * spec;
            b = base2 * dif + col.hilite[2] * spec;
          }
        } else {
          // 하늘 — 핑크↔크림 파동 그라데이션이 프레임마다 흐른다
          const sky = dy > 0 ? dy : 0;
          const wave = 0.5 + 0.5 * Math.sin(tSec * 1.4 + vx * 3.0);
          const gr = 0.35 * wave;
          r = col.sky[0] + (col.hilite[0] - col.sky[0]) * sky * 0.3 + (col.sky2[0] - col.sky[0]) * gr;
          g = col.sky[1] + (col.hilite[1] - col.sky[1]) * sky * 0.3 + (col.sky2[1] - col.sky[1]) * gr;
          b = col.sky[2] + (col.hilite[2] - col.sky[2]) * sky * 0.3 + (col.sky2[2] - col.sky[2]) * gr;
        }
        data[i] = clamp255(r);
        data[i + 1] = clamp255(g);
        data[i + 2] = clamp255(b);
        data[i + 3] = 255;
        i += 4;
      }
    }
    bctx.putImageData(img, 0, 0);
    // 저해상 버퍼를 캔버스 CSS 크기로 부드럽게 확대
    ctx.imageSmoothingEnabled = true;
    ctx.imageSmoothingQuality = "high";
    ctx.clearRect(0, 0, size.w, size.h);
    ctx.drawImage(buf, 0, 0, size.w, size.h);
  }

  function aim(): [number, number] {
    return [(pxRef.current - 0.5) * 2.3, 0.3 + (pyRef.current - 0.5) * 0.4];
  }

  function frame(now: number): void {
    if (t0Ref.current < 0) t0Ref.current = now;
    const t = (now - t0Ref.current) / 1000;
    if (!manualRef.current) {
      // 미리보기 가상 포인터 — 시드 고정 Lissajous(표 밖 자연 경로). 진폭을 끝까지 쓴다
      const ph = (((now - t0Ref.current) % 2000) / 2000) * TAU;
      pxRef.current = 0.5 + 0.48 * Math.sin(ph);
      pyRef.current = 0.5 + 0.42 * Math.sin(2 * ph + 0.7);
    }
    const a = aim();
    headingRef.current += (a[0] - headingRef.current) * 0.14;
    pitchRef.current += (a[1] - pitchRef.current) * 0.14;
    draw(t);
    rafRef.current = requestAnimationFrame(frame);
  }

  function onPoint(e: PointerEvt): void {
    const field = fieldRef.current;
    if (!field) return;
    const r = field.getBoundingClientRect();
    pxRef.current = Math.min(1, Math.max(0, (e.clientX - r.left) / r.width));
    pyRef.current = Math.min(1, Math.max(0, (e.clientY - r.top) / r.height));
    if (!manualRef.current) manualRef.current = true;
    if (reduced()) {
      const a = aim();
      headingRef.current = a[0]; pitchRef.current = a[1];
      draw(STILL_T);
    }
  }

  function onLeave(): void {
    if (manualRef.current) { pxRef.current = 0.5; pyRef.current = 0.5; }
  }

  function onKeyDown(e: KeyEvt): void {
    const deltas: Record<string, [number, number]> = {
      ArrowLeft: [-0.07, 0], ArrowRight: [0.07, 0], ArrowUp: [0, -0.06], ArrowDown: [0, 0.06],
    };
    const d = deltas[e.key];
    if (!d) return;
    e.preventDefault();
    if (!manualRef.current) manualRef.current = true;
    pxRef.current = Math.max(0, Math.min(1, pxRef.current + d[0]));
    pyRef.current = Math.max(0, Math.min(1, pyRef.current + d[1]));
    if (reduced()) {
      const a = aim();
      headingRef.current = a[0]; pitchRef.current = a[1];
      draw(STILL_T);
    }
  }

  useEffect(() => {
    const root = rootRef.current;
    if (!root) return;
    rtRef.current = renderWidth;
    stepRef.current = steps;
    gK = neck;
    colRef.current = {
      blobA: tokRGB(root, "--rm-blob-a"),
      blobB: tokRGB(root, "--rm-blob-b"),
      hilite: tokRGB(root, "--rm-hilite"),
      floor: tokRGB(root, "--rm-floor"),
      shade: tokRGB(root, "--rm-shade"),
      sky: tokRGB(root, "--rm-sky"),
      sky2: tokRGB(root, "--rm-sky2"),
    };
    fit();
    function onResize(): void {
      fit();
      if (reduced()) draw(STILL_T);
    }
    window.addEventListener("resize", onResize);
    if (reduced()) {
      // reduce — rAF 를 돌리지 않고 목이 잇는 순간의 한 장만 그린다
      headingRef.current = 0.55; pitchRef.current = 0.3;
      draw(STILL_T);
      setStill(true);
    } else {
      rafRef.current = requestAnimationFrame(frame);
    }
    return () => {
      window.removeEventListener("resize", onResize);
      cancelAnimationFrame(rafRef.current);
    };
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [renderWidth, steps, neck]);

  const rootCls = still ? `${styles.root} ${styles.isStill}` : styles.root;

  return (
    <main className={styles.stage}>
      <div className={rootCls} ref={rootRef} style={vars}>
        <p className={styles.hint}>
          <svg className={styles.ico} viewBox="0 0 256 256" aria-hidden="true"><g fill="currentColor"><path d="M128 24a16 16 0 0 1 16 16v8a80.06 80.06 0 0 1 63.94 63.94h8a16 16 0 0 1 0 32h-8A80.06 80.06 0 0 1 144 207.94v8a16 16 0 0 1-32 0v-8A80.06 80.06 0 0 1 48.06 144h-8a16 16 0 0 1 0-32h8A80.06 80.06 0 0 1 112 48.06v-8A16 16 0 0 1 128 24m-16 57.35V96a16 16 0 0 0 32 0V81.35A48.09 48.09 0 0 0 81.35 112H96a16 16 0 0 0 0-32h14.65M174.65 144H160a16 16 0 0 0 0 32h14.65A48.09 48.09 0 0 0 144 174.65V160a16 16 0 0 0-32 0v14.65A48.09 48.09 0 0 0 81.35 144" opacity=".2"/><path d="M232 128a104 104 0 1 1-104-104a104 104 0 0 1 104 104m-32 0a8 8 0 0 0-8-8h-9.34A56.1 56.1 0 0 0 136 77.34V68a8 8 0 0 0-16 0v9.34A56.1 56.1 0 0 0 77.34 120H68a8 8 0 0 0 0 16h9.34A56.1 56.1 0 0 0 120 179.66V188a8 8 0 0 0 16 0v-8.34A56.1 56.1 0 0 0 178.66 136H192a8 8 0 0 0 8-8m-40 0a32 32 0 1 1-32-32a32 32 0 0 1 32 32m-16 0a16 16 0 1 0-16 16a16 16 0 0 0 16-16"/></g></svg>
          <span>두 구가 닿는 순간 목이 늘어나며 합쳐집니다 — 포인터로 시점이 돕니다</span>
        </p>
        <div
          className={styles.field}
          ref={fieldRef}
          role="application"
          aria-label={FIELD_LABEL}
          tabIndex={0}
          onPointerMove={onPoint}
          onPointerLeave={onLeave}
          onKeyDown={onKeyDown}
        >
          <canvas className={styles.cv} ref={cvRef}></canvas>
        </div>
        <div className={styles.bar}>
          <span className={styles.meta}><b className={styles.val}>{res}</b> 렌더 타깃 · 스텝 {steps}</span>
          <span className={styles.metaDim}>smin k={neck} · 구 셋 합집합</span>
        </div>
      </div>
    </main>
  );
}