@wix/auto_sdk_seatings_seating-reservation 1.0.12 → 1.0.14

package/build/es/index.typings.d.mts

@@ -1,132 +1,139 @@
 import { NonNullablePaths } from '@wix/sdk-types';
 
+/**
+ * A seating reservation represents a booking for one or more places within a seating plan.
+ *
+ * Seating reservations track specific seat assignments or area capacity allocations for events. Each reservation can include multiple places across different sections of a venue, with individual capacity requirements for each place. The system maintains referential integrity through both internal Wix identifiers and external system references, enabling seamless integration with third-party ticketing platforms.
+ */
 interface SeatingReservation {
     /**
-     * The id of the reservation
+     * Reservation ID.
      * @format GUID
      * @readonly
      */
     _id?: string | null;
     /**
-     * The seating plan id
+     * Seating plan ID.
      * @format GUID
      * @readonly
      */
     seatingPlanId?: string | null;
     /**
-     * The external seating plan id
+     * External seating plan ID used for integration with third-party venue systems.
      * @minLength 1
      * @maxLength 100
      * @readonly
      */
     externalSeatingPlanId?: string | null;
     /**
-     * Reserved places
+     * Places reserved in this reservation. Each place can have its own capacity requirements.
      * @minSize 1
      * @maxSize 100
      */
     reservedPlaces?: PlaceReservation[];
     /**
-     * A client defined external id for cross referencing.
-     * Can reference external entities.
-     * Format: "{fqdn}:{entity guid}"
+     * External reference ID for cross-system integration. Format: `{fqdn}:{entity guid}`. For example, `wix.events.v1.ticket:12345678-1234-1234-1234-123456789012`.
      * @minLength 1
      * @maxLength 100
      */
     externalId?: string | null;
     /**
-     * Revision number, which increments by 1 each time the reservation is updated.
+     * Revision number, which increments by 1 each time the reservation is updated. To prevent conflicting changes, the current revision must be passed when updating the reservation. Ignored when creating a reservation.
      * @readonly
      */
     revision?: string | null;
 }
+/** Individual place reservation within a seating arrangement. */
 interface PlaceReservation {
     /**
-     * The place id.
+     * Place ID. For example, `A1-1-5` for section A, row 1, seat 5.
      * @minLength 5
      * @maxLength 11
      */
     _id?: string;
     /**
-     * Number of places in the spot. If not provided - defaults to 1.
-     * Used to reserve for more that one place in areas.
+     * Number of people to be seated at this place. Used for area seating where multiple guests can occupy a single reservable location.
+     *
+     * Default: `1`
      * @min 1
      * @max 50
      */
     capacity?: number | null;
     /**
-     * Optional section label.
+     * Section name within the venue. For example, `Orchestra` or `Balcony`.
      * @readonly
      */
     sectionLabel?: string | null;
     /**
-     * Area label.
+     * Area name within a section. Used for general admission or standing areas.
      * @readonly
      */
     areaLabel?: string | null;
     /**
-     * Table label.
+     * Table identifier for table-based seating arrangements.
      * @readonly
      */
     tableLabel?: string | null;
     /**
-     * Row label.
+     * Row identifier within a section or area.
      * @readonly
      */
     rowLabel?: string | null;
     /**
-     * Seat label in a row or table.
+     * Individual seat identifier within a row or at a table.
      * @readonly
      */
     seatLabel?: string | null;
 }
+/** Triggers when seating plan category summaries are updated. */
 interface SeatingPlanCategoriesSummaryUpdated {
     /**
-     * Seating plan id
+     * Seating plan ID.
      * @format GUID
      */
     seatingPlanId?: string;
-    /** External seating plan id */
+    /** External seating plan ID. */
     externalSeatingPlanId?: string | null;
     /**
-     * Ticket counts by category
+     * Updated category capacity and reservation counts.
      * @maxSize 100
      */
     categories?: CategoryDetails[];
     /**
-     * Summary revision.
+     * Summary revision number for cache invalidation.
      * @readonly
      */
     revision?: string | null;
 }
+/** Category capacity and reservation summary. */
 interface CategoryDetails {
     /**
-     * Seating plan id
+     * Seating Plan ID.
      * @format GUID
      * @readonly
      */
     seatingPlanId?: string | null;
     /**
-     * External seating plan id
+     * External Seating Plan ID used for integration with third-party systems.
      * @minLength 1
      * @maxLength 100
      * @readonly
      */
     externalSeatingPlanId?: string | null;
     /**
-     * External category id
+     * External Category ID used for mapping to venue-specific category names. For example, `VIP` or `ORCHESTRA`.
      * @minLength 1
      * @maxLength 100
      * @readonly
      */
     externalCategoryId?: string | null;
     /**
-     * Total capacity in the category
+     * Total seating capacity available in category.
      * @readonly
      */
     totalCapacity?: number | null;
     /**
-     * Already reserved capacity
+     * Number of seats currently reserved in category.
      * @readonly
      */
     reserved?: number | null;
@@ -246,57 +253,65 @@ interface CustomTag {
      */
     tag?: string;
 }
+/** Request to create a seating reservation. */
 interface CreateSeatingReservationRequest {
-    /** A reservation to create */
+    /** Reservation to create. */
     reservation?: SeatingReservation;
 }
+/** Response after creating a seating reservation. */
 interface CreateSeatingReservationResponse {
-    /** Created reservation */
+    /** Created reservation. */
     reservation?: SeatingReservation;
 }
+/** Details about specific places, used for error reporting. */
 interface Places {
     /**
-     * Places
+     * List of place identifiers. For example, `A1-1-5` or `VIP-12`.
      * @minSize 1
      * @maxSize 100
      */
     places?: string[];
 }
+/** Details about places that are unavailable, including capacity conflicts. */
 interface UnavailablePlaces {
     /**
-     * Places that cannot be reserved
+     * List of place identifiers that are unavailable. For example, `A1-1-5` or `VIP-12`.
      * @minSize 1
      * @maxSize 100
      */
     unavailablePlaces?: string[];
     /**
-     * Reservation error details
+     * Detailed capacity information for each unavailable place.
      * @minSize 1
      * @maxSize 100
      */
     reservationErrorDetails?: ReservationErrorDetails[];
 }
+/** Capacity conflict details for a given place. */
 interface ReservationErrorDetails {
-    /** Place */
+    /** ID of the place with a capacity conflict. */
     _id?: string;
-    /** Available capacity */
+    /** Currently available capacity at this place. */
     available?: number;
-    /** Requested capacity */
+    /** Requested capacity that exceeds the available capacity. */
     requested?: number;
 }
+/** Request to retrieve a specific seating reservation. */
 interface GetReservationRequest {
     /**
-     * The id of the reservation to return
+     * Reservation ID.
      * @format GUID
      */
     _id: string | null;
 }
+/** Response containing the requested seating reservation. */
 interface GetReservationResponse {
-    /** Created reservation */
+    /** Retrieved reservation. */
     reservation?: SeatingReservation;
 }
+/** Request to query seating reservations. */
 interface QuerySeatingReservationRequest {
-    /** A query object */
+    /** Query object with filter criteria and pagination settings. */
     query: QueryV2;
 }
 interface QueryV2 extends QueryV2PagingMethodOneOf {
@@ -364,10 +379,11 @@ interface CursorPaging {
      */
     cursor?: string | null;
 }
+/** Response containing matching seating reservations. */
 interface QuerySeatingReservationResponse {
-    /** Found reservations */
+    /** Found reservations matching the query criteria. */
     reservations?: SeatingReservation[];
-    /** Paging meta data */
+    /** Paging metadata for result navigation. */
     metadata?: PagingMetadataV2;
 }
 interface PagingMetadataV2 {
@@ -394,129 +410,145 @@ interface Cursors {
      */
     prev?: string | null;
 }
+/** Request to delete a seating reservation. */
 interface DeleteSeatingReservationRequest {
     /**
-     * The id of the reservation to delete
+     * Reservation ID.
      * @format GUID
      */
     _id: string | null;
 }
+/** Response after deleting a seating reservation. */
 interface DeleteSeatingReservationResponse {
-    /** The deleted reservation */
+    /** Deleted reservation. */
     reservation?: SeatingReservation;
 }
+/** Request to delete a specific place reservation. */
 interface DeleteSeatingPlaceReservationRequest {
-    /** The id of the place reservation to delete */
+    /** Place reservation ID. */
     _id?: string | null;
     /**
-     * The id of the place reservation's reservation
+     * Seating reservation ID that contains the place reservation.
      * @format GUID
      */
     reservationId?: string | null;
 }
 interface Empty {
 }
+/** Request to cancel specific place reservations. */
 interface CancelSeatingPlaceReservationsRequest {
     /**
-     * The id of the place reservations' reservation
+     * Seating reservation ID containing the places to cancel.
      * @format GUID
      */
     reservationId?: string | null;
     /**
-     * The place reservations to cancel
+     * Place reservations to cancel with their reduced capacity.
      * @minSize 1
      * @maxSize 100
      */
     placeReservations?: PlaceReservationDetails[];
 }
+/** Occupancy details for a specific place in a seating plan. */
 interface PlaceReservationDetails {
+    /** Place ID. */
     placeId?: string;
+    /** Number of occupied seats or capacity units at this place. */
     occupied?: number;
 }
+/** Response after canceling place reservations. */
 interface CancelSeatingPlaceReservationsResponse {
-    /** The reservation with canceled place reservations */
+    /** Reservation with canceled place reservations. */
     reservation?: SeatingReservation;
 }
+/** Request to update a seating reservation. */
 interface UpdateSeatingReservationRequest {
-    /** A reservation to update */
+    /** Reservation to update with modified capacity values. */
     reservation?: SeatingReservation;
 }
+/** Response after updating a seating reservation. */
 interface UpdateSeatingReservationResponse {
-    /** The updated reservation */
+    /** Updated reservation. */
     reservation?: SeatingReservation;
 }
+/** Request to retrieve all reserved places for a seating plan. */
 interface GetReservedPlacesRequest {
     /**
-     * Seating plan id
+     * Seating plan ID.
      * @format GUID
      */
     _id?: string | null;
 }
+/** Response containing all reserved places for a seating plan. */
 interface GetReservedPlacesResponse {
-    /** Reserved places of the plan */
+    /** Reserved places in the seating plan. */
     placeReservations?: PlaceReservation[];
 }
+/** Request to list reserved places with optional filtering. */
 interface ListReservedPlacesRequest {
     /**
-     * Seating plan id
+     * Seating plan ID.
      * @format GUID
      */
     planId?: string | null;
     /**
-     * Optional filter by reservation id
+     * Optional filter by reservation ID.
      * @format GUID
      */
     reservationId?: string | null;
     /**
-     * Optional filter by seat id
+     * Optional filter by specific seat IDs.
      * @maxSize 50
      * @maxLength 20
      */
     seatId?: string[];
-    /** Paging */
+    /** Paging configuration. */
     paging?: Paging;
 }
+/** Response containing filtered reserved places. */
 interface ListReservedPlacesResponse {
-    /** Seating plan id */
+    /** Reserved places matching the filter criteria. */
     reservedPlaces?: ReservedPlace[];
-    /** Paging */
+    /** Paging metadata for result navigation. */
     pagingMetadata?: PagingMetadata;
 }
+/** Internal representation of a place reservation. */
 interface SeatReservation {
     /**
-     * Place reservation id
+     * Place reservation ID.
      * @maxLength 72
      */
     seatReservationId?: string | null;
     /**
-     * Seat id
+     * Place ID.
      * @maxLength 20
      */
     seatId?: string | null;
     /**
-     * Seating plan id
+     * Seating plan ID.
      * @format GUID
      */
     planId?: string | null;
     /**
-     * Seating reservation id
+     * Seating reservation ID.
      * @format GUID
      */
     reservationId?: string | null;
     /**
-     * Spots size
+     * Number of occupied spots at this place.
      * @max 50000
      */
     spots?: number | null;
-    /** Is area */
+    /** Whether this is an area-based reservation (true) or individual seat (false). */
     area?: boolean | null;
 }
+/** Individual reserved place with full context. */
 interface ReservedPlace {
-    /** Place reservation */
+    /** Place reservation details. */
     seatReservation?: SeatReservation;
-    /** Occupied count */
+    /** Parent reservation (active). */
     reservation?: SeatingReservation;
-    /** Occupied count */
+    /** Parent reservation (deleted, for audit trail). */
     reservationFromTrashBin?: SeatingReservation;
 }
 interface PagingMetadata {
@@ -529,509 +561,596 @@ interface PagingMetadata {
     /** Flag that indicates the server failed to calculate the `total` field. */
     tooManyToCount?: boolean | null;
 }
+/** Request to retrieve category-level capacity summary. */
 interface GetSeatingCategorySummaryRequest {
     /**
-     * Seating plan external id
+     * External seating plan ID.
      * @minLength 1
      * @maxLength 100
      */
     externalId?: string;
 }
+/** Response containing capacity summary by category. */
 interface GetSeatingCategorySummaryResponse {
     /**
-     * Ticket counts by category
+     * Capacity and reservation counts by category.
      * @maxSize 50000
      */
     categories?: CategoryDetails[];
 }
+/** Request to retrieve detailed place-level occupancy data. */
 interface GetSeatingReservationSummaryRequest {
     /**
-     * Seating plan external id
+     * External seating plan ID.
      * @minLength 1
      * @maxLength 100
      */
     externalId: string;
 }
+/** Response containing complete seating plan and occupancy data. */
 interface GetSeatingReservationSummaryResponse {
+    /** Complete seating plan structure. */
     plan?: SeatingPlan;
-    /** @maxSize 50000 */
+    /**
+     * Occupancy details for each place in the plan.
+     * @maxSize 50000
+     */
     places?: PlaceReservationDetails[];
 }
+/** A seating plan represents the layout and organization of seats within a venue. It defines the physical arrangement of seating areas, pricing categories, and individual places where attendees can be seated or positioned during an event. */
 interface SeatingPlan {
     /**
-     * Auto generated unique plan id
+     * Seating plan ID.
      * @format GUID
      * @readonly
      */
     _id?: string | null;
     /**
-     * A client defined external id for cross referencing.
-     * Can reference external entities.
-     * Format: "{fqdn}:{entity guid}"
+     * Client-defined external ID for cross-referencing with external systems. Format: `{fqdn}:{entity_guid}`. For example, `wix.events.v1.event:abc-123-def`.
      * @minLength 1
      * @maxLength 100
      */
     externalId?: string | null;
     /**
-     * Human friendly plan title
+     * Human-friendly seating plan title. For example, `Madison Square Garden - Main Floor`.
      * @minLength 1
      * @maxLength 120
      */
     title?: string | null;
     /**
-     * Sections of the plan. Seating plan is divided in high level sections.
+     * High-level divisions of the venue, such as "Orchestra", "Balcony", or "VIP Section". A default section with `id = 0` is required and serves as the primary seating area.
      * @maxSize 100
      */
     sections?: Section[];
     /**
-     * Categories for plan element grouping.
+     * Pricing tiers or groupings for organizing places, such as "VIP", "General Admission", or "Student Discount". Elements and places can be assigned to categories for pricing and availability management.
      * @maxSize 100
      */
     categories?: Category[];
     /**
-     * Seating plan created timestamp.
+     * Date and time the seating plan was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Seating plan updated timestamp.
+     * Date and time the seating plan was updated.
      * @readonly
      */
     _updatedDate?: Date | null;
     /**
-     * Total capacity
+     * Total number of seats across all sections and elements in the seating plan. Automatically calculated by summing element capacities.
      * @readonly
      */
     totalCapacity?: number | null;
     /**
-     * Total categories
+     * Total number of categories defined in the seating plan. Automatically calculated.
      * @readonly
      */
     totalCategories?: number | null;
     /**
-     * Places not assigned to categories
+     * Places that are not assigned to any category. These places require manual category assignment for pricing and organization.
      * @maxSize 50000
      * @readonly
      */
     uncategorizedPlaces?: Place[];
     /**
-     * A version of the seating plan
+     * Version number of the seating plan, incremented by 1 each time the plan is updated. Used for version management and tracking changes.
      * @readonly
      */
     version?: string | null;
-    /** Data extensions */
+    /** Additional custom fields for extending the seating plan with app-specific data. Learn more about @extended fields. */
     extendedFields?: ExtendedFields;
-    /** Seating Plan UI settings */
+    /** Visual settings for the seating plan, such as background color and opacity. Used by seating chart interfaces for rendering. */
     uiProperties?: SeatingPlanUiProperties;
     /**
-     * Element groups
+     * Hierarchical groupings of elements for UI organization and bulk operations. Groups can contain multiple elements or nested sub-groups for easier management.
      * @maxSize 1000
      */
     elementGroups?: ElementGroup[];
 }
+/** A section represents a high-level division within a seating plan, such as "Orchestra", "Balcony", or "VIP Area". Sections contain elements that define the actual seating arrangements. */
 interface Section {
-    /** Unique section id */
+    /** Section ID. Must be unique within the seating plan. Section with `id = 0` is required as the default section. */
     _id?: number;
     /**
-     * Human readable section title
+     * Human-readable section title. For example, `Orchestra` or `Balcony`.
      * @minLength 1
      * @maxLength 20
      */
     title?: string | null;
     /**
-     * Client configuration object
+     * Client configuration object for storing additional section metadata. Read-only field maintained for backward compatibility.
      * @readonly
      */
     config?: Record<string, any> | null;
     /**
-     * Elements of the section.
+     * Seating elements within this section, such as rows, tables, or general admission areas. Each element generates individual places based on its type and capacity.
      * @maxSize 1000
      */
     elements?: Element[];
     /**
-     * Total capacity
+     * Total capacity of all elements within this section. Automatically calculated by summing element capacities.
      * @readonly
      */
     totalCapacity?: number | null;
     /**
-     * Is default section
+     * Whether this is the default section. Always `true` for section with `id = 0`.
      * @readonly
      */
     default?: boolean;
 }
+/** An element represents a specific seating configuration within a section, such as a row of seats, a table, or a general admission area. Elements generate individual places based on their type and capacity. */
 interface Element {
     /**
-     * Unique element id
+     * Element ID. Must be unique within the seating plan.
      * @min 1
      */
     _id?: number;
     /**
-     * User friendly title/label of the element.
+     * User-friendly title or label for the element. For example, `Row A` or `VIP Table 1`.
      * @minLength 1
      * @maxLength 50
      */
     title?: string | null;
-    /** Element type */
+    /** Type of seating element, which determines capacity limits and place generation behavior. See ElementTypeEnum for available types. */
     type?: TypeWithLiterals;
     /**
-     * Capacity. None for Shape type Element.
+     * Number of seats or spots in this element. Not applicable for SHAPE type elements. Maximum 50,000 per element.
      * @min 1
      * @max 50000
      */
     capacity?: number | null;
-    /** Assigned to a category */
+    /** ID of the category this element is assigned to for pricing and organization. References a category defined in the seating plan. */
     categoryId?: number | null;
-    /** A place numbering meta data */
+    /** Configuration for generating place labels and numbering within this element. Defines how seats are labeled (e.g., 1, 2, 3 or A, B, C). */
     sequencing?: Sequencing;
     /**
-     * Place override (by seq_id)
+     * Custom place configurations that override the default generated places for specific positions. Used for accessibility seating, obstructed views, or custom labeling.
      * @maxSize 2000
      */
     overrides?: Place[];
     /**
-     * Final place sequence with overrides
+     * Final sequence of places generated for this element, including any overrides applied. Read-only field populated by the system.
      * @maxSize 200
      * @readonly
      */
     places?: Place[];
-    /** Element reservation options */
+    /** Constraints on how this element can be reserved or booked. For example, requiring the entire element to be reserved as a unit. */
     reservationOptions?: ReservationOptions;
-    /** Element UI settings */
+    /** Visual positioning and styling properties for rendering this element in a seating chart. Includes coordinates, dimensions, and styling options. */
     uiProperties?: ElementUiProperties;
-    /** Element group id */
+    /** ID of the element group this element belongs to for hierarchical organization. References an ElementGroup defined in the seating plan. */
     elementGroupId?: number | null;
-    /** Multi row element relevant for MULTI_ROW element type */
+    /** Additional properties for MULTI_ROW type elements, defining individual rows and their configurations. Only applicable when type is MULTI_ROW. */
     multiRowProperties?: MultiRowProperties;
 }
 declare enum Type {
+    /** General admission area with a single place containing the full capacity. */
     AREA = "AREA",
+    /** Single row of individual seats with sequential labeling. */
     ROW = "ROW",
+    /** Multiple rows treated as one element, each with individual capacity and sequencing. */
     MULTI_ROW = "MULTI_ROW",
+    /** Rectangular table with individual seats around the perimeter. */
     TABLE = "TABLE",
+    /** Circular table with individual seats around the perimeter. */
     ROUND_TABLE = "ROUND_TABLE",
+    /** Visual element with no seating capacity, used for decorative or informational purposes. */
     SHAPE = "SHAPE"
 }
 /** @enumType */
 type TypeWithLiterals = Type | 'AREA' | 'ROW' | 'MULTI_ROW' | 'TABLE' | 'ROUND_TABLE' | 'SHAPE';
+/** Configuration for generating sequential labels for places within an element. */
 interface Sequencing {
     /**
-     * First seq element
+     * Starting value for the sequence. For example, `1` for numeric sequences or `A` for alphabetical sequences.
      * @minLength 1
      * @maxLength 4
      */
     startAt?: string;
     /**
-     * Finite generated seq of labels
+     * Complete sequence of labels to be used for places. Must match the element's capacity. When provided, overrides automatic label generation.
      * @maxSize 2500
      */
     labels?: string[];
-    /** If true - direction right to left. Otherwise left to right. */
+    /** Whether to apply labels in reverse order (right-to-left instead of left-to-right). Useful for venue-specific numbering conventions. */
     reverseOrder?: boolean | null;
 }
+/** An individual seat or spot within an element where an attendee can be positioned. */
 interface Place {
-    /** Local id of the place in the sequence */
+    /** Zero-based position of this place within the element's sequence. Used to identify the place's position for overrides. */
     index?: number;
     /**
-     * Generated composite unique id in the seating plan.
+     * Unique place ID in the format `{section_id}-{element_id}-{label}`. For example, `0-1-A5` for section 0, element 1, seat A5.
      * @readonly
      */
     _id?: string | null;
     /**
-     * Unique label of the place
+     * Human-readable label for this place, such as `A1`, `12`, or `VIP1`. Generated based on sequencing configuration or custom overrides.
      * @minLength 1
      * @maxLength 4
      */
     label?: string;
     /**
-     * Max capacity per place
+     * Maximum number of people that can occupy this place. Typically 1 for individual seats, higher for AREA type places.
      * @readonly
      */
     capacity?: number | null;
     /**
-     * Type of the parent element
+     * Type of the parent element that contains this place. Inherited from the element's type.
      * @readonly
      */
     elementType?: TypeWithLiterals;
     /**
-     * Assigned category id
+     * ID of the category this place is assigned to. Inherited from element or row category assignment.
      * @readonly
      */
     categoryId?: number | null;
-    /** Place type */
+    /** Special characteristics or accessibility features of this place (standard, wheelchair, accessible, companion, obstructed, discount). */
     type?: PlaceTypeEnumTypeWithLiterals;
 }
 declare enum PlaceTypeEnumType {
+    /** Unknown place type. */
     UNKNOWN_PROPERTY = "UNKNOWN_PROPERTY",
+    /** Standard seating with no special accommodations. */
     STANDARD = "STANDARD",
+    /** Wheelchair accessible seating space. */
     WHEELCHAIR = "WHEELCHAIR",
+    /** Accessible seating for mobility-impaired guests. */
     ACCESSIBLE = "ACCESSIBLE",
+    /** Companion seat adjacent to accessible seating. */
     COMPANION = "COMPANION",
+    /** Seat with limited or obstructed view. */
     OBSTRUCTED = "OBSTRUCTED",
+    /** Discounted pricing seat. */
     DISCOUNT = "DISCOUNT"
 }
 /** @enumType */
 type PlaceTypeEnumTypeWithLiterals = PlaceTypeEnumType | 'UNKNOWN_PROPERTY' | 'STANDARD' | 'WHEELCHAIR' | 'ACCESSIBLE' | 'COMPANION' | 'OBSTRUCTED' | 'DISCOUNT';
+/** Configuration options that control how an element can be reserved or booked. */
 interface ReservationOptions {
-    /** Indicates whether the entire element must be reserved */
+    /** Whether the entire element must be reserved as a single unit. When `true`, individual seats cannot be booked separately. Cannot be used with AREA type elements. */
     reserveWholeElement?: boolean;
 }
+/** Visual positioning and styling properties for rendering elements in a seating chart interface. */
 interface ElementUiProperties {
     /**
+     * Horizontal position coordinate of the element in the seating chart coordinate system.
      * @min -1000000
      * @max 1000000
      */
     x?: number | null;
     /**
+     * Vertical position coordinate of the element in the seating chart coordinate system.
      * @min -1000000
      * @max 1000000
      */
     y?: number | null;
     /**
+     * Layering order for overlapping elements. Higher values appear on top of lower values.
      * @min -1000000
      * @max 1000000
      */
     zIndex?: number | null;
-    /** @max 1000000 */
+    /**
+     * Width of the element in the coordinate system units.
+     * @max 1000000
+     */
     width?: number | null;
-    /** @max 1000000 */
+    /**
+     * Height of the element in the coordinate system units.
+     * @max 1000000
+     */
     height?: number | null;
     /**
+     * Rotation angle of the element in degrees. Positive values rotate clockwise.
      * @min -180
      * @max 180
      */
     rotationAngle?: number | null;
+    /** Shape type for SHAPE elements that don't represent seating. Only applicable when element type is SHAPE. */
     shapeType?: ShapeTypeEnumTypeWithLiterals;
     /**
+     * Font size for text elements in points.
      * @min 10
      * @max 176
      */
     fontSize?: number | null;
-    /** @max 1000000 */
+    /**
+     * Corner radius for rounded rectangular shapes in coordinate system units.
+     * @max 1000000
+     */
     cornerRadius?: number | null;
     /**
+     * Horizontal spacing between individual seats within the element.
      * @min 1
      * @max 60
      */
     seatSpacing?: number | null;
+    /** Whether to hide labels on seats within this element. When `true`, seat labels are not displayed in the UI. */
     hideLabel?: boolean | null;
+    /** Position of labels relative to seats (left, right, both sides, or none). */
     labelPosition?: PositionWithLiterals;
+    /** Array defining the arrangement of seats within the element. Each number represents the count of seats in that position. */
     seatLayout?: number[];
-    /** @max 50 */
+    /**
+     * Number of empty spaces at the top of the seating arrangement for visual spacing.
+     * @max 50
+     */
     emptyTopSeatSpaces?: number | null;
     /**
-     * needs research
+     * Text content for TEXT type shape elements. Only applicable when shape_type is TEXT.
      * @minLength 1
      * @maxLength 10000
      */
     text?: string | null;
     /**
-     * #F0F0F0
+     * Primary color in hexadecimal format. For example, `#FF0000` for red.
      * @format COLOR_HEX
      */
     color?: string | null;
     /**
-     * #F0F0F0
+     * Fill color for shapes in hexadecimal format. For example, `#00FF00` for green.
      * @format COLOR_HEX
      */
     fillColor?: string | null;
     /**
-     * #F0F0F0
+     * Border color in hexadecimal format. For example, `#0000FF` for blue.
      * @format COLOR_HEX
      */
     strokeColor?: string | null;
     /**
-     * px
+     * Border width in pixels for shape outlines.
      * @min 1
      * @max 6
      */
     strokeWidth?: number | null;
-    /** @max 100 */
+    /**
+     * Opacity level as a percentage from 0 (transparent) to 100 (opaque).
+     * @max 100
+     */
     opacity?: number | null;
+    /** Icon type for ICON shape elements. Only applicable when shape_type is ICON. */
     icon?: IconWithLiterals;
+    /** Image object for IMAGE shape elements. Only applicable when shape_type is IMAGE. */
     image?: Image;
+    /** Numbering scheme for seats within this element (numeric, alphabetical, or odd/even). */
     seatNumbering?: NumberingWithLiterals;
 }
 declare enum ShapeTypeEnumType {
+    /** Unknown shape type. */
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
+    /** Text label or annotation. */
     TEXT = "TEXT",
+    /** Rectangular shape. */
     RECTANGLE = "RECTANGLE",
+    /** Circular or oval shape. */
     ELLIPSE = "ELLIPSE",
+    /** Straight line. */
     LINE = "LINE",
+    /** Predefined icon symbol. */
     ICON = "ICON",
+    /** Custom image. */
     IMAGE = "IMAGE"
 }
 /** @enumType */
 type ShapeTypeEnumTypeWithLiterals = ShapeTypeEnumType | 'UNKNOWN_TYPE' | 'TEXT' | 'RECTANGLE' | 'ELLIPSE' | 'LINE' | 'ICON' | 'IMAGE';
 declare enum Position {
+    /** Label positioning options for seats and elements. */
     UNKNOWN_POSITION = "UNKNOWN_POSITION",
+    /** Labels appear to the left of seats. */
     LEFT = "LEFT",
+    /** Labels appear to the right of seats. */
     RIGHT = "RIGHT",
+    /** Labels appear on both sides of seats. */
     BOTH = "BOTH",
+    /** No labels are displayed. */
     NONE = "NONE"
 }
 /** @enumType */
 type PositionWithLiterals = Position | 'UNKNOWN_POSITION' | 'LEFT' | 'RIGHT' | 'BOTH' | 'NONE';
 declare enum Icon {
+    /** Available icon types for venue wayfinding and information. */
     UNKNOWN_ICON = "UNKNOWN_ICON",
+    /** Entrance icon. */
     ENTER = "ENTER",
+    /** Exit icon. */
     EXIT = "EXIT",
+    /** Beverage service icon. */
     DRINKS = "DRINKS",
+    /** Restroom icon. */
     WC = "WC",
+    /** Men's restroom icon. */
     WC_MEN = "WC_MEN",
+    /** Women's restroom icon. */
     WC_WOMEN = "WC_WOMEN",
+    /** Food service icon. */
     FOOD = "FOOD",
+    /** Stairway icon. */
     STAIRS = "STAIRS",
+    /** Elevator icon. */
     ELEVATOR = "ELEVATOR",
+    /** Smoking area icon. */
     SMOKING = "SMOKING",
+    /** Coat check icon. */
     CHECKROOM = "CHECKROOM",
+    /** Stage or performance area icon. */
     STAGE = "STAGE"
 }
 /** @enumType */
 type IconWithLiterals = Icon | 'UNKNOWN_ICON' | 'ENTER' | 'EXIT' | 'DRINKS' | 'WC' | 'WC_MEN' | 'WC_WOMEN' | 'FOOD' | 'STAIRS' | 'ELEVATOR' | 'SMOKING' | 'CHECKROOM' | 'STAGE';
+/** Image reference for use in seating plan visual elements. */
 interface Image {
-    /** WixMedia image ID. */
+    /** Image ID from Wix Media Manager. */
     _id?: string;
     /**
-     * Original image height.
+     * Original image height in pixels.
      * @readonly
      */
     height?: number;
     /**
-     * Original image width.
+     * Original image width in pixels.
      * @readonly
      */
     width?: number;
     /**
-     * WixMedia image URI.
+     * Deprecated. Use the `id` field instead for referencing images.
      * @deprecated
      */
     uri?: string | null;
 }
 declare enum Numbering {
+    /** Seat numbering patterns for sequential label generation. */
     UNKNOWN_NUMBERING = "UNKNOWN_NUMBERING",
+    /** Sequential numbers (1, 2, 3, ...). */
     NUMERIC = "NUMERIC",
+    /** Alternating odd and even numbers. */
     ODD_EVEN = "ODD_EVEN",
+    /** Sequential letters (A, B, C, ...). */
     ALPHABETICAL = "ALPHABETICAL"
 }
 /** @enumType */
 type NumberingWithLiterals = Numbering | 'UNKNOWN_NUMBERING' | 'NUMERIC' | 'ODD_EVEN' | 'ALPHABETICAL';
+/** Configuration for multi-row elements that contain multiple individual rows, each with their own capacity and sequencing. */
 interface MultiRowProperties {
     /**
-     * Individual rows of the multi row element
+     * Individual rows within the multi-row element. Each row has its own capacity, sequencing, and category assignment.
      * @maxSize 1000
      */
     rows?: RowElement[];
-    /** Meta data for vertical labeling */
+    /** Configuration for labeling rows vertically (e.g., Row A, Row B, Row C). Defines how row labels are generated. */
     verticalSequencing?: VerticalSequencing;
     /**
-     * Row spacing
+     * Vertical spacing between rows in the multi-row element. Measured in coordinate system units.
      * @min 1
      * @max 60
      */
     rowSpacing?: number | null;
     /**
-     * Amount of seats in the row
+     * Number of seats per row in the multi-row element.
      * @max 50
      */
     seatAmount?: number | null;
 }
+/** An individual row within a multi-row element, with its own capacity, sequencing, and category assignment. */
 interface RowElement {
     /**
-     * Unique row id
+     * Row ID. Must be unique across all multi-row elements in the seating plan.
      * @min 1
      */
     _id?: number;
     /**
-     * User friendly title/label of the row
+     * User-friendly title or label for this row. For example, `Row A` or `Front Row`.
      * @minLength 1
      * @maxLength 50
      */
     title?: string | null;
     /**
-     * Row capacity
+     * Number of seats in this row. Maximum 50,000 per row.
      * @min 1
      * @max 50000
      */
     capacity?: number | null;
-    /** Assigned to a category */
+    /** Category assignment for this row, which can override the parent element's category. References a category defined in the seating plan. */
     categoryId?: number | null;
-    /** A place numbering meta data for a single row */
+    /** Configuration for generating seat labels within this row. Defines numbering scheme and starting position. */
     sequencing?: Sequencing;
-    /** Row UI settings */
+    /** Visual properties specific to this row within the multi-row element. Includes positioning relative to parent element. */
     uiProperties?: RowElementUiProperties;
 }
+/** Visual properties specific to individual rows within multi-row elements. */
 interface RowElementUiProperties {
     /**
-     * Relative x position to the parent element
+     * Horizontal position relative to the parent multi-row element's coordinate system.
      * @min -1000000
      * @max 1000000
      */
     relativeX?: number | null;
     /**
-     * Width of the row
+     * Width of this row in coordinate system units.
      * @max 1000000
      */
     width?: number | null;
     /**
-     * Amount of seats in the row
+     * Number of seats in this row. Overrides the capacity field when specified.
      * @max 50
      */
     seatAmount?: number | null;
     /**
-     * Seat spacing
+     * Spacing between seats in this row.
      * @min 1
      * @max 60
      */
     seatSpacing?: number | null;
-    /** Label position */
+    /** Position of labels relative to seats in this row (left, right, both sides, or none). // Position of labels relative to seats in this row. */
     labelPosition?: PositionWithLiterals;
-    /** Seat numbering */
+    /** Numbering scheme for seats in this row (numeric, alphabetical, or odd/even). */
     seatNumbering?: NumberingWithLiterals;
 }
+/** Configuration for labeling rows vertically in multi-row elements. */
 interface VerticalSequencing {
     /**
-     * First seq element
+     * Starting value for row labeling. For example, `A` for alphabetical sequences or `1` for numeric sequences.
      * @minLength 1
      * @maxLength 4
      */
     startAt?: string;
-    /** Row numbering */
+    /** Numbering scheme for row labels (numeric, alphabetical, or odd/even). */
     rowNumbering?: NumberingWithLiterals;
-    /** If true - direction bottom to top. Otherwise top to bottom. */
+    /** Whether to label rows in reverse order (bottom-to-top instead of top-to-bottom). */
     reverseOrder?: boolean | null;
 }
+/** A grouping mechanism for organizing places by pricing tier, access level, or other business criteria. */
 interface Category {
     /**
-     * Local category id within the seating plan
+     * Category ID. Must be unique within the seating plan.
      * @min 1
      */
     _id?: number;
     /**
-     * A client defined external id for cross referencing.
-     * Can reference external entities.
-     * Format: "{entity_fqdn}:{entity_id}"
+     * Client-defined external ID for cross-referencing with pricing or ticketing systems. Format: `{entity_fqdn}:{entity_id}`.
      * @minLength 1
      * @maxLength 100
      */
     externalId?: string | null;
     /**
-     * Category label
+     * Human-readable category name, such as `VIP`, `General Admission`, or `Student Discount`.
      * @minLength 1
      * @maxLength 120
      */
     title?: string;
     /**
-     * Client configuration object
+     * Client configuration object for storing additional category metadata. Read-only field maintained for backward compatibility.
      * @readonly
      */
     config?: Record<string, any> | null;
     /**
-     * Total capacity
+     * Total capacity of all places assigned to this category. Automatically calculated by summing place capacities.
      * @readonly
      */
     totalCapacity?: number | null;
     /**
-     * Possible places
+     * All places that are assigned to this category. Populated when using the CATEGORIES fieldset.
      * @maxSize 50000
      * @readonly
      */
@@ -1048,70 +1167,86 @@ interface ExtendedFields {
      */
     namespaces?: Record<string, Record<string, any>>;
 }
+/** Visual styling properties for the overall seating plan background and appearance. */
 interface SeatingPlanUiProperties {
     /**
-     * #F0F0F0
+     * Background color in hexadecimal format. For example, `#F0F0F0` for light gray.
      * @format COLOR_HEX
      */
     backgroundColor?: string | null;
-    /** @max 100 */
+    /**
+     * Background opacity as a percentage from 0 (transparent) to 100 (opaque).
+     * @max 100
+     */
     backgroundOpacity?: number | null;
 }
+/** A hierarchical grouping of elements for UI organization and bulk operations. */
 interface ElementGroup {
     /**
-     * Unique element group id
+     * Element group ID. Must be unique within the seating plan.
      * @min 1
      */
     _id?: number;
-    /** Parent group id */
+    /** ID of the parent group for creating nested group hierarchies. References another ElementGroup in the same seating plan. */
     parentElementGroupId?: number | null;
-    /** Element group UI settings */
+    /** Visual properties for rendering this group in the UI. Includes positioning and dimensions for the group container. */
     uiProperties?: ElementGroupUiProperties;
 }
+/** Visual positioning and styling properties for element groups. */
 interface ElementGroupUiProperties {
     /**
-     * x position of the group
+     * Horizontal position coordinate of the group container.
      * @min -1000000
      * @max 1000000
      */
     x?: number | null;
     /**
-     * y position of the group
+     * Vertical position coordinate of the group container.
      * @min -1000000
      * @max 1000000
      */
     y?: number | null;
     /**
-     * width of the group
+     * Width of the group bounding box in coordinate system units.
      * @max 1000000
      */
     width?: number | null;
     /**
-     * height of the group
+     * Height of the group bounding box in coordinate system units.
      * @max 1000000
      */
     height?: number | null;
     /**
-     * rotation angle of the group
+     * Rotation angle of the group in degrees. Applied to all elements within the group.
      * @min -180
      * @max 180
      */
     rotationAngle?: number | null;
 }
+/** Request to regenerate cached summaries. */
 interface RegenerateSummariesRequest {
     /**
-     * Seating plan id
+     * Seating plan ID.
      * @format GUID
      */
     planId?: string | null;
 }
+/** Response after regenerating summaries. */
 interface RegenerateSummariesResponse {
+    /** Regenerated place-level occupancy summary. */
     seatingReservationsSummary?: SeatingReservationsSummary;
-    /** @maxSize 50000 */
+    /**
+     * Regenerated category-level summaries.
+     * @maxSize 50000
+     */
     categories?: CategoryDetails[];
 }
+/** Aggregated occupancy data for all places in a seating plan. */
 interface SeatingReservationsSummary {
-    /** @maxSize 50000 */
+    /**
+     * Occupancy details for each place.
+     * @maxSize 50000
+     */
     places?: PlaceReservationDetails[];
 }
 interface DomainEvent extends DomainEventBodyOneOf {
@@ -1329,35 +1464,35 @@ interface SeatingReservationDeletedEnvelope {
  */
 declare function onSeatingReservationDeleted(handler: (event: SeatingReservationDeletedEnvelope) => void | Promise<void>): void;
 /**
- * Creates a seating reservation
+ * Creates a seating reservation for one or more places within a seating plan.
  * @public
  * @documentationMaturity preview
  * @permissionId SEATING_PLANS.MANAGE_RESERVATIONS
  * @applicableIdentity APP
- * @returns Created reservation
+ * @returns Created reservation.
  * @fqn com.wixpress.seating.SeatingReservationService.CreateSeatingReservation
  */
 declare function createSeatingReservation(options?: CreateSeatingReservationOptions): Promise<NonNullablePaths<SeatingReservation, `reservedPlaces` | `reservedPlaces.${number}._id`, 4> & {
     __applicationErrorsType?: CreateSeatingReservationApplicationErrors;
 }>;
 interface CreateSeatingReservationOptions {
-    /** A reservation to create */
+    /** Reservation to create. */
     reservation?: SeatingReservation;
 }
 /**
- * Returns seating reservation
- * @param _id - The id of the reservation to return
+ * Retrieves a seating reservation by ID.
+ * @param _id - Reservation ID.
  * @public
  * @documentationMaturity preview
  * @requiredField _id
  * @permissionId SEATING_PLANS.READ_RESERVATIONS
  * @applicableIdentity APP
- * @returns Created reservation
+ * @returns Retrieved reservation.
  * @fqn com.wixpress.seating.SeatingReservationService.GetReservation
  */
 declare function getReservation(_id: string): Promise<NonNullablePaths<SeatingReservation, `reservedPlaces` | `reservedPlaces.${number}._id`, 4>>;
 /**
- * Lists seating reservations by query request
+ * Retrieves seating reservations that match specified criteria.
  * @public
  * @documentationMaturity preview
  * @permissionId SEATING_PLANS.READ_RESERVATIONS
@@ -1391,37 +1526,44 @@ interface ReservationsQueryBuilder {
     find: () => Promise<ReservationsQueryResult>;
 }
 /**
- * Deletes the seating reservation
- * @param _id - The id of the reservation to delete
+ * Deletes a seating reservation and releases all reserved places.
+ * @param _id - Reservation ID.
  * @public
  * @documentationMaturity preview
  * @requiredField _id
  * @permissionId SEATING_PLANS.MANAGE_RESERVATIONS
  * @applicableIdentity APP
+ * @returns Response after deleting a seating reservation.
  * @fqn com.wixpress.seating.SeatingReservationService.DeleteSeatingReservation
  */
 declare function deleteSeatingReservation(_id: string): Promise<NonNullablePaths<DeleteSeatingReservationResponse, `reservation.reservedPlaces` | `reservation.reservedPlaces.${number}._id`, 5>>;
-/** @public
+/**
+ * Retrieves capacity and reservation summary by seating category.
+ * @public
  * @documentationMaturity preview
  * @permissionId SEATING_PLANS.READ_SEATING_PLANS
  * @applicableIdentity APP
+ * @returns Response containing capacity summary by category.
  * @fqn com.wixpress.seating.SeatingReservationService.GetSeatingCategorySummary
  */
 declare function getSeatingCategorySummary(options?: GetSeatingCategorySummaryOptions): Promise<NonNullablePaths<GetSeatingCategorySummaryResponse, `categories`, 2>>;
 interface GetSeatingCategorySummaryOptions {
     /**
-     * Seating plan external id
+     * External seating plan ID.
      * @minLength 1
      * @maxLength 100
      */
     externalId?: string;
 }
-/** @param externalId - Seating plan external id
+/**
+ * Retrieves detailed place-level occupancy data for a seating plan.
+ * @param externalId - External seating plan ID.
  * @public
  * @documentationMaturity preview
  * @requiredField externalId
  * @permissionId SEATING_PLANS.READ_SEATING_PLANS
  * @applicableIdentity APP
+ * @returns Response containing complete seating plan and occupancy data.
  * @fqn com.wixpress.seating.SeatingReservationService.GetSeatingReservationSummary
  */
 declare function getSeatingReservationSummary(externalId: string): Promise<NonNullablePaths<GetSeatingReservationSummaryResponse, `plan.sections` | `plan.sections.${number}._id` | `plan.sections.${number}.default` | `plan.categories` | `plan.categories.${number}._id` | `plan.categories.${number}.title` | `plan.uncategorizedPlaces` | `plan.elementGroups` | `plan.elementGroups.${number}._id` | `places` | `places.${number}.placeId` | `places.${number}.occupied`, 5>>;