freelang-editor 11.7.4

package/.config/jest.config.js

@@ -0,0 +1,47 @@
+const path = require('path');
+
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  rootDir: path.join(__dirname, '..'),
+  globals: {
+    'ts-jest': {
+      diagnostics: false,
+      tsconfig: path.join(__dirname, 'tsconfig.json'),
+    }
+  },
+  roots: ['<rootDir>/src'],
+  testMatch: ['<rootDir>/**/__tests__/**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  collectCoverage: true,
+  collectCoverageFrom: [
+    // 핵심 실행 엔진 (커버리지 75%+ 달성 대상)
+    'src/lexer.ts',
+    'src/ast.ts',
+    'src/token.ts',
+    'src/errors.ts',
+    'src/error-formatter.ts',
+    'src/interpreter-scope.ts',
+    'src/eval-builtins.ts',
+    'src/eval-special-forms.ts',
+    // parser.ts는 2255줄의 대형 파일로 별도 전문 테스트 필요 — 제외
+    // eval-call-function.ts는 비동기/TCO 케이스 많음 — 제외
+  ],
+  coverageThreshold: {
+    global: {
+      lines: 75
+    }
+  },
+  coveragePathIgnorePatterns: [
+    '/node_modules/',
+  ],
+  moduleNameMapper: {
+    '^@/(.*)$': '<rootDir>/src/$1'
+  },
+  testTimeout: 30000,
+  verbose: true,
+  bail: false,
+  maxWorkers: '50%',
+  detectOpenHandles: true,
+  forceExit: true
+};

package/.config/jest.fast.config.js

@@ -0,0 +1,9 @@
+// Fast test config — coverage 없이 2~3초 실행
+const base = require('./jest.config');
+module.exports = {
+  ...base,
+  collectCoverage: false,
+  coverageThreshold: undefined,
+  verbose: false,
+  reporters: ['default'],
+};

package/.config/openapi.yaml

@@ -0,0 +1,457 @@
+openapi: 3.0.0
+info:
+  title: FreeLang v9 HTTP API
+  version: 9.0.0
+  description: FreeLang v9 언어 해석기의 HTTP 인터페이스
+  contact:
+    name: FreeLang 팀
+  license:
+    name: MIT
+
+servers:
+  - url: http://localhost:3000
+    description: 로컬 개발 서버
+  - url: https://api.freelang.local
+    description: 프로덕션 서버
+
+paths:
+  /api/compile:
+    post:
+      summary: FreeLang 코드 컴파일
+      tags:
+        - Compilation
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                  description: FreeLang 소스 코드
+                  example: "var x = 10; fn add(a, b) { a + b }"
+                optimize:
+                  type: boolean
+                  description: 최적화 활성화 여부
+                  default: false
+              required:
+                - code
+      responses:
+        '200':
+          description: 컴파일 성공
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  ast:
+                    type: object
+                    description: 추상 구문 트리
+                  bytecode:
+                    type: string
+                    description: 생성된 바이트코드
+                  metadata:
+                    type: object
+                    properties:
+                      lines:
+                        type: integer
+                      functions:
+                        type: integer
+                      tokens:
+                        type: integer
+        '400':
+          description: 컴파일 오류
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+  /api/execute:
+    post:
+      summary: 컴파일된 코드 실행
+      tags:
+        - Execution
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                  description: FreeLang 소스 코드
+                timeout:
+                  type: integer
+                  description: 실행 타임아웃 (ms)
+                  default: 5000
+                debug:
+                  type: boolean
+                  description: 디버그 모드
+                  default: false
+              required:
+                - code
+      responses:
+        '200':
+          description: 실행 완료
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  output:
+                    type: array
+                    description: 프린트된 출력
+                  result:
+                    type: object
+                    description: 실행 결과 값
+                  executionTime:
+                    type: number
+                    description: 실행 시간 (ms)
+                  memoryUsed:
+                    type: number
+                    description: 메모리 사용량 (MB)
+        '408':
+          description: 타임아웃
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+  /api/analyze:
+    post:
+      summary: 코드 분석 및 최적화 제안
+      tags:
+        - Analysis
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                  description: 분석할 FreeLang 코드
+              required:
+                - code
+      responses:
+        '200':
+          description: 분석 완료
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  complexity:
+                    type: object
+                    properties:
+                      cyclomatic:
+                        type: number
+                      cognitive:
+                        type: number
+                  suggestions:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        type:
+                          type: string
+                          enum: [performance, readability, security]
+                        severity:
+                          type: string
+                          enum: [low, medium, high, critical]
+                        message:
+                          type: string
+                  metrics:
+                    type: object
+                    properties:
+                      lines:
+                        type: integer
+                      functions:
+                        type: integer
+                      cyclomaticComplexity:
+                        type: number
+
+  /api/lint:
+    post:
+      summary: 코드 스타일 검사
+      tags:
+        - Linting
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                rules:
+                  type: object
+                  description: 검사 규칙
+              required:
+                - code
+      responses:
+        '200':
+          description: 검사 완료
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  errors:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/LintError'
+                  warnings:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/LintError'
+
+  /api/test:
+    post:
+      summary: 테스트 실행
+      tags:
+        - Testing
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                  description: 테스트 코드
+              required:
+                - code
+      responses:
+        '200':
+          description: 테스트 완료
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  passed:
+                    type: integer
+                  failed:
+                    type: integer
+                  skipped:
+                    type: integer
+                  results:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        status:
+                          type: string
+                          enum: [passed, failed, skipped]
+                        error:
+                          type: string
+
+  /api/format:
+    post:
+      summary: 코드 포맷팅
+      tags:
+        - Formatting
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                  description: 포맷할 코드
+                options:
+                  type: object
+                  properties:
+                    indentSize:
+                      type: integer
+                      default: 2
+                    lineWidth:
+                      type: integer
+                      default: 80
+              required:
+                - code
+      responses:
+        '200':
+          description: 포맷 완료
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  formatted:
+                    type: string
+                    description: 포맷된 코드
+
+  /api/benchmark:
+    post:
+      summary: 성능 벤치마크
+      tags:
+        - Performance
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                iterations:
+                  type: integer
+                  default: 1000
+              required:
+                - code
+      responses:
+        '200':
+          description: 벤치마크 완료
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  iterations:
+                    type: integer
+                  totalTime:
+                    type: number
+                    description: 총 실행 시간 (ms)
+                  avgTime:
+                    type: number
+                    description: 평균 시간 (ms)
+                  opsPerSec:
+                    type: number
+                    description: 초당 연산 수
+                  memoryPeak:
+                    type: number
+                    description: 최대 메모리 (MB)
+
+  /api/debug:
+    post:
+      summary: 디버그 정보
+      tags:
+        - Debugging
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                code:
+                  type: string
+                breakpoints:
+                  type: array
+                  items:
+                    type: integer
+                    description: 라인 번호
+      responses:
+        '200':
+          description: 디버그 세션 생성됨
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  sessionId:
+                    type: string
+                  variables:
+                    type: object
+                  stack:
+                    type: array
+                    items:
+                      type: object
+
+  /api/version:
+    get:
+      summary: 버전 정보
+      tags:
+        - System
+      responses:
+        '200':
+          description: 버전 정보
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  version:
+                    type: string
+                  name:
+                    type: string
+                  author:
+                    type: string
+                  license:
+                    type: string
+
+  /api/health:
+    get:
+      summary: 헬스 체크
+      tags:
+        - System
+      responses:
+        '200':
+          description: 서버 정상 작동
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    enum: [ok, degraded, down]
+                  uptime:
+                    type: number
+                  memoryUsage:
+                    type: object
+
+components:
+  schemas:
+    Error:
+      type: object
+      properties:
+        error:
+          type: string
+          description: 에러 메시지
+        code:
+          type: integer
+          description: 에러 코드
+        details:
+          type: object
+          description: 상세 정보
+
+    LintError:
+      type: object
+      properties:
+        line:
+          type: integer
+        column:
+          type: integer
+        message:
+          type: string
+        rule:
+          type: string
+        severity:
+          type: string
+          enum: [low, medium, high, critical]
+
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+
+security:
+  - bearerAuth: []

package/.config/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "../dist",
+    "rootDir": "../src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["../src/**/*"],
+  "exclude": [
+    "node_modules",
+    "**/*.test.ts",
+    "../src/test-phase87-packages.ts",
+    "../src/stdlib-server.ts",
+    "../src/stdlib-ws.ts",
+    "../src/stdlib-wsc.ts",
+    "../src/stdlib-pg.ts",
+    "../src/test-composition.ts",
+    "../src/test-modules.ts"
+  ]
+}

package/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,176 @@
+# FreeLang v9 행동 강령
+
+## 우리의 약속
+
+FreeLang v9 커뮤니티의 모든 구성원으로서, 우리는 모든 사람에게 포용적이고 환영하는 커뮤니티를 만들기로 약속합니다.
+
+---
+
+## 우리의 표준
+
+긍정적인 환경을 조성하기 위해, 우리는 다음의 행동을 기대합니다:
+
+### ✅ 칭찬할 행동
+
+- **존중**: 다양한 의견과 경험을 존중합니다
+- **배려**: 다른 사람의 감정을 배려합니다
+- **건설적**: 피드백은 건설적이고 도움이 되도록 합니다
+- **도움**: 다른 사용자를 진심으로 도와줍니다
+- **개방성**: 새로운 아이디어와 관점에 열려있습니다
+- **진정성**: 진정하고 성실하게 행동합니다
+
+### ❌ 용납할 수 없는 행동
+
+다음의 행동은 용납되지 않습니다:
+
+- **괴롭힘**: 인신공격, 모욕, 협박
+- **차별**: 성별, 성적지향, 나이, 종교, 국적에 따른 차별
+- **스팸**: 스팸, 피싱, 악의적 광고
+- **도발**: 의도적인 도발이나 분란 조성
+- **사생활 침해**: 동의 없이 개인 정보 공개
+- **폭력**: 폭력적인 언어나 협박
+- **성희롱**: 성적인 내용의 댓글, 이미지, 행동
+
+---
+
+## 우리의 책임
+
+프로젝트 관리자는 다음 책임이 있습니다:
+
+1. **모니터링**: 부적절한 행동 감시
+2. **시정**: 위반 행동에 적절히 대응
+3. **공정성**: 편견 없이 공정하게 처리
+4. **투명성**: 처리 과정을 명확하게 설명
+5. **보호**: 신고자 보호 및 비밀 유지
+
+---
+
+## 신고
+
+부적절한 행동을 목격하셨나요?
+
+### 신고 방법
+
+1. **이메일**: [kim@dclub.kr](mailto:kim@dclub.kr)
+   - 제목: `[CoC] 신고`
+   - 자세한 설명 포함
+   - 정보 사본 첨부 (가능시)
+
+2. **GitHub Issues**: 심각하지 않은 경우
+   - 이슈 생성
+   - `conduct` 라벨 추가
+
+3. **비밀 연락**: 개인적으로 연락하기 원하면
+   - DM 또는 이메일 사용
+
+### 신고 시 포함할 정보
+
+- 사건이 발생한 날짜와 시간
+- 관련자의 GitHub 사용자명
+- 부적절한 행동의 구체적 설명
+- 증거 링크 (댓글, 이슈 등)
+- 사건의 영향
+
+---
+
+## 대응
+
+신고를 받으면:
+
+1. **검토** (24시간 내): 신고 내용 검토
+2. **조사** (3-7일): 관련자 면담 및 증거 수집
+3. **결정** (7일 내): 위반 여부 판단
+4. **통보**: 신고자 및 관련자 통보
+5. **조치**: 필요시 제재 조치
+
+### 가능한 조치
+
+- **경고**: 처음 경미한 위반
+- **댓글 삭제**: 문제가 되는 댓글 제거
+- **일시 정지**: 7-30일 활동 중단
+- **영구 차단**: 커뮤니티에서 제거
+
+---
+
+## 항소
+
+조치에 불동의할 경우:
+
+1. 7일 내에 이메일로 항소
+2. 새로운 검토자가 재검토
+3. 항소 결과 최종 (번복 불가)
+
+---
+
+## 특별한 경우
+
+### 미성년자 보호
+
+- 18세 미만 사용자의 안전 최우선
+- 미성년자 대상 어떤 형태의 괴롭힘도 즉시 차단
+
+### 정치/종교
+
+- 언어 개발에 관련 없는 정치/종교 논쟁 금지
+- 다양성과 포용을 위협하는 내용 금지
+
+### 외부 명예 훼손
+
+- 다른 프로젝트/사람을 폄하하지 않기
+- 비교는 객관적이고 건설적으로
+
+---
+
+## 커뮤니티의 역할
+
+### 사용자
+- 행동 강령 이해하고 따르기
+- 위반 행동 신고하기
+- 건설적인 피드백 제공
+
+### 관리자
+- 행동 강령 공정하게 시행
+- 신고 신속하게 처리
+- 투명한 과정 유지
+
+### 리더
+- 모범적인 행동 보여주기
+- 새 사용자 환영하기
+- 분쟁 중재하기
+
+---
+
+## 다양성과 포용
+
+우리는 다음을 믿습니다:
+
+- 🌍 국적, 종교, 인종에 관계없이 모두 환영
+- 👥 다양한 배경과 경험의 가치
+- 🤝 포용적인 커뮤니티가 더 강함
+- 💪 함께 더 나은 언어를 만들 수 있음
+
+---
+
+## 감사의 말
+
+이 행동 강령은 다음에서 영감을 받았습니다:
+
+- [Contributor Covenant](https://www.contributor-covenant.org)
+- [Python Community Guidelines](https://www.python.org/community/diversity/)
+- [Rust Code of Conduct](https://www.rust-lang.org/policies/code-of-conduct)
+
+---
+
+## 마지막 말
+
+FreeLang v9 커뮤니티에 참여해주셔서 감사합니다.
+
+함께 **존중**, **배려**, **협력**의 커뮤니티를 만들어가요! 🙏
+
+---
+
+**행동 강령 버전**: 1.0  
+**마지막 업데이트**: 2026-04-13
+
+이 행동 강령은 필요시 업데이트될 수 있습니다.
+변경 사항은 미리 공지됩니다.