docyard 0.6.0 → 0.8.0

data/lib/docyard/templates/partials/_sidebar.html.erb

@@ -1,6 +1,23 @@
 <aside class="sidebar" role="navigation" aria-label="Documentation navigation">
-  <nav>
-    <%= @nav_content %>
-  </nav>
-  <%= @footer_html %>
+  <% if @header_ctas&.any? %>
+  <div class="sidebar-ctas">
+    <% @header_ctas.sort_by { |cta| cta[:variant] == 'secondary' ? 0 : 1 }.each do |cta| %>
+    <a href="<%= cta[:external] ? cta[:href] : link_path(cta[:href]) %>"
+       class="sidebar-cta sidebar-cta--<%= cta[:variant] || 'primary' %>"
+       <%= 'target="_blank" rel="noopener noreferrer"' if cta[:external] %>>
+      <%= cta[:text] %>
+      <% if cta[:variant] != 'secondary' %>
+      <svg class="sidebar-cta-arrow" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M9 5l7 7-7 7"/>
+      </svg>
+      <% end %>
+    </a>
+    <% end %>
+  </div>
+  <% end %>
+  <div class="sidebar-scroll">
+    <nav>
+      <%= @nav_content %>
+    </nav>
+  </div>
 </aside>

data/lib/docyard/templates/partials/_tab_bar.html.erb

@@ -0,0 +1,25 @@
+<% if @has_tabs && @tabs&.any? %>
+<nav class="tab-bar" aria-label="Main navigation">
+  <div class="tab-bar-content">
+    <% @tabs.each do |tab| %>
+    <a href="<%= tab[:external] ? tab[:href] : link_path(tab[:href]) %>"
+       class="tab-item<%= ' is-active' if tab[:active] %>"
+       <%= 'target="_blank" rel="noopener noreferrer"' if tab[:external] %>
+       data-tab-href="<%= tab[:href] %>">
+      <% if tab[:icon] %>
+      <span class="tab-icon"><%= icon(tab[:icon]) %></span>
+      <% end %>
+      <span><%= tab[:text] %></span>
+      <% if tab[:external] %>
+      <svg class="tab-external-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path>
+        <polyline points="15 3 21 3 21 9"></polyline>
+        <line x1="10" y1="14" x2="21" y2="3"></line>
+      </svg>
+      <% end %>
+    </a>
+    <% end %>
+    <div class="tab-indicator" id="tabIndicator"></div>
+  </div>
+</nav>
+<% end %>

data/lib/docyard/templates/partials/_table_of_contents.html.erb

@@ -1,14 +1,13 @@
 <% unless @toc.empty? %>
-  <aside class="docyard-toc" aria-label="Table of contents">
-    <div class="docyard-toc__header">
-      <h2 class="docyard-toc__title">
-        <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" fill="currentColor" viewBox="0 0 256 256" aria-hidden="true">
-          <path d="M88,64a8,8,0,0,1,8-8H216a8,8,0,0,1,0,16H96A8,8,0,0,1,88,64Zm128,56H96a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16Zm0,64H96a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16ZM56,56H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Zm0,64H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Zm0,64H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Z"/>
-        </svg>
-        On this page
-      </h2>
-    </div>
-    <nav id="toc-content" class="docyard-toc__nav">
+  <div class="docyard-toc" role="complementary" aria-label="Table of contents">
+    <div class="docyard-toc__scroll">
+      <div class="docyard-toc__header">
+        <h2 class="docyard-toc__title">
+          <%= icon(:table) %>
+          On this page
+        </h2>
+      </div>
+      <nav id="toc-content" class="docyard-toc__nav">
       <ul class="docyard-toc__list">
         <% @toc.each do |heading| %>
           <li class="docyard-toc__item docyard-toc__item--level-<%= heading[:level] %>">
@@ -40,6 +39,7 @@
           </li>
         <% end %>
       </ul>
-    </nav>
-  </aside>
+      </nav>
+    </div>
+  </div>
 <% end %>

data/lib/docyard/templates/partials/_table_of_contents_toggle.html.erb

@@ -1,8 +1,6 @@
 <% unless @toc.empty? %>
   <button class="secondary-header-toc-toggle" aria-expanded="false" aria-controls="toc-content" aria-label="Toggle table of contents">
     <span>On this page</span>
-    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 256 256" fill="currentColor" aria-hidden="true">
-      <path d="M213.66,101.66l-80,80a8,8,0,0,1-11.32,0l-80-80A8,8,0,0,1,53.66,90.34L128,164.69l74.34-74.35a8,8,0,0,1,11.32,11.32Z"/>
-    </svg>
+    <%= icon(:caret_down) %>
   </button>
 <% end %>

data/lib/docyard/templates/partials/_tabs.html.erb

@@ -13,9 +13,9 @@
           <% if tab[:icon] %>
             <span class="docyard-tabs__icon">
               <% if tab[:icon_source] == "file-extension" %>
-                <%= Docyard::Icons.render_file_extension(tab[:icon]) %>
+                <%= icon_file_extension(tab[:icon]) %>
               <% elsif tab[:icon_source] == "phosphor" %>
-                <%= Docyard::Icons.render(tab[:icon]) %>
+                <%= icon(tab[:icon]) %>
               <% end %>
             </span>
           <% end %>

data/lib/docyard/templates/partials/_theme_toggle.html.erb

@@ -1,13 +1,4 @@
 <button class="theme-toggle" aria-label="Toggle theme" title="Toggle theme">
-  <span class="theme-toggle-track">
-    <!-- Sun icon -->
-    <svg class="theme-toggle-icon theme-toggle-sun-icon" xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 256 256" fill="currentColor">
-      <path d="M120,40V16a8,8,0,0,1,16,0V40a8,8,0,0,1-16,0Zm72,88a64,64,0,1,1-64-64A64.07,64.07,0,0,1,192,128Zm-16,0a48,48,0,1,0-48,48A48.05,48.05,0,0,0,176,128ZM58.34,69.66A8,8,0,0,0,69.66,58.34l-16-16A8,8,0,0,0,42.34,53.66Zm0,116.68-16,16a8,8,0,0,0,11.32,11.32l16-16a8,8,0,0,0-11.32-11.32ZM192,72a8,8,0,0,0,5.66-2.34l16-16a8,8,0,0,0-11.32-11.32l-16,16A8,8,0,0,0,192,72Zm5.66,114.34a8,8,0,0,0-11.32,11.32l16,16a8,8,0,0,0,11.32-11.32ZM48,128a8,8,0,0,0-8-8H16a8,8,0,0,0,0,16H40A8,8,0,0,0,48,128Zm80,80a8,8,0,0,0-8,8v24a8,8,0,0,0,16,0V216A8,8,0,0,0,128,208Zm112-88H216a8,8,0,0,0,0,16h24a8,8,0,0,0,0-16Z"></path>
-    </svg>
-    <!-- Moon stars icon -->
-    <svg class="theme-toggle-icon theme-toggle-moon-icon" xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 256 256" fill="currentColor">
-      <path d="M240,96a8,8,0,0,1-8,8H216v16a8,8,0,0,1-16,0V104H184a8,8,0,0,1,0-16h16V72a8,8,0,0,1,16,0V88h16A8,8,0,0,1,240,96ZM144,56h8v8a8,8,0,0,0,16,0V56h8a8,8,0,0,0,0-16h-8V32a8,8,0,0,0-16,0v8h-8a8,8,0,0,0,0,16Zm72.77,97a8,8,0,0,1,1.43,8A96,96,0,1,1,95.07,37.8a8,8,0,0,1,10.6,9.06A88.07,88.07,0,0,0,209.14,150.33,8,8,0,0,1,216.77,153Zm-19.39,14.88c-1.79.09-3.59.14-5.38.14A104.11,104.11,0,0,1,88,64c0-1.79,0-3.59.14-5.38A80,80,0,1,0,197.38,167.86Z"></path>
-    </svg>
-    <span class="theme-toggle-thumb"></span>
-  </span>
+  <span class="theme-toggle-sun"><%= icon(:sun) %></span>
+  <span class="theme-toggle-moon"><%= icon(:moon_stars) %></span>
 </button>

data/lib/docyard/utils/html_helpers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Utils
+    module HtmlHelpers
+      def escape_html_attribute(text)
+        text.gsub('"', """)
+          .gsub("'", "'")
+          .gsub("<", "&lt;")
+          .gsub(">", "&gt;")
+      end
+    end
+  end
+end

data/lib/docyard/utils/path_resolver.rb

@@ -6,7 +6,8 @@ module Docyard
       def self.normalize(path)
         return "/" if path.nil? || path.empty?
 
-        normalized = path.delete_suffix(".md")
+        normalized = path.delete_suffix("/")
+          .delete_suffix(".md")
           .delete_suffix("/index")
 
         normalized = "" if normalized == "index"

data/lib/docyard/utils/url_helpers.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Utils
+    module UrlHelpers
+      def normalize_base_url(url)
+        return "/" if url.nil? || url.empty?
+
+        url = "/#{url}" unless url.start_with?("/")
+        url.end_with?("/") ? url : "#{url}/"
+      end
+
+      def link_path(path)
+        return path if path.nil? || path.start_with?("http://", "https://")
+
+        "#{base_url.chomp('/')}#{path}"
+      end
+    end
+  end
+end

data/lib/docyard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Docyard
-  VERSION = "0.6.0"
+  VERSION = "0.8.0"
 end

data/lib/docyard.rb

@@ -1,34 +1,41 @@
 # frozen_string_literal: true
 
-# Core modules
 require_relative "docyard/version"
-require_relative "docyard/constants"
-require_relative "docyard/errors"
-require_relative "docyard/logging"
+require_relative "docyard/config/constants"
+require_relative "docyard/utils/errors"
+require_relative "docyard/utils/logging"
 
-# Utilities
 require_relative "docyard/utils/text_formatter"
 require_relative "docyard/utils/path_resolver"
+require_relative "docyard/utils/url_helpers"
+require_relative "docyard/utils/html_helpers"
 
-# Routing
-require_relative "docyard/routing/resolution_result"
-require_relative "docyard/router"
+require_relative "docyard/server/resolution_result"
+require_relative "docyard/server/router"
+require_relative "docyard/server/asset_handler"
+require_relative "docyard/server/dev_server"
+require_relative "docyard/server/preview_server"
+
+require_relative "docyard/rendering/markdown"
+require_relative "docyard/rendering/renderer"
+
+require_relative "docyard/navigation/sidebar_builder"
+require_relative "docyard/navigation/prev_next_builder"
+
+require_relative "docyard/config/branding_resolver"
 
-# Application components
-require_relative "docyard/markdown"
-require_relative "docyard/renderer"
-require_relative "docyard/asset_handler"
 require_relative "docyard/initializer"
-require_relative "docyard/server"
 require_relative "docyard/cli"
 
-# Build components
+require_relative "docyard/search/pagefind_support"
+require_relative "docyard/search/dev_indexer"
+require_relative "docyard/search/build_indexer"
+
 require_relative "docyard/builder"
 require_relative "docyard/build/static_generator"
 require_relative "docyard/build/asset_bundler"
 require_relative "docyard/build/file_copier"
 require_relative "docyard/build/sitemap_generator"
-require_relative "docyard/preview_server"
 
 module Docyard
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docyard
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Sanif Himani
@@ -183,73 +183,94 @@ files:
 - README.md
 - Rakefile
 - lib/docyard.rb
-- lib/docyard/asset_handler.rb
 - lib/docyard/build/asset_bundler.rb
 - lib/docyard/build/file_copier.rb
 - lib/docyard/build/sitemap_generator.rb
 - lib/docyard/build/static_generator.rb
 - lib/docyard/builder.rb
 - lib/docyard/cli.rb
+- lib/docyard/components/aliases.rb
 - lib/docyard/components/base_processor.rb
-- lib/docyard/components/callout_processor.rb
-- lib/docyard/components/code_block_diff_preprocessor.rb
-- lib/docyard/components/code_block_feature_extractor.rb
-- lib/docyard/components/code_block_focus_preprocessor.rb
-- lib/docyard/components/code_block_icon_detector.rb
-- lib/docyard/components/code_block_line_wrapper.rb
-- lib/docyard/components/code_block_options_preprocessor.rb
-- lib/docyard/components/code_block_patterns.rb
-- lib/docyard/components/code_block_processor.rb
-- lib/docyard/components/code_detector.rb
-- lib/docyard/components/code_line_parser.rb
-- lib/docyard/components/code_snippet_import_preprocessor.rb
-- lib/docyard/components/heading_anchor_processor.rb
-- lib/docyard/components/icon_detector.rb
-- lib/docyard/components/icon_processor.rb
+- lib/docyard/components/processors/callout_processor.rb
+- lib/docyard/components/processors/code_block_diff_preprocessor.rb
+- lib/docyard/components/processors/code_block_focus_preprocessor.rb
+- lib/docyard/components/processors/code_block_options_preprocessor.rb
+- lib/docyard/components/processors/code_block_processor.rb
+- lib/docyard/components/processors/code_snippet_import_preprocessor.rb
+- lib/docyard/components/processors/heading_anchor_processor.rb
+- lib/docyard/components/processors/icon_processor.rb
+- lib/docyard/components/processors/table_of_contents_processor.rb
+- lib/docyard/components/processors/table_wrapper_processor.rb
+- lib/docyard/components/processors/tabs_processor.rb
 - lib/docyard/components/registry.rb
-- lib/docyard/components/table_of_contents_processor.rb
-- lib/docyard/components/table_wrapper_processor.rb
-- lib/docyard/components/tabs_parser.rb
-- lib/docyard/components/tabs_processor.rb
-- lib/docyard/components/tabs_range_finder.rb
+- lib/docyard/components/support/code_block/feature_extractor.rb
+- lib/docyard/components/support/code_block/icon_detector.rb
+- lib/docyard/components/support/code_block/line_parser.rb
+- lib/docyard/components/support/code_block/line_wrapper.rb
+- lib/docyard/components/support/code_block/patterns.rb
+- lib/docyard/components/support/code_detector.rb
+- lib/docyard/components/support/tabs/icon_detector.rb
+- lib/docyard/components/support/tabs/parser.rb
+- lib/docyard/components/support/tabs/range_finder.rb
 - lib/docyard/config.rb
+- lib/docyard/config/branding_resolver.rb
+- lib/docyard/config/constants.rb
 - lib/docyard/config/validator.rb
-- lib/docyard/constants.rb
-- lib/docyard/errors.rb
-- lib/docyard/file_watcher.rb
-- lib/docyard/icons.rb
-- lib/docyard/icons/LICENSE.phosphor
-- lib/docyard/icons/file_types.rb
-- lib/docyard/icons/phosphor.rb
 - lib/docyard/initializer.rb
-- lib/docyard/language_mapping.rb
-- lib/docyard/logging.rb
-- lib/docyard/markdown.rb
-- lib/docyard/prev_next_builder.rb
-- lib/docyard/preview_server.rb
-- lib/docyard/rack_application.rb
-- lib/docyard/renderer.rb
-- lib/docyard/router.rb
-- lib/docyard/routing/resolution_result.rb
-- lib/docyard/server.rb
-- lib/docyard/sidebar/config_parser.rb
-- lib/docyard/sidebar/file_system_scanner.rb
-- lib/docyard/sidebar/item.rb
-- lib/docyard/sidebar/renderer.rb
-- lib/docyard/sidebar/title_extractor.rb
-- lib/docyard/sidebar/tree_builder.rb
-- lib/docyard/sidebar_builder.rb
+- lib/docyard/navigation/breadcrumb_builder.rb
+- lib/docyard/navigation/prev_next_builder.rb
+- lib/docyard/navigation/sidebar/children_discoverer.rb
+- lib/docyard/navigation/sidebar/config_parser.rb
+- lib/docyard/navigation/sidebar/file_resolver.rb
+- lib/docyard/navigation/sidebar/file_system_scanner.rb
+- lib/docyard/navigation/sidebar/item.rb
+- lib/docyard/navigation/sidebar/local_config_loader.rb
+- lib/docyard/navigation/sidebar/metadata_extractor.rb
+- lib/docyard/navigation/sidebar/metadata_reader.rb
+- lib/docyard/navigation/sidebar/path_prefixer.rb
+- lib/docyard/navigation/sidebar/renderer.rb
+- lib/docyard/navigation/sidebar/sorter.rb
+- lib/docyard/navigation/sidebar/title_extractor.rb
+- lib/docyard/navigation/sidebar/tree_builder.rb
+- lib/docyard/navigation/sidebar/tree_filter.rb
+- lib/docyard/navigation/sidebar_builder.rb
+- lib/docyard/rendering/icon_helpers.rb
+- lib/docyard/rendering/icons.rb
+- lib/docyard/rendering/icons/LICENSE.phosphor
+- lib/docyard/rendering/icons/file_types.rb
+- lib/docyard/rendering/icons/phosphor.rb
+- lib/docyard/rendering/language_mapping.rb
+- lib/docyard/rendering/markdown.rb
+- lib/docyard/rendering/renderer.rb
+- lib/docyard/rendering/template_resolver.rb
+- lib/docyard/routing/fallback_resolver.rb
+- lib/docyard/search/build_indexer.rb
+- lib/docyard/search/dev_indexer.rb
+- lib/docyard/search/pagefind_support.rb
+- lib/docyard/server/asset_handler.rb
+- lib/docyard/server/dev_server.rb
+- lib/docyard/server/file_watcher.rb
+- lib/docyard/server/pagefind_handler.rb
+- lib/docyard/server/preview_server.rb
+- lib/docyard/server/rack_application.rb
+- lib/docyard/server/resolution_result.rb
+- lib/docyard/server/router.rb
 - lib/docyard/templates/assets/css/code.css
+- lib/docyard/templates/assets/css/components/breadcrumbs.css
 - lib/docyard/templates/assets/css/components/callout.css
 - lib/docyard/templates/assets/css/components/code-block.css
 - lib/docyard/templates/assets/css/components/heading-anchor.css
 - lib/docyard/templates/assets/css/components/icon.css
 - lib/docyard/templates/assets/css/components/logo.css
+- lib/docyard/templates/assets/css/components/nav-menu.css
 - lib/docyard/templates/assets/css/components/navigation.css
 - lib/docyard/templates/assets/css/components/prev-next.css
+- lib/docyard/templates/assets/css/components/search.css
+- lib/docyard/templates/assets/css/components/tab-bar.css
 - lib/docyard/templates/assets/css/components/table-of-contents.css
 - lib/docyard/templates/assets/css/components/tabs.css
 - lib/docyard/templates/assets/css/components/theme-toggle.css
+- lib/docyard/templates/assets/css/landing.css
 - lib/docyard/templates/assets/css/layout.css
 - lib/docyard/templates/assets/css/main.css
 - lib/docyard/templates/assets/css/markdown.css
@@ -257,9 +278,13 @@ files:
 - lib/docyard/templates/assets/css/typography.css
 - lib/docyard/templates/assets/css/variables.css
 - lib/docyard/templates/assets/favicon.svg
+- lib/docyard/templates/assets/fonts/Inter-Variable.ttf
 - lib/docyard/templates/assets/js/components/code-block.js
 - lib/docyard/templates/assets/js/components/heading-anchor.js
 - lib/docyard/templates/assets/js/components/navigation.js
+- lib/docyard/templates/assets/js/components/search.js
+- lib/docyard/templates/assets/js/components/sidebar-toggle.js
+- lib/docyard/templates/assets/js/components/tab-navigation.js
 - lib/docyard/templates/assets/js/components/table-of-contents.js
 - lib/docyard/templates/assets/js/components/tabs.js
 - lib/docyard/templates/assets/js/reload.js
@@ -270,29 +295,43 @@ files:
 - lib/docyard/templates/errors/404.html.erb
 - lib/docyard/templates/errors/500.html.erb
 - lib/docyard/templates/layouts/default.html.erb
-- lib/docyard/templates/markdown/getting-started/installation.md.erb
-- lib/docyard/templates/markdown/guides/configuration.md.erb
-- lib/docyard/templates/markdown/guides/markdown-features.md.erb
-- lib/docyard/templates/markdown/index.md.erb
+- lib/docyard/templates/layouts/splash.html.erb
+- lib/docyard/templates/partials/_breadcrumbs.html.erb
 - lib/docyard/templates/partials/_callout.html.erb
 - lib/docyard/templates/partials/_code_block.html.erb
+- lib/docyard/templates/partials/_doc_footer.html.erb
+- lib/docyard/templates/partials/_features.html.erb
+- lib/docyard/templates/partials/_footer.html.erb
+- lib/docyard/templates/partials/_head.html.erb
+- lib/docyard/templates/partials/_header.html.erb
 - lib/docyard/templates/partials/_heading_anchor.html.erb
+- lib/docyard/templates/partials/_hero.html.erb
 - lib/docyard/templates/partials/_icon.html.erb
 - lib/docyard/templates/partials/_icon_file_extension.html.erb
 - lib/docyard/templates/partials/_nav_group.html.erb
 - lib/docyard/templates/partials/_nav_item.html.erb
 - lib/docyard/templates/partials/_nav_leaf.html.erb
 - lib/docyard/templates/partials/_nav_list.html.erb
+- lib/docyard/templates/partials/_nav_menu.html.erb
+- lib/docyard/templates/partials/_nav_nested_section.html.erb
 - lib/docyard/templates/partials/_nav_section.html.erb
 - lib/docyard/templates/partials/_prev_next.html.erb
+- lib/docyard/templates/partials/_scripts.html.erb
+- lib/docyard/templates/partials/_search_modal.html.erb
+- lib/docyard/templates/partials/_search_trigger.html.erb
 - lib/docyard/templates/partials/_sidebar.html.erb
 - lib/docyard/templates/partials/_sidebar_footer.html.erb
+- lib/docyard/templates/partials/_tab_bar.html.erb
 - lib/docyard/templates/partials/_table_of_contents.html.erb
 - lib/docyard/templates/partials/_table_of_contents_toggle.html.erb
 - lib/docyard/templates/partials/_tabs.html.erb
 - lib/docyard/templates/partials/_theme_toggle.html.erb
+- lib/docyard/utils/errors.rb
+- lib/docyard/utils/html_helpers.rb
+- lib/docyard/utils/logging.rb
 - lib/docyard/utils/path_resolver.rb
 - lib/docyard/utils/text_formatter.rb
+- lib/docyard/utils/url_helpers.rb
 - lib/docyard/version.rb
 - sig/docyard.rbs
 homepage: https://github.com/sanifhimani/docyard

data/lib/docyard/components/callout_processor.rb

@@ -1,121 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../icons"
-require_relative "../renderer"
-require_relative "base_processor"
-require "kramdown"
-require "kramdown-parser-gfm"
-
-module Docyard
-  module Components
-    class CalloutProcessor < BaseProcessor
-      self.priority = 10
-
-      CALLOUT_TYPES = {
-        "note" => { title: "Note", icon: "info", color: "note" },
-        "tip" => { title: "Tip", icon: "lightbulb", color: "tip" },
-        "important" => { title: "Important", icon: "warning-circle", color: "important" },
-        "warning" => { title: "Warning", icon: "warning", color: "warning" },
-        "danger" => { title: "Danger", icon: "siren", color: "danger" }
-      }.freeze
-
-      GITHUB_ALERT_TYPES = {
-        "NOTE" => "note",
-        "TIP" => "tip",
-        "IMPORTANT" => "important",
-        "WARNING" => "warning",
-        "CAUTION" => "danger"
-      }.freeze
-
-      def preprocess(markdown)
-        process_container_syntax(markdown)
-      end
-
-      def postprocess(html)
-        process_github_alerts(html)
-      end
-
-      private
-
-      def process_container_syntax(markdown)
-        markdown.gsub(/^:::[ \t]*(\w+)(?:[ \t]+([^\n]+?))?[ \t]*\n(.*?)^:::[ \t]*$/m) do
-          process_callout_match(Regexp.last_match(0), Regexp.last_match(1), Regexp.last_match(2), Regexp.last_match(3))
-        end
-      end
-
-      def process_callout_match(original_match, type_raw, custom_title, content_markdown)
-        type = type_raw.downcase
-        return original_match unless CALLOUT_TYPES.key?(type)
-
-        config = CALLOUT_TYPES[type]
-        title = determine_title(custom_title, config[:title])
-        content_html = render_markdown_content(content_markdown.strip)
-
-        wrap_in_nomarkdown(render_callout_html(type, title, content_html, config[:icon]))
-      end
-
-      def determine_title(custom_title, default_title)
-        title = custom_title&.strip
-        title.nil? || title.empty? ? default_title : title
-      end
-
-      def render_markdown_content(content_markdown)
-        return "" if content_markdown.empty?
-
-        Kramdown::Document.new(
-          content_markdown,
-          input: "GFM",
-          hard_wrap: false,
-          syntax_highlighter: "rouge"
-        ).to_html
-      end
-
-      def wrap_in_nomarkdown(html)
-        "{::nomarkdown}\n#{html}\n{:/nomarkdown}"
-      end
-
-      def process_github_alerts(html)
-        github_alert_regex = %r{
-          <blockquote>\s*
-          <p>\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*
-          (?:<br\s*/>)?\s*
-          (.*?)</p>
-          (.*?)
-          </blockquote>
-        }mx
-
-        html.gsub(github_alert_regex) do
-          process_github_alert_match(Regexp.last_match(1), Regexp.last_match(2), Regexp.last_match(3))
-        end
-      end
-
-      def process_github_alert_match(alert_type, first_para, rest_content)
-        type = GITHUB_ALERT_TYPES[alert_type]
-        config = CALLOUT_TYPES[type]
-        content_html = combine_alert_content(first_para.strip, rest_content.strip)
-
-        render_callout_html(type, config[:title], content_html, config[:icon])
-      end
-
-      def combine_alert_content(first_para, rest_content)
-        return "<p>#{first_para}</p>" if rest_content.empty?
-
-        "<p>#{first_para}</p>#{rest_content}"
-      end
-
-      def render_callout_html(type, title, content_html, icon_name)
-        icon_svg = Icons.render(icon_name, "duotone") || ""
-        renderer = Renderer.new
-
-        renderer.render_partial(
-          "_callout", {
-            type: type,
-            title: title,
-            content_html: content_html,
-            icon_svg: icon_svg
-          }
-        )
-      end
-    end
-  end
-end