From 4e573e2ca8e0035fb5e45fc9a74b3c43ababf9a0 Mon Sep 17 00:00:00 2001 From: Andrew Date: Mon, 20 Jul 2026 22:32:29 -0400 Subject: [PATCH] Document JavaScript artifact workflow --- AGENTS.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 4ed2858..092a284 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,6 +14,22 @@ not offer to start the server for them. cd demo && mix test ``` +# JavaScript Assets + +- `assets/js/live_toast/live_toast.ts` is the canonical LiveToast client source. +- `priv/static/live_toast.cjs.js`, `priv/static/live_toast.esm.js`, `priv/static/live_toast.js`, and + `priv/static/live_toast.min.js` (and their source maps) are published distribution artifacts. When a change affects + the client source, run `mix assets.build`, review the generated output, and commit the updated artifacts with the + source change. +- The root `assets` project uses Bun. Demo `priv/static` output is generated and ignored; do not commit it. + +# Public API Changes + +- For a new or materially changed supported API, update the README and add or revise a demo recipe that links to the + relevant demo source. +- Add focused coverage in `demo/test` for the supported behavior, including both LiveView and non-LiveView rendering + paths when the public component supports both. + # Code Style - Use Styler/Quokka for Elixir formatting