hazo_collab_forms 1.9.5 → 2.0.0

package/dist/lib/validation_handler.js

@@ -0,0 +1,341 @@
+/**
+ * Server-side validation route handler factory.
+ *
+ * Creates a POST handler that executes validation rules against uploaded documents
+ * using LLM analysis, and returns ClarificationItems for any issues found.
+ *
+ * Usage:
+ *   import { create_validation_route } from 'hazo_collab_forms/lib';
+ *   export const POST = create_validation_route();
+ *
+ * Uses standard Web API Request/Response for portability.
+ * hazo_llm_api is dynamically imported so it's only required at runtime.
+ */
+import 'server-only';
+import { DEFAULT_CLARIFICATION_TEMPLATES } from '../config/clarification_templates.js';
+import { DEFAULT_VALIDATION_PROMPT_SUFFIX } from '../config/defaults.js';
+import { get_config } from './config.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function generate_clarification_id() {
+    return `clr_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Extract has_issue and issue_description from a parsed JSON object.
+ * Supports both new format (validation_passed, validation_details) and
+ * legacy format (has_issue, issue_description).
+ */
+function extract_validation_fields(parsed) {
+    // Determine has_issue: prefer new `validation_passed` (inverted), fall back to legacy `has_issue`
+    const has_issue = 'validation_passed' in parsed
+        ? !parsed.validation_passed
+        : !!parsed.has_issue;
+    // Determine issue_description: prefer new `validation_details`, fall back to legacy names
+    const issue_description = parsed.validation_details ||
+        parsed.issue_description ||
+        parsed.description ||
+        parsed.issue ||
+        undefined;
+    return {
+        has_issue,
+        issue_description,
+        confidence: typeof parsed.confidence === 'number' ? parsed.confidence : undefined,
+    };
+}
+/**
+ * Parse LLM response for validation results.
+ * Supports new format: { validation_passed, validation_details, confidence }
+ * and legacy format: { has_issue, issue_description, confidence }
+ */
+function parse_validation_response(text) {
+    const cleaned = text.trim();
+    // Try direct parse
+    try {
+        const parsed = JSON.parse(cleaned);
+        return extract_validation_fields(parsed);
+    }
+    catch {
+        // Continue
+    }
+    // Strip markdown code fences
+    const fence_match = cleaned.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fence_match) {
+        try {
+            const parsed = JSON.parse(fence_match[1].trim());
+            return extract_validation_fields(parsed);
+        }
+        catch {
+            // Continue
+        }
+    }
+    // Try to find JSON in text
+    const json_match = cleaned.match(/\{[\s\S]*\}/);
+    if (json_match) {
+        try {
+            const parsed = JSON.parse(json_match[0]);
+            return extract_validation_fields(parsed);
+        }
+        catch {
+            // Continue
+        }
+    }
+    // Heuristic: if the text mentions "issue", "problem", "invalid", etc., consider it an issue
+    const issue_keywords = ['issue', 'problem', 'invalid', 'missing', 'incomplete', 'error', 'incorrect'];
+    const lower = cleaned.toLowerCase();
+    const has_issue = issue_keywords.some(k => lower.includes(k));
+    return {
+        has_issue,
+        issue_description: has_issue ? cleaned.slice(0, 500) : undefined,
+    };
+}
+function is_image_mime(mime_type) {
+    return mime_type.startsWith('image/');
+}
+function is_document_mime(mime_type) {
+    return mime_type === 'application/pdf';
+}
+/**
+ * Substitute {{variable}} placeholders in prompt text.
+ */
+function substitute_variables(prompt, variables) {
+    return prompt.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+        return variables[key] ?? `{{${key}}}`;
+    });
+}
+/**
+ * Build a validation prompt that wraps the rule prompt with a configurable response format suffix.
+ * Reads `[validation] prompt_suffix` from INI config, falling back to DEFAULT_VALIDATION_PROMPT_SUFFIX.
+ */
+function build_validation_prompt(rule_prompt) {
+    const suffix = get_config('validation', 'prompt_suffix') ?? DEFAULT_VALIDATION_PROMPT_SUFFIX;
+    return `You are a document validation assistant. Analyze the provided document according to the following rule and determine if there is an issue.
+
+VALIDATION RULE:
+${rule_prompt}
+
+${suffix}`;
+}
+/**
+ * Create a ClarificationItem from a validation rule result.
+ */
+function create_clarification_from_result(rule, result, doc_info) {
+    const template = rule.clarification_type !== 'none'
+        ? DEFAULT_CLARIFICATION_TEMPLATES[rule.clarification_type]
+        : null;
+    const response_options = rule.custom_response_options ??
+        template?.response_options ??
+        [];
+    return {
+        id: generate_clarification_id(),
+        type: rule.clarification_type,
+        status: 'pending',
+        target_field_id: rule.target_field_id,
+        target_label: rule.target_label,
+        rule_name: rule.name,
+        rule_id: rule.rule_id,
+        issue_description: rule.custom_issue_description ??
+            result.issue_description ??
+            template?.default_issue_description ??
+            'A validation issue was detected.',
+        validation_details: result.issue_description,
+        doc_references: doc_info ? [{
+                file_id: '', // Client enriches with actual file_id
+                file_name: doc_info.file_name,
+                mime_type: doc_info.mime_type,
+            }] : [],
+        action_description: rule.custom_action_description ??
+            template?.default_action_description,
+        response_options,
+        response_files: [],
+        created_at: new Date().toISOString(),
+    };
+}
+// ============================================================================
+// Route Handler Factory
+// ============================================================================
+/**
+ * Creates a POST route handler for document validation.
+ *
+ * The handler:
+ * 1. Validates the request payload
+ * 2. Fetches the file (inline or from URL)
+ * 3. Executes each validation rule against the document via LLM
+ * 4. Creates ClarificationItems for rules that find issues
+ * 5. Returns the results
+ */
+export function create_validation_route(options) {
+    const sqlite_path = options?.sqlite_path ?? 'data/prompt_library.sqlite';
+    const on_error = options?.on_error ?? ((err, ctx) => console.error(`[validation] ${ctx}:`, err));
+    // Cache the dynamic import
+    let llm_api_module = null;
+    let init_promise = null;
+    async function get_llm_api() {
+        if (!llm_api_module) {
+            try {
+                const module_id = 'hazo_llm_api/server';
+                llm_api_module = await import(/* webpackIgnore: true */ module_id);
+            }
+            catch {
+                throw new Error('hazo_llm_api is required for validation. Install it: npm install hazo_llm_api');
+            }
+        }
+        return llm_api_module;
+    }
+    async function ensure_initialized() {
+        const api = await get_llm_api();
+        if (!api.is_initialized()) {
+            if (!init_promise) {
+                init_promise = api.initialize_llm_api({ sqlite_path }).then(() => { });
+            }
+            await init_promise;
+        }
+    }
+    /**
+     * Execute a single validation rule against a document.
+     */
+    async function execute_rule(rule, file_b64, mime_type, variables) {
+        const api = await get_llm_api();
+        // Substitute variables in the prompt
+        const resolved_prompt = substitute_variables(rule.prompt, variables);
+        const full_prompt = build_validation_prompt(resolved_prompt);
+        // Call LLM
+        let llm_response;
+        if (is_image_mime(mime_type)) {
+            llm_response = await api.hazo_llm_image_text({
+                prompt: full_prompt,
+                image_b64: file_b64,
+                image_mime_type: mime_type,
+            });
+        }
+        else if (is_document_mime(mime_type)) {
+            llm_response = await api.hazo_llm_document_text({
+                prompt: full_prompt,
+                document_b64: file_b64,
+                document_mime_type: mime_type,
+            });
+        }
+        else {
+            // Fallback: treat as image
+            llm_response = await api.hazo_llm_image_text({
+                prompt: full_prompt,
+                image_b64: file_b64,
+                image_mime_type: mime_type,
+            });
+        }
+        if (!llm_response.success || !llm_response.text) {
+            return {
+                rule_id: rule.rule_id,
+                has_issue: false,
+                raw_response: llm_response.error ?? 'LLM call failed',
+            };
+        }
+        // Parse response
+        const parsed = parse_validation_response(llm_response.text);
+        return {
+            rule_id: rule.rule_id,
+            has_issue: parsed.has_issue,
+            issue_description: parsed.issue_description,
+            confidence: parsed.confidence,
+            raw_response: llm_response.text,
+        };
+    }
+    return async function POST(request) {
+        try {
+            const body = await request.json();
+            const { file_name, mime_type, download_url, file_b64: request_file_b64, rules, variables = {}, content_tag, } = body;
+            // Validate required fields
+            if (!rules?.length) {
+                return Response.json({
+                    success: false,
+                    clarifications: [],
+                    rule_results: [],
+                    errors: [{ rule_id: '', error: 'rules array is required and must not be empty' }],
+                }, { status: 400 });
+            }
+            // Initialize LLM API
+            await ensure_initialized();
+            // Get file as base64
+            let file_b64;
+            if (request_file_b64) {
+                file_b64 = request_file_b64;
+            }
+            else if (download_url) {
+                try {
+                    const absolute_url = download_url.startsWith('http')
+                        ? download_url
+                        : `${new URL(request.url).origin}${download_url}`;
+                    const file_response = await fetch(absolute_url);
+                    if (!file_response.ok) {
+                        throw new Error(`Failed to fetch file: ${file_response.status}`);
+                    }
+                    const buffer = Buffer.from(await file_response.arrayBuffer());
+                    file_b64 = buffer.toString('base64');
+                }
+                catch (err) {
+                    return Response.json({
+                        success: false,
+                        clarifications: [],
+                        rule_results: [],
+                        errors: [{ rule_id: '', error: `Failed to fetch file "${file_name}": ${err instanceof Error ? err.message : 'Unknown error'}` }],
+                    }, { status: 500 });
+                }
+            }
+            else {
+                return Response.json({
+                    success: false,
+                    clarifications: [],
+                    rule_results: [],
+                    errors: [{ rule_id: '', error: 'Either file_b64 or download_url is required' }],
+                }, { status: 400 });
+            }
+            // Add file context variables
+            const all_variables = {
+                ...variables,
+                document_name: file_name,
+                ...(content_tag ? { document_type: content_tag } : {}),
+            };
+            // Execute each rule
+            const rule_results = [];
+            const clarifications = [];
+            const errors = [];
+            for (const rule of rules) {
+                try {
+                    const result = await execute_rule(rule, file_b64, mime_type, all_variables);
+                    rule_results.push(result);
+                    if (result.has_issue && rule.clarification_type !== 'none') {
+                        const clarification = create_clarification_from_result(rule, result, { file_name, mime_type });
+                        clarifications.push(clarification);
+                    }
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : 'Unknown error';
+                    on_error(err, `rule ${rule.rule_id}: ${rule.name}`);
+                    errors.push({ rule_id: rule.rule_id, error: message });
+                    rule_results.push({
+                        rule_id: rule.rule_id,
+                        has_issue: false,
+                        raw_response: message,
+                    });
+                }
+            }
+            const response = {
+                success: errors.length === 0,
+                clarifications,
+                rule_results,
+                ...(errors.length > 0 ? { errors } : {}),
+            };
+            return Response.json(response);
+        }
+        catch (error) {
+            on_error(error, 'unhandled error');
+            return Response.json({
+                success: false,
+                clarifications: [],
+                rule_results: [],
+                errors: [{ rule_id: '', error: error instanceof Error ? error.message : 'Unknown error' }],
+            }, { status: 500 });
+        }
+    };
+}
+//# sourceMappingURL=validation_handler.js.map

package/dist/lib/validation_handler.js.map

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

package/dist/types/clarification.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Type definitions for Document Clarifications feature.
+ *
+ * Clarifications allow reviewers to flag document validation issues,
+ * reference relevant documents, and collect structured responses from clients.
+ */
+import type { FormFileAttachment } from './file_attachment.js';
+/** Clarification type - maps to templates */
+export type ClarificationType = 'none' | 'invalid_document' | 'additional_info_required';
+/** Lifecycle status of a clarification */
+export type ClarificationStatus = 'pending' | 'responded' | 'resolved' | 'dismissed';
+/** Reference to a document relevant to the clarification */
+export interface ClarificationDocReference {
+    /** hazo_files file ID */
+    file_id: string;
+    /** Display filename */
+    file_name: string;
+    /** MIME type for icon display */
+    mime_type: string;
+    /** Why this doc is referenced (optional reviewer comment) */
+    comment?: string;
+    /** Field this doc was originally uploaded to */
+    source_field_id?: string;
+}
+/** A radio option in the response (green) zone */
+export interface ClarificationResponseOption {
+    /** Value key for this option */
+    value: string;
+    /** User-visible label */
+    label: string;
+    /** Show file upload dropzone when this option is selected */
+    shows_file_upload?: boolean;
+    /** Show additional text input when this option is selected */
+    shows_additional_input?: boolean;
+}
+/** A single clarification item */
+export interface ClarificationItem {
+    /** Unique ID, prefixed 'clr_' */
+    id: string;
+    /** Clarification type (maps to template) */
+    type: ClarificationType;
+    /** Lifecycle status */
+    status: ClarificationStatus;
+    /** Field or group this clarification targets */
+    target_field_id: string;
+    /** Human-readable label for the target */
+    target_label: string;
+    /** Validation rule that triggered this (Phase 3) */
+    rule_name?: string;
+    /** Validation rule ID (Phase 3) */
+    rule_id?: string;
+    /** Description of the issue found */
+    issue_description: string;
+    /** Detailed validation result from LLM analysis (shown below issue_description) */
+    validation_details?: string;
+    /** Referenced documents relevant to this clarification */
+    doc_references: ClarificationDocReference[];
+    /** Description of what action the client should take */
+    action_description?: string;
+    /** Available response options (radio buttons) */
+    response_options: ClarificationResponseOption[];
+    /** Client's selected response option value */
+    response_choice?: string;
+    /** Client's free-text comment */
+    user_comment?: string;
+    /** Files uploaded as part of the response */
+    response_files: FormFileAttachment[];
+    /** ISO timestamp when created */
+    created_at: string;
+    /** ISO timestamp of last update */
+    updated_at?: string;
+    /** User ID who created this clarification */
+    created_by?: string;
+    /** User ID who responded */
+    responded_by?: string;
+    /** User ID who resolved */
+    resolved_by?: string;
+}
+/** Template definition for a clarification type */
+export interface ClarificationTemplate {
+    /** Template type key */
+    type: ClarificationType;
+    /** Human-readable name */
+    display_name: string;
+    /** Default issue description (pre-filled in grey zone) */
+    default_issue_description?: string;
+    /** Default action description (pre-filled in green zone) */
+    default_action_description?: string;
+    /** Available response options for this template */
+    response_options: ClarificationResponseOption[];
+    /** Whether to show the comment textarea */
+    enable_comment: boolean;
+    /** Whether to show doc reference list */
+    show_doc_references: boolean;
+}
+/** Response payload when a client submits a clarification response */
+export interface ClarificationResponse {
+    /** Selected response option value */
+    response_choice?: string;
+    /** Free-text comment */
+    user_comment?: string;
+    /** Uploaded response files */
+    response_files?: FormFileAttachment[];
+}
+/** Consumer-provided callbacks for clarification lifecycle */
+export interface ClarificationCallbacks {
+    /** Called when client submits a response to a clarification */
+    on_respond?: (clarification_id: string, response: ClarificationResponse) => void;
+    /** Called when reviewer resolves a clarification */
+    on_resolve?: (clarification_id: string) => void;
+    /** Called when reviewer dismisses a clarification */
+    on_dismiss?: (clarification_id: string) => void;
+    /** Called when reviewer re-opens a resolved/dismissed clarification */
+    on_reopen?: (clarification_id: string) => void;
+    /** Called when a doc reference is deleted from a clarification */
+    on_doc_delete?: (clarification_id: string, file_id: string) => void;
+}
+/** Summary counts for clarifications */
+export interface ClarificationCounts {
+    pending: number;
+    responded: number;
+    resolved: number;
+    dismissed: number;
+    total: number;
+}
+//# sourceMappingURL=clarification.d.ts.map

package/dist/types/clarification.d.ts.map

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

package/dist/types/clarification.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for Document Clarifications feature.
+ *
+ * Clarifications allow reviewers to flag document validation issues,
+ * reference relevant documents, and collect structured responses from clients.
+ */
+export {};
+//# sourceMappingURL=clarification.js.map

package/dist/types/clarification.js.map

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

package/dist/types/doc_link.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Document link types for file attachment references
+ */
+/**
+ * Supported document types for DocLink
+ */
+export type DocLinkType = "pdf" | "image" | "document" | "other";
+/**
+ * Document link configuration
+ */
+export interface DocLink {
+    /** Document type - determines how it's displayed */
+    type: DocLinkType;
+    /** URL/path to the document */
+    url: string;
+    /** Starting page (PDF only) */
+    page?: number;
+    /** Optional display name */
+    filename?: string;
+    /** File ID for uploaded files */
+    file_id?: string;
+}
+/**
+ * Uploaded file metadata for data form file management
+ */
+export interface UploadedFile {
+    file_id: string;
+    filename: string;
+    url: string;
+    mime_type: string;
+    size: number;
+    uploaded_at: string;
+    page?: number;
+}
+/**
+ * Callback event for doc_links click
+ */
+export interface DocLinkClickEvent {
+    field_id: string;
+    doc_links: DocLink[];
+}
+//# sourceMappingURL=doc_link.d.ts.map

package/dist/types/doc_link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc_link.d.ts","sourceRoot":"","sources":["../../src/types/doc_link.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,oDAAoD;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,EAAE,CAAC;CACtB"}

package/dist/types/doc_link.js

@@ -0,0 +1,5 @@
+/**
+ * Document link types for file attachment references
+ */
+export {};
+//# sourceMappingURL=doc_link.js.map

package/dist/types/doc_link.js.map

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

package/dist/types/field_type_definition.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Field type definition types for configurable field types
+ * Supports custom field types (TFN, ABN, etc.) that map to base renderers
+ */
+/**
+ * Base field types - built-in renderers available in the library
+ */
+export type BaseFieldType = "text" | "number" | "date" | "boolean" | "option" | "email" | "tel" | "currency" | "percentage" | "textarea" | "table" | "computed" | "static_text" | "summary_row";
+/**
+ * Field type - includes base types and any custom types defined in config
+ */
+export type FieldType = BaseFieldType | string;
+/**
+ * Field type definition for configurable field types
+ * Loaded from form_field_types.json
+ */
+export interface FieldTypeDefinition {
+    /** Which built-in renderer to use */
+    base_type: BaseFieldType;
+    /** Inherit from another field type definition */
+    extends?: string;
+    /** Human-readable label for this field type */
+    label?: string;
+    /** Regex pattern for validation (validates raw/unmasked value) */
+    pattern?: string;
+    /** Error message when validation fails */
+    validation_message?: string;
+    /** Display format with X placeholders for digits */
+    display_format?: string;
+    /** Input mask with # for digit placeholders */
+    input_mask?: string;
+    /** Default placeholder text */
+    placeholder?: string;
+    /** Maximum input length (including formatting chars) */
+    max_length?: number;
+    /** Number of digits (without formatting) */
+    digit_count?: number;
+    /** HTML inputmode attribute for mobile keyboards */
+    input_mode?: "text" | "numeric" | "tel" | "email" | "url" | "decimal";
+    /** Prefix to display before value */
+    prefix?: string;
+    /** Suffix to display after value */
+    suffix?: string;
+    /** Style class to apply from form_styles.json */
+    style_class?: string;
+    /** Default decimal places for numeric types */
+    decimal_places?: number;
+    /** Minimum value for numeric types */
+    min?: number;
+    /** Maximum value for numeric types */
+    max?: number;
+}
+/**
+ * Field types configuration loaded from form_field_types.json
+ */
+export interface FieldTypesConfig {
+    meta?: {
+        version?: string;
+        description?: string;
+    };
+    field_types: Record<string, FieldTypeDefinition>;
+}
+/**
+ * Default field types configuration
+ */
+export declare const DEFAULT_FIELD_TYPES_CONFIG: FieldTypesConfig;
+//# sourceMappingURL=field_type_definition.d.ts.map

package/dist/types/field_type_definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_type_definition.d.ts","sourceRoot":"","sources":["../../src/types/field_type_definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,GACT,QAAQ,GACR,OAAO,GACP,KAAK,GACL,UAAU,GACV,YAAY,GACZ,UAAU,GACV,OAAO,GACP,UAAU,GACV,aAAa,GACb,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,SAAS,EAAE,aAAa,CAAC;IACzB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;IAGtE,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAgCxC,CAAC"}