Merge branch 'main' into cga

Author: sdqede

.github/workflows/ci.yml

@@ -47,6 +47,7 @@ jobs:
       matrix:
         package:
           - appstash
+          - clean-ansi
           - fetch-api-client
           - find-pkg
           - http-errors

packages/clean-ansi/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 0.1.1 (2025-11-24)
+
+**Note:** Version bump only for package clean-ansi

packages/clean-ansi/README.md

@@ -0,0 +1,95 @@
+# clean-ansi 🧹
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/hyperweb-io/dev-utils/refs/heads/main/docs/img/logo.svg" width="80">
+  <br />
+    <strong>strip ANSI escape codes from strings</strong>
+  <br />
+  <br />
+  Remove all ANSI escape codes from terminal output
+  <br />
+  <br />
+  <a href="https://github.com/hyperweb-io/dev-utils/actions/workflows/ci.yml">
+    <img height="20" src="https://github.com/hyperweb-io/dev-utils/actions/workflows/ci.yml/badge.svg" />
+  </a>
+  <a href="https://github.com/hyperweb-io/dev-utils/blob/main/LICENSE">
+    <img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/>
+  </a>
+</p>
+
+## Why clean-ansi?
+
+Terminal output often contains ANSI escape codes for colors, cursor movement, and formatting. `clean-ansi` removes these codes to give you clean, plain text that's perfect for:
+
+- 🧪 Testing terminal applications and comparing output
+- 📝 Logging to files without formatting codes
+- 🔍 Parsing command-line tool output
+- 📊 Processing terminal data for analysis
+
+## Install
+
+```sh
+npm install clean-ansi
+```
+
+## Usage
+
+```typescript
+import { cleanAnsi } from 'clean-ansi';
+
+const coloredText = '\u001b[31mRed text\u001b[0m';
+const cleanText = cleanAnsi(coloredText);
+console.log(cleanText); // 'Red text'
+```
+
+## API
+
+### `cleanAnsi(input: string): string`
+
+Removes all ANSI escape codes from the input string.
+
+**Parameters:**
+- `input` - The string containing ANSI escape codes
+
+**Returns:**
+- A string with all ANSI escape codes removed
+
+**Handles:**
+- CSI sequences (color codes, cursor movement, etc.)
+- OSC sequences (OS commands like window title)
+- Other escape sequences
+
+### `stripAnsi(input: string): string`
+
+Alias for `cleanAnsi` for compatibility.
+
+## Examples
+
+```typescript
+import { cleanAnsi } from 'clean-ansi';
+
+// Remove color codes
+cleanAnsi('\u001b[31mRed\u001b[0m \u001b[32mGreen\u001b[0m');
+// Returns: 'Red Green'
+
+// Remove cursor movement codes
+cleanAnsi('Hello\u001b[AWorld');
+// Returns: 'HelloWorld'
+
+// Handle complex terminal output
+cleanAnsi('\u001b[?25l\u001b[2J\u001b[H\u001b[31mError:\u001b[0m Message\u001b[?25h');
+// Returns: 'Error: Message'
+
+// Preserve newlines and whitespace
+cleanAnsi('\u001b[31mLine 1\u001b[0m\nLine 2');
+// Returns: 'Line 1\nLine 2'
+```
+
+## Design Philosophy
+
+clean-ansi embraces simplicity:
+- 🎯 Zero dependencies
+- 🪶 Tiny footprint
+- 🚀 Fast and predictable
+- 💎 Pure function
+- 📖 Clear, focused API

packages/clean-ansi/__tests__/clean-ansi.test.ts

@@ -0,0 +1,96 @@
+import { cleanAnsi, stripAnsi } from '../src';
+
+describe('cleanAnsi', () => {
+  it('should return empty string for null or undefined input', () => {
+    expect(cleanAnsi('')).toBe('');
+    expect(cleanAnsi(null as any)).toBe('');
+    expect(cleanAnsi(undefined as any)).toBe('');
+  });
+
+  it('should return the same string if no ANSI codes are present', () => {
+    const text = 'Hello, World!';
+    expect(cleanAnsi(text)).toBe(text);
+  });
+
+  it('should remove CSI color codes', () => {
+    const text = '\u001b[31mRed text\u001b[0m';
+    expect(cleanAnsi(text)).toBe('Red text');
+  });
+
+  it('should remove multiple color codes', () => {
+    const text = '\u001b[31mRed\u001b[0m \u001b[32mGreen\u001b[0m \u001b[34mBlue\u001b[0m';
+    expect(cleanAnsi(text)).toBe('Red Green Blue');
+  });
+
+  it('should remove cursor movement codes', () => {
+    const text = 'Hello\u001b[AWorld';
+    expect(cleanAnsi(text)).toBe('HelloWorld');
+  });
+
+  it('should remove clear screen codes', () => {
+    const text = 'Before\u001b[2JAfter';
+    expect(cleanAnsi(text)).toBe('BeforeAfter');
+  });
+
+  it('should remove cursor visibility codes', () => {
+    const text = 'Text\u001b[?25hMore text\u001b[?25l';
+    expect(cleanAnsi(text)).toBe('TextMore text');
+  });
+
+  it('should remove OSC sequences with BEL terminator', () => {
+    const text = '\u001b]0;Window Title\u0007Content';
+    expect(cleanAnsi(text)).toBe('Content');
+  });
+
+  it('should remove OSC sequences with ESC\\ terminator', () => {
+    const text = '\u001b]2;Title\u001b\\Content';
+    expect(cleanAnsi(text)).toBe('Content');
+  });
+
+  it('should remove other escape sequences', () => {
+    const text = 'Save\u001b7Position\u001b8Restore';
+    expect(cleanAnsi(text)).toBe('SavePositionRestore');
+  });
+
+  it('should handle complex strings with multiple ANSI codes', () => {
+    const text = '\u001b[31m\u001b[1mBold Red\u001b[0m\u001b[32m Green \u001b[0m\u001b]0;Title\u0007Normal';
+    expect(cleanAnsi(text)).toBe('Bold Red Green Normal');
+  });
+
+  it('should preserve newlines and other whitespace', () => {
+    const text = '\u001b[31mLine 1\u001b[0m\nLine 2\n\tTabbed';
+    expect(cleanAnsi(text)).toBe('Line 1\nLine 2\n\tTabbed');
+  });
+
+  it('should handle strings with only ANSI codes', () => {
+    const text = '\u001b[31m\u001b[0m\u001b[32m\u001b[0m';
+    expect(cleanAnsi(text)).toBe('');
+  });
+
+  it('should handle complex real-world terminal output', () => {
+    const text = '\u001b[?25l\u001b[2J\u001b[H\u001b[31mError:\u001b[0m Something went wrong\u001b[?25h';
+    expect(cleanAnsi(text)).toBe('Error: Something went wrong');
+  });
+
+  it('should handle 256 color codes', () => {
+    const text = '\u001b[38;5;208mOrange text\u001b[0m';
+    expect(cleanAnsi(text)).toBe('Orange text');
+  });
+
+  it('should handle RGB color codes', () => {
+    const text = '\u001b[38;2;255;0;0mRed text\u001b[0m';
+    expect(cleanAnsi(text)).toBe('Red text');
+  });
+});
+
+describe('stripAnsi (alias)', () => {
+  it('should work the same as cleanAnsi', () => {
+    const text = '\u001b[31mRed text\u001b[0m';
+    expect(stripAnsi(text)).toBe('Red text');
+    expect(stripAnsi(text)).toBe(cleanAnsi(text));
+  });
+
+  it('should be the same function reference', () => {
+    expect(stripAnsi).toBe(cleanAnsi);
+  });
+});

packages/clean-ansi/jest.config.js

@@ -0,0 +1,18 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+    preset: "ts-jest",
+    testEnvironment: "node",
+    transform: {
+        "^.+\\.tsx?$": [
+            "ts-jest",
+            {
+                babelConfig: false,
+                tsconfig: "tsconfig.json",
+            },
+        ],
+    },
+    transformIgnorePatterns: [`/node_modules/*`],
+    testRegex: "(/__tests__/.*|(\\.|/)(test|spec))\\.(jsx?|tsx?)$",
+    moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json", "node"],
+    modulePathIgnorePatterns: ["dist/*"]
+};

packages/clean-ansi/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "clean-ansi",
+  "version": "0.1.1",
+  "author": "Dan Lynch <[email protected]>",
+  "description": "Remove ANSI escape codes from strings",
+  "main": "index.js",
+  "module": "esm/index.js",
+  "types": "index.d.ts",
+  "homepage": "https://github.com/hyperweb-io/dev-utils",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hyperweb-io/dev-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/hyperweb-io/dev-utils/issues"
+  },
+  "scripts": {
+    "copy": "makage assets",
+    "clean": "makage clean",
+    "prepublishOnly": "npm run build",
+    "build": "npm run clean && makage build-ts && npm run copy",
+    "lint": "eslint . --fix",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "devDependencies": {
+    "makage": "0.1.5"
+  },
+  "keywords": [
+    "ansi",
+    "strip",
+    "clean",
+    "escape codes",
+    "terminal",
+    "colors"
+  ]
+}

…ages/inquirerer/test-utils/strip-ansi.ts packages/clean-ansi/src/index.tspackages/inquirerer/test-utils/strip-ansi.ts renamed to packages/clean-ansi/src/index.ts packages/inquirerer/test-utils/strip-ansi.ts renamed to packages/clean-ansi/src/index.ts

@@ -1,34 +1,35 @@
-// stripAnsi.ts
 /**
  * Remove ANSI escape codes from a string.
  * Handles:
  * - CSI sequences: \u001b[... (color codes, cursor movement, etc.)
  * - OSC sequences: \u001b]... (OS commands like window title)
  * - Other escape sequences: \u001b followed by single characters
  */
-export function stripAnsi(input: string): string {
+export function cleanAnsi(input: string): string {
     if (!input) return '';
-    
+
     // Match CSI (Control Sequence Introducer) sequences: ESC[ followed by parameters and final character
     // Examples: \u001b[31m, \u001b[A, \u001b[2J, \u001b[?25h
     const csiPattern = /\u001b\[[0-9;?]*[A-Za-z]/g;
-    
+
     // Match OSC (Operating System Command) sequences: ESC] followed by parameters and terminator
     // Terminated by BEL (\u0007) or ESC\ (\u001b\\)
     // Examples: \u001b]0;title\u0007, \u001b]2;title\u001b\\
     // Handle BEL-terminated sequences
     const oscBelPattern = /\u001b\][^\u0007]*\u0007/g;
     // Handle ESC\-terminated sequences (more complex, need to match ESC\ specifically)
     const oscEscPattern = /\u001b\][^\u001b]*\u001b\\/g;
-    
+
     // Match other escape sequences: ESC followed by single character
     // Examples: \u001bD (index), \u001bM (reverse index), \u001b7 (save cursor), \u001b8 (restore cursor)
     const otherEscPattern = /\u001b[0-9A-Za-z]/g;
-    
+
     return input
         .replace(csiPattern, '')
         .replace(oscBelPattern, '')
         .replace(oscEscPattern, '')
         .replace(otherEscPattern, '');
 }
-  
+
+// Alias for compatibility
+export const stripAnsi = cleanAnsi;

packages/clean-ansi/tsconfig.esm.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist/esm",
+    "module": "ES2015"
+  }
+}

packages/clean-ansi/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src/"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["dist", "node_modules", "**/*.spec.*", "**/*.test.*"]
+}

packages/create-gen-app-test/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 0.1.1 (2025-11-24)
+
+**Note:** Version bump only for package create-gen-app-test