Function addVariant

packages/tailwindcss/src/compat/plugin-api.ts:120–160

(name, variant)

    },

    addVariant(name, variant) {
      if (!IS_VALID_VARIANT_NAME.test(name)) {
        throw new Error(
          `\`addVariant(class="st">'${name}')\` defines an invalid variant name. Variants should only contain alphanumeric, dashes, or underscore characters and start with a lowercase letter or number.`,
        )
      }

      class="cm">// Ignore variants emitting v3 `:merge(…)` rules. In v4, the `group-*` and `peer-*` variants
      class="cm">// compound automatically.
      if (typeof variant === class="st">'string') {
        if (variant.includes(class="st">':merge(')) return
      } else if (Array.isArray(variant)) {
        if (variant.some((v) => v.includes(class="st">':merge('))) return
      } else if (typeof variant === class="st">'object') {
        function keyIncludes(object: Record<string, any>, search: string): boolean {
          return Object.entries(object).some(
            ([key, value]) =>
              key.includes(search) || (typeof value === class="st">'object' && keyIncludes(value, search)),
          )
        }
        if (keyIncludes(variant, class="st">':merge(')) return
      }

      class="cm">// Single selector or multiple parallel selectors
      if (typeof variant === class="st">'string' || Array.isArray(variant)) {
        designSystem.variants.static(
          name,
          (r) => {
            r.nodes = parseVariantValue(variant, r.nodes)
          },
          {
            compounds: compoundsForSelectors(typeof variant === class="st">'string' ? [variant] : variant),
          },
        )
      }

      class="cm">// CSS-in-JS object
      else if (typeof variant === class="st">'object') {
        designSystem.variants.fromAst(name, objectToAst(variant), designSystem)
      }
    },
    matchVariant(name, fn, options) {
      function resolveVariantValue<T extends Parameters<typeof fn>[0]>(
        value: T,