Merge branch 'main' into cla-check-v2

Author: cb1kenobi

docs/.vuepress/guide.json

@@ -1071,8 +1071,8 @@
                     ]
                 },
                 [
-                    "Titanium_SDK_How-tos/Migrate_a_Titanium_Application_to_the_Platform",
-                    "Migrate a Titanium Application to the Platform"
+                    "Titanium_SDK_How-tos/Adhere_to_the_iOS17_Privacy_Requirements",
+                    "Adhere to the iOS 17+ Privacy Requirements"
                 ],
                 {
                     "title": "Titanium Boilerplates",

docs/api/api.json

@@ -0,0 +1,8 @@
+---
+editUrl: https://github.com/appcelerator/titanium_mobile/edit/master/apidoc/Titanium/UI/RefreshControl.yml
+---
+# RefreshControlOffset
+
+<TypeHeader/>
+
+<ApiDocs/>

docs/api/structs/refreshcontroloffset.md

@@ -7,9 +7,24 @@ editUrl: https://github.com/appcelerator/titanium_mobile/edit/master/apidoc/Tita
 
 ## Overview
 
-By default when a listItem has [canEdit](Titanium.UI.ListItem.canEdit) set to true, a left swipe on the the row presens the 'Delete' button.
+Edit actions can be used to add contextual buttons to your list items / table view rows. The configuration of
+this API is the same for list items (if you use <Titanium.UI.ListView>) and table view rows (if you use <Titanium.UI.TableView).
+
+But please note that the trigger to activate these edit actions can defer based on the API you're integrating the edit actions:
+
+*List Views*:
+By default when a ListItem has [canEdit](Titanium.UI.ListItem.canEdit) set to `true`, a left swipe on the the row presens the localized 'Delete' button.
 This object lets developers define custom titles for editing actions supported on the row.
 This object is used in conjunction with the [editActions](Titanium.UI.ListItem.editActions) property and
 [editaction](Titanium.UI.ListView.editaction) event.
 
+*Table Views*:
+By default when a TableViewRow has [editable](Titanium.UI.TableViewRow.editable) set to `true`, a left swipe on the the row presens the localized 'Delete' button.
+This object lets developers define custom titles for editing actions supported on the row.
+This object is used in conjunction with the [editActions](Titanium.UI.TableViewRow.editActions) property and
+[editaction](Titanium.UI.TableView.editaction) event. For table views, this property was added in Titanium SDK 12.4.0.
+
+In addition, the new property "state" was added in 12.4.0 and can either equal "leading" or "trailing" to show them on a right swipe (leading)
+or left swipe (trailing). If the "state" property is not set, it defaults to "trailing" for backwards compatibility.
+
 <ApiDocs/>

docs/api/structs/rowactiontype.md

@@ -12,11 +12,11 @@ editUrl: https://github.com/appcelerator/titanium_mobile/edit/master/apidoc/Tita
 Creates a configuration object and use it as property of webview.
 
 ``` js
-var config = Ti.UI.iOS.createWebViewConfiguration({ 
+var config = Ti.UI.iOS.createWebViewConfiguration({
     allowsPictureInPictureMediaPlayback: true,
-    preferences: { 
+    preferences: {
         minimumFontSize : 20,
-    }, 
+    },
 });
 
 var webView = Ti.UI.createWebView({

docs/api/structs/webviewpreferencesobject.md

@@ -58,6 +58,15 @@ Adds action items and sets several properties on a window's action bar in the XM
 </Alloy>
 ```
 
+
+`app/controllers/index.js`:
+```
+function doMenuClick() {}
+function openSettings() {}
+function doSearch() {}
+$.index.open();
+```
+
 `app/styles/index.tss`:
 ```
 "MenuItem": {
@@ -89,7 +98,7 @@ if (OS_ANDROID) {
     win.activity.onCreate = () => {
         const actionBar = win.activity.actionBar;
         if (actionBar) {
-            actionBar.backgroundImage = "/bg.png";
+            actionBar.backgroundImage = Ti.Filesystem.getFile(Ti.Filesystem.resourcesDirectory, 'bg.png').nativePath;
             actionBar.title = "New Title";
             actionBar.onHomeIconItemSelected = () => {
                 Ti.API.info("Home icon clicked!");

docs/api/titanium/android/actionbar.md

@@ -31,7 +31,7 @@ var channel = Ti.Android.NotificationManager.createNotificationChannel({
         icon: Ti.Android.R.drawable.ic_dialog_info,
         contentTitle: 'TITLE',
         contentText : 'This is a test',
-        channelId: channel.getId()
+        channelId: channel.id
     });
 
 Ti.Android.NotificationManager.notify(100, notification);

docs/api/titanium/android/notificationchannel.md

@@ -24,10 +24,10 @@ Use the `name` attribute to define your property name and place the value inline
 Then, you can retrieve the property during runtime with the following API call:
 
 ``` js
-var foo = Ti.App.Properties.getString('foo');
+const foo = Ti.App.Properties.getString('foo');
 ```
 
-As of Release 3.2.0, any application properties defined in the `tiapp.xml` file are stored in the
+Any application properties defined in the `tiapp.xml` file are stored in the
 device's secure storage, making them read-only.  Additionally, external access to these
 properties is now restricted.  Other iOS applications cannot access these properties and
 native Android modules must use the Titanium module API TiApplication.getAppProperties()
@@ -36,8 +36,8 @@ method to access these properties.
 If you need to change the values during runtime, initially create the property with these APIs
 rather than defining them in the `tiapp.xml` file.
 
-Prior to Release 3.2.0, application properties defined in the `tiapp.xml` file could be
-overwritten by these APIs and accessed externally by other applications and modules.
+**Important**: Using this API in the Apple ecosystem requires the `NSPrivacyAccessedAPICategoryUserDefaults`
+property set in the privacy manifest that was introduced in iOS 17. You can learn more about it [here](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api).
 
 ## Examples
 

docs/api/titanium/app/properties.md

@@ -111,4 +111,65 @@ var label = Titanium.UI.createLabel({
 win.add(label);
 ```
 
+### Links with underline color.
+
+``` js
+const win = Ti.UI.createWindow({
+	backgroundColor: 'gray',
+	layout: 'vertical'
+});
+const lbl_a = createLink();
+const lbl_b = createLink();
+
+colorLink(lbl_b);
+
+win.add([lbl_a, lbl_b]);
+win.open();
+
+function createLink() {
+	const label = Ti.UI.createLabel({
+		top: 20,
+		attributedString: Ti.UI.createAttributedString({
+			text: 'Check out Titanium SDK',
+			attributes: [{
+				type: Ti.UI.ATTRIBUTE_LINK,
+				value: 'https://titaniumsdk.com',
+				range: [10, 12]
+			}]
+		})
+	});
+
+	label.addEventListener('link', e => {
+		Ti.Platform.openURL(e.url);
+	});
+
+	return label;
+}
+
+function colorLink(lbl) {
+	const attributedString = lbl.attributedString;
+	const textColor = 'purple';
+	const underlineColor = 'yellow';
+
+	for (const attribute of attributedString.attributes) {
+		if (attribute.type === Ti.UI.ATTRIBUTE_LINK) {
+
+			// Set new link color.
+			attributedString.addAttribute({
+				type: Ti.UI.ATTRIBUTE_FOREGROUND_COLOR,
+				value: textColor,
+				range: attribute.range
+			});
+
+			// Set new underline color.
+			attributedString.addAttribute({
+				type: Ti.UI.ATTRIBUTE_UNDERLINE_COLOR,
+				value: underlineColor,
+				range: attribute.range
+			});
+		}
+	}
+}
+```
+
 <ApiDocs/>

docs/api/titanium/ui/attributedstring.md

@@ -8,9 +8,11 @@ editUrl: https://github.com/appcelerator/titanium_mobile/edit/master/apidoc/Tita
 ## Overview
 
 Use the <Titanium.UI.iOS.createWebViewConfiguration> method to create and use as a parameter of <Titanium.UI.WebView.configuration>.
-Using this you can determine how soon a webpage is rendered, how media playback is handled, the granularity of items that the 
+Using this you can determine how soon a webpage is rendered, how media playback is handled, the granularity of items that the
 user can select, and many other options. This property can only be set when creating the webview and will be ignored when set afterwards.
 
 See the example section "Usage of WebViewConfiguration with WebView in iOS".
+Information on additional available preferences can be derived from the original WebKit sources:
+[WKPreferences.mm](https://github.com/WebKit/webkit/blob/main/Source/WebKit/UIProcess/API/Cocoa/WKPreferences.mm)
 
 <ApiDocs/>