tailwindcss 0.0.0-insiders.eb8d929 → 0.0.0-insiders.ec0049a

package/src/lib/setupTrackingContext.js

@@ -1,169 +0,0 @@
-// @ts-check
-
-import fs from 'fs'
-import LRU from '@alloc/quick-lru'
-
-import hash from '../util/hashConfig'
-import resolveConfig from '../public/resolve-config'
-import resolveConfigPath from '../util/resolveConfigPath'
-import { getContext, getFileModifiedMap } from './setupContextUtils'
-import parseDependency from '../util/parseDependency'
-import { validateConfig } from '../util/validateConfig.js'
-import { parseCandidateFiles, resolvedChangedContent } from './content.js'
-import { loadConfig } from '../lib/load-config'
-import getModuleDependencies from './getModuleDependencies'
-
-let configPathCache = new LRU({ maxSize: 100 })
-
-let candidateFilesCache = new WeakMap()
-
-function getCandidateFiles(context, tailwindConfig) {
-  if (candidateFilesCache.has(context)) {
-    return candidateFilesCache.get(context)
-  }
-
-  let candidateFiles = parseCandidateFiles(context, tailwindConfig)
-
-  return candidateFilesCache.set(context, candidateFiles).get(context)
-}
-
-// Get the config object based on a path
-function getTailwindConfig(configOrPath) {
-  let userConfigPath = resolveConfigPath(configOrPath)
-
-  if (userConfigPath !== null) {
-    let [prevConfig, prevConfigHash, prevDeps, prevModified] =
-      configPathCache.get(userConfigPath) || []
-
-    let newDeps = getModuleDependencies(userConfigPath)
-
-    let modified = false
-    let newModified = new Map()
-    for (let file of newDeps) {
-      let time = fs.statSync(file).mtimeMs
-      newModified.set(file, time)
-      if (!prevModified || !prevModified.has(file) || time > prevModified.get(file)) {
-        modified = true
-      }
-    }
-
-    // It hasn't changed (based on timestamps)
-    if (!modified) {
-      return [prevConfig, userConfigPath, prevConfigHash, prevDeps]
-    }
-
-    // It has changed (based on timestamps), or first run
-    for (let file of newDeps) {
-      delete require.cache[file]
-    }
-    let newConfig = validateConfig(resolveConfig(loadConfig(userConfigPath)))
-    let newHash = hash(newConfig)
-    configPathCache.set(userConfigPath, [newConfig, newHash, newDeps, newModified])
-    return [newConfig, userConfigPath, newHash, newDeps]
-  }
-
-  // It's a plain object, not a path
-  let newConfig = resolveConfig(configOrPath?.config ?? configOrPath ?? {})
-
-  newConfig = validateConfig(newConfig)
-
-  return [newConfig, null, hash(newConfig), []]
-}
-
-// DISABLE_TOUCH = TRUE
-
-// Retrieve an existing context from cache if possible (since contexts are unique per
-// source path), or set up a new one (including setting up watchers and registering
-// plugins) then return it
-export default function setupTrackingContext(configOrPath) {
-  return ({ tailwindDirectives, registerDependency }) => {
-    return (root, result) => {
-      let [tailwindConfig, userConfigPath, tailwindConfigHash, configDependencies] =
-        getTailwindConfig(configOrPath)
-
-      let contextDependencies = new Set(configDependencies)
-
-      // If there are no @tailwind or @apply rules, we don't consider this CSS
-      // file or its dependencies to be dependencies of the context. Can reuse
-      // the context even if they change. We may want to think about `@layer`
-      // being part of this trigger too, but it's tough because it's impossible
-      // for a layer in one file to end up in the actual @tailwind rule in
-      // another file since independent sources are effectively isolated.
-      if (tailwindDirectives.size > 0) {
-        // Add current css file as a context dependencies.
-        contextDependencies.add(result.opts.from)
-
-        // Add all css @import dependencies as context dependencies.
-        for (let message of result.messages) {
-          if (message.type === 'dependency') {
-            contextDependencies.add(message.file)
-          }
-        }
-      }
-
-      let [context, , mTimesToCommit] = getContext(
-        root,
-        result,
-        tailwindConfig,
-        userConfigPath,
-        tailwindConfigHash,
-        contextDependencies
-      )
-
-      let fileModifiedMap = getFileModifiedMap(context)
-
-      let candidateFiles = getCandidateFiles(context, tailwindConfig)
-
-      // If there are no @tailwind or @apply rules, we don't consider this CSS file or it's
-      // dependencies to be dependencies of the context. Can reuse the context even if they change.
-      // We may want to think about `@layer` being part of this trigger too, but it's tough
-      // because it's impossible for a layer in one file to end up in the actual @tailwind rule
-      // in another file since independent sources are effectively isolated.
-      if (tailwindDirectives.size > 0) {
-        // Add template paths as postcss dependencies.
-        for (let contentPath of candidateFiles) {
-          for (let dependency of parseDependency(contentPath)) {
-            registerDependency(dependency)
-          }
-        }
-
-        let [changedContent, contentMTimesToCommit] = resolvedChangedContent(
-          context,
-          candidateFiles,
-          fileModifiedMap
-        )
-
-        for (let content of changedContent) {
-          context.changedContent.push(content)
-        }
-
-        // Add the mtimes of the content files to the commit list
-        // We can overwrite the existing values because unconditionally
-        // This is because:
-        // 1. Most of the files here won't be in the map yet
-        // 2. If they are that means it's a context dependency
-        // and we're reading this after the context. This means
-        // that the mtime we just read is strictly >= the context
-        // mtime. Unless the user / os is doing something weird
-        // in which the mtime would be going backwards. If that
-        // happens there's already going to be problems.
-        for (let [path, mtime] of contentMTimesToCommit.entries()) {
-          mTimesToCommit.set(path, mtime)
-        }
-      }
-
-      for (let file of configDependencies) {
-        registerDependency({ type: 'dependency', file })
-      }
-
-      // "commit" the new modified time for all context deps
-      // We do this here because we want content tracking to
-      // read the "old" mtime even when it's a context dependency.
-      for (let [path, mtime] of mTimesToCommit.entries()) {
-        fileModifiedMap.set(path, mtime)
-      }
-
-      return context
-    }
-  }
-}

package/src/lib/sharedState.js

@@ -1,57 +0,0 @@
-export const env =
-  typeof process !== 'undefined'
-    ? {
-        NODE_ENV: process.env.NODE_ENV,
-        DEBUG: resolveDebug(process.env.DEBUG),
-      }
-    : {
-        NODE_ENV: 'production',
-        DEBUG: false,
-      }
-
-export const contextMap = new Map()
-export const configContextMap = new Map()
-export const contextSourcesMap = new Map()
-export const sourceHashMap = new Map()
-export const NOT_ON_DEMAND = new String('*')
-
-export const NONE = Symbol('__NONE__')
-
-export function resolveDebug(debug) {
-  if (debug === undefined) {
-    return false
-  }
-
-  // Environment variables are strings, so convert to boolean
-  if (debug === 'true' || debug === '1') {
-    return true
-  }
-
-  if (debug === 'false' || debug === '0') {
-    return false
-  }
-
-  // Keep the debug convention into account:
-  // DEBUG=* -> This enables all debug modes
-  // DEBUG=projectA,projectB,projectC -> This enables debug for projectA, projectB and projectC
-  // DEBUG=projectA:* -> This enables all debug modes for projectA (if you have sub-types)
-  // DEBUG=projectA,-projectB -> This enables debug for projectA and explicitly disables it for projectB
-
-  if (debug === '*') {
-    return true
-  }
-
-  let debuggers = debug.split(',').map((d) => d.split(':')[0])
-
-  // Ignoring tailwindcss
-  if (debuggers.includes('-tailwindcss')) {
-    return false
-  }
-
-  // Including tailwindcss
-  if (debuggers.includes('tailwindcss')) {
-    return true
-  }
-
-  return false
-}

package/src/lib/substituteScreenAtRules.js

@@ -1,19 +0,0 @@
-import { normalizeScreens } from '../util/normalizeScreens'
-import buildMediaQuery from '../util/buildMediaQuery'
-
-export default function ({ tailwindConfig: { theme } }) {
-  return function (css) {
-    css.walkAtRules('screen', (atRule) => {
-      let screen = atRule.params
-      let screens = normalizeScreens(theme.screens)
-      let screenDefinition = screens.find(({ name }) => name === screen)
-
-      if (!screenDefinition) {
-        throw atRule.error(`No \`${screen}\` screen found.`)
-      }
-
-      atRule.name = 'media'
-      atRule.params = buildMediaQuery(screenDefinition)
-    })
-  }
-}

package/src/plugin.js

@@ -1,124 +0,0 @@
-import postcss from 'postcss'
-import lightningcss from 'lightningcss'
-import browserslist from 'browserslist'
-import setupTrackingContext from './lib/setupTrackingContext'
-import processTailwindFeatures from './processTailwindFeatures'
-import { env } from './lib/sharedState'
-import { findAtConfigPath } from './lib/findAtConfigPath'
-import { handleImportAtRules } from './lib/handleImportAtRules'
-
-module.exports = function tailwindcss(configOrPath) {
-  return {
-    postcssPlugin: 'tailwindcss',
-    plugins: [
-      env.DEBUG &&
-        function (root) {
-          console.log('\n')
-          console.time('JIT TOTAL')
-          return root
-        },
-      ...handleImportAtRules(),
-      function (root, result) {
-        // Use the path for the `@config` directive if it exists, otherwise use the
-        // path for the file being processed
-        configOrPath = findAtConfigPath(root, result) ?? configOrPath
-
-        let context = setupTrackingContext(configOrPath)
-
-        if (root.type === 'document') {
-          let roots = root.nodes.filter((node) => node.type === 'root')
-
-          for (const root of roots) {
-            if (root.type === 'root') {
-              processTailwindFeatures(context)(root, result)
-            }
-          }
-
-          return
-        }
-
-        processTailwindFeatures(context)(root, result)
-      },
-      function lightningCssPlugin(_root, result) {
-        let map = result.map ?? result.opts.map
-
-        let intermediateResult = result.root.toResult({
-          map: map ? { inline: true } : false,
-        })
-        let intermediateMap = intermediateResult.map?.toJSON?.() ?? map
-
-        try {
-          let transformed = lightningcss.transform({
-            filename: result.opts.from,
-            code: Buffer.from(intermediateResult.css),
-            minify: false,
-            sourceMap: !!intermediateMap,
-            targets:
-              typeof process !== 'undefined' && process.env.JEST_WORKER_ID
-                ? { chrome: 111 << 16 }
-                : lightningcss.browserslistToTargets(
-                    browserslist(require('../package.json').browserslist)
-                  ),
-            drafts: {
-              nesting: true,
-              customMedia: true,
-            },
-            nonStandard: {
-              deepSelectorCombinator: true,
-            },
-          })
-
-          let code = transformed.code.toString()
-
-          // https://postcss.org/api/#sourcemapoptions
-          if (intermediateMap && transformed.map != null) {
-            let prev = transformed.map.toString()
-
-            if (typeof intermediateMap === 'object') {
-              intermediateMap.prev = prev
-            } else {
-              code = `${code}\n/*# sourceMappingURL=data:application/json;base64,${Buffer.from(
-                prev
-              ).toString('base64')} */`
-            }
-          }
-
-          result.root = postcss.parse(code, {
-            ...result.opts,
-            map: intermediateMap,
-          })
-        } catch (err) {
-          if (err.source && typeof process !== 'undefined' && process.env.JEST_WORKER_ID) {
-            let lines = err.source.split('\n')
-            err = new Error(
-              [
-                'Error formatting using Lightning CSS:',
-                '',
-                ...[
-                  '```css',
-                  ...lines.slice(Math.max(err.loc.line - 3, 0), err.loc.line),
-                  ' '.repeat(err.loc.column - 1) + '^-- ' + err.toString(),
-                  ...lines.slice(err.loc.line, err.loc.line + 2),
-                  '```',
-                ],
-              ].join('\n')
-            )
-          }
-
-          if (Error.captureStackTrace) {
-            Error.captureStackTrace(err, lightningCssPlugin)
-          }
-          throw err
-        }
-      },
-      env.DEBUG &&
-        function (root) {
-          console.timeEnd('JIT TOTAL')
-          console.log('\n')
-          return root
-        },
-    ].filter(Boolean),
-  }
-}
-
-module.exports.postcss = true

package/src/postcss-plugins/nesting/README.md

@@ -1,42 +0,0 @@
-# tailwindcss/nesting
-
-This is a PostCSS plugin that wraps [postcss-nested](https://github.com/postcss/postcss-nested) or [postcss-nesting](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-nesting) and acts as a compatibility layer to make sure your nesting plugin of choice properly understands Tailwind's custom syntax like `@apply` and `@screen`.
-
-Add it to your PostCSS configuration, somewhere before Tailwind itself:
-
-```js
-// postcss.config.js
-module.exports = {
-  plugins: [
-    require('postcss-import'),
-    require('tailwindcss/nesting'),
-    require('tailwindcss'),
-    require('autoprefixer'),
-  ]
-}
-```
-
-By default, it uses the [postcss-nested](https://github.com/postcss/postcss-nested) plugin under the hood, which uses a Sass-like syntax and is the plugin that powers nesting support in the [Tailwind CSS plugin API](https://tailwindcss.com/docs/plugins#css-in-js-syntax).
-
-If you'd rather use [postcss-nesting](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-nesting) (which is based on the work-in-progress [CSS Nesting](https://drafts.csswg.org/css-nesting-1/) specification), first install the plugin alongside:
-
-```shell
-npm install postcss-nesting
-```
-
-Then pass the plugin itself as an argument to `tailwindcss/nesting` in your PostCSS configuration:
-
-```js
-// postcss.config.js
-module.exports = {
-  plugins: [
-    require('postcss-import'),
-    require('tailwindcss/nesting')(require('postcss-nesting')),
-    require('tailwindcss'),
-    require('autoprefixer'),
-  ]
-}
-```
-
-This can also be helpful if for whatever reason you need to use a very specific version of `postcss-nested` and want to override the version we bundle with `tailwindcss/nesting` itself.
-

package/src/postcss-plugins/nesting/index.js

@@ -1,13 +0,0 @@
-import { nesting } from './plugin'
-
-export default Object.assign(
-  function (opts) {
-    return {
-      postcssPlugin: 'tailwindcss/nesting',
-      Once(root, { result }) {
-        return nesting(opts)(root, result)
-      },
-    }
-  },
-  { postcss: true }
-)

package/src/postcss-plugins/nesting/plugin.js

@@ -1,80 +0,0 @@
-import postcss from 'postcss'
-import postcssNested from 'postcss-nested'
-
-export function nesting(opts = postcssNested) {
-  return (root, result) => {
-    root.walkAtRules('screen', (rule) => {
-      rule.name = 'media'
-      rule.params = `screen(${rule.params})`
-    })
-
-    root.walkAtRules('apply', (rule) => {
-      rule.before(postcss.decl({ prop: '__apply', value: rule.params, source: rule.source }))
-      rule.remove()
-    })
-
-    let plugin = (() => {
-      if (
-        typeof opts === 'function' ||
-        (typeof opts === 'object' && opts?.hasOwnProperty?.('postcssPlugin'))
-      ) {
-        return opts
-      }
-
-      if (typeof opts === 'string') {
-        return require(opts)
-      }
-
-      if (Object.keys(opts).length <= 0) {
-        return postcssNested
-      }
-
-      throw new Error('tailwindcss/nesting should be loaded with a nesting plugin.')
-    })()
-
-    postcss([plugin]).process(root, result.opts).sync()
-
-    root.walkDecls('__apply', (decl) => {
-      decl.before(postcss.atRule({ name: 'apply', params: decl.value, source: decl.source }))
-      decl.remove()
-    })
-
-    /**
-     * Use a private PostCSS API to remove the "clean" flag from the entire AST.
-     * This is done because running process() on the AST will set the "clean"
-     * flag on all nodes, which we don't want.
-     *
-     * This causes downstream plugins using the visitor API to be skipped.
-     *
-     * This is guarded because the PostCSS API is not public
-     * and may change in future versions of PostCSS.
-     *
-     * See https://github.com/postcss/postcss/issues/1712 for more details
-     *
-     * @param {import('postcss').Node} node
-     */
-    function markDirty(node) {
-      if (!('markDirty' in node)) {
-        return
-      }
-
-      // Traverse the tree down to the leaf nodes
-      if (node.nodes) {
-        node.nodes.forEach((n) => markDirty(n))
-      }
-
-      // If it's a leaf node mark it as dirty
-      // We do this here because marking a node as dirty
-      // will walk up the tree and mark all parents as dirty
-      // resulting in a lot of unnecessary work if we did this
-      // for every single node
-      if (!node.nodes) {
-        node.markDirty()
-      }
-    }
-
-    markDirty(root)
-
-    return root
-  }
-}

package/src/processTailwindFeatures.js

@@ -1,58 +0,0 @@
-import normalizeTailwindDirectives from './lib/normalizeTailwindDirectives'
-import expandTailwindAtRules from './lib/expandTailwindAtRules'
-import expandApplyAtRules from './lib/expandApplyAtRules'
-import evaluateTailwindFunctions from './lib/evaluateTailwindFunctions'
-import substituteScreenAtRules from './lib/substituteScreenAtRules'
-import resolveDefaultsAtRules from './lib/resolveDefaultsAtRules'
-import collapseAdjacentRules from './lib/collapseAdjacentRules'
-import collapseDuplicateDeclarations from './lib/collapseDuplicateDeclarations'
-import partitionApplyAtRules from './lib/partitionApplyAtRules'
-import detectNesting from './lib/detectNesting'
-import { createContext } from './lib/setupContextUtils'
-import { issueFlagNotices } from './featureFlags'
-
-export default function processTailwindFeatures(setupContext) {
-  return function (root, result) {
-    let { tailwindDirectives, applyDirectives } = normalizeTailwindDirectives(root)
-
-    detectNesting()(root, result)
-
-    // Partition apply rules that are found in the css
-    // itself.
-    partitionApplyAtRules()(root, result)
-
-    let context = setupContext({
-      tailwindDirectives,
-      applyDirectives,
-      registerDependency(dependency) {
-        result.messages.push({
-          plugin: 'tailwindcss',
-          parent: result.opts.from,
-          ...dependency,
-        })
-      },
-      createContext(tailwindConfig, changedContent) {
-        return createContext(tailwindConfig, changedContent, root)
-      },
-    })(root, result)
-
-    if (context.tailwindConfig.separator === '-') {
-      throw new Error(
-        "The '-' character cannot be used as a custom separator in JIT mode due to parsing ambiguity. Please use another character like '_' instead."
-      )
-    }
-
-    issueFlagNotices(context.tailwindConfig)
-
-    expandTailwindAtRules(context)(root, result)
-    // Partition apply rules that are generated by
-    // addComponents, addUtilities and so on.
-    partitionApplyAtRules()(root, result)
-    expandApplyAtRules(context)(root, result)
-    evaluateTailwindFunctions(context)(root, result)
-    substituteScreenAtRules(context)(root, result)
-    resolveDefaultsAtRules(context)(root, result)
-    collapseAdjacentRules(context)(root, result)
-    collapseDuplicateDeclarations(context)(root, result)
-  }
-}