@frontmcp/ui 0.5.0 → 0.6.0

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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"}

package/esm/universal/UniversalApp.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Universal App Component
+ *
+ * Main entry point for the universal renderer.
+ * Handles loading states, error boundaries, and auto-detection.
+ */
+import React from 'react';
+import type { UniversalAppProps, FrontMCPState } from './types';
+/**
+ * Default loading spinner component.
+ */
+declare function LoadingSpinner(): React.ReactElement;
+/**
+ * Default error display component.
+ */
+declare function ErrorDisplay({ error }: {
+    error: string;
+}): React.ReactElement;
+/**
+ * Default empty state component.
+ */
+declare function EmptyState(): React.ReactElement;
+/**
+ * Universal App component.
+ *
+ * Main entry point for the universal renderer. Handles:
+ * - Loading states
+ * - Error display
+ * - Content auto-detection
+ * - Custom component injection
+ *
+ * @example Basic usage
+ * ```tsx
+ * function App() {
+ *   return (
+ *     <FrontMCPProvider>
+ *       <UniversalApp />
+ *     </FrontMCPProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example With custom content
+ * ```tsx
+ * const content: UniversalContent = {
+ *   type: 'markdown',
+ *   source: '# Hello World',
+ * };
+ *
+ * function App() {
+ *   return (
+ *     <FrontMCPProvider>
+ *       <UniversalApp content={content} />
+ *     </FrontMCPProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example With custom components
+ * ```tsx
+ * const components = {
+ *   WeatherCard: ({ temp }) => <div>{temp}°F</div>,
+ * };
+ *
+ * function App() {
+ *   return (
+ *     <FrontMCPProvider>
+ *       <UniversalApp components={components} />
+ *     </FrontMCPProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function UniversalApp({ content: contentOverride, components, fallback, errorFallback: ErrorFallback, }: UniversalAppProps): React.ReactElement;
+/**
+ * Props for the standalone UniversalAppWithProvider.
+ */
+interface StandaloneAppProps extends UniversalAppProps {
+    /** Initial store state */
+    initialState?: Partial<FrontMCPState>;
+}
+/**
+ * Standalone Universal App with built-in provider.
+ *
+ * Use this when you need a self-contained universal renderer
+ * without manually setting up the provider.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   return (
+ *     <UniversalAppWithProvider
+ *       initialState={{
+ *         toolName: 'get_weather',
+ *         output: { temperature: 72 },
+ *       }}
+ *       content={{
+ *         type: 'markdown',
+ *         source: '# Weather: {output.temperature}°F',
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function UniversalAppWithProvider({ initialState, components, ...appProps }: StandaloneAppProps): React.ReactElement;
+export { LoadingSpinner, ErrorDisplay, EmptyState };
+//# sourceMappingURL=UniversalApp.d.ts.map

package/esm/universal/UniversalApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalApp.d.ts","sourceRoot":"","sources":["../../../src/universal/UniversalApp.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAmC,aAAa,EAAE,MAAM,SAAS,CAAC;AAUjG;;GAEG;AACH,iBAAS,cAAc,IAAI,KAAK,CAAC,YAAY,CAQ5C;AAMD;;GAEG;AACH,iBAAS,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAWtE;AAMD;;GAEG;AACH,iBAAS,UAAU,IAAI,KAAK,CAAC,YAAY,CAQxC;AAuCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EAAE,eAAe,EACxB,UAAU,EACV,QAAQ,EACR,aAAa,EAAE,aAA4B,GAC5C,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CA+BxC;AAMD;;GAEG;AACH,UAAU,kBAAmB,SAAQ,iBAAiB;IACpD,0BAA0B;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,YAAY,EACZ,UAAU,EACV,GAAG,QAAQ,EACZ,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAQzC;AAMD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/esm/universal/cached-runtime.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Cached Runtime Builder
+ *
+ * Optimizes bundling by pre-building and caching the static runtime code.
+ * Separates "vendor" (static runtime) from "app" (user component) chunks.
+ *
+ * Benefits:
+ * - Runtime is built once and cached globally
+ * - Only user components need transpilation per request
+ * - Significantly reduces build time for repeated builds
+ */
+import type { CDNType, ContentSecurityOptions } from './types';
+/**
+ * Runtime cache configuration.
+ */
+interface RuntimeCacheConfig {
+    /** Maximum cache entries */
+    maxEntries?: number;
+    /** TTL in milliseconds (0 = forever) */
+    ttl?: number;
+}
+/**
+ * Placeholders for dynamic content injection.
+ * These are replaced at build time with actual content.
+ */
+export declare const RUNTIME_PLACEHOLDERS: {
+    /** Placeholder for transpiled component code */
+    readonly COMPONENT_CODE: "/*__FRONTMCP_COMPONENT_CODE__*/";
+    /** Placeholder for data injection */
+    readonly DATA_INJECTION: "/*__FRONTMCP_DATA_INJECTION__*/";
+    /** Placeholder for custom components */
+    readonly CUSTOM_COMPONENTS: "/*__FRONTMCP_CUSTOM_COMPONENTS__*/";
+};
+/**
+ * Options for cached runtime.
+ */
+export interface CachedRuntimeOptions {
+    /** CDN type (esm or umd) */
+    cdnType: CDNType;
+    /** Include markdown renderer */
+    includeMarkdown?: boolean;
+    /** Include MDX renderer */
+    includeMdx?: boolean;
+    /** Minify output */
+    minify?: boolean;
+    /** Content security / XSS protection options */
+    contentSecurity?: ContentSecurityOptions;
+}
+/**
+ * Result from getting cached runtime.
+ */
+export interface CachedRuntimeResult {
+    /** Pre-built vendor script (static runtime) */
+    vendorScript: string;
+    /** Template for app script (with placeholders) */
+    appTemplate: string;
+    /** CDN imports for head */
+    cdnImports: string;
+    /** Total size of vendor script */
+    vendorSize: number;
+    /** Whether this was from cache */
+    cached: boolean;
+    /** Cache key used */
+    cacheKey: string;
+}
+/**
+ * Get or build cached runtime.
+ *
+ * @param options - Runtime options
+ * @param config - Cache configuration
+ * @returns Cached runtime result
+ *
+ * @example
+ * ```typescript
+ * const runtime = getCachedRuntime({ cdnType: 'umd', includeMarkdown: true });
+ *
+ * // Replace placeholders with actual content
+ * const appScript = runtime.appTemplate
+ *   .replace(RUNTIME_PLACEHOLDERS.COMPONENT_CODE, transpiledCode)
+ *   .replace(RUNTIME_PLACEHOLDERS.DATA_INJECTION, dataScript);
+ * ```
+ */
+export declare function getCachedRuntime(options: CachedRuntimeOptions, config?: RuntimeCacheConfig): CachedRuntimeResult;
+/**
+ * Clear the runtime cache.
+ */
+export declare function clearRuntimeCache(): void;
+/**
+ * Get cache statistics.
+ */
+export declare function getRuntimeCacheStats(): {
+    entries: number;
+    totalSize: number;
+    keys: string[];
+};
+/**
+ * Build the complete app script by replacing placeholders.
+ *
+ * @param appTemplate - Template with placeholders
+ * @param componentCode - Transpiled component code (or empty string)
+ * @param dataInjection - Data injection script
+ * @param customComponents - Custom components script (or empty string)
+ * @returns Complete app script
+ */
+export declare function buildAppScript(appTemplate: string, componentCode: string, dataInjection: string, customComponents?: string): string;
+/**
+ * Build data injection code for the app script.
+ */
+export declare function buildDataInjectionCode(toolName: string, input: unknown, output: unknown, structuredContent: unknown, contentType: string, source: string | null, hasComponent: boolean): string;
+/**
+ * Build component wrapper code.
+ */
+export declare function buildComponentCode(transpiledCode: string): string;
+export {};
+//# sourceMappingURL=cached-runtime.d.ts.map

package/esm/universal/cached-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-runtime.d.ts","sourceRoot":"","sources":["../../../src/universal/cached-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAuB/D;;GAEG;AACH,UAAU,kBAAkB;IAC1B,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B,gDAAgD;;IAEhD,qCAAqC;;IAErC,wCAAwC;;CAEhC,CAAC;AAiDX;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAkgBD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,GAAE,kBAAuB,GAAG,mBAAmB,CAyEpH;AAqBD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAcA;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,SAAK,GACpB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,YAAY,EAAE,OAAO,GACpB,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAWjE"}