Melange 1.0 уже здесь • На пуговицах

Эй, ребята, это что-то особенное.

Команда Melange и я рады объявить сегодня о выпуске Melange 1.0, что является важной вехой в жизни проекта. Этот релиз представляет собой кульминацию многих месяцев напряженной работы и невероятного сотрудничества.

Меланж, который начинался как форк BuckleScript, был создан с целью обеспечения совместимости с OCaml и предоставления наилучших возможностей OCaml в рамках современной экосистемы JavaScript. Сегодня мы с гордостью представляем Melange 1.0, зрелый и надежный инструмент для компиляции OCaml в эффективный и удобочитаемый JavaScript, на который полагаются команды. для доставки сложных приложений OCaml / ReasonML.

Получи это сейчас:

$ opam install melange.1.0.0

Основные моменты

Melange 1.0 радикально улучшает пользовательский опыт. В этом выпуске основное внимание уделяется надежности, совместимости с OCaml и опыту разработчиков: Melange полностью охватывает Платформа OCaml чтобы пользователям OCaml было легко и надежно ориентироваться на JavaScript.

Интеграция с дюнами

Интеграция с Dune была нашим главным приоритетом. Дюна 3.8выпущенный совсем недавно, добавляет поддержку Melange за счет понимания следующих типов строф:

(library
  (modes melange) ;; <- new Melange mode
)

;; emit JS to `js-output` folder in this 
;; directory
(melange.emit
 (target js-output))

В Melange 1.0 интеграция с Dune является официально поддерживаемым рабочим процессом для создания проектов Melange. Он обеспечивает надежную генерацию правил, поддержку статических ресурсов (ваш HTML / CSS / SVG / изображения), бесшовную интеграцию с редактором (например, с OCaml LSP или Merlin).

Документация

С Melange 1.0 мы также начинаем новую работу по документации, меланж.ре. Этот веб-сайт в настоящее время считается незавершенным, и мы ищем отзывы о том, как лучше всего объяснить рабочий процесс Melange и его доступные функции. Смело обращайтесь в репозиторий OSS.

Кроме того, документация Dune включает Справочные материалы специально для использования Melange с Dune.

Все остальное

Расширенная поддержка версий OCaml

Ранее Melange был доступен только на OCaml 4.14. В этом выпуске мы расширили этот диапазон до версий OCaml, начиная с версии 4.13. Это включает в себя линию выпуска OCaml 5 и позволяет проектам Melange использовать тот же переключатель компилятора OCaml, что и, например, проекты на стороне сервера.

Интеграция с редактором — единственное предостережение: она работает только на OCaml 4.14, так как Melange испускает .cmt артефакты (используется, например, LSP) для двоичного формата OCaml 4.14.

Несколько синтаксисов

Дюна поддерживает ReasonML из коробки через диалекты, сохраняя поддержку ReasonML в Melange неизменной с точки зрения пользователя. Однако внутри Melange 1.0 отказался от каких-либо знаний о ReasonML, вместо этого полагаясь на существующую, проверенную в боевых условиях поддержку диалектов Dune.

А rescript-syntax package также является частью выпуска Melange. Он включает поддержку синтаксиса ReScript в Melange, который также поддерживает Dune. Имейте в виду, однако, что новые функции ReScript вряд ли будут поддерживаться этим пакетом максимальной совместимости.

Отдельный PPX

Большим преимуществом глубокой интеграции с платформой OCaml является возможность предполагать наличие собственного набора инструментов. Это позволило разделить дистрибутив Melange на несколько отдельных компонентов.

Меланж теперь поставляется с melange.ppx препроцессор на основе Ppxlib что можно добавить к (preprocess (pps melange.ppx))согласно Спецификация предварительной обработки Dune.

React JS PPX (для Reason + JSX) также был извлечен и теперь распространяется отдельно как reactjs-jsx-ppx.

Включение современных рабочих процессов JS

Дизайн Melange в Dune был разработан с самого первого дня с целью охвата платформы JavaScript:

• Интеграция с Dune генерирует файлы JavaScript предсказуемым образом.
• Для отработки современных рабочих процессов Melange был протестирован в Next.js приложение, использующее Компоненты сервера Reactи доступные конструкции были сочтены достаточными для реализации аналогичных вариантов использования.

Полный список изменений:

Полный список изменений можно посмотреть здесь.

Поддержка и спонсорство

Работа над этим релизом была бы невозможна без поддержки многих.

Мы благодарим всех, кто сделал это возможным:

Мы также хотели бы поблагодарить следующих известных участников этого выпуска:

• Rudi Grinbergза его незаменимые советы и указания по разработке и внедрению интеграции с Dune.
• Хавьер Чаварриза миграцию огромной производственной кодовой базы Ahrefs в Melange, работу над интеграцией Dune, работу над документацией Melange и предоставление важной обратной связи по проекту.
• Дэвид Санчоза опробование наших самых передовых идей и ранние отзывы о том, как продвигаться вперед с помощью способов, охватывающих всю экосистему.

С нетерпением жду

Мы в восторге от достигнутого нами прогресса и положительных отзывов, которые мы получили от сообщества. Мы по-прежнему привержены постоянному совершенствованию Melange, чтобы он оставался надежным и эффективным инструментом для разработчиков OCaml, ориентированных на платформу JavaScript.

Наш Дорожная карта на второй квартал 2023 года включает в себя большинство целей, которые мы поставили перед собой за последние несколько месяцев, и некоторые из того, над чем мы думаем работать в предстоящие месяцы. Melange 1.0 знаменует собой только начало нашего пути к лучшему опыту работы с OCaml на платформе JS.

Наконец, мы хотели бы выразить нашу глубочайшую благодарность всем, кто поддержал проект, будь то путем добавления кода, тестирования или предоставления отзывов. Это и ваше достижение, и наше, и мы с нетерпением ждем продолжения этого пути вместе.

Спасибо,

Антонио и команда Melange

PS: Если вы хотите попробовать Melange, ответьте на это письмо. Я хотел бы услышать от вас!