Skip to content

Releases: markmead/alpinejs-component

Release list

v3.0.0 — light DOM rendering

v3.0.0 — light DOM rendering Latest
Latest

Choose a tag to compare

View all tags
@markmead markmead released this 02 Aug 07:57
v3.0.0
bd67371

v3 removes the Shadow DOM and renders component content into the light DOM. The directive API is otherwise unchanged.

Breaking

x-component-styles and its styles alias are gone, along with src/styles.js. Document styles now reach component content on their own, so there is nothing to opt into.

<!-- v2 -->
<div x-component="'person-card'" x-component-styles="person-card"></div>

<!-- v3 -->
<div x-component="'person-card'"></div>

If you relied on the shadow boundary to keep page styles out of a component, scope your CSS with @scope or a class convention instead.

Templates, .url, .external, x-slot, and the lifecycle events all carry over unchanged. See Migration From v2 for the full notes.

What dropping the shadow boundary gains you

  • Page styles apply to component content with no configuration
  • $refs and $root resolve across the host boundary
  • label[for], aria-describedby, and friends can reference component content
  • Form controls inside a component submit with an ancestor <form>
  • document.querySelector finds component content

<slot> is now resolved by manual projection rather than natively, since there is no shadow root to do it.

Known limitations

Both are documented in the README and pinned by tests on purpose:

  • A <slot> inside x-for or x-if evaluates in the component's scope instead of the host's
  • A throwing directive expression emits no x-component:error

Internals

src/ is split by responsibility — directive wiring, source resolution, template loading, slots, render, events, caching — instead of one index.js. Remote templates are parsed once and the caches are bounded.

Tooling

  • CI on every push and pull request: lint, build, a committed-output drift check, and the Playwright suite
  • The suite runs on Chromium, Firefox, and WebKit
  • Coverage for CSP and Trusted Types
  • esbuild bumped to 0.28.1

Full Changelog: v2.0.3...v3.0.0

Assets 2
Loading

v2.0.3 — final Shadow DOM release

v2.0.3 — final Shadow DOM release

Choose a tag to compare

View all tags
@markmead markmead released this 26 Jul 08:14
v2.0.3
d1963d5

The last release of the Shadow DOM architecture. v3 replaces it with light DOM rendering.

No runtime change: dist/component.esm.js is byte-identical to 2.0.2. This release exists to ship a smaller, correct package.

Packaging

A files allowlist was added after 2.0.2 was published, so the 2.0.2 tarball still carried eslint.config.js and scripts/build.js. Those are gone. The package is now exactly dist/, src/, and builds/, plus LICENSE, package.json, and README.md.

Tooling

  • Switched to pnpm; the npm lockfile was removed
  • Added Prettier across the repo
  • Bumped esbuild to 0.27.7
  • README Development instructions now use pnpm

Full Changelog: 9027d99...v2.0.3

Loading