한글스크립트의 큰 그림
한글 문장으로 프로그램의 의도를 분명히 쓰고, JavaScript 생태계에서 실행하는 언어를 만듭니다. 현재의 중심은 문장형 소스 → 타입 검사 → JavaScript + 타입 선언입니다. 이 문서는 완료 보고가 아니라 현재 지원 범위와 이후 개발의 기준입니다. 기능 추가만으로 1.0을 선언하지 않습니다.
우리가 꿈꾸는 언어
한글스크립트는 누구나 익숙한 우리말로 생각을 표현하고, 그 생각을 프로그램으로 만들어 갈 수 있는 언어를 꿈꿉니다. 낯선 기호와 딱딱한 표현 앞에서 망설이던 사람도 따뜻한 문장으로 개발의 즐거움을 느낄 수 있도록. 많은 사람에게 오래 사랑받는 언어로, 한 문장씩 함께 만들어 가겠습니다.
최종 목표는 괄호·쉼표·함수 호출 규칙에 익숙하지 않아도 자연스러운 한글 문장으로 프로그램을 작성할 수 있게 하는 것입니다. “3 더하기 5는?”, “1부터 10까지 다 합치면?”, “점수들에서 80 이상인 것들만 골라서 높은 순서로 정리해줘” 같은 표현이 그 방향을 보여줍니다. 이 문장들은 앞으로 설계할 표현의 예시이며, 현재 실행 가능한 문법이 아닙니다.
현재의 문장형 언어를 기반으로 자연스러운 계산·자료 처리 표현을 넓히고, 문장을 조합해 프로그램 전체를 작성하는 방향으로 발전시킵니다. 자유롭게 설명을 덧붙이는 방식도 함께 연구합니다. 따뜻한 표현과 정확한 실행이 함께하도록, 뜻이 모호한 문장은 추측해서 실행하지 않고 어떤 부분을 명확히 해야 하는지 알려주는 것을 원칙으로 삼습니다.
지금의 기반
| 계층 | 현재 제공 | 부분 지원·한계 | 다음 개발 |
|---|---|---|---|
| 문법 | 문장형 선언·함수·분기·반복·모듈·예외·비동기·클래스·타입 | 정해진 문장만 해석. 전체 JS/TS 소스 호환 아님 | 전용 AST, 문법 오류 복구, 더 정밀한 토큰 위치 |
| 타입 | TypeScript strict 기본 검사·제네릭·타입 선언 출력 | any·빈 목록의 검사 제한, 변환 토큰 열은 근사할 수 있음 | 더 나은 기본 추론, 문장별 진단, 명시적인 안전성 규칙 |
| 표준 기능 | 61개 한글 함수: 목록·집합·사전·복사·정렬·숫자·문자열·검증·화면 | 모든 내장 JS API의 한글 별칭은 아님. 일부 원본 변경 함수 존재 | 객체·문자열·날짜 확장, 표준 모듈 분리, 이름 충돌 완화 |
| 실행과 빌드 | Node 등록 로더·CLI·ESM·JS + .d.ts·Vite | 진입 폴더 밖 HGS 의존성 빌드와 자산 복사 미지원 | 프로젝트 빌드·증분 컴파일·watch·정밀한 소스맵 |
| 편집기 | 포맷·진단·타입 정보·정의 이동·스코프 자동 완성·스니펫·ㅎ 아이콘 | 전체 속성 완성·자동 import·참조 찾기·이름 변경·디버거 미지원 | LSP로 기능 분리, 증분 분석, 안전한 리팩터링 |
| 신뢰성 | 문법·실행·타입·문서 예제·프레임워크·실제 편집기 테스트 | 테스트 통과는 모든 입력의 올바름을 뜻하지 않음 | 명세 기반 적합성 테스트·퍼징·회귀·실측 성능 기준 |
| 문서와 배포 | 버전별 변경 내역·함수 계약·예제·npm·Marketplace·CI | 0.x에서 문법과 API가 바뀔 수 있음 | 마이그레이션 도구·릴리스 규칙·1.0 호환성 약속 |
순서대로 만들기
1. 지금 있는 언어를 믿고 사용할 수 있게
함수마다 입력·반환·원본 변경·실패 조건을 일관되게 문서화하고 예제를 실행해 검사합니다. 잘못된 입력과 오류 위치를 회귀 테스트로 남깁니다. 문장형의 모든 조합을 지원한다고 가정하지 않고 지원·부분 지원·미구현을 공개합니다. 현재 0.8 작업은 문서·자료구조·아이콘·배포에 집중합니다.
2. 언어 내부를 확장하기 좋은 구조로
현재 문장·들여쓰기는 규칙 기반 파서로 처리하고 표현식에는 TypeScript AST를 활용합니다. 문장 전체를 나타내는 전용 AST와 범위 정보를 도입한 뒤 문법 검사·타입 연결·출력·포맷을 분리합니다. 이를 기반으로 오류를 여러 개 복구해서 보여주고, 정확한 소스맵과 프로젝트 단위 증분 분석을 만듭니다.
3. 실용적인 개발 환경을 완성하기
편집기의 전체 속성 자동 완성·자동 import·참조와 이름 변경을 LSP에 연결합니다. 프로젝트 설정·증분 빌드·테스트 명령을 제공하고 React/Vue에서 안정적으로 쓰는 예제를 유지합니다. 파일·네트워크·날짜·객체 등은 Node와 브라우저의 권한 차이를 구분한 선택 모듈로 설계합니다.
4. 문장이 탄탄할수록 검사할 수 있는 내용 늘리기
이름과 타입은 등장인물과 사물을, 사전·사후 조건은 세계의 규칙을, 함수와 모듈은 사건과 장면을 표현합니다. 현재는 확인한다로 실행 중 조건을 검사할 수 있습니다. 다음으로 입력 조건·결과 조건·예제 테스트를 더 읽기 쉬운 문장으로 선언하는 방식을 설계할 수 있습니다. 효과가 있는 문법인지 작은 실험과 실제 예제로 먼저 검증합니다.
5. 1.0을 위한 기준 정하기
문법 명세와 표준 API를 고정하고 호환성·폐기 정책을 확정합니다. 핵심 오류 사례, 적합성 테스트, 편집기 기능, 선언 출력, Node·브라우저·프레임워크 연동을 릴리스 기준으로 정합니다. 성능은 환경과 입력 크기를 함께 공개하고 회귀를 추적합니다. 완료되지 않은 항목이 있으면 이름을 붙여 공개합니다.
자연어 문법 확장 설계
자연스러운 한글 문법 확장 제안에 조사·정중 표현·사칙연산·한국어 비교와 조건의 의미 계약을 정리했습니다. 전용 AST와 기존 문법 회귀 검증을 우선하고, 자료 처리와 비동기 표현, 독립 Windows UIA 어댑터는 후속으로 검토합니다. 모든 새 문법은 미구현 제안이며, 0.9·0.10·0.11 표기는 후보 작업 묶음으로 출시 일정이나 지원 사실을 뜻하지 않습니다.
AI와 별도 실행 엔진의 위치
핵심 문법·타입·컴파일·조건 검사에는 AI API가 필요하지 않습니다. 자유로운 산문에서 의도를 추출하는 기능은 선택적인 작성 보조로 실험할 수 있고 로컬 모델도 가능합니다. 생성한 결과도 같은 검사·테스트를 통과해야 합니다. 현재 자유 산문 실행, AI 기반 문장 해석, 자동 정형 증명은 제공하지 않습니다.
JS + .d.ts 경로는 기존 생태계와 타입을 재사용하는 현재의 실행 계약입니다. 독립 VM·바이트코드·네이티브 출력은 별도의 큰 프로젝트이므로 실제 요구와 측정 결과가 생기면 검토합니다. 정식 문서와 지원 도구를 갖추는 데 독립 실행 엔진이 필수인 것은 아닙니다.