releasehx 0.1.2 → 0.2.0

data/lib/releasehx/ops/enrich_ops.rb

@@ -34,7 +34,16 @@ module ReleaseHx
       when :html
         # Direct Liquid template rendering to HTML
         html_content = DraftOps.process_template_content(release: release, config: config, format: :html)
-        WriteOps.safe_write(outpath, html_content)
+
+        # Wrap HTML with Bootstrap styling if enabled
+        enriched = if config && config.dig('modes', 'html_wrap') != false
+                     ReleaseHx.logger.debug('Applying HTML wrapper')
+                     wrap_html(html_content, config)
+                   else
+                     html_content
+                   end
+
+        WriteOps.safe_write(outpath, enriched)
       when :pdf
         # Two-stage process: RHYML → AsciiDoc → PDF
         asciidoc_content = DraftOps.process_template_content(release: release, config: config, format: :adoc)
@@ -49,7 +58,7 @@ module ReleaseHx
     # Generates rich-text output from source draft files of various formats.
     #
     # Automatically detects the input file type and applies the appropriate conversion
-    #  strategy, supporting YAML (via RHYML), Markdown, and AsciiDoc source formats.
+    #  strategy, supporting YAML (via RHYML) and AsciiDoc source formats.
     #
     # @param file_path [String] The path to the source draft file.
     # @param format [Symbol] The target output format (:html or :pdf).
@@ -75,9 +84,6 @@ module ReleaseHx
         # RHYML/YAML files: load as Release object and use Liquid templates
         release = load_rhyml_from_yaml(file_path, config: config)
         enrich_from_rhyml(release: release, config: config, format: format, outpath: outpath, force: true)
-      when '.md'
-        # Markdown files: use native converter
-        convert_markdown(file_path, format: format, config: config, outpath: outpath, force: true)
       when '.adoc'
         # AsciiDoc files: use native converter
         convert_asciidoc(file_path, format: format, config: config, outpath: outpath, force: true)
@@ -86,70 +92,41 @@ module ReleaseHx
       end
     end
 
-    # Converts Markdown files to rich-text formats using native converters.
+    # Converts AsciiDoc content or files to rich-text formats using configured engines.
     #
-    # Uses Kramdown for HTML generation and Tilt with Pandoc for PDF conversion.
-    # Note: Some parameters are reserved for API consistency across conversion methods.
-    #
-    # @param file_path [String] The path to the source Markdown file.
-    # @param format [Symbol] The target output format (:html or :pdf).
-    # @param config [ReleaseHx::Configuration] Reserved for future use.
-    # @param outpath [String] The target output file path.
-    # @param force [Boolean] Reserved for future use.
-    # @return [String] The path to the generated output file.
-    # rubocop:disable Lint/UnusedMethodArgument
-    def self.convert_markdown file_path, format:, config:, outpath:, force:
-      # NOTE: config and force parameters are currently unused but kept for API consistency
-      content = File.read(file_path)
-
-      case format.to_sym
-      when :html
-        require 'kramdown'
-        enriched = Kramdown::Document.new(content).to_html
-        WriteOps.safe_write(outpath, enriched)
-      when :pdf
-        # Use Tilt with Pandoc for direct Markdown to PDF conversion
-        require 'tilt'
-        require 'tilt/pandoc'
-
-        template = Tilt::PandocTemplate.new(file_path)
-        enriched = template.render(nil, to: 'pdf')
-        WriteOps.safe_write(outpath, enriched)
-        ReleaseHx.logger.info("PDF generated via Tilt/Pandoc: #{outpath}")
-      else
-        raise "Unsupported format for Markdown: #{format}"
-      end
-
-      outpath
-    end
-    # rubocop:enable Lint/UnusedMethodArgument
-
-    # Converts AsciiDoc content or files to rich-text formats using Asciidoctor.
+    # Accepts either file paths or raw content strings as input. Selects appropriate
+    # converter engine based on config.conversions.engines.html/pdf settings with intelligent defaults:
+    # - AsciiDoc → HTML: asciidoctor-html5s (default)
+    # - AsciiDoc → PDF: asciidoctor-pdf (default)
     #
-    # Accepts either file paths or raw content strings as input. Uses Asciidoctor
-    # for HTML generation and Asciidoctor-PDF for direct PDF output.
+    # HTML output can be wrapped with Bootstrap CSS when config.modes.html_wrap is enabled.
     #
     # @param file_path_or_content [String] File path or raw AsciiDoc content.
     # @param format [Symbol] The target output format (:html or :pdf).
     # @param outpath [String] The target output file path.
-    # @param config [ReleaseHx::Configuration] Reserved for future use.
-    # @param force [Boolean] Reserved for future use.
+    # @param config [ReleaseHx::Configuration] Configuration for engines and wrapping options.
+    # @param force [Boolean] Whether to overwrite existing files.
     # @return [String] The path to the generated output file.
-    # rubocop:disable Lint/UnusedMethodArgument
     def self.convert_asciidoc file_path_or_content, format:, outpath:, config: nil, force: nil
-      # NOTE: config and force parameters are currently unused but kept for API consistency
       # Determine if input is file path or raw content
       is_file = file_path_or_content.is_a?(String) && File.exist?(file_path_or_content)
       content = is_file ? File.read(file_path_or_content) : file_path_or_content
 
       case format.to_sym
       when :html
-        require 'asciidoctor'
-        enriched = Asciidoctor.convert(content, safe: :safe, backend: 'html5')
+        engine = resolve_engine(format: :html, source_format: :asciidoc, config: config)
+        html_fragment = convert_with_engine(content, engine: engine, format: :html)
+
+        # Wrap HTML with Bootstrap styling if enabled
+        enriched = if config && config.dig('modes', 'html_wrap') != false
+                     ReleaseHx.logger.debug('Applying wrapper to AsciiDoc-derived HTML')
+                     wrap_html(html_fragment, config)
+                   else
+                     html_fragment
+                   end
       when :pdf
-        require 'asciidoctor'
-        require 'asciidoctor-pdf'
-        Asciidoctor.convert(content, to_file: outpath, safe: :safe, backend: 'pdf')
+        engine = resolve_engine(format: :pdf, source_format: :asciidoc, config: config)
+        convert_with_engine(content, engine: engine, format: :pdf, outpath: outpath)
         return outpath
       else
         raise "Unsupported format for AsciiDoc: #{format}"
@@ -163,7 +140,6 @@ module ReleaseHx
       WriteOps.safe_write(outpath, enriched)
       outpath
     end
-    # rubocop:enable Lint/UnusedMethodArgument
 
     # Loads RHYML data from a YAML file and creates a Release object.
     #
@@ -217,5 +193,135 @@ module ReleaseHx
       filename = SchemaGraphy::Templating.render_field_if_template(filename_template, context)
       File.join(output_dir, enrich_dir, filename.strip)
     end
+
+    # Wraps an HTML fragment with Bootstrap CSS and semantic HTML structure.
+    #
+    # Takes a raw HTML fragment and wraps it with proper DOCTYPE, head section with Bootstrap CDN link, and body tag.
+    # Uses the wrapper.html.liquid template for markup generation.
+    #
+    # @param html_fragment [String] The raw HTML content to wrap.
+    # @param config [ReleaseHx::Configuration] Configuration object for title and settings.
+    # @return [String] Complete HTML document with Bootstrap styling.
+    def self.wrap_html html_fragment, config
+      # Extract and parse framework setting
+      framework_spec = config.dig('history', 'html_framework') || 'bare'
+      framework_name, framework_version = parse_framework_spec(framework_spec)
+
+      template_path = WriteOps.resolve_template_path('wrapper.html.liquid', config)
+
+      template_vars = {
+        'config' => config,
+        'content' => html_fragment,
+        'framework' => framework_name,
+        'framework_version' => framework_version
+      }
+
+      WriteOps.process_template(template_path, template_vars, config)
+    end
+
+    # Parses framework specification string into name and version.
+    #
+    # @param spec [String] Framework specification like 'bootstrap5' or 'bootstrap:5.3.0'
+    # @return [Array<String, String>] Tuple of [framework_name, framework_version]
+    def self.parse_framework_spec spec
+      case spec.to_s
+      when /^(.+):(.+)$/
+        # Format: "bootstrap:5.3.0"
+        [::Regexp.last_match(1), ::Regexp.last_match(2)]
+      when 'bootstrap5'
+        ['bootstrap', '5.3.0']
+      when 'bootstrap4'
+        ['bootstrap', '4.6.2']
+      else
+        ['bare', nil]
+      end
+    end
+
+    # Resolves the appropriate conversion engine based on format and source.
+    #
+    # Applies intelligent defaults based on source format:
+    # - AsciiDoc → HTML: asciidoctor-html5s
+    # - AsciiDoc → PDF: asciidoctor-pdf
+    # - Markdown → HTML: kramdown
+    # - Markdown → PDF: pandoc
+    #
+    # @param format [Symbol] Output format (:html or :pdf)
+    # @param source_format [Symbol] Source format (:asciidoc or :markdown)
+    # @param config [Hash] Configuration hash
+    # @return [String] Engine name
+    def self.resolve_engine format:, source_format:, config: nil
+      # Check for explicit engine configuration
+      explicit_engine = config&.dig('conversions', 'engines', format.to_s)
+      return explicit_engine if explicit_engine
+
+      # Apply intelligent defaults based on source format
+      case [source_format, format]
+      when %i[asciidoc html]
+        'asciidoctor-html5s'
+      when %i[asciidoc pdf]
+        'asciidoctor-pdf'
+      when %i[markdown html]
+        'kramdown'
+      when %i[markdown pdf]
+        'pandoc'
+      else
+        raise "Unsupported conversion: #{source_format} → #{format}"
+      end
+    end
+
+    # Converts content using the specified engine.
+    #
+    # @param content [String] Source content to convert
+    # @param engine [String] Engine name (e.g., 'asciidoctor-html5s', 'asciidoctor-pdf')
+    # @param format [Symbol] Output format (:html or :pdf)
+    # @param outpath [String, nil] Output file path (required for PDF)
+    # @return [String] Converted content (for HTML) or output path (for PDF)
+    # rubocop:disable Lint/UnusedMethodArgument
+    def self.convert_with_engine content, engine:, format:, outpath: nil
+      case engine
+      when 'asciidoctor-html5', 'asciidoctor-html5s'
+        require 'asciidoctor'
+        backend = engine.split('-').last # 'html5' or 'html5s'
+
+        if backend == 'html5s'
+          begin
+            require 'asciidoctor-html5s'
+            ReleaseHx.logger.debug('Using asciidoctor-html5s backend for semantic HTML5')
+          rescue LoadError
+            ReleaseHx.logger.warn('asciidoctor-html5s not available, falling back to html5')
+            backend = 'html5'
+          end
+        end
+
+        Asciidoctor.convert(content, safe: :safe, backend: backend)
+
+      when 'asciidoctor-pdf'
+        require 'asciidoctor'
+        require 'asciidoctor-pdf'
+        ReleaseHx.logger.debug('Using asciidoctor-pdf for PDF generation')
+        Asciidoctor.convert(content, to_file: outpath, safe: :safe, backend: 'pdf')
+        outpath
+
+      when 'asciidoctor-web-pdf'
+        require 'asciidoctor'
+        require 'asciidoctor-web-pdf'
+        ReleaseHx.logger.debug('Using asciidoctor-web-pdf for PDF generation')
+        Asciidoctor.convert(content, to_file: outpath, safe: :safe, backend: 'web-pdf')
+        outpath
+
+      when 'kramdown'
+        require 'kramdown'
+        ReleaseHx.logger.debug('Using Kramdown for HTML conversion')
+        Kramdown::Document.new(content).to_html
+
+      when 'pandoc'
+        # Future implementation - would shell out to pandoc
+        raise 'Pandoc engine not yet implemented'
+
+      else
+        raise "Unsupported engine: #{engine}"
+      end
+    end
+    # rubocop:enable Lint/UnusedMethodArgument
   end
 end

data/lib/releasehx/ops/template_ops.rb

@@ -53,7 +53,7 @@ module ReleaseHx
           releasehx_debug: true
         })
 
-      raise "Template rendering failed:\n#{rendered}" if rendered.include?('Liquid error')
+      raise "Template rendering failed:\n#{rendered}" if rendered.match?(/Liquid error[:(]/)
 
       rendered
     end

data/lib/releasehx/rhyml/adapter.rb

@@ -6,9 +6,6 @@ require 'liquid'
 require 'erb'
 require 'yaml'
 require 'json'
-require_relative '../../schemagraphy'
-require_relative '../../schemagraphy/safe_expression'
-require_relative '../../sourcerer/jekyll'
 
 module ReleaseHx
   module RHYML

data/lib/releasehx/rhyml/templates/bootstrap-overrides.css

@@ -0,0 +1,15 @@
+/* Bootstrap Overrides for ReleaseHx */
+/* Users can override this file by placing bootstrap-overrides.css in their _templates directory */
+
+/* Dark Mode Fixes */
+@media (prefers-color-scheme: dark) {
+  /* Fix .bg-light in card headers - use semantic card background instead */
+  .card-header.bg-light {
+    background-color: var(--bs-card-cap-bg) !important;
+    border-bottom: var(--bs-card-border-width) solid var(--bs-card-border-color);
+  }
+}
+
+.container-lg {
+  max-width: 900px;
+}

data/lib/releasehx/rhyml/templates/changelog.adoc.liquid

@@ -11,4 +11,6 @@
 {%- assign item_count = 0 %}
 {%- embed section-text.liquid %}
 
+[.changelog-section]
+
 {%- embed groupings.liquid %}

data/lib/releasehx/rhyml/templates/changelog.html.liquid

@@ -4,11 +4,13 @@
 {%- assign dflt_next_header_level = level | plus: 1 -%}
 {%- assign item_count = 0 %}
 
-<div class="changelog-section">
-    {%- include header.liquid format=format level=level text=content_config.head %}
+<section class="changelog-section py-4 px-3 mb-4 rounded">
+  {%- include header.liquid format=format level=level text=content_config.head %}
 
-    {%- embed section-text.liquid %}
+  {%- embed section-text.liquid %}
 
+  <div class="changelog-content mt-4">
     {%- embed groupings.liquid %}
-</div>
+  </div>
+</section>
 

data/lib/releasehx/rhyml/templates/changelog.md.liquid

@@ -1,3 +1,4 @@
+<!-- .changelog-section -->
 {%- assign content_config = config.changelog %}
 {%- assign section_type = "changelog" %}
 {%- embed config-cascade.liquid %}

data/lib/releasehx/rhyml/templates/embedded.css.liquid

@@ -0,0 +1,263 @@
+/* ReleaseHx Embedded CSS - {{ theme | capitalize }} Theme */
+
+/* CSS Custom Properties - Theme: {{ theme }} */
+:root {
+  {%- if theme == 'compact' %}
+  --release-spacing: 1.5rem;
+  --section-spacing: 1rem;
+  --item-spacing: 0.5rem;
+  --container-padding: 1rem;
+  --heading-margin: 0.75rem;
+  {%- elsif theme == 'detailed' %}
+  --release-spacing: 4rem;
+  --section-spacing: 3rem;
+  --item-spacing: 1.5rem;
+  --container-padding: 3rem;
+  --heading-margin: 2rem;
+  {%- else %}
+  --release-spacing: 3rem;
+  --section-spacing: 2.5rem;
+  --item-spacing: 1rem;
+  --container-padding: 2rem;
+  --heading-margin: 1.5rem;
+  {%- endif %}
+  
+  /* Light Theme Colors */
+  --primary-color: #0d6efd;
+  --success-color: #198754;
+  --info-color: #0dcaf0;
+  --warning-color: #ffc107;
+  --danger-color: #dc3545;
+  --light-bg: #f8f9fa;
+  --white-bg: #ffffff;
+  --text-color: #212529;
+  --text-muted: #6c757d;
+  --border-color: #dee2e6;
+  --border-radius: 0.375rem;
+  --shadow: 0 1px 3px rgba(0, 0, 0, 0.05);
+  --shadow-hover: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+/* Dark Theme Colors */
+@media (prefers-color-scheme: dark) {
+  :root {
+    --primary-color: #6ea8fe;
+    --success-color: #75b798;
+    --info-color: #6edff6;
+    --warning-color: #ffda6a;
+    --danger-color: #ea868f;
+    --light-bg: #212529;
+    --white-bg: #2b3035;
+    --text-color: #ffffff;
+    --text-muted: #adb5bd;
+    --border-color: #495057;
+    --shadow: 0 1px 3px rgba(255, 255, 255, 0.1);
+    --shadow-hover: 0 2px 8px rgba(255, 255, 255, 0.15);
+  }
+}
+
+/* Manual Dark Theme Override */
+.dark-theme {
+  --primary-color: #6ea8fe;
+  --success-color: #75b798;
+  --info-color: #6edff6;
+  --warning-color: #ffda6a;
+  --danger-color: #ea868f;
+  --light-bg: #212529;
+  --white-bg: #2b3035;
+  --text-color: #ffffff;
+  --text-muted: #adb5bd;
+  --border-color: #495057;
+  --shadow: 0 1px 3px rgba(255, 255, 255, 0.1);
+  --shadow-hover: 0 2px 8px rgba(255, 255, 255, 0.15);
+}
+
+/* Base Styles */
+body {
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+  line-height: 1.6;
+  color: var(--text-color);
+  background-color: var(--light-bg);
+}
+
+/* Container and Layout */
+.release-history {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: var(--container-padding);
+}
+
+.release-section {
+  margin-bottom: var(--release-spacing);
+  padding: var(--container-padding);
+  background-color: var(--white-bg);
+  border-radius: var(--border-radius);
+  box-shadow: var(--shadow);
+}
+
+/* Section Styling */
+.changelog-section, .notes-section {
+  margin-bottom: var(--section-spacing);
+  padding: var(--container-padding);
+  border-radius: var(--border-radius);
+}
+
+.changelog-section {
+  border-left: 4px solid var(--success-color);
+  background-color: rgba(25, 135, 84, 0.02);
+}
+
+.notes-section {
+  border-left: 4px solid var(--info-color);
+  background-color: rgba(13, 202, 240, 0.02);
+}
+
+/* Release Notes */
+.release-note {
+  margin-bottom: var(--item-spacing);
+  transition: box-shadow 0.2s ease;
+  border: 1px solid var(--border-color);
+  border-radius: var(--border-radius);
+}
+
+.release-note:hover {
+  box-shadow: var(--shadow-hover);
+  border-color: var(--primary-color);
+}
+
+.card-header {
+  background-color: var(--light-bg);
+  border-bottom: 1px solid #dee2e6;
+  padding: 1rem 1.25rem;
+}
+
+.card-body {
+  padding: 1.25rem;
+}
+
+.card-footer {
+  background-color: var(--light-bg);
+  border-top: 1px solid #dee2e6;
+  padding: 0.75rem 1.25rem;
+}
+
+/* Changelog Entries */
+.change-entry {
+  margin-bottom: var(--item-spacing);
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--border-radius);
+  transition: all 0.15s ease;
+}
+
+.change-entry:hover {
+  background-color: var(--light-bg);
+  border-color: var(--primary-color);
+  transform: translateX(4px);
+}
+
+/* Typography */
+h1, h2, h3, h4, h5, h6 {
+  margin-bottom: var(--heading-margin);
+  line-height: 1.2;
+}
+
+{%- if theme == 'compact' %}
+h1 { font-size: 1.75rem; }
+h2 { font-size: 1.5rem; }
+h3 { font-size: 1.25rem; }
+{%- elsif theme == 'detailed' %}
+h1 { font-size: 3rem; }
+h2 { font-size: 2.5rem; }
+h3 { font-size: 2rem; }
+{%- endif %}
+
+/* Badges and Labels */
+.badge {
+  font-size: 0.75em;
+  padding: 0.35em 0.65em;
+  border-radius: 0.375rem;
+  font-weight: 600;
+}
+
+.badge-primary { background-color: var(--primary-color); color: white; }
+.badge-success { background-color: var(--success-color); color: white; }
+.badge-info { background-color: var(--info-color); color: white; }
+.badge-warning { background-color: var(--warning-color); color: black; }
+.badge-danger { background-color: var(--danger-color); color: white; }
+
+/* Metadata Display */
+.change-metadata {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  align-items: center;
+}
+
+.metadata-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+}
+
+/* Links */
+a {
+  color: var(--primary-color);
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .release-history {
+    padding: 1rem;
+  }
+  
+  .release-section {
+    padding: 1.5rem;
+  }
+  
+  .change-entry {
+    padding: 0.5rem 0.75rem;
+  }
+  
+  {%- if theme == 'detailed' %}
+  h1 { font-size: 2rem; }
+  h2 { font-size: 1.75rem; }
+  h3 { font-size: 1.5rem; }
+  {%- endif %}
+}
+
+/* Print Styles */
+@media print {
+  body {
+    background: white;
+    color: black;
+  }
+  
+  .release-section {
+    box-shadow: none;
+    border: 1px solid var(--border-color);
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+  
+  .release-note {
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+  
+  a {
+    color: black;
+    text-decoration: none;
+  }
+  
+  a:after {
+    content: " (" attr(href) ")";
+    font-size: 0.8em;
+    color: #666;
+  }
+}

data/lib/releasehx/rhyml/templates/entry.adoc.liquid

@@ -15,6 +15,7 @@
 {%- if frame == "ordered" %}
 [start={{ item_count }}]
 {%- endif %}
+[.change-entry]
 {{ bullet -}}
 {{ change.summ | trim }}
 {%- if change.note %} +

data/lib/releasehx/rhyml/templates/entry.html.liquid

@@ -1,4 +1,3 @@
-{%- embed metadata-entry.html.liquid -%}
 {%- assign frame = frame %}
 {%- case frame %}
 {%-   when "unordered" %}
@@ -10,29 +9,31 @@
 {%-     assign item_class = "list-group-item border-0 px-0" %}
 {%-     assign bullet = "" %}
 {%-   else %}
-{%-     assign list_class = "list-unstyled" %}
-{%-     assign item_class = "mb-2" %}
+{%-     assign list_class = "list-group" %}
+{%-     assign item_class = "list-group-item px-3 py-2" %}
 {%-     assign bullet = "" %}
 {%- endcase %}
 
 <div class="change-entry {{ item_class }}" id="entry-{{ change.chid }}">
-    <div class="d-flex align-items-start">
-        <div class="flex-grow-1">
-            <span class="change-summary">{{ bullet }}{{ change.summ | trim | pasterize }}</span>
-            {%- if change_metadata != "" -%}
-            <div class="change-metadata mt-1">
-                {{ change_metadata | trim }}
-            </div>
-            {%- endif %}
-        </div>
-        {%- if change.note %}
-        <div class="note-link">
-            <a href="#note-{{ change.chid }}" class="text-decoration-none">
-                <i class="fa fa-sticky-note-o"></i>
-                <small>NOTE</small>
-            </a>
-        </div>
-        {%- endif %}
+  <div class="d-flex align-items-start justify-content-between">
+    <div class="flex-grow-1">
+      <p class="change-summary mb-2">
+        <span class="text-body">{{ bullet }}{{ change.summ | trim | pasterize }}</span>
+      </p>
+      {%- if change_metadata != "" -%}
+      <div class="change-metadata">
+        {{ change_metadata | trim }}
+      </div>
+      {%- endif %}
+    </div>
+    {%- if change.note %}
+    <div class="note-link ms-3 ps-2 text-nowrap">
+      <a href="#note-{{ change.chid }}" class="badge bg-warning text-decoration-none" title="Has a release note">
+        <i class="fa fa-sticky-note-o"></i>
+        <small>NOTE</small>
+      </a>
     </div>
+    {%- endif %}
+  </div>
 </div>