From d4f0936ba07ed9bdb82ae3481794feaa7c03c661 Mon Sep 17 00:00:00 2001
From: Erick Xavier <erick.xavier@gmail.com>
Date: Mon, 22 Jun 2026 14:03:31 -0300
Subject: [PATCH 1/3] fix(docs): remove npm/ESM references from README and docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

NoJS Elements is CDN-only — it is not published to npm. Remove all
npm install, ESM import, and CJS require references from README,
llms-full.txt, llms.txt, and migration-from-core.md. Expand the
Contributing section with build/test commands.

Closes #58
---
 README.md                      | 38 ++++++++-------------------
 docs/llms-full.txt             | 31 +++-------------------
 docs/llms.txt                  |  3 +--
 docs/md/migration-from-core.md | 47 ----------------------------------
 4 files changed, 15 insertions(+), 104 deletions(-)

diff --git a/README.md b/README.md
index aab71b9..e7122af 100644
--- a/README.md
+++ b/README.md
@@ -10,34 +10,7 @@
 
 ## Installation
 
-### NPM
-
-```bash
-npm install @no-js-dev/nojs-elements
-```
-
-### CDN
-
-```html
-<script src="https://cdn.no-js.dev/elements"></script>
-```
-
----
-
-## Usage
-
-### ESM
-
-```javascript
-import NoJS from '@no-js-dev/nojs';
-import NoJSElements from '@no-js-dev/nojs-elements';
-
-NoJS.use(NoJSElements);
-```
-
-### CDN (Script Tag)
-
-When loaded via `<script>` tag, NoJS Elements auto-installs itself — no `NoJS.use()` call needed:
+Add both script tags to your HTML — NoJS Core first, then Elements:
 
 ```html
 <script src="https://cdn.no-js.dev/"></script>
@@ -45,6 +18,8 @@ When loaded via `<script>` tag, NoJS Elements auto-installs itself — no `NoJS.
 <!-- That's it — all elements are ready to use -->
 ```
 
+NoJS Elements auto-installs itself when loaded via `<script>` tag — no `NoJS.use()` call needed.
+
 ---
 
 ## Elements
@@ -151,6 +126,13 @@ For the full directive reference with all attributes, events, CSS classes, and a
 
 Contributions are welcome! Please open an issue or submit a pull request.
 
+```bash
+npm install            # install dependencies
+npm run build          # esbuild → dist/{iife,esm,cjs}/nojs-elements.js
+npm test               # Jest unit tests
+cd e2e && npx playwright test   # E2E tests (Playwright)
+```
+
 - [Changelog](CHANGELOG.md)
 
 ## License
diff --git a/docs/llms-full.txt b/docs/llms-full.txt
index fe18b98..16eb213 100644
--- a/docs/llms-full.txt
+++ b/docs/llms-full.txt
@@ -7,7 +7,7 @@ NoJS Elements provides drag-and-drop, form validation, tooltips, popovers, modal
 ## Table of Contents
 
 ### Installation
-- [Getting Started](#getting-started) — NPM, CDN, ESM usage
+- [Getting Started](#getting-started) — CDN script tag usage
 
 ### Interaction Elements
 - [Drag & Drop](#drag-and-drop) — `drag`, `drop`, `drag-list`, `drag-multiple`
@@ -44,32 +44,7 @@ NoJS Elements provides drag-and-drop, form validation, tooltips, popovers, modal
 
 ## Installation
 
-### NPM
-
-```bash
-npm install @no-js-dev/nojs-elements
-```
-
-### CDN
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/@no-js-dev/nojs-elements/dist/iife/nojs-elements.js"></script>
-```
-
-## Usage
-
-### ESM
-
-```javascript
-import NoJS from '@no-js-dev/nojs';
-import NoJSElements from '@no-js-dev/nojs-elements';
-
-NoJS.use(NoJSElements);
-```
-
-### CDN (Script Tag)
-
-When loaded via `<script>` tag, NoJS Elements auto-installs itself — no `NoJS.use()` call needed:
+Add both script tags to your HTML — NoJS Core first, then Elements:
 
 ```html
 <script src="https://cdn.no-js.dev/"></script>
@@ -77,6 +52,8 @@ When loaded via `<script>` tag, NoJS Elements auto-installs itself — no `NoJS.
 <!-- That's it — all elements are ready to use -->
 ```
 
+NoJS Elements auto-installs itself when loaded via `<script>` tag — no `NoJS.use()` call needed.
+
 ## Peer Dependency
 
 This plugin requires **No.JS >= 1.13.0** as a peer dependency.
diff --git a/docs/llms.txt b/docs/llms.txt
index a06cff3..7747ecc 100644
--- a/docs/llms.txt
+++ b/docs/llms.txt
@@ -6,7 +6,7 @@ NoJS Elements provides drag-and-drop, form validation, tooltips, popovers, modal
 
 ## Installation
 
-- [Getting Started](https://elements.no-js.dev/): NPM install, CDN script tag, ESM/IIFE usage, peer dependency on No.JS
+- [Getting Started](https://elements.no-js.dev/): CDN script tag usage, peer dependency on No.JS
 
 ## Drag & Drop
 
@@ -56,5 +56,4 @@ NoJS Elements provides drag-and-drop, form validation, tooltips, popovers, modal
 - [No.JS Full Docs](https://no-js.dev/llms-full.txt): Complete No.JS framework documentation
 - [NoJS LSP](https://lsp.no-js.dev/): VS Code extension with completion, hover, and diagnostics for No.JS directives
 - [NoJS Skill](https://github.com/no-js-dev/nojs-skill): AI agent reference for No.JS — full directive, filter, and validation docs
-- [npm](https://www.npmjs.com/package/@no-js-dev/nojs-elements): Install via npm
 - [GitHub](https://github.com/no-js-dev/nojs-elements): Source code, issues, and contributions
diff --git a/docs/md/migration-from-core.md b/docs/md/migration-from-core.md
index 35c943b..a7d6095 100644
--- a/docs/md/migration-from-core.md
+++ b/docs/md/migration-from-core.md
@@ -76,53 +76,6 @@ The CDN build of NoJS Elements auto-installs when it detects `window.NoJS`. No J
 
 ---
 
-## npm / ESM Users
-
-### Before (Core only)
-
-```javascript
-import NoJS from '@no-js-dev/nojs';
-
-NoJS.config({ /* ... */ });
-NoJS.init();
-```
-
-### After (Core + Elements)
-
-```bash
-npm install @no-js-dev/nojs-elements
-```
-
-```javascript
-import NoJS from '@no-js-dev/nojs';
-import NoJSElements from '@no-js-dev/nojs-elements';
-
-NoJS.config({ /* ... */ });
-NoJS.use(NoJSElements);
-NoJS.init();
-```
-
-**Order matters:** `NoJS.use(NoJSElements)` must be called before `NoJS.init()`.
-
----
-
-## CJS / require() Users
-
-```bash
-npm install @no-js-dev/nojs-elements
-```
-
-```javascript
-const NoJS = require('@no-js-dev/nojs');
-const NoJSElements = require('@no-js-dev/nojs-elements');
-
-NoJS.config({ /* ... */ });
-NoJS.use(NoJSElements);
-NoJS.init();
-```
-
----
-
 ## HTML Templates — No Changes Required
 
 Your HTML templates are 100% backward compatible. Every directive attribute, implicit variable, CSS class, and event works exactly as before:

From 0fad3ac75b2f741492055ef51ebb32289fcb720c Mon Sep 17 00:00:00 2001
From: Erick Xavier <erick.xavier@gmail.com>
Date: Mon, 22 Jun 2026 14:22:28 -0300
Subject: [PATCH 2/3] fix(docs): standardize CDN URL, remove ESM refs, fix dead
 link

- Replace cdn.no-js.dev/elements with cdn-elements.no-js.dev/ everywhere
- Remove surviving ESM usage instructions from docs/llms-full.txt
- Fix dead link to NoJS-Skill directives.md#drag-and-drop, now points
  to the correct nojs/references/elements/ directory
---
 README.md                      | 4 ++--
 docs/llms-full.txt             | 6 +++---
 docs/md/migration-from-core.md | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index e7122af..42b8438 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ Add both script tags to your HTML — NoJS Core first, then Elements:
 
 ```html
 <script src="https://cdn.no-js.dev/"></script>
-<script src="https://cdn.no-js.dev/elements"></script>
+<script src="https://cdn-elements.no-js.dev/"></script>
 <!-- That's it — all elements are ready to use -->
 ```
 
@@ -107,7 +107,7 @@ This plugin requires **No.JS >= 1.13.0** as a peer dependency.
 
 Detailed documentation for each element is available in [`docs/md/`](docs/md/).
 
-For the full directive reference with all attributes, events, CSS classes, and accessibility details, see the [NoJS-Skill directive reference](https://github.com/no-js-dev/nojs-skill/blob/main/references/directives.md#drag-and-drop).
+For the full directive reference with all attributes, events, CSS classes, and accessibility details, see the [NoJS-Skill element references](https://github.com/no-js-dev/nojs-skill/blob/main/nojs/references/elements/).
 
 ---
 
diff --git a/docs/llms-full.txt b/docs/llms-full.txt
index 16eb213..57155a5 100644
--- a/docs/llms-full.txt
+++ b/docs/llms-full.txt
@@ -48,7 +48,7 @@ Add both script tags to your HTML — NoJS Core first, then Elements:
 
 ```html
 <script src="https://cdn.no-js.dev/"></script>
-<script src="https://cdn.no-js.dev/elements"></script>
+<script src="https://cdn-elements.no-js.dev/"></script>
 <!-- That's it — all elements are ready to use -->
 ```
 
@@ -84,7 +84,7 @@ This plugin requires **No.JS >= 1.13.0** as a peer dependency.
 
 # Drag and Drop
 
-> The DnD module is included in NoJS Elements. When using the CDN, it is auto-installed — no separate registration is needed. For ESM usage, call `NoJS.use(NoJSElements)` once.
+> The DnD module is included in NoJS Elements. When using the CDN, it is auto-installed — no separate registration is needed.
 
 ## `drag` — Make an Element Draggable
 
@@ -342,7 +342,7 @@ No.JS automatically adds:
 
 # Validation
 
-> The Validation module is included in NoJS Elements. When using the CDN, it is auto-installed — no separate registration is needed. For ESM usage, call `NoJS.use(NoJSElements)` once.
+> The Validation module is included in NoJS Elements. When using the CDN, it is auto-installed — no separate registration is needed.
 
 ## `<form validate>` — Form-Level Validation
 
diff --git a/docs/md/migration-from-core.md b/docs/md/migration-from-core.md
index a7d6095..3674e6f 100644
--- a/docs/md/migration-from-core.md
+++ b/docs/md/migration-from-core.md
@@ -59,7 +59,7 @@ Both packages must be at version 1.13.0 or later. Earlier versions of NoJS Eleme
 
 ```html
 <script src="https://cdn.no-js.dev/"></script>
-<script src="https://cdn.no-js.dev/elements/"></script>
+<script src="https://cdn-elements.no-js.dev/"></script>
 
 <form validate>
   <input name="email" validate="required|email" />

From 6c19b9a6c0559b3ce102c724b003663584039cc7 Mon Sep 17 00:00:00 2001
From: Erick Xavier <erick.xavier@gmail.com>
Date: Mon, 22 Jun 2026 14:25:03 -0300
Subject: [PATCH 3/3] chore: release v1.15.4

---
 CHANGELOG.md               | 14 +++++++++++++-
 dist/cjs/nojs-elements.js  |  2 +-
 dist/esm/nojs-elements.js  |  2 +-
 dist/iife/nojs-elements.js |  2 +-
 package.json               |  2 +-
 5 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3a126d8..438730e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,7 +5,19 @@ All notable changes to **NoJS Elements** will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://github.com/no-js-dev/nojs-elements/compare/v1.15.3...HEAD)
+## [Unreleased](https://github.com/no-js-dev/nojs-elements/compare/v1.15.4...HEAD)
+
+## [1.15.4](https://github.com/no-js-dev/nojs-elements/compare/v1.15.3...v1.15.4) — 2026-06-22
+
+### Fixed
+
+- fix(docs): remove npm/ESM sections from README and docs — NoJS Elements is CDN-only
+- fix(docs): remove npmjs.com link from llms.txt
+- fix(docs): remove npm/ESM/CJS migration sections from migration-from-core.md
+- fix(docs): expand Contributing section with build/test commands
+- fix(docs): standardize CDN URL to cdn-elements.no-js.dev/
+- fix(docs): remove surviving ESM instructions from llms-full.txt
+- fix(docs): fix dead link to Skill repo element references
 
 ## [1.15.3](https://github.com/no-js-dev/nojs-elements/compare/v1.15.2...v1.15.3) — 2026-06-20
 
diff --git a/dist/cjs/nojs-elements.js b/dist/cjs/nojs-elements.js
index 0980c33..d7be132 100644
--- a/dist/cjs/nojs-elements.js
+++ b/dist/cjs/nojs-elements.js
@@ -1,5 +1,5 @@
 /**
- * NoJS Elements v1.15.3 — Element plugins for No.JS
+ * NoJS Elements v1.15.4 — Element plugins for No.JS
  * Drag-and-drop, and more.
  * @author exs.dev
  * @homepage https://elements.no-js.dev/
diff --git a/dist/esm/nojs-elements.js b/dist/esm/nojs-elements.js
index 5d41ff6..8ee3ea2 100644
--- a/dist/esm/nojs-elements.js
+++ b/dist/esm/nojs-elements.js
@@ -1,5 +1,5 @@
 /**
- * NoJS Elements v1.15.3 — Element plugins for No.JS
+ * NoJS Elements v1.15.4 — Element plugins for No.JS
  * Drag-and-drop, and more.
  * @author exs.dev
  * @homepage https://elements.no-js.dev/
diff --git a/dist/iife/nojs-elements.js b/dist/iife/nojs-elements.js
index 6233d03..a05dc57 100644
--- a/dist/iife/nojs-elements.js
+++ b/dist/iife/nojs-elements.js
@@ -1,5 +1,5 @@
 /**
- * NoJS Elements v1.15.3 — Element plugins for No.JS
+ * NoJS Elements v1.15.4 — Element plugins for No.JS
  * Drag-and-drop, and more.
  * @author exs.dev
  * @homepage https://elements.no-js.dev/
diff --git a/package.json b/package.json
index ffdf3ba..e235202 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@no-js-dev/nojs-elements",
-  "version": "1.15.3",
+  "version": "1.15.4",
   "description": "Element plugins for No.JS — drag-and-drop, validation, and more",
   "main": "dist/cjs/nojs-elements.js",
   "module": "dist/esm/nojs-elements.js",