Add deps-new, sci (#12)

Author: sritchie

.clj-kondo/babashka/fs/config.edn

@@ -0,0 +1 @@
+{:lint-as {babashka.fs/with-temp-dir clojure.core/let}}

.clj-kondo/babashka/sci/config.edn

@@ -0,0 +1 @@
+{:hooks {:macroexpand {sci.core/copy-ns sci.core/copy-ns}}}

.clj-kondo/babashka/sci/sci/core.clj

@@ -0,0 +1,9 @@
+(ns sci.core)
+
+(defmacro copy-ns
+  ([ns-sym sci-ns]
+   `(copy-ns ~ns-sym ~sci-ns nil))
+  ([ns-sym sci-ns opts]
+   `[(quote ~ns-sym)
+     ~sci-ns
+     (quote ~opts)]))

.clj-kondo/nextjournal/clerk/config.edn

@@ -0,0 +1,13 @@
+{:config-in-call {nextjournal.clerk.viewer/->viewer-fn {:linters {:unresolved-symbol {:exclude [clj->js]}
+                                                                  :unresolved-namespace {:exclude [nextjournal.clerk.render
+                                                                                                   nextjournal.clerk.render.code
+                                                                                                   nextjournal.clerk.render.hooks
+                                                                                                   js]}}}
+                  nextjournal.clerk.viewer/->viewer-eval {:linters {:unresolved-symbol {:exclude [clj->js]}
+                                                                    :unresolved-namespace {:exclude [nextjournal.clerk.render
+                                                                                                     nextjournal.clerk.render.code
+                                                                                                     nextjournal.clerk.render.hooks
+                                                                                                     js]}}}}
+ :hooks {:analyze-call {nextjournal.clerk.viewer/->viewer-fn nextjournal.clerk.viewer/->viewer-fn
+                        nextjournal.clerk.viewer/->viewer-eval nextjournal.clerk.viewer/->viewer-fn}}
+ :lint-as {nextjournal.clerk/defcached clojure.core/def}}

.clj-kondo/nextjournal/clerk/nextjournal/clerk/viewer.clj_kondo

@@ -0,0 +1,12 @@
+(ns nextjournal.clerk.viewer
+  (:require [clj-kondo.hooks-api :as api]
+            [clojure.string :as str]))
+
+(defn ->viewer-fn [{:keys [node]}]
+  (let [[name-node quoted-node] (:children node)
+        quoted-tag (api/tag quoted-node)]
+    (when (= :quote quoted-tag)
+      (let [quoted-node {:tag :syntax-quote
+                         :children (:children quoted-node)}
+            fn-node (first (:children quoted-node))]
+        {:node fn-node}))))

.clj-kondo/org.mentat/clerk-utils/config.edn

@@ -0,0 +1,12 @@
+{:lint-as
+ {mentat.clerk-utils/->clerk clojure.test/do
+  mentat.clerk-utils/->clerk-only clojure.test/do}
+ :config-in-call
+ {mentat.clerk-utils.show/show-sci
+  {:linters
+   {:unresolved-symbol {:level :off}
+    :unresolved-namespace {:level :off}}}
+  mentat.clerk-utils.show/show-cljs
+  {:linters
+   {:unresolved-symbol {:level :off}
+    :unresolved-namespace {:level :off}}}}}

.clj-kondo/rewrite-clj/rewrite-clj/config.edn

@@ -0,0 +1,5 @@
+{:lint-as
+ {rewrite-clj.zip/subedit-> clojure.core/->
+  rewrite-clj.zip/subedit->> clojure.core/->>
+  rewrite-clj.zip/edit-> clojure.core/->
+  rewrite-clj.zip/edit->> clojure.core/->>}}

.github/workflows/gh-pages.yml

@@ -10,20 +10,17 @@ jobs:
     steps:
       - uses: actions/cache@v3
         with:
-            path: |
-              .cpcache
-              .shadow-cljs
-              ~/.m2
-            key: "1"
+          path: ~/.m2
+          key: ${{ runner.os }}-m2-${{ hashFiles('**/deps.edn') }}
+          restore-keys: ${{ runner.os }}-m2
 
-      - uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v3
 
       - name: Install clojure tools
         uses: DeLaGuardo/setup-clojure@4.0
         with:
-          # Install just one or all simultaneously
-          cli: 1.10.3.1087 # Clojure CLI based on tools.deps
-          # (optional) To avoid rate limit errors please provide github token
+          cli: latest
           github-token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Install babashka
@@ -32,11 +29,10 @@ jobs:
           version: '0.8.156'
 
       - name: Build static site
-        run: bb publish-gh-pages
+        run: bb build-static
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3
-        if: ${{ github.ref == 'refs/heads/main' }}
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./public
+          publish_dir: ./public/build

.github/workflows/kondo.yml

@@ -12,28 +12,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
 
-      - uses: DeLaGuardo/setup-clojure@master
+      - name: Install babashka
+        uses: just-sultanov/setup-babashka@v2
         with:
-          cli: latest
-
-      - name: Set up JDK 17
-        uses: actions/setup-java@v2
-        with:
-          distribution: 'zulu'
-          java-version: '17'
-
-      - name: Install clj-kondo
-        run: sudo ./bin/install-clj-kondo
-
-      - name: Cache Maven packages
-        uses: actions/cache@v2
-        with:
-          path: ~/.m2
-          key: ${{ runner.os }}-m2-${{ hashFiles('**/deps.edn') }}
-          restore-keys: ${{ runner.os }}-m2
-
-      - name: Install dependencies
-        run: clojure -P -M:dev:lint
+          version: '0.8.156'
 
       - name: Cache kondo directory
         uses: actions/cache@v2
@@ -43,5 +25,4 @@ jobs:
           restore-keys: ${{ runner.os }}-kondo
 
       - name: Run clj-kondo
-        run: |
-          clj-kondo --lint src:dev --config '{:output {:pattern "::{{level}} file={{filename}},line={{row}},col={{col}}::{{message}}"}}'
+        run: bb lint --config '{:output {:pattern "::{{level}} file={{filename}},line={{row}},col={{col}}::{{message}}"}}'

CHANGELOG.md

@@ -2,9 +2,41 @@
 
 ## [unreleased]
 
+## [0.2.0]
+
+The interactive docs page is now published to https://mathlive.mentat.org.
+
+- #12:
+
+  - Adds a `deps-new` template that sets up a basic Clerk project with
+    `MathLive.cljs` installed as a dependency. [The template lives
+    here](https://github.com/mentat-collective/MathLive.cljs/tree/main/resources/mathlive/clerk).
+
+  - Adds a `provided` dependency on SCI to `pom.xml`, so that cljdoc builds
+    succeed.
+
+  - Adds `mathlive.sci` with SCI namespace objects for all namespaces, plus a
+    `namespaces` map and a `config` for easy installation into SCI. The
+    namespaces follows the patterns set by the
+    https://github.com/babashka/sci.configs repo.
+
+    - `mathlive.sci/install!` allows the user to install `MathLive.cljs` into
+      SCI's shared context with one mutating call.
+
+  - Migrates the project over to `clerk-utils` and all of its new custom build
+    stuff. This let me simplify development, update the README and DEVELOPING
+    pages and kill my shadow-cljs.edn file. `user.clj` gets quite a bit simpler
+    too.
+
+  - Adds notes to the interactive docs guide about using the library with SCI
+    and with Clerk
+
+  - Upgrades to Clerk version `fad499407d979916d21b33cc7e46e73f7a485e37` for the
+    template and project docs notebook
+
 ## 0.1.0
 
-- Added final `Mathfield component`
+- Added final `Mathfield` component
 
 - Published fleshed-out documentation notebook at https://mentat-collective.github.io/mathlive.cljs
 

DEVELOPING.md

@@ -1,47 +1,47 @@
 ## Dev Dependencies
 
-`clj`, `shadow-cljs`, `node` and `babashka`.
+- [node.js](https://nodejs.org/en/)
+- The [clojure command line tool](https://clojure.org/guides/install_clojure)
+- [Babashka](https://github.com/babashka/babashka#installation)
 
 ## Github Pages, Docs Notebook
 
-The project's [Github Pages
-site](https://mentat-collective.github.io/mathlive.cljs) hosts an interactive
-[Clerk](https://github.com/nextjournal/clerk) notebook demonstrating the
-library's use.
+The project's [Github Pages site](https://mathlive.mentat.org) hosts an
+interactive [Clerk](https://github.com/nextjournal/clerk) notebook demonstrating
+the library's use.
 
 ### Local Notebook Dev
 
-To start a shadow-cljs process watcher for the JS required to run the Clerk
-notebook, run
+Start a Clojure process however you like, and run `(user/serve!)` to run the
+Clerk server. This command should open up `localhost:7777`.
 
-```
-bb dev-notebook
-```
+Alternatively, run
 
-Then start a Clojure process however you like, and run `(user/start!)` to run
-the Clerk server. This command should open up `localhost:7777`.
+```sh
+bb clerk-watch
+```
 
-### Github Pages Static Build
+### Static Build
 
-To test the Pages build locally:
+To test the static build locally:
 
 ```
 bb publish-local
 ```
 
-This will generate the static site in `public`, start a development http server
-and open up a browser window (http://127.0.0.1:8080/) with the production build
-of the documentation notebook.
+This will generate the static site in `public/build`, start a development http
+server and open up a browser window (http://127.0.0.1:8080/) with the production
+build of the documentation notebook.
 
-### Pages Build
+### GitHub Pages
 
 To build and release to Github Pages:
 
 ```
 bb release-gh-pages
 ```
 
-This will ship the site to https://mentat-collective.github.io/mathlive.cljs/.
+This will ship the site to https://mathlive.mentat.org.
 
 ## Publishing to Clojars
 
@@ -67,9 +67,7 @@ The new release will appear on Clojars.
 
 ## Linting
 
-Code is linted with `clj-kondo`. [Install
-`clj-kondo`](https://github.com/clj-kondo/clj-kondo/blob/master/doc/install.md)
-then run
+Code is linted with [`clj-kondo`](https://github.com/clj-kondo/clj-kondo):
 
 ```
 bb lint

README.md

@@ -1,19 +1,27 @@
-# mathlive.cljs
+# MathLive.cljs
 
-A [ClojureScript][CLJS] + [Reagent][REAGENT] wrapper over the [MathLive][MATHLIVE] equation editor.
+A [ClojureScript][cljs-url] + [Reagent][reagent-url] wrapper over the [MathLive][mathlive-url] equation editor.
 
-[![Build Status](https://github.com/mentat-collective/mathlive.cljs/actions/workflows/kondo.yml/badge.svg?branch=main)](https://github.com/mentat-collective/mathlive.cljs/actions/workflows/kondo.yml)
-[![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://github.com/mentat-collective/mathlive.cljs/blob/main/LICENSE)
-[![cljdoc badge](https://cljdoc.org/badge/org.mentat/mathlive.cljs)](https://cljdoc.org/d/org.mentat/mathlive.cljs/CURRENT)
-[![Clojars Project](https://img.shields.io/clojars/v/org.mentat/mathlive.cljs.svg)](https://clojars.org/org.mentat/mathlive.cljs)
+[![Build Status][build-status]][build-status-url]
+[![License][license]][license-url]
+[![cljdoc badge][cljdoc]][cljdoc-url]
+[![Clojars Project][clojars]][clojars-url]
+[![Discord Shield][discord]][discord-url]
 
 ## Quickstart
 
-Install `mathlive.cljs` into your Clojurescript project using the instructions
+Install `MathLive.cljs` into your Clojurescript project using the instructions
 at its Clojars page:
 
-[![Clojars
-Project](https://img.shields.io/clojars/v/org.mentat/mathlive.cljs.svg)](https://clojars.org/org.mentat/mathlive.cljs)
+[![Clojars Project][clojars]][clojars-url]
+
+Or grab the most recent code using a Git dependency:
+
+```clj
+;; deps
+{io.github.mentat-collective/mathlive.cljs
+  {:git/sha "$GIT_SHA"}}
+```
 
 Require `mathlive.core` in your namespace:
 
@@ -23,9 +31,11 @@ Require `mathlive.core` in your namespace:
              [reagent.core :as r]))
 ```
 
-The main entrypoint to the library is the `mathlive.core/Mathfield` component.
-This component acts like a Reagent `[:textarea ,,,]` and takes similar props,
-but allows for interactive mathematical input and conversion to LaTeX.
+The main entrypoint to the library is the
+[`mathlive.core/Mathfield`](https://cljdoc.org/d/org.mentat/mathlive.cljs/CURRENT/api/mathlive.core#Mathfield)
+component. This component acts like a Reagent `[:textarea ,,,]` and takes
+similar props, but allows for interactive mathematical input and conversion to
+LaTeX.
 
 Here's an example component:
 
@@ -43,35 +53,35 @@ Here's an example component:
 ![2022-12-01 16 56 20](https://user-images.githubusercontent.com/69635/205183928-e0fb6227-c45c-4db7-982d-c8e8a3cb3ee8.gif)
 
 See the project's [interactive documentation
-notebook](https://github.com/mentat-collective/mathlive.cljs) for more examples.
-The [MathLive guides](https://cortexjs.io/mathlive/guides/interacting/) are
-great resources as well.
+notebook](https://mathlive.mentat.org) for more examples. The [MathLive
+guides](https://cortexjs.io/mathlive/guides/interacting/) are great resources as
+well.
+
+## Clerk Support
+
+If you want to use `MathLive.cljs` with [Clerk][clerk-url], check out the
+[`mathlive/clerk` template][mathlive-clerk-template-url]. This
+[`deps-new`][deps-new-url] template will generate a Clerk project for you, fully
+configured to use `MathLive.cljs` in your Clerk notebooks.
 
 ## Interactive Documentation via Clerk
 
-The project's [interactive
-documentation](https://mentat-collective.github.io/mathlive.cljs) was generated
-using Nextjournal's [Clerk](https://github.com/nextjournal/clerk). If you'd like
-to edit or play with the documentation, you'll need to install
+The project's [interactive documentation](https://mathlive.mentat.org) was
+generated using Nextjournal's [Clerk](https://github.com/nextjournal/clerk). If
+you'd like to edit or play with the documentation, you'll need to install
 
 - [node.js](https://nodejs.org/en/)
 - The [clojure command line tool](https://clojure.org/guides/install_clojure)
 - [Babashka](https://github.com/babashka/babashka#installation)
 
-Once this is done, run this command in one terminal window to build and serve the custom JS required by the notebook:
+Once this is done, run this command:
 
-```
-bb dev-notebook
-```
-
-In another terminal window, run
-
-```
-bb start-clerk
+```sh
+bb clerk-watch
 ```
 
-This should open a browser window to `http://localhost:7777` with the contents
-of the documentation notebook. Any edits you make to `dev/mathlive/notebook.clj`
+This will open a browser window to `http://localhost:7777` with the contents of
+the documentation notebook. Any edits you make to `dev/mathlive/notebook.clj`
 will be picked up and displayed in the browser on save.
 
 ## Thanks and Support
@@ -91,6 +101,20 @@ Copyright © 2022 Sam Ritchie.
 
 Distributed under the [MIT License](LICENSE). See [LICENSE](LICENSE).
 
-[CLJS]: https://clojurescript.org/
-[MATHLIVE]: https://github.com/arnog/mathlive
-[REAGENT]: https://reagent-project.github.io/
+[build-status-url]: https://github.com/mentat-collective/mathlive.cljs/actions/workflows/kondo.yml
+[build-status]: https://github.com/mentat-collective/mathlive.cljs/actions/workflows/kondo.yml/badge.svg?branch=main
+[cljdoc-url]: https://cljdoc.org/d/org.mentat/mathlive.cljs/CURRENT
+[cljdoc]: https://cljdoc.org/badge/org.mentat/mathlive.cljs
+[clojars-url]: https://clojars.org/org.mentat/mathlive.cljs
+[clojars]: https://img.shields.io/clojars/v/org.mentat/mathlive.cljs.svg
+[discord-url]: https://discord.gg/hsRBqGEeQ4
+[discord]: https://img.shields.io/discord/731131562002743336?style=flat&colorA=000000&colorB=000000&label=&logo=discord
+[license-url]: LICENSE
+[license]: https://img.shields.io/badge/license-MIT-brightgreen.svg
+[github-url]: https://github.com/mentat-collective/mathlive.cljs
+[reagent-url]: https://reagent-project.github.io/
+[mathlive-url]: https://mathlive.dev
+[deps-new-url]: https://github.com/seancorfield/deps-new
+[mathlive-clerk-template-url]: https://github.com/mentat-collective/MathLive.cljs/tree/main/resources/mathlive/clerk
+[clerk-url]: https://clerk.vision
+[cljs-url]: https://clojurescript.org/