@fluojs/vite 1.0.6 → 1.0.7

package/README.ko.md

@@ -8,6 +8,7 @@ fluo 프로젝트를 위한 Vite 플러그인과 빌드 유틸리티입니다.
 
 - [설치](#설치)
 - [사용 시점](#사용-시점)
+- [런타임 및 peer 계약](#런타임-및-peer-계약)
 - [빠른 시작](#빠른-시작)
 - [데코레이터 변환 경계](#데코레이터-변환-경계)
 - [공개 API](#공개-api)
@@ -28,6 +29,12 @@ npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-deco
 - starter 프로젝트가 Babel 설정을 inline으로 복사하지 않고 유지보수되는 decorator transform을 import해야 할 때
 - 향후 Vite 대상 fluo 빌드 유틸리티에 독립적인 public package 경계가 필요할 때
 
+## 런타임 및 peer 계약
+
+`@fluojs/vite`는 `engines.node` 하한을 `>=20.0.0`으로 두는 Node.js 패키지입니다. 생성된 non-Deno starter는 이 Node 기준선과 Vite `>=6.2.0`, 그리고 위에 나열한 Babel peer를 함께 사용합니다.
+
+패키지 root는 Babel이 설치되거나 해석되기 전에 import해도 안전합니다. `@fluojs/vite`를 import하거나 `fluoDecoratorsPlugin()`을 생성해도 `@babel/core`를 로드하지 않습니다. Babel은 eligible 애플리케이션 `.ts` 파일에 대한 Vite `transform` hook에서만 lazy load되며, 누락된 Babel peer도 plugin 생성 시점이 아니라 이 transform 경계에서 보고됩니다.
+
 ## 빠른 시작
 
 ```ts

package/README.md

@@ -8,6 +8,7 @@ Vite plugin and build utilities for fluo projects.
 
 - [Installation](#installation)
 - [When to Use](#when-to-use)
+- [Runtime and Peer Contract](#runtime-and-peer-contract)
 - [Quick Start](#quick-start)
 - [Decorator Transform Boundary](#decorator-transform-boundary)
 - [Public API](#public-api)
@@ -28,6 +29,12 @@ npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-deco
 - when starter projects should import the maintained decorator transform instead of copying Babel configuration inline
 - when future Vite-facing fluo build utilities need a dedicated public package boundary
 
+## 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.
+
+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.
+
 ## Quick Start
 
 ```ts

package/dist/decorators-plugin.d.ts

@@ -1,7 +1,9 @@
 import type { Plugin } from 'vite';
-type BabelCoreModule = Pick<typeof import('@babel/core'), 'transformAsync'>;
-type BabelCoreImporter = () => Promise<BabelCoreModule>;
+/**
+ * Creates the Vite plugin used by generated fluo starter projects to transform
+ * TypeScript application files that contain TC39 standard decorators.
+ *
+ * @returns A Vite plugin that lazily loads Babel for eligible application `.ts` files.
+ */
 export declare function fluoDecoratorsPlugin(): Plugin;
-export declare function createFluoDecoratorsPluginForTesting(importBabelCoreModule: BabelCoreImporter): Plugin;
-export {};
 //# sourceMappingURL=decorators-plugin.d.ts.map

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;AAEnD,KAAK,eAAe,GAAG,IAAI,CAAC,cAAc,aAAa,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAC5E,KAAK,iBAAiB,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AA8IxD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,oCAAoC,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,MAAM,CAErG"}
+{"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"}

package/dist/decorators-plugin.js

@@ -70,7 +70,7 @@ function shouldRequestBabelSourceMaps(config) {
  */
 function createFluoDecoratorsPlugin(importBabelCoreModule) {
   let shouldGenerateSourceMaps = false;
-  let babelCorePromise;
+  let babelCore;
   return {
     name: 'fluo-babel-decorators',
     configResolved(config) {
@@ -81,9 +81,9 @@ function createFluoDecoratorsPlugin(importBabelCoreModule) {
         return null;
       }
       const filePath = readViteFilePath(id);
-      babelCorePromise ??= loadBabelCore(filePath, importBabelCoreModule);
-      const babelCore = await babelCorePromise;
-      const result = await babelCore.transformAsync(code, {
+      const loadedBabelCore = babelCore ?? (await loadBabelCore(filePath, importBabelCoreModule));
+      babelCore = loadedBabelCore;
+      const result = await loadedBabelCore.transformAsync(code, {
         babelrc: false,
         configFile: false,
         filename: filePath,
@@ -107,9 +107,24 @@ function createFluoDecoratorsPlugin(importBabelCoreModule) {
     }
   };
 }
+
+/**
+ * Creates the Vite plugin used by generated fluo starter projects to transform
+ * TypeScript application files that contain TC39 standard decorators.
+ *
+ * @returns A Vite plugin that lazily loads Babel for eligible application `.ts` files.
+ */
 export function fluoDecoratorsPlugin() {
   return createFluoDecoratorsPlugin(importBabelCore);
 }
+
+/**
+ * Creates the fluo Vite decorators plugin with an injected Babel importer for regression tests.
+ *
+ * @internal
+ * @param importBabelCoreModule - Async loader used instead of the production `@babel/core` dynamic import.
+ * @returns A Vite plugin that preserves the production transform boundary while allowing tests to control Babel loading.
+ */
 export function createFluoDecoratorsPluginForTesting(importBabelCoreModule) {
   return createFluoDecoratorsPlugin(importBabelCoreModule);
 }

package/package.json

@@ -8,7 +8,7 @@
     "babel",
     "build-tooling"
   ],
-  "version": "1.0.6",
+  "version": "1.0.7",
   "private": false,
   "license": "MIT",
   "repository": {