process() — tailwindcss Function Reference

Architecture documentation for the process() function in slim.rs from the tailwindcss codebase.

Function rust OxideEngine PreProcessors

Entity Profile

OxideEngine→ PreProcessors→ process() — tailwindcss Function Reference

Dependency Diagram

graph TD
  990d740b_e805_68bb_d4c1_b125cb613a29["process()"]
  728c6622_d993_001c_2e5b_541b85f1c521["slim.rs"]
  990d740b_e805_68bb_d4c1_b125cb613a29 -->|defined in| 728c6622_d993_001c_2e5b_541b85f1c521
  style 990d740b_e805_68bb_d4c1_b125cb613a29 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

crates/oxide/src/extractor/pre_processors/slim.rs lines 11–138

    fn process(&self, content: &[u8]) -> Vec<u8> {
        let len = content.len();
        let mut result = content.to_vec();
        let mut cursor = cursor::Cursor::new(content);
        let mut bracket_stack = BracketStack::default();

        while cursor.pos < len {
            match cursor.curr {
                // Only replace `.` with a space if it's not surrounded by numbers. E.g.:
                //
                // ```diff
                // - .flex.items-center
                // +  flex items-center
                // ```
                //
                // But with numbers, it's allowed:
                //
                // ```diff
                // - px-2.5
                // + px-2.5
                // ```
                b'.' => {
                    // Don't replace dots with spaces when inside of any type of brackets, because
                    // this could be part of arbitrary values. E.g.: `bg-[url(https://example.com)]`
                    //                                                                       ^
                    if !bracket_stack.is_empty() {
                        cursor.advance();
                        continue;
                    }

                    // If the dot is surrounded by digits, we want to keep it. E.g.: `px-2.5`
                    // EXCEPT if it's followed by a valid variant that happens to start with a
                    // digit.
                    // E.g.: `bg-red-500.2xl:flex`
                    //                 ^^^
                    if cursor.prev.is_ascii_digit() && cursor.next.is_ascii_digit() {
                        let mut next_cursor = cursor.clone();
                        next_cursor.advance();

                        let mut variant_machine = VariantMachine::default();
                        if let MachineState::Done(_) = variant_machine.next(&mut next_cursor) {
                            result[cursor.pos] = b' ';
                        }
                    } else {
                        result[cursor.pos] = b' ';
                    }
                }

                // Handle Ruby syntax with `%w[]` arrays embedded in Slim directly.
                //
                // E.g.:
                //
                // ```
                // div [
                //   class=%w[bg-blue-500 w-10 h-10]
                // ]
                // ```
                b'%' if matches!(cursor.next, b'w' | b'W')
                    && matches!(cursor.input.get(cursor.pos + 2), Some(b'[' | b'(' | b'{')) =>
                {
                    result[cursor.pos] = b' '; // Replace `%`
                    cursor.advance();
                    result[cursor.pos] = b' '; // Replace `w`
                    cursor.advance();
                    result[cursor.pos] = b' '; // Replace `[` or `(` or `{`
                    bracket_stack.push(cursor.curr);
                    cursor.advance(); // Move past the bracket
                    continue;
                }

                // Any `[` preceded by an alphanumeric value will not be part of a candidate.
                //
                // E.g.:
                //
                // ```
                //  .text-xl.text-red-600[
                //                       ^ not part of the `text-red-600` candidate
                //    data-foo="bar"
                //  ]
                //    | This line should be red
                // ```