@seatlayer/js 0.56.0 → 0.58.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()`.

package/dist/{channelsMode-CFxx1jp3.d.cts → channelsMode-2z9HBOAX.d.cts}

@@ -1182,6 +1182,15 @@ interface SeatManagerOptions {
     tokenExpiresAt?: number;
     /** Initial mode. Default 'view'. */
     mode?: SeatManagerMode;
+    /**
+     * Which tools the cockpit offers. Default: every tool the token's
+     * capabilities permit. Listing a tool never grants it — capabilities still
+     * gate Categories, Tables and Channels — this only HIDES tools a host has no
+     * use for (a dashboard that does not consume `onSelectionChange` should not
+     * show a Select tab that leads nowhere). Monitor ('view') is always kept:
+     * it is the fail-closed fallback for every refused mode.
+     */
+    tools?: SeatManagerMode[];
     /** Public labels to preselect after live inventory has loaded in Select mode. */
     selectedObjects?: string[];
     /**
@@ -1695,7 +1704,31 @@ declare class SeatManager {
     private filterableSections;
     private applyFilteredSectionCanvas;
     private buildSectionOptions;
+    /**
+     * A tool is offered when the token's capability permits it AND the host has
+     * not hidden it through `options.tools`. No channel-view capability ⇒ the
+     * pill is not rendered at all: a hidden control is honest about authority;
+     * a disabled one advertises it. Authority, not readiness — the Channels
+     * pill must never wait on the lazy module. Monitor is always available; it
+     * is where every refused mode lands.
+     */
+    private toolAvailable;
+    /**
+     * Re-run the availability gate against freshly-loaded facts. `options.mode`
+     * and a deep link are both accepted before the chart exists, so this is where
+     * a now-impossible tool is exchanged for Monitor.
+     */
+    private settleMode;
+    /** Every table object on the chart, across floors. */
+    private tables;
     private paintModeTabs;
+    /**
+     * Every rail opens the same way: what the tool is called, whether it changes
+     * anything (and for whom), and one plain sentence on how to use it. An
+     * operator switching tabs should never have to guess whether a click here
+     * touches live inventory.
+     */
+    private railHeader;
     private paintFollowLiveButton;
     private paintHeatButton;
     private paintMomentumHelp;
@@ -1715,6 +1748,8 @@ declare class SeatManager {
     private renderSelectRail;
     private paintSelectSelection;
     private renderFilterSectionsRail;
+    /** Seats in a chart category that the operator may act on in this mode. */
+    private categorySeats;
     private renderCategoriesRail;
     private paintCategorySelection;
     private renderTablesRail;

package/dist/{channelsMode-CFxx1jp3.d.ts → channelsMode-2z9HBOAX.d.ts}

@@ -1182,6 +1182,15 @@ interface SeatManagerOptions {
     tokenExpiresAt?: number;
     /** Initial mode. Default 'view'. */
     mode?: SeatManagerMode;
+    /**
+     * Which tools the cockpit offers. Default: every tool the token's
+     * capabilities permit. Listing a tool never grants it — capabilities still
+     * gate Categories, Tables and Channels — this only HIDES tools a host has no
+     * use for (a dashboard that does not consume `onSelectionChange` should not
+     * show a Select tab that leads nowhere). Monitor ('view') is always kept:
+     * it is the fail-closed fallback for every refused mode.
+     */
+    tools?: SeatManagerMode[];
     /** Public labels to preselect after live inventory has loaded in Select mode. */
     selectedObjects?: string[];
     /**
@@ -1695,7 +1704,31 @@ declare class SeatManager {
     private filterableSections;
     private applyFilteredSectionCanvas;
     private buildSectionOptions;
+    /**
+     * A tool is offered when the token's capability permits it AND the host has
+     * not hidden it through `options.tools`. No channel-view capability ⇒ the
+     * pill is not rendered at all: a hidden control is honest about authority;
+     * a disabled one advertises it. Authority, not readiness — the Channels
+     * pill must never wait on the lazy module. Monitor is always available; it
+     * is where every refused mode lands.
+     */
+    private toolAvailable;
+    /**
+     * Re-run the availability gate against freshly-loaded facts. `options.mode`
+     * and a deep link are both accepted before the chart exists, so this is where
+     * a now-impossible tool is exchanged for Monitor.
+     */
+    private settleMode;
+    /** Every table object on the chart, across floors. */
+    private tables;
     private paintModeTabs;
+    /**
+     * Every rail opens the same way: what the tool is called, whether it changes
+     * anything (and for whom), and one plain sentence on how to use it. An
+     * operator switching tabs should never have to guess whether a click here
+     * touches live inventory.
+     */
+    private railHeader;
     private paintFollowLiveButton;
     private paintHeatButton;
     private paintMomentumHelp;
@@ -1715,6 +1748,8 @@ declare class SeatManager {
     private renderSelectRail;
     private paintSelectSelection;
     private renderFilterSectionsRail;
+    /** Seats in a chart category that the operator may act on in this mode. */
+    private categorySeats;
     private renderCategoriesRail;
     private paintCategorySelection;
     private renderTablesRail;