helios-press 0.1.0 → 0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3b7ae24fbb56776cc12ecba0e5c5f8c4fe86add758aceeddf4a2556233f65ad
-  data.tar.gz: 27ec84d4133ac49444df9b70f145214e1c57757f8098e19af4d3261271a08eef
+  metadata.gz: ff787a0ede62265b58f025dbcd37aab9b35203b691cd74252dfd6df108669fc2
+  data.tar.gz: 505c0b5583ebbb5c8277fcd2a295abcc12747c3cb1462ec770e53ccf29acdcd4
 SHA512:
-  metadata.gz: d0224ef4872b8727d78d1dc9e1aba083b254bf6380a0e1cf5ea5ffbd4b30a8903b1847253963620f7a2f84a4da93a621d31fba0a81b0297c7e70b9f68236fddb
-  data.tar.gz: 26d02bcc128f38ead744f8dacc50005caa749bb2f8da86249af09053aed2461766f32594e439242a4bf91765816dfcb6c5e3492d91281bf1d5a2a8a590c75b38
+  metadata.gz: fee9b6adf0321cf285cd49c2eda7446771c62e5b57a183962efcdf513026a82187602832fa1a8597c3e5aaa47790fc9dd6ca7944170541d2eeb949cce8710486
+  data.tar.gz: dfec9a5447b75c2536d8548daa69c530ba1db54d30e6fdffcec2bcfc0447d3ee129b57642ab0d9e67196aa33d6847f1958924aaf020bec6205fb297746ff5141

data/README.md

@@ -32,6 +32,9 @@ Helios::Press.configure do |config|
   # Parent controller for admin views (must provide authentication)
   config.admin_parent_controller = "Admin::BaseController"
 
+  # Parent controller for public views (blog index/show)
+  config.public_parent_controller = "ApplicationController"
+
   # Optional slug prefix for posts
   config.post_slug_prefix = nil  # e.g., "blog/" for /blog/my-post
 
@@ -49,16 +52,40 @@ end
 
 ## Routes
 
-Mount the engine:
+Helios::Press provides three independent engines that you can mount wherever you want:
+
+```ruby
+# Admin block editor — mount behind your auth
+mount Helios::Press::Admin::Engine, at: "/admin/press"
+
+# Public blog index/show — mount at your preferred public path
+mount Helios::Press::Public::Engine, at: "/blog"
+
+# API for external post ingestion
+mount Helios::Press::Api::Engine, at: "/api/press"
+```
+
+Mount only the engines you need. For example, if you only want the admin editor and will build your own public views:
 
 ```ruby
-mount Helios::Press::Engine, at: "/helios_press"
+mount Helios::Press::Admin::Engine, at: "/admin/press"
 ```
 
-This provides:
-- **Admin UI**: `/helios_press/admin/posts` - Full block editor
-- **API**: `POST /helios_press/api/posts` - Ingest posts from external sources
-- **Public**: Define your own catch-all route pointing to `Helios::Press::PostsController#show`
+### Routes provided
+
+**Admin Engine:**
+- `GET /` — Posts list
+- `GET /posts/new` — New post form
+- `GET /posts/:id/edit` — Block editor
+- `POST/PATCH/DELETE /posts/:id` — CRUD
+- Block and image sub-resources
+
+**Public Engine:**
+- `GET /` — Published posts index
+- `GET /:slug` — Single post view
+
+**API Engine:**
+- `POST /posts` — Upsert a post by `external_id`
 
 ## JavaScript Setup
 
@@ -69,15 +96,11 @@ import {
   HeliosPressBlocksController,
   HeliosPressTextBlockController,
   HeliosPressImageBlockController
-} from "helios-press"
+} from "helios/press"
 
 application.register("helios-press-blocks", HeliosPressBlocksController)
 application.register("helios-press-text-block", HeliosPressTextBlockController)
 application.register("helios-press-image-block", HeliosPressImageBlockController)
-
-// If using helios-videos:
-import { HeliosVideoBlockController } from "helios-videos"
-application.register("helios-video-block", HeliosVideoBlockController)
 ```
 
 **npm dependencies** (add to your host app's package.json):
@@ -86,13 +109,35 @@ application.register("helios-video-block", HeliosVideoBlockController)
 - `@rails/activestorage`
 - `trix` and `@rails/actiontext`
 
+### Vite
+
+If your host app uses Vite, add an alias so Vite can resolve the gem's JavaScript:
+
+```typescript
+// vite.config.mts
+resolve: {
+  alias: {
+    'helios/press': resolve(__dirname, '/path/to/helios-press/app/javascript/helios/press'),
+  },
+},
+```
+
+When using a local path gem, point to the local checkout. When using the published gem, point to the installed gem path (e.g., via `bundle show helios-press`).
+
 ## CSS
 
-Include the block editor styles in your asset pipeline:
+Include the block editor styles in your stylesheet:
+
+```scss
+@import 'helios_press_blocks';
+```
 
-```css
-/* In your application CSS */
-@import "helios/press/blocks";
+You can either symlink or copy the file from the gem:
+
+```bash
+# Symlink (local development)
+ln -s /path/to/helios-press/app/assets/stylesheets/helios/press/blocks.css \
+      app/assets/stylesheets/_helios_press_blocks.scss
 ```
 
 ## Block Types
@@ -103,7 +148,7 @@ Include the block editor styles in your asset pipeline:
 
 ## API Ingestion
 
-POST to `/helios_press/api/posts` with `X-API-Key` header:
+POST to your mounted API path with `X-API-Key` header:
 
 ```json
 {

data/app/controllers/helios/press/admin/base_controller.rb

@@ -1,8 +1,7 @@
 module Helios
   module Press
     module Admin
-      class BaseController < ::ApplicationController
-        layout "helios/press/admin"
+      class BaseController < Helios::Press.configuration.admin_parent_controller.constantize
       end
     end
   end

data/app/controllers/helios/press/admin/blocks_controller.rb

@@ -30,7 +30,7 @@ module Helios
 
             # Handle video upload for video_container blocks (when helios-videos is present)
             if @block.video_container? && params[:video_signed_id].present? && Helios::Press.videos_enabled?
-              video = Helios::Videos::Video.new(name: params[:video_name], block: @block)
+              video = Helios::Videos.video_class.new(name: params[:video_name], block: @block)
               video.video_file.attach(params[:video_signed_id])
               video.save!
             end

data/app/controllers/helios/press/admin/posts_controller.rb

@@ -23,7 +23,7 @@ module Helios
           @post = Post.new(post_params)
 
           if @post.save
-            redirect_to helios_press.edit_admin_post_path(@post), notice: "Post was successfully created."
+            redirect_to helios_press_admin.edit_post_path(@post), notice: "Post was successfully created."
           else
             render :new, status: :unprocessable_entity
           end
@@ -42,7 +42,7 @@ module Helios
           end
 
           if @post.update(update_params)
-            redirect_to helios_press.edit_admin_post_path(@post), notice: success_message
+            redirect_to helios_press_admin.edit_post_path(@post), notice: success_message
           else
             render :edit, status: :unprocessable_entity
           end
@@ -50,7 +50,7 @@ module Helios
 
         def destroy
           @post.destroy
-          redirect_to helios_press.admin_posts_path, notice: "Post was successfully deleted."
+          redirect_to helios_press_admin.posts_path, notice: "Post was successfully deleted."
         end
 
         private
@@ -63,8 +63,8 @@ module Helios
           params.require(:post).permit(:name, :published, :slug, :keywords, :description)
         end
 
-        def helios_press
-          Helios::Press::Engine.routes.url_helpers
+        def helios_press_admin
+          Helios::Press::Admin::Engine.routes.url_helpers
         end
       end
     end

data/app/controllers/helios/press/posts_controller.rb

@@ -1,6 +1,10 @@
 module Helios
   module Press
-    class PostsController < ::ApplicationController
+    class PostsController < Helios::Press.configuration.public_parent_controller.constantize
+      def index
+        @posts = Post.published.reverse_sorted
+      end
+
       def show
         @post = Post.published.find_by!(slug: params[:slug])
       end

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

@@ -11,6 +11,24 @@ module Helios
       validates :file, presence: true
 
       acts_as_list scope: :block
+
+      DOCUMENT_CONTENT_TYPES = %w[
+        application/pdf
+        application/msword
+        application/vnd.openxmlformats-officedocument.wordprocessingml.document
+      ].freeze
+
+      def svg?
+        file.attached? && file.content_type == "image/svg+xml"
+      end
+
+      def document?
+        file.attached? && DOCUMENT_CONTENT_TYPES.include?(file.content_type)
+      end
+
+      def variable?
+        file.attached? && file.variable?
+      end
     end
   end
 end

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

@@ -1,8 +1,8 @@
 <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) %>"
+     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 -->

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

@@ -2,10 +2,22 @@
      data-helios-press-image-block-target="image"
      data-image-id="<%= block_image.id %>">
 
-  <!-- Image -->
+  <!-- Image / Document -->
   <div class="image-wrapper">
     <% if block_image.file.attached? %>
-      <%= image_tag block_image.file.variant(resize_to_limit: [800, 800]), class: "block-image" %>
+      <% if block_image.svg? %>
+        <%= image_tag url_for(block_image.file), class: "block-image" %>
+      <% elsif block_image.document? %>
+        <div class="document-preview d-flex flex-column align-items-center justify-content-center h-100">
+          <i class="bi <%= block_image.file.content_type.include?('pdf') ? 'bi-file-earmark-pdf' : 'bi-file-earmark-word' %>" style="font-size: 3rem; color: #6c757d;"></i>
+          <small class="text-muted mt-1"><%= block_image.file.filename %></small>
+          <%= link_to "Download", url_for(block_image.file), class: "btn btn-sm btn-outline-secondary mt-1", download: true %>
+        </div>
+      <% elsif block_image.variable? %>
+        <%= image_tag block_image.file.variant(resize_to_limit: [800, 800]), class: "block-image" %>
+      <% else %>
+        <%= image_tag url_for(block_image.file), class: "block-image" %>
+      <% end %>
     <% end %>
 
     <!-- Delete button -->

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

@@ -1,7 +1,7 @@
 <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-base-url-value="<%= helios_press_admin.post_block_path(post, block) %>"
      data-helios-press-text-block-mode-value="view">
 
   <!-- View Mode -->
@@ -18,7 +18,7 @@
   <!-- 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),
+                  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" },

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

@@ -1,7 +1,10 @@
 <% if block.respond_to?(:video) && block.video.present? %>
   <% video = block.video %>
+  <% video_ready = video.key.present? && video.playback_urls.present? %>
   <div data-controller="helios-video-block"
        data-helios-video-block-video-id-value="<%= video.id %>"
+       data-helios-video-block-ready-value="<%= video_ready %>"
+       data-helios-video-block-status-url-value="<%= helios_videos.admin_video_path(video) %>"
        class="video-block-container">
     <!-- Block Controls -->
     <div class="d-flex justify-content-end mb-2">
@@ -32,12 +35,17 @@
     </div>
 
     <!-- Video Player -->
-    <div class="video-player-wrapper">
+    <div class="video-player-wrapper" data-helios-video-block-target="player">
       <%= video.player_component.html_safe %>
     </div>
   </div>
 <% else %>
-  <div class="alert alert-warning mb-0">
-    No video found for this block.
+  <div class="alert alert-warning mb-0 d-flex justify-content-between align-items-center">
+    <span>No video found for this block.</span>
+    <button type="button"
+            class="btn btn-sm btn-danger"
+            data-action="click->helios-press-blocks#deleteBlock">
+      Delete Block
+    </button>
   </div>
 <% end %>

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

@@ -1,4 +1,4 @@
-<%= form_with(model: post, url: post.persisted? ? helios_press.admin_post_path(post) : helios_press.admin_posts_path, local: true) do |form| %>
+<%= 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>
@@ -43,6 +43,6 @@
     <% 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" %>
+    <%= link_to "Cancel", helios_press_admin.posts_path, class: "btn btn-secondary" %>
   </div>
 <% end %>

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

@@ -16,7 +16,7 @@
           <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) %>">
+          <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>

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

@@ -1,30 +1,41 @@
 <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" %>
+    <%= link_to "New Post", helios_press_admin.new_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>
+    <table class="table">
+      <thead>
+        <tr>
+          <th>Title</th>
+          <th>Slug</th>
+          <th>Status</th>
+          <th>Last Updated</th>
+          <th>Actions</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @posts.each do |post| %>
+          <tr>
+            <td><%= link_to post.name, helios_press_admin.edit_post_path(post) %></td>
+            <td><small class="text-muted">/<%= post.slug %></small></td>
+            <td>
+              <% if post.published? %>
+                <span class="badge bg-success">Published</span>
+              <% else %>
+                <span class="badge bg-secondary">Draft</span>
+              <% end %>
+            </td>
+            <td><%= post.updated_at.strftime("%m/%d/%y") %></td>
+            <td>
+              <%= link_to "Edit", helios_press_admin.edit_post_path(post), class: "btn btn-sm btn-outline-primary" %>
+              <%= link_to "Delete", helios_press_admin.post_path(post), data: { turbo_method: :delete, turbo_confirm: "Are you sure?" }, class: "btn btn-sm btn-outline-danger" %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
   <% else %>
     <p class="text-muted">No posts yet. Create your first post!</p>
   <% end %>

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

@@ -3,9 +3,26 @@
     <% 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 || "" %>
+          <% if block_image.svg? %>
+            <%= image_tag url_for(block_image.file),
+                      class: "img-fluid rounded",
+                      alt: block_image.caption.presence || "" %>
+          <% elsif block_image.document? %>
+            <div class="document-download text-center p-3">
+              <i class="bi <%= block_image.file.content_type.include?('pdf') ? 'bi-file-earmark-pdf' : 'bi-file-earmark-word' %>" style="font-size: 3rem;"></i>
+              <p class="mt-2 mb-0">
+                <%= link_to block_image.file.filename, url_for(block_image.file), download: true %>
+              </p>
+            </div>
+          <% elsif block_image.variable? %>
+            <%= image_tag block_image.file.variant(resize_to_limit: [1200, 1200]),
+                      class: "img-fluid rounded",
+                      alt: block_image.caption.presence || "" %>
+          <% else %>
+            <%= image_tag url_for(block_image.file),
+                      class: "img-fluid rounded",
+                      alt: block_image.caption.presence || "" %>
+          <% end %>
         <% end %>
         <% if block_image.caption.present? %>
           <p class="image-caption text-muted mt-2 small">

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

@@ -0,0 +1,21 @@
+<div class="container my-5">
+  <h1>Blog</h1>
+
+  <% if @posts.any? %>
+    <% @posts.each do |post| %>
+      <article class="mb-4">
+        <h2><%= link_to post.name, helios_press_public.post_path(post.slug) %></h2>
+        <p class="text-muted">
+          <time datetime="<%= post.updated_at.iso8601 %>">
+            <%= post.updated_at.strftime("%m/%d/%y") %>
+          </time>
+        </p>
+        <% if post.description.present? %>
+          <p><%= post.description %></p>
+        <% end %>
+      </article>
+    <% end %>
+  <% else %>
+    <p>No posts yet.</p>
+  <% end %>
+</div>

data/config/routes/admin.rb

@@ -0,0 +1,17 @@
+Helios::Press::Admin::Engine.routes.draw do
+  scope module: "helios/press/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
+end

data/config/routes/api.rb

@@ -0,0 +1,5 @@
+Helios::Press::Api::Engine.routes.draw do
+  scope module: "helios/press/api" do
+    resources :posts, only: [:create]
+  end
+end

data/config/routes/public.rb

@@ -0,0 +1,6 @@
+Helios::Press::Public::Engine.routes.draw do
+  scope module: "helios/press" do
+    root to: "posts#index"
+    get ":slug", to: "posts#show", as: :post
+  end
+end

data/config/routes.rb

@@ -1,21 +1,2 @@
 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/lib/helios/press/configuration.rb

@@ -2,12 +2,14 @@ module Helios
   module Press
     class Configuration
       attr_accessor :admin_parent_controller,
+                    :public_parent_controller,
                     :api_parent_controller,
                     :api_authentication,
                     :post_slug_prefix
 
       def initialize
         @admin_parent_controller = "ApplicationController"
+        @public_parent_controller = "ApplicationController"
         @api_parent_controller = "ActionController::API"
         @api_authentication = nil
         @post_slug_prefix = nil

data/lib/helios/press/engine.rb

@@ -6,6 +6,48 @@ module Helios
       initializer "helios_press.assets" do |app|
         app.config.assets.precompile += %w[helios/press/blocks.css] if app.config.respond_to?(:assets)
       end
+
+      initializer "helios_press.helpers" do
+        ActiveSupport.on_load(:action_controller) do
+          helper Rails.application.routes.url_helpers
+        end
+      end
+    end
+
+    module Admin
+      class Engine < ::Rails::Engine
+        engine_name "helios_press_admin"
+
+        self.paths["config/routes.rb"] = "config/routes/admin.rb"
+
+        initializer "helios_press_admin.helpers" do
+          ActiveSupport.on_load(:action_controller) do
+            helper Rails.application.routes.url_helpers
+          end
+        end
+      end
+    end
+
+    module Public
+      class Engine < ::Rails::Engine
+        engine_name "helios_press_public"
+
+        self.paths["config/routes.rb"] = "config/routes/public.rb"
+
+        initializer "helios_press_public.helpers" do
+          ActiveSupport.on_load(:action_controller) do
+            helper Rails.application.routes.url_helpers
+          end
+        end
+      end
+    end
+
+    module Api
+      class Engine < ::Rails::Engine
+        engine_name "helios_press_api"
+
+        self.paths["config/routes.rb"] = "config/routes/api.rb"
+      end
     end
   end
 end

data/lib/helios/press/version.rb

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

data/lib/helios/press.rb

@@ -1,6 +1,7 @@
 require "helios/press/version"
 require "helios/press/engine"
 require "helios/press/configuration"
+require "acts_as_list"
 require "helios-videos"
 require "helios-sitemap"
 

data/lib/helios-press.rb

@@ -0,0 +1 @@
+require "helios/press"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: helios-press
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: '0.2'
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
@@ -110,13 +110,18 @@ files:
 - app/views/helios/press/posts/blocks/_image_container.html.erb
 - app/views/helios/press/posts/blocks/_text.html.erb
 - app/views/helios/press/posts/blocks/_video_container.html.erb
+- app/views/helios/press/posts/index.html.erb
 - app/views/helios/press/posts/show.html.erb
 - app/views/layouts/helios/press/admin.html.erb
 - app/views/layouts/helios/press/application.html.erb
 - config/routes.rb
+- config/routes/admin.rb
+- config/routes/api.rb
+- config/routes/public.rb
 - db/migrate/20250510000001_create_helios_press_posts.rb
 - db/migrate/20250510000002_create_helios_press_blocks.rb
 - db/migrate/20250510000003_create_helios_press_block_images.rb
+- lib/helios-press.rb
 - lib/helios/press.rb
 - lib/helios/press/configuration.rb
 - lib/helios/press/engine.rb