glib-web 6.10.1 → 6.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50357c0c3002870707a68fad3a956248fb13cfb638395068ab970c0a7ee930ed
-  data.tar.gz: d04d1755a167f4d46c18aec66c958050c324192ee847b0ab0ed930ffd7ab2f7e
+  metadata.gz: a644c2f81a6edaeaf5bb946f57402098bab2f8e841392a57568a76244856be89
+  data.tar.gz: 03ab9e4058180c9ecd70f14d6a26e488ca56dcdc1388175393f24c8ed5d4176b
 SHA512:
-  metadata.gz: b72912d4e0dbe1fceb6d2180c292c390567a1c0d5ccc8e5f80bd20fa579d48b87cb0455a7ea3849469e24fbdb6ca90d5059e4c2799de0e0ab0dd15aa3c1e9430
-  data.tar.gz: fd855eb185f11b6d6e73becf6ab91ef1de85c78e957ae653e6f7a6e6bc9cb07eaa869f5f01142d8e73f674553dc621c4ebc517ce1b8bb4f76359a1571ca5bb60
+  metadata.gz: 13fb675a42739c4d67d50b26a359a6cc4136fc695c0f2730d2c21e721b193f955335a39bcab550704bc29cbfb3073569154b7c08b45924de5c576036842fb965
+  data.tar.gz: 1610d45e4b2e60d70475115ca741929585939c847108f46e7b5c209cbc5bff7292720ad85e3eced53f43a43efd2c9bb5756ac3067bab586fe0db17a07177efb0

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

@@ -909,23 +909,41 @@ class Glib::JsonUi::ViewBuilder
     #     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`.
+    # @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
 
-      # 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]
+      # 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
@@ -26,7 +29,10 @@ page.body(
               id: 'signature_main',
               name: 'user[signature]',
               label: 'Your signature',
-              typedName: { name: 'user[signature_name]', label: 'Type your full name', placeholder: 'Full name' },
+              # 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,
@@ -148,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.1
+  version: 6.10.2
 platform: ruby
 authors:
 - ''
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-05 00:00:00.000000000 Z
+date: 2026-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activestorage