@aprovan/patchwork-compiler 0.1.2-dev.9d1cd22 → 0.1.2-dev.abe9883

package/dist/index.d.cts

@@ -222,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;
 }>>;
@@ -244,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;
     }>>;
@@ -274,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;
@@ -290,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;
@@ -422,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;
@@ -444,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;
@@ -629,9 +676,11 @@ declare class IndexedDBBackend implements FSProvider {
 
 interface HttpBackendConfig {
     baseUrl: string;
+    /** How often to poll for external changes, in milliseconds. Default: 7000. */
+    pollIntervalMs?: number;
 }
 /**
- * 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;
@@ -648,8 +697,8 @@ declare class HttpBackend implements FSProvider {
         recursive?: boolean;
     }): Promise<void>;
     exists(path: string): Promise<boolean>;
-    watch(path: string, callback: WatchCallback): () => void;
-    private startWatch;
+    watch(_path: string, callback: WatchCallback): () => void;
+    private startPoll;
     private url;
 }
 
@@ -832,4 +881,4 @@ declare function createIframeProxy(): Proxy;
  */
 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 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 };
+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

@@ -222,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;
 }>>;
@@ -244,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;
     }>>;
@@ -274,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;
@@ -290,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;
@@ -422,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;
@@ -444,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;
@@ -629,9 +676,11 @@ declare class IndexedDBBackend implements FSProvider {
 
 interface HttpBackendConfig {
     baseUrl: string;
+    /** How often to poll for external changes, in milliseconds. Default: 7000. */
+    pollIntervalMs?: number;
 }
 /**
- * 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;
@@ -648,8 +697,8 @@ declare class HttpBackend implements FSProvider {
         recursive?: boolean;
     }): Promise<void>;
     exists(path: string): Promise<boolean>;
-    watch(path: string, callback: WatchCallback): () => void;
-    private startWatch;
+    watch(_path: string, callback: WatchCallback): () => void;
+    private startPoll;
     private url;
 }
 
@@ -832,4 +881,4 @@ declare function createIframeProxy(): Proxy;
  */
 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 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 };
+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 };