{
  "scriptappy": "1.1.0",
  "info": {
    "name": "@nebula.js/sn-boxplot:properties",
    "description": "Boxplot generic object definition",
    "version": "1.0.6",
    "license": "MIT",
    "stability": "experimental",
    "x-qlik-visibility": "private"
  },
  "entries": {
    "properties": {
      "kind": "namespace",
      "entries": {
        "boxplotDef": {
          "description": "Settings specific to the boxplot",
          "entries": {
            "calculations": {
              "description": "Box plot calculation settings.",
              "entries": {
                "auto": {
                  "description": "Use automatic calculations",
                  "defaultValue": true,
                  "type": "boolean"
                },
                "mode": {
                  "description": "Auto calculation modes",
                  "defaultValue": "tukey",
                  "kind": "union",
                  "items": [
                    {
                      "kind": "literal",
                      "value": "'tukey'"
                    },
                    {
                      "kind": "literal",
                      "value": "'fractiles'"
                    },
                    {
                      "kind": "literal",
                      "value": "'stdDev'"
                    }
                  ]
                },
                "parameters": {
                  "description": "Box plot calculation settings",
                  "entries": {
                    "fractiles": {
                      "description": "A number representing the two whisker fractiles as N and 1-N",
                      "defaultValue": 0.01,
                      "type": "number"
                    },
                    "stdDev": {
                      "description": "Standard deviation spread for whiskers",
                      "defaultValue": 3,
                      "type": "number"
                    },
                    "tukey": {
                      "description": "Number of interquartile ranges for whiskers.",
                      "defaultValue": 1.5,
                      "type": "number"
                    }
                  },
                  "kind": "object"
                }
              },
              "kind": "object"
            },
            "color": {
              "description": "Color settings.\nMost color options for visualizations are set in the color object in the options. You activate custom coloring by setting `\"auto\": false` which turns off auto-coloring.\nIf `\"auto\": true`, no other properties need to be defined in the color object.\nNote: Some of the color properties are depending on which theme is currently being used.",
              "entries": {
                "auto": {
                  "description": "Set to use automatic coloring.\nWhen `\"auto\": true`, color settings are based on the visualization used and the number of dimensions\nand measures, that is, the settings are not fixed, but are dependent on the data input.",
                  "defaultValue": true,
                  "type": "boolean"
                },
                "box": {
                  "entries": {
                    "paletteColor": {
                      "description": "The paletteColor object is used to define the box color when you color by single color `(\"mode\": \"primary\")`.",
                      "defaultValue": "{ index: -1, color: '#e6e6e6' }",
                      "type": "#/definitions/paletteColor"
                    }
                  },
                  "kind": "object"
                },
                "expressionIsColor": {
                  "description": "Should be true",
                  "value": "true",
                  "kind": "literal"
                },
                "expressionLabel": {
                  "description": "Label to be defined on tool tips when using a coloring expression.\nOnly used if `'expressionIsColor': false`.",
                  "defaultValue": "",
                  "type": "string"
                },
                "mode": {
                  "description": "Sets the coloring mode for the visualization when auto-coloring has been switched off (`\"auto\": false`). Can be one of:\n* `primary`: a single color (by default blue) is used for all items in the chart. In visualizations that do not benefit from multiple colors (bar charts with one dimension and scatter plots), single color is the default setting.\n* `byExpression`: coloring is based on an expression, which in most cases is a color code. Details are set in the `\"expressionIsColor\"`, `\"expressionLabel`\" and `\"colorExpression\"` properties.\n* `byMultiple`: can be used when more than one measure is used. By default, 12 colors are used for the dimensions. The colors are reused when there are more than 12 dimension values.",
                  "defaultValue": "primary",
                  "kind": "union",
                  "items": [
                    {
                      "kind": "literal",
                      "value": "'primary'"
                    },
                    {
                      "kind": "literal",
                      "value": "'byExpression'"
                    },
                    {
                      "kind": "literal",
                      "value": "'byMultiple'"
                    }
                  ]
                },
                "point": {
                  "entries": {
                    "paletteColor": {
                      "description": "The paletteColor object is used to define the point color when you color by single color `(\"mode\": \"primary\")`.",
                      "defaultValue": "{ index: 6 }",
                      "type": "#/definitions/paletteColor"
                    }
                  },
                  "kind": "object"
                },
                "useBaseColors": {
                  "description": "Use colors encoded in master items.\nOnly applicable when `\"mode\": \"primary\"` has been defined.",
                  "defaultValue": "off",
                  "kind": "union",
                  "items": [
                    {
                      "kind": "literal",
                      "value": "'off'"
                    },
                    {
                      "kind": "literal",
                      "value": "'dimension'"
                    },
                    {
                      "kind": "literal",
                      "value": "'measure'"
                    }
                  ]
                }
              },
              "kind": "object"
            },
            "elements": {
              "description": "Box plot elements settings.",
              "entries": {
                "firstWhisker": {
                  "description": "Box plot element settings",
                  "entries": {
                    "name": {
                      "description": "Label for the boxplot element",
                      "optional": true,
                      "defaultValue": "",
                      "kind": "union",
                      "items": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "StringExpression"
                        }
                      ]
                    }
                  },
                  "kind": "object"
                },
                "outliers": {
                  "description": "Box plot outliers element",
                  "entries": {
                    "include": {
                      "description": "Show the outliers.",
                      "defaultValue": true,
                      "type": "boolean"
                    },
                    "sortOutliers": {
                      "defaultValue": true,
                      "type": "boolean"
                    }
                  },
                  "kind": "object"
                }
              },
              "kind": "object"
            },
            "presentation": {
              "description": "Presentation settings for the boxplots",
              "entries": {
                "whiskers": {
                  "description": "Settings for the boxplot whiskers",
                  "entries": {
                    "show": {
                      "description": "Show whiskers.",
                      "defaultValue": true,
                      "type": "boolean"
                    }
                  },
                  "kind": "object"
                }
              },
              "kind": "object"
            },
            "qHyperCubeDef": {
              "description": "Extends `HyperCubeDef`, see Engine API: `HyperCubeDef`.",
              "extends": [
                {
                  "type": "HyperCubeDef"
                }
              ],
              "kind": "object"
            },
            "sorting": {
              "description": "Wrapper for sorting properties which will be set on the outer dimension.",
              "entries": {
                "autoSort": {
                  "description": "Sort automatically",
                  "defaultValue": true,
                  "type": "boolean"
                }
              },
              "kind": "object"
            }
          },
          "kind": "object"
        },
        "dimensionAxis": {
          "description": "Dimension axis settings.",
          "entries": {
            "dock": {
              "description": "Axis docking position",
              "defaultValue": "near",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'near'"
                },
                {
                  "kind": "literal",
                  "value": "'far'"
                }
              ]
            },
            "label": {
              "description": "Label orientation",
              "defaultValue": "auto",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'auto'"
                },
                {
                  "kind": "literal",
                  "value": "'horizontal'"
                },
                {
                  "kind": "literal",
                  "value": "'tilted'"
                }
              ]
            },
            "show": {
              "description": "Labels and title",
              "defaultValue": "all",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'all'"
                },
                {
                  "kind": "literal",
                  "value": "'labels'"
                },
                {
                  "kind": "literal",
                  "value": "'title'"
                },
                {
                  "kind": "literal",
                  "value": "'none'"
                }
              ]
            }
          },
          "kind": "object"
        },
        "footnote": {
          "description": "Visualization footnote.",
          "optional": true,
          "defaultValue": "",
          "kind": "union",
          "items": [
            {
              "type": "string"
            },
            {
              "type": "StringExpression"
            }
          ]
        },
        "gridlines": {
          "description": "Grid lines settings.",
          "entries": {
            "auto": {
              "description": "Automatic grid line spacing.",
              "defaultValue": true,
              "type": "boolean"
            },
            "spacing": {
              "description": "Grid line spacing. Used only when auto is set to false.",
              "defaultValue": 2,
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": 0
                },
                {
                  "kind": "literal",
                  "value": 2
                },
                {
                  "kind": "literal",
                  "value": 3
                }
              ]
            }
          },
          "kind": "object"
        },
        "measureAxis": {
          "description": "Measure axis settings.",
          "entries": {
            "autoMinMax": {
              "description": "Automatic max/min",
              "defaultValue": true,
              "type": "boolean"
            },
            "dock": {
              "description": "Axis docking position",
              "defaultValue": "near",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'near'"
                },
                {
                  "kind": "literal",
                  "value": "'far'"
                }
              ]
            },
            "max": {
              "description": "Axis max value. `\"autoMinMax\"` must be set to false and `\"minMax\"`\nmust be set to `\"max\"` or `\"minMax\"` to use this property",
              "defaultValue": 10,
              "kind": "union",
              "items": [
                {
                  "type": "number"
                },
                {
                  "type": "ValueExpression"
                }
              ]
            },
            "min": {
              "description": "Axis min value. `\"autoMinMax\"` must be set to false and `\"minMax\"`\nmust be set to `\"min\"` or `\"minMax\"` to use this property",
              "defaultValue": 0,
              "kind": "union",
              "items": [
                {
                  "type": "number"
                },
                {
                  "type": "ValueExpression"
                }
              ]
            },
            "minMax": {
              "description": "Set custom max/min",
              "defaultValue": "min",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'min'"
                },
                {
                  "kind": "literal",
                  "value": "'max'"
                },
                {
                  "kind": "literal",
                  "value": "'minMax'"
                }
              ]
            },
            "show": {
              "description": "Labels and title",
              "defaultValue": "all",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'all'"
                },
                {
                  "kind": "literal",
                  "value": "'labels'"
                },
                {
                  "kind": "literal",
                  "value": "'title'"
                },
                {
                  "kind": "literal",
                  "value": "'none'"
                }
              ]
            },
            "spacing": {
              "description": "Axis scale",
              "defaultValue": 1,
              "type": "number"
            }
          },
          "kind": "object"
        },
        "orientation": {
          "description": "Orientation setting.\nIf vertical, the dimension axis can only be docked on bottom or top and measure axis on left or right.",
          "defaultValue": "vertical",
          "kind": "union",
          "items": [
            {
              "kind": "literal",
              "value": "'vertical'"
            },
            {
              "kind": "literal",
              "value": "'horizontal'"
            }
          ]
        },
        "refLine": {
          "description": "Reference lines settings",
          "entries": {
            "refLines": {
              "description": "Array of measure based reference line definitions",
              "kind": "array",
              "items": {
                "type": "#/definitions/refLine"
              }
            }
          },
          "kind": "object"
        },
        "showTitles": {
          "description": "Show title for the visualization.",
          "optional": true,
          "defaultValue": true,
          "type": "boolean"
        },
        "sorting": {
          "description": "Wrapper for sorting properties which will be set on the outer dimension.",
          "entries": {
            "autoSort": {
              "description": "Sort automatically",
              "defaultValue": true,
              "type": "boolean"
            },
            "elementId": {
              "description": "Sorting preset",
              "defaultValue": "firstWhisker",
              "kind": "union",
              "items": [
                {
                  "kind": "literal",
                  "value": "'firstWhisker'"
                },
                {
                  "kind": "literal",
                  "value": "'boxStart'"
                },
                {
                  "kind": "literal",
                  "value": "'boxMiddle'"
                },
                {
                  "kind": "literal",
                  "value": "'boxEnd'"
                },
                {
                  "kind": "literal",
                  "value": "'lastWhisker'"
                }
              ]
            },
            "expression": {
              "description": "Expression for the sorting. Requires sortByExpression to be -1 or 1.",
              "type": "ValueExpression"
            },
            "sortCriteria": {
              "entries": {
                "sortByAscii": {
                  "description": "Sort by alphabetic",
                  "defaultValue": 0,
                  "type": "number"
                },
                "sortByExpression": {
                  "description": "Sort by expression",
                  "defaultValue": 0,
                  "type": "number"
                },
                "sortByNumeric": {
                  "description": "Sort by numeric",
                  "defaultValue": 0,
                  "type": "number"
                }
              },
              "kind": "object"
            }
          },
          "kind": "object"
        },
        "subtitle": {
          "description": "Visualization subtitle.",
          "optional": true,
          "defaultValue": "",
          "kind": "union",
          "items": [
            {
              "type": "string"
            },
            {
              "type": "StringExpression"
            }
          ]
        },
        "title": {
          "description": "Visualization title.",
          "optional": true,
          "defaultValue": "",
          "kind": "union",
          "items": [
            {
              "type": "string"
            },
            {
              "type": "StringExpression"
            }
          ]
        },
        "version": {
          "description": "Current version of this generic object definition.",
          "type": "string"
        }
      }
    }
  },
  "definitions": {
    "paletteColor": {
      "description": "Color information structure. Holds the actual color and index in palette.",
      "kind": "object",
      "entries": {
        "color": {
          "description": "Color as hex string (mandatory if index: -1)",
          "type": "string"
        },
        "index": {
          "description": "Index in palette",
          "type": "number"
        }
      }
    },
    "refLine": {
      "kind": "object",
      "entries": {
        "label": {
          "description": "Reference line label.",
          "type": "string"
        },
        "paletteColor": {
          "type": "#/definitions/paletteColor"
        },
        "show": {
          "description": "Set to true to display this reference line.",
          "defaultValue": true,
          "kind": "union",
          "items": [
            {
              "type": "boolean"
            },
            {
              "type": "ValueExpression"
            }
          ]
        },
        "coloredBackground": {
          "description": "Set to true to fill the label and/or value of this reference line with this color",
          "optional": true,
          "defaultValue": false,
          "type": "boolean"
        },
        "showLabel": {
          "description": "Set to true to show the label of this reference line.",
          "optional": true,
          "defaultValue": true,
          "type": "boolean"
        },
        "showValue": {
          "description": "Set to true to show the value of this reference line.",
          "optional": true,
          "defaultValue": true,
          "type": "boolean"
        },
        "style": {
          "description": "Styling settings for reference line",
          "optional": true,
          "type": "#/definitions/refLineStyle"
        }
      }
    },
    "refLineStyle": {
      "description": "Styling settings for reference line",
      "kind": "object",
      "entries": {
        "lineThickness": {
          "description": "Set the thickness for this reference line.",
          "optional": true,
          "defaultValue": 2,
          "type": "number"
        },
        "lineType": {
          "description": "Set the dash type for this reference line.",
          "optional": true,
          "defaultValue": "''",
          "type": "string"
        }
      }
    }
  }
}