/**
 * Email colour contract — semantic web roles resolved to LITERAL hex. HTML email has no cascade
 * worth trusting: Gmail strips <style>, Outlook ignores custom properties, and every colour must
 * appear inline as `#rrggbb` on the element that paints it.
 */
import { EMAIL_COLOR_SOURCE } from "./tokens.generated.js";
/**
 * The email palette slots. Each maps 1:1 to a semantic role in `src/tokens/foundation.css`
 * (`EMAIL_COLOR_SOURCE[token].cssVar` names it), so a re-themed role re-tints the email.
 */
export type EmailColorToken = keyof typeof EMAIL_COLOR_SOURCE;
/** A `#rrggbb` string — the only colour form every email client renders identically. */
export type EmailHex = `#${string}`;
/**
 * Convert a CSS HSL channel triplet (`"204 100% 39%"` — the shape every `@godxjp/ui` colour role
 * uses) into the `#rrggbb` literal an email client needs. Consumers with a custom brand role can
 * call this directly: `hslToHex(getComputedStyle(el).getPropertyValue("--primary"))`. @throws if
 * the input is not a bare `H S% L%` triplet (a hex or `hsl(...)` wrapper is rejected rather than
 * silently mis-parsed).
 */
export declare function hslToHex(triplet: string): EmailHex;
/**
 * The canonical (light-scheme) transactional-email palette, as literal hex.
 *
 * | slot                          | web role                          | used for                          |
 * | ----------------------------- | --------------------------------- | --------------------------------- |
 * | `background`                  | `--background`                    | the page wrapper behind the card  |
 * | `foreground`                  | `--foreground`                    | body copy                         |
 * | `surface` / `surfaceForeground`| `--card` / `--card-foreground`   | the 480px card                    |
 * | `muted` / `mutedForeground`   | `--muted` / `--muted-foreground`  | quiet bands, legal copy           |
 * | `border`                      | `--border`                        | card edge, footer hairline        |
 * | `primary` / `primaryForeground`| `--primary` / `--primary-foreground` | the one CTA                  |
 * | `focus`                       | `--ring`                          | focus affordance in webmail panes |
 * | `brand` / `brandForeground`   | `--brand` / `--brand-foreground`  | the GoDX capsule + its glyph      |
 * | `urgency` / `urgencyForeground`| `--attention` / `--attention-foreground` | action-required accent / solid large label |
 */
export declare const EMAIL_COLORS: Readonly<Record<EmailColorToken, EmailHex>>;
/**
 * The dark-scheme palette, derived from the same roles under `.dark` /
 * `:root[data-theme="dark"]`. Use it inside `@media (prefers-color-scheme: dark)` for the clients
 * that honour it — never as the only palette, since most clients do not.
 */
export declare const EMAIL_COLORS_DARK: Readonly<Record<EmailColorToken, EmailHex>>;