Function spacingUtility

packages/tailwindcss/src/utilities.ts:528–577

(
    name: string,
    themeKeys: ThemeKey[],
    handle: (value: string) => AstNode[] | undefined,
    {
      supportsNegative = false,
      supportsFractions = false,
      staticValues,
    }: {
      supportsNegative?: boolean
      supportsFractions?: boolean
      staticValues?: Record<string, AstNode[]>
    } = {},
  )

  }

  function spacingUtility(
    name: string,
    themeKeys: ThemeKey[],
    handle: (value: string) => AstNode[] | undefined,
    {
      supportsNegative = false,
      supportsFractions = false,
      staticValues,
    }: {
      supportsNegative?: boolean
      supportsFractions?: boolean
      staticValues?: Record<string, AstNode[]>
    } = {},
  ) {
    if (supportsNegative) {
      utilities.static(`-${name}-px`, () => handle(class="st">'-1px'))
    }
    utilities.static(`${name}-px`, () => handle(class="st">'1px'))
    functionalUtility(name, {
      themeKeys,
      supportsFractions,
      supportsNegative,
      defaultValue: null,
      handleBareValue: ({ value }) => {
        let multiplier = theme.resolve(null, [class="st">'--spacing'])
        if (!multiplier) return null
        if (!isValidSpacingMultiplier(value)) return null

        return `--spacing(${value})`
      },
      handleNegativeBareValue: ({ value }) => {
        let multiplier = theme.resolve(null, [class="st">'--spacing'])
        if (!multiplier) return null
        if (!isValidSpacingMultiplier(value)) return null

        return `--spacing(-${value})`
      },
      handle,
      staticValues,
    })

    suggest(name, () => [
      {
        values: theme.get([class="st">'--spacing']) ? DEFAULT_SPACING_SUGGESTIONS : [],
        supportsNegative,
        supportsFractions,
        valueThemeKeys: themeKeys,
      },
    ])
  }

  /**
   * ----------------