admin-lte 4.4.1 → 4.6.0

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to AdminLTE will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.6.0] - 2026-08-18
+
+### Added
+
+- **Make any palette colour Bootstrap's `primary` — `data-lte-primary`.** Bootstrap compiles `$primary` into its components, so `.btn-primary` ships with `--bs-btn-bg: #0d6efd` rather than `var(--bs-primary)`: overriding the token repainted the utilities and left every button, pagination, checkbox and focus ring blue, which is why a coloured skin looked half-applied. Both colour sheets now rewire those components to variables and point them at a colour with one attribute — `<html lang="en" data-lte-primary="teal">` — covering `.btn-primary` / `.btn-outline-primary` (hover, active and disabled shaded exactly as Bootstrap shades its own), `.btn-link`, links and `.link-primary`, the `--bs-primary` token trio, `.nav-pills`, `.pagination`, `.progress-bar`, `.list-group-item.active`, `.dropdown-item.active`, `.accordion`, `.form-control` / `.form-select` focus, checkboxes, radios, switches, `.form-range`, `--bs-focus-ring-color`, and AdminLTE's `.card-primary`, `.direct-chat-primary` and `.toast-primary` — in both colour modes, with Bootstrap's dark-mode link tint. Nothing changes without the attribute, and it works on any container, so one page can carry more than one primary. Bootstrap's own theme colours are presets too (`data-lte-primary="danger"`), a brand colour outside the palette needs only `--bs-primary` (hover shades are then derived with `color-mix()` where supported), and `$lte-palette-custom: ("brand": #hex)` generates a full preset in Sass. Every skin preset now names the primary that goes with it, so applying a skin on **UI → Colors** or **Theme Customize** recolours the buttons too; both pages gained a picker and a live preview, and the Colors docs page a section (#6107, requested by @johnnyq).
+
+### Fixed
+
+- **`d-print-none` did nothing on the sidebar and the app wrapper.** The print layout fix from 4.0.0 set `display: grid !important` on `.app-wrapper` and `display: block !important` on `.app-sidebar`, and — being later in the cascade and equally `!important` — beat Bootstrap's `.d-print-none`, so those two elements could not be hidden for printing. Both rules are now scoped with `:not(.d-print-none)`: the print layout still applies to the standard layout, and the display utilities win where a page asks them to (#6106, reported by @johnnyq).
+- **The skip link went invisible on hover.** `.skip-link:hover` painted `var(--bs-primary-emphasis)`, which Bootstrap does not define (it emits `--bs-primary-text-emphasis`), so the background computed to transparent and left white text on the page background. It now uses the emphasis token — dark in light mode, light in dark mode — with the body background for the text.
+
+### Maintenance
+
+- Computed colours in both palette sheets are emitted as hex instead of Sass's `rgb(5.647%, 40.784%, 39.216%)` (cleancss leaves values inside custom properties alone), which pays for a good part of the new feature: `adminlte-colors.css` is ≈ 8 kB gzipped and `adminlte-colors-v3.css` ≈ 9.3 kB. `adminlte.css` is unchanged.
+- `npm run palette -- --check` and the unit tests also verify that every skin's primary exists in its own palette and that both sheets emit the rewiring rules and a preset per colour.
+
+## [4.5.0] - 2026-08-18
+
+### Added
+
+- **The AdminLTE 3 palette, as it was — `dist/css/adminlte-colors-v3.css`.** A second opt-in sheet for everyone who preferred the original colours: the 18 AdminLTE 3 colours (lightblue, navy, olive, lime, fuchsia, maroon, blue, indigo, purple, pink, red, orange, yellow, green, teal, cyan, gray, gray-dark) with the values from the 3.2 build and v3's text-colour rule (Bootstrap 4's YIQ test — white on lightblue, olive, teal…, dark on lime, orange, yellow), emitting exactly the same class families as the designed palette. Load one sheet or the other; they share class names. Built from the same Sass — new `$lte-palette-contrast: "wcag" | "yiq"` knob (with `$lte-palette-yiq-threshold`, `$lte-palette-yiq-text-dark/-light`) — so `$lte-palette-custom` and `$lte-palette-aliases` work with it too. Twelve AdminLTE 2 skin presets (skin-blue, -black, -purple, -green, -red, -yellow and their -light variants) in v4 terms. **UI → Colors** and **Theme Customize** gained a palette switch that swaps the stylesheet live and shows that palette's tiles, presets and pickers; the Colors docs page documents both. `npm run palette -- --check` and the unit tests keep the v3 map and its metadata in step (#6103, follow-up for @johnnyq).
+
 ## [4.4.1] - 2026-08-18
 
 ### Fixed

package/README.md

@@ -161,7 +161,7 @@ a documentation overhaul, and major dependency upgrades. See the
 - Dark mode: `.dark-mode` body class → `data-bs-theme="dark"` attribute (Bootstrap 5.3 native)
 - jQuery no longer required; plugins are vanilla TypeScript
 - The bundled `plugins/` folder is gone — every v3 jQuery widget has a documented vanilla-JS successor ([replacement table](https://adminlte.io/themes/v4/docs/migration.html#third-party-plugin-replacements): Select2 → Tom Select, DataTables → Tabulator, Summernote → Quill, …)
-- The v3 extra colours (`.bg-navy`, `.bg-teal`, the sidebar skins, …) live in an opt-in stylesheet, `dist/css/adminlte-colors.css` — fourteen redesigned colours, every one readable with white text, 17 skin presets, plus a one-line hook for your brand colour ([Colors docs](https://adminlte.io/themes/v4/docs/colors.html), [live demo](https://adminlte.io/themes/v4/UI/colors.html)). Nothing is added to `adminlte.css`.
+- The v3 extra colours (`.bg-navy`, `.bg-teal`, the sidebar skins, …) live in opt-in stylesheets: `dist/css/adminlte-colors.css` — fourteen redesigned colours, every one readable with white text, 17 skin presets, plus a one-line hook for your brand colour — or `dist/css/adminlte-colors-v3.css`, the 18 AdminLTE 3 colours exactly as they were. Either sheet also lets you make one of them Bootstrap's `primary` — `<html data-lte-primary="teal">` recolours buttons, links, pagination and form focus ([Colors docs](https://adminlte.io/themes/v4/docs/colors.html), [live demo](https://adminlte.io/themes/v4/UI/colors.html)). Nothing is added to `adminlte.css`.
 
 See the dedicated [Migration from v3](https://adminlte.io/themes/v4/docs/migration.html) guide.