@fluojs/vite 1.0.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fluo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,59 @@
+# @fluojs/vite
+
+<p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
+
+fluo 프로젝트를 위한 Vite 플러그인과 빌드 유틸리티입니다.
+
+## 목차
+
+- [설치](#설치)
+- [사용 시점](#사용-시점)
+- [빠른 시작](#빠른-시작)
+- [공개 API](#공개-api)
+- [관련 패키지](#관련-패키지)
+- [예제 소스](#예제-소스)
+
+## 설치
+
+```bash
+npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-decorators @babel/preset-typescript
+```
+
+`@babel/core`와 `vite`는 peer dependency입니다. `fluoDecoratorsPlugin()`이 Vite transform 시점에 decorator plugin과 TypeScript preset을 해석하므로 consuming project에는 `@babel/plugin-proposal-decorators`와 `@babel/preset-typescript`도 필요합니다.
+
+## 사용 시점
+
+- fluo 애플리케이션이 TC39 표준 데코레이터가 포함된 TypeScript를 Vite로 빌드할 때
+- starter 프로젝트가 Babel 설정을 inline으로 복사하지 않고 유지보수되는 decorator transform을 import해야 할 때
+- 향후 Vite 대상 fluo 빌드 유틸리티에 독립적인 public package 경계가 필요할 때
+
+## 빠른 시작
+
+```ts
+import { fluoDecoratorsPlugin } from '@fluojs/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [fluoDecoratorsPlugin()],
+  build: {
+    ssr: 'src/main.ts',
+    target: 'node20',
+  },
+});
+```
+
+이 플러그인은 `.ts` 애플리케이션 파일을 Babel로 변환하며 `2023-11` decorators proposal과 `@babel/preset-typescript`를 사용합니다. 경로에 `.test.`가 포함된 파일은 건너뛰므로 생성된 Vitest 테스트 파일은 계속 전용 `@fluojs/testing/vitest` transform 경로를 사용합니다.
+
+## 공개 API
+
+- `fluoDecoratorsPlugin()` — 생성된 fluo starter 프로젝트가 사용하는 Vite 플러그인을 만듭니다.
+
+## 관련 패키지
+
+- [`@fluojs/cli`](../cli/README.ko.md): 이 Vite 플러그인을 import하는 starter 프로젝트를 생성합니다.
+- [`@fluojs/testing`](../testing/README.ko.md): Vitest 전용 decorator transform entrypoint를 제공합니다.
+
+## 예제 소스
+
+- `packages/vite/src/index.ts`
+- `packages/cli/src/new/scaffold.ts`

package/README.md

@@ -0,0 +1,59 @@
+# @fluojs/vite
+
+<p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
+
+Vite plugin and build utilities for fluo projects.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [When to Use](#when-to-use)
+- [Quick Start](#quick-start)
+- [Public API](#public-api)
+- [Related Packages](#related-packages)
+- [Example Sources](#example-sources)
+
+## Installation
+
+```bash
+npm install --save-dev @fluojs/vite vite @babel/core @babel/plugin-proposal-decorators @babel/preset-typescript
+```
+
+`@babel/core` and `vite` are peer dependencies. The decorator plugin and TypeScript preset must also be available in the consuming project because `fluoDecoratorsPlugin()` resolves them when Vite transforms source files.
+
+## When to Use
+
+- when a fluo application uses Vite to build TypeScript that contains TC39 standard decorators
+- 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
+
+## Quick Start
+
+```ts
+import { fluoDecoratorsPlugin } from '@fluojs/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [fluoDecoratorsPlugin()],
+  build: {
+    ssr: 'src/main.ts',
+    target: 'node20',
+  },
+});
+```
+
+The plugin transforms `.ts` application files with Babel using the `2023-11` decorators proposal and `@babel/preset-typescript`. It skips files whose path includes `.test.` so generated Vitest test files continue to use the dedicated `@fluojs/testing/vitest` transform path.
+
+## Public API
+
+- `fluoDecoratorsPlugin()` — creates the Vite plugin used by generated fluo starter projects.
+
+## Related Packages
+
+- [`@fluojs/cli`](../cli/README.md): generates starter projects that import this Vite plugin.
+- [`@fluojs/testing`](../testing/README.md): provides the Vitest-specific decorator transform entrypoint.
+
+## Example Sources
+
+- `packages/vite/src/index.ts`
+- `packages/cli/src/new/scaffold.ts`

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+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()],
+ * });
+ * ```
+ */
+export declare function fluoDecoratorsPlugin(): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,46 @@
+import { transformAsync } from '@babel/core';
+/**
+ * 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 (!id.endsWith('.ts') || id.includes('.test.')) {
+        return null;
+      }
+      const result = await transformAsync(code, {
+        babelrc: false,
+        configFile: false,
+        filename: 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
+      };
+    }
+  };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@fluojs/vite",
+  "description": "Vite plugin and build utilities for fluo projects.",
+  "keywords": [
+    "fluo",
+    "vite",
+    "decorators",
+    "babel",
+    "build-tooling"
+  ],
+  "version": "1.0.0-beta.2",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluojs/fluo.git",
+    "directory": "packages/vite"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@babel/core": ">=7.0.0",
+    "vite": ">=5.0.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
+    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "pnpm exec vitest run -c vitest.config.ts",
+    "test:watch": "pnpm exec vitest -c vitest.config.ts"
+  }
+}