@tomako/tools-runtime 0.1.0

package/src/lib/tools/tarot-reading.ts

@@ -0,0 +1,1044 @@
+import type { AppLocale } from "../../i18n/locale";
+
+import { getTarotVisibleImagery } from "./tarot-imagery";
+
+type TarotCopyLocale = "zh" | "en";
+
+export type TarotQuestionType =
+  | "general"
+  | "love"
+  | "career"
+  | "money"
+  | "decision"
+  | "self";
+
+export type TarotPosition = "past" | "present" | "future";
+export type TarotOrientation = "upright" | "reversed";
+type TarotSuit = "wands" | "cups" | "swords" | "pentacles";
+type MinorRank =
+  | "ace"
+  | "two"
+  | "three"
+  | "four"
+  | "five"
+  | "six"
+  | "seven"
+  | "eight"
+  | "nine"
+  | "ten"
+  | "page"
+  | "knight"
+  | "queen"
+  | "king";
+
+export type TarotCardDraw = {
+  id: string;
+  position: TarotPosition;
+  orientation: TarotOrientation;
+  name: string;
+  visibleImagery: string;
+  meaning: string;
+  theme: string;
+  keywords: string[];
+  positionLens: string;
+  questionConnection: string;
+  advice: string;
+  imageSrc: string;
+};
+
+export type TarotReading = {
+  question: string;
+  questionType: TarotQuestionType;
+  cards: TarotCardDraw[];
+  overallStory: string;
+  adjustment: string;
+};
+
+type LocalizedCard = {
+  name: string;
+  theme: string;
+  upright: string;
+  reversed: string;
+  advice: string;
+  keywords: string[];
+};
+
+type TarotCard = {
+  id: string;
+  zh: LocalizedCard;
+  en: LocalizedCard;
+};
+
+const majorImageById: Record<string, string> = {
+  fool: "maj00.jpg",
+  magician: "maj01.jpg",
+  "high-priestess": "maj02.jpg",
+  empress: "maj03.jpg",
+  emperor: "maj04.jpg",
+  hierophant: "maj05.jpg",
+  lovers: "maj06.jpg",
+  chariot: "maj07.jpg",
+  strength: "maj08.jpg",
+  hermit: "maj09.jpg",
+  "wheel-of-fortune": "maj10.jpg",
+  justice: "maj11.jpg",
+  "hanged-man": "maj12.jpg",
+  death: "maj13.jpg",
+  temperance: "maj14.jpg",
+  devil: "maj15.jpg",
+  tower: "maj16.jpg",
+  star: "maj17.jpg",
+  moon: "maj18.jpg",
+  sun: "maj19.jpg",
+  judgement: "maj20.jpg",
+  world: "maj21.jpg",
+};
+
+const rankImageNumber: Record<MinorRank, string> = {
+  ace: "01",
+  two: "02",
+  three: "03",
+  four: "04",
+  five: "05",
+  six: "06",
+  seven: "07",
+  eight: "08",
+  nine: "09",
+  ten: "10",
+  page: "11",
+  knight: "12",
+  queen: "13",
+  king: "14",
+};
+
+const suitImagePrefix: Record<TarotSuit, string> = {
+  wands: "wands",
+  cups: "cups",
+  swords: "swords",
+  pentacles: "pents",
+};
+
+const suitCopy: Record<
+  TarotSuit,
+  {
+    zhName: string;
+    enName: string;
+    zhDomain: string;
+    enDomain: string;
+    zhKeywords: string[];
+    enKeywords: string[];
+  }
+> = {
+  wands: {
+    zhName: "权杖",
+    enName: "Wands",
+    zhDomain: "行动、热情、创造力和推进速度",
+    enDomain: "action, heat, creativity, and momentum",
+    zhKeywords: ["行动", "热情", "创造"],
+    enKeywords: ["action", "spark", "creation"],
+  },
+  cups: {
+    zhName: "圣杯",
+    enName: "Cups",
+    zhDomain: "情绪、关系、亲密感和内在回应",
+    enDomain: "emotion, relationship, intimacy, and inner response",
+    zhKeywords: ["情绪", "关系", "感受"],
+    enKeywords: ["emotion", "relationship", "feeling"],
+  },
+  swords: {
+    zhName: "宝剑",
+    enName: "Swords",
+    zhDomain: "想法、沟通、判断和冲突处理",
+    enDomain: "thought, communication, judgment, and conflict style",
+    zhKeywords: ["思考", "沟通", "判断"],
+    enKeywords: ["thought", "words", "clarity"],
+  },
+  pentacles: {
+    zhName: "星币",
+    enName: "Pentacles",
+    zhDomain: "资源、金钱、身体、时间和现实执行",
+    enDomain: "resources, money, body, time, and practical execution",
+    zhKeywords: ["资源", "现实", "执行"],
+    enKeywords: ["resources", "practice", "stability"],
+  },
+};
+
+const rankCopy: Record<
+  MinorRank,
+  {
+    zhName: string;
+    enName: string;
+    zhTheme: string;
+    enTheme: string;
+    zhUpright: string;
+    zhReversed: string;
+    zhAdvice: string;
+    enUpright: string;
+    enReversed: string;
+    enAdvice: string;
+  }
+> = {
+  ace: {
+    zhName: "首牌",
+    enName: "Ace",
+    zhTheme: "新的种子与可启动的机会",
+    enTheme: "A new seed and a usable opening",
+    zhUpright: "一个新的入口正在出现，先把它当成可验证的小起点。",
+    zhReversed: "机会还没真正落地，可能需要先补足动机、资源或时机。",
+    zhAdvice: "把灵感变成一个小动作，先确认它是否能产生真实反馈。",
+    enUpright: "A new opening is appearing; treat it as a small testable beginning.",
+    enReversed: "The opening may not be grounded yet; motivation, resources, or timing need attention first.",
+    enAdvice: "Turn the spark into one small action and see whether it creates real feedback.",
+  },
+  two: {
+    zhName: "二",
+    enName: "Two",
+    zhTheme: "选择、平衡与初步规划",
+    enTheme: "Choice, balance, and early planning",
+    zhUpright: "你正在比较两种力量或路径，清楚标准比急着选更重要。",
+    zhReversed: "犹豫可能来自信息不完整，或你还没有承认真正的优先级。",
+    zhAdvice: "写下不可妥协的标准，再看哪个选项更能承担后果。",
+    enUpright: "You are comparing two forces or paths; the standard matters more than rushing the choice.",
+    enReversed: "Hesitation may come from missing information or an unacknowledged priority.",
+    enAdvice: "Name the non-negotiable standard, then choose the option whose consequences you can own.",
+  },
+  three: {
+    zhName: "三",
+    enName: "Three",
+    zhTheme: "扩展、协作与看见下一步",
+    enTheme: "Expansion, collaboration, and the next horizon",
+    zhUpright: "事情开始向外展开，你需要看见更大的格局和可协作的人。",
+    zhReversed: "扩张还不稳，可能是合作节奏或期待没有对齐。",
+    zhAdvice: "先对齐目标、角色和边界，再扩大行动范围。",
+    enUpright: "The matter is starting to expand; look for the wider map and useful collaborators.",
+    enReversed: "Expansion is not steady yet; collaboration rhythm or expectations may be misaligned.",
+    enAdvice: "Align goals, roles, and boundaries before widening the effort.",
+  },
+  four: {
+    zhName: "四",
+    enName: "Four",
+    zhTheme: "稳定、休整与阶段性安全感",
+    enTheme: "Stability, pause, and temporary security",
+    zhUpright: "一个阶段需要稳定下来，先让已有成果站稳。",
+    zhReversed: "稳定可能变成停滞，或你还没有真正允许自己休整。",
+    zhAdvice: "保留能支撑你的结构，同时检查哪里需要重新流动。",
+    enUpright: "A phase needs to stabilize; let the current gains stand on firmer ground.",
+    enReversed: "Stability may be turning into stagnation, or you may not be allowing rest.",
+    enAdvice: "Keep the structures that support you while checking where movement needs to return.",
+  },
+  five: {
+    zhName: "五",
+    enName: "Five",
+    zhTheme: "摩擦、失衡与必要调整",
+    enTheme: "Friction, imbalance, and needed adjustment",
+    zhUpright: "冲突或失衡已经显现，它提醒你不能继续照旧推进。",
+    zhReversed: "你可能正在从摩擦中恢复，也可能在避免一次必要对话。",
+    zhAdvice: "先处理最具体的矛盾，不要把所有不安混成一团。",
+    enUpright: "Friction or imbalance is visible; continuing as usual may not work.",
+    enReversed: "You may be recovering from friction or avoiding a necessary conversation.",
+    enAdvice: "Deal with the most specific tension first instead of blending all unease together.",
+  },
+  six: {
+    zhName: "六",
+    enName: "Six",
+    zhTheme: "回应、修复与阶段性认可",
+    enTheme: "Response, repair, and partial recognition",
+    zhUpright: "你开始得到回应或看见回报，但仍要分辨它是否可持续。",
+    zhReversed: "认可或修复来得不完整，可能需要降低对外界反馈的依赖。",
+    zhAdvice: "接住好的反馈，同时把标准放回自己能掌控的行动上。",
+    enUpright: "A response or reward is arriving, but check whether it is sustainable.",
+    enReversed: "Recognition or repair may be incomplete; reduce dependence on outside validation.",
+    enAdvice: "Receive useful feedback while returning the standard to actions you control.",
+  },
+  seven: {
+    zhName: "七",
+    enName: "Seven",
+    zhTheme: "防守、评估与坚持位置",
+    enTheme: "Defense, assessment, and holding position",
+    zhUpright: "你需要守住一个位置，同时判断哪些压力值得回应。",
+    zhReversed: "过度防御或缺少底气，可能让你把所有声音都当成威胁。",
+    zhAdvice: "区分真正的风险和只是让你紧张的噪音。",
+    enUpright: "You need to hold a position while deciding which pressures deserve response.",
+    enReversed: "Over-defense or low confidence may make every voice feel like a threat.",
+    enAdvice: "Separate real risk from noise that only makes you tense.",
+  },
+  eight: {
+    zhName: "八",
+    enName: "Eight",
+    zhTheme: "速度、重复练习与推进中的秩序",
+    enTheme: "Speed, repetition, and order in motion",
+    zhUpright: "事情在加速，关键是保持节奏和清晰沟通。",
+    zhReversed: "速度可能被延迟、卡顿或重复错误拖住。",
+    zhAdvice: "减少同时推进的事项，让最重要的一条线先跑通。",
+    enUpright: "The matter is accelerating; cadence and clear communication matter now.",
+    enReversed: "Delay, friction, or repeated mistakes may be slowing the momentum.",
+    enAdvice: "Reduce parallel efforts and let the most important line run cleanly first.",
+  },
+  nine: {
+    zhName: "九",
+    enName: "Nine",
+    zhTheme: "积累、边界与接近完成前的韧性",
+    enTheme: "Accumulation, boundaries, and resilience near completion",
+    zhUpright: "你已经走了很远，接下来要保护能量和关键成果。",
+    zhReversed: "疲惫感可能让你低估自己，也提醒你不要硬撑到底。",
+    zhAdvice: "保留必要边界，给恢复留位置，别把韧性误当成无限消耗。",
+    enUpright: "You have come far; protect your energy and the important gains.",
+    enReversed: "Fatigue may make you underestimate yourself and warns against pushing past capacity.",
+    enAdvice: "Keep necessary boundaries and make room for recovery; resilience is not endless depletion.",
+  },
+  ten: {
+    zhName: "十",
+    enName: "Ten",
+    zhTheme: "完成、负荷与收束方式",
+    enTheme: "Completion, burden, and how to close",
+    zhUpright: "这件事接近一个结果，但伴随责任、负荷或收尾压力。",
+    zhReversed: "你可能在卸下过重负担，或需要承认某种方式已经到头。",
+    zhAdvice: "列出必须完成、可以委托、应该停止的三类事项。",
+    enUpright: "This is nearing an outcome, with responsibility, load, or closing pressure attached.",
+    enReversed: "You may be releasing excess burden or admitting that a method has run its course.",
+    enAdvice: "List what must be finished, delegated, and stopped.",
+  },
+  page: {
+    zhName: "侍从",
+    enName: "Page",
+    zhTheme: "学习、试探与新信息",
+    enTheme: "Learning, experimentation, and new information",
+    zhUpright: "以学习者姿态进入，会比立刻证明自己更有效。",
+    zhReversed: "经验不足或消息混乱，可能让判断过早成形。",
+    zhAdvice: "先提问、观察和记录，再做最终判断。",
+    enUpright: "Entering as a learner may work better than trying to prove yourself immediately.",
+    enReversed: "Inexperience or messy information may be forming a judgment too early.",
+    enAdvice: "Ask, observe, and document before making the final call.",
+  },
+  knight: {
+    zhName: "骑士",
+    enName: "Knight",
+    zhTheme: "推进、冲劲与行动风格",
+    enTheme: "Momentum, drive, and action style",
+    zhUpright: "行动力正在增强，但要注意速度是否服务于目标。",
+    zhReversed: "冲动、摇摆或方向不稳，可能让力量用错地方。",
+    zhAdvice: "在行动前确认目标、节奏和停止条件。",
+    enUpright: "Drive is increasing, but speed needs to serve the goal.",
+    enReversed: "Impulse, inconsistency, or unstable direction may send energy to the wrong place.",
+    enAdvice: "Before acting, confirm the goal, cadence, and stop condition.",
+  },
+  queen: {
+    zhName: "王后",
+    enName: "Queen",
+    zhTheme: "成熟承载、感受力与内在掌控",
+    enTheme: "Mature holding, receptivity, and inner command",
+    zhUpright: "你可以用更成熟的方式承载这件事，而不是被它推着走。",
+    zhReversed: "过度吸收他人情绪或忽略自己需求，会削弱你的稳定感。",
+    zhAdvice: "先确认自己的状态，再决定能给出多少回应。",
+    enUpright: "You can hold this matter with more maturity instead of being pushed around by it.",
+    enReversed: "Absorbing too much from others or ignoring your needs may weaken stability.",
+    enAdvice: "Check your own state before deciding how much response you can give.",
+  },
+  king: {
+    zhName: "国王",
+    enName: "King",
+    zhTheme: "领导、边界与稳定掌控",
+    enTheme: "Leadership, boundaries, and steady command",
+    zhUpright: "现在需要更清楚的主导、标准和长期视角。",
+    zhReversed: "掌控可能变成僵硬，或你在逃避承担该承担的责任。",
+    zhAdvice: "把规则说清楚，并用稳定行动证明它不是一时情绪。",
+    enUpright: "Clearer leadership, standards, and long-range perspective are needed now.",
+    enReversed: "Control may be turning rigid, or you may be avoiding responsibility.",
+    enAdvice: "State the rule clearly and prove through steady action that it is not a passing mood.",
+  },
+};
+
+const majorArcana: TarotCard[] = [
+  {
+    id: "fool",
+    zh: {
+      name: "愚者",
+      theme: "新的开始与试探性的勇气",
+      upright: "你正在靠近一个新阶段，真正重要的是先迈出可控的一步。",
+      reversed: "冲动或准备不足正在放大不确定性，先把最低风险的尝试设计出来。",
+      advice: "把目标拆成一次小实验，不要一开始就要求答案完美。",
+      keywords: ["开始", "冒险", "轻装上阵"],
+    },
+    en: {
+      name: "The Fool",
+      theme: "A fresh start and experimental courage",
+      upright: "You are near a new phase, and the useful move is a small, controlled first step.",
+      reversed: "Impulse or under-preparation may be raising uncertainty; design the lowest-risk trial first.",
+      advice: "Turn the goal into one small experiment instead of demanding a perfect answer.",
+      keywords: ["start", "risk", "openness"],
+    },
+  },
+  {
+    id: "magician",
+    zh: {
+      name: "魔术师",
+      theme: "资源整合与主动创造",
+      upright: "你手里已经有可用资源，关键是把它们组织成一个清楚的行动。",
+      reversed: "想法很多但力量分散，先排除会消耗注意力的选项。",
+      advice: "列出你已经拥有的时间、信息、人脉或工具，并选一个最能产生反馈的动作。",
+      keywords: ["资源", "表达", "执行"],
+    },
+    en: {
+      name: "The Magician",
+      theme: "Resourcefulness and intentional action",
+      upright: "You already have usable resources; the key is arranging them into a clear action.",
+      reversed: "There may be many ideas but scattered focus, so remove the options that drain attention.",
+      advice: "List the time, information, people, or tools you already have and choose the action most likely to create feedback.",
+      keywords: ["resources", "craft", "agency"],
+    },
+  },
+  {
+    id: "high-priestess",
+    zh: {
+      name: "女祭司",
+      theme: "直觉、沉默信息与内在判断",
+      upright: "有些答案还没有浮到表面，先听见自己真正犹豫的原因。",
+      reversed: "你可能忽略了直觉里的警讯，或被外界声音盖过了自己的判断。",
+      advice: "暂缓马上定论，写下你已经知道但还没有承认的信息。",
+      keywords: ["直觉", "隐藏信息", "观察"],
+    },
+    en: {
+      name: "The High Priestess",
+      theme: "Intuition, hidden information, and inner knowing",
+      upright: "Some answers have not surfaced yet; listen for the real reason behind your hesitation.",
+      reversed: "You may be ignoring a quiet warning or letting outside noise drown out your own judgment.",
+      advice: "Pause the final call and write down what you already know but have not admitted.",
+      keywords: ["intuition", "silence", "signals"],
+    },
+  },
+  {
+    id: "empress",
+    zh: {
+      name: "皇后",
+      theme: "滋养、关系与自然生长",
+      upright: "这件事需要被好好照料，而不是被催促着立刻结果。",
+      reversed: "过度付出或缺少边界可能让你很快耗尽。",
+      advice: "检查哪些部分需要时间、支持和恢复，也检查你是否给得太多。",
+      keywords: ["滋养", "丰盛", "边界"],
+    },
+    en: {
+      name: "The Empress",
+      theme: "Nurture, relationship, and organic growth",
+      upright: "This matter needs care rather than pressure for an immediate result.",
+      reversed: "Over-giving or weak boundaries may drain you quickly.",
+      advice: "Notice what needs time, support, and recovery, and where you may be giving too much.",
+      keywords: ["nurture", "growth", "boundaries"],
+    },
+  },
+  {
+    id: "emperor",
+    zh: {
+      name: "皇帝",
+      theme: "结构、责任与稳定边界",
+      upright: "现在需要清楚规则和稳定节奏，靠感觉推进会不够。",
+      reversed: "控制欲、僵化或逃避责任都可能让问题卡住。",
+      advice: "把责任、截止时间和可执行标准写清楚。",
+      keywords: ["结构", "责任", "秩序"],
+    },
+    en: {
+      name: "The Emperor",
+      theme: "Structure, responsibility, and stable boundaries",
+      upright: "Clear rules and a steady cadence matter now; feeling your way through may not be enough.",
+      reversed: "Control, rigidity, or avoided responsibility may be keeping things stuck.",
+      advice: "Make the owner, deadline, and standard of done explicit.",
+      keywords: ["structure", "authority", "standards"],
+    },
+  },
+  {
+    id: "hierophant",
+    zh: {
+      name: "教皇",
+      theme: "传统、学习与可信框架",
+      upright: "借助成熟方法或可信前辈，会比完全自创更稳。",
+      reversed: "旧规则可能不再适用，你需要判断哪些规范只是惯性。",
+      advice: "先找一个可靠框架，再决定哪里需要调整成适合你的版本。",
+      keywords: ["学习", "规则", "传承"],
+    },
+    en: {
+      name: "The Hierophant",
+      theme: "Tradition, learning, and trusted frameworks",
+      upright: "A proven method or trusted mentor may be steadier than inventing everything alone.",
+      reversed: "An old rule may no longer fit; decide which norms are only habit.",
+      advice: "Start with a reliable framework, then adapt the parts that need to fit your situation.",
+      keywords: ["learning", "systems", "guidance"],
+    },
+  },
+  {
+    id: "lovers",
+    zh: {
+      name: "恋人",
+      theme: "选择、价值一致与关系协商",
+      upright: "真正的重点是价值是否一致，而不只是眼前是否吸引。",
+      reversed: "摇摆、误解或回避选择会削弱信任。",
+      advice: "把你在意的标准说出来，观察对方或环境是否能回应。",
+      keywords: ["选择", "关系", "一致"],
+    },
+    en: {
+      name: "The Lovers",
+      theme: "Choice, alignment, and relational honesty",
+      upright: "The real question is value alignment, not only immediate attraction.",
+      reversed: "Ambivalence, misunderstanding, or avoided choice may weaken trust.",
+      advice: "Name the standard that matters to you and see whether the other side can meet it.",
+      keywords: ["choice", "alignment", "relationship"],
+    },
+  },
+  {
+    id: "chariot",
+    zh: {
+      name: "战车",
+      theme: "方向感、意志与推进",
+      upright: "只要方向统一，你有机会把局面往前推。",
+      reversed: "力量在互相拉扯，越急越容易偏航。",
+      advice: "先定一个主目标，再把冲突目标放到次要位置。",
+      keywords: ["推进", "目标", "掌控"],
+    },
+    en: {
+      name: "The Chariot",
+      theme: "Direction, willpower, and momentum",
+      upright: "Once the direction is unified, you can move the situation forward.",
+      reversed: "Competing forces may be pulling you off course; rushing could worsen it.",
+      advice: "Pick one primary goal and move the conflicting goals into a secondary lane.",
+      keywords: ["drive", "focus", "momentum"],
+    },
+  },
+  {
+    id: "strength",
+    zh: {
+      name: "力量",
+      theme: "温柔的掌控与耐心勇气",
+      upright: "真正有力量的做法不是压制，而是稳定地安抚和引导。",
+      reversed: "自我怀疑或情绪过载可能让你低估自己的承受力。",
+      advice: "用温和但坚定的方式处理冲突，先稳住节奏。",
+      keywords: ["耐心", "勇气", "自控"],
+    },
+    en: {
+      name: "Strength",
+      theme: "Gentle control and patient courage",
+      upright: "The strong move is not force; it is steady, calm guidance.",
+      reversed: "Self-doubt or emotional overload may be making you underestimate your capacity.",
+      advice: "Handle conflict with gentle firmness and stabilize the rhythm first.",
+      keywords: ["patience", "courage", "self-control"],
+    },
+  },
+  {
+    id: "hermit",
+    zh: {
+      name: "隐士",
+      theme: "独处、辨认真相与慢下来",
+      upright: "你需要一点距离，才能看清自己真正要的是什么。",
+      reversed: "过度封闭可能让你错过必要的反馈。",
+      advice: "给自己安静时间，同时保留一个可信的外部反馈点。",
+      keywords: ["独处", "洞察", "回望"],
+    },
+    en: {
+      name: "The Hermit",
+      theme: "Solitude, truth-seeking, and slowing down",
+      upright: "A little distance can help you see what you truly want.",
+      reversed: "Too much isolation may cut you off from useful feedback.",
+      advice: "Give yourself quiet time while keeping one trusted outside feedback point.",
+      keywords: ["solitude", "insight", "reflection"],
+    },
+  },
+  {
+    id: "wheel-of-fortune",
+    zh: {
+      name: "命运之轮",
+      theme: "周期变化与时机",
+      upright: "局面正在转动，抓住变化中的可行动窗口。",
+      reversed: "你可能在和周期对抗，或重复同一种模式。",
+      advice: "观察趋势而不是只看单次结果，顺势调整动作。",
+      keywords: ["变化", "时机", "周期"],
+    },
+    en: {
+      name: "Wheel of Fortune",
+      theme: "Cycles, change, and timing",
+      upright: "The situation is moving; look for the actionable window inside the change.",
+      reversed: "You may be resisting a cycle or repeating the same pattern.",
+      advice: "Watch the trend instead of one isolated outcome, then adapt with the cycle.",
+      keywords: ["change", "timing", "pattern"],
+    },
+  },
+  {
+    id: "justice",
+    zh: {
+      name: "正义",
+      theme: "事实、平衡与后果",
+      upright: "事实和责任需要被摆到台面上，情绪不能替代证据。",
+      reversed: "判断可能受到偏见、信息不完整或不公平交换的影响。",
+      advice: "先核对事实、承诺和代价，再做决定。",
+      keywords: ["事实", "公平", "后果"],
+    },
+    en: {
+      name: "Justice",
+      theme: "Facts, balance, and consequences",
+      upright: "Facts and responsibility need to be visible; emotion cannot replace evidence.",
+      reversed: "Bias, incomplete information, or an unfair exchange may be shaping the judgment.",
+      advice: "Check the facts, commitments, and costs before deciding.",
+      keywords: ["facts", "fairness", "accountability"],
+    },
+  },
+  {
+    id: "hanged-man",
+    zh: {
+      name: "倒吊人",
+      theme: "暂停、换角度与放下控制",
+      upright: "主动暂停会带来新的视角，不是所有进展都靠硬推。",
+      reversed: "拖延和真正的等待混在一起，容易让你失去主动权。",
+      advice: "问自己：现在停下来是在换角度，还是在逃避下一步？",
+      keywords: ["暂停", "视角", "放下"],
+    },
+    en: {
+      name: "The Hanged Man",
+      theme: "Pause, perspective, and release",
+      upright: "A deliberate pause can bring a new angle; not all progress comes from pushing.",
+      reversed: "Delay and wise waiting may be mixed together, costing you agency.",
+      advice: "Ask whether the pause is giving perspective or avoiding the next step.",
+      keywords: ["pause", "perspective", "release"],
+    },
+  },
+  {
+    id: "death",
+    zh: {
+      name: "死神",
+      theme: "结束旧模式与转化",
+      upright: "一个旧阶段正在收束，放下不再有效的方式会腾出空间。",
+      reversed: "你可能知道该结束什么，却还在用惯性拖住自己。",
+      advice: "明确哪一件事应该停止、简化或换一种做法。",
+      keywords: ["结束", "转化", "更新"],
+    },
+    en: {
+      name: "Death",
+      theme: "Ending an old pattern and transforming",
+      upright: "An old phase is closing; releasing what no longer works creates room.",
+      reversed: "You may know what needs to end while habit keeps you attached.",
+      advice: "Name one thing to stop, simplify, or redesign.",
+      keywords: ["ending", "transition", "renewal"],
+    },
+  },
+  {
+    id: "temperance",
+    zh: {
+      name: "节制",
+      theme: "调和、节奏与长期平衡",
+      upright: "这件事需要比例感，过快或过满都会破坏平衡。",
+      reversed: "节奏失衡，可能是同时追求太多目标。",
+      advice: "把强度调低，把节奏调稳，让关系或计划有恢复空间。",
+      keywords: ["调和", "节奏", "平衡"],
+    },
+    en: {
+      name: "Temperance",
+      theme: "Integration, pacing, and long-term balance",
+      upright: "This needs proportion; too fast or too much may break the balance.",
+      reversed: "The rhythm is off, perhaps because too many goals are being pursued at once.",
+      advice: "Lower the intensity, steady the pace, and leave room for recovery.",
+      keywords: ["balance", "pacing", "integration"],
+    },
+  },
+  {
+    id: "devil",
+    zh: {
+      name: "恶魔",
+      theme: "执念、诱惑与看见束缚",
+      upright: "某种依赖、执念或短期诱惑正在影响你的自由度。",
+      reversed: "你开始看见束缚，也有机会把选择权拿回来。",
+      advice: "找出让你说“我没办法”的那条链子，并做一个小的解绑动作。",
+      keywords: ["执念", "依赖", "解绑"],
+    },
+    en: {
+      name: "The Devil",
+      theme: "Attachment, temptation, and seeing the chain",
+      upright: "A dependency, fixation, or short-term temptation may be reducing your freedom.",
+      reversed: "You are beginning to see the constraint and can reclaim choice.",
+      advice: "Find the chain behind the phrase 'I have no choice' and make one small freeing move.",
+      keywords: ["attachment", "constraint", "choice"],
+    },
+  },
+  {
+    id: "tower",
+    zh: {
+      name: "高塔",
+      theme: "旧结构松动与必要的清醒",
+      upright: "某个不稳的结构可能被现实戳破，这会难受，但也让真相更清楚。",
+      reversed: "你可能已经感觉到问题，却还在避免面对。",
+      advice: "先处理最明显的裂缝，不要等它变成更大的崩塌。",
+      keywords: ["清醒", "破局", "重建"],
+    },
+    en: {
+      name: "The Tower",
+      theme: "A shaky structure and necessary clarity",
+      upright: "A weak structure may be exposed by reality; uncomfortable, but clarifying.",
+      reversed: "You may already sense the issue while trying not to face it.",
+      advice: "Address the clearest crack before it becomes a larger collapse.",
+      keywords: ["clarity", "disruption", "rebuild"],
+    },
+  },
+  {
+    id: "star",
+    zh: {
+      name: "星星",
+      theme: "希望、修复与长线信念",
+      upright: "希望不是空想，而是你愿意慢慢修复的方向。",
+      reversed: "失望让视野变窄，先恢复能量再判断未来。",
+      advice: "给自己一个温和但持续的恢复计划。",
+      keywords: ["希望", "修复", "愿景"],
+    },
+    en: {
+      name: "The Star",
+      theme: "Hope, healing, and long-range faith",
+      upright: "Hope is not fantasy; it is the direction you are willing to repair toward.",
+      reversed: "Disappointment may be narrowing your view; restore energy before judging the future.",
+      advice: "Give yourself a gentle but consistent recovery plan.",
+      keywords: ["hope", "healing", "vision"],
+    },
+  },
+  {
+    id: "moon",
+    zh: {
+      name: "月亮",
+      theme: "迷雾、情绪投射与不确定",
+      upright: "信息还不够清楚，情绪和想象可能正在填补空白。",
+      reversed: "迷雾开始散开，但仍需要验证而不是猜测。",
+      advice: "把事实、猜测和恐惧分成三列，再看下一步。",
+      keywords: ["不确定", "梦境", "投射"],
+    },
+    en: {
+      name: "The Moon",
+      theme: "Fog, brandion, and uncertainty",
+      upright: "The information is not clear yet; emotion and imagination may be filling the gaps.",
+      reversed: "The fog is thinning, but verification still matters more than guessing.",
+      advice: "Separate facts, assumptions, and fears into three columns before the next move.",
+      keywords: ["uncertainty", "brandion", "intuition"],
+    },
+  },
+  {
+    id: "sun",
+    zh: {
+      name: "太阳",
+      theme: "清晰、生命力与公开表达",
+      upright: "事情有机会变得更明朗，也更适合坦诚表达。",
+      reversed: "快乐或信心被压住了，可能需要先处理疲惫或自我否定。",
+      advice: "选择一个能让事情更透明、更简单的动作。",
+      keywords: ["清晰", "自信", "表达"],
+    },
+    en: {
+      name: "The Sun",
+      theme: "Clarity, vitality, and open expression",
+      upright: "The matter can become clearer and more open to honest expression.",
+      reversed: "Joy or confidence may be muted by fatigue or self-doubt.",
+      advice: "Choose one action that makes the situation more transparent and simple.",
+      keywords: ["clarity", "confidence", "warmth"],
+    },
+  },
+  {
+    id: "judgement",
+    zh: {
+      name: "审判",
+      theme: "复盘、召唤与重新选择",
+      upright: "过去的经验正在召唤你做一次更成熟的选择。",
+      reversed: "自责或逃避复盘会让旧问题重复出现。",
+      advice: "把这件事当作一次复盘：学到什么，下一次怎么不同？",
+      keywords: ["复盘", "觉醒", "选择"],
+    },
+    en: {
+      name: "Judgement",
+      theme: "Review, calling, and choosing again",
+      upright: "Past experience is asking you to make a more mature choice.",
+      reversed: "Self-blame or avoiding review may cause the old issue to repeat.",
+      advice: "Treat this as a review: what did you learn, and what changes next time?",
+      keywords: ["review", "calling", "renewal"],
+    },
+  },
+  {
+    id: "world",
+    zh: {
+      name: "世界",
+      theme: "完成、整合与进入下一圈",
+      upright: "一个阶段接近整合，你可以把经验整理成新的起点。",
+      reversed: "事情还差一个收尾动作，未完成感让你难以进入下一步。",
+      advice: "定义什么算完成，然后做那个最后的收束动作。",
+      keywords: ["完成", "整合", "循环"],
+    },
+    en: {
+      name: "The World",
+      theme: "Completion, integration, and the next cycle",
+      upright: "A phase is nearing integration; turn the experience into a new starting point.",
+      reversed: "One closing action may be missing, leaving you unable to move on.",
+      advice: "Define what 'complete' means and do the final closing action.",
+      keywords: ["completion", "integration", "cycle"],
+    },
+  },
+];
+
+const minorRanks: MinorRank[] = [
+  "ace",
+  "two",
+  "three",
+  "four",
+  "five",
+  "six",
+  "seven",
+  "eight",
+  "nine",
+  "ten",
+  "page",
+  "knight",
+  "queen",
+  "king",
+];
+const minorSuits: TarotSuit[] = ["wands", "cups", "swords", "pentacles"];
+
+const minorArcana: TarotCard[] = minorSuits.flatMap((suit) =>
+  minorRanks.map((rank) => {
+    const suitInfo = suitCopy[suit];
+    const rankInfo = rankCopy[rank];
+
+    return {
+      id: `${suit}-${rank}`,
+      zh: {
+        name: `${suitInfo.zhName}${rankInfo.zhName}`,
+        theme: `${rankInfo.zhTheme}：${suitInfo.zhDomain}`,
+        upright: `${rankInfo.zhUpright} 在${suitInfo.zhDomain}这条线上，它更像是可以被你使用的能量。`,
+        reversed: `${rankInfo.zhReversed} 在${suitInfo.zhDomain}这条线上，它提醒你先修正节奏或边界。`,
+        advice: rankInfo.zhAdvice,
+        keywords: [...suitInfo.zhKeywords, rankInfo.zhTheme.split("、")[0]],
+      },
+      en: {
+        name: `${rankInfo.enName} of ${suitInfo.enName}`,
+        theme: `${rankInfo.enTheme}: ${suitInfo.enDomain}`,
+        upright: `${rankInfo.enUpright} In the field of ${suitInfo.enDomain}, this is energy you can work with.`,
+        reversed: `${rankInfo.enReversed} In the field of ${suitInfo.enDomain}, it asks for a rhythm or boundary correction first.`,
+        advice: rankInfo.enAdvice,
+        keywords: [...suitInfo.enKeywords, rankInfo.enTheme.split(",")[0].toLowerCase()],
+      },
+    };
+  }),
+);
+
+const tarotDeck: TarotCard[] = [...majorArcana, ...minorArcana];
+
+export function getTarotCardImageSrc(cardId: string): string {
+  const majorFile = majorImageById[cardId];
+  if (majorFile) return `/brand/tarot-waite/${majorFile}`;
+
+  const [rawSuit, rawRank] = cardId.split("-");
+  if (rawSuit && rawRank && rawSuit in suitImagePrefix && rawRank in rankImageNumber) {
+    const suit = rawSuit as TarotSuit;
+    const rank = rawRank as MinorRank;
+    return `/brand/tarot-waite/${suitImagePrefix[suit]}${rankImageNumber[rank]}.jpg`;
+  }
+
+  return "/brand/tomako-tarot-card-back.webp";
+}
+
+const positionCopy: Record<
+  TarotCopyLocale,
+  Record<TarotPosition, { label: string; lens: string }>
+> = {
+  zh: {
+    past: { label: "过去", lens: "这张牌描述了问题的根源、旧习惯或已经形成的条件。" },
+    present: { label: "现在", lens: "这张牌是当前最需要面对的核心，也是整组牌的行动支点。" },
+    future: { label: "未来", lens: "这张牌不是固定未来，而是如果当前模式继续时较可能出现的走向。" },
+  },
+  en: {
+    past: { label: "Past", lens: "This card describes the root, old habit, or condition already shaping the matter." },
+    present: { label: "Present", lens: "This card is the active core of the reading and the main hinge for action." },
+    future: { label: "Future", lens: "This card is not a fixed future; it shows a likely direction if the current pattern continues." },
+  },
+};
+
+const frameAdvice: Record<TarotCopyLocale, Record<TarotQuestionType, string>> = {
+  zh: {
+    general: "把它当作一次自我观察，先处理最清楚的一步。",
+    love: "关系问题里，优先看沟通、边界、互相回应和真实行为。",
+    career: "事业问题里，优先看资源、节奏、职责和可执行动作。",
+    money: "金钱问题里，优先看风险、时间周期、现金流和可验证选择。",
+    decision: "选择题里，先明确标准，再看哪条路更能承担后果。",
+    self: "自我探索里，重点不是马上改变，而是看见模式后做一个小调整。",
+  },
+  en: {
+    general: "Use this as a self-check and work with the clearest next step first.",
+    love: "For relationship questions, look at communication, boundaries, reciprocity, and real behavior.",
+    career: "For career questions, prioritize resources, cadence, responsibility, and executable moves.",
+    money: "For money questions, prioritize risk, time horizon, cash flow, and verifiable choices.",
+    decision: "For decisions, clarify the standard first, then choose the path whose consequences you can own.",
+    self: "For self-reflection, the goal is not instant change; it is seeing the pattern and adjusting one small thing.",
+  },
+};
+
+const positions: TarotPosition[] = ["past", "present", "future"];
+
+function hashString(value: string): number {
+  let hash = 2166136261;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return hash >>> 0;
+}
+
+function mulberry32(seed: number): () => number {
+  return () => {
+    let t = (seed += 0x6d2b79f5);
+    t = Math.imul(t ^ (t >>> 15), t | 1);
+    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+  };
+}
+
+function pickCards(seed: string): Array<{ card: TarotCard; orientation: TarotOrientation }> {
+  const random = mulberry32(hashString(seed));
+  const remaining = [...tarotDeck];
+  return positions.map(() => {
+    const cardIndex = Math.floor(random() * remaining.length);
+    const [card] = remaining.splice(cardIndex, 1);
+    const orientation: TarotOrientation = random() > 0.42 ? "upright" : "reversed";
+    return { card, orientation };
+  });
+}
+
+function resolveCopyLocale(locale: AppLocale): TarotCopyLocale {
+  return locale === "zh" || locale === "zh-tw" ? "zh" : "en";
+}
+
+function buildQuestionConnection({
+  copyLocale,
+  position,
+  questionType,
+  theme,
+}: {
+  copyLocale: TarotCopyLocale;
+  position: TarotPosition;
+  questionType: TarotQuestionType;
+  theme: string;
+}) {
+  const coreTheme = theme.split(/[:：]/, 1)[0];
+  if (copyLocale === "en") {
+    const subject = questionType === "general" ? "the matter you asked about" : `this ${questionType} question`;
+    if (position === "past") return `In the past position, it suggests that ${subject} did not appear overnight. “${coreTheme}” has already been shaping the background, so look for earlier choices or habits that are still affecting the situation.`;
+    if (position === "present") return `In the present position, it places “${coreTheme}” at the active center of ${subject}. This is the stance, resource, or response most able to change the direction now.`;
+    return `In the future position, it shows “${coreTheme}” as a possible trajectory for ${subject} if the current response continues. Treat it as a condition to verify through later behavior and results, not a fixed outcome.`;
+  }
+
+  const subject: Record<TarotQuestionType, string> = {
+    general: "你问的这件事",
+    love: "这次关系问题",
+    career: "这次事业或工作问题",
+    money: "这次金钱问题",
+    decision: "这次选择",
+    self: "这次自我探索",
+  };
+  if (position === "past") return `放在过去位，它说明${subject[questionType]}并非突然形成，“${coreTheme}”已经作为背景条件影响到现在。回看此前哪些具体选择或习惯仍在延续。`;
+  if (position === "present") return `放在现在位，它把${subject[questionType]}的焦点落在“${coreTheme}”上：这是此刻最能改变走向的态度、资源或应对方式，需要结合你正在做的具体事情来核对。`;
+  return `放在未来位，它把“${coreTheme}”呈现为${subject[questionType]}在当前应对方式延续后可能出现的趋势。请用之后的行为、反馈与结果验证它，而不要把它当成固定结局。`;
+}
+
+export function inferTarotQuestionType(question: string): TarotQuestionType {
+  const value = question.trim().toLowerCase();
+  const patterns: Array<[TarotQuestionType, RegExp]> = [
+    ["love", /感情|爱情|恋爱|关系|复合|结婚|婚姻|对象|伴侣|喜欢|暧昧|love|relationship|dating|partner|marriage|crush/],
+    ["career", /事业|工作|职场|升职|跳槽|面试|创业|项目|career|job|work|promotion|interview|business/],
+    ["money", /金钱|财运|收入|投资|财富|赚钱|现金流|money|finance|income|investment|wealth|cash/],
+    ["decision", /选择|决定|要不要|是否|该不该|哪一个|还是|decision|choose|choice|should i|whether/],
+    ["self", /自己|内心|成长|状态|情绪|人生|方向|self|growth|emotion|purpose|healing/],
+  ];
+
+  return patterns.find(([, pattern]) => pattern.test(value))?.[0] ?? "general";
+}
+
+export function createTarotReading({
+  question,
+  questionType,
+  locale,
+  seed,
+}: {
+  question: string;
+  questionType: TarotQuestionType;
+  locale: AppLocale;
+  seed: string;
+}): TarotReading {
+  const copyLocale = resolveCopyLocale(locale);
+  const normalizedQuestion = question.trim();
+  const draws = pickCards(`${normalizedQuestion}|${questionType}|${seed}`);
+  const cards: TarotCardDraw[] = draws.map(({ card, orientation }, index) => {
+    const position = positions[index];
+    const copy = card[copyLocale];
+    const meaning = orientation === "upright" ? copy.upright : copy.reversed;
+    const positionInfo = positionCopy[copyLocale][position];
+
+    return {
+      id: card.id,
+      position,
+      orientation,
+      name: copy.name,
+      visibleImagery: getTarotVisibleImagery(card.id, copyLocale === "zh", copy.theme),
+      meaning,
+      theme: copy.theme,
+      keywords: copy.keywords,
+      imageSrc: getTarotCardImageSrc(card.id),
+      positionLens:
+        copyLocale === "zh"
+          ? `${positionInfo.lens} ${meaning}`
+          : `${positionInfo.lens} ${meaning}`,
+      questionConnection: buildQuestionConnection({
+        copyLocale,
+        position,
+        questionType,
+        theme: copy.theme,
+      }),
+      advice: copy.advice,
+    };
+  });
+
+  const [past, present, future] = cards;
+  const coreTheme = (value: string) => value.split(/[:：]/, 1)[0];
+  const pastTheme = coreTheme(past.theme);
+  const futureTheme = coreTheme(future.theme);
+  const presentImageBeat = present.visibleImagery.split(/[；。]/, 1)[0];
+  const reversedCount = cards.filter((card) => card.orientation === "reversed").length;
+  const majorCount = cards.filter((card) => majorImageById[card.id]).length;
+  const context = frameAdvice[copyLocale][questionType];
+  const paceNote =
+    reversedCount >= 2
+      ? copyLocale === "zh"
+        ? "如果你最近觉得事情有些拧巴，这种感觉并非空穴来风。两张以上逆位更像是在说：先别硬推，眼下需要的是校准、补足，或者停下一个已经不顺的动作。"
+        : "If things have felt tangled lately, that feeling is not coming from nowhere. With two or more reversals, the useful response is to recalibrate, repair, or stop forcing what is no longer moving well."
+      : copyLocale === "zh"
+        ? "好在这里并没有把路堵死。你手边还有可以推动的条件，只是需要更有意识地使用它们。"
+        : "The path is not closed. There are still workable conditions within reach, but they need to be used deliberately."
+  const weightNote =
+    majorCount >= 2
+      ? copyLocale === "zh"
+        ? "而且这里出现了不止一张大牌，我会把它看得更深一点：你问的表面是一件具体的事，背后也碰到了你长期做选择和面对变化的方式。"
+        : "With more than one Major Arcana here, I would read this a little deeper: beneath the immediate question sits a longer-standing way of choosing and responding to change."
+      : "";
+  const overallStory =
+    copyLocale === "zh"
+      ? `把牌摊开后，我第一眼先停在中间的${present.name}${present.orientation === "upright" ? "正位" : "逆位"}。画面里，${presentImageBeat}。这个姿态让我觉得：你问“${normalizedQuestion}”，重点不只在结果本身，也在于你现在正用什么方式面对它。过去的${past.name}${past.orientation === "upright" ? "正位" : "逆位"}像是在交代“${pastTheme}”怎样一路影响到今天；未来的${future.name}${future.orientation === "upright" ? "正位" : "逆位"}则把“${futureTheme}”摆在前方，但没有把结局写死。${paceNote}${weightNote}`
+      : `When I lay these cards together, my eye goes first to ${present.name} ${present.orientation}. For “${normalizedQuestion},” the issue is not only the outcome; it is also the way you are meeting it now. ${past.name} ${past.orientation} shows how “${pastTheme}” has carried into today, while ${future.name} ${future.orientation} places “${futureTheme}” on the horizon without fixing the ending. ${paceNote}${weightNote ? ` ${weightNote}` : ""}`;
+
+  const realityAction: Record<TarotQuestionType, string> = {
+    general: `把“${normalizedQuestion}”拆成一个可以观察的信号：接下来发生什么具体行为、反馈或结果，才算事情真的在变化。`,
+    love: `回到“${normalizedQuestion}”，先记录实际发生的沟通、回应和边界行为；不要只用一时的热度、冷淡或猜测替对方下结论。`,
+    career: `回到“${normalizedQuestion}”，为下一步写清负责人、截止时间和完成标准，再看它是否真正带来职责、资源或结果上的变化。`,
+    money: `回到“${normalizedQuestion}”，先把赚钱拆成四个可核对的数字：新增收入、已确认成交或回款、必要成本，以及你能承受的最大损失。`,
+    decision: `回到“${normalizedQuestion}”，先写下两个不能妥协的标准，再比较每个选项的真实成本、退出条件和你愿意承担的后果。`,
+    self: `回到“${normalizedQuestion}”，选一个最常重复的场景，记录当时的情绪、行为和边界，观察下一次能否做出一个不同的小选择。`,
+  };
+
+  const adjustment =
+    copyLocale === "zh"
+      ? `接下来先别急着把所有问题一次解决。${realityAction[questionType]} 我更建议你先做一件可以验证的小事：${present.advice} 等同一个问题再次出现时，停一下问自己：眼前有没有新的事实，还是我只是在重复消耗？如果没有可见反馈，就把动作缩小，并为它设一个明确的停止条件。${context}`
+      : `Do not try to solve everything at once. Put your attention on one move you can verify: ${present.advice} When the same issue returns, pause and ask whether you are making real progress or repeating the same drain. Watch for observable behavior, feedback, or results connected to “${futureTheme}.” If the pattern leaves you numb or tense, make the action smaller and give it a clear stopping condition. ${context}`;
+
+  return {
+    question: normalizedQuestion,
+    questionType,
+    cards,
+    overallStory,
+    adjustment,
+  };
+}
+
+export function getTarotPositionLabel(locale: AppLocale, position: TarotPosition): string {
+  return positionCopy[resolveCopyLocale(locale)][position].label;
+}