From 1ff5c35de5dbd70a782875a91dd2232fd01b002b Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sun, 28 Apr 2024 14:38:04 +0200
Subject: Adding upstream version 0.10.1.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 vendor/ipl/html/src/Contract/FormElement.php       | 125 +++++++++++++++++++++
 .../ipl/html/src/Contract/FormElementDecorator.php |  18 +++
 vendor/ipl/html/src/Contract/FormSubmitElement.php |  13 +++
 vendor/ipl/html/src/Contract/ValueCandidates.php   |  22 ++++
 vendor/ipl/html/src/Contract/Wrappable.php         |  45 ++++++++
 5 files changed, 223 insertions(+)
 create mode 100644 vendor/ipl/html/src/Contract/FormElement.php
 create mode 100644 vendor/ipl/html/src/Contract/FormElementDecorator.php
 create mode 100644 vendor/ipl/html/src/Contract/FormSubmitElement.php
 create mode 100644 vendor/ipl/html/src/Contract/ValueCandidates.php
 create mode 100644 vendor/ipl/html/src/Contract/Wrappable.php

(limited to 'vendor/ipl/html/src/Contract')

diff --git a/vendor/ipl/html/src/Contract/FormElement.php b/vendor/ipl/html/src/Contract/FormElement.php
new file mode 100644
index 0000000..6aa1456
--- /dev/null
+++ b/vendor/ipl/html/src/Contract/FormElement.php
@@ -0,0 +1,125 @@
+<?php
+
+namespace ipl\Html\Contract;
+
+use ipl\Html\Attributes;
+use ipl\Html\Form;
+
+/**
+ * Representation of form elements
+ */
+interface FormElement extends Wrappable
+{
+    /**
+     * Get the attributes or options of the element
+     *
+     * @return Attributes
+     */
+    public function getAttributes();
+
+    /**
+     * Add attributes or options to the form element
+     *
+     * @param iterable $attributes
+     *
+     * @return $this
+     */
+    public function addAttributes($attributes);
+
+    /**
+     * Get the description for the element, if any
+     *
+     * @return string|null
+     */
+    public function getDescription();
+
+    /**
+     * Get the label for the element, if any
+     *
+     * @return string|null
+     */
+    public function getLabel();
+
+    /**
+     * Get the validation error messages
+     *
+     * @return array
+     */
+    public function getMessages();
+
+    /**
+     * Add a validation error message
+     *
+     * @param string $message
+     *
+     * @return $this
+     */
+    public function addMessage($message);
+
+    /**
+     * Get the name of the element
+     *
+     * @return string
+     */
+    public function getName();
+
+    /**
+     * Get whether the element has a value
+     *
+     * @return bool False if the element's value is null, the empty string or the empty array; true otherwise
+     */
+    public function hasValue();
+
+    /**
+     * Get the value of the element
+     *
+     * @return mixed
+     */
+    public function getValue();
+
+    /**
+     * Set the value of the element
+     *
+     * @param mixed $value
+     *
+     * @return $this
+     */
+    public function setValue($value);
+
+    /**
+     * Get whether the element has been validated
+     *
+     * @return bool
+     */
+    public function hasBeenValidated();
+
+    /**
+     * Get whether the element is ignored
+     *
+     * @return bool
+     */
+    public function isIgnored();
+
+    /**
+     * Get whether the element is required
+     *
+     * @return bool
+     */
+    public function isRequired();
+
+    /**
+     * Get whether the element is valid
+     *
+     * @return bool
+     */
+    public function isValid();
+
+    /**
+     * Handler which is called after this element has been registered
+     *
+     * @param Form $form
+     *
+     * @return void
+     */
+    public function onRegistered(Form $form);
+}
diff --git a/vendor/ipl/html/src/Contract/FormElementDecorator.php b/vendor/ipl/html/src/Contract/FormElementDecorator.php
new file mode 100644
index 0000000..1e862bb
--- /dev/null
+++ b/vendor/ipl/html/src/Contract/FormElementDecorator.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace ipl\Html\Contract;
+
+use ipl\Html\ValidHtml;
+
+/**
+ * Representation of form element decorators
+ */
+interface FormElementDecorator extends ValidHtml
+{
+    /**
+     * Decorate the given form element
+     *
+     * @param FormElement $formElement
+     */
+    public function decorate(FormElement $formElement);
+}
diff --git a/vendor/ipl/html/src/Contract/FormSubmitElement.php b/vendor/ipl/html/src/Contract/FormSubmitElement.php
new file mode 100644
index 0000000..4909df8
--- /dev/null
+++ b/vendor/ipl/html/src/Contract/FormSubmitElement.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace ipl\Html\Contract;
+
+interface FormSubmitElement extends FormElement
+{
+    /**
+     * Get whether the element has been pressed
+     *
+     * @return bool
+     */
+    public function hasBeenPressed();
+}
diff --git a/vendor/ipl/html/src/Contract/ValueCandidates.php b/vendor/ipl/html/src/Contract/ValueCandidates.php
new file mode 100644
index 0000000..0271500
--- /dev/null
+++ b/vendor/ipl/html/src/Contract/ValueCandidates.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace ipl\Html\Contract;
+
+interface ValueCandidates
+{
+    /**
+     * Get value candidates of this element
+     *
+     * @return array
+     */
+    public function getValueCandidates();
+
+    /**
+     * Set value candidates of this element
+     *
+     * @param array $values
+     *
+     * @return $this
+     */
+    public function setValueCandidates(array $values);
+}
diff --git a/vendor/ipl/html/src/Contract/Wrappable.php b/vendor/ipl/html/src/Contract/Wrappable.php
new file mode 100644
index 0000000..c8cf924
--- /dev/null
+++ b/vendor/ipl/html/src/Contract/Wrappable.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace ipl\Html\Contract;
+
+use ipl\Html\ValidHtml;
+
+/**
+ * Representation of wrappable elements
+ */
+interface Wrappable extends ValidHtml
+{
+    /**
+     * Get the wrapper, if any
+     *
+     * @return Wrappable|null
+     */
+    public function getWrapper();
+
+    /**
+     * Set the wrapper
+     *
+     * @param Wrappable $wrapper
+     *
+     * @return $this
+     */
+    public function setWrapper(Wrappable $wrapper);
+
+    /**
+     * Add a wrapper
+     *
+     * @param Wrappable $wrapper
+     *
+     * @return $this
+     */
+    public function addWrapper(Wrappable $wrapper);
+
+    /**
+     * Prepend a wrapper
+     *
+     * @param Wrappable $wrapper
+     *
+     * @return $this
+     */
+    public function prependWrapper(Wrappable $wrapper);
+}
-- 
cgit v1.2.3