@tsrx/bun-plugin-vue 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dominic Gannaway
+
+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.md

@@ -0,0 +1,40 @@
+# @tsrx/bun-plugin-vue
+
+Bun plugin for compiling `@tsrx/vue` `.tsrx` files.
+
+## Installation
+
+```bash
+pnpm add -D @tsrx/bun-plugin-vue
+```
+
+## Usage
+
+```ts
+import tsrxVue from '@tsrx/bun-plugin-vue';
+
+await Bun.build({
+  entrypoints: ['./src/App.tsrx'],
+  outdir: './dist',
+  target: 'browser',
+  plugins: [tsrxVue()],
+});
+```
+
+The plugin compiles `.tsrx` modules with `@tsrx/vue`, runs the downstream
+`vue-jsx-vapor` transform, strips the remaining TypeScript syntax with Bun, and
+emits component-local `<style>` blocks as virtual CSS modules.
+
+For `bun:test`, register it from a preload:
+
+```ts
+import tsrxVue from '@tsrx/bun-plugin-vue';
+
+Bun.plugin(tsrxVue());
+```
+
+## Options
+
+- `vapor`: options forwarded to `vue-jsx-vapor`.
+- `emitCss`: whether to emit virtual CSS imports (default: `true`).
+- `include`, `exclude`: regex filters for source files.

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@tsrx/bun-plugin-vue",
+  "description": "Bun plugin for @tsrx/vue (.tsrx modules)",
+  "license": "MIT",
+  "author": "Dominic Gannaway",
+  "version": "0.0.2",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ripple-TS/ripple.git",
+    "directory": "packages/bun-plugin-vue"
+  },
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "dependencies": {
+    "@tsrx/vue": "0.0.22"
+  },
+  "peerDependencies": {
+    "bun": "^1.0.0",
+    "vue": ">=3.5",
+    "vue-jsx-vapor": ">=3.2.12"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.9.3",
+    "vue": "3.6.0-beta.10",
+    "vue-jsx-vapor": "^3.2.12"
+  },
+  "files": [
+    "src",
+    "types"
+  ],
+  "scripts": {
+    "test": "pnpm -w test --project bun-plugin-vue"
+  }
+}

package/src/index.js

@@ -0,0 +1,179 @@
+/** @import { BunPlugin, Target, Transpiler } from 'bun' */
+
+import { readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { compile } from '@tsrx/vue';
+
+const require = createRequire(import.meta.url);
+const { transformVueJsxVapor } = require('vue-jsx-vapor/api');
+
+const DEFAULT_INCLUDE = /\.tsrx$/;
+const CSS_QUERY = '?tsrx-css&lang.css';
+const CSS_QUERY_PATTERN = /\?tsrx-css&lang\.css$/;
+const DEFAULT_VAPOR_OPTIONS = {
+	macros: true,
+	compiler: {
+		runtimeModuleName: 'vue-jsx-vapor',
+	},
+};
+
+/**
+ * @typedef {{
+ * 	include?: RegExp,
+ * 	exclude?: RegExp | RegExp[],
+ * 	emitCss?: boolean,
+ * 	vapor?: {
+ * 		interop?: boolean,
+ * 		macros?: boolean | object,
+ * 		compiler?: { runtimeModuleName?: string },
+ * 	},
+ * }} TsrxVueBunPluginOptions
+ */
+
+/**
+ * @param {RegExp} pattern
+ * @param {string} value
+ * @returns {boolean}
+ */
+function test_pattern(pattern, value) {
+	pattern.lastIndex = 0;
+	return pattern.test(value);
+}
+
+/**
+ * @param {RegExp | RegExp[] | undefined} pattern
+ * @param {string} value
+ * @returns {boolean}
+ */
+function matches_pattern(pattern, value) {
+	if (!pattern) return false;
+	if (Array.isArray(pattern)) {
+		return pattern.some((entry) => test_pattern(entry, value));
+	}
+	return test_pattern(pattern, value);
+}
+
+/**
+ * @param {TsrxVueBunPluginOptions} options
+ * @param {string} value
+ * @returns {boolean}
+ */
+function should_compile(options, value) {
+	const include = options.include ?? DEFAULT_INCLUDE;
+	return test_pattern(include, value) && !matches_pattern(options.exclude, value);
+}
+
+/**
+ * @param {string} file_path
+ * @returns {string}
+ */
+function to_css_id(file_path) {
+	return file_path + CSS_QUERY;
+}
+
+/**
+ * @param {Target | undefined} target
+ * @returns {Transpiler | null}
+ */
+function create_transpiler(target) {
+	const Transpiler = globalThis.Bun?.Transpiler;
+	if (typeof Transpiler !== 'function') return null;
+
+	return new Transpiler({
+		loader: 'ts',
+		target,
+	});
+}
+
+/**
+ * @param {TsrxVueBunPluginOptions['vapor']} options
+ */
+function resolve_vapor_options(options) {
+	return {
+		...DEFAULT_VAPOR_OPTIONS,
+		...options,
+		compiler: {
+			...DEFAULT_VAPOR_OPTIONS.compiler,
+			...options?.compiler,
+		},
+	};
+}
+
+/**
+ * Bun plugin for `.tsrx` files that compiles them through `@tsrx/vue`, runs
+ * the downstream `vue-jsx-vapor` transform, then strips the remaining
+ * TypeScript syntax with Bun. Component-local styles are exposed as virtual CSS
+ * modules.
+ *
+ * @param {TsrxVueBunPluginOptions} [options]
+ * @returns {BunPlugin}
+ */
+export function tsrxVue(options = {}) {
+	const emit_css = options.emitCss ?? true;
+	const vapor_options = resolve_vapor_options(options.vapor);
+
+	/** @type {Map<string, string>} */
+	const css_cache = new Map();
+
+	return {
+		name: '@tsrx/bun-plugin-vue',
+
+		setup(build) {
+			// build.config is only present for Bun.build(); runtime registration
+			// via Bun.plugin(), including bun:test preloads, does not provide it.
+			const build_config = build.config ?? {};
+			const transpiler = create_transpiler(build_config.target);
+
+			build.onResolve({ filter: CSS_QUERY_PATTERN }, (args) => ({
+				path: args.path,
+			}));
+
+			build.onLoad({ filter: CSS_QUERY_PATTERN }, (args) => ({
+				contents: css_cache.get(args.path) ?? '',
+				loader: 'css',
+			}));
+
+			build.onLoad(
+				{ filter: options.include ?? DEFAULT_INCLUDE, namespace: 'file' },
+				async (args) => {
+					if (!should_compile(options, args.path)) return undefined;
+
+					const source = await readFile(args.path, 'utf-8');
+					const { code, css } = compile(source, args.path);
+					const css_id = to_css_id(args.path);
+
+					let output = code;
+					if (emit_css && css) {
+						css_cache.set(css_id, css);
+						output = `import ${JSON.stringify(css_id)};\n${code}`;
+					} else {
+						css_cache.delete(css_id);
+					}
+
+					const transformed = transformVueJsxVapor(
+						output,
+						args.path.replace(/\.tsrx$/, '.tsx'),
+						vapor_options,
+						false,
+						false,
+						false,
+					);
+
+					if (transpiler) {
+						return {
+							contents: transpiler.transformSync(transformed.code),
+							loader: 'js',
+						};
+					}
+
+					return {
+						contents: transformed.code,
+						loader: 'ts',
+					};
+				},
+			);
+		},
+	};
+}
+
+export default tsrxVue;

package/types/index.d.ts

@@ -0,0 +1,19 @@
+import type { BunPlugin } from 'bun';
+
+export interface TsrxVueBunPluginVaporOptions {
+	interop?: boolean;
+	macros?: boolean | object;
+	compiler?: {
+		runtimeModuleName?: string;
+	};
+}
+
+export interface TsrxVueBunPluginOptions {
+	include?: RegExp;
+	exclude?: RegExp | RegExp[];
+	emitCss?: boolean;
+	vapor?: TsrxVueBunPluginVaporOptions;
+}
+
+export function tsrxVue(options?: TsrxVueBunPluginOptions): BunPlugin;
+export default tsrxVue;