@maccesar/titools 4.4.2 → 4.6.1

package/skills/purgetss/references/migration-guide.md

@@ -1,6 +1,6 @@
 # Migration Guide
 
-This guide mirrors the official PurgeTSS changelog (see the project `README.md` / `docs/index.md`). It walks through the upgrade-relevant changes from v7.2.6 through v7.11.x, flags breaking changes, and links each section to the reference files that cover the new surface area in depth.
+This guide mirrors the official PurgeTSS changelog (see the project `README.md` / `docs/index.md`). It walks through the upgrade-relevant changes from v7.2.6 through v7.13.x, flags breaking changes, and links each section to the reference files that cover the new surface area in depth.
 
 Changelog source of truth: [https://github.com/macCesar/purgeTSS](https://github.com/macCesar/purgeTSS).
 
@@ -9,6 +9,8 @@ Changelog source of truth: [https://github.com/macCesar/purgeTSS](https://github
 <!-- TOC-START -->
 ## Contents
 
+- [Upgrade to v7.13.x](#upgrade-to-v713x)
+- [Upgrade to v7.12.x](#upgrade-to-v712x)
 - [Upgrade to v7.11.x](#upgrade-to-v711x)
 - [Upgrade to v7.10.x](#upgrade-to-v710x)
 - [Upgrade to v7.9.0](#upgrade-to-v790)
@@ -26,6 +28,87 @@ Changelog source of truth: [https://github.com/macCesar/purgeTSS](https://github
 
 <!-- TOC-END -->
 
+## Upgrade to v7.13.x
+
+**This is the one release in the 7.x line with breaking changes.** They are confined to `purgetss brand`: its flags, the names of the files in `purgetss/brand/`, and the shape of the `brand:` config block. Nothing outside branding is affected — utility classes, `apply:`, `theme`, `images` and the SVG pipeline are untouched. Full release notes in [`version-history.md`](./version-history.md).
+
+### Breaking — `brand` flags renamed, no aliases kept
+
+| Before v7.13.0 | v7.13.0 |
+| --- | --- |
+| `--splash` | `--splash-icon` |
+| `--notification` | `--notification-icon` |
+| `--splash-logo <path>` | `--splash-icon-logo <path>` |
+| `--feature-logo <path>` | `--feature-graphic-logo <path>` |
+| `--icon-logo <path>` (Android launcher) | `--adaptive-logo <path>` — `--icon-logo` now feeds `DefaultIcon.png` |
+| `--legacy-splash` | removed; the 11 `res-*` splashes are part of `android-splash` and always generated |
+
+The rule is now `--<piece>-logo` with no exceptions, which also filled in six flags that never existed (`--ios-splash-logo`, `--marketplace-logo`, `--legacy-icon-logo`, `--appicon-logo`, `--android-splash-logo`, `--notification-icon-logo`).
+
+### Breaking — logo filenames in `purgetss/brand/`
+
+Basenames follow `logo-<piece>`, again with no exceptions:
+
+| Before v7.13.0 | v7.13.0 |
+| --- | --- |
+| `logo-icon.*` (Android launcher mark) | `logo-adaptive.*` — `logo-icon.*` now feeds `DefaultIcon.png` |
+| `logo-splash.*` | `logo-splash-icon.*` |
+| `logo-feature.*` | `logo-feature-graphic.*` |
+
+`logo-icon.svg` is the trap here: the name survived but changed meaning. A project that used it as the Android launcher mark will now get that artwork on `DefaultIcon.png` instead, and the launcher icons will fall back to the main logo.
+
+### Not breaking — the `brand:` config block rewrites itself
+
+The config moved from purpose-based groups (`logos`, `padding`, `android`, `ios`, `colors`) to **one block per piece**, but you do not migrate it by hand. On the next run PurgeTSS rewrites `config.cjs` in place, carries over every value that had been customized, and prints each one it moved:
+
+```text
+::PurgeTSS:: Updated the brand: structure in ./purgetss/config.cjs.
+  Your values were carried over:
+    • brand.logos.androidLauncher → brand.adaptive.logo
+    • brand.padding.androidAdaptive → brand.adaptive.padding
+    • brand.android.splash → brand.splashIcon.enabled
+    • brand.colors.background → brand.background
+```
+
+Both earlier shapes are recognized — the pre-7.7.0 flat keys and the v7.7.0 groups. This happens on `purgetss brand` and on any command that goes through the config (`build`, `watch`, `purge`, `shades`). One key is dropped rather than moved: `brand.android.legacySplash`.
+
+A **typo** is not treated as an old structure — it aborts the run before a single file is written, listing the valid keys. See [`app-branding.md` → Older configs update themselves](./app-branding.md#older-configs-update-themselves).
+
+### Added in v7.13.0
+
+- **`brand` covers every image the Titanium template ships.** A fresh Alloy project used to keep 28 files wearing the grey Alloy logo: the 16 `assets/iphone/Default*.png`, the 11 `res-*/default.png`, and `assets/android/appicon.png`.
+- **`--only <pieces>`** — narrow a run to pieces or groups (`ios`, `store`, `android`). Honored by `--dry-run`.
+- **`LaunchLogo.png`** — drop `purgetss/brand/logo-launch.{svg,png}` and the iOS launch screen shows your logotype instead of the app icon. Written at exactly 1024×1024.
+- **`brand.optimize` / `--optimize`** — palette-quantize the generated PNGs. Off by default (lossy); ~71% smaller on the reference set.
+- **Padding defaults changed:** adaptive `19%` → `18%`. The 28 splash images now share one configurable rule at `26%`, measured against the canvas's shorter side.
+
+### Fixed in v7.13.0
+
+- `shades` and `semantic` no longer strip every comment from `config.cjs` — they rewrite only the `theme:` section.
+
+### What to review
+
+- **Grep your build scripts, `alloy.jmk`, CI jobs and npm scripts for the old flags.** They fail loudly rather than silently, but they do fail.
+- **Rename any `logo-icon.*` you were using as the Android launcher mark to `logo-adaptive.*`** before the next run, or the launcher icons will silently fall back to the main logo.
+- Let the config rewrite itself, then read the diff — it is the record of what you had customized.
+- If you had pinned `--android-adaptive-padding 19` only to match the old default, you can drop the flag; `18%` is the default now.
+
+---
+
+## Upgrade to v7.12.x
+
+v7.12.0 and v7.12.1 are additive — **no breaking changes**. Both releases improve what `purgetss brand --notes` prints; neither changes a generated asset. Full release notes in [`version-history.md`](./version-history.md).
+
+- **Android launch background snippets in `--notes` (v7.12.0).** The notes covered the iOS launch image and the Android launcher icon but never the color Android draws before Titanium creates the first Window, so a run that set a brand background still flashed the default theme color at launch.
+- **`--notes` targets the launcher Activity (v7.12.1).** Titanium applies `Theme.Titanium` directly to the generated launcher Activity, so splash items added only to the `<application>` theme could still be superseded. The notes now print a complete `splashscreen.xml` and a launcher-only `Theme.SplashScreen`. See [`launch-background.md`](./launch-background.md).
+- **Font Awesome Free updated to 7.3.1 (v7.12.1)** — 23 new icon classes, none removed. Run `purgetss icon-library -v=fa` to refresh the font files in an existing project.
+
+### What to review
+
+- If you followed an earlier `--notes` output and put the splash items on the `<application>` theme, re-run `purgetss brand --notes` and move them to a launcher-only theme.
+
+---
+
 ## Upgrade to v7.11.x
 
 v7.11.0 and v7.11.1 are additive — **no breaking changes**. The headline addition is a compile-time SVG image pipeline that runs automatically as a post-step of `purgetss`, plus a `config.cjs` syntax validator. Nothing new is required on upgrade; the new surface is opt-in. Full release notes in [`version-history.md`](./version-history.md).
@@ -79,12 +162,12 @@ Type mismatches in known config fields now print a formatted `Config Syntax Erro
 
 ## Upgrade to v7.10.x
 
-v7.10.0 through v7.10.2 are additive — **no breaking changes**. The notable shift is internal: configs written before v7.7.0 (the `brand:` regroup) now auto-migrate in memory on every run, so projects that never updated to the grouped `brand:` schema keep working without a `TypeError` crash. Full release notes in [`version-history.md`](./version-history.md).
+v7.10.0 through v7.10.2 are additive — **no breaking changes**. The notable shift is internal: configs written before v7.7.0 (the `brand:` regroup) auto-migrate in memory on every run, so projects that never updated to the grouped `brand:` schema keep working without a `TypeError` crash. (v7.13.0 later replaced this with a one-time rewrite on disk.) Full release notes in [`version-history.md`](./version-history.md).
 
 ### Added in v7.10.0
 
 - **`purgetss images --opacity / --padding / --output`** — three CLI-only flags aimed at placeholder / default ImageView workflows. `--opacity` multiplies alpha; `--padding` shrinks the rendered image inside each density canvas; `--output` retargets the basename and subpath. See [`multi-density-images.md`](./multi-density-images.md).
-- **Google Play Feature Graphic in `brand`** — `purgetss brand` now generates `MarketplaceArtworkFeature.png` (1024×500). Auto-discovers `purgetss/brand/logo-feature.{svg,png}` or reuses the master logo. Tune with `--feature-graphic-padding <n>` (range `0-40`, default `12%`), `brand.padding.featureGraphic`, or `--feature-logo <path>`. See [`app-branding.md`](./app-branding.md).
+- **Google Play Feature Graphic in `brand`** — `purgetss brand` now generates `MarketplaceArtworkFeature.png` (1024×500). Auto-discovers `purgetss/brand/logo-feature.{svg,png}` or reuses the master logo. Tune with `--feature-graphic-padding <n>` (range `0-40`, default `12%`), `brand.padding.featureGraphic`, or `--feature-logo <path>`. **Renamed in v7.13.0** to `--feature-graphic-logo` / `brand.featureGraphic.padding`. See [`app-branding.md`](./app-branding.md).
 - **Arbitrary nesting depth in `theme` objects** — property emission walks nested values recursively instead of stopping at level 2. `theme.extend.colors.brand.primary.500` now flattens to `brand-primary-500` instead of being silently dropped. Default keys (`default`, `global`, `DEFAULT`) collapse without contributing to the suffix. See [`arbitrary-values.md`](./arbitrary-values.md).
 - **`apply:` resolves bundled icon fonts from `dist/`** — `apply: 'fas fa-times-circle wh-12 ...'` now merges the FontAwesome family and glyph automatically. Same lookup runs for `mi-*` (Material Icons), `ms-*` (Material Symbols), and `f7-*` (Framework7). Project-level `purgetss/styles/fontawesome.tss` still wins over the bundled default. See [`apply-directive.md`](./apply-directive.md).
 
@@ -102,7 +185,7 @@ v7.10.0 through v7.10.2 are additive — **no breaking changes**. The notable sh
 
 If your project still uses the **flat** `brand:` config that predates v7.7.0, v7.10.2 normalizes it in memory on every run before defaults are applied. Without this, the build crashed with `TypeError: Cannot create property 'ios' on number '15'` because `brand.padding` was a number, not an object.
 
-Mapping (see [`app-branding.md` → Upgrading from pre-7.7.0 configs](./app-branding.md#upgrading-from-pre-7-7-0-configs)):
+Mapping to the v7.7.0 grouped schema (superseded in v7.13.0 by the per-piece structure — see [`app-branding.md` → Older configs update themselves](./app-branding.md#older-configs-update-themselves)):
 
 | Pre-7.7.0 flat key | Current grouped key |
 | --- | --- |
@@ -113,11 +196,11 @@ Mapping (see [`app-branding.md` → Upgrading from pre-7.7.0 configs](./app-bran
 | `brand.notification` | `brand.android.notification` |
 | `brand.splash` | `brand.android.splash` |
 
-The grouped key always wins when both forms coexist. A one-time deprecation notice per session lists which legacy keys were migrated. Auto-migration is transitional and may be removed in a future major version — update `config.cjs` to the grouped schema to silence the notice and stay future-proof.
+The grouped key always wins when both forms coexist. A one-time deprecation notice per session lists which legacy keys were migrated. This in-memory translation was removed in v7.13.0, which rewrites the block on disk once instead.
 
 ### What to review
 
-- If you maintain a `brand:` block from pre-7.7.0, plan the one-time update to the grouped schema (`logos`, `padding`, `android`, `ios`, `colors`).
+- If you maintain a `brand:` block from pre-7.7.0 and are heading past v7.13.0, there is nothing to plan — the block is rewritten on disk on the next run.
 - If you previously skipped `apply:` with icon fonts because they were silently dropped, that workaround is no longer needed in v7.10.0.
 - Deeply nested color families in `theme.extend.colors.*` that you flattened by hand to stay at depth ≤ 2 can be restructured by domain — the recursive emission now reaches every leaf.
 
@@ -439,8 +522,10 @@ If you previously worked around this by inlining the gradient directly in TSS, r
 - After v7.5.0: diff generated `utilities.tss` to confirm property deduplication produces the expected output.
 - After v7.5.3: consider wiring `Appearance.init()` at app boot if you want runtime Light/Dark switching.
 - After v7.6.0: run `brand`, `images`, and `semantic` once in a scratch project before pointing them at production assets, so you can preview the output layout.
-- After v7.7.0: migrate the `brand:` block in `config.cjs` to the grouped schema (`logos`, `padding`, `android`, `ios`, `colors`). v7.10.2 auto-migrates flat configs in memory, but the one-time update is recommended to silence the deprecation notice.
+- After v7.7.0: migrate the `brand:` block in `config.cjs` to the grouped schema (`logos`, `padding`, `android`, `ios`, `colors`). v7.10.2 auto-migrates flat configs in memory. Moot from v7.13.0, which rewrites the block on disk to the per-piece structure by itself.
 - After v7.8.0: run the build once and address every `Class Syntax Error` it surfaces. Update CI to handle the new hard-fail on malformed class names. Migrate any `top-[10px]` style square brackets to `top-(10px)` parentheses.
 - After v7.9.0: search for any `purgetss/experimental/tailwind-classes/` references in tooling/CI and update to `purgetss/glossary/tailwind-classes/`. If a project used top-level `theme.Window` / `View` / `ImageView` and depended on framework defaults being merged in, decide between moving the config under `theme.extend.*` or adding the previously-implicit utilities to the `apply` string.
 - After v7.10.0: deeply nested color families (`theme.extend.colors.brand.primary.500`) now emit recursively — restructure by domain if it improves readability. `apply:` with bundled icon fonts (`fas`, `mi-*`, `ms-*`, `f7-*`) no longer requires `build-fonts` first. The Google Play Feature Graphic ships automatically with `purgetss brand`.
 - After v7.11.0: reference `.svg` images with numeric `w-*`/`h-*` classes to opt into the compile-time SVG pipeline (add `purgetss/.cache/` to `.gitignore`). Ensure every `theme.fontFamily.*` value is a string, not a Tailwind-style array, or the new config validator hard-fails. Use `images.files` to pin per-file sizes and `images.autoSync: false` to stop the pipeline writing back to `config.cjs`.
+- After v7.12.1: re-run `purgetss brand --notes` if you had copied an earlier Android splash snippet — the theme now belongs on the launcher Activity, not on `<application>`. Run `purgetss icon-library -v=fa` to pick up Font Awesome 7.3.1.
+- After v7.13.0: grep build scripts, `alloy.jmk` and CI for the renamed `brand` flags (`--splash`, `--notification`, `--splash-logo`, `--feature-logo`, `--legacy-splash`) — no aliases were kept. Rename any `logo-icon.*` used as the Android launcher mark to `logo-adaptive.*`, or the launcher icons silently fall back to the main logo. Let `config.cjs` rewrite its own `brand:` block, then read the diff.

package/skills/purgetss/references/version-history.md

@@ -8,6 +8,35 @@ When in doubt about whether a class, flag, or config key exists in the user's in
 
 ---
 
+## v7.13.1
+- Four vulnerable transitive dependencies patched (`postcss`, `nanoid`, `brace-expansion`, `uuid`). Lockfile only; no API or class changes.
+
+## v7.13.0
+- **Breaking — one name per thing in `brand`.** `--splash` → `--splash-icon`, `--notification` → `--notification-icon`, `--splash-logo` → `--splash-icon-logo`, `--feature-logo` → `--feature-graphic-logo`. `--icon-logo` now feeds the `icon` piece (`DefaultIcon.png`); the Android launcher source is `--adaptive-logo`. `--legacy-splash` is gone — the 11 per-qualifier Android splashes are part of `android-splash` and always generated. Logo basenames follow `logo-<piece>` with no exceptions, so `logo-splash` → `logo-splash-icon` and `logo-feature` → `logo-feature-graphic`. **No aliases kept.** See [app-branding.md](app-branding.md).
+- **`brand:` config reorganized by piece, not by kind of setting.** 14 piece blocks, each accepting `logo` / `padding` / `background` / `enabled`. `background` cascades from `brand.background`; `padding` deliberately does not. Unknown keys abort the run at both levels instead of being ignored.
+- **Config migration moved from memory to disk.** Older `brand:` shapes are rewritten in `config.cjs` once, carrying over customized values and reporting each one moved. Runs on `brand` and on any command that goes through `ensureConfig()`. Replaces `normalizeLegacyBrand()`, which re-translated on every config read.
+- **`brand` now covers every image the Titanium template ships** — the 16 `assets/iphone/Default*.png`, the 11 `res-*/default.png`, and `assets/android/appicon.png` were previously left with the grey Alloy logo.
+- **`--only <pieces>` filter.** Pieces or groups (`ios`, `store`, `android`), honored by `--dry-run`. Naming a piece generates it even when its opt-in flag is absent; an unknown name aborts before writing.
+- **`LaunchLogo.png` (1024×1024) as the iOS launch screen source.** Activated by the presence of `purgetss/brand/logo-launch.{svg,png}`, or `--only launch-logo`. Tune with `--launch-logo` / `--launch-logo-padding`.
+- **`brand.optimize` / `--optimize`** — quantize the generated PNGs to a palette. Off by default (lossy); ~71% smaller on the reference set. `--no-optimize` overrides the config per run.
+- **Padding defaults changed:** adaptive `19%` → `18%`; the 28 splash images now share one configurable rule (`brand.androidSplash.padding` / `brand.iosSplash.padding`, default `26%`, measured against the canvas's shorter side).
+- Intermediate masters are sized to the largest request of the run instead of a fixed 1024 px, so no destination is ever upscaled.
+- `--nine-patch` declared but **not implemented** — selecting it prints a warning and writes nothing.
+- Fix: `shades` and `semantic` no longer strip every comment from `config.cjs`; they rewrite only the `theme:` section.
+
+## v7.12.1
+- `brand --notes` now targets Titanium's **launcher Activity** instead of only the app theme: prints a complete `splashscreen.xml` plus a launcher-only `Theme.SplashScreen` derived from `Theme.Titanium`. See [launch-background.md](launch-background.md).
+- Font Awesome Free updated to **7.3.1** — 23 new icon classes (`.fa-lotus`, `.fa-codeberg`, `.fa-copilot`, `.fa-substack`, `.fa-tesla`, `.fa-storybook`, `.fa-matrix`, `.fa-nextcloud`, `.fa-visual-studio`, …), none removed.
+
+## v7.12.0
+- `brand --notes` gained Android launch-background snippets (`android:windowSplashScreenBackground` + `android:windowBackground`), so a run that sets a brand background no longer flashes the default theme color at launch.
+- `--notes` wording no longer names only `tiapp.xml` — the command edits neither `tiapp.xml` nor the Android theme resources.
+
+## v7.11.2
+- Fix: `images.files` sync silently gave up on **any config containing comments** — including the one `purgetss init` generates. Every run printed `Could not insert <file> into images.files` while `files` stayed `[]`.
+- Fix: `parseTssMap()` dropped every property following an escaped quote, and classes carrying a nested object (`'.text-xs': { font: { fontSize: 12 } }`) never entered the TSS map — both starved the SVG pipeline of dimensions.
+- Fix: **Android `theme` values keep their quotes in custom rules.** `'.welcome-window': { android: { theme: 'Theme.AppDerived.NoTitleBar' } }` used to emit an unquoted value that Alloy cannot compile, because any value containing the substring `Titanium` was treated as a JavaScript expression. Detection is now anchored to the start of the value.
+
 ## v7.11.1
 - Symmetric width/height cascade in the SVG image pipeline: a class can pin width-only, height-only, or both; the unpinned side stays `null` in `images.files` and is re-derived from the SVG viewBox on every run (no stale auto-derived dimensions frozen in config).
 - `syncConfigImages` mirrors the **current** run instead of taking `max()` across past runs — shrinking a class (e.g. `h-52` → `h-16`) now propagates to `config.cjs`. Pin manually with `images.autoSync: false`.

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