feat: add insertTextFormat property to CompletionItem (#11)

Author: iluuu1994

src/CompletionItem.php

@@ -96,6 +96,15 @@ class CompletionItem
      */
     public $data;
 
+    /**
+     * The format of the insert text. The format applies to both the `insertText` property
+     * and the `newText` property of a provided `textEdit`.
+     *
+     * @var int|null
+     * @see InsertTextFormat
+     */
+    public $insertTextFormat;
+
     /**
      * @param string          $label
      * @param int|null        $kind
@@ -108,6 +117,7 @@ class CompletionItem
      * @param TextEdit[]|null $additionalTextEdits
      * @param Command|null    $command
      * @param mixed|null      $data
+     * @param int|null        $insertTextFormat
      */
     public function __construct(
         string $label = null,
@@ -120,7 +130,8 @@ public function __construct(
         TextEdit $textEdit = null,
         array $additionalTextEdits = null,
         Command $command = null,
-        $data = null
+        $data = null,
+        int $insertTextFormat = null
     ) {
         $this->label = $label;
         $this->kind = $kind;
@@ -133,5 +144,6 @@ public function __construct(
         $this->additionalTextEdits = $additionalTextEdits;
         $this->command = $command;
         $this->data = $data;
+        $this->insertTextFormat = $insertTextFormat;
     }
 }

src/InsertTextFormat.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace LanguageServerProtocol;
+
+/**
+ * Defines whether the insert text in a completion item should be interpreted as
+ * plain text or a snippet.
+ */
+class InsertTextFormat
+{
+    /**
+     * The primary text to be inserted is treated as a plain string.
+     */
+    const PLAIN_TEXT = 1;
+
+    /**
+     * The primary text to be inserted is treated as a snippet.
+     *
+     * A snippet can define tab stops and placeholders with `$1`, `$2`
+     * and `${3:foo}`. `$0` defines the final tab stop, it defaults to
+     * the end of the snippet. Placeholders with equal identifiers are linked,
+     * that is typing in one will update others too.
+     */
+    const SNIPPET = 2;
+}