purgetss 7.5.3 → 7.6.1

package/src/core/images/index.js

@@ -0,0 +1,171 @@
+/**
+ * PurgeTSS - Images pipeline orchestrator
+ *
+ * Discovers source images (auto from `purgetss/images/` or from a user-provided
+ * path) and generates Titanium multi-density variants for Alloy or Classic
+ * projects.
+ *
+ * Layouts:
+ *   Alloy:   app/assets/android/images/res-{density}/  +  app/assets/iphone/images/
+ *   Classic: Resources/android/images/res-{density}/   +  Resources/iphone/images/
+ *
+ * Subdirectories of `purgetss/images/` are preserved in the output paths.
+ *
+ * @fileoverview Orchestrator for `purgetss images`
+ * @author César Estrada
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { logger } from '../branding/branding-logger.js'
+import { logger as mainLogger } from '../../shared/logger.js'
+import { confirmWithAlways } from '../../shared/prompt.js'
+import { setConfigProperty } from '../../shared/config-writer.js'
+import { detectProjectType } from '../branding/tiapp-reader.js'
+import { genAndroidScales, genIphoneScales } from './gen-scales.js'
+import { projectsPurge_TSS_Images_Folder } from '../../shared/constants.js'
+
+const SUPPORTED_EXTS = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif', '.svg'])
+
+export async function runImages(opts) {
+  const {
+    source,             // resolved absolute path (file or directory)
+    projectRoot = process.cwd(),
+    androidOnly = false,
+    iphoneOnly = false,
+    format = null,
+    quality = 85,
+    dryRun = false,
+    yes = false,
+    confirmOverwrites = true
+  } = opts
+
+  if (!fs.existsSync(source)) {
+    throw new Error(`Source not found: ${source}`)
+  }
+
+  const projectType = detectProjectType(projectRoot)
+  const { androidBaseDir, iphoneBaseDir } = resolveOutputDirs(projectRoot, projectType)
+
+  const files = collectImageFiles(source)
+
+  console.log()
+  mainLogger.info('Generating multi-density image variants...')
+  console.log()
+  logger.property('Project:    ', `${projectRoot} (${projectType})`)
+  logger.property('Source:     ', source)
+  logger.property('Images:     ', `${files.length} file${files.length === 1 ? '' : 's'}`)
+  const platforms = []
+  if (!iphoneOnly) platforms.push('Android (5 densities)')
+  if (!androidOnly) platforms.push('iPhone (@1x, @2x, @3x)')
+  logger.property('Platforms:  ', platforms.join(' + '))
+  if (format) logger.property('Format:     ', `convert all to ${format}`)
+  if (dryRun) logger.warning('DRY RUN — no files will be written')
+
+  if (files.length === 0) {
+    logger.warning('No images found. Put your source files inside purgetss/images/ (svg, png, jpg, jpeg, webp, gif).')
+    return { written: [] }
+  }
+
+  if (!dryRun && confirmOverwrites) {
+    logger.warning(`⚠  Scaled images will OVERWRITE existing variants under ${androidBaseDir} and ${iphoneBaseDir}.`)
+    logger.warning(`   Commit first if you want a rollback.`)
+    const choice = await confirmWithAlways('Continue? [y/N/a]', { yes })
+    if (choice === 'no') {
+      logger.info('Aborted.')
+      // eslint-disable-next-line n/no-process-exit
+      process.exit(0)
+    }
+    if (choice === 'always') {
+      const saved = setConfigProperty('images', 'confirmOverwrites', false)
+      if (saved) {
+        logger.success('Saved images.confirmOverwrites = false to purgetss/config.cjs — you won\'t be asked again.')
+      } else {
+        logger.warning('Could not persist preference (config.cjs missing or unreadable). Proceeding anyway.')
+      }
+    }
+  }
+
+  if (projectType === 'unknown') {
+    logger.warning(`Could not detect project layout. Expected 'app/' (Alloy) or 'Resources/' (Classic).`)
+    logger.warning(`Assets will still be written to the detected default paths — verify the output.`)
+  }
+
+  // Relative paths preserve the user's subdirectory structure inside purgetss/images/.
+  // If the source is inside purgetss/images/, compute relPath from that folder
+  // so subdirectories are always preserved in the output — regardless of whether
+  // the user passed the full folder, a subfolder, or a single file.
+  const imagesFolder = projectRoot === process.cwd()
+    ? projectsPurge_TSS_Images_Folder
+    : path.join(projectRoot, 'purgetss', 'images')
+  const sourceIsInsideImagesFolder = source === imagesFolder
+    || source.startsWith(imagesFolder + path.sep)
+
+  const sourceRoot = sourceIsInsideImagesFolder
+    ? imagesFolder
+    : (fs.statSync(source).isDirectory() ? source : path.dirname(source))
+
+  const written = []
+
+  logger.section('Scaling')
+  for (const file of files) {
+    const relPath = path.relative(sourceRoot, file)
+    logger.bullet(relPath)
+
+    if (dryRun) continue
+
+    if (!iphoneOnly) {
+      const androidFiles = await genAndroidScales(file, relPath, androidBaseDir, { format, quality })
+      written.push(...androidFiles)
+    }
+    if (!androidOnly) {
+      const iphoneFiles = await genIphoneScales(file, relPath, iphoneBaseDir, { format, quality })
+      written.push(...iphoneFiles)
+    }
+  }
+
+  if (!dryRun) {
+    console.log()
+    logger.success(`${written.length} file${written.length === 1 ? '' : 's'} written.`)
+    logger.property('Android:    ', androidBaseDir)
+    logger.property('iPhone:     ', iphoneBaseDir)
+  }
+
+  return { written }
+}
+
+function resolveOutputDirs(projectRoot, projectType) {
+  if (projectType === 'classic') {
+    return {
+      androidBaseDir: path.join(projectRoot, 'Resources', 'android', 'images'),
+      iphoneBaseDir: path.join(projectRoot, 'Resources', 'iphone', 'images')
+    }
+  }
+  // Alloy (or unknown fallback uses Alloy convention)
+  return {
+    androidBaseDir: path.join(projectRoot, 'app', 'assets', 'android', 'images'),
+    iphoneBaseDir: path.join(projectRoot, 'app', 'assets', 'iphone', 'images')
+  }
+}
+
+function collectImageFiles(source) {
+  const stat = fs.statSync(source)
+  if (stat.isFile()) {
+    return SUPPORTED_EXTS.has(path.extname(source).toLowerCase()) ? [source] : []
+  }
+  // Directory — recurse
+  return walk(source)
+}
+
+function walk(dir) {
+  const out = []
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      out.push(...walk(full))
+    } else if (entry.isFile() && SUPPORTED_EXTS.has(path.extname(entry.name).toLowerCase())) {
+      out.push(full)
+    }
+  }
+  return out
+}

package/src/shared/config-manager.js

@@ -16,6 +16,9 @@ import defaultTheme from 'tailwindcss/defaultTheme.js'
 import {
   projectsConfigJS,
   projectsPurgeTSSFolder,
+  projectsPurge_TSS_Fonts_Folder,
+  projectsPurge_TSS_Brand_Folder,
+  projectsPurge_TSS_Images_Folder,
   srcConfigFile
 } from './constants.js'
 import { logger } from './logger.js'
@@ -24,6 +27,29 @@ import { makeSureFolderExists } from './utils.js'
 // Create require for ESM compatibility
 const require = createRequire(import.meta.url)
 
+/**
+ * Parse a padding value from either a number or a percentage string.
+ *
+ *   20     → 20
+ *   '20'   → 20
+ *   '20%'  → 20
+ *
+ * Used for `brand.padding` and `brand.iosPadding` so users can write
+ * self-documenting values like `padding: '25%'` in their config.
+ *
+ * @param {number|string} value
+ * @param {string} fieldName - Config path for error messages (e.g. 'brand.padding')
+ * @returns {number} Integer 0-40
+ */
+function parsePadding(value, fieldName) {
+  if (typeof value === 'number') return value
+  if (typeof value === 'string') {
+    const match = value.trim().match(/^(\d+)%?$/)
+    if (match) return parseInt(match[1], 10)
+  }
+  throw new Error(`Invalid ${fieldName}: expected number or '<N>%' string, got ${JSON.stringify(value)}`)
+}
+
 /**
  * Ensure config file exists - SIMPLE logic
  * 1. If config.cjs exists → use it
@@ -31,6 +57,14 @@ const require = createRequire(import.meta.url)
  * 3. If nothing exists → create config.cjs
  */
 export function ensureConfig() {
+  // Ensure the full purgetss/ subfolder layout exists on every init — keeps
+  // fonts/, brand/, and images/ discoverable from day one instead of
+  // appearing lazily on first use of their respective commands.
+  makeSureFolderExists(projectsPurgeTSSFolder)
+  makeSureFolderExists(projectsPurge_TSS_Fonts_Folder)
+  makeSureFolderExists(projectsPurge_TSS_Brand_Folder)
+  makeSureFolderExists(projectsPurge_TSS_Images_Folder)
+
   // 1. ¿Existe config.cjs? → Úsalo
   if (fs.existsSync(projectsConfigJS)) {
     return
@@ -93,6 +127,18 @@ export function getConfigFile() {
   configFile.purge.options.safelist = configFile.purge.options.safelist ?? []
   configFile.purge.options.plugins = configFile.purge.options.plugins ?? []
 
+  configFile.brand = configFile.brand ?? {}
+  configFile.brand.bgColor = configFile.brand.bgColor ?? '#FFFFFF'
+  configFile.brand.padding = parsePadding(configFile.brand.padding ?? 15, 'brand.padding')
+  configFile.brand.iosPadding = parsePadding(configFile.brand.iosPadding ?? 4, 'brand.iosPadding')
+  configFile.brand.darkBgColor = configFile.brand.darkBgColor ?? null
+  configFile.brand.notification = configFile.brand.notification ?? false
+  configFile.brand.splash = configFile.brand.splash ?? false
+
+  configFile.images = configFile.images ?? {}
+  configFile.images.quality = configFile.images.quality ?? 85
+  configFile.images.format = configFile.images.format ?? null
+
   configFile.theme = configFile.theme ?? {}
   configFile.theme.extend = configFile.theme.extend ?? {}
 

package/src/shared/config-writer.js

@@ -0,0 +1,84 @@
+/**
+ * PurgeTSS - config.cjs patcher
+ *
+ * Small helper for writing a single property into an existing top-level
+ * section (e.g. `brand: { ... }` or `images: { ... }`) of the user's
+ * purgetss/config.cjs. Used by the interactive "always" confirmation option
+ * to persist the user's preference.
+ *
+ * Deliberately narrow: only touches the target property, preserves the
+ * user's indentation style, and leaves every other line byte-identical.
+ * If the target section or key can't be located safely, it no-ops rather
+ * than risking a corrupted config — the caller falls back to the one-shot
+ * `--yes` / PURGETSS_YES behavior.
+ *
+ * @fileoverview Non-destructive single-property writer for config.cjs
+ * @author César Estrada
+ */
+
+import fs from 'fs'
+import { projectsConfigJS } from './constants.js'
+
+/**
+ * Set `section.key = value` inside the user's purgetss/config.cjs, preserving
+ * the rest of the file. If the key already exists in that section, its value
+ * is replaced in place; otherwise a new line is appended before the section's
+ * closing brace.
+ *
+ * @param {string} section - Top-level section name (e.g. 'brand', 'images').
+ * @param {string} key - Property key to set inside the section.
+ * @param {*} value - JSON-serializable value (booleans, numbers, strings, null).
+ * @returns {boolean} True on success; false if config is missing or the
+ *   section couldn't be located.
+ */
+export function setConfigProperty(section, key, value) {
+  if (!fs.existsSync(projectsConfigJS)) return false
+
+  const original = fs.readFileSync(projectsConfigJS, 'utf8')
+
+  // Capture the entire section: `<indent>section: { <body> \n<closeIndent>}`.
+  // Non-greedy body match keeps us from swallowing sibling sections.
+  const sectionRegex = new RegExp(
+    `^(\\s*)${section}\\s*:\\s*\\{([\\s\\S]*?)\\n(\\s*)\\}`,
+    'm'
+  )
+  const match = original.match(sectionRegex)
+  if (!match) return false
+
+  const [wholeMatch, sectionIndent, body, closeIndent] = match
+  const propIndent = closeIndent + '  '
+  const valueLiteral = JSON.stringify(value)
+
+  // If the key already exists inside the body, replace its value in place.
+  // Preserves any trailing comment on the same line.
+  const keyRegex = new RegExp(`(\\n\\s+${key}\\s*:\\s*)([^,\\n]+?)(\\s*(?:,|(?=\\n|$)))`)
+  if (keyRegex.test(body)) {
+    const newBody = body.replace(keyRegex, `$1${valueLiteral}$3`)
+    const replaced = `${sectionIndent}${section}: {${newBody}\n${closeIndent}}`
+    fs.writeFileSync(projectsConfigJS, original.replace(wholeMatch, replaced), 'utf8')
+    return true
+  }
+
+  // Key missing — append a new line before the closing brace. Ensure the
+  // previous property line has a trailing comma so the appended property
+  // parses. If that line ends in a // comment, the comma goes between the
+  // value and the comment (not after it).
+  const lines = body.replace(/\s+$/, '').split('\n')
+  const lastIdx = lines.length - 1
+  const lastLine = lines[lastIdx]
+  const commentMatch = lastLine.match(/^(.*?)(\s*\/\/.*)$/)
+  const valuePart = (commentMatch ? commentMatch[1] : lastLine).replace(/\s+$/, '')
+  const commentPart = commentMatch ? commentMatch[2] : ''
+  const needsComma =
+    valuePart &&
+    !valuePart.endsWith(',') &&
+    !valuePart.endsWith('{')
+  lines[lastIdx] = (needsComma ? valuePart + ',' : valuePart) + commentPart
+
+  let newBody = lines.join('\n')
+  newBody += `\n${propIndent}${key}: ${valueLiteral}`
+
+  const replaced = `${sectionIndent}${section}: {${newBody}\n${closeIndent}}`
+  fs.writeFileSync(projectsConfigJS, original.replace(wholeMatch, replaced), 'utf8')
+  return true
+}

package/src/shared/constants.js

@@ -29,6 +29,7 @@ export const projectsAppTSS = `${cwd}/app/styles/app.tss`
 export const projects_AppTSS = `${cwd}/app/styles/_app.tss`
 export const projectsAlloyJMKFile = `${cwd}/app/alloy.jmk`
 export const projectsFontsFolder = `${cwd}/app/assets/fonts`
+export const projectsSemanticColorsJSON = `${cwd}/app/assets/semantic.colors.json`
 export const projectsFontAwesomeJS = `${cwd}/app/lib/fontawesome.js`
 
 // ============================================================================
@@ -39,6 +40,8 @@ export const projectsPurgeTSSFolder = `${cwd}/purgetss`
 export const projectsConfigJS = `${cwd}/purgetss/config.cjs`
 export const projectsTailwind_TSS = `${cwd}/purgetss/styles/utilities.tss`
 export const projectsPurge_TSS_Fonts_Folder = `${cwd}/purgetss/fonts`
+export const projectsPurge_TSS_Brand_Folder = `${cwd}/purgetss/brand`
+export const projectsPurge_TSS_Images_Folder = `${cwd}/purgetss/images`
 export const projectsPurge_TSS_Styles_Folder = `${cwd}/purgetss/styles`
 export const projectsFA_TSS_File = `${cwd}/purgetss/styles/fontawesome.tss`
 

package/src/shared/logger.js

@@ -19,6 +19,27 @@ const purgeLabel = colores.purgeLabel
 // Debug mode flag (can be set externally)
 let purgingDebug = false
 
+// Section mode: when active, the first info/warn/error/file call acts as a
+// ::PurgeTSS:: header and every subsequent call prints indented 3 spaces
+// without the prefix. Used by long-running flows (e.g. purge) that want a
+// single signed line per run instead of one per step. Always wrap with
+// try/finally in the caller to guarantee endSection() runs.
+let _sectionMode = false
+let _sectionHeaderEmitted = false
+
+function _emit(text) {
+  if (_sectionMode) {
+    if (_sectionHeaderEmitted) {
+      console.log('   ' + text)
+    } else {
+      console.log(purgeLabel, text)
+      _sectionHeaderEmitted = true
+    }
+  } else {
+    console.log(purgeLabel, text)
+  }
+}
+
 /**
  * Main logger object with different log levels
  * Maintains exact same API as original for compatibility
@@ -29,7 +50,7 @@ export const logger = {
    * @param {...any} args - Arguments to log
    */
   info: function(...args) {
-    console.log(purgeLabel, args.join(' '))
+    _emit(args.join(' '))
   },
 
   /**
@@ -37,7 +58,7 @@ export const logger = {
    * @param {...any} args - Arguments to log
    */
   warn: function(...args) {
-    console.log(purgeLabel, chalk.yellow(args.join(' ')))
+    _emit(chalk.yellow(args.join(' ')))
   },
 
   /**
@@ -45,7 +66,7 @@ export const logger = {
    * @param {...any} args - Arguments to log
    */
   error: function(...args) {
-    console.log(purgeLabel, chalk.red(args.join(' ')))
+    _emit(chalk.red(args.join(' ')))
   },
 
   /**
@@ -53,7 +74,51 @@ export const logger = {
    * @param {...any} args - Arguments to log
    */
   file: function(...args) {
-    console.log(purgeLabel, chalk.yellow(args.join(' ')), 'file created!')
+    _emit(chalk.yellow(args.join(' ')) + ' file created!')
+  },
+
+  /**
+   * Enable section mode. The next info/warn/error/file call becomes the
+   * ::PurgeTSS:: header; subsequent calls print indented without prefix.
+   * MUST be paired with endSection() via try/finally to avoid state leaks.
+   */
+  startSection: function() {
+    _sectionMode = true
+    _sectionHeaderEmitted = false
+  },
+
+  /**
+   * Exit section mode. Safe to call even if section wasn't started.
+   */
+  endSection: function() {
+    _sectionMode = false
+    _sectionHeaderEmitted = false
+  },
+
+  /**
+   * Log a multi-line block with a single ::PurgeTSS:: header.
+   * First arg is the header (printed next to purgeLabel); remaining args are
+   * continuation lines indented 3 spaces. Pass '' for a blank separator line.
+   *
+   * @param {string} header - Header line (printed after purgeLabel)
+   * @param {...string} lines - Continuation lines (indented, or '' for blank)
+   */
+  block: function(header, ...lines) {
+    console.log(purgeLabel, header)
+    for (const line of lines) {
+      console.log(line === '' ? '' : '   ' + line)
+    }
+  },
+
+  /**
+   * Log a sub-line without the ::PurgeTSS:: prefix, indented 3 spaces.
+   * Use inside sequential flows where a prior logger.info emitted the header.
+   * Prints synchronously, preserving timing with logger.info.
+   *
+   * @param {...any} args - Arguments to log
+   */
+  item: function(...args) {
+    console.log('   ' + args.join(' '))
   }
 }
 

package/src/shared/prompt.js

@@ -0,0 +1,64 @@
+/**
+ * PurgeTSS - Interactive prompt helpers
+ *
+ * Small wrapper around Node's readline for yes/no confirmations on destructive
+ * operations (in-place brand/images writes). Auto-skips when:
+ *   - the caller sets `yes: true` (e.g. from --yes flag)
+ *   - the PURGETSS_YES=1 environment variable is set
+ *   - stdin is not a TTY (CI, hooks, piped input)
+ *
+ * Default answer is NO on empty input — requires explicit "y" / "yes" to proceed.
+ *
+ * @fileoverview TTY-aware confirmation prompts
+ * @author César Estrada
+ */
+
+import readline from 'node:readline/promises'
+
+/**
+ * Ask the user for a yes/no confirmation.
+ *
+ * @param {string} message - Prompt text shown to the user. A trailing space is
+ *   added automatically, so pass something like "Continue? [y/N]".
+ * @param {Object} [opts]
+ * @param {boolean} [opts.yes=false] - Skip prompt and answer yes (e.g. --yes flag).
+ * @returns {Promise<boolean>} True when confirmed or skipped; false otherwise.
+ */
+export async function confirm(message, { yes = false } = {}) {
+  if (yes) return true
+  if (process.env.PURGETSS_YES === '1') return true
+  if (!process.stdin.isTTY) return true
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  try {
+    const answer = await rl.question(`${message} `)
+    return /^y(es)?$/i.test(answer.trim())
+  } finally {
+    rl.close()
+  }
+}
+
+/**
+ * Three-way confirmation: yes / no / always. Same skip rules as confirm()
+ * (--yes flag, PURGETSS_YES env, non-TTY all resolve to 'yes').
+ *
+ * @param {string} message - Prompt text (a trailing space is added).
+ * @param {Object} [opts]
+ * @param {boolean} [opts.yes=false] - Skip prompt, answer 'yes'.
+ * @returns {Promise<'yes'|'no'|'always'>} The user's choice.
+ */
+export async function confirmWithAlways(message, { yes = false } = {}) {
+  if (yes) return 'yes'
+  if (process.env.PURGETSS_YES === '1') return 'yes'
+  if (!process.stdin.isTTY) return 'yes'
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  try {
+    const answer = (await rl.question(`${message} `)).trim().toLowerCase()
+    if (answer === 'a' || answer === 'always') return 'always'
+    if (answer === 'y' || answer === 'yes') return 'yes'
+    return 'no'
+  } finally {
+    rl.close()
+  }
+}

package/src/shared/svg-utils.js

@@ -0,0 +1,80 @@
+/**
+ * PurgeTSS - Shared SVG/Sharp utilities
+ *
+ * Centralizes the logic for safely rasterizing SVGs with Sharp — specifically,
+ * handling SVGs that come out of vector editors (Affinity, Illustrator) with
+ * absurdly large viewBoxes that would otherwise trigger Sharp's pixel limit.
+ *
+ * Shared by:
+ *   - src/core/branding/prepare-master.js (brand pipeline)
+ *   - src/core/images/gen-scales.js       (images pipeline)
+ *
+ * @fileoverview SVG rasterization helpers for the Sharp pipeline
+ * @author César Estrada
+ */
+
+import fs from 'fs'
+import path from 'path'
+import sharp from 'sharp'
+
+// SVGs with natural dimensions above this (in points) are almost always the
+// result of a vector editor baking in transforms — e.g. Affinity exporting a
+// "pliego" as 29559×13542 pt. Callers compensate with adaptive density; this
+// threshold only controls the user-facing warning.
+export const VIEWBOX_WARN_THRESHOLD = 4096
+
+/**
+ * Compute a Sharp density (DPI) so that rasterization of an SVG lands at
+ * approximately `targetSupersampledMax` pixels on the longest side, regardless
+ * of the SVG's intrinsic viewBox. Clamped to Sharp's valid range (1..2400).
+ *
+ * @param {number} naturalMax - Largest SVG dimension in points (at 72 DPI).
+ * @param {number} targetSupersampledMax - Desired raster size on the longest side.
+ * @returns {number} A safe density value in [1, 2400].
+ */
+export function computeSvgDensity(naturalMax, targetSupersampledMax) {
+  return Math.min(
+    2400,
+    Math.max(1, Math.round((targetSupersampledMax / naturalMax) * 72))
+  )
+}
+
+/**
+ * Read an SVG safely — buffer + metadata with the pixel-limit check disabled
+ * (Sharp enforces it even during header parsing for SVG inputs). Optionally
+ * emits a warning via the provided logger when the viewBox is disproportionate.
+ *
+ * The caller is responsible for computing a bounded density (via
+ * computeSvgDensity) before actually rendering — this keeps the real pixel
+ * output inside Sharp's limit even though the limit was disabled at read time.
+ *
+ * @param {string} svgPath - Absolute path to the SVG file.
+ * @param {Object} [opts]
+ * @param {Object} [opts.logger] - Logger exposing a .warning(msg) method. If
+ *   omitted, no warning is emitted (silent mode, for unit tests).
+ * @param {boolean} [opts.withAdvice=false] - Include the "re-export" advice
+ *   line. Enable for the brand pipeline (where the logo is central); keep
+ *   false for the images pipeline (which may process many files).
+ * @returns {Promise<{buffer: Buffer, meta: Object, naturalMax: number}>}
+ */
+export async function readSvgSafely(svgPath, { logger, withAdvice = false } = {}) {
+  const buffer = fs.readFileSync(svgPath)
+  const meta = await sharp(buffer, { limitInputPixels: false }).metadata()
+  const naturalMax = Math.max(meta.width, meta.height)
+
+  if (logger && naturalMax > VIEWBOX_WARN_THRESHOLD) {
+    logger.warning(
+      `⚠  ${path.basename(svgPath)} has a disproportionate viewBox (${meta.width}×${meta.height} pt).`
+    )
+    if (withAdvice) {
+      logger.warning(
+        `   Re-export from your vector editor with a canvas-sized viewBox if possible.`
+      )
+    }
+    logger.warning(
+      `   Adapting rasterization density to compensate.`
+    )
+  }
+
+  return { buffer, meta, naturalMax }
+}

package/src/shared/utils.js

@@ -73,8 +73,10 @@ export function alloyProject(silent = false) {
 
   if (!fs.existsSync(`${cwd}/app/views`)) {
     if (!silent) {
-      logger.info(`Please make sure you are running ${chalk.green('purgetss')} within an Alloy Project.`)
-      logger.info(`For more information, visit ${chalk.green('https://purgetss.com')}`)
+      logger.block(
+        `Please make sure you are running ${chalk.green('purgetss')} within an Alloy Project.`,
+        `For more information, visit ${chalk.green('https://purgetss.com')}`
+      )
     }
     return false
   }
@@ -93,8 +95,10 @@ export function classicProject(silent = false) {
 
   if (!fs.existsSync(`${cwd}/Resources`)) {
     if (!silent) {
-      logger.info(`Please make sure you are running ${chalk.green('purgetss')} within a Titanium's Classic Project.`)
-      logger.info(`For more information, visit ${chalk.green('https://purgetss.com')}`)
+      logger.block(
+        `Please make sure you are running ${chalk.green('purgetss')} within a Titanium's Classic Project.`,
+        `For more information, visit ${chalk.green('https://purgetss.com')}`
+      )
     }
     return false
   }