RubyGems - ruby_ui_admin - Versions diffs - 0.1.0 - Mend

ruby_ui_admin 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (182) hide show

checksums.yaml +7 -0
data/MIT-LICENSE +20 -0
data/README.md +165 -0
data/app/assets/stylesheets/ruby_ui_admin/application.tailwind.css +111 -0
data/app/components/ruby_ui_admin/ui/base.rb +26 -0
data/app/components/ruby_ui_admin/ui/icon.rb +79 -0
data/app/components/ruby_ui_admin/ui/native_select.rb +37 -0
data/app/components/ruby_ui_admin/ui/native_select_group.rb +18 -0
data/app/components/ruby_ui_admin/ui/native_select_icon.rb +42 -0
data/app/components/ruby_ui_admin/ui/native_select_option.rb +18 -0
data/app/components/ruby_ui_admin/ui/pagination.rb +62 -0
data/app/components/ruby_ui_admin/ui/pagination_content.rb +18 -0
data/app/components/ruby_ui_admin/ui/pagination_ellipsis.rb +45 -0
data/app/components/ruby_ui_admin/ui/pagination_item.rb +32 -0
data/app/components/ruby_ui_admin/ui/select.rb +29 -0
data/app/components/ruby_ui_admin/ui/toast_action.rb +30 -0
data/app/components/ruby_ui_admin/ui/toast_cancel.rb +30 -0
data/app/components/ruby_ui_admin/ui/toast_close.rb +43 -0
data/app/components/ruby_ui_admin/ui/toast_description.rb +21 -0
data/app/components/ruby_ui_admin/ui/toast_icon.rb +69 -0
data/app/components/ruby_ui_admin/ui/toast_item.rb +75 -0
data/app/components/ruby_ui_admin/ui/toast_region.rb +147 -0
data/app/components/ruby_ui_admin/ui/toast_title.rb +21 -0
data/app/components/ruby_ui_admin/ui.rb +12 -0
data/app/components/ruby_ui_admin/views/action.rb +37 -0
data/app/components/ruby_ui_admin/views/action_form.rb +104 -0
data/app/components/ruby_ui_admin/views/action_trigger.rb +148 -0
data/app/components/ruby_ui_admin/views/actions_menu.rb +34 -0
data/app/components/ruby_ui_admin/views/base.rb +301 -0
data/app/components/ruby_ui_admin/views/card_component.rb +69 -0
data/app/components/ruby_ui_admin/views/dashboard.rb +40 -0
data/app/components/ruby_ui_admin/views/docs.rb +91 -0
data/app/components/ruby_ui_admin/views/field_input.rb +156 -0
data/app/components/ruby_ui_admin/views/field_value.rb +301 -0
data/app/components/ruby_ui_admin/views/filter_bar.rb +111 -0
data/app/components/ruby_ui_admin/views/form.rb +151 -0
data/app/components/ruby_ui_admin/views/home.rb +35 -0
data/app/components/ruby_ui_admin/views/index.rb +324 -0
data/app/components/ruby_ui_admin/views/path_helpers.rb +36 -0
data/app/components/ruby_ui_admin/views/rails_helpers.rb +15 -0
data/app/components/ruby_ui_admin/views/show.rb +77 -0
data/app/components/ruby_ui_admin/views/show_fields.rb +37 -0
data/app/components/ruby_ui_admin/views/show_tab.rb +58 -0
data/app/components/ruby_ui_admin/views/structure_renderer.rb +148 -0
data/app/components/ruby_ui_admin/views/translation.rb +12 -0
data/app/controllers/ruby_ui_admin/actions_controller.rb +162 -0
data/app/controllers/ruby_ui_admin/application_controller.rb +81 -0
data/app/controllers/ruby_ui_admin/dashboards_controller.rb +12 -0
data/app/controllers/ruby_ui_admin/docs_controller.rb +166 -0
data/app/controllers/ruby_ui_admin/home_controller.rb +18 -0
data/app/controllers/ruby_ui_admin/resources_controller.rb +259 -0
data/config/locales/ruby_ui_admin.en.yml +59 -0
data/config/locales/ruby_ui_admin.pt-BR.yml +59 -0
data/config/routes/dynamic_routes.rb +11 -0
data/config/routes.rb +23 -0
data/docs/README.md +53 -0
data/docs/actions/overview.md +112 -0
data/docs/authorization/action-policy.md +72 -0
data/docs/authorization/adapters.md +101 -0
data/docs/authorization/explicit-mode.md +45 -0
data/docs/authorization/field-authorization.md +53 -0
data/docs/authorization/policies.md +62 -0
data/docs/authorization/scopes.md +48 -0
data/docs/customization/controllers.md +62 -0
data/docs/customization/ejecting.md +55 -0
data/docs/customization/javascript.md +161 -0
data/docs/customization/theming-rubyui.md +80 -0
data/docs/dashboards/overview.md +65 -0
data/docs/fields/overview.md +94 -0
data/docs/filters/overview.md +73 -0
data/docs/generators-and-tasks/overview.md +42 -0
data/docs/getting-started/authentication.md +98 -0
data/docs/getting-started/configuration.md +174 -0
data/docs/getting-started/installation.md +201 -0
data/docs/getting-started/internationalization.md +50 -0
data/docs/getting-started/practical-guide.md +310 -0
data/docs/resources/associations.md +66 -0
data/docs/resources/index-customization.md +68 -0
data/docs/resources/overview.md +50 -0
data/docs/resources/scopes.md +54 -0
data/docs/resources/tabs-panels.md +65 -0
data/lib/generators/ruby_ui_admin/action/action_generator.rb +21 -0
data/lib/generators/ruby_ui_admin/action/templates/action.rb.tt +24 -0
data/lib/generators/ruby_ui_admin/assets/assets_generator.rb +71 -0
data/lib/generators/ruby_ui_admin/card/card_generator.rb +28 -0
data/lib/generators/ruby_ui_admin/card/templates/chart_card.rb.tt +14 -0
data/lib/generators/ruby_ui_admin/card/templates/metric_card.rb.tt +14 -0
data/lib/generators/ruby_ui_admin/card/templates/partial_card.rb.tt +13 -0
data/lib/generators/ruby_ui_admin/components/components_generator.rb +43 -0
data/lib/generators/ruby_ui_admin/controller/controller_generator.rb +30 -0
data/lib/generators/ruby_ui_admin/controller/templates/controller.rb.tt +24 -0
data/lib/generators/ruby_ui_admin/dashboard/dashboard_generator.rb +18 -0
data/lib/generators/ruby_ui_admin/dashboard/templates/dashboard.rb.tt +14 -0
data/lib/generators/ruby_ui_admin/eject/eject_generator.rb +55 -0
data/lib/generators/ruby_ui_admin/filter/filter_generator.rb +28 -0
data/lib/generators/ruby_ui_admin/filter/templates/boolean_filter.rb.tt +13 -0
data/lib/generators/ruby_ui_admin/filter/templates/select_filter.rb.tt +19 -0
data/lib/generators/ruby_ui_admin/filter/templates/text_filter.rb.tt +13 -0
data/lib/generators/ruby_ui_admin/install/install_generator.rb +62 -0
data/lib/generators/ruby_ui_admin/install/templates/initializer.rb.tt +41 -0
data/lib/generators/ruby_ui_admin/locales/locales_generator.rb +22 -0
data/lib/generators/ruby_ui_admin/policy/policy_generator.rb +18 -0
data/lib/generators/ruby_ui_admin/policy/templates/policy.rb.tt +24 -0
data/lib/generators/ruby_ui_admin/resource/resource_generator.rb +84 -0
data/lib/generators/ruby_ui_admin/resource/templates/resource.rb.tt +15 -0
data/lib/generators/ruby_ui_admin/scope/scope_generator.rb +18 -0
data/lib/generators/ruby_ui_admin/scope/templates/scope.rb.tt +11 -0
data/lib/ruby_ui_admin/authorization/action_policy_adapter.rb +69 -0
data/lib/ruby_ui_admin/authorization/adapter.rb +80 -0
data/lib/ruby_ui_admin/authorization/can_can_can_adapter.rb +70 -0
data/lib/ruby_ui_admin/authorization/pundit_adapter.rb +86 -0
data/lib/ruby_ui_admin/authorization.rb +40 -0
data/lib/ruby_ui_admin/base_action.rb +211 -0
data/lib/ruby_ui_admin/base_dashboard.rb +70 -0
data/lib/ruby_ui_admin/base_policy.rb +38 -0
data/lib/ruby_ui_admin/base_resource.rb +503 -0
data/lib/ruby_ui_admin/cards/base_card.rb +59 -0
data/lib/ruby_ui_admin/cards/chart_card.rb +16 -0
data/lib/ruby_ui_admin/cards/metric_card.rb +22 -0
data/lib/ruby_ui_admin/cards/partial_card.rb +14 -0
data/lib/ruby_ui_admin/configuration.rb +177 -0
data/lib/ruby_ui_admin/current.rb +20 -0
data/lib/ruby_ui_admin/dashboard_manager.rb +52 -0
data/lib/ruby_ui_admin/engine.rb +80 -0
data/lib/ruby_ui_admin/execution_context.rb +36 -0
data/lib/ruby_ui_admin/fields/association_field.rb +67 -0
data/lib/ruby_ui_admin/fields/badge_field.rb +19 -0
data/lib/ruby_ui_admin/fields/base_field.rb +208 -0
data/lib/ruby_ui_admin/fields/belongs_to_field.rb +49 -0
data/lib/ruby_ui_admin/fields/boolean_field.rb +13 -0
data/lib/ruby_ui_admin/fields/boolean_group_field.rb +54 -0
data/lib/ruby_ui_admin/fields/code_field.rb +18 -0
data/lib/ruby_ui_admin/fields/date_field.rb +34 -0
data/lib/ruby_ui_admin/fields/date_time_field.rb +37 -0
data/lib/ruby_ui_admin/fields/field_manager.rb +27 -0
data/lib/ruby_ui_admin/fields/file_field.rb +67 -0
data/lib/ruby_ui_admin/fields/files_field.rb +62 -0
data/lib/ruby_ui_admin/fields/has_and_belongs_to_many_field.rb +9 -0
data/lib/ruby_ui_admin/fields/has_many_field.rb +24 -0
data/lib/ruby_ui_admin/fields/has_one_field.rb +13 -0
data/lib/ruby_ui_admin/fields/hidden_field.rb +14 -0
data/lib/ruby_ui_admin/fields/id_field.rb +19 -0
data/lib/ruby_ui_admin/fields/key_value_field.rb +41 -0
data/lib/ruby_ui_admin/fields/number_field.rb +13 -0
data/lib/ruby_ui_admin/fields/password_field.rb +21 -0
data/lib/ruby_ui_admin/fields/record_link_field.rb +45 -0
data/lib/ruby_ui_admin/fields/select_field.rb +71 -0
data/lib/ruby_ui_admin/fields/status_field.rb +21 -0
data/lib/ruby_ui_admin/fields/text_field.rb +14 -0
data/lib/ruby_ui_admin/fields/textarea_field.rb +13 -0
data/lib/ruby_ui_admin/fields/url_field.rb +21 -0
data/lib/ruby_ui_admin/filters/base_filter.rb +81 -0
data/lib/ruby_ui_admin/filters/boolean_filter.rb +9 -0
data/lib/ruby_ui_admin/filters/multiple_select_filter.rb +11 -0
data/lib/ruby_ui_admin/filters/select_filter.rb +9 -0
data/lib/ruby_ui_admin/filters/text_filter.rb +9 -0
data/lib/ruby_ui_admin/menu/builder.rb +94 -0
data/lib/ruby_ui_admin/resource_manager.rb +82 -0
data/lib/ruby_ui_admin/scopes/base_scope.rb +107 -0
data/lib/ruby_ui_admin/services/authorization_service.rb +38 -0
data/lib/ruby_ui_admin/structure.rb +40 -0
data/lib/ruby_ui_admin/tailwind_source.rb +65 -0
data/lib/ruby_ui_admin/version.rb +5 -0
data/lib/ruby_ui_admin/view.rb +34 -0
data/lib/ruby_ui_admin.rb +110 -0
data/lib/tasks/ruby_ui_admin.rake +71 -0
data/public/ruby-ui-admin-assets/application.css +2 -0
data/public/ruby-ui-admin-assets/controllers/index.js +36 -0
data/public/ruby-ui-admin-assets/controllers/rua--bulk-select_controller.js +19 -0
data/public/ruby-ui-admin-assets/controllers/rua--confirm_controller.js +51 -0
data/public/ruby-ui-admin-assets/controllers/rua--dialog_controller.js +55 -0
data/public/ruby-ui-admin-assets/controllers/rua--row-link_controller.js +16 -0
data/public/ruby-ui-admin-assets/controllers/rua--tabs_controller.js +36 -0
data/public/ruby-ui-admin-assets/controllers/ruby_ui--combobox_controller.js +197 -0
data/public/ruby-ui-admin-assets/controllers/ruby_ui--sheet_content_controller.js +7 -0
data/public/ruby-ui-admin-assets/controllers/ruby_ui--sheet_controller.js +15 -0
data/public/ruby-ui-admin-assets/controllers/ruby_ui--sidebar_controller.js +67 -0
data/public/ruby-ui-admin-assets/controllers/ruby_ui--toast_controller.js +151 -0
data/public/ruby-ui-admin-assets/controllers/ruby_ui--toaster_controller.js +314 -0
data/public/ruby-ui-admin-assets/vendor/stimulus.js +2567 -0
data/public/ruby-ui-admin-assets/vendor/turbo.js +7178 -0
metadata +379 -0

data/lib/ruby_ui_admin/configuration.rb ADDED Viewed

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+module RubyUIAdmin
+  # Central configuration object, configured through `RubyUIAdmin.configure`.
+  class Configuration
+    # Branding / app
+    attr_accessor :app_name
+    attr_accessor :root_path
+    attr_accessor :home_path
+    attr_accessor :timezone
+    attr_accessor :locale
+    # Pagination
+    attr_accessor :per_page
+    attr_accessor :per_page_steps
+    # Authentication
+    attr_writer :current_user_method
+    attr_writer :authenticate_with
+    # Name of a host route helper (resolved via `main_app`) for signing out. When set, a
+    # sign-out item renders at the bottom of the sidebar. e.g. :destroy_user_session_path
+    attr_accessor :sign_out_path_name
+    # HTTP method used by the sign-out item (Devise uses :delete).
+    attr_accessor :sign_out_method
+    # Authorization
+    attr_accessor :authorization_client
+    attr_accessor :explicit_authorization
+    attr_accessor :raise_error_on_missing_policy
+    # Ability class for the CanCanCan adapter (`authorization_client = :cancancan`). A class or its
+    # name; defaults to the conventional `Ability`. Ignored by other adapters.
+    attr_accessor :cancancan_ability_class
+    # Resource discovery
+    attr_accessor :resources
+    attr_accessor :model_resource_mapping
+    # Menus
+    attr_writer :main_menu
+    attr_writer :profile_menu
+    # When true (default), the layout loads the bundled JS (tabs, dialogs). The admin
+    # works without it (progressive enhancement); set to false to opt out.
+    attr_accessor :javascript
+    # Head assets (stylesheet + JS tags) for the admin layout. The admin renders the host's
+    # RubyUI components, so the host owns the CSS (Tailwind build) and JS (bundler/importmap that
+    # registers the RubyUI Stimulus controllers + ours). Set this to a proc that returns the
+    # `<head>` asset markup; it's evaluated in the Rails view context, so it can call helpers like
+    # `stylesheet_link_tag` / `javascript_importmap_tags`. When nil, the layout renders no assets.
+    attr_accessor :head_assets
+    # When true, clicking an index row navigates to the record's show page (needs JS).
+    attr_accessor :click_row_to_view_record
+    # When true, non-active tabs on the show view load their content lazily (fetched via JS
+    # when the tab is first opened, with a spinner) instead of all rendering up front. Needs JS;
+    # without JS the active tab still renders and the others show a "requires JavaScript" notice.
+    attr_accessor :lazy_tabs
+    # Controls the in-app docs browser mounted at `<mount>/docs` (renders the gem's `docs/*.md`).
+    # Accepts:
+    #   :local (default) — mounted in development/test only
+    #   true             — mounted in all environments, including production (where it sits behind
+    #                       the admin authentication gate; locally it stays open)
+    #   false            — never mounted
+    #   a callable        — evaluated at boot/route-draw time; truthy enables it
+    # Needs `kramdown` + `kramdown-parser-gfm` available in the running environment's bundle.
+    attr_accessor :docs_enabled
+    # Global pagination options, e.g. `{ type: :countless }` (or a proc returning it) to
+    # paginate without a COUNT query across all resources. Per-resource `self.countless`
+    # can still opt in individually.
+    attr_writer :pagination
+    def initialize
+      @app_name = "RubyUI Admin"
+      @root_path = "/admin"
+      @home_path = nil
+      @timezone = "UTC"
+      @locale = nil
+      @per_page = 24
+      @per_page_steps = [12, 24, 48, 72]
+      @current_user_method = nil
+      @true_user_method = nil
+      @authenticate_with = nil
+      @sign_out_path_name = nil
+      @sign_out_method = :delete
+      @authorization_client = :action_policy
+      @explicit_authorization = false
+      @raise_error_on_missing_policy = false
+      @cancancan_ability_class = nil
+      @resources = nil
+      @model_resource_mapping = {}
+      @main_menu = nil
+      @profile_menu = nil
+      @javascript = true
+      @head_assets = nil
+      @click_row_to_view_record = false
+      @lazy_tabs = false
+      @docs_enabled = :local
+      @pagination = {}
+    end
+    # Resolved pagination options (calls the proc form if given).
+    def pagination
+      @pagination.respond_to?(:call) ? @pagination.call : (@pagination || {})
+    end
+    # Whether pagination should run without a COUNT query globally.
+    def countless_pagination?
+      pagination[:type].to_s == "countless"
+    end
+    # Resolve the current user from the host app context (usually a controller).
+    def current_user_method(&block)
+      if block_given?
+        @current_user_method = block
+      else
+        @current_user_method
+      end
+    end
+    # Resolve the real (non-impersonated) user. Defaults to `current_user` when unset.
+    def true_user_method(&block)
+      if block_given?
+        @true_user_method = block
+      else
+        @true_user_method
+      end
+    end
+    def authenticate_with(&block)
+      if block_given?
+        @authenticate_with = block
+      else
+        @authenticate_with
+      end
+    end
+    def main_menu(&block)
+      if block_given?
+        @main_menu = block
+      else
+        @main_menu
+      end
+    end
+    def profile_menu(&block)
+      if block_given?
+        @profile_menu = block
+      else
+        @profile_menu
+      end
+    end
+    def authorization_enabled?
+      !authorization_client.nil?
+    end
+    # Whether the in-app docs browser is available in the current environment.
+    def docs_enabled?
+      case docs_enabled
+      when nil, :local then Rails.env.local?
+      when Proc then !!docs_enabled.call
+      else !!docs_enabled
+      end
+    end
+  end
+end

data/lib/ruby_ui_admin/current.rb ADDED Viewed

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+require "active_support/current_attributes"
+module RubyUIAdmin
+  # Thread/request-scoped state, accessible globally as RubyUIAdmin::Current.user etc.
+  class Current < ActiveSupport::CurrentAttributes
+    attribute :user
+    attribute :true_user
+    attribute :request
+    attribute :view_context
+    attribute :resource_manager
+    def params
+      request.params
+    rescue
+      {}
+    end
+  end
+end

data/lib/ruby_ui_admin/dashboard_manager.rb ADDED Viewed

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+require "active_support/core_ext/class/subclasses"
+module RubyUIAdmin
+  # Discovers dashboards defined under RubyUIAdmin::Dashboards in
+  # app/ruby_ui_admin/dashboards.
+  class DashboardManager
+    def boot
+      @dashboards = nil
+      self
+    end
+    def dashboards
+      @dashboards ||= fetch_dashboards
+    end
+    def find(id)
+      dashboards.find { |dashboard| dashboard.id == id.to_s }
+    end
+    def any?
+      dashboards.any?
+    end
+    private
+    def fetch_dashboards
+      eager_load_dashboards
+      # Dedupe by name and re-resolve the constant: in development, `descendants` retains
+      # stale class versions from previous Zeitwerk reloads (same name), which would show
+      # duplicates. Resolving by name keeps only the current class.
+      RubyUIAdmin::BaseDashboard.descendants
+        .select { |dashboard| !dashboard.abstract? && dashboard.to_s.start_with?("RubyUIAdmin::Dashboards::") }
+        .map(&:to_s).uniq
+        .filter_map { |name| name.safe_constantize }
+    end
+    def eager_load_dashboards
+      return unless defined?(::Rails)
+      dir = Rails.root.join("app", "ruby_ui_admin", "dashboards")
+      return unless Dir.exist?(dir)
+      loader = Rails.autoloaders.main
+      loader.eager_load_dir(dir) if loader.respond_to?(:eager_load_dir)
+    rescue NameError
+      nil
+    end
+  end
+end

data/lib/ruby_ui_admin/engine.rb ADDED Viewed

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+require "rails/engine"
+require "phlex-rails"
+require "action_policy"
+require "pagy"
+# Loaded at engine boot (before host initializers) so hosts that freeze `Pagy::DEFAULT`
+# don't hit a FrozenError when this extra is first required.
+require "pagy/extras/countless"
+require "turbo-rails"
+require "tailwind_merge"
+module RubyUIAdmin
+  # URL prefix where the bundled stylesheet is served (outside the engine mount).
+  ASSETS_MOUNT_PATH = "/ruby-ui-admin-assets"
+  class Engine < ::Rails::Engine
+    isolate_namespace RubyUIAdmin
+    # Register inflections as early as possible, before autoload paths are set.
+    # The `UI` acronym is needed by BOTH the autoloader (so `ruby_ui_admin/` and
+    # `ui/` map to RubyUIAdmin / UI) AND by Rails routing/controller resolution
+    # (which camelizes "ruby_ui_admin/resources" via ActiveSupport::Inflector).
+    initializer "ruby_ui_admin.inflections", before: :set_autoload_paths do
+      ActiveSupport::Inflector.inflections(:en) do |inflect|
+        inflect.acronym "UI"
+      end
+      Rails.autoloaders.each do |loader|
+        loader.inflector.inflect(
+          "ruby_ui_admin" => "RubyUIAdmin",
+          "ui" => "UI",
+          "dsl" => "DSL"
+        )
+      end
+    end
+    # Discover host-defined resources/actions/filters/policies in `app/ruby_ui_admin`,
+    # namespaced under RubyUIAdmin.
+    initializer "ruby_ui_admin.autoload" do |app|
+      host_dir = Rails.root.join("app", "ruby_ui_admin").to_s
+      ActiveSupport::Dependencies.autoload_paths.delete(host_dir)
+      if Dir.exist?(host_dir)
+        Rails.autoloaders.main.push_dir(host_dir, namespace: RubyUIAdmin)
+        app.config.watchable_dirs[host_dir] = [:rb]
+      end
+    end
+    # Reboot the registry whenever the app reloads in development.
+    config.to_prepare do
+      RubyUIAdmin.reset_resource_manager
+      RubyUIAdmin.boot
+    end
+    # Provide a `mount_ruby_ui_admin` routing helper.
+    initializer "ruby_ui_admin.routing" do
+      ActionDispatch::Routing::Mapper.include(Module.new {
+        def mount_ruby_ui_admin(at: RubyUIAdmin.configuration.root_path, **options, &block)
+          mount RubyUIAdmin::Engine, at:, as: "ruby_ui_admin", **options
+          if block
+            scope at do
+              RubyUIAdmin::Engine.routes.draw(&block)
+            end
+          end
+        end
+      })
+    end
+    # Serve the bundled, precompiled stylesheet at a fixed URL, independent of the
+    # host's asset pipeline.
+    config.app_middleware.use(
+      Rack::Static,
+      urls: [RubyUIAdmin::ASSETS_MOUNT_PATH],
+      root: RubyUIAdmin::Engine.root.join("public").to_s
+    )
+  end
+end

data/lib/ruby_ui_admin/execution_context.rb ADDED Viewed

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+module RubyUIAdmin
+  # Evaluates a value that may be a literal or a Proc. When it's a Proc, it's
+  # instance_exec'd with all the passed keyword arguments available as readers.
+  #
+  #   ExecutionContext.new(target: -> { record.name }, record: post).handle
+  class ExecutionContext
+    def initialize(**args)
+      @target = args.delete(:target)
+      # When present, unknown methods (view/url helpers like `link_to`, `main_app`,
+      # `*_path`) are delegated to this Rails view context inside the block.
+      @view_context = args.delete(:view_context)
+      @args = args
+      args.each do |key, value|
+        define_singleton_method(key) { value }
+      end
+    end
+    def handle
+      return @target unless @target.respond_to?(:call)
+      instance_exec(&@target)
+    end
+    def method_missing(name, *args, **kwargs, &block)
+      return super unless @view_context.respond_to?(name)
+      @view_context.public_send(name, *args, **kwargs, &block)
+    end
+    def respond_to_missing?(name, include_private = false)
+      (@view_context&.respond_to?(name)) || super
+    end
+  end
+end

data/lib/ruby_ui_admin/fields/association_field.rb ADDED Viewed

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+module RubyUIAdmin
+  module Fields
+    # Base for has_one / has_many / has_and_belongs_to_many fields. Association
+    # fields are shown on the show view only by default.
+    class AssociationField < BaseField
+      def default_hidden_views
+        %i[index new edit]
+      end
+      # The association read from the record — `for_attribute:` overrides the field id,
+      # e.g. `field :discussion, as: :has_many, for_attribute: :comments`.
+      def association_name
+        options[:for_attribute] || id
+      end
+      # Read the association (honoring `for_attribute:`); a computed block still wins.
+      def value(record, view_context: nil)
+        return super if block
+        record&.respond_to?(association_name) ? record.public_send(association_name) : nil
+      end
+      def reflection
+        resource&.model_class&.reflect_on_association(association_name)
+      end
+      def target_model
+        options[:model] || reflection&.klass
+      end
+      # Resource to link associated records through (`use_resource:` overrides the default
+      # model→resource lookup done by the view).
+      def use_resource
+        options[:use_resource]
+      end
+      # Applies a `scope:` (Symbol naming a relation method, or a lambda with `query`) to a
+      # relation value. No-op for nil or no scope.
+      def scoped(relation)
+        scope = options[:scope]
+        return relation if relation.nil? || scope.nil?
+        return relation.public_send(scope) if scope.is_a?(Symbol)
+        ExecutionContext.new(target: scope, query: relation, resource: resource).handle
+      end
+      def display_label(record)
+        return nil if record.nil?
+        if record.respond_to?(:to_label)
+          record.to_label
+        elsif record.respond_to?(:name)
+          record.name
+        elsif record.respond_to?(:title)
+          record.title
+        else
+          "#{record.model_name.human} ##{record.id}"
+        end
+      end
+      # Association values aren't writable through a simple setter here.
+      def fill_value(record, value); end
+    end
+  end
+end

data/lib/ruby_ui_admin/fields/badge_field.rb ADDED Viewed

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+module RubyUIAdmin
+  module Fields
+    # Renders the value as a colored badge. Map values to variants with
+    # `options: { active: :success, pending: :warning, ... }`.
+    class BadgeField < BaseField
+      register_as :badge
+      DEFAULT_VARIANT = :gray
+      def variant_for(record)
+        mapping = options[:options] || {}
+        key = value(record)
+        (mapping[key] || mapping[key.to_s] || mapping[key.to_s.to_sym] || DEFAULT_VARIANT).to_sym
+      end
+    end
+  end
+end

data/lib/ruby_ui_admin/fields/base_field.rb ADDED Viewed

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+module RubyUIAdmin
+  module Fields
+    # Base class for all field types. Fields are pure data/metadata objects; the
+    # actual rendering lives in Phlex components (app/components/ruby_ui_admin/fields).
+    class BaseField
+      attr_reader :id, :options, :block
+      attr_accessor :resource
+      # Registers the field under a DSL symbol, e.g. `register_as :text`.
+      def self.register_as(key)
+        @field_type = key.to_sym
+        Fields.register(key, self)
+      end
+      def self.field_type
+        @field_type
+      end
+      def initialize(id, resource: nil, **options, &block)
+        @id = id.to_sym
+        @resource = resource
+        @options = options
+        @block = block
+        @name = options[:name]
+        @required = options.fetch(:required, false)
+        @readonly = options.fetch(:readonly, false)
+        @sortable = options.fetch(:sortable, false)
+        @filterable = options.fetch(:filterable, false)
+        @link_to_record = options.fetch(:link_to_record, false)
+        @format_using = options[:format_using]
+        @help = options[:help]
+        @description = options[:description]
+        @visible = options[:visible]
+        @placeholder = options[:placeholder]
+        @default = options[:default]
+        @only_on = normalize_views(options[:only_on])
+        @hide_on = normalize_views(options[:hide_on])
+      end
+      def type
+        self.class.field_type
+      end
+      def name
+        return @name if @name
+        model = resource&.model_class
+        # Uses the model's i18n attribute name (activerecord.attributes.*),
+        # falling back to a humanized id.
+        model.respond_to?(:human_attribute_name) ? model.human_attribute_name(id) : id.to_s.humanize
+      end
+      def help = @help
+      def description = @description
+      def placeholder = @placeholder
+      def required? = !!@required
+      def readonly? = !!@readonly
+      def sortable? = !!@sortable
+      def filterable? = !!@filterable
+      def link_to_record? = !!@link_to_record
+      # The underlying attribute name on the model (overridable by subclasses,
+      # e.g. belongs_to appends `_id`).
+      def database_id
+        id
+      end
+      # Raw value read from the record (or computed via a block). When a `view_context`
+      # is given, the computed block can use view/url helpers (`link_to`, `main_app`, …).
+      def value(record, view_context: nil)
+        return nil if record.nil?
+        if block
+          ExecutionContext.new(
+            target: block,
+            record: record,
+            resource: resource,
+            current_user: resource&.user,
+            view_context: view_context
+          ).handle
+        elsif record.respond_to?(id)
+          record.public_send(id)
+        end
+      end
+      # Value formatted for display.
+      def formatted_value(record, view_context: nil)
+        raw = value(record, view_context: view_context)
+        return raw if @format_using.nil?
+        ExecutionContext.new(
+          target: @format_using,
+          value: raw,
+          record: record,
+          resource: resource,
+          current_user: resource&.user,
+          view_context: view_context
+        ).handle
+      end
+      # Assigns a submitted value back onto the record.
+      def fill_value(record, value)
+        setter = "#{database_id}="
+        record.public_send(setter, value) if record.respond_to?(setter)
+      end
+      # Which form param this field reads/writes.
+      def permitted_param
+        database_id
+      end
+      # The strong-parameters fragment for this field (scalar by default; fields with
+      # hash/array values override, e.g. boolean_group -> { name => {} }, files -> { name => [] }).
+      def permit_param
+        permitted_param
+      end
+      # All strong-params fragments this field contributes. Defaults to a single `permit_param`;
+      # fields that read extra inputs (e.g. a file field's remove checkbox) return more.
+      def permit_params
+        [permit_param]
+      end
+      # Applies the submitted (permitted) `attributes` to the record for this field. Default just
+      # assigns `permitted_param`; fields with extra inputs override (e.g. file remove).
+      def fill(record, attributes)
+        key = permitted_param.to_s
+        fill_value(record, attributes[key]) if attributes.key?(key)
+      end
+      def has_default?
+        !@default.nil?
+      end
+      # The field's default for a new record (literal or a proc evaluated with
+      # `record`, `resource` and `current_user` available).
+      def default_value(record = nil)
+        return @default unless @default.respond_to?(:call)
+        ExecutionContext.new(
+          target: @default,
+          record: record,
+          resource: resource,
+          current_user: resource&.user
+        ).handle
+      end
+      # Conditional visibility (`visible: -> { current_user.admin? }`), evaluated with
+      # `view`/`record`/`resource`/`current_user`. A literal is used as-is. Defaults to visible.
+      def visible?(view: nil, record: nil)
+        return true if @visible.nil?
+        result =
+          if @visible.respond_to?(:call)
+            ExecutionContext.new(
+              target: @visible,
+              view: View.wrap(view),
+              record: record,
+              resource: resource,
+              current_user: resource&.user
+            ).handle
+          else
+            @visible
+          end
+        !!result
+      end
+      def visible_in_view?(view)
+        view = view.to_sym
+        return @only_on.include?(view) if @only_on
+        return !@hide_on.include?(view) if @hide_on
+        !default_hidden_views.include?(view)
+      end
+      # Views where a field type is hidden unless `only_on`/`hide_on` say otherwise.
+      # Overridden by heavy/association fields (e.g. has_many hides everywhere but show).
+      def default_hidden_views
+        []
+      end
+      # Whether the field can be sorted, and the column/expression to sort by.
+      # `sortable: true` sorts by the database column; `sortable: ->{...}` is custom.
+      def sort_lambda
+        @sortable.respond_to?(:call) ? @sortable : nil
+      end
+      private
+      def normalize_views(value)
+        return nil if value.nil?
+        # `:forms` = new+edit; `:display` = index+show (view groups).
+        Array(value).flat_map do |v|
+          case v.to_sym
+          when :forms then %i[new edit]
+          when :display then %i[index show]
+          else v.to_sym
+          end
+        end
+      end
+    end
+  end
+end