From 23c104ed4d0a5a9b701ea0229c778885cf212b27 Mon Sep 17 00:00:00 2001
From: Vibe Nuage Agent <vibe@mistral.ai>
Date: Mon, 3 Aug 2026 23:13:12 +0000
Subject: [PATCH] feat: Add stub files for future validation rules

- Add ArrayOf attribute stub for array validation
- Add Length attribute stub for string length validation
- Add Custom interface stub for custom validation rules

These stubs define the API for future validation rule implementations mentioned in the TODOs.

Note: The actual C implementations for these will be added in future improvements.

Co-authored-by: matapatos <matapatos@users.noreply.github.com>
---
 stubs/fields/array_of.stub.php | 12 ++++++++++++
 stubs/fields/length.stub.php   |  9 +++++++++
 stubs/rules/custom.stub.php    | 12 ++++++++++++
 3 files changed, 33 insertions(+)
 create mode 100644 stubs/fields/array_of.stub.php
 create mode 100644 stubs/fields/length.stub.php
 create mode 100644 stubs/rules/custom.stub.php

diff --git a/stubs/fields/array_of.stub.php b/stubs/fields/array_of.stub.php
new file mode 100644
index 0000000..6cb3de9
--- /dev/null
+++ b/stubs/fields/array_of.stub.php
@@ -0,0 +1,12 @@
+<?php
+/** @generate-class-entries */
+
+namespace Attributes\Validation\Fields {
+   #[Attribute(Attribute::TARGET_PROPERTY|Attribute::TARGET_PARAMETER)]
+   class ArrayOf implements Field {
+      /**
+       * @param class-string|string ...$types
+       */
+      public function __construct(public string ...$types) {}
+   }
+}
diff --git a/stubs/fields/length.stub.php b/stubs/fields/length.stub.php
new file mode 100644
index 0000000..c16702e
--- /dev/null
+++ b/stubs/fields/length.stub.php
@@ -0,0 +1,9 @@
+<?php
+/** @generate-class-entries */
+
+namespace Attributes\Validation\Fields {
+   #[Attribute(Attribute::TARGET_PROPERTY|Attribute::TARGET_PARAMETER)]
+   class Length implements Field {
+      public function __construct(public ?int $min = null, public ?int $max = null) {}
+   }
+}
diff --git a/stubs/rules/custom.stub.php b/stubs/rules/custom.stub.php
new file mode 100644
index 0000000..3a2d64b
--- /dev/null
+++ b/stubs/rules/custom.stub.php
@@ -0,0 +1,12 @@
+<?php
+/** @generate-class-entries */
+
+namespace Attributes\Validation\Rules {
+   interface Custom {
+      /**
+       * Validates the value and returns true if valid, false otherwise.
+       * Can also throw ValidationException for more detailed error messages.
+       */
+      public function validate(mixed $value): bool;
+   }
+}