@ressjs/vite-router 0.5.2 → 0.6.0-rc.0

package/dist/pages.js

@@ -1,54 +1,15 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertRouteToExpress = convertRouteToExpress;
 exports.getPages = getPages;
-exports.getViteInput = getViteInput;
 exports.getViteSSRInput = getViteSSRInput;
-exports.loadManifest = loadManifest;
-exports.getCompiledProdPage = getCompiledProdPage;
-exports.resolvePlatformCSS = resolvePlatformCSS;
-exports.generateTempEntries = generateTempEntries;
-exports.generateSingleEntry = generateSingleEntry;
-exports.getClientEntriesInput = getClientEntriesInput;
-const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const fast_glob_1 = __importDefault(require("fast-glob"));
+const catalog_1 = require("./variants/catalog");
+const module_extensions_1 = require("./fs/module-extensions");
 /**
  * Convierte rutas estilo Next.js con parámetros dinámicos a formato Express
  * Ejemplos:
@@ -59,241 +20,61 @@ const fast_glob_1 = __importDefault(require("fast-glob"));
 function convertRouteToExpress(route) {
     return route.replace(/\[([^\]]+)\]/g, ':$1');
 }
-function getPages() {
-    // Busca tanto page.tsx como page/index.tsx y prioriza el más corto
-    const files = fast_glob_1.default.sync('app/pages/**/*.{tsx,jsx}');
+function getPages(policy = (0, module_extensions_1.getExtensionPolicy)()) {
+    const files = fast_glob_1.default
+        .sync((0, module_extensions_1.pageGlob)(policy))
+        .filter((file) => (0, module_extensions_1.isPageFile)(file, policy))
+        .sort();
+    // Dos archivos que definen la misma página son ambiguos: cuál gana dependería
+    // del orden del sistema de archivos, que cambia entre sistemas operativos.
+    //
+    // En desarrollo se avisa y se sigue con el primero, para no dejar el servidor
+    // caído mientras alguien renombra un archivo; al construir se falla.
+    (0, module_extensions_1.assertNoModuleCollision)(files, 'app/pages', {
+        strict: process.env.NODE_ENV === 'production',
+    });
     const seen = new Set();
     const pages = [];
     for (const file of files) {
-        let route = file.replace(/^app\/pages/, '').replace(/\.tsx$|\.jsx$/, '');
-        route = route.replace(/\/index$/, '') || '/';
-        // Prioriza page.tsx sobre page/index.tsx
-        if (!seen.has(route)) {
-            seen.add(route);
-            const expressRoute = convertRouteToExpress(route);
-            pages.push({ route, expressRoute, file, abs: node_path_1.default.resolve(file) });
-        }
+        // `page1.tsx` y `page1/index.tsx` describen la misma URL. Gana el primero
+        // por orden alfabético, que es estable.
+        const route = ('/' + (0, module_extensions_1.pageIdOf)(file)).replace(/\/index$/, '') || '/';
+        if (seen.has(route))
+            continue;
+        seen.add(route);
+        pages.push({
+            route,
+            expressRoute: convertRouteToExpress(route),
+            file,
+            abs: node_path_1.default.resolve(file),
+            pageId: (0, catalog_1.pageIdFromFile)(file),
+        });
     }
     return pages;
 }
-// Para Vite: input { [route]: absPath }
-function getViteInput() {
-    const pages = getPages();
+/**
+ * Entradas del entorno de servidor: las páginas más sus middlewares.
+ *
+ * El entorno de cliente no aparece acá: sus entradas salen del catálogo de
+ * variantes, porque una página produce una por cada plataforma que atiende.
+ */
+function getViteSSRInput() {
     const input = {};
-    for (const page of pages) {
-        input[page.file.replace(/^app\/pages\//, '').replace(/\.tsx$|\.jsx$/, '')] = page.abs;
+    for (const page of getPages()) {
+        input[(0, module_extensions_1.pageIdOf)(page.file)] = page.abs;
     }
-    return input;
-}
-// Para Vite SSR: input incluyendo páginas + middlewares
-function getViteSSRInput() {
-    const input = getViteInput(); // Empezar con las páginas
-    // Agregar TODOS los middlewares: .middlewares.ts y middlewares.ts
-    const middlewareFiles = fast_glob_1.default.sync('app/pages/**/{middlewares,*.middlewares}.{ts,js}');
+    const middlewareFiles = (0, module_extensions_1.middlewareGlobs)((0, module_extensions_1.getExtensionPolicy)()).flatMap((g) => fast_glob_1.default.sync(g));
     for (const middlewareFile of middlewareFiles) {
-        const key = middlewareFile.replace(/^app\/pages\//, '').replace(/\.(ts|js)$/, '');
-        input[key] = node_path_1.default.resolve(middlewareFile);
+        // La clave define dónde queda el artefacto, así que tiene que coincidir con
+        // lo que `toCompiledPath` busca al importarlo en producción. Con la
+        // extensión adentro se emitía `algo.middlewares.tsx.js` y la carga fallaba.
+        input[(0, module_extensions_1.pageIdOf)(middlewareFile)] = node_path_1.default.resolve(middlewareFile);
     }
     return input;
 }
-async function loadManifest(distPath = 'dist') {
-    const assetsDir = node_path_1.default.join(distPath, 'server/.vite');
-    const files = await promises_1.default.readdir(assetsDir);
-    const manifestFile = files.find(f => /^manifest-.*\.js$/.test(f));
-    if (!manifestFile)
-        throw new Error('No manifest file found in dist/server/assets');
-    // Import dinámico del manifest
-    const manifest = (await Promise.resolve(`${node_path_1.default.join(assetsDir, manifestFile)}`).then(s => __importStar(require(s)))).default;
-    return manifest;
-}
 /**
  * Convierte una ruta de página TypeScript a su equivalente compilado en producción
  *
  * @param pageFile - Ruta del archivo de página (relativa: "app/pages/pokedex/index.tsx" o absoluta: "/path/to/app/pages/pokedex/index.tsx")
  * @returns Ruta absoluta del archivo compilado (ej: "/path/to/project/dist/server/pokedex/index.js")
  */
-function getCompiledProdPage(pageFile) {
-    if (!pageFile.endsWith('.tsx')) {
-        throw new Error(`getCompiledProdPage expects a .tsx file, got: ${pageFile}`);
-    }
-    // Si es una ruta absoluta, extraer solo la parte relativa
-    let relativePath;
-    if (node_path_1.default.isAbsolute(pageFile)) {
-        // Buscar la parte después de "app/pages/" or "app\pages\" (Windows-compatible)
-        const normalizedPath = pageFile.replace(/\\/g, '/');
-        const appPagesIndex = normalizedPath.indexOf('app/pages/');
-        if (appPagesIndex === -1) {
-            throw new Error(`Absolute path must contain "app/pages/", got: ${pageFile}`);
-        }
-        relativePath = normalizedPath.substring(appPagesIndex);
-    }
-    else {
-        relativePath = pageFile;
-    }
-    // Convertir app/pages/pokedex/index.tsx a dist/server/pokedex/index.js
-    // También convierte [id] a _id_ para rutas dinámicas
-    const compiledRelativePath = relativePath
-        .replace(/^app\/pages\//, '') // Quitar prefijo app/pages/
-        .replace(/\.tsx$/, '.js') // Cambiar extensión .tsx a .js
-        .replace(/\[([^\]]+)\]/g, '_$1_'); // Convertir [id] a _id_
-    return node_path_1.default.resolve(process.cwd(), 'dist', 'server', compiledRelativePath);
-}
-async function fileExists(file) {
-    try {
-        await promises_1.default.access(file);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Platform-aware CSS resolution
- * Busca CSS files con prioridades basadas en platform detection
- */
-// Función helper para determinar si es probablemente un dispositivo móvil
-function isProbablyMobile(platform) {
-    // Mobile si es phone/tablet, o webview (que suele ser mobile), o category native (React Native)
-    return platform.device === 'phone' ||
-        platform.device === 'tablet' ||
-        platform.category === 'webview' ||
-        platform.category === 'native';
-}
-async function resolvePlatformCSS(basePath, platform) {
-    // Orden de prioridad corregido: OS first → device+OS → device → mobile condicional
-    const priorities = [];
-    // 1. OS específico primero: android.scss, ios.scss
-    priorities.push(`${basePath}.${platform.os}.scss`);
-    // Para webview, agregar combinaciones específicas después del OS
-    if (platform.category === 'webview') {
-        // 2. webview.os.scss (ej: webview.android.scss, webview.ios.scss)  
-        priorities.push(`${basePath}.webview.${platform.os}.scss`);
-        // 3. webview.scss general
-        priorities.push(`${basePath}.webview.scss`);
-    }
-    // Para native o web, agregar combinaciones device.os
-    if (platform.category === 'native' || platform.category === 'web') {
-        // 2. device.os.scss (ej: phone.android.scss, tablet.ios.scss)
-        priorities.push(`${basePath}.${platform.device}.${platform.os}.scss`);
-    }
-    // 3. Device específico: phone.scss, tablet.scss, desktop.scss
-    priorities.push(`${basePath}.${platform.device}.scss`);
-    // 4. Mobile fallback SOLO si es probablemente móvil
-    if (isProbablyMobile(platform)) {
-        priorities.push(`${basePath}.mobile.scss`);
-    }
-    // 5. Fallback final
-    priorities.push(`${basePath}.scss`);
-    // Retorna el primer archivo que exista
-    for (const file of priorities) {
-        if (await fileExists(file)) {
-            return file;
-        }
-    }
-    // Si ninguno existe, retorna el CSS base
-    return `${basePath}.scss`;
-}
-async function generateTempEntries(distPath = 'dist', platformInfo) {
-    const pages = getPages();
-    const entriesDir = node_path_1.default.resolve(distPath, '.entries');
-    // Solo crea el directorio si no existe, no lo borra
-    await promises_1.default.mkdir(entriesDir, { recursive: true });
-    const promises = pages.map(async (page) => {
-        // Sanitizar nombre: convertir [id] a _id_ para nombres de archivo
-        const rel = page.file
-            .replace(/^app\/pages\//, '')
-            .replace(/\.tsx$|\.jsx$/, '')
-            .replace(/\//g, '__')
-            .replace(/\[([^\]]+)\]/g, '_$1_');
-        if (platformInfo && platformInfo.device !== 'desktop') {
-            // Solo genera entry específico para mobile devices (phone, tablet)
-            const basePath = page.file.replace(/\.(tsx|jsx)$/, '');
-            const platformCSS = await resolvePlatformCSS(basePath, platformInfo);
-            // Generar entry específico con el CSS resuelto (puede ser base o específico)
-            const platformSuffix = `${platformInfo.device}.${platformInfo.os}`;
-            const entryPath = node_path_1.default.join(entriesDir, rel + `__entry-client.${platformSuffix}.tsx`);
-            await generateSingleEntry(page, entryPath, platformCSS);
-            return [entryPath];
-        }
-        else {
-            // Lógica mejorada: busca dinámicamente todos los archivos CSS específicos
-            const basePath = page.file.replace(/\.(tsx|jsx)$/, '');
-            const baseScss = basePath + '.scss';
-            const results = [];
-            // Genera entry-client base (desktop) - solo CSS base
-            const entryPath = node_path_1.default.join(entriesDir, rel + '__entry-client.tsx');
-            await generateSingleEntry(page, entryPath, baseScss);
-            results.push(entryPath);
-            // Buscar dinámicamente todos los archivos CSS específicos de plataforma
-            const glob = await Promise.resolve().then(() => __importStar(require('fast-glob')));
-            const cssFiles = await glob.default(`${basePath}.*.scss`);
-            for (const cssFile of cssFiles) {
-                // Extraer el sufijo del archivo CSS (ej: mobile, webview.android, desktop.linux)
-                const suffix = cssFile
-                    .replace(basePath + '.', '')
-                    .replace('.scss', '');
-                // Generar entry-client específico
-                const specificEntryPath = node_path_1.default.join(entriesDir, rel + `__entry-client.${suffix}.tsx`);
-                await generateSingleEntry(page, specificEntryPath, cssFile);
-                results.push(specificEntryPath);
-            }
-            return results;
-        }
-    });
-    const entryFiles = await Promise.all(promises);
-    return entryFiles.flat().filter(Boolean);
-}
-async function generateSingleEntry(page, entryPath, preferredScssFile) {
-    // Verifica si el archivo ya existe y es más reciente que el archivo fuente
-    try {
-        const entryStat = await promises_1.default.stat(entryPath);
-        const pageStat = await promises_1.default.stat(page.abs);
-        if (entryStat.mtime > pageStat.mtime) {
-            return; // El entry ya existe y está actualizado
-        }
-    }
-    catch {
-        // El archivo no existe, continúa con la generación
-    }
-    const importPath = node_path_1.default.relative(node_path_1.default.dirname(entryPath), page.abs).replace(/\\/g, '/');
-    // Lógica de fallback: intenta cargar el CSS preferido, si no existe carga el base
-    let scssToImport = '';
-    let scssImport = '';
-    if (await fileExists(preferredScssFile)) {
-        // Existe el CSS específico, usarlo
-        scssToImport = preferredScssFile;
-    }
-    else {
-        // No existe el CSS específico, usar el CSS base como fallback
-        const baseScss = page.file.replace(/\.(tsx|jsx)$/, '.scss');
-        if (await fileExists(baseScss)) {
-            scssToImport = baseScss;
-        }
-    }
-    if (scssToImport) {
-        const scssImportPath = node_path_1.default.relative(node_path_1.default.dirname(entryPath), scssToImport).replace(/\\/g, '/');
-        scssImport = `import "${scssImportPath.startsWith('.') ? scssImportPath : './' + scssImportPath}";`;
-    }
-    const template = `
-${scssImport}
-import { StrictMode } from "react";
-import { hydrateRoot } from "react-dom/client";
-import Page from "${importPath.startsWith('.') ? importPath : './' + importPath}";
-const props = window.__INITIAL_PROPS__ || {};
-hydrateRoot(document.getElementById("root"), <StrictMode><Page {...props} /></StrictMode>);
-`.trim();
-    await promises_1.default.mkdir(node_path_1.default.dirname(entryPath), { recursive: true });
-    await promises_1.default.writeFile(entryPath, template);
-}
-async function getClientEntriesInput(distPath = 'dist') {
-    await generateTempEntries(distPath);
-    // Incluir todos los entry-clients: base, mobile, desktop.linux
-    const entryFiles = fast_glob_1.default.sync(`${distPath}/.entries/**/*__entry-client*.tsx`);
-    const input = {};
-    for (const file of entryFiles) {
-        // Mantener el nombre completo del archivo como key para diferenciar las plataformas
-        const key = file.replace(new RegExp(`^${distPath}/\\.entries/`), '');
-        input[key] = node_path_1.default.resolve(file);
-    }
-    return input;
-}

package/dist/platform.d.ts

@@ -1,16 +1,13 @@
 /**
- * Platform detection for ress.js
- * Combina headers custom de React Native con User-Agent parsing
+ * Detección de plataforma.
+ *
+ * La implementación vive en `@ressjs/platform`, que no depende del router ni de
+ * Vite: así el puente del WebView, el cliente y cualquier consumidor externo
+ * pueden preguntarle lo mismo sin arrastrar el framework entero.
+ *
+ * Este archivo existe para que `import { detectPlatform } from '@ressjs/vite-router'`
+ * siga funcionando.
  */
-export interface PlatformInfo {
-    category: 'web' | 'webview' | 'native';
-    os: 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'unknown';
-    device: 'phone' | 'tablet' | 'desktop';
-    version?: string;
-    appVersion?: string;
-    source: 'headers' | 'user-agent';
-}
-/**
- * Detecta plataforma usando headers custom + User-Agent fallback
- */
-export declare function detectPlatform(userAgent: string, headers?: any): PlatformInfo;
+export { detect, detectPlatform, DEFAULT_PLATFORM } from '@ressjs/platform';
+export { hasCapability, isHandheld, isTV, isWebView } from '@ressjs/platform';
+export type { NativeAppInfo, PlatformDevice, PlatformInfo, PlatformOS } from '@ressjs/platform';

package/dist/platform.js

@@ -1,106 +1,22 @@
 "use strict";
 /**
- * Platform detection for ress.js
- * Combina headers custom de React Native con User-Agent parsing
+ * Detección de plataforma.
+ *
+ * La implementación vive en `@ressjs/platform`, que no depende del router ni de
+ * Vite: así el puente del WebView, el cliente y cualquier consumidor externo
+ * pueden preguntarle lo mismo sin arrastrar el framework entero.
+ *
+ * Este archivo existe para que `import { detectPlatform } from '@ressjs/vite-router'`
+ * siga funcionando.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectPlatform = detectPlatform;
-/**
- * Detecta plataforma usando headers custom + User-Agent fallback
- */
-function detectPlatform(userAgent, headers = {}) {
-    const ressHeaders = headers;
-    // 1. React Native headers detection
-    if (ressHeaders['x-rn-platform']) {
-        return {
-            category: 'native',
-            os: ressHeaders['x-rn-platform'] || 'android',
-            device: 'phone', // React Native es típicamente mobile
-            version: ressHeaders['x-rn-version'],
-            source: 'headers'
-        };
-    }
-    // 2. WebView headers detection
-    if (ressHeaders['x-webview'] === 'true' || ressHeaders['x-ressjs-platform'] === 'webview') {
-        const os = ressHeaders['x-platform'] || ressHeaders['x-ressjs-os'] || 'android';
-        return {
-            category: 'webview',
-            os: os,
-            device: ressHeaders['x-ressjs-device'] || 'phone',
-            version: ressHeaders['x-ressjs-version'],
-            appVersion: ressHeaders['x-ressjs-app-version'],
-            source: 'headers'
-        };
-    }
-    // 3. Ress.js specific headers (original logic)
-    if (ressHeaders['x-ressjs-platform'] === 'webview') {
-        return {
-            category: 'webview',
-            os: ressHeaders['x-ressjs-os'] || 'android',
-            device: ressHeaders['x-ressjs-device'] || 'phone',
-            version: ressHeaders['x-ressjs-version'],
-            appVersion: ressHeaders['x-ressjs-app-version'],
-            source: 'headers'
-        };
-    }
-    // 4. User-Agent fallback detection
-    return detectFromUserAgent(userAgent);
-}
-/**
- * Detección por User-Agent (navegadores estándar)
- */
-function detectFromUserAgent(userAgent) {
-    const ua = userAgent.toLowerCase();
-    // SPECIAL CASE: React Native
-    if (ua.includes('reactnative')) {
-        let os = 'android';
-        if (ua.includes('ios')) {
-            os = 'ios';
-        }
-        else if (ua.includes('android')) {
-            os = 'android';
-        }
-        return {
-            category: 'native',
-            os,
-            device: 'phone', // React Native siempre mobile
-            source: 'user-agent'
-        };
-    }
-    // Detectar OS
-    let os = 'unknown';
-    if (ua.includes('iphone') || ua.includes('ipad') || ua.includes('ios')) {
-        os = 'ios';
-    }
-    else if (ua.includes('android')) {
-        os = 'android';
-    }
-    else if (ua.includes('windows')) {
-        os = 'windows';
-    }
-    else if (ua.includes('macintosh') || ua.includes('mac os x')) {
-        os = 'macos';
-    }
-    else if (ua.includes('linux')) {
-        os = 'linux';
-    }
-    // Detectar device type
-    let device = 'desktop';
-    if (ua.includes('ipad')) {
-        device = 'tablet';
-    }
-    else if (ua.includes('mobile') || ua.includes('phone')) {
-        device = 'phone';
-    }
-    else if (ua.includes('tablet')) {
-        device = 'tablet';
-    }
-    // Detectar category (web vs webview)
-    let category = 'web';
-    return {
-        category,
-        os,
-        device,
-        source: 'user-agent'
-    };
-}
+exports.isWebView = exports.isTV = exports.isHandheld = exports.hasCapability = exports.DEFAULT_PLATFORM = exports.detectPlatform = exports.detect = void 0;
+var platform_1 = require("@ressjs/platform");
+Object.defineProperty(exports, "detect", { enumerable: true, get: function () { return platform_1.detect; } });
+Object.defineProperty(exports, "detectPlatform", { enumerable: true, get: function () { return platform_1.detectPlatform; } });
+Object.defineProperty(exports, "DEFAULT_PLATFORM", { enumerable: true, get: function () { return platform_1.DEFAULT_PLATFORM; } });
+var platform_2 = require("@ressjs/platform");
+Object.defineProperty(exports, "hasCapability", { enumerable: true, get: function () { return platform_2.hasCapability; } });
+Object.defineProperty(exports, "isHandheld", { enumerable: true, get: function () { return platform_2.isHandheld; } });
+Object.defineProperty(exports, "isTV", { enumerable: true, get: function () { return platform_2.isTV; } });
+Object.defineProperty(exports, "isWebView", { enumerable: true, get: function () { return platform_2.isWebView; } });

package/dist/plugin/environments.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Declaración de los entornos de build de ress.js.
+ *
+ * Cliente y servidor se describen como entornos de Vite, de modo que una sola
+ * invocación de build produzca ambos.
+ */
+/**
+ * Directorios de salida.
+ *
+ * Es la única declaración: la comparten el build y el runtime de producción, que
+ * es lo que garantiza que el servidor busque donde el build escribió.
+ */
+/** Archivo con el identificador del build, junto a `route-manifest.json`. */
+export declare const BUILD_ID_FILE = "BUILD_ID";
+export declare const OUT_DIR: {
+    /** Raíz de salida. El manifest de rutas vive acá, junto a los dos entornos. */
+    readonly base: "dist";
+    readonly client: "dist/client";
+    readonly ssr: "dist/server";
+};
+export interface EnvironmentInputs {
+    client: Record<string, string>;
+    ssr: Record<string, string>;
+}
+/**
+ * Construye la porción de configuración de Vite que aporta el framework.
+ *
+ * Se devuelve desde el hook `config` del plugin, de modo que Vite la fusione con
+ * la configuración del usuario según sus reglas normales: lo que el usuario
+ * declare se aplica encima sin que el framework lo pise.
+ *
+ * Las entradas llegan resueltas desde afuera. Quién las enumera es un detalle
+ * interno del framework, no algo que el proyecto consumidor deba declarar en su
+ * `vite.config.ts`.
+ */
+export declare function defineEnvironments(inputs?: EnvironmentInputs): {
+    environments: {
+        client: {
+            build: {
+                outDir: "dist/client";
+                manifest: boolean;
+                rolldownOptions: {
+                    input: Record<string, string>;
+                };
+            };
+        };
+        ssr: {
+            build: {
+                outDir: "dist/server";
+                ssr: boolean;
+                rolldownOptions: {
+                    input: Record<string, string>;
+                };
+            };
+        };
+    };
+    builder: {
+        /**
+         * Secuencial, y en este orden: el build de servidor necesita el manifest
+         * que produce el de cliente para poder resolver assets por página. En
+         * paralelo, el servidor podría leer un manifest incompleto o inexistente.
+         */
+        buildApp: (builder: {
+            environments: Record<string, unknown>;
+            build: (env: unknown) => Promise<unknown>;
+        }) => Promise<void>;
+    };
+};

package/dist/plugin/environments.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Declaración de los entornos de build de ress.js.
+ *
+ * Cliente y servidor se describen como entornos de Vite, de modo que una sola
+ * invocación de build produzca ambos.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OUT_DIR = exports.BUILD_ID_FILE = void 0;
+exports.defineEnvironments = defineEnvironments;
+/**
+ * Directorios de salida.
+ *
+ * Es la única declaración: la comparten el build y el runtime de producción, que
+ * es lo que garantiza que el servidor busque donde el build escribió.
+ */
+/** Archivo con el identificador del build, junto a `route-manifest.json`. */
+exports.BUILD_ID_FILE = 'BUILD_ID';
+exports.OUT_DIR = {
+    /** Raíz de salida. El manifest de rutas vive acá, junto a los dos entornos. */
+    base: 'dist',
+    client: 'dist/client',
+    ssr: 'dist/server',
+};
+/**
+ * Construye la porción de configuración de Vite que aporta el framework.
+ *
+ * Se devuelve desde el hook `config` del plugin, de modo que Vite la fusione con
+ * la configuración del usuario según sus reglas normales: lo que el usuario
+ * declare se aplica encima sin que el framework lo pise.
+ *
+ * Las entradas llegan resueltas desde afuera. Quién las enumera es un detalle
+ * interno del framework, no algo que el proyecto consumidor deba declarar en su
+ * `vite.config.ts`.
+ */
+function defineEnvironments(inputs = { client: {}, ssr: {} }) {
+    const clientOutDir = exports.OUT_DIR.client;
+    const ssrOutDir = exports.OUT_DIR.ssr;
+    return {
+        environments: {
+            client: {
+                build: {
+                    outDir: clientOutDir,
+                    // El manifest del cliente es lo que permite al servidor resolver, en
+                    // producción, qué artefacto corresponde a cada página y variante.
+                    manifest: true,
+                    rolldownOptions: {
+                        input: inputs.client,
+                    },
+                },
+            },
+            ssr: {
+                build: {
+                    outDir: ssrOutDir,
+                    ssr: true,
+                    rolldownOptions: {
+                        input: inputs.ssr,
+                    },
+                },
+            },
+        },
+        builder: {
+            /**
+             * Secuencial, y en este orden: el build de servidor necesita el manifest
+             * que produce el de cliente para poder resolver assets por página. En
+             * paralelo, el servidor podría leer un manifest incompleto o inexistente.
+             */
+            buildApp: async (builder) => {
+                await builder.build(builder.environments.client);
+                await builder.build(builder.environments.ssr);
+            },
+        },
+    };
+}