plutonium 0.26.11 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e10062c979c0a1928e52aa93f22693aae2eb398cb5435301883b0de4212d12b7
-  data.tar.gz: c72b315aa37c784b7d9502ba084a080b71b06e02cdeb9a9bdf5555b921e2b89c
+  metadata.gz: 429c40389e06fd8b0dd3a490515561c4819adda14e3837107426eb74101880d4
+  data.tar.gz: 7f11c16faa7b0e0972007afdced5713d13e4cb2a48397632938f19a56c1f6d90
 SHA512:
-  metadata.gz: ad63980d8dafd43aaea7ecd69434aba8667f1b33a6b28cd753c37bb7bdf3b7607b4c182a0bcc1d4b7cb123eb245ae76b844c2f498d4eaa4ec40609324bac2760
-  data.tar.gz: 73a2186b8e61124260b3eefd856a7a93f0cf53069221d22bd39022e8375b6fb0a108a01fc2226694da3b7fad0fd5a0ed7cd29a943c20e55586ef216c6f097ad9
+  metadata.gz: 8a74e71f54e4d3bd8bde88cb9c02c7f80bba61d5ed01ca20d62aa4559537073c35aeb94b1d9dcab3639b691279d8d8c7a88b1ae2e1da2a7ec26226e1835f251c
+  data.tar.gz: 44aa9125097ade4af6efda8f214bf9ba31cb59792bfa6660e303bb558bfa6da469921aa4954796ee948ca8403f471de3ec013de49abb46f6c83dd6a65b2e3f10

data/.cliff.toml

@@ -0,0 +1,68 @@
+# git-cliff configuration file
+# https://git-cliff.org/docs/configuration
+
+[changelog]
+# changelog header
+header = """
+# Changelog\n
+All notable changes to this project will be documented in this file.\n
+"""
+# template for the changelog body
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [Unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.breaking %}[**breaking**] {% endif %}{{ commit.message | upper_first }}\
+    {% endfor %}
+{% endfor %}\n
+"""
+# remove the leading and trailing whitespace from the template
+trim = true
+# changelog footer
+footer = """
+<!-- generated by git-cliff -->
+"""
+
+[git]
+# parse the commits based on https://www.conventionalcommits.org
+conventional_commits = true
+# filter out the commits that are not conventional
+filter_unconventional = true
+# process each line of a commit as an individual commit
+split_commits = false
+# regex for preprocessing the commit messages
+commit_preprocessors = [
+  { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](https://github.com/radioactive-labs/plutonium-core/issues/${2}))" },
+]
+# regex for parsing and grouping commits
+commit_parsers = [
+  { message = "^feat", group = "Features" },
+  { message = "^fix", group = "Bug Fixes" },
+  { message = "^doc", group = "Documentation" },
+  { message = "^perf", group = "Performance" },
+  { message = "^refactor", group = "Refactoring" },
+  { message = "^style", group = "Styling" },
+  { message = "^test", group = "Testing" },
+  { message = "^chore\\(release\\): prepare for", skip = true },
+  { message = "^chore", group = "Miscellaneous Tasks" },
+  { body = ".*security", group = "Security" },
+]
+# protect breaking changes from being skipped due to matching a skipping commit_parser
+protect_breaking_commits = false
+# filter out the commits that are not matched by commit parsers
+filter_commits = false
+# glob pattern for matching git tags
+tag_pattern = "v[0-9]*"
+# regex for skipping tags
+skip_tags = "v0.1.0-beta.1"
+# regex for ignoring tags
+ignore_tags = ""
+# sort the tags topologically
+topo_order = false
+# sort the commits inside sections by oldest/newest order
+sort_commits = "oldest"

data/CHANGELOG.md

@@ -1,5 +1,70 @@
-## [Unreleased]
+## [0.27.0] - 2025-11-05
 
-## [0.1.0] - 2024-01-01
+### 🚀 Features
 
-- Initial release
+- Add field-level options support for input/display/column definitions
+
+### 🐛 Bug Fixes
+
+- Reload version constant in release:publish task
+
+### 📚 Documentation
+
+- Setup contribution guidelines using Conventional Commits
+## [0.26.9] - 2025-09-25
+
+### 🚀 Features
+
+- Disable csrf protection if authorization header is set
+## [0.26.8] - 2025-08-11
+
+### 🐛 Bug Fixes
+
+- Prevent SQLite adapter error when using non-SQLite databases (#42)
+- Fix STI model routing logic in controller (#43)
+## [0.26.6] - 2025-08-03
+
+### 🚜 Refactor
+
+- Enhance color mode selector and integrate into header layout (#41)
+## [0.26.2] - 2025-07-22
+
+### 🐛 Bug Fixes
+
+- Handle redirect after interaction submission (#37)
+- Enhance flatpickr to attach to modals correctly (#35)
+## [0.23.2] - 2025-05-27
+
+### 🚜 Refactor
+
+- Update EasyMDE styles (#33)
+## [0.23.1] - 2025-05-27
+
+### 🐛 Bug Fixes
+
+- Hide password visibility checkbox when not needed (#32)
+## [0.21.1] - 2025-04-27
+
+### 🚀 Features
+
+- Preserve whitespace in hints to allow some formatting (#25)
+
+### 🚜 Refactor
+
+- Fix join condition for `has_one` and `has_many` associations (#23)
+## [0.21.0] - 2025-04-01
+
+### 🚀 Features
+
+- Add cleaner cards for resources on the dashboard index page (#22)
+## [0.20.4] - 2025-03-15
+
+### 🐛 Bug Fixes
+
+- Fix Tailwind CSS v4 upgrade issue for existing projects (#18)
+## [0.19.13] - 2025-03-02
+
+### 🚀 Features
+
+- Add password visibility toggle to sign up and login forms (#17)
+## [0.6.2] - 2024-02-21

data/CONTRIBUTING.md

@@ -0,0 +1,134 @@
+# Contributing to Plutonium
+
+## Commit Message Convention
+
+This project follows [Conventional Commits](https://www.conventionalcommits.org/) for automated changelog generation and versioning.
+
+### Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+- **feat**: A new feature (triggers MINOR version bump)
+- **fix**: A bug fix (triggers PATCH version bump)
+- **docs**: Documentation only changes
+- **style**: Changes that don't affect code meaning (formatting, etc)
+- **refactor**: Code change that neither fixes a bug nor adds a feature
+- **perf**: Performance improvement
+- **test**: Adding or updating tests
+- **chore**: Maintenance tasks (dependencies, tooling, etc)
+
+### Breaking Changes
+
+Add `BREAKING CHANGE:` in the footer or `!` after type to trigger a MAJOR version bump:
+
+```
+feat!: remove deprecated API
+
+BREAKING CHANGE: The old API has been removed. Use new API instead.
+```
+
+### Examples
+
+```bash
+# Feature (bumps 0.26.11 -> 0.27.0)
+git commit -m "feat: add field-level options support for input definitions"
+
+# Bug fix (bumps 0.26.11 -> 0.26.12)
+git commit -m "fix: resolve inheritance issue with controller_for"
+
+# Breaking change (bumps 0.26.11 -> 1.0.0)
+git commit -m "feat!: redesign definition DSL
+
+BREAKING CHANGE: The definition DSL has been completely redesigned.
+See migration guide for details."
+
+# With scope
+git commit -m "feat(ui): add new table component"
+git commit -m "fix(forms): correct hint display on validation errors"
+
+# Documentation
+git commit -m "docs: update definition structure guide"
+```
+
+## Release Process
+
+### Option 1: Automated (Recommended)
+
+```bash
+# See what the next version should be
+rake release:next_version
+
+# Prepare a new release (updates version, generates changelog)
+rake release:prepare[0.27.0]
+
+# Review changes
+git diff
+
+# Full automated release (prepare, commit, tag, push, publish)
+rake release:full[0.27.0]
+```
+
+### Option 2: Manual
+
+```bash
+# 1. Update version in lib/plutonium/version.rb
+# 2. Generate changelog
+git-cliff --tag v0.27.0 -o CHANGELOG.md
+
+# 3. Commit and tag
+git add -A
+git commit -m "chore(release): prepare for v0.27.0"
+git tag v0.27.0
+git push origin main --tags
+
+# 4. GitHub Actions will automatically publish to RubyGems
+```
+
+## Version Bumping Rules
+
+Following semantic versioning:
+
+- **MAJOR** (X.0.0): Breaking changes
+- **MINOR** (0.X.0): New features (backwards compatible)
+- **PATCH** (0.0.X): Bug fixes (backwards compatible)
+
+The automation determines the version bump based on commits since the last tag:
+- Any commit with `BREAKING CHANGE:` or `!` after type → MAJOR
+- Any `feat:` commits → MINOR
+- Any `fix:` commits → PATCH
+
+## Development Setup
+
+```bash
+# Install dependencies
+bundle install
+
+# Run tests
+bundle exec rspec
+
+# Install git-cliff for changelog generation (optional)
+brew install git-cliff  # macOS
+# or
+cargo install git-cliff  # via Rust
+```
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feat/my-feature`
+3. Make your changes with conventional commits
+4. Run tests: `bundle exec rspec`
+5. Push and create a pull request
+6. The PR title should also follow conventional commit format
+
+## Questions?
+
+Open an issue or discussion on GitHub!

data/Rakefile

@@ -2,6 +2,9 @@ require "bundler/gem_tasks"
 require "rake/testtask"
 require "standard/rake"
 
+# Load custom rake tasks
+Dir.glob("lib/tasks/**/*.rake").each { |r| load r }
+
 task default: %i[test standard]
 
 task :assets do

data/docs/modules/definition.md

@@ -143,17 +143,35 @@ end
 ### 2. **Add Custom Options**
 ```ruby
 class PostDefinition < Plutonium::Resource::Definition
-  # Add placeholder text
-  input :title, placeholder: "Enter an engaging title"
-
-  # Add custom CSS classes
+  # Field-level options for inputs (affect the field wrapper)
+  input :title,
+    label: "Article Title",
+    hint: "Enter a descriptive title",
+    placeholder: "e.g. My First Post"
+
+  # Field-level options for displays (affect the field wrapper)
+  display :content,
+    label: "Article Content",
+    description: "Published article content",
+    placeholder: "No content available"
+
+  # Tag-level options (passed to the HTML element)
+  input :slug, class: "font-mono"
   display :title, class: "text-2xl font-bold"
 
-  # Add wrapper styling
+  # Wrapper styling
   display :content, wrapper: {class: "prose max-w-none"}
 end
 ```
 
+::: tip Field-level vs Tag-level Options
+Plutonium distinguishes between two types of options:
+- **Field-level options** (`label`, `hint`, `description`, `placeholder`) - Processed by the field wrapper, affect labels and help text
+- **Tag-level options** (`class`, `data`, `required`, etc.) - Passed directly to the HTML element
+
+The framework automatically routes each option to the correct destination.
+:::
+
 ### 3. **Configure Select Options**
 ```ruby
 class PostDefinition < Plutonium::Resource::Definition
@@ -794,6 +812,308 @@ end
 
 The Definition module provides a clean, declarative way to configure resource behavior while maintaining clear separation between configuration (definitions), authorization (policies), and business logic (interactions).
 
+## Structuring Your Definition File
+
+A well-structured definition file is easy to read, maintain, and understand. Here's the recommended organization:
+
+### 1. Logical Grouping
+
+Group related declarations together for better readability:
+
+```ruby
+class PostDefinition < Plutonium::Resource::Definition
+  # === Field Type Overrides ===
+  # Group all basic field type changes together
+  field :content, as: :rich_text
+  field :author_id, as: :hidden
+  field :metadata, as: :json
+
+  # === Input Customizations ===
+  # Group form-specific configurations
+  input :title,
+    label: "Post Title",
+    hint: "Enter a descriptive title",
+    placeholder: "e.g. Getting Started with Plutonium"
+
+  input :slug,
+    label: "URL Slug",
+    hint: "Leave blank to auto-generate from title",
+    class: "font-mono"
+
+  input :category, as: :select, choices: %w[Tech Business Lifestyle]
+
+  # === Display Customizations ===
+  # Group show page configurations
+  display :content, as: :markdown
+  display :view_count, label: "Views", class: "font-bold"
+  display :metadata, wrapper: {class: "col-span-full"}
+
+  # === Column Customizations ===
+  # Group table-specific configurations
+  column :title, label: "Article Title"
+  column :view_count, align: :end, label: "Views"
+  column :published_at, align: :end
+
+  # === Search & Filtering ===
+  # Group query-related configurations
+  search do |scope, query|
+    scope.where("title ILIKE ? OR content ILIKE ?", "%#{query}%", "%#{query}%")
+  end
+
+  filter :status, as: :select, choices: %w[draft published archived]
+  filter :category, as: :select, choices: %w[Tech Business Lifestyle]
+
+  # === Scopes ===
+  scope :published
+  scope :draft
+  scope :archived
+
+  # === Sorting ===
+  sort :title
+  sort :created_at
+  sort :view_count
+
+  # === Actions ===
+  action :publish, interaction: Posts::Publish
+  action :archive, interaction: Posts::Archive
+end
+```
+
+### 2. Use Comments to Delineate Sections
+
+Add section headers with comments to make the file scannable:
+
+```ruby
+class PostDefinition < Plutonium::Resource::Definition
+  # ========================================
+  # Field Configuration
+  # ========================================
+
+  field :content, as: :rich_text
+
+  # ========================================
+  # Form Inputs
+  # ========================================
+
+  input :title, hint: "Enter a descriptive title"
+
+  # ========================================
+  # Display Fields
+  # ========================================
+
+  display :content, as: :markdown
+
+  # ========================================
+  # Table Columns
+  # ========================================
+
+  column :view_count, align: :end
+
+  # ========================================
+  # Search, Filters & Scopes
+  # ========================================
+
+  search { |scope, query| scope.where("title ILIKE ?", "%#{query}%") }
+  filter :status, as: :select, choices: %w[draft published]
+
+  # ========================================
+  # Actions
+  # ========================================
+
+  action :publish, interaction: Posts::Publish
+end
+```
+
+### 3. Order Within Each Section
+
+Within each section, order declarations logically:
+
+**For fields/inputs/displays:**
+1. Basic field type overrides first
+2. Fields with simple options next
+3. Fields with complex options or blocks last
+
+**For filters and scopes:**
+1. Most commonly used first
+2. Grouped by related functionality
+
+**For actions:**
+1. Primary actions first (create, publish)
+2. Secondary actions next (archive, duplicate)
+3. Destructive actions last (delete)
+
+### 4. Use `field` vs `input` vs `display` Appropriately
+
+Understanding when to use each declaration:
+
+```ruby
+class PostDefinition < Plutonium::Resource::Definition
+  # Use `field` when the configuration applies to ALL contexts
+  # (form inputs, show page displays, and table columns)
+  field :content, as: :rich_text  # Changes type everywhere
+
+  # Use `input` for form-specific options
+  input :title, hint: "Shown only in forms", placeholder: "Form placeholder"
+
+  # Use `display` for show-page-specific options
+  display :content,
+    description: "Shown only on show pages",
+    wrapper: {class: "col-span-full"}
+
+  # Use `column` for table-specific options
+  column :title, label: "Custom header", align: :center
+end
+```
+
+### 5. Avoid Redundant Declarations
+
+Remember that **all model attributes are auto-detected**. Only declare overrides:
+
+::: code-group
+```ruby [✅ Good - Only Overrides]
+class PostDefinition < Plutonium::Resource::Definition
+  # Only override what needs customization
+  field :content, as: :rich_text
+  input :title, hint: "Enter a descriptive title"
+  display :metadata, wrapper: {class: "col-span-full"}
+end
+```
+
+```ruby [❌ Bad - Redundant]
+class PostDefinition < Plutonium::Resource::Definition
+  # Unnecessary - these are auto-detected correctly
+  field :title, as: :string
+  field :content, as: :text
+  field :published_at, as: :datetime
+  field :author, as: :association
+
+  # Only these override defaults
+  field :content, as: :rich_text  # This actually works, overrides the earlier :text
+  input :title, hint: "Enter a descriptive title"
+end
+```
+:::
+
+### 6. Complex Customizations at the End
+
+Place complex blocks and custom components at the end of their sections:
+
+```ruby
+class PostDefinition < Plutonium::Resource::Definition
+  # Simple overrides first
+  input :title, hint: "Enter title"
+  input :category, as: :select, choices: %w[Tech Business]
+
+  # Complex blocks last
+  input :related_posts do |f|
+    choices = if object.persisted?
+      Post.where.not(id: object.id).published.pluck(:title, :id)
+    else
+      []
+    end
+    f.select_tag choices: choices
+  end
+
+  display :status do |f|
+    StatusBadgeComponent.new(
+      status: f.value,
+      class: "inline-flex items-center"
+    )
+  end
+end
+```
+
+### 7. Example: Well-Structured Definition
+
+Here's a complete example following all best practices:
+
+```ruby
+class PostDefinition < Plutonium::Resource::Definition
+  # ========================================
+  # Field Type Overrides
+  # ========================================
+
+  field :content, as: :rich_text
+  field :author_id, as: :hidden
+
+  # ========================================
+  # Form Inputs
+  # ========================================
+
+  # Basic fields with simple options
+  input :title,
+    label: "Post Title",
+    hint: "Enter a descriptive title",
+    placeholder: "e.g. Getting Started"
+
+  input :slug,
+    hint: "Leave blank to auto-generate",
+    class: "font-mono"
+
+  # Select inputs
+  input :category, as: :select, choices: %w[Tech Business Lifestyle]
+  input :author, as: :association
+
+  # Conditional inputs
+  input :published_at,
+    condition: -> { object.published? },
+    hint: "When this post was published"
+
+  # ========================================
+  # Display Fields
+  # ========================================
+
+  display :content, as: :markdown
+  display :view_count, label: "Total Views", class: "font-bold text-lg"
+  display :metadata, wrapper: {class: "col-span-full"}
+
+  # ========================================
+  # Table Columns
+  # ========================================
+
+  column :title, label: "Article Title"
+  column :category, align: :center
+  column :view_count, align: :end, label: "Views"
+  column :published_at, align: :end
+
+  # ========================================
+  # Search & Filtering
+  # ========================================
+
+  search do |scope, query|
+    scope.where("title ILIKE ? OR content ILIKE ?", "%#{query}%", "%#{query}%")
+  end
+
+  filter :status, as: :select, choices: %w[draft published archived]
+  filter :category, as: :select, choices: %w[Tech Business Lifestyle]
+  filter :published_after, as: :date
+
+  # ========================================
+  # Scopes
+  # ========================================
+
+  scope :published
+  scope :draft
+  scope :scheduled
+
+  # ========================================
+  # Sorting
+  # ========================================
+
+  sort :title
+  sort :published_at
+  sort :view_count
+
+  # ========================================
+  # Actions
+  # ========================================
+
+  action :publish, interaction: Posts::Publish
+  action :schedule, interaction: Posts::Schedule
+  action :archive, interaction: Posts::Archive
+end
+```
+
 ## Related Modules
 
 - **[Resource Record](./resource_record.md)** - Resource controllers and CRUD operations
@@ -836,23 +1156,70 @@ field :name, as: :string, class: "custom-class", wrapper: {class: "field-wrapper
 ```ruby
 input :title,
   as: :string,
-  placeholder: "Enter title",
+  # Field-level options (passed to the field wrapper):
+  label: "Article Title",          # Custom field label
+  hint: "Enter a descriptive title", # Help text shown below input
+  placeholder: "e.g. My First Post", # Input placeholder text
+  # Tag-level options (passed to the input tag):
   required: true,
   class: "custom-input",
-  wrapper: {class: "input-wrapper"},
   data: {controller: "custom"},
-  condition: -> { current_user.admin? }
+  # Wrapper options:
+  wrapper: {class: "input-wrapper"},
+  # Conditional rendering:
+  condition: -> { current_user.admin? },
+  # Pre-submit for dynamic forms:
+  pre_submit: false
 ```
 
+::: tip Field-level vs Tag-level Options
+- **Field-level options** (`label`, `hint`, `placeholder`) are processed by the field wrapper and affect the field's label and help text display
+- **Tag-level options** (like `class`, `data`, `required`) are passed directly to the HTML input element
+- The system automatically routes options to the correct destination
+:::
+
 ### Display Options
 ```ruby
 display :content,
   as: :markdown,
+  # Field-level options (passed to the field wrapper):
+  label: "Article Content",        # Custom field label
+  description: "Published content", # Description text shown below value
+  placeholder: "No content yet",    # Shown when value is empty
+  # Tag-level options (passed to the display tag):
   class: "prose",
+  # Wrapper options:
   wrapper: {class: "content-wrapper"},
+  # Conditional rendering:
   condition: -> { current_user.can_see_content? }
 ```
 
+::: tip Display Uses Description, Forms Use Hint
+- **Display fields** use `:description` for explanatory text below the value
+- **Form fields** use `:hint` for help text below the input
+- Both support `:label` and `:placeholder` options
+:::
+
+### Column Options
+```ruby
+column :title,
+  as: :string,
+  # Column-level options:
+  label: "Article Title",    # Custom column header
+  align: :start,             # Alignment: :start, :center, :end
+  # Tag-level options (passed to the cell renderer):
+  class: "font-bold",
+  # Conditional rendering:
+  condition: -> { current_user.admin? }
+```
+
+::: tip Table Columns
+Table columns support a minimal set of field-level options since they render in a compact table format:
+- `:label` - Column header text
+- `:align` - Column alignment
+- Options like `:description` and `:placeholder` are filtered out as they don't make sense in table cells
+:::
+
 ### Choices Options (for selects)
 ```ruby
 # Static choices

data/lib/plutonium/ui/display/resource.rb

@@ -89,7 +89,14 @@ module Plutonium
             return if conditionally_hidden
 
             tag = display_options[:as] || field_options[:as]
-            tag_attributes = display_options.except(:wrapper, :as, :condition)
+
+            # Extract field-level options from display_options and merge into field_options
+            # These are Phlexi field options that should be passed to field(), not to the tag builder
+            field_level_keys = [:label, :description, :placeholder]
+            field_level_options = display_options.slice(*field_level_keys)
+            field_options = field_options.merge(field_level_options)
+
+            tag_attributes = display_options.except(:wrapper, :as, :condition, *field_level_keys)
             tag_block = display_definition[:block] || ->(f) {
               tag ||= f.inferred_field_component
               if tag.is_a?(Class)

data/lib/plutonium/ui/form/resource.rb

@@ -88,7 +88,15 @@ module Plutonium
           input_options = input_definition[:options] || {}
 
           tag = input_options[:as] || field_options[:as]
-          tag_attributes = input_options.except(:wrapper, :as, :pre_submit, :condition)
+
+          # Extract field-level options from input_options and merge into field_options
+          # These are Phlexi field options that should be passed to form.field(), not to the tag builder
+          # Note: forms use :hint, displays use :description
+          field_level_keys = [:hint, :label, :placeholder]
+          field_level_options = input_options.slice(*field_level_keys)
+          field_options = field_options.merge(field_level_options)
+
+          tag_attributes = input_options.except(:wrapper, :as, :pre_submit, :condition, *field_level_keys)
           if input_options[:pre_submit]
             tag_attributes["data-action"] = "change->form#preSubmit"
           end

data/lib/plutonium/ui/table/resource.rb

@@ -65,8 +65,12 @@ module Plutonium
               next if conditionally_hidden
 
               tag = column_options[:as] || display_definition[:as] || field_options[:as]
-              display_tag_attributes = display_options.except(:wrapper, :as, :condition)
-              column_tag_attributes = column_options.except(:wrapper, :as, :align, :condition)
+
+              # Extract field-level options from display_options and column_options
+              # These are Phlexi field options that should NOT be passed to the tag builder
+              field_level_keys = [:label, :description, :placeholder]
+              display_tag_attributes = display_options.except(:wrapper, :as, :condition, *field_level_keys)
+              column_tag_attributes = column_options.except(:wrapper, :as, :align, :condition, *field_level_keys)
               tag_attributes = display_tag_attributes.merge(column_tag_attributes)
               tag_block = column_definition[:block] || ->(wrapped_object, key) {
                 f = wrapped_object.field(key)
@@ -74,7 +78,9 @@ module Plutonium
                 f.send(:"#{tag}_tag", **tag_attributes)
               }
 
-              field_options = field_options.except(:condition).merge(**column_options.slice(:align))
+              # For table columns, only extract column-level options (label and align)
+              # Field-level options like description and placeholder don't make sense in table cells
+              field_options = field_options.except(:condition).merge(**column_options.slice(:align, :label))
               table.column name,
                 **field_options,
                 sort_params: current_query_object.sort_params_for(name),

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.26.11"
+  VERSION = "0.27.0"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/lib/tasks/release.rake

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+namespace :release do
+  desc "Display next version based on conventional commits"
+  task :next_version do
+    current_version = Plutonium::VERSION
+    puts "Current version: #{current_version}"
+
+    # Check for breaking changes, features, or fixes since last tag
+    breaking = `git log v#{current_version}..HEAD --oneline | grep -i "BREAKING CHANGE"`.strip
+    features = `git log v#{current_version}..HEAD --oneline | grep "^[a-f0-9]* feat"`.strip
+    fixes = `git log v#{current_version}..HEAD --oneline | grep "^[a-f0-9]* fix"`.strip
+
+    major, minor, patch = current_version.split(".").map(&:to_i)
+
+    if !breaking.empty?
+      next_version = "#{major + 1}.0.0"
+      puts "Next version (breaking changes): #{next_version}"
+    elsif !features.empty?
+      next_version = "#{major}.#{minor + 1}.0"
+      puts "Next version (new features): #{next_version}"
+    elsif !fixes.empty?
+      next_version = "#{major}.#{minor}.#{patch + 1}"
+      puts "Next version (bug fixes): #{next_version}"
+    else
+      puts "No changes detected"
+    end
+  end
+
+  desc "Prepare a new release"
+  task :prepare, [:version] do |_t, args|
+    version = args[:version]
+
+    unless version
+      puts "Usage: rake release:prepare[VERSION]"
+      puts "Example: rake release:prepare[0.27.0]"
+      exit 1
+    end
+
+    # Validate version format
+    unless version.match?(/^\d+\.\d+\.\d+$/)
+      puts "Error: Version must be in format X.Y.Z"
+      exit 1
+    end
+
+    # Update version.rb
+    version_file = "lib/plutonium/version.rb"
+    content = File.read(version_file)
+    updated_content = content.gsub(/VERSION = "[\d.]+"/, %{VERSION = "#{version}"})
+    File.write(version_file, updated_content)
+    puts "✓ Updated #{version_file}"
+
+    # Generate changelog using git-cliff
+    if system("which git-cliff > /dev/null 2>&1")
+      system("git-cliff --tag v#{version} -o CHANGELOG.md")
+      puts "✓ Generated CHANGELOG.md"
+    else
+      puts "⚠ git-cliff not found. Install with: brew install git-cliff"
+      puts "  Skipping changelog generation"
+    end
+
+    puts "\nNext steps:"
+    puts "1. Review the changes:"
+    puts "   git diff"
+    puts "2. Commit the version bump:"
+    puts "   git add -A"
+    puts "   git commit -m 'chore(release): prepare for v#{version}'"
+    puts "3. Create and push the tag:"
+    puts "   git tag v#{version}"
+    puts "   git push origin main --tags"
+    puts "4. Build and release the gem:"
+    puts "   rake release:publish"
+  end
+
+  desc "Publish the gem to RubyGems"
+  task :publish do
+    # Reload version constant in case it was updated
+    load "lib/plutonium/version.rb"
+    version = Plutonium::VERSION
+
+    # Build the gem
+    puts "Building gem..."
+    system("gem build plutonium.gemspec") || abort("Gem build failed")
+
+    # Push to RubyGems
+    puts "Publishing to RubyGems..."
+    gem_file = "plutonium-#{version}.gem"
+    system("gem push #{gem_file}") || abort("Gem push failed")
+
+    puts "✓ Published plutonium #{version} to RubyGems"
+
+    # Clean up
+    File.delete(gem_file) if File.exist?(gem_file)
+  end
+
+  desc "Full release workflow"
+  task :full, [:version] do |_t, args|
+    version = args[:version]
+
+    unless version
+      puts "Usage: rake release:full[VERSION]"
+      exit 1
+    end
+
+    puts "Starting release workflow for v#{version}..."
+
+    # Check for uncommitted changes
+    unless `git status --porcelain`.strip.empty?
+      puts "Error: You have uncommitted changes. Please commit or stash them first."
+      exit 1
+    end
+
+    # Check we're on main branch
+    current_branch = `git branch --show-current`.strip
+    unless current_branch == "main" || current_branch == "master"
+      puts "Warning: You're not on main/master branch (current: #{current_branch})"
+      print "Continue anyway? [y/N] "
+      exit 1 unless $stdin.gets.strip.downcase == "y"
+    end
+
+    # Prepare release
+    Rake::Task["release:prepare"].invoke(version)
+
+    # Confirm before proceeding
+    puts "\nReady to commit, tag, and publish?"
+    print "Continue? [y/N] "
+    exit 0 unless $stdin.gets.strip.downcase == "y"
+
+    # Commit
+    system("git add -A")
+    system("git commit -m 'chore(release): prepare for v#{version}'")
+
+    # Push commit (without tags yet)
+    system("git push origin #{current_branch}")
+
+    # Publish gem (do this BEFORE tagging)
+    puts "\nPublishing gem to RubyGems..."
+    Rake::Task["release:publish"].invoke
+
+    # Only tag and push tag if publish succeeded
+    puts "\nCreating and pushing tag..."
+    system("git tag v#{version}")
+    system("git push origin v#{version}")
+
+    puts "\n✓ Release complete!"
+    puts "GitHub Actions will create the release shortly."
+  end
+end
+
+desc "Release tasks"
+task release: ["release:next_version"]

data/plutonium.gemspec

@@ -0,0 +1,65 @@
+require_relative "lib/plutonium/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "plutonium"
+  spec.version = Plutonium::VERSION
+  spec.authors = ["Stefan Froelich"]
+  spec.email = ["sfroelich01@gmail.com"]
+
+  spec.summary = "The Ultimate Rapid Application Development Toolkit (RADKit) for Rails"
+  spec.description = "Plutonium extends Rails' capabilities with a powerful, generator-driven toolkit designed to supercharge your development process. " \
+                     "It transforms the way you build applications with Rails, optimizing for rapid application development."
+  spec.homepage = "https://radioactive-labs.github.io/plutonium-core/"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.2"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/radioactive-labs/plutonium-core"
+  # spec.metadata["changelog_uri"] = "https://google.com"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "zeitwerk"
+  spec.add_dependency "rails", ">= 7.2"
+  spec.add_dependency "listen", "~> 3.8"
+  spec.add_dependency "pagy", "~> 9.0"
+  spec.add_dependency "rabl", "~> 0.16.1" # TODO: what to do with RABL
+  spec.add_dependency "semantic_range", "~> 3.0"
+  spec.add_dependency "tty-prompt", "~> 0.23.1"
+  spec.add_dependency "action_policy", "~> 0.7.0"
+  spec.add_dependency "phlex", "~> 2.0"
+  spec.add_dependency "phlex-rails"
+  spec.add_dependency "phlex-tabler_icons"
+  spec.add_dependency "phlexi-field", ">= 0.2.0"
+  spec.add_dependency "phlexi-form", ">= 0.10.0"
+  spec.add_dependency "phlexi-table", ">= 0.2.0"
+  spec.add_dependency "phlexi-display", ">= 0.2.0"
+  spec.add_dependency "phlexi-menu", ">= 0.4.0"
+  spec.add_dependency "tailwind_merge"
+  spec.add_dependency "phlex-slotable", ">= 1.0.0"
+  spec.add_dependency "redcarpet"
+
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-reporters"
+  spec.add_development_dependency "standard"
+  spec.add_development_dependency "brakeman"
+  spec.add_development_dependency "bundle-audit"
+  spec.add_development_dependency "appraisal"
+  spec.add_development_dependency "combustion"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.26.11
+  version: 0.27.0
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2025-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -399,6 +399,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - "# Plutonium: The pre-alpha demo.md"
+- ".cliff.toml"
 - ".node-version"
 - ".rspec"
 - ".ruby-version"
@@ -408,6 +409,7 @@ files:
 - ".vscode/settings.json"
 - Appraisals
 - CHANGELOG.md
+- CONTRIBUTING.md
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -887,9 +889,11 @@ files:
 - lib/rodauth/features/case_insensitive_login.rb
 - lib/rodauth/plugins.rb
 - lib/tasks/.keep
+- lib/tasks/release.rake
 - package-lock.json
 - package.json
 - plutonium-blog-post.md
+- plutonium.gemspec
 - postcss-gem-import.js
 - postcss.config.js
 - public/.keep