feat: enhance arithmetic interfaces with detailed descriptions and examples

maths/arithmetic/add.py

@@ -14,5 +14,6 @@ add_interface = gr.Interface(
     inputs=[gr.Number(label="A"), gr.Number(label="B")],
     outputs="number",
     title="Addition",
-    description="Add two numbers"
+    description="Add two numbers.\n\n**Description:**\nThis tool takes two numbers as input and returns their sum.\n\n**Examples:**\n- Input: 2, 3 → Output: 5\n- Input: -1.5, 4.2 → Output: 2.7\n- Input: 0, 0 → Output: 0",
+    examples=[[2, 3], [-1.5, 4.2], [0, 0]],
 )

maths/arithmetic/calculate_array.py

@@ -31,13 +31,25 @@ def calculate_array(numbers: list, operations: list) -> float:
             raise ValueError(f"Unsupported operation: {op}")
     return result
 
+def parse_number_list(s):
+    try:
+        return [float(x.strip()) for x in s.split(',') if x.strip() != '']
+    except Exception:
+        return []
+
+def parse_operation_list(s):
+    ops = [x.strip().lower() for x in s.split(',') if x.strip() != '']
+    valid_ops = {'add', 'subtract', 'multiply', 'divide'}
+    return [op for op in ops if op in valid_ops]
+
 array_calc_interface = gr.Interface(
-    fn=lambda numbers, operations: calculate_array(numbers, operations),
+    fn=lambda numbers, operations: calculate_array(parse_number_list(numbers), parse_operation_list(operations)),
     inputs=[
         gr.Textbox(label="Numbers (comma-separated, e.g. 2, 3, 4)"),
         gr.Textbox(label="Operations (comma-separated, e.g. add, multiply)")
     ],
     outputs="text",
     title="Array Calculation",
-    description="Calculate a sequence of numbers with specified operations. Example: Numbers: 2, 3, 4; Operations: add, multiply → (2 + 3) * 4"
+    description="Calculate a sequence of numbers with specified operations.\n\n**Description:**\nThis tool takes a list of numbers and a list of operations (add, subtract, multiply, divide) and computes the result step by step.\n\n**Examples:**\n- Numbers: 2, 3, 4; Operations: add, multiply → (2 + 3) * 4 = 20\n- Numbers: 10, 2, 3; Operations: subtract, divide → (10 - 2) / 3 = 2.666...\n- Numbers: 5, 0; Operations: divide → 5 / 0 = Error: Division by zero",
+    examples=[["2, 3, 4", "add, multiply"], ["10, 2, 3", "subtract, divide"], ["5, 0", "divide"]],
 )

maths/arithmetic/calculate_array_with_visualization.py

@@ -57,5 +57,6 @@ array_calc_vis_interface = gr.Interface(
     ],
     outputs=[gr.Textbox(label="Result"), gr.Plot(label="Visualization")],
     title="Array Calculation with Visualization",
-    description="Calculate a sequence of numbers with specified operations and see a number line visualization."
+    description="Calculate a sequence of numbers with specified operations and see a number line visualization.\n\n**Description:**\nThis tool takes a list of numbers and a list of operations (add, subtract, multiply, divide), computes the result step by step, and visualizes the process on a number line.\n\n**Examples:**\n- Numbers: 2, 3, 4; Operations: add, multiply → (2 + 3) * 4 = 20\n- Numbers: 10, 2, 3; Operations: subtract, divide → (10 - 2) / 3 = 2.666...\n- Numbers: 5, 0; Operations: divide → 5 / 0 = Error: Division by zero",
+    examples=[["2, 3, 4", "add, multiply"], ["10, 2, 3", "subtract, divide"], ["5, 0", "divide"]],
 )

maths/arithmetic/divide.py

@@ -16,5 +16,6 @@ divide_interface = gr.Interface(
     inputs=[gr.Number(label="A"), gr.Number(label="B")],
     outputs="text",
     title="Division",
-    description="Divide two numbers"
+    description="Divide two numbers.\n\n**Description:**\nThis tool takes two numbers as input and returns the result of dividing A by B.\n\n**Examples:**\n- Input: 6, 3 → Output: 2\n- Input: 5, 2 → Output: 2.5\n- Input: 7, 0 → Output: Error: Division by zero",
+    examples=[[6, 3], [5, 2], [7, 0]],
 )

maths/arithmetic/multiply.py

@@ -14,5 +14,6 @@ multiply_interface = gr.Interface(
     inputs=[gr.Number(label="A"), gr.Number(label="B")],
     outputs="number",
     title="Multiplication",
-    description="Multiply two numbers"
+    description="Multiply two numbers.\n\n**Description:**\nThis tool takes two numbers as input and returns their product.\n\n**Examples:**\n- Input: 2, 3 → Output: 6\n- Input: -1.5, 4 → Output: -6\n- Input: 0, 5 → Output: 0",
+    examples=[[2, 3], [-1.5, 4], [0, 5]],
 )

maths/arithmetic/subtract.py

@@ -14,5 +14,6 @@ subtract_interface = gr.Interface(
     inputs=[gr.Number(label="A"), gr.Number(label="B")],
     outputs="number",
     title="Subtraction",
-    description="Subtract two numbers"
+    description="Subtract two numbers.\n\n**Description:**\nThis tool takes two numbers as input and returns their difference (A - B).\n\n**Examples:**\n- Input: 5, 3 → Output: 2\n- Input: -1.5, 4.2 → Output: -5.7\n- Input: 0, 0 → Output: 0",
+    examples=[[5, 3], [-1.5, 4.2], [0, 0]],
 )