activeadmin-tom_select 4.1.0

data/CHANGELOG.md

@@ -0,0 +1,64 @@
+# CHANGELOG
+
+### Version 5.0.0 (Draft - Unreleased)
+
+[Compare changes](https://github.com/glebtv/activeadmin-searchable_select/compare/1-8-stable...master)
+
+#### 🚀 Major Breaking Change: Migration from Select2 to Tom Select
+
+This release represents a complete overhaul of the underlying select library, moving from jQuery-based Select2 to the modern, vanilla JavaScript Tom Select library.
+
+#### ✨ New Features
+- **Tom Select Integration**: Replaced Select2 with Tom Select v2.4.3 for better performance and smaller bundle size
+- **jQuery-Free**: Completely removed jQuery dependency, reducing bundle size significantly
+- **Tailwind CSS Support**: Added full Tailwind CSS 3 support with custom styled components
+- **Modern JavaScript**: Rewritten with ES6+ modules and native browser APIs
+- **TypeScript Ready**: Tom Select provides TypeScript definitions out of the box
+- **Improved Performance**: Faster initialization and better memory management
+
+#### 💔 Breaking Changes
+- **No jQuery Required**: Applications no longer need jQuery for searchable selects
+- **CSS Class Changes**: All Select2 classes replaced with Tom Select equivalents:
+  - `.select2-container` → `.ts-wrapper` or `.ts-control`
+  - `.select2-dropdown` → `.ts-dropdown`
+  - `.select2-results__option` → `.ts-dropdown .option`
+  - `.select2-selection` → `.ts-control .item`
+  - `.select2-search__field` → `.ts-control input`
+- **JavaScript API Changes**: Tom Select has different initialization and options
+- **Removed Legacy Files**: `searchable_select/init.js` no longer exists
+
+#### 🔧 Technical Improvements
+- **Build Process**: Simplified build process using Tailwind CSS 3 and esbuild
+- **CSS Architecture**: Consolidated all styles into a single `tom-select-tailwind.css` file
+- **Test Updates**: Updated all test selectors to work with Tom Select
+- **Package Exports**: Updated npm package exports for Tom Select styles
+- **Documentation**: Added comprehensive migration guide at `/docs/update-tom-select.md`
+
+#### 📦 Dependencies
+- **Removed**:
+  - `jquery` (peer dependency)
+  - `select2` (peer dependency)
+- **Added**:
+  - `tom-select@^2.4.3` (peer dependency)
+  - `tailwindcss@^3.4.0` (dev dependency for test app)
+
+#### 🔄 Migration Path
+Users upgrading to v5.0.0 will need to:
+1. Remove jQuery and Select2 dependencies
+2. Add Tom Select: `npm install tom-select@^2.4.3`
+3. Update CSS imports to use Tom Select styles
+4. Update any custom JavaScript that referenced Select2 APIs
+5. See `/docs/update-tom-select.md` for detailed migration instructions
+
+#### Previous Changes (v0.5.0 Draft)
+- Forked from original repository to @rocket-sensei organization
+- Updated package name to `@rocket-sensei/activeadmin-searchable_select` for NPM publishing
+- Added GitHub Actions workflow for automated NPM publishing on release
+- Fixed all RuboCop linting violations for improved code quality
+- Updated CI configuration for better test stability
+
+### Previous Releases
+
+See
+[1-8-stable branch](https://github.com/codevise/activeadmin-searchable_select/blob/1-8-stable/CHANGELOG.md)
+for previous changes.

data/CLAUDE.md

@@ -0,0 +1,157 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+ActiveAdmin Searchable Select is a Ruby gem that adds searchable select boxes (via Select2) to ActiveAdmin forms and filters. It extends the ActiveAdmin resource DSL to allow defining JSON endpoints for asynchronous option fetching.
+
+## Development Commands
+
+### Testing
+```bash
+# Run full test suite
+bundle exec rspec
+
+# Run tests against specific Rails/ActiveAdmin versions
+appraisal install
+appraisal rspec
+
+# Run a specific test file
+bundle exec rspec spec/features/end_to_end_spec.rb
+
+# Run tests matching a pattern
+bundle exec rspec -e "searchable select"
+```
+
+### Code Quality
+```bash
+# Run Rubocop for style checking
+bundle exec rubocop
+
+# Auto-fix Rubocop violations (when safe)
+bundle exec rubocop -a
+```
+
+### Gem Management
+```bash
+# Install dependencies
+bundle install
+
+# Build gem
+bundle exec rake build
+
+# Release new version (via Semmy)
+bundle exec rake release
+```
+
+### NPM Package
+```bash
+# Install npm dependencies
+npm install
+
+# Prepare source files for npm publishing
+npm run prepublishOnly
+```
+
+## Architecture
+
+### Core Components
+
+1. **Input Extensions** (`lib/activeadmin/inputs/`)
+   - `SearchableSelectInput`: Main form input class that renders searchable select fields
+   - `filters/SearchableSelectInput`: Filter-specific variant for ActiveAdmin index pages
+
+2. **Resource DSL Extension** (`lib/activeadmin/searchable_select/resource_dsl_extension.rb`)
+   - Adds `searchable_select_options` method to ActiveAdmin resources
+   - Defines collection actions that serve JSON endpoints for option fetching
+
+3. **Option Collection** (`lib/activeadmin/searchable_select/option_collection.rb`)
+   - Handles scope filtering via Ransack
+   - Manages pagination and result formatting
+   - Supports custom text attributes and display text lambdas
+
+4. **JavaScript Integration** (`app/assets/javascripts/active_admin/`)
+   - Initializes Select2 on searchable select inputs
+   - Handles AJAX configuration for remote data fetching
+   - Manages selected option rendering
+
+### Request Flow for AJAX Options
+
+1. User types in searchable select input
+2. JavaScript sends AJAX request to `all_options_[resource]_path` 
+3. Collection action (defined by `searchable_select_options`) processes request
+4. `OptionCollection` applies Ransack filtering and pagination
+5. JSON response returned with results and pagination metadata
+6. Select2 renders options in dropdown
+
+### Key Design Patterns
+
+- **Ransack Integration**: All filtering leverages Ransack's query interface
+- **Lazy Loading**: Options can be fetched asynchronously to handle large datasets
+- **Scope Flexibility**: Scopes can be static collections or dynamic lambdas
+- **Multiple Endpoints**: Single resource can define multiple option collections
+- **Test Mode**: `inline_ajax_options` setting renders all options statically for testing
+
+## Testing Approach
+
+Tests use RSpec with Capybara for feature specs. The `spec/internal` directory contains a full Rails 8 application for testing.
+
+### Running the Test App
+
+```bash
+# Start the test app for manual testing/demo
+cd spec/internal
+bundle exec rackup
+
+# Or from project root
+cd spec/internal && bundle exec rackup
+
+# The app will be available at http://localhost:9292
+# Default admin credentials: admin@example.com / password
+```
+
+### Test App Structure
+
+The test app is a full Rails 8 application with:
+- ActiveAdmin configured with Tailwind CSS
+- Tom Select integrated for searchable select functionality
+- Sample models (User, Category, Post, Color) with seed data
+- Various admin resources demonstrating different searchable select configurations
+
+### Building Assets in Test App
+
+```bash
+cd spec/internal
+
+# Build CSS (Tailwind)
+bundle exec rake active_admin:build
+
+# Build JavaScript
+npm run build:js
+
+# Watch for changes during development
+bundle exec rake active_admin:watch  # CSS
+npm run watch:js                     # JavaScript
+```
+
+### Key Test Helpers
+
+- `ActiveAdminHelpers`: Provides DSL for interacting with ActiveAdmin pages
+- `inline_ajax_options` mode: Renders all options inline during feature tests
+- Database cleaner ensures test isolation
+- ABSOLUTELY NO GIT PUSH WITH --no-verify FLAG
+- ABSOLUTELY NO GIT PUSH WITH --no-verify FLAG
+
+## Recent Updates (2025)
+
+### Tom Select Migration
+- Migrated from Select2 to Tom Select for better performance and smaller bundle size
+- Tom Select is now bundled with the gem (no external CDN dependency)
+- Full Tailwind CSS styling support for Tom Select components
+
+### Rails 8 Test App
+- Replaced Combustion-based test app with full Rails 8 application
+- Proper asset pipeline with esbuild and cssbundling-rails
+- Tailwind CSS v3 integration with ActiveAdmin's Tailwind plugin
+- Complete test environment for manual testing and development

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Use ActiveAdmin 4.x beta
+gem 'activeadmin', '4.0.0.beta16'
+
+gemspec name: 'activeadmin-tom_select'
+
+gem 'devise', '~> 4.9', group: :test
+
+gem 'propshaft', '~> 1.2', group: :test
+
+gem 'rails', '~> 8.0', group: :test

data/Gemfile.lock

@@ -0,0 +1,368 @@
+PATH
+  remote: .
+  specs:
+    activeadmin-tom_select (4.1.0)
+      activeadmin (>= 3.0, < 5)
+      ransack (>= 1.8, < 5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actioncable (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+      zeitwerk (~> 2.6)
+    actionmailbox (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      activejob (= 8.0.2.1)
+      activerecord (= 8.0.2.1)
+      activestorage (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      mail (>= 2.8.0)
+    actionmailer (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      actionview (= 8.0.2.1)
+      activejob (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      mail (>= 2.8.0)
+      rails-dom-testing (~> 2.2)
+    actionpack (8.0.2.1)
+      actionview (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      nokogiri (>= 1.8.5)
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+      useragent (~> 0.16)
+    actiontext (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      activerecord (= 8.0.2.1)
+      activestorage (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      globalid (>= 0.6.0)
+      nokogiri (>= 1.8.5)
+    actionview (8.0.2.1)
+      activesupport (= 8.0.2.1)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activeadmin (4.0.0.beta16)
+      arbre (~> 2.0)
+      csv
+      formtastic (>= 5.0)
+      formtastic_i18n (>= 0.7)
+      inherited_resources (~> 2.0)
+      kaminari (>= 1.2.1)
+      railties (>= 7.0)
+      ransack (>= 4.0)
+    activejob (8.0.2.1)
+      activesupport (= 8.0.2.1)
+      globalid (>= 0.3.6)
+    activemodel (8.0.2.1)
+      activesupport (= 8.0.2.1)
+    activerecord (8.0.2.1)
+      activemodel (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      timeout (>= 0.4.0)
+    activestorage (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      activejob (= 8.0.2.1)
+      activerecord (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      marcel (~> 1.0)
+    activesupport (8.0.2.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      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)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    arbre (2.2.0)
+      activesupport (>= 7.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bcrypt (3.1.20)
+    benchmark (0.4.1)
+    bigdecimal (3.2.3)
+    builder (3.3.0)
+    capybara (3.40.0)
+      addressable
+      matrix
+      mini_mime (>= 0.1.3)
+      nokogiri (~> 1.11)
+      rack (>= 1.6.0)
+      rack-test (>= 0.6.3)
+      regexp_parser (>= 1.5, < 3.0)
+      xpath (~> 3.2)
+    capybara-playwright-driver (0.5.7)
+      addressable
+      capybara
+      playwright-ruby-client (>= 1.16.0)
+    combustion (1.5.0)
+      activesupport (>= 3.0.0)
+      railties (>= 3.0.0)
+      thor (>= 0.14.6)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.4)
+    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)
+    devise (4.9.4)
+      bcrypt (~> 3.0)
+      orm_adapter (~> 0.1)
+      railties (>= 4.1.0)
+      responders
+      warden (~> 1.2.3)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    drb (2.2.3)
+    erb (5.0.2)
+    erubi (1.13.1)
+    formtastic (5.0.0)
+      actionpack (>= 6.0.0)
+    formtastic_i18n (0.7.0)
+    globalid (1.2.1)
+      activesupport (>= 6.1)
+    has_scope (0.8.2)
+      actionpack (>= 5.2)
+      activesupport (>= 5.2)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    inherited_resources (2.1.0)
+      actionpack (>= 7.0)
+      has_scope (>= 0.6)
+      railties (>= 7.0)
+      responders (>= 2)
+    io-console (0.8.1)
+    irb (1.15.2)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.13.2)
+    kaminari (1.2.2)
+      activesupport (>= 4.1.0)
+      kaminari-actionview (= 1.2.2)
+      kaminari-activerecord (= 1.2.2)
+      kaminari-core (= 1.2.2)
+    kaminari-actionview (1.2.2)
+      actionview
+      kaminari-core (= 1.2.2)
+    kaminari-activerecord (1.2.2)
+      activerecord
+      kaminari-core (= 1.2.2)
+    kaminari-core (1.2.2)
+    logger (1.7.0)
+    loofah (2.24.1)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    mail (2.8.1)
+      mini_mime (>= 0.1.1)
+      net-imap
+      net-pop
+      net-smtp
+    marcel (1.0.4)
+    matrix (0.4.3)
+    mime-types (3.7.0)
+      logger
+      mime-types-data (~> 3.2025, >= 3.2025.0507)
+    mime-types-data (3.2025.0909)
+    mini_mime (1.1.5)
+    minitest (5.25.5)
+    net-imap (0.5.10)
+      date
+      net-protocol
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.2.2)
+      timeout
+    net-smtp (0.5.1)
+      net-protocol
+    nio4r (2.7.4)
+    nokogiri (1.18.9-x86_64-linux-gnu)
+      racc (~> 1.4)
+    orm_adapter (0.5.0)
+    parallel (1.27.0)
+    parser (3.3.9.0)
+      ast (~> 2.4.1)
+      racc
+    playwright-ruby-client (1.55.0)
+      concurrent-ruby (>= 1.1.6)
+      mime-types (>= 3.0)
+    pp (0.6.2)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.4.0)
+    propshaft (1.2.1)
+      actionpack (>= 7.0.0)
+      activesupport (>= 7.0.0)
+      rack
+    psych (5.2.6)
+      date
+      stringio
+    public_suffix (6.0.2)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    racc (1.8.1)
+    rack (3.2.1)
+    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)
+      rack (>= 3)
+    rails (8.0.2.1)
+      actioncable (= 8.0.2.1)
+      actionmailbox (= 8.0.2.1)
+      actionmailer (= 8.0.2.1)
+      actionpack (= 8.0.2.1)
+      actiontext (= 8.0.2.1)
+      actionview (= 8.0.2.1)
+      activejob (= 8.0.2.1)
+      activemodel (= 8.0.2.1)
+      activerecord (= 8.0.2.1)
+      activestorage (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      bundler (>= 1.15.0)
+      railties (= 8.0.2.1)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    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.2.1)
+      actionpack (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      irb (~> 1.13)
+      rackup (>= 1.0.0)
+      rake (>= 12.2)
+      thor (~> 1.0, >= 1.2.2)
+      zeitwerk (~> 2.6)
+    rainbow (2.2.2)
+      rake
+    rake (13.3.0)
+    ransack (4.3.0)
+      activerecord (>= 6.1.5)
+      activesupport (>= 6.1.5)
+      i18n
+    rdoc (6.14.2)
+      erb
+      psych (>= 4.0.0)
+    regexp_parser (2.11.2)
+    reline (0.6.2)
+      io-console (~> 0.5)
+    responders (3.1.1)
+      actionpack (>= 5.2)
+      railties (>= 5.2)
+    rexml (3.4.4)
+    rspec-core (3.13.5)
+      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)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-rails (6.1.5)
+      actionpack (>= 6.1)
+      activesupport (>= 6.1)
+      railties (>= 6.1)
+      rspec-core (~> 3.13)
+      rspec-expectations (~> 3.13)
+      rspec-mocks (~> 3.13)
+      rspec-support (~> 3.13)
+    rspec-support (3.13.5)
+    rspec_junit_formatter (0.6.0)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    rubocop (1.50.2)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.46.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-rspec (3.0.0)
+      rubocop (~> 1.40)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    sqlite3 (2.7.3-x86_64-linux-gnu)
+    stringio (3.1.7)
+    thor (1.4.0)
+    timeout (0.4.3)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.6.0)
+    uri (1.0.3)
+    useragent (0.16.11)
+    warden (1.2.9)
+      rack (>= 2.0.9)
+    websocket-driver (0.8.0)
+      base64
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    xpath (3.2.0)
+      nokogiri (~> 1.8)
+    zeitwerk (2.7.3)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  activeadmin (= 4.0.0.beta16)
+  activeadmin-tom_select!
+  appraisal (~> 2.2)
+  bundler (>= 1.5, < 3)
+  capybara (~> 3.39)
+  capybara-playwright-driver (~> 0.5)
+  combustion (~> 1.5)
+  database_cleaner-active_record (~> 2.1)
+  devise (~> 4.9)
+  propshaft (~> 1.2)
+  puma (~> 6.0)
+  rails (~> 8.0)
+  rake
+  rspec-rails (~> 6.0)
+  rspec_junit_formatter
+  rubocop (~> 1.50)
+  rubocop-ast (~> 1.46.0)
+  rubocop-rspec (~> 3.0)
+  simplecov
+  sqlite3 (~> 2.1)
+
+BUNDLED WITH
+   2.4.10

data/LICENSE.txt

@@ -0,0 +1,25 @@
+
+Copyright for portions of `codevise/activeadmin-searchable_select`
+held by Mark Fariburn, Praxitar Ltd, 2014 as part of
+`mfairburn/activeadmin-select2` which this project is based on. All
+other copyright for `codevise/activeadmin-searchable_select` held by
+Codevise Solutions Ltd, 2017.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.