platform-calendar-seatmap 2.0.2 → 2.1.3

package/.github/workflows/auto-pr-staging-to-main.yml

@@ -0,0 +1,34 @@
+name: Auto PR staging to main
+
+on:
+  push:
+    branches: ["staging"]
+
+jobs:
+  create-pr:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Create PR if not exists
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Check if an open PR from staging -> main already exists
+          EXISTING_PR=$(gh pr list --base main --head staging --state open --json number --jq '.[0].number')
+
+          if [ -z "$EXISTING_PR" ]; then
+            echo "No existing PR found. Creating one..."
+            gh pr create \
+              --base main \
+              --head staging \
+              --title "Merge staging into main" \
+              --body "Automated PR created from staging branch."
+          else
+            echo "PR #$EXISTING_PR already exists. Skipping."
+          fi

package/dist/components/actionsHandler/ActionsHandler.d.ts

@@ -2,6 +2,7 @@ import { T_Seat, T_SeatMap } from 'platform-calendar-helpers';
 type actions = {
     save: () => (T_SeatMap & {
         backgroundColor: string;
+        ticketColors: Record<string, string>;
     }) | false;
     cancel: () => void;
     updateSeatMap: (seatMap: T_SeatMap) => void;

package/dist/components/app/App.d.ts

@@ -1,11 +1,11 @@
 import { FC } from 'react';
 import '@wix/design-system/styles.global.css';
 import { T_SeatMap, T_Ticket } from 'platform-calendar-helpers';
-import "../../assets/styles/global.css";
-import { actions } from "../actionsHandler/ActionsHandler";
-import { T_ActionHandlersState } from "../../store/reducers/actionHandlers/types";
-import { T_Mode } from "../../helpers/types/commons";
-import { T_MainState } from "../../store/reducers/main/types";
+import 'assets/styles/global.css';
+import { actions } from 'components/actionsHandler/ActionsHandler';
+import { T_ActionHandlersState } from 'store/reducers/actionHandlers/types';
+import { T_Mode } from 'helpers/types/commons';
+import { T_MainState } from 'store/reducers/main/types';
 type T_Props = {
     tickets: T_Ticket[];
     seatMap: T_SeatMap | null;
@@ -13,6 +13,10 @@ type T_Props = {
     mode?: T_Mode;
     soldSeats?: T_MainState['soldSeats'];
     currencySymbol?: string;
+    onSave?: () => void;
+    onCancel?: () => void;
+    onFullscreenChange?: (isFullscreen: boolean) => void;
+    onPreviewChange?: (isPreview: boolean) => void;
 } & Partial<T_ActionHandlersState>;
 declare const App: FC<T_Props>;
 export { App };

package/dist/components/background/Background.d.ts

@@ -2,6 +2,8 @@ import { FC, ReactNode } from 'react';
 type T_Props = {
     children: (ref: React.MutableRefObject<HTMLDivElement>) => ReactNode;
     backgroundColor?: string;
+    /** Hide the dot pattern (e.g. in templates section preview) */
+    hideDots?: boolean;
 };
 declare const Background: FC<T_Props>;
 export { Background };

package/dist/components/elementSelector/ElementSelector.d.ts

@@ -1,10 +1,9 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
     renderMode?: '2d' | '3d';
     onToggleRenderMode?: () => void;
-    onZoomToFit?: () => void;
 };
 declare const ElementSelector: FC<T_Props>;
 export { ElementSelector };

package/dist/components/elementSelector/dropdown/Dropdown.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elementSelector/dropdown/sections/aisles/Aisles.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elementSelector/dropdown/sections/objects/Objects.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elementSelector/dropdown/sections/seatingGroup/SeatingGroup.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elementSelector/dropdown/sections/standingArea/StandingArea.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elementSelector/dropdown/sections/tables/Tables.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elementSelector/dropdown/sections/text/Text.d.ts

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { T_SceneTransform } from "../../../../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Props = {
     sceneTransform: T_SceneTransform;
 };

package/dist/components/elements/aisle/Aisle.d.ts

@@ -4,7 +4,7 @@
  * No seats - purely for layout clarity and visual organization
  */
 import { FC } from 'react';
-import { T_Element_Aisle } from "../../../helpers/types/aisle";
+import { T_Element_Aisle } from 'helpers/types/aisle';
 type T_Props = {
     aisle: T_Element_Aisle;
 };

package/dist/components/elements/table/round/Round.d.ts

@@ -1,8 +1,9 @@
 import { T_Element_Table, T_Seat, T_Ticket } from 'platform-calendar-helpers';
 import { FC } from 'react';
-import { selectSelectedSeatsObj } from "../../../../store/reducers/seatMap/selectors";
-import { selectTicketByIds } from "../../../../store/reducers/main/selectors";
-import { T_SeatColors } from "../../../../helpers/constants/seatColors";
+import { selectSelectedSeatsObj } from 'store/reducers/seatMap/selectors';
+import { selectTicketByIds } from 'store/reducers/main/selectors';
+import { T_SeatColors } from 'helpers/constants/seatColors';
+import { T_TableNumberingConfig } from 'helpers/constants/numberingStyles';
 type T_Props = {
     table: T_Element_Table;
     selectedSeatsObj: ReturnType<typeof selectSelectedSeatsObj>;
@@ -15,6 +16,9 @@ type T_Props = {
     seatColors: T_SeatColors;
     soldSeatIds: Set<string | number>;
     currencySymbol?: string;
+    ticketColors?: Record<string, string>;
+    numberingConfig: T_TableNumberingConfig;
+    iconType: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
 };
 declare const Round: FC<T_Props>;
 export { Round };

package/dist/components/elements/table/square/Square.d.ts

@@ -1,8 +1,9 @@
 import { T_Element_Table, T_Seat, T_Ticket } from 'platform-calendar-helpers';
 import { FC } from 'react';
-import { selectSelectedSeatsObj } from "../../../../store/reducers/seatMap/selectors";
-import { selectTicketByIds } from "../../../../store/reducers/main/selectors";
-import { T_SeatColors } from "../../../../helpers/constants/seatColors";
+import { selectSelectedSeatsObj } from 'store/reducers/seatMap/selectors';
+import { selectTicketByIds } from 'store/reducers/main/selectors';
+import { T_SeatColors } from 'helpers/constants/seatColors';
+import { T_TableNumberingConfig } from 'helpers/constants/numberingStyles';
 type T_Props = {
     table: T_Element_Table;
     selectedSeatsObj: ReturnType<typeof selectSelectedSeatsObj>;
@@ -15,6 +16,9 @@ type T_Props = {
     seatColors: T_SeatColors;
     soldSeatIds: Set<string | number>;
     currencySymbol?: string;
+    ticketColors?: Record<string, string>;
+    numberingConfig: T_TableNumberingConfig;
+    iconType: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
 };
 declare const Square: FC<T_Props>;
 export { Square };

package/dist/components/numberingSettings/NumberingSettings.d.ts

@@ -1,9 +1,10 @@
 /**
  * NUMBERING SETTINGS COMPONENT
- * Configure row and seat numbering styles
+ * Informative panel that shows users how their row and seat labels will look.
+ * Provides presets, identifier types, separators, and numbering configuration.
  */
 import { FC } from 'react';
-import { T_NumberingConfig } from "../../helpers/constants/numberingStyles";
+import { T_NumberingConfig } from 'helpers/constants/numberingStyles';
 type T_Props = {
     config: Partial<T_NumberingConfig>;
     onChange: (config: Partial<T_NumberingConfig>) => void;

package/dist/components/onboarding/Onboarding.d.ts

@@ -12,6 +12,8 @@ interface OnboardingStep {
     spotlightPadding?: number;
     /** If true, skip this step if target element doesn't exist */
     skipIfMissing?: boolean;
+    /** Icon rendered above the title */
+    icon?: React.ReactNode;
 }
 /** Custom event to show onboarding again without page reload (e.g. from "Take the tour again" button) */
 export declare const SHOW_ONBOARDING_EVENT = "seatmap-show-onboarding";

package/dist/components/scene3d/Scene3D.d.ts

@@ -1,4 +1,4 @@
-import { T_SceneTransform } from "../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_Scene3DRef = {
     zoomToFit: () => void;
 };

package/dist/components/sceneContainer/SceneContainer.d.ts

@@ -1,4 +1,4 @@
-import { T_SceneTransform } from "../../helpers/types/commons";
+import { T_SceneTransform } from 'helpers/types/commons';
 type T_SceneContainerRef = {
     zoomToFit: () => void;
 };

package/dist/components/seat/Seat.d.ts

@@ -1,7 +1,7 @@
 import { T_Seat, T_Ticket } from 'platform-calendar-helpers';
 import { FC } from 'react';
-import { selectTicketByIds } from "../../store/reducers/main/selectors";
-import { T_SeatColors } from "../../helpers/constants/seatColors";
+import { selectTicketByIds } from 'store/reducers/main/selectors';
+import { T_SeatColors } from 'helpers/constants/seatColors';
 type T_Props = {
     seat: T_Seat;
     selected: boolean;
@@ -34,6 +34,12 @@ type T_Props = {
     sectionName?: string;
     /** Currency symbol for price display in tooltip */
     currencySymbol?: string;
+    /** Per-ticket color overrides from seatmap settings */
+    ticketColors?: Record<string, string>;
+    /** Computed display label (e.g. after hidden-seat renumbering). Falls back to seat.label. */
+    displayLabel?: string;
+    /** Whether flat numbering is active (no rows). Passed to tooltip to avoid showing row info. */
+    flatNumbering?: boolean;
 };
 declare const Seat: FC<T_Props>;
 export { Seat };

package/dist/components/seatTooltip/SeatTooltip.d.ts

@@ -16,6 +16,8 @@ export interface T_SeatTooltipData {
     isLocked?: boolean;
     customNote?: string;
     currencySymbol?: string;
+    /** When true, rows are irrelevant — don't show row info in the tooltip */
+    flatNumbering?: boolean;
 }
 type T_Props = {
     data: T_SeatTooltipData;

package/dist/components/tableNumberingSettings/TableNumberingSettings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * TABLE NUMBERING SETTINGS
+ * Simplified numbering panel for table elements.
+ * No row concept — only seat identifier type, direction, start number, and prefix.
+ * Direction options are shape-aware (clockwise/CCW for round, LTR/RTL for square).
+ */
+import { FC } from 'react';
+import { T_TableNumberingConfig } from 'helpers/constants/numberingStyles';
+type T_Props = {
+    config: Partial<T_TableNumberingConfig>;
+    /** 0 = round, 1 = square */
+    shape: 0 | 1;
+    onChange: (config: T_TableNumberingConfig) => void;
+};
+declare const TableNumberingSettings: FC<T_Props>;
+export { TableNumberingSettings };

package/dist/helpers/constants/commons.d.ts

@@ -1,4 +1,10 @@
 declare const ALPHABET: string[];
+/**
+ * Venue-safe alphabet excluding letters that resemble numbers.
+ * I is excluded (resembles 1), O is excluded (resembles 0).
+ * This is the industry standard used by Broadway theatres, opera houses, etc.
+ */
+declare const ALPHABET_VENUE: string[];
 declare const CURVE_UPDATED_EVENT_NAME = "CUSTOM_EVENTS/CURVE_UPDATED_EVENT";
 declare const STRETCH_UPDATED_EVENT_NAME = "CUSTOM_EVENTS/STRETCH_UPDATED_EVENT_NAME";
 declare const IS_MOBILE: boolean;
@@ -7,4 +13,4 @@ declare const MODES: {
     readonly view: "view";
     readonly preview: "preview";
 };
-export { ALPHABET, CURVE_UPDATED_EVENT_NAME, STRETCH_UPDATED_EVENT_NAME, MODES, IS_MOBILE };
+export { ALPHABET, ALPHABET_VENUE, CURVE_UPDATED_EVENT_NAME, STRETCH_UPDATED_EVENT_NAME, MODES, IS_MOBILE };

package/dist/helpers/constants/numberingStyles.d.ts

@@ -1,8 +1,35 @@
 /**
  * ROW/SEAT NUMBERING STYLES
- * Configuration options for how rows and seats are labeled
+ * Configuration options for how rows and seats are labeled.
+ *
+ * Supports alphabetic (A, B, C), numeric (1, 2, 3), and Roman numeral (I, II, III)
+ * identifiers for both rows and seats, with configurable separators, presets,
+ * and venue-safe letter exclusion (I, O).
  */
+import { T_Seat } from 'platform-calendar-helpers';
 export type T_NumberingStyle = 'default' | 'compact' | 'full' | 'letter-number';
+export type T_RowIdentifierType = 'alphabetic' | 'numeric' | 'roman';
+export type T_SeatIdentifierType = 'numeric' | 'alphabetic' | 'roman';
+export type T_LabelSeparator = 'none' | 'hyphen' | 'dot' | 'space' | 'full';
+/** Direction options for table seat numbering (shape-aware). */
+export type T_TableSeatDirection = 'clockwise' | 'counter-clockwise' | 'left-to-right' | 'right-to-left' | 'center-out';
+/** Simplified numbering config for table elements (no row concept). */
+export interface T_TableNumberingConfig {
+    /** Show numbers on seats */
+    showSeatNumbers: boolean;
+    /** Seat numbering type (numbers, letters, or roman numerals) */
+    seatNumberingType: T_SeatIdentifierType;
+    /** Numbering direction (shape-aware) */
+    seatNumberingDirection: T_TableSeatDirection;
+    /** Starting seat number */
+    startSeat: number;
+    /** Include seat prefix in labels */
+    includeSeatPrefix: boolean;
+    /** Custom seat prefix string */
+    seatPrefix: string;
+    /** Whether to renumber visible seats when some are hidden */
+    renumberHiddenSeats: boolean;
+}
 export interface T_NumberingConfig {
     /** Style for row labels */
     rowStyle: T_NumberingStyle;
@@ -16,40 +43,201 @@ export interface T_NumberingConfig {
     startRow: string | number;
     /** Starting seat number */
     startSeat: number;
-    /** Row numbering direction (1,2,3 or A,B,C) */
-    rowNumberingType: 'numeric' | 'alphabetic';
+    /** Row numbering type (letters, numbers, or roman numerals) */
+    rowNumberingType: T_RowIdentifierType;
+    /** Seat numbering type (numbers, letters, or roman numerals) */
+    seatNumberingType: T_SeatIdentifierType;
     /** Seat numbering direction */
     seatNumberingDirection: 'left-to-right' | 'right-to-left' | 'center-out';
     /** Include row prefix in labels (e.g., "Row A" vs just "A") */
     includeRowPrefix: boolean;
     /** Include seat prefix in labels (e.g., "Seat 1" vs just "1") */
     includeSeatPrefix: boolean;
+    /** Separator between row and seat in the combined label */
+    separator: T_LabelSeparator;
+    /** Letters to exclude from alphabetic row labels (default: ['I','O']) */
+    excludeLetters: string[];
+    /** Flat numbering mode: ignore rows, label seats 1, 2, 3... globally */
+    flatNumbering: boolean;
+    /** Custom row prefix string (e.g. "Row ", "Section ") */
+    rowPrefix: string;
+    /** Custom seat prefix string (e.g. "Seat ", "") */
+    seatPrefix: string;
+    /** Whether to renumber visible seats when some are hidden */
+    renumberHiddenSeats: boolean;
 }
 export declare const DEFAULT_NUMBERING_CONFIG: T_NumberingConfig;
+export declare const DEFAULT_TABLE_NUMBERING_CONFIG: T_TableNumberingConfig;
+/** Direction options shown for round tables. */
+export declare const TABLE_ROUND_DIRECTION_OPTIONS: ({
+    id: "clockwise";
+    label: string;
+    description: string;
+} | {
+    id: "counter-clockwise";
+    label: string;
+    description: string;
+} | {
+    id: "center-out";
+    label: string;
+    description: string;
+})[];
+/** Direction options shown for square/rectangular tables. */
+export declare const TABLE_SQUARE_DIRECTION_OPTIONS: ({
+    id: "left-to-right";
+    label: string;
+    description: string;
+} | {
+    id: "right-to-left";
+    label: string;
+    description: string;
+} | {
+    id: "center-out";
+    label: string;
+    description: string;
+})[];
 export declare const NUMBERING_STYLE_OPTIONS: {
     id: string;
     label: string;
     description: string;
 }[];
-export declare const ROW_NUMBERING_TYPES: {
-    id: string;
+export declare const ROW_NUMBERING_TYPES: ({
+    id: "alphabetic";
     label: string;
     example: string;
-}[];
+} | {
+    id: "numeric";
+    label: string;
+    example: string;
+} | {
+    id: "roman";
+    label: string;
+    example: string;
+})[];
+export declare const SEAT_NUMBERING_TYPES: ({
+    id: "numeric";
+    label: string;
+    example: string;
+} | {
+    id: "alphabetic";
+    label: string;
+    example: string;
+} | {
+    id: "roman";
+    label: string;
+    example: string;
+})[];
 export declare const SEAT_DIRECTION_OPTIONS: {
     id: string;
     label: string;
     description: string;
 }[];
+export declare const SEPARATOR_OPTIONS: ({
+    id: "none";
+    label: string;
+    example: string;
+} | {
+    id: "hyphen";
+    label: string;
+    example: string;
+} | {
+    id: "dot";
+    label: string;
+    example: string;
+} | {
+    id: "space";
+    label: string;
+    example: string;
+} | {
+    id: "full";
+    label: string;
+    example: string;
+})[];
+/**
+ * Convert a positive integer to a Roman numeral string.
+ * Returns '' for values <= 0 or > 3999.
+ */
+export declare const toRoman: (n: number) => string;
+/**
+ * Convert a Roman numeral string back to a number.
+ * Returns NaN for invalid input.
+ */
+export declare const fromRoman: (s: string) => number;
 /**
- * Generate row label based on index and config
+ * Generate row label based on index and config.
  */
 export declare const generateRowLabel: (rowIndex: number, config: T_NumberingConfig) => string;
 /**
- * Generate seat number based on column index and config
+ * Generate seat identifier based on column index and config.
  */
-export declare const generateSeatNumber: (colIndex: number, totalCols: number, config: T_NumberingConfig) => number | string;
+export declare const generateSeatNumber: (colIndex: number, totalCols: number, config: T_NumberingConfig) => string;
 /**
- * Format seat label based on row and seat
+ * Format seat label based on row and seat identifiers.
  */
 export declare const formatSeatLabel: (rowLabel: string, seatNumber: number | string, config: T_NumberingConfig) => string;
+/**
+ * Compute a display label for a seat, optionally renumbering to skip hidden seats.
+ *
+ * @param rowIndex    - The row index in the grid
+ * @param colIndex    - The column index in the grid
+ * @param rowSeats    - All seats in the same row
+ * @param config      - The numbering config
+ * @param globalIndex - (flat numbering only) The seat's global index across all rows
+ * @param totalSeats  - (flat numbering only) Total number of seats across all rows
+ * @returns The display label string
+ */
+export declare const getDisplaySeatLabel: (rowIndex: number, colIndex: number, rowSeats: T_Seat[], config: T_NumberingConfig, globalIndex?: number, totalSeats?: number, 
+/** (flat numbering only) visible-only global index that skips hidden seats */
+visibleGlobalIndex?: number, 
+/** (flat numbering only) total number of visible seats across all rows */
+totalVisibleSeats?: number) => string;
+/**
+ * Generate a flat (global) seat label ignoring row structure.
+ * Useful for simple venues that just number seats 1, 2, 3...
+ *
+ * @param globalIndex - The seat's position in visual (left-to-right) order
+ * @param totalSeats  - Total number of seats (needed for direction mapping)
+ * @param config      - Numbering configuration
+ */
+export declare const generateFlatSeatLabel: (globalIndex: number, totalSeats: number, config: T_NumberingConfig) => string;
+export type T_IndexingPreset = 'theatre' | 'stadium' | 'classical' | 'simple' | 'full' | 'compact';
+export declare const INDEXING_PRESETS: Record<T_IndexingPreset, Partial<T_NumberingConfig>>;
+/**
+ * Detect which preset (if any) the current numbering config matches.
+ * Returns the preset id or `undefined` when no preset matches.
+ */
+export declare const detectMatchingPreset: (config: Partial<T_NumberingConfig>) => T_IndexingPreset | undefined;
+export declare const INDEXING_PRESET_OPTIONS: ({
+    id: "theatre";
+    label: string;
+    description: string;
+} | {
+    id: "stadium";
+    label: string;
+    description: string;
+} | {
+    id: "classical";
+    label: string;
+    description: string;
+} | {
+    id: "simple";
+    label: string;
+    description: string;
+} | {
+    id: "full";
+    label: string;
+    description: string;
+} | {
+    id: "compact";
+    label: string;
+    description: string;
+})[];
+/**
+ * Generate a seat label for a table element.
+ *
+ * @param seatIndex - The seat's sequential index (0-based, in natural order:
+ *                    clockwise for round, top→right→bottom→left for square)
+ * @param totalSeats - Total number of seats on the table
+ * @param config     - Table numbering configuration
+ */
+export declare const generateTableSeatNumber: (seatIndex: number, totalSeats: number, config: T_TableNumberingConfig) => string;

package/dist/helpers/constants/seatColors.d.ts

@@ -28,6 +28,7 @@ export declare const ZONE_COLORS: {
     box: string;
     accessible: string;
 };
+export declare const TICKET_DEFAULT_PALETTE: string[];
 export declare const SEAT_SELECTION_COLOR = "#3B82F6";
 export declare const SEAT_SELECTION_GLOW = "rgba(59, 130, 246, 0.4)";
 export declare const VIEW_SELECTION_COLOR = "#10B981";

package/dist/helpers/functions/export.d.ts

@@ -4,7 +4,7 @@
  */
 import { T_SeatMap, T_Ticket } from 'platform-calendar-helpers';
 import { T_SeatIndex } from './statistics';
-import { T_SelectedSeats } from "../../store/reducers/elementSelector/types";
+import { T_SelectedSeats } from 'store/reducers/elementSelector/types';
 /** Filters for CSV export (Statistics) */
 export interface T_ExportFilters {
     elementId?: string;

package/dist/helpers/functions/rowLabels.d.ts

@@ -1,6 +1,6 @@
 /**
- * Get row letter from row index, matching the same logic used for seat labels
- * Row 0 = A, Row 1 = B, ..., Row 25 = Z, Row 26 = AA, etc.
+ * Get row letter from row index, using the venue-safe alphabet (excludes I, O).
+ * Row 0 = A, Row 1 = B, ..., Row 7 = H, Row 8 = J (skips I), etc.
  * @param rowIndex Zero-based row index
  * @returns Row letter(s) (e.g., "A", "B", "AA")
  */

package/dist/helpers/functions/seatMap.d.ts

@@ -1,5 +1,5 @@
 import { T_Seat, T_SeatMap } from 'platform-calendar-helpers';
-import { T_SelectedSeats } from "../../store/reducers/elementSelector/types";
+import { T_SelectedSeats } from 'store/reducers/elementSelector/types';
 declare const removeFakeElementsFromSeatMap: (_seatMap: T_SeatMap) => {
     elements: {
         objects: import("platform-calendar-helpers").T_Element_Object[];
@@ -12,6 +12,7 @@ declare const removeFakeElementsFromSeatMap: (_seatMap: T_SeatMap) => {
     id: number;
     name: string;
     backgroundColor?: string;
+    ticketColors?: Record<string, string>;
 };
 declare const addFakeElementsToSeatMap: (_seatMap: T_SeatMap) => T_SeatMap;
 /**

package/dist/helpers/functions/seatStatus.d.ts

@@ -1,6 +1,12 @@
-import { T_Seat } from 'platform-calendar-helpers';
-import { T_SeatColors } from "../constants/seatColors";
-export type { T_SeatColors } from "../constants/seatColors";
+import { T_Seat, T_Ticket } from 'platform-calendar-helpers';
+import { T_SeatColors } from 'helpers/constants/seatColors';
+export type { T_SeatColors } from 'helpers/constants/seatColors';
+/**
+ * Generates a `ticketColors` map for all provided tickets.
+ * Assigns colors sequentially from the curated palette for maximum contrast.
+ * Beyond 16 tickets, cycles through darkened variants.
+ */
+export declare const generateTicketColors: (tickets: T_Ticket[], existing?: Record<string, string>) => Record<string, string>;
 export type T_SeatStatus = 'available' | 'locked' | 'unassigned' | 'sold';
 /**
  * Determines the status of a seat based on its locked state, whether it's sold, and if it has a ticket assigned
@@ -9,12 +15,16 @@ export declare const getSeatStatus: (seat: T_Seat, soldSeatIds: Set<string | num
     [key: string | number]: boolean;
 }) => T_SeatStatus;
 /**
- * Gets the appropriate color for a seat based on its status
+ * Gets the appropriate color for a seat based on its status.
+ * When the seat is 'available' and a per-ticket color is defined in ticketColors,
+ * that color takes priority over the generic available color.
+ * Locked seats use their assigned ticket color (same as available seats), not a dedicated lock color.
  */
 export declare const getSeatColor: (seat: T_Seat, seatColors: T_SeatColors, soldSeatIds: Set<string | number>, ticketIds?: {
     [key: string | number]: boolean;
-}) => string;
+}, ticketColors?: Record<string, string>) => string;
 /**
- * Gets seat colors with fallback to defaults if missing
+ * Gets seat colors with fallback to defaults if missing.
+ * Locked seats now use ticket color (no dedicated lock color), but we keep locked in the type for backward compat.
  */
 export declare const getSeatColorsWithDefaults: (seatColors?: Partial<T_SeatColors> | null) => T_SeatColors;