# 변경 이력 (Changelog)

이 파일은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식을 따르며, 버전은
[유의적 버전(SemVer)](https://semver.org/lang/ko/)의 0.x 규칙을 따릅니다 (`docs/ko/contributing/releasing.md` 참고).

## [Unreleased]

### 추가 — 후처리 (블룸 · 자동 노출)

- `setPostProcessing({ bloom: { enabled, intensity, threshold, knee, radius }, autoExposure: { enabled, minEv, maxEv, speedUp, speedDown, compensation, adaptation } })` / `getPostProcessing()`(`supported` · `active` 포함): PBR 장면 메시에 선택형 HDR 후처리를 켭니다(기본값 꺼짐). 효과가 켜지면 메시를 톤 매핑 없이 `Rgba16Float` HDR 타깃(MSAA면 멀티샘플 타깃에서 resolve)에 그리고, 전체 화면 합성 패스가 노출 · 블룸 · 톤 매핑 · sRGB 인코딩을 한 번에 적용합니다. 2D 차트 · 노드 · 에지 · 헬퍼는 합성 위에 그대로 그려집니다.
- 블룸: 소프트 knee 임계값 프리필터(Karis 평균으로 반짝임 깜빡임 억제), 최대 6단계 13탭 다운샘플 체인, 텐트 업샘플 가산. 자동 노출: 컴퓨트 없이 64 → 16 → 4 → 1 로그 휘도 축소(배경 제외), `minEv..maxEv` 제한 · `compensation`, 1 × 1 상태 텍스처 핑퐁으로 `speedUp` / `speedDown` 시간 적응(리드백 없음). 켠 뒤 첫 프레임과 `adaptation: 'instant'`는 바로 맞춥니다. `setShading({ exposure })`는 결과에 곱해집니다.
- 두 효과가 모두 꺼져 있으면 타깃 · 패스 · 파이프라인이 없고 렌더 결과가 그대로입니다. HDR 메시 · 리시버 파이프라인과 후처리 파이프라인은 처음 쓸 때 만들고, 타깃은 켤 때 만들고 크기 · MSAA 변경 시 다시 만들며 끄면 해제해 `gpuBytes`에 집계됩니다(1280 × 720 기준 약 10 MB, x4는 약 39 MB). WebGPU · `EXT_color_buffer_float`가 있는 WebGL2를 지원하며, 부동소수점 렌더 타깃이 없으면 후처리를 건너뛰고 `supported: false`를 반환합니다. classic 셰이딩에서는 적용되지 않습니다. `exportScene` / `loadScene`이 `postProcessing`을 저장 · 복원합니다. wasm `set_post_processing` / `get_post_processing` 추가.
- 예제 `scene/10-post-processing`, fixture `scene-bloom` · `scene-bloom-msaa` · `scene-auto-exposure`, 문서 `charts/scene-3d`의 「후처리」 절.

### 추가 — 점광원 그림자

- `setShadows({ point: { enabled, mapSize, bias, normalBias, softness, darkness, near, far } })` / `getShadows().point`: `setLighting` 점광원(`pointPosition`)의 전방향 그림자를 켭니다(기본값 꺼짐, 방향광 그림자와 독립). 메인 패스 전 광원 위치에서 90° 큐브 면마다 깊이 전용 패스 6개(`Depth32Float` 큐브 맵, `near`–`far` 역 Z 원근 깊이, `castShadow`인 불투명 객체만)를 그리고, 받는 면은 하드웨어 비교 3 × 3 이중선형 PCF(`softness` 텍셀)로 큐브 이음새까지 틈 없이 필터링합니다. `bias`(기울기 비례) · `normalBias`는 받는 면 거리 기준 텍셀 단위, `far: 'auto'`는 캐스터 · 리시버 범위에 맞춥니다. 그림자는 classic · PBR 모두에서 점광원만 줄입니다.
- 꺼져 있으면 추가 패스가 없고 기존 셰이더 · 파이프라인 · 렌더 결과가 그대로입니다. 켜면 기존 그림자 바인드 그룹(classic 2 · PBR 3)에 바인딩 3–5가 추가되며 방향광 · 점광원 · 둘 다 조합마다 리시버 파이프라인을 처음 쓸 때 만듭니다. `mapSize`(256 / 512 / 1024)는 장치 한도로 제한되고, 맵(1.5 / 6 / 24 MiB)은 켤 때 만들고 끌 때 해제해 `gpuBytes`에 집계됩니다. WebGPU · WebGL2 모두 지원. `exportScene` / `loadScene`이 `shadows.point`를 저장 · 복원합니다(`point` 없는 장면은 현재 설정 유지). wasm `set_scene_point_shadows` / `get_scene_point_shadows` 추가.
- 예제 `scene/09-point-shadows`, fixture `scene-point-shadows` · `scene-point-shadows-pbr`, 문서 `charts/scene-3d`의 「점광원 그림자」 절.

### 추가 — HDR 환경 맵

- `loadEnvironmentHdr(source, { signal })`(Radiance `.hdr`: RGBE, 평면 · 새 형식 RLE, `-Y` / `+Y`; URL · `Blob` · `ArrayBuffer` · 타입 배열) / `createEnvironmentFromFloat(width, height, rgb)`(선형 RGB float): PBR `environment.map`에 쓸 HDR 환경 맵을 만듭니다(최대 4096x2048, 오류는 메서드 이름으로 시작). 너비 1024 이하로 줄여 `Rgba16Float`로 저장하고 생성 시 GPU에서 한 번 사전 필터링합니다: 밉 `i`는 거칠기 `i / (n - 1)`의 GGX 중요도 샘플링(텍셀당 128개, 필터링 중요도 샘플링), 확산광은 SH9 복사조도. 1보다 큰 값이 노출 · 톤 매핑까지 유지됩니다. half float 렌더 타깃이 없는 WebGL2는 CPU 박스 밉으로 대체합니다.
- `environment.rotation`(+y 축 라디안, HDR · LDR 맵 모두). HDR 텍스처는 `getTextures()` / `exportScene`에 `hdr: true`로 표시되고 `loadSceneWithTextures`가 `loadEnvironmentHdr`로 다시 불러옵니다. 텍스처 예산 · `texture_bytes` · `gpuBytes`에 집계되고 `disposeTexture` · 엔진 해제로 풀립니다. LDR 맵 · 하늘/땅 반구 · classic 렌더 결과는 그대로입니다. wasm `create_environment_hdr` / `create_environment_from_float` / `set_scene_env_rotation` 추가, `get_scene_shading`이 회전 값을 12번째로 반환합니다.
- 사전 필터링(업로드 · 다운샘플 · GGX 패스)을 GPU 검증 · 메모리 부족 오류 범위로 감쌉니다. 오류가 나면 텍스처를 해제하고 예산에 집계하지 않습니다: `loadEnvironmentHdr`는 메서드 이름으로 시작하는 오류로 거부되고 WebGL2의 `createEnvironmentFromFloat`는 예외를 던집니다. WebGPU는 오류를 비동기로 알리므로 `createEnvironmentFromFloat`는 동기 API 그대로 ID를 먼저 반환하고, 실패하면 맵을 해제하며 콘솔 경고를 남깁니다. 새 `environmentReady(id)`로 그 결과를 기다릴 수 있습니다(호환성 변경 없음). wasm `environment_ready` 추가.
- 예제 `scene/08-hdr-environment`, fixture `scene-pbr-hdr`, 문서 `charts/scene-3d`의 「HDR 환경 맵」 절.

### 추가 — PBR 재질 맵

- 객체 재질 필드 `metallicRoughnessMap`(B = 금속성, G = 거칠기, 계수에 곱함) · `normalMap` + `normalScale`(접선 공간) · `aoMap` + `aoStrength`(R 채널, 환경광만 줄임) · `emissiveMap` + `emissiveColor`(sRGB 맵 × 색): 기본 도형 · 사용자 메시 · `setObjectMaterial`에서 지정하며 PBR 모델에서만 적용됩니다(classic과 맵 없는 PBR 렌더 결과는 그대로). 접선 프레임은 화면 미분으로 만드는 cotangent 프레임이라 정점 형식 변경 · `TANGENT` 속성 없이 WebGPU · WebGL2 모두 동작하고 뒤집힌 UV도 처리합니다. 모든 맵은 객체의 `mapRepeat` / `mapOffset`을 공유합니다.
- `disposeTexture`가 해당 텍스처를 쓰는 맵 슬롯을 비웁니다. `exportScene` / `loadScene`이 맵 필드를 저장 · 복원하고 `loadSceneWithTextures`가 슬롯마다 텍스처 ID를 다시 매핑합니다. glTF 로더가 `metallicRoughnessTexture` · `normalTexture` · `occlusionTexture` · `emissiveTexture`(TEXCOORD_0, `KHR_texture_transform`)를 읽습니다. wasm `set_object_material_maps` / `get_object_material_maps` 추가.
- 예제 `scene/07-pbr-maps`, fixture `scene-pbr-maps`, 문서 `charts/scene-3d`의 「재질 맵」 절.

### 추가 — MSAA 안티에일리어싱

- `Charturbo.create(canvas, { antialias: true | 4 })`, `setAntialias(1 | 4)` / `getAntialias()`: 메인 패스를 멀티샘플 색상 · 깊이 타깃(샘플 4개)에 그린 뒤 캔버스로 resolve해 메시 윤곽의 계단 현상을 줄입니다(2D 선 · 마커는 셰이더에서 이미 안티에일리어싱되어 거의 같음)(기본값 꺼짐, 꺼져 있으면 텍스처 · 파이프라인 · 렌더 결과가 그대로). 지연 생성되는 PBR · 그림자 리시버 파이프라인까지 샘플 수를 맞추고, 섀도 패스 · 밉 생성 · 오프스크린 패스는 1x로 유지합니다. 장치가 캔버스 형식의 x4 렌더링을 지원하지 않으면 콘솔 경고와 함께 1로 남습니다. 타깃은 켤 때 만들고 크기 변경 시 다시 만들며 끌 때 해제해 `gpuBytes`에 집계됩니다. WebGPU · WebGL2 모두 지원. wasm `set_antialias` / `get_antialias` 추가.

### 변경 — 3D 장면 피킹 가속

- `raycastObjectAtNdc` / `pickObjectAtNdc`: 삼각형 64개 이상인 사용자 메시는 첫 피킹 때 만든 binned-SAH 삼각형 BVH(삼각형당 약 20–23 B, 메시마다 캐시)로 교차를 찾습니다. 결과(객체 · 교차점)는 기존 전수 검사와 비트 단위로 같고, 20만 삼각형 메시에서 광선당 약 840 µs → 0.7 µs입니다. 광선이 월드 경계 상자를 지나지 않는 객체는 역행렬 계산 전에 건너뜁니다.
- 원기둥 피킹이 경계 상자 대신 해석적 원기둥(옆면 · 뚜껑)으로 바뀌어, 상자 모서리 부근의 빈 공간은 더 이상 맞지 않습니다.

### 추가 — 방향광 그림자

- `setShadows({ enabled, mapSize, bias, normalBias, softness, darkness, bounds })` / `getShadows()`: 3D 장면 메시에 방향광 섀도 매핑을 켭니다(기본값 꺼짐, 꺼져 있으면 기존 셰이더 · 파이프라인 · 렌더 결과가 그대로이며 차트 · 과학 3D는 영향 없음). 메인 패스 전 깊이 전용 패스(`Depth32Float`, 역 Z), 캐스터 · 리시버에 맞추고 텍셀 단위로 고정한 직교 광원 카메라(`bounds: 'auto'`) 또는 고정 구, 기울기 비례 bias + 법선 오프셋, 하드웨어 비교 4 × 4 PCF(`softness` 텍셀). 그림자는 classic · PBR 모두에서 방향광만 줄입니다.
- 객체별 `castShadow` / `receiveShadow`(기본 `true`, 기본 도형 · 사용자 메시 · glTF, `setObjectMaterial`로 변경). 반투명 객체는 그림자를 드리우지 않고 알파 테스트 텍스처는 그림자에 구멍을 냅니다. `mapSize`(512 / 1024 / 2048 / 4096)는 장치 한도로 제한되며 맵은 켤 때 만들고 끌 때 해제해 `gpuBytes`에 집계됩니다. WebGPU · WebGL2 모두 지원. `exportScene` / `loadScene`이 `shadows`와 객체 플래그를 저장 · 복원합니다. wasm `set_scene_shadows` / `get_scene_shadows` / `set_object_shadow_flags` / `get_object_shadow_flags` 추가.
- 예제 `scene/06-shadows`, fixture `scene-shadows` · `scene-shadows-pbr`, 문서 `charts/scene-3d`의 「그림자」 절.

### 추가 — 물리 기반 셰이딩(PBR)

- `setShading({ model, toneMapping, exposure, environment: { sky, ground, intensity, map } })` / `getShading()`: 3D 장면 메시에 선택형 PBR을 켭니다(기본값 `model: 'classic'`은 기존 Blinn-Phong 그대로이며 차트 · 과학 3D · 3D 그래프는 바뀌지 않습니다). GGX · 높이 상관 Smith · Schlick 프레넬(`F0 = mix(0.04, color, metallic)`) · Lambert 확산, 선형 공간 조명 후 노출 · 톤 매핑(`'aces'` 기본 · `'reinhard'` · `'none'`) · sRGB 인코딩을 셰이더에서 합니다. 환경광은 하늘 / 땅 반구 또는 등장방형 텍스처(`map`, 거칠기에 따른 밉 레벨, 해석적 split-sum 근사)이며, 모르거나 해제된 텍스처 ID는 반구로 대체됩니다. `ambientIntensity`는 classic 전용입니다.
- PBR 파이프라인은 별도로 처음 쓸 때 컴파일되어 classic 셰이더는 바이트 단위로 그대로입니다. WebGPU · WebGL2 모두 지원. `exportScene` / `loadScene`이 `shading`을 저장 · 복원하고 `loadSceneWithTextures`가 환경 텍스처 ID를 다시 매핑합니다. wasm `set_scene_shading` / `get_scene_shading` 추가.
- 예제 `scene/05-pbr`, fixture `scene-pbr`, 문서 `charts/scene-3d`의 「물리 기반 셰이딩」 절.

### 추가 — glTF 모델

- `loadGltf(source, { position, rotation, scale, scene, baseUrl, signal })`: glTF 2.0 모델(`.gltf` / `.glb`, URL 문자열 · `URL` · `ArrayBuffer` · `Uint8Array` · `Blob`)을 사용자 정의 메시 객체로 불러와 `{ objects, textures, nodes, bounds }`를 반환합니다. `disposeGltf(result)`는 만든 객체와 텍스처를 모두 제거합니다. TS 전용(`sdk/scene-gltf.ts`)이며 엔진은 바뀌지 않았습니다.
- 외부 · `data:` URI 버퍼와 이미지, 모든 접근자 타입(인터리브 · 정규화 · 희소 · 버퍼 뷰 없음), 삼각형 스트립 · 팬 변환(점 · 선은 경고 후 건너뜀). 노드 계층은 꼭짓점에 구워 넣고(법선은 역전치, 거울상은 감기 순서 반전), 법선이 없으면 부드러운 법선을 계산합니다. `scale`은 꼭짓점에, `position` / `rotation`은 객체 변환에 적용됩니다.
- 재질: 기본색(선형 → 감마), 금속성 · 거칠기, 발광(최대 성분 스칼라), `MASK` / `BLEND`, `KHR_texture_transform`(offset · scale), 공유 이미지는 한 번만 디코딩. `KHR_mesh_quantization` · `KHR_materials_emissive_strength` 지원. 샘플러, 기타 텍스처, 스킨 · 모프 · 애니메이션 · 카메라는 무시하고(대부분 경고), 지원하지 않는 필수 확장은 `loadGltf: extension X is required but not supported`를 던집니다. 한 번에 꼭짓점 `GLTF_MAX_VERTICES` · 인덱스 `GLTF_MAX_INDICES`까지. 실패나 중단(`AbortError`) 시 만든 객체와 텍스처를 정리합니다.
- 예제 `scene/04-gltf`, fixture `scene-gltf`, 문서 `charts/scene-3d`의 「glTF 모델」 절.

### 추가 — 3D 텍스처

- 3D 장면 객체에 텍스처를 입힙니다. `loadTexture(source, { mipmaps, signal })`(URL 문자열 · `URL` · `Blob` · `ImageBitmap` · 이미지 · 캔버스 · `OffscreenCanvas` · `ImageData`; 스트레이트 알파로 디코딩하고 `maxTextureSize`보다 크면 비율을 유지해 축소, `signal`로 중단하면 `AbortError`, 오염된 이미지는 `loadTexture: cross-origin image`), `createDataTexture(width, height, rgba)`, `disposeTexture(id)`, `getTextures()`, `maxTextureSize`.
- 재질 · 기본 도형 · 사용자 정의 메시 설명자에 `map`(`null`이면 제거) / `mapRepeat` / `mapOffset` / `alphaTest`(맵이 있으면 기본 0.5)를 추가했고(`addBox` 등, `setObjectMaterial`, `SceneObjectRecord`), 사용자 정의 메시는 `uvs`를 받습니다(없으면 평면 투영). `createTorusMesh`가 `uvs`를 함께 반환합니다. 텍스처는 `color`와 곱해지며 `v = 0`이 이미지의 맨 윗줄이라 뒤집을 필요가 없습니다.
- `exportScene()`은 객체가 쓰는 텍스처를 `textures`에 담고, `loadScene`은 살아 있는 ID를 유지하며 모르는 ID는 경고 후 맵을 버립니다. 새로 추가된 `loadSceneWithTextures(descriptor)`는 `src`가 있는 텍스처를 다시 불러와 ID를 바꿔 매핑합니다. `clearScene()`은 텍스처를 지우지 않습니다. 엔진이 텍스처를 지원하지 않으면 텍스처 API가 `... engine has no texture support`를 던집니다.
- 예제 `scene/03-textures`, 문서 `charts/scene-3d`의 「텍스처」 절.

### 추가 — 포인트 드래그 · 클릭으로 추가

- `enableNodeInteractions`의 `editable`(`true` 또는 `{ drag, dragAxis, min, max, xMin, xMax, addOnClick, addSeries, series, hitRadius }`): 2D 선 · 산점도에서 포인트를 드래그해 값을 바꾸고(ECharts draggable point), 플롯 빈 곳을 클릭 / 탭해 포인트를 추가합니다. 포인트를 누르면 팬 · 브러시 · 박스 줌 대신 드래그가 되고, `dragAxis`(`'y'` · `'x'` · `'xy'`, 기본 선 `'y'` · 산점도 `'xy'`)와 보이는 범위 · `min` / `max`로 값을 제한합니다. 선의 x 드래그는 이웃을 넘지 않고, 클릭으로 추가한 점은 x 순서로 끼워 넣습니다.
- 갱신은 데이터 경로로 합니다(선: `setSeriesData`, 산점도: Rust `set_chart_scatter_point` / `append_chart_scatter_point`로 제자리 이동 · 추가). 장면을 지우지 않으므로 줌 · 범례 · 스타일 상태가 유지됩니다. Escape는 드래그를 취소하고 값을 되돌립니다. 터치 · 펜은 Pointer Events로 동작합니다.
- 이벤트 `pointDrag` · `pointDragEnd`(`cancelled`) · `pointAdd`, React `onPointDrag` · `onPointDragEnd` · `onPointAdd`, Vue `@point-drag` · `@point-drag-end` · `@point-add`. `getSeriesData(series)`가 편집된 데이터를 돌려주고, `setChartEditable` / `getChartEditable`로 옵션을 바꿉니다(잘못된 옵션은 상태를 바꾸기 전에 예외).
- 키보드: 포커스된 포인트를 Shift + 화살표(보이는 범위의 1/50), Alt + 화살표(1/500)로 옮기고 라이브 영역에서 알립니다(영어 · 한국어 · 중국어).
- 예제 `line/16-draggable` · `scatter/07-click-to-add`, fixture `edit-drag-line` · `edit-add-scatter`(스크립트 드래그 · 클릭), 문서 `guide/editing`. 막대 · 누적 / 밴드 / 희소 선 · 추가 y축 시리즈 편집은 아직 없습니다.

### 추가 — 로딩 표시

- `showLoading(options?)` / `hideLoading()` / `isLoading()`(ECharts `showLoading`): 차트 위에 마스크 · 스피너 · 상태 텍스트를 띄웁니다. 기본 텍스트는 영어 · 한국어 · 중국어(`'Loading…'` / `'로딩 중…'` / `'加载中…'`), 옵션 `text` · `maskColor` · `color` · `textColor` · `fontSize` · `spinner` · `delay`(ms). 렌더링으로는 사라지지 않으며 표시 중 다시 호출하면 옵션만 바뀝니다.
- 컨테이너에 `aria-busy="true"`(숨기면 이전 값 복원), polite 라이브 영역 알림, `prefers-reduced-motion`이면 정지한 스피너. 기본 색 · 텍스트는 테마 · 언어 전환을 따르고, PNG / SVG / PDF 내보내기에는 들어가지 않습니다. 잘못된 옵션은 현재 표시를 바꾸기 전에 예외를 던집니다.
- React / Vue `loading` prop(`true` · 옵션 · falsy), 공개 타입 `ChartLoadingOptions` · `CharturboChartLoading`. 예제 `export/03-loading`, fixture `loading`(스피너 고정), 문서 `guide/loading-watermark`.

### 추가 — 리치 텍스트 라벨

- ECharts `label.rich`처럼 `{name|text}` 템플릿과 `rich` 스타일(`color` · `fontSize` · `fontWeight` · `fontStyle` · `fontFamily` · `backgroundColor` · `padding` · `borderRadius` · `lineHeight` · `align`)로 라벨 하나에 여러 글꼴 · 색 · 배지를 섞습니다. `\n` 줄바꿈, `\{` · `\}` · `\\` 이스케이프, 닫히지 않거나 이름 없는 `{`는 일반 텍스트.
- 막대(`labels.format` + `labels.rich`), 파이 · 트리맵 · 선버스트 · 생키 · 퍼널(`label.formatter` + `label.rich`). 막대 안쪽 맞춤 · `'auto'` 겹침 숨김, 파이 지시선 간격, 퍼널 라벨 공간이 스타일 적용 크기를 씁니다. 트리맵 헤더 띠는 첫 줄만 표시합니다.
- DOM은 `textContent`로만 만들고, 스크린 리더에는 일반 텍스트가 전달되며, PNG / SVG / PDF 내보내기가 구간 스타일을 그대로 그립니다. `rich`가 없는 라벨은 이전과 같습니다. 잘못된 `rich`는 현재 차트를 바꾸기 전에 예외를 던집니다.
- 예제 `bar/08-rich-labels` · `pie/07-rich-labels`, fixture `bar-rich-labels` · `pie-rich-labels` · `treemap-rich-labels`, 문서 `guide/rich-labels`.

### 추가 — 워터마크

- `setWatermark(options | null)` / `getWatermark()`: 텍스트 또는 이미지 워터마크를 플롯 위, 라벨 · 툴팁 아래에 타일로 그립니다. 옵션 `text` | `image`(+ `imageWidth` · `imageHeight`), `opacity`(기본 0.15), `rotate`(기본 30°, 양수 = 반시계), `fontSize` · `fontFamily` · `fontWeight` · `color`, `gap`(기본 `[80, 60]`), `repeat`(`false`면 가운데 하나), `export`(기본 `true`).
- PNG / SVG / PDF 내보내기에 포함(`export: false`로 제외). 레이어는 `aria-hidden`이며 클릭을 통과시키고, 차트를 다시 렌더링해도 남으며 테마를 따릅니다. 이미지는 `crossOrigin = 'anonymous'`로 불러오며 불러오지 못하면 그리지 않습니다. 잘못된 옵션은 현재 워터마크를 바꾸기 전에 예외를 던집니다.
- React / Vue `watermark` prop, 공개 타입 `ChartWatermarkOptions` · `ResolvedWatermark`. 예제 `export/02-watermark`, fixture `watermark-text`, 문서 `guide/loading-watermark`.

### 추가 — 패턴 채우기 (decal)

- 차트 옵션 `decal`(ECharts `aria.decal` / `itemStyle.decal`): `true`이면 시리즈마다(단일 시리즈 막대는 category마다, 파이는 조각, 퍼널은 단계, 트리맵 · 선버스트는 최상위 그룹) 자동 패턴이 붙고, 객체면 자동 패턴 위에 옵션을 적용합니다. 시리즈 · 항목 `decal`(막대 · 영역 시리즈, 계층 노드)과 파이 · 퍼널 `decals[]`가 덮어쓰며 `false`는 끕니다.
- 기호 `rect` · `circle` · `triangle` · `diamond` · `line`(줄무늬) · `cross`, 옵션 `symbolSize` · `spacing` · `rotation`(도, 화면 시계 방향) · `color`(기본 `'auto'`: 마크 밝기에 따라 검정 / 흰색) · `opacity`(기본 0.45). 막대(그룹형 · 누적형 · 백분율, 2D) · 파이 / 도넛 · 영역 · 트리맵 · 선버스트 · 퍼널에 적용.
- 패턴은 GPU 프래그먼트 셰이더에서 별도 패스로 그리며(Rust `chart/decal.rs`, 텍스처 없음) 화면 공간에 고정됩니다. WebGPU · WebGL2가 같게 보이고, 범례 견본 · SVG 내보내기(`<pattern>`) · 테마 전환에서 유지됩니다. `decal`이 없으면 렌더링은 그대로입니다. 잘못된 옵션은 현재 차트를 지우기 전에 예외를 던집니다.
- React / Vue 옵션 타입, 예제 `bar/09-decal`, fixture `decal-bar-stacked` · `decal-donut` · `decal-area` · `decal-treemap` · `decal-sunburst` · `decal-funnel`, 문서 `guide/accessibility`. 3D 차트 · 픽토리얼 막대 · 파이 "기타" 조각 · 트리맵 부모 헤더 · 선버스트 중심에는 패턴이 없고, 겹치는 영역(`overlap`)에서는 아래 시리즈의 패턴이 위 시리즈 위에 보일 수 있습니다.

### 추가 — 극좌표계

- `renderPolarChart(data, options)`: 극좌표계 차트(ECharts `polar` + `angleAxis` / `radiusAxis`). 각도 · 반지름 축은 각각 범주 또는 값 축이며 `min` / `max` / `splitNumber` / `labels` / `splitLine` / `name`을 받습니다. `startAngle`(12시 기준 시계 방향 각도, 파이 · 코드와 같음 — ECharts와 기준이 다름), `clockwise`, `innerRadius`, `barCategoryGap` / `barGap`.
- 시리즈: 방사형 · 링 막대(범주 축이 각도면 바깥으로, 반지름이면 원을 따라; `stack` 누적, `roundCap`), 선(열림 / `closed`, `smooth`, `area`, 마커), 산점, 히트맵(범주 각도 × 범주 반지름 셀, 히트맵 색상 맵 · 컬러바 재사용). 레이아웃 · 눈금 · 격자 · 히트 테스트 · 레이블 위치는 Rust(`chart/polar.rs`)에서 계산하고 파이 부채꼴 분할 · 계층 레이블 / 호버 / 범례 / 트윈 경로를 재사용합니다.
- 호버 외곽선 · 툴팁(`ctx.polar`), 범례 강조 / 숨김(다시 쌓고 축을 다시 맞춤, 애니메이션이 켜져 있으면 트윈), 접근성 요약 · 표 · 키보드, CSV / 벡터 SVG 내보내기, React / Vue `type="polar"`, 영어 · 한국어 · 중국어 문구. 잘못된 입력은 현재 차트를 바꾸기 전에 예외를 던집니다.
- 예제 `business/08-polar-bar` · `09-polar-stacked` · `10-polar-line` · `11-polar-heatmap`, fixture `polar-bar` · `polar-stacked` · `polar-line` · `polar-heatmap`, 문서 `charts/polar`. 극좌표 위 캔들스틱 · 박스 플롯 · 효과 산점, 여러 극좌표계, 축 줌은 아직 없습니다.

### 추가 — 막대 · 선 레이스, 차트 전환 모핑

- 막대 레이스: `renderBarChart`의 `realtimeSort`(`true` 또는 `{ max, valueAnimation }`, 가로 · 세로)는 렌더링마다 값 내림차순으로 정렬하고 상위 `max`개만 남깁니다. 애니메이션이 켜져 있으면 막대가 인덱스가 아니라 라벨(키) 기준으로 이전 자리에서 트윈되고(Rust `chart/race.rs`), 새 라벨은 마지막 자리 다음에서 들어오며 페이드인, 빠진 라벨은 그쪽으로 나가며 페이드아웃합니다. 카테고리 · 값 라벨은 막대와 함께 움직이고 값 라벨은 카운트업합니다(`valueAnimation`, 기본 켬).
- 선 레이스: `renderLineChart`의 `endLabel`(`true` 또는 `{ format(value, seriesName) }`)이 선 끝에 시리즈 이름과 값을 표시하며, 왼쪽 → 오른쪽 드러내기 동안 드러나는 앞쪽 끝을 따라갑니다. 오른쪽 여백을 라벨 폭만큼 늘립니다. 2D 선 차트 전용.
- 전환: `animation: { transition: true }`이면 막대 ↔ 파이(카테고리 = 조각 라벨), 트리맵 ↔ 선버스트(노드 경로)로 다시 렌더링할 때 마크 단위로 모핑합니다. 모든 마크를 안쪽 · 바깥쪽 변 24점 폴리곤으로 만들어 Rust에서 점별 보간하므로(`chart/transition.rs`) 프레임마다 리샘플링 · 삼각분할이 없습니다. 짝 없는 마크는 페이드, 마크 2,000개 초과 차트는 enter 애니메이션. 트리맵 · 선버스트에 차트별 `animation` 옵션 추가.
- 히트 테스트 · 툴팁은 최종 레이아웃, 접근성은 최종 값을 씁니다. `prefers-reduced-motion`이면 트윈 · 카운트업 · 모핑이 꺼집니다. 잘못된 옵션은 현재 차트를 지우기 전에 예외를 던지며, 옵션을 주지 않으면 기존 동작은 그대로입니다. React / Vue 옵션 타입 포함.
- 예제 `animation/03-bar-race` · `04-line-race` · `05-bar-pie` · `06-treemap-sunburst`, fixture `race-bar-end` · `race-line-end` · `transition-bar-pie-end` · `transition-treemap-sunburst-end`(종료 상태), 문서 `guide/animation`.

### 추가 — 다중 축 (y축 3개 이상)

- 선 · 콤보 차트의 `axes.extraY`(최대 6개, y축 합계 8개)와 시리즈 `yAxisIndex`(0 = `y`, 1 = `y2`, 2.. = `extraY[k - 2]`, `yAxis`보다 우선). 축마다 `min` / `max` · `autoscale` · `scale` · `format` · `title` · `tickCount` · `breaks` · `color`, 배치는 `position: 'left' | 'right'`와 `offset`(px). 여백은 추가 레이블 · 제목 폭만큼 자동으로 늘어납니다.
- 도메인 · 눈금 · 자동 스케일은 축마다 Rust 엔진에서 계산합니다(`set_chart_y_axis_at`, `chart_y_domain_at`). x 확대 / 이동, 호버 · 크로스헤어, 브러시가 모든 축에서 동작하고, 툴팁은 값을 각 축의 `format`으로 표시합니다.
- 접근성 설명이 추가 축과 그 축의 시리즈를 알려 줍니다(영어 · 한국어 · 중국어). 잘못된 `yAxisIndex`는 현재 차트를 지우기 전에 예외를 던집니다. 공개 타입 `ExtraYAxisOptions` · `ComboExtraYAxisOptions` · `ChartExtraAxisPlacement`.
- 예제 `line/14-multi-axis` · `combo/02-multi-axis`, fixture `axes-multi-line` · `axes-multi-combo`, 문서 `guide/multiple-axes`. 추가 x축, 영역 차트의 다중 축, 주석의 추가 축 지정은 아직 없습니다.

### 추가 — 축 끊김 (axis break)

- 값 축의 `breaks: [{ start, end, gap? }]`(`gap`: 데이터 단위 또는 `'<n>%'`, 기본 `'2%'`). 선(y, y2, extraY), 영역(y), 콤보, 막대 · 그룹 막대의 값 축, 산점도 x / y를 지원합니다. 구간별 매핑은 Rust 스케일 한 곳에 있어 지오메트리 · 눈금(접힌 구간 건너뜀) · 호버 · 브러시 · 확대가 같은 매핑을 씁니다.
- 접힌 자리는 축과 플롯 전체에 지그재그 표시로 그리며, PNG / SVG 내보내기에도 포함됩니다. 접근성 설명이 각 끊김을 축 형식으로 알려 줍니다(영어 · 한국어 · 중국어).
- 축당 최대 8개, 겹침 · 맞닿음 금지, 선형 스케일만 가능(`log`, 픽토리얼 막대, 선 · 영역 x축은 예외). 끊김이 있는 축에 `setAxisScale(..., { scale: 'log' })`를 호출하거나 오차 막대와 끊김을 함께 쓰면 오류입니다. 검증은 현재 차트를 지우기 전에 합니다. 공개 타입 `ChartAxisBreak` · `ChartAxisBreakOptions`.
- 예제 `bar/07-axis-break` · `line/15-axis-break`, fixture `axes-break-bar` · `axes-break-line`. 시간 축 끊김, 오차 막대 · 폭포 차트의 끊김은 아직 없습니다.

### 추가 — 픽토리얼 막대 (pictorialBar)

- `renderPictorialBarChart(data, options)`: 막대를 심볼로 그리는 2D 막대 차트(ECharts `pictorialBar`). 데이터는 `renderBarChart` 항목 배열 또는 `{ categories, series }`이며, 축 · 가로 방향 · 그룹형 / 누적형 / 백분율 · 레이블 · 범례는 막대 차트를 그대로 씁니다. `background` 트랙이 그림자 막대가 됩니다.
- 심볼 옵션(차트 · 시리즈 · 항목 순으로 덮어씀): `symbol`(내장 도형 9종 또는 `path://` SVG 경로 — Rust에서 파싱 · 삼각분할 후 캐시), `symbolRepeat`(`true` · 개수 · `'fixed'`), `symbolSize`(px · %), `symbolMargin`(기본 `'15%'`, `!` = 양 끝 간격), `symbolClip`, `symbolPosition`, `symbolOffset`, `symbolRotate`, `symbolBoundingData`. 음수 막대는 심볼을 뒤집습니다.
- 호버 강조 · 툴팁, 업데이트 트윈과 등장 애니메이션(프레임마다 반복 심볼을 다시 배치), 접근성 요약("픽토리얼 막대 차트", 영어 · 한국어 · 중국어) · 데이터 표 · 키보드, CSV / SVG(벡터) 내보내기, React / Vue `type="pictorialBar"`. 잘못된 옵션 · `image://` · 3D는 현재 차트를 바꾸기 전에 예외를 던집니다.
- 예제 `bar/06-pictorial`, fixture `pictorial-bar-repeat` · `pictorial-bar-paths` · `pictorial-bar-horizontal`, 문서 `charts/pictorial-bar`. `image://` 심볼, `symbolKeepAspect`, 시리즈 겹치기(`barGap: '-100%'`)는 아직 없습니다.

### 추가 — 2D 그래프 (관계도)

- `renderGraph(data, options)`: 평면의 노드-링크 네트워크(ECharts `graph`). `layout: 'force' | 'circular' | 'none' | 'cartesian'`. force는 3D 그래프의 Barnes-Hut 시뮬레이터(`physics`)를 z = 0 평면에서 재사용해 Rust에서 안정될 때까지 돌리고(결정적 시작 배치, `fixed` 노드 고정), circular는 값 비례 구간과 `rotateLabel`, cartesian은 값 축 · 범주 x축(`xAxis.categories`)과 격자선을 씁니다.
- 범주 색과 범례(클릭 숨김 · 호버 강조, 숨긴 노드의 링크도 숨김), 값 비례 크기 `symbolSize: [min, max]`, `symbol`, 엣지 `lineWidth` · `curveness` · `edgeSymbol: 'arrow'` · `edgeColor: 'source' | 'target'` · `edgeOpacity`, 노드 호버 시 인접 노드 · 링크 강조.
- 입력은 장면을 지우기 전에 검증합니다(잘못된 호출은 기존 차트를 유지). 툴팁(범주 › 이름 · 값; 연결 수는 `ctx.hierarchy.children`), `getNodeDetails`, 접근성 요약 · 표 · CSV, 키보드(위 / 아래 노드 순서, 오른쪽 / 왼쪽 연결 노드), SVG 내보내기, React / Vue `type="graph"`, 영어 · 한국어 · 중국어 문구.
- 예제 `graph/04-graph-force-2d` · `05-graph-circular` · `06-graph-cartesian`, fixture `graph2d-force` · `graph2d-circular` · `graph2d-cartesian`, 문서 `charts/graph-2d`. 노드 드래그, 자기 루프, 엣지 호버는 아직 없습니다.

### 추가 — 코드 다이어그램

- `renderChordChart(data, options)`: 그룹 사이 흐름을 원형 호와 리본으로 그립니다(ECharts `chord`). 엔진(Rust, `chart/chord.rs`)이 d3 `chord()` / `chordDirected()`와 같은 레이아웃을 계산합니다. 입력은 정사각 흐름 행렬 + `names` 또는 ECharts 형식 `nodes` / `links`이며, 현재 차트를 지우기 전에 검증합니다.
- `padAngle`, `startAngle`, `clockwise`, `sortGroups` · `sortSubgroups` · `sortChords`, `directed`(방향마다 리본, 화살표 끝), `ribbonColor: 'source' | 'target' | 'gradient' | 'neutral'`, `ribbonOpacity`, `arcWidth`, 원 바깥 이름(`labels`, `labelRotate`).
- 그룹 호버는 그 그룹의 리본만 강조하고, 리본 툴팁은 `출발 → 도착`과 반대 방향 값을 함께 보여 줍니다(`ctx.chord`). 범례 클릭은 그룹을 숨기고 다시 배치하며, 애니메이션이 켜져 있으면 트윈합니다.
- 접근성 요약 · 흐름 행렬 표 · CSV, 키보드(그룹 / 코드 이동, 아래 · 위로 그룹 ↔ 코드), SVG 벡터 내보내기, React / Vue `type="chord"`, 영어 · 한국어 · 중국어 문구. 예제 `hierarchy/07-chord` · `08-chord-directed`, fixture `chord` · `chord-directed`, 문서 `charts/chord`.

### 추가 — 평행 좌표 · 축 브러시

- `renderParallelChart(data, options)`: 행마다 여러 축을 가로지르는 폴리라인 하나(ECharts `parallel`). 차원은 값 · 범주 · 시간 축이며 `min` / `max` / `inverse` / `categories` / `format`을 받습니다. `orient: 'horizontal' | 'vertical'`, `lineWidth`, `opacity`, `smooth`, 시리즈별 색(범례 토글) 또는 `colorBy`(히트맵 색상 맵 · 컬러바 재사용). 입력은 현재 차트를 지우기 전에 검증합니다.
- 축 브러시: 축을 따라 드래그, Shift + 드래그로 구간 추가(한 축 = 합집합, 여러 축 = 교집합), 클릭으로 축 해제, Escape로 전체 해제, `inactiveOpacity` · `inactiveColor` · `brushColor`. `setParallelBrush` · `clearParallelBrush` · `getParallelBrush` · `getParallelActiveRows`, `'parallelBrush'` 이벤트(React `onParallelBrush`, Vue `parallelBrush`). 브러시 변경은 GPU의 행 플래그만 다시 올립니다(10만 행 × 8차원: 생성 약 11 ms, 브러시 약 1 ms, CPU release 기준).
- 호버 강조와 모든 차원을 보여 주는 툴팁(`ctx.parallel`), 접근성 요약 · 표 · 키보드(축 위 값 순서 이동, Shift 브러시, Delete 축 해제), CSV(`exportParallelCSV({ activeOnly })`) / 벡터 SVG 내보내기, React / Vue `type="parallel"`, 영어 · 한국어 · 중국어 문구.
- 예제 `business/05-parallel` · `06-parallel-brush` · `07-parallel-large`, fixture `parallel` · `parallel-brush` · `parallel-vertical-smooth`, 문서 `charts/parallel`.

### 추가 — 플레이그라운드

- 예제 사이트에 `playground.html`을 추가했습니다. 예제 중 하나를 골라 CodeMirror 에디터에서 고치고 Ctrl/⌘ + Enter로 실행합니다. 코드는 Sucrase로 TS / TSX를 변환해 `runner.html` iframe에서 돌리므로, 다시 실행하면 이전 GPU 디바이스 · 타이머 · 리스너가 함께 정리됩니다. 사이트 테마와 언어를 따릅니다.
- 러너 iframe은 빌드된 사이트에서 `sandbox="allow-scripts"`(opaque origin)로 격리합니다. 공유 링크로 받은 코드도 사이트의 localStorage · 쿠키 · DOM에 접근할 수 없습니다. 러너가 15초 안에 뜨지 않으면(예: CORS 헤더가 없는 호스트) 오류를 표시합니다.
- 링크 복사: 코드를 `#code=`(deflate-raw + base64url)에 담아 서버 없이 공유합니다. 공유 링크로 연 코드는 바로 실행하지 않고 실행 버튼을 기다립니다.
- 예제 페이지의 각 카드에 편집 · 플레이그라운드에서 열기를 추가했습니다. 편집하면 소스가 에디터로 바뀌고, 실행하면 그 카드만 러너 iframe으로 바뀝니다. 원래대로는 원래 예제를 다시 마운트합니다. 고친 코드는 플레이그라운드로 가져갈 수 있습니다.
- import 가능한 모듈: `charturbo`, `charturbo/react`, `charturbo/vue`, `react`, `react-dom/client`, `vue`와 예제 헬퍼(`theme`, `demo-playback`, `scene-design`, `streaming-area`).

### 추가 — 캘린더 히트맵

- `renderCalendarHeatmap(data, options)`: `[날짜, 값][]`를 하루 한 셀로 주 단위 배치합니다(ECharts `calendar`). 날짜는 `'YYYY-MM-DD'`(적힌 그대로) 또는 에포크 ms / `Date`(차트 시간대 기준 날짜, `timeZone` 옵션 → `setTimeZone`).
- `range`(연도 · 월 · `[시작, 끝]`) / `ranges`(여러 캘린더), `orient`(가로 · 세로), `cellSize`, `cellGap`, `firstDay`, 요일 · 월 · 연도 레이블(로캘을 따르며 `names`로 교체), 월 경계선 `splitLine`, 데이터 없는 날 `emptyColor`.
- 색은 히트맵 색상 맵(`colorScale`, `color`, `reverse`, `min` / `max` / `center`)과 컬러바를 재사용합니다. 레이아웃 · 경계선 · 레이블 위치 · 히트 테스트는 Rust(`chart/calendar.rs`)에서 계산하고, SVG 보내기는 벡터입니다.
- 툴팁(날짜 · 값, 빈 날은 `No data`), `ctx.calendar`, `getNodeDetails`, 접근성 요약 · 데이터 표 · CSV(데이터가 있는 날), 키보드(하루 · 한 주 · Page Up / Down 한 달), 영어 · 한국어 · 중국어 문구, React / Vue `type="calendar"`. 예제 `heatmap/02-calendar`, fixture `calendar` · `calendar-vertical`, 문서 `charts/calendar`.

### 추가 — 트리 차트 (tidy tree)

- `renderTree(data, options)`: 노드-링크 트리(ECharts `tree`). 엔진(Rust)이 d3 `tree()`와 같은 좌표의 Walker tidy tree를 계산합니다. `layout: 'orthogonal' | 'radial'`, `orient: 'LR' | 'RL' | 'TB' | 'BT'`, `edgeShape: 'curve' | 'polyline'`, `symbol` · `symbolSize` · `lineWidth` · `curvature`, `colorBy: 'group'`. 입력은 계층 차트와 같은 중첩 노드 또는 평면 행이며 노드별 `collapsed`를 받습니다.
- 펼치기 / 접기: 클릭, Enter / Space, `initialTreeDepth`(기본 2, -1 = 전부), `setTreeNodeExpanded` · `toggleTreeNode`, `'treeToggle'` 이벤트(React `onTreeToggle`, Vue `treeToggle`). 토글마다 다시 배치하고 애니메이션이 켜져 있으면 트윈합니다. 접힌 부모는 채운 기호로 그립니다.
- 라벨은 방향별로 놓이고 방사형에서는 바깥쪽으로 회전합니다. 툴팁(경로 · 이름 · 값), 접근성 요약 · 표 · 키보드 탐색, CSV / SVG 내보내기, React / Vue `type="tree"`, 영어 · 한국어 · 중국어 문구를 지원합니다. 팬 / 줌은 아직 없습니다.
- 예제 `hierarchy/05-tree` · `06-tree-radial`, fixture `tree` · `tree-tb-polyline` · `tree-radial`, 문서 `charts/tree`.

### 변경 (호환성 깨짐) — 그래프 레이아웃 GPU 상주

- `stepPhysicsAsync`가 GPU에 상주하는 배치를 진행합니다. 위치·속도는 GPU 버퍼에 남고, CPU는 자신의 배치 편집만 올리며 비동기 readback을 1~2 프레임 뒤에 반영합니다. 자동 sleep 판정은 매 스텝 GPU에서 셉니다. GPU 상주 중에는 절두체 컬링을 생략합니다.
- `stepPhysicsAsync`는 readback 후가 아니라 제출 시점에 resolve하며, GPU 작업 중 CPU 편집은 거부되지 않고 순서대로 적용됩니다. 피킹·내보내기처럼 현재 위치가 필요하면 새 `syncPhysicsPositions()`를 await하세요.

### 추가 — 테마 리버(스트림 그래프)

- `renderThemeRiverChart(data, options?)`(ECharts `themeRiver`): `[x, value, name]` 행을 이름별 스트림으로 묶어 움직이는 기준선 둘레에 쌓습니다. 이름은 처음 나온 순서, x는 합집합이며 행이 없는 x는 0입니다. 값은 0 이상이어야 합니다.
- `offset`: `'wiggle'`(기본, d3 `stackOffsetWiggle`과 수치 일치) · `'silhouette'` · `'zero'`. `order`: `'none'`(기본) · `'insideOut'`(d3 `stackOrderInsideOut`). `smooth`(기본 monotone), `colors`(이름별 레코드 또는 배열), `fillOpacity`(기본 0.85), `labels`(왼쪽 끝 스트림 이름, `minHeight` 기본 12 px). `Date`·날짜 문자열 x는 시간 축이 됩니다.
- 호버하면 그 x의 모든 스트림과 합계를 툴팁에 나열하고(`ctx.chartType === 'themeRiver'`) 포인터 아래 스트림을 강조합니다. 범례 토글은 기준선을 다시 계산합니다. 줌·이동, `appendAreaData` 스트리밍, 접근성 요약·데이터 표·키보드, CSV·SVG 내보내기, React·Vue `type: 'themeRiver'`, `themeRiverSeries` 변환을 지원합니다. 예제 `line/13-theme-river`, fixture `theme-river`.

### 추가 — 내장 문구 다국어(영어 · 한국어 · 중국어 간체)

- 접근성 요약·키보드 도움말·스크린 리더 안내, 데이터 표 제목·머리글·CSV 머리글, 기본 툴팁, 범례·브레드크럼·컬러바 라벨, 기본 시리즈·값 이름, PDF 기본 제목이 차트 로캘을 따릅니다. 로캘 순서: 차트 `locale` → SDK 로캘(`create({ locale })`·`setLocale`) → `<html lang>` → `navigator.language`. `ko*`는 한국어, `zh*`는 중국어 간체, 그 외는 영어입니다.
- `registerMessages(locale, messages)`로 문구를 덮어쓰거나 언어를 추가하고, `getMessages`·`resolveLanguage`·`CHARTURBO_LANGUAGES`·`CharturboMessages` 타입으로 조회합니다.
- `setLocale`이 접근성 문구, 범례 `aria-label`, 컬러바, 비즈니스·계층 차트의 기본 이름(범례·상태·루트·기타)까지 바로 갱신합니다. 다른 차트의 기본 시리즈 이름은 다음 렌더링부터 바뀝니다.
- PDF 제목의 비ASCII 문자를 UTF-16으로 기록해 한국어·중국어 제목이 사라지지 않습니다.
- 문서 사이트(VitePress, `docs/`)를 3개 언어로 추가했고, 예제 사이트에 언어 선택을 추가했습니다.

### 변경 — 영어 출력

- 숫자가 `en-US` 고정이 아니라 차트 로캘로 형식화됩니다(로캘이 없으면 페이지·브라우저 언어).
- 산점도 기본 시리즈 이름이 0부터가 아니라 1부터 셉니다(`Series 1`).
- 박스 플롯 백분위 수염 서수(`1th` → `1st`), OHLC 키보드 도움말과 데이터 표 제목(`OHLC chart data`), 파이 기타 항목 툴팁(`and 2 more`), 콤보 설명(`bars stacked to 100%`)을 고쳤습니다.
- 콤보·선·막대 점의 `getNodeDetails().metadata.description`이 항상 한국어였던 문제를 고쳐 로캘을 따릅니다.

### 추가 — 선 구간 색칠 · 막대 배경 · 라벨 회전 · 회귀선 (병렬 구현)

- 선 · 영역 `pieces` / `piecesBy`(ECharts piecewise `visualMap`): 값 구간마다 색. 경계를 지나는 지점에서 선분을 잘라 색이 경계값에서 정확히 바뀌고, 영역은 경계 띠로 잘라 채웁니다. 예제 `line/12-pieces`, fixture `line-pieces` · `area-pieces`.
- 막대 `background`(ECharts `showBackground`): 값 축 전체 길이의 배경 트랙. 기본은 테마 `baseline` × 0.2 알파. 예제 `bar/04-background`, fixture `bar-background` · `bar-background-horizontal`.
- 막대 값 라벨 `labels.rotate`, x축 라벨 `axes.x.labelRotate`: 회전된 상자로 배치 · 충돌 판정 · 솎기를 하고 아래 여백이 늘어납니다. 회전한 카테고리 이름은 줄이지 않습니다. 예제 `bar/05-label-rotation`, fixture `bar-label-rotation`.
- 산점도 `trendline`(ECharts ecStat): 선형 · 지수(y 가중 로그 최소제곱) · 로그 · 다항식(2~6차, Givens QR) 회귀선과 R², 범례 수식, `getScatterTrendlines()`. 예제 `scatter/06-trendline`, fixture `scatter-trendline`.
- WASM 추가: `set_line_series_pieces`, `chart_line_piece_color`, `set_chart_bar_background`, `set_bar_label_boxes`, `set_bar_axis_label_rotation`, `set_chart_scatter_trendlines`, `chart_scatter_trend_fits`. 기존 시그니처는 그대로이며 SDK와 WASM을 함께 재빌드해야 합니다.

### 수정

- 배경 트랙 수가 다른 막대 차트로 바뀔 때 업데이트 애니메이션이 트랙과 막대를 짝지어 보간하던 문제: 트랙 수가 다르면 등장 애니메이션으로 그립니다.
- 단일 시리즈 막대 · 폭포 차트에서 `legend.position` / `overflow`가 무시되던 문제.

### 추가 — 산점도 지터

- `ScatterChartOptions.jitter: { x, y, seed }`: ggplot2 `geom_jitter`처럼 데이터 단위 균등 오프셋으로 겹친 점을 흩뜨립니다. 점마다 고정(PCG 해시)이라 다시 그려도 같고, hover · 브러시가 흩뜨린 위치를 따르며 툴팁 · 표는 원래 값입니다.
- WASM `set_chart_scatter_jitter(x, y, seed)`를 추가했습니다.
- 예제 `scatter/05-jitter`, WebGPU/WebGL2 fixture `scatter-jitter`를 추가했습니다.

### 추가 — 산점도 파동 효과

- `ScatterChartOptions.ripple`(ECharts `effectScatter`): 선택한 시리즈의 점 뒤로 커지며 사라지는 고리(`period` · `scale` · `count` · `fill`). 점 셰이더가 그리고 매 프레임 점 uniform의 시간만 갱신합니다.
- 파동이 보일 때만 도는 프레임 루프(`chart-effect.ts`)를 추가했습니다. 차트가 바뀌면 스스로 멈추고, `prefers-reduced-motion`이면 정지 프레임입니다. `sdk.setEffectTime(seconds | null)`로 특정 시점에 고정할 수 있습니다.
- WASM `set_chart_scatter_ripple` · `set_chart_effect_time`을 추가했고 점 uniform이 1072 → 1088바이트가 되었습니다(`effect`). SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `scatter/04-ripple`, WebGPU/WebGL2 fixture `scatter-ripple`(1초 시점 고정)을 추가했습니다.

### 추가 — 산점도 심볼 모양

- `ScatterChartOptions.symbol` · `seriesSymbols`: 시리즈마다 원 · 사각형 · 마름모 · 삼각형 점. 모양은 점 인스턴스의 시리즈 슬롯 칸에 함께 실려 업로드 크기가 같고, 원은 이전과 같은 픽셀입니다.
- hover 마커 · SVG 내보내기 · 범례 견본이 같은 모양을 씁니다.
- WASM `set_chart_scatter_shapes(shapes)`를 추가했습니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `scatter/03-symbols`, WebGPU/WebGL2 fixture `scatter-symbols`를 추가했습니다.

### 추가 — 범례 위치 · 페이지 넘김

- `legend.position: 'top' | 'bottom' | 'left' | 'right'`: 범례를 플롯의 원하는 쪽에 두고 그쪽 여백을 잡습니다. 왼쪽 · 오른쪽은 가장 긴 이름에 맞춘 세로 열입니다.
- `legend.overflow: 'scroll'`(기본): 한 줄(또는 한 열)에 들어가지 않는 항목은 ‹ n / m › 버튼으로 넘깁니다. 예전에는 줄바꿈된 범례가 플롯을 덮었습니다. `'wrap'`은 예전 동작입니다. 페이지 밖 항목은 `display: none`이라 포커스 · 내보내기에서 빠집니다.
- 예제 `line/11-legend-paged`, WebGPU/WebGL2 fixture `legend-right-paged` · `legend-bottom-paged`를 추가했습니다.

### 추가 — 생키 세로 방향 · 그라데이션 링크 · 단계 스타일

- `SankeyChartOptions.orient: 'vertical'`: 같은 d3-sankey 배치를 흐름 좌표에서 계산하고 화면에서 x · y를 바꿉니다. hit test · 키보드 · 노드 사각형 · 라벨(막대 아래/위, 가운데 정렬)이 모두 따라갑니다.
- `linkColor: 'gradient'`: 리본이 출발 노드 색에서 도착 노드 색으로 바뀝니다.
- `levels: [{ column, color?, linkOpacity? }]`: 열마다 노드 색과 나가는 링크의 불투명도를 정합니다.
- WASM `set_sankey_chart`의 `options`에 `orient` · `label_width_px`를 추가하고, 마지막 인자 `levels`(단계마다 6개 값)를 추가했습니다. 라벨 flags ±2는 세로 배치(아래/위)입니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `hierarchy/04-sankey-vertical`, WebGPU/WebGL2 fixture `sankey-vertical-gradient`를 추가했습니다.

### 추가 — 파이 다중 고리 (중첩 파이)

- `renderPieChart({ rings: [...] })`로 여러 고리를 그립니다. 퍼센트 · 각도 · "Other" 접기 · 라벨 방식은 고리별로 계산하며, 같은 이름의 조각은 고리를 넘어 색 · 범례 항목 · 강조를 공유합니다. React/Vue `type="pie"`도 같은 데이터를 받습니다.
- 툴팁(`ctx.slice.ring`) · 데이터 표 · 키보드 안내에 고리 이름을 붙입니다. 요약은 고리 수를 말하고 합계는 생략합니다.
- WASM `set_pie_chart`에 마지막 인자 `rings`(고리마다 6개 값) · `groups`(값마다 그룹 id)를 추가했고, `chart_pie_slices`는 조각마다 9개 값(마지막이 고리)을 돌려줍니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `pie/06-nested`, WebGPU/WebGL2 fixture `pie-rings`를 추가했습니다.

### 추가 — 파이 둥근 모서리

- `PieChartOptions.cornerRadius`(CSS px)를 추가했습니다. 모서리 원은 안쪽으로 민 가장자리와 호에 접하며(d3-shape 작도), 얇은 조각·고리에서는 겹치지 않도록 줄어듭니다. 파이 중심은 뾰족하게 유지합니다.
- 길이가 다른 두 경계선을 꼭짓점 손실 없이 잇는 삼각 분할을 추가했습니다. 기존 뾰족한 경로는 바뀌지 않았습니다(기존 pie·donut·sunburst·gauge 화면 차이 0%).
- WASM `set_pie_chart`에 마지막 인자 `corner_radius_px`를 추가했습니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `pie/05-pad-angle`을 `pie/05-rounded`(둥근 모서리 + 각도 간격)로 바꾸고, WebGPU/WebGL2 fixture `pie-rounded`를 추가했습니다.

### 추가 — 파이 조각 각도 간격

- `PieChartOptions.padAngle`(도, 기본 0, 최대 45)을 추가했습니다. 기존 2px 간격 위에 각도 간격을 더하며, 각도 · 퍼센트 · hit test는 바뀌지 않습니다.
- WASM `set_pie_chart`에 마지막 인자 `pad_angle_deg`를 추가했습니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `pie/05-pad-angle`, WebGPU/WebGL2 fixture `pie-pad-angle`를 추가했습니다.

### 추가 — 파이 부분 원 (반 도넛)

- `PieChartOptions.endAngle`을 추가했습니다. 조각이 `startAngle`~`endAngle` 범위를 `direction` 방향으로 나눠 가지며, 화면은 범위의 bbox에 맞춰 잡습니다. 생략하면 기존처럼 한 바퀴입니다.
- WASM `set_pie_chart`에 마지막 인자 `end_angle_deg`(NaN = 한 바퀴)를 추가했습니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `pie/04-half-donut`, WebGPU/WebGL2 fixture `pie-half-donut`를 추가했습니다.

### 추가 — 파이 나이팅게일 로즈

- `PieChartOptions.rose: 'radius' | 'area'`를 추가했습니다. 조각 넓이(도넛은 고리 넓이)가 값에 비례하도록 반지름을 정합니다. `'area'`는 같은 각도, `'radius'`는 비율 각도입니다. 퍼센트는 합계 대비 비율로 유지합니다.
- hit test · 키보드 위치 · 안쪽 라벨 · 바깥 지시선 시작점이 조각마다의 반지름을 따릅니다. 로즈는 도넛 중앙 라벨이 기본으로 꺼집니다.
- WASM `set_pie_chart`에 마지막 인자 `rose`(0 없음 · 1 radius · 2 area)를 추가했습니다. SDK와 WASM을 함께 재빌드해야 합니다.
- 예제 `pie/03-rose`, WebGPU/WebGL2 fixture `pie-rose`를 추가했습니다.

### 추가 — Surface3D 등고선

- `Surface3DSeries.contours`(`show`·`levels`·`color`·`width`·`opacity`)를 ChartGPU v0.4.0 기본값·의미와 맞춰 추가했습니다. 개수 levels는 색상 범위 안쪽을 균등 분할하며 스트리밍 갱신마다 다시 계산합니다.
- 렌더링하는 삼각형 위에서 등고선을 생성해 hole·고정 축·aspect·직교 투영과 일관됩니다. 깊이 테스트하는 1px hairline 전용 파이프라인을 쓰고, 3D 면에 표준 polygon offset을 적용해 같은 평면 선의 깨짐을 없앴습니다.
- WASM `set_chart_3d`·`update_chart_3d_series`에 packed contours 인자를 추가했습니다 (시리즈마다 `[levelCount, r, g, b, a, ...levels]`). SDK와 WASM을 함께 재빌드해야 합니다.
- React/Vue 전달 검증, 재생 제어 예제, 원근·직교 WebGPU/WebGL2 fixture를 추가했습니다. 테스트 alias가 공백이 있는 경로에서도 동작하도록 수정했습니다.

### 추가 — 3D 축 범위 · 비율 · 직교 투영

- `axes3d.x/y/z`의 고정 범위·이름·눈금 수·표시 여부, `aspect: 'cube'|'data'|[x,y,z]`를 제공합니다. 데이터 단위·사용자 비율을 geometry·격자·라벨·피킹에 일관되게 적용하며 고정 범위는 스트리밍에도 유지됩니다.
- `camera.type: 'orthographic'`·`orthoSize`, 평행 광선 피킹·줌·resize 상태 유지와 `getCameraState()`의 투영 정보를 추가했습니다. 다른 차트로 전환할 때 perspective로 복원합니다.
- 0 눈금의 부동소수점 잔차와 작은/큰 수의 긴 라벨을 수정하고, React/Vue 옵션 전달·비교 데모·양 GPU 직교 fixture를 추가했습니다.
- TypeScript 자체 패키지 참조를 소스에 연결해 빌드 산출물이 없는 CI의 타입 검사를 수정했습니다.

### 추가 — 3D 스트리밍 · 표면 갱신

- `appendPointCloud3D`로 XYZ·scalar 색상 청크 추가와 `maxPoints` FIFO를 지원합니다.
- `updateSurface3D`로 높이 전체 교체, column-major 열·row-major 행 추가, 고정 창 스크롤 또는 그리드 확장을 지원합니다.
- 검증 후 원자적으로 반영하며 카메라·스타일·범례 상태를 유지합니다. ID·축 범위·색상·피킹·접근성·CSV를 갱신하고 오래된 툴팁을 해제합니다.
- React/Vue SDK ref 사용 검증과 재생 제어가 있는 예제 2개, 기존 이미지와 스트리밍 결과의 WebGPU/WebGL2 동등성 fixture를 추가했습니다. 현재는 유지 데이터 복사·geometry 재생성 경로이며 부분 GPU 업로드 최적화는 후속 범위입니다.

### 추가 — PointCloud3D · Surface3D 기본 경로

- `renderPointCloud3D`·`renderSurface3D`, React/Vue `type="pointCloud3d"`·`type="surface3d"`를 추가했습니다.
- XYZ billboard와 Y-up row-major surface를 전용 깊이 처리로 렌더링합니다. scalar 색상, grid hole, wireframe, 조명, 시리즈 가시성·강조, orbit/pan/zoom을 지원합니다.
- 원본 XYZ 툴팁·키보드·CSV, surface ray intersection, SVG raster fallback, 예제 3개와 WebGPU/WebGL2 fixture를 연결했습니다. 투명도 0 표면의 선택·렌더와 resize 시 카메라 초기화를 수정했습니다.
- 전체 교체 API에 더해 위 스트리밍·축·투영 API를 제공합니다. 정확한 투명면 합성 등은 후속 범위입니다. 자세한 계약은 `docs/ko/charts/scientific-3d.md`를 참조하세요.

### 추가 — 독립 ErrorBar · Impulse

- `renderErrorBarChart`·`renderImpulseChart`, React/Vue `type="errorBar"`·`type="impulse"`를 추가했습니다.
- 절대/상대/비대칭 오차, 수평/수직, 단측 경계, CSS px/퍼센트 캡, 캡·연결선·마커 표시, baseline과 0길이 impulse를 지원합니다. 독립 샘플은 선 LOD로 생략하지 않습니다.
- 실제 줄기/캡 hover, 데이터 구간 brush, 키보드 접근성·CSV·벡터 SVG, 세 가지 예제와 양 GPU backend fixture를 연결했습니다.
- 전체 채널 교체로 갱신하며 단일 채널 streaming은 거부합니다. 작은 resize에서 CSS 캡 길이를 유지하고 수평 경계를 포함한 X축 범위·줌 한계를 재계산합니다.

### 추가 — 독립 Band 차트

- `renderBandChart(series, options)`와 React/Vue `type="band"`: 두 경계만으로 범위 채우기, 경계별 선 두께, 경계 교차 보존, 결측 쌍의 gap/연결을 지원합니다.
- 두 경계의 극값과 픽셀 버킷 내부 결측을 보존하는 네이티브 LOD, 범위 기반 hover/brush, 줌·팬·시간축·오른쪽 축·범례·벡터 SVG를 연결했습니다.
- 키보드 툴팁·접근성 요약·두 경계 CSV, 10만 쌍·교차 곡선 예제와 WebGPU/WebGL2 시각 회귀 fixture를 추가했습니다.
- 데이터 교체는 두 경계를 함께 `renderBandChart`로 전달합니다. 단일 채널 스트리밍 API는 독립 Band에서 거부합니다.

### 추가 — 독립 OHLC 차트

- `renderOhlcChart(data, options)`와 React/Vue `type="ohlc"`를 추가했습니다. 고가–저가 세로선과 왼쪽 시가·오른쪽 종가 틱을 그리고 `{ barCount }`를 반환합니다.
- `lineWidth`·`tickWidth`, 거래량 패널, 시간축·줌·팬, 픽셀 컬럼 OHLC 집계, 브러시 선택, 키보드 접근성·CSV·벡터 SVG를 지원합니다.
- 툴팁·선택의 종류는 `'ohlc'`이며 잘못된 배열 길이·시간축과 미지원 backend는 기존 차트를 지우기 전에 거부합니다.
- 금융 차트 예제에 5만 개 OHLC bar 데모를 추가했습니다.
- 확대 구간 경계의 부동소수점 오차로 마지막 금융 샘플의 키보드 툴팁이 누락되는 문제를 수정했습니다.

### 추가 — Area 스트리밍 · 제품 랜딩

- overlap 영역의 시리즈별 교체·추가와 `appendAreaData(chunks, options)` 원자적 batch append를 지원합니다. 누적·100% 누적 영역은 정렬 검증 후 함께 갱신하며 FIFO·줌·가시성을 보존합니다.
- 스트리밍 후 percent 툴팁의 오래된 값 참조와 숨긴 시리즈를 다시 표시할 때 누적 영역이 잘리는 문제를 수정했습니다.
- 정적 제품 랜딩과 실제 SDK 스트리밍 hero를 추가했습니다. 지연 로딩, Play/Pause, reduced motion, 화면 밖·숨겨진 탭 정지, GPU 실패 시 정적 preview를 지원합니다.
- 기존 갤러리는 `gallery.html`로 이동하고 area 스트리밍 실행 예제를 추가했습니다.

### 변경 — Charturbo 리브랜딩

- 제품명을 **Charturbo**, npm 패키지명을 `charturbo`로 변경합니다.
- 코어 API는 `import { Charturbo } from 'charturbo'`와 `Charturbo.create(canvas)`를 사용합니다.
- 기존 `Viz*` 타입·보조 API는 `Charturbo*`로, `VIZ_THEMES`는 `CHARTURBO_THEMES`로 변경합니다.
  React·Vue는 `charturbo/react`, `charturbo/vue`의 `CharturboChart`와 `useCharturboChart`를 사용합니다.
- Rust 크레이트와 WASM 파일은 `charturbo-core`, `charturbo_core_bg.wasm`으로 변경합니다.
- 문서·데모·벤치마크 표시명을 통일합니다. 원본 측정의 `viz`·`vizgpu` 식별자는 기록 연결을 위해 유지합니다.

### 수정 — 데모 공통 테마 선택

- 갤러리와 모든 예제 페이지의 상단에 Dark / Light / Midnight / Paper 선택을 표시합니다.
- 페이지와 실제 차트에 함께 적용하고 페이지 이동·새로고침 후에도 유지합니다.
  React·Vue·스파크라인과 3D Scene 디자인 패널도 같은 테마를 사용합니다.

### 추가·개선 — 그래프 물리

- CPU Barnes-Hut 탐색에서 질량 중심 캐시와 스택 없는 DFS 레코드를 사용합니다.
- `supportsGpuPhysics()`와 `stepPhysicsAsync()`를 추가했습니다. WebGPU 반발력 + CPU 스프링·적분·공간 인덱스의 선택적 하이브리드 경로이며, WebGL2에서는 CPU로 폴백합니다.
- 비동기 완료 후 좌표 조회·피킹이 갱신된 위치를 사용합니다. 중복 비동기 호출과 데이터/힘 설정 변경으로 오래된 결과, dispose 후 결과 적용을 거부합니다.
- Apple M1에서 100k 노드 물리 시간 310.30→41.87 ms, FPS 3.5→19.6을 측정했습니다(GPU 왕복 포함). 자세한 조건은 `docs/ko/contributing/benchmarks.md`를 참고하세요.
- cosmos 벤치마크의 프레임당 중복 물리 실행을 수정하고, 대시보드에는 시나리오별 CPU·하이브리드 GPU 중 FPS가 높은 모드를 Charturbo 한 항목으로 표시합니다(동률이면 물리 시간이 짧은 모드).

### 추가 — 3D 데모 디자인 설정

- 3D Scene 페이지에서 Dark / Light / Midnight / Paper 테마, 팔레트·강조 색상, 재질,
  조명 밝기와 격자·좌표축을 실시간으로 바꿀 수 있습니다.
- 설정은 강체·재질 데모에 함께 적용되며, 물체 추가·장면 Reset·다음 방문에도 유지됩니다.
  디자인 초기화로 기본값을 복원할 수 있습니다.

### 수정 — 3D 강체 회전

- 충돌 접촉점과 관성모멘트로 회전 충격량을 계산해, 비껴 맞은 물체와 기울어진 상자가 자연스럽게 회전합니다.
- 접촉점 마찰로 공의 미끄러짐이 구르기로 전환되며, 움직이는 kinematic 표면의 속도도 반영합니다.
- 다중 접촉점과 서브스텝으로 상자 쌓기를 안정화하고, 월드 좌표계 각속도를 쿼터니언으로 적분합니다.
  `stepPhysics()`의 반환 에너지에는 회전 운동에너지도 포함됩니다.
- 강체 데모는 초기 회전 속도 없이 충돌로 생기는 회전을 보여줍니다. 원기둥과 커스텀 메시의 충돌체는
  여전히 경계 상자 근사이므로, 원기둥의 곡면 구르기는 정확히 표현하지 않습니다.

## [0.1.0] - TODO: 배포일 (YYYY-MM-DD)

첫 공개 릴리스입니다. Rust(`crates/charturbo-core`)가 데이터 처리 · 레이아웃 · LOD · hit-test를 맡고,
TypeScript SDK는 WebGPU(WebGL2 폴백) 캔버스와 DOM 오버레이(라벨 · 범례 · 툴팁)만 다룹니다.

### 추가 — 차트

- **선 · 영역** (`renderLineChart`, `renderAreaChart`): 픽셀 열 단위 M4 데시메이션(1M+ 포인트, 스파이크 보존),
  일정한 px 두께의 안티앨리어싱 선, 겹침 / 누적 / 100% 누적 영역, 실제 x 값 · 시간 축(달력 눈금),
  마커 · 점선 · 곡선(`monotone` / `step*`) · 결측값 정책(`gap` / `connect` / `zero`) · 오차 범위 밴드.
- **막대** (`renderBarChart`, `renderGroupedBarChart`): 그룹 / 누적 / 100% 누적, 가로 막대, 데이터 라벨
  (Rust 충돌 판정), 오차 막대, 2D / 3D 모드.
- **산점도 · 버블** (`renderScatterChart`): GPU 인스턴싱(1회 업로드), x/y 줌 · 팬, 그리드 해시 hover.
- **캔들스틱** (`renderCandlestickChart`): 거래량 패널, 2px 미만 캔들의 픽셀 열 OHLC 집계.
- **히스토그램** (`renderHistogram`): Rust O(n) 구간화(Freedman–Diaconis / Sturges / 고정).
- **히트맵** (`renderHeatmap`): R32Float 텍스처 + 256색 LUT, 컬러바, 컬러맵 · 도메인 실시간 변경.
- **박스 플롯 · 바이올린** (`renderBoxPlot`): 선택 알고리즘 사분위, Tukey / min·max / 백분위 수염, KDE 바이올린.
- **파이 · 도넛** (`renderPieChart`): "Other" 접기, 바깥 라벨 · 지시선 배치, 중앙 합계 라벨.
- **콤보** (`renderComboChart`): 막대 + 선 + 영역을 한 플롯에, 선택적 오른쪽 y축.
- **레이더 · 게이지 · 퍼널 · 워터폴** (`renderRadarChart`, `renderGauge` / `setGaugeValue`,
  `renderFunnelChart`, `renderWaterfallChart`): 상태 밴드(색 + 아이콘 + 라벨), 전환율, 소계.
- **트리맵 · 선버스트 · 생키** (`renderTreemap`, `renderSunburst`, `renderSankey`): squarified / 방사형 /
  d3-sankey 방식 레이아웃을 Rust에서 계산, 클릭 드릴다운 · 브레드크럼.
- **스파크라인** (`renderSparkline`): line / area / bar / win-loss, 마지막 · 최소 · 최대 마커와 기준 밴드.

### 추가 — 상호작용 · 데이터

- 툴팁(정렬 · 공유 · 클릭 고정 · 값 형식), crosshair / 마커 hover 스타일, 범례 토글 · 강조.
- 휠 / 드래그 / 핀치 줌 · 팬, y축 줌, 박스 줌, 줌 기록(undo / redo), 범위 네비게이터(미니맵).
- 브러시 선택(`'x'` / `'xy'`)과 `select` 이벤트, 주석(기준선 · 구간 · 점 · 텍스트).
- 실시간 스트리밍(`appendSeriesData` + `maxPoints` 슬라이딩 창), y축 autoscale(`all` / `visible` / `none`).
- 로그 · 반전 축, 이중 y축, 대시보드 커서 · 줌 동기화(`Charturbo.connect`, `sync` 옵션).
- 이벤트 API(`sdk.on` / `off`: `hover`, `click`, `select`, `rangechange`, `legendtoggle`, `themechange`,
  `resize`, `drill`).
- 터치 · 펜 제스처(핀치 줌, 관성 팬, 탭 툴팁, 길게 눌러 스크럽).

### 추가 — 표시 · 접근성 · 내보내기

- 테마(`dark` / `light` / 사용자 `CharturboTheme`), 색각 이상 검증 팔레트, CSS 색 문자열 입력(`ColorInput`).
- d3-format 스타일 숫자 형식(`'.2s'`, `'$,.2f'`, `'compact'`, `'bytes'` 등)과 `Intl` 옵션, 로캘 · 시간대(IANA,
  기본 `'local'`) 지원.
- 접근성: 자동 요약 `aria-label`, 시각적으로 숨긴 긴 설명, 데이터 테이블 / CSV, 모든 차트 종류의 키보드 탐색,
  고대비 모드.
- PNG / JPEG / WebP 이미지(`toImage`, DOM 라벨 포함), 벡터 SVG(`exportChartSVG`), 1페이지 PDF(`toPDF`),
  클립보드 복사.
- 옵트인 애니메이션(enter / update 트윈, Rust에서 staged 마크만 보간, `prefers-reduced-motion` 존중).

### 추가 — 플랫폼 · 패키징

- `Charturbo.create`의 타입 있는 초기화 오류(`CharturboInitError`: `no-webgpu` / `adapter` / `device` / `wasm`),
  `isSupported`, 캔버스 자동 리사이즈(DPR 변경 포함).
- 공유 GPU 디바이스(`CharturboDevice`): 차트 수십~수백 개 페이지(WebGL 컨텍스트 한도 회피).
- React / Vue 컴포넌트(`charturbo/react`, `charturbo/vue`: `CharturboChart`, `useCharturboChart`), SSR에서 import 안전.
- 3D 그래프 · 임베딩: Barnes-Hut 포스 레이아웃, 고차원 임베딩 투영(PCA / JL) + 코사인 k-NN, 노드 검색 · 최단 경로,
  범용 3D 도형 · 강체 물리.
- 배포 형식: ES 모듈(WASM을 별도 `charturbo_core_bg.wasm` 파일로, 번들러가 에셋으로 처리) ·
  `charturbo/inline`(WASM base64 내장) · UMD(`<script>` 태그, WASM 내장, `require`) · `.d.ts`
  (`moduleResolution` `bundler` / `node16` / `nodenext` / `node10` 및 CJS `.d.cts`).
- `setWasmSource(url | Response | bytes | WebAssembly.Module)`: CDN 등 다른 위치에서 WASM 로드.
- TypeDoc API 문서(`npm run docs`), 예제 사이트(`npm run examples:dev` / `examples:build`).

[Unreleased]: TODO: <repository URL>/compare/v0.1.0...HEAD
[0.1.0]: TODO: <repository URL>/releases/tag/v0.1.0