"""Editing mode enum — extracted from edit_plan for independent use."""

import sys

if sys.version_info >= (3, 11):
    from enum import StrEnum
else:
    from enum import Enum

    class StrEnum(str, Enum):
        pass


class EditingMode(StrEnum):
    """剪辑模式枚举。

    #1970 智能剪辑流程重构（2026-09）后，剪辑组装模式改由
    ``CreateGenerationTaskRequest.assembly_mode``（'random'/'narrative'）表达。
    本枚举仅保留模板体系仍在使用的模式；以下三个模式标记 deprecated，
    不主动删除代码（pip/voice_pip 在路由入口已统一映射为 one_take），
    待确认无存量引用后在技术债清理中移除：

    - ONE_TAKE（deprecated）：顺序拼接，等同 assembly_mode='random'
    - PIP（deprecated）：画中画已下线，入口映射 one_take
    - VOICE_PIP（deprecated）：口播+画中画已下线，入口映射 one_take
    - VOICE_OVER：保留，口播+B-roll 模板仍在使用
    """

    ONE_TAKE = "one_take"  # deprecated（#1970）：顺序拼接，等同 assembly_mode='random'
    PIP = "pip"  # deprecated（#1970）：画中画已下线，入口映射 one_take
    VOICE_OVER = "voice_over"  # 口播+B-roll模式（保留）
    VOICE_PIP = "voice_pip"  # deprecated（#1970）：口播+画中画已下线，入口映射 one_take