glib-web 6.10.0 → 6.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebde832f6f50b0556f57e6b2d716d7315fa01c0def0b75953f8ecf5de60ca547
-  data.tar.gz: 4d217bd99f1a415bca302a08528a1da652788fc5cca031009e132079d2716381
+  metadata.gz: 50357c0c3002870707a68fad3a956248fb13cfb638395068ab970c0a7ee930ed
+  data.tar.gz: d04d1755a167f4d46c18aec66c958050c324192ee847b0ab0ed930ffd7ab2f7e
 SHA512:
-  metadata.gz: bb08b62b519b2a2cfc7c9b1767fce93c4373b63b43082715211d44d051a58aafa5e94d4d5509fd907e86a2b0f6a4ce9c35ec7842ce29d2d21993cadcdf044796
-  data.tar.gz: 715c3de7e58cfa4a443cc73b75b5c3d6a47bc5e9eff3eeb5cd812d119e0dff76e5c14832163abeb9ce891ea5c12b4922918b6133aa90a2848ff31fa49f40e664
+  metadata.gz: b72912d4e0dbe1fceb6d2180c292c390567a1c0d5ccc8e5f80bd20fa579d48b87cb0455a7ea3849469e24fbdb6ca90d5059e4c2799de0e0ab0dd15aa3c1e9430
+  data.tar.gz: fd855eb185f11b6d6e73becf6ab91ef1de85c78e957ae653e6f7a6e6bc9cb07eaa869f5f01142d8e73f674553dc621c4ebc517ce1b8bb4f76359a1571ca5bb60

data/app/helpers/glib/json_ui/view_builder/fields.rb

@@ -659,7 +659,10 @@ class Glib::JsonUi::ViewBuilder
     class ChipGroup < AbstractField
       color :color
       array :options
-      bool :multiple
+      # cache: true for the same reason as Upload's — without it a
+      # multiple-selection ChipGroup submits under a single key and only the
+      # last selected value survives server-side parsing.
+      bool :multiple, cache: true
     end
 
     class TimeZone < AbstractField
@@ -797,7 +800,11 @@ class Glib::JsonUi::ViewBuilder
       include Glib::JsonUi::FileUploadErrorHandler
 
       action :onFinishUpload
-      bool :multiple
+      # cache: true so `@multiple` is set before AbstractField#created computes
+      # the submit key — without it the `[]` array suffix is dropped and a
+      # multi-file submit collapses to the last file server-side (silently
+      # saves one Document per drop instead of one per file).
+      bool :multiple, cache: true
       hash :placeholderView, required: [:type, :width, :height], optional: [:url]
       hash :inputView, optional: [:files, :variant]
       hash :clipboardView, optional: [:icon]
@@ -855,10 +862,67 @@ class Glib::JsonUi::ViewBuilder
       end
     end
 
+    # Signature field that lets the user draw a signature on a canvas and
+    # upload it as an image via ActiveStorage direct upload.
+    #
+    # The form shows a placeholder sized by `width`/`height`; tapping it opens
+    # a dialog with the drawing canvas, and Confirm uploads the drawing as a
+    # PNG to `directUploadUrl` and submits the resulting signed id under
+    # `name`. The placeholder then shows the signature, and reopening the
+    # dialog lets the user edit it. Because the canvas is not in the form,
+    # the placeholder can be given the same height as a neighbouring input
+    # (e.g. a typed-name alternative) without losing drawing space.
+    #
+    # `label` titles the dialog; `placeholder` replaces the "Tap to sign"
+    # prompt.
+    #
+    # With `typedName` the dialog gains Draw/Type tabs: the user can type
+    # their name instead of drawing, and the placeholder then shows the name
+    # in a handwriting style (the `glib-sign-typed` hook carries the font).
+    # The typed name is submitted under `typedName[:name]`; exactly one of the
+    # signed id and the typed name is ever non-blank. `typedName[:value]`
+    # pre-populates an existing name.
+    #
+    # @example Basic signature field
+    #   form.fields_sign \
+    #     name: 'user[signature]',
+    #     label: 'Your signature',
+    #     directUploadUrl: glib_direct_uploads_url,
+    #     width: 320,
+    #     height: 160,
+    #     validation: { required: { message: 'add your signature!' } }
+    #
+    # @example Drawn or typed
+    #   form.fields_sign \
+    #     name: 'user[signature]',
+    #     label: 'Your signature',
+    #     typedName: { name: 'user[signature_name]', label: 'Type your full name', placeholder: 'Full name' },
+    #     directUploadUrl: glib_direct_uploads_url,
+    #     width: 320,
+    #     height: 160
+    #
+    # @example Compact signature without validation
+    #   form.fields_sign \
+    #     id: 'signature_compact',
+    #     name: 'user[signature_compact]',
+    #     directUploadUrl: glib_direct_uploads_url,
+    #     width: 220,
+    #     height: 100
+    #
+    # @note The field deliberately has no pre-populated value: a saved
+    #   signature is a signed id that cannot be redrawn from the canvas.
+    #   Resize it via `components_set`/`logics_set` with `width`/`height`.
+    #
+    # @see app/views/json_ui/garage/test_page/fields_sign.json.jbuilder Garage examples
     class Sign < AbstractField
       string :directUploadUrl
       required :directUploadUrl
 
+      # Enables the Type tab. `name` is the param the typed name is submitted
+      # under; `value` pre-populates it; `label`/`placeholder` decorate the
+      # text input in the dialog.
+      hash :typedName, required: [:name], optional: [:value, :label, :placeholder]
+
       # Override
       # Signature field doesn't have default value
       def value(value)

data/app/views/json_ui/garage/test_page/fields_sign.json.jbuilder

@@ -25,6 +25,8 @@ page.body(
             form.fields_sign(
               id: 'signature_main',
               name: 'user[signature]',
+              label: 'Your signature',
+              typedName: { name: 'user[signature_name]', label: 'Type your full name', placeholder: 'Full name' },
               directUploadUrl: glib_direct_uploads_url,
               width: 320,
               height: 160,
@@ -113,7 +115,7 @@ page.body(
                   text: 'Clear value',
                   onClick: ->(action) do
                     action.runMultiple childActions: ->(multiple) do
-                      multiple.components_set targetId: 'signature_main', data: { value: nil }
+                      multiple.components_set targetId: 'signature_main', data: { value: '' }
                       multiple.logics_set targetId: 'signature_status', data: { text: 'Status: cleared' }
                     end
                   end
@@ -137,7 +139,7 @@ page.body(
 
             form.h2 text: 'Edge/advanced'
             form.spacer height: 8
-            form.label text: 'Use a small canvas to test tighter layouts.'
+            form.label text: 'A small, draw-only slot (no typedName, so the dialog has no tabs).'
             form.spacer height: 8
             form.fields_sign(
               id: 'signature_compact',

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glib-web
 version: !ruby/object:Gem::Version
-  version: 6.10.0
+  version: 6.10.1
 platform: ruby
 authors:
 - ''
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-02 00:00:00.000000000 Z
+date: 2026-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activestorage