[ { "path": ".cargo/config.toml", "content": "[target.'cfg(target_env = \"gnu\")']\nrustflags = [\"-C\", \"link-args=-Wl,-z,nodelete\"]\n\n[target.aarch64-unknown-linux-gnu]\nlinker = \"aarch64-linux-gnu-gcc\"\n\n[target.armv7-unknown-linux-gnueabihf]\nlinker = \"arm-linux-gnueabihf-gcc\"\n\n[target.aarch64-unknown-linux-musl]\nlinker = \"aarch64-linux-musl-gcc\"\nrustflags = [\"-C\", \"target-feature=-crt-static\"]\n\n[target.wasm32-unknown-unknown]\nrustflags = [\n \"-C\",\n \"link-arg=--export-table\",\n '--cfg',\n 'getrandom_backend=\"custom\"',\n]\n\n\n# Statically link Visual Studio redistributables on Windows builds\n[target.x86_64-pc-windows-msvc]\nrustflags = [\"-C\", \"target-feature=+crt-static\"]\n[target.aarch64-pc-windows-msvc]\nrustflags = [\"-C\", \"target-feature=+crt-static\"]\n" }, { "path": ".github/workflows/release-crates.yml", "content": "name: release-crates\non:\n workflow_dispatch:\n\njobs:\n release-crates:\n runs-on: ubuntu-latest\n name: Release Rust crate\n steps:\n - uses: actions/checkout@v3\n - uses: bahmutov/npm-install@v1.8.32\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n - run: cargo login ${CRATES_IO_TOKEN}\n env:\n CRATES_IO_TOKEN: ${{ secrets.CRATES_IO_TOKEN }}\n - run: |\n cargo install cargo-workspaces\n cargo workspaces publish --no-remove-dev-deps --from-git -y\n" }, { "path": ".github/workflows/release.yml", "content": "name: release\non:\n workflow_dispatch:\n\njobs:\n build:\n strategy:\n fail-fast: false\n matrix:\n include:\n # Windows\n - os: windows-latest\n target: x86_64-pc-windows-msvc\n binary: lightningcss.exe\n - os: windows-latest\n target: aarch64-pc-windows-msvc\n binary: lightningcss.exe\n # Mac OS\n - os: macos-latest\n target: x86_64-apple-darwin\n strip: strip -x # Must use -x on macOS. This produces larger results on linux.\n binary: lightningcss\n\n name: build-${{ matrix.target }}\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v3\n - name: Install Node.JS\n uses: actions/setup-node@v3\n with:\n node-version: 18\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n\n - name: Setup rust target\n run: rustup target add ${{ matrix.target }}\n\n - uses: bahmutov/npm-install@v1.8.32\n - name: Build release\n run: yarn build-release\n env:\n RUST_TARGET: ${{ matrix.target }}\n - name: Build CLI\n run: |\n cargo build --release --features cli --target ${{ matrix.target }}\n node -e \"require('fs').renameSync('target/${{ matrix.target }}/release/${{ matrix.binary }}', '${{ matrix.binary }}')\"\n - name: Strip debug symbols # https://github.com/rust-lang/rust/issues/46034\n if: ${{ matrix.strip }}\n run: ${{ matrix.strip }} *.node ${{ matrix.binary }}\n - name: Upload artifacts\n uses: actions/upload-artifact@v4\n with:\n name: bindings-${{ matrix.target }}\n path: |\n *.node\n ${{ matrix.binary }}\n\n build-apple-silicon:\n name: build-apple-silicon\n runs-on: macos-latest\n steps:\n - uses: actions/checkout@v3\n - name: Install Node.JS\n uses: actions/setup-node@v3\n with:\n node-version: 18\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n\n - name: Setup rust target\n run: rustup target add aarch64-apple-darwin\n\n - uses: bahmutov/npm-install@v1.8.32\n - name: Build release\n run: yarn build-release\n env:\n RUST_TARGET: aarch64-apple-darwin\n JEMALLOC_SYS_WITH_LG_PAGE: 14\n - name: Build CLI\n run: |\n export CC=$(xcrun -f clang);\n export CXX=$(xcrun -f clang++);\n SYSROOT=$(xcrun --sdk macosx --show-sdk-path);\n export CFLAGS=\"-isysroot $SYSROOT -isystem $SYSROOT\";\n export MACOSX_DEPLOYMENT_TARGET=\"10.9\";\n cargo build --release --features cli --target aarch64-apple-darwin\n mv target/aarch64-apple-darwin/release/lightningcss lightningcss\n env:\n JEMALLOC_SYS_WITH_LG_PAGE: 14\n - name: Strip debug symbols # https://github.com/rust-lang/rust/issues/46034\n run: strip -x *.node lightningcss\n - name: Upload artifacts\n uses: actions/upload-artifact@v4\n with:\n name: bindings-aarch64-apple-darwin\n path: |\n *.node\n lightningcss\n\n build-linux:\n strategy:\n fail-fast: false\n matrix:\n include:\n - target: x86_64-unknown-linux-gnu\n strip: strip\n image: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian\n setup: npm install --global yarn@1\n - target: aarch64-unknown-linux-gnu\n strip: llvm-strip\n image: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian-aarch64\n - target: aarch64-linux-android\n strip: llvm-strip\n image: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian-aarch64\n - target: armv7-unknown-linux-gnueabihf\n strip: llvm-strip\n image: ghcr.io/napi-rs/napi-rs/nodejs-rust@sha256:c22284b2d79092d3e885f64ede00f6afdeb2ccef7e2b6e78be52e7909091cd57\n - target: aarch64-unknown-linux-musl\n image: ghcr.io/napi-rs/napi-rs/nodejs-rust@sha256:78c9ab1f117f8c535b93c4b91a2f19063dda6e4dba48a6187df49810625992c1\n strip: aarch64-linux-musl-strip\n - target: x86_64-unknown-linux-musl\n image: ghcr.io/napi-rs/napi-rs/nodejs-rust@sha256:78c9ab1f117f8c535b93c4b91a2f19063dda6e4dba48a6187df49810625992c1\n strip: strip\n\n name: build-${{ matrix.target }}\n runs-on: ubuntu-latest\n container:\n image: ${{ matrix.image }}\n\n steps:\n - uses: actions/checkout@v3\n - name: Install Node.JS\n uses: actions/setup-node@v3\n with:\n node-version: 18\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n\n - name: Setup Android NDK\n if: ${{ matrix.target == 'aarch64-linux-android' }}\n run: |\n sudo apt update && sudo apt install unzip -y\n cd /tmp\n wget -q https://dl.google.com/android/repository/android-ndk-r28-linux.zip -O /tmp/ndk.zip\n unzip ndk.zip\n\n - name: Setup cross compile toolchain\n if: ${{ matrix.setup }}\n run: ${{ matrix.setup }}\n\n - name: Setup rust target\n run: rustup target add ${{ matrix.target }}\n\n - uses: bahmutov/npm-install@v1.8.32\n - name: Build release\n run: yarn build-release\n env:\n ANDROID_NDK_LATEST_HOME: /tmp/android-ndk-r28\n RUST_TARGET: ${{ matrix.target }}\n - name: Build CLI\n env:\n ANDROID_NDK_LATEST_HOME: /tmp/android-ndk-r28\n run: |\n yarn napi build --bin lightningcss --release --features cli --target ${{ matrix.target }}\n mv target/${{ matrix.target }}/release/lightningcss lightningcss\n - name: Strip debug symbols # https://github.com/rust-lang/rust/issues/46034\n if: ${{ matrix.strip }}\n run: ${{ matrix.strip }} *.node lightningcss\n - name: Upload artifacts\n uses: actions/upload-artifact@v4\n with:\n name: bindings-${{ matrix.target }}\n path: |\n *.node\n lightningcss\n\n build-freebsd:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - name: Build FreeBSD\n uses: cross-platform-actions/action@v0.25.0\n env:\n DEBUG: napi:*\n RUSTUP_HOME: /usr/local/rustup\n CARGO_HOME: /usr/local/cargo\n RUSTUP_IO_THREADS: 1\n with:\n operating_system: freebsd\n version: '14.0'\n memory: 13G\n cpu_count: 3\n environment_variables: 'DEBUG RUSTUP_IO_THREADS'\n shell: bash\n run: |\n sudo pkg install -y -f curl node libnghttp2 npm yarn\n curl https://sh.rustup.rs -sSf --output rustup.sh\n sh rustup.sh -y --profile minimal --default-toolchain beta\n source \"$HOME/.cargo/env\"\n echo \"~~~~ rustc --version ~~~~\"\n rustc --version\n echo \"~~~~ node -v ~~~~\"\n node -v\n echo \"~~~~ yarn --version ~~~~\"\n yarn --version\n yarn install || true\n yarn build-release\n strip -x *.node\n cargo build --release --features cli\n mv target/release/lightningcss lightningcss\n node -e \"require('.')\"\n ./lightningcss --help\n rm -rf node_modules\n rm -rf target\n rm -rf .yarn/cache\n\n - name: Upload artifacts\n uses: actions/upload-artifact@v4\n with:\n name: bindings-x86_64-unknown-freebsd\n path: |\n *.node\n lightningcss\n\n build-wasm:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - name: Install Node.JS\n uses: actions/setup-node@v3\n with:\n node-version: 18\n - uses: bahmutov/npm-install@v1.8.32\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n with:\n targets: wasm32-unknown-unknown\n - name: Setup rust target\n run: rustup target add wasm32-unknown-unknown\n - name: Install wasm-opt\n run: |\n curl -L -O https://github.com/WebAssembly/binaryen/releases/download/version_111/binaryen-version_111-x86_64-linux.tar.gz\n tar -xf binaryen-version_111-x86_64-linux.tar.gz\n - name: Build wasm\n run: |\n export PATH=\"$PATH:./binaryen-version_111/bin\"\n yarn wasm:build-release\n - name: Upload artifacts\n uses: actions/upload-artifact@v4\n with:\n name: wasm\n path: wasm/lightningcss_node.wasm\n\n release:\n runs-on: ubuntu-latest\n name: Build and release\n needs:\n - build\n - build-linux\n - build-apple-silicon\n - build-freebsd\n - build-wasm\n steps:\n - uses: actions/checkout@v3\n - uses: bahmutov/npm-install@v1.8.32\n - name: Download artifacts\n uses: actions/download-artifact@v4\n with:\n path: artifacts\n - name: Show artifacts\n run: ls -R artifacts\n - name: Build npm packages\n run: |\n node scripts/build-npm.js\n cp artifacts/wasm/* wasm/.\n node scripts/build-wasm.js\n - run: echo //registry.npmjs.org/:_authToken=${NPM_TOKEN} > ~/.npmrc\n env:\n NPM_TOKEN: ${{ secrets.NPM_TOKEN }}\n - name: Publish to npm\n run: |\n for pkg in npm/*; do\n echo \"Publishing $pkg...\"\n cd $pkg;\n npm publish;\n cd ../..;\n done\n cd wasm\n echo \"Publishing lightningcss-wasm...\";\n npm publish\n cd ..\n cd cli\n echo \"Publishing lightningcss-cli...\";\n npm publish\n cd ..\n echo \"Publishing lightningcss...\";\n npm publish\n\n release-crates:\n runs-on: ubuntu-latest\n name: Release Rust crate\n steps:\n - uses: actions/checkout@v3\n - uses: bahmutov/npm-install@v1.8.32\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n - run: cargo login ${CRATES_IO_TOKEN}\n env:\n CRATES_IO_TOKEN: ${{ secrets.CRATES_IO_TOKEN }}\n - run: |\n cargo install cargo-workspaces\n cargo workspaces publish --no-remove-dev-deps --from-git -y\n" }, { "path": ".github/workflows/test.yml", "content": "name: test\n\non:\n push:\n branches: [master]\n pull_request:\n branches: [master]\n\njobs:\n test:\n runs-on: ubuntu-latest\n env:\n CARGO_TERM_COLOR: always\n RUST_BACKTRACE: full\n RUSTFLAGS: -D warnings\n steps:\n - uses: actions/checkout@v3\n - uses: dtolnay/rust-toolchain@stable\n - uses: Swatinem/rust-cache@v2\n - run: cargo fmt\n - run: cargo test --all-features\n\n test-js:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - uses: actions/setup-node@v3\n with:\n node-version: 18\n - uses: bahmutov/npm-install@v1.8.32\n - uses: dtolnay/rust-toolchain@stable\n - uses: Swatinem/rust-cache@v2\n - run: yarn build\n - run: yarn test\n - run: yarn tsc\n\n test-wasm:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - uses: actions/setup-node@v3\n with:\n node-version: 18\n - uses: bahmutov/npm-install@v1.8.32\n - uses: dtolnay/rust-toolchain@stable\n with:\n targets: wasm32-unknown-unknown\n - name: Setup rust target\n run: rustup target add wasm32-unknown-unknown\n - uses: Swatinem/rust-cache@v2\n - name: Install wasm-opt\n run: |\n curl -L -O https://github.com/WebAssembly/binaryen/releases/download/version_111/binaryen-version_111-x86_64-linux.tar.gz\n tar -xf binaryen-version_111-x86_64-linux.tar.gz\n - name: Build wasm\n run: |\n export PATH=\"$PATH:./binaryen-version_111/bin\"\n yarn wasm:build-release\n - run: TEST_WASM=node yarn test\n - run: TEST_WASM=browser yarn test\n" }, { "path": ".gitignore", "content": ".DS_Store\n*.node\nnode_modules/\ntarget/\npkg/\ndist/\n.parcel-cache\nnode/*.flow\nartifacts\nnpm\nnode/ast.json\n" }, { "path": ".prettierrc", "content": "{\n \"bracketSpacing\": false,\n \"endOfLine\": \"lf\",\n \"singleQuote\": true,\n \"trailingComma\": \"all\"\n}\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing\n\nWelcome, we really appreciate if you're considering to contribute, the joint effort of our contributors make projects like this possible!\n\nThe goal of this document is to provide guidance on how you can get involved.\n\n## Getting started with bug fixing\n\nIn order to make it easier to get familiar with the codebase we labeled simpler issues using [Good First Issue](https://github.com/parcel-bundler/lightningcss/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) and [Help Wanted](https://github.com/parcel-bundler/lightningcss/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22+label%3A%22help+wanted%22).\n\nBefore starting make sure you have the following requirements installed: [git](https://git-scm.com), [Node](https://nodejs.org), [Yarn](https://yarnpkg.com) and [Rust](https://www.rust-lang.org/tools/install).\n\nThe process starts by [forking](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo) the project and setup a new branch to work in. It's important that the changes are made in separated branches in order to ensure a pull request only includes the commits related to a bug or feature.\n\nClone the forked repository locally and install the dependencies:\n\n```sh\ngit clone https://github.com/USERNAME/lightningcss.git\ncd lightningcss\nyarn install\n```\n\n## Testing\n\nIn order to test, you first need to build the core package:\n\n```sh\nyarn build\n```\n\nThen you can run the tests:\n\n```sh\nyarn test # js tests\ncargo test # rust tests\n```\n\n## Building\n\nThere are different build targets available, with \"release\" being a production build:\n\n```sh\nyarn build\nyarn build-release\n\nyarn wasm:build\nyarn wasm:build-release\n```\n\nNote: If you plan to build the WASM target, ensure that you have the required toolchain and binaries installed.\n\n```sh\nrustup target add wasm32-unknown-unknown\ncargo install wasm-opt\n```\n\n## Website\n\nThe website is built using [Parcel](https://parceljs.org). You can start the development server by running:\n\n```sh\nyarn website:start\n```\n" }, { "path": "Cargo.toml", "content": "[workspace]\nmembers = [\n \"node\",\n \"napi\",\n \"selectors\",\n \"c\",\n \"derive\",\n \"static-self\",\n \"static-self-derive\",\n]\n\n[package]\nauthors = [\"Devon Govett \"]\nname = \"lightningcss\"\nversion = \"1.0.0-alpha.71\"\ndescription = \"A CSS parser, transformer, and minifier\"\nlicense = \"MPL-2.0\"\nedition = \"2021\"\nkeywords = [\"CSS\", \"minifier\", \"Parcel\"]\nrepository = \"https://github.com/parcel-bundler/lightningcss\"\n\n[package.metadata.docs.rs]\nall-features = true\nrustdoc-args = [\"--cfg\", \"docsrs\"]\n\n[[bin]]\nname = \"lightningcss\"\npath = \"src/main.rs\"\nrequired-features = [\"cli\"]\n\n[lib]\nname = \"lightningcss\"\npath = \"src/lib.rs\"\ncrate-type = [\"rlib\"]\n\n[features]\ndefault = [\"bundler\", \"nodejs\", \"sourcemap\"]\nbrowserslist = [\"browserslist-rs\"]\nbundler = [\"dashmap\", \"sourcemap\", \"rayon\"]\ncli = [\"atty\", \"clap\", \"serde_json\", \"browserslist\", \"jemallocator\"]\njsonschema = [\"schemars\", \"serde\", \"parcel_selectors/jsonschema\"]\nnodejs = [\"dep:serde\", \"dep:serde-content\"]\nserde = [\n \"dep:serde\",\n \"dep:serde-content\",\n \"bitflags/serde\",\n \"smallvec/serde\",\n \"cssparser/serde\",\n \"parcel_selectors/serde\",\n \"into_owned\",\n]\nsourcemap = [\"parcel_sourcemap\"]\nvisitor = []\ninto_owned = [\n \"static-self\",\n \"static-self/smallvec\",\n \"static-self/indexmap\",\n \"parcel_selectors/into_owned\",\n]\nsubstitute_variables = [\"visitor\", \"into_owned\"]\n\n[dependencies]\nserde = { version = \"1.0.228\", features = [\"derive\"], optional = true }\nserde-content = { version = \"0.1.2\", features = [\"serde\"], optional = true }\ncssparser = \"0.33.0\"\ncssparser-color = \"0.1.0\"\nparcel_selectors = { version = \"0.28.2\", path = \"./selectors\" }\nitertools = \"0.10.1\"\nsmallvec = { version = \"1.7.0\", features = [\"union\"] }\nbitflags = \"2.2.1\"\nparcel_sourcemap = { version = \"2.1.1\", features = [\"json\"], optional = true }\ndata-encoding = \"2.3.2\"\nlazy_static = \"1.4.0\"\nconst-str = \"0.3.1\"\npathdiff = \"0.2.1\"\nahash = \"0.8.7\"\npastey = \"0.1.0\"\nindexmap = { version = \"2.2.6\", features = [\"serde\"] }\n# CLI deps\natty = { version = \"0.2\", optional = true }\nclap = { version = \"3.0.6\", features = [\"derive\"], optional = true }\nbrowserslist-rs = { version = \"0.19.0\", optional = true }\nrayon = { version = \"1.5.1\", optional = true }\ndashmap = { version = \"5.0.0\", optional = true }\nserde_json = { version = \"1.0.78\", optional = true }\nlightningcss-derive = { version = \"=1.0.0-alpha.43\", path = \"./derive\" }\nschemars = { version = \"0.8.19\", features = [\"smallvec\", \"indexmap2\"], optional = true }\nstatic-self = { version = \"0.1.2\", path = \"static-self\", optional = true }\n\n[target.'cfg(target_os = \"macos\")'.dependencies]\njemallocator = { version = \"0.3.2\", features = [\n \"disable_initial_exec_tls\",\n], optional = true }\n\n[target.'cfg(target_arch = \"wasm32\")'.dependencies]\ngetrandom = { version = \"0.3\", default-features = false }\n\n[dev-dependencies]\nindoc = \"1.0.3\"\nassert_cmd = \"2.0\"\nassert_fs = \"1.0\"\npredicates = \"2.1\"\nserde_json = \"1\"\npretty_assertions = \"1.4.0\"\n\n[[test]]\nname = \"cli_integration_tests\"\npath = \"tests/cli_integration_tests.rs\"\nrequired-features = [\"cli\"]\n\n[[example]]\nname = \"custom_at_rule\"\nrequired-features = [\"visitor\"]\n\n[[example]]\nname = \"serialize\"\nrequired-features = [\"serde\"]\n\n[profile.release]\nlto = true\ncodegen-units = 1\npanic = 'abort'\n" }, { "path": "LICENSE", "content": " Mozilla Public License Version 2.0\n==================================\n\n1. Definitions\n--------------\n\n1.1. \"Contributor\"\nmeans each individual or legal entity that creates, contributes to\nthe creation of, or owns Covered Software.\n\n1.2. \"Contributor Version\"\nmeans the combination of the Contributions of others (if any) used\nby a Contributor and that particular Contributor's Contribution.\n\n1.3. \"Contribution\"\nmeans Covered Software of a particular Contributor.\n\n1.4. \"Covered Software\"\nmeans Source Code Form to which the initial Contributor has attached\nthe notice in Exhibit A, the Executable Form of such Source Code\nForm, and Modifications of such Source Code Form, in each case\nincluding portions thereof.\n\n1.5. \"Incompatible With Secondary Licenses\"\nmeans\n\n(a) that the initial Contributor has attached the notice described\nin Exhibit B to the Covered Software; or\n\n(b) that the Covered Software was made available under the terms of\nversion 1.1 or earlier of the License, but not also under the\nterms of a Secondary License.\n\n1.6. \"Executable Form\"\nmeans any form of the work other than Source Code Form.\n\n1.7. \"Larger Work\"\nmeans a work that combines Covered Software with other material, in\na separate file or files, that is not Covered Software.\n\n1.8. \"License\"\nmeans this document.\n\n1.9. \"Licensable\"\nmeans having the right to grant, to the maximum extent possible,\nwhether at the time of the initial grant or subsequently, any and\nall of the rights conveyed by this License.\n\n1.10. \"Modifications\"\nmeans any of the following:\n\n(a) any file in Source Code Form that results from an addition to,\ndeletion from, or modification of the contents of Covered\nSoftware; or\n\n(b) any new file in Source Code Form that contains any Covered\nSoftware.\n\n1.11. \"Patent Claims\" of a Contributor\nmeans any patent claim(s), including without limitation, method,\nprocess, and apparatus claims, in any patent Licensable by such\nContributor that would be infringed, but for the grant of the\nLicense, by the making, using, selling, offering for sale, having\nmade, import, or transfer of either its Contributions or its\nContributor Version.\n\n1.12. \"Secondary License\"\nmeans either the GNU General Public License, Version 2.0, the GNU\nLesser General Public License, Version 2.1, the GNU Affero General\nPublic License, Version 3.0, or any later versions of those\nlicenses.\n\n1.13. \"Source Code Form\"\nmeans the form of the work preferred for making modifications.\n\n1.14. \"You\" (or \"Your\")\nmeans an individual or a legal entity exercising rights under this\nLicense. For legal entities, \"You\" includes any entity that\ncontrols, is controlled by, or is under common control with You. For\npurposes of this definition, \"control\" means (a) the power, direct\nor indirect, to cause the direction or management of such entity,\nwhether by contract or otherwise, or (b) ownership of more than\nfifty percent (50%) of the outstanding shares or beneficial\nownership of such entity.\n\n2. License Grants and Conditions\n--------------------------------\n\n2.1. Grants\n\nEach Contributor hereby grants You a world-wide, royalty-free,\nnon-exclusive license:\n\n(a) under intellectual property rights (other than patent or trademark)\nLicensable by such Contributor to use, reproduce, make available,\nmodify, display, perform, distribute, and otherwise exploit its\nContributions, either on an unmodified basis, with Modifications, or\nas part of a Larger Work; and\n\n(b) under Patent Claims of such Contributor to make, use, sell, offer\nfor sale, have made, import, and otherwise transfer either its\nContributions or its Contributor Version.\n\n2.2. Effective Date\n\nThe licenses granted in Section 2.1 with respect to any Contribution\nbecome effective for each Contribution on the date the Contributor first\ndistributes such Contribution.\n\n2.3. Limitations on Grant Scope\n\nThe licenses granted in this Section 2 are the only rights granted under\nthis License. No additional rights or licenses will be implied from the\ndistribution or licensing of Covered Software under this License.\nNotwithstanding Section 2.1(b) above, no patent license is granted by a\nContributor:\n\n(a) for any code that a Contributor has removed from Covered Software;\nor\n\n(b) for infringements caused by: (i) Your and any other third party's\nmodifications of Covered Software, or (ii) the combination of its\nContributions with other software (except as part of its Contributor\nVersion); or\n\n(c) under Patent Claims infringed by Covered Software in the absence of\nits Contributions.\n\nThis License does not grant any rights in the trademarks, service marks,\nor logos of any Contributor (except as may be necessary to comply with\nthe notice requirements in Section 3.4).\n\n2.4. Subsequent Licenses\n\nNo Contributor makes additional grants as a result of Your choice to\ndistribute the Covered Software under a subsequent version of this\nLicense (see Section 10.2) or under the terms of a Secondary License (if\npermitted under the terms of Section 3.3).\n\n2.5. Representation\n\nEach Contributor represents that the Contributor believes its\nContributions are its original creation(s) or it has sufficient rights\nto grant the rights to its Contributions conveyed by this License.\n\n2.6. Fair Use\n\nThis License is not intended to limit any rights You have under\napplicable copyright doctrines of fair use, fair dealing, or other\nequivalents.\n\n2.7. Conditions\n\nSections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted\nin Section 2.1.\n\n3. Responsibilities\n-------------------\n\n3.1. Distribution of Source Form\n\nAll distribution of Covered Software in Source Code Form, including any\nModifications that You create or to which You contribute, must be under\nthe terms of this License. You must inform recipients that the Source\nCode Form of the Covered Software is governed by the terms of this\nLicense, and how they can obtain a copy of this License. You may not\nattempt to alter or restrict the recipients' rights in the Source Code\nForm.\n\n3.2. Distribution of Executable Form\n\nIf You distribute Covered Software in Executable Form then:\n\n(a) such Covered Software must also be made available in Source Code\nForm, as described in Section 3.1, and You must inform recipients of\nthe Executable Form how they can obtain a copy of such Source Code\nForm by reasonable means in a timely manner, at a charge no more\nthan the cost of distribution to the recipient; and\n\n(b) You may distribute such Executable Form under the terms of this\nLicense, or sublicense it under different terms, provided that the\nlicense for the Executable Form does not attempt to limit or alter\nthe recipients' rights in the Source Code Form under this License.\n\n3.3. Distribution of a Larger Work\n\nYou may create and distribute a Larger Work under terms of Your choice,\nprovided that You also comply with the requirements of this License for\nthe Covered Software. If the Larger Work is a combination of Covered\nSoftware with a work governed by one or more Secondary Licenses, and the\nCovered Software is not Incompatible With Secondary Licenses, this\nLicense permits You to additionally distribute such Covered Software\nunder the terms of such Secondary License(s), so that the recipient of\nthe Larger Work may, at their option, further distribute the Covered\nSoftware under the terms of either this License or such Secondary\nLicense(s).\n\n3.4. Notices\n\nYou may not remove or alter the substance of any license notices\n(including copyright notices, patent notices, disclaimers of warranty,\nor limitations of liability) contained within the Source Code Form of\nthe Covered Software, except that You may alter any license notices to\nthe extent required to remedy known factual inaccuracies.\n\n3.5. Application of Additional Terms\n\nYou may choose to offer, and to charge a fee for, warranty, support,\nindemnity or liability obligations to one or more recipients of Covered\nSoftware. However, You may do so only on Your own behalf, and not on\nbehalf of any Contributor. You must make it absolutely clear that any\nsuch warranty, support, indemnity, or liability obligation is offered by\nYou alone, and You hereby agree to indemnify every Contributor for any\nliability incurred by such Contributor as a result of warranty, support,\nindemnity or liability terms You offer. You may include additional\ndisclaimers of warranty and limitations of liability specific to any\njurisdiction.\n\n4. Inability to Comply Due to Statute or Regulation\n---------------------------------------------------\n\nIf it is impossible for You to comply with any of the terms of this\nLicense with respect to some or all of the Covered Software due to\nstatute, judicial order, or regulation then You must: (a) comply with\nthe terms of this License to the maximum extent possible; and (b)\ndescribe the limitations and the code they affect. Such description must\nbe placed in a text file included with all distributions of the Covered\nSoftware under this License. Except to the extent prohibited by statute\nor regulation, such description must be sufficiently detailed for a\nrecipient of ordinary skill to be able to understand it.\n\n5. Termination\n--------------\n\n5.1. The rights granted under this License will terminate automatically\nif You fail to comply with any of its terms. However, if You become\ncompliant, then the rights granted under this License from a particular\nContributor are reinstated (a) provisionally, unless and until such\nContributor explicitly and finally terminates Your grants, and (b) on an\nongoing basis, if such Contributor fails to notify You of the\nnon-compliance by some reasonable means prior to 60 days after You have\ncome back into compliance. Moreover, Your grants from a particular\nContributor are reinstated on an ongoing basis if such Contributor\nnotifies You of the non-compliance by some reasonable means, this is the\nfirst time You have received notice of non-compliance with this License\nfrom such Contributor, and You become compliant prior to 30 days after\nYour receipt of the notice.\n\n5.2. If You initiate litigation against any entity by asserting a patent\ninfringement claim (excluding declaratory judgment actions,\ncounter-claims, and cross-claims) alleging that a Contributor Version\ndirectly or indirectly infringes any patent, then the rights granted to\nYou by any and all Contributors for the Covered Software under Section\n2.1 of this License shall terminate.\n\n5.3. In the event of termination under Sections 5.1 or 5.2 above, all\nend user license agreements (excluding distributors and resellers) which\nhave been validly granted by You or Your distributors under this License\nprior to termination shall survive termination.\n\n************************************************************************\n* *\n* 6. Disclaimer of Warranty *\n* ------------------------- *\n* *\n* Covered Software is provided under this License on an \"as is\" *\n* basis, without warranty of any kind, either expressed, implied, or *\n* statutory, including, without limitation, warranties that the *\n* Covered Software is free of defects, merchantable, fit for a *\n* particular purpose or non-infringing. The entire risk as to the *\n* quality and performance of the Covered Software is with You. *\n* Should any Covered Software prove defective in any respect, You *\n* (not any Contributor) assume the cost of any necessary servicing, *\n* repair, or correction. This disclaimer of warranty constitutes an *\n* essential part of this License. No use of any Covered Software is *\n* authorized under this License except under this disclaimer. *\n* *\n************************************************************************\n\n************************************************************************\n* *\n* 7. Limitation of Liability *\n* -------------------------- *\n* *\n* Under no circumstances and under no legal theory, whether tort *\n* (including negligence), contract, or otherwise, shall any *\n* Contributor, or anyone who distributes Covered Software as *\n* permitted above, be liable to You for any direct, indirect, *\n* special, incidental, or consequential damages of any character *\n* including, without limitation, damages for lost profits, loss of *\n* goodwill, work stoppage, computer failure or malfunction, or any *\n* and all other commercial damages or losses, even if such party *\n* shall have been informed of the possibility of such damages. This *\n* limitation of liability shall not apply to liability for death or *\n* personal injury resulting from such party's negligence to the *\n* extent applicable law prohibits such limitation. Some *\n* jurisdictions do not allow the exclusion or limitation of *\n* incidental or consequential damages, so this exclusion and *\n* limitation may not apply to You. *\n* *\n************************************************************************\n\n8. Litigation\n-------------\n\nAny litigation relating to this License may be brought only in the\ncourts of a jurisdiction where the defendant maintains its principal\nplace of business and such litigation shall be governed by laws of that\njurisdiction, without reference to its conflict-of-law provisions.\nNothing in this Section shall prevent a party's ability to bring\ncross-claims or counter-claims.\n\n9. Miscellaneous\n----------------\n\nThis License represents the complete agreement concerning the subject\nmatter hereof. If any provision of this License is held to be\nunenforceable, such provision shall be reformed only to the extent\nnecessary to make it enforceable. Any law or regulation which provides\nthat the language of a contract shall be construed against the drafter\nshall not be used to construe this License against a Contributor.\n\n10. Versions of the License\n---------------------------\n\n10.1. New Versions\n\nMozilla Foundation is the license steward. Except as provided in Section\n10.3, no one other than the license steward has the right to modify or\npublish new versions of this License. Each version will be given a\ndistinguishing version number.\n\n10.2. Effect of New Versions\n\nYou may distribute the Covered Software under the terms of the version\nof the License under which You originally received the Covered Software,\nor under the terms of any subsequent version published by the license\nsteward.\n\n10.3. Modified Versions\n\nIf you create software not governed by this License, and you want to\ncreate a new license for such software, you may create and use a\nmodified version of this License if you rename the license and remove\nany references to the name of the license steward (except to note that\nsuch modified license differs from this License).\n\n10.4. Distributing Source Code Form that is Incompatible With Secondary\nLicenses\n\nIf You choose to distribute Source Code Form that is Incompatible With\nSecondary Licenses under the terms of this version of the License, the\nnotice described in Exhibit B of this License must be attached.\n\nExhibit A - Source Code Form License Notice\n-------------------------------------------\n\nThis Source Code Form is subject to the terms of the Mozilla Public\nLicense, v. 2.0. If a copy of the MPL was not distributed with this\nfile, You can obtain one at https://mozilla.org/MPL/2.0/.\n\nIf it is not possible or desirable to put the notice in a particular\nfile, then You may include the notice in a location (such as a LICENSE\nfile in a relevant directory) where a recipient would be likely to look\nfor such a notice.\n\nYou may add additional accurate notices of copyright ownership.\n\nExhibit B - \"Incompatible With Secondary Licenses\" Notice\n---------------------------------------------------------\n\nThis Source Code Form is \"Incompatible With Secondary Licenses\", as\ndefined by the Mozilla Public License, v. 2.0.\n" }, { "path": "README.md", "content": "# ⚡️ Lightning CSS\n\nAn extremely fast CSS parser, transformer, and minifier written in Rust. Use it with [Parcel](https://parceljs.org), as a standalone library or CLI, or via a plugin with any other tool.\n\n\"performance\n\"performance\n\n## Features\n\n- **Extremely fast** – Parsing and minifying large files is completed in milliseconds, often with significantly smaller output than other tools. See [benchmarks](#benchmarks) below.\n- **Typed property values** – many other CSS parsers treat property values as an untyped series of tokens. This means that each transformer that wants to do something with these values must interpret them itself, leading to duplicate work and inconsistencies. Lightning CSS parses all values using the grammar from the CSS specification, and exposes a specific value type for each property.\n- **Browser-grade parser** – Lightning CSS is built on the [cssparser](https://github.com/servo/rust-cssparser) and [selectors](https://github.com/servo/stylo/tree/main/selectors) crates created by Mozilla and used by Firefox and Servo. These provide a solid general purpose CSS-parsing foundation on top of which Lightning CSS implements support for all specific CSS rules and properties.\n- **Minification** – One of the main purposes of Lightning CSS is to minify CSS to make it smaller. This includes many optimizations including:\n - Combining longhand properties into shorthands where possible.\n - Merging adjacent rules with the same selectors or declarations when it is safe to do so.\n - Combining CSS transforms into a single matrix or vice versa when smaller.\n - Removing vendor prefixes that are not needed, based on the provided browser targets.\n - Reducing `calc()` expressions where possible.\n - Converting colors to shorter hex notation where possible.\n - Minifying gradients.\n - Minifying CSS grid templates.\n - Normalizing property value order.\n - Removing default property sub-values which will be inferred by browsers.\n - Many micro-optimizations, e.g. converting to shorter units, removing unnecessary quotation marks, etc.\n- **Vendor prefixing** – Lightning CSS accepts a list of browser targets, and automatically adds (and removes) vendor prefixes.\n- **Browserslist configuration** – Lightning CSS supports opt-in browserslist configuration discovery to resolve browser targets and integrate with your existing tools and config setup.\n- **Syntax lowering** – Lightning CSS parses modern CSS syntax, and generates more compatible output where needed, based on browser targets.\n - CSS Nesting\n - Custom media queries (draft spec)\n - Logical properties\n * [Color Level 5](https://drafts.csswg.org/css-color-5/)\n - `color-mix()` function\n - Relative color syntax, e.g. `lab(from purple calc(l * .8) a b)`\n - [Color Level 4](https://drafts.csswg.org/css-color-4/)\n - `lab()`, `lch()`, `oklab()`, and `oklch()` colors\n - `color()` function supporting predefined color spaces such as `display-p3` and `xyz`\n - Space separated components in `rgb` and `hsl` functions\n - Hex with alpha syntax\n - `hwb()` color syntax\n - Percent syntax for opacity\n - `#rgba` and `#rrggbbaa` hex colors\n - Selectors\n - `:not` with multiple arguments\n - `:lang` with multiple arguments\n - `:dir`\n - `:is`\n - Double position gradient stops (e.g. `red 40% 80%`)\n - `clamp()`, `round()`, `rem()`, and `mod()` math functions\n - Alignment shorthands (e.g. `place-items`)\n - Two-value `overflow` shorthand\n - Media query range syntax (e.g. `@media (width <= 100px)` or `@media (100px < width < 500px)`)\n - Multi-value `display` property (e.g. `inline flex`)\n - `system-ui` font family fallbacks\n- **CSS modules** – Lightning CSS supports compiling a subset of [CSS modules](https://github.com/css-modules/css-modules) features.\n - Locally scoped class and id selectors\n - Locally scoped custom identifiers, e.g. `@keyframes` names, grid lines/areas, `@counter-style` names, etc.\n - Opt-in support for locally scoped CSS variables and other dashed identifiers.\n - `:local()` and `:global()` selectors\n - The `composes` property\n- **Custom transforms** – The Lightning CSS visitor API can be used to implement custom transform plugins.\n\n## Documentation\n\nLightning CSS can be used from [Parcel](https://parceljs.org), as a standalone library from JavaScript or Rust, using a standalone CLI, or wrapped as a plugin within any other tool. See the [Lightning CSS website](https://lightningcss.dev/docs.html) for documentation.\n\n## Benchmarks\n\n\"performance\n\"performance\n\n```\n$ node bench.js bootstrap-4.css\ncssnano: 544.809ms\n159636 bytes\n\nesbuild: 17.199ms\n160332 bytes\n\nlightningcss: 4.16ms\n143091 bytes\n\n\n$ node bench.js animate.css\ncssnano: 283.105ms\n71723 bytes\n\nesbuild: 11.858ms\n72183 bytes\n\nlightningcss: 1.973ms\n23666 bytes\n\n\n$ node bench.js tailwind.css\ncssnano: 2.198s\n1925626 bytes\n\nesbuild: 107.668ms\n1961642 bytes\n\nlightningcss: 43.368ms\n1824130 bytes\n```\n\nFor more benchmarks comparing more tools and input, see [here](http://goalsmashers.github.io/css-minification-benchmark/). Note that some of the tools shown perform unsafe optimizations that may change the behavior of the original CSS in favor of smaller file size. Lightning CSS does not do this – the output CSS should always behave identically to the input. Keep this in mind when comparing file sizes between tools.\n" }, { "path": "bench.js", "content": "const css = require('./');\nconst cssnano = require('cssnano');\nconst postcss = require('postcss');\nconst esbuild = require('esbuild');\n\nlet opts = {\n filename: process.argv[process.argv.length - 1],\n code: require('fs').readFileSync(process.argv[process.argv.length - 1]),\n minify: true,\n // source_map: true,\n targets: {\n chrome: 95 << 16\n }\n};\n\nasync function run() {\n await doCssNano();\n\n console.time('esbuild');\n let r = await esbuild.transform(opts.code.toString(), {\n sourcefile: opts.filename,\n loader: 'css',\n minify: true\n });\n console.timeEnd('esbuild');\n console.log(r.code.length + ' bytes');\n console.log('');\n\n console.time('lightningcss');\n let res = css.transform(opts);\n console.timeEnd('lightningcss');\n console.log(res.code.length + ' bytes');\n}\n\nasync function doCssNano() {\n console.time('cssnano');\n const result = await postcss([\n cssnano,\n ]).process(opts.code, {from: opts.filename});\n console.timeEnd('cssnano');\n console.log(result.css.length + ' bytes');\n console.log('');\n}\n\nrun();\n" }, { "path": "c/Cargo.toml", "content": "[package]\nauthors = [\"Devon Govett \"]\nname = \"lightningcss_c_bindings\"\nversion = \"0.1.0\"\nedition = \"2021\"\npublish = false\n\n[lib]\ncrate-type = [\"cdylib\"]\n\n[dependencies]\nlightningcss = { path = \"../\", features = [\"browserslist\"] }\nparcel_sourcemap = { version = \"2.1.1\", features = [\"json\"] }\nbrowserslist-rs = { version = \"0.19.0\" }\n\n[build-dependencies]\ncbindgen = \"0.24.3\"\n" }, { "path": "c/build.rs", "content": "use std::env;\n\nfn main() {\n let crate_dir = env::var(\"CARGO_MANIFEST_DIR\").unwrap();\n\n cbindgen::generate(crate_dir)\n .expect(\"Unable to generate bindings\")\n .write_to_file(\"lightningcss.h\");\n}\n" }, { "path": "c/cbindgen.toml", "content": "language = \"C\"\n\n[parse]\nparse_deps = false\ninclude = [\"lightningcss\"]\n\n[export.rename]\nStyleSheetWrapper = \"StyleSheet\"\n\n[enum]\nprefix_with_name = true\n" }, { "path": "c/lightningcss.h", "content": "#include \n#include \n#include \n#include \n\ntypedef struct CssError CssError;\n\ntypedef struct StyleSheet StyleSheet;\n\ntypedef struct Targets {\n uint32_t android;\n uint32_t chrome;\n uint32_t edge;\n uint32_t firefox;\n uint32_t ie;\n uint32_t ios_saf;\n uint32_t opera;\n uint32_t safari;\n uint32_t samsung;\n} Targets;\n\ntypedef struct ParseOptions {\n const char *filename;\n bool nesting;\n bool custom_media;\n bool css_modules;\n const char *css_modules_pattern;\n bool css_modules_dashed_idents;\n bool error_recovery;\n} ParseOptions;\n\ntypedef struct TransformOptions {\n struct Targets targets;\n char **unused_symbols;\n uintptr_t unused_symbols_len;\n} TransformOptions;\n\ntypedef struct RawString {\n char *text;\n uintptr_t len;\n} RawString;\n\ntypedef enum CssModuleReference_Tag {\n /**\n * A local reference.\n */\n CssModuleReference_Local,\n /**\n * A global reference.\n */\n CssModuleReference_Global,\n /**\n * A reference to an export in a different file.\n */\n CssModuleReference_Dependency,\n} CssModuleReference_Tag;\n\ntypedef struct CssModuleReference_Local_Body {\n /**\n * The local (compiled) name for the reference.\n */\n struct RawString name;\n} CssModuleReference_Local_Body;\n\ntypedef struct CssModuleReference_Global_Body {\n /**\n * The referenced global name.\n */\n struct RawString name;\n} CssModuleReference_Global_Body;\n\ntypedef struct CssModuleReference_Dependency_Body {\n /**\n * The name to reference within the dependency.\n */\n struct RawString name;\n /**\n * The dependency specifier for the referenced file.\n */\n struct RawString specifier;\n} CssModuleReference_Dependency_Body;\n\ntypedef struct CssModuleReference {\n CssModuleReference_Tag tag;\n union {\n CssModuleReference_Local_Body local;\n CssModuleReference_Global_Body global;\n CssModuleReference_Dependency_Body dependency;\n };\n} CssModuleReference;\n\ntypedef struct CssModuleExport {\n struct RawString exported;\n struct RawString local;\n bool is_referenced;\n struct CssModuleReference *composes;\n uintptr_t composes_len;\n} CssModuleExport;\n\ntypedef struct CssModulePlaceholder {\n struct RawString placeholder;\n struct CssModuleReference reference;\n} CssModulePlaceholder;\n\ntypedef struct ToCssResult {\n struct RawString code;\n struct RawString map;\n struct CssModuleExport *exports;\n uintptr_t exports_len;\n struct CssModulePlaceholder *references;\n uintptr_t references_len;\n} ToCssResult;\n\ntypedef struct PseudoClasses {\n const char *hover;\n const char *active;\n const char *focus;\n const char *focus_visible;\n const char *focus_within;\n} PseudoClasses;\n\ntypedef struct ToCssOptions {\n bool minify;\n bool source_map;\n const char *input_source_map;\n uintptr_t input_source_map_len;\n const char *project_root;\n struct Targets targets;\n bool analyze_dependencies;\n struct PseudoClasses pseudo_classes;\n} ToCssOptions;\n\nbool lightningcss_browserslist_to_targets(const char *query,\n struct Targets *targets,\n struct CssError **error);\n\nstruct StyleSheet *lightningcss_stylesheet_parse(const char *source,\n uintptr_t len,\n struct ParseOptions options,\n struct CssError **error);\n\nbool lightningcss_stylesheet_transform(struct StyleSheet *stylesheet,\n struct TransformOptions options,\n struct CssError **error);\n\nstruct ToCssResult lightningcss_stylesheet_to_css(struct StyleSheet *stylesheet,\n struct ToCssOptions options,\n struct CssError **error);\n\nvoid lightningcss_stylesheet_free(struct StyleSheet *stylesheet);\n\nvoid lightningcss_to_css_result_free(struct ToCssResult result);\n\nconst char *lightningcss_error_message(struct CssError *error);\n\nvoid lightningcss_error_free(struct CssError *error);\n\nuintptr_t lightningcss_stylesheet_get_warning_count(struct StyleSheet *stylesheet);\n\nconst char *lightningcss_stylesheet_get_warning(struct StyleSheet *stylesheet, uintptr_t index);\n" }, { "path": "c/src/lib.rs", "content": "#![allow(clippy::not_unsafe_ptr_arg_deref)]\n\nuse std::collections::HashSet;\nuse std::ffi::{CStr, CString};\nuse std::mem::ManuallyDrop;\nuse std::os::raw::c_char;\nuse std::sync::{Arc, RwLock};\n\nuse lightningcss::css_modules::PatternParseError;\nuse lightningcss::error::{Error, MinifyErrorKind, ParserError, PrinterError};\nuse lightningcss::stylesheet::{MinifyOptions, ParserFlags, ParserOptions, PrinterOptions, StyleSheet};\nuse lightningcss::targets::Browsers;\nuse parcel_sourcemap::SourceMap;\n\npub struct StyleSheetWrapper<'i, 'o> {\n stylesheet: StyleSheet<'i, 'o>,\n source: &'i str,\n warnings: Vec>,\n}\n\npub struct CssError<'i> {\n kind: ErrorKind<'i>,\n message: Option,\n}\n\nimpl<'i> CssError<'i> {\n fn message(&mut self) -> *const c_char {\n if let Some(message) = &self.message {\n return message.as_ptr();\n }\n\n let string: String = match &self.kind {\n ErrorKind::ParserError(err) => err.to_string().into(),\n ErrorKind::MinifyError(err) => err.to_string().into(),\n ErrorKind::PrinterError(err) => err.to_string().into(),\n ErrorKind::PatternParseError(err) => err.to_string().into(),\n ErrorKind::BrowserslistError(err) => err.to_string().into(),\n ErrorKind::SourceMapError(err) => err.to_string().into(),\n };\n\n self.message = Some(CString::new(string).unwrap());\n self.message.as_ref().unwrap().as_ptr()\n }\n}\n\npub enum ErrorKind<'i> {\n ParserError(Error>),\n MinifyError(Error),\n PrinterError(PrinterError),\n PatternParseError(PatternParseError),\n BrowserslistError(browserslist::Error),\n SourceMapError(parcel_sourcemap::SourceMapError),\n}\n\nmacro_rules! impl_from {\n ($name: ident, $t: ty) => {\n impl<'i> From<$t> for CssError<'i> {\n fn from(err: $t) -> Self {\n CssError {\n kind: ErrorKind::$name(err),\n message: None,\n }\n }\n }\n };\n}\n\nimpl_from!(ParserError, Error>);\nimpl_from!(MinifyError, Error);\nimpl_from!(PrinterError, PrinterError);\nimpl_from!(PatternParseError, PatternParseError);\nimpl_from!(BrowserslistError, browserslist::Error);\nimpl_from!(SourceMapError, parcel_sourcemap::SourceMapError);\n\n#[repr(C)]\npub struct ParseOptions {\n filename: *const c_char,\n nesting: bool,\n custom_media: bool,\n css_modules: bool,\n css_modules_pattern: *const c_char,\n css_modules_dashed_idents: bool,\n error_recovery: bool,\n}\n\n#[repr(C)]\n#[derive(Default, PartialEq)]\npub struct Targets {\n android: u32,\n chrome: u32,\n edge: u32,\n firefox: u32,\n ie: u32,\n ios_saf: u32,\n opera: u32,\n safari: u32,\n samsung: u32,\n}\n\nimpl Into for Targets {\n fn into(self) -> Browsers {\n macro_rules! browser {\n ($val: expr) => {\n if $val > 0 {\n Some($val)\n } else {\n None\n }\n };\n }\n\n Browsers {\n android: browser!(self.android),\n chrome: browser!(self.chrome),\n edge: browser!(self.edge),\n firefox: browser!(self.firefox),\n ie: browser!(self.ie),\n ios_saf: browser!(self.ios_saf),\n opera: browser!(self.opera),\n safari: browser!(self.safari),\n samsung: browser!(self.samsung),\n }\n }\n}\n\nmacro_rules! unwrap {\n ($result: expr, $error: ident, $ret: expr) => {\n match $result {\n Ok(v) => v,\n Err(err) => unsafe {\n *$error = Box::into_raw(Box::new(err.into()));\n return $ret;\n },\n }\n };\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_browserslist_to_targets(\n query: *const c_char,\n targets: *mut Targets,\n error: *mut *mut CssError,\n) -> bool {\n let string = unsafe { std::str::from_utf8_unchecked(CStr::from_ptr(query).to_bytes()) };\n match Browsers::from_browserslist([string]) {\n Ok(Some(browsers)) => {\n let targets = unsafe { &mut *targets };\n targets.android = browsers.android.unwrap_or_default();\n targets.chrome = browsers.chrome.unwrap_or_default();\n targets.edge = browsers.edge.unwrap_or_default();\n targets.firefox = browsers.firefox.unwrap_or_default();\n targets.ie = browsers.ie.unwrap_or_default();\n targets.ios_saf = browsers.ios_saf.unwrap_or_default();\n targets.opera = browsers.opera.unwrap_or_default();\n targets.safari = browsers.safari.unwrap_or_default();\n targets.samsung = browsers.samsung.unwrap_or_default();\n true\n }\n Ok(None) => true,\n Err(err) => unsafe {\n *error = Box::into_raw(Box::new(err.into()));\n false\n },\n }\n}\n\n#[repr(C)]\npub struct TransformOptions {\n targets: Targets,\n unused_symbols: *mut *mut c_char,\n unused_symbols_len: usize,\n}\n\nimpl Into for TransformOptions {\n fn into(self) -> MinifyOptions {\n let mut unused_symbols = HashSet::new();\n let slice = unsafe { std::slice::from_raw_parts(self.unused_symbols, self.unused_symbols_len) };\n for symbol in slice {\n let string = unsafe { std::str::from_utf8_unchecked(CStr::from_ptr(*symbol).to_bytes()).to_owned() };\n unused_symbols.insert(string);\n }\n\n MinifyOptions {\n targets: if self.targets != Targets::default() {\n Some(self.targets.into()).into()\n } else {\n Default::default()\n },\n unused_symbols,\n }\n }\n}\n\n#[repr(C)]\npub struct ToCssOptions {\n minify: bool,\n source_map: bool,\n input_source_map: *const c_char,\n input_source_map_len: usize,\n project_root: *const c_char,\n targets: Targets,\n analyze_dependencies: bool,\n pseudo_classes: PseudoClasses,\n}\n\n#[derive(PartialEq)]\n#[repr(C)]\npub struct PseudoClasses {\n hover: *const c_char,\n active: *const c_char,\n focus: *const c_char,\n focus_visible: *const c_char,\n focus_within: *const c_char,\n}\n\nimpl Default for PseudoClasses {\n fn default() -> Self {\n PseudoClasses {\n hover: std::ptr::null(),\n active: std::ptr::null(),\n focus: std::ptr::null(),\n focus_visible: std::ptr::null(),\n focus_within: std::ptr::null(),\n }\n }\n}\n\nimpl<'a> Into> for PseudoClasses {\n fn into(self) -> lightningcss::printer::PseudoClasses<'a> {\n macro_rules! pc {\n ($ptr: expr) => {\n if $ptr.is_null() {\n None\n } else {\n Some(unsafe { std::str::from_utf8_unchecked(CStr::from_ptr($ptr).to_bytes()) })\n }\n };\n }\n\n lightningcss::printer::PseudoClasses {\n hover: pc!(self.hover),\n active: pc!(self.active),\n focus: pc!(self.focus),\n focus_visible: pc!(self.focus_visible),\n focus_within: pc!(self.focus_within),\n }\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_stylesheet_parse(\n source: *const c_char,\n len: usize,\n options: ParseOptions,\n error: *mut *mut CssError,\n) -> *mut StyleSheetWrapper {\n let slice = unsafe { std::slice::from_raw_parts(source as *const u8, len) };\n let code = unsafe { std::str::from_utf8_unchecked(slice) };\n let warnings = Arc::new(RwLock::new(Vec::new()));\n let mut flags = ParserFlags::empty();\n flags.set(ParserFlags::CUSTOM_MEDIA, options.custom_media);\n let opts = ParserOptions {\n filename: if options.filename.is_null() {\n String::new()\n } else {\n unsafe { std::str::from_utf8_unchecked(CStr::from_ptr(options.filename).to_bytes()).to_owned() }\n },\n flags,\n css_modules: if options.css_modules {\n let pattern = if !options.css_modules_pattern.is_null() {\n let pattern =\n unsafe { std::str::from_utf8_unchecked(CStr::from_ptr(options.css_modules_pattern).to_bytes()) };\n unwrap!(\n lightningcss::css_modules::Pattern::parse(pattern),\n error,\n std::ptr::null_mut()\n )\n } else {\n lightningcss::css_modules::Pattern::default()\n };\n Some(lightningcss::css_modules::Config {\n pattern,\n dashed_idents: options.css_modules_dashed_idents,\n ..Default::default()\n })\n } else {\n None\n },\n error_recovery: options.error_recovery,\n source_index: 0,\n warnings: Some(warnings.clone()),\n };\n\n let stylesheet = unwrap!(StyleSheet::parse(code, opts), error, std::ptr::null_mut());\n Box::into_raw(Box::new(StyleSheetWrapper {\n stylesheet,\n source: code,\n warnings: warnings.clone().read().unwrap().iter().map(|w| w.clone().into()).collect(),\n }))\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_stylesheet_transform(\n stylesheet: *mut StyleSheetWrapper,\n options: TransformOptions,\n error: *mut *mut CssError,\n) -> bool {\n let wrapper = unsafe { stylesheet.as_mut() }.unwrap();\n unwrap!(wrapper.stylesheet.minify(options.into()), error, false);\n true\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_stylesheet_to_css(\n stylesheet: *mut StyleSheetWrapper,\n options: ToCssOptions,\n error: *mut *mut CssError,\n) -> ToCssResult {\n let wrapper = unsafe { stylesheet.as_mut() }.unwrap();\n let mut source_map = if options.source_map {\n let mut sm = SourceMap::new(\"/\");\n sm.add_source(&wrapper.stylesheet.sources[0]);\n unwrap!(sm.set_source_content(0, wrapper.source), error, ToCssResult::default());\n Some(sm)\n } else {\n None\n };\n\n let opts = PrinterOptions {\n minify: options.minify,\n project_root: if options.project_root.is_null() {\n None\n } else {\n Some(unsafe { std::str::from_utf8_unchecked(CStr::from_ptr(options.project_root).to_bytes()) })\n },\n source_map: source_map.as_mut(),\n targets: if options.targets != Targets::default() {\n Some(options.targets.into()).into()\n } else {\n Default::default()\n },\n analyze_dependencies: if options.analyze_dependencies {\n Some(Default::default())\n } else {\n None\n },\n pseudo_classes: if options.pseudo_classes != PseudoClasses::default() {\n Some(options.pseudo_classes.into())\n } else {\n None\n },\n };\n\n let res = unwrap!(wrapper.stylesheet.to_css(opts), error, ToCssResult::default());\n\n let map = if let Some(mut source_map) = source_map {\n if !options.input_source_map.is_null() {\n let slice =\n unsafe { std::slice::from_raw_parts(options.input_source_map as *const u8, options.input_source_map_len) };\n let input_source_map = unsafe { std::str::from_utf8_unchecked(slice) };\n let mut sm = unwrap!(\n SourceMap::from_json(\"/\", input_source_map),\n error,\n ToCssResult::default()\n );\n unwrap!(source_map.extends(&mut sm), error, ToCssResult::default());\n }\n\n unwrap!(source_map.to_json(None), error, ToCssResult::default()).into()\n } else {\n RawString::default()\n };\n\n let (exports, exports_len) = if let Some(exports) = res.exports {\n let exports: Vec = exports\n .into_iter()\n .map(|(k, v)| {\n let composes_len = v.composes.len();\n let composes = if !v.composes.is_empty() {\n let composes: Vec = v.composes.into_iter().map(|composes| composes.into()).collect();\n ManuallyDrop::new(composes).as_mut_ptr()\n } else {\n std::ptr::null_mut()\n };\n\n CssModuleExport {\n exported: k.into(),\n local: v.name.into(),\n is_referenced: v.is_referenced,\n composes,\n composes_len,\n }\n })\n .collect();\n let mut exports = ManuallyDrop::new(exports);\n (exports.as_mut_ptr(), exports.len())\n } else {\n (std::ptr::null_mut(), 0)\n };\n\n let (references, references_len) = if let Some(references) = res.references {\n let references: Vec = references\n .into_iter()\n .map(|(k, v)| CssModulePlaceholder {\n placeholder: k.into(),\n reference: v.into(),\n })\n .collect();\n let mut references = ManuallyDrop::new(references);\n (references.as_mut_ptr(), references.len())\n } else {\n (std::ptr::null_mut(), 0)\n };\n\n ToCssResult {\n code: res.code.into(),\n map,\n exports,\n exports_len,\n references,\n references_len,\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_stylesheet_free(stylesheet: *mut StyleSheetWrapper) {\n if !stylesheet.is_null() {\n drop(unsafe { Box::from_raw(stylesheet) })\n }\n}\n\n#[repr(C)]\npub struct ToCssResult {\n code: RawString,\n map: RawString,\n exports: *mut CssModuleExport,\n exports_len: usize,\n references: *mut CssModulePlaceholder,\n references_len: usize,\n}\n\nimpl Default for ToCssResult {\n fn default() -> Self {\n ToCssResult {\n code: RawString::default(),\n map: RawString::default(),\n exports: std::ptr::null_mut(),\n exports_len: 0,\n references: std::ptr::null_mut(),\n references_len: 0,\n }\n }\n}\n\nimpl Drop for ToCssResult {\n fn drop(&mut self) {\n if !self.exports.is_null() {\n let exports = unsafe { Vec::from_raw_parts(self.exports, self.exports_len, self.exports_len) };\n drop(exports);\n self.exports = std::ptr::null_mut();\n }\n\n if !self.references.is_null() {\n let references = unsafe { Vec::from_raw_parts(self.references, self.references_len, self.references_len) };\n drop(references);\n self.references = std::ptr::null_mut();\n }\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_to_css_result_free(result: ToCssResult) {\n drop(result)\n}\n\n#[repr(C)]\npub struct CssModuleExport {\n exported: RawString,\n local: RawString,\n is_referenced: bool,\n composes: *mut CssModuleReference,\n composes_len: usize,\n}\n\nimpl Drop for CssModuleExport {\n fn drop(&mut self) {\n if !self.composes.is_null() {\n let composes = unsafe { Vec::from_raw_parts(self.composes, self.composes_len, self.composes_len) };\n drop(composes);\n self.composes = std::ptr::null_mut();\n }\n }\n}\n\n#[repr(C)]\npub enum CssModuleReference {\n /// A local reference.\n Local {\n /// The local (compiled) name for the reference.\n name: RawString,\n },\n /// A global reference.\n Global {\n /// The referenced global name.\n name: RawString,\n },\n /// A reference to an export in a different file.\n Dependency {\n /// The name to reference within the dependency.\n name: RawString,\n /// The dependency specifier for the referenced file.\n specifier: RawString,\n },\n}\n\nimpl From for CssModuleReference {\n fn from(reference: lightningcss::css_modules::CssModuleReference) -> Self {\n use lightningcss::css_modules::CssModuleReference::*;\n match reference {\n Local { name } => CssModuleReference::Local { name: name.into() },\n Global { name } => CssModuleReference::Global { name: name.into() },\n Dependency { name, specifier } => CssModuleReference::Dependency {\n name: name.into(),\n specifier: specifier.into(),\n },\n }\n }\n}\n\n#[repr(C)]\npub struct CssModulePlaceholder {\n placeholder: RawString,\n reference: CssModuleReference,\n}\n\n#[repr(C)]\npub struct RawString {\n text: *mut c_char,\n len: usize,\n}\n\nimpl Default for RawString {\n fn default() -> Self {\n RawString {\n text: std::ptr::null_mut(),\n len: 0,\n }\n }\n}\n\nimpl From for RawString {\n fn from(string: String) -> RawString {\n RawString {\n len: string.len(),\n text: Box::into_raw(string.into_boxed_str()) as *mut c_char,\n }\n }\n}\n\nimpl Drop for RawString {\n fn drop(&mut self) {\n if self.text.is_null() {\n return;\n }\n drop(unsafe { Box::from_raw(self.text) });\n self.text = std::ptr::null_mut();\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_error_message(error: *mut CssError) -> *const c_char {\n match unsafe { error.as_mut() } {\n Some(err) => err.message(),\n None => std::ptr::null(),\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_error_free(error: *mut CssError) {\n if !error.is_null() {\n drop(unsafe { Box::from_raw(error) })\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_stylesheet_get_warning_count<'i>(\n stylesheet: *mut StyleSheetWrapper<'i, '_>,\n) -> usize {\n match unsafe { stylesheet.as_mut() } {\n Some(s) => s.warnings.len(),\n None => 0,\n }\n}\n\n#[no_mangle]\npub extern \"C\" fn lightningcss_stylesheet_get_warning<'i>(\n stylesheet: *mut StyleSheetWrapper<'i, '_>,\n index: usize,\n) -> *const c_char {\n let stylesheet = match unsafe { stylesheet.as_mut() } {\n Some(s) => s,\n None => return std::ptr::null(),\n };\n\n match stylesheet.warnings.get_mut(index) {\n Some(w) => w.message(),\n None => std::ptr::null(),\n }\n}\n" }, { "path": "c/test.c", "content": "#include \n#include \n#include \"lightningcss.h\"\n\nint print_error(CssError *error);\n\nint main()\n{\n char *source =\n \".foo {\"\n \" color: lch(50.998% 135.363 338);\"\n \"}\"\n \".bar {\"\n \" color: yellow;\"\n \" composes: foo from './bar.css';\"\n \"}\"\n \".baz:hover {\"\n \" color: var(--foo from './baz.css');\"\n \"}\";\n\n ParseOptions parse_opts = {\n .filename = \"test.css\",\n .css_modules = true,\n .css_modules_pattern = \"yo_[name]_[local]\",\n .css_modules_dashed_idents = true};\n\n CssError *error = NULL;\n StyleSheet *stylesheet = lightningcss_stylesheet_parse(source, strlen(source), parse_opts, &error);\n if (!stylesheet)\n goto cleanup;\n\n char *unused_symbols[1] = {\"bar\"};\n TransformOptions transform_opts = {\n .unused_symbols = unused_symbols,\n .unused_symbols_len = 0};\n\n if (!lightningcss_browserslist_to_targets(\"last 2 versions, not IE <= 11\", &transform_opts.targets, &error))\n goto cleanup;\n\n if (!lightningcss_stylesheet_transform(stylesheet, transform_opts, &error))\n goto cleanup;\n\n ToCssOptions to_css_opts = {\n .minify = true,\n .source_map = true,\n .pseudo_classes = {\n .hover = \"is-hovered\"}};\n\n ToCssResult result = lightningcss_stylesheet_to_css(stylesheet, to_css_opts, &error);\n if (error)\n goto cleanup;\n\n size_t warning_count = lightningcss_stylesheet_get_warning_count(stylesheet);\n for (size_t i = 0; i < warning_count; i++)\n {\n printf(\"warning: %s\\n\", lightningcss_stylesheet_get_warning(stylesheet, i));\n }\n\n fwrite(result.code.text, sizeof(char), result.code.len, stdout);\n printf(\"\\n\");\n fwrite(result.map.text, sizeof(char), result.map.len, stdout);\n printf(\"\\n\");\n\n for (int i = 0; i < result.exports_len; i++)\n {\n printf(\"%.*s -> %.*s\\n\", (int)result.exports[i].exported.len, result.exports[i].exported.text, (int)result.exports[i].local.len, result.exports[i].local.text);\n for (int j = 0; j < result.exports[i].composes_len; j++)\n {\n const CssModuleReference *ref = &result.exports[i].composes[j];\n switch (ref->tag)\n {\n case CssModuleReference_Local:\n printf(\" composes local: %.*s\\n\", (int)ref->local.name.len, ref->local.name.text);\n break;\n case CssModuleReference_Global:\n printf(\" composes global: %.*s\\n\", (int)ref->global.name.len, ref->global.name.text);\n break;\n case CssModuleReference_Dependency:\n printf(\" composes dependency: %.*s from %.*s\\n\", (int)ref->dependency.name.len, ref->dependency.name.text, (int)ref->dependency.specifier.len, ref->dependency.specifier.text);\n break;\n }\n }\n }\n\n for (int i = 0; i < result.references_len; i++)\n {\n printf(\"placeholder: %.*s\\n\", (int)result.references[i].placeholder.len, result.references[i].placeholder.text);\n }\n\ncleanup:\n lightningcss_stylesheet_free(stylesheet);\n lightningcss_to_css_result_free(result);\n\n if (error)\n {\n printf(\"error: %s\\n\", lightningcss_error_message(error));\n lightningcss_error_free(error);\n return 1;\n }\n}\n" }, { "path": "cli/.gitignore", "content": "package.json\nREADME.md\n.DS_Store\nlightningcss.exe\n" }, { "path": "cli/lightningcss", "content": "This file is required so that npm creates the lightningcss binary on Windows.\n" }, { "path": "cli/postinstall.js", "content": "let fs = require('fs');\nlet path = require('path');\n\nlet parts = [process.platform, process.arch];\nif (process.platform === 'linux') {\n const {MUSL, familySync} = require('detect-libc');\n const family = familySync();\n if (family === MUSL) {\n parts.push('musl');\n } else if (process.arch === 'arm') {\n parts.push('gnueabihf');\n } else {\n parts.push('gnu');\n }\n} else if (process.platform === 'win32') {\n parts.push('msvc');\n}\n\nlet binary = process.platform === 'win32' ? 'lightningcss.exe' : 'lightningcss';\n\nlet pkgPath;\ntry {\n pkgPath = path.dirname(require.resolve(`lightningcss-cli-${parts.join('-')}/package.json`));\n} catch (err) {\n pkgPath = path.join(__dirname, '..', 'target', 'release');\n if (!fs.existsSync(path.join(pkgPath, binary))) {\n pkgPath = path.join(__dirname, '..', 'target', 'debug');\n }\n}\n\ntry {\n fs.linkSync(path.join(pkgPath, binary), path.join(__dirname, binary));\n} catch (err) {\n try {\n fs.copyFileSync(path.join(pkgPath, binary), path.join(__dirname, binary));\n } catch (err) {\n console.error('Failed to move lightningcss-cli binary into place.');\n process.exit(1);\n }\n}\n\nif (process.platform === 'win32') {\n try {\n fs.unlinkSync(path.join(__dirname, 'lightningcss'));\n } catch (err) { }\n}\n" }, { "path": "derive/Cargo.toml", "content": "[package]\nauthors = [\"Devon Govett \"]\nname = \"lightningcss-derive\"\ndescription = \"Derive macros for lightningcss\"\nversion = \"1.0.0-alpha.43\"\nlicense = \"MPL-2.0\"\nedition = \"2021\"\nrepository = \"https://github.com/parcel-bundler/lightningcss\"\n\n[lib]\nproc-macro = true\n\n[dependencies]\nsyn = { version = \"1.0\", features = [\"extra-traits\"] }\nquote = \"1.0\"\nproc-macro2 = \"1.0\"\nconvert_case = \"0.6.0\"\n" }, { "path": "derive/src/lib.rs", "content": "use proc_macro::TokenStream;\n\nmod parse;\nmod to_css;\nmod visit;\n\n#[proc_macro_derive(Visit, attributes(visit, skip_visit, skip_type, visit_types))]\npub fn derive_visit_children(input: TokenStream) -> TokenStream {\n visit::derive_visit_children(input)\n}\n\n#[proc_macro_derive(Parse, attributes(css))]\npub fn derive_parse(input: TokenStream) -> TokenStream {\n parse::derive_parse(input)\n}\n\n#[proc_macro_derive(ToCss, attributes(css))]\npub fn derive_to_css(input: TokenStream) -> TokenStream {\n to_css::derive_to_css(input)\n}\n" }, { "path": "derive/src/parse.rs", "content": "use convert_case::Casing;\nuse proc_macro::{self, TokenStream};\nuse proc_macro2::{Literal, Span, TokenStream as TokenStream2};\nuse quote::quote;\nuse syn::{\n parse::Parse, parse_macro_input, parse_quote, Attribute, Data, DataEnum, DeriveInput, Fields, Ident, Token,\n};\n\npub fn derive_parse(input: TokenStream) -> TokenStream {\n let DeriveInput {\n ident,\n data,\n mut generics,\n attrs,\n ..\n } = parse_macro_input!(input);\n let opts = CssOptions::parse_attributes(&attrs).unwrap();\n let cloned_generics = generics.clone();\n let (_, ty_generics, _) = cloned_generics.split_for_impl();\n\n if generics.lifetimes().next().is_none() {\n generics.params.insert(0, parse_quote! { 'i })\n }\n\n let lifetime = generics.lifetimes().next().unwrap().clone();\n let (impl_generics, _, where_clause) = generics.split_for_impl();\n\n let imp = match &data {\n Data::Enum(data) => derive_enum(&data, &ident, &opts),\n _ => todo!(),\n };\n\n let output = quote! {\n impl #impl_generics Parse<#lifetime> for #ident #ty_generics #where_clause {\n fn parse<'t>(input: &mut Parser<#lifetime, 't>) -> Result>> {\n #imp\n }\n }\n };\n\n output.into()\n}\n\nfn derive_enum(data: &DataEnum, ident: &Ident, opts: &CssOptions) -> TokenStream2 {\n let mut idents = Vec::new();\n let mut non_idents = Vec::new();\n for (index, variant) in data.variants.iter().enumerate() {\n let name = &variant.ident;\n let fields = variant\n .fields\n .iter()\n .enumerate()\n .map(|(index, field)| {\n field.ident.as_ref().map_or_else(\n || Ident::new(&format!(\"_{}\", index), Span::call_site()),\n |ident| ident.clone(),\n )\n })\n .collect::>();\n\n let mut expr = match &variant.fields {\n Fields::Unit => {\n idents.push((\n Literal::string(&variant.ident.to_string().to_case(opts.case)),\n name.clone(),\n ));\n continue;\n }\n Fields::Named(_) => {\n quote! {\n return Ok(#ident::#name { #(#fields),* })\n }\n }\n Fields::Unnamed(_) => {\n quote! {\n return Ok(#ident::#name(#(#fields),*))\n }\n }\n };\n\n // Group multiple ident branches together.\n if !idents.is_empty() {\n if idents.len() == 1 {\n let (s, name) = idents.remove(0);\n non_idents.push(quote! {\n if input.try_parse(|input| input.expect_ident_matching(#s)).is_ok() {\n return Ok(#ident::#name)\n }\n });\n } else {\n let matches = idents\n .iter()\n .map(|(s, name)| {\n quote! {\n #s => return Ok(#ident::#name),\n }\n })\n .collect::>();\n non_idents.push(quote! {\n {\n let state = input.state();\n if let Ok(ident) = input.try_parse(|input| input.expect_ident_cloned()) {\n cssparser::match_ignore_ascii_case! { &*ident,\n #(#matches)*\n _ => {}\n }\n input.reset(&state);\n }\n }\n });\n idents.clear();\n }\n }\n\n let is_last = index == data.variants.len() - 1;\n\n for (index, field) in variant.fields.iter().enumerate().rev() {\n let ty = &field.ty;\n let field_name = field.ident.as_ref().map_or_else(\n || Ident::new(&format!(\"_{}\", index), Span::call_site()),\n |ident| ident.clone(),\n );\n if is_last {\n expr = quote! {\n let #field_name = <#ty>::parse(input)?;\n #expr\n };\n } else {\n expr = quote! {\n if let Ok(#field_name) = input.try_parse(<#ty>::parse) {\n #expr\n }\n };\n }\n }\n\n non_idents.push(expr);\n }\n\n let idents = if idents.is_empty() {\n quote! {}\n } else if idents.len() == 1 {\n let (s, name) = idents.remove(0);\n quote! {\n input.expect_ident_matching(#s)?;\n Ok(#ident::#name)\n }\n } else {\n let idents = idents\n .into_iter()\n .map(|(s, name)| {\n quote! {\n #s => Ok(#ident::#name),\n }\n })\n .collect::>();\n quote! {\n let location = input.current_source_location();\n let ident = input.expect_ident()?;\n cssparser::match_ignore_ascii_case! { &*ident,\n #(#idents)*\n _ => Err(location.new_unexpected_token_error(\n cssparser::Token::Ident(ident.clone())\n ))\n }\n }\n };\n\n let output = quote! {\n #(#non_idents)*\n #idents\n };\n\n output.into()\n}\n\npub struct CssOptions {\n pub case: convert_case::Case,\n}\n\nimpl CssOptions {\n pub fn parse_attributes(attrs: &Vec) -> syn::Result {\n for attr in attrs {\n if attr.path.is_ident(\"css\") {\n let opts: CssOptions = attr.parse_args()?;\n return Ok(opts);\n }\n }\n\n Ok(CssOptions {\n case: convert_case::Case::Kebab,\n })\n }\n}\n\nimpl Parse for CssOptions {\n fn parse(input: syn::parse::ParseStream) -> syn::Result {\n let mut case = convert_case::Case::Kebab;\n while !input.is_empty() {\n let k: Ident = input.parse()?;\n let _: Token![=] = input.parse()?;\n let v: Ident = input.parse()?;\n\n if k == \"case\" {\n if v == \"lower\" {\n case = convert_case::Case::Flat;\n }\n }\n }\n\n Ok(Self { case })\n }\n}\n" }, { "path": "derive/src/to_css.rs", "content": "use convert_case::Casing;\nuse proc_macro::{self, TokenStream};\nuse proc_macro2::{Literal, Span, TokenStream as TokenStream2};\nuse quote::quote;\nuse syn::{parse_macro_input, Data, DataEnum, DeriveInput, Fields, Ident, Type};\n\nuse crate::parse::CssOptions;\n\npub fn derive_to_css(input: TokenStream) -> TokenStream {\n let DeriveInput {\n ident,\n data,\n generics,\n attrs,\n ..\n } = parse_macro_input!(input);\n\n let opts = CssOptions::parse_attributes(&attrs).unwrap();\n let (impl_generics, ty_generics, where_clause) = generics.split_for_impl();\n\n let imp = match &data {\n Data::Enum(data) => derive_enum(&data, &opts),\n _ => todo!(),\n };\n\n let output = quote! {\n impl #impl_generics ToCss for #ident #ty_generics #where_clause {\n fn to_css(&self, dest: &mut Printer) -> Result<(), PrinterError>\n where\n W: std::fmt::Write,\n {\n #imp\n }\n }\n };\n\n output.into()\n}\n\nfn derive_enum(data: &DataEnum, opts: &CssOptions) -> TokenStream2 {\n let variants = data\n .variants\n .iter()\n .map(|variant| {\n let name = &variant.ident;\n let fields = variant\n .fields\n .iter()\n .enumerate()\n .map(|(index, field)| {\n field.ident.as_ref().map_or_else(\n || Ident::new(&format!(\"_{}\", index), Span::call_site()),\n |ident| ident.clone(),\n )\n })\n .collect::>();\n\n #[derive(PartialEq)]\n enum NeedsSpace {\n Yes,\n No,\n Maybe,\n }\n\n let mut needs_space = NeedsSpace::No;\n let mut fields_iter = variant.fields.iter().zip(fields.iter()).peekable();\n let mut writes = Vec::new();\n let mut has_needs_space = false;\n while let Some((field, name)) = fields_iter.next() {\n writes.push(if fields.len() > 1 {\n let space = match needs_space {\n NeedsSpace::Yes => quote! { dest.write_char(' ')?; },\n NeedsSpace::No => quote! {},\n NeedsSpace::Maybe => {\n has_needs_space = true;\n quote! {\n if needs_space {\n dest.write_char(' ')?;\n }\n }\n }\n };\n\n if is_option(&field.ty) {\n needs_space = NeedsSpace::Maybe;\n let after_space = if matches!(fields_iter.peek(), Some((field, _)) if !is_option(&field.ty)) {\n // If the next field is non-optional, just insert the space here.\n needs_space = NeedsSpace::No;\n quote! { dest.write_char(' ')?; }\n } else {\n quote! {}\n };\n quote! {\n if let Some(v) = #name {\n #space\n v.to_css(dest)?;\n #after_space\n }\n }\n } else {\n needs_space = NeedsSpace::Yes;\n quote! {\n #space\n #name.to_css(dest)?;\n }\n }\n } else {\n quote! { #name.to_css(dest) }\n });\n }\n\n if writes.len() > 1 {\n writes.push(quote! { Ok(()) });\n }\n\n if has_needs_space {\n writes.insert(0, quote! { let mut needs_space = false });\n }\n\n match variant.fields {\n Fields::Unit => {\n let s = Literal::string(&variant.ident.to_string().to_case(opts.case));\n quote! {\n Self::#name => dest.write_str(#s)\n }\n }\n Fields::Named(_) => {\n quote! {\n Self::#name { #(#fields),* } => {\n #(#writes)*\n }\n }\n }\n Fields::Unnamed(_) => {\n quote! {\n Self::#name(#(#fields),*) => {\n #(#writes)*\n }\n }\n }\n }\n })\n .collect::>();\n\n let output = quote! {\n match self {\n #(#variants),*\n }\n };\n\n output.into()\n}\n\nfn is_option(ty: &Type) -> bool {\n matches!(&ty, Type::Path(p) if p.qself.is_none() && p.path.segments.iter().next().unwrap().ident == \"Option\")\n}\n" }, { "path": "derive/src/visit.rs", "content": "use std::collections::HashSet;\n\nuse proc_macro::{self, TokenStream};\nuse proc_macro2::{Span, TokenStream as TokenStream2};\nuse quote::quote;\nuse syn::{\n parse::Parse, parse_macro_input, parse_quote, Attribute, Data, DataEnum, DeriveInput, Field, Fields,\n GenericParam, Generics, Ident, Member, Token, Type, Visibility,\n};\n\npub fn derive_visit_children(input: TokenStream) -> TokenStream {\n let DeriveInput {\n ident,\n data,\n generics,\n attrs,\n ..\n } = parse_macro_input!(input);\n\n let options: Vec = attrs\n .iter()\n .filter_map(|attr| {\n if attr.path.is_ident(\"visit\") {\n let opts: VisitOptions = attr.parse_args().unwrap();\n Some(opts)\n } else {\n None\n }\n })\n .collect();\n\n let visit_types = if let Some(attr) = attrs.iter().find(|attr| attr.path.is_ident(\"visit_types\")) {\n let types: VisitTypes = attr.parse_args().unwrap();\n let types = types.types;\n Some(quote! { crate::visit_types!(#(#types)|*) })\n } else {\n None\n };\n\n if options.is_empty() {\n derive(&ident, &data, &generics, None, visit_types)\n } else {\n options\n .into_iter()\n .map(|options| derive(&ident, &data, &generics, Some(options), visit_types.clone()))\n .collect()\n }\n}\n\nfn derive(\n ident: &Ident,\n data: &Data,\n generics: &Generics,\n options: Option,\n visit_types: Option,\n) -> TokenStream {\n let mut impl_generics = generics.clone();\n let mut type_defs = quote! {};\n let generics = if let Some(VisitOptions {\n generic: Some(generic), ..\n }) = &options\n {\n let mappings = generics\n .type_params()\n .zip(generic.type_params())\n .map(|(a, b)| quote! { type #a = #b; });\n type_defs = quote! { #(#mappings)* };\n impl_generics.params.clear();\n generic\n } else {\n &generics\n };\n\n if impl_generics.lifetimes().next().is_none() {\n impl_generics.params.insert(0, parse_quote! { 'i })\n }\n\n let lifetime = impl_generics.lifetimes().next().unwrap().clone();\n let t = impl_generics.type_params().find(|g| &g.ident.to_string() == \"R\");\n let v = quote! { __V };\n let t = if let Some(t) = t {\n GenericParam::Type(t.ident.clone().into())\n } else {\n let t: GenericParam = parse_quote! { __T };\n impl_generics\n .params\n .push(parse_quote! { #t: crate::visitor::Visit<#lifetime, __T, #v> });\n t\n };\n\n impl_generics\n .params\n .push(parse_quote! { #v: ?Sized + crate::visitor::Visitor<#lifetime, #t> });\n\n for ty in generics.type_params() {\n let name = &ty.ident;\n impl_generics.make_where_clause().predicates.push(parse_quote! {\n #name: Visit<#lifetime, #t, #v>\n })\n }\n\n let mut seen_types = HashSet::new();\n let mut child_types = Vec::new();\n let mut visit = Vec::new();\n match data {\n Data::Struct(s) => {\n for (\n index,\n Field {\n vis, ty, ident, attrs, ..\n },\n ) in s.fields.iter().enumerate()\n {\n if attrs.iter().any(|attr| attr.path.is_ident(\"skip_visit\")) {\n continue;\n }\n\n if matches!(ty, Type::Reference(_)) || !matches!(vis, Visibility::Public(..)) {\n continue;\n }\n\n if visit_types.is_none() && !seen_types.contains(ty) && !skip_type(attrs) {\n seen_types.insert(ty.clone());\n child_types.push(quote! {\n <#ty as Visit<#lifetime, #t, #v>>::CHILD_TYPES.bits()\n });\n }\n\n let name = ident\n .as_ref()\n .map_or_else(|| Member::Unnamed(index.into()), |ident| Member::Named(ident.clone()));\n visit.push(quote! { self.#name.visit(visitor)?; })\n }\n }\n Data::Enum(DataEnum { variants, .. }) => {\n let variants = variants\n .iter()\n .map(|variant| {\n let name = &variant.ident;\n let mut field_names = Vec::new();\n let mut visit_fields = Vec::new();\n for (index, Field { ty, ident, attrs, .. }) in variant.fields.iter().enumerate() {\n let name = ident.as_ref().map_or_else(\n || Ident::new(&format!(\"_{}\", index), Span::call_site()),\n |ident| ident.clone(),\n );\n field_names.push(name.clone());\n\n if matches!(ty, Type::Reference(_)) {\n continue;\n }\n\n if visit_types.is_none() && !seen_types.contains(ty) && !skip_type(attrs) && !skip_type(&variant.attrs)\n {\n seen_types.insert(ty.clone());\n child_types.push(quote! {\n <#ty as Visit<#lifetime, #t, #v>>::CHILD_TYPES.bits()\n });\n }\n\n visit_fields.push(quote! { #name.visit(visitor)?; })\n }\n\n match variant.fields {\n Fields::Unnamed(_) => {\n quote! {\n Self::#name(#(#field_names),*) => {\n #(#visit_fields)*\n }\n }\n }\n Fields::Named(_) => {\n quote! {\n Self::#name { #(#field_names),* } => {\n #(#visit_fields)*\n }\n }\n }\n Fields::Unit => quote! {},\n }\n })\n .collect::();\n\n visit.push(quote! {\n match self {\n #variants\n _ => {}\n }\n })\n }\n _ => {}\n }\n\n if visit_types.is_none() && child_types.is_empty() {\n child_types.push(quote! { crate::visitor::VisitTypes::empty().bits() });\n }\n\n let (_, ty_generics, _) = generics.split_for_impl();\n let (impl_generics, _, where_clause) = impl_generics.split_for_impl();\n\n let self_visit = if let Some(VisitOptions {\n visit: Some(visit),\n kind: Some(kind),\n ..\n }) = &options\n {\n child_types.push(quote! { crate::visitor::VisitTypes::#kind.bits() });\n\n quote! {\n fn visit(&mut self, visitor: &mut #v) -> Result<(), #v::Error> {\n if visitor.visit_types().contains(crate::visitor::VisitTypes::#kind) {\n visitor.#visit(self)\n } else {\n self.visit_children(visitor)\n }\n }\n }\n } else {\n quote! {}\n };\n\n let child_types = visit_types.unwrap_or_else(|| {\n quote! {\n {\n #type_defs\n crate::visitor::VisitTypes::from_bits_retain(#(#child_types)|*)\n }\n }\n });\n\n let output = quote! {\n impl #impl_generics Visit<#lifetime, #t, #v> for #ident #ty_generics #where_clause {\n const CHILD_TYPES: crate::visitor::VisitTypes = #child_types;\n\n #self_visit\n\n fn visit_children(&mut self, visitor: &mut #v) -> Result<(), #v::Error> {\n if !>::CHILD_TYPES.intersects(visitor.visit_types()) {\n return Ok(())\n }\n\n #(#visit)*\n\n Ok(())\n }\n }\n };\n\n output.into()\n}\n\nfn skip_type(attrs: &Vec) -> bool {\n attrs.iter().any(|attr| attr.path.is_ident(\"skip_type\"))\n}\n\nstruct VisitOptions {\n visit: Option,\n kind: Option,\n generic: Option,\n}\n\nimpl Parse for VisitOptions {\n fn parse(input: syn::parse::ParseStream) -> syn::Result {\n let (visit, kind, comma) = if input.peek(Ident) {\n let visit: Ident = input.parse()?;\n let _: Token![,] = input.parse()?;\n let kind: Ident = input.parse()?;\n let comma: Result = input.parse();\n (Some(visit), Some(kind), comma.is_ok())\n } else {\n (None, None, true)\n };\n let generic: Option = if comma { Some(input.parse()?) } else { None };\n Ok(Self { visit, kind, generic })\n }\n}\n\nstruct VisitTypes {\n types: Vec,\n}\n\nimpl Parse for VisitTypes {\n fn parse(input: syn::parse::ParseStream) -> syn::Result {\n let first: Ident = input.parse()?;\n let mut types = vec![first];\n while input.parse::().is_ok() {\n let id: Ident = input.parse()?;\n types.push(id);\n }\n Ok(Self { types })\n }\n}\n" }, { "path": "examples/custom_at_rule.rs", "content": "use std::{collections::HashMap, convert::Infallible};\n\nuse cssparser::*;\nuse lightningcss::{\n declaration::DeclarationBlock,\n error::PrinterError,\n printer::Printer,\n properties::custom::{Token, TokenOrValue},\n rules::{style::StyleRule, CssRule, CssRuleList, Location},\n selector::{Component, Selector},\n stylesheet::{ParserOptions, PrinterOptions, StyleSheet},\n targets::Browsers,\n traits::{AtRuleParser, ToCss},\n values::{\n color::{CssColor, RGBA},\n length::LengthValue,\n },\n vendor_prefix::VendorPrefix,\n visit_types,\n visitor::{Visit, VisitTypes, Visitor},\n};\n\nfn main() {\n let args: Vec = std::env::args().collect();\n let source = std::fs::read_to_string(&args[1]).unwrap();\n let opts = ParserOptions {\n filename: args[1].clone(),\n ..Default::default()\n };\n\n let mut stylesheet = StyleSheet::parse_with(&source, opts, &mut TailwindAtRuleParser).unwrap();\n\n println!(\"{:?}\", stylesheet);\n\n let mut style_rules = HashMap::new();\n stylesheet\n .visit(&mut StyleRuleCollector {\n rules: &mut style_rules,\n })\n .unwrap();\n println!(\"{:?}\", style_rules);\n stylesheet.visit(&mut ApplyVisitor { rules: &style_rules }).unwrap();\n\n let result = stylesheet\n .to_css(PrinterOptions {\n targets: Browsers {\n chrome: Some(100 << 16),\n ..Browsers::default()\n }\n .into(),\n ..PrinterOptions::default()\n })\n .unwrap();\n println!(\"{}\", result.code);\n}\n\n/// An @tailwind directive.\n#[derive(Debug, Clone)]\nenum TailwindDirective {\n Base,\n Components,\n Utilities,\n Variants,\n}\n\n/// A custom at rule prelude.\nenum Prelude {\n Tailwind(TailwindDirective),\n Apply(Vec),\n}\n\n/// A @tailwind rule.\n#[derive(Debug, Clone)]\nstruct TailwindRule {\n directive: TailwindDirective,\n loc: SourceLocation,\n}\n\n/// An @apply rule.\n#[derive(Debug, Clone)]\nstruct ApplyRule {\n names: Vec,\n loc: SourceLocation,\n}\n\n/// A custom at rule.\n#[derive(Debug, Clone)]\nenum AtRule {\n Tailwind(TailwindRule),\n Apply(ApplyRule),\n}\n\n#[derive(Debug)]\nstruct TailwindAtRuleParser;\nimpl<'i> AtRuleParser<'i> for TailwindAtRuleParser {\n type Prelude = Prelude;\n type Error = Infallible;\n type AtRule = AtRule;\n\n fn parse_prelude<'t>(\n &mut self,\n name: CowRcStr<'i>,\n input: &mut Parser<'i, 't>,\n _options: &ParserOptions<'_, 'i>,\n ) -> Result> {\n match_ignore_ascii_case! {&*name,\n \"tailwind\" => {\n let location = input.current_source_location();\n let ident = input.expect_ident()?;\n let directive = match_ignore_ascii_case! { &*ident,\n \"base\" => TailwindDirective::Base,\n \"components\" => TailwindDirective::Components,\n \"utilities\" => TailwindDirective::Utilities,\n \"variants\" => TailwindDirective::Variants,\n _ => return Err(location.new_unexpected_token_error(\n cssparser::Token::Ident(ident.clone())\n ))\n };\n Ok(Prelude::Tailwind(directive))\n },\n \"apply\" => {\n let mut names = Vec::new();\n loop {\n if let Ok(name) = input.try_parse(|input| input.expect_ident_cloned()) {\n names.push(name.as_ref().into());\n } else {\n break\n }\n }\n\n Ok(Prelude::Apply(names))\n },\n _ => Err(input.new_error(BasicParseErrorKind::AtRuleInvalid(name)))\n }\n }\n\n fn rule_without_block(\n &mut self,\n prelude: Self::Prelude,\n start: &ParserState,\n _options: &ParserOptions<'_, 'i>,\n _is_nested: bool,\n ) -> Result {\n let loc = start.source_location();\n match prelude {\n Prelude::Tailwind(directive) => Ok(AtRule::Tailwind(TailwindRule { directive, loc })),\n Prelude::Apply(names) => Ok(AtRule::Apply(ApplyRule { names, loc })),\n }\n }\n}\n\nstruct StyleRuleCollector<'i, 'a> {\n rules: &'a mut HashMap>,\n}\n\nimpl<'i, 'a> Visitor<'i, AtRule> for StyleRuleCollector<'i, 'a> {\n type Error = Infallible;\n\n fn visit_types(&self) -> VisitTypes {\n VisitTypes::RULES\n }\n\n fn visit_rule(&mut self, rule: &mut lightningcss::rules::CssRule<'i, AtRule>) -> Result<(), Self::Error> {\n match rule {\n CssRule::Style(rule) => {\n for selector in rule.selectors.0.iter() {\n if selector.len() != 1 {\n continue; // TODO\n }\n for component in selector.iter_raw_match_order() {\n match component {\n Component::Class(name) => {\n self.rules.insert(name.0.to_string(), rule.declarations.clone());\n }\n _ => {}\n }\n }\n }\n }\n _ => {}\n }\n\n rule.visit_children(self)\n }\n}\n\nstruct ApplyVisitor<'a, 'i> {\n rules: &'a HashMap>,\n}\n\nimpl<'a, 'i> Visitor<'i, AtRule> for ApplyVisitor<'a, 'i> {\n type Error = Infallible;\n\n fn visit_types(&self) -> VisitTypes {\n visit_types!(RULES | COLORS | LENGTHS | DASHED_IDENTS | SELECTORS | TOKENS)\n }\n\n fn visit_rule(&mut self, rule: &mut CssRule<'i, AtRule>) -> Result<(), Self::Error> {\n // Replace @apply rule with nested style rule.\n if let CssRule::Custom(AtRule::Apply(apply)) = rule {\n let mut declarations = DeclarationBlock::new();\n for name in &apply.names {\n let Some(applied) = self.rules.get(name) else {\n continue;\n };\n declarations\n .important_declarations\n .extend(applied.important_declarations.iter().cloned());\n declarations.declarations.extend(applied.declarations.iter().cloned());\n }\n *rule = CssRule::Style(StyleRule {\n selectors: Component::Nesting.into(),\n vendor_prefix: VendorPrefix::None,\n declarations,\n rules: CssRuleList(vec![]),\n loc: Location {\n source_index: 0,\n line: apply.loc.line,\n column: apply.loc.column,\n },\n })\n }\n\n rule.visit_children(self)\n }\n\n fn visit_url(&mut self, url: &mut lightningcss::values::url::Url<'i>) -> Result<(), Self::Error> {\n url.url = format!(\"https://mywebsite.com/{}\", url.url).into();\n Ok(())\n }\n\n fn visit_color(&mut self, color: &mut lightningcss::values::color::CssColor) -> Result<(), Self::Error> {\n *color = color.to_lab().unwrap();\n Ok(())\n }\n\n fn visit_length(&mut self, length: &mut lightningcss::values::length::LengthValue) -> Result<(), Self::Error> {\n match length {\n LengthValue::Px(px) => *length = LengthValue::Rem(*px / 16.0),\n _ => {}\n }\n\n Ok(())\n }\n\n fn visit_dashed_ident(\n &mut self,\n ident: &mut lightningcss::values::ident::DashedIdent,\n ) -> Result<(), Self::Error> {\n ident.0 = format!(\"--tw-{}\", &ident.0[2..]).into();\n Ok(())\n }\n\n fn visit_selector(&mut self, selector: &mut Selector<'i>) -> Result<(), Self::Error> {\n for c in selector.iter_mut_raw_match_order() {\n match c {\n Component::Class(c) => {\n *c = format!(\"tw-{}\", c).into();\n }\n _ => {}\n }\n }\n\n Ok(())\n }\n\n fn visit_token(&mut self, token: &mut TokenOrValue<'i>) -> Result<(), Self::Error> {\n match token {\n TokenOrValue::Function(f) if f.name == \"theme\" => match f.arguments.0.first() {\n Some(TokenOrValue::Token(Token::String(s))) => match s.as_ref() {\n \"blue-500\" => *token = TokenOrValue::Color(CssColor::RGBA(RGBA::new(0, 0, 255, 1.0))),\n \"red-500\" => *token = TokenOrValue::Color(CssColor::RGBA(RGBA::new(255, 0, 0, 1.0))),\n _ => {}\n },\n _ => {}\n },\n _ => {}\n }\n\n token.visit_children(self)\n }\n}\n\n#[cfg(feature = \"visitor\")]\nimpl<'i, V: Visitor<'i, AtRule>> Visit<'i, AtRule, V> for AtRule {\n const CHILD_TYPES: VisitTypes = VisitTypes::empty();\n\n fn visit_children(&mut self, _: &mut V) -> Result<(), V::Error> {\n Ok(())\n }\n}\n\nimpl ToCss for AtRule {\n fn to_css(&self, dest: &mut Printer) -> Result<(), PrinterError> {\n match self {\n AtRule::Tailwind(rule) => {\n let _ = rule.loc; // TODO: source maps\n let directive = match rule.directive {\n TailwindDirective::Base => \"TAILWIND BASE HERE\",\n TailwindDirective::Components => \"TAILWIND COMPONENTS HERE\",\n TailwindDirective::Utilities => \"TAILWIND UTILITIES HERE\",\n TailwindDirective::Variants => \"TAILWIND VARIANTS HERE\",\n };\n dest.write_str(directive)\n }\n AtRule::Apply(_) => Ok(()),\n }\n }\n}\n" }, { "path": "examples/schema.rs", "content": "fn main() {\n #[cfg(feature = \"jsonschema\")]\n {\n let schema = schemars::schema_for!(lightningcss::stylesheet::StyleSheet);\n let output = serde_json::to_string_pretty(&schema).unwrap();\n let _ = std::fs::write(\"node/ast.json\", output);\n }\n}\n" }, { "path": "examples/serialize.rs", "content": "fn main() {\n parse();\n}\n\n#[cfg(feature = \"serde\")]\nfn parse() {\n use lightningcss::stylesheet::{ParserOptions, StyleSheet};\n use std::{env, fs};\n\n let args: Vec = env::args().collect();\n let contents = fs::read_to_string(&args[1]).unwrap();\n let stylesheet = StyleSheet::parse(\n &contents,\n ParserOptions {\n filename: args[1].clone(),\n ..ParserOptions::default()\n },\n )\n .unwrap();\n let json = serde_json::to_string(&stylesheet).unwrap();\n println!(\"{}\", json);\n}\n\n#[cfg(not(feature = \"serde\"))]\nfn parse() {\n panic!(\"serde feature is not enabled\")\n}\n" }, { "path": "napi/Cargo.toml", "content": "[package]\nauthors = [\"Devon Govett \"]\nname = \"lightningcss-napi\"\nversion = \"0.4.8\"\ndescription = \"Node-API bindings for Lightning CSS\"\nlicense = \"MPL-2.0\"\nrepository = \"https://github.com/parcel-bundler/lightningcss\"\nedition = \"2021\"\n\n[features]\ndefault = []\nvisitor = [\"lightningcss/visitor\"]\nbundler = [\"dep:crossbeam-channel\", \"dep:rayon\"]\n\n[dependencies]\nserde = { version = \"1.0.201\", features = [\"derive\"] }\nserde-content = { version = \"0.1.2\", features = [\"serde\"] }\nserde_bytes = \"0.11.5\"\ncssparser = \"0.33.0\"\nlightningcss = { version = \"1.0.0-alpha.71\", path = \"../\", features = [\n \"nodejs\",\n \"serde\",\n] }\nparcel_sourcemap = { version = \"2.1.1\", features = [\"json\"] }\nserde-detach = \"0.0.1\"\nsmallvec = { version = \"1.7.0\", features = [\"union\"] }\nnapi = { version = \"2\", default-features = false, features = [\n \"napi4\",\n \"napi5\",\n \"serde-json\",\n] }\ncrossbeam-channel = { version = \"0.5.6\", optional = true }\nrayon = { version = \"1.5.1\", optional = true }\n" }, { "path": "napi/src/at_rule_parser.rs", "content": "use std::collections::HashMap;\n\nuse cssparser::*;\nuse lightningcss::{\n declaration::DeclarationBlock,\n error::ParserError,\n rules::{CssRuleList, Location},\n stylesheet::ParserOptions,\n traits::{AtRuleParser, ToCss},\n values::{\n string::CowArcStr,\n syntax::{ParsedComponent, SyntaxString},\n },\n};\nuse serde::{Deserialize, Deserializer, Serialize};\n\n#[derive(Deserialize, Debug, Clone)]\npub struct CustomAtRuleConfig {\n #[serde(default, deserialize_with = \"deserialize_prelude\")]\n prelude: Option,\n body: Option,\n}\n\nfn deserialize_prelude<'de, D>(deserializer: D) -> Result, D::Error>\nwhere\n D: Deserializer<'de>,\n{\n let s = Option::>::deserialize(deserializer)?;\n if let Some(s) = s {\n Ok(Some(\n SyntaxString::parse_string(&s).map_err(|_| serde::de::Error::custom(\"invalid syntax string\"))?,\n ))\n } else {\n Ok(None)\n }\n}\n\n#[derive(Deserialize, Debug, Clone)]\n#[serde(rename_all = \"kebab-case\")]\nenum CustomAtRuleBodyType {\n DeclarationList,\n RuleList,\n StyleBlock,\n}\n\npub struct Prelude<'i> {\n name: CowArcStr<'i>,\n prelude: Option>,\n}\n\n#[derive(Serialize, Deserialize, Clone)]\npub struct AtRule<'i> {\n #[serde(borrow)]\n pub name: CowArcStr<'i>,\n pub prelude: Option>,\n pub body: Option>,\n pub loc: Location,\n}\n\n#[derive(Serialize, Deserialize, Clone)]\n#[serde(tag = \"type\", content = \"value\", rename_all = \"kebab-case\")]\npub enum AtRuleBody<'i> {\n #[serde(borrow)]\n DeclarationList(DeclarationBlock<'i>),\n RuleList(CssRuleList<'i, AtRule<'i>>),\n}\n\n#[derive(Clone)]\npub struct CustomAtRuleParser {\n pub configs: HashMap,\n}\n\nimpl<'i> AtRuleParser<'i> for CustomAtRuleParser {\n type Prelude = Prelude<'i>;\n type Error = ParserError<'i>;\n type AtRule = AtRule<'i>;\n\n fn parse_prelude<'t>(\n &mut self,\n name: CowRcStr<'i>,\n input: &mut Parser<'i, 't>,\n _options: &ParserOptions<'_, 'i>,\n ) -> Result> {\n if let Some(config) = self.configs.get(name.as_ref()) {\n let prelude = if let Some(prelude) = &config.prelude {\n Some(prelude.parse_value(input)?)\n } else {\n None\n };\n Ok(Prelude {\n name: name.into(),\n prelude,\n })\n } else {\n Err(input.new_error(BasicParseErrorKind::AtRuleInvalid(name)))\n }\n }\n\n fn parse_block<'t>(\n &mut self,\n prelude: Self::Prelude,\n start: &ParserState,\n input: &mut Parser<'i, 't>,\n options: &ParserOptions<'_, 'i>,\n is_nested: bool,\n ) -> Result> {\n let config = self.configs.get(prelude.name.as_ref()).unwrap();\n let body = if let Some(body) = &config.body {\n match body {\n CustomAtRuleBodyType::DeclarationList => {\n Some(AtRuleBody::DeclarationList(DeclarationBlock::parse(input, options)?))\n }\n CustomAtRuleBodyType::RuleList => {\n Some(AtRuleBody::RuleList(CssRuleList::parse_with(input, options, self)?))\n }\n CustomAtRuleBodyType::StyleBlock => Some(AtRuleBody::RuleList(CssRuleList::parse_style_block_with(\n input, options, self, is_nested,\n )?)),\n }\n } else {\n return Err(input.new_error(BasicParseErrorKind::AtRuleBodyInvalid));\n };\n\n let loc = start.source_location();\n Ok(AtRule {\n name: prelude.name,\n prelude: prelude.prelude,\n body,\n loc: Location {\n source_index: options.source_index,\n line: loc.line,\n column: loc.column,\n },\n })\n }\n\n fn rule_without_block(\n &mut self,\n prelude: Self::Prelude,\n start: &ParserState,\n options: &ParserOptions<'_, 'i>,\n _is_nested: bool,\n ) -> Result {\n let config = self.configs.get(prelude.name.as_ref()).unwrap();\n if config.body.is_some() {\n return Err(());\n }\n\n let loc = start.source_location();\n Ok(AtRule {\n name: prelude.name,\n prelude: prelude.prelude,\n body: None,\n loc: Location {\n source_index: options.source_index,\n line: loc.line,\n column: loc.column,\n },\n })\n }\n}\n\nimpl<'i> ToCss for AtRule<'i> {\n fn to_css(\n &self,\n dest: &mut lightningcss::printer::Printer,\n ) -> Result<(), lightningcss::error::PrinterError>\n where\n W: std::fmt::Write,\n {\n dest.write_char('@')?;\n serialize_identifier(&self.name, dest)?;\n if let Some(prelude) = &self.prelude {\n dest.write_char(' ')?;\n prelude.to_css(dest)?;\n }\n\n if let Some(body) = &self.body {\n match body {\n AtRuleBody::DeclarationList(decls) => {\n decls.to_css_block(dest)?;\n }\n AtRuleBody::RuleList(rules) => {\n dest.whitespace()?;\n dest.write_char('{')?;\n dest.indent();\n dest.newline()?;\n rules.to_css(dest)?;\n dest.dedent();\n dest.newline()?;\n dest.write_char('}')?;\n }\n }\n }\n\n Ok(())\n }\n}\n\n#[cfg(feature = \"visitor\")]\nuse lightningcss::visitor::{Visit, VisitTypes, Visitor};\n\n#[cfg(feature = \"visitor\")]\nimpl<'i, V: Visitor<'i, AtRule<'i>>> Visit<'i, AtRule<'i>, V> for AtRule<'i> {\n const CHILD_TYPES: VisitTypes = VisitTypes::empty();\n\n fn visit_children(&mut self, visitor: &mut V) -> Result<(), V::Error> {\n self.prelude.visit(visitor)?;\n match &mut self.body {\n Some(AtRuleBody::DeclarationList(decls)) => decls.visit(visitor),\n Some(AtRuleBody::RuleList(rules)) => rules.visit(visitor),\n None => Ok(()),\n }\n }\n}\n" }, { "path": "napi/src/lib.rs", "content": "#[cfg(feature = \"bundler\")]\nuse at_rule_parser::AtRule;\nuse at_rule_parser::{CustomAtRuleConfig, CustomAtRuleParser};\nuse lightningcss::bundler::BundleErrorKind;\n#[cfg(feature = \"bundler\")]\nuse lightningcss::bundler::{Bundler, SourceProvider};\nuse lightningcss::css_modules::{CssModuleExports, CssModuleReferences, PatternParseError};\nuse lightningcss::dependencies::{Dependency, DependencyOptions};\nuse lightningcss::error::{Error, ErrorLocation, MinifyErrorKind, ParserError, PrinterErrorKind};\nuse lightningcss::stylesheet::{\n MinifyOptions, ParserFlags, ParserOptions, PrinterOptions, PseudoClasses, StyleAttribute, StyleSheet,\n};\nuse lightningcss::targets::{Browsers, Features, Targets};\nuse napi::bindgen_prelude::{FromNapiValue, ToNapiValue};\nuse napi::{CallContext, Env, JsObject, JsUnknown};\nuse parcel_sourcemap::SourceMap;\nuse serde::{Deserialize, Serialize};\nuse std::collections::{HashMap, HashSet};\nuse std::sync::{Arc, RwLock};\n\nmod at_rule_parser;\n#[cfg(feature = \"bundler\")]\n#[cfg(not(target_arch = \"wasm32\"))]\nmod threadsafe_function;\n#[cfg(feature = \"visitor\")]\nmod transformer;\nmod utils;\n\n#[cfg(feature = \"visitor\")]\nuse transformer::JsVisitor;\n\n#[cfg(not(feature = \"visitor\"))]\nstruct JsVisitor;\n\n#[cfg(feature = \"visitor\")]\nuse lightningcss::visitor::Visit;\n\nuse utils::get_named_property;\n\n#[derive(Serialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct TransformResult<'i> {\n #[serde(with = \"serde_bytes\")]\n code: Vec,\n #[serde(with = \"serde_bytes\")]\n map: Option>,\n exports: Option,\n references: Option,\n dependencies: Option>,\n warnings: Vec>,\n}\n\nimpl<'i> TransformResult<'i> {\n fn into_js(self, env: Env) -> napi::Result {\n // Manually construct buffers so we avoid a copy and work around\n // https://github.com/napi-rs/napi-rs/issues/1124.\n let mut obj = env.create_object()?;\n let buf = env.create_buffer_with_data(self.code)?;\n obj.set_named_property(\"code\", buf.into_raw())?;\n obj.set_named_property(\n \"map\",\n if let Some(map) = self.map {\n let buf = env.create_buffer_with_data(map)?;\n buf.into_raw().into_unknown()\n } else {\n env.get_null()?.into_unknown()\n },\n )?;\n obj.set_named_property(\"exports\", env.to_js_value(&self.exports)?)?;\n obj.set_named_property(\"references\", env.to_js_value(&self.references)?)?;\n obj.set_named_property(\"dependencies\", env.to_js_value(&self.dependencies)?)?;\n obj.set_named_property(\"warnings\", env.to_js_value(&self.warnings)?)?;\n Ok(obj.into_unknown())\n }\n}\n\n#[cfg(feature = \"visitor\")]\nfn get_visitor(env: Env, opts: &JsObject) -> Option {\n if let Ok(visitor) = get_named_property::(opts, \"visitor\") {\n Some(JsVisitor::new(env, visitor))\n } else {\n None\n }\n}\n\n#[cfg(not(feature = \"visitor\"))]\nfn get_visitor(_env: Env, _opts: &JsObject) -> Option {\n None\n}\n\npub fn transform(ctx: CallContext) -> napi::Result {\n let opts = ctx.get::(0)?;\n let mut visitor = get_visitor(*ctx.env, &opts);\n\n let config: Config = ctx.env.from_js_value(opts)?;\n let code = unsafe { std::str::from_utf8_unchecked(&config.code) };\n let res = compile(code, &config, &mut visitor);\n\n match res {\n Ok(res) => res.into_js(*ctx.env),\n Err(err) => Err(err.into_js_error(*ctx.env, Some(code))?),\n }\n}\n\npub fn transform_style_attribute(ctx: CallContext) -> napi::Result {\n let opts = ctx.get::(0)?;\n let mut visitor = get_visitor(*ctx.env, &opts);\n\n let config: AttrConfig = ctx.env.from_js_value(opts)?;\n let code = unsafe { std::str::from_utf8_unchecked(&config.code) };\n let res = compile_attr(code, &config, &mut visitor);\n\n match res {\n Ok(res) => res.into_js(ctx),\n Err(err) => Err(err.into_js_error(*ctx.env, Some(code))?),\n }\n}\n\n#[cfg(feature = \"bundler\")]\n#[cfg(not(target_arch = \"wasm32\"))]\nmod bundle {\n use super::*;\n use crossbeam_channel::{self, Receiver, Sender};\n use lightningcss::bundler::{FileProvider, ResolveResult};\n use napi::{Env, JsBoolean, JsFunction, JsString, NapiRaw};\n use std::path::{Path, PathBuf};\n use std::str::FromStr;\n use std::sync::Mutex;\n use threadsafe_function::{ThreadSafeCallContext, ThreadsafeFunction, ThreadsafeFunctionCallMode};\n\n pub fn bundle(ctx: CallContext) -> napi::Result {\n let opts = ctx.get::(0)?;\n let mut visitor = get_visitor(*ctx.env, &opts);\n\n let config: BundleConfig = ctx.env.from_js_value(opts)?;\n let fs = FileProvider::new();\n\n // This is pretty silly, but works around a rust limitation that you cannot\n // explicitly annotate lifetime bounds on closures.\n fn annotate<'i, 'o, F>(f: F) -> F\n where\n F: FnOnce(&mut StyleSheet<'i, 'o, AtRule<'i>>) -> napi::Result<()>,\n {\n f\n }\n\n let res = compile_bundle(\n &fs,\n &config,\n visitor.as_mut().map(|visitor| annotate(|stylesheet| stylesheet.visit(visitor))),\n );\n\n match res {\n Ok(res) => res.into_js(*ctx.env),\n Err(err) => Err(err.into_js_error(*ctx.env, None)?),\n }\n }\n\n // A SourceProvider which calls JavaScript functions to resolve and read files.\n struct JsSourceProvider {\n resolve: Option>,\n read: Option>,\n inputs: Mutex>,\n }\n\n unsafe impl Sync for JsSourceProvider {}\n unsafe impl Send for JsSourceProvider {}\n\n // Allocate a single channel per thread to communicate with the JS thread.\n thread_local! {\n static CHANNEL: (Sender>, Receiver>) = crossbeam_channel::unbounded();\n static RESOLVER_CHANNEL: (Sender>, Receiver>) = crossbeam_channel::unbounded();\n }\n\n impl SourceProvider for JsSourceProvider {\n type Error = napi::Error;\n\n fn read<'a>(&'a self, file: &Path) -> Result<&'a str, Self::Error> {\n let source = if let Some(read) = &self.read {\n CHANNEL.with(|channel| {\n let message = ReadMessage {\n file: file.to_str().unwrap().to_owned(),\n tx: channel.0.clone(),\n };\n\n read.call(message, ThreadsafeFunctionCallMode::Blocking);\n channel.1.recv().unwrap()\n })\n } else {\n Ok(std::fs::read_to_string(file)?)\n };\n\n match source {\n Ok(source) => {\n // cache the result\n let ptr = Box::into_raw(Box::new(source));\n self.inputs.lock().unwrap().push(ptr);\n // SAFETY: this is safe because the pointer is not dropped\n // until the JsSourceProvider is, and we never remove from the\n // list of pointers stored in the vector.\n Ok(unsafe { &*ptr })\n }\n Err(e) => Err(e),\n }\n }\n\n fn resolve(&self, specifier: &str, originating_file: &Path) -> Result {\n if let Some(resolve) = &self.resolve {\n return RESOLVER_CHANNEL.with(|channel| {\n let message = ResolveMessage {\n specifier: specifier.to_owned(),\n originating_file: originating_file.to_str().unwrap().to_owned(),\n tx: channel.0.clone(),\n };\n\n resolve.call(message, ThreadsafeFunctionCallMode::Blocking);\n channel.1.recv().unwrap()\n });\n }\n\n Ok(originating_file.with_file_name(specifier).into())\n }\n }\n\n struct ResolveMessage {\n specifier: String,\n originating_file: String,\n tx: Sender>,\n }\n\n struct ReadMessage {\n file: String,\n tx: Sender>,\n }\n\n struct VisitMessage {\n stylesheet: &'static mut StyleSheet<'static, 'static, AtRule<'static>>,\n tx: Sender>,\n }\n\n fn await_promise(env: Env, result: JsUnknown, tx: Sender>, parse: Cb) -> napi::Result<()>\n where\n T: 'static,\n Cb: 'static + Fn(JsUnknown) -> Result,\n {\n // If the result is a promise, wait for it to resolve, and send the result to the channel.\n // Otherwise, send the result immediately.\n if result.is_promise()? {\n let result: JsObject = result.try_into()?;\n let then: JsFunction = get_named_property(&result, \"then\")?;\n let tx2 = tx.clone();\n let cb = env.create_function_from_closure(\"callback\", move |ctx| {\n let res = parse(ctx.get::(0)?)?;\n tx.send(Ok(res)).unwrap();\n ctx.env.get_undefined()\n })?;\n let eb = env.create_function_from_closure(\"error_callback\", move |ctx| {\n let res = ctx.get::(0)?;\n tx2.send(Err(napi::Error::from(res))).unwrap();\n ctx.env.get_undefined()\n })?;\n then.call(Some(&result), &[cb, eb])?;\n } else {\n let result = parse(result)?;\n tx.send(Ok(result)).unwrap();\n }\n\n Ok(())\n }\n\n fn resolve_on_js_thread(ctx: ThreadSafeCallContext) -> napi::Result<()> {\n let specifier = ctx.env.create_string(&ctx.value.specifier)?;\n let originating_file = ctx.env.create_string(&ctx.value.originating_file)?;\n let result = ctx.callback.unwrap().call(None, &[specifier, originating_file])?;\n await_promise(ctx.env, result, ctx.value.tx, move |unknown| {\n ctx.env.from_js_value(unknown)\n })\n }\n\n fn handle_error(tx: Sender>, res: napi::Result<()>) -> napi::Result<()> {\n match res {\n Ok(_) => Ok(()),\n Err(e) => {\n tx.send(Err(e)).expect(\"send error\");\n Ok(())\n }\n }\n }\n\n fn resolve_on_js_thread_wrapper(ctx: ThreadSafeCallContext) -> napi::Result<()> {\n let tx = ctx.value.tx.clone();\n handle_error(tx, resolve_on_js_thread(ctx))\n }\n\n fn read_on_js_thread(ctx: ThreadSafeCallContext) -> napi::Result<()> {\n let file = ctx.env.create_string(&ctx.value.file)?;\n let result = ctx.callback.unwrap().call(None, &[file])?;\n await_promise(ctx.env, result, ctx.value.tx, |unknown| {\n JsString::try_from(unknown)?.into_utf8()?.into_owned()\n })\n }\n\n fn read_on_js_thread_wrapper(ctx: ThreadSafeCallContext) -> napi::Result<()> {\n let tx = ctx.value.tx.clone();\n handle_error(tx, read_on_js_thread(ctx))\n }\n\n pub fn bundle_async(ctx: CallContext) -> napi::Result {\n let opts = ctx.get::(0)?;\n let visitor = get_visitor(*ctx.env, &opts);\n\n let config: BundleConfig = ctx.env.from_js_value(&opts)?;\n\n if let Ok(resolver) = get_named_property::(&opts, \"resolver\") {\n let read = if resolver.has_named_property(\"read\")? {\n let read = get_named_property::(&resolver, \"read\")?;\n Some(ThreadsafeFunction::create(\n ctx.env.raw(),\n unsafe { read.raw() },\n 0,\n read_on_js_thread_wrapper,\n )?)\n } else {\n None\n };\n\n let resolve = if resolver.has_named_property(\"resolve\")? {\n let resolve = get_named_property::(&resolver, \"resolve\")?;\n Some(ThreadsafeFunction::create(\n ctx.env.raw(),\n unsafe { resolve.raw() },\n 0,\n resolve_on_js_thread_wrapper,\n )?)\n } else {\n None\n };\n\n let provider = JsSourceProvider {\n resolve,\n read,\n inputs: Mutex::new(Vec::new()),\n };\n\n run_bundle_task(provider, config, visitor, *ctx.env)\n } else {\n let provider = FileProvider::new();\n run_bundle_task(provider, config, visitor, *ctx.env)\n }\n }\n\n // Runs bundling on a background thread managed by rayon. This is similar to AsyncTask from napi-rs, however,\n // because we call back into the JS thread, which might call other tasks in the node threadpool (e.g. fs.readFile),\n // we may end up deadlocking if the number of rayon threads exceeds node's threadpool size. Therefore, we must\n // run bundling from a thread not managed by Node.\n fn run_bundle_task(\n provider: P,\n config: BundleConfig,\n visitor: Option,\n env: Env,\n ) -> napi::Result\n where\n P::Error: IntoJsError,\n {\n let (deferred, promise) = env.create_deferred()?;\n\n let tsfn = if let Some(mut visitor) = visitor {\n Some(ThreadsafeFunction::create(\n env.raw(),\n std::ptr::null_mut(),\n 0,\n move |ctx: ThreadSafeCallContext| {\n if let Err(err) = ctx.value.stylesheet.visit(&mut visitor) {\n ctx.value.tx.send(Err(err)).expect(\"send error\");\n return Ok(());\n }\n ctx.value.tx.send(Ok(Default::default())).expect(\"send error\");\n Ok(())\n },\n )?)\n } else {\n None\n };\n\n // Run bundling task in rayon threadpool.\n rayon::spawn(move || {\n let res = compile_bundle(\n unsafe { std::mem::transmute::<&'_ P, &'static P>(&provider) },\n &config,\n tsfn.map(move |tsfn| {\n move |stylesheet: &mut StyleSheet| {\n CHANNEL.with(|channel| {\n let message = VisitMessage {\n // SAFETY: we immediately lock the thread until we get a response,\n // so stylesheet cannot be dropped in that time.\n stylesheet: unsafe {\n std::mem::transmute::<\n &'_ mut StyleSheet<'_, '_, AtRule>,\n &'static mut StyleSheet<'static, 'static, AtRule>,\n >(stylesheet)\n },\n tx: channel.0.clone(),\n };\n\n tsfn.call(message, ThreadsafeFunctionCallMode::Blocking);\n channel.1.recv().expect(\"recv error\").map(|_| ())\n })\n }\n }),\n );\n\n deferred.resolve(move |env| match res {\n Ok(v) => v.into_js(env),\n Err(err) => Err(err.into_js_error(env, None)?),\n });\n });\n\n Ok(promise)\n }\n}\n\n#[cfg(feature = \"bundler\")]\n#[cfg(target_arch = \"wasm32\")]\nmod bundle {\n use super::*;\n use lightningcss::bundler::ResolveResult;\n use napi::{Env, JsFunction, JsString, NapiRaw, NapiValue, Ref};\n use std::cell::UnsafeCell;\n use std::path::Path;\n\n pub fn bundle(ctx: CallContext) -> napi::Result {\n let opts = ctx.get::(0)?;\n let mut visitor = get_visitor(*ctx.env, &opts);\n\n let resolver = get_named_property::(&opts, \"resolver\")?;\n let read = get_named_property::(&resolver, \"read\")?;\n let resolve = if resolver.has_named_property(\"resolve\")? {\n let resolve = get_named_property::(&resolver, \"resolve\")?;\n Some(ctx.env.create_reference(resolve)?)\n } else {\n None\n };\n let config: BundleConfig = ctx.env.from_js_value(opts)?;\n\n let provider = JsSourceProvider {\n env: ctx.env.clone(),\n resolve,\n read: ctx.env.create_reference(read)?,\n inputs: UnsafeCell::new(Vec::new()),\n };\n\n // This is pretty silly, but works around a rust limitation that you cannot\n // explicitly annotate lifetime bounds on closures.\n fn annotate<'i, 'o, F>(f: F) -> F\n where\n F: FnOnce(&mut StyleSheet<'i, 'o, AtRule<'i>>) -> napi::Result<()>,\n {\n f\n }\n\n let res = compile_bundle(\n &provider,\n &config,\n visitor.as_mut().map(|visitor| annotate(|stylesheet| stylesheet.visit(visitor))),\n );\n\n match res {\n Ok(res) => res.into_js(*ctx.env),\n Err(err) => Err(err.into_js_error(*ctx.env, None)?),\n }\n }\n\n struct JsSourceProvider {\n env: Env,\n resolve: Option>,\n read: Ref<()>,\n inputs: UnsafeCell>,\n }\n\n impl Drop for JsSourceProvider {\n fn drop(&mut self) {\n if let Some(resolve) = &mut self.resolve {\n drop(resolve.unref(self.env));\n }\n drop(self.read.unref(self.env));\n }\n }\n\n unsafe impl Sync for JsSourceProvider {}\n unsafe impl Send for JsSourceProvider {}\n\n // This relies on Binaryen's Asyncify transform to allow Rust to call async JS functions from sync code.\n // See the comments in async.mjs for more details about how this works.\n extern \"C\" {\n fn await_promise_sync(\n promise: napi::sys::napi_value,\n result: *mut napi::sys::napi_value,\n error: *mut napi::sys::napi_value,\n );\n }\n\n fn get_result(env: Env, mut value: JsUnknown) -> napi::Result {\n if value.is_promise()? {\n let mut result = std::ptr::null_mut();\n let mut error = std::ptr::null_mut();\n unsafe { await_promise_sync(value.raw(), &mut result, &mut error) };\n if !error.is_null() {\n let error = unsafe { JsUnknown::from_raw(env.raw(), error)? };\n return Err(napi::Error::from(error));\n }\n if result.is_null() {\n return Err(napi::Error::new(napi::Status::GenericFailure, \"No result\".to_string()));\n }\n\n value = unsafe { JsUnknown::from_raw(env.raw(), result)? };\n }\n\n Ok(value)\n }\n\n impl SourceProvider for JsSourceProvider {\n type Error = napi::Error;\n\n fn read<'a>(&'a self, file: &Path) -> Result<&'a str, Self::Error> {\n let read: JsFunction = self.env.get_reference_value_unchecked(&self.read)?;\n let file = self.env.create_string(file.to_str().unwrap())?;\n let source: JsUnknown = read.call(None, &[file])?;\n let source = get_result(self.env, source)?;\n let source: JsString = source.try_into()?;\n let source = source.into_utf8()?.into_owned()?;\n\n // cache the result\n let ptr = Box::into_raw(Box::new(source));\n let inputs = unsafe { &mut *self.inputs.get() };\n inputs.push(ptr);\n // SAFETY: this is safe because the pointer is not dropped\n // until the JsSourceProvider is, and we never remove from the\n // list of pointers stored in the vector.\n Ok(unsafe { &*ptr })\n }\n\n fn resolve(&self, specifier: &str, originating_file: &Path) -> Result {\n if let Some(resolve) = &self.resolve {\n let resolve: JsFunction = self.env.get_reference_value_unchecked(resolve)?;\n let specifier = self.env.create_string(specifier)?;\n let originating_file = self.env.create_string(originating_file.to_str().unwrap())?;\n let result: JsUnknown = resolve.call(None, &[specifier, originating_file])?;\n let result = get_result(self.env, result)?;\n let result = self.env.from_js_value(result)?;\n Ok(result)\n } else {\n Ok(ResolveResult::File(originating_file.with_file_name(specifier)))\n }\n }\n }\n}\n\n#[cfg(feature = \"bundler\")]\npub use bundle::*;\n\n// ---------------------------------------------\n\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct Config {\n pub filename: Option,\n pub project_root: Option,\n #[serde(with = \"serde_bytes\")]\n pub code: Vec,\n pub targets: Option,\n #[serde(default)]\n pub include: u32,\n #[serde(default)]\n pub exclude: u32,\n pub minify: Option,\n pub source_map: Option,\n pub input_source_map: Option,\n pub drafts: Option,\n pub non_standard: Option,\n pub css_modules: Option,\n pub analyze_dependencies: Option,\n pub pseudo_classes: Option,\n pub unused_symbols: Option>,\n pub error_recovery: Option,\n pub custom_at_rules: Option>,\n}\n\n#[derive(Debug, Deserialize)]\n#[serde(untagged)]\nenum AnalyzeDependenciesOption {\n Bool(bool),\n Config(AnalyzeDependenciesConfig),\n}\n\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct AnalyzeDependenciesConfig {\n preserve_imports: bool,\n}\n\n#[derive(Debug, Deserialize)]\n#[serde(untagged)]\nenum CssModulesOption {\n Bool(bool),\n Config(CssModulesConfig),\n}\n\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct CssModulesConfig {\n pattern: Option,\n dashed_idents: Option,\n animation: Option,\n container: Option,\n grid: Option,\n custom_idents: Option,\n pure: Option,\n}\n\n#[cfg(feature = \"bundler\")]\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct BundleConfig {\n pub filename: String,\n pub project_root: Option,\n pub targets: Option,\n #[serde(default)]\n pub include: u32,\n #[serde(default)]\n pub exclude: u32,\n pub minify: Option,\n pub source_map: Option,\n pub drafts: Option,\n pub non_standard: Option,\n pub css_modules: Option,\n pub analyze_dependencies: Option,\n pub pseudo_classes: Option,\n pub unused_symbols: Option>,\n pub error_recovery: Option,\n pub custom_at_rules: Option>,\n}\n\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct OwnedPseudoClasses {\n pub hover: Option,\n pub active: Option,\n pub focus: Option,\n pub focus_visible: Option,\n pub focus_within: Option,\n}\n\nimpl<'a> Into> for &'a OwnedPseudoClasses {\n fn into(self) -> PseudoClasses<'a> {\n PseudoClasses {\n hover: self.hover.as_deref(),\n active: self.active.as_deref(),\n focus: self.focus.as_deref(),\n focus_visible: self.focus_visible.as_deref(),\n focus_within: self.focus_within.as_deref(),\n }\n }\n}\n\n#[derive(Serialize, Debug, Deserialize, Default)]\n#[serde(rename_all = \"camelCase\")]\nstruct Drafts {\n #[serde(default)]\n custom_media: bool,\n}\n\n#[derive(Serialize, Debug, Deserialize, Default)]\n#[serde(rename_all = \"camelCase\")]\nstruct NonStandard {\n #[serde(default)]\n deep_selector_combinator: bool,\n}\n\nfn compile<'i>(\n code: &'i str,\n config: &Config,\n #[allow(unused_variables)] visitor: &mut Option,\n) -> Result, CompileError<'i, napi::Error>> {\n let drafts = config.drafts.as_ref();\n let non_standard = config.non_standard.as_ref();\n let warnings = Some(Arc::new(RwLock::new(Vec::new())));\n\n let filename = config.filename.clone().unwrap_or_default();\n let project_root = config.project_root.as_ref().map(|p| p.as_ref());\n let mut source_map = if config.source_map.unwrap_or_default() {\n let mut sm = SourceMap::new(project_root.unwrap_or(\"/\"));\n sm.add_source(&filename);\n sm.set_source_content(0, code)?;\n Some(sm)\n } else {\n None\n };\n\n let res = {\n let mut flags = ParserFlags::empty();\n flags.set(ParserFlags::CUSTOM_MEDIA, matches!(drafts, Some(d) if d.custom_media));\n flags.set(\n ParserFlags::DEEP_SELECTOR_COMBINATOR,\n matches!(non_standard, Some(v) if v.deep_selector_combinator),\n );\n\n let mut stylesheet = StyleSheet::parse_with(\n &code,\n ParserOptions {\n filename: filename.clone(),\n flags,\n css_modules: if let Some(css_modules) = &config.css_modules {\n match css_modules {\n CssModulesOption::Bool(true) => Some(lightningcss::css_modules::Config::default()),\n CssModulesOption::Bool(false) => None,\n CssModulesOption::Config(c) => Some(lightningcss::css_modules::Config {\n pattern: if let Some(pattern) = c.pattern.as_ref() {\n match lightningcss::css_modules::Pattern::parse(pattern) {\n Ok(p) => p,\n Err(e) => return Err(CompileError::PatternError(e)),\n }\n } else {\n Default::default()\n },\n dashed_idents: c.dashed_idents.unwrap_or_default(),\n animation: c.animation.unwrap_or(true),\n container: c.container.unwrap_or(true),\n grid: c.grid.unwrap_or(true),\n custom_idents: c.custom_idents.unwrap_or(true),\n pure: c.pure.unwrap_or_default(),\n }),\n }\n } else {\n None\n },\n source_index: 0,\n error_recovery: config.error_recovery.unwrap_or_default(),\n warnings: warnings.clone(),\n },\n &mut CustomAtRuleParser {\n configs: config.custom_at_rules.clone().unwrap_or_default(),\n },\n )?;\n\n #[cfg(feature = \"visitor\")]\n if let Some(visitor) = visitor.as_mut() {\n stylesheet.visit(visitor).map_err(CompileError::JsError)?;\n }\n\n let targets = Targets {\n browsers: config.targets,\n include: Features::from_bits_truncate(config.include),\n exclude: Features::from_bits_truncate(config.exclude),\n };\n\n stylesheet.minify(MinifyOptions {\n targets,\n unused_symbols: config.unused_symbols.clone().unwrap_or_default(),\n })?;\n\n stylesheet.to_css(PrinterOptions {\n minify: config.minify.unwrap_or_default(),\n source_map: source_map.as_mut(),\n project_root,\n targets,\n analyze_dependencies: if let Some(d) = &config.analyze_dependencies {\n match d {\n AnalyzeDependenciesOption::Bool(b) if *b => Some(DependencyOptions { remove_imports: true }),\n AnalyzeDependenciesOption::Config(c) => Some(DependencyOptions {\n remove_imports: !c.preserve_imports,\n }),\n _ => None,\n }\n } else {\n None\n },\n pseudo_classes: config.pseudo_classes.as_ref().map(|p| p.into()),\n })?\n };\n\n let map = if let Some(mut source_map) = source_map {\n if let Some(input_source_map) = &config.input_source_map {\n if let Ok(mut sm) = SourceMap::from_json(\"/\", input_source_map) {\n let _ = source_map.extends(&mut sm);\n }\n }\n\n source_map.to_json(None).ok()\n } else {\n None\n };\n\n Ok(TransformResult {\n code: res.code.into_bytes(),\n map: map.map(|m| m.into_bytes()),\n exports: res.exports,\n references: res.references,\n dependencies: res.dependencies,\n warnings: warnings.map_or(Vec::new(), |w| {\n Arc::try_unwrap(w)\n .unwrap()\n .into_inner()\n .unwrap()\n .into_iter()\n .map(|w| w.into())\n .collect()\n }),\n })\n}\n\n#[cfg(feature = \"bundler\")]\nfn compile_bundle<\n 'i,\n 'o,\n P: SourceProvider,\n F: FnOnce(&mut StyleSheet<'i, 'o, AtRule<'i>>) -> napi::Result<()>,\n>(\n fs: &'i P,\n config: &'o BundleConfig,\n visit: Option,\n) -> Result, CompileError<'i, P::Error>> {\n use std::path::Path;\n\n let project_root = config.project_root.as_ref().map(|p| p.as_ref());\n let mut source_map = if config.source_map.unwrap_or_default() {\n Some(SourceMap::new(project_root.unwrap_or(\"/\")))\n } else {\n None\n };\n let warnings = Some(Arc::new(RwLock::new(Vec::new())));\n\n let res = {\n let drafts = config.drafts.as_ref();\n let non_standard = config.non_standard.as_ref();\n let mut flags = ParserFlags::empty();\n flags.set(ParserFlags::CUSTOM_MEDIA, matches!(drafts, Some(d) if d.custom_media));\n flags.set(\n ParserFlags::DEEP_SELECTOR_COMBINATOR,\n matches!(non_standard, Some(v) if v.deep_selector_combinator),\n );\n\n let parser_options = ParserOptions {\n flags,\n css_modules: if let Some(css_modules) = &config.css_modules {\n match css_modules {\n CssModulesOption::Bool(true) => Some(lightningcss::css_modules::Config::default()),\n CssModulesOption::Bool(false) => None,\n CssModulesOption::Config(c) => Some(lightningcss::css_modules::Config {\n pattern: if let Some(pattern) = c.pattern.as_ref() {\n match lightningcss::css_modules::Pattern::parse(pattern) {\n Ok(p) => p,\n Err(e) => return Err(CompileError::PatternError(e)),\n }\n } else {\n Default::default()\n },\n dashed_idents: c.dashed_idents.unwrap_or_default(),\n animation: c.animation.unwrap_or(true),\n container: c.container.unwrap_or(true),\n grid: c.grid.unwrap_or(true),\n custom_idents: c.custom_idents.unwrap_or(true),\n pure: c.pure.unwrap_or_default(),\n }),\n }\n } else {\n None\n },\n error_recovery: config.error_recovery.unwrap_or_default(),\n warnings: warnings.clone(),\n filename: String::new(),\n source_index: 0,\n };\n\n let mut at_rule_parser = CustomAtRuleParser {\n configs: config.custom_at_rules.clone().unwrap_or_default(),\n };\n\n let mut bundler =\n Bundler::new_with_at_rule_parser(fs, source_map.as_mut(), parser_options, &mut at_rule_parser);\n let mut stylesheet = bundler.bundle(Path::new(&config.filename))?;\n\n if let Some(visit) = visit {\n visit(&mut stylesheet).map_err(CompileError::JsError)?;\n }\n\n let targets = Targets {\n browsers: config.targets,\n include: Features::from_bits_truncate(config.include),\n exclude: Features::from_bits_truncate(config.exclude),\n };\n\n stylesheet.minify(MinifyOptions {\n targets,\n unused_symbols: config.unused_symbols.clone().unwrap_or_default(),\n })?;\n\n stylesheet.to_css(PrinterOptions {\n minify: config.minify.unwrap_or_default(),\n source_map: source_map.as_mut(),\n project_root,\n targets,\n analyze_dependencies: if let Some(d) = &config.analyze_dependencies {\n match d {\n AnalyzeDependenciesOption::Bool(b) if *b => Some(DependencyOptions { remove_imports: true }),\n AnalyzeDependenciesOption::Config(c) => Some(DependencyOptions {\n remove_imports: !c.preserve_imports,\n }),\n _ => None,\n }\n } else {\n None\n },\n pseudo_classes: config.pseudo_classes.as_ref().map(|p| p.into()),\n })?\n };\n\n let map = if let Some(source_map) = &mut source_map {\n source_map.to_json(None).ok()\n } else {\n None\n };\n\n Ok(TransformResult {\n code: res.code.into_bytes(),\n map: map.map(|m| m.into_bytes()),\n exports: res.exports,\n references: res.references,\n dependencies: res.dependencies,\n warnings: warnings.map_or(Vec::new(), |w| {\n Arc::try_unwrap(w)\n .unwrap()\n .into_inner()\n .unwrap()\n .into_iter()\n .map(|w| w.into())\n .collect()\n }),\n })\n}\n\n#[derive(Debug, Deserialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct AttrConfig {\n pub filename: Option,\n #[serde(with = \"serde_bytes\")]\n pub code: Vec,\n pub targets: Option,\n #[serde(default)]\n pub include: u32,\n #[serde(default)]\n pub exclude: u32,\n #[serde(default)]\n pub minify: bool,\n #[serde(default)]\n pub analyze_dependencies: bool,\n #[serde(default)]\n pub error_recovery: bool,\n}\n\n#[derive(Serialize)]\n#[serde(rename_all = \"camelCase\")]\nstruct AttrResult<'i> {\n #[serde(with = \"serde_bytes\")]\n code: Vec,\n dependencies: Option>,\n warnings: Vec>,\n}\n\nimpl<'i> AttrResult<'i> {\n fn into_js(self, ctx: CallContext) -> napi::Result {\n // Manually construct buffers so we avoid a copy and work around\n // https://github.com/napi-rs/napi-rs/issues/1124.\n let mut obj = ctx.env.create_object()?;\n let buf = ctx.env.create_buffer_with_data(self.code)?;\n obj.set_named_property(\"code\", buf.into_raw())?;\n obj.set_named_property(\"dependencies\", ctx.env.to_js_value(&self.dependencies)?)?;\n obj.set_named_property(\"warnings\", ctx.env.to_js_value(&self.warnings)?)?;\n Ok(obj.into_unknown())\n }\n}\n\nfn compile_attr<'i>(\n code: &'i str,\n config: &AttrConfig,\n #[allow(unused_variables)] visitor: &mut Option,\n) -> Result, CompileError<'i, napi::Error>> {\n let warnings = if config.error_recovery {\n Some(Arc::new(RwLock::new(Vec::new())))\n } else {\n None\n };\n let res = {\n let filename = config.filename.clone().unwrap_or_default();\n let mut attr = StyleAttribute::parse(\n &code,\n ParserOptions {\n filename,\n error_recovery: config.error_recovery,\n warnings: warnings.clone(),\n ..ParserOptions::default()\n },\n )?;\n\n #[cfg(feature = \"visitor\")]\n if let Some(visitor) = visitor.as_mut() {\n attr.visit(visitor).unwrap();\n }\n\n let targets = Targets {\n browsers: config.targets,\n include: Features::from_bits_truncate(config.include),\n exclude: Features::from_bits_truncate(config.exclude),\n };\n\n attr.minify(MinifyOptions {\n targets,\n ..MinifyOptions::default()\n });\n attr.to_css(PrinterOptions {\n minify: config.minify,\n source_map: None,\n project_root: None,\n targets,\n analyze_dependencies: if config.analyze_dependencies {\n Some(DependencyOptions::default())\n } else {\n None\n },\n pseudo_classes: None,\n })?\n };\n Ok(AttrResult {\n code: res.code.into_bytes(),\n dependencies: res.dependencies,\n warnings: warnings.map_or(Vec::new(), |w| {\n Arc::try_unwrap(w)\n .unwrap()\n .into_inner()\n .unwrap()\n .into_iter()\n .map(|w| w.into())\n .collect()\n }),\n })\n}\n\nenum CompileError<'i, E: std::error::Error> {\n ParseError(Error>),\n MinifyError(Error),\n PrinterError(Error),\n SourceMapError(parcel_sourcemap::SourceMapError),\n BundleError(Error>),\n PatternError(PatternParseError),\n #[cfg(feature = \"visitor\")]\n JsError(napi::Error),\n}\n\nimpl<'i, E: std::error::Error> std::fmt::Display for CompileError<'i, E> {\n fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {\n match self {\n CompileError::ParseError(err) => err.kind.fmt(f),\n CompileError::MinifyError(err) => err.kind.fmt(f),\n CompileError::PrinterError(err) => err.kind.fmt(f),\n CompileError::BundleError(err) => err.kind.fmt(f),\n CompileError::PatternError(err) => err.fmt(f),\n CompileError::SourceMapError(err) => write!(f, \"{}\", err.to_string()), // TODO: switch to `fmt::Display` once parcel_sourcemap supports this\n #[cfg(feature = \"visitor\")]\n CompileError::JsError(err) => std::fmt::Debug::fmt(&err, f),\n }\n }\n}\n\nimpl<'i, E: IntoJsError + std::error::Error> CompileError<'i, E> {\n fn into_js_error(self, env: Env, code: Option<&str>) -> napi::Result {\n let reason = self.to_string();\n let data = match &self {\n CompileError::ParseError(Error { kind, .. }) => env.to_js_value(kind)?,\n CompileError::PrinterError(Error { kind, .. }) => env.to_js_value(kind)?,\n CompileError::MinifyError(Error { kind, .. }) => env.to_js_value(kind)?,\n CompileError::BundleError(Error { kind, .. }) => env.to_js_value(kind)?,\n _ => env.get_null()?.into_unknown(),\n };\n\n let (js_error, loc) = match self {\n CompileError::BundleError(Error {\n loc,\n kind: BundleErrorKind::ResolverError(e),\n }) => {\n // Add location info to existing JS error if available.\n (e.into_js_error(env)?, loc)\n }\n CompileError::ParseError(Error { loc, .. })\n | CompileError::PrinterError(Error { loc, .. })\n | CompileError::MinifyError(Error { loc, .. })\n | CompileError::BundleError(Error { loc, .. }) => {\n // Generate an error with location information.\n let syntax_error = env.get_global()?.get_named_property::(\"SyntaxError\")?;\n let reason = env.create_string_from_std(reason)?;\n let obj = syntax_error.new_instance(&[reason])?;\n (obj.into_unknown(), loc)\n }\n _ => return Ok(self.into()),\n };\n\n if js_error.get_type()? == napi::ValueType::Object {\n let mut obj: JsObject = unsafe { js_error.cast() };\n if let Some(loc) = loc {\n let line = env.create_int32((loc.line + 1) as i32)?;\n let col = env.create_int32(loc.column as i32)?;\n let filename = env.create_string_from_std(loc.filename)?;\n obj.set_named_property(\"fileName\", filename)?;\n if let Some(code) = code {\n let source = env.create_string(code)?;\n obj.set_named_property(\"source\", source)?;\n }\n let mut loc = env.create_object()?;\n loc.set_named_property(\"line\", line)?;\n loc.set_named_property(\"column\", col)?;\n obj.set_named_property(\"loc\", loc)?;\n }\n obj.set_named_property(\"data\", data)?;\n Ok(obj.into_unknown().into())\n } else {\n Ok(js_error.into())\n }\n }\n}\n\ntrait IntoJsError {\n fn into_js_error(self, env: Env) -> napi::Result;\n}\n\nimpl IntoJsError for std::io::Error {\n fn into_js_error(self, env: Env) -> napi::Result {\n let reason = self.to_string();\n let syntax_error = env.get_global()?.get_named_property::(\"SyntaxError\")?;\n let reason = env.create_string_from_std(reason)?;\n let obj = syntax_error.new_instance(&[reason])?;\n Ok(obj.into_unknown())\n }\n}\n\nimpl IntoJsError for napi::Error {\n fn into_js_error(self, env: Env) -> napi::Result {\n unsafe { JsUnknown::from_napi_value(env.raw(), ToNapiValue::to_napi_value(env.raw(), self)?) }\n }\n}\n\nimpl<'i, E: std::error::Error> From>> for CompileError<'i, E> {\n fn from(e: Error>) -> CompileError<'i, E> {\n CompileError::ParseError(e)\n }\n}\n\nimpl<'i, E: std::error::Error> From> for CompileError<'i, E> {\n fn from(err: Error) -> CompileError<'i, E> {\n CompileError::MinifyError(err)\n }\n}\n\nimpl<'i, E: std::error::Error> From> for CompileError<'i, E> {\n fn from(err: Error) -> CompileError<'i, E> {\n CompileError::PrinterError(err)\n }\n}\n\nimpl<'i, E: std::error::Error> From for CompileError<'i, E> {\n fn from(e: parcel_sourcemap::SourceMapError) -> CompileError<'i, E> {\n CompileError::SourceMapError(e)\n }\n}\n\nimpl<'i, E: std::error::Error> From>> for CompileError<'i, E> {\n fn from(e: Error>) -> CompileError<'i, E> {\n CompileError::BundleError(e)\n }\n}\n\nimpl<'i, E: std::error::Error> From> for napi::Error {\n fn from(e: CompileError<'i, E>) -> napi::Error {\n match e {\n CompileError::SourceMapError(e) => napi::Error::from_reason(e.to_string()),\n CompileError::PatternError(e) => napi::Error::from_reason(e.to_string()),\n #[cfg(feature = \"visitor\")]\n CompileError::JsError(e) => e,\n _ => napi::Error::new(napi::Status::GenericFailure, e.to_string()),\n }\n }\n}\n\n#[derive(Serialize)]\nstruct Warning<'i> {\n message: String,\n #[serde(flatten)]\n data: ParserError<'i>,\n loc: Option,\n}\n\nimpl<'i> From>> for Warning<'i> {\n fn from(mut e: Error>) -> Self {\n // Convert to 1-based line numbers.\n if let Some(loc) = &mut e.loc {\n loc.line += 1;\n }\n Warning {\n message: e.kind.to_string(),\n data: e.kind,\n loc: e.loc,\n }\n }\n}\n" }, { "path": "napi/src/threadsafe_function.rs", "content": "// Fork of threadsafe_function from napi-rs that allows calling JS function manually rather than\n// only returning args. This enables us to use the return value of the function.\n\n#![allow(clippy::single_component_path_imports)]\n\nuse std::convert::Into;\nuse std::ffi::CString;\nuse std::marker::PhantomData;\nuse std::os::raw::c_void;\nuse std::ptr;\nuse std::sync::atomic::{AtomicBool, AtomicUsize, Ordering};\nuse std::sync::Arc;\n\nuse napi::{check_status, sys, Env, Result, Status};\nuse napi::{JsError, JsFunction, NapiValue};\n\n/// ThreadSafeFunction Context object\n/// the `value` is the value passed to `call` method\npub struct ThreadSafeCallContext {\n pub env: Env,\n pub value: T,\n pub callback: Option,\n}\n\n#[repr(u8)]\npub enum ThreadsafeFunctionCallMode {\n NonBlocking,\n Blocking,\n}\n\nimpl From for sys::napi_threadsafe_function_call_mode {\n fn from(value: ThreadsafeFunctionCallMode) -> Self {\n match value {\n ThreadsafeFunctionCallMode::Blocking => sys::ThreadsafeFunctionCallMode::blocking,\n ThreadsafeFunctionCallMode::NonBlocking => sys::ThreadsafeFunctionCallMode::nonblocking,\n }\n }\n}\n\n/// Communicate with the addon's main thread by invoking a JavaScript function from other threads.\n///\n/// ## Example\n/// An example of using `ThreadsafeFunction`:\n///\n/// ```rust\n/// #[macro_use]\n/// extern crate napi_derive;\n///\n/// use std::thread;\n///\n/// use napi::{\n/// threadsafe_function::{\n/// ThreadSafeCallContext, ThreadsafeFunctionCallMode, ThreadsafeFunctionReleaseMode,\n/// },\n/// CallContext, Error, JsFunction, JsNumber, JsUndefined, Result, Status,\n/// };\n///\n/// #[js_function(1)]\n/// pub fn test_threadsafe_function(ctx: CallContext) -> Result {\n/// let func = ctx.get::(0)?;\n///\n/// let tsfn =\n/// ctx\n/// .env\n/// .create_threadsafe_function(&func, 0, |ctx: ThreadSafeCallContext>| {\n/// ctx.value\n/// .iter()\n/// .map(|v| ctx.env.create_uint32(*v))\n/// .collect::>>()\n/// })?;\n///\n/// let tsfn_cloned = tsfn.clone();\n///\n/// thread::spawn(move || {\n/// let output: Vec = vec![0, 1, 2, 3];\n/// // It's okay to call a threadsafe function multiple times.\n/// tsfn.call(Ok(output.clone()), ThreadsafeFunctionCallMode::Blocking);\n/// });\n///\n/// thread::spawn(move || {\n/// let output: Vec = vec![3, 2, 1, 0];\n/// // It's okay to call a threadsafe function multiple times.\n/// tsfn_cloned.call(Ok(output.clone()), ThreadsafeFunctionCallMode::NonBlocking);\n/// });\n///\n/// ctx.env.get_undefined()\n/// }\n/// ```\npub struct ThreadsafeFunction {\n raw_tsfn: sys::napi_threadsafe_function,\n aborted: Arc,\n ref_count: Arc,\n _phantom: PhantomData,\n}\n\nimpl Clone for ThreadsafeFunction {\n fn clone(&self) -> Self {\n if !self.aborted.load(Ordering::Acquire) {\n let acquire_status = unsafe { sys::napi_acquire_threadsafe_function(self.raw_tsfn) };\n debug_assert!(\n acquire_status == sys::Status::napi_ok,\n \"Acquire threadsafe function failed in clone\"\n );\n }\n\n Self {\n raw_tsfn: self.raw_tsfn,\n aborted: Arc::clone(&self.aborted),\n ref_count: Arc::clone(&self.ref_count),\n _phantom: PhantomData,\n }\n }\n}\n\nunsafe impl Send for ThreadsafeFunction {}\nunsafe impl Sync for ThreadsafeFunction {}\n\nimpl ThreadsafeFunction {\n /// See [napi_create_threadsafe_function](https://nodejs.org/api/n-api.html#n_api_napi_create_threadsafe_function)\n /// for more information.\n pub(crate) fn create) -> Result<()>>(\n env: sys::napi_env,\n func: sys::napi_value,\n max_queue_size: usize,\n callback: R,\n ) -> Result {\n let mut async_resource_name = ptr::null_mut();\n let s = \"napi_rs_threadsafe_function\";\n let len = s.len();\n let s = CString::new(s)?;\n check_status!(unsafe { sys::napi_create_string_utf8(env, s.as_ptr(), len, &mut async_resource_name) })?;\n\n let initial_thread_count = 1usize;\n let mut raw_tsfn = ptr::null_mut();\n let ptr = Box::into_raw(Box::new(callback)) as *mut c_void;\n check_status!(unsafe {\n sys::napi_create_threadsafe_function(\n env,\n func,\n ptr::null_mut(),\n async_resource_name,\n max_queue_size,\n initial_thread_count,\n ptr,\n Some(thread_finalize_cb::),\n ptr,\n Some(call_js_cb::),\n &mut raw_tsfn,\n )\n })?;\n\n let aborted = Arc::new(AtomicBool::new(false));\n let aborted_ptr = Arc::into_raw(aborted.clone()) as *mut c_void;\n check_status!(unsafe { sys::napi_add_env_cleanup_hook(env, Some(cleanup_cb), aborted_ptr) })?;\n\n Ok(ThreadsafeFunction {\n raw_tsfn,\n aborted,\n ref_count: Arc::new(AtomicUsize::new(initial_thread_count)),\n _phantom: PhantomData,\n })\n }\n}\n\nimpl ThreadsafeFunction {\n /// See [napi_call_threadsafe_function](https://nodejs.org/api/n-api.html#n_api_napi_call_threadsafe_function)\n /// for more information.\n pub fn call(&self, value: T, mode: ThreadsafeFunctionCallMode) -> Status {\n if self.aborted.load(Ordering::Acquire) {\n return Status::Closing;\n }\n unsafe {\n sys::napi_call_threadsafe_function(self.raw_tsfn, Box::into_raw(Box::new(value)) as *mut _, mode.into())\n }\n .into()\n }\n}\n\nimpl Drop for ThreadsafeFunction {\n fn drop(&mut self) {\n if !self.aborted.load(Ordering::Acquire) && self.ref_count.load(Ordering::Acquire) > 0usize {\n let release_status = unsafe {\n sys::napi_release_threadsafe_function(self.raw_tsfn, sys::ThreadsafeFunctionReleaseMode::release)\n };\n assert!(\n release_status == sys::Status::napi_ok,\n \"Threadsafe Function release failed\"\n );\n }\n }\n}\n\nunsafe extern \"C\" fn cleanup_cb(cleanup_data: *mut c_void) {\n let aborted = Arc::::from_raw(cleanup_data.cast());\n aborted.store(true, Ordering::SeqCst);\n}\n\nunsafe extern \"C\" fn thread_finalize_cb(\n _raw_env: sys::napi_env,\n finalize_data: *mut c_void,\n _finalize_hint: *mut c_void,\n) where\n R: 'static + Send + FnMut(ThreadSafeCallContext) -> Result<()>,\n{\n // cleanup\n drop(Box::::from_raw(finalize_data.cast()));\n}\n\nunsafe extern \"C\" fn call_js_cb(\n raw_env: sys::napi_env,\n js_callback: sys::napi_value,\n context: *mut c_void,\n data: *mut c_void,\n) where\n R: 'static + Send + FnMut(ThreadSafeCallContext) -> Result<()>,\n{\n // env and/or callback can be null when shutting down\n if raw_env.is_null() {\n return;\n }\n\n let ctx: &mut R = &mut *context.cast::();\n let val: Result = Ok(*Box::::from_raw(data.cast()));\n\n let mut recv = ptr::null_mut();\n sys::napi_get_undefined(raw_env, &mut recv);\n\n let ret = val.and_then(|v| {\n (ctx)(ThreadSafeCallContext {\n env: Env::from_raw(raw_env),\n value: v,\n callback: if js_callback.is_null() {\n None\n } else {\n Some(JsFunction::from_raw(raw_env, js_callback).unwrap()) // TODO: unwrap\n },\n })\n });\n\n let status = match ret {\n Ok(()) => sys::Status::napi_ok,\n Err(e) => sys::napi_fatal_exception(raw_env, JsError::from(e).into_value(raw_env)),\n };\n if status == sys::Status::napi_ok {\n return;\n }\n if status == sys::Status::napi_pending_exception {\n let mut error_result = ptr::null_mut();\n assert_eq!(\n sys::napi_get_and_clear_last_exception(raw_env, &mut error_result),\n sys::Status::napi_ok\n );\n\n // When shutting down, napi_fatal_exception sometimes returns another exception\n let stat = sys::napi_fatal_exception(raw_env, error_result);\n assert!(stat == sys::Status::napi_ok || stat == sys::Status::napi_pending_exception);\n } else {\n let error_code: Status = status.into();\n let error_code_string = format!(\"{:?}\", error_code);\n let mut error_code_value = ptr::null_mut();\n assert_eq!(\n sys::napi_create_string_utf8(\n raw_env,\n error_code_string.as_ptr() as *const _,\n error_code_string.len(),\n &mut error_code_value,\n ),\n sys::Status::napi_ok,\n );\n let error_msg = \"Call JavaScript callback failed in thread safe function\";\n let mut error_msg_value = ptr::null_mut();\n assert_eq!(\n sys::napi_create_string_utf8(\n raw_env,\n error_msg.as_ptr() as *const _,\n error_msg.len(),\n &mut error_msg_value,\n ),\n sys::Status::napi_ok,\n );\n let mut error_value = ptr::null_mut();\n assert_eq!(\n sys::napi_create_error(raw_env, error_code_value, error_msg_value, &mut error_value),\n sys::Status::napi_ok,\n );\n assert_eq!(sys::napi_fatal_exception(raw_env, error_value), sys::Status::napi_ok);\n }\n}\n" }, { "path": "napi/src/transformer.rs", "content": "use std::{\n marker::PhantomData,\n ops::{Index, IndexMut},\n};\n\nuse lightningcss::{\n media_query::MediaFeatureValue,\n properties::{\n custom::{Token, TokenList, TokenOrValue},\n Property,\n },\n rules::{CssRule, CssRuleList},\n stylesheet::ParserOptions,\n traits::ParseWithOptions,\n values::{\n ident::Ident,\n length::{Length, LengthValue},\n string::CowArcStr,\n },\n visitor::{Visit, VisitTypes, Visitor},\n};\nuse lightningcss::{stylesheet::StyleSheet, traits::IntoOwned};\nuse napi::{Env, JsFunction, JsObject, JsUnknown, Ref, ValueType};\nuse serde::{Deserialize, Serialize};\nuse smallvec::SmallVec;\n\nuse crate::{at_rule_parser::AtRule, utils::get_named_property};\n\npub struct JsVisitor {\n env: Env,\n visit_stylesheet: VisitorsRef,\n visit_rule: VisitorsRef,\n rule_map: VisitorsRef,\n property_map: VisitorsRef,\n visit_declaration: VisitorsRef,\n visit_length: Option>,\n visit_angle: Option>,\n visit_ratio: Option>,\n visit_resolution: Option>,\n visit_time: Option>,\n visit_color: Option>,\n visit_image: VisitorsRef,\n visit_url: Option>,\n visit_media_query: VisitorsRef,\n visit_supports_condition: VisitorsRef,\n visit_custom_ident: Option>,\n visit_dashed_ident: Option>,\n visit_selector: Option>,\n visit_token: VisitorsRef,\n token_map: VisitorsRef,\n visit_function: VisitorsRef,\n function_map: VisitorsRef,\n visit_variable: VisitorsRef,\n visit_env: VisitorsRef,\n env_map: VisitorsRef,\n types: VisitTypes,\n}\n\n// This is so that the visitor can work with bundleAsync.\n// We ensure that we only call JsVisitor from the main JS thread.\nunsafe impl Send for JsVisitor {}\n\n#[derive(PartialEq, Eq, Clone, Copy)]\nenum VisitStage {\n Enter,\n Exit,\n}\n\ntype VisitorsRef = Visitors>;\n\nstruct Visitors {\n enter: Option,\n exit: Option,\n}\n\nimpl Visitors {\n fn new(enter: Option, exit: Option) -> Self {\n Self { enter, exit }\n }\n\n fn for_stage(&self, stage: VisitStage) -> Option<&T> {\n match stage {\n VisitStage::Enter => self.enter.as_ref(),\n VisitStage::Exit => self.exit.as_ref(),\n }\n }\n}\n\nimpl Visitors> {\n fn get(&self, env: &Env) -> Visitors {\n Visitors {\n enter: self.enter.as_ref().and_then(|p| env.get_reference_value_unchecked(p).ok()),\n exit: self.exit.as_ref().and_then(|p| env.get_reference_value_unchecked(p).ok()),\n }\n }\n}\n\nimpl Visitors {\n fn named(&self, stage: VisitStage, name: &str) -> Option {\n self\n .for_stage(stage)\n .and_then(|m| get_named_property::(m, name).ok())\n }\n\n fn custom(&self, stage: VisitStage, obj: &str, name: &str) -> Option {\n self\n .for_stage(stage)\n .and_then(|m| m.get_named_property::(obj).ok())\n .and_then(|v| {\n match v.get_type() {\n Ok(ValueType::Function) => return v.try_into().ok(),\n Ok(ValueType::Object) => {\n let o: napi::Result = v.try_into();\n if let Ok(o) = o {\n return get_named_property::(&o, name).ok();\n }\n }\n _ => {}\n }\n\n None\n })\n }\n}\n\nimpl Drop for JsVisitor {\n fn drop(&mut self) {\n macro_rules! drop {\n ($id: ident) => {\n if let Some(v) = &mut self.$id {\n drop(v.unref(self.env));\n }\n };\n }\n\n macro_rules! drop_tuple {\n ($id: ident) => {\n if let Some(v) = &mut self.$id.enter {\n drop(v.unref(self.env));\n }\n if let Some(v) = &mut self.$id.exit {\n drop(v.unref(self.env));\n }\n };\n }\n\n drop_tuple!(visit_stylesheet);\n drop_tuple!(visit_rule);\n drop_tuple!(rule_map);\n drop_tuple!(visit_declaration);\n drop_tuple!(property_map);\n drop!(visit_length);\n drop!(visit_angle);\n drop!(visit_ratio);\n drop!(visit_resolution);\n drop!(visit_time);\n drop!(visit_color);\n drop_tuple!(visit_image);\n drop!(visit_url);\n drop_tuple!(visit_media_query);\n drop_tuple!(visit_supports_condition);\n drop_tuple!(visit_variable);\n drop_tuple!(visit_env);\n drop_tuple!(env_map);\n drop!(visit_custom_ident);\n drop!(visit_dashed_ident);\n drop_tuple!(visit_function);\n drop_tuple!(function_map);\n drop!(visit_selector);\n drop_tuple!(visit_token);\n drop_tuple!(token_map);\n }\n}\n\nimpl JsVisitor {\n pub fn new(env: Env, visitor: JsObject) -> Self {\n let mut types = VisitTypes::empty();\n macro_rules! get {\n ($name: literal, $( $t: ident )|+) => {{\n let res: Option = get_named_property(&visitor, $name).ok();\n\n if res.is_some() {\n types |= $( VisitTypes::$t )|+;\n }\n\n // We must create a reference so that the garbage collector doesn't destroy\n // the function before we try to call it (in the async bundle case).\n res.and_then(|res| env.create_reference(res).ok())\n }};\n }\n\n macro_rules! map {\n ($name: literal, $( $t: ident )|+) => {{\n let obj: Option = get_named_property(&visitor, $name).ok();\n\n if obj.is_some() {\n types |= $( VisitTypes::$t )|+;\n }\n\n obj.and_then(|obj| env.create_reference(obj).ok())\n }};\n }\n\n Self {\n env,\n visit_stylesheet: VisitorsRef::new(get!(\"StyleSheet\", RULES), get!(\"StyleSheetExit\", RULES)),\n visit_rule: VisitorsRef::new(get!(\"Rule\", RULES), get!(\"RuleExit\", RULES)),\n rule_map: VisitorsRef::new(map!(\"Rule\", RULES), get!(\"RuleExit\", RULES)),\n visit_declaration: VisitorsRef::new(get!(\"Declaration\", PROPERTIES), get!(\"DeclarationExit\", PROPERTIES)),\n property_map: VisitorsRef::new(map!(\"Declaration\", PROPERTIES), map!(\"DeclarationExit\", PROPERTIES)),\n visit_length: get!(\"Length\", LENGTHS),\n visit_angle: get!(\"Angle\", ANGLES),\n visit_ratio: get!(\"Ratio\", RATIOS),\n visit_resolution: get!(\"Resolution\", RESOLUTIONS),\n visit_time: get!(\"Time\", TIMES),\n visit_color: get!(\"Color\", COLORS),\n visit_image: VisitorsRef::new(get!(\"Image\", IMAGES), get!(\"ImageExit\", IMAGES)),\n visit_url: get!(\"Url\", URLS),\n visit_media_query: VisitorsRef::new(\n get!(\"MediaQuery\", MEDIA_QUERIES),\n get!(\"MediaQueryExit\", MEDIA_QUERIES),\n ),\n visit_supports_condition: VisitorsRef::new(\n get!(\"SupportsCondition\", SUPPORTS_CONDITIONS),\n get!(\"SupportsConditionExit\", SUPPORTS_CONDITIONS),\n ),\n visit_variable: VisitorsRef::new(get!(\"Variable\", TOKENS), get!(\"VariableExit\", TOKENS)),\n visit_env: VisitorsRef::new(\n get!(\"EnvironmentVariable\", TOKENS | MEDIA_QUERIES | ENVIRONMENT_VARIABLES),\n get!(\n \"EnvironmentVariableExit\",\n TOKENS | MEDIA_QUERIES | ENVIRONMENT_VARIABLES\n ),\n ),\n env_map: VisitorsRef::new(\n map!(\"EnvironmentVariable\", TOKENS | MEDIA_QUERIES | ENVIRONMENT_VARIABLES),\n map!(\n \"EnvironmentVariableExit\",\n TOKENS | MEDIA_QUERIES | ENVIRONMENT_VARIABLES\n ),\n ),\n visit_custom_ident: get!(\"CustomIdent\", CUSTOM_IDENTS),\n visit_dashed_ident: get!(\"DashedIdent\", DASHED_IDENTS),\n visit_function: VisitorsRef::new(get!(\"Function\", TOKENS), get!(\"FunctionExit\", TOKENS)),\n function_map: VisitorsRef::new(map!(\"Function\", TOKENS), map!(\"FunctionExit\", TOKENS)),\n visit_selector: get!(\"Selector\", SELECTORS),\n visit_token: VisitorsRef::new(get!(\"Token\", TOKENS), None),\n token_map: VisitorsRef::new(map!(\"Token\", TOKENS), None),\n types,\n }\n }\n}\n\nimpl<'i> Visitor<'i, AtRule<'i>> for JsVisitor {\n type Error = napi::Error;\n\n fn visit_types(&self) -> VisitTypes {\n self.types\n }\n\n fn visit_stylesheet<'o>(&mut self, stylesheet: &mut StyleSheet<'i, 'o, AtRule<'i>>) -> Result<(), Self::Error> {\n if self.types.contains(VisitTypes::RULES) {\n let env = self.env;\n let visit_stylesheet = self.visit_stylesheet.get::(&env);\n if let Some(visit) = visit_stylesheet.for_stage(VisitStage::Enter) {\n call_visitor(&env, stylesheet, visit)?\n }\n\n stylesheet.visit_children(self)?;\n\n if let Some(visit) = visit_stylesheet.for_stage(VisitStage::Exit) {\n call_visitor(&env, stylesheet, visit)?\n }\n\n Ok(())\n } else {\n stylesheet.visit_children(self)\n }\n }\n\n fn visit_rule_list(\n &mut self,\n rules: &mut lightningcss::rules::CssRuleList<'i, AtRule<'i>>,\n ) -> Result<(), Self::Error> {\n if self.types.contains(VisitTypes::RULES) {\n let env = self.env;\n let rule_map = self.rule_map.get::(&env);\n let visit_rule = self.visit_rule.get::(&env);\n\n visit_list(\n rules,\n |value, stage| {\n // Use a more specific visitor function if available, but fall back to visit_rule.\n let name = match value {\n CssRule::Media(..) => \"media\",\n CssRule::Import(..) => \"import\",\n CssRule::Style(..) => \"style\",\n CssRule::Keyframes(..) => \"keyframes\",\n CssRule::FontFace(..) => \"font-face\",\n CssRule::FontPaletteValues(..) => \"font-palette-values\",\n CssRule::FontFeatureValues(..) => \"font-feature-values\",\n CssRule::Page(..) => \"page\",\n CssRule::Supports(..) => \"supports\",\n CssRule::CounterStyle(..) => \"counter-style\",\n CssRule::Namespace(..) => \"namespace\",\n CssRule::CustomMedia(..) => \"custom-media\",\n CssRule::LayerBlock(..) => \"layer-block\",\n CssRule::LayerStatement(..) => \"layer-statement\",\n CssRule::Property(..) => \"property\",\n CssRule::Container(..) => \"container\",\n CssRule::Scope(..) => \"scope\",\n CssRule::MozDocument(..) => \"moz-document\",\n CssRule::Nesting(..) => \"nesting\",\n CssRule::NestedDeclarations(..) => \"nested-declarations\",\n CssRule::Viewport(..) => \"viewport\",\n CssRule::StartingStyle(..) => \"starting-style\",\n CssRule::ViewTransition(..) => \"view-transition\",\n CssRule::Unknown(v) => {\n let name = v.name.as_ref();\n if let Some(visit) = rule_map.custom(stage, \"unknown\", name) {\n let js_value = env.to_js_value(v)?;\n let res = visit.call(None, &[js_value])?;\n return env.from_js_value(res).map(serde_detach::detach);\n } else {\n \"unknown\"\n }\n }\n CssRule::Custom(c) => {\n let name = c.name.as_ref();\n if let Some(visit) = rule_map.custom(stage, \"custom\", name) {\n let js_value = env.to_js_value(c)?;\n let res = visit.call(None, &[js_value])?;\n return env.from_js_value(res).map(serde_detach::detach);\n } else {\n \"custom\"\n }\n }\n CssRule::Ignored => return Ok(None),\n };\n\n if let Some(visit) = rule_map.named(stage, name).as_ref().or(visit_rule.for_stage(stage)) {\n let js_value = env.to_js_value(value)?;\n let res = visit.call(None, &[js_value])?;\n env.from_js_value(res).map(serde_detach::detach)\n } else {\n Ok(None)\n }\n },\n |rule| rule.visit_children(self),\n )?;\n\n Ok(())\n } else {\n rules.visit_children(self)\n }\n }\n\n fn visit_declaration_block(\n &mut self,\n decls: &mut lightningcss::declaration::DeclarationBlock<'i>,\n ) -> Result<(), Self::Error> {\n if self.types.contains(VisitTypes::PROPERTIES) {\n let env = self.env;\n let property_map = self.property_map.get::(&env);\n let visit_declaration = self.visit_declaration.get::(&env);\n visit_declaration_list(\n &env,\n &mut decls.important_declarations,\n &visit_declaration,\n &property_map,\n |property| property.visit_children(self),\n )?;\n visit_declaration_list(\n &env,\n &mut decls.declarations,\n &visit_declaration,\n &property_map,\n |property| property.visit_children(self),\n )?;\n Ok(())\n } else {\n decls.visit_children(self)\n }\n }\n\n fn visit_length(&mut self, length: &mut LengthValue) -> Result<(), Self::Error> {\n visit(&self.env, length, &self.visit_length)\n }\n\n fn visit_angle(&mut self, angle: &mut lightningcss::values::angle::Angle) -> Result<(), Self::Error> {\n visit(&self.env, angle, &self.visit_angle)\n }\n\n fn visit_ratio(&mut self, ratio: &mut lightningcss::values::ratio::Ratio) -> Result<(), Self::Error> {\n visit(&self.env, ratio, &self.visit_ratio)\n }\n\n fn visit_resolution(\n &mut self,\n resolution: &mut lightningcss::values::resolution::Resolution,\n ) -> Result<(), Self::Error> {\n visit(&self.env, resolution, &self.visit_resolution)\n }\n\n fn visit_time(&mut self, time: &mut lightningcss::values::time::Time) -> Result<(), Self::Error> {\n visit(&self.env, time, &self.visit_time)\n }\n\n fn visit_color(&mut self, color: &mut lightningcss::values::color::CssColor) -> Result<(), Self::Error> {\n visit(&self.env, color, &self.visit_color)\n }\n\n fn visit_image(&mut self, image: &mut lightningcss::values::image::Image<'i>) -> Result<(), Self::Error> {\n visit(&self.env, image, &self.visit_image.enter)?;\n image.visit_children(self)?;\n visit(&self.env, image, &self.visit_image.exit)\n }\n\n fn visit_url(&mut self, url: &mut lightningcss::values::url::Url<'i>) -> Result<(), Self::Error> {\n visit(&self.env, url, &self.visit_url)\n }\n\n fn visit_media_list(&mut self, media: &mut lightningcss::media_query::MediaList<'i>) -> Result<(), Self::Error> {\n if self.types.contains(VisitTypes::MEDIA_QUERIES) {\n let env = self.env;\n let visit_media_query = self.visit_media_query.get::(&env);\n visit_list(\n &mut media.media_queries,\n |value, stage| {\n if let Some(visit) = visit_media_query.for_stage(stage) {\n let js_value = env.to_js_value(value)?;\n let res = visit.call(None, &[js_value])?;\n env.from_js_value(res).map(serde_detach::detach)\n } else {\n Ok(None)\n }\n },\n |q| q.visit_children(self),\n )?;\n Ok(())\n } else {\n media.visit_children(self)\n }\n }\n\n fn visit_media_feature_value(&mut self, value: &mut MediaFeatureValue<'i>) -> Result<(), Self::Error> {\n if self.types.contains(VisitTypes::ENVIRONMENT_VARIABLES) && matches!(value, MediaFeatureValue::Env(_)) {\n let env_map = self.env_map.get::(&self.env);\n let visit_env = self.visit_env.get::(&self.env);\n let call = |stage: VisitStage, value: &mut MediaFeatureValue, env: &Env| -> napi::Result<()> {\n let env_var = if let MediaFeatureValue::Env(env) = value {\n env\n } else {\n return Ok(());\n };\n let visit_type = env_map.named(stage, env_var.name.name());\n let visit = visit_env.for_stage(stage);\n let new_value: Option = if let Some(visit) = visit_type.as_ref().or(visit) {\n let js_value = env.to_js_value(env_var)?;\n let res = visit.call(None, &[js_value])?;\n env.from_js_value(res).map(serde_detach::detach)?\n } else {\n None\n };\n\n match new_value {\n None => return Ok(()),\n Some(TokenOrValue::Length(l)) => *value = MediaFeatureValue::Length(Length::Value(l)),\n Some(TokenOrValue::Resolution(r)) => *value = MediaFeatureValue::Resolution(r),\n Some(TokenOrValue::Token(Token::Number { value: n, .. })) => *value = MediaFeatureValue::Number(n),\n Some(TokenOrValue::Token(Token::Ident(ident))) => *value = MediaFeatureValue::Ident(Ident(ident)),\n // TODO: ratio\n _ => {\n return Err(napi::Error::new(\n napi::Status::InvalidArg,\n format!(\"invalid environment value in media query: {:?}\", new_value),\n ))\n }\n }\n\n Ok(())\n };\n\n call(VisitStage::Enter, value, &self.env)?;\n value.visit_children(self)?;\n call(VisitStage::Exit, value, &self.env)?;\n return Ok(());\n }\n\n value.visit_children(self)\n }\n\n fn visit_supports_condition(\n &mut self,\n condition: &mut lightningcss::rules::supports::SupportsCondition<'i>,\n ) -> Result<(), Self::Error> {\n visit(&self.env, condition, &self.visit_supports_condition.enter)?;\n condition.visit_children(self)?;\n visit(&self.env, condition, &self.visit_supports_condition.exit)\n }\n\n fn visit_custom_ident(\n &mut self,\n ident: &mut lightningcss::values::ident::CustomIdent,\n ) -> Result<(), Self::Error> {\n visit(&self.env, ident, &self.visit_custom_ident)\n }\n\n fn visit_dashed_ident(\n &mut self,\n ident: &mut lightningcss::values::ident::DashedIdent,\n ) -> Result<(), Self::Error> {\n visit(&self.env, ident, &self.visit_dashed_ident)\n }\n\n fn visit_selector_list(\n &mut self,\n selectors: &mut lightningcss::selector::SelectorList<'i>,\n ) -> Result<(), Self::Error> {\n if let Some(visit) = self\n .visit_selector\n .as_ref()\n .and_then(|v| self.env.get_reference_value_unchecked::(v).ok())\n {\n map::<_, _, _, true>(&mut selectors.0, |value| {\n let js_value = self.env.to_js_value(value)?;\n let res = visit.call(None, &[js_value])?;\n self.env.from_js_value(res).map(serde_detach::detach)\n })?;\n }\n\n Ok(())\n }\n\n fn visit_token_list(\n &mut self,\n tokens: &mut lightningcss::properties::custom::TokenList<'i>,\n ) -> Result<(), Self::Error> {\n if self.types.contains(VisitTypes::TOKENS) {\n let env = self.env;\n let visit_token = self.visit_token.get::(&env);\n let token_map = self.token_map.get::(&env);\n let visit_function = self.visit_function.get::(&env);\n let function_map = self.function_map.get::(&env);\n let visit_variable = self.visit_variable.get::(&env);\n let visit_env = self.visit_env.get::(&env);\n let env_map = self.env_map.get::(&env);\n\n visit_list(\n &mut tokens.0,\n |value, stage| {\n let (visit_type, visit) = match value {\n TokenOrValue::Function(f) => (\n function_map.named(stage, f.name.0.as_ref()),\n visit_function.for_stage(stage),\n ),\n TokenOrValue::Var(_) => (None, visit_variable.for_stage(stage)),\n TokenOrValue::Env(e) => (env_map.named(stage, e.name.name()), visit_env.for_stage(stage)),\n TokenOrValue::Token(t) => {\n let name = match t {\n Token::Ident(_) => Some(\"ident\"),\n Token::AtKeyword(_) => Some(\"at-keyword\"),\n Token::Hash(_) => Some(\"hash\"),\n Token::IDHash(_) => Some(\"id-hash\"),\n Token::String(_) => Some(\"string\"),\n Token::Number { .. } => Some(\"number\"),\n Token::Percentage { .. } => Some(\"percentage\"),\n Token::Dimension { .. } => Some(\"dimension\"),\n _ => None,\n };\n let visit = if let Some(name) = name {\n token_map.named(stage, name)\n } else {\n None\n };\n (visit, visit_token.for_stage(stage))\n }\n _ => return Ok(None),\n };\n\n if let Some(visit) = visit_type.as_ref().or(visit) {\n let js_value = match value {\n TokenOrValue::Function(f) => env.to_js_value(f)?,\n TokenOrValue::Var(v) => env.to_js_value(v)?,\n TokenOrValue::Env(v) => env.to_js_value(v)?,\n TokenOrValue::Token(t) => env.to_js_value(t)?,\n _ => unreachable!(),\n };\n\n let res = visit.call(None, &[js_value])?;\n let res: Option = env.from_js_value(res).map(serde_detach::detach)?;\n Ok(res.map(|r| r.0))\n } else {\n Ok(None)\n }\n },\n |value| value.visit_children(self),\n )?;\n\n Ok(())\n } else {\n tokens.visit_children(self)\n }\n }\n}\n\nfn visit>(\n env: &Env,\n value: &mut V,\n visit: &Option>,\n) -> napi::Result<()> {\n if let Some(visit) = visit\n .as_ref()\n .and_then(|v| env.get_reference_value_unchecked::(v).ok())\n {\n call_visitor(env, value, &visit)?;\n }\n\n Ok(())\n}\n\nfn call_visitor>(\n env: &Env,\n value: &mut V,\n visit: &JsFunction,\n) -> napi::Result<()> {\n let js_value = env.to_js_value(value)?;\n let res = visit.call(None, &[js_value])?;\n let new_value: Option = env.from_js_value(res).map(serde_detach::detach)?;\n match new_value {\n Some(new_value) => *value = new_value,\n None => {}\n }\n\n Ok(())\n}\n\nfn visit_declaration_list<'i, C: FnMut(&mut Property<'i>) -> napi::Result<()>>(\n env: &Env,\n list: &mut Vec>,\n visit_declaration: &Visitors,\n property_map: &Visitors,\n visit_children: C,\n) -> napi::Result<()> {\n visit_list(\n list,\n |value, stage| {\n // Use a specific property visitor if available, or fall back to Property visitor.\n let visit = match value {\n Property::Custom(v) => {\n if let Some(visit) = property_map.custom(stage, \"custom\", v.name.as_ref()) {\n let js_value = env.to_js_value(v)?;\n let res = visit.call(None, &[js_value])?;\n return env.from_js_value(res).map(serde_detach::detach);\n } else {\n None\n }\n }\n _ => property_map.named(stage, value.property_id().name()),\n };\n\n if let Some(visit) = visit.as_ref().or(visit_declaration.for_stage(stage)) {\n let js_value = env.to_js_value(value)?;\n let res = visit.call(None, &[js_value])?;\n env.from_js_value(res).map(serde_detach::detach)\n } else {\n Ok(None)\n }\n },\n visit_children,\n )\n}\n\nfn visit_list<\n V,\n L: List,\n F: Fn(&mut V, VisitStage) -> napi::Result>>,\n C: FnMut(&mut V) -> napi::Result<()>,\n>(\n list: &mut L,\n visit: F,\n mut visit_children: C,\n) -> napi::Result<()> {\n map(list, |value| {\n let mut new_value: Option> = visit(value, VisitStage::Enter)?;\n\n match &mut new_value {\n Some(ValueOrVec::Value(v)) => {\n visit_children(v)?;\n\n if let Some(val) = visit(v, VisitStage::Exit)? {\n new_value = Some(val);\n }\n }\n Some(ValueOrVec::Vec(v)) => {\n map(v, |value| {\n visit_children(value)?;\n visit(value, VisitStage::Exit)\n })?;\n }\n None => {\n visit_children(value)?;\n if let Some(val) = visit(value, VisitStage::Exit)? {\n new_value = Some(val);\n }\n }\n }\n\n Ok(new_value)\n })\n}\n\nfn map, F: FnMut(&mut V) -> napi::Result>>, const IS_VEC: bool>(\n list: &mut L,\n mut f: F,\n) -> napi::Result<()> {\n let mut i = 0;\n while i < list.len() {\n let value = &mut list[i];\n let new_value = f(value)?;\n match new_value {\n Some(ValueOrVec::Value(v)) => {\n list[i] = v;\n i += 1;\n }\n Some(ValueOrVec::Vec(vec)) => {\n if vec.is_empty() {\n list.remove(i);\n } else {\n let len = vec.len();\n list.replace(i, vec);\n i += len;\n }\n }\n None => {\n i += 1;\n }\n }\n }\n Ok(())\n}\n\n#[derive(serde::Serialize)]\n#[serde(untagged)]\nenum ValueOrVec {\n Value(V),\n Vec(Vec),\n}\n\n// Manually implemented deserialize for better error messages.\n// https://github.com/serde-rs/serde/issues/773\nimpl<'de, V: serde::Deserialize<'de>, const IS_VEC: bool> serde::Deserialize<'de> for ValueOrVec {\n fn deserialize(deserializer: D) -> Result\n where\n D: serde::Deserializer<'de>,\n {\n use serde::Deserializer;\n let content = serde_content::Value::deserialize(deserializer)?;\n let de = serde_content::Deserializer::new(content.clone()).coerce_numbers();\n\n // Try to deserialize as a sequence first.\n let mut was_seq = false;\n let res = de.deserialize_seq(SeqVisitor {\n was_seq: &mut was_seq,\n phantom: PhantomData,\n });\n\n if was_seq {\n // Allow fallback if we know the value is also a list (e.g. selector).\n if res.is_ok() || !IS_VEC {\n return res.map_err(|e| serde::de::Error::custom(e.to_string())).map(ValueOrVec::Vec);\n }\n }\n\n // If it wasn't a sequence, try a value.\n let de = serde_content::Deserializer::new(content).coerce_numbers();\n return V::deserialize(de)\n .map_err(|e| serde::de::Error::custom(e.to_string()))\n .map(ValueOrVec::Value);\n\n struct SeqVisitor<'a, V> {\n was_seq: &'a mut bool,\n phantom: PhantomData,\n }\n\n impl<'a, 'de, V: serde::Deserialize<'de>> serde::de::Visitor<'de> for SeqVisitor<'a, V> {\n type Value = Vec;\n\n fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {\n formatter.write_str(\"a sequence\")\n }\n\n fn visit_seq(self, mut seq: A) -> Result\n where\n A: serde::de::SeqAccess<'de>,\n {\n *self.was_seq = true;\n let mut vec = Vec::with_capacity(seq.size_hint().unwrap_or(1));\n while let Some(v) = seq.next_element()? {\n vec.push(v);\n }\n Ok(vec)\n }\n }\n }\n}\n\nstruct TokensOrRaw<'i>(ValueOrVec>);\n\nimpl<'i, 'de: 'i> serde::Deserialize<'de> for TokensOrRaw<'i> {\n fn deserialize(deserializer: D) -> Result\n where\n D: serde::Deserializer<'de>,\n {\n #[derive(serde::Deserialize)]\n struct Raw<'i> {\n #[serde(borrow)]\n raw: CowArcStr<'i>,\n }\n\n let content = serde_content::Value::deserialize(deserializer)?;\n let de = serde_content::Deserializer::new(content.clone()).coerce_numbers();\n\n if let Ok(res) = Raw::deserialize(de) {\n let res = TokenList::parse_string_with_options(res.raw.as_ref(), ParserOptions::default())\n .map_err(|_| serde::de::Error::custom(\"Could not parse value\"))?;\n return Ok(TokensOrRaw(ValueOrVec::Vec(res.into_owned().0)));\n }\n\n let de = serde_content::Deserializer::new(content).coerce_numbers();\n Ok(TokensOrRaw(\n ValueOrVec::deserialize(de).map_err(|e| serde::de::Error::custom(e.to_string()))?,\n ))\n }\n}\n\ntrait List: Index + IndexMut {\n fn len(&self) -> usize;\n fn remove(&mut self, i: usize);\n fn replace(&mut self, i: usize, items: Vec);\n}\n\nimpl List for Vec {\n fn len(&self) -> usize {\n Vec::len(self)\n }\n\n fn remove(&mut self, i: usize) {\n Vec::remove(self, i);\n }\n\n fn replace(&mut self, i: usize, items: Vec) {\n self.splice(i..i + 1, items);\n }\n}\n\nimpl> List for SmallVec {\n fn len(&self) -> usize {\n SmallVec::len(self)\n }\n\n fn remove(&mut self, i: usize) {\n SmallVec::remove(self, i);\n }\n\n fn replace(&mut self, i: usize, items: Vec) {\n let len = items.len();\n let mut iter = items.into_iter();\n self[i] = iter.next().unwrap();\n if len > 1 {\n self.insert_many(i + 1, iter);\n }\n }\n}\n\nimpl<'i, R> List> for CssRuleList<'i, R> {\n fn len(&self) -> usize {\n self.0.len()\n }\n\n fn remove(&mut self, i: usize) {\n self[i] = CssRule::Ignored;\n }\n\n fn replace(&mut self, i: usize, items: Vec>) {\n self.0.replace(i, items)\n }\n}\n" }, { "path": "napi/src/utils.rs", "content": "use napi::{Error, JsObject, JsUnknown, Result};\n\n// Workaround for https://github.com/napi-rs/napi-rs/issues/1641\npub fn get_named_property>(obj: &JsObject, property: &str) -> Result {\n let unknown = obj.get_named_property::(property)?;\n T::try_from(unknown)\n}\n" }, { "path": "node/Cargo.toml", "content": "[package]\nauthors = [\"Devon Govett \"]\nname = \"lightningcss_node\"\nversion = \"0.1.0\"\nedition = \"2021\"\npublish = false\n\n[lib]\ncrate-type = [\"cdylib\"]\n\n[dependencies]\nlightningcss-napi = { version = \"0.4.8\", path = \"../napi\", features = [\n \"bundler\",\n \"visitor\",\n] }\nnapi = { version = \"2.15.4\", default-features = false, features = [\n \"compat-mode\",\n] }\nnapi-derive = \"2\"\n\n[target.'cfg(target_os = \"macos\")'.dependencies]\njemallocator = { version = \"0.3.2\", features = [\"disable_initial_exec_tls\"] }\n\n[target.'cfg(not(target_arch = \"wasm32\"))'.build-dependencies]\nnapi-build = \"1\"\n" }, { "path": "node/ast.d.ts", "content": "/* eslint-disable */\n/**\n * This file was automatically generated by json-schema-to-typescript.\n * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,\n * and run json-schema-to-typescript to regenerate this file.\n */\n\nexport type String = string;\n/**\n * A CSS rule.\n */\nexport type Rule = | {\n type: \"media\";\n value: MediaRule;\n }\n| {\n type: \"import\";\n value: ImportRule;\n }\n| {\n type: \"style\";\n value: StyleRule;\n }\n| {\n type: \"keyframes\";\n value: KeyframesRule;\n }\n| {\n type: \"font-face\";\n value: FontFaceRule;\n }\n| {\n type: \"font-palette-values\";\n value: FontPaletteValuesRule;\n }\n| {\n type: \"font-feature-values\";\n value: FontFeatureValuesRule;\n }\n| {\n type: \"page\";\n value: PageRule;\n }\n| {\n type: \"supports\";\n value: SupportsRule;\n }\n| {\n type: \"counter-style\";\n value: CounterStyleRule;\n }\n| {\n type: \"namespace\";\n value: NamespaceRule;\n }\n| {\n type: \"moz-document\";\n value: MozDocumentRule;\n }\n| {\n type: \"nesting\";\n value: NestingRule;\n }\n| {\n type: \"nested-declarations\";\n value: NestedDeclarationsRule;\n }\n| {\n type: \"viewport\";\n value: ViewportRule;\n }\n| {\n type: \"custom-media\";\n value: CustomMediaRule;\n }\n| {\n type: \"layer-statement\";\n value: LayerStatementRule;\n }\n| {\n type: \"layer-block\";\n value: LayerBlockRule;\n }\n| {\n type: \"property\";\n value: PropertyRule;\n }\n| {\n type: \"container\";\n value: ContainerRule;\n }\n| {\n type: \"scope\";\n value: ScopeRule;\n }\n| {\n type: \"starting-style\";\n value: StartingStyleRule;\n }\n| {\n type: \"view-transition\";\n value: ViewTransitionRule;\n }\n| {\n type: \"ignored\";\n }\n| {\n type: \"unknown\";\n value: UnknownAtRule;\n }\n| {\n type: \"custom\";\n value: DefaultAtRule;\n };\n/**\n * Represents a media condition.\n */\nexport type MediaCondition =\n | {\n type: \"feature\";\n value: QueryFeatureFor_MediaFeatureId;\n }\n | {\n type: \"not\";\n value: MediaCondition;\n }\n | {\n /**\n * The conditions for the operator.\n */\n conditions: MediaCondition[];\n /**\n * The operator for the conditions.\n */\n operator: Operator;\n type: \"operation\";\n }\n | {\n type: \"unknown\";\n value: TokenOrValue[];\n };\n/**\n * A generic media feature or container feature.\n */\nexport type QueryFeatureFor_MediaFeatureId =\n | {\n /**\n * The name of the feature.\n */\n name: MediaFeatureNameFor_MediaFeatureId;\n type: \"plain\";\n /**\n * The feature value.\n */\n value: MediaFeatureValue;\n }\n | {\n /**\n * The name of the feature.\n */\n name: MediaFeatureNameFor_MediaFeatureId;\n type: \"boolean\";\n }\n | {\n /**\n * The name of the feature.\n */\n name: MediaFeatureNameFor_MediaFeatureId;\n /**\n * A comparator.\n */\n operator: MediaFeatureComparison;\n type: \"range\";\n /**\n * The feature value.\n */\n value: MediaFeatureValue;\n }\n | {\n /**\n * The end value.\n */\n end: MediaFeatureValue;\n /**\n * A comparator for the end value.\n */\n endOperator: MediaFeatureComparison;\n /**\n * The name of the feature.\n */\n name: MediaFeatureNameFor_MediaFeatureId;\n /**\n * A start value.\n */\n start: MediaFeatureValue;\n /**\n * A comparator for the start value.\n */\n startOperator: MediaFeatureComparison;\n type: \"interval\";\n };\n/**\n * A media feature name.\n */\nexport type MediaFeatureNameFor_MediaFeatureId = MediaFeatureId | String | String;\n/**\n * A media query feature identifier.\n */\nexport type MediaFeatureId =\n | \"width\"\n | \"height\"\n | \"aspect-ratio\"\n | \"orientation\"\n | \"overflow-block\"\n | \"overflow-inline\"\n | \"horizontal-viewport-segments\"\n | \"vertical-viewport-segments\"\n | \"display-mode\"\n | \"resolution\"\n | \"scan\"\n | \"grid\"\n | \"update\"\n | \"environment-blending\"\n | \"color\"\n | \"color-index\"\n | \"monochrome\"\n | \"color-gamut\"\n | \"dynamic-range\"\n | \"inverted-colors\"\n | \"pointer\"\n | \"hover\"\n | \"any-pointer\"\n | \"any-hover\"\n | \"nav-controls\"\n | \"video-color-gamut\"\n | \"video-dynamic-range\"\n | \"scripting\"\n | \"prefers-reduced-motion\"\n | \"prefers-reduced-transparency\"\n | \"prefers-contrast\"\n | \"forced-colors\"\n | \"prefers-color-scheme\"\n | \"prefers-reduced-data\"\n | \"device-width\"\n | \"device-height\"\n | \"device-aspect-ratio\"\n | \"-webkit-device-pixel-ratio\"\n | \"-moz-device-pixel-ratio\";\n/**\n * [media feature value](https://drafts.csswg.org/mediaqueries/#typedef-mf-value) within a media query.\n *\n * See [MediaFeature](MediaFeature).\n */\nexport type MediaFeatureValue =\n | {\n type: \"length\";\n value: Length;\n }\n | {\n type: \"number\";\n value: number;\n }\n | {\n type: \"integer\";\n value: number;\n }\n | {\n type: \"boolean\";\n value: boolean;\n }\n | {\n type: \"resolution\";\n value: Resolution;\n }\n | {\n type: \"ratio\";\n value: Ratio;\n }\n | {\n type: \"ident\";\n value: String;\n }\n | {\n type: \"env\";\n value: EnvironmentVariable;\n };\n/**\n * A CSS [``](https://www.w3.org/TR/css-values-4/#lengths) value, with support for `calc()`.\n */\nexport type Length =\n | {\n type: \"value\";\n value: LengthValue;\n }\n | {\n type: \"calc\";\n value: CalcFor_Length;\n };\nexport type LengthUnit =\n | \"px\"\n | \"in\"\n | \"cm\"\n | \"mm\"\n | \"q\"\n | \"pt\"\n | \"pc\"\n | \"em\"\n | \"rem\"\n | \"ex\"\n | \"rex\"\n | \"ch\"\n | \"rch\"\n | \"cap\"\n | \"rcap\"\n | \"ic\"\n | \"ric\"\n | \"lh\"\n | \"rlh\"\n | \"vw\"\n | \"lvw\"\n | \"svw\"\n | \"dvw\"\n | \"cqw\"\n | \"vh\"\n | \"lvh\"\n | \"svh\"\n | \"dvh\"\n | \"cqh\"\n | \"vi\"\n | \"svi\"\n | \"lvi\"\n | \"dvi\"\n | \"cqi\"\n | \"vb\"\n | \"svb\"\n | \"lvb\"\n | \"dvb\"\n | \"cqb\"\n | \"vmin\"\n | \"svmin\"\n | \"lvmin\"\n | \"dvmin\"\n | \"cqmin\"\n | \"vmax\"\n | \"svmax\"\n | \"lvmax\"\n | \"dvmax\"\n | \"cqmax\";\n/**\n * A mathematical expression used within the [`calc()`](https://www.w3.org/TR/css-values-4/#calc-func) function.\n *\n * This type supports generic value types. Values such as [Length](super::length::Length), [Percentage](super::percentage::Percentage), [Time](super::time::Time), and [Angle](super::angle::Angle) support `calc()` expressions.\n */\nexport type CalcFor_Length =\n | {\n type: \"value\";\n value: Length;\n }\n | {\n type: \"number\";\n value: number;\n }\n | {\n type: \"sum\";\n /**\n * @minItems 2\n * @maxItems 2\n */\n value: [CalcFor_Length, CalcFor_Length];\n }\n | {\n type: \"product\";\n /**\n * @minItems 2\n * @maxItems 2\n */\n value: [number, CalcFor_Length];\n }\n | {\n type: \"function\";\n value: MathFunctionFor_Length;\n };\n/**\n * A CSS [math function](https://www.w3.org/TR/css-values-4/#math-function).\n *\n * Math functions may be used in most properties and values that accept numeric values, including lengths, percentages, angles, times, etc.\n */\nexport type MathFunctionFor_Length =\n | {\n type: \"calc\";\n value: CalcFor_Length;\n }\n | {\n type: \"min\";\n value: CalcFor_Length[];\n }\n | {\n type: \"max\";\n value: CalcFor_Length[];\n }\n | {\n type: \"clamp\";\n /**\n * @minItems 3\n * @maxItems 3\n */\n value: [CalcFor_Length, CalcFor_Length, CalcFor_Length];\n }\n | {\n type: \"round\";\n /**\n * @minItems 3\n * @maxItems 3\n */\n value: [RoundingStrategy, CalcFor_Length, CalcFor_Length];\n }\n | {\n type: \"rem\";\n /**\n * @minItems 2\n * @maxItems 2\n */\n value: [CalcFor_Length, CalcFor_Length];\n }\n | {\n type: \"mod\";\n /**\n * @minItems 2\n * @maxItems 2\n */\n value: [CalcFor_Length, CalcFor_Length];\n }\n | {\n type: \"abs\";\n value: CalcFor_Length;\n }\n | {\n type: \"sign\";\n value: CalcFor_Length;\n }\n | {\n type: \"hypot\";\n value: CalcFor_Length[];\n };\n/**\n * A [rounding strategy](https://www.w3.org/TR/css-values-4/#typedef-rounding-strategy), as used in the `round()` function.\n */\nexport type RoundingStrategy = \"nearest\" | \"up\" | \"down\" | \"to-zero\";\n/**\n * A CSS [``](https://www.w3.org/TR/css-values-4/#resolution) value.\n */\nexport type Resolution =\n | {\n type: \"dpi\";\n value: number;\n }\n | {\n type: \"dpcm\";\n value: number;\n }\n | {\n type: \"dppx\";\n value: number;\n };\n/**\n * A CSS [``](https://www.w3.org/TR/css-values-4/#ratios) value, representing the ratio of two numeric values.\n *\n * @minItems 2\n * @maxItems 2\n */\nexport type Ratio = [number, number];\n/**\n * A raw CSS token, or a parsed value.\n */\nexport type TokenOrValue =\n | {\n type: \"token\";\n value: Token;\n }\n | {\n type: \"color\";\n value: CssColor;\n }\n | {\n type: \"unresolved-color\";\n value: UnresolvedColor;\n }\n | {\n type: \"url\";\n value: Url;\n }\n | {\n type: \"var\";\n value: Variable;\n }\n | {\n type: \"env\";\n value: EnvironmentVariable;\n }\n | {\n type: \"function\";\n value: Function;\n }\n | {\n type: \"length\";\n value: LengthValue;\n }\n | {\n type: \"angle\";\n value: Angle;\n }\n | {\n type: \"time\";\n value: Time;\n }\n | {\n type: \"resolution\";\n value: Resolution;\n }\n | {\n type: \"dashed-ident\";\n value: String;\n }\n | {\n type: \"animation-name\";\n value: AnimationName;\n };\n/**\n * A raw CSS token.\n */\nexport type Token =\n | {\n type: \"ident\";\n value: String;\n }\n | {\n type: \"at-keyword\";\n value: String;\n }\n | {\n type: \"hash\";\n value: String;\n }\n | {\n type: \"id-hash\";\n value: String;\n }\n | {\n type: \"string\";\n value: String;\n }\n | {\n type: \"unquoted-url\";\n value: String;\n }\n | {\n type: \"delim\";\n value: string;\n }\n | {\n type: \"number\";\n /**\n * The value as a float\n */\n value: number;\n }\n | {\n type: \"percentage\";\n /**\n * The value as a float, divided by 100 so that the nominal range is 0.0 to 1.0.\n */\n value: number;\n }\n | {\n type: \"dimension\";\n /**\n * The unit, e.g. \"px\" in `12px`\n */\n unit: String;\n /**\n * The value as a float\n */\n value: number;\n }\n | {\n type: \"white-space\";\n value: String;\n }\n | {\n type: \"comment\";\n value: String;\n }\n | {\n type: \"colon\";\n }\n | {\n type: \"semicolon\";\n }\n | {\n type: \"comma\";\n }\n | {\n type: \"include-match\";\n }\n | {\n type: \"dash-match\";\n }\n | {\n type: \"prefix-match\";\n }\n | {\n type: \"suffix-match\";\n }\n | {\n type: \"substring-match\";\n }\n | {\n type: \"cdo\";\n }\n | {\n type: \"cdc\";\n }\n | {\n type: \"function\";\n value: String;\n }\n | {\n type: \"parenthesis-block\";\n }\n | {\n type: \"square-bracket-block\";\n }\n | {\n type: \"curly-bracket-block\";\n }\n | {\n type: \"bad-url\";\n value: String;\n }\n | {\n type: \"bad-string\";\n value: String;\n }\n | {\n type: \"close-parenthesis\";\n }\n | {\n type: \"close-square-bracket\";\n }\n | {\n type: \"close-curly-bracket\";\n };\n/**\n * A CSS [``](https://www.w3.org/TR/css-color-4/#color-type) value.\n *\n * CSS supports many different color spaces to represent colors. The most common values are stored as RGBA using a single byte per component. Less common values are stored using a `Box` to reduce the amount of memory used per color.\n *\n * Each color space is represented as a struct that implements the `From` and `Into` traits for all other color spaces, so it is possible to convert between color spaces easily. In addition, colors support [interpolation](#method.interpolate) as in the `color-mix()` function.\n */\nexport type CssColor = CurrentColor | RGBColor | LABColor | PredefinedColor | FloatColor | LightDark | SystemColor;\nexport type CurrentColor = {\n type: \"currentcolor\";\n};\nexport type RGBColor = {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"rgb\";\n};\n/**\n * A color in a LAB color space, including the `lab()`, `lch()`, `oklab()`, and `oklch()` functions.\n */\nexport type LABColor =\n | {\n /**\n * The a component.\n */\n a: number;\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The b component.\n */\n b: number;\n /**\n * The lightness component.\n */\n l: number;\n type: \"lab\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The chroma component.\n */\n c: number;\n /**\n * The hue component.\n */\n h: number;\n /**\n * The lightness component.\n */\n l: number;\n type: \"lch\";\n }\n | {\n /**\n * The a component.\n */\n a: number;\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The b component.\n */\n b: number;\n /**\n * The lightness component.\n */\n l: number;\n type: \"oklab\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The chroma component.\n */\n c: number;\n /**\n * The hue component.\n */\n h: number;\n /**\n * The lightness component.\n */\n l: number;\n type: \"oklch\";\n };\n/**\n * A color in a predefined color space, e.g. `display-p3`.\n */\nexport type PredefinedColor =\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"srgb\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"srgb-linear\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"display-p3\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"a98-rgb\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"prophoto-rgb\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"rec2020\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n type: \"xyz-d50\";\n /**\n * The x component.\n */\n x: number;\n /**\n * The y component.\n */\n y: number;\n /**\n * The z component.\n */\n z: number;\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n type: \"xyz-d65\";\n /**\n * The x component.\n */\n x: number;\n /**\n * The y component.\n */\n y: number;\n /**\n * The z component.\n */\n z: number;\n };\n/**\n * A floating point representation of color types that are usually stored as RGBA. These are used when there are any `none` components, which are represented as NaN.\n */\nexport type FloatColor =\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"rgb\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The hue component.\n */\n h: number;\n /**\n * The lightness component.\n */\n l: number;\n /**\n * The saturation component.\n */\n s: number;\n type: \"hsl\";\n }\n | {\n /**\n * The alpha component.\n */\n alpha: number;\n /**\n * The blackness component.\n */\n b: number;\n /**\n * The hue component.\n */\n h: number;\n type: \"hwb\";\n /**\n * The whiteness component.\n */\n w: number;\n };\nexport type LightDark = {\n dark: CssColor;\n light: CssColor;\n type: \"light-dark\";\n};\n/**\n * A CSS [system color](https://drafts.csswg.org/css-color/#css-system-colors) keyword.\n */\nexport type SystemColor =\n | \"accentcolor\"\n | \"accentcolortext\"\n | \"activetext\"\n | \"buttonborder\"\n | \"buttonface\"\n | \"buttontext\"\n | \"canvas\"\n | \"canvastext\"\n | \"field\"\n | \"fieldtext\"\n | \"graytext\"\n | \"highlight\"\n | \"highlighttext\"\n | \"linktext\"\n | \"mark\"\n | \"marktext\"\n | \"selecteditem\"\n | \"selecteditemtext\"\n | \"visitedtext\"\n | \"activeborder\"\n | \"activecaption\"\n | \"appworkspace\"\n | \"background\"\n | \"buttonhighlight\"\n | \"buttonshadow\"\n | \"captiontext\"\n | \"inactiveborder\"\n | \"inactivecaption\"\n | \"inactivecaptiontext\"\n | \"infobackground\"\n | \"infotext\"\n | \"menu\"\n | \"menutext\"\n | \"scrollbar\"\n | \"threeddarkshadow\"\n | \"threedface\"\n | \"threedhighlight\"\n | \"threedlightshadow\"\n | \"threedshadow\"\n | \"window\"\n | \"windowframe\"\n | \"windowtext\";\n/**\n * A color value with an unresolved alpha value (e.g. a variable). These can be converted from the modern slash syntax to older comma syntax. This can only be done when the only unresolved component is the alpha since variables can resolve to multiple tokens.\n */\nexport type UnresolvedColor =\n | {\n /**\n * The unresolved alpha component.\n */\n alpha: TokenOrValue[];\n /**\n * The blue component.\n */\n b: number;\n /**\n * The green component.\n */\n g: number;\n /**\n * The red component.\n */\n r: number;\n type: \"rgb\";\n }\n | {\n /**\n * The unresolved alpha component.\n */\n alpha: TokenOrValue[];\n /**\n * The hue component.\n */\n h: number;\n /**\n * The lightness component.\n */\n l: number;\n /**\n * The saturation component.\n */\n s: number;\n type: \"hsl\";\n }\n | {\n /**\n * The dark value.\n */\n dark: TokenOrValue[];\n /**\n * The light value.\n */\n light: TokenOrValue[];\n type: \"light-dark\";\n };\n/**\n * Defines where the class names referenced in the `composes` property are located.\n *\n * See [Composes](Composes).\n */\nexport type Specifier =\n | {\n type: \"global\";\n }\n | {\n type: \"file\";\n value: String;\n }\n | {\n type: \"source-index\";\n value: number;\n };\n/**\n * A CSS [``](https://www.w3.org/TR/css-values-4/#angles) value.\n *\n * Angles may be explicit or computed by `calc()`, but are always stored and serialized as their computed value.\n */\nexport type Angle =\n | {\n type: \"deg\";\n value: number;\n }\n | {\n type: \"rad\";\n value: number;\n }\n | {\n type: \"grad\";\n value: number;\n }\n | {\n type: \"turn\";\n value: number;\n };\n/**\n * A CSS [`
Time to minify Bootstrap 4 (~10,000 lines). See the readme for more benchmarks.
\n \n \n
\n
\n

Live in the future

\n
\n

Lightning CSS lets you use modern CSS features and future syntax today. Features such as CSS nesting, custom media queries, high gamut color spaces, logical properties, and new selector features are automatically converted to more compatible syntax based on your browser targets.

\n

Lightning CSS also automatically adds vendor prefixes for your browser targets, so you can keep your source code clean and repetition free.

\n

Learn more →

\n
\n
\n

Target Browsers

last 2 versions
\n

Input

\n.foo {\n  color: oklab(59.686% 0.1009 0.1192);\n}
\n

Output

\n.foo {\n  color: #c65d07;\n  color: color(display-p3 .724144 .386777 .148795);\n  color: lab(52.2319% 40.1449 59.9171);\n}
\n
\n
\n
\n
\n
\n

Crush it!

\n

Lightning CSS is not only fast when it comes to build time. It produces smaller output, so your website loads faster too.

\n

The Lightning CSS minifier combines longhand properties into shorthands, removes unnecessary vendor prefixes, merges compatible adjacent rules, removes unnecessary default values, reduces calc() expressions, shortens colors, minifies gradients, and much more.

\n

Details →

\n
\n
\n
Output size
\n
\n
\n
0 KB
\n
\n
40 KB
\n
\n
80 KB
\n
\n
120 KB
\n
\n
160 KB
\n \n
\n
\n
155.89 KB
\n
\n
156.57 KB
\n
\n
139.74 KB
\n
\n\n
CSSNano
\n
ESBuild
\n
Lightning CSS
\n
\n
\n
Output size after minifying Bootstrap 4 (~10,000 lines). See the readme for more benchmarks.
\n
\n
\n
\n
\n

CSS modules

\n

Lightning CSS supports CSS modules, which locally scope classes, ids, @keyframes, CSS variables, and more. This ensures that there are no unintended name clashes between different CSS files.

\n

Lightning CSS generates a mapping of the original names to scoped names, which can be used from your JavaScript. This also enables unused classes and variables to be tree-shaken.

\n

Documentation →

\n
\n 
.heading {\n  composes: typography from './typography.css';\n  color: gray;\n}
\n 
.EgL3uq_heading {\n  color: gray;\n}
\n 
{\n  \"heading\": {\n    \"name\": \"EgL3uq_heading\",\n    \"composes\": [{\n      \"type\": \"dependency\",\n      \"name\": \"typography\",\n      \"specifier\": \"./typography.css\"\n    }]\n  }\n}
\n
\n
\n
\n

Browser grade

\n

Lightning CSS is written in Rust, using the cssparser and selectors crates created by Mozilla and used by Firefox. These provide a solid CSS-parsing foundation on top of which Lightning CSS implements support for all specific CSS rules and properties.

\n

Lightning CSS fully parses every CSS rule, property, and value just as a browser would. This reduces duplicate work for transformers, leading to improved performance and minification.

\n

Custom transforms →

\n
\n 
Background([Background {\n  image: Url(Url { url: \"img.png\" }),\n  color: CssColor(RGBA(RGBA { red: 0, green: 0, blue: 0, alpha: 0 })),\n  position: Position {\n    x: Length(Dimension(Px(20.0))),\n    y: Length(Dimension(Px(10.0))),\n  },\n  repeat: BackgroundRepeat {\n    x: Repeat,\n    y: Repeat,\n  },\n  size: Explicit {\n    width: LengthPercentage(Dimension(Px(50.0))),\n    height: LengthPercentage(Dimension(Px(100.0))),\n  },\n  attachment: Scroll,\n  origin: PaddingBox,\n  clip: BorderBox,\n}])
\n
\n \n
\n Copyright © 2024 Devon Govett and Parcel Contributors.\n
\n \n \n\n" }, { "path": "website/minification.html", "content": "\n" }, { "path": "website/pages/bundling.md", "content": "\n\n# Bundling\n\nLightning CSS supports bundling dependencies referenced by CSS `@import` rules into a single output file. When calling the Lightning CSS API, use the `bundle` or `bundleAsync` function instead of `transform`. When using the CLI, enable the `--bundle` flag.\n\nThis API requires filesystem access, so it does not accept `code` directly via the API. Instead, the `filename` option is used to read the entry file directly.\n\n```js\nimport { bundle } from 'lightningcss';\n\nlet { code, map } = bundle({\n filename: 'style.css',\n minify: true\n});\n```\n\n## Dependencies\n\nCSS files can contain dependencies referenced by `@import` syntax, as well as references to classes in other files via [CSS modules](css-modules.html).\n\n### @import\n\nThe [`@import`](https://developer.mozilla.org/en-US/docs/Web/CSS/@import) at-rule can be used to inline another CSS file into the same CSS bundle as the containing file. This means that at runtime a separate network request will not be needed to load the dependency. Referenced files should be relative to the containing CSS file.\n\n```css\n@import 'other.css';\n```\n\n`@import` rules must appear before all other rules in a stylesheet except `@charset` and `@layer` statement rules. Later import rules will cause an error to be emitted.\n\n### CSS modules\n\nDependencies are also bundled when referencing another file via [CSS modules composition](css-modules.html#dependencies) or [external variables](css-modules.html#local-css-variables). See the linked CSS modules documentation for more details.\n\n## Conditional imports\n\nThe `@import` rule can be conditional by appending a media query or `supports()` query. Lightning CSS will preserve this behavior by wrapping the inlined rules in `@media` and `@supports` rules as needed.\n\n```css\n/* a.css */\n@import \"b.css\" print;\n@import \"c.css\" supports(display: grid);\n\n.a { color: red }\n```\n\n```css\n/* b.css */\n.b { color: green }\n```\n\n```css\n/* c.css */\n.c { display: grid }\n```\n\ncompiles to:\n\n```css\n@media print {\n .b { color: green }\n}\n\n@supports (display: grid) {\n .c { display: grid }\n}\n\n.a { color: red }\n```\n\n
\n\n**Note**: There are currently two cases where combining conditional rules is unsupported:\n\n1. Importing the same CSS file with only a media query, and again with only a supports query. This would require duplicating all rules in the file.\n2. Importing a file with a negated media type (e.g. `not print`) within another file with a negated media type.\n\n
\n\n## Cascade layers\n\nImported CSS rules can also be placed into a CSS cascade layer, allowing you to control the order they apply. Nested imports will be placed into nested layers.\n\n```css\n/* a.css */\n@import \"b.css\" layer(foo);\n.a { color: red }\n```\n\n```css\n/* b.css */\n@import \"c.css\" layer(bar);\n.b { color: green }\n```\n\n```css\n/* c.css */\n.c { color: green }\n```\n\ncompiles to:\n\n```css\n@layer foo.bar {\n .c { color: green }\n}\n\n@layer foo {\n .b { color: green }\n}\n\n.a { color: red }\n```\n\n
\n\n**Note**: There are two unsupported layer combinations that will currently emit a compiler error:\n\n1. Importing the same CSS file with different layer names. This would require duplicating all imported rules multiple times.\n2. Nested anonymous layers.\n\n
\n\n## Bundling order\n\nWhen `@import` rules are processed in browsers, if the same file appears more than once, the _last_ instance applies. This is the opposite from behavior in other languages like JavaScript. Lightning CSS follows this behavior when bundling so that the output behaves the same as if it were not bundled.\n\n```css\n/* index.css */\n@import \"a.css\";\n@import \"b.css\";\n@import \"a.css\";\n```\n\n```css\n/* a.css */\nbody { background: green }\n```\n\n```css\n/* b.css */\nbody { background: red }\n```\n\ncompiles to:\n\n```css\nbody { background: green }\n```\n\n## Custom resolvers\n\nThe `bundleAsync` API is an asynchronous version of `bundle`, which also accepts a custom `resolver` object. This allows you to provide custom JavaScript functions for resolving `@import` specifiers to file paths, and reading files from the file system (or another source). The `read` and `resolve` functions are both optional, and may either return a string synchronously, or a Promise for asynchronous resolution.\n\n`resolve` may also return a `{external: string}` object to mark an `@import` as external. This will preserve the `@import` in the output instead of bundling it. The string provided to the `external` property represents the target URL to import, which may be the original specifier or a different value.\n\nNote that using a custom resolver can slow down bundling significantly, especially when reading files asynchronously. Use `readFileSync` rather than `readFile` if possible for better performance, or omit either of the methods if you don't need to override the default behavior.\n\n```js\nimport { bundleAsync } from 'lightningcss';\n\nlet { code, map } = await bundleAsync({\n filename: 'style.css',\n minify: true,\n resolver: {\n read(filePath) {\n return fs.readFileSync(filePath, 'utf8');\n },\n resolve(specifier, from) {\n if (/^https?:/.test(specifier)) {\n return {external: specifier};\n }\n return path.resolve(path.dirname(from), specifier);\n }\n }\n});\n```\n\n
\n\n**Note:** External imports must be placed before all bundled imports in the source code. CSS does not support interleaving `@import` rules with other rules, so this is required to preserve the behavior of the source code.\n\n```css\n@import \"bundled.css\";\n@import \"https://example.com/external.css\"; /* ❌ */\n```\n\n```css\n@import \"https://example.com/external.css\"; /* ✅ */\n@import \"bundled.css\";\n```\n\n
\n" }, { "path": "website/pages/css-modules.md", "content": "\n\n# CSS modules\n\nBy default, CSS identifiers are global. If two files define the same class names, ids, custom properties, `@keyframes`, etc., they will potentially clash and overwrite each other. To solve this, Lightning CSS supports [CSS modules](https://github.com/css-modules/css-modules).\n\nCSS modules treat the classes defined in each file as unique. Each class name or identifier is renamed to include a unique hash, and a mapping is exported to JavaScript to allow referencing them.\n\nTo enable CSS modules, provide the `cssModules` option when calling the Lightning CSS API. When using the CLI, enable the `--css-modules` flag.\n\n```js\nimport {transform} from 'lightningcss';\n\nlet {code, map, exports} = transform({\n // ...\n cssModules: true,\n code: Buffer.from(`\n .logo {\n background: skyblue;\n }\n `),\n});\n```\n\nThis returns an `exports` object in addition to the compiled code and source map. Each property in the `exports` object maps from the original name in the source CSS to the compiled (i.e. hashed) name. You can use this mapping in your JavaScript or template files to reference the compiled classes and identifiers.\n\nThe exports object for the above example might look like this:\n\n```js\n{\n logo: {\n name: '8h19c6_logo',\n isReferenced: false,\n composes: []\n }\n}\n```\n\n## Class composition\n\nStyle rules in CSS modules can reference other classes with the `composes` property. This causes the referenced class to be applied whenever the composed class is used, effectively providing a form of style mixins.\n\n```css\n.bg-indigo {\n background: indigo;\n}\n\n.indigo-white {\n composes: bg-indigo;\n color: white;\n}\n```\n\nIn the above example, whenever the `indigo-white` class is applied, the `bg-indigo` class will be applied as well. This is indicated in the `exports` object returned by Lightning CSS as follows:\n\n```js\n{\n 'bg-indigo': {\n name: '8h19c6_bg-indigo',\n isReferenced: true,\n composes: []\n },\n 'indigo-white': {\n name: '8h19c6_indigo-white',\n isReferenced: false,\n composes: [{\n type: 'local',\n name: '8h19c6_bg-indigo'\n }]\n }\n}\n```\n\nMultiple classes can be composed at once by separating them with spaces.\n\n```css\n.logo {\n composes: bg-indigo padding-large;\n}\n```\n\n### Dependencies\n\nYou can also reference class names defined in a different CSS file using the `from` keyword:\n\n```css\n.logo {\n composes: bg-indigo from './colors.module.css';\n}\n```\n\nThis outputs an exports object with the dependency information. It is the caller's responsibility to resolve this dependency and apply the target class name when using the `transform` API. When using the `bundle` API, this is handled automatically.\n\n```js\n{\n logo: {\n name: '8h19c6_logo',\n isReferenced: false,\n composes: [{\n type: 'dependency',\n name: 'bg-indigo',\n specifier: './colors.module.css'\n }]\n }\n}\n```\n\n### Global composition\n\nGlobal (i.e. non-hashed) classes can also be composed using the `global` keyword:\n\n```css\n.search {\n composes: search-widget from global;\n}\n```\n\n## Global exceptions\n\nWithin a CSS module, all class and id selectors are local by default. You can also opt out of this behavior for a single selector using the `:global` pseudo class.\n\n```css\n.foo :global(.bar) {\n color: red;\n}\n\n.foo .bar {\n color: green;\n}\n```\n\ncompiles to:\n\n```css\n.EgL3uq_foo .bar {\n color: red;\n}\n\n.EgL3uq_foo .EgL3uq_bar {\n color: #ff0;\n}\n```\n\n## Local CSS variables\n\nBy default, class names, id selectors, and the names of `@keyframes`, `@counter-style`, and CSS grid lines and areas are scoped to the module they are defined in. Scoping for CSS variables and other [``](https://www.w3.org/TR/css-values-4/#dashed-idents) names can also be enabled using the `dashedIdents` option when calling the Lightning CSS API. When using the CLI, enable the `--css-modules-dashed-idents` flag.\n\n```js\nlet {code, map, exports} = transform({\n // ...\n cssModules: {\n dashedIdents: true,\n },\n});\n```\n\nWhen enabled, CSS variables will be renamed so they don't conflict with variable names defined in other files. Referencing a variable uses the standard `var()` syntax, which Lightning CSS will update to match the locally scoped variable name.\n\n```css\n:root {\n --accent-color: hotpink;\n}\n\n.button {\n background: var(--accent-color);\n}\n```\n\nbecomes:\n\n```css\n:root {\n --EgL3uq_accent-color: hotpink;\n}\n\n.EgL3uq_button {\n background: var(--EgL3uq_accent-color);\n}\n```\n\nYou can also reference variables defined in other files using the `from` keyword:\n\n```css\n.button {\n background: var(--accent-color from './vars.module.css');\n}\n```\n\nGlobal variables may be referenced using the `from global` syntax.\n\n```css\n.button {\n color: var(--color from global);\n}\n```\n\nThe same syntax also applies to other CSS values that use the [``](https://www.w3.org/TR/css-values-4/#dashed-idents) syntax. For example, the [@font-palette-values](https://drafts.csswg.org/css-fonts-4/#font-palette-values) rule and [font-palette](https://drafts.csswg.org/css-fonts-4/#propdef-font-palette) property use the `` syntax to define and refer to custom font color palettes, and will be scoped and referenced the same way as CSS variables.\n\n## Custom naming patterns\n\nBy default, Lightning CSS prepends the hash of the filename to each class name and identifier in a CSS file. You can configure this naming pattern using the `pattern` when calling the Lightning CSS API. When using the CLI, provide the `--css-modules-pattern` option.\n\nA pattern is a string with placeholders that will be filled in by Lightning CSS. This allows you to add custom prefixes or adjust the naming convention for scoped classes.\n\n```js\nlet {code, map, exports} = transform({\n // ...\n cssModules: {\n pattern: 'my-company-[name]-[hash]-[local]',\n },\n});\n```\n\nThe following placeholders are currently supported:\n\n- `[name]` - The base name of the file, without the extension.\n- `[hash]` - A hash of the full file path.\n- `[content-hash]` - A hash of the file contents.\n- `[local]` - The original class name or identifier.\n\n
\n\n### CSS Grid\n\n**Note:** CSS grid line names can be ambiguous due to automatic postfixing done by the browser, which generates line names ending with `-start` and `-end` for each grid template area. When using CSS grid, your `\"pattern\"` configuration must end with the `[local]` placeholder so that these references work correctly.\n\n```js\nlet { code, map, exports } = transform({\n // ...\n cssModules: {\n // ❌ [local] must be at the end so that\n // auto-generated grid line names work\n pattern: '[local]-[hash]'\n // ✅ do this instead\n pattern: '[hash]-[local]'\n }\n});\n```\n\n```css\n.grid {\n grid-template-areas: 'nav main';\n}\n\n.nav {\n grid-column-start: nav-start;\n}\n```\n\n
\n\n\n### Pure mode\n\nJust like the `pure` option of the `css-loader` for webpack, Lightning CSS also has a `pure` option that enforces usage of one or more id or class selectors for each rule. \n\n\n```js\nlet {code, map, exports} = transform({\n // ...\n cssModules: {\n pure: true,\n },\n});\n```\n\nIf you enable this option, Lightning CSS will throw an error for CSS rules that don't have at least one id or class selector, like `div`.\nThis is useful because selectors like `div` are not scoped and affects all elements on the page.\n\n\n\n## Turning off feature scoping\n\nScoping of grid, animations, and custom identifiers can be turned off. By default all of these are scoped.\n\n```js\nlet {code, map, exports} = transform({\n // ...\n cssModules: {\n animation: true,\n grid: true,\n customIdents: true,\n },\n});\n```\n\n## Unsupported features\n\nLightning CSS does not currently implement all CSS modules features available in other implementations. Some of these may be added in the future.\n\n- Non-function syntax for the `:local` and `:global` pseudo classes.\n- The `@value` rule – superseded by standard CSS variables.\n- The `:import` and `:export` ICSS rules.\n" }, { "path": "website/pages/docs.md", "content": "\n\n# Getting Started\n\nLightning CSS can be used as a library from JavaScript or Rust, or from a standalone CLI. It can also be wrapped as a plugin in other build tools, and it is built into [Parcel](https://parceljs.org) out of the box.\n\n## From Node\n\nFirst, install Lightning CSS using a package manager such as npm or Yarn.\n\n```shell\nnpm install --save-dev lightningcss\n```\n\nOnce installed, import the module and call one of the Lightning CSS APIs. The `transform` function compiles a CSS stylesheet from a [Node Buffer](https://nodejs.org/api/buffer.html). This example minifies the input CSS, and outputs the compiled code and a source map.\n\n```js\nimport { transform } from 'lightningcss';\n\nlet { code, map } = transform({\n filename: 'style.css',\n code: Buffer.from('.foo { color: red }'),\n minify: true,\n sourceMap: true\n});\n```\n\nSee [Transpilation](transpilation.html) for details about syntax lowering and vendor prefixing CSS for your browser targets, and the draft syntax support in Lightning CSS. You can also use the `bundle` API to process `@import` rules and inline them – see [Bundling](bundling.html) for details.\n\nThe [TypeScript definitions](https://github.com/parcel-bundler/lightningcss/blob/master/node/index.d.ts) also include documentation for all API options.\n\n## From Rust\n\nLightning CSS can also be used as a Rust library to parse, transform, and minify CSS. See the Rust API docs on [docs.rs](https://docs.rs/lightningcss).\n\n## With Parcel\n\n[Parcel](https://parceljs.org) includes Lightning CSS as the default CSS transformer. You should also add a `browserslist` property to your `package.json`, which defines the target browsers that your CSS will be compiled for.\n\nWhile Lightning CSS handles the most commonly used PostCSS plugins like `autoprefixer`, `postcss-preset-env`, and CSS modules, you may still need PostCSS for more custom plugins like TailwindCSS. If that's the case, your PostCSS config will be picked up automatically. You can remove the plugins listed above from your PostCSS config, and they'll be handled by Lightning CSS.\n\nYou can also configure Lightning CSS in the `package.json` in the root of your project. Currently, three options are supported: [drafts](transpilation.html#draft-syntax), which can be used to enable CSS nesting and custom media queries, [pseudoClasses](transpilation.html#pseudo-class-replacement), which allows replacing some pseudo classes like `:focus-visible` with normal classes that can be applied via JavaScript (e.g. polyfills), and [cssModules](css-modules.html), which enables CSS modules globally rather than only for files ending in `.module.css`, or accepts an options object.\n\n```json\n{\n \"@parcel/transformer-css\": {\n \"cssModules\": true,\n \"drafts\": {\n \"nesting\": true,\n \"customMedia\": true\n },\n \"pseudoClasses\": {\n \"focusVisible\": \"focus-ring\"\n }\n }\n}\n```\n\nSee the [Parcel docs](https://parceljs.org/languages/css) for more details.\n\n## From Deno or in browser\n\nThe `lightningcss-wasm` package can be used in Deno or directly in browsers. This uses a WebAssembly build of Lightning CSS. Use `TextEncoder` and `TextDecoder` convert code from a string to a typed array and back.\n\n```js\nimport init, { transform } from 'https://esm.run/lightningcss-wasm';\n\nawait init();\n\nlet {code, map} = transform({\n filename: 'style.css',\n code: new TextEncoder().encode('.foo { color: red }'),\n minify: true,\n});\n\nconsole.log(new TextDecoder().decode(code));\n```\n\nNote that the `bundle` and visitor APIs are not currently available in the WASM build.\n\n## With webpack\n\n[css-minimizer-webpack-plugin](https://webpack.js.org/plugins/css-minimizer-webpack-plugin/) has built in support for Lightning CSS. To use it, first install Lightning CSS in your project with a package manager like npm or Yarn:\n\n```shell\nnpm install --save-dev lightningcss css-minimizer-webpack-plugin browserslist\n```\n\nNext, configure `css-minifier-webpack-plugin` to use Lightning CSS as the minifier. You can provide options using the `minimizerOptions` object. See [Transpilation](transpilation.html) for details.\n\n```js\n// webpack.config.js\nconst CssMinimizerPlugin = require('css-minimizer-webpack-plugin');\nconst lightningcss = require('lightningcss');\nconst browserslist = require('browserslist');\n\nmodule.exports = {\n optimization: {\n minimize: true,\n minimizer: [\n new CssMinimizerPlugin({\n minify: CssMinimizerPlugin.lightningCssMinify,\n minimizerOptions: {\n targets: lightningcss.browserslistToTargets(browserslist('>= 0.25%'))\n },\n }),\n ],\n },\n};\n```\n\n## With Vite\n\nVite supports Lightning CSS out of the box. First, install Lightning CSS into your project:\n\n```shell\nnpm install --save-dev lightningcss\n```\n\nThen, set `'lightningcss'` as CSS [transformer](https://vitejs.dev/config/shared-options.html#css-transformer) and [minifier](https://vitejs.dev/config/build-options.html#build-cssminify) in your Vite config. You can also configure Lightning CSS options such as targets and css modules via the [css.lightningcss](https://vitejs.dev/config/shared-options.html#css-lightningcss) option in your Vite config.\n\n```js\n// vite.config.ts\nimport browserslist from 'browserslist';\nimport {browserslistToTargets} from 'lightningcss';\n\nexport default {\n css: {\n transformer: 'lightningcss',\n lightningcss: {\n targets: browserslistToTargets(browserslist('>= 0.25%'))\n }\n },\n build: {\n cssMinify: 'lightningcss'\n }\n};\n```\n\n## From the CLI\n\nLightning CSS includes a standalone CLI that can be used to compile, minify, and bundle CSS files. It can be used when you only need to compile CSS, and don't need more advanced functionality from a larger build tool such as code splitting and support for other languages.\n\nTo use the CLI, install the `lightningcss-cli` package with an npm compatible package manager:\n\n```shell\nnpm install --save-dev lightningcss-cli\n```\n\nThen, you can run the `lightningcss` command via `npx`, `yarn`, or by setting up a script in your package.json.\n\n```json\n{\n \"scripts\": {\n \"build\": \"lightningcss --minify --bundle --targets \\\">= 0.25%\\\" input.css -o output.css\"\n }\n}\n```\n\nTo see all of the available options, use the `--help` argument:\n\n```shell\nnpx lightningcss-cli --help\n```\n\n## Error recovery\n\nBy default, Lightning CSS is strict, and will error when parsing an invalid rule or declaration. However, sometimes you may encounter a third party library that you can't easily modify, which unintentionally contains invalid syntax, or IE-specific hacks. In these cases, you can enable the `errorRecovery` option (or `--error-recovery` CLI flag). This will skip over invalid rules and declarations, omitting them in the output, and producing a warning instead of an error. You should also open an issue or PR to fix the issue in the library if possible.\n\n## Source maps\n\nLightning CSS supports generating source maps when compiling, minifying, and bundling your source code to make debugging easier. Use the `sourceMap` option to enable it when using the API, or the `--sourcemap` CLI flag.\n\nIf the input CSS came from another compiler such as Sass or Less, you can also pass an input source map to Lightning CSS using the `inputSourceMap` API option. This will map compiled locations back to their location in the original source code.\n\nFinally, the `projectRoot` option can be used to make file paths in source maps relative to a root directory. This makes build stable between machines.\n" }, { "path": "website/pages/minification.md", "content": "\n\n# Minification\n\nLightning CSS can optimize your CSS to make it smaller, which can help improve the loading performance of your website. When using the Lightning CSS API, enable the `minify` option, or when using the CLI, use the `--minify` flag.\n\n```js\nimport { transform } from 'lightningcss';\n\nlet { code, map } = transform({\n // ...\n minify: true\n});\n```\n\n## Optimizations\n\nThe Lightning CSS minifier includes many optimizations to generate the smallest possible output for all rules, properties, and values in your stylesheet. Lightning CSS does not perform any optimizations that change the behavior of your CSS unless it can prove that it is safe to do so. For example, only adjacent style rules are merged to avoid changing the order and potentially breaking the styles.\n\n### Shorthands\n\nLightning CSS will combine longhand properties into shorthands when all of the constituent longhand properties are defined. For example:\n\n```css\n.foo {\n padding-top: 1px;\n padding-left: 2px;\n padding-bottom: 3px;\n padding-right: 4px;\n}\n```\n\nminifies to:\n\n```css\n.foo{padding:1px 4px 3px 2px}\n```\n\nThis is supported across most shorthand properties defined in the CSS spec.\n\n### Merge adjacent rules\n\nLightning CSS will merge adjacent style rules with the same selectors or declarations.\n\n```css\n.a {\n color: red;\n}\n\n.b {\n color: red;\n}\n\n.c {\n color: green;\n}\n\n.c {\n padding: 10px;\n}\n```\n\nbecomes:\n\n```css\n.a,.b{color:red}.c{color:green;padding:10px}\n```\n\nIn addition to style rules, Lightning CSS will also merge adjacent `@media`, `@supports`, and `@container` rules with identical queries, and adjacent `@layer` rules with the same layer name.\n\nLightning CSS will not merge rules that are not adjacent, e.g. if another rule is between rules with the same declarations or selectors. This is because changing the order of the rules could cause the behavior of the compiled CSS to differ from the input CSS.\n\n### Remove prefixes\n\nLightning CSS will remove vendor prefixed properties that are not needed according to your configured browser targets. This is more likely to affect precompiled libraries that include unused prefixes rather than your own code.\n\nFor example, when compiling for modern browsers, prefixed versions of the `transition` property will be removed, since the unprefixed version is supported by all browsers.\n\n```css\n.button {\n -webkit-transition: background 200ms;\n -moz-transition: background 200ms;\n transition: background 200ms;\n}\n```\n\nbecomes:\n\n```css\n.button{transition:background .2s}\n```\n\nSee [Transpilation](transpilation.html) for more on how to configure browser targets.\n\n### Reduce calc\n\nLightning CSS will reduce `calc()` and other math expressions to constant values where possible. When different units are used, the terms are reduced as much as possible.\n\n```css\n.foo {\n width: calc(100px * 2);\n height: calc(((75.37% - 63.5px) - 900px) + (2 * 100px));\n}\n```\n\nminifies to:\n\n```css\n.foo{width:200px;height:calc(75.37% - 763.5px)}\n```\n\nNote that `calc()` expressions with variables are currently left unmodified by Lightning CSS.\n\n### Minify colors\n\nLightning CSS will minify colors to the smallest format possible without changing the color gamut. For example, named colors as well as `rgb()` and `hsl()` colors are converted to hex notation, using hex alpha notation when supported by your browser targets.\n\n```css\n.foo {\n color: rgba(255, 255, 0, 0.8)\n}\n```\n\nminifies to:\n\n```css\n.foo{color:#ff0c}\n```\n\nNote that only colors in the RGB gamut (including HSL and HWB) are converted to hex. Colors in other color spaces such as LAB or P3 are preserved.\n\nIn addition to static colors, Lightning CSS also supports many color functions such as `color-mix()` and relative colors. When all components are known, Lightning CSS precomputes the result of these functions and outputs a static color. This both reduces the size and makes the syntax compatible with more browser targets.\n\n```css\n.foo {\n color: rgb(from rebeccapurple r calc(g * 2) b);\n background: color-mix(in hsl, hsl(120deg 10% 20%), hsl(30deg 30% 40%));\n}\n```\n\nminifies to:\n\n```css\n.foo{color:#669;background:#545c3d}\n```\n\nNote that these conversions cannot be performed when any of the components include CSS variables.\n\n### Normalizing values\n\nLightning CSS parses all properties and values according to the CSS specification, filling in defaults where appropriate. When minifying, it omits default values where possible since the browser will fill those in when parsing.\n\n```css\n.foo {\n background: 0% 0% / auto repeat scroll padding-box border-box red;\n}\n```\n\nminifies to:\n\n```css\n.foo{background:red}\n```\n\nIn addition to removing defaults, Lightning CSS also omits quotes, whitespace, and optional delimiters where possible. It also converts values to shorter equivalents where possible.\n\n```css\n.foo {\n font-weight: bold;\n background-position: center center;\n background-image: url(\"logo.png\");\n}\n```\n\nminifies to:\n\n```css\n.foo{background-image:url(logo.png);background-position:50%;font-weight:700}\n```\n\n### CSS grid templates\n\nLightning CSS will minify the `grid-template-areas` property to remove unnecessary whitespace and placeholders in template strings.\n\n```css\n.foo {\n grid-template-areas: \"head head\"\n \"nav main\"\n \"foot ....\";\n}\n```\n\nminifies to:\n\n```css\n.foo{grid-template-areas:\"head head\"\"nav main\"\"foot.\"}\n```\n\n### Reduce transforms\n\nLightning CSS will reduce CSS transform functions to shorter equivalents where possible.\n\n```css\n.foo {\n transform: translate(0, 50px);\n}\n```\n\nminifies to:\n\n```css\n.foo{transform:translateY(50px)}\n```\n\nIn addition, the `matrix()` and `matrix3d()` functions are converted to their equivalent transforms when shorter:\n\n```css\n.foo {\n transform: matrix3d(1, 0, 0, 0, 0, 0.707106, 0.707106, 0, 0, -0.707106, 0.707106, 0, 100, 100, 10, 1);\n}\n```\n\nminifies to:\n\n```css\n.foo{transform:translate3d(100px,100px,10px)rotateX(45deg)}\n```\n\nWhen a matrix would be shorter, individual transform functions are converted to a single matrix instead:\n\n```css\n.foo {\n transform: translate(100px, 200px) rotate(45deg) skew(10deg) scale(2);\n}\n```\n\nminifies to:\n\n```css\n.foo{transform:matrix(1.41421,1.41421,-1.16485,1.66358,100,200)}\n```\n\n## Unused symbols\n\nIf you know that certain class names, ids, `@keyframes` rules, CSS variables, or other CSS identifiers are unused (for example as part of a larger full project analysis), you can use the `unusedSymbols` option to remove them.\n\n```js\nlet { code, map } = transform({\n // ...\n minify: true,\n unusedSymbols: ['foo', 'fade-in', '--color']\n});\n```\n\nWith this configuration, the following CSS:\n\n```css\n:root {\n --color: red;\n}\n\n.foo {\n color: var(--color);\n}\n\n@keyframes fade-in {\n from { opacity: 0 }\n to { opacity: 1 }\n}\n\n.bar {\n color: green;\n}\n```\n\nminifies to:\n\n```css\n.bar{color:green}\n```\n" }, { "path": "website/pages/transforms.md", "content": "\n\n# Custom transforms\n\nThe Lightning CSS visitor API can be used to implement custom transform plugins in JavaScript. It is designed to enable custom non-standard extensions to CSS, making your code easier to author while shipping standard CSS to the browser. You can implement extensions such as custom shorthand properties or additional at-rules (e.g. mixins), build time transforms (e.g. convert units, inline constants, etc.), CSS rule analysis, and much more.\n\nCustom transforms have a build time cost: it can be around 2x slower to compile with a JS visitor than without. This means visitors should generally be used to implement custom, non-standard CSS extensions. Common standard transforms such as compiling modern standard CSS features (and draft specs) for older browsers should be done in Rust as part of Lightning CSS itself. Please open an issue if there's a feature we don't handle yet.\n\n## Visitors\n\nCustom transforms are implemented by passing a `visitor` object to the Lightning CSS Node API. A visitor includes one or more functions which are called for specific value types such as `Rule`, `Property`, or `Length`. In general, you should try to be as specific as possible about the types of values you want to handle. This way, Lightning CSS needs to call into JS as infrequently as possible, with the smallest objects possible, which improves performance. See the [TypeScript definitions](https://github.com/parcel-bundler/lightningcss/blob/eb49015cf887ae720b80a2856ccbdf61bf940ef1/node/index.d.ts#L184-L214) for a full list of available visitor functions.\n\nVisitors can return a new value to update it. Each visitor accepts a different type of value, and usually expects the same type in return. This example multiplies all lengths by 2:\n\n```js\nimport { transform } from 'lightningcss';\n\nlet res = transform({\n filename: 'test.css',\n minify: true,\n code: Buffer.from(`\n .foo {\n width: 12px;\n }\n `),\n visitor: {\n Length(length) {\n return {\n unit: length.unit,\n value: length.value * 2\n }\n }\n }\n});\n\nassert.equal(res.code.toString(), '.foo{width:24px}');\n```\n\nSome visitor functions accept an array as a return value, enabling you to replace one value with multiple, or remove a value by returning an empty array. You can also provide an object instead of a function to further reduce the number of times a visitor is called. For example, when providing a `Property` visitor, you can use an object with keys for specific property names. This improves performance by only calling your visitor function when needed.\n\nThis example adds `-webkit-overflow-scrolling: touch` before any `overflow` properties.\n\n```js\nlet res = transform({\n filename: 'test.css',\n minify: true,\n code: Buffer.from(`\n .foo {\n overflow: auto;\n }\n `),\n visitor: {\n Property: {\n overflow(property) {\n return [{\n property: 'custom',\n value: {\n name: '-webkit-overflow-scrolling',\n value: [{\n type: 'token',\n value: {\n type: 'ident',\n value: 'touch'\n }\n }]\n }\n }, property];\n },\n }\n }\n});\n\nassert.equal(res.code.toString(), '.foo{-webkit-overflow-scrolling:touch;overflow:auto}');\n```\n\n## Value types\n\nThe Lightning CSS AST is very detailed – each CSS property has a specific value type with all parts fully normalized. For example, a shorthand property such as `background` includes values for all of its sub-properties such as `background-color`, `background-image`, `background-position`, etc. This makes it both easier and faster for custom transforms to correctly handle all value types without reimplementing parsing. See the [TypeScript definitions](https://github.com/parcel-bundler/lightningcss/blob/master/node/ast.d.ts) for full documentation of all values.\n\nKnown property values can be either _parsed_ or _unparsed_. Parsed values are fully expanded following the CSS specification. Unparsed values could not be parsed according to the grammar, and are stored as raw CSS tokens. This may occur because the value is invalid, or because it included unknown values such as CSS variables. Each property visitor function will need to handle both types of values.\n\n```js\ntransform({\n code: Buffer.from(`\n .foo { width: 12px }\n .bar { width: var(--w) }\n `),\n visitor: {\n Property: {\n width(v) {\n if (v.property === 'unparsed') {\n // Handle unparsed value, e.g. `var(--w)`\n } else {\n // Handle parsed value, e.g. `12px`\n }\n }\n }\n }\n});\n```\n\nUnknown properties, including custom properties, have the property type \"custom\". These values are also stored as raw CSS tokens. To visit custom properties, use the `custom` visitor function, or an object to filter by name. For example, to handle a custom `size` property and expand it to `width` and `height`, the following transform might be used.\n\n```js\nlet res = transform({\n minify: true,\n code: Buffer.from(`\n .foo {\n size: 12px;\n }\n `),\n visitor: {\n Property: {\n custom: {\n size(property) {\n // Handle the size property when the value is a length.\n if (property.value[0].type === 'length') {\n let value = {\n type: 'length-percentage',\n value: { type: 'dimension', value: property.value[0].value }\n };\n\n return [\n { property: 'width', value },\n { property: 'height', value }\n ];\n }\n }\n }\n }\n }\n});\n\nassert.equal(res.code.toString(), '.foo{width:12px;height:12px}');\n```\n\n## Raw values\n\nThe Lightning CSS AST is very detailed, which is really useful when you need to transform it. However, it can be tedious to construct a full AST from scratch when returning entirely new values from a visitor. That's when raw values come in handy. You can return a `raw` property containing a string of CSS syntax from visitors that return declarations (i.e. properties) and tokens, and Lightning CSS will parse it for you and put it into the AST.\n\nThis example implements a custom `color` function, which returns a raw CSS color value as a string, rather than constructing the whole AST.\n\n```js\nlet res = transform({\n minify: true,\n code: Buffer.from(`\n .foo {\n color: color('red');\n }\n `),\n visitor: {\n Function: {\n color() {\n return { raw: 'rgb(255, 0, 0)' };\n }\n }\n }\n});\n\nassert.equal(res.code.toString(), '.foo{color:red}');\n```\n\n## Entry and exit visitors\n\nBy default, visitors are called when traversing downward through the tree (a pre-order traversal). This means each node is visited before its children. Sometimes it is useful to process a node after its children instead (a post-order traversal). This can be done by using an `Exit` visitor function, such as `FunctionExit`.\n\nFor example, if you had a function visitor to double a length argument, and a visitor to replace an environment variable with a value, you could use an exit visitor to process the function after its arguments.\n\n```js\nlet res = transform({\n filename: 'test.css',\n minify: true,\n code: Buffer.from(`\n .foo {\n padding: double(env(--branding-padding));\n }\n `),\n visitor: {\n FunctionExit: {\n // This will run after the EnvironmentVariable visitor, below.\n double(f) {\n if (f.arguments[0].type === 'length') {\n return {\n type: 'length',\n value: {\n unit: f.arguments[0].value.unit,\n value: f.arguments[0].value.value * 2\n }\n };\n }\n }\n },\n EnvironmentVariable: {\n // This will run before the FunctionExit visitor, above.\n '--branding-padding': () => ({\n type: 'length',\n value: {\n unit: 'px',\n value: 20\n }\n })\n }\n }\n});\n\nassert.equal(res.code.toString(), '.foo{padding:40px}');\n```\n\n## Composing visitors\n\nMultiple visitors can be combined into one using the `composeVisitors` function. This lets you reuse visitors between projects by publishing them as plugins. The AST is visited in a single pass, running the functions from each visitor object as if they were written together.\n\n```js\nimport { transform, composeVisitors } from 'lightningcss';\n\nlet environmentVisitor = {\n EnvironmentVariable: {\n '--branding-padding': () => ({\n type: 'length',\n value: {\n unit: 'px',\n value: 20\n }\n })\n }\n};\n\nlet doubleFunctionVisitor = {\n FunctionExit: {\n double(f) {\n if (f.arguments[0].type === 'length') {\n return {\n type: 'length',\n value: {\n unit: f.arguments[0].value.unit,\n value: f.arguments[0].value.value * 2\n }\n };\n }\n }\n }\n};\n\nlet res = transform({\n filename: 'test.css',\n minify: true,\n code: Buffer.from(`\n .foo {\n padding: double(env(--branding-padding));\n }\n `),\n visitor: composeVisitors([environmentVisitor, doubleFunctionVisitor])\n});\n\nassert.equal(res.code.toString(), '.foo{padding:40px}');\n```\n\nEach visitor object has the opportunity to visit every value once. If a visitor returns a new value, that value is visited by the other visitor objects but not again by the original visitor that created it. If other visitors subsequently modify the value, the previous visitors will not revisit the value. This is to avoid infinite loops.\n\n## Unknown at-rules\n\nBy default, unknown at-rules are stored in the AST as raw tokens. This allows you to interpret them however you like by writing a custom visitor. The following example allows declaring static variables using named at-rules, and inlines them when an `at-keyword` token is seen:\n\n```js\nlet declared = new Map();\nlet res = transform({\n filename: 'test.css',\n minify: true,\n code: Buffer.from(`\n @blue #056ef0;\n\n .menu_link {\n background: @blue;\n }\n `),\n visitor: {\n Rule: {\n unknown(rule) {\n declared.set(rule.name, rule.prelude);\n return [];\n }\n },\n Token: {\n 'at-keyword'(token) {\n return declared.get(token.value);\n }\n }\n }\n});\n\nassert.equal(res.code.toString(), '.menu_link{background:#056ef0}');\n```\n\n## Custom at-rules\n\nRaw tokens as stored in unknown at-rules are fine for simple cases, but in more complex cases, you may wish to interpret a custom at-rule body as a standard CSS declaration list or rule list. However, by default, Lightning CSS does not know how unknown rules should be parsed. You can define their syntax using the `customAtRules` option.\n\nThe syntax of the at-rule prelude can be defined with a [CSS syntax string](https://drafts.css-houdini.org/css-properties-values-api/#syntax-strings), which Lightning CSS will interpret and use to validate the input CSS. This uses the same syntax as the [@property](https://developer.mozilla.org/en-US/docs/Web/CSS/@property) rule. The body syntax is defined using one of the following options:\n\n* `\"declaration-list\"` – A list of CSS declarations (property value pairs), as in a style rule or other at-rules like `@font-face`.\n* `\"rule-list\"` – A list of nested CSS rules, including style rules and at rules. Directly nested declarations with CSS nesting are not allowed. This matches how rules like `@keyframes` are parsed.\n* `\"style-block\"` – A list of CSS declarations and/or nested rules. This matches the behavior of rules like `@media` and `@supports` which support directly nested declarations when inside a style rule. Note that the [nesting](transpilation.html#nesting) and [targets](transpilation.html#browser-targets) options must be defined for nesting to be compiled.\n\nThis example defines two custom at-rules. `@mixin` defines a reusable style block, supporting both directly nested declarations and nested rules. A visitor function registers the mixin in a map and removes the custom rule. `@apply` looks up the requested mixin in the map and returns the nested rules, which are inlined into the parent.\n\n```js\nlet mixins = new Map();\nlet res = transform({\n filename: 'test.css',\n minify: true,\n targets: { chrome: 100 << 16 },\n code: Buffer.from(`\n @mixin color {\n color: red;\n\n &.bar {\n color: yellow;\n }\n }\n\n .foo {\n @apply color;\n }\n `),\n customAtRules: {\n mixin: {\n prelude: '',\n body: 'style-block'\n },\n apply: {\n prelude: ''\n }\n },\n visitor: {\n Rule: {\n custom: {\n mixin(rule) {\n mixins.set(rule.prelude.value, rule.body.value);\n return [];\n },\n apply(rule) {\n return mixins.get(rule.prelude.value);\n }\n }\n }\n }\n});\n\nassert.equal(res.code.toString(), '.foo{color:red}.foo.bar{color:#ff0}');\n```\n\n## Dependencies\n\nVisitors can emit dependencies so the caller (e.g. bundler) knows to re-run the transformation or invalidate a cache when those files change. These are returned as part of the result's `dependencies` property (along with other dependencies when the `analyzeDependencies` option is enabled).\n\nBy passing a function to the `visitor` option instead of an object, you get access to the `addDependency` function. This accepts a dependency object with `type: 'file'` or `type: 'glob'`. File dependencies invalidate the transformation whenever the `filePath` changes (created, updated, or deleted). Glob dependencies invalidate whenever any file matched by the glob changes. `composeVisitors` also supports function visitors.\n\nBy default, Lightning CSS does not do anything with these dependencies except return them to the caller. It's the caller's responsibility to implement file watching and cache invalidation accordingly.\n\n```js\nlet res = transform({\n filename: 'test.css',\n code: Buffer.from(`\n @dep \"foo.js\";\n @glob \"**/*.json\";\n\n .foo {\n width: 32px;\n }\n `),\n visitor: ({addDependency}) => ({\n Rule: {\n unknown: {\n dep(rule) {\n let file = rule.prelude[0].value.value;\n addDependency({\n type: 'file',\n filePath: file\n });\n return [];\n },\n glob(rule) {\n let glob = rule.prelude[0].value.value;\n addDependency({\n type: 'glob',\n glob\n });\n return [];\n }\n }\n }\n })\n});\n\nassert.equal(res.dependencies, [\n {\n type: 'file',\n filePath: 'foo.js'\n },\n {\n type: 'glob',\n filePath: '**/*.json'\n }\n]);\n```\n\n## Examples\n\nFor examples of visitors that perform a variety of real world tasks, see the Lightning CSS [visitor tests](https://github.com/parcel-bundler/lightningcss/blob/master/node/test/visitor.test.mjs).\n\n## Publishing a plugin\n\nVisitor plugins can be published to npm in order to share them with others. Plugin packages simply consist of an exported visitor object, which users can compose with other plugins via the `composeVisitors` function as described above.\n\n```js\n// lightningcss-plugin-double-function\nexport default {\n FunctionExit: {\n double(f) {\n // ...\n }\n }\n};\n```\n\nPlugins can also export a function in order to accept options.\n\n```js\n// lightningcss-plugin-env\nexport default (values) => ({\n EnvironmentVariable(env) {\n return values[env.name];\n }\n});\n```\n\nPlugin package names should start with `lightningcss-plugin-` and be descriptive about what they do, e.g. `lightningcss-plugin-double-function`. In addition, they should include the `lightningcss-plugin` keyword in their package.json so people can find them on npm.\n\n```json\n{\n \"name\": \"lightningcss-plugin-double-function\",\n \"keywords\": [\"lightningcss-plugin\"],\n \"main\": \"plugin.mjs\"\n}\n```\n\n## Using plugins\n\nTo use a published visitor plugin, install the package from npm, import it, and use the `composeVisitors` function as described above.\n\n```js\nimport { transform, composeVisitors } from 'lightningcss';\nimport environmentVisitor from 'lightningcss-plugin-environment';\nimport doubleFunctionVisitor from 'lightningcss-plugin-double-function';\n\nlet res = transform({\n filename: 'test.css',\n minify: true,\n code: Buffer.from(`\n .foo {\n padding: double(env(--branding-padding));\n }\n `),\n visitor: composeVisitors([\n environmentVisitor({\n '--branding-padding': {\n type: 'length',\n value: {\n unit: 'px',\n value: 20\n }\n }\n }),\n doubleFunctionVisitor\n ])\n});\n\nassert.equal(res.code.toString(), '.foo{padding:40px}');\n```\n" }, { "path": "website/pages/transpilation.md", "content": "\n\n# Transpilation\n\nLightning CSS includes support for transpiling modern CSS syntax to support older browsers, including vendor prefixing and syntax lowering.\n\n## Browser targets\n\nBy default Lightning CSS does not perform any transpilation of CSS syntax for older browsers. This means that if you write your code using modern syntax or without vendor prefixes, that’s what Lightning CSS will output. You can declare your app’s supported browsers using the `targets` option. When this is declared, Lightning CSS will transpile your code accordingly to ensure compatibility with your supported browsers.\n\nTargets are defined using an object that specifies the minimum version of each browser you want to support. The easiest way to build a targets object is to use [browserslist](https://browserslist.dev). This lets you use a query that automatically updates over time as new browser versions are released, market share changes, etc. The following example will return a targets object listing browsers with >= 0.25% market share.\n\n```js\nimport browserslist from 'browserslist';\nimport { transform, browserslistToTargets } from 'lightningcss';\n\n// Call this once per build.\nlet targets = browserslistToTargets(browserslist('>= 0.25%'));\n\n// Use `targets` for each file you transform.\nlet { code, map } = transform({\n // ...\n targets\n});\n```\n\nFor the best performance, you should call browserslist once for your whole build process, and reuse the same `targets` object when calling `transform` for each file.\n\nUnder the hood, `targets` are represented using an object that maps browser names to minimum versions. Version numbers are represented using a single 24-bit number, with one semver component (major, minor, patch) per byte. For example, this targets object would represent Safari 13.2.0.\n\n```js\nlet targets = {\n safari: (13 << 16) | (2 << 8)\n};\n```\n\n### CLI\n\nWhen using the CLI, targets can be provided by passing a [browserslist](https://browserslist.dev) query to the `--targets` option. Alternatively, if the `--browserslist` option is provided, then `lightningcss` finds browserslist configuration, selects queries by environment and loads the resulting queries as targets.\n\nConfiguration discovery and targets resolution is modeled after the original `browserslist` Node package. The configuration is resolved in the following order:\n\n- If a `BROWSERSLIST` environment variable is present, then load targets from its value.\n- If a `BROWSERSLIST_CONFIG` environment variable is present, then load the browserslist configuration from the file at the provided path.\n- If none of the above apply, then find, parse and use targets from the first `browserslist`, `.browserslistrc`, or `package.json` configuration file in any parent directory.\n\nBrowserslist configuration files may contain sections denoted by square brackets. Use these to specify different targets for different environments. Targets which are not placed in a section are added to `defaults` and used if no section matches the environment.\n\n```ini\n# Defaults, applied when no other section matches the provided environment.\nfirefox ESR\n\n# Targets applied only to the staging environment.\n[staging]\nsamsung >= 4\n```\n\nWhen using parsed configuration from `browserslist`, `.browserslistrc`, or `package.json` configuration files, the environment is determined by:\n\n- the `BROWSERSLIST_ENV` environment variable if present\n- the `NODE_ENV` environment variable if present\n- otherwise `\"production\"` is used.\n\nIf no targets are found for the resulting environment, then the `defaults` configuration section is used.\n\n### Feature flags\n\nIn most cases, setting the `targets` option and letting Lightning CSS automatically compile your CSS works great. However, in other cases you might need a little more control over exactly what features are compiled and which are not. That's where the `include` and `exclude` options come in.\n\nThe `include` and `exclude` options allow you to explicitly turn on or off certain features. These override the defaults based on the provided browser targets. For example, you might want to only compile colors, and handle auto prefixing or other features with another tool. Or you may want to handle everything except vendor prefixing with Lightning CSS. These options make that possible.\n\nThe `include` and `exclude` options are configured using the `Features` enum, which can be imported from `lightningcss`. You can bitwise OR multiple flags together to turn them on or off.\n\n```js\nimport { transform, Features } from 'lightningcss';\n\nlet { code, map } = transform({\n // ...\n targets,\n // Always compile colors and CSS nesting, regardless of browser targets.\n include: Features.Colors | Features.Nesting,\n // Never add any vendor prefixes, regardless of targets.\n exclude: Features.VendorPrefixes\n});\n```\n\nHere is a full list of available flags, described in the sections below:\n\n
\n\n* `Nesting`\n* `NotSelectorList`\n* `DirSelector`\n* `LangSelectorList`\n* `IsSelector`\n* `TextDecorationThicknessPercent`\n* `MediaIntervalSyntax`\n* `MediaRangeSyntax`\n* `CustomMediaQueries`\n* `ClampFunction`\n* `ColorFunction`\n* `OklabColors`\n* `LabColors`\n* `P3Colors`\n* `HexAlphaColors`\n* `SpaceSeparatedColorNotation`\n* `LightDark`\n* `FontFamilySystemUi`\n* `DoublePositionGradients`\n* `VendorPrefixes`\n* `LogicalProperties`\n* `Selectors` – shorthand for `Nesting | NotSelectorList | DirSelector | LangSelectorList | IsSelector`\n* `MediaQueries` – shorthand for `MediaIntervalSyntax | MediaRangeSyntax | CustomMediaQueries`\n* `Colors` – shorthand for `ColorFunction | OklabColors | LabColors | P3Colors | HexAlphaColors | SpaceSeparatedColorNotation | LightDark`\n\n
\n\n## Vendor prefixing\n\nBased on your configured browser targets, Lightning CSS automatically adds vendor prefixed fallbacks for many CSS features. For example, when using the [`image-set()`](https://developer.mozilla.org/en-US/docs/Web/CSS/image/image-set()) function, Lightning CSS will output a fallback `-webkit-image-set()` value as well, since Chrome does not yet support the unprefixed value.\n\n```css\n.logo {\n background: image-set(url(logo.png) 2x, url(logo.png) 1x);\n}\n```\n\ncompiles to:\n\n```css\n.logo {\n background: -webkit-image-set(url(logo.png) 2x, url(logo.png) 1x);\n background: image-set(\"logo.png\" 2x, \"logo.png\");\n}\n```\n\nIn addition, if your CSS source code (or more likely a library) includes unnecessary vendor prefixes, Lightning CSS will automatically remove them to reduce bundle sizes. For example, when compiling for modern browsers, prefixed versions of the `transition` property will be removed, since the unprefixed version is supported by all browsers.\n\n```css\n.button {\n -webkit-transition: background 200ms;\n -moz-transition: background 200ms;\n transition: background 200ms;\n}\n```\n\nbecomes:\n\n```css\n.button {\n transition: background .2s;\n}\n```\n\n## Syntax lowering\n\nLightning CSS automatically compiles many modern CSS syntax features to more compatible output that is supported in your target browsers.\n\n### Nesting\n\nThe [CSS Nesting](https://drafts.csswg.org/css-nesting/) spec enables style rules to be nested, with the selectors of the child rules extending the parent selector in some way. This is very commonly supported by CSS pre-processors like Sass, but with this spec, it will eventually be supported natively in browsers. Lightning CSS compiles this syntax to un-nested style rules that are supported in all browsers today.\n\n```css\n.foo {\n color: blue;\n\n .bar {\n color: red;\n }\n}\n```\n\nis equivalent to:\n\n```css\n.foo {\n color: blue;\n}\n\n.foo .bar {\n color: red;\n}\n```\n\n[Conditional rules](https://drafts.csswg.org/css-nesting/#conditionals) such as `@media` may also be nested within a style rule, without repeating the selector. For example:\n\n```css\n.foo {\n display: grid;\n\n @media (orientation: landscape) {\n grid-auto-flow: column;\n }\n}\n```\n\nis equivalent to:\n\n```css\n.foo {\n display: grid;\n}\n\n@media (orientation: landscape) {\n .foo {\n grid-auto-flow: column;\n }\n}\n```\n\n### Color mix\n\nThe [`color-mix()`](https://drafts.csswg.org/css-color-5/#color-mix) function allows you to mix two colors by the specified amount in a certain color space. Lightning CSS will evaluate this function statically when all components are known (i.e. not variables).\n\n```css\n.foo {\n color: color-mix(in hsl, hsl(120deg 10% 20%) 25%, hsl(30deg 30% 40%));\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n color: #706a43;\n}\n```\n\n### Relative colors\n\nRelative colors allow you to modify the components of a color using math functions. In addition, you can convert colors between color spaces. Lightning CSS performs these calculations statically when all components are known (i.e. not variables).\n\nThis example lightens `slateblue` by 10% in the LCH color space.\n\n```css\n.foo {\n color: lch(from slateblue calc(l * 1.1) c h);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n color: lch(49.0282% 65.7776 296.794);\n}\n```\n\n### LAB colors\n\nLightning CSS will convert [`lab()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/lab()), [`lch()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/lch()), [`oklab()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/oklab), and [`oklch()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/oklch) colors to fallback values for unsupported browsers when needed. These functions allow you to define colors in higher gamut color spaces, making it possible to use colors that cannot be represented by RGB.\n\n```css\n.foo {\n color: lab(40% 56.6 39);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n color: #b32323;\n color: color(display-p3 .643308 .192455 .167712);\n color: lab(40% 56.6 39);\n}\n```\n\nAs shown above, a `display-p3` fallback is included in addition to RGB when a target browser supports the P3 color space. This preserves high color gamut colors when possible.\n\n### Color function\n\nLightning CSS converts the [`color()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color()) function to RGB when needed for compatibility with older browsers. This allows you to use predefined color spaces such as `display-p3`, `xyz`, and `a98-rgb`.\n\n```css\n.foo {\n color: color(a98-rgb 0.44091 0.49971 0.37408);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n color: #6a805d;\n color: color(a98-rgb .44091 .49971 .37408);\n}\n```\n\n### HWB colors\n\nLightning CSS converts [`hwb()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/hwb) colors to RGB.\n\n```css\n.foo {\n color: hwb(194 0% 0%);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n color: #00c4ff;\n}\n```\n\n### Color notation\n\nSpace separated color notation is converted to hex when needed. Hex colors with alpha are also converted to `rgba()` when unsupported by all targets.\n\n```css\n.foo {\n color: #7bffff80;\n background: rgb(123 255 255);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n color: rgba(123, 255, 255, .5);\n background: #7bffff;\n}\n```\n\n### light-dark() color function\n\nThe [`light-dark()`](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/light-dark) function allows you to specify a light mode and dark mode color in a single declaration, without needing to write a separate media query rule. In addition, it uses the [`color-scheme`](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme) property to control which theme to use, which allows you to set it programmatically. The `color-scheme` property also inherits so themes can be nested and the nearest ancestor color scheme applies.\n\nLightning CSS converts the `light-dark()` function to use CSS variable fallback when your browser targets don't support it natively. For this to work, you must set the `color-scheme` property on an ancestor element. The following example shows how you can support both operating system and programmatic overrides for the color scheme.\n\n```css\nhtml {\n color-scheme: light dark;\n}\n\nhtml[data-theme=light] {\n color-scheme: light;\n}\n\nhtml[data-theme=dark] {\n color-scheme: dark;\n}\n\nbutton {\n background: light-dark(#aaa, #444);\n}\n```\n\ncompiles to:\n\n```css\nhtml {\n --lightningcss-light: initial;\n --lightningcss-dark: ;\n color-scheme: light dark;\n}\n\n@media (prefers-color-scheme: dark) {\n html {\n --lightningcss-light: ;\n --lightningcss-dark: initial;\n }\n}\n\nhtml[data-theme=\"light\"] {\n --lightningcss-light: initial;\n --lightningcss-dark: ;\n color-scheme: light;\n}\n\nhtml[data-theme=\"dark\"] {\n --lightningcss-light: ;\n --lightningcss-dark: initial;\n color-scheme: dark;\n}\n\nbutton {\n background: var(--lightningcss-light, #aaa) var(--lightningcss-dark, #444);\n}\n```\n\n### Logical properties\n\nCSS [logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Logical_Properties) allow you to define values in terms of writing direction, so that UIs mirror in right-to-left languages. Lightning CSS will compile these to use the `:dir()` selector when unsupported. If the `:dir()` selector is unsupported, it is compiled as described [below](#%3Adir()-selector).\n\n```css\n.foo {\n border-start-start-radius: 20px\n}\n```\n\ncompiles to:\n\n```css\n.foo:dir(ltr) {\n border-top-left-radius: 20px;\n}\n\n.foo:dir(rtl) {\n border-top-right-radius: 20px;\n}\n```\n\n\n### :dir() selector\n\nThe [`:dir()`](https://developer.mozilla.org/en-US/docs/Web/CSS/:dir) selector matches elements based on the writing direction. Lightning CSS compiles this to use the `:lang()` selector when unsupported, which approximates this behavior as closely as possible.\n\n```css\na:dir(rtl) {\n color:red\n}\n```\n\ncompiles to:\n\n```css\na:lang(ae, ar, arc, bcc, bqi, ckb, dv, fa, glk, he, ku, mzn, nqo, pnb, ps, sd, ug, ur, yi) {\n color: red;\n}\n```\n\nIf multiple arguments to `:lang()` are unsupported, it is compiled as described [below](#%3Alang()-selector).\n\n### :lang() selector\n\nThe [`:lang()`](https://developer.mozilla.org/en-US/docs/Web/CSS/:lang) selector matches elements based on their language. Some browsers do not support multiple arguments to this function, so Lightning CSS compiles them to use `:is()` when needed.\n\n```css\na:lang(en, fr) {\n color:red\n}\n```\n\ncompiles to:\n\n```css\na:is(:lang(en), :lang(fr)) {\n color: red;\n}\n```\n\nWhen the `:is()` selector is unsupported, it is compiled as described [below](#%3Ais()-selector).\n\n### :is() selector\n\nThe [`:is()`](https://developer.mozilla.org/en-US/docs/Web/CSS/:is) matches when one of its arguments matches. Lightning CSS falls back to the `:-webkit-any` and `:-moz-any` prefixed selectors.\n\n```css\np:is(:first-child, .lead) {\n margin-top: 0;\n}\n```\n\ncompiles to:\n\n```css\np:-webkit-any(:first-child, .lead) {\n margin-top: 0;\n}\n\np:-moz-any(:first-child, .lead) {\n margin-top: 0;\n}\n\np:is(:first-child, .lead) {\n margin-top: 0;\n}\n```\n\n
\n\n**Note**: The prefixed versions of these selectors do not support complex selectors (e.g. selectors with combinators). Lightning CSS will only output prefixes if the arguments are simple selectors. Complex selectors in `:is()` are not currently compiled.\n\n
\n\n### :not() selector\n\nThe [`:not()`](https://developer.mozilla.org/en-US/docs/Web/CSS/:not) selector can accept multiple arguments, and matches if none of the arguments match. Some older browsers only support a single argument, so Lightning CSS compiles this when needed. The `:is` selector is used to ensure the specificity remains the same, with fallback to `-webkit-any` and `-moz-any` as needed (described above).\n\n```css\np:not(:first-child, .lead) {\n margin-top: 1em;\n}\n```\n\ncompiles to:\n\n```css\np:not(:is(:first-child, .lead)) {\n margin-top: 1em;\n}\n```\n\n### Math functions\n\nLightning CSS simplifies [math functions](https://w3c.github.io/csswg-drafts/css-values/#math) including `clamp()`, `round()`, `rem()`, `mod()`, `abs()`, and `sign()`, [trigonometric functions](https://w3c.github.io/csswg-drafts/css-values/#trig-funcs) including `sin()`, `cos()`, `tan()`, `asin()`, `acos()`, `atan()`, and `atan2()`, and [exponential functions](https://w3c.github.io/csswg-drafts/css-values/#exponent-funcs) including `pow()`, `log()`, `sqrt()`, `exp()`, and `hypot()` when all arguments are known (i.e. not variables). In addition, the numeric constants `e`, `pi`, `infinity`, `-infinity`, and `NaN` are supported in all calculations.\n\n```css\n.foo {\n width: round(calc(100px * sin(pi / 4)), 5px);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n width: 70px;\n}\n```\n\n### Media query ranges\n\n[Media query range syntax](https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries#syntax_improvements_in_level_4) allows defining media queries using comparison operators to create ranges and intervals. Lightning CSS compiles this to the corresponding `min` and `max` media features when needed.\n\n```css\n@media (480px <= width <= 768px) {\n .foo { color: red }\n}\n```\n\ncompiles to:\n\n```css\n@media (min-width: 480px) and (max-width: 768px) {\n .foo { color: red }\n}\n```\n\n### Shorthands\n\nLightning CSS compiles the following shorthands to corresponding longhands when the shorthand is not supported in all target browsers:\n\n* Alignment shorthands: [place-items](https://developer.mozilla.org/en-US/docs/Web/CSS/place-items), [place-content](https://developer.mozilla.org/en-US/docs/Web/CSS/place-content), [place-self](https://developer.mozilla.org/en-US/docs/Web/CSS/place-self)\n* [Overflow shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/overflow) with multiple values (e.g. `overflow: hidden auto`)\n* [text-decoration](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration) with thickness, style, color, etc.\n* Two value [display](https://developer.mozilla.org/en-US/docs/Web/CSS/display) syntax (e.g. `display: inline flex`)\n\n### Double position gradients\n\nCSS gradients support using two positions in a color stop to repeat the color at two subsequent positions. When unsupported, Lightning CSS compiles it.\n\n```css\n.foo {\n background: linear-gradient(green, red 30% 40%, pink);\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n background: linear-gradient(green, red 30%, red 40%, pink);\n}\n```\n\n### system-ui font\n\nThe `system-ui` font allows you to use the operating system default font. When unsupported, Lightning CSS compiles it to a font stack that works across major platforms.\n\n```css\n.foo {\n font-family: system-ui;\n}\n```\n\ncompiles to:\n\n```css\n.foo {\n font-family: system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Noto Sans, Ubuntu, Cantarell, Helvetica Neue;\n}\n```\n\n## Draft syntax\n\nLightning CSS can also be configured to compile several draft specs that are not yet available natively in any browser. Because these are drafts and the syntax can still change, they must be enabled manually in your project.\n\n### Custom media queries\n\nSupport for [custom media queries](https://drafts.csswg.org/mediaqueries-5/#custom-mq) is included in the Media Queries Level 5 draft spec. This allows you to define media queries that are reused in multiple places within a CSS file. Lightning CSS will perform this substitution ahead of time when this feature is enabled.\n\nFor example:\n\n```css\n@custom-media --modern (color), (hover);\n\n@media (--modern) and (width > 1024px) {\n .a { color: green; }\n}\n```\n\nis equivalent to:\n\n```css\n@media ((color) or (hover)) and (width > 1024px) {\n .a { color: green; }\n}\n```\n\nBecause custom media queries are a draft, they are not enabled by default. To use them, enable the `customMedia` option under `drafts` when calling the Lightning CSS API. When using the CLI, enable the `--custom-media` flag.\n\n```js\nlet { code, map } = transform({\n // ...\n drafts: {\n customMedia: true\n }\n});\n```\n\n## Pseudo class replacement\n\nLightning CSS supports replacing CSS pseudo classes such as `:focus-visible` with normal CSS classes that can be applied using JavaScript. This makes it possible to polyfill these pseudo classes for older browsers.\n\n```js\nlet { code, map } = transform({\n // ...\n pseudoClasses: {\n focusVisible: 'focus-visible'\n }\n});\n```\n\nThe above configuration will result in the `:focus-visible` pseudo class in all selectors being replaced with the `.focus-visible` class. This enables you to use a JavaScript [polyfill](https://github.com/WICG/focus-visible), which will apply the `.focus-visible` class as appropriate.\n\nThe following pseudo classes may be configured as shown above:\n\n* `hover` – corresponds to the `:hover` pseudo class\n* `active` – corresponds to the `:active` pseudo class\n* `focus` – corresponds to the `:focus` pseudo class\n* `focusVisible` – corresponds to the `:focus-visible` pseudo class\n* `focusWithin` – corresponds to the `:focus-within` pseudo class\n\n## Non-standard syntax\n\nFor compatibility with other tools, Lightning CSS supports parsing some non-standard CSS syntax. This must be enabled by turning on a flag under the `nonStandard` option.\n\n```js\nlet { code, map } = transform({\n // ...\n nonStandard: {\n deepSelectorCombinator: true\n }\n});\n\n```\n\nCurrently the following features are supported:\n\n* `deepSelectorCombinator` – enables parsing the Vue/Angular `>>>` and `/deep/` selector combinators.\n" }, { "path": "website/playground/index.html", "content": "\n\n \n ⚡️ Lightning CSS Playground\n \n \n \n
\n \n \n \n

Lightning CSS Playground

\n \n GitHub \n \n
\n
\n
\n

Options

\n \n \n \n \n

Draft syntax

\n \n

Targets

\n
\n \n \n \n \n \n \n \n \n \n
\n

Features

\n
\n Include\n
\n
\n
\n Exclude\n
\n
\n \n \n
\n
\n
\n
\n \n \n
\n \n \n\n" }, { "path": "website/playground/playground.js", "content": "import * as localWasm from '../../wasm';\nimport { EditorView, basicSetup } from 'codemirror';\nimport { javascript } from '@codemirror/lang-javascript';\nimport { css } from '@codemirror/lang-css';\nimport { oneDark } from '@codemirror/theme-one-dark';\nimport { syntaxTree } from '@codemirror/language';\nimport { linter, lintGutter } from '@codemirror/lint'\nimport { Compartment } from '@codemirror/state'\n\nconst linterCompartment = new Compartment;\nconst visitorLinterCompartment = new Compartment;\n\nlet wasm;\nlet editor, visitorEditor, outputEditor, modulesEditor, depsEditor;\nlet enc = new TextEncoder();\nlet dec = new TextDecoder();\nlet inputs = document.querySelectorAll('input[type=number]');\n\nasync function loadVersions() {\n const { versions } = await fetch('https://data.jsdelivr.com/v1/package/npm/lightningcss-wasm').then(r => r.json());\n versions\n .map(v => {\n const option = document.createElement('option');\n option.value = v;\n option.textContent = v;\n return option;\n })\n .forEach(o => {\n version.appendChild(o);\n })\n}\n\nasync function loadWasm() {\n if (version.value === 'local') {\n wasm = localWasm;\n } else {\n wasm = await new Function('version', 'return import(`https://esm.sh/lightningcss-wasm@${version}?bundle`)')(version.value);\n }\n await wasm.default();\n}\n\nfunction loadPlaygroundState() {\n const hash = window.location.hash.slice(1);\n try {\n return JSON.parse(decodeURIComponent(hash));\n } catch {\n return {\n minify: minify.checked,\n visitorEnabled: visitorEnabled.checked,\n targets: getTargets(),\n include: 0,\n exclude: 0,\n source: `@custom-media --modern (color), (hover);\n\n.foo {\n background: yellow;\n\n -webkit-border-radius: 2px;\n -moz-border-radius: 2px;\n border-radius: 2px;\n\n -webkit-transition: background 200ms;\n -moz-transition: background 200ms;\n transition: background 200ms;\n\n &.bar {\n color: green;\n }\n}\n\n@media (--modern) and (width > 1024px) {\n .a {\n color: green;\n }\n}`,\n version: version.value,\n visitor: `{\n Color(color) {\n if (color.type === 'rgb') {\n color.g = 0;\n return color;\n }\n }\n}`\n };\n }\n}\n\nfunction reflectPlaygroundState(playgroundState) {\n if (typeof playgroundState.minify !== 'undefined') {\n minify.checked = playgroundState.minify;\n }\n\n if (typeof playgroundState.cssModules !== 'undefined') {\n cssModules.checked = playgroundState.cssModules;\n compiledModules.hidden = !playgroundState.cssModules;\n }\n\n if (typeof playgroundState.analyzeDependencies !== 'undefined') {\n analyzeDependencies.checked = playgroundState.analyzeDependencies;\n compiledDependencies.hidden = !playgroundState.analyzeDependencies;\n }\n\n if (typeof playgroundState.customMedia !== 'undefined') {\n customMedia.checked = playgroundState.customMedia;\n }\n\n if (typeof playgroundState.visitorEnabled !== 'undefined') {\n visitorEnabled.checked = playgroundState.visitorEnabled;\n }\n\n if (playgroundState.targets) {\n const { targets } = playgroundState;\n for (let input of inputs) {\n let value = targets[input.id];\n input.value = value == null ? '' : value >> 16;\n }\n }\n\n updateFeatures(sidebar.elements.include, playgroundState.include);\n updateFeatures(sidebar.elements.exclude, playgroundState.exclude);\n if (playgroundState.include) {\n include.parentElement.open = true;\n }\n if (playgroundState.exclude) {\n exclude.parentElement.open = true;\n }\n\n if (playgroundState.unusedSymbols) {\n unusedSymbols.value = playgroundState.unusedSymbols.join('\\n');\n }\n\n if (playgroundState.version) {\n version.value = playgroundState.version;\n }\n}\n\nfunction savePlaygroundState() {\n let data = new FormData(sidebar);\n const playgroundState = {\n minify: minify.checked,\n customMedia: customMedia.checked,\n cssModules: cssModules.checked,\n analyzeDependencies: analyzeDependencies.checked,\n targets: getTargets(),\n include: getFeatures(data.getAll('include')),\n exclude: getFeatures(data.getAll('exclude')),\n source: editor.state.doc.toString(),\n visitorEnabled: visitorEnabled.checked,\n visitor: visitorEditor.state.doc.toString(),\n unusedSymbols: unusedSymbols.value.split('\\n').map(v => v.trim()).filter(Boolean),\n version: version.value,\n };\n\n const hash = encodeURIComponent(JSON.stringify(playgroundState));\n\n if (\n typeof URL === 'function' &&\n typeof history === 'object' &&\n typeof history.replaceState === 'function'\n ) {\n const url = new URL(location.href);\n url.hash = hash;\n history.replaceState(null, null, url);\n } else {\n location.hash = hash;\n }\n}\n\nfunction getTargets() {\n let targets = {};\n for (let input of inputs) {\n if (input.value !== '') {\n targets[input.id] = input.valueAsNumber << 16;\n }\n }\n\n return targets;\n}\n\nfunction getFeatures(vals) {\n let features = 0;\n for (let name of vals) {\n features |= wasm.Features[name];\n }\n return features;\n}\n\nfunction updateFeatures(elements, include) {\n for (let checkbox of elements) {\n let feature = wasm.Features[checkbox.value];\n checkbox.checked = (include & feature) === feature;\n checkbox.indeterminate = !checkbox.checked && (include & feature);\n }\n}\n\nfunction update() {\n const { transform } = wasm;\n\n const targets = getTargets();\n let data = new FormData(sidebar);\n let include = getFeatures(data.getAll('include'));\n let exclude = getFeatures(data.getAll('exclude'));\n try {\n let res = transform({\n filename: 'test.css',\n code: enc.encode(editor.state.doc.toString()),\n minify: minify.checked,\n targets: Object.keys(targets).length === 0 ? null : targets,\n include,\n exclude,\n drafts: {\n customMedia: customMedia.checked\n },\n cssModules: cssModules.checked,\n analyzeDependencies: analyzeDependencies.checked,\n unusedSymbols: unusedSymbols.value.split('\\n').map(v => v.trim()).filter(Boolean),\n visitor: visitorEnabled.checked ? (0, eval)('(' + visitorEditor.state.doc.toString() + ')') : undefined,\n });\n\n let update = outputEditor.state.update({ changes: { from: 0, to: outputEditor.state.doc.length, insert: dec.decode(res.code) } });\n outputEditor.update([update]);\n\n if (res.exports) {\n let update = modulesEditor.state.update({ changes: { from: 0, to: modulesEditor.state.doc.length, insert: '// CSS module exports\\n' + JSON.stringify(res.exports, false, 2) } });\n modulesEditor.update([update]);\n }\n\n if (res.dependencies) {\n let update = depsEditor.state.update({ changes: { from: 0, to: depsEditor.state.doc.length, insert: '// Dependencies\\n' + JSON.stringify(res.dependencies, false, 2) } });\n depsEditor.update([update]);\n }\n\n compiledModules.hidden = !cssModules.checked;\n compiledDependencies.hidden = !analyzeDependencies.checked;\n visitor.hidden = !visitorEnabled.checked;\n source.dataset.expanded = visitor.hidden;\n compiled.dataset.expanded = compiledModules.hidden && compiledDependencies.hidden;\n compiledModules.dataset.expanded = compiledDependencies.hidden;\n compiledDependencies.dataset.expanded = compiledModules.hidden;\n\n editor.dispatch({\n effects: linterCompartment.reconfigure(createCssLinter(null, res.warnings))\n });\n\n visitorEditor.dispatch({\n effects: visitorLinterCompartment.reconfigure(createVisitorLinter(null))\n });\n } catch (e) {\n let update = outputEditor.state.update({ changes: { from: 0, to: outputEditor.state.doc.length, insert: `/* ERROR: ${e.message} */` } });\n outputEditor.update([update]);\n\n editor.dispatch({\n effects: linterCompartment.reconfigure(createCssLinter(e))\n });\n\n visitorEditor.dispatch({\n effects: visitorLinterCompartment.reconfigure(createVisitorLinter(e))\n });\n }\n\n savePlaygroundState();\n}\n\nfunction createCssLinter(lastError, warnings) {\n return linter(view => {\n let diagnostics = [];\n if (lastError && lastError.loc) {\n let l = view.state.doc.line(lastError.loc.line);\n let loc = l.from + lastError.loc.column - 1;\n let node = syntaxTree(view.state).resolveInner(loc, 1);\n diagnostics.push(\n {\n from: node.from,\n to: node.to,\n message: lastError.message,\n severity: 'error'\n }\n );\n }\n if (warnings) {\n for (let warning of warnings) {\n let l = view.state.doc.line(warning.loc.line);\n let loc = l.from + warning.loc.column - 1;\n let node = syntaxTree(view.state).resolveInner(loc, 1);\n diagnostics.push({\n from: node.from,\n to: node.to,\n message: warning.message,\n severity: 'warning'\n });\n }\n }\n return diagnostics;\n }, { delay: 0 });\n}\n\nfunction createVisitorLinter(lastError) {\n return linter(view => {\n if (lastError && !lastError.loc) {\n // Firefox has lineNumber and columnNumber, Safari has line and column.\n let line = lastError.lineNumber ?? lastError.line;\n let column = lastError.columnNumber ?? lastError.column;\n if (lastError.column != null) {\n column--;\n }\n\n if (line == null) {\n // Chrome.\n let match = lastError.stack.match(/(?:(?:eval.*:)|(?:eval:))(?\\d+):(?\\d+)/);\n if (match) {\n line = Number(match.groups.line);\n column = Number(match.groups.column);\n\n // Chrome's column numbers are off by the amount of leading whitespace in the line.\n let l = view.state.doc.line(line);\n let m = l.text.match(/^\\s*/);\n if (m) {\n column += m[0].length;\n }\n }\n }\n\n if (line != null) {\n let l = view.state.doc.line(line);\n let loc = l.from + column;\n let node = syntaxTree(view.state).resolveInner(loc, -1);\n return [\n {\n from: node.from,\n to: node.to,\n message: lastError.message,\n severity: 'error'\n }\n ];\n }\n }\n return [];\n }, { delay: 0 });\n}\n\nfunction renderFeatures(parent, name) {\n for (let feature in wasm.Features) {\n let label = document.createElement('label');\n let checkbox = document.createElement('input');\n checkbox.type = 'checkbox';\n checkbox.name = name;\n checkbox.value = feature;\n checkbox.oninput = () => {\n let data = new FormData(sidebar);\n let flags = getFeatures(data.getAll(name));\n let f = wasm.Features[feature];\n if (checkbox.checked) {\n flags |= f;\n } else {\n flags &= ~f;\n }\n updateFeatures(sidebar.elements[name], flags);\n };\n label.appendChild(checkbox);\n label.appendChild(document.createTextNode(' ' + feature))\n parent.appendChild(label);\n }\n}\n\nasync function main() {\n await loadWasm();\n renderFeatures(include, 'include');\n renderFeatures(exclude, 'exclude');\n\n let state = loadPlaygroundState();\n reflectPlaygroundState(state);\n\n editor = new EditorView({\n extensions: [lintGutter(), basicSetup, css(), oneDark, linterCompartment.of(createCssLinter())],\n parent: source,\n doc: state.source,\n dispatch(tr) {\n editor.update([tr]);\n if (tr.docChanged) {\n update();\n }\n }\n });\n\n visitorEditor = new EditorView({\n extensions: [lintGutter(), basicSetup, javascript(), oneDark, visitorLinterCompartment.of(createVisitorLinter())],\n parent: visitor,\n doc: state.visitor,\n dispatch(tr) {\n visitorEditor.update([tr]);\n if (tr.docChanged) {\n update();\n }\n }\n });\n\n outputEditor = new EditorView({\n extensions: [basicSetup, css(), oneDark, EditorView.editable.of(false), EditorView.lineWrapping],\n parent: compiled,\n });\n\n modulesEditor = new EditorView({\n extensions: [basicSetup, javascript(), oneDark, EditorView.editable.of(false), EditorView.lineWrapping],\n parent: compiledModules,\n });\n\n depsEditor = new EditorView({\n extensions: [basicSetup, javascript(), oneDark, EditorView.editable.of(false), EditorView.lineWrapping],\n parent: compiledDependencies,\n });\n\n update();\n sidebar.oninput = update;\n\n await loadVersions();\n version.onchange = async () => {\n await loadWasm();\n update();\n };\n}\n\nmain();\n" }, { "path": "website/synthwave.css", "content": "/*\n * Based on Synthwave '84 Theme originally by Robb Owen [@Robb0wen] for Visual Studio Code\n * Originally ported for PrismJS by Marc Backes [@themarcba]\n */\n\npre[class*=\"language-\"] {\n color: lab(64% 103 0);\n text-shadow: 0 0 10px lab(64% 103 0 / .5);\n background: rgb(255 255 255 / .05);\n display: block;\n padding: 20px;\n border-radius: 8px;\n font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;\n font-size: 13px;\n text-align: left;\n white-space: pre-wrap;\n word-spacing: normal;\n word-break: normal;\n word-wrap: break-word;\n line-height: 1.5;\n\n -moz-tab-size: 4;\n -o-tab-size: 4;\n tab-size: 4;\n\n -webkit-hyphens: none;\n -moz-hyphens: none;\n -ms-hyphens: none;\n hyphens: none;\n}\n\n/* Code blocks */\npre[class*=\"language-\"] {\n padding: 1em;\n margin: .5em 0;\n overflow: auto;\n}\n\n/* Inline code */\n:not(pre) > code[class*=\"language-\"] {\n padding: .1em;\n border-radius: .3em;\n white-space: normal;\n}\n\n.token.comment,\n.token.block-comment,\n.token.prolog,\n.token.doctype,\n.token.cdata {\n color: #8e8e8e;\n text-shadow: none;\n}\n\n.token.punctuation {\n color: #ccc;\n}\n\n.token.tag,\n.token.attr-name,\n.token.namespace,\n.token.number,\n.token.unit,\n.token.hexcode,\n.token.deleted,\n.token.function {\n color: lch(65% 85 35);\n text-shadow: 0 0 10px lch(65% 85 35 / .5);\n}\n\n.token.property,\n.token.selector {\n color: lch(85% 58 205);\n text-shadow: 0 0 10px lch(85% 58 205 / .5);\n}\n\n.token.function-name {\n color: #6196cc;\n}\n\n.token.boolean,\n.token.selector .token.id {\n color: #fdfdfd;\n text-shadow: 0 0 2px #001716, 0 0 3px #03edf975, 0 0 5px #03edf975, 0 0 8px #03edf975;\n}\n\n.token.class-name {\n color: #fff5f6;\n text-shadow: 0 0 2px #000, 0 0 10px #fc1f2c75, 0 0 5px #fc1f2c75, 0 0 25px #fc1f2c75;\n}\n\n.token.constant,\n.token.symbol {\n color: lab(64% 103 0);\n text-shadow: 0 0 2px #100c0f, 0 0 5px #dc078e33, 0 0 10px #fff3;\n}\n\n.token.important,\n.token.atrule,\n.token.keyword,\n.token.selector .token.class,\n.token.builtin {\n color: #f4eee4;\n text-shadow: 0 0 2px #393a33, 0 0 8px #f39f0575, 0 0 2px #f39f0575;\n}\n\n.token.string,\n.token.string-property,\n.token.char,\n.token.attr-value,\n.token.regex,\n.token.variable,\n.token.url {\n color: lch(85% 82.34 80.104);\n text-shadow: 0 0 10px lch(85% 82.34 80.104 / .5);\n}\n\n.token.operator,\n.token.entity {\n color: #67cdcc;\n}\n\n.token.important,\n.token.bold {\n font-weight: bold;\n}\n\n.token.italic {\n font-style: italic;\n}\n\n.token.entity {\n cursor: help;\n}\n\n.token.inserted {\n color: green;\n}\n" }, { "path": "website/transforms.html", "content": "\n" }, { "path": "website/transpilation.html", "content": "\n" } ]