@fluojs/vite 1.0.3 → 1.0.5

package/README.ko.md

@@ -19,7 +19,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 +42,7 @@ export default defineConfig({
 });
 ```
 
-이 플러그인은 `.ts` 애플리케이션 파일을 Babel로 변환하며 `2023-11` decorators proposal과 `@babel/preset-typescript`를 사용합니다. 파일 경계를 판단하기 전에 Vite query suffix를 제거한 뒤 declaration 파일, `.test.` 또는 `.spec.` 파일, `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 진단으로 표시됩니다.
 
 ## 공개 API
 
@@ -56,5 +56,5 @@ export default defineConfig({
 ## 예제 소스
 
 - `packages/vite/src/index.ts`
-- `packages/vite/src/internal/decorators-plugin.ts`
+- `packages/vite/src/decorators-plugin.ts`
 - `packages/cli/src/new/scaffold.ts`

package/README.md

@@ -19,7 +19,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 +42,7 @@ 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.` or `.spec.` 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.
 
 ## Public API
 
@@ -56,5 +56,5 @@ The plugin transforms `.ts` application files with Babel using the `2023-11` dec
 ## Example Sources
 
 - `packages/vite/src/index.ts`
-- `packages/vite/src/internal/decorators-plugin.ts`
+- `packages/vite/src/decorators-plugin.ts`
 - `packages/cli/src/new/scaffold.ts`

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

@@ -0,0 +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;AAoFnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAsC7C"}

package/dist/decorators-plugin.js

@@ -0,0 +1,106 @@
+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 loadBabelCore(filePath) {
+  try {
+    return await import('@babel/core');
+  } catch (error) {
+    throw createBabelTransformDiagnostic(error, filePath);
+  }
+}
+function readViteFilePath(id) {
+  const filePath = id.split(/[?#]/, 1)[0] ?? id;
+  return filePath;
+}
+function isNodeModulesPath(filePath) {
+  return /(?:^|\/)node_modules(?:\/|$)/u.test(filePath);
+}
+function isTypeScriptTestFile(filePath) {
+  return /\.(?:test|spec)\.ts$/u.test(filePath);
+}
+function shouldTransformTypeScriptApplicationFile(id) {
+  const normalizedFilePath = readViteFilePath(id).replaceAll('\\', '/');
+  if (!normalizedFilePath.endsWith('.ts') || normalizedFilePath.endsWith('.d.ts')) {
+    return false;
+  }
+  return !isNodeModulesPath(normalizedFilePath) && !isTypeScriptTestFile(normalizedFilePath);
+}
+function shouldRequestBabelSourceMaps(config) {
+  return config.command === 'serve' || Boolean(config.build.sourcemap);
+}
+
+/**
+ * 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()],
+ * });
+ * ```
+ */
+export function fluoDecoratorsPlugin() {
+  let shouldGenerateSourceMaps = false;
+  let babelCorePromise;
+  return {
+    name: 'fluo-babel-decorators',
+    configResolved(config) {
+      shouldGenerateSourceMaps = shouldRequestBabelSourceMaps(config);
+    },
+    async transform(code, id) {
+      if (!shouldTransformTypeScriptApplicationFile(id)) {
+        return null;
+      }
+      const filePath = readViteFilePath(id);
+      babelCorePromise ??= loadBabelCore(filePath);
+      const babelCore = await babelCorePromise;
+      const result = await babelCore.transformAsync(code, {
+        babelrc: false,
+        configFile: false,
+        filename: filePath,
+        plugins: [['@babel/plugin-proposal-decorators', {
+          version: '2023-11'
+        }]],
+        presets: [['@babel/preset-typescript', {
+          allowDeclareFields: true
+        }]],
+        sourceMaps: shouldGenerateSourceMaps
+      }).catch(error => {
+        throw createBabelTransformDiagnostic(error, filePath);
+      });
+      if (!result?.code) {
+        return null;
+      }
+      return {
+        code: result.code,
+        map: result.map ?? null
+      };
+    }
+  };
+}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { fluoDecoratorsPlugin } from './internal/decorators-plugin.js';
+export { fluoDecoratorsPlugin } from './decorators-plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -1 +1 @@
-export { fluoDecoratorsPlugin } from './internal/decorators-plugin.js';
+export { fluoDecoratorsPlugin } from './decorators-plugin.js';

package/package.json

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"decorators-plugin.d.ts","sourceRoot":"","sources":["../../src/internal/decorators-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAsBnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAwB7C"}

package/dist/internal/decorators-plugin.js

@@ -1,58 +0,0 @@
-import { transformAsync } from '@babel/core';
-function readViteFilePath(id) {
-  const [filePath] = id.split('?', 1);
-  return filePath;
-}
-function shouldTransformTypeScriptApplicationFile(id) {
-  const normalizedFilePath = readViteFilePath(id).replaceAll('\\', '/');
-  if (!normalizedFilePath.endsWith('.ts') || normalizedFilePath.endsWith('.d.ts')) {
-    return false;
-  }
-  return !normalizedFilePath.includes('/node_modules/') && !normalizedFilePath.includes('.test.') && !normalizedFilePath.includes('.spec.');
-}
-
-/**
- * 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()],
- * });
- * ```
- */
-export function fluoDecoratorsPlugin() {
-  return {
-    name: 'fluo-babel-decorators',
-    async transform(code, id) {
-      if (!shouldTransformTypeScriptApplicationFile(id)) {
-        return null;
-      }
-      const result = await transformAsync(code, {
-        babelrc: false,
-        configFile: false,
-        filename: readViteFilePath(id),
-        plugins: [['@babel/plugin-proposal-decorators', {
-          version: '2023-11'
-        }]],
-        presets: [['@babel/preset-typescript', {
-          allowDeclareFields: true
-        }]],
-        sourceMaps: true
-      });
-      if (!result?.code) {
-        return null;
-      }
-      return {
-        code: result.code,
-        map: result.map ?? null
-      };
-    }
-  };
-}