activeadmin-tom_select 4.2.0.beta2 → 4.2.0.beta3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e86dab1b663b3d834ac234945831201f8fe141870301d8ea9068abcf1a0114d5
-  data.tar.gz: 60dac0ce0274974cfe3f82c90524b08f4bc9937fc1d1ff430d7c85e27888848e
+  metadata.gz: a7f03f81fde8c3cf98c1da59093fb6386ca5fc1aaff4f5dff48920a44fd0faeb
+  data.tar.gz: 8ab41c965bea2add11c9294290139d80c2d914a39b9b6406a17b87aaee1a95a3
 SHA512:
-  metadata.gz: 274183f6fb8ec1a5ebd0635adfbb2802ffc94dd2b40da4d19862a72cbd1c8c01076e889f9dfe3666e508d76428d4162205aa21307797521f7d48e75fce7bda3e
-  data.tar.gz: 27dda8943d09f860270178614c4a01e45005aaf684226eb4d376ab1c51ed42d4f1d82f9c7f8dc647b5c6e5317f2d32509f61a3db118d73d2d1b81a423bbfb5ac
+  metadata.gz: 786f45e19accdb9f376a21e9bd4e61ff4437e87b9918ba404cb1719eb1073bd6b985a614220d762cd48a1b2d837bf181306f27ff894413673cc5c663eebd3bde
+  data.tar.gz: 8a51883fcb2bf87324d2fe7c23ae989dd12720163985e09e894b813769962a43a3142c8f1e96a21e2f258ae7e7b38853c13ccf6e59cf8f707f62f93fededbf53

data/.actrc

@@ -14,6 +14,8 @@
 --pull=false
 
 # Bind working directory for better performance with local files
+# Note: With --bind, SQLite may have locking issues with parallel jobs.
+# Run with '-j 1' or '--jobs 1' to serialize jobs if needed.
 --bind
 
 # Use host network for faster downloads and to avoid network issues

data/.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['3.3', '3.4']
+        ruby: ['3.3', '3.4', '4.0']
         gemfile:
           - rails_7.x_active_admin_4.x
           - rails_8.x_active_admin_4.x
@@ -23,6 +23,8 @@ jobs:
       BUNDLE_GEMFILE: ${{ github.workspace }}/gemfiles/${{ matrix.gemfile }}.gemfile
       RAILS_ENV: test
       PLAYWRIGHT_BROWSERS_PATH: ${{ github.workspace }}/ms-playwright
+      # Unique database suffix for parallel test execution
+      GITHUB_JOB: test-ruby${{ matrix.ruby }}-${{ matrix.gemfile }}
 
     steps:
       - uses: actions/checkout@v5
@@ -33,13 +35,11 @@ jobs:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
 
-      # Cache APT packages for Playwright dependencies
-      - name: Cache APT packages
-        uses: awalsh128/cache-apt-pkgs-action@v1.5.3
-        with:
-          packages: libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libdbus-1-3 libatspi2.0-0 libx11-6 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 libgbm1 libxcb1 libxkbcommon0 libpango-1.0-0 libcairo2 libasound2
-          version: 1.0
-          execute_install_scripts: true
+      # Install Playwright dependencies
+      - name: Install Playwright APT dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libdbus-1-3 libatspi2.0-0 libx11-6 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 libgbm1 libxcb1 libxkbcommon0 libpango-1.0-0 libcairo2 libasound2t64
 
       # Get Playwright version for cache key
       - name: Get Playwright version

data/.gitignore

@@ -34,3 +34,6 @@
 /coverage/
 *.lcov
 rspec-results.xml
+
+# Playwright browsers cache (act, CI)
+ms-playwright/

data/Appraisals

@@ -1,9 +1,27 @@
 appraise 'rails-7.x-active-admin-4.x' do
-  gem 'rails', '~> 7.1'
-  gem 'activeadmin', '4.0.0.beta19'
+  gem 'rails', '~> 7.2'
+  gem 'activeadmin', '4.0.0.beta20'
+  gem 'devise', '~> 4.9'
+  gem 'tailwindcss-rails', '~> 4.4.0'
 end
 
 appraise 'rails-8.x-active-admin-4.x' do
   gem 'rails', '~> 8.0'
-  gem 'activeadmin', '4.0.0.beta19'
+  gem 'activeadmin', '4.0.0.beta20'
+  gem 'devise', '~> 4.9'
+  gem 'tailwindcss-rails', '~> 4.4.0'
+end
+
+appraise 'rails-8.1-active-admin-4.x-devise-4' do
+  gem 'rails', '~> 8.1'
+  gem 'activeadmin', '4.0.0.beta20'
+  gem 'devise', '~> 4.9'
+  gem 'tailwindcss-rails', '~> 4.4.0'
+end
+
+appraise 'rails-8.1-active-admin-4.x-devise-5' do
+  gem 'rails', '~> 8.1'
+  gem 'activeadmin', '4.0.0.beta20'
+  gem 'devise', '~> 5.0'
+  gem 'tailwindcss-rails', '~> 4.4.0'
 end

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # CHANGELOG
 
+### Version 4.2.0.beta3
+
+#### 🔄 Dependencies
+- **ActiveAdmin Update**: Updated ActiveAdmin from 4.0.0.beta19 to 4.0.0.beta20
+  - Now requires Rails 7.2+ (dropped support for Rails 7.0 and 7.1)
+  - Added Ruby 4.0 to CI test matrix
+- **Appraisal Updates**: Updated Appraisal gemfiles to use Rails 7.2 and ActiveAdmin 4.0.0.beta20
+
+#### 📚 Documentation
+- Added comprehensive ActiveAdmin v4.0.0 beta changelog to `docs/activeadmin-4-changelog.md`
+  - Includes all changes from beta1 through beta20
+  - Documents breaking changes, new features, and migration path
+
+#### 🔧 Technical Improvements
+- **CI Workflow**: Added Ruby 4.0 to test matrix for future compatibility
+
 ### Version 4.1.2
 
 #### 🐛 Bug Fixes

data/Gemfile

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

data/Gemfile.lock

@@ -1,38 +1,38 @@
 PATH
   remote: .
   specs:
-    activeadmin-tom_select (4.2.0.beta2)
+    activeadmin-tom_select (4.2.0.beta3)
       activeadmin (>= 3.0, < 5)
       ransack (>= 1.8, < 5)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    action_text-trix (2.1.15)
+    action_text-trix (2.1.18)
       railties
-    actioncable (8.1.1)
-      actionpack (= 8.1.1)
-      activesupport (= 8.1.1)
+    actioncable (8.1.3)
+      actionpack (= 8.1.3)
+      activesupport (= 8.1.3)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
       zeitwerk (~> 2.6)
-    actionmailbox (8.1.1)
-      actionpack (= 8.1.1)
-      activejob (= 8.1.1)
-      activerecord (= 8.1.1)
-      activestorage (= 8.1.1)
-      activesupport (= 8.1.1)
+    actionmailbox (8.1.3)
+      actionpack (= 8.1.3)
+      activejob (= 8.1.3)
+      activerecord (= 8.1.3)
+      activestorage (= 8.1.3)
+      activesupport (= 8.1.3)
       mail (>= 2.8.0)
-    actionmailer (8.1.1)
-      actionpack (= 8.1.1)
-      actionview (= 8.1.1)
-      activejob (= 8.1.1)
-      activesupport (= 8.1.1)
+    actionmailer (8.1.3)
+      actionpack (= 8.1.3)
+      actionview (= 8.1.3)
+      activejob (= 8.1.3)
+      activesupport (= 8.1.3)
       mail (>= 2.8.0)
       rails-dom-testing (~> 2.2)
-    actionpack (8.1.1)
-      actionview (= 8.1.1)
-      activesupport (= 8.1.1)
+    actionpack (8.1.3)
+      actionview (= 8.1.3)
+      activesupport (= 8.1.3)
       nokogiri (>= 1.8.5)
       rack (>= 2.2.4)
       rack-session (>= 1.0.1)
@@ -40,45 +40,45 @@ GEM
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
       useragent (~> 0.16)
-    actiontext (8.1.1)
+    actiontext (8.1.3)
       action_text-trix (~> 2.1.15)
-      actionpack (= 8.1.1)
-      activerecord (= 8.1.1)
-      activestorage (= 8.1.1)
-      activesupport (= 8.1.1)
+      actionpack (= 8.1.3)
+      activerecord (= 8.1.3)
+      activestorage (= 8.1.3)
+      activesupport (= 8.1.3)
       globalid (>= 0.6.0)
       nokogiri (>= 1.8.5)
-    actionview (8.1.1)
-      activesupport (= 8.1.1)
+    actionview (8.1.3)
+      activesupport (= 8.1.3)
       builder (~> 3.1)
       erubi (~> 1.11)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    activeadmin (4.0.0.beta19)
+    activeadmin (4.0.0.beta22)
       arbre (~> 2.0)
       csv
-      formtastic (>= 5.0)
+      formtastic (>= 6.0)
       formtastic_i18n (>= 0.7)
       inherited_resources (~> 2.0)
       kaminari (>= 1.2.1)
-      railties (>= 7.0)
+      railties (>= 7.2)
       ransack (>= 4.0)
-    activejob (8.1.1)
-      activesupport (= 8.1.1)
+    activejob (8.1.3)
+      activesupport (= 8.1.3)
       globalid (>= 0.3.6)
-    activemodel (8.1.1)
-      activesupport (= 8.1.1)
-    activerecord (8.1.1)
-      activemodel (= 8.1.1)
-      activesupport (= 8.1.1)
+    activemodel (8.1.3)
+      activesupport (= 8.1.3)
+    activerecord (8.1.3)
+      activemodel (= 8.1.3)
+      activesupport (= 8.1.3)
       timeout (>= 0.4.0)
-    activestorage (8.1.1)
-      actionpack (= 8.1.1)
-      activejob (= 8.1.1)
-      activerecord (= 8.1.1)
-      activesupport (= 8.1.1)
+    activestorage (8.1.3)
+      actionpack (= 8.1.3)
+      activejob (= 8.1.3)
+      activerecord (= 8.1.3)
+      activesupport (= 8.1.3)
       marcel (~> 1.0)
-    activesupport (8.1.1)
+    activesupport (8.1.3)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -91,7 +91,7 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    addressable (2.8.8)
+    addressable (2.8.9)
       public_suffix (>= 2.0.2, < 8.0)
     appraisal (2.5.0)
       bundler
@@ -101,8 +101,8 @@ GEM
       activesupport (>= 7.0)
     ast (2.4.3)
     base64 (0.3.0)
-    bcrypt (3.1.20)
-    bigdecimal (4.0.1)
+    bcrypt (3.1.22)
+    bigdecimal (4.1.0)
     builder (3.3.0)
     capybara (3.40.0)
       addressable
@@ -113,7 +113,7 @@ GEM
       rack-test (>= 0.6.3)
       regexp_parser (>= 1.5, < 3.0)
       xpath (~> 3.2)
-    capybara-playwright-driver (0.5.7)
+    capybara-playwright-driver (0.5.9)
       addressable
       capybara
       playwright-ruby-client (>= 1.16.0)
@@ -139,10 +139,10 @@ GEM
     diff-lcs (1.6.2)
     docile (1.4.1)
     drb (2.2.3)
-    erb (6.0.1)
+    erb (6.0.2)
     erubi (1.13.1)
-    formtastic (5.0.0)
-      actionpack (>= 6.0.0)
+    formtastic (6.0.0)
+      actionpack (>= 7.2.0)
     formtastic_i18n (0.7.0)
     git (1.19.1)
       addressable (~> 2.8)
@@ -152,7 +152,7 @@ GEM
     has_scope (0.9.0)
       actionpack (>= 7.0)
       activesupport (>= 7.0)
-    i18n (1.14.7)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     inherited_resources (2.1.0)
       actionpack (>= 7.0)
@@ -160,11 +160,12 @@ GEM
       railties (>= 7.0)
       responders (>= 2)
     io-console (0.8.2)
-    irb (1.16.0)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.18.0)
+    json (2.19.3)
     kaminari (1.2.2)
       activesupport (>= 4.1.0)
       kaminari-actionview (= 1.2.2)
@@ -180,7 +181,7 @@ GEM
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    loofah (2.25.0)
+    loofah (2.25.1)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
     mail (2.9.0)
@@ -194,11 +195,12 @@ GEM
     mime-types (3.7.0)
       logger
       mime-types-data (~> 3.2025, >= 3.2025.0507)
-    mime-types-data (3.2025.0924)
+    mime-types-data (3.2026.0331)
     mini_mime (1.1.5)
-    minitest (6.0.0)
+    minitest (6.0.2)
+      drb (~> 2.0)
       prism (~> 1.5)
-    net-imap (0.6.2)
+    net-imap (0.6.3)
       date
       net-protocol
     net-pop (0.1.2)
@@ -208,34 +210,35 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.5)
-    nokogiri (1.18.10-aarch64-linux-gnu)
+    nokogiri (1.19.2-aarch64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.10-aarch64-linux-musl)
+    nokogiri (1.19.2-aarch64-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.18.10-arm-linux-gnu)
+    nokogiri (1.19.2-arm-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.10-arm-linux-musl)
+    nokogiri (1.19.2-arm-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.18.10-arm64-darwin)
+    nokogiri (1.19.2-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-darwin)
+    nokogiri (1.19.2-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-linux-gnu)
+    nokogiri (1.19.2-x86_64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-linux-musl)
+    nokogiri (1.19.2-x86_64-linux-musl)
       racc (~> 1.4)
     orm_adapter (0.5.0)
     parallel (1.27.0)
-    parser (3.3.10.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
-    playwright-ruby-client (1.57.0)
+    playwright-ruby-client (1.58.1)
+      base64
       concurrent-ruby (>= 1.1.6)
       mime-types (>= 3.0)
     pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.7.0)
+    prism (1.9.0)
     propshaft (1.3.1)
       actionpack (>= 7.0.0)
       activesupport (>= 7.0.0)
@@ -243,11 +246,11 @@ GEM
     psych (5.3.1)
       date
       stringio
-    public_suffix (7.0.0)
+    public_suffix (7.0.5)
     puma (6.6.1)
       nio4r (~> 2.0)
     racc (1.8.1)
-    rack (3.2.4)
+    rack (3.2.5)
     rack-session (2.1.1)
       base64 (>= 0.1.0)
       rack (>= 3.0.0)
@@ -255,30 +258,30 @@ GEM
       rack (>= 1.3)
     rackup (2.3.1)
       rack (>= 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)
+    rails (8.1.3)
+      actioncable (= 8.1.3)
+      actionmailbox (= 8.1.3)
+      actionmailer (= 8.1.3)
+      actionpack (= 8.1.3)
+      actiontext (= 8.1.3)
+      actionview (= 8.1.3)
+      activejob (= 8.1.3)
+      activemodel (= 8.1.3)
+      activerecord (= 8.1.3)
+      activestorage (= 8.1.3)
+      activesupport (= 8.1.3)
       bundler (>= 1.15.0)
-      railties (= 8.1.1)
+      railties (= 8.1.3)
     rails-dom-testing (2.3.0)
       activesupport (>= 5.0.0)
       minitest
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.6.2)
-      loofah (~> 2.21)
+    rails-html-sanitizer (1.7.0)
+      loofah (~> 2.25)
       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.1.1)
-      actionpack (= 8.1.1)
-      activesupport (= 8.1.1)
+    railties (8.1.3)
+      actionpack (= 8.1.3)
+      activesupport (= 8.1.3)
       irb (~> 1.13)
       rackup (>= 1.0.0)
       rake (>= 12.2)
@@ -293,7 +296,7 @@ GEM
       activesupport (>= 7.2)
       i18n
     rchardet (1.10.0)
-    rdoc (7.0.1)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -308,7 +311,7 @@ GEM
     rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.7)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-rails (6.1.5)
@@ -319,7 +322,7 @@ GEM
       rspec-expectations (~> 3.13)
       rspec-mocks (~> 3.13)
       rspec-support (~> 3.13)
-    rspec-support (3.13.6)
+    rspec-support (3.13.7)
     rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
     rubocop (1.80.2)
@@ -351,17 +354,17 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    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)
+    sqlite3 (2.9.2-aarch64-linux-gnu)
+    sqlite3 (2.9.2-aarch64-linux-musl)
+    sqlite3 (2.9.2-arm-linux-gnu)
+    sqlite3 (2.9.2-arm-linux-musl)
+    sqlite3 (2.9.2-arm64-darwin)
+    sqlite3 (2.9.2-x86_64-darwin)
+    sqlite3 (2.9.2-x86_64-linux-gnu)
+    sqlite3 (2.9.2-x86_64-linux-musl)
     stringio (3.2.0)
-    thor (1.4.0)
-    timeout (0.6.0)
+    thor (1.5.0)
+    timeout (0.6.1)
     tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
@@ -379,7 +382,7 @@ GEM
     websocket-extensions (0.1.5)
     xpath (3.2.0)
       nokogiri (~> 1.8)
-    zeitwerk (2.7.4)
+    zeitwerk (2.7.5)
 
 PLATFORMS
   aarch64-linux-gnu
@@ -388,19 +391,21 @@ PLATFORMS
   arm-linux-musl
   arm64-darwin
   x86_64-darwin
+  x86_64-linux
   x86_64-linux-gnu
   x86_64-linux-musl
 
 DEPENDENCIES
-  activeadmin (= 4.0.0.beta19)
+  activeadmin (~> 4.0.0.beta)
   activeadmin-tom_select!
   appraisal (~> 2.2)
-  bundler (>= 1.5, < 3)
+  bundler (>= 1.5)
   capybara (~> 3.39)
   capybara-playwright-driver (~> 0.5)
   combustion (~> 1.5)
   database_cleaner-active_record (~> 2.1)
   devise (~> 4.9)
+  nokogiri (~> 1.19)
   propshaft (~> 1.2)
   puma (~> 6.0)
   rails (~> 8.0)
@@ -412,7 +417,7 @@ DEPENDENCIES
   rubocop-rspec (~> 3.0)
   semmy (~> 1.1)
   simplecov
-  sqlite3 (~> 2.1)
+  sqlite3 (~> 2.9)
 
 BUNDLED WITH
-   2.6.7
+  4.0.6

data/activeadmin-tom_select.gemspec

@@ -14,27 +14,28 @@ Gem::Specification.new do |spec|
   spec.files         = `git ls-files -z`.split("\x0")
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = ['>= 3.0', '< 4']
+  spec.required_ruby_version = '>= 4.0'
 
   spec.add_development_dependency 'appraisal', '~> 2.2'
-  spec.add_development_dependency 'bundler', ['>= 1.5', '< 3']
+  spec.add_development_dependency 'bundler', '>= 1.5'
   spec.add_development_dependency 'combustion', '~> 1.5'
   spec.add_development_dependency 'database_cleaner-active_record', '~> 2.1'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec-rails', '~> 6.0'
-  spec.add_development_dependency 'sqlite3', '~> 2.1'
+  spec.add_development_dependency 'sqlite3', '~> 2.9'
 
   spec.add_development_dependency 'capybara', '~> 3.39'
   spec.add_development_dependency 'capybara-playwright-driver', '~> 0.5'
   spec.add_development_dependency 'puma', '~> 6.0'
 
+  spec.add_development_dependency 'nokogiri', '~> 1.19'
   spec.add_development_dependency 'rubocop', '~> 1.50'
   spec.add_development_dependency 'rubocop-ast', '~> 1.46.0'
   spec.add_development_dependency 'rubocop-rspec', '~> 3.0'
 
   spec.add_development_dependency 'rspec_junit_formatter'
-  spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'semmy', '~> 1.1'
+  spec.add_development_dependency 'simplecov'
 
   spec.add_dependency 'activeadmin', '>= 3.0', '< 5'
   spec.add_dependency 'ransack', '>= 1.8', '< 5'

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

@@ -153,9 +153,39 @@ From ActiveAdmin's upgrade guide:
 - Run `bundle binstubs tailwindcss-ruby --force`.
 - Confirm `bin/tailwindcss` exists.
 
+### CSS Import Fails: "Failed to find 'activeadmin-tom_select/css'"
+
+This error occurs when using Tailwind CSS v3 with `npx tailwindcss` CLI because postcss-import doesn't support npm subpath exports.
+
+**Solution 1: Configure postcss-import to resolve from node_modules (recommended)**
+
+Create `postcss.config.js` in your project root:
+
+```javascript
+module.exports = {
+  plugins: {
+    'postcss-import': {
+      path: ['node_modules']
+    },
+    'tailwindcss': {},
+    'autoprefixer': {},
+  }
+}
+```
+
+Then use clean imports in your CSS:
+
+```css
+@import "activeadmin-tom_select/src/tom-select-tailwind.css";
+```
+
+**For Tailwind v4:** Use `@import "activeadmin-tom_select/css"` with the `@config` directive.
+
 ### ActiveAdmin styles not loading
 - Verify `app/assets/builds/active_admin.css` exists.
-- Check that `active_admin.tailwind.css` imports `activeadmin-tom_select/css`.
+- Check that CSS imports are correct (see above).
+- Run `npm install` to ensure packages are installed.
+- Ensure `postcss.config.js` exists if using Tailwind v3.
 
 ### Tom Select not initializing
 - Verify `window.TomSelect` in the console.