# ════════════════════════════════════════════════════════════════════════════
# ## 🔷 Problem {NUMBER}: {problem_name}.py
# ════════════════════════════════════════════════════════════════════════════
# **Category:** {Category} | {التصنيف}
# **Difficulty:** {Easy/Medium/Hard} | {سهل/متوسط/صعب}
# **Source:** {programmingadvices.com / LeetCode / HackerRank}
# ════════════════════════════════════════════════════════════════════════════

# ────────────────────────────────────────────────────────────────────────────
# 📝 DESCRIPTION | الوصف
# ────────────────────────────────────────────────────────────────────────────
#
# EN:
# {Write clear problem description here}
#
# AR:
# {اكتب وصف المشكلة بوضوح هنا}
#
# ────────────────────────────────────────────────────────────────────────────

# ────────────────────────────────────────────────────────────────────────────
# 💡 EXAMPLES | الأمثلة
# ────────────────────────────────────────────────────────────────────────────
#
# Example 1:
# Input:  {sample input}
# Output: {expected output}
#   Why:    {explanation}
#
# Example 2:
# Input:  {sample input}
# Output: {expected output}
#   Why:    {explanation}
#
# Example 3 (Edge Case):
# Input:  {edge case}
# Output: {expected output}
#   Why:    {explanation}
#
# ────────────────────────────────────────────────────────────────────────────

# ────────────────────────────────────────────────────────────────────────────
# ⚠️ CONSTRAINTS | القيود
# ────────────────────────────────────────────────────────────────────────────
#
# • All functions must use Python Type Hints | يجب استخدام تلميحات الأنواع في جميع الدوال
# • {constraint 1} | {القيد الأول}
# • {constraint 2} | {القيد الثاني}
# • {constraint 3} | {القيد الثالث}
#
# ────────────────────────────────────────────────────────────────────────────

# ────────────────────────────────────────────────────────────────────────────
# 🔧 FUNCTION SIGNATURES | توقيعات الدوال
# ────────────────────────────────────────────────────────────────────────────
#
# def function_name(param: type) -> return_type:
# def helper_function(param: type) -> return_type:
#
# ────────────────────────────────────────────────────────────────────────────