AEUScripts용 스크립트와 네이티브 UI를 만드는 개발자를 위한 문서다. 처음 사용한다면 01 · Developer Guide부터 시작하고, 구현 중에는 AE API와 Native UI 레퍼런스를 참고한다.
AEUScripts는 AEX 안의 QuickJS-NG에서 .aeu를 실행하는 별도 엔진이다. ExtendScript/JSX 또는 ScriptUI 객체 모델과 호환되지 않는다. 이 문서는 현재 구현된 API를 설명한다.
문서 기준
•
갱신일 — 2026-10-03 (Asia/Seoul)
•
문서 상태 — 개발 중인 Windows preview API
•
로컬 배포 label — 0.1.0-preview.6
•
VS Code 확장 — 0.6.1, 최소 대상 VS Code 1.96
•
소스 기준 — ea5c965; native/API 코드는 10월 3일 Release 빌드와 동일
•
호스트 검증 환경 — Windows x64 / AE 26.2.1; SDK 25.6으로 빌드
스크립트 개발자는 C++ SDK를 직접 호출하지 않는다. 확장이 제공하는 공개 타입과 이 문서의 ae/ui 계약을 사용한다.
flowchart LR A[".aeu 원본 + XML"] --> B["VS Code: Build Current Script"] B --> C[".aeuscript/*.aeu 생성 JavaScript"] C --> D["AEUScript.aex / QuickJS"] D --> E["ae: AE 작업"] D --> F["ui: 네이티브 UI"]
Mermaid
복사
지금 만들 수 있는 것
•
활성 컴포지션에 텍스트 레이어 생성 및 현재 Position 읽기/쓰기.
•
XML 컨트롤로 일반 창, modeless dialog, 등록형 도킹 패널 구성.
•
버튼·숫자 드래그 입력·슬라이더·드롭다운과 이벤트 처리, 요소 추가/제거/갱신.
•
TypeScript 편집·빌드, 메타데이터, 로그·오류 위치 매핑.
현재 레이어 열거/선택/검색, 효과·키프레임 편집, 일반 파일/네트워크 접근은 공개 API에 없다. macOS, CEP bridge, .aeux/.aeub, Custom Effect/FXwrapper는 후속 지원이다.
가장 먼저 지킬 계약
1.
원본을 저장하고 빌드한 .aeuscript/*.aeu를 실행한다.
2.
activeComp는 null을 검사하고 AE 객체는 매 실행/이벤트에서 다시 조회한다.
3.
도킹 초기화는 UI 구성만 한다. AE 작업은 이벤트 안에서 실행한다.
4.
transaction은 Undo 그룹이며 오류 시 자동 rollback이 아니다.
5.
도킹 스크립트 ID는 유지하고 새 ID 등록 후 AE를 재시작한다.
검증 범위
문서의 실행 가능한 코드 예제 7개는 2026-10-03 실제 확장 빌드 엔진으로 타입·메타데이터·XML·코드 생성 검사를 통과했다. 이번 문서 작성 중 해당 예제를 AE에서 실행하지는 않았다.
10월 3일 Release의 자동 검사: Release CTest 7/7, 언어/XML/QuickJS 18/18, VS Code 1.96.0 확장 호스트 통과. 새 AEX는 실제 AE에서 재실행 검증하지 않았다. 이전 설치본의 AE 검증과 구분한다. 실제 AE 25.6, macOS, 3D Position, 다양한 DPI/밝은 테마/장시간 사용과 일부 부동 창 입력은 별도 검증 범위다.
읽는 순서
01 시작하기 → 02 AE API → 03 UI API → 04 도킹 → 05 메타데이터 → 06 예제·문제 해결. 문서는 한국어로 설명하며 API 이름과 메뉴 명칭은 실제 표기를 유지한다.
저장소의 공개 타입, docs/QUICKSTART.md, docs/SCRIPT_UI_API.md, docs/DOCKABLE_SCRIPTS.md, docs/SCRIPT_METADATA.md, 실제 바인딩을 대조했다. 로컬 문서 원본은 docs/developer-guide/에 보관한다. 변경 시 코드·타입·예제 검증과 이 문서를 함께 갱신한다.
