@frontmcp/ui 0.6.0 → 0.6.2

package/dependency/import-parser.d.ts

@@ -1,82 +0,0 @@
-/**
- * Import Parser
- *
- * Parses JavaScript/TypeScript source code to extract import statements.
- * Identifies external (npm) vs relative (local) imports.
- *
- * **Known Limitations:**
- * - Regex-based parsing may produce incorrect results for imports inside comments or strings
- * - Multi-line import statements with unusual formatting may not be detected
- * - Template literal imports (e.g., `import(\`${path}\`)`) are not supported
- * - For caching purposes, false positives are preferred over false negatives
- *
- * @packageDocumentation
- */
-import type { ParsedImport, 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.
- *
- * Extracts named, default, namespace, side-effect, and dynamic imports.
- * Also extracts re-exports that reference external modules.
- *
- * @param source - Source code to parse
- * @returns Parsed import result with categorized imports
- *
- * @example
- * ```typescript
- * const source = `
- *   import React from 'react';
- *   import { useState, useEffect } from 'react';
- *   import * as d3 from 'd3';
- *   import 'chart.js';
- *   import('./lazy-module');
- *   import { helper } from './utils';
- * `;
- *
- * const result = parseImports(source);
- * console.log(result.externalPackages);
- * // ['react', 'd3', 'chart.js', 'lazy-module']
- * ```
- */
-export declare function parseImports(source: string): ParsedImportResult;
-/**
- * Extract only external package names from source.
- *
- * This is a faster version when you only need package names.
- *
- * @param source - Source code to parse
- * @returns Array of unique external package names
- */
-export declare function extractExternalPackages(source: string): string[];
-/**
- * Filter imports to only include specified packages.
- *
- * @param result - Parsed import result
- * @param packages - Package names to include
- * @returns Filtered imports
- */
-export declare function filterImportsByPackages(result: ParsedImportResult, packages: string[]): ParsedImport[];
-/**
- * Get import statistics for a source file.
- *
- * @param source - Source code to analyze
- * @returns Import statistics
- */
-export declare function getImportStats(source: string): {
-    total: number;
-    external: number;
-    relative: number;
-    byType: Record<string, number>;
-    packages: string[];
-};
-//# sourceMappingURL=import-parser.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../src/dependency/import-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA6FhE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAaxD;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CA4K/D;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAMtG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAsBA"}

package/dependency/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * Dependency Resolution Module
- *
- * Provides CDN dependency resolution, import parsing, and file-based
- * component bundling support for FrontMCP UI widgets.
- *
- * @packageDocumentation
- */
-export { type CDNProvider, type CDNPlatformType, type CDNProviderConfig, type CDNDependency, type BundleTarget, type FileBundleOptions, type FileTemplateConfig, type ImportMap, type ResolvedDependency, type ComponentBuildManifest, type BuildCacheStorage, type CacheStats, type CDNRegistryEntry, type CDNRegistry, type DependencyResolverOptions, type ParsedImport, type ParsedImportResult, type TemplateMode, type TemplateFormat, type TemplateSource, type UrlFetchResult, type ResolvedTemplate, type TemplateProcessingOptions, type ProcessedTemplate, detectTemplateMode, detectFormatFromPath, } from './types';
-export { cdnProviderSchema, cdnPlatformTypeSchema, cdnDependencySchema, type CDNDependencyInput, type CDNDependencyOutput, bundleTargetSchema, fileBundleOptionsSchema, type FileBundleOptionsInput, type FileBundleOptionsOutput, fileTemplateConfigSchema, type FileTemplateConfigInput, type FileTemplateConfigOutput, importMapSchema, type ImportMapInput, type ImportMapOutput, resolvedDependencySchema, type ResolvedDependencyInput, type ResolvedDependencyOutput, componentBuildManifestSchema, buildManifestMetadataSchema, buildManifestOutputsSchema, type ComponentBuildManifestInput, type ComponentBuildManifestOutput, cdnProviderConfigSchema, cdnRegistryEntrySchema, packageMetadataSchema, type CDNRegistryEntryInput, type CDNRegistryEntryOutput, dependencyResolverOptionsSchema, type DependencyResolverOptionsInput, type DependencyResolverOptionsOutput, importTypeSchema, parsedImportSchema, parsedImportResultSchema, type ParsedImportInput, type ParsedImportOutput, type ParsedImportResultInput, type ParsedImportResultOutput, cacheStatsSchema, type CacheStatsInput, type CacheStatsOutput, type SafeParseResult, validateCDNDependency, safeParseCDNDependency, validateFileTemplateConfig, safeParseFileTemplateConfig, validateBuildManifest, safeParseBuildManifest, } from './schemas';
-export { DEFAULT_CDN_REGISTRY, CDN_PROVIDER_PRIORITY, lookupPackage, getPackageCDNUrl, getPackageCDNDependency, getRegisteredPackages, isPackageRegistered, mergeRegistries, getPackagePeerDependencies, resolveAllDependencies, } from './cdn-registry';
-export { parseImports, extractExternalPackages, filterImportsByPackages, getImportStats, getPackageName, } from './import-parser';
-export { DependencyResolver, createResolver, createClaudeResolver, createOpenAIResolver, resolveDependencies, generateImportMapForPackages, DependencyResolutionError, NoProviderError, } from './resolver';
-export { createImportMap, createImportMapFromOverrides, mergeImportMaps, addScope, generateImportMapScriptTag, generateImportMapScriptTagMinified, generateUMDShim, generateCDNScriptTags, generateESMScriptTags, generateDependencyHTML, validateImportMap, type UMDShimOptions, type DependencyHTMLOptions, } from './import-map';
-export { detectTemplateSource, isFileBasedTemplate, validateTemplateUrl, detectFormatFromUrl, fetchTemplateFromUrl, type FetchTemplateOptions, readTemplateFromFile, resolveFilePath, type ReadTemplateOptions, resolveTemplate, type ResolveTemplateOptions, getUrlCache, clearUrlCache, needsRefetch, invalidateUrlCache, } from './template-loader';
-export { processTemplate, processTemplates, supportsHandlebars, producesHtml, requiresBundling, processHtmlTemplate, processMarkdownTemplate, processMdxTemplate, clearHandlebarsCache, isMarkedAvailable, } from './template-processor';
-//# sourceMappingURL=index.d.ts.map

package/dependency/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dependency/index.ts"],"names":[],"mappings":"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"}

package/dependency/resolver.d.ts

@@ -1,164 +0,0 @@
-/**
- * Dependency Resolver
- *
- * Resolves external npm package imports to CDN URLs.
- * Handles platform-specific CDN selection and dependency ordering.
- *
- * @packageDocumentation
- */
-import type { CDNDependency, CDNPlatformType, CDNRegistry, DependencyResolverOptions, ResolvedDependency, ImportMap } from './types';
-/**
- * Error thrown when a dependency cannot be resolved.
- */
-export declare class DependencyResolutionError extends Error {
-    readonly packageName: string;
-    readonly reason: string;
-    constructor(packageName: string, reason: string);
-}
-/**
- * Error thrown when no CDN provider is available for a package.
- */
-export declare class NoProviderError extends DependencyResolutionError {
-    readonly platform: CDNPlatformType;
-    constructor(packageName: string, platform: CDNPlatformType);
-}
-/**
- * Dependency resolver for external npm packages.
- *
- * Resolves package imports to CDN URLs based on platform requirements
- * and dependency relationships.
- *
- * @example
- * ```typescript
- * const resolver = new DependencyResolver({
- *   platform: 'claude',
- * });
- *
- * // Resolve from source code
- * const source = `
- *   import React from 'react';
- *   import { Chart } from 'chart.js';
- * `;
- *
- * const resolved = await resolver.resolveFromSource(source, ['react', 'chart.js']);
- * console.log(resolved.map(d => d.cdnUrl));
- * ```
- */
-export declare class DependencyResolver {
-    private readonly options;
-    private readonly registry;
-    constructor(options?: DependencyResolverOptions);
-    /**
-     * Resolve a single package to its CDN dependency.
-     *
-     * @param packageName - NPM package name
-     * @param override - Optional explicit CDN dependency override
-     * @returns Resolved dependency, or null in non-strict mode if package is not found (should be bundled)
-     * @throws DependencyResolutionError if package cannot be resolved in strict mode
-     */
-    resolve(packageName: string, override?: CDNDependency): ResolvedDependency | null;
-    /**
-     * Resolve multiple packages.
-     *
-     * @param packageNames - Array of package names
-     * @param overrides - Optional explicit overrides for specific packages
-     * @returns Array of resolved dependencies (in dependency order)
-     */
-    resolveMany(packageNames: string[], overrides?: Record<string, CDNDependency>): ResolvedDependency[];
-    /**
-     * Resolve dependencies from source code.
-     *
-     * Parses the source to extract imports, then resolves external packages
-     * that are in the externals list.
-     *
-     * @param source - Source code to parse
-     * @param externals - Package names to resolve from CDN (others are bundled)
-     * @param overrides - Optional explicit CDN overrides
-     * @returns Resolved dependencies
-     */
-    resolveFromSource(source: string, externals: string[], overrides?: Record<string, CDNDependency>): ResolvedDependency[];
-    /**
-     * Generate an import map for resolved dependencies.
-     *
-     * @param dependencies - Resolved dependencies
-     * @returns Browser import map
-     */
-    generateImportMap(dependencies: ResolvedDependency[]): ImportMap;
-    /**
-     * Check if a package can be resolved for the current platform.
-     *
-     * @param packageName - Package name to check
-     * @returns true if the package can be resolved
-     */
-    canResolve(packageName: string): boolean;
-    /**
-     * Get the resolved CDN URL for a package.
-     *
-     * @param packageName - Package name
-     * @param override - Optional explicit override
-     * @returns CDN URL or undefined if cannot resolve
-     */
-    getUrl(packageName: string, override?: CDNDependency): string | undefined;
-    /**
-     * Get peer dependencies for a package.
-     */
-    getPeerDependencies(packageName: string): string[];
-    /**
-     * Create the current registry (default + custom).
-     */
-    getRegistry(): CDNRegistry;
-    /**
-     * Get the current platform.
-     */
-    getPlatform(): CDNPlatformType;
-    /**
-     * Create a resolved dependency object.
-     */
-    private createResolvedDependency;
-    /**
-     * Try to extract version from CDN URL.
-     */
-    private extractVersionFromUrl;
-}
-/**
- * Create a dependency resolver for a specific platform.
- *
- * @param platform - Target platform
- * @param options - Additional options
- * @returns Configured dependency resolver
- */
-export declare function createResolver(platform: CDNPlatformType, options?: Omit<DependencyResolverOptions, 'platform'>): DependencyResolver;
-/**
- * Create a Claude-compatible resolver.
- *
- * Only uses cdnjs.cloudflare.com for dependencies.
- */
-export declare function createClaudeResolver(options?: Omit<DependencyResolverOptions, 'platform'>): DependencyResolver;
-/**
- * Create an OpenAI-compatible resolver.
- *
- * Can use any CDN but prefers Cloudflare.
- */
-export declare function createOpenAIResolver(options?: Omit<DependencyResolverOptions, 'platform'>): DependencyResolver;
-/**
- * Resolve dependencies for a source file.
- *
- * Convenience function that creates a resolver and resolves in one call.
- *
- * @param source - Source code
- * @param externals - Package names to resolve from CDN
- * @param options - Resolver options
- * @returns Resolved dependencies
- */
-export declare function resolveDependencies(source: string, externals: string[], options?: DependencyResolverOptions): ResolvedDependency[];
-/**
- * Generate import map for dependencies.
- *
- * Convenience function that resolves and generates import map in one call.
- *
- * @param externals - Package names to include
- * @param options - Resolver options
- * @returns Import map
- */
-export declare function generateImportMapForPackages(externals: string[], options?: DependencyResolverOptions): ImportMap;
-//# sourceMappingURL=resolver.d.ts.map

package/dependency/resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/dependency/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAEf,WAAW,EACX,yBAAyB,EACzB,kBAAkB,EAClB,SAAS,EACV,MAAM,SAAS,CAAC;AAgBjB;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,WAAW,EAAE,MAAM;aAAkB,MAAM,EAAE,MAAM;gBAAnD,WAAW,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM;CAIhF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,yBAAyB;aACX,QAAQ,EAAE,eAAe;gBAA9D,WAAW,EAAE,MAAM,EAAkB,QAAQ,EAAE,eAAe;CAI3E;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;gBAE3B,OAAO,GAAE,yBAA8B;IAYnD;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;IAuCjF;;;;;;OAMG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,kBAAkB,EAAE;IAyBpG;;;;;;;;;;OAUG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACxC,kBAAkB,EAAE;IASvB;;;;;OAKG;IACH,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,SAAS;IAIhE;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IASxC;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;IASzE;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAIlD;;OAEG;IACH,WAAW,IAAI,WAAW;IAI1B;;OAEG;IACH,WAAW,IAAI,eAAe;IAI9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAe9B;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,GACpD,kBAAkB,CAKpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,GAAG,kBAAkB,CAE9G;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,GAAG,kBAAkB,CAE9G;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,kBAAkB,EAAE,CAGtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAIhH"}