rewriteUrls() — tailwindcss Function Reference

Architecture documentation for the rewriteUrls() function in urls.ts from the tailwindcss codebase.

Function typescript CompilerEngine AstTransformation calls 4 called by 1

Entity Profile

CompilerEngine→ AstTransformation→ rewriteUrls() — tailwindcss Function Reference

Dependency Diagram

graph TD
  ef1f735b_b130_6631_a9cc_e465ace5e479["rewriteUrls()"]
  2cba246e_336d_6f47_8fa4_83f35f72c847["createCompileOptions()"]
  2cba246e_336d_6f47_8fa4_83f35f72c847 -->|calls| ef1f735b_b130_6631_a9cc_e465ace5e479
  257c4715_dc91_0c7f_fce8_433a757d9ce6["parse()"]
  ef1f735b_b130_6631_a9cc_e465ace5e479 -->|calls| 257c4715_dc91_0c7f_fce8_433a757d9ce6
  fafe253f_5b0a_82ac_9823_6d2c3e638dbd["normalizePath()"]
  ef1f735b_b130_6631_a9cc_e465ace5e479 -->|calls| fafe253f_5b0a_82ac_9823_6d2c3e638dbd
  e9d556bc_f22d_356c_1bd2_27442c34b5c7["walk()"]
  ef1f735b_b130_6631_a9cc_e465ace5e479 -->|calls| e9d556bc_f22d_356c_1bd2_27442c34b5c7
  af90c185_29a2_6c4c_ef06_b18f00f7655c["toCss()"]
  ef1f735b_b130_6631_a9cc_e465ace5e479 -->|calls| af90c185_29a2_6c4c_ef06_b18f00f7655c
  style ef1f735b_b130_6631_a9cc_e465ace5e479 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/@tailwindcss-node/src/urls.ts lines 37–93

export async function rewriteUrls({
  css,
  base,
  root,
}: {
  css: string
  base: string
  root: string
}) {
  if (!css.includes('url(') && !css.includes('image-set(')) {
    return css
  }

  let ast = parse(css)

  let promises: Promise<void>[] = []

  function replacerForDeclaration(url: string) {
    if (url[0] === '/') return url

    let absoluteUrl = path.posix.join(normalizePath(base), url)
    let relativeUrl = path.posix.relative(normalizePath(root), absoluteUrl)

    // If the path points to a file in the same directory, `path.relative` will
    // remove the leading `./` and we need to add it back in order to still
    // consider the path relative
    if (!relativeUrl.startsWith('.')) {
      relativeUrl = './' + relativeUrl
    }

    return relativeUrl
  }

  walk(ast, (node) => {
    if (node.kind !== 'declaration') return
    if (!node.value) return

    let isCssUrl = cssUrlRE.test(node.value)
    let isCssImageSet = cssImageSetRE.test(node.value)

    if (isCssUrl || isCssImageSet) {
      let rewriterToUse = isCssImageSet ? rewriteCssImageSet : rewriteCssUrls

      promises.push(
        rewriterToUse(node.value, replacerForDeclaration).then((url) => {
          node.value = url
        }),
      )
    }
  })

  if (promises.length) {
    await Promise.all(promises)
  }

  return toCss(ast)
}