@limonify/zest-ui 0.1.0

package/lib/number-field/scrub-area/NumberFieldScrubArea.js

@@ -0,0 +1,119 @@
+"use strict";
+'use client';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumberFieldScrubArea = NumberFieldScrubArea;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const react_native_gesture_handler_1 = require("react-native-gesture-handler");
+const NumberFieldRootContext_1 = require("../root/NumberFieldRootContext");
+const useRenderElement_1 = require("../../use-render/useRenderElement");
+const useStableCallback_1 = require("../../hooks/useStableCallback");
+const createChangeEventDetails_1 = require("../../utils/createChangeEventDetails");
+const reasons_1 = require("../../utils/reasons");
+/**
+ * An area where the user can drag to change the field value.
+ * Renders a `<View>` wrapped in a `GestureDetector`.
+ *
+ * **Diverges from the web deliberately.** Upstream holds a pointer lock and reads
+ * `movementX`/`movementY`, which lets the mouse scrub forever in place. A touch
+ * cannot be locked and has no movement deltas, so this is an ordinary drag: the
+ * value steps once for every `pixelSensitivity` pixels travelled. Upstream's
+ * `teleportDistance` and the `ScrubAreaCursor` part go with the pointer lock —
+ * both exist to manage a virtual cursor that a touch screen never shows.
+ *
+ * Requires `react-native-gesture-handler`, and the app to be wrapped in
+ * `<GestureHandlerRootView>`.
+ */
+function NumberFieldScrubArea(componentProps) {
+    const { render, className, direction = 'horizontal', pixelSensitivity = 2, style, ref, ...elementProps } = componentProps;
+    const { testID } = elementProps;
+    const { getStepAmount, incrementValue, lastChangedValueRef, onValueCommitted, setScrubbing, state, valueRef, } = (0, NumberFieldRootContext_1.useNumberFieldRootContext)();
+    const { disabled, readOnly } = state;
+    // How much of the drag has already been turned into steps. Kept in a ref
+    // because the gesture runs outside React's render.
+    const appliedRef = React.useRef(0);
+    const scrub = (0, useStableCallback_1.useStableCallback)((translationX, translationY) => {
+        const travelled = direction === 'vertical' ? -translationY : translationX;
+        // Only whole steps are applied, and the remainder stays pending so a slow
+        // drag still accumulates instead of being rounded away every frame.
+        const steps = Math.trunc(travelled / pixelSensitivity) - appliedRef.current;
+        if (steps === 0) {
+            return;
+        }
+        appliedRef.current += steps;
+        incrementValue(getStepAmount() * Math.abs(steps), {
+            direction: steps > 0 ? 1 : -1,
+            reason: reasons_1.REASONS.scrub,
+        });
+    });
+    const gesture = React.useMemo(() => react_native_gesture_handler_1.Gesture.Pan()
+        .enabled(!disabled && !readOnly)
+        // A gesture is invisible to the rendered tree, so tests can only reach it
+        // through gesture-handler's registry, which is keyed by this id.
+        .withTestId(testID !== null && testID !== void 0 ? testID : 'number-field-scrub-area')
+        .onBegin(() => {
+        appliedRef.current = 0;
+        setScrubbing(true);
+    })
+        // The move that activates the pan arrives as `onStart`, and every move
+        // after it as `onUpdate`.
+        .onStart((event) => scrub(event.translationX, event.translationY))
+        .onUpdate((event) => scrub(event.translationX, event.translationY))
+        .onFinalize(() => {
+        var _a;
+        setScrubbing(false);
+        onValueCommitted((_a = lastChangedValueRef.current) !== null && _a !== void 0 ? _a : valueRef.current, (0, createChangeEventDetails_1.createChangeEventDetails)(reasons_1.REASONS.scrub));
+    })
+        // The handlers touch React state, so they must not run on the UI thread.
+        .runOnJS(true), [
+        disabled,
+        readOnly,
+        testID,
+        scrub,
+        setScrubbing,
+        onValueCommitted,
+        lastChangedValueRef,
+        valueRef,
+    ]);
+    const element = (0, useRenderElement_1.useRenderElement)(react_native_1.View, componentProps, {
+        state,
+        ref,
+        props: elementProps,
+    });
+    return (0, jsx_runtime_1.jsx)(react_native_gesture_handler_1.GestureDetector, { gesture: gesture, children: element });
+}
+//# sourceMappingURL=NumberFieldScrubArea.js.map

package/lib/number-field/scrub-area/NumberFieldScrubArea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberFieldScrubArea.js","sourceRoot":"","sources":["../../../src/number-field/scrub-area/NumberFieldScrubArea.tsx"],"names":[],"mappings":"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"}

package/lib/number-field/utils/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const CHANGE_VALUE_TICK_DELAY = 60;
+export declare const START_AUTO_CHANGE_DELAY = 400;
+export declare const SCROLLING_POINTER_MOVE_DISTANCE = 8;
+//# sourceMappingURL=constants.d.ts.map

package/lib/number-field/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/number-field/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,+BAA+B,IAAI,CAAC"}

package/lib/number-field/utils/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCROLLING_POINTER_MOVE_DISTANCE = exports.START_AUTO_CHANGE_DELAY = exports.CHANGE_VALUE_TICK_DELAY = void 0;
+exports.CHANGE_VALUE_TICK_DELAY = 60;
+exports.START_AUTO_CHANGE_DELAY = 400;
+exports.SCROLLING_POINTER_MOVE_DISTANCE = 8;
+//# sourceMappingURL=constants.js.map

package/lib/number-field/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/number-field/utils/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAC7B,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAC9B,QAAA,+BAA+B,GAAG,CAAC,CAAC"}

package/lib/number-field/utils/parse.d.ts

@@ -0,0 +1,26 @@
+export declare const PERCENTAGES: string[];
+export declare const PERMILLE: string[];
+export declare const FULLWIDTH_DECIMAL = "\uFF0E";
+export declare const FULLWIDTH_GROUP = "\uFF0C";
+export declare const PERCENT_RE: RegExp;
+export declare const PERMILLE_RE: RegExp;
+export declare const ARABIC_PERSIAN_DETECT_RE: RegExp;
+export declare const HAN_DETECT_RE: RegExp;
+export declare function isNumeralChar(char: string): boolean;
+export declare const BASE_NON_NUMERIC_SYMBOLS: readonly [".", ",", "．", "，", "٫", "٬"];
+export declare const SPACE_SEPARATOR_RE: RegExp;
+export declare const FORMAT_CONTROL_DETECT_RE: RegExp;
+export declare const PLUS_SIGNS_WITH_ASCII: string[];
+export declare const MINUS_SIGNS_WITH_ASCII: string[];
+export declare const ANY_MINUS_RE: RegExp;
+export declare const ANY_PLUS_RE: RegExp;
+export declare const ANY_MINUS_DETECT_RE: RegExp;
+export declare const ANY_PLUS_DETECT_RE: RegExp;
+/**
+ * Returns the `Intl.NumberFormat` parts of a representative number, which surface every
+ * non-numeric symbol a given locale/format renders.
+ */
+export declare function getFormatParts(locale?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions): Intl.NumberFormatPart[];
+export declare function getNumberLocaleDetails(locale?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions): Partial<Record<keyof Intl.NumberFormatPartTypeRegistry, string | undefined>>;
+export declare function parseNumber(formattedNumber: string, locale?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions): number | null;
+//# sourceMappingURL=parse.d.ts.map

package/lib/number-field/utils/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/number-field/utils/parse.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW,UAAuB,CAAC;AAChD,eAAO,MAAM,QAAQ,UAAa,CAAC;AAGnC,eAAO,MAAM,iBAAiB,WAAM,CAAC;AACrC,eAAO,MAAM,eAAe,WAAM,CAAC;AAEnC,eAAO,MAAM,UAAU,QAAW,CAAC;AACnC,eAAO,MAAM,WAAW,QAAS,CAAC;AAMlC,eAAO,MAAM,wBAAwB,QAAa,CAAC;AACnD,eAAO,MAAM,aAAa,QAAkB,CAAC;AAK7C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,WAEzC;AAED,eAAO,MAAM,wBAAwB,yCAO3B,CAAC;AACX,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAI5C,eAAO,MAAM,wBAAwB,QAAY,CAAC;AAElD,eAAO,MAAM,qBAAqB,UAAkB,CAAC;AACrD,eAAO,MAAM,sBAAsB,UAAsC,CAAC;AAS1E,eAAO,MAAM,YAAY,QAAgB,CAAC;AAC1C,eAAO,MAAM,WAAW,QAAY,CAAC;AACrC,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAC/C,eAAO,MAAM,kBAAkB,QAAU,CAAC;AAO1C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,2BAE/F;AAED,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,gFAqBnC;AAED,wBAAgB,WAAW,CACzB,eAAe,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,iBAmHnC"}

package/lib/number-field/utils/parse.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANY_PLUS_DETECT_RE = exports.ANY_MINUS_DETECT_RE = exports.ANY_PLUS_RE = exports.ANY_MINUS_RE = exports.MINUS_SIGNS_WITH_ASCII = exports.PLUS_SIGNS_WITH_ASCII = exports.FORMAT_CONTROL_DETECT_RE = exports.SPACE_SEPARATOR_RE = exports.BASE_NON_NUMERIC_SYMBOLS = exports.HAN_DETECT_RE = exports.ARABIC_PERSIAN_DETECT_RE = exports.PERMILLE_RE = exports.PERCENT_RE = exports.FULLWIDTH_GROUP = exports.FULLWIDTH_DECIMAL = exports.PERMILLE = exports.PERCENTAGES = void 0;
+exports.isNumeralChar = isNumeralChar;
+exports.getFormatParts = getFormatParts;
+exports.getNumberLocaleDetails = getNumberLocaleDetails;
+exports.parseNumber = parseNumber;
+const formatNumber_1 = require("../../utils/formatNumber");
+// Han numerals in digit order, with both zero forms first ('零' at 0, '〇' at 1), so a
+// character's digit value is `max(indexOf - 1, 0)`.
+const HAN_NUMERALS = '零〇一二三四五六七八九';
+// Arabic-Indic (U+0660–0669), Persian (U+06F0–06F9), and fullwidth (U+FF10–FF19) digits are
+// contiguous ranges whose bases are divisible by 16, so `charCode % 16` is the digit value for
+// all three systems.
+const NON_ASCII_DIGIT_RE = /[٠-٩۰-۹０-９]/g;
+const HAN_RE = /[零〇一二三四五六七八九]/g;
+exports.PERCENTAGES = ['%', '٪', '％', '﹪'];
+exports.PERMILLE = ['‰', '؉'];
+// Fullwidth punctuation common in CJK inputs
+exports.FULLWIDTH_DECIMAL = '．'; // U+FF0E
+exports.FULLWIDTH_GROUP = '，'; // U+FF0C
+exports.PERCENT_RE = /[%٪％﹪]/;
+exports.PERMILLE_RE = /[‰؉]/;
+const PERCENT_GLOBAL_RE = /[%٪％﹪]/g;
+const PERMILLE_GLOBAL_RE = /[‰؉]/g;
+// Detection regexes (non-global to avoid lastIndex side effects). Arabic-Indic and Persian
+// digits share one regex because both resolve to the `ar` locale heuristic.
+exports.ARABIC_PERSIAN_DETECT_RE = /[٠-٩۰-۹]/;
+exports.HAN_DETECT_RE = /[零〇一二三四五六七八九]/;
+const ANY_NUMERAL_DETECT_RE = /[0-9٠-٩۰-۹０-９零〇一二三四五六七八九]/;
+// Whether the character is a digit in any numeral system the field accepts.
+function isNumeralChar(char) {
+    return ANY_NUMERAL_DETECT_RE.test(char);
+}
+exports.BASE_NON_NUMERIC_SYMBOLS = [
+    '.',
+    ',',
+    exports.FULLWIDTH_DECIMAL,
+    exports.FULLWIDTH_GROUP,
+    '٫',
+    '٬',
+];
+exports.SPACE_SEPARATOR_RE = /\p{Zs}/u;
+// Format/bidi control characters (e.g. the LRM/ALM marks RTL locales insert around exponent and
+// currency signs). `parseNumber` strips these, so input validation must treat them as ignorable
+// rather than rejecting the typed string. Non-global so it's safe for repeated `.test(char)`.
+exports.FORMAT_CONTROL_DETECT_RE = /\p{Cf}/u;
+const FORMAT_CONTROL_GLOBAL_RE = /\p{Cf}/gu;
+exports.PLUS_SIGNS_WITH_ASCII = ['+', '＋', '﹢'];
+exports.MINUS_SIGNS_WITH_ASCII = ['-', '−', '－', '‒', '–', '—', '﹣'];
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+function shiftDecimal(value, exponentDelta) {
+    const [coefficient, exponent = '0'] = String(value).split('e');
+    return Number(`${coefficient}e${Number(exponent) + exponentDelta}`);
+}
+exports.ANY_MINUS_RE = /[-−－‒–—﹣]/gu;
+exports.ANY_PLUS_RE = /[+＋﹢]/gu;
+exports.ANY_MINUS_DETECT_RE = /[-−－‒–—﹣]/;
+exports.ANY_PLUS_DETECT_RE = /[+＋﹢]/;
+// A representative value with a grouping separator and a fractional part, so that the formatter
+// emits every locale-specific part (group, decimal, currency, unit, literal, exponent, …). Shared
+// so the locale-detail and allowed-character derivations enumerate the same parts.
+const SAMPLE_FORMAT_NUMBER = 11111.1;
+/**
+ * Returns the `Intl.NumberFormat` parts of a representative number, which surface every
+ * non-numeric symbol a given locale/format renders.
+ */
+function getFormatParts(locale, options) {
+    return (0, formatNumber_1.getFormatter)(locale, options).formatToParts(SAMPLE_FORMAT_NUMBER);
+}
+function getNumberLocaleDetails(locale, options) {
+    const parts = getFormatParts(locale, options);
+    const result = {};
+    parts.forEach((part) => {
+        result[part.type] = part.value;
+    });
+    // The formatting options may omit the decimal separator (e.g. integer formats), so resolve it
+    // from the plain locale formatter. This overrides any options-derived decimal too, which is
+    // safe because the separator is locale-determined and identical across format styles.
+    (0, formatNumber_1.getFormatter)(locale)
+        .formatToParts(0.1)
+        .forEach((part) => {
+        if (part.type === 'decimal') {
+            result[part.type] = part.value;
+        }
+    });
+    return result;
+}
+function parseNumber(formattedNumber, locale, options) {
+    if (formattedNumber == null) {
+        return null;
+    }
+    // Normalize control characters and whitespace; remove bidi/format controls
+    let input = String(formattedNumber).replace(FORMAT_CONTROL_GLOBAL_RE, '').trim();
+    // Normalize unicode minus/plus to ASCII, handle leading/trailing signs
+    input = input.replace(exports.ANY_MINUS_RE, '-').replace(exports.ANY_PLUS_RE, '+');
+    let isNegative = false;
+    // Strips a matched sign (leading "-12" / trailing "1234-") while recording negativity.
+    const takeSign = (match, sign) => {
+        if (sign === '-') {
+            isNegative = true;
+        }
+        return '';
+    };
+    input = input.replace(/([+-])\s*$/, takeSign).replace(/^\s*([+-])/, takeSign);
+    // Heuristic locale detection
+    let computedLocale = locale;
+    if (computedLocale === undefined) {
+        if (exports.ARABIC_PERSIAN_DETECT_RE.test(input)) {
+            computedLocale = 'ar';
+        }
+        else if (exports.HAN_DETECT_RE.test(input)) {
+            computedLocale = 'zh';
+        }
+    }
+    const { group, decimal, currency, exponentSeparator } = getNumberLocaleDetails(computedLocale, options);
+    // Build robust unit regex from all unit parts (such as "km/h")
+    const unitParts = (0, formatNumber_1.getFormatter)(computedLocale, options)
+        .formatToParts(1)
+        .filter((p) => p.type === 'unit')
+        .map((p) => escapeRegExp(p.value));
+    const unitRegex = unitParts.length ? new RegExp(unitParts.join('|'), 'g') : null;
+    let groupRegex = null;
+    if (group) {
+        const isSpaceGroup = /\p{Zs}/u.test(group);
+        const isApostropheGroup = group === "'" || group === '’';
+        // Check if the group separator is a space-like character.
+        // If so, we'll replace all such characters with an empty string.
+        if (isSpaceGroup) {
+            groupRegex = /\p{Zs}/gu;
+        }
+        else if (isApostropheGroup) {
+            // Some environments format numbers with ASCII apostrophe and others with a curly apostrophe.
+            groupRegex = /['’]/g;
+        }
+        else {
+            groupRegex = new RegExp(escapeRegExp(group), 'g');
+        }
+    }
+    const replacements = [
+        [groupRegex, ''],
+        [decimal ? new RegExp(escapeRegExp(decimal), 'g') : null, '.'],
+        // Fullwidth/Arabic punctuation
+        [/[．٫]/g, '.'], // FULLWIDTH_DECIMAL, ARABIC DECIMAL SEPARATOR (U+066B)
+        [/[，٬]/g, ''], // FULLWIDTH_GROUP, ARABIC THOUSANDS SEPARATOR (U+066C)
+        // Currency & unit labels
+        [currency ? new RegExp(escapeRegExp(currency), 'g') : null, ''],
+        [unitRegex, ''],
+        [PERCENT_GLOBAL_RE, ''],
+        [PERMILLE_GLOBAL_RE, ''],
+        [exponentSeparator ? new RegExp(escapeRegExp(exponentSeparator), 'g') : null, 'e'],
+        // Numeral systems to ASCII digits
+        [NON_ASCII_DIGIT_RE, (ch) => String(ch.charCodeAt(0) % 16)],
+        [HAN_RE, (ch) => String(Math.max(HAN_NUMERALS.indexOf(ch) - 1, 0))],
+    ];
+    let unformatted = replacements.reduce((acc, [regex, replacement]) => {
+        return regex ? acc.replace(regex, replacement) : acc;
+    }, input);
+    // Mixed-locale safety: keep only the last '.' as decimal
+    const lastDot = unformatted.lastIndexOf('.');
+    if (lastDot !== -1) {
+        unformatted = `${unformatted.slice(0, lastDot).replace(/\./g, '')}.${unformatted.slice(lastDot + 1).replace(/\./g, '')}`;
+    }
+    // Guard against Infinity inputs (ASCII and symbol)
+    if (/^[-+]?Infinity$/i.test(input) || input.includes('∞')) {
+        return null;
+    }
+    const parseTarget = (isNegative ? '-' : '') + unformatted;
+    let num = parseFloat(parseTarget);
+    const style = options === null || options === void 0 ? void 0 : options.style;
+    const isUnitPercent = style === 'unit' && (options === null || options === void 0 ? void 0 : options.unit) === 'percent';
+    const hasPercentSymbol = exports.PERCENT_RE.test(formattedNumber) || style === 'percent';
+    const hasPermilleSymbol = exports.PERMILLE_RE.test(formattedNumber);
+    if (hasPermilleSymbol) {
+        num = shiftDecimal(num, -3);
+    }
+    else if (!isUnitPercent && hasPercentSymbol) {
+        num = shiftDecimal(num, -2);
+    }
+    if (!Number.isFinite(num)) {
+        return null;
+    }
+    return num;
+}
+//# sourceMappingURL=parse.js.map

package/lib/number-field/utils/parse.js.map

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

package/lib/number-field/utils/validate.d.ts

@@ -0,0 +1,10 @@
+type NumberFormatOptionsWithRounding = Intl.NumberFormatOptions & {
+    roundingIncrement?: number | undefined;
+    roundingMode?: string | undefined;
+    roundingPriority?: string | undefined;
+};
+export declare function hasNumberFormatRoundingOptions(format?: NumberFormatOptionsWithRounding): format is NumberFormatOptionsWithRounding;
+export declare function removeFloatingPointErrors(value: number, format?: NumberFormatOptionsWithRounding): number;
+export declare function toValidatedNumber(value: number | null, step: number | undefined, minWithDefault: number, maxWithDefault: number, minWithZeroDefault: number, format: NumberFormatOptionsWithRounding | undefined, snapOnStep: boolean, small: boolean, shouldClamp: boolean): number | null;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/lib/number-field/utils/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/number-field/utils/validate.ts"],"names":[],"mappings":"AAYA,KAAK,+BAA+B,GAAG,IAAI,CAAC,mBAAmB,GAAG;IAChE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,MAAM,CAAC,EAAE,+BAA+B,GACvC,MAAM,IAAI,+BAA+B,CAU3C;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,+BAA+B,UA0ChG;AAiBD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,+BAA+B,GAAG,SAAS,EACnD,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,iBAmCrB"}

package/lib/number-field/utils/validate.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasNumberFormatRoundingOptions = hasNumberFormatRoundingOptions;
+exports.removeFloatingPointErrors = removeFloatingPointErrors;
+exports.toValidatedNumber = toValidatedNumber;
+const clamp_1 = require("../../utils/clamp");
+const formatNumber_1 = require("../../utils/formatNumber");
+const parse_1 = require("./parse");
+// A relative factor scaled by the step size when snapping (`stepSize * STEP_EPSILON_FACTOR`).
+const STEP_EPSILON_FACTOR = 1e-10;
+// An absolute cap (in the value's own units) on how far floating-point cleanup may move a value.
+// Equal to `STEP_EPSILON_FACTOR` only by coincidence — the two are independent and may diverge.
+const MAX_FLOATING_POINT_CLEANUP_DELTA = 1e-10;
+function hasNumberFormatRoundingOptions(format) {
+    return ((format === null || format === void 0 ? void 0 : format.maximumFractionDigits) != null ||
+        (format === null || format === void 0 ? void 0 : format.minimumFractionDigits) != null ||
+        (format === null || format === void 0 ? void 0 : format.maximumSignificantDigits) != null ||
+        (format === null || format === void 0 ? void 0 : format.minimumSignificantDigits) != null ||
+        (format === null || format === void 0 ? void 0 : format.roundingIncrement) != null ||
+        (format === null || format === void 0 ? void 0 : format.roundingMode) != null ||
+        (format === null || format === void 0 ? void 0 : format.roundingPriority) != null);
+}
+function removeFloatingPointErrors(value, format) {
+    if (!Number.isFinite(value)) {
+        return value;
+    }
+    if (!hasNumberFormatRoundingOptions(format)) {
+        // Clean binary floating-point noise (e.g. `0.1 + 0.2`) without discarding legitimate
+        // precision. The cleanup is delta-bounded, so it cannot tell noise apart from real digits
+        // that fall within the same epsilon: arithmetic that produces sub-epsilon precision (e.g.
+        // accumulating a high-significance `step` past the first tick) is normalized to ~15
+        // significant digits.
+        const roundedValue = parseFloat(value.toPrecision(15));
+        const cleanupDelta = Math.abs(roundedValue - value);
+        // Cap the cleanup delta so `toPrecision(15)` cannot erase meaningful fractional values
+        // at large magnitudes, where the relative epsilon alone is too permissive. The trade-off is
+        // that from the `2^19` binade (~5.2e5) up, a single ULP exceeds the absolute cap, so genuine
+        // stepping noise is left uncleaned there (e.g. `1000000.1 + 0.2` stays `1000000.2999999999`)
+        // rather than risk corrupting real precision.
+        const cleanupTolerance = Math.min(Number.EPSILON * Math.max(1, Math.abs(value)), MAX_FLOATING_POINT_CLEANUP_DELTA);
+        return cleanupDelta <= cleanupTolerance ? roundedValue : value;
+    }
+    const formatter = (0, formatNumber_1.getFormatter)('en-US', {
+        ...format,
+        // These options alter only display decoration, not numeric rounding.
+        signDisplay: 'auto',
+        currencySign: 'standard',
+        notation: format.notation === 'compact' ? 'standard' : format.notation,
+        useGrouping: false,
+    });
+    const roundedText = formatter.format(value);
+    const roundedValue = (0, parse_1.parseNumber)(roundedText, 'en-US', format);
+    if (roundedValue === null) {
+        return value;
+    }
+    return formatter.format(roundedValue) === roundedText ? roundedValue : value;
+}
+function snapToStep(value, base, step, nearest) {
+    const stepSize = Math.abs(step);
+    const direction = Math.sign(step);
+    const tolerance = stepSize * STEP_EPSILON_FACTOR * direction;
+    const rawSteps = value - base + tolerance;
+    if (nearest) {
+        return base + Math.round(rawSteps / step) * step;
+    }
+    const snappedSteps = direction > 0 ? Math.floor(rawSteps / stepSize) : Math.ceil(rawSteps / stepSize);
+    return base + snappedSteps * stepSize;
+}
+function toValidatedNumber(value, step, minWithDefault, maxWithDefault, minWithZeroDefault, format, snapOnStep, small, shouldClamp) {
+    if (value === null) {
+        return value;
+    }
+    let nextValue = value;
+    if (step != null && snapOnStep && step !== 0) {
+        const base = small || minWithDefault === Number.MIN_SAFE_INTEGER ? minWithZeroDefault : minWithDefault;
+        // Snap before clamping so non-step-aligned boundaries stay reachable. Small (alt-key) steps
+        // snap to the nearest multiple; regular steps snap directionally.
+        nextValue = snapToStep(nextValue, base, step, small);
+    }
+    // Clamp before rounding so a value just outside a fractional boundary (e.g. `0.4` with
+    // `min: 0.6`) is pulled in range first, then clamp again after rounding in case rounding
+    // nudges it back out. Both passes are needed for non-integer bounds.
+    if (shouldClamp) {
+        nextValue = (0, clamp_1.clamp)(nextValue, minWithDefault, maxWithDefault);
+    }
+    // Non-stepping values — parsed input (typing, paste, blur) and externally-supplied controlled
+    // values — involve no arithmetic here, so they carry no binary noise to clean and are returned
+    // verbatim to keep every digit, including values with more than 15 significant digits. Only
+    // stepping/snapping arithmetic can introduce noise (e.g. 0.7 + 0.1), which
+    // `removeFloatingPointErrors` cleans.
+    if (step == null && !hasNumberFormatRoundingOptions(format)) {
+        return nextValue;
+    }
+    const roundedValue = removeFloatingPointErrors(nextValue, format);
+    return shouldClamp ? (0, clamp_1.clamp)(roundedValue, minWithDefault, maxWithDefault) : roundedValue;
+}
+//# sourceMappingURL=validate.js.map

package/lib/number-field/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/number-field/utils/validate.ts"],"names":[],"mappings":";;AAkBA,wEAYC;AAED,8DA0CC;AAiBD,8CA4CC;AAvID,6CAA0C;AAC1C,2DAAwD;AACxD,mCAAsC;AAEtC,8FAA8F;AAC9F,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,iGAAiG;AACjG,gGAAgG;AAChG,MAAM,gCAAgC,GAAG,KAAK,CAAC;AAU/C,SAAgB,8BAA8B,CAC5C,MAAwC;IAExC,OAAO,CACL,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,qBAAqB,KAAI,IAAI;QACrC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,qBAAqB,KAAI,IAAI;QACrC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,wBAAwB,KAAI,IAAI;QACxC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,wBAAwB,KAAI,IAAI;QACxC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,iBAAiB,KAAI,IAAI;QACjC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,YAAY,KAAI,IAAI;QAC5B,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,KAAI,IAAI,CACjC,CAAC;AACJ,CAAC;AAED,SAAgB,yBAAyB,CAAC,KAAa,EAAE,MAAwC;IAC/F,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,qFAAqF;QACrF,0FAA0F;QAC1F,0FAA0F;QAC1F,oFAAoF;QACpF,sBAAsB;QACtB,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC;QACpD,uFAAuF;QACvF,4FAA4F;QAC5F,6FAA6F;QAC7F,6FAA6F;QAC7F,8CAA8C;QAC9C,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAC/B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAC7C,gCAAgC,CACjC,CAAC;QAEF,OAAO,YAAY,IAAI,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,CAAC;IAED,MAAM,SAAS,GAAG,IAAA,2BAAY,EAAC,OAAO,EAAE;QACtC,GAAG,MAAM;QACT,qEAAqE;QACrE,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,UAAU;QACxB,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ;QACtE,WAAW,EAAE,KAAK;KACgB,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAA,mBAAW,EAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE/D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/E,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,OAAgB;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,QAAQ,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7D,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;IAE1C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,CAAC;IAED,MAAM,YAAY,GAChB,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACnF,OAAO,IAAI,GAAG,YAAY,GAAG,QAAQ,CAAC;AACxC,CAAC;AAED,SAAgB,iBAAiB,CAC/B,KAAoB,EACpB,IAAwB,EACxB,cAAsB,EACtB,cAAsB,EACtB,kBAA0B,EAC1B,MAAmD,EACnD,UAAmB,EACnB,KAAc,EACd,WAAoB;IAEpB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,IAAI,IAAI,IAAI,IAAI,IAAI,UAAU,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GACR,KAAK,IAAI,cAAc,KAAK,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,cAAc,CAAC;QAE5F,4FAA4F;QAC5F,kEAAkE;QAClE,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,uFAAuF;IACvF,yFAAyF;IACzF,qEAAqE;IACrE,IAAI,WAAW,EAAE,CAAC;QAChB,SAAS,GAAG,IAAA,aAAK,EAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,8FAA8F;IAC9F,+FAA+F;IAC/F,4FAA4F;IAC5F,2EAA2E;IAC3E,sCAAsC;IACtC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,WAAW,CAAC,CAAC,CAAC,IAAA,aAAK,EAAC,YAAY,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1F,CAAC"}

package/lib/otp-field/index.d.ts

@@ -0,0 +1,6 @@
+export * as OTPField from './index.parts';
+export type * from './root/OTPFieldRoot';
+export type * from './input/OTPFieldInput';
+export { useOTPFieldRootContext } from './root/OTPFieldRootContext';
+export type { OTPValidationType } from './utils/otp';
+//# sourceMappingURL=index.d.ts.map

package/lib/otp-field/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/otp-field/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/lib/otp-field/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOTPFieldRootContext = exports.OTPField = void 0;
+exports.OTPField = __importStar(require("./index.parts"));
+var OTPFieldRootContext_1 = require("./root/OTPFieldRootContext");
+Object.defineProperty(exports, "useOTPFieldRootContext", { enumerable: true, get: function () { return OTPFieldRootContext_1.useOTPFieldRootContext; } });
+//# sourceMappingURL=index.js.map

package/lib/otp-field/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/otp-field/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0DAA0C;AAI1C,kEAAoE;AAA3D,6HAAA,sBAAsB,OAAA"}

package/lib/otp-field/index.parts.d.ts

@@ -0,0 +1,4 @@
+export { OTPFieldRoot as Root } from './root/OTPFieldRoot';
+export { OTPFieldInput as Input } from './input/OTPFieldInput';
+export { Separator } from '../separator/Separator';
+//# sourceMappingURL=index.parts.d.ts.map

package/lib/otp-field/index.parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.parts.d.ts","sourceRoot":"","sources":["../../src/otp-field/index.parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/otp-field/index.parts.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Separator = exports.Input = exports.Root = void 0;
+var OTPFieldRoot_1 = require("./root/OTPFieldRoot");
+Object.defineProperty(exports, "Root", { enumerable: true, get: function () { return OTPFieldRoot_1.OTPFieldRoot; } });
+var OTPFieldInput_1 = require("./input/OTPFieldInput");
+Object.defineProperty(exports, "Input", { enumerable: true, get: function () { return OTPFieldInput_1.OTPFieldInput; } });
+var Separator_1 = require("../separator/Separator");
+Object.defineProperty(exports, "Separator", { enumerable: true, get: function () { return Separator_1.Separator; } });
+//# sourceMappingURL=index.parts.js.map

package/lib/otp-field/index.parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.parts.js","sourceRoot":"","sources":["../../src/otp-field/index.parts.ts"],"names":[],"mappings":";;;AAAA,oDAA2D;AAAlD,oGAAA,YAAY,OAAQ;AAC7B,uDAA+D;AAAtD,sGAAA,aAAa,OAAS;AAC/B,oDAAmD;AAA1C,sGAAA,SAAS,OAAA"}

package/lib/otp-field/input/OTPFieldInput.d.ts

@@ -0,0 +1,40 @@
+import * as React from 'react';
+import { TextInput } from 'react-native';
+import type { OTPFieldRootState } from '../root/OTPFieldRoot';
+import type { ZestUIComponentProps } from '../../types';
+/**
+ * A single OTP slot.
+ * Renders a `<TextInput>`.
+ *
+ * Its slot index comes from its position among the other inputs, via
+ * `CompositeList` — so slots need no index prop.
+ *
+ * **Diverges from the web deliberately.** Upstream handles paste through a
+ * `paste` event and selection ranges. React Native reports every edit as a whole
+ * string through `onChangeText` and has no paste event, so both cases go through
+ * the same path: whatever arrives is written from this slot onwards. That is also
+ * what makes OS autofill work — iOS and Android deliver the entire SMS code into
+ * the focused slot, which lands here as one long string.
+ */
+export declare function OTPFieldInput(componentProps: OTPFieldInput.Props): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export interface OTPFieldInputState extends OTPFieldRootState {
+    /**
+     * This slot's character.
+     */
+    value: string;
+    /**
+     * This slot's index.
+     */
+    index: number;
+    /**
+     * Whether this slot has a character.
+     */
+    filled: boolean;
+}
+export interface OTPFieldInputProps extends Omit<ZestUIComponentProps<typeof TextInput, OTPFieldInputState>, 'value'> {
+}
+export declare namespace OTPFieldInput {
+    type State = OTPFieldInputState;
+    type Props = OTPFieldInputProps;
+}
+//# sourceMappingURL=OTPFieldInput.d.ts.map

package/lib/otp-field/input/OTPFieldInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OTPFieldInput.d.ts","sourceRoot":"","sources":["../../../src/otp-field/input/OTPFieldInput.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EACL,SAAS,EAGV,MAAM,cAAc,CAAC;AAMtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOxD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,KAAK,0EAwIhE;AAWD,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,oBAAoB,CAAC,OAAO,SAAS,EAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAAG;AAEtF,yBAAiB,aAAa,CAAC;IAC7B,KAAY,KAAK,GAAG,kBAAkB,CAAC;IACvC,KAAY,KAAK,GAAG,kBAAkB,CAAC;CACxC"}