@aprovan/patchwork-compiler 0.1.2-dev.ba8f277 → 0.1.2-dev.c680591

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;
@@ -695,11 +701,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
@@ -725,11 +731,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)
  */
@@ -742,7 +748,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.
  *
@@ -770,7 +776,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
  */
@@ -793,7 +799,7 @@ declare class ParentBridge {
     private pendingCalls;
     private iframes;
     private messageHandler;
-    constructor(proxy: ServiceProxy);
+    constructor(proxy: Proxy);
     /**
      * Register an iframe to receive messages from
      */
@@ -816,7 +822,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
  *
@@ -826,4 +832,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, type WatchCallback, type WatchEventType, 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_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, getImageRegistry, injectNamespaceGlobals, loadImage, mountEmbedded, mountIframe, parseImageConfig, parseImageSpec, parseManifest, reloadEmbedded, reloadIframe, removeNamespaceGlobals, resolveEntry, safeParseImageConfig, safeParseManifest, setCdnBaseUrl, 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;
@@ -695,11 +701,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
@@ -725,11 +731,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)
  */
@@ -742,7 +748,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.
  *
@@ -770,7 +776,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
  */
@@ -793,7 +799,7 @@ declare class ParentBridge {
     private pendingCalls;
     private iframes;
     private messageHandler;
-    constructor(proxy: ServiceProxy);
+    constructor(proxy: Proxy);
     /**
      * Register an iframe to receive messages from
      */
@@ -816,7 +822,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
  *
@@ -826,4 +832,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, type WatchCallback, type WatchEventType, 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_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, getImageRegistry, injectNamespaceGlobals, loadImage, mountEmbedded, mountIframe, parseImageConfig, parseImageSpec, parseManifest, reloadEmbedded, reloadIframe, removeNamespaceGlobals, resolveEntry, safeParseImageConfig, safeParseManifest, setCdnBaseUrl, vfsPlugin };

package/dist/index.js

@@ -707,7 +707,7 @@ function vfsPlugin(project, options = {}) {
 function generateMessageId() {
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
 }
-function createHttpServiceProxy(proxyUrl) {
+function createHttpProxy(proxyUrl) {
   return {
     async call(namespace, procedure, args) {
       const url = `${proxyUrl}/${namespace}/${procedure}`;
@@ -851,7 +851,7 @@ var ParentBridge = class {
     this.pendingCalls.clear();
   }
 };
-function createIframeServiceProxy() {
+function createIframeProxy() {
   const pendingCalls = /* @__PURE__ */ new Map();
   if (typeof window !== "undefined") {
     window.addEventListener("message", (event) => {
@@ -1477,13 +1477,15 @@ function disposeIframeBridge() {
 // src/compiler.ts
 var esbuildInitialized = false;
 var esbuildInitPromise = null;
-async function initEsbuild() {
+var DEFAULT_ESBUILD_WASM_URL = "https://unpkg.com/esbuild-wasm/esbuild.wasm";
+async function initEsbuild(urlOverrides) {
   if (esbuildInitialized) return;
   if (esbuildInitPromise) return esbuildInitPromise;
+  const wasmUrl = urlOverrides?.["esbuild-wasm/esbuild.wasm"] || DEFAULT_ESBUILD_WASM_URL;
   esbuildInitPromise = (async () => {
     try {
       await esbuild.initialize({
-        wasmURL: "https://unpkg.com/esbuild-wasm/esbuild.wasm"
+        wasmURL: wasmUrl
       });
       esbuildInitialized = true;
     } catch (error) {
@@ -1506,7 +1508,7 @@ function hashContent(content) {
   return Math.abs(hash).toString(16).padStart(8, "0");
 }
 async function createCompiler(options) {
-  await initEsbuild();
+  await initEsbuild(options.urlOverrides);
   const { image: imageSpec, proxyUrl, cdnBaseUrl: cdnBaseUrl3, widgetCdnBaseUrl } = options;
   if (cdnBaseUrl3) {
     setCdnBaseUrl(cdnBaseUrl3);
@@ -1518,7 +1520,7 @@ async function createCompiler(options) {
   }
   const registry = getImageRegistry();
   await registry.preload(imageSpec);
-  const proxy = createHttpServiceProxy(proxyUrl);
+  const proxy = createHttpProxy(proxyUrl);
   return new PatchworkCompiler(proxy, registry);
 }
 var PatchworkCompiler = class {
@@ -2715,8 +2717,8 @@ export {
   cdnTransformPlugin,
   createCompiler,
   createFieldAccessProxy,
-  createHttpServiceProxy,
-  createIframeServiceProxy,
+  createHttpProxy,
+  createIframeProxy,
   createImageRegistry,
   createProjectFromFiles,
   createSingleFileProject,