@labpics/colors 0.6.0 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@labpics/colors",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Framework-agnostic contrast engine: resolve accessible, perceptually-anchored colour roles for any background. WASM core, zero runtime dependencies.",
   "type": "module",
   "license": "MIT",

package/pkg/labcolors.d.ts

@@ -137,11 +137,22 @@ export type RoleRecipe =
 | { kind: "ladder"; source: LadderSource; position: string }
 | { kind: "glow"; source: LadderSource; step: "subtle" | "base" | "bloom" }
 | { kind: "pair-fill"; source: LadderSource }
+| { kind: "pair-label"; source: LadderSource; fraction: number; floor: "aa-text" | "aa-ui" | "none" }
 | { kind: "alpha-analog"; of: LadderSource; alpha: number }
 | { kind: "zero" };
 
+/** Именованный пресет ролей. Тонкий конфиг несёт `preset` вместо простыни `roles`. */
+export type RolePreset = "labui";
+
 /** Полный конфиг дизайн-системы клиента — вход loadConfig (JSON.stringify(config)). */
 export interface ThemeConfig {
+    /**
+     * Пресет ролей: наполняет словарь дизайн-системы целиком, чтобы клиент вносил
+     * ТОЛЬКО значения (якоря, ручки), не семантику. Тонкий конфиг задаёт `preset` и
+     * ОПУСКАЕТ `roles`/`aliases`. Задать `preset` вместе с непустыми `roles` —
+     * ошибка `invalid_config` (оверрайд отдельных ролей — не этот слой).
+     */
+    readonly preset?: RolePreset;
     readonly brand: ThemeAnchors;
     readonly neutral: {
         readonly anchors: { light: string; mid: string; dark: string };
@@ -166,7 +177,8 @@ export interface ThemeConfig {
         readonly chroma_fraction: number;
     };
     readonly themes: ReadonlyArray<{ name: string; preset: "srgb" | "dim" | "srgb-ic" | "dim-ic" }>;
-    readonly roles: ReadonlyArray<{ name: string; recipe: RoleRecipe }>;
+    /** Опускается в тонком конфиге (задан `preset`); иначе — полный словарь ролей. */
+    readonly roles?: ReadonlyArray<{ name: string; recipe: RoleRecipe }>;
     readonly aliases?: ReadonlyArray<{ alias: string; target: string }>;
 }