@frontmcp/uipack 0.12.2 → 1.0.0-beta.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@frontmcp/uipack",
-  "version": "0.12.2",
-  "description": "FrontMCP UIpack - Bundling, build tools, and platform adapters for MCP UI development (React-free core)",
+  "version": "1.0.0-beta.2",
+  "description": "FrontMCP UIpack - HTML shell builder, pluggable import resolver, and NPM component loader for MCP UI (React-free core)",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
   "license": "Apache-2.0",
@@ -9,10 +9,7 @@
     "mcp",
     "ui",
     "bundler",
-    "esbuild",
-    "swc",
-    "tailwind",
-    "htmx",
+    "template",
     "agentfront",
     "frontmcp",
     "framework",
@@ -58,12 +55,6 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "0.12.2",
-    "@swc/core": "^1.5.0",
-    "@enclave-vm/core": "^2.11.1",
-    "dompurify": "^3.3.1",
-    "esbuild": "^0.27.3",
-    "handlebars": "^4.7.8",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/resolver/cdn-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * CDN Registry
+ *
+ * Pre-configured CDN URLs for popular npm packages.
+ * Maps package names to their CDN URLs for different providers.
+ *
+ * @packageDocumentation
+ */
+import type { CDNRegistry, CDNRegistryEntry, CDNProvider } from './types';
+/**
+ * Built-in CDN registry for popular packages.
+ * esm.sh is prioritized as the primary CDN for ESM module loading.
+ */
+export declare const DEFAULT_CDN_REGISTRY: CDNRegistry;
+/**
+ * Look up a package in the CDN registry.
+ */
+export declare function lookupPackage(packageName: string, registry?: CDNRegistry): CDNRegistryEntry | undefined;
+/**
+ * Get the CDN URL for a package, trying providers in order.
+ */
+export declare function getPackageCDNUrl(packageName: string, providerOrder?: CDNProvider[], registry?: CDNRegistry): string | undefined;
+/**
+ * Get all registered package names.
+ */
+export declare function getRegisteredPackages(registry?: CDNRegistry): string[];
+/**
+ * Check if a package is in the registry.
+ */
+export declare function isPackageRegistered(packageName: string, registry?: CDNRegistry): boolean;
+/**
+ * Merge custom registry with the default registry.
+ */
+export declare function mergeRegistries(customRegistry: CDNRegistry): CDNRegistry;
+/**
+ * Get peer dependencies for a package.
+ */
+export declare function getPackagePeerDependencies(packageName: string, registry?: CDNRegistry): string[];
+//# sourceMappingURL=cdn-registry.d.ts.map

package/resolver/cdn-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-registry.d.ts","sourceRoot":"","sources":["../../src/resolver/cdn-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,WA4JlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,WAAkC,GAC3C,gBAAgB,GAAG,SAAS,CAE9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,WAAW,EAAkD,EAC5E,QAAQ,GAAE,WAAkC,GAC3C,MAAM,GAAG,SAAS,CAoBpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,WAAkC,GAAG,MAAM,EAAE,CAE5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAkC,GAAG,OAAO,CAE9G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAKxE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,WAAkC,GAC3C,MAAM,EAAE,CAYV"}

package/resolver/esm-sh.resolver.d.ts

@@ -0,0 +1,54 @@
+/**
+ * esm.sh Import Resolver
+ *
+ * Default resolver that uses esm.sh CDN for bare import specifiers.
+ * Falls back to the CDN registry for known packages.
+ *
+ * @packageDocumentation
+ */
+import type { ImportResolver, CDNRegistry, CDNProvider } from './types';
+/**
+ * Options for configuring the esm.sh resolver.
+ */
+export interface EsmShResolverOptions {
+    /** Base CDN URL for esm.sh fallback */
+    fallbackCdnBase?: string;
+    /** Custom CDN registry for known packages */
+    registry?: CDNRegistry;
+    /** Provider priority order */
+    providerOrder?: CDNProvider[];
+}
+/**
+ * Create the default esm.sh import resolver.
+ *
+ * Known packages (in CDN registry) use their registered CDN URL.
+ * Unknown packages fall back to `https://esm.sh/{specifier}`.
+ *
+ * @example
+ * ```typescript
+ * const resolver = createEsmShResolver();
+ * const result = resolver.resolve('react');
+ * // { value: 'https://esm.sh/react@18.3.1', type: 'url' }
+ * ```
+ */
+/**
+ * Create an import resolver that applies URL overrides before falling back to the base resolver.
+ *
+ * Supports exact matches and prefix matches:
+ * - Exact: `{ '@frontmcp/ui': 'http://localhost:5173/@frontmcp/ui' }`
+ * - Prefix: `@frontmcp/ui/components` matches `@frontmcp/ui` prefix → appends `/components`
+ *
+ * @example
+ * ```typescript
+ * const resolver = createResolverWithOverrides({
+ *   '@frontmcp/ui': 'http://localhost:5173/@frontmcp/ui',
+ * });
+ * resolver.resolve('@frontmcp/ui/components');
+ * // { value: 'http://localhost:5173/@frontmcp/ui/components', type: 'url' }
+ * ```
+ */
+export declare function createResolverWithOverrides(overrides: Record<string, string>, baseOptions?: EsmShResolverOptions): ImportResolver & {
+    overrides: Record<string, string>;
+};
+export declare function createEsmShResolver(options?: EsmShResolverOptions): ImportResolver;
+//# sourceMappingURL=esm-sh.resolver.d.ts.map

package/resolver/esm-sh.resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-sh.resolver.d.ts","sourceRoot":"","sources":["../../src/resolver/esm-sh.resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkC,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAIxG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;CAC/B;AAID;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,WAAW,CAAC,EAAE,oBAAoB,GACjC,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAmBxD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc,CAoEtF"}

package/resolver/import-map.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Import Map Generator
+ *
+ * Generates browser-compatible import maps from resolved imports.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap
+ * @packageDocumentation
+ */
+import type { ImportMap, ResolvedImport, ResolvedDependency } from './types';
+/**
+ * Create an import map from a record of specifier → ResolvedImport.
+ */
+export declare function createImportMapFromResolved(resolved: Record<string, ResolvedImport>): ImportMap;
+/**
+ * Create an import map from resolved dependencies.
+ */
+export declare function createImportMap(dependencies: ResolvedDependency[]): ImportMap;
+/**
+ * Merge multiple import maps into one.
+ */
+export declare function mergeImportMaps(...maps: ImportMap[]): ImportMap;
+/**
+ * Generate an HTML script tag for an import map.
+ */
+export declare function generateImportMapScriptTag(map: ImportMap): string;
+/**
+ * Generate a minified import map script tag.
+ */
+export declare function generateImportMapScriptTagMinified(map: ImportMap): string;
+/**
+ * Generate CDN script tags for non-ESM dependencies.
+ */
+export declare function generateCDNScriptTags(dependencies: ResolvedDependency[]): string[];
+/**
+ * Generate complete HTML for loading dependencies.
+ */
+export declare function generateDependencyHTML(dependencies: ResolvedDependency[], options?: {
+    minify?: boolean;
+}): string;
+/**
+ * Validate an import map structure.
+ */
+export declare function validateImportMap(map: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=import-map.d.ts.map

package/resolver/import-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-map.d.ts","sourceRoot":"","sources":["../../src/resolver/import-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7E;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,SAAS,CAiB/F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAe7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,SAAS,CAsB/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAGzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAWlF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,kBAAkB,EAAE,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAYrH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAwCpF"}

package/resolver/import-parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Import Parser
+ *
+ * Parses JavaScript/TypeScript source code to extract import statements.
+ * Identifies external (npm) vs relative (local) imports.
+ *
+ * @packageDocumentation
+ */
+import type { ParsedImportResult } from './types';
+/**
+ * Get the base package name from an import specifier.
+ *
+ * @example
+ * 'lodash' -> 'lodash'
+ * 'lodash/debounce' -> 'lodash'
+ * '@org/package' -> '@org/package'
+ * '@org/package/subpath' -> '@org/package'
+ */
+export declare function getPackageName(specifier: string): string;
+/**
+ * Parse all import statements from source code.
+ */
+export declare function parseImports(source: string): ParsedImportResult;
+/**
+ * Extract only external package names from source.
+ */
+export declare function extractExternalPackages(source: string): string[];
+//# sourceMappingURL=import-parser.d.ts.map

package/resolver/import-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../src/resolver/import-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAiChE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAWxD;AAoBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAwJ/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE"}

package/resolver/import-rewriter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Import Rewriter
+ *
+ * Rewrites bare import specifiers in source code using a pluggable ImportResolver.
+ *
+ * @packageDocumentation
+ */
+import type { ResolverOptions, RewriteImportsResult } from './types';
+/**
+ * Rewrite bare import specifiers in source code using the provided resolver.
+ *
+ * - Known packages are resolved via the resolver
+ * - Relative imports are left untouched
+ * - Node built-in imports are left untouched
+ *
+ * @example
+ * ```typescript
+ * const result = rewriteImports(`
+ *   import React from 'react';
+ *   import { helper } from './utils';
+ * `, { resolver: createEsmShResolver() });
+ *
+ * // result.code:
+ * // import React from 'https://esm.sh/react@18.3.1';
+ * // import { helper } from './utils';
+ * ```
+ */
+export declare function rewriteImports(source: string, options?: ResolverOptions): RewriteImportsResult;
+//# sourceMappingURL=import-rewriter.d.ts.map

package/resolver/import-rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../src/resolver/import-rewriter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAIrE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,oBAAoB,CAuElG"}

package/resolver/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolver Module
+ *
+ * Pluggable import resolution for bare specifiers.
+ * Default resolver uses esm.sh CDN with CDN registry for known packages.
+ *
+ * @packageDocumentation
+ */
+export type { ImportResolver, ResolveContext, ResolvedImport, ResolverOptions, CDNProvider, CDNDependency, CDNProviderConfig, CDNRegistryEntry, CDNRegistry, ImportMap, ResolvedDependency, ParsedImport, ParsedImportResult, RewriteImportsResult, } from './types';
+export { DEFAULT_CDN_REGISTRY, lookupPackage, getPackageCDNUrl, getRegisteredPackages, isPackageRegistered, mergeRegistries, getPackagePeerDependencies, } from './cdn-registry';
+export { createEsmShResolver, createResolverWithOverrides, type EsmShResolverOptions } from './esm-sh.resolver';
+export { parseImports, extractExternalPackages, getPackageName } from './import-parser';
+export { createImportMapFromResolved, createImportMap, mergeImportMaps, generateImportMapScriptTag, generateImportMapScriptTagMinified, generateCDNScriptTags, generateDependencyHTML, validateImportMap, } from './import-map';
+export { rewriteImports } from './import-rewriter';
+//# sourceMappingURL=index.d.ts.map

package/resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGhH,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGxF,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,kCAAkC,EAClC,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}