photon-grid-core 2.0.4 → 2.0.6

package/styles/themes/theme-quartz.js

@@ -1,27 +1,35 @@
-/* pg-quartz-theme — clean, modern blue (default look) */
+/**
+ * pg-quartz-theme — clean, modern (blue accent).
+ *
+ * A cosmetic *variant* layered on top of the active color mode (light/dark).
+ * It only overrides structural / appearance concerns — density, radii,
+ * typography, accent color, checkbox shape, motion, and the distinctive quartz
+ * "chrome" tint. All base surface, text and border colors are inherited from
+ * the mode tokens (`var(--pg-colors-*)`), so this variant renders correctly in
+ * both light and dark.
+ *
+ * The container carries the `.pg-quartz-theme` class; `.pg-grid` is its child,
+ * hence the descendant selectors below.
+ */
 export const themeQuartzCss = `
 
-/* ──────────── pg-quartz-theme variables ──────────── */
+/* ──────────── pg-quartz-theme: structural + accent tokens ──────────── */
 .pg-quartz-theme .pg-grid {
-  --pg-colors-border: #ddddde;
-  --pg-colors-header-background: #f8fafc;
-  --pg-colors-header-border: #ddddde;
-  --pg-colors-header-text: #475569;
-  --pg-colors-row-background: #ffffff;
-  --pg-colors-row-alt-background: #f8fafc;
-  --pg-colors-row-hover: #f1f5f9;
-  --pg-colors-row-selected: #eff6ff;
-  --pg-colors-row-selected-hover: #dbeafe;
-  --pg-colors-text-primary: #0f172a;
-  --pg-colors-text-secondary: #64748b;
-  --pg-colors-text-muted: #94a3b8;
-  --pg-colors-text-disabled: #cbd5e1;
+  /* Accent identity — drives sorted headers, selection, checkboxes, links. */
   --pg-colors-primary: #2563eb;
-  --pg-colors-filter-background: #ffffff;
-  --pg-colors-scrollbar-bg: #f8fafc;
-  --pg-colors-badge-background: #dbeafe;
-  --pg-colors-badge-text: #1e40af;
 
+  /* Quartz "chrome" surface — the flat tint shared by every non-data surface
+     (header, footer/pagination, top grouping row, scrollbars, serial-number
+     column). Derived from the mode's alt background so it tints correctly in
+     both light and dark; defined once here so the look changes in one place. */
+  --pg-quartz-chrome-background: var(--pg-colors-background-alt);
+  --pg-colors-header-background: var(--pg-quartz-chrome-background);
+  --pg-colors-filter-background: var(--pg-quartz-chrome-background);
+  --pg-colors-footer-background: var(--pg-quartz-chrome-background);
+  --pg-colors-scrollbar-bg: var(--pg-quartz-chrome-background);
+  --pg-colors-scrollbar-track: var(--pg-quartz-chrome-background);
+
+  /* Typography identity */
   --pg-typography-font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
   --pg-typography-font-size-md: 0.8rem;
   --pg-typography-font-size-sm: 12px;
@@ -30,57 +38,60 @@ export const themeQuartzCss = `
   --pg-typography-font-weight-semi-bold: 600;
   --pg-typography-letter-spacing-wide: 0.06em;
 
+  /* Density */
   --pg-header-row-height: 40px;
   --pg-row-height: 44px;
+
+  /* Shape */
   --pg-borders-radius-md: 6px;
   --pg-borders-radius-sm: 4px;
   --pg-borders-radius-pill: 9999px;
-  --pg-transitions-duration-fast: 150ms;
   --pg-sizing-checkbox-size: 16px;
-  --pg-colors-resize-handle-color: #ddddde;
+
+  /* Motion */
+  --pg-transitions-duration-fast: 150ms;
 }
 
-/* Quartz header — title case, semi-bold */
+/* Quartz header — capitalized, semi-bold; color follows the mode. */
 .pg-quartz-theme .pg-th {
   text-transform: capitalize;
   font-size: 13px;
   font-weight: 600;
   letter-spacing: 0;
-  color: #475569;
+  color: var(--pg-colors-header-text);
 }
-// .pg-quartz-theme .pg-th--sorted { color: #2563eb; }
 
-/* Quartz row — bottom divider uses the theme border color */
+/* Quartz row — bottom divider uses the mode border color */
 .pg-quartz-theme .pg-row { border-bottom: 1px solid var(--pg-colors-border); }
 
-/* Quartz icon tones */
-.pg-quartz-theme .pg-icon { color: #64748b; }
-.pg-quartz-theme .pg-th--sorted .pg-icon { color: #2563eb; }
-.pg-quartz-theme .pg-row-drag-handle { color: #94a3b8; }
-.pg-quartz-theme .pg-th--no-group { background-color: #f8fafc; }
+/* Quartz icon tones — mode-aware */
+.pg-quartz-theme .pg-icon { color: var(--pg-colors-text-secondary); }
+.pg-quartz-theme .pg-th--sorted .pg-icon { color: var(--pg-colors-primary); }
+.pg-quartz-theme .pg-row-drag-handle { color: var(--pg-colors-text-disabled); }
+.pg-quartz-theme .pg-th--no-group { background: var(--pg-quartz-chrome-background); }
 
-/* Quartz checkbox — 16px, 4px-radius square, solid blue on check */
+/* Quartz checkbox — 16px, 4px-radius square, solid accent on check */
 .pg-quartz-theme .pg-checkbox {
   appearance: none;
   -webkit-appearance: none;
   width: 16px;
   height: 16px;
-  border: 2px solid #cbd5e1;
+  border: 2px solid var(--pg-colors-checkbox-border);
   border-radius: 4px;
-  background: #fff;
+  background: var(--pg-colors-checkbox-background);
   cursor: pointer;
   position: relative;
   flex-shrink: 0;
   transition: background 150ms ease, border-color 150ms ease, box-shadow 150ms ease;
 }
-.pg-quartz-theme .pg-checkbox:hover { border-color: #2563eb; }
+.pg-quartz-theme .pg-checkbox:hover { border-color: var(--pg-colors-primary); }
 .pg-quartz-theme .pg-checkbox:focus-visible {
   outline: none;
-  box-shadow: 0 0 0 3px rgba(37,99,235,0.25);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--pg-colors-primary) 25%, transparent);
 }
 .pg-quartz-theme .pg-checkbox:checked {
-  background: #2563eb;
-  border-color: #2563eb;
+  background: var(--pg-colors-primary);
+  border-color: var(--pg-colors-primary);
 }
 .pg-quartz-theme .pg-checkbox:checked::after {
   content: '';
@@ -89,14 +100,14 @@ export const themeQuartzCss = `
   top: 1px;
   width: 5px;
   height: 9px;
-  border: 2px solid #fff;
+  border: 2px solid var(--pg-colors-primary-text);
   border-top: none;
   border-left: none;
   transform: rotate(45deg);
 }
 .pg-quartz-theme .pg-checkbox:indeterminate {
-  background: #2563eb;
-  border-color: #2563eb;
+  background: var(--pg-colors-primary);
+  border-color: var(--pg-colors-primary);
 }
 .pg-quartz-theme .pg-checkbox:indeterminate::after {
   content: '';
@@ -105,16 +116,26 @@ export const themeQuartzCss = `
   top: 50%;
   width: 8px;
   height: 2px;
-  background: #fff;
+  background: var(--pg-colors-primary-text);
   transform: translateY(-50%);
 }
 
-/* Quartz row selection highlight — blue left bar */
-.pg-quartz-theme .pg-row--selected { box-shadow: inset 3px 0 0 #2563eb; }
+/* Quartz row selection highlight — accent left bar */
+// .pg-quartz-theme .pg-row--selected { box-shadow: inset 3px 0 0 var(--pg-colors-primary); }
 
 /* Quartz row-drag animation — smooth cubic-bezier */
 .pg-quartz-theme .pg-grid--row-dragging .pg-row {
   transition: background 150ms ease, top 130ms cubic-bezier(0.2, 0, 0, 1);
 }
+
+/* ──────────── Quartz chrome tint — serial (row number) column ────────────
+   Header, filter and body cells of the serial column share the chrome surface
+   so the number gutter reads as grid chrome rather than data. (Scrollbars and
+   the header/footer/grouping surfaces are driven by the tokens above.) */
+.pg-quartz-theme .pg-th--serial,
+.pg-quartz-theme .pg-filter-cell--serial,
+.pg-quartz-theme .pg-cell--serial {
+  background: var(--pg-quartz-chrome-background);
+}
 `;
 //# sourceMappingURL=theme-quartz.js.map

package/styles/themes/theme-quartz.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-quartz.js","sourceRoot":"","sources":["../../../src/styles/themes/theme-quartz.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqH7B,CAAC"}
+{"version":3,"file":"theme-quartz.js","sourceRoot":"","sources":["../../../src/styles/themes/theme-quartz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8H7B,CAAC"}

package/theme/theme-manager.d.ts

@@ -1,20 +1,68 @@
-import type { Theme, BuiltInThemeName } from '../types/theme.types';
+import type { Theme, BuiltInThemeName, ThemeMode, ThemeVariant } from '../types/theme.types';
 import type { EventBus } from '../event-bus/event-bus';
+/**
+ * Coordinates the two independent theming axes:
+ *
+ * 1. **Mode** (`light` / `dark`) — the full color palette, injected as design
+ *    tokens (CSS custom properties) scoped to the grid's container element.
+ * 2. **Variant** (`quartz` / `alpine` / …) — a cosmetic skin applied as a CSS
+ *    class on that same container. Variant stylesheets only override structural
+ *    and accent concerns, so any variant composes with either mode.
+ *
+ * Mode tokens are additionally mirrored onto `:root` so fixed/portal elements
+ * (menus, dropdowns, overlays appended to `<body>`) inherit the palette.
+ */
 export declare class ThemeManager {
-    private eventBus;
-    private injector;
-    private rootInjector;
-    private registry;
-    private activeTheme;
+    private readonly eventBus;
+    /** Per-instance stylesheet carrying the active mode's tokens. */
+    private readonly injector;
+    /** Mirrors mode tokens onto `:root` for portaled elements. */
+    private readonly rootInjector;
+    private readonly registry;
+    private activeMode;
+    private activeVariant;
     private scopeEl;
+    /** Monotonic source for unique per-instance scope ids. */
+    private static scopeSeq;
     constructor(eventBus: EventBus);
+    /** Register (or replace) a mode theme so it can be resolved by name. */
     registerTheme(theme: Theme): void;
+    /**
+     * Apply a color mode (light/dark) by injecting its tokens. Colors cascade
+     * from the container down to every cell; the same tokens are mirrored to
+     * `:root` for portaled UI. Does not touch the active variant.
+     */
+    applyMode(modeOrTheme: ThemeMode | Theme, scopeEl?: HTMLElement): void;
+    /**
+     * Apply (or clear) the cosmetic variant skin. Swaps the `pg-<variant>-theme`
+     * class on the scope container; passing `'none'` removes any active variant.
+     */
+    applyVariant(variant: ThemeVariant | 'none', scopeEl?: HTMLElement): void;
+    /**
+     * Backward-compatible entry point for the deprecated `theme` option / API.
+     * Normalizes a legacy value (e.g. `'dark'`, `'quartz'`, `'pg-quartz-theme'`,
+     * `'quartz-dark'`) onto the mode/variant axes and applies it.
+     *
+     * @deprecated Prefer {@link applyMode} + {@link applyVariant}.
+     */
     applyTheme(nameOrTheme: BuiltInThemeName | string | Theme, scopeEl?: HTMLElement): void;
-    getActiveTheme(): Theme | null;
+    /** The active mode theme (light/dark). Never null after construction. */
+    getActiveTheme(): Theme;
+    /** The active mode as a plain string. */
+    getActiveMode(): ThemeMode;
+    /** The active variant, or `'none'` when no skin is applied. */
+    getActiveVariant(): ThemeVariant | 'none';
     getTheme(name: string): Theme | undefined;
     getAllThemes(): Theme[];
+    /** Toggle between light and dark mode, preserving the active variant. */
     toggleDarkMode(): void;
     isDarkMode(): boolean;
     destroy(): void;
+    /** Resolve a mode name or Theme object to a concrete light/dark Theme. */
+    private resolveModeTheme;
+    /** Ensure the scope element carries a stable id used to target its tokens. */
+    private ensureScopeId;
+    /** Map a legacy `theme` string onto the mode/variant axes. */
+    private static parseLegacyTheme;
 }
 //# sourceMappingURL=theme-manager.d.ts.map

package/theme/theme-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-manager.d.ts","sourceRoot":"","sources":["../../src/theme/theme-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMvD,qBAAa,YAAY;IASX,OAAO,CAAC,QAAQ;IAR5B,OAAO,CAAC,QAAQ,CAAwB;IAGxC,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,OAAO,CAA4B;gBAEvB,QAAQ,EAAE,QAAQ;IAKtC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIjC,UAAU,CACR,WAAW,EAAE,gBAAgB,GAAG,MAAM,GAAG,KAAK,EAC9C,OAAO,CAAC,EAAE,WAAW,GACpB,IAAI;IAoCP,cAAc,IAAI,KAAK,GAAG,IAAI;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,YAAY,IAAI,KAAK,EAAE;IAIvB,cAAc,IAAI,IAAI;IAQtB,UAAU,IAAI,OAAO;IAIrB,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"theme-manager.d.ts","sourceRoot":"","sources":["../../src/theme/theme-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAoBvD;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IAcX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAbrC,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,OAAO,CAA4B;IAE3C,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAK;gBAEC,QAAQ,EAAE,QAAQ;IAM/C,wEAAwE;IACxE,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIjC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IA2BtE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAkBzE;;;;;;OAMG;IACH,UAAU,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAmBvF,yEAAyE;IACzE,cAAc,IAAI,KAAK;IAIvB,yCAAyC;IACzC,aAAa,IAAI,SAAS;IAI1B,+DAA+D;IAC/D,gBAAgB,IAAI,YAAY,GAAG,MAAM;IAIzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,YAAY,IAAI,KAAK,EAAE;IAIvB,yEAAyE;IACzE,cAAc,IAAI,IAAI;IAItB,UAAU,IAAI,OAAO;IAIrB,OAAO,IAAI,IAAI;IAOf,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB;IAKxB,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IASrB,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAuBhC"}

package/theme/theme-manager.js

@@ -1,56 +1,129 @@
+import { THEME_VARIANT_CLASS } from '../types/theme.types';
 import { GridEventType } from '../types/event.types';
 import { CssVarInjector } from './css-var-injector';
 import { lightTheme } from './themes/light-theme';
 import { darkTheme } from './themes/dark-theme';
+/** Attribute used to scope a grid instance's mode tokens to its container. */
+const SCOPE_ATTR = 'data-pg-theme-scope';
+/** Matches any `pg-<name>-theme` variant class so it can be swapped cleanly. */
+const VARIANT_CLASS_RE = /^pg-[a-z0-9]+-theme$/;
+/**
+ * Coordinates the two independent theming axes:
+ *
+ * 1. **Mode** (`light` / `dark`) — the full color palette, injected as design
+ *    tokens (CSS custom properties) scoped to the grid's container element.
+ * 2. **Variant** (`quartz` / `alpine` / …) — a cosmetic skin applied as a CSS
+ *    class on that same container. Variant stylesheets only override structural
+ *    and accent concerns, so any variant composes with either mode.
+ *
+ * Mode tokens are additionally mirrored onto `:root` so fixed/portal elements
+ * (menus, dropdowns, overlays appended to `<body>`) inherit the palette.
+ */
 export class ThemeManager {
     constructor(eventBus) {
         this.eventBus = eventBus;
+        /** Per-instance stylesheet carrying the active mode's tokens. */
         this.injector = new CssVarInjector();
-        // A second injector always sets variables on :root so that fixed-position
-        // elements appended to <body> (menus, dropdowns, overlays) can inherit them.
+        /** Mirrors mode tokens onto `:root` for portaled elements. */
         this.rootInjector = new CssVarInjector();
         this.registry = new Map();
-        this.activeTheme = null;
+        this.activeVariant = 'none';
         this.scopeEl = null;
         this.registry.set('light', lightTheme);
         this.registry.set('dark', darkTheme);
+        this.activeMode = lightTheme;
     }
+    /** Register (or replace) a mode theme so it can be resolved by name. */
     registerTheme(theme) {
         this.registry.set(theme.name, theme);
     }
-    applyTheme(nameOrTheme, scopeEl) {
-        let theme;
-        if (typeof nameOrTheme === 'string') {
-            theme = this.registry.get(nameOrTheme);
-            if (!theme) {
-                console.warn(`[PhotonGrid] Theme "${nameOrTheme}" not found. Falling back to "light".`);
-                theme = lightTheme;
-            }
+    /**
+     * Apply a color mode (light/dark) by injecting its tokens. Colors cascade
+     * from the container down to every cell; the same tokens are mirrored to
+     * `:root` for portaled UI. Does not touch the active variant.
+     */
+    applyMode(modeOrTheme, scopeEl) {
+        const theme = this.resolveModeTheme(modeOrTheme);
+        this.activeMode = theme;
+        if (scopeEl)
+            this.scopeEl = scopeEl;
+        const target = this.scopeEl;
+        if (target) {
+            const scopeId = this.ensureScopeId(target);
+            this.injector.injectAsStylesheet(theme.tokens, `[${SCOPE_ATTR}="${scopeId}"]`);
+            target.setAttribute('data-pg-mode', theme.mode);
+            // `color-scheme` is inherited, so setting it on the container makes every
+            // native control inside (filter inputs/selects, date pickers, native
+            // scrollbars) render with the correct light/dark chrome.
+            target.style.colorScheme = theme.mode;
         }
         else {
-            theme = nameOrTheme;
-            this.registry.set(theme.name, theme);
+            this.injector.injectAsStylesheet(theme.tokens, ':root');
+            document.documentElement.setAttribute('data-pg-mode', theme.mode);
+            document.documentElement.style.colorScheme = theme.mode;
         }
-        this.scopeEl = scopeEl ?? null;
-        this.activeTheme = theme;
-        const selector = scopeEl
-            ? `[data-photon-grid-id="${scopeEl.getAttribute('data-photon-grid-id')}"]`
-            : ':root';
-        this.injector.injectAsStylesheet(theme.tokens, selector);
         // Always mirror variables to :root so fixed/portal elements pick them up.
         this.rootInjector.inject(theme.tokens, document.documentElement);
-        if (scopeEl) {
-            scopeEl.setAttribute('data-pg-theme', theme.name);
-            scopeEl.setAttribute('data-pg-mode', theme.mode);
+        this.eventBus.emit(GridEventType.THEME_CHANGED, { themeName: theme.name });
+    }
+    /**
+     * Apply (or clear) the cosmetic variant skin. Swaps the `pg-<variant>-theme`
+     * class on the scope container; passing `'none'` removes any active variant.
+     */
+    applyVariant(variant, scopeEl) {
+        if (scopeEl)
+            this.scopeEl = scopeEl;
+        const target = this.scopeEl ?? document.documentElement;
+        // Remove any previously applied variant class before adding the new one.
+        for (const cls of Array.from(target.classList)) {
+            if (VARIANT_CLASS_RE.test(cls))
+                target.classList.remove(cls);
+        }
+        this.activeVariant = variant;
+        if (variant !== 'none') {
+            target.classList.add(THEME_VARIANT_CLASS[variant]);
+            target.setAttribute('data-pg-variant', variant);
         }
         else {
-            document.documentElement.setAttribute('data-pg-theme', theme.name);
-            document.documentElement.setAttribute('data-pg-mode', theme.mode);
+            target.removeAttribute('data-pg-variant');
         }
-        this.eventBus.emit(GridEventType.THEME_CHANGED, { themeName: theme.name });
     }
+    /**
+     * Backward-compatible entry point for the deprecated `theme` option / API.
+     * Normalizes a legacy value (e.g. `'dark'`, `'quartz'`, `'pg-quartz-theme'`,
+     * `'quartz-dark'`) onto the mode/variant axes and applies it.
+     *
+     * @deprecated Prefer {@link applyMode} + {@link applyVariant}.
+     */
+    applyTheme(nameOrTheme, scopeEl) {
+        if (typeof nameOrTheme !== 'string') {
+            this.registry.set(nameOrTheme.name, nameOrTheme);
+            this.applyMode(nameOrTheme, scopeEl);
+            return;
+        }
+        const { mode, variant } = ThemeManager.parseLegacyTheme(nameOrTheme);
+        if (scopeEl)
+            this.scopeEl = scopeEl;
+        if (mode)
+            this.applyMode(mode, scopeEl);
+        if (variant !== undefined)
+            this.applyVariant(variant, scopeEl);
+        if (!mode && variant === undefined) {
+            console.warn(`[PhotonGrid] Theme "${nameOrTheme}" not recognized. Expected a mode ` +
+                `('light' | 'dark') or variant ('quartz' | 'alpine' | 'balham' | 'material').`);
+        }
+    }
+    /** The active mode theme (light/dark). Never null after construction. */
     getActiveTheme() {
-        return this.activeTheme;
+        return this.activeMode;
+    }
+    /** The active mode as a plain string. */
+    getActiveMode() {
+        return this.activeMode.mode;
+    }
+    /** The active variant, or `'none'` when no skin is applied. */
+    getActiveVariant() {
+        return this.activeVariant;
     }
     getTheme(name) {
         return this.registry.get(name);
@@ -58,22 +131,53 @@ export class ThemeManager {
     getAllThemes() {
         return Array.from(this.registry.values());
     }
+    /** Toggle between light and dark mode, preserving the active variant. */
     toggleDarkMode() {
-        const current = this.activeTheme;
-        if (!current)
-            return;
-        const targetName = current.mode === 'light' ? 'dark' : 'light';
-        const target = this.registry.get(targetName);
-        if (target)
-            this.applyTheme(target, this.scopeEl ?? undefined);
+        this.applyMode(this.activeMode.mode === 'light' ? 'dark' : 'light');
     }
     isDarkMode() {
-        return this.activeTheme?.mode === 'dark';
+        return this.activeMode.mode === 'dark';
     }
     destroy() {
         this.injector.remove();
         this.rootInjector.remove();
-        this.activeTheme = null;
+    }
+    // ──────────────────── internals ────────────────────
+    /** Resolve a mode name or Theme object to a concrete light/dark Theme. */
+    resolveModeTheme(modeOrTheme) {
+        if (typeof modeOrTheme !== 'string')
+            return modeOrTheme;
+        return this.registry.get(modeOrTheme) ?? lightTheme;
+    }
+    /** Ensure the scope element carries a stable id used to target its tokens. */
+    ensureScopeId(el) {
+        let id = el.getAttribute(SCOPE_ATTR);
+        if (!id) {
+            id = `pg-scope-${(ThemeManager.scopeSeq += 1)}`;
+            el.setAttribute(SCOPE_ATTR, id);
+        }
+        return id;
+    }
+    /** Map a legacy `theme` string onto the mode/variant axes. */
+    static parseLegacyTheme(name) {
+        // Strip the historical `pg-…-theme` wrapper so `pg-quartz-theme` → `quartz`.
+        const normalized = name
+            .trim()
+            .toLowerCase()
+            .replace(/^pg-/, '')
+            .replace(/-theme$/, '');
+        if (normalized === 'light' || normalized === 'dark') {
+            return { mode: normalized };
+        }
+        // Split an optional trailing mode suffix, e.g. `quartz-dark`.
+        const [base, suffix] = normalized.split('-');
+        const mode = suffix === 'light' || suffix === 'dark' ? suffix : undefined;
+        if (base === 'quartz' || base === 'alpine' || base === 'balham' || base === 'material') {
+            return { variant: base, mode };
+        }
+        return {};
     }
 }
+/** Monotonic source for unique per-instance scope ids. */
+ThemeManager.scopeSeq = 0;
 //# sourceMappingURL=theme-manager.js.map

package/theme/theme-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-manager.js","sourceRoot":"","sources":["../../src/theme/theme-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme-manager.js","sourceRoot":"","sources":["../../src/theme/theme-manager.ts"],"names":[],"mappings":"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"}

package/theme/themes/light-theme.js

@@ -42,7 +42,7 @@ export const lightTheme = {
             footerBorder: '#e2e8f0',
             pinnedBackground: '#ffffff',
             pinnedShadow: '4px 0 6px -2px rgba(15,23,42,0.08)',
-            filterBackground: '#ffffff',
+            filterBackground: '#f8fafc',
             filterBorder: '#e2e8f0',
             filterActiveBackground: '#eff6ff',
             filterActiveBorder: '#93c5fd',

package/types/column.types.d.ts

@@ -38,6 +38,31 @@ export type ColumnSummaryAggregation = 'sum' | 'avg' | 'min' | 'max' | 'count' |
  * Only honoured on columns whose {@link ColumnDef.type} is `'currency'` or `'number'`.
  */
 export type AggFunc = 'sum' | 'avg' | 'min' | 'max' | 'count';
+/**
+ * Visibility strategy for a header action icon — the filter funnel and the
+ * column-menu "⋯" button.
+ *
+ * Applied grid-wide via {@link HeaderIconsConfig}, and overridable per column
+ * through {@link ColumnDef.filterIconDisplay} / {@link ColumnDef.menuIconDisplay}.
+ */
+export declare enum HeaderIconDisplay {
+    /**
+     * Icon stays hidden until the pointer hovers the header cell (or the icon is
+     * otherwise activated — e.g. a column with an active filter always shows its
+     * funnel). This is the default and matches the classic "reveal on hover"
+     * behaviour.
+     */
+    HOVER = "hover",
+    /** Icon is permanently rendered, regardless of hover state. */
+    ALWAYS = "always",
+    /**
+     * Icon is never rendered. The underlying feature remains available through
+     * other affordances (e.g. the filter row, or right-clicking the header for
+     * the column menu) — only the header button is suppressed. Use this to hide
+     * the filter funnel and/or the "⋯" menu icon entirely.
+     */
+    HIDDEN = "hidden"
+}
 export interface ColumnDropdownOption {
     /** The stored value — must be unique within the option list. */
     value: string | number;
@@ -80,6 +105,23 @@ export interface ColumnDef {
     rowDrag?: boolean;
     alwaysVisible?: boolean;
     visible?: boolean;
+    /**
+     * Controls when this column's filter funnel icon appears in the header.
+     * Only relevant while the column is filterable ({@link ColumnDef.filterable}
+     * is not `false`). Overrides the grid-level {@link HeaderIconsConfig.filter}
+     * default.
+     *
+     * @default HeaderIconDisplay.HOVER
+     */
+    filterIconDisplay?: HeaderIconDisplay;
+    /**
+     * Controls when this column's column-menu "⋯" icon appears in the header.
+     * Only relevant while the column menu is enabled for the grid. Overrides the
+     * grid-level {@link HeaderIconsConfig.menu} default.
+     *
+     * @default HeaderIconDisplay.HOVER
+     */
+    menuIconDisplay?: HeaderIconDisplay;
     renderHtml?: boolean;
     /**
      * Per-column rendering overrides, grouped by concern (display, editor,

package/types/column.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column.types.d.ts","sourceRoot":"","sources":["../../src/types/column.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"column.types.d.ts","sourceRoot":"","sources":["../../src/types/column.types.ts"],"names":[],"mappings":"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"}

package/types/column.types.js

@@ -1,2 +1,27 @@
-export {};
+/**
+ * Visibility strategy for a header action icon — the filter funnel and the
+ * column-menu "⋯" button.
+ *
+ * Applied grid-wide via {@link HeaderIconsConfig}, and overridable per column
+ * through {@link ColumnDef.filterIconDisplay} / {@link ColumnDef.menuIconDisplay}.
+ */
+export var HeaderIconDisplay;
+(function (HeaderIconDisplay) {
+    /**
+     * Icon stays hidden until the pointer hovers the header cell (or the icon is
+     * otherwise activated — e.g. a column with an active filter always shows its
+     * funnel). This is the default and matches the classic "reveal on hover"
+     * behaviour.
+     */
+    HeaderIconDisplay["HOVER"] = "hover";
+    /** Icon is permanently rendered, regardless of hover state. */
+    HeaderIconDisplay["ALWAYS"] = "always";
+    /**
+     * Icon is never rendered. The underlying feature remains available through
+     * other affordances (e.g. the filter row, or right-clicking the header for
+     * the column menu) — only the header button is suppressed. Use this to hide
+     * the filter funnel and/or the "⋯" menu icon entirely.
+     */
+    HeaderIconDisplay["HIDDEN"] = "hidden";
+})(HeaderIconDisplay || (HeaderIconDisplay = {}));
 //# sourceMappingURL=column.types.js.map

package/types/column.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"column.types.js","sourceRoot":"","sources":["../../src/types/column.types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"column.types.js","sourceRoot":"","sources":["../../src/types/column.types.ts"],"names":[],"mappings":"AA2DA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,iBAiBX;AAjBD,WAAY,iBAAiB;IAC3B;;;;;OAKG;IACH,oCAAe,CAAA;IACf,+DAA+D;IAC/D,sCAAiB,CAAA;IACjB;;;;;OAKG;IACH,sCAAiB,CAAA;AACnB,CAAC,EAjBW,iBAAiB,KAAjB,iBAAiB,QAiB5B"}