tailwind-variants 3.2.1 → 3.3.0

package/dist/chunk-OYFAXDFZ.js

@@ -0,0 +1,147 @@
+// src/internal/join-class-value.ts
+var isArray = Array.isArray;
+var joinClassValue = (value) => {
+  if (!value && value !== 0 && value !== 0n) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number") {
+    if (value !== value) return "";
+    return "" + value;
+  }
+  if (typeof value === "bigint") return "" + value;
+  let result = "";
+  if (isArray(value)) {
+    const length = value.length;
+    for (let index = 0; index < length; index++) {
+      const item = value[index];
+      if (!item && item !== 0 && item !== 0n) continue;
+      const resolved = typeof item === "string" ? item : joinClassValue(item);
+      if (resolved) {
+        if (result) result += " ";
+        result += resolved;
+      }
+    }
+    return result;
+  }
+  if (typeof value === "object") {
+    for (const key in value) {
+      if (value[key]) {
+        if (result) result += " ";
+        result += key;
+      }
+    }
+  }
+  return result;
+};
+
+// src/utils.ts
+var SPACE_REGEX = /\s+/g;
+var isArray2 = Array.isArray;
+var removeExtraSpaces = (str) => {
+  if (typeof str !== "string" || !str) return str;
+  return str.replace(SPACE_REGEX, " ").trim();
+};
+var stringNeedsNormalize = (str) => {
+  const len = str.length;
+  if (len === 0) return false;
+  const first = str.charCodeAt(0);
+  const last = str.charCodeAt(len - 1);
+  if (first === 32 || last === 32 || first >= 9 && first <= 13 || first === 160 || last >= 9 && last <= 13 || last === 160) {
+    return true;
+  }
+  for (let i = 0; i < len; i++) {
+    const code = str.charCodeAt(i);
+    if (code >= 9 && code <= 13 || code === 160) return true;
+    if (code === 32 && i + 1 < len && str.charCodeAt(i + 1) === 32) return true;
+  }
+  return false;
+};
+var cx = (...classnames) => {
+  const result = joinClassValue(classnames);
+  if (!result) return void 0;
+  return stringNeedsNormalize(result) ? removeExtraSpaces(result) : result;
+};
+var falsyToString = (value) => value === false ? "false" : value === true ? "true" : value === 0 ? "0" : value;
+var isEmptyObject = (obj) => {
+  if (!obj || typeof obj !== "object") return true;
+  for (const _ in obj) return false;
+  return true;
+};
+var isEqual = (obj1, obj2) => {
+  if (obj1 === obj2) return true;
+  if (!obj1 || !obj2) return false;
+  const record1 = obj1;
+  const record2 = obj2;
+  const keys1 = Object.keys(record1);
+  const keys2 = Object.keys(record2);
+  if (keys1.length !== keys2.length) return false;
+  for (let i = 0; i < keys1.length; i++) {
+    const key = keys1[i];
+    if (!keys2.includes(key)) return false;
+    if (record1[key] !== record2[key]) return false;
+  }
+  return true;
+};
+var isBoolean = (value) => value === true || value === false;
+var joinObjects = (obj1, obj2) => {
+  const target = obj1;
+  for (const key in obj2) {
+    if (Object.hasOwn(obj2, key)) {
+      const val2 = obj2[key];
+      if (key in target) {
+        target[key] = cx(target[key], val2);
+      } else {
+        target[key] = val2;
+      }
+    }
+  }
+  return obj1;
+};
+var flat = (arr, target) => {
+  for (let i = 0; i < arr.length; i++) {
+    const el = arr[i];
+    if (isArray2(el)) flat(el, target);
+    else if (el) target.push(el);
+  }
+};
+function flatArray(arr) {
+  const flattened = [];
+  flat(arr, flattened);
+  return flattened;
+}
+var flatMergeArrays = (...arrays) => {
+  const result = [];
+  flat(arrays, result);
+  const filtered = [];
+  for (let i = 0; i < result.length; i++) {
+    if (result[i]) filtered.push(result[i]);
+  }
+  return filtered;
+};
+var mergeObjects = (obj1, obj2) => {
+  const record1 = obj1;
+  const record2 = obj2;
+  const result = {};
+  for (const key in record1) {
+    const val1 = record1[key];
+    if (key in record2) {
+      const val2 = record2[key];
+      if (isArray2(val1) || isArray2(val2)) {
+        result[key] = flatMergeArrays(val2, val1);
+      } else if (typeof val1 === "object" && typeof val2 === "object" && val1 && val2) {
+        result[key] = mergeObjects(val1, val2);
+      } else {
+        result[key] = val2 + " " + val1;
+      }
+    } else {
+      result[key] = val1;
+    }
+  }
+  for (const key in record2) {
+    if (!(key in record1)) {
+      result[key] = record2[key];
+    }
+  }
+  return result;
+};
+
+export { cx, falsyToString, flat, flatArray, flatMergeArrays, isBoolean, isEmptyObject, isEqual, joinClassValue, joinObjects, mergeObjects, removeExtraSpaces };

package/dist/config-bO3A8WhU.d.cts

@@ -0,0 +1,112 @@
+/** Class value accepted by the callable merger (`createMerger()`). */
+type ClassNameValue = ClassNameArray | string | null | undefined | 0 | 0n | false;
+type ClassNameArray = readonly ClassNameValue[];
+/** Built-in merger configuration shape. */
+type Config<ClassGroupIds extends string, ThemeGroupIds extends string> = ConfigGroupsPart<ClassGroupIds, ThemeGroupIds>;
+/**
+ * Dynamic merger config groups. When merging configs, use `override` or `extend`.
+ */
+interface ConfigGroupsPart<ClassGroupIds extends string, ThemeGroupIds extends string> {
+    /**
+     * Theme scales used in classGroups.
+     *
+     * The keys are the same as in the Tailwind config but the values are sometimes defined more broadly.
+     */
+    theme: NoInfer<ThemeObject<ThemeGroupIds>>;
+    /**
+     * Object with groups of classes.
+     *
+     * @example
+     * {
+     *     // Creates group of classes `group`, `of` and `classes`
+     *     'group-id': ['group', 'of', 'classes'],
+     *     // Creates group of classes `look-at-me-other` and `look-at-me-group`.
+     *     'other-group': [{ 'look-at-me': ['other', 'group']}]
+     * }
+     */
+    classGroups: NoInfer<Record<ClassGroupIds, ClassGroup<ThemeGroupIds>>>;
+    /**
+     * Conflicting classes across groups.
+     *
+     * The key is the ID of a class group which creates a conflict, values are IDs of class groups which receive a conflict. That means if a class from from the key ID is present, all preceding classes from the values are removed.
+     *
+     * A class group ID is the key of a class group in the classGroups object.
+     *
+     * @example { gap: ['gap-x', 'gap-y'] }
+     */
+    conflictingClassGroups: NoInfer<Partial<Record<ClassGroupIds, readonly ClassGroupIds[]>>>;
+    /**
+     * Postfix modifiers conflicting with other class groups.
+     *
+     * A class group ID is the key of a class group in classGroups object.
+     *
+     * @example { 'font-size': ['leading'] }
+     */
+    conflictingClassGroupModifiers: NoInfer<Partial<Record<ClassGroupIds, readonly ClassGroupIds[]>>>;
+    /**
+     * Class group IDs which should be resolved again with their postfix modifier attached.
+     *
+     * This is needed when a slash can make the full class name belong to a different class group than the part before the slash.
+     *
+     * @example ['container-type'] // `@container-size/sidebar` should resolve differently from `@container-size`
+     */
+    postfixLookupClassGroups?: readonly NoInferString<ClassGroupIds>[];
+    /**
+     * Modifiers whose order among multiple modifiers should be preserved because their order changes which element gets targeted.
+     *
+     * Classes with these modifiers are not overwritten by peers that only differ in order-sensitive modifier position.
+     */
+    orderSensitiveModifiers: string[];
+}
+type ThemeObject<ThemeGroupIds extends string> = Record<ThemeGroupIds, ClassGroup<ThemeGroupIds>>;
+type ClassGroup<ThemeGroupIds extends string> = readonly ClassDefinition<ThemeGroupIds>[];
+type ClassDefinition<ThemeGroupIds extends string> = string | ClassValidator | ThemeGetter | ClassObject<ThemeGroupIds>;
+type ClassValidator = (classPart: string) => boolean;
+interface ThemeGetter {
+    (theme: ThemeObject<AnyThemeGroupIds>): ClassGroup<AnyClassGroupIds>;
+    isThemeGetter: true;
+}
+type ClassObject<ThemeGroupIds extends string> = Record<string, readonly ClassDefinition<ThemeGroupIds>[]>;
+/**
+ * Hack from https://stackoverflow.com/questions/56687668/a-way-to-disable-type-argument-inference-in-generics/56688073#56688073
+ *
+ * Could be replaced with NoInfer utility type from TypeScript (https://www.typescriptlang.org/docs/handbook/utility-types.html#noinfertype), but that is only supported in TypeScript 5.4 or higher, so I should wait some time before using it.
+ */
+type NoInfer<T> = [T][T extends unknown ? 0 : never];
+/**
+ * Special-purpose NoInfer variant for string unions used in array item positions.
+ *
+ * The NoInfer helper above doesn't prevent inference from array items in all cases, so this keeps
+ * config arrays like `postfixLookupClassGroups` from defining or narrowing class group IDs.
+ * Prefer TypeScript's built-in `NoInfer` when the minimum supported version is 5.4+.
+ */
+type NoInferString<T extends string> = T extends infer S ? S & string : never;
+type AnyClassGroupIds = string;
+type AnyThemeGroupIds = string;
+/** Merger config with unrestricted class-group and theme-group IDs. */
+type AnyConfig = Config<AnyClassGroupIds, AnyThemeGroupIds>;
+/** Merger config: `override` replaces class groups, `extend` appends to them. */
+interface ConfigExtension {
+    override?: Partial<AnyConfig>;
+    extend?: Partial<AnyConfig>;
+}
+
+/** Merger config for the built-in Tailwind conflict resolver. */
+type TWMergeConfig = ConfigExtension & Partial<AnyConfig> & {
+    extend?: Partial<AnyConfig>;
+    override?: Partial<AnyConfig>;
+};
+type TWMConfig = {
+    /**
+     * Whether to merge conflicting Tailwind classes.
+     * @default true
+     */
+    twMerge?: boolean;
+    /**
+     * Custom merger config (`extend` / `override`, or legacy flat fields).
+     */
+    twMergeConfig?: TWMergeConfig;
+};
+type TVConfig = TWMConfig;
+
+export type { ClassNameValue as C, TWMConfig as T, TVConfig as a, TWMergeConfig as b };

package/dist/config-bO3A8WhU.d.ts

@@ -0,0 +1,112 @@
+/** Class value accepted by the callable merger (`createMerger()`). */
+type ClassNameValue = ClassNameArray | string | null | undefined | 0 | 0n | false;
+type ClassNameArray = readonly ClassNameValue[];
+/** Built-in merger configuration shape. */
+type Config<ClassGroupIds extends string, ThemeGroupIds extends string> = ConfigGroupsPart<ClassGroupIds, ThemeGroupIds>;
+/**
+ * Dynamic merger config groups. When merging configs, use `override` or `extend`.
+ */
+interface ConfigGroupsPart<ClassGroupIds extends string, ThemeGroupIds extends string> {
+    /**
+     * Theme scales used in classGroups.
+     *
+     * The keys are the same as in the Tailwind config but the values are sometimes defined more broadly.
+     */
+    theme: NoInfer<ThemeObject<ThemeGroupIds>>;
+    /**
+     * Object with groups of classes.
+     *
+     * @example
+     * {
+     *     // Creates group of classes `group`, `of` and `classes`
+     *     'group-id': ['group', 'of', 'classes'],
+     *     // Creates group of classes `look-at-me-other` and `look-at-me-group`.
+     *     'other-group': [{ 'look-at-me': ['other', 'group']}]
+     * }
+     */
+    classGroups: NoInfer<Record<ClassGroupIds, ClassGroup<ThemeGroupIds>>>;
+    /**
+     * Conflicting classes across groups.
+     *
+     * The key is the ID of a class group which creates a conflict, values are IDs of class groups which receive a conflict. That means if a class from from the key ID is present, all preceding classes from the values are removed.
+     *
+     * A class group ID is the key of a class group in the classGroups object.
+     *
+     * @example { gap: ['gap-x', 'gap-y'] }
+     */
+    conflictingClassGroups: NoInfer<Partial<Record<ClassGroupIds, readonly ClassGroupIds[]>>>;
+    /**
+     * Postfix modifiers conflicting with other class groups.
+     *
+     * A class group ID is the key of a class group in classGroups object.
+     *
+     * @example { 'font-size': ['leading'] }
+     */
+    conflictingClassGroupModifiers: NoInfer<Partial<Record<ClassGroupIds, readonly ClassGroupIds[]>>>;
+    /**
+     * Class group IDs which should be resolved again with their postfix modifier attached.
+     *
+     * This is needed when a slash can make the full class name belong to a different class group than the part before the slash.
+     *
+     * @example ['container-type'] // `@container-size/sidebar` should resolve differently from `@container-size`
+     */
+    postfixLookupClassGroups?: readonly NoInferString<ClassGroupIds>[];
+    /**
+     * Modifiers whose order among multiple modifiers should be preserved because their order changes which element gets targeted.
+     *
+     * Classes with these modifiers are not overwritten by peers that only differ in order-sensitive modifier position.
+     */
+    orderSensitiveModifiers: string[];
+}
+type ThemeObject<ThemeGroupIds extends string> = Record<ThemeGroupIds, ClassGroup<ThemeGroupIds>>;
+type ClassGroup<ThemeGroupIds extends string> = readonly ClassDefinition<ThemeGroupIds>[];
+type ClassDefinition<ThemeGroupIds extends string> = string | ClassValidator | ThemeGetter | ClassObject<ThemeGroupIds>;
+type ClassValidator = (classPart: string) => boolean;
+interface ThemeGetter {
+    (theme: ThemeObject<AnyThemeGroupIds>): ClassGroup<AnyClassGroupIds>;
+    isThemeGetter: true;
+}
+type ClassObject<ThemeGroupIds extends string> = Record<string, readonly ClassDefinition<ThemeGroupIds>[]>;
+/**
+ * Hack from https://stackoverflow.com/questions/56687668/a-way-to-disable-type-argument-inference-in-generics/56688073#56688073
+ *
+ * Could be replaced with NoInfer utility type from TypeScript (https://www.typescriptlang.org/docs/handbook/utility-types.html#noinfertype), but that is only supported in TypeScript 5.4 or higher, so I should wait some time before using it.
+ */
+type NoInfer<T> = [T][T extends unknown ? 0 : never];
+/**
+ * Special-purpose NoInfer variant for string unions used in array item positions.
+ *
+ * The NoInfer helper above doesn't prevent inference from array items in all cases, so this keeps
+ * config arrays like `postfixLookupClassGroups` from defining or narrowing class group IDs.
+ * Prefer TypeScript's built-in `NoInfer` when the minimum supported version is 5.4+.
+ */
+type NoInferString<T extends string> = T extends infer S ? S & string : never;
+type AnyClassGroupIds = string;
+type AnyThemeGroupIds = string;
+/** Merger config with unrestricted class-group and theme-group IDs. */
+type AnyConfig = Config<AnyClassGroupIds, AnyThemeGroupIds>;
+/** Merger config: `override` replaces class groups, `extend` appends to them. */
+interface ConfigExtension {
+    override?: Partial<AnyConfig>;
+    extend?: Partial<AnyConfig>;
+}
+
+/** Merger config for the built-in Tailwind conflict resolver. */
+type TWMergeConfig = ConfigExtension & Partial<AnyConfig> & {
+    extend?: Partial<AnyConfig>;
+    override?: Partial<AnyConfig>;
+};
+type TWMConfig = {
+    /**
+     * Whether to merge conflicting Tailwind classes.
+     * @default true
+     */
+    twMerge?: boolean;
+    /**
+     * Custom merger config (`extend` / `override`, or legacy flat fields).
+     */
+    twMergeConfig?: TWMergeConfig;
+};
+type TVConfig = TWMConfig;
+
+export type { ClassNameValue as C, TWMConfig as T, TVConfig as a, TWMergeConfig as b };

package/dist/config.cjs

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/config.d.cts

@@ -0,0 +1 @@
+export { a as TVConfig, T as TWMConfig, b as TWMergeConfig } from './config-bO3A8WhU.cjs';

package/dist/config.d.ts

@@ -1,23 +1 @@
-import type {extendTailwindMerge} from "tailwind-merge";
-
-type MergeConfig = Parameters<typeof extendTailwindMerge>[0];
-type LegacyMergeConfig = Extract<MergeConfig, {extend?: unknown}>["extend"];
-
-export type TWMergeConfig = MergeConfig & LegacyMergeConfig;
-
-export type TWMConfig = {
-  /**
-   * Whether to merge the class names with `tailwind-merge` library.
-   * It's avoid to have duplicate tailwind classes. (Recommended)
-   * @see https://github.com/dcastil/tailwind-merge/blob/v2.2.0/README.md
-   * @default true
-   */
-  twMerge?: boolean;
-  /**
-   * The config object for `tailwind-merge` library.
-   * @see https://github.com/dcastil/tailwind-merge/blob/v2.2.0/docs/configuration.md
-   */
-  twMergeConfig?: TWMergeConfig;
-};
-
-export type TVConfig = TWMConfig;
+export { a as TVConfig, T as TWMConfig, b as TWMergeConfig } from './config-bO3A8WhU.js';

package/dist/config.js

@@ -0,0 +1 @@
+