{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Tour Configuration Schema",
  "description": "Complete tour configuration schema for guided tours",
  "type": "object",
  "required": ["id"],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the tour"
    },
    "steps": {
      "type": "array",
      "description": "Array of tour step configurations",
      "items": {
        "$ref": "#/definitions/TourStepConfiguration"
      }
    },
    "stepDefaults": {
      "description": "Default settings applied to all steps. Individual step settings will override these defaults",
      "$ref": "#/definitions/TourStepDefaultsConfiguration"
    },
    "keyboard": {
      "description": "Keyboard interaction settings",
      "$ref": "#/definitions/KeyboardSettings"
    },
    "exit": {
      "description": "Exit behavior settings",
      "$ref": "#/definitions/ExitSettings"
    },
    "visual": {
      "description": "Visual appearance settings",
      "$ref": "#/definitions/VisualSettings"
    }
  },
  "definitions": {
    "TourStepConfiguration": {
      "type": "object",
      "required": ["id"],
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the step"
        },
        "content": {
          "$ref": "#/definitions/TourStepContent",
          "description": "Content configuration"
        },
        "target": {
          "$ref": "#/definitions/TargetElement",
          "description": "Target element configuration"
        },
        "container": {
          "$ref": "#/definitions/StepContainerSettings",
          "description": "Container configuration"
        },
        "highlight": {
          "$ref": "#/definitions/HighlightSettings",
          "description": "Highlight configuration"
        },
        "navigation": {
          "$ref": "#/definitions/TourStepNavigation",
          "description": "Navigation configuration"
        },
        "behavior": {
          "$ref": "#/definitions/TourStepBehavior",
          "description": "Behavior configuration"
        },
        "canClickTarget": {
          "type": "boolean",
          "description": "Controls whether users can interact with the step target element",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "TourStepDefaultsConfiguration": {
      "type": "object",
      "properties": {
        "content": {
          "$ref": "#/definitions/TourStepContent",
          "description": "Content configuration"
        },
        "target": {
          "$ref": "#/definitions/TargetElement",
          "description": "Target element configuration"
        },
        "container": {
          "$ref": "#/definitions/StepContainerSettings",
          "description": "Container configuration"
        },
        "highlight": {
          "$ref": "#/definitions/HighlightSettings",
          "description": "Highlight configuration"
        },
        "navigation": {
          "$ref": "#/definitions/TourStepNavigation",
          "description": "Navigation configuration"
        },
        "behavior": {
          "$ref": "#/definitions/TourStepBehavior",
          "description": "Behavior configuration"
        },
        "canClickTarget": {
          "type": "boolean",
          "description": "Controls whether users can interact with the step target element",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "TourStepContent": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Step title"
        },
        "body": {
          "type": "string",
          "description": "Step content/description body"
        },
        "image": {
          "$ref": "#/definitions/TourStepImage",
          "description": "Optional image to display in the step"
        }
      },
      "additionalProperties": false
    },
    "TourStepImage": {
      "type": "object",
      "required": ["src", "alt"],
      "properties": {
        "src": {
          "type": "string",
          "description": "Source URL for the image"
        },
        "alt": {
          "type": "string",
          "description": "Alternative text for accessibility"
        },
        "width": {
          "type": "number",
          "description": "Width of the image in pixels"
        },
        "height": {
          "type": "number",
          "description": "Height of the image in pixels"
        }
      },
      "additionalProperties": false
    },
    "TargetElement": {
      "type": "object",
      "properties": {
        "selector": {
          "type": "string",
          "description": "CSS selector for the target element"
        },
        "placement": {
          "type": "string",
          "enum": ["auto", "top", "right", "bottom", "left", "auto-start", "auto-end", "top-start", "top-end", "bottom-start", "bottom-end", "left-start", "left-end", "right-start", "right-end"],
          "description": "Position relative to target",
          "default": "auto"
        }
      },
      "additionalProperties": false
    },
    "StepContainerSettings": {
      "type": "object",
      "properties": {
        "arrow": {
          "oneOf": [
            {
              "type": "boolean",
              "description": "Controls visibility of directional arrow"
            },
            {
              "$ref": "#/definitions/CustomArrowImageOptions",
              "description": "Custom arrow image configuration"
            }
          ],
          "default": true
        },
        "offset": {
          "$ref": "#/definitions/OffsetValue",
          "description": "Offset configuration for the step container position"
        }
      },
      "additionalProperties": false
    },
    "HighlightSettings": {
      "type": "object",
      "properties": {
        "additionalHighlightSelectors": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Additional element selectors to highlight during the step",
          "default": []
        },
        "xOffset": {
          "type": "number",
          "description": "X-axis offset in pixels",
          "default": 0
        },
        "yOffset": {
          "type": "number",
          "description": "Y-axis offset in pixels",
          "default": 0
        },
        "padding": {
          "type": "number",
          "description": "Padding for highlight area",
          "default": 0
        },
        "borderRadius": {
          "oneOf": [
            {
              "type": "number"
            },
            {
              "$ref": "#/definitions/BorderRadiusConfig"
            }
          ],
          "description": "Border radius for highlight area",
          "default": 0
        }
      },
      "additionalProperties": false
    },
    "BorderRadiusConfig": {
      "type": "object",
      "properties": {
        "topLeft": {
          "type": "number"
        },
        "bottomLeft": {
          "type": "number"
        },
        "bottomRight": {
          "type": "number"
        },
        "topRight": {
          "type": "number"
        }
      },
      "additionalProperties": false
    },
    "TourStepNavigation": {
      "type": "object",
      "properties": {
        "buttons": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/StepOptionsButton"
          },
          "description": "Navigation buttons configuration"
        },
        "cancelIcon": {
          "$ref": "#/definitions/CancelIcon",
          "description": "Close button configuration"
        },
        "progressTrigger": {
          "$ref": "#/definitions/StepProgressTrigger",
          "description": "Automatic progression configuration"
        }
      },
      "additionalProperties": false
    },
    "StepOptionsButton": {
      "type": "object",
      "properties": {
        "tourActions": {
          "type": "array",
          "items": {
            "oneOf": [
              { "$ref": "#/definitions/TourAction" },
              { "$ref": "#/definitions/TourActionShow" },
              { "$ref": "#/definitions/TourActionRemoveStep" },
              { "$ref": "#/definitions/TourActionAddStep" },
              { "$ref": "#/definitions/TourActionAddSteps" },
              { "$ref": "#/definitions/TourActionDomEvent" }
            ]
          }
        },
        "text": {
          "type": "string",
          "description": "Button text content"
        },
        "ariaLabel": {
          "type": "string",
          "description": "Accessibility label"
        },
        "disabled": {
          "type": "boolean",
          "description": "Disabled state"
        },
        "secondary": {
          "type": "boolean",
          "description": "Secondary styling"
        }
      },
      "additionalProperties": false
    },
    "TourAction": {
      "type": "object",
      "required": ["type"],
      "properties": {
        "type": {
          "type": "string",
          "enum": ["next", "back", "cancel", "complete", "hide"],
          "description": "Type of action to execute"
        }
      },
      "additionalProperties": false
    },
    "TourActionShow": {
      "type": "object",
      "required": ["type", "stepId"],
      "properties": {
        "type": {
          "const": "show"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step to show"
        }
      },
      "additionalProperties": false
    },
    "TourActionRemoveStep": {
      "type": "object",
      "required": ["type", "stepId"],
      "properties": {
        "type": {
          "const": "removeStep"
        },
        "stepId": {
          "type": "string",
          "description": "ID of the step to remove"
        }
      },
      "additionalProperties": false
    },
    "TourActionAddStep": {
      "type": "object",
      "required": ["type", "stepConfig"],
      "properties": {
        "type": {
          "const": "addStep"
        },
        "stepConfig": {
          "$ref": "#/definitions/TourStepConfiguration"
        }
      },
      "additionalProperties": false
    },
    "TourActionAddSteps": {
      "type": "object",
      "required": ["type", "stepConfigs"],
      "properties": {
        "type": {
          "const": "addSteps"
        },
        "stepConfigs": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/TourStepConfiguration"
          }
        }
      },
      "additionalProperties": false
    },
    "TourActionDomEvent": {
      "type": "object",
      "required": ["type", "selector", "eventName"],
      "properties": {
        "type": {
          "const": "domEvent"
        },
        "selector": {
          "type": "string",
          "description": "Selector of the element to perform action"
        },
        "eventName": {
          "type": "string",
          "description": "DOM event to be dispatched on the selected element",
          "enum": [
            "click", "dblclick", "mousedown", "mouseup", "mouseover", "mouseout",
            "mousemove", "mouseenter", "mouseleave", "keydown", "keyup", "keypress",
            "focus", "blur", "input", "change", "submit", "reset", "select",
            "cut", "copy", "paste", "drag", "dragstart", "dragend", "dragenter",
            "dragleave", "dragover", "drop", "scroll", "wheel", "contextmenu",
            "touchstart", "touchmove", "touchend", "touchcancel", "cancelGuidedTour",
            "completeGuidedTour", "getGuidedTour", "getGuidedTours", "startGuidedTour"
          ]
        }
      },
      "args": {
        "type": "array",
        "description": "Arguments to be passed to the DOM event or XGuidedTours method to be dispatched",
        "items": {
            "type": ["string", "number", "boolean", "object", "array", "null"]
        }
      },
      "additionalProperties": false
    },
    "CancelIcon": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Show close button icon"
        },
        "ariaLabel": {
          "type": "string",
          "description": "Accessibility label"
        }
      },
      "additionalProperties": false
    },
    "StepProgressTrigger": {
      "type": "object",
      "required": ["event", "selector"],
      "properties": {
        "event": {
          "type": "string",
          "description": "DOM event that triggers progression"
        },
        "selector": {
          "type": "string",
          "description": "Element selector for event listener"
        }
      },
      "additionalProperties": false
    },
    "TourStepBehavior": {
      "type": "object",
      "properties": {
        "waitForElementConditions": {
          "$ref": "#/definitions/WaitForElementConditions",
          "description": "Target element wait configuration"
        },
        "scrollToTarget": {
          "oneOf": [
            {
              "type": "boolean"
            },
            {
              "$ref": "#/definitions/ScrollIntoViewOptions"
            }
          ],
          "description": "Scroll behavior",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "WaitForElementConditions": {
      "type": "object",
      "properties": {
        "waitTimeout": {
          "type": "number",
          "description": "Maximum wait time in milliseconds for element to exist",
          "default": 0
        },
        "skipStepIfTargetMissing": {
          "type": "boolean",
          "description": "Skip if element doesn't exist",
          "default": false
        }
      },
      "additionalProperties": false
    },
    "ScrollIntoViewOptions": {
      "type": "object",
      "properties": {
        "behavior": {
          "type": "string",
          "enum": ["auto", "smooth"],
          "description": "Scroll behavior"
        },
        "block": {
          "type": "string",
          "enum": ["start", "center", "end", "nearest"],
          "description": "Vertical alignment"
        },
        "inline": {
          "type": "string",
          "enum": ["start", "center", "end", "nearest"],
          "description": "Horizontal alignment"
        }
      },
      "additionalProperties": false
    },
    "KeyboardSettings": {
      "type": "object",
      "description": "Keyboard interaction settings",
      "properties": {
        "allowArrowKeys": {
          "type": "boolean",
          "description": "Enable left/right arrow keys for step navigation",
          "default": true
        },
        "allowEscapeKey": {
          "type": "boolean",
          "description": "Enable escape key for tour exit",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "ExitSettings": {
      "type": "object",
      "description": "Exit behavior settings",
      "properties": {
        "requireConfirmation": {
          "type": "boolean",
          "description": "Whether to show confirmation dialog before exit",
          "default": false
        },
        "confirmationMessage": {
          "type": "string",
          "description": "Custom message for exit confirmation dialog",
          "default": "Are you sure you want to exit the tour?"
        }
      },
      "if": {
        "properties": {
          "requireConfirmation": { "const": true }
        }
      },
      "then": {
        "required": ["confirmationMessage"]
      },
      "additionalProperties": false
    },
    "VisualSettings": {
      "type": "object",
      "description": "Visual appearance settings",
      "properties": {
        "enableHighlightOverlay": {
          "type": "boolean",
          "description": "Controls whether to dim the background and highlight the target element",
          "default": false
        }
      },
      "additionalProperties": false
    },
    "CustomArrowImageOptions": {
      "type": "object",
      "required": ["src"],
      "properties": {
        "src": {
          "type": "string",
          "description": "Source URL for the arrow image"
        },
        "alt": {
          "type": "string",
          "description": "Alternative text for accessibility"
        },
        "width": {
          "type": "number",
          "description": "Width of the arrow element in pixels"
        },
        "height": {
          "type": "number",
          "description": "Height of the arrow element in pixels"
        },
        "offset": {
          "$ref": "#/definitions/OffsetValue",
          "description": "Offset configuration for the arrow position"
        },
        "placementToTarget": {
          "type": "string",
          "enum": ["top", "right", "bottom", "left", "top-start", "top-end", "bottom-start", "bottom-end", "left-start", "left-end", "right-start", "right-end"],
          "description": "Placement of the arrow relative to the target element"
        }
      },
      "additionalProperties": false
    },
    "OffsetValue": {
      "oneOf": [
        {
          "type": "number",
          "description": "Simple numeric offset value"
        },
        {
          "type": "object",
          "properties": {
            "mainAxis": {
              "type": "number",
              "description": "The axis that runs along the side of the floating element. Represents the distance (gutter or margin) between the reference and floating element.",
              "default": 0
            },
            "crossAxis": {
              "type": "number",
              "description": "The axis that runs along the alignment of the floating element. Represents the skidding between the reference and floating element.",
              "default": 0
            },
            "alignmentAxis": {
              "oneOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The same axis as 'crossAxis' but applies only to aligned placements and inverts the 'end' alignment. When set to a number, it overrides the crossAxis value. A positive number will move the floating element in the direction of the opposite edge to the one that is aligned, while a negative number the reverse.",
              "default": null
            }
          },
          "additionalProperties": false
        }
      ],
      "description": "Configures positioning offset as either a number or detailed axis-based configuration"
    }
  },
  "additionalProperties": false
}