typed_eav 0.1.0

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_common_fields.html.erb

@@ -0,0 +1,57 @@
+<%# Shared common fields for all field definition forms.
+    Rendered inside a form_with block via:
+      render "typed_eav/forms/common_fields", f: f, field: field %>
+
+<% if field.errors.any? %>
+  <div style="color: red; margin-bottom: 1rem;">
+    <h3><%= pluralize(field.errors.count, "error") %>:</h3>
+    <ul>
+      <% field.errors.each do |error| %>
+        <li><%= error.full_message %></li>
+      <% end %>
+    </ul>
+  </div>
+<% end %>
+
+<% if field.new_record? %>
+  <input type="hidden" name="type" value="<%= field.field_type_name %>" />
+<% end %>
+
+<div>
+  <label>Field Type</label>
+  <input type="text" value="<%= field.field_type_name.humanize %>" disabled readonly />
+</div>
+
+<div>
+  <%= f.label :entity_type %>
+  <% if field.persisted? %>
+    <%= f.text_field :entity_type, disabled: true %>
+  <% else %>
+    <%= f.select :entity_type, TypedEAV.registry.entity_types, { prompt: "Select entity..." } %>
+  <% end %>
+</div>
+
+<div>
+  <%= f.label :name %>
+  <%= f.text_field :name, required: true %>
+</div>
+
+<div>
+  <label>Scope</label>
+  <%# The controller derives scope from the ambient value (TypedEAV.current_scope)
+      and never permits it from params. Display it read-only so users can see which
+      partition this field belongs to without implying they can change it. %>
+  <input type="text"
+         value="<%= field.scope.presence || (field.new_record? ? (TypedEAV.current_scope || "Global (all scopes)") : "Global (all scopes)") %>"
+         disabled readonly />
+</div>
+
+<div>
+  <%= f.label :required %>
+  <%= f.check_box :required %>
+</div>
+
+<div>
+  <%= f.label :sort_order %>
+  <%= f.number_field :sort_order, min: 0 %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_date.html.erb

@@ -0,0 +1,21 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_date, "Earliest Date" %>
+    <%= f.date_field :min_date, value: field.min_date %>
+  </div>
+
+  <div>
+    <%= f.label :max_date, "Latest Date" %>
+    <%= f.date_field :max_date, value: field.max_date %>
+  </div>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.date_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_date_array.html.erb

@@ -0,0 +1,16 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_size, "Min Items" %>
+    <%= f.number_field :min_size, min: 0, value: field.min_size %>
+  </div>
+
+  <div>
+    <%= f.label :max_size, "Max Items" %>
+    <%= f.number_field :max_size, min: 1, value: field.max_size %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_date_time.html.erb

@@ -0,0 +1,21 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_datetime, "Earliest" %>
+    <%= f.datetime_local_field :min_datetime, value: field.min_datetime %>
+  </div>
+
+  <div>
+    <%= f.label :max_datetime, "Latest" %>
+    <%= f.datetime_local_field :max_datetime, value: field.max_datetime %>
+  </div>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.datetime_local_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_decimal.html.erb

@@ -0,0 +1,21 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min %>
+    <%= f.number_field :min, value: field.min, step: "any" %>
+  </div>
+
+  <div>
+    <%= f.label :max %>
+    <%= f.number_field :max, value: field.max, step: "any" %>
+  </div>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.number_field :default_value, value: field.default_value, step: "any" %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_decimal_array.html.erb

@@ -0,0 +1,16 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_size, "Min Items" %>
+    <%= f.number_field :min_size, min: 0, value: field.min_size %>
+  </div>
+
+  <div>
+    <%= f.label :max_size, "Max Items" %>
+    <%= f.number_field :max_size, min: 1, value: field.max_size %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_email.html.erb

@@ -0,0 +1,11 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.text_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_integer.html.erb

@@ -0,0 +1,21 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min %>
+    <%= f.number_field :min, value: field.min %>
+  </div>
+
+  <div>
+    <%= f.label :max %>
+    <%= f.number_field :max, value: field.max %>
+  </div>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.number_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_integer_array.html.erb

@@ -0,0 +1,16 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_size, "Min Items" %>
+    <%= f.number_field :min_size, min: 0, value: field.min_size %>
+  </div>
+
+  <div>
+    <%= f.label :max_size, "Max Items" %>
+    <%= f.number_field :max_size, min: 1, value: field.max_size %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_json.html.erb

@@ -0,0 +1,11 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.text_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_long_text.html.erb

@@ -0,0 +1,21 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_length %>
+    <%= f.number_field :min_length, min: 0, value: field.min_length %>
+  </div>
+
+  <div>
+    <%= f.label :max_length %>
+    <%= f.number_field :max_length, min: 1, value: field.max_length %>
+  </div>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.text_area :default_value, value: field.default_value, rows: 3 %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_multi_select.html.erb

@@ -0,0 +1,6 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_select.html.erb

@@ -0,0 +1,14 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <% if field.persisted? && field.field_options.any? %>
+    <div>
+      <%= f.label :default_value %>
+      <%= f.select :default_value, field.field_options.sorted.map { |o| [o.label, o.value] },
+            { include_blank: "None", selected: field.default_value } %>
+    </div>
+  <% end %>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_text.html.erb

@@ -0,0 +1,26 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_length %>
+    <%= f.number_field :min_length, min: 0, value: field.min_length %>
+  </div>
+
+  <div>
+    <%= f.label :max_length %>
+    <%= f.number_field :max_length, min: 1, value: field.max_length %>
+  </div>
+
+  <div>
+    <%= f.label :pattern, "Regex Pattern" %>
+    <%= f.text_field :pattern, value: field.pattern, placeholder: "e.g. ^[A-Z]+" %>
+  </div>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.text_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_text_array.html.erb

@@ -0,0 +1,16 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :min_size, "Min Items" %>
+    <%= f.number_field :min_size, min: 0, value: field.min_size %>
+  </div>
+
+  <div>
+    <%= f.label :max_size, "Max Items" %>
+    <%= f.number_field :max_size, min: 1, value: field.max_size %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/forms/_url.html.erb

@@ -0,0 +1,11 @@
+<%= form_with(model: field, scope: :typed_eav_field,
+      url: field.persisted? ? typed_eav_field_path(field) : typed_eav_fields_path) do |f| %>
+  <%= render "typed_eav/forms/common_fields", f: f, field: field %>
+
+  <div>
+    <%= f.label :default_value %>
+    <%= f.text_field :default_value, value: field.default_value %>
+  </div>
+
+  <div><%= f.submit field.persisted? ? "Update" : "Create" %></div>
+<% end %>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/index.html.erb

@@ -0,0 +1,42 @@
+<h1>Typed Fields</h1>
+
+<div style="margin-bottom: 1rem;">
+  <%= form_with url: new_typed_eav_field_path, method: :get do |f| %>
+    <%= f.select :type, TypedEAV.config.type_names %>
+    <%= f.submit "New Field" %>
+  <% end %>
+</div>
+
+<table>
+  <thead>
+    <tr>
+      <th></th>
+      <th>ID</th>
+      <th>Type</th>
+      <th>Entity</th>
+      <th>Name</th>
+      <th>Required</th>
+      <th>Scope</th>
+      <th>Options</th>
+      <th>Default</th>
+      <th></th>
+    </tr>
+  </thead>
+  <tbody>
+    <% @fields.each do |field| %>
+      <tr>
+        <td><%= link_to "Edit", edit_typed_eav_field_path(field) %></td>
+        <td><%= link_to "##{field.id}", typed_eav_field_path(field) %></td>
+        <td><%= field.field_type_name %></td>
+        <td><%= field.entity_type %></td>
+        <td><%= field.name %></td>
+        <td><%= field.required? ? "Yes" : "" %></td>
+        <td><code><%= field.scope.inspect %></code></td>
+        <td><code><%= field.options %></code></td>
+        <td><code><%= field.default_value.inspect %></code></td>
+        <td><%= button_to "Delete", typed_eav_field_path(field), method: :delete,
+              data: { turbo_confirm: "Delete this field and all its values?" } %></td>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/new.html.erb

@@ -0,0 +1,7 @@
+<h1>New <%= @field.field_type_name.humanize %> Field</h1>
+
+<%= render_typed_eav_form(field: @field) %>
+
+<div style="margin-top: 1rem;">
+  <%= link_to "Back", typed_eav_fields_path %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/show.html.erb

@@ -0,0 +1,44 @@
+<h1><%= @field.field_type_name.humanize %> Field: <%= @field.name %></h1>
+
+<dl>
+  <dt>ID</dt>
+  <dd><%= @field.id %></dd>
+
+  <dt>Type</dt>
+  <dd><%= @field.field_type_name %></dd>
+
+  <dt>Entity Type</dt>
+  <dd><%= @field.entity_type %></dd>
+
+  <dt>Name</dt>
+  <dd><%= @field.name %></dd>
+
+  <dt>Required</dt>
+  <dd><%= @field.required? ? "Yes" : "No" %></dd>
+
+  <dt>Scope</dt>
+  <dd><code><%= @field.scope.inspect %></code></dd>
+
+  <dt>Options</dt>
+  <dd><code><%= @field.options %></code></dd>
+
+  <dt>Default Value</dt>
+  <dd><code><%= @field.default_value.inspect %></code></dd>
+
+  <dt>Values Count</dt>
+  <dd><%= @field.values.count %></dd>
+</dl>
+
+<% if @field.optionable? && @field.field_options.any? %>
+  <h2>Options</h2>
+  <ul>
+    <% @field.field_options.sorted.each do |option| %>
+      <li><%= option.label %> (<code><%= option.value %></code>)</li>
+    <% end %>
+  </ul>
+<% end %>
+
+<div style="margin-top: 1rem;">
+  <%= link_to "Edit", edit_typed_eav_field_path(@field) %> |
+  <%= link_to "Back", typed_eav_fields_path %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_boolean.html.erb

@@ -0,0 +1,10 @@
+<div>
+  <%= form.label :value, field.name %>
+  <% if field.required? %>
+    <%= form.check_box :value, { checked: typed_value.value }, "true", "false" %>
+  <% else %>
+    <%= form.select :value,
+          [["", ""], ["Yes", "true"], ["No", "false"]],
+          { selected: typed_value.value.nil? ? "" : typed_value.value.to_s } %>
+  <% end %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_color.html.erb

@@ -0,0 +1,4 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.color_field :value, value: typed_value.value || "#000000" %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_date.html.erb

@@ -0,0 +1,6 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.date_field :value, value: typed_value.value,
+        min: field.try(:min_date), max: field.try(:max_date),
+        required: field.required? %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_date_array.html.erb

@@ -0,0 +1,9 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= render_array_field(
+        form: form,
+        name: :value,
+        value: typed_value.value,
+        field_method: :date_field,
+        field_opts: {}) %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_date_time.html.erb

@@ -0,0 +1,5 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.datetime_local_field :value, value: typed_value.value,
+        required: field.required? %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_decimal.html.erb

@@ -0,0 +1,6 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.number_field :value, value: typed_value.value,
+        min: field.try(:min), max: field.try(:max),
+        step: "any", required: field.required? %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_decimal_array.html.erb

@@ -0,0 +1,9 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= render_array_field(
+        form: form,
+        name: :value,
+        value: typed_value.value,
+        field_method: :number_field,
+        field_opts: { step: "any" }) %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_email.html.erb

@@ -0,0 +1,5 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.email_field :value, value: typed_value.value,
+        required: field.required? %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_integer.html.erb

@@ -0,0 +1,6 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.number_field :value, value: typed_value.value,
+        min: field.try(:min), max: field.try(:max),
+        required: field.required? %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_integer_array.html.erb

@@ -0,0 +1,9 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= render_array_field(
+        form: form,
+        name: :value,
+        value: typed_value.value,
+        field_method: :number_field,
+        field_opts: { min: field.try(:min), max: field.try(:max) }) %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_json.html.erb

@@ -0,0 +1,7 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.text_area :value,
+        value: typed_value.value.is_a?(String) ? typed_value.value : typed_value.value&.to_json,
+        rows: 4,
+        placeholder: '{"key": "value"}' %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_long_text.html.erb

@@ -0,0 +1,7 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.text_area :value, value: typed_value.value,
+        maxlength: field.try(:max_length),
+        required: field.required?,
+        rows: 4 %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_multi_select.html.erb

@@ -0,0 +1,7 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.select :value,
+        field.field_options.sorted.map { |o| [o.label, o.value] },
+        { selected: Array(typed_value.value) },
+        { multiple: true, required: field.required? } %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_select.html.erb

@@ -0,0 +1,7 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.select :value,
+        field.field_options.sorted.map { |o| [o.label, o.value] },
+        { include_blank: !field.required?, selected: typed_value.value },
+        { required: field.required? } %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_text.html.erb

@@ -0,0 +1,6 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.text_field :value, value: typed_value.value,
+        maxlength: field.try(:max_length),
+        required: field.required? %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_text_array.html.erb

@@ -0,0 +1,9 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= render_array_field(
+        form: form,
+        name: :value,
+        value: typed_value.value,
+        field_method: :text_field,
+        field_opts: {}) %>
+</div>

data/lib/generators/typed_eav/scaffold/templates/views/typed_eav/values/inputs/_url.html.erb

@@ -0,0 +1,5 @@
+<div>
+  <%= form.label :value, field.name %>
+  <%= form.url_field :value, value: typed_value.value,
+        required: field.required? %>
+</div>

data/lib/typed_eav/column_mapping.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module TypedEAV
+  # Maps field types to their native database column on the values table.
+  #
+  # This is the core concept borrowed from Relaticle's hybrid EAV:
+  # instead of serializing everything into a jsonb blob, each value
+  # type gets its own column so the database can natively index,
+  # sort, and enforce constraints.
+  #
+  # Usage in field type classes:
+  #
+  #   class TypedEAV::Field::Integer < TypedEAV::Field::Base
+  #     value_column :integer_value
+  #   end
+  #
+  # The value model reads this to know which column to read/write.
+  # The query builder reads this to know which column to filter on.
+  # ActiveRecord handles all type casting automatically via the
+  # column's registered ActiveRecord::Type.
+  module ColumnMapping
+    extend ActiveSupport::Concern
+
+    DEFAULT_OPERATORS_BY_COLUMN = {
+      boolean_value: %i[eq not_eq is_null is_not_null],
+      string_value: %i[eq not_eq contains not_contains starts_with ends_with is_null is_not_null],
+      text_value: %i[eq not_eq contains not_contains starts_with ends_with is_null is_not_null],
+      integer_value: %i[eq not_eq gt gteq lt lteq between is_null is_not_null],
+      decimal_value: %i[eq not_eq gt gteq lt lteq between is_null is_not_null],
+      date_value: %i[eq not_eq gt gteq lt lteq between is_null is_not_null],
+      datetime_value: %i[eq not_eq gt gteq lt lteq between is_null is_not_null],
+      json_value: %i[contains is_null is_not_null],
+    }.freeze
+    FALLBACK_OPERATORS = %i[eq not_eq is_null is_not_null].freeze
+
+    class_methods do
+      # Declare which typed column this field type stores its value in.
+      def value_column(column_name = nil)
+        unless column_name
+          return @value_column || raise(NotImplementedError,
+                                        "#{name} must declare `value_column :column_name`")
+        end
+
+        @value_column = column_name.to_sym
+      end
+
+      # All operators this field type supports for querying.
+      # Subclasses can override to restrict or extend.
+      def supported_operators
+        @supported_operators || default_operators_for(value_column)
+      end
+
+      def operators(*ops)
+        @supported_operators = ops.map(&:to_sym)
+      end
+
+      private
+
+      def default_operators_for(col)
+        DEFAULT_OPERATORS_BY_COLUMN.fetch(col, FALLBACK_OPERATORS)
+      end
+    end
+  end
+end