@load28/unplugin-tt weekly downloads statistics

@load28/unplugin-tt

.tt과 .ttx 모듈을 번들러에서 그대로 import합니다. 중간 .ts/.tsx 트리를 만들지 않고, 번들러가 소스를 직접 읽습니다.

unplugin 기반이라 구현은 하나이고 번들러별 서브패스로 갈라져 나갑니다.

컴파일러는 @load28/tt-lang을 함께 설치하면 자동으로 찾습니다 (npm install --save-dev @load28/tt-lang@next @load28/unplugin-tt@next). @load28/tt-lang이 없으면 PATH의 ttc(cargo install --path .)로 폴백합니다.

서브패스

| import | 상태 |

| @load28/unplugin-tt/vite | 예제(tt-interop)로 검증 | | @load28/unplugin-tt/esbuild | 번들·실행 검증 | | @load28/unplugin-tt/rollup, /rolldown, /webpack, /rspack, /farm | unplugin이 제공하는 어댑터 — 미검증 |

@load28/unplugin-tt를 그대로 import하면 unplugin 객체와 vitePlugin· esbuildPlugin 같은 이름들이 나옵니다.

동작

| 단계 | 하는 일 |

| resolveId | .tt/.ttx 지정자를 파일 경로로 풀고 각각 .ts/.tsx를 덧붙인 가상 id를 돌려줍니다. @tt/std, @tt/std/option, @tt/std/result는 각각 가상 모듈 id로 바꿉니다 | | load | ttc -p --rewrite-imports off의 출력을 돌려줍니다. 표준 라이브러리와 파이프 런타임은 모듈별 ttc --emit-std types|option|result|runtime 출력을 사용합니다 |

id에 .ts 또는 .tsx를 붙이는 이유는 호스트의 TypeScript 처리에 그대로 태우기 위해서입니다. 덕분에 플러그인이 변환을 직접 하지 않습니다. 다만 esbuild의 load는 JavaScript만 반환할 수 있어서, 그 경로에는 소스 종류에 맞는 ts/tsx loader를 명시합니다.

--rewrite-imports off인 것도 의도입니다. 지정자 재작성은 미리 컴파일하는 파이프라인을 위한 기능이고, 여기서는 .tt이 그대로 남아야 이 플러그인이 다음 모듈도 잡습니다.

컴파일 에러는 ttc의 진단이 그대로 빌드 에러가 됩니다.

옵션

| 옵션 | 기본값 | 설명 |

| compiler | 설치된 @load28/tt-lang의 바이너리, 없으면 "ttc" | ttc 실행 파일 경로 | | verify | true | false면 --no-verify를 넘겨 방출물 자가 검사를 생략합니다 |

타입 선언(index.d.ts와 서브패스별 .d.ts)을 함께 싣습니다 — 소비자가 vite.config.ts를 타입 검사에 넣어도 tt()의 옵션이 그대로 검사됩니다.

타입은 별도입니다

번들러 플러그인은 런타임만 해결합니다. .ts 파일이 .tt을 import할 때 타입 검사와 정의 이동이 동작하려면 사이드카가 필요하고, 그건 ttc가 만듭니다.

CLI에서 ttc help workflow를 실행하거나 VSCode 확장을 참조하세요. 확장은 저장할 때마다 사이드카를 갱신합니다.

알려진 제약

• enforce: "pre"는 Rollup·esbuild에서 무시됩니다 (unplugin 문서의 지원 훅 표). 그 두 곳에서는 플러그인 순서를 직접 앞에 두세요. • resolveId는 Rspack·Rsbuild에서 최신 버전을 요구합니다.

Description from the npm listing.