@buzola/bun-plugin 0.0.1

package/dist/__tests__/plugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.test.d.ts.map

package/dist/__tests__/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/plugin.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/plugin.test.js

@@ -0,0 +1,127 @@
+import { describe, expect, it } from 'bun:test';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { buzolaPlugin } from '../plugin.js';
+async function runSetup(plugin) {
+    const captured = {};
+    const mockBuild = {
+        onResolve: (_opts, fn) => {
+            captured.resolve = fn;
+        },
+        onLoad: (_opts, fn) => {
+            captured.load = fn;
+        },
+    };
+    await plugin.setup(mockBuild);
+    return captured;
+}
+function makeEmptyRoutesFixture() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'buzola-bun-test-'));
+    fs.mkdirSync(path.join(root, 'routes'));
+    return {
+        root,
+        cleanup: () => fs.rmSync(root, { recursive: true, force: true }),
+    };
+}
+describe('buzolaPlugin (Bun)', () => {
+    it('uses default plugin name and virtual module ID', async () => {
+        const { root, cleanup } = makeEmptyRoutesFixture();
+        try {
+            const plugin = buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' });
+            expect(plugin.name).toBe('buzola');
+            const handlers = await runSetup(plugin);
+            expect(handlers.resolve({ path: 'virtual:buzola/routes' })).toEqual({
+                path: 'virtual:buzola/routes',
+                namespace: 'buzola',
+            });
+            expect(handlers.resolve({ path: 'virtual:buzola/other' })).toBeUndefined();
+        }
+        finally {
+            cleanup();
+        }
+    });
+    it('uses named plugin and virtual module ID when name is set', async () => {
+        const { root, cleanup } = makeEmptyRoutesFixture();
+        try {
+            const plugin = buzolaPlugin({
+                root,
+                routesDir: 'routes',
+                output: 'buzola.gen.ts',
+                name: 'admin',
+            });
+            expect(plugin.name).toBe('buzola:admin');
+            const handlers = await runSetup(plugin);
+            expect(handlers.resolve({ path: 'virtual:buzola/admin/routes' })).toEqual({
+                path: 'virtual:buzola/admin/routes',
+                namespace: 'buzola',
+            });
+            expect(handlers.resolve({ path: 'virtual:buzola/routes' })).toBeUndefined();
+        }
+        finally {
+            cleanup();
+        }
+    });
+    it('onLoad returns a ts module re-exporting from the generated file', async () => {
+        const { root, cleanup } = makeEmptyRoutesFixture();
+        try {
+            const plugin = buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' });
+            const handlers = await runSetup(plugin);
+            const result = handlers.load({});
+            expect(result.loader).toBe('ts');
+            expect(result.contents).toContain('export { routes, pageRegistry }');
+            expect(result.contents).toContain(JSON.stringify(path.join(root, 'buzola.gen')));
+        }
+        finally {
+            cleanup();
+        }
+    });
+    it('writes buzola.gen.ts during setup when routes dir exists', async () => {
+        const { root, cleanup } = makeEmptyRoutesFixture();
+        try {
+            const outputPath = path.join(root, 'buzola.gen.ts');
+            const plugin = buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' });
+            expect(fs.existsSync(outputPath)).toBe(false);
+            await runSetup(plugin);
+            expect(fs.existsSync(outputPath)).toBe(true);
+            expect(fs.readFileSync(outputPath, 'utf-8')).toContain('pageRegistry');
+        }
+        finally {
+            cleanup();
+        }
+    });
+    it('skips generation when routes dir does not exist', async () => {
+        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'buzola-bun-test-'));
+        try {
+            const outputPath = path.join(root, 'buzola.gen.ts');
+            const plugin = buzolaPlugin({ root, routesDir: 'nonexistent', output: 'buzola.gen.ts' });
+            await runSetup(plugin);
+            expect(fs.existsSync(outputPath)).toBe(false);
+        }
+        finally {
+            fs.rmSync(root, { recursive: true, force: true });
+        }
+    });
+    it('Bun.build resolves virtual:buzola/routes through the plugin', async () => {
+        const { root, cleanup } = makeEmptyRoutesFixture();
+        try {
+            const entryPath = path.join(root, 'entry.ts');
+            fs.writeFileSync(entryPath, `import { routes, pageRegistry } from 'virtual:buzola/routes'\nexport { routes, pageRegistry }\n`);
+            const result = await Bun.build({
+                entrypoints: [entryPath],
+                plugins: [buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' })],
+                target: 'browser',
+                external: ['react', '@buzola/router'],
+            });
+            expect(result.success).toBe(true);
+            expect(result.outputs.length).toBeGreaterThan(0);
+            const bundle = await result.outputs[0].text();
+            expect(bundle).toContain('pageRegistry');
+            expect(bundle).toContain('buildRouteTree');
+        }
+        finally {
+            cleanup();
+        }
+    });
+});
+//# sourceMappingURL=plugin.test.js.map

package/dist/__tests__/plugin.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.js","sourceRoot":"","sources":["../../src/__tests__/plugin.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { buzolaPlugin } from './plugin.js';
+export type { BuzolaPluginOptions } from './plugin.js';
+//# 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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { buzolaPlugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/plugin.d.ts

@@ -0,0 +1,13 @@
+import { type BasePluginOptions } from '@buzola/codegen';
+import type { BunPlugin } from 'bun';
+export interface BuzolaPluginOptions extends BasePluginOptions {
+}
+/**
+ * Bun plugin for Buzola page-centric routing. Scans the routes directory,
+ * generates `buzola.gen.ts`, and exposes the `virtual:buzola/routes` module.
+ *
+ * Options can also be provided via `buzola.config.ts` in the project root;
+ * plugin options take precedence. See `examples/bun` for a `Bun.build` setup.
+ */
+export declare function buzolaPlugin(options?: BuzolaPluginOptions): BunPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EAOtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;CAAG;AAEjE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAqBzE"}

package/dist/plugin.js

@@ -0,0 +1,29 @@
+import { buildVirtualSource, BUZOLA_NAMESPACE, generate, resolveOptions, resolveVirtualModuleId, VIRTUAL_ID_PATTERN, } from '@buzola/codegen';
+/**
+ * Bun plugin for Buzola page-centric routing. Scans the routes directory,
+ * generates `buzola.gen.ts`, and exposes the `virtual:buzola/routes` module.
+ *
+ * Options can also be provided via `buzola.config.ts` in the project root;
+ * plugin options take precedence. See `examples/bun` for a `Bun.build` setup.
+ */
+export function buzolaPlugin(options = {}) {
+    const { pluginName, id: virtualId } = resolveVirtualModuleId(options.name);
+    return {
+        name: pluginName,
+        async setup(build) {
+            const generateOptions = await resolveOptions(options);
+            await generate({ ...generateOptions, optional: true });
+            const virtualSource = buildVirtualSource(generateOptions.outputPath);
+            build.onResolve({ filter: VIRTUAL_ID_PATTERN }, args => {
+                if (args.path !== virtualId)
+                    return;
+                return { path: args.path, namespace: BUZOLA_NAMESPACE };
+            });
+            build.onLoad({ filter: /.*/, namespace: BUZOLA_NAMESPACE }, () => ({
+                contents: virtualSource,
+                loader: 'ts',
+            }));
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,iBAAiB,CAAA;AAKxB;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC7D,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1E,OAAO;QACN,IAAI,EAAE,UAAU;QAChB,KAAK,CAAC,KAAK,CAAC,KAAK;YAChB,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAA;YACrD,MAAM,QAAQ,CAAC,EAAE,GAAG,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YACtD,MAAM,aAAa,GAAG,kBAAkB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;YAEpE,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACtD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;oBAAE,OAAM;gBACnC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAA;YACxD,CAAC,CAAC,CAAA;YAEF,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClE,QAAQ,EAAE,aAAa;gBACvB,MAAM,EAAE,IAAI;aACZ,CAAC,CAAC,CAAA;QACJ,CAAC;KACD,CAAA;AACF,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+	"name": "@buzola/bun-plugin",
+	"version": "0.0.1",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"bun": "./src/index.ts",
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/contember/buzola",
+		"directory": "packages/bun-plugin"
+	},
+	"dependencies": {
+		"@buzola/codegen": "^0.0.1",
+		"@buzola/router": "^0.0.11"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^25.3.3",
+		"typescript": "^5.7.0"
+	}
+}

package/src/__tests__/plugin.test.ts

@@ -0,0 +1,148 @@
+import { describe, expect, it } from 'bun:test'
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
+import { buzolaPlugin } from '../plugin.js'
+
+type ResolveHandler = (args: { path: string }) => unknown
+type LoadHandler = (args: unknown) => { contents: string; loader: string }
+
+interface CapturedHandlers {
+	resolve?: ResolveHandler
+	load?: LoadHandler
+}
+
+async function runSetup(plugin: { setup: (build: never) => void | Promise<void> }): Promise<CapturedHandlers> {
+	const captured: CapturedHandlers = {}
+	const mockBuild = {
+		onResolve: (_opts: unknown, fn: ResolveHandler) => {
+			captured.resolve = fn
+		},
+		onLoad: (_opts: unknown, fn: LoadHandler) => {
+			captured.load = fn
+		},
+	}
+	await plugin.setup(mockBuild as never)
+	return captured
+}
+
+function makeEmptyRoutesFixture(): { root: string; cleanup: () => void } {
+	const root = fs.mkdtempSync(path.join(os.tmpdir(), 'buzola-bun-test-'))
+	fs.mkdirSync(path.join(root, 'routes'))
+	return {
+		root,
+		cleanup: () => fs.rmSync(root, { recursive: true, force: true }),
+	}
+}
+
+describe('buzolaPlugin (Bun)', () => {
+	it('uses default plugin name and virtual module ID', async () => {
+		const { root, cleanup } = makeEmptyRoutesFixture()
+		try {
+			const plugin = buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' })
+			expect(plugin.name).toBe('buzola')
+
+			const handlers = await runSetup(plugin)
+			expect(handlers.resolve!({ path: 'virtual:buzola/routes' })).toEqual({
+				path: 'virtual:buzola/routes',
+				namespace: 'buzola',
+			})
+			expect(handlers.resolve!({ path: 'virtual:buzola/other' })).toBeUndefined()
+		} finally {
+			cleanup()
+		}
+	})
+
+	it('uses named plugin and virtual module ID when name is set', async () => {
+		const { root, cleanup } = makeEmptyRoutesFixture()
+		try {
+			const plugin = buzolaPlugin({
+				root,
+				routesDir: 'routes',
+				output: 'buzola.gen.ts',
+				name: 'admin',
+			})
+			expect(plugin.name).toBe('buzola:admin')
+
+			const handlers = await runSetup(plugin)
+			expect(handlers.resolve!({ path: 'virtual:buzola/admin/routes' })).toEqual({
+				path: 'virtual:buzola/admin/routes',
+				namespace: 'buzola',
+			})
+			expect(handlers.resolve!({ path: 'virtual:buzola/routes' })).toBeUndefined()
+		} finally {
+			cleanup()
+		}
+	})
+
+	it('onLoad returns a ts module re-exporting from the generated file', async () => {
+		const { root, cleanup } = makeEmptyRoutesFixture()
+		try {
+			const plugin = buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' })
+			const handlers = await runSetup(plugin)
+			const result = handlers.load!({})
+			expect(result.loader).toBe('ts')
+			expect(result.contents).toContain('export { routes, pageRegistry }')
+			expect(result.contents).toContain(JSON.stringify(path.join(root, 'buzola.gen')))
+		} finally {
+			cleanup()
+		}
+	})
+
+	it('writes buzola.gen.ts during setup when routes dir exists', async () => {
+		const { root, cleanup } = makeEmptyRoutesFixture()
+		try {
+			const outputPath = path.join(root, 'buzola.gen.ts')
+			const plugin = buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' })
+			expect(fs.existsSync(outputPath)).toBe(false)
+
+			await runSetup(plugin)
+
+			expect(fs.existsSync(outputPath)).toBe(true)
+			expect(fs.readFileSync(outputPath, 'utf-8')).toContain('pageRegistry')
+		} finally {
+			cleanup()
+		}
+	})
+
+	it('skips generation when routes dir does not exist', async () => {
+		const root = fs.mkdtempSync(path.join(os.tmpdir(), 'buzola-bun-test-'))
+		try {
+			const outputPath = path.join(root, 'buzola.gen.ts')
+			const plugin = buzolaPlugin({ root, routesDir: 'nonexistent', output: 'buzola.gen.ts' })
+
+			await runSetup(plugin)
+
+			expect(fs.existsSync(outputPath)).toBe(false)
+		} finally {
+			fs.rmSync(root, { recursive: true, force: true })
+		}
+	})
+
+	it('Bun.build resolves virtual:buzola/routes through the plugin', async () => {
+		const { root, cleanup } = makeEmptyRoutesFixture()
+		try {
+			const entryPath = path.join(root, 'entry.ts')
+			fs.writeFileSync(
+				entryPath,
+				`import { routes, pageRegistry } from 'virtual:buzola/routes'\nexport { routes, pageRegistry }\n`,
+			)
+
+			const result = await Bun.build({
+				entrypoints: [entryPath],
+				plugins: [buzolaPlugin({ root, routesDir: 'routes', output: 'buzola.gen.ts' })],
+				target: 'browser',
+				external: ['react', '@buzola/router'],
+			})
+
+			expect(result.success).toBe(true)
+			expect(result.outputs.length).toBeGreaterThan(0)
+
+			const bundle = await result.outputs[0]!.text()
+			expect(bundle).toContain('pageRegistry')
+			expect(bundle).toContain('buildRouteTree')
+		} finally {
+			cleanup()
+		}
+	})
+})

package/src/index.ts

@@ -0,0 +1,2 @@
+export { buzolaPlugin } from './plugin.js'
+export type { BuzolaPluginOptions } from './plugin.js'

package/src/plugin.ts

@@ -0,0 +1,42 @@
+import {
+	type BasePluginOptions,
+	buildVirtualSource,
+	BUZOLA_NAMESPACE,
+	generate,
+	resolveOptions,
+	resolveVirtualModuleId,
+	VIRTUAL_ID_PATTERN,
+} from '@buzola/codegen'
+import type { BunPlugin } from 'bun'
+
+export interface BuzolaPluginOptions extends BasePluginOptions {}
+
+/**
+ * Bun plugin for Buzola page-centric routing. Scans the routes directory,
+ * generates `buzola.gen.ts`, and exposes the `virtual:buzola/routes` module.
+ *
+ * Options can also be provided via `buzola.config.ts` in the project root;
+ * plugin options take precedence. See `examples/bun` for a `Bun.build` setup.
+ */
+export function buzolaPlugin(options: BuzolaPluginOptions = {}): BunPlugin {
+	const { pluginName, id: virtualId } = resolveVirtualModuleId(options.name)
+
+	return {
+		name: pluginName,
+		async setup(build) {
+			const generateOptions = await resolveOptions(options)
+			await generate({ ...generateOptions, optional: true })
+			const virtualSource = buildVirtualSource(generateOptions.outputPath)
+
+			build.onResolve({ filter: VIRTUAL_ID_PATTERN }, args => {
+				if (args.path !== virtualId) return
+				return { path: args.path, namespace: BUZOLA_NAMESPACE }
+			})
+
+			build.onLoad({ filter: /.*/, namespace: BUZOLA_NAMESPACE }, () => ({
+				contents: virtualSource,
+				loader: 'ts',
+			}))
+		},
+	}
+}