@maccesar/titools 2.0.7 → 2.2.1

package/skills/ti-howtos/references/web-content-integration.md

@@ -1,47 +1,10 @@
 # Web Content Integration
 
-## Table of Contents
-
-- [Web Content Integration](#web-content-integration)
-  - [Table of Contents](#table-of-contents)
-  - [1. The WebView Component](#1-the-webview-component)
-    - [WKWebView (Titanium SDK 8.0.0+)](#wkwebview-titanium-sdk-800)
-    - [Basic WebView Creation](#basic-webview-creation)
-      - [Remote URL](#remote-url)
-      - [Local HTML](#local-html)
-      - [Inline HTML](#inline-html)
-    - [Local Web Content with Assets](#local-web-content-with-assets)
-    - [WebView Properties and Methods](#webview-properties-and-methods)
-      - [Navigation](#navigation)
-      - [Load Control](#load-control)
-      - [Data Handling](#data-handling)
-      - [Events](#events)
-  - [2. Communication Between WebViews and Titanium](#2-communication-between-webviews-and-titanium)
-    - [Local Web Content Communication](#local-web-content-communication)
-      - [Logging from WebView](#logging-from-webview)
-      - [Bidirectional Events with Ti.App](#bidirectional-events-with-tiapp)
-    - [Remote Web Content Communication](#remote-web-content-communication)
-      - [Using evalJS() for Remote Content](#using-evaljs-for-remote-content)
-      - [Passing Data to Remote Content](#passing-data-to-remote-content)
-  - [3. Performance and Interaction Concerns](#3-performance-and-interaction-concerns)
-    - [WebView Performance](#webview-performance)
-    - [WebView in TableViews](#webview-in-tableviews)
-    - [WebView in Scrollable Components](#webview-in-scrollable-components)
-    - [Viewport Meta Tag](#viewport-meta-tag)
-  - [4. WebView Use Cases](#4-webview-use-cases)
-    - [Authentication Flows](#authentication-flows)
-    - [Canvas and Graphics](#canvas-and-graphics)
-  - [5. WKWebView-Specific Considerations](#5-wkwebview-specific-considerations)
-  - [Best Practices Summary](#best-practices-summary)
-
----
-
 ## 1. The WebView Component
 
 ### WKWebView (Titanium SDK 8.0.0+)
-Apple deprecated UIWebView. Titanium now uses WKWebView as the underlying implementation.
 
-**Important**: WKWebView has some behavioral differences compared to the original UIWebView.
+> **Important**: As of Titanium SDK 8.0.0, WKWebView is the only supported web view on iOS. Apple deprecated UIWebView and it has been removed. WKWebView has behavioral differences you must account for.
 
 ### Basic WebView Creation
 
@@ -104,7 +67,10 @@ Local content can include CSS, JS, and images. Paths are relative to Resources (
 - `url` - Local or remote URL
 - `html` - Inline HTML string
 - `scalesPageToFit` - Boolean to scale content to dimensions
-- `setBasicAuthentication(username, password)` - HTTP authentication
+- `setBasicAuthentication(host, username, password)` - HTTP authentication
+  ```javascript
+  webView.setBasicAuthentication('myDomain.com', 'username', 'password');
+  ```
 
 #### Events
 - `beforeload` - Fires before loading begins (`e.url` contains the source)
@@ -178,6 +144,8 @@ button.addEventListener('click', () => {
 
 **Critical**: Titanium statements (Ti.API, Ti.App) do NOT work in remote HTML content.
 
+> **Warning**: On iOS 12.0+, calling `evalJS()` synchronously from certain contexts can cause a deadlock. Always prefer the callback-based async version.
+
 #### Using evalJS() for Remote Content
 
 Inject JavaScript and retrieve results as strings:
@@ -259,6 +227,12 @@ For mobile-optimized content, use the viewport meta tag:
 
 ## 4. WebView Use Cases
 
+### Common WebView Use Cases
+- **HTML forms**: WebViews provide auto-scroll to focused fields, next/previous navigation, and native keyboard integration — often better than building forms in native UI.
+- **Rich text / HTML email**: Render styled content that would be difficult with native labels.
+- **Canvas / graphics**: HTML5 Canvas provides 2D drawing capabilities not available in native Titanium APIs.
+- **OAuth flows**: Load third-party auth pages (Google, Facebook) inside a WebView and intercept redirects.
+
 ### Authentication Flows
 Many OAuth providers use WebView for login (like the Facebook module).
 
@@ -289,13 +263,22 @@ For complex graphics, use HTML5 Canvas:
 </script>
 ```
 
-## 5. WKWebView-Specific Considerations
+## 5. WKWebView Behavioral Differences (iOS)
 
-1. **Cookie Management**: WKWebView has separate cookie storage.
-2. **localStorage/SessionStorage**: Not shared with native app.
-3. **Asynchronous evalJS**: In modern iOS versions, async usage is preferred to avoid blocking.
-
-For detailed WKWebView information, refer to the official migration guide and specific behaviors.
+- **Cookies**: WKWebView uses a separate cookie store from `Ti.Network`. Cookies set via HTTPClient are not automatically shared with WebViews.
+- **localStorage/sessionStorage**: NOT shared between the native app and the WebView. Each WKWebView has its own storage.
+- **evalJS is async**: On iOS 12.0+, synchronous `evalJS()` can cause deadlocks. Use the callback form instead:
+  ```javascript
+  webView.evalJS('document.title', (result) => {
+      Ti.API.info(`Title: ${result}`);
+  });
+  ```
+- **Viewport meta tag required**: WKWebView requires an explicit viewport tag to scale content properly:
+  ```html
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  ```
+- **Custom fonts**: Must use a special `@font-face` path format in WKWebView CSS. Fonts must be in the app bundle and referenced correctly.
+- **Remote HTML limitations**: `Ti.API`, `Ti.App.fireEvent()`, and other Titanium calls do NOT work in remotely-loaded HTML pages. Only local HTML files can communicate with the Titanium runtime.
 
 ## Best Practices Summary
 

package/skills/ti-howtos/references/webpack-build-pipeline.md

@@ -1,20 +1,6 @@
 # Webpack Build Pipeline
 
-Starting with Titanium SDK 9.1.0, Webpack is the default build engine for managing your project's assets and code.
-
-## Table of Contents
-
-- [Webpack Build Pipeline](#webpack-build-pipeline)
-  - [Table of Contents](#table-of-contents)
-  - [1. Key Benefits](#1-key-benefits)
-  - [2. The `@` Alias](#2-the--alias)
-  - [3. NPM Dependency Management](#3-npm-dependency-management)
-  - [4. Platform-Specific Files](#4-platform-specific-files)
-  - [5. Diagnostic Web UI](#5-diagnostic-web-ui)
-  - [6. Advanced Configuration](#6-advanced-configuration)
-  - [7. Known Limitations](#7-known-limitations)
-
----
+Webpack integration is available as an **alternative build pipeline** starting with Titanium SDK 9.1.0. It is not mandatory — projects work without it. When enabled, Webpack manages your project's assets and code bundling.
 
 ## 1. Key Benefits
 - **Lightning-Fast Incremental Builds**: Only what changes is processed.
@@ -63,7 +49,34 @@ When doing `import { func } from '@/utils'`, Webpack will select the correct ver
 Webpack includes a web interface to analyze the build and asset sizes.
 Default URL: `http://localhost:1732/webpack/latest/web`
 
-## 6. Advanced Configuration
+## 6. Project Plugins
+Webpack support is powered by plugins that handle different project types. Plugins are automatically selected based on your project:
+
+| Plugin                             | Purpose                 |
+| ---------------------------------- | ----------------------- |
+| `@appcd/webpack-plugin-alloy`      | Alloy project support   |
+| `@appcd/webpack-plugin-classic`    | Classic project support |
+| `@appcd/webpack-plugin-babel`      | Babel transpilation     |
+| `@appcd/webpack-plugin-typescript` | TypeScript support      |
+
+### Custom Plugin Configuration
+Plugins can be customized using the `webpack-chain` API in your project's `webpack.config.js`:
+
+```javascript
+module.exports = (api) => {
+    // Add a custom alias
+    api.chainWebpack((config) => {
+        config.resolve.alias.set('@utils', api.resolve('app/lib/utils'));
+    });
+};
+```
+
+Common customizations:
+- **Add alias**: `config.resolve.alias.set(name, path)`
+- **Add loader**: `config.module.rule(name).use(name).loader(loader)`
+- **Delete plugin**: `config.plugins.delete(name)`
+
+## 7. Advanced Configuration
 You can extend the configuration via plugins in `package.json`:
 ```json
 {
@@ -73,6 +86,29 @@ You can extend the configuration via plugins in `package.json`:
 }
 ```
 
-## 7. Known Limitations
+## 8. Global Configuration
+Configure Webpack daemon settings in `~/.appcelerator/appcd/config.json`:
+```json
+{
+    "webpack": {
+        "inactivityTimeout": 600000
+    }
+}
+```
+
+## 9. Troubleshooting
+
+**Build seems stuck**: The Webpack daemon may need a restart:
+```bash
+appcd exec /webpack/latest/stop
+```
+
+**View build logs**:
+```bash
+appcd logcat "*webpack*"
+```
+
+## 10. Known Limitations
 - **Hyperloop**: Currently not compatible with the Webpack pipeline.
-- **Alloy.jmk**: Older makefiles are ignored by Webpack.
+- **Alloy.jmk**: Build hooks are not supported — use Webpack plugins instead.
+- First build may be slower due to daemon startup.

package/skills/ti-ui/SKILL.md

@@ -28,26 +28,6 @@ This skill automatically detects Titanium projects when invoked and provides UI/
 - **Not detected** → Indicates this is for Titanium projects only, does NOT provide Titanium UI guidance
 :::
 
-## Table of Contents
-
-- [Titanium SDK UI Expert](#titanium-sdk-ui-expert)
-  - [Project Detection](#project-detection)
-  - [Table of Contents](#table-of-contents)
-  - [Quick Reference](#quick-reference)
-  - [Critical Rules (Low Freedom)](#critical-rules-low-freedom)
-    - [Performance](#performance)
-    - [iOS Accessibility](#ios-accessibility)
-    - [Layout](#layout)
-    - [Platform-Specific Properties](#platform-specific-properties)
-    - [Event Management](#event-management)
-    - [App Architecture](#app-architecture)
-  - [Platform Differences Summary](#platform-differences-summary)
-  - [UI Design Workflow](#ui-design-workflow)
-  - [Searching References](#searching-references)
-  - [Related Skills](#related-skills)
-
----
-
 ## Quick Reference
 
 | Topic                            | Reference                                                               |
@@ -174,6 +154,6 @@ For tasks beyond UI components, use these complementary skills:
 
 | Task                                            | Use This Skill |
 | ----------------------------------------------- | -------------- |
-| Project architecture, services, memory cleanup  | `alloy-expert` |
+| Project architecture, services, memory cleanup  | `ti-expert`    |
 | Native features (camera, location, push, media) | `ti-howtos`    |
 | Alloy MVC, data binding, widgets                | `alloy-guides` |

package/skills/ti-ui/references/accessibility-deep-dive.md

@@ -1,32 +1,15 @@
 # Accessibility (a11y) Deep Dive
 
-## Table of Contents
-
-- [Accessibility (a11y) Deep Dive](#accessibility-a11y-deep-dive)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. Core Accessibility Properties](#2-core-accessibility-properties)
-    - [Basic Usage](#basic-usage)
-    - [Android TalkBack](#android-talkback)
-    - [Star Rating Example](#star-rating-example)
-    - [Toggle Button Example](#toggle-button-example)
-  - [6. System-Level Accessibility Events](#6-system-level-accessibility-events)
-    - [Monitor Accessibility Changes](#monitor-accessibility-changes)
-    - [Code Patterns](#code-patterns)
-    - [Accessibility First Development](#accessibility-first-development)
-  - [9. External Resources](#9-external-resources)
-  - [10. Common Issues](#10-common-issues)
-    - [Issue: VoiceOver Can't Access Children](#issue-voiceover-cant-access-children)
-    - [Issue: TalkBack Doesn't Speak Text](#issue-talkback-doesnt-speak-text)
-    - [Issue: Complex Custom Controls Not Accessible](#issue-complex-custom-controls-not-accessible)
-    - [Issue: State Changes Not Announced](#issue-state-changes-not-announced)
-
----
-
 ## 1. Overview
 
 Accessibility ensures your app is usable by everyone, including users with visual, hearing, and motor disabilities. Titanium supports both Android TalkBack and iOS VoiceOver spoken feedback systems.
 
+### Design Considerations Beyond Screen Readers
+
+- **Motor disabilities**: Provide larger tap targets (minimum 44x44 points on iOS, 48x48 dp on Android). Support alternative input methods. Avoid interactions that require precise gestures or rapid timing.
+- **Color-blindness**: Never rely on color alone to convey information. Use text labels, icons, or patterns alongside color indicators. Test your UI with grayscale to verify usability.
+- **Screen magnifiers**: Users with low vision may use the built-in zoom features (iOS Zoom, Android Magnification). Ensure your layout remains functional when magnified — avoid absolute positioning that breaks at large zoom levels.
+
 ## 2. Core Accessibility Properties
 
 All Titanium view elements support these accessibility properties:
@@ -38,6 +21,8 @@ All Titanium view elements support these accessibility properties:
 | `accessibilityHint`   | -                             | Briefly describes what performing an action will do (e.g., "Closes the window") |
 | `accessibilityValue`  | State or value of the control | String describing current state (e.g., "Selected", "50 percent")                |
 
+> **Android note**: On Android, `accessibilityLabel`, `accessibilityValue`, and `accessibilityHint` are combined (in that order) and mapped to Android's native `contentDescription` property. This means TalkBack reads all three as a single string, while VoiceOver on iOS reads them as separate announcements.
+
 ### Basic Usage
 
 ```javascript
@@ -79,6 +64,8 @@ const button = Ti.UI.createButton({
 ...
 ```javascript
 // BAD - Container with accessibility properties
+// On iOS, VoiceOver treats the entire container as ONE accessible element,
+// completely blocking access to all children inside it (nameField, emailField, etc.)
 const container = Ti.UI.createView({
   accessibilityLabel: 'Form container',  // DON'T DO THIS
   accessibilityHint: 'Contains input fields'
@@ -175,6 +162,7 @@ const label = Ti.UI.createLabel({
 });
 
 // Don't set accessibility on containers (iOS)
+// VoiceOver treats the container as a single element, making all children unreachable
 const container = Ti.UI.createView({
   accessibilityLabel: 'Container'  // BLOCKS children on iOS
 });
@@ -208,14 +196,72 @@ function createAccessibleListItem(title, subtitle, action) {
 }
 ```
 
-## 9. External Resources
+## 9. Platform Behavior Comparison
+
+TalkBack (Android) and VoiceOver (iOS) interpret accessibility properties differently:
+
+| Element                          | TalkBack Response                                 | VoiceOver Response                                      |
+| -------------------------------- | ------------------------------------------------- | ------------------------------------------------------- |
+| Button with label "Submit"       | "Submit, button, double-tap to activate"          | "Submit, button"                                        |
+| Slider with value 50%            | "50 percent, slider"                              | "50%, adjustable"                                       |
+| Label with hint                  | Reads label + value + hint as one combined string | Reads label first, then hint as a separate announcement |
+| Checkbox, checked                | "Checked, checkbox, double-tap to toggle"         | "Checked, tick box"                                     |
+| Image with label "Profile photo" | "Profile photo"                                   | "Profile photo, image"                                  |
+
+> On Android, the three accessibility properties are concatenated into `contentDescription`, so they are always read as one utterance. On iOS, VoiceOver reads them as distinct pieces with brief pauses between them.
+
+## 10. Testing Procedures
+
+### Android Emulator
+
+The Android emulator does not provide a built-in method to test accessibility. You must test on a physical device for accurate TalkBack behavior.
+
+### Android Device (TalkBack)
+
+1. Open **Settings > Accessibility > TalkBack**
+2. Toggle TalkBack **On**
+3. A confirmation dialog appears — confirm to enable
+
+**TalkBack gestures**:
+- **Tap**: Select and hear the element described
+- **Double-tap**: Activate the selected element
+- **Swipe left/right**: Navigate to the previous/next element
+- **Swipe up/down**: Change reading granularity (characters, words, headings)
+
+To disable TalkBack, navigate to the same setting and toggle it off. You can also set a hardware shortcut (hold both volume keys for 3 seconds) for quick toggling during development.
+
+### iOS Simulator (Accessibility Inspector)
+
+Use the Accessibility Inspector to examine elements without enabling VoiceOver:
+
+1. In Xcode, go to **Xcode > Open Developer Tool > Accessibility Inspector**
+2. Select the Simulator as the target device
+3. Hover over or tap elements to inspect their accessibility label, value, hint, and traits
+
+This is the fastest way to verify properties during development.
+
+### iOS Device (VoiceOver)
+
+1. Open **Settings > Accessibility > VoiceOver**
+2. Toggle VoiceOver **On**
+
+**VoiceOver gestures**:
+- **Tap**: Select and hear the element described
+- **Double-tap**: Activate the selected element
+- **Swipe left/right**: Navigate to the previous/next element
+- **Three-finger swipe**: Scroll content
+- **Two-finger tap**: Pause/resume speech
+
+To disable VoiceOver, navigate to the same setting and toggle it off. You can also configure the Accessibility Shortcut (triple-click the side button) for quick toggling.
+
+## 11. External Resources
 
 - [Accessibility Programming Guide for iOS](https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/iPhoneAccessibility/Introduction/Introduction.html)
 - [Android Accessibility API Guide](http://developer.android.com/guide/topics/ui/accessibility/index.html)
 - [Android Accessibility Design Guide](http://developer.android.com/design/patterns/accessibility.html)
 - [W3C Web Content Accessibility Guidelines](http://www.w3.org/WAI/WCAG20/quickref/)
 
-## 10. Common Issues
+## 12. Common Issues
 
 ### Issue: VoiceOver Can't Access Children
 

package/skills/ti-ui/references/animation-and-matrices.md

@@ -1,52 +1,5 @@
 # Animation, Matrices, and Transitions
 
-## Table of Contents
-
-- [Animation, Matrices, and Transitions](#animation-matrices-and-transitions)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. Basic Animations](#2-basic-animations)
-    - [Property Animation Syntax](#property-animation-syntax)
-    - [Animation Properties](#animation-properties)
-    - [Animation Curves (Easing)](#animation-curves-easing)
-    - [Reversing Animation](#reversing-animation)
-    - [Repeating Animation](#repeating-animation)
-  - [3. 2D Matrix Animations](#3-2d-matrix-animations)
-    - [Basic 2D Transform](#basic-2d-transform)
-    - [2D Matrix Methods](#2d-matrix-methods)
-    - [Sequential Transformations](#sequential-transformations)
-    - [Identity (Reset) Transform](#identity-reset-transform)
-  - [4. 3D Matrix Animations (iOS Only)](#4-3d-matrix-animations-ios-only)
-    - [Basic 3D Transform](#basic-3d-transform)
-    - [3D Matrix Methods](#3d-matrix-methods)
-    - [Flip Card Effect](#flip-card-effect)
-  - [5. iOS Transitions](#5-ios-transitions)
-    - [Transition Constants](#transition-constants)
-    - [View Transition](#view-transition)
-    - [Window Transition (NavigationWindow)](#window-transition-navigationwindow)
-  - [6. Dynamic Animations (iOS Only)](#6-dynamic-animations-ios-only)
-    - [Gravity Animation](#gravity-animation)
-    - [Attachment (Spring) Behavior](#attachment-spring-behavior)
-    - [Push Behavior](#push-behavior)
-  - [7. Animation Events](#7-animation-events)
-    - [Animation Lifecycle](#animation-lifecycle)
-    - [Stopping Animations](#stopping-animations)
-  - [8. Common Animation Patterns](#8-common-animation-patterns)
-    - [Fade In/Out](#fade-inout)
-    - [Slide In](#slide-in)
-    - [Pulse Animation](#pulse-animation)
-    - [Shake Animation](#shake-animation)
-    - [Bounce In](#bounce-in)
-  - [9. Performance Considerations](#9-performance-considerations)
-    - [DO:](#do)
-    - [DON'T:](#dont)
-    - [Bad vs Good](#bad-vs-good)
-  - [10. Platform Differences](#10-platform-differences)
-    - [iOS vs Android](#ios-vs-android)
-  - [Best Practices](#best-practices)
-
----
-
 ## 1. Overview
 
 Animations add visual interest and professionalism to apps when used appropriately. Titanium supports:

package/skills/ti-ui/references/application-structures.md

@@ -1,51 +1,5 @@
 # Application Structures and Core Building Blocks
 
-## Table of Contents
-
-- [Application Structures and Core Building Blocks](#application-structures-and-core-building-blocks)
-  - [Table of Contents](#table-of-contents)
-  - [1. Overview](#1-overview)
-  - [2. Windows](#2-windows)
-    - [Window Concepts](#window-concepts)
-    - [Creating Windows](#creating-windows)
-    - [Window Events](#window-events)
-    - [Window Lifecycle](#window-lifecycle)
-  - [3. Views](#3-views)
-    - [View Concepts](#view-concepts)
-    - [Creating Views](#creating-views)
-    - [Common View Types](#common-view-types)
-    - [Adding Views to Windows](#adding-views-to-windows)
-    - [Removing Views](#removing-views)
-  - [4. TabGroups](#4-tabgroups)
-    - [Tab-Based Apps](#tab-based-apps)
-    - [Tab Properties](#tab-properties)
-    - [Window Titles vs Tab Titles](#window-titles-vs-tab-titles)
-    - [Tab Events](#tab-events)
-    - [Tab Recommendations](#tab-recommendations)
-    - [Tab-Based Applications](#tab-based-applications)
-    - [Navigation Bar Customization](#navigation-bar-customization)
-  - [7. Modal Windows](#7-modal-windows)
-    - [iOS Modal Windows](#ios-modal-windows)
-  - [8. Heavyweight vs Lightweight Windows](#8-heavyweight-vs-lightweight-windows)
-    - [Heavyweight Windows (Android)](#heavyweight-windows-android)
-    - [Lightweight Windows](#lightweight-windows)
-  - [9. Window Hierarchy and Stacking](#9-window-hierarchy-and-stacking)
-    - [Understanding the Stack](#understanding-the-stack)
-    - [Accessing the Stack](#accessing-the-stack)
-  - [10. Platform-Specific Navigation](#10-platform-specific-navigation)
-    - [Android Navigation Patterns](#android-navigation-patterns)
-    - [iOS Navigation Patterns](#ios-navigation-patterns)
-  - [11. Execution Contexts](#11-execution-contexts)
-    - [Lightweight Contexts](#lightweight-contexts)
-  - [12. Common Patterns](#12-common-patterns)
-    - [Drill-Down Navigation](#drill-down-navigation)
-    - [Modal Forms](#modal-forms)
-    - [Tab with Navigation](#tab-with-navigation)
-  - [13. Best Practices](#13-best-practices)
-  - [14. Platform Differences Summary](#14-platform-differences-summary)
-
----
-
 ## 1. Overview
 
 Titanium apps are built from three core components:

package/skills/ti-ui/references/custom-fonts-styling.md

@@ -1,62 +1,5 @@
 # Custom Fonts and Attributed Strings
 
-## Table of Contents
-
-- [Custom Fonts and Attributed Strings](#custom-fonts-and-attributed-strings)
-  - [Table of Contents](#table-of-contents)
-  - [1. Custom Fonts Overview](#1-custom-fonts-overview)
-    - [Font Sources](#font-sources)
-  - [2. Platform-Specific Font Loading](#2-platform-specific-font-loading)
-    - [Key Difference](#key-difference)
-    - [Example](#example)
-  - [3. Alloy Projects](#3-alloy-projects)
-    - [Directory Structure](#directory-structure)
-    - [XML Usage](#xml-usage)
-    - [TSS Styling](#tss-styling)
-    - [Cross-Platform Solution 1: Rename Font File](#cross-platform-solution-1-rename-font-file)
-    - [Cross-Platform Solution 2: Platform-Specific Styles](#cross-platform-solution-2-platform-specific-styles)
-  - [4. Classic Titanium Projects](#4-classic-titanium-projects)
-    - [Directory Structure](#directory-structure-1)
-    - [Runtime Platform Switching](#runtime-platform-switching)
-    - [Platform-Switching Helper Function](#platform-switching-helper-function)
-  - [5. Finding PostScript Name](#5-finding-postscript-name)
-    - [Using FontBook (macOS)](#using-fontbook-macos)
-    - [Common Font Patterns](#common-font-patterns)
-  - [6. iOS Platform Notes](#6-ios-platform-notes)
-    - [Automatic Info.plist Registration](#automatic-infoplist-registration)
-    - [Using System Fonts](#using-system-fonts)
-  - [7. Attributed Strings](#7-attributed-strings)
-    - [Basic Syntax](#basic-syntax)
-    - [Important Warning](#important-warning)
-    - [Property Equivalents](#property-equivalents)
-  - [8. Attribute Types](#8-attribute-types)
-    - [Font Attribute](#font-attribute)
-    - [Foreground Color](#foreground-color)
-    - [Background Color](#background-color)
-    - [Underline](#underline)
-    - [Strikethrough](#strikethrough)
-    - [Links (iOS 7+)](#links-ios-7)
-  - [9. iOS-Exclusive Attributes](#9-ios-exclusive-attributes)
-    - [Ligature](#ligature)
-    - [Kerning (Character Spacing)](#kerning-character-spacing)
-    - [Stroke Text (iOS 7+)](#stroke-text-ios-7)
-    - [Shadow (iOS 7+)](#shadow-ios-7)
-    - [Letterpress Effect (iOS 7+)](#letterpress-effect-ios-7)
-    - [Writing Direction (iOS 7+)](#writing-direction-ios-7)
-    - [Baseline Offset (iOS 7+)](#baseline-offset-ios-7)
-    - [Oblique/Skew (iOS 7+)](#obliqueskew-ios-7)
-    - [Expansion (iOS 7+)](#expansion-ios-7)
-  - [10. Multiple Attributes Example](#10-multiple-attributes-example)
-  - [11. Best Practices](#11-best-practices)
-    - [Custom Fonts](#custom-fonts)
-    - [Attributed Strings](#attributed-strings)
-  - [12. Common Issues](#12-common-issues)
-    - [Font Not Showing](#font-not-showing)
-    - [Wrong Font on One Platform](#wrong-font-on-one-platform)
-    - [Attributed String Not Displaying](#attributed-string-not-displaying)
-
----
-
 ## 1. Custom Fonts Overview
 
 Titanium supports TrueType (.ttf) and OpenType (.otf) fonts on both iOS and Android. Custom fonts are a quick way to personalize or brand your application.
@@ -372,6 +315,15 @@ const attr = Ti.UI.createAttributedString({
 
 **iOS**: Supports same styles and patterns as Underline.
 
+**iOS Strikethrough Color** (iOS 7+):
+```javascript
+{
+  type: Ti.UI.ATTRIBUTE_STRIKETHROUGH_COLOR,
+  value: 'red',
+  range: [start, length]
+}
+```
+
 ### Links (iOS 7+)
 
 ```javascript

package/skills/ti-ui/references/event-handling.md

@@ -1,43 +1,5 @@
 # Event Handling
 
-## Table of Contents
-
-- [Event Handling](#event-handling)
-  - [Table of Contents](#table-of-contents)
-  - [1. Event Listener Pattern](#1-event-listener-pattern)
-    - [Basic Pattern](#basic-pattern)
-    - [Controlling Event Bubbling](#controlling-event-bubbling)
-    - [Bubbling Example](#bubbling-example)
-  - [3. Firing Events](#3-firing-events)
-    - [Fire Custom Event](#fire-custom-event)
-    - [Listening to App Events](#listening-to-app-events)
-    - [Memory Warning](#memory-warning)
-  - [5. Touch Events](#5-touch-events)
-    - [Touch Event Lifecycle](#touch-event-lifecycle)
-    - [Touch Enabled](#touch-enabled)
-  - [6. Named vs Anonymous Functions](#6-named-vs-anonymous-functions)
-    - [Anonymous Function (One-time use)](#anonymous-function-one-time-use)
-    - [Named Function (Reusable)](#named-function-reusable)
-  - [7. Removing Event Listeners](#7-removing-event-listeners)
-    - [Must Match Function Signature](#must-match-function-signature)
-  - [8. Android Hardware Button Events](#8-android-hardware-button-events)
-    - [Available Events](#available-events)
-    - [Handling Back Button](#handling-back-button)
-    - [Note: Window Types](#note-window-types)
-  - [9. Android Menu](#9-android-menu)
-    - [Create Options Menu](#create-options-menu)
-  - [10. Event Listener Best Practices](#10-event-listener-best-practices)
-    - [Define Before Event May Fire](#define-before-event-may-fire)
-    - [Global Event Memory Leaks](#global-event-memory-leaks)
-    - [Remove Listeners on Window Close](#remove-listeners-on-window-close)
-  - [11. Special Considerations](#11-special-considerations)
-    - [Platform-Specific Events](#platform-specific-events)
-    - [Event Naming](#event-naming)
-    - [Custom Properties on Events](#custom-properties-on-events)
-  - [Best Practices Summary](#best-practices-summary)
-
----
-
 ## 1. Event Listener Pattern
 
 ### Basic Pattern
@@ -50,19 +12,39 @@ element.addEventListener('event_type', (e) => {
 });
 ```
 ...
+### Events That Bubble
+
+All user input events defined by `Ti.UI.View` bubble up the view hierarchy: `click`, `dblclick`, `doubletap`, `longclick`, `longpress`, `pinch`, `singletap`, `swipe`, `touchcancel`, `touchend`, `touchmove`, `touchstart`, `twofingertap`. The **only** `Ti.UI.View` event that does NOT bubble is `postlayout`.
+
+> **Event synonyms**: `singletap` is a synonym for `click`, and `doubletap` is a synonym for `dblclick`.
+
+Events representing view-specific state — such as `focus`, `scroll`, and `postlayout` — do **not** bubble. Only user input events bubble.
+
+### Bubbling Boundaries
+
+Bubbling stops at these special container boundaries: `Window`, `NavigationWindow`, `SplitWindow`, `Tab`, and `TabGroup`.
+
+Note that `TableViewSection` is a logical (non-view) container that still participates in bubbling — events from rows bubble through the section to the `TableView`.
+
+### Native Event Handling Precedence
+
+Event bubbling happens after native event handling. Native UI effects (such as highlighting) have already occurred before any event handler fires.
+
 ### Controlling Event Bubbling
 
 ```javascript
 // Check if event bubbles
 Ti.API.info(`Bubbles: ${e.bubbles}`);
 
-// Stop further bubbling
+// Stop further bubbling — cancelBubble is always false when an event handler is invoked
 e.cancelBubble = true;
 
 // Prevent view from bubbling to parent
 view.bubbleParent = false;
 ```
 
+> **Note**: Multiple events of different types are treated separately. If the user lifting their finger triggers `touchend`, `singletap`, and `click`, setting `cancelBubble` on one does not affect the others.
+
 ### Bubbling Example
 
 ```javascript
@@ -256,7 +238,7 @@ win.addEventListener('androidback', (e) => {
 
 ### Note: Window Types
 
-Since 3.2.0, all windows are heavyweight by default and can receive hardware button events.
+Since 3.2.0, all windows are heavyweight by default and you cannot control the type of window created. All windows can receive hardware button events.
 
 ## 9. Android Menu
 
@@ -360,6 +342,16 @@ Some events only work on certain platforms:
 - `globalPoint` property - iOS only
 - Hardware buttons - Android only
 
+### Shake Event
+
+The `Ti.Gesture` module enables listening for the `shake` event, which fires when the device detects a shake motion:
+
+```javascript
+Ti.Gesture.addEventListener('shake', (e) => {
+  Ti.API.info(`Device shaken at timestamp: ${e.timestamp}`);
+});
+```
+
 ### Event Naming
 
 **WARNING**: Do NOT use spaces in custom event names (causes issues with libraries like Backbone.js):