lightningcss 1.33.0 → 1.33.0.2

data/sig/lightningcss/node.rbs

@@ -0,0 +1,104 @@
+# Generated from lib/lightningcss/node.rb with RBS::Inline
+
+module LightningCSS
+  # One object in the AST Lightning CSS parsed a stylesheet to.
+  #
+  #     root = LightningCSS.parse(".a { color: red }").root
+  #
+  #     root.type                        #=> "stylesheet"
+  #     root.every("declaration")        #=> every declaration in the stylesheet
+  #     root.rules.first.value.location  #=> {"source_index" => 0, "line" => 0, "column" => 1}
+  #
+  # Every object in the tree is a node, so reads chain all the way down. Most say what they are
+  # with their own `type`. The stylesheet, a declaration block, and a declaration do not, so a node
+  # names those from where it sits.
+  class Node
+    include Enumerable[LightningCSS::Node]
+
+    POSITION: Array[String]
+
+    DECLARATIONS: Array[String]
+
+    attr_reader parent: LightningCSS::Node?
+
+    attr_reader field: String?
+
+    # : (Hash[String, untyped], ?LightningCSS::Node?, ?String?) -> void
+    def initialize: (Hash[String, untyped], ?LightningCSS::Node?, ?String?) -> void
+
+    # : () -> String?
+    def type: () -> String?
+
+    # : () -> String?
+    def underscored_type: () -> String?
+
+    # : () -> bool
+    def rule?: () -> bool
+
+    # : () -> Hash[String, Integer]?
+    def location: () -> Hash[String, Integer]?
+
+    # : (String) -> untyped
+    def []: (String) -> untyped
+
+    # : () -> Array[String]
+    def keys: () -> Array[String]
+
+    # : () -> Hash[String, untyped]
+    def to_h: () -> Hash[String, untyped]
+
+    # : (?untyped) -> String
+    def to_json: (?untyped) -> String
+
+    # : (Array[Symbol]?) -> Hash[Symbol, untyped]
+    def deconstruct_keys: (Array[Symbol]?) -> Hash[Symbol, untyped]
+
+    # : () -> Array[LightningCSS::Node]
+    def child_nodes: () -> Array[LightningCSS::Node]
+
+    # : () { (LightningCSS::Node) -> void } -> void
+    # : () -> Enumerator[LightningCSS::Node, void]
+    def each: () { (LightningCSS::Node) -> void } -> void
+            | () -> Enumerator[LightningCSS::Node, void]
+
+    # : () -> Array[LightningCSS::Node]
+    def ancestors: () -> Array[LightningCSS::Node]
+
+    # : (String) -> Array[LightningCSS::Node]
+    def every: (String) -> Array[LightningCSS::Node]
+
+    # : () -> Hash[String, untyped]
+    def fields: () -> Hash[String, untyped]
+
+    # : () -> String
+    def inspect: () -> String
+
+    # : (Symbol, *untyped) -> untyped
+    def method_missing: (Symbol, *untyped) -> untyped
+
+    # : (Symbol, ?bool) -> bool
+    def respond_to_missing?: (Symbol, ?bool) -> bool
+
+    attr_reader attributes: Hash[String, untyped]
+
+    private
+
+    # : () -> String?
+    def inferred_type: () -> String?
+
+    # : (untyped, String) -> Array[LightningCSS::Node]
+    def nodes_in: (untyped, String) -> Array[LightningCSS::Node]
+
+    # : (String, untyped) -> String
+    def described_field: (String, untyped) -> String
+
+    # : (Array[untyped]) -> String
+    def counted: (Array[untyped]) -> String
+
+    # : (String) -> String?
+    def field_for: (String) -> String?
+
+    # : (untyped, String) -> untyped
+    def wrap: (untyped, String) -> untyped
+  end
+end

data/sig/lightningcss/options.rbs

@@ -13,6 +13,8 @@ module LightningCSS
 
     STYLE_ATTRIBUTE: Array[Symbol]
 
+    PARSE: Array[Symbol]
+
     BUNDLE: Array[Symbol]
 
     attr_reader to_h: Hash[Symbol, untyped]

data/sig/lightningcss/parse_result.rbs

@@ -0,0 +1,30 @@
+# Generated from lib/lightningcss/parse_result.rb with RBS::Inline
+
+module LightningCSS
+  # What a stylesheet parsed to.
+  #
+  # `stylesheet` is the AST exactly as Lightning CSS serializes it, and `root` is the same tree as a
+  # `LightningCSS::Node` to walk. `warnings` are the ones a transform would have reported.
+  class ParseResult
+    attr_reader source: String?
+
+    attr_reader stylesheet: Hash[String, untyped]
+
+    attr_reader warnings: Array[LightningCSS::Warning]
+
+    # : (String, ?String?) -> LightningCSS::ParseResult
+    def self.from_json: (String, ?String?) -> LightningCSS::ParseResult
+
+    # : (stylesheet: Hash[String, untyped], warnings: Array[LightningCSS::Warning], ?source: String?) -> void
+    def initialize: (stylesheet: Hash[String, untyped], warnings: Array[LightningCSS::Warning], ?source: String?) -> void
+
+    # : () -> LightningCSS::Node
+    def root: () -> LightningCSS::Node
+
+    # : () -> bool
+    def warnings?: () -> bool
+
+    # : () -> String
+    def inspect: () -> String
+  end
+end

data/sig/lightningcss/result.rbs

@@ -14,13 +14,13 @@ module LightningCSS
 
     attr_reader exports: Hash[String, String]?
 
-    attr_reader warnings: Array[String]
+    attr_reader warnings: Array[LightningCSS::Warning]
 
     # : (String) -> LightningCSS::Result
     def self.from_json: (String) -> LightningCSS::Result
 
-    # : (code: String, warnings: Array[String], ?exports: Hash[String, String]?) -> void
-    def initialize: (code: String, warnings: Array[String], ?exports: Hash[String, String]?) -> void
+    # : (code: String, warnings: Array[LightningCSS::Warning], ?exports: Hash[String, String]?) -> void
+    def initialize: (code: String, warnings: Array[LightningCSS::Warning], ?exports: Hash[String, String]?) -> void
 
     # : () -> bool
     def warnings?: () -> bool

data/sig/lightningcss/transformer.rbs

@@ -21,6 +21,9 @@ module LightningCSS
 
     alias call transform
 
+    # : (String, ?filename: String?, ?error_recovery: bool) -> LightningCSS::ParseResult
+    def parse: (String, ?filename: String?, ?error_recovery: bool) -> LightningCSS::ParseResult
+
     # : (String, ?minify: bool, ?error_recovery: bool, ?targets: browsers?, ?css_modules: css_modules?, ?scope: String?) -> LightningCSS::Result
     def bundle: (String, ?minify: bool, ?error_recovery: bool, ?targets: browsers?, ?css_modules: css_modules?, ?scope: String?) -> LightningCSS::Result
 

data/sig/lightningcss/types.rbs

@@ -1,17 +1,19 @@
 # Note: This file is hand written, `rbs-inline` does not generate this file.
 
 module LightningCSS
+  type version = Integer | Float | String
+
   type browsers = {
-    ?android: Integer,
-    ?chrome: Integer,
-    ?edge: Integer,
-    ?firefox: Integer,
-    ?ie: Integer,
-    ?ios: Integer,
-    ?ios_saf: Integer,
-    ?opera: Integer,
-    ?safari: Integer,
-    ?samsung: Integer
+    ?android: version,
+    ?chrome: version,
+    ?edge: version,
+    ?firefox: version,
+    ?ie: version,
+    ?ios: version,
+    ?ios_saf: version,
+    ?opera: version,
+    ?safari: version,
+    ?samsung: version
   }
 
   type css_modules = bool | {

data/sig/lightningcss/visitor.rbs

@@ -0,0 +1,24 @@
+# Generated from lib/lightningcss/visitor.rb with RBS::Inline
+
+module LightningCSS
+  # Walks an AST, answering each node with the method named after it and walking through anything
+  # nothing answers.
+  #
+  #     class Colors < LightningCSS::Visitor
+  #       def visit_declaration(node)
+  #         puts node.value.type if node.property == "color"
+  #       end
+  #     end
+  #
+  #     Colors.new.visit(LightningCSS.parse(".a { color: red }"))
+  #
+  # A rule is answered as one, as in `visit_style_rule` or `visit_media_rule`, since `style`,
+  # `nesting`, and `namespace` are also what a selector is made of.
+  class Visitor
+    # : (LightningCSS::Node | LightningCSS::ParseResult) -> void
+    def visit: (LightningCSS::Node | LightningCSS::ParseResult) -> void
+
+    # : (LightningCSS::Node) -> void
+    def visit_children: (LightningCSS::Node) -> void
+  end
+end

data/sig/lightningcss/warning.rbs

@@ -0,0 +1,36 @@
+# Generated from lib/lightningcss/warning.rb with RBS::Inline
+
+module LightningCSS
+  class Warning
+    attr_reader message: String
+
+    attr_reader type: String?
+
+    attr_reader location: LightningCSS::Location?
+
+    # : (Hash[String, untyped]) -> LightningCSS::Warning
+    def self.from_hash: (Hash[String, untyped]) -> LightningCSS::Warning
+
+    # : (message: String, ?type: String?, ?location: LightningCSS::Location?) -> void
+    def initialize: (message: String, ?type: String?, ?location: LightningCSS::Location?) -> void
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+
+    # : () -> String
+    def to_s: () -> String
+
+    alias to_str to_s
+
+    # : (untyped) -> bool
+    def ==: (untyped) -> bool
+
+    alias eql? ==
+
+    # : () -> Integer
+    def hash: () -> Integer
+
+    # : () -> String
+    def inspect: () -> String
+  end
+end

data/sig/lightningcss.rbs

@@ -11,12 +11,20 @@
 #     LightningCSS.transform(".title { color: red }", scope: "[data-scope-abc]").code
 #     #=> ".title[data-scope-abc]{color:red}"
 #
+# `parse` returns the AST instead, to walk with `LightningCSS::Node` and `LightningCSS::Visitor`:
+#
+#     LightningCSS.parse(".a { color: red }").root.every("declaration").first.property
+#     #=> "color"
+#
 # `LightningCSS::Options` is what the options are read by, and `LightningCSS::Transformer` holds a
 # set of them to reuse across many stylesheets.
 module LightningCSS
   # : (String, ?filename: String?, ?minify: bool, ?error_recovery: bool, ?targets: browsers?, ?css_modules: css_modules?, ?scope: String?) -> LightningCSS::Result
   def self.transform: (String, ?filename: String?, ?minify: bool, ?error_recovery: bool, ?targets: browsers?, ?css_modules: css_modules?, ?scope: String?) -> LightningCSS::Result
 
+  # : (String, ?filename: String?, ?error_recovery: bool) -> LightningCSS::ParseResult
+  def self.parse: (String, ?filename: String?, ?error_recovery: bool) -> LightningCSS::ParseResult
+
   # : (String, ?minify: bool, ?error_recovery: bool, ?targets: browsers?, ?css_modules: css_modules?, ?scope: String?) -> LightningCSS::Result
   def self.bundle: (String, ?minify: bool, ?error_recovery: bool, ?targets: browsers?, ?css_modules: css_modules?, ?scope: String?) -> LightningCSS::Result
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lightningcss
 version: !ruby/object:Gem::Version
-  version: 1.33.0
+  version: 1.33.0.2
 platform: ruby
 authors:
 - Marco Roth
@@ -26,10 +26,15 @@ files:
 - lib/lightningcss.rb
 - lib/lightningcss/backend.rb
 - lib/lightningcss/errors.rb
+- lib/lightningcss/location.rb
+- lib/lightningcss/node.rb
 - lib/lightningcss/options.rb
+- lib/lightningcss/parse_result.rb
 - lib/lightningcss/result.rb
 - lib/lightningcss/transformer.rb
 - lib/lightningcss/version.rb
+- lib/lightningcss/visitor.rb
+- lib/lightningcss/warning.rb
 - licenses/README.md
 - licenses/lightningcss-MPL-2.0.txt
 - lightningcss.gemspec
@@ -44,11 +49,16 @@ files:
 - sig/lightningcss.rbs
 - sig/lightningcss/backend.rbs
 - sig/lightningcss/errors.rbs
+- sig/lightningcss/location.rbs
+- sig/lightningcss/node.rbs
 - sig/lightningcss/options.rbs
+- sig/lightningcss/parse_result.rbs
 - sig/lightningcss/result.rbs
 - sig/lightningcss/transformer.rbs
 - sig/lightningcss/types.rbs
 - sig/lightningcss/version.rbs
+- sig/lightningcss/visitor.rbs
+- sig/lightningcss/warning.rbs
 homepage: https://github.com/marcoroth/lightningcss-ruby
 licenses:
 - MIT