Вышел clojurescript-0.0-2719

Сторонние библиотеки

Но ClojureScript не планировал быть изолированным от экосистемы JavaScript, так же как и Clojure от JVM платформы, стараясь использовать все ее преемущества. Но до последнего времени эта цель жертвовалась в угоду достижения оптимизации при компиляции. Google Closure Compiler позволяет делать очень глубокую оптимизацию кода (в частности, отсекая неиспользуемый код библиотек и тем самым значительно сокращая объем кода, подлежащего минификации и передаче на клиент). Однако, это создавало трудности при подключении библиотек, несовместимых с ним. На мимуточку, среди них jQuery, React, D3 и другие. Тем, кто не застал “темные времена”, можно почитать о способах подключения сторонних зависимостей из-за требовательного Google Closure Compiler и об использовании jQuery, в частности.

Все, хватит сложностей

0.0-2719 полностью поддерживает подключение любых библиотек, используя опробованные годами: deps.cljs и опцию :foreign-libs.

deps.cljs - это EDN файл-манифест в корне jar-файла с дополнительной информацией для компилятора. Например, для react.jar пакета он выглядит так:

{:foreign-libs [{:file     "react/react.js"
                 :file-min "react/react.min.js"
                 :provides ["com.facebook.React"]}
                {:file     "react/react_with_addons.js"
                 :file-min "react/react_with_addons.min.js"
                 :provides ["com.facebook.ReactWithAddons"]}]
 :externs ["react/externs/react.js"]}

В этом файле все, что нужно для всех способов компиляции и REPL’а.

Пример использования:

(ns foo.bar
    (:require com.facebook.React))

(enable-console-print!)

(println
    (. js/React
       (renderToString
         (. js/React (DOM.div nil "Hello!")))))

В REPL:

cljs.user> (require 'com.facebook.React)
cljs.user> (. js/React 
            (renderToString 
              (. js/React (DOM.div nil "Hello!"))))

Теперь не надо:

подключать <script> в режиме разработки
располагать эти скрипты в нужном порядке
добавлять React в :preamble при :advanced компиляции (которое форсировало его появление в начале всех скомпилированных файлов)
явно указывать :externs

Однако, теперь все библиотеки для ClojureScript должны быть запакованы в jar, который содержит такой файл.

Почему не Bower?

Некоторые вполне обоснованно спросят, почему бы не использовать проверенные решения для управления js-зависимостями, например, Bower?

Во-первых, Bower требует nodejs-платформу, тогда как ClojureScript рассматривает NodeJs как опциональную, одну из платформ.
Bower создан для управления зависимостями, однако в Clojure экосистеме этой цели уже служит Maven, а теперь он будет делать то же для ClojureScript.
Наконец, Bower не решает проблему динамической подгрузки библиотек, и это непросто, так как JavaScript библиотеки используют разные решения (CommonJS, AMD), а некоторые вообще не оформлены как модуль, заставляя пользователей по-старинке подключать их как <script> на страницу. Текущее решение устраняет “парадокс выбора”.

Что теперь?

Теперь, когда мы приступили к снятию сильнейшей боли от разработки, остается запаковать самые популярные JavaScript библиотеки, которые устраняют пробелы в ClojureScript экосистеме.

Надо собраться и сделать. Необходима обратная связь. Это серьезное изменение и команда разработчиков стремится отполировать изменения как можно скорее.

Что еще поменялось?

CLJS-985: ex-info теперь не теряет стектрейс
CLJS-984: REPL использует публичное API NodeJs
CLJS-963: не геренируется goog/dep.js при уровне оптимизации :none

Исправленные баги