@mweinbach/apple-docs-mcp 1.0.0

package/dist/utils/constants.js

@@ -0,0 +1,266 @@
+/**
+ * Configuration constants for Apple Docs MCP
+ */
+// API Limits - Optimized for agent context windows
+export const API_LIMITS = {
+    MAX_SEARCH_RESULTS: 15,
+    MAX_RELATED_APIS: 10,
+    MAX_REFERENCES: 50,
+    MAX_SIMILAR_APIS: 15,
+    MAX_FRAMEWORK_DEPTH: 10,
+    DEFAULT_FRAMEWORK_DEPTH: 3,
+    // Default values for various operations - reduced for agent optimization
+    DEFAULT_FRAMEWORK_SYMBOLS_LIMIT: 15,
+    DEFAULT_DOCUMENTATION_UPDATES_LIMIT: 15,
+    DEFAULT_TECHNOLOGY_OVERVIEWS_LIMIT: 15,
+    DEFAULT_SAMPLE_CODE_LIMIT: 15,
+    DEFAULT_TECHNOLOGIES_LIMIT: 25,
+    DEFAULT_REFERENCES_LIMIT: 10,
+    // Maximum values for schema validation - unchanged for power users
+    MAX_FRAMEWORK_SYMBOLS_LIMIT: 200,
+    MAX_DOCUMENTATION_UPDATES_LIMIT: 200,
+    MAX_TECHNOLOGY_OVERVIEWS_LIMIT: 200,
+    MAX_SAMPLE_CODE_LIMIT: 200,
+    MAX_TECHNOLOGIES_LIMIT: 500,
+    MAX_REFERENCES_LIMIT: 50,
+};
+// Search Depth Configuration
+export const SEARCH_DEPTH_LIMITS = {
+    shallow: 5,
+    medium: 10,
+    deep: 15,
+};
+// Cache TTL Configuration (in milliseconds)
+export const CACHE_TTL = {
+    API_DOCS: 30 * 60 * 1000, // 30 minutes
+    SEARCH_RESULTS: 10 * 60 * 1000, // 10 minutes
+    FRAMEWORK_INDEX: 60 * 60 * 1000, // 1 hour
+    TECHNOLOGIES: 2 * 60 * 60 * 1000, // 2 hours
+    UPDATES: 30 * 60 * 1000, // 30 minutes
+    SAMPLE_CODE: 2 * 60 * 60 * 1000, // 2 hours
+    TECHNOLOGY_OVERVIEWS: 2 * 60 * 60 * 1000, // 2 hours
+};
+// Cache Size Configuration
+export const CACHE_SIZE = {
+    API_DOCS: 500,
+    SEARCH_RESULTS: 200,
+    FRAMEWORK_INDEX: 100,
+    TECHNOLOGIES: 50,
+    UPDATES: 100,
+    SAMPLE_CODE: 100,
+    TECHNOLOGY_OVERVIEWS: 100,
+    // Default cache configuration
+    DEFAULT_CACHE_SIZE: 1000,
+    DEFAULT_CACHE_TTL: 30 * 60 * 1000, // 30 minutes
+};
+// Safari User-Agent Constants
+// Comprehensive collection of real Safari User-Agent strings covering different macOS versions and architectures
+export const SAFARI_USER_AGENTS = [
+    // macOS Monterey (12.x) + Safari 15.x - 3 versions
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15', // Intel Mac, macOS 12.7.6, Safari 15.6.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15', // Apple Silicon Mac, macOS 12.7.5, Safari 15.6.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15', // Intel Mac, macOS 12.7.4, Safari 15.6.1
+    // macOS Ventura (13.x) + Safari 16.x - 5 versions
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15', // Intel Mac, macOS 13.7.1, Safari 16.6.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15', // Apple Silicon Mac, macOS 13.7.0, Safari 16.6.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15', // Intel Mac, macOS 13.6.9, Safari 16.6.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15', // Apple Silicon Mac, macOS 13.6.8, Safari 16.6.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15', // Intel Mac, macOS 13.6.7, Safari 16.6.1
+    // macOS Sonoma (14.x) + Safari 17.x - 8 versions
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15', // Intel Mac, macOS 14.7.1, Safari 17.6.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15', // Apple Silicon Mac, macOS 14.7.1, Safari 17.6.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15', // Intel Mac, macOS 14.6.1, Safari 17.6.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15', // Apple Silicon Mac, macOS 14.6.1, Safari 17.6.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15', // Intel Mac, macOS 14.5, Safari 17.5
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15', // Apple Silicon Mac, macOS 14.5, Safari 17.5
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15', // Intel Mac, macOS 14.4.1, Safari 17.4.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15', // Apple Silicon Mac, macOS 14.4.1, Safari 17.4.1
+    // macOS Sequoia (15.x) + Safari 18.x - 6 versions
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15', // Intel Mac, macOS 15.1, Safari 18.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15', // Apple Silicon Mac, macOS 15.1, Safari 18.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15', // Intel Mac, macOS 15.0.1, Safari 18.0.1
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15', // Apple Silicon Mac, macOS 15.0.1, Safari 18.0.1
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15', // Intel Mac, macOS 15.0, Safari 18.0
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15', // Apple Silicon Mac, macOS 15.0, Safari 18.0
+    // macOS 26 Beta + Safari 19.x Beta - 3 versions
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15', // Apple Silicon Mac, macOS 26.0 Beta, Safari 19.0 Beta
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15', // Intel Mac, macOS 26.0 Beta, Safari 19.0 Beta
+    'Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15', // Apple Silicon Mac, macOS 26.1 Beta, Safari 19.1 Beta
+];
+// Categorized Safari User-Agent groups for easy selection
+export const SAFARI_USER_AGENT_CATEGORIES = {
+    monterey: SAFARI_USER_AGENTS.slice(0, 3), // macOS 12.x + Safari 15.x
+    ventura: SAFARI_USER_AGENTS.slice(3, 8), // macOS 13.x + Safari 16.x
+    sonoma: SAFARI_USER_AGENTS.slice(8, 16), // macOS 14.x + Safari 17.x
+    sequoia: SAFARI_USER_AGENTS.slice(16, 22), // macOS 15.x + Safari 18.x
+    beta: SAFARI_USER_AGENTS.slice(22, 25), // macOS 26.x + Safari 19.x Beta
+};
+// User-Agent validation and utility functions
+export const SAFARI_USER_AGENT_UTILS = {
+    // Regular expression to validate Safari User-Agent format
+    SAFARI_UA_REGEX: /^Mozilla\/5\.0 \(Macintosh; (Intel|arm64) Mac OS X (\d+)_(\d+)(?:_(\d+))?\) AppleWebKit\/([\d.]+) \(KHTML, like Gecko\) Version\/([\d.]+) Safari\/([\d.]+)$/,
+    /**
+     * Validates if a User-Agent string is a valid Safari format
+     * @param userAgent - The User-Agent string to validate
+     * @returns boolean indicating if the format is valid
+     */
+    isValidSafariUserAgent: (userAgent) => {
+        return SAFARI_USER_AGENT_UTILS.SAFARI_UA_REGEX.test(userAgent);
+    },
+    /**
+     * Extracts architecture from User-Agent string
+     * @param userAgent - The User-Agent string
+     * @returns 'Intel' | 'Apple Silicon' | null
+     */
+    getArchitecture: (userAgent) => {
+        const match = userAgent.match(SAFARI_USER_AGENT_UTILS.SAFARI_UA_REGEX);
+        if (!match) {
+            return null;
+        }
+        return match[1] === 'Intel' ? 'Intel' : 'Apple Silicon';
+    },
+    /**
+     * Extracts macOS version from User-Agent string
+     * @param userAgent - The User-Agent string
+     * @returns string representation of macOS version (e.g., "14.7.1")
+     */
+    getMacOSVersion: (userAgent) => {
+        const match = userAgent.match(SAFARI_USER_AGENT_UTILS.SAFARI_UA_REGEX);
+        if (!match) {
+            return null;
+        }
+        const [, , major, minor, patch] = match;
+        return patch ? `${major}.${minor}.${patch}` : `${major}.${minor}`;
+    },
+    /**
+     * Extracts Safari version from User-Agent string
+     * @param userAgent - The User-Agent string
+     * @returns string representation of Safari version (e.g., "17.6.1")
+     */
+    getSafariVersion: (userAgent) => {
+        const match = userAgent.match(SAFARI_USER_AGENT_UTILS.SAFARI_UA_REGEX);
+        if (!match) {
+            return null;
+        }
+        return match[6];
+    },
+    /**
+     * Gets a random Safari User-Agent from all available options
+     * @returns A random Safari User-Agent string
+     */
+    getRandomUserAgent: () => {
+        const randomIndex = Math.floor(Math.random() * SAFARI_USER_AGENTS.length);
+        return SAFARI_USER_AGENTS[randomIndex];
+    },
+    /**
+     * Gets a random Safari User-Agent from a specific category
+     * @param category - The category to select from
+     * @returns A random Safari User-Agent string from the specified category
+     */
+    getRandomUserAgentFromCategory: (category) => {
+        const userAgents = SAFARI_USER_AGENT_CATEGORIES[category];
+        const randomIndex = Math.floor(Math.random() * userAgents.length);
+        return userAgents[randomIndex];
+    },
+};
+// Request Configuration
+export const REQUEST_CONFIG = {
+    TIMEOUT: 30000, // 30 seconds
+    MAX_RETRIES: 3,
+    RETRY_DELAY: 1000, // 1 second
+    MAX_CONCURRENT_REQUESTS: 5,
+    USER_AGENT: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
+    // Default Safari User-Agent (latest stable)
+    DEFAULT_SAFARI_USER_AGENT: SAFARI_USER_AGENTS[19], // macOS 15.1, Safari 18.1, Apple Silicon
+};
+// Rate Limiting Configuration
+export const RATE_LIMIT = {
+    MAX_REQUESTS_PER_MINUTE: 100,
+    WINDOW_MS: 60000, // 1 minute
+};
+// Processing Limits Configuration
+export const PROCESSING_LIMITS = {
+    // Limits for slice operations in various tools
+    MAX_COLLECTIONS_TO_SHOW: 5,
+    MAX_RELATED_APIS_PER_SECTION: 3,
+    MAX_PLATFORM_COMPATIBILITY_ITEMS: 2,
+    MAX_SIMILAR_APIS_FOR_DEEP_SEARCH: 3,
+    MAX_TOPIC_IDENTIFIERS: 4,
+    MAX_DOC_FETCHER_RELATED_APIS: 10,
+    MAX_DOC_FETCHER_REFERENCES: 15,
+    MAX_DOC_FETCHER_SIMILAR_APIS: 8,
+    MAX_DOC_FETCHER_REFS_PER_TYPE: 5,
+    // Response time thresholds (milliseconds)
+    RESPONSE_TIME_GOOD_THRESHOLD: 1000,
+    RESPONSE_TIME_MODERATE_THRESHOLD: 3000,
+};
+// Apple Developer URLs
+export const APPLE_URLS = {
+    BASE: 'https://developer.apple.com',
+    SEARCH: 'https://developer.apple.com/search/',
+    DOCUMENTATION: 'https://developer.apple.com/documentation/',
+    TUTORIALS_DATA: 'https://developer.apple.com/tutorials/data/',
+    TECHNOLOGIES_JSON: 'https://developer.apple.com/tutorials/data/documentation/technologies.json',
+    UPDATES_JSON: 'https://developer.apple.com/tutorials/data/documentation/Updates.json',
+    UPDATES_INDEX_JSON: 'https://developer.apple.com/tutorials/data/index/updates',
+    TECHNOLOGY_OVERVIEWS_JSON: 'https://developer.apple.com/tutorials/data/documentation/TechnologyOverviews.json',
+    TECHNOLOGY_OVERVIEWS_INDEX_JSON: 'https://developer.apple.com/tutorials/data/index/technologyoverviews',
+    SAMPLE_CODE_JSON: 'https://developer.apple.com/tutorials/data/documentation/SampleCode.json',
+    SAMPLE_CODE_INDEX_JSON: 'https://developer.apple.com/tutorials/data/index/samplecode',
+};
+// WWDC URLs
+export const WWDC_URLS = {
+    BASE: 'https://developer.apple.com/videos',
+    TOPICS: 'https://developer.apple.com/videos/topics/',
+    YEAR_BASE: 'https://developer.apple.com/videos/wwdc',
+    PLAY_BASE: 'https://developer.apple.com/videos/play/wwdc',
+    // URL builders
+    getYearUrl: (year) => `https://developer.apple.com/videos/wwdc${year}/`,
+    getVideoUrl: (year, videoId) => `https://developer.apple.com/videos/play/wwdc${year}/${videoId}/`,
+    getCodeUrl: (year, videoId) => `https://developer.apple.com/videos/play/wwdc${year}/${videoId}/code`,
+    getTranscriptUrl: (year, videoId) => `https://developer.apple.com/videos/play/wwdc${year}/${videoId}/transcript`,
+    getResourcesUrl: (year, videoId) => `https://developer.apple.com/videos/play/wwdc${year}/${videoId}/resources`,
+    getTopicUrl: (topicId) => `https://developer.apple.com/videos/${topicId}/`,
+};
+// WWDC Configuration
+export const WWDC_CONFIG = {
+    // Year ranges
+    EARLIEST_YEAR: 2014,
+    LATEST_YEAR: 2025,
+    CODE_TAB_INTRODUCED_YEAR: 2022, // WWDC22 introduced separate code tabs
+    // Available years array
+    AVAILABLE_YEARS: ['2014', '2015', '2016', '2017', '2018', '2019', '2020', '2021', '2022', '2023', '2024', '2025'],
+    // Default limits - reduced for agent optimization
+    DEFAULT_VIDEO_LIMIT: 15,
+    DEFAULT_CODE_EXAMPLES_LIMIT: 10,
+    DEFAULT_SEARCH_LIMIT: 10,
+    DEFAULT_RELATED_VIDEOS_LIMIT: 10,
+    DEFAULT_TOPIC_VIDEOS_LIMIT: 10,
+    // Maximum limits - unchanged for power users
+    MAX_VIDEO_LIMIT: 200,
+    MAX_CODE_EXAMPLES_LIMIT: 100,
+    MAX_SEARCH_LIMIT: 100,
+    MAX_RELATED_VIDEOS_LIMIT: 50,
+    MAX_TOPIC_VIDEOS_LIMIT: 100,
+    // Processing limits
+    MIN_CODE_LENGTH: 10, // Minimum code length to consider valid
+    MAX_CONTEXT_MATCHES: 3, // Maximum matches per video in search results
+    MAX_TOPIC_VIDEOS_FOR_SCORING: 10, // Maximum videos to load for similarity scoring
+    // Cache TTL for WWDC data (in milliseconds)
+    CACHE_TTL: 60 * 60 * 1000, // 1 hour - increased since data is now bundled
+};
+// Error Messages
+export const ERROR_MESSAGES = {
+    INVALID_URL: 'URL must be from developer.apple.com',
+    FETCH_FAILED: 'Failed to fetch data from Apple Developer Documentation',
+    PARSE_FAILED: 'Failed to parse response data',
+    NOT_FOUND: 'Documentation not found (404). This URL may have been moved or removed.',
+    TIMEOUT: 'Request timed out. Please try again later.',
+    NETWORK_ERROR: 'Network error occurred. Please check your connection.',
+    RATE_LIMITED: 'Request rate limit exceeded. Please wait before trying again.',
+    API_ERROR: 'API error occurred while processing the request.',
+    CACHE_ERROR: 'Cache operation failed, but the request will continue.',
+    VALIDATION_ERROR: 'Input validation failed. Please check your parameters.',
+    SERVICE_UNAVAILABLE: 'Apple Developer Documentation service is temporarily unavailable.',
+};
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

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

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Unified error handling utilities
+ */
+import type { AppError, ErrorResponse } from '../types/error.js';
+import { ErrorType } from '../types/error.js';
+export type { AppError };
+export { ErrorType };
+/**
+ * Create a standardized error response
+ */
+export declare function createErrorResponse(error: AppError): ErrorResponse;
+/**
+ * Handle fetch errors with specific error types
+ */
+export declare function handleFetchError(error: unknown, url: string): AppError;
+/**
+ * Handle JSON parsing errors
+ */
+export declare function handleParseError(error: unknown): AppError;
+/**
+ * Validate input parameters
+ */
+export declare function validateInput(value: string, fieldName: string, minLength?: number): AppError | null;
+/**
+ * Log error for debugging (only in development)
+ */
+export declare function logError(error: AppError, context?: string): void;
+/**
+ * Handle generic errors and convert them to AppError
+ */
+export declare function handleGenericError(error: unknown, context: string, fallbackMessage?: string): AppError;
+/**
+ * Create a standardized error response with consistent formatting
+ */
+export declare function createStandardErrorResponse(error: unknown, operation: string): ErrorResponse;
+/**
+ * Wrap async functions with error handling
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, context: string, fallbackMessage?: string): Promise<T>;
+/**
+ * Validate multiple input parameters
+ */
+export declare function validateInputs(validations: Array<{
+    value: string;
+    fieldName: string;
+    minLength?: number;
+}>): AppError | null;
+/**
+ * Handle cache-related errors
+ */
+export declare function handleCacheError(error: unknown, operation: string): AppError;
+/**
+ * Recovery action for error responses
+ */
+export interface RecoveryAction {
+    tool: string;
+    args: Record<string, unknown>;
+    reason: string;
+}
+/**
+ * Tool-specific recovery actions - ready-to-use tool calls for error recovery
+ */
+export declare const TOOL_RECOVERY_ACTIONS: Record<string, Record<string, RecoveryAction>>;
+/**
+ * Tool-specific error suggestions
+ */
+export declare const TOOL_ERROR_SUGGESTIONS: Record<string, Record<string, string[]>>;
+/**
+ * Get tool-specific error suggestions
+ */
+export declare function getToolErrorSuggestions(toolName: string, errorType: ErrorType): string[];
+/**
+ * Get recovery action for a tool error
+ */
+export declare function getRecoveryAction(toolName: string, errorType: ErrorType): RecoveryAction | null;
+/**
+ * Create error response with tool-specific suggestions and recovery actions
+ */
+export declare function createToolErrorResponse(error: AppError, toolName: string): ErrorResponse;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI9C,YAAY,EAAE,QAAQ,EAAE,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAgBlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAmDtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAWzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,QAAQ,GAAG,IAAI,CAYtG;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,CAoEtG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAG5F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3E,QAAQ,GAAG,IAAI,CAQjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAU5E;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4DhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA+E3E,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CA6BxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAE/F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,GACf,aAAa,CA+Bf"}