panda-core 0.1.16 → 0.2.1

data/app/views/panda/core/admin/shared/_breadcrumbs.html.erb

@@ -0,0 +1,35 @@
+<% if defined?(@breadcrumbs) && @breadcrumbs.any? %>
+  <div class="flex">
+    <nav class="flex-1 px-4 py-3 text-gray-700 border-b border-gray-200 bg-gray-50" aria-label="Breadcrumb" id="panda-breadcrumbs">
+      <ol class="inline-flex items-center space-x-1 md:space-x-3">
+        <% @breadcrumbs.each_with_index do |breadcrumb, index| %>
+          <li class="inline-flex items-center">
+            <% if index > 0 %>
+              <svg class="w-3 h-3 text-gray-400 mx-1" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 6 10">
+                <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="m1 9 4-4-4-4"/>
+              </svg>
+            <% end %>
+            
+            <% if breadcrumb.path && index < @breadcrumbs.length - 1 %>
+              <%= link_to breadcrumb.label, breadcrumb.path, class: "inline-flex items-center text-sm font-medium text-gray-700 hover:text-blue-600" %>
+            <% else %>
+              <span class="text-sm font-medium text-gray-500"><%= breadcrumb.label %></span>
+            <% end %>
+          </li>
+        <% end %>
+      </ol>
+    </nav>
+    
+    <% if content_for?(:sidebar) %>
+      <div class="px-4 py-3 border-b border-gray-200 bg-gray-50 text-gray-700" tabindex="-1" data-controller="toggle">
+        <a href="#" id="slideover-toggle" data-action="click->toggle#toggle touch->toggle#toggle" class="inline-flex items-center text-sm font-medium text-gray-700 hover:text-blue-600">
+          <svg class="w-4 h-4 mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"></path>
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"></path>
+          </svg>
+          <%= yield(:sidebar_title) || "Settings" %>
+        </a>
+      </div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/panda/core/admin/shared/_flash.html.erb

@@ -0,0 +1,31 @@
+<% if flash.any? %>
+  <div class="fixed top-4 right-4 z-50 space-y-2">
+    <% flash.each do |type, message| %>
+      <div class="bg-white rounded-lg shadow-lg p-4 max-w-sm" data-controller="flash" data-flash-delay-value="5000">
+        <div class="flex items-start">
+          <div class="flex-shrink-0">
+            <% if type == "success" %>
+              <i class="fa-regular fa-check-circle text-green-500"></i>
+            <% elsif type == "error" %>
+              <i class="fa-regular fa-times-circle text-red-500"></i>
+            <% elsif type == "warning" %>
+              <i class="fa-regular fa-exclamation-triangle text-yellow-500"></i>
+            <% else %>
+              <i class="fa-regular fa-info-circle text-blue-500"></i>
+            <% end %>
+          </div>
+          <div class="ml-3 w-0 flex-1">
+            <p class="text-sm font-medium text-gray-900">
+              <%= message %>
+            </p>
+          </div>
+          <div class="ml-4 flex-shrink-0 flex">
+            <button type="button" class="bg-white rounded-md inline-flex text-gray-400 hover:text-gray-500" data-action="click->flash#close">
+              <i class="fa-regular fa-times"></i>
+            </button>
+          </div>
+        </div>
+      </div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/panda/core/admin/shared/_sidebar.html.erb

@@ -0,0 +1,27 @@
+<nav class="flex flex-col flex-1">
+  <ul role="list" class="flex flex-col flex-1 gap-y-7">
+    <li>
+      <ul role="list" class="-mx-2 space-y-1">
+        <% Panda::Core.configuration.admin_navigation_items&.call(current_user)&.each do |item| %>
+          <li>
+            <%= link_to item[:path], class: "group flex gap-x-3 rounded-md p-2 text-sm leading-6 font-semibold text-gray-200 hover:text-white hover:bg-gray-700" do %>
+              <i class="<%= item[:icon] %> text-gray-200 group-hover:text-white"></i>
+              <%= item[:label] %>
+            <% end %>
+          </li>
+        <% end %>
+      </ul>
+    </li>
+    
+    <li class="mt-auto">
+      <div class="flex items-center gap-x-4 px-6 py-3 text-sm font-semibold leading-6 text-gray-200">
+        <% if current_user %>
+          <span class="flex-1"><%= "#{current_user.firstname} #{current_user.lastname}" %></span>
+          <%= link_to panda_core.admin_logout_path, method: :delete, class: "text-gray-200 hover:text-white" do %>
+            <i class="fa-regular fa-sign-out"></i>
+          <% end %>
+        <% end %>
+      </div>
+    </li>
+  </ul>
+</nav>

data/app/views/panda/core/admin/shared/_slideover.html.erb

@@ -0,0 +1,33 @@
+<div class="fixed inset-0 z-50 lg:hidden" role="dialog" aria-modal="true" id="mobile-slideover">
+  <div class="fixed inset-0 bg-gray-600 bg-opacity-75"></div>
+  <div class="fixed inset-0 flex">
+    <div class="relative flex w-full max-w-xs flex-1 flex-col bg-gray-800">
+      <div class="absolute top-0 right-0 -mr-12 pt-2">
+        <button type="button" class="ml-1 flex h-10 w-10 items-center justify-center rounded-full focus:outline-none focus:ring-2 focus:ring-inset focus:ring-white">
+          <span class="sr-only">Close sidebar</span>
+          <svg class="h-6 w-6 text-white" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
+          </svg>
+        </button>
+      </div>
+      <%= yield %>
+    </div>
+  </div>
+</div>
+
+<div class="hidden lg:flex lg:flex-shrink-0" id="slideover" data-toggle-target="content">
+  <div class="flex w-96">
+    <div class="flex min-h-0 flex-1 flex-col bg-gray-50 border-l border-gray-200">
+      <% if content_for?(:sidebar_title) %>
+        <div class="flex h-16 flex-shrink-0 items-center border-b border-gray-200 px-6">
+          <h2 class="text-lg font-medium text-gray-900"><%= yield :sidebar_title %></h2>
+        </div>
+      <% end %>
+      <div class="flex flex-1 flex-col overflow-y-auto">
+        <div class="px-6 py-4">
+          <%= yield %>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>

data/config/routes.rb

@@ -0,0 +1,22 @@
+Panda::Core::Engine.routes.draw do
+  # Use the configured admin path (defaults to "/admin")
+  admin_path = Panda::Core.configuration.admin_path.delete_prefix("/")
+  
+  scope path: admin_path, as: "admin" do
+    get "/login", to: "admin/sessions#new", as: :login
+    
+    # OmniAuth routes - middleware handles /admin/auth/:provider automatically
+    # We just need to define the callback routes
+    get "/auth/:provider/callback", to: "admin/sessions#create", as: :auth_callback
+    post "/auth/:provider/callback", to: "admin/sessions#create"
+    get "/auth/failure", to: "admin/sessions#failure", as: :auth_failure
+    delete "/logout", to: "admin/sessions#destroy", as: :logout
+
+    constraints Panda::Core::AdminConstraint.new do
+      get "/", to: "admin/dashboard#show", as: :root
+      
+      # Profile management
+      resource :my_profile, only: %i[edit update], controller: "admin/my_profile", path: "my_profile"
+    end
+  end
+end

data/db/migrate/20241210000003_add_current_theme_to_panda_core_users.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class AddCurrentThemeToPandaCoreUsers < ActiveRecord::Migration[7.1]
+  def change
+    add_column :panda_core_users, :current_theme, :string, default: "default"
+  end
+end

data/db/migrate/20250809000001_create_panda_core_users.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreatePandaCoreUsers < ActiveRecord::Migration[7.1]
+  def change
+    create_table :panda_core_users, id: :uuid do |t|
+      t.string :firstname, null: false
+      t.string :lastname, null: false
+      t.string :email, null: false
+      t.string :image_url
+      t.boolean :admin, default: false, null: false
+      t.timestamps
+    end
+
+    add_index :panda_core_users, :email, unique: true
+  end
+end

data/lib/generators/panda/core/dev_tools/USAGE

@@ -0,0 +1,24 @@
+Description:
+    Sets up or updates Panda Core development tools in your gem or Rails application.
+    This includes linting configurations, testing helpers, and CI/CD workflows.
+
+Example:
+    # Initial setup
+    rails generate panda:core:dev_tools
+
+    # Force update (overwrites existing files)
+    rails generate panda:core:dev_tools --force
+
+    # Skip adding dependencies to Gemfile
+    rails generate panda:core:dev_tools --skip-dependencies
+
+    This will:
+        - Copy .standard.yml, .yamllint, and .rspec configurations
+        - Set up GitHub Actions workflows for CI and releases
+        - Add development dependencies to your Gemfile
+        - Create testing helper configuration
+        - Add rake tasks for linting and security checks
+        - Track version for future updates
+
+    To check for updates later:
+        bundle exec rake panda:check_updates

data/lib/generators/panda/core/dev_tools/templates/lefthook.yml

@@ -0,0 +1,13 @@
+---
+assert_lefthook_installed: true
+colors: true
+pre-commit:
+  parallel: true
+  jobs:
+    - name: bundle-audit
+      run: bundle exec bundle-audit --update
+    - name: bundle-outdated
+      run: bundle outdated --strict
+    - name: standardrb
+      run: bundle exec standardrb --fix {all_files}
+      glob: "**/*.rb"

data/lib/generators/panda/core/dev_tools/templates/spec_support_panda_core_helpers.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "panda/core/testing/rspec_config"
+require "panda/core/testing/omniauth_helpers"
+require "panda/core/testing/capybara_config"
+
+RSpec.configure do |config|
+  # Apply Panda Core RSpec configuration
+  Panda::Core::Testing::RSpecConfig.configure(config)
+  Panda::Core::Testing::RSpecConfig.setup_matchers
+
+  # Configure Capybara
+  Panda::Core::Testing::CapybaraConfig.configure
+
+  # Include helpers
+  config.include Panda::Core::Testing::OmniAuthHelpers, type: :system
+  config.include Panda::Core::Testing::CapybaraConfig::Helpers, type: :system
+end

data/lib/generators/panda/core/dev_tools_generator.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Panda
+  module Core
+    module Generators
+      class DevToolsGenerator < Rails::Generators::Base
+        source_root File.expand_path("dev_tools/templates", __dir__)
+
+        desc "Set up or update Panda Core development tools in your gem/application"
+
+        class_option :force, type: :boolean, default: false,
+          desc: "Overwrite existing files"
+        class_option :skip_dependencies, type: :boolean, default: false,
+          desc: "Skip adding dependencies to Gemfile"
+
+        VERSION_FILE = ".panda-dev-tools-version"
+        CURRENT_VERSION = "1.0.0"
+
+        def check_for_updates
+          if File.exist?(VERSION_FILE)
+            installed_version = File.read(VERSION_FILE).strip
+            if installed_version != CURRENT_VERSION
+              say "Updating Panda Core dev tools from #{installed_version} to #{CURRENT_VERSION}", :yellow
+              @updating = true
+            else
+              say "Panda Core dev tools are up to date (#{CURRENT_VERSION})", :green
+              unless options[:force]
+                say "Use --force to reinstall anyway"
+                nil
+              end
+            end
+          else
+            say "Installing Panda Core dev tools #{CURRENT_VERSION}", :green
+            @updating = false
+          end
+        end
+
+        def copy_linting_configs
+          say "Copying linting configurations..."
+          copy_file ".standard.yml", force: options[:force] || @updating
+          copy_file ".yamllint", force: options[:force] || @updating
+          copy_file ".rspec", force: options[:force] || @updating
+          copy_file "lefthook.yml", force: options[:force] || @updating
+        end
+
+        def copy_github_workflows
+          say "Copying GitHub Actions workflows..."
+          directory ".github", ".github", force: options[:force] || @updating
+        end
+
+        def create_version_file
+          create_file VERSION_FILE, CURRENT_VERSION, force: true
+        end
+
+        def add_development_dependencies
+          say "Adding development dependencies to gemspec..."
+
+          if File.exist?("Gemfile")
+            append_to_file "Gemfile" do
+              <<~RUBY
+                
+                group :development, :test do
+                  # Panda Core development tools
+                  gem "standard"
+                  gem "brakeman"
+                  gem "bundler-audit"
+                  gem "yamllint"
+                end
+              RUBY
+            end
+          end
+        end
+
+        def create_spec_helper
+          say "Creating spec helper with Panda Core testing configuration..."
+
+          create_file "spec/support/panda_core_helpers.rb" do
+            <<~RUBY
+              # frozen_string_literal: true
+              
+              require 'panda/core/testing/rspec_config'
+              require 'panda/core/testing/omniauth_helpers'
+              require 'panda/core/testing/capybara_config'
+              
+              RSpec.configure do |config|
+                # Apply Panda Core RSpec configuration
+                Panda::Core::Testing::RSpecConfig.configure(config)
+                Panda::Core::Testing::RSpecConfig.setup_matchers
+                
+                # Configure Capybara
+                Panda::Core::Testing::CapybaraConfig.configure
+                
+                # Include helpers
+                config.include Panda::Core::Testing::OmniAuthHelpers, type: :system
+                config.include Panda::Core::Testing::CapybaraConfig::Helpers, type: :system
+              end
+            RUBY
+          end
+        end
+
+        def add_rake_tasks
+          say "Adding Panda Core rake tasks..."
+
+          append_to_file "Rakefile" do
+            <<~RUBY
+              
+              # Panda Core development tasks
+              namespace :panda do
+                desc "Run all linters"
+                task :lint do
+                  sh "bundle exec standardrb"
+                  sh "yamllint -c .yamllint ."
+                end
+                
+                desc "Run security checks"
+                task :security do
+                  sh "bundle exec brakeman --quiet"
+                  sh "bundle exec bundle-audit --update"
+                end
+                
+                desc "Run all quality checks"
+                task quality: [:lint, :security]
+              end
+            RUBY
+          end
+        end
+
+        def display_instructions
+          say "\n✅ Panda Core development tools have been set up!", :green
+          say "\nNext steps:"
+          say "  1. Run 'bundle install' to install new dependencies"
+          say "  2. Run 'bundle exec rake panda:quality' to check code quality"
+          say "  3. Customize .github/workflows for your gem's needs"
+          say "  4. Add 'require' statements to your spec_helper.rb or rails_helper.rb:"
+          say "     require 'support/panda_core_helpers'"
+          say "\nFor more information, see: docs/development_tools.md"
+        end
+      end
+    end
+  end
+end

data/lib/panda/core/asset_loader.rb

@@ -0,0 +1,221 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'fileutils'
+require 'json'
+
+module Panda
+  module Core
+    # AssetLoader handles loading compiled assets from GitHub releases
+    # Falls back to local development assets when GitHub assets unavailable
+    class AssetLoader
+      class << self
+        # Generate HTML tags for loading Panda Core assets
+        def asset_tags(options = {})
+          if use_github_assets?
+            github_asset_tags(options)
+          else
+            development_asset_tags(options)
+          end
+        end
+
+        # Get the JavaScript asset URL
+        def javascript_url
+          if use_github_assets?
+            github_javascript_url
+          else
+            development_javascript_url
+          end
+        end
+
+        # Get the CSS asset URL (if exists)
+        def css_url
+          if use_github_assets?
+            github_css_url
+          else
+            development_css_url
+          end
+        end
+
+        # Check if GitHub-hosted assets should be used
+        def use_github_assets?
+          # Use GitHub assets in production or when explicitly enabled
+          Rails.env.production? ||
+            ENV['PANDA_CORE_USE_GITHUB_ASSETS'] == 'true' ||
+            !development_assets_available? ||
+            ((Rails.env.test? || in_test_environment?) && compiled_assets_available?)
+        end
+
+        private
+
+        def github_asset_tags(_options = {})
+          version = asset_version
+          base_url = github_base_url(version)
+
+          tags = []
+
+          # JavaScript tag with integrity check
+          js_url = "#{base_url}panda-core-#{version}.js"
+
+          js_attrs = {
+            src: js_url
+          }
+          # In CI environment, don't use defer to ensure immediate execution
+          js_attrs[:defer] = true unless ENV['GITHUB_ACTIONS'] == 'true'
+
+          tags << content_tag(:script, '', js_attrs)
+
+          # CSS tag if CSS bundle exists
+          css_url = "#{base_url}panda-core-#{version}.css"
+          if github_asset_exists?(version, "panda-core-#{version}.css")
+            css_attrs = {
+              rel: 'stylesheet',
+              href: css_url
+            }
+            tags << tag(:link, css_attrs)
+          end
+
+          tags.join("\n").html_safe
+        end
+
+        def development_asset_tags(_options = {})
+          # In test environment with CI, always use compiled assets
+          if (Rails.env.test? || ENV['CI'].present?) && compiled_assets_available?
+            # Use the same logic as GitHub assets but with local paths
+            version = asset_version
+            js_url = "/panda-core-assets/panda-core-#{version}.js"
+            css_url = "/panda-core-assets/panda-core-#{version}.css"
+
+            tags = []
+
+            # JavaScript tag
+            js_attrs = {
+              src: js_url
+            }
+            js_attrs[:defer] = true unless ENV['GITHUB_ACTIONS'] == 'true'
+            tags << content_tag(:script, '', js_attrs)
+
+            # CSS tag if exists
+            if File.exist?(Rails.root.join('public', 'panda-core-assets', "panda-core-#{version}.css"))
+              css_attrs = {
+                rel: 'stylesheet',
+                href: css_url
+              }
+              tags << tag(:link, css_attrs)
+            end
+
+          else
+            # Development mode - use importmap
+            tags = []
+            tags << javascript_include_tag('panda/core/application', type: 'module')
+          end
+          tags.join("\n").html_safe
+        end
+
+        def github_javascript_url
+          version = asset_version
+          # In test environment with local compiled assets, use local URL
+          if Rails.env.test? && compiled_assets_available?
+            "/panda-core-assets/panda-core-#{version}.js"
+          else
+            "#{github_base_url(version)}panda-core-#{version}.js"
+          end
+        end
+
+        def github_css_url
+          version = asset_version
+          # In test environment with local compiled assets, use local URL
+          if Rails.env.test? && compiled_assets_available?
+            css_file = "/panda-core-assets/panda-core-#{version}.css"
+            File.exist?(Rails.root.join("public#{css_file}")) ? css_file : nil
+          else
+            "#{github_base_url(version)}panda-core-#{version}.css"
+          end
+        end
+
+        def development_javascript_url
+          if compiled_assets_available?
+            version = asset_version
+            "/panda-core-assets/panda-core-#{version}.js"
+          else
+            # Return importmap path
+            '/assets/panda/core/application.js'
+          end
+        end
+
+        def development_css_url
+          return unless compiled_assets_available?
+
+          version = asset_version
+          css_file = "/panda-core-assets/panda-core-#{version}.css"
+          File.exist?(Rails.root.join("public#{css_file}")) ? css_file : nil
+        end
+
+        def asset_version
+          Panda::Core::VERSION
+        end
+
+        def github_base_url(version)
+          "https://github.com/tastybamboo/panda-core/releases/download/v#{version}/"
+        end
+
+        def github_asset_exists?(_version, _filename)
+          # For now, assume assets exist if we're using GitHub mode
+          # Could implement actual checking via GitHub API
+          true
+        end
+
+        def development_assets_available?
+          # Check if we're in a development environment with importmap available
+          Rails.env.development? && defined?(Importmap)
+        end
+
+        def compiled_assets_available?
+          # Check if compiled assets exist in test location
+          version = asset_version
+          js_file = Rails.public_path.join('panda-core-assets', "panda-core-#{version}.js")
+          js_file.exist?
+        end
+
+        def in_test_environment?
+          # Additional check for test environment indicators
+          ENV['CI'].present? || ENV['GITHUB_ACTIONS'].present? || ENV['RAILS_ENV'] == 'test'
+        end
+
+        # Helper methods to match ActionView helpers
+        def content_tag(name, content = nil, options = {})
+          attrs = options.map do |k, v|
+            if v == true
+              k.to_s
+            elsif v
+              "#{k}=\"#{v}\""
+            end
+          end.compact.join(' ')
+
+          if content || block_given?
+            "<#{name}#{attrs.present? ? " #{attrs}" : ''}>#{content || (block_given? ? yield : '')}</#{name}>"
+          else
+            "<#{name}#{attrs.present? ? " #{attrs}" : ''}><#{name}>"
+          end
+        end
+
+        def tag(name, options = {})
+          attrs = options.map do |k, v|
+            if v == true
+              k.to_s
+            elsif v
+              "#{k}=\"#{v}\""
+            end
+          end.compact.join(' ')
+
+          "<#{name}#{attrs.present? ? " #{attrs}" : ''} />"
+        end
+
+        def javascript_include_tag(source, options = {})
+          options[:src] = source.start_with?('/') ? source : "/assets/#{source}"
+          content_tag(:script, '', options)
+        end
+      end
+    end
+  end
+end

data/lib/panda/core/authentication.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Panda
+  module Core
+    module Authentication
+      extend ActiveSupport::Concern
+
+      included do
+        helper_method :current_user if respond_to?(:helper_method)
+      end
+
+      def current_user
+        return @current_user if defined?(@current_user)
+        @current_user = User.find_by(id: session[:user_id]) if session[:user_id]
+      end
+
+      def require_authentication
+        redirect_to admin_login_path unless current_user
+      end
+
+      def require_admin
+        redirect_to admin_login_path unless current_user&.admin?
+      end
+
+      def sign_in(user)
+        session[:user_id] = user.id
+        @current_user = user
+      end
+
+      def sign_out
+        session.delete(:user_id)
+        @current_user = nil
+      end
+    end
+  end
+end

data/lib/panda/core/component_registry.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Panda
+  module Core
+    class ComponentRegistry
+      class << self
+        def components
+          @components ||= {}
+        end
+
+        def register(name, component_class)
+          components[name.to_sym] = component_class
+        end
+
+        def unregister(name)
+          components.delete(name.to_sym)
+        end
+
+        def get(name)
+          components[name.to_sym]
+        end
+
+        def all
+          components
+        end
+
+        def clear!
+          @components = {}
+        end
+
+        def registered?(name)
+          components.key?(name.to_sym)
+        end
+      end
+    end
+  end
+end