js_admin 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e58cee8e95f86b47a5487366c9bb11691c14ad57da5a8fbb5d9f3522b49c7372
-  data.tar.gz: e47f66d3d176de880706e7fd52deb86d03ba058bf63bc75b9d702ba4e20f0814
+  metadata.gz: bacbc059bd6ee6d36d9ad35c5fa86b8cb258b4d1fda939bf3bd98b269f74c7ea
+  data.tar.gz: ef27365d7d4d61abfb48a114bcd9a1eb3a5f569b943a2369951f12e4e78aef22
 SHA512:
-  metadata.gz: cd4ee8893dea3b7a19998cf43923919491a6b5fbbda3865b4efb2b127b7d3e851da0d790a9e3be30dceaa84e9b97990b1672c13db3a9c7621f484091f3f07ad4
-  data.tar.gz: 1c149b1cca178d1850fc1a78051d1b59af102d3323a4c38f57c93fd3952652cd37c1e0657bd65da3973b81ab3aaaf0f0da94ff6517e14d8e5846202c47df0d10
+  metadata.gz: bccfe7a4bc553ff4581f6a31a4beb244fe47a39cec17a3d851b527ff74f8d2b3d8d12aa0e3f71a85ac74b2bbcd4bccddb919327cb8235c4688fa37483cc91973
+  data.tar.gz: 79370d4f7c372a9527924c0768f641109424b24c55fb42ef2f16011702f518b04560201c5b3c43c2200c860a60a447f1edf72ce542f33da2d53a3ab2af5a74aa

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.2.0 - 2026-10-18
+
+- Add host application authentication and authorization callbacks as an alternative to Basic Auth.
+- Reject conflicting or incomplete authentication configuration with localized errors.
+- Add English and Korean I18n translations for the JSAdmin interface.
+- Add `select_options` configuration to render a column as a select with static or callable choices.
+
 ## 0.1.0 - 2026-07-18
 
 - Change the default mount path to `/admin`.

data/README.md

@@ -74,9 +74,12 @@ Available configuration options:
 | `records_per_page` | `10` | Number of records shown per resource index page. |
 | `association_limit` | `100` | Maximum number of associated records loaded into a `belongs_to` select. |
 | `display_name_methods` | `%i[name title email username id]` | Methods tried in order when displaying records in tables and select labels. |
+| `field_select_options` | `{}` | Select choices by model and column. Register them with `select_options`. |
 | `basic_auth_username` | `nil` | HTTP Basic Auth username. Auth is disabled unless username and password are both present. |
 | `basic_auth_password` | `nil` | HTTP Basic Auth password. |
 | `basic_auth_realm` | `"JSAdmin"` | HTTP Basic Auth realm. |
+| `authenticate_with` | `nil` | Controller-context callback delegated to the host application's authentication. |
+| `authorize_with` | `nil` | Optional controller-context callback that returns whether the authenticated user may access JSAdmin. |
 
 Example:
 
@@ -86,14 +89,21 @@ JSAdmin.configure do |config|
   config.include_models User, Post
   config.exclude_models AuditLog
   config.records_per_page = 10
+  config.select_options "Post", category: -> { Category.pluck(:name) }
 end
 ```
 
+`select_options` renders the column as a select. Pass an array or a callable;
+callables are evaluated each time the form renders. Choices can be values or
+`[label, value]` pairs.
+
 ## Authentication
 
-JSAdmin works without authentication unless Basic Auth credentials are
-configured. When both username and password are set, every JSAdmin request
-requires HTTP Basic Auth.
+JSAdmin works without authentication unless Basic Auth credentials or an
+authentication callback are configured. Choose exactly one of the following
+authentication strategies.
+
+For HTTP Basic Auth, configure both username and password:
 
 ```ruby
 # config/initializers/js_admin.rb
@@ -104,8 +114,45 @@ JSAdmin.configure do |config|
 end
 ```
 
-For production apps, you can also mount JSAdmin inside the host application's
-admin authentication constraint when you need app-level authorization.
+To delegate authentication to the host application, provide a callback instead.
+JSAdmin controllers inherit from the host application's `ApplicationController`,
+and the callback runs in the controller context:
+
+```ruby
+# config/initializers/js_admin.rb
+JSAdmin.configure do |config|
+  config.authenticate_with do
+    authenticate_user!
+  end
+
+  config.authorize_with do
+    current_user&.admin?
+  end
+end
+```
+
+`authorize_with` is optional. When configured, returning `false` responds with
+`403 Forbidden`. Basic Auth and `authenticate_with` cannot be configured
+together. Partial Basic Auth credentials and `authorize_with` without
+`authenticate_with` also raise `JSAdmin::ConfigurationError`.
+
+For production apps, you can alternatively mount JSAdmin inside the host
+application's admin authentication constraint.
+
+## Internationalization
+
+JSAdmin follows the host application's `I18n.locale`.
+
+Supported locales:
+
+| Locale | Language |
+| --- | --- |
+| `en` | English |
+| `ko` | 한국어 |
+
+The translations cover the interface, CRUD notices, configuration errors, and
+generator messages. Host applications can override any key under the
+`js_admin` namespace.
 
 ## Field Mapping
 
@@ -117,6 +164,7 @@ JSAdmin maps database columns to inputs automatically:
 | `boolean` | checkbox |
 | `integer`, `bigint`, `float`, `decimal` | number input |
 | `date`, `datetime`, `time` | matching date/time input |
+| `select_options` configured column | select |
 | Rails enum | select |
 | `belongs_to` foreign key | select |
 | other columns | text input |

data/app/controllers/js_admin/application_controller.rb

@@ -1,20 +1,36 @@
 require "digest"
 
 module JSAdmin
-  class ApplicationController < ActionController::Base
-    before_action :authenticate_basic_auth
+  class ApplicationController < ::ApplicationController
+    before_action :authenticate_js_admin
+    before_action :authorize_js_admin
 
     private
 
-    def authenticate_basic_auth
-      return unless JSAdmin.configuration.basic_auth_enabled?
+    def authenticate_js_admin
+      case JSAdmin.configuration.authentication_strategy
+      when :basic_auth
+        authenticate_basic_auth
+      when :callback
+        instance_exec(&JSAdmin.configuration.authentication_callback)
+      end
+    end
 
+    def authenticate_basic_auth
       authenticate_or_request_with_http_basic(basic_auth_realm) do |username, password|
         secure_compare(username, JSAdmin.configuration.basic_auth_username) &&
           secure_compare(password, JSAdmin.configuration.basic_auth_password)
       end
     end
 
+    def authorize_js_admin
+      callback = JSAdmin.configuration.authorization_callback
+      return unless callback
+      return if instance_exec(&callback)
+
+      head :forbidden
+    end
+
     def basic_auth_realm
       realm = JSAdmin.configuration.basic_auth_realm.to_s
       return "JSAdmin" if realm.empty?

data/app/controllers/js_admin/resources_controller.rb

@@ -18,7 +18,8 @@ module JSAdmin
       @record = @resource.new_record(resource_params)
 
       if @record.save
-        redirect_to resource_path(@resource.model_id, @record), notice: "#{@resource.singular_label} was created."
+        redirect_to resource_path(@resource.model_id, @record),
+                    notice: t("js_admin.resources.notices.created", resource: @resource.singular_label)
       else
         render :new, status: :unprocessable_entity
       end
@@ -29,7 +30,8 @@ module JSAdmin
 
     def update
       if @record.update(resource_params)
-        redirect_to resource_path(@resource.model_id, @record), notice: "#{@resource.singular_label} was updated."
+        redirect_to resource_path(@resource.model_id, @record),
+                    notice: t("js_admin.resources.notices.updated", resource: @resource.singular_label)
       else
         render :edit, status: :unprocessable_entity
       end
@@ -37,7 +39,7 @@ module JSAdmin
 
     def destroy
       @record.destroy
-      message = "#{@resource.singular_label} was deleted."
+      message = t("js_admin.resources.notices.deleted", resource: @resource.singular_label)
 
       respond_to do |format|
         format.turbo_stream do

data/app/helpers/js_admin/application_helper.rb

@@ -101,6 +101,8 @@ module JSAdmin
         tag.input(**js_admin_input_options(form, field, js_admin_text_input_classes(form, field)).merge(type: "datetime-local", value: js_admin_formatted_field_value(form, field, "%Y-%m-%dT%H:%M:%S")))
       when :time_field
         tag.input(**js_admin_input_options(form, field, js_admin_text_input_classes(form, field)).merge(type: "time", value: js_admin_formatted_field_value(form, field, "%H:%M:%S")))
+      when :configured_select
+        select_tag(js_admin_field_name(form, field), options_for_select(field.configured_select_values, js_admin_field_value(form, field)), js_admin_select_options(form, field))
       when :enum_select
         select_tag(js_admin_field_name(form, field), options_for_select(field.enum_values, js_admin_field_value(form, field)), js_admin_select_options(form, field))
       when :association_select
@@ -171,7 +173,11 @@ module JSAdmin
 
     def js_admin_table_value(field, record)
       value = field.formatted_value(record)
-      classes = value == "NULL" ? "text-slate-400 dark:text-slate-500" : "text-slate-700 dark:text-slate-200"
+      classes = if field.value_for(record).nil?
+        "text-slate-400 dark:text-slate-500"
+      else
+        "text-slate-700 dark:text-slate-200"
+      end
 
       tag.span(truncate(value, length: 80), class: classes)
     end
@@ -189,7 +195,7 @@ module JSAdmin
     end
 
     def js_admin_sidebar_resource_label(resource)
-      resource.model_class.name.demodulize.underscore.humanize
+      resource.singular_label
     end
 
     def js_admin_sidebar_namespace_label(namespace)

data/app/views/js_admin/models/_index_content.html.erb

@@ -1,6 +1,6 @@
 <div class="mb-8">
-  <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100">Models</h1>
-  <p class="mt-2 text-sm text-slate-600 dark:text-slate-400"><%= pluralize(@resources.size, "model") %> available</p>
+  <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100"><%= t("js_admin.models.heading") %></h1>
+  <p class="mt-2 text-sm text-slate-600 dark:text-slate-400"><%= t("js_admin.models.available", count: @resources.size, formatted_count: number_with_delimiter(@resources.size)) %></p>
 </div>
 
 <div class="overflow-hidden rounded-lg border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">

data/app/views/js_admin/models/index.html.erb

@@ -1,4 +1,4 @@
-<% content_for :title, "JSAdmin Models" %>
+<% content_for :title, t("js_admin.titles.models") %>
 
 <%= render layout: "layouts/js_admin/content_frame" do %>
   <%= render "index_content" %>

data/app/views/js_admin/resources/_edit_content.html.erb

@@ -1,11 +1,11 @@
 <div class="mb-8">
   <div class="mb-2 text-sm text-slate-500 dark:text-slate-400">
-    <%= link_to "Home", root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
+    <%= link_to t("js_admin.navigation.home"), root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
     <%= link_to @resource.label, resources_path(@resource.model_id), class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
     <%= link_to @resource.display_name(@record), resource_path(@resource.model_id, @record), class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
-    Edit
+    <%= t("js_admin.resources.actions.edit") %>
   </div>
-  <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100">Edit <%= @resource.display_name(@record) %></h1>
+  <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100"><%= t("js_admin.resources.headings.edit", record: @resource.display_name(@record)) %></h1>
 </div>
 
 <%= render "form", record: @record, resource: @resource, url: resource_path(@resource.model_id, @record) %>

data/app/views/js_admin/resources/_form.html.erb

@@ -31,7 +31,8 @@
   </div>
 
   <div class="flex items-center gap-2">
-    <%= form.submit class: "inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2.5 text-sm font-medium text-white shadow-sm hover:bg-sky-700 dark:bg-sky-500 dark:hover:bg-sky-400" %>
-    <%= link_to "Cancel", record.persisted? ? resource_path(resource.model_id, record) : resources_path(resource.model_id), class: "inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2.5 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:bg-slate-800" %>
+    <% submit_label = record.persisted? ? t("js_admin.resources.actions.update", resource: resource.singular_label) : t("js_admin.resources.actions.create", resource: resource.singular_label) %>
+    <%= form.submit submit_label, class: "inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2.5 text-sm font-medium text-white shadow-sm hover:bg-sky-700 dark:bg-sky-500 dark:hover:bg-sky-400" %>
+    <%= link_to t("js_admin.resources.actions.cancel"), record.persisted? ? resource_path(resource.model_id, record) : resources_path(resource.model_id), class: "inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2.5 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:bg-slate-800" %>
   </div>
 <% end %>

data/app/views/js_admin/resources/_index_content.html.erb

@@ -1,11 +1,11 @@
 <div class="mb-8 flex flex-col gap-5 sm:flex-row sm:items-center sm:justify-between">
   <div>
-    <div class="mb-2 text-sm text-slate-500 dark:text-slate-400"><%= link_to "Home", root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> / <%= @resource.label %></div>
+    <div class="mb-2 text-sm text-slate-500 dark:text-slate-400"><%= link_to t("js_admin.navigation.home"), root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> / <%= @resource.label %></div>
     <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100"><%= @resource.label %></h1>
-    <p class="mt-2 text-sm text-slate-600 dark:text-slate-400"><%= number_with_delimiter(@total_count) %> records</p>
+    <p class="mt-2 text-sm text-slate-600 dark:text-slate-400"><%= t("js_admin.resources.records", count: @total_count, formatted_count: number_with_delimiter(@total_count)) %></p>
   </div>
 
-  <%= link_to "New #{@resource.singular_label}", new_resource_path(@resource.model_id), class: "inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2.5 text-sm font-medium text-white shadow-sm hover:bg-sky-700 dark:bg-sky-500 dark:hover:bg-sky-400" %>
+  <%= link_to t("js_admin.resources.actions.new", resource: @resource.singular_label), new_resource_path(@resource.model_id), class: "inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2.5 text-sm font-medium text-white shadow-sm hover:bg-sky-700 dark:bg-sky-500 dark:hover:bg-sky-400" %>
 </div>
 
 <div class="overflow-x-auto rounded-lg border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">
@@ -15,7 +15,7 @@
         <% @resource.list_fields.each do |field| %>
           <th scope="col" class="whitespace-nowrap px-5 py-4 text-left text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400"><%= field.human_name %></th>
         <% end %>
-        <th scope="col" class="w-44 px-5 py-4 text-right text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400">Actions</th>
+        <th scope="col" class="w-44 px-5 py-4 text-right text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400"><%= t("js_admin.resources.table.actions") %></th>
       </tr>
     </thead>
     <tbody class="divide-y divide-slate-200 bg-white dark:divide-slate-800 dark:bg-slate-900">
@@ -26,9 +26,9 @@
           <% end %>
           <td class="whitespace-nowrap px-5 py-4 text-right text-sm">
             <div class="flex items-center justify-end gap-3">
-              <%= link_to "View", resource_path(@resource.model_id, record), class: "font-medium text-sky-700 hover:text-sky-900 dark:text-sky-300 dark:hover:text-sky-200" %>
-              <%= link_to "Edit", edit_resource_path(@resource.model_id, record), class: "font-medium text-slate-700 hover:text-slate-950 dark:text-slate-300 dark:hover:text-slate-100" %>
-              <%= button_to "Delete", resource_path(@resource.model_id, record), method: :delete, form: { class: "inline", data: { turbo_confirm: "Delete this record?" } }, class: "font-medium text-rose-700 hover:text-rose-900 dark:text-rose-300 dark:hover:text-rose-200" %>
+              <%= link_to t("js_admin.resources.actions.view"), resource_path(@resource.model_id, record), class: "font-medium text-sky-700 hover:text-sky-900 dark:text-sky-300 dark:hover:text-sky-200" %>
+              <%= link_to t("js_admin.resources.actions.edit"), edit_resource_path(@resource.model_id, record), class: "font-medium text-slate-700 hover:text-slate-950 dark:text-slate-300 dark:hover:text-slate-100" %>
+              <%= button_to t("js_admin.resources.actions.delete"), resource_path(@resource.model_id, record), method: :delete, form: { class: "inline", data: { turbo_confirm: t("js_admin.resources.delete_confirmation") } }, class: "font-medium text-rose-700 hover:text-rose-900 dark:text-rose-300 dark:hover:text-rose-200" %>
             </div>
           </td>
         </tr>
@@ -36,7 +36,7 @@
 
       <% if @records.empty? %>
         <tr>
-          <td colspan="<%= @resource.list_fields.size + 1 %>" class="px-5 py-12 text-center text-sm text-slate-500 dark:text-slate-400">No records</td>
+          <td colspan="<%= @resource.list_fields.size + 1 %>" class="px-5 py-12 text-center text-sm text-slate-500 dark:text-slate-400"><%= t("js_admin.resources.table.no_records") %></td>
         </tr>
       <% end %>
     </tbody>
@@ -44,31 +44,31 @@
 </div>
 
 <div class="mt-6 flex justify-end">
-  <nav class="flex flex-wrap items-center justify-end gap-2" aria-label="Pagination">
+  <nav class="flex flex-wrap items-center justify-end gap-2" aria-label="<%= t("js_admin.resources.pagination.label") %>">
     <% if @page > 1 %>
-      <%= link_to "First", resources_path(@resource.model_id, page: 1), class: js_admin_pagination_link_classes %>
+      <%= link_to t("js_admin.resources.pagination.first"), resources_path(@resource.model_id, page: 1), class: js_admin_pagination_link_classes %>
     <% else %>
-      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true">First</span>
+      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true"><%= t("js_admin.resources.pagination.first") %></span>
     <% end %>
 
     <% if @resource.previous_page?(@page) %>
-      <%= link_to "Previous", resources_path(@resource.model_id, page: @page - 1), class: js_admin_pagination_link_classes %>
+      <%= link_to t("js_admin.resources.pagination.previous"), resources_path(@resource.model_id, page: @page - 1), class: js_admin_pagination_link_classes %>
     <% else %>
-      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true">Previous</span>
+      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true"><%= t("js_admin.resources.pagination.previous") %></span>
     <% end %>
 
-    <span class="<%= js_admin_pagination_status_classes %>" aria-current="page" aria-label="Page <%= @page %> of <%= @total_pages %>"><%= @page %> / <%= @total_pages %></span>
+    <span class="<%= js_admin_pagination_status_classes %>" aria-current="page" aria-label="<%= t("js_admin.resources.pagination.status", page: @page, total_pages: @total_pages) %>"><%= @page %> / <%= @total_pages %></span>
 
     <% if @resource.next_page?(@page) %>
-      <%= link_to "Next", resources_path(@resource.model_id, page: @page + 1), class: js_admin_pagination_link_classes %>
+      <%= link_to t("js_admin.resources.pagination.next"), resources_path(@resource.model_id, page: @page + 1), class: js_admin_pagination_link_classes %>
     <% else %>
-      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true">Next</span>
+      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true"><%= t("js_admin.resources.pagination.next") %></span>
     <% end %>
 
     <% if @page < @total_pages %>
-      <%= link_to "Last", resources_path(@resource.model_id, page: @total_pages), class: js_admin_pagination_link_classes %>
+      <%= link_to t("js_admin.resources.pagination.last"), resources_path(@resource.model_id, page: @total_pages), class: js_admin_pagination_link_classes %>
     <% else %>
-      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true">Last</span>
+      <span class="<%= js_admin_pagination_disabled_classes %>" aria-disabled="true"><%= t("js_admin.resources.pagination.last") %></span>
     <% end %>
   </nav>
 </div>

data/app/views/js_admin/resources/_new_content.html.erb

@@ -1,10 +1,10 @@
 <div class="mb-8">
   <div class="mb-2 text-sm text-slate-500 dark:text-slate-400">
-    <%= link_to "Home", root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
+    <%= link_to t("js_admin.navigation.home"), root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
     <%= link_to @resource.label, resources_path(@resource.model_id), class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
-    New
+    <%= t("js_admin.resources.actions.new", resource: @resource.singular_label) %>
   </div>
-  <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100">New <%= @resource.singular_label %></h1>
+  <h1 class="text-2xl font-semibold text-slate-950 dark:text-slate-100"><%= t("js_admin.resources.headings.new", resource: @resource.singular_label) %></h1>
 </div>
 
 <%= render "form", record: @record, resource: @resource, url: resources_path(@resource.model_id) %>

data/app/views/js_admin/resources/_show_content.html.erb

@@ -1,7 +1,7 @@
 <div class="mb-8 flex flex-col gap-5 sm:flex-row sm:items-center sm:justify-between">
   <div>
     <div class="mb-2 text-sm text-slate-500 dark:text-slate-400">
-      <%= link_to "Home", root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
+      <%= link_to t("js_admin.navigation.home"), root_path, class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
       <%= link_to @resource.label, resources_path(@resource.model_id), class: "hover:text-slate-950 dark:hover:text-slate-100" %> /
       <%= @resource.display_name(@record) %>
     </div>
@@ -9,8 +9,8 @@
   </div>
 
   <div class="flex gap-2">
-    <%= link_to "Edit", edit_resource_path(@resource.model_id, @record), class: "inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2.5 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:bg-slate-800" %>
-    <%= button_to "Delete", resource_path(@resource.model_id, @record), method: :delete, form: { data: { turbo_confirm: "Delete this record?" } }, class: "inline-flex items-center justify-center rounded-md bg-rose-600 px-4 py-2.5 text-sm font-medium text-white shadow-sm hover:bg-rose-700 dark:bg-rose-500 dark:hover:bg-rose-400" %>
+    <%= link_to t("js_admin.resources.actions.edit"), edit_resource_path(@resource.model_id, @record), class: "inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2.5 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:bg-slate-800" %>
+    <%= button_to t("js_admin.resources.actions.delete"), resource_path(@resource.model_id, @record), method: :delete, form: { data: { turbo_confirm: t("js_admin.resources.delete_confirmation") } }, class: "inline-flex items-center justify-center rounded-md bg-rose-600 px-4 py-2.5 text-sm font-medium text-white shadow-sm hover:bg-rose-700 dark:bg-rose-500 dark:hover:bg-rose-400" %>
   </div>
 </div>
 

data/app/views/js_admin/resources/edit.html.erb

@@ -1,4 +1,4 @@
-<% content_for :title, "Edit #{@resource.display_name(@record)}" %>
+<% content_for :title, t("js_admin.titles.edit", record: @resource.display_name(@record)) %>
 
 <%= render layout: "layouts/js_admin/content_frame" do %>
   <%= render "edit_content" %>

data/app/views/js_admin/resources/new.html.erb

@@ -1,4 +1,4 @@
-<% content_for :title, "New #{@resource.singular_label}" %>
+<% content_for :title, t("js_admin.titles.new", resource: @resource.singular_label) %>
 
 <%= render layout: "layouts/js_admin/content_frame" do %>
   <%= render "new_content" %>

data/app/views/layouts/js_admin/_sidebar.html.erb

@@ -25,12 +25,12 @@
   </nav>
 
   <div class="shrink-0 border-t border-slate-200 px-5 py-4 dark:border-slate-800 sm:px-8 lg:px-5">
-    <button type="button" data-js-admin-theme-target="toggle" data-action="js-admin-theme#toggle" class="inline-flex h-9 w-full items-center justify-between rounded-md border border-slate-300 bg-white px-3 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:bg-slate-800" aria-label="Toggle dark mode" aria-pressed="false">
+    <button type="button" data-js-admin-theme-target="toggle" data-action="js-admin-theme#toggle" class="inline-flex h-9 w-full items-center justify-between rounded-md border border-slate-300 bg-white px-3 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-200 dark:hover:bg-slate-800" aria-label="<%= t("js_admin.theme.toggle_aria_label") %>" aria-pressed="false">
       <span class="flex items-center gap-2">
         <span class="h-2.5 w-2.5 rounded-full bg-slate-500 dark:bg-amber-300"></span>
-        <span>Theme</span>
+        <span><%= t("js_admin.theme.label") %></span>
       </span>
-      <span class="text-xs text-slate-400 dark:text-slate-500">Toggle</span>
+      <span class="text-xs text-slate-400 dark:text-slate-500"><%= t("js_admin.theme.toggle") %></span>
     </button>
   </div>
 </aside>

data/config/locales/js_admin.en.yml

@@ -0,0 +1,65 @@
+en:
+  js_admin:
+    configuration:
+      errors:
+        incomplete_basic_auth: "Basic Auth username and password must both be configured."
+        multiple_authentication_strategies: "Basic Auth and authenticate_with cannot be configured at the same time."
+        authorization_without_authentication: "authorize_with requires authenticate_with."
+    generator:
+      options:
+        path: "Mount path for JSAdmin"
+      warnings:
+        importmap_missing: "config/importmap.rb was not found. Run bin/rails importmap:install, then rerun js_admin:install."
+    titles:
+      models: "JSAdmin Models"
+      new: "New %{resource}"
+      edit: "Edit %{record}"
+    navigation:
+      home: "Home"
+    models:
+      heading: "Models"
+      available:
+        one: "%{formatted_count} model available"
+        other: "%{formatted_count} models available"
+    resources:
+      notices:
+        created: "%{resource} was created."
+        updated: "%{resource} was updated."
+        deleted: "%{resource} was deleted."
+      records:
+        one: "%{formatted_count} record"
+        other: "%{formatted_count} records"
+      headings:
+        new: "New %{resource}"
+        edit: "Edit %{record}"
+      actions:
+        create: "Create %{resource}"
+        update: "Update %{resource}"
+        new: "New %{resource}"
+        view: "View"
+        edit: "Edit"
+        delete: "Delete"
+        cancel: "Cancel"
+      table:
+        actions: "Actions"
+        no_records: "No records"
+      delete_confirmation: "Delete this record?"
+      pagination:
+        label: "Pagination"
+        first: "First"
+        previous: "Previous"
+        next: "Next"
+        last: "Last"
+        status: "Page %{page} of %{total_pages}"
+    theme:
+      label: "Theme"
+      toggle: "Toggle"
+      toggle_aria_label: "Toggle dark mode"
+    values:
+      null: "NULL"
+      "true": "true"
+      "false": "false"
+    resource:
+      fallback_display_name: "%{resource} #%{id}"
+    errors:
+      unknown_resource: "Unknown JSAdmin resource: %{model_id}"

data/config/locales/js_admin.ko.yml

@@ -0,0 +1,65 @@
+ko:
+  js_admin:
+    configuration:
+      errors:
+        incomplete_basic_auth: "Basic Auth username과 password를 모두 설정해야 합니다."
+        multiple_authentication_strategies: "Basic Auth와 authenticate_with는 동시에 설정할 수 없습니다."
+        authorization_without_authentication: "authorize_with를 사용하려면 authenticate_with가 필요합니다."
+    generator:
+      options:
+        path: "JSAdmin mount 경로"
+      warnings:
+        importmap_missing: "config/importmap.rb를 찾을 수 없습니다. bin/rails importmap:install 실행 후 js_admin:install을 다시 실행하세요."
+    titles:
+      models: "JSAdmin 모델"
+      new: "새 %{resource}"
+      edit: "%{record} 편집"
+    navigation:
+      home: "홈"
+    models:
+      heading: "모델"
+      available:
+        one: "사용 가능한 모델 %{formatted_count}개"
+        other: "사용 가능한 모델 %{formatted_count}개"
+    resources:
+      notices:
+        created: "%{resource} 레코드를 생성했습니다."
+        updated: "%{resource} 레코드를 수정했습니다."
+        deleted: "%{resource} 레코드를 삭제했습니다."
+      records:
+        one: "레코드 %{formatted_count}개"
+        other: "레코드 %{formatted_count}개"
+      headings:
+        new: "새 %{resource}"
+        edit: "%{record} 편집"
+      actions:
+        create: "%{resource} 생성"
+        update: "%{resource} 저장"
+        new: "새 %{resource}"
+        view: "보기"
+        edit: "편집"
+        delete: "삭제"
+        cancel: "취소"
+      table:
+        actions: "작업"
+        no_records: "레코드가 없습니다"
+      delete_confirmation: "이 레코드를 삭제하시겠습니까?"
+      pagination:
+        label: "페이지 탐색"
+        first: "처음"
+        previous: "이전"
+        next: "다음"
+        last: "마지막"
+        status: "전체 %{total_pages}페이지 중 %{page}페이지"
+    theme:
+      label: "테마"
+      toggle: "전환"
+      toggle_aria_label: "다크 모드 전환"
+    values:
+      null: "NULL"
+      "true": "참"
+      "false": "거짓"
+    resource:
+      fallback_display_name: "%{resource} #%{id}"
+    errors:
+      unknown_resource: "알 수 없는 JSAdmin 리소스입니다: %{model_id}"

data/lib/generators/js_admin/install/install_generator.rb

@@ -16,7 +16,7 @@ module JSAdmin
       class_option :path,
                    type: :string,
                    default: "/admin",
-                   desc: "Mount path for JSAdmin"
+                   desc: I18n.t("js_admin.generator.options.path")
 
       def mount_engine
         route %(mount JSAdmin::Engine => "#{options[:path]}")
@@ -36,10 +36,17 @@ module JSAdmin
             # Methods tried in order when displaying records in labels and associations.
             # config.display_name_methods = %i[name title email username id]
 
+            # Render a column as a select. Callables are evaluated on every form render.
+            # config.select_options "Post", category: -> { Category.pluck(:name) }
+
             # Basic Auth is disabled unless both username and password are present.
             # config.basic_auth_username = ENV["JS_ADMIN_BASIC_AUTH_USERNAME"]
             # config.basic_auth_password = ENV["JS_ADMIN_BASIC_AUTH_PASSWORD"]
             # config.basic_auth_realm = "JSAdmin"
+
+            # Or delegate authentication and authorization to the host application.
+            # config.authenticate_with { authenticate_user! }
+            # config.authorize_with { current_user&.admin? }
           end
         RUBY
       end
@@ -48,7 +55,7 @@ module JSAdmin
         importmap_path = application_path("config/importmap.rb")
 
         unless File.exist?(importmap_path)
-          say_status :warning, "config/importmap.rb was not found. Run bin/rails importmap:install, then rerun js_admin:install.", :yellow
+          say_status :warning, I18n.t("js_admin.generator.warnings.importmap_missing"), :yellow
           return
         end
 

data/lib/js_admin/configuration.rb

@@ -5,19 +5,25 @@ module JSAdmin
                   :records_per_page,
                   :association_limit,
                   :display_name_methods,
+                  :field_select_options,
                   :basic_auth_username,
                   :basic_auth_password,
                   :basic_auth_realm
 
+    attr_reader :authentication_callback, :authorization_callback
+
     def initialize
       @included_models = []
       @excluded_models = []
       @records_per_page = 10
       @association_limit = 100
       @display_name_methods = %i[name title email username id]
+      @field_select_options = {}
       @basic_auth_username = nil
       @basic_auth_password = nil
       @basic_auth_realm = "JSAdmin"
+      @authentication_callback = nil
+      @authorization_callback = nil
     end
 
     def include_models(*models)
@@ -28,12 +34,72 @@ module JSAdmin
       excluded_models.concat(normalize_model_names(models))
     end
 
+    def select_options(model, **options_by_field)
+      model_options = field_select_options[normalize_model_names([ model ]).first] ||= {}
+      model_options.merge!(options_by_field.transform_keys(&:to_s))
+    end
+
+    def select_options_for(model, field_name)
+      field_select_options.dig(normalize_model_names([ model ]).first, field_name.to_s)
+    end
+
     def basic_auth_enabled?
-      basic_auth_username.to_s != "" && basic_auth_password.to_s != ""
+      basic_auth_username_configured? && basic_auth_password_configured?
+    end
+
+    def authenticate_with(&callback)
+      @authentication_callback = callback
+    end
+
+    def authorize_with(&callback)
+      @authorization_callback = callback
+    end
+
+    def authentication_strategy
+      validate!
+
+      return :callback if authentication_callback
+      return :basic_auth if basic_auth_enabled?
+
+      :none
+    end
+
+    def validate!
+      validate_basic_auth_credentials!
+      validate_authentication_strategy!
+      validate_authorization_callback!
+
+      self
     end
 
     private
 
+    def validate_basic_auth_credentials!
+      return if basic_auth_username_configured? == basic_auth_password_configured?
+
+      raise ConfigurationError, I18n.t("js_admin.configuration.errors.incomplete_basic_auth")
+    end
+
+    def validate_authentication_strategy!
+      return unless basic_auth_enabled? && authentication_callback
+
+      raise ConfigurationError, I18n.t("js_admin.configuration.errors.multiple_authentication_strategies")
+    end
+
+    def validate_authorization_callback!
+      return unless authorization_callback && !authentication_callback
+
+      raise ConfigurationError, I18n.t("js_admin.configuration.errors.authorization_without_authentication")
+    end
+
+    def basic_auth_username_configured?
+      basic_auth_username.to_s != ""
+    end
+
+    def basic_auth_password_configured?
+      basic_auth_password.to_s != ""
+    end
+
     def normalize_model_names(models)
       models.flatten.map { |model| model.is_a?(Class) ? model.name : model.to_s }
     end

data/lib/js_admin/configuration_error.rb

@@ -0,0 +1,4 @@
+module JSAdmin
+  class ConfigurationError < StandardError
+  end
+end

data/lib/js_admin/field.rb

@@ -36,6 +36,7 @@ module JSAdmin
     end
 
     def input_kind
+      return :configured_select if configured_select?
       return :association_select if belongs_to_association
       return :enum_select if enum?
 
@@ -65,6 +66,15 @@ module JSAdmin
       resource.model_class.defined_enums.fetch(name, {}).keys
     end
 
+    def configured_select?
+      !configured_select_source.nil?
+    end
+
+    def configured_select_values
+      source = configured_select_source
+      Array(source.respond_to?(:call) ? source.call : source)
+    end
+
     def belongs_to_association
       @belongs_to_association ||= resource.model_class
                                           .reflect_on_all_associations(:belongs_to)
@@ -98,11 +108,11 @@ module JSAdmin
 
       case value
       when nil
-        "NULL"
+        I18n.t("js_admin.values.null")
       when true
-        "true"
+        I18n.t("js_admin.values.true")
       when false
-        "false"
+        I18n.t("js_admin.values.false")
       else
         value.to_s
       end
@@ -110,6 +120,10 @@ module JSAdmin
 
     private
 
+    def configured_select_source
+      JSAdmin.configuration.select_options_for(resource.model_class, name)
+    end
+
     def inheritance_column?
       name == resource.model_class.inheritance_column
     end

data/lib/js_admin/registry.rb

@@ -7,7 +7,10 @@ module JSAdmin
 
       def resource_for!(model_id)
         resources.find { |resource| resource.model_id == model_id } ||
-          raise(ActiveRecord::RecordNotFound, "Unknown JSAdmin resource: #{model_id}")
+          raise(
+            ActiveRecord::RecordNotFound,
+            I18n.t("js_admin.errors.unknown_resource", model_id: model_id)
+          )
       end
 
       def reset!

data/lib/js_admin/resource.rb

@@ -69,7 +69,11 @@ module JSAdmin
 
       return record.public_send(display_method).to_s if display_method
 
-      "#{singular_label} ##{record.id}"
+      I18n.t(
+        "js_admin.resource.fallback_display_name",
+        resource: singular_label,
+        id: record.id
+      )
     end
 
     def next_page?(page)

data/lib/js_admin/version.rb

@@ -1,3 +1,3 @@
 module JSAdmin
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/js_admin.rb

@@ -5,6 +5,7 @@ require "stimulus-rails"
 require "tailwindcss-rails"
 require "turbo-rails"
 
+require "js_admin/configuration_error"
 require "js_admin/configuration"
 require "js_admin/field"
 require "js_admin/registry"
@@ -19,6 +20,7 @@ module JSAdmin
 
     def configure
       yield configuration
+      configuration.validate!
       Registry.reset!
     end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: js_admin
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - JoungSik
 bindir: bin
 cert_chain: []
-date: 2026-07-17 00:00:00.000000000 Z
+date: 2026-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -150,10 +150,13 @@ files:
 - app/views/layouts/js_admin/_flash_messages.html.erb
 - app/views/layouts/js_admin/_sidebar.html.erb
 - app/views/layouts/js_admin/application.html.erb
+- config/locales/js_admin.en.yml
+- config/locales/js_admin.ko.yml
 - config/routes.rb
 - lib/generators/js_admin/install/install_generator.rb
 - lib/js_admin.rb
 - lib/js_admin/configuration.rb
+- lib/js_admin/configuration_error.rb
 - lib/js_admin/engine.rb
 - lib/js_admin/field.rb
 - lib/js_admin/registry.rb