helios-press 0.1.0

data/app/models/helios/press/block_image.rb

@@ -0,0 +1,16 @@
+module Helios
+  module Press
+    class BlockImage < ActiveRecord::Base
+      self.table_name = "helios_press_block_images"
+
+      belongs_to :block, class_name: "Helios::Press::Block", touch: true
+
+      has_one_attached :file
+
+      validates :position, presence: true, numericality: { only_integer: true, greater_than_or_equal_to: 0 }
+      validates :file, presence: true
+
+      acts_as_list scope: :block
+    end
+  end
+end

data/app/models/helios/press/post.rb

@@ -0,0 +1,39 @@
+module Helios
+  module Press
+    class Post < ActiveRecord::Base
+      self.table_name = "helios_press_posts"
+
+      has_many :blocks, -> { order(position: :asc) },
+               class_name: "Helios::Press::Block",
+               foreign_key: :post_id,
+               dependent: :destroy
+
+      accepts_nested_attributes_for :blocks, allow_destroy: true
+
+      validates :name, presence: true
+      validates :slug, presence: true, uniqueness: true
+
+      before_validation :generate_slug, if: -> { name.present? && (slug.blank? || name_changed?) }
+
+      scope :published, -> { where(published: true) }
+      scope :reverse_sorted, -> { order(updated_at: :desc) }
+
+      private
+
+      def generate_slug
+        prefix = Helios::Press.configuration.post_slug_prefix
+        base_slug = name.parameterize
+        base_slug = "#{prefix}#{base_slug}" if prefix.present?
+        candidate_slug = base_slug
+        counter = 1
+
+        while self.class.where(slug: candidate_slug).where.not(id: id).exists?
+          candidate_slug = "#{base_slug}-#{counter}"
+          counter += 1
+        end
+
+        self.slug = candidate_slug
+      end
+    end
+  end
+end

data/app/views/helios/press/admin/blocks/_block.html.erb

@@ -0,0 +1,25 @@
+<div id="block-<%= block.id %>"
+     class="content-block"
+     data-helios-press-blocks-target="block"
+     data-block-id="<%= block.id %>">
+
+  <!-- Drag handle in left margin -->
+  <div class="drag-handle">
+    <i class="bi bi-grip-vertical"></i>
+  </div>
+
+  <div class="block-content">
+    <% case block.block_type %>
+    <% when "text" %>
+      <%= render "helios/press/admin/blocks/text_block", block: block, post: post %>
+    <% when "image_container" %>
+      <%= render "helios/press/admin/blocks/image_block", block: block, post: post %>
+    <% when "video_container" %>
+      <% if Helios::Press.videos_enabled? %>
+        <%= render "helios/press/admin/blocks/video_block", block: block, post: post %>
+      <% else %>
+        <div class="alert alert-warning mb-0">Video blocks require the helios-videos gem.</div>
+      <% end %>
+    <% end %>
+  </div>
+</div>

data/app/views/helios/press/admin/blocks/_image_block.html.erb

@@ -0,0 +1,47 @@
+<div data-controller="helios-press-image-block"
+     data-helios-press-image-block-id-value="<%= block.id %>"
+     data-helios-press-image-block-post-id-value="<%= post.id %>"
+     data-helios-press-image-block-base-url-value="<%= helios_press.admin_post_block_images_path(post, block) %>"
+     data-helios-press-image-block-block-url-value="<%= helios_press.admin_post_block_path(post, block) %>"
+     class="image-block-container">
+
+  <!-- Block Controls -->
+  <div class="d-flex justify-content-between align-items-center mb-2">
+    <div class="d-flex align-items-center gap-2">
+      <label class="form-label mb-0 small">Images per row:</label>
+      <select class="form-select form-select-sm"
+              style="width: auto;"
+              data-action="change->helios-press-image-block#updateColumns"
+              data-helios-press-image-block-target="columnsSelect">
+        <% (1..6).each do |n| %>
+          <option value="<%= n %>" <%= "selected" if (block.columns || 3) == n %>><%= n %></option>
+        <% end %>
+      </select>
+    </div>
+    <button type="button"
+            class="btn btn-sm btn-danger"
+            data-action="click->helios-press-blocks#deleteBlock">
+      Delete Block
+    </button>
+  </div>
+
+  <!-- Images Grid -->
+  <div class="images-grid"
+       data-helios-press-image-block-target="grid"
+       data-columns="<%= block.columns || 3 %>"
+       style="--grid-columns: <%= block.columns || 3 %>;">
+    <% block.block_images.each do |block_image| %>
+      <%= render "helios/press/admin/blocks/image_item", block_image: block_image, block: block, post: post %>
+    <% end %>
+
+    <!-- Dropzone as a grid item -->
+    <div class="image-dropzone"
+         data-helios-press-image-block-target="dropzone"
+         data-action="dragover->helios-press-image-block#handleDragOver
+                      dragleave->helios-press-image-block#handleDragLeave
+                      drop->helios-press-image-block#handleDrop">
+      <i class="bi bi-plus-circle"></i>
+      <p>Drop to add</p>
+    </div>
+  </div>
+</div>

data/app/views/helios/press/admin/blocks/_image_item.html.erb

@@ -0,0 +1,38 @@
+<div class="image-item"
+     data-helios-press-image-block-target="image"
+     data-image-id="<%= block_image.id %>">
+
+  <!-- Image -->
+  <div class="image-wrapper">
+    <% if block_image.file.attached? %>
+      <%= image_tag block_image.file.variant(resize_to_limit: [800, 800]), class: "block-image" %>
+    <% end %>
+
+    <!-- Delete button -->
+    <button type="button"
+            class="btn btn-sm btn-danger image-delete"
+            data-action="click->helios-press-image-block#deleteImage">
+      <i class="bi bi-trash"></i>
+    </button>
+  </div>
+
+  <!-- Caption -->
+  <div class="image-caption">
+    <!-- View Mode -->
+    <div class="caption-view"
+         data-image-id="<%= block_image.id %>"
+         data-action="click->helios-press-image-block#editCaption">
+      <%= block_image.caption.presence || "Click to add caption..." %>
+    </div>
+
+    <!-- Edit Mode -->
+    <div class="caption-edit d-none">
+      <input type="text"
+             class="form-control form-control-sm"
+             value="<%= block_image.caption %>"
+             placeholder="Enter caption..."
+             data-image-id="<%= block_image.id %>"
+             data-action="blur->helios-press-image-block#saveCaption keydown.enter->helios-press-image-block#saveCaption keydown.esc->helios-press-image-block#cancelCaption">
+    </div>
+  </div>
+</div>

data/app/views/helios/press/admin/blocks/_text_block.html.erb

@@ -0,0 +1,39 @@
+<div data-controller="helios-press-text-block"
+     data-helios-press-text-block-id-value="<%= block.id %>"
+     data-helios-press-text-block-post-id-value="<%= post.id %>"
+     data-helios-press-text-block-base-url-value="<%= helios_press.admin_post_block_path(post, block) %>"
+     data-helios-press-text-block-mode-value="view">
+
+  <!-- View Mode -->
+  <div data-helios-press-text-block-target="viewMode"
+       data-action="dblclick->helios-press-text-block#enterEditMode"
+       class="block-view-mode">
+    <% if block.content.present? %>
+      <%= helios_press_process_rich_text_links(block.content) %>
+    <% else %>
+      <p class="text-muted fst-italic">Double-click to add content...</p>
+    <% end %>
+  </div>
+
+  <!-- Edit Mode -->
+  <div data-helios-press-text-block-target="editMode" class="block-edit-mode d-none">
+    <%= form_with(model: block,
+                  url: helios_press.admin_post_block_path(post, block),
+                  data: { helios_press_text_block_target: "form" }) do |f| %>
+      <%= f.rich_text_area :content,
+                          data: { helios_press_text_block_target: "editor" },
+                          class: "form-control mb-2" %>
+      <div class="d-flex gap-2">
+        <%= f.submit "Save", class: "btn btn-primary btn-sm", data: { action: "click->helios-press-text-block#save" } %>
+        <button type="button"
+                class="btn btn-secondary btn-sm"
+                data-action="click->helios-press-text-block#cancelEdit">Cancel</button>
+        <button type="button"
+                class="btn btn-danger btn-sm"
+                data-action="click->helios-press-blocks#deleteBlock">
+          Delete
+        </button>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/helios/press/admin/blocks/_video_block.html.erb

@@ -0,0 +1,43 @@
+<% if block.respond_to?(:video) && block.video.present? %>
+  <% video = block.video %>
+  <div data-controller="helios-video-block"
+       data-helios-video-block-video-id-value="<%= video.id %>"
+       class="video-block-container">
+    <!-- Block Controls -->
+    <div class="d-flex justify-content-end mb-2">
+      <button type="button"
+              class="btn btn-sm btn-danger"
+              data-action="click->helios-press-blocks#deleteBlock">
+        Delete Block
+      </button>
+    </div>
+
+    <!-- Video Name (editable) -->
+    <div class="mb-3">
+      <!-- View Mode -->
+      <div class="name-view"
+           data-action="click->helios-video-block#editName"
+           style="cursor: pointer; padding: 0.5rem; border: 1px solid transparent; border-radius: 0.25rem;">
+        <%= video.name.presence || "Click to add name..." %>
+      </div>
+
+      <!-- Edit Mode -->
+      <div class="name-edit d-none">
+        <input type="text"
+               class="form-control form-control-sm"
+               value="<%= video.name %>"
+               placeholder="Enter video name..."
+               data-action="blur->helios-video-block#saveName keydown.enter->helios-video-block#saveName keydown.esc->helios-video-block#cancelName">
+      </div>
+    </div>
+
+    <!-- Video Player -->
+    <div class="video-player-wrapper">
+      <%= video.player_component.html_safe %>
+    </div>
+  </div>
+<% else %>
+  <div class="alert alert-warning mb-0">
+    No video found for this block.
+  </div>
+<% end %>

data/app/views/helios/press/admin/posts/_blocks_container.html.erb

@@ -0,0 +1,27 @@
+<div id="blocks-container" data-helios-press-blocks-target="blocksContainer">
+  <!-- Placeholder at the top -->
+  <div class="block-placeholder"
+       data-helios-press-blocks-target="placeholder"
+       data-position="0"
+       data-action="click->helios-press-blocks#addBlock
+                    dragover->helios-press-blocks#handlePlaceholderDragOver
+                    dragleave->helios-press-blocks#handlePlaceholderDragLeave
+                    drop->helios-press-blocks#handlePlaceholderDrop">
+    <div class="placeholder-line"></div>
+  </div>
+
+  <% post.blocks.each do |block| %>
+    <%= render "helios/press/admin/blocks/block", block: block, post: post %>
+
+    <!-- Placeholder after each block -->
+    <div class="block-placeholder"
+         data-helios-press-blocks-target="placeholder"
+         data-position="<%= block.position + 1 %>"
+         data-action="click->helios-press-blocks#addBlock
+                      dragover->helios-press-blocks#handlePlaceholderDragOver
+                      dragleave->helios-press-blocks#handlePlaceholderDragLeave
+                      drop->helios-press-blocks#handlePlaceholderDrop">
+      <div class="placeholder-line"></div>
+    </div>
+  <% end %>
+</div>

data/app/views/helios/press/admin/posts/_form.html.erb

@@ -0,0 +1,48 @@
+<%= form_with(model: post, url: post.persisted? ? helios_press.admin_post_path(post) : helios_press.admin_posts_path, local: true) do |form| %>
+  <% if post.errors.any? %>
+    <div class="alert alert-danger">
+      <h4><%= pluralize(post.errors.count, "error") %> prohibited this post from being saved:</h4>
+      <ul class="mb-0">
+        <% post.errors.full_messages.each do |message| %>
+          <li><%= message %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div class="mb-3">
+    <%= form.label :name, "Title", class: "form-label" %>
+    <%= form.text_field :name, class: "form-control", placeholder: "Enter post title" %>
+  </div>
+
+  <div class="mb-3">
+    <%= form.label :slug, "Slug", class: "form-label" %>
+    <%= form.text_field :slug, class: "form-control", placeholder: "abc/xyz" %>
+  </div>
+
+  <div class="mb-3">
+    <%= form.label :description, class: "form-label" %>
+    <%= form.text_area :description, class: "form-control", rows: 3, placeholder: "Brief description for social media previews" %>
+    <div class="form-text">This description will appear when the post is shared on social media</div>
+  </div>
+
+  <div class="mb-3">
+    <%= form.label :keywords, class: "form-label" %>
+    <%= form.text_field :keywords, class: "form-control", placeholder: "Separate keywords with commas" %>
+  </div>
+
+  <div class="mb-3">
+    <div class="form-check">
+      <%= form.check_box :published, class: "form-check-input" %>
+      <%= form.label :published, "Published", class: "form-check-label" %>
+    </div>
+  </div>
+
+  <div class="d-flex gap-2">
+    <%= form.submit "Save", class: "btn btn-primary" %>
+    <% if post.persisted? && !post.published? %>
+      <%= form.submit "Publish Now", name: "publish", class: "btn btn-success", data: { turbo_confirm: "Publish this post now?" } %>
+    <% end %>
+    <%= link_to "Cancel", helios_press.admin_posts_path, class: "btn btn-secondary" %>
+  </div>
+<% end %>

data/app/views/helios/press/admin/posts/edit.html.erb

@@ -0,0 +1,26 @@
+<div class="container py-5">
+  <div class="row">
+    <div class="col-lg-8">
+      <h1 class="mb-4">Edit Post</h1>
+
+      <!-- Basic Post Info -->
+      <div class="card mb-4">
+        <div class="card-body">
+          <%= render "form", post: @post %>
+        </div>
+      </div>
+
+      <!-- Blocks Editor -->
+      <div class="card">
+        <div class="card-header">
+          <h5 class="mb-0">Content Blocks</h5>
+        </div>
+        <div class="card-body">
+          <div data-controller="helios-press-blocks" data-helios-press-blocks-post-id-value="<%= @post.id %>" data-helios-press-blocks-base-url-value="<%= helios_press.admin_post_blocks_path(@post) %>">
+            <%= render "blocks_container", post: @post %>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>

data/app/views/helios/press/admin/posts/index.html.erb

@@ -0,0 +1,31 @@
+<div class="container py-5">
+  <div class="d-flex justify-content-between align-items-center mb-4">
+    <h1>Posts</h1>
+    <%= link_to "New Post", helios_press.new_admin_post_path, class: "btn btn-primary" %>
+  </div>
+
+  <% if @posts.any? %>
+    <div class="list-group">
+      <% @posts.each do |post| %>
+        <div class="list-group-item d-flex justify-content-between align-items-center">
+          <div>
+            <h5 class="mb-1">
+              <%= link_to post.name, helios_press.edit_admin_post_path(post) %>
+            </h5>
+            <small class="text-muted">/<%= post.slug %></small>
+            <% if post.published? %>
+              <span class="badge bg-success ms-2">Published</span>
+            <% else %>
+              <span class="badge bg-secondary ms-2">Draft</span>
+            <% end %>
+          </div>
+          <div>
+            <small class="text-muted"><%= post.updated_at.strftime("%m/%d/%y") %></small>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="text-muted">No posts yet. Create your first post!</p>
+  <% end %>
+</div>

data/app/views/helios/press/admin/posts/new.html.erb

@@ -0,0 +1,12 @@
+<div class="container py-5">
+  <div class="row">
+    <div class="col-lg-8">
+      <h1 class="mb-4">New Post</h1>
+      <div class="card">
+        <div class="card-body">
+          <%= render "form", post: @post %>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>

data/app/views/helios/press/posts/blocks/_image_container.html.erb

@@ -0,0 +1,18 @@
+<div class="image-block mb-5">
+  <div class="images-grid" style="--grid-columns: <%= block.columns || 3 %>;">
+    <% block.block_images.each do |block_image| %>
+      <div class="image-item">
+        <% if block_image.file.attached? %>
+          <%= image_tag block_image.file.variant(resize_to_limit: [1200, 1200]),
+                    class: "img-fluid rounded",
+                    alt: block_image.caption.presence || "" %>
+        <% end %>
+        <% if block_image.caption.present? %>
+          <p class="image-caption text-muted mt-2 small">
+            <%= block_image.caption %>
+          </p>
+        <% end %>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/helios/press/posts/blocks/_text.html.erb

@@ -0,0 +1,3 @@
+<div class="text-block mb-4">
+  <%= helios_press_process_rich_text_links(block.content) %>
+</div>

data/app/views/helios/press/posts/blocks/_video_container.html.erb

@@ -0,0 +1,12 @@
+<% if Helios::Press.videos_enabled? && block.respond_to?(:video) && block.video.present? %>
+  <% video = block.video %>
+  <div class="video-block mb-5">
+    <% if video.name.present? %>
+      <h3 class="h5 mb-3"><%= video.name %></h3>
+    <% end %>
+
+    <div class="video-player-wrapper">
+      <%= video.player_component.html_safe %>
+    </div>
+  </div>
+<% end %>

data/app/views/helios/press/posts/show.html.erb

@@ -0,0 +1,45 @@
+<% content_for :title, @post.name %>
+
+<% content_for :head do %>
+  <%
+    first_image_block = @post.blocks.find { |b| b.block_type == "image_container" && b.block_images.any? }
+  %>
+  <% if @post.keywords.present? %>
+    <meta name="keywords" content="<%= @post.keywords %>">
+  <% end %>
+
+  <meta property="og:title" content="<%= @post.name %>">
+  <meta property="og:type" content="article">
+  <meta property="og:url" content="<%= request.base_url %>/<%= @post.slug %>">
+  <% if @post.description.present? %>
+    <meta property="og:description" content="<%= @post.description %>">
+  <% end %>
+  <% if first_image_block&.block_images&.first&.file&.attached? %>
+    <meta property="og:image" content="<%= url_for(first_image_block.block_images.first.file.variant(resize_to_limit: [1200, 630])) %>">
+  <% end %>
+  <% if @post.published? %>
+    <meta property="article:published_time" content="<%= @post.created_at.iso8601 %>">
+    <meta property="article:modified_time" content="<%= @post.updated_at.iso8601 %>">
+  <% end %>
+<% end %>
+
+<div class="container my-5">
+  <article class="post">
+    <header class="post-header mb-5">
+      <h1 class="display-4 mb-3"><%= @post.name %></h1>
+      <p class="text-muted">
+        <time datetime="<%= @post.updated_at.iso8601 %>">
+          <%= @post.updated_at.strftime("%m/%d/%y") %>
+        </time>
+      </p>
+    </header>
+
+    <div class="post-content">
+      <% @post.blocks.each_with_index do |block, index| %>
+        <div id="block-<%= index %>">
+          <%= render "helios/press/posts/blocks/#{block.block_type}", block: block, block_index: index %>
+        </div>
+      <% end %>
+    </div>
+  </article>
+</div>

data/app/views/layouts/helios/press/admin.html.erb

@@ -0,0 +1 @@
+<%= render template: "layouts/application" %>

data/app/views/layouts/helios/press/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Helios press</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "helios/press/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,21 @@
+Helios::Press::Engine.routes.draw do
+  namespace :admin do
+    root to: "posts#index"
+    resources :posts do
+      resources :blocks, only: [:create, :update, :destroy] do
+        collection do
+          patch :reorder
+        end
+        resources :images, controller: "block_images", only: [:create, :update, :destroy] do
+          collection do
+            patch :reorder
+          end
+        end
+      end
+    end
+  end
+
+  namespace :api do
+    resources :posts, only: [:create]
+  end
+end

data/db/migrate/20250510000001_create_helios_press_posts.rb

@@ -0,0 +1,18 @@
+class CreateHeliosPressPosts < ActiveRecord::Migration[8.0]
+  def change
+    create_table :helios_press_posts do |t|
+      t.string :name, null: false
+      t.string :slug, null: false
+      t.text :description
+      t.string :keywords
+      t.boolean :published, default: false, null: false
+      t.string :external_id
+
+      t.timestamps
+    end
+
+    add_index :helios_press_posts, :slug, unique: true
+    add_index :helios_press_posts, :external_id, unique: true
+    add_index :helios_press_posts, :published
+  end
+end

data/db/migrate/20250510000002_create_helios_press_blocks.rb

@@ -0,0 +1,14 @@
+class CreateHeliosPressBlocks < ActiveRecord::Migration[8.0]
+  def change
+    create_table :helios_press_blocks do |t|
+      t.references :post, null: false, foreign_key: { to_table: :helios_press_posts }
+      t.string :block_type, null: false
+      t.integer :position, null: false
+      t.integer :columns, default: 3
+
+      t.timestamps
+    end
+
+    add_index :helios_press_blocks, [:post_id, :position]
+  end
+end

data/db/migrate/20250510000003_create_helios_press_block_images.rb

@@ -0,0 +1,13 @@
+class CreateHeliosPressBlockImages < ActiveRecord::Migration[8.0]
+  def change
+    create_table :helios_press_block_images do |t|
+      t.references :block, null: false, foreign_key: { to_table: :helios_press_blocks }
+      t.integer :position, null: false
+      t.text :caption
+
+      t.timestamps
+    end
+
+    add_index :helios_press_block_images, [:block_id, :position]
+  end
+end

data/lib/helios/press/configuration.rb

@@ -0,0 +1,17 @@
+module Helios
+  module Press
+    class Configuration
+      attr_accessor :admin_parent_controller,
+                    :api_parent_controller,
+                    :api_authentication,
+                    :post_slug_prefix
+
+      def initialize
+        @admin_parent_controller = "ApplicationController"
+        @api_parent_controller = "ActionController::API"
+        @api_authentication = nil
+        @post_slug_prefix = nil
+      end
+    end
+  end
+end

data/lib/helios/press/engine.rb

@@ -0,0 +1,11 @@
+module Helios
+  module Press
+    class Engine < ::Rails::Engine
+      isolate_namespace Helios::Press
+
+      initializer "helios_press.assets" do |app|
+        app.config.assets.precompile += %w[helios/press/blocks.css] if app.config.respond_to?(:assets)
+      end
+    end
+  end
+end

data/lib/helios/press/version.rb

@@ -0,0 +1,5 @@
+module Helios
+  module Press
+    VERSION = "0.1.0"
+  end
+end

data/lib/helios/press.rb

@@ -0,0 +1,23 @@
+require "helios/press/version"
+require "helios/press/engine"
+require "helios/press/configuration"
+require "helios-videos"
+require "helios-sitemap"
+
+module Helios
+  module Press
+    class << self
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def configure
+        yield(configuration)
+      end
+
+      def videos_enabled?
+        defined?(Helios::Videos)
+      end
+    end
+  end
+end

data/lib/tasks/helios/press_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :helios_press do
+#   # Task goes here
+# end