veryfront 0.0.84 → 0.0.88

package/esm/src/transforms/esm/http-bundler.js

@@ -134,40 +134,133 @@ export function createHTTPPlugin() {
     };
 }
 /**
- * Ensure esm.sh URLs have ?external=react for SSR.
- * This makes them import React as a bare specifier, which deno.json resolves.
+ * Ensure esm.sh URLs have external=react,react-dom for SSR.
+ * This makes them import React as bare specifiers, which the import map resolves.
  *
  * Uses two esm.sh features:
- * - `external=react` - Don't bundle React, let import map resolve it
+ * - `external=react,react-dom` - Don't bundle React/ReactDOM, let import map resolve them
  * - `deps=react@X,react-dom@X` - Pin dependency versions to prevent mismatches
+ *
+ * Logic for external handling:
+ * 1. If no `external=` param → add `external=react,react-dom`
+ * 2. If `external=X` exists but no `react` → append `,react,react-dom`
+ * 3. If has `react` but no `react-dom` → append `,react-dom`
+ * 4. If has both `react` AND `react-dom` → leave alone
+ *
+ * @param code - Source code to process
+ * @param _cacheDir - Unused (kept for API compatibility)
+ * @param hash - Hash for logging
+ * @param reactVersion - React version for deps param (defaults to REACT_VERSION)
  */
-export function bundleHttpImports(code, _cacheDir, hash) {
+export function bundleHttpImports(code, _cacheDir, hash, reactVersion) {
     const has = hasHttpImports(code);
     logger.debug(`${LOG_PREFIX} Check: hasHttp=${has}, hash=${hash.slice(0, 8)}`);
     if (!has)
         return code;
+    const version = reactVersion ?? REACT_VERSION;
     return replaceSpecifiers(code, (specifier) => {
+        // Handle relative esm.sh paths like "/react-dom?target=es2022" or "/hoist-non-react-statics@..."
+        // These are returned by esm.sh stub modules and need to be converted to full URLs
+        if (specifier.startsWith("/") && !specifier.startsWith("//")) {
+            const fullUrl = `https://esm.sh${specifier}`;
+            // Recursively process as full URL (will add external params if needed)
+            const isReactPackage = /^\/react(-dom)?(@|\/|\?|$)/.test(specifier);
+            if (isReactPackage) {
+                // React packages - just ensure target and return full URL
+                if (!specifier.includes("target=")) {
+                    const joiner = specifier.includes("?") ? "&" : "?";
+                    return `${fullUrl}${joiner}target=es2022`;
+                }
+                return fullUrl;
+            }
+            // Non-React packages - add external params
+            const params = [];
+            if (!specifier.includes("target="))
+                params.push("target=es2022");
+            if (!specifier.includes("external="))
+                params.push("external=react,react-dom");
+            if (!specifier.includes("deps="))
+                params.push(`deps=react@${version},react-dom@${version}`);
+            if (params.length === 0)
+                return fullUrl;
+            const joiner = specifier.includes("?") ? "&" : "?";
+            return `${fullUrl}${joiner}${params.join("&")}`;
+        }
         const isEsmSh = specifier.startsWith("https://esm.sh/") ||
             specifier.startsWith("http://esm.sh/");
         const isVfEsm = specifier.startsWith("https://esm.veryfront.com/");
         if (!isEsmSh && !isVfEsm)
             return null;
+        // Don't modify React/ReactDOM package URLs themselves
         const isReactPackage = /\/react(-dom)?(@|\/|$)/.test(specifier);
+        if (isReactPackage) {
+            // Just ensure target is set for React packages
+            if (!specifier.includes("target=")) {
+                const joiner = specifier.includes("?") ? "&" : "?";
+                return `${specifier}${joiner}target=es2022`;
+            }
+            return null;
+        }
+        // For non-React packages: ensure external=react,react-dom and deps
         const params = [];
         if (!specifier.includes("target=")) {
             params.push("target=es2022");
         }
-        // Only add external and deps to non-React packages
-        // Use external=react to not bundle React (let import map resolve it)
-        // Use deps=react@X,react-dom@X to pin dependency versions
-        if (!isReactPackage) {
-            if (!specifier.includes("external=react")) {
-                params.push("external=react");
+        // Handle external param - ensure both react AND react-dom are externalized
+        const hasExternal = specifier.includes("external=");
+        const hasReactExternal = specifier.includes("external=react") ||
+            /external=[^&]*\breact\b/.test(specifier);
+        const hasReactDomExternal = /external=[^&]*react-dom/.test(specifier);
+        if (!hasExternal) {
+            // No external param - add both
+            params.push("external=react,react-dom");
+        }
+        else if (!hasReactExternal) {
+            // Has external but no react - append react,react-dom
+            // This requires modifying existing param, so we'll use URL parsing
+            try {
+                const url = new URL(specifier);
+                const existing = url.searchParams.get("external") || "";
+                url.searchParams.set("external", `${existing},react,react-dom`);
+                // Return full modified URL and skip other param additions
+                if (!specifier.includes("target=")) {
+                    url.searchParams.set("target", "es2022");
+                }
+                if (!specifier.includes("deps=")) {
+                    url.searchParams.set("deps", `react@${version},react-dom@${version}`);
+                }
+                logger.debug(`${LOG_PREFIX} ${specifier} -> ${url.toString()}`);
+                return url.toString();
+            }
+            catch {
+                // Fallback: just add as new param (may create duplicate)
+                params.push("external=react,react-dom");
+            }
+        }
+        else if (!hasReactDomExternal) {
+            // Has react but not react-dom - append react-dom
+            try {
+                const url = new URL(specifier);
+                const existing = url.searchParams.get("external") || "";
+                url.searchParams.set("external", `${existing},react-dom`);
+                if (!specifier.includes("target=")) {
+                    url.searchParams.set("target", "es2022");
+                }
+                if (!specifier.includes("deps=")) {
+                    url.searchParams.set("deps", `react@${version},react-dom@${version}`);
+                }
+                logger.debug(`${LOG_PREFIX} ${specifier} -> ${url.toString()}`);
+                return url.toString();
             }
-            if (!specifier.includes("deps=")) {
-                params.push(`deps=react@${REACT_VERSION},react-dom@${REACT_VERSION}`);
+            catch {
+                // Fallback
+                params.push("external=react-dom");
             }
         }
+        // else: has both react and react-dom - no external changes needed
+        if (!specifier.includes("deps=")) {
+            params.push(`deps=react@${version},react-dom@${version}`);
+        }
         if (params.length === 0)
             return null;
         const joiner = specifier.includes("?") ? "&" : "?";

package/esm/src/transforms/esm/http-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAmBzE,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAyUF;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8D9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAiInB"}
+{"version":3,"file":"http-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAezE,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAoVF;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8D9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAiInB"}

package/esm/src/transforms/esm/http-cache.js

@@ -10,23 +10,26 @@ import * as dntShim from "../../../_dnt.shims.js";
 import { createFileSystem, exists } from "../../platform/compat/fs.js";
 import { isAbsolute, join } from "../../platform/compat/path/index.js";
 import { cwd } from "../../platform/compat/process.js";
+import { isDeno } from "../../platform/compat/runtime.js";
 import { rendererLogger as logger } from "../../utils/index.js";
 import { simpleHash } from "../../utils/hash-utils.js";
 import { LRUCache } from "../../utils/lru-wrapper.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../observability/tracing/span-names.js";
 import { resolveImport } from "../../modules/import-map/resolver.js";
-import { isDeno } from "../../platform/compat/runtime.js";
-import { getDenoNpmReactMap, getReactImportMap, REACT_VERSION } from "./package-registry.js";
+import { getReactImportMap, REACT_VERSION } from "./package-registry.js";
 import { parseImports, replaceSpecifiers } from "./lexer.js";
 import { CacheBackends, createDistributedCacheAccessor } from "../../cache/backend.js";
 import { HTTP_MODULE_CACHE_MAX_ENTRIES, HTTP_MODULE_DISTRIBUTED_TTL_SEC, } from "../../utils/constants/cache.js";
 /** Lazy-loaded distributed cache backend for cross-pod sharing */
 const getDistributedCache = createDistributedCacheAccessor(() => CacheBackends.httpModule(), "HTTP-CACHE");
-/** TTL for cached modules in distributed cache (uses centralized config) */
-const DISTRIBUTED_CACHE_TTL_SECONDS = HTTP_MODULE_DISTRIBUTED_TTL_SEC;
 const cachedPaths = new LRUCache({ maxEntries: HTTP_MODULE_CACHE_MAX_ENTRIES });
 const processingStack = new Set();
+/** Tracks last TTL refresh per hash. Refresh every 4h to keep 20h+ remaining (24h total). */
+const lastDistributedRefresh = new LRUCache({
+    maxEntries: HTTP_MODULE_CACHE_MAX_ENTRIES,
+});
+const DISTRIBUTED_REFRESH_INTERVAL_MS = 4 * 60 * 60 * 1000;
 function ensureAbsoluteDir(path) {
     return isAbsolute(path) ? path : join(cwd(), path);
 }
@@ -36,13 +39,24 @@ function isHttpUrl(specifier) {
 /**
  * Check if a URL is for React core packages.
  *
- * Previously, React modules were NOT cached to prevent multiple React instances.
- * Now with npm: specifiers for Deno (which auto-deduplicate) and consistent
- * esm.sh URLs with external=react for other runtimes, all code uses the same
- * React instance.
+ * React core modules (react, react-dom) must NOT be cached/bundled.
+ * Instead, all packages use external=react and import from the same esm.sh URL.
+ * This prevents multiple React instances which causes "useContext is null" errors.
  */
-function isReactCoreUrl(_url) {
-    return false;
+function isReactCoreUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.hostname.includes("esm.sh"))
+            return false;
+        // Extract package name from esm.sh pathname
+        // Formats: /react@version, /v150/react@version, /stable/react@version
+        const pathname = parsed.pathname.replace(/^\/(v\d+|stable)\//, "/");
+        const match = pathname.match(/^\/(react|react-dom)(@[\d.]+)?(?:\/|$|\?)/);
+        return match !== null;
+    }
+    catch {
+        return false;
+    }
 }
 function isExternalScheme(specifier) {
     return specifier.startsWith("node:") ||
@@ -98,25 +112,8 @@ function toEsmShUrlFromNpm(specifier) {
     return `https://esm.sh/${specifier.slice(4)}`;
 }
 function resolveBareSpecifier(specifier, importMap, reactVersion = REACT_VERSION) {
-    // For Deno SSR: Resolve React to npm: specifiers for automatic deduplication.
-    // Deno's native npm resolution ensures all modules share the same React instance.
-    // See: https://deno.com/blog/not-using-npm-specifiers-doing-it-wrong
-    if (isDeno) {
-        const denoReactMap = getDenoNpmReactMap(reactVersion);
-        const denoMatch = denoReactMap[specifier];
-        if (denoMatch)
-            return denoMatch;
-        // For unknown react/* or react-dom/* subpaths, construct npm: specifiers
-        if (specifier.startsWith("react/") && !specifier.startsWith("react-dom")) {
-            const subpath = specifier.slice("react/".length);
-            return `npm:react@${reactVersion}/${subpath}`;
-        }
-        if (specifier.startsWith("react-dom/")) {
-            const subpath = specifier.slice("react-dom/".length);
-            return `npm:react-dom@${reactVersion}/${subpath}`;
-        }
-    }
-    // For non-Deno runtimes: Use esm.sh URLs with consistent versioning.
+    // Use esm.sh URLs for React - NO npm: specifiers per plan requirements.
+    // All packages use external=react to share the same React instance.
     const reactMap = getReactImportMap(reactVersion);
     const reactMapped = reactMap[specifier];
     if (reactMapped)
@@ -151,23 +148,28 @@ async function cacheHttpModule(url, options) {
     const fs = createFileSystem();
     if (await exists(cachePath)) {
         cachedPaths.set(cacheKey, cachePath);
-        // Synchronously ensure code:{hash} exists in distributed cache for cross-pod recovery
-        // This backfills bundles created before code:{hash} storage was added
-        // Synchronous to guarantee data is stored before other pods need it
+        // Refresh distributed cache TTL so bundles outlive transforms that reference them.
+        // Without this, bundles expire (24h) while SSR transforms (6h) are still valid.
         const distributed = await getDistributedCache();
         if (distributed) {
             const hash = simpleHash(normalizedUrl);
-            try {
-                const hasCode = await distributed.get(`code:${hash}`);
-                if (!hasCode) {
+            const hashStr = String(hash);
+            const now = Date.now();
+            const lastRefresh = lastDistributedRefresh.get(hashStr);
+            const needsRefresh = !lastRefresh || (now - lastRefresh > DISTRIBUTED_REFRESH_INTERVAL_MS);
+            if (needsRefresh) {
+                try {
                     const code = await fs.readTextFile(cachePath);
-                    await distributed.set(`code:${hash}`, code, DISTRIBUTED_CACHE_TTL_SECONDS);
-                    logger.info("[HTTP-CACHE] Backfilled code:{hash} for existing bundle", { hash });
+                    await Promise.all([
+                        distributed.set(`code:${hash}`, code, HTTP_MODULE_DISTRIBUTED_TTL_SEC),
+                        distributed.set(`hash:${hash}`, normalizedUrl, HTTP_MODULE_DISTRIBUTED_TTL_SEC),
+                    ]);
+                    lastDistributedRefresh.set(hashStr, now);
+                    logger.debug("[HTTP-CACHE] Refreshed distributed cache TTL", { hash });
+                }
+                catch (error) {
+                    logger.debug("[HTTP-CACHE] Distributed cache refresh failed", { hash, error });
                 }
-            }
-            catch (error) {
-                // Log but don't fail - backfill is best-effort
-                logger.debug("[HTTP-CACHE] Backfill failed, continuing", { hash, error });
             }
         }
         return cachePath;
@@ -232,9 +234,9 @@ async function cacheHttpModule(url, options) {
         const hash = simpleHash(normalizedUrl);
         try {
             await Promise.all([
-                distributed.set(normalizedUrl, code, DISTRIBUTED_CACHE_TTL_SECONDS),
-                distributed.set(`code:${hash}`, code, DISTRIBUTED_CACHE_TTL_SECONDS),
-                distributed.set(`hash:${hash}`, normalizedUrl, DISTRIBUTED_CACHE_TTL_SECONDS),
+                distributed.set(normalizedUrl, code, HTTP_MODULE_DISTRIBUTED_TTL_SEC),
+                distributed.set(`code:${hash}`, code, HTTP_MODULE_DISTRIBUTED_TTL_SEC),
+                distributed.set(`hash:${hash}`, normalizedUrl, HTTP_MODULE_DISTRIBUTED_TTL_SEC),
             ]);
         }
         catch (error) {
@@ -264,6 +266,11 @@ async function resolveSpecifier(specifier, baseUrl, options) {
         if (!baseUrl || !isHttpUrl(baseUrl))
             return null;
         const resolved = new URL(specifier, baseUrl).toString();
+        // For React core URLs: return the full esm.sh URL (not cached, to prevent multiple instances)
+        // This transforms relative paths like "/react-dom?..." to "https://esm.sh/react-dom?..."
+        if (isReactCoreUrl(resolved)) {
+            return normalizeHttpUrl(resolved);
+        }
         const cached = await cacheHttpModule(resolved, options);
         return cached ? `file://${cached}` : null;
     }

package/esm/src/transforms/esm/import-rewriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/import-rewriter.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB1F;AAkDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB3F;AAWD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAgEjB"}
+{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/import-rewriter.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB1F;AAoDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB3F;AAWD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAgEjB"}

package/esm/src/transforms/esm/import-rewriter.js

@@ -40,9 +40,9 @@ function normalizeVersionedSpecifier(specifier) {
 }
 const REACT_IMPORT_MAP = {
     react: `https://esm.sh/react@${REACT_DEFAULT_VERSION}?target=es2022`,
-    "react-dom": `https://esm.sh/react-dom@${REACT_DEFAULT_VERSION}?target=es2022`,
-    "react-dom/client": `https://esm.sh/react-dom@${REACT_DEFAULT_VERSION}/client?target=es2022`,
-    "react-dom/server": `https://esm.sh/react-dom@${REACT_DEFAULT_VERSION}/server?target=es2022`,
+    "react-dom": `https://esm.sh/react-dom@${REACT_DEFAULT_VERSION}?external=react&target=es2022`,
+    "react-dom/client": `https://esm.sh/react-dom@${REACT_DEFAULT_VERSION}/client?external=react&target=es2022`,
+    "react-dom/server": `https://esm.sh/react-dom@${REACT_DEFAULT_VERSION}/server?external=react&target=es2022`,
     "react/jsx-runtime": `https://esm.sh/react@${REACT_DEFAULT_VERSION}/jsx-runtime?target=es2022`,
     "react/jsx-dev-runtime": `https://esm.sh/react@${REACT_DEFAULT_VERSION}/jsx-dev-runtime?target=es2022`,
 };

package/esm/src/transforms/esm/package-registry.d.ts

@@ -8,13 +8,20 @@
 export declare const DEFAULT_REACT_VERSION = "19.1.1";
 export declare const TAILWIND_VERSION = "4.1.8";
 /**
- * Set the React version from project configuration.
- * Call this during project initialization if a custom version is specified.
+ * Validate React version format (semver: X.Y.Z).
+ * Returns true if valid, false otherwise.
  */
-export declare function setReactVersion(version: string): void;
+export declare function isValidReactVersion(version: string): boolean;
 /**
- * Get the current React version.
- * Returns configured version if set, otherwise the default.
+ * Validate and normalize React version.
+ * Returns the version if valid, or DEFAULT_REACT_VERSION if invalid.
+ * Logs a warning if the version is invalid.
+ */
+export declare function normalizeReactVersion(version: string | undefined): string;
+/**
+ * @deprecated Global React version is no longer supported.
+ * Use config.react.version passed through TransformOptions instead.
+ * This function now always returns DEFAULT_REACT_VERSION.
  */
 export declare function getReactVersion(): string;
 /** @deprecated Use DEFAULT_REACT_VERSION or getReactVersion() */
@@ -66,14 +73,9 @@ export declare function getReactUrls(version?: string): Record<string, string>;
  */
 export declare function getReactImportMap(version?: string): Record<string, string>;
 /**
- * Get React npm specifiers for Deno SSR.
- * Uses npm: protocol which Deno handles natively with automatic deduplication.
- * See: https://deno.com/blog/not-using-npm-specifiers-doing-it-wrong
- *
- * Benefits over esm.sh:
- * - Automatic semantic version deduplication (like Node's node_modules)
- * - No manual external= flags or shared-*.ts wrapper files needed
- * - Native support in Deno 2+
+ * Get React esm.sh URLs for Deno SSR.
+ * Uses esm.sh for both SSR and browser to ensure identical React instances.
+ * All sub-packages use external=react to share the same React instance.
  *
  * @param version - React version to use (defaults to REACT_VERSION)
  */

package/esm/src/transforms/esm/package-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-registry.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/package-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAKxC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,WAAwB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAM1C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU3E"}
+{"version":3,"file":"package-registry.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/package-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,WAAwB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAa1C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU3E"}

package/esm/src/transforms/esm/package-registry.js

@@ -7,21 +7,33 @@
 /** Default React version - used when not specified in project config */
 export const DEFAULT_REACT_VERSION = "19.1.1";
 export const TAILWIND_VERSION = "4.1.8";
-/** Cached React version from project config */
-let configuredReactVersion = null;
 /**
- * Set the React version from project configuration.
- * Call this during project initialization if a custom version is specified.
+ * Validate React version format (semver: X.Y.Z).
+ * Returns true if valid, false otherwise.
  */
-export function setReactVersion(version) {
-    configuredReactVersion = version;
+export function isValidReactVersion(version) {
+    return /^\d+\.\d+\.\d+$/.test(version);
 }
 /**
- * Get the current React version.
- * Returns configured version if set, otherwise the default.
+ * Validate and normalize React version.
+ * Returns the version if valid, or DEFAULT_REACT_VERSION if invalid.
+ * Logs a warning if the version is invalid.
+ */
+export function normalizeReactVersion(version) {
+    if (!version)
+        return DEFAULT_REACT_VERSION;
+    if (isValidReactVersion(version))
+        return version;
+    console.warn(`[VERYFRONT] Invalid React version format "${version}" (expected X.Y.Z). Using default: ${DEFAULT_REACT_VERSION}`);
+    return DEFAULT_REACT_VERSION;
+}
+/**
+ * @deprecated Global React version is no longer supported.
+ * Use config.react.version passed through TransformOptions instead.
+ * This function now always returns DEFAULT_REACT_VERSION.
  */
 export function getReactVersion() {
-    return configuredReactVersion ?? DEFAULT_REACT_VERSION;
+    return DEFAULT_REACT_VERSION;
 }
 /** @deprecated Use DEFAULT_REACT_VERSION or getReactVersion() */
 export const REACT_VERSION = DEFAULT_REACT_VERSION;
@@ -43,8 +55,14 @@ export const REACT_VERSION = DEFAULT_REACT_VERSION;
  * v12: Store HTTP bundle code by hash for direct recovery (code:{hash})
  */
 export const TRANSFORM_CACHE_VERSION = 12;
-function esmSh(pkg, version, path = "", query = "target=es2022") {
-    return `https://esm.sh/${pkg}@${version}${path}?${query}`;
+/** csstype version - must match deno.json for type consistency */
+const CSSTYPE_VERSION = "3.2.3";
+/** Build esm.sh URL with deps=csstype for React packages (ensures type consistency) */
+function esmShReact(pkg, version, path = "", external = false) {
+    const params = external
+        ? [`external=react`, `target=es2022`, `deps=csstype@${CSSTYPE_VERSION}`]
+        : [`target=es2022`, `deps=csstype@${CSSTYPE_VERSION}`];
+    return `https://esm.sh/${pkg}@${version}${path}?${params.join("&")}`;
 }
 /**
  * Generate esm.sh URL for browser.
@@ -70,12 +88,12 @@ export function getEsmShUrl(pkg, version, external) {
 export function getReactUrls(version) {
     const v = version ?? getReactVersion();
     return {
-        react: esmSh("react", v),
-        "react-dom": esmSh("react-dom", v, "", "external=react&target=es2022"),
-        "react-dom/client": esmSh("react-dom", v, "/client", "external=react&target=es2022"),
-        "react-dom/server": esmSh("react-dom", v, "/server", "external=react&target=es2022"),
-        "react/jsx-runtime": esmSh("react", v, "/jsx-runtime", "external=react&target=es2022"),
-        "react/jsx-dev-runtime": esmSh("react", v, "/jsx-dev-runtime", "external=react&target=es2022"),
+        react: esmShReact("react", v),
+        "react-dom": esmShReact("react-dom", v, "", true),
+        "react-dom/client": esmShReact("react-dom", v, "/client", true),
+        "react-dom/server": esmShReact("react-dom", v, "/server", true),
+        "react/jsx-runtime": esmShReact("react", v, "/jsx-runtime", true),
+        "react/jsx-dev-runtime": esmShReact("react", v, "/jsx-dev-runtime", true),
     };
 }
 /**
@@ -93,29 +111,24 @@ export function getReactImportMap(version) {
     return {
         ...getReactUrls(v),
         // Prefix match for any react/* subpath imports
-        "react/": esmSh("react", v, "/", "external=react&target=es2022"),
+        "react/": esmShReact("react", v, "/", true),
     };
 }
 /**
- * Get React npm specifiers for Deno SSR.
- * Uses npm: protocol which Deno handles natively with automatic deduplication.
- * See: https://deno.com/blog/not-using-npm-specifiers-doing-it-wrong
- *
- * Benefits over esm.sh:
- * - Automatic semantic version deduplication (like Node's node_modules)
- * - No manual external= flags or shared-*.ts wrapper files needed
- * - Native support in Deno 2+
+ * Get React esm.sh URLs for Deno SSR.
+ * Uses esm.sh for both SSR and browser to ensure identical React instances.
+ * All sub-packages use external=react to share the same React instance.
  *
  * @param version - React version to use (defaults to REACT_VERSION)
  */
 export function getDenoNpmReactMap(version) {
     const v = version ?? getReactVersion();
     return {
-        "react": `npm:react@${v}`,
-        "react-dom": `npm:react-dom@${v}`,
-        "react-dom/client": `npm:react-dom@${v}/client`,
-        "react-dom/server": `npm:react-dom@${v}/server`,
-        "react/jsx-runtime": `npm:react@${v}/jsx-runtime`,
-        "react/jsx-dev-runtime": `npm:react@${v}/jsx-dev-runtime`,
+        "react": esmShReact("react", v),
+        "react-dom": esmShReact("react-dom", v, "", true),
+        "react-dom/client": esmShReact("react-dom", v, "/client", true),
+        "react-dom/server": esmShReact("react-dom", v, "/server", true),
+        "react/jsx-runtime": esmShReact("react", v, "/jsx-runtime", true),
+        "react/jsx-dev-runtime": esmShReact("react", v, "/jsx-dev-runtime", true),
     };
 }

package/esm/src/transforms/esm/react-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-imports.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/react-imports.ts"],"names":[],"mappings":"AAmBA,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAe,EACvB,YAAY,GAAE,MAAsB,GACnC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAe,EACxB,YAAY,GAAE,MAAsB,GACnC,OAAO,CAAC,MAAM,CAAC,CASjB"}
+{"version":3,"file":"react-imports.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/react-imports.ts"],"names":[],"mappings":"AAiBA,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAe,EACvB,YAAY,GAAE,MAAsB,GACnC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAe,EACxB,YAAY,GAAE,MAAsB,GACnC,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/esm/src/transforms/esm/react-imports.js

@@ -1,7 +1,5 @@
 import { replaceSpecifiers } from "./lexer.js";
-import { getDenoNpmReactMap, getReactImportMap, REACT_VERSION } from "./package-registry.js";
-import { isDeno } from "../../platform/compat/runtime.js";
-import { getLocalReactPaths } from "../../platform/compat/react-paths.js";
+import { getReactImportMap, REACT_VERSION } from "./package-registry.js";
 const srcDir = new URL(".", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url).pathname.replace(/\/(build|src)\/transforms\/esm\/?$/, "");
 function getVeryfrontModulePaths() {
     return {
@@ -16,12 +14,10 @@ export async function resolveReactImports(code, forSSR = false, reactVersion = R
     if (!forSSR) {
         return replaceSpecifiers(code, (specifier) => reactImports[specifier] ?? null);
     }
-    // For Deno SSR: Use npm: specifiers (auto-deduplicated by Deno's npm cache)
-    // For Node/Bun SSR: Use local node_modules paths (auto-deduplicated by Node)
-    // See: https://deno.com/blog/not-using-npm-specifiers-doing-it-wrong
+    // For SSR: Use esm.sh URLs consistently (NO npm: specifiers per plan requirements)
     const ssrImports = {
         ...getVeryfrontModulePaths(),
-        ...(isDeno ? getDenoNpmReactMap(reactVersion) : getLocalReactPaths()),
+        ...reactImports,
     };
     return replaceSpecifiers(code, (specifier) => ssrImports[specifier] ?? null);
 }

package/esm/src/transforms/esm/types.d.ts

@@ -8,6 +8,8 @@ export interface TransformOptions {
     ssr?: boolean;
     apiBaseUrl?: string;
     studioEmbed?: boolean;
+    /** React version for transforms (from project config, defaults to DEFAULT_REACT_VERSION) */
+    reactVersion?: string;
 }
 export interface TransformContext {
     source: string;

package/esm/src/transforms/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;CAC3B"}

package/esm/src/transforms/mdx/esm-module-loader/cache/index.d.ts

@@ -35,4 +35,18 @@ export declare function invalidateModulePaths(changedPaths: string[]): void;
  * Called when files are updated via Studio to ensure fresh content is served.
  */
 export declare function clearESMDiskCache(): Promise<void>;
+/**
+ * Look up a module in the MDX-ESM cache.
+ *
+ * This allows other loaders (like SSR loader) to reuse modules that
+ * MDX-ESM has already transformed and cached, preventing duplicate
+ * module instances (which breaks React context, etc.).
+ *
+ * @param filePath - Project-relative file path like "lib/ChatContext.tsx"
+ * @param cacheDir - The MDX-ESM cache directory for this project/contentSource
+ * @param projectDir - Project directory to strip from absolute paths
+ * @param contentHash - Optional content hash to validate cached file freshness
+ * @returns The cached file path if found and valid, null otherwise
+ */
+export declare function lookupMdxEsmCache(filePath: string, cacheDir: string, projectDir?: string, contentHash?: string): Promise<string | null>;
 //# sourceMappingURL=index.d.ts.map

package/esm/src/transforms/mdx/esm-module-loader/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,mCAAmC,CAAC;AAO3C;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAGvC;AAOD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAgClE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,mCAAmC,CAAC;AAQ3C;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAGvC;AAOD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAgClE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwCxB"}