@shba007/unascii 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+<p align="center">
+  <img src="./public/logo.png" lt="Logo" width="128" />
+<p>
+
+# unascii
+
+<!-- automd:badges color=blue -->
+
+[![npm version](https://img.shields.io/npm/v/unascii?color=blue)](https://npmjs.com/package/unascii)
+[![npm downloads](https://img.shields.io/npm/dm/unascii?color=blue)](https://npmjs.com/package/unascii)
+[![License](https://img.shields.io/npm/l/unascii?color=blue)](https://github.com/shba007/unascii?tab=MIT-1-ov-file)
+
+<!-- /automd -->
+
+> Print any image in ascii anywhere (browser/cli)
+
+## Usage (CLI)
+
+Globally run unascii with `npx`:
+
+```sh
+npx unascii@latest ./file/path.jpg
+```
+
+or
+
+```sh
+npx unascii@latest ./file/path.jpg --width=50
+```
+
+    Options:
+    --width Width of the image
+    --widthSkew Width Skew of the image
+    --output <console|file> Output as file or console
+    --characters <minimalist|normal|normal2|alphabetic|alphanumeric|numerical|extended|math|arrow|grayscale|max|codepage437|blockelement> Output Character Set
+    --grayscale <true|false> Output as grayscale or color only works with console
+
+Use `npx unascii --help` for more usage info.
+
+## Usage (API)
+
+Install package:
+
+<!-- automd:pm-install -->
+
+```sh
+# ✨ Auto-detect
+npx nypm install unascii
+
+# npm
+npm install unascii
+
+# yarn
+yarn add unascii
+
+# pnpm
+pnpm install unascii
+
+# bun
+bun install unascii
+```
+
+<!-- /automd -->
+
+Import:
+
+<!-- automd:jsimport cjs cdn name="pkg" -->
+
+**ESM** (Node.js, Bun)
+
+```js
+import {} from 'unascii'
+```
+
+**CommonJS** (Legacy Node.js)
+
+```js
+const {} = require('unascii')
+```
+
+**CDN** (Deno, Bun and Browsers)
+
+```js
+import {} from 'https://esm.sh/unascii'
+```
+
+<!-- /automd -->
+
+## Development
+
+<details>
+
+<summary>local development</summary>
+
+- Clone this repository
+- Install latest LTS version of [Node.js](https://nodejs.org/en/)
+- Enable [Corepack](https://github.com/nodejs/corepack) using `corepack enable`
+- Install dependencies using `pnpm install`
+- Run interactive tests using `pnpm dev`
+
+</details>
+
+## License
+
+<!-- automd:contributors license=MIT -->
+
+Published under the [MIT](https://github.com/shba007/unascii/blob/main/LICENSE) license.
+Made by [community](https://github.com/shba007/unascii/graphs/contributors) 💛
+<br><br>
+<a href="https://github.com/shba007/unascii/graphs/contributors">
+<img src="https://contrib.rocks/image?repo=shba007/unascii" />
+</a>
+
+<!-- /automd -->
+
+<!-- automd:with-automd -->
+
+---
+
+_🤖 auto updated with [automd](https://automd.unjs.io)_
+
+<!-- /automd -->

package/bin/unascii.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { runMain } from '../dist/cli.mjs'
+
+runMain()

package/dist/cli.cjs

@@ -0,0 +1,95 @@
+'use strict';
+
+const citty = require('citty');
+const consola = require('consola');
+const pathe = require('pathe');
+const unstorage = require('unstorage');
+const fsDriver = require('unstorage/drivers/fs');
+const index = require('./shared/unascii.BVDz6TJY.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const consola__default = /*#__PURE__*/_interopDefaultCompat(consola);
+const pathe__default = /*#__PURE__*/_interopDefaultCompat(pathe);
+const fsDriver__default = /*#__PURE__*/_interopDefaultCompat(fsDriver);
+
+const name = "@shba007/unascii";
+const version = "0.3.1";
+const description = "Print any image in ascii anywhere (browser/cli)";
+
+const storage = unstorage.createStorage({
+  driver: fsDriver__default({ base: "." })
+});
+const main = citty.defineCommand({
+  meta: {
+    name,
+    description,
+    version
+  },
+  args: {
+    path: {
+      type: "positional",
+      description: "Path of the image",
+      required: true
+    },
+    width: {
+      type: "string",
+      description: "Width of the image",
+      default: "32"
+    },
+    widthSkew: {
+      type: "string",
+      description: "Width Skew of the image",
+      default: "1.75"
+    },
+    output: {
+      type: "string",
+      description: "Output as file or console",
+      valueHint: "console|file",
+      default: "console"
+    },
+    characters: {
+      type: "string",
+      description: "Output Character Set",
+      valueHint: `minimalist|normal|normal2|alphabetic|alphanumeric|numerical|extended|math|arrow|grayscale|max|codepage437|blockelement`
+    },
+    grayscale: {
+      type: "boolean",
+      description: "Output as grayscale or color only works with console",
+      valueHint: "true|false"
+    },
+    verbose: {
+      type: "boolean",
+      description: "Verbose Output",
+      valueHint: "true|false",
+      default: false
+    }
+  },
+  async run({ args }) {
+    if (args.verbose) {
+      process.env.DEBUG = process.env.DEBUG || "true";
+    }
+    const print = await index.asciiPrint(args.path, {
+      width: args.width ? Number.parseInt(args.width) ?? void 0 : void 0,
+      widthSkew: args.widthSkew ? Number.parseFloat(args.widthSkew) ?? void 0 : void 0,
+      output: args.output,
+      characters: args.characters,
+      grayscale: args.grayscale
+    });
+    const image = await print.getImage();
+    if (args.output === "console") {
+      consola__default.info("\n" + image);
+    } else if (args.output === "file") {
+      const outputPath = pathe__default.format({ name: index.isURL(args.path) ? args.path.split("/").at(-1)?.split(".")[0] : pathe__default.parse(args.path).name, root: "/", ext: ".txt" });
+      await storage.setItem(outputPath, image);
+    }
+    if (!print) {
+      consola__default.error("Print not started.");
+      process.exit(1);
+    }
+  }
+});
+const runMain = () => citty.runMain(main);
+
+exports.main = main;
+exports.runMain = runMain;

package/dist/cli.d.cts

@@ -0,0 +1,44 @@
+import * as citty from 'citty';
+
+declare const main: citty.CommandDef<{
+    path: {
+        type: "positional";
+        description: string;
+        required: true;
+    };
+    width: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    widthSkew: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    output: {
+        type: "string";
+        description: string;
+        valueHint: string;
+        default: string;
+    };
+    characters: {
+        type: "string";
+        description: string;
+        valueHint: string;
+    };
+    grayscale: {
+        type: "boolean";
+        description: string;
+        valueHint: string;
+    };
+    verbose: {
+        type: "boolean";
+        description: string;
+        valueHint: string;
+        default: false;
+    };
+}>;
+declare const runMain: () => Promise<void>;
+
+export { main, runMain };

package/dist/cli.d.mts

@@ -0,0 +1,44 @@
+import * as citty from 'citty';
+
+declare const main: citty.CommandDef<{
+    path: {
+        type: "positional";
+        description: string;
+        required: true;
+    };
+    width: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    widthSkew: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    output: {
+        type: "string";
+        description: string;
+        valueHint: string;
+        default: string;
+    };
+    characters: {
+        type: "string";
+        description: string;
+        valueHint: string;
+    };
+    grayscale: {
+        type: "boolean";
+        description: string;
+        valueHint: string;
+    };
+    verbose: {
+        type: "boolean";
+        description: string;
+        valueHint: string;
+        default: false;
+    };
+}>;
+declare const runMain: () => Promise<void>;
+
+export { main, runMain };

package/dist/cli.d.ts

@@ -0,0 +1,44 @@
+import * as citty from 'citty';
+
+declare const main: citty.CommandDef<{
+    path: {
+        type: "positional";
+        description: string;
+        required: true;
+    };
+    width: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    widthSkew: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    output: {
+        type: "string";
+        description: string;
+        valueHint: string;
+        default: string;
+    };
+    characters: {
+        type: "string";
+        description: string;
+        valueHint: string;
+    };
+    grayscale: {
+        type: "boolean";
+        description: string;
+        valueHint: string;
+    };
+    verbose: {
+        type: "boolean";
+        description: string;
+        valueHint: string;
+        default: false;
+    };
+}>;
+declare const runMain: () => Promise<void>;
+
+export { main, runMain };

package/dist/cli.mjs

@@ -0,0 +1,86 @@
+import { defineCommand, runMain as runMain$1 } from 'citty';
+import consola from 'consola';
+import pathe from 'pathe';
+import { createStorage } from 'unstorage';
+import fsDriver from 'unstorage/drivers/fs';
+import { a as asciiPrint, i as isURL } from './shared/unascii.C-iPcHtB.mjs';
+
+const name = "@shba007/unascii";
+const version = "0.3.1";
+const description = "Print any image in ascii anywhere (browser/cli)";
+
+const storage = createStorage({
+  driver: fsDriver({ base: "." })
+});
+const main = defineCommand({
+  meta: {
+    name,
+    description,
+    version
+  },
+  args: {
+    path: {
+      type: "positional",
+      description: "Path of the image",
+      required: true
+    },
+    width: {
+      type: "string",
+      description: "Width of the image",
+      default: "32"
+    },
+    widthSkew: {
+      type: "string",
+      description: "Width Skew of the image",
+      default: "1.75"
+    },
+    output: {
+      type: "string",
+      description: "Output as file or console",
+      valueHint: "console|file",
+      default: "console"
+    },
+    characters: {
+      type: "string",
+      description: "Output Character Set",
+      valueHint: `minimalist|normal|normal2|alphabetic|alphanumeric|numerical|extended|math|arrow|grayscale|max|codepage437|blockelement`
+    },
+    grayscale: {
+      type: "boolean",
+      description: "Output as grayscale or color only works with console",
+      valueHint: "true|false"
+    },
+    verbose: {
+      type: "boolean",
+      description: "Verbose Output",
+      valueHint: "true|false",
+      default: false
+    }
+  },
+  async run({ args }) {
+    if (args.verbose) {
+      process.env.DEBUG = process.env.DEBUG || "true";
+    }
+    const print = await asciiPrint(args.path, {
+      width: args.width ? Number.parseInt(args.width) ?? void 0 : void 0,
+      widthSkew: args.widthSkew ? Number.parseFloat(args.widthSkew) ?? void 0 : void 0,
+      output: args.output,
+      characters: args.characters,
+      grayscale: args.grayscale
+    });
+    const image = await print.getImage();
+    if (args.output === "console") {
+      consola.info("\n" + image);
+    } else if (args.output === "file") {
+      const outputPath = pathe.format({ name: isURL(args.path) ? args.path.split("/").at(-1)?.split(".")[0] : pathe.parse(args.path).name, root: "/", ext: ".txt" });
+      await storage.setItem(outputPath, image);
+    }
+    if (!print) {
+      consola.error("Print not started.");
+      process.exit(1);
+    }
+  }
+});
+const runMain = () => runMain$1(main);
+
+export { main, runMain };

package/dist/index.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+const index = require('./shared/unascii.BVDz6TJY.cjs');
+
+
+
+exports.asciiPrint = index.asciiPrint;

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+type ASCIICharacterSet = keyof typeof asciiCharacterSet;
+declare const asciiCharacterSet: {
+    minimalist: string;
+    normal: string;
+    normal2: string;
+    alphabetic: string;
+    alphanumeric: string;
+    numerical: string;
+    extended: string;
+    math: string;
+    arrow: string;
+    grayscale: string;
+    max: string;
+    codepage437: string;
+    blockelement: string;
+};
+
+type OutputType = 'console' | 'file' | 'dom';
+interface PrintOptions {
+    width?: number;
+    widthSkew?: number;
+    widthScale?: number;
+    output?: OutputType;
+    characters?: ASCIICharacterSet;
+    grayscale?: boolean;
+}
+interface Print {
+    getImage: () => Promise<string>;
+}
+
+declare function asciiPrint(imagePath: string, opts?: PrintOptions): Promise<Print>;
+
+export { type OutputType, asciiPrint };

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+type ASCIICharacterSet = keyof typeof asciiCharacterSet;
+declare const asciiCharacterSet: {
+    minimalist: string;
+    normal: string;
+    normal2: string;
+    alphabetic: string;
+    alphanumeric: string;
+    numerical: string;
+    extended: string;
+    math: string;
+    arrow: string;
+    grayscale: string;
+    max: string;
+    codepage437: string;
+    blockelement: string;
+};
+
+type OutputType = 'console' | 'file' | 'dom';
+interface PrintOptions {
+    width?: number;
+    widthSkew?: number;
+    widthScale?: number;
+    output?: OutputType;
+    characters?: ASCIICharacterSet;
+    grayscale?: boolean;
+}
+interface Print {
+    getImage: () => Promise<string>;
+}
+
+declare function asciiPrint(imagePath: string, opts?: PrintOptions): Promise<Print>;
+
+export { type OutputType, asciiPrint };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+type ASCIICharacterSet = keyof typeof asciiCharacterSet;
+declare const asciiCharacterSet: {
+    minimalist: string;
+    normal: string;
+    normal2: string;
+    alphabetic: string;
+    alphanumeric: string;
+    numerical: string;
+    extended: string;
+    math: string;
+    arrow: string;
+    grayscale: string;
+    max: string;
+    codepage437: string;
+    blockelement: string;
+};
+
+type OutputType = 'console' | 'file' | 'dom';
+interface PrintOptions {
+    width?: number;
+    widthSkew?: number;
+    widthScale?: number;
+    output?: OutputType;
+    characters?: ASCIICharacterSet;
+    grayscale?: boolean;
+}
+interface Print {
+    getImage: () => Promise<string>;
+}
+
+declare function asciiPrint(imagePath: string, opts?: PrintOptions): Promise<Print>;
+
+export { type OutputType, asciiPrint };

package/dist/index.mjs

@@ -0,0 +1 @@
+export { a as asciiPrint } from './shared/unascii.C-iPcHtB.mjs';

package/dist/shared/unascii.BVDz6TJY.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+const asciiCharacterSet = {
+  minimalist: "#+-.",
+  normal: "@%#*+=-:.",
+  normal2: "&$Xx+;:.",
+  alphabetic: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
+  alphanumeric: "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890abcdefghijklmnopqrstuvwxyz",
+  numerical: "0896452317",
+  extended: "@%#{}[]()<>^*+=~-:.",
+  math: "+-\xD7\xF7=\u2260\u2248\u221E\u221A\u03C0",
+  arrow: "\u2191\u2197\u2192\u2198\u2193\u2199\u2190\u2196",
+  grayscale: `@$BWM#*oahkbdpwmZO0QCJYXzcvnxrjft/|()1{}[]-_+~<>i!lI;:,"^'.`,
+  max: `\xC6\xD1\xCA\u0152\xD8M\xC9\xCB\xC8\xC3\xC2WQB\xC5\xE6#N\xC1\xFEE\xC4\xC0HKR\u017D\u0153Xg\xD0\xEAq\xDB\u0160\xD5\xD4A\u20AC\xDFpm\xE3\xE2G\xB5\xF8\xF0\xE98\xDA\xDC$\xEBd\xD9\xFD\xE8\xD3\xDE\xD6\xE5\xFF\xD2b\xAAFD\xF1\xE1ZP\xE4\u0161\xC7\xE0h\xFB\u0178\xDDk\u0178\xAES9\u017EUTe\xB5uOyx\xCE\xBEf4\xF55\xF4\xFA&a\xFC\u21222\xF9\xE7w\xA9Y\xA30V\xC7Lr\xCC\xB33\xCF\xEC\xD3C@n\xC4\xF2s\xA2u\u2030\xBD\xBC\u2021zJ\u0123%\xA4Itoc\xABrjv1l\xAD=\xEF\xEC<>i7\u2020[\xBF?\xD7}*{+()/\xBB\xAB\u2022\xAC|!\xA1\xF7\xA6\xAF\u2014^\xAA\u201E""~\xB3\xBA\xB2\u2013\xB0\xAD\xB9\u2039\u203A;:''\u201A'\u02DC\u02C6\xB8\u2026\xB7\xA8\xB4`,
+  codepage437: "\u2588\u2593\u2592\u2591",
+  blockelement: "\u2588"
+};
+function rgbToHex({ r, g, b }) {
+  r = Math.max(0, Math.min(255, Math.round(r)));
+  g = Math.max(0, Math.min(255, Math.round(g)));
+  b = Math.max(0, Math.min(255, Math.round(b)));
+  const redHex = r.toString(16).padStart(2, "0");
+  const greenHex = g.toString(16).padStart(2, "0");
+  const blueHex = b.toString(16).padStart(2, "0");
+  return `#${redHex}${greenHex}${blueHex}`;
+}
+function isURL(str) {
+  const urlPattern = /^(https?:\/\/)?([\d.a-z-]+)\.([.a-z]{2,6})([\w ./-]*)*\/?$/;
+  return urlPattern.test(str);
+}
+
+let createCanvas;
+let loadImage;
+let colorizer;
+async function loadFunctions() {
+  if (process.env.BROWSER) {
+    let createCanvasBrowser = function(width, height) {
+      const canvas = document.createElement("canvas");
+      canvas.width = width;
+      canvas.height = height;
+      return canvas;
+    };
+    async function loadImageBrowser(url) {
+      return new Promise((resolve) => {
+        const image = new Image();
+        image.crossOrigin = "Anonymous";
+        image.addEventListener("load", () => resolve(image));
+        image.src = url;
+      });
+    }
+    createCanvas = createCanvasBrowser;
+    loadImage = loadImageBrowser;
+    colorizer = (color, char, output) => output === "console" ? char : `<span style="color: ${color}">${char}</span>`;
+  } else {
+    try {
+      const { createCanvas: createCanvasNode, loadImage: loadImageNode } = await import('canvas');
+      const { Chalk } = await import('chalk');
+      createCanvas = createCanvasNode;
+      loadImage = loadImageNode;
+      const chalk = new Chalk();
+      colorizer = (color, char, output) => output === "console" ? chalk.hex(color)(char) : char;
+    } catch {
+      throw new Error("Unable to import canvas/chalk modules");
+    }
+  }
+}
+function getAsciiChar(grayscale, widthScale, characterSet) {
+  const chars = asciiCharacterSet[characterSet] + " ".repeat(widthScale);
+  const index = Math.floor(grayscale * (chars.length - 1) / 255);
+  return chars[index];
+}
+function imageDataToASCII(imageData, widthScale, characterSet, isGrayscale, outputType) {
+  let ascii = "";
+  const { width, height, data } = imageData;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const i = (y * width + x) * 4;
+      const r = data[i];
+      const g = data[i + 1];
+      const b = data[i + 2];
+      const a = data[i + 3];
+      if (a < 16) {
+        ascii += " ";
+        continue;
+      }
+      const brightness = 0.3 * r + 0.59 * g + 0.11 * b;
+      let char = getAsciiChar(brightness, widthScale, characterSet);
+      if (!isGrayscale) {
+        const hexColor = rgbToHex({ r, g, b });
+        char = colorizer(hexColor, char, outputType);
+      }
+      ascii += char;
+    }
+    ascii += "\n";
+  }
+  return ascii;
+}
+async function imagePathToASCII(imagePath, width, widthSkew, widthScale, characterSet, isGrayscale, outputType) {
+  if (process.env.DEBUG) console.time("loadImage");
+  const image = await loadImage(imagePath);
+  if (process.env.DEBUG) console.timeEnd("loadImage");
+  const aspectRatio = image.width / image.height;
+  const canvas = createCanvas(width * widthSkew, Math.floor(width / aspectRatio));
+  const ctx = canvas.getContext("2d");
+  if (!ctx)
+    throw new Error("Canvas Context Undefined");
+  ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
+  const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+  if (process.env.DEBUG) console.time("imageDataToASCII");
+  const data = imageDataToASCII(imageData, widthScale, characterSet, isGrayscale, outputType);
+  if (process.env.DEBUG) console.timeEnd("imageDataToASCII");
+  return data;
+}
+async function asciiPrint(imagePath, opts) {
+  const { width = 32, widthSkew = 1.75, widthScale = 1, output = "console", characters = "alphanumeric", grayscale = false } = opts ?? {};
+  await loadFunctions();
+  if (process.env.DEBUG) console.time("imagePathToASCII");
+  const image = imagePathToASCII(imagePath, width, widthSkew, widthScale, characters, grayscale, output);
+  if (process.env.DEBUG) console.timeEnd("imagePathToASCII");
+  return {
+    getImage: async () => image
+  };
+}
+
+exports.asciiPrint = asciiPrint;
+exports.isURL = isURL;

package/dist/shared/unascii.C-iPcHtB.mjs

@@ -0,0 +1,123 @@
+const asciiCharacterSet = {
+  minimalist: "#+-.",
+  normal: "@%#*+=-:.",
+  normal2: "&$Xx+;:.",
+  alphabetic: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
+  alphanumeric: "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890abcdefghijklmnopqrstuvwxyz",
+  numerical: "0896452317",
+  extended: "@%#{}[]()<>^*+=~-:.",
+  math: "+-\xD7\xF7=\u2260\u2248\u221E\u221A\u03C0",
+  arrow: "\u2191\u2197\u2192\u2198\u2193\u2199\u2190\u2196",
+  grayscale: `@$BWM#*oahkbdpwmZO0QCJYXzcvnxrjft/|()1{}[]-_+~<>i!lI;:,"^'.`,
+  max: `\xC6\xD1\xCA\u0152\xD8M\xC9\xCB\xC8\xC3\xC2WQB\xC5\xE6#N\xC1\xFEE\xC4\xC0HKR\u017D\u0153Xg\xD0\xEAq\xDB\u0160\xD5\xD4A\u20AC\xDFpm\xE3\xE2G\xB5\xF8\xF0\xE98\xDA\xDC$\xEBd\xD9\xFD\xE8\xD3\xDE\xD6\xE5\xFF\xD2b\xAAFD\xF1\xE1ZP\xE4\u0161\xC7\xE0h\xFB\u0178\xDDk\u0178\xAES9\u017EUTe\xB5uOyx\xCE\xBEf4\xF55\xF4\xFA&a\xFC\u21222\xF9\xE7w\xA9Y\xA30V\xC7Lr\xCC\xB33\xCF\xEC\xD3C@n\xC4\xF2s\xA2u\u2030\xBD\xBC\u2021zJ\u0123%\xA4Itoc\xABrjv1l\xAD=\xEF\xEC<>i7\u2020[\xBF?\xD7}*{+()/\xBB\xAB\u2022\xAC|!\xA1\xF7\xA6\xAF\u2014^\xAA\u201E""~\xB3\xBA\xB2\u2013\xB0\xAD\xB9\u2039\u203A;:''\u201A'\u02DC\u02C6\xB8\u2026\xB7\xA8\xB4`,
+  codepage437: "\u2588\u2593\u2592\u2591",
+  blockelement: "\u2588"
+};
+function rgbToHex({ r, g, b }) {
+  r = Math.max(0, Math.min(255, Math.round(r)));
+  g = Math.max(0, Math.min(255, Math.round(g)));
+  b = Math.max(0, Math.min(255, Math.round(b)));
+  const redHex = r.toString(16).padStart(2, "0");
+  const greenHex = g.toString(16).padStart(2, "0");
+  const blueHex = b.toString(16).padStart(2, "0");
+  return `#${redHex}${greenHex}${blueHex}`;
+}
+function isURL(str) {
+  const urlPattern = /^(https?:\/\/)?([\d.a-z-]+)\.([.a-z]{2,6})([\w ./-]*)*\/?$/;
+  return urlPattern.test(str);
+}
+
+let createCanvas;
+let loadImage;
+let colorizer;
+async function loadFunctions() {
+  if (process.env.BROWSER) {
+    let createCanvasBrowser = function(width, height) {
+      const canvas = document.createElement("canvas");
+      canvas.width = width;
+      canvas.height = height;
+      return canvas;
+    };
+    async function loadImageBrowser(url) {
+      return new Promise((resolve) => {
+        const image = new Image();
+        image.crossOrigin = "Anonymous";
+        image.addEventListener("load", () => resolve(image));
+        image.src = url;
+      });
+    }
+    createCanvas = createCanvasBrowser;
+    loadImage = loadImageBrowser;
+    colorizer = (color, char, output) => output === "console" ? char : `<span style="color: ${color}">${char}</span>`;
+  } else {
+    try {
+      const { createCanvas: createCanvasNode, loadImage: loadImageNode } = await import('canvas');
+      const { Chalk } = await import('chalk');
+      createCanvas = createCanvasNode;
+      loadImage = loadImageNode;
+      const chalk = new Chalk();
+      colorizer = (color, char, output) => output === "console" ? chalk.hex(color)(char) : char;
+    } catch {
+      throw new Error("Unable to import canvas/chalk modules");
+    }
+  }
+}
+function getAsciiChar(grayscale, widthScale, characterSet) {
+  const chars = asciiCharacterSet[characterSet] + " ".repeat(widthScale);
+  const index = Math.floor(grayscale * (chars.length - 1) / 255);
+  return chars[index];
+}
+function imageDataToASCII(imageData, widthScale, characterSet, isGrayscale, outputType) {
+  let ascii = "";
+  const { width, height, data } = imageData;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const i = (y * width + x) * 4;
+      const r = data[i];
+      const g = data[i + 1];
+      const b = data[i + 2];
+      const a = data[i + 3];
+      if (a < 16) {
+        ascii += " ";
+        continue;
+      }
+      const brightness = 0.3 * r + 0.59 * g + 0.11 * b;
+      let char = getAsciiChar(brightness, widthScale, characterSet);
+      if (!isGrayscale) {
+        const hexColor = rgbToHex({ r, g, b });
+        char = colorizer(hexColor, char, outputType);
+      }
+      ascii += char;
+    }
+    ascii += "\n";
+  }
+  return ascii;
+}
+async function imagePathToASCII(imagePath, width, widthSkew, widthScale, characterSet, isGrayscale, outputType) {
+  if (process.env.DEBUG) console.time("loadImage");
+  const image = await loadImage(imagePath);
+  if (process.env.DEBUG) console.timeEnd("loadImage");
+  const aspectRatio = image.width / image.height;
+  const canvas = createCanvas(width * widthSkew, Math.floor(width / aspectRatio));
+  const ctx = canvas.getContext("2d");
+  if (!ctx)
+    throw new Error("Canvas Context Undefined");
+  ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
+  const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+  if (process.env.DEBUG) console.time("imageDataToASCII");
+  const data = imageDataToASCII(imageData, widthScale, characterSet, isGrayscale, outputType);
+  if (process.env.DEBUG) console.timeEnd("imageDataToASCII");
+  return data;
+}
+async function asciiPrint(imagePath, opts) {
+  const { width = 32, widthSkew = 1.75, widthScale = 1, output = "console", characters = "alphanumeric", grayscale = false } = opts ?? {};
+  await loadFunctions();
+  if (process.env.DEBUG) console.time("imagePathToASCII");
+  const image = imagePathToASCII(imagePath, width, widthSkew, widthScale, characters, grayscale, output);
+  if (process.env.DEBUG) console.timeEnd("imagePathToASCII");
+  return {
+    getImage: async () => image
+  };
+}
+
+export { asciiPrint as a, isURL as i };

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@shba007/unascii",
+  "version": "0.3.1",
+  "description": "Print any image in ascii anywhere (browser/cli)",
+  "author": "Shirsendu Bairagi <shirsendu2001@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shba007/unascii.git"
+  },
+  "keywords": [],
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.mjs",
+      "require": "./dist/cli.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "unascii": "./bin/unascii.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "volta": {
+    "node": "20.18.1"
+  },
+  "engines": {
+    "node": "^20.15.0",
+    "pnpm": "^9.15.0"
+  },
+  "dependencies": {
+    "canvas": "^2.11.2",
+    "chalk": "^5.3.0",
+    "citty": "^0.1.6",
+    "consola": "^3.2.3",
+    "pathe": "^1.1.2",
+    "unstorage": "^1.13.1"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.10",
+    "@dotenvx/dotenvx": "^1.30.1",
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.8",
+    "changelogen": "^0.5.7",
+    "eslint": "^9.17.0",
+    "eslint-config-unjs": "^0.4.2",
+    "jiti": "^2.4.1",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "unbuild": "3.0.1",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "dev": "vitest dev",
+    "lint": "eslint . --fix",
+    "format": "prettier .  --write",
+    "build": "unbuild",
+    "play": "jiti playground/cli",
+    "release": "pnpm test && changelogen --release && pnpm publish && git push --follow-tags",
+    "test": "pnpm lint && pnpm test:types && vitest run --coverage",
+    "test:types": "tsc --noEmit --skipLibCheck",
+    "unascii": "jiti playground/cli"
+  }
+}