Add sidebar component

lib/ruby_ui/sidebar/collapsiable_sidebar.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class CollapsiableSidebar < Base
+    def initialize(side: :left, variant: :sidebar, collapsible: :offcanvas, open: true, **attrs)
+      @side = side
+      @variant = variant
+      @collapsible = collapsible
+      @open = open
+      super(**attrs)
+    end
+
+    def view_template(&)
+      MobileSidebar(side: @side, **attrs, &)
+      div(**mix(sidebar_attrs, attrs)) do
+        div(**gap_element_attrs)
+        div(**content_wrapper_attrs) do
+          div(**content_attrs, &)
+        end
+      end
+    end
+
+    private
+
+    def sidebar_attrs
+      {
+        class: "group peer hidden text-sidebar-foreground md:block",
+        data: {
+          state: @open ? "expanded" : "collapsed",
+          collapsible: @open ? "" : @collapsible,
+          variant: @variant,
+          side: @side,
+          collapsible_kind: @collapsible,
+          ruby_ui__sidebar_target: "sidebar"
+        }
+      }
+    end
+
+    def gap_element_attrs
+      {
+        class: [
+          "relative w-[var(--sidebar-width)] bg-transparent transition-[width]",
+          "duration-200 ease-linear",
+          "group-data-[collapsible=offcanvas]:w-0",
+          "group-data-[side=right]:rotate-180",
+          variant_classes
+        ]
+      }
+    end
+
+    def content_wrapper_attrs
+      {
+        class: [
+          "fixed inset-y-0 z-10 hidden h-svh w-[var(--sidebar-width)]",
+          "transition-[left,right,width] duration-200 ease-linear md:flex",
+          content_wrapper_side_classes,
+          content_wrapper_variant_classes
+        ]
+      }
+    end
+
+    def content_attrs
+      {
+        class: [
+          "flex h-full w-full flex-col bg-sidebar",
+          "group-data-[variant=floating]:rounded-lg",
+          "group-data-[variant=floating]:border",
+          "group-data-[variant=floating]:border-sidebar-border",
+          "group-data-[variant=floating]:shadow"
+        ],
+        data: {
+          sidebar: "sidebar"
+        }
+      }
+    end
+
+    def variant_classes
+      if %i[floating inset].include?(@variant)
+        "group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)_+_theme(spacing.4))]"
+      else
+        "group-data-[collapsible=icon]:w-[var(--sidebar-width-icon)]"
+      end
+    end
+
+    def content_wrapper_side_classes
+      return "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]" if @side == :left
+
+      "right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]"
+    end
+
+    def content_wrapper_variant_classes
+      if %i[floating inset].include?(@variant)
+        "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)_+_theme(spacing.4)_+2px)]"
+      else
+        "group-data-[collapsible=icon]:w-[var(--sidebar-width-icon)] group-data-[side=left]:border-r group-data-[side=right]:border-l"
+      end
+    end
+  end
+end

lib/ruby_ui/sidebar/mobile_sidebar.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class MobileSidebar < Base
+    SIDEBAR_WIDTH_MOBILE = "18rem"
+
+    def initialize(side: :left, **attrs)
+      @side = side
+      super(**attrs)
+    end
+
+    def view_template(&)
+      Sheet(**attrs) do
+        SheetContent(
+          side: @side,
+          class: "w-[var(--sidebar-width)] bg-sidebar p-0 text-sidebar-foreground [&>button]:hidden",
+          style: {
+            "--sidebar-width": SIDEBAR_WIDTH_MOBILE
+          },
+          data: {
+            sidebar: "sidebar",
+            mobile: "true"
+          }
+        ) do
+          SheetHeader(class: "sr-only") do
+            SheetTitle { "Sidebar" }
+            SheetDescription { "Displays the mobile sidebar." }
+          end
+          div(class: "flex h-full w-full flex-col", &)
+        end
+      end
+    end
+
+    private
+
+    def default_attrs
+      {
+        data: {
+          ruby_ui__sidebar_target: "mobileSidebar",
+          action: "ruby--ui-sidebar:open->ruby-ui--sheet#open:self"
+        }
+      }
+    end
+  end
+end

lib/ruby_ui/sidebar/non_collapsible_sidebar.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class NonCollpapsibleSidebar < Base
+    def view_template(&)
+      div(**attrs, &)
+    end
+
+    private
+
+    def default_attrs
+      {
+        class: "flex h-full w-[var(--sidebar-width)] flex-col bg-sidebar text-sidebar-foreground"
+      }
+    end
+  end
+end

lib/ruby_ui/sidebar/sidebar.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class Sidebar < Base
+    SIDES = %i[left right].freeze
+    VARIANTS = %i[sidebar floating inset].freeze
+    COLLAPSIBLES = %i[offcanvas icon none].freeze
+
+    def initialize(side: :left, variant: :sidebar, collapsible: :offcanvas, open: true, **attrs)
+      raise ArgumentError, "Invalid side: #{side}." unless SIDES.include?(side.to_sym)
+      raise ArgumentError "Invalid variant: #{variant}." unless VARIANTS.include?(variant.to_sym)
+      raise ArgumentError, "Invalid collapsible: #{collapsible}." unless COLLAPSIBLES.include?(collapsible.to_sym)
+
+      @side = side.to_sym
+      @variant = variant.to_sym
+      @collapsible = collapsible.to_sym
+      @open = open
+      super(**attrs)
+    end
+
+    def view_template(&)
+      if @collapsible == :none
+        NonCollapsiableSidebar(**attrs, &)
+      else
+        CollapsiableSidebar(side: @side, variant: @variant, collapsible: @collapsible, open: @open, **attrs, &)
+      end
+    end
+  end
+end

lib/ruby_ui/sidebar/sidebar_content.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class SidebarContent < Base
+    def view_template(&)
+      div(**attrs, &)
+    end
+
+    private
+
+    def default_attrs
+      {
+        class: "flex min-h-0 flex-1 flex-col gap-2 overflow-auto group-data-[collapsible=icon]:overflow-hidden",
+        data: {
+          sidebar: "content"
+        }
+      }
+    end
+  end
+end

lib/ruby_ui/sidebar/sidebar_controller.js

@@ -0,0 +1,67 @@
+import { Controller } from "@hotwired/stimulus";
+
+const SIDEBAR_COOKIE_NAME = "sidebar_state";
+const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
+const State = {
+  EXPANDED: "expanded",
+  COLLAPSED: "collapsed",
+};
+const MOBILE_BREAKPOINT = 768;
+
+export default class extends Controller {
+  static targets = ["sidebar", "mobileSidebar"];
+
+  sidebarTargetConnected() {
+    const { state, collapsibleKind } = this.sidebarTarget.dataset;
+
+    this.open = state === State.EXPANDED;
+    this.collapsibleKind = collapsibleKind;
+  }
+
+  toggle(e) {
+    e.preventDefault();
+
+    if (this.#isMobile()) {
+      this.#openMobileSidebar();
+
+      return;
+    }
+
+    this.open = !this.open;
+    this.onToggle();
+  }
+
+  onToggle() {
+    this.#updateSidebarState();
+    this.#persistSidebarState();
+  }
+
+  #updateSidebarState() {
+    if (!this.hasSidebarTarget) {
+      return;
+    }
+
+    const { dataset } = this.sidebarTarget;
+
+    dataset.state = this.open ? State.EXPANDED : State.COLLAPSED;
+    dataset.collapsible = this.open ? "" : this.collapsibleKind;
+  }
+
+  #persistSidebarState() {
+    document.cookie = `${SIDEBAR_COOKIE_NAME}=${this.open}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
+  }
+
+  #isMobile() {
+    return window.innerWidth < MOBILE_BREAKPOINT;
+  }
+
+  #openMobileSidebar() {
+    if (!this.hasMobileSidebarTarget) {
+      return;
+    }
+
+    this.mobileSidebarTarget.dispatchEvent(
+      new CustomEvent("ruby--ui-sidebar:open"),
+    );
+  }
+}

lib/ruby_ui/sidebar/sidebar_footer.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class SidebarFooter < Base
+    def view_template(&)
+      div(**attrs, &)
+    end
+
+    private
+
+    def default_attrs
+      {
+        class: "flex flex-col gap-2 p-2",
+        data: {
+          sidebar: "footer"
+        }
+      }
+    end
+  end
+end

lib/ruby_ui/sidebar/sidebar_group.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class SidebarGroup < Base
+    def view_template(&)
+      div(**attrs, &)
+    end
+
+    private
+
+    def default_attrs
+      {
+        class: "relative flex w-full min-w-0 flex-col p-2",
+        data: {
+          sidebar: "group"
+        }
+      }
+    end
+  end
+end

lib/ruby_ui/sidebar/sidebar_group_action.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class SidebarGroupAction < Base
+    def initialize(as: :button, **attrs)
+      @as = as
+      super(**attrs)
+    end
+
+    def view_template(&)
+      tag(@as, **attrs, &)
+    end
+
+    private
+
+    def default_attrs
+      {
+        class: [
+          "absolute right-3 top-3.5 flex aspect-square w-5 items-center",
+          "justify-center rounded-md p-0 text-sidebar-foreground",
+          "outline-none ring-sidebar-ring transition-transform",
+          "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
+          "focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
+          "after:absolute after:-inset-2 after:md:hidden",
+          "group-data-[collapsible=icon]:hidden"
+        ],
+        data: {
+          sidebar: "group-action"
+        }
+      }
+    end
+  end
+end

lib/ruby_ui/sidebar/sidebar_group_content.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RubyUI
+  class SidebarGroupContent < Base
+    def view_template(&)
+      div(**attrs, &)
+    end
+
+    private
+
+    def default_attrs
+      {
+        class: "w-full text-sm",
+        data: {
+          sidebar: "group-content"
+        }
+      }
+    end
+  end
+end