@ultracart/bq-skill 0.1.2

package/dist/lib/alarm.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateAlarms = evaluateAlarms;
+exports.aggregateMetric = aggregateMetric;
+exports.parseCooldown = parseCooldown;
+exports.extractAlarmMetrics = extractAlarmMetrics;
+/**
+ * Evaluate all alarms for a report against the current data.json rows.
+ */
+function evaluateAlarms(alarms, data, alarmState) {
+    const results = [];
+    for (const alarm of alarms) {
+        const result = evaluateAlarm(alarm, data, alarmState);
+        results.push(result);
+    }
+    return results;
+}
+function evaluateAlarm(alarm, data, alarmState) {
+    switch (alarm.type) {
+        case 'missing_data':
+            return evaluateMissingData(alarm, data, alarmState);
+        case 'threshold':
+            return evaluateThreshold(alarm, data, alarmState);
+        case 'pct_change':
+            return evaluatePctChange(alarm, data, alarmState);
+        default:
+            return { alarm, triggered: false, reason: `Unknown alarm type: ${alarm.type}`, suppressed: false };
+    }
+}
+function evaluateMissingData(alarm, data, alarmState) {
+    const triggered = data.length === 0;
+    const suppressed = triggered && isSuppressed(alarm, alarmState);
+    return {
+        alarm,
+        triggered,
+        reason: triggered ? 'Query returned zero rows' : `Query returned ${data.length} rows`,
+        suppressed,
+    };
+}
+function evaluateThreshold(alarm, data, alarmState) {
+    if (!alarm.metric || alarm.operator === undefined || alarm.value === undefined) {
+        return { alarm, triggered: false, reason: 'Alarm missing required fields: metric, operator, value', suppressed: false };
+    }
+    if (data.length === 0) {
+        return { alarm, triggered: false, reason: 'No data to evaluate', suppressed: false };
+    }
+    const aggregate = alarm.aggregate || 'sum';
+    const currentValue = aggregateMetric(data, alarm.metric, aggregate);
+    if (currentValue === null) {
+        return { alarm, triggered: false, reason: `Metric "${alarm.metric}" not found or not numeric`, suppressed: false };
+    }
+    const triggered = compareValues(currentValue, alarm.operator, alarm.value);
+    const suppressed = triggered && isSuppressed(alarm, alarmState);
+    return {
+        alarm,
+        triggered,
+        currentValue,
+        reason: triggered
+            ? `${alarm.metric} (${aggregate}) = ${currentValue} ${alarm.operator} ${alarm.value}`
+            : `${alarm.metric} (${aggregate}) = ${currentValue}, threshold ${alarm.operator} ${alarm.value} not met`,
+        suppressed,
+    };
+}
+function evaluatePctChange(alarm, data, alarmState) {
+    if (!alarm.metric || alarm.operator === undefined || alarm.value === undefined) {
+        return { alarm, triggered: false, reason: 'Alarm missing required fields: metric, operator, value', suppressed: false };
+    }
+    if (data.length === 0) {
+        return { alarm, triggered: false, reason: 'No data to evaluate', suppressed: false };
+    }
+    const aggregate = alarm.aggregate || 'sum';
+    const currentValue = aggregateMetric(data, alarm.metric, aggregate);
+    if (currentValue === null) {
+        return { alarm, triggered: false, reason: `Metric "${alarm.metric}" not found or not numeric`, suppressed: false };
+    }
+    // Find previous run's metric value
+    const previousEntry = getPreviousMetricEntry(alarmState, alarm.metric);
+    if (!previousEntry) {
+        return {
+            alarm,
+            triggered: false,
+            currentValue,
+            reason: `No previous run data for "${alarm.metric}" — first run, skipping percent change check`,
+            suppressed: false,
+        };
+    }
+    const previousValue = previousEntry.metrics[alarm.metric];
+    if (previousValue === 0) {
+        // Avoid division by zero
+        const triggered = currentValue !== 0;
+        const suppressed = triggered && isSuppressed(alarm, alarmState);
+        return {
+            alarm,
+            triggered,
+            currentValue,
+            previousValue,
+            reason: triggered
+                ? `Previous ${alarm.metric} was 0, current is ${currentValue} — infinite change`
+                : `Both previous and current ${alarm.metric} are 0`,
+            suppressed,
+        };
+    }
+    const pctChange = ((currentValue - previousValue) / Math.abs(previousValue)) * 100;
+    const triggered = compareValues(pctChange, alarm.operator, alarm.value);
+    const suppressed = triggered && isSuppressed(alarm, alarmState);
+    return {
+        alarm,
+        triggered,
+        currentValue,
+        previousValue,
+        pctChange,
+        reason: triggered
+            ? `${alarm.metric} changed ${pctChange >= 0 ? '+' : ''}${pctChange.toFixed(1)}% (${previousValue} → ${currentValue}), threshold ${alarm.operator} ${alarm.value}%`
+            : `${alarm.metric} changed ${pctChange >= 0 ? '+' : ''}${pctChange.toFixed(1)}% (${previousValue} → ${currentValue}), threshold ${alarm.operator} ${alarm.value}% not met`,
+        suppressed,
+    };
+}
+/**
+ * Aggregate a numeric column from the data rows.
+ */
+function aggregateMetric(data, metric, aggregate) {
+    const values = [];
+    for (const row of data) {
+        const raw = row[metric];
+        if (raw === null || raw === undefined)
+            continue;
+        const num = typeof raw === 'number' ? raw : parseFloat(String(raw));
+        if (!isNaN(num))
+            values.push(num);
+    }
+    if (values.length === 0)
+        return null;
+    switch (aggregate) {
+        case 'sum':
+            return values.reduce((a, b) => a + b, 0);
+        case 'avg':
+            return values.reduce((a, b) => a + b, 0) / values.length;
+        case 'min':
+            return Math.min(...values);
+        case 'max':
+            return Math.max(...values);
+        case 'first':
+            return values[0];
+        case 'last':
+            return values[values.length - 1];
+        default:
+            return null;
+    }
+}
+function compareValues(actual, operator, threshold) {
+    switch (operator) {
+        case '<': return actual < threshold;
+        case '>': return actual > threshold;
+        case '<=': return actual <= threshold;
+        case '>=': return actual >= threshold;
+        case '==': return actual === threshold;
+        case '!=': return actual !== threshold;
+        default: return false;
+    }
+}
+function getPreviousMetricEntry(alarmState, metric) {
+    if (!alarmState.metric_history || alarmState.metric_history.length === 0)
+        return null;
+    // Walk backwards to find the most recent entry that has this metric
+    for (let i = alarmState.metric_history.length - 1; i >= 0; i--) {
+        const entry = alarmState.metric_history[i];
+        if (entry.metrics[metric] !== undefined)
+            return entry;
+    }
+    return null;
+}
+/**
+ * Parse a cooldown duration string like "24h", "7d", "1h" into milliseconds.
+ */
+function parseCooldown(cooldown) {
+    const match = cooldown.match(/^(\d+)(h|d|m)$/);
+    if (!match)
+        return 24 * 60 * 60 * 1000; // default 24h
+    const amount = parseInt(match[1], 10);
+    switch (match[2]) {
+        case 'h': return amount * 60 * 60 * 1000;
+        case 'd': return amount * 24 * 60 * 60 * 1000;
+        case 'm': return amount * 60 * 1000;
+        default: return 24 * 60 * 60 * 1000;
+    }
+}
+function isSuppressed(alarm, alarmState) {
+    const cooldown = alarm.cooldown || '24h';
+    if (cooldown === '0')
+        return false;
+    const suppression = alarmState.suppression?.[alarm.name];
+    if (!suppression)
+        return false;
+    const lastFired = new Date(suppression.last_fired).getTime();
+    const now = Date.now();
+    const cooldownMs = parseCooldown(cooldown);
+    return (now - lastFired) < cooldownMs;
+}
+/**
+ * Extract the metrics referenced by alarms from the current data.
+ */
+function extractAlarmMetrics(alarms, data) {
+    const metrics = {};
+    for (const alarm of alarms) {
+        if (alarm.metric && alarm.type !== 'missing_data') {
+            const aggregate = alarm.aggregate || 'sum';
+            const value = aggregateMetric(data, alarm.metric, aggregate);
+            if (value !== null) {
+                metrics[alarm.metric] = value;
+            }
+        }
+    }
+    return metrics;
+}
+//# sourceMappingURL=alarm.js.map

package/dist/lib/alarm.js.map

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

package/dist/lib/analysis.d.ts

@@ -0,0 +1,16 @@
+import type { LlmProvider } from './llm/provider';
+export interface AnalysisOptions {
+    provider: LlmProvider;
+    analysisPromptPath: string;
+    dataJsonPath: string;
+    chartPngPath?: string;
+    outputPath: string;
+    model: string;
+}
+export declare function generateAnalysis(options: AnalysisOptions): Promise<string>;
+/**
+ * Generate a default analysis prompt template when Claude Code creates a new report.
+ * This is a generic template — Claude Code should customize it based on the specific query/data.
+ */
+export declare function getDefaultAnalysisPromptTemplate(reportName: string, sqlSummary: string, dataFields: string[]): string;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/lib/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/lib/analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,gBAAgB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDhF;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CA2CrH"}

package/dist/lib/analysis.js

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAnalysis = generateAnalysis;
+exports.getDefaultAnalysisPromptTemplate = getDefaultAnalysisPromptTemplate;
+const fs = __importStar(require("fs"));
+async function generateAnalysis(options) {
+    const analysisPrompt = fs.readFileSync(options.analysisPromptPath, 'utf-8');
+    const rawData = fs.readFileSync(options.dataJsonPath, 'utf-8');
+    // Normalize data to array
+    let dataStr;
+    try {
+        const parsed = JSON.parse(rawData);
+        dataStr = JSON.stringify(Array.isArray(parsed) ? parsed : parsed.rows || parsed, null, 2);
+    }
+    catch {
+        dataStr = rawData;
+    }
+    // Build user message content parts
+    const contentParts = [];
+    contentParts.push({
+        type: 'text',
+        text: `Here is the query result data (JSON):\n\n\`\`\`json\n${dataStr}\n\`\`\``,
+    });
+    // Include chart PNG if available
+    if (options.chartPngPath && fs.existsSync(options.chartPngPath)) {
+        const pngData = fs.readFileSync(options.chartPngPath);
+        contentParts.push({
+            type: 'image',
+            mediaType: 'image/png',
+            base64Data: pngData.toString('base64'),
+        });
+        contentParts.push({
+            type: 'text',
+            text: 'Above is the rendered chart visualization for this report.',
+        });
+    }
+    contentParts.push({
+        type: 'text',
+        text: 'Please generate the executive analysis based on the data and visualization provided.',
+    });
+    const messages = [
+        { role: 'system', content: analysisPrompt },
+        { role: 'user', content: contentParts },
+    ];
+    const analysisText = await options.provider.complete(messages, {
+        model: options.model,
+        maxTokens: 4096,
+    });
+    // Write to output file
+    fs.writeFileSync(options.outputPath, analysisText);
+    return analysisText;
+}
+/**
+ * Generate a default analysis prompt template when Claude Code creates a new report.
+ * This is a generic template — Claude Code should customize it based on the specific query/data.
+ */
+function getDefaultAnalysisPromptTemplate(reportName, sqlSummary, dataFields) {
+    return `# ${reportName} — Analysis System Prompt
+
+## Overview
+You are an expert analyst specializing in UltraCart e-commerce data. You will receive JSON data and a corresponding PNG visualization. Generate a comprehensive executive analysis.
+
+## Source Query Context
+${sqlSummary}
+
+## JSON Data Fields
+${dataFields.map((f) => `- **${f}**`).join('\n')}
+
+## Analysis Methodology
+
+### 1. Executive Summary
+- 2-3 sentence overview of the key findings
+- Lead with the most impactful insight
+
+### 2. Key Findings
+- Top 3-5 findings supported by specific numbers from the data
+- Include percentage comparisons where applicable
+- Reference the visualization where relevant
+
+### 3. Trend & Pattern Analysis
+- Identify notable trends, patterns, or anomalies
+- Compare segments (if applicable)
+- Note any concerning or encouraging patterns
+
+### 4. Alert Conditions
+- Flag any metrics that appear unusual (sudden drops >30%, unexpected spikes, etc.)
+- Note data quality issues if any (negative values, missing data, etc.)
+
+### 5. Actionable Recommendations
+- 3-5 specific, actionable recommendations based on the data
+- Prioritize by potential business impact
+- Be specific — reference actual values from the data
+
+## Output Format
+- Use markdown formatting
+- Include specific numbers, percentages, and comparisons
+- Keep the analysis concise but thorough (500-1000 words)
+- Write for a business audience, not a technical one
+`;
+}
+//# sourceMappingURL=analysis.js.map

package/dist/lib/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/lib/analysis.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,4CAsDC;AAMD,4EA2CC;AApHD,uCAAyB;AAalB,KAAK,UAAU,gBAAgB,CAAC,OAAwB;IAC7D,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAE/D,0BAA0B;IAC1B,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAAqB,EAAE,CAAC;IAE1C,YAAY,CAAC,IAAI,CAAC;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,wDAAwD,OAAO,UAAU;KAChF,CAAC,CAAC;IAEH,iCAAiC;IACjC,IAAI,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACvC,CAAC,CAAC;QACH,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,4DAA4D;SACnE,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,IAAI,CAAC;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,sFAAsF;KAC7F,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAiB;QAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE;QAC3C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE;KACxC,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;QAC7D,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,uBAAuB;IACvB,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAEnD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,gCAAgC,CAAC,UAAkB,EAAE,UAAkB,EAAE,UAAoB;IAC3G,OAAO,KAAK,UAAU;;;;;;EAMtB,UAAU;;;EAGV,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC/C,CAAC;AACF,CAAC"}

package/dist/lib/bigquery.d.ts

@@ -0,0 +1,55 @@
+import { ResolvedMerchantConfig } from './config';
+export interface DatasetInfo {
+    dataset_id: string;
+    description: string;
+}
+export interface TableInfo {
+    table_name: string;
+    description: string;
+}
+export interface QueryParameter {
+    name: string;
+    type: 'DATE' | 'DATETIME' | 'INT64' | 'FLOAT64' | 'BOOL' | 'STRING';
+    value: string;
+}
+export interface QueryOptions {
+    sample?: number;
+    dryRun?: boolean;
+    maxBytes?: number;
+    force?: boolean;
+}
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    totalRows: number;
+    schema: Array<{
+        name: string;
+        type: string;
+        mode: string;
+    }>;
+    bytesProcessed: number;
+}
+export declare function getProject(config: ResolvedMerchantConfig): string;
+export declare function getDatasets(config: ResolvedMerchantConfig): DatasetInfo[];
+export declare function getTables(config: ResolvedMerchantConfig, datasetId: string): TableInfo[];
+export declare function getTableSchema(config: ResolvedMerchantConfig, datasetId: string, tableName: string, options?: {
+    live?: boolean;
+}): Promise<Array<{
+    name: string;
+    type: string;
+    mode: string;
+    description?: string;
+    fields?: unknown[];
+}>>;
+export declare function executeQuery(config: ResolvedMerchantConfig, sql: string, params?: QueryParameter[], options?: QueryOptions): Promise<QueryResult>;
+export interface ExternalTableInfo {
+    alias: string;
+    projectId: string;
+    description?: string;
+    dataset: string;
+    table: string;
+    fullyQualified: string;
+}
+export declare function getExternalTables(config: ResolvedMerchantConfig): ExternalTableInfo[];
+export declare function getExternalTableSchema(config: ResolvedMerchantConfig, projectId: string, datasetId: string, tableName: string): Promise<any[]>;
+export declare function refreshSchemaCache(config: ResolvedMerchantConfig): Promise<void>;
+//# sourceMappingURL=bigquery.d.ts.map

package/dist/lib/bigquery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigquery.d.ts","sourceRoot":"","sources":["../../src/lib/bigquery.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,UAAU,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAEjE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,WAAW,EAAE,CAoBzE;AAgDD,wBAAgB,SAAS,CAAC,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAKxF;AAMD,wBAAsB,cAAc,CAClC,MAAM,EAAE,sBAAsB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAAC,CAaxG;AAUD,wBAAsB,YAAY,CAChC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,cAAc,EAAO,EAC7B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA4GtB;AAUD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,EAAE,CAoBrF;AAQD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,EAAE,CAAC,CAwBhB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAatF"}