sorbet-baml 0.1.0 → 0.3.0

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>

data/docs-site/src/_layouts/default.liquid

@@ -0,0 +1,27 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    {% render "head", title: title, description: description %}
+  </head>
+  <body class="bg-gray-50 min-h-screen">
+    {% render "nav" %}
+    
+    <main class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+      {{ content }}
+    </main>
+    
+    <footer class="bg-white border-t border-gray-200 mt-16">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+        <div class="text-center text-gray-600">
+          <p>&copy; 2025 <a href="mailto:hey@vicente.services" class="text-blue-600 hover:text-blue-800">Vicente Reig</a>. MIT License.</p>
+          <p class="mt-2">
+            <a href="https://github.com/vicentereig/sorbet-baml" class="text-blue-600 hover:text-blue-800">GitHub</a> •
+            <a href="https://rubygems.org/gems/sorbet-baml" class="text-blue-600 hover:text-blue-800">RubyGems</a>
+          </p>
+        </div>
+      </div>
+    </footer>
+    
+    <script src="{% asset_path js %}" defer></script>
+  </body>
+</html>

data/docs-site/src/_layouts/doc.liquid

@@ -0,0 +1,39 @@
+---
+layout: default
+---
+
+<div class="lg:grid lg:grid-cols-4 lg:gap-8">
+  <!-- Sidebar navigation -->
+  <div class="lg:col-span-1">
+    <div class="sticky top-20">
+      <nav class="space-y-1">
+        <h3 class="text-lg font-semibold text-gray-900 mb-4">Documentation</h3>
+        <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>
+      </nav>
+    </div>
+  </div>
+  
+  <!-- Main content -->
+  <div class="lg:col-span-3 mt-8 lg:mt-0">
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-8">
+      {% if title %}
+        <h1 class="text-3xl font-bold text-gray-900 mb-6">{{ title }}</h1>
+      {% endif %}
+      
+      <div class="prose prose-lg max-w-none">
+        {{ content }}
+      </div>
+    </div>
+  </div>
+</div>