# utils/password/chongming_password.pyi

def hash_password(password: str) -> str:
    """
    对明文密码进行 Argon2id 哈希，返回 PHC 格式字符串。

    Args:
        password: 明文密码

    Returns:
        str: 形如 "$argon2id$v=19$m=19456,t=2,p=1$..." 的哈希

    Raises:
        ValueError: 如果密码为空或哈希过程失败
    """
    ...

def verify_password(password: str, password_hash: str) -> bool:
    """
    验证明文密码是否与给定哈希匹配。

    Args:
        password: 明文密码
        password_hash: 存储的 PHC 格式哈希

    Returns:
        bool: 匹配返回 True，否则 False

    Raises:
        ValueError: 如果哈希格式无效
    """
    ...