@gjsify/adwaita-web 0.37.0 → 0.38.0

package/lib/types/accent.d.ts

@@ -0,0 +1,28 @@
+import { type AdwAccentColorName } from '@gjsify/adwaita-core';
+/** The custom property carrying the accent fill. */
+export declare const ACCENT_BG_PROPERTY = "--accent-bg-color";
+/** The custom property carrying the standalone accent, for text on the window. */
+export declare const ACCENT_PROPERTY = "--accent-color";
+/** Where and how to apply the accent. */
+export interface ApplyAccentOptions {
+    /** The element to set the properties on. Defaults to `document.documentElement`. */
+    readonly target?: HTMLElement;
+    /**
+     * Which standalone variant to use. Defaults to the target's RESOLVED scheme,
+     * because the standalone colour is the one thing about an accent that differs
+     * between light and dark — reading it beats assuming light.
+     */
+    readonly dark?: boolean;
+}
+/**
+ * Whether `element` is currently rendering dark.
+ *
+ * `.theme-dark` / `.theme-light` are the stylesheet's manual overrides and win
+ * over the media query, so an explicit class is checked first and
+ * `prefers-color-scheme` only decides when neither is present.
+ */
+export declare function isAdwaitaDark(element: HTMLElement): boolean;
+/** Set the accent custom properties for `name`. */
+export declare function applyAdwaitaAccent(name: AdwAccentColorName, options?: ApplyAccentOptions): void;
+/** Drop the properties, so the stylesheet's own values apply again. */
+export declare function clearAdwaitaAccent(target?: HTMLElement): void;

package/lib/types/adw-accent.spec.d.ts

@@ -0,0 +1,2 @@
+import '@gjsify/adwaita-web';
+export declare const AdwAccentTest: () => Promise<void>;

package/lib/types/index.d.ts

@@ -1,5 +1,7 @@
 import '@gjsify/adwaita-fonts';
 export { addBreakpoints, bindBreakpointSetter } from './breakpoints.js';
+export { ACCENT_BG_PROPERTY, ACCENT_PROPERTY, applyAdwaitaAccent, clearAdwaitaAccent, isAdwaitaDark, } from './accent.js';
+export type { ApplyAccentOptions } from './accent.js';
 export { AdwAvatar } from './elements/adw-avatar.js';
 export { AdwBanner } from './elements/adw-banner.js';
 export { AdwCard } from './elements/adw-card.js';