@achimismaili/easy-web-brand 0.0.0

package/README.md

@@ -0,0 +1,25 @@
+# @achimismaili/easy-web-brand
+
+Logo trimming and favicon generation for the easy-web ecosystem.
+
+## Install
+
+```bash
+pnpm add -D @achimismaili/easy-web-brand
+```
+
+## Usage (CLI)
+
+```bash
+easy-web-brand trim src/assets/logos
+easy-web-brand favicons src/assets/logos --out src/assets/logos/favicons
+```
+
+## Usage (API)
+
+```ts
+import { trimFolder, generateFaviconsForFolder } from '@achimismaili/easy-web-brand';
+
+await trimFolder('src/assets/logos');
+await generateFaviconsForFolder('src/assets/logos', 'src/assets/logos/favicons');
+```

package/dist/chunk-K657YEVU.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+// src/trim.ts
+import sharp from "sharp";
+import { readdir, writeFile } from "fs/promises";
+import { join, extname } from "path";
+async function trimLogos(input, opts) {
+  const threshold = opts?.threshold ?? 10;
+  const minOutputDim = opts?.minOutputDim ?? 50;
+  const paddingPct = opts?.paddingPct ?? 2;
+  const minPaddingPx = opts?.minPaddingPx ?? 10;
+  const origMeta = await sharp(input).metadata();
+  const origW = origMeta.width;
+  const origH = origMeta.height;
+  const { data: rawData, info: rawInfo } = await sharp(input).raw().toBuffer({ resolveWithObject: true });
+  const hasAlpha = rawInfo.channels === 4;
+  const topLeftAlpha = hasAlpha ? rawData[3] : 255;
+  const mode = hasAlpha && topLeftAlpha === 0 ? "transparent" : "white";
+  const { data: trimmedPng, info: trimInfo } = await sharp(input).trim({ threshold }).png().toBuffer({ resolveWithObject: true });
+  const trimW = trimInfo.width;
+  const trimH = trimInfo.height;
+  if (trimW === origW && trimH === origH) {
+    const originalBuffer = Buffer.isBuffer(input) ? input : await sharp(input).png().toBuffer();
+    return {
+      buffer: originalBuffer,
+      changed: false,
+      before: { w: origW, h: origH },
+      after: { w: trimW, h: trimH }
+    };
+  }
+  if (trimW < minOutputDim || trimH < minOutputDim) {
+    const label = typeof input === "string" ? input : "<buffer>";
+    throw new Error(
+      `trim produced pathologically small output: ${trimW}x${trimH}, refusing to overwrite ${label}`
+    );
+  }
+  const pad = Math.max(minPaddingPx, Math.round(paddingPct / 100 * Math.min(trimW, trimH)));
+  const background = mode === "transparent" ? { r: 0, g: 0, b: 0, alpha: 0 } : { r: 255, g: 255, b: 255, alpha: 1 };
+  const resultBuffer = await sharp(trimmedPng).extend({ top: pad, bottom: pad, left: pad, right: pad, background }).png({ compressionLevel: 9, palette: false }).toBuffer();
+  const finalMeta = await sharp(resultBuffer).metadata();
+  return {
+    buffer: resultBuffer,
+    changed: true,
+    before: { w: origW, h: origH },
+    after: { w: finalMeta.width, h: finalMeta.height }
+  };
+}
+async function trimFolder(folderPath, opts) {
+  const files = await readdir(folderPath);
+  const pngs = files.filter((f) => extname(f).toLowerCase() === ".png");
+  const processed = [];
+  const skipped = [];
+  for (const file of pngs) {
+    const fullPath = join(folderPath, file);
+    const result = await trimLogos(fullPath, opts);
+    if (result.changed) {
+      await writeFile(fullPath, result.buffer);
+      processed.push(file);
+    } else {
+      skipped.push(file);
+    }
+  }
+  return { processed, skipped };
+}
+
+// src/favicons.ts
+import sharp2 from "sharp";
+import pngToIco from "png-to-ico";
+import { mkdir, readdir as readdir2, writeFile as writeFile2 } from "fs/promises";
+import { join as join2, extname as extname2, basename, resolve } from "path";
+async function generateFavicons(input, outDir, baseName) {
+  await mkdir(outDir, { recursive: true });
+  const [buf16, buf32, buf48, buf180, buf512] = await Promise.all([
+    // 16px: nearest-neighbor for pixel-crisp tiny icon
+    sharp2(input).resize(16, 16, {
+      fit: "contain",
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+      kernel: sharp2.kernel.nearest
+    }).png().toBuffer(),
+    // 32px and above: lanczos3 for quality
+    sharp2(input).resize(32, 32, {
+      fit: "contain",
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+      kernel: sharp2.kernel.lanczos3
+    }).png().toBuffer(),
+    sharp2(input).resize(48, 48, {
+      fit: "contain",
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+      kernel: sharp2.kernel.lanczos3
+    }).png().toBuffer(),
+    sharp2(input).resize(180, 180, {
+      fit: "contain",
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+      kernel: sharp2.kernel.lanczos3
+    }).png().toBuffer(),
+    sharp2(input).resize(512, 512, {
+      fit: "contain",
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+      kernel: sharp2.kernel.lanczos3
+    }).png().toBuffer()
+  ]);
+  const icoBuffer = await pngToIco([buf16, buf32, buf48]);
+  const icoPath = resolve(outDir, `${baseName}.ico`);
+  const png32Path = resolve(outDir, `${baseName}-32.png`);
+  const png180Path = resolve(outDir, `${baseName}-180.png`);
+  const png512Path = resolve(outDir, `${baseName}-512.png`);
+  await Promise.all([
+    writeFile2(icoPath, icoBuffer),
+    writeFile2(png32Path, buf32),
+    writeFile2(png180Path, buf180),
+    writeFile2(png512Path, buf512)
+  ]);
+  return { ico: icoPath, png32: png32Path, png180: png180Path, png512: png512Path };
+}
+async function generateFaviconsForFolder(folderPath, outDir) {
+  const files = await readdir2(folderPath);
+  const sources = files.filter(
+    (f) => extname2(f).toLowerCase() === ".png" && !basename(f, ".png").endsWith("-white")
+  );
+  const results = [];
+  for (const file of sources) {
+    const base = basename(file, ".png");
+    const outputs = await generateFavicons(join2(folderPath, file), outDir, base);
+    results.push({ base, outputs });
+  }
+  return results;
+}
+
+export {
+  trimLogos,
+  trimFolder,
+  generateFavicons,
+  generateFaviconsForFolder
+};
+//# sourceMappingURL=chunk-K657YEVU.js.map

package/dist/chunk-K657YEVU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/trim.ts","../src/favicons.ts"],"sourcesContent":["import sharp from 'sharp';\nimport { readdir, writeFile } from 'node:fs/promises';\nimport { join, extname } from 'node:path';\n\nexport interface TrimOptions {\n  paddingPct?: number;    // default 2\n  minPaddingPx?: number;  // default 10\n  threshold?: number;     // default 10\n  minOutputDim?: number;  // default 50\n}\n\nexport interface TrimResult {\n  buffer: Buffer;\n  changed: boolean;\n  before: { w: number; h: number };\n  after: { w: number; h: number };\n}\n\n/**\n * Trim solid-color / transparent borders from a logo PNG and re-pad it with a small\n * background-aware margin. Auto-detects transparent vs white background by inspecting\n * the top-left pixel of the raw input.\n *\n * Sharp API note: `.metadata()` on a chained `.trim()` pipeline returns the ORIGINAL\n * header dimensions (it does not evaluate operations). To read post-trim dimensions we\n * must materialize the buffer via `.toBuffer({ resolveWithObject: true })` and read\n * `info.width` / `info.height`.\n */\nexport async function trimLogos(\n  input: string | Buffer,\n  opts?: TrimOptions,\n): Promise<TrimResult> {\n  const threshold = opts?.threshold ?? 10;\n  const minOutputDim = opts?.minOutputDim ?? 50;\n  const paddingPct = opts?.paddingPct ?? 2;\n  const minPaddingPx = opts?.minPaddingPx ?? 10;\n\n  // Read original dimensions from the input header.\n  const origMeta = await sharp(input).metadata();\n  const origW = origMeta.width!;\n  const origH = origMeta.height!;\n\n  // Detect background mode from the top-left pixel of the ORIGINAL image.\n  const { data: rawData, info: rawInfo } = await sharp(input)\n    .raw()\n    .toBuffer({ resolveWithObject: true });\n  const hasAlpha = rawInfo.channels === 4;\n  const topLeftAlpha = hasAlpha ? rawData[3]! : 255;\n  const mode: 'transparent' | 'white' = hasAlpha && topLeftAlpha === 0 ? 'transparent' : 'white';\n\n  // Perform the trim and capture the ACTUAL post-trim dimensions from the resulting buffer.\n  const { data: trimmedPng, info: trimInfo } = await sharp(input)\n    .trim({ threshold })\n    .png()\n    .toBuffer({ resolveWithObject: true });\n  const trimW = trimInfo.width;\n  const trimH = trimInfo.height;\n\n  // NO-OP SKIP: trim found nothing to remove — return the original bytes unchanged.\n  if (trimW === origW && trimH === origH) {\n    const originalBuffer = Buffer.isBuffer(input) ? input : await sharp(input).png().toBuffer();\n    return {\n      buffer: originalBuffer,\n      changed: false,\n      before: { w: origW, h: origH },\n      after: { w: trimW, h: trimH },\n    };\n  }\n\n  // OVER-TRIM GUARD: refuse to produce pathologically small outputs (e.g. threshold too high).\n  if (trimW < minOutputDim || trimH < minOutputDim) {\n    const label = typeof input === 'string' ? input : '<buffer>';\n    throw new Error(\n      `trim produced pathologically small output: ${trimW}x${trimH}, refusing to overwrite ${label}`,\n    );\n  }\n\n  // Add background-aware padding. paddingPct is a percentage of the shorter trimmed edge;\n  // minPaddingPx is a floor so tiny logos still get a comfortable margin.\n  const pad = Math.max(minPaddingPx, Math.round((paddingPct / 100) * Math.min(trimW, trimH)));\n  const background =\n    mode === 'transparent'\n      ? { r: 0, g: 0, b: 0, alpha: 0 }\n      : { r: 255, g: 255, b: 255, alpha: 1 };\n\n  const resultBuffer = await sharp(trimmedPng)\n    .extend({ top: pad, bottom: pad, left: pad, right: pad, background })\n    .png({ compressionLevel: 9, palette: false })\n    .toBuffer();\n\n  const finalMeta = await sharp(resultBuffer).metadata();\n  return {\n    buffer: resultBuffer,\n    changed: true,\n    before: { w: origW, h: origH },\n    after: { w: finalMeta.width!, h: finalMeta.height! },\n  };\n}\n\n/**\n * Trim every `*.png` in `folderPath` in-place. Files where the trim is a no-op are left\n * on disk untouched (skipped). Files where trim shrinks the image are overwritten with\n * the padded, re-encoded PNG.\n */\nexport async function trimFolder(\n  folderPath: string,\n  opts?: TrimOptions,\n): Promise<{ processed: string[]; skipped: string[] }> {\n  const files = await readdir(folderPath);\n  const pngs = files.filter((f) => extname(f).toLowerCase() === '.png');\n\n  const processed: string[] = [];\n  const skipped: string[] = [];\n\n  for (const file of pngs) {\n    const fullPath = join(folderPath, file);\n    const result = await trimLogos(fullPath, opts);\n    if (result.changed) {\n      await writeFile(fullPath, result.buffer);\n      processed.push(file);\n    } else {\n      skipped.push(file);\n    }\n  }\n\n  return { processed, skipped };\n}\n","import sharp from 'sharp';\nimport pngToIco from 'png-to-ico';\nimport { mkdir, readdir, writeFile } from 'node:fs/promises';\nimport { join, extname, basename, resolve } from 'node:path';\n\nexport interface FaviconOutputs {\n  ico: string;\n  png32: string;\n  png180: string;\n  png512: string;\n}\n\n/**\n * Generate a multi-resolution ICO (16/32/48 px frames) and three PNG sizes\n * (32×32, 180×180, 512×512) from a single transparent-background source PNG.\n *\n * All outputs are written to `outDir` with the given `baseName`:\n *   <baseName>.ico, <baseName>-32.png, <baseName>-180.png, <baseName>-512.png\n *\n * Kernel choice: 16px uses `nearest` for pixel-crisp tiny icons; 32/48/180/512 use\n * `lanczos3` for high-quality downscaling. Background is always transparent so the\n * source PNG's alpha channel is preserved through the resize pipeline.\n */\nexport async function generateFavicons(\n  input: string | Buffer,\n  outDir: string,\n  baseName: string,\n): Promise<FaviconOutputs> {\n  await mkdir(outDir, { recursive: true });\n\n  // Resize to all required sizes in parallel.\n  const [buf16, buf32, buf48, buf180, buf512] = await Promise.all([\n    // 16px: nearest-neighbor for pixel-crisp tiny icon\n    sharp(input)\n      .resize(16, 16, {\n        fit: 'contain',\n        background: { r: 0, g: 0, b: 0, alpha: 0 },\n        kernel: sharp.kernel.nearest,\n      })\n      .png()\n      .toBuffer(),\n    // 32px and above: lanczos3 for quality\n    sharp(input)\n      .resize(32, 32, {\n        fit: 'contain',\n        background: { r: 0, g: 0, b: 0, alpha: 0 },\n        kernel: sharp.kernel.lanczos3,\n      })\n      .png()\n      .toBuffer(),\n    sharp(input)\n      .resize(48, 48, {\n        fit: 'contain',\n        background: { r: 0, g: 0, b: 0, alpha: 0 },\n        kernel: sharp.kernel.lanczos3,\n      })\n      .png()\n      .toBuffer(),\n    sharp(input)\n      .resize(180, 180, {\n        fit: 'contain',\n        background: { r: 0, g: 0, b: 0, alpha: 0 },\n        kernel: sharp.kernel.lanczos3,\n      })\n      .png()\n      .toBuffer(),\n    sharp(input)\n      .resize(512, 512, {\n        fit: 'contain',\n        background: { r: 0, g: 0, b: 0, alpha: 0 },\n        kernel: sharp.kernel.lanczos3,\n      })\n      .png()\n      .toBuffer(),\n  ]);\n\n  // Build multi-res ICO from 16/32/48 frames. png-to-ico takes an array of PNG buffers\n  // and returns a single ICO buffer whose frame count equals the input array length.\n  const icoBuffer = await pngToIco([buf16, buf32, buf48]);\n\n  const icoPath = resolve(outDir, `${baseName}.ico`);\n  const png32Path = resolve(outDir, `${baseName}-32.png`);\n  const png180Path = resolve(outDir, `${baseName}-180.png`);\n  const png512Path = resolve(outDir, `${baseName}-512.png`);\n\n  await Promise.all([\n    writeFile(icoPath, icoBuffer),\n    writeFile(png32Path, buf32),\n    writeFile(png180Path, buf180),\n    writeFile(png512Path, buf512),\n  ]);\n\n  return { ico: icoPath, png32: png32Path, png180: png180Path, png512: png512Path };\n}\n\n/**\n * Generate favicon sets for every transparent-background logo in `folderPath`.\n * Files ending with `-white` are skipped (white-background logos produce ugly favicons).\n * Outputs land in `outDir` named after each source base name.\n */\nexport async function generateFaviconsForFolder(\n  folderPath: string,\n  outDir: string,\n): Promise<Array<{ base: string; outputs: FaviconOutputs }>> {\n  const files = await readdir(folderPath);\n  const sources = files.filter(\n    (f) => extname(f).toLowerCase() === '.png' && !basename(f, '.png').endsWith('-white'),\n  );\n\n  const results: Array<{ base: string; outputs: FaviconOutputs }> = [];\n  for (const file of sources) {\n    const base = basename(file, '.png');\n    const outputs = await generateFavicons(join(folderPath, file), outDir, base);\n    results.push({ base, outputs });\n  }\n  return results;\n}\n"],"mappings":"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","names":["sharp","readdir","writeFile","join","extname"]}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import {
+  generateFaviconsForFolder,
+  trimFolder
+} from "./chunk-K657YEVU.js";
+
+// src/cli.ts
+import mri from "mri";
+var USAGE = `
+easy-web-brand \u2014 logo trimming and favicon generation for the easy-web ecosystem
+
+Usage:
+  easy-web-brand trim <folder> [options]
+  easy-web-brand favicons <folder> --out=<outDir> [options]
+  easy-web-brand --help
+
+Commands:
+  trim      Trim blank canvas from all *.png files in <folder> in-place.
+  favicons  Generate multi-res ICO + PNG favicon sets from transparent logos in <folder>.
+
+Options:
+  --out=<dir>       Output directory for favicon generation (required for favicons command)
+  --padding=<pct>   Padding percentage after trim (default: 2)
+  --min-pad=<px>    Minimum padding in pixels (default: 10)
+  --threshold=<n>   Trim threshold: color similarity 0-100 (default: 10)
+  -h, --help        Show this help message
+`.trim();
+async function main() {
+  const argv = mri(process.argv.slice(2), {
+    boolean: ["help", "h"],
+    string: ["out"],
+    alias: { h: "help" }
+  });
+  if (argv.help || argv._.length === 0) {
+    process.stdout.write(USAGE + "\n");
+    process.exit(0);
+  }
+  const [command, folder] = argv._;
+  if (command !== "trim" && command !== "favicons") {
+    process.stderr.write(`Unknown command: "${command}"
+
+${USAGE}
+`);
+    process.exit(1);
+  }
+  if (!folder) {
+    process.stderr.write(`Error: <folder> argument is required.
+
+${USAGE}
+`);
+    process.exit(1);
+  }
+  if (command === "trim") {
+    const opts = {
+      paddingPct: argv["padding"] !== void 0 ? Number(argv["padding"]) : void 0,
+      minPaddingPx: argv["min-pad"] !== void 0 ? Number(argv["min-pad"]) : void 0,
+      threshold: argv["threshold"] !== void 0 ? Number(argv["threshold"]) : void 0
+    };
+    try {
+      const result = await trimFolder(folder, opts);
+      process.stdout.write(
+        `Trim complete: ${result.processed.length} processed, ${result.skipped.length} skipped.
+`
+      );
+      for (const f of result.processed) process.stdout.write(`  trimmed: ${f}
+`);
+      for (const f of result.skipped) process.stdout.write(`  skipped: ${f}
+`);
+    } catch (err) {
+      process.stderr.write(
+        `Error during trim: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+      process.exit(2);
+    }
+  } else if (command === "favicons") {
+    const outDir = argv["out"];
+    if (!outDir) {
+      process.stderr.write(`Error: --out=<dir> is required for the favicons command.
+
+${USAGE}
+`);
+      process.exit(1);
+    }
+    try {
+      const results = await generateFaviconsForFolder(folder, outDir);
+      process.stdout.write(`Favicons complete: ${results.length} sets generated.
+`);
+      for (const r of results) {
+        process.stdout.write(`  ${r.base}: ico, 32, 180, 512
+`);
+      }
+    } catch (err) {
+      process.stderr.write(
+        `Error during favicons: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+      process.exit(2);
+    }
+  }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import mri from 'mri';\nimport { trimFolder } from './trim.js';\nimport { generateFaviconsForFolder } from './favicons.js';\n\nconst USAGE = `\neasy-web-brand — logo trimming and favicon generation for the easy-web ecosystem\n\nUsage:\n  easy-web-brand trim <folder> [options]\n  easy-web-brand favicons <folder> --out=<outDir> [options]\n  easy-web-brand --help\n\nCommands:\n  trim      Trim blank canvas from all *.png files in <folder> in-place.\n  favicons  Generate multi-res ICO + PNG favicon sets from transparent logos in <folder>.\n\nOptions:\n  --out=<dir>       Output directory for favicon generation (required for favicons command)\n  --padding=<pct>   Padding percentage after trim (default: 2)\n  --min-pad=<px>    Minimum padding in pixels (default: 10)\n  --threshold=<n>   Trim threshold: color similarity 0-100 (default: 10)\n  -h, --help        Show this help message\n`.trim();\n\nasync function main(): Promise<void> {\n  const argv = mri(process.argv.slice(2), {\n    boolean: ['help', 'h'],\n    string: ['out'],\n    alias: { h: 'help' },\n  });\n\n  if (argv.help || argv._.length === 0) {\n    process.stdout.write(USAGE + '\\n');\n    process.exit(0);\n  }\n\n  const [command, folder] = argv._;\n\n  if (command !== 'trim' && command !== 'favicons') {\n    process.stderr.write(`Unknown command: \"${command}\"\\n\\n${USAGE}\\n`);\n    process.exit(1);\n  }\n\n  if (!folder) {\n    process.stderr.write(`Error: <folder> argument is required.\\n\\n${USAGE}\\n`);\n    process.exit(1);\n  }\n\n  if (command === 'trim') {\n    const opts = {\n      paddingPct: argv['padding'] !== undefined ? Number(argv['padding']) : undefined,\n      minPaddingPx: argv['min-pad'] !== undefined ? Number(argv['min-pad']) : undefined,\n      threshold: argv['threshold'] !== undefined ? Number(argv['threshold']) : undefined,\n    };\n    try {\n      const result = await trimFolder(folder, opts);\n      process.stdout.write(\n        `Trim complete: ${result.processed.length} processed, ${result.skipped.length} skipped.\\n`,\n      );\n      for (const f of result.processed) process.stdout.write(`  trimmed: ${f}\\n`);\n      for (const f of result.skipped) process.stdout.write(`  skipped: ${f}\\n`);\n    } catch (err) {\n      process.stderr.write(\n        `Error during trim: ${err instanceof Error ? err.message : String(err)}\\n`,\n      );\n      process.exit(2);\n    }\n  } else if (command === 'favicons') {\n    const outDir = argv['out'];\n    if (!outDir) {\n      process.stderr.write(`Error: --out=<dir> is required for the favicons command.\\n\\n${USAGE}\\n`);\n      process.exit(1);\n    }\n    try {\n      const results = await generateFaviconsForFolder(folder, outDir);\n      process.stdout.write(`Favicons complete: ${results.length} sets generated.\\n`);\n      for (const r of results) {\n        process.stdout.write(`  ${r.base}: ico, 32, 180, 512\\n`);\n      }\n    } catch (err) {\n      process.stderr.write(\n        `Error during favicons: ${err instanceof Error ? err.message : String(err)}\\n`,\n      );\n      process.exit(2);\n    }\n  }\n}\n\nmain();\n"],"mappings":";;;;;;;AAAA,OAAO,SAAS;AAIhB,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBZ,KAAK;AAEP,eAAe,OAAsB;AACnC,QAAM,OAAO,IAAI,QAAQ,KAAK,MAAM,CAAC,GAAG;AAAA,IACtC,SAAS,CAAC,QAAQ,GAAG;AAAA,IACrB,QAAQ,CAAC,KAAK;AAAA,IACd,OAAO,EAAE,GAAG,OAAO;AAAA,EACrB,CAAC;AAED,MAAI,KAAK,QAAQ,KAAK,EAAE,WAAW,GAAG;AACpC,YAAQ,OAAO,MAAM,QAAQ,IAAI;AACjC,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,CAAC,SAAS,MAAM,IAAI,KAAK;AAE/B,MAAI,YAAY,UAAU,YAAY,YAAY;AAChD,YAAQ,OAAO,MAAM,qBAAqB,OAAO;AAAA;AAAA,EAAQ,KAAK;AAAA,CAAI;AAClE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,CAAC,QAAQ;AACX,YAAQ,OAAO,MAAM;AAAA;AAAA,EAA4C,KAAK;AAAA,CAAI;AAC1E,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,YAAY,QAAQ;AACtB,UAAM,OAAO;AAAA,MACX,YAAY,KAAK,SAAS,MAAM,SAAY,OAAO,KAAK,SAAS,CAAC,IAAI;AAAA,MACtE,cAAc,KAAK,SAAS,MAAM,SAAY,OAAO,KAAK,SAAS,CAAC,IAAI;AAAA,MACxE,WAAW,KAAK,WAAW,MAAM,SAAY,OAAO,KAAK,WAAW,CAAC,IAAI;AAAA,IAC3E;AACA,QAAI;AACF,YAAM,SAAS,MAAM,WAAW,QAAQ,IAAI;AAC5C,cAAQ,OAAO;AAAA,QACb,kBAAkB,OAAO,UAAU,MAAM,eAAe,OAAO,QAAQ,MAAM;AAAA;AAAA,MAC/E;AACA,iBAAW,KAAK,OAAO,UAAW,SAAQ,OAAO,MAAM,cAAc,CAAC;AAAA,CAAI;AAC1E,iBAAW,KAAK,OAAO,QAAS,SAAQ,OAAO,MAAM,cAAc,CAAC;AAAA,CAAI;AAAA,IAC1E,SAAS,KAAK;AACZ,cAAQ,OAAO;AAAA,QACb,sBAAsB,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA;AAAA,MACxE;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,WAAW,YAAY,YAAY;AACjC,UAAM,SAAS,KAAK,KAAK;AACzB,QAAI,CAAC,QAAQ;AACX,cAAQ,OAAO,MAAM;AAAA;AAAA,EAA+D,KAAK;AAAA,CAAI;AAC7F,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI;AACF,YAAM,UAAU,MAAM,0BAA0B,QAAQ,MAAM;AAC9D,cAAQ,OAAO,MAAM,sBAAsB,QAAQ,MAAM;AAAA,CAAoB;AAC7E,iBAAW,KAAK,SAAS;AACvB,gBAAQ,OAAO,MAAM,KAAK,EAAE,IAAI;AAAA,CAAuB;AAAA,MACzD;AAAA,IACF,SAAS,KAAK;AACZ,cAAQ,OAAO;AAAA,QACb,0BAA0B,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA;AAAA,MAC5E;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF;AAEA,KAAK;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+interface TrimOptions {
+    paddingPct?: number;
+    minPaddingPx?: number;
+    threshold?: number;
+    minOutputDim?: number;
+}
+interface TrimResult {
+    buffer: Buffer;
+    changed: boolean;
+    before: {
+        w: number;
+        h: number;
+    };
+    after: {
+        w: number;
+        h: number;
+    };
+}
+/**
+ * Trim solid-color / transparent borders from a logo PNG and re-pad it with a small
+ * background-aware margin. Auto-detects transparent vs white background by inspecting
+ * the top-left pixel of the raw input.
+ *
+ * Sharp API note: `.metadata()` on a chained `.trim()` pipeline returns the ORIGINAL
+ * header dimensions (it does not evaluate operations). To read post-trim dimensions we
+ * must materialize the buffer via `.toBuffer({ resolveWithObject: true })` and read
+ * `info.width` / `info.height`.
+ */
+declare function trimLogos(input: string | Buffer, opts?: TrimOptions): Promise<TrimResult>;
+/**
+ * Trim every `*.png` in `folderPath` in-place. Files where the trim is a no-op are left
+ * on disk untouched (skipped). Files where trim shrinks the image are overwritten with
+ * the padded, re-encoded PNG.
+ */
+declare function trimFolder(folderPath: string, opts?: TrimOptions): Promise<{
+    processed: string[];
+    skipped: string[];
+}>;
+
+interface FaviconOutputs {
+    ico: string;
+    png32: string;
+    png180: string;
+    png512: string;
+}
+/**
+ * Generate a multi-resolution ICO (16/32/48 px frames) and three PNG sizes
+ * (32×32, 180×180, 512×512) from a single transparent-background source PNG.
+ *
+ * All outputs are written to `outDir` with the given `baseName`:
+ *   <baseName>.ico, <baseName>-32.png, <baseName>-180.png, <baseName>-512.png
+ *
+ * Kernel choice: 16px uses `nearest` for pixel-crisp tiny icons; 32/48/180/512 use
+ * `lanczos3` for high-quality downscaling. Background is always transparent so the
+ * source PNG's alpha channel is preserved through the resize pipeline.
+ */
+declare function generateFavicons(input: string | Buffer, outDir: string, baseName: string): Promise<FaviconOutputs>;
+/**
+ * Generate favicon sets for every transparent-background logo in `folderPath`.
+ * Files ending with `-white` are skipped (white-background logos produce ugly favicons).
+ * Outputs land in `outDir` named after each source base name.
+ */
+declare function generateFaviconsForFolder(folderPath: string, outDir: string): Promise<Array<{
+    base: string;
+    outputs: FaviconOutputs;
+}>>;
+
+export { type FaviconOutputs, type TrimOptions, type TrimResult, generateFavicons, generateFaviconsForFolder, trimFolder, trimLogos };

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  generateFavicons,
+  generateFaviconsForFolder,
+  trimFolder,
+  trimLogos
+} from "./chunk-K657YEVU.js";
+export {
+  generateFavicons,
+  generateFaviconsForFolder,
+  trimFolder,
+  trimLogos
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@achimismaili/easy-web-brand",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "import": "./dist/cli.js"
+    }
+  },
+  "bin": {
+    "easy-web-brand": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "mri": "^1.2.0",
+    "png-to-ico": "^3.0.2",
+    "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "eslint": "^9.0.0",
+    "execa": "^9.6.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.34.4",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/achimismaili/easy-web.git",
+    "directory": "packages/easy-web-brand"
+  },
+  "license": "MIT"
+}