@maccesar/titools 4.4.2 → 4.5.0

package/README.md

@@ -178,7 +178,7 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 | purgetss     | Utility-first styling               | UI styling and animations               |
 | ti-ui        | UI/UX patterns                      | Complex layouts, ListViews, platform UI |
 | ti-api       | Complete Titanium API reference     | Looking up properties, methods, events  |
-| ti-guides    | SDK fundamentals                    | tiapp.xml, Hyperloop, distribution      |
+| ti-guides    | SDK fundamentals                    | tiapp.xml, Hyperloop, distribution, JDK/Xcode compatibility, release notes |
 | ti-howtos    | Native feature integration          | Location, push, media, platform APIs    |
 | alloy-guides | Alloy MVC framework reference       | Controllers, models, views, widgets     |
 | alloy-howtos | Alloy CLI, configuration, debugging | alloy.jmk, config.json, custom XML tags |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "4.4.2",
+  "version": "4.5.0",
   "description": "Titanium SDK skills and agents for AI coding assistants (Claude Code, Gemini CLI, Codex CLI)",
   "main": "lib/index.js",
   "type": "module",

package/skills/ti-api/references/api-media.md

@@ -160,75 +160,227 @@ The Media module is used to access the device's media-related functionality, suc
 
 ### Related Types
 
+> **Warning:** `success` receives a different shape depending on `allowMultiple`. With a single selection it is a `CameraMediaItemType` and the blob is on `e.media`. With `allowMultiple: true` it is a `CameraMediaMultipleItemsType` and there is no `e.media` at all — the blobs live under `e.images`, `e.videos` and `e.livePhotos`, each entry itself a `CameraMediaItemType`.
+
+#### CameraMediaItemType
+> A media object from the camera or photo gallery.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | both | Indicates if the operation succeeded. Returns `true`. |
+| error | String | both | Error message, if any returned. |
+| code | Number | both | Error code. Returns 0. |
+| media | Ti.Blob | both | The media object, as a [Blob](Titanium.Blob). |
+| path | String | android | The path of the image when returning data from the gallery. |
+| mediaType | String | both | The type of media, either `MEDIA_TYPE_PHOTO`, `MEDIA_TYPE_LIVEPHOTO` or `MEDIA_… |
+| cropRect | Dimension | both | Simple object defining the user's selected crop rectangle, or `null` if the use… |
+| previewRect | Size | android | Simple object defining the preview image size. This will be undefined when cust… |
+| livePhoto | Ti.UI.iOS.LivePhoto | both | The live photo object, as a <Titanium.UI.iOS.LivePhoto> and `undefined` if no l… |
+
+#### CameraMediaMultipleItemsType
+> A media object from photo gallery when <Titanium.Media.allowMultiple> is `true`.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | both | Indicates if the operation succeeded. Returns `true`. |
+| error | String | both | Error message, if any returned. |
+| code | Number | both | Error code. Returns 0. |
+| images | Array<CameraMediaItemType> | both | The list of selected images. |
+| livePhotos | Array<Titanium.UI.iOS.LivePhoto> | ios | The list of selected live photo objects. |
+| videos | Array<CameraMediaItemType> | both | The list of selected videos. |
+
+#### CameraOpen
+> Parameters of the open callback
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| width | Number | android | Width of the preview camera image |
+| height | Number | android | Height of the preview camera image |
+
 #### CameraOptionsType
 > Simple object for specifying options to [showCamera](Titanium.Media.showCamera).
 
-| Property | Type | Description |
-|----------|------|-------------|
-| success | Callback<CameraMediaItemType> | Function to call when the camera is closed after a successful capture/selection. |
-| open | Callback<CameraOpen> | Function to call when the camera is shown |
-| error | Callback<FailureResponse> | Function to call upon receiving an error. |
-| cancel | Callback<FailureResponse> | Function to call if the user presses the cancel button. |
-| recording | Callback<CameraRecordingCallback> | Function to call during recording. Returns size and duration. |
-| androidback | Callback<FailureResponse> | Function to call if the user presses the back button. |
-| autohide | Boolean | Specifies if the camera should be hidden automatically after the media capture … |
-| animated | Boolean | Specifies if the dialog should be animated upon showing and hiding. |
-| saveToPhotoGallery | Boolean | Specifies if the media should be saved to the photo gallery upon successful cap… |
-| allowEditing | Boolean | Specifies if the media should be editable after capture/selection. |
-| zoomEnabled | Boolean | Specifies if pinch to zoom is enabled or not. |
-| targetImageWidth | Number | Maximum width of the saved image. Depending on your phone and your value this m… |
-| targetImageHeight | Number | Maximum height of the saved image. Depending on your phone and your value this … |
-| mediaTypes | Array<String> | Array of media type constants to allow. Note: If you want to select live photos… |
-| videoMaximumDuration | Number | Maximum duration (in milliseconds) to allow video capture before completing. |
-| videoQuality | Number | Constant to indicate the video quality during capture. |
-| whichCamera | Number | Opens the camera with the specified camera direction. |
-| showControls | Boolean | Indicates if the built-in camera controls should be displayed. |
-| overlay | Ti.UI.View | View to added as an overlay to the camera UI (on top). |
-| transform | Ti.UI.Matrix2D | Transformation matrix to apply to the camera or photogallery view. |
-| inPopOver | Boolean | Show the camera in a popover. |
-| popoverView | Ti.UI.View | View to position the camera or photo gallery popover on top of. |
-| arrowDirection | Number | Controls the type of arrow and position of the popover. |
-| autorotate | Boolean | Determines if the camera preview should rotate or not. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Callback<CameraMediaItemType> | both | Function to call when the camera is closed after a successful capture/selection. |
+| open | Callback<CameraOpen> | android | Function to call when the camera is shown |
+| error | Callback<FailureResponse> | both | Function to call upon receiving an error. |
+| cancel | Callback<FailureResponse> | both | Function to call if the user presses the cancel button. |
+| recording | Callback<CameraRecordingCallback> | android | Function to call during recording. Returns size and duration. |
+| androidback | Callback<FailureResponse> | android | Function to call if the user presses the back button. |
+| autohide | Boolean | both | Specifies if the camera should be hidden automatically after the media capture … |
+| animated | Boolean | ios | Specifies if the dialog should be animated upon showing and hiding. |
+| saveToPhotoGallery | Boolean | both | Specifies if the media should be saved to the photo gallery upon successful cap… |
+| allowEditing | Boolean | ios | Specifies if the media should be editable after capture/selection. |
+| zoomEnabled | Boolean | android | Specifies if pinch to zoom is enabled or not. |
+| targetImageWidth | Number | android | Maximum width of the saved image. Depending on your phone and your value this m… |
+| targetImageHeight | Number | android | Maximum height of the saved image. Depending on your phone and your value this … |
+| mediaTypes | Array<String> | both | Array of media type constants to allow. Note: If you want to select live photos… |
+| videoMaximumDuration | Number | both | Maximum duration (in milliseconds) to allow video capture before completing. |
+| videoQuality | Number | both | Constant to indicate the video quality during capture. |
+| whichCamera | Number | android | Opens the camera with the specified camera direction. |
+| showControls | Boolean | ios | Indicates if the built-in camera controls should be displayed. |
+| overlay | Ti.UI.View | both | View to added as an overlay to the camera UI (on top). |
+| transform | Ti.UI.Matrix2D | ios | Transformation matrix to apply to the camera or photogallery view. |
+| inPopOver | Boolean | ios | Show the camera in a popover. |
+| popoverView | Ti.UI.View | ios | View to position the camera or photo gallery popover on top of. |
+| arrowDirection | Number | ios | Controls the type of arrow and position of the popover. |
+| autorotate | Boolean | ios | Determines if the camera preview should rotate or not. |
+
+#### CameraRecordingCallback
+> Infos about the current video recording
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| duration | Number | both | Length in milliseconds |
+| size | Number | both | Size of the video in bytes |
+
+#### FailureResponse
+> Properties used in any event or callback which needs to report a failure.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | both | Indicates if the operation succeeded. Returns `false`. |
+| error | String | both | Error message, if any returned. |
+| code | Number | both | Error code. Returns a non-zero value. |
+
+#### MediaAuthorizationResponse
+> Argument passed to the callback when a request finishes successfully or erroneously.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | both | Indicates if the operation succeeded. |
+| error | String | both | Error message, if any returned. |
+| code | Number | both | Error code. Returns 0 if `success` is `true`. |
+
+#### MediaQueryInfoType
+> A full query descriptor for a filtering predicate.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| value | Number \| String \| Boolean | ios | The value for the given predicate. See the descriptions in <MediaQueryType> for… |
+| exact | Boolean | ios | Whether or not the predicate is for an exact match. The default is `true`. |
 
 #### MediaQueryType
 > A specifier for a media library query. By default, filters perform an exact match.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| grouping | Number | A constant that specifies the ordering of the result array. |
-| mediaType | MediaQueryInfoType \| Number | The media type to filter on. |
-| title | MediaQueryInfoType \| String | The title to filter on. Value should be a String. |
-| albumTitle | MediaQueryInfoType \| String | The album title to filter on. Value should be a String. |
-| artist | MediaQueryInfoType \| String | The artist to filter on. Value should be a String. |
-| albumArtist | MediaQueryInfoType \| String | The album artist to filter on. Value should be a String. |
-| genre | MediaQueryInfoType \| String | The genre to filter on. Value should be a String. |
-| composer | MediaQueryInfoType \| String | The composer to filter on. Value should be a String. |
-| isCompilation | MediaQueryInfoType \| Boolean | Filter by whether or not the item is a compilation. The value should be a Boole… |
-| playCount | MediaQueryInfoType \| Number | The play count to filter on. Value should be a Number. |
-| persistentID | MediaQueryInfoType \| Number | The persistent ID to filter on. Value should be a Number. |
-| albumPersistentID | MediaQueryInfoType \| Number | The album persistent ID to filter on. Value should be a Number. |
-| albumArtistPersistentID | MediaQueryInfoType \| Number | The album artist persistent ID to filter on. Value should be a Number. |
-| genrePersistentID | MediaQueryInfoType \| Number | The genre persistent ID to filter on. Value should be a Number. |
-| composerPersistentID | MediaQueryInfoType \| Number | The composer persistent ID to filter on. Value should be a Number. |
-| isCloudItem | MediaQueryInfoType \| Boolean | Filter by whether or not the item is a cloud item. Value should be a Boolean. |
-| hasProtectedAsset | MediaQueryInfoType \| Boolean | Filter by whether or not the item is a protected asset. Value should be a Boole… |
-| podcastTitle | MediaQueryInfoType \| String | The podcast title to filter on. Value should be a String. |
-| podcastPersistentID | MediaQueryInfoType \| Number | The podcast persistent ID to filter on. Value should be a Number. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| grouping | Number | ios | A constant that specifies the ordering of the result array. |
+| mediaType | MediaQueryInfoType \| Number | ios | The media type to filter on. |
+| title | MediaQueryInfoType \| String | ios | The title to filter on. Value should be a String. |
+| albumTitle | MediaQueryInfoType \| String | ios | The album title to filter on. Value should be a String. |
+| artist | MediaQueryInfoType \| String | ios | The artist to filter on. Value should be a String. |
+| albumArtist | MediaQueryInfoType \| String | ios | The album artist to filter on. Value should be a String. |
+| genre | MediaQueryInfoType \| String | ios | The genre to filter on. Value should be a String. |
+| composer | MediaQueryInfoType \| String | ios | The composer to filter on. Value should be a String. |
+| isCompilation | MediaQueryInfoType \| Boolean | ios | Filter by whether or not the item is a compilation. The value should be a Boole… |
+| playCount | MediaQueryInfoType \| Number | ios | The play count to filter on. Value should be a Number. |
+| persistentID | MediaQueryInfoType \| Number | ios | The persistent ID to filter on. Value should be a Number. |
+| albumPersistentID | MediaQueryInfoType \| Number | ios | The album persistent ID to filter on. Value should be a Number. |
+| albumArtistPersistentID | MediaQueryInfoType \| Number | ios | The album artist persistent ID to filter on. Value should be a Number. |
+| genrePersistentID | MediaQueryInfoType \| Number | ios | The genre persistent ID to filter on. Value should be a Number. |
+| composerPersistentID | MediaQueryInfoType \| Number | ios | The composer persistent ID to filter on. Value should be a Number. |
+| isCloudItem | MediaQueryInfoType \| Boolean | ios | Filter by whether or not the item is a cloud item. Value should be a Boolean. |
+| hasProtectedAsset | MediaQueryInfoType \| Boolean | ios | Filter by whether or not the item is a protected asset. Value should be a Boole… |
+| podcastTitle | MediaQueryInfoType \| String | ios | The podcast title to filter on. Value should be a String. |
+| podcastPersistentID | MediaQueryInfoType \| Number | ios | The podcast persistent ID to filter on. Value should be a Number. |
 
 #### MusicLibraryOptionsType
 > Simple object for specifying options to [openMusicLibrary](Titanium.Media.openMusicLibrary).
 
-| Property | Type | Description |
-|----------|------|-------------|
-| success | Callback<MusicLibraryResponseType> | Function to call when the music library selection is made. |
-| error | Callback<FailureResponse> | Function to call upon receiving an error. |
-| cancel | Callback<FailureResponse> | Function to call if the user presses the cancel button. |
-| autohide | Boolean | Specifies that the library should be hidden automatically after media selection… |
-| animated | Boolean | Boolean if the dialog should be animated when showing and hiding. |
-| mediaTypes | Number \| Array<Number> | An array of media type constants defining selectable media. |
-| allowMultipleSelections | Boolean | Set to `true` to allow the user to select multiple items from the library. |
-
-*Plus 2 more types: *
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Callback<MusicLibraryResponseType> | ios | Function to call when the music library selection is made. |
+| error | Callback<FailureResponse> | ios | Function to call upon receiving an error. |
+| cancel | Callback<FailureResponse> | ios | Function to call if the user presses the cancel button. |
+| autohide | Boolean | ios | Specifies that the library should be hidden automatically after media selection… |
+| animated | Boolean | ios | Boolean if the dialog should be animated when showing and hiding. |
+| mediaTypes | Number \| Array<Number> | ios | An array of media type constants defining selectable media. |
+| allowMultipleSelections | Boolean | ios | Set to `true` to allow the user to select multiple items from the library. |
+
+#### MusicLibraryResponseType
+> Simple object passed to the [openMusicLibrary](Titanium.Media.openMusicLibrary) `success` callback function.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| representative | Ti.Media.Item | both | A single representative of the selected items. |
+| items | Array<Titanium.Media.Item> | both | A list of all the items chosen by the user. |
+| types | Number | both | Media types in this collection, represented as the bitwise OR of the media type… |
+
+#### PhotoGalleryOptionsType
+> Simple object for specifying options to [openPhotoGallery](Titanium.Media.openPhotoGallery).
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Callback<CameraMediaItemType> \| Callback<CameraMediaMultipleItemsType> | both | Function to call when the photo gallery is closed after a successful selection. |
+| error | Callback<FailureResponse> | both | Function to call upon receiving an error. |
+| cancel | Callback<FailureResponse> | both | Function to call if the user presses the cancel button. |
+| autohide | Boolean | ios | Specifies if the photo gallery should be hidden automatically after the media s… |
+| animated | Boolean | ios | Specifies if the dialog should be animated upon showing and hiding. |
+| allowEditing | Boolean | ios | Specifies if the media should be editable after capture/selection. |
+| mediaTypes | Array<String> | both | Array of media type constants to allow. Live photos is only supported on the iO… |
+| popoverView | Ti.UI.View | ios | View to position the photo gallery popover on top of. |
+| arrowDirection | Number | ios | Controls the type of arrow and position of the popover. |
+| allowMultiple | Boolean | both | Specifies if the user should be able to select multiple photos. |
+| maxImages | Boolean | android | Specifies the number of images a user can select at maximum. |
+| pathOnly | Boolean | android | Do not include the blob in the result |
+| selectionLimit | Boolean | ios | Specifies number of media item that can be selected. |
+| allowTranscoding | Boolean | ios | Specifies if the video should be transcoded (using highest quality preset) . If… |
+
+#### PreviewImageError
+> The parameter passed to the `error` callback of <PreviewImageOptions>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | android | Indicates if the operation succeeded. Returns `false`. |
+| error | String | android | Error message, if any returned. |
+| code | Number | android | Error code, if applicable. |
+| message | String | android | Description of the error. |
+
+#### PreviewImageOptions
+> Options passed to <Titanium.Media.previewImage>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| image | Ti.Blob | android | The image to preview. Must be a blob based on a file, such as from <Titanium.Fi… |
+| success | Callback<SuccessResponse> | android | Function to be called back if the preview succeeds. No info is passed. |
+| error | Callback<PreviewImageError> | android | Function called back if the preview fails. Check the `message` property of pass… |
+
+#### RouteDescription
+> An Object describing the current audio route.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| inputs | Array<String> | ios | An Array of current input ports for the session. See the `AUDIO_SESSION_PORT` c… |
+| outputs | Array<String> | ios | An Array of current output ports for the session. See the `AUDIO_SESSION_PORT` … |
+
+#### ScreenshotResult
+> The parameter passed to the <Titanium.Media.takeScreenshot> callback.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| media | Ti.Blob | both | The screenshot image. |
+
+#### SuccessResponse
+> Properties used in any event or callback which needs to report a success.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | both | Indicates if the operation succeeded. Returns `true`. |
+| error | String | both | Error message, if any returned. |
+| code | Number | both | Error code. Returns 0. |
+
+#### RequestCameraAccessResult
+> Same shape as [MediaAuthorizationResponse](#mediaauthorizationresponse): `success`, `error`, `code`.
+
+#### RequestMusicLibraryAccessResult
+> Same shape as [MediaAuthorizationResponse](#mediaauthorizationresponse): `success`, `error`, `code`.
+
+#### RequestPhotoGalleryAccessResult
+> Same shape as [MediaAuthorizationResponse](#mediaauthorizationresponse): `success`, `error`, `code`.
+
+Also referenced by this API, documented elsewhere: `Dictionary`.
 
 ---
 

package/skills/ti-api/references/api-modules-map.md

@@ -597,32 +597,42 @@ In Alloy, use the **`<Module>`** element with the `module` attribute set to `ti.
 #### CameraAnimationParams
 > Simple object used to control camera animations.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| camera | Modules.Map.Annotation | <Modules.Map.Camera> to be animated to. |
-| duration | Number | The amount of time (in milliseconds) that the animation will last. |
-| curve | Number | Animation curve or easing function to apply to the animation. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| camera | Modules.Map.Annotation | both | <Modules.Map.Camera> to be animated to. |
+| duration | Number | both | The amount of time (in milliseconds) that the animation will last. |
+| curve | Number | both | Animation curve or easing function to apply to the animation. |
 
 #### ClusterAnnotationParams
 > Simple object used to create cluster annotation view.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| memberAnnotations | Array<Modules.Map.Annotation> | Array of Modules.Map.Annotation, which is recieved in event 'clusteringstarted'… |
-| annotation | Modules.Map.Annotation | <Modules.Map.Annotation> instance, which you want to show as clustered annotati… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| memberAnnotations | Array<Modules.Map.Annotation> | ios | Array of Modules.Map.Annotation, which is received in event 'clusteringstarted'… |
+| annotation | Modules.Map.Annotation | ios | <Modules.Map.Annotation> instance, which you want to show as clustered annotati… |
 
 #### MapLocationTypeV2
 > Simple object used as an argument to [setLocation](Modules.Map.View.setLocation).
 
-| Property | Type | Description |
-|----------|------|-------------|
-| longitude | Number | Longitude value for the center point of the map, in decimal degrees. |
-| latitude | Number | Latitude value for the center point of the map, in decimal degrees. |
-| longitudeDelta | Number | The amount of east-to-west distance displayed on the map, measured in decimal d… |
-| latitudeDelta | Number | The amount of north-to-south distance displayed on the map, measured in decimal… |
-| animate | Boolean | Set to `true` to animate the move to the new location. |
-
-*Plus 3 more types: MapViewPadding*
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| longitude | Number | both | Longitude value for the center point of the map, in decimal degrees. |
+| latitude | Number | both | Latitude value for the center point of the map, in decimal degrees. |
+| longitudeDelta | Number | both | The amount of east-to-west distance displayed on the map, measured in decimal d… |
+| latitudeDelta | Number | both | The amount of north-to-south distance displayed on the map, measured in decimal… |
+| animate | Boolean | both | Set to `true` to animate the move to the new location. |
+
+#### MapViewPadding
+> The padding applied to the map view using <Modules.Map.View.padding>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| top | Number | both | Top padding of the map view. |
+| left | Number | both | Left padding of the map view. |
+| bottom | Number | both | Bottom padding of the map view. |
+| right | Number | both | Right padding of the map view. |
+
+Also referenced by this API, documented elsewhere: [MapPointType](#mappointtype), [MapRegionTypev2](#mapregiontypev2).
 
 ---
 

package/skills/ti-api/references/api-modules-social-misc.md

@@ -206,17 +206,20 @@
 > Platforms: both
 > Type: module
 
-### Properties (unique: 10/50)
+### Properties (unique: 14/50)
 | Property | Type | Platform | Description |
 |----------|------|----------|-------------|
 | accessToken | String | both | OAuth token set after a successful `authorize`. |
 | accessTokenExpired | Boolean | both | Returns whether the <Modules.Facebook.accessToken… |
 | accessTokenActive | Boolean | both | Returns `true` if the <Modules.Facebook.accessTok… |
+| advertiserTrackingEnabled | Boolean | ios | Gets or sets the SDK's advertiser-tracking flag. |
 | appID | String | both | If not explicitly set, the default will be read f… |
+| authenticationToken | String | android | Returns the raw Authentication Token (JWT) from the most recent Limited Login, … |
 | canPresentOpenGraphActionDialog | Boolean | android | Checks if the device can support the use of the F… |
 | expirationDate | Date | both | Time at which the `accessToken` expires. |
 | loggedIn | Boolean | both | Indicates if the user is logged in. |
-| loginTracking | Number | ios | Gets or sets the desired tracking preference to u… |
+| loginTracking | Number | both | Gets or sets the desired tracking preference to use for login attempts. |
+| nonce | String | android | Optional nonce used by Limited Login (`LOGIN_TRACKING_LIMITED`) to bind the iss… |
 | permissions | Array<String> | both | Array of permissions to request for your app. |
 | uid | String | both | Unique user ID returned from Facebook. |
 
@@ -272,13 +275,30 @@
 ### Events (6)
 | Event | Platform | Description |
 |-------|----------|-------------|
-| login | both | Fired at session login. |
+| login | both | Fired at session login. Payload: `success`, `cancelled`, `error`, `code`, `uid`, `data`, `authenticationToken`. |
 | logout | both | Fired at session logout. |
 | requestDialogCompleted | both | Fired when the Send Request dialog is closed. |
 | shareCompleted | both | Fired when the Share dialog or Web Share dialog is closed. |
 | inviteCompleted | both | Fired when the Invite dialog is closed. |
 | tokenUpdated | both | Fired when [refreshPermissionsFromServer](Modules.Facebook.refreshPermissionsFr… |
 
+### Login Tracking and Limited Login
+
+`loginTracking` and the `LOGIN_TRACKING_ENABLED` (default) / `LOGIN_TRACKING_LIMITED` constants are supported on **both** platforms. With `LOGIN_TRACKING_LIMITED`, `authorize()` (or `requestNewReadPermissions()`) starts Facebook's OIDC-based Limited Login flow: the SDK returns an Authentication Token (a JWT) instead of a classic Graph access token, delivered as `event.authenticationToken.tokenString` on the `login` event. Verify that JWT's signature server-side against Facebook's JWKS.
+
+> **Warning:** `Modules.Facebook.LoginButton` honors `loginTracking` on iOS only. The Android FB SDK's button exposes no Limited Login configuration, so on Android you must trigger Limited Login through `Modules.Facebook.authorize()` rather than through the button.
+
+### Related Types
+
+#### LimitedLoginAuthenticationToken
+> Shape of `event.authenticationToken` on the [login](Modules.Facebook.login) event when Limited Login (`LOGIN_TRACKING_LIMITED`) is used.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| tokenString | String | both | The signed JWT (header.payload.signature) issued by Facebook. Verify on your ba… |
+| nonce | String | both | The nonce echoed back by Facebook. Matches the [nonce](Modules.Facebook.nonce) … |
+| graphDomain | String | both | Optional graph domain hint returned by the iOS SDK (e.g. `gaming`). `undefined`… |
+
 ---
 
 ## Modules.Facebook.LoginButton

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