@tomako/tools-runtime 0.1.0

package/src/lib/tools/social-profile-kit.schema.ts

@@ -0,0 +1,328 @@
+import { z } from "zod";
+
+export const socialProfilePlatformSchema = z.enum([
+  "x",
+  "bluesky",
+  "threads",
+  "linkedin",
+  "linkedin-company",
+  "instagram",
+  "tiktok",
+  "youtube",
+  "facebook",
+]);
+
+export const socialProfileModeSchema = z.enum([
+  "personalCreator",
+  "brandCompany",
+]);
+
+export const socialProfileInputModeSchema = z.enum(["form", "prompt"]);
+
+export const socialProfileToneSchema = z.enum([
+  "modern",
+  "friendly",
+  "professional",
+  "bold",
+  "minimal",
+]);
+
+export const socialProfileTargetMarketSchema = z.enum([
+  "china",
+  "northAmerica",
+  "japan",
+  "europe",
+  "global",
+]);
+
+export const socialProfileOutputLanguageSchema = z.enum(["zh", "en", "ja"]);
+
+export const socialProfileThemeSchema = z.enum(["light", "dark"]);
+
+export const socialAvatarSourceSchema = z.enum([
+  "uploaded",
+  "logoGenerator",
+  "placeholder",
+]);
+
+export const socialAssetGenerationModeSchema = z.enum([
+  "userProvided",
+  "logoGenerator",
+  "placeholder",
+  "generate",
+  "crop",
+  "regenerateVariant",
+]);
+
+const socialSafeAreaBoxSchema = z.object({
+  x: z.number(),
+  y: z.number(),
+  width: z.number(),
+  height: z.number(),
+  note: z.string(),
+});
+
+export const socialProfileInputSchema = z.object({
+  mode: socialProfileModeSchema,
+  inputMode: socialProfileInputModeSchema,
+  name: z.string().min(1).max(80),
+  positioning: z.string().min(1).max(180),
+  audience: z.string().min(1).max(120),
+  targetMarket: socialProfileTargetMarketSchema,
+  outputLanguage: socialProfileOutputLanguageSchema,
+  tone: socialProfileToneSchema,
+  prompt: z.string().max(1200).optional(),
+  platforms: z.array(socialProfilePlatformSchema).min(1),
+  theme: socialProfileThemeSchema,
+});
+
+export const socialImageAssetSchema = z.object({
+  kind: z.enum(["placeholder", "uploaded", "generated"]),
+  source: socialAvatarSourceSchema.optional(),
+  generationMode: socialAssetGenerationModeSchema.optional(),
+  isPlaceholderOnly: z.boolean().optional(),
+  src: z.string().optional(),
+  prompt: z.string(),
+  width: z.number(),
+  height: z.number(),
+});
+
+export const socialBannerAssetSchema = z.object({
+  kind: z.enum(["placeholder", "uploaded", "generated", "notApplicable"]),
+  generationMode: socialAssetGenerationModeSchema.optional(),
+  src: z.string().optional(),
+  prompt: z.string().optional(),
+  width: z.number().optional(),
+  height: z.number().optional(),
+  safeArea: z.string().optional(),
+  safeAreaBox: socialSafeAreaBoxSchema.optional(),
+});
+
+const socialProfileVisualStrategySchema = z.object({
+  brandArchetype: z.string(),
+  visualDirection: z.enum([
+    "product-ui-concept",
+    "workflow-scene",
+    "value-metaphor",
+    "brand-atmosphere",
+    "community-editorial",
+    "educational-channel",
+    "founder-portrait-context",
+  ]),
+  logoUsage: z.enum(["reference-only", "subtle-optional", "avoid-in-image"]),
+  textUsage: z.enum(["avoid-generated-text", "short-safe-label-only"]),
+  strategyRationale: z.string(),
+  globalAvoid: z.array(z.string()).default([]),
+  platformStrategies: z.object({
+    x: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    bluesky: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    threads: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    linkedin: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    "linkedin-company": z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    instagram: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    tiktok: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    youtube: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+    facebook: z
+      .object({
+        backgroundStrategy: z.string(),
+        visualConcept: z.string(),
+        composition: z.string(),
+        logoTreatment: z.string(),
+        textTreatment: z.string(),
+        avoid: z.array(z.string()).default([]),
+      })
+      .optional(),
+  }),
+});
+
+export const socialPlatformProfileSchema = z.object({
+  platform: socialProfilePlatformSchema,
+  displayName: z.string(),
+  username: z.string(),
+  bio: z.string(),
+  headline: z.string().optional(),
+  description: z.string().optional(),
+  website: z.string().optional(),
+  avatar: socialImageAssetSchema,
+  banner: socialBannerAssetSchema.optional(),
+  colors: z.array(z.string()).min(3).max(6),
+});
+
+export const socialProfileKitOutputSchema = z.object({
+  id: z.string(),
+  generatedAt: z.string(),
+  input: socialProfileInputSchema,
+  profiles: z.object({
+    x: socialPlatformProfileSchema,
+    bluesky: socialPlatformProfileSchema,
+    threads: socialPlatformProfileSchema,
+    linkedin: socialPlatformProfileSchema,
+    "linkedin-company": socialPlatformProfileSchema,
+    instagram: socialPlatformProfileSchema,
+    tiktok: socialPlatformProfileSchema,
+    youtube: socialPlatformProfileSchema,
+    facebook: socialPlatformProfileSchema,
+  }),
+  visualStrategy: socialProfileVisualStrategySchema.optional(),
+});
+
+export const socialProfileKitAgentResultSchema = z.object({
+  promptId: z.string(),
+  promptVersion: z.string(),
+  summary: z.string(),
+  strategy: z.object({
+    positioning: z.string(),
+    audience: z.string(),
+    tone: z.string(),
+    visualDirection: z.string(),
+    reusePlan: z.string(),
+  }),
+  kit: socialProfileKitOutputSchema,
+  assetPlan: z.array(
+    z.object({
+      id: z.string(),
+      label: z.string(),
+      assetKind: z.enum(["avatar", "banner"]).optional(),
+      generationMode: socialAssetGenerationModeSchema.optional(),
+      requiredForV1: z.boolean().optional(),
+      master: z.object({
+        width: z.number(),
+        height: z.number(),
+        note: z.string(),
+        safeAreaBox: socialSafeAreaBoxSchema.optional(),
+      }),
+      platforms: z.array(socialProfilePlatformSchema),
+      outputs: z
+        .array(
+          z.object({
+            platform: socialProfilePlatformSchema,
+            kind: z.enum(["avatar", "banner"]),
+            width: z.number(),
+            height: z.number(),
+            generationMode: socialAssetGenerationModeSchema.optional(),
+            cropFrom: z.string().optional(),
+            safeAreaBox: socialSafeAreaBoxSchema.optional(),
+          }),
+        )
+        .optional(),
+    }),
+  ),
+  qualityChecks: z.array(z.string()),
+  limitations: z.array(z.string()),
+  generatedAt: z.string(),
+});
+
+export type SocialProfilePlatform = z.infer<
+  typeof socialProfilePlatformSchema
+>;
+export type SocialProfileMode = z.infer<typeof socialProfileModeSchema>;
+export type SocialProfileInputMode = z.infer<
+  typeof socialProfileInputModeSchema
+>;
+export type SocialProfileTone = z.infer<typeof socialProfileToneSchema>;
+export type SocialProfileTargetMarket = z.infer<
+  typeof socialProfileTargetMarketSchema
+>;
+export type SocialProfileOutputLanguage = z.infer<
+  typeof socialProfileOutputLanguageSchema
+>;
+export type SocialProfileTheme = z.infer<typeof socialProfileThemeSchema>;
+export type SocialAvatarSource = z.infer<typeof socialAvatarSourceSchema>;
+export type SocialAssetGenerationMode = z.infer<
+  typeof socialAssetGenerationModeSchema
+>;
+export type SocialProfileInput = z.infer<typeof socialProfileInputSchema>;
+export type SocialImageAsset = z.infer<typeof socialImageAssetSchema>;
+export type SocialBannerAsset = z.infer<typeof socialBannerAssetSchema>;
+export type SocialProfileVisualStrategy = z.infer<
+  typeof socialProfileVisualStrategySchema
+>;
+export type SocialPlatformProfile = z.infer<
+  typeof socialPlatformProfileSchema
+>;
+export type SocialProfileKitOutput = z.infer<
+  typeof socialProfileKitOutputSchema
+>;
+export type SocialProfileKitAgentResult = z.infer<
+  typeof socialProfileKitAgentResultSchema
+>;
+
+export function getDefaultOutputLanguageForMarket(
+  market: SocialProfileTargetMarket,
+): SocialProfileOutputLanguage {
+  if (market === "china") return "zh";
+  if (market === "japan") return "ja";
+  return "en";
+}

package/src/lib/tools/startup-idea-research-schema.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+
+export const STARTUP_IDEA_RESEARCH_RESULT_TYPE = "startup_idea_research";
+export const STARTUP_IDEA_RESEARCH_SCENE = "startup_idea_research";
+export const STARTUP_IDEA_RESEARCH_PROMPT_VERSION = "startup-idea-research.v1";
+
+const invalidBriefPattern =
+  /^(test|demo|placeholder|asdf|123|111|hello|hi|创业idea|startup idea)$/i;
+
+export const startupIdeaResearchInputSchema = z.object({
+  idea: z
+    .string()
+    .trim()
+    .min(20)
+    .max(1800)
+    .refine((value) => !invalidBriefPattern.test(value), "placeholder"),
+  targetUsers: z.string().trim().max(500).optional(),
+  region: z.string().trim().max(120).optional(),
+  stage: z
+    .enum(["raw", "problem", "prototype", "launched", "pivot"])
+    .default("raw"),
+  focus: z.string().trim().max(500).optional(),
+});
+
+export type StartupIdeaResearchInput = z.infer<typeof startupIdeaResearchInputSchema>;
+
+const confidence = z.enum(["low", "medium", "high"]).catch("low");
+const signalStrength = z.enum(["weak", "mixed", "strong"]).catch("mixed");
+const scoreBand = z.enum(["low", "medium", "high"]).catch("medium");
+
+const sourceSchema = z.object({
+  label: z.string(),
+  url: z.string().optional(),
+  note: z.string().optional(),
+});
+
+const competitorSchema = z.object({
+  name: z.string(),
+  url: z.string().optional(),
+  positioning: z.string().optional(),
+  pricingSignal: z.string().optional(),
+  tractionSignal: z.string().optional(),
+  gap: z.string().optional(),
+});
+
+const personaSchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  painIntensity: scoreBand,
+  budget: scoreBand,
+  reachableChannels: z.array(z.string()).default([]),
+});
+
+const experimentSchema = z.object({
+  title: z.string(),
+  goal: z.string(),
+  method: z.string(),
+  successMetric: z.string(),
+  duration: z.string().optional(),
+});
+
+const communityPostSchema = z.object({
+  title: z.string(),
+  subtitle: z.string(),
+  posterPrompt: z.string(),
+  body: z.string(),
+  callToAction: z.string(),
+  tags: z.array(z.string()).default([]),
+});
+
+export const startupIdeaResearchResultSchema = z.object({
+  ideaTitle: z.string(),
+  oneLineSummary: z.string(),
+  verdict: z.object({
+    painExists: signalStrength,
+    willingnessToPay: signalStrength,
+    marketReadiness: signalStrength,
+    confidence,
+    summary: z.string(),
+  }),
+  painEvidence: z.object({
+    realPainSignals: z.array(z.string()).default([]),
+    weakSignals: z.array(z.string()).default([]),
+    missingEvidence: z.array(z.string()).default([]),
+  }),
+  userSegments: z.array(personaSchema).default([]),
+  willingnessToPay: z.object({
+    likelyPayers: z.array(z.string()).default([]),
+    pricingHypotheses: z.array(z.string()).default([]),
+    objections: z.array(z.string()).default([]),
+    confidence,
+  }),
+  competitors: z.array(competitorSchema).default([]),
+  differentiation: z.array(z.string()).default([]),
+  validationPlan: z.array(experimentSchema).default([]),
+  risks: z.array(z.string()).default([]),
+  nextSteps: z.array(z.string()).default([]),
+  communityPost: communityPostSchema,
+  sources: z.array(sourceSchema).default([]),
+  disclaimer: z.string().default(""),
+  promptVersion: z.string().default(STARTUP_IDEA_RESEARCH_PROMPT_VERSION),
+  generatedAt: z.string().optional(),
+});
+
+export type StartupIdeaResearchResult = z.infer<typeof startupIdeaResearchResultSchema>;
+export type StartupIdeaSignalStrength = z.infer<typeof signalStrength>;
+export type StartupIdeaConfidence = z.infer<typeof confidence>;

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

@@ -0,0 +1,89 @@
+const majorImagery: Record<string, string> = {
+  fool: "年轻人背着小包走向悬崖边，仰头望天；白狗在脚边跃起，手中白玫瑰与远山同在。",
+  magician: "人物一手举杖指天、一手指向地面；桌上摆着权杖、圣杯、宝剑与星币，头顶是无限符号。",
+  "high-priestess": "女祭司坐在黑白双柱之间，膝上放着卷轴；身后石榴帷幕遮住水面与月亮。",
+  empress: "皇后坐在麦田与森林之间，身披石榴长袍；身旁有心形金星盾牌，头戴十二星冠。",
+  emperor: "皇帝端坐在饰有公羊头的石座上，手持权杖与圆球；红袍后方是荒峻山脉。",
+  hierophant: "教皇在两根柱子之间举手祝福，脚下交叉着两把钥匙，两位信徒跪在面前。",
+  lovers: "赤裸男女站在天使下方，身后分别是果树与火焰树，远处高山升起。",
+  chariot: "战车御者立在车上，肩披星纹帷幕；黑白两只狮身人面兽并列在前，城池在身后。",
+  strength: "白衣女子温柔合拢狮子的嘴，头顶悬着无限符号，腰间与头上缠绕花环。",
+  hermit: "披灰袍的老人独立山巅，一手提着六芒星灯笼，一手拄长杖。",
+  "wheel-of-fortune": "巨轮上刻有字母与炼金符号，四角有持书生物，轮旁环绕蛇、胡狼与狮身人面兽。",
+  justice: "正义端坐双柱之间，右手举剑、左手持天秤，红袍下露出方形扣饰。",
+  "hanged-man": "人物单脚倒悬在树架上，双手置于身后；双腿交成数字四，头部发出光环。",
+  death: "黑甲骷髅骑着白马前行，黑旗上开着白玫瑰；国王倒地，人物迎向远处升起的太阳。",
+  temperance: "天使一脚踩地、一脚踏水，在两只杯子之间倾倒水流；远处道路通向发光山峰。",
+  devil: "有角恶魔蹲在高台上，男女被松弛锁链系在台座两侧，头上长角、身后有尾巴。",
+  tower: "闪电击中高塔顶部，王冠被掀落，两个人从燃烧的塔中坠下，火星散向黑夜。",
+  star: "赤裸女子一膝跪地，把两壶水分别倒入池中与土地；天空有一颗大星和七颗小星。",
+  moon: "月亮俯照两座塔，狗与狼隔路对嚎；龙虾从水中爬出，小路蜿蜒通向远山。",
+  sun: "赤裸孩子骑在白马上，手举红旗；巨大太阳照耀四朵向日葵与矮墙。",
+  judgement: "天使在云中吹响号角，男女与孩子从棺木中起身举臂回应，远处是冰山与海。",
+  world: "披紫色飘带的人物在月桂花环中起舞，双手各持一根权杖；四角出现人、鹰、狮与牛。",
+};
+
+const minorImagery: Record<string, string> = {
+  "wands-ace": "一只手从云中伸出，握着冒出新叶的权杖；下方是河谷、城堡与远山。",
+  "wands-two": "人物站在城墙上，一手托地球、一手握权杖，望向海岸与远方；另一根权杖固定在墙上。",
+  "wands-three": "披红斗篷的人背对画面站在高处，扶着一根权杖眺望海面船只，身旁另立两根权杖。",
+  "wands-four": "四根权杖撑起花果彩棚，两人举花庆祝；后方人群与城堡清晰可见。",
+  "wands-five": "五名年轻人各举一根权杖交错挥动，动作像争抢、练习或混乱的对抗。",
+  "wands-six": "戴月桂冠的骑手举着饰有花环的权杖穿过人群，周围的人也高举权杖。",
+  "wands-seven": "人物站在高地上双手横握权杖，面对下方伸来的六根权杖，双脚穿着不同鞋子。",
+  "wands-eight": "八根权杖斜向飞过开阔天空，正朝河流与远处绿色丘陵落下，画面中没有人物。",
+  "wands-nine": "头缠绷带的人双手扶着一根权杖警惕回望，身后八根权杖排成围栏。",
+  "wands-ten": "人物弯身抱着十根沉重权杖走向前方城镇，视线被手中的木杖遮住。",
+  "wands-page": "年轻侍从在荒地中双手端详一根发芽权杖，衣袍绘有火蜥蜴。",
+  "wands-knight": "骑士举着发芽权杖，胯下马匹腾跃；披风和盔饰像火焰，背景是沙漠丘陵。",
+  "wands-queen": "皇后端坐狮纹王座，一手持向日葵、一手握权杖；脚边伏着一只黑猫。",
+  "wands-king": "国王端坐在火蜥蜴与狮子装饰的王座上，手握发芽权杖，脚边有一只小蜥蜴。",
+  "cups-ace": "一只手从云中托起满溢的圣杯，白鸽衔着圆片落向杯中，五道水流注入莲花池。",
+  "cups-two": "一男一女面对面交换圣杯，上方悬着双蛇杖与带翼狮首。",
+  "cups-three": "三名女子围成圆圈高举圣杯庆祝，脚边散落葡萄、南瓜与果实。",
+  "cups-four": "人物抱臂坐在树下，面前摆着三只杯；云中伸手递来第四只杯，他却侧头不看。",
+  "cups-five": "黑斗篷人物低头面对三只倾倒的杯，身后仍有两只直立圣杯；远处桥梁通向房屋。",
+  "cups-six": "庭院里，一个孩子把盛着白花的杯递给另一个孩子，周围还摆着五只花杯。",
+  "cups-seven": "黑色人影面对云中的七只圣杯，杯中分别出现人首、蛇、城堡、珠宝、花环、龙与蒙布形体。",
+  "cups-eight": "红衣人物背对八只整齐堆放的圣杯走向山路，天空同时悬着月亮与日蚀般的圆盘。",
+  "cups-nine": "人物双臂交叉坐在长凳上，身后弧形高台整齐陈列九只圣杯。",
+  "cups-ten": "一家四口在河畔举臂欢庆，天空彩虹上排列十只圣杯，远处是家园。",
+  "cups-page": "年轻侍从捧杯注视从杯中探出的鱼，身后海面起伏。",
+  "cups-knight": "披甲骑士骑白马缓步过河，平稳地向前举着一只圣杯。",
+  "cups-queen": "皇后坐在海边石座上，凝视手中有盖且装饰繁复的圣杯，脚边水流环绕。",
+  "cups-king": "国王手持圣杯与权杖坐在海中石座上，波涛里有船只与跃起的鱼。",
+  "swords-ace": "一只手从云中举起直剑，剑尖穿过王冠与花环；下方是崎岖群山。",
+  "swords-two": "蒙眼女子在海边交叉举着两把剑，身后水面散布岩石，新月悬在天空。",
+  "swords-three": "一颗红心被三把剑贯穿，背景是乌云与倾落的雨。",
+  "swords-four": "骑士石像双手合十躺在墓台上，墙上挂着三把剑，第四把刻在台侧。",
+  "swords-five": "前景人物带笑收起宝剑，两个人垂头走向海边；地上散落着剑，天空云层凌乱。",
+  "swords-six": "船夫撑船载着披斗篷的大人与孩子渡水，六把剑竖插在船头。",
+  "swords-seven": "人物踮脚抱走五把剑并回头张望，身后营地旁还留下两把剑。",
+  "swords-eight": "蒙眼并被绳索捆住的女子站在湿地，周围八把剑形成疏松围栏，城堡在远处。",
+  "swords-nine": "人物夜里从床上惊醒，以手掩面；墙上横排九把剑，被褥绘有星座与决斗图案。",
+  "swords-ten": "人物俯卧地面，背上插着十把剑；黑夜边缘已露出远方晨光。",
+  "swords-page": "年轻人双手举剑站在风吹的高地上，身体朝前、视线回望，云层与群鸟快速移动。",
+  "swords-knight": "披甲骑士挥剑策马疾驰，树木被狂风吹弯，天空布满碎云。",
+  "swords-queen": "皇后侧坐云纹王座，右手竖剑、左手向前伸出，天空有飞鸟。",
+  "swords-king": "国王正面端坐，双手竖握宝剑；王座饰有蝴蝶与新月，树木在身后。",
+  "pentacles-ace": "一只手从云中托起巨大星币；下方花园小径穿过拱门，通向远山。",
+  "pentacles-two": "人物用无限形绳带上下抛接两枚星币，身后两艘船在高低起伏的海浪中航行。",
+  "pentacles-three": "工匠站在教堂长椅上与两人交谈，拱顶上方嵌着三枚星币。",
+  "pentacles-four": "人物头顶一枚、怀抱一枚、双脚各踩一枚星币坐在城外，身体紧紧护住它们。",
+  "pentacles-five": "两名衣衫单薄、受伤的人在雪中走过彩绘玻璃窗，窗上亮着五枚星币。",
+  "pentacles-six": "富人一手持天秤，一手把钱币分给两名跪地者，六枚星币排列在上方。",
+  "pentacles-seven": "农人双手倚着锄具停下观察藤蔓，枝叶间长着七枚星币。",
+  "pentacles-eight": "工匠坐在长凳上雕刻星币，六枚成品挂在柱上，另有一枚在脚边。",
+  "pentacles-nine": "华服女子站在结满葡萄与星币的花园中，戴手套的手上停着一只猎鹰。",
+  "pentacles-ten": "拱门下坐着披纹章斗篷的老人，家人与孩子相聚，狗在脚边，十枚星币覆盖画面。",
+  "pentacles-page": "年轻侍从双手托起星币凝神端详，站在花田与新翻土地前。",
+  "pentacles-knight": "黑马静止不动，骑士双手平托一枚星币；身后是已经耕整的田地。",
+  "pentacles-queen": "皇后坐在花木环绕的王座上，低头怀抱星币；脚边草丛中有一只兔子。",
+  "pentacles-king": "国王坐在葡萄与公牛装饰的王座上，手持权杖与星币，脚边植物繁盛，城堡在后。",
+};
+
+export function getTarotVisibleImagery(cardId: string, chinese: boolean, fallback: string) {
+  const description = majorImagery[cardId] ?? minorImagery[cardId];
+  if (!description || !chinese) return fallback;
+  return description;
+}