panda-core 0.10.6 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d19f2a3ddaf8824cf777911ccd3f763d705088ab6af1b42b0bbf25d27ef47813
-  data.tar.gz: 8670e719ed3e22b8eb3fc4c846b18b0714096989adcfa975859015c4c95ccb66
+  metadata.gz: ecbb8f9e4f925e37db74cbb9bec9b45277feceafc990fbab333433adf86e8e36
+  data.tar.gz: ab419ee62bb77a3c382b462997439853ec07e438a37ea0d02935eb52d69d7169
 SHA512:
-  metadata.gz: a4d9001b13004fc24c8f19a7d770509293ed9908d77baef27f34f72688a9519dd26fc9a99d3310259bd25f60e888be4866c9a13369c4d674e57c3962932c0f30
-  data.tar.gz: 1ed6107145993f8cf0eb0bc1576d2f31e310be2a51a45170ea25b2556b2301f3b470680a004d200f14a088f88e5cc37571371b3b9611c345f19ffbc9b9a12ee2
+  metadata.gz: 79f71a37792d0c3b85edb9d211459e2b1433c3fab96bc8adfa707bb8ce443f11c80cdb12c05a75a03154912908c1bb759fdc2031b3ae1840a045f1629d3f0d14
+  data.tar.gz: 1d4f21c85d14ee7a474d8a83f1d99bccac31761a2803372a9d10d49156618cc40331d598ea805273040f8b56b5f4562bd873765bde423c76e358a76aab8ca56a

data/README.md

@@ -5,6 +5,26 @@ Core functionality shared between Panda Software gems:
 - [Panda CMS](https://github.com/tastybamboo/panda-cms)
 - [Panda Editor](https://github.com/tastybamboo/panda-editor)
 
+## Requirements
+
+### Database Support
+
+Panda Core supports both PostgreSQL and SQLite3 databases:
+
+**PostgreSQL** (recommended for production):
+
+- PostgreSQL 12, 15, 17, 18
+- Tested against all versions in CI
+- Uses native UUID generation (`gen_random_uuid()`)
+
+**SQLite3** (development/testing):
+
+- SQLite 3.x
+- Uses application-level UUID generation
+- Ideal for local development and testing
+
+Both databases are tested extensively in CI across multiple Ruby and Rails versions to ensure cross-database compatibility.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -144,33 +164,6 @@ Panda Core uses Tailwind CSS v4 to compile all admin interface styling.
 
 **Quick Start** - Compile full CSS (Core + CMS):
 
-```bash
-cd /path/to/panda-core
-
-bundle exec tailwindcss -i app/assets/tailwind/application.css \
-  -o public/panda-core-assets/panda-core.css \
-  --content '../cms/app/views/**/*.erb' \
-  --content '../cms/app/components/**/*.rb' \
-  --content '../cms/app/javascript/**/*.js' \
-  --content 'app/views/**/*.erb' \
-  --content 'app/components/**/*.rb' \
-  --minify
-```
-
-**Result**: `panda-core.css` (~37KB) with all utility classes
-
-**Important**: Always compile with full content before committing!
-
-For complete documentation on:
-- Development workflows (Core-only vs full stack)
-- Release processes
-- Troubleshooting
-- Best practices
-
-See **[docs/ASSET_COMPILATION.md](docs/ASSET_COMPILATION.md)**
-
-**How Asset Serving Works:**
-
 Core's Rack middleware serves `/panda-core-assets/` from the gem's `public/` directory:
 
 ```ruby
@@ -190,7 +183,7 @@ This means:
 **What Gets Compiled:**
 
 The compilation process:
-- Scans all Core and CMS views/components for Tailwind classes (via `tailwind.config.js`)
+- Scans all Core and registered modules' views/components for Tailwind classes
 - Includes EditorJS content styles for rich text editing
 - Applies theme variables for default and sky themes
 - Outputs a single minified CSS file (~37KB)
@@ -208,28 +201,15 @@ Panda CMS depends on Panda Core and loads its CSS automatically:
 <link rel="stylesheet" href="/panda-core-assets/panda-core.css">
 ```
 
-CMS no longer compiles its own CSS - all styling comes from Core.
-
-**Content Scanning**
-
-The `tailwind.config.js` file configures content scanning to include:
-- Core views: `../../app/views/**/*.html.erb`
-- Core components: `../../app/components/**/*.rb`
-- CMS views: `../../../cms/app/views/**/*.html.erb`
-- CMS components: `../../../cms/app/components/**/*.rb`
-- CMS JavaScript: `../../../cms/app/javascript/**/*.js`
-
 This ensures all Tailwind classes used across the Panda ecosystem are included in the compiled CSS.
 
-**Customizing Styles**
+To regenerate CSS, run (from inside `panda-core` or another engine):
 
-To customize the admin interface styles:
+```
+bundle exec rake app:panda:compile_css
+```
 
-1. Edit `app/assets/tailwind/application.css` in panda-core
-2. Add custom CSS in the appropriate `@layer` (base, components, or utilities)
-3. Recompile: `bundle exec tailwindcss -i app/assets/tailwind/application.css -o public/panda-core-assets/panda-core.css --minify`
-4. Copy the updated CSS to test locations if needed
-5. Restart your Rails server to see changes
+You should run this from the top-most or last registered engine in your application.
 
 **Theme System**
 

data/app/assets/tailwind/application.css

@@ -1,13 +1,5 @@
 @import 'tailwindcss';
 
-@source "../../app/views/**/*.html.erb";
-@source "../../app/components/**/*.html.erb";
-@source "../../app/components/**/*.rb";
-@source "../../app/helpers/**/*.rb";
-@source "../../../cms/app/views/**/*.html.erb";
-@source "../../../cms/app/components/**/*.html.erb";
-@source "../../../cms/app/components/**/*.rb";
-
 @theme {
   /* Legacy colors */
   --color-white: var(--color-white);
@@ -250,6 +242,12 @@
   .btn-danger {
     @apply bg-red-600 text-white hover:bg-red-700 focus:ring-red-500;
   }
+
+  a.block-link:after {
+    position: absolute;
+    content: '';
+    inset: 0;
+  }
 }
 
 /* EditorJS content styles */

data/app/models/concerns/panda/core/has_uuid.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Panda
+  module Core
+    # Concern for models using UUIDs as primary keys
+    # Ensures UUID generation works across all database adapters
+    module HasUUID
+      extend ActiveSupport::Concern
+
+      included do
+        # Generate UUID before creation if not already set
+        # PostgreSQL uses gen_random_uuid() natively
+        # SQLite and other databases use SecureRandom.uuid
+        before_create :generate_uuid_if_blank
+      end
+
+      private
+
+      def generate_uuid_if_blank
+        self.id ||= SecureRandom.uuid if id.blank?
+      end
+    end
+  end
+end

data/app/models/panda/core/user.rb

@@ -3,6 +3,8 @@
 module Panda
   module Core
     class User < ApplicationRecord
+      include HasUUID
+
       self.table_name = "panda_core_users"
 
       # Active Storage attachment for avatar with variants
@@ -69,14 +71,6 @@ module Panda
         true
       end
 
-      def name
-        if self[:name].present?
-          self[:name]
-        else
-          email&.split("@")&.first || "Unknown User"
-        end
-      end
-
       # Returns the URL for the user's avatar
       # Prefers Active Storage attachment over OAuth provider URL
       # @param size [Symbol] The variant size (:thumb, :small, :medium, :large, or nil for original)

data/db/migrate/20250809000001_create_panda_core_users.rb

@@ -2,16 +2,21 @@
 
 class CreatePandaCoreUsers < ActiveRecord::Migration[7.1]
   def change
-    unless table_exists?(:panda_core_users)
-      create_table :panda_core_users, id: :uuid do |t|
-        t.string :name
-        t.string :email, null: false
-        t.string :image_url
-        t.boolean :is_admin, default: false, null: false
-        t.timestamps
-      end
+    # Enable pgcrypto extension for PostgreSQL UUID generation
+    enable_extension "pgcrypto" if ActiveRecord::Base.connection.adapter_name == "PostgreSQL"
 
-      add_index :panda_core_users, :email, unique: true
+    # Rails 7.1+ supports id: :uuid across databases
+    # PostgreSQL uses gen_random_uuid(), SQLite uses application-generated UUIDs
+    create_table :panda_core_users, id: :uuid do |t|
+      t.string :name
+      t.string :email, null: false
+      t.string :image_url
+      t.boolean :is_admin, default: false, null: false
+      t.string :current_theme
+      t.string :oauth_avatar_url
+      t.timestamps
     end
+
+    add_index :panda_core_users, :email, unique: true
   end
 end

data/lib/panda/core/engine.rb

@@ -81,8 +81,10 @@ Panda::Core::ModuleRegistry.register(
   gem_name: "panda-core",
   engine: "Panda::Core::Engine",
   paths: {
+    builders: "app/builders/panda/core/**/*.rb",
+    components: "app/components/panda/core/**/*.rb",
+    helpers: "app/helpers/panda/core/**/*.rb",
     views: "app/views/panda/core/**/*.erb",
-    components: "app/components/panda/core/**/*.rb"
-    # JavaScript paths are auto-discovered from config/importmap.rb
+    javascripts: "app/assets/javascript/panda/core/**/*.js"
   }
 )

data/lib/panda/core/shared/inflections_config.rb

@@ -15,6 +15,7 @@ module Panda
               inflect.acronym "CMS"
               inflect.acronym "SEO"
               inflect.acronym "AI"
+              inflect.acronym "UUID"
             end
           end
         end

data/lib/panda/core/version.rb

@@ -2,6 +2,6 @@
 
 module Panda
   module Core
-    VERSION = "0.10.6"
+    VERSION = "0.11.0"
   end
 end

data/lib/tasks/panda/core/ci_tasks.rake

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# TODO: These should ideally move to the panda: namespace and lint across all loaded modules
+
+namespace :panda do
+  namespace :core do
+    desc "Run all linters"
+    task :lint do
+      puts "Running Ruby linter..."
+      sh "bundle exec standardrb"
+      puts "Running YAML linter..."
+      sh "yamllint -c .yamllint ."
+    end
+
+    namespace :lint do
+      desc "Run Ruby linter"
+      task :ruby do
+        sh "bundle exec standardrb"
+      end
+
+      desc "Run YAML linter"
+      task :yaml do
+        sh "yamllint -c .yamllint ."
+      end
+    end
+
+    desc "Run security checks"
+    task :security do
+      puts "Running Brakeman..."
+      sh "bundle exec brakeman --quiet"
+      puts "Running Bundler Audit..."
+      sh "bundle exec bundle-audit --update"
+    end
+
+    desc "Run all quality checks"
+    task quality: [:lint, :security]
+  end
+end

data/lib/tasks/panda/core/migrations.rake

@@ -3,7 +3,6 @@
 namespace :panda do
   namespace :core do
     namespace :install do
-      desc "Copy migrations from panda_core to application"
       task :migrations do
         # Delegate to the auto-generated task
         Rake::Task["panda_core:install:migrations"].invoke

data/lib/tasks/panda/shared.rake

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+namespace :panda do
+  desc "Show all registered modules"
+  task registered_modules: :environment do
+    Panda::Core::ModuleRegistry.modules(&:map).each do |registered_module, module_attrs|
+      puts registered_modules
+    end
+  end
+
+  desc "Compile the Panda CSS"
+  task compile_css: :environment do
+    Rails.logger = Logger.new($stdout) if Rails.env.development? || Rails.env.test?
+
+    core_gemspec = Gem::Specification.find_by_name("panda-core")
+    output_dir = "#{core_gemspec.full_gem_path}/public/panda-core-assets"
+
+    puts "\n" + ("=" * 80)
+    puts "Panda CSS Compilation"
+    puts "=" * 80
+
+    registered_modules = Panda::Core::ModuleRegistry.modules(&:map)
+
+    puts "\n📦 Found #{registered_modules.length} registered Panda module(s):"
+    registered_modules.each do |gem_name, _info|
+      puts "   • #{gem_name}"
+    end
+
+    if registered_modules.length == 1
+      puts "\n⚠️  Warning: Only compiling CSS for panda-core (no other modules loaded)"
+    end
+
+    puts "\n🎨 Output: #{output_dir}/panda-core.css"
+    puts ""
+
+    command = ["bundle exec tailwindcss",
+      "-i #{core_gemspec.full_gem_path}/app/assets/tailwind/application.css",
+      "-o #{output_dir}/panda-core.css"]
+
+    content_paths_count = 0
+    registered_modules.each do |gem_name, info|
+      gem_path = begin
+        gem_spec = Gem::Specification.find_by_name(gem_name)
+        gem_spec.full_gem_path
+      rescue Gem::LoadError
+        Rails.logger.error { "Gem '#{gem_name}' not installed; can't compile panda-core CSS for it" }
+        next
+      end
+
+      info[:paths].each do |asset_type, path|
+        command << "--content '#{gem_path}/#{path}'"
+        content_paths_count += 1
+      end
+    end
+
+    puts "📂 Scanning #{content_paths_count} content path(s) for Tailwind classes..."
+    puts ""
+
+    command << "--minify"
+    command << "--verbose"
+
+    system(command.join(" "))
+
+    puts "\n" + ("=" * 80)
+    if File.exist?("#{output_dir}/panda-core.css")
+      filesize = File.size("#{output_dir}/panda-core.css").to_fs(:human_size)
+      puts "✅ CSS compilation successful!"
+      puts ""
+      puts "   Main file:      #{output_dir}/panda-core.css (#{filesize})"
+
+      # Create versioned CSS file
+      versioned_css_file = "#{output_dir}/panda-core-#{core_gemspec.version}.css"
+      File.copy_stream("#{output_dir}/panda-core.css", versioned_css_file)
+      if File.exist?(versioned_css_file)
+        puts "   Versioned copy: #{versioned_css_file}"
+      end
+    else
+      puts "❌ CSS compilation failed!"
+    end
+    puts "=" * 80
+    puts ""
+  end
+end

data/public/panda-core-assets/favicons/browserconfig.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig>
+    <msapplication>
+        <tile>
+            <square150x150logo src="/panda-cms-assets/mstile-150x150.png"/>
+            <TileColor>#b91d47</TileColor>
+        </tile>
+    </msapplication>
+</browserconfig>

data/public/panda-core-assets/favicons/safari-pinned-tab.svg

@@ -0,0 +1,61 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="200.000000pt" height="200.000000pt" viewBox="0 0 200.000000 200.000000"
+ preserveAspectRatio="xMidYMid meet">
+<metadata>
+Created by potrace 1.14, written by Peter Selinger 2001-2017
+</metadata>
+<g transform="translate(0.000000,200.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M565 1803 c-42 -22 -65 -43 -83 -78 -42 -82 -32 -165 29 -226 36 -36
+39 -43 33 -75 l-6 -34 -28 42 c-49 77 -190 192 -210 172 -5 -5 -17 -38 -26
+-74 -26 -102 -3 -238 55 -319 l19 -26 -61 3 c-67 4 -137 -12 -137 -31 0 -24
+56 -102 100 -139 46 -40 115 -68 166 -68 32 0 32 -1 23 -32 -21 -74 -7 -156
+37 -215 29 -39 33 -89 7 -78 -59 25 -73 27 -105 21 -24 -4 -47 -19 -67 -42
+-26 -29 -31 -43 -31 -87 0 -63 25 -120 76 -176 84 -93 183 -120 272 -73 44 23
+78 26 156 16 35 -5 46 -11 46 -25 0 -19 44 -59 65 -59 7 0 23 8 36 19 18 14
+46 19 110 23 65 3 95 10 123 26 50 30 164 31 227 2 118 -53 240 5 305 144 15
+33 24 70 24 103 0 44 -5 58 -31 87 -45 51 -85 56 -171 21 -29 -12 -22 38 12
+87 67 96 53 232 -35 353 -13 19 -8 30 72 150 75 113 90 143 114 230 33 117 36
+145 13 145 -23 0 -185 -155 -208 -199 l-20 -36 -11 50 c-11 50 -11 50 22 81
+125 119 48 334 -120 334 -55 0 -79 -10 -122 -51 l-31 -29 -59 22 c-83 30 -208
+29 -288 -2 l-59 -22 -31 30 c-18 17 -45 36 -60 41 -41 16 -107 13 -142 -6z
+m557 -83 c74 -23 159 -80 206 -139 42 -52 92 -158 92 -194 0 -33 -41 -161 -70
+-217 -39 -77 -217 -136 -385 -127 -188 10 -313 97 -375 263 -19 53 -19 54 0
+116 73 236 308 367 532 298z m-437 -49 c3 -5 -4 -12 -14 -16 -11 -3 -32 -20
+-46 -36 l-25 -31 0 36 c0 23 6 39 18 45 22 13 59 14 67 2z m698 -3 c16 -13 35
+-68 22 -68 -16 0 -95 62 -90 71 9 13 48 11 68 -3z m66 -442 c-50 -81 -93 -145
+-96 -142 -5 4 22 49 154 259 14 22 26 37 29 34 3 -2 -37 -70 -87 -151z m-171
+-273 c-74 -117 -67 -107 -72 -102 -7 7 114 199 124 199 5 0 -18 -44 -52 -97z
+m-378 -72 c63 -15 156 -13 218 3 29 7 52 9 52 4 0 -21 -21 -46 -44 -52 -13 -3
+-38 -22 -56 -43 -30 -34 -32 -40 -27 -91 6 -54 5 -56 -53 -143 -33 -48 -69
+-90 -80 -94 -11 -3 -25 -15 -30 -26 -11 -19 -11 -19 -53 2 -54 27 -144 94
+-156 117 -8 16 -1 17 82 17 75 0 99 4 127 21 48 28 80 78 80 127 0 53 -56 111
+-117 121 -40 7 -41 9 -31 32 7 15 17 23 27 20 9 -3 36 -10 61 -15z m174 -288
+c-64 -99 -87 -133 -91 -129 -6 5 91 156 101 156 4 0 0 -12 -10 -27z m235 -45
+c-32 -44 -90 -87 -148 -109 -30 -11 -58 -18 -62 -17 -5 2 13 37 39 78 l48 75
+71 0 71 0 -19 -27z m-864 -22 c67 -28 119 -138 83 -174 -34 -34 -124 11 -159
+79 -29 58 -16 96 39 108 1 1 18 -5 37 -13z m1199 -28 c13 -36 -24 -112 -66
+-138 -46 -28 -82 -26 -107 6 l-21 27 27 49 c51 93 142 124 167 56z m-649 -93
+c14 -13 25 -34 25 -47 0 -19 -3 -18 -18 12 -11 24 -28 39 -52 47 -34 11 -34
+12 -7 12 17 1 38 -9 52 -24z"/>
+<path d="M765 1496 c-71 -31 -115 -122 -95 -198 23 -83 91 -119 158 -84 57 30
+122 119 122 168 0 37 -34 90 -71 110 -40 21 -72 22 -114 4z m121 -98 c19 -23
+19 -23 -2 -5 -11 9 -29 17 -39 17 -27 0 -55 -30 -55 -59 0 -31 8 -44 35 -59
+11 -6 15 -12 9 -12 -26 0 -57 37 -57 68 0 65 70 96 109 50z m-31 -26 c0 -18
+-20 -15 -23 4 -3 10 1 15 10 12 7 -3 13 -10 13 -16z"/>
+<path d="M1119 1487 c-94 -63 -83 -180 24 -258 75 -54 149 -32 182 56 31 80
+-5 172 -79 206 -54 25 -86 24 -127 -4z m84 -79 c9 -7 20 -27 23 -45 5 -26 1
+-37 -19 -57 -15 -14 -34 -26 -44 -26 -11 1 -6 6 14 15 36 15 48 42 34 78 -14
+35 -53 45 -89 22 l-27 -18 19 21 c21 24 63 29 89 10z m-23 -38 c0 -11 -4 -20
+-10 -20 -5 0 -10 9 -10 20 0 11 5 20 10 20 6 0 10 -9 10 -20z"/>
+<path d="M948 1249 c-14 -6 -29 -16 -32 -24 -6 -18 40 -75 61 -75 13 0 13 -3
+3 -15 -17 -21 -48 -19 -62 5 -17 26 -30 26 -26 -1 2 -12 15 -31 30 -42 23 -17
+31 -19 53 -9 19 9 32 9 47 1 28 -15 65 -3 84 27 13 19 14 28 5 37 -8 8 -15 6
+-27 -11 -17 -24 -46 -29 -62 -9 -8 10 -4 16 19 26 57 25 61 72 7 90 -37 13
+-64 13 -100 0z m42 -23 c0 -2 -9 -6 -20 -9 -11 -3 -20 -1 -20 4 0 5 9 9 20 9
+11 0 20 -2 20 -4z"/>
+</g>
+</svg>

data/public/panda-core-assets/favicons/site.webmanifest

@@ -0,0 +1,14 @@
+{
+    "name": "",
+    "short_name": "",
+    "icons": [
+        {
+            "src": "/panda-cms-assets/favicons/android-chrome-192x192.png",
+            "sizes": "192x192",
+            "type": "image/png"
+        }
+    ],
+    "theme_color": "#ffffff",
+    "background_color": "#ffffff",
+    "display": "standalone"
+}