tarotap/README.md

Complete 78-card Tarot deck library with 12-language support (EN/DE/ES/FR/IT/JA/KO/NL/PT/RU/TW/ZH) and TypeScript

# Tarotap - Tarot Card Library

> Complete 78-card Tarot deck library

## Features

- Complete 78 tarot cards (22 Major Arcana + 56 Minor Arcana)
- Multi-language support (English, German, Spanish, French, Italian, Japanese, Korean, Dutch, Portuguese, Russian, Traditional Chinese, Simplified Chinese)
- Random card drawing
- Search cards by name or ID
- Filter by Major/Minor Arcana and suits
- Zero dependencies

## Installation

```bash
npm install tarotap
```

## Usage

```typescript
import { getRandomCard, drawCards, getCardById, getMajorArcana, TarotCard } from 'tarotap';

// Get a random card (English by default)
const card: TarotCard = getRandomCard();
console.log(card.name); // "The Fool"

// Get a random card in German
const cardDE: TarotCard = getRandomCard('de');
console.log(cardDE.name); // "Der Narr"

// Get a random card in Spanish
const cardES: TarotCard = getRandomCard('es');
console.log(cardES.name); // "El Loco"

// Get a random card in French
const cardFR: TarotCard = getRandomCard('fr');
console.log(cardFR.name); // "Le Mat"

// Get a random card in Italian
const cardIT: TarotCard = getRandomCard('it');
console.log(cardIT.name); // "Il Matto"

// Get a random card in Japanese
const cardJA: TarotCard = getRandomCard('ja');
console.log(cardJA.name); // "愚者"

// Get a random card in Korean
const cardKO: TarotCard = getRandomCard('ko');
console.log(cardKO.name); // "바보"

// Get a random card in Dutch
const cardNL: TarotCard = getRandomCard('nl');
console.log(cardNL.name); // "De Dwaas"

// Get a random card in Portuguese
const cardPT: TarotCard = getRandomCard('pt');
console.log(cardPT.name); // "O Louco"

// Get a random card in Russian
const cardRU: TarotCard = getRandomCard('ru');
console.log(cardRU.name); // "Шут"

// Get a random card in Traditional Chinese
const cardTW: TarotCard = getRandomCard('tw');
console.log(cardTW.name); // "愚者"

// Get a random card in Simplified Chinese
const cardZH: TarotCard = getRandomCard('zh');
console.log(cardZH.name); // "愚人"

// Draw multiple cards
const cards: TarotCard[] = drawCards(3, false, 'ja');

// Get specific card
const fool: TarotCard | null = getCardById('the-fool', 'en');

// Get Major Arcana in Korean
const majorArcana: TarotCard[] = getMajorArcana('ko');
```

CommonJS:
```javascript
const tarotap = require('tarotap');
const card = tarotap.getRandomCard('de');
```

## API

- `getAllCards(language?)` - Get all 78 cards
- `getCardById(id, language?)` - Get card by ID
- `getRandomCard(language?)` - Get random card
- `drawCards(count, allowDuplicates?, language?)` - Draw multiple cards
- `getMajorArcana(language?)` - Get Major Arcana cards
- `getMinorArcana(language?)` - Get Minor Arcana cards
- `getCardsBySuit(suit, language?)` - Get cards by suit
- `searchCards(query, language?)` - Search cards

**Languages**: `'en'` (English), `'de'` (German), `'es'` (Spanish), `'fr'` (French), `'it'` (Italian), `'ja'` (Japanese), `'ko'` (Korean), `'nl'` (Dutch), `'pt'` (Portuguese), `'ru'` (Russian), `'tw'` (Traditional Chinese), `'zh'` (Simplified Chinese)

## Card Format

```javascript
{
  "id": "the-fool",
  "name": "The Fool"
}
```

## Live Demo

Try it at [Tarotap.com](https://tarotap.com/en)

## License

MIT

---

*Made with ❤️ by the Tarotap Team - Bringing ancient wisdom to the digital age*