@cap-kit/settings 8.0.0-next.0 → 8.0.1

package/Package.swift

@@ -10,7 +10,7 @@ let package = Package(
             targets: ["SettingsPlugin"])
     ],
     dependencies: [
-        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.2")
     ],
     targets: [
         .target(
@@ -20,10 +20,6 @@ let package = Package(
                 .product(name: "Cordova", package: "capacitor-swift-pm")
             ],
             path: "ios/Sources/SettingsPlugin"
-        ),
-        .testTarget(
-            name: "SettingsPluginTests",
-            dependencies: ["SettingsPlugin"],
-            path: "ios/Tests/SettingsPluginTests")
+        )
     ]
 )

package/README.md

@@ -122,7 +122,7 @@ This design ensures consistent behavior across Android, iOS, and Web.
 ### open(...)
 
 ```typescript
-open(options: PlatformOptions) => Promise<SettingsResult>
+open(options: PlatformOptions) => Promise<void>
 ```
 
 Opens the specified settings option on the current platform.
@@ -132,8 +132,6 @@ On Web, this method is not supported.
 | ------------- | ----------------------------------------------------------- | ----------------------------------- |
 | **`options`** | <code><a href="#platformoptions">PlatformOptions</a></code> | Platform-specific settings options. |
 
-**Returns:** <code>Promise&lt;<a href="#settingsresult">SettingsResult</a>&gt;</code>
-
 **Since:** 1.0.0
 
 --------------------
@@ -142,7 +140,7 @@ On Web, this method is not supported.
 ### openIOS(...)
 
 ```typescript
-openIOS(options: IOSOptions) => Promise<SettingsResult>
+openIOS(options: IOSOptions) => Promise<void>
 ```
 
 Opens a specific system settings section. (iOS Only)
@@ -151,8 +149,6 @@ Opens a specific system settings section. (iOS Only)
 | ------------- | ------------------------------------------------- | --------------------- |
 | **`options`** | <code><a href="#iosoptions">IOSOptions</a></code> | iOS settings options. |
 
-**Returns:** <code>Promise&lt;<a href="#settingsresult">SettingsResult</a>&gt;</code>
-
 **Since:** 1.0.0
 
 --------------------
@@ -161,7 +157,7 @@ Opens a specific system settings section. (iOS Only)
 ### openAndroid(...)
 
 ```typescript
-openAndroid(options: AndroidOptions) => Promise<SettingsResult>
+openAndroid(options: AndroidOptions) => Promise<void>
 ```
 
 Opens a specific Android Intent. (Android Only)
@@ -171,8 +167,6 @@ On Web, this method is not supported.
 | ------------- | --------------------------------------------------------- | ------------------------- |
 | **`options`** | <code><a href="#androidoptions">AndroidOptions</a></code> | Android settings options. |
 
-**Returns:** <code>Promise&lt;<a href="#settingsresult">SettingsResult</a>&gt;</code>
-
 **Since:** 1.0.0
 
 --------------------
@@ -205,20 +199,6 @@ const { version } = await Settings.getPluginVersion();
 ### Interfaces
 
 
-#### SettingsResult
-
-Response object for settings open operations.
-
-All platforms return a state-based result object.
-Promise rejection is NOT used.
-
-| Prop          | Type                                                            | Description                                                                                                                                      |
-| ------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **`success`** | <code>boolean</code>                                            | Indicates if the operation was successful.                                                                                                       |
-| **`error`**   | <code>string</code>                                             | Human-readable error message, if the operation failed.                                                                                           |
-| **`code`**    | <code><a href="#settingserrorcode">SettingsErrorCode</a></code> | Machine-readable error code. This field is present when `success` is false and allows programmatic handling of platform limitations or failures. |
-
-
 #### PlatformOptions
 
 Platform-specific options for opening system settings.
@@ -262,16 +242,6 @@ Result object returned by the `getPluginVersion()` method.
 ### Enums
 
 
-#### SettingsErrorCode
-
-| Members                 | Value                            | Description                                                                       |
-| ----------------------- | -------------------------------- | --------------------------------------------------------------------------------- |
-| **`UNAVAILABLE`**       | <code>'UNAVAILABLE'</code>       | The device does not have the requested hardware.                                  |
-| **`PERMISSION_DENIED`** | <code>'PERMISSION_DENIED'</code> | The user denied the permission or the feature is disabled in settings.            |
-| **`INIT_FAILED`**       | <code>'INIT_FAILED'</code>       | The Settings plugin failed to initialize (e.g., runtime error or Looper failure). |
-| **`UNKNOWN_TYPE`**      | <code>'UNKNOWN_TYPE'</code>      | The requested Settings plugin type is not valid or not supported by the plugin.   |
-
-
 #### AndroidSettings
 
 | Members                      | Value                                   | Description                                                                                              |

package/android/src/main/java/io/capkit/settings/SettingsError.kt

@@ -0,0 +1,25 @@
+package io.capkit.settings
+
+/**
+ * Native error model for the Settings plugin (Android).
+ *
+ * IMPORTANT:
+ * - Extends Throwable to allow usage with Result.failure(...)
+ * - Must NOT reference Capacitor or JavaScript
+ * - Mapping to JS error codes happens ONLY in the Plugin layer
+ */
+sealed class SettingsError(
+  message: String,
+) : Throwable(message) {
+  /** Feature or capability is not available on this device */
+  class Unavailable(message: String) : SettingsError(message)
+
+  /** Permission was denied by the user or system */
+  class PermissionDenied(message: String) : SettingsError(message)
+
+  /** Plugin failed to initialize correctly */
+  class InitFailed(message: String) : SettingsError(message)
+
+  /** Unsupported or unknown type/value was provided */
+  class UnknownType(message: String) : SettingsError(message)
+}

package/android/src/main/java/io/capkit/settings/SettingsImpl.kt

@@ -6,17 +6,15 @@ import io.capkit.settings.utils.SettingsLogger
 import io.capkit.settings.utils.SettingsUtils
 
 /**
- * Platform-specific native implementation for the Settings plugin (Android).
- *
- * This class contains ONLY Android platform logic and MUST NOT:
- * - depend on Capacitor APIs
- * - reference PluginCall
- * - perform JS-related validation
- *
- * The Capacitor plugin (SettingsPlugin) is responsible for:
- * - reading configuration
- * - extracting call parameters
- * - resolving results to JavaScript
+ Native Android implementation for the Settings plugin.
+
+ Responsibilities:
+ - Perform platform logic
+ - Throw typed SettingsError values on failure
+
+ Forbidden:
+ - Accessing PluginCall
+ - Referencing Capacitor APIs
  */
 class SettingsImpl(
   private val context: Context,
@@ -46,50 +44,23 @@ class SettingsImpl(
   /**
    * Opens an Android system settings screen.
    *
-   * The operation is considered successful if:
-   * - the option maps to a valid Intent
-   * - an Activity exists to handle the Intent
-   *
-   * No Activity result is awaited, by design.
-   *
-   * @param option JavaScript-facing settings key
-   * @return standardized Result object (state-based)
+   * @throws SettingsError if the operation fails
    */
-  fun open(option: String): Result {
-    SettingsLogger.debug("Requested Android settings option:", option)
-
+  fun open(option: String) {
     val intent =
       SettingsUtils.resolveIntent(option, context.packageName)
-        ?: return Result(
-          success = false,
-          error = "Requested setting is not available on Android",
-          code = "UNAVAILABLE",
+        ?: throw SettingsError.Unavailable(
+          "Requested setting is not available on Android",
         )
 
     intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
 
-    return if (intent.resolveActivity(context.packageManager) != null) {
-      context.startActivity(intent)
-      SettingsLogger.debug("Android settings activity started:", intent.action ?: "unknown")
-      Result(success = true)
-    } else {
-      SettingsLogger.error("No activity found to handle intent for option: $option")
-      Result(
-        success = false,
-        error = "Cannot open settings URL",
-        code = "UNAVAILABLE",
+    if (intent.resolveActivity(context.packageManager) == null) {
+      throw SettingsError.Unavailable(
+        "No activity found to handle settings intent",
       )
     }
-  }
 
-  /**
-   * Standardized result returned by Settings operations.
-   *
-   * This mirrors the iOS result model and the public TypeScript API.
-   */
-  data class Result(
-    val success: Boolean,
-    val error: String? = null,
-    val code: String? = null,
-  )
+    context.startActivity(intent)
+  }
 }

package/android/src/main/java/io/capkit/settings/SettingsPlugin.kt

@@ -21,20 +21,35 @@ import com.getcapacitor.annotation.CapacitorPlugin
   name = "Settings",
 )
 class SettingsPlugin : Plugin() {
+  // ---------------------------------------------------------------------------
+  // Properties
+  // ---------------------------------------------------------------------------
+
   /**
-   * Plugin configuration parsed from capacitor.config.ts.
+   * Immutable plugin configuration parsed from capacitor.config.ts.
    */
   private lateinit var config: SettingsConfig
 
   /**
-   * Native implementation containing Android-specific logic.
+   * Native implementation containing platform-specific logic only.
+   *
+   * IMPORTANT:
+   * - Must NOT access PluginCall
+   * - Must NOT reference Capacitor APIs
    */
   private lateinit var implementation: SettingsImpl
 
+  // ---------------------------------------------------------------------------
+  // Lifecycle
+  // ---------------------------------------------------------------------------
+
   /**
-   * Plugin lifecycle entry point.
+   * Called once when the plugin is loaded by the Capacitor bridge.
    *
-   * Called exactly once when the plugin is loaded.
+   * This is the correct place to:
+   * - read static configuration
+   * - initialize native resources
+   * - inject configuration into the implementation
    */
   override fun load() {
     super.load()
@@ -44,7 +59,35 @@ class SettingsPlugin : Plugin() {
     implementation.updateConfig(config)
   }
 
-  // --- Open Settings ---
+  // ---------------------------------------------------------------------------
+  // Error Mapping
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Maps native SettingsError instances to JS-facing SettingsErrorCode values.
+   *
+   * IMPORTANT:
+   * - This is the ONLY place where native errors are translated
+   * - SettingsImpl must NEVER know about JS or Capacitor error codes
+   */
+  private fun reject(
+    call: PluginCall,
+    error: SettingsError,
+  ) {
+    val code =
+      when (error) {
+        is SettingsError.Unavailable -> "UNAVAILABLE"
+        is SettingsError.PermissionDenied -> "PERMISSION_DENIED"
+        is SettingsError.InitFailed -> "INIT_FAILED"
+        is SettingsError.UnknownType -> "UNKNOWN_TYPE"
+      }
+
+    call.reject(error.message, code)
+  }
+
+  // ---------------------------------------------------------------------------
+  // Open
+  // ---------------------------------------------------------------------------
 
   /**
    * Opens a platform-specific settings screen (legacy key).
@@ -52,24 +95,45 @@ class SettingsPlugin : Plugin() {
   @PluginMethod
   fun open(call: PluginCall) {
     val option = call.getString("optionAndroid") ?: ""
-    val result = implementation.open(option)
-    call.resolve(result.toJS())
+    handleOpen(call, option)
   }
 
+  // ---------------------------------------------------------------------------
+  // Open (Android)
+  // ---------------------------------------------------------------------------
+
   /**
    * Opens an Android settings screen.
    */
   @PluginMethod
   fun openAndroid(call: PluginCall) {
     val option = call.getString("option") ?: ""
-    val result = implementation.open(option)
-    call.resolve(result.toJS())
+    handleOpen(call, option)
   }
 
-  // --- Version ---
+  private fun handleOpen(
+    call: PluginCall,
+    option: String,
+  ) {
+    try {
+      implementation.open(option)
+      call.resolve()
+    } catch (error: SettingsError) {
+      reject(call, error)
+    }
+  }
+
+  // ---------------------------------------------------------------------------
+  // Version
+  // ---------------------------------------------------------------------------
 
   /**
    * Returns the native plugin version.
+   *
+   * NOTE:
+   * - This method is guaranteed not to fail
+   * - Therefore it does NOT use TestError
+   * - Version is injected at build time from package.json
    */
   @PluginMethod
   fun getPluginVersion(call: PluginCall) {
@@ -77,15 +141,4 @@ class SettingsPlugin : Plugin() {
     ret.put("version", BuildConfig.PLUGIN_VERSION)
     call.resolve(ret)
   }
-
-  /**
-   * Converts a native Result into a JSObject.
-   */
-  private fun SettingsImpl.Result.toJS(): JSObject {
-    val obj = JSObject()
-    obj.put("success", success)
-    if (error != null) obj.put("error", error)
-    if (code != null) obj.put("code", code)
-    return obj
-  }
 }

package/dist/docs.json

@@ -7,7 +7,7 @@
     "methods": [
       {
         "name": "open",
-        "signature": "(options: PlatformOptions) => Promise<SettingsResult>",
+        "signature": "(options: PlatformOptions) => Promise<void>",
         "parameters": [
           {
             "name": "options",
@@ -15,7 +15,7 @@
             "type": "PlatformOptions"
           }
         ],
-        "returns": "Promise<SettingsResult>",
+        "returns": "Promise<void>",
         "tags": [
           {
             "name": "param",
@@ -32,14 +32,13 @@
         ],
         "docs": "Opens the specified settings option on the current platform.\nOn Web, this method is not supported.",
         "complexTypes": [
-          "SettingsResult",
           "PlatformOptions"
         ],
         "slug": "open"
       },
       {
         "name": "openIOS",
-        "signature": "(options: IOSOptions) => Promise<SettingsResult>",
+        "signature": "(options: IOSOptions) => Promise<void>",
         "parameters": [
           {
             "name": "options",
@@ -47,7 +46,7 @@
             "type": "IOSOptions"
           }
         ],
-        "returns": "Promise<SettingsResult>",
+        "returns": "Promise<void>",
         "tags": [
           {
             "name": "platforms",
@@ -72,14 +71,13 @@
         ],
         "docs": "Opens a specific system settings section. (iOS Only)",
         "complexTypes": [
-          "SettingsResult",
           "IOSOptions"
         ],
         "slug": "openios"
       },
       {
         "name": "openAndroid",
-        "signature": "(options: AndroidOptions) => Promise<SettingsResult>",
+        "signature": "(options: AndroidOptions) => Promise<void>",
         "parameters": [
           {
             "name": "options",
@@ -87,7 +85,7 @@
             "type": "AndroidOptions"
           }
         ],
-        "returns": "Promise<SettingsResult>",
+        "returns": "Promise<void>",
         "tags": [
           {
             "name": "platforms",
@@ -108,7 +106,6 @@
         ],
         "docs": "Opens a specific Android Intent. (Android Only)\nOn Web, this method is not supported.",
         "complexTypes": [
-          "SettingsResult",
           "AndroidOptions"
         ],
         "slug": "openandroid"
@@ -142,43 +139,6 @@
     "properties": []
   },
   "interfaces": [
-    {
-      "name": "SettingsResult",
-      "slug": "settingsresult",
-      "docs": "Response object for settings open operations.\n\nAll platforms return a state-based result object.\nPromise rejection is NOT used.",
-      "tags": [],
-      "methods": [],
-      "properties": [
-        {
-          "name": "success",
-          "tags": [],
-          "docs": "Indicates if the operation was successful.",
-          "complexTypes": [],
-          "type": "boolean"
-        },
-        {
-          "name": "error",
-          "tags": [],
-          "docs": "Human-readable error message, if the operation failed.",
-          "complexTypes": [],
-          "type": "string | undefined"
-        },
-        {
-          "name": "code",
-          "tags": [
-            {
-              "text": "SettingsErrorCode.UNAVAILABLE",
-              "name": "example"
-            }
-          ],
-          "docs": "Machine-readable error code.\n\nThis field is present when `success` is false and allows\nprogrammatic handling of platform limitations or failures.",
-          "complexTypes": [
-            "SettingsErrorCode"
-          ],
-          "type": "SettingsErrorCode"
-        }
-      ]
-    },
     {
       "name": "PlatformOptions",
       "slug": "platformoptions",
@@ -309,36 +269,6 @@
     }
   ],
   "enums": [
-    {
-      "name": "SettingsErrorCode",
-      "slug": "settingserrorcode",
-      "members": [
-        {
-          "name": "UNAVAILABLE",
-          "value": "'UNAVAILABLE'",
-          "tags": [],
-          "docs": "The device does not have the requested hardware."
-        },
-        {
-          "name": "PERMISSION_DENIED",
-          "value": "'PERMISSION_DENIED'",
-          "tags": [],
-          "docs": "The user denied the permission or the feature is disabled in settings."
-        },
-        {
-          "name": "INIT_FAILED",
-          "value": "'INIT_FAILED'",
-          "tags": [],
-          "docs": "The Settings plugin failed to initialize (e.g., runtime error or Looper failure)."
-        },
-        {
-          "name": "UNKNOWN_TYPE",
-          "value": "'UNKNOWN_TYPE'",
-          "tags": [],
-          "docs": "The requested Settings plugin type is not valid or not supported by the plugin."
-        }
-      ]
-    },
     {
       "name": "AndroidSettings",
       "slug": "androidsettings",

package/dist/esm/definitions.d.ts

@@ -91,31 +91,6 @@ export interface SettingsError {
      */
     code: SettingsErrorCode;
 }
-/**
- * Response object for settings open operations.
- *
- * All platforms return a state-based result object.
- * Promise rejection is NOT used.
- */
-export interface SettingsResult {
-    /**
-     * Indicates if the operation was successful.
-     */
-    success: boolean;
-    /**
-     * Human-readable error message, if the operation failed.
-     */
-    error?: string;
-    /**
-     * Machine-readable error code.
-     *
-     * This field is present when `success` is false and allows
-     * programmatic handling of platform limitations or failures.
-     *
-     * @example SettingsErrorCode.UNAVAILABLE
-     */
-    code?: SettingsErrorCode;
-}
 /**
  * Platform-specific options for opening system settings.
  *
@@ -633,7 +608,7 @@ export interface SettingsPlugin {
      *
      * @since 1.0.0
      */
-    open(options: PlatformOptions): Promise<SettingsResult>;
+    open(options: PlatformOptions): Promise<void>;
     /**
      * Opens a specific system settings section. (iOS Only)
      *
@@ -654,7 +629,7 @@ export interface SettingsPlugin {
      *
      * @since 1.0.0
      */
-    openIOS(options: IOSOptions): Promise<SettingsResult>;
+    openIOS(options: IOSOptions): Promise<void>;
     /**
      * Opens a specific Android Intent. (Android Only)
      * On Web, this method is not supported.
@@ -666,7 +641,7 @@ export interface SettingsPlugin {
      *
      * @since 1.0.0
      */
-    openAndroid(options: AndroidOptions): Promise<SettingsResult>;
+    openAndroid(options: AndroidOptions): Promise<void>;
     /**
      * Returns the native plugin version.
      *

package/dist/esm/definitions.js.map

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

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import { SettingsPlugin, SettingsResult, PluginVersionResult } from './definitions';
+import { SettingsPlugin, PluginVersionResult } from './definitions';
 /**
  * Web implementation of the Settings plugin.
  *
@@ -20,19 +20,19 @@ export declare class SettingsWeb extends WebPlugin implements SettingsPlugin {
      * This operation is not supported on the Web, as browsers do not
      * provide APIs to open operating system settings.
      */
-    open(): Promise<SettingsResult>;
+    open(): Promise<void>;
     /**
      * Attempts to open an iOS settings screen.
      *
      * This operation is not supported on the Web.
      */
-    openIOS(): Promise<SettingsResult>;
+    openIOS(): Promise<void>;
     /**
      * Attempts to open an Android settings screen.
      *
      * This operation is not supported on the Web.
      */
-    openAndroid(): Promise<SettingsResult>;
+    openAndroid(): Promise<void>;
     /**
      * Returns the plugin version.
      *

package/dist/esm/web.js

@@ -1,5 +1,4 @@
 import { WebPlugin } from '@capacitor/core';
-import { SettingsErrorCode } from './definitions';
 /**
  * Web implementation of the Settings plugin.
  *
@@ -24,11 +23,7 @@ export class SettingsWeb extends WebPlugin {
      * provide APIs to open operating system settings.
      */
     async open() {
-        return {
-            success: false,
-            error: 'Opening system settings is not supported on the Web.',
-            code: SettingsErrorCode.UNAVAILABLE,
-        };
+        this.unavailable('Opening system settings is not supported on the Web.');
     }
     /**
      * Attempts to open an iOS settings screen.
@@ -36,11 +31,7 @@ export class SettingsWeb extends WebPlugin {
      * This operation is not supported on the Web.
      */
     async openIOS() {
-        return {
-            success: false,
-            error: 'iOS settings are not available in web environments.',
-            code: SettingsErrorCode.UNAVAILABLE,
-        };
+        this.unavailable('iOS settings are not available in web environments.');
     }
     /**
      * Attempts to open an Android settings screen.
@@ -48,11 +39,7 @@ export class SettingsWeb extends WebPlugin {
      * This operation is not supported on the Web.
      */
     async openAndroid() {
-        return {
-            success: false,
-            error: 'Android settings are not available in web environments.',
-            code: SettingsErrorCode.UNAVAILABLE,
-        };
+        this.unavailable('Android settings are not available in web environments.');
     }
     // --- Plugin Info ---
     /**

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAuD,MAAM,eAAe,CAAC;AAEvG;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,wBAAwB;IAExB;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACR,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sDAAsD;YAC7D,IAAI,EAAE,iBAAiB,CAAC,WAAW;SACpC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,qDAAqD;YAC5D,IAAI,EAAE,iBAAiB,CAAC,WAAW;SACpC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,yDAAyD;YAChE,IAAI,EAAE,iBAAiB,CAAC,WAAW;SACpC,CAAC;IACJ,CAAC;IAED,sBAAsB;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,wBAAwB;IAExB;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,WAAW,CAAC,sDAAsD,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,WAAW,CAAC,qDAAqD,CAAC,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,WAAW,CAAC,yDAAyD,CAAC,CAAC;IAC9E,CAAC;IAED,sBAAsB;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}