sorbet-baml 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6ebc9d978b525e29a1a19ef184f073393d6a588e54d84dc2b9fd7034d1fa40c
-  data.tar.gz: f7d5e028fe65a4a4cc9b19c60dc17dd65fd13353634e55201db5189bb457447a
+  metadata.gz: eb876085f297285bbd07f7fd02c272417eade6ee6a33bd23632652746b1261d3
+  data.tar.gz: 8053e7074130ab128679fbc7a6c88d97fd2f3aaafb5c1637ab98271025fcdf69
 SHA512:
-  metadata.gz: 40b4736cc561b5135ee32e08543148c018ea9963e016c6cbb66697cd346ff7cf30f7438d370853c045b40d062a47f38d7aaa1a9c6c8e92f8e7f6721b495966e0
-  data.tar.gz: 0caf0a19906655bbfae88723bbe5b38301601c1523c3cc3b8dc31a15bf6bdd02ceacb790cf0d4bddf718c1162ba51d7b0fcd08110578616cd7c7ac27272bcd42
+  metadata.gz: cb1ef5173f16930f836eac60d64ca3c3e7a98de3b1aed127012f46497b72c09fade60b34d55e9aee40e8966db3d38361706c6d9c5bdb31a1f4af7761501263c6
+  data.tar.gz: 695791bb1caee6b763437aa5f5d6688640f5792a482372eb08a5e3da74ce7a007aed166f130945b736bc47bc4030d50a24c38910b99543b5d1ea533538a31119

data/README.md

@@ -1,5 +1,10 @@
 # sorbet-baml
 
+[![Gem Version](https://img.shields.io/gem/v/sorbet-baml)](https://rubygems.org/gems/sorbet-baml)
+[![Total Downloads](https://img.shields.io/gem/dt/sorbet-baml)](https://rubygems.org/gems/sorbet-baml)
+[![License](https://img.shields.io/github/license/vicentereig/sorbet-baml)](https://github.com/vicentereig/sorbet-baml/blob/main/LICENSE.txt)
+[![Sorbet Compatible](https://img.shields.io/badge/Sorbet-compatible-blue)](https://sorbet.org)
+
 Ruby-idiomatic conversion from Sorbet types to BAML (Boundary AI Markup Language) for efficient LLM prompting.
 
 ## What is this?
@@ -193,6 +198,113 @@ ResearchSubtask.to_baml
 
 **Why descriptions matter**: LLMs use field descriptions to understand context and generate more accurate, meaningful data. This is crucial for complex domains where field names alone aren't sufficient.
 
+## 🛠️ Tool Type Definitions
+
+Generate BAML tool specifications for agentic workflows, function calling, and structured LLM interactions:
+
+### T::Struct-based Tools
+
+```ruby
+class ReplyTool < T::Struct
+  # The response message to send back to the user
+  const :response, String
+end
+
+class SearchTool < T::Struct
+  # The search query to execute
+  const :query, String
+  # Maximum number of results to return
+  const :limit, T.nilable(Integer)
+end
+
+# Generate BAML tool definitions
+ReplyTool.to_baml_tool
+# =>
+# class ReplyTool {
+#   response string @description("The response message to send back to the user")
+# }
+
+SearchTool.to_baml_tool
+# =>
+# class SearchTool {
+#   query string @description("The search query to execute")
+#   limit int? @description("Maximum number of results to return")
+# }
+
+# Module API also available
+SorbetBaml.from_tool(ReplyTool)
+```
+
+### DSPy-style Tools (Optional)
+
+When `dspy.rb` is available, automatically convert DSPy tools with rich metadata:
+
+```ruby
+class CalculatorTool < DSPy::Tools::Base
+  extend T::Sig
+  
+  tool_name 'calculator'
+  tool_description 'Performs basic arithmetic operations'
+
+  sig { params(operation: String, num1: Float, num2: Float).returns(T.any(Float, String)) }
+  def call(operation:, num1:, num2:)
+    case operation.downcase
+    when 'add' then num1 + num2
+    when 'subtract' then num1 - num2
+    when 'multiply' then num1 * num2
+    when 'divide'
+      return "Error: Cannot divide by zero" if num2 == 0
+      num1 / num2
+    else
+      "Error: Unknown operation '#{operation}'. Use add, subtract, multiply, or divide"
+    end
+  end
+end
+
+# Automatic extraction of tool metadata and parameter types
+CalculatorTool.to_baml
+# =>
+# // Performs basic arithmetic operations
+# class calculator {
+#   operation string @description("Parameter operation")
+#   num1 float @description("Parameter num1")
+#   num2 float @description("Parameter num2")
+# }
+
+# Optional parameters handled correctly
+class SearchTool < DSPy::Tools::Base
+  extend T::Sig
+  
+  tool_name 'search'
+  tool_description 'Search for information'
+
+  sig { params(query: String, limit: T.nilable(Integer)).returns(T::Array[String]) }
+  def call(query:, limit: nil)
+    # Implementation...
+  end
+end
+
+SearchTool.to_baml
+# =>
+# // Search for information
+# class search {
+#   query string @description("Parameter query")
+#   limit int? @description("Parameter limit (optional)")
+# }
+
+# Module API also available
+SorbetBaml.from_dspy_tool(CalculatorTool)
+```
+
+**Tool Features:**
+- ✅ **T::Struct tools**: Convert any struct to BAML tool definition
+- ✅ **DSPy integration**: Automatic extraction from DSPy::Tools::Base classes
+- ✅ **Parameter types**: Full Sorbet type support (string, int, float, arrays, maps, etc.)
+- ✅ **Optional parameters**: Automatically detect and mark with `?`
+- ✅ **Descriptions**: Extract from comments (T::Struct) or automatic generation (DSPy)
+- ✅ **Tool metadata**: Names, descriptions, and parameter documentation
+- ✅ **Ruby-idiomatic**: `.to_baml_tool()` and `.to_baml()` methods
+
 ## 🎯 Complete Type Support
 
 ### ✅ Fully Supported
@@ -222,6 +334,8 @@ ResearchSubtask.to_baml
 ### 🚀 Advanced Features
 
 - **Ruby-idiomatic API**: Every T::Struct and T::Enum gets `.to_baml` method
+- **Tool definitions**: Generate BAML tool specs for function calling and agentic workflows
+- **DSPy integration**: Automatic tool conversion from DSPy::Tools::Base classes
 - **Smart defaults**: Field descriptions and dependencies included automatically
 - **Field descriptions**: Extracts comments from source code for LLM context
 - **Dependency management**: Automatically includes all referenced types
@@ -249,21 +363,25 @@ ResearchSubtask.to_baml
 
 ## 🏁 Production Ready
 
-This gem has reached **feature completeness** for core BAML conversion needs. The Ruby-idiomatic API is stable and thoroughly tested with **50+ test cases** covering all type combinations and edge cases.
+This gem has reached **feature completeness** for core BAML conversion needs. The Ruby-idiomatic API is stable and thoroughly tested with **80+ test cases** covering all type combinations, tool definitions, and edge cases.
 
 ### 📊 Quality Metrics
 
 - ✅ **100% Test Coverage** - All features comprehensively tested
 - ✅ **Full Sorbet Type Safety** - Zero type errors throughout codebase  
-- ✅ **50+ Test Cases** - Covering basic types, complex combinations, and edge cases
+- ✅ **80+ Test Cases** - Covering basic types, complex combinations, tool definitions, and edge cases
 - ✅ **TDD Development** - All features built test-first
 - ✅ **Field Descriptions** - Automatic comment extraction for LLM context
+- ✅ **Tool Definitions** - BAML tool specifications for function calling and agentic workflows
+- ✅ **DSPy Integration** - Automatic tool conversion from DSPy::Tools::Base classes
 - ✅ **Smart Defaults** - Dependencies and descriptions included by default
 - ✅ **Zero Breaking Changes** - Maintains backward compatibility
 
 ### ✅ Complete Feature Set
 
 - ✅ **Ruby-idiomatic API**: Every T::Struct and T::Enum gets `.to_baml` method
+- ✅ **Tool definitions**: Generate BAML tool specifications from T::Struct classes
+- ✅ **DSPy integration**: Automatic tool conversion from DSPy::Tools::Base classes
 - ✅ **Smart defaults**: Field descriptions and dependencies included automatically
 - ✅ **Field descriptions**: Extract documentation from comments for LLM context
 - ✅ **Dependency management**: Automatically includes all referenced types
@@ -272,6 +390,7 @@ This gem has reached **feature completeness** for core BAML conversion needs. Th
 
 ### 🗺️ Future Enhancements (Optional)
 
+- [ ] **DSPy-independent tool API**: Tools shouldn't require DSPy, just follow the same API pattern
 - [ ] **Type aliases**: `T.type_alias { String }` → `type Alias = string`
 - [ ] **Custom naming**: Convert between snake_case ↔ camelCase
 - [ ] **CLI tool**: `sorbet-baml convert MyStruct` command
@@ -282,6 +401,8 @@ This gem has reached **feature completeness** for core BAML conversion needs. Th
 
 - **v0.0.1** - Initial implementation with basic type support
 - **v0.1.0** - Complete type system + Ruby-idiomatic API + field descriptions + smart defaults
+- **v0.2.0** - Description parameter support and enhanced field extraction
+- **v0.3.0** - Tool type definitions + DSPy integration + 80+ test cases + comprehensive documentation
 
 ## 🌟 Real-World Usage: Autonomous Research Agents
 

data/Rakefile

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 

data/docs-site/.gitignore

@@ -0,0 +1,48 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Build outputs
+output/
+dist/
+
+# Cache directories
+.bridgetown-cache/
+.tmp/
+
+# Environment files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# System files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Log files
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Package lock files (keep only one)
+package-lock.json
+
+# Ruby
+.bundle/
+vendor/bundle

data/docs-site/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+gem 'bridgetown', '~> 1.3.4'
+gem 'puma', '< 7'

data/docs-site/Gemfile.lock

@@ -0,0 +1,140 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (7.2.2.2)
+      activesupport (= 7.2.2.2)
+    activesupport (7.2.2.2)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    amazing_print (1.8.1)
+    base64 (0.3.0)
+    benchmark (0.4.1)
+    bigdecimal (3.2.2)
+    bridgetown (1.3.4)
+      bridgetown-builder (= 1.3.4)
+      bridgetown-core (= 1.3.4)
+      bridgetown-paginate (= 1.3.4)
+    bridgetown-builder (1.3.4)
+      bridgetown-core (= 1.3.4)
+    bridgetown-core (1.3.4)
+      activemodel (>= 6.0, < 8.0)
+      activesupport (>= 6.0, < 8.0)
+      addressable (~> 2.4)
+      amazing_print (~> 1.2)
+      colorator (~> 1.0)
+      csv (~> 3.2)
+      erubi (~> 1.9)
+      faraday (~> 2.0)
+      faraday-follow_redirects (~> 0.3)
+      hash_with_dot_access (~> 1.2)
+      i18n (~> 1.0)
+      kramdown (~> 2.1)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (>= 5.0, < 5.5)
+      listen (~> 3.0)
+      rake (>= 13.0)
+      roda (~> 3.46)
+      rouge (>= 3.0, < 5.0)
+      serbea (~> 1.0)
+      thor (~> 1.1)
+      tilt (~> 2.0)
+      zeitwerk (~> 2.5)
+    bridgetown-paginate (1.3.4)
+      bridgetown-core (= 1.3.4)
+    colorator (1.1.0)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.3)
+    csv (3.3.5)
+    drb (2.2.3)
+    erubi (1.13.1)
+    faraday (2.13.4)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-follow_redirects (0.3.0)
+      faraday (>= 1, < 3)
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
+    ffi (1.17.2)
+    ffi (1.17.2-aarch64-linux-gnu)
+    ffi (1.17.2-aarch64-linux-musl)
+    ffi (1.17.2-arm-linux-gnu)
+    ffi (1.17.2-arm-linux-musl)
+    ffi (1.17.2-arm64-darwin)
+    ffi (1.17.2-x86-linux-gnu)
+    ffi (1.17.2-x86-linux-musl)
+    ffi (1.17.2-x86_64-darwin)
+    ffi (1.17.2-x86_64-linux-gnu)
+    ffi (1.17.2-x86_64-linux-musl)
+    hash_with_dot_access (1.2.0)
+      activesupport (>= 5.0.0, < 8.0)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.13.2)
+    kramdown (2.5.1)
+      rexml (>= 3.3.9)
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    liquid (5.4.0)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.7.0)
+    minitest (5.25.5)
+    net-http (0.6.0)
+      uri
+    nio4r (2.7.4)
+    public_suffix (6.0.2)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    rack (3.2.0)
+    rake (13.3.0)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    rexml (3.4.1)
+    roda (3.95.0)
+      rack
+    rouge (4.6.0)
+    securerandom (0.4.1)
+    serbea (1.0.1)
+      activesupport (>= 6.0)
+      erubi (>= 1.10)
+      tilt (~> 2.0)
+    thor (1.4.0)
+    tilt (2.6.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.0.3)
+    zeitwerk (2.7.3)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  ruby
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  bridgetown (~> 1.3.4)
+  puma (< 7)
+
+BUNDLED WITH
+   2.6.9

data/docs-site/Rakefile

@@ -0,0 +1,3 @@
+require 'bridgetown'
+
+Bridgetown.load_tasks

data/docs-site/bridgetown.config.yml

@@ -0,0 +1,15 @@
+# Welcome to Bridgetown!
+#
+# This config file is for settings that affect your whole site, values
+# which you are expected to set up once and rarely edit after that.
+
+url: "https://vicentereig.github.io"
+base_path: "/sorbet-baml"
+
+permalink: "/:title/"
+template_engine: liquid
+
+# Meta information
+title: "sorbet-baml"
+description: "Ruby-idiomatic conversion from Sorbet types to BAML for efficient LLM prompting"
+author: "Vicente Reig"

data/docs-site/config/initializers.rb

@@ -0,0 +1,9 @@
+# Bridgetown Configuration
+
+# Add frontend asset configurations
+Bridgetown.configure do |config|
+  # Configure esbuild
+  config.frontend_bundling_path = 'output'
+
+  # Other configurations can go here
+end

data/docs-site/config/puma.rb

@@ -0,0 +1,9 @@
+if ENV['BRIDGETOWN_ENV'] == 'production'
+  bind "tcp://0.0.0.0:#{ENV.fetch('PORT', 4000)}"
+else
+  bind "tcp://127.0.0.1:#{ENV.fetch('PORT', 4000)}"
+end
+
+environment ENV.fetch('BRIDGETOWN_ENV', 'development')
+
+plugin :tmp_restart

data/docs-site/config.ru

@@ -0,0 +1,5 @@
+require 'bridgetown-core/rack/boot'
+
+Bridgetown::Rack.boot
+
+run RodaApp.freeze.app

data/docs-site/esbuild.config.js

@@ -0,0 +1,11 @@
+const esbuildOptions = {
+  target: "es2020",
+  minify: process.argv.includes("--minify"),
+  bundle: true,
+  entryPoints: ["frontend/javascript/index.js"],
+  outdir: "output/_bridgetown/static",
+  entryNames: "index.[hash]",
+  publicPath: "/sorbet-baml/_bridgetown/static",
+}
+
+module.exports = esbuildOptions

data/docs-site/frontend/javascript/index.js

@@ -0,0 +1,22 @@
+import "../styles/index.css"
+import Plausible from 'plausible-tracker'
+
+// Initialize Plausible Analytics
+const plausible = Plausible({
+  domain: 'vicentereig.github.io'
+})
+
+// Track page views automatically
+plausible.trackPageview()
+
+// Mobile menu toggle
+document.addEventListener('DOMContentLoaded', function() {
+  const mobileMenuButton = document.getElementById('mobile-menu-button');
+  const mobileMenu = document.getElementById('mobile-menu');
+  
+  if (mobileMenuButton && mobileMenu) {
+    mobileMenuButton.addEventListener('click', function() {
+      mobileMenu.classList.toggle('hidden');
+    });
+  }
+});

data/docs-site/frontend/styles/index.css

@@ -0,0 +1,61 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  html {
+    font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  }
+  
+  body {
+    line-height: 1.6;
+    color: #374151;
+  }
+  
+  h1, h2, h3, h4, h5, h6 {
+    font-weight: 600;
+    line-height: 1.25;
+  }
+}
+
+@layer components {
+  .nav-link {
+    @apply block px-3 py-2 text-gray-700 hover:text-blue-600 hover:bg-blue-50 rounded-md transition-colors;
+  }
+  
+  .nav-link.active {
+    @apply text-blue-600 bg-blue-50;
+  }
+  
+  .code-block {
+    @apply bg-gray-900 text-gray-100 p-4 rounded-lg overflow-x-auto;
+  }
+  
+  .prose code {
+    @apply text-sm;
+  }
+  
+  .prose pre {
+    @apply bg-gray-900 text-gray-100;
+  }
+  
+  .prose pre code {
+    @apply text-gray-100;
+  }
+}
+
+/* Syntax highlighting */
+.highlight {
+  @apply rounded-lg;
+}
+
+.highlight pre {
+  @apply m-0 p-4 bg-gray-900 text-gray-100 overflow-x-auto;
+}
+
+.highlight .k { color: #c678dd; } /* Keyword */
+.highlight .s { color: #98c379; } /* String */
+.highlight .c { color: #5c6370; } /* Comment */
+.highlight .n { color: #e06c75; } /* Name */
+.highlight .nb { color: #61afef; } /* Builtin */
+.highlight .nf { color: #61afef; } /* Function */

data/docs-site/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "sorbet-baml-docs",
+  "private": true,
+  "scripts": {
+    "dev": "bridgetown start",
+    "build": "bridgetown build"
+  },
+  "devDependencies": {
+    "@tailwindcss/typography": "^0.5.0",
+    "autoprefixer": "^10.4.0",
+    "esbuild": "^0.19.0",
+    "postcss": "^8.4.0",
+    "tailwindcss": "^3.3.0"
+  },
+  "dependencies": {
+    "plausible-tracker": "^0.3.9"
+  }
+}

data/docs-site/postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

data/docs-site/server/roda_app.rb

@@ -0,0 +1,9 @@
+class RodaApp < Bridgetown::Rack::Roda
+  route do |r|
+    # Handle static assets first
+    r.public
+
+    # Handle Bridgetown routes
+    r.bridgetown
+  end
+end

data/docs-site/src/_components/head.liquid

@@ -0,0 +1,26 @@
+<title>{% if title %}{{ title }} | {% endif %}{{ site.title }}</title>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<meta name="description" content="{% if description %}{{ description }}{% else %}{{ site.description }}{% endif %}" />
+<meta name="author" content="{{ site.author }}" />
+
+<!-- Open Graph tags -->
+<meta property="og:title" content="{% if title %}{{ title }} | {% endif %}{{ site.title }}" />
+<meta property="og:description" content="{% if description %}{{ description }}{% else %}{{ site.description }}{% endif %}" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="{{ site.url }}{{ site.base_path }}{{ page.url }}" />
+<meta property="og:site_name" content="{{ site.title }}" />
+
+<!-- Twitter Card tags -->
+<meta name="twitter:card" content="summary" />
+<meta name="twitter:title" content="{% if title %}{{ title }} | {% endif %}{{ site.title }}" />
+<meta name="twitter:description" content="{% if description %}{{ description }}{% else %}{{ site.description }}{% endif %}" />
+
+<!-- Links -->
+<link rel="canonical" href="{{ site.url }}{{ site.base_path }}{{ page.url }}" />
+
+{% if site.base_path %}
+<link rel="stylesheet" href="{{ site.base_path }}/_bridgetown/static/index.QMORYXZK.css">
+{% else %}
+<link rel="stylesheet" href="/_bridgetown/static/index.QMORYXZK.css">
+{% endif %}

data/docs-site/src/_components/nav.liquid

@@ -0,0 +1,68 @@
+<nav class="bg-white border-b border-gray-200 sticky top-0 z-50">
+  <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+    <div class="flex justify-between h-16">
+      <div class="flex items-center">
+        <a href="{{ '/' | relative_url }}" class="flex items-center">
+          <span class="text-xl font-bold text-gray-900">sorbet-baml</span>
+        </a>
+      </div>
+      
+      <!-- Desktop navigation -->
+      <div class="hidden md:flex items-center space-x-8">
+        <a href="{{ '/' | relative_url }}" class="nav-link {% if page.url == '/' %}active{% endif %}">
+          Home
+        </a>
+        <a href="{{ '/getting-started/' | relative_url }}" class="nav-link {% if page.url contains 'getting-started' %}active{% endif %}">
+          Getting Started
+        </a>
+        <a href="{{ '/type-mapping/' | relative_url }}" class="nav-link {% if page.url contains 'type-mapping' %}active{% endif %}">
+          Type Mapping
+        </a>
+        <a href="{{ '/advanced-usage/' | relative_url }}" class="nav-link {% if page.url contains 'advanced-usage' %}active{% endif %}">
+          Advanced Usage
+        </a>
+        <a href="{{ '/troubleshooting/' | relative_url }}" class="nav-link {% if page.url contains 'troubleshooting' %}active{% endif %}">
+          Troubleshooting
+        </a>
+        <a href="https://github.com/vicentereig/sorbet-baml" class="text-gray-500 hover:text-gray-700 p-1" target="_blank" rel="noopener" title="GitHub Repository">
+          <svg style="width: 16px; height: 16px;" fill="currentColor" viewBox="0 0 20 20" aria-hidden="true">
+            <path fill-rule="evenodd" d="M10 0C4.477 0 0 4.484 0 10.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0110 4.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.203 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.942.359.31.678.921.678 1.856 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0020 10.017C20 4.484 15.522 0 10 0z" clip-rule="evenodd"></path>
+          </svg>
+        </a>
+      </div>
+      
+      <!-- Mobile menu button -->
+      <div class="md:hidden flex items-center">
+        <button type="button" class="text-gray-500 hover:text-gray-700 focus:outline-none focus:text-gray-700" id="mobile-menu-button">
+          <svg class="h-6 w-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16" />
+          </svg>
+        </button>
+      </div>
+    </div>
+  </div>
+  
+  <!-- Mobile menu -->
+  <div class="md:hidden hidden" id="mobile-menu">
+    <div class="px-2 pt-2 pb-3 space-y-1 sm:px-3 bg-white border-t border-gray-200">
+      <a href="{{ '/' | relative_url }}" class="nav-link {% if page.url == '/' %}active{% endif %}">
+        Home
+      </a>
+      <a href="{{ '/getting-started/' | relative_url }}" class="nav-link {% if page.url contains 'getting-started' %}active{% endif %}">
+        Getting Started
+      </a>
+      <a href="{{ '/type-mapping/' | relative_url }}" class="nav-link {% if page.url contains 'type-mapping' %}active{% endif %}">
+        Type Mapping
+      </a>
+      <a href="{{ '/advanced-usage/' | relative_url }}" class="nav-link {% if page.url contains 'advanced-usage' %}active{% endif %}">
+        Advanced Usage
+      </a>
+      <a href="{{ '/troubleshooting/' | relative_url }}" class="nav-link {% if page.url contains 'troubleshooting' %}active{% endif %}">
+        Troubleshooting
+      </a>
+      <a href="https://github.com/vicentereig/sorbet-baml" class="nav-link" target="_blank" rel="noopener">
+        GitHub
+      </a>
+    </div>
+  </div>
+</nav>