@contember/utilities 1.2.0-rc.0 → 1.2.0-rc.2

package/dist/production/index.js

@@ -2,12 +2,17 @@ import { AssertionError } from "./assert-types/AssertionError.js";
 import { isArrayOfMembersSatisfyingFactory, isBoolean, isDefined, isFalse, isHTMLElement, isNonEmptyString, isNonEmptyTrimmedEndString, isNonEmptyTrimmedStartString, isNonEmptyTrimmedString, isNonNegativeNumber, isNotNull, isNotNullish, isNull, isNumber, isNumericString, isObject, isOneOfFactory, isPlainObject, isSlugString, isString, isTrue, isUndefined, satisfiesOneOfFactory } from "./assert-types/Predicates.js";
 import { assert } from "./assert-types/assert.js";
 import { assertNever } from "./assert-types/assertNever.js";
-import { GlobalClassNamePrefixContext } from "./class-name/GlobalClassNamePrefixContext.js";
+import { colorSchemeClassName, isColorSchemeClassName } from "./class-name/colorSchemeClassName.js";
+import { COLOR_SCHEME_CLASS_NAME_REG_EXP, THEME_CLASS_NAME_REG_EXP } from "./class-name/constants.js";
+import { deduplicateClassName } from "./class-name/deduplicateClassName.js";
+import { filterThemedClassName } from "./class-name/filterThemedClassName.js";
+import { flatClassNameList } from "./class-name/flatClassNameList.js";
 import { listClassName } from "./class-name/listClassName.js";
 import { stateClassName } from "./class-name/stateClassName.js";
-import { useClassName } from "./class-name/useClassName.js";
-import { useClassNameFactory } from "./class-name/useClassNameFactory.js";
+import { contentThemeClassName, controlsThemeClassName, themeClassName } from "./class-name/themeClassName.js";
 import { px } from "./css-utilities/px.js";
+import { currentOrDeprecated } from "./deprecate/currentOrDeprecated.js";
+import { deprecate } from "./deprecate/deprecate.js";
 import { dataAttribute } from "./dom/dataAttribute.js";
 import { getMatchingParentElement } from "./dom/getMatchingParentElement.js";
 import { getSizeFromResizeObserverEntryFactory } from "./dom/getSizeFromResizeObserverEntry.js";
@@ -23,15 +28,25 @@ import { toKebabCase } from "./string-utilities/kebabCase.js";
 import { trimString } from "./string-utilities/trimString.js";
 export {
   AssertionError,
-  GlobalClassNamePrefixContext,
+  COLOR_SCHEME_CLASS_NAME_REG_EXP,
+  THEME_CLASS_NAME_REG_EXP,
   assert,
   assertNever,
   capitalize,
+  colorSchemeClassName,
+  contentThemeClassName,
+  controlsThemeClassName,
+  currentOrDeprecated,
   dataAttribute,
+  deduplicateClassName,
+  deprecate,
+  filterThemedClassName,
+  flatClassNameList,
   getMatchingParentElement,
   getSizeFromResizeObserverEntryFactory,
   isArrayOfMembersSatisfyingFactory,
   isBoolean,
+  isColorSchemeClassName,
   isDefined,
   isFalse,
   isHTMLElement,
@@ -63,9 +78,8 @@ export {
   stateClassName,
   stateDataAttributes,
   svgSizeProps,
+  themeClassName,
   toKebabCase,
-  trimString,
-  useClassName,
-  useClassNameFactory
+  trimString
 };
 //# sourceMappingURL=index.js.map

package/dist/production/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/types/assert-types/Predicates.d.ts

@@ -2,7 +2,7 @@ import { Predicate, SlugString, UnionOfPredicateTypes } from './types';
 export declare function isNull(value: unknown): value is null;
 export declare function isNotNull<T>(value: unknown): value is T;
 export declare function isUndefined(value: unknown): value is undefined;
-export declare function isDefined<T>(value: unknown): value is T;
+export declare function isDefined<T>(value: unknown): value is Exclude<T, undefined>;
 export declare function isNotNullish<T>(value: T): value is Exclude<T, null | undefined>;
 export declare function isBoolean(value: unknown): value is boolean;
 export declare function isTrue(value: unknown): value is true;

package/dist/types/assert-types/Predicates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Predicates.d.ts","sourceRoot":"","sources":["../../../src/assert-types/Predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEtE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAEvD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAEvD;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,CAE/E;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAMD,eAAO,MAAM,uBAAuB,UAJM,OAAO,oBAIsB,CAAA;AACvE,eAAO,MAAM,4BAA4B,UALC,OAAO,oBAKsC,CAAA;AACvF,eAAO,MAAM,0BAA0B,UANG,OAAO,oBAMkC,CAAA;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEnE;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAE9D;AACD,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EACxC,OAAO,EAAE,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GACxD,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAIhC;AACD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EACzE,GAAG,UAAU,EAAE,CAAC,GACd,SAAS,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAI9C;AACD,wBAAgB,iCAAiC,CAAC,CAAC,EAClD,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACvC,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAIvC;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AACD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAE3F"}
+{"version":3,"file":"Predicates.d.ts","sourceRoot":"","sources":["../../../src/assert-types/Predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEtE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAEvD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAE3E;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,CAE/E;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAMD,eAAO,MAAM,uBAAuB,UAJM,OAAO,oBAIsB,CAAA;AACvE,eAAO,MAAM,4BAA4B,UALC,OAAO,oBAKsC,CAAA;AACvF,eAAO,MAAM,0BAA0B,UANG,OAAO,oBAMkC,CAAA;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEnE;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAE9D;AACD,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EACxC,OAAO,EAAE,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GACxD,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAIhC;AACD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EACzE,GAAG,UAAU,EAAE,CAAC,GACd,SAAS,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAI9C;AACD,wBAAgB,iCAAiC,CAAC,CAAC,EAClD,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACvC,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAIvC;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AACD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAE3F"}

package/dist/types/class-name/colorSchemeClassName.d.ts

@@ -0,0 +1,35 @@
+import { KebabCase } from 'type-fest';
+import { ColorSchemeClassName } from './types';
+/**
+ * Returns a string with a color scheme class name, prefixed with `scheme-`
+ *
+ * @param scheme - Color scheme name
+ * @returns A color scheme class name
+ *
+ * @example
+ * ```tsx
+ * const colorScheme = colorSchemeClassName('system')
+ * //  ^ 'scheme-system'
+ *
+ * return (
+ * 	<div className={colorScheme}>
+ * 		<button className={controlsThemeClassName}>Click me</button>
+ * 	</div>
+ *
+ * // renders:
+ * // <div class="scheme-system">
+ * // 	<button class="scheme-system theme-default-controls theme-danger-controls:hover">Click me</button>
+ * // </div>
+ * ```
+ */
+export declare function colorSchemeClassName<S extends KebabCase<string> = KebabCase<string>>(scheme: S): ColorSchemeClassName<S>;
+export declare function colorSchemeClassName<S extends KebabCase<string> = KebabCase<string>>(scheme: null | undefined): undefined;
+export declare function colorSchemeClassName<S extends KebabCase<string> = KebabCase<string>>(scheme: S | null | undefined): ColorSchemeClassName<S> | undefined;
+/**
+ * Tests if a string is a color scheme CSS class
+ * @param value - String to test
+ * @returns `true` if the string is a color scheme CSS class
+ * @internal
+ */
+export declare function isColorSchemeClassName<T extends string>(value: string): value is ColorSchemeClassName<T>;
+//# sourceMappingURL=colorSchemeClassName.d.ts.map

package/dist/types/class-name/colorSchemeClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorSchemeClassName.d.ts","sourceRoot":"","sources":["../../../src/class-name/colorSchemeClassName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAC1H,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAC3H,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AASzJ;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAExG"}

package/dist/types/class-name/constants.d.ts

@@ -0,0 +1,42 @@
+/**
+ * RegExp that matches theme class names
+ *
+ * @internal
+ *
+ * If theme is `default` then it will match:
+ *
+ * - theme-default
+ * - theme-default:hover
+ * - theme-default:active
+ * - theme-default:focus
+ * - theme-default-content
+ * - theme-default-content:hover
+ * - theme-default-content:active
+ * - theme-default-content:focus
+ * - theme-default-controls
+ * - theme-default-controls:hover
+ * - theme-default-controls:active
+ * - theme-default-controls:focus
+ *
+ * If theme is `brand-color` then it will match:
+ *
+ * - theme-brand-color
+ * - theme-brand-color:hover
+ * - theme-brand-color:active
+ * - theme-brand-color:focus
+ * - theme-brand-color-content
+ * - theme-brand-color-content:hover
+ * - theme-brand-color-content:active
+ * - theme-brand-color-content:focus
+ * - theme-brand-color-controls
+ * - theme-brand-color-controls:hover
+ * - theme-brand-color-controls:active
+ * - theme-brand-color-controls:focus
+ */
+export declare const THEME_CLASS_NAME_REG_EXP: RegExp;
+/**
+ * Regular expression for testing if a string is a color scheme CSS class
+ * @internal
+ */
+export declare const COLOR_SCHEME_CLASS_NAME_REG_EXP: RegExp;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/class-name/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/class-name/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,eAAO,MAAM,wBAAwB,QAAyF,CAAA;AAE9H;;;GAGG;AACH,eAAO,MAAM,+BAA+B,QAA4D,CAAA"}

package/dist/types/class-name/deduplicateClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicateClassName.d.ts","sourceRoot":"","sources":["../../../src/class-name/deduplicateClassName.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEvE"}

package/dist/types/class-name/filterThemedClassName.d.ts

@@ -0,0 +1,7 @@
+import { ColorSchemeClassName, NestedClassName } from './types';
+export type ThemeConfig = {
+    content: string | undefined;
+    controls: string | undefined;
+};
+export declare function filterThemedClassName(nestedClassName: NestedClassName, defaultColorSchemeContext: ColorSchemeClassName): string[];
+//# sourceMappingURL=filterThemedClassName.d.ts.map

package/dist/types/class-name/filterThemedClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterThemedClassName.d.ts","sourceRoot":"","sources":["../../../src/class-name/filterThemedClassName.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAEvF,wBAAgB,qBAAqB,CACpC,eAAe,EAAE,eAAe,EAChC,yBAAyB,EAAE,oBAAoB,YA0E/C"}

package/dist/types/class-name/flatClassNameList.d.ts

@@ -0,0 +1,3 @@
+import { NestedClassName } from './types';
+export declare function flatClassNameList(className: NestedClassName): string[];
+//# sourceMappingURL=flatClassNameList.d.ts.map

package/dist/types/class-name/flatClassNameList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatClassNameList.d.ts","sourceRoot":"","sources":["../../../src/class-name/flatClassNameList.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEzC,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CActE"}

package/dist/types/class-name/index.d.ts

@@ -1,7 +1,10 @@
-export * from './GlobalClassNamePrefixContext';
-export * from './Types';
+export * from './colorSchemeClassName';
+export * from './constants';
+export * from './deduplicateClassName';
+export * from './filterThemedClassName';
+export * from './flatClassNameList';
 export * from './listClassName';
 export * from './stateClassName';
-export * from './useClassName';
-export * from './useClassNameFactory';
+export * from './themeClassName';
+export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/class-name/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/class-name/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/class-name/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA"}

package/dist/types/class-name/stateClassName.d.ts

@@ -1,4 +1,4 @@
-import { ClassNameStateMap } from './Types';
+import { ClassNameStateMap } from './types';
 export interface StateClassNameOptions {
     glue?: string;
     removeFalsy?: boolean;

package/dist/types/class-name/themeClassName.d.ts

@@ -0,0 +1,87 @@
+import { KebabCase } from 'type-fest';
+import { ThemeContentClassName, ThemeControlsClassName } from './types';
+/**
+ * Returns a string with a content theme class name, prefixed with `theme-` and suffixed with `-content`
+ *
+ * IMPORTANT: Make sure to use color scheme class in combination with theme class names.
+ *
+ * @param contentTheme - Theme name basis for content
+ * @param state - State of the theme starting with a ":", e.g. `":hover"`, `":focus"`, `":active"`, `":focus-visible"`
+ * @returns A content theme class name
+ *
+ * @see {@link controlsThemeClassName}
+ * @see {@link (colorSchemeClassName:3)}
+ *
+ * @example
+ * ```tsx
+ * const colorScheme = colorSchemeClassName('system')
+ * //  ^ 'scheme-system'
+ * const contentThemeClassName = contentThemeClassName('default')
+ * //  ^ 'theme-default-content:hover'
+ * const dangerOnMouseOverTheme = controlsThemeClassName('danger', ':hover')
+ * //  ^ 'theme-danger-controls:hover'
+ *
+ * return (
+ * 	<div className={`${colorScheme} ${contentThemeClassName}`}>
+ * 		<button className={`${colorScheme} ${dangerOnMouseOverTheme}`}>Delete</button>
+ * 	</div>
+ * )
+ * ```
+ */
+export declare function contentThemeClassName<ContentTheme extends KebabCase<string> = KebabCase<string>, State extends `:${KebabCase<string>}` | null | undefined = undefined>(theme: ContentTheme | null | undefined, state?: State | null | undefined): ThemeContentClassName<ContentTheme, State> | undefined;
+/**
+ * Returns a string with a controls theme class name, prefixed with `theme-` and suffixed with `-controls`
+ *
+ * IMPORTANT: Make sure to use color scheme class in combination with theme class names.
+ *
+ * @param theme - Theme name basis for controls
+ * @param state - State of the theme starting with a ":", e.g. `":hover"`, `":focus"`, `":active"`, `":focus-visible"`
+ * @returns A controls theme class name
+ *
+ * @see {@link contentThemeClassName}
+ * @see {@link (colorSchemeClassName:3)}
+ *
+ * @example
+ * ```tsx
+ * const colorScheme = colorSchemeClassName('system')
+ * //  ^ 'scheme-system'
+ * const contentThemeClassName = contentThemeClassName('default')
+ * //  ^ 'theme-default-content:hover'
+ * const dangerOnMouseOverTheme = controlsThemeClassName('danger', ':hover')
+ * //  ^ 'theme-danger-controls:hover'
+ *
+ * return (
+ * 	<div className={`${colorScheme} ${contentThemeClassName}`}>
+ * 		<button className={`${colorScheme} ${dangerOnMouseOverTheme}`}>Delete</button>
+ * 	</div>
+ * )
+ * ```
+ */
+export declare function controlsThemeClassName<ControlsTheme extends KebabCase<string> = KebabCase<string>, State extends `:${KebabCase<string>}` | null | undefined = undefined>(theme: ControlsTheme | null | undefined, state?: State | null | undefined): ThemeControlsClassName<ControlsTheme, State> | undefined;
+/**
+ * Returns a tuple with a content theme class name and a controls theme class name, prefixed with `theme-` and suffixed with `-content` and `-controls` respectively
+ *
+ * IMPORTANT: Make sure to use color scheme class in combination with theme class names.
+ *
+ * @param theme - Theme name basis for content and controls
+ * @param state - State of the theme starting with a ":", e.g. `":hover"`, `":focus"`, `":active"`, `":focus-visible"`
+ * @returns A tuple with a content theme class name and a controls theme class name
+ *
+ * @see {@link contentThemeClassName}
+ * @see {@link controlsThemeClassName}
+ * @see {@link (colorSchemeClassName:3)}
+ *
+ * @example
+ * ```tsx
+ * const colorScheme = colorSchemeClassName('system')
+ * //  ^ 'scheme-system'
+ * const errorTheme = themeClassName('danger').join(' ')
+ * //  ^ 'theme-danger-content theme-danger-controls'
+ *
+ * return (
+ * 	<div className={`${colorScheme} ${errorTheme}`}>File not found</div>
+ * )
+ * ```
+ */
+export declare function themeClassName<Theme extends KebabCase<string> = KebabCase<string>, State extends `:${KebabCase<string>}` | null | undefined = undefined>(theme: Theme | null | undefined, state?: State | null | undefined): readonly [ThemeContentClassName<Theme, State> | undefined, ThemeControlsClassName<Theme, State> | undefined];
+//# sourceMappingURL=themeClassName.d.ts.map

package/dist/types/class-name/themeClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeClassName.d.ts","sourceRoot":"","sources":["../../../src/class-name/themeClassName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CACpC,YAAY,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAC1D,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EAEpE,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACtC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,0DAGhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CACrC,aAAa,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAC3D,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EAEpE,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACvC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,4DAGhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAC7B,KAAK,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EACnD,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EAEnE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC/B,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,gHAMjC"}

package/dist/types/class-name/types.d.ts

@@ -0,0 +1,14 @@
+import { PropsWithChildren } from 'react';
+import { KebabCase } from 'type-fest';
+export type NestedClassName = string | false | null | undefined | (string | false | null | undefined)[] | NestedClassName[];
+export type ClassNameStateMap = {
+    [key: string]: string | number | boolean | null | undefined;
+};
+export type ComponentClassNameProps = PropsWithChildren<{
+    className?: NestedClassName;
+    componentClassName?: string | string[];
+}>;
+export type ColorSchemeClassName<T extends KebabCase<string> = KebabCase<string>> = `scheme-${T}`;
+export type ThemeContentClassName<T extends KebabCase<string> = KebabCase<string>, S extends `:${KebabCase<string>}` | null | undefined = undefined> = S extends string ? `theme-${T}-content${S}` : `theme-${T}-content`;
+export type ThemeControlsClassName<T extends KebabCase<string> = KebabCase<string>, S extends `:${KebabCase<string>}` | null | undefined = undefined> = S extends string ? `theme-${T}-controls${S}` : `theme-${T}-controls`;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/class-name/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/class-name/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,eAAe,EAAE,CAAA;AAC3H,MAAM,MAAM,iBAAiB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,CAAA;AAE/F,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;IACvD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACvC,CAAC,CAAA;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,EAAE,CAAA;AACjG,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,IAAI,CAAC,SAAS,MAAM,GACpK,SAAS,CAAC,WAAW,CAAC,EAAE,GACxB,SAAS,CAAC,UAAU,CAAA;AACvB,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,IAAI,CAAC,SAAS,MAAM,GACrK,SAAS,CAAC,YAAY,CAAC,EAAE,GACzB,SAAS,CAAC,WAAW,CAAA"}

package/dist/types/deprecate/currentOrDeprecated.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Resolves current or deprecated value. If both are defined, it will throw an error in development mode.
+ *
+ * @internal
+ *
+ * Errors are thrown only in development mode. In production mode, the deprecated value is returned.
+ *
+ * @param current - Current value that replaces deprecated value
+ * @param deprecated - Deprecated value that will be removed in the next release
+ * @param shouldThrow - Whether to throw an error if both current and deprecated are defined
+ * @returns Deprecated value if it is defined, otherwise current value
+ * @throws Error if both current and deprecated are defined
+ *
+ * @example
+ * ```ts
+ * const current = 'current'
+ * const deprecated = 'deprecated'
+ *
+ * const value = currentOrDeprecated(current, deprecated)
+ *
+ * console.log(value) // 'deprecated'
+ * ```
+ *
+ * @example
+ * ```ts
+ * const current = 'current'
+ * const deprecated = undefined
+ *
+ * const value = currentOrDeprecated(current, deprecated)
+ *
+ * console.log(value) // 'current'
+ * ```
+ */
+export declare function currentOrDeprecated<R, D>(current: R, deprecated: D, shouldThrow?: boolean): R | D;
+//# sourceMappingURL=currentOrDeprecated.d.ts.map

package/dist/types/deprecate/currentOrDeprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currentOrDeprecated.d.ts","sourceRoot":"","sources":["../../../src/deprecate/currentOrDeprecated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,GAAE,OAAe,GAAG,CAAC,GAAG,CAAC,CAiBxG"}

package/dist/types/deprecate/deprecate.d.ts

@@ -0,0 +1,19 @@
+import { SemverString } from './types';
+/**
+ * Logs a deprecation warning if the assertion is `false`.
+ * @internal
+ *
+ * @param removal - Version when the deprecated feature will be removed
+ * @param assertion - Condition that must be true to avoid the deprecation warning
+ * @param deprecated - Name of the deprecated feature
+ * @param replacement - Name of the feature that replaces the deprecated feature
+ *
+ * @example
+ * ```ts
+ * const { visible } = props
+ * deprecate(visible !== 'default', '1.3.0', '"default"', '"hidden"')
+ * // Logs: Use of "default" is deprecated and might be removed in the next release. Use "hidden" instead.
+ * ```
+ */
+export declare function deprecate(removal: SemverString, assertion: boolean, deprecated: string, replacement: string): void;
+//# sourceMappingURL=deprecate.d.ts.map

package/dist/types/deprecate/deprecate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecate.d.ts","sourceRoot":"","sources":["../../../src/deprecate/deprecate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAYlH"}

package/dist/types/deprecate/index.d.ts

@@ -0,0 +1,4 @@
+export * from './currentOrDeprecated';
+export * from './deprecate';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/deprecate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/deprecate/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA"}

package/dist/types/deprecate/types.d.ts

@@ -0,0 +1,2 @@
+export type SemverString = `${number}.${number}.${number}` | `v${number}.${number}.${number}`;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/deprecate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/deprecate/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAA"}

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from './assert-types';
 export * from './class-name';
 export * from './css-utilities';
+export * from './deprecate';
 export * from './dom';
 export * from './functional';
 export * from './string-utilities';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,SAAS,CAAA"}