postCssAstToCssAst() — tailwindcss Function Reference

Architecture documentation for the postCssAstToCssAst() function in ast.ts from the tailwindcss codebase.

Function typescript BuildIntegrations PostCSSPlugin calls 5 called by 2

Entity Profile

BuildIntegrations→ PostCSSPlugin→ postCssAstToCssAst() — tailwindcss Function Reference

Dependency Diagram

graph TD
  117741fb_51f9_63e4_669e_170efd25ca86["postCssAstToCssAst()"]
  25f462e7_c718_35c5_7ff1_b1b41cc176bf["ast.ts"]
  117741fb_51f9_63e4_669e_170efd25ca86 -->|defined in| 25f462e7_c718_35c5_7ff1_b1b41cc176bf
  7e4891ad_b5c5_f083_e9e1_3dc43422517d["tailwindcss()"]
  7e4891ad_b5c5_f083_e9e1_3dc43422517d -->|calls| 117741fb_51f9_63e4_669e_170efd25ca86
  68e0856a_9def_2393_d694_827f4f3af860["compiler()"]
  68e0856a_9def_2393_d694_827f4f3af860 -->|calls| 117741fb_51f9_63e4_669e_170efd25ca86
  5bcf4886_1230_a8ff_7302_a26cc5a9a525["get()"]
  117741fb_51f9_63e4_669e_170efd25ca86 -->|calls| 5bcf4886_1230_a8ff_7302_a26cc5a9a525
  c203f636_607a_d332_b4c5_6a40c108f778["decl()"]
  117741fb_51f9_63e4_669e_170efd25ca86 -->|calls| c203f636_607a_d332_b4c5_6a40c108f778
  66319c06_7c38_f9ea_4bf0_2a0e18bac1a4["rule()"]
  117741fb_51f9_63e4_669e_170efd25ca86 -->|calls| 66319c06_7c38_f9ea_4bf0_2a0e18bac1a4
  f9b19679_c1f0_28d6_4d1a_31a10c52e42d["atRule()"]
  117741fb_51f9_63e4_669e_170efd25ca86 -->|calls| f9b19679_c1f0_28d6_4d1a_31a10c52e42d
  96bdb9bb_93af_2fac_25bd_5a2e67895fa7["comment()"]
  117741fb_51f9_63e4_669e_170efd25ca86 -->|calls| 96bdb9bb_93af_2fac_25bd_5a2e67895fa7
  style 117741fb_51f9_63e4_669e_170efd25ca86 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/@tailwindcss-postcss/src/ast.ts lines 126–189

export function postCssAstToCssAst(root: postcss.Root): AstNode[] {
  let inputMap = new DefaultMap<postcss.Input, Source>((input) => ({
    file: input.file ?? input.id ?? null,
    code: input.css,
  }))

  function toSource(node: postcss.ChildNode): SourceLocation | undefined {
    let source = node.source
    if (!source) return

    let input = source.input
    if (!input) return
    if (source.start === undefined) return
    if (source.end === undefined) return

    return [inputMap.get(input), source.start.offset, source.end.offset]
  }

  function transform(
    node: postcss.ChildNode,
    parent: Extract<AstNode, { nodes: AstNode[] }>['nodes'],
  ) {
    // Declaration
    if (node.type === 'decl') {
      let astNode = decl(node.prop, node.value, node.important)
      astNode.src = toSource(node)
      parent.push(astNode)
    }

    // Rule
    else if (node.type === 'rule') {
      let astNode = rule(node.selector)
      astNode.src = toSource(node)
      node.each((child) => transform(child, astNode.nodes))
      parent.push(astNode)
    }

    // AtRule
    else if (node.type === 'atrule') {
      let astNode = atRule(`@${node.name}`, node.params)
      astNode.src = toSource(node)
      node.each((child) => transform(child, astNode.nodes))
      parent.push(astNode)
    }

    // Comment
    else if (node.type === 'comment') {
      if (node.text.charCodeAt(0) !== EXCLAMATION_MARK) return
      let astNode = comment(node.text)
      astNode.src = toSource(node)
      parent.push(astNode)
    }

    // Unknown
    else {
      node satisfies never
    }
  }

  let ast: AstNode[] = []
  root.each((node) => transform(node, ast))

  return ast
}