maquina-components 0.1.1 → 0.2.0

data/app/views/components/pagination/_previous.html.erb

@@ -0,0 +1,57 @@
+<%# locals: (href: nil, label: nil, disabled: false, show_label: true, css_classes: "", **html_options) %>
+<% is_disabled = disabled || href.nil?
+  display_label = label || t("maquina_components.pagination.previous", default: "Previous")
+  merged_data = (html_options.delete(:data) || {}).merge("pagination-part": "previous") %>
+
+<% if is_disabled %>
+  <span
+    class="<%= css_classes.presence %>"
+    data-pagination-part="previous"
+    aria-disabled="true"
+    <%= tag.attributes(html_options.except(:data)) %>
+  >
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="24"
+      height="24"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      stroke-width="2"
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+    >
+      <path d="m15 18-6-6 6-6" />
+    </svg>
+
+    <% if show_label %>
+      <span><%= display_label %></span>
+    <% end %>
+  </span>
+<% else %>
+  <%= link_to href,
+        class: css_classes.presence,
+        data: merged_data,
+        "aria-label": display_label,
+        **html_options do %>
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="24"
+      height="24"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      stroke-width="2"
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+    >
+      <path d="m15 18-6-6 6-6" />
+    </svg>
+
+    <% if show_label %>
+      <span><%= display_label %></span>
+    <% end %>
+  <% end %>
+<% end %>

data/app/views/components/sidebar/_content.html.erb

@@ -0,0 +1,8 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :content
+  ) %>
+
+<%= content_tag :div, class: css_classes, data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

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

@@ -0,0 +1,8 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :footer
+  ) %>
+
+<%= content_tag :div, class: css_classes, data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

data/app/views/components/sidebar/_group.html.erb

@@ -0,0 +1,12 @@
+<%# locals: (title: nil, css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :group
+  ) %>
+
+<%= content_tag :div, class: css_classes, data: merged_data, **html_options do %>
+  <% if title.present? %>
+    <div data-sidebar-part="group-label"><%= title %></div>
+  <% end %>
+
+  <%= yield %>
+<% end %>

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

@@ -0,0 +1,8 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :header
+  ) %>
+
+<%= content_tag :div, class: css_classes, data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

data/app/views/components/sidebar/_inset.html.erb

@@ -0,0 +1,8 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :inset
+  ) %>
+
+<%= content_tag :main, class: css_classes, data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

data/app/views/components/sidebar/_menu.html.erb

@@ -0,0 +1,8 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :menu
+  ) %>
+
+<%= content_tag :ul, class: css_classes, data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

data/app/views/components/sidebar/_menu_button.html.erb

@@ -0,0 +1,14 @@
+<%# locals: (title:, url:, icon_name: nil, size: :default, active: false, css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: "menu-button",
+    size: size,
+    active: active
+  ) %>
+
+<%= link_to url, class: css_classes, data: merged_data, **html_options do %>
+  <% if icon_name.present? %>
+    <%= icon_for(icon_name) %>
+  <% end %>
+
+  <span><%= title %></span>
+<% end %>

data/app/views/components/sidebar/_menu_item.html.erb

@@ -0,0 +1,7 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data =
+  (html_options.delete(:data) || {}).merge(sidebar_part: "menu-item") %>
+
+<%= content_tag :li, class: "group/menu-item #{css_classes}", data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

data/app/views/components/sidebar/_menu_link.html.erb

@@ -0,0 +1,32 @@
+<%# locals: (url: "#", active: false, title: nil, subtitle: nil, icon: nil, text_icon: nil, icon_classes: "", css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: "menu-link",
+    active: active
+  ) %>
+
+<%= link_to url, class: css_classes, data: merged_data, **html_options do %>
+  <% if icon.present? || text_icon.present? %>
+    <div data-sidebar-part="menu-avatar">
+      <% if icon.present? %>
+        <%= image_tag icon, class: icon_classes %>
+      <% elsif text_icon.present? %>
+        <span class="<%= icon_classes %>"><%= text_icon %></span>
+      <% end %>
+    </div>
+  <% end %>
+
+  <% if title.present? || subtitle.present? %>
+    <div
+      class="flex flex-col gap-0.5 leading-none"
+      data-sidebar-hide-on-collapse
+    >
+      <% if title.present? %>
+        <span class="font-medium"><%= title %></span>
+      <% end %>
+
+      <% if subtitle.present? %>
+        <span class="text-xs text-sidebar-foreground/70"><%= subtitle %></span>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/components/sidebar/_provider.html.erb

@@ -0,0 +1,16 @@
+<%# locals: (default_open: true, variant: :inset, css_classes: "", cookie_name: "sidebar_state", keyboard_shortcut: "b", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    component: :sidebar,
+    variant: variant,
+    controller: "sidebar",
+    outlet: "sidebar",
+    sidebar_default_open_value: default_open,
+    sidebar_open_value: default_open,
+    sidebar_cookie_name_value: cookie_name,
+    sidebar_keyboard_shortcut_value: keyboard_shortcut,
+    action: "keydown.meta+#{keyboard_shortcut}@window->sidebar#toggleWithKeyboard keydown.ctrl+#{keyboard_shortcut}@window->sidebar#toggleWithKeyboard"
+  ) %>
+
+<%= content_tag :div, class: css_classes, data: merged_data, **html_options do %>
+  <%= yield %>
+<% end %>

data/app/views/components/sidebar/_trigger.html.erb

@@ -0,0 +1,12 @@
+<%# locals: (icon_name:, css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    sidebar_part: :trigger,
+    controller: "sidebar-trigger",
+    action: "click->sidebar-trigger#triggerClick",
+    sidebar_trigger_sidebar_outlet: "[data-outlet='sidebar']"
+  ) %>
+
+<%= button_tag type: :button, class: css_classes, data: merged_data, **html_options do %>
+  <%= icon_for(icon_name) %>
+  <span class="sr-only">Toggle Sidebar</span>
+<% end %>

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

@@ -0,0 +1,100 @@
+<%# locals: (title:, value:, icon: nil, icon_class: "", subtitle: nil, value_class: "", container_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>
+      <% if subtitle.present? %>
+        <p class="text-xs text-muted-foreground mt-1"><%= 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>
+    <% end %>
+  </div>
+</div>

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

@@ -0,0 +1,38 @@
+<%# locals: (cards: [], columns: 3, container_class: "", action: nil, action_position: "end") -%>
+
+<div
+  class="<%= class_names("flex flex-col lg:flex-row lg:items-center gap-4": action.present?) %>"
+>
+  <% if action.present? && action_position == "start" %>
+    <div class="flex justify-center lg:justify-start">
+      <%= action %>
+    </div>
+  <% end %>
+
+  <div
+    class="<%= class_names(
+    "grid gap-4", 
+    "grid-cols-1",
+    "sm:grid-cols-#{columns}",
+    container_class,
+    "flex-1": action.present?
+  ) %>"
+  >
+    <% cards.each do |card| %>
+      <%= render "components/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] || "" %>
+    <% end %>
+  </div>
+
+  <% if action.present? && action_position == "end" %>
+    <div class="flex justify-center lg:justify-end">
+      <%= action %>
+    </div>
+  <% end %>
+</div>

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

@@ -0,0 +1,5 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(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

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

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

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

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

@@ -0,0 +1,5 @@
+<%# locals: (css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(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

@@ -0,0 +1,8 @@
+<%# locals: (css_classes: "", scope: "col", **html_options) %>
+<%
+  merged_data = (html_options.delete(:data) || {}).merge(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? %>
+<% end %>

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

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

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

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

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

@@ -0,0 +1,19 @@
+<%# locals: (value:, pressed: false, disabled: false, aria_label: nil, css_classes: "", **html_options) %>
+<% merged_data = (html_options.delete(:data) || {}).merge(
+    "toggle-group-part": "item",
+    "toggle-group-target": "item",
+    value: value,
+    state: pressed ? "on" : "off",
+    action: "click->toggle-group#toggle keydown->toggle-group#handleKeydown"
+  ) %>
+
+<%= content_tag :button,
+      type: "button",
+      class: css_classes.presence,
+      data: merged_data,
+      disabled: disabled,
+      "aria-pressed": pressed,
+      "aria-label": aria_label,
+      **html_options do %>
+  <%= yield %>
+<% end %>

data/config/importmap.rb

@@ -0,0 +1 @@
+pin_all_from MaquinaComponents::Engine.root.join("app/javascript/controllers"), under: "controllers"

data/lib/generators/maquina_components/install/USAGE

@@ -0,0 +1,39 @@
+Description:
+    Install maquina_components into your Rails application.
+
+    This generator will:
+    - Add the engine CSS import to your Tailwind application.css
+    - Add theme variables (shadcn/ui convention) for customization
+    - Create a helper file for icon overrides and customizations
+
+Example:
+    bin/rails generate maquina_components:install
+
+    This will:
+      insert  @import "../builds/tailwind/maquina_components_engine.css";
+      append  Theme variables to app/assets/tailwind/application.css
+      create  app/helpers/maquina_components_helper.rb
+
+Options:
+    --skip-theme    Skip adding theme variables (if you already have them)
+    --skip-helper   Skip creating the helper file
+
+Prerequisites:
+    - tailwindcss-rails gem installed
+    - app/assets/tailwind/application.css exists
+
+After Installation:
+    1. Customize theme variables in app/assets/tailwind/application.css
+    2. Override icon helper in app/helpers/maquina_components_helper.rb
+    3. Start using components:
+
+       <%%= render "components/card" do %>
+         <%%= render "components/card/header" do %>
+           <%%= render "components/card/title", text: "Hello World" %>
+         <%% end %>
+       <%% end %>
+
+    4. Use data attributes with form helpers:
+
+       <%%= f.text_field :email, data: { component: "input" } %>
+       <%%= f.submit "Save", data: { component: "button", variant: "primary" } %>

data/lib/generators/maquina_components/install/install_generator.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module MaquinaComponents
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Install maquina_components into your Rails application"
+
+      class_option :skip_theme, type: :boolean, default: false,
+        desc: "Skip adding theme variables to application.css"
+      class_option :skip_helper, type: :boolean, default: false,
+        desc: "Skip creating the maquina_components helper"
+
+      def check_tailwindcss_rails
+        css_path = "app/assets/tailwind/application.css"
+
+        unless File.exist?(File.join(destination_root, css_path))
+          say_status :warning, "tailwindcss-rails doesn't appear to be installed", :yellow
+          say "Please install tailwindcss-rails first:"
+          say "  bundle add tailwindcss-rails"
+          say "  rails tailwindcss:install"
+          say ""
+        end
+      end
+
+      def add_engine_css_import
+        css_path = "app/assets/tailwind/application.css"
+        full_path = File.join(destination_root, css_path)
+
+        unless File.exist?(full_path)
+          say_status :skip, "#{css_path} not found", :yellow
+          return
+        end
+
+        import_line = '@import "../builds/tailwind/maquina_components_engine.css";'
+
+        if File.read(full_path).include?(import_line)
+          say_status :skip, "Engine CSS import already present", :blue
+          return
+        end
+
+        # Insert after @import "tailwindcss"; or @import 'tailwindcss'; line
+        inject_into_file css_path, after: /@import\s+["']tailwindcss["'];?\n/ do
+          "\n#{import_line}\n"
+        end
+
+        say_status :insert, "Added maquina_components engine CSS import", :green
+      end
+
+      def add_theme_variables
+        return if options[:skip_theme]
+
+        css_path = "app/assets/tailwind/application.css"
+        full_path = File.join(destination_root, css_path)
+
+        unless File.exist?(full_path)
+          say_status :skip, "#{css_path} not found", :yellow
+          return
+        end
+
+        if File.read(full_path).include?("--color-primary:")
+          say_status :skip, "Theme variables already present", :blue
+          return
+        end
+
+        theme_content = File.read(File.expand_path("templates/theme.css.tt", __dir__))
+
+        append_to_file css_path, "\n#{theme_content}"
+
+        say_status :append, "Added theme variables to application.css", :green
+      end
+
+      def create_helper
+        return if options[:skip_helper]
+
+        helper_path = "app/helpers/maquina_components_helper.rb"
+        full_path = File.join(destination_root, helper_path)
+
+        if File.exist?(full_path)
+          say_status :skip, "#{helper_path} already exists", :blue
+          return
+        end
+
+        template "maquina_components_helper.rb.tt", helper_path
+        say_status :create, helper_path, :green
+      end
+
+      def show_post_install_message
+        say ""
+        say "=" * 60
+        say "  maquina_components installed successfully!", :green
+        say "=" * 60
+        say ""
+        say "Next steps:"
+        say ""
+        say "1. Customize theme variables in app/assets/tailwind/application.css"
+        say "   to match your design system."
+        say ""
+        say "2. Override the icon helper in app/helpers/maquina_components_helper.rb"
+        say "   to use your own icon system (Heroicons, Lucide, etc.)."
+        say ""
+        say "3. Start using components in your views:"
+        say ""
+        say '   <%= render "components/card" do %>'
+        say '     <%= render "components/card/header" do %>'
+        say '       <%= render "components/card/title", text: "Hello" %>'
+        say "     <% end %>"
+        say "   <% end %>"
+        say ""
+        say "4. For form elements, use data attributes:"
+        say ""
+        say '   <%= f.text_field :email, data: { component: "input" } %>'
+        say '   <%= f.submit "Save", data: { component: "button", variant: "primary" } %>'
+        say ""
+        say "Documentation: https://github.com/maquina-app/maquina_components"
+        say ""
+      end
+    end
+  end
+end

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

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# MaquinaComponents Helper
+#
+# This helper provides customization hooks for maquina_components.
+# Override methods here to integrate with your application's icon system,
+# sidebar state management, and other customizations.
+#
+# Documentation: https://github.com/maquina-app/maquina_components
+#
+module MaquinaComponentsHelper
+  # Icon Override
+  #
+  # Override this method to use your own icon system (Heroicons, Lucide, etc.)
+  # The engine's icon_for helper will call this method first.
+  #
+  # @param name [Symbol] Icon name (e.g., :check, :chevron_right, :home)
+  # @param options [Hash] Options hash with :class, :stroke_width, etc.
+  # @return [String, nil] SVG string or nil to fall back to engine's icons
+  #
+  # @example Using Heroicons
+  #   def main_icon_svg_for(name)
+  #     heroicon_tag(name, variant: :outline)
+  #   end
+  #
+  # @example Using Lucide
+  #   def main_icon_svg_for(name)
+  #     lucide_icon(name)
+  #   end
+  #
+  # @example Using inline SVG files
+  #   def main_icon_svg_for(name)
+  #     file_path = Rails.root.join("app/assets/images/icons/#{name}.svg")
+  #     File.read(file_path) if File.exist?(file_path)
+  #   end
+  #
+  def main_icon_svg_for(name)
+    # Return nil to use the engine's built-in icons
+    # Override this method to use your own icon system
+    nil
+  end
+
+  # Sidebar State Helpers
+  #
+  # These helpers are re-exported from the engine for convenience.
+  # You can override them if you need custom cookie names or behavior.
+
+  # Returns the current sidebar state from cookies
+  # @param cookie_name [String] Cookie name (default: "sidebar_state")
+  # @return [Symbol] :expanded or :collapsed
+  def app_sidebar_state(cookie_name = "sidebar_state")
+    sidebar_state(cookie_name)
+  end
+
+  # Check if sidebar is expanded
+  # @param cookie_name [String] Cookie name (default: "sidebar_state")
+  # @return [Boolean]
+  def app_sidebar_open?(cookie_name = "sidebar_state")
+    sidebar_open?(cookie_name)
+  end
+
+  # Check if sidebar is collapsed
+  # @param cookie_name [String] Cookie name (default: "sidebar_state")
+  # @return [Boolean]
+  def app_sidebar_closed?(cookie_name = "sidebar_state")
+    sidebar_closed?(cookie_name)
+  end
+end