querylane 0.1.0

data/lib/querylane.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# querylane — a Gmail-style search language, chips, facets and keyboard-driven
+# results for Rails on Hotwire.
+#
+# Flow: Request (params) → Query (parse, interpret, validate) → Compiler
+# (text + filters per index) → Searcher (backend) → Result (hits, chips,
+# facets, state) → engine partials and Stimulus controllers.
+require "rails"
+require "active_support"
+require "active_support/core_ext/object/blank"
+require "active_support/core_ext/string/inflections"
+require "strscan"
+
+require "querylane/version"
+require "querylane/errors"
+require "querylane/configuration"
+require "querylane/filter"
+require "querylane/scope"
+require "querylane/context"
+require "querylane/definition"
+require "querylane/ast"
+require "querylane/parser"
+require "querylane/query"
+require "querylane/compiler"
+require "querylane/chips"
+require "querylane/rewriter"
+require "querylane/preview"
+require "querylane/group_token"
+require "querylane/suggest"
+require "querylane/saving"
+require "querylane/request"
+require "querylane/result"
+require "querylane/search"
+require "querylane/searchers/meilisearch"
+require "querylane/doctor"
+require "querylane/presenter"
+require "querylane/controller"
+require "querylane/engine"
+
+module Querylane
+  class << self
+    # @return [Querylane::Configuration]
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Configures querylane once, at boot (an initializer in the host).
+    #
+    # @yieldparam config [Querylane::Configuration]
+    def configure
+      yield configuration
+    end
+
+    # Test hook.
+    def reset_configuration!
+      @configuration = nil
+    end
+  end
+end

data/lib/tasks/querylane.rake

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+namespace :querylane do
+  desc "Check the indexes behind a definition, e.g. rake querylane:doctor[PEOPLE] or querylane:doctor[MemberSearch::Definition.current]"
+  task :doctor, [:definition] => :environment do |_task, args|
+    receiver, method = args.fetch(:definition).split(".", 2)
+    definition = method ? receiver.constantize.public_send(method) : receiver.constantize
+    client = Querylane.configuration.searcher.send(:client)
+    problems = Querylane::Doctor.check(definition, client: client)
+    problems.each { |problem| puts problem }
+    puts problems.empty? ? "querylane: #{definition.name} indexes are ready" : "querylane: #{problems.size} problem(s)"
+    exit(1) if problems.any?
+  end
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: querylane
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ajaya Agrawalla
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-10-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.1.0
+description: 'A Rails engine: server-parsed query language, interpretation chips,
+  disjunctive facets and keyboard-driven results on Turbo Frames and Stimulus, with
+  a Meilisearch searcher.'
+email:
+- ajaya@clearstack.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- SECURITY.md
+- app/assets/stylesheets/querylane.css
+- app/helpers/querylane/search_helper.rb
+- app/javascript/querylane/controllers/box_controller.js
+- app/javascript/querylane/controllers/options_controller.js
+- app/javascript/querylane/controllers/results_controller.js
+- app/javascript/querylane/controllers/suggest_controller.js
+- app/javascript/querylane/index.js
+- app/javascript/querylane/overlay.js
+- app/javascript/querylane/package.json
+- app/views/querylane/_chips.html.erb
+- app/views/querylane/_denied.html.erb
+- app/views/querylane/_empty.html.erb
+- app/views/querylane/_facets.html.erb
+- app/views/querylane/_first_load.html.erb
+- app/views/querylane/_form.html.erb
+- app/views/querylane/_group.html.erb
+- app/views/querylane/_help.html.erb
+- app/views/querylane/_options.html.erb
+- app/views/querylane/_options_row.html.erb
+- app/views/querylane/_outcome.html.erb
+- app/views/querylane/_pager.html.erb
+- app/views/querylane/_preview.html.erb
+- app/views/querylane/_record.html.erb
+- app/views/querylane/_related.html.erb
+- app/views/querylane/_results.html.erb
+- app/views/querylane/_rows.html.erb
+- app/views/querylane/_saved.html.erb
+- app/views/querylane/_suggest_box.html.erb
+- app/views/querylane/_suggestions.html.erb
+- app/views/querylane/_toolbar.html.erb
+- app/views/querylane/_unavailable.html.erb
+- app/views/querylane/_writes.html.erb
+- config/importmap.rb
+- config/locales/querylane.en.yml
+- lib/querylane.rb
+- lib/querylane/ast.rb
+- lib/querylane/chips.rb
+- lib/querylane/compiler.rb
+- lib/querylane/configuration.rb
+- lib/querylane/context.rb
+- lib/querylane/controller.rb
+- lib/querylane/definition.rb
+- lib/querylane/doctor.rb
+- lib/querylane/engine.rb
+- lib/querylane/errors.rb
+- lib/querylane/filter.rb
+- lib/querylane/group_token.rb
+- lib/querylane/parser.rb
+- lib/querylane/presenter.rb
+- lib/querylane/preview.rb
+- lib/querylane/query.rb
+- lib/querylane/request.rb
+- lib/querylane/result.rb
+- lib/querylane/rewriter.rb
+- lib/querylane/saving.rb
+- lib/querylane/scope.rb
+- lib/querylane/search.rb
+- lib/querylane/searchers/meilisearch.rb
+- lib/querylane/suggest.rb
+- lib/querylane/version.rb
+- lib/tasks/querylane.rake
+homepage: https://github.com/clearstackio/querylane
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/clearstackio/querylane
+  source_code_uri: https://github.com/clearstackio/querylane/tree/master
+  changelog_uri: https://github.com/clearstackio/querylane/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/clearstackio/querylane/issues
+  documentation_uri: https://github.com/clearstackio/querylane/tree/master/docs/guides
+  rubygems_mfa_required: 'true'
+  allowed_push_host: https://rubygems.org
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Gmail-style search box, operators, chips and facets for Rails on Hotwire
+test_files: []