@vistagenic/vista 0.1.0-alpha.1

package/dist/build/manifest.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Vista Build Utilities
+ *
+ * Generates build manifests, BUILD_ID, and manages .vista output structure.
+ */
+/**
+ * Generate a unique build ID based on timestamp and random bytes.
+ */
+export declare function generateBuildId(): string;
+/**
+ * Read existing BUILD_ID or generate a new one.
+ */
+export declare function getBuildId(vistaDir: string, forceNew?: boolean): string;
+export interface VistaDirs {
+    root: string;
+    cache: string;
+    server: string;
+    static: string;
+    chunks: string;
+    css: string;
+    media: string;
+}
+/**
+ * Create the .vista directory structure.
+ */
+export declare function createVistaDirectories(cwd: string): VistaDirs;
+export interface BuildManifest {
+    buildId: string;
+    polyfillFiles: string[];
+    devFiles: string[];
+    lowPriorityFiles: string[];
+    rootMainFiles: string[];
+    pages: Record<string, string[]>;
+}
+/**
+ * Generate build-manifest.json
+ */
+export declare function generateBuildManifest(vistaDir: string, buildId: string, pages?: Record<string, string[]>): BuildManifest;
+export interface RouteInfo {
+    page: string;
+    regex: string;
+    routeKeys: Record<string, string>;
+    namedRegex?: string;
+}
+export interface RoutesManifest {
+    version: number;
+    basePath: string;
+    redirects: any[];
+    rewrites: any[];
+    headers: any[];
+    staticRoutes: RouteInfo[];
+    dynamicRoutes: RouteInfo[];
+}
+/**
+ * Generate routes-manifest.json from route tree.
+ */
+export declare function generateRoutesManifest(vistaDir: string, staticRoutes?: RouteInfo[], dynamicRoutes?: RouteInfo[]): RoutesManifest;
+export interface ClientComponentInfo {
+    filePath: string;
+    chunkName: string;
+    exports: string[];
+}
+export interface ClientComponentsManifest {
+    buildId: string;
+    clientModules: Record<string, ClientComponentInfo>;
+}
+/**
+ * Generate manifest of client components (files with 'client load').
+ */
+export declare function generateClientComponentsManifest(vistaDir: string, buildId: string, clientModules?: Record<string, ClientComponentInfo>): ClientComponentsManifest;
+export interface ServerComponentInfo {
+    filePath: string;
+    hasMetadata: boolean;
+    hasGenerateMetadata: boolean;
+}
+/**
+ * Generate manifest of server components.
+ */
+export declare function generateServerComponentsManifest(vistaDir: string, serverModules?: Record<string, ServerComponentInfo>): void;
+/**
+ * Get Webpack cache configuration for persistent caching.
+ */
+export declare function getWebpackCacheConfig(vistaDir: string, buildId: string, name: string): {
+    type: "filesystem";
+    version: string;
+    cacheDirectory: string;
+    name: string;
+    buildDependencies: {
+        config: string[];
+    };
+};
+/**
+ * Clean old cache entries (keeps last N builds).
+ */
+export declare function cleanOldCache(vistaDir: string, keepBuilds?: number): void;

package/dist/build/manifest.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Vista Build Utilities
+ *
+ * Generates build manifests, BUILD_ID, and manages .vista output structure.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBuildId = generateBuildId;
+exports.getBuildId = getBuildId;
+exports.createVistaDirectories = createVistaDirectories;
+exports.generateBuildManifest = generateBuildManifest;
+exports.generateRoutesManifest = generateRoutesManifest;
+exports.generateClientComponentsManifest = generateClientComponentsManifest;
+exports.generateServerComponentsManifest = generateServerComponentsManifest;
+exports.getWebpackCacheConfig = getWebpackCacheConfig;
+exports.cleanOldCache = cleanOldCache;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = __importDefault(require("crypto"));
+// ============================================================================
+// BUILD_ID Generation
+// ============================================================================
+/**
+ * Generate a unique build ID based on timestamp and random bytes.
+ */
+function generateBuildId() {
+    const timestamp = Date.now().toString(36);
+    const random = crypto_1.default.randomBytes(4).toString('hex');
+    return `${timestamp}-${random}`;
+}
+/**
+ * Read existing BUILD_ID or generate a new one.
+ */
+function getBuildId(vistaDir, forceNew = false) {
+    const buildIdPath = path_1.default.join(vistaDir, 'BUILD_ID');
+    if (!forceNew && fs_1.default.existsSync(buildIdPath)) {
+        return fs_1.default.readFileSync(buildIdPath, 'utf-8').trim();
+    }
+    const buildId = generateBuildId();
+    fs_1.default.mkdirSync(vistaDir, { recursive: true });
+    fs_1.default.writeFileSync(buildIdPath, buildId);
+    return buildId;
+}
+/**
+ * Create the .vista directory structure.
+ */
+function createVistaDirectories(cwd) {
+    const root = path_1.default.join(cwd, '.vista');
+    const dirs = {
+        root,
+        cache: path_1.default.join(root, 'cache'),
+        server: path_1.default.join(root, 'server'),
+        static: path_1.default.join(root, 'static'),
+        chunks: path_1.default.join(root, 'static', 'chunks'),
+        css: path_1.default.join(root, 'static', 'css'),
+        media: path_1.default.join(root, 'static', 'media'),
+    };
+    // Create all directories
+    Object.values(dirs).forEach(dir => {
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    });
+    // Create cache subdirectories
+    fs_1.default.mkdirSync(path_1.default.join(dirs.cache, 'webpack'), { recursive: true });
+    fs_1.default.mkdirSync(path_1.default.join(dirs.cache, 'swc'), { recursive: true });
+    fs_1.default.mkdirSync(path_1.default.join(dirs.cache, 'images'), { recursive: true });
+    // Create server subdirectories
+    fs_1.default.mkdirSync(path_1.default.join(dirs.server, 'app'), { recursive: true });
+    fs_1.default.mkdirSync(path_1.default.join(dirs.server, 'chunks'), { recursive: true });
+    return dirs;
+}
+/**
+ * Generate build-manifest.json
+ */
+function generateBuildManifest(vistaDir, buildId, pages = {}) {
+    const manifest = {
+        buildId,
+        polyfillFiles: [],
+        devFiles: [],
+        lowPriorityFiles: [],
+        rootMainFiles: [
+            '/_vista/static/chunks/webpack.js',
+            '/_vista/static/chunks/main.js',
+        ],
+        pages,
+    };
+    const manifestPath = path_1.default.join(vistaDir, 'build-manifest.json');
+    fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+/**
+ * Generate routes-manifest.json from route tree.
+ */
+function generateRoutesManifest(vistaDir, staticRoutes = [], dynamicRoutes = []) {
+    const manifest = {
+        version: 1,
+        basePath: '',
+        redirects: [],
+        rewrites: [],
+        headers: [],
+        staticRoutes,
+        dynamicRoutes,
+    };
+    const manifestPath = path_1.default.join(vistaDir, 'routes-manifest.json');
+    fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+/**
+ * Generate manifest of client components (files with 'client load').
+ */
+function generateClientComponentsManifest(vistaDir, buildId, clientModules = {}) {
+    const manifest = {
+        buildId,
+        clientModules,
+    };
+    const manifestPath = path_1.default.join(vistaDir, 'client-components-manifest.json');
+    fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+/**
+ * Generate manifest of server components.
+ */
+function generateServerComponentsManifest(vistaDir, serverModules = {}) {
+    const manifest = {
+        serverModules,
+    };
+    const manifestPath = path_1.default.join(vistaDir, 'server', 'server-components-manifest.json');
+    fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+}
+// ============================================================================
+// Cache Utilities
+// ============================================================================
+/**
+ * Get Webpack cache configuration for persistent caching.
+ */
+function getWebpackCacheConfig(vistaDir, buildId, name) {
+    return {
+        type: 'filesystem',
+        version: buildId,
+        cacheDirectory: path_1.default.join(vistaDir, 'cache', 'webpack'),
+        name: name,
+        buildDependencies: {
+            config: [__filename],
+        },
+    };
+}
+/**
+ * Clean old cache entries (keeps last N builds).
+ */
+function cleanOldCache(vistaDir, keepBuilds = 5) {
+    const cacheDir = path_1.default.join(vistaDir, 'cache', 'webpack');
+    if (!fs_1.default.existsSync(cacheDir))
+        return;
+    const entries = fs_1.default.readdirSync(cacheDir)
+        .map(name => ({
+        name,
+        path: path_1.default.join(cacheDir, name),
+        stat: fs_1.default.statSync(path_1.default.join(cacheDir, name)),
+    }))
+        .filter(e => e.stat.isDirectory())
+        .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs);
+    // Remove old cache directories
+    entries.slice(keepBuilds).forEach(entry => {
+        fs_1.default.rmSync(entry.path, { recursive: true, force: true });
+    });
+}

package/dist/build/rsc/client-manifest.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Client Component Manifest Generator
+ *
+ * Scans the app directory and builds a manifest of all Client Components.
+ * Client components are those with 'client load' directive.
+ *
+ * The manifest maps component paths to their chunk names for client-side loading.
+ */
+export interface ClientComponentEntry {
+    /** Unique ID for this component */
+    id: string;
+    /** Relative path from app directory */
+    path: string;
+    /** Absolute file path */
+    absolutePath: string;
+    /** Generated chunk name */
+    chunkName: string;
+    /** Exported names from this module */
+    exports: string[];
+    /** Is async/lazy loaded */
+    async: boolean;
+}
+export interface ClientManifest {
+    /** Build ID for cache busting */
+    buildId: string;
+    /** Map of module ID to client component info */
+    clientModules: Record<string, ClientComponentEntry>;
+    /** Map of module path to module ID (for lookups) */
+    pathToId: Record<string, string>;
+    /** SSR module mapping (server paths to client chunks) */
+    ssrModuleMapping: Record<string, string>;
+}
+/**
+ * Generate the client component manifest
+ */
+export declare function generateClientManifest(cwd: string, appDir: string): ClientManifest;
+/**
+ * Get client component info by module ID
+ */
+export declare function getClientComponent(manifest: ClientManifest, moduleId: string): ClientComponentEntry | undefined;
+/**
+ * Get client component by file path
+ */
+export declare function getClientComponentByPath(manifest: ClientManifest, filePath: string): ClientComponentEntry | undefined;
+/**
+ * Check if a path is a client component
+ */
+export declare function isClientComponentPath(manifest: ClientManifest, filePath: string): boolean;

package/dist/build/rsc/client-manifest.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Client Component Manifest Generator
+ *
+ * Scans the app directory and builds a manifest of all Client Components.
+ * Client components are those with 'client load' directive.
+ *
+ * The manifest maps component paths to their chunk names for client-side loading.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateClientManifest = generateClientManifest;
+exports.getClientComponent = getClientComponent;
+exports.getClientComponentByPath = getClientComponentByPath;
+exports.isClientComponentPath = isClientComponentPath;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// Try to load Rust NAPI bindings
+let rustNative = null;
+try {
+    const possiblePaths = [
+        path_1.default.resolve(__dirname, '../../../../../crates/vista-napi'),
+        path_1.default.resolve(__dirname, '../../../../crates/vista-napi'),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            rustNative = require(p);
+            break;
+        }
+        catch (e) {
+            // Try next
+        }
+    }
+}
+catch (e) {
+    // Fallback to JS
+}
+/**
+ * Check if source has 'client load' directive
+ */
+function hasClientDirective(source) {
+    if (rustNative?.isClientComponent) {
+        return rustNative.isClientComponent(source);
+    }
+    const trimmed = source.trim();
+    return trimmed.startsWith("'client load'") || trimmed.startsWith('"client load"');
+}
+/**
+ * Extract export names from source (simple regex approach)
+ */
+function extractExports(source) {
+    const exports = [];
+    // Default export
+    if (/export\s+default\s+/.test(source)) {
+        exports.push('default');
+    }
+    // Named exports: export function Name, export const Name, export class Name
+    const namedExportRegex = /export\s+(?:async\s+)?(?:function|const|let|var|class)\s+([A-Z][a-zA-Z0-9_]*)/g;
+    let match;
+    while ((match = namedExportRegex.exec(source)) !== null) {
+        exports.push(match[1]);
+    }
+    // Export { Name1, Name2 }
+    const reExportRegex = /export\s+\{([^}]+)\}/g;
+    while ((match = reExportRegex.exec(source)) !== null) {
+        const names = match[1]
+            .split(',')
+            .map((n) => n
+            .trim()
+            .split(/\s+as\s+/)
+            .pop()
+            ?.trim())
+            .filter(Boolean);
+        exports.push(...names);
+    }
+    return [...new Set(exports)];
+}
+/**
+ * Generate a unique chunk name for a component
+ */
+function generateChunkName(relativePath) {
+    return relativePath
+        .replace(/\\/g, '/')
+        .replace(/\.[jt]sx?$/, '')
+        .replace(/[^a-zA-Z0-9]/g, '_')
+        .toLowerCase();
+}
+/**
+ * Generate unique module ID
+ */
+function generateModuleId(relativePath) {
+    // Use a hash-like ID for production, readable path for dev
+    const normalized = relativePath.replace(/\\/g, '/').replace(/\.[jt]sx?$/, '');
+    return `client:${normalized}`;
+}
+/**
+ * Scan directory recursively for client components
+ */
+function scanForClientComponents(dir, appDir, components) {
+    if (!fs_1.default.existsSync(dir))
+        return;
+    const items = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    for (const item of items) {
+        const fullPath = path_1.default.join(dir, item.name);
+        if (item.isDirectory()) {
+            if (!item.name.startsWith('.') && item.name !== 'node_modules') {
+                scanForClientComponents(fullPath, appDir, components);
+            }
+        }
+        else if (item.isFile()) {
+            const ext = path_1.default.extname(item.name);
+            if (!['.tsx', '.ts', '.jsx', '.js'].includes(ext))
+                continue;
+            try {
+                const source = fs_1.default.readFileSync(fullPath, 'utf-8');
+                if (hasClientDirective(source)) {
+                    const relativePath = path_1.default.relative(appDir, fullPath);
+                    const moduleId = generateModuleId(relativePath);
+                    components.push({
+                        id: moduleId,
+                        path: relativePath,
+                        absolutePath: fullPath,
+                        chunkName: generateChunkName(relativePath),
+                        exports: extractExports(source),
+                        async: false,
+                    });
+                }
+            }
+            catch (e) {
+                console.warn(`[Vista RSC] Failed to read ${fullPath}:`, e);
+            }
+        }
+    }
+}
+/**
+ * Generate the client component manifest
+ */
+function generateClientManifest(cwd, appDir) {
+    const components = [];
+    scanForClientComponents(appDir, appDir, components);
+    const clientModules = {};
+    const pathToId = {};
+    const ssrModuleMapping = {};
+    for (const component of components) {
+        clientModules[component.id] = component;
+        pathToId[component.path] = component.id;
+        pathToId[component.absolutePath] = component.id;
+        // Map server path to client chunk for SSR
+        ssrModuleMapping[component.absolutePath] = `/_vista/static/chunks/${component.chunkName}.js`;
+    }
+    // Get or generate build ID
+    const buildIdPath = path_1.default.join(cwd, '.vista', 'BUILD_ID');
+    let buildId = 'dev';
+    try {
+        if (fs_1.default.existsSync(buildIdPath)) {
+            buildId = fs_1.default.readFileSync(buildIdPath, 'utf-8').trim();
+        }
+    }
+    catch (e) {
+        // Use dev
+    }
+    return {
+        buildId,
+        clientModules,
+        pathToId,
+        ssrModuleMapping,
+    };
+}
+/**
+ * Get client component info by module ID
+ */
+function getClientComponent(manifest, moduleId) {
+    return manifest.clientModules[moduleId];
+}
+/**
+ * Get client component by file path
+ */
+function getClientComponentByPath(manifest, filePath) {
+    const moduleId = manifest.pathToId[filePath];
+    if (!moduleId)
+        return undefined;
+    return manifest.clientModules[moduleId];
+}
+/**
+ * Check if a path is a client component
+ */
+function isClientComponentPath(manifest, filePath) {
+    return filePath in manifest.pathToId;
+}

package/dist/build/rsc/client-reference-plugin.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Vista Client Reference Plugin
+ *
+ * Webpack plugin that transforms server component imports in the client bundle.
+ *
+ * When a client bundle imports a server component, this plugin:
+ * 1. Replaces the import with a client reference proxy
+ * 2. The proxy throws an error if used on the client (server components can't run on client)
+ * 3. For valid patterns (passing server component as children), the reference works
+ *
+ * This ensures:
+ * - Server code never leaks to the client bundle
+ * - Server components contribute 0kb to client JavaScript
+ * - Clear error messages when misusing server components
+ */
+import webpack from 'webpack';
+export interface ClientReferencePluginOptions {
+    /** Path to the app directory */
+    appDir: string;
+    /** Path to client manifest JSON */
+    clientManifestPath: string;
+}
+/**
+ * Client Reference Plugin
+ *
+ * Transforms imports of server components in the client bundle
+ */
+export declare class ClientReferencePlugin {
+    private appDir;
+    private clientManifestPath;
+    private clientManifest;
+    constructor(options: ClientReferencePluginOptions);
+    apply(compiler: webpack.Compiler): void;
+    private loadManifest;
+    private getComponentId;
+    private generateRuntimeManifest;
+}