JeomLang (점랭)

점 유니코드 문자 16종만으로 프로그래밍하는 난해한 프로그래밍 언어
파일 확장자: .jeom

개요

점랭(JeomLang) 은 유니코드의 “점” 계열 문자만으로 모든 코드를 작성하는 난해한 프로그래밍 언어입니다.
난해하지만 함수 · 재귀 · 배열 · 딕셔너리 · 오류처리 · 람다 · 고차함수 · 모듈을 갖춘 완전한 언어입니다.

단일 엔진 파일(core/engine.js)이 브라우저 웹 IDE와 Node.js CLI를 모두 구동합니다.

파일 구조

jeomlang/
├── core/
│   ├── engine.js          ← 공용 JS 엔진 (렉서+파서+VM, UMD)
│   └── cli.js             ← Node.js CLI
├── ide/
│   ├── index.html         ← 웹 IDE
│   ├── ide.css
│   ├── src/ide.ts         ← TypeScript 소스
│   └── dist/ide.js        ← 빌드 결과
├── home/
│   ├── index.html         ← 메인 페이지
│   ├── index.js
│   └── style.css
├── assets/img/            ← 로고 이미지
├── stdlib/std.jeom        ← 표준 라이브러리
├── examples/              ← 예제 파일
├── docs/                  ← 문서
├── server/                ← 점랭 서버
├── shared/
│   └── custom-elements.js ← 공용 웹 컴포넌트 (<jeom-version>)
└── tools/
    ├── formatter/
    │   └── formatter.py   ← 코드 포맷터
    ├── language-support/  ← 하이라이터, Linguist
    └── vscode-extension/  ← VS Code 확장

빠른 시작

웹 IDE

https://jeomlang.vercel.app/ide 에서 바로 사용할 수 있습니다.

CLI 설치 (Node.js 18+)

npm install -g jeomlang
jeom run hello.jeom

또는 로컬 클론:

git clone https://github.com/minirang/jeomlang.git
cd jeomlang
node core/cli.js run examples/hello.jeom

CLI 명령

jeom run <파일.jeom>          # 실행
jeom check <파일.jeom>        # 문법 검사
jeom repl                     # 대화형 REPL
jeom encode "Hello"           # 문자열 → 점 인코딩
jeom encode-num 42            # 정수 → 점 인코딩
jeom encode-float 3.14        # 소수 → 점 인코딩
jeom decode "•·.·.•"          # 점 코드 → 값
jeom tokens <파일.jeom>       # 토큰 목록
jeom ast <파일.jeom>          # AST 출력
jeom ops                      # 전체 명령 토큰
jeom new <파일.jeom>          # 새 파일 생성
jeom version                  # 버전 확인

점 문자 16종

|기호 |유니코드 |용도 | |:-:|------|-----------------| |.|U+002E|0비트 | |·|U+00B7|1비트 | |˙|U+02D9|함수 관련 | |•|U+2022|숫자 리터럴 구분자 | |․|U+2024|명령 조합 | |‥|U+2025|반복 · 오류 · 소수점 구분자| |…|U+2026|조건 분기 | |‧|U+2027|문자열 바이트 구분자 | |∘|U+2218|변수 | |⋅|U+22C5|산술 · 논리 | |●|U+25CF|문자열 리터럴 구분자 | |◦|U+25E6|배열 · 딕셔너리 | |⦁|U+2981|스택 조작 | |⸳|U+2E33|타입 변환 | |⋮|U+22EE|블록 | |⋯|U+22EF|파일 · 모듈 | |◘|U+25D8|주석 |

리터럴 인코딩

정수: •<이진수>• — .=0, ·=1, big-endian
예: ••=0, •·•=1, •·.·•=5, •·.·.•=10

소수: •<정수부>‥<소수부>•
예: •·‥·•=1.5, •··‥.·•=3.25, •‥·•=0.5

문자열: ●<UTF-8 바이트>● — 바이트 경계 ‧, 각 바이트 8비트
예: ●.·..·...‧.··.·..·● = “Hi”

코드 예제

Hello World

◘ Hello, Jeom!
•·
  ●.·..·...‧.··..·.·‧.··.··..‧.··.··..‧.··.····‧..·.··..‧..·.....‧.·..·.·.‧.··..·.·‧.··.····‧.··.··.·‧..·....·●
  ··
⋮⋮

팩토리얼 (재귀) — 5! = 120

˙ ·∘·
˙∘ ·
⋮
  ∘∘ ·
  •·•
  ⋅‧∘∘
  …
  ⋮
    •·• ˙˙
  ⋮⋮
  ∘∘ ·
  ∘∘ ·
  •·•
  ⋅⋅
  ˙˙˙ ·∘·
  ⋅⋅⋅
  ˙˙
⋮⋮

•·
  •·.·•
  ˙˙˙ ·∘·
  ··
⋮⋮

더 많은 예제는 examples/ 폴더를 참고하세요.

포맷터

JS 엔진으로 파싱 후 Python이 포맷 출력합니다. node가 PATH에 있어야 합니다.

python3 tools/formatter/formatter.py hello.jeom           # hello.fmt.jeom 생성
python3 tools/formatter/formatter.py hello.jeom -r        # 포맷 후 원본 삭제
python3 tools/formatter/formatter.py hello.jeom -o out.jeom
python3 tools/formatter/formatter.py hello.jeom --check   # 포맷 필요 여부 확인
python3 tools/formatter/formatter.py *.jeom               # 여러 파일

표준 라이브러리

●.···..··‧.···.·..‧.··..·..‧.··.··..‧.··.·..·‧.··...·.‧..·.····‧.···..··‧.···.·..‧.··..·..‧..·.···.‧.··.·.·.‧.··..·.·‧.··.····‧.··.··.·●
⋯·⦁

|함수 토큰 |설명 | |-------|-----------| |·∘∘ |배열 오름차순 정렬 | |·∘· |배열 최댓값 | |·∘·· |배열 최솟값 | |·∘∘∘ |배열 합계 | |·∘·∘ |배열 역순 | |·∘··∘|배열 포함 여부 | |·∘∘· |배열 → 문자열 연결|

엔진 API

const {
  encodeString,   // 문자열 → 점 리터럴
  encodeNumber,   // 정수   → 점 리터럴
  encodeFloat,    // 소수   → 점 리터럴
  decodeString,   // 점 리터럴 → 문자열
  decodeNumber,   // 점 리터럴 → 숫자 (정수/소수 모두)
  tokenize,
  parse,
  JeomVM,
} = require('./core/engine.js');

const vm = new JeomVM({
  stdout: s => process.stdout.write(s),
  stderr: s => process.stderr.write(s),
  stdin:  () => Promise.resolve(''),
  readFile:   path => fs.promises.readFile(path, 'utf8'),
  writeFile:  (path, s) => fs.promises.writeFile(path, s),
  fileExists: path => fs.promises.access(path).then(() => true, () => false),
});

await vm.run(sourceCode);

VS Code 확장

tools/vscode-extension/ 에 포함되어 있습니다. https://github.com/captain34643875-wq/JeomLang-VScode 에서도 확인하실수 있습니다. 구문 강조, 코드 스니펫, 언어 설정을 제공합니다.

기여

<CONTRIBUTING.md> 를 참고해 주세요.

라이선스

Apache License 2.0

언어 이름 유의사항

jeomlang, jeom, JeomLang, JEOM, JEOMLANG, Jeomlang, Jeom, 점랭 만이 이 언어를 나타내는 말입니다.