layout-style-css 1.1.1 → 2.0.0

package/CHANGELOG.md

@@ -1,10 +1,42 @@
 # Changelog
 
-All notable changes to `layout-style-css` are documented here.
-
-This project follows semantic versioning. The `1.1.1` release is additive and keeps the existing `ly-*` public contract intact.
+All notable changes to `layout-style-css` are documented here. This project follows semantic versioning.
+
+## [2.0.0] - 2026-07-19
+
+### Breaking
+
+- Rebuilt the package as a dependency-free, container-first layout system requiring Node.js 20 or newer for development scripts.
+- Replaced size-tier wrappers with compact, prose, content, wide, full, and breakout semantics; wrappers now include fluid logical gutters and safe-area compensation.
+- Standardized personalities, recipes, and regions on `data-ly-layout`, `data-ly-recipe`, and `data-ly-area`.
+- Replaced root personality exports and companion `all-with-ui-kit*` aggregates with focused modules under `personalities/` and `integrations/`.
+- Moved v1 containers, root hooks, columns, and recipe aliases into the opt-in `legacy.css` bundle for the v2 line; removal is scheduled for v3.
+
+### Added
+
+- Added stack, cluster, center, cover, switcher, sidebar, grid, split, panes, media, reel, frame, and bounded-scroll primitives.
+- Added seven functional recipes that preserve mobile DOM, reading, and focus order while rearranging named areas at `48rem` and `64rem` container thresholds.
+- Made every `data-ly-recipe` value a complete alternative to its matching class and kept explicit wrapper measures authoritative under all personalities.
+- Added sixteen spatially distinct personalities across left-rail, right-rail, three-zone, mosaic, and equal-split families.
+- Added explicit base, medium-container, and large-container order escape hatches with accessibility guidance.
+- Added a maintainable interactive layout lab with allowlisted query state, copyable snippets, ecosystem modes, and rendered coverage at 375px, 768px, 1280px, and 1440px.
+- Added a complete 1.x-to-2.0 migration guide, Node.js 20/22 CI, and Chromium, Firefox, and WebKit release verification.
 
-## [1.1.1] - 2026-07-05
+### Integration
+
+- Pinned `ui-style-kit-css@2.0.1` and `interactive-surface-css@1.4.0` as development fixtures only; the default package has no companion imports, peer dependencies, or runtime dependencies.
+- Documented the all-three import order as UI Style Kit bridge, Interactive Surface `state-core.css`, Layout integration bridge, then Layout core.
+- Kept the upcoming UI Style Kit revision as a follow-up outside this release.
+- Preserved structural v1 `.ly-content` and `.ly-divider` compatibility while leaving the removed paint-owned `.ly-surface--raised` selector to UI Style Kit or application themes.
+
+## [1.1.2] - 2026-07-08
+
+### Fixed
+
+- Reissued the release metadata, package lock, README install examples, wiki checklist, and publish workflow recovery tag under `1.1.2`.
+- Kept the additive `1.1.1` CSS and documentation contract intact while moving the publish target to a clean patch version.
+
+## [1.1.1] - 2026-07-05
 
 ### Added
 
@@ -21,16 +53,16 @@ This project follows semantic versioning. The `1.1.1` release is additive and ke
 - Reworked the demo mobile controls into a compact drawer so the sticky header does not consume the mobile viewport.
 - Expanded the demo to cover app shell, wrappers, split layouts, sidebars, panes, button groups, card grids, card sizes, galleries, carousels, frames, and scroll areas.
 - Updated README examples to use exported CSS entrypoints and valid CDN links.
-- Updated npm release metadata, package file allowlist, and release verification scripts for the `1.1.1` package.
-- Updated the npm publish workflow to publish from `release.published` events and explicit `workflow_dispatch` tags.
+- Updated npm release metadata, package file allowlist, and release verification scripts for the `1.1.1` package.
+- Updated the npm publish workflow to publish from `release.published` events and explicit `workflow_dispatch` tags.
 
 ### Fixed
 
 - Fixed README quick-start imports that referenced non-exported paths.
-- Fixed malformed UI Style Kit CDN link markup in the README.
-- Clarified responsive column utility documentation so class groups do not imply bare numeric class names.
-- Preserved GitHub Pages artifact generation with a Pages-root `index.html`.
-- Fixed the release automation path so draft releases can be published before the npm workflow runs.
+- Fixed malformed UI Style Kit CDN link markup in the README.
+- Clarified responsive column utility documentation so class groups do not imply bare numeric class names.
+- Preserved GitHub Pages artifact generation with a Pages-root `index.html`.
+- Fixed the release automation path so draft releases can be published before the npm workflow runs.
 
 ### Security
 

package/CONTRIBUTING.md

@@ -6,9 +6,10 @@ Thanks for improving `layout-style-css`. This repository is a CSS layout library
 
 ```bash
 npm install
-npm run build
-npm run lint
-npm test
+npm run build
+npm run lint
+npm run check:demo-js
+npm test
 ```
 
 Run the full release gate before opening a release PR:
@@ -23,15 +24,18 @@ npm run release:verify
 - Regenerate `dist/` with `npm run build`; do not hand-edit generated dist files.
 - Keep public layout classes prefixed with `ly-`.
 - Leave colors, typography, borders, shadows, native controls, focus states, themes, and modes to `ui-style-kit-css`.
-- Add structural aliases in `styles/layout-ui-style-kit-bridge.css` only when they map to layout primitives or layout recipes.
+- Add structural aliases in `styles/integrations/ui-style-kit.css` only when they map to layout primitives or layout recipes.
+- Preserve semantic mobile DOM, reading, and focus order; built-in recipes must use named areas instead of `order`.
+- Test container behavior below and above `48rem` and `64rem`.
 - Update README, `docs/wiki`, and `CHANGELOG.md` when a public class, export, recipe, release workflow, or package behavior changes.
 
 ## Testing Expectations
 
 Every change that affects public behavior should update or preserve:
 
-- `test/layout-css-contract.test.mjs` for package, CSS, docs, and tarball contracts.
-- `test/demo-smoke.test.mjs` for rendered demo behavior.
+- `test/layout-css-contract.test.mjs` for package, CSS, docs, and tarball contracts.
+- `test/release-docs-contract.test.mjs` for current documentation and workflow contracts.
+- `test/demo-smoke.test.mjs` for rendered demo behavior.
 - `test/pages-artifact.test.mjs` for GitHub Pages output.
 - `stylelint` for authored CSS formatting.
 
@@ -41,7 +45,8 @@ Every change that affects public behavior should update or preserve:
 - The npm tarball contains only intended release files.
 - README examples use exported package entrypoints.
 - Documentation links resolve to versioned files.
-- Demo controls remain compact on mobile and tablet viewports.
+- Demo controls remain compact on mobile and tablet viewports.
+- Chromium, Firefox, and WebKit pass for release-facing rendered changes.
 - New CSS does not introduce UI Style Kit-owned visual declarations.
 
 ## Wiki Updates