@gooddata/sdk-ui-kit 11.13.0-alpha.1 → 11.13.0-alpha.2

package/esm/measureNumberFormat/hooks/useCurrencyFormatDefaults.d.ts

@@ -0,0 +1,21 @@
+import type { MetricType } from "@gooddata/sdk-model";
+/** @internal */
+export interface UseCurrencyFormatDefaultsConfig {
+    metricType?: MetricType;
+    normalizedFormat: string | null;
+    currencyFormatOverride?: string | null;
+    presetFormats: string[];
+    hasInheritPreset: boolean;
+    onFormatChange: (format: string | null) => void;
+    shouldBootstrap: boolean;
+    fallbackFormat?: string;
+}
+/**
+ * @internal
+ *
+ * Ensures that currency metrics default to a meaningful preset instead of falling back to custom formats.
+ * - When no format is set yet, it applies the inherited override or the standard currency preset.
+ * - When switching to currency with an incompatible format, it coerces the format to a supported preset.
+ */
+export declare function useCurrencyFormatDefaults({ metricType, normalizedFormat, currencyFormatOverride, presetFormats, hasInheritPreset, onFormatChange, shouldBootstrap, fallbackFormat, }: UseCurrencyFormatDefaultsConfig): void;
+//# sourceMappingURL=useCurrencyFormatDefaults.d.ts.map

package/esm/measureNumberFormat/hooks/useCurrencyFormatDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrencyFormatDefaults.d.ts","sourceRoot":"","sources":["../../../src/measureNumberFormat/hooks/useCurrencyFormatDefaults.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,gBAAgB;AAChB,MAAM,WAAW,+BAA+B;IAC5C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EACtC,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAwC,GAC3C,EAAE,+BAA+B,QAkCjC"}

package/esm/measureNumberFormat/hooks/useCurrencyFormatDefaults.js

@@ -0,0 +1,49 @@
+// (C) 2025 GoodData Corporation
+import { useEffect, useRef } from "react";
+const DEFAULT_CURRENCY_FORMAT = "$#,##0.00";
+/**
+ * @internal
+ *
+ * Ensures that currency metrics default to a meaningful preset instead of falling back to custom formats.
+ * - When no format is set yet, it applies the inherited override or the standard currency preset.
+ * - When switching to currency with an incompatible format, it coerces the format to a supported preset.
+ */
+export function useCurrencyFormatDefaults({ metricType, normalizedFormat, currencyFormatOverride, presetFormats, hasInheritPreset, onFormatChange, shouldBootstrap, fallbackFormat = DEFAULT_CURRENCY_FORMAT, }) {
+    const previousMetricType = usePreviousMetricType(metricType);
+    useEffect(() => {
+        if (metricType !== "CURRENCY" || !shouldBootstrap) {
+            return;
+        }
+        onFormatChange(resolveDefaultFormat(currencyFormatOverride, fallbackFormat));
+    }, [currencyFormatOverride, fallbackFormat, metricType, onFormatChange, shouldBootstrap]);
+    useEffect(() => {
+        if (metricType !== "CURRENCY" || previousMetricType === "CURRENCY") {
+            return;
+        }
+        const matchesCurrencyPreset = normalizedFormat === null ? hasInheritPreset : presetFormats.includes(normalizedFormat);
+        if (matchesCurrencyPreset) {
+            return;
+        }
+        onFormatChange(resolveDefaultFormat(currencyFormatOverride, fallbackFormat));
+    }, [
+        currencyFormatOverride,
+        fallbackFormat,
+        hasInheritPreset,
+        metricType,
+        normalizedFormat,
+        onFormatChange,
+        presetFormats,
+        previousMetricType,
+    ]);
+}
+function resolveDefaultFormat(currencyFormatOverride, fallbackFormat) {
+    return currencyFormatOverride ? null : fallbackFormat;
+}
+function usePreviousMetricType(metricType) {
+    const ref = useRef(undefined);
+    useEffect(() => {
+        ref.current = metricType;
+    }, [metricType]);
+    return ref.current;
+}
+//# sourceMappingURL=useCurrencyFormatDefaults.js.map

package/esm/measureNumberFormat/hooks/useCurrencyFormatDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrencyFormatDefaults.js","sourceRoot":"","sources":["../../../src/measureNumberFormat/hooks/useCurrencyFormatDefaults.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAI1C,MAAM,uBAAuB,GAAG,WAAW,CAAC;AAc5C;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,EACtC,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,GAAG,uBAAuB,GACV;IAC9B,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAE7D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,UAAU,KAAK,UAAU,IAAI,CAAC,eAAe,EAAE,CAAC;YAChD,OAAO;QACX,CAAC;QAED,cAAc,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC,CAAC;IACjF,CAAC,EAAE,CAAC,sBAAsB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IAE1F,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,UAAU,KAAK,UAAU,IAAI,kBAAkB,KAAK,UAAU,EAAE,CAAC;YACjE,OAAO;QACX,CAAC;QAED,MAAM,qBAAqB,GACvB,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAE5F,IAAI,qBAAqB,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,cAAc,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC,CAAC;IACjF,CAAC,EAAE;QACC,sBAAsB;QACtB,cAAc;QACd,gBAAgB;QAChB,UAAU;QACV,gBAAgB;QAChB,cAAc;QACd,aAAa;QACb,kBAAkB;KACrB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,oBAAoB,CAAC,sBAAiD,EAAE,cAAsB;IACnG,OAAO,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC;AAC1D,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAkC;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAyB,SAAS,CAAC,CAAC;IACtD,SAAS,CAAC,GAAG,EAAE;QACX,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC;IAC7B,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC,OAAO,CAAC;AACvB,CAAC"}

package/esm/measureNumberFormat/index.d.ts

@@ -1,4 +1,8 @@
 export * from "./typings.js";
 export type { IMeasureNumberFormatOwnProps } from "./MeasureNumberFormat.js";
 export { MeasureNumberFormat } from "./MeasureNumberFormat.js";
+export { validateCurrencyFormat, isCurrencyFormat, type CurrencyFormatValidationErrorCode, type ICurrencyFormatValidationError, type ICurrencyFormatValidationOptions, type ICurrencyFormatValidationResult, } from "./validation/currencyFormatValidator.js";
+export { useCurrencyFormatDefaults } from "./hooks/useCurrencyFormatDefaults.js";
+export type { UseCurrencyFormatDefaultsConfig } from "./hooks/useCurrencyFormatDefaults.js";
+export { createCurrencyPresets, CURRENCY_PRESET_DEFINITIONS, type ICurrencyPresetDefinition, } from "./presets/currencyPresets.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/measureNumberFormat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/measureNumberFormat/index.ts"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/measureNumberFormat/index.ts"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACH,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,iCAAiC,EACtC,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,GACvC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,YAAY,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,EACH,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,yBAAyB,GACjC,MAAM,8BAA8B,CAAC"}

package/esm/measureNumberFormat/index.js

@@ -1,4 +1,7 @@
-// (C) 2020-2024 GoodData Corporation
+// (C) 2020-2025 GoodData Corporation
 export * from "./typings.js";
 export { MeasureNumberFormat } from "./MeasureNumberFormat.js";
+export { validateCurrencyFormat, isCurrencyFormat, } from "./validation/currencyFormatValidator.js";
+export { useCurrencyFormatDefaults } from "./hooks/useCurrencyFormatDefaults.js";
+export { createCurrencyPresets, CURRENCY_PRESET_DEFINITIONS, } from "./presets/currencyPresets.js";
 //# sourceMappingURL=index.js.map

package/esm/measureNumberFormat/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/measureNumberFormat/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/measureNumberFormat/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACH,sBAAsB,EACtB,gBAAgB,GAKnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EACH,qBAAqB,EACrB,2BAA2B,GAE9B,MAAM,8BAA8B,CAAC"}

package/esm/measureNumberFormat/presets/currencyPresets.d.ts

@@ -0,0 +1,28 @@
+import { type IFormatPreset } from "../typings.js";
+/**
+ * Base currency preset definitions without localized names.
+ * @internal
+ */
+export interface ICurrencyPresetDefinition {
+    localIdentifier: string;
+    format: string;
+    previewNumber: number;
+    messageId: string;
+}
+/**
+ * Base currency preset definitions.
+ * These are the raw preset data that can be used to create localized presets.
+ * @internal
+ */
+export declare const CURRENCY_PRESET_DEFINITIONS: readonly ICurrencyPresetDefinition[];
+/**
+ * Creates localized currency format presets.
+ *
+ * @param formatMessage - Function to format localized messages (e.g., from react-intl)
+ * @returns Array of currency format presets with localized names
+ * @internal
+ */
+export declare function createCurrencyPresets(formatMessage: (descriptor: {
+    id: string;
+}) => string): IFormatPreset[];
+//# sourceMappingURL=currencyPresets.d.ts.map

package/esm/measureNumberFormat/presets/currencyPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencyPresets.d.ts","sourceRoot":"","sources":["../../../src/measureNumberFormat/presets/currencyPresets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,yBAAyB,EAmBlE,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,CAAC,UAAU,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,GACtD,aAAa,EAAE,CAOjB"}

package/esm/measureNumberFormat/presets/currencyPresets.js

@@ -0,0 +1,42 @@
+// (C) 2025 GoodData Corporation
+/**
+ * Base currency preset definitions.
+ * These are the raw preset data that can be used to create localized presets.
+ * @internal
+ */
+export const CURRENCY_PRESET_DEFINITIONS = [
+    {
+        localIdentifier: "currency",
+        format: "$#,##0.00",
+        previewNumber: 1000.12,
+        messageId: "metricComponent.numberFormat.preset.currency",
+    },
+    {
+        localIdentifier: "currency-single-decimal",
+        format: "$#,##0.0",
+        previewNumber: 1000.12,
+        messageId: "metricComponent.numberFormat.preset.currency1",
+    },
+    {
+        localIdentifier: "currency-rounded",
+        format: "$#,##0",
+        previewNumber: 1000.12,
+        messageId: "metricComponent.numberFormat.preset.currencyRounded",
+    },
+];
+/**
+ * Creates localized currency format presets.
+ *
+ * @param formatMessage - Function to format localized messages (e.g., from react-intl)
+ * @returns Array of currency format presets with localized names
+ * @internal
+ */
+export function createCurrencyPresets(formatMessage) {
+    return CURRENCY_PRESET_DEFINITIONS.map((definition) => ({
+        name: formatMessage({ id: definition.messageId }),
+        localIdentifier: definition.localIdentifier,
+        format: definition.format,
+        previewNumber: definition.previewNumber,
+    }));
+}
+//# sourceMappingURL=currencyPresets.js.map

package/esm/measureNumberFormat/presets/currencyPresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencyPresets.js","sourceRoot":"","sources":["../../../src/measureNumberFormat/presets/currencyPresets.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAehC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAyC;IAC7E;QACI,eAAe,EAAE,UAAU;QAC3B,MAAM,EAAE,WAAW;QACnB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,8CAA8C;KAC5D;IACD;QACI,eAAe,EAAE,yBAAyB;QAC1C,MAAM,EAAE,UAAU;QAClB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,+CAA+C;KAC7D;IACD;QACI,eAAe,EAAE,kBAAkB;QACnC,MAAM,EAAE,QAAQ;QAChB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,qDAAqD;KACnE;CACK,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACjC,aAAqD;IAErD,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC;QACjD,eAAe,EAAE,UAAU,CAAC,eAAe;QAC3C,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,aAAa,EAAE,UAAU,CAAC,aAAa;KAC1C,CAAC,CAAC,CAAC;AACR,CAAC"}

package/esm/measureNumberFormat/validation/currencyFormatValidator.d.ts

@@ -0,0 +1,55 @@
+import { type ISeparators } from "@gooddata/number-formatter";
+/**
+ * @alpha
+ */
+export type CurrencyFormatValidationErrorCode = "empty" | "invalidFormat" | "missingCurrencySymbol" | "missingDecimalPlaces";
+/**
+ * @alpha
+ */
+export interface ICurrencyFormatValidationError {
+    code: CurrencyFormatValidationErrorCode;
+    /**
+     * Indexes of sections (0-based) that failed validation.
+     * The value is only present for section-driven validations.
+     */
+    sectionIndexes?: number[];
+    message: string;
+}
+/**
+ * @alpha
+ */
+export interface ICurrencyFormatValidationResult {
+    isValid: boolean;
+    errors: ICurrencyFormatValidationError[];
+}
+/**
+ * @alpha
+ */
+export interface ICurrencyFormatValidationOptions {
+    /**
+     * Sample value used to verify the formatter does not throw.
+     * Defaults to 12345.67 to cover both thousands and decimals.
+     */
+    sampleValue?: number;
+    /**
+     * Number of mandatory decimal places each section must contain.
+     * Set to 0 (or a negative value) to skip the decimal check.
+     * Defaults to 2.
+     */
+    requiredDecimalPlaces?: number;
+    separators?: ISeparators;
+}
+/**
+ * Validates a number format string that is expected to represent a currency amount.
+ *
+ * @alpha
+ */
+export declare function validateCurrencyFormat(format: string | undefined | null, options?: ICurrencyFormatValidationOptions): ICurrencyFormatValidationResult;
+/**
+ * Checks if a format string represents a currency format.
+ * A currency format is one where at least one numeric section contains a currency symbol.
+ *
+ * @alpha
+ */
+export declare function isCurrencyFormat(format: string | undefined | null): boolean;
+//# sourceMappingURL=currencyFormatValidator.d.ts.map

package/esm/measureNumberFormat/validation/currencyFormatValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencyFormatValidator.d.ts","sourceRoot":"","sources":["../../../src/measureNumberFormat/validation/currencyFormatValidator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAWrF;;GAEG;AACH,MAAM,MAAM,iCAAiC,GACvC,OAAO,GACP,eAAe,GACf,uBAAuB,GACvB,sBAAsB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC3C,IAAI,EAAE,iCAAiC,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,8BAA8B,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,WAAW,CAAC;CAC5B;AASD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACjC,OAAO,GAAE,gCAAqC,GAC/C,+BAA+B,CAsDjC;AAgED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAc3E"}

package/esm/measureNumberFormat/validation/currencyFormatValidator.js

@@ -0,0 +1,118 @@
+// (C) 2025 GoodData Corporation
+import { ClientFormatterFacade } from "@gooddata/number-formatter";
+const DEFAULT_SAMPLE_VALUE = 12345.67;
+const DEFAULT_REQUIRED_DECIMALS = 2;
+const SECTION_SEPARATOR = ";";
+const NUMBER_PLACEHOLDER_PATTERN = /[0#?]/;
+const DECIMAL_TOKEN_PATTERN = /\.(0+)/;
+const CURRENCY_SYMBOL_PATTERN = /\p{Sc}/u;
+const CURRENCY_BRACKET_PATTERN = /\[\$[^\]]+\]/;
+const QUOTED_CURRENCY_PATTERN = /(["'])[ \t]*[A-Za-z]{2,6}[ \t]*\1/;
+const DEFAULT_ERROR_MESSAGES = {
+    empty: "Format is required.",
+    invalidFormat: "Format contains invalid tokens.",
+    missingCurrencySymbol: "Currency symbol is missing.",
+    missingDecimalPlaces: "Format must include the required decimal places.",
+};
+/**
+ * Validates a number format string that is expected to represent a currency amount.
+ *
+ * @alpha
+ */
+export function validateCurrencyFormat(format, options = {}) {
+    const sanitizedFormat = format?.trim() ?? "";
+    const errors = [];
+    if (!sanitizedFormat) {
+        errors.push(buildError("empty"));
+        return { isValid: false, errors };
+    }
+    const sampleValue = options.sampleValue ?? DEFAULT_SAMPLE_VALUE;
+    const separators = options.separators;
+    if (!isParsableFormat(sanitizedFormat, sampleValue, separators)) {
+        errors.push(buildError("invalidFormat"));
+        return { isValid: false, errors };
+    }
+    const sections = getFormatSections(sanitizedFormat);
+    const sectionsWithNumbers = sections.filter(hasNumericPlaceholder);
+    if (sectionsWithNumbers.length === 0) {
+        errors.push(buildError("invalidFormat"));
+        return { isValid: false, errors };
+    }
+    if (!sectionsWithNumbers.every(hasCurrencyToken)) {
+        errors.push(buildError("missingCurrencySymbol", collectInvalidSections(sectionsWithNumbers, hasCurrencyToken)));
+    }
+    const requiredDecimals = options.requiredDecimalPlaces ?? DEFAULT_REQUIRED_DECIMALS;
+    if (requiredDecimals > 0 &&
+        !sectionsWithNumbers.every((section) => hasRequiredDecimals(section, requiredDecimals))) {
+        errors.push(buildError("missingDecimalPlaces", collectInvalidSections(sectionsWithNumbers, (section) => hasRequiredDecimals(section, requiredDecimals))));
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+function buildError(code, sectionIndexes) {
+    return {
+        code,
+        sectionIndexes,
+        message: DEFAULT_ERROR_MESSAGES[code],
+    };
+}
+function getFormatSections(format) {
+    return format
+        .split(SECTION_SEPARATOR)
+        .map((section) => section.trim())
+        .filter((section) => section.length > 0);
+}
+function hasNumericPlaceholder(section) {
+    return NUMBER_PLACEHOLDER_PATTERN.test(section);
+}
+function hasCurrencyToken(section) {
+    return (CURRENCY_BRACKET_PATTERN.test(section) ||
+        CURRENCY_SYMBOL_PATTERN.test(section) ||
+        QUOTED_CURRENCY_PATTERN.test(section));
+}
+function hasRequiredDecimals(section, requiredDecimalPlaces) {
+    const match = section.match(DECIMAL_TOKEN_PATTERN);
+    if (!match) {
+        return false;
+    }
+    return match[1].length >= requiredDecimalPlaces;
+}
+function collectInvalidSections(sections, predicate) {
+    const invalidIndexes = sections.reduce((result, section, index) => {
+        if (!predicate(section)) {
+            result.push(index);
+        }
+        return result;
+    }, []);
+    return invalidIndexes.length > 0 ? invalidIndexes : undefined;
+}
+function isParsableFormat(format, sampleValue, separators) {
+    try {
+        ClientFormatterFacade.formatValue(sampleValue, format, separators);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks if a format string represents a currency format.
+ * A currency format is one where at least one numeric section contains a currency symbol.
+ *
+ * @alpha
+ */
+export function isCurrencyFormat(format) {
+    const sanitizedFormat = format?.trim();
+    if (!sanitizedFormat) {
+        return false;
+    }
+    const sections = getFormatSections(sanitizedFormat);
+    const sectionsWithNumbers = sections.filter(hasNumericPlaceholder);
+    if (sectionsWithNumbers.length === 0) {
+        return false;
+    }
+    return sectionsWithNumbers.some(hasCurrencyToken);
+}
+//# sourceMappingURL=currencyFormatValidator.js.map

package/esm/measureNumberFormat/validation/currencyFormatValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencyFormatValidator.js","sourceRoot":"","sources":["../../../src/measureNumberFormat/validation/currencyFormatValidator.ts"],"names":[],"mappings":"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"}