open-index/open-npm huggingface dataset:
npm package: @lxgicstudios/ai-a11y
Description: Scan HTML and JSX for accessibility issues and get AI-powered fix suggestions
Author: LXGIC Studios
Latest version: 1.0.0

# ai-a11y

Scan your HTML and JSX files for accessibility issues. Get WCAG-based suggestions with actual code fixes.

## Install

```bash
npm install -g ai-a11y
```

## Usage

```bash
npx ai-a11y ./src/components/Header.tsx
# Scans a single file

npx ai-a11y ./src/components/
# Scans all HTML/JSX files in a directory
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-adr
Description: Generate Architecture Decision Records with AI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-adr

Generate Architecture Decision Records with AI

## Install

```bash
npm install -g ai-adr
```

## Usage

```bash
npx ai-adr "switch from REST to GraphQL"
npx ai-adr "adopt microservices architecture"
npx ai-adr "use PostgreSQL over MongoDB"
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-alias
Description: Generate useful shell aliases from your command history
Author: LXGIC Studios
Latest version: 1.0.0

# ai-alias

Generate useful shell aliases from your command history

## Install

```bash
npm install -g ai-alias
```

## Usage

```bash
npx ai-alias
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-animation
Description: Generate CSS and Framer Motion animations from descriptions
Author: LXGIC Studios
Latest version: 1.0.0

# ai-animation

Generate CSS and Framer Motion animations from plain English.

## Install

```bash
npm install -g ai-animation
```

## Usage

```bash
npx ai-animation "fade in from left with bounce"
npx ai-animation "pulse glow effect" -f css
npx ai-animation "staggered list entrance" -f framer -o animations.ts
```

## Options

- `-f, --format <format>` - css, framer, or both (default: both)
- `-o, --output <file>` - Write to file

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-api-docs
Description: Generate API documentation from route files using AI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-api-docs

Generate API documentation from your route files. Supports markdown and OpenAPI output.

## Install

```bash
npm install -g ai-api-docs
```

## Usage

```bash
npx ai-api-docs ./src/routes/
# → API docs written to API_DOCS.md

npx ai-api-docs ./src/routes/ --format openapi -o spec.yaml
# → OpenAPI 3.0 spec

npx ai-api-docs ./src/api/ -o docs/api.md
# → Custom output path
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-audit-fix
Description: Analyze npm audit output with AI and get actionable fix suggestions
Author: LXGIC Studios
Latest version: 1.0.0

# ai-audit-fix

Analyze npm audit output with AI and get clear, actionable fix suggestions instead of cryptic vulnerability reports.

## Install

```bash
npm install -g ai-audit-fix
```

## Usage

```bash
npx ai-audit-fix
```

Run it in any project with a `package.json`. It runs `npm audit` under the hood, sends the results to GPT-4o-mini, and gives you a plain English breakdown with exact fix commands.

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## What you get

- Vulnerability summary (critical/high/moderate/low counts)
- Plain English explanation of each issue
- Exact commands to fix them

## License

MIT
npm package: @lxgicstudios/ai-auth-check
Description: AI-powered auth security auditor - find vulnerabilities in your authentication code using GPT
Author: LXGIC Studios
Latest version: 1.0.2

# ai-auth-check

[![npm version](https://img.shields.io/npm/v/ai-auth-check.svg)](https://www.npmjs.com/package/ai-auth-check)
[![npm downloads](https://img.shields.io/npm/dm/ai-auth-check.svg)](https://www.npmjs.com/package/ai-auth-check)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

AI-powered auth auditor. Find session management flaws, weak JWT configs, and OAuth vulnerabilities in your code.

Audit your auth implementation for security flaws.

## Install

```bash
npm install -g ai-auth-check
```

## Usage

```bash
npx ai-auth-check ./src/auth/
npx ai-auth-check ./lib/middleware/ -o security-report.md
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-backup-script
Description: Generate database backup scripts with AI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-backup-script

Generate database backup scripts with AI

## Install

```bash
npm install -g ai-backup-script
```

## Usage

```bash
npx ai-backup-script "PostgreSQL daily to S3"
npx ai-backup-script "MongoDB hourly to GCS"
npx ai-backup-script "MySQL weekly to local with rotation"
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-changelog
Description: Generate clean changelogs from git history using OpenAI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-changelog

Generates a clean, categorized changelog from your git history. You give it two refs (tags, branches, commits) and it reads the log between them, then uses OpenAI to turn that mess of commit messages into a proper CHANGELOG entry.

## Install

```bash
npm install -g ai-changelog
```

## Setup

You'll need an OpenAI API key:

```bash
export OPENAI_API_KEY=sk-your-key-here
```

## Usage

```bash
# Between two tags
npx ai-changelog --from v1.0.0 --to v2.0.0

# From a tag to HEAD
npx ai-changelog --from v1.0.0 --to HEAD

# Write directly to a file
npx ai-changelog --from v1.0.0 --to v2.0.0 -o CHANGELOG.md
```

It'll group your commits into Added, Changed, Fixed, Removed. No more hand-writing changelogs.

## What it does

1. Reads git log between the two refs you give it
2. Sends the commit list to OpenAI
3. Gets back a nicely formatted changelog entry
4. Prints it or writes it to a file

That's it. Nothing fancy, just saves you 20 minutes every release.
npm package: @lxgicstudios/ai-code-review
Description: AI-powered code review for staged git changes
Author: LXGIC Studios
Latest version: 1.0.0

# ai-code-review

Get a code review before you even push. It reads your staged changes and gives you feedback with colored output right in the terminal.

## Install

```bash
npm install -g ai-code-review
```

## Setup

```bash
export OPENAI_API_KEY=sk-your-key-here
```

## Usage

```bash
# Stage your changes first
git add .

# Run the review
npx ai-code-review
```

You'll get color-coded feedback:
- 🔴 **CRITICAL** - Bugs, security issues. Fix these.
- 🟡 **WARNING** - Code smells, things that might bite you later.
- 🔵 **SUGGESTION** - Style and readability stuff.
- 🟢 **GOOD** - Things you did right. Everyone needs a pat on the back.

## Why bother?

Catches dumb mistakes before your teammates do. Way less embarrassing than getting "you left a console.log in here" on your PR.
npm package: @lxgicstudios/ai-docs
Description: Add JSDoc/TSDoc comments to your source files using OpenAI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-docs

Adds JSDoc or TSDoc comments to your code. Point it at files or a directory and it'll document your exported functions, classes, and interfaces without touching any logic.

## Install

```bash
npm install -g ai-docs
```

## Setup

```bash
export OPENAI_API_KEY=sk-your-key-here
```

## Usage

```bash
# Preview docs for a directory (prints to stdout)
npx ai-docs src/ --style jsdoc

# TSDoc style
npx ai-docs src/ --style tsdoc

# Actually write the changes back to the files
npx ai-docs src/ --style jsdoc --write

# Single file
npx ai-docs src/utils.ts --style jsdoc

# Glob patterns work too
npx ai-docs "src/**/*.ts" --style tsdoc
```

## What it does

Reads each file, sends it to OpenAI, gets back the same file with doc comments added to all the exported stuff. It won't change your code. It just adds comments above functions, classes, interfaces, and types.

## Tips

- Run without `--write` first to preview what it'll do
- It skips files over 20KB (they'd blow the context window anyway)
- Automatically ignores node_modules and dist folders
npm package: @lxgicstudios/ai-form
Description: Generate form components with validation from descriptions
Author: LXGIC Studios
Latest version: 1.0.1

# @lxgicstudios/ai-form

[![npm version](https://img.shields.io/npm/v/%40lxgicstudios%2Fai-form.svg)](https://www.npmjs.com/package/@lxgicstudios/ai-form)
[![npm downloads](https://img.shields.io/npm/dm/%40lxgicstudios%2Fai-form.svg)](https://www.npmjs.com/package/@lxgicstudios/ai-form)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/lxgic-studios/ai-form)](https://github.com/lxgic-studios/ai-form/stargazers)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue)](https://www.typescriptlang.org/)



Generate form components with validation from plain English descriptions.

## Install

```bash
npm install -g @lxgicstudios/ai-form
```

## Usage

```bash
npx @lxgicstudios/ai-form "signup form with email, password, name"
npx @lxgicstudios/ai-form "checkout form with address and payment" -t
npx @lxgicstudios/ai-form "contact form" -o ContactForm.tsx -t
```

## Options

- `-t, --typescript` - Generate TypeScript
- `-l, --library <lib>` - Validation library (default: react-hook-form + zod)
- `-o, --output <file>` - Write to file

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-gitignore
Description: Auto-detect your project's tech stack and generate a comprehensive .gitignore file. Supports Node, Python, Go, Rust, Java, Ruby, .NET, and 20+ more frameworks.
Author: LXGIC Studios
Latest version: 1.0.0

# @lxgicstudios/ai-gitignore

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/ai-gitignore.svg)](https://www.npmjs.com/package/@lxgicstudios/ai-gitignore)
[![license](https://img.shields.io/npm/l/@lxgicstudios/ai-gitignore.svg)](https://github.com/lxgicstudios/ai-gitignore/blob/main/LICENSE)
[![node](https://img.shields.io/node/v/@lxgicstudios/ai-gitignore.svg)](https://nodejs.org)

Auto-detect your project's tech stack and generate a comprehensive .gitignore file. Supports 20+ languages and frameworks. No config needed.

Zero external dependencies.

## Install

```bash
npm install -g @lxgicstudios/ai-gitignore
```

Or run it directly:

```bash
npx @lxgicstudios/ai-gitignore
```

## Usage

```bash
# Generate .gitignore for current directory
ai-gitignore

# Preview what would be generated
ai-gitignore --preview

# Merge with existing .gitignore
ai-gitignore --merge

# Check for tracked files that should be ignored
ai-gitignore --check

# Scan a specific directory
ai-gitignore /path/to/project

# Overwrite existing .gitignore
ai-gitignore --force

# JSON output
ai-gitignore --json
```

## Features

- Auto-detects your tech stack by scanning project files
- Supports 20+ languages: Node.js, TypeScript, Python, Go, Rust, Java, Ruby, .NET, PHP, Swift, Kotlin, Dart, Elixir, Scala, Haskell, R, Terraform, and more
- Detects frameworks: Next.js, React/Vite, Docker
- Includes OS-specific rules (macOS, Windows, Linux)
- Includes editor rules (VS Code, JetBrains, Vim)
- Merge mode to add rules to an existing .gitignore
- Check mode to find tracked files that should be ignored
- Preview mode to see output before writing
- JSON output for scripting
- Confidence scoring for detections
- Zero external dependencies

## Detected Stacks

| Stack | Detection Files |
|-------|----------------|
| Node.js | package.json, yarn.lock, .nvmrc |
| TypeScript | tsconfig.json, *.ts files |
| Python | requirements.txt, pyproject.toml, Pipfile |
| Go | go.mod, go.sum |
| Rust | Cargo.toml, Cargo.lock |
| Java | pom.xml, build.gradle |
| Ruby | Gemfile, Rakefile |
| .NET | *.csproj, *.sln |
| PHP | composer.json |
| Swift | Package.swift, *.xcodeproj |
| Kotlin | build.gradle.kts |
| Dart/Flutter | pubspec.yaml |
| Elixir | mix.exs |
| Terraform | main.tf, *.tf |
| Docker | Dockerfile, docker-compose.yml |
| Next.js | next.config.js |

## Options

| Option | Alias | Description | Default |
|--------|-------|-------------|---------|
| `--help` | `-h` | Show help message | |
| `--dir <path>` | `-d` | Directory to scan | `.` |
| `--check` | `-c` | Find tracked files that should be ignored | `false` |
| `--merge` | `-m` | Merge with existing .gitignore | `false` |
| `--preview` | `-p` | Preview without writing | `false` |
| `--force` | `-f` | Overwrite existing .gitignore | `false` |
| `--json` | | Output as JSON | `false` |

## License

MIT - [LXGIC Studios](https://github.com/lxgicstudios)
npm package: @lxgicstudios/ai-index
Description: Suggest database indexes from query patterns using AI
Author: LXGIC Studios
Latest version: 1.0.0

# @lxgicstudios/ai-index

Analyze your query patterns and get smart database index suggestions. Tells you exactly what to create and why.

## Install

```bash
npm install -g @lxgicstudios/ai-index
```

## Usage

```bash
npx @lxgicstudios/ai-index ./src/queries/
# Analyzes all query files and suggests indexes

npx @lxgicstudios/ai-index ./src/queries/users.ts -o indexes.sql
# Single file, saves SQL to file
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## Options

- `-o, --output <path>` - Save suggestions to file

## License

MIT
npm package: @lxgicstudios/ai-mock-data
Description: AI-powered mock data generator - create realistic test fixtures from types, schemas, or descriptions using GPT
Author: LXGIC Studios
Latest version: 1.0.1

# ai-mock-data

[![npm version](https://img.shields.io/npm/v/ai-mock-data.svg)](https://www.npmjs.com/package/ai-mock-data)
[![npm downloads](https://img.shields.io/npm/dm/ai-mock-data.svg)](https://www.npmjs.com/package/ai-mock-data)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

AI-powered mock data generator. Create realistic test fixtures without writing faker configs.

Need test data that doesn't look like garbage? Describe what you want and get back realistic mock data. Way better than writing faker.js configs by hand.

## Install

```bash
npm install -g ai-mock-data
```

## Usage

```bash
# Simple description
npx ai-mock-data "users with name, email, age" --count 50

# Get CSV instead
npx ai-mock-data "product catalog with prices" --count 100 --format csv

# SQL inserts
npx ai-mock-data "blog posts with authors" --format sql --count 20

# From a schema file
npx ai-mock-data "users" --schema types/User.ts --count 50

# Save to file
npx ai-mock-data "orders" --count 200 -o mock-orders.json
```

## Setup

```bash
export OPENAI_API_KEY=your-key-here
```

## Options

- `-c, --count <number>` - How many records (default 10)
- `-f, --format <fmt>` - json, csv, or sql (default json)
- `-s, --schema <file>` - TS type or JSON schema file to match
- `-o, --output <file>` - Write to a file

## License

MIT
npm package: @lxgicstudios/ai-monitoring
Description: Generate monitoring and alerting configuration
Author: LXGIC Studios
Latest version: 1.0.0

# ai-monitoring

Generate monitoring and alerting configuration

## Install

```bash
npm install -g ai-monitoring
```

## Usage

```bash
npx ai-monitoring "your description here"
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-next-config
Description: Generate Next.js config with best practices
Author: LXGIC Studios
Latest version: 1.0.0

# ai-next-config

Generate Next.js config with best practices.

## Install

```bash
npm install -g ai-next-config
```

## Usage

```bash
npx ai-next-config
# Reads package.json, generates next.config.mjs

npx ai-next-config -o next.config.js
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-pitch
Description: Generate startup pitch deck content with AI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-pitch

Generate startup pitch deck content with AI.

## Install

```bash
npm install -g ai-pitch
```

## Usage

```bash
npx ai-pitch "AI-powered code review tool for teams"
npx ai-pitch "marketplace for freelance designers" -o deck.md
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-pr
Description: Generate pull request descriptions from git diff. Summarize changes, list modified files, detect breaking changes, and suggest reviewers automatically.
Author: LXGIC Studios
Latest version: 1.0.0

# @lxgicstudios/ai-pr

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/ai-pr.svg)](https://www.npmjs.com/package/@lxgicstudios/ai-pr)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)

Generate pull request descriptions from git diff. Automatically summarizes changes, lists modified files, detects breaking changes, and suggests reviewers.

## Install

```bash
npm install -g @lxgicstudios/ai-pr
```

Or run directly:

```bash
npx @lxgicstudios/ai-pr
```

## Usage

```bash
# Basic - diff against main branch
ai-pr

# Diff against a specific branch
ai-pr --base develop

# Output as markdown
ai-pr --markdown

# Save to file
ai-pr --markdown --output pr-description.md

# Detect breaking changes
ai-pr --breaking

# JSON output (great for CI/CD)
ai-pr --json
```

## Features

- Zero dependencies - uses only Node.js builtins
- Generates PR descriptions from git diff automatically
- Categorizes files (Source, Tests, Config, CI/CD, Docs, Styles)
- Detects breaking changes from commits and removed exports
- Suggests reviewers based on git history
- Colorful terminal output with clean formatting
- Markdown output for direct pasting into PRs
- JSON output for CI/CD integration
- Works with any git repository

## Options

| Option | Description | Default |
|--------|-------------|---------|
| `--base <branch>` | Base branch to diff against | `main` |
| `--template` | Use conventional commit format | `false` |
| `--breaking` | Highlight breaking changes | `false` |
| `--markdown` | Output raw markdown | `false` |
| `--output <file>` | Write markdown to file | - |
| `--json` | Output as JSON | `false` |
| `--help` | Show help message | - |

## License

MIT

---

**Built by [LXGIC Studios](https://lxgicstudios.com)**
npm package: @lxgicstudios/ai-regex
Description: Generate regex patterns from plain English descriptions
Author: LXGIC Studios
Latest version: 1.0.0

# ai-regex

Generate regex patterns from plain English. No more regex pain.

## Install

```bash
npm install -g ai-regex
```

## Usage

```bash
npx ai-regex "email addresses"
# → /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g

npx ai-regex "US phone numbers" --json
# → Full JSON with pattern, flags, explanation, examples
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-release
Description: Generate semantic version bumps, release notes, and git tags using AI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-release

Automatic semantic versioning, release notes, and git tags. Reads your commits and figures out the rest.

## Install

```bash
npm install -g ai-release
```

## Usage

```bash
npx ai-release
# → minor bump: v1.2.0 → v1.3.0
# → Creates annotated tag with release notes

npx ai-release --dry-run
# → Preview the bump and notes without tagging

npx ai-release --no-tag
# → Generate notes without creating a git tag
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-schema
Description: Generate database schemas from plain English descriptions
Author: LXGIC Studios
Latest version: 1.0.0

# ai-schema

Generate database schemas from plain English. Supports PostgreSQL, MySQL, and SQLite.

## Install

```bash
npm install -g ai-schema
```

## Usage

```bash
npx ai-schema "e-commerce with users, products, orders"
# Outputs PostgreSQL CREATE TABLE statements

npx ai-schema "blog with posts, comments, tags" --dialect mysql
# MySQL syntax

npx ai-schema "SaaS with teams, members, billing" -o schema.sql
# Write to file
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## Options

- `-d, --dialect` - postgresql, mysql, or sqlite (default: postgresql)
- `-o, --output` - Write schema to a file

## License

MIT
npm package: @lxgicstudios/ai-script
Description: Generate package.json scripts with AI
Author: LXGIC Studios
Latest version: 1.0.0

# ai-script

Generate package.json scripts with AI

## Install

```bash
npm install -g ai-script
```

## Usage

```bash
npx ai-script "lint, test, build, deploy"
npx ai-script "docker build, docker push, k8s deploy"
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/ai-sql
Description: Convert natural language to SQL queries using AI
Author: LXGIC Studios
Latest version: 1.0.1

# @lxgicstudios/ai-sql

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/ai-sql.svg)](https://www.npmjs.com/package/@lxgicstudios/ai-sql)
[![npm downloads](https://img.shields.io/npm/dm/@lxgicstudios/ai-sql.svg)](https://www.npmjs.com/package/@lxgicstudios/ai-sql)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/lxgic-studios/ai-sql)](https://github.com/lxgic-studios/ai-sql/stargazers)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue)](https://www.typescriptlang.org/)


AI-powered natural language to SQL converter. Just describe what you want.

Convert natural language to SQL queries. Just describe what you want.

## Install

```bash
npm install -g @lxgicstudios/ai-sql
```

## Usage

```bash
npx @lxgicstudios/ai-sql "find users who signed up last week"
npx @lxgicstudios/ai-sql "top 10 products by revenue" -d mysql
npx @lxgicstudios/ai-sql "monthly active users trend" -s "users(id,email,created_at,last_login)"
```

## Options

- `-d, --dialect <dialect>` - SQL dialect (default: PostgreSQL)
- `-s, --schema <schema>` - Table schema for context

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-test-gen
Description: AI-powered unit test generator - create Jest, Vitest, and Mocha tests from source files using GPT
Author: LXGIC Studios
Latest version: 1.0.1

# ai-test-gen

Point it at your source files and it writes unit tests for you. Supports Jest, Vitest, and Mocha.

## Install

```bash
npm install -g ai-test-gen
```

## Setup

```bash
export OPENAI_API_KEY=sk-your-key-here
```

## Usage

```bash
# Generate Jest tests for a file
npx ai-test-gen src/utils.ts --framework jest

# Vitest instead
npx ai-test-gen src/utils.ts --framework vitest

# Multiple files
npx ai-test-gen "src/**/*.ts" --framework jest

# Save to a file
npx ai-test-gen src/utils.ts --framework jest -o src/__tests__/utils.test.ts
```

## What you get

Actual test files with imports, describe blocks, and test cases. It covers happy paths, edge cases, and error handling. You'll probably want to tweak them a bit, but it beats starting from scratch.

## Heads up

The generated tests are a starting point. They won't know about your mocks, test utilities, or specific setup. But they'll get you 80% there, which is the annoying part anyway.
npm package: @lxgicstudios/ai-validator
Description: Generate Zod and Yup validation schemas from TypeScript types
Author: LXGIC Studios
Latest version: 1.0.0

# ai-validator

Generate Zod and Yup validation schemas from TypeScript types

## Install

```bash
npm install -g ai-validator
```

## Usage

```bash
npx ai-validator ./path/to/file
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```

## License

MIT
npm package: @lxgicstudios/ai-wiki
Description: AI-powered wiki generator - GitHub wiki pages from code with GPT
Author: LXGIC Studios
Latest version: 1.0.1

# ai-wiki

[![npm version](https://img.shields.io/npm/v/ai-wiki.svg)](https://www.npmjs.com/package/ai-wiki)
[![npm downloads](https://img.shields.io/npm/dm/ai-wiki.svg)](https://www.npmjs.com/package/ai-wiki)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/lxgic-studios/ai-wiki)](https://github.com/lxgic-studios/ai-wiki/stargazers)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue)](https://www.typescriptlang.org/)



Generate a project wiki from your codebase

## Install

```bash
npm install -g ai-wiki
```

## Usage

```bash
npx ai-wiki ./src/
npx ai-wiki ./lib/
```

## Setup

```bash
export OPENAI_API_KEY=sk-...
```
npm package: @lxgicstudios/api-rate
Description: Test and measure API rate limits. Send increasing request bursts, detect throttling, show requests/second before 429, retry-after values, and rate limit headers.
Author: LXGIC Studios
Latest version: 1.0.0

# @lxgicstudios/api-rate

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/api-rate.svg)](https://www.npmjs.com/package/@lxgicstudios/api-rate)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)

Test and measure API rate limits. Send increasing request bursts, detect when throttling kicks in, and show requests/second before 429 along with retry-after values and rate limit headers.

## Install

```bash
npm install -g @lxgicstudios/api-rate
```

Or run directly:

```bash
npx @lxgicstudios/api-rate https://api.example.com/endpoint
```

## Usage

```bash
# Basic rate limit test
api-rate https://api.example.com/endpoint

# Custom ramp-up pattern
api-rate https://api.example.com --ramp 1,5,10,50,100

# Set test duration
api-rate https://api.example.com --duration 60s

# Add authentication headers
api-rate https://api.example.com -H "Authorization: Bearer your-token"

# POST requests
api-rate https://api.example.com -m POST

# JSON output for analysis
api-rate https://api.example.com --json
```

## Features

- Zero dependencies - uses only Node.js builtins
- Sends increasing concurrent request bursts to detect rate limits
- Shows exactly when throttling kicks in (HTTP 429)
- Displays requests/second you can sustain safely
- Captures rate-limit headers (X-RateLimit-*, Retry-After)
- Warm-up request before testing starts
- Progress bar showing test advancement
- Status code distribution for each burst
- Configurable ramp-up pattern
- Configurable test duration timeout
- JSON output for automated analysis
- Colorful terminal output with clear status indicators

## How It Works

1. Sends a warm-up request to verify the endpoint is reachable
2. Runs burst tests with increasing concurrency (1, 5, 10, 25, 50 by default)
3. For each burst, sends all requests concurrently and measures responses
4. Detects HTTP 429 responses and captures rate limit headers
5. Reports the maximum safe request rate before throttling

## Options

| Option | Description | Default |
|--------|-------------|---------|
| `--ramp <n,n,n>` | Concurrent request counts per burst | `1,5,10,25,50` |
| `--duration, -d` | Max test duration in seconds | `30s` |
| `--method, -m` | HTTP method | `GET` |
| `--header, -H` | Add custom header (repeatable) | - |
| `--verbose, -v` | Show detailed output | `false` |
| `--json` | Output results as JSON | `false` |
| `--help, -h` | Show help message | - |

## License

MIT

---

**Built by [LXGIC Studios](https://lxgicstudios.com)**
npm package: @lxgicstudios/bundle-check
Description: Check npm package bundle sizes before installing. Shows minified + gzipped size, dependency count, and suggests lighter alternatives. Perfect for CI pipelines.
Author: LXGIC Studios
Latest version: 1.0.0

# bundle-check

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/bundle-check.svg)](https://www.npmjs.com/package/@lxgicstudios/bundle-check)
[![license](https://img.shields.io/npm/l/@lxgicstudios/bundle-check.svg)](https://github.com/lxgicstudios/bundle-check/blob/main/LICENSE)
[![node](https://img.shields.io/node/v/@lxgicstudios/bundle-check.svg)](https://nodejs.org)

Check npm package bundle sizes before you install them. Shows unpacked size, gzipped size, dependency count, and suggests lighter alternatives when they exist.

## Install

```bash
npm install -g @lxgicstudios/bundle-check
```

Or run directly with npx:

```bash
npx @lxgicstudios/bundle-check lodash
```

## Usage

```bash
# Check a single package
bundle-check lodash

# Compare two packages side by side
bundle-check --compare moment dayjs

# CI mode with size limit (exits 1 if over)
bundle-check express --limit 500KB

# JSON output for scripts
bundle-check react --json
```

## Features

- Shows unpacked and gzipped bundle sizes
- Counts direct dependencies
- Suggests lighter alternatives for popular heavy packages
- Compare two packages side by side with `--compare`
- CI-friendly `--limit` flag that exits with code 1 if size is over threshold
- JSON output for piping into other tools
- ZERO external dependencies (uses built-in Node modules only)
- Colorful terminal output

## Options

| Option | Description |
|--------|-------------|
| `--compare <a> <b>` | Compare two packages side by side |
| `--limit <size>` | Fail if gzip size exceeds limit (e.g., 100KB, 1MB) |
| `--json` | Output results as JSON |
| `--help` | Show help message |

## Size Formats

You can use these formats with `--limit`:

- `100B` (bytes)
- `10KB` (kilobytes)
- `1MB` (megabytes)
- `1GB` (gigabytes)

## CI Usage

Add bundle size checks to your CI pipeline:

```bash
# Fail if any package is over 500KB gzipped
npx @lxgicstudios/bundle-check express --limit 500KB
```

## Built With

- Node.js built-in `https`, `http`, and `zlib` modules
- npm registry API
- Zero external dependencies

## License

MIT - [LXGIC Studios](https://github.com/lxgicstudios)
npm package: @lxgicstudios/csvkit-next
Description: Advanced CSV toolkit. Transform, filter, merge, validate, and analyze CSV files. Zero dependencies.
Author: LXGIC Studios
Latest version: 1.0.1

# csvkit-next

Advanced CSV toolkit. Transform, filter, merge, validate, and analyze CSV files. Zero dependencies.

## Installation

```bash
npm install -g @lxgicstudios/csvkit-next
```

Or use directly:

```bash
npx @lxgicstudios/csvkit-next stats data.csv
```

## Commands

### Filter rows

```bash
csvkit filter data.csv age gt 30
csvkit filter users.csv email contains @gmail
csvkit filter sales.csv status eq completed
```

**Operators:** eq, ne, gt, lt, gte, lte, contains, startswith, endswith, regex, empty, notempty

### Transform columns

```bash
csvkit transform data.csv "full_name=first+' '+last"
csvkit transform prices.csv "total=price*quantity"
csvkit transform users.csv "email_domain=email.split('@')[1]"
```

### Merge files

```bash
csvkit merge users.csv orders.csv -o combined.csv
```

### Validate

```bash
csvkit validate data.csv
csvkit validate data.csv schema.json
```

Schema format:
```json
{
  "required": ["id", "email"],
  "types": {
    "age": "number",
    "email": "email",
    "created": "date"
  }
}
```

### Statistics

```bash
csvkit stats sales.csv
```

Output:
```
Rows: 1523
Columns: id, product, price, quantity, date

Column Stats:
  price:
    Type: number
    Non-empty: 1523/1523
    Min: 9.99, Max: 499.99, Avg: 87.45
    Unique: 342
```

### Other Commands

```bash
csvkit head data.csv 20          # First 20 rows
csvkit tail data.csv 20          # Last 20 rows
csvkit columns data.csv          # List columns
csvkit sort data.csv price desc  # Sort by price descending
csvkit unique data.csv category  # Unique values in column
csvkit sample data.csv 50        # Random 50 rows
csvkit convert data.csv -t json  # Convert to JSON
```

## Programmatic Usage

```javascript
const { parseCSV, filter, transform, stats } = require('@lxgicstudios/csvkit-next');

// Parse CSV
const data = parseCSV(csvString);

// Filter
const adults = filter(data, 'age', 'gte', '18');

// Transform
const withFullName = transform(data, "name=first+' '+last");

// Get stats
const statistics = stats(data);
console.log(statistics.rows, statistics.columns);
```

## Why csvkit-next?

- **Zero dependencies** - Pure JavaScript, nothing to install
- **Fast** - Streams large files efficiently
- **Complete** - Filter, transform, merge, validate, analyze
- **Scriptable** - Works great in pipelines

---

**Built by [LXGIC Studios](https://lxgicstudios.com)**

🔗 [GitHub](https://github.com/lxgicstudios/csvkit-next) · [Twitter](https://x.com/lxgicstudios)
npm package: @lxgicstudios/docvert
Description: Convert documents between formats. PDF to Markdown, DOCX to HTML, TXT extraction. Zero-config CLI tool.
Author: LXGIC Studios
Latest version: 1.0.1

# docvert

Convert documents between formats. PDF, DOCX, HTML, Markdown, TXT. Zero-config CLI tool.

## Installation

```bash
npm install -g @lxgicstudios/docvert
```

Or use directly with npx:

```bash
npx @lxgicstudios/docvert document.docx
```

## Usage

```bash
# Basic conversion (auto-detects output format)
docvert document.docx              # → document.md

# Specify output format
docvert report.pdf -t html         # → report.html
docvert page.html -t md            # → page.md

# Custom output path
docvert input.docx -o output.md

# Batch conversion
docvert *.docx -t md
```

## Supported Formats

| Input | Output |
|-------|--------|
| .docx | .md, .html, .txt |
| .pdf  | .md, .html, .txt |
| .html | .md, .txt |
| .md   | .html, .txt |
| .txt  | .md, .html |

## Options

| Option | Description |
|--------|-------------|
| `-o, --output <file>` | Output file path |
| `-t, --to <format>` | Target format: md, html, txt |
| `-v, --verbose` | Show detailed output |
| `-h, --help` | Show help |

## Programmatic Usage

```javascript
const { convert } = require('@lxgicstudios/docvert');

// Convert DOCX to Markdown
const markdown = await convert('document.docx', 'md');

// Convert PDF to HTML
const html = await convert('report.pdf', 'html');
```

## Examples

### Convert a Word document to Markdown

```bash
docvert meeting-notes.docx
# Output: meeting-notes.md
```

### Convert PDF report to HTML

```bash
docvert quarterly-report.pdf -t html -o report.html
```

### Batch convert all DOCX files in a folder

```bash
docvert docs/*.docx -t md
```

## Why docvert?

- **Zero config** - Works out of the box
- **Fast** - Lazy-loads dependencies
- **Clean output** - Produces readable, well-formatted documents
- **Batch processing** - Convert multiple files at once

---

**Built by [LXGIC Studios](https://lxgicstudios.com)**

🔗 [GitHub](https://github.com/lxgicstudios/docvert) · [Twitter](https://x.com/lxgicstudios)
npm package: @lxgicstudios/env-typegen
Description: Generate TypeScript types from .env files with smart type inference. Zero-config CLI tool.
Author: LXGIC Studios
Latest version: 1.0.1

# @lxgicstudios/env-typegen

Generate TypeScript types from your .env files with smart type inference.

No more `process.env.PORT as unknown as number`. Get proper types automatically.

## Installation

```bash
# Use directly with npx (recommended)
npx @lxgicstudios/env-typegen

# Or install globally
npm install -g @lxgicstudios/env-typegen
```

## Usage

```bash
# Generate types from .env in current directory
npx @lxgicstudios/env-typegen

# Generate from specific file
npx @lxgicstudios/env-typegen .env.local

# Output to custom path
npx @lxgicstudios/env-typegen -o src/types/env.d.ts

# Also generate Zod schema for runtime validation
npx @lxgicstudios/env-typegen --zod
```

## Example

Given this `.env`:

```env
# Database configuration
DATABASE_URL=postgresql://localhost:5432/mydb
DB_POOL_SIZE=10

# Server settings
PORT=3000
DEBUG=true

# External services
API_KEY=sk_live_abc123
ADMIN_EMAIL=admin@example.com
```

Running `npx @lxgicstudios/env-typegen` generates:

```typescript
export interface Env {
  /** Database configuration */
  DATABASE_URL: string;
  DB_POOL_SIZE: number;
  /** Server settings */
  PORT: number;
  DEBUG: boolean;
  /** External services */
  API_KEY: string;
  ADMIN_EMAIL: string;
}

export function getEnv(): Env {
  return {
    DATABASE_URL: process.env.DATABASE_URL || '',
    DB_POOL_SIZE: Number(process.env.DB_POOL_SIZE),
    PORT: Number(process.env.PORT),
    DEBUG: ['true', '1', 'yes'].includes((process.env.DEBUG || '').toLowerCase()),
    API_KEY: process.env.API_KEY || '',
    ADMIN_EMAIL: process.env.ADMIN_EMAIL || '',
  } as Env;
}

// Augment NodeJS namespace
declare global {
  namespace NodeJS {
    interface ProcessEnv {
      DATABASE_URL: string;
      DB_POOL_SIZE: string;
      PORT: string;
      DEBUG: string;
      API_KEY: string;
      ADMIN_EMAIL: string;
    }
  }
}
```

## Type Inference

| Pattern | Inferred Type |
|---------|---------------|
| `PORT=3000` | `number` |
| `DEBUG=true` | `boolean` |
| `API_URL=https://...` | `string` (URL) |
| `EMAIL=a@b.com` | `string` (email) |
| Everything else | `string` |

## Options

| Option | Description |
|--------|-------------|
| `-i, --input <file>` | Input .env file (default: .env) |
| `-o, --output <file>` | Output file (default: env.d.ts) |
| `--zod` | Also generate Zod schema |
| `--name <name>` | Interface name (default: Env) |
| `-h, --help` | Show help |

## Programmatic API

```typescript
import { 
  parseEnvFile, 
  generateTypeScript, 
  generateZodSchema 
} from '@lxgicstudios/env-typegen';

// Parse .env file
const variables = parseEnvFile('.env');

// Generate TypeScript
const ts = generateTypeScript(variables, 'MyEnv');

// Generate Zod schema
const zod = generateZodSchema(variables);
```

---

**Built by [LXGIC Studios](https://lxgicstudios.com)**

🔗 [GitHub](https://github.com/lxgicstudios/env-typegen) · [Twitter](https://x.com/lxgicstudios)
npm package: @lxgicstudios/hash-it
Description: Hash passwords with bcrypt, generate file checksums (SHA-256, SHA-512, MD5), and verify hashes. Fast CLI hashing tool powered by Node crypto.
Author: LXGIC Studios
Latest version: 1.0.0

# hash-it

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/hash-it.svg)](https://www.npmjs.com/package/@lxgicstudios/hash-it)
[![license](https://img.shields.io/npm/l/@lxgicstudios/hash-it.svg)](https://github.com/lxgicstudios/hash-it/blob/main/LICENSE)
[![node](https://img.shields.io/node/v/@lxgicstudios/hash-it.svg)](https://nodejs.org)

Hash passwords with bcrypt, generate file checksums (SHA-256, SHA-512, MD5), and verify hashes. All from the command line. One dependency (bcryptjs).

## Install

```bash
npm install -g @lxgicstudios/hash-it
```

Or run directly:

```bash
npx @lxgicstudios/hash-it password "my-secret"
```

## Features

- Hash passwords with bcrypt (configurable rounds)
- Verify passwords against bcrypt hashes
- Generate file checksums (SHA-256, SHA-512, MD5)
- Hash arbitrary text strings
- Multiple output encodings (hex, base64)
- JSON output for scripting
- Colorful terminal output
- Just one external dependency (bcryptjs)

## Usage

### Hash a password

```bash
hash-it password "my-secret-password"
# => $2a$10$K8Y1...
```

### Verify a password

```bash
hash-it verify "my-secret" '$2a$10$K8Y1...'
# => MATCH or NO MATCH
```

### File checksum

```bash
hash-it checksum package.json
# => SHA-256: a1b2c3d4...

hash-it checksum --algo md5 large-file.zip
# => MD5: e5f6a7b8...
```

### Hash text

```bash
hash-it text "hello world"
# => SHA-256: b94d27b9...

hash-it text --algo sha512 "hello world"
```

## Options

| Option | Alias | Default | Description |
|--------|-------|---------|-------------|
| `--help` | `-h` | | Show help message |
| `--json` | | | Output as JSON |
| `--algo` | `-a` | `sha256` | Hash algorithm: sha256, sha512, md5 |
| `--rounds` | `-r` | `10` | Bcrypt salt rounds |
| `--encoding` | `-e` | `hex` | Output encoding: hex, base64 |

## Commands

| Command | Description |
|---------|-------------|
| `password <text>` | Hash a password with bcrypt |
| `verify <text> <hash>` | Verify password against bcrypt hash |
| `checksum <file>` | Generate file checksum |
| `text <string>` | Hash a text string |

## License

MIT - [LXGIC Studios](https://lxgicstudios.com)
npm package: @lxgicstudios/header-check
Description: Audit HTTP security headers on any URL. Checks CSP, HSTS, X-Frame-Options, and more. Gives letter grades A-F with fix suggestions for Express and Nginx.
Author: LXGIC Studios
Latest version: 1.0.0

# header-check

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/header-check.svg)](https://www.npmjs.com/package/@lxgicstudios/header-check)
[![license](https://img.shields.io/npm/l/@lxgicstudios/header-check.svg)](https://github.com/lxgicstudios/header-check/blob/main/LICENSE)
[![node](https://img.shields.io/node/v/@lxgicstudios/header-check.svg)](https://nodejs.org)

Audit HTTP security headers on any URL. Checks CSP, HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, and Permissions-Policy. Gives you a letter grade A-F and generates fix snippets for Express and Nginx.

## Install

```bash
npm install -g @lxgicstudios/header-check
```

Or run directly with npx:

```bash
npx @lxgicstudios/header-check https://example.com
```

## Usage

```bash
# Basic security audit
header-check https://example.com

# Audit with fix suggestions for Express and Nginx
header-check https://example.com --fix

# CI mode - fail if grade is below B
header-check https://example.com --ci --min-grade B

# JSON output
header-check https://example.com --json
```

## Features

- Checks 7 critical security headers with weighted scoring
- Letter grade A-F based on overall security posture
- Generates ready-to-use config snippets for Express.js and Nginx
- CI-friendly with `--ci` and `--min-grade` flags
- JSON output for automation
- ZERO external dependencies
- Works with HTTP and HTTPS URLs

## Headers Checked

| Header | Points | What It Does |
|--------|--------|-------------|
| Content-Security-Policy | 10 | Prevents XSS and injection attacks |
| Strict-Transport-Security | 10 | Forces HTTPS connections |
| X-Frame-Options | 5 | Prevents clickjacking |
| X-Content-Type-Options | 5 | Prevents MIME type sniffing |
| Referrer-Policy | 5 | Controls referrer information |
| Permissions-Policy | 5 | Controls browser features (camera, mic, etc.) |
| X-XSS-Protection | 5 | Legacy XSS filter hint |

## Options

| Option | Description |
|--------|-------------|
| `--fix` | Show config snippets for Express and Nginx |
| `--ci` | CI mode (exit code 1 if below min-grade) |
| `--min-grade <A-F>` | Minimum acceptable grade (default: C) |
| `--json` | Output results as JSON |
| `--help` | Show help message |

## Grading Scale

| Grade | Score |
|-------|-------|
| A | 90-100% |
| B | 80-89% |
| C | 65-79% |
| D | 50-64% |
| F | Below 50% |

## CI Usage

```bash
# Fail the build if security headers aren't up to par
npx @lxgicstudios/header-check https://your-site.com --ci --min-grade B
```

## License

MIT - [LXGIC Studios](https://github.com/lxgicstudios)
npm package: @lxgicstudios/incident
Description: Generate structured incident reports and postmortems with interactive prompts. Supports Google SRE, PagerDuty, and basic templates. Output as markdown.
Author: LXGIC Studios
Latest version: 1.0.0

# @lxgicstudios/incident

[![npm version](https://img.shields.io/npm/v/@lxgicstudios/incident)](https://www.npmjs.com/package/@lxgicstudios/incident)
[![license](https://img.shields.io/npm/l/@lxgicstudios/incident)](LICENSE)
[![node](https://img.shields.io/node/v/@lxgicstudios/incident)](package.json)

Generate structured incident reports and postmortems with interactive prompts. Supports Google SRE, PagerDuty, and basic templates. Output as markdown.

Zero external dependencies. Just Node.js builtins.

## Install

```bash
npm install -g @lxgicstudios/incident
```

Or run directly:

```bash
npx @lxgicstudios/incident new
```

## Usage

```bash
# Create a new incident interactively
incident new

# List all incidents
incident list

# View a specific incident
incident view INC-20260208-A1B2

# Export as markdown
incident export INC-20260208-A1B2

# List incidents as JSON
incident list --json
```

## Features

- **Interactive prompts** for timeline, root cause, severity, and action items
- **Three templates**: Basic, Google SRE, PagerDuty
- **Severity levels**: SEV1 through SEV4
- **Timeline tracking** with timestamps
- **Action items** with priority, owner, and status
- **Lessons learned** section
- **Markdown export** for sharing and documentation
- **JSON storage** in `.incidents/` directory
- **Zero dependencies** - uses only Node.js builtins

## Templates

| Template | Style | Best For |
|----------|-------|----------|
| `basic` | Simple fields, clean layout | Quick reports, small teams |
| `google-sre` | Detailed postmortem with detection/trigger sections | SRE teams, thorough analysis |
| `pagerduty` | Incident response format with communication checklist | On-call teams, response tracking |

## Commands

| Command | Description |
|---------|-------------|
| `new` | Create a new incident report interactively |
| `list` | List all saved incidents |
| `view <id>` | Display an incident's full report |
| `export <id>` | Save incident as a markdown file |

## Options

| Option | Description | Default |
|--------|-------------|---------|
| `--template <name>` | Template: basic, google-sre, pagerduty | `basic` |
| `--severity <level>` | SEV1, SEV2, SEV3, or SEV4 | |
| `--output <file>` | Output file for export | `<ID>.md` |
| `--json` | Output as JSON | `false` |
| `--help` | Show help message | |
| `--version` | Show version number | |

## Storage

Incidents are stored in `.incidents/` as both JSON (data) and Markdown (readable). You can commit this directory to your repo for team access.

```
.incidents/
  INC-20260208-A1B2.json
  INC-20260208-A1B2.md
```

## License

MIT - [LXGIC Studios](https://lxgicstudios.com)
npm package: @lxgicstudios/json-to-ts
Description: Generate TypeScript interfaces from JSON data or API responses. Zero-config CLI tool.
Author: LXGIC Studios
Latest version: 1.0.1

# @lxgicstudios/json-to-ts

Generate TypeScript interfaces from JSON data or API responses.

Stop writing types by hand. Just paste your JSON.

## Installation

```bash
# Use directly with npx (recommended)
npx @lxgicstudios/json-to-ts data.json

# Or install globally
npm install -g @lxgicstudios/json-to-ts
```

## Usage

```bash
# From file
npx @lxgicstudios/json-to-ts data.json

# From URL
npx @lxgicstudios/json-to-ts https://api.example.com/users -n User

# From pipe
curl https://api.example.com/users | npx @lxgicstudios/json-to-ts

# Output to file
npx @lxgicstudios/json-to-ts response.json -o src/types/api.ts
```

## Example

Given this JSON:

```json
{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com",
  "address": {
    "street": "123 Main St",
    "city": "Anytown"
  },
  "tags": ["developer", "typescript"]
}
```

Running `npx @lxgicstudios/json-to-ts user.json -n User` outputs:

```typescript
export interface Address {
  street: string;
  city: string;
}

export interface User {
  id: number;
  name: string;
  email: string;
  address: Address;
  tags: string[];
}
```

## Options

| Option | Description |
|--------|-------------|
| `-n, --name <name>` | Root interface name (default: Root) |
| `-o, --output <file>` | Write to file |
| `-t, --type` | Use `type` instead of `interface` |
| `--optional` | Make all properties optional |
| `--no-export` | Don't add `export` keyword |
| `-h, --help` | Show help |

## Features

- ✅ Nested objects become separate interfaces
- ✅ Arrays are properly typed
- ✅ Mixed arrays become union types
- ✅ Fetches from URLs
- ✅ Pipe support
- ✅ Handles empty arrays as `unknown[]`

## Programmatic API

```typescript
import { 
  jsonToTypeScript, 
  parseAndGenerate, 
  fetchAndGenerate 
} from '@lxgicstudios/json-to-ts';

// From object
const types = jsonToTypeScript({ id: 1, name: 'Test' }, { rootName: 'User' });

// From JSON string
const types2 = parseAndGenerate('{"id": 1}', { useType: true });

// From URL
const types3 = await fetchAndGenerate('https://api.example.com/data', {
  rootName: 'ApiResponse',
  optional: true
});
```

---

**Built by [LXGIC Studios](https://lxgicstudios.com)**

🔗 [GitHub](https://github.com/lxgicstudios/json-to-ts) · [Twitter](https://x.com/lxgicstudios)