@kbach/react 0.6.29 → 0.6.31

package/dist/core/index.d.ts

@@ -86,8 +86,17 @@ interface ResolvedStyle {
     /** Styles keyed by modifier or modifier combo, e.g. 'dark', 'hover', 'dark:hover' */
     [modifierKey: string]: StyleValue | undefined;
 }
-type ColorShades = Record<string, string>;
-type ThemeColors = Record<string, string | ColorShades>;
+/**
+ * A color value is either a plain string (hex/rgb/alias-to-another-color-name)
+ * or a mode-aware pair — resolved to `light` or `dark` per the active theme
+ * mode wherever it's actually used (className resolution, useColors()).
+ */
+type ColorValue = string | {
+    light: string;
+    dark: string;
+};
+type ColorShades = Record<string, ColorValue>;
+type ThemeColors = Record<string, ColorValue | ColorShades>;
 type ThemeSpacing = Record<string, number | string>;
 interface ThemeConfig {
     colors: ThemeColors;
@@ -163,6 +172,34 @@ interface ResolvedConfig {
     plugins: Array<(api: PluginAPI) => void>;
 }
 
+/**
+ * True for a mode-aware color pair (`{ light, dark }`), as opposed to a plain
+ * hex/rgb/alias string. Shared by config.ts (alias-chain resolution),
+ * resolvers/color.ts (direct lookups), and modeAwareColors.ts (className
+ * expansion) so all three agree on exactly one definition. Real shade keys
+ * are always numeric strings ('1'–'12'), so this can never collide with one.
+ */
+declare function isModeAwareColor(v: unknown): v is {
+    light: string;
+    dark: string;
+};
+
+/**
+ * Expand every class referencing a mode-aware color (a kbach.config.js color
+ * value shaped `{ light, dark }`) into an explicit base + dark: pair BEFORE
+ * normal parsing — e.g. `bg-surface` becomes `bg-[#ffffff] dark:bg-[#111827]`.
+ * `bg-surface/50` becomes `bg-[#ffffff]/50 dark:bg-[#111827]/50` (the arbitrary-
+ * color-plus-opacity composition already resolveColor() already supports).
+ *
+ * Runs once, upfront, purely as a string rewrite — everything downstream
+ * (CSS generation, native bucketing/flatten(), the existing dark: reactivity
+ * machinery: DarkWrapper, bucketMods()) then handles the result exactly like
+ * a hand-written dark: pair, with zero further changes needed anywhere else.
+ * That also means resolve()'s cache (keyed on the ORIGINAL, unexpanded string
+ * — see resolver.ts) stays correct without any changes to its cache key.
+ */
+declare function expandModeAwareColorClasses(classString: string, colors: ThemeColors): string;
+
 declare const defaultColors: {
     transparent: string;
     current: string;
@@ -1271,4 +1308,4 @@ declare function subscribeGlobalWidth(listener: WidthListener): () => void;
  */
 declare function getActiveBreakpoints(width?: number, screens?: Record<string, number>): Set<string>;
 
-export { BASE_RESET, type ColorShades, type DarkMode, type DefaultColorName, type DefaultSpacingKey, type FrameworkConfig, LRUCache, type ParsedClass, type Platform, type PluginAPI, RESET_STYLE_ID, type ResolvedConfig, type ResolvedStyle, type StyleValue, type ThemeColors, type ThemeConfig, type ThemeMode, type ThemeSpacing, buildConfig, clearCache, clearPluginModifiers, customVariants, defaultColors, defaultTheme, disableRuntimeCSS, escapeCSSSelector, flatten, generateClassCSS, getActiveBreakpoints, getAllModifierNames, getBuiltinStandaloneNames, getBuiltinUtilityPrefixes, getConfig, getDefaultFontFamily, getEffectiveIsWeb, getGlobalDarkMode, getGlobalScreens, getGlobalWidth, getInteractiveModifiers, getModeModifiers, getModifier, getResponsiveModifiers, initConfig, isKnownModifier, isKnownUtility, isNative, isRuntimeCSSDisabled, isWeb, kbachWarn, matchModifier, normalizeClassString, onConfigChange, parseClass, parseClasses, parseHexRgb, registerModifier, resetConfig, resolve, resolveColor, resolveSizing, resolveSpacing, resolveUtility, setDefaultFontFamily, setGlobalDarkMode, setGlobalWidth, setResolveTarget, splitClassTokens, subscribeGlobalDarkMode, subscribeGlobalWidth, syncGlobalDarkMode, syncGlobalScreens, syncGlobalWidth, toNativeValue, updateConfig };
+export { BASE_RESET, type ColorShades, type ColorValue, type DarkMode, type DefaultColorName, type DefaultSpacingKey, type FrameworkConfig, LRUCache, type ParsedClass, type Platform, type PluginAPI, RESET_STYLE_ID, type ResolvedConfig, type ResolvedStyle, type StyleValue, type ThemeColors, type ThemeConfig, type ThemeMode, type ThemeSpacing, buildConfig, clearCache, clearPluginModifiers, customVariants, defaultColors, defaultTheme, disableRuntimeCSS, escapeCSSSelector, expandModeAwareColorClasses, flatten, generateClassCSS, getActiveBreakpoints, getAllModifierNames, getBuiltinStandaloneNames, getBuiltinUtilityPrefixes, getConfig, getDefaultFontFamily, getEffectiveIsWeb, getGlobalDarkMode, getGlobalScreens, getGlobalWidth, getInteractiveModifiers, getModeModifiers, getModifier, getResponsiveModifiers, initConfig, isKnownModifier, isKnownUtility, isModeAwareColor, isNative, isRuntimeCSSDisabled, isWeb, kbachWarn, matchModifier, normalizeClassString, onConfigChange, parseClass, parseClasses, parseHexRgb, registerModifier, resetConfig, resolve, resolveColor, resolveSizing, resolveSpacing, resolveUtility, setDefaultFontFamily, setGlobalDarkMode, setGlobalWidth, setResolveTarget, splitClassTokens, subscribeGlobalDarkMode, subscribeGlobalWidth, syncGlobalDarkMode, syncGlobalScreens, syncGlobalWidth, toNativeValue, updateConfig };