@georgedong32/ccs 7.66.0

package/dist/web-server/usage/cliproxy-usage-syncer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CLIProxy Usage Syncer
+ *
+ * Periodically fetches CLIProxy usage data, transforms it, and persists
+ * snapshots locally so analytics data survives CLIProxy restarts.
+ *
+ * Snapshot location: ~/.ccs/cache/cliproxy-usage/latest.json
+ * Sync interval: 5 minutes
+ */
+import { fetchCliproxyUsageRaw } from '../../cliproxy/stats-fetcher';
+import type { DailyUsage, HourlyUsage, MonthlyUsage } from './types';
+type FetchCliproxyUsageRaw = typeof fetchCliproxyUsageRaw;
+/**
+ * Read the latest CLIProxy usage snapshot from disk.
+ * Returns empty arrays on failure (file not found, parse error, version mismatch).
+ */
+export declare function loadCachedCliproxyData(): Promise<{
+    daily: DailyUsage[];
+    hourly: HourlyUsage[];
+    monthly: MonthlyUsage[];
+}>;
+/**
+ * Fetch latest CLIProxy usage data and persist a snapshot to disk.
+ * Non-fatal: logs warning and returns early if CLIProxy is unavailable.
+ */
+export declare function syncCliproxyUsage(fetchRaw?: FetchCliproxyUsageRaw): Promise<void>;
+/**
+ * Start periodic CLIProxy usage sync (every 5 minutes).
+ * Performs an immediate sync on startup.
+ */
+export declare function startCliproxySync(syncNow?: () => Promise<void>): void;
+/**
+ * Stop periodic CLIProxy usage sync.
+ */
+export declare function stopCliproxySync(): void;
+export {};
+//# sourceMappingURL=cliproxy-usage-syncer.d.ts.map

package/dist/web-server/usage/cliproxy-usage-syncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliproxy-usage-syncer.d.ts","sourceRoot":"","sources":["../../../src/web-server/usage/cliproxy-usage-syncer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAMrE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAgBrE,KAAK,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAoC1D;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC;IACtD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC,CAsBD;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,GAAE,qBAA6C,GACtD,OAAO,CAAC,IAAI,CAAC,CAkCf;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAM,OAAO,CAAC,IAAI,CAA6B,GAAG,IAAI,CAchG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/web-server/usage/cliproxy-usage-syncer.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * CLIProxy Usage Syncer
+ *
+ * Periodically fetches CLIProxy usage data, transforms it, and persists
+ * snapshots locally so analytics data survives CLIProxy restarts.
+ *
+ * Snapshot location: ~/.ccs/cache/cliproxy-usage/latest.json
+ * Sync interval: 5 minutes
+ */
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopCliproxySync = exports.startCliproxySync = exports.syncCliproxyUsage = exports.loadCachedCliproxyData = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const stats_fetcher_1 = require("../../cliproxy/stats-fetcher");
+const cliproxy_usage_transformer_1 = require("./cliproxy-usage-transformer");
+const config_manager_1 = require("../../utils/config-manager");
+const ui_1 = require("../../utils/ui");
+const SNAPSHOT_VERSION = 1;
+/** Sync interval in ms, configurable via CCS_CLIPROXY_SYNC_INTERVAL env var (default: 5 min) */
+const SYNC_INTERVAL_MS = Math.max(30000, parseInt(process.env.CCS_CLIPROXY_SYNC_INTERVAL ?? '300000', 10) || 300000);
+// Module-level interval ID
+let syncIntervalId = null;
+// ---------------------------------------------------------------------------
+// Cache directory helpers
+// ---------------------------------------------------------------------------
+function getCliproxyCacheDir() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'cache', 'cliproxy-usage');
+}
+function getLatestSnapshotPath() {
+    return path.join(getCliproxyCacheDir(), 'latest.json');
+}
+function ensureCliproxyCacheDir() {
+    const dir = getCliproxyCacheDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+// ---------------------------------------------------------------------------
+// Load cached data
+// ---------------------------------------------------------------------------
+/**
+ * Read the latest CLIProxy usage snapshot from disk.
+ * Returns empty arrays on failure (file not found, parse error, version mismatch).
+ */
+async function loadCachedCliproxyData() {
+    const empty = { daily: [], hourly: [], monthly: [] };
+    try {
+        const snapshotPath = getLatestSnapshotPath();
+        if (!fs.existsSync(snapshotPath)) {
+            return empty;
+        }
+        const raw = fs.readFileSync(snapshotPath, 'utf-8');
+        const snapshot = JSON.parse(raw);
+        if (snapshot.version !== SNAPSHOT_VERSION) {
+            console.log((0, ui_1.info)('CLIProxy snapshot version mismatch, will refresh on next sync'));
+            return empty;
+        }
+        return { daily: snapshot.daily, hourly: snapshot.hourly, monthly: snapshot.monthly };
+    }
+    catch (err) {
+        console.log((0, ui_1.warn)('Failed to read CLIProxy snapshot:') + ` ${err.message}`);
+        return empty;
+    }
+}
+exports.loadCachedCliproxyData = loadCachedCliproxyData;
+// ---------------------------------------------------------------------------
+// Sync
+// ---------------------------------------------------------------------------
+/**
+ * Fetch latest CLIProxy usage data and persist a snapshot to disk.
+ * Non-fatal: logs warning and returns early if CLIProxy is unavailable.
+ */
+async function syncCliproxyUsage(fetchRaw = stats_fetcher_1.fetchCliproxyUsageRaw) {
+    const raw = await fetchRaw();
+    if (raw === null) {
+        console.log((0, ui_1.warn)('CLIProxy usage sync skipped: proxy unavailable'));
+        return;
+    }
+    try {
+        ensureCliproxyCacheDir();
+        const daily = (0, cliproxy_usage_transformer_1.transformCliproxyToDailyUsage)(raw);
+        const hourly = (0, cliproxy_usage_transformer_1.transformCliproxyToHourlyUsage)(raw);
+        const monthly = (0, cliproxy_usage_transformer_1.transformCliproxyToMonthlyUsage)(raw);
+        const snapshot = {
+            version: SNAPSHOT_VERSION,
+            timestamp: Date.now(),
+            daily,
+            hourly,
+            monthly,
+        };
+        // Atomic write: temp file + rename
+        const snapshotPath = getLatestSnapshotPath();
+        const tempFile = snapshotPath + '.tmp';
+        fs.writeFileSync(tempFile, JSON.stringify(snapshot), 'utf-8');
+        fs.renameSync(tempFile, snapshotPath);
+        console.log((0, ui_1.ok)('CLIProxy usage snapshot updated'));
+    }
+    catch (err) {
+        // Non-fatal - stale snapshot will continue to be served
+        console.log((0, ui_1.warn)('Failed to write CLIProxy snapshot:') + ` ${err.message}`);
+    }
+}
+exports.syncCliproxyUsage = syncCliproxyUsage;
+// ---------------------------------------------------------------------------
+// Interval management
+// ---------------------------------------------------------------------------
+/**
+ * Start periodic CLIProxy usage sync (every 5 minutes).
+ * Performs an immediate sync on startup.
+ */
+function startCliproxySync(syncNow = () => syncCliproxyUsage()) {
+    if (syncIntervalId !== null) {
+        return;
+    }
+    const intervalMin = Math.round(SYNC_INTERVAL_MS / 60000);
+    console.log((0, ui_1.info)(`Starting CLIProxy usage sync (interval: ${intervalMin} min)`));
+    // Fire-and-forget initial sync
+    void syncNow();
+    syncIntervalId = setInterval(() => {
+        void syncNow();
+    }, SYNC_INTERVAL_MS);
+}
+exports.startCliproxySync = startCliproxySync;
+/**
+ * Stop periodic CLIProxy usage sync.
+ */
+function stopCliproxySync() {
+    if (syncIntervalId !== null) {
+        clearInterval(syncIntervalId);
+        syncIntervalId = null;
+    }
+}
+exports.stopCliproxySync = stopCliproxySync;
+//# sourceMappingURL=cliproxy-usage-syncer.js.map

package/dist/web-server/usage/cliproxy-usage-syncer.js.map

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

package/dist/web-server/usage/cliproxy-usage-transformer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CLIProxy Usage Transformer
+ *
+ * Transforms CLIProxy's usage API response into DailyUsage/HourlyUsage/MonthlyUsage
+ * types compatible with the CCS analytics dashboard.
+ */
+import type { CliproxyUsageApiResponse, CliproxyRequestDetail } from '../../cliproxy/stats-fetcher';
+import type { DailyUsage, HourlyUsage, MonthlyUsage } from './types';
+/** Flat entry pairing a model name with its request detail */
+interface FlatDetail {
+    model: string;
+    detail: CliproxyRequestDetail;
+}
+/**
+ * Flatten the nested response.usage.apis[provider].models[model].details[]
+ * structure into a flat array. Failed requests are skipped.
+ */
+export declare function flattenCliproxyDetails(response: CliproxyUsageApiResponse): FlatDetail[];
+/** Transform CLIProxy usage response into DailyUsage array (sorted descending by date) */
+export declare function transformCliproxyToDailyUsage(response: CliproxyUsageApiResponse): DailyUsage[];
+/** Transform CLIProxy usage response into HourlyUsage array (sorted descending by hour) */
+export declare function transformCliproxyToHourlyUsage(response: CliproxyUsageApiResponse): HourlyUsage[];
+/** Transform CLIProxy usage response into MonthlyUsage array (sorted descending by month) */
+export declare function transformCliproxyToMonthlyUsage(response: CliproxyUsageApiResponse): MonthlyUsage[];
+export {};
+//# sourceMappingURL=cliproxy-usage-transformer.d.ts.map

package/dist/web-server/usage/cliproxy-usage-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliproxy-usage-transformer.d.ts","sourceRoot":"","sources":["../../../src/web-server/usage/cliproxy-usage-transformer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEpG,OAAO,KAAK,EAAkB,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMrF,8DAA8D;AAC9D,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAuBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,UAAU,EAAE,CAkBvF;AAiDD,0FAA0F;AAC1F,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,UAAU,EAAE,CAsB9F;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,WAAW,EAAE,CA0BhG;AAED,6FAA6F;AAC7F,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,wBAAwB,GACjC,YAAY,EAAE,CAkBhB"}

package/dist/web-server/usage/cliproxy-usage-transformer.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * CLIProxy Usage Transformer
+ *
+ * Transforms CLIProxy's usage API response into DailyUsage/HourlyUsage/MonthlyUsage
+ * types compatible with the CCS analytics dashboard.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformCliproxyToMonthlyUsage = exports.transformCliproxyToHourlyUsage = exports.transformCliproxyToDailyUsage = exports.flattenCliproxyDetails = void 0;
+const model_pricing_1 = require("../model-pricing");
+/** Build ModelBreakdown from accumulated token counts */
+function buildModelBreakdown(modelName, acc) {
+    const { inputTokens, outputTokens, cacheReadTokens } = acc;
+    const cost = (0, model_pricing_1.calculateCost)({ inputTokens, outputTokens, cacheCreationTokens: 0, cacheReadTokens }, modelName);
+    return { modelName, inputTokens, outputTokens, cacheCreationTokens: 0, cacheReadTokens, cost };
+}
+// ============================================================================
+// FLATTEN
+// ============================================================================
+/**
+ * Flatten the nested response.usage.apis[provider].models[model].details[]
+ * structure into a flat array. Failed requests are skipped.
+ */
+function flattenCliproxyDetails(response) {
+    const apis = response?.usage?.apis;
+    if (!apis)
+        return [];
+    const results = [];
+    for (const providerData of Object.values(apis)) {
+        const models = providerData?.models;
+        if (!models)
+            continue;
+        for (const [model, modelData] of Object.entries(models)) {
+            const details = modelData?.details;
+            if (!details)
+                continue;
+            for (const detail of details) {
+                if (detail.failed)
+                    continue;
+                results.push({ model, detail });
+            }
+        }
+    }
+    return results;
+}
+exports.flattenCliproxyDetails = flattenCliproxyDetails;
+// ============================================================================
+// GENERIC AGGREGATOR
+// ============================================================================
+/** Group flat details by a time key extractor, return sorted DailyUsage-like records */
+function aggregateByKey(flat, keyFn, buildRecord, sortFn) {
+    // bucket: timeKey -> modelName -> accumulator
+    const buckets = new Map();
+    for (const { model, detail } of flat) {
+        const key = keyFn(detail.timestamp);
+        if (!buckets.has(key))
+            buckets.set(key, new Map());
+        const modelMap = buckets.get(key);
+        if (!modelMap.has(model)) {
+            modelMap.set(model, { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 });
+        }
+        const acc = modelMap.get(model);
+        acc.inputTokens += detail.tokens?.input_tokens ?? 0;
+        acc.outputTokens += detail.tokens?.output_tokens ?? 0;
+        acc.cacheReadTokens += detail.tokens?.cached_tokens ?? 0;
+    }
+    const records = [];
+    Array.from(buckets.entries()).forEach(([key, modelMap]) => {
+        const breakdowns = Array.from(modelMap.entries()).map(([name, acc]) => buildModelBreakdown(name, acc));
+        records.push(buildRecord(key, breakdowns));
+    });
+    return records.sort(sortFn);
+}
+/** Sum token field across all breakdowns */
+function sumField(breakdowns, field) {
+    return breakdowns.reduce((acc, b) => acc + b[field], 0);
+}
+// ============================================================================
+// TRANSFORMS
+// ============================================================================
+/** Transform CLIProxy usage response into DailyUsage array (sorted descending by date) */
+function transformCliproxyToDailyUsage(response) {
+    const flat = flattenCliproxyDetails(response);
+    return aggregateByKey(flat, (ts) => ts.slice(0, 10), (date, breakdowns) => {
+        const totalCost = sumField(breakdowns, 'cost');
+        return {
+            date,
+            source: 'cliproxy',
+            inputTokens: sumField(breakdowns, 'inputTokens'),
+            outputTokens: sumField(breakdowns, 'outputTokens'),
+            cacheCreationTokens: 0,
+            cacheReadTokens: sumField(breakdowns, 'cacheReadTokens'),
+            cost: totalCost,
+            totalCost,
+            modelsUsed: breakdowns.map((b) => b.modelName),
+            modelBreakdowns: breakdowns,
+        };
+    }, (a, b) => b.date.localeCompare(a.date));
+}
+exports.transformCliproxyToDailyUsage = transformCliproxyToDailyUsage;
+/** Transform CLIProxy usage response into HourlyUsage array (sorted descending by hour) */
+function transformCliproxyToHourlyUsage(response) {
+    const flat = flattenCliproxyDetails(response);
+    return aggregateByKey(flat, (ts) => {
+        const date = ts.slice(0, 10);
+        const hour = ts.slice(11, 13) || '00';
+        return `${date} ${hour}:00`;
+    }, (hour, breakdowns) => {
+        const totalCost = sumField(breakdowns, 'cost');
+        return {
+            hour,
+            source: 'cliproxy',
+            inputTokens: sumField(breakdowns, 'inputTokens'),
+            outputTokens: sumField(breakdowns, 'outputTokens'),
+            cacheCreationTokens: 0,
+            cacheReadTokens: sumField(breakdowns, 'cacheReadTokens'),
+            cost: totalCost,
+            totalCost,
+            modelsUsed: breakdowns.map((b) => b.modelName),
+            modelBreakdowns: breakdowns,
+        };
+    }, (a, b) => b.hour.localeCompare(a.hour));
+}
+exports.transformCliproxyToHourlyUsage = transformCliproxyToHourlyUsage;
+/** Transform CLIProxy usage response into MonthlyUsage array (sorted descending by month) */
+function transformCliproxyToMonthlyUsage(response) {
+    const flat = flattenCliproxyDetails(response);
+    return aggregateByKey(flat, (ts) => ts.slice(0, 7), (month, breakdowns) => ({
+        month,
+        source: 'cliproxy',
+        inputTokens: sumField(breakdowns, 'inputTokens'),
+        outputTokens: sumField(breakdowns, 'outputTokens'),
+        cacheCreationTokens: 0,
+        cacheReadTokens: sumField(breakdowns, 'cacheReadTokens'),
+        totalCost: sumField(breakdowns, 'cost'),
+        modelsUsed: breakdowns.map((b) => b.modelName),
+        modelBreakdowns: breakdowns,
+    }), (a, b) => b.month.localeCompare(a.month));
+}
+exports.transformCliproxyToMonthlyUsage = transformCliproxyToMonthlyUsage;
+//# sourceMappingURL=cliproxy-usage-transformer.js.map

package/dist/web-server/usage/cliproxy-usage-transformer.js.map

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

package/dist/web-server/usage/data-aggregator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Data Aggregator for Claude Code Usage Analytics
+ *
+ * Aggregates raw JSONL entries into daily, monthly, and session summaries.
+ * Uses model-pricing.ts for cost calculations.
+ */
+import { type RawUsageEntry } from '../jsonl-parser';
+import { type DailyUsage, type HourlyUsage, type MonthlyUsage, type SessionUsage } from './types';
+/**
+ * Aggregate raw entries into daily usage summaries
+ * Groups by date (YYYY-MM-DD), calculates costs per model
+ */
+export declare function aggregateDailyUsage(entries: RawUsageEntry[], source?: string): DailyUsage[];
+/**
+ * Aggregate raw entries into hourly usage summaries
+ * Groups by hour (YYYY-MM-DD HH:00), calculates costs per model
+ */
+export declare function aggregateHourlyUsage(entries: RawUsageEntry[], source?: string): HourlyUsage[];
+/**
+ * Aggregate raw entries into monthly usage summaries
+ * Groups by month (YYYY-MM), calculates costs per model
+ */
+export declare function aggregateMonthlyUsage(entries: RawUsageEntry[], source?: string): MonthlyUsage[];
+/**
+ * Aggregate raw entries into session usage summaries
+ * Groups by sessionId, tracks last activity and versions
+ */
+export declare function aggregateSessionUsage(entries: RawUsageEntry[], source?: string): SessionUsage[];
+import { type ParserOptions } from '../jsonl-parser';
+/**
+ * Load daily usage data (replaces better-ccusage loadDailyUsageData)
+ */
+export declare function loadDailyUsageData(options?: ParserOptions): Promise<DailyUsage[]>;
+/**
+ * Load hourly usage data for today's chart
+ */
+export declare function loadHourlyUsageData(options?: ParserOptions): Promise<HourlyUsage[]>;
+/**
+ * Load monthly usage data (replaces better-ccusage loadMonthlyUsageData)
+ */
+export declare function loadMonthlyUsageData(options?: ParserOptions): Promise<MonthlyUsage[]>;
+/**
+ * Load session data (replaces better-ccusage loadSessionData)
+ */
+export declare function loadSessionData(options?: ParserOptions): Promise<SessionUsage[]>;
+/**
+ * Load all usage data in a single pass (more efficient)
+ */
+export declare function loadAllUsageData(options?: ParserOptions): Promise<{
+    daily: DailyUsage[];
+    hourly: HourlyUsage[];
+    monthly: MonthlyUsage[];
+    session: SessionUsage[];
+}>;
+//# sourceMappingURL=data-aggregator.d.ts.map

package/dist/web-server/usage/data-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-aggregator.d.ts","sourceRoot":"","sources":["../../../src/web-server/usage/data-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AA0DjB;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,SAAkB,GACvB,UAAU,EAAE,CAgFd;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,SAAkB,GACvB,WAAW,EAAE,CAgFf;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,SAAkB,GACvB,YAAY,EAAE,CA+EhB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,SAAkB,GACvB,YAAY,EAAE,CA+GhB;AAMD,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAGzF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAG3F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGtF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACvE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC,CAQD"}