shellfie 2.0.19 → 2.0.21

package/README.md

@@ -5,33 +5,46 @@ Your terminal output deserves better than a blurry screenshot.
 
 ![shellfie](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/logo-2.svg)
 
-| Feature             | shellfie | carbon-now-cli | svg-term | termtosvg |
-| ------------------- | -------- | -------------- | -------- | --------- |
-| Zero dependencies   | ✅       | ❌             | ❌       | ❌        |
-| No native bindings  | ✅       | ❌             | ❌       | ❌        |
-| No headless browser | ✅       | ❌             | ✅       | ✅        |
-| Full ANSI support   | ✅       | ✅             | ✅       | ✅        |
-| 24-bit true color   | ✅       | ✅             | ❌       | ✅        |
-| Runs in browser     | ✅       | ❌             | ❌       | ❌        |
-| Synchronous API     | ✅       | ❌             | ❌       | ❌        |
-
 ```typescript
-import { execSync } from "child_process";
-import shellfie from 'shellfie'
+import shellfie, { themes } from "shellfie";
+import { writeFileSync } from "node:fs";
+
+const script = `
+#!/bin/bash
+
+echo "Hello World!"
+`;
+
+const svg = shellfie(script, {
+  template: "macos",
+  theme: themes.draculaPro,
+  title: "Syntax highlighting",
+  watermark: "\x1b[38;5;242mGenerated by shellfie\x1b[0m",
+});
 
-const log = execSync("git log --oneline --graph --color=always").toString();
-const svg = shellfie(log, { title: "git log" });
+writeFileSync("highlight.svg", svg);
 ```
 
-![Git Log](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/git-log.svg)
+![Syntax Highlight](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/highlight.svg)
+
+| Feature                     | shellfie | carbon-now-cli | svg-term | termtosvg |
+| --------------------------- | -------- | -------------- | -------- | --------- |
+| Zero dependencies           | ✅       | ❌             | ❌       | ❌        |
+| No native bindings          | ✅       | ❌             | ❌       | ❌        |
+| No headless browser         | ✅       | ❌             | ✅       | ✅        |
+| Full ANSI support           | ✅       | ✅             | ✅       | ✅        |
+| 24-bit true color           | ✅       | ✅             | ❌       | ✅        |
+| Runs in browser             | ✅       | ❌             | ❌       | ❌        |
+| Synchronous API             | ✅       | ❌             | ❌       | ❌        |
+| Built-in Syntax hightligher | ✅       | ❌             | ❌       | ❌        |
 
 ## Why SVG?
 
 ✅ **Infinitely scalable** — pixel-perfect at any zoom level, retina-ready by default.  
 ✅ **Selectable text** — copy code directly from the image.  
 ✅ **Embeddable everywhere** — high quality embedding in READMEs, docs, blogs, everywhere.  
-✅ **Tiny files** — 2-10KB vs blurry 500KB+ PNGs.   
-✅ **No rendering pipeline** — runs anywhere JavaScript runs.   
+✅ **Tiny files** — 2-10KB vs blurry 500KB+ PNGs.  
+✅ **No rendering pipeline** — runs anywhere JavaScript runs.
 
 ## Install
 
@@ -67,8 +80,8 @@ const svg = shellfie(terminalOutput, {
 
 ## Templates
 
-| macOS                             | Windows                               | Minimal                               |
-| --------------------------------- | ------------------------------------- | ------------------------------------- |
+| macOS                                                                                                | Windows                                                                                                  | Minimal                                                                                                  |
+| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
 | ![macos](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/macos.svg) | ![windows](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/windows.svg) | ![minimal](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/minimal.svg) |
 
 ```typescript
@@ -128,7 +141,8 @@ shellfie(output, {
 shellfie(input, {
   template?: "macos",                             // 'macos' | 'windows' | 'minimal' | Template
   title?: "my-terminal",                          // window title
-  width?: 80,                                     // terminal columns (auto-detected if not set)
+  width?: 80,                                     // SVG width in pixels (auto-detected if not set)
+  height?: 400,                                   // SVG height in pixels (auto-detected if not set)
   padding?: 16,                                   // number | [v, h] | [top, right, bottom, left]
   controls?: true,                                // show window control buttons
   controlsPosition?: "left",                      // 'left' (macOS) or 'right' (Windows)
@@ -142,6 +156,7 @@ shellfie(input, {
     format: "woff2",                              //   'woff2' | 'woff' | 'ttf'
   },
   theme?: customTheme,                            // custom color theme or see themes below
+  language?: "typescript",                        // syntax highlighting: 'auto' | language | false
   watermark?: "Generated by shellfie",            // bottom-right text (supports ANSI)
   watermarkPadding?: 16,                          // number | [v, h] | [top, right, bottom, left]
   header?: {                                      // header configuration
@@ -183,52 +198,52 @@ import shellfie, { dracula, nord, tokyoNight } from "shellfie";
 shellfie(output, { theme: dracula });
 ```
 
-| Dracula                                      | Dracula PRO                                   | Nord                                   |
-| -------------------------------------------- | --------------------------------------------- | -------------------------------------- |
+| Dracula                                                                                                         | Dracula PRO                                                                                                             | Nord                                                                                                      |
+| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
 | ![Dracula](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/dracula.svg) | ![Dracula PRO](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/dracula-pro.svg) | ![Nord](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/nord.svg) |
 
-| Tokyo Night                                          | One Dark                                       | One Light                                      |
-| ---------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- |
+| Tokyo Night                                                                                                             | One Dark                                                                                                          | One Light                                                                                                           |
+| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
 | ![Tokyo Night](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/tokyo-night.svg) | ![One Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/one-dark.svg) | ![One Light](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/one-light.svg) |
 
-| Monokai                                      | Catppuccin Mocha                                               | Material                                       |
-| -------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------------- |
+| Monokai                                                                                                         | Catppuccin Mocha                                                                                                                  | Material                                                                                                          |
+| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
 | ![Monokai](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/monokai.svg) | ![Catppuccin Mocha](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/catppuccin-mocha.svg) | ![Material](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/material.svg) |
 
-| GitHub Dark                                          | GitHub Light                                           | VS Code                                        |
-| ---------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------- |
+| GitHub Dark                                                                                                             | GitHub Light                                                                                                              | VS Code                                                                                                        |
+| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
 | ![GitHub Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/github-dark.svg) | ![GitHub Light](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/github-light.svg) | ![VS Code](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/vscode.svg) |
 
-| Gruvbox Dark                                           | Gruvbox Light                                            | Solarized Dark                                             |
-| ------------------------------------------------------ | -------------------------------------------------------- | ---------------------------------------------------------- |
+| Gruvbox Dark                                                                                                              | Gruvbox Light                                                                                                               | Solarized Dark                                                                                                                |
+| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
 | ![Gruvbox Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/gruvbox-dark.svg) | ![Gruvbox Light](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/gruvbox-light.svg) | ![Solarized Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/solarized-dark.svg) |
 
-| Solarized Light                                              | SynthWave '84                                          | Shades of Purple                                               |
-| ------------------------------------------------------------ | ------------------------------------------------------ | -------------------------------------------------------------- |
+| Solarized Light                                                                                                                 | SynthWave '84                                                                                                              | Shades of Purple                                                                                                                  |
+| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
 | ![Solarized Light](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/solarized-light.svg) | ![SynthWave '84](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/synthwave-84.svg) | ![Shades of Purple](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/shades-of-purple.svg) |
 
-| Cobalt                                       | Oceanic Next                                           | Lucario                                        |
-| -------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------- |
+| Cobalt                                                                                                        | Oceanic Next                                                                                                              | Lucario                                                                                                         |
+| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
 | ![Cobalt](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/cobalt.svg) | ![Oceanic Next](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/oceanic-next.svg) | ![Lucario](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/lucario.svg) |
 
-| Panda Syntax                                         | Hopscotch                                      | Paraiso Dark                                           |
-| ---------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------ |
+| Panda Syntax                                                                                                              | Hopscotch                                                                                                           | Paraiso Dark                                                                                                              |
+| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
 | ![Panda Syntax](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/panda-syntax.svg) | ![Hopscotch](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/hopscotch.svg) | ![Paraiso Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/paraiso-dark.svg) |
 
-| Base16 Dark                                          | Base16 Light                                           | Duotone Dark                                           |
-| ---------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------ |
+| Base16 Dark                                                                                                             | Base16 Light                                                                                                              | Duotone Dark                                                                                                              |
+| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
 | ![Base16 Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/base16-dark.svg) | ![Base16 Light](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/base16-light.svg) | ![Duotone Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/duotone-dark.svg) |
 
-| 3024 Night                                           | A11y Dark                                      | Blackboard                                     |
-| ---------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- |
+| 3024 Night                                                                                                            | A11y Dark                                                                                                           | Blackboard                                                                                                            |
+| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
 | ![3024 Night](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/3024-night.svg) | ![A11y Dark](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/a11y-dark.svg) | ![Blackboard](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/blackboard.svg) |
 
-| Seti                                         | Twilight                                       | Verminal                                       |
-| -------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- |
+| Seti                                                                                                      | Twilight                                                                                                          | Verminal                                                                                                          |
+| --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
 | ![Seti](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/seti.svg) | ![Twilight](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/twilight.svg) | ![Verminal](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/verminal.svg) |
 
-| Yeti                                         | Zenburn                                        |
-| -------------------------------------------- | ---------------------------------------------- |
+| Yeti                                                                                                      | Zenburn                                                                                                         |
+| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
 | ![Yeti](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/yeti.svg) | ![Zenburn](https://raw.githubusercontent.com/tool3/shellfie/refs/heads/master/examples/svgs/themes/zenburn.svg) |
 
 ## Custom Themes
@@ -308,9 +323,11 @@ getMaxWidth(lines); // 80
 ```
 
 ## Related
+
 - See [shellfie-cli](https://github.com/tool3/shellfie-cli) for command line usage
-- See [shellfied](https://github.com/tool3/shellfied) the shellfie web app
+- See [shellfied](https://github.com/tool3/shellfied) for the shellfie web app
+<!--  - See [dvd](https://github.com/tool3/dvd) for shellfie on drugs !-->
 
 ## License
-MIT
 
+MIT

package/dist/highlight/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Syntax Highlighting Module
+ *
+ * Zero-dependency syntax highlighting that outputs ANSI-colored strings
+ * for use with shellfie's SVG renderer.
+ */
+import type { DetectionResult, LanguageTokenizer, Token } from './types';
+/**
+ * Get a language tokenizer by name or alias
+ */
+export declare function getLanguage(name: string): LanguageTokenizer | undefined;
+/**
+ * Get all registered language names
+ */
+export declare function getLanguageNames(): string[];
+/**
+ * Get a language tokenizer by file extension
+ */
+export declare function getLanguageByExtension(ext: string): LanguageTokenizer | undefined;
+/**
+ * Auto-detect the language of a code snippet
+ * Returns the best match or undefined if no confident match
+ */
+export declare function detectLanguage(code: string): DetectionResult | undefined;
+/**
+ * Convert tokens to ANSI-colored string
+ */
+export declare function tokensToAnsi(tokens: Token[]): string;
+/**
+ * Highlight code with syntax highlighting, returning ANSI-colored string
+ *
+ * @param code - The source code to highlight
+ * @param language - Language name, alias, or 'auto' for auto-detection
+ * @returns ANSI-colored string ready for shellfie
+ */
+export declare function highlight(code: string, language?: string): string;
+export type { DetectionResult, LanguageTokenizer, Token, TokenPattern, TokenType } from './types';
+export { ANSI_RESET, TOKEN_TO_ANSI } from './types';
+export { COMMON_PATTERNS, createCLikePatterns, tokenize, wordBoundary } from './tokenizer';
+export { languages } from './languages';
+//# sourceMappingURL=index.d.ts.map

package/dist/highlight/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/highlight/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,EAAa,MAAM,SAAS,CAAC;AAgBpF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAGjF;AAiMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAkCxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAapD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAe,GAAG,MAAM,CAmBzE;AAGD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/highlight/index.js

@@ -0,0 +1,314 @@
+"use strict";
+/**
+ * Syntax Highlighting Module
+ *
+ * Zero-dependency syntax highlighting that outputs ANSI-colored strings
+ * for use with shellfie's SVG renderer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languages = exports.wordBoundary = exports.tokenize = exports.createCLikePatterns = exports.COMMON_PATTERNS = exports.TOKEN_TO_ANSI = exports.ANSI_RESET = void 0;
+exports.getLanguage = getLanguage;
+exports.getLanguageNames = getLanguageNames;
+exports.getLanguageByExtension = getLanguageByExtension;
+exports.detectLanguage = detectLanguage;
+exports.tokensToAnsi = tokensToAnsi;
+exports.highlight = highlight;
+const languages_1 = require("./languages");
+const types_1 = require("./types");
+/**
+ * Language registry - maps names/aliases to tokenizers
+ */
+const registry = new Map();
+// Build registry from all languages
+for (const lang of languages_1.languages) {
+    registry.set(lang.name.toLowerCase(), lang);
+    for (const alias of lang.aliases) {
+        registry.set(alias.toLowerCase(), lang);
+    }
+}
+/**
+ * Get a language tokenizer by name or alias
+ */
+function getLanguage(name) {
+    return registry.get(name.toLowerCase());
+}
+/**
+ * Get all registered language names
+ */
+function getLanguageNames() {
+    return languages_1.languages.map(l => l.name);
+}
+/**
+ * Get a language tokenizer by file extension
+ */
+function getLanguageByExtension(ext) {
+    const normalizedExt = ext.startsWith('.') ? ext.toLowerCase() : `.${ext.toLowerCase()}`;
+    return languages_1.languages.find(lang => lang.extensions.includes(normalizedExt));
+}
+/**
+ * Detection patterns for auto-detection
+ */
+const DETECTION_PATTERNS = [
+    // Bash/Shell
+    {
+        language: 'bash',
+        patterns: [
+            /^#!.*\b(?:ba)?sh\b/m, // Bash/sh shebang
+            /^#!.*\bzsh\b/m, // Zsh shebang
+            /^#!.*\bfish\b/m, // Fish shebang
+            /\$\([^)]+\)/, // Command substitution
+            /\$\{[^}]+\}/, // Variable expansion
+            /\b(echo|export|source|alias)\b/, // Common builtins
+            /\b(if|then|else|fi|for|do|done)\b/, // Shell keywords
+            /\|\s*(?:grep|sed|awk|xargs)\b/, // Pipe to common tools
+        ],
+        weight: 1,
+    },
+    // TypeScript (check before JavaScript due to overlap)
+    {
+        language: 'typescript',
+        patterns: [
+            /:\s*(?:string|number|boolean|void|any|unknown|never)\b/, // Type annotations
+            /\binterface\s+\w+/, // Interface
+            /\btype\s+\w+\s*=/, // Type alias
+            /<\w+(?:\s*,\s*\w+)*>/, // Generic types
+            /\bas\s+\w+/, // Type assertion
+            /\?:/, // Optional property
+        ],
+        weight: 2,
+    },
+    // JavaScript
+    {
+        language: 'javascript',
+        patterns: [
+            /^#!.*\bnode\b/m, // Node.js shebang
+            /^#!.*\bbun\b/m, // Bun shebang
+            /^#!.*\bdeno\b/m, // Deno shebang
+            /\b(const|let|var)\s+\w+\s*=/, // Variable declarations
+            /\bfunction\s+\w+\s*\(/, // Function declarations
+            /=>\s*[{(]/, // Arrow functions
+            /\bclass\s+\w+/, // Class declarations
+            /\b(import|export)\s+/, // ES modules
+            /\b(async|await)\b/, // Async/await
+            /console\.\w+/, // Console usage
+        ],
+        weight: 1,
+    },
+    // Python
+    {
+        language: 'python',
+        patterns: [
+            /^#!.*python/m, // Python shebang
+            /\bdef\s+\w+\s*\(/, // Function def
+            /\bclass\s+\w+[:(]/, // Class def
+            /\bimport\s+\w+/, // Import
+            /\bfrom\s+\w+\s+import\b/, // From import
+            /:\s*$/m, // Colon at end of line
+            /__\w+__/, // Magic methods
+            /\bself\./, // Self reference
+        ],
+        weight: 1,
+    },
+    // JSON
+    {
+        language: 'json',
+        patterns: [
+            /^\s*\{[\s\S]*\}\s*$/, // Object
+            /^\s*\[[\s\S]*\]\s*$/, // Array
+            /"[^"]*"\s*:\s*(?:"[^"]*"|[\d.]+|true|false|null|\{|\[)/, // Key-value
+        ],
+        weight: 1,
+    },
+    // Go
+    {
+        language: 'go',
+        patterns: [
+            /\bpackage\s+\w+/, // Package declaration
+            /\bfunc\s+(?:\(\w+\s+\*?\w+\))?\s*\w+/, // Function/method
+            /\bgo\s+\w+/, // Goroutine
+            /:=\s*/, // Short declaration
+            /\bchan\s+/, // Channel
+            /\bdefer\s+/, // Defer
+            /\bstruct\s*\{/, // Struct
+        ],
+        weight: 1,
+    },
+    // Rust
+    {
+        language: 'rust',
+        patterns: [
+            /\bfn\s+\w+/, // Function
+            /\blet\s+(?:mut\s+)?\w+/, // Let binding
+            /\bimpl\s+(?:<[^>]+>\s*)?\w+/, // Impl block
+            /\bpub\s+(?:fn|struct|enum|mod)\b/, // Public items
+            /\bmatch\s+\w+\s*\{/, // Match expression
+            /->|=>/, // Arrows
+            /&(?:mut\s+)?'?\w+/, // References/lifetimes
+            /!$/m, // Macro calls
+        ],
+        weight: 1,
+    },
+    // Java
+    {
+        language: 'java',
+        patterns: [
+            /\bpublic\s+(?:static\s+)?(?:void|class|interface)\b/, // Public decl
+            /\bpackage\s+[\w.]+;/, // Package
+            /\bimport\s+[\w.*]+;/, // Import
+            /\bSystem\.out\./, // System.out
+            /@\w+(?:\([^)]*\))?/, // Annotations
+            /\bextends\s+\w+/, // Extends
+            /\bimplements\s+\w+/, // Implements
+        ],
+        weight: 1,
+    },
+    // C/C++
+    {
+        language: 'cpp',
+        patterns: [
+            /#include\s*[<"]/, // Include
+            /#define\s+\w+/, // Define
+            /\bint\s+main\s*\(/, // Main function
+            /\bstd::/, // STL namespace
+            /\btemplate\s*</, // Templates
+            /\bnamespace\s+\w+/, // Namespace
+            /\bvirtual\s+/, // Virtual
+            /->/, // Pointer member access
+            /\bnullptr\b/, // nullptr
+        ],
+        weight: 1,
+    },
+    // C (lower weight than C++ due to overlap)
+    {
+        language: 'c',
+        patterns: [
+            /#include\s*[<"]/, // Include
+            /\bint\s+main\s*\(/, // Main function
+            /\bprintf\s*\(/, // printf
+            /\bscanf\s*\(/, // scanf
+            /\bmalloc\s*\(/, // malloc
+            /\bfree\s*\(/, // free
+            /\bNULL\b/, // NULL
+        ],
+        weight: 0.5,
+    },
+    // C#
+    {
+        language: 'csharp',
+        patterns: [
+            /\busing\s+[\w.]+;/, // Using directive
+            /\bnamespace\s+[\w.]+/, // Namespace
+            /\bpublic\s+(?:partial\s+)?class\b/, // Class declaration
+            /\bvar\s+\w+\s*=/, // Var declaration
+            /\basync\s+Task/, // Async Task
+            /\bawait\s+/, // Await
+            /\bLinq\b|\.Select\(|\.Where\(/, // LINQ
+            /\bConsole\.Write/, // Console
+        ],
+        weight: 1,
+    },
+    // HTML/XML
+    {
+        language: 'html',
+        patterns: [
+            /<!DOCTYPE\s+html/i, // HTML doctype
+            /<html[\s>]/i, // HTML tag
+            /<head[\s>]/i, // Head tag
+            /<body[\s>]/i, // Body tag
+            /<div[\s>]/i, // Div tag
+            /<span[\s>]/i, // Span tag
+            /<\/\w+>/, // Closing tags
+            /<\w+[^>]*\/?>/, // Self-closing or opening tags
+            /\s(?:class|id|href|src)="/, // Common attributes
+        ],
+        weight: 1,
+    },
+];
+/**
+ * Auto-detect the language of a code snippet
+ * Returns the best match or undefined if no confident match
+ */
+function detectLanguage(code) {
+    const scores = new Map();
+    for (const { language, patterns, weight } of DETECTION_PATTERNS) {
+        let matchCount = 0;
+        for (const pattern of patterns) {
+            if (pattern.test(code)) {
+                matchCount++;
+            }
+        }
+        if (matchCount > 0) {
+            const score = (matchCount / patterns.length) * weight;
+            const existing = scores.get(language) ?? 0;
+            scores.set(language, Math.max(existing, score));
+        }
+    }
+    // Find the best match
+    let bestLang;
+    let bestScore = 0;
+    for (const [lang, score] of scores) {
+        if (score > bestScore) {
+            bestScore = score;
+            bestLang = lang;
+        }
+    }
+    // Require minimum confidence
+    if (bestLang && bestScore >= 0.15) {
+        return { language: bestLang, confidence: bestScore };
+    }
+    return undefined;
+}
+/**
+ * Convert tokens to ANSI-colored string
+ */
+function tokensToAnsi(tokens) {
+    let result = '';
+    for (const token of tokens) {
+        const ansiCode = types_1.TOKEN_TO_ANSI[token.type];
+        if (ansiCode) {
+            result += ansiCode + token.value + types_1.ANSI_RESET;
+        }
+        else {
+            result += token.value;
+        }
+    }
+    return result;
+}
+/**
+ * Highlight code with syntax highlighting, returning ANSI-colored string
+ *
+ * @param code - The source code to highlight
+ * @param language - Language name, alias, or 'auto' for auto-detection
+ * @returns ANSI-colored string ready for shellfie
+ */
+function highlight(code, language = 'auto') {
+    let tokenizer;
+    if (language === 'auto') {
+        const detected = detectLanguage(code);
+        if (detected) {
+            tokenizer = getLanguage(detected.language);
+        }
+    }
+    else {
+        tokenizer = getLanguage(language);
+    }
+    // If no tokenizer found, return code as-is
+    if (!tokenizer) {
+        return code;
+    }
+    const tokens = tokenizer.tokenize(code);
+    return tokensToAnsi(tokens);
+}
+var types_2 = require("./types");
+Object.defineProperty(exports, "ANSI_RESET", { enumerable: true, get: function () { return types_2.ANSI_RESET; } });
+Object.defineProperty(exports, "TOKEN_TO_ANSI", { enumerable: true, get: function () { return types_2.TOKEN_TO_ANSI; } });
+// Export tokenizer utilities for custom language implementations
+var tokenizer_1 = require("./tokenizer");
+Object.defineProperty(exports, "COMMON_PATTERNS", { enumerable: true, get: function () { return tokenizer_1.COMMON_PATTERNS; } });
+Object.defineProperty(exports, "createCLikePatterns", { enumerable: true, get: function () { return tokenizer_1.createCLikePatterns; } });
+Object.defineProperty(exports, "tokenize", { enumerable: true, get: function () { return tokenizer_1.tokenize; } });
+Object.defineProperty(exports, "wordBoundary", { enumerable: true, get: function () { return tokenizer_1.wordBoundary; } });
+// Export languages
+var languages_2 = require("./languages");
+Object.defineProperty(exports, "languages", { enumerable: true, get: function () { return languages_2.languages; } });
+//# sourceMappingURL=index.js.map

package/dist/highlight/index.js.map

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

package/dist/highlight/languages/bash.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageTokenizer } from '../types';
+export declare const bash: LanguageTokenizer;
+//# sourceMappingURL=bash.d.ts.map

package/dist/highlight/languages/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/highlight/languages/bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,UAAU,CAAC;AAwFvE,eAAO,MAAM,IAAI,EAAE,iBAKlB,CAAC"}