@frontmcp/uipack 0.6.1

package/esm/typings/schemas.d.ts

@@ -0,0 +1,232 @@
+/**
+ * TypeScript Type Fetching Engine Schemas
+ *
+ * Zod validation schemas for type fetching configuration and results.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Schema for type fetch error codes.
+ */
+export declare const typeFetchErrorCodeSchema: z.ZodEnum<{
+    NETWORK_ERROR: "NETWORK_ERROR";
+    TIMEOUT: "TIMEOUT";
+    NO_TYPES_HEADER: "NO_TYPES_HEADER";
+    INVALID_SPECIFIER: "INVALID_SPECIFIER";
+    PACKAGE_NOT_FOUND: "PACKAGE_NOT_FOUND";
+    PARSE_ERROR: "PARSE_ERROR";
+}>;
+export type TypeFetchErrorCodeInput = z.input<typeof typeFetchErrorCodeSchema>;
+export type TypeFetchErrorCodeOutput = z.output<typeof typeFetchErrorCodeSchema>;
+/**
+ * Schema for a single type fetch result.
+ */
+export declare const typeFetchResultSchema: z.ZodObject<{
+    specifier: z.ZodString;
+    resolvedPackage: z.ZodString;
+    version: z.ZodString;
+    content: z.ZodString;
+    fetchedUrls: z.ZodArray<z.ZodString>;
+    fetchedAt: z.ZodString;
+}, z.core.$strict>;
+export type TypeFetchResultInput = z.input<typeof typeFetchResultSchema>;
+export type TypeFetchResultOutput = z.output<typeof typeFetchResultSchema>;
+/**
+ * Schema for a type fetch error.
+ */
+export declare const typeFetchErrorSchema: z.ZodObject<{
+    specifier: z.ZodString;
+    code: z.ZodEnum<{
+        NETWORK_ERROR: "NETWORK_ERROR";
+        TIMEOUT: "TIMEOUT";
+        NO_TYPES_HEADER: "NO_TYPES_HEADER";
+        INVALID_SPECIFIER: "INVALID_SPECIFIER";
+        PACKAGE_NOT_FOUND: "PACKAGE_NOT_FOUND";
+        PARSE_ERROR: "PARSE_ERROR";
+    }>;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TypeFetchErrorInput = z.input<typeof typeFetchErrorSchema>;
+export type TypeFetchErrorOutput = z.output<typeof typeFetchErrorSchema>;
+/**
+ * Schema for batch type fetch request.
+ */
+export declare const typeFetchBatchRequestSchema: z.ZodObject<{
+    imports: z.ZodArray<z.ZodString>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    maxConcurrency: z.ZodOptional<z.ZodNumber>;
+    skipCache: z.ZodOptional<z.ZodBoolean>;
+    versionOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export type TypeFetchBatchRequestInput = z.input<typeof typeFetchBatchRequestSchema>;
+export type TypeFetchBatchRequestOutput = z.output<typeof typeFetchBatchRequestSchema>;
+/**
+ * Schema for batch type fetch result.
+ */
+export declare const typeFetchBatchResultSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        specifier: z.ZodString;
+        resolvedPackage: z.ZodString;
+        version: z.ZodString;
+        content: z.ZodString;
+        fetchedUrls: z.ZodArray<z.ZodString>;
+        fetchedAt: z.ZodString;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodObject<{
+        specifier: z.ZodString;
+        code: z.ZodEnum<{
+            NETWORK_ERROR: "NETWORK_ERROR";
+            TIMEOUT: "TIMEOUT";
+            NO_TYPES_HEADER: "NO_TYPES_HEADER";
+            INVALID_SPECIFIER: "INVALID_SPECIFIER";
+            PACKAGE_NOT_FOUND: "PACKAGE_NOT_FOUND";
+            PARSE_ERROR: "PARSE_ERROR";
+        }>;
+        message: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    totalTimeMs: z.ZodNumber;
+    cacheHits: z.ZodNumber;
+    networkRequests: z.ZodNumber;
+}, z.core.$strict>;
+export type TypeFetchBatchResultInput = z.input<typeof typeFetchBatchResultSchema>;
+export type TypeFetchBatchResultOutput = z.output<typeof typeFetchBatchResultSchema>;
+/**
+ * Schema for a cache entry.
+ */
+export declare const typeCacheEntrySchema: z.ZodObject<{
+    result: z.ZodObject<{
+        specifier: z.ZodString;
+        resolvedPackage: z.ZodString;
+        version: z.ZodString;
+        content: z.ZodString;
+        fetchedUrls: z.ZodArray<z.ZodString>;
+        fetchedAt: z.ZodString;
+    }, z.core.$strict>;
+    cachedAt: z.ZodNumber;
+    size: z.ZodNumber;
+    accessCount: z.ZodNumber;
+}, z.core.$strict>;
+export type TypeCacheEntryInput = z.input<typeof typeCacheEntrySchema>;
+export type TypeCacheEntryOutput = z.output<typeof typeCacheEntrySchema>;
+/**
+ * Schema for cache statistics.
+ */
+export declare const typeCacheStatsSchema: z.ZodObject<{
+    entries: z.ZodNumber;
+    totalSize: z.ZodNumber;
+    hits: z.ZodNumber;
+    misses: z.ZodNumber;
+    hitRate: z.ZodNumber;
+}, z.core.$strict>;
+export type TypeCacheStatsInput = z.input<typeof typeCacheStatsSchema>;
+export type TypeCacheStatsOutput = z.output<typeof typeCacheStatsSchema>;
+/**
+ * Schema for import type.
+ */
+export declare const dtsImportTypeSchema: z.ZodEnum<{
+    import: "import";
+    export: "export";
+    reference: "reference";
+    "declare-module": "declare-module";
+}>;
+/**
+ * Schema for a parsed .d.ts import.
+ */
+export declare const dtsImportSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        import: "import";
+        export: "export";
+        reference: "reference";
+        "declare-module": "declare-module";
+    }>;
+    specifier: z.ZodString;
+    statement: z.ZodString;
+    line: z.ZodNumber;
+}, z.core.$strict>;
+export type DtsImportInput = z.input<typeof dtsImportSchema>;
+export type DtsImportOutput = z.output<typeof dtsImportSchema>;
+/**
+ * Schema for .d.ts parse result.
+ */
+export declare const dtsParseResultSchema: z.ZodObject<{
+    imports: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            import: "import";
+            export: "export";
+            reference: "reference";
+            "declare-module": "declare-module";
+        }>;
+        specifier: z.ZodString;
+        statement: z.ZodString;
+        line: z.ZodNumber;
+    }, z.core.$strict>>;
+    externalPackages: z.ZodArray<z.ZodString>;
+    relativeImports: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type DtsParseResultInput = z.input<typeof dtsParseResultSchema>;
+export type DtsParseResultOutput = z.output<typeof dtsParseResultSchema>;
+/**
+ * Schema for type fetcher options.
+ */
+export declare const typeFetcherOptionsSchema: z.ZodObject<{
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    maxConcurrency: z.ZodOptional<z.ZodNumber>;
+    cdnBaseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TypeFetcherOptionsInput = z.input<typeof typeFetcherOptionsSchema>;
+export type TypeFetcherOptionsOutput = z.output<typeof typeFetcherOptionsSchema>;
+/**
+ * Schema for package resolution result.
+ */
+export declare const packageResolutionSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    subpath: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    typesUrl: z.ZodString;
+}, z.core.$strict>;
+export type PackageResolutionInput = z.input<typeof packageResolutionSchema>;
+export type PackageResolutionOutput = z.output<typeof packageResolutionSchema>;
+/**
+ * Safe parse result type.
+ */
+export type SafeParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+/**
+ * Validate a batch request.
+ *
+ * @param data - Data to validate
+ * @returns Validated batch request or throws ZodError
+ */
+export declare function validateBatchRequest(data: unknown): TypeFetchBatchRequestOutput;
+/**
+ * Safely validate a batch request.
+ *
+ * @param data - Data to validate
+ * @returns Safe parse result with success flag
+ */
+export declare function safeParseBatchRequest(data: unknown): SafeParseResult<TypeFetchBatchRequestOutput>;
+/**
+ * Validate type fetcher options.
+ *
+ * @param data - Data to validate
+ * @returns Validated options or throws ZodError
+ */
+export declare function validateTypeFetcherOptions(data: unknown): TypeFetcherOptionsOutput;
+/**
+ * Safely validate type fetcher options.
+ *
+ * @param data - Data to validate
+ * @returns Safe parse result with success flag
+ */
+export declare function safeParseTypeFetcherOptions(data: unknown): SafeParseResult<TypeFetcherOptionsOutput>;
+//# sourceMappingURL=schemas.d.ts.map

package/esm/typings/schemas.d.ts.map

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

package/esm/typings/type-fetcher.d.ts

@@ -0,0 +1,89 @@
+/**
+ * TypeScript Type Fetcher
+ *
+ * Fetches TypeScript .d.ts files from esm.sh CDN based on import statements.
+ * Resolves dependencies recursively and combines them into a single output.
+ *
+ * @packageDocumentation
+ */
+import type { TypeFetchBatchRequest, TypeFetchBatchResult, TypeFetcherOptions } from './types';
+import type { TypeCacheAdapter } from './cache';
+/**
+ * TypeScript type fetcher for esm.sh CDN.
+ *
+ * Fetches .d.ts files based on import statements, resolves dependencies
+ * recursively, and combines them into single outputs per import.
+ *
+ * @example
+ * ```typescript
+ * const fetcher = new TypeFetcher({
+ *   maxDepth: 2,
+ *   timeout: 10000,
+ *   maxConcurrency: 5,
+ * });
+ *
+ * const result = await fetcher.fetchBatch({
+ *   imports: [
+ *     'import { Card } from "@frontmcp/ui/react"',
+ *     'import React from "react"',
+ *   ],
+ * });
+ *
+ * console.log(result.results[0].content); // Combined .d.ts for @frontmcp/ui
+ * ```
+ */
+export declare class TypeFetcher {
+    private readonly maxDepth;
+    private readonly timeout;
+    private readonly maxConcurrency;
+    private readonly cdnBaseUrl;
+    private readonly fetchFn;
+    private readonly cache;
+    constructor(options?: TypeFetcherOptions, cache?: TypeCacheAdapter);
+    /**
+     * Fetch types for a batch of import statements.
+     *
+     * @param request - Batch request configuration
+     * @returns Batch result with results and errors
+     */
+    fetchBatch(request: TypeFetchBatchRequest): Promise<TypeFetchBatchResult>;
+    /**
+     * Fetch types for a single import specifier.
+     */
+    private fetchTypesForSpecifier;
+    /**
+     * Resolve a package specifier to a types URL.
+     * Uses path fallback: try full path, then remove last segment until found.
+     */
+    private resolvePackage;
+    /**
+     * Recursively fetch .d.ts files.
+     */
+    private fetchRecursive;
+    /**
+     * Fetch with timeout support.
+     */
+    private fetchWithTimeout;
+}
+/**
+ * Create a new TypeFetcher instance.
+ *
+ * @param options - Fetcher configuration
+ * @param cache - Optional custom cache adapter
+ * @returns TypeFetcher instance
+ *
+ * @example
+ * ```typescript
+ * const fetcher = createTypeFetcher({
+ *   maxDepth: 2,
+ *   timeout: 10000,
+ *   maxConcurrency: 5,
+ * });
+ *
+ * const result = await fetcher.fetchBatch({
+ *   imports: ['import React from "react"'],
+ * });
+ * ```
+ */
+export declare function createTypeFetcher(options?: TypeFetcherOptions, cache?: TypeCacheAdapter): TypeFetcher;
+//# sourceMappingURL=type-fetcher.d.ts.map

package/esm/typings/type-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-fetcher.d.ts","sourceRoot":"","sources":["../../../src/typings/type-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAIV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAkDhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,OAAO,GAAE,kBAAuB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IAStE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmF/E;;OAEG;YACW,sBAAsB;IAgFpC;;;OAGG;YACW,cAAc;IA2C5B;;OAEG;YACW,cAAc;IA4F5B;;OAEG;YACW,gBAAgB;CAiB/B;AAyGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAErG"}

package/esm/typings/types.d.ts

@@ -0,0 +1,320 @@
+/**
+ * TypeScript Type Fetching Engine Types
+ *
+ * Type definitions for fetching and combining TypeScript .d.ts files
+ * from esm.sh CDN based on import statements.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Result of fetching types for a single import specifier.
+ *
+ * @example
+ * ```typescript
+ * const result: TypeFetchResult = {
+ *   specifier: '@frontmcp/ui/react',
+ *   resolvedPackage: '@frontmcp/ui',
+ *   version: '1.0.0',
+ *   content: '// Combined .d.ts content...',
+ *   fetchedUrls: ['https://esm.sh/v135/@frontmcp/ui@1.0.0/index.d.ts'],
+ *   fetchedAt: '2024-01-01T00:00:00.000Z',
+ * };
+ * ```
+ */
+export interface TypeFetchResult {
+    /**
+     * Original import specifier from the import statement.
+     *
+     * @example '@frontmcp/ui/react', 'react', 'lodash/debounce'
+     */
+    specifier: string;
+    /**
+     * Resolved package name (may differ from specifier due to path fallback).
+     *
+     * @example '@frontmcp/ui' when specifier was '@frontmcp/ui/react'
+     */
+    resolvedPackage: string;
+    /**
+     * Version of the package used for type fetching.
+     *
+     * @example '18.2.0', 'latest'
+     */
+    version: string;
+    /**
+     * Combined .d.ts content for this import.
+     * Includes all resolved dependencies combined into a single string.
+     */
+    content: string;
+    /**
+     * All URLs that were fetched to build this result.
+     * Useful for debugging and cache invalidation.
+     */
+    fetchedUrls: string[];
+    /**
+     * ISO timestamp when this result was fetched.
+     */
+    fetchedAt: string;
+}
+/**
+ * Error information for a failed type fetch.
+ */
+export interface TypeFetchError {
+    /**
+     * Original import specifier that failed.
+     */
+    specifier: string;
+    /**
+     * Error code for programmatic handling.
+     */
+    code: TypeFetchErrorCode;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * URL that caused the error (if applicable).
+     */
+    url?: string;
+}
+/**
+ * Error codes for type fetching failures.
+ */
+export type TypeFetchErrorCode = 'NETWORK_ERROR' | 'TIMEOUT' | 'NO_TYPES_HEADER' | 'INVALID_SPECIFIER' | 'PACKAGE_NOT_FOUND' | 'PARSE_ERROR';
+/**
+ * Request for fetching types for multiple imports.
+ *
+ * @example
+ * ```typescript
+ * const request: TypeFetchBatchRequest = {
+ *   imports: [
+ *     'import { Card } from "@frontmcp/ui/react"',
+ *     'import React from "react"',
+ *   ],
+ *   maxDepth: 2,
+ *   timeout: 10000,
+ *   maxConcurrency: 5,
+ * };
+ * ```
+ */
+export interface TypeFetchBatchRequest {
+    /**
+     * Array of import statements to process.
+     *
+     * @example ['import { Card } from "@frontmcp/ui/react"', 'import React from "react"']
+     */
+    imports: string[];
+    /**
+     * Maximum depth for recursive dependency resolution.
+     * Prevents infinite loops and limits network requests.
+     *
+     * @default 2
+     */
+    maxDepth?: number;
+    /**
+     * Timeout in milliseconds for each network request.
+     *
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Maximum concurrent network requests.
+     *
+     * @default 5
+     */
+    maxConcurrency?: number;
+    /**
+     * Skip the cache and fetch fresh types.
+     *
+     * @default false
+     */
+    skipCache?: boolean;
+    /**
+     * Version overrides for specific packages.
+     * Keys are package names, values are version strings.
+     *
+     * @example { 'react': '18.2.0', '@frontmcp/ui': '1.0.0' }
+     */
+    versionOverrides?: Record<string, string>;
+}
+/**
+ * Result of a batch type fetch operation.
+ */
+export interface TypeFetchBatchResult {
+    /**
+     * Successfully fetched type results.
+     */
+    results: TypeFetchResult[];
+    /**
+     * Errors encountered during fetching.
+     */
+    errors: TypeFetchError[];
+    /**
+     * Total time taken in milliseconds.
+     */
+    totalTimeMs: number;
+    /**
+     * Number of cache hits.
+     */
+    cacheHits: number;
+    /**
+     * Number of network requests made.
+     */
+    networkRequests: number;
+}
+/**
+ * Cache entry for a fetched type result.
+ */
+export interface TypeCacheEntry {
+    /**
+     * The cached type fetch result.
+     */
+    result: TypeFetchResult;
+    /**
+     * Timestamp when this entry was cached.
+     */
+    cachedAt: number;
+    /**
+     * Size of the content in bytes.
+     */
+    size: number;
+    /**
+     * Number of times this entry was accessed.
+     */
+    accessCount: number;
+}
+/**
+ * Cache statistics.
+ */
+export interface TypeCacheStats {
+    /**
+     * Number of entries in cache.
+     */
+    entries: number;
+    /**
+     * Total size of cached data in bytes.
+     */
+    totalSize: number;
+    /**
+     * Number of cache hits.
+     */
+    hits: number;
+    /**
+     * Number of cache misses.
+     */
+    misses: number;
+    /**
+     * Cache hit rate (0-1).
+     */
+    hitRate: number;
+}
+/**
+ * Import/export found in a .d.ts file.
+ */
+export interface DtsImport {
+    /**
+     * Type of import/export/reference.
+     */
+    type: 'import' | 'export' | 'reference' | 'declare-module';
+    /**
+     * Module specifier (package name or relative path).
+     *
+     * @example 'react', './types', '@types/node'
+     */
+    specifier: string;
+    /**
+     * Full statement as it appears in the .d.ts file.
+     */
+    statement: string;
+    /**
+     * Line number in source (1-indexed).
+     */
+    line: number;
+}
+/**
+ * Result of parsing a .d.ts file.
+ */
+export interface DtsParseResult {
+    /**
+     * All imports/exports/references found.
+     */
+    imports: DtsImport[];
+    /**
+     * External package dependencies (npm packages).
+     */
+    externalPackages: string[];
+    /**
+     * Relative imports (local .d.ts files).
+     */
+    relativeImports: string[];
+}
+/**
+ * Options for creating a TypeFetcher instance.
+ */
+export interface TypeFetcherOptions {
+    /**
+     * Maximum depth for recursive dependency resolution.
+     *
+     * @default 2
+     */
+    maxDepth?: number;
+    /**
+     * Timeout in milliseconds for each network request.
+     *
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Maximum concurrent network requests.
+     *
+     * @default 5
+     */
+    maxConcurrency?: number;
+    /**
+     * Base URL for esm.sh CDN.
+     *
+     * @default 'https://esm.sh'
+     */
+    cdnBaseUrl?: string;
+    /**
+     * Custom fetch function (for testing or proxying).
+     */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Result of resolving a package specifier.
+ */
+export interface PackageResolution {
+    /**
+     * Resolved package name.
+     *
+     * @example '@frontmcp/ui' when specifier was '@frontmcp/ui/react'
+     */
+    packageName: string;
+    /**
+     * Subpath within the package (if any).
+     *
+     * @example 'react' when specifier was '@frontmcp/ui/react'
+     */
+    subpath?: string;
+    /**
+     * Resolved version.
+     */
+    version: string;
+    /**
+     * URL for the TypeScript types.
+     */
+    typesUrl: string;
+}
+/**
+ * Default options for TypeFetcher.
+ */
+export declare const DEFAULT_TYPE_FETCHER_OPTIONS: Required<Omit<TypeFetcherOptions, 'fetch'>>;
+/**
+ * Cache key prefix for type cache entries.
+ */
+export declare const TYPE_CACHE_PREFIX = "types:";
+/**
+ * Default cache TTL in milliseconds (1 hour).
+ */
+export declare const DEFAULT_TYPE_CACHE_TTL: number;
+//# sourceMappingURL=types.d.ts.map

package/esm/typings/types.d.ts.map

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