activeadmin-tom_select 4.1.2 → 4.2.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 153fdfdb190ef24f202368e25d4aec43867b04e7b95d6bbcb7f628220f86aa19
-  data.tar.gz: ce4baaecf0ec8e56b7f2e8e42af66e9f13089b8ca452c7d060cab78f9ccf4a3f
+  metadata.gz: 51891fdd7a6ddb7f062561854aed70a0a87e5d62f7fb0d508083f83769e08602
+  data.tar.gz: 8245fa43ed7603591d6b1895dbe41a6af6ea8d6366cc79c557a0ea7ac555e2f1
 SHA512:
-  metadata.gz: 14c597299f028c3502505975c5f2c92eea64415511ad0fc74fbd675a28c6af8b512b3b585fc29951f2c42309a70b1657e580c4b5a60bac383b8ce0dae7c482fe
-  data.tar.gz: 0a8e4068afd1fadaf7b32413ad6b8ba155979270a2768f2692e734cb6734955e4422234b32508db6e5be18325bf7b109bcd64ea50b09a2b8f799a9d08bbe3d1e
+  metadata.gz: 915986e4bbb049887dc16ec4136f2d870575dfa02c42853665fda6f3c4f307036238c7182ccdb6520f2abdec9c9089631828b971d645fcc330f1390ebd5b1241
+  data.tar.gz: 18b3700cc468eed2f6424b447f0c0eea35cd777aa6eaea7a2d80303af14ea336ceda4226297f26c87d169ab9f690a51595fb979367176019e32341f09159817b

data/Appraisals

@@ -1,9 +1,9 @@
 appraise 'rails-7.x-active-admin-4.x' do
   gem 'rails', '~> 7.1'
-  gem 'activeadmin', '4.0.0.beta16'
+  gem 'activeadmin', '4.0.0.beta19'
 end
 
 appraise 'rails-8.x-active-admin-4.x' do
   gem 'rails', '~> 8.0'
-  gem 'activeadmin', '4.0.0.beta16'
+  gem 'activeadmin', '4.0.0.beta19'
 end

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+### Version 4.1.2
+
+#### 🐛 Bug Fixes
+- **SonarQube Integration**: Fixed coverage path issues preventing SonarQube from reading test coverage reports in CI
+- **SimpleCov Configuration**: Reverted to standard SimpleCov JSON formatter for better compatibility
+- **CI Workflow**: Improved coverage reporting by using absolute paths instead of relative paths
+
+#### 🔧 Technical Improvements
+- **Removed CodeCov**: Simplified CI by removing unused CodeCov integration (using SonarQube exclusively for coverage)
+- **SonarQube Configuration**: Updated `sonar-project.properties` to include npm-package in sources and exclude built assets
+- **Appraisal Updates**: Updated all Appraisal gemfiles to latest dependency versions
+
 ### Version 4.1.1
 
 #### ✨ Improvements

data/Gemfile

@@ -1,7 +1,7 @@
 source 'https://rubygems.org'
 
 # Use ActiveAdmin 4.x beta
-gem 'activeadmin', '4.0.0.beta16'
+gem 'activeadmin', '4.0.0.beta19'
 
 gemspec name: 'activeadmin-tom_select'
 

data/Gemfile.lock

@@ -1,36 +1,38 @@
 PATH
   remote: .
   specs:
-    activeadmin-tom_select (4.1.2)
+    activeadmin-tom_select (4.2.0.beta1)
       activeadmin (>= 3.0, < 5)
       ransack (>= 1.8, < 5)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (8.0.3)
-      actionpack (= 8.0.3)
-      activesupport (= 8.0.3)
+    action_text-trix (2.1.15)
+      railties
+    actioncable (8.1.1)
+      actionpack (= 8.1.1)
+      activesupport (= 8.1.1)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
       zeitwerk (~> 2.6)
-    actionmailbox (8.0.3)
-      actionpack (= 8.0.3)
-      activejob (= 8.0.3)
-      activerecord (= 8.0.3)
-      activestorage (= 8.0.3)
-      activesupport (= 8.0.3)
+    actionmailbox (8.1.1)
+      actionpack (= 8.1.1)
+      activejob (= 8.1.1)
+      activerecord (= 8.1.1)
+      activestorage (= 8.1.1)
+      activesupport (= 8.1.1)
       mail (>= 2.8.0)
-    actionmailer (8.0.3)
-      actionpack (= 8.0.3)
-      actionview (= 8.0.3)
-      activejob (= 8.0.3)
-      activesupport (= 8.0.3)
+    actionmailer (8.1.1)
+      actionpack (= 8.1.1)
+      actionview (= 8.1.1)
+      activejob (= 8.1.1)
+      activesupport (= 8.1.1)
       mail (>= 2.8.0)
       rails-dom-testing (~> 2.2)
-    actionpack (8.0.3)
-      actionview (= 8.0.3)
-      activesupport (= 8.0.3)
+    actionpack (8.1.1)
+      actionview (= 8.1.1)
+      activesupport (= 8.1.1)
       nokogiri (>= 1.8.5)
       rack (>= 2.2.4)
       rack-session (>= 1.0.1)
@@ -38,20 +40,21 @@ GEM
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
       useragent (~> 0.16)
-    actiontext (8.0.3)
-      actionpack (= 8.0.3)
-      activerecord (= 8.0.3)
-      activestorage (= 8.0.3)
-      activesupport (= 8.0.3)
+    actiontext (8.1.1)
+      action_text-trix (~> 2.1.15)
+      actionpack (= 8.1.1)
+      activerecord (= 8.1.1)
+      activestorage (= 8.1.1)
+      activesupport (= 8.1.1)
       globalid (>= 0.6.0)
       nokogiri (>= 1.8.5)
-    actionview (8.0.3)
-      activesupport (= 8.0.3)
+    actionview (8.1.1)
+      activesupport (= 8.1.1)
       builder (~> 3.1)
       erubi (~> 1.11)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    activeadmin (4.0.0.beta16)
+    activeadmin (4.0.0.beta19)
       arbre (~> 2.0)
       csv
       formtastic (>= 5.0)
@@ -60,47 +63,46 @@ GEM
       kaminari (>= 1.2.1)
       railties (>= 7.0)
       ransack (>= 4.0)
-    activejob (8.0.3)
-      activesupport (= 8.0.3)
+    activejob (8.1.1)
+      activesupport (= 8.1.1)
       globalid (>= 0.3.6)
-    activemodel (8.0.3)
-      activesupport (= 8.0.3)
-    activerecord (8.0.3)
-      activemodel (= 8.0.3)
-      activesupport (= 8.0.3)
+    activemodel (8.1.1)
+      activesupport (= 8.1.1)
+    activerecord (8.1.1)
+      activemodel (= 8.1.1)
+      activesupport (= 8.1.1)
       timeout (>= 0.4.0)
-    activestorage (8.0.3)
-      actionpack (= 8.0.3)
-      activejob (= 8.0.3)
-      activerecord (= 8.0.3)
-      activesupport (= 8.0.3)
+    activestorage (8.1.1)
+      actionpack (= 8.1.1)
+      activejob (= 8.1.1)
+      activerecord (= 8.1.1)
+      activesupport (= 8.1.1)
       marcel (~> 1.0)
-    activesupport (8.0.3)
+    activesupport (8.1.1)
       base64
-      benchmark (>= 0.3)
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
       logger (>= 1.4.2)
       minitest (>= 5.1)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
     appraisal (2.5.0)
       bundler
       rake
       thor (>= 0.14.0)
-    arbre (2.2.0)
+    arbre (2.2.1)
       activesupport (>= 7.0)
     ast (2.4.3)
     base64 (0.3.0)
     bcrypt (3.1.20)
-    benchmark (0.4.1)
-    bigdecimal (3.2.3)
+    bigdecimal (4.0.1)
     builder (3.3.0)
     capybara (3.40.0)
       addressable
@@ -119,15 +121,15 @@ GEM
       activesupport (>= 3.0.0)
       railties (>= 3.0.0)
       thor (>= 0.14.6)
-    concurrent-ruby (1.3.5)
-    connection_pool (2.5.4)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
     crass (1.0.6)
     csv (3.3.5)
     database_cleaner-active_record (2.2.2)
       activerecord (>= 5.a)
       database_cleaner-core (~> 2.0)
     database_cleaner-core (2.0.1)
-    date (3.4.1)
+    date (3.5.1)
     devise (4.9.4)
       bcrypt (~> 3.0)
       orm_adapter (~> 0.1)
@@ -137,16 +139,16 @@ GEM
     diff-lcs (1.6.2)
     docile (1.4.1)
     drb (2.2.3)
-    erb (5.0.2)
+    erb (6.0.1)
     erubi (1.13.1)
     formtastic (5.0.0)
       actionpack (>= 6.0.0)
     formtastic_i18n (0.7.0)
     globalid (1.3.0)
       activesupport (>= 6.1)
-    has_scope (0.8.2)
-      actionpack (>= 5.2)
-      activesupport (>= 5.2)
+    has_scope (0.9.0)
+      actionpack (>= 7.0)
+      activesupport (>= 7.0)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     inherited_resources (2.1.0)
@@ -154,12 +156,12 @@ GEM
       has_scope (>= 0.6)
       railties (>= 7.0)
       responders (>= 2)
-    io-console (0.8.1)
-    irb (1.15.2)
+    io-console (0.8.2)
+    irb (1.16.0)
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.15.0)
+    json (2.18.0)
     kaminari (1.2.2)
       activesupport (>= 4.1.0)
       kaminari-actionview (= 1.2.2)
@@ -175,10 +177,11 @@ GEM
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    loofah (2.24.1)
+    loofah (2.25.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
-    mail (2.8.1)
+    mail (2.9.0)
+      logger
       mini_mime (>= 0.1.1)
       net-imap
       net-pop
@@ -190,8 +193,9 @@ GEM
       mime-types-data (~> 3.2025, >= 3.2025.0507)
     mime-types-data (3.2025.0924)
     mini_mime (1.1.5)
-    minitest (5.25.5)
-    net-imap (0.5.10)
+    minitest (6.0.0)
+      prism (~> 1.5)
+    net-imap (0.6.2)
       date
       net-protocol
     net-pop (0.1.2)
@@ -200,54 +204,68 @@ GEM
       timeout
     net-smtp (0.5.1)
       net-protocol
-    nio4r (2.7.4)
+    nio4r (2.7.5)
+    nokogiri (1.18.10-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.10-aarch64-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.10-x86_64-darwin)
+      racc (~> 1.4)
     nokogiri (1.18.10-x86_64-linux-gnu)
       racc (~> 1.4)
+    nokogiri (1.18.10-x86_64-linux-musl)
+      racc (~> 1.4)
     orm_adapter (0.5.0)
     parallel (1.27.0)
-    parser (3.3.9.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    playwright-ruby-client (1.55.0)
+    playwright-ruby-client (1.57.0)
       concurrent-ruby (>= 1.1.6)
       mime-types (>= 3.0)
-    pp (0.6.2)
+    pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.5.1)
+    prism (1.7.0)
     propshaft (1.3.1)
       actionpack (>= 7.0.0)
       activesupport (>= 7.0.0)
       rack
-    psych (5.2.6)
+    psych (5.3.1)
       date
       stringio
-    public_suffix (6.0.2)
+    public_suffix (7.0.0)
     puma (6.6.1)
       nio4r (~> 2.0)
     racc (1.8.1)
-    rack (3.2.1)
+    rack (3.2.4)
     rack-session (2.1.1)
       base64 (>= 0.1.0)
       rack (>= 3.0.0)
     rack-test (2.2.0)
       rack (>= 1.3)
-    rackup (2.2.1)
+    rackup (2.3.1)
       rack (>= 3)
-    rails (8.0.3)
-      actioncable (= 8.0.3)
-      actionmailbox (= 8.0.3)
-      actionmailer (= 8.0.3)
-      actionpack (= 8.0.3)
-      actiontext (= 8.0.3)
-      actionview (= 8.0.3)
-      activejob (= 8.0.3)
-      activemodel (= 8.0.3)
-      activerecord (= 8.0.3)
-      activestorage (= 8.0.3)
-      activesupport (= 8.0.3)
+    rails (8.1.1)
+      actioncable (= 8.1.1)
+      actionmailbox (= 8.1.1)
+      actionmailer (= 8.1.1)
+      actionpack (= 8.1.1)
+      actiontext (= 8.1.1)
+      actionview (= 8.1.1)
+      activejob (= 8.1.1)
+      activemodel (= 8.1.1)
+      activerecord (= 8.1.1)
+      activestorage (= 8.1.1)
+      activesupport (= 8.1.1)
       bundler (>= 1.15.0)
-      railties (= 8.0.3)
+      railties (= 8.1.1)
     rails-dom-testing (2.3.0)
       activesupport (>= 5.0.0)
       minitest
@@ -255,9 +273,9 @@ GEM
     rails-html-sanitizer (1.6.2)
       loofah (~> 2.21)
       nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
-    railties (8.0.3)
-      actionpack (= 8.0.3)
-      activesupport (= 8.0.3)
+    railties (8.1.1)
+      actionpack (= 8.1.1)
+      activesupport (= 8.1.1)
       irb (~> 1.13)
       rackup (>= 1.0.0)
       rake (>= 12.2)
@@ -265,26 +283,27 @@ GEM
       tsort (>= 0.2)
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
-    rake (13.3.0)
+    rake (13.3.1)
     ransack (4.4.1)
       activerecord (>= 7.2)
       activesupport (>= 7.2)
       i18n
-    rdoc (6.14.2)
+    rdoc (7.0.1)
       erb
       psych (>= 4.0.0)
+      tsort
     regexp_parser (2.11.3)
-    reline (0.6.2)
+    reline (0.6.3)
       io-console (~> 0.5)
-    responders (3.1.1)
-      actionpack (>= 5.2)
-      railties (>= 5.2)
-    rspec-core (3.13.5)
+    responders (3.2.0)
+      actionpack (>= 7.0)
+      railties (>= 7.0)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.5)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-rails (6.1.5)
@@ -323,17 +342,24 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    sqlite3 (2.7.4-x86_64-linux-gnu)
-    stringio (3.1.7)
+    sqlite3 (2.8.1-aarch64-linux-gnu)
+    sqlite3 (2.8.1-aarch64-linux-musl)
+    sqlite3 (2.8.1-arm-linux-gnu)
+    sqlite3 (2.8.1-arm-linux-musl)
+    sqlite3 (2.8.1-arm64-darwin)
+    sqlite3 (2.8.1-x86_64-darwin)
+    sqlite3 (2.8.1-x86_64-linux-gnu)
+    sqlite3 (2.8.1-x86_64-linux-musl)
+    stringio (3.2.0)
     thor (1.4.0)
-    timeout (0.4.3)
+    timeout (0.6.0)
     tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
-    unicode-emoji (4.1.0)
-    uri (1.0.3)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
     useragent (0.16.11)
     warden (1.2.9)
       rack (>= 2.0.9)
@@ -343,13 +369,20 @@ GEM
     websocket-extensions (0.1.5)
     xpath (3.2.0)
       nokogiri (~> 1.8)
-    zeitwerk (2.7.3)
+    zeitwerk (2.7.4)
 
 PLATFORMS
-  x86_64-linux
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
 
 DEPENDENCIES
-  activeadmin (= 4.0.0.beta16)
+  activeadmin (= 4.0.0.beta19)
   activeadmin-tom_select!
   appraisal (~> 2.2)
   bundler (>= 1.5, < 3)
@@ -371,4 +404,4 @@ DEPENDENCIES
   sqlite3 (~> 2.1)
 
 BUNDLED WITH
-   2.4.10
+   2.6.7

data/README.md

@@ -80,7 +80,7 @@ Import stylesheets and require javascripts:
 Add to `package.json`:
 ```json
 "dependencies": {
-  "activeadmin-tom_select": "^4.1.0"
+  "activeadmin-tom_select": "^4.2.0-beta1"
 }
 ```
 

data/docs/activeadmin-4-asset-setup.md

@@ -0,0 +1,171 @@
+# ActiveAdmin 4 Asset Setup (Tailwind CSS v4)
+
+## Overview
+This guide documents the current, working setup for ActiveAdmin 4.0.0.beta19 with Tailwind CSS v4 and Tom Select (no jQuery).
+
+## Requirements
+- ActiveAdmin 4.0.0.beta19
+- Tailwind CSS v4 via `tailwindcss-rails` (ships `bin/tailwindcss`)
+- ESBuild (or other JS bundler) for ActiveAdmin JS + Tom Select
+
+## 1. Gemfile
+
+```ruby
+# ActiveAdmin 4 beta
+gem "activeadmin", "4.0.0.beta19"
+
+gem "activeadmin-tom_select"
+
+# Tailwind CSS v4 (bundled CLI)
+gem "tailwindcss-rails", "~> 4.4.0"
+```
+
+## 2. package.json
+
+```json
+{
+  "dependencies": {
+    "@activeadmin/activeadmin": "^4.0.0-beta19",
+    "tom-select": "^2.4.3",
+    "activeadmin-tom_select": "^4.1.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.27.2"
+  },
+  "scripts": {
+    "build:js": "node esbuild-active_admin.config.js",
+    "build:css": "bundle exec rake active_admin:build",
+    "build": "npm run build:js && npm run build:css",
+    "watch:js": "node esbuild-active_admin.config.js --watch",
+    "watch:css": "bundle exec rake active_admin:watch",
+    "dev": "npm run watch:js & npm run watch:css"
+  }
+}
+```
+
+## 3. JavaScript Entry (app/javascript/active_admin.js)
+
+```javascript
+import "@activeadmin/activeadmin";
+
+import TomSelect from "tom-select";
+window.TomSelect = TomSelect;
+
+import { setupAutoInit, initSearchableSelects } from "activeadmin-tom_select";
+window.initSearchableSelects = initSearchableSelects;
+setupAutoInit();
+```
+
+## 4. Tailwind Input (app/assets/stylesheets/active_admin.tailwind.css)
+
+```css
+@import "tailwindcss";
+@config "../../../tailwind-active_admin.config.mjs";
+
+@import "activeadmin-tom_select/css";
+```
+
+## 5. Tailwind Config (tailwind-active_admin.config.mjs)
+
+```javascript
+import { execSync } from "child_process";
+import activeAdminPlugin from "@activeadmin/activeadmin/plugin";
+
+const activeAdminPath = execSync("bundle show activeadmin", {
+  encoding: "utf-8"
+}).trim();
+
+export default {
+  content: [
+    `${activeAdminPath}/vendor/javascript/flowbite.js`,
+    `${activeAdminPath}/plugin.js`,
+    `${activeAdminPath}/app/views/**/*.{arb,erb,html,rb}`,
+    "./app/admin/**/*.{arb,erb,html,rb}",
+    "./app/views/active_admin/**/*.{arb,erb,html,rb}",
+    "./app/views/admin/**/*.{arb,erb,html,rb}",
+    "./app/views/layouts/active_admin*.{erb,html}",
+    "./app/javascript/**/*.js"
+  ],
+  darkMode: "selector",
+  plugins: [activeAdminPlugin]
+};
+```
+
+## 6. Tailwind Build Tasks (lib/tasks/active_admin.rake)
+
+```ruby
+namespace :active_admin do
+  desc "Build Active Admin Tailwind stylesheets"
+  task build: :environment do
+    command = [
+      Rails.root.join("bin/tailwindcss").to_s,
+      "-i", Rails.root.join("app/assets/stylesheets/active_admin.tailwind.css").to_s,
+      "-o", Rails.root.join("app/assets/builds/active_admin.css").to_s,
+      "-m"
+    ]
+
+    system(*command, exception: true)
+  end
+
+  desc "Watch Active Admin Tailwind stylesheets"
+  task watch: :environment do
+    command = [
+      Rails.root.join("bin/tailwindcss").to_s,
+      "--watch",
+      "-i", Rails.root.join("app/assets/stylesheets/active_admin.tailwind.css").to_s,
+      "-o", Rails.root.join("app/assets/builds/active_admin.css").to_s,
+      "-m"
+    ]
+
+    system(*command, exception: true)
+  end
+end
+
+Rake::Task["assets:precompile"].enhance(["active_admin:build"])
+Rake::Task["test:prepare"].enhance(["active_admin:build"]) if Rake::Task.task_defined?("test:prepare")
+Rake::Task["spec:prepare"].enhance(["active_admin:build"]) if Rake::Task.task_defined?("spec:prepare")
+Rake::Task["db:test:prepare"].enhance(["active_admin:build"]) if Rake::Task.task_defined?("db:test:prepare")
+```
+
+## 7. Tailwind CLI Binstub
+
+```bash
+bundle binstubs tailwindcss-ruby --force
+```
+
+## 8. Upgrade Notes (ActiveAdmin 4.0.0.beta19)
+
+From ActiveAdmin's upgrade guide:
+- `_site_header.html.erb` container class changed from `sticky` to `fixed`.
+- `active_admin.html.erb` adds the `pt-16` utility class.
+- Tailwind v4 uses `@import "tailwindcss"` and `@config` (no `@tailwind` directives).
+- The Tailwind config file is ESM. Use `tailwind-active_admin.config.mjs`.
+- jQuery/jQuery UI removed; `columns` and `tabs` components removed.
+- Replace `default_main_content` with `render "show_default"`.
+- Replace `as: :datepicker` with `as: :date_picker`.
+- Replace `active_admin_comments` with `active_admin_comments_for(resource)`.
+- Replace `attributes_table` with `attributes_table_for(resource)` in sidebars.
+
+## Troubleshooting
+
+### CSS not building
+- Ensure `tailwindcss-rails` is pinned to `~> 4.4.0`.
+- Run `bundle binstubs tailwindcss-ruby --force`.
+- Confirm `bin/tailwindcss` exists.
+
+### ActiveAdmin styles not loading
+- Verify `app/assets/builds/active_admin.css` exists.
+- Check that `active_admin.tailwind.css` imports `activeadmin-tom_select/css`.
+
+### Tom Select not initializing
+- Verify `window.TomSelect` in the console.
+- Ensure `setupAutoInit()` is called.
+
+## Migration Checklist
+
+- [ ] Update ActiveAdmin to 4.0.0.beta19
+- [ ] Use Tailwind v4 `@import` + `@config`
+- [ ] Add `tailwindcss-rails` (~> 4.4.0) and binstub
+- [ ] Create `tailwind-active_admin.config.mjs` (ESM)
+- [ ] Update rake tasks to use `bin/tailwindcss` (no `-c`)
+- [ ] Rebuild assets and verify UI