@maccesar/titools 2.0.6 → 2.2.0

package/skills/ti-ui/references/gestures.md

@@ -1,45 +1,5 @@
 # Gestures
 
-## Table of Contents
-
-- [Gestures](#gestures)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. Touch Events](#2-touch-events)
-    - [Touch Lifecycle](#touch-lifecycle)
-    - [Touch Event Properties](#touch-event-properties)
-    - [Android Note](#android-note)
-  - [3. Swipe Gesture](#3-swipe-gesture)
-    - [Basic Swipe](#basic-swipe)
-    - [Swipe Direction Detection](#swipe-direction-detection)
-    - [Swipe vs Scroll](#swipe-vs-scroll)
-  - [4. Pinch Gesture (iOS Only)](#4-pinch-gesture-ios-only)
-    - [Pinch to Zoom](#pinch-to-zoom)
-  - [5. Long Press Gesture](#5-long-press-gesture)
-    - [Basic Long Press](#basic-long-press)
-    - [Long Press Duration](#long-press-duration)
-    - [Android Long Press Convention](#android-long-press-convention)
-  - [6. Shake Gesture](#6-shake-gesture)
-    - [Detecting Shake](#detecting-shake)
-    - [Shake Example](#shake-example)
-    - [Testing Shake](#testing-shake)
-  - [7. Accelerometer as Input](#7-accelerometer-as-input)
-    - [Basic Accelerometer](#basic-accelerometer)
-    - [Accelerometer Properties](#accelerometer-properties)
-    - [Using Accelerometer for Control](#using-accelerometer-for-control)
-    - [Smoothing Accelerometer Data](#smoothing-accelerometer-data)
-  - [8. Gesture Lifecycle Management](#8-gesture-lifecycle-management)
-    - [Battery Considerations](#battery-considerations)
-  - [9. Platform-Specific Considerations](#9-platform-specific-considerations)
-    - [iOS](#ios)
-    - [Android](#android)
-  - [10. Best Practices](#10-best-practices)
-  - [11. Combining Gestures](#11-combining-gestures)
-    - [Multiple Gesture Types](#multiple-gesture-types)
-    - [Preventing Gesture Conflicts](#preventing-gesture-conflicts)
-
----
-
 ## 1. Overview
 
 Titanium supports various gestures beyond simple taps:

package/skills/ti-ui/references/icons-and-splash-screens.md

@@ -1,47 +1,5 @@
 # Icons and Splash Screens
 
-## Table of Contents
-
-- [Icons and Splash Screens](#icons-and-splash-screens)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. Asset Locations](#2-asset-locations)
-  - [3. DefaultIcon.png (Recommended)](#3-defaulticonpng-recommended)
-  - [4. iOS Icons](#4-ios-icons)
-    - [App Icons](#app-icons)
-    - [Spotlight \& Settings Icons](#spotlight--settings-icons)
-    - [iOS Splash Screens](#ios-splash-screens)
-    - [iTunes Artwork (Ad-Hoc builds)](#itunes-artwork-ad-hoc-builds)
-    - [iTunes Connect Requirements](#itunes-connect-requirements)
-  - [5. Android Icons](#5-android-icons)
-    - [Launcher Icons](#launcher-icons)
-    - [Action Bar Icons](#action-bar-icons)
-    - [Notification Icons](#notification-icons)
-    - [Google Play Requirements](#google-play-requirements)
-  - [6. Android Splash Screens](#6-android-splash-screens)
-    - [Android 12+ (SDK 12.0.0+)](#android-12-sdk-1200)
-    - [Android \< 12 (Legacy)](#android--12-legacy)
-      - [Nine-Patch Images (Recommended)](#nine-patch-images-recommended)
-      - [Density-Specific Splash Screens](#density-specific-splash-screens)
-      - [Custom Theme Splash Screen](#custom-theme-splash-screen)
-  - [7. Localized Splash Screens](#7-localized-splash-screens)
-    - [Android Localization](#android-localization)
-    - [iOS Localization](#ios-localization)
-  - [8. Adaptive Icons (Android 8.0+)](#8-adaptive-icons-android-80)
-  - [9. Common Issues](#9-common-issues)
-    - [Build Fails - Missing Icons](#build-fails---missing-icons)
-    - [Android Splash Stretched/Distorted](#android-splash-stretcheddistorted)
-    - [iOS Icons Not Updating](#ios-icons-not-updating)
-    - [Android 12 Splash Not Showing Custom Image](#android-12-splash-not-showing-custom-image)
-  - [11. iOS Launch Files (Storyboards)](#11-ios-launch-files-storyboards)
-    - [Enabling Launch Storyboards](#enabling-launch-storyboards)
-    - [Customizing Background Color](#customizing-background-color)
-    - [Using Images in Storyboards](#using-images-in-storyboards)
-    - [Launch File Cache](#launch-file-cache)
-  - [Best Practices](#best-practices)
-
----
-
 ## 1. Overview
 
 App icons and splash screens are required for app store submissions and provide visual branding during app launch.
@@ -93,6 +51,8 @@ Place a single `DefaultIcon.png` (1024x1024px) in project root. Titanium auto-ge
 | Universal retina     | Settings  | 58x58      | `appicon-Small@2x.png`    |
 | iPhone 6 Plus+       | Settings  | 87x87      | `appicon-Small@3x.png`    |
 
+**App Thinning note:** Application icons and launch images are added to the Asset Catalog to support App Thinning. Due to this change, you cannot reference launch image assets from the filesystem (e.g., you cannot set `backgroundImage` to a launch image file).
+
 ### iOS Splash Screens
 
 | Device                                  | Dimensions | Filename                         |
@@ -149,7 +109,9 @@ Place a single `DefaultIcon.png` (1024x1024px) in project root. Titanium auto-ge
 | hdpi    | 240 | 72x72      | `platform/android/res/drawable-hdpi/appicon.png`    |
 | xhdpi   | 320 | 96x96      | `platform/android/res/drawable-xhdpi/appicon.png`   |
 | xxhdpi  | 480 | 144x144    | `platform/android/res/drawable-xxhdpi/appicon.png`  |
-| xxxhdpi | 640 | 192x192    | `platform/android/res/drawable-xxxhdpi/appicon.png` |
+| xxxhdpi | 640 | 512x512    | `platform/android/res/drawable-xxxhdpi/appicon.png` |
+
+The filename must match the `icon` element in your tiapp.xml file. By default, newly created projects use `Resources/android/appicon.png`.
 
 ### Action Bar Icons
 
@@ -162,6 +124,17 @@ Place a single `DefaultIcon.png` (1024x1024px) in project root. Titanium auto-ge
 | xxhdpi  | 72x72      | `Resources/android/images/res-xxhdpi/`  | `app/assets/android/images/res-xxhdpi/`  |
 | xxxhdpi | 144x144    | `Resources/android/images/res-xxxhdpi/` | `app/assets/android/images/res-xxxhdpi/` |
 
+### Small and Contextual Icons
+
+Used for notification status bar icons and other small UI elements:
+
+| Density | Dimensions |
+| ------- | ---------- |
+| ldpi    | 12x12      |
+| mdpi    | 16x16      |
+| hdpi    | 24x24      |
+| xhdpi   | 32x32      |
+
 ### Notification Icons
 
 **Important:** Must be white-on-transparent background only.
@@ -222,7 +195,9 @@ Android 12 uses app icon as splash screen automatically. Use **Adaptive Icons**
 
 ### Android < 12 (Legacy)
 
-Use `default.png` or nine-patch images.
+Use `default.png` or nine-patch images. Android uses `default.png` (lowercase 'd') for the splash screen filename. This is different from iOS which uses uppercase `Default.png`.
+
+**Warning:** Do not use `<supports-screens/>` with `android:anyDensity` set to false, as this can cause scaling issues with splash screens.
 
 #### Nine-Patch Images (Recommended)
 
@@ -345,6 +320,8 @@ platform/android/res/
 
 ### Build Fails - Missing Icons
 
+If any app icon files are missing, the build will fail. If launch image files (prefixed with `Default`) are missing, the build will NOT fail. If you have a `DefaultIcon.png` in the project root, the Titanium SDK will auto-generate any missing iTunesArtwork files.
+
 **Solution:** Add `DefaultIcon.png` (1024x1024) to project root for auto-generation.
 
 ### Android Splash Stretched/Distorted

package/skills/ti-ui/references/layouts-and-positioning.md

@@ -39,45 +39,6 @@ if (OS_IOS) {
 - Android: `actionBar` config, any `Ti.Android.*` constant
 :::
 
-## Table of Contents
-
-- [Layouts, Positioning, and View Hierarchy](#layouts-positioning-and-view-hierarchy)
-  - [🚨 CRITICAL: Platform-Specific Properties Require Modifiers](#-critical-platform-specific-properties-require-modifiers)
-  - [Table of Contents](#table-of-contents)
-  - [1. Units of Measurement](#1-units-of-measurement)
-    - [Available Units](#available-units)
-    - [Density-Independent Pixels (dp)](#density-independent-pixels-dp)
-    - [Best Practice](#best-practice)
-  - [2. Positioning Properties](#2-positioning-properties)
-    - [Edge-Based Positioning](#edge-based-positioning)
-    - [Center Positioning](#center-positioning)
-    - [Dynamic Sizing](#dynamic-sizing)
-  - [3. Layout Modes](#3-layout-modes)
-    - [Composite (Default)](#composite-default)
-    - [Vertical Layout](#vertical-layout)
-    - [Horizontal Layout](#horizontal-layout)
-  - [4. Auto-Size Behaviors](#4-auto-size-behaviors)
-    - [Ti.UI.SIZE](#tiuisize)
-    - [Ti.UI.FILL](#tiuifill)
-    - [Component Defaults](#component-defaults)
-    - [Auto-Size in Layout Modes](#auto-size-in-layout-modes)
-  - [5. Combining Layouts](#5-combining-layouts)
-    - [Nested Layouts](#nested-layouts)
-  - [6. View Hierarchy and Z-Index](#6-view-hierarchy-and-z-index)
-    - [Stacking Order](#stacking-order)
-    - [Explicit Z-Index](#explicit-z-index)
-  - [7. Common Layout Patterns](#7-common-layout-patterns)
-    - [Full-Screen Overlay](#full-screen-overlay)
-    - [Centered Content](#centered-content)
-    - [Bottom-Aligned Content](#bottom-aligned-content)
-    - [Percentage-Based Layout](#percentage-based-layout)
-  - [8. Platform Considerations](#8-platform-considerations)
-    - [Android Density-Specific Resources](#android-density-specific-resources)
-    - [iOS Asset Catalog](#ios-asset-catalog)
-  - [Best Practices](#best-practices)
-
----
-
 ## 1. Units of Measurement
 
 ### Available Units
@@ -87,6 +48,9 @@ if (OS_IOS) {
 | `dp` / `dip` | Density-independent pixels | **Recommended** for cross-platform          |
 | `px`         | Absolute pixels            | Use sparingly - varies by screen density    |
 | `%`          | Percentage of parent size  | Relative to parent's dimension              |
+| `mm`         | Millimeters                | Absolute physical unit                      |
+| `cm`         | Centimeters                | Absolute physical unit                      |
+| `in`         | Inches                     | Absolute physical unit                      |
 | `system`     | Platform default           | iOS = dip, Android = px (unless configured) |
 
 ### Density-Independent Pixels (dp)
@@ -99,6 +63,24 @@ if (OS_IOS) {
 
 **iOS**: Effectively `1dip = 1px` on non-retina, `1dip = 2px` on retina
 
+### Default Units in tiapp.xml
+
+You can set app-wide default units via the `ti.ui.defaultunit` property in `tiapp.xml`:
+
+```xml
+<property name="ti.ui.defaultunit" type="string">dp</property>
+```
+
+When set, numeric values without explicit units (e.g., `width: 100`) use this unit instead of the platform default.
+
+### Platform Coordinate Grid Differences
+
+> **Important**: iOS and Android use different default coordinate systems:
+> - **iOS** uses a density-independent grid (e.g., 320×480 dip for iPhone classic, 1024×768 for iPad). Values are always in dip.
+> - **Android** uses a pixel-based grid by default (varies by device: HVGA 320×480px, WVGA800 480×800px, etc.).
+>
+> This is why setting `ti.ui.defaultunit` to `dp` is recommended for cross-platform consistency — it normalizes Android's behavior to match iOS's density-independent approach.
+
 ### Best Practice
 
 Always use `dp` for consistent sizing across devices:
@@ -183,6 +165,8 @@ Stacking order controlled by:
 - Addition order
 - `zIndex` property (higher = on top)
 
+> **Android limitation**: `zIndex` is only supported by composite layouts. The `zIndex` property is ignored by horizontal and vertical layouts.
+
 ### Vertical Layout
 
 Children stack vertically:
@@ -281,6 +265,18 @@ const view = Ti.UI.createView({
 | Switch          | WebView         |                                        |
 | TextField       | ScrollableView  |                                        |
 
+### ScrollView Auto-Sizing
+
+When a `ScrollView`'s `contentWidth` or `contentHeight` is set to `"auto"` or `Ti.UI.SIZE`, the scroll view's content area grows based on the bottom/right offsets of its child views:
+
+```javascript
+const scrollView = Ti.UI.createScrollView({
+  contentWidth: 'auto',
+  contentHeight: 'auto',
+  layout: 'vertical'
+});
+```
+
 ### Auto-Size in Layout Modes
 
 In `vertical`/`horizontal` layouts:
@@ -350,6 +346,18 @@ win.add(view1);
 win.add(view2);  // view2 appears on top of view1
 ```
 
+### The `size` Property and `postlayout` Event
+
+The read-only `size` property provides the width and height of a view after layout. This property won't return accurate values until a `postlayout` event has been received:
+
+```javascript
+const view = Ti.UI.createView({ width: '50%', height: Ti.UI.SIZE });
+
+view.addEventListener('postlayout', () => {
+  Ti.API.info(`Actual size: ${view.size.width}x${view.size.height}`);
+});
+```
+
 ### Explicit Z-Index
 
 ```javascript

package/skills/ti-ui/references/listviews-and-performance.md

@@ -1,55 +1,5 @@
 # ListViews and Performance Optimization
 
-## Table of Contents
-
-- [ListViews and Performance Optimization](#listviews-and-performance-optimization)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-    - [Core Concepts](#core-concepts)
-  - [2. Basic ListView Structure](#2-basic-listview-structure)
-    - [Declarative (Alloy XML)](#declarative-alloy-xml)
-    - [Programmatic Data Binding](#programmatic-data-binding)
-    - [Mapping External Data](#mapping-external-data)
-  - [3. Templates](#3-templates)
-    - [Default Template](#default-template)
-    - [Custom Templates](#custom-templates)
-    - [Multiple Templates](#multiple-templates)
-  - [4. Data Binding](#4-data-binding)
-    - [Binding Syntax](#binding-syntax)
-    - [Programmatic Binding with Custom Templates](#programmatic-binding-with-custom-templates)
-  - [5. Section Operations](#5-section-operations)
-    - [CRUD Methods](#crud-methods)
-    - [Example Operations](#example-operations)
-  - [6. Events](#6-events)
-    - [Item Click](#item-click)
-    - [Marker Events (Infinite Scroll)](#marker-events-infinite-scroll)
-    - [Template Element Events](#template-element-events)
-  - [7. Critical Performance Rules](#7-critical-performance-rules)
-    - [Rule 1: Avoid Ti.UI.SIZE in Templates](#rule-1-avoid-tiuisize-in-templates)
-    - [Rule 2: Cannot Access Children Directly](#rule-2-cannot-access-children-directly)
-    - [Rule 3: Minimize Template Count](#rule-3-minimize-template-count)
-    - [Rule 4: Use updateItemAt for Changes](#rule-4-use-updateitemat-for-changes)
-    - [Rule 5: Animations are Limited](#rule-5-animations-are-limited)
-  - [8. iOS Action Items (Swipe Actions)](#8-ios-action-items-swipe-actions)
-  - [9. Search](#9-search)
-  - [10. Performance Best Practices](#10-performance-best-practices)
-    - [DO:](#do)
-    - [DON'T:](#dont)
-  - [11. Transitioning from TableView](#11-transitioning-from-tableview)
-    - [Core Logic Differences](#core-logic-differences)
-    - [API Differences](#api-differences)
-  - [12. Common Patterns](#12-common-patterns)
-    - [Infinite Scroll with Markers](#infinite-scroll-with-markers)
-    - [Multiple Selection](#multiple-selection)
-    - [Section Index (A-Z)](#section-index-a-z)
-  - [13. Platform Differences](#13-platform-differences)
-    - [iOS vs Android](#ios-vs-android)
-    - [cacheSize (iOS)](#cachesize-ios)
-  - [14. Debugging](#14-debugging)
-    - [Common Issues](#common-issues)
-
----
-
 ## 1. Overview
 
 ListView is a data-oriented, high-performance replacement for TableView. It optimizes large datasets by recycling native views and managing the item lifecycle automatically.
@@ -199,6 +149,34 @@ const items = [
 $.dynamicListView.sections[0].setItems(items);
 ```
 
+### iOS Built-in Templates (iOS Only)
+
+iOS provides four built-in templates that can be used without defining custom `ItemTemplate`:
+
+| Constant                            | Layout                                                          |
+| ----------------------------------- | --------------------------------------------------------------- |
+| `Ti.UI.LIST_ITEM_TEMPLATE_DEFAULT`  | Left-justified title only (this is the default)                 |
+| `Ti.UI.LIST_ITEM_TEMPLATE_SUBTITLE` | Title with subtitle below in smaller gray text                  |
+| `Ti.UI.LIST_ITEM_TEMPLATE_SETTINGS` | Left-justified title on left, right-justified subtitle on right |
+| `Ti.UI.LIST_ITEM_TEMPLATE_CONTACTS` | Right-justified title with left-justified subtitle              |
+
+```javascript
+const section = Ti.UI.createListSection({
+  items: [
+    { properties: { title: 'Title', subtitle: 'Subtitle' } }
+  ]
+});
+
+const listView = Ti.UI.createListView({
+  sections: [section],
+  defaultItemTemplate: Ti.UI.LIST_ITEM_TEMPLATE_SUBTITLE
+});
+```
+
+### Supported Template View Classes
+
+The following views can be used as child elements in custom templates: ActivityIndicator, Button, ImageView, Label, MaskedImage, ProgressBar, Slider, Switch, TextArea, TextField.
+
 ## 4. Data Binding
 
 ### Binding Syntax
@@ -260,6 +238,22 @@ section.replaceItemsAt(2, 3, replacementItems);
 section.deleteItemsAt(10, 2);
 ```
 
+### Row Animation (iOS)
+
+You can pass animation styles to append/delete/insert/replace/update methods:
+
+```javascript
+section.deleteItemsAt(0, 1, {
+  animationStyle: Ti.UI.iOS.RowAnimationStyle.LEFT
+});
+
+section.appendItems(newItems, {
+  animationStyle: Ti.UI.iOS.RowAnimationStyle.FADE
+});
+```
+
+Available styles: `Ti.UI.iOS.RowAnimationStyle.BOTTOM`, `FADE`, `LEFT`, `NONE`, `RIGHT`, `TOP`.
+
 ## 6. Events
 
 ### Item Click
@@ -309,6 +303,29 @@ function markerReached(e) {
 $.myList.addEventListener('marker', markerReached);
 ```
 
+Since SDK 4.1.0, use `addMarker()` to add additional markers after the initial `setMarker()`:
+
+```javascript
+$.myList.addMarker({ sectionIndex: 0, itemIndex: 149 });
+```
+
+### Scroll Events
+
+Since SDK 4.1.0, use `scrollstart` and `scrollend` events to monitor scrolling:
+
+```javascript
+$.myList.addEventListener('scrollstart', (e) => {
+  Ti.API.info(`Scroll started at section ${e.firstVisibleSectionIndex}, item ${e.firstVisibleItemIndex}`);
+  Ti.API.info(`Visible items: ${e.visibleItemCount}`);
+});
+
+$.myList.addEventListener('scrollend', (e) => {
+  Ti.API.info(`Scroll ended at section ${e.firstVisibleSectionIndex}, item ${e.firstVisibleItemIndex}`);
+});
+```
+
+Event properties: `firstVisibleSectionIndex`, `firstVisibleItemIndex`, `visibleItemCount`.
+
 ### Template Element Events
 
 ```xml
@@ -432,32 +449,71 @@ ListView items have limited animation support. For complex animations, consider
 ```javascript
 const section = $.myList.sections[0];
 
-// Define edit actions
-const deleteAction = Ti.UI.iOS.createListViewDeleteOptions({
-  title: 'Delete'
-});
-
-const moreAction = Ti.UI.iOS.createListViewEditAction({
-  title: 'More',
-  backgroundColor: 'blue',
-  style: Ti.UI.iOS.LIST_VIEW_EDIT_ACTION_STYLE_NORMAL
-});
-
-// Enable editing
-section.editActions = [deleteAction, moreAction];
+// Define edit actions as plain objects with title, style, and optional color
+section.editActions = [
+  {
+    title: 'Delete',
+    style: Ti.UI.iOS.ROW_ACTION_STYLE_DESTRUCTIVE
+  },
+  {
+    title: 'More',
+    color: 'blue',
+    style: Ti.UI.iOS.ROW_ACTION_STYLE_NORMAL
+  }
+];
 section.canEdit = true;
 
-// Handle actions
+// Handle actions — e.action is the title STRING of the tapped action
 $.myList.addEventListener('editaction', (e) => {
-  if (e.action === deleteAction) {
-    section.deleteItemsAt(e.itemIndex, 1);
-  } else if (e.action === moreAction) {
+  if (e.action === 'Delete') {
+    e.section.deleteItemsAt(e.itemIndex, 1);
+  } else if (e.action === 'More') {
     // Handle more action
+    Ti.API.info(`More tapped on item ${e.itemIndex} in section ${e.sectionIndex}`);
   }
 });
 ```
 
-## 9. Search
+**Available action styles:**
+- `Ti.UI.iOS.ROW_ACTION_STYLE_DEFAULT` — gray background
+- `Ti.UI.iOS.ROW_ACTION_STYLE_DESTRUCTIVE` — red background (default)
+- `Ti.UI.iOS.ROW_ACTION_STYLE_NORMAL` — custom color background
+
+**Event properties:** `action` (string — the title), `itemId`, `itemIndex`, `section`, `sectionIndex`.
+
+## 9. Editing Mode (iOS)
+
+Set the `editing` property to toggle edit mode, allowing users to delete and reorder items:
+
+```javascript
+// Toggle edit mode
+$.myList.editing = true;
+
+// Auto-remove sections that become empty during editing
+$.myList.pruneSectionsOnEdit = true;
+```
+
+### Delete Event
+
+Fires when a user deletes an item in edit mode:
+
+```javascript
+$.myList.addEventListener('delete', (e) => {
+  Ti.API.info(`Deleted item ${e.itemIndex} from section ${e.sectionIndex}`);
+});
+```
+
+### Move Event
+
+Fires when a user reorders an item in edit mode:
+
+```javascript
+$.myList.addEventListener('move', (e) => {
+  Ti.API.info(`Moved item from ${e.itemIndex} to ${e.targetItemIndex}`);
+});
+```
+
+## 10. Search
 
 ```javascript
 const searchView = Ti.UI.createSearchBar({
@@ -477,7 +533,30 @@ const items = [
 ];
 ```
 
-## 10. Performance Best Practices
+### Search Properties
+
+- `keepSectionsInSearch: true` — preserves section headers while filtering search results.
+- `caseInsensitiveSearch: true` — enables case-insensitive search filtering.
+
+```javascript
+const listView = Ti.UI.createListView({
+  searchView: searchView,
+  keepSectionsInSearch: true,
+  caseInsensitiveSearch: true
+});
+```
+
+### No Results Event
+
+Since SDK 3.3.0, when items are filtered using `searchView` or `searchText`, the `noresults` event fires when search returns no results:
+
+```javascript
+$.myList.addEventListener('noresults', (e) => {
+  Ti.API.info('No matching items found');
+});
+```
+
+## 11. Performance Best Practices
 
 ### DO:
 - Use fixed heights in templates
@@ -494,7 +573,7 @@ const items = [
 - Add complex animations to list items
 - Ignore the "recycled" nature of views
 
-## 11. Transitioning from TableView
+## 12. Transitioning from TableView
 
 ### Core Logic Differences
 
@@ -522,7 +601,7 @@ const items = [
 - `appendRow`, `deleteRow`, `deselectRow`, `insertRowAfter`, `insertRowBefore`, `selectRow`, `updateRow`, `scrollToIndex`.
 - *Alternatives*: Use `scrollToItem` and `selectItem` (iOS). For row manipulation, use the containing `ListSection`.
 
-## 12. Common Patterns
+## 13. Common Patterns
 
 ### Infinite Scroll with Markers
 
@@ -583,7 +662,7 @@ $.myList.addEventListener('itemclick', (e) => {
 $.myList.sectionIndexTitles = ["A", "B", "C", ...];
 ```
 
-## 13. Platform Differences
+## 14. Platform Differences
 
 ### iOS vs Android
 
@@ -595,6 +674,41 @@ $.myList.sectionIndexTitles = ["A", "B", "C", ...];
 | Default template image | Left side    | Right side    |
 | cacheSize property     | Supported    | Not supported |
 
+### Grouped Style (iOS)
+
+Set `style: Ti.UI.iOS.ListViewStyle.GROUPED` to display sections as separate visual groups with rounded corners and inset spacing:
+
+```javascript
+const listView = Ti.UI.createListView({
+  style: Ti.UI.iOS.ListViewStyle.GROUPED,
+  sections: [sectionA, sectionB]
+});
+```
+
+### Pull-to-Refresh (iOS)
+
+The `pull` event fires when the user pulls past the top of the list, and `pullend` fires when the user releases. Use the `pullView` property to set a custom pull-to-refresh view:
+
+```javascript
+const pullView = Ti.UI.createView({
+  height: 60,
+  backgroundColor: '#eee'
+});
+pullView.add(Ti.UI.createLabel({ text: 'Pull to refresh...' }));
+
+$.myList.pullView = pullView;
+
+$.myList.addEventListener('pull', (e) => {
+  // User is pulling — update UI as needed
+  pullView.children[0].text = e.active ? 'Release to refresh...' : 'Pull to refresh...';
+});
+
+$.myList.addEventListener('pullend', (e) => {
+  // User released — trigger data refresh
+  refreshData();
+});
+```
+
 ### cacheSize (iOS)
 
 ```javascript
@@ -602,7 +716,7 @@ $.myList.sectionIndexTitles = ["A", "B", "C", ...];
 $.myList.cacheSize = 3;  // Default
 ```
 
-## 14. Debugging
+## 15. Debugging
 
 ### Common Issues