@keenmate/pure-css 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -3,6 +3,46 @@
 All notable changes to `@keenmate/pure-css` are documented here. Format based on
 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [1.0.2] — 2026-09-15 [PUBLISHED]
+
+### Added
+
+- **A `--base-icon-refresh` token.** Lucide's two-curved-arrows (`refresh-cw`)
+  glyph — reload / re-fetch a view or dataset — added to `variables/_base.scss`
+  and emitted from `output-base-css-variables` (so both the standalone `base.css`
+  and the `pure-css.css` bundle carry it). Sits in the utility-icon row next to
+  `search` and `filter`; consumers spin it with a CSS animation while a refresh
+  is in flight.
+- **Three `--base-icon-*` tokens: `copy`, `ellipsis`, `save`.** Mask-friendly
+  Lucide glyphs, added to `variables/_base.scss` **and** emitted from
+  `output-base-css-variables` (so both the standalone `base.css` and the
+  `pure-css.css` bundle carry them).
+  - `copy` (two overlapping sheets) — copy-to-clipboard.
+  - `ellipsis` (three dots) — the "more / overflow" affordance. The vertical
+    variant is the **same glyph rotated 90°** (rotate-one-glyph, like `chevron`),
+    so consumers don't need a separate token.
+  - `save` (floppy disk) — persist / commit.
+
+  These complete the affordance set pure-admin migrated off Font Awesome: its
+  `--pa-icon-copy` / `-ellipsis` / `-save` already routed through these
+  `--base-icon-*` names with inline fallbacks, so they now become fully
+  theme-overridable with no pure-admin change.
+
+## [1.0.1] — 2026-09-13 [PUBLISHED]
+
+### Fixed
+
+- **Sidebar type-and-go search text was invisible on themes with a
+  mode-independent sidebar (e.g. express light).** The framed search box
+  (`.pc-sidebar__search`) sits on the **input** surface (`--base-input-bg`), but
+  its field text and its `:hover` colour used `--pc-sidebar-text` — a token tuned
+  for the **sidebar** surface. When a theme keeps the sidebar one colour across
+  modes (express: always-black sidebar → `--pc-sidebar-text: #fff`), that white
+  text landed on the light input background and vanished (white-on-white). Both
+  now use `--base-input-color`, which is emitted per-mode alongside
+  `--base-input-bg`, so the text/background pair is always legible. Affects
+  `.pc-sidebar__search-field` and `.pc-sidebar__search:hover`.
+
 ## [1.0.0] — 2026-09-12 [PUBLISHED]
 
 The **first stable release** — the 1.0.0-rc series culminates here. Two additive
@@ -138,7 +178,7 @@ pure-css mirrors it and a drift guard keeps the two honest.
 The **shared theming knob** release. Before rc07 the same visual token (a tooltip
 background, an input border, a dropdown surface) was produced *twice and
 independently* — pure-admin's `--pc-*` component tokens were baked compile-time
-literals, while the KeenMate web components read `--base-*` live — so they agreed
+literals, while the Keenmate web components read `--base-*` live — so they agreed
 only by coincidence and diverged the instant a theme retuned `--base-*` at
 runtime (every dual-mode theme does exactly this at `.pc-mode-dark`). rc07 makes
 `--base-*` the single runtime knob: override one namespace and pure-admin

package/README.md

@@ -1,26 +1,24 @@
 # @keenmate/pure-css
 
-KeenMate's CSS **foundation** — descended from [Yahoo's Pure CSS](https://purecss.io/) and extended into a
+Keenmate's CSS **foundation** — descended from [Yahoo's Pure CSS](https://purecss.io/) and extended into a
 more robust, themeable layer for real apps. One small, dependency-free package gives you the
 **`--base-*` theming contract** (one block of custom properties re-themes everything at once), a
 modern **flexbox grid** (`.pc-row` / `.pc-col`, container-query responsive — replacing Pure's float
 grid), a set of **utility classes**, and an optional **app shell + JS runtime** (in the
 `pure-css.css` bundle).
 
-It's the shared layer the whole KeenMate stack agrees on:
-[`@keenmate/pure-admin-core`](https://github.com/KeenMate/pure-admin) builds its component library on
-top of it, and every KeenMate web/Svelte component reads its colours from the same `--base-*`
+It's the shared layer the whole Keenmate stack agrees on:
+[`@keenmate/pure-admin-core`](https://github.com/Keenmate/pure-admin) builds its component library on
+top of it, and every Keenmate web/Svelte component reads its colours from the same `--base-*`
 variables.
 
-## What's New in 1.0.0
+## What's New in 1.0.2
 
-- **Icons — a `filter` glyph and a `check` / `indeterminate` selection pair join the shared `--base-*` contract** — three more mask-friendly Lucide glyphs so every consumer paints the same affordances from one theme knob. `--base-icon-filter` (a funnel) is the "refine / narrow a list" mark, deliberately separate from `--base-icon-search` (find-by-text) so a component can show both at once. `--base-icon-check` (✓) and `--base-icon-indeterminate` (−) are the checkbox / tree-node selection pair used by web-multiselect, web-treeview and plain checkboxes — `check` means selected, `indeterminate` means a tri-state parent whose children are a mix. `indeterminate` reuses the minus shape of `collapse` by default but is its own independently-overridable token, so selection never gets entangled with disclosure (the same discipline as `add` vs `expand`). All three are authored in the canonical `@keenmate/base-css-variables` package first and mirrored into `variables/_base.scss` + the emit mixin, keeping the parity drift-guard green; consume them via `mask: var(--base-icon-check); background: currentColor`.
+- **Icons — `copy`, `ellipsis`, `save` and `refresh` glyphs join the shared `--base-*` contract** — four more mask-friendly Lucide glyphs so every consumer paints the same actions from one theme knob. `--base-icon-copy` (two overlapping sheets) is copy-to-clipboard, `--base-icon-ellipsis` (three dots) is the "more / overflow" mark — its vertical `⋮` variant is the *same glyph rotated 90°* (the rotate-one-glyph discipline already used for `chevron`), so there's no separate token to maintain — `--base-icon-save` (a floppy disk) is persist / commit, and `--base-icon-refresh` (two curved arrows, Lucide `refresh-cw`) is reload / re-fetch, sitting alongside `search` and `filter` in the utility-icon row (consumers typically spin it with a CSS animation while a fetch is in flight). The action trio completes the affordance set pure-admin migrated off Font Awesome: its `--pa-icon-copy` / `-ellipsis` / `-save` already routed through these `--base-icon-*` names with inline fallbacks, so they become fully theme-overridable with zero pure-admin change. All are authored in `variables/_base.scss` and emitted from `output-base-css-variables`, so both the standalone `base.css` and the `pure-css.css` bundle carry them; consume via `mask: var(--base-icon-copy); background: currentColor`.
 
-- **Docs — mode & variant classes belong on `<html>`, not `<body>`** — a new "Mode & variant class placement" section in the README (mirrored by a `NOTE` in `_base-css-variables.scss`) documents a subtle theming pitfall. CSS resolves a custom property's `var()` at the element that *declares* it, so derived component tokens that pure-admin-core emits once at `:root` — e.g. `--pa-btn-info-bg: var(--pc-info)` — bake in `:root`'s input value. Put a `.pc-mode-dark` / `.pa-color-*` class on a descendant like `<body>` and the override arrives too late: the derived token stays frozen at its default-mode value and role buttons or surfaces don't recolour when you switch. Applying the class to `:root` (the element that declares the tokens) makes the overrides win and everything re-resolves. The section also documents the one-frame `transition: none !important` trick to suppress a colour flash during the swap.
+## What's New in 1.0.1
 
-## What's New in 1.0.0-rc09
-
-- **Namespace hygiene — the app shell no longer reaches into pure-admin's token namespace** — the KeenMate ecosystem is aligning its custom-property prefixes with its class prefixes: `--pc-*` / `.pc-*` belong to the pure-css foundation + app shell, `--pa-*` / `.pa-*` belong to pure-admin components. As part of that rename, pure-css's shell had a handful of incidental references to *component* tokens — `var(--pc-card-bg, …)` in the fit-flyout / navbar dropdown / resize-handle, `var(--pc-input-bg, …)` in the sidebar search, and `var(--pc-icon-chevron, …)` on the sidebar/navbar chevrons. Since those tokens are moving to `--pa-*` (pure-admin's namespace) and the foundation must not depend on pure-admin, each now reads its `--base-*` foundation value directly. Rendered output is byte-for-byte unchanged — every dropped tier already resolved to the same `--base-*` fallback.
+- **Sidebar search — type-and-go text is legible again on mode-independent sidebars** — the framed sidebar search box (`.pc-sidebar__search`) sits on the *input* surface (`--base-input-bg`), but its field text and `:hover` colour were painted with `--pc-sidebar-text`, a token tuned for the *sidebar* surface. On themes that keep the sidebar one colour across light and dark (e.g. express, whose sidebar is always black → `--pc-sidebar-text: #fff`), that white text landed on the light input background and vanished — white-on-white, so you couldn't read what you were typing. Both `.pc-sidebar__search-field` and `.pc-sidebar__search:hover` now read `--base-input-color`, which is emitted per-mode alongside `--base-input-bg`, so the field text always pairs with its own surface and stays readable in every theme.
 
 ## Why
 
@@ -135,7 +133,11 @@ swap the icon set.
 | `--base-icon-add` / `--base-icon-edit` / `--base-icon-delete` | `+` / pencil / trash | **CRUD action** verbs — create / modify / **destroy** (delete is a trash can, *not* an ✕, so it reads as destructive) |
 | `--base-icon-search` | magnifying glass | search inputs, command palette — find **by text** |
 | `--base-icon-filter` | funnel | refine / **narrow a list** by criteria (filter toggles, faceted search) — distinct from `search` |
+| `--base-icon-refresh` | two curved arrows | reload / re-fetch a view or dataset |
 | `--base-icon-check` / `--base-icon-indeterminate` | `✓` / `−` | **selection** pair (checkboxes, multiselect, tree nodes): `check` = selected, `indeterminate` = a tri-state parent whose children are a mix |
+| `--base-icon-copy` | two overlapping sheets | copy-to-clipboard |
+| `--base-icon-ellipsis` | three dots `⋯` | "more / overflow" affordance — **rotate-one-glyph** for the vertical `⋮` variant (rotate 90°) |
+| `--base-icon-save` | floppy disk | persist / commit |
 
 Three intentional distinctions:
 
@@ -162,7 +164,7 @@ that redeclares them, loaded *after* `base.css`:
 
 Because pure-admin-core, the components and any consumer all read the same variables, that one block
 re-themes all of them at once. This is the same model as
-[`@keenmate/pure-admin-themes`](https://github.com/KeenMate/pure-admin-themes), so the same CLI and
+[`@keenmate/pure-admin-themes`](https://github.com/Keenmate/pure-admin-themes), so the same CLI and
 publishing infrastructure applies.
 
 ### Mode & variant class placement
@@ -210,4 +212,4 @@ One intentional difference: `utilities.scss` here `@use`s `_fonts.scss` so the g
 
 ## License
 
-MIT © KeenMate. The grid is derived from [Pure](https://purecss.io/) (Yahoo!, BSD).
+MIT © Keenmate. The grid is derived from [Pure](https://purecss.io/) (Yahoo!, BSD).

package/dist/css/base.css

@@ -137,8 +137,12 @@
   --base-icon-delete: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M3 6h18%22/%3E%3Cpath d=%22M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2%22/%3E%3Cpath d=%22M10 11v6%22/%3E%3Cpath d=%22M14 11v6%22/%3E%3C/svg%3E");
   --base-icon-search: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Ccircle cx=%2211%22 cy=%2211%22 r=%228%22/%3E%3Cpath d=%22m21 21-4.3-4.3%22/%3E%3C/svg%3E");
   --base-icon-filter: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpolygon points=%2222 3 2 3 10 12.46 10 19 14 21 14 12.46 22 3%22/%3E%3C/svg%3E");
+  --base-icon-refresh: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8%22/%3E%3Cpath d=%22M21 3v5h-5%22/%3E%3Cpath d=%22M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16%22/%3E%3Cpath d=%22M3 21v-5h5%22/%3E%3C/svg%3E");
   --base-icon-check: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M20 6 9 17l-5-5%22/%3E%3C/svg%3E");
   --base-icon-indeterminate: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M5 12h14%22/%3E%3C/svg%3E");
+  --base-icon-copy: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Crect width=%2214%22 height=%2214%22 x=%228%22 y=%228%22 rx=%222%22 ry=%222%22/%3E%3Cpath d=%22M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2%22/%3E%3C/svg%3E");
+  --base-icon-ellipsis: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Ccircle cx=%2212%22 cy=%2212%22 r=%221%22/%3E%3Ccircle cx=%2219%22 cy=%2212%22 r=%221%22/%3E%3Ccircle cx=%225%22 cy=%2212%22 r=%221%22/%3E%3C/svg%3E");
+  --base-icon-save: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z%22/%3E%3Cpath d=%22M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7%22/%3E%3Cpath d=%22M7 3v4a1 1 0 0 0 1 1h7%22/%3E%3C/svg%3E");
   --base-color-1: #f59e0b;
   --base-color-2: #ec4899;
   --base-color-3: #10b981;

package/dist/css/pure-css.css

@@ -2446,7 +2446,7 @@ body.loaded .pc-sidebar__search {
 }
 .pc-sidebar__search:hover {
   border-color: #0ea5e9;
-  color: var(--pc-sidebar-text, var(--base-text-color-1));
+  color: var(--base-input-color);
 }
 .sidebar-hidden .pc-layout__sidebar--icon-collapse .pc-sidebar__search {
   width: auto;
@@ -2481,7 +2481,7 @@ body.loaded .pc-sidebar__search {
   border: none;
   outline: none;
   background: transparent;
-  color: var(--pc-sidebar-text, var(--base-text-color-1));
+  color: var(--base-input-color);
   font: inherit;
   padding: 0;
 }
@@ -3131,7 +3131,6 @@ body.pc-layout--sticky .pc-layout__inner {
   border-top: 1px solid var(--pc-border-color);
 }
 
-/* Pure Admin Visual Framework - Default Font Definitions */
 .font-family-system {
   font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
 }
@@ -6082,8 +6081,12 @@ body.pc-layout--sticky .pc-layout__inner {
   --base-icon-delete: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M3 6h18%22/%3E%3Cpath d=%22M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2%22/%3E%3Cpath d=%22M10 11v6%22/%3E%3Cpath d=%22M14 11v6%22/%3E%3C/svg%3E");
   --base-icon-search: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Ccircle cx=%2211%22 cy=%2211%22 r=%228%22/%3E%3Cpath d=%22m21 21-4.3-4.3%22/%3E%3C/svg%3E");
   --base-icon-filter: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpolygon points=%2222 3 2 3 10 12.46 10 19 14 21 14 12.46 22 3%22/%3E%3C/svg%3E");
+  --base-icon-refresh: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8%22/%3E%3Cpath d=%22M21 3v5h-5%22/%3E%3Cpath d=%22M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16%22/%3E%3Cpath d=%22M3 21v-5h5%22/%3E%3C/svg%3E");
   --base-icon-check: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M20 6 9 17l-5-5%22/%3E%3C/svg%3E");
   --base-icon-indeterminate: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M5 12h14%22/%3E%3C/svg%3E");
+  --base-icon-copy: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Crect width=%2214%22 height=%2214%22 x=%228%22 y=%228%22 rx=%222%22 ry=%222%22/%3E%3Cpath d=%22M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2%22/%3E%3C/svg%3E");
+  --base-icon-ellipsis: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Ccircle cx=%2212%22 cy=%2212%22 r=%221%22/%3E%3Ccircle cx=%2219%22 cy=%2212%22 r=%221%22/%3E%3Ccircle cx=%225%22 cy=%2212%22 r=%221%22/%3E%3C/svg%3E");
+  --base-icon-save: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z%22/%3E%3Cpath d=%22M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7%22/%3E%3Cpath d=%22M7 3v4a1 1 0 0 0 1 1h7%22/%3E%3C/svg%3E");
   --base-color-1: #f59e0b;
   --base-color-2: #ec4899;
   --base-color-3: #10b981;

package/dist/css/utilities.css

@@ -1,4 +1,3 @@
-/* Pure Admin Visual Framework - Default Font Definitions */
 .font-family-system {
   font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@keenmate/pure-css",
-  "version": "1.0.0",
-  "description": "The KeenMate CSS foundation — --base-* theming contract, PureCSS grid and utility classes. Extracted from pure-admin-core so docs sites, standalone pages and every web/svelte component share one theming layer.",
+  "version": "1.0.2",
+  "description": "The Keenmate CSS foundation — --base-* theming contract, PureCSS grid and utility classes. Extracted from pure-admin-core so docs sites, standalone pages and every web/svelte component share one theming layer.",
   "style": "dist/css/pure-css.css",
   "exports": {
     ".": "./dist/css/pure-css.css",
@@ -55,7 +55,7 @@
     "keenmate",
     "pure-admin"
   ],
-  "author": "KeenMate",
+  "author": "Keenmate",
   "license": "MIT",
   "peerDependencies": {
     "sass": "^1.0.0"
@@ -67,12 +67,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/KeenMate/pure-css.git"
+    "url": "git+https://github.com/Keenmate/pure-css.git"
   },
   "bugs": {
-    "url": "https://github.com/KeenMate/pure-css/issues"
+    "url": "https://github.com/Keenmate/pure-css/issues"
   },
-  "homepage": "https://github.com/KeenMate/pure-css#readme",
+  "homepage": "https://github.com/Keenmate/pure-css#readme",
   "publishConfig": {
     "access": "public"
   },

package/src/scss/_base-css-variables.scss

@@ -216,9 +216,11 @@
 
   // === Utility icons ===
   // search = magnifying glass (find by text); filter = funnel (refine/narrow a
-  // list — distinct affordance from search, its own knob).
+  // list — distinct affordance from search, its own knob); refresh = two curved
+  // arrows (reload/re-fetch — consumers spin it while a refresh is in flight).
   --base-icon-search: #{$base-icon-search};
   --base-icon-filter: #{$base-icon-filter};
+  --base-icon-refresh: #{$base-icon-refresh};
 
   // === Selection icons — checkbox / tree-node state pair ===
   // check = ✓ (selected), indeterminate = − (tri-state parent, partially selected).
@@ -227,6 +229,15 @@
   --base-icon-check: #{$base-icon-check};
   --base-icon-indeterminate: #{$base-icon-indeterminate};
 
+  // === Action / affordance icons ===
+  // copy = two overlapping sheets (copy-to-clipboard); ellipsis = three dots
+  // ("more / overflow" — vertical variant is the same glyph rotated 90°);
+  // save = floppy disk. Consumed by pure-admin's --pa-icon-copy / -ellipsis /
+  // -save (which fell back to inline glyphs until these landed).
+  --base-icon-copy: #{$base-icon-copy};
+  --base-icon-ellipsis: #{$base-icon-ellipsis};
+  --base-icon-save: #{$base-icon-save};
+
   // === Theme palette slots (1–9) + paired contrast text (WS7.6) ===
   // Promoted into the --base-* contract so the branded/data-viz palette is
   // themeable through the same namespace; --pc-color-N aliases these.

package/src/scss/_fonts.scss

@@ -1,4 +1,4 @@
-/* Pure Admin Visual Framework - Default Font Definitions */
+// @keenmate/pure-css — default font definitions
 
 // Default framework fonts - themes can override these
 // Note: Font size classes for <html> are in _utilities.scss (use px values for correct rem scaling)

package/src/scss/_sidebar.scss

@@ -221,7 +221,12 @@ body.pc-layout--sticky .pc-layout__sidebar {
       // alias; inlined so the shell no longer depends on the component layer
       // (variables/_components.scss now lives in pure-admin-core).
       border-color: $accent-color;
-      color: var(--pc-sidebar-text, var(--base-text-color-1));
+      // This framed box sits on the INPUT surface (--base-input-bg above), NOT
+      // the sidebar surface — so emphasise with the input text colour, not
+      // --pc-sidebar-text. In themes with a mode-independent sidebar (e.g.
+      // express: always-black sidebar → --pc-sidebar-text is white) the old
+      // sidebar-text hover went white-on-white on the light input bg.
+      color: var(--base-input-color);
     }
 
     // Collapsed rail ONLY (icon-collapse mode AND actually collapsed, i.e.
@@ -276,7 +281,14 @@ body.pc-layout--sticky .pc-layout__sidebar {
         border: none;
         outline: none;
         background: transparent;
-        color: var(--pc-sidebar-text, var(--base-text-color-1));
+        // The field shows through to the framed box's --base-input-bg surface,
+        // so its text must use the input text colour (--base-input-color), not
+        // the sidebar text colour. --pc-sidebar-text is tuned for the sidebar
+        // surface, which can be mode-independent (express: always-black sidebar
+        // → white sidebar text) and then renders white-on-white on a light
+        // input bg. --base-input-color is emitted per-mode alongside
+        // --base-input-bg, so the pair is always legible.
+        color: var(--base-input-color);
         font: inherit;
         padding: 0;
 

package/src/scss/pure-css.scss

@@ -1,6 +1,6 @@
 // @keenmate/pure-css — full foundation bundle
 // ============================================================================
-// The KeenMate CSS foundation, extracted from @keenmate/pure-admin-core so it
+// The Keenmate CSS foundation, extracted from @keenmate/pure-admin-core so it
 // can be consumed on its own (docs sites, standalone pages, non-admin portals)
 // and so pure-admin-core, themes and any web/svelte component share ONE
 // theming contract: the `--base-*` (and derived `--pc-*`) custom properties.

package/src/scss/utilities.scss

@@ -1,4 +1,4 @@
-// Pure Admin Visual - Utility Classes
+// @keenmate/pure-css — utility classes
 // Spacing utilities similar to Bootstrap/Tailwind
 // Based on rem units: 0, 0.25, 0.5, 0.75, 1, 1.25, 1.5, 2, 2.5, 3, 4, 5
 

package/src/scss/variables/_base.scss

@@ -340,6 +340,8 @@ $base-rem: 1rem !default;
 //   - search:     magnifying glass — search inputs, filter fields, command palette.
 //   - filter:     funnel — narrow a list/table by criteria (filter toggles, faceted
 //                 search). Distinct from `search` (find by text) — read as "refine".
+//   - refresh:    two curved arrows (refresh-cw) — reload / re-fetch a view or
+//                 dataset. Consumers spin it (CSS animation) while in flight.
 //
 // Selection — the checkbox / tree-node state pair (shared by web-multiselect,
 // web-treeview, checkboxes — one tick everywhere):
@@ -363,10 +365,18 @@ $base-icon-delete: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/200
 // Utility: magnifying glass (Lucide search) + funnel (Lucide filter).
 $base-icon-search: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Ccircle cx=%2211%22 cy=%2211%22 r=%228%22/%3E%3Cpath d=%22m21 21-4.3-4.3%22/%3E%3C/svg%3E") !default;
 $base-icon-filter: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpolygon points=%2222 3 2 3 10 12.46 10 19 14 21 14 12.46 22 3%22/%3E%3C/svg%3E") !default;
+// refresh = two curved arrows (Lucide refresh-cw): reload / re-fetch a view or dataset.
+$base-icon-refresh: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8%22/%3E%3Cpath d=%22M21 3v5h-5%22/%3E%3Cpath d=%22M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16%22/%3E%3Cpath d=%22M3 21v-5h5%22/%3E%3C/svg%3E") !default;
 // Selection: check = ✓ (Lucide check), indeterminate = − (Lucide minus). indeterminate
 // shares the minus shape with `collapse` but is its own knob (selection ≠ disclosure).
 $base-icon-check: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M20 6 9 17l-5-5%22/%3E%3C/svg%3E") !default;
 $base-icon-indeterminate: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M5 12h14%22/%3E%3C/svg%3E") !default;
+// copy = two overlapping sheets (Lucide copy); ellipsis = three dots (Lucide
+// ellipsis, the "more / overflow" affordance — the vertical variant is the same
+// glyph rotated 90°); save = floppy disk (Lucide save).
+$base-icon-copy: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Crect width=%2214%22 height=%2214%22 x=%228%22 y=%228%22 rx=%222%22 ry=%222%22/%3E%3Cpath d=%22M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2%22/%3E%3C/svg%3E") !default;
+$base-icon-ellipsis: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Ccircle cx=%2212%22 cy=%2212%22 r=%221%22/%3E%3Ccircle cx=%2219%22 cy=%2212%22 r=%221%22/%3E%3Ccircle cx=%225%22 cy=%2212%22 r=%221%22/%3E%3C/svg%3E") !default;
+$base-icon-save: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%23000%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z%22/%3E%3Cpath d=%22M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7%22/%3E%3Cpath d=%22M7 3v4a1 1 0 0 0 1 1h7%22/%3E%3C/svg%3E") !default;
 
 // =============================================================================
 // ALERT COLOR DERIVATION PARAMETERS