@vistagenic/vista 0.1.0 → 0.2.1

package/dist/bin/build-rsc.js

@@ -22,6 +22,7 @@ const client_manifest_1 = require("../build/rsc/client-manifest");
 const server_manifest_1 = require("../build/rsc/server-manifest");
 const file_scanner_1 = require("./file-scanner");
 const config_1 = require("../config");
+const constants_1 = require("../constants");
 const structure_validator_1 = require("../server/structure-validator");
 const static_generator_1 = require("../server/static-generator");
 const structure_log_1 = require("../server/structure-log");
@@ -67,7 +68,7 @@ import { createFromFetch } from 'react-server-dom-webpack/client';
 import { RSCRouter } from 'vista/client/rsc-router';
 import { callServer } from 'vista/client/server-actions';
 
-const hydrateDocument = (window as any).__VISTA_HYDRATE_DOCUMENT__ === true;
+const hydrateDocument = (window as any).${constants_1.HYDRATE_DOCUMENT_FLAG} === true;
 const rootElement = hydrateDocument ? document : document.getElementById('root');
 if (!rootElement) {
   throw new Error('Missing #root element for hydration.');
@@ -90,7 +91,7 @@ hydrateRoot(
 
 // Vista live-reload: listen for server component changes via SSE
 (function connectReload() {
-  const es = new EventSource('/__vista_reload');
+  const es = new EventSource('${constants_1.SSE_ENDPOINT}');
   es.onmessage = (e) => {
     if (e.data === 'reload') {
       window.location.reload();

package/dist/bin/build.js

@@ -12,6 +12,7 @@ const webpack_config_1 = require("./webpack.config");
 const file_scanner_1 = require("./file-scanner");
 const manifest_1 = require("../build/manifest");
 const config_1 = require("../config");
+const constants_1 = require("../constants");
 const structure_validator_1 = require("../server/structure-validator");
 const structure_log_1 = require("../server/structure-log");
 const _debug = !!process.env.VISTA_DEBUG;
@@ -237,7 +238,7 @@ function hideCompileError() {
     if (div) div.remove();
 }
 
-const sse = new EventSource('/__vista_reload');
+const sse = new EventSource('${constants_1.SSE_ENDPOINT}');
 sse.onmessage = (event) => {
     if (event.data === 'reload') {
         hideCompileError();
@@ -265,7 +266,7 @@ sse.onerror = (e) => {
         : '// SSE reload disabled in production'}
 
 // Export for debugging
-(window as any).__VISTA_CLIENT_COMPONENTS__ = CLIENT_COMPONENTS;
+(window as any).${constants_1.CLIENT_COMPONENTS_FLAG} = CLIENT_COMPONENTS;
     `;
     fs_1.default.writeFileSync(path_1.default.join(vistaDir, 'client.tsx'), clientEntryContent);
     if (_debug) {

package/dist/bin/webpack.config.js

@@ -10,9 +10,10 @@ const react_refresh_webpack_plugin_1 = __importDefault(require("@pmmmwh/react-re
 const mini_css_extract_plugin_1 = __importDefault(require("mini-css-extract-plugin"));
 const server_component_plugin_1 = require("./server-component-plugin");
 const vista_flight_plugin_1 = require("../build/webpack/plugins/vista-flight-plugin");
+const constants_1 = require("../constants");
 function createWebpackConfig(options) {
     const { cwd, isDev } = options;
-    const vistaDir = path_1.default.join(cwd, '.vista');
+    const vistaDir = path_1.default.join(cwd, constants_1.BUILD_DIR);
     const entryPoint = path_1.default.join(vistaDir, 'client.tsx');
     // Find React - check local node_modules first, then traverse up for monorepo hoisting
     const findModulePath = (moduleName) => {

package/dist/build/manifest.d.ts

@@ -38,6 +38,8 @@ export interface ArtifactManifest {
     schemaVersion: number;
     buildId: string;
     generatedAt: string;
+    /** Integrity watermark — framework identity + hash token */
+    __integrity?: string;
     manifests: {
         buildManifest: string;
         routesManifest: string;

package/dist/build/manifest.js

@@ -26,6 +26,8 @@ exports.cleanOldCache = cleanOldCache;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const crypto_1 = __importDefault(require("crypto"));
+const constants_1 = require("../constants");
+const integrity_1 = require("../integrity");
 // ============================================================================
 // BUILD_ID Generation
 // ============================================================================
@@ -56,7 +58,7 @@ function getBuildId(vistaDir, forceNew = false) {
  * In RSC mode, creates the full structure for server/client bundles.
  */
 function createVistaDirectories(cwd, mode = 'legacy') {
-    const root = path_1.default.join(cwd, '.vista');
+    const root = path_1.default.join(cwd, constants_1.BUILD_DIR);
     const dirs = {
         root,
         cache: path_1.default.join(root, 'cache'),
@@ -93,7 +95,7 @@ function generateBuildManifest(vistaDir, buildId, pages = {}) {
         polyfillFiles: [],
         devFiles: [],
         lowPriorityFiles: [],
-        rootMainFiles: ['/_vista/static/chunks/webpack.js', '/_vista/static/chunks/main.js'],
+        rootMainFiles: [`${constants_1.STATIC_CHUNKS_PATH}webpack.js`, `${constants_1.STATIC_CHUNKS_PATH}main.js`],
         pages,
     };
     const manifestPath = path_1.default.join(vistaDir, 'build-manifest.json');
@@ -144,10 +146,10 @@ function generateRequiredServerFilesManifest(cwd, vistaDir) {
         appDir: cwd,
         relativeAppDir: '.',
         files: [
-            '.vista/BUILD_ID',
-            '.vista/build-manifest.json',
-            '.vista/routes-manifest.json',
-            '.vista/app-path-routes-manifest.json',
+            `${constants_1.BUILD_DIR}/BUILD_ID`,
+            `${constants_1.BUILD_DIR}/build-manifest.json`,
+            `${constants_1.BUILD_DIR}/routes-manifest.json`,
+            `${constants_1.BUILD_DIR}/app-path-routes-manifest.json`,
         ],
     };
     fs_1.default.writeFileSync(path_1.default.join(vistaDir, 'required-server-files.json'), JSON.stringify(manifest, null, 2));
@@ -163,6 +165,7 @@ function writeArtifactManifest(vistaDir, buildId) {
         schemaVersion: 1,
         buildId,
         generatedAt: new Date().toISOString(),
+        __integrity: (0, integrity_1.generateBuildWatermark)(),
         manifests: {
             buildManifest: 'build-manifest.json',
             routesManifest: 'routes-manifest.json',

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

@@ -19,6 +19,7 @@ exports.isClientComponentPath = isClientComponentPath;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const component_identity_1 = require("./component-identity");
+const constants_1 = require("../../constants");
 // Try to load Rust NAPI bindings
 let rustNative = null;
 try {
@@ -148,11 +149,11 @@ function generateClientManifestWithRoots(cwd, appDir, additionalRoots = []) {
         pathToId[component.absolutePath] = component.id;
         pathToId[normalizedAbsolutePath] = component.id;
         // Map server path to client chunk for SSR
-        ssrModuleMapping[component.absolutePath] = `/_vista/static/chunks/${component.chunkName}.js`;
-        ssrModuleMapping[normalizedAbsolutePath] = `/_vista/static/chunks/${component.chunkName}.js`;
+        ssrModuleMapping[component.absolutePath] = `${constants_1.STATIC_CHUNKS_PATH}${component.chunkName}.js`;
+        ssrModuleMapping[normalizedAbsolutePath] = `${constants_1.STATIC_CHUNKS_PATH}${component.chunkName}.js`;
     }
     // Get or generate build ID
-    const buildIdPath = path_1.default.join(cwd, '.vista', 'BUILD_ID');
+    const buildIdPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'BUILD_ID');
     let buildId = 'dev';
     try {
         if (fs_1.default.existsSync(buildIdPath)) {

package/dist/build/rsc/compiler.js

@@ -19,6 +19,7 @@ const fs_1 = __importDefault(require("fs"));
 const manifest_1 = require("../manifest");
 const client_manifest_1 = require("./client-manifest");
 const server_manifest_1 = require("./server-manifest");
+const constants_1 = require("../../constants");
 // Find module path (handles monorepo hoisting)
 const findModulePath = (moduleName, cwd) => {
     const localPath = path_1.default.resolve(cwd, 'node_modules', moduleName);
@@ -174,8 +175,8 @@ function createServerWebpackConfig(options) {
         plugins: [
             new webpack_1.default.DefinePlugin({
                 'process.env.NODE_ENV': JSON.stringify(isDev ? 'development' : 'production'),
-                __VISTA_BUILD_ID__: JSON.stringify(buildId),
-                __VISTA_SERVER__: 'true',
+                [constants_1.BUILD_ID_DEFINE]: JSON.stringify(buildId),
+                [constants_1.SERVER_DEFINE]: 'true',
             }),
         ],
         devtool: isDev ? 'source-map' : false,
@@ -217,7 +218,7 @@ function createClientWebpackConfig(options) {
             path: vistaDirs.chunks,
             filename: isDev ? '[name].js' : 'main-[contenthash:8].js',
             chunkFilename: isDev ? '[name].js' : '[name]-[contenthash:8].js',
-            publicPath: '/_vista/static/chunks/',
+            publicPath: constants_1.STATIC_CHUNKS_PATH,
             clean: !isDev,
         },
         // Disable filesystem cache for client RSC build in dev mode.
@@ -383,11 +384,11 @@ function createClientWebpackConfig(options) {
             },
             new webpack_1.default.DefinePlugin({
                 'process.env.NODE_ENV': JSON.stringify(isDev ? 'development' : 'production'),
-                __VISTA_BUILD_ID__: JSON.stringify(buildId),
-                __VISTA_SERVER__: 'false',
+                [constants_1.BUILD_ID_DEFINE]: JSON.stringify(buildId),
+                [constants_1.SERVER_DEFINE]: 'false',
             }),
             // No HotModuleReplacementPlugin or ReactRefreshWebpackPlugin
-            // RSC client builds use Vista's SSE live-reload (/__vista_reload) instead
+            // RSC client builds use Vista's SSE live-reload (${SSE_ENDPOINT}) instead
             // Extract CSS Modules into a separate file
             new MiniCssExtractPlugin({
                 filename: isDev ? 'modules.css' : 'modules-[contenthash:8].css',

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

@@ -20,6 +20,7 @@ exports.isServerComponentPath = isServerComponentPath;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const component_identity_1 = require("./component-identity");
+const constants_1 = require("../../constants");
 const RESERVED_INTERNAL_SEGMENTS = new Set(['[not-found]']);
 function hasReservedInternalSegment(relativePath) {
     return relativePath
@@ -323,7 +324,7 @@ function generateServerManifest(cwd, appDir) {
     }
     const routes = buildRoutes(components, appDir);
     // Get or generate build ID
-    const buildIdPath = path_1.default.join(cwd, '.vista', 'BUILD_ID');
+    const buildIdPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'BUILD_ID');
     let buildId = 'dev';
     try {
         if (fs_1.default.existsSync(buildIdPath)) {

package/dist/build/webpack/plugins/vista-flight-plugin.js

@@ -13,6 +13,7 @@ exports.VistaFlightPlugin = void 0;
 const webpack_1 = __importDefault(require("webpack"));
 const path_1 = __importDefault(require("path"));
 const component_identity_1 = require("../../rsc/component-identity");
+const constants_1 = require("../../../constants");
 const PLUGIN_NAME = 'VistaFlightPlugin';
 class VistaFlightPlugin {
     appDir;
@@ -88,7 +89,7 @@ class VistaFlightPlugin {
         const jsSource = `// Vista Client Reference Manifest
 (function() {
   if (typeof window !== 'undefined') {
-    window.__VISTA_CLIENT_MANIFEST__ = ${JSON.stringify(manifest, null, 2)};
+    window.${constants_1.CLIENT_MANIFEST_FLAG} = ${JSON.stringify(manifest, null, 2)};
   }
 })();`;
         compilation.emitAsset('vista-client-manifest.js', new webpack_1.default.sources.RawSource(jsSource));

package/dist/client/hydration.js

@@ -48,6 +48,7 @@ exports.hydrateClientComponents = hydrateClientComponents;
 exports.initializeHydration = initializeHydration;
 const React = __importStar(require("react"));
 const client_1 = require("react-dom/client");
+const constants_1 = require("../constants");
 // Track hydrated components
 const hydratedComponents = new Set();
 const loadedChunks = new Map();
@@ -175,7 +176,7 @@ async function hydrateComponent(reference) {
 async function hydrateClientComponents(options = {}) {
     const { progressive = false, priority = 'normal', useIdleCallback = false } = options;
     // Get references from window
-    const references = window.__VISTA_CLIENT_REFERENCES__ || [];
+    const references = window[constants_1.CLIENT_REFS_FLAG] || [];
     if (references.length === 0) {
         console.log('[Vista] No client components to hydrate');
         return;

package/dist/constants.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Vista Framework Constants
+ *
+ * All framework-specific naming lives here. When renaming the framework,
+ * only this file (and the Rust equivalent naming.rs) needs to change.
+ */
+/** Framework name used in logs, error messages, and branding */
+export declare const FRAMEWORK_NAME = "vista";
+/** Hidden build output directory name */
+export declare const BUILD_DIR = ".vista";
+/** Base URL prefix for all framework-served assets */
+export declare const URL_PREFIX = "/_vista";
+/** Static chunks URL path */
+export declare const STATIC_CHUNKS_PATH = "/_vista/static/chunks/";
+/** Image optimization endpoint URL */
+export declare const IMAGE_ENDPOINT = "/_vista/image";
+/** SSE live-reload endpoint */
+export declare const SSE_ENDPOINT = "/__vista_reload";
+/** Structure validation endpoint (dev only) */
+export declare const STRUCTURE_ENDPOINT = "/__vista_structure";
+/** Hydration mode flag: true = full document, false = content only */
+export declare const HYDRATE_DOCUMENT_FLAG = "__VISTA_HYDRATE_DOCUMENT__";
+/** Client config injection */
+export declare const CONFIG_FLAG = "__VISTA_CONFIG__";
+/** Client component references array */
+export declare const CLIENT_REFS_FLAG = "__VISTA_CLIENT_REFERENCES__";
+/** RSC payload data */
+export declare const RSC_DATA_FLAG = "__VISTA_RSC_DATA__";
+/** Build ID injection (webpack DefinePlugin) */
+export declare const BUILD_ID_DEFINE = "__VISTA_BUILD_ID__";
+/** Server-side flag (webpack DefinePlugin) */
+export declare const SERVER_DEFINE = "__VISTA_SERVER__";
+/** Client manifest injection */
+export declare const CLIENT_MANIFEST_FLAG = "__VISTA_CLIENT_MANIFEST__";
+/** Client components list */
+export declare const CLIENT_COMPONENTS_FLAG = "__VISTA_CLIENT_COMPONENTS__";
+/** Component wrapper marker to prevent double-wrapping */
+export declare const WRAPPED_MARKER = "__vistaWrapped";
+/** Theme setter function name */
+export declare const THEME_SETTER = "__vistaSetTheme";
+/** Client component mount ID prefix (used in Rust serializer too) */
+export declare const MOUNT_ID_PREFIX = "__vista_cc_";
+/** Local font family name prefix */
+export declare const LOCAL_FONT_PREFIX = "__vista_local_";
+/** URL prefixes to suppress in request logging */
+export declare const LOG_IGNORE_PREFIXES: string[];

package/dist/constants.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Vista Framework Constants
+ *
+ * All framework-specific naming lives here. When renaming the framework,
+ * only this file (and the Rust equivalent naming.rs) needs to change.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_IGNORE_PREFIXES = exports.LOCAL_FONT_PREFIX = exports.MOUNT_ID_PREFIX = exports.THEME_SETTER = exports.WRAPPED_MARKER = exports.CLIENT_COMPONENTS_FLAG = exports.CLIENT_MANIFEST_FLAG = exports.SERVER_DEFINE = exports.BUILD_ID_DEFINE = exports.RSC_DATA_FLAG = exports.CLIENT_REFS_FLAG = exports.CONFIG_FLAG = exports.HYDRATE_DOCUMENT_FLAG = exports.STRUCTURE_ENDPOINT = exports.SSE_ENDPOINT = exports.IMAGE_ENDPOINT = exports.STATIC_CHUNKS_PATH = exports.URL_PREFIX = exports.BUILD_DIR = exports.FRAMEWORK_NAME = void 0;
+// ============================================================================
+// Framework Identity
+// ============================================================================
+/** Framework name used in logs, error messages, and branding */
+exports.FRAMEWORK_NAME = 'vista';
+// ============================================================================
+// Build Directory (.vista/ — equivalent to Next.js .next/)
+// ============================================================================
+/** Hidden build output directory name */
+exports.BUILD_DIR = '.vista';
+// ============================================================================
+// URL Prefixes (/_vista/ — equivalent to Next.js /_next/)
+// ============================================================================
+/** Base URL prefix for all framework-served assets */
+exports.URL_PREFIX = '/_vista';
+/** Static chunks URL path */
+exports.STATIC_CHUNKS_PATH = '/_vista/static/chunks/';
+/** Image optimization endpoint URL */
+exports.IMAGE_ENDPOINT = '/_vista/image';
+/** SSE live-reload endpoint */
+exports.SSE_ENDPOINT = '/__vista_reload';
+/** Structure validation endpoint (dev only) */
+exports.STRUCTURE_ENDPOINT = '/__vista_structure';
+// ============================================================================
+// Window Globals (__VISTA_* — equivalent to Next.js __NEXT_*)
+// ============================================================================
+/** Hydration mode flag: true = full document, false = content only */
+exports.HYDRATE_DOCUMENT_FLAG = '__VISTA_HYDRATE_DOCUMENT__';
+/** Client config injection */
+exports.CONFIG_FLAG = '__VISTA_CONFIG__';
+/** Client component references array */
+exports.CLIENT_REFS_FLAG = '__VISTA_CLIENT_REFERENCES__';
+/** RSC payload data */
+exports.RSC_DATA_FLAG = '__VISTA_RSC_DATA__';
+/** Build ID injection (webpack DefinePlugin) */
+exports.BUILD_ID_DEFINE = '__VISTA_BUILD_ID__';
+/** Server-side flag (webpack DefinePlugin) */
+exports.SERVER_DEFINE = '__VISTA_SERVER__';
+/** Client manifest injection */
+exports.CLIENT_MANIFEST_FLAG = '__VISTA_CLIENT_MANIFEST__';
+/** Client components list */
+exports.CLIENT_COMPONENTS_FLAG = '__VISTA_CLIENT_COMPONENTS__';
+// ============================================================================
+// Internal Markers
+// ============================================================================
+/** Component wrapper marker to prevent double-wrapping */
+exports.WRAPPED_MARKER = '__vistaWrapped';
+/** Theme setter function name */
+exports.THEME_SETTER = '__vistaSetTheme';
+/** Client component mount ID prefix (used in Rust serializer too) */
+exports.MOUNT_ID_PREFIX = '__vista_cc_';
+/** Local font family name prefix */
+exports.LOCAL_FONT_PREFIX = '__vista_local_';
+// ============================================================================
+// Logger Ignore Prefixes
+// ============================================================================
+/** URL prefixes to suppress in request logging */
+exports.LOG_IGNORE_PREFIXES = ['/__vista', '/_vista/static/'];

package/dist/dev-error.js

@@ -15,6 +15,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
  * Uses inline styles and vanilla JS for interactivity.
  */
 const react_1 = __importDefault(require("react"));
+const constants_1 = require("./constants");
 // ============================================================================
 // Inline CSS (no external dependencies)
 // ============================================================================
@@ -297,7 +298,7 @@ function renderErrorHTML(errors) {
     // Vista live-reload: auto-refresh error overlay when files change
     (function() {
       function connect() {
-        var es = new EventSource('/__vista_reload');
+        var es = new EventSource('${constants_1.SSE_ENDPOINT}');
         es.onmessage = function(e) {
           if (e.data && e.data !== 'connected') window.location.reload();
         };

package/dist/font/local.js

@@ -29,6 +29,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createLocalFont = createLocalFont;
 const registry_1 = require("./registry");
+const constants_1 = require("../constants");
 // ─── Helpers ───────────────────────────────────────────────────────────────
 let _counter = 0;
 function hashName(name) {
@@ -85,7 +86,7 @@ function createLocalFont(options) {
     const sources = typeof src === 'string' ? [{ path: src, weight: String(weight), style }] : src;
     // Generate a unique family name
     _counter++;
-    const familyName = `__vista_local_${hashName(sources.map((s) => s.path).join('|') + _counter)}`;
+    const familyName = `${constants_1.LOCAL_FONT_PREFIX}${hashName(sources.map((s) => s.path).join('|') + _counter)}`;
     const className = `__font_${hashName(familyName)}`;
     const variableName = variable || `--font-local-${hashName(familyName)}`;
     const fontFamilyValue = `'${familyName}', ${fallback.join(', ')}`;

package/dist/image/image-config.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VALID_LOADERS = exports.imageConfigDefault = void 0;
+const constants_1 = require("../constants");
 exports.imageConfigDefault = {
     deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
     imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
-    path: '/_vista/image',
+    path: constants_1.IMAGE_ENDPOINT,
     loader: 'default',
     loaderFile: '',
     domains: [],

package/dist/image/image-loader.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultLoader = void 0;
+const constants_1 = require("../constants");
 /**
  * Default Vista image loader.
  *
@@ -18,6 +19,6 @@ const defaultLoader = ({ src, width, quality }) => {
         return src;
     }
     const q = quality || 75;
-    return `/_vista/image?url=${encodeURIComponent(src)}&w=${width}&q=${q}`;
+    return `${constants_1.IMAGE_ENDPOINT}?url=${encodeURIComponent(src)}&w=${width}&q=${q}`;
 };
 exports.defaultLoader = defaultLoader;

package/dist/integrity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Vista Framework Integrity Verification
+ *
+ * Cross-checks TypeScript constants against the compiled Rust binary.
+ * If someone renames constants.ts without recompiling the Rust native
+ * binary, the tokens won't match and the framework refuses to start.
+ *
+ * This is the core of Vista's rename-prevention system.
+ */
+/**
+ * Compute integrity token from JS constants.
+ * The order and values MUST match naming.rs::compute_integrity_token().
+ */
+export declare function computeJSIntegrityToken(): string;
+/**
+ * Verify framework integrity at startup.
+ * Loads the compiled Rust binary and cross-checks naming constants.
+ *
+ * @param nativeModule - The loaded vista-napi module
+ * @returns true if integrity check passes
+ * @throws Error if integrity check fails (framework has been tampered with)
+ */
+export declare function verifyFrameworkIntegrity(nativeModule?: any): boolean;
+/**
+ * Generate integrity watermark for build output.
+ * Embedded in the build manifest so built artifacts are also verified.
+ */
+export declare function generateBuildWatermark(): string;

package/dist/integrity.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Vista Framework Integrity Verification
+ *
+ * Cross-checks TypeScript constants against the compiled Rust binary.
+ * If someone renames constants.ts without recompiling the Rust native
+ * binary, the tokens won't match and the framework refuses to start.
+ *
+ * This is the core of Vista's rename-prevention system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeJSIntegrityToken = computeJSIntegrityToken;
+exports.verifyFrameworkIntegrity = verifyFrameworkIntegrity;
+exports.generateBuildWatermark = generateBuildWatermark;
+const constants_1 = require("./constants");
+// ============================================================================
+// JS-side integrity token computation
+// Must match the Rust-side compute_integrity_token() in naming.rs exactly.
+// ============================================================================
+/**
+ * Simple deterministic hash matching Rust's DefaultHasher behavior.
+ * We use the same algorithm: hash each string in the same order.
+ *
+ * NOTE: This intentionally uses a custom hasher to match Rust's DefaultHasher.
+ * Do NOT replace with crypto.createHash — it must produce the same output
+ * as the compiled binary.
+ */
+function hashString(str, seed) {
+    // Rust DefaultHasher (SipHash-2-4) approximation via string bytes
+    let h = seed;
+    for (let i = 0; i < str.length; i++) {
+        h = h ^ BigInt(str.charCodeAt(i));
+        h = (h * 0x100000001b3n) & 0xffffffffffffffffn;
+    }
+    // Add length (Rust hashes the string length too)
+    h = h ^ BigInt(str.length);
+    h = (h * 0x100000001b3n) & 0xffffffffffffffffn;
+    return h;
+}
+/**
+ * Compute integrity token from JS constants.
+ * The order and values MUST match naming.rs::compute_integrity_token().
+ */
+function computeJSIntegrityToken() {
+    const values = [
+        constants_1.FRAMEWORK_NAME,
+        constants_1.URL_PREFIX,
+        constants_1.STATIC_CHUNKS_PATH,
+        constants_1.MOUNT_ID_PREFIX,
+        constants_1.RSC_DATA_FLAG, // maps to RSC_DATA_GLOBAL in Rust
+        constants_1.CLIENT_REFS_FLAG, // maps to CLIENT_REFS_GLOBAL in Rust
+        constants_1.BUILD_ID_DEFINE, // maps to BUILD_ID_GLOBAL in Rust
+        constants_1.BUILD_DIR,
+        constants_1.SSE_ENDPOINT,
+        constants_1.IMAGE_ENDPOINT,
+    ];
+    let hash = 0xcbf29ce484222325n; // FNV offset basis
+    for (const val of values) {
+        hash = hashString(val, hash);
+    }
+    return hash.toString(16);
+}
+// ============================================================================
+// Runtime Verification
+// ============================================================================
+/**
+ * Verify framework integrity at startup.
+ * Loads the compiled Rust binary and cross-checks naming constants.
+ *
+ * @param nativeModule - The loaded vista-napi module
+ * @returns true if integrity check passes
+ * @throws Error if integrity check fails (framework has been tampered with)
+ */
+function verifyFrameworkIntegrity(nativeModule) {
+    // If native module isn't available, skip (graceful degradation)
+    if (!nativeModule?.getFrameworkIdentity) {
+        return true;
+    }
+    const identity = nativeModule.getFrameworkIdentity();
+    // Check 1: Framework name must match
+    if (identity.name !== constants_1.FRAMEWORK_NAME) {
+        throw new Error(`[${constants_1.FRAMEWORK_NAME}] Framework integrity check failed: ` +
+            `binary name "${identity.name}" !== constants name "${constants_1.FRAMEWORK_NAME}". ` +
+            `The native binary was compiled for a different framework version. ` +
+            `Please recompile with: cargo build --release`);
+    }
+    // Check 2: Individual constants must match
+    const mismatches = [];
+    if (identity.urlPrefix !== constants_1.URL_PREFIX)
+        mismatches.push(`URL_PREFIX: rust="${identity.urlPrefix}" ts="${constants_1.URL_PREFIX}"`);
+    if (identity.buildDir !== constants_1.BUILD_DIR)
+        mismatches.push(`BUILD_DIR: rust="${identity.buildDir}" ts="${constants_1.BUILD_DIR}"`);
+    if (identity.sseEndpoint !== constants_1.SSE_ENDPOINT)
+        mismatches.push(`SSE_ENDPOINT: rust="${identity.sseEndpoint}" ts="${constants_1.SSE_ENDPOINT}"`);
+    if (identity.imageEndpoint !== constants_1.IMAGE_ENDPOINT)
+        mismatches.push(`IMAGE_ENDPOINT: rust="${identity.imageEndpoint}" ts="${constants_1.IMAGE_ENDPOINT}"`);
+    if (identity.mountIdPrefix !== constants_1.MOUNT_ID_PREFIX)
+        mismatches.push(`MOUNT_ID_PREFIX: rust="${identity.mountIdPrefix}" ts="${constants_1.MOUNT_ID_PREFIX}"`);
+    if (identity.staticChunksPath !== constants_1.STATIC_CHUNKS_PATH)
+        mismatches.push(`STATIC_CHUNKS_PATH: rust="${identity.staticChunksPath}" ts="${constants_1.STATIC_CHUNKS_PATH}"`);
+    if (mismatches.length > 0) {
+        throw new Error(`[${constants_1.FRAMEWORK_NAME}] Framework integrity check failed — ` +
+            `TypeScript constants don't match compiled Rust binary:\n` +
+            mismatches.map((m) => `  • ${m}`).join('\n') +
+            '\n' +
+            `Please recompile the native binary: cargo build --release`);
+    }
+    return true;
+}
+/**
+ * Generate integrity watermark for build output.
+ * Embedded in the build manifest so built artifacts are also verified.
+ */
+function generateBuildWatermark() {
+    return `${constants_1.FRAMEWORK_NAME}:${computeJSIntegrityToken()}`;
+}

package/dist/server/artifact-validator.js

@@ -7,6 +7,7 @@ exports.validateVistaArtifacts = validateVistaArtifacts;
 exports.assertVistaArtifacts = assertVistaArtifacts;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
 const BASE_REQUIRED_FILES = [
     'BUILD_ID',
     'artifact-manifest.json',
@@ -18,14 +19,8 @@ const BASE_REQUIRED_FILES = [
     'react-client-manifest.json',
     'react-server-manifest.json',
 ];
-const RSC_REQUIRED_FILES = [
-    ...BASE_REQUIRED_FILES,
-    path_1.default.join('server', 'server-manifest.json'),
-];
-const LEGACY_REQUIRED_FILES = [
-    ...BASE_REQUIRED_FILES,
-    'client.js',
-];
+const RSC_REQUIRED_FILES = [...BASE_REQUIRED_FILES, path_1.default.join('server', 'server-manifest.json')];
+const LEGACY_REQUIRED_FILES = [...BASE_REQUIRED_FILES, 'client.js'];
 function readJsonSafe(absolutePath) {
     try {
         return JSON.parse(fs_1.default.readFileSync(absolutePath, 'utf-8'));
@@ -35,11 +30,11 @@ function readJsonSafe(absolutePath) {
     }
 }
 function validateVistaArtifacts(cwd, mode) {
-    const vistaDir = path_1.default.join(cwd, '.vista');
+    const vistaDir = path_1.default.join(cwd, constants_1.BUILD_DIR);
     const missing = [];
     const requiredFiles = mode === 'rsc' ? RSC_REQUIRED_FILES : LEGACY_REQUIRED_FILES;
     if (!fs_1.default.existsSync(vistaDir)) {
-        return ['.vista directory is missing'];
+        return [`${constants_1.BUILD_DIR} directory is missing`];
     }
     for (const relativePath of requiredFiles) {
         const absolutePath = path_1.default.join(vistaDir, relativePath);
@@ -59,5 +54,5 @@ function assertVistaArtifacts(cwd, mode) {
     if (missing.length === 0)
         return;
     const missingList = missing.map((entry) => `- ${entry}`).join('\n');
-    throw new Error(`[vista:server] Missing or invalid .vista artifacts for ${mode} mode.\n${missingList}\nRun "vista build${mode === 'rsc' ? ' --rsc' : ''}" first.`);
+    throw new Error(`[vista:server] Missing or invalid ${constants_1.BUILD_DIR} artifacts for ${mode} mode.\n${missingList}\nRun "vista build${mode === 'rsc' ? ' --rsc' : ''}" first.`);
 }

package/dist/server/engine.js

@@ -14,6 +14,7 @@ const react_1 = __importDefault(require("react"));
 const stream_1 = require("stream");
 const webpack_dev_middleware_1 = __importDefault(require("webpack-dev-middleware"));
 const webpack_hot_middleware_1 = __importDefault(require("webpack-hot-middleware"));
+const constants_1 = require("../constants");
 const config_1 = require("../config");
 const dev_error_1 = require("../dev-error");
 const artifact_validator_1 = require("./artifact-validator");
@@ -164,10 +165,10 @@ function enableClientComponentWrapping(appDir, cwd) {
                 const componentId = getClientComponentId(resolved);
                 if (componentId && result?.default) {
                     // Wrap the default export if not already wrapped
-                    if (!result.default.__vistaWrapped) {
+                    if (!result.default[constants_1.WRAPPED_MARKER]) {
                         const OriginalComponent = result.default;
                         const WrappedComponent = (0, client_boundary_1.wrapClientComponent)(OriginalComponent, componentId);
-                        WrappedComponent.__vistaWrapped = true;
+                        WrappedComponent[constants_1.WRAPPED_MARKER] = true;
                         result.default = WrappedComponent;
                     }
                 }
@@ -222,7 +223,7 @@ function startServer(port = 3003, compiler) {
     // Enable RSC: Auto-wrap client components with hydration markers
     enableClientComponentWrapping(appDir, cwd);
     // Load pre-rendered static pages from disk into in-memory cache
-    const vistaDirRoot = path_1.default.join(cwd, '.vista');
+    const vistaDirRoot = path_1.default.join(cwd, constants_1.BUILD_DIR);
     const loadedStaticPages = (0, static_cache_1.loadStaticPagesFromDisk)(vistaDirRoot);
     if (loadedStaticPages > 0) {
         (0, logger_1.logInfo)(`Loaded ${loadedStaticPages} pre-rendered page(s) from cache`);
@@ -248,7 +249,7 @@ function startServer(port = 3003, compiler) {
         // Watches server component files and triggers page reload
         const sseClients = new Set();
         // SSE endpoint for server reload
-        app.get('/__vista_reload', (req, res) => {
+        app.get(constants_1.SSE_ENDPOINT, (req, res) => {
             res.setHeader('Content-Type', 'text/event-stream');
             res.setHeader('Cache-Control', 'no-cache');
             res.setHeader('Connection', 'keep-alive');
@@ -375,12 +376,12 @@ function startServer(port = 3003, compiler) {
     app.use(express_1.default.static(path_1.default.join(cwd, 'public')));
     // Image optimization endpoint
     const imageHandler = (0, image_optimizer_1.createImageHandler)(cwd, isDev);
-    app.get('/_vista/image', imageHandler);
+    app.get(constants_1.IMAGE_ENDPOINT, imageHandler);
     // Serve .vista build artifacts with proper routing
     // /_vista/static/* -> .vista/static/*
-    app.use('/_vista/static', express_1.default.static(path_1.default.join(cwd, '.vista', 'static')));
+    app.use(`${constants_1.URL_PREFIX}/static`, express_1.default.static(path_1.default.join(cwd, constants_1.BUILD_DIR, 'static')));
     // Legacy: Serve .vista root for backward compatibility (client.css, etc.)
-    app.use(express_1.default.static(path_1.default.join(cwd, '.vista')));
+    app.use(express_1.default.static(path_1.default.join(cwd, constants_1.BUILD_DIR)));
     app.use(async (req, res, next) => {
         if (req.path.startsWith('/styles.css') || req.path.startsWith('/__webpack_hmr')) {
             return next();
@@ -672,7 +673,7 @@ layouts) {
                     d.classList.add('dark');
                     d.classList.remove('light');
                     d.style.colorScheme = 'dark';
-                    window.__vistaSetTheme = function(newTheme) {
+                    window.${constants_1.THEME_SETTER} = function(newTheme) {
                         d.classList.remove('light', 'dark');
                         d.classList.add(newTheme);
                         d.style.colorScheme = newTheme;

package/dist/server/logger.js

@@ -21,6 +21,7 @@ exports.logEvent = logEvent;
 exports.requestLogger = requestLogger;
 exports.markStartTime = markStartTime;
 const os_1 = __importDefault(require("os"));
+const constants_1 = require("../constants");
 // ─── ANSI Colors ───────────────────────────────────────────────────────────
 const bold = (s) => `\x1b[1m${s}\x1b[22m`;
 const dim = (s) => `\x1b[2m${s}\x1b[22m`;
@@ -199,8 +200,7 @@ function getVistaVersion() {
 }
 const INTERNAL_PREFIXES = [
     '/__webpack',
-    '/__vista',
-    '/_vista/static/',
+    ...constants_1.LOG_IGNORE_PREFIXES,
     '/favicon.ico',
     '/_next',
     '/hot-update',

package/dist/server/rsc-engine.js

@@ -30,6 +30,7 @@ const logger_1 = require("./logger");
 const not_found_page_1 = require("./not-found-page");
 const static_cache_1 = require("./static-cache");
 const static_generator_1 = require("./static-generator");
+const constants_1 = require("../constants");
 const CjsModule = require('module');
 // ---------------------------------------------------------------------------
 // SSR Webpack Shim
@@ -85,12 +86,12 @@ function getCSSLinks(projectRoot) {
     const root = projectRoot || process.cwd();
     const links = ['<link rel="stylesheet" href="/styles.css" />'];
     // Check for extracted CSS modules (from MiniCssExtractPlugin)
-    const chunksDir = path_1.default.join(root, '.vista', 'static', 'chunks');
+    const chunksDir = path_1.default.join(root, constants_1.BUILD_DIR, 'static', 'chunks');
     try {
         if (fs_1.default.existsSync(chunksDir)) {
             const files = fs_1.default.readdirSync(chunksDir).filter((f) => f.endsWith('.css'));
             for (const f of files) {
-                links.push(`<link rel="stylesheet" href="/_vista/static/chunks/${f}" />`);
+                links.push(`<link rel="stylesheet" href="${constants_1.STATIC_CHUNKS_PATH}${f}" />`);
             }
         }
     }
@@ -151,6 +152,15 @@ function setupTypeScriptRuntime(cwd) {
                 esModuleInterop: true,
             },
         });
+        return;
+    }
+    catch {
+        // fallback
+    }
+    try {
+        require.resolve('tsx', { paths: [cwd] });
+        require('tsx/cjs');
+        return;
     }
     catch (e) {
         console.log('Failed to setup TypeScript runtime:', e);
@@ -218,7 +228,7 @@ function withTimeout(url, options = {}, timeoutMs = 3000) {
     });
 }
 function cleanHotUpdateFiles(cwd) {
-    const chunksDir = path_1.default.join(cwd, '.vista', 'static', 'chunks');
+    const chunksDir = path_1.default.join(cwd, constants_1.BUILD_DIR, 'static', 'chunks');
     if (!fs_1.default.existsSync(chunksDir))
         return;
     for (const f of fs_1.default.readdirSync(chunksDir)) {
@@ -231,7 +241,7 @@ function cleanHotUpdateFiles(cwd) {
     }
 }
 function findChunkFiles(cwd) {
-    const chunksDir = path_1.default.join(cwd, '.vista', 'static', 'chunks');
+    const chunksDir = path_1.default.join(cwd, constants_1.BUILD_DIR, 'static', 'chunks');
     if (!fs_1.default.existsSync(chunksDir))
         return [];
     const files = fs_1.default
@@ -404,14 +414,14 @@ function injectBeforeClosingTag(html, tagName, injection) {
 }
 function createHtmlDocument(appHtml, metadataHtml, chunkFiles, rootMode = 'legacy') {
     const scripts = chunkFiles
-        .map((chunk) => `<script defer src="/_vista/static/chunks/${chunk}"></script>`)
+        .map((chunk) => `<script defer src="${constants_1.STATIC_CHUNKS_PATH}${chunk}"></script>`)
         .join('\n  ');
     if (rootMode === 'document' ||
         /^\s*<!doctype html>\s*<html/i.test(appHtml) ||
         /^\s*<html/i.test(appHtml)) {
         const fontHtml = (0, registry_1.getAllFontHTML)();
         const headInjection = `\n  <meta charset="utf-8" />\n  <meta name="viewport" content="width=device-width, initial-scale=1" />\n  ${metadataHtml}\n  ${fontHtml}\n  ${getCSSLinks()}`;
-        const bodyInjection = `\n  <script>window.__VISTA_HYDRATE_DOCUMENT__ = true;</script>\n  ${scripts}`;
+        const bodyInjection = `\n  <script>window.${constants_1.HYDRATE_DOCUMENT_FLAG} = true;</script>\n  ${scripts}`;
         let html = appHtml;
         if (!/^\s*<!doctype html>/i.test(html)) {
             html = `<!DOCTYPE html>\n${html}`;
@@ -431,7 +441,7 @@ function createHtmlDocument(appHtml, metadataHtml, chunkFiles, rootMode = 'legac
   ${getCSSLinks()}
 </head>
 <body>
-  <script>window.__VISTA_HYDRATE_DOCUMENT__ = false;</script>
+  <script>window.${constants_1.HYDRATE_DOCUMENT_FLAG} = false;</script>
   <div id="root">${appHtml}</div>
   ${scripts}
 </body>
@@ -545,7 +555,7 @@ async function renderFlightToHTMLStream(upstreamOrigin, pathname, search, metada
     const element = react_1.default.createElement(FlightRoot);
     // 5. Build script tags for client chunks
     const scripts = chunkFiles
-        .map((chunk) => `<script defer src="/_vista/static/chunks/${chunk}"></script>`)
+        .map((chunk) => `<script defer src="${constants_1.STATIC_CHUNKS_PATH}${chunk}"></script>`)
         .join('\n  ');
     // 6. Render to a pipeable HTML stream
     return new Promise((resolve, reject) => {
@@ -574,7 +584,7 @@ async function renderFlightToHTMLStream(upstreamOrigin, pathname, search, metada
                         // Inject scripts before </body>
                         if (html.includes('</body>')) {
                             const bodyInjection = `
-  <script>window.__VISTA_HYDRATE_DOCUMENT__ = ${rootMode === 'document'};</script>
+  <script>window.${constants_1.HYDRATE_DOCUMENT_FLAG} = ${rootMode === 'document'};</script>
   ${scripts}`;
                             html = html.replace('</body>', `${bodyInjection}\n</body>`);
                         }
@@ -606,14 +616,14 @@ async function renderFlightToHTMLStream(upstreamOrigin, pathname, search, metada
  */
 function wrapInDocumentShell(bodyContent, metadataHtml, chunkFiles, rootMode) {
     const scripts = chunkFiles
-        .map((chunk) => `<script defer src="/_vista/static/chunks/${chunk}"></script>`)
+        .map((chunk) => `<script defer src="${constants_1.STATIC_CHUNKS_PATH}${chunk}"></script>`)
         .join('\n  ');
     if (rootMode === 'document' ||
         /^\s*<!doctype html>\s*<html/i.test(bodyContent) ||
         /^\s*<html/i.test(bodyContent)) {
         const fontHtml = (0, registry_1.getAllFontHTML)();
         const headInjection = `\n  <meta charset="utf-8" />\n  <meta name="viewport" content="width=device-width, initial-scale=1" />\n  ${metadataHtml}\n  ${fontHtml}\n  ${getCSSLinks()}`;
-        const bodyInjection = `\n  <script>window.__VISTA_HYDRATE_DOCUMENT__ = true;</script>\n  ${scripts}`;
+        const bodyInjection = `\n  <script>window.${constants_1.HYDRATE_DOCUMENT_FLAG} = true;</script>\n  ${scripts}`;
         let html = bodyContent;
         if (!/^\s*<!doctype html>/i.test(html)) {
             html = `<!DOCTYPE html>\n${html}`;
@@ -633,7 +643,7 @@ function wrapInDocumentShell(bodyContent, metadataHtml, chunkFiles, rootMode) {
   ${getCSSLinks()}
 </head>
 <body>
-  <script>window.__VISTA_HYDRATE_DOCUMENT__ = false;</script>
+  <script>window.${constants_1.HYDRATE_DOCUMENT_FLAG} = false;</script>
   <div id="root">${bodyContent}</div>
   ${scripts}
 </body>
@@ -654,7 +664,7 @@ function startRSCServer(options = {}) {
     installSingleReactResolution(cwd);
     setupTypeScriptRuntime(cwd);
     installSSRWebpackShim();
-    const serverManifestPath = path_1.default.join(cwd, '.vista', 'server', 'server-manifest.json');
+    const serverManifestPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'server', 'server-manifest.json');
     if (!fs_1.default.existsSync(serverManifestPath)) {
         console.error(`[vista:rsc] Missing server manifest at ${serverManifestPath}. Run "vista build --rsc" first.`);
         process.exit(1);
@@ -678,8 +688,8 @@ function startRSCServer(options = {}) {
     catch (err) {
         // Flight SSR not available — fallback to renderToString
     }
-    const ssrManifestPath = path_1.default.join(cwd, '.vista', 'react-server-manifest.json');
-    const ssrManifestLegacyPath = path_1.default.join(cwd, '.vista', 'react-ssr-manifest.json');
+    const ssrManifestPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'react-server-manifest.json');
+    const ssrManifestLegacyPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'react-ssr-manifest.json');
     const resolvedSSRManifestPath = fs_1.default.existsSync(ssrManifestPath)
         ? ssrManifestPath
         : fs_1.default.existsSync(ssrManifestLegacyPath)
@@ -731,7 +741,7 @@ function startRSCServer(options = {}) {
     // ========================================================================
     // Load pre-rendered static pages from disk into in-memory cache
     // ========================================================================
-    const vistaDirRoot = path_1.default.join(cwd, '.vista');
+    const vistaDirRoot = path_1.default.join(cwd, constants_1.BUILD_DIR);
     const loadedStaticPages = (0, static_cache_1.loadStaticPagesFromDisk)(vistaDirRoot);
     if (loadedStaticPages > 0) {
         (0, logger_1.logInfo)(`Loaded ${loadedStaticPages} pre-rendered page(s) from cache`);
@@ -817,7 +827,7 @@ function startRSCServer(options = {}) {
     // ========================================================================
     const sseReloadClients = new Set();
     if (isDev) {
-        app.get('/__vista_reload', (req, res) => {
+        app.get(constants_1.SSE_ENDPOINT, (req, res) => {
             res.setHeader('Content-Type', 'text/event-stream');
             res.setHeader('Cache-Control', 'no-cache');
             res.setHeader('Connection', 'keep-alive');
@@ -849,7 +859,7 @@ function startRSCServer(options = {}) {
     }
     if (isDev && options.compiler) {
         app.use((0, webpack_dev_middleware_1.default)(options.compiler, {
-            publicPath: '/_vista/static/chunks/',
+            publicPath: constants_1.STATIC_CHUNKS_PATH,
             stats: 'none',
             writeToDisk: true,
         }));
@@ -896,7 +906,7 @@ function startRSCServer(options = {}) {
     // Structure Watcher SSE (RSC dev mode)
     // ========================================================================
     const sseStructureClients = new Set();
-    app.get('/__vista_structure', (req, res) => {
+    app.get(constants_1.STRUCTURE_ENDPOINT, (req, res) => {
         res.setHeader('Content-Type', 'text/event-stream');
         res.setHeader('Cache-Control', 'no-cache');
         res.setHeader('Connection', 'keep-alive');
@@ -949,7 +959,7 @@ function startRSCServer(options = {}) {
         });
     }
     app.get('/styles.css', (req, res) => {
-        const cssPath = path_1.default.join(cwd, '.vista', 'client.css');
+        const cssPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'client.css');
         if (fs_1.default.existsSync(cssPath)) {
             res.setHeader('Content-Type', 'text/css');
             res.sendFile(cssPath);
@@ -959,11 +969,11 @@ function startRSCServer(options = {}) {
     });
     // Image optimization endpoint
     const imageHandler = (0, image_optimizer_1.createImageHandler)(cwd, isDev);
-    app.get('/_vista/image', imageHandler);
+    app.get(constants_1.IMAGE_ENDPOINT, imageHandler);
     app.use(express_1.default.static(path_1.default.join(cwd, 'public')));
-    app.use('/_vista/static', express_1.default.static(path_1.default.join(cwd, '.vista', 'static')));
-    app.use('/_vista', express_1.default.static(path_1.default.join(cwd, '.vista')));
-    app.use(express_1.default.static(path_1.default.join(cwd, '.vista')));
+    app.use(`${constants_1.URL_PREFIX}/static`, express_1.default.static(path_1.default.join(cwd, constants_1.BUILD_DIR, 'static')));
+    app.use(constants_1.URL_PREFIX, express_1.default.static(path_1.default.join(cwd, constants_1.BUILD_DIR)));
+    app.use(express_1.default.static(path_1.default.join(cwd, constants_1.BUILD_DIR)));
     const proxyRSCRequest = async (req, res) => {
         try {
             const fetchOptions = {

package/dist/server/rsc-upstream.js

@@ -9,6 +9,7 @@ const path_1 = __importDefault(require("path"));
 const react_1 = __importDefault(require("react"));
 const url_1 = require("url");
 const root_resolver_1 = require("./root-resolver");
+const constants_1 = require("../constants");
 // NOTE: RouteErrorBoundary and RouteSuspense are 'use client' components.
 // Under --conditions react-server, React.Component is not available, so we
 // must NOT import them at the top level.  Instead we lazy-require them after
@@ -96,9 +97,19 @@ function setupTypeScriptRuntime(cwd) {
                 esModuleInterop: true,
             },
         });
+        return;
+    }
+    catch {
+        // fallback
+    }
+    try {
+        require.resolve('tsx', { paths: [cwd] });
+        // tsx/cjs registers the TypeScript loader for require()
+        require('tsx/cjs');
+        return;
     }
     catch {
-        throw new Error('No TypeScript compiler available for RSC upstream runtime.');
+        throw new Error('No TypeScript compiler available for RSC upstream runtime. Install one of: @swc-node/register, ts-node, or tsx');
     }
 }
 function hasClientBoundaryDirective(source) {
@@ -323,8 +334,8 @@ function startUpstream() {
     const flightServerPath = resolveFromWorkspace('react-server-dom-webpack/server.node', cwd);
     const flightServer = require(flightServerPath);
     installClientLoadHook(cwd, flightServer.createClientModuleProxy);
-    const serverManifestPath = path_1.default.join(cwd, '.vista', 'server', 'server-manifest.json');
-    const flightManifestPath = path_1.default.join(cwd, '.vista', 'react-client-manifest.json');
+    const serverManifestPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'server', 'server-manifest.json');
+    const flightManifestPath = path_1.default.join(cwd, constants_1.BUILD_DIR, 'react-client-manifest.json');
     if (!fs_1.default.existsSync(serverManifestPath)) {
         throw new Error('Missing RSC server manifest. Run "vista build" first.');
     }

package/dist/server/structure-watch.js

@@ -17,6 +17,7 @@ exports.createStructureWatcher = createStructureWatcher;
 const path_1 = __importDefault(require("path"));
 const events_1 = require("events");
 const structure_validator_1 = require("./structure-validator");
+const constants_1 = require("../constants");
 // ============================================================================
 // Watch Service
 // ============================================================================
@@ -52,7 +53,7 @@ class StructureWatcher extends events_1.EventEmitter {
             ];
             this.watcher = chokidar.watch(watchPaths, {
                 ignoreInitial: true,
-                ignored: ['**/node_modules/**', '**/.vista/**', '**/dist/**'],
+                ignored: ['**/node_modules/**', `**/${constants_1.BUILD_DIR}/**`, '**/dist/**'],
                 persistent: true,
             });
             this.watcher.on('all', (event, filePath) => {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@vistagenic/vista",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "The React Framework for Visionaries - Rust-powered SSR with Server Components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/vistagen/Vista-Js.git",
+    "url": "git+https://github.com/vistagen/Vista-Js.git",
     "directory": "packages/vista"
   },
   "author": "Vista Team",
@@ -88,7 +88,7 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "vista": "./bin/vista.js"
+    "vista": "bin/vista.js"
   },
   "publishConfig": {
     "access": "public"