Built-in Plugins

Oxc transformer includes built-in support for popular transformation plugins to improve developer experience and build performance.

Tagged Template Escape

When enabled, </script> sequences inside tagged template literals are escaped to prevent browsers from prematurely closing a surrounding <script> tag. This avoids parsing errors and potential XSS vulnerabilities when JavaScript is embedded directly in HTML.

Recommendation

Enable this option when the transformed output may be embedded directly in HTML <script> tags. Without it, tagged template literals containing </script> can break when embedded in HTML <script> tags. See oxc-project/oxc#15306 for details.

import { transform } from "oxc-transform";

const result = await transform("lib.js", sourceCode, {
  plugins: {
    taggedTemplateEscape: true,
  },
});

For example, foo`</script>` is transformed into a helper call where the </script> sequence is escaped to <\/script>.

Styled Components

The styled-components plugin adds comprehensive support for styled-components with server-side rendering, style minification, and enhanced debugging capabilities.

Basic Usage

import { transform } from "oxc-transform";

const result = await transform("Component.jsx", sourceCode, {
  plugins: {
    styledComponents: {
      displayName: true,
      ssr: true,
      fileName: true,
      minify: true,
    },
  },
});

Example

Input:

import styled from "styled-components";

const Button = styled.div`
  color: blue;
  padding: 10px;
`;

Output (with default options):

import styled from "styled-components";

const Button = styled.div.withConfig({
  displayName: "Button",
  componentId: "sc-1234567-0",
})`color:blue;padding:10px;`;

Configuration Options

Core Options

Option	Type	Default	Description
displayName	boolean	true	Enhances the attached CSS class name with component names for easier debugging
ssr	boolean	true	Adds unique component IDs to avoid checksum mismatches during server-side rendering
fileName	boolean	true	Controls whether the displayName is prefixed with the filename

Template Literal Options

Option	Type	Default	Description
transpileTemplateLiterals	boolean	false	Converts tagged template literals to an array representation
minify	boolean	true	Minifies CSS content by removing whitespace and comments

transpileTemplateLiterals is disabled by default because Oxc does not lower template literals to ES5. Without that subsequent lowering, the array representation increases output size. Enable it only when a downstream transform will lower template literals.

Advanced Options

Option	Type	Default	Description
pure	boolean	false	Adds /*#__PURE__*/ comments for better tree-shaking
namespace	string	undefined	Adds a namespace prefix to component IDs
meaninglessFileNames	string[]	["index"]	List of filenames considered meaningless for component naming

Not Yet Implemented

Option	Type	Default	Description
cssProp	boolean	true	JSX css prop transformation (planned)
topLevelImportPaths	string[]	[]	Custom import path handling (planned)

Supported Import Patterns

The plugin works with various styled-components import patterns:

// Default import
import styled from "styled-components";

// Namespace import
import * as styled from "styled-components";

// Named imports
import { createGlobalStyle, css, keyframes } from "styled-components";

// Native and primitives
import styled from "styled-components/native";
import styled from "styled-components/primitives";

Features

✅ Fully Supported:

• Display names for debugging
• Filename prefixing in display names
• Server-side rendering support
• Template literal transpilation
• CSS minification
• Namespace prefixes
• Pure annotations for call expressions

⚠️ Partially Supported:

• Pure annotations (call expressions only, not tagged templates due to bundler limitations)

❌ Not Yet Implemented:

• JSX css prop transformation
• Custom import path handling