expo-gaode-map-navigation 2.0.17 → 2.0.19

package/build/src/map/utils/OfflineMapManager.d.ts

@@ -0,0 +1,153 @@
+/**
+ * 离线地图便捷 API
+ * 提供更友好的 API 接口和事件监听
+ */
+import type { OfflineMapInfo, OfflineMapDownloadConfig, OfflineMapDownloadEvent, OfflineMapCompleteEvent, OfflineMapErrorEvent, OfflineMapPausedEvent, OfflineMapCancelledEvent, OfflineMapStorageInfo } from '../types/offline.types';
+/**
+ * 离线地图管理类
+ */
+export declare class OfflineMapManager {
+    /**
+     * 打开高德 3D 地图 SDK 官方离线地图 UI 组件（Android）。
+     */
+    static openOfflineMapUI(): Promise<void>;
+    /**
+     * 获取所有可下载的城市列表
+     */
+    static getAvailableCities(): Promise<OfflineMapInfo[]>;
+    /**
+     * 获取所有省份列表
+     */
+    static getAvailableProvinces(): Promise<OfflineMapInfo[]>;
+    /**
+     * 根据省份代码获取城市列表
+     */
+    static getCitiesByProvince(provinceCode: string): Promise<OfflineMapInfo[]>;
+    /**
+     * 获取已下载的地图列表
+     */
+    static getDownloadedMaps(): Promise<OfflineMapInfo[]>;
+    /**
+     * 开始下载离线地图
+     */
+    static startDownload(config: OfflineMapDownloadConfig): Promise<void>;
+    /**
+     * 暂停下载
+     */
+    static pauseDownload(cityCode: string): Promise<void>;
+    /**
+     * 恢复下载
+     */
+    static resumeDownload(cityCode: string): Promise<void>;
+    /**
+     * 取消下载
+     */
+    static cancelDownload(cityCode: string): Promise<void>;
+    /**
+     * 删除离线地图
+     */
+    static deleteMap(cityCode: string): Promise<void>;
+    /**
+     * 更新离线地图
+     */
+    static updateMap(cityCode: string): Promise<void>;
+    /**
+     * 检查是否有可用更新
+     */
+    static checkUpdate(cityCode: string): Promise<boolean>;
+    /**
+     * 检查地图是否已下载
+     */
+    static isMapDownloaded(cityCode: string): Promise<boolean>;
+    /**
+     * 获取地图下载状态
+     */
+    static getMapStatus(cityCode: string): Promise<OfflineMapInfo>;
+    /**
+     * 获取所有下载任务的总进度
+     */
+    static getTotalProgress(): Promise<number>;
+    /**
+     * 获取当前正在下载的城市列表
+     */
+    static getDownloadingCities(): Promise<string[]>;
+    /**
+     * 获取离线地图占用的存储空间（字节）
+     */
+    static getStorageSize(): Promise<number>;
+    /**
+     * 获取详细的存储信息
+     */
+    static getStorageInfo(): Promise<OfflineMapStorageInfo>;
+    /**
+     * 清理所有离线地图
+     */
+    static clearAllMaps(): Promise<void>;
+    /**
+     * 设置离线地图存储路径
+     */
+    static setStoragePath(path: string): void;
+    /**
+     * 获取离线地图存储路径
+     */
+    static getStoragePath(): Promise<string>;
+    /**
+     * 批量下载地图
+     */
+    static batchDownload(cityCodes: string[], allowCellular?: boolean): Promise<void>;
+    /**
+     * 批量删除地图
+     */
+    static batchDelete(cityCodes: string[]): Promise<void>;
+    /**
+     * 批量更新地图
+     */
+    static batchUpdate(cityCodes: string[]): Promise<void>;
+    /**
+     * 暂停所有下载任务
+     */
+    static pauseAllDownloads(): Promise<void>;
+    /**
+     * 恢复所有下载任务
+     */
+    static resumeAllDownloads(): Promise<void>;
+    /**
+     * 监听下载进度事件
+     */
+    static addDownloadProgressListener(listener: (event: OfflineMapDownloadEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载完成事件
+     */
+    static addDownloadCompleteListener(listener: (event: OfflineMapCompleteEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载错误事件
+     */
+    static addDownloadErrorListener(listener: (event: OfflineMapErrorEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载暂停事件
+     */
+    static addDownloadPausedListener(listener: (event: OfflineMapPausedEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载取消事件
+     */
+    static addDownloadCancelledListener(listener: (event: OfflineMapCancelledEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 移除所有监听器
+     */
+    static removeAllListeners(): void;
+}
+/**
+ * 默认导出管理类
+ */
+export default OfflineMapManager;
+//# sourceMappingURL=OfflineMapManager.d.ts.map

package/build/src/map/utils/OfflineMapManager.d.ts.map

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

package/build/src/map/utils/OfflineMapManager.js

@@ -0,0 +1,217 @@
+/**
+ * 离线地图便捷 API
+ * 提供更友好的 API 接口和事件监听
+ */
+import ExpoGaodeMapOfflineModule from '../ExpoGaodeMapOfflineModule';
+/**
+ * 离线地图管理类
+ */
+export class OfflineMapManager {
+    // ==================== 地图列表管理 ====================
+    /**
+     * 打开高德 3D 地图 SDK 官方离线地图 UI 组件（Android）。
+     */
+    static async openOfflineMapUI() {
+        return ExpoGaodeMapOfflineModule.openOfflineMapUI();
+    }
+    /**
+     * 获取所有可下载的城市列表
+     */
+    static async getAvailableCities() {
+        return ExpoGaodeMapOfflineModule.getAvailableCities();
+    }
+    /**
+     * 获取所有省份列表
+     */
+    static async getAvailableProvinces() {
+        return ExpoGaodeMapOfflineModule.getAvailableProvinces();
+    }
+    /**
+     * 根据省份代码获取城市列表
+     */
+    static async getCitiesByProvince(provinceCode) {
+        return ExpoGaodeMapOfflineModule.getCitiesByProvince(provinceCode);
+    }
+    /**
+     * 获取已下载的地图列表
+     */
+    static async getDownloadedMaps() {
+        return ExpoGaodeMapOfflineModule.getDownloadedMaps();
+    }
+    // ==================== 下载管理 ====================
+    /**
+     * 开始下载离线地图
+     */
+    static async startDownload(config) {
+        return ExpoGaodeMapOfflineModule.startDownload(config);
+    }
+    /**
+     * 暂停下载
+     */
+    static async pauseDownload(cityCode) {
+        return ExpoGaodeMapOfflineModule.pauseDownload(cityCode);
+    }
+    /**
+     * 恢复下载
+     */
+    static async resumeDownload(cityCode) {
+        return ExpoGaodeMapOfflineModule.resumeDownload(cityCode);
+    }
+    /**
+     * 取消下载
+     */
+    static async cancelDownload(cityCode) {
+        return ExpoGaodeMapOfflineModule.cancelDownload(cityCode);
+    }
+    /**
+     * 删除离线地图
+     */
+    static async deleteMap(cityCode) {
+        return ExpoGaodeMapOfflineModule.deleteMap(cityCode);
+    }
+    /**
+     * 更新离线地图
+     */
+    static async updateMap(cityCode) {
+        return ExpoGaodeMapOfflineModule.updateMap(cityCode);
+    }
+    /**
+     * 检查是否有可用更新
+     */
+    static async checkUpdate(cityCode) {
+        return ExpoGaodeMapOfflineModule.checkUpdate(cityCode);
+    }
+    // ==================== 状态查询 ====================
+    /**
+     * 检查地图是否已下载
+     */
+    static async isMapDownloaded(cityCode) {
+        return ExpoGaodeMapOfflineModule.isMapDownloaded(cityCode);
+    }
+    /**
+     * 获取地图下载状态
+     */
+    static async getMapStatus(cityCode) {
+        return ExpoGaodeMapOfflineModule.getMapStatus(cityCode);
+    }
+    /**
+     * 获取所有下载任务的总进度
+     */
+    static async getTotalProgress() {
+        return ExpoGaodeMapOfflineModule.getTotalProgress();
+    }
+    /**
+     * 获取当前正在下载的城市列表
+     */
+    static async getDownloadingCities() {
+        return ExpoGaodeMapOfflineModule.getDownloadingCities();
+    }
+    // ==================== 存储管理 ====================
+    /**
+     * 获取离线地图占用的存储空间（字节）
+     */
+    static async getStorageSize() {
+        return ExpoGaodeMapOfflineModule.getStorageSize();
+    }
+    /**
+     * 获取详细的存储信息
+     */
+    static async getStorageInfo() {
+        return ExpoGaodeMapOfflineModule.getStorageInfo();
+    }
+    /**
+     * 清理所有离线地图
+     */
+    static async clearAllMaps() {
+        return ExpoGaodeMapOfflineModule.clearAllMaps();
+    }
+    /**
+     * 设置离线地图存储路径
+     */
+    static setStoragePath(path) {
+        ExpoGaodeMapOfflineModule.setStoragePath(path);
+    }
+    /**
+     * 获取离线地图存储路径
+     */
+    static async getStoragePath() {
+        return ExpoGaodeMapOfflineModule.getStoragePath();
+    }
+    // ==================== 批量操作 ====================
+    /**
+     * 批量下载地图
+     */
+    static async batchDownload(cityCodes, allowCellular = false) {
+        return ExpoGaodeMapOfflineModule.batchDownload(cityCodes, allowCellular);
+    }
+    /**
+     * 批量删除地图
+     */
+    static async batchDelete(cityCodes) {
+        return ExpoGaodeMapOfflineModule.batchDelete(cityCodes);
+    }
+    /**
+     * 批量更新地图
+     */
+    static async batchUpdate(cityCodes) {
+        return ExpoGaodeMapOfflineModule.batchUpdate(cityCodes);
+    }
+    /**
+     * 暂停所有下载任务
+     */
+    static async pauseAllDownloads() {
+        return ExpoGaodeMapOfflineModule.pauseAllDownloads();
+    }
+    /**
+     * 恢复所有下载任务
+     */
+    static async resumeAllDownloads() {
+        return ExpoGaodeMapOfflineModule.resumeAllDownloads();
+    }
+    // ==================== 事件监听 ====================
+    /**
+     * 监听下载进度事件
+     */
+    static addDownloadProgressListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadProgress', listener);
+    }
+    /**
+     * 监听下载完成事件
+     */
+    static addDownloadCompleteListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadComplete', listener);
+    }
+    /**
+     * 监听下载错误事件
+     */
+    static addDownloadErrorListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadError', listener);
+    }
+    /**
+     * 监听下载暂停事件
+     */
+    static addDownloadPausedListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadPaused', listener);
+    }
+    /**
+     * 监听下载取消事件
+     */
+    static addDownloadCancelledListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadCancelled', listener);
+    }
+    /**
+     * 移除所有监听器
+     */
+    static removeAllListeners() {
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadProgress');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadComplete');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadError');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadPaused');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadCancelled');
+    }
+}
+/**
+ * 默认导出管理类
+ */
+export default OfflineMapManager;
+//# sourceMappingURL=OfflineMapManager.js.map

package/build/src/map/utils/OfflineMapManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineMapManager.js","sourceRoot":"","sources":["../../../../src/map/utils/OfflineMapManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 离线地图便捷 API\n * 提供更友好的 API 接口和事件监听\n */\n\nimport ExpoGaodeMapOfflineModule from '../ExpoGaodeMapOfflineModule';\nimport type {\n  OfflineMapInfo,\n  OfflineMapDownloadConfig,\n  OfflineMapDownloadEvent,\n  OfflineMapCompleteEvent,\n  OfflineMapErrorEvent,\n  OfflineMapPausedEvent,\n  OfflineMapCancelledEvent,\n  OfflineMapStorageInfo,\n} from '../types/offline.types';\n\n/**\n * 离线地图管理类\n */\nexport class OfflineMapManager {\n  // ==================== 地图列表管理 ====================\n\n  /**\n   * 打开高德 3D 地图 SDK 官方离线地图 UI 组件（Android）。\n   */\n  static async openOfflineMapUI(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.openOfflineMapUI();\n  }\n  \n  /**\n   * 获取所有可下载的城市列表\n   */\n  static async getAvailableCities(): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getAvailableCities();\n  }\n  \n  /**\n   * 获取所有省份列表\n   */\n  static async getAvailableProvinces(): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getAvailableProvinces();\n  }\n  \n  /**\n   * 根据省份代码获取城市列表\n   */\n  static async getCitiesByProvince(provinceCode: string): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getCitiesByProvince(provinceCode);\n  }\n  \n  /**\n   * 获取已下载的地图列表\n   */\n  static async getDownloadedMaps(): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getDownloadedMaps();\n  }\n  \n  // ==================== 下载管理 ====================\n  \n  /**\n   * 开始下载离线地图\n   */\n  static async startDownload(config: OfflineMapDownloadConfig): Promise<void> {\n    return ExpoGaodeMapOfflineModule.startDownload(config);\n  }\n  \n  /**\n   * 暂停下载\n   */\n  static async pauseDownload(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.pauseDownload(cityCode);   \n  }\n  \n  /**\n   * 恢复下载\n   */\n  static async resumeDownload(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.resumeDownload(cityCode);\n  }\n  \n  /**\n   * 取消下载\n   */\n  static async cancelDownload(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.cancelDownload(cityCode);\n  }\n  \n  /**\n   * 删除离线地图\n   */\n  static async deleteMap(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.deleteMap(cityCode);\n  }\n  \n  /**\n   * 更新离线地图\n   */\n  static async updateMap(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.updateMap(cityCode);\n  }\n  \n  /**\n   * 检查是否有可用更新\n   */\n  static async checkUpdate(cityCode: string): Promise<boolean> {\n    return ExpoGaodeMapOfflineModule.checkUpdate(cityCode);\n  }\n  \n  // ==================== 状态查询 ====================\n  \n  /**\n   * 检查地图是否已下载\n   */\n  static async isMapDownloaded(cityCode: string): Promise<boolean> {\n    return ExpoGaodeMapOfflineModule.isMapDownloaded(cityCode);\n  }\n  \n  /**\n   * 获取地图下载状态\n   */\n  static async getMapStatus(cityCode: string): Promise<OfflineMapInfo> {\n    return ExpoGaodeMapOfflineModule.getMapStatus(cityCode);\n  }\n  \n  /**\n   * 获取所有下载任务的总进度\n   */\n  static async getTotalProgress(): Promise<number> {\n    return ExpoGaodeMapOfflineModule.getTotalProgress();\n  }\n  \n  /**\n   * 获取当前正在下载的城市列表\n   */\n  static async getDownloadingCities(): Promise<string[]> {\n    return ExpoGaodeMapOfflineModule.getDownloadingCities();\n  }\n  \n  // ==================== 存储管理 ====================\n  \n  /**\n   * 获取离线地图占用的存储空间（字节）\n   */\n  static async getStorageSize(): Promise<number> {\n    return ExpoGaodeMapOfflineModule.getStorageSize();\n  }\n  \n  /**\n   * 获取详细的存储信息\n   */\n  static async getStorageInfo(): Promise<OfflineMapStorageInfo> {\n    return ExpoGaodeMapOfflineModule.getStorageInfo();\n  }\n  \n  /**\n   * 清理所有离线地图\n   */\n  static async clearAllMaps(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.clearAllMaps();\n  }\n  \n  /**\n   * 设置离线地图存储路径\n   */\n  static setStoragePath(path: string): void {\n    ExpoGaodeMapOfflineModule.setStoragePath(path);\n  }\n  \n  /**\n   * 获取离线地图存储路径\n   */\n  static async getStoragePath(): Promise<string> {\n    return ExpoGaodeMapOfflineModule.getStoragePath();\n  }\n  \n  // ==================== 批量操作 ====================\n  \n  /**\n   * 批量下载地图\n   */\n  static async batchDownload(cityCodes: string[], allowCellular = false): Promise<void> {\n    return ExpoGaodeMapOfflineModule.batchDownload(cityCodes, allowCellular);\n  }\n  \n  /**\n   * 批量删除地图\n   */\n  static async batchDelete(cityCodes: string[]): Promise<void> {\n    return ExpoGaodeMapOfflineModule.batchDelete(cityCodes);\n  }\n  \n  /**\n   * 批量更新地图\n   */\n  static async batchUpdate(cityCodes: string[]): Promise<void> {\n    return ExpoGaodeMapOfflineModule.batchUpdate(cityCodes);\n  }\n  \n  /**\n   * 暂停所有下载任务\n   */\n  static async pauseAllDownloads(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.pauseAllDownloads();\n  }\n  \n  /**\n   * 恢复所有下载任务\n   */\n  static async resumeAllDownloads(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.resumeAllDownloads();\n  }\n  \n  // ==================== 事件监听 ====================\n  \n  /**\n   * 监听下载进度事件\n   */\n  static addDownloadProgressListener(\n    listener: (event: OfflineMapDownloadEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadProgress', listener);\n  }\n  \n  /**\n   * 监听下载完成事件\n   */\n  static addDownloadCompleteListener(\n    listener: (event: OfflineMapCompleteEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadComplete', listener);\n  }\n  \n  /**\n   * 监听下载错误事件\n   */\n  static addDownloadErrorListener(\n    listener: (event: OfflineMapErrorEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadError', listener);\n  }\n  \n  /**\n   * 监听下载暂停事件\n   */\n  static addDownloadPausedListener(\n    listener: (event: OfflineMapPausedEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadPaused', listener);\n  }\n  \n  /**\n   * 监听下载取消事件\n   */\n  static addDownloadCancelledListener(\n    listener: (event: OfflineMapCancelledEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadCancelled', listener);\n  }\n  \n  /**\n   * 移除所有监听器\n   */\n  static removeAllListeners(): void {\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadProgress');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadComplete');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadError');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadPaused');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadCancelled');\n  }\n}\n\n/**\n * 默认导出管理类\n */\nexport default OfflineMapManager;\n"]}

package/build/src/map/utils/PermissionUtils.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 位置权限类型
+ */
+export declare enum LocationPermissionType {
+    /** 仅前台（使用时） */
+    FOREGROUND = "foreground",
+    /** 后台位置 */
+    BACKGROUND = "background",
+    /** 前台+后台 */
+    FOREGROUND_AND_BACKGROUND = "foreground_and_background"
+}
+/**
+ * 权限工具类
+ *
+ * 🔔 **重要说明**：
+ *
+ * 本工具类**不执行实际的权限请求**，仅提供：
+ * - 平台检测（Android 14+、iOS 17+）
+ * - 权限说明文案（适配新系统特性）
+ * - 最佳实践建议
+ * - 诊断信息
+ *
+ * **实际权限请求请使用**：
+ * ```typescript
+ * import ExpoGaodeMapModule from 'expo-gaode-map';
+ *
+ * // 检查权限
+ * const status = await ExpoGaodeMapModule.checkLocationPermission();
+ *
+ * // 请求权限
+ * const result = await ExpoGaodeMapModule.requestLocationPermission();
+ * ```
+ *
+ * 本工具类主要用于在请求权限**之前**向用户展示说明文案。
+ */
+export declare class PermissionUtils {
+    /**
+     * 检查当前平台的系统版本
+     */
+    static getSystemInfo(): {
+        platform: 'android' | 'ios';
+        version: number;
+        isAndroid14Plus: boolean;
+        isiOS17Plus: boolean;
+    };
+    /**
+     * 获取权限说明文案
+     */
+    static getPermissionRationale(type: LocationPermissionType): string;
+    /**
+     * Android 权限说明文案
+     */
+    private static getAndroidRationale;
+    /**
+     * iOS 权限说明文案
+     */
+    private static getiOSRationale;
+    /**
+     * 获取精确位置权限说明（iOS 14+）
+     */
+    static getAccuracyRationale(): string;
+    /**
+     * 获取权限请求的最佳实践建议
+     */
+    static getBestPractices(): {
+        android14: string[];
+        ios17: string[];
+        general: string[];
+    };
+    /**
+     * 验证 Info.plist 配置（仅 iOS）
+     */
+    static validateiOSConfiguration(): {
+        valid: boolean;
+        missingKeys: string[];
+        recommendations: string[];
+    };
+    /**
+     * 检查是否支持后台位置权限
+     */
+    static supportsBackgroundLocation(): boolean;
+    /**
+     * 打印权限诊断信息
+     */
+    static printDiagnostics(): void;
+}
+/**
+ * 向后兼容的别名
+ * @deprecated 请使用 PermissionUtils
+ */
+export declare const PermissionManager: typeof PermissionUtils;
+//# sourceMappingURL=PermissionUtils.d.ts.map

package/build/src/map/utils/PermissionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionUtils.d.ts","sourceRoot":"","sources":["../../../../src/map/utils/PermissionUtils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,oBAAY,sBAAsB;IAChC,eAAe;IACf,UAAU,eAAe;IACzB,WAAW;IACX,UAAU,eAAe;IACzB,YAAY;IACZ,yBAAyB,8BAA8B;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI;QACtB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,OAAO,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;KACtB;IAYD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM;IAUnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAqClC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA+B9B;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM;IAerC;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI;QACzB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB;IAuBD;;OAEG;IACH,MAAM,CAAC,wBAAwB,IAAI;QACjC,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IA2BD;;OAEG;IACH,MAAM,CAAC,0BAA0B,IAAI,OAAO;IAY5C;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,IAAI;CA6ChC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wBAAkB,CAAC"}