@echortech/bot-widget 1.0.0

package/README.md

@@ -0,0 +1,145 @@
+# Spirit Bot Widget
+
+A type-safe widget library for integrating Spirit Bot into React and React Native applications. Published as a single package with platform-specific exports.
+
+## Installation
+
+```bash
+npm install @echortech/bot-widget
+```
+
+**Peer dependencies** (install what your platform needs):
+```bash
+# Web
+npm install react react-dom
+
+# Mobile
+npm install react react-native
+```
+
+## Quick Start
+
+### React (Web)
+
+```tsx
+import { ChatWidget, GreetingPopup } from '@echortech/bot-widget';
+
+export function App() {
+  return (
+    <ChatWidget
+      jwtToken={userToken}
+      firmId={firmId}
+      botUrl="https://spirit-bot-service.example.com"
+      onError={(err) => console.error(err)}
+    />
+  );
+}
+```
+
+### React Native (Mobile)
+
+```tsx
+import { ChatWidget, GreetingModal } from '@echortech/bot-widget/native';
+
+export function App() {
+  return (
+    <ChatWidget
+      jwtToken={userToken}
+      firmId={firmId}
+      botUrl="https://spirit-bot-service.example.com"
+      height={500}
+      onError={(err) => console.error(err)}
+    />
+  );
+}
+```
+
+### Core Only (API Client / Types)
+
+```ts
+import { BotAPIClient } from '@echortech/bot-widget/core';
+
+const client = new BotAPIClient(botUrl, jwtToken, firmId);
+const response = await client.sendMessage('Hello', chatId);
+```
+
+## Exports
+
+| Import Path | What You Get |
+|-------------|-------------|
+| `@echortech/bot-widget` | React web components + core (types, API client, utils) |
+| `@echortech/bot-widget/native` | React Native components + core |
+| `@echortech/bot-widget/core` | Core only (types, BotAPIClient, utilities) |
+
+## Components
+
+### Web (`@echortech/bot-widget`)
+
+- **`ChatWidget`** — Full chat interface with message history, auto-scroll, loading states, error display
+- **`GreetingPopup`** — Contextual greeting notifications with priority badges and action buttons
+
+### Mobile (`@echortech/bot-widget/native`)
+
+- **`ChatWidget`** — Mobile-optimized chat with `KeyboardAvoidingView` and gesture-friendly input
+- **`GreetingModal`** — Modal-based greeting with `TouchableOpacity` actions
+
+### Configuration (All Components)
+
+```typescript
+interface BotWidgetConfig {
+  jwtToken: string;          // JWT token for authentication
+  firmId: string;            // Firm ID header
+  botUrl: string;            // Base URL of Spirit Bot Service
+  chatId?: number;           // Chat session ID (default: 1001)
+  filingId?: string;         // Optional filing context
+  taxYear?: number;          // Optional tax year context
+  onError?: (error: BotAPIError) => void;
+  onSuccess?: (response: any) => void;
+}
+```
+
+## API Client
+
+The `BotAPIClient` handles all HTTP communication with the Spirit Bot Service:
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `sendMessage(message, chatId, context?)` | `POST /chat` | Send message, get bot response |
+| `getGreeting()` | `POST /greet` | Get contextual greeting |
+| `getDocumentsNeeded(chatId)` | `GET /filing/documents-needed` | List required documents |
+| `getFormPath(chatId)` | `GET /filing/form-path` | Get smart form structure |
+| `startIntake()` | `POST /filing/intake/start` | Start intake questionnaire |
+| `answerIntakeQuestion(sessionId, answer)` | `POST /filing/intake/answer` | Answer intake question |
+| `getProfile(chatId)` | `GET /filing/profile` | Get user profile |
+| `healthCheck()` | `GET /health` | Service health check |
+
+**Authentication**: JWT token in `Authorization: Bearer` header, firm ID in `x-firm-id` header — handled automatically.
+
+## Development
+
+```bash
+pnpm install          # Install dependencies
+pnpm build            # Build web + native
+pnpm build:web        # Build web only
+pnpm build:native     # Build native only
+pnpm test             # Run all tests (vitest + jest)
+pnpm test:web         # Run web + core tests only
+pnpm test:native      # Run React Native tests only
+pnpm type-check       # TypeScript type checking
+pnpm dev              # Watch mode
+```
+
+## Project Structure
+
+```
+src/
+  core/       # Types, BotAPIClient, utility functions (shared by both platforms)
+  web/        # React components + CSS (ChatWidget, GreetingPopup)
+  native/     # React Native components (ChatWidget, GreetingModal)
+```
+
+Both platforms compile separately (`tsconfig.web.json` / `tsconfig.native.json`) to handle different JSX modes, then output to `dist/web/` and `dist/native/`.
+
+## License
+
+MIT

package/dist/native/core/api-client.d.ts

@@ -0,0 +1,57 @@
+import { ChatResponse, GreetingResponse, DocumentsResponse, FormPathResponse, IntakeQuestion, UserProfile, HealthCheckResponse } from './types';
+export declare class BotAPIClient {
+    private client;
+    private baseUrl;
+    private jwtToken;
+    private firmId;
+    constructor(baseUrl: string, jwtToken: string, firmId: string);
+    /**
+     * Send a message to the bot and receive a response
+     */
+    sendMessage(message: string, chatId: number, context?: {
+        filing_id?: string;
+        tax_year?: number;
+    }): Promise<ChatResponse>;
+    /**
+     * Get a proactive greeting based on user's current state
+     */
+    getGreeting(): Promise<GreetingResponse>;
+    /**
+     * Get list of documents user needs to upload
+     */
+    getDocumentsNeeded(chatId: number): Promise<DocumentsResponse>;
+    /**
+     * Get smart form routing based on user's profile
+     */
+    getFormPath(chatId: number): Promise<FormPathResponse>;
+    /**
+     * Start the 7-question intake questionnaire
+     */
+    startIntake(): Promise<IntakeQuestion>;
+    /**
+     * Record an answer and get the next question
+     */
+    answerIntakeQuestion(sessionId: string, answer: string): Promise<IntakeQuestion>;
+    /**
+     * Get completed intake profile
+     */
+    getProfile(chatId: number): Promise<UserProfile>;
+    /**
+     * Check bot service and dependencies health
+     */
+    healthCheck(): Promise<HealthCheckResponse>;
+    /**
+     * Update JWT token (for token refresh scenarios)
+     */
+    setToken(token: string): void;
+    /**
+     * Update firm ID
+     */
+    setFirmId(firmId: string): void;
+    /**
+     * Handle API errors
+     */
+    private handleError;
+}
+export default BotAPIClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/native/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../src/core/api-client.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EAEd,WAAW,EACX,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAEjB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAc7D;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,YAAY,CAAC;IAqBxB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAmB9C;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkBpE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB5D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAmB5C;;OAEG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC;IAwB1B;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBtD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAejD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,CAAC,WAAW;CAsBpB;AAED,eAAe,YAAY,CAAC"}

package/dist/native/core/api-client.js

@@ -0,0 +1,196 @@
+import axios from 'axios';
+export class BotAPIClient {
+    constructor(baseUrl, jwtToken, firmId) {
+        this.baseUrl = baseUrl;
+        this.jwtToken = jwtToken;
+        this.firmId = firmId;
+        this.client = axios.create({
+            baseURL: baseUrl,
+            timeout: 10000,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    /**
+     * Send a message to the bot and receive a response
+     */
+    async sendMessage(message, chatId, context) {
+        try {
+            const request = {
+                message,
+                chatId,
+                context,
+            };
+            const response = await this.client.post('/chat', request, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Get a proactive greeting based on user's current state
+     */
+    async getGreeting() {
+        try {
+            const response = await this.client.post('/greet', {}, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Get list of documents user needs to upload
+     */
+    async getDocumentsNeeded(chatId) {
+        try {
+            const response = await this.client.get(`/filing/documents-needed?chatId=${chatId}`, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Get smart form routing based on user's profile
+     */
+    async getFormPath(chatId) {
+        try {
+            const response = await this.client.get(`/filing/form-path?chatId=${chatId}`, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Start the 7-question intake questionnaire
+     */
+    async startIntake() {
+        try {
+            const response = await this.client.post('/filing/intake/start', {}, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Record an answer and get the next question
+     */
+    async answerIntakeQuestion(sessionId, answer) {
+        try {
+            const request = {
+                session_id: sessionId,
+                answer,
+            };
+            const response = await this.client.post('/filing/intake/answer', request, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Get completed intake profile
+     */
+    async getProfile(chatId) {
+        try {
+            const response = await this.client.get(`/filing/profile?chatId=${chatId}`, {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Check bot service and dependencies health
+     */
+    async healthCheck() {
+        try {
+            const response = await this.client.get('/health', {
+                headers: {
+                    Authorization: `Bearer ${this.jwtToken}`,
+                    'x-firm-id': this.firmId,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error);
+        }
+    }
+    /**
+     * Update JWT token (for token refresh scenarios)
+     */
+    setToken(token) {
+        this.jwtToken = token;
+    }
+    /**
+     * Update firm ID
+     */
+    setFirmId(firmId) {
+        this.firmId = firmId;
+    }
+    /**
+     * Handle API errors
+     */
+    handleError(error) {
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            if (axiosError.response?.data) {
+                return axiosError.response.data;
+            }
+            return {
+                detail: axiosError.message || 'Unknown error occurred',
+                status_code: axiosError.response?.status || 500,
+                retry_after: axiosError.response?.headers['retry-after']
+                    ? parseInt(axiosError.response.headers['retry-after'])
+                    : undefined,
+            };
+        }
+        return {
+            detail: 'An unexpected error occurred',
+            status_code: 500,
+        };
+    }
+}
+export default BotAPIClient;
+//# sourceMappingURL=api-client.js.map

package/dist/native/core/api-client.js.map

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

package/dist/native/core/index.d.ts

@@ -0,0 +1,4 @@
+export type { ChatMessage, ChatRequest, ChatResponse, ChatContext, GreetingRequest, GreetingResponse, AlertAction, Document, DocumentsResponse, FormSection, FormPathResponse, IntakeQuestion, IntakeAnswerRequest, UserProfile, HealthCheckResponse, BotAPIError, BotWidgetConfig, } from './types';
+export { BotAPIClient, default } from './api-client';
+export { formatTimestamp, isTokenExpired, getErrorMessage, debounce, throttle, isValidToken, getPriorityColor, getPriorityLabel, truncateText, isMessageTooLong, formatProgress, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/native/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/native/core/index.js

@@ -0,0 +1,5 @@
+// Export API client
+export { BotAPIClient, default } from './api-client';
+// Export utilities
+export { formatTimestamp, isTokenExpired, getErrorMessage, debounce, throttle, isValidToken, getPriorityColor, getPriorityLabel, truncateText, isMessageTooLong, formatProgress, } from './utils';
+//# sourceMappingURL=index.js.map

package/dist/native/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAqBA,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAErD,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/native/core/types.d.ts

@@ -0,0 +1,109 @@
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp?: string;
+    toolCalls?: string[];
+    responseTimeMs?: number;
+}
+export interface ChatRequest {
+    message: string;
+    chatId: number;
+    context?: ChatContext;
+}
+export interface ChatResponse {
+    reply: string;
+    toolCalls: string[];
+    responseTimeMs: number;
+}
+export interface ChatContext {
+    filing_id?: string;
+    tax_year?: number;
+}
+export interface GreetingRequest {
+}
+export interface AlertAction {
+    label: string;
+    type: 'navigate' | 'chat' | 'external';
+    target?: string;
+    message?: string;
+}
+export interface GreetingResponse {
+    greeting: string;
+    priority: 1 | 2 | 3 | 4 | 5;
+    alert_type: 'action_required' | 'deadline' | 'status' | 'nudge' | 'tip';
+    actions: AlertAction[];
+    filing_context?: {
+        filing_id: string;
+        tax_year: number;
+    };
+}
+export interface Document {
+    type: string;
+    priority: number;
+    status: 'required' | 'optional';
+    description: string;
+    count_expected: number;
+    count_uploaded: number;
+    deadline: string;
+}
+export interface DocumentsResponse {
+    documents: Document[];
+    overall_progress: string;
+}
+export interface FormSection {
+    name: string;
+    status: 'completed' | 'in_progress' | 'not_started';
+    guidance: string;
+    estimated_time_minutes: number;
+}
+export interface FormPathResponse {
+    sections: FormSection[];
+}
+export interface IntakeQuestion {
+    question_number: number;
+    question: string;
+    options: string[];
+    session_id: string;
+}
+export interface IntakeAnswerRequest {
+    session_id: string;
+    answer: string;
+}
+export interface UserProfile {
+    income_sources: string[];
+    dependents: number;
+    home_owner: boolean;
+    rrsp_contributor: boolean;
+    charitable_donor: boolean;
+    capital_gains: boolean;
+    completed_at: string;
+}
+export interface HealthCheckResponse {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    services: {
+        vllm: boolean;
+        nestjs: boolean;
+        supabase: boolean;
+        redis: boolean;
+    };
+}
+export interface BotAPIError {
+    detail: string;
+    status_code: number;
+    retry_after?: number;
+}
+export interface BotWidgetConfig {
+    jwtToken: string;
+    firmId: string;
+    botUrl: string;
+    chatId?: number;
+    filingId?: string;
+    taxYear?: number;
+    theme?: 'light' | 'dark';
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    enableGreeting?: boolean;
+    enableChat?: boolean;
+    onError?: (error: BotAPIError) => void;
+    onSuccess?: (data: any) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/native/core/types.d.ts.map

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

package/dist/native/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/native/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/native/core/utils.d.ts

@@ -0,0 +1,46 @@
+import { BotAPIError } from './types';
+/**
+ * Format timestamp to readable format
+ */
+export declare function formatTimestamp(timestamp: string): string;
+/**
+ * Check if token is expired (basic check)
+ */
+export declare function isTokenExpired(token: string): boolean;
+/**
+ * Handle API error and return user-friendly message
+ */
+export declare function getErrorMessage(error: BotAPIError): string;
+/**
+ * Debounce function for API calls
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function for API calls
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Validate JWT token format
+ */
+export declare function isValidToken(token: string): boolean;
+/**
+ * Get priority color
+ */
+export declare function getPriorityColor(priority: 1 | 2 | 3 | 4 | 5): string;
+/**
+ * Get priority label
+ */
+export declare function getPriorityLabel(priority: 1 | 2 | 3 | 4 | 5): string;
+/**
+ * Truncate text to specified length
+ */
+export declare function truncateText(text: string, length: number): string;
+/**
+ * Check if message is too long
+ */
+export declare function isMessageTooLong(message: string, maxLength?: number): boolean;
+/**
+ * Format progress percentage
+ */
+export declare function formatProgress(progress: string): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/native/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKtC;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsB1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAUpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAUpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAEnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD"}