First Commit

2026-07-03 16:27:34 +02:00
commit 7a7440daab
8955 changed files with 1117958 additions and 0 deletions
@@ -0,0 +1,122 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\CssSelector\XPath;
+
+/**
+ * XPath expression translator interface.
+ *
+ * This component is a port of the Python cssselect library,
+ * which is copyright Ian Bicking, @see https://github.com/SimonSapin/cssselect.
+ *
+ * @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
+ *
+ * @internal
+ */
+class XPathExpr
+{
+    public function __construct(
+        private string $path = '',
+        private string $element = '*',
+        private string $condition = '',
+        bool $starPrefix = false,
+    ) {
+        if ($starPrefix) {
+            $this->addStarPrefix();
+        }
+    }
+
+    public function getElement(): string
+    {
+        return $this->element;
+    }
+
+    /**
+     * @return $this
+     */
+    public function addCondition(string $condition, string $operator = 'and'): static
+    {
+        $this->condition = $this->condition ? \sprintf('(%s) %s (%s)', $this->condition, $operator, $condition) : $condition;
+
+        return $this;
+    }
+
+    public function getCondition(): string
+    {
+        return $this->condition;
+    }
+
+    /**
+     * @return $this
+     */
+    public function addNameTest(): static
+    {
+        if ('*' !== $this->element) {
+            $this->addCondition('name() = '.Translator::getXpathLiteral($this->element));
+            $this->element = '*';
+        }
+
+        return $this;
+    }
+
+    /**
+     * @return $this
+     */
+    public function addStarPrefix(): static
+    {
+        $this->path .= '*/';
+
+        return $this;
+    }
+
+    /**
+     * Joins another XPathExpr with a combiner.
+     *
+     * When $hasInnerConditions is true, $expr->condition is folded into $expr->element as a
+     * "[...]" predicate rather than onto $this->condition, so subsequent addCondition() calls
+     * on $this are not AND'd with it. Needed for relative selectors inside :has().
+     *
+     * @return $this
+     */
+    public function join(string $combiner, self $expr, ?string $closingCombiner = null, bool $hasInnerConditions = false): static
+    {
+        $path = $this->__toString().$combiner;
+
+        if ('*/' !== $expr->path) {
+            $path .= $expr->path;
+        }
+
+        $this->path = $path;
+
+        if (!$hasInnerConditions) {
+            $this->element = $expr->element.($closingCombiner ?? '');
+            $this->condition = $expr->condition;
+        } else {
+            $this->element = $expr->element;
+            if ($expr->condition) {
+                $this->element .= '['.$expr->condition.']';
+            }
+            if ($closingCombiner) {
+                $this->element .= $closingCombiner;
+            }
+        }
+
+        return $this;
+    }
+
+    public function __toString(): string
+    {
+        $path = $this->path.$this->element;
+        $condition = '' === $this->condition ? '' : '['.$this->condition.']';
+
+        return $path.$condition;
+    }
+}