querylane 0.1.0

data/app/views/querylane/_options_row.html.erb

@@ -0,0 +1,51 @@
+<%# One options-panel row. Locals: row (Definition::PanelRow), values, held, definition, id.
+    A masked field starts empty: its current terms stay in the box (shown
+    masked as the placeholder); what is typed here is added. %>
+<% field_id = ->(name) { "#{id}-compose-#{name}" } %>
+<div class="ql-options-row">
+  <% case row.kind %>
+  <% when :inputs %>
+    <% names = row.bare ? [row.name] : row.keys.map(&:to_s) %>
+    <label class="ql-options-label" for="<%= field_id.(names.first) %>"><%= row.label %></label>
+    <div class="ql-options-inputs">
+      <% names.each_with_index do |name, position| %>
+        <span class="ql-options-input">
+          <%# Sensitive fields stay type=text (a password field would invite the browser to save it), masked by CSS. %>
+          <input type="text" id="<%= field_id.(name) %>" name="compose[<%= name %>]" form="<%= id %>-form"
+                 value="<%= values[name] %>" class="form-control form-control-sm <%= "ql-masked" if row.masked %>" autocomplete="off" spellcheck="false"
+                 <%= tag.attributes(placeholder: (t("querylane.options.held", text: held[name]) if held[name])) %>
+                 <%= tag.attributes(aria: {label: ("#{row.label} #{name.humanize}" if position.positive?)}) %>
+                 data-querylane--options-target="field">
+          <% if row.masked %>
+            <button type="button" class="ql-link ql-options-reveal" aria-controls="<%= field_id.(name) %>" aria-pressed="false"
+                    data-action="querylane--options#reveal"
+                    data-show="<%= t("querylane.options.show") %>" data-hide="<%= t("querylane.options.hide") %>"><%= t("querylane.options.show") %></button>
+          <% end %>
+        </span>
+      <% end %>
+    </div>
+  <% when :flags %>
+    <% flags = definition.operator(row.keys.first) %>
+    <span class="ql-options-label" id="<%= field_id.(row.name) %>-label"><%= row.label %></span>
+    <div class="ql-options-checks" role="group" aria-labelledby="<%= field_id.(row.name) %>-label">
+      <% definition.flag_values(flags, row.values).each do |value, label| %>
+        <label class="ql-options-check">
+          <input type="checkbox" name="compose[<%= row.name %>][]" value="<%= value %>" form="<%= id %>-form"
+                 <%= "checked" if Array(values[row.name]).include?(value.to_s) %> data-querylane--options-target="field">
+          <%= label %>
+        </label>
+      <% end %>
+    </div>
+  <% when :options %>
+    <span class="ql-options-label"><%= row.label %></span>
+    <div class="ql-options-checks">
+      <% row.keys.each do |key| %>
+        <label class="ql-options-check">
+          <input type="checkbox" name="compose[options][]" value="<%= key %>" form="<%= id %>-form"
+                 <%= "checked" if values["options"].include?(key.to_s) %> data-querylane--options-target="field">
+          <%= definition.option(key).label %>
+        </label>
+      <% end %>
+    </div>
+  <% end %>
+</div>

data/app/views/querylane/_outcome.html.erb

@@ -0,0 +1,16 @@
+<%# Open/View button (full-page POST) or the reason it cannot be opened. Locals: outcome. %>
+<% case outcome %>
+<% when Querylane::Presenter::Action %>
+  <%= button_to outcome.label, outcome.url, params: outcome.params || {}, method: :post,
+        class: "btn btn-sm #{(outcome.style == :primary) ? "btn-primary" : "btn-outline-primary"} ql-open",
+        form: {class: "d-inline", data: {turbo: false}}, data: {querylane_open: true} %>
+<% when Querylane::Presenter::Reason %>
+  <span class="ql-reason"><%= outcome.text %><% if outcome.link_url %> <%= link_to outcome.link_label, outcome.link_url, data: {turbo: false} %><% end %>
+    <% if outcome.more.any? %>
+      <details class="ql-reason-more">
+        <summary class="ql-link"><%= t("querylane.reasons.more", count: outcome.more.size) %></summary>
+        <ul><% outcome.more.each do |more| %><li><%= more %></li><% end %></ul>
+      </details>
+    <% end %>
+  </span>
+<% end %>

data/app/views/querylane/_pager.html.erb

@@ -0,0 +1,19 @@
+<%# Previous, up to five pages, Next. Submit buttons of the search form. Locals: result, id. %>
+<% pages = [result.pages, 1].max
+   start = [[result.page - 2, 1].max, [pages - 4, 1].max].min
+   window = (start..[start + 4, pages].min) %>
+<nav aria-label="<%= t("querylane.toolbar.pages") %>">
+  <ul class="pagination pagination-sm mb-0 ql-pager">
+    <li class="page-item previous <%= "disabled" if result.page <= 1 %>">
+      <button type="submit" form="<%= id %>-form" name="page" value="<%= result.page - 1 %>" class="page-link" <%= "disabled" if result.page <= 1 %>><%= t("querylane.toolbar.previous") %></button>
+    </li>
+    <% window.each do |number| %>
+      <li class="page-item <%= "active" if number == result.page %>">
+        <button type="submit" form="<%= id %>-form" name="page" value="<%= number %>" class="page-link" <%= 'aria-current="page"'.html_safe if number == result.page %>><%= number %></button>
+      </li>
+    <% end %>
+    <li class="page-item next <%= "disabled" if result.page >= pages %>">
+      <button type="submit" form="<%= id %>-form" name="page" value="<%= result.page + 1 %>" class="page-link" <%= "disabled" if result.page >= pages %>><%= t("querylane.toolbar.next") %></button>
+    </li>
+  </ul>
+</nav>

data/app/views/querylane/_preview.html.erb

@@ -0,0 +1,39 @@
+<%# The preview (Space on a record): every record of its group, any status.
+    Locals: result (from querylane_related), presenter, id. %>
+<turbo-frame id="<%= id %>-preview" class="ql-preview">
+  <section class="ql-preview-card" aria-labelledby="<%= id %>-preview-title">
+    <% if result.state == :unavailable %>
+      <p role="status"><%= t("querylane.group.unavailable") %></p>
+    <% else %>
+      <% group = Querylane::Presenter::Group.new(nil, result.hits) %>
+      <header class="ql-preview-head">
+        <div>
+          <h2 id="<%= id %>-preview-title" class="ql-preview-title"><%= presenter.title(group) if result.hits.any? %></h2>
+          <% if result.hits.any? && (subtitle = presenter.subtitle(group)) %><div class="ql-preview-subtitle"><%= subtitle %></div><% end %>
+        </div>
+        <button type="button" class="ql-link" data-action="querylane--results#closePreview"><%= t("querylane.group.close") %></button>
+      </header>
+      <div class="ql-preview-count"><%= t("querylane.group.preview_count", count: result.total) %></div>
+      <ul class="ql-preview-list">
+        <% result.hits.each do |hit| %>
+          <li class="ql-preview-record">
+            <div>
+              <div class="ql-preview-line">
+                <strong><%= safe_join(presenter.cells(hit).first(3).map(&:text).compact_blank, " · ") %></strong>
+                <% if (badge = presenter.status(hit)) %><span class="ql-badge ql-badge-<%= badge.tone %>"><%= badge.text %></span><% end %>
+              </div>
+              <div class="ql-preview-detail">
+                <%= safe_join([*presenter.cells(hit).drop(3).map(&:text), *presenter.flags(hit).map(&:text)].compact_blank, " · ") %>
+              </div>
+            </div>
+            <div class="ql-preview-outcome"><%= render "querylane/outcome", outcome: presenter.outcome(hit) %></div>
+          </li>
+        <% end %>
+      </ul>
+      <footer class="ql-preview-foot" aria-hidden="true">
+        <span><kbd>↑↓</kbd> <%= t("querylane.group.keys.next") %></span>
+        <span><kbd>Esc</kbd> <%= t("querylane.group.keys.close") %></span>
+      </footer>
+    <% end %>
+  </section>
+</turbo-frame>

data/app/views/querylane/_record.html.erb

@@ -0,0 +1,16 @@
+<%# One record in lanes. Focusable for ↑/↓/Enter. Locals: presenter, hit, columns. %>
+<div class="ql-record" tabindex="-1" data-querylane-record="<%= presenter.record_key(hit) %>">
+  <% presenter.cells(hit).each_with_index do |cell, index| %>
+    <% width = columns[index]&.width %>
+    <div class="ql-lane <%= "ql-cell-#{cell.style}" if cell.style %>" style="<%= "width: #{width}px" if width %>"><%= cell.text %></div>
+  <% end %>
+  <% if presenter.status_label %>
+    <div class="ql-lane ql-lane-status">
+      <% if (badge = presenter.status(hit)) %><span class="ql-badge ql-badge-<%= badge.tone %>"><%= badge.text %></span><% end %>
+    </div>
+  <% end %>
+  <div class="ql-lane ql-lane-flags">
+    <% presenter.flags(hit).each do |flag| %><span class="ql-flag ql-flag-<%= flag.tone %>"><%= flag.text %></span><% end %>
+  </div>
+  <div class="ql-lane ql-lane-outcome"><%= render "querylane/outcome", outcome: presenter.outcome(hit) %></div>
+</div>

data/app/views/querylane/_related.html.erb

@@ -0,0 +1,17 @@
+<%# "More records": every record of one group the page did not show.
+    Locals: result (from querylane_related), presenter, frame. %>
+<turbo-frame id="<%= frame %>" class="ql-related">
+  <% if result.state == :unavailable %>
+    <div class="ql-related-head" role="status"><%= t("querylane.group.unavailable") %></div>
+  <% else %>
+    <% hits = result.unshown_hits %>
+    <div class="ql-related-head"><%= t("querylane.group.all", loaded: result.hits.size, total: result.total) %></div>
+    <% if hits.empty? %>
+      <div class="ql-related-none"><%= t("querylane.group.none") %></div>
+    <% end %>
+    <% columns = presenter.columns %>
+    <% hits.each do |hit| %>
+      <%= render "querylane/record", presenter: presenter, hit: hit, columns: columns %>
+    <% end %>
+  <% end %>
+</turbo-frame>

data/app/views/querylane/_results.html.erb

@@ -0,0 +1,66 @@
+<%# The results frame: everything one search request answers.
+    Locals: result, id, info_id, per_id, first_load, rows. %>
+<turbo-frame id="<%= id %>-results" class="ql-results" data-revision="<%= result.revision %>" data-controller="querylane--results"
+             data-action="change->querylane--results#submitForm keydown->querylane--results#keys">
+  <%# The answer's state, inside the frame (Turbo keeps the frame element's own
+      attributes): the revision answered, for host tests waiting on a search. %>
+  <span hidden data-querylane-state data-revision="<%= result.revision %>" data-options-open="<%= result.options_open? %>" data-saved-active="<%= result.saved_active? %>"></span>
+  <% if result.rewritten %>
+    <turbo-stream action="querylane_set_query" target="<%= id %>-box" data-revision="<%= result.revision %>"><template><%= result.query %></template></turbo-stream>
+  <% end %>
+  <div id="<%= id %>-error" class="ql-error" role="alert"
+       <%= tag.attributes(data: {querylane_error_range: querylane_utf16_range(result.query, result.error&.range)&.to_json}) %>>
+    <% if result.error %>
+      <strong><%= t("querylane.states.invalid") %></strong> <%= result.error.message %>
+      <% if result.error.fix %>
+        <button type="submit" form="<%= id %>-form" name="fix" value="1" class="ql-link"><%= t("querylane.states.fix") %></button>
+      <% end %>
+    <% end %>
+  </div>
+  <% if result.notice %>
+    <div class="ql-notice ql-notice-<%= result.notice %>" role="status"><%= t("querylane.saved.notice.#{result.notice}") %></div>
+  <% end %>
+  <%= render "querylane/saved", result: result, id: id unless result.saved_searches.nil? %>
+  <%= render "querylane/chips", result: result, id: id %>
+  <%= render "querylane/options", result: result, id: id if result.options_open? %>
+
+  <div class="ql-under" <%= "inert" if result.options_open? %>>
+  <% case result.state %>
+  <% when :first_load %>
+    <%= first_load || render("querylane/first_load", definition: result.definition) %>
+    <div class="ql-footer"><div class="ql-info" <%= %(id="#{info_id}").html_safe if info_id %>><%= t("querylane.footer.showing", first: 0, last: 0, total: 0) %></div></div>
+  <% when :invalid %>
+  <% when :short %>
+    <div class="ql-state" role="status"><%= t("querylane.states.short", count: result.definition.min_text_length) %></div>
+  <% when :unavailable %>
+    <%= render "querylane/unavailable", result: result, id: id %>
+  <% when :denied %>
+    <%= render "querylane/denied", result: result, id: id %>
+  <% else %>
+    <div class="ql-layout">
+      <%= render "querylane/facets", result: result, id: id %>
+      <section class="ql-main" aria-live="polite">
+        <%= render "querylane/toolbar", result: result, id: id, per_id: per_id %>
+        <% if result.state == :empty %>
+          <%= render "querylane/empty", result: result, id: id %>
+        <% else %>
+          <div class="ql-rows"><%= rows %></div>
+          <button type="submit" form="<%= id %>-form" name="group" hidden tabindex="-1"
+                  data-turbo-frame="<%= id %>-preview" data-querylane--results-target="previewButton"></button>
+          <turbo-frame id="<%= id %>-preview" class="ql-preview" data-querylane--results-target="preview"></turbo-frame>
+        <% end %>
+        <div class="ql-footer">
+          <div class="ql-info" <%= %(id="#{info_id}").html_safe if info_id %>><%= t("querylane.footer.showing", first: result.first_shown, last: result.last_shown, total: result.total) %></div>
+          <div class="ql-keys" aria-hidden="true">
+            <span><kbd>/</kbd> <%= t("querylane.footer.keys.search") %></span>
+            <span><kbd>↑↓</kbd> <%= t("querylane.footer.keys.move") %></span>
+            <span><kbd>Enter</kbd> <%= t("querylane.footer.keys.open") %></span>
+            <span><kbd>Space</kbd> <%= t("querylane.footer.keys.preview") %></span>
+            <span><kbd>Esc</kbd> <%= t("querylane.footer.keys.clear") %></span>
+          </div>
+        </div>
+      </section>
+    </div>
+  <% end %>
+  </div>
+</turbo-frame>

data/app/views/querylane/_rows.html.erb

@@ -0,0 +1,13 @@
+<%# Grouped records drawn from a Querylane::Presenter. Locals: presenter. %>
+<% columns = presenter.columns %>
+<div class="ql-record ql-record-head" aria-hidden="true">
+  <% columns.each do |column| %>
+    <div class="ql-lane" style="<%= "width: #{column.width}px" if column.width %>"><%= column.label %></div>
+  <% end %>
+  <% if presenter.status_label %><div class="ql-lane ql-lane-status"><%= presenter.status_label %></div><% end %>
+  <div class="ql-lane ql-lane-flags"></div>
+  <div class="ql-lane ql-lane-outcome"><%= presenter.outcome_label %></div>
+</div>
+<% presenter.groups.each do |group| %>
+  <%= render "querylane/group", presenter: presenter, group: group, columns: columns %>
+<% end %>

data/app/views/querylane/_saved.html.erb

@@ -0,0 +1,31 @@
+<%# Saved searches (M12): a native popover opened by the box's Saved button.
+    Name and Save belong to the search form; choosing one sends its id and the
+    server rewrites the box. Locals: result, id. %>
+<div id="<%= id %>-saved" popover class="ql-saved">
+  <div class="ql-saved-head">
+    <label for="<%= id %>-saved-name"><%= t("querylane.saved.title") %></label>
+    <input type="text" id="<%= id %>-saved-name" name="saved_name" form="<%= id %>-form" maxlength="80" autocomplete="off"
+           data-action="keydown.enter->querylane--results#enter" data-querylane-enter="<%= id %>-saved-submit"
+           class="form-control form-control-sm" placeholder="<%= t("querylane.saved.name") %>" <%= "disabled" if result.save_refusal || result.query.blank? %>>
+    <button type="submit" form="<%= id %>-form" name="save_search" value="1" class="btn btn-sm btn-primary" id="<%= id %>-saved-submit"
+            <%= "disabled" if result.save_refusal || result.query.blank? %>><%= t("querylane.saved.save") %></button>
+  </div>
+  <% if (refusal = result.save_refusal) %>
+    <p class="ql-saved-refusal">
+      <strong><%= t("querylane.saved.cannot") %></strong>
+      <%= t("querylane.saved.refusal", value: refusal.value, operator: refusal.operator.downcase) %>
+      <%= refusal.rest.present? ? t("querylane.saved.refusal_rest", rest: refusal.rest) : t("querylane.saved.refusal_alone") %>
+    </p>
+  <% end %>
+  <div class="ql-saved-heading"><%= t("querylane.saved.yours") %></div>
+  <% if result.saved_searches.empty? %>
+    <p class="ql-saved-none"><%= t("querylane.saved.none") %></p>
+  <% end %>
+  <% result.saved_searches.each do |saved| %>
+    <button type="submit" form="<%= id %>-form" name="saved" value="<%= saved.id %>" class="ql-saved-item">
+      <span class="ql-saved-name"><%= saved.name %></span>
+      <code class="ql-saved-query"><%= saved.query %></code>
+      <% if saved.used_at %><span class="ql-saved-used"><%= t("querylane.saved.used", date: l(saved.used_at.to_date, format: :short)) %></span><% end %>
+    </button>
+  <% end %>
+</div>

data/app/views/querylane/_suggest_box.html.erb

@@ -0,0 +1,45 @@
+<%# A search box with suggestions for any page (M7 header, M13 palette).
+    The form posts the text for suggestions into the list frame; the hidden
+    submitters post it to the search page (full page, never in a URL).
+    Locals: id, url, search_url, mode (:header or :palette), label, placeholder,
+    trigger (palette: show its button; ⌘K / Ctrl-K always opens it). %>
+<% palette = mode == :palette %>
+<div class="ql-suggest ql-suggest-<%= mode %>" data-controller="querylane--suggest"
+     data-querylane--suggest-debounce-value="<%= Querylane.configuration.debounce_ms %>"
+     data-querylane--suggest-palette-value="<%= palette %>"
+     data-action="keydown@document->querylane--suggest#shortcut">
+  <% if palette && trigger %>
+    <button type="button" class="ql-suggest-trigger" data-action="querylane--suggest#open">
+      <span><%= placeholder %></span> <kbd aria-hidden="true">⌘K</kbd>
+    </button>
+  <% end %>
+  <% if palette %>
+    <dialog class="ql-palette" aria-label="<%= label %>" data-querylane--suggest-target="dialog"
+            data-action="close->querylane--suggest#closed click->querylane--suggest#backdrop">
+  <% end %>
+  <%= form_with url: url, method: :post, id: "#{id}-form", class: "ql-suggest-form", html: {role: "search"},
+        data: {turbo: true, turbo_frame: "#{id}-list", action: "submit->querylane--suggest#submitted"} do %>
+    <%= hidden_field_tag :revision, 0, id: nil, data: {querylane__suggest_target: "revision"} %>
+    <svg class="ql-box-icon" viewBox="0 0 20 20" width="16" height="16" aria-hidden="true"><circle cx="8.5" cy="8.5" r="6" fill="none" stroke="currentColor" stroke-width="2"/><path d="M13 13l5 5" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
+    <label class="visually-hidden" for="<%= id %>-input"><%= label %></label>
+    <input type="text" id="<%= id %>-input" name="<%= Querylane.configuration.param_name %>" class="ql-suggest-input"
+           placeholder="<%= placeholder %>" autocomplete="off" autocapitalize="off" spellcheck="false"
+           role="combobox" aria-autocomplete="list" aria-controls="<%= id %>-list" aria-expanded="false"
+           data-querylane--suggest-target="input"
+           data-action="input->querylane--suggest#typed keydown->querylane--suggest#keys focus->querylane--suggest#reopen compositionstart->querylane--suggest#compose compositionend->querylane--suggest#composed">
+    <kbd class="ql-suggest-key" aria-hidden="true"><%= palette ? "Esc" : "/" %></kbd>
+    <button type="submit" formaction="<%= search_url %>" data-turbo="false" hidden tabindex="-1" data-querylane--suggest-target="searchAll"></button>
+    <button type="submit" formaction="<%= search_url %>" name="options" value="1" data-turbo="false" hidden tabindex="-1" data-querylane--suggest-target="openOptions"></button>
+  <% end %>
+  <div class="ql-suggest-pop" hidden data-querylane--suggest-target="pop">
+    <turbo-frame id="<%= id %>-list" class="ql-suggest-list" role="listbox" aria-label="<%= label %>"
+                 data-querylane--suggest-target="list" data-action="combobox-commit->querylane--suggest#commit"></turbo-frame>
+    <div class="ql-suggest-foot" aria-hidden="true">
+      <span><kbd>↑↓</kbd> <%= t("querylane.suggest.keys.move") %></span>
+      <span><kbd>Enter</kbd> <%= t("querylane.suggest.keys.open") %></span>
+      <span><kbd>Tab</kbd> <%= t("querylane.suggest.keys.complete") %></span>
+      <span><kbd>Esc</kbd> <%= t("querylane.suggest.keys.close") %></span>
+    </div>
+  </div>
+  <% if palette %></dialog><% end %>
+</div>

data/app/views/querylane/_suggestions.html.erb

@@ -0,0 +1,47 @@
+<%# Suggestions: operator completions, people (groups), go-to. Options carry
+    no query text: a completion holds only its word, people their own Action.
+    Locals: result, presenter, groups, id. %>
+<turbo-frame id="<%= id %>-list" class="ql-suggest-list" role="listbox" data-revision="<%= result.revision %>">
+  <% if result.completions.any? %>
+    <div role="group" aria-labelledby="<%= id %>-operators">
+      <div class="ql-suggest-heading" id="<%= id %>-operators"><%= t("querylane.suggest.operators") %></div>
+      <% result.completions.each_with_index do |completion, position| %>
+        <div role="option" id="<%= id %>-operator-<%= position %>" class="ql-suggest-option" data-querylane-complete="<%= completion.word %>">
+          <code class="ql-suggest-word"><%= completion.word %></code>
+          <span class="ql-suggest-detail"><%= completion.hint %></span>
+          <% if position.zero? %><span class="ql-suggest-aside"><%= t("querylane.suggest.complete") %></span><% end %>
+        </div>
+      <% end %>
+    </div>
+  <% end %>
+  <% if groups.any? || %i[empty unavailable].include?(result.state) %>
+    <div role="group" aria-labelledby="<%= id %>-people">
+      <div class="ql-suggest-heading" id="<%= id %>-people"><%= t("querylane.suggest.people") %></div>
+      <% if result.state == :unavailable %>
+        <div class="ql-suggest-note"><%= t("querylane.suggest.unavailable") %></div>
+      <% elsif groups.empty? %>
+        <div class="ql-suggest-note"><%= t("querylane.suggest.none") %></div>
+      <% end %>
+      <% groups.each_with_index do |group, position| %>
+        <% suggestion = presenter.suggestion(group) %>
+        <div role="option" id="<%= id %>-person-<%= position %>" class="ql-suggest-option ql-suggest-person">
+          <span class="ql-suggest-title"><%= presenter.title(group) %></span>
+          <span class="ql-suggest-subtitle"><%= presenter.subtitle(group) %></span>
+          <span class="ql-suggest-detail"><%= suggestion.detail %></span>
+          <% if suggestion.badge %><span class="ql-suggest-aside ql-badge ql-badge-<%= suggestion.badge.tone %>"><%= suggestion.badge.text %></span><% end %>
+          <% if suggestion.action %><div hidden><%= render "querylane/outcome", outcome: suggestion.action %></div><% end %>
+        </div>
+      <% end %>
+    </div>
+  <% end %>
+  <div role="group" aria-labelledby="<%= id %>-go">
+    <div class="ql-suggest-heading" id="<%= id %>-go"><%= t("querylane.suggest.go_to") %></div>
+    <div role="option" id="<%= id %>-search-all" class="ql-suggest-option ql-suggest-go" data-querylane-go="search">
+      <%= result.typed.present? ? t("querylane.suggest.search_all", text: result.typed) : t("querylane.suggest.search_all_empty") %>
+      <span class="ql-suggest-aside"><kbd>Enter</kbd></span>
+    </div>
+    <div role="option" id="<%= id %>-open-options" class="ql-suggest-option ql-suggest-go" data-querylane-go="options">
+      <%= t("querylane.suggest.options") %>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/querylane/_toolbar.html.erb

@@ -0,0 +1,28 @@
+<%# Count, sort, page size and pager; controls belong to the search form. Locals: result, id, per_id. %>
+<div class="ql-toolbar">
+  <div class="ql-count">
+    <%= case result.total_kind
+        when :estimated then t("querylane.toolbar.about", count: number_with_delimiter(result.total))
+        when :capped then t("querylane.toolbar.capped", count: number_with_delimiter(result.total))
+        else t("querylane.toolbar.records", count: result.total)
+        end %>
+    <% if result.merged %><span class="ql-count-note"><%= t("querylane.toolbar.merged") %></span><% end %>
+  </div>
+  <div class="ql-toolbar-controls">
+    <label class="ql-control"><%= t("querylane.toolbar.sort") %>
+      <select name="sort" form="<%= id %>-form" class="form-select form-select-sm">
+        <% result.definition.sorts.each do |sort| %>
+          <option value="<%= sort.key %>" <%= "selected" if sort == result.sort %>><%= sort.label %></option>
+        <% end %>
+      </select>
+    </label>
+    <label class="ql-control"><%= t("querylane.toolbar.show") %>
+      <select name="per" form="<%= id %>-form" class="form-select form-select-sm" <%= %(id="#{per_id}").html_safe if per_id %>>
+        <% result.definition.per_options.each do |per| %>
+          <option value="<%= per %>" <%= "selected" if per == result.per %>><%= per %></option>
+        <% end %>
+      </select>
+    </label>
+    <%= render "querylane/pager", result: result, id: id %>
+  </div>
+</div>

data/app/views/querylane/_unavailable.html.erb

@@ -0,0 +1,7 @@
+<%# The backend did not answer: nothing was searched. Hosts override this
+    partial to add their own way round (e.g. a roster page). Locals: result, id. %>
+<div class="ql-state ql-state-unavailable" role="status">
+  <h2><%= t("querylane.states.unavailable_title") %></h2>
+  <p><%= t("querylane.states.unavailable") %></p>
+  <button type="submit" form="<%= id %>-form" class="ql-link"><%= t("querylane.states.try_again") %></button>
+</div>

data/app/views/querylane/_writes.html.erb

@@ -0,0 +1,16 @@
+<%# The options panel's "Writes" line: what Search would put in the box, with
+    sensitive values masked. Its own frame, refreshed as fields change.
+    Locals: preview (Querylane::Preview), id. %>
+<turbo-frame id="<%= id %>-writes" class="ql-writes" aria-live="polite">
+  <div class="ql-writes-line">
+    <span class="ql-writes-label"><%= t("querylane.options.writes") %></span>
+    <% if preview.error %>
+      <span class="ql-writes-error"><%= t("querylane.options.invalid") %> <%= preview.error.message %></span>
+    <% else %>
+      <code class="ql-writes-text"><%= preview.text %></code>
+    <% end %>
+  </div>
+  <p class="ql-writes-kept">
+    <%= preview.kept.present? ? t("querylane.options.kept", text: preview.kept) : t("querylane.options.kept_none") %>
+  </p>
+</turbo-frame>

data/config/importmap.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# querylane's browser modules for hosts on importmap-rails (Propshaft or
+# Sprockets). Querylane::Engine appends this file to the host's
+# `config.importmap.paths`, so the host map gains `querylane` (index.js) and
+# one pin per module under its own file name, extension included:
+#
+#   querylane                                   -> querylane/index.js
+#   querylane/overlay.js                        -> querylane/overlay.js
+#   querylane/controllers/box_controller.js     -> querylane/controllers/box_controller.js
+#   ...
+#
+# The modules import each other by those names, which also resolve under a
+# webpack or esbuild `querylane` alias, as an npm package, and in a hand-written
+# import map with one `"querylane/": "/querylane/"` prefix entry.
+#
+# Nothing is preloaded: a page that imports "querylane" fetches the rest, and
+# pages without a search box fetch nothing. A host that wants preloading pins
+# the same names again with `preload: true`.
+#
+# The host pins the peers its page shares with querylane:
+#
+#   pin "@hotwired/stimulus", to: "stimulus.min.js"   # stimulus-rails
+#   pin "@github/combobox-nav"
+#
+# and loads Turbo 8 however it already does (turbo-rails' pin is fine):
+# querylane never imports Turbo.
+#
+# The pins are listed when the map is drawn: after adding a module file, restart
+# the server (importmap-rails redraws only when an importmap.rb changes).
+pin "querylane", to: "querylane/index.js", preload: false
+(Querylane::Engine.javascript_modules - ["querylane/index.js"]).each do |file|
+  pin file, to: file, preload: false
+end

data/config/locales/querylane.en.yml

@@ -0,0 +1,136 @@
+en:
+  querylane:
+    box:
+      label: "Search"
+      placeholder: "Name, last four, policy, or operators like is:active"
+      clear: "Clear the search"
+      search: "Search"
+      options: "Options"
+    options:
+      title: "Search options"
+      lead: "Filled from the box · Search writes it back"
+      writes: "Writes"
+      kept: "Kept as typed: %{text}."
+      kept_none: "Kept as typed: nothing. Parts the panel cannot show stay in the box untouched."
+      reset: "Reset fields"
+      cancel: "Cancel"
+      search: "Search"
+      held: "In the box: %{text}"
+      show: "Show"
+      hide: "Hide"
+      invalid: "The fields would write a query that cannot run:"
+    suggest:
+      label: "Search members"
+      placeholder: "Search members"
+      operators: "Operators"
+      people: "People"
+      go_to: "Go to"
+      search_all: "Search all for %{text}"
+      search_all_empty: "Open Member Search"
+      options: "Open search options"
+      complete: "Tab to complete"
+      none: "No people match yet."
+      unavailable: "People could not be loaded; Search all still works."
+      records:
+        one: "1 record"
+        other: "%{count} records"
+      keys:
+        move: "move"
+        open: "open"
+        complete: "complete"
+        close: "close"
+    saved:
+      button: "Saved"
+      title: "Save this search"
+      name: "Name"
+      save: "Save"
+      yours: "Your saved searches"
+      none: "Nothing saved yet."
+      used: "used %{date}"
+      cannot: "Cannot save:"
+      refusal: "“%{value}” is read as %{operator}. Saved searches never keep member IDs, SSNs or last fours, even when the box worked them out."
+      refusal_rest: "Remove it, or save “%{rest}” alone."
+      refusal_alone: "Remove it first."
+      notice:
+        saved: "Search saved."
+        refused: "This search was not saved: it holds a member ID, SSN or last four."
+        store_failed: "Saved searches are unavailable right now."
+    reasons:
+      more:
+        one: "+1 more"
+        other: "+%{count} more"
+    errors:
+      parked: "%{key}: is not available yet."
+    group:
+      more:
+        one: "1 more record for this person"
+        other: "%{count} more records for this person"
+      hide: "Hide"
+      all: "All records for this person, any status · %{loaded} of %{total}"
+      none: "Every record is already shown above."
+      unavailable: "These records could not be loaded. Search again."
+      close: "Close · Esc"
+      preview_count:
+        one: "1 record you can see, any status"
+        other: "%{count} records you can see, any status"
+      keys:
+        next: "next person, preview follows"
+        close: "closes"
+    chips:
+      count:
+        one: "1 character"
+        other: "%{count} characters"
+      searching_for: "Searching for"
+      remove: "Remove %{label}"
+      syntax_help: "Syntax help"
+      clear: "Clear"
+    toolbar:
+      records:
+        one: "1 record"
+        other: "%{count} records"
+      about: "about %{count} records"
+      capped: "%{count}+ records"
+      merged: "Copies of the same record are shown once on this page."
+      sort: "Sort"
+      show: "Show"
+      previous: "Previous"
+      next: "Next"
+      pages: "Result pages"
+    footer:
+      showing: "Showing %{first} to %{last} of %{total} entries"
+      keys:
+        search: "search"
+        move: "move"
+        open: "open record"
+        preview: "preview"
+        clear: "clear"
+    facets:
+      find: "Find a %{facet}…"
+      find_label: "Find a %{facet} value"
+      note: "Counts are records. Ticking more boxes in one group widens the search (OR); the counts beside unticked boxes show what they would add. Different groups narrow (AND)."
+      unavailable: "Counts unavailable"
+    help:
+      title: "Search syntax"
+      lead: "Plain words search names. Operators narrow. Esc closes."
+      words: "words"
+      masked: "masked"
+      boolean: "on operators only; terms are ANDed"
+    states:
+      short: "Type at least %{count} letters of a name, or add an operator."
+      first_load_title: "Who are you looking for?"
+      first_load: "Type what you have. The page works out whether it is a name, the last four or a policy."
+      try: "Try"
+      empty_title: "Nothing matches %{searched}."
+      widen: "Search all %{facet}"
+      drop: "Drop %{label}"
+      relax: "Allow fewer name matches"
+      empty_note: "Each button changes the search box, so the new search is visible."
+      empty: "No matching records found"
+      unavailable_title: "Search is not answering right now."
+      unavailable: "Your search was not run. Try again in a minute."
+      try_again: "Try again"
+      denied_title: "No results: your access could not be checked."
+      denied: "Search shows nothing rather than risk showing records outside your access. Reload the page; if it keeps happening, contact support."
+      invalid: "Not searched."
+      fix: "Fix it"
+      searching: "Searching…"

data/lib/querylane/ast.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Querylane
+  # Parsed query nodes. Ranges are character ranges into the query text.
+  module Ast
+    # `key:value`, or a bare word / quoted phrase when key is nil.
+    Term = Data.define(:key, :value, :quoted, :range)
+    # `-term`, `NOT term`, `-(…)`.
+    Not = Data.define(:node, :range)
+    # `a OR b OR c` (binds tighter than the implicit AND).
+    Or = Data.define(:nodes, :range)
+    # `( … )`, an AND of its nodes.
+    Group = Data.define(:nodes, :range)
+    # The whole query: an AND of its nodes.
+    Root = Data.define(:nodes, :source)
+  end
+end