robin_cms 0.1.7 → 0.3.0

data/lib/robin_cms/library.rb

@@ -1,6 +1,13 @@
 # frozen_string_literal: true
 
 module RobinCMS
+  # The data access layer for Items.
+  #
+  # This class implements a Data Mapper pattern for persisting items to disk.
+  # It works well for this domain because there are two ways that items are
+  # written to disk, depending on whether they are a Data or Collection item.
+  # Since the Data Mapper is independent of the in-memory representation of
+  # Items, Items don't need to know about which 'type' they are.
   class Library
     include Editable
     include Sluggable
@@ -22,11 +29,13 @@ module RobinCMS
         extend CollectionLibrary
       when "data"
         extend DataLibrary
+      when "singular"
+        extend SingularLibrary
       end
     end
 
     def blank
-      Item.new(nil, **@schema)
+      Item.new(nil, {}, **@schema)
     end
 
     def create_static(filename, tempfile)
@@ -79,5 +88,21 @@ module RobinCMS
     def kind
       @schema[:id]
     end
+
+    def type
+      @schema[:type]
+    end
+
+    def collection?
+      type == "collection"
+    end
+
+    def data?
+      type == "data"
+    end
+
+    def singular?
+      type == "singular"
+    end
   end
 end

data/lib/robin_cms/singular_library.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module RobinCMS
+  module SingularLibrary
+    # Since there is only one of these, give it the special id 0.
+    ID = 0
+
+    def self.extended(target)
+      # Since singular files can't be created or delete by users, create an
+      # empty one automatically if it doesn't already exist.
+
+      filename = target.schema[:id]
+      filetype = target.schema[:filetype]
+      filepath = File.join(target.schema[:location], "#{filename}.#{filetype}")
+
+      return if File.exist?(filepath)
+
+      FileUtils.mkdir_p(File.dirname(filepath))
+      item = Item.new(nil, {title: target.schema[:label]}, **target.schema)
+      item.update_timestamps!
+      serialized = YAML.dump(item.frontmatter, stringify_names: true)
+      File.write(filepath, serialized)
+    end
+
+    def create(_attributes = nil)
+      raise InvalidOperationError, "Invalid operation for Singular item"
+    end
+
+    def find_one(_id = nil)
+      # Ignore the id parameter. For singular libraries, there is only a single
+      # item. The id parameter is left for API compatibility with the other
+      # library types.
+
+      item = YAML.load_file(filepath, symbolize_names: true, permitted_classes: [Date])
+
+      return nil unless item
+
+      Item.new(ID, item, **@schema)
+    end
+
+    def all
+      # Returns an array of the only item. For API compatibility with the other
+      # library types.
+      [find_one].compact
+    end
+
+    def write(item)
+      FileUtils.mkdir_p(File.dirname(filepath))
+      FileUtils.touch(filepath)
+
+      item.update_timestamps!
+      serialized = YAML.dump(item.frontmatter, stringify_names: true)
+      File.write(filepath, serialized)
+
+      filepath
+    end
+
+    def delete(_id = nil)
+      raise InvalidOperationError, "Invalid operation for Singular item"
+    end
+
+    private
+
+    def filepath
+      File.join(@schema[:location], "#{@schema[:id]}.#{@schema[:filetype]}")
+    end
+  end
+end

data/lib/robin_cms/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RobinCMS
-  VERSION = "0.1.7"
+  VERSION = "0.3.0"
 end

data/lib/robin_cms/views/change_password.erb

@@ -16,7 +16,7 @@
   </div>
   <%= erb :flash %>
   <footer class="controls --align-right">
-    <a href="<%= root_url %>">Back</a>
+    <a href="<%= home_url %>">Back</a>
     <button type="submit">Update</button>
   </footer>
 </form>

data/lib/robin_cms/views/image_field.erb

@@ -9,7 +9,6 @@
   initial values. This one probably needs to be fixed.
 %>
 <img
-  id="image-preview"
   class="image-preview"
   src="<%= item_image_url(@item) %>"
   alt="<%= @item.image_alt %>"

data/lib/robin_cms/views/layout.erb

@@ -19,7 +19,7 @@
     <% if session[:auth_user] %>
       <header id="site-header">
         <span class="controls">
-          <h1><a href="<%= root_url %>"><%= @config[:title] %> admin</a></h1>
+          <h1><a href="<%= home_url %>"><%= @config[:title] %> admin</a></h1>
         </span>
         <span class="controls --gap-md">
           <a href="<%= @config[:url] %>" target="_blank">
@@ -35,7 +35,13 @@
         </span>
       </header>
     <% end %>
+
     <main id="site-content">
+      <% if session[:auth_user] %>
+        <header class="card --clear">
+          <%= erb :nav %>
+        </header>
+      <% end %>
       <%= yield %>
       <footer id="site-footer" class="card --clear">
         <%= erb :"logo.svg" %>
@@ -46,6 +52,7 @@
         </p>
       </footer>
     </main>
+
     <dialog id="successdialog" class="card">
       <h2>Success!</h2>
       <p><%= flash[:success_dialog] %></p>
@@ -55,6 +62,7 @@
         </form>
       </div>
     </dialog>
+
     <dialog id="errordialog" class="card">
       <h2>Oops, something went wrong.</h2>
       <p><%= flash[:error_dialog] %></p>
@@ -65,6 +73,7 @@
       </div>
     </dialog>
   </body>
+
   <script>
     const image = document.getElementById("__field_image")
     if (image) {

data/lib/robin_cms/views/library.erb

@@ -1,6 +1,3 @@
-<header class="card --clear">
-  <%= erb :nav %>
-</header>
 <div class="card">
   <% if @library[:description] %>
     <p><%= @library[:description] %></p>
@@ -13,7 +10,9 @@
     </form>
   <% end %>
 </div>
+
 <%= erb :filter_form %>
+
 <% if @items.empty? %>
   <div class="no-items">
     Nothing to show.
@@ -55,12 +54,12 @@
           <% end %>
           <td class="date">
             <a href="<%= library_item_url(@library, item) %>">
-              <%= item.created_at.strftime("%b %d, %Y") %>
+              <%= item.created_at&.strftime("%b %d, %Y") %>
             </a>
           </td>
           <td class="date">
             <a href="<%= library_item_url(@library, item) %>">
-              <%= item.updated_at.strftime("%b %d, %Y") %>
+              <%= item.updated_at&.strftime("%b %d, %Y") %>
             </a>
           </td>
         </tr>

data/lib/robin_cms/views/library_actions.erb

@@ -1,5 +1,7 @@
 <span class="controls">
-  <a href="<%= library_url(@library) %>">Back</a>
+  <% unless @library.singular? %>
+    <a href="<%= library_url(@library) %>">Back</a>
+  <% end %>
   <button form="<%= safe_id(@item.id, 'edit_item') %>" type="submit">Save</button>
   <%= erb :delete_dialog if has_delete %>
 </span>

data/lib/robin_cms/views/library_item.erb

@@ -4,6 +4,7 @@
   </h2>
   <%= erb :library_actions, locals: { has_delete: @item.can_delete? } %>
 </header>
+
 <form
   id="<%= safe_id(@item.id, 'edit_item') %>"
   class="card"
@@ -19,7 +20,7 @@
     <div class="field">
       <%=
         case field[:type]
-        when "text", "date", "number", "color", "email", "url"
+        when "text", "date", "number", "color", "email", "url", "array"
           erb :input_field, locals: { field: field }
         when "hidden"
           erb :hidden_field, locals: { field: field }
@@ -28,7 +29,7 @@
         when "image"
           erb :image_field, locals: { field: field }
         when "richtext"
-          erb :richtext_field, locals: { field: field }
+          erb :richtext_field, locals: { field: field, library: @library }
         else
           ""
         end

data/lib/robin_cms/views/new_tab.svg.erb

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
 <svg fill="#000000" width="12px" height="12px" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
   <path fill-rule="evenodd" d="M5,2 L7,2 C7.55228475,2 8,2.44771525 8,3 C8,3.51283584 7.61395981,3.93550716 7.11662113,3.99327227 L7,4 L5,4 C4.48716416,4 4.06449284,4.38604019 4.00672773,4.88337887 L4,5 L4,19 C4,19.5128358 4.38604019,19.9355072 4.88337887,19.9932723 L5,20 L19,20 C19.5128358,20 19.9355072,19.6139598 19.9932723,19.1166211 L20,19 L20,17 C20,16.4477153 20.4477153,16 21,16 C21.5128358,16 21.9355072,16.3860402 21.9932723,16.8833789 L22,17 L22,19 C22,20.5976809 20.75108,21.9036609 19.1762728,21.9949073 L19,22 L5,22 C3.40231912,22 2.09633912,20.75108 2.00509269,19.1762728 L2,19 L2,5 C2,3.40231912 3.24891996,2.09633912 4.82372721,2.00509269 L5,2 L7,2 L5,2 Z M21,2 L21.081,2.003 L21.2007258,2.02024007 L21.2007258,2.02024007 L21.3121425,2.04973809 L21.3121425,2.04973809 L21.4232215,2.09367336 L21.5207088,2.14599545 L21.5207088,2.14599545 L21.6167501,2.21278596 L21.7071068,2.29289322 L21.7071068,2.29289322 L21.8036654,2.40469339 L21.8036654,2.40469339 L21.8753288,2.5159379 L21.9063462,2.57690085 L21.9063462,2.57690085 L21.9401141,2.65834962 L21.9401141,2.65834962 L21.9641549,2.73400703 L21.9641549,2.73400703 L21.9930928,2.8819045 L21.9930928,2.8819045 L22,3 L22,3 L22,9 C22,9.55228475 21.5522847,10 21,10 C20.4477153,10 20,9.55228475 20,9 L20,5.414 L13.7071068,11.7071068 C13.3466228,12.0675907 12.7793918,12.0953203 12.3871006,11.7902954 L12.2928932,11.7071068 C11.9324093,11.3466228 11.9046797,10.7793918 12.2097046,10.3871006 L12.2928932,10.2928932 L18.584,4 L15,4 C14.4477153,4 14,3.55228475 14,3 C14,2.44771525 14.4477153,2 15,2 L21,2 Z"/>
 </svg>

data/lib/robin_cms/views/profile.erb

@@ -4,7 +4,7 @@
 <section class="card">
   <p>You are currently logged in as <b><%= @username %></b>.</p>
   <div class="controls --align-right">
-    <a href="<%= root_url %>">Back</a>
+    <a href="<%= home_url %>">Back</a>
     <form action="<%= change_password_url %>">
       <button type="submit">Change password</button>
     </form>

data/lib/robin_cms/views/richtext_field.erb

@@ -1,10 +1,96 @@
 <link rel="stylesheet" type="text/css" href="https://unpkg.com/trix@2.0.8/dist/trix.css">
+
+<style>
+  <%= erb :"trix.css" %>
+</style>
+
 <script type="text/javascript" src="https://unpkg.com/trix@2.0.8/dist/trix.umd.min.js"></script>
+<script>
+  addEventListener("trix-before-initialize", function () {
+    Trix.config.attachments.preview.caption = false;
+    Trix.config.attachments.file.caption = false;
+  });
+
+  addEventListener("trix-attachment-add", function (e) {
+    if (e.attachment.file) {
+      uploadFileAttachment(e.attachment);
+    }
+  });
+
+  addEventListener("trix-attachment-remove", function (e) {
+    if (e.attachment.file) {
+      removeFile(e.attachment);
+    }
+  });
+
+  function uploadFileAttachment(attachment) {
+    uploadFile(attachment.file, setProgress, setAttributes);
+
+    function setProgress(progress) {
+      attachment.setUploadProgress(progress); 
+    }
+
+    function setAttributes(attributes) {
+      attachment.setAttributes(attributes);
+    }
+  }
+
+  function uploadFile(file, progressCallback, successCallback) {
+    var formData = new FormData();
+    formData.append("key", createStorageKey(file));
+    formData.append("Content-Type", file.type);
+    formData.append("file", file);
+
+    var xhr = new XMLHttpRequest();
+
+    xhr.open("POST", "<%= library_attachment_url(library) %>", true);
+
+    xhr.upload.addEventListener("progress", function (e) {
+      var progress = e.loaded / e.total * 100;
+      progressCallback(progress);
+    });
+
+    xhr.addEventListener("load", function (e) {
+      if (xhr.status == 200) {
+        var res = JSON.parse(xhr.response);
+        var attributes = {
+          url: res.url,
+          href: res.url + "?content-disposition=attachment"
+        };
+        successCallback(attributes);
+      }
+    });
+
+    xhr.send(formData);
+  }
+
+  function removeFile(attachment) {
+    var url = attachment.getAttribute("url");
+    var parts = url.split("/");
+    var key = parts[parts.length - 1];
+
+    var formData = new FormData();
+    formData.append("key", key);
+
+    var xhr = new XMLHttpRequest();
+
+    xhr.open("POST", "<%= delete_library_attachment_url(library) %>", true); 
+    xhr.send(formData);
+  }
+
+  function createStorageKey(file) {
+    var date = new Date();
+    var day = date.toISOString().slice(0, 10);
+    return date.getTime() + "-" + file.name;
+  }
+</script>
+
 <%= erb :field_label, locals: { field: field } %>
+<%# TODO: label for attribute doesn't reference correct id %>
 <input
   id="richtext-content"
   type="hidden"
   name="<%= field[:id] %>"
-  value="<%= @item.field_value_or_default(field[:id]) %>"
+  value="<%= escape_for_trix(@item.field_value_or_default(field[:id])) %>"
 >
-<trix-editor input="richtext-content"></trix-editor>
+<trix-editor class="trix-content" input="richtext-content"></trix-editor>

data/lib/robin_cms/views/select_field.erb

@@ -7,7 +7,7 @@
   <% for option in field[:options] %>
     <option
       value="<%= option[:value] %>"
-      <% if option[:value].to_s == @item.published?.to_s %>
+      <% if option[:value].to_s == @item.field_value_or_default(field[:id]) %>
         selected
       <% end %>
     >

data/lib/robin_cms/views/stylesheet.css.erb

@@ -194,7 +194,7 @@ select {
 input,
 select,
 trix-toolbar,
-img#image-preview {
+img.image-preview {
   display: block;
   margin-top: var(--padding-xs);
 }
@@ -425,7 +425,6 @@ hr {
 /* trix editor overrides */
 
 trix-editor {
-  height: 16rem;
   border: 1px solid var(--border-color) !important;
   border-radius: var(--border-radius) !important;
   box-shadow: var(--box-shadow-input);
@@ -446,3 +445,4 @@ trix-editor {
 .trix-button.trix-active {
   background: var(--accent-color-light) !important;
 }
+

data/lib/robin_cms/views/trix.css.erb

@@ -0,0 +1,75 @@
+.trix-content {
+  line-height: 1.5; }
+  .trix-content * {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0; }
+  .trix-content h1 {
+    font-size: 1.2em;
+    line-height: 1.2; }
+  .trix-content blockquote {
+    border: 0 solid #ccc;
+    border-left-width: 0.3em;
+    margin-left: 0.3em;
+    padding-left: 0.6em; }
+  .trix-content [dir=rtl] blockquote,
+  .trix-content blockquote[dir=rtl] {
+    border-width: 0;
+    border-right-width: 0.3em;
+    margin-right: 0.3em;
+    padding-right: 0.6em; }
+  .trix-content li {
+    margin-left: 1em; }
+  .trix-content [dir=rtl] li {
+    margin-right: 1em; }
+  .trix-content pre {
+    display: inline-block;
+    width: 100%;
+    vertical-align: top;
+    font-family: monospace;
+    font-size: 0.9em;
+    padding: 0.5em;
+    white-space: pre;
+    background-color: #eee;
+    overflow-x: auto; }
+  .trix-content img {
+    max-width: 100%;
+    height: auto; }
+  .trix-content .attachment {
+    display: inline-block;
+    position: relative;
+    max-width: 100%; }
+    .trix-content .attachment a {
+      color: inherit;
+      text-decoration: none; }
+      .trix-content .attachment a:hover, .trix-content .attachment a:visited:hover {
+        color: inherit; }
+  .trix-content .attachment__caption {
+    text-align: center; }
+    .trix-content .attachment__caption .attachment__name + .attachment__size::before {
+      content: ' \2022 '; }
+  .trix-content .attachment--preview {
+    width: 50%;
+    text-align: center; }
+    .trix-content .attachment--preview .attachment__caption {
+      color: #666;
+      font-size: 0.9em;
+      line-height: 1.2; }
+  .trix-content .attachment--file {
+    color: #333;
+    line-height: 1;
+    margin: 0 2px 2px 2px;
+    padding: 0.4em 1em;
+    border: 1px solid #bbb;
+    border-radius: 5px; }
+  .trix-content .attachment-gallery {
+    display: flex;
+    flex-wrap: wrap;
+    position: relative; }
+    .trix-content .attachment-gallery .attachment {
+      flex: 1 0 33%;
+      padding: 0 0.5em;
+      max-width: 33%; }
+    .trix-content .attachment-gallery.attachment-gallery--2 .attachment, .trix-content .attachment-gallery.attachment-gallery--4 .attachment {
+      flex-basis: 50%;
+      max-width: 50%; }

data/lib/robin_cms.rb

@@ -23,10 +23,14 @@ module RobinCMS
 
   class ConversionError < StandardError
   end
+
+  class InvalidOperationError < StandardError
+  end
 end
 
 require_relative "robin_cms/version"
 require_relative "robin_cms/configuration"
+require_relative "robin_cms/configuration_schema"
 require_relative "robin_cms/editable"
 require_relative "robin_cms/sluggable"
 require_relative "robin_cms/queryable"
@@ -34,6 +38,7 @@ require_relative "robin_cms/item"
 require_relative "robin_cms/library"
 require_relative "robin_cms/collection_library"
 require_relative "robin_cms/data_library"
+require_relative "robin_cms/singular_library"
 require_relative "robin_cms/item"
 require_relative "robin_cms/auth"
 require_relative "robin_cms/flash"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: robin_cms
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.3.0
 platform: ruby
 authors:
 - Aron Lebani
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-25 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bcrypt
@@ -80,8 +80,8 @@ files:
 - lib/robin_cms/auth.rb
 - lib/robin_cms/cms.rb
 - lib/robin_cms/collection_library.rb
-- lib/robin_cms/configuration-schema.json
 - lib/robin_cms/configuration.rb
+- lib/robin_cms/configuration_schema.rb
 - lib/robin_cms/data_library.rb
 - lib/robin_cms/editable.rb
 - lib/robin_cms/flash.rb
@@ -89,6 +89,7 @@ files:
 - lib/robin_cms/item.rb
 - lib/robin_cms/library.rb
 - lib/robin_cms/queryable.rb
+- lib/robin_cms/singular_library.rb
 - lib/robin_cms/sluggable.rb
 - lib/robin_cms/version.rb
 - lib/robin_cms/views/change_password.erb
@@ -112,6 +113,7 @@ files:
 - lib/robin_cms/views/richtext_field.erb
 - lib/robin_cms/views/select_field.erb
 - lib/robin_cms/views/stylesheet.css.erb
+- lib/robin_cms/views/trix.css.erb
 homepage: https://robincms.org
 licenses:
 - MIT
@@ -133,7 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A simple, flat-file CMS for Static Site Generators.

data/lib/robin_cms/configuration-schema.json

@@ -1,120 +0,0 @@
-{
-	"$schema": "http://json-schema.org/draft-06/schema#",
-	"title": "RobinCMS configuration schema",
-	"type": "object",
-	"required": ["url", "libraries"],
-	"properties": {
-		"title": { "type": "string" },
-		"url": { "type": "string" },
-		"build_command": { "type": "string" },
-		"accent_color": {
-			"type": "string",
-			"pattern": "^\#{1}[a-fA-F0-9]{6}"
-		},
-		"libraries": {
-			"type": "array",
-			"items": {
-				"anyOf": [
-					{ "$ref": "#/$defs/library_schema" },
-					{ "$ref": "#/$defs/data_schema" }
-				]
-			}
-		}
-	},
-	"$defs": {
-		"options_schema": {
-			"type": "array",
-			"items": {
-				"type": "object",
-				"required": ["label", "value"],
-				"properties": {
-					"label": { "type": "string" },
-					"value": { "type": "string" }
-				}
-			}
-		},
-		"image_dimensions_schema": { "type": "string", "pattern": "^[0-9]+x[0-9]+$" },
-		"image_filetype_schema": { "type": "string", "enum": ["png", "jpg"] },
-		"library_schema": {
-			"type": "object",
-			"required": ["id", "label", "label_singular"],
-			"properties": {
-				"id": { "type": "string" },
-				"type": { "type": "string", "const": "collection" },
-				"filetype": { "type": "string", "enum": ["html"] },
-				"label": { "type": "string" },
-				"label_singular": { "type": "string" },
-				"location": { "type": "string" },
-				"static_location": { "type": "string" },
-				"description": { "type": "string" },
-				"can_create": { "type": "boolean" },
-				"can_delete": { "type": "boolean" },
-				"pattern": { "type": "string" },
-				"display_name_pattern": { "type": "string" },
-				"fields": {
-					"type": "array",
-					"items": {
-						"type": "object",
-						"required": ["id", "label"],
-						"properties": {
-							"id": { "type": "string" },
-							"label": { "type": "string" },
-							"type": {
-								"type": "string",
-								"enum": ["text", "richtext", "date", "hidden", "number", "color", "email", "url", "select", "image"]
-							},
-							"default": { "type": "string" },
-							"required": { "type": "boolean" },
-							"readonly": { "type": "boolean" },
-							"options": { "$ref": "#/$defs/options_schema" },
-							"dimensions": { "$ref": "#/$defs/image_dimensions_schema" },
-							"filetype": { "$ref": "#/$defs/image_filetype_schema" },
-							"description": { "type": "string" },
-							"order": { "type": "number" }
-						}
-					}
-				}
-			}
-		},
-		"data_schema": {
-			"type": "object",
-			"required": ["id", "label", "label_singular"],
-			"properties": {
-				"id": { "type": "string" },
-				"type": { "type": "string", "const": "data" },
-				"filetype": { "type": "string", "enum": ["yml"] },
-				"label": { "type": "string" },
-				"label_singular": { "type": "string" },
-				"location": { "type": "string" },
-				"static_location": { "type": "string" },
-				"description": { "type": "string" },
-				"can_create": { "type": "boolean" },
-				"can_delete": { "type": "boolean" },
-				"pattern": { "type": "string" },
-				"display_name_pattern": { "type": "string" },
-				"fields": {
-					"type": "array",
-					"items": {
-						"type": "object",
-						"required": ["id", "label"],
-						"properties": {
-							"id": { "type": "string" },
-							"label": { "type": "string" },
-							"type": {
-								"type": "string",
-								"enum": ["text", "date", "hidden", "number", "color", "email", "url", "select", "image"]
-							},
-							"default": { "type": "string" },
-							"required": { "type": "boolean" },
-							"readonly": { "type": "boolean" },
-							"options": { "$ref": "#/$defs/options_schema" },
-							"dimensions": { "$ref": "#/$defs/image_dimensions_schema" },
-							"filetype": { "$ref": "#/$defs/image_filetype_schema" },
-							"description": { "type": "string" }
-						}
-					}
-				}
-			}
-		}
-	}
-}