a2ui-rails 0.1.0

data/lib/a2ui/signatures/adapt_layout.rb

@@ -0,0 +1,19 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class AdaptLayout < DSPy::Signature
+    description 'Adapt components for screen size.'
+
+    input do
+      const :components, T::Array[Component]
+      const :root_id, String
+      const :screen, ScreenSize
+    end
+
+    output do
+      const :components, T::Array[Component], description: 'Adapted components'
+      const :hidden_ids, T::Array[String], default: [], description: 'IDs to hide'
+    end
+  end
+end

data/lib/a2ui/signatures/generate_ui.rb

@@ -0,0 +1,20 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class GenerateUI < DSPy::Signature
+    description 'Generate UI components from natural language.'
+
+    input do
+      const :request, String, description: 'What UI to create'
+      const :surface_id, String
+      const :available_data, String, default: '{}', description: 'Available data model as JSON'
+    end
+
+    output do
+      const :root_id, String, description: 'Root component ID'
+      const :components, T::Array[Component], description: 'Component adjacency list'
+      const :initial_data, T::Array[DataUpdate], default: [], description: 'Initial data values'
+    end
+  end
+end

data/lib/a2ui/signatures/handle_action.rb

@@ -0,0 +1,23 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class HandleAction < DSPy::Signature
+    description 'Process user action and generate response.'
+
+    input do
+      const :action, UserAction
+      const :current_data, String, default: '{}', description: 'Surface data as JSON'
+      const :business_rules, String, default: '', description: 'Domain constraints'
+    end
+
+    output do
+      const :response_type, ActionResponseType
+      const :streams, T::Array[StreamOp], default: []
+      const :components, T::Array[Component], default: []
+      const :data_updates, T::Array[DataUpdate], default: []
+      const :redirect_url, String, default: '', description: 'URL if navigating'
+      const :message, String, default: '', description: 'User-facing message'
+    end
+  end
+end

data/lib/a2ui/signatures/parse_input.rb

@@ -0,0 +1,21 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ParseInput < DSPy::Signature
+    description 'Convert natural language to data updates.'
+
+    input do
+      const :text, String, description: 'User natural language input'
+      const :target_path, String, description: 'Path to update'
+      const :expected_schema, String, default: '', description: 'Expected structure hint'
+    end
+
+    output do
+      const :updates, T::Array[DataUpdate]
+      const :confidence, Float, description: '0.0-1.0 confidence score'
+      const :needs_clarification, T::Boolean
+      const :question, String, default: '', description: 'Clarification question if needed'
+    end
+  end
+end

data/lib/a2ui/signatures/update_ui.rb

@@ -0,0 +1,21 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class UpdateUI < DSPy::Signature
+    description 'Generate incremental Turbo Stream updates.'
+
+    input do
+      const :request, String, description: 'What to update'
+      const :surface_id, String
+      const :current_components, T::Array[Component], default: []
+      const :current_data, String, default: '{}', description: 'Current data as JSON'
+    end
+
+    output do
+      const :streams, T::Array[StreamOp], description: 'Turbo Stream operations'
+      const :components, T::Array[Component], default: [], description: 'New/updated components'
+      const :data_updates, T::Array[DataUpdate], default: []
+    end
+  end
+end

data/lib/a2ui/signatures/validate_data.rb

@@ -0,0 +1,18 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ValidateData < DSPy::Signature
+    description 'Validate data model against rules.'
+
+    input do
+      const :data, String, description: 'Data model as JSON'
+      const :rules, String, description: 'Validation rules'
+    end
+
+    output do
+      const :valid, T::Boolean
+      const :issues, T::Array[ValidationIssue], default: []
+    end
+  end
+end

data/lib/a2ui/signatures.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+require 'dspy'
+require_relative 'types'
+
+require_relative 'signatures/generate_ui'
+require_relative 'signatures/update_ui'
+require_relative 'signatures/handle_action'
+require_relative 'signatures/validate_data'
+require_relative 'signatures/parse_input'
+require_relative 'signatures/adapt_layout'

data/lib/a2ui/types/action.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class Action < T::Struct
+    const :name, String, description: 'Action identifier sent to server'
+    const :context, T::Array[ContextBinding], default: []
+  end
+end

data/lib/a2ui/types/action_response_type.rb

@@ -0,0 +1,13 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ActionResponseType < T::Enum
+    enums do
+      UpdateUI = new('update_ui')
+      Navigate = new('navigate')
+      DeleteSurface = new('delete_surface')
+      NoOp = new('no_op')
+    end
+  end
+end

data/lib/a2ui/types/alignment.rb

@@ -0,0 +1,13 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class Alignment < T::Enum
+    enums do
+      Start = new('start')
+      Center = new('center')
+      End = new('end')
+      Stretch = new('stretch')
+    end
+  end
+end

data/lib/a2ui/types/boolean_value.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class BooleanValue < T::Struct
+    const :key, String
+    const :boolean, T::Boolean
+  end
+end

data/lib/a2ui/types/button_component.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ButtonComponent < T::Struct
+    const :id, String
+    const :label, Value, description: 'Button label text'
+    const :action, Action
+    const :disabled, T::Boolean, default: false
+    const :variant, String, default: 'primary', description: 'primary, secondary, or danger'
+  end
+end

data/lib/a2ui/types/card_component.rb

@@ -0,0 +1,11 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class CardComponent < T::Struct
+    const :id, String
+    const :child_id, String, description: 'ID of the child component'
+    const :title, String, default: ''
+    const :elevation, Integer, default: 1
+  end
+end

data/lib/a2ui/types/check_box_component.rb

@@ -0,0 +1,10 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class CheckBoxComponent < T::Struct
+    const :id, String
+    const :checked, PathReference, description: 'Path to boolean in data model'
+    const :label, String, default: ''
+  end
+end

data/lib/a2ui/types/column_component.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ColumnComponent < T::Struct
+    const :id, String
+    const :children, Children
+    const :distribution, Distribution, default: Distribution::Start
+    const :alignment, Alignment, default: Alignment::Stretch
+    const :gap, Integer, default: 8
+  end
+end

data/lib/a2ui/types/context_binding.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ContextBinding < T::Struct
+    const :key, String, description: 'Key name in the action context'
+    const :path, String, description: 'JSON Pointer to extract value from'
+  end
+end

data/lib/a2ui/types/data_driven_children.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class DataDrivenChildren < T::Struct
+    const :path, String, description: 'JSON Pointer to array in data model'
+    const :template_id, String, description: 'Component ID to use as template for each item'
+  end
+end

data/lib/a2ui/types/data_update.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class DataUpdate < T::Struct
+    const :path, String, description: 'JSON Pointer path (e.g., /reservation/guests)'
+    const :entries, T::Array[DataValue], description: 'Values to set at this path'
+  end
+end

data/lib/a2ui/types/distribution.rb

@@ -0,0 +1,15 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class Distribution < T::Enum
+    enums do
+      Start = new('start')
+      Center = new('center')
+      End = new('end')
+      SpaceBetween = new('space_between')
+      SpaceAround = new('space_around')
+      SpaceEvenly = new('space_evenly')
+    end
+  end
+end

data/lib/a2ui/types/divider_component.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class DividerComponent < T::Struct
+    const :id, String
+    const :orientation, Orientation, default: Orientation::Horizontal
+  end
+end

data/lib/a2ui/types/explicit_children.rb

@@ -0,0 +1,8 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ExplicitChildren < T::Struct
+    const :ids, T::Array[String], description: 'List of child component IDs'
+  end
+end

data/lib/a2ui/types/icon_component.rb

@@ -0,0 +1,10 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class IconComponent < T::Struct
+    const :id, String
+    const :name, String, description: 'Material icon name (e.g., check, close, menu)'
+    const :size, Integer, default: 24
+  end
+end

data/lib/a2ui/types/image_component.rb

@@ -0,0 +1,11 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ImageComponent < T::Struct
+    const :id, String
+    const :src, Value, description: 'Image URL'
+    const :alt, String, default: ''
+    const :fit, ImageFit, default: ImageFit::Contain
+  end
+end

data/lib/a2ui/types/image_fit.rb

@@ -0,0 +1,14 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ImageFit < T::Enum
+    enums do
+      Contain = new('contain')
+      Cover = new('cover')
+      Fill = new('fill')
+      ScaleDown = new('scale_down')
+      None = new('none')
+    end
+  end
+end

data/lib/a2ui/types/input_type.rb

@@ -0,0 +1,16 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class InputType < T::Enum
+    enums do
+      Text = new('text')
+      Number = new('number')
+      Date = new('date')
+      Longtext = new('longtext')
+      Email = new('email')
+      Tel = new('tel')
+      Url = new('url')
+    end
+  end
+end

data/lib/a2ui/types/list_component.rb

@@ -0,0 +1,10 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ListComponent < T::Struct
+    const :id, String
+    const :children, Children
+    const :orientation, Orientation, default: Orientation::Vertical
+  end
+end

data/lib/a2ui/types/literal_value.rb

@@ -0,0 +1,8 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class LiteralValue < T::Struct
+    const :value, String, description: 'The literal string value'
+  end
+end

data/lib/a2ui/types/number_value.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class NumberValue < T::Struct
+    const :key, String
+    const :number, Float
+  end
+end

data/lib/a2ui/types/object_value.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ObjectValue < T::Struct
+    const :key, String
+    const :entries, T::Hash[String, T.untyped], default: {}, description: 'Nested key-value pairs as JSON-like hash'
+  end
+end

data/lib/a2ui/types/orientation.rb

@@ -0,0 +1,11 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class Orientation < T::Enum
+    enums do
+      Horizontal = new('horizontal')
+      Vertical = new('vertical')
+    end
+  end
+end

data/lib/a2ui/types/path_reference.rb

@@ -0,0 +1,8 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class PathReference < T::Struct
+    const :path, String, description: 'JSON Pointer to data model (e.g., /user/name)'
+  end
+end

data/lib/a2ui/types/row_component.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class RowComponent < T::Struct
+    const :id, String
+    const :children, Children
+    const :distribution, Distribution, default: Distribution::Start
+    const :alignment, Alignment, default: Alignment::Center
+    const :gap, Integer, default: 8
+  end
+end

data/lib/a2ui/types/screen_size.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ScreenSize < T::Enum
+    enums do
+      Mobile = new('mobile')
+      Tablet = new('tablet')
+      Desktop = new('desktop')
+    end
+  end
+end

data/lib/a2ui/types/select_component.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class SelectComponent < T::Struct
+    const :id, String
+    const :value, PathReference, description: 'Path to selected value'
+    const :options_path, PathReference, description: 'Path to array of {value, label} options'
+    const :label, String, default: ''
+    const :placeholder, String, default: 'Select...'
+  end
+end

data/lib/a2ui/types/slider_component.rb

@@ -0,0 +1,13 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class SliderComponent < T::Struct
+    const :id, String
+    const :value, PathReference, description: 'Path to numeric value'
+    const :min, Float, default: 0.0
+    const :max, Float, default: 100.0
+    const :step, Float, default: 1.0
+    const :label, String, default: ''
+  end
+end

data/lib/a2ui/types/stream_action.rb

@@ -0,0 +1,16 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class StreamAction < T::Enum
+    enums do
+      Append = new('append')
+      Prepend = new('prepend')
+      Replace = new('replace')
+      Update = new('update')
+      Remove = new('remove')
+      Before = new('before')
+      After = new('after')
+    end
+  end
+end

data/lib/a2ui/types/stream_op.rb

@@ -0,0 +1,10 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class StreamOp < T::Struct
+    const :action, StreamAction
+    const :target, String, description: 'Target element ID'
+    const :component_ids, T::Array[String], default: [], description: 'Components to render'
+  end
+end

data/lib/a2ui/types/string_value.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class StringValue < T::Struct
+    const :key, String
+    const :string, String
+  end
+end

data/lib/a2ui/types/text_component.rb

@@ -0,0 +1,10 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class TextComponent < T::Struct
+    const :id, String
+    const :content, Value, description: 'Text content'
+    const :usage_hint, TextUsageHint, default: TextUsageHint::Body
+  end
+end

data/lib/a2ui/types/text_field_component.rb

@@ -0,0 +1,13 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class TextFieldComponent < T::Struct
+    const :id, String
+    const :value, PathReference, description: 'Path to bound value in data model'
+    const :input_type, InputType, default: InputType::Text
+    const :label, String, default: ''
+    const :placeholder, String, default: ''
+    const :is_required, T::Boolean, default: false, description: 'Whether the field is required'
+  end
+end

data/lib/a2ui/types/text_usage_hint.rb

@@ -0,0 +1,16 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class TextUsageHint < T::Enum
+    enums do
+      H1 = new('h1')
+      H2 = new('h2')
+      H3 = new('h3')
+      H4 = new('h4')
+      H5 = new('h5')
+      Body = new('body')
+      Caption = new('caption')
+    end
+  end
+end

data/lib/a2ui/types/user_action.rb

@@ -0,0 +1,11 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class UserAction < T::Struct
+    const :name, String, description: 'Action name from component'
+    const :surface_id, String
+    const :source_id, String, description: 'Component ID that triggered action'
+    const :context, T::Hash[String, String], default: {}, description: 'Resolved context values'
+  end
+end

data/lib/a2ui/types/validation_issue.rb

@@ -0,0 +1,10 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  class ValidationIssue < T::Struct
+    const :path, String, description: 'JSON Pointer to invalid field'
+    const :message, String
+    const :code, String, description: 'Machine-readable code like required, invalid_format'
+  end
+end