edatalia-websign 3.5.4 → 3.5.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,12 @@
3
3
  All significant updates to this project will be documented here.
4
4
  This changelog is public.
5
5
 
6
+ ## [3.5.5] - 2026-06-22
7
+
8
+ ### Fixed
9
+
10
+ - STU signature no longer throws when no device is connected (avoided `setInkingMode` call on a null tablet)
11
+
6
12
  ## [3.5.4] - 2026-06-02
7
13
 
8
14
  ### Fixed
package/README.md CHANGED
@@ -79,7 +79,7 @@ WebSign comes with default parameter values, but it's recommended to set them to
79
79
  mainContainerHeight: "800px",
80
80
  widget: {
81
81
  type: "fixed",
82
- page: 0.
82
+ page: 0,
83
83
  width: 160,
84
84
  height: 100,
85
85
  x: 100,
@@ -251,6 +251,72 @@ wacom: {
251
251
  ```
252
252
 
253
253
  Example: "**varEbp**": "Titulo=Título inicial|||Subtitulo=Subtítulo inicial|||Nombre=Edatalia|||TextoPrevio=Estoy de acuerdo con el documento a firmar",
254
+
255
+ ## 🎨 Toast/Snackbar Customization
256
+
257
+ WebSign shows informational toast messages (snackbars) during the signature process. Some of these messages are shown based on the `debug` configuration parameter.
258
+
259
+ ### Debug Mode and Toast Visibility
260
+
261
+ By default, `debug: false` is set in the configuration. This controls which toast messages are displayed:
262
+
263
+ | Scenario | With `debug: true` | With `debug: false` |
264
+ |----------|-------------------|---------------------|
265
+ | Positioning the signature box in PDF | ✅ Shown | ✅ Always shown (direct usage) |
266
+ | Signature field not found in PDF | ✅ Shown | ✅ Always shown (direct usage) |
267
+ | Perform signature in the box | ✅ Shown | ✅ Always shown (direct usage) |
268
+ | Container 'web-sign' not found | ✅ Shown | ❌ Hidden |
269
+ | Signature too short | ✅ Shown | ❌ Hidden |
270
+ | Device detection messages | ✅ Shown | ❌ Hidden |
271
+ | Certificate selection/processing | ✅ Shown | ❌ Hidden |
272
+ | Error messages | ✅ Shown | ❌ Hidden |
273
+ | Success messages | ✅ Shown | ❌ Hidden |
274
+
275
+ **Note:** The three toasts related to positioning and signature field interaction (positioning the box, field not found, perform signature) always appear regardless of the debug setting because they use the Snackbar directly, not the debug manager.
276
+
277
+ ### Customizing Toast Appearance
278
+
279
+ You can customize the look and feel of the toast notifications via CSS. The toast has the id `websign-snackbar`:
280
+
281
+ ```html
282
+ <style>
283
+ /* Base customization */
284
+ #websign-snackbar {
285
+ border-radius: 12px !important;
286
+ font-family: Arial, sans-serif !important;
287
+ font-weight: bold !important;
288
+ }
289
+
290
+ /* Color by type - add class via JavaScript before WebSign loads */
291
+ #websign-snackbar.info {
292
+ background-color: #0057a2 !important;
293
+ }
294
+ #websign-snackbar.error {
295
+ background-color: #d32f2f !important;
296
+ }
297
+ #websign-snackbar.success {
298
+ background-color: #388e3c !important;
299
+ }
300
+ </style>
301
+ ```
302
+
303
+ Alternatively, you can set a custom class using a data attribute on the `<body>` element (must be set before WebSign loads):
304
+
305
+ ```html
306
+ <body data-websign-snackbar-class="mi-clase-custom">
307
+ <!-- Your content -->
308
+ </body>
309
+
310
+ <style>
311
+ .mi-clase-custom {
312
+ border-radius: 8px;
313
+ background-color: purple !important;
314
+ }
315
+ </style>
316
+ ```
317
+
318
+ The toasts support the following types: `info`, `error`, and `success`.
319
+
254
320
  ## 📡 Events
255
321
 
256
322
 
Binary file