import type {
    GeneratorType,
    LayoutConfig,
    TemplateType,
    WorksheetDefinition,
    WorksheetType,
} from '../models/worksheet';
import { difficultyToStars } from './difficulty';

/**
 * MathFunctionType - 保持向后兼容（mathPageMixin / mathIndex）
 */
export interface MathFunctionType {
    id: string;
    page?: string;
    title: string;
    desc: string;
    icon?: string;
    img?: string;
}

/**
 * FocusFunctionType - 保持向后兼容（focusPageMixin / focusIndex）
 */
export interface FocusFunctionType {
    id: string;
    page?: string;
    title: string;
    desc: string;
    icon: string;
    mode?: string;
    img?: string;
}

interface SheetEngine {
    subcategory: string;
    template: TemplateType;
    generator: GeneratorType;
    generatorConfig?: Record<string, unknown>;
    layoutConfig?: LayoutConfig;
    tags?: string[];
    sortOrder: number;
}

function legacyPath(ui: WorksheetType): string | null {
    if (!ui.page) return null;
    if (ui.subpackage) {
        return `/${ui.subpackage}/${ui.page}/${ui.page}`;
    }
    return `/pages/${ui.page}/${ui.page}`;
}

function sheet(ui: WorksheetType, engine: SheetEngine): WorksheetDefinition {
    const ageMin = ui.ageRange?.[0] ?? 3;
    const ageMax = ui.ageRange?.[1] ?? 8;
    return {
        ...ui,
        subcategory: engine.subcategory,
        ageMin,
        ageMax,
        difficultyLevel: difficultyToStars(ui.difficulty),
        previewImage: ui.img ?? '',
        tags: engine.tags?.length ? engine.tags : [engine.subcategory],
        isNew: false,
        isHot: false,
        sortOrder: engine.sortOrder,
        downloadCount: 0,
        status: 'active',
        template: engine.template,
        generator: engine.generator,
        generatorConfig: engine.generatorConfig ?? {},
        layoutConfig: engine.layoutConfig ?? { showBorder: true },
        userConfigurable: null,
        legacyPage: legacyPath(ui),
    };
}

const L = {
    gridEx: { showBorder: true, fontSize: 18 } satisfies LayoutConfig,
    card: { showBorder: true, columns: 2, fontSize: 16 } satisfies LayoutConfig,
    trace: {
        showBorder: true,
        showInstruction: true,
        fontSize: 20,
    } satisfies LayoutConfig,
};

// 现有功能清单 §二：数感启蒙 26 种 + §三 13 种 + §四 §五 语文 2
// prettier-ignore
export const ALL_WORKSHEETS: WorksheetDefinition[] = [
    sheet(
        { id: 'number-find', title: '找数字，涂一涂', desc: '在数字方阵中找出目标数字并涂色', category: 'math', page: 'mathDraw', subpackage: 'mathPages', img: '/assets/mathEntrance/number-find.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fff3e0', previewText: '🔍 1 2 3' },
        { subcategory: 'number-sense', template: 'grid-coloring', generator: 'counting', sortOrder: 1, layoutConfig: { ...L.gridEx }, generatorConfig: { functionId: 'number-find' } },
    ),
    sheet(
        { id: 'number-write', title: '看数字，写一写', desc: '按笔画顺序练习书写数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', img: '/assets/mathEntrance/number-write.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fff3e0', previewText: '1 2 3' },
        { subcategory: 'number-sense', template: 'tracing-writing', generator: 'counting', sortOrder: 2, layoutConfig: { ...L.trace }, generatorConfig: { functionId: 'number-write' } },
    ),
    sheet(
        { id: 'number-coloring', title: '按数字，涂颜色', desc: '按指定数字给对应圆圈涂色', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🎨', img: '/assets/mathEntrance/number-coloring.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '🎨' },
        { subcategory: 'number-sense', template: 'grid-coloring', generator: 'counting', sortOrder: 3, layoutConfig: { ...L.gridEx }, generatorConfig: { functionId: 'number-coloring' } },
    ),
    sheet(
        { id: 'counting-matching', title: '数一数，连一连', desc: '连线配对数字和对应数量图形', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔗', img: '/assets/mathEntrance/count-match.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '3↔🍎🍎🍎' },
        { subcategory: 'counting', template: 'match-connect', generator: 'counting', sortOrder: 4, layoutConfig: { ...L.gridEx }, generatorConfig: { functionId: 'counting-matching' } },
    ),
    sheet(
        { id: 'number-object-match', title: '数物连线', desc: '连线相同数量的物品和数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔗', img: '/assets/mathEntrance/number-object-match.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '🔗' },
        { subcategory: 'counting', template: 'match-connect', generator: 'counting', sortOrder: 5, generatorConfig: { functionId: 'number-object-match' } },
    ),
    sheet(
        { id: 'number-object-fill', title: '数物填写', desc: '数物品数量，填写对应数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✏️', img: '/assets/mathEntrance/number-object-fill.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '✏️' },
        { subcategory: 'counting', template: 'grid-exercise', generator: 'counting', sortOrder: 6, generatorConfig: { functionId: 'number-object-fill' } },
    ),
    sheet(
        { id: 'counting-select', title: '数一数，选一选', desc: '数出物品数量，圈出正确答案', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✓', img: '/assets/mathEntrance/counting-select.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '✓' },
        { subcategory: 'counting', template: 'grid-exercise', generator: 'counting', sortOrder: 7, generatorConfig: { functionId: 'counting-select' } },
    ),
    sheet(
        { id: 'counting-fill', title: '数一数，填一填', desc: '数出物品数量，填写数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✏️', img: '/assets/mathEntrance/counting-fill.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '✏️' },
        { subcategory: 'counting', template: 'grid-exercise', generator: 'counting', sortOrder: 8, generatorConfig: { functionId: 'counting-fill' } },
    ),
    sheet(
        { id: 'compare', title: '数一数，比大小', desc: '比较数量，填入 ＞＜＝', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '⚖️', img: '/assets/mathEntrance/compare.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '3 ○ 5' },
        { subcategory: 'counting', template: 'grid-exercise', generator: 'comparison', sortOrder: 9, generatorConfig: { functionId: 'compare' } },
    ),
    sheet(
        { id: 'number-sort', title: '数字排序', desc: '写出正确的数字顺序', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔢', img: '/assets/mathEntrance/number-sort.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fff3e0', previewText: '1→2→3' },
        { subcategory: 'sequence', template: 'sequence-pattern', generator: 'number-sequence', sortOrder: 10, generatorConfig: { functionId: 'number-sort' } },
    ),
    sheet(
        { id: 'missing-number', title: '填上缺少的数字', desc: '在数列中找出并填写缺失数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '❓', img: '/assets/mathEntrance/missing-number.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fff3e0', previewText: '1_3_5' },
        { subcategory: 'sequence', template: 'sequence-pattern', generator: 'number-sequence', sortOrder: 11, generatorConfig: { functionId: 'missing-number' } },
    ),
    sheet(
        { id: 'number-decompose', title: '10以内数的分与合', desc: '把数字分一分，合一合', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔢', img: '/assets/mathEntrance/number-decompose.png', ageRange: [4, 6], difficulty: 'beginner', previewBg: '#fff3e0', previewText: '8=?+?' },
        { subcategory: 'decompose', template: 'grid-exercise', generator: 'number-decompose', sortOrder: 12, generatorConfig: { max: 10 } },
    ),
    sheet(
        { id: 'number-decompose-20', title: '20以内数的分与合', desc: '把数字分一分，合一合', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔢', img: '/assets/mathEntrance/number-decompose-20.png', ageRange: [5, 7], difficulty: 'basic', previewBg: '#fff3e0', previewText: '15=?+?' },
        { subcategory: 'decompose', template: 'grid-exercise', generator: 'number-decompose', sortOrder: 13, generatorConfig: { max: 20 } },
    ),
    sheet(
        { id: 'one-digit-addition', title: '一位数加法', desc: '通过圆点学习一位数加法运算', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/one-digit-addition.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '2+3=?' },
        { subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 14, generatorConfig: { operators: ['+'], maxNumber: 9, showDots: true } },
    ),
    sheet(
        { id: 'addition-5', title: '5以内加法', desc: '图形化展示 5 以内加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/addition-5.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e3f2fd', previewText: '2+1=?' },
        { subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 15, generatorConfig: { operators: ['+'], maxNumber: 5, showDots: true } },
    ),
    sheet(
        { id: 'addition-10', title: '10以内加法', desc: '图形化展示 10 以内加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/addition-10.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '3+5=?' },
        { subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 16, generatorConfig: { operators: ['+'], maxNumber: 10, showDots: true } },
    ),
    sheet(
        { id: 'subtraction-10', title: '10以内减法', desc: '图形化展示 10 以内减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/subtraction-10.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '8-3=?' },
        { subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 17, generatorConfig: { operators: ['-'], maxNumber: 10, showDots: true } },
    ),
    sheet(
        { id: 'addition-subtraction-10', title: '10以内加减法', desc: '加减法混合运算', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '±', img: '/assets/mathEntrance/addition-subtraction-10.png', ageRange: [5, 7], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '±' },
        { subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 18, generatorConfig: { operators: ['+', '-'], maxNumber: 10, showDots: true } },
    ),
    sheet(
        { id: 'make-ten', title: '凑十法练习', desc: '20 以内进位加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/make-ten.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '7+?=10' },
        { subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 19, generatorConfig: { method: 'make-ten' } },
    ),
    sheet(
        { id: 'break-ten', title: '破十法练习', desc: '20 以内退位减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/break-ten.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '15-8=?' },
        { subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 20, generatorConfig: { method: 'break-ten' } },
    ),
    sheet(
        { id: 'flat-ten', title: '平十法练习', desc: '20 以内退位减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/flat-ten.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '14-6=?' },
        { subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 21, generatorConfig: { method: 'flat-ten' } },
    ),
    sheet(
        { id: 'borrow-ten', title: '借十法练习', desc: '20 以上退位减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/borrow-ten.png', ageRange: [6, 8], difficulty: 'advanced', previewBg: '#e3f2fd', previewText: '32-8=?' },
        { subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 22, generatorConfig: { method: 'borrow-ten' } },
    ),
    sheet(
        { id: 'practice-addition', title: '加法运算', desc: '10/20/50/100 以内加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/practice-addition.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '25+18=?' },
        { subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 23, generatorConfig: { operators: ['+'], preset: 'vertical' } },
    ),
    sheet(
        { id: 'practice-subtraction', title: '减法运算', desc: '10/20/50/100 以内减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/practice-subtraction.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '43-17=?' },
        { subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 24, generatorConfig: { operators: ['-'], preset: 'vertical' } },
    ),
    sheet(
        { id: 'practice-mixed', title: '混合运算', desc: '10/20/50/100 以内加减法混合', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '±', img: '/assets/mathEntrance/practice-mixed.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '±' },
        { subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 25, generatorConfig: { operators: ['+', '-'], preset: 'vertical' } },
    ),
    sheet(
        { id: 'multiplication-table', title: '九九乘法表', desc: '学习九九乘法口诀', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✖️', img: '/assets/mathEntrance/multiplication-table.png', ageRange: [6, 8], difficulty: 'intermediate', previewBg: '#f3e5f5', previewText: '3×4=12' },
        { subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 26, generatorConfig: { operators: ['×'], mode: 'multiplication-table' } },
    ),

    sheet(
        { id: 'color-shape-match', title: '根据颜色画图形', desc: '根据颜色画出对应图形', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎯', img: '/assets/focusEntrance/color-shape-match.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#f3e5f5', previewText: '🎯' },
        { subcategory: 'focus-visual', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 27, generatorConfig: { functionId: 'color-shape-match' } },
    ),
    sheet(
        { id: 'shape-symbol', title: '图形符号配对', desc: '根据图形画对应符号', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔗', img: '/assets/focusEntrance/shape-symbol.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e8eaf6', previewText: '△→♠' },
        { subcategory: 'focus-visual', template: 'match-connect', generator: 'shape-grid', sortOrder: 28, generatorConfig: { functionId: 'shape-symbol' } },
    ),
    sheet(
        { id: 'shape-recognition', title: '识别形状', desc: '识别形状，涂一涂', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔍', img: '/assets/focusEntrance/shape-recognition.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '△ ○ □' },
        { subcategory: 'focus-visual', template: 'grid-coloring', generator: 'shape-grid', sortOrder: 29, generatorConfig: { functionId: 'shape-recognition' } },
    ),
    sheet(
        { id: 'position-coloring', title: '方位涂涂乐', desc: '观察位置，在方格中涂色', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '📍', img: '/assets/focusEntrance/position-coloring.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e8f5e9', previewText: '📍' },
        { subcategory: 'focus-grid', template: 'grid-coloring', generator: 'shape-grid', sortOrder: 30, generatorConfig: { functionId: 'position-coloring' } },
    ),
    sheet(
        { id: 'color-pattern', title: '颜色找规律', desc: '观察颜色规律，在空白图形中涂色', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', img: '/assets/focusEntrance/color-pattern.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fff8e1', previewText: '🎨' },
        { subcategory: 'focus-grid', template: 'grid-coloring', generator: 'color-pattern', sortOrder: 31, generatorConfig: { functionId: 'color-pattern' } },
    ),
    sheet(
        { id: 'match-connect', title: '连连看', desc: '根据物品连一连', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔗', img: '/assets/focusEntrance/match-connect.png', ageRange: [3, 6], difficulty: 'beginner', previewBg: '#e0f7fa', previewText: '🔗' },
        { subcategory: 'focus-connect', template: 'match-connect', generator: 'shape-grid', sortOrder: 32, generatorConfig: { functionId: 'match-connect' } },
    ),
    sheet(
        { id: 'line-recognition', title: '线条识别', desc: '认识不同线条，画出颜色对应的线条', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '📏', img: '/assets/focusEntrance/line-recognition.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#f1f8e9', previewText: '〰️' },
        { subcategory: 'focus-visual', template: 'tracing-writing', generator: 'shape-grid', sortOrder: 33, generatorConfig: { functionId: 'line-recognition' } },
    ),
    sheet(
        { id: 'grid-reasoning', title: '方格推理', desc: '推理出合并方格并连线', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🧩', img: '/assets/focusEntrance/grid-reasoning.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e8eaf6', previewText: '🧩' },
        { subcategory: 'focus-logic', template: 'special-graphic', generator: 'shape-grid', sortOrder: 34, generatorConfig: { functionId: 'grid-reasoning' } },
    ),
    sheet(
        { id: 'code-connect', title: '译码连线', desc: '按数字顺序将数字对应颜色连线', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔢', img: '/assets/focusEntrance/code-connect.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#fff3e0', previewText: '🔢' },
        { subcategory: 'focus-connect', template: 'match-connect', generator: 'dot-connect', sortOrder: 35, generatorConfig: { functionId: 'code-connect' } },
    ),
    sheet(
        { id: 'dot-connect', title: '数字点连线', desc: '按数字顺序连点成图', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔗', img: '/assets/focusEntrance/dot-connect.png', ageRange: [3, 6], difficulty: 'beginner', previewBg: '#e3f2fd', previewText: '1→2→3' },
        { subcategory: 'focus-connect', template: 'match-connect', generator: 'dot-connect', sortOrder: 36, generatorConfig: { functionId: 'dot-connect' } },
    ),
    sheet(
        { id: 'grid-drawing-3x3', title: '格子仿画 3×3', desc: '简单有趣，培养专注力', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', mode: '3x3', img: '/assets/focusEntrance/grid-drawing-3x3.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '▦' },
        { subcategory: 'grid-copy', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 37, generatorConfig: { grid: '3x3' } },
    ),
    sheet(
        { id: 'grid-drawing-5x5', title: '格子仿画 5×5', desc: '创意挑战，提升观察力', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', mode: '5x5', img: '/assets/focusEntrance/grid-drawing-5x5.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fce4ec', previewText: '▦' },
        { subcategory: 'grid-copy', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 38, generatorConfig: { grid: '5x5' } },
    ),
    sheet(
        { id: 'grid-drawing-7x7', title: '格子仿画 7×7', desc: '大师挑战，锻炼耐心', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', mode: '7x7', img: '/assets/focusEntrance/grid-drawing-7x7.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#fce4ec', previewText: '▦' },
        { subcategory: 'grid-copy', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 39, generatorConfig: { grid: '7x7' } },
    ),

    sheet(
        { id: 'word-recognition', title: '识字卡', desc: '输入或选字生成涂色识字卡（grid/find 模板）', category: 'chinese', page: 'index', subpackage: '', icon: '📖', img: '', ageRange: [3, 6], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '大 小' },
        { subcategory: 'literacy', template: 'card-layout', generator: 'custom', sortOrder: 40, generatorConfig: { functionId: 'word-recognition' }, layoutConfig: { ...L.card } },
    ),
    sheet(
        { id: 'copybook', title: '练字帖', desc: '选字生成田字格笔顺练字帖', category: 'chinese', page: 'copyBook', subpackage: '', icon: '✏️', img: '', ageRange: [4, 7], difficulty: 'basic', previewBg: '#fff8e1', previewText: '横竖撇' },
        { subcategory: 'copybook', template: 'tracing-writing', generator: 'character-tracing', sortOrder: 41, generatorConfig: { functionId: 'copybook' }, layoutConfig: { ...L.trace } },
    ),

    sheet(
        {
            id: 'letter-tracing-single',
            title: '看图描红',
            desc: '单字母配图、例句与六行四线三格描红',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '🔠',
            img: '',
            ageRange: [4, 7],
            difficulty: 'beginner',
            previewBg: '#e8f4ff',
            previewText: 'Aa',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 42,
            layoutConfig: {
                ...L.trace,
                instructionText: '看一看，读一读，再描一描',
            },
            generatorConfig: {
                mode: 'letter-tracing-single',
                letterCase: 'upper',
                selectedLetter: 'A',
                repetitions: 5,
                fadePattern: 'gradient',
            },
        },
    ),
    sheet(
        {
            id: 'letter-tracing-two-column',
            title: '两列练习',
            desc: '左 A–M、右 N–Z，每组包含大小写',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '🔤',
            img: '',
            ageRange: [4, 7],
            difficulty: 'beginner',
            previewBg: '#e8f4ff',
            previewText: 'A|N',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 43,
            layoutConfig: {
                ...L.trace,
                columns: 2,
                instructionText: '左 A–M、右 N–Z，大小写配对描红',
            },
            generatorConfig: {
                mode: 'letter-tracing-two-column',
                letterCase: 'both',
                repetitions: 4,
                fadePattern: 'gradient',
            },
        },
    ),
    sheet(
        {
            id: 'letter-tracing-upper-lower',
            title: '字母总览',
            desc: 'Uppercase / Lowercase 分区，每区四行（7+7+6+6）',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '🔡',
            img: '',
            ageRange: [4, 7],
            difficulty: 'beginner',
            previewBg: '#e8f4ff',
            previewText: 'Aa Bb',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 44,
            layoutConfig: {
                ...L.trace,
                columns: 13,
                instructionText: '认读全部大写与小写字母',
            },
            generatorConfig: {
                mode: 'letter-tracing-upper-lower',
                letterCase: 'both',
                repetitions: 1,
                fadePattern: 'first-only',
            },
        },
    ),
    sheet(
        {
            id: 'letter-tracing-case-pairing',
            title: '大小写练习',
            desc: '半组字母左大写右小写，每行四个',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '✏️',
            img: '',
            ageRange: [4, 7],
            difficulty: 'beginner',
            previewBg: '#e8f4ff',
            previewText: 'A→Z',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 45,
            layoutConfig: {
                ...L.trace,
                instructionText: '左栏大写、右栏小写，逐行对应描红',
            },
            generatorConfig: {
                mode: 'letter-tracing-case-pairing',
                letterCase: 'both',
                alphabetHalf: 'A-M',
                repetitions: 4,
                fadePattern: 'gradient',
            },
        },
    ),
    sheet(
        {
            id: 'letter-tracing-three',
            title: '三字母精练',
            desc: '每页聚焦 3 个字母，大写 + 小写深度书写',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '🔤',
            img: '',
            ageRange: [4, 7],
            difficulty: 'basic',
            previewBg: '#e8f4ff',
            previewText: 'ABC',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 46,
            layoutConfig: {
                ...L.trace,
                instructionText: '每页 3 个字母，逐字精练',
            },
            generatorConfig: {
                mode: 'letter-tracing-three',
                letterCase: 'both',
                repetitions: 5,
                fadePattern: 'gradient',
                tripleLetters: ['A', 'B', 'C'],
            },
        },
    ),
    sheet(
        {
            id: 'letter-tracing-half',
            title: '单字母逐行',
            desc: '每行一个字母，13 字母半表逐字练习',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '📝',
            img: '',
            ageRange: [4, 7],
            difficulty: 'basic',
            previewBg: '#e8f4ff',
            previewText: 'A–M',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 47,
            layoutConfig: {
                ...L.trace,
                instructionText: '每行一个字母，逐字反复练习',
            },
            generatorConfig: {
                mode: 'letter-tracing-half',
                letterCase: 'both',
                alphabetHalf: 'A-M',
                repetitions: 5,
                fadePattern: 'first-only',
            },
        },
    ),
    sheet(
        {
            id: 'letter-tracing-daily-checkin',
            title: '每日打卡',
            desc: '四宫格每日字母打卡，闭合四线三格练习',
            category: 'english',
            page: 'letterTracing',
            subpackage: 'englishPages',
            icon: '🗓️',
            img: '',
            ageRange: [4, 7],
            difficulty: 'basic',
            previewBg: '#e8f4ff',
            previewText: 'ABCD',
        },
        {
            subcategory: 'letter-tracing',
            template: 'tracing-writing',
            generator: 'letter-tracing',
            sortOrder: 48,
            layoutConfig: {
                ...L.trace,
                instructionText: '四宫格每日打卡字母描红',
            },
            generatorConfig: {
                mode: 'letter-tracing-daily-checkin',
                letterCase: 'both',
                repetitions: 5,
                fadePattern: 'first-only',
                dailyLetters: ['A', 'B', 'C', 'D'],
            },
        },
    ),
];

export const MATH_FUNCTION_TYPES: MathFunctionType[] = ALL_WORKSHEETS.filter(
    (w) => w.category === 'math',
)
    .sort((a, b) => a.sortOrder - b.sortOrder)
    .map((w) => ({
        id: w.id,
        page: w.page,
        title: w.title,
        desc: w.desc,
        icon: w.icon,
        img: w.img,
    }));

export const FOCUS_FUNCTION_TYPES: FocusFunctionType[] = ALL_WORKSHEETS.filter(
    (w) => w.category === 'focus',
)
    .sort((a, b) => a.sortOrder - b.sortOrder)
    .map((w) => ({
        id: w.id,
        page: w.page,
        title: w.title,
        desc: w.desc,
        icon: w.icon ?? '・',
        mode: w.mode,
        img: w.img,
    }));

export function getWorksheetsByCategory(
    category: string,
): WorksheetDefinition[] {
    if (category === 'all') return ALL_WORKSHEETS;
    return ALL_WORKSHEETS.filter((w) => w.category === category);
}

export function getWorksheetsByAge<T extends WorksheetType>(
    worksheets: readonly T[],
    age: number,
): T[] {
    return worksheets.filter((w) => {
        if (!w.ageRange) return true;
        return age >= w.ageRange[0] && age <= w.ageRange[1];
    });
}

export function getWorksheetPath(worksheet: WorksheetType): string {
    if (!worksheet.page) return '';
    if (worksheet.subpackage) {
        return `/${worksheet.subpackage}/${worksheet.page}/${worksheet.page}?id=${worksheet.id}`;
    }
    return `/pages/${worksheet.page}/${worksheet.page}`;
}

export function getWorksheetById(id: string): WorksheetDefinition | undefined {
    return ALL_WORKSHEETS.find((w) => w.id === id);
}