@almadar/patterns 2.48.0 → 2.50.0

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.0.0",
3
- "exportedAt": "2026-06-17T11:00:54.689Z",
3
+ "exportedAt": "2026-06-18T10:28:38.516Z",
4
4
  "patterns": {
5
5
  "entity-table": {
6
6
  "type": "entity-table",
@@ -7067,6 +7067,12 @@
7067
7067
  ],
7068
7068
  "description": "Declarative event key emitted on click for trait dispatch",
7069
7069
  "kind": "event"
7070
+ },
7071
+ "loading": {
7072
+ "types": [
7073
+ "boolean"
7074
+ ],
7075
+ "description": "Shows a skeleton/spinner overlay while true."
7070
7076
  }
7071
7077
  }
7072
7078
  },
@@ -7215,6 +7221,12 @@
7215
7221
  "lg"
7216
7222
  ],
7217
7223
  "default": "md"
7224
+ },
7225
+ "overlay": {
7226
+ "types": [
7227
+ "boolean"
7228
+ ],
7229
+ "description": "Renders a centered overlay backdrop instead of inline."
7218
7230
  }
7219
7231
  }
7220
7232
  },
@@ -7284,6 +7296,18 @@
7284
7296
  "textarea"
7285
7297
  ]
7286
7298
  },
7299
+ "label": {
7300
+ "types": [
7301
+ "string"
7302
+ ],
7303
+ "description": "label prop"
7304
+ },
7305
+ "helperText": {
7306
+ "types": [
7307
+ "string"
7308
+ ],
7309
+ "description": "helperText prop"
7310
+ },
7287
7311
  "error": {
7288
7312
  "types": [
7289
7313
  "string"
@@ -7443,8 +7467,7 @@
7443
7467
  "types": [
7444
7468
  "array"
7445
7469
  ],
7446
- "description": "Select options",
7447
- "required": true,
7470
+ "description": "Select options (flat list)",
7448
7471
  "items": {
7449
7472
  "types": [
7450
7473
  "object"
@@ -7467,6 +7490,54 @@
7467
7490
  ]
7468
7491
  }
7469
7492
  },
7493
+ "groups": {
7494
+ "types": [
7495
+ "array"
7496
+ ],
7497
+ "description": "Grouped options — rendered as <optgroup> in native mode, sections in rich mode.",
7498
+ "items": {
7499
+ "types": [
7500
+ "object"
7501
+ ],
7502
+ "properties": {
7503
+ "label": {
7504
+ "types": [
7505
+ "string"
7506
+ ]
7507
+ },
7508
+ "options": {
7509
+ "types": [
7510
+ "array"
7511
+ ],
7512
+ "items": {
7513
+ "types": [
7514
+ "object"
7515
+ ],
7516
+ "properties": {
7517
+ "value": {
7518
+ "types": [
7519
+ "string"
7520
+ ]
7521
+ },
7522
+ "label": {
7523
+ "types": [
7524
+ "string"
7525
+ ]
7526
+ }
7527
+ },
7528
+ "required": [
7529
+ "value",
7530
+ "label"
7531
+ ]
7532
+ }
7533
+ }
7534
+ },
7535
+ "required": [
7536
+ "label",
7537
+ "options"
7538
+ ]
7539
+ }
7540
+ },
7470
7541
  "placeholder": {
7471
7542
  "types": [
7472
7543
  "string"
@@ -7475,9 +7546,15 @@
7475
7546
  },
7476
7547
  "value": {
7477
7548
  "types": [
7478
- "string"
7549
+ "string",
7550
+ "array"
7479
7551
  ],
7480
- "description": "Current value"
7552
+ "description": "Current value (string for single, string[] for multiple)",
7553
+ "items": {
7554
+ "types": [
7555
+ "string"
7556
+ ]
7557
+ }
7481
7558
  },
7482
7559
  "action": {
7483
7560
  "types": [
@@ -7492,12 +7569,37 @@
7492
7569
  ],
7493
7570
  "description": "Error message"
7494
7571
  },
7572
+ "multiple": {
7573
+ "types": [
7574
+ "boolean"
7575
+ ],
7576
+ "description": "Allow selecting multiple values — activates the rich dropdown."
7577
+ },
7578
+ "searchable": {
7579
+ "types": [
7580
+ "boolean"
7581
+ ],
7582
+ "description": "Show a search input inside the dropdown — activates the rich dropdown."
7583
+ },
7584
+ "clearable": {
7585
+ "types": [
7586
+ "boolean"
7587
+ ],
7588
+ "description": "Show a clear button when a value is selected."
7589
+ },
7495
7590
  "onChange": {
7496
7591
  "types": [
7497
7592
  "function",
7498
7593
  "string"
7499
7594
  ],
7500
- "description": "onChange handler or declarative event key for trait dispatch"
7595
+ "description": "onChange handler (native ChangeEvent) or declarative event key for trait dispatch"
7596
+ },
7597
+ "onValueChange": {
7598
+ "types": [
7599
+ "function",
7600
+ "string"
7601
+ ],
7602
+ "description": "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
7501
7603
  }
7502
7604
  }
7503
7605
  },
@@ -8071,6 +8173,18 @@
8071
8173
  "string"
8072
8174
  ],
8073
8175
  "description": "Additional CSS classes"
8176
+ },
8177
+ "header": {
8178
+ "types": [
8179
+ "node"
8180
+ ],
8181
+ "description": "Optional slot rendered above the items."
8182
+ },
8183
+ "footer": {
8184
+ "types": [
8185
+ "node"
8186
+ ],
8187
+ "description": "Optional slot rendered below the items."
8074
8188
  }
8075
8189
  }
8076
8190
  },
@@ -44662,25 +44776,29 @@
44662
44776
  "types": [
44663
44777
  "object"
44664
44778
  ],
44665
- "description": "Asset loader instance (uses global singleton if not provided)"
44779
+ "description": "Asset loader instance (uses global singleton if not provided)",
44780
+ "nonAuthorable": true
44666
44781
  },
44667
44782
  "tileRenderer": {
44668
44783
  "types": [
44669
44784
  "object"
44670
44785
  ],
44671
- "description": "Custom tile renderer component"
44786
+ "description": "Custom tile renderer component",
44787
+ "nonAuthorable": true
44672
44788
  },
44673
44789
  "unitRenderer": {
44674
44790
  "types": [
44675
44791
  "object"
44676
44792
  ],
44677
- "description": "Custom unit renderer component"
44793
+ "description": "Custom unit renderer component",
44794
+ "nonAuthorable": true
44678
44795
  },
44679
44796
  "featureRenderer": {
44680
44797
  "types": [
44681
44798
  "object"
44682
44799
  ],
44683
- "description": "Custom feature renderer component"
44800
+ "description": "Custom feature renderer component",
44801
+ "nonAuthorable": true
44684
44802
  },
44685
44803
  "preloadAssets": {
44686
44804
  "types": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.0.0",
3
- "exportedAt": "2026-06-17T11:00:54.689Z",
3
+ "exportedAt": "2026-06-18T10:28:38.516Z",
4
4
  "patterns": {
5
5
  "entity-table": {
6
6
  "type": "entity-table",
@@ -7067,6 +7067,12 @@
7067
7067
  ],
7068
7068
  "description": "Declarative event key emitted on click for trait dispatch",
7069
7069
  "kind": "event"
7070
+ },
7071
+ "loading": {
7072
+ "types": [
7073
+ "boolean"
7074
+ ],
7075
+ "description": "Shows a skeleton/spinner overlay while true."
7070
7076
  }
7071
7077
  }
7072
7078
  },
@@ -7215,6 +7221,12 @@
7215
7221
  "lg"
7216
7222
  ],
7217
7223
  "default": "md"
7224
+ },
7225
+ "overlay": {
7226
+ "types": [
7227
+ "boolean"
7228
+ ],
7229
+ "description": "Renders a centered overlay backdrop instead of inline."
7218
7230
  }
7219
7231
  }
7220
7232
  },
@@ -7284,6 +7296,18 @@
7284
7296
  "textarea"
7285
7297
  ]
7286
7298
  },
7299
+ "label": {
7300
+ "types": [
7301
+ "string"
7302
+ ],
7303
+ "description": "label prop"
7304
+ },
7305
+ "helperText": {
7306
+ "types": [
7307
+ "string"
7308
+ ],
7309
+ "description": "helperText prop"
7310
+ },
7287
7311
  "error": {
7288
7312
  "types": [
7289
7313
  "string"
@@ -7443,8 +7467,7 @@
7443
7467
  "types": [
7444
7468
  "array"
7445
7469
  ],
7446
- "description": "Select options",
7447
- "required": true,
7470
+ "description": "Select options (flat list)",
7448
7471
  "items": {
7449
7472
  "types": [
7450
7473
  "object"
@@ -7467,6 +7490,54 @@
7467
7490
  ]
7468
7491
  }
7469
7492
  },
7493
+ "groups": {
7494
+ "types": [
7495
+ "array"
7496
+ ],
7497
+ "description": "Grouped options — rendered as <optgroup> in native mode, sections in rich mode.",
7498
+ "items": {
7499
+ "types": [
7500
+ "object"
7501
+ ],
7502
+ "properties": {
7503
+ "label": {
7504
+ "types": [
7505
+ "string"
7506
+ ]
7507
+ },
7508
+ "options": {
7509
+ "types": [
7510
+ "array"
7511
+ ],
7512
+ "items": {
7513
+ "types": [
7514
+ "object"
7515
+ ],
7516
+ "properties": {
7517
+ "value": {
7518
+ "types": [
7519
+ "string"
7520
+ ]
7521
+ },
7522
+ "label": {
7523
+ "types": [
7524
+ "string"
7525
+ ]
7526
+ }
7527
+ },
7528
+ "required": [
7529
+ "value",
7530
+ "label"
7531
+ ]
7532
+ }
7533
+ }
7534
+ },
7535
+ "required": [
7536
+ "label",
7537
+ "options"
7538
+ ]
7539
+ }
7540
+ },
7470
7541
  "placeholder": {
7471
7542
  "types": [
7472
7543
  "string"
@@ -7475,9 +7546,15 @@
7475
7546
  },
7476
7547
  "value": {
7477
7548
  "types": [
7478
- "string"
7549
+ "string",
7550
+ "array"
7479
7551
  ],
7480
- "description": "Current value"
7552
+ "description": "Current value (string for single, string[] for multiple)",
7553
+ "items": {
7554
+ "types": [
7555
+ "string"
7556
+ ]
7557
+ }
7481
7558
  },
7482
7559
  "action": {
7483
7560
  "types": [
@@ -7492,12 +7569,37 @@
7492
7569
  ],
7493
7570
  "description": "Error message"
7494
7571
  },
7572
+ "multiple": {
7573
+ "types": [
7574
+ "boolean"
7575
+ ],
7576
+ "description": "Allow selecting multiple values — activates the rich dropdown."
7577
+ },
7578
+ "searchable": {
7579
+ "types": [
7580
+ "boolean"
7581
+ ],
7582
+ "description": "Show a search input inside the dropdown — activates the rich dropdown."
7583
+ },
7584
+ "clearable": {
7585
+ "types": [
7586
+ "boolean"
7587
+ ],
7588
+ "description": "Show a clear button when a value is selected."
7589
+ },
7495
7590
  "onChange": {
7496
7591
  "types": [
7497
7592
  "function",
7498
7593
  "string"
7499
7594
  ],
7500
- "description": "onChange handler or declarative event key for trait dispatch"
7595
+ "description": "onChange handler (native ChangeEvent) or declarative event key for trait dispatch"
7596
+ },
7597
+ "onValueChange": {
7598
+ "types": [
7599
+ "function",
7600
+ "string"
7601
+ ],
7602
+ "description": "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
7501
7603
  }
7502
7604
  }
7503
7605
  },
@@ -8071,6 +8173,18 @@
8071
8173
  "string"
8072
8174
  ],
8073
8175
  "description": "Additional CSS classes"
8176
+ },
8177
+ "header": {
8178
+ "types": [
8179
+ "node"
8180
+ ],
8181
+ "description": "Optional slot rendered above the items."
8182
+ },
8183
+ "footer": {
8184
+ "types": [
8185
+ "node"
8186
+ ],
8187
+ "description": "Optional slot rendered below the items."
8074
8188
  }
8075
8189
  }
8076
8190
  },
@@ -44662,25 +44776,29 @@
44662
44776
  "types": [
44663
44777
  "object"
44664
44778
  ],
44665
- "description": "Asset loader instance (uses global singleton if not provided)"
44779
+ "description": "Asset loader instance (uses global singleton if not provided)",
44780
+ "nonAuthorable": true
44666
44781
  },
44667
44782
  "tileRenderer": {
44668
44783
  "types": [
44669
44784
  "object"
44670
44785
  ],
44671
- "description": "Custom tile renderer component"
44786
+ "description": "Custom tile renderer component",
44787
+ "nonAuthorable": true
44672
44788
  },
44673
44789
  "unitRenderer": {
44674
44790
  "types": [
44675
44791
  "object"
44676
44792
  ],
44677
- "description": "Custom unit renderer component"
44793
+ "description": "Custom unit renderer component",
44794
+ "nonAuthorable": true
44678
44795
  },
44679
44796
  "featureRenderer": {
44680
44797
  "types": [
44681
44798
  "object"
44682
44799
  ],
44683
- "description": "Custom feature renderer component"
44800
+ "description": "Custom feature renderer component",
44801
+ "nonAuthorable": true
44684
44802
  },
44685
44803
  "preloadAssets": {
44686
44804
  "types": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@almadar/patterns",
3
- "version": "2.48.0",
3
+ "version": "2.50.0",
4
4
  "description": "Pattern registry and component mappings for Almadar",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",