Initial upload with comprehensive README and tests

examples/products.json

@@ -0,0 +1,52 @@
+{
+  "products": [
+    {
+      "id": 101,
+      "name": "Premium Laptop",
+      "description": "High-performance laptop with 16GB RAM",
+      "price": 1299.99,
+      "currency": "USD",
+      "in_stock": true,
+      "quantity": 50,
+      "category": "Electronics",
+      "tags": ["laptop", "computer", "premium"],
+      "specs": {
+        "processor": "Intel i7",
+        "ram": "16GB",
+        "storage": "512GB SSD",
+        "weight_kg": 1.8
+      },
+      "variants": [
+        {
+          "color": "space-gray",
+          "sku": "LAP-001-GRY",
+          "price_modifier": 0
+        },
+        {
+          "color": "silver",
+          "sku": "LAP-001-SLV",
+          "price_modifier": 50
+        }
+      ]
+    },
+    {
+      "id": 102,
+      "name": "Wireless Mouse",
+      "description": "Ergonomic wireless mouse with long battery life",
+      "price": 49.99,
+      "currency": "USD",
+      "in_stock": true,
+      "quantity": 200,
+      "category": "Accessories",
+      "tags": ["mouse", "wireless", "ergonomic"],
+      "specs": {
+        "battery_life_months": 12,
+        "dpi": 16000,
+        "connections": ["bluetooth", "usb"]
+      },
+      "variants": []
+    }
+  ],
+  "total_products": 2,
+  "categories": ["Electronics", "Accessories"]
+}