wytch 0.1.0 → 0.3.0

data/lib/wytch/site.rb

@@ -0,0 +1,97 @@
+# 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
+      else
+        puts "Warning: config.rb not found in current directory"
+      end
+    end
+
+    # Creates a new Site with default configuration.
+    def initialize
+      @inflections = {}
+      @content_dir = "content"
+      @site_code_path = "src"
+      @page_class = "Wytch::Page"
+      @pages = {}
+      @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
+        loader.push_dir @site_code_path if Dir.exist?(@site_code_path)
+        loader.enable_reloading
+        loader.inflector.inflect(@inflections) if @inflections.any?
+        loader.setup
+        loader
+      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
+  end
+end

data/lib/wytch/site_code_loader_middleware.rb

@@ -0,0 +1,37 @@
+# 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!
+
+      @coordinator.reload_lock.with_read_lock {
+        @app.call(env)
+      }
+    end
+  end
+end

data/lib/wytch/templates/Gemfile.tt

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+<% if @local_wytch_path -%>
+gem "wytch", path: "<%= @local_wytch_path %>"
+<% else -%>
+gem "wytch", "~> <%= Gem::Version.new(Wytch::VERSION).segments[0..1].join('.') %>"
+<% end -%>
+
+gem "builder", "~> 3.3"
+gem "commonmarker", "~> 2.0"

data/lib/wytch/templates/config.rb.tt

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

data/lib/wytch/templates/content/feed.rb.tt

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+add <%= @site_module %>::FeedHelper
+view <%= @site_module %>::FeedView

data/lib/wytch/templates/content/index.rb.tt

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+view <%= @site_module %>::HomeView
+
+@metadata[:title] = "Welcome to Wytch"
+@metadata[:description] = "Your static site generator"

data/lib/wytch/templates/content/posts/hello-world.rb.tt

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+add <%= @site_module %>::PostHelpers
+view <%= @site_module %>::PostView
+
+@metadata[:title] = "Hello World"
+
+content_markdown <<~MD
+  This is your first blog post.
+
+  Write your content in **markdown**.
+MD

data/lib/wytch/templates/content/sitemap.rb.tt

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+add <%= @site_module %>::SitemapHelper
+view <%= @site_module %>::SitemapView

data/lib/wytch/templates/frontend/Main.res.tt

@@ -0,0 +1,2 @@
+// Main entry point for ReScript code
+Console.log("Hello from <%= @site_module %>!")

data/lib/wytch/templates/frontend/main.css.tt

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

data/lib/wytch/templates/gitignore.tt

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

data/lib/wytch/templates/package.json.tt

@@ -0,0 +1,19 @@
+{
+  "name": "<%= @site_name %>",
+  "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/lib/wytch/templates/public/robots.txt.tt

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

data/lib/wytch/templates/rescript.json.tt

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

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  module FeedHelper
+    def path
+      "/feed.xml"
+    end
+
+    def build_path
+      "feed.xml"
+    end
+
+    def include_in_sitemap?
+      false
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  class FeedView
+    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.feed xmlns: "http://www.w3.org/2005/Atom" do
+        xml.title "Blog"
+        xml.link href: "#{Wytch.site.base_url}/feed.xml", rel: "self"
+        xml.link href: Wytch.site.base_url
+        xml.updated posts.first&.last_modified || Time.now.iso8601
+        xml.id Wytch.site.base_url
+
+        posts.each do |post|
+          xml.entry do
+            xml.title post.metadata[:title]
+            xml.link href: "#{Wytch.site.base_url}#{post.path}"
+            xml.id "#{Wytch.site.base_url}#{post.path}"
+            xml.updated post.last_modified || Time.now.iso8601
+            xml.content post.content_html, type: "html" if post.respond_to?(:content_html)
+          end
+        end
+      end
+    end
+
+    private
+
+    def posts
+      Wytch.site.pages.values
+        .select(&:blog_post?)
+        .sort_by { |p| p.last_modified || "" }
+        .reverse
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  class HomeView < Phlex::HTML
+    def initialize(page)
+      @page = page
+    end
+
+    def view_template
+      render Layout.new(@page) do
+        h1 { @page.metadata[:title] }
+
+        h2 { "Posts" }
+
+        ul do
+          posts.each do |post|
+            li { a(href: post.path) { post.metadata[:title] } }
+          end
+        end
+      end
+    end
+
+    private
+
+    def posts
+      Wytch.site.pages.values.select { |p| p.path.start_with?("/posts/") }
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  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/lib/wytch/templates/src/site/page.rb.tt

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  class Page < Wytch::Page
+    def blog_post?
+      false
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  module PostHelpers
+    def blog_post?
+      true
+    end
+
+    def content_markdown(markdown)
+      @content_markdown = markdown
+    end
+
+    def content_html
+      require "commonmarker"
+      Commonmarker.to_html(@content_markdown || "")
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  class PostView < Phlex::HTML
+    def initialize(page)
+      @page = page
+    end
+
+    def view_template
+      render Layout.new(@page) do
+        article do
+          h1 { @page.metadata[:title] }
+
+          unsafe_raw @page.content_html
+        end
+
+        a(href: "/") { "Back to home" }
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module <%= @site_module %>
+  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/lib/wytch/templates/vite.config.js.tt

@@ -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,
+  },
+});

data/lib/wytch/version.rb

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

data/lib/wytch.rb

@@ -1,8 +1,58 @@
 # frozen_string_literal: true
 
-require_relative "wytch/version"
+require "zeitwerk"
+require "phlex"
 
+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
-  # Your code goes here...
+
+  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
+  end
 end
+
+loader.eager_load

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";