第06章 - 内容数据模型与典故JSON

export const AllusionSchema = z
  .object({
    id: z.string().regex(/^[a-z0-9-]+$/, 'id 只能是小写字母、数字与连字符'),
    /** 信史 / 神话 / 传说：典故馆要分开呈现（神话落在时间轴最左端） */
    kind: z.enum(['history', 'myth', 'legend']).default('history'),
    title: z.string().min(1),
    pinyin: z.string().min(1),
    dynasty: z.string().min(1),
    era: z.string().min(1),
    /** 用于历史长卷排序，公元前为负数 */
    yearApprox: z.number().int(),
    figures: z.array(z.string().min(1)).min(1),
    source: SourceSchema,
    /** 一句话寓意，孩子能听懂 */
    moral: z.string().min(1).max(90),
    keywords: z.array(z.string().min(1)).min(2).max(6),
    ageRange: z.tuple([z.number().int(), z.number().int()]),
    story: z.array(StoryBeatSchema).min(2).max(6),
    keyMoment: KeyMomentSchema,
    misconceptions: z.array(z.string().min(1)).min(1),
    quiz: z.array(QuizQuestionSchema).min(2),
    game: z.object({
      /** 主玩法模板，用于缩略图与筛选 */
      template: z.string().min(1),
      /** 实际参与编排的各段脚本，按顺序执行 */
      stages: z.array(GameStageSchema).min(1).max(3),
    }),
  })
  // ... 五条 refine 规则见 6.3

.refine((v) => v.quiz.every((q) => q.answer < q.options.length), {
  message: 'quiz 的 answer 下标越界',
  path: ['quiz'],
})
.refine((v) => v.keyMoment.options.filter((o) => o.isCanonical).length === 1, {
  message: 'keyMoment 必须恰好有一个 isCanonical 选项',
  path: ['keyMoment'],
})
.refine((v) => v.story.some((b) => b.id === v.keyMoment.beatId), {
  message: 'keyMoment.beatId 必须存在于 story 中',
  path: ['keyMoment', 'beatId'],
})
.refine((v) => new Set(v.story.map((b) => b.id)).size === v.story.length, {
  message: 'story 的 beat id 不能重复',
  path: ['story'],
})
.refine((v) => v.quiz.some((q) => q.kind === 'transfer'), {
  message: '至少需要一道 transfer（迁移）题，否则无法验证“真的记住了”',
  path: ['quiz'],
});

export const QuizQuestionSchema = z.object({
  id: z.string().min(1),
  kind: z.enum(['recall', 'transfer']).default('recall'),
  question: z.string().min(1),
  options: z.array(z.string().min(1)).min(2).max(4),
  answer: z.number().int().min(0),
  explanation: z.string().min(1),
});

export const StoryBeatSchema = z.object({
  id: z.string().min(1),
  title: z.string().min(1),
  /** 屏幕上的一句话。中日文卡得紧，英文天然更长，所以上限按英文给 */
  text: z.string().max(90),
  narration: z.string().min(1),   // 旁白可以更长，TTS 会完整读出来
  illustration: z.string().min(1).default('none'),
});

export const KeyMomentSchema = z.object({
  beatId: z.string().min(1),
  question: z.string().min(1),
  options: z.array(KeyMomentOptionSchema).min(2).max(4),
  reveal: z.string().min(1),
});

export const GameStageSchema = z.object({
  template: z.string().min(1),
  levelScript: z.unknown(),
});

export const allusions: AllusionContent[] = [
  AllusionSchema.parse(raw),          // 曹冲称象
  AllusionSchema.parse(rawPangu),
  AllusionSchema.parse(rawHouyi),
  /* ... 共 12 个 */
];

/** 取某个典故里指定模板的阶段脚本；缺了就早失败，别等玩到一半才发现 */
export function stageScript(content: AllusionContent, template: string): unknown {
  const stage = content.game.stages.find((s) => s.template === template);
  if (!stage) {
    throw new Error('典故 ' + content.id + ' 缺少 ' + template + ' 阶段脚本');
  }
  return stage.levelScript;
}

// games/pangu/src/logic.ts —— 纯逻辑：不碰 Phaser，可以直接单测
export function tapLevel(content: AllusionContent): TapLevel {
  return TapLevelSchema.parse(stageScript(content, 'tap'));
}
export function placeLevel(content: AllusionContent): PlaceLevel {
  return PlaceLevelSchema.parse(stageScript(content, 'place'));
}