@aprovan/patchwork-compiler 0.1.2-dev.6bd527d → 0.1.2-dev.78c0b14

package/dist/index.d.cts

@@ -17,7 +17,7 @@ interface VirtualProject {
 /**
  * Core types for the Patchwork compiler
  */
-type Platform = 'browser' | 'cli';
+type Platform = "browser" | "cli";
 interface Manifest$1 {
     name: string;
     version: string;
@@ -29,7 +29,7 @@ interface Manifest$1 {
     packages?: Record<string, string>;
 }
 interface InputSpec {
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    type: "string" | "number" | "boolean" | "object" | "array";
     default?: unknown;
     required?: boolean;
     description?: string;
@@ -46,7 +46,7 @@ interface CompiledWidget {
     /** Source map (if generated) */
     sourceMap?: string;
 }
-type MountMode = 'embedded' | 'iframe';
+type MountMode = "embedded" | "iframe";
 interface MountOptions {
     /** Target DOM element to mount into */
     target: HTMLElement;
@@ -79,8 +79,8 @@ interface ImageConfig$1 {
     platform: Platform;
     esbuild?: {
         target?: string;
-        format?: 'esm' | 'cjs' | 'iife';
-        jsx?: 'automatic' | 'transform' | 'preserve';
+        format?: "esm" | "cjs" | "iife";
+        jsx?: "automatic" | "transform" | "preserve";
         jsxFactory?: string;
         jsxFragment?: string;
     };
@@ -136,6 +136,12 @@ interface CompilerOptions {
     cdnBaseUrl?: string;
     /** Base URL for widget imports (default: same as cdnBaseUrl). Used for transforming imports in widget code. */
     widgetCdnBaseUrl?: string;
+    /**
+     * URL overrides for bundled assets/packages.
+     * Keys are asset identifiers (e.g., 'esbuild-wasm/esbuild.wasm'), values are local URLs.
+     * Use this to bundle assets locally for offline support or improved performance.
+     */
+    urlOverrides?: Record<string, string>;
 }
 interface Compiler {
     /** Pre-load an image package */
@@ -157,7 +163,7 @@ interface Compiler {
  * The compiler provides the interface; actual implementation (e.g., UTCP, MCP)
  * is handled by the runtime/backend.
  */
-interface ServiceProxy {
+interface Proxy {
     call(namespace: string, procedure: string, args: unknown[]): Promise<unknown>;
 }
 /**
@@ -178,7 +184,7 @@ interface GlobalInterfaceDefinition {
     /** Optional TypeScript type definitions for methods */
     types?: string;
 }
-type BridgeMessageType = 'service-call' | 'service-result' | 'error';
+type BridgeMessageType = "service-call" | "service-result" | "error";
 interface BridgeMessage {
     type: BridgeMessageType;
     id: string;
@@ -216,15 +222,15 @@ declare const EsbuildConfigSchema: z.ZodOptional<z.ZodObject<{
     jsxFactory: z.ZodOptional<z.ZodString>;
     jsxFragment: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    jsx?: "automatic" | "transform" | "preserve" | undefined;
     target?: string | undefined;
     format?: "esm" | "cjs" | "iife" | undefined;
+    jsx?: "automatic" | "transform" | "preserve" | undefined;
     jsxFactory?: string | undefined;
     jsxFragment?: string | undefined;
 }, {
-    jsx?: "automatic" | "transform" | "preserve" | undefined;
     target?: string | undefined;
     format?: "esm" | "cjs" | "iife" | undefined;
+    jsx?: "automatic" | "transform" | "preserve" | undefined;
     jsxFactory?: string | undefined;
     jsxFragment?: string | undefined;
 }>>;
@@ -238,15 +244,15 @@ declare const ImageConfigSchema: z.ZodObject<{
         jsxFactory: z.ZodOptional<z.ZodString>;
         jsxFragment: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     }, {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     }>>;
@@ -268,9 +274,9 @@ declare const ImageConfigSchema: z.ZodObject<{
     platform: "browser" | "cli";
     dependencies?: Record<string, string> | undefined;
     esbuild?: {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     } | undefined;
@@ -284,9 +290,9 @@ declare const ImageConfigSchema: z.ZodObject<{
     platform: "browser" | "cli";
     dependencies?: Record<string, string> | undefined;
     esbuild?: {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     } | undefined;
@@ -416,19 +422,65 @@ declare const DEFAULT_IMAGE_CONFIG: ImageConfig;
 declare const DEFAULT_CLI_IMAGE_CONFIG: ImageConfig;
 
 /**
- * Image loader - fetches and loads image packages from CDN or local
+ * Shared CDN configuration for the patchwork compiler
  *
- * Images must be installed as npm packages or available on CDN.
+ * This module centralizes CDN base URL management used by:
+ * - Image loading (images/loader.ts)
+ * - CDN transforms (transforms/cdn.ts)
+ * - Mount utilities (mount/embedded.ts)
  */
-
+declare const DEFAULT_CDN_BASE = "https://esm.sh";
 /**
- * Set the CDN base URL for image loading
+ * Set the CDN base URL for all CDN operations
  */
 declare function setCdnBaseUrl(url: string): void;
 /**
  * Get the current CDN base URL
  */
 declare function getCdnBaseUrl(): string;
+/**
+ * Convert a package specifier to a CDN URL
+ *
+ * @param packageName - The npm package name
+ * @param version - Optional version specifier
+ * @param subpath - Optional subpath (e.g., '/client' for 'react-dom/client')
+ * @param deps - Optional dependency version overrides (use ?deps=react@18)
+ */
+declare function toEsmShUrl(packageName: string, version?: string, subpath?: string, deps?: Record<string, string>): string;
+/**
+ * Check if an import path is a bare module specifier
+ */
+declare function isBareImport(path: string): boolean;
+/**
+ * Parse a package specifier into name and version
+ */
+declare function parsePackageSpec(spec: string): {
+    name: string;
+    version?: string;
+};
+/**
+ * Extract package name and subpath from an import
+ */
+declare function parseImportPath(importPath: string): {
+    packageName: string;
+    subpath?: string;
+};
+/**
+ * Match an import path against alias patterns
+ * Supports glob patterns like '@/components/ui/*'
+ */
+declare function matchAlias(importPath: string, aliases: Record<string, string>): string | null;
+/**
+ * Get common named exports for known packages
+ */
+declare function getCommonExports(packageName: string): string[];
+
+/**
+ * Image loader - fetches and loads image packages from CDN or local
+ *
+ * Images must be installed as npm packages or available on CDN.
+ */
+
 interface ImagePackageJson {
     name: string;
     version: string;
@@ -438,6 +490,7 @@ interface ImagePackageJson {
 }
 /**
  * Parse image specifier into name and version
+ * (Alias of parsePackageSpec for image-specific usage)
  */
 declare function parseImageSpec(spec: string): {
     name: string;
@@ -625,7 +678,7 @@ interface HttpBackendConfig {
     baseUrl: string;
 }
 /**
- * HTTP-based FSProvider for connecting to remote servers (e.g., stitchery)
+ * HTTP-based FSProvider for connecting to remote VFS servers
  */
 declare class HttpBackend implements FSProvider {
     private config;
@@ -679,6 +732,7 @@ declare class VFSStore {
     listFiles(prefix?: string): Promise<string[]>;
     loadProject(id: string): Promise<VirtualProject | null>;
     saveProject(project: VirtualProject): Promise<void>;
+    watch(path: string, callback: WatchCallback): () => void;
     sync(): Promise<SyncResult>;
     on<T extends SyncEventType>(event: T, callback: SyncEventCallback<T extends "change" ? ChangeRecord : T extends "conflict" ? ConflictRecord : T extends "error" ? Error : SyncStatus>): () => void;
     private remotePath;
@@ -694,11 +748,11 @@ declare class VFSStore {
 /**
  * Mount a widget in embedded mode (direct DOM injection)
  */
-declare function mountEmbedded(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function mountEmbedded(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 /**
  * Hot reload an embedded widget
  */
-declare function reloadEmbedded(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function reloadEmbedded(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 
 /**
  * Iframe mount mode - mounts widgets in sandboxed iframes
@@ -724,11 +778,11 @@ declare const DEV_SANDBOX: string[];
 /**
  * Mount a widget in iframe mode (sandboxed)
  */
-declare function mountIframe(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function mountIframe(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 /**
  * Hot reload an iframe widget
  */
-declare function reloadIframe(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function reloadIframe(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 /**
  * Dispose the shared bridge (call on app shutdown)
  */
@@ -741,7 +795,7 @@ declare function disposeIframeBridge(): void;
 /**
  * Create a service proxy that calls the backend via HTTP
  */
-declare function createHttpServiceProxy(proxyUrl: string): ServiceProxy;
+declare function createHttpProxy(proxyUrl: string): Proxy;
 /**
  * Creates a proxy that enables fluent method chaining for dynamic field access.
  *
@@ -769,7 +823,7 @@ declare function createFieldAccessProxy<T = unknown>(namespace: string, handler:
  * //   calls proxy.call('github', 'repos.list_for_user', [{ username: 'x' }])
  * ```
  */
-declare function generateNamespaceGlobals(services: string[], proxy: ServiceProxy): Record<string, unknown>;
+declare function generateNamespaceGlobals(services: string[], proxy: Proxy): Record<string, unknown>;
 /**
  * Inject namespace globals into a window object
  */
@@ -792,7 +846,7 @@ declare class ParentBridge {
     private pendingCalls;
     private iframes;
     private messageHandler;
-    constructor(proxy: ServiceProxy);
+    constructor(proxy: Proxy);
     /**
      * Register an iframe to receive messages from
      */
@@ -815,7 +869,7 @@ declare class ParentBridge {
  *
  * Creates a service proxy that sends postMessage to parent.
  */
-declare function createIframeServiceProxy(): ServiceProxy;
+declare function createIframeProxy(): Proxy;
 /**
  * Generate the bridge script to inject into iframes
  *
@@ -825,4 +879,4 @@ declare function createIframeServiceProxy(): ServiceProxy;
  */
 declare function generateIframeBridgeScript(services: string[]): string;
 
-export { type BridgeMessage, type BridgeMessageType, type CdnTransformOptions, type ChangeRecord, type CompileOptions, CompileOptionsSchema, type CompiledWidget, type Compiler, type CompilerOptions, DEFAULT_CLI_IMAGE_CONFIG, DEFAULT_IMAGE_CONFIG, DEV_SANDBOX, EsbuildConfigSchema, type GlobalInterfaceDefinition, HttpBackend, type HttpBackendConfig, type ImageConfig$1 as ImageConfig, ImageConfigSchema, type ImageMountFn, ImageRegistry, IndexedDBBackend, type InputSpec, InputSpecSchema, type LoadedImage, type Manifest$1 as Manifest, ManifestSchema, type MountMode, MountModeSchema, type MountOptions, MountOptionsSchema, type MountedWidget, ParentBridge, type Platform, PlatformSchema, type ServiceCallHandler, type ServiceCallPayload, type ServiceProxy, type ServiceResultPayload, type VFSPluginOptions, VFSStore, type VFSStoreOptions, type VirtualFile, type VirtualProject, cdnTransformPlugin, createCompiler, createFieldAccessProxy, createHttpServiceProxy, createIframeServiceProxy, createImageRegistry, createProjectFromFiles, createSingleFileProject, detectMainFile, disposeIframeBridge, extractNamespaces, fetchPackageJson, generateIframeBridgeScript, generateImportMap, generateNamespaceGlobals, getCdnBaseUrl, getImageRegistry, injectNamespaceGlobals, loadImage, mountEmbedded, mountIframe, parseImageConfig, parseImageSpec, parseManifest, reloadEmbedded, reloadIframe, removeNamespaceGlobals, resolveEntry, safeParseImageConfig, safeParseManifest, setCdnBaseUrl, vfsPlugin };
+export { type BridgeMessage, type BridgeMessageType, type CdnTransformOptions, type ChangeRecord, type CompileOptions, CompileOptionsSchema, type CompiledWidget, type Compiler, type CompilerOptions, DEFAULT_CDN_BASE, DEFAULT_CLI_IMAGE_CONFIG, DEFAULT_IMAGE_CONFIG, DEV_SANDBOX, EsbuildConfigSchema, type GlobalInterfaceDefinition, HttpBackend, type HttpBackendConfig, type ImageConfig$1 as ImageConfig, ImageConfigSchema, type ImageMountFn, ImageRegistry, IndexedDBBackend, type InputSpec, InputSpecSchema, type LoadedImage, type Manifest$1 as Manifest, ManifestSchema, type MountMode, MountModeSchema, type MountOptions, MountOptionsSchema, type MountedWidget, ParentBridge, type Platform, PlatformSchema, type Proxy, type ServiceCallHandler, type ServiceCallPayload, type ServiceResultPayload, type VFSPluginOptions, VFSStore, type VFSStoreOptions, type VirtualFile, type VirtualProject, type WatchCallback, type WatchEventType, cdnTransformPlugin, createCompiler, createFieldAccessProxy, createHttpProxy, createIframeProxy, createImageRegistry, createProjectFromFiles, createSingleFileProject, detectMainFile, disposeIframeBridge, extractNamespaces, fetchPackageJson, generateIframeBridgeScript, generateImportMap, generateNamespaceGlobals, getCdnBaseUrl, getCommonExports, getImageRegistry, injectNamespaceGlobals, isBareImport, loadImage, matchAlias, mountEmbedded, mountIframe, parseImageConfig, parseImageSpec, parseImportPath, parseManifest, parsePackageSpec, reloadEmbedded, reloadIframe, removeNamespaceGlobals, resolveEntry, safeParseImageConfig, safeParseManifest, setCdnBaseUrl, toEsmShUrl, vfsPlugin };

package/dist/index.d.ts

@@ -17,7 +17,7 @@ interface VirtualProject {
 /**
  * Core types for the Patchwork compiler
  */
-type Platform = 'browser' | 'cli';
+type Platform = "browser" | "cli";
 interface Manifest$1 {
     name: string;
     version: string;
@@ -29,7 +29,7 @@ interface Manifest$1 {
     packages?: Record<string, string>;
 }
 interface InputSpec {
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    type: "string" | "number" | "boolean" | "object" | "array";
     default?: unknown;
     required?: boolean;
     description?: string;
@@ -46,7 +46,7 @@ interface CompiledWidget {
     /** Source map (if generated) */
     sourceMap?: string;
 }
-type MountMode = 'embedded' | 'iframe';
+type MountMode = "embedded" | "iframe";
 interface MountOptions {
     /** Target DOM element to mount into */
     target: HTMLElement;
@@ -79,8 +79,8 @@ interface ImageConfig$1 {
     platform: Platform;
     esbuild?: {
         target?: string;
-        format?: 'esm' | 'cjs' | 'iife';
-        jsx?: 'automatic' | 'transform' | 'preserve';
+        format?: "esm" | "cjs" | "iife";
+        jsx?: "automatic" | "transform" | "preserve";
         jsxFactory?: string;
         jsxFragment?: string;
     };
@@ -136,6 +136,12 @@ interface CompilerOptions {
     cdnBaseUrl?: string;
     /** Base URL for widget imports (default: same as cdnBaseUrl). Used for transforming imports in widget code. */
     widgetCdnBaseUrl?: string;
+    /**
+     * URL overrides for bundled assets/packages.
+     * Keys are asset identifiers (e.g., 'esbuild-wasm/esbuild.wasm'), values are local URLs.
+     * Use this to bundle assets locally for offline support or improved performance.
+     */
+    urlOverrides?: Record<string, string>;
 }
 interface Compiler {
     /** Pre-load an image package */
@@ -157,7 +163,7 @@ interface Compiler {
  * The compiler provides the interface; actual implementation (e.g., UTCP, MCP)
  * is handled by the runtime/backend.
  */
-interface ServiceProxy {
+interface Proxy {
     call(namespace: string, procedure: string, args: unknown[]): Promise<unknown>;
 }
 /**
@@ -178,7 +184,7 @@ interface GlobalInterfaceDefinition {
     /** Optional TypeScript type definitions for methods */
     types?: string;
 }
-type BridgeMessageType = 'service-call' | 'service-result' | 'error';
+type BridgeMessageType = "service-call" | "service-result" | "error";
 interface BridgeMessage {
     type: BridgeMessageType;
     id: string;
@@ -216,15 +222,15 @@ declare const EsbuildConfigSchema: z.ZodOptional<z.ZodObject<{
     jsxFactory: z.ZodOptional<z.ZodString>;
     jsxFragment: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    jsx?: "automatic" | "transform" | "preserve" | undefined;
     target?: string | undefined;
     format?: "esm" | "cjs" | "iife" | undefined;
+    jsx?: "automatic" | "transform" | "preserve" | undefined;
     jsxFactory?: string | undefined;
     jsxFragment?: string | undefined;
 }, {
-    jsx?: "automatic" | "transform" | "preserve" | undefined;
     target?: string | undefined;
     format?: "esm" | "cjs" | "iife" | undefined;
+    jsx?: "automatic" | "transform" | "preserve" | undefined;
     jsxFactory?: string | undefined;
     jsxFragment?: string | undefined;
 }>>;
@@ -238,15 +244,15 @@ declare const ImageConfigSchema: z.ZodObject<{
         jsxFactory: z.ZodOptional<z.ZodString>;
         jsxFragment: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     }, {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     }>>;
@@ -268,9 +274,9 @@ declare const ImageConfigSchema: z.ZodObject<{
     platform: "browser" | "cli";
     dependencies?: Record<string, string> | undefined;
     esbuild?: {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     } | undefined;
@@ -284,9 +290,9 @@ declare const ImageConfigSchema: z.ZodObject<{
     platform: "browser" | "cli";
     dependencies?: Record<string, string> | undefined;
     esbuild?: {
-        jsx?: "automatic" | "transform" | "preserve" | undefined;
         target?: string | undefined;
         format?: "esm" | "cjs" | "iife" | undefined;
+        jsx?: "automatic" | "transform" | "preserve" | undefined;
         jsxFactory?: string | undefined;
         jsxFragment?: string | undefined;
     } | undefined;
@@ -416,19 +422,65 @@ declare const DEFAULT_IMAGE_CONFIG: ImageConfig;
 declare const DEFAULT_CLI_IMAGE_CONFIG: ImageConfig;
 
 /**
- * Image loader - fetches and loads image packages from CDN or local
+ * Shared CDN configuration for the patchwork compiler
  *
- * Images must be installed as npm packages or available on CDN.
+ * This module centralizes CDN base URL management used by:
+ * - Image loading (images/loader.ts)
+ * - CDN transforms (transforms/cdn.ts)
+ * - Mount utilities (mount/embedded.ts)
  */
-
+declare const DEFAULT_CDN_BASE = "https://esm.sh";
 /**
- * Set the CDN base URL for image loading
+ * Set the CDN base URL for all CDN operations
  */
 declare function setCdnBaseUrl(url: string): void;
 /**
  * Get the current CDN base URL
  */
 declare function getCdnBaseUrl(): string;
+/**
+ * Convert a package specifier to a CDN URL
+ *
+ * @param packageName - The npm package name
+ * @param version - Optional version specifier
+ * @param subpath - Optional subpath (e.g., '/client' for 'react-dom/client')
+ * @param deps - Optional dependency version overrides (use ?deps=react@18)
+ */
+declare function toEsmShUrl(packageName: string, version?: string, subpath?: string, deps?: Record<string, string>): string;
+/**
+ * Check if an import path is a bare module specifier
+ */
+declare function isBareImport(path: string): boolean;
+/**
+ * Parse a package specifier into name and version
+ */
+declare function parsePackageSpec(spec: string): {
+    name: string;
+    version?: string;
+};
+/**
+ * Extract package name and subpath from an import
+ */
+declare function parseImportPath(importPath: string): {
+    packageName: string;
+    subpath?: string;
+};
+/**
+ * Match an import path against alias patterns
+ * Supports glob patterns like '@/components/ui/*'
+ */
+declare function matchAlias(importPath: string, aliases: Record<string, string>): string | null;
+/**
+ * Get common named exports for known packages
+ */
+declare function getCommonExports(packageName: string): string[];
+
+/**
+ * Image loader - fetches and loads image packages from CDN or local
+ *
+ * Images must be installed as npm packages or available on CDN.
+ */
+
 interface ImagePackageJson {
     name: string;
     version: string;
@@ -438,6 +490,7 @@ interface ImagePackageJson {
 }
 /**
  * Parse image specifier into name and version
+ * (Alias of parsePackageSpec for image-specific usage)
  */
 declare function parseImageSpec(spec: string): {
     name: string;
@@ -625,7 +678,7 @@ interface HttpBackendConfig {
     baseUrl: string;
 }
 /**
- * HTTP-based FSProvider for connecting to remote servers (e.g., stitchery)
+ * HTTP-based FSProvider for connecting to remote VFS servers
  */
 declare class HttpBackend implements FSProvider {
     private config;
@@ -679,6 +732,7 @@ declare class VFSStore {
     listFiles(prefix?: string): Promise<string[]>;
     loadProject(id: string): Promise<VirtualProject | null>;
     saveProject(project: VirtualProject): Promise<void>;
+    watch(path: string, callback: WatchCallback): () => void;
     sync(): Promise<SyncResult>;
     on<T extends SyncEventType>(event: T, callback: SyncEventCallback<T extends "change" ? ChangeRecord : T extends "conflict" ? ConflictRecord : T extends "error" ? Error : SyncStatus>): () => void;
     private remotePath;
@@ -694,11 +748,11 @@ declare class VFSStore {
 /**
  * Mount a widget in embedded mode (direct DOM injection)
  */
-declare function mountEmbedded(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function mountEmbedded(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 /**
  * Hot reload an embedded widget
  */
-declare function reloadEmbedded(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function reloadEmbedded(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 
 /**
  * Iframe mount mode - mounts widgets in sandboxed iframes
@@ -724,11 +778,11 @@ declare const DEV_SANDBOX: string[];
 /**
  * Mount a widget in iframe mode (sandboxed)
  */
-declare function mountIframe(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function mountIframe(widget: CompiledWidget, options: MountOptions, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 /**
  * Hot reload an iframe widget
  */
-declare function reloadIframe(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: ServiceProxy): Promise<MountedWidget>;
+declare function reloadIframe(mounted: MountedWidget, widget: CompiledWidget, image: LoadedImage | null, proxy: Proxy): Promise<MountedWidget>;
 /**
  * Dispose the shared bridge (call on app shutdown)
  */
@@ -741,7 +795,7 @@ declare function disposeIframeBridge(): void;
 /**
  * Create a service proxy that calls the backend via HTTP
  */
-declare function createHttpServiceProxy(proxyUrl: string): ServiceProxy;
+declare function createHttpProxy(proxyUrl: string): Proxy;
 /**
  * Creates a proxy that enables fluent method chaining for dynamic field access.
  *
@@ -769,7 +823,7 @@ declare function createFieldAccessProxy<T = unknown>(namespace: string, handler:
  * //   calls proxy.call('github', 'repos.list_for_user', [{ username: 'x' }])
  * ```
  */
-declare function generateNamespaceGlobals(services: string[], proxy: ServiceProxy): Record<string, unknown>;
+declare function generateNamespaceGlobals(services: string[], proxy: Proxy): Record<string, unknown>;
 /**
  * Inject namespace globals into a window object
  */
@@ -792,7 +846,7 @@ declare class ParentBridge {
     private pendingCalls;
     private iframes;
     private messageHandler;
-    constructor(proxy: ServiceProxy);
+    constructor(proxy: Proxy);
     /**
      * Register an iframe to receive messages from
      */
@@ -815,7 +869,7 @@ declare class ParentBridge {
  *
  * Creates a service proxy that sends postMessage to parent.
  */
-declare function createIframeServiceProxy(): ServiceProxy;
+declare function createIframeProxy(): Proxy;
 /**
  * Generate the bridge script to inject into iframes
  *
@@ -825,4 +879,4 @@ declare function createIframeServiceProxy(): ServiceProxy;
  */
 declare function generateIframeBridgeScript(services: string[]): string;
 
-export { type BridgeMessage, type BridgeMessageType, type CdnTransformOptions, type ChangeRecord, type CompileOptions, CompileOptionsSchema, type CompiledWidget, type Compiler, type CompilerOptions, DEFAULT_CLI_IMAGE_CONFIG, DEFAULT_IMAGE_CONFIG, DEV_SANDBOX, EsbuildConfigSchema, type GlobalInterfaceDefinition, HttpBackend, type HttpBackendConfig, type ImageConfig$1 as ImageConfig, ImageConfigSchema, type ImageMountFn, ImageRegistry, IndexedDBBackend, type InputSpec, InputSpecSchema, type LoadedImage, type Manifest$1 as Manifest, ManifestSchema, type MountMode, MountModeSchema, type MountOptions, MountOptionsSchema, type MountedWidget, ParentBridge, type Platform, PlatformSchema, type ServiceCallHandler, type ServiceCallPayload, type ServiceProxy, type ServiceResultPayload, type VFSPluginOptions, VFSStore, type VFSStoreOptions, type VirtualFile, type VirtualProject, cdnTransformPlugin, createCompiler, createFieldAccessProxy, createHttpServiceProxy, createIframeServiceProxy, createImageRegistry, createProjectFromFiles, createSingleFileProject, detectMainFile, disposeIframeBridge, extractNamespaces, fetchPackageJson, generateIframeBridgeScript, generateImportMap, generateNamespaceGlobals, getCdnBaseUrl, getImageRegistry, injectNamespaceGlobals, loadImage, mountEmbedded, mountIframe, parseImageConfig, parseImageSpec, parseManifest, reloadEmbedded, reloadIframe, removeNamespaceGlobals, resolveEntry, safeParseImageConfig, safeParseManifest, setCdnBaseUrl, vfsPlugin };
+export { type BridgeMessage, type BridgeMessageType, type CdnTransformOptions, type ChangeRecord, type CompileOptions, CompileOptionsSchema, type CompiledWidget, type Compiler, type CompilerOptions, DEFAULT_CDN_BASE, DEFAULT_CLI_IMAGE_CONFIG, DEFAULT_IMAGE_CONFIG, DEV_SANDBOX, EsbuildConfigSchema, type GlobalInterfaceDefinition, HttpBackend, type HttpBackendConfig, type ImageConfig$1 as ImageConfig, ImageConfigSchema, type ImageMountFn, ImageRegistry, IndexedDBBackend, type InputSpec, InputSpecSchema, type LoadedImage, type Manifest$1 as Manifest, ManifestSchema, type MountMode, MountModeSchema, type MountOptions, MountOptionsSchema, type MountedWidget, ParentBridge, type Platform, PlatformSchema, type Proxy, type ServiceCallHandler, type ServiceCallPayload, type ServiceResultPayload, type VFSPluginOptions, VFSStore, type VFSStoreOptions, type VirtualFile, type VirtualProject, type WatchCallback, type WatchEventType, cdnTransformPlugin, createCompiler, createFieldAccessProxy, createHttpProxy, createIframeProxy, createImageRegistry, createProjectFromFiles, createSingleFileProject, detectMainFile, disposeIframeBridge, extractNamespaces, fetchPackageJson, generateIframeBridgeScript, generateImportMap, generateNamespaceGlobals, getCdnBaseUrl, getCommonExports, getImageRegistry, injectNamespaceGlobals, isBareImport, loadImage, matchAlias, mountEmbedded, mountIframe, parseImageConfig, parseImageSpec, parseImportPath, parseManifest, parsePackageSpec, reloadEmbedded, reloadIframe, removeNamespaceGlobals, resolveEntry, safeParseImageConfig, safeParseManifest, setCdnBaseUrl, toEsmShUrl, vfsPlugin };