glib-web 6.10.0 → 6.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebde832f6f50b0556f57e6b2d716d7315fa01c0def0b75953f8ecf5de60ca547
-  data.tar.gz: 4d217bd99f1a415bca302a08528a1da652788fc5cca031009e132079d2716381
+  metadata.gz: a644c2f81a6edaeaf5bb946f57402098bab2f8e841392a57568a76244856be89
+  data.tar.gz: 03ab9e4058180c9ecd70f14d6a26e488ca56dcdc1388175393f24c8ed5d4176b
 SHA512:
-  metadata.gz: bb08b62b519b2a2cfc7c9b1767fce93c4373b63b43082715211d44d051a58aafa5e94d4d5509fd907e86a2b0f6a4ce9c35ec7842ce29d2d21993cadcdf044796
-  data.tar.gz: 715c3de7e58cfa4a443cc73b75b5c3d6a47bc5e9eff3eeb5cd812d119e0dff76e5c14832163abeb9ce891ea5c12b4922918b6133aa90a2848ff31fa49f40e664
+  metadata.gz: 13fb675a42739c4d67d50b26a359a6cc4136fc695c0f2730d2c21e721b193f955335a39bcab550704bc29cbfb3073569154b7c08b45924de5c576036842fb965
+  data.tar.gz: 1610d45e4b2e60d70475115ca741929585939c847108f46e7b5c209cbc5bff7292720ad85e3eced53f43a43efd2c9bb5756ac3067bab586fe0db17a07177efb0

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,13 +862,88 @@ 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 A saved signature is a signed id that cannot be redrawn from the
+    #   canvas: when a record is re-edited the field pre-populates `value`
+    #   with the existing attachment's signed id (the component renders a
+    #   read-only preview instead of ink). An untouched field therefore
+    #   re-submits that same signed id, so consumers should treat a
+    #   same-signed-id re-attach as "no change". 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
 
+      # URL of an already-attached signature image to display as a read-only
+      # preview (typically `file_url(attachment)` when re-editing a record
+      # that has a drawn signature). Pair with `prop:` so the field also
+      # submits the existing signed id when left untouched.
+      string :fileUrl
+
+      # Enables the Type tab. `value` pre-populates the previously typed
+      # name; `label`/`placeholder` decorate the text input in the dialog.
+      # `name` is still accepted but unused: the typed name is submitted
+      # through the field's own param (single-param contract), and the
+      # server routes it to the name attribute.
+      hash :typedName, optional: [:name, :value, :label, :placeholder]
+
       # Override
-      # Signature field doesn't have default value
-      def value(value)
+      # A stored signature is an attachment -- submit its signed id (mirrors
+      # File#determine_value) so re-editing a signed submission pre-fills the
+      # field with the existing blob's signed id instead of serializing the
+      # whole attachment proxy.
+      def determine_value(context, prop)
+        if (value = context.field_value(prop)).attached?
+          value.signed_id || ''
+        end
       end
     end
 

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

@@ -1,5 +1,8 @@
 json.title 'Test Page (Fields Sign)'
 
+# 60x20 ink stand-in used by the pre-filled examples.
+preview_data_uri = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADwAAAAUCAYAAADRA14pAAAAoklEQVR4nO2XUQrAIAxDcwjvf9WNfQzG1NFqUt1mwL8a8hBtxfYzYXSAaC1glVJK2RohOXAJdCS4FNgCGw0tA7YAjQCXAHsBoqAPbzpwa3A19OkLpjkjsAL66gmWOTOo0gtvOJXe/VcP9JpH3DvmewBLkdeUKfaLD09xqSaid7bkqilrS57pKHJCYmWq9uFZQD2ZLLkeB49ZQO/qybX+w1/XDujJvn2bufeCAAAAAElFTkSuQmCC'
+
 page = json_ui_page json
 
 render 'json_ui/garage/test_page/header', json: json, page: page
@@ -25,6 +28,11 @@ page.body(
             form.fields_sign(
               id: 'signature_main',
               name: 'user[signature]',
+              label: 'Your signature',
+              # Single-param contract: the typed name is submitted through the
+              # field's own param, so typedName carries only the input's
+              # decoration and pre-filled value.
+              typedName: { label: 'Type your full name', placeholder: 'Full name' },
               directUploadUrl: glib_direct_uploads_url,
               width: 320,
               height: 160,
@@ -113,7 +121,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 +145,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',
@@ -146,6 +154,46 @@ page.body(
               width: 220,
               height: 100
             )
+
+            form.spacer height: 12
+            form.hr width: 'matchParent'
+            form.spacer height: 12
+
+            form.h2 text: 'Pre-filled (re-edit)'
+            form.spacer height: 8
+            form.label text: 'A saved signature: value carries the signed id, fileUrl renders the preview.'
+            form.spacer height: 8
+            form.fields_sign(
+              id: 'signature_prefilled',
+              name: 'user[signature_prefilled]',
+              # A stand-in for the signed id the Sign builder derives from
+              # `prop:` on a re-edit (see Sign#determine_value).
+              value: 'prefilled-signed-id',
+              fileUrl: preview_data_uri,
+              typedName: { label: 'Type your full name', placeholder: 'Full name' },
+              directUploadUrl: glib_direct_uploads_url,
+              width: 320,
+              height: 160
+            )
+
+            form.spacer height: 12
+            form.hr width: 'matchParent'
+            form.spacer height: 12
+
+            form.h2 text: 'Read-only (pre-filled)'
+            form.spacer height: 8
+            form.label text: 'A saved signature on a read-only field: the preview shows, the edit overlay does not.'
+            form.spacer height: 8
+            form.fields_sign(
+              id: 'signature_readonly',
+              name: 'user[signature_readonly]',
+              value: 'readonly-signed-id',
+              fileUrl: preview_data_uri,
+              directUploadUrl: glib_direct_uploads_url,
+              width: 320,
+              height: 160,
+              readOnly: true
+            )
           end
         )
       end

metadata

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