03미로 — 줄이 꺾여 길을 내는 중간 지점

<main class="stage">
<div class="tml" id="tml">
  <p class="tml__hint">
    <svg class="tml__ico" viewBox="0 0 256 256" aria-hidden="true"><g fill="currentColor"><path d="M144 48h32v32h-32zm40 40h32v32h-32zm-40 40h32v32h-32zm-40 40h32v32h-32z" opacity=".2"/><path d="M228 92h-44V48a12 12 0 0 0-12-12H48a12 12 0 0 0-12 12v56a12 12 0 0 0 12 12h44v44a12 12 0 0 0 12 12h44v44a12 12 0 0 0 12 12h68a12 12 0 0 0 12-12v-56a12 12 0 0 0-12-12h-44v-44a12 12 0 0 0-12-12m-12 24h44v32h-44zm-56 56h44v32h-44zm-56 56h44v32H60zm124 32h-44v-32h44zM60 92V60h44v32zm44 24H60v-16h44z"/></g></svg>
    <span>점과 줄 사이의 중간 지점 — 줄이 꺾여 길을 냅니다. F 를 움직이면 미로가 다시 짜입니다</span>
  </p>
  <div class="tml__field" id="field">
    <canvas class="tml__cv" id="cv"></canvas>
  </div>
  <div class="tml__bar">
    <label class="tml__dial">시드
      <input type="number" id="seed" min="1" max="9999" step="1" value="7" aria-label="패턴 시드">
    </label>
    <label class="tml__dial tml__grow">사료율 F
      <input type="range" id="fk" min="0.010" max="0.070" step="0.001" value="0.037" aria-label="사료율 F">
    </label>
  </div>
</div>
</main>

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

// 미로 — Gray-Scott 반응-확산. 점과 줄 사이 파라미터 구간에서 줄이
// 꺾이고 갈라져 미로 같은 무늬가 되는 축 (03).
// 파스텔 — mix() 로 옅게 섞은 로컬 변수만 쓴다. 리터럴 hex 0개(BD26).
$tml-field:  mix($subject-pink,  $stage-paper, 26%);   // 밭 바탕 — 옅은 핑크끼
$tml-wall:   mix($subject-mint,  $stage-paper, 46%);   // 통로 테두리 옅은 단
$tml-maze:   mix($subject-sky,   $stage-paper, 42%);   // 미로 벽 본체 — 파스텔 스카이
$tml-inkend: mix($subject-sky,   $subject-ink, 34%);   // 가장 진한 끝단

$duration: $dur-loop;
$easing: $ease-out;
$color: $tml-maze;

@include stage($stage-paper);

.tml {
  // V 농도 → 색 5단계 LUT (JS 가 getComputedStyle 로 읽는다)
  --tml-c0: #{$stage-paper};
  --tml-c1: #{$tml-field};
  --tml-c2: #{$tml-wall};
  --tml-c3: #{$tml-maze};
  --tml-c4: #{$tml-inkend};

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

.tml__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;
}
.tml__ico { width: 16px; height: 16px; flex: 0 0 auto; color: $subject-ink; }

.tml__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);
}

.tml__cv { display: block; width: 100%; height: 100%; }

.tml__bar { display: flex; align-items: center; gap: $sp-3; flex-wrap: wrap; }
.tml__dial {
  display: flex; align-items: center; gap: $sp-2;
  font-weight: 700; font-size: 11px; color: $subject-ink;
}
.tml__grow { flex: 1 1 auto; min-width: 120px; }
.tml__grow input { flex: 1 1 auto; }
.tml__dial input {
  width: 72px; margin: 0;
  padding: $sp-1 $sp-2; border: 0; border-radius: $r-sm;
  background: rgba($subject-ink, .08); color: $subject-ink;
  font-weight: 700; font-size: 12px; font-family: inherit;
}
.tml__dial input[type="range"] {
  width: auto; padding: 0; accent-color: $tml-maze;
}
.tml__dial input:focus-visible { outline: 2px solid $subject-blue; outline-offset: 2px; }

@media (max-width: 340px) {
  .tml { gap: $sp-1; }
  .tml__field { height: 100px; }
  .tml__dial input { width: 56px; }
  .tml__hint { font-size: 10px; }
}

// reduce — 루프 없이 성숙 상태 한 장만 남긴다
@media (prefers-reduced-motion: reduce) {
  .tml.is-still .tml__field { cursor: default; }
}

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);
}

.tml {
  --tml-c0: #ffffff;
  --tml-c1: rgb(100%, 90.1098039216%, 93.0666666667%);
  --tml-c2: rgb(67.7098039216%, 92.2431372549%, 83.9450980392%);
  --tml-c3: rgb(76.1176470588%, 90.9411764706%, 100%);
  --tml-c4: rgb(20.6196078431%, 31.8431372549%, 40.7294117647%);
  display: flex;
  flex-direction: column;
  gap: 8px;
  width: 100%;
  max-width: 424px;
}

.tml__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;
}

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

.tml__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);
}

.tml__cv {
  display: block;
  width: 100%;
  height: 100%;
}

.tml__bar {
  display: flex;
  align-items: center;
  gap: 12px;
  flex-wrap: wrap;
}

.tml__dial {
  display: flex;
  align-items: center;
  gap: 8px;
  font-weight: 700;
  font-size: 11px;
  color: #17141a;
}

.tml__grow {
  flex: 1 1 auto;
  min-width: 120px;
}

.tml__grow input {
  flex: 1 1 auto;
}

.tml__dial input {
  width: 72px;
  margin: 0;
  padding: 4px 8px;
  border: 0;
  border-radius: 8px;
  background: rgba(23, 20, 26, 0.08);
  color: #17141a;
  font-weight: 700;
  font-size: 12px;
  font-family: inherit;
}

.tml__dial input[type=range] {
  width: auto;
  padding: 0;
  accent-color: rgb(76.1176470588%, 90.9411764706%, 100%);
}

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

@media (max-width: 340px) {
  .tml {
    gap: 4px;
  }
  .tml__field {
    height: 100px;
  }
  .tml__dial input {
    width: 56px;
  }
  .tml__hint {
    font-size: 10px;
  }
}
@media (prefers-reduced-motion: reduce) {
  .tml.is-still .tml__field {
    cursor: default;
  }
}

// 미로 — Gray-Scott 반응-확산. 점(높은 F)과 줄(낮은 F) 사이 구간에서는
// 줄이 마구 꺾이고 갈라져 미로 같은 통로 무늬가 된다. 격자가 낮은 해상도라
// 곡선에 계단이 살짝 보이는 것도 이 계열의 특징이다.
// 매 프레임 8스텝씩 라플라스 확산 + 반응항을 계산해 ImageData 로 화소를 박고
// 저해상 버퍼를 putImageData 로 그린 뒤 drawImage 로 확대한다.
var root = document.getElementById('tml');
var field = document.getElementById('field');
var cv = document.getElementById('cv');
var ctx = cv.getContext('2d');
var seedIn = document.getElementById('seed');
var fkIn = document.getElementById('fk');

// 결정적 난수 — mulberry32. 같은 시드면 같은 수열을 돌려준다
function mulberry32(a) {
  return function () {
    a |= 0; a = (a + 0x6D2B79F5) | 0;
    var t = Math.imul(a ^ (a >>> 15), 1 | a);
    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
  };
}

var GW = 64, GH = 40;            // 격자 셀 수 (480x300 비율)
var DU = 0.16, DV = 0.08;        // 확산 계수 (고정 — 5점 라플라스 dt=1 안정 스케일)
var F = 0.037, K = 0.060;        // 사료율·제거율 (fk 슬라이더가 F 를 움직인다)
var STEPS = 8;                   // 프레임당 시뮬레이션 스텝
var PRE = 900;                   // 시작 시 미리 성숙시키는 스텝 — 통로가 짜인 직후
var WOBBLE = 0.006;              // 성숙 뒤에도 계속 주는 미세 U 주입량 — 미로가 살아 흐른다
var u = new Float32Array(GW * GH);
var v = new Float32Array(GW * GH);
var u2 = new Float32Array(GW * GH);
var v2 = new Float32Array(GW * GH);

var reduce = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
var W = 0, H = 0, dpr = 1;
var raf = 0, phase = 0;

// ── 색 — scss 가 내려준 파스텔 사용자속성을 읽어 5단계 LUT 를 미리 편다 ──
var css = getComputedStyle(root);
var LUT = new Uint8Array(256 * 3);
function hex6(s) {
  s = String(s).trim().replace('#', '');
  if (s.length === 3) s = s.charAt(0) + s.charAt(0) + s.charAt(1) + s.charAt(1) + s.charAt(2) + s.charAt(2);
  return [parseInt(s.slice(0, 2), 16) || 0, parseInt(s.slice(2, 4), 16) || 0, parseInt(s.slice(4, 6), 16) || 0];
}
function buildLut() {
  var stops = [hex6(tok('--tml-c0')), hex6(tok('--tml-c1')), hex6(tok('--tml-c2')), hex6(tok('--tml-c3')), hex6(tok('--tml-c4'))];
  for (var q = 0; q < 256; q++) {
    var t = q / 255 * (stops.length - 1);
    var k = Math.min(stops.length - 2, Math.floor(t));
    var f = t - k;
    for (var c = 0; c < 3; c++) LUT[q * 3 + c] = stops[k][c] + (stops[k + 1][c] - stops[k][c]) * f;
  }
}
function tok(name) { return css.getPropertyValue(name); }

// ── 시드 — 작은 V 조각 20개를 널브러뜨린다. 자라 만나며 통로가 생긴다 ──
function seedField(sd) {
  var rng = mulberry32(sd >>> 0);
  u.fill(1); v.fill(0);
  var n = 20;
  for (var s = 0; s < n; s++) {
    var cx = 2 + Math.floor(rng() * (GW - 6));
    var cy = 1 + Math.floor(rng() * (GH - 4));
    var w = 1 + Math.floor(rng() * 4);
    var h = 1 + Math.floor(rng() * 3);
    for (var y = cy; y < Math.min(GH, cy + h); y++) {
      for (var x = cx; x < Math.min(GW, cx + w); x++) {
        v[y * GW + x] = 0.5; u[y * GW + x] = 0.25;
      }
    }
  }
}

// ── 한 스텝 — 5점 라플라스(토러스 경계) + Gray-Scott 반응항 ──
function step() {
  for (var y = 0; y < GH; y++) {
    var yT = ((y - 1 + GH) % GH) * GW, yB = ((y + 1) % GH) * GW, yC = y * GW;
    for (var x = 0; x < GW; x++) {
      var xL = (x - 1 + GW) % GW, xR = (x + 1) % GW;
      var i = yC + x;
      var uc = u[i], vc = v[i];
      var lapU = u[yC + xL] + u[yC + xR] + u[yT + x] + u[yB + x] - 4 * uc;
      var lapV = v[yC + xL] + v[yC + xR] + v[yT + x] + v[yB + x] - 4 * vc;
      var uvv = uc * vc * vc;
      var nu = uc + DU * lapU - uvv + F * (1 - uc);
      var nv = vc + DV * lapV + uvv - (F + K) * vc;
      u2[i] = nu < 0 ? 0 : (nu > 1 ? 1 : nu);
      v2[i] = nv < 0 ? 0 : (nv > 1 ? 1 : nv);
    }
  }
  var tu = u; u = u2; u2 = tu;
  var tv = v; v = v2; v2 = tv;
}

var buf = null, small = null, sctx = null;
function setupBuffers() {
  small = document.createElement('canvas');
  small.width = GW; small.height = GH;
  sctx = small.getContext('2d');
  buf = sctx.createImageData(GW, GH);
}

function paint() {
  var px = buf.data, i4 = 0;
  for (var p = 0; p < GW * GH; p++) {
    // V 농도 0(종이) → 1(잉크끼 파스텔) — LUT 로 색 단계
    var q = Math.max(0, Math.min(255, (v[p] * 340) | 0));
    px[i4] = LUT[q * 3];
    px[i4 + 1] = LUT[q * 3 + 1];
    px[i4 + 2] = LUT[q * 3 + 2];
    px[i4 + 3] = 255;
    i4 += 4;
  }
  sctx.putImageData(buf, 0, 0);
  ctx.imageSmoothingEnabled = true;
  ctx.imageSmoothingQuality = 'high';
  ctx.drawImage(small, 0, 0, GW, GH, 0, 0, W, H);
}

// 미세 U 주입 — 사인 리본이 시간에 흐르며 아주 조금씩 U 를 채운다.
// 짜인 미로가 이 흔들림에 반응해 통로를 계속 다시 낸다(살아 있는 무늬).
function wobble(tt) {
  var ph = phase;
  for (var y = 0; y < GH; y++) {
    for (var x = 0; x < GW; x++) {
      var wob = 0.5 + 0.5 * Math.sin(x * 0.18 + y * 0.12 + tt + ph);
      var i = y * GW + x;
      var nu = u[i] + wob * WOBBLE;
      u[i] = nu > 1 ? 1 : nu;
    }
  }
}

function frame() {
  for (var s = 0; s < STEPS; s++) { wobble(phase + s * 0.02); step(); }
  phase += STEPS * 0.02;
  paint();
  raf = requestAnimationFrame(frame);
}

function fit() {
  var r = field.getBoundingClientRect();
  dpr = window.devicePixelRatio || 1;
  W = r.width; H = r.height;
  cv.width = Math.round(W * dpr);
  cv.height = Math.round(H * dpr);
  ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
}

// 시드 재생성 → 미리성숙(PRE 스텝 동기) → 즉시 다시 그리기 (reduce 경로에서도)
function regrow(sd) {
  phase = sd * 0.7;
  seedField(sd);
  for (var s = 0; s < PRE; s++) step();
  paint();
}

function onSeed() {
  var val = Math.max(1, Math.min(9999, Math.floor(Number(seedIn.value)) || 1));
  regrow(val);
}
function onFk() {
  F = Number(fkIn.value);
  // reduce 경로에서도 프레임이 즉시 반응하게 — 새 F 로 짧게 진행해 다시 그린다
  if (reduce) { for (var s = 0; s < 60; s++) step(); paint(); }
}

seedIn.addEventListener('input', onSeed);
seedIn.addEventListener('change', onSeed);
fkIn.addEventListener('input', onFk);
fkIn.addEventListener('change', onFk);
window.addEventListener('resize', function () { fit(); paint(); });

buildLut();
setupBuffers();
fit();
regrow(Number(seedIn.value) || 7);
if (reduce) {
  // reduce — 루프를 돌지 않고 성숙 상태 한 장만 그린다
  root.classList.add('is-still');
} else {
  raf = requestAnimationFrame(frame);
}

// MazeLabyrinth — vanilla 판(run/311/demo/03-turing-maze-labyrinth/index.html) 의 React 포트.
// Gray-Scott 반응-확산을 64x40 격자에서 계산해 ImageData 로 화소를 박고
// imageSmoothingEnabled 를 켠 채 drawImage 로 늘려 화면을 채운다.
// 움직임은 캔버스 rAF 루프가 전부 그리므로 @keyframes 가 없다 — props 는 CSS 변수로 내려간다.
import { useEffect, useRef, useState } from "react";
import type { CSSProperties } from "react";
import styles from "./MazeLabyrinth.module.scss";

export type MazeLabyrinthProps = {
  duration?: string;
  easing?: string;
  color?: string;
};

type Vars = CSSProperties & { "--duration"?: string; "--easing"?: string; "--color"?: string };
type Box<T> = { current: T };
// React 이벤트 제네릭이 없는 환경이라 필요한 것만 로컬로 선언한다
type InputEvt = { target: { value: string } };

const GW = 64, GH = 40;         // 격자 셀 수 — 화면이 커져도 이 값은 그대로다
const DU = 0.16, DV = 0.08;     // 확산 계수 (5점 라플라스 dt=1 안정 스케일)
const K = 0.060;                // 제거율 (고정)
const STEPS = 8;                // 프레임당 시뮬레이션 스텝
const PRE = 900;                // 시작 시 미리 성숙시키는 스텝 — 통로가 짜인 직후
const WOBBLE = 0.006;           // 성숙 뒤에도 계속 주는 미세 U 주입량
const FIELD_LABEL = "미로 무늬 반응 실험판";

// 결정적 난수 — mulberry32. 같은 시드면 같은 수열을 돌려준다
function mulberry32(a: number): () => number {
  return function () {
    a |= 0; a = (a + 0x6d2b79f5) | 0;
    let t = Math.imul(a ^ (a >>> 15), 1 | a);
    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
  };
}

// 토큰 다섯 단계를 256칸 표로 편다 — 프레임마다 색을 다시 섞지 않게 하기 위해서다
function buildLut(stops: number[][]): Uint8Array {
  const lut = new Uint8Array(256 * 3);
  for (let q = 0; q < 256; q++) {
    const t = (q / 255) * (stops.length - 1);
    const k = Math.min(stops.length - 2, Math.floor(t));
    const f = t - k;
    for (let c = 0; c < 3; c++) lut[q * 3 + c] = stops[k][c] + (stops[k + 1][c] - stops[k][c]) * f;
  }
  return lut;
}

// Gray-Scott 상태 한 덩어리 — u·v 두 격자와 다음 프레임용 버퍼
type Grid = { u: Float32Array; v: Float32Array; u2: Float32Array; v2: Float32Array };

// 작은 V 조각 20개를 널브러뜨린 시드 — 자라 만나며 통로가 생긴다
function seedField(sd: number): Grid {
  const rng = mulberry32(sd >>> 0);
  const g: Grid = {
    u: new Float32Array(GW * GH).fill(1),
    v: new Float32Array(GW * GH),
    u2: new Float32Array(GW * GH),
    v2: new Float32Array(GW * GH),
  };
  for (let s = 0; s < 20; s++) {
    const cx = 2 + Math.floor(rng() * (GW - 6));
    const cy = 1 + Math.floor(rng() * (GH - 4));
    const w = 1 + Math.floor(rng() * 4);
    const h = 1 + Math.floor(rng() * 3);
    for (let y = cy; y < Math.min(GH, cy + h); y++) {
      for (let x = cx; x < Math.min(GW, cx + w); x++) {
        g.v[y * GW + x] = 0.5; g.u[y * GW + x] = 0.25;
      }
    }
  }
  return g;
}

export default function MazeLabyrinth({
  duration = "2s",                            // vanilla $duration: $dur-loop
  easing = "ease-out",                        // vanilla $easing: $ease-out
  color = "#a5d4f0",                          // vanilla $color: $tml-maze
}: MazeLabyrinthProps) {
  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 smallRef = useRef<HTMLCanvasElement | null>(null);
  const sctxRef = useRef<CanvasRenderingContext2D | null>(null);
  const bufRef = useRef<ImageData | null>(null);
  const lutRef = useRef<Uint8Array | null>(null);
  const gridRef = useRef<Grid | null>(null);
  const sizeRef = useRef({ w: 0, h: 0 }) as Box<{ w: number; h: number }>;
  const fkRef = useRef(0.037) as Box<number>;
  const phaseRef = useRef(0) as Box<number>;
  const rafRef = useRef(0) as Box<number>;
  const [seed, setSeed] = useState(7);
  const [fk, setFk] = useState(0.037);
  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;
  }

  function hex3to6(v: string): string {
    if (v.length === 3) return v.charAt(0) + v.charAt(0) + v.charAt(1) + v.charAt(1) + v.charAt(2) + v.charAt(2);
    return v;
  }

  function stops(): number[][] {
    const root = rootRef.current;
    if (!root) return [[0, 0, 0], [255, 255, 255]];
    const one = (n: string) => {
      const v = hex3to6(getComputedStyle(root).getPropertyValue(n).trim().replace("#", ""));
      return [parseInt(v.slice(0, 2), 16), parseInt(v.slice(2, 4), 16), parseInt(v.slice(4, 6), 16)];
    };
    return [one("--tml-c0"), one("--tml-c1"), one("--tml-c2"), one("--tml-c3"), one("--tml-c4")];
  }

  // 고DPI 대응 — 배킹 스토어는 devicePixelRatio 배, 그리기 좌표계는 CSS 픽셀 그대로
  function fit(): void {
    const field = fieldRef.current;
    const cv = cvRef.current;
    if (!field || !cv) return;
    const r = field.getBoundingClientRect();
    const dpr = window.devicePixelRatio || 1;
    sizeRef.current.w = r.width;
    sizeRef.current.h = r.height;
    cv.width = Math.round(r.width * dpr);
    cv.height = Math.round(r.height * dpr);
    const ctx = ctxRef.current;
    if (ctx) ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
  }

  // 한 스텝 — 5점 라플라스(토러스 경계) + Gray-Scott 반응항
  function step(): void {
    const g = gridRef.current;
    if (!g) return;
    const F = fkRef.current;
    for (let y = 0; y < GH; y++) {
      const yT = ((y - 1 + GH) % GH) * GW, yB = ((y + 1) % GH) * GW, yC = y * GW;
      for (let x = 0; x < GW; x++) {
        const xL = (x - 1 + GW) % GW, xR = (x + 1) % GW;
        const i = yC + x;
        const uc = g.u[i], vc = g.v[i];
        const lapU = g.u[yC + xL] + g.u[yC + xR] + g.u[yT + x] + g.u[yB + x] - 4 * uc;
        const lapV = g.v[yC + xL] + g.v[yC + xR] + g.v[yT + x] + g.v[yB + x] - 4 * vc;
        const uvv = uc * vc * vc;
        const nu = uc + DU * lapU - uvv + F * (1 - uc);
        const nv = vc + DV * lapV + uvv - (F + K) * vc;
        g.u2[i] = nu < 0 ? 0 : nu > 1 ? 1 : nu;
        g.v2[i] = nv < 0 ? 0 : nv > 1 ? 1 : nv;
      }
    }
    const tu = g.u; g.u = g.u2; g.u2 = tu;
    const tv = g.v; g.v = g.v2; g.v2 = tv;
  }

  // 미세 U 주입 — 사인 리본이 시간에 흐르며 아주 조금씩 U 를 채운다
  function wobble(tt: number): void {
    const g = gridRef.current;
    if (!g) return;
    const ph = phaseRef.current;
    for (let y = 0; y < GH; y++) {
      for (let x = 0; x < GW; x++) {
        const wob = 0.5 + 0.5 * Math.sin(x * 0.18 + y * 0.12 + tt + ph);
        const i = y * GW + x;
        const nu = g.u[i] + wob * WOBBLE;
        g.u[i] = nu > 1 ? 1 : nu;
      }
    }
  }

  function paint(): void {
    const ctx = ctxRef.current, sctx = sctxRef.current, g = gridRef.current;
    const buf = bufRef.current, lut = lutRef.current;
    if (!ctx || !sctx || !g || !buf || !lut) return;
    const W = sizeRef.current.w, H = sizeRef.current.h;
    const px = buf.data;
    let i4 = 0;
    for (let p = 0; p < GW * GH; p++) {
      // V 농도 0(종이) → 1(잉크끼 파스텔) — LUT 로 색 단계
      const q = Math.max(0, Math.min(255, (g.v[p] * 340) | 0));
      px[i4] = lut[q * 3];
      px[i4 + 1] = lut[q * 3 + 1];
      px[i4 + 2] = lut[q * 3 + 2];
      px[i4 + 3] = 255;
      i4 += 4;
    }
    sctx.putImageData(buf, 0, 0);
    // 확대 보간을 켜 둔 채로 늘린다 — 이 한 줄이 셀 덩어리를 부드러운 무늬로 바꾼다
    ctx.imageSmoothingEnabled = true;
    ctx.imageSmoothingQuality = "high";
    ctx.drawImage(sctx.canvas, 0, 0, GW, GH, 0, 0, W, H);
  }

  function frame(): void {
    for (let s = 0; s < STEPS; s++) { wobble(phaseRef.current + s * 0.02); step(); }
    phaseRef.current += STEPS * 0.02;
    paint();
    rafRef.current = requestAnimationFrame(frame);
  }

  // 시드 재생성 → 미리성숙(PRE 스텝 동기) → 즉시 다시 그리기 (reduce 경로에서도)
  function regrow(sd: number): void {
    phaseRef.current = sd * 0.7;
    gridRef.current = seedField(sd);
    for (let s = 0; s < PRE; s++) step();
    paint();
  }

  function onSeedInput(e: InputEvt): void {
    const v = Math.max(1, Math.min(9999, Math.floor(Number(e.target.value)) || 1));
    setSeed(v);
    regrow(v);
  }

  function onFkInput(e: InputEvt): void {
    const v = Number(e.target.value);
    fkRef.current = v;
    setFk(v);
    // reduce 경로에서도 프레임이 즉시 반응하게 — 새 F 로 짧게 진행해 다시 그린다
    if (reduced()) { for (let s = 0; s < 60; s++) step(); paint(); }
  }

  function onResize(): void {
    fit();
    paint();
  }

  useEffect(() => {
    const cv = cvRef.current;
    if (!cv) return;
    ctxRef.current = cv.getContext("2d");
    if (!ctxRef.current) return;
    const small = document.createElement("canvas");
    small.width = GW;
    small.height = GH;
    smallRef.current = small;
    sctxRef.current = small.getContext("2d");
    if (!sctxRef.current) return;
    bufRef.current = sctxRef.current.createImageData(GW, GH);   // 한 번만 만들어 두고 프레임마다 같은 배열을 덮어쓴다
    lutRef.current = buildLut(stops());
    fit();
    regrow(seed);
    window.addEventListener("resize", onResize);
    if (reduced()) {
      // reduce — 루프를 시작하지 않고 성숙 상태 한 장만 그린다
      setStill(true);
    } else {
      rafRef.current = requestAnimationFrame(frame);
    }
    return () => {
      window.removeEventListener("resize", onResize);
      cancelAnimationFrame(rafRef.current);
    };
  }, []);

  const cls = [styles.root, still ? styles.isStill : ""].filter(Boolean).join(" ");
  return (
    <main className={styles.stage}>
      <div className={cls} 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="M144 48h32v32h-32zm40 40h32v32h-32zm-40 40h32v32h-32zm-40 40h32v32h-32z" opacity=".2"/><path d="M228 92h-44V48a12 12 0 0 0-12-12H48a12 12 0 0 0-12 12v56a12 12 0 0 0 12 12h44v44a12 12 0 0 0 12 12h44v44a12 12 0 0 0 12 12h68a12 12 0 0 0 12-12v-56a12 12 0 0 0-12-12h-44v-44a12 12 0 0 0-12-12m-12 24h44v32h-44zm-56 56h44v32h-44zm-56 56h44v32H60zm124 32h-44v-32h44zM60 92V60h44v32zm44 24H60v-16h44z"/></g></svg>
          <span>점과 줄 사이의 중간 지점 — 줄이 꺾여 길을 냅니다. F 를 움직이면 미로가 다시 짜입니다</span>
        </p>
        <div
          className={styles.field}
          ref={fieldRef}
          role="application"
          aria-label={FIELD_LABEL}
        >
          <canvas className={styles.cv} ref={cvRef}></canvas>
          <b className={styles.badge} aria-hidden="true">64 &times; 40</b>
        </div>
        <div className={styles.bar}>
          <label className={styles.dial}>시드
            <input
              type="number"
              min={1}
              max={9999}
              step={1}
              value={seed}
              aria-label="패턴 시드"
              onChange={onSeedInput}
            />
          </label>
          <label className={styles.dial + " " + styles.grow}>사료율 F
            <input
              type="range"
              min={0.01}
              max={0.07}
              step={0.001}
              value={fk}
              aria-label="사료율 F"
              onChange={onFkInput}
            />
            <b className={styles.val}>{fk.toFixed(3)}</b>
          </label>
        </div>
      </div>
    </main>
  );
}