📝 Add JSDoc to variable interfaces

JSDoc written in the implementation is not referenced from LSP etc.

Author: Milly

denops_std/variable/types.ts

@@ -1,21 +1,46 @@
 import type { Denops } from "https://deno.land/x/denops_core@v4.0.0/mod.ts";
 
+/**
+ * Represents a getter method for retrieving property value.
+ */
 export type Getter = {
-  get<T = unknown>(
-    denops: Denops,
-    prop: string,
-    defaultValue: T,
-  ): Promise<T>;
-  get<T = unknown>(
-    denops: Denops,
-    prop: string,
-  ): Promise<T | null>;
+  /**
+   * Gets the value of the specified property, or default value if it doesn't exist.
+   * @param prop - The name of the property.
+   * @param defaultValue - The default value to be returned if the property doesn't exist.
+   * @returns A promise that resolves to the value of the property.
+   */
+  get<T = unknown>(denops: Denops, prop: string, defaultValue?: T): Promise<T>;
+
+  /**
+   * Gets the value of the specified property, or null if it doesn't exist.
+   * @param prop - The name of the property.
+   * @returns A promise that resolves to the value of the property.
+   */
+  get<T = unknown>(denops: Denops, prop: string): Promise<T | null>;
 };
 
+/**
+ * Represents a setter method for setting property value.
+ */
 export type Setter = {
+  /**
+   * Sets the value of the specified property.
+   * @param prop - The name of the property.
+   * @param value - The value to be set.
+   * @returns A promise that resolves when the value has been set.
+   */
   set<T = unknown>(denops: Denops, prop: string, value: T): Promise<void>;
 };
 
+/**
+ * Represents a remover method for removing property value.
+ */
 export type Remover = {
+  /**
+   * Removes the value of the specified property or resets to its default value.
+   * @param prop - The name of the property.
+   * @returns A promise that resolves when the value has been removed or reset.
+   */
   remove(denops: Denops, prop: string): Promise<void>;
 };