docs: add JSDoc documentation to component modules

- Document input.ts for user input management
- Document list.ts for item display and selection
- Document preview.ts for content preview functionality
- Document help.ts for interactive help system
- Include module-level documentation explaining each component's role

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: lambdalisue

denops/fall/component/help.ts

@@ -1,3 +1,20 @@
+/**
+ * @module component/help
+ *
+ * Help component for the vim-fall picker UI.
+ *
+ * This module provides the HelpComponent class which displays interactive help
+ * information to users. It supports:
+ *
+ * - Multi-page help content with navigation
+ * - Syntax highlighting through decorations
+ * - Dynamic content generation based on current mappings
+ * - Toggle visibility with F1 key
+ *
+ * The help component provides contextual assistance, showing available
+ * keyboard shortcuts and commands for the current picker.
+ */
+
 import type { Denops } from "jsr:@denops/std@^7.3.2";
 import type { Decoration } from "jsr:@denops/std@^7.3.2/buffer";
 import * as mapping from "jsr:@denops/std@^7.3.2/mapping";

denops/fall/component/input.ts

@@ -1,3 +1,13 @@
+/**
+ * @module component/input
+ *
+ * Input component for the vim-fall picker UI.
+ *
+ * This module provides the InputComponent class which manages the user input area
+ * of the picker. It displays the current query, cursor position, collection/processing
+ * status, and provides visual feedback through spinners and status indicators.
+ */
+
 import type { Denops } from "jsr:@denops/std@^7.3.2";
 import * as fn from "jsr:@denops/std@^7.3.2/function";
 import * as buffer from "jsr:@denops/std@^7.3.2/buffer";

denops/fall/component/list.ts

@@ -1,3 +1,20 @@
+/**
+ * @module component/list
+ *
+ * List component for the vim-fall picker UI.
+ *
+ * This module provides the ListComponent class which manages the main list area
+ * of the picker where filtered and rendered items are displayed. It handles:
+ *
+ * - Rendering items with syntax highlighting
+ * - Managing item selection with visual indicators
+ * - Executing commands on the list buffer
+ * - Handling decorations for match highlighting
+ *
+ * The list component works closely with the render processor to display
+ * items in a scrollable, interactive list format.
+ */
+
 import type { Denops } from "jsr:@denops/std@^7.3.2";
 import type { Decoration } from "jsr:@denops/std@^7.3.2/buffer";
 import { batch } from "jsr:@denops/std@^7.3.2/batch";

denops/fall/component/preview.ts

@@ -1,3 +1,20 @@
+/**
+ * @module component/preview
+ *
+ * Preview component for the vim-fall picker UI.
+ *
+ * This module provides the PreviewComponent class which displays previews of
+ * selected items in the picker. It supports:
+ *
+ * - Content preview with optional syntax highlighting
+ * - Cursor positioning at specific lines/columns
+ * - File type detection for proper highlighting
+ * - Command execution within the preview context
+ *
+ * The preview component enhances the user experience by showing item details
+ * before selection, making it easier to identify the desired item.
+ */
+
 import type { Denops } from "jsr:@denops/std@^7.3.2";
 import * as fn from "jsr:@denops/std@^7.3.2/function";
 import * as buffer from "jsr:@denops/std@^7.3.2/buffer";