@maccesar/titools 2.0.7 → 2.2.0

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

@@ -1,44 +1,17 @@
 # Orientation
 
-## Table of Contents
-
-- [Orientation](#orientation)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. Orientation Modes](#2-orientation-modes)
-    - [Supported Orientations](#supported-orientations)
-  - [3. Locking Orientation](#3-locking-orientation)
-    - [Lock to Specific Orientation](#lock-to-specific-orientation)
-    - [Android Orientation Values](#android-orientation-values)
-    - [Runtime Orientation Lock (iOS)](#runtime-orientation-lock-ios)
-  - [4. Handling Orientation Changes](#4-handling-orientation-changes)
-    - [Detect Orientation Change](#detect-orientation-change)
-    - [Window Orientation Events](#window-orientation-events)
-  - [5. Adapting UI to Orientation](#5-adapting-ui-to-orientation)
-    - [Responsive Layout Example](#responsive-layout-example)
-    - [Orientation-Specific Components](#orientation-specific-components)
-  - [6. Platform Differences](#6-platform-differences)
-    - [iOS Orientation](#ios-orientation)
-    - [Android Orientation](#android-orientation)
-  - [7. Checking Current Orientation](#7-checking-current-orientation)
-  - [8. Disabling Orientation Change](#8-disabling-orientation-change)
-    - [Disable All Rotation](#disable-all-rotation)
-    - [Disable Rotation for Specific Window (iOS)](#disable-rotation-for-specific-window-ios)
-  - [9. Orientation Lock During Specific Operation](#9-orientation-lock-during-specific-operation)
-    - [Temporarily Lock Orientation](#temporarily-lock-orientation)
-  - [10. Best Practices](#10-best-practices)
-  - [11. Common Issues](#11-common-issues)
-    - [Orientation Not Changing](#orientation-not-changing)
-    - [UI Doesn't Adapt](#ui-doesnt-adapt)
-    - [Upside-Down Orientation](#upside-down-orientation)
-
----
-
 ## 1. Overview
 
 Orientation refers to whether the app displays in portrait or landscape mode, and how to handle orientation changes.
 
-## 2. Orientation Modes
+## 2. Design Principles
+
+- **Don't mix orientations on iPhone/iPod** — Pick either portrait or landscape for your entire app; switching between them mid-flow creates a jarring user experience.
+- **Don't support portrait-upside-down on iPhone** — If a user receives a phone call while the device is upside-down, the call UI appears upside-down, which is disorienting and risky.
+- **iPad should support all orientations** — Apple's HIG expects iPad apps to work in every orientation. Users frequently rotate their iPads.
+- **These principles apply equally to Android** — While Android is more permissive, the same UX considerations hold. Consistency within your app matters.
+
+## 3. Orientation Modes
 
 ### Supported Orientations
 
@@ -52,7 +25,7 @@ Orientation refers to whether the app displays in portrait or landscape mode, an
 | `Ti.UI.FACE_DOWN`       | Device face down (flat on table) |
 | `Ti.UI.AUTO`            | Let system decide                |
 
-## 3. Locking Orientation
+## 4. Locking Orientation
 
 ### Lock to Specific Orientation
 
@@ -70,7 +43,14 @@ Orientation refers to whether the app displays in portrait or landscape mode, an
     </dict>
   </plist>
 </ios>
+```
 
+**iOS plist iPhone vs iPad keys**: You can specify different supported orientations for iPhone and iPad using device-specific keys:
+- `UISupportedInterfaceOrientations~iphone` — iPhone-specific orientations (default: portrait only)
+- `UISupportedInterfaceOrientations~ipad` — iPad-specific orientations (default: all four orientations)
+- `UISupportedInterfaceOrientations` (without suffix) — applies to both if device-specific keys are absent
+
+```xml
 <android>
   <manifest>
     <activity>
@@ -104,6 +84,8 @@ Orientation refers to whether the app displays in portrait or landscape mode, an
 - `nosensor` - Ignores accelerometer (orientation changes only)
 - `user` - User's preference
 
+> **Warning — Android set-vs-get value mismatch**: On Android, the orientation values you SET don't match those you GET. You can set 4 values (portrait upright, landscape right, portrait upside-down, landscape left) but only get 2 values back (portrait or landscape). Also, "portrait" and "landscape" meaning varies between phones and tablets based on sensor orientation — on most phones portrait is the default, but on some tablets landscape is the default sensor position.
+
 ### Runtime Orientation Lock (iOS)
 
 ```javascript
@@ -114,7 +96,7 @@ Ti.UI.iPhone.setStatusBarStyle(Ti.UI.iPhone.StatusBar.DEFAULT);
 // Use tiapp.xml configuration for consistent behavior
 ```
 
-## 4. Handling Orientation Changes
+## 5. Handling Orientation Changes
 
 ### Detect Orientation Change
 
@@ -128,8 +110,14 @@ Ti.Gesture.addEventListener('orientationchange', (e) => {
              e.orientation === Ti.UI.LANDSCAPE_RIGHT) {
     adjustForLandscape();
   }
+
+  // Ti.Gesture helper methods — convenience booleans
+  Ti.API.info(`Is portrait: ${e.source.isPortrait()}`);
+  Ti.API.info(`Is landscape: ${e.source.isLandscape()}`);
 });
 ```
+
+> **Anti-pattern warning**: Do NOT use `orientationchange` event listeners to force an orientation. This causes: (1) the wrong orientation showing briefly before the forced one kicks in, (2) potential memory leaks from repeated listener firing, and (3) improper technique. Use `tiapp.xml` or window `orientationModes` instead.
 ...
 ### Window Orientation Events
 
@@ -145,7 +133,7 @@ win.addEventListener('orientationchange', (e) => {
 });
 ```
 
-## 5. Adapting UI to Orientation
+## 6. Adapting UI to Orientation
 
 ### Responsive Layout Example
 
@@ -211,7 +199,7 @@ function switchLayout() {
 Ti.Gesture.addEventListener('orientationchange', switchLayout);
 ```
 
-## 6. Platform Differences
+## 7. Platform Differences
 
 ### iOS Orientation
 
@@ -227,7 +215,7 @@ Ti.Gesture.addEventListener('orientationchange', switchLayout);
 - More granular control (sensor, user, nosensor)
 - May ignore upside-down depending on device
 
-## 7. Checking Current Orientation
+## 8. Checking Current Orientation
 
 ```javascript
 // Get current orientation
@@ -244,7 +232,7 @@ const isLandscape = (currentOrientation === Ti.UI.LANDSCAPE_LEFT ||
                    currentOrientation === Ti.UI.LANDSCAPE_RIGHT);
 ```
 
-## 8. Disabling Orientation Change
+## 9. Disabling Orientation Change
 
 ### Disable All Rotation
 
@@ -253,7 +241,7 @@ const isLandscape = (currentOrientation === Ti.UI.LANDSCAPE_LEFT ||
 <ios>
   <plist>
     <dict>
-      <key>UISupportedInterfaceOorientations</key>
+      <key>UISupportedInterfaceOrientations</key>
       <array>
         <string>UIInterfaceOrientationPortrait</string>
       </array>
@@ -281,45 +269,43 @@ const win = Ti.UI.createWindow({
 
 **Note**: Window-level orientation control is limited; app-level configuration is preferred.
 
-## 9. Orientation Lock During Specific Operation
+## 10. Orientation Lock Limitations
 
-### Temporarily Lock Orientation
+**Important:** Runtime orientation locking is NOT reliably supported across platforms.
 
-```javascript
-let originalOrientation = null;
-
-function lockOrientation() {
-  // Save current orientation
-  originalOrientation = Ti.Gesture.orientation;
+- **iOS**: Orientation is controlled exclusively via `tiapp.xml` plist keys and window-level `orientationModes`. There is no API to lock/unlock orientation at runtime.
+- **Android**: Use `android:screenOrientation` in `tiapp.xml` manifest. Changing orientation programmatically at runtime is not supported through Titanium APIs.
 
-  // Force portrait
-  if (Ti.Platform.osname === 'iphone' || Ti.Platform.osname === 'ipad') {
-    // iOS doesn't support runtime orientation lock
-    // This is controlled at app level
-    Ti.API.warn('iOS orientation must be locked in tiapp.xml');
-  }
-}
+If you need a specific orientation for a particular screen (e.g., landscape for video playback), create a dedicated window with the desired `orientationModes` set at creation time:
 
-function unlockOrientation() {
-  // Would restore orientation
-  // Not fully supported on all platforms
-}
+```javascript
+// Landscape-only video window
+const videoWin = Ti.UI.createWindow({
+  orientationModes: [Ti.UI.LANDSCAPE_LEFT, Ti.UI.LANDSCAPE_RIGHT]
+});
 
-// Use case: During video playback
 const videoPlayer = Ti.Media.createVideoPlayer({
   url: 'video.mp4'
 });
 
-videoPlayer.addEventListener('playbackstart', () => {
-  lockOrientation();
-});
-
-videoPlayer.addEventListener('playbackcomplete', () => {
-  unlockOrientation();
-});
+videoWin.add(videoPlayer);
+videoWin.open();
 ```
 
-## 10. Best Practices
+## 11. Modal Window Constraints (iOS)
+
+> **Note**: Modal windows should not support orientations unsupported by the parent window. This can cause bad visual/redraw behavior after the modal is dismissed. Additionally, setting `orientationModes` on non-modal windows inside a `NavigationWindow` or `TabGroup` is bad practice — only the root window's orientation settings are respected.
+
+## 12. Splash Screen Configuration
+
+Splash screens need orientation-specific image variants:
+
+- **Android**: Uses `default.png` (lowercase `d`) placed in `Resources/android/images/`.
+- **iOS**: Uses `Default.png` (uppercase `D`) with orientation variants like `Default-Landscape.png` and `Default-Portrait.png` for iPad and Universal apps.
+
+See the `icons-and-splash-screens.md` reference for full details on naming conventions and required sizes.
+
+## 13. Best Practices
 
 1. **Test on multiple devices** - Orientation behavior varies
 2. **Test rotation scenarios** - How does your UI adapt?
@@ -330,7 +316,7 @@ videoPlayer.addEventListener('playbackcomplete', () => {
 7. **Handle edge cases** - What happens during phone calls?
 8. **Consider tablets** - Default orientation may differ
 
-## 11. Common Issues
+## 14. Common Issues
 
 ### Orientation Not Changing
 

package/skills/ti-ui/references/platform-ui-android.md

@@ -1,53 +1,5 @@
 # Android UI Components and Conventions
 
-## Table of Contents
-
-- [Android UI Components and Conventions](#android-ui-components-and-conventions)
-  - [Table of Contents](#table-of-contents)
-  - [1. Action Bar](#1-action-bar)
-    - [Overview](#overview)
-    - [Enabling Action Bar](#enabling-action-bar)
-    - [Creating Action Bar (Programmatic)](#creating-action-bar-programmatic)
-    - [Action Bar with App Icon](#action-bar-with-app-icon)
-    - [Action View (Custom Layout)](#action-view-custom-layout)
-  - [2. Android Themes](#2-android-themes)
-    - [Overview](#overview-1)
-    - [Titanium Material Themes (SDK 10.0.0+)](#titanium-material-themes-sdk-1000)
-    - [Material 3 Themes (SDK 12.0.0+)](#material-3-themes-sdk-1200)
-    - [Applying Themes](#applying-themes)
-    - [Custom Theme](#custom-theme)
-    - [Color Palette Attributes](#color-palette-attributes)
-    - [Hiding Action Bar](#hiding-action-bar)
-    - [Theme Requirements](#theme-requirements)
-  - [3. Options Menu](#3-options-menu)
-    - [Legacy Options Menu](#legacy-options-menu)
-    - [Context Menu (Long Press)](#context-menu-long-press)
-  - [4. Status Bar Notifications](#4-status-bar-notifications)
-    - [Notifications](#notifications)
-    - [Notification Channels (Android 8.0+)](#notification-channels-android-80)
-    - [Clearing Notifications](#clearing-notifications)
-  - [5. Progress Bars](#5-progress-bars)
-    - [Horizontal Progress Bar](#horizontal-progress-bar)
-    - [Spinner (Indeterminate Progress)](#spinner-indeterminate-progress)
-  - [6. Tab Groups and Tabs](#6-tab-groups-and-tabs)
-    - [Native Android Tabs](#native-android-tabs)
-    - [Tab Badges](#tab-badges)
-  - [7. Hardware Back Button Handling](#7-hardware-back-button-handling)
-    - [Handling Back Button](#handling-back-button)
-    - [Exit Confirmation Dialog](#exit-confirmation-dialog)
-  - [8. Notification Drawer](#8-notification-drawer)
-    - [Display Notification](#display-notification)
-  - [9. Android UI Conventions](#9-android-ui-conventions)
-    - [Back Button Behavior](#back-button-behavior)
-    - [Up/Down Navigation](#updown-navigation)
-    - [App Shortcuts](#app-shortcuts)
-  - [10. Material Design Components](#10-material-design-components)
-    - [Using AppCompat v7](#using-appcompat-v7)
-    - [Material Design Components](#material-design-components)
-  - [Best Practices](#best-practices)
-
----
-
 ## 1. Action Bar
 
 ### Overview
@@ -130,8 +82,35 @@ activity.onPrepareOptionsMenu = (e) => {
   const menu = e.menu;
   // Modify items based on state
 };
+
+// Force menu recreation (useful when menu items need to change dynamically)
+activity.invalidateOptionsMenu();
 ```
 
+### Action Bar Properties
+
+```javascript
+const activity = Ti.Android.currentActivity;
+const actionBar = activity.actionBar;
+
+// Show the "up" affordance arrow next to the home icon
+actionBar.displayHomeAsUp = true;
+
+// Customize icon and logo
+actionBar.icon = '/images/actionbar_icon.png';
+actionBar.logo = '/images/actionbar_logo.png';
+
+// Handle home icon/logo clicks
+actionBar.onHomeIconItemSelected = () => {
+  // Navigate up or open navigation drawer
+  win.close();
+};
+```
+
+### Refreshing the Options Menu
+
+Call `activity.invalidateOptionsMenu()` to force `onCreateOptionsMenu` to be called again. This is useful when menu items need to change dynamically (e.g., when the user switches tabs or a state change requires different menu options).
+
 ### Action Bar with App Icon
 
 ```javascript
@@ -311,6 +290,8 @@ win.addEventListener('open', () => {
 
 ### Theme Requirements
 
+> **Warning:** SDK 10.0.0+ requires material-based themes. Using non-material themes will cause a runtime error. Do NOT name your custom theme file `theme.xml` — this will overwrite Titanium's built-in theme file. Use descriptive names like `mytheme.xml`.
+
 - SDK 10.0.0+ requires material-based themes (runtime error otherwise)
 - Place custom themes in `platform/android/res/values/`
 - Do NOT name file `theme.xml` (overwrites Titanium's)
@@ -623,6 +604,91 @@ Android 7.1+ app shortcuts:
 
 These can be accessed via Hyperloop or custom modules.
 
+## 11. Toast Notifications
+
+Toast notifications display brief messages at the bottom of the screen that automatically disappear.
+
+```javascript
+const toast = Ti.UI.createNotification({
+  message: 'Item saved successfully',
+  duration: Ti.UI.NOTIFICATION_DURATION_LONG
+});
+toast.show();
+```
+
+### Positioning
+
+Use `offsetX` and `offsetY` to reposition the toast from its default location:
+
+```javascript
+const toast = Ti.UI.createNotification({
+  message: 'Custom position',
+  duration: Ti.UI.NOTIFICATION_DURATION_SHORT,
+  offsetX: 0,
+  offsetY: 100
+});
+toast.show();
+```
+
+**Duration options:**
+- `Ti.UI.NOTIFICATION_DURATION_SHORT` — Short display time
+- `Ti.UI.NOTIFICATION_DURATION_LONG` — Longer display time
+
+## 12. HTML Labels and Linkification
+
+### HTML Content in Labels
+
+Use the `html` property on Labels to render inline HTML content:
+
+```javascript
+const label = Ti.UI.createLabel({
+  html: '<b>Bold</b> and <i>italic</i> text',
+  autoLink: Ti.UI.AUTOLINK_ALL
+});
+```
+
+### Auto-Link Constants
+
+The `autoLink` property automatically detects and linkifies content:
+
+| Constant                         | Description                   |
+| -------------------------------- | ----------------------------- |
+| `Ti.UI.AUTOLINK_ALL`             | Linkify all detected patterns |
+| `Ti.UI.AUTOLINK_EMAIL_ADDRESSES` | Linkify email addresses       |
+| `Ti.UI.AUTOLINK_MAP_ADDRESSES`   | Linkify street addresses      |
+| `Ti.UI.AUTOLINK_PHONE_NUMBERS`   | Linkify phone numbers         |
+| `Ti.UI.AUTOLINK_URLS`            | Linkify web URLs              |
+
+You can combine multiple constants using bitwise OR:
+
+```javascript
+const label = Ti.UI.createLabel({
+  text: 'Call 555-1234 or visit example.com',
+  autoLink: Ti.UI.AUTOLINK_PHONE_NUMBERS | Ti.UI.AUTOLINK_URLS
+});
+```
+
+## 13. Nine-Patch Images
+
+Nine-patch images (`.9.png`) define stretchable regions that adapt to different screen sizes and content.
+
+### Key Points
+
+- Files use the `.9.png` extension
+- Only work as `backgroundImage` (not as regular images)
+- Define stretchable regions so the image scales without distortion
+- Reference **without** the `.9` in code — Android resolves it automatically
+- Create with the Android SDK's `draw9patch` tool
+
+```javascript
+const button = Ti.UI.createButton({
+  title: 'Submit',
+  backgroundImage: '/images/button_bg.png',  // actual file: button_bg.9.png
+  width: Ti.UI.SIZE,
+  height: Ti.UI.SIZE
+});
+```
+
 ## Best Practices
 
 1. **Follow Material Design guidelines** for modern Android apps

package/skills/ti-ui/references/platform-ui-ios.md

@@ -1,43 +1,5 @@
 # iOS UI Components and Conventions
 
-## Table of Contents
-
-- [iOS UI Components and Conventions](#ios-ui-components-and-conventions)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. iPad-Only UI Components](#2-ipad-only-ui-components)
-    - [Popover](#popover)
-    - [Popover Events](#popover-events)
-    - [SplitWindow](#splitwindow)
-    - [SplitWindow in Portrait](#splitwindow-in-portrait)
-  - [3. Badges](#3-badges)
-    - [App Icon Badge](#app-icon-badge)
-    - [Tab Badge](#tab-badge)
-    - [Accessing Preferences in App](#accessing-preferences-in-app)
-      - [Dynamic Quick Actions](#dynamic-quick-actions)
-      - [Handling Quick Actions](#handling-quick-actions)
-    - [Peek and Pop](#peek-and-pop)
-      - [Enabling Peek and Pop](#enabling-peek-and-pop)
-      - [Preview Action Styles](#preview-action-styles)
-  - [6. Navigation Bar (iOS)](#6-navigation-bar-ios)
-    - [NavigationWindow](#navigationwindow)
-    - [Toolbar](#toolbar)
-    - [System Buttons](#system-buttons)
-  - [7. Tab Bar](#7-tab-bar)
-    - [Creating Tab Bar](#creating-tab-bar)
-    - [Tab Bar Customization (iOS)](#tab-bar-customization-ios)
-  - [8. Activity Indicator](#8-activity-indicator)
-    - [iOS-Specific Location](#ios-specific-location)
-  - [9. Platform Best Practices](#9-platform-best-practices)
-    - [Follow iOS Human Interface Guidelines](#follow-ios-human-interface-guidelines)
-    - [iOS-Specific Patterns](#ios-specific-patterns)
-  - [10. Common Issues](#10-common-issues)
-    - [Settings Not Appearing](#settings-not-appearing)
-    - [3D Touch Not Working](#3d-touch-not-working)
-    - [SplitWindow Issues](#splitwindow-issues)
-
----
-
 ## 1. Overview
 
 iOS offers several UI components and conventions that differ from Android. This guide covers iPad-specific controls, app badges, Settings integration, 3D Touch, and iOS-specific navigation patterns.
@@ -183,14 +145,59 @@ tab1.setBadge(null);
 tab1.badge = null;
 ```
 ...
+### Settings.bundle Integration
+
+iOS apps can expose user-configurable settings in the device's Settings app using a Settings.bundle.
+
+**Setup**:
+- Place the bundle at `platform/iphone/Settings.bundle/` (SDK 1.8+)
+- The bundle contains `Root.plist`, which defines the settings UI (toggles, text fields, groups, etc.)
+- Edit `Root.plist` using Xcode's Property List editor for a visual interface
+
+**Key conventions**: Settings keys typically use the `_preference` suffix (e.g., `username_preference`, `enabled_preference`).
+
 ### Accessing Preferences in App
 
 ```javascript
+// Read a preference set in iOS Settings app
+const username = Ti.App.Properties.getString('username_preference');
+
 // Must match the "Key" value from Root.plist
 const name = Ti.App.Properties.getString('name_preference');
 const enabled = Ti.App.Properties.getBool('enabled_preference');
 ```
 ...
+#### Static Quick Actions (via tiapp.xml)
+
+Static shortcuts are defined in `tiapp.xml` and available immediately when the app is installed.
+
+- **Required keys**: `UIApplicationShortcutItemTitle`, `UIApplicationShortcutItemType`
+- **Optional keys**: `UIApplicationShortcutItemSubtitle`, `UIApplicationShortcutItemIconType`, `UIApplicationShortcutItemIconFile`, `UIApplicationShortcutItemUserInfo`
+
+```xml
+<ios>
+  <plist>
+    <dict>
+      <key>UIApplicationShortcutItems</key>
+      <array>
+        <dict>
+          <key>UIApplicationShortcutItemTitle</key>
+          <string>New Message</string>
+          <key>UIApplicationShortcutItemType</key>
+          <string>com.app.newmessage</string>
+          <key>UIApplicationShortcutItemIconType</key>
+          <string>UIApplicationShortcutIconTypeCompose</string>
+        </dict>
+      </array>
+    </dict>
+  </plist>
+</ios>
+```
+
+Quick action titles and subtitles can be localized using `i18n/LANG/app.xml` (not `strings.xml`). Use the localized key as the value in `tiapp.xml`.
+
+To use custom images for quick action icons, enable app thinning in `tiapp.xml` with `<use-app-thinning>true</use-app-thinning>` inside the `<ios>` element.
+
 #### Dynamic Quick Actions
 
 ```javascript
@@ -285,6 +292,24 @@ Ti.UI.iOS.PREVIEW_ACTION_STYLE_SELECTED  // Blue background
 Ti.UI.iOS.PREVIEW_ACTION_STYLE_DESTRUCTIVE  // Red background
 ```
 
+#### Peek and Pop Details
+
+- Use the `contentHeight` property on the preview context to control the peek preview height (e.g., `contentHeight: 400` as shown above).
+- Use `Ti.UI.iOS.createPreviewActionGroup()` to group related preview actions into a submenu:
+
+```javascript
+const subAction1 = Ti.UI.iOS.createPreviewAction({ title: 'Copy', style: Ti.UI.iOS.PREVIEW_ACTION_STYLE_DEFAULT });
+const subAction2 = Ti.UI.iOS.createPreviewAction({ title: 'Move', style: Ti.UI.iOS.PREVIEW_ACTION_STYLE_DEFAULT });
+
+const actionGroup = Ti.UI.iOS.createPreviewActionGroup({
+  title: 'Organize',
+  style: Ti.UI.iOS.PREVIEW_ACTION_STYLE_DEFAULT,
+  actions: [subAction1, subAction2]
+});
+```
+
+> **Important**: 3D Touch features (Peek and Pop, quick actions with force) can ONLY be tested on physical devices with 3D Touch hardware. The iOS Simulator does not support force touch.
+
 ## 6. Navigation Bar (iOS)
 
 ### NavigationWindow

package/skills/ti-ui/references/scrolling-views.md

@@ -1,27 +1,5 @@
 # Scrolling Views
 
-## Table of Contents
-
-- [Scrolling Views](#scrolling-views)
-  - [Table of Contents](#table-of-contents)
-  - [1. ScrollView vs ScrollableView](#1-scrollview-vs-scrollableview)
-  - [2. ScrollView](#2-scrollview)
-    - [Creating a ScrollView](#creating-a-scrollview)
-    - [ScrollView Events](#scrollview-events)
-    - [Android ScrollView Direction](#android-scrollview-direction)
-  - [3. ScrollableView](#3-scrollableview)
-    - [Creating a ScrollableView](#creating-a-scrollableview)
-    - [ScrollableView Events](#scrollableview-events)
-    - [Image Gallery](#image-gallery)
-    - [Onboarding Wizard](#onboarding-wizard)
-    - [Long Form Content](#long-form-content)
-    - [Scrollable Form](#scrollable-form)
-    - [ScrollableView](#scrollableview)
-  - [8. Detecting Scroll Position](#8-detecting-scroll-position)
-  - [Best Practices](#best-practices)
-
----
-
 ## 1. ScrollView vs ScrollableView
 
 | Feature          | ScrollView                     | ScrollableView                   |
@@ -56,6 +34,19 @@ scrollView.add(content);
 win.add(scrollView);
 ```
 ...
+### ScrollView Properties
+
+| Property                                      | Description                                                         | Platform |
+| --------------------------------------------- | ------------------------------------------------------------------- | -------- |
+| `contentWidth` / `contentHeight`              | Size of the scrollable content area                                 | All      |
+| `scrollType`                                  | `'vertical'` or `'horizontal'` (Android only — see below)           | Android  |
+| `showHorizontalScrollIndicator`               | Show/hide horizontal scroll indicator                               | All      |
+| `showVerticalScrollIndicator`                 | Show/hide vertical scroll indicator                                 | All      |
+| `zoomScale` / `minZoomScale` / `maxZoomScale` | Zoom level (values 0–1)                                             | iOS      |
+| `horizontalBounce` / `verticalBounce`         | Enable/disable bounce effect at edges                               | iOS      |
+| `canCancelEvents`                             | Allow ScrollView to cancel touch events in children (default: true) | iOS      |
+| `scrollable`                                  | Enable/disable scrolling                                            | All      |
+
 ### ScrollView Events
 
 ```javascript
@@ -77,7 +68,7 @@ scrollView.addEventListener('scrollEnd', (e) => {
 ...
 ### Android ScrollView Direction
 
-Android ScrollView can be vertical OR horizontal, not both:
+Android ScrollView can be vertical OR horizontal, not both. If you don't set `scrollType`, Android auto-detects: if width equals contentWidth it defaults to vertical; if height equals contentHeight it defaults to horizontal. If Titanium cannot determine the direction, a warning is logged to the console.
 
 ```javascript
 // Explicit horizontal scroll

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

@@ -1,59 +1,5 @@
 # TableViews
 
-## Table of Contents
-
-- [TableViews](#tableviews)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. TableView vs ListView](#2-tableview-vs-listview)
-  - [3. Creating a TableView](#3-creating-a-tableview)
-    - [Basic TableView](#basic-tableview)
-  - [4. Creating rows](#4-creating-rows)
-    - [Object Literal Rows (Simple)](#object-literal-rows-simple)
-    - [Explicit TableViewRow Objects](#explicit-tableviewrow-objects)
-    - [Performance: setData() vs appendRow()](#performance-setdata-vs-appendrow)
-  - [5. Row Properties](#5-row-properties)
-    - [Built-in Row Properties](#built-in-row-properties)
-    - [Styled Rows Example](#styled-rows-example)
-    - [Row Indicators](#row-indicators)
-  - [6. Custom Rows](#6-custom-rows)
-    - [Adding Child Views](#adding-child-views)
-    - [Performance Warning](#performance-warning)
-  - [7. Headers and Footers](#7-headers-and-footers)
-    - [Table-Level Headers/Footers](#table-level-headersfooters)
-    - [Custom Header/Footer Views](#custom-headerfooter-views)
-    - [Section Headers/Footers](#section-headersfooters)
-  - [8. Grouped Table Style (iOS)](#8-grouped-table-style-ios)
-  - [9. Editing Mode](#9-editing-mode)
-  - [10. TableView Events](#10-tableview-events)
-    - [Click Event](#click-event)
-    - [Delete Event](#delete-event)
-    - [Scroll Events](#scroll-events)
-  - [11. Searching](#11-searching)
-  - [12. Updating Table Data](#12-updating-table-data)
-    - [Appending Rows](#appending-rows)
-    - [Inserting Rows](#inserting-rows)
-    - [Deleting Rows](#deleting-rows)
-    - [Updating Specific Row](#updating-specific-row)
-  - [13. TableView Sections](#13-tableview-sections)
-    - [Creating Sections](#creating-sections)
-    - [Custom Section Headers](#custom-section-headers)
-  - [14. Performance Optimization](#14-performance-optimization)
-    - [Use className](#use-classname)
-    - [Avoid Too Many Rows](#avoid-too-many-rows)
-    - [Optimize Custom Rows](#optimize-custom-rows)
-  - [15. Common Patterns](#15-common-patterns)
-    - [Detail View Navigation](#detail-view-navigation)
-    - [Row Actions (Swipe to Delete)](#row-actions-swipe-to-delete)
-    - [Refresh Control](#refresh-control)
-  - [16. Platform Differences](#16-platform-differences)
-    - [iOS](#ios)
-    - [Android](#android)
-  - [17. Migration: TableView to ListView](#17-migration-tableview-to-listview)
-  - [Best Practices](#best-practices)
-
----
-
 ## 1. Overview
 
 TableView is a scrolling list component that displays rows of data. While ListView is the recommended modern API for most use cases, TableView remains useful for:
@@ -83,7 +29,10 @@ const table = Ti.UI.createTableView({
   width: Ti.UI.FILL,
   backgroundColor: 'white',
   rowHeight: 50,
-  separatorColor: '#ccc'
+  minRowHeight: 40,
+  maxRowHeight: 80,
+  separatorColor: '#ccc',
+  scrollable: true  // Set false to disable scrolling
 });
 
 win.add(table);
@@ -393,7 +342,8 @@ table.deleteRow(3);  // Delete row at index 3
 
 // Clear all rows
 table.setData([]);
-// NOT: table.data = null (causes issues)
+// NOT: table.data = null or undefined (causes unexpected behavior)
+// Use table.setData([]) or table.data = [] to clear
 ```
 
 ### Updating Specific Row