JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 184
  • Score
    100M100P100Q61150F
  • License MIT

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

Package Exports

  • tarotap
  • tarotap/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tarotap) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

npm install tarotap

Usage

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:

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

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

Live Demo

Try it at Tarotap.com

License

MIT


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