@sablier/devkit 1.12.1 → 1.13.0

package/README.md

@@ -26,7 +26,7 @@ Extend the base Biome configuration in your `biome.jsonc`:
 
 ```jsonc
 {
-  "$schema": "https://biomejs.dev/schemas/2.0.6/schema.json",
+  "$schema": "https://biomejs.dev/schemas/latest/schema.json",
   "extends": ["@sablier/devkit/biome"],
 }
 ```
@@ -116,25 +116,31 @@ Available modules:
 | Module          | Description                     |
 | --------------- | ------------------------------- |
 | `base.just`     | Common development recipes      |
-| `npm.just`      | NPM package management          |
+| `csv.just`      | CSV/TSV validation with qsv     |
 | `evm.just`      | EVM/Foundry tooling             |
-| `tsv.just`      | TypeScript validation           |
+| `npm.just`      | NPM package management          |
 | `settings.just` | Just settings and configuration |
+| `vercel.just`   | Vercel build and deploy         |
 
 ## ⚙️ Available Configs
 
-| Tool            | Config File/Directory                    |
-| --------------- | ---------------------------------------- |
-| 🔍 Biome        | [`biome/`](./biome/)                     |
-| 📝 EditorConfig | [`.editorconfig`](./.editorconfig)       |
-| 🛠 Just         | [`just/`](./just/)                       |
-| ✨ Prettier     | [`.prettierrc.json`](./.prettierrc.json) |
-| 📦 TSConfig     | [`tsconfig/`](./tsconfig/)               |
-| 🧪 Vitest       | [`vitest/`](./vitest/)                   |
+| Tool        | Config File/Directory                    |
+| ----------- | ---------------------------------------- |
+| 🔍 Biome    | [`biome/`](./biome/)                     |
+| 🛠 Just     | [`just/`](./just/)                       |
+| ✨ Prettier | [`.prettierrc.json`](./.prettierrc.json) |
+| 📦 TSConfig | [`tsconfig/`](./tsconfig/)               |
+| 🧪 Vitest   | [`vitest/`](./vitest/)                   |
+| 💻 VSCode   | [`vscode/`](./vscode/)                   |
 
 ## 🐈‍⬛ GitHub Actions
 
-The [setup](./actions/setup/) action installs requisite dependencies in GitHub CI workflows.
+Reusable composite actions for GitHub CI workflows.
+
+| Action                                        | Description                                |
+| --------------------------------------------- | ------------------------------------------ |
+| [`actions/setup`](./actions/setup/)           | Install dependencies (Node.js, Just, etc.) |
+| [`actions/node-cache`](./actions/node-cache/) | Cache Node.js dependencies                 |
 
 ```yaml
 - uses: sablier-labs/devkit/actions/setup@main
@@ -150,4 +156,4 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## 📄 License
 
-This project is licensed under MIT.
+This project is licensed under MIT — see the [LICENSE](LICENSE.md) file for details.

package/biome/ui.jsonc

@@ -37,6 +37,9 @@
         "noSvgWithoutTitle": "off",
         "useKeyWithClickEvents": "off"
       },
+      "correctness": {
+        "useExhaustiveDependencies": "off" // doesn't work with React Compiler: https://github.com/biomejs/biome/issues/5293
+      },
       "nursery": {
         // Sort Tailwind CSS classes alphabetically
         // See https://github.com/biomejs/biome/issues/1274#issuecomment-3490774696

package/just/base.just

@@ -42,7 +42,7 @@ _clean +globs:
 # Install mdformat with plugins
 [no-cd]
 @install-mdformat:
-    uv tool install mdformat \
+    uv tool install mdformat --python 3.14 \
         --with mdformat-frontmatter \
         --with mdformat-gfm
 alias im := install-mdformat

package/just/vercel.just

@@ -0,0 +1,109 @@
+import "./settings.just"
+
+# ---------------------------------------------------------------------------- #
+#                                 DEPENDENCIES                                 #
+# ---------------------------------------------------------------------------- #
+
+# Ni: https://github.com/antfu-collective/ni
+na := require("na")
+
+# ---------------------------------------------------------------------------- #
+#                                   CONSTANTS                                  #
+# ---------------------------------------------------------------------------- #
+
+# Consumer MUST override with a JSON map of app name → Vercel project ID.
+# Example: '{"portal": "prj_xxx", "landing": "prj_yyy"}'
+VERCEL_PROJECT_IDS := '{}'
+
+# ---------------------------------------------------------------------------- #
+#                                    RECIPES                                   #
+# ---------------------------------------------------------------------------- #
+
+# Build website for Vercel deployment
+[arg("app", long)]
+[arg("env", long)]
+[group("vercel")]
+build app env="staging":
+    @just _vercel-build "{{ app }}" "{{ env }}"
+alias b := build
+
+# Deploy website to Vercel
+[arg("app", long)]
+[arg("env", long)]
+[arg("skip_build", long="skip-build", value="true")]
+[confirm("Are you sure you want to deploy? [y/N]")]
+[group("vercel")]
+deploy app env="staging" skip_build="false":
+    @just _vercel-deploy "{{ app }}" "{{ env }}" "{{ skip_build }}"
+alias d := deploy
+
+# ---------------------------------------------------------------------------- #
+#                                PRIVATE HELPERS                               #
+# ---------------------------------------------------------------------------- #
+
+# Core build: vercel pull + vercel build
+[private, script("python3")]
+_vercel-build app env:
+    import json, os, subprocess, sys
+
+    def run(*cmd):
+        result = subprocess.run(cmd)
+        if result.returncode != 0:
+            sys.exit(result.returncode)
+
+    # Workaround for https://github.com/vercel/vercel/issues/14666
+    os.environ["VERCEL_TARGET_ENV"] = "{{ env }}"
+    os.environ["NEXT_PUBLIC_VERCEL_TARGET_ENV"] = "{{ env }}"
+
+    # Resolve project ID from app name
+    project_ids = json.loads('{{ VERCEL_PROJECT_IDS }}')
+    app = "{{ app }}"
+    if app not in project_ids:
+        print(f"Error: unknown app '{app}'. Known apps: {', '.join(project_ids) or '(none)'}", file=sys.stderr)
+        sys.exit(1)
+    os.environ["VERCEL_PROJECT_ID"] = project_ids[app]
+
+    token = os.environ.get("VERCEL_TOKEN", "")
+    if not token:
+        print("Error: VERCEL_TOKEN is not set.", file=sys.stderr)
+        sys.exit(1)
+
+    # Pull the environment from the Vercel project
+    run("na", "vercel", "pull", "--environment={{ env }}", f"--token={token}", "--yes")
+
+    # Build the project
+    run("na", "vercel", "build", "--target={{ env }}", f"--token={token}")
+
+# Core deploy: optionally build, then deploy prebuilt artifacts
+[private, script("python3")]
+_vercel-deploy app env skip_build="false":
+    import json, os, subprocess, sys
+
+    def run(*cmd):
+        result = subprocess.run(cmd)
+        if result.returncode != 0:
+            sys.exit(result.returncode)
+
+    # Build the project if not skipped (calls the PUBLIC recipe so consumer overrides apply)
+    if "{{ skip_build }}" != "true":
+        run("just", "build", "--app={{ app }}", "--env={{ env }}")
+
+    # Workaround for https://github.com/vercel/vercel/issues/14666
+    os.environ["VERCEL_TARGET_ENV"] = "{{ env }}"
+    os.environ["NEXT_PUBLIC_VERCEL_TARGET_ENV"] = "{{ env }}"
+
+    # Resolve project ID from app name
+    project_ids = json.loads('{{ VERCEL_PROJECT_IDS }}')
+    app = "{{ app }}"
+    if app not in project_ids:
+        print(f"Error: unknown app '{app}'. Known apps: {', '.join(project_ids) or '(none)'}", file=sys.stderr)
+        sys.exit(1)
+    os.environ["VERCEL_PROJECT_ID"] = project_ids[app]
+
+    token = os.environ.get("VERCEL_TOKEN", "")
+    if not token:
+        print("Error: VERCEL_TOKEN is not set.", file=sys.stderr)
+        sys.exit(1)
+
+    # Deploy the project to Vercel
+    run("na", "vercel", "deploy", "--prebuilt", "--target={{ env }}", f"--token={token}")

package/package.json

@@ -3,7 +3,7 @@
   "description": "Configuration files and reusable scripts for Sablier repositories",
   "license": "MIT",
   "type": "module",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "author": {
     "name": "Sablier Labs Ltd",
     "url": "https://sablier.com"