@zonetrix/shared 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,235 @@
+/**
+ * Centralized type definitions for the Seat Map Studio packages
+ */
+type SeatState = "available" | "reserved" | "selected" | "unavailable";
+type SeatShape = "circle" | "square" | "rounded-square";
+type Tool = "select" | "seat" | "row" | "section" | "stage";
+type EditorMode = "edit" | "read";
+/**
+ * Seat data structure used in the editor and viewer
+ */
+interface SeatData {
+    seatState: SeatState;
+    shape?: SeatShape;
+    sectionName?: string;
+    rowLabel?: string;
+    columnLabel?: string;
+    price?: number;
+    seatNumber?: string;
+}
+/**
+ * Section configuration for creating seat groups
+ */
+interface SectionConfig {
+    name: string;
+    rows: number;
+    columns: number;
+    startRow?: string;
+    startColumn?: number;
+    price?: number;
+    color?: string;
+    locked?: boolean;
+}
+/**
+ * Row pricing structure for section-based pricing
+ */
+interface RowPricing {
+    sectionName: string;
+    rowLabel: string;
+    price: number;
+}
+/**
+ * Stage configuration for theater/venue stages
+ */
+interface StageConfig {
+    label: string;
+    width: number;
+    height: number;
+    rotation?: number;
+    color?: string;
+}
+/**
+ * Color settings for customizing the appearance
+ */
+interface ColorSettings {
+    canvasBackground: string;
+    stageColor: string;
+    seatAvailable: string;
+    seatReserved: string;
+    seatSelected: string;
+    seatUnavailable: string;
+    gridLines: string;
+    currency: string;
+}
+/**
+ * Default color palette
+ */
+declare const DEFAULT_COLORS: ColorSettings;
+/**
+ * Alignment guide for visual assistance
+ */
+interface AlignmentGuide {
+    position: number;
+    orientation: "horizontal" | "vertical";
+}
+/**
+ * Canvas state for view management
+ */
+interface CanvasState {
+    zoom: number;
+    panX: number;
+    panY: number;
+    gridSize: number;
+    gridEnabled: boolean;
+    snapToGrid: boolean;
+}
+/**
+ * Booking selection for read mode
+ */
+interface BookingSelection {
+    seats: SeatData[];
+    totalPrice: number;
+    count: number;
+}
+declare const calculateSeatPrice: (seat: SeatData, rowPricing: RowPricing[], sectionPrice?: number) => number;
+/**
+ * Serialized seat for JSON export/import
+ */
+interface SerializedSeat {
+    id: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    shape: SeatShape;
+    state: SeatState;
+    sectionName?: string;
+    rowLabel?: string;
+    columnLabel?: string;
+    seatNumber?: string;
+    price?: number;
+}
+/**
+ * Serialized section for JSON export/import
+ */
+interface SerializedSection {
+    id: string;
+    name: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    config: SectionConfig;
+    seatIds: string[];
+}
+/**
+ * Serialized stage for JSON export/import
+ */
+interface SerializedStage {
+    id: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    config: StageConfig;
+}
+/**
+ * Canvas configuration for export/import
+ */
+interface CanvasConfig {
+    width: number;
+    height: number;
+    backgroundColor: string;
+}
+/**
+ * Metadata for seat map configuration
+ */
+interface SeatMapMetadata {
+    name: string;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+    venue?: string;
+    capacity?: number;
+}
+/**
+ * Complete seat map configuration for export/import
+ * This is the main interface used for JSON serialization
+ */
+interface SeatMapConfig {
+    version: string;
+    metadata: SeatMapMetadata;
+    canvas: CanvasConfig;
+    colors: ColorSettings;
+    seats: SerializedSeat[];
+    sections?: SerializedSection[];
+    stages?: SerializedStage[];
+}
+/**
+ * Validation result for config validation
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+
+/**
+ * Validates a seat map configuration
+ */
+declare function validateSeatMapConfig(config: any): ValidationResult;
+/**
+ * Generates a unique ID for seat map objects
+ */
+declare function generateId(prefix?: string): string;
+/**
+ * Formats a date for metadata
+ */
+declare function formatDate(date?: Date): string;
+
+/**
+ * Creates a default seat map configuration
+ */
+declare function createDefaultConfig(name?: string): SeatMapConfig;
+/**
+ * Updates the metadata timestamp
+ */
+declare function updateConfigTimestamp(config: SeatMapConfig): SeatMapConfig;
+/**
+ * Merges seat state overrides into a config
+ * @param config - Base configuration
+ * @param reservedSeats - Array of seat IDs to mark as reserved
+ * @param unavailableSeats - Array of seat IDs to mark as unavailable
+ */
+declare function applySeatStateOverrides(config: SeatMapConfig, reservedSeats?: string[], unavailableSeats?: string[]): SeatMapConfig;
+/**
+ * Extracts selected seats from a config
+ */
+declare function getSelectedSeats(config: SeatMapConfig): SerializedSeat[];
+/**
+ * Calculates total capacity of a seat map
+ */
+declare function calculateCapacity(config: SeatMapConfig): number;
+/**
+ * Calculates available seats count
+ */
+declare function calculateAvailableSeats(config: SeatMapConfig): number;
+/**
+ * Deep clones a seat map config
+ */
+declare function cloneConfig(config: SeatMapConfig): SeatMapConfig;
+/**
+ * Exports config as JSON string
+ */
+declare function exportConfigAsJSON(config: SeatMapConfig, pretty?: boolean): string;
+/**
+ * Imports config from JSON string
+ */
+declare function importConfigFromJSON(jsonString: string): SeatMapConfig;
+/**
+ * Downloads config as a JSON file
+ * Note: This function is meant for browser environments
+ */
+declare function downloadConfigAsFile(config: SeatMapConfig, filename?: string): void;
+
+export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, type RowPricing, type SeatData, type SeatMapConfig, type SeatMapMetadata, type SeatShape, type SeatState, type SectionConfig, type SerializedSeat, type SerializedSection, type SerializedStage, type StageConfig, type Tool, type ValidationResult, applySeatStateOverrides, calculateAvailableSeats, calculateCapacity, calculateSeatPrice, cloneConfig, createDefaultConfig, downloadConfigAsFile, exportConfigAsJSON, formatDate, generateId, getSelectedSeats, importConfigFromJSON, updateConfigTimestamp, validateSeatMapConfig };

package/dist/index.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Centralized type definitions for the Seat Map Studio packages
+ */
+type SeatState = "available" | "reserved" | "selected" | "unavailable";
+type SeatShape = "circle" | "square" | "rounded-square";
+type Tool = "select" | "seat" | "row" | "section" | "stage";
+type EditorMode = "edit" | "read";
+/**
+ * Seat data structure used in the editor and viewer
+ */
+interface SeatData {
+    seatState: SeatState;
+    shape?: SeatShape;
+    sectionName?: string;
+    rowLabel?: string;
+    columnLabel?: string;
+    price?: number;
+    seatNumber?: string;
+}
+/**
+ * Section configuration for creating seat groups
+ */
+interface SectionConfig {
+    name: string;
+    rows: number;
+    columns: number;
+    startRow?: string;
+    startColumn?: number;
+    price?: number;
+    color?: string;
+    locked?: boolean;
+}
+/**
+ * Row pricing structure for section-based pricing
+ */
+interface RowPricing {
+    sectionName: string;
+    rowLabel: string;
+    price: number;
+}
+/**
+ * Stage configuration for theater/venue stages
+ */
+interface StageConfig {
+    label: string;
+    width: number;
+    height: number;
+    rotation?: number;
+    color?: string;
+}
+/**
+ * Color settings for customizing the appearance
+ */
+interface ColorSettings {
+    canvasBackground: string;
+    stageColor: string;
+    seatAvailable: string;
+    seatReserved: string;
+    seatSelected: string;
+    seatUnavailable: string;
+    gridLines: string;
+    currency: string;
+}
+/**
+ * Default color palette
+ */
+declare const DEFAULT_COLORS: ColorSettings;
+/**
+ * Alignment guide for visual assistance
+ */
+interface AlignmentGuide {
+    position: number;
+    orientation: "horizontal" | "vertical";
+}
+/**
+ * Canvas state for view management
+ */
+interface CanvasState {
+    zoom: number;
+    panX: number;
+    panY: number;
+    gridSize: number;
+    gridEnabled: boolean;
+    snapToGrid: boolean;
+}
+/**
+ * Booking selection for read mode
+ */
+interface BookingSelection {
+    seats: SeatData[];
+    totalPrice: number;
+    count: number;
+}
+declare const calculateSeatPrice: (seat: SeatData, rowPricing: RowPricing[], sectionPrice?: number) => number;
+/**
+ * Serialized seat for JSON export/import
+ */
+interface SerializedSeat {
+    id: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    shape: SeatShape;
+    state: SeatState;
+    sectionName?: string;
+    rowLabel?: string;
+    columnLabel?: string;
+    seatNumber?: string;
+    price?: number;
+}
+/**
+ * Serialized section for JSON export/import
+ */
+interface SerializedSection {
+    id: string;
+    name: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    config: SectionConfig;
+    seatIds: string[];
+}
+/**
+ * Serialized stage for JSON export/import
+ */
+interface SerializedStage {
+    id: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    config: StageConfig;
+}
+/**
+ * Canvas configuration for export/import
+ */
+interface CanvasConfig {
+    width: number;
+    height: number;
+    backgroundColor: string;
+}
+/**
+ * Metadata for seat map configuration
+ */
+interface SeatMapMetadata {
+    name: string;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+    venue?: string;
+    capacity?: number;
+}
+/**
+ * Complete seat map configuration for export/import
+ * This is the main interface used for JSON serialization
+ */
+interface SeatMapConfig {
+    version: string;
+    metadata: SeatMapMetadata;
+    canvas: CanvasConfig;
+    colors: ColorSettings;
+    seats: SerializedSeat[];
+    sections?: SerializedSection[];
+    stages?: SerializedStage[];
+}
+/**
+ * Validation result for config validation
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+
+/**
+ * Validates a seat map configuration
+ */
+declare function validateSeatMapConfig(config: any): ValidationResult;
+/**
+ * Generates a unique ID for seat map objects
+ */
+declare function generateId(prefix?: string): string;
+/**
+ * Formats a date for metadata
+ */
+declare function formatDate(date?: Date): string;
+
+/**
+ * Creates a default seat map configuration
+ */
+declare function createDefaultConfig(name?: string): SeatMapConfig;
+/**
+ * Updates the metadata timestamp
+ */
+declare function updateConfigTimestamp(config: SeatMapConfig): SeatMapConfig;
+/**
+ * Merges seat state overrides into a config
+ * @param config - Base configuration
+ * @param reservedSeats - Array of seat IDs to mark as reserved
+ * @param unavailableSeats - Array of seat IDs to mark as unavailable
+ */
+declare function applySeatStateOverrides(config: SeatMapConfig, reservedSeats?: string[], unavailableSeats?: string[]): SeatMapConfig;
+/**
+ * Extracts selected seats from a config
+ */
+declare function getSelectedSeats(config: SeatMapConfig): SerializedSeat[];
+/**
+ * Calculates total capacity of a seat map
+ */
+declare function calculateCapacity(config: SeatMapConfig): number;
+/**
+ * Calculates available seats count
+ */
+declare function calculateAvailableSeats(config: SeatMapConfig): number;
+/**
+ * Deep clones a seat map config
+ */
+declare function cloneConfig(config: SeatMapConfig): SeatMapConfig;
+/**
+ * Exports config as JSON string
+ */
+declare function exportConfigAsJSON(config: SeatMapConfig, pretty?: boolean): string;
+/**
+ * Imports config from JSON string
+ */
+declare function importConfigFromJSON(jsonString: string): SeatMapConfig;
+/**
+ * Downloads config as a JSON file
+ * Note: This function is meant for browser environments
+ */
+declare function downloadConfigAsFile(config: SeatMapConfig, filename?: string): void;
+
+export { type AlignmentGuide, type BookingSelection, type CanvasConfig, type CanvasState, type ColorSettings, DEFAULT_COLORS, type EditorMode, type RowPricing, type SeatData, type SeatMapConfig, type SeatMapMetadata, type SeatShape, type SeatState, type SectionConfig, type SerializedSeat, type SerializedSection, type SerializedStage, type StageConfig, type Tool, type ValidationResult, applySeatStateOverrides, calculateAvailableSeats, calculateCapacity, calculateSeatPrice, cloneConfig, createDefaultConfig, downloadConfigAsFile, exportConfigAsJSON, formatDate, generateId, getSelectedSeats, importConfigFromJSON, updateConfigTimestamp, validateSeatMapConfig };

package/dist/index.js

@@ -0,0 +1,281 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_COLORS: () => DEFAULT_COLORS,
+  applySeatStateOverrides: () => applySeatStateOverrides,
+  calculateAvailableSeats: () => calculateAvailableSeats,
+  calculateCapacity: () => calculateCapacity,
+  calculateSeatPrice: () => calculateSeatPrice,
+  cloneConfig: () => cloneConfig,
+  createDefaultConfig: () => createDefaultConfig,
+  downloadConfigAsFile: () => downloadConfigAsFile,
+  exportConfigAsJSON: () => exportConfigAsJSON,
+  formatDate: () => formatDate,
+  generateId: () => generateId,
+  getSelectedSeats: () => getSelectedSeats,
+  importConfigFromJSON: () => importConfigFromJSON,
+  updateConfigTimestamp: () => updateConfigTimestamp,
+  validateSeatMapConfig: () => validateSeatMapConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types/seatMap.ts
+var DEFAULT_COLORS = {
+  canvasBackground: "#1a1a1a",
+  stageColor: "#808080",
+  seatAvailable: "#2C2B30",
+  seatReserved: "#FCEA00",
+  seatSelected: "#3A7DE5",
+  seatUnavailable: "#6b7280",
+  gridLines: "#404040",
+  currency: "KD"
+};
+var calculateSeatPrice = (seat, rowPricing, sectionPrice) => {
+  if (seat.price !== void 0) return seat.price;
+  const rowPrice = rowPricing.find(
+    (rp) => rp.sectionName === seat.sectionName && rp.rowLabel === seat.rowLabel
+  );
+  if (rowPrice) return rowPrice.price;
+  return sectionPrice || 0;
+};
+
+// src/utils/validator.ts
+function validateSeatMapConfig(config) {
+  const errors = [];
+  const warnings = [];
+  if (!config) {
+    errors.push("Config is null or undefined");
+    return { valid: false, errors, warnings };
+  }
+  if (!config.version || typeof config.version !== "string") {
+    errors.push("Missing or invalid version field");
+  }
+  if (!config.metadata) {
+    errors.push("Missing metadata");
+  } else {
+    if (!config.metadata.name || typeof config.metadata.name !== "string") {
+      errors.push("Missing or invalid metadata.name");
+    }
+    if (!config.metadata.createdAt || typeof config.metadata.createdAt !== "string") {
+      warnings.push("Missing or invalid metadata.createdAt");
+    }
+    if (!config.metadata.updatedAt || typeof config.metadata.updatedAt !== "string") {
+      warnings.push("Missing or invalid metadata.updatedAt");
+    }
+  }
+  if (!config.canvas) {
+    errors.push("Missing canvas configuration");
+  } else {
+    if (typeof config.canvas.width !== "number" || config.canvas.width <= 0) {
+      errors.push("Invalid canvas width");
+    }
+    if (typeof config.canvas.height !== "number" || config.canvas.height <= 0) {
+      errors.push("Invalid canvas height");
+    }
+    if (!config.canvas.backgroundColor || typeof config.canvas.backgroundColor !== "string") {
+      warnings.push("Missing or invalid canvas background color");
+    }
+  }
+  if (!config.colors) {
+    warnings.push("Missing color configuration");
+  } else {
+    const requiredColors = [
+      "canvasBackground",
+      "stageColor",
+      "seatAvailable",
+      "seatReserved",
+      "seatSelected",
+      "seatUnavailable",
+      "gridLines"
+    ];
+    requiredColors.forEach((color) => {
+      if (!config.colors[color] || typeof config.colors[color] !== "string") {
+        warnings.push(`Missing or invalid color: ${color}`);
+      }
+    });
+  }
+  if (!config.seats || !Array.isArray(config.seats)) {
+    errors.push("Missing or invalid seats array");
+  } else {
+    config.seats.forEach((seat, index) => {
+      if (!seat.id || typeof seat.id !== "string") {
+        errors.push(`Seat at index ${index} missing or invalid id`);
+      }
+      if (!seat.position || typeof seat.position.x !== "number" || typeof seat.position.y !== "number") {
+        errors.push(`Seat at index ${index} missing or invalid position`);
+      }
+      if (!isValidSeatShape(seat.shape)) {
+        errors.push(`Seat at index ${index} has invalid shape: ${seat.shape}`);
+      }
+      if (!isValidSeatState(seat.state)) {
+        errors.push(`Seat at index ${index} has invalid state: ${seat.state}`);
+      }
+    });
+    const seatIds = config.seats.map((s) => s.id);
+    const duplicates = seatIds.filter((id, index) => seatIds.indexOf(id) !== index);
+    if (duplicates.length > 0) {
+      errors.push(`Duplicate seat IDs found: ${duplicates.join(", ")}`);
+    }
+  }
+  if (config.sections && Array.isArray(config.sections)) {
+    config.sections.forEach((section, index) => {
+      if (!section.id || typeof section.id !== "string") {
+        warnings.push(`Section at index ${index} missing or invalid id`);
+      }
+      if (!section.name || typeof section.name !== "string") {
+        warnings.push(`Section at index ${index} missing or invalid name`);
+      }
+      if (!section.config) {
+        warnings.push(`Section at index ${index} missing config`);
+      }
+    });
+  }
+  if (config.stages && Array.isArray(config.stages)) {
+    config.stages.forEach((stage, index) => {
+      if (!stage.id || typeof stage.id !== "string") {
+        warnings.push(`Stage at index ${index} missing or invalid id`);
+      }
+      if (!stage.config || !stage.config.label) {
+        warnings.push(`Stage at index ${index} missing or invalid config`);
+      }
+    });
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function isValidSeatState(state) {
+  return ["available", "reserved", "selected", "unavailable"].includes(state);
+}
+function isValidSeatShape(shape) {
+  return ["circle", "square", "rounded-square"].includes(shape);
+}
+function generateId(prefix = "obj") {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+function formatDate(date = /* @__PURE__ */ new Date()) {
+  return date.toISOString();
+}
+
+// src/utils/serializer.ts
+function createDefaultConfig(name = "Untitled Venue") {
+  return {
+    version: "1.0.0",
+    metadata: {
+      name,
+      createdAt: formatDate(),
+      updatedAt: formatDate()
+    },
+    canvas: {
+      width: 1200,
+      height: 800,
+      backgroundColor: DEFAULT_COLORS.canvasBackground
+    },
+    colors: { ...DEFAULT_COLORS },
+    seats: [],
+    sections: [],
+    stages: []
+  };
+}
+function updateConfigTimestamp(config) {
+  return {
+    ...config,
+    metadata: {
+      ...config.metadata,
+      updatedAt: formatDate()
+    }
+  };
+}
+function applySeatStateOverrides(config, reservedSeats, unavailableSeats) {
+  if (!reservedSeats && !unavailableSeats) {
+    return config;
+  }
+  const reservedSet = new Set(reservedSeats || []);
+  const unavailableSet = new Set(unavailableSeats || []);
+  return {
+    ...config,
+    seats: config.seats.map((seat) => {
+      let newState = seat.state;
+      if (unavailableSet.has(seat.id) || unavailableSet.has(seat.seatNumber || "")) {
+        newState = "unavailable";
+      } else if (reservedSet.has(seat.id) || reservedSet.has(seat.seatNumber || "")) {
+        newState = "reserved";
+      }
+      return newState !== seat.state ? { ...seat, state: newState } : seat;
+    })
+  };
+}
+function getSelectedSeats(config) {
+  return config.seats.filter((seat) => seat.state === "selected");
+}
+function calculateCapacity(config) {
+  return config.seats.length;
+}
+function calculateAvailableSeats(config) {
+  return config.seats.filter((seat) => seat.state === "available").length;
+}
+function cloneConfig(config) {
+  return JSON.parse(JSON.stringify(config));
+}
+function exportConfigAsJSON(config, pretty = true) {
+  return pretty ? JSON.stringify(config, null, 2) : JSON.stringify(config);
+}
+function importConfigFromJSON(jsonString) {
+  try {
+    const config = JSON.parse(jsonString);
+    return config;
+  } catch (error) {
+    throw new Error(`Failed to parse JSON: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+function downloadConfigAsFile(config, filename = "seat-map-config.json") {
+  const jsonString = exportConfigAsJSON(config);
+  const blob = new Blob([jsonString], { type: "application/json" });
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  URL.revokeObjectURL(url);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_COLORS,
+  applySeatStateOverrides,
+  calculateAvailableSeats,
+  calculateCapacity,
+  calculateSeatPrice,
+  cloneConfig,
+  createDefaultConfig,
+  downloadConfigAsFile,
+  exportConfigAsJSON,
+  formatDate,
+  generateId,
+  getSelectedSeats,
+  importConfigFromJSON,
+  updateConfigTimestamp,
+  validateSeatMapConfig
+});

package/dist/index.mjs

@@ -0,0 +1,240 @@
+// src/types/seatMap.ts
+var DEFAULT_COLORS = {
+  canvasBackground: "#1a1a1a",
+  stageColor: "#808080",
+  seatAvailable: "#2C2B30",
+  seatReserved: "#FCEA00",
+  seatSelected: "#3A7DE5",
+  seatUnavailable: "#6b7280",
+  gridLines: "#404040",
+  currency: "KD"
+};
+var calculateSeatPrice = (seat, rowPricing, sectionPrice) => {
+  if (seat.price !== void 0) return seat.price;
+  const rowPrice = rowPricing.find(
+    (rp) => rp.sectionName === seat.sectionName && rp.rowLabel === seat.rowLabel
+  );
+  if (rowPrice) return rowPrice.price;
+  return sectionPrice || 0;
+};
+
+// src/utils/validator.ts
+function validateSeatMapConfig(config) {
+  const errors = [];
+  const warnings = [];
+  if (!config) {
+    errors.push("Config is null or undefined");
+    return { valid: false, errors, warnings };
+  }
+  if (!config.version || typeof config.version !== "string") {
+    errors.push("Missing or invalid version field");
+  }
+  if (!config.metadata) {
+    errors.push("Missing metadata");
+  } else {
+    if (!config.metadata.name || typeof config.metadata.name !== "string") {
+      errors.push("Missing or invalid metadata.name");
+    }
+    if (!config.metadata.createdAt || typeof config.metadata.createdAt !== "string") {
+      warnings.push("Missing or invalid metadata.createdAt");
+    }
+    if (!config.metadata.updatedAt || typeof config.metadata.updatedAt !== "string") {
+      warnings.push("Missing or invalid metadata.updatedAt");
+    }
+  }
+  if (!config.canvas) {
+    errors.push("Missing canvas configuration");
+  } else {
+    if (typeof config.canvas.width !== "number" || config.canvas.width <= 0) {
+      errors.push("Invalid canvas width");
+    }
+    if (typeof config.canvas.height !== "number" || config.canvas.height <= 0) {
+      errors.push("Invalid canvas height");
+    }
+    if (!config.canvas.backgroundColor || typeof config.canvas.backgroundColor !== "string") {
+      warnings.push("Missing or invalid canvas background color");
+    }
+  }
+  if (!config.colors) {
+    warnings.push("Missing color configuration");
+  } else {
+    const requiredColors = [
+      "canvasBackground",
+      "stageColor",
+      "seatAvailable",
+      "seatReserved",
+      "seatSelected",
+      "seatUnavailable",
+      "gridLines"
+    ];
+    requiredColors.forEach((color) => {
+      if (!config.colors[color] || typeof config.colors[color] !== "string") {
+        warnings.push(`Missing or invalid color: ${color}`);
+      }
+    });
+  }
+  if (!config.seats || !Array.isArray(config.seats)) {
+    errors.push("Missing or invalid seats array");
+  } else {
+    config.seats.forEach((seat, index) => {
+      if (!seat.id || typeof seat.id !== "string") {
+        errors.push(`Seat at index ${index} missing or invalid id`);
+      }
+      if (!seat.position || typeof seat.position.x !== "number" || typeof seat.position.y !== "number") {
+        errors.push(`Seat at index ${index} missing or invalid position`);
+      }
+      if (!isValidSeatShape(seat.shape)) {
+        errors.push(`Seat at index ${index} has invalid shape: ${seat.shape}`);
+      }
+      if (!isValidSeatState(seat.state)) {
+        errors.push(`Seat at index ${index} has invalid state: ${seat.state}`);
+      }
+    });
+    const seatIds = config.seats.map((s) => s.id);
+    const duplicates = seatIds.filter((id, index) => seatIds.indexOf(id) !== index);
+    if (duplicates.length > 0) {
+      errors.push(`Duplicate seat IDs found: ${duplicates.join(", ")}`);
+    }
+  }
+  if (config.sections && Array.isArray(config.sections)) {
+    config.sections.forEach((section, index) => {
+      if (!section.id || typeof section.id !== "string") {
+        warnings.push(`Section at index ${index} missing or invalid id`);
+      }
+      if (!section.name || typeof section.name !== "string") {
+        warnings.push(`Section at index ${index} missing or invalid name`);
+      }
+      if (!section.config) {
+        warnings.push(`Section at index ${index} missing config`);
+      }
+    });
+  }
+  if (config.stages && Array.isArray(config.stages)) {
+    config.stages.forEach((stage, index) => {
+      if (!stage.id || typeof stage.id !== "string") {
+        warnings.push(`Stage at index ${index} missing or invalid id`);
+      }
+      if (!stage.config || !stage.config.label) {
+        warnings.push(`Stage at index ${index} missing or invalid config`);
+      }
+    });
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function isValidSeatState(state) {
+  return ["available", "reserved", "selected", "unavailable"].includes(state);
+}
+function isValidSeatShape(shape) {
+  return ["circle", "square", "rounded-square"].includes(shape);
+}
+function generateId(prefix = "obj") {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+function formatDate(date = /* @__PURE__ */ new Date()) {
+  return date.toISOString();
+}
+
+// src/utils/serializer.ts
+function createDefaultConfig(name = "Untitled Venue") {
+  return {
+    version: "1.0.0",
+    metadata: {
+      name,
+      createdAt: formatDate(),
+      updatedAt: formatDate()
+    },
+    canvas: {
+      width: 1200,
+      height: 800,
+      backgroundColor: DEFAULT_COLORS.canvasBackground
+    },
+    colors: { ...DEFAULT_COLORS },
+    seats: [],
+    sections: [],
+    stages: []
+  };
+}
+function updateConfigTimestamp(config) {
+  return {
+    ...config,
+    metadata: {
+      ...config.metadata,
+      updatedAt: formatDate()
+    }
+  };
+}
+function applySeatStateOverrides(config, reservedSeats, unavailableSeats) {
+  if (!reservedSeats && !unavailableSeats) {
+    return config;
+  }
+  const reservedSet = new Set(reservedSeats || []);
+  const unavailableSet = new Set(unavailableSeats || []);
+  return {
+    ...config,
+    seats: config.seats.map((seat) => {
+      let newState = seat.state;
+      if (unavailableSet.has(seat.id) || unavailableSet.has(seat.seatNumber || "")) {
+        newState = "unavailable";
+      } else if (reservedSet.has(seat.id) || reservedSet.has(seat.seatNumber || "")) {
+        newState = "reserved";
+      }
+      return newState !== seat.state ? { ...seat, state: newState } : seat;
+    })
+  };
+}
+function getSelectedSeats(config) {
+  return config.seats.filter((seat) => seat.state === "selected");
+}
+function calculateCapacity(config) {
+  return config.seats.length;
+}
+function calculateAvailableSeats(config) {
+  return config.seats.filter((seat) => seat.state === "available").length;
+}
+function cloneConfig(config) {
+  return JSON.parse(JSON.stringify(config));
+}
+function exportConfigAsJSON(config, pretty = true) {
+  return pretty ? JSON.stringify(config, null, 2) : JSON.stringify(config);
+}
+function importConfigFromJSON(jsonString) {
+  try {
+    const config = JSON.parse(jsonString);
+    return config;
+  } catch (error) {
+    throw new Error(`Failed to parse JSON: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+function downloadConfigAsFile(config, filename = "seat-map-config.json") {
+  const jsonString = exportConfigAsJSON(config);
+  const blob = new Blob([jsonString], { type: "application/json" });
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  URL.revokeObjectURL(url);
+}
+export {
+  DEFAULT_COLORS,
+  applySeatStateOverrides,
+  calculateAvailableSeats,
+  calculateCapacity,
+  calculateSeatPrice,
+  cloneConfig,
+  createDefaultConfig,
+  downloadConfigAsFile,
+  exportConfigAsJSON,
+  formatDate,
+  generateId,
+  getSelectedSeats,
+  importConfigFromJSON,
+  updateConfigTimestamp,
+  validateSeatMapConfig
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@zonetrix/shared",
+  "version": "1.0.0",
+  "description": "Shared types and utilities for seat-map-studio packages",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+  },
+  "keywords": [
+    "seat-map",
+    "types",
+    "shared"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.8.3"
+  }
+}