@parallelogram-js/core
v0.7.20
Published
A lightweight, enhancement-first JavaScript framework for progressive web applications
Maintainers
Readme
@parallelogram-js/core adds behaviour to server-rendered HTML through data attributes and a small set of web components. Components load the first time a page uses them, and links swap the page in place instead of reloading it.
npm install @parallelogram-js/coreThe package is ESM only and targets Baseline 2023 browsers: Chrome and Edge 120, Firefox 121, and Safari 17.2 or later.
The framework is optional. Any enhancement can be used on its own — import Toggle from '@parallelogram-js/core/components/Toggle', then Toggle.enhanceAll() mounts it on every matching element, with no framework and no build step beyond your bundler.
Versions and browser support
- Releases follow semantic versioning from 1.0. Before it, any release may rename or remove something; each such change is marked Breaking in the changelog with what to change, and the upgrade guides carry the same list. 0.7.7 and 0.7.8 were patch releases with breaking changes, and an earlier version of this line said that never happened.
- Where something is deprecated rather than removed outright, it is announced in the changelog and keeps working for at least one minor release and thirty days, whichever is longer, before it goes. The wall-clock half matters: 0.5.0 to 0.6.0 took six hours, and a window measured only in releases is no window at all when a release costs an afternoon.
- The browser floor is Baseline 2023: Chrome and Edge 120, Firefox 121, and Safari 17.2 on macOS and iOS, or later. Older browsers aren't tested or supported.
- Only the latest minor release line gets security fixes. See SECURITY.md for how to report a vulnerability.
Documentation
- Documentation site, with a page and live example for every component
- Getting started
- Pages and the router
- Writing a component
- Events and alerts
- Upgrading from 0.5 to 0.6
- Upgrading from 0.4 to 0.5
- llms.txt, the documentation index for coding agents
- Changelog
License
Sortable, Swappable and Droppable are built on a port of Shopify Draggable, used under its MIT licence. THIRD-PARTY-NOTICES.md reproduces it.
