@adaptabletools/adaptable-cjs 23.0.0-canary.8 → 23.0.0

package/src/Utilities/Helpers/{ScheduledAlertHelper.js → Scheduling/ScheduledAlertHelper.js}

@@ -8,10 +8,10 @@ exports.getScheduledAlertNotificationForm = getScheduledAlertNotificationForm;
 exports.scheduledAlertIncludeSuspendButton = scheduledAlertIncludeSuspendButton;
 exports.CreateEmptyScheduledAlertDefinition = CreateEmptyScheduledAlertDefinition;
 const tslib_1 = require("tslib");
-const ObjectFactory_1 = tslib_1.__importDefault(require("../ObjectFactory"));
-const GeneralConstants_1 = require("../Constants/GeneralConstants");
-const ObjectDefaultConstants_1 = require("../Constants/ObjectDefaultConstants");
-const Uuid_1 = require("../../AdaptableState/Uuid");
+const ObjectFactory_1 = tslib_1.__importDefault(require("../../ObjectFactory"));
+const GeneralConstants_1 = require("../../Constants/GeneralConstants");
+const ObjectDefaultConstants_1 = require("../../Constants/ObjectDefaultConstants");
+const Uuid_1 = require("../../../AdaptableState/Uuid");
 function isScheduledAlertDefinition(alert) {
     return alert != null && 'Schedule' in alert;
 }

package/src/Utilities/Helpers/{ScheduledJobsMiddlewareHelper.d.ts → Scheduling/ScheduledJobsMiddlewareHelper.d.ts}

@@ -1,3 +1,3 @@
-import { IAdaptable } from '../../AdaptableInterfaces/IAdaptable';
+import { IAdaptable } from '../../../AdaptableInterfaces/IAdaptable';
 export declare function refreshScheduledAlertJobs(adaptable: IAdaptable): void;
 export declare function refreshScheduledReportJobs(adaptable: IAdaptable): void;

package/src/Utilities/Helpers/{ScheduledJobsMiddlewareHelper.js → Scheduling/ScheduledJobsMiddlewareHelper.js}

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.refreshScheduledAlertJobs = refreshScheduledAlertJobs;
 exports.refreshScheduledReportJobs = refreshScheduledReportJobs;
 const tslib_1 = require("tslib");
-const ModuleConstants = tslib_1.__importStar(require("../Constants/ModuleConstants"));
+const ModuleConstants = tslib_1.__importStar(require("../../Constants/ModuleConstants"));
 function refreshScheduledAlertJobs(adaptable) {
     const alertModule = adaptable.adaptableModules.get(ModuleConstants.AlertModuleId);
     alertModule?.setUpScheduledAlertJobs?.();

package/src/Utilities/Helpers/{ScheduledReportHelper.d.ts → Scheduling/ScheduledReportHelper.d.ts}

@@ -1,4 +1,4 @@
-import { ExportState, ReportNameType, ReportSchedule } from '../../AdaptableState/ExportState';
+import { ExportState, ReportNameType, ReportSchedule } from '../../../AdaptableState/ExportState';
 export declare function reportScheduleToSchedule(reportSchedule: {
     ReportName?: string;
     ScheduleType?: string;

package/src/Utilities/Helpers/{ScheduledReportHelper.js → Scheduling/ScheduledReportHelper.js}

@@ -8,7 +8,7 @@ exports.exportStateNeedsScheduleUuids = exportStateNeedsScheduleUuids;
 exports.ensureExportStateSchedulesUuids = ensureExportStateSchedulesUuids;
 exports.replaceScheduledReportScheduleInList = replaceScheduledReportScheduleInList;
 exports.countSchedulesForReport = countSchedulesForReport;
-const Uuid_1 = require("../../AdaptableState/Uuid");
+const Uuid_1 = require("../../../AdaptableState/Uuid");
 function reportScheduleToSchedule(reportSchedule) {
     const { ReportName: reportName, ScheduleType: _scheduleType, ...schedule } = reportSchedule;
     return {

package/src/Utilities/Helpers/SettingsPanelHelper.d.ts

@@ -0,0 +1,5 @@
+import { AdaptableApi } from '../../Api/AdaptableApi';
+import { SettingsPanelNavigation, SettingsPanelNavigationGroup, SettingsPanelOptions } from '../../AdaptableOptions/SettingsPanelOptions';
+export declare const DEFAULT_SETTINGS_PANEL_NAVIGATION_GROUPS: SettingsPanelNavigationGroup[];
+export declare const buildDefaultSettingsPanelNavigation: (customPanelNames?: string[]) => SettingsPanelNavigation;
+export declare const resolveSettingsPanelNavigation: (api: AdaptableApi, settingsPanelOptions: SettingsPanelOptions) => SettingsPanelNavigation;

package/src/Utilities/{Defaults/DefaultSettingsPanel.js → Helpers/SettingsPanelHelper.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildDefaultSettingsPanelNavigation = exports.DEFAULT_SETTINGS_PANEL_NAVIGATION_GROUPS = void 0;
+exports.resolveSettingsPanelNavigation = exports.buildDefaultSettingsPanelNavigation = exports.DEFAULT_SETTINGS_PANEL_NAVIGATION_GROUPS = void 0;
 exports.DEFAULT_SETTINGS_PANEL_NAVIGATION_GROUPS = [
     {
         label: 'Grid & UI',
@@ -49,3 +49,18 @@ const buildDefaultSettingsPanelNavigation = (customPanelNames = []) => {
     return { groups };
 };
 exports.buildDefaultSettingsPanelNavigation = buildDefaultSettingsPanelNavigation;
+const cloneSettingsPanelNavigation = (navigation) => ({
+    groups: navigation.groups.map((group) => ({
+        label: group.label,
+        items: [...group.items],
+    })),
+});
+const resolveSettingsPanelNavigation = (api, settingsPanelOptions) => {
+    const defaultNavigation = (0, exports.buildDefaultSettingsPanelNavigation)(settingsPanelOptions.customSettingsPanels?.map((panel) => panel.name) ?? []);
+    if (!settingsPanelOptions.navigation) {
+        return defaultNavigation;
+    }
+    const context = api.internalApi.buildBaseContext();
+    return settingsPanelOptions.navigation(context, cloneSettingsPanelNavigation(defaultNavigation));
+};
+exports.resolveSettingsPanelNavigation = resolveSettingsPanelNavigation;

package/src/Utilities/Helpers/StyledColumns/BarStylesHelper.d.ts

@@ -0,0 +1,63 @@
+import { BarStyleCellTextHorizontalAlignment, BarStyleCellTextLayout, BarStyleCellTextPlacement, BarStyleCellTextProperties, BarStyleCellTextVerticalAlignment } from '../../../AdaptableState/StyledColumns/Common/BarStyleProperties';
+import { CellTextOption, CellTextOptions } from '../../../AdaptableState/StyledColumns/Common/CellTextOptions';
+export type BarStyleCellTextLabels = {
+    cellValue?: string;
+    percentage?: string;
+};
+export declare const resolveBarStyleCellTextLayout: (props: BarStyleCellTextProperties | undefined) => BarStyleCellTextLayout;
+/** True when any value is configured for display. */
+export declare const hasBarStyleCellTextConfigured: (props: BarStyleCellTextProperties | undefined) => boolean;
+/** Set of value tokens that currently have a placement. */
+export declare const getActiveBarStyleCellTextTokens: (props: BarStyleCellTextProperties | undefined) => CellTextOptions;
+export declare const mergeBarStyleCellTextProperties: (current: BarStyleCellTextProperties | undefined, patch: Partial<BarStyleCellTextProperties>) => BarStyleCellTextProperties | undefined;
+/**
+ * Set or clear a value's placement. Passing `placement: undefined` removes the value.
+ */
+export declare const setBarStyleCellTextPlacement: (current: BarStyleCellTextProperties | undefined, token: CellTextOption, placement: BarStyleCellTextPlacement | undefined) => BarStyleCellTextProperties | undefined;
+/**
+ * Patch a single axis of a value's placement (creating the value with defaults if
+ * needed). Used by the wizard's placement pickers.
+ */
+export declare const patchBarStyleCellTextPlacement: (current: BarStyleCellTextProperties | undefined, token: CellTextOption, patch: Partial<BarStyleCellTextPlacement>) => BarStyleCellTextProperties | undefined;
+/**
+ * Toggle whether a value is displayed. When turning on a previously-hidden
+ * value we use the default placement (Left / Below).
+ */
+export declare const toggleBarStyleCellTextToken: (current: BarStyleCellTextProperties | undefined, token: CellTextOption, show: boolean) => {
+    CellTextProperties: BarStyleCellTextProperties | undefined;
+};
+export declare const buildBarStyleCellTextLabels: (props: BarStyleCellTextProperties | undefined, cellValueLabel: string | undefined, percentageLabel: string | undefined) => BarStyleCellTextLabels;
+export declare const hasBarStyleCellTextLabels: (labels: BarStyleCellTextLabels) => boolean;
+/** Join active labels with a space, Cell Value first then Percent Value. */
+export declare const joinBarStyleCellTextLabels: (labels: BarStyleCellTextLabels) => string;
+export type BarStyleCellTextSlotEntry = {
+    vertical: BarStyleCellTextVerticalAlignment;
+    horizontal: BarStyleCellTextHorizontalAlignment;
+    /** Labels in render order (Cell Value first, then Percent Value). */
+    parts: string[];
+    /** The joined text, ready to render. */
+    text: string;
+};
+/**
+ * Resolve which placements are populated and what text goes in each cell of
+ * the 3 × 3 grid. Empty slots are omitted. Two values landing on the same
+ * (vertical, horizontal) slot are concatenated with a single space, Cell
+ * Value before Percent Value.
+ */
+export declare const resolveBarStyleCellTextSlots: (props: BarStyleCellTextProperties | undefined, labels: BarStyleCellTextLabels) => BarStyleCellTextSlotEntry[];
+export type BarStyleCellTextSlotPresence = {
+    hasAbove: boolean;
+    hasBelow: boolean;
+    hasMerged: boolean;
+};
+export declare const getBarStyleCellTextSlotPresence: (props: BarStyleCellTextProperties | undefined) => BarStyleCellTextSlotPresence;
+export declare const formatBarStyleCellTextLayoutSummary: (layout: BarStyleCellTextLayout) => string | undefined;
+export type MountBarStyleCellTextArgs = {
+    wrapperEl: HTMLElement;
+    mergedOverlayEl?: HTMLElement;
+    textClassName: string;
+    cellTextProperties?: BarStyleCellTextProperties;
+    labels: BarStyleCellTextLabels;
+    mergedPointerEventsNone?: boolean;
+};
+export declare const mountBarStyleCellText: (args: MountBarStyleCellTextArgs) => void;

package/src/Utilities/Helpers/{barChartCellText.js → StyledColumns/BarStylesHelper.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mountBarChartCellText = exports.formatBarChartCellTextLayoutSummary = exports.getBarChartCellTextSlotPresence = exports.resolveBarChartCellTextSlots = exports.joinBarChartCellTextLabels = exports.hasBarChartCellTextLabels = exports.buildBarChartCellTextLabels = exports.toggleBarChartCellTextToken = exports.patchBarChartCellTextPlacement = exports.setBarChartCellTextPlacement = exports.mergeBarChartCellTextProperties = exports.getActiveBarChartCellTextTokens = exports.hasBarChartCellTextConfigured = exports.resolveBarChartCellTextLayout = void 0;
+exports.mountBarStyleCellText = exports.formatBarStyleCellTextLayoutSummary = exports.getBarStyleCellTextSlotPresence = exports.resolveBarStyleCellTextSlots = exports.joinBarStyleCellTextLabels = exports.hasBarStyleCellTextLabels = exports.buildBarStyleCellTextLabels = exports.toggleBarStyleCellTextToken = exports.patchBarStyleCellTextPlacement = exports.setBarStyleCellTextPlacement = exports.mergeBarStyleCellTextProperties = exports.getActiveBarStyleCellTextTokens = exports.hasBarStyleCellTextConfigured = exports.resolveBarStyleCellTextLayout = void 0;
 /** Default placement applied to a value whose Horizontal/Vertical were omitted. */
 const DEFAULT_PLACEMENT = {
     Horizontal: 'Left',
@@ -8,12 +8,13 @@ const DEFAULT_PLACEMENT = {
 };
 const HORIZONTAL_VALUES = ['Left', 'Center', 'Right'];
 const VERTICAL_VALUES = ['Above', 'Below', 'Merged'];
-const isHorizontal = (value) => typeof value === 'string' &&
-    HORIZONTAL_VALUES.includes(value);
+const isHorizontal = (value) => typeof value === 'string' && HORIZONTAL_VALUES.includes(value);
 const isVertical = (value) => typeof value === 'string' && VERTICAL_VALUES.includes(value);
 /** Normalise a placement, applying defaults for missing axes. */
 const sanitizePlacement = (placement) => ({
-    Horizontal: isHorizontal(placement?.Horizontal) ? placement.Horizontal : DEFAULT_PLACEMENT.Horizontal,
+    Horizontal: isHorizontal(placement?.Horizontal)
+        ? placement.Horizontal
+        : DEFAULT_PLACEMENT.Horizontal,
     Vertical: isVertical(placement?.Vertical) ? placement.Vertical : DEFAULT_PLACEMENT.Vertical,
 });
 /** Returns a layout with only the values that are actually present, defaults filled in. */
@@ -27,17 +28,17 @@ const sanitizeCellTextLayout = (layout) => {
     }
     return result;
 };
-const resolveBarChartCellTextLayout = (props) => sanitizeCellTextLayout(props?.CellTextLayout);
-exports.resolveBarChartCellTextLayout = resolveBarChartCellTextLayout;
+const resolveBarStyleCellTextLayout = (props) => sanitizeCellTextLayout(props?.CellTextLayout);
+exports.resolveBarStyleCellTextLayout = resolveBarStyleCellTextLayout;
 /** True when any value is configured for display. */
-const hasBarChartCellTextConfigured = (props) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(props);
+const hasBarStyleCellTextConfigured = (props) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(props);
     return Boolean(layout.CellValue || layout.PercentValue);
 };
-exports.hasBarChartCellTextConfigured = hasBarChartCellTextConfigured;
+exports.hasBarStyleCellTextConfigured = hasBarStyleCellTextConfigured;
 /** Set of value tokens that currently have a placement. */
-const getActiveBarChartCellTextTokens = (props) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(props);
+const getActiveBarStyleCellTextTokens = (props) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(props);
     const tokens = [];
     if (layout.CellValue) {
         tokens.push('CellValue');
@@ -47,8 +48,8 @@ const getActiveBarChartCellTextTokens = (props) => {
     }
     return tokens;
 };
-exports.getActiveBarChartCellTextTokens = getActiveBarChartCellTextTokens;
-const mergeBarChartCellTextProperties = (current, patch) => {
+exports.getActiveBarStyleCellTextTokens = getActiveBarStyleCellTextTokens;
+const mergeBarStyleCellTextProperties = (current, patch) => {
     const merged = { ...current, ...patch };
     if (merged.CellTextLayout) {
         merged.CellTextLayout = sanitizeCellTextLayout(merged.CellTextLayout);
@@ -61,12 +62,12 @@ const mergeBarChartCellTextProperties = (current, patch) => {
     }
     return merged;
 };
-exports.mergeBarChartCellTextProperties = mergeBarChartCellTextProperties;
+exports.mergeBarStyleCellTextProperties = mergeBarStyleCellTextProperties;
 /**
  * Set or clear a value's placement. Passing `placement: undefined` removes the value.
  */
-const setBarChartCellTextPlacement = (current, token, placement) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(current);
+const setBarStyleCellTextPlacement = (current, token, placement) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(current);
     const next = { ...layout };
     const key = token === 'CellValue' ? 'CellValue' : 'PercentValue';
     if (placement) {
@@ -75,46 +76,46 @@ const setBarChartCellTextPlacement = (current, token, placement) => {
     else {
         delete next[key];
     }
-    return (0, exports.mergeBarChartCellTextProperties)(current, { CellTextLayout: next });
+    return (0, exports.mergeBarStyleCellTextProperties)(current, { CellTextLayout: next });
 };
-exports.setBarChartCellTextPlacement = setBarChartCellTextPlacement;
+exports.setBarStyleCellTextPlacement = setBarStyleCellTextPlacement;
 /**
  * Patch a single axis of a value's placement (creating the value with defaults if
  * needed). Used by the wizard's placement pickers.
  */
-const patchBarChartCellTextPlacement = (current, token, patch) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(current);
+const patchBarStyleCellTextPlacement = (current, token, patch) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(current);
     const key = token === 'CellValue' ? 'CellValue' : 'PercentValue';
     const existing = layout[key];
     const nextPlacement = {
         ...(existing ?? DEFAULT_PLACEMENT),
         ...patch,
     };
-    return (0, exports.setBarChartCellTextPlacement)(current, token, nextPlacement);
+    return (0, exports.setBarStyleCellTextPlacement)(current, token, nextPlacement);
 };
-exports.patchBarChartCellTextPlacement = patchBarChartCellTextPlacement;
+exports.patchBarStyleCellTextPlacement = patchBarStyleCellTextPlacement;
 /**
  * Toggle whether a value is displayed. When turning on a previously-hidden
  * value we use the default placement (Left / Below).
  */
-const toggleBarChartCellTextToken = (current, token, show) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(current);
+const toggleBarStyleCellTextToken = (current, token, show) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(current);
     const key = token === 'CellValue' ? 'CellValue' : 'PercentValue';
     if (show && !layout[key]) {
         return {
-            CellTextProperties: (0, exports.setBarChartCellTextPlacement)(current, token, DEFAULT_PLACEMENT),
+            CellTextProperties: (0, exports.setBarStyleCellTextPlacement)(current, token, DEFAULT_PLACEMENT),
         };
     }
     if (!show && layout[key]) {
         return {
-            CellTextProperties: (0, exports.setBarChartCellTextPlacement)(current, token, undefined),
+            CellTextProperties: (0, exports.setBarStyleCellTextPlacement)(current, token, undefined),
         };
     }
     return { CellTextProperties: current };
 };
-exports.toggleBarChartCellTextToken = toggleBarChartCellTextToken;
-const buildBarChartCellTextLabels = (props, cellValueLabel, percentageLabel) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(props);
+exports.toggleBarStyleCellTextToken = toggleBarStyleCellTextToken;
+const buildBarStyleCellTextLabels = (props, cellValueLabel, percentageLabel) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(props);
     const labels = {};
     if (layout.CellValue && cellValueLabel != undefined) {
         labels.cellValue = cellValueLabel;
@@ -124,11 +125,11 @@ const buildBarChartCellTextLabels = (props, cellValueLabel, percentageLabel) =>
     }
     return labels;
 };
-exports.buildBarChartCellTextLabels = buildBarChartCellTextLabels;
-const hasBarChartCellTextLabels = (labels) => Boolean(labels.cellValue || labels.percentage);
-exports.hasBarChartCellTextLabels = hasBarChartCellTextLabels;
+exports.buildBarStyleCellTextLabels = buildBarStyleCellTextLabels;
+const hasBarStyleCellTextLabels = (labels) => Boolean(labels.cellValue || labels.percentage);
+exports.hasBarStyleCellTextLabels = hasBarStyleCellTextLabels;
 /** Join active labels with a space, Cell Value first then Percent Value. */
-const joinBarChartCellTextLabels = (labels) => {
+const joinBarStyleCellTextLabels = (labels) => {
     const parts = [];
     if (labels.cellValue)
         parts.push(labels.cellValue);
@@ -136,15 +137,15 @@ const joinBarChartCellTextLabels = (labels) => {
         parts.push(labels.percentage);
     return parts.join(' ');
 };
-exports.joinBarChartCellTextLabels = joinBarChartCellTextLabels;
+exports.joinBarStyleCellTextLabels = joinBarStyleCellTextLabels;
 /**
  * Resolve which placements are populated and what text goes in each cell of
  * the 3 × 3 grid. Empty slots are omitted. Two values landing on the same
  * (vertical, horizontal) slot are concatenated with a single space, Cell
  * Value before Percent Value.
  */
-const resolveBarChartCellTextSlots = (props, labels) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(props);
+const resolveBarStyleCellTextSlots = (props, labels) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(props);
     // Iteration order matters when both values share a slot: Cell Value first,
     // then Percent Value (matches the legacy "joined" behaviour).
     const candidates = [];
@@ -179,9 +180,9 @@ const resolveBarChartCellTextSlots = (props, labels) => {
     }
     return Array.from(slotMap.values());
 };
-exports.resolveBarChartCellTextSlots = resolveBarChartCellTextSlots;
-const getBarChartCellTextSlotPresence = (props) => {
-    const layout = (0, exports.resolveBarChartCellTextLayout)(props);
+exports.resolveBarStyleCellTextSlots = resolveBarStyleCellTextSlots;
+const getBarStyleCellTextSlotPresence = (props) => {
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(props);
     const verticals = new Set();
     if (layout.CellValue)
         verticals.add(sanitizePlacement(layout.CellValue).Vertical);
@@ -193,7 +194,7 @@ const getBarChartCellTextSlotPresence = (props) => {
         hasMerged: verticals.has('Merged'),
     };
 };
-exports.getBarChartCellTextSlotPresence = getBarChartCellTextSlotPresence;
+exports.getBarStyleCellTextSlotPresence = getBarStyleCellTextSlotPresence;
 // ---------------------------------------------------------------------------
 // Summary formatting
 // ---------------------------------------------------------------------------
@@ -212,7 +213,7 @@ const formatPlacementSummary = (placement) => {
     const { Horizontal, Vertical } = sanitizePlacement(placement);
     return `${VERTICAL_LABEL[Vertical]}-${HORIZONTAL_LABEL[Horizontal]}`;
 };
-const formatBarChartCellTextLayoutSummary = (layout) => {
+const formatBarStyleCellTextLayoutSummary = (layout) => {
     const parts = [];
     if (layout.CellValue) {
         parts.push(`${formatTokenLabel('CellValue')}: ${formatPlacementSummary(layout.CellValue)}`);
@@ -222,7 +223,7 @@ const formatBarChartCellTextLayoutSummary = (layout) => {
     }
     return parts.length ? parts.join('; ') : undefined;
 };
-exports.formatBarChartCellTextLayoutSummary = formatBarChartCellTextLayoutSummary;
+exports.formatBarStyleCellTextLayoutSummary = formatBarStyleCellTextLayoutSummary;
 // ---------------------------------------------------------------------------
 // DOM mount
 // ---------------------------------------------------------------------------
@@ -282,12 +283,12 @@ const createCellTextRow = (slots, textClassName, compact) => {
     }
     return row;
 };
-const mountBarChartCellText = (args) => {
+const mountBarStyleCellText = (args) => {
     const { cellTextProperties, labels, wrapperEl, textClassName } = args;
-    if (!(0, exports.hasBarChartCellTextConfigured)(cellTextProperties) || !(0, exports.hasBarChartCellTextLabels)(labels)) {
+    if (!(0, exports.hasBarStyleCellTextConfigured)(cellTextProperties) || !(0, exports.hasBarStyleCellTextLabels)(labels)) {
         return;
     }
-    const slots = (0, exports.resolveBarChartCellTextSlots)(cellTextProperties, labels);
+    const slots = (0, exports.resolveBarStyleCellTextSlots)(cellTextProperties, labels);
     if (!slots.length) {
         return;
     }
@@ -302,7 +303,7 @@ const mountBarChartCellText = (args) => {
     // (i.e. the two tokens claim two separate bands of vertical space). When
     // they share a vertical band — or when only one token is configured —
     // we have room for the full-size font.
-    const layout = (0, exports.resolveBarChartCellTextLayout)(cellTextProperties);
+    const layout = (0, exports.resolveBarStyleCellTextLayout)(cellTextProperties);
     const compact = Boolean(layout.CellValue &&
         layout.PercentValue &&
         sanitizePlacement(layout.CellValue).Vertical !==
@@ -330,4 +331,4 @@ const mountBarChartCellText = (args) => {
         mergedOverlayEl.append(row);
     }
 };
-exports.mountBarChartCellText = mountBarChartCellText;
+exports.mountBarStyleCellText = mountBarStyleCellText;

package/src/Utilities/Helpers/{StyledColumnGradientHelper.d.ts → StyledColumns/GradientStyleHelper.d.ts}

@@ -1,9 +1,9 @@
 import type { CSSProperties } from 'react';
 import type { IRowNode } from 'ag-grid-community';
-import { StyledColumn } from '../../AdaptableState/StyledColumnState';
-import { CellColorRange, NumericStyledColumn } from '../../AdaptableState/StyledColumns/Common/NumericStyledColumn';
-import { GradientStyle } from '../../AdaptableState/StyledColumns/GradientStyle';
-import { AdaptableApi } from '../../Api/AdaptableApi';
+import { StyledColumn } from '../../../AdaptableState/StyledColumnState';
+import { CellColorRange, NumericStyledColumn } from '../../../AdaptableState/StyledColumns/Common/NumericStyledColumn';
+import { GradientStyle } from '../../../AdaptableState/StyledColumns/GradientStyle';
+import { AdaptableApi } from '../../../Api/AdaptableApi';
 /**
  * Default alpha at the **low** end of a Gradient range when `MinAlpha` is unset.
  * Slightly above zero so the bottom-edge value of every range still shows its

package/src/Utilities/Helpers/{StyledColumnGradientHelper.js → StyledColumns/GradientStyleHelper.js}

@@ -8,9 +8,9 @@ exports.gradientStyleRangeLookupValueType = gradientStyleRangeLookupValueType;
 exports.isNegativeZeroCentredBand = isNegativeZeroCentredBand;
 const tslib_1 = require("tslib");
 const tinycolor2_1 = tslib_1.__importDefault(require("tinycolor2"));
-const StyleHelper_1 = require("./StyleHelper");
-const StyleHelper_2 = require("./StyleHelper");
-const clamp_1 = tslib_1.__importDefault(require("../utils/clamp"));
+const StyleHelper_1 = require("../StyleHelper");
+const StyleHelper_2 = require("../StyleHelper");
+const NumberExtensions_1 = require("../../Extensions/NumberExtensions");
 /**
  * Default alpha at the **low** end of a Gradient range when `MinAlpha` is unset.
  * Slightly above zero so the bottom-edge value of every range still shows its
@@ -131,11 +131,11 @@ const getZeroCentredGradientPreviewCellStyle = (cellValue, gradientStyle) => {
     const reverseGradient = matchingRange.Min === previewMin && matchingRange.Max === 0;
     const minAlphaBound = gradientStyle.MinAlpha ?? exports.DEFAULT_GRADIENT_MIN_ALPHA;
     const maxAlphaBound = gradientStyle.MaxAlpha ?? exports.DEFAULT_GRADIENT_MAX_ALPHA;
-    const lo = Math.min((0, clamp_1.default)(minAlphaBound, 0, 1), (0, clamp_1.default)(maxAlphaBound, 0, 1));
-    const hi = Math.max((0, clamp_1.default)(minAlphaBound, 0, 1), (0, clamp_1.default)(maxAlphaBound, 0, 1));
+    const lo = Math.min((0, NumberExtensions_1.clamp)(minAlphaBound, 0, 1), (0, NumberExtensions_1.clamp)(maxAlphaBound, 0, 1));
+    const hi = Math.max((0, NumberExtensions_1.clamp)(minAlphaBound, 0, 1), (0, NumberExtensions_1.clamp)(maxAlphaBound, 0, 1));
     const span = Math.abs(max - min);
     let t = span === 0 ? 0.5 : (Number(cellValue) - min) / span;
-    t = (0, clamp_1.default)(t, 0, 1);
+    t = (0, NumberExtensions_1.clamp)(t, 0, 1);
     if (reverseGradient) {
         t = 1 - t;
     }
@@ -197,11 +197,11 @@ const getGradientPreviewCellStyle = (cellValue, styledColumn, api, rowNode) => {
     }
     const minAlphaBound = gradientStyle.MinAlpha ?? exports.DEFAULT_GRADIENT_MIN_ALPHA;
     const maxAlphaBound = gradientStyle.MaxAlpha ?? exports.DEFAULT_GRADIENT_MAX_ALPHA;
-    const lo = Math.min((0, clamp_1.default)(minAlphaBound, 0, 1), (0, clamp_1.default)(maxAlphaBound, 0, 1));
-    const hi = Math.max((0, clamp_1.default)(minAlphaBound, 0, 1), (0, clamp_1.default)(maxAlphaBound, 0, 1));
+    const lo = Math.min((0, NumberExtensions_1.clamp)(minAlphaBound, 0, 1), (0, NumberExtensions_1.clamp)(maxAlphaBound, 0, 1));
+    const hi = Math.max((0, NumberExtensions_1.clamp)(minAlphaBound, 0, 1), (0, NumberExtensions_1.clamp)(maxAlphaBound, 0, 1));
     const span = Math.abs(max - min);
     let t = span === 0 ? 0.5 : (Number(cellValue) - min) / span;
-    t = (0, clamp_1.default)(t, 0, 1);
+    t = (0, NumberExtensions_1.clamp)(t, 0, 1);
     if (reverseGradient) {
         t = 1 - t;
     }

package/src/Utilities/Helpers/{IconStylePresets.d.ts → StyledColumns/IconStyleHelper.d.ts}

@@ -1,4 +1,9 @@
-import { IconStyleBuiltInPreset, IconStyleMapping } from '../../AdaptableState/StyledColumns/IconStyle';
+import { IconStyleBuiltInPreset, IconStyleMapping } from '../../../AdaptableState/StyledColumns/IconStyle';
+/**
+ * Icon Column Style resolves one key → glyph per scalar cell value; AdapTable
+ * array column types are not supported (use Badge Style for per-element visuals).
+ */
+export declare function isUnsupportedColumnDataTypeForIconStyle(dataType?: string): boolean;
 export declare const ICON_STYLE_PRESETS: Record<IconStyleBuiltInPreset, IconStyleMapping[]>;
 /** Returns a fresh copy of the mappings for a given preset. */
 export declare const getIconStylePresetMappings: (preset: IconStyleBuiltInPreset) => IconStyleMapping[];

package/src/Utilities/Helpers/{IconStylePresets.js → StyledColumns/IconStyleHelper.js}

@@ -1,6 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ICON_STYLE_PRESET_DESCRIPTIONS = exports.ICON_STYLE_PRESET_LABELS = exports.getIconStylePresetMappings = exports.ICON_STYLE_PRESETS = void 0;
+exports.isUnsupportedColumnDataTypeForIconStyle = isUnsupportedColumnDataTypeForIconStyle;
+/**
+ * Icon Column Style resolves one key → glyph per scalar cell value; AdapTable
+ * array column types are not supported (use Badge Style for per-element visuals).
+ */
+function isUnsupportedColumnDataTypeForIconStyle(dataType) {
+    switch (dataType) {
+        case 'textArray':
+        case 'numberArray':
+        case 'tupleArray':
+        case 'objectArray':
+            return true;
+        default:
+            return false;
+    }
+}
 /**
  * Built-in {@link IconStyle} mapping presets.
  *

package/src/Utilities/Helpers/{percentBarPreviewHelper.d.ts → StyledColumns/PercentBarStyleHelper.d.ts}

@@ -1,5 +1,5 @@
-import { StyledColumn } from '../../AdaptableState/StyledColumnState';
-import { PercentBarStyle } from '../../AdaptableState/StyledColumns/PercentBarStyle';
+import { StyledColumn } from '../../../AdaptableState/StyledColumnState';
+import { PercentBarStyle } from '../../../AdaptableState/StyledColumns/PercentBarStyle';
 export declare const hasPercentBarRangesConfigured: (pb: PercentBarStyle | undefined) => boolean;
 /** Illustrative scale for preview — shows negatives when origin is Auto or Zero. */
 export declare const getPercentBarPreviewScale: (pb: PercentBarStyle) => {

package/src/Utilities/Helpers/{percentBarPreviewHelper.js → StyledColumns/PercentBarStyleHelper.js}

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasPercentBarStylePreview = exports.getPercentBarPreviewResolvedBarColor = exports.getPercentBarPreviewTrackColor = exports.formatPercentBarPreviewCellText = exports.getPercentBarPreviewGeometry = exports.getPercentBarPreviewSampleValues = exports.getPercentBarPreviewScale = exports.hasPercentBarRangesConfigured = void 0;
-const tslib_1 = require("tslib");
-const StyleHelper_1 = require("./StyleHelper");
-const clamp_1 = tslib_1.__importDefault(require("../utils/clamp"));
-const StyledColumnGradientHelper_1 = require("./StyledColumnGradientHelper");
-const barChartCellText_1 = require("./barChartCellText");
+const StyleHelper_1 = require("../StyleHelper");
+const NumberExtensions_1 = require("../../Extensions/NumberExtensions");
+const GradientStyleHelper_1 = require("./GradientStyleHelper");
+const BarStylesHelper_1 = require("./BarStylesHelper");
 const evenlySpacedValues = (min, max, count) => {
     if (count <= 1) {
         return [min];
@@ -17,7 +16,7 @@ const toFraction = (value, min, max) => {
     if (max === min) {
         return 0;
     }
-    return (0, clamp_1.default)((value - min) / (max - min), 0, 1);
+    return (0, NumberExtensions_1.clamp)((value - min) / (max - min), 0, 1);
 };
 const resolveOrigin = (percentBarStyle, cellValue, min, max) => {
     const origin = percentBarStyle.Origin ?? 'Auto';
@@ -73,14 +72,14 @@ exports.hasPercentBarRangesConfigured = hasPercentBarRangesConfigured;
 const getPercentBarPreviewScale = (pb) => {
     const origin = pb.Origin ?? 'Auto';
     if (origin === 'Zero' || origin === 'Auto') {
-        return { min: StyledColumnGradientHelper_1.ZERO_CENTRED_PREVIEW_SCALE_MIN, max: StyledColumnGradientHelper_1.ZERO_CENTRED_PREVIEW_SCALE_MAX };
+        return { min: GradientStyleHelper_1.ZERO_CENTRED_PREVIEW_SCALE_MIN, max: GradientStyleHelper_1.ZERO_CENTRED_PREVIEW_SCALE_MAX };
     }
     return { min: 0, max: 100 };
 };
 exports.getPercentBarPreviewScale = getPercentBarPreviewScale;
 const getPercentBarPreviewSampleValues = (pb) => {
     const { min, max } = (0, exports.getPercentBarPreviewScale)(pb);
-    return evenlySpacedValues(min, max, StyledColumnGradientHelper_1.STYLED_COLUMN_PREVIEW_SAMPLE_COUNT);
+    return evenlySpacedValues(min, max, GradientStyleHelper_1.STYLED_COLUMN_PREVIEW_SAMPLE_COUNT);
 };
 exports.getPercentBarPreviewSampleValues = getPercentBarPreviewSampleValues;
 const getPercentBarPreviewGeometry = (numericValue, pb, min, max) => {
@@ -115,7 +114,7 @@ const getPercentBarPreviewGeometry = (numericValue, pb, min, max) => {
         barWidthPercent = 0;
     }
     else {
-        percentageValue = (((0, clamp_1.default)(numericValue, min, max) - min) / (max - min)) * 100;
+        percentageValue = (((0, NumberExtensions_1.clamp)(numericValue, min, max) - min) / (max - min)) * 100;
         const origin = resolveOrigin(pb, numericValue, min, max);
         const valueFrac = toFraction(numericValue, min, max);
         const originFrac = toFraction(origin, min, max);
@@ -133,8 +132,8 @@ const getPercentBarPreviewGeometry = (numericValue, pb, min, max) => {
 };
 exports.getPercentBarPreviewGeometry = getPercentBarPreviewGeometry;
 const formatPercentBarPreviewCellText = (numericValue, percentageValue, pb) => {
-    const labels = (0, barChartCellText_1.buildBarChartCellTextLabels)(pb.CellTextProperties, Number.isInteger(numericValue) ? String(numericValue) : numericValue.toFixed(1), `${percentageValue.toFixed(0)}%`);
-    return (0, barChartCellText_1.joinBarChartCellTextLabels)(labels);
+    const labels = (0, BarStylesHelper_1.buildBarStyleCellTextLabels)(pb.CellTextProperties, Number.isInteger(numericValue) ? String(numericValue) : numericValue.toFixed(1), `${percentageValue.toFixed(0)}%`);
+    return (0, BarStylesHelper_1.joinBarStyleCellTextLabels)(labels);
 };
 exports.formatPercentBarPreviewCellText = formatPercentBarPreviewCellText;
 const getPercentBarPreviewTrackColor = (pb) => {
@@ -144,7 +143,7 @@ const getPercentBarPreviewTrackColor = (pb) => {
     return pb.BackColor ?? undefined;
 };
 exports.getPercentBarPreviewTrackColor = getPercentBarPreviewTrackColor;
-const getPercentBarPreviewResolvedBarColor = (color) => color ? (0, StyleHelper_1.getVariableColor)(color) : undefined;
+const getPercentBarPreviewResolvedBarColor = (color) => (color ? (0, StyleHelper_1.getVariableColor)(color) : undefined);
 exports.getPercentBarPreviewResolvedBarColor = getPercentBarPreviewResolvedBarColor;
 const hasPercentBarStylePreview = (styledColumn) => (0, exports.hasPercentBarRangesConfigured)(styledColumn.PercentBarStyle);
 exports.hasPercentBarStylePreview = hasPercentBarStylePreview;

package/src/Utilities/Helpers/{SparklineOptionsHelper.js → StyledColumns/SparklineStyleHelper.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveSparklineOptionsForRender = resolveSparklineOptionsForRender;
-const StyleHelper_1 = require("./StyleHelper");
+const StyleHelper_1 = require("../StyleHelper");
 const resolveCssColor = (color) => {
     if (color == null || color === '') {
         return color;

package/src/Utilities/Helpers/StyledColumns/StyledColumnHelper.d.ts

@@ -0,0 +1,52 @@
+import type { IRowNode } from 'ag-grid-enterprise';
+import type { AdaptableApi } from '../../../Api/AdaptableApi';
+import type { StyledColumn } from '../../../AdaptableState/StyledColumnState';
+import type { RowScope } from '../../../AdaptableState/Common/RowScope';
+/**
+ * Row kinds used by {@link RowScope} and the Styled Column Scope wizard.
+ * All are available to all Styled Columns with exception of Sparkline (which is data rows only)
+ */
+export type StyledColumnRowKind = 'Data' | 'Group' | 'Summary' | 'Total';
+export declare const STYLED_COLUMN_ROW_KINDS: StyledColumnRowKind[];
+export declare const STYLED_COLUMN_ROW_KIND_EXCLUDE_KEY: Record<StyledColumnRowKind, keyof RowScope>;
+export declare const isStyledColumnRowKindSupported: (styledColumn: StyledColumn, kind: StyledColumnRowKind) => boolean;
+export declare const getStyledColumnRowKindDisabledReason: (styledColumn: StyledColumn, kind: StyledColumnRowKind) => string | undefined;
+/**
+ * Classifies the AG Grid row node into a single {@link StyledColumnRowKind}.
+ * Order matches {@link shouldRenderStyledColumnOnRow}: total before summary,
+ * summary before group.
+ */
+export declare const getStyledColumnRowKindForNode: (node: IRowNode, api: AdaptableApi) => StyledColumnRowKind;
+/**
+ * Forces `Exclude*` to `true` for row kinds that do not apply to the current
+ * Styled Column type, so persisted state cannot contradict the capability
+ * matrix. Returns `undefined` when no change is needed.
+ */
+export declare const sanitizeStyledColumnRowScope: (styledColumn: StyledColumn) => RowScope | undefined;
+/**
+ * Returns `true` when the Styled Column should render on the given row.
+ *
+ * Single source of truth consulted by every styled-column cell renderer
+ * (Badge / Icon / Rating / Percent Bar / Bullet Chart / Range Bar) and
+ * by `getStyledColumnStyle` (Gradient / Percent Bar cellStyle).
+ *
+ * Semantics:
+ *  - **Type capabilities** first: some types never target certain row kinds
+ *    (see {@link isStyledColumnRowKindSupported}). Unsupported kinds always
+ *    return `false` regardless of `RowScope`.
+ *  - When `StyledColumn.RowScope` is **set**, the explicit `Exclude*`
+ *    flags win. Unset flags default to "include" — i.e. `RowScope: {}`
+ *    means "render on every *supported* row kind".
+ *  - When `StyledColumn.RowScope` is **unset**, the historical per-type
+ *    default applies:
+ *      - Badge: render on every row kind (that the type supports).
+ *      - All other types: render on every row kind *except* group rows
+ *        (matches the hardcoded "isGroupRowNode → plain text" check that
+ *        every other styled-column renderer used to carry), again
+ *        intersected with type capabilities (e.g. Sparkline → data only).
+ *
+ * The per-type default lets us promote `RowScope` cleanly without
+ * altering existing user-visible behaviour: state that doesn't mention
+ * `RowScope` keeps rendering exactly as before.
+ */
+export declare const shouldRenderStyledColumnOnRow: (styledColumn: StyledColumn, node: IRowNode, api: AdaptableApi) => boolean;