@mrdemonwolf/iconwolf 0.1.1 → 0.2.1

package/dist/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA8BrE,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqH7B"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgCrE,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgI7B"}

package/dist/generator.js

@@ -8,19 +8,21 @@ import { generateStandardIcon } from './variants/standard.js';
 import { generateFavicon } from './variants/favicon.js';
 import { generateSplashIcon } from './variants/splash.js';
 import { generateAndroidIcons } from './variants/android.js';
+import { applyBanner, shouldApplyBanner } from './utils/banner.js';
 async function resolveInput(resolvedPath, bgColor, silent) {
     if (isIconComposerFolder(resolvedPath)) {
         if (!silent)
             logger.info(`Apple Icon Composer file: ${resolvedPath}`);
         const result = await renderIconComposerFolder(resolvedPath);
         const inputPath = result.composedImagePath;
+        const foregroundPath = result.foregroundImagePath;
         const cleanupPath = path.dirname(result.composedImagePath);
         if (bgColor === '#FFFFFF') {
             bgColor = result.extractedBgColor;
             if (!silent)
                 logger.info(`Extracted background color: ${bgColor}`);
         }
-        return { inputPath, cleanupPath, bgColor };
+        return { inputPath, foregroundPath, cleanupPath, bgColor };
     }
     return { inputPath: resolvedPath, bgColor };
 }
@@ -37,6 +39,7 @@ export async function generate(options) {
         throw new Error(`Source not found: ${resolvedInput}`);
     }
     let inputPath;
+    let foregroundPath;
     let cleanupPath;
     let splashPath;
     let splashCleanupPath;
@@ -44,6 +47,7 @@ export async function generate(options) {
         // Resolve main input (Apple Icon Composer .icon folder or PNG)
         const mainInput = await resolveInput(resolvedInput, bgColor, silent);
         inputPath = mainInput.inputPath;
+        foregroundPath = mainInput.foregroundPath;
         cleanupPath = mainInput.cleanupPath;
         bgColor = mainInput.bgColor;
         // Resolve splash input if provided
@@ -53,7 +57,7 @@ export async function generate(options) {
                 throw new Error(`Splash source not found: ${resolvedSplashInput}`);
             }
             const splashInput = await resolveInput(resolvedSplashInput, bgColor, silent);
-            splashPath = splashInput.inputPath;
+            splashPath = splashInput.foregroundPath ?? splashInput.inputPath;
             splashCleanupPath = splashInput.cleanupPath;
         }
         // Validate source image
@@ -100,11 +104,19 @@ export async function generate(options) {
                 logger.generated(result);
         }
         if (generateAll || variants.splash) {
-            const result = await generateSplashIcon(splashPath || inputPath, outputDir);
+            const result = await generateSplashIcon(splashPath || foregroundPath || inputPath, outputDir);
             results.push(result);
             if (!silent)
                 logger.generated(result);
         }
+        // Apply banner overlay if requested
+        if (options.banner) {
+            for (const result of results) {
+                if (shouldApplyBanner(result.filePath)) {
+                    await applyBanner(result, options.banner);
+                }
+            }
+        }
         if (!silent)
             logger.summary(results);
         return results;

package/dist/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUnE,KAAK,UAAU,YAAY,CACzB,YAAoB,EACpB,OAAe,EACf,MAAe;IAEf,IAAI,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,YAAY,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC3C,MAAM,cAAc,GAAG,MAAM,CAAC,mBAAmB,CAAC;QAClD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAE3D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC;YAClC,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAyB;IAEzB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IACxE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IAEvC,IAAI,CAAC,MAAM;QAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAE7B,sBAAsB;IACtB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,aAAa,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,SAAiB,CAAC;IACtB,IAAI,cAAkC,CAAC;IACvC,IAAI,WAA+B,CAAC;IACpC,IAAI,UAA8B,CAAC;IACnC,IAAI,iBAAqC,CAAC;IAE1C,IAAI,CAAC;QACH,+DAA+D;QAC/D,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACrE,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QAChC,cAAc,GAAG,SAAS,CAAC,cAAc,CAAC;QAC1C,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;QACpC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QAE5B,mCAAmC;QACnC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,mBAAmB,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,YAAY,CACpC,mBAAmB,EACnB,OAAO,EACP,MAAM,CACP,CAAC;YACF,UAAU,GAAG,WAAW,CAAC,cAAc,IAAI,WAAW,CAAC,SAAS,CAAC;YACjE,iBAAiB,GAAG,WAAW,CAAC,WAAW,CAAC;QAC9C,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM;YACT,MAAM,CAAC,IAAI,CACT,WAAW,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CACpE,CAAC;QAEJ,2CAA2C;QAC3C,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;YAC1E,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM;gBACT,MAAM,CAAC,IAAI,CACT,kBAAkB,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAC7F,CAAC;QACN,CAAC;QAED,0BAA0B;QAC1B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC;QAE3D,uCAAuC;QACvC,MAAM,UAAU,GACd,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC;QAC3E,MAAM,WAAW,GAAG,CAAC,UAAU,CAAC;QAEhC,MAAM,OAAO,GAAuB,EAAE,CAAC;QAEvC,6BAA6B;QAC7B,IAAI,WAAW,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,WAAW,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAC/C,SAAS,EACT,SAAS,EACT,OAAO,EACP,EAAE,iBAAiB,EAAE,QAAQ,CAAC,OAAO,EAAE,CACxC,CAAC;YACF,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,CAAC,MAAM;oBAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,IAAI,WAAW,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC,UAAU,IAAI,cAAc,IAAI,SAAS,EACzC,SAAS,CACV,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,oCAAoC;QACpC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACvC,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,gCAAgC;QAChC,IAAI,WAAW,EAAE,CAAC;YAChB,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,iBAAiB,EAAE,CAAC;YACtB,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@ import { generate } from './generator.js';
 import * as logger from './utils/logger.js';
 import { resolveDefaultOutputDir } from './utils/paths.js';
 import { readCachedUpdateInfo, refreshCacheInBackground, } from './utils/update-notifier.js';
-const VERSION = '0.1.0';
+const VERSION = '0.2.1';
 const program = new Command();
 program
     .name('iconwolf')
@@ -18,6 +18,9 @@ program
     .option('--icon', 'Generate standard icon.png only')
     .option('--splash-input <path>', 'Use a separate image for the splash screen icon')
     .option('--bg-color <hex>', 'Background color for Android adaptive icon', '#FFFFFF')
+    .option('--banner <text>', 'Diagonal ribbon banner text (e.g. DEV, BETA, STAGING)')
+    .option('--banner-color <hex>', 'Ribbon color (default: auto from text)')
+    .option('--banner-position <pos>', 'Banner position: top-left, top-right, bottom-left, bottom-right', 'top-left')
     .action(async (input, opts) => {
     const updateInfo = readCachedUpdateInfo(VERSION);
     refreshCacheInBackground().catch(() => { });
@@ -32,6 +35,13 @@ program
         },
         bgColor: opts.bgColor,
         splashInputPath: opts.splashInput,
+        banner: opts.banner
+            ? {
+                text: opts.banner,
+                color: opts.bannerColor,
+                position: opts.bannerPosition,
+            }
+            : undefined,
     };
     try {
         await generate(options);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CACV,+GAA+G,CAChH;KACA,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CACP,SAAS,EACT,6DAA6D,CAC9D;KACA,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;KAC3E,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;KACnE,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;KAChD,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC;KACtD,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;KACnD,MAAM,CACL,uBAAuB,EACvB,iDAAiD,CAClD;KACA,MAAM,CACL,kBAAkB,EAClB,4CAA4C,EAC5C,SAAS,CACV;KACA,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAI,EAAE,EAAE;IACpC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjD,wBAAwB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAqB;QAChC,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,IAAI,CAAC,MAAM;QACtB,QAAQ,EAAE;YACR,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;YAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;SACzB;QACD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,WAAW;KAClC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QAExB,IAAI,UAAU,EAAE,eAAe,EAAE,CAAC;YAChC,MAAM,CAAC,YAAY,CACjB,UAAU,CAAC,cAAc,EACzB,UAAU,CAAC,aAAa,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CACV,+GAA+G,CAChH;KACA,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CACP,SAAS,EACT,6DAA6D,CAC9D;KACA,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;KAC3E,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;KACnE,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;KAChD,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC;KACtD,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;KACnD,MAAM,CACL,uBAAuB,EACvB,iDAAiD,CAClD;KACA,MAAM,CACL,kBAAkB,EAClB,4CAA4C,EAC5C,SAAS,CACV;KACA,MAAM,CACL,iBAAiB,EACjB,uDAAuD,CACxD;KACA,MAAM,CAAC,sBAAsB,EAAE,wCAAwC,CAAC;KACxE,MAAM,CACL,yBAAyB,EACzB,iEAAiE,EACjE,UAAU,CACX;KACA,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAI,EAAE,EAAE;IACpC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjD,wBAAwB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAqB;QAChC,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,IAAI,CAAC,MAAM;QACtB,QAAQ,EAAE;YACR,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;YAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;SACzB;QACD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,WAAW;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACjB,CAAC,CAAC;gBACE,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,KAAK,EAAE,IAAI,CAAC,WAAW;gBACvB,QAAQ,EAAE,IAAI,CAAC,cAAgC;aAChD;YACH,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QAExB,IAAI,UAAU,EAAE,eAAe,EAAE,CAAC;YAChC,MAAM,CAAC,YAAY,CACjB,UAAU,CAAC,cAAc,EACzB,UAAU,CAAC,aAAa,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib.d.ts

@@ -4,7 +4,8 @@ export { generateFavicon } from './variants/favicon.js';
 export { generateSplashIcon } from './variants/splash.js';
 export { generateAndroidIcons } from './variants/android.js';
 export { validateSourceImage } from './utils/image.js';
+export { applyBanner, createBannerSvg, shouldApplyBanner, } from './utils/banner.js';
 export { isIconComposerFolder, renderIconComposerFolder, } from './utils/icon-composer.js';
 export { OUTPUT_FILES, resolveOutputPath } from './utils/paths.js';
-export type { VariantFlags, GeneratorOptions, GenerationResult, } from './types.js';
+export type { BannerOptions, BannerPosition, VariantFlags, GeneratorOptions, GenerationResult, } from './types.js';
 //# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,WAAW,EACX,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/lib.js

@@ -4,6 +4,7 @@ export { generateFavicon } from './variants/favicon.js';
 export { generateSplashIcon } from './variants/splash.js';
 export { generateAndroidIcons } from './variants/android.js';
 export { validateSourceImage } from './utils/image.js';
+export { applyBanner, createBannerSvg, shouldApplyBanner, } from './utils/banner.js';
 export { isIconComposerFolder, renderIconComposerFolder, } from './utils/icon-composer.js';
 export { OUTPUT_FILES, resolveOutputPath } from './utils/paths.js';
 //# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,WAAW,EACX,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,9 @@
+export type BannerPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export interface BannerOptions {
+    text: string;
+    color?: string;
+    position?: BannerPosition;
+}
 export interface VariantFlags {
     android: boolean;
     favicon: boolean;
@@ -10,6 +16,7 @@ export interface GeneratorOptions {
     variants: VariantFlags;
     bgColor: string;
     splashInputPath?: string;
+    banner?: BannerOptions;
     silent?: boolean;
 }
 export interface GenerationResult {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/utils/banner.d.ts

@@ -0,0 +1,5 @@
+import type { BannerOptions, BannerPosition, GenerationResult } from '../types.js';
+export declare function createBannerSvg(size: number, text: string, color: string, position: BannerPosition): string;
+export declare function applyBanner(result: GenerationResult, bannerOptions: BannerOptions): Promise<void>;
+export declare function shouldApplyBanner(filePath: string): boolean;
+//# sourceMappingURL=banner.d.ts.map

package/dist/utils/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAgBrB,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,GACvB,MAAM,CA0CR;AAUD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf;AASD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/utils/banner.js

@@ -0,0 +1,88 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import sharp from 'sharp';
+const DEFAULT_COLORS = {
+    DEV: '#4CAF50',
+    BETA: '#FF9800',
+    STAGING: '#2196F3',
+    ALPHA: '#9C27B0',
+};
+const FALLBACK_COLOR = '#F44336';
+function resolveColor(text, color) {
+    if (color)
+        return color;
+    return DEFAULT_COLORS[text.toUpperCase()] ?? FALLBACK_COLOR;
+}
+export function createBannerSvg(size, text, color, position) {
+    const ribbonWidth = Math.round(size * 0.42);
+    const ribbonHeight = Math.round(size * 0.08);
+    const fontSize = Math.round(ribbonHeight * 0.6);
+    const halfDiag = ribbonWidth / 2;
+    // Center of the ribbon in each corner
+    let cx;
+    let cy;
+    let angle;
+    switch (position) {
+        case 'top-left':
+            cx = size * 0.2;
+            cy = size * 0.2;
+            angle = -45;
+            break;
+        case 'top-right':
+            cx = size * 0.8;
+            cy = size * 0.2;
+            angle = 45;
+            break;
+        case 'bottom-left':
+            cx = size * 0.2;
+            cy = size * 0.8;
+            angle = 45;
+            break;
+        case 'bottom-right':
+            cx = size * 0.8;
+            cy = size * 0.8;
+            angle = -45;
+            break;
+    }
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 ${size} ${size}">
+  <g transform="translate(${cx}, ${cy}) rotate(${angle})">
+    <rect x="${-halfDiag}" y="${-ribbonHeight / 2}" width="${ribbonWidth}" height="${ribbonHeight}" fill="${color}"/>
+    <text x="0" y="0" text-anchor="middle" dominant-baseline="central"
+      font-family="Arial, Helvetica, sans-serif" font-weight="bold"
+      font-size="${fontSize}" fill="white">${escapeXml(text)}</text>
+  </g>
+</svg>`;
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+export async function applyBanner(result, bannerOptions) {
+    const color = resolveColor(bannerOptions.text, bannerOptions.color);
+    const position = bannerOptions.position ?? 'top-left';
+    const meta = await sharp(result.filePath).metadata();
+    const size = meta.width ?? 1024;
+    const svg = createBannerSvg(size, bannerOptions.text, color, position);
+    const svgBuffer = Buffer.from(svg);
+    const tmpPath = result.filePath + '.tmp';
+    await sharp(result.filePath)
+        .composite([{ input: svgBuffer, top: 0, left: 0 }])
+        .png()
+        .toFile(tmpPath);
+    fs.renameSync(tmpPath, result.filePath);
+    const stat = fs.statSync(result.filePath);
+    result.size = stat.size;
+}
+/** Files that should not receive a banner overlay. */
+const SKIP_FILES = new Set([
+    'favicon.png',
+    'android-icon-background.png',
+    'monochrome-icon.png',
+]);
+export function shouldApplyBanner(filePath) {
+    return !SKIP_FILES.has(path.basename(filePath));
+}
+//# sourceMappingURL=banner.js.map

package/dist/utils/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"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"}

package/dist/utils/icon-composer.d.ts

@@ -1,5 +1,6 @@
 export interface IconComposerResult {
     composedImagePath: string;
+    foregroundImagePath: string;
     extractedBgColor: string;
 }
 /**

package/dist/utils/icon-composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon-composer.d.ts","sourceRoot":"","sources":["../../src/utils/icon-composer.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAS/D;AA6HD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAgG7B"}
+{"version":3,"file":"icon-composer.d.ts","sourceRoot":"","sources":["../../src/utils/icon-composer.ts"],"names":[],"mappings":"AA4CA,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAS/D;AA6HD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA2H7B"}

package/dist/utils/icon-composer.js

@@ -128,8 +128,13 @@ export async function renderIconComposerFolder(iconFolderPath) {
     }
     const manifestRaw = fs.readFileSync(manifestPath, 'utf-8');
     const manifest = JSON.parse(manifestRaw);
+    // Resolve fill: prefer top-level `fill`, fall back to first `fill-specializations` entry (light appearance)
+    const fill = manifest.fill ??
+        manifest['fill-specializations']?.find((s) => !s.appearance)?.value ??
+        manifest['fill-specializations']?.[0]?.value ??
+        {};
     // Create background
-    const { buffer: backgroundBuffer, bgColor: extractedBgColor } = await createBackground(manifest.fill);
+    const { buffer: backgroundBuffer, bgColor: extractedBgColor } = await createBackground(fill);
     // Build composite operations for each layer
     const compositeOps = [];
     for (const group of manifest.groups) {
@@ -185,15 +190,32 @@ export async function renderIconComposerFolder(iconFolderPath) {
             compositeOps.push({ input: layerBuffer, left, top });
         }
     }
-    // Compose final image
+    // Compose final image (with background)
     const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'iconwolf-compose-'));
     const composedPath = path.join(tmpDir, 'composed-icon.png');
     await sharp(backgroundBuffer)
         .composite(compositeOps)
         .png()
         .toFile(composedPath);
+    // Compose foreground-only image (transparent background) for splash
+    const foregroundPath = path.join(tmpDir, 'foreground-icon.png');
+    const transparentBg = await sharp({
+        create: {
+            width: ICON_SIZE,
+            height: ICON_SIZE,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .png()
+        .toBuffer();
+    await sharp(transparentBg)
+        .composite(compositeOps)
+        .png()
+        .toFile(foregroundPath);
     return {
         composedImagePath: composedPath,
+        foregroundImagePath: foregroundPath,
         extractedBgColor,
     };
 }

package/dist/utils/icon-composer.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon-composer.js","sourceRoot":"","sources":["../../src/utils/icon-composer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"icon-composer.js","sourceRoot":"","sources":["../../src/utils/icon-composer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrdemonwolf/iconwolf",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "A CLI tool that takes an iOS app compositor icon and generates all necessary icon variants for cross-platform use.",
   "type": "module",
   "main": "./dist/lib.js",

package/src/generator.ts

@@ -11,10 +11,12 @@ import { generateStandardIcon } from './variants/standard.js';
 import { generateFavicon } from './variants/favicon.js';
 import { generateSplashIcon } from './variants/splash.js';
 import { generateAndroidIcons } from './variants/android.js';
+import { applyBanner, shouldApplyBanner } from './utils/banner.js';
 import type { GeneratorOptions, GenerationResult } from './types.js';
 
 interface ResolvedInput {
   inputPath: string;
+  foregroundPath?: string;
   cleanupPath?: string;
   bgColor: string;
 }
@@ -28,6 +30,7 @@ async function resolveInput(
     if (!silent) logger.info(`Apple Icon Composer file: ${resolvedPath}`);
     const result = await renderIconComposerFolder(resolvedPath);
     const inputPath = result.composedImagePath;
+    const foregroundPath = result.foregroundImagePath;
     const cleanupPath = path.dirname(result.composedImagePath);
 
     if (bgColor === '#FFFFFF') {
@@ -35,7 +38,7 @@ async function resolveInput(
       if (!silent) logger.info(`Extracted background color: ${bgColor}`);
     }
 
-    return { inputPath, cleanupPath, bgColor };
+    return { inputPath, foregroundPath, cleanupPath, bgColor };
   }
 
   return { inputPath: resolvedPath, bgColor };
@@ -58,6 +61,7 @@ export async function generate(
   }
 
   let inputPath: string;
+  let foregroundPath: string | undefined;
   let cleanupPath: string | undefined;
   let splashPath: string | undefined;
   let splashCleanupPath: string | undefined;
@@ -66,6 +70,7 @@ export async function generate(
     // Resolve main input (Apple Icon Composer .icon folder or PNG)
     const mainInput = await resolveInput(resolvedInput, bgColor, silent);
     inputPath = mainInput.inputPath;
+    foregroundPath = mainInput.foregroundPath;
     cleanupPath = mainInput.cleanupPath;
     bgColor = mainInput.bgColor;
 
@@ -80,7 +85,7 @@ export async function generate(
         bgColor,
         silent,
       );
-      splashPath = splashInput.inputPath;
+      splashPath = splashInput.foregroundPath ?? splashInput.inputPath;
       splashCleanupPath = splashInput.cleanupPath;
     }
 
@@ -141,13 +146,22 @@ export async function generate(
 
     if (generateAll || variants.splash) {
       const result = await generateSplashIcon(
-        splashPath || inputPath,
+        splashPath || foregroundPath || inputPath,
         outputDir,
       );
       results.push(result);
       if (!silent) logger.generated(result);
     }
 
+    // Apply banner overlay if requested
+    if (options.banner) {
+      for (const result of results) {
+        if (shouldApplyBanner(result.filePath)) {
+          await applyBanner(result, options.banner);
+        }
+      }
+    }
+
     if (!silent) logger.summary(results);
 
     return results;

package/src/index.ts

@@ -8,9 +8,9 @@ import {
   readCachedUpdateInfo,
   refreshCacheInBackground,
 } from './utils/update-notifier.js';
-import type { GeneratorOptions } from './types.js';
+import type { BannerPosition, GeneratorOptions } from './types.js';
 
-const VERSION = '0.1.0';
+const VERSION = '0.2.1';
 
 const program = new Command();
 
@@ -38,6 +38,16 @@ program
     'Background color for Android adaptive icon',
     '#FFFFFF',
   )
+  .option(
+    '--banner <text>',
+    'Diagonal ribbon banner text (e.g. DEV, BETA, STAGING)',
+  )
+  .option('--banner-color <hex>', 'Ribbon color (default: auto from text)')
+  .option(
+    '--banner-position <pos>',
+    'Banner position: top-left, top-right, bottom-left, bottom-right',
+    'top-left',
+  )
   .action(async (input: string, opts) => {
     const updateInfo = readCachedUpdateInfo(VERSION);
     refreshCacheInBackground().catch(() => {});
@@ -53,6 +63,13 @@ program
       },
       bgColor: opts.bgColor,
       splashInputPath: opts.splashInput,
+      banner: opts.banner
+        ? {
+            text: opts.banner,
+            color: opts.bannerColor,
+            position: opts.bannerPosition as BannerPosition,
+          }
+        : undefined,
     };
 
     try {

package/src/lib.ts

@@ -4,12 +4,19 @@ export { generateFavicon } from './variants/favicon.js';
 export { generateSplashIcon } from './variants/splash.js';
 export { generateAndroidIcons } from './variants/android.js';
 export { validateSourceImage } from './utils/image.js';
+export {
+  applyBanner,
+  createBannerSvg,
+  shouldApplyBanner,
+} from './utils/banner.js';
 export {
   isIconComposerFolder,
   renderIconComposerFolder,
 } from './utils/icon-composer.js';
 export { OUTPUT_FILES, resolveOutputPath } from './utils/paths.js';
 export type {
+  BannerOptions,
+  BannerPosition,
   VariantFlags,
   GeneratorOptions,
   GenerationResult,

package/src/types.ts

@@ -1,3 +1,15 @@
+export type BannerPosition =
+  | 'top-left'
+  | 'top-right'
+  | 'bottom-left'
+  | 'bottom-right';
+
+export interface BannerOptions {
+  text: string;
+  color?: string;
+  position?: BannerPosition;
+}
+
 export interface VariantFlags {
   android: boolean;
   favicon: boolean;
@@ -11,6 +23,7 @@ export interface GeneratorOptions {
   variants: VariantFlags;
   bgColor: string;
   splashInputPath?: string;
+  banner?: BannerOptions;
   silent?: boolean;
 }
 

package/src/utils/banner.ts

@@ -0,0 +1,116 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import sharp from 'sharp';
+import type {
+  BannerOptions,
+  BannerPosition,
+  GenerationResult,
+} from '../types.js';
+
+const DEFAULT_COLORS: Record<string, string> = {
+  DEV: '#4CAF50',
+  BETA: '#FF9800',
+  STAGING: '#2196F3',
+  ALPHA: '#9C27B0',
+};
+
+const FALLBACK_COLOR = '#F44336';
+
+function resolveColor(text: string, color?: string): string {
+  if (color) return color;
+  return DEFAULT_COLORS[text.toUpperCase()] ?? FALLBACK_COLOR;
+}
+
+export function createBannerSvg(
+  size: number,
+  text: string,
+  color: string,
+  position: BannerPosition,
+): string {
+  const ribbonWidth = Math.round(size * 0.42);
+  const ribbonHeight = Math.round(size * 0.08);
+  const fontSize = Math.round(ribbonHeight * 0.6);
+  const halfDiag = ribbonWidth / 2;
+
+  // Center of the ribbon in each corner
+  let cx: number;
+  let cy: number;
+  let angle: number;
+
+  switch (position) {
+    case 'top-left':
+      cx = size * 0.2;
+      cy = size * 0.2;
+      angle = -45;
+      break;
+    case 'top-right':
+      cx = size * 0.8;
+      cy = size * 0.2;
+      angle = 45;
+      break;
+    case 'bottom-left':
+      cx = size * 0.2;
+      cy = size * 0.8;
+      angle = 45;
+      break;
+    case 'bottom-right':
+      cx = size * 0.8;
+      cy = size * 0.8;
+      angle = -45;
+      break;
+  }
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 ${size} ${size}">
+  <g transform="translate(${cx}, ${cy}) rotate(${angle})">
+    <rect x="${-halfDiag}" y="${-ribbonHeight / 2}" width="${ribbonWidth}" height="${ribbonHeight}" fill="${color}"/>
+    <text x="0" y="0" text-anchor="middle" dominant-baseline="central"
+      font-family="Arial, Helvetica, sans-serif" font-weight="bold"
+      font-size="${fontSize}" fill="white">${escapeXml(text)}</text>
+  </g>
+</svg>`;
+}
+
+function escapeXml(s: string): string {
+  return s
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+export async function applyBanner(
+  result: GenerationResult,
+  bannerOptions: BannerOptions,
+): Promise<void> {
+  const color = resolveColor(bannerOptions.text, bannerOptions.color);
+  const position = bannerOptions.position ?? 'top-left';
+
+  const meta = await sharp(result.filePath).metadata();
+  const size = meta.width ?? 1024;
+
+  const svg = createBannerSvg(size, bannerOptions.text, color, position);
+  const svgBuffer = Buffer.from(svg);
+
+  const tmpPath = result.filePath + '.tmp';
+
+  await sharp(result.filePath)
+    .composite([{ input: svgBuffer, top: 0, left: 0 }])
+    .png()
+    .toFile(tmpPath);
+
+  fs.renameSync(tmpPath, result.filePath);
+
+  const stat = fs.statSync(result.filePath);
+  result.size = stat.size;
+}
+
+/** Files that should not receive a banner overlay. */
+const SKIP_FILES = new Set([
+  'favicon.png',
+  'android-icon-background.png',
+  'monochrome-icon.png',
+]);
+
+export function shouldApplyBanner(filePath: string): boolean {
+  return !SKIP_FILES.has(path.basename(filePath));
+}

package/src/utils/icon-composer.ts

@@ -30,14 +30,21 @@ interface IconComposerGroup {
   translucency?: { enabled: boolean; value: number };
 }
 
+interface IconComposerFillSpecialization {
+  appearance?: string;
+  value: IconComposerFill;
+}
+
 interface IconComposerManifest {
-  fill: IconComposerFill;
+  fill?: IconComposerFill;
+  'fill-specializations'?: IconComposerFillSpecialization[];
   groups: IconComposerGroup[];
   'supported-platforms'?: unknown;
 }
 
 export interface IconComposerResult {
   composedImagePath: string;
+  foregroundImagePath: string;
   extractedBgColor: string;
 }
 
@@ -195,9 +202,16 @@ export async function renderIconComposerFolder(
   const manifestRaw = fs.readFileSync(manifestPath, 'utf-8');
   const manifest: IconComposerManifest = JSON.parse(manifestRaw);
 
+  // Resolve fill: prefer top-level `fill`, fall back to first `fill-specializations` entry (light appearance)
+  const fill: IconComposerFill =
+    manifest.fill ??
+    manifest['fill-specializations']?.find((s) => !s.appearance)?.value ??
+    manifest['fill-specializations']?.[0]?.value ??
+    {};
+
   // Create background
   const { buffer: backgroundBuffer, bgColor: extractedBgColor } =
-    await createBackground(manifest.fill);
+    await createBackground(fill);
 
   // Build composite operations for each layer
   const compositeOps: sharp.OverlayOptions[] = [];
@@ -267,7 +281,7 @@ export async function renderIconComposerFolder(
     }
   }
 
-  // Compose final image
+  // Compose final image (with background)
   const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'iconwolf-compose-'));
   const composedPath = path.join(tmpDir, 'composed-icon.png');
 
@@ -276,8 +290,28 @@ export async function renderIconComposerFolder(
     .png()
     .toFile(composedPath);
 
+  // Compose foreground-only image (transparent background) for splash
+  const foregroundPath = path.join(tmpDir, 'foreground-icon.png');
+
+  const transparentBg = await sharp({
+    create: {
+      width: ICON_SIZE,
+      height: ICON_SIZE,
+      channels: 4,
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+    },
+  })
+    .png()
+    .toBuffer();
+
+  await sharp(transparentBg)
+    .composite(compositeOps)
+    .png()
+    .toFile(foregroundPath);
+
   return {
     composedImagePath: composedPath,
+    foregroundImagePath: foregroundPath,
     extractedBgColor,
   };
 }

package/tests/cli.test.ts

@@ -40,6 +40,9 @@ describe('CLI end-to-end', () => {
     expect(output).toContain('--icon');
     expect(output).toContain('--splash-input');
     expect(output).toContain('--bg-color');
+    expect(output).toContain('--banner');
+    expect(output).toContain('--banner-color');
+    expect(output).toContain('--banner-position');
   });
 
   it('generates icon.png via CLI with --icon flag', () => {
@@ -73,6 +76,14 @@ describe('CLI end-to-end', () => {
     }).toThrow();
   });
 
+  it('generates icon with --banner DEV flag', () => {
+    const outDir = path.join(tmpDir, 'cli-banner');
+
+    runCli(`${testPng} --icon --banner DEV -o ${outDir}`);
+
+    expect(fs.existsSync(path.join(outDir, 'icon.png'))).toBe(true);
+  });
+
   it('generates favicon when --favicon flag is used', () => {
     const outDir = path.join(tmpDir, 'cli-favicon');
 

package/tests/generator.test.ts

@@ -347,6 +347,54 @@ describe('generate', () => {
     expect(fs.existsSync(path.join(outDir, 'splash-icon.png'))).toBe(true);
   });
 
+  it('applies banner to icon, adaptive-icon, and splash but not favicon', async () => {
+    const outDir = path.join(tmpDir, 'banner-test');
+
+    const results = await generate({
+      inputPath: testPng,
+      outputDir: outDir,
+      variants: { android: false, favicon: false, splash: false, icon: false },
+      bgColor: '#FFFFFF',
+      banner: { text: 'DEV' },
+    });
+
+    // All 4 default files should exist
+    expect(fs.existsSync(path.join(outDir, OUTPUT_FILES.icon))).toBe(true);
+    expect(fs.existsSync(path.join(outDir, OUTPUT_FILES.favicon))).toBe(true);
+    expect(fs.existsSync(path.join(outDir, OUTPUT_FILES.splashIcon))).toBe(
+      true,
+    );
+    expect(
+      fs.existsSync(path.join(outDir, OUTPUT_FILES.androidForeground)),
+    ).toBe(true);
+    expect(results.length).toBe(4);
+  });
+
+  it('skips banner on background and monochrome android variants', async () => {
+    const outDir = path.join(tmpDir, 'banner-android');
+
+    const results = await generate({
+      inputPath: testPng,
+      outputDir: outDir,
+      variants: { android: true, favicon: false, splash: false, icon: false },
+      bgColor: '#FFFFFF',
+      banner: { text: 'STAGING', color: '#2196F3' },
+    });
+
+    // adaptive-icon.png should exist (banner applied)
+    expect(
+      fs.existsSync(path.join(outDir, OUTPUT_FILES.androidForeground)),
+    ).toBe(true);
+    // background and monochrome should exist (no banner)
+    expect(
+      fs.existsSync(path.join(outDir, OUTPUT_FILES.androidBackground)),
+    ).toBe(true);
+    expect(
+      fs.existsSync(path.join(outDir, OUTPUT_FILES.androidMonochrome)),
+    ).toBe(true);
+    expect(results.length).toBe(3);
+  });
+
   it('throws on missing splash input file', async () => {
     const outDir = path.join(tmpDir, 'splash-missing');
 

package/tests/utils/banner.test.ts

@@ -0,0 +1,142 @@
+import fs from 'node:fs';
+import sharp from 'sharp';
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import {
+  createBannerSvg,
+  applyBanner,
+  shouldApplyBanner,
+} from '../../src/utils/banner.js';
+import { createTestPng, createTmpDir, cleanDir } from '../helpers.js';
+
+let tmpDir: string;
+
+beforeAll(() => {
+  tmpDir = createTmpDir();
+});
+
+afterAll(() => {
+  cleanDir(tmpDir);
+});
+
+describe('createBannerSvg', () => {
+  it('generates valid SVG with correct dimensions', () => {
+    const svg = createBannerSvg(1024, 'DEV', '#4CAF50', 'top-left');
+    expect(svg).toContain('width="1024"');
+    expect(svg).toContain('height="1024"');
+    expect(svg).toContain('DEV');
+    expect(svg).toContain('#4CAF50');
+  });
+
+  it('renders different positions', () => {
+    const positions = [
+      'top-left',
+      'top-right',
+      'bottom-left',
+      'bottom-right',
+    ] as const;
+
+    for (const pos of positions) {
+      const svg = createBannerSvg(1024, 'BETA', '#FF9800', pos);
+      expect(svg).toContain('BETA');
+      expect(svg).toContain('<svg');
+    }
+  });
+
+  it('escapes XML characters in text', () => {
+    const svg = createBannerSvg(1024, 'A&B<C>', '#FF0000', 'top-left');
+    expect(svg).toContain('A&amp;B&lt;C&gt;');
+  });
+
+  it('scales ribbon proportionally to icon size', () => {
+    const svg512 = createBannerSvg(512, 'DEV', '#4CAF50', 'top-left');
+    const svg1024 = createBannerSvg(1024, 'DEV', '#4CAF50', 'top-left');
+    expect(svg512).toContain('width="512"');
+    expect(svg1024).toContain('width="1024"');
+  });
+});
+
+describe('applyBanner', () => {
+  it('composites banner onto a PNG file', async () => {
+    const pngPath = await createTestPng(1024, 1024, tmpDir, 'banner-test.png');
+    const originalSize = fs.statSync(pngPath).size;
+
+    const result = {
+      filePath: pngPath,
+      width: 1024,
+      height: 1024,
+      size: originalSize,
+    };
+
+    await applyBanner(result, { text: 'DEV' });
+
+    expect(fs.existsSync(pngPath)).toBe(true);
+    // The file should still be a valid PNG
+    const meta = await sharp(pngPath).metadata();
+    expect(meta.width).toBe(1024);
+    expect(meta.height).toBe(1024);
+    expect(meta.format).toBe('png');
+    // Size in result should be updated
+    expect(result.size).toBe(fs.statSync(pngPath).size);
+  });
+
+  it('uses custom color when provided', async () => {
+    const pngPath = await createTestPng(
+      1024,
+      1024,
+      tmpDir,
+      'banner-custom-color.png',
+    );
+    const result = {
+      filePath: pngPath,
+      width: 1024,
+      height: 1024,
+      size: fs.statSync(pngPath).size,
+    };
+
+    await applyBanner(result, { text: 'TEST', color: '#FF00FF' });
+
+    const meta = await sharp(pngPath).metadata();
+    expect(meta.width).toBe(1024);
+  });
+
+  it('uses custom position', async () => {
+    const pngPath = await createTestPng(1024, 1024, tmpDir, 'banner-pos.png');
+    const result = {
+      filePath: pngPath,
+      width: 1024,
+      height: 1024,
+      size: fs.statSync(pngPath).size,
+    };
+
+    await applyBanner(result, { text: 'DEV', position: 'bottom-right' });
+
+    const meta = await sharp(pngPath).metadata();
+    expect(meta.width).toBe(1024);
+  });
+});
+
+describe('shouldApplyBanner', () => {
+  it('returns true for icon.png', () => {
+    expect(shouldApplyBanner('/out/icon.png')).toBe(true);
+  });
+
+  it('returns true for adaptive-icon.png', () => {
+    expect(shouldApplyBanner('/out/adaptive-icon.png')).toBe(true);
+  });
+
+  it('returns true for splash-icon.png', () => {
+    expect(shouldApplyBanner('/out/splash-icon.png')).toBe(true);
+  });
+
+  it('returns false for favicon.png', () => {
+    expect(shouldApplyBanner('/out/favicon.png')).toBe(false);
+  });
+
+  it('returns false for android-icon-background.png', () => {
+    expect(shouldApplyBanner('/out/android-icon-background.png')).toBe(false);
+  });
+
+  it('returns false for monochrome-icon.png', () => {
+    expect(shouldApplyBanner('/out/monochrome-icon.png')).toBe(false);
+  });
+});