@maccesar/titools 4.4.2 → 4.6.1

package/skills/ti-api/references/api-ui-extras.md

@@ -280,27 +280,90 @@ JavaScript in the web view executes in its own context.  The web view can intera
 #### BackForwardList
 > The object returned to the <Titanium.UI.WebView.backForwardList> method.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| currentItem | BackForwardListItem | The current item. |
-| backItem | BackForwardListItem | The item immediately preceding the current item. |
-| forwardItem | BackForwardListItem | The item immediately following the current item. |
-| backList | Array<BackForwardListItem> | The portion of the list preceding the current item. |
-| forwardList | Array<BackForwardListItem> | The portion of the list following the current item. |
-
-#### Dictionary
-> Plain JavaScript object.
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| currentItem | BackForwardListItem | ios | The current item. |
+| backItem | BackForwardListItem | ios | The item immediately preceding the current item. |
+| forwardItem | BackForwardListItem | ios | The item immediately following the current item. |
+| backList | Array<BackForwardListItem> | ios | The portion of the list preceding the current item. |
+| forwardList | Array<BackForwardListItem> | ios | The portion of the list following the current item. |
+
+#### BackForwardListItem
+> The object represents a webpage in the back-forward of a web view.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| url | String | ios | The URL of the webpage represented by this item. |
+| initialUrl | String | ios | The URL of the initial request that created this item. |
+| title | String | ios | The title of the webpage represented by this item. |
+
+#### DataCreationResult
+> The parameter passed to the <Titanium.UI.WebView.createPDF> or <Titanium.UI.WebView.createWebArchive>callback.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| data | Ti.Blob | ios | The created data. |
+| success | Boolean | ios | Indicates if the data creation successful or not. |
+| error | String | ios | Error message, if any returned. |
+
+#### DataCreationResultAndroid
+> Success callback in <Titanium.UI.WebView.createPDF>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| data | Ti.Blob | android | The created data. |
+
+#### OnLinkURLResponse
+> An object returned when the <Titanium.UI.WebView.onlink> callback is fired.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| url | String | both | The URL of the link that should be navigated to. |
+
+#### SearchResult
+> The parameter passed to the <Titanium.UI.WebView.findString>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | ios | Indicates if string found or not. |
+| error | String | ios | Error message, if any returned. |
+
+#### setHtmlOptions
+> Options used by <Titanium.UI.WebView.setHtml>
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| baseURL | String | both | Sets the URL that the web content's paths will be relative to. |
+| mimeType | String | both | Sets the MIME type for the content. Defaults to "text/html" if not specified. |
+
+#### SnapshotResult
+> The parameter passed to the <Titanium.UI.WebView.takeSnapshot> callback.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| snapshot | Ti.Blob | ios | The snapshot image. |
+| success | Boolean | ios | Indicates if the snapshot taken. |
+| error | String | ios | Error message, if any returned. |
 
 #### StringSearchOptions
 > The optional options to pass to the <Titanium.UI.WebView.findString>. Pass a dictionary with one or more of the following string-keys:     * `caseSensitive` (Boolean value)     * `backward` (Boolean value)     * `wraps` (Boolean value)
 
-| Property | Type | Description |
-|----------|------|-------------|
-| caseSensitive | Boolean | Whether or not the search should be case sensitive. |
-| backward | Boolean | The direction to search from the current selection. The search will respect the… |
-| wraps | Boolean | Whether the search should start at the beginning of the document once it reache… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| caseSensitive | Boolean | both | Whether or not the search should be case sensitive. |
+| backward | Boolean | both | The direction to search from the current selection. The search will respect the… |
+| wraps | Boolean | both | Whether the search should start at the beginning of the document once it reache… |
+
+#### UserScriptParams
+> Dictionary of options for the <Titanium.UI.WebView.addUserScript> method.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| source | String | ios | A script that can be injected into a webpage. |
+| injectionTime | Number | ios | The time when the script should be injected into the webpage. |
+| mainFrameOnly | Boolean | ios | A Boolean value indicating whether the script should be injected only into the … |
 
-*Plus 2 more types: *
+Also referenced by this API, documented elsewhere: `Dictionary`.
 
 ---
 

package/skills/ti-api/references/api-ui-lists.md

@@ -131,22 +131,54 @@ A `ListView` object is a container for [ListSection](Titanium.UI.ListSection) ob
 #### AnimatedOptions
 > A JavaScript object holding an `animated` property. Used for many UI methods as a means of specifying some transition should be animated.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
 
 #### AnimatedWithDurationOptions
 > A JavaScript object holding `animated` and `duration` properties. Used on iOS For [TableView](Titanium.UI.TableView) and [ListView](Titanium.UI.ListView) content offset transitions.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
-| duration | Number | The duration in `milliseconds` for animation |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
+| duration | Number | both | The duration in `milliseconds` for animation |
+
+#### ListItemEventType
+> The arguments for the <Titanium.UI.ListView.prefetch> and <Titanium.UI.ListView.cancelprefetch> events.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| section | Ti.UI.ListSection | ios | List section if the item is contained in a list section. |
+| sectionIndex | Number | ios | Section index. |
+| itemIndex | Number | ios | Item index. |
+| itemId | String | ios | The item ID bound to the list item that generated the event. |
+
+#### ListViewIndexEntry
+> A simple object that represents an index entry in a `ListView`.
 
-#### Dictionary
-> Plain JavaScript object.
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| title | String | ios | Title to display in the index bar. |
+| index | Number | ios | Section index associated with this title. |
 
-*Plus 6 more types: ListViewMarkerProps, Padding, Point, SelectedItem*
+#### ListViewMarkerProps
+> The parameter for [setMarker](Titanium.UI.ListView.setMarker) and [addMarker](Titanium.UI.ListView.addMarker) methods.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| sectionIndex | Number | both | The sectionIndex of the reference item. |
+| itemIndex | Number | both | The itemIndex of the reference item. |
+
+#### SelectedItem
+> The arguments for the <Titanium.UI.ListView.itemsselected> event.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| section | Ti.UI.ListSection | both | List section if the item is contained in a list section. |
+| sectionIndex | Number | both | Section index. |
+| itemIndex | Number | both | Item index. |
+
+Also referenced by this API, documented elsewhere: `Dictionary`, [HorizontalInsets](#horizontalinsets), [ListViewAnimationProperties](#listviewanimationproperties), [Padding](api-ui-windows-navigation.md#padding), [Point](api-ui-extras.md#point).
 
 ---
 
@@ -422,27 +454,62 @@ There are few approaches to creating and using `TableView` object.
 #### AnimatedOptions
 > A JavaScript object holding an `animated` property. Used for many UI methods as a means of specifying some transition should be animated.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
 
 #### AnimatedWithDurationOptions
 > A JavaScript object holding `animated` and `duration` properties. Used on iOS For [TableView](Titanium.UI.TableView) and [ListView](Titanium.UI.ListView) content offset transitions.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
-| duration | Number | The duration in `milliseconds` for animation |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
+| duration | Number | both | The duration in `milliseconds` for animation |
 
 #### HorizontalInsets
 > Dictionary object of parameters for horizontal-only insets applied to [Table](Titanium.UI.TableView) and [List](Titanium.UI.ListView) views. Only `left` and `right` properties are used (see <Padding>).
 
-| Property | Type | Description |
-|----------|------|-------------|
-| left | Number | Left padding/inset |
-| right | Number | Right padding/inset |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| left | Number | both | Left padding/inset |
+| right | Number | both | Right padding/inset |
+
+#### SelectedRowObject
+> The arguments for the <Titanium.UI.TableView.rowsselected> event.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| index | Number | both | Row index. |
+| row | Ti.UI.TableViewRow | both | Table view row object. |
+| rowData | Dictionary<Titanium.UI.TableViewRow> | both | Properties of the row. Use this property rather than `row` to access any custom… |
+| section | Ti.UI.TableViewSection | both | Table view section object, if the clicked row is contained in a section. |
+
+#### Size
+> A simple object consisting of size measurements.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| height | Number | both | The height measurement. |
+| width | Number | both | The width measurement. |
+
+#### TableViewAnimationProperties
+> A simple object for specifying the animation properties to use when inserting or deleting rows, or scrolling the table.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | Whether this table change should be animated. Ignored if any `animationStyle` v… |
+| animationStyle | Number | both | Type of animation to use for row insertions and deletions. |
+| position | Number | both | Specifies what position to scroll the selected row to. |
+
+#### TableViewIndexEntry
+> A simple object that represents an index entry in a `TableView`.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| title | String | both | Title to display in the index bar for this item. |
+| index | Number | both | Row index associated with this item. |
 
-*Plus 5 more types: SelectedRowObject, Size, TableViewAnimationProperties*
+Also referenced by this API, documented elsewhere: `Dictionary`, [Padding](api-ui-windows-navigation.md#padding), [Point](api-ui-extras.md#point).
 
 ---
 

package/skills/ti-api/references/api-ui-windows-navigation.md

@@ -164,32 +164,60 @@ This applies to Windows inside both standalone NavigationWindow and TabGroup (wh
 #### AnimatedOptions
 > A JavaScript object holding an `animated` property. Used for many UI methods as a means of specifying some transition should be animated.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
+
+#### closeWindowParams
+> Dictionary of options for the <Titanium.UI.Window.close> method.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | Determines whether to use an animated effect when the window is closed. Default… |
+| animationDuration | Number | ios | duration of the animation in milliseconds |
+| animationStyle | Number | ios | Transition type to use during a transition animation. |
+| activityEnterAnimation | Number | android | Animation resource to use for the incoming activity. |
+| activityExitAnimation | Number | android | Animation resource to use for the outgoing activity. |
 
 #### Padding
 > Dictionary object of parameters for the padding/insets applied to all kinds of views.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| left | Number | Left padding/inset |
-| right | Number | Right padding/inset |
-| top | Number | Top padding/inset |
-| bottom | Number | Bottom padding/inset |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| left | Number | both | Left padding/inset |
+| right | Number | both | Right padding/inset |
+| top | Number | both | Top padding/inset |
+| bottom | Number | both | Bottom padding/inset |
 
-#### closeWindowParams
-> Dictionary of options for the <Titanium.UI.Window.close> method.
+#### shadowDict
+> Dictionary describing the shadow effect for text.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | Determines whether to use an animated effect when the window is closed. Default… |
-| animationDuration | Number | duration of the animation in milliseconds |
-| animationStyle | Number | Transition type to use during a transition animation. |
-| activityEnterAnimation | Number | Animation resource to use for the incoming activity. |
-| activityExitAnimation | Number | Animation resource to use for the outgoing activity. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| blurRadius | Number | both | Specifies the blur radius of the shadow. |
+| color | String \| Ti.UI.Color | both | Color name or hex triplet specifying the color of the shadow. |
+| offset | Size | both | <Size> with the properties `width` and `height` used as the horizontal and vert… |
+
+#### titleAttributesParams
+> Dictionary of options for the <Titanium.UI.Window.titleAttributes> property.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| color | String \| Ti.UI.Color | both | Color of the window title, as a color name or hex triplet. |
+| font | Font | ios | Font to use for the window title. |
+| shadow | shadowDict | ios | Shadow color and offset for the window title. |
 
-*Plus 3 more types: windowToolbarParam*
+#### windowToolbarParam
+> Dictionary of options for the <Titanium.UI.Window.setToolbar> method.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| translucent | Boolean | both | Defines if the toolbar is translucent. |
+| animated | Boolean | both | Defines if the toolbar appearance is animated. |
+| barColor | String \| Ti.UI.Color | both | Background color for the toolbar, as a color name or hex triplet. |
+| tintColor | String \| Ti.UI.Color | both | The tintColor to apply to the tool bar. |
+
+Also referenced by this API, documented elsewhere: `Dictionary`, [Font](api-ui-lists.md#font), [openWindowParams](#openwindowparams).
 
 ---
 
@@ -334,45 +362,45 @@ You can add tabs to the group using [addTab](Titanium.UI.TabGroup.addTab), and p
 #### closeWindowParams
 > Dictionary of options for the <Titanium.UI.Window.close> method.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | Determines whether to use an animated effect when the window is closed. Default… |
-| animationDuration | Number | duration of the animation in milliseconds |
-| animationStyle | Number | Transition type to use during a transition animation. |
-| activityEnterAnimation | Number | Animation resource to use for the incoming activity. |
-| activityExitAnimation | Number | Animation resource to use for the outgoing activity. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | Determines whether to use an animated effect when the window is closed. Default… |
+| animationDuration | Number | ios | duration of the animation in milliseconds |
+| animationStyle | Number | ios | Transition type to use during a transition animation. |
+| activityEnterAnimation | Number | android | Animation resource to use for the incoming activity. |
+| activityExitAnimation | Number | android | Animation resource to use for the outgoing activity. |
 
 #### disableTabOptions
 > Dictionary of options for the <Titanium.UI.TabGroup.disableTabOptions> method.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | Determines whether to use an animated effect to hide/show the navigation bar. |
-| enabled | Boolean | Show or hide the navigation bar. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | Determines whether to use an animated effect to hide/show the navigation bar. |
+| enabled | Boolean | both | Show or hide the navigation bar. |
 
 #### openWindowParams
 > Dictionary of options for the <Titanium.UI.Window.open> method.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | Determines whether to use an animated effect when the window is shown. |
-| bottom | Number \| String | Window's bottom position, in platform-specific units. |
-| fullscreen | Boolean | Determines if the window is fullscreen. |
-| height | Number \| String | Window's height, in platform-specific units. |
-| left | Number \| String | Window's left position, in platform-specific units. |
-| modal | Boolean | Determines whether to open the window modal in front of other windows. |
-| forceModal | Boolean | Indicates whether the window enforces modal behaviour. |
-| modalStyle | Number | Presentation style of this modal window. |
-| modalTransitionStyle | Number | Transition style of this modal window. |
-| navBarHidden | Boolean | For modal windows, hides the nav bar (`true`) or shows the nav bar (`false`). |
-| right | Number \| String | Window's right position, in platform-specific units. |
-| top | Number \| String | Window's top position, in platform-specific units. |
-| transition | Number | Transition style of this non-modal window. |
-| width | Number \| String | Window's width, in platform-specific units. |
-| activityEnterAnimation | Number | Animation resource to run on the activity being opened. |
-| activityExitAnimation | Number | Animation resource to run on the activity that is being put in background as a … |
-
-*Plus 1 more types: *
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | Determines whether to use an animated effect when the window is shown. |
+| bottom | Number \| String | both | Window's bottom position, in platform-specific units. |
+| fullscreen | Boolean | both | Determines if the window is fullscreen. |
+| height | Number \| String | both | Window's height, in platform-specific units. |
+| left | Number \| String | both | Window's left position, in platform-specific units. |
+| modal | Boolean | both | Determines whether to open the window modal in front of other windows. |
+| forceModal | Boolean | ios | Indicates whether the window enforces modal behaviour. |
+| modalStyle | Number | ios | Presentation style of this modal window. |
+| modalTransitionStyle | Number | ios | Transition style of this modal window. |
+| navBarHidden | Boolean | both | For modal windows, hides the nav bar (`true`) or shows the nav bar (`false`). |
+| right | Number \| String | both | Window's right position, in platform-specific units. |
+| top | Number \| String | both | Window's top position, in platform-specific units. |
+| transition | Number | ios | Transition style of this non-modal window. |
+| width | Number \| String | both | Window's width, in platform-specific units. |
+| activityEnterAnimation | Number | android | Animation resource to run on the activity being opened. |
+| activityExitAnimation | Number | android | Animation resource to run on the activity that is being put in background as a … |
+
+Also referenced by this API, documented elsewhere: `Dictionary`, [Font](api-ui-lists.md#font), [shadowDict](#shadowdict), [titleAttributesParams](#titleattributesparams).
 
 ---
 

package/skills/ti-guides/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ti-guides
-description: 'Use when working on Titanium SDK fundamentals: project configuration (`tiapp.xml`, `timodule.xml`), CommonJS modules, Hyperloop native access, app distribution (App Store / Google Play, certificates, provisioning), Titanium CLI usage, memory management, bridge optimization, SQLite transactions, image memory, or coding standards. Triggers include `tiapp.xml` in the project root, for either Alloy (`app/`) or Classic (`Resources/`) Titanium projects.'
+description: 'Use when working on Titanium SDK fundamentals: project configuration (`tiapp.xml`, `timodule.xml`), CommonJS modules, Hyperloop native access, app distribution (App Store / Google Play, certificates, provisioning), Titanium CLI usage, memory management, bridge optimization, SQLite transactions, image memory, coding standards, the compatibility matrix (which JDK, Node.js, Xcode or Android SDK a given Titanium SDK needs), or what changed in a Titanium SDK release. Triggers include `tiapp.xml` in the project root, for either Alloy (`app/`) or Classic (`Resources/`) Titanium projects.'
 ---
 
 # ti-guides
@@ -19,6 +19,8 @@ Use this skill when:
 - Using Hyperloop to call native APIs (Objective-C / Swift / Java)
 - Optimizing memory: removing global listeners, caching native properties, image memory footprints
 - Working with the Titanium CLI (`ti build`, `ti sdk install`, `ti sdk select`)
+- Checking which JDK, Node.js, Xcode or Android SDK a Titanium SDK version requires
+- Finding out what changed in a Titanium SDK release and whether it affects existing code
 - Writing CommonJS modules (stateful caching, ES6+ patterns, antipatterns)
 - Authoring `AndroidManifest.xml` overrides
 - Following TiDev style and naming conventions
@@ -47,6 +49,8 @@ Do NOT use for:
 | Google Play (APK / AAB), App Store (IPA), certificates, provisioning, deployment | [app-distribution.md](references/app-distribution.md) |
 | Complete `tiapp.xml` and `timodule.xml` reference | [tiapp-config.md](references/tiapp-config.md) |
 | Titanium CLI commands, options, tasks, configuration, build processes | [cli-reference.md](references/cli-reference.md) |
+| JDK, Node.js, Xcode and Android SDK versions each Titanium SDK supports | [compatibility-matrix.md](references/compatibility-matrix.md) |
+| What changed per 13.x release, and which changes affect your code | [sdk-release-notes.md](references/sdk-release-notes.md) |
 | Community support, modules, sample code, Slack, learning materials | [resources.md](references/resources.md) |
 
 ## Core practices

package/skills/ti-guides/references/compatibility-matrix.md

@@ -0,0 +1,89 @@
+# Compatibility matrix
+
+Which JDK, Node.js, Xcode and Android SDK versions a given Titanium SDK release can build with. Components outside the min/max ranges below are not compatible.
+
+Only the currently supported ranges are reproduced here. Upstream also keeps collapsed tables of long-unsupported ranges (back to Titanium 1.7); if a project is pinned to something older than the rows below, consult the upstream matrix directly.
+
+<!-- TOC-START -->
+## Contents
+
+- [1. Operating system](#1-operating-system)
+- [2. Java Development Kit](#2-java-development-kit)
+- [3. Node.js](#3-nodejs)
+- [4. Android](#4-android)
+- [5. iOS and Xcode](#5-ios-and-xcode)
+- [6. Which platform can build what](#6-which-platform-can-build-what)
+
+<!-- TOC-END -->
+
+## 1. Operating system
+
+| Operating system | Version |
+|---|---|
+| macOS | 10.11.5 and later |
+| Windows | Windows 7 and later (Android) |
+| Linux | Tested on Fedora and (K)Ubuntu; others should work |
+
+## 2. Java Development Kit
+
+The JDK is required to build Titanium apps and modules for Android. OpenJDK or Oracle both work.
+
+| Titanium SDK version | Min JDK | Max JDK |
+|---|---|---|
+| 13.3.0 - latest | 18 | 25 |
+| 12.8.0 - 13.2.0 | 18 | 21 |
+
+`12.0.0 - 12.7.0` (JDK 11-17) moved to the unsupported table when 13.3.0 shipped.
+
+## 3. Node.js
+
+Node.js is required to install and run the Titanium SDK. On Windows, enable `dev mode` in Windows settings for Node to work correctly.
+
+| Titanium SDK version | Min Node | Max Node |
+|---|---|---|
+| 13.1.1 - latest | 20.x | 24.x |
+| 13.0.0 - 13.1.0 | 20.x | 22.x |
+| 12.6.0 - 12.8.0 | 18.x | 22.x |
+
+## 4. Android
+
+As of Titanium 9.0.0 the build system downloads the needed Android SDK platforms and tools automatically. Upgrade those packages only between major projects — changes there have broken the Titanium toolchain several times.
+
+| Titanium SDK version | Min target (`android:targetSdkVersion`) | Max target | Min supported (`android:minSdkVersion`) |
+|---|---|---|---|
+| 13.1.0+ | 15.x (API 35) | 15.x (API 35) | 7.x (API 24) |
+| 12.8.0 - 13.0.1 | 15.x (API 35) | 15.x (API 35) | 5.x (API 21) |
+| 12.5.0 - 12.8.0 | 14.x (API 34) | 14.x (API 34) | 5.x (API 21) |
+| 12.0.0 - 12.5.0 | 13.x (API 33) | 13.x (API 33) | 5.x (API 21) |
+
+A `android:targetSDKVersion` set in `tiapp.xml` must fall inside the min/max target range of the SDK in use.
+
+> **Note:** Titanium SDK 13.4.0 is described in its release note as *preparing the SDK for Android target SDK 36*. The matrix above still lists API 35 as the maximum; treat API 36 as in-progress rather than as a supported target until the matrix says otherwise.
+
+Developing native Android add-on modules on macOS also requires the Xcode command line tools.
+
+## 5. iOS and Xcode
+
+Building for iOS requires macOS — Apple's license agreement allows iOS development only on Apple hardware.
+
+| Titanium SDK version | Min Xcode | Max Xcode | Notes |
+|---|---|---|---|
+| 12.6.3 - latest | 12.0.0 | 16.x | Full support for iOS 18.4 |
+| 12.2.0 - 12.6.2 | 12.0.0 | 16.2 | Full support for iOS 17 |
+| 10.1.0 - 12.1.2 | 11.0.0 | 13.x | Full support for iOS 15 |
+
+| Titanium SDK version | Min iOS SDK | Max iOS SDK | Min target iOS | Max target iOS |
+|---|---|---|---|---|
+| 12.2.0 - latest | 13.0.0 | 17.x | 12.0 | 17.x |
+| 10.1.0 - 12.1.2 | 13.0.0 | 15.x | 12.0 | 15.x |
+
+> **Note:** these two tables lag behind the release notes. Titanium SDK 13.3.0 shipped *support for Xcode 27 and iOS 27*, which no row above reflects. Where they disagree, the release note is the newer statement — see [sdk-release-notes.md](sdk-release-notes.md).
+
+## 6. Which platform can build what
+
+| Target | macOS | Windows | Linux |
+|---|---|---|---|
+| Android | Yes | Yes | Yes |
+| iOS | Yes | No | No |
+
+Anything marked *pre-release* upstream — Beta, Developer Preview, Release Candidate, and continuous builds — is not officially supported.

package/skills/ti-guides/references/resources.md

@@ -111,7 +111,13 @@ See `hyperloop-native-access.md` for native module development:
 
 ### IDE support
 
-- VS Code: https://code.visualstudio.com/ (with Titanium extensions)
+Titanium has no IDE of its own; the CLI is the common denominator and every editor below drives it.
+
+| Editor | Integration |
+|---|---|
+| Visual Studio Code | Titanium extension — https://code.visualstudio.com/ |
+| JetBrains IDEs | Community plugin — https://github.com/devloopsnet/titanium-jetbrains |
+| Atom | Titanium package (Atom itself is discontinued) |
 
 ### CLI tools
 

package/skills/ti-guides/references/sdk-release-notes.md

@@ -0,0 +1,75 @@
+# SDK release notes: what changes your code
+
+Condensed 13.x release history, filtered down to what actually affects how you write or configure an app. Full changelogs (every commit, every credit) live upstream under `Titanium_SDK_Release_Notes/`.
+
+Each GA release desupports the previous patch release. Running an unsupported version is allowed, but bug reports against it are not accepted.
+
+<!-- TOC-START -->
+## Contents
+
+- [1. Version timeline](#1-version-timeline)
+- [2. 13.4.0 — Android target SDK 36 groundwork](#2-1340--android-target-sdk-36-groundwork)
+- [3. 13.3.1 — patch](#3-1331--patch)
+- [4. 13.3.0 — Xcode 27, iOS 27, multi-scene](#4-1330--xcode-27-ios-27-multi-scene)
+- [5. 13.2.0 — ViewPager2, keepHardwareMode](#5-1320--viewpager2-keephardwaremode)
+- [6. Bundled module versions](#6-bundled-module-versions)
+
+<!-- TOC-END -->
+
+## 1. Version timeline
+
+| Version | Date | Headline |
+|---|---|---|
+| 13.4.0.GA | 28 July 2026 | Prepares the SDK for Android target SDK 36; v8 memory cleanup |
+| 13.3.1.GA | 20 July 2026 | Patch — iOS restart and LiveView fixes |
+| 13.3.0.GA | 01 July 2026 | Xcode 27 and iOS 27, Hyperloop 8.0.0, iOS multi-scene apps |
+| 13.2.0.GA | 08 April 2026 | iOS core changes, Node.js 24 support, Android fixes |
+| 13.1.0.GA | — | Minor release, high-priority fixes |
+| 13.0.0.GA | — | Major release: iOS 26 / Xcode 26, Android 16 KB page size |
+
+## 2. 13.4.0 — Android target SDK 36 groundwork
+
+- **Prepares the SDK for Android target SDK 36.** Groundwork only; the compatibility matrix still lists API 35 as the maximum target. See [compatibility-matrix.md](compatibility-matrix.md) § Android.
+- v8 memory cleanup (Android).
+- `Window.rect` now reflects pre-open `left`/`top` instead of reporting zeros before the window opens (Android).
+- Build paths adjusted for Windows hosts.
+- iOS: fixed the dimming area in a TableView SearchBar.
+- The debug-only selector for `Ti.App._restart()` was removed, making the method callable outside debug builds.
+
+## 3. 13.3.1 — patch
+
+iOS-only fixes: the `restart` method, and LiveView restart. Hyperloop bumped to 8.0.1.
+
+## 4. 13.3.0 — Xcode 27, iOS 27, multi-scene
+
+- **Xcode 27 and iOS 27 support.** This postdates the Xcode/iOS rows in the compatibility matrix, which still cap at Xcode 16.x.
+- **iOS multi-scene applications** are supported.
+- **Hyperloop 8.0.0.**
+- ScrollableView (Android): a deprecation note was added for its older events. As of SDK 13.4.0 no ScrollableView event is actually flagged deprecated in the API metadata — `scroll`, `scrollend` and `dragend` all remain current — so treat this as advance warning, not as a removal.
+- ImageView: pinch-and-zoom improved on Android; the remote-image fade-in animation was removed on iOS.
+- TabGroup (iOS): `focus` is now emitted separately from `selected`. Code that assumed one event covered both cases needs checking.
+- `borderWidth` no longer renders at double thickness when `borderRadius` is an array (iOS).
+- Android: Material 3 BottomNavigation theme and dark/light switching fixes, CameraX rotation fix under orientation lock, WebView fix for URLs carrying large GET data, `Ti.Preferences` optimized.
+
+## 5. 13.2.0 — ViewPager2, keepHardwareMode
+
+- **ScrollableView moved to ViewPager2 on Android.** A backing-widget swap; verify paging, nested scrolling and any custom paging control against it.
+- **`keepHardwareMode` added to `Ti.UI.View`** (Android) — controls the view's render mode.
+- **`hideKeyboardAccessoryView` added to WebView** (iOS) to hide the keyboard accessory bar.
+- **AttributedString support on Android**, previously iOS-only.
+- Images can be dragged horizontally inside a ScrollableView (Android).
+- ListView caches `searchText` (Android).
+- The app name in `AndroidManifest.xml` now uses the i18n value.
+- Node.js 24 support; core-js upgraded, removing the `baseline-browser-mapping` warning.
+- iOS: Mac Catalyst fixes for `Ti.UI.Button` styling and events, and module builds with `mac=true`.
+
+## 6. Bundled module versions
+
+Versions shipped with each SDK. Unchanged rows are omitted.
+
+| Module | 13.2.0 (Android / iOS) | 13.3.0+ (Android / iOS) |
+|---|---|---|
+| facebook | 14.0.0 / 15.0.0 | 15.0.0 / 16.0.0 |
+| hyperloop | 7.1.0 / 7.1.0 | 8.0.1 / 8.0.1 (8.0.0 in 13.3.0) |
+
+Stable across 13.2.0–13.4.0: `ti.map` 5.7.0 / 7.3.1, `ti.webdialog` 2.5.0 / 3.0.2, `ti.playservices` 18.6.0 (Android only), `ti.identity` 3.2.0 / 5.0.0, `urlSession` 4.0.1 (iOS only), `ti.coremotion` 4.0.1 (iOS only), `ti.applesignin` 3.1.2 (iOS only).

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

@@ -108,9 +108,15 @@ scrollableView.addEventListener('scroll', (e) => {
   Ti.API.info(`Views: ${e.view}`);  // View object reference
 });
 
-scrollableView.addEventListener('dragEnd', (e) => {
+// Android only, and lowercase: ScrollableView has no `dragEnd` event.
+scrollableView.addEventListener('dragend', (e) => {
   Ti.API.info(`Drag ended, settled on page: ${e.currentPage}`);
 });
+
+// Cross-platform equivalent — fires once the view stops moving.
+scrollableView.addEventListener('scrollend', (e) => {
+  Ti.API.info(`Settled on page: ${e.currentPage}`);
+});
 ```
 ...
 ### Image gallery