/**
 * categorical-color.ts — Categorical 色相 SSOT(2026-06-04 codify)
 *
 * Tag / Avatar / Calendar 等「以色相做分類標籤」的元件,色彩 variant **一律消費此 SSOT**。
 * 目的:**variant 名 == primitive 色相名,1:1,零 offset** —— 根治「red variant 接到 deep-orange」
 * 這類 categorical-vs-semantic 混淆(2026-06-04 user 抓:red = 品牌紅 hue-25〔--brand #DF3232 同族〕
 * ≠ deep-orange hue-38 ≠ semantic --error〔= deep-orange〕。三者完全無關)。
 *
 * 世界級對照:
 * - Ant Design Tag preset colors —— 用原始色相名(red/orange/green/blue…)做 categorical labeling
 *   (https://ant.design/components/tag/)。本 DS Tag/Avatar 採此模型。
 * - Atlassian Color 原則 —— **categorical(裝飾)色 vs semantic(狀態)色必須分離**
 *   (https://atlassian.design/foundations/color):categorical `red` 用 `--color-red-*`,跟 semantic
 *   `--error`(= deep-orange)無關;把 error 色拿來當 categorical 標籤 = 反 pattern。
 *
 * ⚠️ Tailwind v4 掃描限制:class 字串**必須以字面形式出現在被掃描的 source**(本檔在 src/,會被掃),
 * 不可用 runtime function 拼字串(否則 `bg-[var(--color-orange-1)]` 不被生成 → silent 失效)。
 * 故本 SSOT 以**字面 const map** 提供;consumer `import` 後索引(cva 列 key 取值,保 VariantProps 型別)。
 *
 * 互動 state(solid dismiss hover/active)用 semantic `--{hue}-hover` / `--{hue}-active`
 * (dark-mode 方向 pre-computed,**不可**用 primitive step-5,否則 dark mode 反向)。12 色相皆已定義。
 *
 * **加色相**:加進 `CATEGORICAL_HUES` + 下列 5 個 map 各補一行字面值(key X 用 `--color-X-*`,1:1)。
 * **機械防線**:`check_categorical_color_1to1.sh` 強制 map 的 key X 的值含 `--color-X-`(名實一致,禁 offset)。
 */
/** 12 個 categorical 色相(順序對齊 primitives.css / Storybook color token 列)。 */
export declare const CATEGORICAL_HUES: readonly ["blue", "green", "deep-orange", "yellow", "red", "orange", "amber", "lime", "turquoise", "indigo", "purple", "magenta"];
export type CategoricalHue = (typeof CATEGORICAL_HUES)[number];
/** neutral 不是色相(無 hue),用 secondary/foreground + neutral-9 solid,各 consumer 自處理(不在下列 map)。 */
export type CategoricalColor = CategoricalHue | 'neutral';
/** subtle 模式 class:step-1 底 + step-7 字。key X 一律對 `--color-X-*`(1:1)。 */
export declare const CAT_SUBTLE: Record<CategoricalHue, string>;
/**
 * solid 模式 class:step-6 底 + on-emphasis 配對文字。
 * 文字色依「step-6 底亮度」分桶(WCAG ≥3:1 大粗字門檻,2026-06-04 user「以最低為原則」):
 *   - 夠深的色底 → `text-on-emphasis`(白):blue / deep-orange / red / turquoise / indigo / purple / magenta
 *   - 太亮的色底 → `text-on-emphasis-dark`(深):yellow / amber / orange / lime(白字連 3:1 都不過)
 *   - ★ green 例外:白字 2.47 連 3:1 都不過,但 user 拍板維持白字(綠底白字慣見觀感)= documented exception。
 * 對比為 oklch→相對亮度實測(scripts/categorical-color-invariants.mjs 機械驗,green 列 exempt)。
 */
export declare const CAT_SOLID: Record<CategoricalHue, string>;
/** solid 互動(dismiss hover/active)— semantic dark-mode-aware token。 */
export declare const CAT_INTERACT: Record<CategoricalHue, {
    hover: string;
    active: string;
}>;
/** Avatar style 物件用:subtle / solid 的 raw token { bg, text }(非 class)。 */
export declare const CAT_SUBTLE_TOKENS: Record<CategoricalHue, {
    bg: string;
    text: string;
}>;
export declare const CAT_SOLID_TOKENS: Record<CategoricalHue, {
    bg: string;
    text: string;
}>;
/** Calendar event tile:subtle 底 + hover step-2(1:1)。 */
export declare const CAT_EVENT: Record<CategoricalHue, string>;
/** Calendar all-day accent:左側 step-6 實心條。 */
export declare const CAT_ACCENT: Record<CategoricalHue, string>;
//# sourceMappingURL=categorical-color.d.ts.map