@nathanvale/chatline 0.0.1

package/dist/ingest/ingest-csv.js

@@ -0,0 +1,300 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { parse } from 'csv-parse/sync';
+import { MessageSchema } from '../schema/message.js';
+/**
+ * Main entry point: Ingest CSV file and convert to unified Message schema
+ */
+export function ingestCSV(csvFilePath, options) {
+    const csvContent = readFileSync(csvFilePath, 'utf-8');
+    const rows = parse(csvContent, { columns: true });
+    const messages = [];
+    let lineNumber = 2; // Start at 2 (header is line 1)
+    for (const row of rows) {
+        const rowMessages = parseCSVRow(row, lineNumber, options);
+        messages.push(...rowMessages);
+        lineNumber++;
+    }
+    return messages;
+}
+/**
+ * Parse a single CSV row and produce 1-N messages
+ * Maps iMazing CSV format to unified Message schema
+ *
+ * AC01: Parse iMazing CSV rows with correct field mapping per CSV header
+ */
+export function parseCSVRow(row, lineNumber, options) {
+    const messages = [];
+    // Extract iMazing CSV fields (headers have spaces, not underscores)
+    const messageDate = row['Message Date'];
+    const deliveredDate = row['Delivered Date'];
+    const readDate = row['Read Date'];
+    const editedDate = row['Edited Date'];
+    const service = row.Service;
+    const type = row.Type;
+    const senderName = row['Sender Name'];
+    const senderID = row['Sender ID'];
+    const status = row.Status;
+    const text = row.Text;
+    const subject = row.Subject;
+    const attachment = row.Attachment;
+    const attachmentType = row['Attachment type'];
+    const replyingTo = row['Replying to'];
+    // AC03: Convert CSV dates to ISO 8601 UTC with Z suffix
+    const date = convertToISO8601(messageDate || '');
+    if (!date)
+        return []; // Skip rows with invalid dates
+    // AC02: Split rows into text/media/tapback/notification by analyzing content
+    // Determine messageKind and isFromMe from Type field
+    const isFromMe = type === 'Outgoing' || type === 'Sent';
+    let messageKind = 'text';
+    if (type === 'Notification') {
+        messageKind = 'notification';
+    }
+    // Base message object with common fields
+    const baseMessage = {
+        isFromMe,
+        date,
+    };
+    // Conditionally add optional fields to satisfy exactOptionalPropertyTypes
+    const handle = senderName || senderID;
+    if (handle)
+        baseMessage.handle = handle;
+    if (service)
+        baseMessage.service = service;
+    if (subject)
+        baseMessage.subject = subject;
+    if (readDate)
+        baseMessage.dateRead = convertToISO8601(readDate);
+    if (deliveredDate)
+        baseMessage.dateDelivered = convertToISO8601(deliveredDate);
+    if (editedDate) {
+        baseMessage.dateEdited = convertToISO8601(editedDate);
+        baseMessage.isEdited = true;
+    }
+    if (status === 'Read')
+        baseMessage.isRead = true;
+    else if (status === 'Unread')
+        baseMessage.isRead = false;
+    // AC05: Preserve row metadata (source, line number) for provenance
+    const baseExportMetadata = {
+        source: 'csv',
+        lineNumber,
+        csvGuid: `csv:${lineNumber}:0`,
+        ...(replyingTo && { replyingTo }),
+    };
+    // Create text message
+    if (messageKind === 'text' && text) {
+        const textMessage = {
+            ...baseMessage,
+            guid: `csv:${lineNumber}:0`,
+            messageKind: 'text',
+            text,
+            exportMetadata: baseExportMetadata,
+        };
+        messages.push(textMessage);
+    }
+    // AC04: Resolve iMazing attachment paths to absolute paths when files exist
+    if (attachment && attachment.trim() !== '') {
+        const resolvedPath = resolveAttachmentPath({ filename: attachment }, {
+            ...options,
+            messageDate: date,
+        });
+        // Only create media message if path can be resolved to absolute path (schema requirement)
+        if (resolvedPath) {
+            const mediaMessage = {
+                ...baseMessage,
+                guid: `csv:${lineNumber}:0:media`,
+                messageKind: 'media',
+                media: {
+                    id: `media:csv:${lineNumber}:0`,
+                    filename: attachment,
+                    path: resolvedPath,
+                    mimeType: attachmentType || undefined,
+                    mediaKind: inferMediaKind(attachmentType || ''),
+                },
+                exportMetadata: {
+                    ...baseExportMetadata,
+                    attachmentIndex: 0,
+                },
+            };
+            messages.push(mediaMessage);
+        }
+    }
+    // Create notification message if explicitly marked
+    if (messageKind === 'notification') {
+        const notificationMessage = {
+            ...baseMessage,
+            guid: `csv:${lineNumber}:0`,
+            messageKind: 'notification',
+            exportMetadata: baseExportMetadata,
+        };
+        messages.push(notificationMessage);
+    }
+    // Fallback: If no messages created but we have text, create text message
+    if (messages.length === 0 && text) {
+        const fallbackMessage = {
+            ...baseMessage,
+            guid: `csv:${lineNumber}:0`,
+            messageKind: 'text',
+            text,
+            exportMetadata: baseExportMetadata,
+        };
+        messages.push(fallbackMessage);
+    }
+    return messages;
+}
+/**
+ * Convert CSV date to ISO 8601 UTC with Z suffix
+ * Input format: "YYYY-MM-DD HH:MM:SS" (space-separated)
+ */
+export function convertToISO8601(csvDate) {
+    if (!csvDate || csvDate.trim() === '') {
+        return null;
+    }
+    try {
+        // Normalize: convert space to T (CSV uses space, ISO 8601 uses T)
+        const normalized = csvDate.trim().replace(' ', 'T');
+        // Basic validation: should contain date separators
+        if (!normalized.includes('-') && !normalized.includes('/')) {
+            return null;
+        }
+        // Append Z if not present (assuming UTC)
+        let isoString = normalized;
+        if (!normalized.includes('Z') && !normalized.match(/[+-]\d{2}:/)) {
+            isoString = `${normalized}Z`;
+        }
+        // Parse and validate
+        const date = new Date(isoString);
+        if (Number.isNaN(date.getTime())) {
+            return null;
+        }
+        // Return ISO 8601 with Z suffix
+        return date.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve attachment path to absolute path when file exists
+ */
+export function resolveAttachmentPath(attachment, options) {
+    if (!attachment)
+        return null;
+    const { attachmentRoots, messageDate } = options;
+    // If already absolute and exists, return it
+    if (attachment.copied_path?.startsWith('/')) {
+        if (existsSync(attachment.copied_path)) {
+            return attachment.copied_path;
+        }
+    }
+    // Expand tilde if present
+    if (attachment.copied_path?.startsWith('~')) {
+        const expanded = attachment.copied_path.replace('~', os.homedir());
+        if (existsSync(expanded)) {
+            return expanded;
+        }
+    }
+    // Search using timestamp pattern in attachment roots
+    if (messageDate && attachmentRoots.length > 0) {
+        const dateStr = formatDateForAttachmentSearch(messageDate);
+        const filename = attachment.filename || 'unknown';
+        const senderName = attachment.senderName || '*';
+        for (const root of attachmentRoots) {
+            // Try exact pattern: YYYY-MM-DD HH MM SS - SenderName - filename
+            const pattern = `${dateStr} - ${senderName} - ${filename}`;
+            const fullPath = path.join(root, pattern);
+            if (existsSync(fullPath)) {
+                return fullPath;
+            }
+            // Try wildcard pattern if sender name unknown
+            if (senderName === '*' && existsSync(root)) {
+                try {
+                    const files = readdirSync(root).filter((f) => {
+                        return f.includes(dateStr) && f.endsWith(filename);
+                    });
+                    if (files.length > 0 && files[0]) {
+                        return path.join(root, files[0]);
+                    }
+                }
+                catch {
+                    // Directory doesn't exist or can't be read
+                }
+            }
+        }
+    }
+    // Not found
+    return null;
+}
+/**
+ * Infer media kind from MIME type
+ */
+export function inferMediaKind(mimeType) {
+    if (!mimeType)
+        return 'unknown';
+    if (mimeType.startsWith('image/'))
+        return 'image';
+    if (mimeType.startsWith('audio/'))
+        return 'audio';
+    if (mimeType.startsWith('video/'))
+        return 'video';
+    if (mimeType.includes('pdf'))
+        return 'pdf';
+    return 'unknown';
+}
+/**
+ * Format ISO 8601 date for attachment search pattern
+ * Converts: 2023-10-23T06:52:57.000Z → 2023-10-23 06 52 57
+ */
+export function formatDateForAttachmentSearch(isoDate) {
+    try {
+        const date = new Date(isoDate);
+        const year = date.getUTCFullYear();
+        const month = String(date.getUTCMonth() + 1).padStart(2, '0');
+        const day = String(date.getUTCDate()).padStart(2, '0');
+        const hours = String(date.getUTCHours()).padStart(2, '0');
+        const minutes = String(date.getUTCMinutes()).padStart(2, '0');
+        const seconds = String(date.getUTCSeconds()).padStart(2, '0');
+        return `${year}-${month}-${day} ${hours} ${minutes} ${seconds}`;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Export envelope wrapper for CSV ingestion output
+ */
+export function createExportEnvelope(messages) {
+    return {
+        schemaVersion: '2.0.0',
+        source: 'csv',
+        createdAt: new Date().toISOString(),
+        messages,
+    };
+}
+/**
+ * Validate all messages pass schema validation
+ */
+export function validateMessages(messages) {
+    const errors = [];
+    for (let i = 0; i < messages.length; i++) {
+        const message = messages[i];
+        if (!message)
+            continue;
+        const result = MessageSchema.safeParse(message);
+        if (!result.success) {
+            errors.push({
+                index: i,
+                message,
+                issues: result.error.issues,
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=ingest-csv.js.map

package/dist/ingest/ingest-csv.js.map

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

package/dist/ingest/ingest-db.d.ts

@@ -0,0 +1,64 @@
+import type { ExportEnvelope, Message } from '../schema/message.js';
+export type DBMessage = {
+    guid: string;
+    rowid?: number;
+    text?: string | null;
+    is_from_me: number;
+    date: number;
+    chat_id?: string;
+    handle?: string;
+    service?: string;
+    subject?: string | null;
+    attachments?: DBAttachment[];
+    [key: string]: unknown;
+};
+export type DBAttachment = {
+    id: string;
+    filename: string;
+    mime_type?: string;
+    uti?: string | null;
+    copied_path?: string;
+    total_bytes?: number;
+    [key: string]: unknown;
+};
+export type IngestOptions = {
+    attachmentRoots: string[];
+};
+/**
+ * Split a single DB message into multiple Message objects
+ * - 1 text message (if text exists)
+ * - N media messages (one per attachment)
+ * All parts share same groupGuid (original DB guid) and timestamps
+ */
+export declare function splitDBMessage(dbMessage: DBMessage, lineNumber: number, _options: IngestOptions): Message[];
+/**
+ * Generate stable part GUID using format: p:<index>/<original_guid>
+ * This ensures:
+ * - Deterministic generation (same input → same output)
+ * - Stable ordering (index reflects order in split)
+ * - Uniqueness within a message's parts
+ */
+export declare function generatePartGUID(originalGuid: string, index: number): string;
+/**
+ * Convert Apple epoch timestamp to ISO 8601 UTC with Z suffix
+ * Apple epoch = seconds since 2001-01-01 00:00:00 UTC
+ *
+ * Handles:
+ * - Seconds precision: 718110777
+ * - Milliseconds precision: 718110777000
+ * - Nanoseconds precision: 718110777123456789 (truncate to seconds)
+ */
+export declare function convertAppleEpochToISO8601(appleEpoch: number): string | null;
+/**
+ * Infer media kind from MIME type
+ */
+export declare function inferMediaKind(mimeType: string): 'image' | 'audio' | 'video' | 'pdf' | 'unknown';
+/**
+ * Main entry point: Ingest DB messages and split into normalized schema
+ */
+export declare function ingestDBMessages(dbMessages: DBMessage[], options: IngestOptions): Message[];
+/**
+ * Create export envelope for DB ingestion output
+ */
+export declare function createExportEnvelope(messages: Message[]): ExportEnvelope;
+//# sourceMappingURL=ingest-db.d.ts.map

package/dist/ingest/ingest-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-db.d.ts","sourceRoot":"","sources":["../../src/ingest/ingest-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnE,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,YAAY,EAAE,CAAA;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AASD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,GACrB,OAAO,EAAE,CAyEX;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6B5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,MAAM,GACd,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CASjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE,aAAa,GACpB,OAAO,EAAE,CAWX;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAOxE"}

package/dist/ingest/ingest-db.js

@@ -0,0 +1,172 @@
+/**
+ * Apple epoch reference: seconds since 2001-01-01 00:00:00 UTC
+ * Unix epoch reference: seconds since 1970-01-01 00:00:00 UTC
+ * Difference: 31 years = 978307200 seconds
+ */
+const APPLE_EPOCH_OFFSET = 978307200;
+/**
+ * Split a single DB message into multiple Message objects
+ * - 1 text message (if text exists)
+ * - N media messages (one per attachment)
+ * All parts share same groupGuid (original DB guid) and timestamps
+ */
+export function splitDBMessage(dbMessage, lineNumber, _options) {
+    const messages = [];
+    const originalGuid = dbMessage.guid;
+    const attachments = dbMessage.attachments || [];
+    const date = convertAppleEpochToISO8601(dbMessage.date);
+    const isFromMe = dbMessage.is_from_me === 1;
+    if (!date)
+        return []; // Skip invalid dates
+    // Common fields for all parts
+    const baseMessage = {
+        isFromMe,
+        date,
+        groupGuid: originalGuid,
+    };
+    // Conditionally add optional fields to satisfy exactOptionalPropertyTypes
+    if (dbMessage.handle)
+        baseMessage.handle = dbMessage.handle;
+    if (dbMessage.chat_id)
+        baseMessage.chatId = dbMessage.chat_id;
+    if (dbMessage.service)
+        baseMessage.service = dbMessage.service;
+    if (dbMessage.subject)
+        baseMessage.subject = dbMessage.subject;
+    // Part index counter (0 = text, 1+ = media)
+    let partIndex = 0;
+    // 1. Create text message if text exists
+    if (dbMessage.text) {
+        const textMessage = {
+            ...baseMessage,
+            guid: generatePartGUID(originalGuid, partIndex),
+            messageKind: 'text',
+            text: dbMessage.text,
+            exportMetadata: {
+                source: 'db',
+                lineNumber,
+                parentGUID: originalGuid,
+                partIndex,
+            },
+        };
+        messages.push(textMessage);
+        partIndex++;
+    }
+    // 2. Create media messages for each attachment
+    attachments.forEach((att, attachmentIndex) => {
+        const mediaMessage = {
+            ...baseMessage,
+            guid: generatePartGUID(originalGuid, partIndex),
+            messageKind: 'media',
+            media: {
+                id: att.id || `media:${originalGuid}:${attachmentIndex}`,
+                filename: att.filename || 'unknown',
+                path: att.copied_path || null,
+                mimeType: att.mime_type || undefined,
+                uti: att.uti || undefined,
+                size: att.total_bytes || undefined,
+                mediaKind: inferMediaKind(att.mime_type || ''),
+            },
+            exportMetadata: {
+                source: 'db',
+                lineNumber,
+                parentGUID: originalGuid,
+                partIndex,
+                attachmentIndex,
+            },
+        };
+        messages.push(mediaMessage);
+        partIndex++;
+    });
+    return messages;
+}
+/**
+ * Generate stable part GUID using format: p:<index>/<original_guid>
+ * This ensures:
+ * - Deterministic generation (same input → same output)
+ * - Stable ordering (index reflects order in split)
+ * - Uniqueness within a message's parts
+ */
+export function generatePartGUID(originalGuid, index) {
+    return `p:${index}/${originalGuid}`;
+}
+/**
+ * Convert Apple epoch timestamp to ISO 8601 UTC with Z suffix
+ * Apple epoch = seconds since 2001-01-01 00:00:00 UTC
+ *
+ * Handles:
+ * - Seconds precision: 718110777
+ * - Milliseconds precision: 718110777000
+ * - Nanoseconds precision: 718110777123456789 (truncate to seconds)
+ */
+export function convertAppleEpochToISO8601(appleEpoch) {
+    try {
+        // Determine if input is in seconds, milliseconds, or nanoseconds
+        // Apple epoch realistic ranges:
+        // - Seconds: 0 to ~5,000,000,000 (2001 to ~2159)
+        // - Milliseconds: 0 to ~5,000,000,000,000 (2001 to ~2159)
+        // - Nanoseconds: anything > 1e15
+        let seconds;
+        if (appleEpoch > 1000000000000000) {
+            // Clearly nanoseconds (> 1 quadrillion)
+            seconds = Math.floor(appleEpoch / 1000000000);
+        }
+        else if (appleEpoch > 100000000000) {
+            // Likely milliseconds (> 100 billion, beyond realistic seconds range)
+            seconds = Math.floor(appleEpoch / 1000);
+        }
+        else {
+            // Seconds (includes values up to ~5 billion, covering years 2001-2159)
+            seconds = appleEpoch;
+        }
+        // Convert Apple epoch to Unix epoch
+        const unixSeconds = seconds + APPLE_EPOCH_OFFSET;
+        // Create Date and convert to ISO 8601
+        const date = new Date(unixSeconds * 1000);
+        return date.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Infer media kind from MIME type
+ */
+export function inferMediaKind(mimeType) {
+    if (!mimeType)
+        return 'unknown';
+    if (mimeType.startsWith('image/'))
+        return 'image';
+    if (mimeType.startsWith('audio/'))
+        return 'audio';
+    if (mimeType.startsWith('video/'))
+        return 'video';
+    if (mimeType.includes('pdf'))
+        return 'pdf';
+    return 'unknown';
+}
+/**
+ * Main entry point: Ingest DB messages and split into normalized schema
+ */
+export function ingestDBMessages(dbMessages, options) {
+    const messages = [];
+    let lineNumber = 1;
+    for (const dbMsg of dbMessages) {
+        const splitMessages = splitDBMessage(dbMsg, lineNumber, options);
+        messages.push(...splitMessages);
+        lineNumber++;
+    }
+    return messages;
+}
+/**
+ * Create export envelope for DB ingestion output
+ */
+export function createExportEnvelope(messages) {
+    return {
+        schemaVersion: '2.0.0',
+        source: 'db',
+        createdAt: new Date().toISOString(),
+        messages,
+    };
+}
+//# sourceMappingURL=ingest-db.js.map

package/dist/ingest/ingest-db.js.map

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

package/dist/ingest/link-replies-and-tapbacks.d.ts

@@ -0,0 +1,53 @@
+import type { Message } from '#schema/message';
+type ScoredCandidate = {
+    message: Message;
+    score: number;
+    reasons: string[];
+};
+type AmbiguousLink = {
+    messageGuid: string;
+    selectedTarget: string;
+    candidates: ScoredCandidate[];
+    tieCount: number;
+    confidenceScore: number;
+};
+type LinkingOptions = {
+    trackAmbiguous?: boolean;
+    minConfidenceThreshold?: number;
+};
+type LinkingResult = {
+    messages: Message[];
+    ambiguousLinks?: AmbiguousLink[];
+};
+/**
+ * AC01 + AC02: Link replies to their parent messages
+ *
+ * Primary: DB association_guid when present
+ * Fallback: Heuristics using timestamp and content matching
+ */
+export declare function linkRepliesToParents(messages: Message[], options?: LinkingOptions): Message[] | LinkingResult;
+/**
+ * AC03: Link tapbacks to their parent messages
+ *
+ * Primary: DB association_guid when present
+ * Fallback: Heuristics preferring media messages
+ */
+export declare function linkTapbacksToParents(messages: Message[], options?: LinkingOptions): Message[] | LinkingResult;
+/**
+ * AC04: Detect and report ambiguous links with confidence scores
+ */
+export declare function detectAmbiguousLinks(messages: Message[]): {
+    tieCount: number;
+    ambiguousMessages: {
+        messageGuid: string;
+        selectedTarget: string;
+        tieCount: number;
+        topCandidates: {
+            guid: string;
+            score: number;
+            reasons: string[];
+        }[];
+    }[];
+};
+export type { LinkingResult, AmbiguousLink };
+//# sourceMappingURL=link-replies-and-tapbacks.d.ts.map

package/dist/ingest/link-replies-and-tapbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-replies-and-tapbacks.d.ts","sourceRoot":"","sources":["../../src/ingest/link-replies-and-tapbacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAiB9C,KAAK,eAAe,GAAG;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,KAAK,aAAa,GAAG;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,KAAK,cAAc,GAAG;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAC/B,CAAA;AAED,KAAK,aAAa,GAAG;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAA;CAChC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,cAAmB,GAC1B,OAAO,EAAE,GAAG,aAAa,CAuF3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,cAAmB,GAC1B,OAAO,EAAE,GAAG,aAAa,CAkF3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE;;;;;;;;;;;;EA0BvD;AA2PD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAA"}