veryfront 0.1.545 → 0.1.546

package/src/src/transforms/pipeline/stages/ssr-css-strip.ts

@@ -1,201 +0,0 @@
-/**
- * CSS Strip Stage - removes CSS import statements from compiled code.
- *
- * CSS files are not valid JS modules and will crash both the SSR module
- * loader and browser module system if left in compiled code. This plugin
- * strips them and records the CSS specifiers in pipeline metadata for
- * downstream collection (used by the SSR rendering pipeline to include
- * the CSS content in the HTML output).
- *
- * For CSS Module imports (`import styles from "./X.module.css"`), the
- * import is replaced with a Proxy stub that returns the property name
- * as the class name. This matches the Next.js convention where
- * `styles.container` → `"container"` (identity mapping), which works
- * correctly with Tailwind CSS class-based styling.
- */
-
-import type { TransformPlugin } from "../types.js";
-import { TransformStage } from "../types.js";
-import { parseImports, rewriteImports } from "../../esm/lexer.js";
-import {
-  getCssModuleScope,
-  resolveCssModuleKey,
-  toScopedCssModuleClass,
-} from "../../css-modules/naming.js";
-
-function isCSSImport(specifier: string | undefined): boolean {
-  return specifier?.endsWith(".css") || false;
-}
-
-function isCssModuleImport(specifier: string | undefined): boolean {
-  return specifier?.endsWith(".module.css") || false;
-}
-
-function cssModuleProxyExpression(): string {
-  return "new Proxy({}, { get: (_, p) => String(p) })";
-}
-
-function scopedCssModuleProxyExpression(moduleKey: string): string {
-  const scope = getCssModuleScope(moduleKey);
-  return `new Proxy({}, { get: (_, p) => typeof p === "string" ? "${scope.base}_" + String(p).replace(/[^\\w-]/g, "_") + "__${scope.hash}" : "" })`;
-}
-
-type NamedImportBinding = { imported: string; local: string };
-
-function parseNamedImportBindings(namedClause: string): NamedImportBinding[] {
-  const bindings: NamedImportBinding[] = [];
-
-  for (const rawPart of namedClause.split(",")) {
-    const part = rawPart.trim();
-    if (!part) continue;
-
-    const aliasMatch = part.match(/^([_$a-zA-Z][\w$-]*)\s+as\s+([_$a-zA-Z][\w$]*)$/);
-    if (aliasMatch) {
-      const imported = aliasMatch[1];
-      const local = aliasMatch[2];
-      if (!imported || !local) continue;
-      bindings.push({ imported, local });
-      continue;
-    }
-
-    if (/^[_$a-zA-Z][\w$]*$/.test(part)) {
-      bindings.push({ imported: part, local: part });
-    }
-  }
-
-  return bindings;
-}
-
-/**
- * Generate a replacement for a static CSS import statement.
- *
- * - Side-effect import: `import "./globals.css"` → comment
- * - Default import: `import styles from "./X.module.css"` → Proxy stub
- * - Named imports: `import { a } from "./X.css"` → null stubs
- */
-function generateCSSStub(statement: string, specifier: string): string {
-  const trimmed = statement.trim();
-
-  // Re-export from CSS: export { default as styles } from './module.css'
-  // → strip entirely, the CSS is collected separately
-  if (/^export\s/.test(trimmed)) {
-    return `/* css re-export stripped: ${specifier} */`;
-  }
-
-  // Side-effect import: import "./globals.css"
-  if (/^import\s+['"`]/.test(trimmed)) {
-    return `/* css import: ${specifier} */`;
-  }
-
-  const fromIndex = trimmed.lastIndexOf(" from ");
-  if (fromIndex === -1) {
-    return `/* css import: ${specifier} */`;
-  }
-
-  const cssModuleKey = isCssModuleImport(specifier) ? specifier : undefined;
-  const importClause = trimmed.slice(6, fromIndex).trim(); // Skip "import "
-
-  // Default import: import styles from "./Button.module.css"
-  // → const styles = new Proxy({}, { get: (_, p) => String(p) })
-  // This makes styles.container return "container" (identity mapping)
-  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(importClause)) {
-    const expr = cssModuleKey
-      ? scopedCssModuleProxyExpression(cssModuleKey)
-      : cssModuleProxyExpression();
-    return `const ${importClause} = ${expr}; /* css module: ${specifier} */`;
-  }
-
-  // Namespace import: import * as styles from "./X.module.css"
-  const nsMatch = importClause.match(/^\*\s+as\s+([a-zA-Z_$][a-zA-Z0-9_$]*)$/);
-  if (nsMatch) {
-    const expr = cssModuleKey
-      ? scopedCssModuleProxyExpression(cssModuleKey)
-      : cssModuleProxyExpression();
-    return `const ${nsMatch[1]} = ${expr}; /* css module: ${specifier} */`;
-  }
-
-  // Named imports: import { container, header } from "./X.module.css"
-  const namedMatch = importClause.match(/^\{([^}]+)\}$/);
-  if (namedMatch?.[1]) {
-    const bindings = parseNamedImportBindings(namedMatch[1]);
-    if (bindings.length > 0) {
-      const stubs = bindings
-        .map((binding) => {
-          const value = cssModuleKey
-            ? toScopedCssModuleClass(cssModuleKey, binding.imported)
-            : binding.imported;
-          return `${binding.local} = "${value}"`;
-        })
-        .join(", ");
-      return `const ${stubs}; /* css module: ${specifier} */`;
-    }
-  }
-
-  // Mixed: import styles, { container } from "./X.module.css"
-  const mixedMatch = importClause.match(/^([a-zA-Z_$][a-zA-Z0-9_$]*)\s*,\s*\{([^}]+)\}$/);
-  if (mixedMatch?.[1] && mixedMatch[2]) {
-    const defaultName = mixedMatch[1];
-    const bindings = parseNamedImportBindings(mixedMatch[2]);
-    const namedStubs = bindings
-      .map((binding) => {
-        const value = cssModuleKey
-          ? toScopedCssModuleClass(cssModuleKey, binding.imported)
-          : binding.imported;
-        return `${binding.local} = "${value}"`;
-      })
-      .join(", ");
-    const defaultExpr = cssModuleKey
-      ? scopedCssModuleProxyExpression(cssModuleKey)
-      : cssModuleProxyExpression();
-    return namedStubs.length > 0
-      ? `const ${defaultName} = ${defaultExpr}, ${namedStubs}; /* css module: ${specifier} */`
-      : `const ${defaultName} = ${defaultExpr}; /* css module: ${specifier} */`;
-  }
-
-  return `/* css import: ${specifier} */`;
-}
-
-/**
- * Generate a replacement for dynamic CSS imports.
- * Keeps syntax valid in expression position (e.g. await import("./x.css")).
- */
-function generateDynamicCSSStub(specifier: string): string {
-  if (isCssModuleImport(specifier)) {
-    return `Promise.resolve({ default: ${
-      scopedCssModuleProxyExpression(specifier)
-    } }) /* css import: ${specifier} */`;
-  }
-
-  return `Promise.resolve({}) /* css import: ${specifier} */`;
-}
-
-export const cssStripPlugin: TransformPlugin = {
-  name: "css-strip",
-  stage: TransformStage.COMPILE + 0.5, // Run after esbuild compile, before import resolution
-
-  async transform(ctx) {
-    const imports = await parseImports(ctx.code);
-
-    const hasCssImports = imports.some((imp) => isCSSImport(imp.n));
-    if (!hasCssImports) return ctx.code;
-
-    const cssSpecifiers: string[] = [];
-
-    const result = await rewriteImports(ctx.code, (imp, statement) => {
-      if (!isCSSImport(imp.n)) return null;
-      cssSpecifiers.push(imp.n!);
-      const moduleKey = isCssModuleImport(imp.n)
-        ? resolveCssModuleKey(imp.n!, ctx.filePath, ctx.projectDir)
-        : undefined;
-      const specifierForStub = moduleKey ?? imp.n!;
-      if (imp.d > -1) return generateDynamicCSSStub(specifierForStub);
-      return generateCSSStub(statement, specifierForStub);
-    });
-
-    if (cssSpecifiers.length > 0) {
-      ctx.metadata.set("cssImports", cssSpecifiers);
-    }
-
-    return result;
-  },
-};

package/src/src/transforms/pipeline/stages/ssr-http-cache.ts

@@ -1,49 +0,0 @@
-/**
- * SSR HTTP Cache Stage - caches HTTP imports to local file:// paths.
- *
- * Deno supports HTTP imports, but Node.js and Bun don't.
- * This stage normalizes all SSR dependencies by downloading HTTP modules
- * (esm.sh, npm:, etc.) into a shared cache and rewriting imports to file://.
- * This keeps SSR runtime-agnostic and avoids loader hooks.
- */
-
-import type { TransformPlugin } from "../types.js";
-import { TransformStage } from "../types.js";
-import { cacheHttpImportsToLocal } from "../../esm/http-cache.js";
-import { getHttpBundleCacheDir } from "../../../utils/cache-dir.js";
-import { loadImportMap } from "../../../modules/import-map/index.js";
-import type { ImportMapConfig } from "../../../modules/import-map/index.js";
-import { rendererLogger as logger } from "../../../utils/index.js";
-
-const LOG_PREFIX = "[SSR-HTTP-CACHE]";
-
-export const ssrHttpCachePlugin: TransformPlugin = {
-  name: "ssr-http-cache",
-  stage: TransformStage.FINALIZE - 1, // Run just before finalize
-
-  async transform(ctx) {
-    const cachedMap = ctx.metadata.get("importMap") as ImportMapConfig | undefined;
-    const importMap = cachedMap ?? (await loadImportMap(ctx.projectDir));
-
-    if (!cachedMap) {
-      ctx.metadata.set("importMap", importMap);
-    }
-
-    const { code, bundleManifestId } = await cacheHttpImportsToLocal(ctx.code, {
-      cacheDir: getHttpBundleCacheDir(),
-      importMap,
-      reactVersion: ctx.reactVersion,
-    });
-
-    if (code !== ctx.code) {
-      logger.debug(`${LOG_PREFIX} Cached HTTP imports for ${ctx.filePath.slice(-40)}`);
-    }
-
-    // Store bundle manifest ID in context metadata for downstream consumers
-    if (bundleManifestId) {
-      ctx.metadata.set("bundleManifestId", bundleManifestId);
-    }
-
-    return code;
-  },
-};

package/src/src/transforms/pipeline/stages/ssr-http-stub.ts

@@ -1,96 +0,0 @@
-/**
- * SSR HTTP Stub Stage - replaces browser-only HTTP imports with stubs during SSR.
- * Modules like video.js access browser globals at import time and fail in SSR.
- */
-
-import type { TransformPlugin } from "../types.js";
-import { TransformStage } from "../types.js";
-import { parseImports, rewriteImports } from "../../esm/lexer.js";
-
-/** Known browser-only packages that need SSR stubbing */
-const BROWSER_ONLY_PATTERNS = [
-  "video.js",
-  "video-js",
-  "videojs",
-  "gsap",
-  "three",
-  "mapbox",
-  "leaflet",
-];
-
-function isHttpImport(specifier: string | undefined): boolean {
-  return specifier?.startsWith("http://") || specifier?.startsWith("https://") || false;
-}
-
-function isBrowserOnlyModule(specifier: string): boolean {
-  return BROWSER_ONLY_PATTERNS.some((pattern) => specifier.includes(pattern));
-}
-
-function extractImportNames(list: string): string[] {
-  return list
-    .split(",")
-    .map((n) => n.trim().split(/\s+as\s+/).at(-1)?.trim() ?? "")
-    .filter(Boolean);
-}
-
-/** Generate a stub for a given import statement */
-function generateStub(
-  imp: { n: string | undefined; ss: number; se: number; d: number },
-  statement: string,
-): string | null {
-  if (!imp.n || imp.d > -1 || !isHttpImport(imp.n) || !isBrowserOnlyModule(imp.n)) return null;
-
-  const trimmed = statement.trim();
-
-  // Side-effect import: import 'url' -> /* SSR stub: import 'url' */
-  if (/^import\s+['"`]/.test(trimmed)) return `/* SSR stub: ${trimmed} */`;
-
-  const fromIndex = trimmed.lastIndexOf(" from ");
-  if (fromIndex === -1) return null;
-
-  const importClause = trimmed.slice(6, fromIndex).trim(); // Skip 'import '
-
-  // Default import: import X from 'url' -> const X = null
-  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(importClause)) {
-    return `const ${importClause} = null; /* SSR stub for ${imp.n} */`;
-  }
-
-  // Namespace import: import * as X from 'url' -> const X = {}
-  const namespaceMatch = importClause.match(/^\*\s+as\s+([a-zA-Z_$][a-zA-Z0-9_$]*)$/);
-  if (namespaceMatch) return `const ${namespaceMatch[1]} = {}; /* SSR stub for ${imp.n} */`;
-
-  // Named imports: import { X, Y as Z } from 'url' -> const X = null, Z = null
-  const namedMatch = importClause.match(/^\{([^}]+)\}$/);
-  if (namedMatch?.[1]) {
-    const names = extractImportNames(namedMatch[1]);
-    if (!names.length) return null;
-    return `const ${names.map((n) => `${n} = null`).join(", ")}; /* SSR stub for ${imp.n} */`;
-  }
-
-  // Mixed import: import X, { Y } from 'url'
-  const mixedMatch = importClause.match(/^([a-zA-Z_$][a-zA-Z0-9_$]*)\s*,\s*\{([^}]+)\}$/);
-  if (mixedMatch?.[1] && mixedMatch[2]) {
-    const names = [mixedMatch[1], ...extractImportNames(mixedMatch[2])];
-    if (!names.length) return null;
-    return `const ${names.map((n) => `${n} = null`).join(", ")}; /* SSR stub for ${imp.n} */`;
-  }
-
-  return null;
-}
-
-export const ssrHttpStubPlugin: TransformPlugin = {
-  name: "ssr-http-stub",
-  stage: TransformStage.RESOLVE_CONTEXT + 1, // Run just after resolve-context, before resolve-relative
-
-  async transform(ctx) {
-    const imports = await parseImports(ctx.code);
-
-    const needsStubbing = imports.some((imp) => {
-      if (!imp.n || imp.d !== -1) return false;
-      return isHttpImport(imp.n) && isBrowserOnlyModule(imp.n);
-    });
-    if (!needsStubbing) return ctx.code;
-
-    return rewriteImports(ctx.code, (imp, statement) => generateStub(imp, statement));
-  },
-};

package/src/src/transforms/pipeline/stages/ssr-vf-modules/constants.ts

@@ -1,62 +0,0 @@
-/**
- * Shared constants, types, and caches for the SSR VF Modules stage.
- */
-
-import { join } from "../../../../platform/compat/path/index.js";
-import { createFileSystem } from "../../../../platform/compat/fs.js";
-import { getFrameworkRootFromMeta } from "../../../../platform/compat/vfs-paths.js";
-import { Singleflight } from "../../../../utils/singleflight.js";
-
-export const LOG_PREFIX = "[SSR-VF-MODULES]";
-
-// Extensions to try when resolving framework files
-export const EXTENSIONS = [".tsx", ".ts", ".jsx", ".js"];
-
-// Get framework root - this works in both Deno source and compiled binaries
-const RUNTIME_FRAMEWORK_ROOT = getFrameworkRootFromMeta(import.meta.url);
-
-// Always use the runtime-detected framework root.
-// In compiled binaries, embedded files are extracted to the runtime directory,
-// NOT accessible at compile-time paths. The extraction structure mirrors the
-// original directory layout, so dist/framework-src is at {extraction_root}/dist/framework-src.
-export const FRAMEWORK_ROOT = RUNTIME_FRAMEWORK_ROOT;
-
-// Directory containing embedded framework sources for compiled binaries.
-// These are .src files created by scripts/prepare-framework-sources.ts.
-// In compiled binaries, files are extracted to the runtime directory.
-export const EMBEDDED_SRC_DIR = join(RUNTIME_FRAMEWORK_ROOT, "dist", "framework-src");
-
-// Map of _vf_modules prefixes to framework directories.
-// Prefer regular src/ when present so source checkouts never serve stale
-// dist/framework-src copies; compiled binaries fall back to embedded .src files.
-export const FRAMEWORK_LOOKUPS: Array<[prefix: string, frameworkDir: string]> = [
-  // Regular sources for dev mode
-  ["_veryfront/", join(FRAMEWORK_ROOT, "src")],
-  // Embedded sources for compiled binaries (these are .src files)
-  ["_veryfront/", EMBEDDED_SRC_DIR],
-];
-
-// Singleflight for framework module file writes to prevent race conditions
-export const frameworkWriteFlight = new Singleflight<string>();
-
-// Singleflight for top-level framework source transforms so concurrent user
-// modules importing the same veryfront/* module do not receive cycle placeholders.
-export const frameworkTransformFlight = new Singleflight<string>();
-
-// Cache for already-transformed #veryfront/ dependencies to avoid cycles and redundant work
-export const veryfrontTransformCache = new Map<string, string>();
-
-// Cache for transformed framework files by absolute path to prevent cycles and redundant work
-export const frameworkFileCache = new Map<string, string>();
-
-// Track files currently being transformed to detect cycles
-export const transformingFiles = new Set<string>();
-
-// Maximum recursion depth for relative imports
-export const MAX_RELATIVE_IMPORT_DEPTH = 10;
-
-export interface TransformContext {
-  reactVersion: string;
-  projectDir: string;
-  fs: ReturnType<typeof createFileSystem>;
-}

package/src/src/transforms/pipeline/stages/ssr-vf-modules/import-finder.ts

@@ -1,46 +0,0 @@
-/**
- * Import discovery functions for the SSR VF Modules stage.
- */
-
-/**
- * Find all /_vf_modules/_veryfront/ imports in the code.
- * Only matches framework modules, not user project files.
- */
-export function findVfModuleImports(code: string): string[] {
-  const imports: string[] = [];
-  // Note: \s* allows zero whitespace (minified code: from"..." has no space)
-  // Only match _veryfront/ framework modules, not user project files.
-  // Handle both raw "/_vf_modules/..." specifiers and malformed
-  // "file:///_vf_modules/..." variants that can leak out of stale caches.
-  const pattern = /from\s*["']((?:file:\/\/)?\/_vf_modules\/_veryfront\/[^"']+)["']/g;
-
-  let match: RegExpExecArray | null;
-  while ((match = pattern.exec(code)) !== null) {
-    imports.push(match[1]!);
-  }
-
-  return [...new Set(imports)];
-}
-
-/**
- * Find all relative imports (./foo, ../bar) in the code.
- * Returns array of specifiers.
- */
-export function findRelativeImports(code: string): string[] {
-  const imports: string[] = [];
-
-  // Match: from "./foo" or from "../bar"
-  const fromPattern = /from\s*["'](\.\.?\/[^"']+)["']/g;
-  // Match side-effect imports: import "./foo" or import "../bar" (no `from`)
-  const sideEffectPattern = /import\s*["'](\.\.?\/[^"']+)["']/g;
-
-  let match: RegExpExecArray | null;
-  while ((match = fromPattern.exec(code)) !== null) {
-    imports.push(match[1]!);
-  }
-  while ((match = sideEffectPattern.exec(code)) !== null) {
-    imports.push(match[1]!);
-  }
-
-  return [...new Set(imports)];
-}

package/src/src/transforms/pipeline/stages/ssr-vf-modules/index.ts

@@ -1,174 +0,0 @@
-/**
- * SSR VF Modules Stage - resolves /_vf_modules/_veryfront/ paths to framework source.
- *
- * The SSR import map rewrites "veryfront/head" -> "/_vf_modules/_veryfront/react/runtime/core.js?ssr=true"
- * This stage resolves those paths to actual framework source files, transforms them
- * (including React import rewriting), and rewrites imports to file:// paths.
- *
- * This ensures framework components use the same cached React bundles as user code,
- * preventing the "dual React instances" error that causes hooks to fail.
- */
-
-import type { TransformPlugin } from "../../types.js";
-import { TransformStage } from "../../types.js";
-import { rendererLogger as logger } from "../../../../utils/index.js";
-import { replaceSpecifiers } from "../../../esm/lexer.js";
-import { createFileSystem } from "../../../../platform/compat/fs.js";
-import { REACT_DEFAULT_VERSION } from "../../../../utils/constants/cdn.js";
-import { findRelativeImports, findVfModuleImports } from "./import-finder.js";
-import {
-  resolveFrameworkFile,
-  resolveRelativeFrameworkImport,
-  resolveVeryfrontSourcePath,
-} from "./path-resolver.js";
-import {
-  cacheTransformedCode,
-  isCyclePlaceholder,
-  resolveAndTransformVeryfrontImport,
-  transformFrameworkSource,
-} from "./transform.js";
-import {
-  EMBEDDED_SRC_DIR,
-  EXTENSIONS,
-  FRAMEWORK_LOOKUPS,
-  FRAMEWORK_ROOT,
-  frameworkTransformFlight,
-  LOG_PREFIX,
-} from "./constants.js";
-
-// Re-export submodules for external consumers
-export { findRelativeImports, findVfModuleImports } from "./import-finder.js";
-export {
-  resolveFrameworkFile,
-  resolveRelativeFrameworkImport,
-  resolveVeryfrontSourcePath,
-  tryReadWithExtensions,
-} from "./path-resolver.js";
-export {
-  cacheTransformedCode,
-  isCyclePlaceholder,
-  resolveAndTransformVeryfrontImport,
-  transformFrameworkCode,
-  transformFrameworkSource,
-} from "./transform.js";
-export {
-  EMBEDDED_SRC_DIR,
-  EXTENSIONS,
-  FRAMEWORK_LOOKUPS,
-  FRAMEWORK_ROOT,
-  frameworkFileCache,
-  frameworkTransformFlight,
-  frameworkWriteFlight,
-  LOG_PREFIX,
-  MAX_RELATIVE_IMPORT_DEPTH,
-  type TransformContext,
-  transformingFiles,
-  veryfrontTransformCache,
-} from "./constants.js";
-
-// Log initialization paths once for debugging
-let _initLogged = false;
-function logInitOnce(): void {
-  if (_initLogged) return;
-  _initLogged = true;
-  logger.debug(`${LOG_PREFIX} Initialized`, {
-    importMetaUrl: import.meta.url,
-    frameworkRoot: FRAMEWORK_ROOT,
-    embeddedSrcDir: EMBEDDED_SRC_DIR,
-  });
-}
-
-// Export internal functions for testing
-export const _testExports = {
-  findVfModuleImports,
-  findRelativeImports,
-  resolveFrameworkFile,
-  resolveRelativeFrameworkImport,
-  resolveVeryfrontSourcePath,
-  resolveAndTransformVeryfrontImport,
-  FRAMEWORK_ROOT,
-  EMBEDDED_SRC_DIR,
-  EXTENSIONS,
-};
-
-export const ssrVfModulesPlugin: TransformPlugin = {
-  name: "ssr-vf-modules",
-  stage: TransformStage.RESOLVE_ALIASES + 0.5, // Run right after import resolution
-  condition: (ctx) => ctx.target === "ssr",
-
-  async transform(ctx) {
-    logInitOnce();
-
-    const vfModuleImports = findVfModuleImports(ctx.code);
-    logger.debug(`${LOG_PREFIX} Transform called`, {
-      file: ctx.filePath?.slice(-60) ?? "<unknown>",
-      count: vfModuleImports.length,
-      imports: vfModuleImports.slice(0, 5),
-    });
-
-    if (vfModuleImports.length === 0) return ctx.code;
-
-    logger.debug(`${LOG_PREFIX} Found ${vfModuleImports.length} /_vf_modules/ imports`, {
-      file: ctx.filePath?.slice(-60) ?? "<unknown>",
-      imports: vfModuleImports,
-      frameworkRoot: FRAMEWORK_ROOT,
-    });
-
-    const fs = createFileSystem();
-    const replacements = new Map<string, string>();
-
-    for (const vfModulePath of vfModuleImports) {
-      try {
-        logger.debug(`${LOG_PREFIX} Resolving framework file`, {
-          vfModulePath,
-          frameworkRoot: FRAMEWORK_ROOT,
-          embeddedSrcDir: EMBEDDED_SRC_DIR,
-        });
-
-        const resolved = await resolveFrameworkFile(vfModulePath, fs);
-        if (!resolved) {
-          logger.warn(`${LOG_PREFIX} Could not resolve ${vfModulePath}`, {
-            frameworkRoot: FRAMEWORK_ROOT,
-            lookups: FRAMEWORK_LOOKUPS.map(([prefix, dir]) => ({ prefix, dir })),
-          });
-          continue;
-        }
-
-        logger.debug(`${LOG_PREFIX} Resolved framework file`, {
-          vfModulePath,
-          sourcePath: resolved.sourcePath,
-          contentLength: resolved.content.length,
-        });
-
-        const cachePath = await frameworkTransformFlight.do(resolved.sourcePath, async () => {
-          const transformed = await transformFrameworkSource(
-            resolved.content,
-            resolved.sourcePath,
-            ctx.reactVersion ?? REACT_DEFAULT_VERSION,
-            ctx.projectDir,
-            fs,
-          );
-
-          // Skip cycle placeholders - don't cache or use them
-          if (isCyclePlaceholder(transformed)) {
-            throw new Error(`Cycle detected while transforming ${vfModulePath}`);
-          }
-
-          return await cacheTransformedCode(transformed, vfModulePath, fs);
-        });
-        replacements.set(vfModulePath, `file://${cachePath}`);
-
-        logger.debug(`${LOG_PREFIX} Transformed ${vfModulePath} -> file://${cachePath}`);
-      } catch (error) {
-        logger.error(`${LOG_PREFIX} Failed to transform ${vfModulePath}`, {
-          error: error instanceof Error ? error.message : String(error),
-          stack: error instanceof Error ? error.stack : undefined,
-        });
-      }
-    }
-
-    if (replacements.size === 0) return ctx.code;
-
-    return replaceSpecifiers(ctx.code, (specifier) => replacements.get(specifier) ?? null);
-  },
-};