remove unwanted comments

src/ListRenderer/ChecklistRenderer.ts

@@ -110,7 +110,7 @@ export class CheckListRenderer implements ListRendererInterface<ChecklistItemMet
  /**
  * Return the item content
  * @param item - item wrapper (<li>)
- * @returns
+ * @returns - item content string
  */
  getItemContent(item: Element): string {
  const contentNode = item.querySelector(`.${CheckListRenderer.CSS.itemContent}`);
@@ -148,8 +148,7 @@ export class CheckListRenderer implements ListRendererInterface<ChecklistItemMet
 
  /**
  * Toggle checklist item state
- * @param checkbox
- * @returns
+ * @param checkbox - checkbox element to be toggled
  */
  private toggleCheckbox(checkbox: Element): void {
  checkbox.classList.toggle(CheckListRenderer.CSS.itemChecked);
@@ -160,9 +159,8 @@ export class CheckListRenderer implements ListRendererInterface<ChecklistItemMet
  /**
  * Removes class responsible for special hover behavior on an item
  * @param el - item wrapper
- * @returns
  */
- private removeSpecialHoverBehavior(el: Element) {
+ private removeSpecialHoverBehavior(el: Element): void {
  el.classList.remove(CheckListRenderer.CSS.noHover);
  }
 }

src/ListRenderer/OrderedListRenderer.ts

@@ -78,7 +78,7 @@ export class OrderedListRenderer implements ListRendererInterface<OrderedListIte
  /**
  * Return the item content
  * @param item - item wrapper (<li>)
- * @returns
+ * @returns - item content string
  */
  getItemContent(item: Element): string {
  const contentNode = item.querySelector(`.${OrderedListRenderer.CSS.itemContent}`);

src/ListRenderer/UnorderedListRenderer.ts

@@ -78,7 +78,7 @@ export class UnorderedListRenderer implements ListRendererInterface<UnorderedLis
  /**
  * Return the item content
  * @param item - item wrapper (<li>)
- * @returns
+ * @returns - item content string
  */
  getItemContent(item: Element): string {
  const contentNode = item.querySelector(`.${UnorderedListRenderer.CSS.itemContent}`);

src/ListTabulator/index.ts

@@ -189,7 +189,6 @@ export default class ListTabulator<Renderer extends ListRenderer> {
  /**
  * The method for recursive collecting of the child items
  * @param parent - where to find items
- * @returns
  */
  const getItems = (parent: ItemChildWrapperElement): ListItem[] => {
  const children = getChildItems(parent);
@@ -327,7 +326,6 @@ export default class ListTabulator<Renderer extends ListRenderer> {
  /**
  * Handle UL, OL and LI tags paste and returns List data
  * @param element - html element that contains whole list
- * @returns
  */
  pasteHandler(element: PasteEvent['detail']['data']): ListData {
  const { tagName: tag } = element;
@@ -381,7 +379,6 @@ export default class ListTabulator<Renderer extends ListRenderer> {
  /**
  * Handles Enter keypress
  * @param event - keydown
- * @returns
  */
  enterPressed(event: KeyboardEvent): void {
  const currentItem = this.currentItem;

src/index.ts

@@ -25,15 +25,13 @@ export type ListParams = BlockToolConstructorOptions<ListData, NestedListConfig>
 export default class NestedList {
  /**
  * Notify core that read-only mode is supported
- * @returns
  */
  static get isReadOnlySupported(): boolean {
  return true;
  }
 
  /**
  * Allow to use native Enter behaviour
- * @returns
  */
  static get enableLineBreaks(): boolean {
  return true;
@@ -43,7 +41,6 @@ export default class NestedList {
  * Get Tool toolbox settings
  * icon - Tool icon's SVG
  * title - title to show in toolbox
- * @returns
  */
  static get toolbox(): ToolboxConfig {
  return {
@@ -54,7 +51,6 @@ export default class NestedList {
 
  /**
  * Get list style name
- * @returns
  */
  get listStyle(): ListDataStyle {
  return this.data.style || this.defaultListStyle;

src/utils/focusItem.ts

@@ -6,7 +6,6 @@ import { getItemContentElement } from './getItemContentElement';
  * Sets focus to the item's content
  * @param item - item (<li>) to select
  * @param atStart - where to set focus: at the start or at the end
- * @returns
  */
 export function focusItem(item: ItemElement, atStart: boolean = true): void {
  const itemContent = getItemContentElement(item);

src/utils/isLastItem.ts

@@ -2,7 +2,7 @@ import type { ItemElement } from '../types/Elements';
 
 /**
  * Check that passed item element is last item of the list
- * @param item
+ * @param item - item to be checked, wherever it has next element sibling
  */
 export function isLastItem(item: ItemElement): boolean {
  return item.nextElementSibling === null;

src/utils/type-guards.ts

@@ -1,7 +1,6 @@
 /**
  * Type guard to check if a node is an HTMLElement, then we can safely use it as an HTMLElement
- * @param node
- * @returns
+ * @param node - Node to be checked, wherever it is an HTMLElement
  */
 export function isHtmlElement(node: Node): node is HTMLElement {
  // node is an HTMLElement if it is an element node