@fluojs/vite 1.0.4 → 1.0.6

package/README.ko.md

@@ -9,6 +9,7 @@ fluo 프로젝트를 위한 Vite 플러그인과 빌드 유틸리티입니다.
 - [설치](#설치)
 - [사용 시점](#사용-시점)
 - [빠른 시작](#빠른-시작)
+- [데코레이터 변환 경계](#데코레이터-변환-경계)
 - [공개 API](#공개-api)
 - [관련 패키지](#관련-패키지)
 - [예제 소스](#예제-소스)
@@ -19,7 +20,7 @@ fluo 프로젝트를 위한 Vite 플러그인과 빌드 유틸리티입니다.
 npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-decorators @babel/preset-typescript
 ```
 
-`@babel/core` `>=7.26.0`, `@babel/plugin-proposal-decorators` `>=7.28.0`, `@babel/preset-typescript` `>=7.27.0`, `vite` `>=6.2.0`은 peer dependency입니다. `fluoDecoratorsPlugin()`이 Vite transform 시점에 Babel decorator plugin과 TypeScript preset을 해석하기 때문입니다.
+`@babel/core` `>=7.26.0`, `@babel/plugin-proposal-decorators` `>=7.28.0`, `@babel/preset-typescript` `>=7.27.0`, `vite` `>=6.2.0`은 peer dependency입니다. `fluoDecoratorsPlugin()`이 Vite transform 시점에 Babel을 로드하고 Babel decorator plugin과 TypeScript preset을 해석하며, 누락된 peer dependency를 Vite `transform` hook의 진단으로 보고하기 때문입니다.
 
 ## 사용 시점
 
@@ -42,7 +43,17 @@ export default defineConfig({
 });
 ```
 
-이 플러그인은 `.ts` 애플리케이션 파일을 Babel로 변환하며 `2023-11` decorators proposal과 `@babel/preset-typescript`를 사용합니다. 파일 경계를 판단하기 전에 Vite query suffix를 제거한 뒤 declaration 파일, `*.test.ts` 또는 `*.spec.ts` 파일, `node_modules`, `.ts`가 아닌 파일은 건너뛰므로 생성된 Vitest 테스트 파일은 계속 전용 `@fluojs/testing/vitest` transform 경로를 사용합니다.
+이 플러그인은 `.ts` 애플리케이션 파일을 Babel로 변환하며 `2023-11` decorators proposal과 `@babel/preset-typescript`를 사용합니다. 파일 경계를 판단하기 전에 Vite query suffix를 제거한 뒤 declaration 파일, `*.test.ts` 또는 `*.spec.ts` 파일, `node_modules`, `.ts`가 아닌 파일은 건너뛰므로 생성된 Vitest 테스트 파일은 계속 전용 `@fluojs/testing/vitest` transform 경로를 사용합니다. `@fluojs/vite`를 import하거나 `fluoDecoratorsPlugin()`을 생성하는 시점에는 `@babel/core`를 로드하지 않으며, 누락된 Babel peer는 Vite가 변환 중인 소스 파일에 대한 transform-time 진단으로 표시됩니다.
+
+## 데코레이터 변환 경계
+
+`@fluojs/vite`는 Vitest 테스트 변환이 아니라 애플리케이션 빌드 변환을 소유합니다. 생성된 non-Deno starter는 파일 경계 분리를 명시적으로 유지합니다:
+
+1. `vite.config.ts`는 `@fluojs/vite`에서 `fluoDecoratorsPlugin()`을 import합니다.
+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 경로에 남습니다.
+
+생성 프로젝트를 커스터마이즈할 때도 이 경계를 분리하세요. `experimentalDecorators`를 다시 활성화하거나, direct esbuild decorator handling에 의존하거나, 테스트 파일을 Vite 애플리케이션 transform으로 보내는 방식은 문서화된 fluo 지원 계약 밖에 있습니다.
 
 ## 공개 API
 

package/README.md

@@ -9,6 +9,7 @@ Vite plugin and build utilities for fluo projects.
 - [Installation](#installation)
 - [When to Use](#when-to-use)
 - [Quick Start](#quick-start)
+- [Decorator Transform Boundary](#decorator-transform-boundary)
 - [Public API](#public-api)
 - [Related Packages](#related-packages)
 - [Example Sources](#example-sources)
@@ -19,7 +20,7 @@ Vite plugin and build utilities for fluo projects.
 npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-decorators @babel/preset-typescript
 ```
 
-`@babel/core` `>=7.26.0`, `@babel/plugin-proposal-decorators` `>=7.28.0`, `@babel/preset-typescript` `>=7.27.0`, and `vite` `>=6.2.0` are peer dependencies because `fluoDecoratorsPlugin()` resolves the Babel decorator plugin and TypeScript preset when Vite transforms source files.
+`@babel/core` `>=7.26.0`, `@babel/plugin-proposal-decorators` `>=7.28.0`, `@babel/preset-typescript` `>=7.27.0`, and `vite` `>=6.2.0` are peer dependencies because `fluoDecoratorsPlugin()` loads Babel, resolves the Babel decorator plugin and TypeScript preset, and reports missing peer dependencies from the Vite `transform` hook when Vite transforms source files.
 
 ## When to Use
 
@@ -42,7 +43,17 @@ export default defineConfig({
 });
 ```
 
-The plugin transforms `.ts` application files with Babel using the `2023-11` decorators proposal and `@babel/preset-typescript`. It strips Vite query suffixes before deciding the file boundary, then skips declaration files, `*.test.ts` or `*.spec.ts` files, `node_modules`, and non-`.ts` files so generated Vitest test files continue to use the dedicated `@fluojs/testing/vitest` transform path.
+The plugin transforms `.ts` application files with Babel using the `2023-11` decorators proposal and `@babel/preset-typescript`. It strips Vite query suffixes before deciding the file boundary, then skips declaration files, `*.test.ts` or `*.spec.ts` files, `node_modules`, and non-`.ts` files so generated Vitest test files continue to use the dedicated `@fluojs/testing/vitest` transform path. Importing `@fluojs/vite` or creating `fluoDecoratorsPlugin()` does not load `@babel/core`; missing Babel peers are surfaced as transform-time diagnostics for the source file Vite is transforming.
+
+## Decorator Transform Boundary
+
+`@fluojs/vite` owns application build transforms, not Vitest test transforms. Generated non-Deno starters keep the file-boundary split explicit:
+
+1. `vite.config.ts` imports `fluoDecoratorsPlugin()` from `@fluojs/vite`.
+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.
+
+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

@@ -1,19 +1,7 @@
 import type { Plugin } from 'vite';
-/**
- * Creates the Vite transform plugin used by fluo starter projects to compile
- * TC39 standard decorator syntax through Babel before Vite bundles the app.
- *
- * @returns A Vite plugin that transforms TypeScript application files and skips test files.
- *
- * @example
- * ```ts
- * import { fluoDecoratorsPlugin } from '@fluojs/vite';
- * import { defineConfig } from 'vite';
- *
- * export default defineConfig({
- *   plugins: [fluoDecoratorsPlugin()],
- * });
- * ```
- */
+type BabelCoreModule = Pick<typeof import('@babel/core'), 'transformAsync'>;
+type BabelCoreImporter = () => Promise<BabelCoreModule>;
 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":"AACA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAC;AA8BnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CA6B7C"}
+{"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"}

package/dist/decorators-plugin.js

@@ -1,4 +1,36 @@
-import { transformAsync } from '@babel/core';
+const BABEL_PEER_DEPENDENCIES = ['@babel/core', '@babel/plugin-proposal-decorators', '@babel/preset-typescript'];
+function readErrorCode(value) {
+  if (!value || typeof value !== 'object' || !('code' in value)) {
+    return undefined;
+  }
+  const code = value.code;
+  return typeof code === 'string' ? code : undefined;
+}
+function readErrorMessage(value) {
+  return value instanceof Error ? value.message : String(value);
+}
+function isMissingPeerDependencyError(error) {
+  const code = readErrorCode(error);
+  const message = readErrorMessage(error);
+  return (code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND' || message.includes('Cannot find package')) && BABEL_PEER_DEPENDENCIES.some(dependencyName => message.includes(dependencyName));
+}
+function createBabelTransformDiagnostic(error, filePath) {
+  const message = readErrorMessage(error);
+  if (!isMissingPeerDependencyError(error)) {
+    return error instanceof Error ? error : new Error(message);
+  }
+  return new Error(`[fluo-babel-decorators] Failed to resolve a Babel peer dependency while transforming ${filePath}. ` + 'Install @babel/core, @babel/plugin-proposal-decorators, and @babel/preset-typescript in the Vite project. ' + `Original error: ${message}`);
+}
+async function importBabelCore() {
+  return await import('@babel/core');
+}
+async function loadBabelCore(filePath, importBabelCoreModule) {
+  try {
+    return await importBabelCoreModule();
+  } catch (error) {
+    throw createBabelTransformDiagnostic(error, filePath);
+  }
+}
 function readViteFilePath(id) {
   const filePath = id.split(/[?#]/, 1)[0] ?? id;
   return filePath;
@@ -36,8 +68,9 @@ function shouldRequestBabelSourceMaps(config) {
  * });
  * ```
  */
-export function fluoDecoratorsPlugin() {
+function createFluoDecoratorsPlugin(importBabelCoreModule) {
   let shouldGenerateSourceMaps = false;
+  let babelCorePromise;
   return {
     name: 'fluo-babel-decorators',
     configResolved(config) {
@@ -47,10 +80,13 @@ export function fluoDecoratorsPlugin() {
       if (!shouldTransformTypeScriptApplicationFile(id)) {
         return null;
       }
-      const result = await transformAsync(code, {
+      const filePath = readViteFilePath(id);
+      babelCorePromise ??= loadBabelCore(filePath, importBabelCoreModule);
+      const babelCore = await babelCorePromise;
+      const result = await babelCore.transformAsync(code, {
         babelrc: false,
         configFile: false,
-        filename: readViteFilePath(id),
+        filename: filePath,
         plugins: [['@babel/plugin-proposal-decorators', {
           version: '2023-11'
         }]],
@@ -58,6 +94,8 @@ export function fluoDecoratorsPlugin() {
           allowDeclareFields: true
         }]],
         sourceMaps: shouldGenerateSourceMaps
+      }).catch(error => {
+        throw createBabelTransformDiagnostic(error, filePath);
       });
       if (!result?.code) {
         return null;
@@ -68,4 +106,10 @@ export function fluoDecoratorsPlugin() {
       };
     }
   };
+}
+export function fluoDecoratorsPlugin() {
+  return createFluoDecoratorsPlugin(importBabelCore);
+}
+export function createFluoDecoratorsPluginForTesting(importBabelCoreModule) {
+  return createFluoDecoratorsPlugin(importBabelCoreModule);
 }

package/package.json

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