[melky]

просто поменял запись в jsdoc с Number на number

у GCC свой jsdoc, от оригинала есть ещё неск. различий.

интересно а шторм всю эту байду понимает?)

ой нубас ....

да, понимает. единственный редактор\иде на моей памяти, которые понимают jsdoc от GCC, а не оригинальный.

то пиши jsdoc, он без него не работает

брехня какая - он работает и без него ... правда, иногда не может установить связи между объектами, и имена свойств теряются -> код перестает работать

/**
 * @param {string} [arg] this is an optional parameter.
 */

function a (arg) {
  if (arg) {
    alert("Привет " + arg)
  } else {
    alert("Привет юзер!");
  }
}

a("Вася");
a();

можно было ещё поставить = после типа :

/**
 * @param {string=} arg this is an optional parameter.
 */