refactor: susun semula struktur folder — Laravel source ke src/

vendor/laravel/mcp/src/Server/Completions/CompletionResponse.php

@@ -0,0 +1,90 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Laravel\Mcp\Server\Completions;
+
+use Illuminate\Contracts\Support\Arrayable;
+use InvalidArgumentException;
+use UnitEnum;
+
+/**
+ * @implements Arrayable<string, mixed>
+ */
+abstract class CompletionResponse implements Arrayable
+{
+    protected const MAX_VALUES = 100;
+
+    /**
+     * @param  array<int, string>  $values
+     */
+    public function __construct(
+        protected array $values,
+        protected bool $hasMore = false,
+    ) {
+        if (count($values) > self::MAX_VALUES) {
+            throw new InvalidArgumentException(
+                sprintf('Completion values cannot exceed %d items (received %d)', self::MAX_VALUES, count($values))
+            );
+        }
+    }
+
+    public static function empty(): CompletionResponse
+    {
+        return new DirectCompletionResponse([]);
+    }
+
+    /**
+     * @param  array<int, string>|class-string<UnitEnum>  $items
+     */
+    public static function match(array|string $items): CompletionResponse
+    {
+        if (is_string($items)) {
+            return new EnumCompletionResponse($items);
+        }
+
+        return new ArrayCompletionResponse($items);
+    }
+
+    /**
+     * @param  array<int, string>|string  $items
+     */
+    public static function result(array|string $items): CompletionResponse
+    {
+        if (is_array($items)) {
+            $hasMore = count($items) > self::MAX_VALUES;
+            $truncated = array_slice($items, 0, self::MAX_VALUES);
+
+            return new DirectCompletionResponse($truncated, $hasMore);
+        }
+
+        return new DirectCompletionResponse([$items], false);
+    }
+
+    abstract public function resolve(string $value): CompletionResponse;
+
+    /**
+     * @return array<int, string>
+     */
+    public function values(): array
+    {
+        return $this->values;
+    }
+
+    public function hasMore(): bool
+    {
+        return $this->hasMore;
+    }
+
+    /**
+     * @return array{values: array<int, string>, total: int, hasMore: bool}
+     */
+    public function toArray(): array
+    {
+        return [
+            'values' => $this->values,
+            'total' => count($this->values),
+            'hasMore' => $this->hasMore,
+        ];
+    }
+}