tailwindcss/src/featureFlags.js
2020-08-19 13:34:21 -04:00

75 lines
1.9 KiB
JavaScript

import _ from 'lodash'
import chalk from 'chalk'
import log from './util/log'
const featureFlags = {
future: ['removeDeprecatedGapUtilities'],
experimental: [
'uniformColorPalette',
'extendedSpacingScale',
'defaultLineHeights',
'extendedFontSizeScale',
'applyComplexClasses',
],
}
export function flagEnabled(config, flag) {
if (featureFlags.future.includes(flag)) {
return config.future === 'all' || _.get(config, ['future', flag], false)
}
if (featureFlags.experimental.includes(flag)) {
return config.experimental === 'all' || _.get(config, ['experimental', flag], false)
}
return false
}
function experimentalFlagsEnabled(config) {
if (config.experimental === 'all') {
return featureFlags.experimental
}
return Object.keys(_.get(config, 'experimental', {})).filter(
flag => featureFlags.experimental.includes(flag) && config.experimental[flag]
)
}
function futureFlagsAvailable(config) {
if (config.future === 'all') {
return []
}
return featureFlags.future.filter(flag => !_.has(config, ['future', flag]))
}
export function issueFlagNotices(config) {
if (process.env.JEST_WORKER_ID !== undefined) {
return
}
if (experimentalFlagsEnabled(config).length > 0) {
const changes = experimentalFlagsEnabled(config)
.map(s => chalk.yellow(s))
.join(', ')
log.warn([
`You have enabled experimental features: ${changes}`,
'Experimental features are not covered by semver, may introduce breaking changes, and can change at any time.',
])
}
if (futureFlagsAvailable(config).length > 0) {
const changes = futureFlagsAvailable(config)
.map(s => chalk.magenta(s))
.join(', ')
log.risk([
`There are upcoming breaking changes: ${changes}`,
'We highly recommend opting-in to these changes now to simplify upgrading Tailwind in the future.',
'https://tailwindcss.com/docs/upcoming-changes',
])
}
}
export default featureFlags