Cleanup some JSDoc comments

Author: efoken

jsx-runtime.js

@@ -3,10 +3,9 @@ import { createElement } from "./src/core.js";
 export { Fragment } from "./src/core.js";
 
 /**
- *
  * @param {any} type
  * @param {any} props
- * @param {any} [key ]
+ * @param {any} [key]
  * @returns
  */
 export const jsx = (type, props, key) => {

src/context.js

@@ -65,7 +65,6 @@ export const useConsumer = (id) => {
 };
 
 /**
- *
  * @type {import("context").UseContext}
  */
 export const useContext = (context) => {

src/element/custom-element.js

@@ -6,8 +6,8 @@ import { setPrototype, transformValue } from "./set-prototype.js";
 export { Any, createType } from "./set-prototype.js";
 
 let ID = 0;
+
 /**
- *
  * @param {Element & {dataset?:object}} node
  * @returns {string|number}
  */

src/element/errors.js

@@ -1,6 +1,5 @@
 export class Error {
     /**
-     *
      * @param {HTMLElement} target
      * @param {string} message
      * @param {string} value

src/element/set-prototype.js

@@ -160,7 +160,6 @@ export const transformValue = (type, value) =>
           new type(value);
 
 /**
- *
  * @param {import("schema").TypeCustom<(...args:any)=>any>} TypeCustom
  * @param {*} value
  * @returns
@@ -172,6 +171,7 @@ export const mapValue = ({ map }, value) => {
         return { value, error: true };
     }
 };
+
 /**
  * Filter the values based on their type
  * @param {any} type
@@ -211,6 +211,7 @@ export const createType = (map, serialize) => ({
     map,
     serialize,
 });
+
 /**
  * Type any, used to avoid type validation.
  * @typedef {null} Any

src/hooks/custom-hooks/use-prop.js

@@ -1,7 +1,6 @@
 import { useHost } from "../create-hooks.js";
 
 /**
- *
  * @type {import("core").UseProp}
  */
 export const useProp = (name) => {

src/hooks/custom-hooks/use-suspense.js

@@ -47,19 +47,17 @@ export const useAsync = (callback, args) => {
 };
 
 /**
- *
  * @type {import("core").UseSuspense}
  */
-
 export const useSuspense = (fps = 8) => {
     const host = useHost();
+
     /**
      * @type {import("internal/hooks").ReturnSetStateUseSuspense}
      */
     const [status, setStatus] = useState({ pending: true });
 
     /**
-     *
      * @param {()=>any} callback
      * @param {number} deep
      */
@@ -94,6 +92,7 @@ export const useSuspense = (fps = 8) => {
                 }, fps);
             }
         };
+
         /**
          * @param {Event} event
          */

src/render.js

@@ -226,7 +226,6 @@ function diff(newVnode, node, id = ID, hydrate = false, isSvg = false) {
     return node;
 }
 /**
- *
  * @param {Element|ShadowRoot} parent
  * @param {boolean} [hydrate]
  * @return {import("vnode").Fragment}
@@ -379,7 +378,6 @@ export function renderChildren(children, fragment, parent, id, hydrate, isSvg) {
 }
 
 /**
- *
  * @param {Element} node
  * @param {Object} props
  * @param {Object} nextProps
@@ -397,7 +395,6 @@ export function diffProps(node, props, nextProps, handlers, isSvg) {
 }
 
 /**
- *
  * @param {Element} node
  * @param {string} key
  * @param {any} prevValue
@@ -484,7 +481,6 @@ export function setProperty(node, key, prevValue, nextValue, isSvg, handlers) {
 }
 
 /**
- *
  * @param {Node} node
  * @param {string} type
  * @param {import("vnode").VNodeListener} [nextHandler]
@@ -519,7 +515,6 @@ export function setEvent(node, type, nextHandler, handlers) {
 }
 
 /**
- *
  * @param {*} style
  * @param {string} key
  * @param {string} value

src/utils.js

@@ -33,7 +33,6 @@ export const isObject = (value) => typeof value == "object";
 export const { isArray } = Array;
 
 /**
- *
  * @param {Element & {dataset?:object}} node
  * @returns
  */
@@ -83,7 +82,6 @@ export function flat(list, callback) {
 }
 
 /**
- *
  * @param {Element} target
  * @param {string} type
  * @param {(event:Event)=>void} handler

ssr/load.js

@@ -12,7 +12,6 @@ let ID = 0;
 if (isServer()) setOptions(options);
 
 /**
- *
  * @param {import("../src/options").Options} options
  */
 function setOptions(options) {