jazzy 0.13.7 → 0.14.2

data/lib/jazzy/symbol_graph/graph.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # rubocop:disable Metrics/ClassLength
 module Jazzy
   module SymbolGraph
@@ -63,21 +65,26 @@ module Jazzy
       # Increasingly desparate ways to find the name of the symbol
       # at the target end of a relationship
       def rel_target_name(rel, target_node)
-        (target_node && target_node.symbol.name) ||
+        target_node&.symbol&.name ||
           rel.target_fallback ||
           Jazzy::SymbolGraph.demangle(rel.target_usr)
       end
 
       # Same for the source end.  Less help from the tool here
       def rel_source_name(rel, source_node)
-        (source_node && source_node.qualified_name) ||
+        source_node&.qualified_name ||
           Jazzy::SymbolGraph.demangle(rel.source_usr)
       end
 
       # Protocol conformance is redundant if it's unconditional
       # and already expressed in the type's declaration.
+      #
+      # Skip implementation-detail conformances.
       def redundant_conformance?(rel, type, protocol)
-        type && rel.constraints.empty? && type.conformance?(protocol)
+        return false unless type
+
+        (rel.constraints.empty? && type.conformance?(protocol)) ||
+          (type.actor? && rel.actor_protocol?)
       end
 
       # source is a member/protocol requirement of target
@@ -86,11 +93,11 @@ module Jazzy
 
         source.protocol_requirement = rel.protocol_requirement?
         constraints =
-          ExtConstraints.new(target && target.constraints,
+          ExtConstraints.new(target&.constraints,
                              source.unique_context_constraints(target))
 
         # Add to its parent or invent an extension
-        unless target && target.try_add_child(source, constraints.ext)
+        unless target&.try_add_child(source, constraints.ext)
           add_ext_member(rel.target_usr, source, constraints)
         end
       end
@@ -101,7 +108,7 @@ module Jazzy
 
         return if redundant_conformance?(rel, source, protocol_name)
 
-        type_constraints = (source && source.constraints) || []
+        type_constraints = source&.constraints || []
         constraints =
           ExtConstraints.new(type_constraints,
                              rel.constraints - type_constraints)
@@ -122,7 +129,7 @@ module Jazzy
                target_parent.is_a?(SymNode)
           # Could probably figure this out with demangle, but...
           warn "Can't resolve membership of default implementation "\
-               "#{source.symbol.usr}."
+            "#{source.symbol.usr}."
           source.unlisted = true
           return
         end
@@ -174,14 +181,14 @@ module Jazzy
 
         root_symbol_nodes =
           symbol_nodes.values
-                      .select(&:top_level_decl?)
-                      .sort
-                      .map(&:to_sourcekit)
+            .select(&:top_level_decl?)
+            .sort
+            .map(&:to_sourcekit)
 
         root_ext_nodes =
           ext_nodes.values
-                   .sort
-                   .map { |n| n.to_sourcekit(module_name) }
+            .sort
+            .map { |n| n.to_sourcekit(module_name) }
         {
           'key.diagnostic_stage' => 'parse',
           'key.substructure' => root_symbol_nodes + root_ext_nodes,

data/lib/jazzy/symbol_graph/relationship.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Jazzy
   module SymbolGraph
     # A Relationship is a tidied-up SymbolGraph JSON object
@@ -20,11 +22,18 @@ module Jazzy
         kind == :defaultImplementationOf
       end
 
+      # Protocol conformances added by compiler to actor decls that
+      # users aren't interested in.
+      def actor_protocol?
+        %w[Actor Sendable].include?(target_fallback)
+      end
+
       def initialize(hash)
         kind = hash[:kind]
         unless KINDS.include?(kind)
           raise "Unknown relationship kind '#{kind}'"
         end
+
         self.kind = kind.to_sym
         self.source_usr = hash[:source]
         self.target_usr = hash[:target]

data/lib/jazzy/symbol_graph/sym_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Jazzy
   module SymbolGraph
     # The rebuilt syntax tree is made of nodes that either match
@@ -23,6 +25,7 @@ module Jazzy
 
     # A SymNode is a node of the reconstructed syntax tree holding a symbol.
     # It can turn itself into SourceKit and helps decode extensions.
+    # rubocop:disable Metrics/ClassLength
     class SymNode < BaseNode
       attr_accessor :symbol
       attr_writer :override
@@ -59,6 +62,10 @@ module Jazzy
         symbol.kind.end_with?('protocol')
       end
 
+      def actor?
+        symbol.kind.end_with?('actor')
+      end
+
       def constraints
         symbol.constraints
       end
@@ -72,6 +79,7 @@ module Jazzy
                (!protocol? || node.protocol_requirement?)
           return false
         end
+
         add_child(node)
         true
       end
@@ -93,24 +101,31 @@ module Jazzy
       # conformance: don't bother if it's already in the type declaration.
       def conformance?(protocol)
         return false unless symbol.declaration =~ /(?<=:).*?(?=(where|$))/
+
         Regexp.last_match[0] =~ /\b#{protocol}\b/
       end
 
       # Generate the 'where' clause for the declaration
       def where_clause
-        parent_constraints = (parent && parent.constraints) || []
+        parent_constraints = parent&.constraints || []
         (constraints - parent_constraints).to_where_clause
       end
 
       def inherits_clause
         return '' unless superclass_name
+
         " : #{superclass_name}"
       end
 
+      # approximately...
+      def async?
+        symbol.declaration =~ /\basync\b[^)]*$/
+      end
+
       def full_declaration
-        symbol.availability
-              .append(symbol.declaration + inherits_clause + where_clause)
-              .join("\n")
+        symbol.attributes
+          .append(symbol.declaration + inherits_clause + where_clause)
+          .join("\n")
       end
 
       # rubocop:disable Metrics/MethodLength
@@ -120,11 +135,12 @@ module Jazzy
 
         hash = {
           'key.kind' => symbol.kind,
-          'key.usr' =>  symbol.usr,
+          'key.usr' => symbol.usr,
           'key.name' => symbol.name,
           'key.accessibility' => symbol.acl,
           'key.parsed_decl' => declaration,
           'key.annotated_decl' => xml_declaration,
+          'key.symgraph_async' => async?,
         }
         if docs = symbol.doc_comments
           hash['key.doc.comment'] = docs
@@ -136,12 +152,13 @@ module Jazzy
         end
         if location = symbol.location
           hash['key.filepath'] = location[:filename]
-          hash['key.doc.line'] = location[:line]
-          hash['key.doc.column'] = location[:character]
+          hash['key.doc.line'] = location[:line] + 1
+          hash['key.doc.column'] = location[:character] + 1
         end
         unless children.empty?
           hash['key.substructure'] = children_to_sourcekit
         end
+        hash['key.symgraph_spi'] = true if symbol.spi
 
         hash
       end
@@ -154,5 +171,6 @@ module Jazzy
         symbol <=> other.symbol
       end
     end
+    # rubocop:enable Metrics/ClassLength
   end
 end

data/lib/jazzy/symbol_graph/symbol.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # rubocop:disable Metrics/ClassLength
 module Jazzy
   module SymbolGraph
@@ -8,10 +10,11 @@ module Jazzy
       attr_accessor :declaration
       attr_accessor :kind
       attr_accessor :acl
+      attr_accessor :spi
       attr_accessor :location # can be nil, keys :filename :line :character
       attr_accessor :constraints # array, can be empty
       attr_accessor :doc_comments # can be nil
-      attr_accessor :availability # array, can be empty
+      attr_accessor :attributes # array, can be empty
       attr_accessor :generic_type_params # set, can be empty
       attr_accessor :parameter_names # array, can be nil
 
@@ -22,13 +25,14 @@ module Jazzy
       def initialize(hash)
         self.usr = hash[:identifier][:precise]
         self.path_components = hash[:pathComponents]
-        raw_decl = hash[:declarationFragments].map { |f| f[:spelling] }.join
-        init_kind(hash[:kind][:identifier])
+        raw_decl, keywords = parse_decl_fragments(hash[:declarationFragments])
+        init_kind(hash[:kind][:identifier], keywords)
         init_declaration(raw_decl)
         if func_signature = hash[:functionSignature]
           init_func_signature(func_signature)
         end
         init_acl(hash[:accessLevel])
+        self.spi = hash[:spi]
         if location = hash[:location]
           init_location(location)
         end
@@ -36,19 +40,29 @@ module Jazzy
         if comments_hash = hash[:docComment]
           init_doc_comments(comments_hash)
         end
-        init_availability(hash[:availability] || [])
+        init_attributes(hash[:availability] || [])
         init_generic_type_params(hash)
       end
 
+      def parse_decl_fragments(fragments)
+        decl = ''
+        keywords = Set.new
+        fragments.each do |frag|
+          decl += frag[:spelling]
+          keywords.add(frag[:spelling]) if frag[:kind] == 'keyword'
+        end
+        [decl, keywords]
+      end
+
       # Repair problems with SymbolGraph's declprinter
 
       def init_declaration(raw_decl)
         # Too much 'Self.TypeName'; omitted arg labels look odd;
         # duplicated constraints; swift 5.3 vs. master workaround
-        self.declaration =
-          raw_decl.gsub(/\bSelf\./, '')
-                  .gsub(/(?<=\(|, )_: /, '_ arg: ')
-                  .gsub(/ where.*$/, '')
+        self.declaration = raw_decl
+          .gsub(/\bSelf\./, '')
+          .gsub(/(?<=\(|, )_: /, '_ arg: ')
+          .gsub(/ where.*$/, '')
         if kind == 'source.lang.swift.decl.class'
           declaration.sub!(/\s*:.*$/, '')
         end
@@ -85,25 +99,32 @@ module Jazzy
         'static.subscript' => 'function.subscript',
         'typealias' => 'typealias',
         'associatedtype' => 'associatedtype',
+        'actor' => 'actor',
       }.freeze
 
       # We treat 'static var' differently to 'class var'
-      def adjust_kind_for_declaration(kind)
-        return kind unless declaration =~ /\bstatic\b/
+      # We treat actors as first-class entities
+      def adjust_kind_for_declaration(kind, keywords)
+        if kind == 'swift.class' && keywords.member?('actor')
+          return 'swift.actor'
+        end
+        return kind unless keywords.member?('static')
+
         kind.gsub(/type/, 'static')
       end
 
-      def init_kind(kind)
-        adjusted = adjust_kind_for_declaration(kind)
+      def init_kind(kind, keywords)
+        adjusted = adjust_kind_for_declaration(kind, keywords)
         sourcekit_kind = KIND_MAP[adjusted.sub('swift.', '')]
         raise "Unknown symbol kind '#{kind}'" unless sourcekit_kind
-        self.kind = 'source.lang.swift.decl.' + sourcekit_kind
+
+        self.kind = "source.lang.swift.decl.#{sourcekit_kind}"
       end
 
       # Mapping SymbolGraph's ACL to SourceKit
 
       def init_acl(acl)
-        self.acl = 'source.lang.swift.accessibility.' + acl
+        self.acl = "source.lang.swift.accessibility.#{acl}"
       end
 
       # Symbol location - only available for public+ decls
@@ -120,6 +141,7 @@ module Jazzy
       def init_constraints(hash, raw_decl)
         raw_constraints = %i[swiftGenerics swiftExtension].flat_map do |key|
           next [] unless container = hash[key]
+
           container[:constraints] || []
         end
 
@@ -146,16 +168,16 @@ module Jazzy
       end
 
       def init_doc_comments(comments_hash)
-        self.doc_comments =
-          comments_hash[:lines].map { |l| l[:text] }
-                               .join("\n")
+        self.doc_comments = comments_hash[:lines]
+          .map { |l| l[:text] }
+          .join("\n")
       end
 
       # Availability
       # Re-encode this as Swift.  Should really teach Jazzy about these,
       # could maybe then do something smarter here.
-      def init_availability(avail_hash_list)
-        self.availability = avail_hash_list.map do |avail|
+      def availability_attributes(avail_hash_list)
+        avail_hash_list.map do |avail|
           str = '@available('
           if avail[:isUnconditionallyDeprecated]
             str += '*, deprecated'
@@ -171,8 +193,8 @@ module Jazzy
             next nil
           end
 
-          str += ', message: "' + avail[:message] + '"' if avail[:message]
-          str += ', renamed: "' + avail[:renamed] + '"' if avail[:renamed]
+          str += ", message: \"#{avail[:message]}\"" if avail[:message]
+          str += ", renamed: \"#{avail[:renamed]}\"" if avail[:renamed]
 
           str + ')'
         end.compact
@@ -185,11 +207,18 @@ module Jazzy
         str
       end
 
+      def spi_attributes
+        spi ? ['@_spi(Unknown)'] : []
+      end
+
+      def init_attributes(avail_hash_list)
+        self.attributes =
+          availability_attributes(avail_hash_list) + spi_attributes
+      end
+
       # Sort order
       include Comparable
 
-      # rubocop:disable Metrics/CyclomaticComplexity
-      # rubocop:disable Metrics/PerceivedComplexity
       def <=>(other)
         # Things with location: order by file/line/column
         # (pls tell what wheel i am reinventing :/)
@@ -198,6 +227,7 @@ module Jazzy
             if location[:line] == other_loc[:line]
               return location[:character] <=> other_loc[:character]
             end
+
             return location[:line] <=> other_loc[:line]
           end
           return location[:filename] <=> other_loc[:filename]
@@ -209,10 +239,9 @@ module Jazzy
 
         # Things without a location: by name and then USR
         return usr <=> other.usr if name == other.name
+
         name <=> other.name
       end
-      # rubocop:enable Metrics/PerceivedComplexity
-      # rubocop:enable Metrics/CyclomaticComplexity
     end
   end
 end

data/lib/jazzy/symbol_graph.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'set'
 require 'jazzy/symbol_graph/graph'
 require 'jazzy/symbol_graph/constraint'
@@ -12,32 +14,28 @@ require 'jazzy/symbol_graph/ext_node'
 
 module Jazzy
   module SymbolGraph
-    # Run `swift symbolgraph-extract` with configured args,
-    # parse the results, and return as JSON in SourceKit[ten]
+    # Find swift symbol graph files, either having been passed
+    # in directly, or generated by running`swift symbolgraph-extract`
+    # with configured args.
+    # Then parse the results, and return as JSON in SourceKit[ten]
     # format.
     def self.build(config)
-      Dir.mktmpdir do |tmp_dir|
-        args = arguments(config, tmp_dir)
+      if config.symbolgraph_directory.nil?
+        Dir.mktmpdir do |tmp_dir|
+          args = arguments(config, tmp_dir)
 
-        Executable.execute_command('swift',
-                                   args.unshift('symbolgraph-extract'),
-                                   true) # raise on error
+          Executable.execute_command('swift',
+                                     args.unshift('symbolgraph-extract'),
+                                     true) # raise on error
 
-        Dir[tmp_dir + '/*.symbols.json'].map do |filename|
-          # The @ part is for extensions in our module (before the @)
-          # of types in another module (after the @).
-          filename =~ /(.*?)(@(.*?))?\.symbols/
-          module_name = Regexp.last_match[3] || Regexp.last_match[1]
-          {
-            filename =>
-              Graph.new(File.read(filename), module_name).to_sourcekit,
-          }
-        end.to_json
+          parse_symbols(tmp_dir)
+        end
+      else
+        parse_symbols(config.symbolgraph_directory.to_s)
       end
     end
 
     # Figure out the args to pass to symbolgraph-extract
-    # rubocop:disable Metrics/CyclomaticComplexity
     def self.arguments(config, output_path)
       if config.module_name.empty?
         raise 'error: `--swift-build-tool symbolgraph` requires `--module`.'
@@ -45,29 +43,42 @@ module Jazzy
 
       user_args = config.build_tool_arguments.join
 
-      if user_args =~ /--(?:module-name|minimum-access-level|output-dir)/
+      if user_args =~ /-(?:module-name|minimum-access-level|output-dir)/
         raise 'error: `--build-tool-arguments` for '\
-          "`--swift-build-tool symbolgraph` can't use `--module`, "\
-          '`--minimum-access-level`, or `--output-dir`.'
+          "`--swift-build-tool symbolgraph` can't use `-module`, "\
+          '`-minimum-access-level`, or `-output-dir`.'
       end
 
       # Default set
       args = [
-        "--module-name=#{config.module_name}",
-        '--minimum-access-level=private',
-        "--output-dir=#{output_path}",
-        '--skip-synthesized-members',
+        '-module-name', config.module_name,
+        '-minimum-access-level', 'private',
+        '-output-dir', output_path,
+        '-skip-synthesized-members'
       ]
 
       # Things user can override
-      args.append("--sdk=#{sdk(config)}") unless user_args =~ /--sdk/
-      args.append("--target=#{target}") unless user_args =~ /--target/
-      args.append("-F=#{config.source_directory}") unless user_args =~ /-F(?!s)/
-      args.append("-I=#{config.source_directory}") unless user_args =~ /-I/
+      args += ['-sdk', sdk(config)] unless user_args =~ /-sdk/
+      args += ['-target', target] unless user_args =~ /-target/
+      args += ['-F', config.source_directory.to_s] unless user_args =~ /-F(?!s)/
+      args += ['-I', config.source_directory.to_s] unless user_args =~ /-I/
 
       args + config.build_tool_arguments
     end
-    # rubocop:enable Metrics/CyclomaticComplexity
+
+    # Parse the symbol files in the given directory
+    def self.parse_symbols(directory)
+      Dir[directory + '/*.symbols.json'].map do |filename|
+        # The @ part is for extensions in our module (before the @)
+        # of types in another module (after the @).
+        File.basename(filename) =~ /(.*?)(@(.*?))?\.symbols/
+        module_name = Regexp.last_match[3] || Regexp.last_match[1]
+        {
+          filename =>
+            Graph.new(File.read(filename), module_name).to_sourcekit,
+        }
+      end.to_json
+    end
 
     # Get the SDK path.  On !darwin this just isn't needed.
     def self.sdk(config)
@@ -87,8 +98,8 @@ module Jazzy
     def self.demangle(usr)
       args = %w[demangle -simplified -compact].append(usr.sub(/^s:/, 's'))
       output, = Executable.execute_command('swift', args, true)
-      return output.chomp
-    rescue
+      output.chomp
+    rescue StandardError
       usr
     end
   end

data/lib/jazzy/themes/apple/assets/css/highlight.css.scss

@@ -1,63 +1,67 @@
+/*! Jazzy - https://github.com/realm/jazzy
+ *  Copyright Realm Inc.
+ *  SPDX-License-Identifier: MIT
+ */
 /* Credit to https://gist.github.com/wataru420/2048287 */
 
 .highlight {
-  .c { color: #999988; font-style: italic } /* Comment */
-  .err { color: #a61717; background-color: #e3d2d2 } /* Error */
-  .k { color: #000000; font-weight: bold } /* Keyword */
-  .o { color: #000000; font-weight: bold } /* Operator */
-  .cm { color: #999988; font-style: italic } /* Comment.Multiline */
-  .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
-  .c1 { color: #999988; font-style: italic } /* Comment.Single */
-  .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
-  .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
-  .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
-  .ge { color: #000000; font-style: italic } /* Generic.Emph */
-  .gr { color: #aa0000 } /* Generic.Error */
-  .gh { color: #999999 } /* Generic.Heading */
-  .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
-  .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
-  .go { color: #888888 } /* Generic.Output */
-  .gp { color: #555555 } /* Generic.Prompt */
-  .gs { font-weight: bold } /* Generic.Strong */
-  .gu { color: #aaaaaa } /* Generic.Subheading */
-  .gt { color: #aa0000 } /* Generic.Traceback */
-  .kc { color: #000000; font-weight: bold } /* Keyword.Constant */
-  .kd { color: #000000; font-weight: bold } /* Keyword.Declaration */
-  .kp { color: #000000; font-weight: bold } /* Keyword.Pseudo */
-  .kr { color: #000000; font-weight: bold } /* Keyword.Reserved */
-  .kt { color: #445588; } /* Keyword.Type */
-  .m { color: #009999 } /* Literal.Number */
-  .s { color: #d14 } /* Literal.String */
-  .na { color: #008080 } /* Name.Attribute */
-  .nb { color: #0086B3 } /* Name.Builtin */
-  .nc { color: #445588; font-weight: bold } /* Name.Class */
-  .no { color: #008080 } /* Name.Constant */
-  .ni { color: #800080 } /* Name.Entity */
-  .ne { color: #990000; font-weight: bold } /* Name.Exception */
-  .nf { color: #990000; } /* Name.Function */
-  .nn { color: #555555 } /* Name.Namespace */
-  .nt { color: #000080 } /* Name.Tag */
-  .nv { color: #008080 } /* Name.Variable */
-  .ow { color: #000000; font-weight: bold } /* Operator.Word */
-  .w { color: #bbbbbb } /* Text.Whitespace */
-  .mf { color: #009999 } /* Literal.Number.Float */
-  .mh { color: #009999 } /* Literal.Number.Hex */
-  .mi { color: #009999 } /* Literal.Number.Integer */
-  .mo { color: #009999 } /* Literal.Number.Oct */
-  .sb { color: #d14 } /* Literal.String.Backtick */
-  .sc { color: #d14 } /* Literal.String.Char */
-  .sd { color: #d14 } /* Literal.String.Doc */
-  .s2 { color: #d14 } /* Literal.String.Double */
-  .se { color: #d14 } /* Literal.String.Escape */
-  .sh { color: #d14 } /* Literal.String.Heredoc */
-  .si { color: #d14 } /* Literal.String.Interpol */
-  .sx { color: #d14 } /* Literal.String.Other */
-  .sr { color: #009926 } /* Literal.String.Regex */
-  .s1 { color: #d14 } /* Literal.String.Single */
-  .ss { color: #990073 } /* Literal.String.Symbol */
-  .bp { color: #999999 } /* Name.Builtin.Pseudo */
-  .vc { color: #008080 } /* Name.Variable.Class */
-  .vg { color: #008080 } /* Name.Variable.Global */
-  .vi { color: #008080 } /* Name.Variable.Instance */
-  .il { color: #009999 } /* Literal.Number.Integer.Long */
+  .c { color: #999988; font-style: italic } // Comment
+  .err { color: #a61717; background-color: #e3d2d2 } // Error
+  .k { color: #000000; font-weight: bold } // Keyword
+  .o { color: #000000; font-weight: bold } // Operator
+  .cm { color: #999988; font-style: italic } // Comment.Multiline
+  .cp { color: #999999; font-weight: bold } // Comment.Preproc
+  .c1 { color: #999988; font-style: italic } // Comment.Single
+  .cs { color: #999999; font-weight: bold; font-style: italic } // Comment.Special
+  .gd { color: #000000; background-color: #ffdddd } // Generic.Deleted
+  .gd .x { color: #000000; background-color: #ffaaaa } // Generic.Deleted.Specific
+  .ge { color: #000000; font-style: italic } // Generic.Emph
+  .gr { color: #aa0000 } // Generic.Error
+  .gh { color: #999999 } // Generic.Heading
+  .gi { color: #000000; background-color: #ddffdd } // Generic.Inserted
+  .gi .x { color: #000000; background-color: #aaffaa } // Generic.Inserted.Specific
+  .go { color: #888888 } // Generic.Output
+  .gp { color: #555555 } // Generic.Prompt
+  .gs { font-weight: bold } // Generic.Strong
+  .gu { color: #aaaaaa } // Generic.Subheading
+  .gt { color: #aa0000 } // Generic.Traceback
+  .kc { color: #000000; font-weight: bold } // Keyword.Constant
+  .kd { color: #000000; font-weight: bold } // Keyword.Declaration
+  .kp { color: #000000; font-weight: bold } // Keyword.Pseudo
+  .kr { color: #000000; font-weight: bold } // Keyword.Reserved
+  .kt { color: #445588; } // Keyword.Type
+  .m { color: #009999 } // Literal.Number
+  .s { color: #d14 } // Literal.String
+  .na { color: #008080 } // Name.Attribute
+  .nb { color: #0086B3 } // Name.Builtin
+  .nc { color: #445588; font-weight: bold } // Name.Class
+  .no { color: #008080 } // Name.Constant
+  .ni { color: #800080 } // Name.Entity
+  .ne { color: #990000; font-weight: bold } // Name.Exception
+  .nf { color: #990000; } // Name.Function
+  .nn { color: #555555 } // Name.Namespace
+  .nt { color: #000080 } // Name.Tag
+  .nv { color: #008080 } // Name.Variable
+  .ow { color: #000000; font-weight: bold } // Operator.Word
+  .w { color: #bbbbbb } // Text.Whitespace
+  .mf { color: #009999 } // Literal.Number.Float
+  .mh { color: #009999 } // Literal.Number.Hex
+  .mi { color: #009999 } // Literal.Number.Integer
+  .mo { color: #009999 } // Literal.Number.Oct
+  .sb { color: #d14 } // Literal.String.Backtick
+  .sc { color: #d14 } // Literal.String.Char
+  .sd { color: #d14 } // Literal.String.Doc
+  .s2 { color: #d14 } // Literal.String.Double
+  .se { color: #d14 } // Literal.String.Escape
+  .sh { color: #d14 } // Literal.String.Heredoc
+  .si { color: #d14 } // Literal.String.Interpol
+  .sx { color: #d14 } // Literal.String.Other
+  .sr { color: #009926 } // Literal.String.Regex
+  .s1 { color: #d14 } // Literal.String.Single
+  .ss { color: #990073 } // Literal.String.Symbol
+  .bp { color: #999999 } // Name.Builtin.Pseudo
+  .vc { color: #008080 } // Name.Variable.Class
+  .vg { color: #008080 } // Name.Variable.Global
+  .vi { color: #008080 } // Name.Variable.Instance
+  .il { color: #009999 } // Literal.Number.Integer.Long
 }

data/lib/jazzy/themes/apple/assets/css/jazzy.css.scss

@@ -1,3 +1,7 @@
+/*! Jazzy - https://github.com/realm/jazzy
+ *  Copyright Realm Inc.
+ *  SPDX-License-Identifier: MIT
+ */
 ////////////////////////////////
 // Constants
 ////////////////////////////////
@@ -181,7 +185,7 @@ header {
   z-index: 3;
   img {
     padding-right: 6px;
-    vertical-align: -4px;
+    vertical-align: -3px;
     height: 16px;
   }
   a {