purgetss 7.7.0 → 7.7.1

package/README.md

@@ -17,7 +17,7 @@
 - 23,300+ utility classes for styling Titanium views
 - Parses XML files to generate a clean `app.tss` with only the classes your project uses
 - Customizable defaults via `config.cjs`, with JIT classes for arbitrary values
-- `brand` command for Titanium icons and branding assets, including Android launcher variants, optional Android 12+ splash artwork, and legacy `default.png` fallback generation
+- `brand` command for Titanium icons and branding assets, focused on the modern Titanium icon pipeline: Android adaptive icons, iOS icon variants, optional Android 12+ splash artwork, and a minimal `default.png` compatibility fallback
 - Icon font support: Font Awesome, Material Icons, Material Symbols, Framework7-Icons
 - `build-fonts` command generates `fonts.tss` with class definitions and fontFamily selectors
 - `shades` command generates color shades from any hex color
@@ -384,6 +384,8 @@ Button: {
 - `brand` regenerates `app/assets/android/default.png` in Alloy projects, or `Resources/android/default.png` in Classic projects, so older Android splash paths still have a fallback.
 - `cleanup-legacy` no longer removes `default.png`.
 - Branding help and docs now spell out the difference between Android launcher icons, Android 12+ `splash_icon.png`, and legacy Android splash assets.
+- `--notes` is explicit that `tiapp.xml` is not auto-edited and that apps with an existing custom Android theme should merge splash snippets into that theme instead of replacing it.
+- `brand` does not try to manage older Android splash theme assets such as `background.png` or `background.9.png`; if a project still depends on them, that remains manual by design.
 
 See the full release notes in [CHANGELOG.md](./CHANGELOG.md).
 

package/bin/purgetss

@@ -273,18 +273,25 @@ The recommended workflow is: put files in ${chalk.cyan('purgetss/brand/')}, then
 CLI flags always win over config values.
 
 Generates:
-  ${chalk.yellow('DefaultIcon.png')} / ${chalk.yellow('DefaultIcon-ios.png')}              Root icons (alpha + flattened)
-  ${chalk.yellow('DefaultIcon-Dark.png')} / ${chalk.yellow('DefaultIcon-Tinted.png')}     iOS 18+ variants (Apple HIG specs)
-  ${chalk.yellow('iTunesConnect.png')} / ${chalk.yellow('MarketplaceArtwork.png')}       App Store + Play Store artwork
+  ${chalk.yellow('DefaultIcon.png')}/${chalk.yellow('DefaultIcon-ios.png')}                          Root icons (alpha + flattened)
+  ${chalk.yellow('DefaultIcon-Dark.png')}/${chalk.yellow('DefaultIcon-Tinted.png')}                  iOS 18+ variants (Apple HIG specs)
+  ${chalk.yellow('iTunesConnect.png')}/${chalk.yellow('MarketplaceArtwork.png')}                     App Store + Play Store artwork
   ${chalk.yellow('mipmap-*/ic_launcher_{foreground,background,monochrome}.png')}  Android adaptive × 5
-  ${chalk.yellow('mipmap-*/ic_launcher.png')}                           Android legacy × 5
-  ${chalk.yellow('mipmap-anydpi-v26/ic_launcher.xml')}                  Adaptive icon binder
-  ${chalk.yellow('drawable-*/splash_icon.png')}                         Android 12+ splash icon (with ${chalk.cyan('--splash')})
-  ${chalk.yellow('app/assets/android/default.png')}                     Android <12 legacy splash fallback
+  ${chalk.yellow('mipmap-*/ic_launcher.png')}                                     Android legacy × 5
+  ${chalk.yellow('mipmap-anydpi-v26/ic_launcher.xml')}                            Adaptive icon binder
+  ${chalk.yellow('drawable-*/splash_icon.png')}                                   Android 12+ splash icon (with ${chalk.cyan('--splash')})
+  ${chalk.yellow('app/assets/android/default.png')}                               Android <12 compatibility fallback
 
 Android dark/light mode is handled by the ${chalk.yellow('monochrome')} adaptive layer
 (Android 13+ tints it from the wallpaper + theme). No separate dark file exists.
 
+Scope:
+  ${chalk.green('brand')} targets the modern Titanium icon pipeline: iOS app icons,
+  Android adaptive icons, and optional Android 12+ splash artwork.
+  Older Android splash themes such as ${chalk.yellow('background.png')} / ${chalk.yellow('background.9.png')}
+  are outside the normal scope of this command and should be managed manually
+  if a project still depends on them.
+
 Examples:
   ${chalk.cyan('purgetss brand')}                                           # uses purgetss/brand/logo.svg + config
   ${chalk.cyan('purgetss brand')} logo.svg                                  # explicit logo path

package/dist/purgetss.ui.js

@@ -1,4 +1,4 @@
-// PurgeTSS v7.7.0
+// PurgeTSS v7.7.1
 // Created by César Estrada
 // https://purgetss.com
 

package/lib/templates/purgetss.config.js.cjs

@@ -13,15 +13,7 @@ module.exports = {
     }
   },
   brand: {
-    logos: {
-      // Optional overrides. If omitted, PurgeTSS auto-discovers files from purgetss/brand/:
-      // primary: './docs/logo.svg',
-      // androidLauncher: './docs/app-icon.svg',
-      // androidSplash: './docs/splash.svg',
-      // monochrome: './docs/logo-mono.svg',
-      // iosDark: './docs/logo-dark.svg',
-      // iosTinted: './docs/logo-tinted.svg'
-    },
+    logos: {},               // empty = auto-discovers from purgetss/brand/
     padding: {
       ios: '4%',             // iOS aesthetic. Range: 2% bold — 8% conservative. No launcher mask.
       androidLegacy: '10%',  // legacy ic_launcher.png padding
@@ -31,15 +23,14 @@ module.exports = {
       splash: false,         // also generate splash_icon.png × 5
       notification: false    // also generate ic_stat_notify.png × 5
     },
+    ios: {
+      dark: true,            // generate iOS 18+ Dark appearance icon
+      tinted: true,          // generate iOS 18+ Tinted appearance icon
+      darkBackground: null   // null = transparent per Apple HIG
+    },
     colors: {
       background: '#FFFFFF'  // Android adaptive bg + iOS/marketplace flatten
     },
-    // Optional iOS overrides:
-    // ios: {
-    //   dark: false,
-    //   tinted: false,
-    //   darkBackground: '#111111'
-    // },
     confirmOverwrites: true  // prompt before overwriting files (set false to skip)
   },
   images: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "purgetss",
-  "version": "7.7.0",
+  "version": "7.7.1",
   "main": "src/index.js",
   "bin": {
     "purgetss": "bin/purgetss"

package/src/core/branding/ensure-brand-section.js

@@ -23,15 +23,7 @@ import { projectsConfigJS, projectsPurge_TSS_Brand_Folder } from '../../shared/c
 import { logger } from './branding-logger.js'
 
 const BRAND_BLOCK = `  brand: {
-    logos: {
-      // Optional overrides. If omitted, PurgeTSS auto-discovers files from purgetss/brand/:
-      // primary: './docs/logo.svg',
-      // androidLauncher: './docs/app-icon.svg',
-      // androidSplash: './docs/splash.svg',
-      // monochrome: './docs/logo-mono.svg',
-      // iosDark: './docs/logo-dark.svg',
-      // iosTinted: './docs/logo-tinted.svg'
-    },
+    logos: {},               // empty = auto-discovers from purgetss/brand/
     padding: {
       ios: '4%',             // iOS aesthetic. Range: 2% bold — 8% conservative. No launcher mask.
       androidLegacy: '10%',  // legacy ic_launcher.png padding
@@ -41,15 +33,14 @@ const BRAND_BLOCK = `  brand: {
       splash: false,         // also generate splash_icon.png × 5
       notification: false    // also generate ic_stat_notify.png × 5
     },
+    ios: {
+      dark: true,            // generate iOS 18+ Dark appearance icon
+      tinted: true,          // generate iOS 18+ Tinted appearance icon
+      darkBackground: null   // null = transparent per Apple HIG
+    },
     colors: {
       background: '#FFFFFF'  // Android adaptive bg + iOS/marketplace flatten
     },
-    // Optional iOS overrides:
-    // ios: {
-    //   dark: false,
-    //   tinted: false,
-    //   darkBackground: '#111111'
-    // },
     confirmOverwrites: true  // prompt before overwriting files (set false to skip)
   },
 `

package/src/core/branding/post-gen-notes.js

@@ -84,6 +84,10 @@ function printFullNotes(opts) {
   logger.section('Configuration reminders')
   console.log('  The tool does NOT auto-edit tiapp.xml. Snippets below are optional —')
   console.log('  paste only what you need, after reviewing.')
+  console.log('  If your app already uses a custom Android theme, merge these changes')
+  console.log('  into that theme instead of replacing it blindly.')
+  console.log('  brand is designed around the modern Titanium icon pipeline, not around')
+  console.log('  older Android splash themes such as background.png / background.9.png.')
   console.log()
   console.log(`  ${chalk.yellow('⚠')}  ${chalk.yellow('tiapp.xml <application> tag may be self-closing')}`)
   console.log('     If yours looks like:')
@@ -114,14 +118,18 @@ function printFullNotes(opts) {
     console.log('     If you want the Android 12+ splash to use splash_icon instead of')
     console.log('     ic_launcher, add a custom theme and point')
     console.log(code('       <item name="android:windowSplashScreenAnimatedIcon">@drawable/splash_icon</item>'))
+    console.log('     If you still see a brief flash during splash exit, the artifact may')
+    console.log('     come from Titanium or the system splash transition rather than from')
+    console.log('     the generated PNG assets themselves.')
   }
 
   console.log()
   console.log(`  ${num(withSplash ? '4.' : '3.')} ${chalk.cyan('Android <12 legacy splash')}`)
-  console.log('     PurgeTSS brand now regenerates app/assets/android/default.png as')
-  console.log('     a legacy fallback splash for Titanium projects.')
-  console.log('     If your app uses a custom windowBackground / background.9.png theme,')
-  console.log('     that custom theme still takes precedence.')
+  console.log('     PurgeTSS brand still regenerates app/assets/android/default.png as')
+  console.log('     a compatibility fallback while Titanium continues to recognize it.')
+  console.log('     It is not the primary modern path. If your app uses a custom')
+  console.log('     windowBackground / background.9.png theme, that custom theme still')
+  console.log('     takes precedence and should be managed manually.')
 
   if (withNotification) {
     const colorsDir = projectType === 'classic'