plutonium 0.23.3 → 0.23.5

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

@@ -59,9 +59,14 @@ module Plutonium
               column_definition = resource_definition.defined_columns[name] || {}
               column_options = column_definition[:options] || {}
 
+              # Check for conditional rendering
+              condition = column_options[:condition] || display_options[:condition] || field_options[:condition]
+              conditionally_hidden = condition && !instance_exec(&condition)
+              next if conditionally_hidden
+
               tag = column_options[:as] || display_definition[:as] || field_options[:as]
-              display_tag_attributes = display_options.except(:wrapper, :as)
-              column_tag_attributes = column_options.except(:wrapper, :as, :align)
+              display_tag_attributes = display_options.except(:wrapper, :as, :condition)
+              column_tag_attributes = column_options.except(:wrapper, :as, :align, :condition)
               tag_attributes = display_tag_attributes.merge(column_tag_attributes)
               tag_block = column_definition[:block] || ->(wrapped_object, key) {
                 f = wrapped_object.field(key)
@@ -69,7 +74,7 @@ module Plutonium
                 f.send(:"#{tag}_tag", **tag_attributes)
               }
 
-              field_options = field_options.merge(**column_options.slice(:align))
+              field_options = field_options.except(:condition).merge(**column_options.slice(:align))
               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.23.3"
+  VERSION = "0.23.5"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/src/css/intl_tel_input.css

@@ -0,0 +1,259 @@
+/**
+ * International Telephone Input - Complete Tailwind v4 Overrides
+ * Overrides to match Plutonium form theme using Tailwind colors
+ * Import this AFTER the original intl_tel_input.css
+ */
+
+/* Override CSS variables with Tailwind colors */
+:root {
+  --iti-hover-color: theme(colors.primary.50);
+  --iti-border-color: theme(colors.gray.300);
+  --iti-dialcode-color: theme(colors.gray.500);
+  --iti-dropdown-bg: theme(colors.white);
+  --iti-arrow-color: theme(colors.gray.700);
+}
+
+/* Dark mode overrides */
+@media (prefers-color-scheme: dark) {
+  :root {
+    --iti-hover-color: theme(colors.primary.900 / 0.3);
+    --iti-border-color: theme(colors.gray.600);
+    --iti-dialcode-color: theme(colors.gray.400);
+    --iti-dropdown-bg: theme(colors.gray.700);
+    --iti-arrow-color: theme(colors.white);
+  }
+}
+
+/* Manual dark mode class support */
+.dark {
+  --iti-hover-color: theme(colors.primary.900 / 0.3);
+  --iti-border-color: theme(colors.gray.600);
+  --iti-dialcode-color: theme(colors.gray.400);
+  --iti-dropdown-bg: theme(colors.gray.700);
+  --iti-arrow-color: theme(colors.white);
+}
+
+/* ITI wrapper to ensure full width */
+.iti {
+  @apply w-full;
+}
+
+/* Main container - match form input styling */
+.iti input.iti__tel-input,
+.iti input.iti__tel-input[type=tel],
+.iti input.iti__tel-input[type=text] {
+  @apply w-full border border-gray-300 rounded-md shadow-sm font-medium text-sm bg-white text-gray-700 outline-none transition-colors duration-200 focus:ring-2 focus:ring-primary-500 focus:border-primary-500 dark:bg-gray-700 dark:border-gray-600 dark:text-white dark:placeholder-gray-400;
+  padding: theme(spacing.2);
+  padding-left: 52px;
+  /* Space for country selector */
+}
+
+/* Country container positioning */
+.iti .iti__country-container {
+  @apply absolute top-0 bottom-0 left-0 z-10;
+  padding: theme(spacing.2);
+  width: 52px;
+  /* Fixed width to match input padding */
+}
+
+/* Selected country button styling */
+.iti .iti__selected-country {
+  @apply bg-transparent border-0 text-gray-700 dark:text-white;
+}
+
+/* Selected country primary container */
+.iti .iti__selected-country-primary {
+  @apply px-2 text-gray-700 dark:text-white;
+}
+
+/* Arrow styling with Tailwind colors */
+.iti .iti__arrow {
+  @apply ml-1;
+  border-top-color: theme(colors.gray.700);
+}
+
+.dark .iti .iti__arrow {
+  border-top-color: theme(colors.white);
+}
+
+.iti .iti__arrow--up {
+  border-bottom-color: theme(colors.gray.700);
+  border-top-color: transparent;
+}
+
+.dark .iti .iti__arrow--up {
+  border-bottom-color: theme(colors.white);
+}
+
+/* Dropdown content styling to match form theme */
+.iti .iti__dropdown-content {
+  @apply border border-gray-300 bg-white shadow-sm rounded-md dark:bg-gray-700 dark:border-gray-600;
+}
+
+/* Search input to match form theme */
+.iti .iti__search-input {
+  @apply w-full p-2 border border-gray-300 rounded-md shadow-sm font-medium text-sm bg-white text-gray-700 outline-none focus:ring-2 focus:ring-primary-500 focus:border-primary-500 dark:bg-gray-700 dark:border-gray-600 dark:text-white dark:placeholder-gray-400;
+  margin: theme(spacing.2);
+  width: calc(100% - theme(spacing.4));
+}
+
+/* Search input border top */
+.iti .iti__search-input+.iti__country-list {
+  @apply border-t border-gray-300 dark:border-gray-600;
+}
+
+/* Country list styling */
+.iti .iti__country-list {
+  @apply max-h-48 overflow-y-auto;
+}
+
+/* Individual country styling */
+.iti .iti__country {
+  @apply px-2 py-2 text-gray-700 hover:bg-primary-500 hover:text-white dark:text-white dark:hover:bg-primary-500;
+}
+
+/* Country name and flag spacing */
+.iti .iti__country-name,
+.iti .iti__country-list .iti__flag {
+  @apply mr-2 dark:mr-2;
+}
+
+/* RTL support */
+[dir="rtl"] .iti .iti__country-name,
+[dir="rtl"] .iti .iti__country-list .iti__flag {
+  @apply mr-0 ml-2;
+}
+
+/* Dial code styling */
+.iti .iti__dial-code {
+  @apply text-gray-500 dark:text-gray-400;
+}
+
+/* Selected dial code */
+.iti .iti__selected-dial-code {
+  @apply ml-1 text-gray-500 dark:text-gray-400;
+}
+
+[dir="rtl"] .iti .iti__selected-dial-code {
+  @apply ml-0 mr-1;
+}
+
+/* Prevent any styling when aria-activedescendant is set (dropdown navigation) */
+.iti .iti__selected-country[aria-activedescendant],
+.iti .iti__selected-country-primary[aria-activedescendant] {
+  background-color: transparent !important;
+}
+
+/* Prevent hover styling when dropdown content is being hovered */
+.iti .iti__selected-country:has(+ .iti__dropdown-content:hover),
+.iti .iti__selected-country-primary:has(~ .iti__dropdown-content:hover) {
+  background-color: transparent !important;
+}
+
+/* Remove all hover states from country container completely */
+.iti--allow-dropdown .iti__country-container:hover,
+.iti--allow-dropdown .iti__country-container:hover .iti__selected-country,
+.iti--allow-dropdown .iti__country-container:hover .iti__selected-country-primary {
+  background-color: transparent !important;
+}
+
+/* Ensure flags never get background colors on hover or when aria-activedescendant is set */
+.iti .iti__flag,
+.iti .iti__selected-country[aria-activedescendant] .iti__flag,
+.iti .iti__selected-country-primary[aria-activedescendant] .iti__flag,
+.iti .iti__country-container:hover .iti__flag {
+  background-color: transparent !important;
+}
+
+/* Globe icon maintains its specific background */
+.iti .iti__flag.iti__globe {
+  @apply bg-gray-100 dark:bg-gray-600;
+  background-color: theme(colors.gray.100) !important;
+}
+
+.dark .iti .iti__flag.iti__globe {
+  background-color: theme(colors.gray.600) !important;
+}
+
+/* Country highlight state */
+.iti .iti__country.iti__highlight {
+  @apply bg-primary-500 text-white;
+}
+
+/* Fullscreen popup styling for mobile */
+.iti--fullscreen-popup.iti--container {
+  @apply bg-black/50;
+}
+
+.iti--fullscreen-popup .iti__dropdown-content {
+  @apply bg-white dark:bg-gray-700;
+}
+
+.iti--fullscreen-popup .iti__country {
+  @apply py-3 text-base;
+}
+
+/* Globe icon visibility fix for dark mode */
+.iti .iti__flag.iti__globe {
+  @apply bg-gray-100 dark:bg-gray-600;
+  background-blend-mode: multiply;
+}
+
+.dark .iti .iti__flag.iti__globe {
+  filter: invert(1) brightness(0.8);
+}
+
+/* Validation state overrides */
+.iti.iti-invalid input.iti__tel-input,
+.iti.iti-invalid input.iti__tel-input[type=tel],
+.iti.iti-invalid input.iti__tel-input[type=text] {
+  @apply bg-red-50 border-red-500 text-red-900 focus:ring-red-500 focus:border-red-500 dark:border-red-500 dark:text-red-500;
+}
+
+.iti.iti-valid input.iti__tel-input,
+.iti.iti-valid input.iti__tel-input[type=tel],
+.iti.iti-valid input.iti__tel-input[type=text] {
+  @apply bg-green-50 border-green-500 text-green-900 focus:ring-green-500 focus:border-green-500 dark:border-green-500 dark:text-green-400;
+}
+
+/* Validation state arrow colors */
+.iti.iti-invalid .iti__arrow {
+  border-top-color: theme(colors.red.500);
+}
+
+.iti.iti-invalid .iti__arrow--up {
+  border-bottom-color: theme(colors.red.500);
+  border-top-color: transparent;
+}
+
+.iti.iti-valid .iti__arrow {
+  border-top-color: theme(colors.green.500);
+}
+
+.iti.iti-valid .iti__arrow--up {
+  border-bottom-color: theme(colors.green.500);
+  border-top-color: transparent;
+}
+
+/* Disabled state */
+.iti input.iti__tel-input:disabled,
+.iti input.iti__tel-input[type=tel]:disabled,
+.iti input.iti__tel-input[type=text]:disabled {
+  @apply cursor-not-allowed bg-gray-100 text-gray-500 dark:bg-gray-900 dark:text-gray-400;
+}
+
+.iti input.iti__tel-input:disabled+.iti__country-container {
+  @apply cursor-not-allowed;
+}
+
+.iti input.iti__tel-input:disabled+.iti__country-container .iti__selected-country {
+  @apply text-gray-500 dark:text-gray-400;
+}
+
+.iti input.iti__tel-input:disabled+.iti__country-container .iti__arrow {
+  border-top-color: theme(colors.gray.400);
+}
+
+.dark .iti input.iti__tel-input:disabled+.iti__country-container .iti__arrow {
+  border-top-color: theme(colors.gray.600);
+}

data/src/css/plutonium.css

@@ -1,3 +1,4 @@
 @import "core.css";
 @import "easymde.css";
 @import "slim_select.css";
+@import "intl_tel_input.css";

data/src/css/slim_select.css

@@ -1,6 +1,7 @@
 /**
- * Slim Select with Tailwind CSS - Matched to Form Theme
- * Updated to match the Plutonium form input styling
+ * Slim Select with Tailwind CSS
+ * Overrides for theming with Tailwind colors and dark mode support
+ * Import this AFTER the original slim_select.css
  */
 
 /* Animation keyframes */

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.23.3
+  version: 0.23.5
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-27 00:00:00.000000000 Z
+date: 2025-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -493,21 +493,48 @@ files:
 - docs/.vitepress/theme/custom.css
 - docs/.vitepress/theme/index.ts
 - docs/api-examples.md
-- docs/guide/getting-started/authorization.md
-- docs/guide/getting-started/core-concepts.md
-- docs/guide/getting-started/index.md
-- docs/guide/getting-started/installation.md
-- docs/guide/getting-started/resources.md
-- docs/guide/tutorial.md
-- docs/guide/what-is-plutonium.md
+- docs/guide/cursor-rules.md
+- docs/guide/deep-dive/authorization.md
+- docs/guide/deep-dive/resources.md
+- docs/guide/getting-started/01-installation.md
+- docs/guide/index.md
+- docs/guide/introduction/01-what-is-plutonium.md
+- docs/guide/introduction/02-core-concepts.md
+- docs/guide/tutorial/01-project-setup.md
+- docs/guide/tutorial/02-creating-a-feature-package.md
+- docs/guide/tutorial/03-defining-resources.md
+- docs/guide/tutorial/04-creating-a-portal.md
+- docs/guide/tutorial/05-customizing-the-ui.md
+- docs/guide/tutorial/06-adding-custom-actions.md
+- docs/guide/tutorial/07-implementing-authorization.md
 - docs/index.md
 - docs/markdown-examples.md
+- docs/modules/action.md
+- docs/modules/authentication.md
+- docs/modules/configuration.md
+- docs/modules/controller.md
+- docs/modules/core.md
+- docs/modules/definition.md
+- docs/modules/display.md
+- docs/modules/form.md
+- docs/modules/generator.md
+- docs/modules/index.md
+- docs/modules/interaction.md
+- docs/modules/package.md
+- docs/modules/policy.md
+- docs/modules/portal.md
+- docs/modules/query.md
+- docs/modules/resource_record.md
+- docs/modules/routing.md
+- docs/modules/table.md
+- docs/modules/ui.md
 - docs/public/android-chrome-192x192.png
 - docs/public/android-chrome-512x512.png
 - docs/public/apple-touch-icon.png
 - docs/public/favicon-16x16.png
 - docs/public/favicon-32x32.png
 - docs/public/favicon.ico
+- docs/public/plutonium.mdc
 - docs/public/plutonium.png
 - docs/public/site.webmanifest
 - docs/public/templates/base.rb
@@ -866,6 +893,7 @@ files:
 - src/.npmignore
 - src/css/core.css
 - src/css/easymde.css
+- src/css/intl_tel_input.css
 - src/css/plutonium.css
 - src/css/plutonium.entry.css
 - src/css/slim_select.css

data/docs/guide/getting-started/authorization.md

@@ -1,296 +0,0 @@
-# Authorization and Access Control
-
-Plutonium provides a robust authorization system built on top of [Action Policy](https://actionpolicy.evilmartians.io/), offering fine-grained access control, resource scoping, and entity-based authorization.
-
-## Overview
-
-Authorization in Plutonium operates at multiple levels:
-- Resource-level policies
-- Action-based permissions
-- Entity-based scoping
-- Attribute-level access control
-
-## Basic Policy Definition
-
-Every resource in Plutonium requires a policy. Here's a basic example:
-
-```ruby
-class BlogPolicy < ResourcePolicy
-  # Core CRUD Permissions
-
-  def create?
-    # All authenticated users can create blogs
-    true
-  end
-
-  def read?
-    # Allow anyone to read blogs
-    true
-  end
-
-  def update?
-    # Allow only the blog owner to update
-    owner?
-  end
-
-  def destroy?
-    # Allow only the blog owner or admins to destroy
-    owner? || user.admin?
-  end
-
-  # Attribute Control
-
-  def permitted_attributes_for_create
-    [:title, :content, :category]
-  end
-
-  def permitted_attributes_for_read
-    [:title, :content, :category, :created_at, :updated_at, :user_id]
-  end
-
-  def permitted_attributes_for_update
-    [:title, :content, :category]
-  end
-
-  # Association Access
-
-  def permitted_associations
-    [:comments]
-  end
-
-  private
-
-  def owner?
-    record.user_id == user.id
-  end
-end
-```
-
-## Default Behaviors in Plutonium Policies
-
-::: info Overview
-Plutonium's Policy system implements a secure-by-default pattern with clear inheritance chains for both permissions and attribute access.
-:::
-
-### Permission Defaults
-
-Permission methods follow two key patterns: core permissions that default to `false`, and derived permissions that inherit from core ones.
-
-#### Core Permission Chain
-
-```mermaid
-graph TD
-    subgraph Core Permissions
-        A[create? ❌] --> B[update? ❌]
-        A --> C[destroy? ❌]
-        D[read? ❌] --> E[index? ❌]
-        D --> F[show? ❌]
-    end
-```
-
-::: warning Security First
-All core permissions (`create?` and `read?`) default to `false`. You must explicitly override these to grant access.
-```ruby
-# Default implementations
-def create?
-  false
-end
-
-def read?
-  false
-end
-```
-:::
-
-#### Permission Inheritance
-
-::: code-group
-```ruby [Action Methods]
-def update?
-  create?    # Inherits from create?
-end
-
-def destroy?
-  create?    # Inherits from create?
-end
-
-def index?
-  read?      # Inherits from read?
-end
-
-def show?
-  read?      # Inherits from read?
-end
-```
-
-```ruby [Helper Methods]
-def new?
-  create?    # Matches create?
-end
-
-def edit?
-  update?    # Matches update?
-end
-
-def search?
-  index?     # Matches index?
-end
-```
-:::
-
-### Attribute Permission Defaults
-
-Attribute permissions also follow an inheritance pattern, but with auto-detection in development:
-
-::: details Inheritance Chain
-```mermaid
-graph TD
-    subgraph Core Attributes
-        A[permitted_attributes_for_create] --> B[permitted_attributes_for_update]
-        C[permitted_attributes_for_read] --> D[permitted_attributes_for_show]
-        C --> E[permitted_attributes_for_index]
-    end
-```
-:::
-
-#### Core Implementation Details
-
-::: code-group
-```ruby [Create Attributes]
-def permitted_attributes_for_create
-  # Auto-detects fields but excludes system columns
-  autodetect_permitted_fields(:permitted_attributes_for_create) - [
-    resource_class.primary_key.to_sym,
-    :created_at,
-    :updated_at
-  ]
-end
-```
-
-```ruby [Read Attributes]
-def permitted_attributes_for_read
-  # Auto-detects all fields
-  autodetect_permitted_fields(:permitted_attributes_for_read)
-end
-```
-
-```ruby [Update Attributes]
-def permitted_attributes_for_update
-  # Inherits from create
-  permitted_attributes_for_create
-end
-```
-:::
-
-::: danger Auto-detection Warning
-The default attribute detection:
-- Only works in development
-- Raises errors in other environments
-- Shows warning messages
-- Must be overridden in production
-:::
-
-### Association Defaults
-
-By default, no associations are permitted:
-
-```ruby
-def permitted_associations
-  []  # Must be explicitly defined
-end
-```
-
-### Context Object Defaults
-
-Two built-in authorization contexts:
-
-::: code-group
-```ruby [Required Context]
-# User must be present
-authorize :user, allow_nil: false
-```
-
-```ruby [Optional Context]
-# Entity scope is optional
-authorize :entity_scope, allow_nil: true
-```
-:::
-
-#### Default Scoping Behavior
-
-When an entity scope exists, records are automatically filtered:
-
-```ruby
-relation_scope do |relation|
-  next relation unless entity_scope
-  relation.associated_with(entity_scope)
-end
-```
-
-#### Adding Custom Contexts
-
-You can add additional authorization contexts:
-
-::: code-group
-```ruby [Policy]
-class BlogPolicy < ResourcePolicy
-  authorize :ability, allow_nil: true
-
-  def promote?
-    user.admin? && ability&.can?(:promote, record)
-  end
-end
-```
-
-```ruby [Controller]
-class BlogsController < ResourceController
-  authorize :ability, through: :current_ability
-
-  private
-
-  def current_ability
-    @current_ability ||= Ability.new(current_user)
-  end
-end
-```
-:::
-
-## Quick Reference
-
-| Method Type | Default | Inherits From |
-|------------|---------|---------------|
-| create? | false | - |
-| read? | false | - |
-| update? | false | create? |
-| destroy? | false | create? |
-| index? | false | read? |
-| show? | false | read? |
-| attributes_for_create | auto* | - |
-| attributes_for_read | auto* | - |
-| attributes_for_update | auto* | create |
-| associations | [] | - |
-
-::: warning
-\*Auto-detection only works in development
-:::
-
-## Security Best Practices
-
-### 1. Never Skip Authorization
-
-Plutonium controllers automatically verify authorization:
-
-```ruby
-class BlogsController < ResourceController
-  def show
-    # This will raise an error if you forget to authorize
-    # authorize! resource_record
-    render :show
-  end
-end
-```
-
-## Related Resources
-
-- [Action Policy Documentation](https://actionpolicy.evilmartians.io/)
-- [Rails Security Guide](https://guides.rubyonrails.org/security.html)