maquina-components 0.4.4 → 0.5.1

data/app/views/components/stats/_stats_card.html.erb

@@ -1,100 +1,40 @@
-<%# locals: (title:, value:, icon: nil, icon_class: "", subtitle: nil, value_class: "", container_class: "") -%>
+<%# locals: (title:, value:, icon: nil, subtitle: nil, css_classes: "", icon_classes: "", value_classes: "", container_class: "", icon_class: "", value_class: "", **html_options) %>
+<%
+  # container_class / icon_class / value_class are legacy aliases
+  css_classes = css_classes.presence || container_class
+  icon_classes = icon_classes.presence || icon_class
+  value_classes = value_classes.presence || value_class
 
-<div
-  class="<%= class_names("bg-card p-4 rounded-lg shadow-sm border border-border", container_class) %>"
->
-  <div class="flex items-center justify-between">
-    <div>
-      <p class="text-sm text-muted-foreground"><%= title %></p>
-      <p
-        class="<%= class_names("text-2xl font-bold", value_class.presence || "text-foreground") %>"
-      >
-        <%= value %>
-      </p>
+  # Legacy string icon names map to built-in icons; symbols pass straight
+  # through; anything else renders as custom icon markup.
+  legacy_icons = {
+    "message-square" => :message_square,
+    "arrow-up" => :arrow_up,
+    "arrow-down" => :arrow_down,
+    "check-circle" => :check_circle,
+    "lightning-bolt" => :lightning_bolt,
+    "exclamation-circle" => :circle_alert,
+    "clipboard-list" => :clipboard_list,
+    "chart-bar" => :chart_bar
+  }
+  icon_name = icon.is_a?(Symbol) ? icon : legacy_icons[icon.to_s]
+
+  merged_data = merge_component_data(html_options, component: "stats-card")
+%>
+<%= tag.div class: css_classes.presence, data: merged_data, **html_options do %>
+  <div data-stats-part="body">
+    <div data-stats-part="text">
+      <p data-stats-part="title"><%= title %></p>
+      <p data-stats-part="value" class="<%= value_classes.presence %>"><%= value %></p>
       <% if subtitle.present? %>
-        <p class="text-xs text-muted-foreground mt-1"><%= subtitle %></p>
+        <p data-stats-part="subtitle"><%= subtitle %></p>
       <% end %>
     </div>
+
     <% if icon.present? %>
-      <div class="<%= icon_class.presence || "text-muted-foreground" %>">
-        <% case icon %>
-        <% when "message-square" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M8 10h.01M12 10h.01M16 10h.01M9 16H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-5l-5 5v-5z"
-            />
-          </svg>
-        <% when "arrow-up" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M7 17L17 7M17 7H7M17 7V17"
-            />
-          </svg>
-        <% when "arrow-down" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M17 7L7 17M7 17H17M7 17V7"
-            />
-          </svg>
-        <% when "check-circle" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"
-            />
-          </svg>
-        <% when "lightning-bolt" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M13 10V3L4 14h7v7l9-11h-7z"
-            />
-          </svg>
-        <% when "exclamation-circle" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"
-            />
-          </svg>
-        <% when "clipboard-list" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"
-            />
-          </svg>
-        <% when "chart-bar" %>
-          <svg class="w-8 h-8" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path
-              stroke-linecap="round"
-              stroke-linejoin="round"
-              stroke-width="2"
-              d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"
-            />
-          </svg>
-        <% else %>
-          <%# Allow custom SVG or icon HTML to be passed %>
-          <%= icon %>
-        <% end %>
+      <div data-stats-part="icon" class="<%= icon_classes.presence %>">
+        <%= icon_name ? builtin_icon_for(icon_name, class: "size-8") : icon %>
       </div>
     <% end %>
   </div>
-</div>
+<% end %>

data/app/views/components/stats/_stats_grid.html.erb

@@ -1,38 +1,32 @@
-<%# locals: (cards: [], columns: 3, container_class: "", action: nil, action_position: "end") -%>
+<%# locals: (cards: [], columns: 3, action: nil, action_position: :end, css_classes: "", container_class: "", **html_options) %>
+<%
+  # container_class is a legacy alias
+  css_classes = css_classes.presence || container_class
+  action_position = action_position.to_s
+  columns = columns.to_i.clamp(1, 6)
 
-<div
-  class="<%= class_names("flex flex-col lg:flex-row lg:items-center gap-4": action.present?) %>"
->
+  merged_data = merge_component_data(html_options,
+    component: "stats-grid",
+    columns: columns
+  )
+  merged_data[:"with-action"] = true if action.present?
+%>
+<%= tag.div class: css_classes.presence, data: merged_data, **html_options do %>
   <% if action.present? && action_position == "start" %>
-    <div class="flex justify-center lg:justify-start">
+    <div data-stats-part="action" data-position="start">
       <%= action %>
     </div>
   <% end %>
 
-  <div
-    class="<%= class_names(
-    "grid gap-4", 
-    "grid-cols-1",
-    "sm:grid-cols-#{columns}",
-    container_class,
-    "flex-1": action.present?
-  ) %>"
-  >
+  <div data-stats-part="grid">
     <% cards.each do |card| %>
-      <%= render "components/stats/stats_card",
-      title: card[:title],
-      value: card[:value],
-      icon: card[:icon],
-      icon_class: card[:icon_class] || "",
-      subtitle: card[:subtitle],
-      value_class: card[:value_class] || "",
-      container_class: card[:container_class] || "" %>
+      <%= render "components/stats/stats_card", **card.symbolize_keys %>
     <% end %>
   </div>
 
   <% if action.present? && action_position == "end" %>
-    <div class="flex justify-center lg:justify-end">
+    <div data-stats-part="action" data-position="end">
       <%= action %>
     </div>
   <% end %>
-</div>
+<% end %>

data/app/views/components/table/_body.html.erb

@@ -1,5 +1,5 @@
 <%# locals: (css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(table_part: :body) %>
+<% merged_data = merge_component_data(html_options, table_part: :body) %>
 <%= content_tag :tbody, class: css_classes.presence, data: merged_data, **html_options do %>
   <%= yield %>
 <% end %>

data/app/views/components/table/_caption.html.erb

@@ -1,5 +1,5 @@
-<%# locals: (css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(table_part: :caption) %>
+<%# locals: (text: nil, content: nil, css_classes: "", **html_options) %>
+<% merged_data = merge_component_data(html_options, table_part: :caption) %>
 <%= content_tag :caption, class: css_classes.presence, data: merged_data, **html_options do %>
-  <%= yield if block_given? %>
+  <%= text || content || yield %>
 <% end %>

data/app/views/components/table/_cell.html.erb

@@ -1,5 +1,5 @@
-<%# locals: (css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(table_part: :cell) %>
+<%# locals: (text: nil, content: nil, css_classes: "", **html_options) %>
+<% merged_data = merge_component_data(html_options, table_part: :cell) %>
 <%= content_tag :td, class: css_classes.presence, data: merged_data, **html_options do %>
-  <%= yield if block_given? %>
+  <%= text || content || yield %>
 <% end %>

data/app/views/components/table/_footer.html.erb

@@ -1,5 +1,5 @@
 <%# locals: (css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(table_part: :footer) %>
+<% merged_data = merge_component_data(html_options, table_part: :footer) %>
 <%= content_tag :tfoot, class: css_classes.presence, data: merged_data, **html_options do %>
   <%= yield %>
 <% end %>

data/app/views/components/table/_head.html.erb

@@ -1,8 +1,8 @@
-<%# locals: (css_classes: "", scope: "col", **html_options) %>
+<%# locals: (text: nil, content: nil, css_classes: "", scope: "col", **html_options) %>
 <%
-  merged_data = (html_options.delete(:data) || {}).merge(table_part: :head)
+  merged_data = merge_component_data(html_options, table_part: :head)
   html_options[:scope] = scope if scope
 %>
 <%= content_tag :th, class: css_classes.presence, data: merged_data, **html_options do %>
-  <%= yield if block_given? %>
+  <%= text || content || yield %>
 <% end %>

data/app/views/components/table/_header.html.erb

@@ -1,6 +1,6 @@
 <%# locals: (css_classes: "", sticky: false, **html_options) %>
 <%
-  merged_data = (html_options.delete(:data) || {}).merge(table_part: :header)
+  merged_data = merge_component_data(html_options, table_part: :header)
   merged_data[:sticky] = "true" if sticky
 %>
 <%= content_tag :thead, class: css_classes.presence, data: merged_data, **html_options do %>

data/app/views/components/table/_row.html.erb

@@ -1,6 +1,6 @@
 <%# locals: (css_classes: "", selected: false, **html_options) %>
 <%
-  merged_data = (html_options.delete(:data) || {}).merge(table_part: :row)
+  merged_data = merge_component_data(html_options, table_part: :row)
   merged_data[:state] = :selected if selected
 %>
 <%= content_tag :tr, class: css_classes.presence, data: merged_data, **html_options do %>

data/app/views/components/toast/_action.html.erb

@@ -1,5 +1,5 @@
 <%# locals: (label:, href: nil, method: nil, css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(
+<% merged_data = merge_component_data(html_options,
     toast_part: "action"
   ) %>
 

data/app/views/components/toast/_description.html.erb

@@ -1,5 +1,5 @@
 <%# locals: (text: nil, content: nil, css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(
+<% merged_data = merge_component_data(html_options,
     toast_part: "description"
   ) %>
 

data/app/views/components/toast/_title.html.erb

@@ -1,5 +1,5 @@
 <%# locals: (text: nil, content: nil, css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(
+<% merged_data = merge_component_data(html_options,
     toast_part: "title"
   ) %>
 

data/app/views/components/toggle_group/_item.html.erb

@@ -1,5 +1,5 @@
 <%# locals: (value:, pressed: false, disabled: false, aria_label: nil, css_classes: "", **html_options) %>
-<% merged_data = (html_options.delete(:data) || {}).merge(
+<% merged_data = merge_component_data(html_options,
     "toggle-group-part": "item",
     "toggle-group-target": "item",
     value: value,

data/lib/generators/maquina_components/install/templates/maquina_components_helper.rb.tt

@@ -6,9 +6,17 @@
 # Override methods here to integrate with your application's icon system,
 # sidebar state management, and other customizations.
 #
+# Engine helper modules are included below to make their methods available
+# in your views (icon_for, sidebar_open?, toast_flash_messages, etc.).
+#
 # Documentation: https://github.com/maquina-app/maquina_components
 #
 module MaquinaComponentsHelper
+  include MaquinaComponents::ComponentsHelper
+  include MaquinaComponents::IconsHelper
+  include MaquinaComponents::SidebarHelper
+  include MaquinaComponents::ToastHelper
+
   # Icon Override
   #
   # Override this method to use your own icon system (Heroicons, Lucide, etc.)

data/lib/generators/maquina_components/scaffold_templates/scaffold_templates_generator.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module MaquinaComponents
+  module Generators
+    class ScaffoldTemplatesGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Copy maquina_components scaffold templates to your application"
+
+      TEMPLATE_FILES = %w[
+        _form.html.erb.tt
+        edit.html.erb.tt
+        index.html.erb.tt
+        new.html.erb.tt
+        partial.html.erb.tt
+        show.html.erb.tt
+      ].freeze
+
+      def copy_templates
+        TEMPLATE_FILES.each do |filename|
+          copy_file filename, "lib/templates/erb/scaffold/#{filename}"
+        end
+      end
+
+      def show_post_install_message
+        say ""
+        say "Scaffold templates installed!", :green
+        say ""
+        say "Rails will now use maquina_components when you run:"
+        say "  rails generate scaffold ModelName field:type"
+        say ""
+        say "Templates are in lib/templates/erb/scaffold/"
+        say "Feel free to customize them for your application."
+        say ""
+      end
+    end
+  end
+end

data/lib/generators/maquina_components/scaffold_templates/templates/_form.html.erb.tt

@@ -0,0 +1,49 @@
+<%%= form_with(model: <%= model_resource_name %>, class: "space-y-4") do |form| %>
+  <%% if <%= singular_table_name %>.errors.any? %>
+    <%%= render "components/alert", variant: :destructive do %>
+      <%%= render "components/alert/title", text: "<%%= pluralize(<%= singular_table_name %>.errors.count, 'error') %> prohibited this <%= singular_table_name %> from being saved:" %>
+      <%%= render "components/alert/description" do %>
+        <ul class="list-disc list-inside mt-2">
+          <%% <%= singular_table_name %>.errors.each do |error| %>
+            <li><%%= error.full_message %></li>
+          <%% end %>
+        </ul>
+      <%% end %>
+    <%% end %>
+  <%% end %>
+
+<% attributes.each do |attribute| -%>
+  <div class="space-y-2">
+<% if attribute.password_digest? -%>
+    <%%= form.label :password %>
+    <%%= form.password_field :password, data: { component: "input" } %>
+  </div>
+
+  <div class="space-y-2">
+    <%%= form.label :password_confirmation %>
+    <%%= form.password_field :password_confirmation, data: { component: "input" } %>
+<% elsif attribute.attachments? -%>
+    <%%= form.label :<%= attribute.column_name %> %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, multiple: true, data: { component: "input" } %>
+<% elsif attribute.field_type == :text_area -%>
+    <%%= form.label :<%= attribute.column_name %> %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, data: { component: "textarea" } %>
+<% elsif attribute.field_type == :check_box -%>
+    <div class="flex items-center gap-2">
+      <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, data: { component: "checkbox" } %>
+      <%%= form.label :<%= attribute.column_name %> %>
+    </div>
+<% elsif attribute.field_type == :select -%>
+    <%%= form.label :<%= attribute.column_name %> %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, [], {}, data: { component: "select" } %>
+<% else -%>
+    <%%= form.label :<%= attribute.column_name %> %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, data: { component: "input" } %>
+<% end -%>
+  </div>
+
+<% end -%>
+  <div class="flex items-center gap-4 pt-4">
+    <%%= form.submit data: { component: "button", variant: "primary" } %>
+  </div>
+<%% end %>

data/lib/generators/maquina_components/scaffold_templates/templates/edit.html.erb.tt

@@ -0,0 +1,29 @@
+<%% content_for :title, "Editing <%= human_name.downcase %>" %>
+
+<%% content_for :breadcrumbs do %>
+  <%%= render "components/breadcrumbs" do %>
+    <%%= render "components/breadcrumbs/list" do %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/link", href: <%= index_helper(type: :path) %>, text: "<%= human_name.pluralize %>" %>
+      <%% end %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/link", href: <%= model_resource_name(prefix: "@") %>, text: "<%= human_name %>" %>
+      <%% end %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/page", text: "Edit" %>
+      <%% end %>
+    <%% end %>
+  <%% end %>
+<%% end %>
+
+<div class="space-y-6">
+  <%%= render "components/card" do %>
+    <%%= render "components/card/header" do %>
+      <%%= render "components/card/title", text: "Editing <%= human_name.downcase %>" %>
+    <%% end %>
+
+    <%%= render "components/card/content" do %>
+      <%%= render "form", <%= singular_table_name %>: @<%= singular_table_name %> %>
+    <%% end %>
+  <%% end %>
+</div>

data/lib/generators/maquina_components/scaffold_templates/templates/index.html.erb.tt

@@ -0,0 +1,58 @@
+<%% content_for :title, "<%= human_name.pluralize %>" %>
+
+<div class="space-y-6">
+  <%%= render "components/card" do %>
+    <%%= render "components/card/header", layout: :row do %>
+      <div>
+        <%%= render "components/card/title", text: "<%= human_name.pluralize %>" %>
+        <%%= render "components/card/description", text: "<%%= @<%= plural_table_name %>.size %> record(s)" %>
+      </div>
+      <%%= render "components/card/action" do %>
+        <%%= link_to "New <%= human_name.downcase %>", <%= new_helper(type: :path) %>, data: { component: "button", variant: "primary", size: "sm" } %>
+      <%% end %>
+    <%% end %>
+
+    <%%= render "components/card/content" do %>
+      <%% if @<%= plural_table_name %>.any? %>
+        <%%= render "components/table" do %>
+          <%%= render "components/table/header" do %>
+            <%%= render "components/table/row" do %>
+<% attributes.reject(&:password_digest?).each do |attribute| -%>
+              <%%= render "components/table/head" do %><%= attribute.human_name %><%% end %>
+<% end -%>
+              <%%= render "components/table/head" do %><%% end %>
+            <%% end %>
+          <%% end %>
+          <%%= render "components/table/body" do %>
+            <%% @<%= plural_table_name %>.each do |<%= singular_table_name %>| %>
+              <%%= render "components/table/row" do %>
+<% attributes.reject(&:password_digest?).each do |attribute| -%>
+<% if attribute.attachment? -%>
+                <%%= render "components/table/cell" do %><%%= link_to <%= singular_table_name %>.<%= attribute.column_name %>.filename, <%= singular_table_name %>.<%= attribute.column_name %> if <%= singular_table_name %>.<%= attribute.column_name %>.attached? %><%% end %>
+<% elsif attribute.attachments? -%>
+                <%%= render "components/table/cell" do %><%%= <%= singular_table_name %>.<%= attribute.column_name %>.count %> file(s)<%% end %>
+<% else -%>
+                <%%= render "components/table/cell" do %><%%= <%= singular_table_name %>.<%= attribute.column_name %> %><%% end %>
+<% end -%>
+<% end -%>
+                <%%= render "components/table/cell" do %>
+                  <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(singular_table_name) %>, data: { component: "button", variant: "ghost", size: "sm" } %>
+                <%% end %>
+              <%% end %>
+            <%% end %>
+          <%% end %>
+        <%% end %>
+      <%% else %>
+        <%%= render "components/empty" do %>
+          <%%= render "components/empty/header" do %>
+            <%%= render "components/empty/title", text: "No <%= human_name.pluralize.downcase %> yet" %>
+            <%%= render "components/empty/description", text: "Get started by creating a new <%= human_name.downcase %>." %>
+          <%% end %>
+          <%%= render "components/empty/content" do %>
+            <%%= link_to "New <%= human_name.downcase %>", <%= new_helper(type: :path) %>, data: { component: "button", variant: "primary" } %>
+          <%% end %>
+        <%% end %>
+      <%% end %>
+    <%% end %>
+  <%% end %>
+</div>

data/lib/generators/maquina_components/scaffold_templates/templates/new.html.erb.tt

@@ -0,0 +1,26 @@
+<%% content_for :title, "New <%= human_name.downcase %>" %>
+
+<%% content_for :breadcrumbs do %>
+  <%%= render "components/breadcrumbs" do %>
+    <%%= render "components/breadcrumbs/list" do %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/link", href: <%= index_helper(type: :path) %>, text: "<%= human_name.pluralize %>" %>
+      <%% end %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/page", text: "New" %>
+      <%% end %>
+    <%% end %>
+  <%% end %>
+<%% end %>
+
+<div class="space-y-6">
+  <%%= render "components/card" do %>
+    <%%= render "components/card/header" do %>
+      <%%= render "components/card/title", text: "New <%= human_name.downcase %>" %>
+    <%% end %>
+
+    <%%= render "components/card/content" do %>
+      <%%= render "form", <%= singular_table_name %>: @<%= singular_table_name %> %>
+    <%% end %>
+  <%% end %>
+</div>

data/lib/generators/maquina_components/scaffold_templates/templates/partial.html.erb.tt

@@ -0,0 +1,17 @@
+<div id="<%%= dom_id <%= singular_name %> %>">
+<% attributes.reject(&:password_digest?).each do |attribute| -%>
+  <div>
+    <strong class="text-sm font-medium text-muted-foreground"><%= attribute.human_name %>:</strong>
+<% if attribute.attachment? -%>
+    <%%= link_to <%= singular_name %>.<%= attribute.column_name %>.filename, <%= singular_name %>.<%= attribute.column_name %> if <%= singular_name %>.<%= attribute.column_name %>.attached? %>
+<% elsif attribute.attachments? -%>
+    <%% <%= singular_name %>.<%= attribute.column_name %>.each do |<%= attribute.singular_name %>| %>
+      <div><%%= link_to <%= attribute.singular_name %>.filename, <%= attribute.singular_name %> %></div>
+    <%% end %>
+<% else -%>
+    <%%= <%= singular_name %>.<%= attribute.column_name %> %>
+<% end -%>
+  </div>
+
+<% end -%>
+</div>

data/lib/generators/maquina_components/scaffold_templates/templates/show.html.erb.tt

@@ -0,0 +1,53 @@
+<%% content_for :title, "<%= human_name %>" %>
+
+<%% content_for :breadcrumbs do %>
+  <%%= render "components/breadcrumbs" do %>
+    <%%= render "components/breadcrumbs/list" do %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/link", href: <%= index_helper(type: :path) %>, text: "<%= human_name.pluralize %>" %>
+      <%% end %>
+      <%%= render "components/breadcrumbs/item" do %>
+        <%%= render "components/breadcrumbs/page", text: "<%= human_name %>" %>
+      <%% end %>
+    <%% end %>
+  <%% end %>
+<%% end %>
+
+<div class="space-y-6">
+  <%%= render "components/card" do %>
+    <%%= render "components/card/header", layout: :row do %>
+      <div>
+        <%%= render "components/card/title", text: "<%= human_name %>" %>
+      </div>
+      <%%= render "components/card/action" do %>
+        <%%= link_to "Edit this <%= human_name.downcase %>", <%= edit_helper(type: :path) %>, data: { component: "button", variant: "outline", size: "sm" } %>
+      <%% end %>
+    <%% end %>
+
+    <%%= render "components/card/content" do %>
+      <dl class="grid grid-cols-1 gap-4 sm:grid-cols-2">
+<% attributes.reject(&:password_digest?).each do |attribute| -%>
+        <div>
+          <dt class="text-sm font-medium text-muted-foreground"><%= attribute.human_name %></dt>
+<% if attribute.attachment? -%>
+          <dd class="mt-1"><%%= link_to @<%= singular_table_name %>.<%= attribute.column_name %>.filename, @<%= singular_table_name %>.<%= attribute.column_name %> if @<%= singular_table_name %>.<%= attribute.column_name %>.attached? %></dd>
+<% elsif attribute.attachments? -%>
+          <dd class="mt-1">
+            <%% @<%= singular_table_name %>.<%= attribute.column_name %>.each do |<%= attribute.singular_name %>| %>
+              <div><%%= link_to <%= attribute.singular_name %>.filename, <%= attribute.singular_name %> %></div>
+            <%% end %>
+          </dd>
+<% else -%>
+          <dd class="mt-1"><%%= @<%= singular_table_name %>.<%= attribute.column_name %> %></dd>
+<% end -%>
+        </div>
+<% end -%>
+      </dl>
+    <%% end %>
+
+    <%%= render "components/card/footer" do %>
+      <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %>, data: { component: "button", variant: "ghost" } %>
+      <%%= button_to "Destroy this <%= human_name.downcase %>", <%= model_resource_name(prefix: "@") %>, method: :delete, data: { component: "button", variant: "destructive" } %>
+    <%% end %>
+  <%% end %>
+</div>

data/lib/maquina-components.rb

@@ -1,3 +1,8 @@
+# Gemspec dependencies are not auto-required by Bundler in host apps,
+# so load them here before the engine wires them up.
+require "importmap-rails"
+require "stimulus-rails"
+
 require "maquina_components/version"
 require "maquina_components/engine"
 

data/lib/maquina_components/engine.rb

@@ -1,11 +1,15 @@
 module MaquinaComponents
   class Engine < ::Rails::Engine
     initializer "maquina-components.importmap", before: "importmap" do |app|
-      app.config.importmap.paths << root.join("config/importmap.rb")
-      app.config.importmap.cache_sweepers << root.join("app/javascript")
+      # Hosts bundling JS without importmap-rails (esbuild, vite, bun)
+      # have no config.importmap; skip so the engine doesn't break boot.
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << root.join("config/importmap.rb")
+        app.config.importmap.cache_sweepers << root.join("app/javascript")
+      end
     end
 
-    initializer "maquin-components.assets" do |app|
+    initializer "maquina-components.assets" do |app|
       if app.config.respond_to?(:assets)
         app.config.assets.paths << Engine.root.join("app/javascript")
       end

data/lib/maquina_components/version.rb

@@ -1,3 +1,3 @@
 module MaquinaComponents
-  VERSION = "0.4.4"
+  VERSION = "0.5.1"
 end