@adia-ai/web-components 0.6.29 → 0.6.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,18 @@
1
1
  # Changelog — @adia-ai/web-components
2
2
 
3
+ ## [0.6.30] — 2026-05-23
4
+
5
+ ### Added — `dist/web-components.min.js` rolled-up CDN-ready JS bundle
6
+
7
+ - **`dist/web-components.min.js`** ships as part of the tarball (1.01 MB raw / ~330 KB gzipped / ~250 KB brotli). Single esbuild-bundled file — flattens every relative import from `index.js` through the 95 primitive registrations + core + tokens into one ESM payload. Browser-target Chromium 125+ / Safari 18+ / Firefox 129+ (matches existing `check:lightningcss-build` baseline).
8
+ - **New `./js/bundled` export** in package.json `exports` map points at the bundle. Existing `./` (root) export unchanged — bundler consumers (Vite, webpack, esbuild) continue using it.
9
+ - Companion to the v0.6.29 CSS bundle: HTML-first / CodePen / marketing pages can now drop in two `<link>` + one `<script type="module">` and have working AdiaUI primitives. See [`/site/getting-started/cdn-usage`](https://ui-kit.exe.xyz/site/getting-started/cdn-usage) for the full template.
10
+ - Generation: `npm run build:bundle-js` (esbuild bundle mode). Freshness enforced at release time via `check:js-bundles-fresh` gate (mirrors `check:css-bundles-fresh` discipline). `npm run build:bundles` runs both CSS + JS together.
11
+
12
+ ### Documentation — README CDN section + AI-agent discoverability
13
+
14
+ - **README.md** grows two new sections: "CDN (no bundler — CodePen, marketing pages, static HTML)" with the bundle URLs + choice-tree, and "Using with AI agents" pointing at the `adia-ui-kit` skill for Claude Code / Cursor / Windsurf / Claude Desktop harnesses.
15
+
3
16
  ## [0.6.29] — 2026-05-23
4
17
 
5
18
  ### Added — `dist/web-components.min.css` rolled-up CDN-ready bundle
package/README.md CHANGED
@@ -21,6 +21,37 @@ For composite shells (admin / chat / editor / simple / theme clusters), pair wit
21
21
  npm install @adia-ai/web-components @adia-ai/web-modules
22
22
  ```
23
23
 
24
+ ### Using with AI agents (Claude Code / Cursor / Windsurf / Claude Desktop)
25
+
26
+ When composing UI with an AI coding agent, load the **`adia-ui-kit` skill** in the agent's harness. It encodes:
27
+
28
+ - 95-primitive catalog (which `*-ui` tag does what + when to use it)
29
+ - Composition patterns (admin shell, dashboards, forms, chat, editor surfaces)
30
+ - Pre-flight manifest gate (catches "imports without declared deps" before authoring)
31
+ - Plan-Execute-Verify discipline (render the result in a real demo to verify)
32
+
33
+ The skill lives at [`.agents/skills/adia-ui-kit/`](https://github.com/adiahealth/gen-ui-kit/tree/main/.agents/skills/adia-ui-kit) in the repo; activation phrases include "build a page with AdiaUI", "compose this UI", "wire these components", "use AdiaUI primitives to compose…", and "what's the pattern for an admin app / dashboard / form / chat surface". Without the skill, an agent works against this README; with the skill, it has the reasoning ladder + catalog + recipes for every primitive.
34
+
35
+ ## CDN — no bundler (CodePen, marketing pages, static HTML)
36
+
37
+ Since **v0.6.30**, this package ships pre-flattened + minified bundles under `dist/` that work via jsdelivr/unpkg with zero build tooling. Drop these into any HTML page:
38
+
39
+ ```html
40
+ <!-- CSS: all primitives, tokens, resets (443 KB raw / ~50 KB gzipped) -->
41
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-components@0.6.30/dist/web-components.min.css">
42
+
43
+ <!-- JS: registers all 95 primitives (~250 KB gzipped via Brotli) -->
44
+ <script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-components@0.6.30/dist/web-components.min.js"></script>
45
+ ```
46
+
47
+ For composite shells, add the corresponding bundle from `@adia-ai/web-modules` — see [its README](../web-modules/#cdn-no-bundler--codepen-marketing-pages-static-html) or the [CDN usage guide](https://ui-kit.exe.xyz/site/cdn-usage). The kitchen-sink path is `@adia-ai/web-modules/dist/everything.min.js` (all primitives + all 4 shells; ~190 KB gzipped) — one tag for CodePen demos.
48
+
49
+ **Pick ONE bundle path.** Mixing (e.g. `everything.min.js` + a separate `web-components.min.js`) causes `customElements.define` to throw "name already defined" on dup-load. The choice tree:
50
+
51
+ - HTML-first / CodePen / marketing → `@adia-ai/web-modules/everything` (one tag covers everything)
52
+ - Primitives only, no shells → `@adia-ai/web-components/js/bundled`
53
+ - Vite/webpack/esbuild → existing root export (`import '@adia-ai/web-components'`); the `*/bundled` exports are additive — bundler consumers see no change.
54
+
24
55
  ## Quick start
25
56
 
26
57
  ESM-only — bundlers (Vite, esbuild, webpack 5+, Rollup) resolve `import` for both `.js` and `.css`; in plain HTML use `<script type="module">` + `<link rel="stylesheet">`.