wytch 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 662c7632994e850e71fce70842f153b11d7e56f8877df6156094c070213a68a6
-  data.tar.gz: 546b863eb417cd7ada91d725a1def5662aae4182e9c53762ab98758c574f103b
+  metadata.gz: 7aa017b3a2d6ed1b64cde7b4a73f312222d64a630a365ad71db68f4babc28ce5
+  data.tar.gz: fba837a626f3c4dfcc3525d03127ada6b62b30b367e31da4c5eef3721c7b264a
 SHA512:
-  metadata.gz: 9a8a7bc87f19981aa54f33132f5cb5e9adf7799c380187f2b5db8a0756feab7f2c6e158eeaeeaef2d6bccb95188f8ff5e561e66b5bf4c8dda70df56859f8c137
-  data.tar.gz: ac6aae6cf98f82c74dd1b11ba1d814d03cbbb9b9ab85c6c2f738fc300632ff99602c571e436554e58b11aa7d47fb94c99f9532e41eb77116ccd7fe37a9a56dca
+  metadata.gz: b70258ec6436a644dee4ecb637dc0bcad929428c7803d4272b7eef34b8bb0620b024c683a2a77f41e1235c05f5c1713b188a374bc7d050bb77a571bd924db7f0
+  data.tar.gz: 98a84928a3cf7bd5aff50e99225d6b944da43ca69a44c2bb94a10ee8bc5ba424365ca228378f2f2472757b25632f86b7b5bea0aaa458e075100e2b96f1f87985

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 ## [Unreleased]
 
+## [0.3.0] - 2025-12-7
+
+- Add YARD documentation to all classes and methods
+- Add UTF-8 charset meta tag to generated site layouts
+- Fix index page building to `build/index.html` instead of `build/index/index.html`
+- Update CLI output to reflect single-command build process
+
+## [0.2.0] - 2025-12-7
+
+- Add Vite integration for asset pipeline (CSS, ReScript)
+- Add blog scaffolding with posts, sitemap, and Atom feed
+- Add Layout component for consistent page structure
+- `wytch build` now automatically runs `npm run build` for assets
+- Add static file serving from `public/` directory
+- Add hot-reloading for site code and content during development
+- Add documentation (README usage guide)
+
 ## [0.1.0] - 2025-10-29
 
 - Initial release

data/lib/wytch/builder.rb

@@ -3,9 +3,29 @@
 require "fileutils"
 
 module Wytch
+  # Builds the static site by rendering all pages to the output directory.
+  #
+  # The Builder is responsible for the production build process:
+  # 1. Loading site configuration and content
+  # 2. Rendering each page to HTML
+  # 3. Copying static files from public/
+  # 4. Integrating Vite-built assets
+  #
+  # @example Building via CLI
+  #   $ wytch build
+  #
+  # @example Building programmatically
+  #   Wytch::Builder.new.build
   class Builder
+    # @return [String] the output directory for built files
     OUTPUT_DIR = "build"
 
+    # Builds the entire site.
+    #
+    # Sets RACK_ENV to "production", loads the site configuration,
+    # renders all pages to HTML files, and copies static assets.
+    #
+    # @return [void]
     def build
       ENV["RACK_ENV"] = "production"
       Site.load!
@@ -31,12 +51,19 @@ module Wytch
 
     private
 
+    # Copies files from public/ to the output directory.
+    #
+    # @return [void]
     def copy_public_files
       return unless Dir.exist?("public")
 
       FileUtils.cp_r "public/.", OUTPUT_DIR, verbose: true
     end
 
+    # Reports on Vite assets in the output directory.
+    # Vite builds directly to build/assets, so no copying is needed.
+    #
+    # @return [void]
     def copy_vite_assets
       vite_output = File.join(OUTPUT_DIR, "assets")
       return unless Dir.exist?(vite_output)

data/lib/wytch/cli.rb

@@ -3,15 +3,36 @@
 require "thor"
 
 module Wytch
+  # Command-line interface for Wytch.
+  #
+  # Provides commands for creating, developing, and building Wytch sites.
+  #
+  # @example
+  #   $ wytch new my-site     # Create a new site
+  #   $ wytch server          # Start development server
+  #   $ wytch build           # Build for production
   class CLI < Thor
     include Thor::Actions
 
+    # Returns the path to template files used by the generator.
+    #
+    # @return [String] path to templates directory
     def self.source_root
       File.expand_path("templates", __dir__)
     end
 
     desc "new NAME", "Create a new Wytch site"
     method_option :local, type: :boolean, default: false, desc: "Use local Wytch gem for development"
+    # Creates a new Wytch site with the given name.
+    #
+    # Generates a complete site structure including:
+    # - Configuration files (Gemfile, config.rb, package.json, etc.)
+    # - Content directory with sample pages
+    # - Source directory with views and layouts
+    # - Asset pipeline setup (Vite, ReScript, Tailwind)
+    #
+    # @param name [String] the name/directory for the new site
+    # @return [void]
     def new(name)
       @local_wytch_path = File.expand_path("../..", __dir__) if options[:local]
 
@@ -68,18 +89,26 @@ module Wytch
       say "  npm run dev       # Start Vite dev server (Terminal 1)"
       say "  wytch server      # Start Wytch dev server (Terminal 2)"
       say "\nTo build for production:"
-      say "  npm run build     # Build assets with Vite"
-      say "  wytch build       # Build static site"
+      say "  wytch build       # Build assets and static site to build/"
     end
 
     desc "server", "Start a development server"
     method_option :port, type: :numeric, default: 6969, aliases: "-p", desc: "Port to run the server on"
     method_option :host, type: :string, default: "localhost", aliases: "-h", desc: "Host to bind the server to"
+    # Starts the development server with hot reloading.
+    #
+    # @return [void]
     def server
       Server.new(options).start
     end
 
     desc "build", "Build the static site"
+    # Builds the site for production.
+    #
+    # First runs `npm run build` to compile assets with Vite,
+    # then renders all pages to static HTML in the build/ directory.
+    #
+    # @return [void]
     def build
       system("npm run build") || abort("Asset build failed")
       Builder.new.build
@@ -87,6 +116,10 @@ module Wytch
 
     private
 
+    # Converts a snake_case name to PascalCase.
+    #
+    # @param name [String] the name to classify
+    # @return [String] the PascalCase version
     def classify(name)
       name.split("_").map(&:capitalize).join
     end

data/lib/wytch/content_loader.rb

@@ -1,7 +1,21 @@
 # frozen_string_literal: true
 
 module Wytch
+  # Discovers and loads content files into Page objects.
+  #
+  # The ContentLoader scans the content directory for Ruby files and
+  # instantiates Page objects for each one. It uses the configured
+  # page_class from the Site.
+  #
+  # @see Wytch::Site#content_dir
+  # @see Wytch::Site#page_class
   class ContentLoader
+    # Loads all content files and returns a hash of pages.
+    #
+    # Scans the content directory recursively for .rb files,
+    # creates a Page instance for each, and returns them keyed by path.
+    #
+    # @return [Hash{String => Page}] pages keyed by their URL path
     def load_content
       pages = {}
 
@@ -15,14 +29,24 @@ module Wytch
 
     private
 
+    # Creates a Page instance from a content file.
+    #
+    # @param file_path [String] path to the content file, relative to content_dir
+    # @return [Page] the loaded page
     def load_page(file_path)
       page_class.new(file_path:)
     end
 
+    # Returns the configured page class.
+    #
+    # @return [Class] the page class to instantiate
     def page_class
       Object.const_get(Wytch.site.page_class)
     end
 
+    # Returns the content directory path.
+    #
+    # @return [String] the content directory
     def content_dir
       Wytch.site.content_dir
     end

data/lib/wytch/once.rb

@@ -1,12 +1,32 @@
 # frozen_string_literal: true
 
 module Wytch
+  # A thread-safe utility for executing a block exactly once.
+  #
+  # Once ensures that a given block of code is executed only one time,
+  # even when called from multiple threads. After the first execution,
+  # subsequent calls are no-ops.
+  #
+  # @example
+  #   setup = Once.new { puts "Initializing..." }
+  #   setup.call  # prints "Initializing..."
+  #   setup.call  # does nothing
+  #   setup.call  # does nothing
   class Once
+    # Creates a new Once instance with the given block.
+    #
+    # @yield the block to execute once
     def initialize(&block)
       @block = block
       @mutex = Mutex.new
     end
 
+    # Executes the block if it hasn't been executed yet.
+    #
+    # Thread-safe: if multiple threads call this simultaneously,
+    # only one will execute the block.
+    #
+    # @return [void]
     def call
       @mutex&.synchronize do
         return unless @mutex

data/lib/wytch/page.rb

@@ -1,7 +1,33 @@
 # frozen_string_literal: true
 
 module Wytch
+  # Represents a single page in a Wytch site.
+  #
+  # Pages are defined by Ruby content files in the content directory. Each content
+  # file is evaluated in the context of a Page instance, allowing it to set metadata
+  # and configure the view class.
+  #
+  # @example A typical content file (content/about.rb)
+  #   view MySite::AboutView
+  #   add MySite::PageHelpers
+  #
+  #   @metadata[:title] = "About Us"
+  #   @metadata[:description] = "Learn more about our company"
+  #
+  # @example Accessing page data in a view
+  #   class MySite::AboutView < Phlex::HTML
+  #     def initialize(page)
+  #       @page = page
+  #     end
+  #
+  #     def view_template
+  #       h1 { @page.metadata[:title] }
+  #     end
+  #   end
   class Page
+    # Creates a new page by loading and evaluating a content file.
+    #
+    # @param file_path [String] path to the content file, relative to the content directory
     def initialize(file_path:)
       @file_path = file_path
       @metadata = {}
@@ -12,12 +38,19 @@ module Wytch
       instance_eval File.read(source_path), source_path
     end
 
+    # @return [Hash] arbitrary metadata set by the content file
     attr_reader :metadata
 
+    # Renders the page using its configured view class.
+    #
+    # @return [String] the rendered HTML
     def render
       @view_class.new(self).call
     end
 
+    # Returns the URL path for this page.
+    #
+    # @return [String] the URL path (e.g., "/" for index, "/about" for about.rb)
     def path
       if virtual_path == "index"
         "/"
@@ -26,34 +59,76 @@ module Wytch
       end
     end
 
+    # Returns the virtual path derived from the file path.
+    #
+    # @return [String] the path without directory prefix or .rb suffix
     def virtual_path
       @file_path.delete_prefix("#{Wytch.site.content_dir}/").delete_suffix(".rb")
     end
 
+    # Returns the output file path for the built page.
+    #
+    # @return [String] the build path (e.g., "about/index.html")
     def build_path
-      "#{virtual_path}/index.html"
+      if virtual_path == "index"
+        "index.html"
+      else
+        "#{virtual_path}/index.html"
+      end
     end
 
+    # Extends this page instance with a helper module.
+    # Called from content files to add helper methods.
+    #
+    # @param helper_module [Module] the module to extend this page with
+    # @return [void]
+    #
+    # @example
+    #   add MySite::PostHelpers
     def add(helper_module)
       extend helper_module
     end
 
+    # Sets the view class for rendering this page.
+    # Called from content files to specify which Phlex view to use.
+    #
+    # @param view_class [Class] a Phlex view class that accepts the page in its initializer
+    # @return [void]
+    #
+    # @example
+    #   view MySite::PostView
     def view(view_class)
       @view_class = view_class
     end
 
+    # Whether this page should be included in the sitemap.
+    # Override in subclasses to exclude pages.
+    #
+    # @return [Boolean] true by default
     def include_in_sitemap?
       true
     end
 
+    # The last modification date for sitemap generation.
+    # Override in subclasses to provide actual dates.
+    #
+    # @return [Date, Time, nil] the last modified date, or nil if unknown
     def last_modified
       nil
     end
 
+    # The change frequency hint for sitemap generation.
+    # Override in subclasses to provide hints like "daily", "weekly", etc.
+    #
+    # @return [String, nil] the change frequency, or nil if unknown
     def change_frequency
       nil
     end
 
+    # The priority hint for sitemap generation.
+    # Override in subclasses to provide a value between 0.0 and 1.0.
+    #
+    # @return [Float, nil] the priority, or nil if unknown
     def priority
       nil
     end

data/lib/wytch/reload_coordinator.rb

@@ -4,9 +4,21 @@ require "concurrent/atomic/read_write_lock"
 require "listen"
 
 module Wytch
+  # Coordinates hot reloading of site code and content during development.
+  #
+  # The ReloadCoordinator watches the site code and content directories for
+  # changes using the Listen gem. When files change, it marks the appropriate
+  # component as dirty and reloads it on the next request.
+  #
+  # It uses a read-write lock to ensure thread-safe reloading while allowing
+  # concurrent reads during page rendering.
+  #
+  # @see Wytch::SiteCodeLoaderMiddleware
   class ReloadCoordinator
+    # @return [Concurrent::ReadWriteLock] lock for coordinating reloads
     attr_reader :reload_lock
 
+    # Creates a new ReloadCoordinator and sets up file watchers.
     def initialize
       @reload_lock = Concurrent::ReadWriteLock.new
 
@@ -26,6 +38,13 @@ module Wytch
       end
     end
 
+    # Reloads site code and/or content if changes have been detected.
+    #
+    # Starts file listeners on first call. If site code has changed, reloads
+    # both site code (via Zeitwerk) and content. If only content has changed,
+    # reloads just the content.
+    #
+    # @return [void]
     def reload!
       @start_site_code_listener&.call
       @start_content_listener&.call

data/lib/wytch/server.rb

@@ -3,13 +3,38 @@
 require "rack"
 
 module Wytch
+  # Development server for Wytch sites.
+  #
+  # The Server provides a local development environment with:
+  # - Hot reloading of site code and content
+  # - Static file serving from public/
+  # - Page rendering on each request
+  #
+  # @example Starting via CLI
+  #   $ wytch server
+  #   $ wytch server --port 3000 --host 0.0.0.0
+  #
+  # @example Starting programmatically
+  #   Wytch::Server.new(port: 3000).start
   class Server
+    # @return [Hash] server options (port, host)
     attr_reader :options
 
+    # Creates a new server instance.
+    #
+    # @param options [Hash] server options
+    # @option options [Integer] :port the port to listen on (default: 6969)
+    # @option options [String] :host the host to bind to (default: "localhost")
     def initialize(options = {})
       @options = options
     end
 
+    # Starts the development server.
+    #
+    # Loads the site configuration, starts file watchers for hot reloading,
+    # and begins serving requests. This method blocks until the server is stopped.
+    #
+    # @return [void]
     def start
       ENV["RACK_ENV"] = "development"
       Site.load!
@@ -30,6 +55,9 @@ module Wytch
 
     private
 
+    # Builds the Rack application stack.
+    #
+    # @return [Rack::Builder] the configured Rack app
     def app
       base_app = lambda { |env|
         path = env["PATH_INFO"]

data/lib/wytch/site.rb

@@ -1,7 +1,24 @@
 # frozen_string_literal: true
 
 module Wytch
+  # Holds the configuration and state for a Wytch site.
+  #
+  # The Site class is the central configuration point for Wytch. It manages
+  # the content directory, site code loading, page class, and the collection
+  # of all pages.
+  #
+  # @example Configuring a site in config.rb
+  #   Wytch.configure do |site|
+  #     site.page_class = "MySite::Page"
+  #     site.base_url = "https://example.com"
+  #     site.content_dir = "pages"  # default is "content"
+  #   end
+  #
+  # @see Wytch.configure
   class Site
+    # Loads the site configuration from config.rb in the current directory.
+    #
+    # @return [void]
     def self.load!
       if File.exist?(config_file = File.join(Dir.pwd, "config.rb"))
         load config_file
@@ -10,6 +27,7 @@ module Wytch
       end
     end
 
+    # Creates a new Site with default configuration.
     def initialize
       @inflections = {}
       @content_dir = "content"
@@ -19,13 +37,38 @@ module Wytch
       @base_url = nil
     end
 
+    # @return [Hash] custom inflections for Zeitwerk autoloading
     attr_reader :inflections
+
+    # @!attribute content_dir
+    #   @return [String] directory containing content files (default: "content")
+    # @!attribute site_code_path
+    #   @return [String] directory containing site Ruby code (default: "src")
+    # @!attribute page_class
+    #   @return [String] fully qualified class name for pages (default: "Wytch::Page")
+    # @!attribute pages
+    #   @return [Hash{String => Page}] all loaded pages, keyed by path
+    # @!attribute base_url
+    #   @return [String, nil] base URL for the site (used in sitemaps, feeds, etc.)
     attr_accessor :content_dir, :site_code_path, :page_class, :pages, :base_url
 
+    # Adds custom inflections for Zeitwerk autoloading.
+    #
+    # @param inflections_hash [Hash{String => String}] mapping of file names to class names
+    # @return [void]
+    #
+    # @example
+    #   site.inflect("api" => "API", "html_parser" => "HTMLParser")
     def inflect(inflections_hash)
       @inflections.merge!(inflections_hash)
     end
 
+    # Returns the Zeitwerk loader for site code.
+    #
+    # The loader is configured to watch the site_code_path directory and
+    # supports hot reloading during development.
+    #
+    # @return [Zeitwerk::Loader] the configured loader
     def site_code_loader
       @site_code_loader ||= begin
         loader = Zeitwerk::Loader.new
@@ -37,10 +80,16 @@ module Wytch
       end
     end
 
+    # Returns the content loader instance.
+    #
+    # @return [ContentLoader] the loader for content files
     def content_loader
       @content_loader ||= ContentLoader.new
     end
 
+    # Loads all content files and populates the pages hash.
+    #
+    # @return [Hash{String => Page}] all loaded pages
     def load_content
       @pages = content_loader.load_content
     end

data/lib/wytch/site_code_loader_middleware.rb

@@ -1,12 +1,31 @@
 # frozen_string_literal: true
 
 module Wytch
+  # Rack middleware that triggers hot reloading before each request.
+  #
+  # This middleware wraps the base application and coordinates with the
+  # ReloadCoordinator to ensure site code and content are reloaded when
+  # files change. It acquires a read lock during request processing to
+  # prevent reloads from interfering with rendering.
+  #
+  # @see Wytch::ReloadCoordinator
   class SiteCodeLoaderMiddleware
+    # Creates a new middleware instance.
+    #
+    # @param app [#call] the Rack application to wrap
+    # @param coordinator [ReloadCoordinator] the reload coordinator
     def initialize(app, coordinator)
       @app = app
       @coordinator = coordinator
     end
 
+    # Handles a Rack request.
+    #
+    # Triggers a reload check, then processes the request while holding
+    # a read lock to prevent concurrent reloads.
+    #
+    # @param env [Hash] the Rack environment
+    # @return [Array] the Rack response tuple
     def call(env)
       @coordinator.reload!
 

data/lib/wytch/templates/src/site/layout.rb.tt

@@ -11,6 +11,7 @@ module <%= @site_module %>
 
       html do
         head do
+          meta charset: "utf-8"
           title { @page.metadata[:title] }
           meta name: "description", content: @page.metadata[:description] if @page.metadata[:description]
           meta name: "viewport", content: "width=device-width, initial-scale=1.0"

data/lib/wytch/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 module Wytch
-  VERSION = "0.2.0"
+  # The current version of Wytch.
+  VERSION = "0.3.0"
 end

data/lib/wytch.rb

@@ -7,19 +7,48 @@ loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect("cli" => "CLI")
 loader.setup
 
+# Wytch is a minimal static site generator that uses Ruby for content
+# and Phlex for views.
+#
+# @example Basic configuration in config.rb
+#   Wytch.configure do |site|
+#     site.page_class = "MySite::Page"
+#     site.base_url = "https://example.com"
+#   end
+#
+# @see Wytch::Site
+# @see Wytch::Page
 module Wytch
+  # Base error class for all Wytch errors.
   class Error < StandardError; end
 
   class << self
+    # Returns the global site instance.
+    #
+    # @return [Wytch::Site] the current site configuration
     def site
       @site ||= Site.new
     end
 
+    # Configures the global site instance.
+    #
+    # @yield [site] Configuration block
+    # @yieldparam site [Wytch::Site] the site instance to configure
+    # @return [Wytch::Site] the configured site
+    #
+    # @example
+    #   Wytch.configure do |site|
+    #     site.page_class = "MySite::Page"
+    #     site.content_dir = "pages"
+    #   end
     def configure
       yield(site) if block_given?
       site
     end
 
+    # Resets the global site instance. Primarily used for testing.
+    #
+    # @return [void]
     def reset_site!
       @site = nil
     end

data/website/.gitignore

@@ -0,0 +1,4 @@
+build/
+node_modules/
+lib/
+.vite/

data/website/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gem "wytch", path: ".."
+
+gem "builder", "~> 3.3"
+gem "yard", "~> 0.9"

data/website/Gemfile.lock

@@ -0,0 +1,63 @@
+PATH
+  remote: ..
+  specs:
+    wytch (0.2.0)
+      concurrent-ruby (~> 1.3)
+      listen (~> 3.9)
+      phlex (~> 1.11)
+      puma (~> 6.4)
+      rack (~> 3.1)
+      thor (~> 1.4)
+      zeitwerk (~> 2.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    builder (3.3.0)
+    concurrent-ruby (1.3.5)
+    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)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    nio4r (2.7.5)
+    phlex (1.11.0)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    rack (3.2.4)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    thor (1.4.0)
+    yard (0.9.38)
+    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
+  builder (~> 3.3)
+  wytch!
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.6.9

data/website/assets/Main.res

@@ -0,0 +1,2 @@
+// Main entry point for ReScript code
+Console.log("Hello from Wytch-site!")

data/website/assets/main.css

@@ -0,0 +1 @@
+@import "tailwindcss";

data/website/bin/generate_api_docs

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'yard'
+require 'fileutils'
+
+# Path to the wytch gem lib directory
+WYTCH_LIB_PATH = File.expand_path('../../lib', __dir__)
+API_CONTENT_DIR = File.expand_path('../content/api', __dir__)
+
+puts "Cleaning existing API documentation..."
+FileUtils.rm_rf(API_CONTENT_DIR)
+FileUtils.mkdir_p(API_CONTENT_DIR)
+
+puts "Parsing YARD documentation from #{WYTCH_LIB_PATH}..."
+YARD.parse("#{WYTCH_LIB_PATH}/**/*.rb")
+
+puts "Generating API content files..."
+YARD::Registry.all(:class).each do |klass|
+  # Convert Wytch::Page to wytch/page
+  path_segments = klass.path.split('::').map(&:downcase)
+  
+  # Create directory structure
+  dir_path = File.join(API_CONTENT_DIR, *path_segments[0..-2])
+  FileUtils.mkdir_p(dir_path) if path_segments.length > 1
+  
+  # Create content file
+  file_path = File.join(API_CONTENT_DIR, *path_segments) + '.rb'
+  
+  File.write(file_path, <<~RUBY)
+    # frozen_string_literal: true
+    
+    view WytchSite::ApiClassView
+    
+    @metadata[:title] = "#{klass.path}"
+    @metadata[:yard_path] = "#{klass.path}"
+  RUBY
+  
+  puts "  Created #{file_path.sub(API_CONTENT_DIR + '/', '')}"
+end
+
+puts "\nGenerated #{YARD::Registry.all(:class).count} API documentation pages"
+puts "Run 'wytch build' to build the site"

data/website/config.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+Wytch.configure do |site|
+  site.page_class = "WytchSite::Page"
+  # site.base_url = "https://example.com"
+end

data/website/content/api/wytch/builder.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::Builder"
+@metadata[:yard_path] = "Wytch::Builder"

data/website/content/api/wytch/cli.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::CLI"
+@metadata[:yard_path] = "Wytch::CLI"

data/website/content/api/wytch/contentloader.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::ContentLoader"
+@metadata[:yard_path] = "Wytch::ContentLoader"

data/website/content/api/wytch/error.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::Error"
+@metadata[:yard_path] = "Wytch::Error"

data/website/content/api/wytch/once.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::Once"
+@metadata[:yard_path] = "Wytch::Once"

data/website/content/api/wytch/page.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::Page"
+@metadata[:yard_path] = "Wytch::Page"

data/website/content/api/wytch/reloadcoordinator.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::ReloadCoordinator"
+@metadata[:yard_path] = "Wytch::ReloadCoordinator"

data/website/content/api/wytch/server.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::Server"
+@metadata[:yard_path] = "Wytch::Server"

data/website/content/api/wytch/site.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::Site"
+@metadata[:yard_path] = "Wytch::Site"

data/website/content/api/wytch/sitecodeloadermiddleware.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::ApiClassView
+
+@metadata[:title] = "Wytch::SiteCodeLoaderMiddleware"
+@metadata[:yard_path] = "Wytch::SiteCodeLoaderMiddleware"

data/website/content/index.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view WytchSite::HomeView
+
+@metadata[:title] = "Wytch"
+@metadata[:description] = "A minimal static site generator"

data/website/content/sitemap.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+add WytchSite::SitemapHelper
+view WytchSite::SitemapView

data/website/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "wytch-site",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "devDependencies": {
+    "@jihchi/vite-plugin-rescript": "^7.1.0",
+    "rescript": "^11.1.4",
+    "tailwindcss": "^4.1.0",
+    "vite": "^7.2.2"
+  },
+  "dependencies": {
+    "@rescript/core": "^1.6.1"
+  }
+}

data/website/public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Allow: /

data/website/rescript.json

@@ -0,0 +1,18 @@
+{
+  "name": "wytch-site",
+  "sources": [
+    {
+      "dir": "assets",
+      "subdirs": true
+    }
+  ],
+  "package-specs": [
+    {
+      "module": "esmodule",
+      "in-source": false
+    }
+  ],
+  "suffix": ".res.js",
+  "bs-dependencies": ["@rescript/core"],
+  "bsc-flags": ["-open RescriptCore"]
+}

data/website/src/wytch_site/api_class_view.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module WytchSite
+  class ApiClassView < Phlex::HTML
+    def initialize(page)
+      @page = page
+      @klass = @page.yard_object
+    end
+
+    def view_template
+      render Layout.new(@page) do
+        article do
+          header do
+            h1 { @klass.path }
+            p(class: "summary") { @klass.docstring.summary } unless @klass.docstring.summary.empty?
+          end
+
+          unless @klass.docstring.to_s.empty?
+            section(class: "description") do
+              h2 { "Description" }
+              div { unsafe_raw markdown_to_html(@klass.docstring.to_s) }
+            end
+          end
+
+          # Public methods
+          public_methods = @klass.meths(visibility: :public).reject { |m| m.name == :initialize }
+          if public_methods.any?
+            section(class: "methods") do
+              h2 { "Methods" }
+              public_methods.each do |method|
+                render_method(method)
+              end
+            end
+          end
+        end
+      end
+    end
+
+    private
+
+    def render_method(method)
+      article(class: "method", id: method.name) do
+        h3 { code { method.signature } }
+        
+        unless method.docstring.to_s.empty?
+          div(class: "method-description") do
+            unsafe_raw markdown_to_html(method.docstring.to_s)
+          end
+        end
+
+        # Parameters
+        param_tags = method.tags.select { |t| t.tag_name == "param" }
+        if param_tags.any?
+          dl(class: "parameters") do
+            dt { "Parameters:" }
+            param_tags.each do |tag|
+              dd do
+                code { tag.name }
+                span { " (#{tag.types.join(', ')})" } if tag.types
+                plain " — #{tag.text}" if tag.text
+              end
+            end
+          end
+        end
+
+        # Returns
+        return_tags = method.tags.select { |t| t.tag_name == "return" }
+        if return_tags.any?
+          dl(class: "returns") do
+            dt { "Returns:" }
+            return_tags.each do |tag|
+              dd do
+                span { "(#{tag.types.join(', ')})" } if tag.types
+                plain " — #{tag.text}" if tag.text
+              end
+            end
+          end
+        end
+      end
+    end
+
+    def markdown_to_html(text)
+      # Simple markdown rendering - just handle basic formatting
+      text.gsub(/`([^`]+)`/, '<code>\1</code>')
+          .gsub(/\*\*([^*]+)\*\*/, '<strong>\1</strong>')
+          .gsub(/\n\n/, '</p><p>')
+          .then { |s| "<p>#{s}</p>" }
+    end
+  end
+end

data/website/src/wytch_site/home_view.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module WytchSite
+  class HomeView < Phlex::HTML
+    def initialize(page)
+      @page = page
+    end
+
+    def view_template
+      render Layout.new(@page) do
+        h1 { @page.metadata[:title] }
+        p { @page.metadata[:description] }
+        
+        section do
+          h2 { "API Documentation" }
+          ul do
+            api_pages.each do |page|
+              li { a(href: page.path) { page.metadata[:title] } }
+            end
+          end
+        end
+      end
+    end
+    
+    private
+    
+    def api_pages
+      Wytch.site.pages.values
+        .select { |p| p.path.start_with?('/api/') }
+        .sort_by { |p| p.metadata[:title] }
+    end
+  end
+end

data/website/src/wytch_site/layout.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module WytchSite
+  class Layout < Phlex::HTML
+    def initialize(page)
+      @page = page
+    end
+
+    def view_template(&block)
+      doctype
+
+      html do
+        head do
+          meta charset: "utf-8"
+          title { @page.metadata[:title] }
+          meta name: "description", content: @page.metadata[:description] if @page.metadata[:description]
+          meta name: "viewport", content: "width=device-width, initial-scale=1.0"
+
+          # Vite assets
+          if ENV["RACK_ENV"] == "development"
+            script src: "http://localhost:6970/@vite/client", type: "module"
+            link rel: "stylesheet", href: "http://localhost:6970/assets/main.css"
+            script src: "http://localhost:6970/assets/Main.res", type: "module"
+          else
+            link rel: "stylesheet", href: "/assets/main.css"
+            script src: "/assets/app.js", type: "module"
+          end
+        end
+
+        body(&block)
+      end
+    end
+  end
+end

data/website/src/wytch_site/page.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'yard'
+
+module WytchSite
+  class Page < Wytch::Page
+    def yard_object
+      return nil unless @metadata[:yard_path]
+      
+      # Parse YARD if registry is empty
+      if YARD::Registry.all.empty?
+        YARD.parse(File.expand_path('../../../lib/**/*.rb', __dir__))
+      end
+      
+      YARD::Registry.at(@metadata[:yard_path])
+    end
+  end
+end

data/website/src/wytch_site/sitemap_helper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module WytchSite
+  module SitemapHelper
+    def path
+      "/sitemap.xml"
+    end
+
+    def build_path
+      "sitemap.xml"
+    end
+
+    def include_in_sitemap?
+      false
+    end
+  end
+end

data/website/src/wytch_site/sitemap_view.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module WytchSite
+  class SitemapView
+    def initialize(page)
+      @page = page
+    end
+
+    def call
+      require "builder"
+
+      xml = Builder::XmlMarkup.new(indent: 2)
+      xml.instruct! :xml, version: "1.0", encoding: "UTF-8"
+      xml.urlset xmlns: "http://www.sitemaps.org/schemas/sitemap/0.9" do
+        Wytch.site.pages.values.each do |page|
+          next unless page.include_in_sitemap?
+          xml.url do
+            xml.loc "#{Wytch.site.base_url}#{page.path}"
+            xml.lastmod page.last_modified if page.last_modified
+            xml.changefreq page.change_frequency if page.change_frequency
+            xml.priority page.priority if page.priority
+          end
+        end
+      end
+    end
+  end
+end

data/website/vite.config.js

@@ -0,0 +1,26 @@
+import { defineConfig } from "vite";
+import createReScriptPlugin from "@jihchi/vite-plugin-rescript";
+
+export default defineConfig({
+  plugins: [
+    createReScriptPlugin({
+      loader: {
+        suffix: ".res.js",
+      },
+    }),
+  ],
+  build: {
+    outDir: "build/assets",
+    manifest: true,
+    rollupOptions: {
+      input: {
+        main: "./assets/main.css",
+        app: "./assets/Main.res",
+      },
+    },
+  },
+  server: {
+    port: 6970,
+    strictPort: false,
+  },
+});

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wytch
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Jared Norman
@@ -155,6 +155,35 @@ files:
 - lib/wytch/templates/vite.config.js.tt
 - lib/wytch/version.rb
 - sig/wytch.rbs
+- website/.gitignore
+- website/Gemfile
+- website/Gemfile.lock
+- website/assets/Main.res
+- website/assets/main.css
+- website/bin/generate_api_docs
+- website/config.rb
+- website/content/api/wytch/builder.rb
+- website/content/api/wytch/cli.rb
+- website/content/api/wytch/contentloader.rb
+- website/content/api/wytch/error.rb
+- website/content/api/wytch/once.rb
+- website/content/api/wytch/page.rb
+- website/content/api/wytch/reloadcoordinator.rb
+- website/content/api/wytch/server.rb
+- website/content/api/wytch/site.rb
+- website/content/api/wytch/sitecodeloadermiddleware.rb
+- website/content/index.rb
+- website/content/sitemap.rb
+- website/package.json
+- website/public/robots.txt
+- website/rescript.json
+- website/src/wytch_site/api_class_view.rb
+- website/src/wytch_site/home_view.rb
+- website/src/wytch_site/layout.rb
+- website/src/wytch_site/page.rb
+- website/src/wytch_site/sitemap_helper.rb
+- website/src/wytch_site/sitemap_view.rb
+- website/vite.config.js
 homepage: https://github.com/SuperGoodSoft/wytch
 licenses:
 - MIT