@vanelsas/baredom 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 All notable changes to BareDome will be documented in this file.
 
+## [1.3.0] - 2026-04-07
+
+### Added
+
+Six new components:
+
+- **Effects** — x-splash, x-metaball-cursor, x-neural-glow, x-organic-progress
+- **Layout** — x-bento-grid, x-bento-item
+
+### Changed
+
+- **x-neural-glow** — automatic light/dark background adaptation via shader luminance detection
+
+## [1.2.0] - 2026-04-05
+
+### Added
+
+- **Scroll** — x-scroll-stack (card-stack with scroll-driven align support)
+- **Documentation** — JavaScript Developer Guide (`docs/javascript-guide.md`) for npm/ESM setup, event handling, theming, and framework integration
+
+### Changed
+
+- Cleaned up x-button.md for JavaScript developer readability
+- Added JavaScript guide link to README Installation section
+
 ## [1.1.0] - 2026-04-05
 
 ### Added

package/README.md

@@ -11,7 +11,7 @@
 
 ## What is BareDOM?
 
-BareDOM is a library of 54 UI components built entirely on web standards — Custom Elements v1, Shadow DOM, and ES modules. There is no framework runtime, no virtual DOM, and no JavaScript framework peer dependency. Every component is a native HTML element that you register once and use anywhere.
+BareDOM is a library of more than 70 UI components built entirely on web standards — Custom Elements v1, Shadow DOM, and ES modules. There is no framework runtime, no virtual DOM, and no JavaScript framework peer dependency. Every component is a native HTML element that you register once and use anywhere.
 
 The core rendering model is deliberately simple:
 
@@ -25,7 +25,7 @@ BareDOM is authored in ClojureScript and compiled to optimised, minified ES modu
 
 BareDOM has been created using Claude Code. The CLAUDE.md file is added to the repository for your convenience.
 
-All web components—including new, modern, and exciting ones such as x-ripple-effect, x-scroll-parallax, x-scroll-story, x-scroll-timeline, x-kinetic-typography, x-organic-shape, and x-gaussian-blur—can be seen [here](https://avanelsas.github.io/baredom/)
+All web components—including new, modern, and exciting ones such as x-ripple-effect, x-scroll-parallax, x-scroll-story, x-scroll-timeline, x-kinetic-typography, x-organic-shape, x-gaussian-blur, x-neural-glow, x-metaball-cursor, and x-organic-progress—can be seen [here](https://avanelsas.github.io/baredom/)
 
 ---
 
@@ -33,7 +33,7 @@ All web components—including new, modern, and exciting ones such as x-ripple-e
 
 Like most Clojure/ClojureScript developers starting out with UIs, I went through the common phases of using Reagent and Re-frame—which are great utilities in their own right. However, as my UIs became larger and more complex, bundle sizes increased, and I found myself spending too much time rebuilding generic, reusable components from scratch.
 
-I started looking for a different approach and discovered Web Components. I built a few, but didn't have the spare time to develop a comprehensive set that could be used in any project. Then AI arrived. While experimenting with Claude Code, I realised that 1 + 1 = 3. That is how Baredom, my first open-source project, was born.
+I started looking for a different approach and discovered Web Components. I built a few, but didn't have the spare time to develop a comprehensive set that could be used in any project. Then AI arrived. While experimenting with Claude Code, I realised that 1 + 1 could be 3. That is how BareDOM, my first open-source project, was born.
 
 # Why web components?
 
@@ -55,6 +55,8 @@ I started looking for a different approach and discovered Web Components. I buil
 
 ## Installation
 
+> **Using JavaScript?** See the [JavaScript Developer Guide](./docs/javascript-guide.md) for npm/ESM setup, event handling, theming, and framework integration examples (React, Vue, Svelte).
+
 BareDOM can be consumed three ways: as a **ClojureScript source dependency** (Clojars), as **standalone ES module files** (no build tool required), or as an **npm package**.
 
 ### Option A — ClojureScript via Clojars
@@ -62,13 +64,13 @@ BareDOM can be consumed three ways: as a **ClojureScript source dependency** (Cl
 Add BareDOM to your `deps.edn`:
 
 ```clojure
-{:deps {com.github.avanelsas/baredom {:mvn/version "1.1.0"}}}
+{:deps {com.github.avanelsas/baredom {:mvn/version "1.2.0"}}}
 ```
 
 Or in your `shadow-cljs.edn` dependencies:
 
 ```clojure
-:dependencies [[com.github.avanelsas/baredom "1.1.0"]]
+:dependencies [[com.github.avanelsas/baredom "1.2.0"]]
 ```
 
 Then require component namespaces directly and call their `init!` function once at startup:
@@ -125,7 +127,7 @@ Add the npm package to your `package.json`:
 ```json
 {
   "dependencies": {
-    "@vanelsas/baredom": "^1.1.0"
+    "@vanelsas/baredom": "^1.2.0"
   }
 }
 ```