К примеру, если вы используете VS Code, вы можете добавить в начале вашего js-файла:

// @ts-check

Либо эту опцию можно включить для всех js-файлов по умолчанию (рекомендую). Это можно сделать в настройках воркспейса либо глобально во всем редакторе. После чего, вы сможете использовать аннотации типов в формате JSDoc:

/**
* @param {Object} src
* @param {String} src.uid
* @param {Number} src.date
* @param {String} [src.detail] необязательный параметр
*
* @returns {String}
*/
function myFunction(src) {
  ...
};

Существует и более компактный формат, но за нюансами — лучше сходить в доки.

В любом месте использования вы будете видеть сигнатуру вашей функции и ошибки при попытке сделать что-то неправильно. Ну и так далее: примитивы, пользовательские типы, все что нужно будет проверяться и подсвечиваться. Далее вкусовщина — на мой взгляд, аннотации в формате комментов делают сам код более чистым и читаемым в части логики. А главное, он работает в браузере в исходном виде. После того как привыкаешь — код на TS кажется излишне замусоренным и избыточным.

А можно подробней про минусы phalcon? Почему сейчас нет особого смысле в нем?