@luzmo/dashboard-contents-types 1.0.5 → 1.0.6

package/assets/json-schemas/sunburst-chart-slots.schema.json.d.ts

@@ -0,0 +1,481 @@
+declare const _default: {
+    "$id": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json",
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "definitions": {
+        "ColumnSubtype": {
+            "enum": [
+                "coordinates",
+                "currency",
+                "duration",
+                "hierarchy_element_expression",
+                "topography"
+            ],
+            "type": "string"
+        },
+        "DateTimeSlotContent": {
+            "properties": {
+                "aggregationFunc": {
+                    "description": "Basic aggregation function. It can be used when a \"datetime\" column is used in a measure slot.",
+                    "enum": [
+                        "count",
+                        "distinctcount"
+                    ],
+                    "type": "string"
+                },
+                "color": {
+                    "description": "Color of the column. Any column type can have it, but it's applied when a column is set as a measure and when multiple measures are defined.",
+                    "type": [
+                        "null",
+                        "string"
+                    ]
+                },
+                "columnId": {
+                    "description": "Column id",
+                    "format": "uuid",
+                    "type": "string"
+                },
+                "datasetId": {
+                    "description": "Dataset id",
+                    "format": "uuid",
+                    "type": "string"
+                },
+                "datetimeDisplayMode": {
+                    "description": "If it's set it will be used for datetime formatting together with weekStart, weekDayNameFormat, monthNameFormat",
+                    "enum": [
+                        "day_in_month",
+                        "day_in_year",
+                        "default",
+                        "hour_in_day",
+                        "minute_in_hour",
+                        "month_name",
+                        "month_number",
+                        "quarter_number",
+                        "second_in_minute",
+                        "week_number",
+                        "weekday_name",
+                        "weekday_number"
+                    ],
+                    "type": "string"
+                },
+                "format": {
+                    "description": "D3 format, it is used for \"numeric\" formatting (https://observablehq.com/@d3/d3-format), for \"datetime\" formatting (https://d3js.org/d3-time-format).\nIt can also be used for \"hierarchy\" formatting but when it's used in the measure slot.",
+                    "type": "string"
+                },
+                "grandTotals": {
+                    "description": "Enable or disable grand totals, they're only used in Pivot table",
+                    "properties": {
+                        "enabled": {
+                            "type": "boolean"
+                        }
+                    },
+                    "type": "object"
+                },
+                "label": {
+                    "description": "Label in format {locale: \"label\"}, for example, {en: \"Total Revenue\"}",
+                    "type": "object"
+                },
+                "level": {
+                    "description": "\"hierarchy\" or \"datetime\" level",
+                    "type": [
+                        "number",
+                        "null"
+                    ]
+                },
+                "lowestLevel": {
+                    "description": "Lowest \"hierarchy\" or \"datetime\" level",
+                    "type": [
+                        "null",
+                        "number"
+                    ]
+                },
+                "monthNameFormat": {
+                    "description": "Month name format for datetime column formatting",
+                    "enum": [
+                        "letter",
+                        "long",
+                        "short"
+                    ],
+                    "type": "string"
+                },
+                "periodOverPeriod": {
+                    "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/PeriodOverPeriod",
+                    "description": "Settings to configure period over period comparison. It can be used only in a measure slot."
+                },
+                "subtype": {
+                    "description": "There's no subtype for \"datetime\", it can be null or omitted",
+                    "type": "null"
+                },
+                "type": {
+                    "const": "datetime",
+                    "description": "\"datetime\" column type",
+                    "type": "string"
+                },
+                "weekDayNameFormat": {
+                    "description": "Week day name format for datetime column formatting",
+                    "enum": [
+                        "letter",
+                        "long",
+                        "short"
+                    ],
+                    "type": "string"
+                },
+                "weekStart": {
+                    "description": "Week start day, 'sunday' or 'monday'. For datetime column formatting.",
+                    "enum": [
+                        "monday",
+                        "sunday"
+                    ],
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "HierarchySlotContent": {
+            "properties": {
+                "aggregationFunc": {
+                    "description": "Basic aggregation function. It can be used when a \"hierarchy\" column is used in a measure slot.",
+                    "enum": [
+                        "count",
+                        "distinctcount"
+                    ],
+                    "type": "string"
+                },
+                "color": {
+                    "description": "Color of the column. Any column type can have it, but it's applied when a column is set as a measure and when multiple measures are defined.",
+                    "type": [
+                        "null",
+                        "string"
+                    ]
+                },
+                "columnId": {
+                    "description": "Column id",
+                    "format": "uuid",
+                    "type": "string"
+                },
+                "datasetId": {
+                    "description": "Dataset id",
+                    "format": "uuid",
+                    "type": "string"
+                },
+                "format": {
+                    "description": "D3 format, it is used for \"numeric\" formatting (https://observablehq.com/@d3/d3-format), for \"datetime\" formatting (https://d3js.org/d3-time-format).\nIt can also be used for \"hierarchy\" formatting but when it's used in the measure slot.",
+                    "type": "string"
+                },
+                "grandTotals": {
+                    "description": "Enable or disable grand totals, they're only used in Pivot table",
+                    "properties": {
+                        "enabled": {
+                            "type": "boolean"
+                        }
+                    },
+                    "type": "object"
+                },
+                "label": {
+                    "description": "Label in format {locale: \"label\"}, for example, {en: \"Total Revenue\"}",
+                    "type": "object"
+                },
+                "level": {
+                    "description": "\"hierarchy\" or \"datetime\" level",
+                    "type": [
+                        "number",
+                        "null"
+                    ]
+                },
+                "lowestLevel": {
+                    "description": "Lowest \"hierarchy\" or \"datetime\" level",
+                    "type": [
+                        "null",
+                        "number"
+                    ]
+                },
+                "periodOverPeriod": {
+                    "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/PeriodOverPeriod",
+                    "description": "Settings to configure period over period comparison. It can be used only in a measure slot."
+                },
+                "subtype": {
+                    "anyOf": [
+                        {
+                            "enum": [
+                                "coordinates",
+                                "currency",
+                                "date",
+                                "datetime",
+                                "duration",
+                                "hierarchy_element_expression",
+                                "topography"
+                            ],
+                            "type": "string"
+                        },
+                        {
+                            "type": "null"
+                        }
+                    ],
+                    "description": "Column subtype"
+                },
+                "type": {
+                    "const": "hierarchy",
+                    "description": "\"hierarchy\" column type",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "LevelsSlot": {
+            "description": "Category slot definition of the Line chart",
+            "properties": {
+                "content": {
+                    "description": "levels slot definition, it can contain mixed data (numeric, categorical)",
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/NumericSlotContent"
+                            },
+                            {
+                                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/HierarchySlotContent"
+                            },
+                            {
+                                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/DateTimeSlotContent"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                "name": {
+                    "const": "levels",
+                    "description": "Name of the slot",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "MeasureSlot": {
+            "description": "Measure slot definition of the Line chart",
+            "properties": {
+                "content": {
+                    "description": "Measure slot definition, it can contain numeric data",
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/NumericSlotContent"
+                            },
+                            {
+                                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/HierarchySlotContent"
+                            },
+                            {
+                                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/DateTimeSlotContent"
+                            }
+                        ]
+                    },
+                    "maxItems": 1,
+                    "type": "array"
+                },
+                "name": {
+                    "const": "measure",
+                    "description": "Name of the slot",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "NumericSlotContent": {
+            "properties": {
+                "aggregationFunc": {
+                    "description": "Aggregation function. It can be used with a \"numeric\" column type, and with some limitations with \"hierarchy\" and \"datetime\" column types.",
+                    "enum": [
+                        "average",
+                        "count",
+                        "cumulativesum",
+                        "distinctcount",
+                        "histogram",
+                        "max",
+                        "median",
+                        "min",
+                        "rate",
+                        "stddev",
+                        "sum",
+                        "weightedaverage"
+                    ],
+                    "type": "string"
+                },
+                "aggregationWeight": {
+                    "description": "Aggregation weight. It can be used with a \"numeric\" column type.",
+                    "properties": {
+                        "columnId": {
+                            "description": "Column id",
+                            "format": "uuid",
+                            "type": "string"
+                        },
+                        "columnSubType": {
+                            "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/ColumnSubtype",
+                            "description": "Column subtype"
+                        },
+                        "datasetId": {
+                            "description": "Dataset id",
+                            "format": "uuid",
+                            "type": "string"
+                        }
+                    },
+                    "type": "object"
+                },
+                "bins": {
+                    "description": "Bin definition. It can be used when a \"numeric\" column is used as a category.",
+                    "properties": {
+                        "enabled": {
+                            "description": "Enable or disable binning",
+                            "type": "boolean"
+                        },
+                        "number": {
+                            "description": "Defines the range of the bins",
+                            "type": "number"
+                        }
+                    },
+                    "type": "object"
+                },
+                "color": {
+                    "description": "Color of the column. Any column type can have it, but it's applied when a column is set as a measure and when multiple measures are defined.",
+                    "type": [
+                        "null",
+                        "string"
+                    ]
+                },
+                "columnId": {
+                    "description": "Column id",
+                    "format": "uuid",
+                    "type": "string"
+                },
+                "currency": {
+                    "description": "Currency code, for example \"€\" or \"$\". It is only used when the column type is \"numeric\" and subtype is \"currency\".",
+                    "type": [
+                        "null",
+                        "string"
+                    ]
+                },
+                "datasetId": {
+                    "description": "Dataset id",
+                    "format": "uuid",
+                    "type": "string"
+                },
+                "duration": {
+                    "description": "Duration definition. It's only used when the column type is \"numeric\" and subtype is \"duration\".",
+                    "properties": {
+                        "format": {
+                            "description": "Duration format",
+                            "enum": [
+                                "long",
+                                "short",
+                                "time"
+                            ],
+                            "type": "string"
+                        },
+                        "levels": {
+                            "description": "Duration levels used",
+                            "items": {
+                                "type": "number"
+                            },
+                            "type": "array"
+                        }
+                    },
+                    "type": "object"
+                },
+                "format": {
+                    "description": "D3 format, it is used for \"numeric\" formatting (https://observablehq.com/@d3/d3-format), for \"datetime\" formatting (https://d3js.org/d3-time-format).\nIt can also be used for \"hierarchy\" formatting but when it's used in the measure slot.",
+                    "type": "string"
+                },
+                "formula": {
+                    "description": "A dataset formula id or an ad-hoc formula. A formula is an entity similar to a column. You can add formulas on the dataset details page or use ad-hoc formulas. You can find more information about formulas in the article https://academy.luzmo.com/article/52tm82oo",
+                    "type": "string"
+                },
+                "grandTotals": {
+                    "description": "Enable or disable grand totals, they're only used in Pivot table",
+                    "properties": {
+                        "enabled": {
+                            "type": "boolean"
+                        }
+                    },
+                    "type": "object"
+                },
+                "label": {
+                    "description": "Label in format {locale: \"label\"}, for example, {en: \"Total Revenue\"}",
+                    "type": "object"
+                },
+                "periodOverPeriod": {
+                    "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/PeriodOverPeriod",
+                    "description": "Settings to configure period over period comparison. It can be used only in a measure slot."
+                },
+                "subtype": {
+                    "anyOf": [
+                        {
+                            "enum": [
+                                "coordinates",
+                                "currency",
+                                "date",
+                                "datetime",
+                                "duration",
+                                "hierarchy_element_expression",
+                                "topography"
+                            ],
+                            "type": "string"
+                        },
+                        {
+                            "type": "null"
+                        }
+                    ],
+                    "description": "Column subtype"
+                },
+                "type": {
+                    "const": "numeric",
+                    "description": "\"numeric\" column / formula type",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "PeriodOverPeriod": {
+            "properties": {
+                "level": {
+                    "description": "Period of time level\n0 - period, 1 - year, 2 - quarter, 3 - month, 4 - week, 5 - day... 9 - millisecond",
+                    "type": "number"
+                },
+                "periodToDate": {
+                    "description": "Turn ON/OFF period to date comparison",
+                    "type": "boolean"
+                },
+                "quantity": {
+                    "description": "Number of periods",
+                    "type": "number"
+                },
+                "type": {
+                    "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/PeriodOverPeriodType",
+                    "description": "Period over period comparison type"
+                }
+            },
+            "type": "object"
+        },
+        "PeriodOverPeriodType": {
+            "description": "Period over period comparison type:\n'none' - turned off,\n'past' - absolute value comparison to the past,\n'percentageChange' - percentage change comparison to the past",
+            "enum": [
+                "none",
+                "past",
+                "percentageChange"
+            ],
+            "type": "string"
+        }
+    },
+    "description": "Data definition of the Sunburst chart",
+    "items": {
+        "anyOf": [
+            {
+                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/MeasureSlot"
+            },
+            {
+                "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json#/definitions/LevelsSlot"
+            }
+        ]
+    },
+    "maxItems": 2,
+    "type": "array"
+}
+
+;
+
+export default _default;

package/assets/json-schemas/sunburst-chart.schema.json.d.ts

@@ -0,0 +1,23 @@
+declare const _default: {
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart.schema.json",
+    "type": "object",
+    "description": "Sunburst Chart item",
+    "properties": {
+        "type": {
+            "description": "Type of the item",
+            "type": "string",
+            "const": "sunburst-chart"
+        },
+        "options": {
+            "description": "Options of the Sunburst Chart item",
+            "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-options.schema.json"
+        },
+        "slots": {
+            "description": "Data definition of the Sunburst Chart item",
+            "$ref": "https://developer.luzmo.com/assets/json-schemas/0.1.90/sunburst-chart-slots.schema.json"
+        }
+    }
+};
+
+export default _default;

package/assets/json-schemas/symbol-map-options.schema.json.d.ts

@@ -1068,7 +1068,7 @@ declare const _default: {
                     "description": "Custom border styling",
                     "properties": {
                         "border-bottom-width": {
-                            "description": "Border bottom width",
+                            "description": "Border bottom width, it is visible when a border style and color are set",
                             "examples": [
                                 "0px",
                                 "1px",
@@ -1077,7 +1077,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "border-color": {
-                            "description": "Border color",
+                            "description": "Border color, it is visible when a border style and width are set",
                             "examples": [
                                 "rgba(216, 216, 216, 1)",
                                 "rgb(147, 146, 148)"
@@ -1085,7 +1085,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "border-left-width": {
-                            "description": "Border left width",
+                            "description": "Border left width, it is visible when a border style and color are set",
                             "examples": [
                                 "0px",
                                 "1px",
@@ -1103,7 +1103,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "border-right-width": {
-                            "description": "Border right width",
+                            "description": "Border right width, it is visible when a border style and color are set",
                             "examples": [
                                 "0px",
                                 "1px",
@@ -1112,7 +1112,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "border-style": {
-                            "description": "Border style",
+                            "description": "Border style, it is visible when a border color and width are set",
                             "examples": [
                                 "none",
                                 "solid",
@@ -1122,7 +1122,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "border-top-width": {
-                            "description": "Border top width",
+                            "description": "Border top width, it is visible when a border style and color are set",
                             "examples": [
                                 "0px",
                                 "1px",
@@ -1164,12 +1164,15 @@ declare const _default: {
                     "type": "object"
                 },
                 "colors": {
-                    "description": "Custom color palette",
+                    "description": "Custom color palette, an array of colors which may affect different areas of a chart, for example, lines, bars, etc.",
                     "examples": [
                         [
-                            "rgb(68, 52, 255)",
-                            "rgb(68, 52, 255)",
-                            "rgb(218, 214, 255)"
+                            "red",
+                            "green",
+                            "blue",
+                            "yellow",
+                            "orange",
+                            "purple"
                         ]
                     ],
                     "items": {
@@ -1180,19 +1183,6 @@ declare const _default: {
                 "font": {
                     "description": "Custom font styling",
                     "properties": {
-                        "font-style": {
-                            "const": "normal",
-                            "description": "Use it to reset the font style to \"normal\"",
-                            "type": "string"
-                        },
-                        "font-weight": {
-                            "description": "Font weight",
-                            "examples": [
-                                400,
-                                700
-                            ],
-                            "type": "number"
-                        },
                         "fontFamily": {
                             "description": "Font family",
                             "examples": [
@@ -1205,7 +1195,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "fontSize": {
-                            "description": "Font size in px",
+                            "description": "Font size in px, if not set, it will be inherited from the theme. It can be overridden if more specific \"fontSize\" is set, for example, \"fontSize\" inside options like \"title\", \"axis\", \"legend\", \"tooltip\", etc.",
                             "examples": [
                                 10,
                                 15,
@@ -1234,7 +1224,7 @@ declare const _default: {
                     "type": "string"
                 },
                 "title": {
-                    "description": "Custom title styling",
+                    "description": "Custom title styling, it's applied if the title is displayed",
                     "properties": {
                         "align": {
                             "description": "Title align",
@@ -1267,7 +1257,7 @@ declare const _default: {
                             "type": "boolean"
                         },
                         "fontSize": {
-                            "description": "Title's font size in px",
+                            "description": "Title's font size in px, if not set, it will be inherited from the \"font\"->\"fontSize\" option",
                             "examples": [
                                 16,
                                 20
@@ -1303,7 +1293,7 @@ declare const _default: {
                     "type": "object"
                 },
                 "tooltip": {
-                    "description": "Custom tooltip styling",
+                    "description": "Custom tooltip styling, it's applied if the tooltip is turned on",
                     "properties": {
                         "background": {
                             "description": "Tooltip's background",
@@ -1316,16 +1306,7 @@ declare const _default: {
                             "type": "string"
                         },
                         "fontSize": {
-                            "description": "Tooltip's font size in px",
-                            "examples": [
-                                12,
-                                16,
-                                20
-                            ],
-                            "type": "number"
-                        },
-                        "lineHeight": {
-                            "description": "Tooltip's line height in px",
+                            "description": "Tooltip's font size in px, if not set, it will be inherited from the \"font\"->\"fontSize\" option",
                             "examples": [
                                 12,
                                 16,
@@ -1334,7 +1315,7 @@ declare const _default: {
                             "type": "number"
                         },
                         "opacity": {
-                            "description": "Tooltip's opacity",
+                            "description": "Tooltip's opacity, it should be between 0 and 1, for example, 0.8",
                             "examples": [
                                 0.5,
                                 0.8,
@@ -1464,7 +1445,7 @@ declare const _default: {
             "type": "string"
         },
         "title": {
-            "description": "Title in format { \"locale\": \"title\"}, for example, { \"en\": \"Title\"}",
+            "description": "Title in format { \"locale\": \"title\"}, for example, { \"en\": \"Title\"}. It's applied if the title is displayed.",
             "examples": [
                 {
                     "en": "Title"