@maccesar/titools 2.7.2 → 2.8.0

package/skills/ti-branding/scripts/lib/deps.sh

@@ -1,58 +0,0 @@
-#!/usr/bin/env bash
-# deps.sh — detect required system tools and guide installation.
-
-check_deps() {
-  local master="$1"
-  local need_rsvg=0
-  local missing=()
-
-  local master_lower
-  master_lower=$(printf '%s' "$master" | tr '[:upper:]' '[:lower:]')
-  case "$master_lower" in
-    *.svg) need_rsvg=1 ;;
-  esac
-
-  if ! command -v magick >/dev/null 2>&1; then
-    missing+=("imagemagick")
-  fi
-
-  if [[ $need_rsvg -eq 1 ]] && ! command -v rsvg-convert >/dev/null 2>&1; then
-    missing+=("librsvg")
-  fi
-
-  if [[ ${#missing[@]} -eq 0 ]]; then
-    log_ok "All dependencies present: $(magick -version | head -1 | awk '{print $2,$3}')"
-    [[ $need_rsvg -eq 1 ]] && log_ok "librsvg: $(rsvg-convert --version | head -1)"
-    return 0
-  fi
-
-  log_err "Missing required tools: ${missing[*]}"
-  echo
-  echo "Install with one of:"
-  local os="$(uname -s)"
-  case "$os" in
-    Darwin)
-      echo "  macOS:      brew install ${missing[*]}"
-      ;;
-    Linux)
-      if command -v apt >/dev/null 2>&1; then
-        local apt_pkgs=()
-        for m in "${missing[@]}"; do
-          case "$m" in
-            imagemagick) apt_pkgs+=("imagemagick") ;;
-            librsvg)     apt_pkgs+=("librsvg2-bin") ;;
-          esac
-        done
-        echo "  Ubuntu:     sudo apt install ${apt_pkgs[*]}"
-      elif command -v pacman >/dev/null 2>&1; then
-        echo "  Arch:       sudo pacman -S ${missing[*]}"
-      elif command -v dnf >/dev/null 2>&1; then
-        echo "  Fedora:     sudo dnf install ${missing[*]}"
-      fi
-      ;;
-  esac
-  echo "  Windows:    choco install ${missing[*]}"
-  echo
-  echo "After installing, re-run this command."
-  exit 1
-}

package/skills/ti-branding/scripts/lib/gen-android-adaptive.sh

@@ -1,64 +0,0 @@
-#!/usr/bin/env bash
-# gen-android-adaptive.sh — produce the adaptive icon triplet (foreground +
-# background + monochrome) at 5 densities.
-#
-# Android adaptive icon: 108×108dp canvas, 66×66dp safe-zone.
-# Densities: mdpi=108px, hdpi=162, xhdpi=216, xxhdpi=324, xxxhdpi=432.
-#
-# Foreground: logo centered inside safe-zone, transparent outside.
-# Background: solid color (or pattern) filling the full canvas.
-# Monochrome: foreground silhouette in pure white with preserved alpha — Android
-#             applies themed tint at runtime on API 31+.
-
-gen_android_adaptive() {
-  local master="$1"
-  local bg="$2"
-  local padding="$3"        # percent per side
-  local res_root="$4"       # e.g. /path/app/platform/android/res
-  local mono_master="${5:-}" # optional dedicated silhouette master
-
-  local densities=(mdpi hdpi xhdpi xxhdpi xxxhdpi)
-  local sizes=(108 162 216 324 432)
-
-  for i in "${!densities[@]}"; do
-    local d="${densities[$i]}"
-    local size="${sizes[$i]}"
-    local inner=$(( size * (100 - 2 * padding) / 100 ))
-    local dir="$res_root/mipmap-$d"
-    mkdir -p "$dir"
-
-    # Foreground: logo centered, padded, transparent outside
-    magick "$master" \
-      -resize "${inner}x${inner}" \
-      -background none -gravity center -extent "${size}x${size}" \
-      -strip \
-      "$dir/ic_launcher_foreground.png"
-
-    # Background: solid color
-    magick -size "${size}x${size}" "xc:$bg" \
-      -strip \
-      "$dir/ic_launcher_background.png"
-
-    # Monochrome: white silhouette with alpha. If a dedicated mono master was
-    # provided, render it fresh with the same padding. Otherwise derive from
-    # the colored foreground (naive whitening — may flatten complex logos).
-    if [[ -n "$mono_master" ]]; then
-      magick "$mono_master" \
-        -resize "${inner}x${inner}" \
-        -background none -gravity center -extent "${size}x${size}" \
-        -channel RGB -fill white -colorize 100 +channel \
-        -strip \
-        "$dir/ic_launcher_monochrome.png"
-    else
-      magick "$dir/ic_launcher_foreground.png" \
-        -channel RGB -fill white -colorize 100 +channel \
-        -strip \
-        "$dir/ic_launcher_monochrome.png"
-    fi
-  done
-
-  # anydpi-v26 binder directory (XML copied by caller from assets/ic_launcher.xml)
-  mkdir -p "$res_root/mipmap-anydpi-v26"
-
-  log_ok "Adaptive icons: foreground + background + monochrome × 5 densities"
-}

package/skills/ti-branding/scripts/lib/gen-android-legacy.sh

@@ -1,36 +0,0 @@
-#!/usr/bin/env bash
-# gen-android-legacy.sh — produce the flat ic_launcher.png for pre-adaptive Android
-# (API 21–25, ~3% of users in 2026). Composites foreground over background and
-# scales down to the legacy density sizes.
-#
-# Legacy densities: mdpi=48px, hdpi=72, xhdpi=96, xxhdpi=144, xxxhdpi=192.
-
-gen_android_legacy() {
-  local master="$1"
-  local bg="$2"
-  local padding="$3"
-  local res_root="$4"
-
-  local densities=(mdpi hdpi xhdpi xxhdpi xxxhdpi)
-  local sizes=(48 72 96 144 192)
-
-  for i in "${!densities[@]}"; do
-    local d="${densities[$i]}"
-    local size="${sizes[$i]}"
-    # Legacy icons are displayed as-drawn (no adaptive mask), so we can fill more of
-    # the canvas. Reduce the padding by ~40% for the legacy composite.
-    local legacy_padding=$(( padding * 60 / 100 ))
-    local inner=$(( size * (100 - 2 * legacy_padding) / 100 ))
-    local dir="$res_root/mipmap-$d"
-    mkdir -p "$dir"
-
-    # Compose: solid bg + logo centered
-    magick -size "${size}x${size}" "xc:$bg" \
-      \( "$master" -resize "${inner}x${inner}" \) \
-      -gravity center -composite \
-      -strip \
-      "$dir/ic_launcher.png"
-  done
-
-  log_ok "Legacy ic_launcher.png × 5 densities (fallback for Android <8)"
-}

package/skills/ti-branding/scripts/lib/gen-ios.sh

@@ -1,46 +0,0 @@
-#!/usr/bin/env bash
-# gen-ios.sh — produce Titanium's two root-level iOS/Android icons:
-#
-#   DefaultIcon.png       1024×1024, alpha preserved (universal / Android source)
-#   DefaultIcon-ios.png   1024×1024, alpha flattened over bg-color (iOS)
-#
-# This matches what `titanium` / `alloy new` ships out of the box: a fresh
-# Alloy project contains both files in the project root, with DefaultIcon.png
-# keeping transparency and DefaultIcon-ios.png flattened (Apple rejects alpha
-# on App Store icon uploads).
-#
-# Padding is purely visual breathing room — iOS app icons have no launcher
-# mask. Default 8% per side (logo fills 84% of the canvas), which matches
-# Apple's HIG aesthetic for branded wordmarks.
-
-gen_ios() {
-  local tight="$1"        # tight master (aspect-preserved, transparent bg)
-  local bg="$2"
-  local padding="$3"      # iOS padding percent per side (default 8)
-  local out_root="$4"
-
-  mkdir -p "$out_root"
-
-  local size=1024
-  local inner=$(( size * (100 - 2 * padding) / 100 ))
-
-  # DefaultIcon.png — alpha preserved (matches `ti create` default for the
-  # universal icon source; Alloy/Android use this directly).
-  magick "$tight" \
-    -resize "${inner}x${inner}" \
-    -background none -gravity center -extent "${size}x${size}" \
-    -strip \
-    "$out_root/DefaultIcon.png"
-
-  # DefaultIcon-ios.png — flattened over bg-color. This is the file iOS
-  # actually ships; Apple rejects alpha on App Store icon uploads.
-  magick "$tight" \
-    -resize "${inner}x${inner}" \
-    -background none -gravity center -extent "${size}x${size}" \
-    -background "$bg" -alpha remove -alpha off \
-    -strip \
-    "$out_root/DefaultIcon-ios.png"
-
-  log_ok "DefaultIcon.png (1024×1024, ${padding}% padding, alpha preserved)"
-  log_ok "DefaultIcon-ios.png (1024×1024, ${padding}% padding, alpha flattened over $bg)"
-}

package/skills/ti-branding/scripts/lib/gen-marketplace.sh

@@ -1,55 +0,0 @@
-#!/usr/bin/env bash
-# gen-marketplace.sh — store-submission artwork.
-#
-#   iTunesConnect.png      1024×1024 (App Store)
-#   MarketplaceArtwork.png 512×512   (Google Play)
-#
-# Alpha handling depends on whether --bg-color was EXPLICITLY provided
-# (tracked via the 5th argument, `flatten`):
-#   - flatten=0 (no --bg-color) → alpha preserved, matches `ti create` default
-#   - flatten=1 (--bg-color X)  → alpha flattened on bg-color. Prevents the
-#                                  dark-mode-muddy-icon issue on Play Store
-#                                  and macOS App Store when the master has
-#                                  significant transparent areas.
-#
-# Uses the same --ios-padding as the iOS master (default 8%) so the three
-# square icons share the same visual weight.
-
-gen_marketplace() {
-  local tight="$1"
-  local bg="$2"
-  local padding="$3"      # ios-padding percent per side
-  local out_root="$4"
-  local flatten="${5:-0}" # 1 when --bg-color was explicitly provided
-
-  mkdir -p "$out_root"
-
-  local flatten_args=()
-  local alpha_label="alpha"
-  if [[ "$flatten" == "1" ]]; then
-    flatten_args=(-background "$bg" -alpha remove -alpha off)
-    alpha_label="flat on $bg"
-  fi
-
-  # App Store (1024²)
-  local size_ios=1024
-  local inner_ios=$(( size_ios * (100 - 2 * padding) / 100 ))
-  magick "$tight" \
-    -resize "${inner_ios}x${inner_ios}" \
-    -background none -gravity center -extent "${size_ios}x${size_ios}" \
-    "${flatten_args[@]}" \
-    -strip \
-    "$out_root/iTunesConnect.png"
-
-  # Google Play (512²)
-  local size_play=512
-  local inner_play=$(( size_play * (100 - 2 * padding) / 100 ))
-  magick "$tight" \
-    -resize "${inner_play}x${inner_play}" \
-    -background none -gravity center -extent "${size_play}x${size_play}" \
-    "${flatten_args[@]}" \
-    -strip \
-    "$out_root/MarketplaceArtwork.png"
-
-  log_ok "Marketplace artwork: iTunesConnect.png (1024², ${padding}% padding, ${alpha_label}), MarketplaceArtwork.png (512², ${padding}% padding, ${alpha_label})"
-}

package/skills/ti-branding/scripts/lib/gen-notification.sh

@@ -1,46 +0,0 @@
-#!/usr/bin/env bash
-# gen-notification.sh — white-on-transparent notification icons at 5 densities.
-# Android applies a runtime tint based on the notification's color property, so
-# all non-transparent pixels become white and color information is discarded.
-#
-# Sizes per Android spec: mdpi=24px, hdpi=36, xhdpi=48, xxhdpi=72, xxxhdpi=96.
-#
-# Notification icons are NOT masked by the launcher, so they render as drawn.
-# We trim any transparent padding baked into the master first, then scale the
-# logo to fill the canvas edge-to-edge on its longer axis (with a 1px
-# anti-aliasing margin per side). This matches what first-party Android apps
-# ship (Gmail, Slack, Chrome) — the logo reaches the edge instead of sitting
-# in a visibly padded box in the status bar.
-#
-# Material's 22dp-inside-24dp "live area" is a conservative guideline; in
-# practice notification icons benefit from going closer to the edge because
-# the status bar is already tiny.
-
-gen_notification() {
-  local master="$1"
-  local res_root="$2"
-
-  local densities=(mdpi hdpi xhdpi xxhdpi xxxhdpi)
-  local sizes=(24 36 48 72 96)
-
-  for i in "${!densities[@]}"; do
-    local d="${densities[$i]}"
-    local size="${sizes[$i]}"
-    # Edge-to-edge with a 1px anti-aliasing margin per side.
-    local inner=$(( size - 2 ))
-    (( inner < 1 )) && inner=1
-    local dir="$res_root/drawable-$d"
-    mkdir -p "$dir"
-
-    # Trim baked-in transparent padding from the master, then scale to inner.
-    magick "$master" \
-      -trim +repage \
-      -resize "${inner}x${inner}" \
-      -channel RGB -fill white -colorize 100 +channel \
-      -background none -gravity center -extent "${size}x${size}" \
-      -strip \
-      "$dir/ic_stat_notify.png"
-  done
-
-  log_ok "Notification icons (white+alpha, edge-to-edge) × 5 densities"
-}

package/skills/ti-branding/scripts/lib/gen-splash-icon.sh

@@ -1,31 +0,0 @@
-#!/usr/bin/env bash
-# gen-splash-icon.sh — Android 12+ SplashScreen API icon.
-# The spec: 288dp canvas, icon occupies the central 192dp (~67% of canvas).
-# The OS renders a circular mask automatically, so keep the icon transparent
-# outside the 192dp safe-zone.
-#
-# Densities: mdpi=288px, hdpi=432, xhdpi=576, xxhdpi=864, xxxhdpi=1152.
-
-gen_splash_icon() {
-  local master="$1"
-  local res_root="$2"
-
-  local densities=(mdpi hdpi xhdpi xxhdpi xxxhdpi)
-  local sizes=(288 432 576 864 1152)
-
-  for i in "${!densities[@]}"; do
-    local d="${densities[$i]}"
-    local size="${sizes[$i]}"
-    local inner=$(( size * 192 / 288 ))
-    local dir="$res_root/drawable-$d"
-    mkdir -p "$dir"
-
-    magick "$master" \
-      -resize "${inner}x${inner}" \
-      -background none -gravity center -extent "${size}x${size}" \
-      -strip \
-      "$dir/splash_icon.png"
-  done
-
-  log_ok "Android 12+ splash_icon.png × 5 densities"
-}

package/skills/ti-branding/scripts/lib/prepare-master.sh

@@ -1,48 +0,0 @@
-#!/usr/bin/env bash
-# prepare-master.sh — produces two normalized masters from the input:
-#
-#   1. <out>_square.png — 1024×1024 PNG with the logo centered in a square
-#      canvas and transparent padding added to sides (or top/bottom) to keep
-#      the logo's aspect intact. Used for iOS DefaultIcon and marketplace
-#      artwork — platforms that require square icons.
-#
-#   2. <out>_tight.png — logo rasterized at 1024-px max dimension with its
-#      native aspect preserved (no padding added). Used for Android adaptive
-#      icon generation so a horizontal wordmark can fill the safe-zone by
-#      width instead of being double-padded inside the square master.
-#
-# The skill's main script passes <out>_square.png to iOS generators and
-# <out>_tight.png to Android adaptive/legacy/notification/splash generators.
-
-prepare_master() {
-  local input="$1"
-  local base="$2"       # e.g. /path/.ti-branding/_master (no extension)
-  local square="${base}_square.png"
-  local tight="${base}_tight.png"
-  local ext="${input##*.}"
-  ext=$(printf '%s' "$ext" | tr '[:upper:]' '[:lower:]')
-
-  mkdir -p "$(dirname "$base")"
-
-  case "$ext" in
-    svg)
-      # Rasterize SVG at 2048-px max dimension preserving native aspect — this
-      # is the tight master. rsvg-convert's -a flag preserves aspect when both
-      # -w and -h are supplied, producing the larger of the two dimensions.
-      rsvg-convert -w 2048 -h 2048 -a "$input" -o "$tight.2x.png"
-      magick "$tight.2x.png" -resize "1024x1024>" -strip "$tight"
-      rm -f "$tight.2x.png"
-      ;;
-    png)
-      magick "$input" -resize "1024x1024>" -strip "$tight"
-      ;;
-  esac
-
-  # Build the square master by padding the tight master to 1024×1024 with
-  # transparency. magick's -gravity center + -extent centers the logo and
-  # distributes padding to whichever axis is shorter.
-  magick "$tight" \
-    -background none -gravity center -extent 1024x1024 \
-    -strip \
-    "$square"
-}

package/skills/ti-branding/scripts/lib/validate.sh

@@ -1,67 +0,0 @@
-#!/usr/bin/env bash
-# validate.sh — sanity-check the master input.
-
-validate_master() {
-  local master="$1"
-  local ext="${master##*.}"
-  ext=$(printf '%s' "$ext" | tr '[:upper:]' '[:lower:]')
-
-  case "$ext" in
-    svg)
-      validate_svg "$master"
-      ;;
-    png)
-      validate_png "$master"
-      ;;
-    *)
-      log_err "Unsupported format: .$ext (expected .svg or .png)"
-      exit 2
-      ;;
-  esac
-}
-
-validate_svg() {
-  local master="$1"
-  if ! grep -q "<svg" "$master" 2>/dev/null; then
-    log_err "File does not appear to be valid SVG: $master"
-    exit 2
-  fi
-
-  if grep -qE '<(script|foreignObject)' "$master" 2>/dev/null; then
-    log_warn "SVG contains <script> or <foreignObject> — may not render correctly."
-  fi
-
-  log_ok "SVG input accepted (will rasterize to 1024×1024)"
-}
-
-validate_png() {
-  local master="$1"
-  local w h
-  w=$(magick identify -format "%w" "$master" 2>/dev/null || echo 0)
-  h=$(magick identify -format "%h" "$master" 2>/dev/null || echo 0)
-
-  if [[ -z "$w" || "$w" -eq 0 ]]; then
-    log_err "Could not read PNG dimensions: $master"
-    exit 2
-  fi
-
-  if [[ "$w" -lt 1024 || "$h" -lt 1024 ]]; then
-    log_err "PNG too small: ${w}×${h}. Need at least 1024×1024 for high-density output."
-    exit 2
-  fi
-
-  if [[ "$w" -ne "$h" ]]; then
-    log_warn "PNG is not square (${w}×${h}). Will be center-cropped to square."
-  fi
-
-  local has_alpha
-  has_alpha=$(magick identify -format "%A" "$master" 2>/dev/null)
-  case "$has_alpha" in
-    True|Blend)
-      log_ok "PNG ${w}×${h} with alpha — good for monochrome layer"
-      ;;
-    *)
-      log_warn "PNG ${w}×${h} has no alpha — monochrome layer will be a square silhouette"
-      ;;
-  esac
-}