lightningcss_rb 0.0.1

data/Cargo.toml

@@ -0,0 +1,7 @@
+# This Cargo.toml is here to let externals tools (IDEs, etc.) know that this is
+# a Rust project. Your extensions dependencies should be added to the Cargo.toml
+# in the ext/ directory.
+
+[workspace]
+members = ["./ext/lightningcss_rb"]
+resolver = "2"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Marc Heiligers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/NOTICE.md

@@ -0,0 +1,17 @@
+# Third-party notices
+
+The Ruby and Rust binding code in this gem (`lightningcss_rb`) is licensed under
+the MIT License, see `LICENSE.txt`.
+
+This gem links the **LightningCSS** Rust library, which is licensed under the
+**Mozilla Public License 2.0 (MPL-2.0)**:
+
+- Project: https://github.com/parcel-bundler/lightningcss
+- License: https://www.mozilla.org/en-US/MPL/2.0/
+- Version: 1.0.0-alpha.71
+
+The MPL-2.0 covers the LightningCSS source files. Under the MPL-2.0, the source
+for any modified MPL-covered files must be made available; this gem uses an
+unmodified upstream release obtained from crates.io, whose source is available
+at the project URL above. The MIT license applies only to the binding code in
+this repository, not to the bundled LightningCSS sources.

data/README.md

@@ -0,0 +1,57 @@
+# LightningcssRb
+
+TODO: Delete this and the text below, and describe your gem
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/lightningcss_rb`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+## Installation
+
+TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Because this gem has a Rust extension, compile it with `bundle exec rake compile` before running the tests (or run `bundle exec rake`, which compiles, tests, and lints). You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+### Tests
+
+`bin/test` runs the test suite, and can scope down to a single file or a single test:
+
+```bash
+bin/test                                   # all tests
+bin/test test/test_lightningcss_rb.rb      # a single file
+bin/test test/test_lightningcss_rb.rb:26   # the test defined at or above line 26
+```
+
+Flags are passed through to minitest (e.g. `bin/test -v`). The shims run against the currently compiled extension, so re-run `bundle exec rake compile` after changing Rust code.
+
+### Linting
+
+`bin/rubocop` runs RuboCop, forwarding any arguments (e.g. `bin/rubocop -a` to autocorrect).
+
+### Install & Release
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/marcheiligers/lightningcss_rb.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+Dir.glob("lib/tasks/**/*.rake").each { |f| load f }
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+require "rb_sys/extensiontask"
+
+desc "Compile the extension"
+task build: :compile
+
+GEMSPEC = Gem::Specification.load("lightningcss_rb.gemspec")
+
+RbSys::ExtensionTask.new("lightningcss_rb", GEMSPEC) do |ext|
+  ext.lib_dir = "lib/lightningcss_rb"
+end
+
+task default: %i[compile test rubocop]

data/ext/lightningcss_rb/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "lightningcss_rb"
+version = "0.1.0"
+edition = "2021"
+authors = ["Marc Heiligers <marc@fascination.works>"]
+license = "MIT"
+publish = false
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+magnus = { version = "0.8.2" }
+lightningcss = { version = "=1.0.0-alpha.71", features = ["serde"] }
+serde_json = "1"

data/ext/lightningcss_rb/extconf.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "mkmf"
+require "rb_sys/mkmf"
+
+create_rust_makefile("lightningcss_rb/lightningcss_rb")

data/ext/lightningcss_rb/src/lib.rs

@@ -0,0 +1,57 @@
+use lightningcss::stylesheet::{MinifyOptions, ParserOptions, PrinterOptions, StyleSheet};
+use magnus::{function, prelude::*, ExceptionClass, Error, RModule, Ruby};
+
+/// Build a `LightningcssRb::Error` from any displayable error. Falls back to
+/// StandardError if the custom class can't be resolved, so this never panics
+/// across the FFI boundary.
+fn error(message: impl std::fmt::Display) -> Error {
+    let ruby = Ruby::get().unwrap();
+    let class: ExceptionClass = ruby
+        .class_object()
+        .const_get::<_, RModule>("LightningcssRb")
+        .and_then(|m| m.const_get("Error"))
+        .unwrap_or_else(|_| ruby.exception_standard_error());
+    Error::new(class, message.to_string())
+}
+
+/// Parse CSS into LightningCSS's AST, serialized as a JSON string.
+fn parse(css: String) -> Result<String, Error> {
+    let stylesheet = StyleSheet::parse(&css, ParserOptions::default()).map_err(error)?;
+    serde_json::to_string(&stylesheet).map_err(error)
+}
+
+/// Serialize a JSON AST (as produced by `parse`) back to CSS.
+fn to_css(ast_json: String, minify: bool) -> Result<String, Error> {
+    let stylesheet: StyleSheet = serde_json::from_str(&ast_json).map_err(error)?;
+    let res = stylesheet
+        .to_css(PrinterOptions {
+            minify,
+            ..Default::default()
+        })
+        .map_err(error)?;
+    Ok(res.code)
+}
+
+/// Parse, run the optimization pass, and print CSS. With `minify: true`
+/// whitespace is also removed.
+fn transform(css: String, minify: bool) -> Result<String, Error> {
+    let mut stylesheet = StyleSheet::parse(&css, ParserOptions::default()).map_err(error)?;
+    stylesheet.minify(MinifyOptions::default()).map_err(error)?;
+    let res = stylesheet
+        .to_css(PrinterOptions {
+            minify,
+            ..Default::default()
+        })
+        .map_err(error)?;
+    Ok(res.code)
+}
+
+#[magnus::init]
+fn init(ruby: &Ruby) -> Result<(), Error> {
+    let module = ruby.define_module("LightningcssRb")?;
+    module.define_error("Error", ruby.exception_standard_error())?;
+    module.define_singleton_method("_parse", function!(parse, 1))?;
+    module.define_singleton_method("_to_css", function!(to_css, 2))?;
+    module.define_singleton_method("_transform", function!(transform, 2))?;
+    Ok(())
+}

data/lib/lightningcss_rb/ast/selectors/attribute.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class Attribute < Base
+        node_attr_reader :name, :namespace, :operation
+
+        OPERATORS = {
+          "equal" => "=",
+          "includes" => "~=",
+          "dash-match" => "|=",
+          "prefix" => "^=",
+          "substring" => "*=",
+          "suffix" => "$="
+        }.freeze
+
+        def to_css # rubocop:disable Metrics/MethodLength
+          ns = namespace_prefix
+          s = "[#{ns}#{name}"
+          if operation
+            op  = OPERATORS[operation[:operator]]
+            val = operation[:value]
+            s += "#{op}\"#{val}\""
+            case operation[:caseSensitivity]
+            when "ascii-case-insensitive" then s += " i"
+            when "explicit-case-sensitive" then s += " s"
+            end
+          end
+          "#{s}]"
+        end
+
+        private
+
+        def namespace_prefix
+          return "" if namespace.nil?
+
+          case namespace[:type]
+          when "any"      then "*|"
+          when "specific" then "#{namespace[:prefix]}|"
+          else                 ""
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/base.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class Base
+        attr_reader :node
+
+        def self.node_attr_reader(*names)
+          names.each do |name|
+            define_method name do
+              node[name]
+            end
+          end
+        end
+
+        def self.from_ast(node)
+          new(node: node)
+        end
+
+        def initialize(node:)
+          @node = node
+        end
+
+        def to_css
+          raise NotImplementedError, "#{self.class.name} must implement #{to_css}"
+        end
+
+        def to_s = to_css
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/class_selector.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class ClassSelector < Base
+        node_attr_reader :name
+
+        def to_css = ".#{name}"
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/combinator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class Combinator < Base
+        node_attr_reader :value
+
+        STRINGS = {
+          "descendant" => " ",
+          "child" => " > ",
+          "next-sibling" => " + ",
+          "later-sibling" => " ~ ",
+          "pseudo-element" => "",
+          "slot-assignment" => "",
+          "part" => "",
+          "deep-descendant" => " >>> ",
+          "deep" => " /deep/ "
+        }.freeze
+
+        def to_css = STRINGS.fetch(value, " ")
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/id.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class Id < Base
+        node_attr_reader :name
+
+        def to_css = "##{name}"
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/namespace.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      UnknownNamespaceKind = Class.new(UnknownError)
+
+      class Namespace < Base
+        node_attr_reader :kind, :prefix
+
+        def to_css
+          case kind
+          when "none"  then "|"
+          when "any"   then "*|"
+          when "named" then "#{prefix}|"
+          else raise UnknownNamespaceKind(kind, node)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/nesting.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class Nesting < Base
+        def to_css = "&"
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/pseudo_class.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class PseudoClass < Base
+        node_attr_reader :kind
+
+        def to_css # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/AbcSize
+          case kind
+          when "not"    then ":not(#{render_selector_list(node[:selectors])})"
+          when "is"     then ":is(#{render_selector_list(node[:selectors])})"
+          when "where"  then ":where(#{render_selector_list(node[:selectors])})"
+          when "has"    then ":has(#{render_selector_list(node[:selectors])})"
+          when "any"    then ":#{vendor_prefix_str(node[:vendorPrefix])}any(#{render_selector_list(node[:selectors])})"
+          when "host"   then node[:selectors] ? ":host(#{render_selector(node[:selectors])})" : ":host"
+          when "local"  then ":local(#{render_selector(node[:selector])})"
+          when "global" then ":global(#{render_selector(node[:selector])})"
+          when "lang"   then ":lang(#{node[:languages].join(", ")})"
+          when "dir"    then ":dir(#{node[:direction]})"
+          when "webkit-scrollbar" then ":#{node[:value]}"
+          when "nth-child"        then ":nth-child(#{nth_str}#{of_str})"
+          when "nth-last-child"   then ":nth-last-child(#{nth_str}#{of_str})"
+          when "nth-of-type"      then ":nth-of-type(#{nth_str})"
+          when "nth-last-of-type" then ":nth-last-of-type(#{nth_str})"
+          when "nth-col"          then ":nth-col(#{nth_str})"
+          when "nth-last-col"     then ":nth-last-col(#{nth_str})"
+          when "active-view-transition-type" then ":active-view-transition-type(#{node[:type].join(", ")})"
+          when "state"  then ":state(#{node[:state]})"
+          when "custom" then ":#{node[:name]}"
+          when "custom-function" then ":#{node[:name]}()"
+          else ":#{kind}"
+          end
+        end
+
+        private
+
+        def render_selector_list(selectors)
+          selectors.map { |sel| render_selector(sel) }.join(", ")
+        end
+
+        def render_selector(components)
+          components.map { |h| Selectors.from_ast(h).to_css }.join
+        end
+
+        def nth_str
+          a = node[:a]
+          b = node[:b]
+          return b.to_s if a == 0
+          return "n" if a == 1 && b == 0
+          return "n+#{b}" if a == 1
+
+          s = "#{a}n"
+          s += "+#{b}" if b.positive?
+          s += b.to_s  if b.negative?
+          s
+        end
+
+        def of_str
+          return "" unless node[:of]
+
+          " of #{render_selector_list(node[:of])}"
+        end
+
+        def vendor_prefix_str(prefixes)
+          return "" if prefixes.nil? || prefixes.empty?
+
+          "-#{prefixes.first}-"
+        end
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/pseudo_element.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class PseudoElement < Base
+        node_attr_reader :kind
+
+        SIMPLE = %w[
+          after before first-line first-letter details-content target-text
+          search-text marker cue cue-region view-transition picker-icon
+          checkmark grammar-error spelling-error
+        ].freeze
+
+        VENDOR_PREFIXED = %w[selection placeholder backdrop file-selector-button].freeze
+
+        def to_css # rubocop:disable Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/AbcSize
+          if SIMPLE.include?(kind)
+            "::#{kind}"
+          elsif VENDOR_PREFIXED.include?(kind)
+            "::#{vendor_prefix_str(node[:vendorPrefix])}#{kind}"
+          else
+            case kind
+            when "highlight-function"  then "::highlight(#{node[:name]})"
+            when "cue-function"        then "::cue(#{render_selector(node[:selector])})"
+            when "cue-region-function" then "::cue-region(#{render_selector(node[:selector])})"
+            when "picker-function"     then "::picker(#{node[:identifier]})"
+            when "slotted"             then "::slotted(#{render_selector(node[:selector])})"
+            when "part"                then "::part(#{node[:names].join(" ")})"
+            when "custom"              then "::#{node[:name]}"
+            when "custom-function"     then "::#{node[:name]}()"
+            when "view-transition-group", "view-transition-image-pair",
+                 "view-transition-old", "view-transition-new"
+              "::#{kind}(#{view_transition_part(node[:part])})"
+            when "webkit-scrollbar"
+              "::-webkit-scrollbar#{webkit_scrollbar_suffix(node[:value])}"
+            else
+              "::#{kind}"
+            end
+          end
+        end
+
+        def to_s = to_css
+
+        private
+
+        def render_selector(components)
+          components.map { |h| Selectors.from_ast(h).to_css }.join
+        end
+
+        def vendor_prefix_str(prefixes)
+          return "" if prefixes.nil? || prefixes.empty?
+
+          "-#{prefixes.first}-"
+        end
+
+        def view_transition_part(part)
+          part[:name] || "*"
+        end
+
+        def webkit_scrollbar_suffix(value)
+          value == "scrollbar" ? "" : "-#{value}"
+        end
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/type_selector.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class TypeSelector < Base
+        node_attr_reader :name
+
+        def to_css = name
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors/universal.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class AST
+    module Selectors
+      class Universal < Base
+        def to_css = "*"
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast/selectors.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "selectors/base"
+require_relative "selectors/combinator"
+require_relative "selectors/universal"
+require_relative "selectors/namespace"
+require_relative "selectors/type_selector"
+require_relative "selectors/id"
+require_relative "selectors/class_selector"
+require_relative "selectors/attribute"
+require_relative "selectors/pseudo_class"
+require_relative "selectors/pseudo_element"
+require_relative "selectors/nesting"
+
+module LightningcssRb
+  class AST
+    module Selectors
+      TYPE_MAP = {
+        "combinator" => Combinator,
+        "universal" => Universal,
+        "namespace" => Namespace,
+        "type" => TypeSelector,
+        "id" => Id,
+        "class" => ClassSelector,
+        "attribute" => Attribute,
+        "pseudo-class" => PseudoClass,
+        "pseudo-element" => PseudoElement,
+        "nesting" => Nesting
+      }.freeze
+
+      def self.from_ast(node)
+        klass = TYPE_MAP[node[:type]]
+        raise UnknownSelectorType.new("Unknown selector type: #{node[:type].inspect}", node) unless klass
+
+        klass.from_ast(node)
+      end
+    end
+  end
+end

data/lib/lightningcss_rb/ast.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require_relative "ast/selectors"
+
+module LightningcssRb
+  class AST
+    UnknownSelectorType = Class.new(UnknownError)
+
+    attr_reader :ast
+
+    def initialize(ast)
+      @ast = ast.is_a?(String) ? LightningcssRb.parse(ast) : ast
+    end
+
+    def rules
+      ast[:rules]
+    end
+
+    def selectors
+      collect_selectors(rules)
+    end
+
+    private
+
+    # Recursively collect fully-resolved selector strings, descending into nested
+    # rules and expanding each `&` (nesting) token against the parent selector(s).
+    def collect_selectors(rules, parents = nil)
+      rules.flat_map do |rule|
+        case rule[:type]
+        when "style"
+          resolved = resolve_nesting(rule.dig(:value, :selectors), parents)
+          resolved.map { |selector| selector_to_s(selector) } +
+            collect_selectors(rule.dig(:value, :rules), resolved)
+        when "media"
+          collect_selectors(rule.dig(:value, :rules), parents)
+        end
+      end.compact
+    end
+
+    # Replace the `nesting` token in each selector with each parent selector,
+    # producing the cartesian product when a parent has multiple selectors.
+    def resolve_nesting(selectors, parents)
+      return selectors if parents.nil?
+
+      selectors.flat_map do |selector|
+        parents.map do |parent|
+          selector.flat_map { |part| part[:type] == "nesting" ? parent : [part] }
+        end
+      end
+    end
+
+    def selector_to_s(selector)
+      selector.map { |part| Selectors.from_ast(part).to_css }.join
+    end
+  end
+end

data/lib/lightningcss_rb/error.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  Error = Class.new(StandardError)
+end