lightningcss_rb 0.0.1

data/lib/lightningcss_rb/unknown_error.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  class UnknownError < Error
+    attr_reader :context
+
+    def initialize(message, context = nil)
+      super(message)
+
+      @context = context
+    end
+
+    def pretty_print
+      <<~PP
+        #{self.class.name}: #{message}
+        #{JSON.pretty_generate(context)}
+      PP
+    end
+  end
+end

data/lib/lightningcss_rb/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module LightningcssRb
+  VERSION = "0.0.1"
+end

data/lib/lightningcss_rb.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "lightningcss_rb/version"
+require_relative "lightningcss_rb/error"
+require_relative "lightningcss_rb/unknown_error"
+require_relative "lightningcss_rb/ast"
+
+# Load the native extension. Precompiled gems ship a build per Ruby ABI under
+# lib/lightningcss_rb/<major.minor>/; source installs compile to lib/lightningcss_rb/.
+begin
+  RUBY_VERSION =~ /(\d+\.\d+)/
+  require_relative "lightningcss_rb/#{Regexp.last_match(1)}/lightningcss_rb"
+rescue LoadError
+  require_relative "lightningcss_rb/lightningcss_rb"
+end
+
+# Ruby bindings for the LightningCSS parser, transformer, and minifier.
+#
+# The native extension exposes the underlying LightningCSS AST as JSON; the
+# methods here wrap those primitives with a friendlier Ruby interface.
+module LightningcssRb
+  # Error is defined above so it is available before ast.rb loads.
+
+  module_function
+
+  # Parse CSS into the LightningCSS AST as a Ruby Hash (with symbol keys).
+  #
+  # @param css [String] the CSS source to parse
+  # @return [Hash] the parsed stylesheet AST
+  # @raise [LightningcssRb::Error] if the CSS cannot be parsed
+  def parse(css)
+    JSON.parse(_parse(css), symbolize_names: true)
+  end
+
+  # Serialize an AST (as returned by {parse}) back to CSS.
+  #
+  # @param ast [Hash, String] an AST Hash from {parse}, or a raw AST JSON String
+  # @param minify [Boolean] remove whitespace and shorten the output
+  # @return [String] the serialized CSS
+  # @raise [LightningcssRb::Error] if the AST cannot be serialized
+  def to_css(ast, minify: false)
+    json = ast.is_a?(String) ? ast : JSON.generate(ast)
+    _to_css(json, minify)
+  end
+
+  # Parse, optimize, and re-print CSS in one step.
+  #
+  # @param css [String] the CSS source
+  # @param minify [Boolean] remove whitespace and shorten the output
+  # @return [String] the transformed CSS
+  # @raise [LightningcssRb::Error] if the CSS cannot be processed
+  def transform(css, minify: true)
+    _transform(css, minify)
+  end
+
+  # Parse, optimize, and minify CSS. Shorthand for `transform(css, minify: true)`.
+  #
+  # @param css [String] the CSS source
+  # @return [String] the minified CSS
+  # @raise [LightningcssRb::Error] if the CSS cannot be processed
+  def minify(css)
+    _transform(css, true)
+  end
+end

data/sig/lightningcss_rb.rbs

@@ -0,0 +1,16 @@
+module LightningcssRb
+  VERSION: String
+
+  class Error < StandardError
+  end
+
+  def self.parse: (String css) -> Hash[Symbol, untyped]
+  def self.to_css: (Hash[Symbol, untyped] | String ast, ?minify: bool) -> String
+  def self.transform: (String css, ?minify: bool) -> String
+  def self.minify: (String css) -> String
+
+  # Native primitives defined by the extension.
+  def self._parse: (String css) -> String
+  def self._to_css: (String ast_json, bool minify) -> String
+  def self._transform: (String css, bool minify) -> String
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: lightningcss_rb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Marc Heiligers
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rb_sys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.91
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.91
+description: lightningcss_rb wraps the LightningCSS Rust library via a native extension,
+  exposing CSS parsing (to an AST), transformation, and minification to Ruby.
+email:
+- marc@fascination.works
+executables: []
+extensions:
+- ext/lightningcss_rb/extconf.rb
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Cargo.lock
+- Cargo.toml
+- LICENSE.txt
+- NOTICE.md
+- README.md
+- Rakefile
+- ext/lightningcss_rb/Cargo.toml
+- ext/lightningcss_rb/extconf.rb
+- ext/lightningcss_rb/src/lib.rs
+- lib/lightningcss_rb.rb
+- lib/lightningcss_rb/ast.rb
+- lib/lightningcss_rb/ast/selectors.rb
+- lib/lightningcss_rb/ast/selectors/attribute.rb
+- lib/lightningcss_rb/ast/selectors/base.rb
+- lib/lightningcss_rb/ast/selectors/class_selector.rb
+- lib/lightningcss_rb/ast/selectors/combinator.rb
+- lib/lightningcss_rb/ast/selectors/id.rb
+- lib/lightningcss_rb/ast/selectors/namespace.rb
+- lib/lightningcss_rb/ast/selectors/nesting.rb
+- lib/lightningcss_rb/ast/selectors/pseudo_class.rb
+- lib/lightningcss_rb/ast/selectors/pseudo_element.rb
+- lib/lightningcss_rb/ast/selectors/type_selector.rb
+- lib/lightningcss_rb/ast/selectors/universal.rb
+- lib/lightningcss_rb/error.rb
+- lib/lightningcss_rb/unknown_error.rb
+- lib/lightningcss_rb/version.rb
+- lib/tasks/.keep
+- sig/lightningcss_rb.rbs
+homepage: https://github.com/marcheiligers/lightningcss_rb
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/marcheiligers/lightningcss_rb
+  source_code_uri: https://github.com/marcheiligers/lightningcss_rb
+  changelog_uri: https://github.com/marcheiligers/lightningcss_rb/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.11
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Ruby bindings for LightningCSS, a fast CSS parser, transformer, and minifier.
+test_files: []