@capgo/inappbrowser 7.3.2 → 7.4.0

package/android/src/main/res/drawable/ic_share.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M18,16.08c-0.76,0 -1.44,0.3 -1.96,0.77L8.91,12.7c0.05,-0.23 0.09,-0.46 0.09,-0.7s-0.04,-0.47 -0.09,-0.7l7.05,-4.11c0.54,0.5 1.25,0.81 2.04,0.81 1.66,0 3,-1.34 3,-3s-1.34,-3 -3,-3 -3,1.34 -3,3c0,0.24 0.04,0.47 0.09,0.7L8.04,9.81C7.5,9.31 6.79,9 6,9c-1.66,0 -3,1.34 -3,3s1.34,3 3,3c0.79,0 1.5,-0.31 2.04,-0.81l7.12,4.16c-0.05,0.21 -0.08,0.43 -0.08,0.65 0,1.61 1.31,2.92 2.92,2.92 1.61,0 2.92,-1.31 2.92,-2.92s-1.31,-2.92 -2.92,-2.92z"/>
+</vector> 

package/android/src/main/res/layout/activity_browser.xml

@@ -6,9 +6,17 @@
     android:layout_height="match_parent"
     tools:context="com.cap.browser.plugin.WebViewActivity">
 
+    <!-- Status bar color view that will be positioned at the top -->
+    <View
+        android:id="@+id/status_bar_color_view"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="@android:color/transparent" />
+
     <com.google.android.material.appbar.AppBarLayout
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
+        android:layout_marginTop="0dp"
         android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
 
         <include

package/android/src/main/res/layout/tool_bar.xml

@@ -19,15 +19,15 @@
 
     <ImageButton
         android:id="@+id/buttonNearDone"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:layout_gravity="start"
-        android:background="@android:color/transparent"
+        android:layout_width="48dp"
+        android:layout_height="48dp"
+        android:layout_gravity="end"
+        android:layout_marginEnd="8dp"
+        android:background="?attr/selectableItemBackgroundBorderless"
         android:contentDescription="@string/button_near_done"
+        android:padding="12dp"
         android:src="@drawable/ic_clear_24px"
-        android:translationX="64px"
-        tools:visibility="gone"
-        />
+        android:visibility="gone" />
     <ImageButton
         android:id="@+id/reloadButton"
         android:layout_width="wrap_content"
@@ -50,6 +50,18 @@
         android:singleLine="false"
         android:textColor="#262626" />
 
+    <ImageButton
+        android:id="@+id/shareButton"
+        android:layout_width="48dp"
+        android:layout_height="48dp"
+        android:layout_gravity="end"
+        android:layout_marginEnd="8dp"
+        android:background="?attr/selectableItemBackgroundBorderless"
+        android:contentDescription="@string/share_button"
+        android:padding="12dp"
+        android:src="@drawable/ic_share"
+        android:visibility="gone" />
+
     <ImageButton
         android:id="@+id/forwardButton"
         android:layout_width="wrap_content"

package/android/src/main/res/values/strings.xml

@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="my_string">Just a simple string</string>
     <string name="title_activity_browser">BrowserActivity</string>
@@ -8,4 +9,5 @@
     <string name="back_button">Back Button</string>
     <string name="title">Title</string>
     <string name="forward_button">Forward Button</string>
+    <string name="share_button">Share</string>
 </resources>

package/dist/docs.json

@@ -136,7 +136,7 @@
             "text": "0.1.0"
           }
         ],
-        "docs": "Open url in a new webview with toolbars, and enhanced capabilities, like camera access, file access, listen events, inject javascript, bi directional communication, etc.",
+        "docs": "Open url in a new webview with toolbars, and enhanced capabilities, like camera access, file access, listen events, inject javascript, bi directional communication, etc.\n\nJavaScript Interface:\nWhen you open a webview with this method, a JavaScript interface is automatically injected that provides:\n- `window.mobileApp.close()`: Closes the webview from JavaScript\n- `window.mobileApp.postMessage(obj)`: Sends a message from the webview to the app",
         "complexTypes": [
           "OpenWebViewOptions"
         ],
@@ -468,8 +468,13 @@
         },
         {
           "name": "preventDeeplink",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "if true the deeplink will not be opened, if false the deeplink will be opened when clicked on the link",
           "complexTypes": [],
           "type": "boolean | undefined"
         }
@@ -588,6 +593,10 @@
             {
               "text": "0.1.0",
               "name": "since"
+            },
+            {
+              "text": "\"https://capgo.app\"",
+              "name": "example"
             }
           ],
           "docs": "Target URL to load.",
@@ -600,6 +609,10 @@
             {
               "text": "0.1.0",
               "name": "since"
+            },
+            {
+              "text": "headers: {\n  'Custom-Header': 'test-value',\n  'Authorization': 'Bearer test-token'\n}\nTest URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/",
+              "name": "example"
             }
           ],
           "docs": "Headers to send with the request.",
@@ -614,6 +627,10 @@
             {
               "text": "6.1.0",
               "name": "since"
+            },
+            {
+              "text": "credentials: {\n  username: 'test-user',\n  password: 'test-pass'\n}\nTest URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/",
+              "name": "example"
             }
           ],
           "docs": "Credentials to send with the request and all subsequent requests for the same host.",
@@ -622,15 +639,35 @@
           ],
           "type": "Credentials"
         },
+        {
+          "name": "jsInterface",
+          "tags": [
+            {
+              "text": "// In your webpage loaded in the webview:\ndocument.getElementById('closeBtn').addEventListener('click', () => {\n  window.mobileApp.close();\n});\n\n// Send data to the app\nwindow.mobileApp.postMessage({ action: 'login', data: { user: 'test' }});",
+              "name": "example"
+            },
+            {
+              "text": "6.10.0",
+              "name": "since"
+            }
+          ],
+          "docs": "JavaScript Interface:\nThe webview automatically injects a JavaScript interface providing:\n- `window.mobileApp.close()`: Closes the webview from JavaScript\n- `window.mobileApp.postMessage(obj)`: Sends a message to the app (listen via \"messageFromWebview\" event)",
+          "complexTypes": [],
+          "type": "undefined"
+        },
         {
           "name": "shareDisclaimer",
           "tags": [
             {
               "text": "0.1.0",
               "name": "since"
+            },
+            {
+              "text": "shareDisclaimer: {\n  title: 'Disclaimer',\n  message: 'This is a test disclaimer',\n  confirmBtn: 'Accept',\n  cancelBtn: 'Decline'\n}\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
-          "docs": "share options",
+          "docs": "Share options for the webview. When provided, shows a disclaimer dialog before sharing content.\nThis is useful for:\n- Warning users about sharing sensitive information\n- Getting user consent before sharing\n- Explaining what will be shared\n- Complying with privacy regulations\n\nNote: shareSubject is required when using shareDisclaimer",
           "complexTypes": [
             "DisclaimerOptions"
           ],
@@ -646,9 +683,13 @@
             {
               "text": "ToolBarType.DEFAULT",
               "name": "default"
+            },
+            {
+              "text": "toolbarType: ToolBarType.ACTIVITY,\ntitle: 'Activity Toolbar Test'\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
-          "docs": "Toolbar type",
+          "docs": "Toolbar type determines the appearance and behavior of the browser's toolbar\n- \"activity\": Shows a simple toolbar with just a close button and share button\n- \"navigation\": Shows a full navigation toolbar with back/forward buttons\n- \"blank\": Shows no toolbar\n- \"\": Default toolbar with close button",
           "complexTypes": [
             "ToolBarType"
           ],
@@ -660,9 +701,13 @@
             {
               "text": "0.1.0",
               "name": "since"
+            },
+            {
+              "text": "\"Share this page\"",
+              "name": "example"
             }
           ],
-          "docs": "Share subject",
+          "docs": "Subject text for sharing. Required when using shareDisclaimer.\nThis text will be used as the subject line when sharing content.",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -676,6 +721,10 @@
             {
               "text": "'New Window'",
               "name": "default"
+            },
+            {
+              "text": "\"Camera Test\"",
+              "name": "example"
             }
           ],
           "docs": "Title of the browser",
@@ -706,6 +755,10 @@
             {
               "text": "false",
               "name": "default"
+            },
+            {
+              "text": "activeNativeNavigationForWebview: true,\ndisableGoBackOnNativeApplication: true\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
           "docs": "If true, active the native navigation within the webview, Android only",
@@ -718,9 +771,13 @@
             {
               "text": "false",
               "name": "default"
+            },
+            {
+              "text": "disableGoBackOnNativeApplication: true\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
-          "docs": "Disable the possibility to go back on native application,\nusefull to force user to stay on the webview, Android only",
+          "docs": "Disable the possibility to go back on native application,\nuseful to force user to stay on the webview, Android only",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
@@ -734,9 +791,13 @@
             {
               "text": "false",
               "name": "default"
+            },
+            {
+              "text": "isPresentAfterPageLoad: true,\npreShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
-          "docs": "Open url in a new window fullscreen\n\nisPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.",
+          "docs": "Open url in a new window fullscreen\nisPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
@@ -774,6 +835,10 @@
             {
               "text": "false",
               "name": "default"
+            },
+            {
+              "text": "showReloadButton: true\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
           "docs": "Shows a reload button that reloads the web page",
@@ -790,6 +855,10 @@
             {
               "text": "false",
               "name": "default"
+            },
+            {
+              "text": "closeModal: true,\ncloseModalTitle: 'Close Window',\ncloseModalDescription: 'Are you sure you want to close?',\ncloseModalOk: 'Yes, close',\ncloseModalCancel: 'No, stay'\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
           "docs": "CloseModal: if true a confirm will be displayed when user clicks on close button, if false the browser will be closed immediately.",
@@ -808,7 +877,7 @@
               "name": "default"
             }
           ],
-          "docs": "CloseModalTitle: title of the confirm when user clicks on close button, only on IOS",
+          "docs": "CloseModalTitle: title of the confirm when user clicks on close button",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -824,7 +893,7 @@
               "name": "default"
             }
           ],
-          "docs": "CloseModalDescription: description of the confirm when user clicks on close button, only on IOS",
+          "docs": "CloseModalDescription: description of the confirm when user clicks on close button",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -840,7 +909,7 @@
               "name": "default"
             }
           ],
-          "docs": "CloseModalOk: text of the confirm button when user clicks on close button, only on IOS",
+          "docs": "CloseModalOk: text of the confirm button when user clicks on close button",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -856,7 +925,7 @@
               "name": "default"
             }
           ],
-          "docs": "CloseModalCancel: text of the cancel button when user clicks on close button, only on IOS",
+          "docs": "CloseModalCancel: text of the cancel button when user clicks on close button",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -884,14 +953,38 @@
               "name": "since"
             },
             {
-              "text": "'#ffffff''",
+              "text": "'#ffffff'",
               "name": "default"
+            },
+            {
+              "text": "toolbarColor: '#FF5733'\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
           "docs": "toolbarColor: color of the toolbar in hex format",
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "toolbarTextColor",
+          "tags": [
+            {
+              "text": "6.10.0",
+              "name": "since"
+            },
+            {
+              "text": "calculated based on toolbarColor brightness",
+              "name": "default"
+            },
+            {
+              "text": "toolbarTextColor: '#FFFFFF'\nTest URL: https://capgo.app",
+              "name": "example"
+            }
+          ],
+          "docs": "toolbarTextColor: color of the buttons and title in the toolbar in hex format\nWhen set, it overrides the automatic light/dark mode detection for text color",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
           "name": "showArrow",
           "tags": [
@@ -902,6 +995,10 @@
             {
               "text": "false",
               "name": "default"
+            },
+            {
+              "text": "showArrow: true\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
           "docs": "showArrow: if true an arrow would be shown instead of cross for closing the window",
@@ -930,6 +1027,10 @@
             {
               "text": "6.6.0",
               "name": "since"
+            },
+            {
+              "text": "preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
           "docs": "preShowScript: if isPresentAfterPageLoad is true and this variable is set the plugin will inject a script before showing the browser.\nThis script will be run in an async context. The plugin will wait for the script to finish (max 10 seconds)",
@@ -954,11 +1055,15 @@
             {
               "text": "6.7.0",
               "name": "since"
+            },
+            {
+              "text": "buttonNearDone: {\n  ios: {\n    iconType: 'sf-symbol',\n    icon: 'star.fill'\n  },\n  android: {\n    iconType: 'asset',\n    icon: 'public/monkey.svg',\n    width: 24,\n    height: 24\n  }\n}\nTest URL: https://capgo.app",
+              "name": "example"
             }
           ],
-          "docs": "buttonNearDone allows for a creation of a custom button. Please see [buttonNearDone.md](/buttonNearDone.md) for more info.",
+          "docs": "buttonNearDone allows for a creation of a custom button near the done/close button.\nThe button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n\nFor Android:\n- iconType must be \"asset\"\n- icon path should be in the public folder (e.g. \"monkey.svg\")\n- width and height are optional, defaults to 48dp\n- button is positioned at the end of toolbar with 8dp margin\n\nFor iOS:\n- iconType can be \"sf-symbol\" or \"asset\"\n- for sf-symbol, icon should be the symbol name\n- for asset, icon should be the asset name",
           "complexTypes": [],
-          "type": "{ ios: { iconType: 'sf-symbol' | 'asset'; icon: string; }; android: { iconType: 'asset'; icon: string; width?: number | undefined; height?: number | undefined; }; } | undefined"
+          "type": "{ ios: { iconType: 'sf-symbol' | 'asset'; icon: string; }; android: { iconType: 'asset' | 'vector'; icon: string; width?: number | undefined; height?: number | undefined; }; } | undefined"
         }
       ]
     },
@@ -971,29 +1076,49 @@
       "properties": [
         {
           "name": "title",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "\"Title\"",
+              "name": "default"
+            }
+          ],
+          "docs": "Title of the disclaimer dialog",
           "complexTypes": [],
           "type": "string"
         },
         {
           "name": "message",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "\"Message\"",
+              "name": "default"
+            }
+          ],
+          "docs": "Message shown in the disclaimer dialog",
           "complexTypes": [],
           "type": "string"
         },
         {
           "name": "confirmBtn",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "\"Confirm\"",
+              "name": "default"
+            }
+          ],
+          "docs": "Text for the confirm button",
           "complexTypes": [],
           "type": "string"
         },
         {
           "name": "cancelBtn",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "\"Cancel\"",
+              "name": "default"
+            }
+          ],
+          "docs": "Text for the cancel button",
           "complexTypes": [],
           "type": "string"
         }
@@ -1066,26 +1191,35 @@
         {
           "name": "ACTIVITY",
           "value": "\"activity\"",
-          "tags": [],
-          "docs": ""
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Shows a simple toolbar with just a close button and share button"
         },
         {
           "name": "NAVIGATION",
           "value": "\"navigation\"",
-          "tags": [],
-          "docs": ""
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Shows a full navigation toolbar with back/forward buttons"
         },
         {
           "name": "BLANK",
           "value": "\"blank\"",
-          "tags": [],
-          "docs": ""
-        },
-        {
-          "name": "DEFAULT",
-          "value": "\"\"",
-          "tags": [],
-          "docs": ""
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Shows no toolbar"
         }
       ]
     },