@maccesar/titools 2.7.2 → 2.9.0

package/skills/ti-branding/scripts/ti-branding

@@ -1,546 +0,0 @@
-#!/usr/bin/env bash
-# ti-branding — generate icon and splash assets for Titanium SDK 13.x projects.
-# Entry point. Parses args, validates, and delegates to lib/ scripts.
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-LIB_DIR="$SCRIPT_DIR/lib"
-ASSETS_DIR="$(cd "$SCRIPT_DIR/../assets" && pwd)"
-
-# shellcheck source=lib/deps.sh
-source "$LIB_DIR/deps.sh"
-# shellcheck source=lib/validate.sh
-source "$LIB_DIR/validate.sh"
-# shellcheck source=lib/prepare-master.sh
-source "$LIB_DIR/prepare-master.sh"
-# shellcheck source=lib/gen-ios.sh
-source "$LIB_DIR/gen-ios.sh"
-# shellcheck source=lib/gen-android-adaptive.sh
-source "$LIB_DIR/gen-android-adaptive.sh"
-# shellcheck source=lib/gen-android-legacy.sh
-source "$LIB_DIR/gen-android-legacy.sh"
-# shellcheck source=lib/gen-marketplace.sh
-source "$LIB_DIR/gen-marketplace.sh"
-# shellcheck source=lib/cleanup-legacy.sh
-source "$LIB_DIR/cleanup-legacy.sh"
-# shellcheck source=lib/gen-notification.sh
-source "$LIB_DIR/gen-notification.sh"
-# shellcheck source=lib/gen-splash-icon.sh
-source "$LIB_DIR/gen-splash-icon.sh"
-
-# -----------------------------------------------------------------------------
-# Defaults
-# -----------------------------------------------------------------------------
-
-MASTER=""
-MONOCHROME_MASTER=""
-BG_COLOR="#FFFFFF"
-BG_COLOR_EXPLICIT=0
-PADDING=20
-IOS_PADDING=4
-WITH_NOTIFICATION=0
-WITH_SPLASH_ICON=0
-CLEANUP_LEGACY=0
-AGGRESSIVE=0
-OUTPUT=""
-OUTPUT_EXPLICIT=0
-DRY_RUN=0
-IN_PLACE=0
-IS_IN_PLACE=0
-NOTES=0
-PROJECT_ROOT="$(pwd)"
-
-# -----------------------------------------------------------------------------
-# Colored output helpers
-# -----------------------------------------------------------------------------
-
-if [[ -t 1 ]]; then
-  C_RED=$'\033[31m'; C_GREEN=$'\033[32m'; C_YELLOW=$'\033[33m'
-  C_BLUE=$'\033[34m'; C_DIM=$'\033[2m'; C_BOLD=$'\033[1m'; C_RESET=$'\033[0m'
-else
-  C_RED=''; C_GREEN=''; C_YELLOW=''; C_BLUE=''; C_DIM=''; C_BOLD=''; C_RESET=''
-fi
-
-log_info()  { echo "${C_BLUE}ℹ${C_RESET} $*"; }
-log_ok()    { echo "${C_GREEN}✓${C_RESET} $*"; }
-log_warn()  { echo "${C_YELLOW}⚠${C_RESET} $*" >&2; }
-log_err()   { echo "${C_RED}✗${C_RESET} $*" >&2; }
-log_step()  { echo; echo "${C_BOLD}==>${C_RESET} $*"; }
-
-export C_RED C_GREEN C_YELLOW C_BLUE C_DIM C_BOLD C_RESET
-export -f log_info log_ok log_warn log_err log_step
-
-# -----------------------------------------------------------------------------
-# Usage
-# -----------------------------------------------------------------------------
-
-usage() {
-  cat <<'EOF'
-ti-branding — generate branding assets for Titanium SDK 13.x projects.
-
-USAGE:
-  ti-branding <master> [options]
-
-ARGUMENTS:
-  <master>                 Path to master image (SVG or PNG ≥ 1024×1024).
-
-OPTIONS:
-  --bg-color <hex>         Background color for adaptive layer + iOS alpha flatten.
-                           Default: #FFFFFF
-  --padding <pct>          Android safe-zone padding per side (0–40). Default: 20
-                           (Material spec floor is 19.44%; default 20 gives a
-                           tiny buffer while keeping the logo visibly prominent.)
-  --ios-padding <pct>      iOS/marketplace aesthetic padding per side (0–40).
-                           Default: 4. iOS icons have no launcher mask — this
-                           is purely breathing room. Production reference apps
-                           (Mail, Safari, La Baraja) use 2-6% per side.
-  --with-notification      Also generate ic_stat_notify.png × 5 densities.
-  --with-splash-icon       Also generate splash_icon.png × 5 densities (Android 12+).
-  --cleanup-legacy         After generating (or standalone), remove legacy branding
-                           artifacts detected via tiapp.xml analysis. Safe by default —
-                           context-aware, always prints a plan before deleting.
-  --aggressive             With --cleanup-legacy, also remove ldpi density folders
-                           (<1% global market in 2026). Off by default.
-  --output <dir>           Staging directory. Default: <project>/.ti-branding
-  --project <dir>          Project root (default: current working directory).
-  --in-place               Skip the staging directory — write files directly into
-                           the project root. OVERWRITES existing icons. --output
-                           takes precedence when both are passed.
-  --monochrome-master <p>  Optional dedicated silhouette master for
-                           ic_launcher_monochrome.png + ic_stat_notify.png.
-                           Use when the colored logo has multi-color detail
-                           that would collapse into a featureless blob when
-                           naively whitened. Falls back to main master if omitted.
-  --notes                  Print full tiapp.xml snippets + padding tuning guide
-                           after the run. Default is a compact summary — use this
-                           when you need the config snippets to paste into tiapp.xml.
-  --dry-run                Print what would be generated without writing files.
-  -h, --help               Show this help.
-
-EXAMPLES:
-  ti-branding ./logo.svg
-  ti-branding ./logo.png --bg-color "#0B1326" --padding 22
-  ti-branding ./docs/snap-logo.svg --bg-color "#0B1326" --with-notification --with-splash-icon
-EOF
-}
-
-# -----------------------------------------------------------------------------
-# Parse args
-# -----------------------------------------------------------------------------
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -h|--help) usage; exit 0 ;;
-    --bg-color) BG_COLOR="$2"; BG_COLOR_EXPLICIT=1; shift 2 ;;
-    --padding) PADDING="$2"; shift 2 ;;
-    --ios-padding) IOS_PADDING="$2"; shift 2 ;;
-    --with-notification) WITH_NOTIFICATION=1; shift ;;
-    --with-splash-icon) WITH_SPLASH_ICON=1; shift ;;
-    --cleanup-legacy) CLEANUP_LEGACY=1; shift ;;
-    --aggressive) AGGRESSIVE=1; shift ;;
-    --output) OUTPUT="$2"; OUTPUT_EXPLICIT=1; shift 2 ;;
-    --project) PROJECT_ROOT="$2"; shift 2 ;;
-    --in-place) IN_PLACE=1; shift ;;
-    --monochrome-master) MONOCHROME_MASTER="$2"; shift 2 ;;
-    --notes) NOTES=1; shift ;;
-    --dry-run) DRY_RUN=1; shift ;;
-    --) shift; break ;;
-    -*) log_err "Unknown option: $1"; usage >&2; exit 2 ;;
-    *)
-      if [[ -z "$MASTER" ]]; then
-        MASTER="$1"; shift
-      else
-        log_err "Unexpected positional argument: $1"; exit 2
-      fi
-      ;;
-  esac
-done
-
-# -----------------------------------------------------------------------------
-# Validate args
-# -----------------------------------------------------------------------------
-
-# Cleanup-only mode: master image is optional when --cleanup-legacy is set alone.
-if [[ -z "$MASTER" && $CLEANUP_LEGACY -eq 0 ]]; then
-  log_err "Master image path is required (unless using --cleanup-legacy alone)."
-  usage >&2
-  exit 2
-fi
-
-if [[ -n "$MASTER" && ! -f "$MASTER" ]]; then
-  log_err "Master image not found: $MASTER"
-  exit 2
-fi
-
-# Resolve to absolute path
-if [[ -n "$MASTER" ]]; then
-  MASTER="$(cd "$(dirname "$MASTER")" && pwd)/$(basename "$MASTER")"
-fi
-PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"
-
-if [[ "$PADDING" -lt 0 || "$PADDING" -gt 40 ]]; then
-  log_err "Padding must be between 0 and 40 (got: $PADDING)."
-  exit 2
-fi
-
-if [[ "$IOS_PADDING" -lt 0 || "$IOS_PADDING" -gt 40 ]]; then
-  log_err "iOS padding must be between 0 and 40 (got: $IOS_PADDING)."
-  exit 2
-fi
-
-if [[ ! "$BG_COLOR" =~ ^#[0-9A-Fa-f]{6}$ ]]; then
-  log_err "--bg-color must be a 6-digit hex like #0B1326 (got: $BG_COLOR)."
-  exit 2
-fi
-
-# Resolve staging dir:
-#   explicit --output wins over --in-place (avoids ambiguity)
-#   --in-place (no --output) → write directly into the project root
-#   neither → default to .ti-branding/ inside the project
-if [[ $IN_PLACE -eq 1 && $OUTPUT_EXPLICIT -eq 0 ]]; then
-  OUTPUT="$PROJECT_ROOT"
-  IS_IN_PLACE=1
-fi
-OUTPUT="${OUTPUT:-$PROJECT_ROOT/.ti-branding}"
-
-# -----------------------------------------------------------------------------
-# Detect project layout
-# -----------------------------------------------------------------------------
-
-PROJECT_TYPE="unknown"
-if [[ -d "$PROJECT_ROOT/app" ]]; then
-  PROJECT_TYPE="alloy"
-elif [[ -d "$PROJECT_ROOT/Resources" ]]; then
-  PROJECT_TYPE="classic"
-fi
-
-log_step "ti-branding — Titanium SDK 13.x"
-log_info "Project:      $PROJECT_ROOT ($PROJECT_TYPE)"
-if [[ -n "$MASTER" ]]; then
-  log_info "Master:       $MASTER"
-  log_info "Background:   $BG_COLOR"
-  log_info "Padding:      Android ${PADDING}% / iOS ${IOS_PADDING}% per side"
-  if [[ $IS_IN_PLACE -eq 1 ]]; then
-    log_info "Writing IN PLACE to: $PROJECT_ROOT"
-  else
-    log_info "Staging:      $OUTPUT"
-  fi
-fi
-[[ $WITH_NOTIFICATION -eq 1 ]] && log_info "Extras:       + notification icons"
-[[ $WITH_SPLASH_ICON -eq 1 ]] && log_info "Extras:       + Android 12+ splash icon"
-[[ $CLEANUP_LEGACY -eq 1 ]] && log_info "Cleanup:      --cleanup-legacy$([[ $AGGRESSIVE -eq 1 ]] && echo " --aggressive")"
-[[ $IS_IN_PLACE -eq 1 && $DRY_RUN -eq 0 ]] && log_warn "⚠  --in-place mode: files in your project will be OVERWRITTEN. Commit first if you want a rollback."
-[[ $DRY_RUN -eq 1 ]] && log_warn "DRY RUN — no files will be written"
-
-# -----------------------------------------------------------------------------
-# Cleanup-only mode — skip all generation steps
-# -----------------------------------------------------------------------------
-
-if [[ -z "$MASTER" && $CLEANUP_LEGACY -eq 1 ]]; then
-  log_step "Cleanup-only mode"
-  cleanup_legacy "$PROJECT_ROOT" "$PROJECT_TYPE" "$AGGRESSIVE" "$DRY_RUN"
-  exit 0
-fi
-
-if [[ "$PROJECT_TYPE" == "unknown" ]]; then
-  log_warn "Could not detect project layout. Expected 'app/' (Alloy) or 'Resources/' (Classic)."
-  log_warn "Assets will be generated under '$OUTPUT/standalone/' so you can copy them manually."
-fi
-
-# -----------------------------------------------------------------------------
-# Pipeline
-# -----------------------------------------------------------------------------
-
-log_step "1/6 Checking dependencies"
-check_deps "$MASTER"
-
-log_step "2/6 Validating master"
-validate_master "$MASTER"
-
-log_step "3/6 Preparing masters (square for iOS, tight for Android)"
-PREPARED_BASE="$OUTPUT/_master"
-MASTER_SQUARE="${PREPARED_BASE}_square.png"
-MASTER_TIGHT="${PREPARED_BASE}_tight.png"
-MONO_TIGHT=""
-if [[ $DRY_RUN -eq 0 ]]; then
-  mkdir -p "$OUTPUT"
-  prepare_master "$MASTER" "$PREPARED_BASE"
-  log_ok "Square master: $MASTER_SQUARE"
-  log_ok "Tight master:  $MASTER_TIGHT"
-
-  # Optional: prepare a dedicated monochrome master if provided.
-  if [[ -n "$MONOCHROME_MASTER" ]]; then
-    if [[ ! -f "$MONOCHROME_MASTER" ]]; then
-      log_err "Monochrome master not found: $MONOCHROME_MASTER"
-      exit 2
-    fi
-    local_mono_base="$OUTPUT/_master_mono"
-    prepare_master "$MONOCHROME_MASTER" "$local_mono_base"
-    MONO_TIGHT="${local_mono_base}_tight.png"
-    log_ok "Monochrome master (for ic_launcher_monochrome + ic_stat_notify): $MONO_TIGHT"
-  fi
-else
-  log_info "[dry-run] would prepare: $MASTER_SQUARE + $MASTER_TIGHT"
-  [[ -n "$MONOCHROME_MASTER" ]] && log_info "[dry-run] would prepare monochrome master from: $MONOCHROME_MASTER"
-fi
-
-# Resolve target paths based on project layout
-case "$PROJECT_TYPE" in
-  alloy)   ANDROID_RES="$OUTPUT/app/platform/android/res" ;;
-  classic) ANDROID_RES="$OUTPUT/platform/android/res" ;;
-  *)       ANDROID_RES="$OUTPUT/standalone/platform/android/res" ;;
-esac
-ROOT_STAGING="$OUTPUT"
-
-log_step "4/6 Generating iOS master + marketplace artwork (square)"
-if [[ $DRY_RUN -eq 0 ]]; then
-  gen_ios "$MASTER_TIGHT" "$BG_COLOR" "$IOS_PADDING" "$ROOT_STAGING"
-  gen_marketplace "$MASTER_TIGHT" "$BG_COLOR" "$IOS_PADDING" "$ROOT_STAGING" "$BG_COLOR_EXPLICIT"
-else
-  log_info "[dry-run] would emit DefaultIcon.png, DefaultIcon-ios.png, iTunesConnect.png, MarketplaceArtwork.png"
-fi
-
-log_step "5/6 Generating Android adaptive + legacy launcher icons (tight)"
-if [[ $DRY_RUN -eq 0 ]]; then
-  gen_android_adaptive "$MASTER_TIGHT" "$BG_COLOR" "$PADDING" "$ANDROID_RES" "$MONO_TIGHT"
-  gen_android_legacy "$MASTER_TIGHT" "$BG_COLOR" "$PADDING" "$ANDROID_RES"
-  cp "$ASSETS_DIR/ic_launcher.xml" "$ANDROID_RES/mipmap-anydpi-v26/ic_launcher.xml"
-  log_ok "Adaptive icon XML bind: $ANDROID_RES/mipmap-anydpi-v26/ic_launcher.xml"
-else
-  log_info "[dry-run] would emit adaptive + legacy icons × 5 densities"
-fi
-
-if [[ $WITH_NOTIFICATION -eq 1 || $WITH_SPLASH_ICON -eq 1 ]]; then
-  log_step "6/6 Generating optional extras"
-  if [[ $WITH_NOTIFICATION -eq 1 && $DRY_RUN -eq 0 ]]; then
-    # Use monochrome master if provided, else fall back to main (whitened by the generator).
-    gen_notification "${MONO_TIGHT:-$MASTER_TIGHT}" "$ANDROID_RES"
-  elif [[ $WITH_NOTIFICATION -eq 1 ]]; then
-    log_info "[dry-run] would emit ic_stat_notify.png × 5 densities"
-  fi
-  if [[ $WITH_SPLASH_ICON -eq 1 && $DRY_RUN -eq 0 ]]; then
-    gen_splash_icon "$MASTER_TIGHT" "$ANDROID_RES"
-  elif [[ $WITH_SPLASH_ICON -eq 1 ]]; then
-    log_info "[dry-run] would emit splash_icon.png × 5 densities"
-  fi
-else
-  log_step "6/6 (skipped — no optional extras requested)"
-fi
-
-if [[ $CLEANUP_LEGACY -eq 1 ]]; then
-  log_step "Cleanup legacy artifacts"
-  cleanup_legacy "$PROJECT_ROOT" "$PROJECT_TYPE" "$AGGRESSIVE" "$DRY_RUN"
-fi
-
-log_step "Done"
-if [[ $DRY_RUN -eq 0 ]]; then
-  # In --in-place mode, intermediate master files (_master_square.png /
-  # _master_tight.png) land directly in the project root alongside the real
-  # branded assets. Clean them up so the user is only left with the 4 icons.
-  if [[ $IS_IN_PLACE -eq 1 ]]; then
-    rm -f "$OUTPUT/_master_square.png" "$OUTPUT/_master_tight.png"
-    log_ok "All assets written IN PLACE at: $PROJECT_ROOT"
-  else
-    log_ok "All assets staged at: $OUTPUT"
-  fi
-
-  # ---------------------------------------------------------------------------
-  # Post-generation output — compact summary by default, full notes with --notes.
-  # ---------------------------------------------------------------------------
-
-  if [[ $NOTES -eq 0 ]]; then
-    # Compact summary — only config/destination + 3-line next steps + hint.
-    echo
-    echo "${C_BOLD}Summary${C_RESET}"
-    echo "  Background:   ${BG_COLOR}   Padding: Android ${PADDING}% / iOS ${IOS_PADDING}%"
-    if [[ $IS_IN_PLACE -eq 1 ]]; then
-      echo "  Written in place to: $PROJECT_ROOT"
-    else
-      echo "  Staged at:    $OUTPUT"
-    fi
-    echo
-    echo "${C_BOLD}Next steps${C_RESET}"
-    if [[ $IS_IN_PLACE -eq 1 ]]; then
-      echo "  • Preview the new icons in ${C_YELLOW}Preview.app${C_RESET}."
-      echo "  • If something looks wrong: ${C_DIM}git checkout -- .${C_RESET}"
-      echo "  • Rebuild: ${C_DIM}ti clean && ti build -p android -T emulator${C_RESET}"
-    else
-      case "$PROJECT_TYPE" in
-        alloy)
-          echo "  • Preview in ${C_YELLOW}Preview.app${C_RESET}, then copy to project:"
-          echo "      ${C_DIM}cp $OUTPUT/{DefaultIcon,DefaultIcon-ios,iTunesConnect,MarketplaceArtwork}.png $PROJECT_ROOT/${C_RESET}"
-          echo "      ${C_DIM}cp -R $OUTPUT/app/platform/android/res/. $PROJECT_ROOT/app/platform/android/res/${C_RESET}"
-          ;;
-        classic)
-          echo "  • Preview in ${C_YELLOW}Preview.app${C_RESET}, then copy to project:"
-          echo "      ${C_DIM}cp $OUTPUT/{DefaultIcon,DefaultIcon-ios,iTunesConnect,MarketplaceArtwork}.png $PROJECT_ROOT/${C_RESET}"
-          echo "      ${C_DIM}cp -R $OUTPUT/platform/android/res/. $PROJECT_ROOT/platform/android/res/${C_RESET}"
-          ;;
-        *)
-          echo "  • Review ${C_YELLOW}$OUTPUT/${C_RESET} and copy files to their final paths manually."
-          ;;
-      esac
-      echo "  • Cleanup staging: ${C_DIM}rm -rf $OUTPUT${C_RESET}"
-    fi
-    echo
-    log_info "Pass ${C_BOLD}--notes${C_RESET} to print tiapp.xml snippets + padding tuning guide."
-    echo
-    exit 0
-  fi
-
-  # ---------------------------------------------------------------------------
-  # Full notes (with --notes) — tiapp.xml snippets, padding tuning, etc.
-  # ---------------------------------------------------------------------------
-
-  echo
-  echo "${C_BOLD}Notes on what was generated${C_RESET}"
-  echo
-  echo "  • Brand color ${BG_COLOR} was baked into Android adaptive background layer"
-  echo "    and iOS/marketplace flattened masters (Apple rejects alpha)."
-  echo "  • Android padding:  ${PADDING}%  (logo fills $((100 - 2 * PADDING))% of each mipmap canvas)"
-  echo "  • iOS padding:      ${IOS_PADDING}%  (logo fills $((100 - 2 * IOS_PADDING))% of DefaultIcon-ios and marketplace art)"
-  echo
-  echo "  If the logo looks ${C_DIM}pegado / cramped${C_RESET}: re-run with higher padding"
-  echo "      --padding ${C_YELLOW}25-30${C_RESET}      (Android)"
-  echo "      --ios-padding ${C_YELLOW}8-12${C_RESET}   (iOS)"
-  echo
-  echo "  If the logo looks ${C_DIM}too small / lost${C_RESET}: re-run with lower padding"
-  echo "      --padding ${C_YELLOW}19${C_RESET}         (Android spec floor)"
-  echo "      --ios-padding ${C_YELLOW}2-3${C_RESET}    (matches first-party apps like Mail, Safari)"
-
-  echo
-  echo "${C_BOLD}Configuration reminders${C_RESET}"
-  echo "  ${C_DIM}The skill does NOT auto-create XML resource files or edit tiapp.xml.${C_RESET}"
-  echo "  ${C_DIM}Every snippet below is optional — paste only what you need, after reviewing.${C_RESET}"
-  echo
-  echo "  ${C_YELLOW}⚠${C_RESET}  ${C_BOLD}tiapp.xml <application> tag may be self-closing${C_RESET}"
-  echo "     If yours looks like:"
-  echo "         ${C_DIM}<application android:icon=\"@mipmap/ic_launcher\" .../>${C_RESET}"
-  echo "     You must expand it BEFORE adding children:"
-  echo "         ${C_DIM}<application android:icon=\"@mipmap/ic_launcher\" ...>${C_RESET}"
-  echo "         ${C_DIM}  <meta-data .../>${C_RESET}"
-  echo "         ${C_DIM}</application>${C_RESET}"
-  echo
-  echo "  ${C_BOLD}1. iOS launch background${C_RESET} — under ${C_YELLOW}<ios>${C_RESET} in tiapp.xml:"
-  echo "  ${C_DIM}Matches your --bg-color to the launch storyboard.${C_RESET}"
-  cat <<EOF
-      <ios>
-        <enable-launch-screen-storyboard>true</enable-launch-screen-storyboard>
-        <default-background-color>${BG_COLOR}</default-background-color>
-      </ios>
-EOF
-  echo
-  echo "  ${C_BOLD}2. Android launcher icon${C_RESET} — under ${C_YELLOW}<android><manifest><application>${C_RESET}:"
-  echo "  ${C_DIM}Required for the adaptive icon you just generated to be used.${C_RESET}"
-  cat <<'EOF'
-      <application android:icon="@mipmap/ic_launcher"
-                   android:usesCleartextTraffic="false"/>
-EOF
-
-  if [[ $WITH_SPLASH_ICON -eq 1 ]]; then
-    echo
-    echo "  ${C_BOLD}3. Android 12+ splash screen — OPTIONAL, advanced${C_RESET}"
-    echo
-    echo "  Titanium SDK 13.x shows a system splash automatically using your launcher"
-    echo "  icon. ${C_YELLOW}For most apps THE DEFAULT IS ENOUGH — do nothing.${C_RESET}"
-    echo
-    echo "  If you experience a visible ${C_BOLD}FLICKER${C_RESET} at the end of the splash (brief"
-    echo "  color flash before index.js renders), that is the system splash background"
-    echo "  mismatching your first Titanium activity background."
-    echo
-    echo "  Fixing it requires adding a custom theme + wiring it in tiapp.xml. This is"
-    echo "  ${C_BOLD}INVASIVE${C_RESET} — do NOT auto-apply the snippet below without:"
-    echo "    ${C_DIM}(a) verifying the parent theme you pick actually exists in your${C_RESET}"
-    echo "    ${C_DIM}    Titanium SDK version (theme names vary across SDK releases)${C_RESET}"
-    echo "    ${C_DIM}(b) checking whether your project already has a custom theme —${C_RESET}"
-    echo "    ${C_DIM}    if so, EXTEND it instead of overriding via android:theme${C_RESET}"
-    echo "    ${C_DIM}(c) testing the build succeeds before committing tiapp.xml${C_RESET}"
-    echo
-    echo "  ${C_DIM}Template (verify parent theme exists in your SDK before using):${C_RESET}"
-    cat <<EOF
-      <!-- app/platform/android/res/values/splash_theme.xml -->
-      <?xml version="1.0" encoding="utf-8"?>
-      <resources>
-        <style name="Theme.App.Splash" parent="@style/YOUR_APP_PARENT_THEME">
-          <item name="android:windowSplashScreenBackground">${BG_COLOR}</item>
-          <item name="android:windowSplashScreenAnimatedIcon">@mipmap/ic_launcher</item>
-        </style>
-      </resources>
-EOF
-    echo
-    echo "  ${C_BOLD}Known-working parent${C_RESET} (confirmed in Titanium SDK 13.2.0):"
-    echo "    ${C_DIM}@style/Theme.Titanium.Light.Fullscreen${C_RESET}"
-    echo
-    echo "  If your SDK does not expose Theme.Titanium.Light.Fullscreen, check the"
-    echo "  styles.xml shipped with your installed SDK under the android/ folder —"
-    echo "  the available parent themes vary across SDK versions."
-    echo
-    echo "  ${C_YELLOW}⚠${C_RESET} Do NOT inherit from ${C_DIM}@android:style/Theme.DeviceDefault.NoActionBar${C_RESET}."
-    echo "  That parent strips the ActionBar from every screen in your app."
-    echo
-    echo "  ${C_DIM}The splash_icon.png × 5 files are generated for advanced use (custom${C_RESET}"
-    echo "  ${C_DIM}splash icon distinct from launcher). Most apps do NOT need them —${C_RESET}"
-    echo "  ${C_DIM}Titanium falls back to the launcher icon for the system splash.${C_RESET}"
-  fi
-
-  if [[ $WITH_NOTIFICATION -eq 1 ]]; then
-    case "$PROJECT_TYPE" in
-      alloy)   COLORS_DIR="app/platform/android/res/values" ;;
-      classic) COLORS_DIR="platform/android/res/values" ;;
-      *)       COLORS_DIR="platform/android/res/values" ;;
-    esac
-    echo
-    echo "  ${C_BOLD}4. FCM notification icon + tint${C_RESET}"
-    echo "  ${C_DIM}Only needed if you use firebase.cloudmessaging for push. The white-on-${C_RESET}"
-    echo "  ${C_DIM}transparent icon was generated; you still need to wire it.${C_RESET}"
-    echo
-    echo "  ${C_DIM}Create ${COLORS_DIR}/colors.xml (if missing) or merge into existing:${C_RESET}"
-    cat <<EOF
-      <?xml version="1.0" encoding="utf-8"?>
-      <resources>
-        <color name="notification_tint">${BG_COLOR}</color>
-      </resources>
-EOF
-    echo
-    echo "  ${C_DIM}Then under <android><manifest><application> in tiapp.xml:${C_RESET}"
-    cat <<'EOF'
-      <meta-data android:name="com.google.firebase.messaging.default_notification_icon"
-                 android:resource="@drawable/ic_stat_notify"/>
-      <meta-data android:name="com.google.firebase.messaging.default_notification_color"
-                 android:resource="@color/notification_tint"/>
-EOF
-  fi
-
-  echo
-  echo "${C_BOLD}Next steps${C_RESET}"
-  echo
-  if [[ $IS_IN_PLACE -eq 1 ]]; then
-    echo "  1. Preview the new icons in ${C_YELLOW}Preview.app${C_RESET} — the files in your project"
-    echo "     were overwritten directly (no staging directory was used)."
-    echo "  2. If something looks wrong, restore from git:  ${C_DIM}git checkout -- .${C_RESET}"
-    echo "  3. Rebuild:           ${C_DIM}ti clean && ti build -p android -T emulator${C_RESET}"
-  else
-    echo "  1. Preview in ${C_YELLOW}Preview.app${C_RESET} (never use ${C_DIM}open${C_RESET} without -a — triggers heavy editors)"
-  case "$PROJECT_TYPE" in
-    alloy)
-      echo "  2. If good, copy to project:"
-      echo "       cp $OUTPUT/DefaultIcon.png $OUTPUT/DefaultIcon-ios.png $OUTPUT/iTunesConnect.png $OUTPUT/MarketplaceArtwork.png $PROJECT_ROOT/"
-      echo "       cp -R $OUTPUT/app/platform/android/res/. $PROJECT_ROOT/app/platform/android/res/"
-      ;;
-    classic)
-      echo "  2. If good, copy to project:"
-      echo "       cp $OUTPUT/DefaultIcon.png $OUTPUT/DefaultIcon-ios.png $OUTPUT/iTunesConnect.png $OUTPUT/MarketplaceArtwork.png $PROJECT_ROOT/"
-      echo "       cp -R $OUTPUT/platform/android/res/. $PROJECT_ROOT/platform/android/res/"
-      ;;
-    *)
-      echo "  2. Review staging dir and copy files to their final paths manually."
-      ;;
-  esac
-    echo "  3. Cleanup staging:   rm -rf $OUTPUT"
-    echo "  4. Rebuild:           ${C_DIM}ti clean && ti build -p android -T emulator${C_RESET}"
-  fi
-  echo
-else
-  log_info "Dry-run complete. Re-run without --dry-run to write files."
-fi