veryfront 0.1.47 → 0.1.49

package/src/src/react/components/ai/theme.ts

@@ -1,13 +1,127 @@
 /**
  * Theme System for Styled Components
  *
- * Provides default theme and utilities for customization.
+ * Uses CSS custom properties that align with the Veryfront Studio design system.
+ * When embedded in a host that defines --background, --foreground, etc., the chat
+ * UI automatically inherits those tokens. When standalone, sensible defaults are
+ * injected via <style> on the chat root element.
  */
 
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export { cva, type VariantProps } from "class-variance-authority";
+
+// ---------------------------------------------------------------------------
+// CSS Custom Property tokens
+// ---------------------------------------------------------------------------
+
+/**
+ * Light-mode defaults that match the Veryfront Studio `:root` values.
+ * Uses OKLch for perceptual uniformity.
+ */
+export const TOKENS_LIGHT = {
+  "--background": "oklch(0.9512 0.008 98.88)",
+  "--foreground": "oklch(0.2768 0 0)",
+  "--card": "oklch(1 0 0)",
+  "--card-foreground": "oklch(0.2768 0 0)",
+  "--popover": "oklch(1 0 0)",
+  "--popover-foreground": "oklch(0.2768 0 0)",
+  "--primary": "oklch(0.2768 0 0)",
+  "--primary-foreground": "oklch(1 0 0)",
+  "--muted": "oklch(0.9422 0.0081 98.88)",
+  "--muted-foreground": "oklch(0.55 0.005 95.11)",
+  "--accent": "oklch(0.93 0 0)",
+  "--accent-foreground": "oklch(0.15 0 0)",
+  "--destructive": "oklch(0.55 0.22 27)",
+  "--destructive-foreground": "oklch(1 0 0)",
+  "--border": "oklch(0.84 0.0055 95.11)",
+  "--input": "oklch(1 0 0)",
+  "--input-border": "oklch(0.88 0 0)",
+  "--input-placeholder": "oklch(0.7025 0 0)",
+  "--ring": "oklch(0.2768 0 0 / 0.3)",
+  "--success": "oklch(0.52 0.15 145)",
+  "--chat-bubble": "oklch(0.2768 0 0)",
+  "--chat-bubble-foreground": "oklch(1 0 0)",
+  "--tab-background": "oklch(1 0 0)",
+  "--tab-foreground": "oklch(0.7025 0 0)",
+  "--tab-active-background": "oklch(0.9422 0.0081 98.88)",
+  "--tab-active-foreground": "oklch(0.2768 0 0)",
+  "--sidebar-background": "oklch(0.9512 0.008 98.88)",
+  "--sidebar-foreground": "oklch(0.07 0 0)",
+  "--sidebar-border": "oklch(0.9 0.006 98.88)",
+} as const;
+
+/**
+ * Dark-mode defaults that match the Studio `[data-theme="dark"]` values.
+ */
+export const TOKENS_DARK = {
+  "--background": "oklch(0.2768 0 0)",
+  "--foreground": "oklch(0.9512 0.008 98.88)",
+  "--card": "oklch(0.3211 0 0)",
+  "--card-foreground": "oklch(0.9512 0.008 98.88)",
+  "--popover": "oklch(0.21 0.01 220)",
+  "--popover-foreground": "oklch(0.9512 0.008 98.88)",
+  "--primary": "oklch(0.9512 0.008 98.88)",
+  "--primary-foreground": "oklch(0.2768 0 0)",
+  "--muted": "oklch(0.5338 0.0046 106.55)",
+  "--muted-foreground": "oklch(0.9512 0.008 98.88)",
+  "--accent": "oklch(0.25 0.01 220)",
+  "--accent-foreground": "oklch(1 0 0)",
+  "--destructive": "oklch(0.55 0.22 27)",
+  "--destructive-foreground": "oklch(1 0 0)",
+  "--border": "oklch(0.42 0.0017 106.48)",
+  "--input": "oklch(0.3211 0 0)",
+  "--input-border": "oklch(0.38 0.01 220)",
+  "--input-placeholder": "oklch(0.8975 0 0)",
+  "--ring": "oklch(0.6 0.01 220 / 0.5)",
+  "--success": "oklch(0.52 0.14 143)",
+  "--chat-bubble": "oklch(0.9512 0.008 98.88)",
+  "--chat-bubble-foreground": "oklch(0.2768 0 0)",
+  "--tab-background": "oklch(0.3211 0 0)",
+  "--tab-foreground": "oklch(0.8975 0 0)",
+  "--tab-active-background": "oklch(0.5338 0.0046 106.55)",
+  "--tab-active-foreground": "oklch(0.9512 0.008 98.88)",
+  "--sidebar-background": "oklch(0.18 0.01 220)",
+  "--sidebar-foreground": "oklch(0.9512 0.008 98.88)",
+  "--sidebar-border": "oklch(0.3 0.01 220)",
+} as const;
+
+function tokensToCSS(tokens: Record<string, string>): string {
+  return Object.entries(tokens).map(([k, v]) => `${k}:${v}`).join(";");
+}
+
+/**
+ * Generates scoped CSS for the chat UI design tokens.
+ * Uses [data-vf-chat] as scope so tokens don't leak to the page.
+ *
+ * If a host application (e.g. Studio) already defines these CSS custom
+ * properties on :root, the host values cascade through and our fallbacks
+ * are never reached — because we set them on [data-vf-chat] which has
+ * lower specificity for inherited vars. We intentionally only set them
+ * on the chat root so parent-defined tokens take precedence.
+ *
+ * Dark mode: supports prefers-color-scheme, .dark, and [data-theme="dark"].
+ */
+export function generateTokenCSS(): string {
+  const light = tokensToCSS(TOKENS_LIGHT);
+  const dark = tokensToCSS(TOKENS_DARK);
+
+  return [
+    `@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap');`,
+    `[data-vf-chat]{font-family:'Inter',ui-sans-serif,system-ui,sans-serif;${light}}`,
+    `[data-vf-chat] button{cursor:pointer;}`,
+    `@media(prefers-color-scheme:dark){[data-vf-chat]:not([data-vf-theme]){${dark}}}`,
+    `.dark [data-vf-chat]:not([data-vf-theme]),[data-theme="dark"] [data-vf-chat]:not([data-vf-theme]){${dark}}`,
+  ].join("");
+}
+
+// ---------------------------------------------------------------------------
+// Theme interfaces
+// ---------------------------------------------------------------------------
+
 export interface ChatTheme {
   /** Container styles */
   container?: string;
-
   /** Message styles by role */
   message?: {
     user?: string;
@@ -15,68 +129,49 @@ export interface ChatTheme {
     system?: string;
     tool?: string;
   };
-
   /** Input styles */
   input?: string;
-
   /** Button styles */
   button?: string;
-
   /** Loading indicator styles */
   loading?: string;
 }
 
 /**
- * Default theme using Tailwind CSS - Apple Messages inspired, clean & minimal
+ * Default theme using CSS custom properties from the design system.
  */
 export const defaultChatTheme: ChatTheme = {
-  container: "flex flex-col h-full overflow-hidden bg-white dark:bg-neutral-900",
+  container: "flex flex-col h-full overflow-hidden bg-[var(--background)]",
   message: {
-    user: "bg-blue-500 text-white rounded-[20px] rounded-br-[4px] px-4 py-2.5 max-w-[75%]",
-    assistant:
-      "bg-neutral-100 dark:bg-neutral-800 text-neutral-900 dark:text-neutral-100 rounded-[20px] rounded-bl-[4px] px-4 py-2.5 max-w-[75%]",
-    system:
-      "bg-neutral-100 dark:bg-neutral-800 text-neutral-500 dark:text-neutral-400 rounded-2xl px-4 py-2 text-sm mx-auto text-center",
+    user:
+      "bg-[var(--chat-bubble)] text-[var(--chat-bubble-foreground)] rounded-[22px] px-5 py-3 max-w-[80%] shadow-sm",
+    assistant: "text-[var(--card-foreground)] max-w-none",
+    system: "text-[var(--muted-foreground)] text-sm mx-auto text-center py-2",
     tool:
-      "bg-neutral-50 dark:bg-neutral-800 text-neutral-600 dark:text-neutral-300 rounded-xl px-3 py-2 text-sm font-mono border border-neutral-200 dark:border-neutral-700",
+      "bg-[var(--card)] text-[var(--card-foreground)] rounded-xl px-3 py-2 text-sm font-mono border border-[var(--border)]",
   },
   input:
-    "flex-1 px-4 py-2.5 bg-neutral-100 dark:bg-neutral-800 border-0 rounded-full focus:outline-none focus:ring-2 focus:ring-blue-500/30 dark:text-neutral-100 placeholder-neutral-400 dark:placeholder-neutral-500 text-[15px]",
+    "w-full bg-transparent border-none focus:outline-none focus:ring-0 text-[var(--foreground)] placeholder:text-[var(--input-placeholder)] text-[15px] leading-normal",
   button:
-    "w-9 h-9 flex items-center justify-center bg-blue-500 hover:bg-blue-600 active:scale-95 text-white rounded-full transition-all disabled:opacity-30 disabled:cursor-not-allowed disabled:hover:bg-blue-500 disabled:active:scale-100",
-  loading: "w-1.5 h-1.5 bg-neutral-400 rounded-full animate-bounce",
+    "size-9 shrink-0 flex items-center justify-center rounded-full transition-all bg-[var(--foreground)] text-[var(--background)] hover:opacity-90 active:scale-95 disabled:opacity-40",
+  loading: "size-2 bg-[var(--border)] rounded-full animate-pulse",
 };
 
 export interface AgentTheme {
-  /** Container styles */
   container?: string;
-
-  /** Status styles */
   status?: string;
-
-  /** Thinking indicator styles */
   thinking?: string;
-
-  /** Tool invocation styles */
   tool?: string;
-
-  /** Tool result styles */
   toolResult?: string;
 }
 
-/**
- * Default agent theme - Apple-inspired, clean & minimal
- */
 export const defaultAgentTheme: AgentTheme = {
-  container:
-    "border border-neutral-200 dark:border-neutral-800 rounded-2xl p-6 space-y-4 bg-white dark:bg-neutral-900",
+  container: "border border-[var(--border)] rounded-2xl p-6 space-y-4 bg-[var(--card)]",
   status: "inline-flex items-center px-3 py-1.5 rounded-full text-sm font-medium",
   thinking:
-    "bg-amber-50 dark:bg-amber-900/20 rounded-xl px-4 py-3 italic text-neutral-700 dark:text-neutral-300 border border-amber-200 dark:border-amber-800",
-  tool:
-    "rounded-xl px-4 py-3 bg-blue-50 dark:bg-blue-900/20 border border-blue-200 dark:border-blue-800",
-  toolResult:
-    "mt-2 p-3 bg-neutral-100 dark:bg-neutral-800 rounded-xl font-mono text-sm overflow-x-auto",
+    "bg-amber-500/10 rounded-xl px-4 py-3 italic text-[var(--foreground)] border border-amber-500/20",
+  tool: "rounded-xl px-4 py-3 bg-blue-500/10 border border-blue-500/20",
+  toolResult: "mt-2 p-3 bg-[var(--accent)] rounded-xl font-mono text-sm overflow-x-auto",
 };
 
 function isPlainObject(value: unknown): value is Record<string, unknown> {
@@ -114,9 +209,80 @@ export function mergeThemes<T>(
 }
 
 /**
- * Utility to combine class names
- * (Simple version - in production use 'clsx' or 'cn' from shadcn)
+ * Utility to combine and merge Tailwind class names.
  */
-export function cn(...classes: (string | undefined | null | false)[]): string {
-  return classes.filter(Boolean).join(" ");
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs));
 }
+
+// ---------------------------------------------------------------------------
+// CVA Variant Definitions
+// ---------------------------------------------------------------------------
+
+import { cva } from "class-variance-authority";
+
+type CvaReturn = ReturnType<typeof cva>;
+
+export const messageVariants: CvaReturn = cva("", {
+  variants: {
+    role: {
+      user:
+        "bg-[var(--chat-bubble)] text-[var(--chat-bubble-foreground)] rounded-[22px] px-5 py-3 max-w-[80%] shadow-sm",
+      assistant: "text-[var(--card-foreground)] max-w-none",
+      system: "text-[var(--muted-foreground)] text-sm mx-auto text-center py-2",
+      tool:
+        "bg-[var(--card)] text-[var(--card-foreground)] rounded-xl px-3 py-2 text-sm font-mono border border-[var(--border)]",
+    },
+  },
+  defaultVariants: {
+    role: "assistant",
+  },
+});
+
+export const chatButtonVariants: CvaReturn = cva(
+  [
+    "inline-flex items-center justify-center gap-2 whitespace-nowrap",
+    "font-medium rounded-full transition-all duration-150",
+    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] focus-visible:ring-offset-2",
+    "disabled:pointer-events-none disabled:opacity-50",
+    "[&_svg]:shrink-0",
+  ],
+  {
+    variants: {
+      variant: {
+        primary:
+          "bg-[var(--primary)] text-[var(--primary-foreground)] hover:opacity-90 active:scale-95",
+        ghost: "bg-transparent text-[var(--foreground)] hover:bg-[var(--foreground)]/5",
+        outline:
+          "border border-[var(--border)] bg-transparent text-[var(--foreground)] hover:bg-[var(--foreground)]/5",
+        "icon-ghost":
+          "bg-transparent text-[var(--muted-foreground)] hover:text-[var(--foreground)] hover:bg-[var(--foreground)]/5 !p-0 !gap-0",
+      },
+      size: {
+        sm: "h-[38px] px-4 text-sm [&_svg]:size-4",
+        default: "h-[42px] px-5 text-base [&_svg]:size-5",
+        "icon-xs": "size-7 [&_svg]:size-4",
+        "icon-sm": "size-9 [&_svg]:size-5",
+        "icon-default": "size-10 [&_svg]:size-5",
+      },
+    },
+    defaultVariants: {
+      variant: "primary",
+      size: "default",
+    },
+  },
+);
+
+export const chatContainerVariants: CvaReturn = cva("flex flex-col overflow-hidden", {
+  variants: {
+    variant: {
+      default: "h-full bg-[var(--background)]",
+      embedded: "h-full bg-transparent",
+      floating:
+        "h-[600px] w-[400px] rounded-2xl border border-[var(--border)] bg-[var(--background)] shadow-xl",
+    },
+  },
+  defaultVariants: {
+    variant: "default",
+  },
+});

package/src/src/react/primitives/input-box.tsx

@@ -17,6 +17,9 @@ export const InputBox = React.forwardRef<
   HTMLInputElement | HTMLTextAreaElement,
   InputBoxProps
 >(({ className, value, onChange, onSubmit, multiline, ...props }, ref) => {
+  const internalRef = React.useRef<HTMLTextAreaElement>(null);
+  const textareaRef = (ref as React.RefObject<HTMLTextAreaElement>) || internalRef;
+
   const handleKeyDown = (
     e: React.KeyboardEvent<HTMLInputElement | HTMLTextAreaElement>,
   ): void => {
@@ -25,18 +28,29 @@ export const InputBox = React.forwardRef<
     onSubmit();
   };
 
+  // Auto-resize textarea to fit content
+  React.useEffect(() => {
+    const el = textareaRef.current;
+    if (!el || !multiline) return;
+    el.style.height = "auto";
+    if (value) {
+      el.style.height = Math.min(el.scrollHeight, 200) + "px";
+    }
+  }, [value, multiline, textareaRef]);
+
   if (multiline) {
     return (
       <textarea
         // deno-lint-ignore no-explicit-any
-        ref={ref as any}
+        ref={textareaRef as any}
         className={className}
+        style={{ resize: "none", border: "none", outline: "none" }}
         value={value}
         onChange={onChange}
         onKeyDown={handleKeyDown}
         data-input-box=""
         data-multiline="true"
-        rows={3}
+        rows={1}
         {...(props as React.TextareaHTMLAttributes<HTMLTextAreaElement>)}
       />
     );
@@ -74,8 +88,17 @@ export interface SubmitButtonProps extends React.ButtonHTMLAttributes<HTMLButton
 
 function SubmitIcon(): React.JSX.Element {
   return (
-    <svg className="w-4 h-4" viewBox="0 0 24 24" fill="currentColor">
-      <path d="M2.01 21L23 12 2.01 3 2 10l15 2-15 2z" />
+    <svg
+      className="size-5"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    >
+      <path d="m5 12 7-7 7 7" />
+      <path d="M12 19V5" />
     </svg>
   );
 }

package/src/src/rendering/cache/index.ts

@@ -10,8 +10,15 @@ export {
   type CacheLookupResult,
 } from "./cache-coordinator.js";
 export type { CachePayload, CacheStore } from "./types.js";
-export { APICacheStore, type APICacheStoreOptions } from "./stores/index.js";
-export { FilesystemCacheStore, type FilesystemCacheStoreOptions } from "./stores/index.js";
-export { KVCacheStore, type KVCacheStoreOptions } from "./stores/index.js";
-export { MemoryCacheStore, type MemoryCacheStoreOptions } from "./stores/index.js";
-export { RedisCacheStore, type RedisCacheStoreOptions } from "./stores/index.js";
+export {
+  APICacheStore,
+  type APICacheStoreOptions,
+  FilesystemCacheStore,
+  type FilesystemCacheStoreOptions,
+  KVCacheStore,
+  type KVCacheStoreOptions,
+  MemoryCacheStore,
+  type MemoryCacheStoreOptions,
+  RedisCacheStore,
+  type RedisCacheStoreOptions,
+} from "./stores/index.js";

package/src/src/rendering/component-handling.ts

@@ -9,7 +9,6 @@ import type { RuntimeAdapter } from "../platform/adapters/base.js";
 import type { EntityInfo, PageBundle } from "../types/index.js";
 import { createError, getErrorMessage, toError } from "../errors/veryfront-error.js";
 import { getProjectReact } from "../react/index.js";
-import { injectNodePositions } from "../transforms/plugins/babel-node-positions.js";
 import { buildComponentCacheKey } from "../cache/keys.js";
 import { LRUCache } from "../utils/lru-wrapper.js";
 import { registerLRUCache } from "../cache/index.js";
@@ -50,6 +49,8 @@ export async function handleComponentPage(
     projectId?: string;
     /** Enable node position injection for Studio Navigator */
     studioEmbed?: boolean;
+    /** Request mode ("preview" | "production") for studio features */
+    mode?: string;
     /** Content source ID for cache isolation (branch name or release ID) */
     contentSourceId?: string;
     /** React version for transforms (from project config) */
@@ -59,13 +60,10 @@ export async function handleComponentPage(
   try {
     logger.debug(`Loading TSX/JSX file: ${pageInfo.entity.path}`);
 
-    const rawFileContent = await adapter.fs.readFile(pageInfo.entity.path);
-    const normalizedPath = pageInfo.entity.path.startsWith(projectDir)
-      ? pageInfo.entity.path.slice(projectDir.length).replace(/^\/+/, "")
-      : pageInfo.entity.path;
-    const fileContent = options?.studioEmbed
-      ? injectNodePositions(rawFileContent, { filePath: normalizedPath })
-      : rawFileContent;
+    // Node positions are injected by the SSR module loader (for all files
+    // including this entry point) when dev || mode === "preview" — no need
+    // to inject here to avoid double-injection which shifts positions.
+    const fileContent = await adapter.fs.readFile(pageInfo.entity.path);
 
     const clientModuleCode = options?.cachedClientModule ??
       (await bundleComponentForClient(
@@ -79,6 +77,7 @@ export async function handleComponentPage(
       ));
 
     const { loadComponentFromSource } = await import("../modules/react-loader/index.js");
+    const dev = options?.mode === "development";
     const PageComponent = await loadComponentFromSource(
       fileContent,
       pageInfo.entity.path,
@@ -86,11 +85,12 @@ export async function handleComponentPage(
       adapter,
       {
         projectId: options?.projectId ?? projectDir,
-        dev: true,
+        dev,
         moduleServerUrl: options?.moduleServerUrl,
         ssr: true,
         contentSourceId: options?.contentSourceId,
         reactVersion: options?.reactVersion,
+        mode: options?.mode,
       },
     );
 

package/src/src/rendering/orchestrator/pipeline.ts

@@ -30,7 +30,7 @@ import { join } from "../../platform/compat/path/index.js";
 import type { MdxBundle, PageBundle } from "../../types/index.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import { isExtendedFSAdapter } from "../../platform/adapters/fs/wrapper.js";
-import type { CacheCoordinator } from "../cache/cache-coordinator.js";
+import type { CacheLookupResult } from "../cache/cache-coordinator.js";
 import type { PageRenderer } from "../page-renderer.js";
 import type { PageResolver } from "../page-resolution/index.js";
 import type { LayoutOrchestrator } from "./layout.js";
@@ -77,9 +77,19 @@ const resolvePageDataLog = logger.component("resolve-page-data");
 // Re-export test helper for backward compatibility
 export { __injectCssCacheForTests } from "./css-cache.js";
 
+/**
+ * Minimal cache interface used by RenderPipeline.
+ * Decoupled from the concrete CacheCoordinator class so that Renderer
+ * can supply a context-aware adapter without an unsafe `as any` cast.
+ */
+export interface PipelineCacheCoordinator {
+  checkCache(slug: string, cacheKey?: string): Promise<CacheLookupResult>;
+  persistResult(result: RenderResult, slug: string, cacheKey?: string): Promise<void>;
+}
+
 export interface RenderPipelineConfig {
   pageResolver: PageResolver;
-  cacheCoordinator: CacheCoordinator;
+  cacheCoordinator: PipelineCacheCoordinator;
   pageRenderer: PageRenderer;
   layoutOrchestrator: LayoutOrchestrator;
   ssrOrchestrator: SSROrchestrator;

package/src/src/rendering/page-renderer.ts

@@ -162,6 +162,7 @@ export class PageRenderer {
                   moduleServerUrl: this.moduleServerUrl,
                   projectId: options?.projectId,
                   studioEmbed: options?.studioEmbed,
+                  mode: this.mode,
                   contentSourceId: options?.contentSourceId,
                 },
               ),

package/src/src/rendering/renderer.ts

@@ -518,7 +518,7 @@ export class Renderer {
 
     const pipeline = new RenderPipeline({
       pageResolver,
-      cacheCoordinator: pipelineCacheCoordinator as any,
+      cacheCoordinator: pipelineCacheCoordinator,
       pageRenderer,
       layoutOrchestrator,
       ssrOrchestrator,

package/src/src/rendering/shared/context-aware-cache.ts

@@ -70,11 +70,6 @@ export class ContextAwareCacheCoordinator {
           await this.store.delete(cacheKey);
 
           logger.debug("Cache expired", {
-            slug,
-            projectId: ctx.projectId,
-          });
-
-          logger.debug("Cache miss", {
             slug,
             cacheKey,
             projectId: ctx.projectId,

package/src/src/repositories/schemas/index.ts

@@ -9,8 +9,6 @@ export {
   CacheRepositoryOptionsSchema,
   type CacheStats,
   CacheStatsSchema,
-  type FileSystemRepositoryOptions,
-  FileSystemRepositoryOptionsSchema,
   type RepositoryContext,
   RepositoryContextSchema,
 } from "./repository.schema.js";

package/src/src/repositories/schemas/repository.schema.ts

@@ -21,22 +21,7 @@ export const CacheRepositoryOptionsSchema = z.object({
   maxEntries: z.number().int().positive().optional(),
 });
 
-export const FileSystemRepositoryOptionsSchema = z.object({
-  baseDir: z.string(),
-  securityContext: z
-    .enum([
-      "user-input",
-      "static-serving",
-      "build",
-      "internal",
-      "route-discovery",
-      "module-loading",
-    ])
-    .optional(),
-});
-
 // Inferred types
 export type RepositoryContext = z.infer<typeof RepositoryContextSchema>;
 export type CacheStats = z.infer<typeof CacheStatsSchema>;
 export type CacheRepositoryOptions = z.infer<typeof CacheRepositoryOptionsSchema>;
-export type FileSystemRepositoryOptions = z.infer<typeof FileSystemRepositoryOptionsSchema>;

package/src/src/repositories/types.ts

@@ -1,12 +1,7 @@
 import type { DirEntry, FileInfo } from "../platform/adapters/base.js";
 
 // Re-export schema-based types
-export type {
-  CacheRepositoryOptions,
-  CacheStats,
-  FileSystemRepositoryOptions,
-  RepositoryContext,
-} from "./schemas/index.js";
+export type { CacheRepositoryOptions, CacheStats, RepositoryContext } from "./schemas/index.js";
 
 // Import for use in interface definitions
 import type { CacheStats, RepositoryContext } from "./schemas/index.js";

package/src/src/routing/api/module-loader/esbuild-plugin.ts

@@ -2,7 +2,6 @@ import * as dntShim from "../../../../_dnt.shims.js";
 import {
   computeIntegrity,
   createLockfileManager,
-  getDenoStdNodeBase,
   HTTP_MODULE_FETCH_TIMEOUT_MS,
   HTTP_NETWORK_CONNECT_TIMEOUT,
   type LockfileManager,
@@ -28,27 +27,9 @@ export function createHTTPPlugin(options: HTTPPluginOptions | string[]): Plugin
   return {
     name: "vf-api-http-fetch",
     setup(build): void {
-      const stdNodeBase = getDenoStdNodeBase();
       const resolvedUrls: string[] = [];
       const nodeMapped: Array<{ from: string; to: string }> = [];
 
-      function mapNodeCore(spec: string): string | null {
-        if (spec.startsWith("node:")) {
-          return `${stdNodeBase}/${spec.slice(5)}.ts`;
-        }
-
-        switch (spec) {
-          case "buffer":
-            return `${stdNodeBase}/buffer.ts`;
-          case "path":
-            return `${stdNodeBase}/path.ts`;
-          case "fs":
-            return `${stdNodeBase}/fs.ts`;
-          default:
-            return null;
-        }
-      }
-
       async function fetchWithTimeout(url: string): Promise<dntShim.Response> {
         const controller = new AbortController();
         const timeout = dntShim.setTimeout(() => controller.abort(), HTTP_MODULE_FETCH_TIMEOUT_MS);
@@ -76,13 +57,18 @@ export function createHTTPPlugin(options: HTTPPluginOptions | string[]): Plugin
         return { path: reactUrl, namespace: "http-url" };
       });
 
-      build.onResolve({ filter: /^(node:|buffer$|path$|fs$)/ }, (args) => {
-        const mapped = mapNodeCore(args.path);
-        if (!mapped) return undefined;
+      // Node.js built-in modules — mark as external so they resolve at runtime
+      // via Deno's node: compat layer or Node.js itself. Post-processing in
+      // rewriteExternalImports converts bare names to node: prefix for Deno.
+      const nodeBuiltinPattern =
+        /^(node:|assert$|buffer$|child_process$|cluster$|crypto$|dgram$|dns$|events$|fs$|http$|http2$|https$|net$|os$|path$|perf_hooks$|querystring$|readline$|stream$|string_decoder$|tls$|tty$|url$|util$|v8$|vm$|worker_threads$|zlib$)/;
 
-        nodeMapped.push({ from: args.path, to: mapped });
-        logger.debug(`[http] map '${args.path}' -> '${mapped}'`);
-        return { path: mapped, namespace: "http-url" };
+      build.onResolve({ filter: nodeBuiltinPattern }, (args) => {
+        nodeMapped.push({
+          from: args.path,
+          to: args.path.startsWith("node:") ? args.path : `node:${args.path}`,
+        });
+        return { path: args.path, external: true };
       });
 
       build.onResolve({ filter: /.*/ }, (args) => {