phlex-reactive 0.13.2 → 0.13.3

data/lib/phlex/reactive/component/dsl.rb

@@ -389,6 +389,13 @@ module Phlex
           #     inputs: { title: :string, qty: :number },
           #     outputs: %i[title_preview char_count]
           #
+          # A CHECKBOX contributes its checked state, never its constant .value
+          # (issue #262): 1/0 as a :number, "true"/"false" as a :string, and a
+          # real boolean as a :boolean. It wins over the hidden companion Rails
+          # renders before it. A radio group contributes its checked radio's value.
+          #
+          #   reactive_compute :total, inputs: [:price, { gift_wrap: :boolean }], outputs: %i[total]
+          #
           # An output with no matching form field writes to its reactive_text(:name)
           # node (textContent); a declared input also mirrors into its own text node
           # with no reducer. The array form's wire stays byte-identical.

data/lib/phlex/reactive/component/helpers.rb

@@ -449,7 +449,7 @@ module Phlex
         # the baseline is the DOM's own `defaultValue`/`defaultChecked`/
         # `defaultSelected` from the last server render (dirty = current ≠ default).
         # The descriptor deep-merges via mix, so a caller's own data-action is
-        # token-joined, not clobbered (CLAUDE.md Never-Do #8).
+        # token-joined, not clobbered (AGENTS.md Never-Do #8).
         def reactive_field(param, **attrs)
           # Issue #184: the removed dirty: kwarg lands in **attrs — catch it and
           # print the reactive_dirty rewrite.
@@ -1232,8 +1232,9 @@ module Phlex
         # The inputs param wire (issue #104). Untyped (array form) → a JSON ARRAY of
         # names, byte-identical to the shipped wire so the client keeps its numeric
         # coercion. Typed (hash form) → a JSON OBJECT of name→type
-        # ({"title":"string","qty":"number"}) so the client reads a :string raw and
-        # coerces a :number through Number.
+        # ({"title":"string","qty":"number"}) so the client reads a :string raw,
+        # coerces a :number through Number and reads a :boolean as a checkbox's
+        # checked state (issue #262).
         def compute_inputs_param(definition)
           types = definition.input_types
           return definition.inputs.map(&:to_s).to_json if types.nil?

data/lib/phlex/reactive/component.rb

@@ -102,7 +102,8 @@ module Phlex
       # `input_types` (issue #104) is nil for the ARRAY input form (untyped ⇒ the
       # client coerces every input through Number, the shipped behavior) and a
       # { name => type } hash for the typed HASH form (:string reads the field
-      # value raw, :number coerces). `inputs` stays the ordered name list either
+      # value raw, :number coerces, :boolean reads a checkbox's checked state —
+      # issue #262). `inputs` stays the ordered name list either
       # way, so iteration order is preserved and the array-form wire is unchanged.
       #
       # `mirror` (issue #159) is nil when undeclared, else a { name => [id

data/lib/phlex/reactive/param_schema.rb

@@ -174,6 +174,22 @@ module Phlex
         coerced.equal?(DROP) ? {} : coerced
       end
 
+      # The key this DECLARATION holds for `name` if it declares it as an ARRAY
+      # param, else nil. Reads the declaration, never the incoming params, so the
+      # endpoint's empty-group announcement (issue #258) can only ever fill
+      # something the action asked for.
+      #
+      # A key that is neither a String nor a Symbol stays unresolved on purpose:
+      # `compile` accepts `{ 0 => [:string] }`, but `coerce_hash` raises on
+      # `0.to_sym` the moment that key is PRESENT, and the announcement is what
+      # would make it present. Resolving it would turn a request that answers 200
+      # and fills nothing into a 500.
+      def array_param(name)
+        name = name.to_s
+        key, type = @schema.find { |k, _| (k.is_a?(String) || k.is_a?(Symbol)) && k.to_s == name }
+        key if type.is_a?(Array)
+      end
+
       private
 
       # Coerce a value against a declared type. Arrays accept both a real JSON

data/lib/phlex/reactive/test_helpers.rb

@@ -64,10 +64,17 @@ module Phlex
       # `:file` param is present, issue #34): token + act flat, params bracketed.
       # No JSON Content-Type — Rails' test `post` builds the multipart body from
       # the nested Hash (files ride as UploadedFile values).
-      def post_reactive_multipart(component_or_class, act, params: {}, payload: {})
+      #
+      # `empty_groups:` names the `[]` groups the client cleared (issue #258). A
+      # form body cannot carry an empty array, so the client leaves those keys
+      # out and announces them in a field of its own; passing the names here is
+      # how a spec reproduces that request. Omit it and the body is exactly what
+      # it was before the field existed.
+      def post_reactive_multipart(component_or_class, act, params: {}, payload: {}, empty_groups: [])
         token = reactive_action_token(component_or_class, payload)
-        post Phlex::Reactive.action_path,
-          params: { token:, act:, params: },
+        body = { token:, act:, params: }
+        body[:empty_groups] = empty_groups if empty_groups.present?
+        post Phlex::Reactive.action_path, params: body,
           headers: { "Accept" => "text/vnd.turbo-stream.html" }
       end
 

data/lib/phlex/reactive/version.rb

@@ -2,6 +2,6 @@
 
 module Phlex
   module Reactive
-    VERSION = "0.13.2"
+    VERSION = "0.13.3"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phlex-reactive
 version: !ruby/object:Gem::Version
-  version: 0.13.2
+  version: 0.13.3
 platform: ruby
 authors:
 - Mikael Henriksson