{"_id":"@cometpisces/tarot-kit","_rev":"4-ba86e789967c4f9af98aa9af56f0e759","name":"@cometpisces/tarot-kit","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@cometpisces/tarot-kit","version":"0.1.0","license":"MIT","_id":"@cometpisces/tarot-kit@0.1.0","maintainers":[{"name":"cometpisces","email":"koyostar@gmail.com"}],"dist":{"shasum":"3987c330e83deaf5ebca8ce28237e68f0efe20b3","tarball":"https://registry.npmjs.org/@cometpisces/tarot-kit/-/tarot-kit-0.1.0.tgz","fileCount":31,"integrity":"sha512-QhAaecKFHX/F5WTG6wpZkpUjdA+sKsIuUnLybB2fxEjERqwXoLgXacXx4Gp+aEBmapI4lo+X9EaDMAaDfelzUw==","signatures":[{"sig":"MEQCIH2hzzbJMWB/XGXLE6SI6mRC7yL0TZQq+LgmVp65WhydAiBsCIXo/YNl3xT+d/T8dIr7gF/o3Tf0EDt3NnNOmt40lQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":555369},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"d01434bf7db5d8c41e8058b57e814098f85e0ec9","scripts":{"test":"echo \"no tests yet\"","build":"tsc","export:json":"node dist/scripts/export-json.js"},"_npmUser":{"name":"cometpisces","email":"koyostar@gmail.com"},"_npmVersion":"11.6.2","description":"Rider-Waite tarot data and helper utilities","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/tarot-kit_0.1.0_1779641236861_0.8579627680498927","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cometpisces/tarot-kit","version":"0.1.1","license":"MIT","_id":"@cometpisces/tarot-kit@0.1.1","maintainers":[{"name":"cometpisces","email":"koyostar@gmail.com"}],"dist":{"shasum":"dc9739f87f96900b12f338f557afe882c43d36e9","tarball":"https://registry.npmjs.org/@cometpisces/tarot-kit/-/tarot-kit-0.1.1.tgz","fileCount":32,"integrity":"sha512-VEqrJzcEZiITAMfxfSIqs2UYVkeN72d08ohLXVkITLOkS8Hq0sk34KfrgJ0YTu07g9XFpfT23iGd5eNl8Ax69g==","signatures":[{"sig":"MEUCIQCWU7P8Ft3AKk3YAR7AqzDWeLEmGseqP/A7tvWuS87a1gIgMUeBKai1PLMWBAxvGD09h3dXvjFP32gNKXcx95F7BwU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":558519},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"d01434bf7db5d8c41e8058b57e814098f85e0ec9","scripts":{"test":"echo \"no tests yet\"","build":"tsc","export:json":"node dist/scripts/export-json.js"},"_npmUser":{"name":"cometpisces","email":"koyostar@gmail.com"},"_npmVersion":"11.6.2","description":"Rider-Waite tarot data and helper utilities","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/tarot-kit_0.1.1_1779641851267_0.878191797225929","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cometpisces/tarot-kit","version":"0.1.2","keywords":["tarot","rider-waite","tarot-cards","card-meanings","divination","major-arcana","minor-arcana","card-reading","typescript","localization","i18n"],"license":"MIT","_id":"@cometpisces/tarot-kit@0.1.2","maintainers":[{"name":"cometpisces","email":"koyostar@gmail.com"}],"dist":{"shasum":"0a59bac2a83c9dcfd26221478341d2923bcbbc8b","tarball":"https://registry.npmjs.org/@cometpisces/tarot-kit/-/tarot-kit-0.1.2.tgz","fileCount":32,"integrity":"sha512-3HoKzB+xkEoBjCnloaxe/2ybnZaRvg4WTB/UopVGzhHkc8c8ryDnkKGrDorkXQ2jMyebb3Rb8rsFSdoH30/jqQ==","signatures":[{"sig":"MEUCIDH2u/pm3LfCfUDO3BRxSrKpOwzQfM7nm8fFJS6ek46OAiEAmU0VOnQApDVgcIf5DZ8+fb1dvl02mX2pVP+eL3rqdwA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":559366},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"d0277853d20b9063227373f35d3b3e6107313d36","scripts":{"test":"echo \"no tests yet\"","build":"tsc","export:json":"node dist/scripts/export-json.js"},"_npmUser":{"name":"cometpisces","email":"koyostar@gmail.com"},"_npmVersion":"11.6.2","description":"Complete Rider-Waite tarot deck data with card meanings, drawing utilities, and localization - TypeScript library for building tarot reading apps","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/tarot-kit_0.1.2_1779645319300_0.5322342580494697","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@cometpisces/tarot-kit","version":"0.2.0","description":"Complete Rider-Waite tarot deck data with card meanings, drawing utilities, and localization - TypeScript library for building tarot reading apps","license":"MIT","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","export:json":"node dist/scripts/export-json.js","test":"echo \"no tests yet\""},"devDependencies":{"@types/node":"^25.6.0","typescript":"^6.0.2"},"keywords":["tarot","rider-waite","tarot-cards","card-meanings","divination","major-arcana","minor-arcana","card-reading","typescript","localization","i18n"],"gitHead":"d6a05b4ee6dfff5ce07339f8ed1af3d7a8a9575c","_id":"@cometpisces/tarot-kit@0.2.0","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-5BgI7Q5J5870s1KC9FxWf/HGhh1WBapvZdIn1+ad/0JB7WBARDVBWbBnxXWPR2H4bw+P9KlaG0+3jDwOnxe5eA==","shasum":"fa1a32aaff51f136ec25d8e6de132904968b7c41","tarball":"https://registry.npmjs.org/@cometpisces/tarot-kit/-/tarot-kit-0.2.0.tgz","fileCount":32,"unpackedSize":552913,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCpztk5jpa8CKJ2AFyLJHKGYLD/C7PzmtvgP+bqtbc7XAIhAN7I66gmmYh2pNktrUqZyO3ri7HSWXbH+mIAJcB6Xrlp"}]},"_npmUser":{"name":"cometpisces","email":"koyostar@gmail.com"},"directories":{},"maintainers":[{"name":"cometpisces","email":"koyostar@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tarot-kit_0.2.0_1779650794077_0.19439970057491385"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-24T16:47:16.701Z","modified":"2026-05-24T19:26:34.345Z","0.1.0":"2026-05-24T16:47:17.073Z","0.1.1":"2026-05-24T16:57:31.442Z","0.1.2":"2026-05-24T17:55:19.498Z","0.2.0":"2026-05-24T19:26:34.249Z"},"license":"MIT","keywords":["tarot","rider-waite","tarot-cards","card-meanings","divination","major-arcana","minor-arcana","card-reading","typescript","localization","i18n"],"description":"Complete Rider-Waite tarot deck data with card meanings, drawing utilities, and localization - TypeScript library for building tarot reading apps","maintainers":[{"name":"cometpisces","email":"koyostar@gmail.com"}],"readme":"# @cometpisces/tarot-kit\n\nRider-Waite tarot card data and helper utilities for building tarot applications.\n\n## Installation\n\n```bash\nnpm install @cometpisces/tarot-kit\n# or\npnpm add @cometpisces/tarot-kit\n# or\nyarn add @cometpisces/tarot-kit\n```\n\n## Features\n\n- 📇 Complete Rider-Waite tarot deck data (78 cards)\n- 🎴 Major and Minor Arcana with detailed meanings\n- 🔀 Card drawing utilities (single or multiple draws)\n- 🌍 Localization support (English and Chinese)\n- 📊 Reading aspects (upright/reversed meanings, context-specific interpretations)\n- 📖 Rich card metadata including keywords, numerology, astrology, and symbolism\n\n## Usage\n\n### Import Card Data\n\n```typescript\nimport { cards, getAllCards, getCardById } from '@cometpisces/tarot-kit';\n\n// Get all 78 cards\nconst allCards = getAllCards();\n\n// Get a specific card by ID\nconst fool = getCardById('major-00-fool');\nconsole.log(fool.name); // \"The Fool\"\n```\n\n### Draw Random Cards\n\n```typescript\nimport { drawRandomCard, drawCards } from '@cometpisces/tarot-kit';\n\n// Draw a single card\nconst singleCard = drawRandomCard();\nconsole.log(singleCard.card.name, singleCard.orientation); // e.g., \"The Fool\", \"upright\"\n\n// Draw multiple cards (e.g., 3-card spread)\nconst threeCards = drawCards(3);\nthreeCards.forEach(drawn => {\n  console.log(`${drawn.card.name} (${drawn.orientation})`);\n});\n```\n\n### Get Card Meanings\n\n```typescript\nimport { getCardMeaning } from '@cometpisces/tarot-kit';\n\nconst fool = getCardById('major-00-fool');\nconst upright = getCardMeaning(fool, 'upright');\nconst reversed = getCardMeaning(fool, 'reversed');\n\nconsole.log(upright.general); // General upright meaning\nconsole.log(reversed.general); // General reversed meaning\n```\n\n### Filter by Arcana\n\n```typescript\nimport { getCardsByArcana } from '@cometpisces/tarot-kit';\n\n// Get all Major Arcana cards\nconst majorArcana = getCardsByArcana('major');\n\n// Get all Minor Arcana cards\nconst minorArcana = getCardsByArcana('minor');\n```\n\n### Localization\n\n```typescript\nimport { getLocalizedText } from '@cometpisces/tarot-kit';\n\nconst fool = getCardById('major-00-fool');\n\n// Get name in different languages\nconst nameInEnglish = getLocalizedText(fool.name, 'en'); // \"The Fool\"\nconst nameInChinese = getLocalizedText(fool.name, 'zh'); // \"愚者\"\n```\n\n## TypeScript Support\n\nThis package is written in TypeScript and includes full type definitions.\n\n```typescript\nimport type { \n  TarotCard, \n  DrawnCard, \n  CardOrientation,\n  TarotCardMeaning \n} from '@cometpisces/tarot-kit';\n\nconst card: TarotCard = getCardById('major-00-fool');\nconst drawn: DrawnCard = drawRandomCard();\nconst orientation: CardOrientation = 'upright';\n```\n\n## Card Data Structure\n\nEach card includes:\n\n- **Basic Info**: ID, name (localized), arcana type, suit (for Minor Arcana)\n- **Meanings**: Upright and reversed interpretations\n- **Reading Aspects**: Context-specific meanings (love, career, spiritual, shadow)\n- **Metadata**: Keywords, numerology, astrology, elemental associations, and symbolism\n\n## Card Images\n\nThis package contains **data only**. For Rider-Waite tarot card images, install the companion package:\n\n```bash\nnpm install @cometpisces/tarot-kit-images\n```\n\n### Using with Images\n\n```typescript\nimport { getCardById, drawRandomCard } from '@cometpisces/tarot-kit';\nimport { getImagePath } from '@cometpisces/tarot-kit-images';\n\nconst drawn = drawRandomCard();\nconst imagePath = getImagePath(drawn.card.id);\n\n// Use in your app\n<img src={`/images/${imagePath}`} alt={drawn.card.name.en} />\n```\n\nSee [@cometpisces/tarot-kit-images](https://www.npmjs.com/package/@cometpisces/tarot-kit-images) for complete documentation.\n\n## License\n\nMIT","readmeFilename":"README.md"}