@keenmate/pure-admin-core 2.7.0 → 2.7.1

package/README.md

@@ -2,6 +2,14 @@
 
 Lightweight, data-focused CSS/SCSS admin framework with Corporate theme as default.
 
+## What's New in 2.7.1
+
+- **KPI showcases promoted to permanent core components.** The seven showcase designs (terminal grid, sparkline list, comparison gauges, hero + supporting, bento, numeric strip, editorial minimal) graduate from demo-inline `<style>`/`<script>` blocks into framework components — ~500 lines of CSS and ~350 lines of JS now live in shared sources instead of duplicated inline blocks.
+- **Eight new core SCSS partials** under `core-components/`. `_kpi-base.scss` carries the chrome shared across all seven designs (`pa-kpi-header`, `pa-kpi-live` + pulse animation, `pa-kpi-footer`, `pa-kpi-detail` hover popover, `pa-kpi-spark-dot`/`-spark-wrap`, `pa-kpi-sectionhead`); seven design-specific files carry per-design layout + typography. All wired into `_core.scss` after `data-viz`.
+- **All `kpi-*` classes renamed to `pa-kpi-*`** to match the framework's BEM prefix rule. Element (`__header`, `__live`, `__footer`, `__detail`) and modifier (`--positive`, `--negative`, `--neutral`, `--up-strong`, `--down-strong`) structures preserved 1:1.
+- **Per-component cascade variables namespace-prefixed.** `--kpi-accent` → `--pa-kpi-accent`, `--kpi-bar-color` → `--pa-kpi-bar-color`. Gauge tick knobs (`--pa-kpi-gauge-tick-pos`, `--pa-kpi-gauge-tick-color`) keep their gauge-specific names.
+- **No new framework tokens.** All sentiment, popover-chrome, sparkline-geometry, contrast-tier, and surface tokens were already emitted by `_base-css-variables.scss` from the 2.6.0 consolidation — this release reuses them.
+
 ## What's New in 2.7.0
 
 - **Full `core-components/` consolidation pass — every SCSS-baked role colour migrated to CSS custom properties.** Started with the four files deferred from 2.6.0 (`_statistics.scss` / `_data-display.scss` / `_data-viz.scss` / `_comparison.scss`) and extended to cover the rest: timelines, file selectors, query editors, lists, checkbox lists, logic trees, input wrappers, composite badges, notifications, and live-data card states. Roughly 120 SCSS-baked role-colour references migrated, so theme overrides of `--pa-success` / `--pa-warning` / `--pa-danger` / `--pa-info` now cascade into every component in `core-components/`. Many of these previously baked colours at compile time and silently ignored theme overrides.
@@ -19,15 +27,6 @@ Lightweight, data-focused CSS/SCSS admin framework with Corporate theme as defau
 - **`--pa-sidebar-submenu-active-text` — new token for high-contrast active submenu rows.** Active state set the background colour but inherited text colour from the sidebar's regular text token; on themes where the active background is an intentionally bright brand colour (e.g. corporate's blue-600), the inherited dark-mode text became unreadable against the bright active fill. New token defaults to the existing sidebar text colour (zero impact on themes that don't override the active bg) and can be set to white/high-contrast independently. Applied at both the level-2 submenu link and the collapsed-state toggle.
 - **`.pa-btn-split` chevron corners rebuilt** — the container previously used `overflow: hidden` + `border-radius` to clip both trigger buttons (which had `border-radius: 0`) to a rounded outer shape. With `display: inline-flex` adjacent buttons, hover-fill paint could bypass the rounded-corner clip on outline variants in some browsers/themes, producing square chevron corners. Rebuilt to not rely on container clipping: each trigger keeps its own `border-radius` from base `.pa-btn`; only the inner edges (between main button and chevron toggle) are flattened via logical-property radii. Per-row action buttons inside the dropdown menu are unaffected — the rule now scopes to direct children only.
 
-## What's New in 2.6.0
-
-- **Seven KPI showcase designs** under the new `KPI` sidebar group — Terminal grid (Bloomberg-style dense panel with view-mode toggle), Sparkline list (one-row-per-KPI with filled-area chart), Comparison gauges (progress bars with target tick), Hero + supporting (big focal metric + side rail), Bento (asymmetric grid with sparklines behind values), Numeric strip (tabular spreadsheet-style), and Editorial minimal (light-weight typography with hairline rules). Each page ships with a Usage Guide + CSS Classes Reference card so the markup is documented in-place.
-- **Framework token consolidation** — single source of truth for role colours (`--pa-success / --pa-warning / --pa-danger / --pa-info`), a new 5-step sentiment scale (`--pa-very-positive` through `--pa-very-negative`), text-contrast tiers (`--pa-text-strong / -secondary / -tertiary`), surface tints (`--pa-surface-hover / -track`), popover chrome (`--pa-detail-*`), and chart trendline tokens (`--pa-chart-trendline-height / -stroke`). Button + contextual surfaces rewired so a single override of `--pa-success` cascades through everything.
-- **Role colours migrated to Tailwind palette (Visual breaking)** — `$base-success-color` → `#22c55e`, `$base-warning-color` → `#f97316` (most visible: warning yellow → orange), `$base-danger-color` → `#ef4444`. Themes that override these via `!default` still win; consumers using stock defaults will see the shift on buttons, alerts, and contextual chips.
-- **`pa-stat--square` redesigned (Visual breaking)** — `__symbol` is now an inline 50%-sized companion next to `__number` (was a giant 12%-opacity watermark), markup order drives prefix-vs-suffix layout (`<symbol><number>` for `$847K`, `<number><symbol>` for `87%`), and font sizes are container-relative (`cqi`) so values track tile width instead of viewport. Multi-character units like `°C`, `¥`, `M` now render correctly at any tile size.
-- **Theme-aware dashboard chart + new `pa:theme-change` event** — the demo's D3 chart was reading CSS custom properties from `<html>` (always returned `:root` defaults) and snapshotting them once at draw time. Fixed both bugs and introduced a `pa:theme-change` window event that any consumer code with cached theme-dependent values can listen to and re-render.
-- **Progress ring / gauge dark-theme fixes** — `__inner` mask switched from compile-time `$card-bg` to runtime `var(--pa-card-bg)` so the percentage value stays readable in dark themes; track colours moved from `rgba(0,0,0,0.08)` to a `color-mix(... var(--pa-text-color-1) 12%, transparent)` so the unfilled portion is visible on both light and dark surfaces.
-
 ## Installation
 
 ```bash