@vanelsas/baredom 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to BareDome will be documented in this file.
 
+## [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
+
+Nine new components:
+
+- **Effects** — x-ripple-effect, x-gaussian-blur
+- **Scroll** — x-scroll-parallax, x-scroll-timeline, x-scroll-story
+- **Typography** — x-typography, x-kinetic-typography
+- **Decorative** — x-organic-divider, x-organic-shape
+
 ## [1.0.0] - 2026-04-04
 
 Stable release — promoted from 1.0.0-rc.4 with no code changes.

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 60 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,10 +25,18 @@ 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/)
+
 ---
 
 ## Why BareDOM?
 
+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 could be 3. That is how BareDOM, my first open-source project, was born.
+
+# Why web components?
+
 **Works in any stack.** Because components are native HTML elements, they work wherever HTML works — vanilla JavaScript, React, Vue, Svelte, Angular, server-rendered HTML, or a static page. No adapter layer, no wrapper library.
 
 **No framework lock-in.** Your components are not tied to the framework you are building with today. Migrate your app, keep your components.
@@ -47,6 +55,8 @@ BareDOM has been created using Claude Code. The CLAUDE.md file is added to the r
 
 ## 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
@@ -54,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.0.0-rc.4"}}}
+{:deps {com.github.avanelsas/baredom {:mvn/version "1.2.0"}}}
 ```
 
 Or in your `shadow-cljs.edn` dependencies:
 
 ```clojure
-:dependencies [[com.github.avanelsas/baredom "1.0.0-rc.4"]]
+:dependencies [[com.github.avanelsas/baredom "1.2.0"]]
 ```
 
 Then require component namespaces directly and call their `init!` function once at startup:
@@ -117,7 +127,7 @@ Add the npm package to your `package.json`:
 ```json
 {
   "dependencies": {
-    "@vanelsas/baredom": "^1.0.0-rc.4"
+    "@vanelsas/baredom": "^1.2.0"
   }
 }
 ```