한글스크립트 0.8 문법
문장형이 유일한 기본 문법입니다. 시작 표기 없이 첫 문장부터 작성합니다.
키워드형과 .ks 입력은 제거됐습니다. 소스는 .hgs, 기본 빌드는 JavaScript와 .d.ts입니다.
문장 블록은 공백 들여쓰기를 사용합니다. 탭과 여러 줄 표현식은 지원하지 않습니다.
#로 시작하는 행은 주석입니다. 행 끝 주석은 지원하지 않습니다.
값·함수·조건·반복
이름은 "하늘"이다
점수: 숫자는 90이다
기준은 80으로 고정한다
인사(누구: 문자열)를 정의한다:
돌려주기 "안녕, " + 누구
각 수를 범위(3)에서:
만약 수 == 1 이라면:
계속하기
출력(인사(이름), 수)
동안 점수 < 100:
점수 = 점수 + 1
만약 점수 == 95 이라면:
멈추기
| 기능 | 문장 |
|---|---|
| 변수 | 이름은 값이다, 재대입은 이름 = 값 |
| 타입 있는 변수 | 점수: 숫자는 90이다 |
| 고정값 | 기준은 80으로 고정한다 |
| 함수 | 더함(가: 숫자, 나: 숫자)를 정의한다: |
| 반환 | 돌려주기 값, 값 없이도 가능 |
| 조건 | 만약 식 이라면: / 아니고 식 이라면: / 아니면: |
| 반복 | 각 항목을 목록에서: / 동안 식: |
| 반복 제어 | 멈추기 / 계속하기 |
은·는과 을·를은 둘 다 허용합니다. 타입 없는 인자는 any, 빈 목록 선언은 any[]가 됩니다.
타입은 숫자, 문자열, 논리(또는 불리언), 모름, 아무거나, 무효를 사용하거나 TypeScript 타입 표현식을 작성할 수 있습니다.
표현식은 JavaScript 연산자·배열·객체·정규식·템플릿 문자열을 사용합니다.
참, 거짓, 비어있음, 정의안됨은 리터럴입니다. 문자열·주석·속성 이름은 치환하지 않습니다.
JS 전역 Math, JSON, Map, Set, Date, Error 등은 원래 이름으로 사용합니다.
임의의 JS/TS 선언·중괄호 블록을 소스로 작성하는 문법은 지원하지 않습니다.
선택과 한 번 이상 반복
상태는 "완료"이다
상태에 따라:
"준비"인 경우:
출력("준비 중")
"완료"인 경우:
출력("끝")
그 밖의 경우:
출력("알 수 없음")
횟수는 0이다
먼저 실행한다:
횟수 = 횟수 + 1
횟수 < 3인 동안 반복한다
선택 분기는 다음 분기로 넘어가지 않습니다. 그 밖의 경우:는 기본 분기입니다.
모듈
"./math.js"에서 { 더함 }을 가져온다
"./settings.js"에서 설정을 가져온다
계산(값: 숫자)를 정의한다:
돌려주기 더함(값, 설정.기준)
계산을 공개한다
여러 이름은 { 계산, 더함 }을 공개한다, 기본 내보내기는 계산을 기본으로 공개한다로 작성합니다.
가져오기·공개 문장은 최상위에서만 사용합니다. CLI는 진입 폴더 안의 상대 경로 .hgs 모듈 그래프를 검사하고 모듈별 .js·.d.ts를 생성하며 가져오기 경로를 .js로 바꿉니다. 번들 하나로 묶거나 자산을 복사하지 않으며 진입 폴더 밖 .hgs 의존성은 지원하지 않습니다.
React·Vue의 Vite 플러그인은 .hgs import를 빌드할 때 처리합니다.
비동기·생성기·오류 처리
비동기로 계산(값: 숫자)를 정의한다:
결과는 기다리기 Promise.resolve(값 * 2)이다
돌려주기 결과
차례로 목록()를 정의한다:
내주기 1
내주기 2
시도한다:
오류를 일으킨다 새 Error("입력을 확인하세요")
오류를 잡으면:
출력(String(오류))
마지막으로:
출력("마침")
기다리기는 비동기 함수의 식 맨 앞에 사용합니다. 내주기는 차례로 정의한 함수 안에서 사용합니다.
브라우저 데모는 네트워크·외부 모듈을 제공하지 않습니다. 모듈과 외부 API 연동은 로컬 프로젝트에서 사용하세요.
클래스·자료형·제네릭
사람 클래스를 정의한다:
이름: 문자열은 ""이다
생성할 때(이름: 문자열):
자신.이름 = 이름
소개()를 정의한다:
돌려주기 자신.이름
별명을 읽으면:
돌려주기 자신.이름
별명을 바꾸면(값: 문자열):
자신.이름 = 값
사람을 이어받아 학생 클래스를 정의한다:
생성할 때(이름: 문자열):
부모(이름)
사용자는 새 학생("하늘")이다
출력(사용자.소개())
상자<T> 자료형을 정의한다:
값: T
숫자상자 타입은 상자<숫자>이다
상태 열거값을 정의한다:
준비
완료
복사<T>(값: T)를 정의한다:
돌려주기 값
자료형·타입 별칭·열거값은 최상위에 작성합니다. 클래스의 추상·접근 제한자·데코레이터 및 전체 TypeScript 문법은 지원 범위가 아닙니다.
기본 함수와 표준 기능
| 함수 | 의미 |
|---|---|
출력(...값) |
콘솔 출력 |
길이(값) |
문자열 UTF-16 코드 단위 또는 목록 항목 수 |
추가(목록, 값) |
원본 목록에 추가 |
포함(목록, 값) |
포함 여부 |
나누기(글, 구분자) / 잇기(목록, 구분자) |
문자열 분리·연결 |
다듬기(글) |
양 끝 공백 제거 |
숫자로(값) |
빈 문자열·비유한 숫자는 오류 |
합계(목록) / 평균(목록) |
합계·평균, 빈 평균은 오류 |
최솟값(목록) / 최댓값(목록) |
빈 목록은 오류 |
반올림(값, 자리=0) |
JS Math.round, 자리 -10~10 |
정렬(목록) |
원본을 복사해 숫자 오름차순 정렬 |
범위(끝) / 범위(시작, 끝, 간격) |
끝 제외, 음수 간격 지원, 최대 10만 항목 |
기본 함수 이름은 사용자 선언 이름으로 사용하지 않습니다. JS 부동소수점·반올림 규칙을 따르며 Python 호환·임의 정밀도 십진 연산을 의미하지 않습니다.
화면 함수 5개
숫자입력("이름", 0), 글자입력("이름", ""), 선택입력("이름", ["하나", "둘"], "하나")로 입력값을 읽습니다.
"계산하기" 버튼을 누르면: 뒤의 블록은 해당 버튼을 눌렀을 때 실행합니다.
버튼("이름")도 같은 조건을 반환하며 보여주기("이름", 값)은 이름과 값을 결과 항목으로 등록합니다. 현재 온라인 데모는 이를 콘솔에 표시합니다.
버튼을 누를 때마다 현재 입력값으로 전체 프로그램을 다시 실행합니다. 일반 변수는 실행 사이에 유지되지 않습니다.
이름은 중복할 수 없으며 한 실행당 최대 40개 화면 요소를 제공합니다.
화면 함수는 데모 UI 실행 환경이 필요하며 Node CLI 단독 실행이나 React·Vue 컴포넌트 자동 생성 기능은 아닙니다.
실행·진단 범위
ksc build는 타입 검사 후 JS와 .d.ts를 생성합니다. ksc run은 신뢰하는 로컬 코드를 Node.js에서 실행합니다.
--typescript는 중간 TypeScript 확인용 출력입니다. 별도의 소스 문법 모드가 아닙니다.
웹 데모와 Vite 플러그인은 문법·타입 검사를 수행하며, Vite는 HGS 의존 모듈의 오류도 검사해 빌드를 중단합니다.
문법·타입 진단은 원본 HGS 행과 열로 매핑합니다. 일부 변환 토큰의 열은 근사할 수 있으며 디버거용 정밀 소스맵은 아직 제공하지 않습니다.
임의의 한국어를 해석하는 AI 실행기·Python 호환 언어·전체 JavaScript/TypeScript 대체 언어가 아닙니다.
목록·집합·사전과 문장형 값
0.8.0은 목록·집합·사전·복사·정렬을 포함해 61개 한글 함수를 제공합니다. 타입 자리에서 목록<T>는 Array<T>, 집합<T>는 Set<T>, 사전<K, V>는 Map<K, V>입니다. 목록으로(값)으로 순회 가능한 값을 배열로 바꿉니다.
값 자리에서 「대상을 오름차순으로 정렬한 값」「대상을 내림차순으로 정렬한 값」「대상을 얕게 복사한 값」「대상을 깊게 복사한 값」「대상에서 중복을 제거한 값」을 사용할 수 있습니다. 정해진 문법이며 임의의 산문을 추측하지 않습니다.
향후 문법 제안
자연어 사칙연산·정중 표현·한국어 비교와 Windows 자동화는 별도 설계 제안입니다. 이 문서의 현재 문법에 추가된 지원 기능이 아닙니다.