layout-style-css 1.1.2 → 2.1.0

package/CHANGELOG.md

@@ -1,8 +1,45 @@
-# Changelog
-
-All notable changes to `layout-style-css` are documented here.
-
-This project follows semantic versioning. The `1.1.2` release is a patch recovery for the `1.1.1` package and keeps the existing `ly-*` public contract intact.
+# Changelog
+
+All notable changes to `layout-style-css` are documented here. This project follows semantic versioning.
+
+## [2.1.0] - 2026-07-20
+
+### Changed
+
+- Updated the ecosystem demo and documentation to use `ui-style-kit-css@2.1.0` visual CSS, `ui-style-kit-css/interactive-surface-theme.css`, `interactive-surface-css@1.5.0` state core, and Layout core as the canonical import order.
+- Kept `layout-style-css/integrations/ui-style-kit.css` available as a frozen deprecated structural bridge for legacy UI-prefixed layout aliases.
+- Updated release metadata and the GitHub Pages demo to identify the 2.1.0 package line.
+
+### Tests
+
+- Switched demo fixtures to consume the staged UI Style Kit 2.1 manifest, visual bundle, and token bridge while locking Interactive Surface to the released 1.5.0 package.
+
+## [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.
+
+### 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
 
@@ -12,42 +49,42 @@ This project follows semantic versioning. The `1.1.2` release is a patch recover
 - 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
-
-- Added versioned wiki documentation under `docs/wiki` for installation, layout primitives, recipes, UI Style Kit compatibility, demo deployment, publishing, security, and contribution workflows.
-- Added UI Style Kit-compatible structural aliases for `saas`, `bento`, `max`, `bau`, `tactile`, `neo`, `retro`, `brutal`, `cyber`, `y2k`, and `rg` prefixes.
-- Added layout recipe helpers for button groups, card grids, card sizing, galleries, and carousels.
-- Added F-Pattern, Z-Pattern, Split-Screen, Mondrian, and Synthwave layout styles.
-- Added `layout-style-css/all-with-ui-kit-and-interactive-surface.css` for the three-library import path.
-- Added direct `./dist/*.css` package exports for consumers that need generated dist files.
-- Added `CHANGELOG.md`, `CONTRIBUTING.md`, and `SECURITY.md` to the release documentation set.
-
-### Changed
-
-- 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.
-
-### 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.
-
-### Security
-
-- Kept the layout CSS contract free of visual properties owned by `ui-style-kit-css`.
-- Kept the package CSS-only at runtime with no network calls, dynamic script execution, or secret handling.
-- Added release verification coverage for npm pack contents and documentation completeness.
-
-## [1.0.0]
-
-### Added
-
-- Initial public release of layout primitives, layout style files, generated dist bundles, and demo coverage.
-
+
+### Added
+
+- Added versioned wiki documentation under `docs/wiki` for installation, layout primitives, recipes, UI Style Kit compatibility, demo deployment, publishing, security, and contribution workflows.
+- Added UI Style Kit-compatible structural aliases for `saas`, `bento`, `max`, `bau`, `tactile`, `neo`, `retro`, `brutal`, `cyber`, `y2k`, and `rg` prefixes.
+- Added layout recipe helpers for button groups, card grids, card sizing, galleries, and carousels.
+- Added F-Pattern, Z-Pattern, Split-Screen, Mondrian, and Synthwave layout styles.
+- Added `layout-style-css/all-with-ui-kit-and-interactive-surface.css` for the three-library import path.
+- Added direct `./dist/*.css` package exports for consumers that need generated dist files.
+- Added `CHANGELOG.md`, `CONTRIBUTING.md`, and `SECURITY.md` to the release documentation set.
+
+### Changed
+
+- 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.
+
+### 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.
+
+### Security
+
+- Kept the layout CSS contract free of visual properties owned by `ui-style-kit-css`.
+- Kept the package CSS-only at runtime with no network calls, dynamic script execution, or secret handling.
+- Added release verification coverage for npm pack contents and documentation completeness.
+
+## [1.0.0]
+
+### Added
+
+- Initial public release of layout primitives, layout style files, generated dist bundles, and demo coverage.
+

package/CONTRIBUTING.md

@@ -1,50 +1,55 @@
-# Contributing
-
-Thanks for improving `layout-style-css`. This repository is a CSS layout library, so changes should keep structure, spacing, responsive behavior, and package contracts separate from visual styling.
-
-## Local Setup
-
-```bash
-npm install
-npm run build
-npm run lint
-npm test
-```
-
-Run the full release gate before opening a release PR:
-
-```bash
-npm run release:verify
-```
-
-## Development Rules
-
-- Keep authored CSS in `styles/`.
-- 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.
-- 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/pages-artifact.test.mjs` for GitHub Pages output.
-- `stylelint` for authored CSS formatting.
-
-## Review Checklist
-
-- The package remains publishable as a public npm library.
-- 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.
-- New CSS does not introduce UI Style Kit-owned visual declarations.
-
-## Wiki Updates
-
-The source for the project wiki is `docs/wiki/`. If GitHub Wiki is enabled for the repository, mirror those files into the wiki remote after the main branch documentation is merged.
-
+# Contributing
+
+Thanks for improving `layout-style-css`. This repository is a CSS layout library, so changes should keep structure, spacing, responsive behavior, and package contracts separate from visual styling.
+
+## Local Setup
+
+```bash
+npm install
+npm run build
+npm run lint
+npm run check:demo-js
+npm test
+```
+
+Run the full release gate before opening a release PR:
+
+```bash
+npm run release:verify
+```
+
+## Development Rules
+
+- Keep authored CSS in `styles/`.
+- 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/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/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.
+
+## Review Checklist
+
+- The package remains publishable as a public npm library.
+- 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.
+- Chromium, Firefox, and WebKit pass for release-facing rendered changes.
+- New CSS does not introduce UI Style Kit-owned visual declarations.
+
+## Wiki Updates
+
+The source for the project wiki is `docs/wiki/`. If GitHub Wiki is enabled for the repository, mirror those files into the wiki remote after the main branch documentation is merged.
+

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Foscat
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Foscat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.