Skip to content

Conversation

@Ankitsinghsisodya
Copy link

@Ankitsinghsisodya Ankitsinghsisodya commented Jan 12, 2026

What changed / motivation?

This addresses issue #1061 by documenting the processStylexRules API that is exported from @stylexjs/babel-plugin. This API is essential for people building custom bundler integrations or improving official integrations.

The documentation covers:

  • Function purpose and usage
  • Function signature with TypeScript types
  • Configuration options (useLayers, legacyDisableLayers)
  • Example for custom bundler integrations

Note: Per reviewer feedback, documentation was moved to the babel-plugin README (more appropriate for custom integrations) and legacy Meta-internal options (enableLTRRTLComments, useLegacyClassnamesSort) were excluded.

Linked PR/Issues

Fixes #1061

Additional Context

This is a documentation-only change. No code changes or tests required.

Files modified:

  • packages/@stylexjs/babel-plugin/README.md (added processStylexRules section)
  • packages/docs/content/docs/api/index.mdx (removed link)
  • packages/docs/content/docs/api/configuration/meta.json (removed entry)

Files deleted:

  • packages/docs/content/docs/api/configuration/processStylexRules.mdx

Pre-flight checklist

This addresses issue facebook#1061 by documenting the processStylexRules
API that is exported from @stylexjs/babel-plugin.

The documentation covers:
- Function purpose and usage
- Function signature with TypeScript types
- Configuration options (useLayers, enableLTRRTLComments, etc.)
- Example for custom bundler integrations
Copilot AI review requested due to automatic review settings January 12, 2026 05:11
@vercel
Copy link

vercel bot commented Jan 12, 2026

@Ankitsinghsisodya is attempting to deploy a commit to the Meta Open Source Team on Vercel.

A member of the Team first needs to authorize it.

@meta-cla
Copy link

meta-cla bot commented Jan 12, 2026

Hi @Ankitsinghsisodya!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jan 12, 2026
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive API documentation for the processStylexRules function exported from @stylexjs/babel-plugin, addressing issue #1061. This function is essential for developers building custom bundler integrations.

Changes:

  • New documentation file explaining the processStylexRules API, including function signature, configuration options, and usage examples
  • Updated navigation to include link to the new documentation
  • Updated meta.json to include the new page in the documentation structure

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
packages/docs/content/docs/api/configuration/processStylexRules.mdx Comprehensive documentation for processStylexRules API with examples and configuration options
packages/docs/content/docs/api/index.mdx Added navigation link to processStylexRules documentation
packages/docs/content/docs/api/configuration/meta.json Added processStylexRules.mdx to pages array for documentation structure

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Member

@mellyeliu mellyeliu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should probably live in a section in the babel-plugin README.md instead of within the configs docs, since it’s only relevant for custom integrations.

Addresses review feedback:
- Move documentation to babel-plugin README.md (for custom integrations)
- Remove legacy Meta-internal options (enableLTRRTLComments, useLegacyClassnamesSort)
- Delete standalone processStylexRules.mdx from docs site
- Update navigation files (meta.json, index.mdx)
@Ankitsinghsisodya
Copy link
Author

@mellyeliu sir, I have done all the changes suggested by you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs] Add docs for processStylexRules to API section

2 participants