Files
2nd/10_Wiki/Topic_Programming/Frontend/Parser.md
T
Antigravity Agent 9148c358d0 docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를
Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류.

- 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로
  자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거,
  동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거.
- 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming,
  Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business,
  Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로,
  나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는
  title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백).
  원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지.
- 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서.
- 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는
  지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지.
- Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경.
- 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
2026-07-05 00:33:48 +09:00

168 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
id: wiki-2026-0508-parser
title: Parser
category: 10_Wiki/Topics
status: verified
canonical_id: self
aliases: [JS Parser, JavaScript Parser, AST Parser]
duplicate_of: none
source_trust_level: A
confidence_score: 0.9
verification_status: applied
tags: [frontend, parser, ast, swc, oxc, babel]
raw_sources: []
last_reinforced: 2026-05-10
github_commit: pending
tech_stack:
language: JavaScript/Rust
framework: SWC/oxc/Babel
---
# Parser
## 매 한 줄
> **"매 source code → AST 의 변환기"**. 매 tokenizer (lexer) → parser → AST tree. 2026 frontend 매 Babel (JS) → SWC (Rust) → oxc (faster Rust) 의 evolution. Vite 7 / Next 16 / Turbopack 의 내부 매 oxc/SWC.
## 매 핵심
### 매 Pipeline
- **Lexer (Tokenizer)**: 매 character stream → token stream (`const`, `x`, `=`, `1`).
- **Parser**: 매 tokens → AST (Abstract Syntax Tree) — `VariableDeclaration { kind: 'const', declarations: [...] }`.
- **Transformer**: 매 AST 의 modify (JSX → JS, TS → JS, ES2025 → ES5).
- **Generator**: 매 AST → source code (codegen).
### 매 Modern Parsers (2026)
- **oxc** (Boshen, Rust): 매 fastest — Babel 의 50-100×, SWC 의 3×. Vite 7 default.
- **SWC** (Vercel, Rust): 매 Next.js / Turbopack 의 backbone. Babel 의 20×.
- **Babel** (JS): 매 legacy ecosystem 의 최대 plugin 호환성. 매 새 project 에서 비추.
- **esbuild** (Go): 매 bundler 내장 parser — Vite dev 의 default.
- **Acorn**: 매 ESLint 9 의 default parser.
### 매 응용
1. Bundling: 매 Vite/Webpack/Turbopack 의 module graph 빌드.
2. Linting: 매 ESLint/Biome 의 rule 적용.
3. Type checking: 매 TS Compiler / SWC `@swc/plugin-tsc`.
4. Code transformation: 매 JSX, TS, decorator, JSX-runtime, optional chaining.
## 💻 패턴
### Babel 의 AST 분석
```js
import * as parser from '@babel/parser';
import traverse from '@babel/traverse';
const code = `const x = 1 + 2;`;
const ast = parser.parse(code, { sourceType: 'module' });
traverse(ast, {
BinaryExpression(path) {
if (path.node.operator === '+') {
console.log('Found addition:', path.node.left.value, '+', path.node.right.value);
}
},
});
```
### SWC programmatic
```js
import { parse, transform } from '@swc/core';
const ast = await parse('const x: number = 1;', {
syntax: 'typescript',
target: 'es2022',
});
const { code } = await transform('const x: number = 1;', {
jsc: { parser: { syntax: 'typescript' }, target: 'es2020' },
});
```
### oxc parser (Rust crate)
```rust
use oxc_allocator::Allocator;
use oxc_parser::Parser;
use oxc_span::SourceType;
let allocator = Allocator::default();
let source = "const x = 1;";
let source_type = SourceType::default();
let ret = Parser::new(&allocator, source, source_type).parse();
println!("{:#?}", ret.program);
```
### Custom Babel plugin
```js
export default function ({ types: t }) {
return {
visitor: {
Identifier(path) {
if (path.node.name === 'foo') {
path.node.name = 'bar';
}
},
},
};
}
```
### AST node 직접 생성
```js
import * as t from '@babel/types';
const node = t.variableDeclaration('const', [
t.variableDeclarator(t.identifier('x'), t.numericLiteral(42)),
]);
// → const x = 42;
```
### ESLint custom rule
```js
export default {
create(context) {
return {
VariableDeclaration(node) {
if (node.kind === 'var') {
context.report({ node, message: 'Use let/const instead of var' });
}
},
};
},
};
```
## 매 결정 기준
| 상황 | Parser |
|---|---|
| New Vite project | oxc (default) |
| Next.js / Turbopack | SWC (built-in) |
| Custom transform plugin (rich ecosystem) | Babel |
| Bundler dev mode | esbuild |
| Lint custom rule | Acorn (ESLint default) |
| Rust toolchain | oxc |
**기본값**: oxc 또는 SWC — 2026 매 Babel 의 production 사용 비추.
## 🔗 Graph
- 부모: [[AST]]
- 변형: [[SWC]] · [[esbuild]]
- 응용: [[Vite]] · [[Turbopack]] · [[ESLint]] · [[Biome]]
- Adjacent: [[Source_Maps]]
## 🤖 LLM 활용
**언제**: codemod 작성, 매 lint rule, custom transformer (CSS-in-JS extraction, dead code elimination).
**언제 X**: 매 simple regex 로 충분한 substitution — AST overkill.
## ❌ 안티패턴
- **Regex 로 JS parsing**: 매 nested template literal / comment 를 매번 break.
- **Babel new project**: 매 SWC/oxc 의 50× 빠름 — legacy plugin 없으면 마이그레이션.
- **AST mutation in place**: 매 path API 사용 — direct node assignment 시 traversal 깨짐.
## 🧪 검증 / 중복
- Verified (oxc 0.40, SWC 1.10, Babel 8 docs, Vite 7 release notes).
- 신뢰도 A.
## 🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — modern parser landscape (oxc/SWC) 강조 |