@maccesar/titools 5.2.0 → 5.2.2

package/lib/utils.js

@@ -271,6 +271,8 @@ export function compareVersions(v1, v2) {
 }
 
 export default {
+  readSkillDescription,
+  shortenSkillDescription,
   blockExists,
   removeOldBlock,
   createKnowledgeBlock,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "5.2.0",
+  "version": "5.2.2",
   "description": "Titanium SDK skills and agents for AI coding assistants, including native game and sound synthesis modules",
   "main": "lib/index.js",
   "type": "module",
@@ -63,7 +63,9 @@
     "skills/",
     "agents/",
     "commands/",
-    "AGENTS-VERCEL-RESEARCH.md"
+    "CONTRIBUTING.md",
+    "docs/examples.md",
+    "docs/knowledge-index.md"
   ],
   "publishConfig": {
     "access": "public"

package/skills/purgetss/references/multi-density-images.md

@@ -360,7 +360,7 @@ If your source images live elsewhere (e.g. next to your design files in `docs/sc
 
 ```bash
 purgetss images ./docs/screenshots/home-hero.png
-purgetss images /Users/cesar/Design/banner.svg
+purgetss images /path/to/design/banner.svg
 ```
 
 When the source is outside `purgetss/images/`, subdirectory preservation uses the directory of the source file as the root instead. Processing that external source in Classic does not bootstrap unrelated PurgeTSS folders or config.

package/skills/ti-admob-unified/SKILL.md

@@ -1,11 +1,21 @@
 ---
 name: ti-admob-unified
-description: "Use when a Titanium app declares ti.admob.unified or its mediation complements, imports require('ti.admob.unified'), or asks to integrate/configure AdMob banners, interstitials, rewarded or app-open ads, UMP/ATT, privacy options, lifecycle, ad frequency or AppLovin, Meta, InMobi, Unity and Liftoff mediation with this module. Applies to Alloy and Classic on Android/iOS."
+description: "Use when a Titanium app declares ti.admob.unified or its mediation complements, imports require('ti.admob.unified'), or asks to integrate/configure AdMob banners, interstitials, rewarded, rewarded interstitial or app-open ads, UMP/ATT, privacy options, lifecycle, ad frequency or AppLovin, Meta, InMobi, Unity and Liftoff mediation with this module. Applies to Alloy and Classic on Android/iOS."
 ---
 
 # ti.admob.unified — ads, privacy and providers
 
-Integrate César's unified Titanium module using its official documentation and maintained application library. The local **1.0.0** contract is preparing for its first public release; do not claim a public release or usable production demand from these snapshots. Sources are pinned to **`5b4cbf9347a51c4f959dc262ac1500f82f28b4a0`**, copied 2026-10-11. See `references/source-snapshot.json` for paths/hashes and [references/source-notes.md](references/source-notes.md) for provenance and update checks. Check the installed build and current sources when behavior differs.
+Use the public **ti.admob.unified 1.0.0** module through its official
+[repository](https://github.com/macCesar/ti.admob.unified),
+[Android release](https://github.com/macCesar/ti.admob.unified/releases/tag/android-1.0.0)
+and [iOS release](https://github.com/macCesar/ti.admob.unified/releases/tag/ios-1.0.0).
+Reviewed released source: `034843299b2984253988e0ffccb9f6a1c91682c9` (2026-10-24).
+The core supports banners, interstitial, rewarded, rewarded interstitial and
+app-open formats; install only the mediation complements the app uses.
+Requires **Titanium 13.4.1.GA**, iOS 15+, Android API 24+ (compile SDK 36).
+Apple packages target iOS, not Mac Catalyst. See [source notes](references/source-notes.md)
+and the [snapshot](references/source-snapshot.json) for provenance and validation
+boundaries. Public module availability does not establish production ad eligibility.
 
 ## Required workflow
 
@@ -19,9 +29,12 @@ Read the relevant references before proposing calls or configuration. Do not inf
 | Consent-first startup, ATT, privacy options, request eligibility | [references/privacy.md](references/privacy.md) |
 | Fixed/adaptive banners, real reserved layout and pause/cleanup | [references/banners.md](references/banners.md) |
 | Interstitial/rewarded/app-open load/show, rewards and cleanup | [references/fullscreen.md](references/fullscreen.md) |
-| Select/install providers, publisher accounts, mappings, diagnostics | [references/mediation.md](references/mediation.md), [references/dependencies.md](references/dependencies.md) |
+| Rewarded interstitial introduction, visible Skip, rewards and cancellation | [references/rewarded-interstitial.md](references/rewarded-interstitial.md), [references/fullscreen.md](references/fullscreen.md) |
+| Production IDs, app-ads.txt, store/AdMob readiness and final-build checks | [references/production.md](references/production.md) |
+| Select/install providers, publisher accounts, mappings, diagnostics | [references/mediation.md](references/mediation.md), [references/dependencies.md](references/dependencies.md), [references/mediation-parity.md](references/mediation-parity.md) |
 | Replace legacy modules or internal builds | [references/migration.md](references/migration.md) |
 | Unsupported formats, extending providers, license/distribution | [references/roadmap.md](references/roadmap.md), [references/contributing.md](references/contributing.md), [references/third-party-notices.md](references/third-party-notices.md) |
+| Official docs index and release history | [references/index.md](references/index.md), [references/module-changelog.md](references/module-changelog.md) |
 | Game experience and frequency decisions | [references/game-monetization.md](references/game-monetization.md), plus fullscreen/privacy |
 
 Cite factual guidance with `[source: references/<file>.md]`. If the relevant source is unavailable, mark the claim `FROM_MEMORY (unverified):` and do not invent a method or provider setting.
@@ -30,12 +43,13 @@ Cite factual guidance with `[source: references/<file>.md]`. If the relevant sou
 
 - Inspect `tiapp.xml`, installed artifacts, project type and existing ad owner before adding another boundary. Use `ti-guides`/`ti-howtos`, Alloy or UI skills as applicable.
 - Prefer the official copy-ready `assets/example/lib/ads.js`: copy unchanged to Alloy `app/lib/ads.js` or Classic `Resources/lib/ads.js`. Its documentation imports `require('lib/ads')`; preserve its path and provenance. `assets/example/library-usage.js` and `assets/example/app.js` are official integration evidence, not navigation templates to paste wholesale.
-- Follow the documented UMP → request eligibility → initialization sequence. `canRequestAds()` is the gate, not ATT status or a guessed personalization flag. Resolve requested ATT separately; do not request it without an actual use case. Preserve privacy options and named-listener cleanup.
+- Follow UMP → optional foreground ATT → `canRequestAds()` → initialization/loading. A UMP error can retain prior eligibility; check the gate. `getTrackingAuthorizationStatus()` reads ATT without prompting or initializing. Android reports `applicable:false`; its `authorized:true` convention does not grant general tracking permission. The library defers ATT to `resumed` when needed. Preserve privacy options and named-listener cleanup.
 - Application IDs and ad-unit IDs are different. Use documented test IDs during development; do not switch to production IDs as an incidental fix.
-- Native activity/app lifecycle and SDK banner refresh belong to the module/Google. The app owns tab/window coverage and reserved layout. Do not add refresh timers or duplicate background handlers for banners.
-- Separate loading from deliberate fullscreen presentation. Do not show from a load callback. Coordinate game clock/audio/inputs and ad ownership; handle no-fill, failed presentation, actual close and destroyed screens without repeated ads or late navigation.
+- Preserve banners during Android's `_closeFromActivityForcedToDestroy` event; ordinary close still destroys the owner. Each banner manager has independent coverage/background state. Native activity/app lifecycle and SDK banner refresh belong to the module/Google. The app owns tab/window coverage and reserved layout. Do not add refresh timers or duplicate background handlers for banners.
+- Separate preloading from deliberate presentation. Loading alone never authorizes showing. An explicit pending Show intent must expire with its presentation context. Coordinate game clock/audio/inputs, no-fill, show failure, close and destroyed screens. Raw `load()`/`show()` are void; manager Boolean returns describe its attempt, not delivery. A stale-size rejection reloads but does not queue manager presentation. `autoReload` is a live close policy that loads another ad, never presents it.
+- Rewarded interstitial requires an accurate reward introduction and a visible Skip option. Present only while that introduction remains valid; credit only `rewarded`, not close/impression/click. Cancel pending introductions on background, lost eligibility, navigation or another fullscreen. Reward handling may need to survive screen changes for an already-presented ad.
 - Install only selected mediation complements on each target platform. All application calls use `ti.admob.unified`. Configure provider accounts and AdMob mappings; neither a packaged adapter nor `ready` diagnostics nor a Google test ad proves provider delivery. Do not invent placeholder keys, manual provider initializers or an `enableMediation` option.
-- Consult the roadmap before suggesting native ads, rewarded interstitial or a network outside the distributed set. Supporting several formats does not justify enabling all of them in a game.
+- Consult the roadmap before suggesting native ads, deferred ironSource or a network outside the distributed set. Supporting several formats does not justify enabling all of them in a game.
 
 ## Acceptance
 

package/skills/ti-admob-unified/assets/example/app.js

@@ -2,7 +2,7 @@
  * ti.admob.unified example
  *
  * This app uses only Google's official demo ad unit IDs. It demonstrates:
- * - UMP -> canRequestAds -> ATT (iOS) -> initialization
+ * - UMP -> ATT (iOS) -> canRequestAds -> initialization
  * - every ad format the module exposes, one button each
  * - a banner host that reserves its own space
  * - explicit listener and proxy cleanup
@@ -39,11 +39,14 @@ let preserveConsentBannerSlot = false
 let initializationStarted = false
 let initializationComplete = false
 let trackingRequestStarted = false
+let appActive = true
+let trackingPending = false
 let windowClosed = false
 let banner = null
 let activeBannerButton = null
 let interstitial = null
 let rewarded = null
+let rewardedInterstitial = null
 let appOpen = null
 
 // Native semantic color names keep existing views in sync with the system theme.
@@ -59,10 +62,15 @@ const win = Ti.UI.createWindow({
   title: 'AdMob Playground',
   barColor: colors.canvas,
   titleAttributes: { color: colors.ink },
-  layout: 'composite',
+  layout: 'vertical',
   extendSafeArea: false
 })
 
+// Native vertical layout reserves the HUD's measured height above the viewport.
+const viewport = Ti.UI.createView({
+  width: Ti.UI.FILL, height: Ti.UI.FILL, layout: 'composite'
+})
+
 const content = Ti.UI.createScrollView({
   top: 0, left: 0, right: 0, bottom: 0,
   layout: 'vertical', contentHeight: Ti.UI.SIZE,
@@ -96,7 +104,7 @@ masthead.add(Ti.UI.createLabel({
 page.add(masthead)
 
 const session = Ti.UI.createView({
-  top: '24dp', left: '24dp', right: '24dp', height: Ti.UI.SIZE,
+  top: '12dp', bottom: '12dp', left: '24dp', right: '24dp', height: Ti.UI.SIZE,
   layout: 'vertical', backgroundColor: colors.tint, borderRadius: '12dp'
 })
 const sessionLabel = Ti.UI.createLabel({
@@ -107,12 +115,11 @@ const sessionLabel = Ti.UI.createLabel({
 const statusLabel = Ti.UI.createLabel({
   text: 'Requesting privacy information…',
   top: '8dp', left: '16dp', right: '16dp', bottom: '16dp',
-  height: '48dp', verticalAlign: Ti.UI.TEXT_VERTICAL_ALIGNMENT_TOP, color: colors.ink,
+  height: Ti.UI.SIZE, verticalAlign: Ti.UI.TEXT_VERTICAL_ALIGNMENT_TOP, color: colors.ink,
   font: { fontSize: '16dp', fontWeight: 'semibold' }
 })
 session.add(sessionLabel)
 session.add(statusLabel)
-page.add(session)
 
 const activity = Ti.UI.createLabel({
   text: 'Session events will appear here.', left: '16dp', right: '16dp',
@@ -140,6 +147,10 @@ function setBannerHeight(value) {
 
 let currentSection
 const formatCards = []
+const fullscreenButtons = []
+function cancelPendingFullscreenShows() {
+  fullscreenButtons.forEach(button => button.cancelPendingShow())
+}
 function createSection(title, description, grid) {
   page.add(Ti.UI.createLabel({
     text: title, top: '32dp', left: '24dp', right: '24dp', height: Ti.UI.SIZE,
@@ -190,7 +201,11 @@ function createAdButton(title, handlers) {
     accessibilityHint: handlers.description || ''
   })
   let state = 'idle'
-  const sizeGuard = fullscreen ? createFullscreenSizeGuard(() => win.size) : null
+  let pendingShow = false
+  let introPending = false
+  let introAccepted = false
+  let showIntent = 0
+  const sizeGuard = fullscreen ? createFullscreenSizeGuard(() => win) : null
   button.creating = function () {
     state = 'creating'
     button.applyProperties({ title: 'Loading…', backgroundColor: colors.quiet, color: colors.muted, enabled: false })
@@ -201,8 +216,16 @@ function createAdButton(title, handlers) {
       title: `Show ${title.toLowerCase()}`, backgroundColor: colors.accent,
       backgroundSelectedColor: colors.pressed, color: colors.surface, enabled: true
     })
+    if (pendingShow) presentRequestedAd()
+  }
+  button.cancelPendingShow = function () {
+    pendingShow = false
+    introPending = false
+    introAccepted = false
+    showIntent += 1
   }
   button.reset = function () {
+    button.cancelPendingShow()
     state = 'idle'
     button.applyProperties({
       title: isFormat && consentBusy ? 'Waiting for consent…'
@@ -234,24 +257,59 @@ function createAdButton(title, handlers) {
     if (sizeGuard) sizeGuard.recordLoad()
     handlers.onLoad(button)
   }
+  function presentRequestedAd() {
+    if (!pendingShow || state !== 'ready') return
+    if (windowClosed || consentBusy || !appActive || !Admob.canRequestAds()) {
+      button.cancelPendingShow()
+      return
+    }
+    if (handlers.beforeShow && !introAccepted) {
+      if (introPending) return
+      introPending = true
+      const intent = showIntent
+      handlers.beforeShow(accepted => {
+        if (intent !== showIntent || !pendingShow) return
+        introPending = false
+        if (!accepted) { button.cancelPendingShow(); return }
+        introAccepted = true
+        presentRequestedAd()
+      })
+      return
+    }
+    sizeGuard.show(() => {
+      pendingShow = false
+      state = 'showing'
+      button.applyProperties({ title: 'Showing…', enabled: false, backgroundColor: colors.quiet, color: colors.muted })
+      handlers.onShow(button)
+    }, () => button.load())
+  }
   button.addEventListener('click', () => {
-    if (consentBusy || state === 'creating' || state === 'showing') return
-    if (state === 'ready') {
-      if (windowClosed || !Admob.canRequestAds()) {
-        setStatus(`${title} blocked by privacy settings`)
+    if (consentBusy || state === 'creating' || state === 'showing' || introPending) return
+    if (fullscreen) {
+      if (windowClosed || !appActive || !Admob.canRequestAds()) {
+        setStatus(`${title} blocked by privacy or foreground state`)
         return
       }
-      sizeGuard.show(() => {
-        state = 'showing'
-        button.applyProperties({ title: 'Showing…', enabled: false, backgroundColor: colors.quiet, color: colors.muted })
-        handlers.onShow(button)
-      }, () => button.load())
+      cancelPendingFullscreenShows()
+      pendingShow = true
+      if (state === 'ready') presentRequestedAd()
+      else button.load()
       return
     }
-    if (!fullscreen || state === 'failed') button.load()
+    button.load()
   })
+  if (fullscreen) fullscreenButtons.push(button)
   const parent = card || currentSection
   parent.add(button)
+  if (handlers.policyUrl) {
+    const policy = Ti.UI.createButton({
+      title: 'AdMob rewarded interstitial requirements',
+      top: '8dp', left: '20dp', right: '20dp', bottom: '8dp',
+      height: Ti.UI.SIZE, color: colors.accent, font: { fontSize: '14dp' }
+    })
+    policy.addEventListener('click', () => Ti.Platform.openURL(handlers.policyUrl))
+    parent.add(policy)
+  }
   return button
 }
 
@@ -308,6 +366,7 @@ function loadExampleAds() {
   rewardedButton.load()
   appOpenButton.load()
   adaptiveButton.load()
+  rewardedInterstitialButton.load()
   adsStoppedForConsent = false
   preserveConsentBannerSlot = false
 }
@@ -319,10 +378,41 @@ function onTrackingAuthorizationCompleted(event) {
     onTrackingAuthorizationCompleted
   )
   Ti.API.info(`ATT status: ${event.status}`)
+  Ti.API.info('Current ATT state: ' + JSON.stringify(Admob.getTrackingAuthorizationStatus()))
   initializeAdsOnce()
   updateConsentTools()
 }
 
+function requestExampleTracking() {
+  if (windowClosed || trackingRequestStarted || (Ti.Platform.osname !== 'android' && !appActive)) return
+  trackingRequestStarted = true
+  Admob.addEventListener('tracking_authorization_completed', onTrackingAuthorizationCompleted)
+  updateConsentTools()
+  Admob.requestTrackingAuthorization()
+}
+
+let trackingQueryCount = 0
+function updateTrackingStatus(manual = false) {
+  if (manual) trackingQueryCount += 1
+  const tracking = Admob.getTrackingAuthorizationStatus()
+  const names = ['Not determined', 'Restricted', 'Denied', 'Authorized']
+  trackingStatusLabel.text = tracking.applicable
+    ? `ATT status: ${names[tracking.status] || 'Unknown'} (${tracking.status}). Authorized: ${tracking.authorized}. Applicable: true.`
+    : 'ATT status: not applicable on Android (3). Authorized: true is a portable convention, not general tracking permission.'
+  trackingStatusLabel.text += `\nLast checked: ${new Date().toLocaleTimeString()}. Manual checks: ${trackingQueryCount}.`
+  if (tracking.applicable && tracking.status !== 0) {
+    trackingStatusLabel.text += '\nPermission already resolved. Change it in iOS Settings.'
+  }
+  trackingQueryButton.enabled = !windowClosed && !consentBusy && !trackingRequestStarted
+  trackingPermissionButton.enabled = !windowClosed && appActive && !consentBusy && !trackingRequestStarted
+    && !(initializationStarted && !initializationComplete) && tracking.applicable && tracking.status === 0
+  trackingPermissionButton.applyProperties({
+    backgroundColor: trackingPermissionButton.enabled ? colors.tint : colors.quiet,
+    color: trackingPermissionButton.enabled ? colors.accent : colors.muted
+  })
+  return tracking
+}
+
 function continueAfterPrivacyGate(canRequestAds) {
   if (!canRequestAds || initializationStarted || windowClosed) {
     return
@@ -332,12 +422,23 @@ function continueAfterPrivacyGate(canRequestAds) {
     return
   }
 
-  trackingRequestStarted = true
-  Admob.addEventListener(
-    'tracking_authorization_completed',
-    onTrackingAuthorizationCompleted
-  )
-  Admob.requestTrackingAuthorization()
+  if (Ti.Platform.osname !== 'android' && !appActive) {
+    trackingPending = true
+    return
+  }
+  trackingPending = false
+  requestExampleTracking()
+}
+
+function onApplicationPause() {
+  appActive = false
+  cancelPendingFullscreenShows()
+  updateTrackingStatus()
+}
+function onApplicationResumed() {
+  appActive = true
+  if (trackingPending) continueAfterPrivacyGate(Admob.canRequestAds())
+  updateTrackingStatus()
 }
 
 // Reopening is separate from initial consent; unknown/error is not NOT_REQUIRED.
@@ -361,7 +462,7 @@ function updateConsentTools() {
     button.enabled = !busy
     button.title = busy ? 'Run test — please wait…' : 'Run test'
   })
-
+  updateTrackingStatus()
 }
 
 function stopAdsForConsent() {
@@ -369,9 +470,11 @@ function stopAdsForConsent() {
   destroyBanner()
   destroyInterstitial()
   destroyRewarded()
+  destroyRewardedInterstitial()
   destroyAppOpen()
   interstitialButton.reset()
   rewardedButton.reset()
+  rewardedInterstitialButton.reset()
   appOpenButton.reset()
   adsStoppedForConsent = true
 }
@@ -680,6 +783,32 @@ function onRewardedClosed() {
   rewardedButton.load()
 }
 
+function destroyRewardedInterstitial() {
+  if (!rewardedInterstitial) return
+  rewardedInterstitial.removeEventListener(Admob.AD_LOADED, onRewardedInterstitialLoaded)
+  rewardedInterstitial.removeEventListener(Admob.AD_FAILED_TO_LOAD, onRewardedInterstitialFailed)
+  rewardedInterstitial.removeEventListener(Admob.AD_FAILED_TO_SHOW, onRewardedInterstitialFailed)
+  rewardedInterstitial.removeEventListener(Admob.AD_REWARDED, onRewardEarned)
+  rewardedInterstitial.removeEventListener(Admob.AD_CLOSED, onRewardedInterstitialClosed)
+  rewardedInterstitial.destroy()
+  rewardedInterstitial = null
+}
+
+function onRewardedInterstitialLoaded() {
+  setStatus('Rewarded interstitial ready')
+  rewardedInterstitialButton.ready()
+}
+
+function onRewardedInterstitialFailed(event) {
+  setStatus(`Rewarded interstitial failed: ${event.error} (${event.code})`)
+  rewardedInterstitialButton.failed()
+}
+
+function onRewardedInterstitialClosed() {
+  rewardedInterstitialButton.reset()
+  rewardedInterstitialButton.load()
+}
+
 function destroyAppOpen() {
   if (!appOpen) {
     return
@@ -760,6 +889,11 @@ const interstitialButton = createAdButton('Interstitial', {
 const rewardedButton = createAdButton('Rewarded', {
   description: 'An opt-in experience that earns an in-app reward.',
   onLoad: () => {
+    // Reuse consumed proxies so a delayed SDK reward still reaches its listener.
+    if (rewarded && !rewarded.isLoaded()) {
+      rewarded.load()
+      return
+    }
     destroyRewarded()
     rewarded = Admob.createRewarded({
       adUnitId: Admob.TEST_REWARDED,
@@ -796,6 +930,43 @@ const appOpenButton = createAdButton('App open', {
   onShow: () => appOpen.show()
 })
 
+const rewardedInterstitialButton = createAdButton('Rewarded interstitial', {
+  description: 'Complete this test ad to earn 10 demo coins. AdMob requires an introduction explaining the reward, a clear Skip option before the ad starts, and enough time to decide. Tap Show to choose Watch test ad or Skip.',
+  policyUrl: 'https://support.google.com/admob/answer/9884467?hl=en',
+  onLoad: () => {
+    // Reuse consumed proxies so a delayed SDK reward still reaches its listener.
+    if (rewardedInterstitial && !rewardedInterstitial.isLoaded()) {
+      rewardedInterstitial.load()
+      return
+    }
+    destroyRewardedInterstitial()
+    rewardedInterstitial = Admob.createRewardedInterstitial({
+      adUnitId: Admob.TEST_REWARDED_INTERSTITIAL,
+      requestAgent: 'ti.admob.unified example', autoReload: false
+    })
+    rewardedInterstitial.addEventListener(Admob.AD_LOADED, onRewardedInterstitialLoaded)
+    rewardedInterstitial.addEventListener(Admob.AD_FAILED_TO_LOAD, onRewardedInterstitialFailed)
+    rewardedInterstitial.addEventListener(Admob.AD_FAILED_TO_SHOW, onRewardedInterstitialFailed)
+    rewardedInterstitial.addEventListener(Admob.AD_REWARDED, onRewardEarned)
+    rewardedInterstitial.addEventListener(Admob.AD_CLOSED, onRewardedInterstitialClosed)
+    rewardedInterstitial.load()
+  },
+  beforeShow: complete => {
+    const intro = Ti.UI.createAlertDialog({
+      title: 'Test ad reward',
+      message: 'Watch this test ad to earn 10 demo coins, or skip and continue without watching.',
+      buttonNames: ['Watch test ad', 'Skip'], cancel: 1
+    })
+    intro.addEventListener('click', event => {
+      const watch = event.index === 0
+      if (!watch) setStatus('Rewarded interstitial skipped')
+      complete(watch)
+    })
+    intro.show()
+  },
+  onShow: () => rewardedInterstitial.show()
+})
+
 createSection('Banner ads', 'Adaptive starts automatically. Choose a format for the banner slot.', true)
 
 const fixedButton = createAdButton('Fixed banner', {
@@ -869,6 +1040,30 @@ currentSection.add(privacyNote)
 
 setPrivacyOptionsAvailable(undefined)
 
+createSection('Tracking transparency', 'Check ATT without a prompt. Request it only when the app uses tracking. UMP may already handle the request.', false)
+const trackingStatusLabel = Ti.UI.createLabel({
+  top: '8dp', left: '8dp', right: '8dp', height: Ti.UI.SIZE,
+  color: colors.muted, font: { fontSize: '13dp' }, text: 'ATT status: checking…'
+})
+currentSection.add(trackingStatusLabel)
+const trackingQueryButton = createAdButton('Check ATT status', {
+  privacy: true,
+  onLoad: button => {
+    button.reset()
+    updateTrackingStatus(true)
+    setStatus('ATT status refreshed without requesting permission')
+  }
+})
+const trackingPermissionButton = createAdButton('Request ATT permission', {
+  privacy: true,
+  onLoad: button => {
+    button.reset()
+    const tracking = updateTrackingStatus()
+    if (tracking.applicable && tracking.status === 0 && appActive) requestExampleTracking()
+  }
+})
+updateTrackingStatus()
+
 if (consentTestingEnabled) {
   createSection('Consent demo', 'Choose a scenario and run it. Testing clears the previous consent choice.', false)
   currentSection.add(Ti.UI.createLabel({
@@ -967,14 +1162,22 @@ Admob.addEventListener(
 )
 Admob.addEventListener('ad_inspector_closed', onAdInspectorClosed)
 
-win.add(content)
-win.add(bannerHost)
+viewport.add(content)
+viewport.add(bannerHost)
+win.add(session)
+win.add(viewport)
+Ti.App.addEventListener('pause', onApplicationPause)
+Ti.App.addEventListener('resumed', onApplicationResumed)
 
 // On Android, Titanium also fires close while it recreates the activity, for
 // example on a light/dark switch. The window survives, so its ads must too.
 win.addEventListener('close', event => {
   if (event._closeFromActivityForcedToDestroy) return
   windowClosed = true
+  cancelPendingFullscreenShows()
+  trackingPending = false
+  Ti.App.removeEventListener('pause', onApplicationPause)
+  Ti.App.removeEventListener('resumed', onApplicationResumed)
   content.removeEventListener('postlayout', layoutPage)
 
   Admob.removeEventListener('module_initialized', onModuleInitialized)
@@ -993,6 +1196,7 @@ win.addEventListener('close', event => {
   destroyBanner()
   destroyInterstitial()
   destroyRewarded()
+  destroyRewardedInterstitial()
   destroyAppOpen()
 })
 

package/skills/ti-admob-unified/assets/example/lib/ads.js

@@ -95,6 +95,7 @@ async function initializeIfAllowed() {
  * options.consent: dictionary passed to requestConsent()
  * options.requestTrackingAuthorization: true only when the app has a real ATT use case
  * options.initialization: dictionary passed to initialize()
+ * Call start() while active. If UMP spans an iOS interruption, ATT waits for resumed.
  */
 function start(options) {
   if (startup) {
@@ -103,6 +104,18 @@ function start(options) {
 
   startupOptions = options || {}
   startup = (async () => {
+    const watchForeground = startupOptions.requestTrackingAuthorization === true && Ti.Platform.osname !== 'android'
+    let active = true
+    let resumeTracking = null
+    function onPause() { active = false }
+    function onResumed() {
+      active = true
+      if (resumeTracking) resumeTracking()
+    }
+    if (watchForeground) {
+      Ti.App.addEventListener('pause', onPause)
+      Ti.App.addEventListener('resumed', onResumed)
+    }
     const consent = await waitForEvent('consent_complete', () => {
       Admob.requestConsent(startupOptions.consent || {})
     })
@@ -113,6 +126,11 @@ function start(options) {
 
     let tracking = null
     if (startupOptions.requestTrackingAuthorization === true) {
+      if (watchForeground) {
+        if (!active) await new Promise(resolve => { resumeTracking = resolve })
+        Ti.App.removeEventListener('pause', onPause)
+        Ti.App.removeEventListener('resumed', onResumed)
+      }
       tracking = await waitForEvent('tracking_authorization_completed', () => {
         Admob.requestTrackingAuthorization()
       })
@@ -409,7 +427,12 @@ function fullscreenProperties(options) {
 function createFullscreenSizeGuard(getSize) {
   let requestedSize = null
   function sizeKey() {
-    const size = getSize()
+    const geometry = getSize()
+    // Window.size can change while Android restores bars after a fullscreen ad.
+    // Outer window bounds stay stable and still track rotation and split view.
+    const rect = geometry && geometry.rect
+    const size = rect && rect.width > 0 && rect.height > 0
+      ? rect : (geometry && geometry.size) || geometry
     return size && size.width > 0 && size.height > 0
       ? `${Math.round(size.width)}x${Math.round(size.height)}` : null
   }
@@ -437,7 +460,7 @@ function createFullscreen(options, factoryName) {
   let destroyed = false
   let loadRequested = options.autoLoad === true
   let loading = false
-  const sizeGuard = createFullscreenSizeGuard(() => (options.window || Ti.UI.currentWindow)?.size)
+  const sizeGuard = createFullscreenSizeGuard(() => options.window || Ti.UI.currentWindow)
 
   function detach(destroyNative) {
     if (!proxy) {
@@ -565,6 +588,10 @@ function createRewarded(options) {
   return createFullscreen(options, 'createRewarded')
 }
 
+function createRewardedInterstitial(options) {
+  return createFullscreen(options, 'createRewardedInterstitial')
+}
+
 function createAppOpen(options) {
   return createFullscreen(options, 'createAppOpen')
 }
@@ -613,6 +640,7 @@ module.exports = {
   createFullscreenSizeGuard,
   createInterstitial,
   createRewarded,
+  createRewardedInterstitial,
   createAppOpen,
   destroyAll
 }