스피논 구현 상태와 API 명세 대장

기준: 2026-09-28 · 명세 버전: 0.1.0-draft · 현재 제품 지원 완료: 없음

이 문서가 구현 상태의 공식 원본이다. 웹 미리보기의 체크박스는 개인 브라우저에 저장되는 탐색 도구이며 공식 완료 판정이 아니다. 아래 78개 항목은 현재 로드맵과 같은 ID를 사용한다. - [ ]는 미완료이며, PoC가 있어도 제품 API의 지원 완료를 뜻하지 않는다.

스피논 구현 관문 의존 관계: 기초 검증, 첫 앱, 병렬 품질 개선과 생태계, 출시

그림은 전체 계획의 작업 흐름을 요약한다. R·S는 첫 앱 이전의 기초 검증으로 묶었고, E·X의 독립 작업은 병렬로 진행할 수 있다. D로 모이는 화살표는 E·X의 모든 항목이 첫 공식 릴리스의 필수 조건이라는 뜻이 아니다. 첫 공식 릴리스의 범위는 아직 결정하지 않았다. 개별 항목의 완료 여부는 아래 목록에서 판정한다.

완료 표시 규칙

기능 항목을 - [x]로 바꾸려면 구현 코드와 버전 있는 API/인터페이스 명세 링크, 지원 플랫폼·프레임워크 범위, 성공·오류·수명 동작, 사용 예제, 실제 동작 근거를 같은 PR에 넣는다. 명세가 없으면 구현 코드가 있어도 미완료다.
앱 작성자에게 보이는 요소·CSS·JS API·CLI·OTA는 공개 API 명세 목록에 연결한다. 내부 트리·렌더러·V8 경계는 호출자·입출력·소유권·오류가 적힌 인터페이스 명세에 연결한다. 기존 0001~0006 제안 문서는 완료된 API 명세를 대신하지 않는다.
조사·벤치마크·문서화처럼 호출 가능한 API가 없는 항목은 API 해당 없음으로 두되, 판정 기준·산출물과 원본 근거를 연결한 뒤 완료 표시한다.
일부만 구현됐으면 해당 항목을 쪼개 하위 ID를 만들거나 지원 범위를 좁혀 명시한다. PoC, 시뮬레이터 실행, 설계 초안, 단일 플랫폼 결과만으로 세 플랫폼 지원을 체크하지 않는다.
공개 API가 바뀌면 명세·예제·호환성 표·변경 이력도 같은 변경에 포함한다. 미지원 API는 이름과 진단 결과를 기록한다. 상태를 바꾼 PR에는 기기/브라우저, 빌드, 원본 증거를 남긴다.

각 항목의 관련 계약은 현재 제안 명세를 가리킨다. 기능 항목의 API 명세: 미작성은 실제 인터페이스·예제·오류 계약이 아직 게시되지 않았다는 뜻이다.

1. 위험 검증

2. 세 플랫폼 수직 구현

3. 실사용 UI

4. 렌더러·성능

E01 부분 레이아웃 계산 — 오염된 서브트리만 다시 계산하고 관련 프레임만 반영한다. 관련 계약: 0002-ui-tree-events.md · API 명세: 미작성 · 근거: 없음
E02 GPU 텍스트·이미지 품질 — 글리프 캐시, 이미지 업로드, 클리핑·합성의 품질과 메모리 비용을 개선한다. 관련 계약: 0002-ui-tree-events.md · API 명세: 미작성 · 근거: 없음
E03 입력·접근성 통합 검증 — GPU 화면의 IME·선택·스크롤·접근성 의미 트리가 플랫폼 기능과 일치하는지 확인한다. 관련 계약: 0002-ui-tree-events.md · API 명세: 미작성 · 근거: 없음
E04 GPU 프레임 배치 — 변경 명령 병합·자원 재사용·불필요한 GPU 제출 제거를 구현한다. 관련 계약: 0002-ui-tree-events.md · API 명세: 미작성 · 근거: 없음
E05 스레드 스케줄러 — JS·레이아웃·UI 큐와 우선순위, 역압력, 취소 및 입력 응답을 측정하며 정한다. 관련 계약: 0002-ui-tree-events.md · API 명세: 미작성 · 근거: 없음
E06 제스처·애니메이션 — 드래그·스크롤·취소·동시 제스처와 프레임 스케줄러를 연결한다. 관련 계약: 0002-ui-tree-events.md · API 명세: 미작성 · 근거: 없음
E07 장시간·오류 회귀 — 회전, 백그라운드 복귀, 빠른 입력, 누수와 오류 복원을 확인한다. 관련 계약: 0002-ui-tree-events.md · API: 해당 없음 · 산출물: 미완료 · 근거: 없음
E08 시작 시간 최적화 실험 — 번들 사전 변환·V8 코드 캐시·스냅샷의 효과와 버전 호환성을 따로 측정한다. 관련 계약: 0002-ui-tree-events.md · API: 해당 없음 · 산출물: 미완료 · 근거: 없음

5. 프레임워크·도구

6. 배포·출시

D01 네이티브 컴포넌트·WebView — 지도·미디어·카메라·WebView 삽입과 화면 수명주기를 제공한다. 관련 계약: 0003-web-surface.md · API 명세: 미작성 · 근거: 없음
D02 릴리스 스냅샷 매니페스트 — 기능별 진입점·청크 의존성, JS·CSS·폰트·이미지 해시, 엔진·네이티브 API 호환 버전과 서명을 기록한다. 관련 계약: 0004-runtime-build.md · API 명세: 미작성 · 근거: 없음
D03 CLI 배포 명령과 패키징 — 앱 바이너리와 정책상 허용되는 OTA 릴리스를 생성·검증·서명한다. 변경된 청크·에셋만 업로드하고 기능별 채널·대상 집단을 지정한다. 관련 계약: 0004-runtime-build.md · API 명세: 미작성 · 근거: 없음
D04 청크 OTA 설치와 롤백 — 없는 해시의 파일만 다운로드하고 검증된 릴리스 스냅샷을 원자적으로 활성화한다. 기능별 단계적 배포, 실패 감지·자동 중지와 이전 또는 내장 버전 복원을 구현한다. 관련 계약: 0004-runtime-build.md · API 명세: 미작성 · 근거: 없음
D05 OTA 정책·보안 재검토 — 초기 정책 검토 이후 바뀐 기능과 원격 코드·권한 변경 범위를 출시 시점에 다시 확인한다. 관련 계약: 0004-runtime-build.md · API: 해당 없음 · 산출물: 미완료 · 근거: 없음
D06 CI·실기기 회귀 — Android/iOS 빌드, 화면 일치, 입력, 누수, 업데이트/롤백을 반복 검증한다. 관련 계약: 0001-conformance.md · API: 해당 없음 · 산출물: 미완료 · 근거: 없음
D07 최종 네 구현 비교 — React Native·ReactLynx·네이티브 기준 앱과 모든 지원 시나리오를 다시 측정한다. 관련 계약: 0001-conformance.md · API: 해당 없음 · 산출물: 미완료 · 근거: 없음
D08 버전별 명세 사이트 — 저장소 Markdown 명세에서 검색 가능한 HTML 문서를 생성해 API·지원표·예제·마이그레이션·라이선스를 버전별로 공개한다. 관련 계약: README.md · API: 해당 없음 · 산출물: 미완료 · 근거: 없음

기존 PoC의 위치

V8 연동 비교, 동적 UI 트리, 스타일·레이아웃 실험은 위 항목을 구현할 때 참고하는 증거다. 현재 공개 스피논 API의 세 플랫폼 적합성 완료를 증명하지 않는다.

#스피논 구현 상태와 API 명세 대장

#완료 표시 규칙

#1. 위험 검증

#2. 세 플랫폼 수직 구현

#3. 실사용 UI

#4. 렌더러·성능

#5. 프레임워크·도구

#6. 배포·출시

#기존 PoC의 위치