@datarailsshared/dr_renderer 1.5.105 → 1.5.114

package/src/types/options/constants.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Default settings for tooltip styling.
+ */
+export type TooltipDefaultSettings = {
+    /**
+     * - Default tooltip font color
+     */
+    FONT_COLOR: string;
+    /**
+     * - Default tooltip font size
+     */
+    FONT_SIZE: string;
+    /**
+     * - Default tooltip font family
+     */
+    FONT_FAMILY: string;
+};
+/**
+ * Default settings for label styling.
+ */
+export type LabelDefaultSettings = {
+    /**
+     * - Default label font color
+     */
+    FONT_COLOR: string;
+    /**
+     * - Default label font size
+     */
+    FONT_SIZE: string;
+    /**
+     * - Default label font family
+     */
+    FONT_FAMILY: string;
+};
+/**
+ * Chart type string literal union.
+ */
+export type ChartTypeValue = "line-chart" | "line-chart-smooth" | "line-chart-forecast" | "column-chart" | "column-chart-stacked" | "column-chart-stacked-percent" | "combo-chart" | "combo-column-chart" | "combo-stacked-chart" | "bar-chart" | "bar-chart-stacked" | "bar-chart-stacked-percent" | "scatter-chart" | "area-chart" | "area-chart-smooth" | "table_only" | "polygon-chart" | "pie-chart" | "pie-chart-drilldown" | "gauge-solid-chart" | "gauge-chart" | "gauge-chart-enhanced" | "gauge-chart-dynamic-goal" | "gauge-chart-categories-summary" | "kpi-widget" | "smart-kpi" | "text-widget" | "waterfall-chart-breakdown" | "waterfall-chart-walkthrough" | "published_item" | "rich_text" | "excel_viewer" | "donut-chart";
+/**
+ * Chart types object type.
+ */
+export type ChartTypesMap = {
+    LINE_CHART: "line-chart";
+    LINE_CHART_SMOOTH: "line-chart-smooth";
+    LINE_CHART_FORECAST: "line-chart-forecast";
+    COLUMN_CHART: "column-chart";
+    COLUMN_CHART_STACKED: "column-chart-stacked";
+    COLUMN_CHART_STACKED_PERCENT: "column-chart-stacked-percent";
+    COMBO_CHART: "combo-chart";
+    COMBO_COLUMN_CHART: "combo-column-chart";
+    COMBO_STACKED_CHART: "combo-stacked-chart";
+    BAR_CHART: "bar-chart";
+    BAR_CHART_STACKED: "bar-chart-stacked";
+    BAR_CHART_STACKED_PERCENT: "bar-chart-stacked-percent";
+    SCATTER_CHART: "scatter-chart";
+    AREA_CHART: "area-chart";
+    AREA_CHART_SMOOTH: "area-chart-smooth";
+    TABLE_ONLY: "table_only";
+    POLYGON_CHART: "polygon-chart";
+    PIE_CHART: "pie-chart";
+    PIE_CHART_DRILLDOWN: "pie-chart-drilldown";
+    GAUGE_SOLID_CHART: "gauge-solid-chart";
+    GAUGE_CHART: "gauge-chart";
+    GAUGE_CHART_ENHANCED: "gauge-chart-enhanced";
+    GAUGE_CHART_DYNAMIC_GOAL: "gauge-chart-dynamic-goal";
+    GAUGE_CHART_CATEGORIES_SUMMARY: "gauge-chart-categories-summary";
+    KPI_WIDGET: "kpi-widget";
+    SMART_KPI: "smart-kpi";
+    TEXT_WIDGET: "text-widget";
+    WATERFALL_BREAKDOWN: "waterfall-chart-breakdown";
+    WATERFALL_WALKTHROUGH: "waterfall-chart-walkthrough";
+    PUBLISHED_ITEM: "published_item";
+    RICH_TEXT: "rich_text";
+    EXCEL_VIEWER: "excel_viewer";
+    DONUT_CHART: "donut-chart";
+};
+/**
+ * Chart color palette for various UI elements.
+ */
+export type CHART_COLORS = string;
+export namespace CHART_COLORS {
+    let BACKGROUND: string;
+    let TEXT: string;
+    let LABEL: string;
+    let LABEL_SECOND: string;
+    let DRILL_UP_FILL: string;
+    let DRILL_BUTTON_COLOR_FILL: string;
+    let DRILL_BUTTON_COLOR: string;
+    let DRILL_BUTTON_COLOR_HOVER: string;
+    let PLOT_BORDER: string;
+    let MINOR_GRID_LINE: string;
+    let TICK_COLOR: string;
+    let LABELS_OLD: string;
+    let DATA_LABELS: string;
+    let CONTRAST_TEXT: string;
+    let LEGEND_BACKGROUND: string;
+    let MASK: string;
+}
+/**
+ * Chart type string literal union.
+ * @typedef {'line-chart'|'line-chart-smooth'|'line-chart-forecast'|'column-chart'|'column-chart-stacked'|'column-chart-stacked-percent'|'combo-chart'|'combo-column-chart'|'combo-stacked-chart'|'bar-chart'|'bar-chart-stacked'|'bar-chart-stacked-percent'|'scatter-chart'|'area-chart'|'area-chart-smooth'|'table_only'|'polygon-chart'|'pie-chart'|'pie-chart-drilldown'|'gauge-solid-chart'|'gauge-chart'|'gauge-chart-enhanced'|'gauge-chart-dynamic-goal'|'gauge-chart-categories-summary'|'kpi-widget'|'smart-kpi'|'text-widget'|'waterfall-chart-breakdown'|'waterfall-chart-walkthrough'|'published_item'|'rich_text'|'excel_viewer'|'donut-chart'} ChartTypeValue
+ */
+/**
+ * Chart types object type.
+ * @typedef {Object} ChartTypesMap
+ * @property {'line-chart'} LINE_CHART
+ * @property {'line-chart-smooth'} LINE_CHART_SMOOTH
+ * @property {'line-chart-forecast'} LINE_CHART_FORECAST
+ * @property {'column-chart'} COLUMN_CHART
+ * @property {'column-chart-stacked'} COLUMN_CHART_STACKED
+ * @property {'column-chart-stacked-percent'} COLUMN_CHART_STACKED_PERCENT
+ * @property {'combo-chart'} COMBO_CHART
+ * @property {'combo-column-chart'} COMBO_COLUMN_CHART
+ * @property {'combo-stacked-chart'} COMBO_STACKED_CHART
+ * @property {'bar-chart'} BAR_CHART
+ * @property {'bar-chart-stacked'} BAR_CHART_STACKED
+ * @property {'bar-chart-stacked-percent'} BAR_CHART_STACKED_PERCENT
+ * @property {'scatter-chart'} SCATTER_CHART
+ * @property {'area-chart'} AREA_CHART
+ * @property {'area-chart-smooth'} AREA_CHART_SMOOTH
+ * @property {'table_only'} TABLE_ONLY
+ * @property {'polygon-chart'} POLYGON_CHART
+ * @property {'pie-chart'} PIE_CHART
+ * @property {'pie-chart-drilldown'} PIE_CHART_DRILLDOWN
+ * @property {'gauge-solid-chart'} GAUGE_SOLID_CHART
+ * @property {'gauge-chart'} GAUGE_CHART
+ * @property {'gauge-chart-enhanced'} GAUGE_CHART_ENHANCED
+ * @property {'gauge-chart-dynamic-goal'} GAUGE_CHART_DYNAMIC_GOAL
+ * @property {'gauge-chart-categories-summary'} GAUGE_CHART_CATEGORIES_SUMMARY
+ * @property {'kpi-widget'} KPI_WIDGET
+ * @property {'smart-kpi'} SMART_KPI
+ * @property {'text-widget'} TEXT_WIDGET
+ * @property {'waterfall-chart-breakdown'} WATERFALL_BREAKDOWN
+ * @property {'waterfall-chart-walkthrough'} WATERFALL_WALKTHROUGH
+ * @property {'published_item'} PUBLISHED_ITEM
+ * @property {'rich_text'} RICH_TEXT
+ * @property {'excel_viewer'} EXCEL_VIEWER
+ * @property {'donut-chart'} DONUT_CHART
+ */
+/**
+ * Chart type identifiers.
+ * @type {ChartTypesMap}
+ */
+export const CHART_TYPES: ChartTypesMap;
+/**
+ * Available font families for chart suboptions.
+ * @type {string[]}
+ */
+export const SUBOPTIONS_FONTS: string[];
+/**
+ * Default font family for Highcharts elements.
+ * @type {string}
+ */
+export const HIGHCHARTS_FONT_FAMILY: string;
+/**
+ * Default font family CSS value with fallback.
+ * @type {string}
+ */
+export const HIGHCHARTS_FONT_FAMILY_CSS: string;
+/**
+ * Default settings for tooltip styling.
+ * @typedef {Object} TooltipDefaultSettings
+ * @property {string} FONT_COLOR - Default tooltip font color
+ * @property {string} FONT_SIZE - Default tooltip font size
+ * @property {string} FONT_FAMILY - Default tooltip font family
+ */
+/**
+ * @type {TooltipDefaultSettings}
+ */
+export const TOOLTIP_DEFAULT_SETTINGS: TooltipDefaultSettings;
+/**
+ * Default tooltip options for Highcharts.
+ * @type {{ borderColor: string, shadow: Object, style: Object, enabled: boolean }}
+ */
+export const TOOLTIP_DEFAULT_OPTIONS: {
+    borderColor: string;
+    shadow: Object;
+    style: Object;
+    enabled: boolean;
+};
+/**
+ * Default settings for label styling.
+ * @typedef {Object} LabelDefaultSettings
+ * @property {string} FONT_COLOR - Default label font color
+ * @property {string} FONT_SIZE - Default label font size
+ * @property {string} FONT_FAMILY - Default label font family
+ */
+/**
+ * @type {LabelDefaultSettings}
+ */
+export const LABEL_DEFAULT_SETTINGS: LabelDefaultSettings;
+/**
+ * Default label options for Highcharts data labels.
+ * @type {{ style: { fontSize: string, fontFamily: string, fontWeight: string }, color: string }}
+ */
+export const LABEL_DEFAULT_OPTIONS: {
+    style: {
+        fontSize: string;
+        fontFamily: string;
+        fontWeight: string;
+    };
+    color: string;
+};
+/**
+ * Default label for chart axis.
+ * @type {string}
+ */
+export const CHART_AXIS_DEFAULT_LABEL: string;
+/**
+ * Default label for chart legend.
+ * @type {string}
+ */
+export const CHART_LEGEND_DEFAULT_LABEL: string;
+/**
+ * Pre-generated font size options for suboptions select elements.
+ * @type {Array<{label: number, value: number}>}
+ */
+export const SUBOPTIONS_FONT_SIZE_VALUES: Array<{
+    label: number;
+    value: number;
+}>;
+/**
+ * Default CSS class for suboption categories.
+ * @type {string}
+ */
+export const DEFAULT_CATEGORY_CLASS: string;
+/**
+ * Generates font size options for select elements.
+ * Creates options from 6 to 24 (inclusive).
+ * @returns {Array<{label: number, value: number}>} Array of font size options
+ */
+export function generateFontSizeOptions(): Array<{
+    label: number;
+    value: number;
+}>;

package/src/types/options/elements.d.ts

@@ -0,0 +1,456 @@
+/**
+ * Element type literals for suboption elements.
+ */
+export type ElementType = "toggle" | "checkbox" | "input" | "select" | "radio" | "color_picker" | "devider" | "textarea" | "tag" | "text";
+/**
+ * Option item for select/radio elements.
+ */
+export type ElementOption = {
+    /**
+     * - Display label
+     */
+    label: string | number;
+    /**
+     * - Option value
+     */
+    value: string | number;
+};
+/**
+ * Tag element options configuration.
+ */
+export type TagElementOptions = {
+    /**
+     * - Whether new tags can be added
+     */
+    add_new_tag?: boolean | undefined;
+    /**
+     * - Whether tags are searchable
+     */
+    searchable?: boolean | undefined;
+    /**
+     * - Whether multiple tags can be selected
+     */
+    multiple?: boolean | undefined;
+};
+/**
+ * Callback function that receives chart type and returns boolean.
+ */
+export type ShowConditionCallback = (chartType: string) => boolean;
+/**
+ * Callback function for handling value changes.
+ */
+export type ValueChangeCallback = (value: Record<string, unknown>) => void;
+/**
+ * Callback function for disabled state.
+ */
+export type DisabledConditionCallback = (value: Record<string, unknown>) => boolean;
+/**
+ * Suboption element definition.
+ */
+export type SuboptionElement = {
+    /**
+     * - Type of the UI element
+     */
+    element_type: ElementType;
+    /**
+     * - Display label for the element
+     */
+    element_label?: string | undefined;
+    /**
+     * - Property name in the options object
+     */
+    value_name?: string | undefined;
+    /**
+     * - Default value for the element
+     */
+    default_value?: string | number | boolean | unknown[] | null | undefined;
+    /**
+     * - Options for select/radio/tag elements
+     */
+    element_options?: string[] | ElementOption[] | TagElementOptions | undefined;
+    /**
+     * - Function to determine if element should be shown
+     */
+    showFn?: ShowConditionCallback | undefined;
+    /**
+     * - Click handler function
+     */
+    clickFn?: ValueChangeCallback | undefined;
+    /**
+     * - Change handler function
+     */
+    onChange?: ValueChangeCallback | undefined;
+    /**
+     * - String expression for disabled state
+     */
+    disabled_str?: string | undefined;
+    /**
+     * - Function to determine disabled state
+     */
+    disabled_fn?: DisabledConditionCallback | undefined;
+    /**
+     * - Whether element is hidden
+     */
+    hidden?: boolean | undefined;
+    /**
+     * - Whether to show element in one row
+     */
+    show_in_one_row?: boolean | undefined;
+    /**
+     * - Tooltip text for the label
+     */
+    label_tooltip?: string | undefined;
+    /**
+     * - Subtitle for the element
+     */
+    element_sub_title?: string | undefined;
+    /**
+     * - Value type for input elements
+     */
+    value_type?: "string" | "number" | undefined;
+};
+/**
+ * Toggle element options.
+ */
+export type ToggleElementOptions = {
+    /**
+     * - Disabled state expression
+     */
+    disabled_str?: string | undefined;
+    /**
+     * - Disabled state function
+     */
+    disabled_fn?: DisabledConditionCallback | undefined;
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+};
+/**
+ * Checkbox element options.
+ */
+export type CheckboxElementOptions = {
+    /**
+     * - Click handler
+     */
+    clickFn?: ValueChangeCallback | undefined;
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+    /**
+     * - Disabled state function
+     */
+    disabled_fn?: DisabledConditionCallback | undefined;
+    /**
+     * - Whether element is hidden
+     */
+    hidden?: boolean | undefined;
+};
+/**
+ * Input element options.
+ */
+export type InputElementOptions = {
+    /**
+     * - Change handler
+     */
+    onChange?: ValueChangeCallback | undefined;
+    /**
+     * - Tooltip text
+     */
+    label_tooltip?: string | undefined;
+    /**
+     * - Show in one row
+     */
+    show_in_one_row?: boolean | undefined;
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+};
+/**
+ * Select element additional options.
+ */
+export type SelectElementOptions = {
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+    /**
+     * - Disabled state function
+     */
+    disabled_fn?: DisabledConditionCallback | undefined;
+};
+/**
+ * Radio element additional options.
+ */
+export type RadioElementOptions = {
+    /**
+     * - Subtitle for the element
+     */
+    element_sub_title?: string | undefined;
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+};
+/**
+ * Color picker element additional options.
+ */
+export type ColorPickerElementOptions = {
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+};
+/**
+ * Textarea element additional options.
+ */
+export type TextareaElementOptions = {
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+};
+/**
+ * Tag element additional options.
+ */
+export type TagAdditionalOptions = {
+    /**
+     * - Show condition function
+     */
+    showFn?: ShowConditionCallback | undefined;
+};
+/**
+ * Font styling default values.
+ */
+export type FontStylingDefaults = {
+    /**
+     * - Default font style
+     */
+    fontStyle?: string | undefined;
+    /**
+     * - Default font size
+     */
+    fontSize?: string | number | undefined;
+    /**
+     * - Default font color
+     */
+    fontColor?: string | undefined;
+};
+/**
+ * @fileoverview UI element factory functions for chart suboptions.
+ * Provides reusable factories to create consistent element definitions
+ * for the chart options editor UI.
+ * @module @datarailsshared/dr_renderer/options/elements
+ */
+/**
+ * Element type literals for suboption elements.
+ * @typedef {'toggle'|'checkbox'|'input'|'select'|'radio'|'color_picker'|'devider'|'textarea'|'tag'|'text'} ElementType
+ */
+/**
+ * Option item for select/radio elements.
+ * @typedef {Object} ElementOption
+ * @property {string|number} label - Display label
+ * @property {string|number} value - Option value
+ */
+/**
+ * Tag element options configuration.
+ * @typedef {Object} TagElementOptions
+ * @property {boolean} [add_new_tag] - Whether new tags can be added
+ * @property {boolean} [searchable] - Whether tags are searchable
+ * @property {boolean} [multiple] - Whether multiple tags can be selected
+ */
+/**
+ * Callback function that receives chart type and returns boolean.
+ * @callback ShowConditionCallback
+ * @param {string} chartType - The chart type identifier
+ * @returns {boolean} Whether to show the element
+ */
+/**
+ * Callback function for handling value changes.
+ * @callback ValueChangeCallback
+ * @param {Record<string, unknown>} value - The current options value object
+ * @returns {void}
+ */
+/**
+ * Callback function for disabled state.
+ * @callback DisabledConditionCallback
+ * @param {Record<string, unknown>} value - The current options value object
+ * @returns {boolean} Whether the element should be disabled
+ */
+/**
+ * Suboption element definition.
+ * @typedef {Object} SuboptionElement
+ * @property {ElementType} element_type - Type of the UI element
+ * @property {string} [element_label] - Display label for the element
+ * @property {string} [value_name] - Property name in the options object
+ * @property {string|number|boolean|null|Array<unknown>} [default_value] - Default value for the element
+ * @property {Array<ElementOption>|TagElementOptions|string[]} [element_options] - Options for select/radio/tag elements
+ * @property {ShowConditionCallback} [showFn] - Function to determine if element should be shown
+ * @property {ValueChangeCallback} [clickFn] - Click handler function
+ * @property {ValueChangeCallback} [onChange] - Change handler function
+ * @property {string} [disabled_str] - String expression for disabled state
+ * @property {DisabledConditionCallback} [disabled_fn] - Function to determine disabled state
+ * @property {boolean} [hidden] - Whether element is hidden
+ * @property {boolean} [show_in_one_row] - Whether to show element in one row
+ * @property {string} [label_tooltip] - Tooltip text for the label
+ * @property {string} [element_sub_title] - Subtitle for the element
+ * @property {'number'|'string'} [value_type] - Value type for input elements
+ */
+/**
+ * Toggle element options.
+ * @typedef {Object} ToggleElementOptions
+ * @property {string} [disabled_str] - Disabled state expression
+ * @property {DisabledConditionCallback} [disabled_fn] - Disabled state function
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ */
+/**
+ * Creates a toggle element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {boolean} [defaultValue=false] - Default value
+ * @param {ToggleElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createToggle(valueName: string, label: string, defaultValue?: boolean, options?: ToggleElementOptions): SuboptionElement;
+/**
+ * Checkbox element options.
+ * @typedef {Object} CheckboxElementOptions
+ * @property {ValueChangeCallback} [clickFn] - Click handler
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ * @property {DisabledConditionCallback} [disabled_fn] - Disabled state function
+ * @property {boolean} [hidden] - Whether element is hidden
+ */
+/**
+ * Creates a checkbox element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {boolean} [defaultValue=false] - Default value
+ * @param {CheckboxElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createCheckbox(valueName: string, label: string, defaultValue?: boolean, options?: CheckboxElementOptions): SuboptionElement;
+/**
+ * Input element options.
+ * @typedef {Object} InputElementOptions
+ * @property {ValueChangeCallback} [onChange] - Change handler
+ * @property {string} [label_tooltip] - Tooltip text
+ * @property {boolean} [show_in_one_row] - Show in one row
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ */
+/**
+ * Creates an input element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {string|number|null} [defaultValue=''] - Default value
+ * @param {InputElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createInput(valueName: string, label: string, defaultValue?: string | number | null, options?: InputElementOptions): SuboptionElement;
+/**
+ * Select element additional options.
+ * @typedef {Object} SelectElementOptions
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ * @property {DisabledConditionCallback} [disabled_fn] - Disabled state function
+ */
+/**
+ * Creates a select element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {Array<ElementOption>|string[]} elementOptions - Options for the select
+ * @param {string|number} [defaultValue] - Default value
+ * @param {SelectElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createSelect(valueName: string, label: string, elementOptions: Array<ElementOption> | string[], defaultValue?: string | number, options?: SelectElementOptions): SuboptionElement;
+/**
+ * Radio element additional options.
+ * @typedef {Object} RadioElementOptions
+ * @property {string} [element_sub_title] - Subtitle for the element
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ */
+/**
+ * Creates a radio element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {Array<ElementOption>} elementOptions - Options for the radio group
+ * @param {string} [defaultValue=''] - Default value
+ * @param {RadioElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createRadio(valueName: string, label: string, elementOptions: Array<ElementOption>, defaultValue?: string, options?: RadioElementOptions): SuboptionElement;
+/**
+ * Color picker element additional options.
+ * @typedef {Object} ColorPickerElementOptions
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ */
+/**
+ * Creates a color picker element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {string} [defaultValue=''] - Default color value
+ * @param {ColorPickerElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createColorPicker(valueName: string, label: string, defaultValue?: string, options?: ColorPickerElementOptions): SuboptionElement;
+/**
+ * Creates a divider element.
+ * @param {string} [label] - Optional section label
+ * @returns {SuboptionElement}
+ */
+export function createDivider(label?: string): SuboptionElement;
+/**
+ * Textarea element additional options.
+ * @typedef {Object} TextareaElementOptions
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ */
+/**
+ * Creates a textarea element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {string} [defaultValue=''] - Default value
+ * @param {TextareaElementOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createTextarea(valueName: string, label: string, defaultValue?: string, options?: TextareaElementOptions): SuboptionElement;
+/**
+ * Tag element additional options.
+ * @typedef {Object} TagAdditionalOptions
+ * @property {ShowConditionCallback} [showFn] - Show condition function
+ */
+/**
+ * Creates a tag element.
+ * @param {string} valueName - Property name in options
+ * @param {string} label - Display label
+ * @param {Array<string|number>} [defaultValue=[]] - Default value
+ * @param {TagElementOptions} [tagOptions={}] - Tag-specific options
+ * @param {TagAdditionalOptions} [options={}] - Additional options
+ * @returns {SuboptionElement}
+ */
+export function createTag(valueName: string, label: string, defaultValue?: Array<string | number>, tagOptions?: TagElementOptions, options?: TagAdditionalOptions): SuboptionElement;
+/**
+ * Font styling default values.
+ * @typedef {Object} FontStylingDefaults
+ * @property {string} [fontStyle] - Default font style
+ * @property {string|number} [fontSize] - Default font size
+ * @property {string} [fontColor] - Default font color
+ */
+/**
+ * Creates a standard font styling group (font style, size, color).
+ * @param {FontStylingDefaults} [defaults={}] - Default values
+ * @returns {SuboptionElement[]}
+ */
+export function createFontStylingGroup(defaults?: FontStylingDefaults): SuboptionElement[];
+/**
+ * Creates a label font styling group with divider.
+ * @param {FontStylingDefaults} [defaults={}] - Default values
+ * @returns {SuboptionElement[]}
+ */
+export function createLabelStyleGroup(defaults?: FontStylingDefaults): SuboptionElement[];
+/**
+ * Creates a tooltip font styling group with divider.
+ * @param {FontStylingDefaults} [defaults={}] - Default values
+ * @returns {SuboptionElement[]}
+ */
+export function createTooltipStyleGroup(defaults?: FontStylingDefaults): SuboptionElement[];

package/src/types/options/helpers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if a chart type supports vertical data labels option.
+ * Returns false for chart types that don't support vertical labels.
+ * @param {string} type - The chart type identifier
+ * @returns {boolean} True if the chart supports vertical data labels
+ */
+export function chartHasVerticalDataLabelsOption(type: string): boolean;