open_blog 0.1.0 → 0.3.0

data/lib/open_blog/build_css.rb

@@ -27,17 +27,60 @@ module OpenBlog
       end
     end
 
+    OVERRIDE = <<~CSS
+      /*
+        Open Blog loads this file after the preset chosen with config.theme.
+        Put your token overrides here. Colours can also be set with config.theme_colors.
+
+        :root[data-ob-theme] {
+          --ob-accent: #1d4ed8;
+          --ob-font-display: Georgia, serif;
+          --ob-radius-card: 0.5rem;
+        }
+        :root[data-ob-theme][data-theme="dark"] {
+          --ob-accent: #93c5fd;
+        }
+        @media (prefers-color-scheme: dark) {
+          :root[data-ob-theme]:not([data-theme="light"]) {
+            --ob-accent: #93c5fd;
+          }
+        }
+      */
+    CSS
+
+    COLOR_SCHEME = <<~CSS
+      :root { color-scheme: light dark; }
+      :root[data-theme="light"] { color-scheme: light; }
+      :root[data-theme="dark"] { color-scheme: dark; }
+    CSS
+
     def self.tokens
-      source = theme_root.join("theme.css").read
-      block = source.match(%r{/\* open-blog:tokens:start \*/(.*?)/\* open-blog:tokens:end \*/}m)
-      raise ConfigurationError, "The theme must contain its marked token block" unless block
-      "#{block[1].strip}\n"
+      OVERRIDE
+    end
+
+    def self.themes
+      faces = Themes::FONTS.map do |font|
+        <<~CSS
+          @font-face {
+            font-family: "#{font.family}";
+            font-style: #{font.style};
+            font-weight: #{font.weight};
+            font-display: swap;
+            src: url("#{font.file}") format("woff2");
+            unicode-range: #{font.range};
+          }
+        CSS
+      end
+      presets = Themes.names.map do |name|
+        preset = Themes.fetch(name)
+        Themes.css(name, light: preset.light.merge(preset.tokens), dark: preset.dark)
+      end
+      [ *faces, COLOR_SCHEME, *presets ].join
     end
 
-    def self.write(path: Engine.root.join("app/assets/builds/open_blog/blog.css"), tokens_path: theme_root.join("open_blog_theme.css"))
-      css = render
-      values = tokens
-      [ [ path, css ], [ tokens_path, values ] ].each do |destination, bytes|
+    def self.write(path: Engine.root.join("app/assets/builds/open_blog/blog.css"), tokens_path: theme_root.join("open_blog_theme.css"),
+      themes_path: Pathname(path).dirname.join("themes.css"))
+      [ [ path, render ], [ tokens_path, tokens ], [ themes_path, themes ] ].each do |destination, bytes|
         destination = Pathname(destination)
         FileUtils.mkdir_p(destination.dirname)
         destination.binwrite(bytes)

data/lib/open_blog/configuration.rb

@@ -5,6 +5,7 @@ require "active_support/core_ext/numeric/time"
 require "active_support/core_ext/numeric/bytes"
 require "open_blog/configuration_error"
 require "open_blog/page_views"
+require "open_blog/themes"
 
 module OpenBlog
   class Configuration
@@ -17,12 +18,16 @@ module OpenBlog
       end
     end
 
+    THEMES = (Themes.names + [ :none ]).freeze
+    THEME_MODES = %i[light dark].freeze
+    THEME_COLOR_KEYS = Themes::COLOR_TOKENS.to_h { |token| [ token.tr("-", "_").to_sym, token ] }.freeze
+
     attr_accessor :site_name, :public_base_url, :default_author, :publisher, :locale,
       :blog_title, :blog_tagline, :layout, :parent_controller, :mount_path,
       :route_segments, :posts_per_page, :primary_list_type, :call_to_action,
       :default_social_image_url, :policy_urls, :sign_in_destinations, :body_formats,
       :default_body_format, :markdown_hardbreaks, :ai_label, :require_approval,
-      :color_scheme, :syntax_theme, :feed_content, :feed_size, :serve_sitemap,
+      :color_scheme, :theme, :theme_colors, :faq_collapsed, :syntax_theme, :feed_content, :feed_size, :serve_sitemap,
       :page_views, :page_view_bot_pattern, :page_view_retention_days, :popular_posts,
       :preview_expires_in, :storage_service, :image_delivery, :max_image_bytes,
       :image_content_types, :image_fetch_policy, :api_rate_limit, :search_rate_limit
@@ -45,6 +50,9 @@ module OpenBlog
       @ai_label = :when_required
       @require_approval = false
       @color_scheme = :system
+      @theme = :signal
+      @theme_colors = {}
+      @faq_collapsed = true
       @syntax_theme = "github".dup
       @feed_content = :summary
       @feed_size = 20
@@ -101,6 +109,7 @@ module OpenBlog
       end
       invalid!(:default_body_format, "must be enabled in body_formats") unless body_formats.include?(default_body_format)
       preview_duration
+      validate_theme!
       validate_view_settings!
       invalid!(:mcp, "enabled must be true or false") unless [ true, false ].include?(mcp.enabled)
       invalid!(:mcp, "max_page_size must be a positive integer") unless mcp.max_page_size.is_a?(Integer) && mcp.max_page_size.positive?
@@ -115,8 +124,35 @@ module OpenBlog
       value.to_f
     end
 
+    def theme_colors_for(mode)
+      validate_theme!
+      theme_colors.except(*THEME_MODES).merge(theme_colors.fetch(mode, {})).to_h do |key, color|
+        [ THEME_COLOR_KEYS.fetch(key), color ]
+      end
+    end
+
     private
 
+    def validate_theme!
+      invalid!(:theme, "must be #{THEMES.map(&:inspect).join(', ')}") unless THEMES.include?(theme)
+      invalid!(:faq_collapsed, "must be true or false") unless [ true, false ].include?(faq_collapsed)
+      invalid!(:theme_colors, "must be a hash") unless theme_colors.is_a?(Hash)
+      theme_colors.each do |key, value|
+        next validate_theme_color!(key, key, value) unless THEME_MODES.include?(key)
+        invalid!("theme_colors.#{key}", "must be a hash") unless value.is_a?(Hash)
+        value.each { |token, color| validate_theme_color!("#{key}.#{token}", token, color) }
+      end
+    end
+
+    def validate_theme_color!(path, token, color)
+      unless THEME_COLOR_KEYS.key?(token)
+        invalid!("theme_colors.#{path}", "is not a colour token; use #{THEME_COLOR_KEYS.keys.join(', ')}")
+      end
+      unless color.is_a?(String) && color.encoding.ascii_compatible? && color.valid_encoding? && color.match?(Themes::HEX)
+        invalid!("theme_colors.#{path}", "must be a hex colour such as #0f766e")
+      end
+    end
+
     def validate_view_settings!
       invalid!(:page_views, "must be true or false") unless [ true, false ].include?(page_views)
       invalid!(:page_view_bot_pattern, "must be a regular expression") unless page_view_bot_pattern.is_a?(Regexp)

data/lib/open_blog/doctor/files.rb

@@ -34,27 +34,66 @@ module OpenBlog
       end
 
       def theme
+        colors = Configuration::THEME_MODES.index_with { |mode| @config.theme_colors_for(mode) }
+        preset = Themes.fetch(@config.theme) unless @config.theme == :none
+        problem = theme_files(preset)
+        return [ "error", problem ] if problem
+        warnings = []
+        warnings << "theme_colors has no effect with theme :none." if preset.nil? && colors.values.any?(&:any?)
+        low = preset ? low_contrast(preset, colors) : []
+        warnings << "Theme colours below #{Themes::MIN_CONTRAST}:1 contrast: #{low.join(', ')}." if low.any?
+        stale = stale_component_styles(preset)
+        warnings << stale if stale
+        if Dir[@root.join("app/views/layouts/**/*")].select { |path| File.file?(path) }.any? { |path| File.read(path).match?(/stylesheet_link_tag\s*(?:\(?\s*):all\b/) }
+          warnings << "Replace stylesheet_link_tag :all to avoid loading the blog reset on other pages."
+        end
+        return [ "warning", warnings.join(" ") ] if warnings.any?
+        [ "ok", "Theme #{@config.theme}: sources and compiled stylesheets are available." ]
+      rescue ConfigurationError => error
+        [ "error", error.message ]
+      end
+
+      def low_contrast(preset, colors)
+        colors.flat_map do |mode, overrides|
+          Themes.low_contrast(preset.public_send(mode).merge(overrides)).map do |foreground, background, ratio|
+            "#{mode} #{foreground.tr('-', '_')} on #{background.tr('-', '_')} #{ratio.floor(2)}:1"
+          end
+        end
+      end
+
+      def stale_component_styles(preset)
+        return if layout_source.include?("open_blog_stylesheets")
+        path = "app/assets/tailwind/open_blog/blog.css"
+        source = read(path)
+        absent = []
+        absent << "preset" if preset && !source.include?("data-ob-theme")
+        absent << "collapsed FAQ" if @config.faq_collapsed && !source.include?("details.ob-faq-entry")
+        return if absent.empty?
+        "#{path} has no #{absent.join(' or ')} rules. Delete it#{' and theme.css in the same directory' if preset}, then run bin/rails generate open_blog:install."
+      end
+
+      def theme_files(preset)
         layout = layout_source
         tailwind = @root.join("app/assets/tailwind/application.css")
         bundled = @root.join("app/assets/stylesheets/application.tailwind.css")
         if !layout.include?("open_blog_stylesheets")
           asset = layout[/stylesheet_link_tag\s*\(?\s*["']([^"']+)["']/, 1]
-          return [ "error", "The blog layout must load the installed stylesheet." ] unless %w[tailwind application].include?(asset)
+          return "The blog layout must load the installed stylesheet." unless %w[tailwind application].include?(asset)
+          return "The blog layout must call open_blog_theme_stylesheets to load the #{preset.name} theme." if preset && !layout.include?("open_blog_theme_stylesheets")
           entry = asset == "tailwind" ? tailwind : bundled
-          return [ "error", "Missing Tailwind entry stylesheet #{entry.relative_path_from(@root)}." ] unless entry.file?
+          return "Missing Tailwind entry stylesheet #{entry.relative_path_from(@root)}." unless entry.file?
           source = entry.read
-          return [ "error", "Import open_blog/theme.css in #{entry.relative_path_from(@root)}." ] unless source.match?(/@import\s+["'][^"']*open_blog\/theme(?:\.css)?["']/)
+          return "Import open_blog/theme.css in #{entry.relative_path_from(@root)}." unless source.match?(/@import\s+["'][^"']*open_blog\/theme(?:\.css)?["']/)
           absent = %w[theme blog syntax].reject { |name| @root.join("app/assets/tailwind/open_blog/#{name}.css").file? }
-          return [ "error", "Missing theme sources: #{absent.join(', ')}." ] if absent.any?
-          asset = "#{asset}.css"
+          return "Missing theme sources: #{absent.join(', ')}." if absent.any?
+          assets = [ "#{asset}.css" ]
         else
-          return [ "error", "Install app/assets/stylesheets/open_blog_theme.css." ] unless @root.join("app/assets/stylesheets/open_blog_theme.css").file?
-          asset = "open_blog/blog.css"
-          return [ "error", "The blog layout must load open_blog_stylesheets." ] unless layout.include?("open_blog_stylesheets")
+          return "Install app/assets/stylesheets/open_blog_theme.css." unless @root.join("app/assets/stylesheets/open_blog_theme.css").file?
+          assets = [ "open_blog/blog.css" ]
         end
-        return [ "error", "Build the missing #{asset} stylesheet." ] unless @application.assets&.resolver&.resolve(asset)
-        all = Dir[@root.join("app/views/layouts/**/*")].select { |path| File.file?(path) }.any? { |path| File.read(path).match?(/stylesheet_link_tag\s*(?:\(?\s*):all\b/) }
-        all ? [ "warning", "Replace stylesheet_link_tag :all to avoid loading the blog reset on other pages." ] : [ "ok", "Theme sources and compiled stylesheet are available." ]
+        assets << "open_blog/themes.css" if preset
+        missing = assets.reject { |asset| @application.assets&.resolver&.resolve(asset) }
+        "Build the missing #{missing.join(', ')} stylesheet." if missing.any?
       end
     end
   end

data/lib/open_blog/doctor.rb

@@ -11,7 +11,7 @@ module OpenBlog
 
     CHECKS = { "Configuration" => :configuration, "Migrations" => :migrations, "Route" => :route,
       "Views" => :views, "Theme" => :theme, "JavaScript" => :javascript, "Authentication" => :authentication,
-      "Rate limit" => :rate_limit, "Jobs" => :jobs, "Storage" => :storage, "Policy pages" => :policy_pages,
+      "Rate limit" => :rate_limit, "Jobs" => :jobs, "Storage" => :storage, "Record keys" => :record_keys, "Policy pages" => :policy_pages,
       "Records" => :records, "Declarations" => :declarations }.freeze
     TABLES = %w[open_blog_authors open_blog_categories open_blog_series open_blog_images open_blog_posts
       open_blog_api_tokens open_blog_pages open_blog_page_views open_blog_faqs open_blog_tags open_blog_taggings open_blog_redirects open_blog_revisions
@@ -126,6 +126,35 @@ module OpenBlog
       [ "ok", "Active Storage and the configured image processor are available." ]
     end
 
+    def record_keys
+      if (missing_tables & %w[active_storage_attachments open_blog_images open_blog_authors open_blog_posts action_text_rich_texts]).any?
+        return [ "warning", "Record keys cannot be checked until all content tables are installed." ]
+      end
+      attachment = key_kind("active_storage_attachments", "record_id")
+      owners = %w[open_blog_images open_blog_authors].reject { |table| key_kind(table, "id") == attachment }
+      if owners.any?
+        return [ "error", "active_storage_attachments.record_id is #{attachment}, but #{owners.map { |table| "#{table}.id is #{key_kind(table, 'id')}" }.join(' and ')}, " \
+          "so blog images and avatars cannot attach. Install and run the latest migrations: " \
+          "bin/rails railties:install:migrations FROM=open_blog, then bin/rails db:migrate." ]
+      end
+      if @config.body_formats.include?(:rich_text)
+        problems = []
+        if key_kind("action_text_rich_texts", "record_id") != key_kind("open_blog_posts", "id")
+          problems << "action_text_rich_texts.record_id is #{key_kind('action_text_rich_texts', 'record_id')}, but open_blog_posts.id is #{key_kind('open_blog_posts', 'id')}, so rich-text bodies cannot save"
+        end
+        if key_kind("action_text_rich_texts", "id") != attachment
+          problems << "action_text_rich_texts.id is #{key_kind('action_text_rich_texts', 'id')}, but active_storage_attachments.record_id is #{attachment}, so rich-text bodies cannot embed images"
+        end
+        return [ "error", "#{problems.join('; ')}. Use config.body_formats = [ :markdown ] with these host tables." ] if problems.any?
+      end
+      [ "ok", "Blog image and author IDs match active_storage_attachments.record_id (#{attachment})." ]
+    end
+
+    def key_kind(table, column)
+      found = ActiveRecord::Base.connection.columns(table).find { |candidate| candidate.name == column }
+      { uuid: "uuid", integer: "integer" }.fetch(found.type, found.sql_type)
+    end
+
     def policy_pages
       problems = %i[responsible_party corrections editorial ai_use].filter_map do |key|
         url = @config.policy_urls[key]

data/lib/open_blog/mcp/registry.rb

@@ -22,12 +22,12 @@ module OpenBlog
           endpoint("remove_post", :publish, "posts", :destroy, fields: ApiFields::REMOVE, id: :required),
           upload_definition,
           endpoint("list_categories", :read, "categories", :index, fields: ApiFields::PAGE),
-          endpoint("save_category", :write, "categories", :create, fields: ApiFields::CATEGORY, id: :optional, upsert: true),
+          endpoint("save_category", :write, "categories", :create, fields: ApiFields::CATEGORY, id: :optional, upsert: Category),
           endpoint("list_tags", :read, "tags", :index, fields: ApiFields::PAGE),
           endpoint("list_authors", :read, "authors", :index, fields: ApiFields::PAGE),
-          endpoint("save_author", :write, "authors", :create, fields: ApiFields::AUTHOR, id: :optional, upsert: true),
+          endpoint("save_author", :write, "authors", :create, fields: ApiFields::AUTHOR, id: :optional, upsert: Author),
           endpoint("list_series", :read, "series", :index, fields: ApiFields::PAGE),
-          endpoint("save_series", :write, "series", :create, fields: ApiFields::SERIES, id: :optional, upsert: true),
+          endpoint("save_series", :write, "series", :create, fields: ApiFields::SERIES, id: :optional, upsert: Series),
           endpoint("list_redirects", :read, "redirects", :index, fields: ApiFields::PAGE),
           endpoint("save_redirect", :publish, "redirects", :create, fields: ApiFields::REDIRECT, required: [ :old_path ]),
           site_page_definition("get_site_page", :read),
@@ -43,7 +43,7 @@ module OpenBlog
 
       def endpoint(name, scope, controller, action, fields: [], id: nil, required: [], force: {}, upsert: false, create_publish: false, properties: nil)
         properties ||= Schemas.fields(fields)
-        properties = properties.merge("id" => upsert ? { type: "integer", minimum: 1 } : Schemas.identifier) if id
+        properties = properties.merge("id" => upsert ? Schemas.key(upsert) : Schemas.identifier) if id
         required = required + (id == :required ? [ :id ] : [])
         force.each { |key, value| properties[key.to_s] = properties.fetch(key.to_s).merge(const: value) if properties.key?(key.to_s) }
         definition(name, scope, Schemas.object(properties, required: required)) do |arguments, actor:, base_url:|

data/lib/open_blog/mcp/schemas.rb

@@ -15,6 +15,10 @@ module OpenBlog
         { anyOf: [ { type: "integer", minimum: 1 }, { type: "string", minLength: 1 } ] }
       end
 
+      def key(model)
+        RecordKeys.uuid?(model) ? { type: "string", format: "uuid" } : { type: "integer", minimum: 1 }
+      end
+
       def fields(names)
         names.to_h { |name| [ name.to_s, field(name) ] }
       end
@@ -44,7 +48,7 @@ module OpenBlog
           object(fields(%i[reviewer_name approved_at facts_checked evidence confirmed_by]), required: %w[reviewer_name approved_at facts_checked evidence confirmed_by])
         when :old_slugs
           { type: "array", items: { anyOf: [ text, object(fields(%i[slug moved_on]), required: [ "slug" ]) ] } }
-        when :image_id then { type: "integer", minimum: 1 }
+        when :image_id then key(Image)
         when :type then { type: "string", enum: %w[person organization] }
         when :body_format then { type: "string", enum: %w[markdown rich_text] }
         when :provenance then { type: "string", enum: %w[ai_assisted human_written unknown] }

data/lib/open_blog/post_attributes.rb

@@ -106,7 +106,7 @@ module OpenBlog
       when Integer then Author.find(input)
       when String
         invalid(:author) if input.blank?
-        if input.match?(/\A[1-9]\d*\z/)
+        if input.match?(/\A[1-9]\d*\z/) || RecordKeys.uuid_id?(Author, input)
           Author.find(input)
         else
           Author.find_by(slug: input) || Author.find_by(name: input) || Author.create!(name: input)
@@ -154,7 +154,7 @@ module OpenBlog
       return Image.find(input) if input.is_a?(Integer)
       if input.is_a?(Hash) && input.keys.map(&:to_s) == [ "image_id" ]
         id = input[:image_id] || input["image_id"]
-        return Image.find(id) if id.is_a?(Integer) || (id.is_a?(String) && id.match?(/\A[1-9]\d*\z/))
+        return Image.find(id) if id.is_a?(Integer) || (id.is_a?(String) && id.match?(/\A[1-9]\d*\z/)) || RecordKeys.uuid_id?(Image, id)
       end
       raise Error::ImageNotPermitted
     end

data/lib/open_blog/record_keys.rb

@@ -0,0 +1,35 @@
+module OpenBlog
+  # Copied host migrations call these methods, so their names and arguments must stay stable.
+  module RecordKeys
+    UUID = /\A\h{8}-\h{4}-\h{4}-\h{4}-\h{12}\z/
+    ATTACHING_TABLES = %w[open_blog_images open_blog_authors].freeze
+
+    module_function
+
+    def attachment_type(connection)
+      if connection.data_source_exists?("active_storage_attachments")
+        column = connection.columns("active_storage_attachments").find { |candidate| candidate.name == "record_id" }
+        column&.type == :uuid ? :uuid : :bigint
+      else
+        generators = Rails.configuration.generators
+        generators.options.dig(generators.orm, :primary_key_type)&.to_sym == :uuid ? :uuid : :bigint
+      end
+    end
+
+    def table_options(connection)
+      attachment_type(connection) == :uuid ? { id: :uuid } : {}
+    end
+
+    def uuid?(model)
+      model.type_for_attribute(model.primary_key).type == :uuid
+    end
+
+    def id?(model, value)
+      uuid?(model) ? value.is_a?(String) && value.match?(UUID) : value.is_a?(Integer) && value.positive?
+    end
+
+    def uuid_id?(model, value)
+      uuid?(model) && value.is_a?(String) && value.match?(UUID)
+    end
+  end
+end

data/lib/open_blog/themes.rb

@@ -0,0 +1,167 @@
+module OpenBlog
+  module Themes
+    Preset = Data.define(:name, :light, :dark, :tokens)
+    Font = Data.define(:family, :style, :weight, :file, :range)
+
+    MIN_CONTRAST = 4.5
+
+    COLOR_TOKENS = %w[
+      surface surface-raised surface-sunken heading text text-muted text-subtle border border-strong
+      accent accent-hover accent-soft accent-contrast accent-2 accent-2-soft
+      code-bg code-text code-border notice-bg notice-border notice-text note tip warning
+    ].freeze
+
+    TOKENS = %w[
+      font-display font-body font-mono radius-card radius-media radius-pill prose-size prose-leading
+      content-width page-width shadow heading-weight heading-tracking heading-transform rule-width lede-style
+    ].freeze
+
+    CONTRAST_PAIRS = [
+      %w[heading surface], %w[text surface], %w[text-muted surface], %w[text-subtle surface],
+      %w[heading surface-raised], %w[text surface-raised], %w[text-muted surface-raised], %w[text-subtle surface-raised],
+      %w[heading surface-sunken], %w[text surface-sunken],
+      %w[accent surface], %w[accent-hover surface], %w[accent surface-raised], %w[accent-hover surface-raised], %w[accent accent-soft],
+      %w[heading accent-soft], %w[text accent-soft], %w[heading accent-2-soft],
+      %w[accent-contrast accent], %w[notice-text notice-bg], %w[code-text code-bg],
+      %w[note surface-raised], %w[tip surface-raised], %w[warning surface-raised]
+    ].map(&:freeze).freeze
+
+    SANS = "ui-sans-serif, system-ui, sans-serif"
+    MONO = '"JetBrains Mono", ui-monospace, SFMono-Regular, Consolas, monospace'
+
+    PRESETS = {
+      signal: {
+        light: %w[
+          #ffffff #f6fbfa #eaf4f2 #0b1f22 #2b3f42 #4d6165 #5f7579 #cfe0dd #5f8a84
+          #0f766e #115e59 #d9f0ec #ffffff #b45309 #fdebd3
+          #f6fbfa #0b1f22 #b3cfca #fff7e8 #f0b35b #6b3f0a #1d5fa8 #166534 #92400e
+        ],
+        dark: %w[
+          #071a1c #0d2528 #041214 #eaf6f4 #c9dedb #a3bdb9 #8ba8a4 #1f4145 #5f8a84
+          #5eead4 #99f6e4 #0f3d3a #06201f #fbbf24 #3d2a0a
+          #041214 #e6f1ef #2a4d51 #33250c #b07d2c #fde7bd #7cc4f8 #86efac #fcd34d
+        ],
+        tokens: [
+          %("Outfit", #{SANS}), %("DM Sans", #{SANS}), MONO, "1rem", "0.75rem", "999px", "1.125rem", "1.8",
+          "46rem", "72rem", "0 18px 40px -20px #0b1f2259", "750", "-0.02em", "none", "1px", "normal"
+        ]
+      },
+      editorial: {
+        light: %w[
+          #fbf7f1 #f4ede2 #ece3d4 #1f1a16 #3a322c #5c524a #6b6158 #dccfbd #8c7b66
+          #8a2d2d #6f2222 #f1dedb #ffffff #b7791f #f4e6c9
+          #f9f4ec #1f1a16 #c9b9a3 #f6efe4 #d0b58a #5a4420 #2c5282 #2f6b3a #8a5a0b
+        ],
+        dark: %w[
+          #1a1512 #241d18 #120e0c #f6eee2 #ddd2c3 #b9ab9a #a39483 #3d332b #8c7b66
+          #e9a09a #f4c2bd #43201e #1a1512 #e0b25a #3a2c10
+          #110d0b #f3ebdf #4a3e34 #2e2515 #8a7040 #f0e0be #9cc3e8 #a3d9a5 #ebc46a
+        ],
+        tokens: [
+          '"Newsreader", Georgia, "Times New Roman", serif', '"Newsreader", Georgia, "Times New Roman", serif', MONO,
+          "0.375rem", "0.25rem", "999px", "1.25rem", "1.75", "42rem", "72rem", "none", "500", "-0.015em", "none", "1px", "italic"
+        ]
+      },
+      ink: {
+        light: %w[
+          #ffffff #f5f5f4 #ececea #0a0a0a #262626 #525252 #636363 #d4d4d4 #0a0a0a
+          #1f3bd6 #172c9f #e3e8ff #ffffff #c6f432 #f1fbc9
+          #fafafa #0a0a0a #0a0a0a #fffbe6 #0a0a0a #0a0a0a #1f3bd6 #166534 #8a4b00
+        ],
+        dark: %w[
+          #000000 #111111 #1a1a1a #ffffff #e5e5e5 #b5b5b5 #9a9a9a #333333 #ffffff
+          #8ea2ff #b4c1ff #141c4d #000000 #c6f432 #2a3505
+          #0d0d0d #f5f5f5 #ffffff #1f1c05 #ffffff #ffffff #8ea2ff #c6f432 #facc15
+        ],
+        tokens: [
+          %("Space Grotesk", #{SANS}), %("DM Sans", #{SANS}), MONO, "0", "0", "0", "1.0625rem", "1.7",
+          "44rem", "72rem", "none", "700", "-0.03em", "uppercase", "2px", "normal"
+        ]
+      }
+    }.to_h do |name, values|
+      [ name, Preset.new(name: name, light: COLOR_TOKENS.zip(values[:light]).to_h.freeze,
+        dark: COLOR_TOKENS.zip(values[:dark]).to_h.freeze, tokens: TOKENS.zip(values[:tokens]).to_h.freeze) ]
+    end.freeze
+
+    RANGES = {
+      "latin" => "U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, " \
+        "U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD",
+      "latin-ext" => "U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, " \
+        "U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF"
+    }.freeze
+
+    FONTS = [
+      [ "Outfit", "normal", "100 900", "outfit" ],
+      [ "DM Sans", "normal", "100 1000", "dm-sans" ],
+      [ "DM Sans", "italic", "100 1000", "dm-sans-italic" ],
+      [ "JetBrains Mono", "normal", "100 800", "jetbrains-mono" ],
+      [ "Newsreader", "normal", "200 800", "newsreader" ],
+      [ "Newsreader", "italic", "200 800", "newsreader-italic" ],
+      [ "Space Grotesk", "normal", "300 700", "space-grotesk" ]
+    ].flat_map do |family, style, weight, file|
+      RANGES.map { |subset, range| Font.new(family: family, style: style, weight: weight, file: "#{file}-#{subset}.woff2", range: range) }
+    end.freeze
+
+    HEX = /\A#(?:\h{3}|\h{6}|\h{8})\z/
+
+    class << self
+      def names
+        PRESETS.keys
+      end
+
+      def fetch(name)
+        PRESETS.fetch(name.to_s.to_sym) do
+          raise ConfigurationError, "Unknown theme #{name.inspect}; use #{names.join(', ')}"
+        end
+      end
+
+      def css(name, light: {}, dark: {})
+        root = %(:root[data-ob-theme="#{fetch(name).name}"])
+        system = "@media (prefers-color-scheme: dark) {\n#{rule(%(#{root}:not([data-theme="light"])), dark, "  ")}}\n"
+        [
+          (rule(root, light) if light.any?),
+          (rule(%(#{root}[data-theme="dark"]), dark) if dark.any?),
+          (system if dark.any?)
+        ].compact.join
+      end
+
+      def contrast(foreground, background, backdrop = background)
+        under = blend(rgba(background), rgba(backdrop).first(3))
+        lighter, darker = [ blend(rgba(foreground), under), under ].map { |color| luminance(color) }.sort.reverse
+        (lighter + 0.05) / (darker + 0.05)
+      end
+
+      def low_contrast(colors)
+        CONTRAST_PAIRS.filter_map do |foreground, background|
+          ratio = contrast(colors.fetch(foreground), colors.fetch(background), colors.fetch("surface"))
+          [ foreground, background, ratio ] if ratio < MIN_CONTRAST
+        end
+      end
+
+      private
+
+      def rule(selector, values, indent = "")
+        lines = values.map { |token, value| "#{indent}  --ob-#{token.to_s.tr('_', '-')}: #{value};\n" }
+        "#{indent}#{selector} {\n#{lines.join}#{indent}}\n"
+      end
+
+      def rgba(color)
+        raise ArgumentError, "Expected a hex colour, got #{color.inspect}" unless color.is_a?(String) && color.match?(HEX)
+        digits = color.delete_prefix("#")
+        digits = digits.chars.map { |digit| digit * 2 }.join if digits.length == 3
+        digits.ljust(8, "f").scan(/../).map { |channel| channel.to_i(16) / 255.0 }
+      end
+
+      def blend(color, under)
+        *channels, alpha = color
+        channels.zip(under).map { |top, bottom| top * alpha + bottom * (1 - alpha) }
+      end
+
+      def luminance(channels)
+        channels.zip([ 0.2126, 0.7152, 0.0722 ]).sum do |value, weight|
+          weight * (value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055)**2.4)
+        end
+      end
+    end
+  end
+end

data/lib/open_blog/version.rb

@@ -1,3 +1,3 @@
 module OpenBlog
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/open_blog.rb

@@ -40,6 +40,7 @@ module OpenBlog
   autoload :Renderer, "open_blog/renderer"
   autoload :SyntaxCss, "open_blog/syntax_css"
   autoload :BuildCss, "open_blog/build_css"
+  autoload :Themes, "open_blog/themes"
   autoload :ReaderPage, "open_blog/reader_page"
   autoload :ReaderDates, "open_blog/reader_dates"
   autoload :JsonFeed, "open_blog/json_feed"
@@ -57,6 +58,7 @@ module OpenBlog
   autoload :Mcp, "open_blog/mcp"
   autoload :ApiFields, "open_blog/api_fields"
   autoload :Authentication, "open_blog/authentication"
+  autoload :RecordKeys, "open_blog/record_keys"
 
   class << self
     def config

data/lib/tasks/open_blog.rake

@@ -37,7 +37,7 @@ namespace :open_blog do
   task :syntax_css, [ :path ] => :environment do |_task, arguments|
     puts "Wrote #{OpenBlog::SyntaxCss.write(path: arguments[:path])}"
   end
-  desc "Build the packaged stylesheet and token-only theme override"
+  desc "Build the packaged stylesheets and the theme override stub"
   task build_css: :environment do
     options = ENV["OUT"].present? ? { path: ENV["OUT"] } : {}
     puts "Wrote #{OpenBlog::BuildCss.write(**options)}"