@datarailsshared/dr_renderer 1.5.107 → 1.5.116

package/src/options/index.js

@@ -0,0 +1,215 @@
+/**
+ * @fileoverview Chart Options Builder API
+ * 
+ * This module provides a functional builder pattern for creating chart suboption
+ * configurations. It allows for composable, reusable option definitions with
+ * full type support.
+ * 
+ * @module @datarailsshared/dr_renderer/options
+ * 
+ * @example
+ * // Import builders
+ * const { withLabel, withTooltip, buildSuboptions } = require('@datarailsshared/dr_renderer').options;
+ * 
+ * // Build custom suboptions
+ * const suboptions = buildSuboptions([withLabel, withTooltip]);
+ * 
+ * @example
+ * // Get preset for a chart type
+ * const { getPresetForChart, buildSuboptionsForChart } = require('@datarailsshared/dr_renderer').options;
+ * 
+ * const columnChartOptions = buildSuboptionsForChart('column-chart');
+ */
+
+// Re-export constants
+const constants = require('./constants');
+
+// Re-export element factories
+const elements = require('./elements');
+
+// Re-export builders
+const builders = require('./builders');
+
+// Re-export presets
+const presets = require('./presets');
+
+// Re-export helpers
+const helpers = require('./helpers');
+
+// ============================================================================
+// Factory Functions
+// ============================================================================
+
+/**
+ * Feature flag checker callback.
+ * @callback FeatureChecker
+ * @param {string} featureName - The feature flag name to check
+ * @returns {boolean} Whether the feature is enabled
+ */
+
+/**
+ * Configuration for createDefaultSuboptions.
+ * @typedef {Object} CreateDefaultSuboptionsConfig
+ * @property {import('./constants').ChartTypesMap} [CHART_TYPES] - Chart types enum (for table options)
+ * @property {FeatureChecker} [hasFeature] - Feature flag checker function
+ * @property {string} [ENABLE_GAUGE_DYNAMIC_GOAL] - Feature flag name for gauge dynamic goal
+ * @property {import('./builders').GaugeSegment[]} [defaultGaugeSegments] - Default gauge segments array
+ */
+
+/**
+ * Creates the default suboptions object for highchartsRenderer.
+ * This generates the complete suboptions object with all chart options.
+ * @param {CreateDefaultSuboptionsConfig} [config={}] - Configuration options
+ * @returns {Record<string, import('./builders').SuboptionDefinition>} Complete suboptions object
+ */
+const createDefaultSuboptions = (config = {}) => ({
+    'widget_library': builders.withWidgetLibrary(),
+    'table_options': builders.withTableOptions(),
+    'table_options_transpose': builders.withTableOptionsTranspose({ CHART_TYPES: config.CHART_TYPES }),
+    'table_options_gauge': builders.withTableOptionsGauge(),
+    'table_design_options': builders.withTableDesignOptions(),
+    'value': builders.withValue(),
+    'range': builders.withRange(),
+    'name': builders.withName(),
+    'subtitle': builders.withSubtitle(),
+    'chart': builders.withChart(),
+    'chart_grid': builders.withChartGrid(),
+    'chart_forecast': builders.withChartForecast(),
+    'total_value_label_donut': builders.withTotalValueLabelDonut(),
+    'chart_position': builders.withChartPosition(),
+    'label': builders.withLabel(),
+    'label_pie': builders.withLabelPie(),
+    'label_gauge': builders.withLabelGauge({ 
+        hasFeature: config.hasFeature, 
+        ENABLE_GAUGE_DYNAMIC_GOAL: config.ENABLE_GAUGE_DYNAMIC_GOAL 
+    }),
+    'label_with_percentage': builders.withLabelWithPercentage(),
+    'label_with_percentage_percent_stacked': builders.withLabelWithPercentagePercentStacked(),
+    'axisY': builders.withAxisY(),
+    'axisY_percent_stacked': builders.withAxisYPercentStacked(),
+    'axisX': builders.withAxisX(),
+    'ticks': builders.withTicks(),
+    'tooltips': builders.withTooltip(),
+    'tooltips_pie': builders.withTooltipPie(),
+    'tooltips_gauge': builders.withTooltipGauge(),
+    'negative_number_format': builders.withNegativeNumberFormat(),
+    'delta_column': builders.withDeltaColumn(),
+    'delta_column_for_drill_down': builders.withDeltaColumnForDrillDown(),
+    'advanced': builders.withAdvanced(),
+    'legends': builders.withLegends(),
+    'gauge_goal': builders.withGaugeGoal(),
+    'gauge_segments': builders.withGaugeSegments({ defaultSegments: config.defaultGaugeSegments }),
+    'gauge_is_absolute': builders.withGaugeIsAbsolute(),
+});
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+module.exports = {
+    // Constants
+    CHART_COLORS: constants.CHART_COLORS,
+    SUBOPTIONS_FONTS: constants.SUBOPTIONS_FONTS,
+    HIGHCHARTS_FONT_FAMILY: constants.HIGHCHARTS_FONT_FAMILY,
+    HIGHCHARTS_FONT_FAMILY_CSS: constants.HIGHCHARTS_FONT_FAMILY_CSS,
+    TOOLTIP_DEFAULT_SETTINGS: constants.TOOLTIP_DEFAULT_SETTINGS,
+    TOOLTIP_DEFAULT_OPTIONS: constants.TOOLTIP_DEFAULT_OPTIONS,
+    LABEL_DEFAULT_SETTINGS: constants.LABEL_DEFAULT_SETTINGS,
+    LABEL_DEFAULT_OPTIONS: constants.LABEL_DEFAULT_OPTIONS,
+    SUBOPTIONS_FONT_SIZE_VALUES: constants.SUBOPTIONS_FONT_SIZE_VALUES,
+    DEFAULT_CATEGORY_CLASS: constants.DEFAULT_CATEGORY_CLASS,
+    
+    // Element factories
+    createToggle: elements.createToggle,
+    createCheckbox: elements.createCheckbox,
+    createInput: elements.createInput,
+    createSelect: elements.createSelect,
+    createRadio: elements.createRadio,
+    createColorPicker: elements.createColorPicker,
+    createDivider: elements.createDivider,
+    createTextarea: elements.createTextarea,
+    createTag: elements.createTag,
+    createFontStylingGroup: elements.createFontStylingGroup,
+    createLabelStyleGroup: elements.createLabelStyleGroup,
+    createTooltipStyleGroup: elements.createTooltipStyleGroup,
+    
+    // Label builders
+    withLabel: builders.withLabel,
+    withLabelPie: builders.withLabelPie,
+    withLabelGauge: builders.withLabelGauge,
+    withLabelWithPercentage: builders.withLabelWithPercentage,
+    withLabelWithPercentagePercentStacked: builders.withLabelWithPercentagePercentStacked,
+    
+    // Tooltip builders
+    withTooltip: builders.withTooltip,
+    withTooltipPie: builders.withTooltipPie,
+    withTooltipGauge: builders.withTooltipGauge,
+    
+    // Axis builders
+    withAxisY: builders.withAxisY,
+    withAxisYPercentStacked: builders.withAxisYPercentStacked,
+    withAxisX: builders.withAxisX,
+    
+    // Table builders
+    withTableOptions: builders.withTableOptions,
+    withTableOptionsTranspose: builders.withTableOptionsTranspose,
+    withTableOptionsGauge: builders.withTableOptionsGauge,
+    withTableDesignOptions: builders.withTableDesignOptions,
+    
+    // Chart config builders
+    withChart: builders.withChart,
+    withChartGrid: builders.withChartGrid,
+    withChartForecast: builders.withChartForecast,
+    withChartPosition: builders.withChartPosition,
+    
+    // Other builders
+    withWidgetLibrary: builders.withWidgetLibrary,
+    withSubtitle: builders.withSubtitle,
+    withName: builders.withName,
+    withNegativeNumberFormat: builders.withNegativeNumberFormat,
+    withValue: builders.withValue,
+    withRange: builders.withRange,
+    withTicks: builders.withTicks,
+    withLegends: builders.withLegends,
+    withDeltaColumn: builders.withDeltaColumn,
+    withDeltaColumnForDrillDown: builders.withDeltaColumnForDrillDown,
+    withAdvanced: builders.withAdvanced,
+    withTotalValueLabelDonut: builders.withTotalValueLabelDonut,
+    withGaugeGoal: builders.withGaugeGoal,
+    withGaugeSegments: builders.withGaugeSegments,
+    withGaugeIsAbsolute: builders.withGaugeIsAbsolute,
+    
+    // Helper function
+    createSuboption: builders.createSuboption,
+    
+    // Reusable disabled conditions
+    LABEL_DISABLED_CONDITION: builders.LABEL_DISABLED_CONDITION,
+    LABEL_PIE_DISABLED_CONDITION: builders.LABEL_PIE_DISABLED_CONDITION,
+    TOOLTIP_DISABLED_CONDITION: builders.TOOLTIP_DISABLED_CONDITION,
+    TOOLTIP_PIE_DISABLED_CONDITION: builders.TOOLTIP_PIE_DISABLED_CONDITION,
+    
+    // Reusable elements
+    LABEL_SHOW_TOGGLE: builders.LABEL_SHOW_TOGGLE,
+    LABEL_PIE_SHOW_TOGGLE: builders.LABEL_PIE_SHOW_TOGGLE,
+    LABEL_OVERLAP_TOGGLE: builders.LABEL_OVERLAP_TOGGLE,
+    TOOLTIP_SHOW_TOGGLE: builders.TOOLTIP_SHOW_TOGGLE,
+    TOOLTIP_PIE_SHOW_TOGGLE: builders.TOOLTIP_PIE_SHOW_TOGGLE,
+    GAUGE_SHOW_TOGGLE: builders.GAUGE_SHOW_TOGGLE,
+    
+    // Presets and utilities
+    CHART_TYPES: constants.CHART_TYPES,
+    CHART_PRESETS: presets.CHART_PRESETS,
+    BUILDER_KEY_MAP: presets.BUILDER_KEY_MAP,
+    getBuilderKey: presets.getBuilderKey,
+    getPresetForChart: presets.getPresetForChart,
+    buildSuboptionsForChart: presets.buildSuboptionsForChart,
+    buildSuboptions: presets.buildSuboptions,
+    getChartTypes: presets.getChartTypes,
+    hasPreset: presets.hasPreset,
+    
+    // Helpers
+    chartHasVerticalDataLabelsOption: helpers.chartHasVerticalDataLabelsOption,
+    
+    // Factory functions
+    createDefaultSuboptions,
+};

package/src/options/presets.js

@@ -0,0 +1,388 @@
+/**
+ * @fileoverview Chart-specific option presets.
+ * Defines which suboptions are available for each chart type.
+ * @module @datarailsshared/dr_renderer/options/presets
+ */
+
+const { CHART_TYPES } = require('./constants');
+
+const {
+    // Label builders
+    withLabel,
+    withLabelPie,
+    withLabelGauge,
+    withLabelWithPercentage,
+    withLabelWithPercentagePercentStacked,
+    
+    // Tooltip builders
+    withTooltip,
+    withTooltipPie,
+    withTooltipGauge,
+    
+    // Axis builders
+    withAxisY,
+    withAxisYPercentStacked,
+    withAxisX,
+    
+    // Table builders
+    withTableOptions,
+    withTableOptionsTranspose,
+    withTableOptionsGauge,
+    withTableDesignOptions,
+    
+    // Chart config builders
+    withChart,
+    withChartGrid,
+    withChartForecast,
+    withChartPosition,
+    
+    // Other builders
+    withWidgetLibrary,
+    withSubtitle,
+    withName,
+    withNegativeNumberFormat,
+    withValue,
+    withRange,
+    withLegends,
+    withDeltaColumn,
+    withDeltaColumnForDrillDown,
+    withAdvanced,
+    withTotalValueLabelDonut,
+    withGaugeGoal,
+    withGaugeSegments,
+    withGaugeIsAbsolute,
+    withTicks,
+} = require('./builders');
+
+// ============================================================================
+// Suboption Key Mapping
+// ============================================================================
+
+/**
+ * Suboption key string literal.
+ * @typedef {'label'|'label_pie'|'label_gauge'|'label_with_percentage'|'label_with_percentage_percent_stacked'|'tooltips'|'tooltips_pie'|'tooltips_gauge'|'axisY'|'axisY_percent_stacked'|'axisX'|'table_options'|'table_options_transpose'|'table_options_gauge'|'table_design_options'|'chart'|'chart_grid'|'chart_forecast'|'chart_position'|'widget_library'|'subtitle'|'name'|'negative_number_format'|'value'|'range'|'legends'|'delta_column'|'delta_column_for_drill_down'|'advanced'|'total_value_label_donut'|'gauge_goal'|'gauge_segments'|'gauge_is_absolute'|'ticks'} SuboptionKey
+ */
+
+/**
+ * Maps builder functions to their suboption keys.
+ * Used to build the suboptions object with correct keys.
+ * @type {Map<BuilderFunction, SuboptionKey>}
+ */
+const BUILDER_KEY_MAP = new Map([
+    [withLabel, 'label'],
+    [withLabelPie, 'label_pie'],
+    [withLabelGauge, 'label_gauge'],
+    [withLabelWithPercentage, 'label_with_percentage'],
+    [withLabelWithPercentagePercentStacked, 'label_with_percentage_percent_stacked'],
+    [withTooltip, 'tooltips'],
+    [withTooltipPie, 'tooltips_pie'],
+    [withTooltipGauge, 'tooltips_gauge'],
+    [withAxisY, 'axisY'],
+    [withAxisYPercentStacked, 'axisY_percent_stacked'],
+    [withAxisX, 'axisX'],
+    [withTableOptions, 'table_options'],
+    [withTableOptionsTranspose, 'table_options_transpose'],
+    [withTableOptionsGauge, 'table_options_gauge'],
+    [withTableDesignOptions, 'table_design_options'],
+    [withChart, 'chart'],
+    [withChartGrid, 'chart_grid'],
+    [withChartForecast, 'chart_forecast'],
+    [withChartPosition, 'chart_position'],
+    [withWidgetLibrary, 'widget_library'],
+    [withSubtitle, 'subtitle'],
+    [withName, 'name'],
+    [withNegativeNumberFormat, 'negative_number_format'],
+    [withValue, 'value'],
+    [withRange, 'range'],
+    [withLegends, 'legends'],
+    [withDeltaColumn, 'delta_column'],
+    [withDeltaColumnForDrillDown, 'delta_column_for_drill_down'],
+    [withAdvanced, 'advanced'],
+    [withTotalValueLabelDonut, 'total_value_label_donut'],
+    [withGaugeGoal, 'gauge_goal'],
+    [withGaugeSegments, 'gauge_segments'],
+    [withGaugeIsAbsolute, 'gauge_is_absolute'],
+    [withTicks, 'ticks'],
+]);
+
+// ============================================================================
+// Chart Preset Definitions
+// ============================================================================
+
+/**
+ * Chart presets mapping chart types to their suboption builders.
+ * Each preset defines which builders are used for that chart type.
+ * @type {Record<import('./constants').ChartTypeValue, BuilderFunction[]>}
+ */
+const CHART_PRESETS = {
+    // Line charts
+    [CHART_TYPES.LINE_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.LINE_CHART_SMOOTH]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.LINE_CHART_FORECAST]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartForecast, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    
+    // Area charts
+    [CHART_TYPES.AREA_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.AREA_CHART_SMOOTH]: [
+        withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    
+    // Polygon chart
+    [CHART_TYPES.POLYGON_CHART]: [
+        withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    
+    // Column charts
+    [CHART_TYPES.COLUMN_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptions, withTableDesignOptions,
+        withChart, withNegativeNumberFormat, withDeltaColumnForDrillDown, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.COLUMN_CHART_STACKED]: [
+        withAxisY, withAxisX, withTooltip, withLabelWithPercentage, withSubtitle,
+        withWidgetLibrary, withTableOptions, withTableDesignOptions,
+        withChartGrid, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.COLUMN_CHART_STACKED_PERCENT]: [
+        withAxisYPercentStacked, withAxisX, withTooltip, withLabelWithPercentagePercentStacked, withSubtitle,
+        withWidgetLibrary, withTableOptions, withTableDesignOptions,
+        withChartGrid, withAdvanced, withLegends,
+    ],
+    
+    // Combo charts
+    [CHART_TYPES.COMBO_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.COMBO_COLUMN_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptions, withTableDesignOptions,
+        withChart, withNegativeNumberFormat, withDeltaColumnForDrillDown, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.COMBO_STACKED_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabelWithPercentage, withSubtitle,
+        withWidgetLibrary, withTableOptions, withTableDesignOptions,
+        withChartGrid, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    
+    // Bar charts
+    [CHART_TYPES.BAR_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.BAR_CHART_STACKED]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.BAR_CHART_STACKED_PERCENT]: [
+        withAxisYPercentStacked, withAxisX, withTooltip, withLabelWithPercentagePercentStacked, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withAdvanced, withLegends,
+    ],
+    
+    // Scatter chart
+    [CHART_TYPES.SCATTER_CHART]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChartGrid, withNegativeNumberFormat, withDeltaColumn, withAdvanced, withLegends,
+    ],
+    
+    // Pie charts
+    [CHART_TYPES.PIE_CHART]: [
+        withTooltipPie, withLabelPie, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChart, withNegativeNumberFormat, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.PIE_CHART_DRILLDOWN]: [
+        withTooltipPie, withLabelPie, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChart, withNegativeNumberFormat, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.DONUT_CHART]: [
+        withTooltipPie, withLabelPie, withSubtitle,
+        withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withChart, withNegativeNumberFormat, withAdvanced, withLegends,
+        withChartPosition, withTotalValueLabelDonut,
+    ],
+    
+    // Gauge charts
+    [CHART_TYPES.GAUGE_CHART_ENHANCED]: [
+        withLabelGauge, withTooltipGauge, withSubtitle,
+        withTableOptionsGauge, withTableDesignOptions,
+        withGaugeGoal, withGaugeSegments, withGaugeIsAbsolute,
+    ],
+    [CHART_TYPES.GAUGE_CHART_DYNAMIC_GOAL]: [
+        withLabelGauge, withTooltipGauge, withSubtitle,
+        withTableOptionsGauge, withTableDesignOptions,
+        withGaugeGoal, withGaugeSegments, withGaugeIsAbsolute,
+    ],
+    [CHART_TYPES.GAUGE_CHART_CATEGORIES_SUMMARY]: [
+        withLabelGauge, withTooltipGauge, withSubtitle,
+    ],
+    
+    // KPI widgets
+    [CHART_TYPES.KPI_WIDGET]: [
+        withValue, withRange, withWidgetLibrary, withName,
+        withTableOptionsTranspose, withTableDesignOptions,
+        withNegativeNumberFormat, withLegends,
+    ],
+    [CHART_TYPES.SMART_KPI]: [
+        withValue, withRange, withWidgetLibrary, withName,
+        withTableOptionsTranspose, withTableDesignOptions,
+        withNegativeNumberFormat, withLegends,
+    ],
+    
+    // Text widget
+    [CHART_TYPES.TEXT_WIDGET]: [
+        withName, withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withNegativeNumberFormat, withLegends,
+    ],
+    
+    // Table only
+    [CHART_TYPES.TABLE_ONLY]: [
+        withSubtitle, withWidgetLibrary, withTableOptionsTranspose, withTableDesignOptions,
+        withNegativeNumberFormat, withDeltaColumn, withAdvanced,
+    ],
+    
+    // Waterfall charts
+    [CHART_TYPES.WATERFALL_BREAKDOWN]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withChart, withNegativeNumberFormat, withAdvanced, withLegends,
+    ],
+    [CHART_TYPES.WATERFALL_WALKTHROUGH]: [
+        withAxisY, withAxisX, withTooltip, withLabel, withSubtitle,
+        withWidgetLibrary, withChart, withNegativeNumberFormat, withAdvanced, withLegends,
+    ],
+    
+    // Legacy gauge charts (kept for backwards compatibility)
+    [CHART_TYPES.GAUGE_SOLID_CHART]: [],
+    [CHART_TYPES.GAUGE_CHART]: [],
+    
+    // Non-chart types (kept for type completeness)
+    [CHART_TYPES.PUBLISHED_ITEM]: [],
+    [CHART_TYPES.RICH_TEXT]: [],
+    [CHART_TYPES.EXCEL_VIEWER]: [],
+};
+
+// ============================================================================
+// Utility Functions
+// ============================================================================
+
+/**
+ * Gets the suboption key for a builder function.
+ * @param {BuilderFunction} builder - The builder function
+ * @returns {SuboptionKey|undefined} The suboption key
+ */
+const getBuilderKey = (builder) => BUILDER_KEY_MAP.get(builder);
+
+/**
+ * Gets the preset configuration for a chart type.
+ * @param {import('./constants').ChartTypeValue} chartType - The chart type identifier
+ * @returns {BuilderFunction[]|undefined} Array of builder functions or undefined if not found
+ */
+const getPresetForChart = (chartType) => CHART_PRESETS[chartType];
+
+/**
+ * Builder configuration options passed to builder functions.
+ * @typedef {Object} BuilderConfig
+ * @property {import('./constants').ChartTypesMap} [CHART_TYPES] - Chart types enum
+ * @property {(featureName: string) => boolean} [hasFeature] - Feature flag checker
+ * @property {string} [ENABLE_GAUGE_DYNAMIC_GOAL] - Feature flag name
+ * @property {import('./builders').GaugeSegment[]} [defaultSegments] - Default gauge segments
+ */
+
+/**
+ * Builder function type.
+ * @callback BuilderFunction
+ * @param {BuilderConfig} [config] - Configuration options
+ * @returns {import('./builders').SuboptionDefinition} The suboption definition
+ */
+
+/**
+ * Builds the suboptions object for a chart type using its preset.
+ * @param {string} chartType - The chart type identifier
+ * @param {BuilderConfig} [config={}] - Configuration to pass to builders
+ * @returns {Record<string, import('./builders').SuboptionDefinition>} The suboptions object
+ */
+const buildSuboptionsForChart = (chartType, config = {}) => {
+    const preset = CHART_PRESETS[/** @type {import('./constants').ChartTypeValue} */ (chartType)];
+    if (!preset) {
+        return {};
+    }
+    
+    /** @type {Record<string, import('./builders').SuboptionDefinition>} */
+    const suboptions = {};
+    preset.forEach((builder) => {
+        const key = BUILDER_KEY_MAP.get(builder);
+        if (key) {
+            suboptions[key] = builder(config);
+        }
+    });
+    
+    return suboptions;
+};
+
+/**
+ * Builds a complete suboptions object from an array of builders.
+ * @param {BuilderFunction[]} builders - Array of builder functions
+ * @param {BuilderConfig} [config={}] - Configuration to pass to builders
+ * @returns {Record<string, import('./builders').SuboptionDefinition>} The suboptions object
+ */
+const buildSuboptions = (builders, config = {}) => {
+    /** @type {Record<string, import('./builders').SuboptionDefinition>} */
+    const suboptions = {};
+    builders.forEach((builder) => {
+        const key = BUILDER_KEY_MAP.get(builder);
+        if (key) {
+            suboptions[key] = builder(config);
+        }
+    });
+    return suboptions;
+};
+
+/**
+ * Gets all available chart types.
+ * @returns {import('./constants').ChartTypeValue[]} Array of chart type identifiers
+ */
+const getChartTypes = () => /** @type {import('./constants').ChartTypeValue[]} */ (Object.values(CHART_TYPES));
+
+/**
+ * Checks if a chart type has a preset defined.
+ * @param {string} chartType - The chart type identifier
+ * @returns {boolean} True if preset exists
+ */
+const hasPreset = (chartType) => chartType in CHART_PRESETS;
+
+module.exports = {
+    CHART_TYPES,
+    CHART_PRESETS,
+    BUILDER_KEY_MAP,
+    getBuilderKey,
+    getPresetForChart,
+    buildSuboptionsForChart,
+    buildSuboptions,
+    getChartTypes,
+    hasPreset,
+};

package/src/types/graph-table-renderer.d.ts

@@ -35,9 +35,9 @@ export class GraphTableRenderer {
      * Creates Pivot Data Model that works we BE data response to aggregate data to render with Chart and Table
      * @param {Rows} rows BE data response
      * @param {GTROptions} options
-     * @returns {this}
+     * @returns {GraphTableRenderer}
      */
-    createPivotModel(rows: Rows, options: GTROptions): this;
+    createPivotModel(rows: Rows, options: GTROptions): GraphTableRenderer;
     /**
      * @returns {void}
      */

package/src/types/index.d.ts

@@ -1,2 +1,12 @@
+// Re-export error types
+export * from './errors';
+
+// Re-export GraphTableRenderer types
 export * from './graph-table-renderer';
-export * from './errors'
+
+// Re-export options module types
+export * from './options/builders';
+export * from './options/constants';
+export * from './options/elements';
+export * from './options/helpers';
+export * from './options/presets';