a2ui-rails 0.1.0

data/lib/a2ui/types.rb

@@ -0,0 +1,91 @@
+# typed: strict
+# frozen_string_literal: true
+
+require 'sorbet-runtime'
+
+# Enums
+require_relative 'types/text_usage_hint'
+require_relative 'types/image_fit'
+require_relative 'types/input_type'
+require_relative 'types/distribution'
+require_relative 'types/alignment'
+require_relative 'types/orientation'
+require_relative 'types/stream_action'
+require_relative 'types/action_response_type'
+require_relative 'types/screen_size'
+
+# Value types
+require_relative 'types/literal_value'
+require_relative 'types/path_reference'
+
+# Children types
+require_relative 'types/explicit_children'
+require_relative 'types/data_driven_children'
+
+# Data value types
+require_relative 'types/string_value'
+require_relative 'types/number_value'
+require_relative 'types/boolean_value'
+require_relative 'types/object_value'
+
+# Action types
+require_relative 'types/context_binding'
+require_relative 'types/action'
+require_relative 'types/user_action'
+require_relative 'types/validation_issue'
+
+module A2UI
+  # =============================================================================
+  # TYPE ALIASES (Union Types)
+  # Must be defined after all constituent types are loaded
+  # =============================================================================
+
+  # Value is either a literal string OR a path to the data model
+  Value = T.type_alias { T.any(LiteralValue, PathReference) }
+
+  # Children are either an explicit ID list OR data-driven from a path
+  Children = T.type_alias { T.any(ExplicitChildren, DataDrivenChildren) }
+
+  # Data model values can be string, number, boolean, or nested object
+  DataValue = T.type_alias { T.any(StringValue, NumberValue, BooleanValue, ObjectValue) }
+end
+
+# Components (depend on type aliases above)
+require_relative 'types/text_component'
+require_relative 'types/image_component'
+require_relative 'types/icon_component'
+require_relative 'types/button_component'
+require_relative 'types/text_field_component'
+require_relative 'types/check_box_component'
+require_relative 'types/slider_component'
+require_relative 'types/select_component'
+require_relative 'types/row_component'
+require_relative 'types/column_component'
+require_relative 'types/card_component'
+require_relative 'types/list_component'
+require_relative 'types/divider_component'
+
+module A2UI
+  # Component union type - all possible component types
+  Component = T.type_alias do
+    T.any(
+      TextComponent,
+      ImageComponent,
+      IconComponent,
+      ButtonComponent,
+      TextFieldComponent,
+      CheckBoxComponent,
+      SliderComponent,
+      SelectComponent,
+      RowComponent,
+      ColumnComponent,
+      CardComponent,
+      ListComponent,
+      DividerComponent
+    )
+  end
+end
+
+# Types that depend on Component/DataValue unions
+require_relative 'types/data_update'
+require_relative 'types/stream_op'

data/lib/a2ui/version.rb

@@ -0,0 +1,6 @@
+# typed: strict
+# frozen_string_literal: true
+
+module A2UI
+  VERSION = '0.1.0'
+end

data/lib/a2ui.rb

@@ -0,0 +1,7 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative 'a2ui/version'
+require_relative 'a2ui/types'
+require_relative 'a2ui/signatures'
+require_relative 'a2ui/modules'

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: a2ui-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vicente Reig
+bindir: bin
+cert_chain: []
+date: 2025-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dspy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.34'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.34'
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  A Ruby port of Google's A2UI (Agent-to-User Interface) for Rails.
+  Uses DSPy.rb to generate typed UI descriptions from natural language,
+  rendered as ViewComponents via Turbo Streams.
+email:
+- vicente@vicente.services
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/a2ui.rb
+- lib/a2ui/modules.rb
+- lib/a2ui/modules/action_handler.rb
+- lib/a2ui/modules/data_validator.rb
+- lib/a2ui/modules/input_parser.rb
+- lib/a2ui/modules/layout_adapter.rb
+- lib/a2ui/modules/surface.rb
+- lib/a2ui/modules/surface_manager.rb
+- lib/a2ui/modules/ui_generator.rb
+- lib/a2ui/modules/ui_updater.rb
+- lib/a2ui/signatures.rb
+- lib/a2ui/signatures/adapt_layout.rb
+- lib/a2ui/signatures/generate_ui.rb
+- lib/a2ui/signatures/handle_action.rb
+- lib/a2ui/signatures/parse_input.rb
+- lib/a2ui/signatures/update_ui.rb
+- lib/a2ui/signatures/validate_data.rb
+- lib/a2ui/types.rb
+- lib/a2ui/types/action.rb
+- lib/a2ui/types/action_response_type.rb
+- lib/a2ui/types/alignment.rb
+- lib/a2ui/types/boolean_value.rb
+- lib/a2ui/types/button_component.rb
+- lib/a2ui/types/card_component.rb
+- lib/a2ui/types/check_box_component.rb
+- lib/a2ui/types/column_component.rb
+- lib/a2ui/types/context_binding.rb
+- lib/a2ui/types/data_driven_children.rb
+- lib/a2ui/types/data_update.rb
+- lib/a2ui/types/distribution.rb
+- lib/a2ui/types/divider_component.rb
+- lib/a2ui/types/explicit_children.rb
+- lib/a2ui/types/icon_component.rb
+- lib/a2ui/types/image_component.rb
+- lib/a2ui/types/image_fit.rb
+- lib/a2ui/types/input_type.rb
+- lib/a2ui/types/list_component.rb
+- lib/a2ui/types/literal_value.rb
+- lib/a2ui/types/number_value.rb
+- lib/a2ui/types/object_value.rb
+- lib/a2ui/types/orientation.rb
+- lib/a2ui/types/path_reference.rb
+- lib/a2ui/types/row_component.rb
+- lib/a2ui/types/screen_size.rb
+- lib/a2ui/types/select_component.rb
+- lib/a2ui/types/slider_component.rb
+- lib/a2ui/types/stream_action.rb
+- lib/a2ui/types/stream_op.rb
+- lib/a2ui/types/string_value.rb
+- lib/a2ui/types/text_component.rb
+- lib/a2ui/types/text_field_component.rb
+- lib/a2ui/types/text_usage_hint.rb
+- lib/a2ui/types/user_action.rb
+- lib/a2ui/types/validation_issue.rb
+- lib/a2ui/version.rb
+homepage: https://github.com/vicentereig/a2ui-rails
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/vicentereig/a2ui-rails
+  source_code_uri: https://github.com/vicentereig/a2ui-rails
+  changelog_uri: https://github.com/vicentereig/a2ui-rails/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.5
+specification_version: 4
+summary: A2UI for Rails - LLM-driven UI generation with Turbo Streams
+test_files: []