Botyglot Components V0.0.1

Previews

No matching results.

x
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
<!DOCTYPE html>
<html>
  <head>
    <title>Demo</title>
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <meta name="csrf-param" content="authenticity_token" />
    <meta name="csrf-token" content="VGItLYvp2c3UQt3ohblcBvP3-P7fRolbeDZkqQvzc7RMABwDtyInynJRA3Fgp4604Ijj0RQkAJSZ9kv2w3vi4g" />
    <!-- ATTENTION: The following line is required for Turbo dialog works see: https://github.com/hotwired/turbo/issues/1191#issuecomment-1952959217 -->
    <meta name="turbo-prefetch" content="false">
    <link rel="stylesheet" href="/assets/tailwind-b07d8146.css" data-turbo-track="reload" />
    <link rel="stylesheet" href="/assets/elevate-9611e0ae.css" />
    <script src="/vite/assets/application-Dhu5wEut.js" crossorigin="anonymous" type="module"></script><link rel="modulepreload" href="/vite/assets/monaco-editor-C1G6nEm4.js" as="script" crossorigin="anonymous"><link rel="stylesheet" href="/vite/assets/monaco-editor-DQmwQvws.css" media="screen" />
  </head>
  <body>
    <div id="elevate-toast-host" data-controller="toast" data-turbo-permanent="true" data-toast-position-value="top-center" data-toast-layout-value="default" data-toast-auto-dismiss-duration-value="4000" data-toast-limit-value="3" data-toast-gap-value="14" class="elevate-toast elevate-toast--position--top-center">
      <ol data-toast-target="container" class="relative flex flex-col-reverse sm:flex-col gap-0 pointer-events-auto [&>li]:pointer-events-auto" style="height: 0px;"></ol>
      <div data-toast-target="livePolite" role="status" aria-live="polite" aria-atomic="true" class="sr-only"></div>
      <div data-toast-target="liveAssertive" role="alert" aria-live="assertive" aria-atomic="true" class="sr-only"></div>
      <template data-toast-template data-toast-type="default">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--default"
        aria-hidden="true">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" aria-hidden="true">
                    <circle cx="9" cy="9" r="7.4"></circle>
                    <circle cx="9" cy="9" r="1.4" fill="currentColor" stroke="none"></circle>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template data-toast-type="success">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--success"
        aria-hidden="true">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" aria-hidden="true">
                    <circle cx="9" cy="9" r="7.4"></circle>
                    <path d="M5.6 9.2 L8 11.6 L12.4 6.8"></path>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template data-toast-type="error">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--error"
        aria-hidden="true">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" aria-hidden="true">
                    <circle cx="9" cy="9" r="7.4"></circle>
                    <path d="M6.2 6.2 L11.8 11.8 M11.8 6.2 L6.2 11.8"></path>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template data-toast-type="info">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--info"
        aria-hidden="true">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" aria-hidden="true">
                    <circle cx="9" cy="9" r="7.4"></circle>
                    <path d="M9 8 L9 12.4"></path>
                    <circle cx="9" cy="5.6" r="0.5" fill="currentColor" stroke="none"></circle>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template data-toast-type="warning">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--warning"
        aria-hidden="true">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" aria-hidden="true">
                    <path d="M9 2.4 L16.2 14.6 L1.8 14.6 Z"></path>
                    <path d="M9 7.2 L9 10.6"></path>
                    <circle cx="9" cy="12.6" r="0.5" fill="currentColor" stroke="none"></circle>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template data-toast-type="danger">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--danger"
        aria-hidden="true">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" aria-hidden="true">
                    <path d="M9 1.8 L15.6 5.4 L15.6 10 C15.6 13.4 12.6 15.6 9 16.6 C5.4 15.6 2.4 13.4 2.4 10 L2.4 5.4 Z"></path>
                    <path d="M9 6.4 L9 10"></path>
                    <circle cx="9" cy="12" r="0.5" fill="currentColor" stroke="none"></circle>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template data-toast-type="loading">
        <li class="toast-item">
          <div class="elevate-toast--content">
            <div class="elevate-toast--row">
              <div class="elevate-toast--plate elevate-toast--plate--loading"
        role="progressbar" aria-label="Loading…">
                <span class="elevate-toast--plate-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 18 18" fill="none" focusable="false" aria-hidden="true">
                    <circle cx="9" cy="9" r="7" stroke="currentColor" stroke-opacity="0.2" stroke-width="1.6"></circle>
                    <path d="M9 2 A7 7 0 0 1 16 9" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"></path>
                  </svg>
                </span>
              </div>
              <div class="elevate-toast--text">
                <p class="elevate-toast--title" data-toast-slot="message"></p>
                <p class="elevate-toast--description" data-toast-slot="description"></p>
              </div>
              <button type="button" class="elevate-toast--close" data-toast-slot="close" aria-label="Close">
                <span class="elevate-toast--close-icon elevate-icon">
                  <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                    <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                  </svg>
                </span>
              </button>
            </div>
          </div>
        </li>
      </template>
      <template data-toast-template-rich>
        <li class="toast-item">
          <div class="elevate-toast--content elevate-toast--content--rich">
            <div data-toast-slot="content"></div>
            <button type="button" class="elevate-toast--close elevate-toast--close--floating" data-toast-slot="close" aria-label="Close"><span class="elevate-toast--close-icon elevate-icon">
                <svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewbox="0 0 14 14" fill="none" focusable="false" aria-hidden="true">
                  <path d="M3.5 3.5 L10.5 10.5 M10.5 3.5 L3.5 10.5" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path>
                </svg>
              </span></button></div>
        </li>
      </template>
    </div>
    <main class="container mx-auto mt-12 px-5">
      <form data-controller="elevate-hotwire" data-elevate-hotwire-values-value="{"elevate_lookbook_user":{"id":null,"first_name":null,"last_name":null,"phone":null,"email":null,"amount":null,"website":null,"country":null,"birth_date":null,"appointment_at":null,"code_snippet":null,"bio":null,"preferred_time":null,"newsletter":false,"marketing_emails":null,"terms_accepted":false,"privacy_policy_accepted":false,"interests":null,"notification_preferences":[],"errors":{"_is_valid":true},"warnings":{"_is_valid":true},"suggested_values":{"first_name":"Oscar Botyglot","country":"france","birth_date":"2026-08-25","appointment_at":"2026-05-18T08:00:00.000Z","code_snippet":"# Sample Ruby code\nclass HelloWorld\n  def greet(name)\n    puts \"Hello, #{name}!\"\n  end\nend\n\nhello = HelloWorld.new\nhello.greet(\"World\")\n","phone":"+33 1 23 45 67 89","amount":1234.56,"bio":"Passionate software developer with expertise in Ruby on Rails and Vue.js. Always eager to learn new technologies and share knowledge with the community.","preferred_time":"2026-08-25T14:30:00.000Z","newsletter":true,"marketing_emails":true,"terms_accepted":true,"privacy_policy_accepted":true,"interests":["ruby","javascript"],"notification_preferences":["email","push"]}}}" data-elevate-hotwire-validation-url-value="/elevate/users" id="new_elevate_lookbook_user_form" class="form elevate_lookbook_user-form" action="/elevate/users" accept-charset="UTF-8" method="post"><input type="hidden" name="authenticity_token" value="r7ScvGnb_cQ75f3Dkotb32bUyins4Cs6gIE6jVaxEkGChIAiY0p30Pyax-NPiDLT9ph10gv8yxKDEJ7WV6j5CA" autocomplete="off" />
        <div class="input-block" id="elevate_lookbook_user_interests__wrapper" data-controller="elevate-hotwire-multi-select" data-elevate-hotwire-multi-select-elevate-hotwire-outlet="form" data-elevate-hotwire-multi-select-name-value="elevate_lookbook_user[interests]" data-elevate-hotwire-multi-select-input-id-value="elevate_lookbook_user_interests" data-elevate-hotwire-multi-select-input-name-value="elevate_lookbook_user[interests][]" data-elevate-hotwire-multi-select-limit-value="5" data-elevate-hotwire-multi-select-disabled-value="false" data-elevate-hotwire-multi-select-count-text-value="selected" data-elevate-hotwire-multi-select-initial-choices-value="[{"id":"ruby","display_name":"Ruby"},{"id":"javascript","display_name":"JavaScript"},{"id":"python","display_name":"Python"},{"id":"go","display_name":"Go"},{"id":"rust","display_name":"Rust"},{"id":"typescript","display_name":"TypeScript"},{"id":"elixir","display_name":"Elixir"},{"id":"other","display_name":"Other"}]">
          <select id="elevate_lookbook_user_interests" class="custom-autocomplete" multiple="multiple" data-elevate-hotwire-multi-select-target="select">
            <option value="ruby">Ruby</option>
            <option value="javascript">JavaScript</option>
            <option value="python">Python</option>
            <option value="go">Go</option>
            <option value="rust">Rust</option>
            <option value="typescript">TypeScript</option>
            <option value="elixir">Elixir</option>
            <option value="other">Other</option>
          </select></div>
      </form>
    </main>
  </body>
  <script>
    /* see this fix: https://github.com/rails/importmap-rails/issues/65#issuecomment-999939960 */
    window.process = { env: { NODE_ENV: 'production'} }
  </script>
</html>
1
2
3
4
5
6
7
8
9
<%- url = Elevate::Engine.routes.url_helpers.users_path -%>
<%= elevate_form_with(model: user, url: url, scope: :elevate_lookbook_user) do |form| %>
  <%= render Elevate::Hotwire::MultiSelectComponent.new(
    form: form,
    field_name: :interests,
    choices: user.interests__potential_values
  ) %>
<% end %>

Basic multi-select with programming language choices

No params configured.

No assets to display.

app/components/elevate/hotwire/multi_select/multi_select_controller.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
// Field-level Stimulus controller for Elevate::Hotwire::MultiSelectComponent.
//
// TomSelect (multiple mode) over a UI-only <select multiple>. Mirrors the
// autocomplete controller, with two multi-select deltas:
//
//   1. Array-valued submission. The <select> carries no submittable name;
//      `useHiddenArray` manages one hidden <input name="X[]"> per selected
//      value (plus a single empty-marker when empty) off the store slice.
//      TomSelect drives the store; the store drives the hiddens.
//
//   2. Display modes. Default: removable tags, collapsing overflow past
//      `limit` to a "+N" pill. `showCount`: a single "N selected" summary
//      in the control instead of tags (railsblocks count-display style).
//
// Validity classes are `input-block__field--invalid` / `--warning`, matching
// the rest of the Hotwire form components.
import { Controller } from "@hotwired/stimulus";
import TomSelect from "tom-select";
import { useFormState }        from "../../../../assets/javascripts/hotwire/behaviors/use_form_state";
import { useTouchOnFocus }     from "../../../../assets/javascripts/hotwire/behaviors/use_touch_on_focus";
import { useEmptyClass }       from "../../../../assets/javascripts/hotwire/behaviors/use_empty_class";
import { useValidityClasses }  from "../../../../assets/javascripts/hotwire/behaviors/use_validity_classes";
import { useErrorPlaceholder } from "../../../../assets/javascripts/hotwire/behaviors/use_error_placeholder";
import { usePotentialValues }  from "../../../../assets/javascripts/hotwire/behaviors/use_potential_values";
import { useSuggestedValue }   from "../../../../assets/javascripts/hotwire/behaviors/use_suggested_value";
import { useHiddenArray }      from "../../../../assets/javascripts/hotwire/behaviors/use_hidden_array";
const INVALID_CLASS = "input-block__field--invalid";
const WARNING_CLASS = "input-block__field--warning";
export default class ElevateHotwireMultiSelectController extends Controller {
  static outlets = ["elevate-hotwire"];
  static targets = ["select"];
  static values = {
    name:              String,
    displayError:      { type: Boolean, default: true },
    suggestValue:      { type: String,  default: "" }, // '' | 'true' | 'force'
    placeholder:       { type: String,  default: "" },
    inputId:           { type: String,  default: "" },
    inputName:         { type: String,  default: "" }, // already has the [] suffix
    limit:             { type: Number,  default: 5 },
    disabled:          { type: Boolean, default: false },
    showCount:         { type: Boolean, default: false },
    countText:         { type: String,  default: "selected" },
    countTextSingular: { type: String,  default: "" },
    initialChoices:    { type: Array,   default: [] },
  };
  #tomSelect = null;
  #countEl = null;
  connect() {
    const name = this.nameValue;
    this.#tomSelect = new TomSelect(this.selectTarget, {
      // <select multiple> makes TomSelect default maxItems to null (unlimited).
      create: false,
      // Keep selected options in the dropdown so their checkbox reads as
      // checked (railsblocks "Filter by Categories" behavior).
      hideSelected: false,
      plugins: {
        remove_button: {
          title: "Remove",
          // The plugin's default renders `label` via textContent, so an SVG
          // string would leak as raw text. Override `html` (parsed as HTML,
          // like the autocomplete clear button) to emit a crisp SVG cross.
          html: (data) =>
            `<div class="${data.className}" title="${data.title}" role="button" tabindex="-1">` +
            '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">' +
            '<line x1="1.5" y1="10.5" x2="10.5" y2="1.5"/><line x1="10.5" y1="10.5" x2="1.5" y2="1.5"/>' +
            "</svg></div>",
        },
        checkbox_options: {}, // a checkbox per option, checked when selected
        no_active_items:  {}, // don't highlight already-selected tags as active
      },
      placeholder: this.placeholderValue || undefined,
    });
    useFormState(this, {
      name,
      onValueChange: (v) => this.#syncSelectValue(v),
      // Options changed server-side → rebuild TomSelect's list, then re-apply
      // the current store selection (a fresh list otherwise drops it).
      onPotentialValuesChange: () =>
        queueMicrotask(() => {
          this.#tomSelect?.sync();
          this.#syncSelectValue(this.fieldValue());
        }),
    });
    useTouchOnFocus(this, { target: this.#tomSelect.control_input });
    useEmptyClass(this, { name, wrapper: this.element });
    useValidityClasses(this, {
      name,
      input: this.#tomSelect.wrapper,
      invalidClass: INVALID_CLASS,
      warningClass: WARNING_CLASS,
    });
    if (this.displayErrorValue) {
      useErrorPlaceholder(this, { name, parent: this.element });
    }
    usePotentialValues(this, {
      name,
      select: this.selectTarget,
      initialChoices: this.initialChoicesValue,
    });
    useHiddenArray(this, {
      name,
      arrayName: this.inputNameValue,
      idPrefix:  this.inputIdValue,
      parent:    this.element,
    });
    this.#tomSelect.sync();
    if (this.showCountValue) this.#setupCountDisplay();
    // TomSelect change → store (getValue is an array in multiple mode).
    this.#tomSelect.on("change", () => {
      const value = this.#tomSelect.getValue();
      this.updateFieldValue(Array.isArray(value) ? value : []);
      this.#refreshDisplay();
    });
    useSuggestedValue(this, { name, mode: this.suggestValueValue });
    if (this.disabledValue) this.#tomSelect.disable();
    // Drive the initial selection from the store (onValueChange suppresses its
    // first fire) — now if the outlet is up, and again once it connects.
    const syncFromStore = () => this.#syncSelectValue(this.fieldValue());
    if (this.hasElevateHotwireOutlet) syncFromStore();
    const prevOutletConnected = this.elevateHotwireOutletConnected?.bind(this);
    this.elevateHotwireOutletConnected = function (outlet, element) {
      if (prevOutletConnected) prevOutletConnected(outlet, element);
      syncFromStore();
    };
  }
  disconnect() {
    if (this.#tomSelect) {
      this.#tomSelect.destroy();
      this.#tomSelect = null;
    }
    super.disconnect();
  }
  // Mirror a store value (array | scalar | null) onto TomSelect. Silent
  // setValue avoids re-firing `change` back into the store.
  #syncSelectValue(v) {
    if (!this.#tomSelect) return;
    const array = Array.isArray(v) ? v : v == null || v === "" ? [] : [v];
    this.#tomSelect.setValue(array.map(String), true);
    this.#refreshDisplay();
  }
  #setupCountDisplay() {
    this.#countEl = document.createElement("div");
    this.#countEl.className = "ts-count-display";
    this.#tomSelect.control.appendChild(this.#countEl);
  }
  // Count mode: show "N text" and hide the tags (via `count-active`).
  // Tag mode: hide items past `limit` and show a "+N" pill for the overflow.
  #refreshDisplay() {
    const ts = this.#tomSelect;
    if (!ts) return;
    const items = Array.from(ts.control.querySelectorAll(":scope > .item"));
    const count = items.length;
    if (this.showCountValue) {
      if (!this.#countEl) return;
      // TomSelect rebuilds items on every change but leaves appended nodes;
      // guard against a stray detach just in case.
      if (!this.#countEl.isConnected) ts.control.appendChild(this.#countEl);
      ts.control.classList.toggle("count-active", count > 0);
      const text =
        count === 1 && this.countTextSingularValue
          ? this.countTextSingularValue
          : this.countTextValue;
      this.#countEl.textContent = count > 0 ? `${count} ${text}` : "";
      return;
    }
    // Tag mode: collapse overflow beyond `limit`.
    const limit = this.limitValue;
    items.forEach((item, idx) => {
      item.style.display = idx < limit ? "" : "none";
    });
    const overflow = count - limit;
    if (overflow > 0) {
      if (!this.#countEl) this.#setupCountDisplay();
      if (!this.#countEl.isConnected) ts.control.appendChild(this.#countEl);
      this.#countEl.textContent = `+${overflow}`;
    } else if (this.#countEl) {
      this.#countEl.textContent = "";
    }
  }
}