@seatlayer/js 0.56.0 → 0.57.0

package/README.md

@@ -225,6 +225,7 @@ designer.mount();
 `new SeatingChart(options)` — options: `container` (selector or element, required),
 `event` (key, required), `apiBase?`, `maxSelection?` (default 10),
 `selectedObjects?`, `selectableObjects?`, `numberOfPlacesToSelect?`,
+`selectionValidators?`,
 `onSelectionChange?`, `onSelectionValidityChange?`, `onHold?`,
 `onHoldRestored?`, `onError?`.
 
@@ -232,6 +233,33 @@ Selection methods: `getSelection()`, `selectObjects()`, `deselectObjects()`,
 `clearSelection()`, `selectCategories()`, `deselectCategories()`,
 `setSelectableObjects()`, `setMaxSelection()`, `getSelectionValidity()`.
 
+Selection validators are local buyer guidance and a pre-hold guard. They do not
+replace the server's authoritative availability, ticket-option, or companion
+checks:
+
+```js
+new SeatPicker({
+  container: '#seats',
+  event: 'ev_xxx',
+  selectionValidators: [
+    { type: 'minimumSelectedPlaces', minimum: 2 },
+    { type: 'consecutiveSeats' },
+    { type: 'noOrphanSeats' },
+  ],
+  onSelectionValidityChange: ({ isValid, violations }) => {
+    checkoutButton.disabled = !isValid;
+    warning.textContent = violations.join(', ');
+  },
+});
+```
+
+`consecutiveSeats` means one uninterrupted run in the same row and category.
+`noOrphanSeats` rejects a choice that strands one free seat between unavailable
+neighbours. The full `SeatPicker` disables checkout and shows localized advice;
+bare `SeatingChart.hold()` rejects an invalid selection with
+`code: 'selection_invalid'`. Exact-count failures keep the existing
+`selection_count_mismatch` code.
+
 Lifecycle/hold methods: `render()`, `hold()`, `bestAvailable(qty, categoryKey?)`,
 `resumeHold(holdId)`, `getCurrentHold()`, `releaseLabels(labels)`, `release()`,
 `destroy()`.