lcp 0.1.0

data/examples/showcase/config/lcp_ruby/presenters/platform_profiles.rb

@@ -0,0 +1,90 @@
+define_presenter :platform_profiles do
+  model :platform_profile
+  label "Platform Profiles"
+  slug "platform-profiles"
+  icon "user-circle"
+
+  index do
+    description "Showcase of `lcp_managed: true` per-item additive behavior on " \
+                "a `bind_to:` model. The host class `PlatformProfile` ships with " \
+                "a minimal 2-column table (`name`, `bio`); LCP additively adds " \
+                "`favorite_color` (regular field), `category_id` + `belongs_to " \
+                ":category` (managed FK + AR macro), polymorphic `belongs_to " \
+                ":notable`, managed enum `priority`, NOT-NULL `view_count`, " \
+                "managed `has_many :profile_tags`, and managed `has_one " \
+                ":profile_setting`."
+    per_page 25
+    row_click :show
+
+    column :name, link_to: :show, sortable: true
+    column :favorite_color, sortable: true
+    column :priority, sortable: true
+    column :view_count, sortable: true
+    column :category_id, label: "Category"
+    column :notable_type, label: "Notable kind"
+    column :updated_at, renderer: :relative_date, sortable: true
+  end
+
+  show do
+    description "All managed scenarios of `lcp_managed: true` rendered inline. " \
+                "Open the DSL at `config/lcp_ruby/models/platform_profile.rb` " \
+                "to see the per-item flag in source."
+
+    section "Host-owned (metadata-only)", columns: 2 do
+      field :name, renderer: :heading
+      field :bio
+      field :display_name, label: "Display Name (host method)"
+    end
+
+    section "LCP-managed: regular column", columns: 2 do
+      field :favorite_color, label: "Favorite Color (added at boot)"
+    end
+
+    section "LCP-managed: belongs_to + auto FK column", columns: 2 do
+      field :category_id, label: "category_id (auto-added FK)"
+    end
+
+    section "LCP-managed: polymorphic belongs_to", columns: 2 do
+      field :notable_type
+      field :notable_id
+    end
+
+    section "LCP-managed: enum field (column only, no AR enum macro)", columns: 2 do
+      field :priority, label: "Priority (managed enum)"
+    end
+
+    section "LCP-managed: NOT NULL + default", columns: 2 do
+      field :view_count, label: "View count (NOT NULL, default 0)"
+    end
+
+    # has_many / has_one managed associations are AR macros declared on the
+    # host class but have NO column on the bound side — they cannot be
+    # rendered as `field :name` in show (validator requires a field row).
+    # Verified live: `record.profile_tags` returns the related rows and
+    # `record.profile_setting` returns the linked setting (see Rails
+    # console / spec/integration/bind_to_managed_spec.rb Scenario 4 & 5).
+    # A future custom `association_table` show renderer would surface them
+    # in the page — out of scope here.
+  end
+
+  form do
+    section "Host-owned" do
+      field :name
+      field :bio, input_type: :textarea
+    end
+
+    section "LCP-managed" do
+      field :favorite_color
+      # `association:` kwarg auto-resolved by layout_builder's find_association_for_fk
+      # (FK col `category_id` → AR macro `:category`); explicit kwarg currently
+      # ships as String through DSL and breaks render_association_select.
+      field :category_id, input_type: :association_select
+      # Polymorphic FK pair — both columns auto-added, declared as plain
+      # fields here; for a real polymorphic UI you'd build a custom widget.
+      field :notable_type
+      field :notable_id, label: "Notable ID"
+      field :priority
+      field :view_count
+    end
+  end
+end

data/examples/showcase/config/lcp_ruby/presenters/projects.rb

@@ -0,0 +1,58 @@
+define_presenter :projects do
+  model :project
+  label "Projects"
+  slug "projects"
+  icon "briefcase"
+
+  index do
+    description "Demonstrates cascading selects: department -> lead (employee in that department)."
+    default_sort :name, :asc
+    per_page 25
+
+    column :name, link_to: :show, sortable: true
+    column :status, renderer: :badge, options: {
+      color_map: { active: "green", completed: "blue", archived: "gray" }
+    }, sortable: true
+    column "department.name", label: "Department"
+    column "lead.name", label: "Lead"
+
+    includes :department, :lead
+  end
+
+  show do
+    section "Project Details", columns: 2 do
+      field :name, renderer: :heading
+      field :status, renderer: :badge, options: {
+        color_map: { active: "green", completed: "blue", archived: "gray" }
+      }
+      field "department.name", label: "Department"
+      field "lead.name", label: "Project Lead"
+    end
+
+    includes :department, :lead
+  end
+
+  form do
+    description "Cascading selects: select a department first, then choose a lead from that department."
+
+    section "Project Information", columns: 2 do
+      info "Select a department first. The lead dropdown will update to show only employees from the selected department."
+      field :name, placeholder: "Project name...", autofocus: true
+      field :status, input_type: :select
+      field :department_id, input_type: :association_select,
+        input_options: { sort: { name: :asc }, label_method: :name }
+      field :lead_id, input_type: :association_select,
+        input_options: {
+          search: true,
+          sort: { name: :asc },
+          label_method: :name,
+          depends_on: { field: :department_id, foreign_key: :department_id }
+        }
+    end
+  end
+
+  action :create, type: :built_in, on: :collection, label: "New Project"
+  action :show, type: :built_in, on: :single
+  action :edit, type: :built_in, on: :single
+  action :destroy, type: :built_in, on: :single, confirm: true, style: :danger
+end

data/examples/showcase/config/lcp_ruby/presenters/quick_note_dialog.rb

@@ -0,0 +1,14 @@
+define_presenter :quick_note_dialog do
+  model :showcase_quick_note
+
+  dialog size: :small, title_key: "lcp_ruby.dialogs.quick_note_title"
+
+  form do
+    section "Note" do
+      field :title, autofocus: true, placeholder: "Note title..."
+      field :body, input_type: :textarea, input_options: { rows: 2 },
+        placeholder: "Write a quick note..."
+      field :priority, input_type: :select
+    end
+  end
+end

data/examples/showcase/config/lcp_ruby/presenters/roles.rb

@@ -0,0 +1,60 @@
+define_presenter :roles do
+  model :role
+  label "Roles"
+  slug "roles"
+  icon "shield-check"
+
+  index do
+    description "DB-backed role management. Roles defined here are validated during authorization — unknown role names on users are filtered out and logged."
+    default_sort :position, :asc
+    per_page 25
+    row_click :show
+
+    column :name, link_to: :show, sortable: true, renderer: :code
+    column :label, sortable: true, renderer: :heading
+    column :description, renderer: :truncate, options: { max: 60 }
+    column :active, renderer: :boolean_icon, sortable: true
+    column :position, sortable: true, renderer: :number
+  end
+
+  show do
+    description "Role details. The name must match role keys used in permissions YAML files."
+
+    section "Role Details", columns: 2 do
+      field :name, renderer: :code
+      field :label, renderer: :heading
+      field :active, renderer: :boolean_icon
+      field :position, renderer: :number
+    end
+
+    section "Description" do
+      field :description
+    end
+  end
+
+  form do
+    description "Role names are lowercase identifiers used in permissions YAML (e.g., admin, manager, viewer)."
+
+    section "Role Details", columns: 2 do
+      field :name, placeholder: "e.g. admin, manager, viewer", autofocus: true,
+        hint: "Lowercase identifier matching keys in permissions YAML"
+      field :label, placeholder: "e.g. Administrator, Manager"
+      field :description, input_type: :textarea, col_span: 2
+      field :active, input_type: :toggle
+      field :position, input_type: :number
+    end
+  end
+
+  search do
+    searchable_fields :name, :label
+    placeholder "Search roles..."
+    filter :all, label: "All", default: true
+    filter :active, label: "Active", scope: :active_roles
+    filter :inactive, label: "Inactive", scope: :inactive_roles
+  end
+
+  action :create, type: :built_in, on: :collection, label: "New Role", icon: "plus"
+  action :show, type: :built_in, on: :single
+  action :edit, type: :built_in, on: :single
+  action :destroy, type: :built_in, on: :single, confirm: true, style: :danger
+end

data/examples/showcase/config/lcp_ruby/presenters/save_filter_dialog.rb

@@ -0,0 +1,17 @@
+define_presenter :save_filter_dialog do
+  model :saved_filter
+
+  dialog size: :small, title_key: "lcp_ruby.saved_filters.dialog_title"
+
+  form do
+    section "Filter" do
+      field :name, autofocus: true
+      field :description, input_type: :textarea, input_options: { rows: 2 }
+      field :visibility, input_type: :select
+      field :target_role, visible_when: { field: :visibility, operator: :eq, value: "role" }
+      field :target_group, visible_when: { field: :visibility, operator: :eq, value: "group" }
+      field :pinned, input_type: :toggle
+      field :default_filter, input_type: :toggle
+    end
+  end
+end

data/examples/showcase/config/lcp_ruby/presenters/saved_filters.rb

@@ -0,0 +1,94 @@
+define_presenter :saved_filters do
+  model :saved_filter
+  label "Saved Filters"
+  slug "saved-filters"
+  icon "bookmark"
+
+  index do
+    description "Management view for saved filter records. Browse, edit, and delete user-created filters across all presenters."
+    default_sort :created_at, :desc
+    per_page 25
+    row_click :show
+
+    column :name, link_to: :show, sortable: true
+    column :target_presenter, sortable: true
+    column :visibility, renderer: :badge, options: {
+      color_map: { personal: "blue", role: "orange", group: "purple", global: "green" }
+    }, sortable: true
+    column :pinned, renderer: :boolean
+    column :default_filter, renderer: :boolean
+    column :owner_id, sortable: true
+    column :created_at, renderer: :relative_date, sortable: true
+  end
+
+  show do
+    section "Filter Details", columns: 2 do
+      field :name, renderer: :heading
+      field :description, renderer: :text
+      field :target_presenter
+      field :visibility, renderer: :badge, options: {
+        color_map: { personal: "blue", role: "orange", group: "purple", global: "green" }
+      }
+    end
+
+    section "Targeting", columns: 2 do
+      field :owner_id
+      field :target_role
+      field :target_group
+    end
+
+    section "Display", columns: 2 do
+      field :pinned, renderer: :boolean
+      field :default_filter, renderer: :boolean
+      field :position
+      field :icon
+      field :color
+    end
+
+    section "Query" do
+      field :ql_text, renderer: :code
+    end
+
+    section "Metadata", columns: 2 do
+      field :created_at, renderer: :relative_date
+      field :updated_at, renderer: :relative_date
+    end
+  end
+
+  form do
+    section "Filter Details", columns: 2 do
+      field :name, placeholder: "Filter name...", autofocus: true
+      field :description, input_type: :textarea, input_options: { rows: 2 }
+      field :target_presenter, placeholder: "e.g. showcase-search"
+      field :visibility, input_type: :select
+    end
+
+    section "Targeting", columns: 2 do
+      field :target_role, placeholder: "e.g. admin"
+      field :target_group, placeholder: "e.g. engineering"
+    end
+
+    section "Display", columns: 2 do
+      field :pinned, input_type: :toggle
+      field :default_filter, input_type: :toggle
+      field :position, input_type: :number
+      field :icon, placeholder: "e.g. star"
+      field :color, placeholder: "e.g. blue"
+    end
+  end
+
+  search do
+    searchable_fields :name, :description, :target_presenter
+    placeholder "Search saved filters..."
+    filter :all, label: "All", default: true
+    filter :personal, label: "Personal", scope: :personal_only
+    filter :global, label: "Global", scope: :global_only
+    filter :role, label: "Role", scope: :role_only
+    filter :pinned, label: "Pinned", scope: :pinned_only
+  end
+
+  action :create, type: :built_in, on: :collection, label: "New Filter", icon: "plus"
+  action :show, type: :built_in, on: :single
+  action :edit, type: :built_in, on: :single
+  action :destroy, type: :built_in, on: :single, confirm: true, style: :danger
+end

data/examples/showcase/config/lcp_ruby/presenters/showcase_aggregate_items.rb

@@ -0,0 +1,61 @@
+define_presenter :showcase_aggregate_items do
+  model :showcase_aggregate_item
+  label "Aggregate Tasks"
+  slug "showcase-aggregate-items"
+  icon "check-square"
+
+  index do
+    default_sort :created_at, :desc
+    per_page 25
+    row_click :show
+
+    column :title, link_to: :show, sortable: true
+    column :status, renderer: :badge, options: {
+      color_map: { todo: "gray", in_progress: "blue", done: "green", cancelled: "red" }
+    }, sortable: true
+    column :hours, sortable: true
+    column :cost, renderer: :currency, sortable: true
+    column :priority_score, sortable: true
+    column :assignee, sortable: true
+    column :due_date, renderer: :date, sortable: true
+    column :showcase_aggregate_id, sortable: true
+  end
+
+  show do
+    section "Task Details", columns: 2 do
+      field :title, renderer: :heading
+      field :status, renderer: :badge, options: {
+        color_map: { todo: "gray", in_progress: "blue", done: "green", cancelled: "red" }
+      }
+      field :hours
+      field :cost, renderer: :currency
+      field :priority_score
+      field :assignee
+      field :due_date, renderer: :date
+      field :showcase_aggregate_id
+    end
+  end
+
+  form do
+    section "Task", columns: 2 do
+      field :title, placeholder: "Task title...", autofocus: true, col_span: 2
+      field :status, input_type: :select
+      field :hours
+      field :cost
+      field :priority_score
+      field :assignee, placeholder: "Assignee name..."
+      field :due_date, input_type: :date
+      field :showcase_aggregate_id, input_type: :association_select
+    end
+  end
+
+  search do
+    searchable_fields :title, :assignee
+    placeholder "Search tasks..."
+  end
+
+  action :create, type: :built_in, on: :collection, label: "New Task", icon: "plus"
+  action :show, type: :built_in, on: :single
+  action :edit, type: :built_in, on: :single
+  action :destroy, type: :built_in, on: :single, confirm: true, style: :danger
+end

data/examples/showcase/config/lcp_ruby/presenters/showcase_aggregates.rb

@@ -0,0 +1,115 @@
+define_presenter :showcase_aggregates do
+  model :showcase_aggregate
+  label "Virtual Columns"
+  slug "showcase-aggregates"
+  default true
+  icon "calculator"
+
+  index do
+    description "Demonstrates the full virtual columns system — declarative aggregates (COUNT, SUM, AVG, MIN, MAX), " \
+                "expression columns, JOIN-based columns, window functions, service columns, auto_include, " \
+                "and item_classes with virtual column conditions. All columns are sortable."
+    default_sort :name, :asc
+    per_page 25
+    row_click :show
+
+    column :name, width: "15%", link_to: :show, sortable: true, pinned: :left
+    column :status, width: "8%", renderer: :badge, options: {
+      color_map: { planning: "gray", active: "green", completed: "blue", archived: "orange" }
+    }, sortable: true
+    column :company_name, width: "10%", sortable: true
+    column :tasks_count, width: "6%", sortable: true
+    column :completed_count, width: "6%", sortable: true
+    column :health_score, width: "6%", renderer: :number, sortable: true
+    column :has_overdue_tasks, width: "7%", renderer: :boolean_icon, sortable: true
+    column :is_over_budget, width: "7%", renderer: :boolean_icon, sortable: true
+    column :budget_per_task, width: "8%", renderer: :currency, sortable: true
+    column :total_hours, width: "7%", sortable: true
+    column :completed_cost, width: "8%", renderer: :currency, sortable: true
+    column :budget_rank, width: "6%", sortable: true
+    column :unique_assignees, width: "6%", sortable: true
+
+    # Row styling using virtual column conditions
+    item_class "lcp-row-danger",
+      when: { field: :has_overdue_tasks, operator: :eq, value: true }
+
+    item_class "lcp-row-warning",
+      when: { field: :is_over_budget, operator: :eq, value: true }
+
+    item_class "lcp-row-success",
+      when: { field: :status, operator: :eq, value: "completed" }
+  end
+
+  show do
+    description "All values below are computed dynamically via SQL subqueries, JOINs, window functions, and services — no stored counters."
+
+    section "Project", columns: 2 do
+      field :name, renderer: :heading
+      field :status, renderer: :badge, options: {
+        color_map: { planning: "gray", active: "green", completed: "blue", archived: "orange" }
+      }
+      field :description
+      field :budget, renderer: :currency
+    end
+
+    section "Company (JOIN-based)", columns: 2, description: "Values pulled from a joined table via LEFT JOIN virtual columns." do
+      field :company_name
+      field :company_country
+    end
+
+    section "Aggregate Statistics", columns: 2, description: "Computed via COUNT, SUM, and AVG aggregates over associated tasks." do
+      field :tasks_count
+      field :completed_count
+      field :unique_assignees
+      field :total_hours
+      field :completed_cost, renderer: :currency
+      field :avg_priority
+    end
+
+    section "Expression Columns", columns: 2, description: "Inline SQL expressions: boolean checks, derived values, auto-included flags." do
+      field :has_overdue_tasks, renderer: :boolean_icon
+      field :is_over_budget, renderer: :boolean_icon
+      field :budget_per_task, renderer: :currency
+    end
+
+    section "Window & Service", columns: 2, description: "ROW_NUMBER() window function and service-computed health score." do
+      field :budget_rank
+      field :health_score, renderer: :number
+    end
+
+    section "Date Range", columns: 2, description: "MIN and MAX aggregates on the due_date field." do
+      field :earliest_due_date, renderer: :date
+      field :latest_due_date, renderer: :date
+    end
+
+    association_list "Tasks", association: :showcase_aggregate_items,
+      display_template: :default, link: false,
+      empty_message: "No tasks yet."
+  end
+
+  form do
+    section "Project", columns: 2 do
+      field :name, placeholder: "Project name...", autofocus: true, col_span: 2
+      field :status, input_type: :select
+      field :budget
+      field :company_id, input_type: :association_select
+    end
+
+    section "Description" do
+      field :description, input_type: :textarea, input_options: { rows: 4 }
+    end
+  end
+
+  search do
+    searchable_fields :name, :description
+    placeholder "Search projects..."
+  end
+
+  export formats: [ :csv, :xlsx ], max_records: 2000
+
+  action :export, type: :built_in, on: :collection, icon: "download"
+  action :create, type: :built_in, on: :collection, label: "New Project", icon: "plus"
+  action :show, type: :built_in, on: :single
+  action :edit, type: :built_in, on: :single
+  action :destroy, type: :built_in, on: :single, confirm: true, style: :danger
+end

data/examples/showcase/config/lcp_ruby/presenters/showcase_aggregates_tiles.rb

@@ -0,0 +1,44 @@
+define_presenter :showcase_aggregates_tiles, inherits: :showcase_aggregates do
+  label "Virtual Columns (Tiles)"
+  slug "showcase-aggregates-tiles"
+
+  index do
+    layout :tiles
+    default_sort :name, :asc
+    per_page 6
+    row_click :show
+
+    tile { columns 2 }
+
+    card do
+      title_field :name
+      subtitle_field :status, renderer: :badge, options: {
+        color_map: { planning: "gray", active: "green", completed: "blue", archived: "orange" }
+      }
+      description_field :description, max_lines: 3
+      actions :inline
+
+      field :budget, label: "Budget", renderer: :currency
+      field :tasks_count, label: "Tasks"
+      field :completed_count, label: "Completed"
+      field :health_score, label: "Health %", renderer: :number
+      field :has_overdue_tasks, label: "Overdue?", renderer: :boolean_icon
+      field :company_name, label: "Company"
+    end
+
+    sort_field :name, label: "Name"
+    sort_field :budget, label: "Budget"
+    sort_field :tasks_count, label: "Tasks"
+    sort_field :health_score, label: "Health"
+
+    per_page_options 6, 12
+
+    summary do
+      field :budget, function: :sum, label: "Total Budget", renderer: :currency
+      field :budget, function: :avg, label: "Avg Budget", renderer: :currency
+      field :name, function: :count, label: "Project Count"
+      field :budget, function: :max, label: "Max Budget", renderer: :currency
+      field :budget, function: :min, label: "Min Budget", renderer: :currency
+    end
+  end
+end

data/examples/showcase/config/lcp_ruby/presenters/showcase_amount_kanban.rb

@@ -0,0 +1,31 @@
+# Phase 1 kanban demo (custom provider mode). Demonstrates the host-API
+# escape hatch from CLAUDE.md: when DefaultProvider's mode detection
+# (workflow/enum/belongs_to) cannot express a grouping, the configurator
+# ships a HostProvider subclass. Read-only board (no `move`) — Phase 2
+# extends with custom write semantics if the host app needs them.
+define_presenter :showcase_amount_kanban, inherits: :showcase_workflows do
+  label "Workflow Requests (by amount bucket — custom provider)"
+  slug "showcase-amount-kanban"
+  icon "kanban"
+
+  index do
+    layout :kanban
+    description "Phase 1 kanban with a custom HostProvider — virtual grouping by amount range. Read-only (no move)."
+    row_click :show
+    default_sort :amount, :desc
+
+    card do
+      title_field :title
+      subtitle_field :status
+      field :amount, renderer: :currency, options: { currency: "USD" }
+      field :priority, renderer: :badge, options: {
+        color_map: { low: "gray", normal: "blue", high: "orange", urgent: "red" }
+      }
+    end
+
+    kanban do
+      provider ShowcaseAmountProvider
+      column_order %w[small medium large whale]
+    end
+  end
+end