captify 0.1.15 → 0.1.17

package/dist/utils/file-download-utilities.d.ts

@@ -1,38 +0,0 @@
-/**
- * Client-side file download utilities
- * These functions are designed for browser environments to handle file downloads
- */
-/**
- * Downloads a file with progress tracking using the Fetch API
- * @param url - The URL to download from
- * @param fileName - The filename for the downloaded file
- * @param fileSize - Expected file size in bytes (for progress calculation)
- * @param signal - AbortSignal for cancellation support
- * @param onProgressUpdate - Callback for progress updates
- */
-export declare function downloadWithProgress(url: string, fileName: string, fileSize: number, signal: AbortSignal, onProgressUpdate: (percentage: number, loaded: number) => void): Promise<void>;
-/**
- * Triggers a direct download by creating and clicking an anchor element
- * @param url - The URL to download from
- * @param fileName - The filename for the downloaded file
- */
-export declare function triggerDirectDownload(url: string, fileName: string): void;
-/**
- * Check if an error is an abort error (from AbortController)
- * @param error - The error to check
- * @returns True if the error is an abort error
- */
-export declare function isAbortError(error: unknown): boolean;
-/**
- * Check if an error is a CORS-related error
- * @param error - The error to check
- * @returns True if the error appears to be CORS-related
- */
-export declare function isCorsError(error: unknown): boolean;
-/**
- * Maps download errors to user-friendly messages
- * @param error - The error to map
- * @returns A user-friendly error message
- */
-export declare function mapDownloadErrorMessage(error: Error): string;
-//# sourceMappingURL=file-download-utilities.d.ts.map

package/dist/utils/file-download-utilities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-download-utilities.d.ts","sourceRoot":"","sources":["../../lib/utils/file-download-utilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAC7D,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAezE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAUpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAenD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuB5D"}

package/dist/utils/file-download-utilities.js

@@ -1,129 +0,0 @@
-/**
- * Client-side file download utilities
- * These functions are designed for browser environments to handle file downloads
- */
-/**
- * Downloads a file with progress tracking using the Fetch API
- * @param url - The URL to download from
- * @param fileName - The filename for the downloaded file
- * @param fileSize - Expected file size in bytes (for progress calculation)
- * @param signal - AbortSignal for cancellation support
- * @param onProgressUpdate - Callback for progress updates
- */
-export async function downloadWithProgress(url, fileName, fileSize, signal, onProgressUpdate) {
-    var _a;
-    if (fileSize <= 0) {
-        throw new Error("Invalid file size: file size must be greater than 0.");
-    }
-    const response = await fetch(url, { signal });
-    if (!response.ok) {
-        throw new Error(`Download failed: ${response.status} ${response.statusText}`);
-    }
-    const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
-    if (!reader) {
-        throw new Error("Unable to read response body");
-    }
-    const chunks = [];
-    let receivedLength = 0;
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        chunks.push(value);
-        receivedLength += value.length;
-        const rawPercentage = (receivedLength / fileSize) * 100;
-        const percentage = Math.min(100, rawPercentage);
-        onProgressUpdate(percentage, receivedLength);
-    }
-    // Create blob and trigger download
-    const blob = new Blob(chunks);
-    const blobUrl = window.URL.createObjectURL(blob);
-    const link = document.createElement("a");
-    link.href = blobUrl;
-    link.download = fileName;
-    link.style.display = "none";
-    document.body.appendChild(link);
-    link.click();
-    document.body.removeChild(link);
-    window.URL.revokeObjectURL(blobUrl);
-}
-/**
- * Triggers a direct download by creating and clicking an anchor element
- * @param url - The URL to download from
- * @param fileName - The filename for the downloaded file
- */
-export function triggerDirectDownload(url, fileName) {
-    try {
-        const link = document.createElement("a");
-        link.href = url;
-        link.download = fileName;
-        link.style.display = "none";
-        link.rel = "noopener noreferrer";
-        document.body.appendChild(link);
-        link.click();
-        document.body.removeChild(link);
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        throw new Error(`Failed to trigger download: ${errorMessage}`);
-    }
-}
-/**
- * Check if an error is an abort error (from AbortController)
- * @param error - The error to check
- * @returns True if the error is an abort error
- */
-export function isAbortError(error) {
-    // DOMException with name 'AbortError' is the standard abort error
-    if (error instanceof DOMException && error.name === "AbortError") {
-        return true;
-    }
-    // Check error message for abort-related strings
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    return (errorMessage.toLowerCase().includes("aborted") || errorMessage.toLowerCase().includes("abort"));
-}
-/**
- * Check if an error is a CORS-related error
- * @param error - The error to check
- * @returns True if the error appears to be CORS-related
- */
-export function isCorsError(error) {
-    // First check if this is an abort error - not a CORS error
-    if (isAbortError(error)) {
-        return false;
-    }
-    // TypeError can indicate CORS issues (e.g., "Failed to fetch")
-    if (error instanceof TypeError) {
-        return true;
-    }
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    return (errorMessage.toLowerCase().includes("cors") || errorMessage.toLowerCase().includes("network"));
-}
-/**
- * Maps download errors to user-friendly messages
- * @param error - The error to map
- * @returns A user-friendly error message
- */
-export function mapDownloadErrorMessage(error) {
-    const message = error.message;
-    if (message.includes("403") || message.includes("Access denied")) {
-        return "You don't have permission to download this file.";
-    }
-    if (message.includes("404") || message.includes("not found")) {
-        return "File not found. It may have been deleted.";
-    }
-    if (message.includes("expired")) {
-        return "Download link expired. Please try again.";
-    }
-    if (message.includes("authenticated")) {
-        return "Please log in to download files.";
-    }
-    if (message.includes("tenant")) {
-        return "Access denied: File belongs to a different account.";
-    }
-    if (message.includes("aborted") || message.includes("AbortError")) {
-        return "Download was cancelled.";
-    }
-    return "Download failed. Please try again.";
-}
-//# sourceMappingURL=file-download-utilities.js.map

package/dist/utils/file-download-utilities.js.map

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

package/dist/utils/file-icons.d.ts

@@ -1,12 +0,0 @@
-/**
- * Returns an appropriate icon component based on the file's media type
- * @param mediaType - The MIME type of the file (e.g., "image/png", "application/pdf")
- * @returns A Lucide React icon component representing the file type
- *
- * @example
- * getFileIcon("image/png") // Returns <Image /> icon
- * getFileIcon("video/mp4") // Returns <Video /> icon
- * getFileIcon("application/zip") // Returns <Archive /> icon
- */
-export declare function getFileIcon(mediaType: string): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=file-icons.d.ts.map

package/dist/utils/file-icons.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-icons.d.ts","sourceRoot":"","sources":["../../lib/utils/file-icons.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,2CAQ5C"}

package/dist/utils/file-icons.js

@@ -1,25 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Archive, FileText, Image, Music, Video } from "lucide-react";
-/**
- * Returns an appropriate icon component based on the file's media type
- * @param mediaType - The MIME type of the file (e.g., "image/png", "application/pdf")
- * @returns A Lucide React icon component representing the file type
- *
- * @example
- * getFileIcon("image/png") // Returns <Image /> icon
- * getFileIcon("video/mp4") // Returns <Video /> icon
- * getFileIcon("application/zip") // Returns <Archive /> icon
- */
-export function getFileIcon(mediaType) {
-    if (mediaType.startsWith("image/"))
-        return _jsx(Image, { className: "size-4" });
-    if (mediaType.startsWith("video/"))
-        return _jsx(Video, { className: "size-4" });
-    if (mediaType.startsWith("audio/"))
-        return _jsx(Music, { className: "size-4" });
-    if (/^application\/(x-)?(tar|gzip|bzip2|xz|zstd|7z|zip)/.test(mediaType)) {
-        return _jsx(Archive, { className: "size-4" });
-    }
-    return _jsx(FileText, { className: "size-4" });
-}
-//# sourceMappingURL=file-icons.js.map

package/dist/utils/file-icons.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-icons.js","sourceRoot":"","sources":["../../lib/utils/file-icons.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAEtE;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAC,KAAK,IAAC,SAAS,EAAC,QAAQ,GAAG,CAAC;IACxE,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAC,KAAK,IAAC,SAAS,EAAC,QAAQ,GAAG,CAAC;IACxE,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAC,KAAK,IAAC,SAAS,EAAC,QAAQ,GAAG,CAAC;IACxE,IAAI,oDAAoD,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzE,OAAO,KAAC,OAAO,IAAC,SAAS,EAAC,QAAQ,GAAG,CAAC;IACxC,CAAC;IACD,OAAO,KAAC,QAAQ,IAAC,SAAS,EAAC,QAAQ,GAAG,CAAC;AACzC,CAAC"}

package/dist/utils/file-server-utilities.d.ts

@@ -1,21 +0,0 @@
-/**
- * Extracts filename from S3 key with extension preservation
- * @param key - S3 object key
- * @returns Filename with extension, or 'download' with detected extension
- */
-export declare function extractFilename(key: string): string;
-/**
- * Validates and normalizes an S3 key to prevent path traversal attacks
- * @param key - The S3 object key to validate
- * @param expectedPath - The expected path prefix the key must match
- * @returns Normalized key if valid, throws error if invalid
- */
-export declare function validateAndNormalizeKey(key: string, expectedPath: string): string;
-/**
- * Validates that user identifiers don't contain dangerous characters
- * @param userId - User ID to validate
- * @param tenantId - Tenant ID to validate
- * @throws Error if identifiers contain invalid characters
- */
-export declare function validateUserIdentifiers(userId: string, tenantId: string): void;
-//# sourceMappingURL=file-server-utilities.d.ts.map

package/dist/utils/file-server-utilities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-server-utilities.d.ts","sourceRoot":"","sources":["../../lib/utils/file-server-utilities.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAanD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAqEjF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU9E"}

package/dist/utils/file-server-utilities.js

@@ -1,107 +0,0 @@
-import { escapeRegex } from "./";
-/**
- * Normalizes a string by converting Unicode to NFKC form
- * This converts full-width characters to ASCII equivalents
- * @param str - String to normalize
- * @returns Normalized string
- */
-function normalizeUnicode(str) {
-    return str.normalize("NFKC");
-}
-/**
- * Extracts filename from S3 key with extension preservation
- * @param key - S3 object key
- * @returns Filename with extension, or 'download' with detected extension
- */
-export function extractFilename(key) {
-    const segments = key.split("/").filter((s) => s !== "");
-    if (segments.length > 0) {
-        return segments[segments.length - 1];
-    }
-    // Fallback: try to detect extension from key
-    const extensionMatch = key.match(/\.([a-zA-Z0-9]+)$/);
-    if (extensionMatch) {
-        return `download.${extensionMatch[1]}`;
-    }
-    return "download";
-}
-/**
- * Validates and normalizes an S3 key to prevent path traversal attacks
- * @param key - The S3 object key to validate
- * @param expectedPath - The expected path prefix the key must match
- * @returns Normalized key if valid, throws error if invalid
- */
-export function validateAndNormalizeKey(key, expectedPath) {
-    // Decode URL-encoded characters to catch encoded path traversal attempts
-    let decodedKey;
-    try {
-        decodedKey = decodeURIComponent(key);
-    }
-    catch (_a) {
-        // If decoding fails, the key contains invalid sequences
-        throw new Error("Access denied: Invalid file path - malformed encoding");
-    }
-    // Normalize Unicode to NFKC form
-    // This converts homoglyphs like full-width characters to ASCII equivalents
-    // e.g., ．．／ (full-width) becomes ../ (ASCII)
-    decodedKey = normalizeUnicode(decodedKey);
-    // Check for null bytes explicitly (avoids control character in regex)
-    if (decodedKey.includes("\0")) {
-        throw new Error("Access denied: Invalid file path - path traversal detected");
-    }
-    // Check for path traversal attempts
-    const dangerousPatterns = [
-        /\.\.\//, // ../
-        /\.\.\\/, // ..\
-        /\.\//, // ./
-        /\.\\/, // .\
-        /^\/+/, // Leading slashes
-        /\/\/+/, // Multiple consecutive slashes
-    ];
-    // Check the normalized key for dangerous patterns
-    for (const pattern of dangerousPatterns) {
-        if (pattern.test(decodedKey)) {
-            throw new Error("Access denied: Invalid file path - path traversal detected");
-        }
-    }
-    // Normalize the path using decoded key
-    const normalizedKey = decodedKey
-        .split("/")
-        .filter((segment) => segment !== "" && segment !== ".")
-        .join("/");
-    // Validate expectedPath before processing
-    if (!expectedPath || expectedPath.trim() === "") {
-        throw new Error("Access denied: Invalid file path - expected path is empty");
-    }
-    const normalizedExpectedPath = expectedPath
-        .split("/")
-        .filter((segment) => segment !== "" && segment !== ".")
-        .join("/");
-    // Validate that normalization didn't result in an empty path
-    if (normalizedExpectedPath === "") {
-        throw new Error("Access denied: Invalid file path - expected path is empty after normalization");
-    }
-    // Strict regex matching - escape special regex characters in expectedPath
-    const escapedPath = escapeRegex(normalizedExpectedPath);
-    const pathRegex = new RegExp(`^${escapedPath}(?:/|$)`);
-    if (!pathRegex.test(normalizedKey)) {
-        throw new Error("Access denied: File does not belong to your account");
-    }
-    return normalizedKey;
-}
-/**
- * Validates that user identifiers don't contain dangerous characters
- * @param userId - User ID to validate
- * @param tenantId - Tenant ID to validate
- * @throws Error if identifiers contain invalid characters
- */
-export function validateUserIdentifiers(userId, tenantId) {
-    const safePattern = /^[a-zA-Z0-9_-]+$/;
-    if (!safePattern.test(userId)) {
-        throw new Error("Access denied: Invalid user identifier");
-    }
-    if (!safePattern.test(tenantId)) {
-        throw new Error("Access denied: Invalid tenant identifier");
-    }
-}
-//# sourceMappingURL=file-server-utilities.js.map

package/dist/utils/file-server-utilities.js.map

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

package/dist/utils/file.d.ts

@@ -1,154 +0,0 @@
-/**
- * Formats a byte size into a human-readable string with appropriate units
- * @param bytes - The file size in bytes (must be non-negative)
- * @param decimals - Number of decimal places (default: 2)
- * @returns A formatted string with size and unit (e.g., "1.50 MB", "256 KB")
- * @throws {Error} If bytes is negative
- *
- * @example
- * formatFileSize(0) // Returns "0 B"
- * formatFileSize(1024) // Returns "1.00 KB"
- * formatFileSize(1536) // Returns "1.50 KB"
- * formatFileSize(1048576) // Returns "1.00 MB"
- * formatFileSize(1048576, 0) // Returns "1 MB"
- */
-export declare function formatFileSize(bytes: number, decimals?: number): string;
-/**
- * Returns a human-readable label for a file type based on its media type
- * @param mediaType - The MIME type of the file (e.g., "image/png", "application/pdf")
- * @returns A user-friendly label for the file type
- *
- * @example
- * getFileTypeLabel("image/png") // Returns "Image"
- * getFileTypeLabel("video/mp4") // Returns "Video"
- * getFileTypeLabel("application/pdf") // Returns "PDF"
- * getFileTypeLabel("application/zip") // Returns "Archive"
- */
-export declare function getFileTypeLabel(mediaType: string): string;
-/**
- * Sanitizes a filename to prevent security issues like XSS, path traversal, and invalid characters
- * @param filename - The filename to sanitize
- * @param maxLength - Maximum length (default: 255)
- * @returns Sanitized filename
- */
-export declare function sanitizeFilename(filename: string, maxLength?: number): string;
-/**
- * Sanitizes a filename for AWS Bedrock document attachments.
- * Bedrock has strict requirements for document names:
- * - Only alphanumeric characters, whitespace, hyphens, parentheses, and square brackets
- * - No consecutive whitespace characters
- * - NO PERIODS allowed (including file extensions)
- *
- * @param filename - The filename to sanitize
- * @param maxLength - Maximum length (default: 255)
- * @returns Bedrock-compatible document name (without extension)
- *
- * @example
- * sanitizeFilenameForBedrock("report@2024.pdf") // Returns "report-2024"
- * sanitizeFilenameForBedrock("my  file.pdf") // Returns "my file"
- * sanitizeFilenameForBedrock("data#export!.xlsx") // Returns "data-export"
- * sanitizeFilenameForBedrock("development guide.pdf") // Returns "development guide"
- */
-export declare function sanitizeFilenameForBedrock(filename: string, maxLength?: number): string;
-/**
- * Sanitizes filenames in UI message file parts for Bedrock compatibility.
- * Bedrock has strict filename requirements that need to be enforced before
- * sending messages to the LLM.
- *
- * This function also handles duplicate filenames by appending a numeric suffix
- * (e.g., "report", "report-2", "report-3") to ensure uniqueness across all
- * messages in the conversation.
- *
- * @param messages - Array of UI messages that may contain file parts
- * @returns Messages with sanitized and deduplicated filenames in file parts
- *
- * @example
- * const sanitized = sanitizeMessagesForBedrock(messages);
- * const modelMessages = convertToModelMessages(sanitized);
- */
-export declare function sanitizeMessagesForBedrock<T extends {
-    parts?: Array<{
-        type: string;
-        filename?: string;
-    }>;
-}>(messages: T[]): T[];
-/**
- * Calculate SHA-256 hash of file content.
- *
- * Uses the Web Crypto API to generate a unique identifier for file content.
- * This can be used for deduplication, caching, or integrity verification.
- *
- * @param file - The file or blob to hash
- * @returns A promise that resolves to a hex-encoded SHA-256 hash string
- *
- * @example
- * ```typescript
- * const file = new File(['hello'], 'test.txt');
- * const hash = await getFileHash(file);
- * console.log(hash); // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
- * ```
- *
- * @example
- * ```typescript
- * // Deduplication check
- * const hash = await getFileHash(newFile);
- * if (uploadedHashes.has(hash)) {
- *   console.log('File already uploaded');
- * }
- * ```
- */
-export declare function getFileHash(file: File | Blob): Promise<string>;
-/**
- * Extracts the display filename from an S3 key.
- * S3 keys typically have the format: {path}/{uuid}-{originalFilename}
- * This function strips the UUID prefix to get the original filename.
- *
- * @param key - The S3 object key
- * @param originalName - Optional original name from metadata (takes precedence if provided)
- * @returns The display filename
- *
- * @example
- * extractDisplayName("docs/550e8400-e29b-41d4-a716-446655440000-report.pdf")
- * // Returns "report.pdf"
- *
- * @example
- * extractDisplayName("docs/file.pdf", "My Report.pdf")
- * // Returns "My Report.pdf"
- */
-export declare function extractDisplayName(key: string, originalName?: string): string;
-/**
- * Downloads a file with progress tracking using the Fetch API
- * @param url - The URL to download from
- * @param fileName - The filename for the downloaded file
- * @param fileSize - Expected file size in bytes (for progress calculation)
- * @param signal - AbortSignal for cancellation support
- * @param onProgressUpdate - Callback for progress updates
- */
-export declare function downloadWithProgress(url: string, fileName: string, fileSize: number, signal: AbortSignal, onProgressUpdate: (percentage: number, loaded: number) => void): Promise<void>;
-/**
- * Triggers a direct download by creating and clicking an anchor element
- * Note: This only catches DOM manipulation errors. Browser download failures
- * occur asynchronously and won't be caught by this function.
- * @param url - The URL to download from
- * @param fileName - The filename for the downloaded file
- */
-export declare function triggerDirectDownload(url: string, fileName: string): void;
-/**
- * Check if an error is an abort error (from AbortController)
- * @param error - The error to check
- * @returns True if the error is an abort error
- */
-export declare function isAbortError(error: unknown): boolean;
-/**
- * Check if an error is a CORS-related error
- * @param error - The error to check
- * @returns True if the error appears to be CORS-related
- */
-export declare function isCorsError(error: unknown): boolean;
-/**
- * Maps download errors to user-friendly messages
- * @param error - The error to map
- * @returns A user-friendly error message
- */
-export declare function mapDownloadErrorMessage(error: Error): string;
-//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../lib/utils/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAa1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CA+BlF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAqC5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAChE,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAiEpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAc7E;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAC7D,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAezE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAUpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAenD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuB5D"}