panda-core 0.9.1 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52d28416fc7360a3f5cc27ec2ad1f332a61426a8279853461dfe7398f180213a
-  data.tar.gz: f68cd0fbaf803d80a3549f67485328c80850e3d035d42f7c89eb1b15a80f6b64
+  metadata.gz: 3e7863be64e4e612a42759b596547772fdc8ea9f50d85dc57b6c879328cbb8fa
+  data.tar.gz: 14c99c7ad8e4dd48c69aecf9b958ab9201e77e5159affcdc3bba8bb5a6608998
 SHA512:
-  metadata.gz: d71325c49673982b5ae74107eb7e05cb0bd04b12bc64262284392df691b142953fb6f5a25385c4795d605ec243e972ac30cd8688fb4e7f95ebc43e360b7ba5e1
-  data.tar.gz: b0391beb484a72298375547b4d526e73ce47ea18a1d73864e6e2ef226e25fef961d83c268a5cdab12b5dbc1c08c984696f344bfe0e974d0e9c1a37badafdb035
+  metadata.gz: 337d68b1a7c03cedfdcea65f5978d13dc3cd6692d79188dc0132e4fb55a781d3b4c0991a23582e9fae585c88fa58ea314401f1a0cc5a9bc5059617d385536753
+  data.tar.gz: 5be39c37ddf7d54f51071bc2486fd33b81e1be1bc1176358c890180de86676ce7848d89b426ecad80663e7a72e371de164fb71b1a3bd82c44e6decd09519bf57

data/app/controllers/panda/core/admin/settings_controller.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Panda
+  module Core
+    module Admin
+      class SettingsController < AdminController
+        def show
+          # Placeholder for site settings page
+        end
+      end
+    end
+  end
+end

data/app/helpers/panda/core/asset_helper.rb

@@ -9,6 +9,10 @@ module Panda
       end
 
       # Include only Core JavaScript
+      #
+      # This is the single entry point for all Panda JavaScript loading.
+      # It automatically includes JavaScript from Core and all registered modules
+      # via ModuleRegistry.
       def panda_core_javascript
         # Use asset_tags for development mode (importmap) compatibility
         # In development, this will use importmap; in production/test, compiled bundles
@@ -22,20 +26,34 @@ module Panda
             javascript_include_tag(js_url, type: "module")
           end
         else
-          # Development mode - Use the engine's importmap (loaded in initializer)
-          # This keeps the engine's JavaScript separate from the app's importmap
-          # Build the importmap JSON manually since paths are already absolute
-          imports = {}
-          Panda::Core.importmap.instance_variable_get(:@packages).each do |name, package|
-            imports[name] = package[:path]
-          end
+          # Development mode - Use ModuleRegistry to combine all Panda module importmaps
+          imports = Panda::Core::ModuleRegistry.combined_importmap
 
           importmap_json = JSON.generate({"imports" => imports})
 
+          # Generate entry point script tags for Core and all registered modules
+          entry_points = []
+
+          # Core entry points (always included)
+          entry_points << '<script type="module">import "panda/core/application"</script>'
+          entry_points << '<script type="module">import "panda/core/controllers/index"</script>'
+
+          # Add entry points for each registered module
+          Panda::Core::ModuleRegistry.modules.each do |gem_name, info|
+            # Extract module namespace from gem name (e.g., "panda-cms" -> "cms")
+            module_slug = gem_name.sub(/^panda-/, "")
+
+            # Check if the module is actually loaded
+            module_name = info[:engine].sub(/::Engine$/, "")
+            next unless Object.const_defined?(module_name)
+
+            entry_points << %(<script type="module">import "panda/#{module_slug}/application"</script>)
+            entry_points << %(<script type="module">import "panda/#{module_slug}/controllers/index"</script>)
+          end
+
           <<~HTML.html_safe
             <script type="importmap">#{importmap_json}</script>
-            <script type="module">import "panda/core/application"</script>
-            <script type="module">import "panda/core/controllers/index"</script>
+            #{entry_points.join("\n")}
           HTML
         end
       end

data/app/views/panda/core/admin/settings/show.html.erb

@@ -0,0 +1,10 @@
+<%= render Panda::Core::Admin::ContainerComponent.new do %>
+  <%= render Panda::Core::Admin::HeadingComponent.new(level: 1, text: "Settings") %>
+
+  <div class="mt-6 space-y-6">
+    <%= render Panda::Core::Admin::PanelComponent.new do %>
+      <%= render Panda::Core::Admin::HeadingComponent.new(level: 2, text: "Site Settings") %>
+      <p class="text-sm text-gray-600 mt-2">Configure your site settings here.</p>
+    <% end %>
+  </div>
+<% end %>

data/app/views/panda/core/shared/_header.html.erb

@@ -6,11 +6,14 @@
     <%= csp_meta_tag %>
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@7.1.0/css/all.min.css">
     <%= panda_core_stylesheet %>
+
+    <!-- ES Module Shims polyfill - must load BEFORE importmap (blocking, not async) -->
+    <script src="https://ga.jspm.io/npm:[email protected]/dist/es-module-shims.js" crossorigin="anonymous"></script>
+
+    <!-- Panda JavaScript (Core + all registered modules via ModuleRegistry) -->
     <%= panda_core_javascript %>
 
     <% if defined?(Panda::CMS) && controller.class.name.start_with?("Panda::CMS") %>
-      <!-- CMS Assets -->
-      <%= panda_cms_javascript %>
       <%= render "panda/cms/shared/favicons" %>
     <% end %>
 

data/config/routes.rb

@@ -19,6 +19,9 @@ Panda::Core::Engine.routes.draw do
     # Profile management
     resource :my_profile, only: %i[show edit update], controller: "admin/my_profile", path: "my_profile"
 
+    # Settings
+    resource :settings, only: [:show], controller: "admin/settings"
+
     # Test-only authentication endpoint (available in development and test environments)
     # This bypasses OAuth for faster, more reliable test execution
     # Development: Used by Capybara system tests which run Rails server in development mode

data/lib/panda/core/asset_loader.rb

@@ -151,8 +151,9 @@ module Panda
             version = asset_version
             "/panda-core-assets/panda-core-#{version}.js"
           else
-            # Return importmap path
-            "/assets/panda/core/application.js"
+            # Return path for development/test mode
+            # JavaScript is served via importmap from app/javascript
+            "/panda/core/application.js"
           end
         end
 

data/lib/panda/core/engine/middleware_config.rb

@@ -4,29 +4,13 @@ module Panda
   module Core
     class Engine < ::Rails::Engine
       # Middleware configuration for static assets
+      # Note: Actual middleware is registered in engine.rb initializer
+      # This module is kept for organizational purposes
       module MiddlewareConfig
         extend ActiveSupport::Concern
 
-        included do
-          # Make files in public available to the main app (e.g. /panda-core-assets/panda-logo.png)
-          config.middleware.use Rack::Static,
-            urls: ["/panda-core-assets"],
-            root: Panda::Core::Engine.root.join("public"),
-            header_rules: [
-              # Disable caching in development for instant CSS updates
-              [:all, {"Cache-Control" => Rails.env.development? ? "no-cache, no-store, must-revalidate" : "public, max-age=31536000"}]
-            ]
-
-          # Make JavaScript files available for importmap
-          # Serve from app/javascript with proper MIME types
-          config.middleware.use Rack::Static,
-            urls: ["/panda", "/panda/core"],
-            root: Panda::Core::Engine.root.join("app/javascript"),
-            header_rules: [
-              [:all, {"Cache-Control" => Rails.env.development? ? "no-cache, no-store, must-revalidate" : "public, max-age=31536000",
-                      "Content-Type" => "text/javascript; charset=utf-8"}]
-            ]
-        end
+        # Middleware configuration moved to engine.rb initializer
+        # See lib/panda/core/engine.rb - initializer "panda.core.static_assets"
       end
     end
   end

data/lib/panda/core/engine.rb

@@ -57,6 +57,23 @@ module Panda
         # Configuration is already initialized with defaults in Configuration class
       end
 
+      # Static asset middleware for serving public files and JavaScript modules
+      # Must run before Propshaft to intercept /panda/* requests
+      initializer "panda.core.static_assets" do |app|
+        # Serve public assets (CSS, images, etc.)
+        app.config.middleware.insert_before Propshaft::Server, Rack::Static,
+          urls: ["/panda-core-assets"],
+          root: Panda::Core::Engine.root.join("public"),
+          header_rules: [
+            # Disable caching in development for instant CSS updates
+            [:all, {"Cache-Control" => Rails.env.development? ? "no-cache, no-store, must-revalidate" : "public, max-age=31536000"}]
+          ]
+
+        # Use ModuleRegistry's custom middleware to serve JavaScript from all registered modules
+        # This middleware checks all modules and serves from the first matching location
+        app.config.middleware.insert_before Propshaft::Server, Panda::Core::ModuleRegistry::JavaScriptMiddleware
+      end
+
       # Auto-compile CSS for test/development environments
       initializer "panda_core.auto_compile_assets", after: :load_config_initializers do |app|
         # Only auto-compile in test or when explicitly requested
@@ -104,3 +121,14 @@ module Panda
     end
   end
 end
+
+# Register Core module with ModuleRegistry for JavaScript serving
+Panda::Core::ModuleRegistry.register(
+  gem_name: "panda-core",
+  engine: "Panda::Core::Engine",
+  paths: {
+    views: "app/views/panda/core/**/*.erb",
+    components: "app/components/panda/core/**/*.rb"
+    # JavaScript paths are auto-discovered from config/importmap.rb
+  }
+)

data/lib/panda/core/module_registry.rb

@@ -144,8 +144,62 @@ module Panda
           @modules.key?(gem_name)
         end
 
+        # Returns a combined importmap for all registered modules
+        #
+        # This merges importmaps from Core and all registered modules (CMS, CMS Pro, etc.)
+        # into a single hash suitable for <script type="importmap"> generation.
+        #
+        # Order matters: Core imports are added first, then modules in registration order.
+        # If there are conflicts, later modules override earlier ones.
+        #
+        # @return [Hash] Combined imports hash {"module/name" => "/path/to/file.js"}
+        def combined_importmap
+          imports = {}
+
+          # Add Panda Core imports first (if Core has an importmap)
+          if defined?(Panda::Core.importmap)
+            Panda::Core.importmap.instance_variable_get(:@packages).each do |name, package|
+              imports[name] = package.path
+            end
+          end
+
+          # Add registered modules' importmaps in registration order
+          @modules.each do |gem_name, info|
+            next unless engine_available?(info[:engine])
+
+            # Get the module's importmap constant (e.g., Panda::CMS.importmap)
+            module_importmap = module_importmap_for(info[:engine])
+            next unless module_importmap
+
+            module_importmap.instance_variable_get(:@packages).each do |name, package|
+              imports[name] = package.path
+            end
+          end
+
+          imports
+        end
+
         private
 
+        # Get the importmap for a module
+        #
+        # @param engine_name [String] Engine constant name (e.g., "Panda::CMS::Engine")
+        # @return [Importmap::Map, nil] Module's importmap or nil if not available
+        def module_importmap_for(engine_name)
+          # Extract module namespace from engine name (e.g., "Panda::CMS::Engine" -> "Panda::CMS")
+          module_name = engine_name.sub(/::Engine$/, "")
+          return nil unless Object.const_defined?(module_name)
+
+          mod = Object.const_get(module_name)
+          return nil unless mod.respond_to?(:importmap)
+
+          mod.importmap
+        rescue NoMethodError
+          nil
+        rescue NameError
+          nil
+        end
+
         # Check if an engine constant is defined and available
         #
         # @param engine_name [String] Engine constant name
@@ -223,6 +277,99 @@ module Panda
           nil
         end
       end
+
+      # Custom Rack middleware to serve JavaScript modules from all registered Panda modules
+      #
+      # This middleware checks all registered modules' app/javascript/panda directories
+      # and serves the first matching file. This solves the problem of multiple Rack::Static
+      # instances blocking each other.
+      #
+      class JavaScriptMiddleware
+        def initialize(app)
+          @app = app
+        end
+
+        def call(env)
+          request = Rack::Request.new(env)
+          path = request.path_info
+
+          # Only handle /panda/core/* and /panda/cms/* style JavaScript module requests
+          # Skip paths like /panda-core-assets/* (public assets handled by Rack::Static)
+          return @app.call(env) unless path.start_with?("/panda/")
+
+          # Strip /panda/ prefix to get relative path
+          # e.g., "/panda/cms/application.js" -> "cms/application.js"
+          relative_path = path.sub(%r{^/panda/}, "")
+          return @app.call(env) if relative_path.empty?
+
+          # Try to find the file in registered modules
+          file_path = find_javascript_file(relative_path)
+
+          if file_path && File.file?(file_path)
+            puts "[JavaScriptMiddleware] Serving: #{path} from #{file_path}"
+            serve_file(file_path, env)
+          else
+            puts "[JavaScriptMiddleware] Not found: #{path} (tried #{relative_path})"
+            @app.call(env)
+          end
+        rescue => e
+          # On error, log and pass to next middleware
+          puts "[JavaScriptMiddleware] Error: #{e.message}"
+          Rails.logger.error("[ModuleRegistry::JavaScriptMiddleware] Error: #{e.message}\n#{e.backtrace.join("\n")}") if defined?(Rails.logger)
+          @app.call(env)
+        end
+
+        private
+
+        def find_javascript_file(relative_path)
+          # Check each registered module's JavaScript directory
+          ModuleRegistry.modules.each do |gem_name, info|
+            next unless ModuleRegistry.send(:engine_available?, info[:engine])
+
+            root = ModuleRegistry.send(:engine_root, info[:engine])
+            next unless root
+
+            # Check in app/javascript/panda/
+            candidate = root.join("app/javascript/panda", relative_path)
+            return candidate.to_s if candidate.exist? && candidate.file?
+          end
+
+          nil
+        end
+
+        def serve_file(file_path, env)
+          # Read file content
+          content = File.read(file_path)
+
+          # Determine content type
+          content_type = case File.extname(file_path)
+          when ".js"
+            "application/javascript; charset=utf-8"
+          when ".json"
+            "application/json; charset=utf-8"
+          else
+            "text/plain; charset=utf-8"
+          end
+
+          # Determine cache control
+          cache_control = if Rails.env.development? || Rails.env.test?
+            "no-cache, no-store, must-revalidate"
+          else
+            "public, max-age=31536000"
+          end
+
+          # Return response
+          [
+            200,
+            {
+              "Content-Type" => content_type,
+              "Content-Length" => content.bytesize.to_s,
+              "Cache-Control" => cache_control
+            },
+            [content]
+          ]
+        end
+      end
     end
   end
 end

data/lib/panda/core/testing/support/system/ci_capybara_config.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# CI-specific Capybara configuration
+# This file configures Capybara for GitHub Actions and other CI environments
+# It uses a more robust Puma setup with compatibility for Puma 6 and 7+
+
+return unless defined?(Capybara)
+
+ci_mode = ENV["GITHUB_ACTIONS"] == "true" || ENV["CI_SYSTEM_SPECS"] == "true"
+return unless ci_mode
+
+require "rack/handler/puma"
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    Capybara.server = :puma_ci
+    Capybara.default_max_wait_time = Integer(ENV.fetch("CAPYBARA_MAX_WAIT_TIME", 5))
+    Capybara.server_host = "127.0.0.1"
+    Capybara.always_include_port = true
+
+    puts "[CI Config] Capybara.server      = #{Capybara.server.inspect}"
+    puts "[CI Config] Capybara.server_host = #{Capybara.server_host.inspect}"
+    puts "[CI Config] Capybara.max_wait    = #{Capybara.default_max_wait_time}s"
+  end
+end
+
+Capybara.register_server :puma_ci do |app, port, host|
+  puts "[CI Config] Starting Puma (single mode) on #{host}:#{port}"
+
+  min_threads = Integer(ENV.fetch("PUMA_MIN_THREADS", "2"))
+  max_threads = Integer(ENV.fetch("PUMA_MAX_THREADS", "2"))
+
+  options = {
+    Host: host,
+    Port: port,
+    Threads: "#{min_threads}:#{max_threads}",
+    Workers: 0,
+    Silent: false,
+    Verbose: true,
+    PreloadApp: false
+  }
+
+  # --- Puma Compatibility Layer (supports Puma 6 AND Puma 7+) ---
+  puma_run = Rack::Handler::Puma.method(:run)
+
+  if puma_run.arity == 2
+    # Puma <= 6.x signature:
+    #   run(app, options_hash)
+    puts "[CI Config] Using Puma <= 6 API (arity 2)"
+    Rack::Handler::Puma.run(app, options)
+  else
+    # Puma >= 7.x signature:
+    #   run(app, **options)
+    puts "[CI Config] Using Puma >= 7 API (keyword args)"
+    Rack::Handler::Puma.run(app, **options)
+  end
+end

data/lib/panda/core/version.rb

@@ -2,6 +2,6 @@
 
 module Panda
   module Core
-    VERSION = "0.9.1"
+    VERSION = "0.9.3"
   end
 end

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: panda-core
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.3
 platform: ruby
 authors:
 - Otaina Limited
 - James Inman
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: image_processing
@@ -429,6 +430,7 @@ files:
 - app/controllers/panda/core/admin/dashboard_controller.rb
 - app/controllers/panda/core/admin/my_profile_controller.rb
 - app/controllers/panda/core/admin/sessions_controller.rb
+- app/controllers/panda/core/admin/settings_controller.rb
 - app/controllers/panda/core/admin/test_sessions_controller.rb
 - app/controllers/panda/core/application_controller.rb
 - app/helpers/panda/core/asset_helper.rb
@@ -456,6 +458,7 @@ files:
 - app/views/panda/core/admin/dashboard/show.html.erb
 - app/views/panda/core/admin/my_profile/edit.html.erb
 - app/views/panda/core/admin/sessions/new.html.erb
+- app/views/panda/core/admin/settings/show.html.erb
 - app/views/panda/core/admin/shared/_breadcrumbs.html.erb
 - app/views/panda/core/admin/shared/_flash.html.erb
 - app/views/panda/core/admin/shared/_sidebar.html.erb
@@ -506,6 +509,7 @@ files:
 - lib/panda/core/testing/support/setup.rb
 - lib/panda/core/testing/support/system/better_system_tests.rb
 - lib/panda/core/testing/support/system/capybara_setup.rb
+- lib/panda/core/testing/support/system/ci_capybara_config.rb
 - lib/panda/core/testing/support/system/cuprite_helpers.rb
 - lib/panda/core/testing/support/system/cuprite_setup.rb
 - lib/panda/core/testing/support/system/database_connection_helpers.rb
@@ -526,6 +530,7 @@ metadata:
   homepage_uri: https://github.com/tastybamboo/panda-core
   source_code_uri: https://github.com/tastybamboo/panda-core
   changelog_uri: https://github.com/tastybamboo/panda-core/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -540,7 +545,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Core libraries and development tools for Tasty Bamboo projects
 test_files: []