@seatlayer/core 0.1.3 → 0.2.0

package/dist/index.d.cts

@@ -425,6 +425,12 @@ interface ISeatmapRenderer {
     setCategoryHighlight?(key: string | null): void;
     /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
     setDimmedSections?(ids: string[] | null): void;
+    /**
+     * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
+     * booked seats render hollow (a non-color cue), so seat state never relies
+     * on hue alone. Off (the default) renders exactly as before.
+     */
+    setColorblindSafe?(on: boolean): void;
     /**
      * Switch the projection. `'flat'` = normal top-down; `'isometric'` = the "3D"
      * view (affine skew/rotate + elevation lift), hit-testing preserved in screen
@@ -541,6 +547,14 @@ declare function chartBounds(doc: ChartDoc): {
     height: number;
 };
 
+declare const MAX_GA_CAPACITY = 100000;
+declare const MAX_EVENT_INVENTORY = 100000;
+/** Stable internal inventory label for one unit of a GA area's capacity. */
+declare function gaUnitLabel(areaId: string, index: number): string;
+declare function gaUnitLabels(area: GAAreaObject): string[];
+declare function gaAreasOf(doc: ChartDoc): GAAreaObject[];
+declare function isGaUnitLabel(label: string): boolean;
+
 /**
  * Section membership + hide/show resolution (Batch 3.3).
  *
@@ -645,6 +659,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private statusById;
     private catColor;
     private theme;
+    /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
+    private colorblind;
+    /** Category order from the doc — the stable index into the CB palette. */
+    private catOrder;
     private selection;
     private selectionRings;
     private hoverRing;
@@ -797,8 +815,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSeats;
     /** A booth renders as a click-selectable rounded block (dims from the doc). */
     private renderBoothUnit;
+    /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
+    private seatBaseColor;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
+    /**
+     * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
+     * render booked seats hollow. Off restores the exact default rendering.
+     */
+    setColorblindSafe(on: boolean): void;
     /**
      * Dim the seats of these section/zone ids (organizer manager use) so held-back
      * inventory is visually distinct on the canvas without hiding it. `null`/empty
@@ -930,7 +955,7 @@ interface PickerSeat {
 }
 interface HoldConflict {
     label: string;
-    reason: string;
+    status: string;
 }
 /** An open hold — its id, the labels it covers, and the server's expiry time (ms epoch). */
 interface HoldInfo {
@@ -939,6 +964,8 @@ interface HoldInfo {
     expiresAt: number;
     /** The held seats with their chosen ticket tier — what the host books against. */
     seats: PickerSeat[];
+    /** Server-authoritative commercial line items, including GA units and resolved prices. */
+    items?: HoldServerItem[];
 }
 /** One category's slice of a section (dot + price + count) for the summary card. */
 interface SectionCategory {
@@ -970,6 +997,21 @@ interface SectionSummary {
 interface HoldResponse {
     holdId: string;
     expiresAt: number;
+    items?: HoldServerItem[];
+}
+interface HoldServerItem {
+    label: string;
+    objectId: string;
+    objectType: 'seat' | 'booth' | 'ga';
+    categoryKey: string;
+    tierId: string | null;
+    unitPrice: number;
+    currency: string;
+    quantity?: number;
+}
+interface HoldSelectionRequest {
+    label: string;
+    tierId?: string | null;
 }
 interface BestAvailableResponse extends HoldResponse {
     labels: string[];
@@ -985,13 +1027,14 @@ interface PickerTransport {
             venue?: string | null;
             startsAt?: number | null;
             currency?: string;
+            mode?: string;
         };
     }>;
     objects(key: string): Promise<{
         seats: Record<string, string>;
         hidden?: string[];
     }>;
-    hold(key: string, labels: string[]): Promise<HoldResponse>;
+    hold(key: string, selections: HoldSelectionRequest[], ttlMs?: number, replaceHoldId?: string): Promise<HoldResponse>;
     bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResponse>;
     release(key: string, labels: string[], holdId: string): Promise<unknown>;
     /** Optional — the SDK omits booking (it hands the holdId to the host page). */
@@ -1019,6 +1062,12 @@ interface PickerCallbacks extends RendererCallbacks {
     onSectionFocus?: (summary: SectionSummary | null) => void;
     /** A deck was tapped in the 3D all-floors overview — host enters that floor in 2D. */
     onDeckTap?: (floorId: string) => void;
+    /**
+     * Non-blocking selection advice (localized): currently the orphan-seat hint —
+     * the selection would strand a single free seat between unavailable
+     * neighbors. `null` clears a previously shown hint. Never prevents anything.
+     */
+    onHint?: (message: string | null) => void;
     onError?: (err: unknown) => void;
 }
 interface PickerOptions extends PickerCallbacks {
@@ -1031,6 +1080,8 @@ interface PickerOptions extends PickerCallbacks {
     currency?: string;
     /** Flash a pulse when a seat we didn't touch goes free→taken (live-activity cue). */
     flashOnLiveChange?: boolean;
+    /** Start in colorblind-safe rendering (Okabe-Ito hues + hollow booked seats). */
+    colorblindSafe?: boolean;
 }
 declare class PickerController {
     private readonly opts;
@@ -1054,6 +1105,8 @@ declare class PickerController {
     private attempt;
     private closed;
     private hold_;
+    private liveStatuses;
+    private currency;
     private expiryTimer;
     constructor(options: PickerOptions);
     get doc(): ChartDoc | null;
@@ -1073,6 +1126,8 @@ declare class PickerController {
         venue?: string | null;
         startsAt?: number | null;
         currency?: string;
+        /** 'test' ⇒ sandbox event (hosts show a TEST MODE ribbon). */
+        mode?: string;
     } | null>;
     getSelection(): PickerSeat[];
     clearSelection(): void;
@@ -1083,7 +1138,23 @@ declare class PickerController {
      * re-throws so the caller can choose the banner copy. Returns null only when
      * there's nothing to hold.
      */
-    hold(labelsArg?: string[]): Promise<HoldInfo | null>;
+    hold(labelsArg?: string[], ttlMs?: number): Promise<HoldInfo | null>;
+    /** Public GA inventory derived from the live synthetic-unit status stream. */
+    getGAAreas(): {
+        id: string;
+        label: string;
+        capacity: number;
+        available: number;
+        categoryKey: string;
+        price: number;
+        currency: string;
+        tiers?: CategoryTier[];
+    }[];
+    /** Select a quantity from one GA area and hold it atomically. */
+    holdGA(areaId: string, qty: number, options?: {
+        tierId?: string | null;
+        ttlMs?: number;
+    }): Promise<HoldInfo | null>;
     /** Server-picks `qty` best free seats and holds them atomically. Throws on failure. */
     bestAvailable(qty: number, categoryKey?: string): Promise<HoldInfo | null>;
     /**
@@ -1162,14 +1233,26 @@ declare class PickerController {
     /** PickerSeats (with chosen tier) for a set of held labels. */
     private seatsForLabels;
     private emitSelectionChange;
+    /** Whether the last emitted hint was non-null (avoids clearing repeatedly). */
+    private hintShown;
+    /**
+     * Orphan-seat advice on manual selection: when the buyer's current picks
+     * strand one (or more) single free seats between unavailable same-row
+     * neighbors, surface a localized, non-blocking hint. Cleared (null) as soon
+     * as the selection stops stranding anyone.
+     */
+    private emitOrphanHint;
+    /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
+    setColorblindSafe(on: boolean): void;
     private emitError;
     private holdCovers;
     private handle409Conflicts;
     /** Set the open hold + (re)arm the server-authoritative expiry timer. */
     private setHold;
     private clearHold;
-    private onHoldExpired;
+    private expireActiveHold;
     private applySeatsMap;
+    private clearBookedHoldIfSettled;
     private resnapshot;
     private connect;
     private scheduleReconnect;
@@ -1247,4 +1330,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type ISeatmapRenderer, type Locale, type LodRung, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, getLocale, hiddenObjectIds, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };
+export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };

package/dist/index.d.ts

@@ -425,6 +425,12 @@ interface ISeatmapRenderer {
     setCategoryHighlight?(key: string | null): void;
     /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
     setDimmedSections?(ids: string[] | null): void;
+    /**
+     * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
+     * booked seats render hollow (a non-color cue), so seat state never relies
+     * on hue alone. Off (the default) renders exactly as before.
+     */
+    setColorblindSafe?(on: boolean): void;
     /**
      * Switch the projection. `'flat'` = normal top-down; `'isometric'` = the "3D"
      * view (affine skew/rotate + elevation lift), hit-testing preserved in screen
@@ -541,6 +547,14 @@ declare function chartBounds(doc: ChartDoc): {
     height: number;
 };
 
+declare const MAX_GA_CAPACITY = 100000;
+declare const MAX_EVENT_INVENTORY = 100000;
+/** Stable internal inventory label for one unit of a GA area's capacity. */
+declare function gaUnitLabel(areaId: string, index: number): string;
+declare function gaUnitLabels(area: GAAreaObject): string[];
+declare function gaAreasOf(doc: ChartDoc): GAAreaObject[];
+declare function isGaUnitLabel(label: string): boolean;
+
 /**
  * Section membership + hide/show resolution (Batch 3.3).
  *
@@ -645,6 +659,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private statusById;
     private catColor;
     private theme;
+    /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
+    private colorblind;
+    /** Category order from the doc — the stable index into the CB palette. */
+    private catOrder;
     private selection;
     private selectionRings;
     private hoverRing;
@@ -797,8 +815,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSeats;
     /** A booth renders as a click-selectable rounded block (dims from the doc). */
     private renderBoothUnit;
+    /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
+    private seatBaseColor;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
+    /**
+     * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
+     * render booked seats hollow. Off restores the exact default rendering.
+     */
+    setColorblindSafe(on: boolean): void;
     /**
      * Dim the seats of these section/zone ids (organizer manager use) so held-back
      * inventory is visually distinct on the canvas without hiding it. `null`/empty
@@ -930,7 +955,7 @@ interface PickerSeat {
 }
 interface HoldConflict {
     label: string;
-    reason: string;
+    status: string;
 }
 /** An open hold — its id, the labels it covers, and the server's expiry time (ms epoch). */
 interface HoldInfo {
@@ -939,6 +964,8 @@ interface HoldInfo {
     expiresAt: number;
     /** The held seats with their chosen ticket tier — what the host books against. */
     seats: PickerSeat[];
+    /** Server-authoritative commercial line items, including GA units and resolved prices. */
+    items?: HoldServerItem[];
 }
 /** One category's slice of a section (dot + price + count) for the summary card. */
 interface SectionCategory {
@@ -970,6 +997,21 @@ interface SectionSummary {
 interface HoldResponse {
     holdId: string;
     expiresAt: number;
+    items?: HoldServerItem[];
+}
+interface HoldServerItem {
+    label: string;
+    objectId: string;
+    objectType: 'seat' | 'booth' | 'ga';
+    categoryKey: string;
+    tierId: string | null;
+    unitPrice: number;
+    currency: string;
+    quantity?: number;
+}
+interface HoldSelectionRequest {
+    label: string;
+    tierId?: string | null;
 }
 interface BestAvailableResponse extends HoldResponse {
     labels: string[];
@@ -985,13 +1027,14 @@ interface PickerTransport {
             venue?: string | null;
             startsAt?: number | null;
             currency?: string;
+            mode?: string;
         };
     }>;
     objects(key: string): Promise<{
         seats: Record<string, string>;
         hidden?: string[];
     }>;
-    hold(key: string, labels: string[]): Promise<HoldResponse>;
+    hold(key: string, selections: HoldSelectionRequest[], ttlMs?: number, replaceHoldId?: string): Promise<HoldResponse>;
     bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResponse>;
     release(key: string, labels: string[], holdId: string): Promise<unknown>;
     /** Optional — the SDK omits booking (it hands the holdId to the host page). */
@@ -1019,6 +1062,12 @@ interface PickerCallbacks extends RendererCallbacks {
     onSectionFocus?: (summary: SectionSummary | null) => void;
     /** A deck was tapped in the 3D all-floors overview — host enters that floor in 2D. */
     onDeckTap?: (floorId: string) => void;
+    /**
+     * Non-blocking selection advice (localized): currently the orphan-seat hint —
+     * the selection would strand a single free seat between unavailable
+     * neighbors. `null` clears a previously shown hint. Never prevents anything.
+     */
+    onHint?: (message: string | null) => void;
     onError?: (err: unknown) => void;
 }
 interface PickerOptions extends PickerCallbacks {
@@ -1031,6 +1080,8 @@ interface PickerOptions extends PickerCallbacks {
     currency?: string;
     /** Flash a pulse when a seat we didn't touch goes free→taken (live-activity cue). */
     flashOnLiveChange?: boolean;
+    /** Start in colorblind-safe rendering (Okabe-Ito hues + hollow booked seats). */
+    colorblindSafe?: boolean;
 }
 declare class PickerController {
     private readonly opts;
@@ -1054,6 +1105,8 @@ declare class PickerController {
     private attempt;
     private closed;
     private hold_;
+    private liveStatuses;
+    private currency;
     private expiryTimer;
     constructor(options: PickerOptions);
     get doc(): ChartDoc | null;
@@ -1073,6 +1126,8 @@ declare class PickerController {
         venue?: string | null;
         startsAt?: number | null;
         currency?: string;
+        /** 'test' ⇒ sandbox event (hosts show a TEST MODE ribbon). */
+        mode?: string;
     } | null>;
     getSelection(): PickerSeat[];
     clearSelection(): void;
@@ -1083,7 +1138,23 @@ declare class PickerController {
      * re-throws so the caller can choose the banner copy. Returns null only when
      * there's nothing to hold.
      */
-    hold(labelsArg?: string[]): Promise<HoldInfo | null>;
+    hold(labelsArg?: string[], ttlMs?: number): Promise<HoldInfo | null>;
+    /** Public GA inventory derived from the live synthetic-unit status stream. */
+    getGAAreas(): {
+        id: string;
+        label: string;
+        capacity: number;
+        available: number;
+        categoryKey: string;
+        price: number;
+        currency: string;
+        tiers?: CategoryTier[];
+    }[];
+    /** Select a quantity from one GA area and hold it atomically. */
+    holdGA(areaId: string, qty: number, options?: {
+        tierId?: string | null;
+        ttlMs?: number;
+    }): Promise<HoldInfo | null>;
     /** Server-picks `qty` best free seats and holds them atomically. Throws on failure. */
     bestAvailable(qty: number, categoryKey?: string): Promise<HoldInfo | null>;
     /**
@@ -1162,14 +1233,26 @@ declare class PickerController {
     /** PickerSeats (with chosen tier) for a set of held labels. */
     private seatsForLabels;
     private emitSelectionChange;
+    /** Whether the last emitted hint was non-null (avoids clearing repeatedly). */
+    private hintShown;
+    /**
+     * Orphan-seat advice on manual selection: when the buyer's current picks
+     * strand one (or more) single free seats between unavailable same-row
+     * neighbors, surface a localized, non-blocking hint. Cleared (null) as soon
+     * as the selection stops stranding anyone.
+     */
+    private emitOrphanHint;
+    /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
+    setColorblindSafe(on: boolean): void;
     private emitError;
     private holdCovers;
     private handle409Conflicts;
     /** Set the open hold + (re)arm the server-authoritative expiry timer. */
     private setHold;
     private clearHold;
-    private onHoldExpired;
+    private expireActiveHold;
     private applySeatsMap;
+    private clearBookedHoldIfSettled;
     private resnapshot;
     private connect;
     private scheduleReconnect;
@@ -1247,4 +1330,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type ISeatmapRenderer, type Locale, type LodRung, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, getLocale, hiddenObjectIds, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };
+export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };