@fluojs/vite 1.0.7 → 2.0.0

package/README.ko.md

@@ -4,11 +4,14 @@
 
 fluo 프로젝트를 위한 Vite 플러그인과 빌드 유틸리티입니다.
 
+Coordinated Node 24 릴리스를 준비한다면 패키지 업그레이드 전에 [소비자 마이그레이션 가이드](../../docs/getting-started/migrate-node24.ko.md)를 따르세요.
+
 ## 목차
 
 - [설치](#설치)
 - [사용 시점](#사용-시점)
 - [런타임 및 peer 계약](#런타임-및-peer-계약)
+- [지원 Vite 매트릭스](#지원-vite-매트릭스)
 - [빠른 시작](#빠른-시작)
 - [데코레이터 변환 경계](#데코레이터-변환-경계)
 - [공개 API](#공개-api)
@@ -31,10 +34,14 @@ npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-deco
 
 ## 런타임 및 peer 계약
 
-`@fluojs/vite`는 `engines.node` 하한을 `>=20.0.0`으로 두는 Node.js 패키지입니다. 생성된 non-Deno starter는 이 Node 기준선과 Vite `>=6.2.0`, 그리고 위에 나열한 Babel peer를 함께 사용합니다.
+`@fluojs/vite`는 `engines.node` 하한을 `>=24.0.0 <27`으로 두는 Node.js 패키지입니다. 생성된 non-Deno starter는 이제 Vite `^8.2.2`, Vitest와 `@vitest/coverage-v8` `^4.1.11`, 그리고 위에 나열한 Babel peer를 선언합니다. 배포된 Vite `>=6.2.0` peer 범위는 바뀌지 않습니다. 생성된 ESM config는 `build.rolldownOptions`를 사용하고, Babel이 Rolldown/Oxc보다 먼저 애플리케이션 데코레이터를 변환하며, `@fluojs/testing/vitest`가 별도 test transform boundary를 유지합니다. Direct Oxc/esbuild decorator processing은 지원하지 않습니다.
 
 패키지 root는 Babel이 설치되거나 해석되기 전에 import해도 안전합니다. `@fluojs/vite`를 import하거나 `fluoDecoratorsPlugin()`을 생성해도 `@babel/core`를 로드하지 않습니다. Babel은 eligible 애플리케이션 `.ts` 파일에 대한 Vite `transform` hook에서만 lazy load되며, 누락된 Babel peer도 plugin 생성 시점이 아니라 이 transform 경계에서 보고됩니다.
 
+## 지원 Vite 매트릭스
+
+배포된 peer 범위는 `vite >=6.2.0`을 유지합니다. 패키지 suite는 워크스페이스에 고정된 Vite 8.2.2 Rolldown/Oxc pipeline에서 실행됩니다. Integration gate는 plugin이 normal-stage transform보다 먼저 실행되고 field-decorator binding metadata를 보존하는지 검증하며, `enforce: 'pre'`를 회귀시키면 실패합니다. Vite 8을 선택하는 consumer는 Vite 자체 Node.js engine 범위도 충족해야 합니다.
+
 ## 빠른 시작
 
 ```ts
@@ -45,7 +52,7 @@ export default defineConfig({
   plugins: [fluoDecoratorsPlugin()],
   build: {
     ssr: 'src/main.ts',
-    target: 'node20',
+    target: 'node24',
   },
 });
 ```
@@ -60,6 +67,9 @@ export default defineConfig({
 2. Vite 플러그인은 query suffix를 제거하고 애플리케이션 `.ts` 파일만 허용하며, 첫 eligible transform 시점에 Babel을 lazy load한 뒤 `@babel/plugin-proposal-decorators`의 `{ version: '2023-11' }` 설정과 `@babel/preset-typescript`를 실행합니다.
 3. `vitest.config.ts`는 `@fluojs/testing/vitest`에서 `fluoBabelDecoratorsPlugin()`을 import하므로 `*.test.ts`와 `*.spec.ts` 파일은 testing-specific transform 경로에 남습니다.
 
+React SSR + Vite starter는 데코레이터가 있는 애플리케이션 선언을 `src/app.ts`에 두고,
+`src/page.tsx` 같은 `.tsx` 모듈에는 JSX 렌더링을 유지합니다.
+
 생성 프로젝트를 커스터마이즈할 때도 이 경계를 분리하세요. `experimentalDecorators`를 다시 활성화하거나, direct esbuild decorator handling에 의존하거나, 테스트 파일을 Vite 애플리케이션 transform으로 보내는 방식은 문서화된 fluo 지원 계약 밖에 있습니다.
 
 ## 공개 API

package/README.md

@@ -4,11 +4,14 @@
 
 Vite plugin and build utilities for fluo projects.
 
+Preparing for the coordinated Node 24 release? Follow the [consumer migration guide](../../docs/getting-started/migrate-node24.md) before upgrading packages.
+
 ## Table of Contents
 
 - [Installation](#installation)
 - [When to Use](#when-to-use)
 - [Runtime and Peer Contract](#runtime-and-peer-contract)
+- [Supported Vite Matrix](#supported-vite-matrix)
 - [Quick Start](#quick-start)
 - [Decorator Transform Boundary](#decorator-transform-boundary)
 - [Public API](#public-api)
@@ -31,10 +34,14 @@ npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-deco
 
 ## Runtime and Peer Contract
 
-`@fluojs/vite` is a Node.js package with an `engines.node` floor of `>=20.0.0`. Generated non-Deno starters pair that Node baseline with Vite `>=6.2.0` and the Babel peers listed above.
+`@fluojs/vite` is a Node.js package with an `engines.node` floor of `>=24.0.0 <27`. Generated non-Deno starters now declare Vite `^8.2.2`, Vitest and `@vitest/coverage-v8` `^4.1.11`, and the Babel peers listed above. The published Vite `>=6.2.0` peer range is unchanged. Generated ESM configs use `build.rolldownOptions`, with Babel transforming application decorators before Rolldown/Oxc and `@fluojs/testing/vitest` retaining the separate test transform boundary; direct Oxc/esbuild decorator processing is unsupported.
 
 The package root is safe to import before Babel is installed or resolved: importing `@fluojs/vite` and creating `fluoDecoratorsPlugin()` do not load `@babel/core`. Babel is loaded lazily only from Vite's `transform` hook for eligible application `.ts` files, and missing Babel peers are reported from that transform boundary instead of plugin creation.
 
+## Supported Vite Matrix
+
+The published peer range remains `vite >=6.2.0`. The package suite runs under the workspace-pinned Vite 8.2.2 Rolldown/Oxc pipeline. Its integration gate verifies the plugin runs before normal-stage transforms and preserves field-decorator binding metadata; regressing `enforce: 'pre'` makes the gate fail. Consumers selecting Vite 8 must also satisfy Vite's own Node.js engine range.
+
 ## Quick Start
 
 ```ts
@@ -45,7 +52,7 @@ export default defineConfig({
   plugins: [fluoDecoratorsPlugin()],
   build: {
     ssr: 'src/main.ts',
-    target: 'node20',
+    target: 'node24',
   },
 });
 ```
@@ -60,6 +67,9 @@ The plugin transforms `.ts` application files with Babel using the `2023-11` dec
 2. The Vite plugin strips query suffixes, accepts only application `.ts` files, lazily loads Babel on the first eligible transform, and runs `@babel/plugin-proposal-decorators` with `{ version: '2023-11' }` plus `@babel/preset-typescript`.
 3. `vitest.config.ts` imports `fluoBabelDecoratorsPlugin()` from `@fluojs/testing/vitest`, so `*.test.ts` and `*.spec.ts` files stay on the testing-specific transform path.
 
+The React SSR + Vite starter keeps its decorator-bearing application declarations in `src/app.ts`;
+JSX rendering remains in `.tsx` modules such as `src/page.tsx`.
+
 Keep those boundaries separate when customizing generated projects. Re-enabling `experimentalDecorators`, relying on direct esbuild decorator handling, or routing test files through the Vite application transform is outside the documented fluo support contract.
 
 ## Public API

package/dist/decorators-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators-plugin.d.ts","sourceRoot":"","sources":["../src/decorators-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAC;AAiJnD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}
+{"version":3,"file":"decorators-plugin.d.ts","sourceRoot":"","sources":["../src/decorators-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAC;AAkJnD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/decorators-plugin.js

@@ -73,6 +73,7 @@ function createFluoDecoratorsPlugin(importBabelCoreModule) {
   let babelCore;
   return {
     name: 'fluo-babel-decorators',
+    enforce: 'pre',
     configResolved(config) {
       shouldGenerateSourceMaps = shouldRequestBabelSourceMaps(config);
     },

package/package.json

@@ -8,7 +8,7 @@
     "babel",
     "build-tooling"
   ],
-  "version": "1.0.7",
+  "version": "2.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -17,7 +17,7 @@
     "directory": "packages/vite"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0 <27"
   },
   "publishConfig": {
     "access": "public"
@@ -41,7 +41,7 @@
     "vite": ">=6.2.0"
   },
   "devDependencies": {
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",