@jk2908/solas 0.1.0 → 0.1.1

package/README.md

@@ -72,23 +72,21 @@ All Solas options are passed to `solas()` inside `defineConfig`.
 
 ### `url`
 
-Use `url` to tell Solas what the public application origin is.
+`url` is optional. If you set it, Solas treats it as the public origin for your app.
 
-`url` is optional.
+Solas resolves it in this order:
 
-This happens inside `solas()` when the plugin builds its validated config object. Solas assigns `config.url` with this lookup order:
-
-- `config.url`
+- the `url` option passed to `solas()`
 - `VITE_APP_URL`
-- `APP_URL`
 
 Current behaviour:
 
 - Solas reads that value during plugin configuration.
-- Solas injects `APP_URL` and `VITE_APP_URL` into `import.meta.env`.
-- The current Solas runtime does not otherwise require `config.url` for routing, build, or prerender to work.
+- Solas exposes the resolved value as `import.meta.env.VITE_APP_URL`.
+- If `url` is set, prerender uses it as the request origin for build-time renders.
+- The runtime router does not otherwise require `config.url` for routing to work.
 
-In practice, that means you do not have to pass `url` unless your application code wants a canonical origin value, or you want to standardise that value in config rather than relying on environment variables.
+In practice, you only need `url` if your app code wants to read the public origin from `import.meta.env.VITE_APP_URL`, or if your prerendered output needs a real public origin.
 
 If you do want to set it explicitly, this is the shape:
 
@@ -102,11 +100,7 @@ export default defineConfig(({ mode }) => ({
 }))
 ```
 
-If you prefer environment variables, set one of these instead:
-
-```sh
-APP_URL=https://example.com
-```
+If you prefer an environment variable, set this instead:
 
 ```sh
 VITE_APP_URL=https://example.com

package/dist/cli.js

@@ -52,6 +52,7 @@ async function build() {
         for await (const result of Prerender.Build.run(app, manifest.prerenderedRoutes, {
             timeout,
             concurrency,
+            origin: manifest.url,
         })) {
             const route = result.route;
             try {

package/dist/index.js

@@ -21,7 +21,7 @@ function solas(c) {
     const config = Solas.Config.validate({
         ...DEFAULT_CONFIG,
         ...c,
-        url: c.url ?? process.env.VITE_APP_URL?.toString() ?? process.env.APP_URL?.toString(),
+        url: c.url ?? process.env.VITE_APP_URL?.toString(),
     });
     if (config.logger?.level)
         Logger.defaultLevel = config.logger.level;
@@ -183,8 +183,7 @@ function solas(c) {
             viteConfig.server ??= {};
             viteConfig.server.port = config.port ?? viteConfig.server.port ?? 8787;
             viteConfig.define ??= {};
-            viteConfig.define['import.meta.env.APP_URL'] = JSON.stringify(process.env.APP_URL);
-            viteConfig.define['import.meta.env.VITE_APP_URL'] = JSON.stringify(process.env.VITE_APP_URL);
+            viteConfig.define['import.meta.env.VITE_APP_URL'] = JSON.stringify(config.url);
             viteConfig.define['import.meta.env.SOLAS_VERSION'] = JSON.stringify(pkg.version);
             viteConfig.resolve ??= {};
             viteConfig.resolve.alias = {
@@ -216,6 +215,7 @@ function solas(c) {
             await Bun.write(path.join(generatedDir, 'build.json'), JSON.stringify({
                 prerenderedRoutes: Array.from(buildContext.prerenderedRoutes),
                 precompress: config.precompress,
+                url: config.url,
             }));
             logger.info('[closeBundle]', 'vite build complete');
         },

package/dist/types.d.ts

@@ -82,6 +82,7 @@ export type LooseNumber<T extends number> = T | (number & {});
 export type BuildManifest = {
     prerenderedRoutes: string[];
     precompress: boolean;
+    url?: PluginConfig['url'];
 };
 export declare namespace Route {
     type Metadata = Metadata.Item | ((input: Metadata.Input<Router.Params>) => Promise<Metadata.Item> | Metadata.Item);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jk2908/solas",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"description": "A React Server Components meta-framework powered by Vite",
 	"keywords": [
 		"framework",