@buzola/vite-plugin 0.0.8 → 0.0.10

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import * as path from 'node:path';
+import { parseArgs } from 'node:util';
+import { loadConfig } from './config.js';
+import { generate } from './generate.js';
+const { values } = parseArgs({
+    options: {
+        'routes-dir': { type: 'string', short: 'r' },
+        output: { type: 'string', short: 'o' },
+        'persistent-param': { type: 'string', multiple: true },
+        root: { type: 'string' },
+        help: { type: 'boolean', short: 'h', default: false },
+    },
+    strict: true,
+});
+if (values.help) {
+    console.log(`Usage: buzola-generate [options]
+
+Options:
+  -r, --routes-dir <path>         Routes directory (default: src/routes)
+  -o, --output <path>             Output file path (default: src/buzola.gen.ts)
+      --persistent-param <name>   Persistent parameter name (repeatable)
+      --root <path>               Project root directory (default: cwd)
+  -h, --help                      Show this help message`);
+    process.exit(0);
+}
+const root = path.resolve(values.root ?? process.cwd());
+const fileConfig = await loadConfig(root);
+const routesDir = path.resolve(root, values['routes-dir'] ?? fileConfig.routesDir ?? 'src/routes');
+const outputPath = path.resolve(root, values.output ?? fileConfig.output ?? 'src/buzola.gen.ts');
+const persistentParams = values['persistent-param'] ?? fileConfig.persistentParams;
+const changed = await generate({ routesDir, outputPath, persistentParams });
+if (changed) {
+    console.log(`Generated ${path.relative(root, outputPath)}`);
+}
+else {
+    console.log('No changes');
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE;QACR,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QACtC,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;KACrD;IACD,MAAM,EAAE,IAAI;CACZ,CAAC,CAAA;AAEF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,CAAC,GAAG,CAAC;;;;;;;yDAO4C,CAAC,CAAA;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAChB,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AACvD,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,SAAS,IAAI,YAAY,CAAC,CAAA;AAClG,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,mBAAmB,CAAC,CAAA;AAChG,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,IAAI,UAAU,CAAC,gBAAgB,CAAA;AAElF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAA;AAE3E,IAAI,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;AAC5D,CAAC;KAAM,CAAC;IACP,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;AAC1B,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+export interface BuzolaConfig {
+    /** Path to routes directory, relative to project root. Defaults to "src/routes". */
+    routesDir?: string;
+    /** Path to output generated file, relative to project root. Defaults to "src/buzola.gen.ts". */
+    output?: string;
+    /**
+     * Parameter names that should be persistent across navigations.
+     * When set, generates a BuzolaPersistentParams type augmentation
+     * so these params become optional in Link and navigate() calls.
+     */
+    persistentParams?: string[];
+}
+/**
+ * Load buzola config from the project root.
+ * Looks for `buzola.config.ts`, `buzola.config.js`, or `buzola.config.mjs`.
+ *
+ * @returns The loaded config, or an empty object if no config file is found.
+ */
+export declare function loadConfig(root: string): Promise<BuzolaConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC5B,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAID;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAUpE"}

package/dist/config.js

@@ -0,0 +1,20 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const CONFIG_FILES = ['buzola.config.ts', 'buzola.config.js', 'buzola.config.mjs'];
+/**
+ * Load buzola config from the project root.
+ * Looks for `buzola.config.ts`, `buzola.config.js`, or `buzola.config.mjs`.
+ *
+ * @returns The loaded config, or an empty object if no config file is found.
+ */
+export async function loadConfig(root) {
+    for (const file of CONFIG_FILES) {
+        const configPath = path.resolve(root, file);
+        if (!fs.existsSync(configPath))
+            continue;
+        const mod = await import(configPath);
+        return mod.default ?? mod;
+    }
+    return {};
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAejC,MAAM,YAAY,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;AAElF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC5C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAQ;QAExC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;QACpC,OAAO,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA;IAC1B,CAAC;IAED,OAAO,EAAE,CAAA;AACV,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,26 @@
+import type { ModuleLoader } from './generator/page-extractor.js';
+export interface GenerateOptions {
+    /** Absolute path to the routes directory. */
+    routesDir: string;
+    /** Absolute path to the output file. */
+    outputPath: string;
+    /** Parameter names that should be persistent across navigations. */
+    persistentParams?: string[];
+    /** Custom module loader. Defaults to native `import()`. */
+    moduleLoader?: ModuleLoader;
+}
+/**
+ * Generate the `buzola.gen.ts` route module from a routes directory.
+ *
+ * Works standalone (no Vite required) — uses native `import()` as the
+ * default module loader. Pass a custom `moduleLoader` to integrate with
+ * Vite's `ssrLoadModule` or other bundlers.
+ *
+ * Note: The default module loader uses native `import()`, which can load
+ * `.ts`/`.tsx` files with Bun but not with Node.js. For Node.js, provide
+ * a custom `moduleLoader` (e.g. via Vite's `ssrLoadModule`).
+ *
+ * @returns `true` if the output file was written (content changed), `false` otherwise.
+ */
+export declare function generate(options: GenerateOptions): Promise<boolean>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAIjE,MAAM,WAAW,eAAe;IAC/B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAYzE"}

package/dist/generate.js

@@ -0,0 +1,44 @@
+import * as fs from 'node:fs';
+import { generateRouteModule } from './generator/codegen.js';
+import { scanRouteFiles } from './generator/scanner.js';
+import { buildFileRouteTree } from './generator/tree-builder.js';
+/**
+ * Generate the `buzola.gen.ts` route module from a routes directory.
+ *
+ * Works standalone (no Vite required) — uses native `import()` as the
+ * default module loader. Pass a custom `moduleLoader` to integrate with
+ * Vite's `ssrLoadModule` or other bundlers.
+ *
+ * Note: The default module loader uses native `import()`, which can load
+ * `.ts`/`.tsx` files with Bun but not with Node.js. For Node.js, provide
+ * a custom `moduleLoader` (e.g. via Vite's `ssrLoadModule`).
+ *
+ * @returns `true` if the output file was written (content changed), `false` otherwise.
+ */
+export async function generate(options) {
+    const { routesDir, outputPath, persistentParams, moduleLoader = defaultModuleLoader } = options;
+    if (!fs.existsSync(routesDir)) {
+        throw new Error(`Routes directory does not exist: ${routesDir}`);
+    }
+    const files = scanRouteFiles(routesDir);
+    const tree = await buildFileRouteTree(files, moduleLoader);
+    const code = generateRouteModule({ tree, routesDir, outputPath, persistentParams });
+    return writeIfChanged(outputPath, code);
+}
+async function defaultModuleLoader(absolutePath) {
+    try {
+        return await import(absolutePath);
+    }
+    catch (error) {
+        throw new Error(`Failed to load module "${absolutePath}". The default module loader uses native import() which `
+            + `supports .ts/.tsx files with Bun but not Node.js. For Node.js, provide a custom moduleLoader option.`, { cause: error });
+    }
+}
+function writeIfChanged(filePath, content) {
+    if (fs.existsSync(filePath) && fs.readFileSync(filePath, 'utf-8') === content) {
+        return false;
+    }
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return true;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAahE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACtD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,GAAG,mBAAmB,EAAE,GAAG,OAAO,CAAA;IAE/F,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IAC1D,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAA;IAEnF,OAAO,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACxC,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,YAAoB;IACtD,IAAI,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACd,0BAA0B,YAAY,0DAA0D;cAC7F,sGAAsG,EACzG,EAAE,KAAK,EAAE,KAAK,EAAE,CAChB,CAAA;IACF,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAe;IACxD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAA;IACb,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 export { buzolaPlugin } from './plugin.js';
 export type { BuzolaPluginOptions } from './plugin.js';
+export { generate } from './generate.js';
+export type { GenerateOptions } from './generate.js';
+export { loadConfig } from './config.js';
+export type { BuzolaConfig } from './config.js';
 export { scanRouteFiles } from './generator/scanner.js';
 export type { ScannedFile } from './generator/scanner.js';
 export { buildFileRouteTree } from './generator/tree-builder.js';

package/dist/index.d.ts.map

@@ -1 +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;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAEhG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA"}
+{"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;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAEhG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -1,4 +1,6 @@
 export { buzolaPlugin } from './plugin.js';
+export { generate } from './generate.js';
+export { loadConfig } from './config.js';
 export { scanRouteFiles } from './generator/scanner.js';
 export { buildFileRouteTree } from './generator/tree-builder.js';
 export { generateRouteModule } from './generator/codegen.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAG5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAG5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/plugin.d.ts

@@ -30,6 +30,9 @@ export interface BuzolaPluginOptions {
  * - BuzolaPageMap type augmentation
  *
  * Provides `virtual:buzola/routes` virtual module.
+ *
+ * Options can also be provided via `buzola.config.ts` in the project root.
+ * Plugin options take precedence over the config file.
  */
 export declare function buzolaPlugin(options?: BuzolaPluginOptions): Plugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAMjD,MAAM,WAAW,mBAAmB;IACnC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA+FtE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAIjD,MAAM,WAAW,mBAAmB;IACnC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAqFtE"}

package/dist/plugin.js

@@ -1,8 +1,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { generateRouteModule } from './generator/codegen.js';
-import { scanRouteFiles } from './generator/scanner.js';
-import { buildFileRouteTree } from './generator/tree-builder.js';
+import { loadConfig } from './config.js';
+import { generate } from './generate.js';
 /**
  * Vite plugin for Buzola page-centric routing.
  *
@@ -13,43 +12,41 @@ import { buildFileRouteTree } from './generator/tree-builder.js';
  * - BuzolaPageMap type augmentation
  *
  * Provides `virtual:buzola/routes` virtual module.
+ *
+ * Options can also be provided via `buzola.config.ts` in the project root.
+ * Plugin options take precedence over the config file.
  */
 export function buzolaPlugin(options = {}) {
-    const { name: nameOption, routesDir: routesDirOption = 'src/routes', output: outputOption = 'src/buzola.gen.ts', persistentParams: persistentParamsOption, } = options;
+    const { name: nameOption } = options;
     const pluginName = nameOption ? `buzola:${nameOption}` : 'buzola';
     const virtualModuleId = nameOption ? `virtual:buzola/${nameOption}/routes` : 'virtual:buzola/routes';
     const resolvedVirtualId = '\0' + virtualModuleId;
     let root;
-    let routesDir;
-    let outputPath;
+    let baseOptions;
     let server;
-    async function generate(moduleLoader) {
-        const files = scanRouteFiles(routesDir);
-        const tree = await buildFileRouteTree(files, moduleLoader);
-        const code = generateRouteModule({
-            tree,
-            routesDir,
-            outputPath,
-            persistentParams: persistentParamsOption,
-        });
-        return writeIfChanged(outputPath, code);
-    }
     return {
         name: pluginName,
         enforce: 'pre',
-        configResolved(config) {
+        async configResolved(config) {
             root = config.root;
-            routesDir = path.resolve(root, routesDirOption);
-            outputPath = path.resolve(root, outputOption);
+            const fileConfig = await loadConfig(root);
+            const routesDir = options.routesDir ?? fileConfig.routesDir ?? 'src/routes';
+            const output = options.output ?? fileConfig.output ?? 'src/buzola.gen.ts';
+            const persistentParams = options.persistentParams ?? fileConfig.persistentParams;
+            baseOptions = {
+                routesDir: path.resolve(root, routesDir),
+                outputPath: path.resolve(root, output),
+                persistentParams,
+            };
         },
         configureServer(srv) {
             server = srv;
         },
         async buildStart() {
-            if (!fs.existsSync(routesDir))
+            if (!fs.existsSync(baseOptions.routesDir))
                 return;
             if (server) {
-                await generate((p) => server.ssrLoadModule(p));
+                await generate({ ...baseOptions, moduleLoader: (p) => server.ssrLoadModule(p) });
             }
             else {
                 // Production build — create a temporary Vite server for module loading
@@ -61,7 +58,7 @@ export function buzolaPlugin(options = {}) {
                     optimizeDeps: { noDiscovery: true },
                 });
                 try {
-                    await generate((p) => tempServer.ssrLoadModule(p));
+                    await generate({ ...baseOptions, moduleLoader: (p) => tempServer.ssrLoadModule(p) });
                 }
                 finally {
                     await tempServer.close();
@@ -75,13 +72,13 @@ export function buzolaPlugin(options = {}) {
         },
         load(id) {
             if (id === resolvedVirtualId) {
-                return `export { routes, pageRegistry } from '${outputPath.replace(/\.ts$/, '')}';\n`;
+                return `export { routes, pageRegistry } from '${baseOptions.outputPath.replace(/\.ts$/, '')}';\n`;
             }
         },
         async handleHotUpdate({ file }) {
-            if (!file.startsWith(routesDir) || !server)
+            if (!file.startsWith(baseOptions.routesDir) || !server)
                 return;
-            const changed = await generate((p) => server.ssrLoadModule(p));
+            const changed = await generate({ ...baseOptions, moduleLoader: (p) => server.ssrLoadModule(p) });
             if (!changed)
                 return;
             // Invalidate the virtual module so Vite re-evaluates it.
@@ -96,11 +93,4 @@ export function buzolaPlugin(options = {}) {
         },
     };
 }
-function writeIfChanged(filePath, content) {
-    if (fs.existsSync(filePath) && fs.readFileSync(filePath, 'utf-8') === content) {
-        return false;
-    }
-    fs.writeFileSync(filePath, content, 'utf-8');
-    return true;
-}
 //# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/package.json

@@ -1,9 +1,12 @@
 {
 	"name": "@buzola/vite-plugin",
-	"version": "0.0.8",
+	"version": "0.0.10",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
+	"bin": {
+		"buzola": "./dist/cli.js"
+	},
 	"exports": {
 		".": {
 			"bun": "./src/index.ts",
@@ -21,7 +24,7 @@
 		"directory": "packages/vite-plugin"
 	},
 	"dependencies": {
-		"@buzola/router": "^0.0.8"
+		"@buzola/router": "^0.0.10"
 	},
 	"devDependencies": {
 		"@types/node": "^25.3.3",

package/src/cli.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import * as path from 'node:path'
+import { parseArgs } from 'node:util'
+import { loadConfig } from './config.js'
+import { generate } from './generate.js'
+
+const { values } = parseArgs({
+	options: {
+		'routes-dir': { type: 'string', short: 'r' },
+		output: { type: 'string', short: 'o' },
+		'persistent-param': { type: 'string', multiple: true },
+		root: { type: 'string' },
+		help: { type: 'boolean', short: 'h', default: false },
+	},
+	strict: true,
+})
+
+if (values.help) {
+	console.log(`Usage: buzola-generate [options]
+
+Options:
+  -r, --routes-dir <path>         Routes directory (default: src/routes)
+  -o, --output <path>             Output file path (default: src/buzola.gen.ts)
+      --persistent-param <name>   Persistent parameter name (repeatable)
+      --root <path>               Project root directory (default: cwd)
+  -h, --help                      Show this help message`)
+	process.exit(0)
+}
+
+const root = path.resolve(values.root ?? process.cwd())
+const fileConfig = await loadConfig(root)
+
+const routesDir = path.resolve(root, values['routes-dir'] ?? fileConfig.routesDir ?? 'src/routes')
+const outputPath = path.resolve(root, values.output ?? fileConfig.output ?? 'src/buzola.gen.ts')
+const persistentParams = values['persistent-param'] ?? fileConfig.persistentParams
+
+const changed = await generate({ routesDir, outputPath, persistentParams })
+
+if (changed) {
+	console.log(`Generated ${path.relative(root, outputPath)}`)
+} else {
+	console.log('No changes')
+}

package/src/config.ts

@@ -0,0 +1,35 @@
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+
+export interface BuzolaConfig {
+	/** Path to routes directory, relative to project root. Defaults to "src/routes". */
+	routesDir?: string
+	/** Path to output generated file, relative to project root. Defaults to "src/buzola.gen.ts". */
+	output?: string
+	/**
+	 * Parameter names that should be persistent across navigations.
+	 * When set, generates a BuzolaPersistentParams type augmentation
+	 * so these params become optional in Link and navigate() calls.
+	 */
+	persistentParams?: string[]
+}
+
+const CONFIG_FILES = ['buzola.config.ts', 'buzola.config.js', 'buzola.config.mjs']
+
+/**
+ * Load buzola config from the project root.
+ * Looks for `buzola.config.ts`, `buzola.config.js`, or `buzola.config.mjs`.
+ *
+ * @returns The loaded config, or an empty object if no config file is found.
+ */
+export async function loadConfig(root: string): Promise<BuzolaConfig> {
+	for (const file of CONFIG_FILES) {
+		const configPath = path.resolve(root, file)
+		if (!fs.existsSync(configPath)) continue
+
+		const mod = await import(configPath)
+		return mod.default ?? mod
+	}
+
+	return {}
+}

package/src/generate.ts

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs'
+import { generateRouteModule } from './generator/codegen.js'
+import type { ModuleLoader } from './generator/page-extractor.js'
+import { scanRouteFiles } from './generator/scanner.js'
+import { buildFileRouteTree } from './generator/tree-builder.js'
+
+export interface GenerateOptions {
+	/** Absolute path to the routes directory. */
+	routesDir: string
+	/** Absolute path to the output file. */
+	outputPath: string
+	/** Parameter names that should be persistent across navigations. */
+	persistentParams?: string[]
+	/** Custom module loader. Defaults to native `import()`. */
+	moduleLoader?: ModuleLoader
+}
+
+/**
+ * Generate the `buzola.gen.ts` route module from a routes directory.
+ *
+ * Works standalone (no Vite required) — uses native `import()` as the
+ * default module loader. Pass a custom `moduleLoader` to integrate with
+ * Vite's `ssrLoadModule` or other bundlers.
+ *
+ * Note: The default module loader uses native `import()`, which can load
+ * `.ts`/`.tsx` files with Bun but not with Node.js. For Node.js, provide
+ * a custom `moduleLoader` (e.g. via Vite's `ssrLoadModule`).
+ *
+ * @returns `true` if the output file was written (content changed), `false` otherwise.
+ */
+export async function generate(options: GenerateOptions): Promise<boolean> {
+	const { routesDir, outputPath, persistentParams, moduleLoader = defaultModuleLoader } = options
+
+	if (!fs.existsSync(routesDir)) {
+		throw new Error(`Routes directory does not exist: ${routesDir}`)
+	}
+
+	const files = scanRouteFiles(routesDir)
+	const tree = await buildFileRouteTree(files, moduleLoader)
+	const code = generateRouteModule({ tree, routesDir, outputPath, persistentParams })
+
+	return writeIfChanged(outputPath, code)
+}
+
+async function defaultModuleLoader(absolutePath: string): Promise<Record<string, unknown>> {
+	try {
+		return await import(absolutePath)
+	} catch (error) {
+		throw new Error(
+			`Failed to load module "${absolutePath}". The default module loader uses native import() which `
+				+ `supports .ts/.tsx files with Bun but not Node.js. For Node.js, provide a custom moduleLoader option.`,
+			{ cause: error },
+		)
+	}
+}
+
+function writeIfChanged(filePath: string, content: string): boolean {
+	if (fs.existsSync(filePath) && fs.readFileSync(filePath, 'utf-8') === content) {
+		return false
+	}
+
+	fs.writeFileSync(filePath, content, 'utf-8')
+	return true
+}

package/src/index.ts

@@ -1,6 +1,12 @@
 export { buzolaPlugin } from './plugin.js'
 export type { BuzolaPluginOptions } from './plugin.js'
 
+export { generate } from './generate.js'
+export type { GenerateOptions } from './generate.js'
+
+export { loadConfig } from './config.js'
+export type { BuzolaConfig } from './config.js'
+
 export { scanRouteFiles } from './generator/scanner.js'
 export type { ScannedFile } from './generator/scanner.js'
 

package/src/plugin.ts

@@ -1,10 +1,8 @@
 import * as fs from 'node:fs'
 import * as path from 'node:path'
 import type { Plugin, ViteDevServer } from 'vite'
-import { generateRouteModule } from './generator/codegen.js'
-import type { ModuleLoader } from './generator/page-extractor.js'
-import { scanRouteFiles } from './generator/scanner.js'
-import { buildFileRouteTree } from './generator/tree-builder.js'
+import { loadConfig } from './config.js'
+import { generate, type GenerateOptions } from './generate.js'
 
 export interface BuzolaPluginOptions {
 	/**
@@ -38,45 +36,38 @@ export interface BuzolaPluginOptions {
  * - BuzolaPageMap type augmentation
  *
  * Provides `virtual:buzola/routes` virtual module.
+ *
+ * Options can also be provided via `buzola.config.ts` in the project root.
+ * Plugin options take precedence over the config file.
  */
 export function buzolaPlugin(options: BuzolaPluginOptions = {}): Plugin {
-	const {
-		name: nameOption,
-		routesDir: routesDirOption = 'src/routes',
-		output: outputOption = 'src/buzola.gen.ts',
-		persistentParams: persistentParamsOption,
-	} = options
+	const { name: nameOption } = options
 
 	const pluginName = nameOption ? `buzola:${nameOption}` : 'buzola'
 	const virtualModuleId = nameOption ? `virtual:buzola/${nameOption}/routes` : 'virtual:buzola/routes'
 	const resolvedVirtualId = '\0' + virtualModuleId
 
 	let root: string
-	let routesDir: string
-	let outputPath: string
+	let baseOptions: Omit<GenerateOptions, 'moduleLoader'>
 	let server: ViteDevServer | undefined
 
-	async function generate(moduleLoader: ModuleLoader): Promise<boolean> {
-		const files = scanRouteFiles(routesDir)
-		const tree = await buildFileRouteTree(files, moduleLoader)
-		const code = generateRouteModule({
-			tree,
-			routesDir,
-			outputPath,
-			persistentParams: persistentParamsOption,
-		})
-
-		return writeIfChanged(outputPath, code)
-	}
-
 	return {
 		name: pluginName,
 		enforce: 'pre',
 
-		configResolved(config) {
+		async configResolved(config) {
 			root = config.root
-			routesDir = path.resolve(root, routesDirOption)
-			outputPath = path.resolve(root, outputOption)
+			const fileConfig = await loadConfig(root)
+
+			const routesDir = options.routesDir ?? fileConfig.routesDir ?? 'src/routes'
+			const output = options.output ?? fileConfig.output ?? 'src/buzola.gen.ts'
+			const persistentParams = options.persistentParams ?? fileConfig.persistentParams
+
+			baseOptions = {
+				routesDir: path.resolve(root, routesDir),
+				outputPath: path.resolve(root, output),
+				persistentParams,
+			}
 		},
 
 		configureServer(srv) {
@@ -84,10 +75,10 @@ export function buzolaPlugin(options: BuzolaPluginOptions = {}): Plugin {
 		},
 
 		async buildStart() {
-			if (!fs.existsSync(routesDir)) return
+			if (!fs.existsSync(baseOptions.routesDir)) return
 
 			if (server) {
-				await generate((p) => server!.ssrLoadModule(p))
+				await generate({ ...baseOptions, moduleLoader: (p) => server!.ssrLoadModule(p) })
 			} else {
 				// Production build — create a temporary Vite server for module loading
 				const { createServer } = await import('vite')
@@ -98,7 +89,7 @@ export function buzolaPlugin(options: BuzolaPluginOptions = {}): Plugin {
 					optimizeDeps: { noDiscovery: true },
 				})
 				try {
-					await generate((p) => tempServer.ssrLoadModule(p))
+					await generate({ ...baseOptions, moduleLoader: (p) => tempServer.ssrLoadModule(p) })
 				} finally {
 					await tempServer.close()
 				}
@@ -113,14 +104,14 @@ export function buzolaPlugin(options: BuzolaPluginOptions = {}): Plugin {
 
 		load(id) {
 			if (id === resolvedVirtualId) {
-				return `export { routes, pageRegistry } from '${outputPath.replace(/\.ts$/, '')}';\n`
+				return `export { routes, pageRegistry } from '${baseOptions.outputPath.replace(/\.ts$/, '')}';\n`
 			}
 		},
 
 		async handleHotUpdate({ file }) {
-			if (!file.startsWith(routesDir) || !server) return
+			if (!file.startsWith(baseOptions.routesDir) || !server) return
 
-			const changed = await generate((p) => server!.ssrLoadModule(p))
+			const changed = await generate({ ...baseOptions, moduleLoader: (p) => server!.ssrLoadModule(p) })
 			if (!changed) return
 
 			// Invalidate the virtual module so Vite re-evaluates it.
@@ -135,12 +126,3 @@ export function buzolaPlugin(options: BuzolaPluginOptions = {}): Plugin {
 		},
 	}
 }
-
-function writeIfChanged(filePath: string, content: string): boolean {
-	if (fs.existsSync(filePath) && fs.readFileSync(filePath, 'utf-8') === content) {
-		return false
-	}
-
-	fs.writeFileSync(filePath, content, 'utf-8')
-	return true
-}