poetry-ui 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7e5a4ac13adb19047199d51de9fc0077d10f3b89d74302fc738a10db528dc63
-  data.tar.gz: 2100d959fc3e89a3c189b6b8350ca4a22d41eda259a286fb071b898e88c9b56d
+  metadata.gz: a79167a3bdfe8283f8e3d6517e9b1a253fabd02df41417c5cafa79ad3fa12ddf
+  data.tar.gz: adb7128dde7ad61162336a2126b436e558bcd6bd49217c7347f0f829a8cecacc
 SHA512:
-  metadata.gz: 8416f0e954b93265431f796ad2f2f42aea2a68c0f912dc7d6d83f224dc30c0c264a0ece1d806e4a0fca567c558e1a592eaa63e445fb8e25c20f98e1ff870c3dc
-  data.tar.gz: a92f9fb002bb8eb856c2f9810d6733a6234fe95e72131d60cd8e173f943210b7a616681626afc0a40c3cd90ecdcd1c4da0791722cc2b09574395780a734bba6c
+  metadata.gz: 78e59128853d1a15f2041262b1f8d486aeb626b4a0bb5f84cc649dd5c2f9dfe064962be4533de4e0f14a0c56e073daf33fb594e7ebfaa601d49adfb043d5c86a
+  data.tar.gz: f847ad9c837ff9f46a89fef1d40548506f0e425ef9f95292d5145fe92f76cfb3736cd750a6790c94535337c6b2223932af1c7e6b9bab275dcf853b7bafb61fab

data/app/components/poetry/ui/date_time_field/component.html.erb

@@ -0,0 +1,6 @@
+<%# DateField's template verbatim: native input visible (and THE form
+    value) until the controller builds segments into the group. %>
+<%= content_tag(:div, **root_attributes.to_attributes) do %>
+  <%= content_tag(:span, "", **Poetry::Core::HTML::Attributes.new(group_attributes).to_attributes) %>
+  <%= tag.input(**input_attributes.to_attributes) %>
+<% end %>

data/app/components/poetry/ui/date_time_field/component.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    # Segmented date-and-time editors.
+    module DateTimeField
+      # A segmented date-and-time editor: one control, one value. The form
+      # value is a native <input type=datetime-local> submitting local wall
+      # time as YYYY-MM-DDTHH:MM (HH:MM:SS with seconds:), and without JS
+      # that native input simply renders, so the field always works.
+      # Enhanced, the date segments and the time segments share one row in
+      # the locale's own order and separators; the locale decides 12- vs
+      # 24-hour editing (hour_cycle: pins it). No zone travels on the wire:
+      # the value is the wall time the user typed, for the app to place.
+      #
+      # A DateTimeField is a DateField specialized to a date and a time -
+      # segments share the date-field-* part vocabulary.
+      #
+      # @example
+      #   render Poetry::Ui::DateTimeField::Component.new(
+      #     name: "event[starts_at]", label: "Starts", value: "2026-07-13T09:30"
+      #   )
+      class Component < DateField::Component
+        # Projected into the registry, llms.txt, and the agent surface.
+        AGENT_RULES = [
+          "Date-and-time entry is a DateTimeField (poetry_date_time_field / form.datetime_field) - " \
+          "never a DateField beside a TimeField, three selects, or a bare input type=datetime-local " \
+          "when the design system is in play; params[<name>] is YYYY-MM-DDTHH:MM (with :SS under " \
+          "seconds:), with or without JS.",
+          "No zone rides the wire: the value is the wall time the user typed on their own clock - the " \
+          "app places it (Time.zone.parse in the controller, or the model's zone).",
+          "12- vs 24-hour follows the user's locale automatically (the dayPeriod segment appears only " \
+          "under twelve-hour cycles); hour_cycle: pins it when a product must."
+        ].freeze
+
+        # EXTENDS DateField's root declaration (extend: true merges into
+        # the inherited element) - same date-field controller, two more
+        # values; group/input inherit untouched.
+        use_stimulus do
+          on :root, extend: true do
+            controller :date_field do
+              value :seconds, true, if: :seconds
+              value :hour_cycle, if: -> { hour_cycle.present? }
+            end
+          end
+        end
+
+        option :seconds, :boolean, default: false,
+                                   doc: "Adds the seconds segment; the wire format becomes YYYY-MM-DDTHH:MM:SS."
+        option :hour_cycle, :string, doc: "Pins the hour cycle (h12/h23/h11/h24) instead of the locale's."
+
+        part "date-time-field", "Root - the controller and the enhanced/disabled surface ride " \
+                                "here (segments inside share the date-field-* vocabulary)",
+             states: {
+               "data-enhanced" => "the controller connected and built segments (no JS = the " \
+                                  "native input, visible and styled)",
+               "data-disabled" => "disabled: is set",
+               "data-invalid" => "invalid: is set (the group wears the destructive ring)"
+             }
+        part "date-time-field-group", "The bordered segment row - hidden until enhancement, then " \
+                                      "the editing surface (cn-input chrome, focus-within ring)",
+             states: {
+               "data-disabled" => "disabled: is set (chrome dims, pointer events off)",
+               "data-invalid" => "invalid: is set (destructive border + ring)"
+             }
+        part "date-time-field-input", "The native <input type=datetime-local> - THE form value in " \
+                                      "both modes; tabindex -1 + aria-hidden once segments exist"
+
+        private
+
+        def input_type
+          "datetime-local"
+        end
+
+        def slot_prefix
+          "date-time-field"
+        end
+
+        def iso(candidate)
+          candidate.respond_to?(:strftime) ? candidate.strftime("%FT%H:%M#{":%S" if seconds}") : candidate.to_s
+        end
+
+        def placeholder_iso
+          return iso(placeholder_value) if placeholder_value.present?
+
+          "#{Date.current.strftime("%F")}T12:00#{":00" if seconds}"
+        end
+      end
+    end
+  end
+end

data/app/components/poetry/ui/date_time_field/preview.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    module DateTimeField
+      # The DateTimeField preview: empty and valued fields, seconds, a
+      # pinned 24-hour cycle, disabled, invalid, and a pinned locale.
+      class Preview < Poetry::Core::Preview::Base
+        # Empty: date placeholders then hour/minute (plus AM/PM under
+        # twelve-hour locales) once enhanced; the styled native input before that.
+        def default
+          render_component(name: "event[starts_at]", label: "Starts")
+        end
+
+        def with_value
+          render_component(name: "event[starts_at]", value: "2026-07-13T13:05", label: "Starts")
+        end
+
+        def with_seconds
+          render_component(name: "job[run_at]", value: "2026-07-13T09:30:15", seconds: true, label: "Run at")
+        end
+
+        # A pinned 24-hour cycle regardless of the page locale.
+        def twenty_four_hour
+          render_component(name: "shift[starts_at]", value: "2026-07-13T21:15", hour_cycle: "h23", label: "Shift start")
+        end
+
+        def disabled
+          render_component(name: "event[starts_at]", value: "2026-07-13T13:05", disabled: true, label: "Starts")
+        end
+
+        def invalid
+          render_component(name: "event[starts_at]", value: "2026-07-13T13:05", invalid: true, label: "Starts")
+        end
+
+        # locale: pins the order, separators, and cycle instead of following the page locale.
+        def localized
+          render_component(name: "termin[beginn]", value: "2026-07-13T14:30", locale: "de-DE", label: "Beginn")
+        end
+      end
+    end
+  end
+end

data/app/components/poetry/ui/date_time_field/style.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    module DateTimeField
+      # DateField's style verbatim (one segment engine, two components) -
+      # including the group/date-field marker name, which the enhanced-
+      # input selector keys on. See date_field/style.rb for the rationale.
+      class Style < Poetry::Core::Style
+        base "group/date-field flex w-full flex-col"
+
+        element :group,
+                "cn-input hidden w-fit min-w-0 select-none items-center tabular-nums " \
+                "group-data-[enhanced]/date-field:flex " \
+                "focus-within:border-ring focus-within:ring-[3px] focus-within:ring-ring/50 " \
+                "data-invalid:border-destructive data-invalid:ring-destructive/20 " \
+                "dark:data-invalid:ring-destructive/40 " \
+                "data-disabled:pointer-events-none data-disabled:opacity-50 " \
+                "[&_[data-slot=date-field-segment]]:rounded-sm " \
+                "[&_[data-slot=date-field-segment]]:px-0.5 " \
+                "[&_[data-slot=date-field-segment]]:outline-none " \
+                "[&_[data-slot=date-field-segment]:focus]:bg-accent " \
+                "[&_[data-slot=date-field-segment]:focus]:text-accent-foreground " \
+                "[&_[data-slot=date-field-segment][data-placeholder]]:text-muted-foreground " \
+                "[&_[data-slot=date-field-literal]]:text-muted-foreground"
+        element :input, "group-data-[enhanced]/date-field:sr-only"
+      end
+    end
+  end
+end

data/app/components/poetry/ui/time_field/component.rb

@@ -26,8 +26,8 @@ module Poetry
           "Input or a pair of selects; params[<name>] is HH:MM (HH:MM:SS with seconds:).",
           "12- vs 24-hour follows the user's locale automatically (the dayPeriod segment " \
           "appears only under twelve-hour cycles); hour_cycle: pins it when a product must.",
-          "For a date AND a time, compose a DateField and a TimeField side by side - there " \
-          "is no datetime component by design."
+          "For a date AND a time, use a DateTimeField (poetry_date_time_field / form.datetime_field): " \
+          "one control, one datetime-local value."
         ].freeze
 
         # EXTENDS DateField's root declaration (extend: true merges into

data/app/helpers/poetry/ui/components_helper.rb

@@ -1110,6 +1110,18 @@ module Poetry
         render(Poetry::Ui::TimeField::Component.new(**))
       end
 
+      # A segmented date-and-time editor over a native datetime-local
+      # input: one control, one local wall-time value (no zone on the wire).
+      #
+      # @example
+      #     poetry_date_time_field(
+      #       name: "event[starts_at]", label: "Starts", value: "2026-07-13T09:30"
+      #     )
+      # @see Poetry::Ui::DateTimeField::Component
+      def poetry_date_time_field(**)
+        render(Poetry::Ui::DateTimeField::Component.new(**))
+      end
+
       # A quantity within a known range (disk, seats, strength) - role
       # "meter progressbar" (the two-token fallback); never indeterminate.
       #

data/app/helpers/poetry/ui/form_builder.rb

@@ -28,12 +28,18 @@ module Poetry
         "f.association(:company) reflects the association - belongs_to renders a Combobox on " \
         "the foreign key, has_many the select-all checkbox group on singular_ids.",
         "Validations become attributes: presence -> aria-required (NEVER native required), " \
-        "length -> maxlength/minlength, numericality -> min/max/step.",
+        "length -> maxlength/minlength, numericality -> min/max/step; f.input(required: true/false) " \
+        "overrides the presence inference (aria only).",
         "Hints/placeholders resolve from poetry_form.* i18n (simple_form.* keys keep working " \
         "as a fallback); pass hint:/placeholder: to override.",
         "f.submit renders a poetry Button with the Rails i18n label; f.fieldset(legend:)/" \
         "f.group lay out sections; boolean f.input renders the horizontal Field " \
-        "(switch: true -> the setting row)."
+        "(switch: true -> the setting row).",
+        "Apps on simple_form: add poetry-simple_form instead of rewriting views - " \
+        "Poetry::SimpleForm.activate! maps every simple_form type onto this builder (poetry-only " \
+        "controls via as: :switch/:slider/:otp/:sensitive/:tag_group/:date_picker/:calendar/" \
+        ":combobox/:autocomplete/:native_select; poetry: options merge last). The bridge is the " \
+        "migration path, form_with(builder:) the end state."
       ].freeze
 
       # One-line summaries of the builder methods, projected into the
@@ -64,7 +70,7 @@ module Poetry
         {
           "rules" => AGENT_RULES,
           "methods" => METHOD_SUMMARIES,
-          "input_types" => (INPUT_DISPATCH.keys + TYPED_FIELDS + %i[boolean enum]).map(&:to_s)
+          "input_types" => (INPUT_DISPATCH.keys + TYPED_FIELDS + %i[boolean switch enum]).map(&:to_s)
         }
       end
 
@@ -251,6 +257,27 @@ module Poetry
         end
       end
 
+      # A Field-wrapped DateTimeField (one control, one datetime-local value; seconds:/hour_cycle: pass through).
+      #
+      # @param method [Symbol] the model attribute
+      # @param hint [String, nil] hint text
+      # @return [ActiveSupport::SafeBuffer]
+      def datetime_field(method, hint: nil, **options)
+        field_component = field_for(method, hint: hint)
+        describedby = field_component.control_attributes["aria-describedby"]
+        @template.render(field_component) do
+          @template.render DateTimeField::Component.new(
+            name: field_name(method),
+            value: object.public_send(method),
+            required: required?(method),
+            invalid: field_component.invalid?,
+            id: field_component.control_attributes["id"],
+            **(describedby ? { described_by: describedby } : {}),
+            **options.transform_keys(&:to_sym)
+          )
+        end
+      end
+
       # form.file_input(:document) / form.file_input(:photos, variant: :dropzone,
       # multiple: true) - a Field wrapping a FileInput; the native
       # input is the form value, so ActiveStorage attaches as usual.
@@ -354,13 +381,14 @@ module Poetry
         time: :time_field, file: :file_input, sensitive: :sensitive_input,
         select: :poetry_select, combobox: :poetry_combobox,
         radio_group: :radio_group, autocomplete: :autocomplete,
-        tag_group: :tag_group, date_picker: :date_picker, calendar: :calendar
+        tag_group: :tag_group, date_picker: :date_picker, calendar: :calendar,
+        slider: :slider, otp: :otp_field, native_select: :native_select, datetime: :datetime_field
       }.freeze
       # The as: values that answer with #field carrying a native input type.
       TYPED_FIELDS = %i[email url tel].freeze
       # The as: values whose dispatch method takes the collection as its
       # second positional argument.
-      COLLECTION_ARGS = %i[select combobox radio_group autocomplete].freeze
+      COLLECTION_ARGS = %i[select combobox radio_group autocomplete native_select].freeze
 
       # The inferred entrypoint: one call, everything derived from the
       # model. The control type comes from as: when given, otherwise from
@@ -379,34 +407,38 @@ module Poetry
       #
       # @param method [Symbol] the model attribute
       # @param as [Symbol, nil] explicit control type - an INPUT_DISPATCH
-      #   key, :email/:url/:tel, :boolean, or :enum (overrides inference)
+      #   key, :email/:url/:tel, :boolean, :switch, or :enum (overrides inference)
       # @param collection [Enumerable, nil] choices for collection-shaped
-      #   types (:select, :combobox, :radio_group, :autocomplete)
+      #   types (:select, :combobox, :radio_group, :autocomplete, :native_select)
       # @param hint [String, nil] hint text (overrides the i18n chain)
+      # @param required [Boolean, nil] overrides the presence-validator inference for this
+      #   call (aria-required only, never the native attribute)
       # @return [ActiveSupport::SafeBuffer] the rendered Field
-      def input(method, as: nil, collection: nil, hint: nil, **options)
+      def input(method, as: nil, collection: nil, hint: nil, required: nil, **options)
+        unless required.nil?
+          return with_required_override(method, required) do
+            input(method, as: as, collection: collection, hint: hint, **options)
+          end
+        end
+
         type = as || infer_input_type(method, collection: collection)
         hint ||= form_i18n(:hints, method)
         options[:placeholder] = form_i18n(:placeholders, method) if options[:placeholder].nil?
         options.compact!
 
         return boolean_input(method, hint: hint, **options) if type == :boolean
+        return boolean_input(method, hint: hint, switch: true, **options) if type == :switch
         return enum_input(method, hint: hint, **options) if type == :enum
         if TYPED_FIELDS.include?(type)
           return field(method, hint: hint, type: type, **length_attributes(method),
                                **options)
         end
 
-        if type == :datetime
-          raise ArgumentError, "f.input cannot infer :datetime (no composite control yet) - " \
-                               "pass as: :date or as: :time explicitly"
-        end
-
         options = length_attributes(method).merge(options) if %i[string password text].include?(type)
         options = numeric_attributes(method).merge(options) if type == :number
         dispatch = INPUT_DISPATCH.fetch(type) do
           raise ArgumentError, "f.input does not know as: #{type.inspect} " \
-                               "(one of #{INPUT_DISPATCH.keys.inspect}, :email, :url, :tel, :boolean, :enum)"
+                               "(one of #{INPUT_DISPATCH.keys.inspect}, :email, :url, :tel, :boolean, :switch, :enum)"
         end
         args = COLLECTION_ARGS.include?(type) ? [method, collection] : [method]
         send(dispatch, *args, hint: hint, **options)
@@ -879,6 +911,7 @@ module Poetry
       # validators (:if/:unless) never claim required, and :on contexts
       # must match the record's persistence.
       def required?(method)
+        return @required_overrides[method] if @required_overrides&.key?(method)
         return false unless object.class.respond_to?(:validators_on)
 
         context = object.respond_to?(:persisted?) && object.persisted? ? :update : :create
@@ -891,6 +924,16 @@ module Poetry
         end
       end
 
+      # Pins required?(method) for the duration of one render (f.input's
+      # required: keyword) - every Field-wrapped path reads required? through
+      # field_for, so the override reaches aria-required and nothing else.
+      def with_required_override(method, value)
+        (@required_overrides ||= {})[method] = value
+        yield
+      ensure
+        @required_overrides&.delete(method)
+      end
+
       # The Rails 8 respellings: ActionView 8
       # aliases textarea/checkbox at ITS class body, so a subclass override
       # of the old name never reaches them - define both, version-gated.

data/config/component_descriptions.yml

@@ -33,6 +33,7 @@ poetry/ui/context_menu: A menu of actions revealed by right-clicking an element.
 poetry/ui/data_table: A table with sorting, row selection, and sticky headers.
 poetry/ui/date_field: A segmented input for typing a date one part at a time.
 poetry/ui/date_picker: A date field that opens a calendar popover for selection.
+poetry/ui/date_time_field: A segmented input for typing a date and a time one part at a time.
 poetry/ui/deferred: A region that lazily loads its content on visibility, with skeleton
   and error states.
 poetry/ui/dialog: A window overlaid on the page for content that requires attention.

data/config/component_registry.yml

@@ -3922,6 +3922,156 @@ components:
           'on': input
         - method: inputKeydown
           'on': keydown
+  poetry/ui/date_time_field:
+    class_name: Poetry::Ui::DateTimeField::Component
+    identifier: poetry--ui--date_time_field
+    bem_block: poetry-ui-date_time_field
+    styles: []
+    options:
+    - name: described_by
+      type: string
+      description: Ids for aria-describedby (hint or error text).
+    - name: disabled
+      type: boolean
+      default: false
+      description: Disables the field; the segment group dims and goes inert.
+    - name: hour_cycle
+      type: string
+      description: Pins the hour cycle (h12/h23/h11/h24) instead of the locale's.
+    - name: id
+      type: string
+      description: The native input's DOM id - the Field label target.
+    - name: invalid
+      type: boolean
+      default: false
+      description: Paints the destructive border/ring and sets aria-invalid.
+    - name: label
+      type: string
+      description: Standalone accessible name; inside a form the Field label wires
+        ids instead. Segments announce it themselves.
+    - name: locale
+      type: string
+      description: Pins the field to a locale other than the page's.
+    - name: max
+      type:
+      description: The latest allowed date (Date or ISO string) - rides native constraint
+        validation.
+    - name: min
+      type:
+      description: The earliest allowed date (Date or ISO string) - rides native constraint
+        validation.
+    - name: name
+      type: string
+      required: true
+      description: The form field name - required; the value posts as ISO yyyy-mm-dd
+        with or without JS.
+    - name: placeholder_value
+      type:
+      description: What the first arrow press on an empty segment lands on; defaults
+        to today.
+    - name: readonly
+      type: boolean
+      default: false
+      description: The value shows but cannot be edited.
+    - name: required
+      type: boolean
+      default: false
+      description: Marks the native input required.
+    - name: seconds
+      type: boolean
+      default: false
+      description: Adds the seconds segment; the wire format becomes YYYY-MM-DDTHH:MM:SS.
+    - name: value
+      type:
+      description: Date, or an ISO yyyy-mm-dd string; nil renders empty.
+    slots: []
+    description: A segmented input for typing a date and a time one part at a time.
+    elements:
+    - group
+    - input
+    capsule: c812f47a82a9
+    controllers:
+    - identifier: poetry--core--date-field
+      targets:
+      - group
+      - input
+      values:
+      - hourCycle
+      - labels
+      - locale
+      - placeholder
+      - placeholders
+      - seconds
+      actions:
+      - focusGap
+      - settle
+      events:
+      - poetry:date-field:change
+    agent_rules:
+    - Date-and-time entry is a DateTimeField (poetry_date_time_field / form.datetime_field)
+      - never a DateField beside a TimeField, three selects, or a bare input type=datetime-local
+      when the design system is in play; params[<name>] is YYYY-MM-DDTHH:MM (with
+      :SS under seconds:), with or without JS.
+    - 'No zone rides the wire: the value is the wall time the user typed on their
+      own clock - the app places it (Time.zone.parse in the controller, or the model''s
+      zone).'
+    - '12- vs 24-hour follows the user''s locale automatically (the dayPeriod segment
+      appears only under twelve-hour cycles); hour_cycle: pins it when a product must.'
+    parts:
+    - name: date-time-field
+      description: Root - the controller and the enhanced/disabled surface ride here
+        (segments inside share the date-field-* vocabulary)
+      states:
+      - attr: data-enhanced
+        condition: the controller connected and built segments (no JS = the native
+          input, visible and styled)
+      - attr: data-disabled
+        condition: 'disabled: is set'
+      - attr: data-invalid
+        condition: 'invalid: is set (the group wears the destructive ring)'
+    - name: date-time-field-group
+      description: The bordered segment row - hidden until enhancement, then the editing
+        surface (cn-input chrome, focus-within ring)
+      states:
+      - attr: data-disabled
+        condition: 'disabled: is set (chrome dims, pointer events off)'
+      - attr: data-invalid
+        condition: 'invalid: is set (destructive border + ring)'
+    - name: date-time-field-input
+      description: The native <input type=datetime-local> - THE form value in both
+        modes; tabindex -1 + aria-hidden once segments exist
+    stimulus:
+    - element: root
+      controllers:
+      - identifier: poetry--core--date-field
+        registers: true
+        values:
+        - name: locale
+          conditional: if
+        - name: placeholder
+        - name: labels
+        - name: placeholders
+      - identifier: poetry--core--date-field
+        values:
+        - name: seconds
+          conditional: if seconds
+        - name: hour_cycle
+          conditional: if
+    - element: group
+      controllers:
+      - identifier: poetry--core--date-field
+        targets:
+        - name: group
+        actions:
+        - method: focusGap
+          'on': click
+        - method: settle
+          'on': focusout
+    - element: input
+      controllers:
+      - identifier: poetry--core--date-field
+        targets:
+        - name: input
   poetry/ui/deferred:
     class_name: Poetry::Ui::Deferred::Component
     identifier: poetry--ui--deferred
@@ -10672,8 +10822,8 @@ components:
       Input or a pair of selects; params[<name>] is HH:MM (HH:MM:SS with seconds:).
     - '12- vs 24-hour follows the user''s locale automatically (the dayPeriod segment
       appears only under twelve-hour cycles); hour_cycle: pins it when a product must.'
-    - For a date AND a time, compose a DateField and a TimeField side by side - there
-      is no datetime component by design.
+    - 'For a date AND a time, use a DateTimeField (poetry_date_time_field / form.datetime_field):
+      one control, one datetime-local value.'
     parts:
     - name: time-field
       description: Root - the controller and the enhanced/disabled surface ride here
@@ -12093,6 +12243,7 @@ helper_args:
   poetry_data_table: 0
   poetry_date_field: 0
   poetry_date_picker: 0
+  poetry_date_time_field: 0
   poetry_deferred: 0
   poetry_dialog: 0
   poetry_drawer: 0
@@ -12208,12 +12359,17 @@ form_builder:
   - f.association(:company) reflects the association - belongs_to renders a Combobox
     on the foreign key, has_many the select-all checkbox group on singular_ids.
   - 'Validations become attributes: presence -> aria-required (NEVER native required),
-    length -> maxlength/minlength, numericality -> min/max/step.'
+    length -> maxlength/minlength, numericality -> min/max/step; f.input(required:
+    true/false) overrides the presence inference (aria only).'
   - 'Hints/placeholders resolve from poetry_form.* i18n (simple_form.* keys keep working
     as a fallback); pass hint:/placeholder: to override.'
   - 'f.submit renders a poetry Button with the Rails i18n label; f.fieldset(legend:)/f.group
     lay out sections; boolean f.input renders the horizontal Field (switch: true ->
     the setting row).'
+  - 'Apps on simple_form: add poetry-simple_form instead of rewriting views - Poetry::SimpleForm.activate!
+    maps every simple_form type onto this builder (poetry-only controls via as: :switch/:slider/:otp/:sensitive/:tag_group/:date_picker/:calendar/:combobox/:autocomplete/:native_select;
+    poetry: options merge last). The bridge is the migration path, form_with(builder:)
+    the end state.'
   methods:
     input: 'the inferred entrypoint: type from as:/attachments/enums/column/name'
     association: 'reflection-derived: belongs_to -> Combobox(fk), has_many -> checkbox
@@ -12250,8 +12406,13 @@ form_builder:
   - tag_group
   - date_picker
   - calendar
+  - slider
+  - otp
+  - native_select
+  - datetime
   - email
   - url
   - tel
   - boolean
+  - switch
   - enum

data/lib/poetry/ui/version.rb

@@ -3,6 +3,6 @@
 module Poetry
   module Ui
     # The gem version.
-    VERSION = "0.0.2"
+    VERSION = "0.0.3"
   end
 end

data/lib/poetry/ui.rb

@@ -45,6 +45,7 @@ module Poetry
       "file_input" => %w[input icon], # input variant wears Input; the dropzone's upload glyph
       "date_field" => %w[input], # the pre-enhancement native input wears Input's chrome
       "time_field" => %w[date_field input], # DateField at hour granularity - one segment engine
+      "date_time_field" => %w[date_field input], # DateField with both runs - the same segment engine
       "meter" => %w[progress], # wears Progress::Style chrome verbatim
       "search_field" => %w[input input_group button icon], # composes their chrome
       "tag_group" => %w[icon], # the remove glyph
@@ -60,7 +61,8 @@ module Poetry
     # only the family it is composing in. The coverage gate fails on any
     # new component until it is mapped here.
     SKILL_FAMILIES = {
-      "forms" => %w[autocomplete button button_group calendar checkbox combobox date_field date_picker field
+      "forms" => %w[autocomplete button button_group calendar checkbox combobox date_field date_picker date_time_field
+                    field
                     field_group field_separator fieldset
                     file_input input input_group input_otp label native_select number_field
                     questionnaire radio_group search_field select sensitive_input slider switch textarea time_field

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: poetry-ui
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Matt Solt
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.0.3
 description: 'Poetry''s components for the AI-native UI component library: accessible,
   themeable, agent-legible ViewComponents built entirely on poetry-core''s public
   DSL.'
@@ -141,6 +141,10 @@ files:
 - app/components/poetry/ui/date_picker/component.rb
 - app/components/poetry/ui/date_picker/preview.rb
 - app/components/poetry/ui/date_picker/style.rb
+- app/components/poetry/ui/date_time_field/component.html.erb
+- app/components/poetry/ui/date_time_field/component.rb
+- app/components/poetry/ui/date_time_field/preview.rb
+- app/components/poetry/ui/date_time_field/style.rb
 - app/components/poetry/ui/deferred/component.html.erb
 - app/components/poetry/ui/deferred/component.rb
 - app/components/poetry/ui/deferred/preview.rb