shellfie-cli 1.0.2 → 2.0.0

package/README.md

@@ -1,24 +1,253 @@
 # shellfie-cli
-create beautiful terminal screenshots using formatted string
 
-# usage
-```bash
-shellfie '\x1b[105mSHELLFIE\\x1b[0m🤳' '\x1b[38;5;225mthe easiest way' '\x1b[38;5;213mto create beautiful' '\x1b[38;5;14mCLI screenshots 📸' '\x1b[38;5;199mprogrammatically 🚀' -h 300 -w 400
+Transform your terminal output into beautiful SVG screenshots, directly from the command line.
+
+```sh
+npm test | npx shellfie --title "Test Results" -o tests.svg
+```
+
+![npm test](examples/tests.svg)
+
+✅ **Zero friction** - Pipe any command output and get an SVG instantly.  
+✅ **Beautiful defaults** - macOS-style terminal window with syntax highlighting.  
+✅ **Fully customizable** - 12 themes, 3 templates, custom fonts, and more.  
+✅ **Portable SVGs** - Embed fonts for consistent rendering everywhere.  
+✅ **Run everywhere** - Terminal, CI/CD, npm scripts.   
+
+## Installation
+
+```sh
+# Use directly with npx (no install needed)
+npx shellfie-cli --help
+
+# Or install globally
+npm install -g shellfie-cli
+
+# Or add to your project
+npm install shellfie-cli --save-dev
+```
+
+## Quick Start
+
+### Pipe command output
+
+```sh
+# Capture npm test output
+npm test 2>&1 | shellfie -o test-results.svg
+
+# Capture git log
+git log --oneline -10 | shellfie --title "Recent Commits" -o commits.svg
+
+# Capture any command with colors
+ls -la --color=always | shellfie --theme nord
+```
+
+```sh
+lolcat --help | shellfie -o lolcat
+```
+
+![npm test](examples/lolcat.svg)
+
+### Read from a file
+
+```sh
+# Convert a log file to SVG
+shellfie error.log -o error-screenshot.svg
+
+# ASCII art
+shellfie banner.txt --template minimal --theme monokai
+```
+
+### Output to stdout
+
+```sh
+# Pipe SVG to another command or file
+cat output.txt | shellfie --stdout > output.svg
+
+# Use with clipboard (macOS)
+echo "Hello World" | shellfie --stdout | pbcopy
+```
+
+## Options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--output <path>` | `-o` | Output file path (default: `./shellfie.svg`) |
+| `--name <name>` | `-n` | Output filename (without extension) |
+| `--stdout` | | Print SVG to stdout instead of file |
+| `--template <name>` | `-t` | Window style: `macos`, `windows`, `minimal` |
+| `--theme <name>` | `-T` | Color theme (see [Themes](#themes)) |
+| `--title <text>` | | Window title bar text |
+| `--watermark <text>` | | Text in bottom-right corner (supports ANSI colors) |
+| `--width <cols>` | `-w` | Terminal width in columns (auto-detected) |
+| `--padding <value>` | `-p` | Padding in pixels (`16` or `top,right,bottom,left`) |
+| `--font-size <px>` | | Font size in pixels (default: `14`) |
+| `--line-height <n>` | | Line height multiplier (default: `1.4`) |
+| `--font-family <css>` | | CSS font-family string |
+| `--embed-font` | | Embed system font for portable SVGs |
+| `--no-controls` | | Hide window control buttons |
+| `--no-custom-glyphs` | | Use font glyphs instead of pixel-perfect box drawing |
+| `--header-height <px>` | | Custom header bar height |
+| `--header-color <hex>` | | Header background color |
+| `--footer-height <px>` | | Footer bar height |
+| `--footer-color <hex>` | | Footer background color |
+| `--list-themes` | | List all available themes |
+| `--list-templates` | | List all available templates |
+| `--help` | `-h` | Show help |
+| `--version` | `-v` | Show version |
+
+## Themes
+
+```sh
+shellfie --list-themes
+```
+
+Available themes:
+
+| Theme | Description |
+|-------|-------------|
+| `dracula` | Dark, vibrant purple |
+| `nord` | Arctic, bluish colors |
+| `tokyoNight` | Dark, moody |
+| `oneDark` | VS Code One Dark |
+| `monokai` | Classic dark |
+| `catppuccinMocha` | Warm, cozy dark |
+| `githubDark` | GitHub dark mode |
+| `githubLight` | GitHub light mode |
+| `gruvboxDark` | Retro dark |
+| `gruvboxLight` | Retro light |
+| `solarizedDark` | Solarized dark |
+| `solarizedLight` | Solarized light |
+
+## Templates
+
+```sh
+shellfie --list-templates
+```
+
+| Template | Description |
+|----------|-------------|
+| `macos` | macOS-style with traffic light buttons (default) |
+| `windows` | Windows-style with square buttons |
+| `minimal` | Clean, no window chrome |
+
+## Examples
+
+### Capture test results with a theme
+
+```sh
+npm test 2>&1 | shellfie --theme dracula --title "Unit Tests" -o tests.svg
 ```
-![](https://github.com/tool3/shellfie/blob/master/shellfies/shellfie.png?raw=true)   
-or
-```bash
-echo "\x1b[34mHello world" | shellfie -w 200 -h 200 -n hello
+![tests dracula](examples/tests-dracula.svg)
+
+### Git log with minimal template
+
+```sh
+git log --oneline --graph --color=always | shellfie -t minimal --theme githubDark -o git-log.svg
+```
+![git log](examples/git-log.svg)
+
+### Custom padding and font size
+
+```sh
+cat script.sh | shellfie --padding "20,30" --font-size 30 -o script.svg
+```
+![script](examples/script.svg)
+
+### Embed font for sharing
+
+```sh
+ls -l | lolcat -f | shellfie --embed-font -o portable.svg
+```
+![portable](examples/portable.svg)
+
+### Add watermark
+
+```sh
+ifconfig | grep inet | shellfie --watermark "@$USER" --theme monokai
+```
+![watermark](examples/watermark.svg)
+
+### Colored watermark
+
+Watermarks support ANSI escape sequences for colors and styles:
+
+```sh
+# Red watermark using octal notation
+echo "test" | shellfie --watermark '\033[31m@username\033[0m'
+
+# Green watermark using hex notation
+echo "test" | shellfie --watermark '\x1b[32m@username\x1b[0m'
+
+# Bold blue watermark using shorthand notation
+echo "test" | shellfie --watermark '\e[1;34m@username\e[0m'
+
+# Works with bash variables
+echo "test" | shellfie --watermark '\e[1;32m@$USER\e[0m'
+```
+
+### With header and footer bars
+
+```sh
+htop -n 1 | shellfie --header-height 30 --footer-height 20 -o system.svg
+```
+
+## Tips
+
+### Preserve colors
+
+Many commands disable colors when piped. Force them with:
+
+```sh
+# ls
+ls -la --color=always | shellfie
+
+# grep
+grep --color=always pattern file | shellfie
+
+# git
+git -c color.ui=always log | shellfie
+
+# npm
+npm test --color | shellfie
+```
+
+### Capture stderr too
+
+Include error output with `2>&1`:
+
+```sh
+npm test 2>&1 | shellfie -o output.svg
+```
+
+### CI/CD Integration
+
+```yaml
+# GitHub Actions example
+- name: Generate test screenshot
+  run: npm test 2>&1 | npx shellfie-cli --theme githubDark -o test-output.svg
+
+- name: Upload artifact
+  uses: actions/upload-artifact@v4
+  with:
+    name: test-screenshot
+    path: test-output.svg
 ```
-![](https://github.com/tool3/shellfie-cli/blob/master/shellfies/hello.png?raw=true)   
 
-# useful examples
-```bash
-lolcat --help > help.txt
-cat help.txt | shellfie -m raw
+### npm scripts
+
+```json
+{
+  "scripts": {
+    "test:screenshot": "npm test 2>&1 | shellfie --theme dracula -o tests.svg"
+  }
+}
 ```
-![](https://github.com/tool3/shellfied/blob/master/lolcat.png?raw=true)
 
-# options
+## Related
+
+- [shellfie](https://github.com/tool3/shellfie) - The core library for programmatic use
+
+## License
 
-see [shellfie](https://github.com/tool3/shellfie)
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const spinner_1 = require("./spinner");
+const shellfie_1 = require("./shellfie");
+const createParser = () => yargs_1.default
+    .scriptName('shellfie')
+    .usage('$0 [options] [file]')
+    .usage('')
+    .usage('Transform terminal output into beautiful SVG images')
+    .option('output', {
+    alias: 'o',
+    type: 'string',
+    describe: 'Output file path (defaults to ./shellfie.svg)',
+})
+    .option('name', {
+    alias: 'n',
+    type: 'string',
+    describe: 'Output filename (without extension)',
+})
+    .option('stdout', {
+    type: 'boolean',
+    describe: 'Output SVG to stdout instead of file',
+    default: false,
+})
+    .option('template', {
+    alias: 't',
+    type: 'string',
+    choices: shellfie_1.TEMPLATE_NAMES,
+    describe: 'Window template style',
+    default: 'macos',
+})
+    .option('theme', {
+    alias: 'T',
+    type: 'string',
+    choices: shellfie_1.THEME_NAMES,
+    describe: 'Color theme',
+})
+    .option('title', {
+    type: 'string',
+    describe: 'Window title text',
+})
+    .option('width', {
+    alias: 'w',
+    type: 'number',
+    describe: 'Terminal width in columns (auto-detected if not set)',
+})
+    .option('padding', {
+    alias: 'p',
+    type: 'string',
+    describe: 'Padding in pixels (single value or "top,right,bottom,left")',
+})
+    .option('font-size', {
+    type: 'number',
+    describe: 'Font size in pixels',
+    default: 14,
+})
+    .option('line-height', {
+    type: 'number',
+    describe: 'Line height multiplier',
+    default: 1.4,
+})
+    .option('watermark', {
+    type: 'string',
+    describe: 'Watermark text (bottom-right corner)',
+})
+    .option('no-controls', {
+    type: 'boolean',
+    describe: 'Hide window control buttons',
+    default: false,
+})
+    .option('no-custom-glyphs', {
+    type: 'boolean',
+    describe: 'Use font glyphs instead of pixel-perfect box drawing',
+    default: false,
+})
+    .option('font-family', {
+    type: 'string',
+    describe: 'CSS font-family string',
+})
+    .option('embed-font', {
+    type: 'boolean',
+    describe: 'Embed system font in SVG (for portability)',
+    default: false,
+})
+    .option('header-height', {
+    type: 'number',
+    describe: 'Custom header bar height (enables header)',
+})
+    .option('header-color', {
+    type: 'string',
+    describe: 'Header background color (hex)',
+})
+    .option('footer-height', {
+    type: 'number',
+    describe: 'Footer bar height (enables footer)',
+})
+    .option('footer-color', {
+    type: 'string',
+    describe: 'Footer background color (hex)',
+})
+    .option('list-themes', {
+    type: 'boolean',
+    describe: 'List all available themes',
+})
+    .option('list-templates', {
+    type: 'boolean',
+    describe: 'List all available templates',
+})
+    .example('cat output.txt | $0 -o screenshot.svg', 'Create SVG from piped input')
+    .example('$0 terminal.txt --theme dracula', 'Create SVG from file with theme')
+    .example('npm test 2>&1 | $0 --title "Tests"', 'Capture command output with title')
+    .example('$0 --list-themes', 'List all available themes')
+    .demandCommand(0)
+    .help()
+    .alias('help', 'h')
+    .version()
+    .alias('version', 'v')
+    .wrap(Math.min(100, process.stdout.columns || 80))
+    .showHelpOnFail(true);
+const exit = (code, message) => {
+    if (message)
+        console.error(message);
+    process.exit(code);
+};
+const handleListCommands = (argv) => {
+    if (argv['list-themes']) {
+        (0, shellfie_1.listThemes)();
+        return true;
+    }
+    if (argv['list-templates']) {
+        (0, shellfie_1.listTemplates)();
+        return true;
+    }
+    return false;
+};
+const fetchInput = async (inputFile) => (0, shellfie_1.loadInput)(inputFile).catch(() => {
+    throw new Error(`Cannot read file "${inputFile}"`);
+});
+const validateInput = (input) => {
+    if (!input.trim())
+        throw new Error('Input is empty.');
+};
+const writeSvg = (svg, argv, inputFile) => {
+    const outputPath = (0, shellfie_1.resolveOutputPath)(argv, inputFile);
+    if (argv.stdout) {
+        (0, shellfie_1.outputToStdout)(svg);
+        process.exit(0);
+    }
+    (0, shellfie_1.outputToFile)(svg, outputPath);
+    return outputPath;
+};
+const run = async () => {
+    const parser = createParser();
+    const argv = (await parser.parse());
+    if (handleListCommands(argv))
+        process.exit(0);
+    const inputFile = argv._[0];
+    const input = await fetchInput(inputFile).catch((err) => exit(1, `Error: ${err.message}`));
+    if (!input) {
+        parser.showHelp();
+        process.exit(0);
+    }
+    validateInput(input);
+    const spinner = (0, spinner_1.createSpinner)('Creating SVG');
+    if (!argv.stdout)
+        spinner.start();
+    try {
+        const svg = await (0, shellfie_1.generateSvg)(input, argv);
+        const outputPath = writeSvg(svg, argv, inputFile);
+        spinner.success(`Created ${outputPath}`);
+    }
+    catch (err) {
+        spinner.fail('Failed to create SVG');
+        exit(1, err instanceof Error ? err.message : String(err));
+    }
+};
+run();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/shellfie.d.ts

@@ -0,0 +1,17 @@
+import { themes, type shellfieOptions, type Theme } from 'shellfie';
+import { type CliArgs, type BuildOptionsResult } from './utils';
+export declare const THEME_NAMES: (keyof typeof themes)[];
+export declare const TEMPLATE_NAMES: readonly ["macos", "windows", "minimal"];
+export declare const listThemes: () => void;
+export declare const listTemplates: () => void;
+export declare const resolveTheme: (themeName?: string) => Theme | undefined;
+export declare const toShellfieOptions: ({ themeName, ...rest }: BuildOptionsResult) => shellfieOptions;
+export declare const loadInput: (inputFile?: string) => Promise<string>;
+export declare const generateSvg: (input: string, argv: Partial<CliArgs>) => Promise<string>;
+export declare const outputToStdout: (svg: string) => void;
+export declare const outputToFile: (svg: string, outputPath: string) => void;
+export declare const resolveOutputPath: (argv: {
+    output?: string;
+    name?: string;
+}, inputFile?: string) => string;
+//# sourceMappingURL=shellfie.d.ts.map

package/dist/shellfie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellfie.d.ts","sourceRoot":"","sources":["../src/shellfie.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAiB,KAAK,eAAe,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAA0C,KAAK,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAExG,eAAO,MAAM,WAAW,EAA0B,CAAC,MAAM,OAAO,MAAM,CAAC,EAAE,CAAC;AAC1E,eAAO,MAAM,cAAc,0CAA2C,CAAC;AAOvE,eAAO,MAAM,UAAU,QAAO,IAAmD,CAAC;AAElF,eAAO,MAAM,aAAa,QAAO,IAAyD,CAAC;AAE3F,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,KAAG,KAAK,GAAG,SACmB,CAAC;AAE9E,eAAO,MAAM,iBAAiB,GAAI,wBAAwB,kBAAkB,KAAG,eAG7E,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,CAAyB,CAAC;AAEvF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CACrB,CAAC;AAE9D,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,YAAY,MAAM,KAAG,IAE9D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,YAAY,MAAM,KACjB,MACiE,CAAC"}

package/dist/shellfie.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOutputPath = exports.outputToFile = exports.outputToStdout = exports.generateSvg = exports.loadInput = exports.toShellfieOptions = exports.resolveTheme = exports.listTemplates = exports.listThemes = exports.TEMPLATE_NAMES = exports.THEME_NAMES = void 0;
+const node_fs_1 = require("node:fs");
+const shellfie_1 = require("shellfie");
+const utils_1 = require("./utils");
+exports.THEME_NAMES = Object.keys(shellfie_1.themes);
+exports.TEMPLATE_NAMES = ['macos', 'windows', 'minimal'];
+const printList = (title, items) => {
+    console.log(title);
+    items.forEach((name) => console.log(`  ${name}`));
+};
+const listThemes = () => printList('Available themes:', exports.THEME_NAMES);
+exports.listThemes = listThemes;
+const listTemplates = () => printList('Available templates:', exports.TEMPLATE_NAMES);
+exports.listTemplates = listTemplates;
+const resolveTheme = (themeName) => themeName ? shellfie_1.themes[themeName] : undefined;
+exports.resolveTheme = resolveTheme;
+const toShellfieOptions = ({ themeName, ...rest }) => ({
+    ...rest,
+    theme: (0, exports.resolveTheme)(themeName),
+});
+exports.toShellfieOptions = toShellfieOptions;
+const loadInput = (inputFile) => (0, utils_1.readInput)(inputFile);
+exports.loadInput = loadInput;
+const generateSvg = (input, argv) => (0, shellfie_1.shellfieAsync)(input, (0, exports.toShellfieOptions)((0, utils_1.buildOptions)(argv)));
+exports.generateSvg = generateSvg;
+const outputToStdout = (svg) => {
+    process.stdout.write(svg);
+};
+exports.outputToStdout = outputToStdout;
+const outputToFile = (svg, outputPath) => {
+    (0, node_fs_1.writeFileSync)(outputPath, svg, 'utf-8');
+};
+exports.outputToFile = outputToFile;
+const resolveOutputPath = (argv, inputFile) => (0, utils_1.getOutputPath)({ output: argv.output, name: argv.name, inputFile });
+exports.resolveOutputPath = resolveOutputPath;
+//# sourceMappingURL=shellfie.js.map

package/dist/shellfie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellfie.js","sourceRoot":"","sources":["../src/shellfie.ts"],"names":[],"mappings":";;;AAAA,qCAAwC;AACxC,uCAAmF;AACnF,mCAAwG;AAE3F,QAAA,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAM,CAA4B,CAAC;AAC7D,QAAA,cAAc,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAEvE,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,KAAwB,EAAQ,EAAE;IAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC;AAEK,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,mBAAW,CAAC,CAAC;AAArE,QAAA,UAAU,cAA2D;AAE3E,MAAM,aAAa,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC,sBAAsB,EAAE,sBAAc,CAAC,CAAC;AAA9E,QAAA,aAAa,iBAAiE;AAEpF,MAAM,YAAY,GAAG,CAAC,SAAkB,EAAqB,EAAE,CACpE,SAAS,CAAC,CAAC,CAAE,iBAAM,CAAC,SAAgC,CAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AADjE,QAAA,YAAY,gBACqD;AAEvE,MAAM,iBAAiB,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAsB,EAAmB,EAAE,CAAC,CAAC;IACjG,GAAG,IAAI;IACP,KAAK,EAAE,IAAA,oBAAY,EAAC,SAAS,CAAC;CAC/B,CAAC,CAAC;AAHU,QAAA,iBAAiB,qBAG3B;AAEI,MAAM,SAAS,GAAG,CAAC,SAAkB,EAAmB,EAAE,CAAC,IAAA,iBAAS,EAAC,SAAS,CAAC,CAAC;AAA1E,QAAA,SAAS,aAAiE;AAEhF,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,IAAsB,EAAmB,EAAE,CACpF,IAAA,wBAAa,EAAC,KAAK,EAAE,IAAA,yBAAiB,EAAC,IAAA,oBAAY,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AADjD,QAAA,WAAW,eACsC;AAEvD,MAAM,cAAc,GAAG,CAAC,GAAW,EAAQ,EAAE;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEK,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,UAAkB,EAAQ,EAAE;IACpE,IAAA,uBAAa,EAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC;AAFW,QAAA,YAAY,gBAEvB;AAEK,MAAM,iBAAiB,GAAG,CAC/B,IAAwC,EACxC,SAAkB,EACV,EAAE,CACV,IAAA,qBAAa,EAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAJxD,QAAA,iBAAiB,qBAIuC"}

package/dist/spinner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Minimal spinner implementation with zero dependencies.
+ * Shows a spinning animation while processing.
+ */
+export interface Spinner {
+    start(): void;
+    stop(): void;
+    success(message: string): void;
+    fail(message: string): void;
+}
+export declare function createSpinner(text: string): Spinner;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../src/spinner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,OAAO;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDnD"}

package/dist/spinner.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Minimal spinner implementation with zero dependencies.
+ * Shows a spinning animation while processing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpinner = createSpinner;
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const FRAME_INTERVAL = 80;
+function createSpinner(text) {
+    let frameIndex = 0;
+    let intervalId = null;
+    let currentText = text;
+    const clearLine = () => {
+        if (process.stdout.isTTY) {
+            process.stdout.clearLine(0);
+            process.stdout.cursorTo(0);
+        }
+    };
+    const render = () => {
+        clearLine();
+        const frame = SPINNER_FRAMES[frameIndex];
+        process.stdout.write(`${frame} ${currentText}`);
+        frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+    };
+    return {
+        start() {
+            if (!process.stdout.isTTY) {
+                // Non-TTY: just print the message once
+                console.log(`... ${currentText}`);
+                return;
+            }
+            render();
+            intervalId = setInterval(render, FRAME_INTERVAL);
+        },
+        stop() {
+            if (intervalId) {
+                clearInterval(intervalId);
+                intervalId = null;
+            }
+            clearLine();
+        },
+        success(message) {
+            this.stop();
+            console.log(`\x1b[32m✓ ${message}\x1b[0m`);
+        },
+        fail(message) {
+            this.stop();
+            console.log(`\x1b[31m✗ ${message}\x1b[0m`);
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../src/spinner.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAYH,sCAgDC;AA1DD,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1E,MAAM,cAAc,GAAG,EAAE,CAAC;AAS1B,SAAgB,aAAa,CAAC,IAAY;IACxC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAA0B,IAAI,CAAC;IAC7C,IAAI,WAAW,GAAG,IAAI,CAAC;IAEvB,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,SAAS,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC;QAChD,UAAU,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC;IACxD,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;YACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC1B,uCAAuC;gBACvC,OAAO,CAAC,GAAG,CAAC,OAAO,WAAW,EAAE,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YACD,MAAM,EAAE,CAAC;YACT,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC;QAED,IAAI;YACF,IAAI,UAAU,EAAE,CAAC;gBACf,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC1B,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,SAAS,EAAE,CAAC;QACd,CAAC;QAED,OAAO,CAAC,OAAe;YACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,OAAe;YAClB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,SAAS,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,59 @@
+export interface CliArgs {
+    _: (string | number)[];
+    output?: string;
+    name?: string;
+    stdout: boolean;
+    template: string;
+    theme?: string;
+    title?: string;
+    width?: number;
+    padding?: string;
+    'font-size': number;
+    'line-height': number;
+    watermark?: string;
+    'no-controls': boolean;
+    'no-custom-glyphs': boolean;
+    'font-family'?: string;
+    'embed-font': boolean;
+    'header-height'?: number;
+    'header-color'?: string;
+    'footer-height'?: number;
+    'footer-color'?: string;
+    'list-themes'?: boolean;
+    'list-templates'?: boolean;
+}
+export interface BuildOptionsResult {
+    template: 'macos' | 'windows' | 'minimal';
+    themeName?: string;
+    title?: string;
+    width?: number;
+    padding?: number | [number, number] | [number, number, number, number];
+    fontSize: number;
+    lineHeight: number;
+    watermark?: string;
+    controls: boolean;
+    customGlyphs: boolean;
+    fontFamily?: string;
+    embedFont: boolean;
+    header?: {
+        height?: number;
+        backgroundColor?: string;
+    };
+    footer?: {
+        height?: number;
+        backgroundColor?: string;
+    };
+}
+type Padding = number | [number, number] | [number, number, number, number];
+export declare const parseEscapeSequences: (input: string) => string;
+export declare const readStdin: () => Promise<string>;
+export declare const readInput: (inputFile?: string) => Promise<string>;
+export declare const parsePadding: (input: string) => Padding;
+export declare const getOutputPath: (options: {
+    output?: string;
+    name?: string;
+    inputFile?: string;
+}) => string;
+export declare const buildOptions: (argv: Partial<CliArgs>) => BuildOptionsResult;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,KAAK,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAQ5E,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MACkD,CAAC;AAExG,eAAO,MAAM,SAAS,QAAO,OAAO,CAAC,MAAM,CAMvC,CAAC;AAEL,eAAO,MAAM,SAAS,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,CAIlE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAyB5C,CAAC;AAKF,eAAO,MAAM,aAAa,GAAI,SAAS;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,MAQH,CAAC;AAaF,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,CAAC,OAAO,CAAC,KAAG,kBAepD,CAAC"}

package/dist/utils.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOptions = exports.getOutputPath = exports.parsePadding = exports.readInput = exports.readStdin = exports.parseEscapeSequences = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const ESCAPE_REPLACEMENTS = [
+    [/\\033/g, '\x1b'],
+    [/\\x1[bB]/g, '\x1b'],
+    [/\\e/g, '\x1b'],
+];
+const parseEscapeSequences = (input) => ESCAPE_REPLACEMENTS.reduce((str, [pattern, replacement]) => str.replace(pattern, replacement), input);
+exports.parseEscapeSequences = parseEscapeSequences;
+const readStdin = () => new Promise((resolve, reject) => {
+    const chunks = [];
+    process.stdin.on('data', (chunk) => chunks.push(chunk));
+    process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+    process.stdin.on('error', reject);
+});
+exports.readStdin = readStdin;
+const readInput = async (inputFile) => {
+    if (inputFile)
+        return (0, node_fs_1.readFileSync)((0, node_path_1.resolve)(inputFile), 'utf-8');
+    if (!process.stdin.isTTY)
+        return (0, exports.readStdin)();
+    return '';
+};
+exports.readInput = readInput;
+const parsePadding = (input) => {
+    const values = input
+        .split(/[,\s]+/)
+        .map((v) => v.trim())
+        .filter(Boolean)
+        .map(Number);
+    if (values.some(isNaN)) {
+        throw new Error(`Invalid padding value: "${input}". Use numbers only.`);
+    }
+    const paddingByLength = {
+        1: () => values[0],
+        2: () => values,
+        4: () => values,
+    };
+    const toPadding = paddingByLength[values.length];
+    if (!toPadding) {
+        throw new Error(`Invalid padding format: "${input}". Use 1, 2, or 4 values (e.g., "16", "10,20", "10,20,15,25").`);
+    }
+    return toPadding();
+};
+exports.parsePadding = parsePadding;
+const ensureSvgExtension = (path) => path.endsWith('.svg') ? path : `${path}.svg`;
+const getOutputPath = (options) => {
+    const { output, name, inputFile } = options;
+    if (output)
+        return ensureSvgExtension((0, node_path_1.resolve)(output));
+    if (name)
+        return (0, node_path_1.resolve)(process.cwd(), ensureSvgExtension(name));
+    if (inputFile)
+        return (0, node_path_1.resolve)(process.cwd(), `${(0, node_path_1.basename)(inputFile).replace(/\.[^.]+$/, '')}.svg`);
+    return (0, node_path_1.resolve)(process.cwd(), 'shellfie.svg');
+};
+exports.getOutputPath = getOutputPath;
+const buildHeaderFooter = (height, color) => {
+    if (height === undefined && color === undefined)
+        return undefined;
+    return {
+        ...(height !== undefined && { height }),
+        ...(color !== undefined && { backgroundColor: color }),
+    };
+};
+const buildOptions = (argv) => ({
+    template: argv.template ?? 'macos',
+    fontSize: argv['font-size'] ?? 14,
+    lineHeight: argv['line-height'] ?? 1.4,
+    embedFont: argv['embed-font'] ?? false,
+    controls: !argv['no-controls'],
+    customGlyphs: !argv['no-custom-glyphs'],
+    ...(argv.theme && { themeName: argv.theme }),
+    ...(argv.title !== undefined && { title: argv.title }),
+    ...(argv.width !== undefined && { width: argv.width }),
+    ...(argv.padding !== undefined && { padding: (0, exports.parsePadding)(argv.padding) }),
+    ...(argv.watermark !== undefined && { watermark: (0, exports.parseEscapeSequences)(argv.watermark) }),
+    ...(argv['font-family'] !== undefined && { fontFamily: argv['font-family'] }),
+    ...({ header: buildHeaderFooter(argv['header-height'], argv['header-color']) }),
+    ...({ footer: buildHeaderFooter(argv['footer-height'], argv['footer-color']) }),
+});
+exports.buildOptions = buildOptions;
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,36 +1,46 @@
 {
   "name": "shellfie-cli",
-  "version": "1.0.2",
-  "description": "create beautiful terminal screenshots",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo 'set your tests here'"
+  "version": "2.0.0",
+  "description": "Transform terminal output into beautiful SVG images from the command line",
+  "bin": {
+    "shellfie": "./dist/cli.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tool3/shellfie-cli.git"
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "terminal",
-    "xterm",
+    "svg",
     "screenshot",
     "ansi",
-    "cli"
+    "cli",
+    "shellfie",
+    "tty",
+    "carbon",
+    "terminal-screenshot"
   ],
-  "author": "Tal Hayut",
+  "author": "tool3",
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/tool3/shellfie-cli/issues"
-  },
-  "bin": {
-    "shellfie": "index.js"
-  },
-  "homepage": "https://github.com/tool3/shellfie-cli#readme",
   "dependencies": {
-    "shellfie": "^1.2.2",
-    "yargs": "^16.1.1"
+    "shellfie": "^2.0.0",
+    "yargs": "^17.7.2"
   },
   "devDependencies": {
-    "mocha": "^8.2.1"
+    "@types/node": "^20.10.0",
+    "@types/yargs": "^17.0.32",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
   }
 }

package/.github/workflows/test.yml

@@ -1,18 +0,0 @@
-name: test
-
-on:
-  push:
-    branches:
-    - master
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v1
-      - uses: actions/setup-node@v1
-        with:
-          node-version: 12
-      - run: |
-          npm ci
-          npm run test

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2021 Tal Hayut
-
-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/commands/load.js

@@ -1,38 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs');
-
-const validOpts = opts => {
-  if(!opts || !opts.commands) return true;
-  return process.argv[2].includes(opts.commands) ? true : false;
-};
-
-module.exports.load = opts => {
-
-  if(!validOpts(opts)) return false;
-  if (process.stdin.isTTY) return false;
-  
-  const BUFSIZE = 65536;
-  let nbytes = 0;
-  let chunks = [];
-  let buffer = '';
-
-  while(true) {
-    try {
-      buffer = Buffer.alloc(BUFSIZE);
-      nbytes = fs.readSync(0, buffer, 0, BUFSIZE, null);
-    } 
-    catch (e) {
-      if (e.code != 'EAGAIN') throw e; 
-    }
-
-    if (nbytes === 0) break;
-     chunks.push(buffer.slice(0, nbytes));
-  }
-  
-  const stdin = Buffer.concat(chunks).toString();
-  if (stdin) {
-    process.argv.push(stdin.trim());
-    return true;
-  }
-
-};

package/commands/shellify.js

@@ -1,15 +0,0 @@
-const shellfie = require('shellfie');
-
-async function shellify(argv) {
-    const options = {};
-    if (argv.width || argv.height) {
-        const viewport = { ...argv };
-        argv.viewport = viewport;
-    }
-    const name = argv.name || 'a random named image';
-    Object.assign(options, argv);
-    await shellfie(argv.string, options);    
-    console.log(`📸 \x1b[32;1m${name}\x1b[0m \x1b[32mwas saved at \x1b[0;2m${argv.location}\x1b[0m`)
-}
-
-module.exports = shellify;

package/index.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-require('./commands/load').load();
-const yargs = require('yargs');
-const shellify = require('./commands/shellify');
-
-yargs
-    .config({
-        location: `${process.env.INIT_CWD || process.cwd()}/shellfies`
-    })
-    .command(
-        '$0 <string|string..>',
-        'create terminal screenshots from ansi string',
-        { },
-        async argv => {
-            try {
-                await shellify(argv);    
-            } catch (error) {
-                console.error(error);
-            }
-            
-        })
-    .example('$0 \x1b[32mI\'m Green! --width 200')
-    .option('name', { alias: 'n', type: 'string', desc: 'image name' })
-    .option('mode', { alias: 'm', type: 'string', desc: 'input mode (can also be \'raw\')', default: 'default'})
-    .option('width', { alias: 'w', type: 'number', desc: 'set width' })
-    .option('height', { alias: 'h', type: 'number', desc: 'set height' })
-    .option('background', { alias: 'b', type: 'string', desc: 'set background color' })
-    .option('foreground', { alias: 'f', type: 'string', desc: 'set default text color' })
-    .option('font-family', { alias: 'ff', type: 'string', desc: 'set font family' })
-    .option('font-size', { alias: 'fs', type: 'number', desc: 'set font size' })
-    .option('font-weight', { alias: 'fw', type: 'string', desc: 'set font weight' })
-    .option('location', { alias: 'l', type: 'string', desc: 'destination folder', default: './shellfies' })
-    .option('puppeteerArgs', { alias: 'p', type: 'array', desc: 'optional puppeteer args', default: ['--no-sandbox', '--disable-setuid-sandbox']})
-    .help()
-    .wrap(90)
-    .argv